@elurjs/kit 2.4.4

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

@@ -0,0 +1,25 @@
+/** Cache mode for a route. */
+export type CacheMode = "public" | "private" | "dynamic";
+/** Cache policy declared by the route's data module. */
+export interface CachePolicy {
+    mode: CacheMode;
+    revalidate: number;
+    tags?: string[];
+}
+/** Default cache policy when none is declared. */
+export declare const DEFAULT_CACHE_POLICY: CachePolicy;
+/**
+ * Normalizes a raw cache export from a data module into a CachePolicy.
+ * Returns the default policy if the input is invalid or missing.
+ */
+export declare function normalizeCachePolicy(raw: unknown): CachePolicy;
+/**
+ * Determines whether a route's cache policy allows public caching for the
+ * given request.
+ *
+ * Per §9.1:
+ * - "dynamic" → never cache
+ * - "private" → never cache publicly (requires private adapter)
+ * - "public" → cache only if request has no Cookie/Authorization
+ */
+export declare function shouldCachePublic(policy: CachePolicy, request: Request): boolean;

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

@@ -0,0 +1,25 @@
+/** Cache mode for a route. */
+export type CacheMode = "public" | "private" | "dynamic";
+/** Cache policy declared by the route's data module. */
+export interface CachePolicy {
+    mode: CacheMode;
+    revalidate: number;
+    tags?: string[];
+}
+/** Default cache policy when none is declared. */
+export declare const DEFAULT_CACHE_POLICY: CachePolicy;
+/**
+ * Normalizes a raw cache export from a data module into a CachePolicy.
+ * Returns the default policy if the input is invalid or missing.
+ */
+export declare function normalizeCachePolicy(raw: unknown): CachePolicy;
+/**
+ * Determines whether a route's cache policy allows public caching for the
+ * given request.
+ *
+ * Per §9.1:
+ * - "dynamic" → never cache
+ * - "private" → never cache publicly (requires private adapter)
+ * - "public" → cache only if request has no Cookie/Authorization
+ */
+export declare function shouldCachePublic(policy: CachePolicy, request: Request): boolean;

package/dist/lib/cache.d.cts

@@ -0,0 +1,13 @@
+export interface CacheEntry {
+    html: string;
+    generatedAt: number;
+    revalidate: number;
+}
+export interface CacheOptions {
+    cacheDir: string;
+    defaultRevalidate?: number;
+}
+export declare function getCachedHtml(cacheDir: string, pathname: string): Promise<CacheEntry | undefined>;
+export declare function setCachedHtml(cacheDir: string, pathname: string, html: string, revalidate: number): Promise<void>;
+export declare function isStale(cacheDir: string, pathname: string): Promise<boolean>;
+export declare function clearCache(cacheDir: string): Promise<void>;

package/dist/lib/cache.d.ts

@@ -0,0 +1,13 @@
+export interface CacheEntry {
+    html: string;
+    generatedAt: number;
+    revalidate: number;
+}
+export interface CacheOptions {
+    cacheDir: string;
+    defaultRevalidate?: number;
+}
+export declare function getCachedHtml(cacheDir: string, pathname: string): Promise<CacheEntry | undefined>;
+export declare function setCachedHtml(cacheDir: string, pathname: string, html: string, revalidate: number): Promise<void>;
+export declare function isStale(cacheDir: string, pathname: string): Promise<boolean>;
+export declare function clearCache(cacheDir: string): Promise<void>;

package/dist/lib/capabilities-C0TDQoMY.cjs

