@elurjs/kit 2.4.10 → 2.5.1

package/dist/lib/adapters/node.js.map

@@ -1 +1 @@
-{"version":3,"file":"node.js","names":[],"sources":["../../../src/adapters/node.ts"],"sourcesContent":["import { mkdir, rm, stat, writeFile } from \"node:fs/promises\";\nimport { relative, resolve } from \"node:path\";\nimport { build } from \"vite\";\nimport { scanRoutes } from \"../router/route-scanner.js\";\nimport type { Adapter } from \"./index.js\";\nimport { writeSsrEntry } from \"./shared.js\";\nimport { DEFAULT_CAPABILITIES } from \"../runtime/capabilities.js\";\n\n/**\n * Node adapter for elur-kit.\n *\n * Produces a self-contained Node server entry at `.elur/node-server.mjs`.\n * Run it with:\n *\n *   node .elur/node-server.mjs\n *\n * The server serves static files from `dist/` and renders pages on demand for\n * unmatched routes.\n */\nexport const nodeAdapter: Adapter = {\n  name: \"node\",\n  capabilities: DEFAULT_CAPABILITIES,\n\n  async build(options) {\n    const root = resolve(options.root);\n    const outDir = resolve(root, options.outDir);\n    const generatedDir = resolve(root, \".elur\");\n\n    try {\n      await stat(outDir);\n    } catch {\n      throw new Error(\n        `Output directory not found: ${outDir}. Run \"elur-kit build\" first.`,\n      );\n    }\n\n    await rm(generatedDir, { recursive: true, force: true });\n    await mkdir(generatedDir, { recursive: true });\n\n    const appDir = resolve(root, options.appDir);\n    const routes = await scanRoutes(appDir);\n\n    const entryPath = resolve(generatedDir, \"node-index.ts\");\n    await writeSsrEntry(entryPath, routes, options);\n\n    const serverPath = resolve(generatedDir, \"node-server.ts\");\n    await writeFile(\n      serverPath,\n      buildNodeServerSource(relativeToUrlPath(generatedDir, outDir), options),\n      \"utf8\",\n    );\n\n    await build({\n      configFile: false,\n      root,\n      build: {\n        outDir: generatedDir,\n        emptyOutDir: false,\n        ssr: true,\n        lib: {\n          entry: serverPath,\n          formats: [\"es\"],\n        },\n        rollupOptions: {\n          external: [/^@elurjs\\/kit(?:\\/.*)?$/, /^@elurjs\\/core(?:\\/.*)?$/, /^node:/],\n          output: {\n            entryFileNames: \"node-server.mjs\",\n            inlineDynamicImports: true,\n          },\n        },\n      },\n    });\n  },\n};\n\nfunction buildNodeServerSource(\n  outDirUrl: string,\n  options: {\n    clientEntry: string;\n    lang: string;\n    port?: number;\n  },\n): string {\n  return `// AUTO-GENERATED by @elurjs/kit. Do not edit.\nimport { createServer } from \"node:http\";\nimport { fileURLToPath } from \"node:url\";\nimport { createWebHandler } from \"@elurjs/kit/runtime\";\nimport { incomingMessageToRequest } from \"@elurjs/kit/runtime\";\nimport handler from \"./node-index.ts\";\n\nconst outDir = fileURLToPath(new URL(${JSON.stringify(outDirUrl)}, import.meta.url));\nconst port = Number(process.env.PORT) || ${options.port ?? 3000};\n\n// The adapter-bundled handler already handles actions, API routes, render\n// endpoint and dynamic SSR. We only need to add static file serving from\n// the output directory, then fall through to the bundled handler.\nconst webHandler = createWebHandler(\n  { pages: [], api: [], error404: undefined, error500: undefined },\n  {},\n  { staticRoot: outDir, lang: ${JSON.stringify(options.lang)}, clientEntry: ${JSON.stringify(options.clientEntry)} },\n);\n\ncreateServer(async (req, res) => {\n  const body = req.method !== \"GET\" && req.method !== \"HEAD\"\n    ? await readBody(req)\n    : undefined;\n  const request = incomingMessageToRequest(req, body);\n  // Try static files first via the unified handler, then fall back to the\n  // bundled SSR handler for dynamic routes.\n  let response = await webHandler(request);\n  if (response.status === 404) {\n    response = await handler(request);\n  }\n  res.writeHead(response.status, Object.fromEntries(response.headers.entries()));\n  res.end(Buffer.from(await response.arrayBuffer()));\n}).listen(port, () => {\n  console.log(\\`Node server running at http://localhost:\\${port}\\`);\n});\n\nfunction readBody(req: import(\"node:http\").IncomingMessage): Promise<Buffer> {\n  return new Promise((resolve, reject) => {\n    const chunks: Buffer[] = [];\n    req.on(\"data\", (chunk) => chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk)));\n    req.on(\"end\", () => resolve(Buffer.concat(chunks)));\n    req.on(\"error\", reject);\n  });\n}\n`;\n}\n\nfunction relativeToUrlPath(from: string, to: string): string {\n  const path = relative(from, to).split(\"\\\\\").join(\"/\");\n  return `${path.startsWith(\".\") ? path : `./${path}`}/`;\n}\n"],"mappings":";;;;;;;AAmBA,IAAa,IAAuB;CAClC,MAAM;CACN,cAAc;CAEd,MAAM,MAAM,GAAS;EACnB,IAAM,IAAO,EAAQ,EAAQ,IAAI,GAC3B,IAAS,EAAQ,GAAM,EAAQ,MAAM,GACrC,IAAe,EAAQ,GAAM,OAAO;EAE1C,IAAI;GACF,MAAM,EAAK,CAAM;EACnB,QAAQ;GACN,MAAU,MACR,+BAA+B,EAAO,8BACxC;EACF;EAGA,AADA,MAAM,EAAG,GAAc;GAAE,WAAW;GAAM,OAAO;EAAK,CAAC,GACvD,MAAM,EAAM,GAAc,EAAE,WAAW,GAAK,CAAC;EAE7C,IAAM,IAAS,EAAQ,GAAM,EAAQ,MAAM,GACrC,IAAS,MAAM,EAAW,CAAM,GAEhC,IAAY,EAAQ,GAAc,eAAe;EACvD,MAAM,EAAc,GAAW,GAAQ,CAAO;EAE9C,IAAM,IAAa,EAAQ,GAAc,gBAAgB;EAOzD,AANA,MAAM,EACJ,GACA,EAAsB,EAAkB,GAAc,CAAM,GAAG,CAAO,GACtE,MACF,GAEA,MAAM,EAAM;GACV,YAAY;GACZ;GACA,OAAO;IACL,QAAQ;IACR,aAAa;IACb,KAAK;IACL,KAAK;KACH,OAAO;KACP,SAAS,CAAC,IAAI;IAChB;IACA,eAAe;KACb,UAAU;MAAC;MAA2B;MAA4B;KAAQ;KAC1E,QAAQ;MACN,gBAAgB;MAChB,sBAAsB;KACxB;IACF;GACF;EACF,CAAC;CACH;AACF;AAEA,SAAS,EACP,GACA,GAKQ;CACR,OAAO;;;;;;;uCAO8B,KAAK,UAAU,CAAS,EAAE;2CACtB,EAAQ,QAAQ,IAAK;;;;;;;;gCAQhC,KAAK,UAAU,EAAQ,IAAI,EAAE,iBAAiB,KAAK,UAAU,EAAQ,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BlH;AAEA,SAAS,EAAkB,GAAc,GAAoB;CAC3D,IAAM,IAAO,EAAS,GAAM,CAAE,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK,GAAG;CACpD,OAAO,GAAG,EAAK,WAAW,GAAG,IAAI,IAAO,KAAK,IAAO;AACtD"}
+{"version":3,"file":"node.js","names":[],"sources":["../../../src/adapters/node.ts"],"sourcesContent":["import { mkdir, rm, stat, writeFile } from \"node:fs/promises\";\nimport { relative, resolve } from \"node:path\";\nimport { build } from \"vite\";\nimport { scanRoutes } from \"../router/route-scanner.js\";\nimport type { Adapter } from \"./index.js\";\nimport { writeSsrEntry } from \"./shared.js\";\nimport { DEFAULT_CAPABILITIES } from \"../runtime/capabilities.js\";\n\n/**\n * Node adapter for elur-kit.\n *\n * Produces a self-contained Node server entry at `.elur/node-server.mjs`.\n * Run it with:\n *\n *   node .elur/node-server.mjs\n *\n * The server serves static files from `dist/` and renders pages on demand for\n * unmatched routes.\n */\nexport const nodeAdapter: Adapter = {\n  name: \"node\",\n  capabilities: DEFAULT_CAPABILITIES,\n\n  async build(options) {\n    const root = resolve(options.root);\n    const outDir = resolve(root, options.outDir);\n    const generatedDir = resolve(root, \".elur\");\n\n    try {\n      await stat(outDir);\n    } catch {\n      throw new Error(\n        `Output directory not found: ${outDir}. Run \"elur-kit build\" first.`,\n      );\n    }\n\n    await rm(generatedDir, { recursive: true, force: true });\n    await mkdir(generatedDir, { recursive: true });\n\n    const appDir = resolve(root, options.appDir);\n    const routes = await scanRoutes(appDir);\n\n    const entryPath = resolve(generatedDir, \"node-index.ts\");\n    await writeSsrEntry(entryPath, routes, options);\n\n    const serverPath = resolve(generatedDir, \"node-server.ts\");\n    await writeFile(\n      serverPath,\n      buildNodeServerSource(relativeToUrlPath(generatedDir, outDir), options),\n      \"utf8\",\n    );\n\n    await build({\n      configFile: false,\n      root,\n      build: {\n        outDir: generatedDir,\n        emptyOutDir: false,\n        ssr: true,\n        lib: {\n          entry: serverPath,\n          formats: [\"es\"],\n        },\n        rollupOptions: {\n          external: [/^@elurjs\\/kit(?:\\/.*)?$/, /^@elurjs\\/core(?:\\/.*)?$/, /^node:/],\n          output: {\n            entryFileNames: \"node-server.mjs\",\n            inlineDynamicImports: true,\n          },\n        },\n      },\n    });\n  },\n};\n\nfunction buildNodeServerSource(\n  outDirUrl: string,\n  options: {\n    clientEntry: string;\n    lang: string;\n    port?: number;\n    logLevel?: string;\n    redirects?: import(\"../router/redirects.js\").RedirectRule[];\n    rewrites?: import(\"../router/redirects.js\").RewriteRule[];\n    routeHeaders?: import(\"../router/redirects.js\").RouteHeadersRule[];\n  },\n): string {\n  const logLevelOption = options.logLevel ? `, logLevel: ${JSON.stringify(options.logLevel)}` : \"\";\n  // Rule arrays are plain data: emit them as JSON literals when defined.\n  const routingOptions = ([\"redirects\", \"rewrites\", \"routeHeaders\"] as const)\n    .map((key) => {\n      const rules = options[key];\n      return rules && rules.length > 0 ? `, ${key}: ${JSON.stringify(rules)}` : \"\";\n    })\n    .join(\"\");\n  return `// AUTO-GENERATED by @elurjs/kit. Do not edit.\nimport { createServer } from \"node:http\";\nimport { fileURLToPath } from \"node:url\";\nimport { createWebHandler } from \"@elurjs/kit/runtime\";\nimport { incomingMessageToRequest, sendWebResponse } from \"@elurjs/kit/runtime\";\nimport handler from \"./node-index.ts\";\n\nconst outDir = fileURLToPath(new URL(${JSON.stringify(outDirUrl)}, import.meta.url));\nconst port = Number(process.env.PORT) || ${options.port ?? 3000};\n\n// The adapter-bundled handler already handles actions, API routes, render\n// endpoint and dynamic SSR. We only need to add static file serving from\n// the output directory, then fall through to the bundled handler.\nconst webHandler = createWebHandler(\n  { pages: [], api: [], error404: undefined, error500: undefined },\n  {},\n  { staticRoot: outDir, lang: ${JSON.stringify(options.lang)}, clientEntry: ${JSON.stringify(options.clientEntry)}${logLevelOption}${routingOptions} },\n);\n\ncreateServer(async (req, res) => {\n  const body = req.method !== \"GET\" && req.method !== \"HEAD\"\n    ? await readBody(req)\n    : undefined;\n  const request = incomingMessageToRequest(req, body);\n  // Try static files first via the unified handler, then fall back to the\n  // bundled SSR handler for dynamic routes.\n  let response = await webHandler(request);\n  if (response.status === 404) {\n    response = await handler(request);\n  }\n  // Streams the body: streaming SSR chunks flush as they are produced.\n  await sendWebResponse(res, response);\n}).listen(port, () => {\n  console.log(\\`Node server running at http://localhost:\\${port}\\`);\n});\n\nfunction readBody(req: import(\"node:http\").IncomingMessage): Promise<Buffer> {\n  return new Promise((resolve, reject) => {\n    const chunks: Buffer[] = [];\n    req.on(\"data\", (chunk) => chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk)));\n    req.on(\"end\", () => resolve(Buffer.concat(chunks)));\n    req.on(\"error\", reject);\n  });\n}\n`;\n}\n\nfunction relativeToUrlPath(from: string, to: string): string {\n  const path = relative(from, to).split(\"\\\\\").join(\"/\");\n  return `${path.startsWith(\".\") ? path : `./${path}`}/`;\n}\n"],"mappings":";;;;;;;AAmBA,IAAa,IAAuB;CAClC,MAAM;CACN,cAAc;CAEd,MAAM,MAAM,GAAS;EACnB,IAAM,IAAO,EAAQ,EAAQ,IAAI,GAC3B,IAAS,EAAQ,GAAM,EAAQ,MAAM,GACrC,IAAe,EAAQ,GAAM,OAAO;EAE1C,IAAI;GACF,MAAM,EAAK,CAAM;EACnB,QAAQ;GACN,MAAU,MACR,+BAA+B,EAAO,8BACxC;EACF;EAGA,AADA,MAAM,EAAG,GAAc;GAAE,WAAW;GAAM,OAAO;EAAK,CAAC,GACvD,MAAM,EAAM,GAAc,EAAE,WAAW,GAAK,CAAC;EAE7C,IAAM,IAAS,EAAQ,GAAM,EAAQ,MAAM,GACrC,IAAS,MAAM,EAAW,CAAM,GAEhC,IAAY,EAAQ,GAAc,eAAe;EACvD,MAAM,EAAc,GAAW,GAAQ,CAAO;EAE9C,IAAM,IAAa,EAAQ,GAAc,gBAAgB;EAOzD,AANA,MAAM,EACJ,GACA,EAAsB,EAAkB,GAAc,CAAM,GAAG,CAAO,GACtE,MACF,GAEA,MAAM,EAAM;GACV,YAAY;GACZ;GACA,OAAO;IACL,QAAQ;IACR,aAAa;IACb,KAAK;IACL,KAAK;KACH,OAAO;KACP,SAAS,CAAC,IAAI;IAChB;IACA,eAAe;KACb,UAAU;MAAC;MAA2B;MAA4B;KAAQ;KAC1E,QAAQ;MACN,gBAAgB;MAChB,sBAAsB;KACxB;IACF;GACF;EACF,CAAC;CACH;AACF;AAEA,SAAS,EACP,GACA,GASQ;CACR,IAAM,IAAiB,EAAQ,WAAW,eAAe,KAAK,UAAU,EAAQ,QAAQ,MAAM,IAExF,IAAkB;EAAC;EAAa;EAAY;CAAc,CAAC,CAC9D,KAAK,MAAQ;EACZ,IAAM,IAAQ,EAAQ;EACtB,OAAO,KAAS,EAAM,SAAS,IAAI,KAAK,EAAI,IAAI,KAAK,UAAU,CAAK,MAAM;CAC5E,CAAC,CAAC,CACD,KAAK,EAAE;CACV,OAAO;;;;;;;uCAO8B,KAAK,UAAU,CAAS,EAAE;2CACtB,EAAQ,QAAQ,IAAK;;;;;;;;gCAQhC,KAAK,UAAU,EAAQ,IAAI,EAAE,iBAAiB,KAAK,UAAU,EAAQ,WAAW,IAAI,IAAiB,EAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BpJ;AAEA,SAAS,EAAkB,GAAc,GAAoB;CAC3D,IAAM,IAAO,EAAS,GAAM,CAAE,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK,GAAG;CACpD,OAAO,GAAG,EAAK,WAAW,GAAG,IAAI,IAAO,KAAK,IAAO;AACtD"}

