@astroscope/wormhole 1.1.0 → 3.0.0

package/dist/index.js

@@ -1,38 +1,240 @@
-//#region src/define.ts
-/**
-* Define a wormhole that transfers state from server middleware to client components.
-*
-* **Security:** wormhole data is serialized into the HTML and sent to the browser.
-* Never store secrets (tokens, API keys, credentials) in a wormhole.
-*/
-function defineWormhole(name) {
-	const listeners = /* @__PURE__ */ new Set();
-	const key = `__wormhole_${name}__`;
-	let store;
+import { n as createWormhole, r as defineWormhole, t as assignWormholeNames } from "./define-1UkPnsXV.js";
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { collectRouteIslands, routeEntrypoints, stripQuery } from "@astroscope/node/islands";
+import { serializeExcludePatterns } from "@astroscope/node/excludes";
+//#region src/extraction/vite-plugin.ts
+const WORMHOLE_VIRTUAL_MODULE_ID = "virtual:@astroscope/wormhole/manifest";
+const REGISTRY_VIRTUAL_MODULE_ID = "virtual:@astroscope/wormhole/registry";
+const CONFIG_VIRTUAL_MODULE_ID = "virtual:@astroscope/wormhole/config";
+const RESOLVED_VIRTUAL_MODULE_ID = `\0${WORMHOLE_VIRTUAL_MODULE_ID}`;
+const RESOLVED_REGISTRY_STUB_ID = `\0${REGISTRY_VIRTUAL_MODULE_ID}`;
+const RESOLVED_CONFIG_VIRTUAL_MODULE_ID = `\0${CONFIG_VIRTUAL_MODULE_ID}`;
+const MANIFEST_FILE_NAME = "wormhole-manifest.json";
+const SCAN_EXTENSIONS = [
+	".ts",
+	".tsx",
+	".js",
+	".jsx"
+];
+const SERVER_SCAN_EXTENSIONS = [...SCAN_EXTENSIONS, ".astro"];
+/** chunk file name → manifest key, e.g. `_astro/Counter.abc.js` → `Counter.abc` */
+function chunkFileNameToName(fileName) {
+	return fileName.slice(fileName.lastIndexOf("/") + 1).replace(/\.js$/, "");
+}
+function wormholeVitePlugin(options) {
+	let isBuild = false;
+	const clientScans = /* @__PURE__ */ new Map();
+	const serverScans = /* @__PURE__ */ new Map();
+	const routeNames = /* @__PURE__ */ new Map();
+	const patternsByFile = /* @__PURE__ */ new Map();
 	return {
-		name,
-		key,
-		get() {
-			if (store !== void 0) return store;
-			const getter = globalThis[key];
-			const value = typeof getter === "function" ? getter() : void 0;
-			if (value === void 0) throw new Error(`wormhole "${name}" is not initialized`);
-			return value;
+		name: "@astroscope/wormhole/extract",
+		configResolved(config) {
+			isBuild = config.command === "build";
 		},
-		set(data) {
-			if (typeof globalThis.window === "undefined") throw new Error(`wormhole "${name}" set() cannot be called on the server as it is not request-scoped; use open(wormhole, data, fn) from "@astroscope/wormhole/server" instead`);
-			store = data;
-			for (const fn of listeners) fn(data);
+		resolveId(id) {
+			if (id === "virtual:@astroscope/wormhole/manifest") return RESOLVED_VIRTUAL_MODULE_ID;
+			if (id === "virtual:@astroscope/wormhole/config") return RESOLVED_CONFIG_VIRTUAL_MODULE_ID;
+			if (id === "virtual:@astroscope/wormhole/registry") return options.registryPath ?? RESOLVED_REGISTRY_STUB_ID;
 		},
-		subscribe(fn) {
-			listeners.add(fn);
-			return () => {
-				listeners.delete(fn);
+		load(id) {
+			if (id === RESOLVED_REGISTRY_STUB_ID) return "export const wormholes = {};";
+			if (id === RESOLVED_CONFIG_VIRTUAL_MODULE_ID) return `export const exclude = ${options.exclude ? serializeExcludePatterns(options.exclude) : "null"};`;
+			if (id === options.registryPath && this.environment?.name === "client") throw new Error(`[@astroscope/wormhole] ${path.relative(process.cwd(), id)} is server-only — client code reads wormholes through the \`wormholes\` proxy from '@astroscope/wormhole'`);
+			if (id !== RESOLVED_VIRTUAL_MODULE_ID) return;
+			if (!isBuild) return "export const manifest = null;";
+			return `
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+
+const dir = dirname(fileURLToPath(import.meta.url));
+
+let manifest = null;
+
+for (const candidate of [
+  join(dir, '${MANIFEST_FILE_NAME}'),
+  join(dir, 'chunks', '${MANIFEST_FILE_NAME}'),
+  join(dir, '..', 'chunks', '${MANIFEST_FILE_NAME}'),
+]) {
+  try {
+    manifest = JSON.parse(readFileSync(candidate, 'utf-8'));
+    break;
+  } catch {
+    manifest = null;
+  }
+}
+
+export { manifest };
+`;
+		},
+		async transform(code, id) {
+			if (!isBuild || !this.environment) return;
+			if (id.includes("node_modules")) return;
+			const client = this.environment.name === "client";
+			const extensions = client ? SCAN_EXTENSIONS : SERVER_SCAN_EXTENSIONS;
+			const file = extensions.some((ext) => id.endsWith(ext)) ? id : stripQuery(id);
+			if (!extensions.some((ext) => file.endsWith(ext))) return;
+			if (!code.includes("@astroscope/wormhole")) return;
+			const { scanWormholeAccess } = await import("./scan-CczEOWpD.js");
+			const scan = scanWormholeAccess(code, file);
+			if (scan) (client ? clientScans : serverScans).set(client ? id : stripQuery(id), scan);
+		},
+		async generateBundle() {
+			if (this.environment.name === "client") return;
+			const { routes, patternsByModule } = await collectRouteIslands(this, options.pages());
+			for (const pattern of routes.keys()) routeNames.set(pattern, routeNames.get(pattern) ?? /* @__PURE__ */ new Set());
+			for (const [id, patterns] of patternsByModule) {
+				const file = stripQuery(id);
+				let owners = patternsByFile.get(file);
+				if (!owners) {
+					owners = /* @__PURE__ */ new Set();
+					patternsByFile.set(file, owners);
+				}
+				patterns.forEach((pattern) => owners.add(pattern));
+				const scan = serverScans.get(file);
+				if (!scan) continue;
+				for (const pattern of patterns) {
+					const names = routeNames.get(pattern);
+					scan.names.forEach((name) => names.add(name));
+					if (scan.dynamic) names.add("*");
+				}
+			}
+		},
+		writeBundle(outputOptions, bundle) {
+			if (this.environment.name !== "client" || !outputOptions.dir) return;
+			const chunks = {};
+			const chunkNamesByFileName = /* @__PURE__ */ new Map();
+			const chunkEdges = /* @__PURE__ */ new Map();
+			const scriptEntries = [];
+			for (const chunk of Object.values(bundle)) {
+				if (chunk.type !== "chunk") continue;
+				const names = /* @__PURE__ */ new Set();
+				let dynamic = false;
+				for (const moduleId of chunk.moduleIds) {
+					const scan = clientScans.get(moduleId);
+					scan?.names.forEach((name) => names.add(name));
+					dynamic ||= scan?.dynamic ?? false;
+				}
+				const chunkNames = [...dynamic ? ["*"] : [], ...names];
+				if (chunkNames.length > 0) chunks[chunkFileNameToName(chunk.fileName)] = chunkNames;
+				chunkNamesByFileName.set(chunk.fileName, chunkNames);
+				chunkEdges.set(chunk.fileName, [...chunk.imports, ...chunk.dynamicImports]);
+				if ((chunk.isEntry || chunk.isDynamicEntry) && chunk.facadeModuleId?.includes("astro&type=script")) scriptEntries.push(chunk.fileName);
+			}
+			const scriptNames = /* @__PURE__ */ new Set();
+			for (const entry of scriptEntries) {
+				const names = /* @__PURE__ */ new Set();
+				const visited = /* @__PURE__ */ new Set();
+				const walk = (fileName) => {
+					if (visited.has(fileName)) return;
+					visited.add(fileName);
+					chunkNamesByFileName.get(fileName)?.forEach((name) => names.add(name));
+					chunkEdges.get(fileName)?.forEach(walk);
+				};
+				walk(entry);
+				names.forEach((name) => scriptNames.add(name));
+				const owner = bundle[entry]?.type === "chunk" ? stripQuery(bundle[entry].facadeModuleId ?? "") : "";
+				const owners = patternsByFile.get(owner) ?? routeNames.keys();
+				for (const pattern of owners) {
+					const route = routeNames.get(pattern);
+					names.forEach((name) => route?.add(name));
+				}
+			}
+			const routes = {};
+			for (const [pattern, names] of routeNames) routes[pattern] = [...names];
+			const manifest = {
+				chunks,
+				scripts: [...scriptNames],
+				routes
 			};
+			const chunksDir = path.resolve(outputOptions.dir, "..", "server", "chunks");
+			if (fs.existsSync(chunksDir)) fs.writeFileSync(path.join(chunksDir, MANIFEST_FILE_NAME), JSON.stringify(manifest));
+			else console.error(`[@astroscope/wormhole] server chunks directory not found, cannot write manifest to ${chunksDir}`);
 		}
 	};
 }
 //#endregion
-export { defineWormhole };
+//#region src/integration.ts
+/**
+* Astro integration for wormholes with per-route loading and per-island delivery.
+*
+* Resolves the `src/wormholes.ts` registry and exposes it to the middleware as a
+* virtual module, injects the middleware after the project's own (so handlers see
+* everything earlier middleware put on `locals`), registers the vite plugin that
+* scans server and client code for `wormholes.<name>` accesses and maps them onto
+* routes and chunks, and generates the registry type stub that types the
+* `wormholes` proxy. Delivery happens at runtime: the middleware runs the handlers
+* the route needs, and the islands emitter (via `@astroscope/node`) writes each
+* island's slice before its tag.
+*/
+function wormholeIntegration(options = {}) {
+	const resolveRegistryPath = (srcDir) => ["wormholes.ts", path.join("wormholes", "index.ts")].map((candidate) => path.join(fileURLToPath(srcDir), candidate)).find((candidate) => fs.existsSync(candidate)) ?? null;
+	let root = "";
+	let resolvedRoutes = [];
+	return {
+		name: "@astroscope/wormhole",
+		hooks: {
+			"astro:config:setup": ({ config, updateConfig, addMiddleware }) => {
+				root = fileURLToPath(config.root);
+				addMiddleware({
+					order: "post",
+					entrypoint: "@astroscope/wormhole/middleware"
+				});
+				updateConfig({ vite: { plugins: [wormholeVitePlugin({
+					registryPath: resolveRegistryPath(config.srcDir),
+					exclude: options.exclude ?? null,
+					pages: () => routeEntrypoints(root, resolvedRoutes)
+				})] } });
+			},
+			"astro:routes:resolved": ({ routes }) => {
+				resolvedRoutes = routes;
+			},
+			"astro:config:done": ({ config, injectTypes, logger }) => {
+				const registryPath = resolveRegistryPath(config.srcDir);
+				if (!registryPath) {
+					logger.warn("no src/wormholes.ts registry found — the wormholes proxy stays untyped");
+					return;
+				}
+				const stubFile = path.join(fileURLToPath(config.root), ".astro", "integrations", "_astroscope_wormhole", "registry.d.ts");
+				const specifier = path.relative(path.dirname(stubFile), registryPath.replace(/([/\\]index)?\.ts$/, "")).split(path.sep).join("/");
+				const written = injectTypes({
+					filename: "registry.d.ts",
+					content: `import type { UnwrapWormholes } from '@astroscope/wormhole';
+
+declare module '@astroscope/wormhole' {
+  interface WormholeRegistry extends UnwrapWormholes<typeof import(${JSON.stringify(specifier)}).wormholes> {}\n}\n`
+				});
+				if (path.resolve(fileURLToPath(written)) !== path.resolve(stubFile)) logger.error(`registry type stub landed at ${fileURLToPath(written)} instead of the expected ${stubFile} — its relative import is now wrong and the wormholes proxy is untyped; please report this to @astroscope/wormhole`);
+			}
+		}
+	};
+}
+//#endregion
+//#region src/index.ts
+const stubs = /* @__PURE__ */ new Map();
+function stub(name) {
+	let wormhole = stubs.get(name);
+	if (!wormhole) {
+		wormhole = createWormhole();
+		assignWormholeNames({ [name]: wormhole });
+		stubs.set(name, wormhole);
+	}
+	return wormhole;
+}
+/**
+* Access wormholes by name — `wormholes.cart.get()`. This is the server side of the
+* proxy (the browser build ships its own): values come from the request's
+* wormhole middleware scope, so it works in frontmatter, endpoints, and
+* server-rendered islands alike. Typed via the registry type stub the integration
+* generates from `src/wormholes.ts`.
+*/
+const wormholes = new Proxy({}, { get(_target, prop) {
+	return typeof prop === "string" ? stub(prop) : void 0;
+} });
+//#endregion
+export { assignWormholeNames, wormholeIntegration as default, defineWormhole, wormholes };
 
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/define.ts"],"sourcesContent":["import type { DeepReadonly, Wormhole } from './types.js';\n\n/**\n * Define a wormhole that transfers state from server middleware to client components.\n *\n * **Security:** wormhole data is serialized into the HTML and sent to the browser.\n * Never store secrets (tokens, API keys, credentials) in a wormhole.\n */\nexport function defineWormhole<T>(name: string): Wormhole<T> {\n  const listeners = new Set<(data: DeepReadonly<T>) => void>();\n  const key = `__wormhole_${name}__`;\n  let store: DeepReadonly<T> | undefined;\n\n  return {\n    name,\n    key,\n\n    get(): DeepReadonly<T> {\n      if (store !== undefined) return store;\n\n      const getter = (globalThis as any)[key];\n      const value = typeof getter === 'function' ? (getter() as DeepReadonly<T> | undefined) : undefined;\n\n      if (value === undefined) {\n        throw new Error(`wormhole \"${name}\" is not initialized`);\n      }\n\n      return value;\n    },\n\n    set(data: DeepReadonly<T>): void {\n      if (typeof (globalThis as any).window === 'undefined') {\n        throw new Error(\n          `wormhole \"${name}\" set() cannot be called on the server as it is not request-scoped; use open(wormhole, data, fn) from \"@astroscope/wormhole/server\" instead`,\n        );\n      }\n\n      store = data;\n\n      for (const fn of listeners) fn(data);\n    },\n\n    subscribe(fn: (data: DeepReadonly<T>) => void): () => void {\n      listeners.add(fn);\n\n      return () => {\n        listeners.delete(fn);\n      };\n    },\n  };\n}\n"],"mappings":";;;;;;;AAQA,SAAgB,eAAkB,MAA2B;CAC3D,MAAM,4BAAY,IAAI,IAAqC;CAC3D,MAAM,MAAM,cAAc,KAAK;CAC/B,IAAI;CAEJ,OAAO;EACL;EACA;EAEA,MAAuB;GACrB,IAAI,UAAU,KAAA,GAAW,OAAO;GAEhC,MAAM,SAAU,WAAmB;GACnC,MAAM,QAAQ,OAAO,WAAW,aAAc,OAAO,IAAoC,KAAA;GAEzF,IAAI,UAAU,KAAA,GACZ,MAAM,IAAI,MAAM,aAAa,KAAK,qBAAqB;GAGzD,OAAO;EACT;EAEA,IAAI,MAA6B;GAC/B,IAAI,OAAQ,WAAmB,WAAW,aACxC,MAAM,IAAI,MACR,aAAa,KAAK,4IACpB;GAGF,QAAQ;GAER,KAAK,MAAM,MAAM,WAAW,GAAG,IAAI;EACrC;EAEA,UAAU,IAAiD;GACzD,UAAU,IAAI,EAAE;GAEhB,aAAa;IACX,UAAU,OAAO,EAAE;GACrB;EACF;CACF;AACF"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/extraction/vite-plugin.ts","../src/integration.ts","../src/index.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\nimport { type ExcludePattern, serializeExcludePatterns } from '@astroscope/node/excludes';\nimport { collectRouteIslands, stripQuery } from '@astroscope/node/islands';\nimport type { Plugin } from 'vite';\nimport type { WormholeScan } from './scan.js';\nimport type { WormholeManifest } from './types.js';\n\nexport const WORMHOLE_VIRTUAL_MODULE_ID = 'virtual:@astroscope/wormhole/manifest';\nexport const REGISTRY_VIRTUAL_MODULE_ID = 'virtual:@astroscope/wormhole/registry';\nexport const CONFIG_VIRTUAL_MODULE_ID = 'virtual:@astroscope/wormhole/config';\n\nconst RESOLVED_VIRTUAL_MODULE_ID = `\\0${WORMHOLE_VIRTUAL_MODULE_ID}`;\nconst RESOLVED_REGISTRY_STUB_ID = `\\0${REGISTRY_VIRTUAL_MODULE_ID}`;\nconst RESOLVED_CONFIG_VIRTUAL_MODULE_ID = `\\0${CONFIG_VIRTUAL_MODULE_ID}`;\n\nconst MANIFEST_FILE_NAME = 'wormhole-manifest.json';\n\nconst SCAN_EXTENSIONS = ['.ts', '.tsx', '.js', '.jsx'];\n// compiled astro components are plain modules in the server build\nconst SERVER_SCAN_EXTENSIONS = [...SCAN_EXTENSIONS, '.astro'];\n\n/** chunk file name → manifest key, e.g. `_astro/Counter.abc.js` → `Counter.abc` */\nfunction chunkFileNameToName(fileName: string): string {\n  return fileName.slice(fileName.lastIndexOf('/') + 1).replace(/\\.js$/, '');\n}\n\n/**\n * Build-time side of wormhole slicing: scans modules for `wormholes.<name>`\n * accesses — server modules are attributed to the routes whose page or endpoint\n * reaches them (what the middleware must load), client modules to the emitted\n * chunks (what each island receives) — and drops the manifest next to the server\n * chunks, where the virtual module reads it back at runtime, mirroring the islands\n * and i18n manifests. Dev needs none of this: without a manifest the middleware\n * loads and ships all wormholes with every page.\n */\nexport type WormholeVitePluginOptions = {\n  /** absolute path of `src/wormholes.ts` (or `wormholes/index.ts`), null when the project has none */\n  registryPath: string | null;\n  /** the middleware's exclude patterns, null for the default */\n  exclude: ExcludePattern[] | null;\n  /** route modules (absolute ids) → the route patterns they serve, see `routeEntrypoints` of `@astroscope/node/islands` */\n  pages: () => Map<string, string[]>;\n};\n\nexport function wormholeVitePlugin(options: WormholeVitePluginOptions): Plugin {\n  let isBuild = false;\n  const clientScans = new Map<string, WormholeScan>();\n  const serverScans = new Map<string, WormholeScan>();\n  // names read on the server per route pattern, and the routes reaching each server\n  // module — carried from the server build to the client build, where `<script>`\n  // entries are attributed to routes through the component file owning them\n  const routeNames = new Map<string, Set<string>>();\n  const patternsByFile = new Map<string, Set<string>>();\n\n  return {\n    name: '@astroscope/wormhole/extract',\n\n    configResolved(config) {\n      isBuild = config.command === 'build';\n    },\n\n    resolveId(id) {\n      if (id === WORMHOLE_VIRTUAL_MODULE_ID) return RESOLVED_VIRTUAL_MODULE_ID;\n      if (id === CONFIG_VIRTUAL_MODULE_ID) return RESOLVED_CONFIG_VIRTUAL_MODULE_ID;\n\n      // the registry virtual resolves straight to the project's own module, so the\n      // middleware and user imports share one instance; without a registry file it\n      // falls back to an empty stub (the middleware then opens nothing)\n      if (id === REGISTRY_VIRTUAL_MODULE_ID) return options.registryPath ?? RESOLVED_REGISTRY_STUB_ID;\n    },\n\n    load(id) {\n      if (id === RESOLVED_REGISTRY_STUB_ID) {\n        return 'export const wormholes = {};';\n      }\n\n      if (id === RESOLVED_CONFIG_VIRTUAL_MODULE_ID) {\n        // exclude patterns may contain RegExp — serialized as code, not JSON\n        return `export const exclude = ${options.exclude ? serializeExcludePatterns(options.exclude) : 'null'};`;\n      }\n\n      // the registry carries the handlers, and with them the project's server code\n      if (id === options.registryPath && this.environment?.name === 'client') {\n        throw new Error(\n          `[@astroscope/wormhole] ${path.relative(process.cwd(), id)} is server-only — client code reads wormholes through the \\`wormholes\\` proxy from '@astroscope/wormhole'`,\n        );\n      }\n\n      if (id !== RESOLVED_VIRTUAL_MODULE_ID) return;\n\n      if (!isBuild) {\n        return 'export const manifest = null;';\n      }\n\n      // the manifest only exists after the client build — read it at runtime. astro\n      // bundles middleware at the server root and other code under chunks/, so\n      // probe both relative to wherever this module ended up\n      return `\nimport { readFileSync } from 'node:fs';\nimport { fileURLToPath } from 'node:url';\nimport { dirname, join } from 'node:path';\n\nconst dir = dirname(fileURLToPath(import.meta.url));\n\nlet manifest = null;\n\nfor (const candidate of [\n  join(dir, '${MANIFEST_FILE_NAME}'),\n  join(dir, 'chunks', '${MANIFEST_FILE_NAME}'),\n  join(dir, '..', 'chunks', '${MANIFEST_FILE_NAME}'),\n]) {\n  try {\n    manifest = JSON.parse(readFileSync(candidate, 'utf-8'));\n    break;\n  } catch {\n    manifest = null;\n  }\n}\n\nexport { manifest };\n`;\n    },\n\n    async transform(code, id) {\n      if (!isBuild || !this.environment) return;\n      if (id.includes('node_modules')) return;\n\n      const client = this.environment.name === 'client';\n      const extensions = client ? SCAN_EXTENSIONS : SERVER_SCAN_EXTENSIONS;\n      // astro `<script>` modules carry their language in the query (`?astro&type=script&…&lang.ts`),\n      // other virtual variants (`?astroPropagatedAssets`) keep the file's own extension\n      const file = extensions.some((ext) => id.endsWith(ext)) ? id : stripQuery(id);\n\n      if (!extensions.some((ext) => file.endsWith(ext))) return;\n      if (!code.includes('@astroscope/wormhole')) return;\n\n      // dynamic import keeps the parser out of the SSR runtime bundle\n      const { scanWormholeAccess } = await import('./scan.js');\n      const scan = scanWormholeAccess(code, file);\n\n      if (scan) {\n        (client ? clientScans : serverScans).set(client ? id : stripQuery(id), scan);\n      }\n    },\n\n    async generateBundle() {\n      if (this.environment.name === 'client') return;\n\n      const { routes, patternsByModule } = await collectRouteIslands(this, options.pages());\n\n      for (const pattern of routes.keys()) {\n        routeNames.set(pattern, routeNames.get(pattern) ?? new Set());\n      }\n\n      for (const [id, patterns] of patternsByModule) {\n        const file = stripQuery(id);\n        let owners = patternsByFile.get(file);\n\n        if (!owners) {\n          owners = new Set();\n          patternsByFile.set(file, owners);\n        }\n\n        patterns.forEach((pattern) => owners.add(pattern));\n\n        const scan = serverScans.get(file);\n\n        if (!scan) continue;\n\n        for (const pattern of patterns) {\n          const names = routeNames.get(pattern)!;\n\n          scan.names.forEach((name) => names.add(name));\n\n          if (scan.dynamic) {\n            names.add('*');\n          }\n        }\n      }\n    },\n\n    writeBundle(outputOptions, bundle) {\n      if (this.environment.name !== 'client' || !outputOptions.dir) return;\n\n      const chunks: WormholeManifest['chunks'] = {};\n      const chunkNamesByFileName = new Map<string, string[]>();\n      const chunkEdges = new Map<string, string[]>();\n      const scriptEntries: string[] = [];\n\n      for (const chunk of Object.values(bundle)) {\n        if (chunk.type !== 'chunk') continue;\n\n        const names = new Set<string>();\n        let dynamic = false;\n\n        for (const moduleId of chunk.moduleIds) {\n          const scan = clientScans.get(moduleId);\n\n          scan?.names.forEach((name) => names.add(name));\n          dynamic ||= scan?.dynamic ?? false;\n        }\n\n        const chunkNames = [...(dynamic ? ['*'] : []), ...names];\n\n        if (chunkNames.length > 0) {\n          chunks[chunkFileNameToName(chunk.fileName)] = chunkNames;\n        }\n\n        chunkNamesByFileName.set(chunk.fileName, chunkNames);\n        chunkEdges.set(chunk.fileName, [...chunk.imports, ...chunk.dynamicImports]);\n\n        // astro `<script>` entries are not islands, so no island emission covers\n        // them — their reachable names ship at stream end instead\n        if ((chunk.isEntry || chunk.isDynamicEntry) && chunk.facadeModuleId?.includes('astro&type=script')) {\n          scriptEntries.push(chunk.fileName);\n        }\n      }\n\n      const scriptNames = new Set<string>();\n\n      for (const entry of scriptEntries) {\n        const names = new Set<string>();\n        const visited = new Set<string>();\n\n        const walk = (fileName: string): void => {\n          if (visited.has(fileName)) return;\n\n          visited.add(fileName);\n          chunkNamesByFileName.get(fileName)?.forEach((name) => names.add(name));\n          chunkEdges.get(fileName)?.forEach(walk);\n        };\n\n        walk(entry);\n        names.forEach((name) => scriptNames.add(name));\n\n        // the script belongs to the routes reaching the component it sits in;\n        // an owner the server build never saw means every route may need it\n        const owner = bundle[entry]?.type === 'chunk' ? stripQuery(bundle[entry].facadeModuleId ?? '') : '';\n        const owners = patternsByFile.get(owner) ?? routeNames.keys();\n\n        for (const pattern of owners) {\n          const route = routeNames.get(pattern);\n\n          names.forEach((name) => route?.add(name));\n        }\n      }\n\n      const routes: WormholeManifest['routes'] = {};\n\n      for (const [pattern, names] of routeNames) {\n        routes[pattern] = [...names];\n      }\n\n      const manifest: WormholeManifest = { chunks, scripts: [...scriptNames], routes };\n      const chunksDir = path.resolve(outputOptions.dir, '..', 'server', 'chunks');\n\n      if (fs.existsSync(chunksDir)) {\n        fs.writeFileSync(path.join(chunksDir, MANIFEST_FILE_NAME), JSON.stringify(manifest));\n      } else {\n        console.error(\n          `[@astroscope/wormhole] server chunks directory not found, cannot write manifest to ${chunksDir}`,\n        );\n      }\n    },\n  };\n}\n","import fs from 'node:fs';\nimport path from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport type { ExcludePattern } from '@astroscope/node/excludes';\nimport { routeEntrypoints } from '@astroscope/node/islands';\nimport type { AstroIntegration, IntegrationResolvedRoute } from 'astro';\nimport { wormholeVitePlugin } from './extraction/vite-plugin.js';\n\nexport type WormholeIntegrationOptions = {\n  /** patterns the middleware skips — no handler runs, nothing is delivered; defaults to RECOMMENDED_EXCLUDES */\n  exclude?: ExcludePattern[] | undefined;\n};\n\n/**\n * Astro integration for wormholes with per-route loading and per-island delivery.\n *\n * Resolves the `src/wormholes.ts` registry and exposes it to the middleware as a\n * virtual module, injects the middleware after the project's own (so handlers see\n * everything earlier middleware put on `locals`), registers the vite plugin that\n * scans server and client code for `wormholes.<name>` accesses and maps them onto\n * routes and chunks, and generates the registry type stub that types the\n * `wormholes` proxy. Delivery happens at runtime: the middleware runs the handlers\n * the route needs, and the islands emitter (via `@astroscope/node`) writes each\n * island's slice before its tag.\n */\nexport default function wormholeIntegration(options: WormholeIntegrationOptions = {}): AstroIntegration {\n  const resolveRegistryPath = (srcDir: URL): string | null =>\n    ['wormholes.ts', path.join('wormholes', 'index.ts')]\n      .map((candidate) => path.join(fileURLToPath(srcDir), candidate))\n      .find((candidate) => fs.existsSync(candidate)) ?? null;\n\n  let root = '';\n  let resolvedRoutes: IntegrationResolvedRoute[] = [];\n\n  return {\n    name: '@astroscope/wormhole',\n    hooks: {\n      'astro:config:setup': ({ config, updateConfig, addMiddleware }) => {\n        root = fileURLToPath(config.root);\n\n        addMiddleware({ order: 'post', entrypoint: '@astroscope/wormhole/middleware' });\n\n        updateConfig({\n          vite: {\n            plugins: [\n              wormholeVitePlugin({\n                registryPath: resolveRegistryPath(config.srcDir),\n                exclude: options.exclude ?? null,\n                pages: () => routeEntrypoints(root, resolvedRoutes),\n              }),\n            ],\n          },\n        });\n      },\n\n      'astro:routes:resolved': ({ routes }) => {\n        resolvedRoutes = routes;\n      },\n\n      'astro:config:done': ({ config, injectTypes, logger }) => {\n        const registryPath = resolveRegistryPath(config.srcDir);\n\n        if (!registryPath) {\n          logger.warn('no src/wormholes.ts registry found — the wormholes proxy stays untyped');\n\n          return;\n        }\n\n        // the specifier is relative to the stub's own directory, whose documented\n        // location is `.astro/integrations/<normalized integration name>/` — the\n        // url injectTypes returns verifies the assumption below, so a layout change\n        // in astro fails loudly at sync time instead of silently untyping the proxy\n        const stubFile = path.join(\n          fileURLToPath(config.root),\n          '.astro',\n          'integrations',\n          '_astroscope_wormhole',\n          'registry.d.ts',\n        );\n        const relative = path.relative(path.dirname(stubFile), registryPath.replace(/([/\\\\]index)?\\.ts$/, ''));\n        const specifier = relative.split(path.sep).join('/');\n\n        const written = injectTypes({\n          filename: 'registry.d.ts',\n          content:\n            `import type { UnwrapWormholes } from '@astroscope/wormhole';\\n\\n` +\n            `declare module '@astroscope/wormhole' {\\n` +\n            `  interface WormholeRegistry extends UnwrapWormholes<typeof import(${JSON.stringify(specifier)}).wormholes> {}\\n` +\n            `}\\n`,\n        });\n\n        if (path.resolve(fileURLToPath(written)) !== path.resolve(stubFile)) {\n          logger.error(\n            `registry type stub landed at ${fileURLToPath(written)} instead of the expected ${stubFile} — ` +\n              `its relative import is now wrong and the wormholes proxy is untyped; please report this to @astroscope/wormhole`,\n          );\n        }\n      },\n    },\n  };\n}\n","import { assignWormholeNames, createWormhole } from './define.js';\nimport type { Wormhole, WormholeMap } from './types.js';\n\nexport { default } from './integration.js';\nexport type { WormholeIntegrationOptions } from './integration.js';\nexport { defineWormhole, assignWormholeNames } from './define.js';\nexport type {\n  UnwrapWormholes,\n  Wormhole,\n  WormholeDefinition,\n  WormholeHandler,\n  WormholeMap,\n  WormholeRegistry,\n} from './types.js';\n\nconst stubs = new Map<string, Wormhole<unknown>>();\n\nfunction stub(name: string): Wormhole<unknown> {\n  let wormhole = stubs.get(name);\n\n  if (!wormhole) {\n    wormhole = createWormhole();\n\n    assignWormholeNames({ [name]: wormhole });\n    stubs.set(name, wormhole);\n  }\n\n  return wormhole;\n}\n\n/**\n * Access wormholes by name — `wormholes.cart.get()`. This is the server side of the\n * proxy (the browser build ships its own): values come from the request's\n * wormhole middleware scope, so it works in frontmatter, endpoints, and\n * server-rendered islands alike. Typed via the registry type stub the integration\n * generates from `src/wormholes.ts`.\n */\nexport const wormholes: WormholeMap = new Proxy({} as WormholeMap, {\n  get(_target, prop) {\n    return typeof prop === 'string' ? stub(prop) : undefined;\n  },\n});\n"],"mappings":"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"}

package/dist/key-BqTy1gM3.js

@@ -0,0 +1,9 @@
+//#region src/key.ts
+/** the shared key format for a wormhole's ALS entry — kept free of node imports for the browser build */
+function wormholeKey(name) {
+	return `__wormhole_${name}__`;
+}
+//#endregion
+export { wormholeKey as t };
+
+//# sourceMappingURL=key-BqTy1gM3.js.map

package/dist/key-BqTy1gM3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-BqTy1gM3.js","names":[],"sources":["../src/key.ts"],"sourcesContent":["/** the shared key format for a wormhole's ALS entry — kept free of node imports for the browser build */\nexport function wormholeKey(name: string): string {\n  return `__wormhole_${name}__`;\n}\n"],"mappings":";;AACA,SAAgB,YAAY,MAAsB;CAChD,OAAO,cAAc,KAAK;AAC5B"}

package/dist/middleware-entrypoint.d.ts

@@ -0,0 +1,4 @@
+//#region src/middleware-entrypoint.d.ts
+export declare const onRequest: import("astro").MiddlewareHandler;
+//#endregion
+//# sourceMappingURL=middleware-entrypoint.d.ts.map

package/dist/middleware-entrypoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware-entrypoint.d.ts","names":[],"sources":["../src/middleware-entrypoint.ts"],"mappings":";qBAGa,2BAAS"}

package/dist/middleware-entrypoint.js

@@ -0,0 +1,263 @@
+import { t as als } from "./als-CntRqWdO.js";
+import { i as getWormholeSource, t as assignWormholeNames } from "./define-1UkPnsXV.js";
+import { getRouteIslands, registerDocumentEmitter, registerIslandEmitter } from "@astroscope/node/islands";
+import { RECOMMENDED_EXCLUDES, shouldExclude } from "@astroscope/node/excludes";
+import { exclude } from "virtual:@astroscope/wormhole/config";
+import { maybeAll, maybeThen } from "@entwico/dash";
+import { wormholes } from "virtual:@astroscope/wormhole/registry";
+import { log } from "@astroscope/node/log";
+import { manifest } from "virtual:@astroscope/wormhole/manifest";
+import { DURATION_BUCKETS, createCounter, createHistogram, errorType, withSpan } from "@astroscope/node/telemetry";
+//#region src/client-state.ts
+/**
+* Script generation for wormhole delivery, shipped through the `@astroscope/node`
+* islands pipeline (see islands-emitter.ts for the placement policy).
+*/
+/** values may contain `<\/script>` — escape `<` so they cannot end the tag */
+function jsonForScript(value) {
+	return JSON.stringify(value).replace(/</g, "\\u003c");
+}
+/**
+* Inline script writing entries onto `self.__wormholes__` and notifying listeners —
+* the counterpart of the browser proxy's entry protocol, safe in either order.
+*/
+function createWormholeMergeScript(entries) {
+	return `<script>{const s=self.__wormholes__??={},d=${jsonForScript(entries)};for(const n in d){const e=s[n]??={};e.v=d[n];e.l&&e.l.forEach(f=>f(e.v))}}<\/script>`;
+}
+//#endregion
+//#region src/manifest.ts
+/** null in dev and when the build produced no manifest (broken deploy → full delivery fallback) */
+function getWormholeManifest() {
+	return manifest;
+}
+//#endregion
+//#region src/reachable.ts
+/** public url or dist-relative file name of a chunk → manifest chunk name, e.g. `…/_astro/Counter.abc.js` → `Counter.abc` */
+function chunkName(url) {
+	return url.slice(url.lastIndexOf("/") + 1).replace(/\.js$/, "");
+}
+/**
+* The wormhole names the chunks of a closure can reach; `null` when one of them
+* reads dynamically (`*` — all open wormholes).
+*/
+function namesInClosure(closure, manifest) {
+	const names = /* @__PURE__ */ new Set();
+	for (const url of closure) for (const name of manifest.chunks[chunkName(url)] ?? []) {
+		if (name === "*") return null;
+		names.add(name);
+	}
+	return [...names];
+}
+//#endregion
+//#region src/request-store.ts
+const requestWormholes = /* @__PURE__ */ new WeakMap();
+function setRequestWormholes(request, wormholes) {
+	requestWormholes.set(request, wormholes);
+}
+function getRequestWormholes(request) {
+	return requestWormholes.get(request);
+}
+//#endregion
+//#region src/islands-emitter.ts
+/**
+* Contributes each island's wormhole slice: an inline merge script with the values
+* of every open wormhole the island's full chunk closure (dynamic imports included)
+* can reach, emitted before the island tag — parsed strictly before the island
+* connects, even mid-stream. Names already written earlier in the document are
+* skipped; a `*` chunk (dynamic proxy access) degrades to all open wormholes.
+*/
+const IS_DEV = !!import.meta.env?.DEV;
+let registered = false;
+let warnedMissingManifest = false;
+const reachableByManifest = /* @__PURE__ */ new WeakMap();
+function reachableFor(island, manifest) {
+	let byIsland = reachableByManifest.get(manifest);
+	if (!byIsland) {
+		byIsland = /* @__PURE__ */ new WeakMap();
+		reachableByManifest.set(manifest, byIsland);
+	}
+	const cached = byIsland.get(island);
+	if (cached !== void 0) return cached;
+	const reachable = namesInClosure(island.fullClosure, manifest);
+	byIsland.set(island, reachable);
+	return reachable;
+}
+/**
+* The document-level wormhole delivery, exported for tests: everything open as
+* `head` content in dev (or without a manifest), script-entry names as `end`
+* content in prod — running after the rewriter, names the islands emitter
+* already wrote are skipped race-free.
+*/
+function createWormholeDocumentEmitter(dev = IS_DEV) {
+	return (context) => {
+		const request = getRequestWormholes(context.request);
+		if (!request || request.values.size === 0) return null;
+		if (dev) return { head: createWormholeMergeScript(Object.fromEntries(request.values)) };
+		const manifest = getWormholeManifest();
+		if (!manifest) {
+			if (!warnedMissingManifest) {
+				warnedMissingManifest = true;
+				log.error("wormhole manifest not found — delivering all open wormholes with every page (is the integration configured?)");
+			}
+			return { head: createWormholeMergeScript(Object.fromEntries(request.values)) };
+		}
+		const names = manifest.scripts.includes("*") ? [...request.values.keys()] : manifest.scripts.filter((name) => request.values.has(name));
+		if (names.length === 0) return null;
+		return { end: () => {
+			const fresh = names.filter((name) => !request.emitted.has(name));
+			if (fresh.length === 0) return null;
+			return createWormholeMergeScript(Object.fromEntries(fresh.map((name) => [name, request.values.get(name)])));
+		} };
+	};
+}
+function registerWormholeEmitters() {
+	if (registered) return;
+	registered = true;
+	registerDocumentEmitter(createWormholeDocumentEmitter());
+	registerIslandEmitter((island, context) => {
+		if (!context) return null;
+		const request = getRequestWormholes(context.request);
+		const manifest = getWormholeManifest();
+		if (!request || request.values.size === 0 || !manifest) return null;
+		const reachable = reachableFor(island, manifest);
+		const entries = {};
+		let count = 0;
+		for (const name of reachable ?? request.values.keys()) {
+			if (!request.values.has(name) || request.emitted.has(name)) continue;
+			request.emitted.add(name);
+			entries[name] = request.values.get(name);
+			count++;
+		}
+		if (count === 0) return null;
+		return { html: createWormholeMergeScript(entries) };
+	});
+}
+//#endregion
+//#region src/telemetry.ts
+const SCOPE = "@astroscope/wormhole";
+const handlerDuration = createHistogram("astro.wormhole.handler.duration", {
+	scope: SCOPE,
+	description: "Wormhole handler execution per request",
+	unit: "s",
+	buckets: DURATION_BUCKETS.io
+});
+const handlerFailures = createCounter("astro.wormhole.handler.failures", {
+	scope: SCOPE,
+	description: "Wormhole handlers that threw",
+	unit: "{handler}"
+});
+/**
+* Runs one handler under its own span (child of the request span — the
+* handlers run in parallel, so the trace shows which one holds the page's
+* first byte), records its duration and counts and logs a failure. A
+* synchronous handler stays synchronous.
+*/
+function measureHandler(name, run) {
+	const attributes = { "astro.wormhole.name": name };
+	const started = performance.now();
+	const fail = (error) => {
+		handlerFailures.add(1, {
+			...attributes,
+			"error.type": errorType(error)
+		});
+		log.error(error instanceof Error ? {
+			err: error,
+			wormhole: name
+		} : {
+			reason: error,
+			wormhole: name
+		}, "wormhole handler failed");
+		throw error;
+	};
+	return withSpan(`wormhole ${name}`, {
+		scope: SCOPE,
+		attributes
+	}, () => {
+		let result;
+		try {
+			result = run();
+		} catch (error) {
+			return fail(error);
+		}
+		return maybeThen(result, (value) => {
+			handlerDuration.record((performance.now() - started) / 1e3, attributes);
+			return value;
+		}, fail);
+	});
+}
+//#endregion
+//#region src/middleware.ts
+/**
+* The wormhole middleware, injected by the integration after the project's own
+* middleware: runs the handlers of the wormholes the request's route can read —
+* server and `<script>` reads from the manifest, island reads through the route's
+* islands from `@astroscope/node`, and eager wormholes — makes the values
+* readable on the server for the duration of the request, and hands them to the
+* islands pipeline for delivery. Routes the build could not attribute (dev, no
+* manifest, astro's own routes) load everything.
+*/
+function createWormholeMiddleware(options = {}) {
+	assignWormholeNames(wormholes);
+	registerWormholeEmitters();
+	const sources = /* @__PURE__ */ new Map();
+	for (const [name, wormhole] of Object.entries(wormholes)) {
+		const source = getWormholeSource(wormhole);
+		if (!source) throw new Error(`wormhole "${name}" has no handler — define it with defineWormhole({ handler: (ctx) => ... })`);
+		sources.set(name, source);
+	}
+	const everything = [...sources.keys()];
+	const eager = everything.filter((name) => sources.get(name).eager);
+	const entriesByRoute = /* @__PURE__ */ new Map();
+	const routeNames = (pattern) => {
+		const manifest = getWormholeManifest();
+		if (!manifest) return null;
+		const server = manifest.routes[pattern];
+		const islands = getRouteIslands(pattern);
+		if (!server || !islands || server.includes("*")) return null;
+		const names = /* @__PURE__ */ new Set([...eager, ...server]);
+		for (const island of islands) {
+			const reachable = namesInClosure(island.fullClosure, manifest);
+			if (!reachable) return null;
+			reachable.forEach((name) => names.add(name));
+		}
+		return [...names].filter((name) => sources.has(name));
+	};
+	const entriesFor = (pattern) => {
+		let entries = entriesByRoute.get(pattern);
+		if (!entries) {
+			entries = (routeNames(pattern) ?? everything).map((name) => ({
+				name,
+				key: wormholes[name].key,
+				handler: sources.get(name).handler
+			}));
+			entriesByRoute.set(pattern, entries);
+		}
+		return entries;
+	};
+	return (ctx, next) => {
+		if (shouldExclude(ctx, options.exclude ?? RECOMMENDED_EXCLUDES)) return next();
+		const entries = entriesFor(ctx.routePattern);
+		return maybeThen(maybeAll(entries.map((entry) => measureHandler(entry.name, () => entry.handler(ctx)))), (loaded) => {
+			const open = /* @__PURE__ */ new Map();
+			const scope = new Map(als.getStore());
+			for (let i = 0; i < entries.length; i++) {
+				const data = loaded[i];
+				if (data === void 0) continue;
+				open.set(entries[i].name, data);
+				scope.set(entries[i].key, data);
+			}
+			setRequestWormholes(ctx.request, {
+				values: open,
+				emitted: /* @__PURE__ */ new Set()
+			});
+			return als.run(scope, () => next());
+		});
+	};
+}
+//#endregion
+//#region src/middleware-entrypoint.ts
+const onRequest = createWormholeMiddleware({ exclude: exclude ?? void 0 });
+//#endregion
+export { onRequest };
+
+//# sourceMappingURL=middleware-entrypoint.js.map