@@ -0,0 +1,2 @@
+var e={streaming:!0,filesystem:`persistent`,imageRuntime:!0,backgroundWork:!0},t={streaming:!0,filesystem:`ephemeral`,imageRuntime:!1,backgroundWork:!1,maxBodySize:1048576},n={streaming:!0,filesystem:`readonly`,imageRuntime:!1,backgroundWork:!1,maxBodySize:1048576};function r(t={}){return{...e,...t}}function i(e={streaming:!0}){return e.streaming!==!1}function a(e){return e.filesystem===`persistent`}function o(e){return e.filesystem===`persistent`||e.filesystem===`ephemeral`}function s(e,t={}){let n=[];return t.isr&&!a(e)&&n.push(`ISR requires a persistent filesystem; the host declares filesystem="${e.filesystem}".`),t.images&&e.imageRuntime===!1&&e.filesystem===`none`&&n.push(`On-demand image transforms require either imageRuntime=true or a readable filesystem; the host has neither.`),t.streaming&&e.streaming===!1&&n.push(`Streaming was requested but the host declares streaming=false.`),{ok:n.length===0,problems:n}}Object.defineProperty(exports,"a",{enumerable:!0,get:function(){return a}}),Object.defineProperty(exports,"c",{enumerable:!0,get:function(){return s}}),Object.defineProperty(exports,"i",{enumerable:!0,get:function(){return r}}),Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return n}}),Object.defineProperty(exports,"o",{enumerable:!0,get:function(){return i}}),Object.defineProperty(exports,"r",{enumerable:!0,get:function(){return t}}),Object.defineProperty(exports,"s",{enumerable:!0,get:function(){return o}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return e}});
+//# sourceMappingURL=capabilities-C0TDQoMY.cjs.map

package/dist/lib/capabilities-C0TDQoMY.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities-C0TDQoMY.cjs","names":[],"sources":["../../src/runtime/capabilities.ts"],"sourcesContent":["// --- Adapter capabilities contract (§8.5) ---\n//\n// Every runtime host (Node CLI, Vite dev, Node/Bun adapters, Vercel, Netlify)\n// declares an explicit `AdapterCapabilities` object. The framework uses it to\n// decide which features are safe to enable: streaming, filesystem access,\n// runtime image transforms, background work, body size limits, ISR persistence.\n//\n// Invalid or incompatible capability combinations fail fast during build.\n\nexport type FilesystemCapability = \"none\" | \"readonly\" | \"persistent\" | \"ephemeral\";\n\nexport interface AdapterCapabilities {\n  /** Whether the host supports streaming responses (ReadableStream bodies). */\n  streaming: boolean;\n  /** Filesystem access model of the host. */\n  filesystem: FilesystemCapability;\n  /** Whether the host can run image transforms at request time. */\n  imageRuntime: boolean;\n  /** Whether the host allows background work after the response completes. */\n  backgroundWork: boolean;\n  /** Maximum request body size in bytes accepted by the host (if any). */\n  maxBodySize?: number;\n}\n\nexport interface CapabilityOptions {\n  streaming?: boolean;\n  filesystem?: FilesystemCapability;\n  imageRuntime?: boolean;\n  backgroundWork?: boolean;\n  maxBodySize?: number;\n}\n\n/** Default capabilities for a full-featured long-lived Node/Bun process. */\nexport const DEFAULT_CAPABILITIES: AdapterCapabilities = {\n  streaming: true,\n  filesystem: \"persistent\",\n  imageRuntime: true,\n  backgroundWork: true,\n};\n\n/** Default capabilities for a stateless serverless function (Vercel/Netlify). */\nexport const SERVERLESS_CAPABILITIES: AdapterCapabilities = {\n  streaming: true,\n  filesystem: \"ephemeral\",\n  imageRuntime: false,\n  backgroundWork: false,\n  maxBodySize: 1_048_576,\n};\n\n/** Default capabilities for an edge runtime (read-only filesystem). */\nexport const EDGE_CAPABILITIES: AdapterCapabilities = {\n  streaming: true,\n  filesystem: \"readonly\",\n  imageRuntime: false,\n  backgroundWork: false,\n  maxBodySize: 1_048_576,\n};\n\nexport function createCapabilities(options: CapabilityOptions = {}): AdapterCapabilities {\n  return {\n    ...DEFAULT_CAPABILITIES,\n    ...options,\n  };\n}\n\n/** True when the host supports streaming responses (streaming !== false). */\nexport function supportsStreaming(capabilities: Pick<AdapterCapabilities, \"streaming\"> = { streaming: true }): boolean {\n  return capabilities.streaming !== false;\n}\n\n/** True when the host can write to persistent storage (for ISR/cache/image writes). */\nexport function supportsPersistentStorage(capabilities: Pick<AdapterCapabilities, \"filesystem\">): boolean {\n  return capabilities.filesystem === \"persistent\";\n}\n\n/** True when the host exposes a writable filesystem at build/runtime. */\nexport function supportsWritableFilesystem(capabilities: Pick<AdapterCapabilities, \"filesystem\">): boolean {\n  return capabilities.filesystem === \"persistent\" || capabilities.filesystem === \"ephemeral\";\n}\n\nexport interface CapabilityDiagnostics {\n  ok: boolean;\n  problems: string[];\n}\n\n/**\n * Validates a capability declaration and reports incompatible combinations.\n * Used by the build pipeline so invalid hosts fail at build time instead of\n * producing a broken runtime.\n */\nexport function validateCapabilities(\n  capabilities: AdapterCapabilities,\n  features: { isr?: boolean; images?: boolean; streaming?: boolean } = {},\n): CapabilityDiagnostics {\n  const problems: string[] = [];\n\n  if (features.isr && !supportsPersistentStorage(capabilities)) {\n    problems.push(\n      `ISR requires a persistent filesystem; the host declares filesystem=\"${capabilities.filesystem}\".`,\n    );\n  }\n  if (features.images && capabilities.imageRuntime === false && capabilities.filesystem === \"none\") {\n    problems.push(\n      \"On-demand image transforms require either imageRuntime=true or a readable filesystem; the host has neither.\",\n    );\n  }\n  if (features.streaming && capabilities.streaming === false) {\n    problems.push(\"Streaming was requested but the host declares streaming=false.\");\n  }\n\n  return { ok: problems.length === 0, problems };\n}\n"],"mappings":"AAiCA,IAAa,EAA4C,CACvD,UAAW,GACX,WAAY,aACZ,aAAc,GACd,eAAgB,EAClB,EAGa,EAA+C,CAC1D,UAAW,GACX,WAAY,YACZ,aAAc,GACd,eAAgB,GAChB,YAAa,OACf,EAGa,EAAyC,CACpD,UAAW,GACX,WAAY,WACZ,aAAc,GACd,eAAgB,GAChB,YAAa,OACf,EAEA,SAAgB,EAAmB,EAA6B,CAAC,EAAwB,CACvF,MAAO,CACL,GAAG,EACH,GAAG,CACL,CACF,CAGA,SAAgB,EAAkB,EAAuD,CAAE,UAAW,EAAK,EAAY,CACrH,OAAO,EAAa,YAAc,EACpC,CAGA,SAAgB,EAA0B,EAAgE,CACxG,OAAO,EAAa,aAAe,YACrC,CAGA,SAAgB,EAA2B,EAAgE,CACzG,OAAO,EAAa,aAAe,cAAgB,EAAa,aAAe,WACjF,CAYA,SAAgB,EACd,EACA,EAAqE,CAAC,EAC/C,CACvB,IAAM,EAAqB,CAAC,EAgB5B,OAdI,EAAS,KAAO,CAAC,EAA0B,CAAY,GACzD,EAAS,KACP,uEAAuE,EAAa,WAAW,GACjG,EAEE,EAAS,QAAU,EAAa,eAAiB,IAAS,EAAa,aAAe,QACxF,EAAS,KACP,6GACF,EAEE,EAAS,WAAa,EAAa,YAAc,IACnD,EAAS,KAAK,gEAAgE,EAGzE,CAAE,GAAI,EAAS,SAAW,EAAG,UAAS,CAC/C"}