package/dist/lib/adapters/vercel.cjs

@@ -1,2 +1,2 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../route-scanner-JY6YrNH5.cjs"),t=require("../shared-CfqOLsKj.cjs"),n=require("../capabilities-C0TDQoMY.cjs");let r=require("node:fs/promises"),i=require("node:path"),a=require("vite");var o={name:`vercel`,capabilities:n.r,async build(n){let o=(0,i.resolve)(n.root),s=(0,i.resolve)(o,n.outDir),c=(0,i.resolve)(o,`.vercel/output`),l=(0,i.join)(c,`functions`,`__elur-js-kit.func`),u=(0,i.resolve)(o,`.elur`);try{await(0,r.stat)(s)}catch{throw Error(`Output directory not found: ${s}. Run "elur-kit build" first.`)}await(0,r.rm)(c,{recursive:!0,force:!0}),await(0,r.mkdir)(c,{recursive:!0}),await(0,r.mkdir)(l,{recursive:!0}),await(0,r.mkdir)(u,{recursive:!0}),await t.t(s,(0,i.join)(c,`static`));let d=(0,i.resolve)(o,n.appDir),f=await e.t(d),p=(0,i.resolve)(u,`vercel-index.ts`);await t.n(p,f,n),await(0,a.build)({configFile:!1,root:o,build:{outDir:l,emptyOutDir:!0,ssr:!0,lib:{entry:p,formats:[`es`],fileName:()=>`index.js`},rollupOptions:{external:[],output:{inlineDynamicImports:!0}}}});let m=(0,i.join)(l,`vercel-index.js`),h=(0,i.join)(l,`index.js`);try{await(0,r.stat)(m),await(0,r.rename)(m,h)}catch{}await(0,r.writeFile)((0,i.join)(l,`.vc-config.json`),JSON.stringify({runtime:`nodejs20.x`,handler:`index.js`,launcherType:`Nodejs`,shouldAddHelpers:!0},null,2),`utf8`),await(0,r.writeFile)((0,i.join)(c,`config.json`),JSON.stringify({version:3,routes:[{handle:`filesystem`},{src:`/(.*)`,dest:`/__elur-js-kit`}]},null,2),`utf8`)}};exports.vercelAdapter=o;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../route-scanner-JY6YrNH5.cjs"),t=require("../capabilities-C0TDQoMY.cjs"),n=require("../shared-CP0Dc3cp.cjs");let r=require("node:fs/promises"),i=require("node:path"),a=require("vite");var o={name:`vercel`,capabilities:t.r,async build(t){let o=(0,i.resolve)(t.root),s=(0,i.resolve)(o,t.outDir),c=(0,i.resolve)(o,`.vercel/output`),l=(0,i.join)(c,`functions`,`__elur-js-kit.func`),u=(0,i.resolve)(o,`.elur`);try{await(0,r.stat)(s)}catch{throw Error(`Output directory not found: ${s}. Run "elur-kit build" first.`)}await(0,r.rm)(c,{recursive:!0,force:!0}),await(0,r.mkdir)(c,{recursive:!0}),await(0,r.mkdir)(l,{recursive:!0}),await(0,r.mkdir)(u,{recursive:!0}),await n.t(s,(0,i.join)(c,`static`));let d=(0,i.resolve)(o,t.appDir),f=await e.t(d),p=(0,i.resolve)(u,`vercel-index.ts`);await n.n(p,f,t),await(0,a.build)({configFile:!1,root:o,build:{outDir:l,emptyOutDir:!0,ssr:!0,lib:{entry:p,formats:[`es`],fileName:()=>`index.js`},rollupOptions:{external:[],output:{inlineDynamicImports:!0}}}});let m=(0,i.join)(l,`vercel-index.js`),h=(0,i.join)(l,`index.js`);try{await(0,r.stat)(m),await(0,r.rename)(m,h)}catch{}await(0,r.writeFile)((0,i.join)(l,`.vc-config.json`),JSON.stringify({runtime:`nodejs20.x`,handler:`index.js`,launcherType:`Nodejs`,shouldAddHelpers:!0},null,2),`utf8`),await(0,r.writeFile)((0,i.join)(c,`config.json`),JSON.stringify({version:3,routes:[{handle:`filesystem`},{src:`/(.*)`,dest:`/__elur-js-kit`}]},null,2),`utf8`)}};exports.vercelAdapter=o;
 //# sourceMappingURL=vercel.cjs.map

