@jasonshimmy/vite-plugin-cer-app 0.28.2 → 0.29.0

package/dist/runtime/isr-handler.d.ts

@@ -9,31 +9,20 @@
  *   import { handler, routes } from './dist/server/server.js'
  *   app.use(createIsrHandler(routes, handler))
  *
- * Usage (Hono):
- *   import { createIsrHandler } from '@jasonshimmy/vite-plugin-cer-app/isr'
- *   import { handler, routes } from './dist/server/server.js'
- *   app.use('*', createIsrHandler(routes, handler))
+ * Web Request/Response frameworks require a transport bridge; this factory
+ * accepts Node.js IncomingMessage/ServerResponse objects.
  */
 import type { IncomingMessage, ServerResponse } from 'node:http';
 /** A single cached SSR response stored by `createIsrHandler`. Includes the full rendered HTML, response headers, status code, and revalidation metadata. */
 export interface IsrCacheEntry {
     html: string;
-    headers: Record<string, string>;
+    headers: Record<string, string | string[]>;
     statusCode: number;
     builtAt: number;
     revalidate: number;
 }
-/** The SSR request handler signature produced by the server entry bundle (exported as `handler`). Compatible with Express, Hono, and any Node.js HTTP server. */
+/** The Node.js request handler signature produced by the server entry bundle. Web Request/Response frameworks require a bridge. */
 export type SsrHandlerFn = (req: IncomingMessage, res: ServerResponse) => unknown;