package/dist/lib/capabilities-C7txofmY.js

@@ -0,0 +1,45 @@
+//#region src/runtime/capabilities.ts
+var e = {
+	streaming: !0,
+	filesystem: "persistent",
+	imageRuntime: !0,
+	backgroundWork: !0
+}, t = {
+	streaming: !0,
+	filesystem: "ephemeral",
+	imageRuntime: !1,
+	backgroundWork: !1,
+	maxBodySize: 1048576
+}, n = {
+	streaming: !0,
+	filesystem: "readonly",
+	imageRuntime: !1,
+	backgroundWork: !1,
+	maxBodySize: 1048576
+};
+function r(t = {}) {
+	return {
+		...e,
+		...t
+	};
+}
+function i(e = { streaming: !0 }) {
+	return e.streaming !== !1;
+}
+function a(e) {
+	return e.filesystem === "persistent";
+}
+function o(e) {
+	return e.filesystem === "persistent" || e.filesystem === "ephemeral";
+}
+function s(e, t = {}) {
+	let n = [];
+	return t.isr && !a(e) && n.push(`ISR requires a persistent filesystem; the host declares filesystem="${e.filesystem}".`), t.images && e.imageRuntime === !1 && e.filesystem === "none" && n.push("On-demand image transforms require either imageRuntime=true or a readable filesystem; the host has neither."), t.streaming && e.streaming === !1 && n.push("Streaming was requested but the host declares streaming=false."), {
+		ok: n.length === 0,
+		problems: n
+	};
+}
+//#endregion
+export { a, s as c, r as i, n, i as o, t as r, o as s, e as t };
+
+//# sourceMappingURL=capabilities-C7txofmY.js.map