package/dist/lib/adapters/vercel.js

@@ -1,15 +1,15 @@
 import { t as e } from "../route-scanner-XcLId7lK.js";
-import { n as t, t as n } from "../shared-DU3iQgr7.js";
-import { r } from "../capabilities-C7txofmY.js";
+import { r as t } from "../capabilities-C7txofmY.js";
+import { n, t as r } from "../shared-D8w-neq2.js";
 import { mkdir as i, rename as a, rm as o, stat as s, writeFile as c } from "node:fs/promises";
 import { join as l, resolve as u } from "node:path";
 import { build as d } from "vite";
 //#region src/adapters/vercel.ts
 var f = {
 	name: "vercel",
-	capabilities: r,
-	async build(r) {
-		let f = u(r.root), p = u(f, r.outDir), m = u(f, ".vercel/output"), h = l(m, "functions", "__elur-js-kit.func"), g = u(f, ".elur");
+	capabilities: t,
+	async build(t) {
+		let f = u(t.root), p = u(f, t.outDir), m = u(f, ".vercel/output"), h = l(m, "functions", "__elur-js-kit.func"), g = u(f, ".elur");
 		try {
 			await s(p);
 		} catch {
@@ -18,9 +18,9 @@ var f = {
 		await o(m, {
 			recursive: !0,
 			force: !0
-		}), await i(m, { recursive: !0 }), await i(h, { recursive: !0 }), await i(g, { recursive: !0 }), await n(p, l(m, "static"));
-		let _ = u(f, r.appDir), v = await e(_), y = u(g, "vercel-index.ts");
-		await t(y, v, r), await d({
+		}), await i(m, { recursive: !0 }), await i(h, { recursive: !0 }), await i(g, { recursive: !0 }), await r(p, l(m, "static"));
+		let _ = u(f, t.appDir), v = await e(_), y = u(g, "vercel-index.ts");
+		await n(y, v, t), await d({
 			configFile: !1,
 			root: f,
 			build: {

package/dist/lib/build/build.d.cts

@@ -46,6 +46,38 @@ export interface BuildConfig {
      * the endpoint (no 404 storms on static hosts like Vercel).
      */
     renderEndpoint?: boolean;
+    /**
+     * Client router options (Fase 8.3 + §9). `enabled`/`prefetch`/`morph`/
+     * `loadingIndicator` are baked into the generated entry; `separate` makes
+     * the router its own generated module (emitted as its own chunk when the
+     * client bundle declares it as an input) so pages without islands only
+     * load `router.js`; `entry` is that chunk's public URL; `speculation`
+     * emits a Speculation Rules block on static pages.
+     */
+    router?: {
+        enabled?: boolean;
+        prefetch?: boolean;
+        morph?: boolean;
+        loadingIndicator?: boolean;
+        speculation?: "prefetch" | "prerender";
+        /** Generate a standalone router module next to the client entry. */
+        separate?: boolean;
+        /** Public URL of the router chunk (default: "/_elur/router.js"). */
+        entry?: string;
+        /** Path of the generated router module (default: sibling "router.ts"). */
+        outFile?: string;
+    };
+    /**
+     * Client JS emission mode: `"modern"` gates the entry per page (0% JS);
+     * `"legacy"` emits the combined entry unconditionally on every page.
+     */
+    js?: "modern" | "legacy";
+    /**
+     * Public site URL (e.g. "https://example.com"). When set, the build
+     * generates `sitemap.xml` from the scanned routes automatically, unless
+     * one already exists in the output (from `public/` or an integration).
+     */
+    site?: string;
     /**
      * Integrations to invoke during the build lifecycle. When provided, the
      * `build` hook fires after all pages and image variants are generated,
@@ -53,6 +85,14 @@ export interface BuildConfig {
      * robots.txt, search indexes, etc.) into the output directory.
      */
     integrations?: ElurKitIntegration[];
+    /**
+     * Optional observer invoked once per build phase with its duration in
+     * milliseconds ("scan", "pages", "images", "integrations", "sitemap").
+     * Phases that don't run (no images, no integrations, no site URL) are not
+     * reported. Used by the CLI to render progress; the build itself stays
+     * silent.
+     */
+    onPhase?: (name: string, durationMs: number) => void;
 }
 export interface BuildResult {
     /** Number of static HTML pages generated. */

package/dist/lib/build/build.d.ts

@@ -46,6 +46,38 @@ export interface BuildConfig {
      * the endpoint (no 404 storms on static hosts like Vercel).
      */
     renderEndpoint?: boolean;
+    /**
+     * Client router options (Fase 8.3 + §9). `enabled`/`prefetch`/`morph`/
+     * `loadingIndicator` are baked into the generated entry; `separate` makes
+     * the router its own generated module (emitted as its own chunk when the
+     * client bundle declares it as an input) so pages without islands only
+     * load `router.js`; `entry` is that chunk's public URL; `speculation`
+     * emits a Speculation Rules block on static pages.
+     */
+    router?: {
+        enabled?: boolean;
+        prefetch?: boolean;
+        morph?: boolean;
+        loadingIndicator?: boolean;
+        speculation?: "prefetch" | "prerender";
+        /** Generate a standalone router module next to the client entry. */
+        separate?: boolean;
+        /** Public URL of the router chunk (default: "/_elur/router.js"). */
+        entry?: string;
+        /** Path of the generated router module (default: sibling "router.ts"). */
+        outFile?: string;
+    };
+    /**
+     * Client JS emission mode: `"modern"` gates the entry per page (0% JS);
+     * `"legacy"` emits the combined entry unconditionally on every page.
+     */
+    js?: "modern" | "legacy";
+    /**
+     * Public site URL (e.g. "https://example.com"). When set, the build
+     * generates `sitemap.xml` from the scanned routes automatically, unless
+     * one already exists in the output (from `public/` or an integration).
+     */
+    site?: string;
     /**
      * Integrations to invoke during the build lifecycle. When provided, the
      * `build` hook fires after all pages and image variants are generated,
@@ -53,6 +85,14 @@ export interface BuildConfig {
      * robots.txt, search indexes, etc.) into the output directory.
      */
     integrations?: ElurKitIntegration[];
+    /**
+     * Optional observer invoked once per build phase with its duration in
+     * milliseconds ("scan", "pages", "images", "integrations", "sitemap").
+     * Phases that don't run (no images, no integrations, no site URL) are not
+     * reported. Used by the CLI to render progress; the build itself stays
+     * silent.
+     */
+    onPhase?: (name: string, durationMs: number) => void;
 }
 export interface BuildResult {
     /** Number of static HTML pages generated. */

package/dist/lib/build/document-shell.d.cts

@@ -1,4 +1,5 @@
 import type { PageMetadata } from "../types.js";
+export type SpeculationMode = "prefetch" | "prerender";
 export interface ShellOptions {
     /** Rendered inner HTML that goes inside `#app`. */
     body: string;
@@ -25,8 +26,33 @@ export interface ShellOptions {
     data?: unknown;
     /** Per-page action names serialized into `<script id="elur-actions">`. */
     actions?: Record<string, string[]>;
-    /** Path to the client entry module, e.g. `/_elur/entry-client.js`. */
+    /**
+     * Path to the client entry module, e.g. `/_elur/entry-client.js`. In split
+     * builds this is the hydrate-only entry; callers gate it per page so it is
+     * only emitted when the rendered body actually contains islands.
+     */
     clientEntry?: string;
+    /**
+     * Path to the standalone client router module, e.g. `/_elur/router.js`
+     * (split builds only). Emitted as a second `<script type="module">` so pages
+     * without islands still get SPA navigation without paying for the islands
+     * entry.
+     */
+    routerEntry?: string;
+    /**
+     * Whether the client router is enabled for this page. When `false`, the
+     * `elur:render-endpoint` meta is omitted entirely: no client router will run,
+     * so there is nothing to advertise endpoint availability to.
+     */
+    routerEnabled?: boolean;
+    /**
+     * Speculation Rules API mode emitted as
+     * `<script type="speculationrules">` with document rules and
+     * `eagerness: "moderate"`. Chromium-only progressive enhancement — other
+     * browsers ignore the unknown script type. Only set this for static builds;
+     * never apply to URLs reachable via server actions.
+     */
+    speculation?: SpeculationMode;
     /** Page metadata emitted as `<meta>`, `<link>` and OG/Twitter tags in `<head>`. */
     metadata?: PageMetadata;
     /**
@@ -38,6 +64,26 @@ export interface ShellOptions {
      */
     renderEndpoint?: boolean;
 }
+/**
+ * Explicit delimiters around the `#app` content. The streaming pipeline
+ * (`createStreamingResponse`) and adapter render endpoints extract the page
+ * body with these markers instead of parsing the shell layout by hand, so
+ * changes to the shell markup never break extraction. They are HTML comments:
+ * invisible, and ignored by hydration and the SPA router.
+ */
+export declare const APP_START_MARKER = "<!--elur:app:start-->";
+export declare const APP_END_MARKER = "<!--elur:app:end-->";
+/**
+ * Extracts the inner HTML of `#app` from a full document produced by
+ * `documentShell`. Returns `undefined` when the markers are missing (e.g. a
+ * hand-written document).
+ */
+export declare function extractAppBody(html: string): string | undefined;
+/**
+ * Serializes data for embedding inside a `<script>` tag. Escapes `<` so a
+ * `</script>` sequence in the data cannot break out of the tag.
+ */
+export declare function serializeData(data: unknown): string;
 /**
  * Builds the `<head>` tags for a `PageMetadata` object. Every tag is marked with
  * `data-elur-head` so the client-side router can replace them on navigation

package/dist/lib/build/document-shell.d.ts

@@ -1,4 +1,5 @@
 import type { PageMetadata } from "../types.js";
+export type SpeculationMode = "prefetch" | "prerender";
 export interface ShellOptions {
     /** Rendered inner HTML that goes inside `#app`. */
     body: string;
@@ -25,8 +26,33 @@ export interface ShellOptions {
     data?: unknown;
     /** Per-page action names serialized into `<script id="elur-actions">`. */
     actions?: Record<string, string[]>;
-    /** Path to the client entry module, e.g. `/_elur/entry-client.js`. */
+    /**
+     * Path to the client entry module, e.g. `/_elur/entry-client.js`. In split
+     * builds this is the hydrate-only entry; callers gate it per page so it is
+     * only emitted when the rendered body actually contains islands.
+     */
     clientEntry?: string;
+    /**
+     * Path to the standalone client router module, e.g. `/_elur/router.js`
+     * (split builds only). Emitted as a second `<script type="module">` so pages
+     * without islands still get SPA navigation without paying for the islands
+     * entry.
+     */
+    routerEntry?: string;
+    /**
+     * Whether the client router is enabled for this page. When `false`, the
+     * `elur:render-endpoint` meta is omitted entirely: no client router will run,
+     * so there is nothing to advertise endpoint availability to.
+     */
+    routerEnabled?: boolean;
+    /**
+     * Speculation Rules API mode emitted as
+     * `<script type="speculationrules">` with document rules and
+     * `eagerness: "moderate"`. Chromium-only progressive enhancement — other
+     * browsers ignore the unknown script type. Only set this for static builds;
+     * never apply to URLs reachable via server actions.
+     */
+    speculation?: SpeculationMode;
     /** Page metadata emitted as `<meta>`, `<link>` and OG/Twitter tags in `<head>`. */
     metadata?: PageMetadata;
     /**
@@ -38,6 +64,26 @@ export interface ShellOptions {
      */
     renderEndpoint?: boolean;
 }
+/**
+ * Explicit delimiters around the `#app` content. The streaming pipeline
+ * (`createStreamingResponse`) and adapter render endpoints extract the page
+ * body with these markers instead of parsing the shell layout by hand, so
+ * changes to the shell markup never break extraction. They are HTML comments:
+ * invisible, and ignored by hydration and the SPA router.
+ */
+export declare const APP_START_MARKER = "<!--elur:app:start-->";
+export declare const APP_END_MARKER = "<!--elur:app:end-->";
+/**
+ * Extracts the inner HTML of `#app` from a full document produced by
+ * `documentShell`. Returns `undefined` when the markers are missing (e.g. a
+ * hand-written document).
+ */
+export declare function extractAppBody(html: string): string | undefined;
+/**
+ * Serializes data for embedding inside a `<script>` tag. Escapes `<` so a
+ * `</script>` sequence in the data cannot break out of the tag.
+ */
+export declare function serializeData(data: unknown): string;
 /**
  * Builds the `<head>` tags for a `PageMetadata` object. Every tag is marked with
  * `data-elur-head` so the client-side router can replace them on navigation

package/dist/lib/build/vite-build.d.cts

@@ -1,9 +1,22 @@
+import { type InlineConfig } from "vite";
 import { type InterpolationMode } from "../vite/interpolation-plugin.js";
 export interface ClientBuildOptions {
     /** Project root (absolute). */
     root: string;
-    /** Absolute path to the user's Vite client config (e.g. vite.client.config.ts). */
-    userConfigPath: string;
+    /**
+     * Absolute path to the user's Vite client config (e.g.
+     * vite.client.config.ts). When omitted, a default config is generated
+     * from `defaultInputs` — the generated entry plus, in split builds, the
+     * generated router module — so projects get a working bundle with zero
+     * client config.
+     */
+    userConfigPath?: string;
+    /**
+     * Default bundle inputs (name → absolute entry path) used when no user
+     * config is present. With `entry-client` + `router` keys the output is
+     * `entry-client.js` + `router.js`.
+     */
+    defaultInputs?: Record<string, string>;
     /** Absolute path to the app directory (used by the interpolation plugin). */
     appDir: string;
     /** Absolute path to the islands directory (used by the interpolation plugin). */
@@ -14,6 +27,8 @@ export interface ClientBuildOptions {
     base?: string;
     /** Optional log prefix. */
     logPrefix?: string;
+    /** Suppress bundle logs (kit's and Vite's); errors still surface. */
+    quiet?: boolean;
     /**
      * How the legacy interpolation transform is handled (default: "auto").
      * With a Elur core that supports partial attribute interpolation natively
@@ -36,6 +51,14 @@ export interface ClientBuildResult {
  * transformed before reaching the browser.
  */
 export declare function buildClientBundle(options: ClientBuildOptions): Promise<ClientBuildResult>;
+export declare function loadUserConfig(path: string, _root: string): Promise<InlineConfig>;
+/**
+ * Resolves a user Vite config's `build.rollupOptions.input` to a list of
+ * absolute entry paths. Used to detect whether the bundle will emit the
+ * generated router module as its own chunk (split build) or not (legacy
+ * single-entry bundle — the router stays embedded in the entry).
+ */
+export declare function resolveClientInputs(userConfigPath: string, root: string): Promise<string[]>;
 export interface AtomicStageOptions {
     /** Final destination directory (absolute). */
     outDir: string;

package/dist/lib/build/vite-build.d.ts

@@ -1,9 +1,22 @@
+import { type InlineConfig } from "vite";
 import { type InterpolationMode } from "../vite/interpolation-plugin.js";
 export interface ClientBuildOptions {
     /** Project root (absolute). */
     root: string;
-    /** Absolute path to the user's Vite client config (e.g. vite.client.config.ts). */
-    userConfigPath: string;
+    /**
+     * Absolute path to the user's Vite client config (e.g.
+     * vite.client.config.ts). When omitted, a default config is generated
+     * from `defaultInputs` — the generated entry plus, in split builds, the
+     * generated router module — so projects get a working bundle with zero
+     * client config.
+     */
+    userConfigPath?: string;
+    /**
+     * Default bundle inputs (name → absolute entry path) used when no user
+     * config is present. With `entry-client` + `router` keys the output is
+     * `entry-client.js` + `router.js`.
+     */
+    defaultInputs?: Record<string, string>;
     /** Absolute path to the app directory (used by the interpolation plugin). */
     appDir: string;
     /** Absolute path to the islands directory (used by the interpolation plugin). */
@@ -14,6 +27,8 @@ export interface ClientBuildOptions {
     base?: string;
     /** Optional log prefix. */
     logPrefix?: string;
+    /** Suppress bundle logs (kit's and Vite's); errors still surface. */
+    quiet?: boolean;
     /**
      * How the legacy interpolation transform is handled (default: "auto").
      * With a Elur core that supports partial attribute interpolation natively
@@ -36,6 +51,14 @@ export interface ClientBuildResult {
  * transformed before reaching the browser.
  */
 export declare function buildClientBundle(options: ClientBuildOptions): Promise<ClientBuildResult>;
+export declare function loadUserConfig(path: string, _root: string): Promise<InlineConfig>;
+/**
+ * Resolves a user Vite config's `build.rollupOptions.input` to a list of
+ * absolute entry paths. Used to detect whether the bundle will emit the
+ * generated router module as its own chunk (split build) or not (legacy
+ * single-entry bundle — the router stays embedded in the entry).
+ */
+export declare function resolveClientInputs(userConfigPath: string, root: string): Promise<string[]>;
 export interface AtomicStageOptions {
     /** Final destination directory (absolute). */
     outDir: string;

package/dist/lib/cache/adapter.d.cts

@@ -0,0 +1,41 @@
+export interface CacheEntry {
+    html: string;
+    generatedAt: number;
+    revalidate: number;
+    tags?: string[];
+    version?: string;
+}
+export interface CacheWriteOptions {
+    revalidate: number;
+    tags?: string[];
+    version?: string;
+}
+export interface CacheAdapter {
+    get(key: string): Promise<CacheEntry | null>;
+    set(key: string, value: CacheEntry, options: CacheWriteOptions): Promise<void>;
+    delete(key: string): Promise<void>;
+    invalidateTags(tags: readonly string[]): Promise<void>;
+}
+/** Computes a SHA-256 key from a normalized identity string. */
+export declare function cacheKey(...parts: string[]): string;
+export interface FsCacheAdapterOptions {
+    cacheDir: string;
+    /** Max entries before cleanup runs. Default: 1000. */
+    maxEntries?: number;
+    /** Max age in ms for entries. Default: 24h. */
+    maxAgeMs?: number;
+}
+export declare function createFsCacheAdapter(options: FsCacheAdapterOptions): CacheAdapter;
+/**
+ * Gets a cached entry. If the entry is stale (past revalidate), serves it
+ * immediately and triggers a background revalidation.
+ *
+ * @param adapter The cache adapter.
+ * @param key The cache key.
+ * @param revalidate The revalidation function (called if stale or missing).
+ * @returns The cache entry (fresh or stale), or null if missing.
+ */
+export declare function getWithSWR(adapter: CacheAdapter, key: string, revalidate: () => Promise<CacheEntry | null>): Promise<{
+    entry: CacheEntry | null;
+    stale: boolean;
+}>;

package/dist/lib/cache/adapter.d.ts

@@ -0,0 +1,41 @@
+export interface CacheEntry {
+    html: string;
+    generatedAt: number;
+    revalidate: number;
+    tags?: string[];
+    version?: string;
+}
+export interface CacheWriteOptions {
+    revalidate: number;
+    tags?: string[];
+    version?: string;
+}
+export interface CacheAdapter {
+    get(key: string): Promise<CacheEntry | null>;
+    set(key: string, value: CacheEntry, options: CacheWriteOptions): Promise<void>;
+    delete(key: string): Promise<void>;
+    invalidateTags(tags: readonly string[]): Promise<void>;
+}
+/** Computes a SHA-256 key from a normalized identity string. */
+export declare function cacheKey(...parts: string[]): string;
+export interface FsCacheAdapterOptions {
+    cacheDir: string;
+    /** Max entries before cleanup runs. Default: 1000. */
+    maxEntries?: number;
+    /** Max age in ms for entries. Default: 24h. */
+    maxAgeMs?: number;
+}
+export declare function createFsCacheAdapter(options: FsCacheAdapterOptions): CacheAdapter;
+/**
+ * Gets a cached entry. If the entry is stale (past revalidate), serves it
+ * immediately and triggers a background revalidation.
+ *
+ * @param adapter The cache adapter.
+ * @param key The cache key.
+ * @param revalidate The revalidation function (called if stale or missing).
+ * @returns The cache entry (fresh or stale), or null if missing.
+ */
+export declare function getWithSWR(adapter: CacheAdapter, key: string, revalidate: () => Promise<CacheEntry | null>): Promise<{
+    entry: CacheEntry | null;
+    stale: boolean;
+}>;

package/dist/lib/cache/index.cjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../invalidation-CFpNQUv6.cjs"),t=require("../cache-X1n4Ossu.cjs"),n=require("../adapter-Dz2hzR36.cjs");function r(e){let t=e.client,n=e.prefix??`elur-kit:`,r=e=>`${n}data:${e}`,i=e=>`${n}tag:${e}`;async function a(e){let n=await t.get(r(e));if(!n)return null;try{return JSON.parse(n)}catch{return null}}async function o(e,n,a){let o={html:n.html,generatedAt:n.generatedAt??Date.now(),revalidate:a.revalidate,tags:a.tags,version:a.version},s=r(e),c=JSON.stringify(o);if(a.revalidate>0?await t.set(s,c,{PX:a.revalidate*1e3}):await t.set(s,c),a.tags&&a.tags.length>0&&t.sadd&&t.srem)for(let e of a.tags)await t.sadd(i(e),s)}async function s(e){await t.del(r(e))}async function c(e){if(e.length!==0){if(t.smembers&&t.srem){let n=new Set;for(let r of e){let e=await t.smembers(i(r));for(let t of e)n.add(t);await t.del(i(r))}n.size>0&&await t.del([...n])}else{let r=await t.keys(`${n}data:*`);for(let n of r){let r=await t.get(n);if(r)try{JSON.parse(r).tags?.some(t=>e.includes(t))&&await t.del(n)}catch{}}}}}return{get:a,set:o,delete:s,invalidateTags:c}}function i(e){let t=e.namespace,n=e.prefix??`elur-kit:`,r=e=>`${n}data:${e}`,i=e=>`${n}tag:${e}`;async function a(e){let n=await t.get(i(e));if(!n)return[];try{return JSON.parse(n)}catch{return[]}}async function o(e,n){await t.put(i(e),JSON.stringify(n))}async function s(e){let n=await t.get(r(e));if(!n)return null;try{return JSON.parse(n)}catch{return null}}async function c(e,n,i){let s={html:n.html,generatedAt:n.generatedAt??Date.now(),revalidate:i.revalidate,tags:i.tags,version:i.version},c=r(e),l=JSON.stringify(s);if(i.revalidate>0?await t.put(c,l,{expirationTtl:i.revalidate}):await t.put(c,l),i.tags&&i.tags.length>0)for(let e of i.tags){let t=await a(e);t.includes(c)||(t.push(c),await o(e,t))}}async function l(e){await t.delete(r(e))}async function u(e){if(e.length!==0)for(let n of e){let e=await a(n);for(let n of e)await t.delete(n);await t.delete(i(n))}}return{get:s,set:c,delete:l,invalidateTags:u}}exports.CacheInvalidator=e.t,exports.DEFAULT_CACHE_POLICY=e.i,exports.cacheKey=n.n,exports.clearCache=t.t,exports.connectCacheAdapter=e.n,exports.createCloudflareKVCacheAdapter=i,exports.createFsCacheAdapter=n.r,exports.createRedisCacheAdapter=r,exports.defaultInvalidator=e.r,exports.getCachedHtml=t.n,exports.getWithSWR=n.i,exports.isStale=t.r,exports.normalizeCachePolicy=e.a,exports.setCachedHtml=t.i,exports.shouldCachePublic=e.o;
+//# sourceMappingURL=index.cjs.map

package/dist/lib/cache/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":[],"sources":["../../../src/cache/redis-adapter.ts"],"sourcesContent":["// --- Redis / Upstash / Cloudflare KV Cache Adapter (v2.1 — Fix #3) ---\n//\n// Pluggable cache adapter for serverless and distributed deployments.\n// Implements the same CacheAdapter interface as the filesystem adapter, so\n// it can be dropped in via config without changing application code.\n//\n// Supports any Redis-compatible client (node-redis, ioredis, Upstash REST,\n// Cloudflare KV via @upstash/redis or direct API).\n\nimport type { CacheAdapter, CacheEntry, CacheWriteOptions } from \"./adapter.js\";\n\n// ─── Redis Cache Adapter ────────────────────────────────────────────────────\n\nexport interface RedisCacheAdapterOptions {\n  /**\n   * Redis client with get/set/del commands.\n   * Compatible with node-redis, ioredis, and Upstash.\n   */\n  client: RedisClient;\n  /** Key prefix to namespace cache entries. Default: \"elur-kit:\". */\n  prefix?: string;\n}\n\nexport interface RedisClient {\n  get(key: string): Promise<string | null>;\n  set(key: string, value: string, opts?: { EX?: number; PX?: number; NX?: boolean }): Promise<unknown>;\n  del(key: string | string[]): Promise<number>;\n  keys(pattern: string): Promise<string[]>;\n  srem?(key: string, ...members: string[]): Promise<number>;\n  smembers?(key: string): Promise<string[]>;\n  sadd?(key: string, ...members: string[]): Promise<number>;\n}\n\nexport function createRedisCacheAdapter(options: RedisCacheAdapterOptions): CacheAdapter {\n  const client = options.client;\n  const prefix = options.prefix ?? \"elur-kit:\";\n\n  const dataKey = (key: string) => `${prefix}data:${key}`;\n  const tagKey = (tag: string) => `${prefix}tag:${tag}`;\n\n  async function get(key: string): Promise<CacheEntry | null> {\n    const raw = await client.get(dataKey(key));\n    if (!raw) return null;\n    try {\n      return JSON.parse(raw) as CacheEntry;\n    } catch {\n      return null;\n    }\n  }\n\n  async function set(key: string, value: CacheEntry, opts: CacheWriteOptions): Promise<void> {\n    const entry: CacheEntry = {\n      html: value.html,\n      generatedAt: value.generatedAt ?? Date.now(),\n      revalidate: opts.revalidate,\n      tags: opts.tags,\n      version: opts.version,\n    };\n    const fullKey = dataKey(key);\n    const serialized = JSON.stringify(entry);\n\n    // Set TTL on the Redis key if revalidate is set (convert seconds to ms for PX).\n    if (opts.revalidate > 0) {\n      await client.set(fullKey, serialized, { PX: opts.revalidate * 1000 });\n    } else {\n      await client.set(fullKey, serialized);\n    }\n\n    // Update tag index using Redis sets if available.\n    if (opts.tags && opts.tags.length > 0 && client.sadd && client.srem) {\n      for (const tag of opts.tags) {\n        await client.sadd(tagKey(tag), fullKey);\n      }\n    }\n  }\n\n  async function del(key: string): Promise<void> {\n    await client.del(dataKey(key));\n  }\n\n  async function invalidateTags(tags: readonly string[]): Promise<void> {\n    if (tags.length === 0) return;\n\n    if (client.smembers && client.srem) {\n      // Use Redis sets for O(1) tag lookup.\n      const keysToDelete = new Set<string>();\n      for (const tag of tags) {\n        const members = await client.smembers(tagKey(tag));\n        for (const m of members) keysToDelete.add(m);\n        await client.del(tagKey(tag));\n      }\n      if (keysToDelete.size > 0) {\n        await client.del([...keysToDelete]);\n      }\n    } else {\n      // Fallback: scan all data keys and check tags in the entry.\n      const allKeys = await client.keys(`${prefix}data:*`);\n      for (const fullKey of allKeys) {\n        const raw = await client.get(fullKey);\n        if (!raw) continue;\n        try {\n          const entry = JSON.parse(raw) as CacheEntry;\n          if (entry.tags?.some((t) => tags.includes(t))) {\n            await client.del(fullKey);\n          }\n        } catch {\n          // skip corrupt entries\n        }\n      }\n    }\n  }\n\n  return { get, set, delete: del, invalidateTags };\n}\n\n// ─── Cloudflare KV Cache Adapter ────────────────────────────────────────────\n\nexport interface CloudflareKVAdapterOptions {\n  /**\n   * Cloudflare KV namespace binding (from wrangler.toml env binding).\n   * Must implement `get`, `put`, and `delete` methods.\n   */\n  namespace: CloudflareKVNamespace;\n  /** Key prefix to namespace cache entries. Default: \"elur-kit:\". */\n  prefix?: string;\n}\n\nexport interface CloudflareKVNamespace {\n  get(key: string): Promise<string | null>;\n  put(key: string, value: string, options?: { expirationTtl?: number }): Promise<void>;\n  delete(key: string): Promise<void>;\n  list(options?: { prefix?: string }): Promise<{ keys: { name: string; metadata?: unknown }[] }>;\n}\n\nexport function createCloudflareKVCacheAdapter(options: CloudflareKVAdapterOptions): CacheAdapter {\n  const kv = options.namespace;\n  const prefix = options.prefix ?? \"elur-kit:\";\n\n  const dataKey = (key: string) => `${prefix}data:${key}`;\n  const tagKey = (tag: string) => `${prefix}tag:${tag}`;\n\n  // KV doesn't have sets, so we store tag → keys as a JSON string.\n  async function loadTagKeys(tag: string): Promise<string[]> {\n    const raw = await kv.get(tagKey(tag));\n    if (!raw) return [];\n    try {\n      return JSON.parse(raw) as string[];\n    } catch {\n      return [];\n    }\n  }\n\n  async function saveTagKeys(tag: string, keys: string[]): Promise<void> {\n    await kv.put(tagKey(tag), JSON.stringify(keys));\n  }\n\n  async function get(key: string): Promise<CacheEntry | null> {\n    const raw = await kv.get(dataKey(key));\n    if (!raw) return null;\n    try {\n      return JSON.parse(raw) as CacheEntry;\n    } catch {\n      return null;\n    }\n  }\n\n  async function set(key: string, value: CacheEntry, opts: CacheWriteOptions): Promise<void> {\n    const entry: CacheEntry = {\n      html: value.html,\n      generatedAt: value.generatedAt ?? Date.now(),\n      revalidate: opts.revalidate,\n      tags: opts.tags,\n      version: opts.version,\n    };\n    const fullKey = dataKey(key);\n    const serialized = JSON.stringify(entry);\n\n    // KV supports expirationTtl in seconds.\n    if (opts.revalidate > 0) {\n      await kv.put(fullKey, serialized, { expirationTtl: opts.revalidate });\n    } else {\n      await kv.put(fullKey, serialized);\n    }\n\n    // Update tag index.\n    if (opts.tags && opts.tags.length > 0) {\n      for (const tag of opts.tags) {\n        const existing = await loadTagKeys(tag);\n        if (!existing.includes(fullKey)) {\n          existing.push(fullKey);\n          await saveTagKeys(tag, existing);\n        }\n      }\n    }\n  }\n\n  async function del(key: string): Promise<void> {\n    await kv.delete(dataKey(key));\n  }\n\n  async function invalidateTags(tags: readonly string[]): Promise<void> {\n    if (tags.length === 0) return;\n    for (const tag of tags) {\n      const keys = await loadTagKeys(tag);\n      for (const fullKey of keys) {\n        await kv.delete(fullKey);\n      }\n      await kv.delete(tagKey(tag));\n    }\n  }\n\n  return { get, set, delete: del, invalidateTags };\n}\n"],"mappings":"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"}

package/dist/lib/cache/index.d.cts

@@ -0,0 +1,5 @@
+export { type CacheAdapter, type CacheEntry, type CacheWriteOptions, type FsCacheAdapterOptions, createFsCacheAdapter, cacheKey, getWithSWR, } from "./adapter.js";
+export { type RedisCacheAdapterOptions, type RedisClient, createRedisCacheAdapter, type CloudflareKVAdapterOptions, type CloudflareKVNamespace, createCloudflareKVCacheAdapter, } from "./redis-adapter.js";
+export { type CacheMode, type CachePolicy, DEFAULT_CACHE_POLICY, normalizeCachePolicy, shouldCachePublic, } from "./policy.js";
+export { type InvalidationEvent, type InvalidationListener, CacheInvalidator, defaultInvalidator, connectCacheAdapter, } from "./invalidation.js";
+export { getCachedHtml, setCachedHtml, isStale, clearCache, type CacheOptions, } from "../cache.js";

package/dist/lib/cache/index.d.ts

@@ -0,0 +1,5 @@
+export { type CacheAdapter, type CacheEntry, type CacheWriteOptions, type FsCacheAdapterOptions, createFsCacheAdapter, cacheKey, getWithSWR, } from "./adapter.js";
+export { type RedisCacheAdapterOptions, type RedisClient, createRedisCacheAdapter, type CloudflareKVAdapterOptions, type CloudflareKVNamespace, createCloudflareKVCacheAdapter, } from "./redis-adapter.js";
+export { type CacheMode, type CachePolicy, DEFAULT_CACHE_POLICY, normalizeCachePolicy, shouldCachePublic, } from "./policy.js";
+export { type InvalidationEvent, type InvalidationListener, CacheInvalidator, defaultInvalidator, connectCacheAdapter, } from "./invalidation.js";
+export { getCachedHtml, setCachedHtml, isStale, clearCache, type CacheOptions, } from "../cache.js";