-/**
- * Wraps an SSR handler with stale-while-revalidate ISR caching.
- *
- * Routes that declare `meta.ssg.revalidate` in the `routes` array are cached
- * in memory. After the TTL expires the stale response is served immediately
- * while a fresh render runs in the background (stale-while-revalidate).
- *
- * Routes without a `revalidate` value are passed through to the handler directly.
- */
 export declare function createIsrHandler(routes: Array<{
     path: string;
     meta?: Record<string, unknown>;

package/dist/runtime/isr-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"isr-handler.d.ts","sourceRoot":"","sources":["../../src/runtime/isr-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAEhE,4JAA4J;AAC5J,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,iKAAiK;AACjK,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,KAAK,OAAO,CAAA;AA8FjF;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,EAC/D,OAAO,EAAE,YAAY,GACpB,YAAY,CAgDd"}
+{"version":3,"file":"isr-handler.d.ts","sourceRoot":"","sources":["../../src/runtime/isr-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAKhE,4JAA4J;AAC5J,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAA;IAC1C,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,mIAAmI;AACnI,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,KAAK,OAAO,CAAA;AAiGjF,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,EAC/D,OAAO,EAAE,YAAY,GACpB,YAAY,CAgEd"}

package/dist/runtime/isr-handler.js

@@ -9,76 +9,71 @@
  *   import { handler, routes } from './dist/server/server.js'
  *   app.use(createIsrHandler(routes, handler))
  *
- * Usage (Hono):
- *   import { createIsrHandler } from '@jasonshimmy/vite-plugin-cer-app/isr'
- *   import { handler, routes } from './dist/server/server.js'
- *   app.use('*', createIsrHandler(routes, handler))
+ * Web Request/Response frameworks require a transport bridge; this factory
+ * accepts Node.js IncomingMessage/ServerResponse objects.
  */
+import { Readable } from 'node:stream';
+import { EventEmitter } from 'node:events';
+import { matchRoutePattern as _matchPattern, findRevalidate as _findRevalidate } from './route-matching.js';
 // ─── Internal helpers ─────────────────────────────────────────────────────────
-function _matchPattern(pattern, urlPath) {
-    const norm = (s) => s.replace(/\/+$/, '') || '/';
-    if (norm(pattern) === norm(urlPath))
-        return true;
-    const regexStr = '^' +
-        norm(pattern)
-            .replace(/[.+?^${}()|[\]\\]/g, '\\$&')
-            .replace(/:[^/]+\*/g, '.*')
-            .replace(/:[^/]+/g, '[^/]+') +
-        '$';
-    return new RegExp(regexStr).test(norm(urlPath));
-}
-function _findRevalidate(routes, urlPath) {
-    for (const route of routes) {
-        if (_matchPattern(route.path, urlPath)) {
-            const ssg = route.meta?.ssg;
-            if (typeof ssg?.revalidate === 'number')
-                return ssg.revalidate;
-            return null;
-        }
-    }
-    return null;
-}
-async function _renderForCache(urlPath, handler, revalidate) {
+async function _renderForCache(urlPath, handler, revalidate, request) {
     return new Promise((resolve) => {
+        const timer = setTimeout(() => resolve(null), 30_000);
+        timer.unref?.();
+        const finish = (entry) => { clearTimeout(timer); resolve(entry); };
         const chunks = [];
         const capturedHeaders = {};
         let capturedStatus = 200;
-        const fakeRes = {
+        const events = new EventEmitter();
+        const fakeRes = Object.assign(events, {
+            headersSent: false,
+            writableEnded: false,
+            getHeader(name) { return capturedHeaders[name.toLowerCase()]; },
+            getHeaders() { return { ...capturedHeaders }; },
+            removeHeader(name) { delete capturedHeaders[name.toLowerCase()]; },
+            writeHead(status, headers) { capturedStatus = status; Object.assign(capturedHeaders, Object.fromEntries(Object.entries(headers ?? {}).map(([key, value]) => [key.toLowerCase(), value]))); this.headersSent = true; return this; },
             get statusCode() { return capturedStatus; },
             set statusCode(v) { capturedStatus = v; },
             setHeader(name, value) {
                 capturedHeaders[name.toLowerCase()] = value;
             },
             write(chunk) {
+                this.headersSent = true;
                 chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk, 'utf-8'));
+                return true;
             },
             end(body) {
+                if (this.writableEnded)
+                    return this;
+                this.headersSent = true;
+                this.writableEnded = true;
                 if (body !== undefined) {
                     chunks.push(Buffer.isBuffer(body) ? body : Buffer.from(String(body), 'utf-8'));
                 }
-                resolve({
+                finish({
                     html: Buffer.concat(chunks).toString('utf-8'),
-                    headers: Object.fromEntries(Object.entries(capturedHeaders).map(([k, v]) => [k, Array.isArray(v) ? v.join(', ') : v])),
+                    headers: { ...capturedHeaders },
                     statusCode: capturedStatus,
                     builtAt: Date.now(),
                     revalidate,
                 });
+                events.emit('finish');
+                return this;
             },
-        };
-        const fakeReq = {
-            url: urlPath,
-            method: 'GET',
-            headers: { accept: 'text/html' },
-        };
+        });
+        const fakeReq = Object.assign(Readable.from([]), {
+            url: urlPath, method: 'GET', headers: { ...request.headers },
+            socket: request.socket, httpVersion: request.httpVersion,
+        });
         try {
             const result = handler(fakeReq, fakeRes);
             if (result && typeof result.catch === 'function') {
                 ;
-                result.catch(() => resolve(null));
+                result.catch(() => finish(null));
             }
         }
         catch {
-            resolve(null);
+            finish(null);
         }
     });
 }
@@ -100,15 +95,34 @@ function _serveFromCache(entry, res, status) {
  *
  * Routes without a `revalidate` value are passed through to the handler directly.
  */
+function isCacheable(entry) {
+    return entry.statusCode === 200 && !entry.headers['set-cookie'] &&
+        !/private|no-store/i.test(String(entry.headers['cache-control'] ?? '')) &&
+        !String(entry.headers.vary ?? '').split(',').some((name) => name.trim() && name.trim().toLowerCase() !== 'accept-encoding');
+}
 export function createIsrHandler(routes, handler) {
     const cache = new Map();
+    const cold = new Map();
+    const store = (path, entry) => {
+        if (!isCacheable(entry))
+            return;
+        if (!cache.has(path) && cache.size >= 1000)
+            cache.delete(cache.keys().next().value);
+        cache.set(path, entry);
+    };
     // True lock: stores the in-flight revalidation Promise per URL path.
     // A path present in this map means a background render is already in progress.
     const _inFlight = new Map();
     return async (req, res) => {
         const urlPath = (req.url ?? '/').split('?')[0];
         const revalidate = _findRevalidate(routes, urlPath);
-        if (revalidate === null) {
+        const mode = routes.find((route) => _matchPattern(route.path, urlPath))?.meta?.render;
+        const middlewarePrivate = res.getHeader?.('set-cookie') ||
+            /private|no-store/i.test(String(res.getHeader?.('cache-control') ?? '')) ||
+            String(res.getHeader?.('vary') ?? '').split(',').some((name) => name.trim() && name.trim().toLowerCase() !== 'accept-encoding');
+        // Only anonymous, canonical GET documents can share cached HTML.
+        if (revalidate === null || revalidate < 0 || mode === 'server' || middlewarePrivate ||
+            (req.method ?? 'GET') !== 'GET' || (req.url ?? '').includes('?') || req.headers.cookie || req.headers.authorization) {
             return handler(req, res);
         }
         const cached = cache.get(urlPath);
@@ -123,9 +137,9 @@ export function createIsrHandler(routes, handler) {
             // revalidation is already in flight for this path.
             _serveFromCache(cached, res, 'STALE');
             if (!_inFlight.has(urlPath)) {
-                const promise = _renderForCache(urlPath, handler, revalidate).then((entry) => {
+                const promise = _renderForCache(urlPath, handler, revalidate, req).then((entry) => {
                     if (entry)
-                        cache.set(urlPath, entry);
+                        store(urlPath, entry);
                 }).catch(() => {
                     // Background render failed — next request will try again.
                 }).finally(() => {
@@ -136,10 +150,15 @@ export function createIsrHandler(routes, handler) {
             return;
         }
         // Cache miss — render, cache, then serve.
-        const entry = await _renderForCache(urlPath, handler, revalidate);
+        // Before rendering we cannot know whether the response varies by a header.
+        // Coalesce only identical requests so uncached responses remain isolated.
+        const coldKey = JSON.stringify([urlPath, Object.entries(req.headers).sort(([a], [b]) => a.localeCompare(b))]);
+        if (!cold.has(coldKey))
+            cold.set(coldKey, _renderForCache(urlPath, handler, revalidate, req).finally(() => cold.delete(coldKey)));
+        const entry = await cold.get(coldKey);
         if (entry) {
-            cache.set(urlPath, entry);
-            _serveFromCache(entry, res, 'HIT');
+            store(urlPath, entry);
+            _serveFromCache(entry, res, isCacheable(entry) ? 'HIT' : 'BYPASS');
         }
         else {
             await handler(req, res);

package/dist/runtime/isr-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"isr-handler.js","sourceRoot":"","sources":["../../src/runtime/isr-handler.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"isr-handler.js","sourceRoot":"","sources":["../../src/runtime/isr-handler.ts"],"names":[],"mappings":"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"}

package/dist/runtime/request-dispatcher.d.ts

@@ -0,0 +1,31 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import { type SsrHandlerFn } from './isr-handler.js';
+export interface ServerApplication {
+    handler: SsrHandlerFn;
+    spaHandler?: SsrHandlerFn;
+    routes?: Array<{
+        path: string;
+        meta?: Record<string, unknown>;
+    }>;
+    apiRoutes?: Array<{
+        path: string;
+        handlers: Record<string, unknown>;
+    }>;
+    runServerMiddleware?: (req: IncomingMessage, res: ServerResponse) => Promise<boolean>;
+    runWithRequestContext?: <T>(req: IncomingMessage, res: ServerResponse, fn: () => Promise<T>) => Promise<T>;
+}
+export interface DispatcherOptions {
+    /** Known SSG documents. The transport supplies disk or platform asset access. */
+    prerendered?: {
+        paths: readonly string[];
+        read: (path: string, req: IncomingMessage) => string | null | Promise<string | null>;
+        /** False for hybrid SSG builds that deliberately reject ungenerated static routes. */
+        fallback?: boolean;
+        notFound?: (req: IncomingMessage) => string | null | Promise<string | null>;
+    };
+}
+export declare function normalizeDocumentPath(path: string): string;
+export declare function isPrivateBuildPath(path: string): boolean;
+/** Common CER routing semantics; transport adapters supply Node-compatible requests/responses. */
+export declare function createRequestDispatcher(app: ServerApplication, options?: DispatcherOptions): SsrHandlerFn;
+//# sourceMappingURL=request-dispatcher.d.ts.map

package/dist/runtime/request-dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-dispatcher.d.ts","sourceRoot":"","sources":["../../src/runtime/request-dispatcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAEhE,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAEtE,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,YAAY,CAAA;IACrB,UAAU,CAAC,EAAE,YAAY,CAAA;IACzB,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAA;IAChE,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAA;IACtE,mBAAmB,CAAC,EAAE,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IACrF,qBAAqB,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAA;CAC3G;AAED,MAAM,WAAW,iBAAiB;IAChC,iFAAiF;IACjF,WAAW,CAAC,EAAE;QACZ,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;QACxB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,eAAe,KAAK,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;QACpF,sFAAsF;QACtF,QAAQ,CAAC,EAAE,OAAO,CAAA;QAClB,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;KAC5E,CAAA;CACF;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAO1D;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD;AAuCD,kGAAkG;AAClG,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,iBAAiB,EAAE,OAAO,GAAE,iBAAsB,GAAG,YAAY,CAwD7G"}

package/dist/runtime/request-dispatcher.js

@@ -0,0 +1,152 @@
+import { findRenderMode, findRevalidate } from './route-matching.js';
+import { createIsrHandler } from './isr-handler.js';
+export function normalizeDocumentPath(path) {
+    let decoded;
+    try {
+        decoded = decodeURIComponent(path);
+    }
+    catch {
+        throw Object.assign(new Error('Invalid URL encoding'), { statusCode: 400 });
+    }
+    if (!decoded.startsWith('/') || decoded.includes('\\') || decoded.includes('\0') || decoded.split('/').some((part) => part === '.' || part === '..')) {
+        throw Object.assign(new Error('Invalid URL path'), { statusCode: 400 });
+    }
+    return decoded.replace(/\/+$/, '') || '/';
+}
+export function isPrivateBuildPath(path) {
+    return /^\/(?:server|client|\.vite)(?:\/|$)/.test(path) || /^\/(?:ssg-manifest|cer-client-manifest|cer-startup-manifest)\.json$/.test(path);
+}
+function matchApiPattern(pattern, urlPath) {
+    const patternParts = pattern.split('/');
+    const urlParts = urlPath.split('/');
+    if (patternParts.length !== urlParts.length)
+        return null;
+    const params = {};
+    for (let i = 0; i < patternParts.length; i++) {
+        const p = patternParts[i];
+        const u = urlParts[i];
+        if (p.startsWith(':')) {
+            try {
+                params[p.slice(1)] = decodeURIComponent(u);
+            }
+            catch {
+                throw Object.assign(new Error('Invalid route parameter'), { statusCode: 400 });
+            }
+        }
+        else if (p !== u) {
+            return null;
+        }
+    }
+    return params;
+}
+async function parseBody(req) {
+    if (!['POST', 'PUT', 'PATCH', 'DELETE'].includes(req.method ?? 'GET'))
+        return undefined;
+    const chunks = [];
+    let size = 0;
+    for await (const chunk of req) {
+        const bytes = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+        size += bytes.length;
+        if (size > 1024 * 1024)
+            throw Object.assign(new Error('Request body too large'), { statusCode: 413 });
+        chunks.push(bytes);
+    }
+    const bytes = Buffer.concat(chunks);
+    if (!bytes.length)
+        return undefined;
+    if (String(req.headers['content-type'] ?? '').includes('application/json')) {
+        try {
+            return JSON.parse(bytes.toString('utf8'));
+        }
+        catch {
+            throw Object.assign(new Error('Invalid JSON'), { statusCode: 400 });
+        }
+    }
+    return bytes;
+}
+/** Common CER routing semantics; transport adapters supply Node-compatible requests/responses. */
+export function createRequestDispatcher(app, options = {}) {
+    const render = createIsrHandler(app.routes ?? [], app.handler);
+    const paths = new Set(options.prerendered?.paths.map(normalizeDocumentPath));
+    return async (req, res) => {
+        const dispatch = async () => {
+            try {
+                const url = new URL(req.url ?? '/', 'http://cer.local');
+                const path = normalizeDocumentPath(url.pathname);
+                if (isPrivateBuildPath(path)) {
+                    res.statusCode = 404;
+                    res.end('Not Found');
+                    return;
+                }
+                if (app.runServerMiddleware && !(await app.runServerMiddleware(req, res)))
+                    return;
+                if (!url.pathname.startsWith('/api/')) {
+                    const mode = findRenderMode(app.routes ?? [], path);
+                    if (mode === 'spa' && app.spaHandler)
+                        await app.spaHandler(req, res);
+                    else if (['GET', 'HEAD'].includes(req.method ?? 'GET') && mode !== 'server' && findRevalidate(app.routes ?? [], path) === null && paths.has(path)) {
+                        const html = await options.prerendered.read(path, req);
+                        if (html === null)
+                            throw new Error(`Missing prerendered document: ${path}`);
+                        res.setHeader('Content-Type', 'text/html; charset=utf-8');
+                        if (!res.getHeader('Cache-Control'))
+                            res.setHeader('Cache-Control', 'no-cache');
+                        res.end(req.method === 'HEAD' ? undefined : html);
+                    }
+                    else if (options.prerendered?.fallback === false && mode !== 'server' && findRevalidate(app.routes ?? [], path) === null && !paths.has(path)) {
+                        res.statusCode = 404;
+                        res.setHeader('Content-Type', 'text/html; charset=utf-8');
+                        const html = await options.prerendered.notFound?.(req) ?? '<!doctype html><meta name="robots" content="noindex"><title>Not found</title><h1>Not found</h1>';
+                        res.end(req.method === 'HEAD' ? undefined : html);
+                    }
+                    else
+                        await render(req, res);
+                    return;
+                }
+                for (const route of app.apiRoutes ?? []) {
+                    const params = matchApiPattern(route.path, url.pathname);
+                    if (!params)
+                        continue;
+                    const method = (req.method ?? 'GET').toLowerCase();
+                    const fn = route.handlers[method] ?? route.handlers[method.toUpperCase()] ?? (method === 'head' ? route.handlers.get ?? route.handlers.GET : undefined) ?? route.handlers.default;
+                    if (typeof fn !== 'function') {
+                        res.statusCode = 405;
+                        res.setHeader('Allow', Object.keys(route.handlers).filter((key) => key !== 'default').map((key) => key.toUpperCase()).join(', '));
+                        res.end('Method Not Allowed');
+                        return;
+                    }
+                    Object.assign(req, { params, query: Object.fromEntries(url.searchParams), body: await parseBody(req) });
+                    Object.assign(res, {
+                        json(data) { res.setHeader('Content-Type', 'application/json; charset=utf-8'); res.end(JSON.stringify(data)); },
+                        status(code) { res.statusCode = code; return res; },
+                    });
+                    await fn(req, res);
+                    return;
+                }
+                res.statusCode = 404;
+                res.end('Not Found');
+            }
+            catch (error) {
+                if (res.headersSent) {
+                    res.end();
+                    return;
+                }
+                const code = error.statusCode;
+                res.statusCode = code === 400 || code === 413 ? code : 500;
+                res.end(res.statusCode === 500 ? 'Internal Server Error' : error.message);
+            }
+        };
+        try {
+            await (app.runWithRequestContext ? app.runWithRequestContext(req, res, dispatch) : dispatch());
+        }
+        catch {
+            if (!res.headersSent) {
+                res.statusCode = 500;
+                res.end('Internal Server Error');
+            }
+            else
+                res.end();
+        }
+    };
+}
+//# sourceMappingURL=request-dispatcher.js.map

package/dist/runtime/request-dispatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-dispatcher.js","sourceRoot":"","sources":["../../src/runtime/request-dispatcher.ts"],"names":[],"mappings":"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"}

package/dist/runtime/route-matching.d.ts

@@ -0,0 +1,20 @@
+export declare function matchRoutePattern(pattern: string, urlPath: string): boolean;
+/**
+ * Returns the per-route `render` strategy ('static' | 'server' | 'spa') for
+ * the route that best matches `urlPath`, or `null` when no route matches or
+ * none declares a render mode.
+ */
+export declare function findRenderMode(routes: Array<{
+    path: string;
+    meta?: Record<string, unknown>;
+}>, urlPath: string): 'static' | 'server' | 'spa' | null;
+/**
+ * Looks up the `meta.ssg.revalidate` TTL (in seconds) for the route that best
+ * matches `urlPath`. Returns `null` when no route matches or none defines
+ * `revalidate`.
+ */
+export declare function findRevalidate(routes: Array<{
+    path: string;
+    meta?: Record<string, unknown>;
+}>, urlPath: string): number | null;
+//# sourceMappingURL=route-matching.d.ts.map

package/dist/runtime/route-matching.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-matching.d.ts","sourceRoot":"","sources":["../../src/runtime/route-matching.ts"],"names":[],"mappings":"AAAA,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAW3E;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,EAC/D,OAAO,EAAE,MAAM,GACd,QAAQ,GAAG,QAAQ,GAAG,KAAK,GAAG,IAAI,CASpC;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,EAC/D,OAAO,EAAE,MAAM,GACd,MAAM,GAAG,IAAI,CAQf"}

package/dist/runtime/route-matching.js

@@ -0,0 +1,45 @@
+export function matchRoutePattern(pattern, urlPath) {
+    const norm = (s) => s.replace(/\/+$/, '') || '/';
+    if (norm(pattern) === norm(urlPath))
+        return true;
+    const regexStr = '^' + norm(pattern).split('/').map((segment, index) => {
+        if (/^:[^/]+\*$/.test(segment))
+            return index ? '(?:/.*)?' : '.*';
+        const prefix = index ? '/' : '';
+        if (segment.startsWith(':'))
+            return prefix + '[^/]+';
+        return prefix + segment.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    }).join('') + '$';
+    return new RegExp(regexStr).test(norm(urlPath));
+}
+/**
+ * Returns the per-route `render` strategy ('static' | 'server' | 'spa') for
+ * the route that best matches `urlPath`, or `null` when no route matches or
+ * none declares a render mode.
+ */
+export function findRenderMode(routes, urlPath) {
+    for (const route of routes) {
+        if (matchRoutePattern(route.path, urlPath)) {
+            const render = route.meta?.render;
+            if (render === 'static' || render === 'server' || render === 'spa')
+                return render;
+            return null;
+        }
+    }
+    return null;
+}
+/**
+ * Looks up the `meta.ssg.revalidate` TTL (in seconds) for the route that best
+ * matches `urlPath`. Returns `null` when no route matches or none defines
+ * `revalidate`.
+ */
+export function findRevalidate(routes, urlPath) {
+    for (const route of routes) {
+        if (matchRoutePattern(route.path, urlPath)) {
+            const ssg = route.meta?.ssg;
+            return typeof ssg?.revalidate === 'number' ? ssg.revalidate : null;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=route-matching.js.map

package/dist/runtime/route-matching.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-matching.js","sourceRoot":"","sources":["../../src/runtime/route-matching.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,iBAAiB,CAAC,OAAe,EAAE,OAAe;IAChE,MAAM,IAAI,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,GAAG,CAAA;IAChE,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAA;IAChD,MAAM,QAAQ,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE;QACrE,IAAI,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC;YAAE,OAAO,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAA;QAChE,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAA;QAC/B,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,MAAM,GAAG,OAAO,CAAA;QACpD,OAAO,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAA;IAChE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG,CAAA;IAEjB,OAAO,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAA;AACjD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,MAA+D,EAC/D,OAAe;IAEf,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,iBAAiB,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC;YAC3C,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,MAAM,CAAA;YACjC,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,KAAK;gBAAE,OAAO,MAAM,CAAA;YACjF,OAAO,IAAI,CAAA;QACb,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,MAA+D,EAC/D,OAAe;IAEf,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,iBAAiB,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC;YAC3C,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,EAAE,GAA0C,CAAA;YAClE,OAAO,OAAO,GAAG,EAAE,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAA;QACpE,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/types/api.d.ts

@@ -1,6 +1,7 @@
 import type { IncomingMessage, ServerResponse } from 'node:http';
 /**
  * Augmented Node.js `IncomingMessage` passed to API route handlers.
+ * Web hosting adapters provide a compatibility bridge, without Node socket APIs.
  * Route params and query string are pre-parsed; `body` is parsed from JSON automatically.
  */
 export interface ApiRequest extends IncomingMessage {
@@ -10,6 +11,8 @@ export interface ApiRequest extends IncomingMessage {
 }
 /**
  * Augmented Node.js `ServerResponse` passed to API route handlers.
+ * Web hosting adapters implement the documented header/write/end contract;
+ * socket-specific Node methods require a native Node transport.
  * Adds convenience methods for JSON responses and fluent status setting.
  */
 export interface ApiResponse extends ServerResponse {

package/dist/types/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/types/api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAEhE;;;GAGG;AACH,MAAM,WAAW,UAAW,SAAQ,eAAe;IACjD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7B,IAAI,EAAE,OAAO,CAAA;CACd;AAED;;;GAGG;AACH,MAAM,WAAW,WAAY,SAAQ,cAAc;IACjD,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAA;IACzB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAA;CAClC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;AAEpF,6GAA6G;AAC7G,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,UAAU,CAAA;IACf,GAAG,EAAE,WAAW,CAAA;CACjB"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/types/api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAEhE;;;;GAIG;AACH,MAAM,WAAW,UAAW,SAAQ,eAAe;IACjD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7B,IAAI,EAAE,OAAO,CAAA;CACd;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAY,SAAQ,cAAc;IACjD,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAA;IACzB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAA;CAClC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;AAEpF,6GAA6G;AAC7G,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,UAAU,CAAA;IACf,GAAG,EAAE,WAAW,CAAA;CACjB"}

package/dist/types/config.d.ts

@@ -4,6 +4,8 @@ import type { IncomingMessage } from 'node:http';
 export interface CerAppIntegration {
     /** Stable name used in diagnostics. */
     name: string;
+    /** Semantic colors contributed to build and runtime CSS. App values override these. */
+    customColors?: Record<string, Record<string, string>>;
     /** Resolve a rendered custom-element tag to its side-effect registration module. */
     componentResolver?: (tag: string) => string | undefined;
     /** Imports that must run once in the generated client entry (for example global CSS). */
@@ -124,7 +126,27 @@ export interface I18nConfig {
     strategy?: 'prefix' | 'prefix_except_default' | 'no_prefix';
 }
 /** Global Static Site Generation (SSG) configuration. Controls which routes are pre-rendered and at what concurrency. */
+export interface SitemapPageMetadata {
+    /** Actual content modification date, never automatically set to build time. */
+    lastmod?: string;
+    images?: string[];
+    /** Exclude deliberately nonindexable pages. */
+    exclude?: boolean;
+}
+export interface NetlifyFormSchema {
+    name: string;
+    fields: string[];
+    honeypot?: string;
+}
 export interface SsgConfig {
+    /** Retain intermediates for custom consumers. Auto retains hybrid/fallback/adapter builds. */
+    keepServer?: boolean;
+    /** Control entry downloading independently of hydration, per concrete generated path. */
+    entryPreload?: boolean | ((path: string) => boolean);
+    /** Metadata callback for successfully rendered sitemap entries. */
+    sitemap?: (path: string) => SitemapPageMetadata | Promise<SitemapPageMetadata>;
+    /** Optional Netlify registration artifacts, generated from one application schema. */
+    netlifyForms?: NetlifyFormSchema[];
     /**
      * Routes to pre-render.
      * - `'auto'` (default) — pre-render every static route discovered in `app/pages/`.
@@ -152,6 +174,9 @@ export interface SsgConfig {
 }
 /** JIT (Just-In-Time) CSS configuration for shadow-DOM style injection. */
 export interface JitCssConfig {
+    /** Static mode supplies scanned CSS to each shadow root without browser JIT. */
+    mode?: 'runtime' | 'static';
+    safelist?: string[];
     /** Additional glob patterns for content files scanned by the JIT CSS engine. */
     content?: string[];
     /** Enable every extended color family or list only the families to retain. Defaults to `false`. */
@@ -278,6 +303,8 @@ export interface CerAppConfig {
     autoImports?: AutoImportsConfig;
     /** UI/framework integrations composed into generated entries and component code splitting. */
     integrations?: CerAppIntegration[];
+    /** Options forwarded to Vite preview (including HTTPS certificates and headers). */
+    preview?: import('vite').PreviewOptions;
     port?: number;
     /**
      * Runtime configuration accessible via `useRuntimeConfig()`.