package/dist/lib/capabilities-C7txofmY.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities-C7txofmY.js","names":[],"sources":["../../src/runtime/capabilities.ts"],"sourcesContent":["// --- Adapter capabilities contract (§8.5) ---\n//\n// Every runtime host (Node CLI, Vite dev, Node/Bun adapters, Vercel, Netlify)\n// declares an explicit `AdapterCapabilities` object. The framework uses it to\n// decide which features are safe to enable: streaming, filesystem access,\n// runtime image transforms, background work, body size limits, ISR persistence.\n//\n// Invalid or incompatible capability combinations fail fast during build.\n\nexport type FilesystemCapability = \"none\" | \"readonly\" | \"persistent\" | \"ephemeral\";\n\nexport interface AdapterCapabilities {\n  /** Whether the host supports streaming responses (ReadableStream bodies). */\n  streaming: boolean;\n  /** Filesystem access model of the host. */\n  filesystem: FilesystemCapability;\n  /** Whether the host can run image transforms at request time. */\n  imageRuntime: boolean;\n  /** Whether the host allows background work after the response completes. */\n  backgroundWork: boolean;\n  /** Maximum request body size in bytes accepted by the host (if any). */\n  maxBodySize?: number;\n}\n\nexport interface CapabilityOptions {\n  streaming?: boolean;\n  filesystem?: FilesystemCapability;\n  imageRuntime?: boolean;\n  backgroundWork?: boolean;\n  maxBodySize?: number;\n}\n\n/** Default capabilities for a full-featured long-lived Node/Bun process. */\nexport const DEFAULT_CAPABILITIES: AdapterCapabilities = {\n  streaming: true,\n  filesystem: \"persistent\",\n  imageRuntime: true,\n  backgroundWork: true,\n};\n\n/** Default capabilities for a stateless serverless function (Vercel/Netlify). */\nexport const SERVERLESS_CAPABILITIES: AdapterCapabilities = {\n  streaming: true,\n  filesystem: \"ephemeral\",\n  imageRuntime: false,\n  backgroundWork: false,\n  maxBodySize: 1_048_576,\n};\n\n/** Default capabilities for an edge runtime (read-only filesystem). */\nexport const EDGE_CAPABILITIES: AdapterCapabilities = {\n  streaming: true,\n  filesystem: \"readonly\",\n  imageRuntime: false,\n  backgroundWork: false,\n  maxBodySize: 1_048_576,\n};\n\nexport function createCapabilities(options: CapabilityOptions = {}): AdapterCapabilities {\n  return {\n    ...DEFAULT_CAPABILITIES,\n    ...options,\n  };\n}\n\n/** True when the host supports streaming responses (streaming !== false). */\nexport function supportsStreaming(capabilities: Pick<AdapterCapabilities, \"streaming\"> = { streaming: true }): boolean {\n  return capabilities.streaming !== false;\n}\n\n/** True when the host can write to persistent storage (for ISR/cache/image writes). */\nexport function supportsPersistentStorage(capabilities: Pick<AdapterCapabilities, \"filesystem\">): boolean {\n  return capabilities.filesystem === \"persistent\";\n}\n\n/** True when the host exposes a writable filesystem at build/runtime. */\nexport function supportsWritableFilesystem(capabilities: Pick<AdapterCapabilities, \"filesystem\">): boolean {\n  return capabilities.filesystem === \"persistent\" || capabilities.filesystem === \"ephemeral\";\n}\n\nexport interface CapabilityDiagnostics {\n  ok: boolean;\n  problems: string[];\n}\n\n/**\n * Validates a capability declaration and reports incompatible combinations.\n * Used by the build pipeline so invalid hosts fail at build time instead of\n * producing a broken runtime.\n */\nexport function validateCapabilities(\n  capabilities: AdapterCapabilities,\n  features: { isr?: boolean; images?: boolean; streaming?: boolean } = {},\n): CapabilityDiagnostics {\n  const problems: string[] = [];\n\n  if (features.isr && !supportsPersistentStorage(capabilities)) {\n    problems.push(\n      `ISR requires a persistent filesystem; the host declares filesystem=\"${capabilities.filesystem}\".`,\n    );\n  }\n  if (features.images && capabilities.imageRuntime === false && capabilities.filesystem === \"none\") {\n    problems.push(\n      \"On-demand image transforms require either imageRuntime=true or a readable filesystem; the host has neither.\",\n    );\n  }\n  if (features.streaming && capabilities.streaming === false) {\n    problems.push(\"Streaming was requested but the host declares streaming=false.\");\n  }\n\n  return { ok: problems.length === 0, problems };\n}\n"],"mappings":";AAiCA,IAAa,IAA4C;CACvD,WAAW;CACX,YAAY;CACZ,cAAc;CACd,gBAAgB;AAClB,GAGa,IAA+C;CAC1D,WAAW;CACX,YAAY;CACZ,cAAc;CACd,gBAAgB;CAChB,aAAa;AACf,GAGa,IAAyC;CACpD,WAAW;CACX,YAAY;CACZ,cAAc;CACd,gBAAgB;CAChB,aAAa;AACf;AAEA,SAAgB,EAAmB,IAA6B,CAAC,GAAwB;CACvF,OAAO;EACL,GAAG;EACH,GAAG;CACL;AACF;AAGA,SAAgB,EAAkB,IAAuD,EAAE,WAAW,GAAK,GAAY;CACrH,OAAO,EAAa,cAAc;AACpC;AAGA,SAAgB,EAA0B,GAAgE;CACxG,OAAO,EAAa,eAAe;AACrC;AAGA,SAAgB,EAA2B,GAAgE;CACzG,OAAO,EAAa,eAAe,gBAAgB,EAAa,eAAe;AACjF;AAYA,SAAgB,EACd,GACA,IAAqE,CAAC,GAC/C;CACvB,IAAM,IAAqB,CAAC;CAgB5B,OAdI,EAAS,OAAO,CAAC,EAA0B,CAAY,KACzD,EAAS,KACP,uEAAuE,EAAa,WAAW,GACjG,GAEE,EAAS,UAAU,EAAa,iBAAiB,MAAS,EAAa,eAAe,UACxF,EAAS,KACP,6GACF,GAEE,EAAS,aAAa,EAAa,cAAc,MACnD,EAAS,KAAK,gEAAgE,GAGzE;EAAE,IAAI,EAAS,WAAW;EAAG;CAAS;AAC/C"}

