chore: import upstream snapshot with attribution

2026-07-13 12:58:35 +08:00
commit 85453da49f
4031 changed files with 710987 additions and 0 deletions
@@ -0,0 +1,94 @@
+import { createHash } from "node:crypto";
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { buildSync } from "esbuild";
+import {
+  HYPERFRAME_RUNTIME_ARTIFACTS,
+  HYPERFRAME_RUNTIME_CONTRACT,
+  loadHyperframeRuntimeSource,
+} from "../src/inline-scripts/hyperframe";
+
+const thisDir = dirname(fileURLToPath(import.meta.url));
+const distDir = resolve(thisDir, "../dist");
+const iifePath = resolve(distDir, HYPERFRAME_RUNTIME_ARTIFACTS.iife);
+const esmPath = resolve(distDir, HYPERFRAME_RUNTIME_ARTIFACTS.esm);
+const manifestPath = resolve(distDir, HYPERFRAME_RUNTIME_ARTIFACTS.manifest);
+
+const runtimeSourceRaw = loadHyperframeRuntimeSource();
+if (runtimeSourceRaw === null) {
+  throw new Error("Cannot build runtime artifact: entry.ts not found at expected path");
+}
+const runtimeSource = `${runtimeSourceRaw}\n`;
+const runtimeSha256 = createHash("sha256").update(runtimeSource, "utf8").digest("hex");
+const buildId = process.env.HYPERFRAME_RUNTIME_BUILD_ID?.trim() || "dev";
+const runtimeEntryPath = resolve(thisDir, "../src/runtime/entry.ts");
+const esmBuild = buildSync({
+  entryPoints: [runtimeEntryPath],
+  bundle: true,
+  write: false,
+  platform: "browser",
+  format: "esm",
+  target: ["es2020"],
+  minify: true,
+  legalComments: "none",
+});
+const esmSource = `${esmBuild.outputFiles[0]?.text ?? ""}\n`;
+
+const manifest = {
+  version: process.env.HYPERFRAME_RUNTIME_VERSION?.trim() || "0.1.0",
+  buildId,
+  sha256: runtimeSha256,
+  artifacts: {
+    iife: HYPERFRAME_RUNTIME_ARTIFACTS.iife,
+    esm: HYPERFRAME_RUNTIME_ARTIFACTS.esm,
+  },
+  contract: HYPERFRAME_RUNTIME_CONTRACT,
+};
+
+mkdirSync(distDir, { recursive: true });
+writeFileSync(iifePath, runtimeSource, "utf8");
+writeFileSync(esmPath, esmSource, "utf8");
+writeFileSync(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`, "utf8");
+
+// ── Generate src/generated/runtime-inline.ts ──────────────────────────────
+// This file is compiled by tsc into dist/ and provides the production-safe
+// getHyperframeRuntimeScript() that returns the IIFE as a string constant —
+// no esbuild, no file I/O, no import.meta.url arithmetic.
+const generatedDir = resolve(thisDir, "../src/generated");
+mkdirSync(generatedDir, { recursive: true });
+const inlineModulePath = resolve(generatedDir, "runtime-inline.ts");
+const escapedSource = JSON.stringify(runtimeSourceRaw);
+writeFileSync(
+  inlineModulePath,
+  [
+    "// AUTO-GENERATED by scripts/build-hyperframes-runtime-artifact.ts — do not edit",
+    `const RUNTIME_IIFE: string = ${escapedSource};`,
+    "",
+    "/**",
+    " * Returns the pre-built hyperframe runtime IIFE as a string constant.",
+    " * This is the production-safe path: no esbuild, no file I/O,",
+    " * no import.meta.url arithmetic.",
+    " */",
+    "export function getHyperframeRuntimeScript(): string {",
+    "  return RUNTIME_IIFE;",
+    "}",
+    "",
+  ].join("\n"),
+  "utf8",
+);
+
+console.log(
+  JSON.stringify({
+    event: "hyperframe_runtime_artifacts_generated",
+    buildId,
+    distDir,
+    iifePath,
+    esmPath,
+    manifestPath,
+    inlineModulePath,
+    sourceBytes: Buffer.byteLength(runtimeSource, "utf8"),
+    esmBytes: Buffer.byteLength(esmSource, "utf8"),
+    sha256: runtimeSha256,
+  }),
+);