package/dist/lib/cli/commands.d.cts

@@ -0,0 +1,15 @@
+import type { CliOptions } from "../cli.js";
+/** Exit codes used by all CLI commands. */
+export declare const ExitCode: {
+    readonly Success: 0;
+    readonly GenericError: 1;
+    readonly ConfigError: 2;
+    readonly TypeError: 3;
+    readonly RouteConflict: 4;
+    readonly MissingDependency: 5;
+};
+/** Formats an error with cause, path, and suggestion. */
+export declare function formatError(cause: string, path?: string, suggestion?: string): string;
+export declare function doCheck(options: CliOptions): Promise<number>;
+export declare function doRoutes(options: CliOptions): Promise<number>;
+export declare function doDoctor(options: CliOptions): Promise<number>;

package/dist/lib/cli/commands.d.ts

@@ -0,0 +1,15 @@
+import type { CliOptions } from "../cli.js";
+/** Exit codes used by all CLI commands. */
+export declare const ExitCode: {
+    readonly Success: 0;
+    readonly GenericError: 1;
+    readonly ConfigError: 2;
+    readonly TypeError: 3;
+    readonly RouteConflict: 4;
+    readonly MissingDependency: 5;
+};
+/** Formats an error with cause, path, and suggestion. */
+export declare function formatError(cause: string, path?: string, suggestion?: string): string;
+export declare function doCheck(options: CliOptions): Promise<number>;
+export declare function doRoutes(options: CliOptions): Promise<number>;
+export declare function doDoctor(options: CliOptions): Promise<number>;