@nexus_js/server 0.6.0

package/dist/load-module.js

@@ -0,0 +1,288 @@
+/**
+ * Load route modules in dev (compile .nx → .mjs) and prod (pre-built .js under .nexus/output).
+ */
+import { compile } from '@nexus_js/compiler';
+import { buildRouteManifest } from '@nexus_js/router';
+import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
+import { mkdir, readdir, readFile, stat, unlink, writeFile } from 'node:fs/promises';
+import { dirname, join, relative } from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+/** Map manifest pattern to the same path segment used by `nexus build`. */
+function patternToOutputSegment(pattern) {
+    if (pattern === '/')
+        return 'index';
+    return pattern.replace(/^\//, '');
+}
+function compiledServerPath(appRoot, pattern) {
+    const outDir = join(appRoot, '.nexus', 'output');
+    return join(outDir, patternToOutputSegment(pattern)) + '.js';
+}
+/**
+ * Resolve @nexus_js/compiler dist entry + fingerprint. `require.resolve('…/package.json')` fails
+ * because package.json is not exported — use `import.meta.resolve` from this module instead.
+ */
+/** Newest mtime among `dist/*.js` so codegen-only edits invalidate the dev-server cache. */
+function maxMtimeMsCompilerDist(distDir) {
+    let max = 0;
+    try {
+        for (const name of readdirSync(distDir)) {
+            if (!name.endsWith('.js'))
+                continue;
+            max = Math.max(max, statSync(join(distDir, name)).mtimeMs);
+        }
+    }
+    catch {
+        return 0;
+    }
+    return max;
+}
+function compilerDistMeta() {
+    try {
+        const entry = fileURLToPath(import.meta.resolve('@nexus_js/compiler', import.meta.url));
+        const distDir = dirname(entry);
+        const mtimeMs = Math.max(statSync(entry).mtimeMs, maxMtimeMsCompilerDist(distDir));
+        const pkgDir = dirname(distDir);
+        const version = JSON.parse(readFileSync(join(pkgDir, 'package.json'), 'utf-8'));
+        const v = (version.version ?? '0').replace(/[^\w.]/g, '_');
+        const fingerprint = `${v}_${Math.floor(mtimeMs)}`;
+        return { entry, mtimeMs, fingerprint };
+    }
+    catch {
+        return null;
+    }
+}
+function devServerCachePath(appRoot, nxPath, fingerprint) {
+    const rel = relative(appRoot, nxPath);
+    const safe = rel.replace(/[^a-zA-Z0-9._/-]/g, '_');
+    return join(appRoot, '.nexus', 'dev-server', fingerprint, safe + '.mjs');
+}
+function actionsSidecarPath(serverPath) {
+    return serverPath.replace(/\.mjs$/u, '.actions.mjs').replace(/\.js$/u, '.actions.js');
+}
+/** Auto-import app `$lib` helpers used inside generated action bodies (sidecar has no imports from .nx). */
+function actionsImportPreamble(appRoot, actionsCode) {
+    const rules = [
+        { needle: 'appendMessage', rel: 'src/lib/chat-room.js', name: 'appendMessage' },
+        { needle: 'validateFlowPayload', rel: 'src/lib/validate-flow.js', name: 'validateFlowPayload' },
+    ];
+    const byFile = new Map();
+    for (const { needle, rel, name } of rules) {
+        if (!actionsCode.includes(needle))
+            continue;
+        const abs = join(appRoot, rel);
+        if (!existsSync(abs))
+            continue;
+        let set = byFile.get(abs);
+        if (!set) {
+            set = new Set();
+            byFile.set(abs, set);
+        }
+        set.add(name);
+    }
+    const lines = [];
+    for (const [abs, set] of byFile) {
+        const names = [...set].sort().join(', ');
+        lines.push(`import { ${names} } from ${JSON.stringify(pathToFileURL(abs).href)};\n`);
+    }
+    return lines.join('');
+}
+async function writeActionsSidecar(appRoot, serverOutPath, actionsModule) {
+    const p = actionsSidecarPath(serverOutPath);
+    const code = actionsImportPreamble(appRoot, actionsModule) + actionsModule;
+    await writeFile(p, code, 'utf-8');
+}
+/** Max mtime under `src/lib/*.{js,mjs,cjs}` so edits to shared action deps bust ESM cache. */
+async function maxSrcLibMtime(appRoot) {
+    const libDir = join(appRoot, 'src', 'lib');
+    let max = 0;
+    try {
+        const entries = await readdir(libDir, { withFileTypes: true });
+        for (const e of entries) {
+            if (!e.isFile())
+                continue;
+            if (!/\.(m?js|cjs)$/iu.test(e.name))
+                continue;
+            max = Math.max(max, (await stat(join(libDir, e.name))).mtimeMs);
+        }
+    }
+    catch {
+        return 0;
+    }
+    return max;
+}
+async function collectFilesRecursive(dir, match) {
+    const out = [];
+    async function walk(d) {
+        let entries;
+        try {
+            entries = await readdir(d, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            const p = join(d, e.name);
+            if (e.isDirectory())
+                await walk(p);
+            else if (match(e.name))
+                out.push(p);
+        }
+    }
+    await walk(dir);
+    return out;
+}
+/**
+ * Re-import every `*.actions.mjs` under `.nexus/dev-server` so `registerAction` picks up
+ * code changes (including edits to files imported from the sidecar, e.g. `$lib/chat-room.js`).
+ * Called from `server.reload()` when the CLI file watcher fires.
+ */
+/**
+ * Loads every route module once so generated `*.actions.*` sidecars run `registerAction`
+ * before any HTTP request. Dev: compiles each `.nx` route; prod: imports `*.actions.js` from `.nexus/output`.
+ */
+export async function preloadRegisteredServerActions(appRoot, dev) {
+    if (dev) {
+        const routesDir = join(appRoot, 'src', 'routes');
+        const manifest = await buildRouteManifest(routesDir);
+        const seen = new Set();
+        for (const route of manifest.routes) {
+            if (!route.filepath.endsWith('.nx'))
+                continue;
+            if (seen.has(route.filepath))
+                continue;
+            seen.add(route.filepath);
+            try {
+                await loadRouteModule(route.filepath, { dev: true, appRoot, pattern: route.pattern });
+            }
+            catch (err) {
+                console.error(`[Nexus] Failed to preload server actions for ${route.filepath}:`, err);
+            }
+        }
+        await reimportDevActionSidecars(appRoot);
+        return;
+    }
+    const outDir = join(appRoot, '.nexus', 'output');
+    let files = [];
+    try {
+        files = await collectFilesRecursive(outDir, (n) => n.endsWith('.actions.js'));
+    }
+    catch {
+        return;
+    }
+    for (const p of files) {
+        try {
+            const st = await stat(p);
+            await import(`${pathToFileURL(p).href}?t=${st.mtimeMs}`);
+        }
+        catch (err) {
+            console.error(`[Nexus] Failed to import server actions sidecar (${p}):`, err);
+        }
+    }
+}
+export async function reimportDevActionSidecars(appRoot) {
+    const root = join(appRoot, '.nexus', 'dev-server');
+    let files = [];
+    try {
+        files = await collectFilesRecursive(root, (n) => n.endsWith('.actions.mjs'));
+    }
+    catch {
+        return;
+    }
+    const libM = await maxSrcLibMtime(appRoot);
+    for (const p of files) {
+        try {
+            const st = await stat(p);
+            await import(`${pathToFileURL(p).href}?t=${st.mtimeMs}_${libM}`);
+        }
+        catch (err) {
+            console.error(`[Nexus] Failed to re-import actions (${p}):`, err);
+        }
+    }
+}
+async function importActionsSidecar(serverOutPath, appRoot, dev) {
+    const p = actionsSidecarPath(serverOutPath);
+    try {
+        await stat(p);
+    }
+    catch {
+        return;
+    }
+    try {
+        const st = await stat(p);
+        const libM = dev ? await maxSrcLibMtime(appRoot) : 0;
+        const bust = dev ? `${st.mtimeMs}_${libM}` : `${st.mtimeMs}`;
+        await import(`${pathToFileURL(p).href}?t=${bust}`);
+    }
+    catch (err) {
+        console.error(`[Nexus] Failed to import server actions sidecar (${p}):`, err);
+    }
+}
+/**
+ * Dynamic import for `.ts`/`.js` routes, compiled `.nx` in dev, or built `.js` in production.
+ */
+export async function loadRouteModule(filepath, options) {
+    if (filepath.endsWith('.ts') || filepath.endsWith('.js') || filepath.endsWith('.mjs')) {
+        return import(pathToFileURL(filepath).href);
+    }
+    if (!filepath.endsWith('.nx')) {
+        throw new Error(`[Nexus] Unsupported route module: ${filepath}`);
+    }
+    const { dev, appRoot, pattern } = options;
+    if (!dev) {
+        const outFile = compiledServerPath(appRoot, pattern);
+        try {
+            await stat(outFile);
+        }
+        catch {
+            throw new Error(`[Nexus] No compiled server module for "${pattern}" (${filepath}). Run \`nexus build\` first.`);
+        }
+        const mod = await import(pathToFileURL(outFile).href);
+        await importActionsSidecar(outFile, appRoot, false);
+        return mod;
+    }
+    const nxStat = await stat(filepath);
+    const cc = compilerDistMeta();
+    const fingerprint = cc?.fingerprint ?? 'unknown';
+    const outPath = devServerCachePath(appRoot, filepath, fingerprint);
+    let needsCompile = true;
+    try {
+        const outStat = await stat(outPath);
+        needsCompile =
+            outStat.mtimeMs < nxStat.mtimeMs ||
+                (cc !== null && outStat.mtimeMs < cc.mtimeMs);
+    }
+    catch {
+        needsCompile = true;
+    }
+    if (needsCompile) {
+        const source = await readFile(filepath, 'utf-8');
+        const result = compile(source, filepath, {
+            mode: 'server',
+            dev: true,
+            ssr: true,
+            emitIslandManifest: true,
+            target: 'node',
+            appRoot,
+        });
+        await mkdir(dirname(outPath), { recursive: true });
+        await writeFile(outPath, result.serverCode, 'utf-8');
+        const ap = actionsSidecarPath(outPath);
+        if (result.actionsModule) {
+            await writeActionsSidecar(appRoot, outPath, result.actionsModule);
+        }
+        else {
+            try {
+                await unlink(ap);
+            }
+            catch {
+                /* none */
+            }
+        }
+    }
+    await importActionsSidecar(outPath, appRoot, true);
+    const outStatForUrl = await stat(outPath);
+    const cacheBust = Math.max(nxStat.mtimeMs, outStatForUrl.mtimeMs, cc !== null ? cc.mtimeMs : 0);
+    const url = `${pathToFileURL(outPath).href}?t=${cacheBust}`;
+    return import(url);
+}
+//# sourceMappingURL=load-module.js.map

package/dist/load-module.js.map

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

package/dist/logger.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Nexus Server Logger — terminal observability for SSR, Actions, HMR.
+ *
+ * Symbol key:
+ *   ○  Static / immutable (CDN-cached forever)
+ *   ◑  PPR / SWR (partially cached, stale-while-revalidate)
+ *   λ  Dynamic (no CDN cache, server-rendered per request)
+ *   ~  Streaming (Suspense, can't cache)
+ *   ▲  Server Action (mutation)
+ *   ✖  Error (any 4xx/5xx)
+ */
+export type CacheStrategy = 'static-immutable' | 'swr' | 'dynamic-no-store' | 'streaming-no-store' | 'private-no-store';
+export type RouteSymbol = 'static' | 'ppr' | 'dynamic' | 'streaming' | 'error';
+export interface RouteLogEntry {
+    method: string;
+    path: string;
+    status: number;
+    duration: number;
+    cacheStrategy?: CacheStrategy | string;
+    /** Number of <nexus-island> markers found in the rendered HTML */
+    islandCount?: number;
+    errorMessage?: string;
+}
+export interface ActionLogEntry {
+    name: string;
+    duration: number;
+    status: 'success' | 'error' | 'cancelled' | 'rejected' | 'queued';
+    islandId?: string;
+    raceStrategy?: string;
+    errorMessage?: string;
+}
+export interface HmrLogEntry {
+    filename: string;
+    event: string;
+}
+export declare const nexusLogger: {
+    /**
+     * Logs an SSR route render to the terminal.
+     * Called by @nexus_js/server after each page response.
+     */
+    route(entry: RouteLogEntry): void;
+    /**
+     * Logs a Server Action invocation.
+     * Called by @nexus_js/server/actions after each action resolves/rejects.
+     */
+    action(entry: ActionLogEntry): void;
+    /**
+     * Logs a file-change event from the dev-mode watcher.
+     */
+    hmr(entry: HmrLogEntry): void;
+    /**
+     * Startup banner. Printed by the CLI after the server port is bound.
+     * The server itself does NOT call this — the CLI (or host) controls when/whether to print.
+     */
+    banner(opts: {
+        port: number;
+        version: string;
+        elapsed: number;
+        dev: boolean;
+    }): void;
+};
+export type { RouteLogEntry as NexusRouteLog, ActionLogEntry as NexusActionLog };
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAWH,MAAM,MAAM,aAAa,GACrB,kBAAkB,GAClB,KAAK,GACL,kBAAkB,GAClB,oBAAoB,GACpB,kBAAkB,CAAC;AAEvB,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;AAE/E,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAS,MAAM,CAAC;IACtB,IAAI,EAAW,MAAM,CAAC;IACtB,MAAM,EAAS,MAAM,CAAC;IACtB,QAAQ,EAAO,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,aAAa,GAAG,MAAM,CAAC;IACvC,kEAAkE;IAClE,WAAW,CAAC,EAAG,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAW,MAAM,CAAC;IACtB,QAAQ,EAAO,MAAM,CAAC;IACtB,MAAM,EAAS,SAAS,GAAG,OAAO,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,CAAC;IACzE,QAAQ,CAAC,EAAM,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAK,MAAM,CAAC;CAClB;AA+CD,eAAO,MAAM,WAAW;IACtB;;;OAGG;iBACU,aAAa,GAAG,IAAI;IA0BjC;;;OAGG;kBACW,cAAc,GAAG,IAAI;IA+BnC;;OAEG;eACQ,WAAW,GAAG,IAAI;IAW7B;;;OAGG;iBACU;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;CAuBrF,CAAC;AAGF,YAAY,EAAE,aAAa,IAAI,aAAa,EAAE,cAAc,IAAI,cAAc,EAAE,CAAC"}

package/dist/logger.js

@@ -0,0 +1,158 @@
+/**
+ * Nexus Server Logger — terminal observability for SSR, Actions, HMR.
+ *
+ * Symbol key:
+ *   ○  Static / immutable (CDN-cached forever)
+ *   ◑  PPR / SWR (partially cached, stale-while-revalidate)
+ *   λ  Dynamic (no CDN cache, server-rendered per request)
+ *   ~  Streaming (Suspense, can't cache)
+ *   ▲  Server Action (mutation)
+ *   ✖  Error (any 4xx/5xx)
+ */
+// ── ANSI palette ──────────────────────────────────────────────────────────────
+const c = {
+    reset: '\x1b[0m', bold: '\x1b[1m', dim: '\x1b[2m',
+    red: '\x1b[31m', green: '\x1b[32m', yellow: '\x1b[33m',
+    blue: '\x1b[34m', mag: '\x1b[35m', cyan: '\x1b[36m',
+    gray: '\x1b[90m', white: '\x1b[97m',
+};
+// ── Internal helpers ──────────────────────────────────────────────────────────
+function now() {
+    return new Date().toLocaleTimeString('en', { hour12: false });
+}
+function routeSymbol(entry) {
+    if (entry.status >= 500 || entry.status === 0)
+        return `${c.red}✖${c.reset}`;
+    if (entry.status >= 400)
+        return `${c.yellow}✖${c.reset}`;
+    switch (entry.cacheStrategy) {
+        case 'static-immutable': return `${c.green}○${c.reset}`;
+        case 'swr': return `${c.cyan}◑${c.reset}`;
+        case 'streaming-no-store': return `${c.mag}~${c.reset}`;
+        case 'private-no-store': return `${c.gray}λ${c.reset}`;
+        default: return `${c.yellow}λ${c.reset}`;
+    }
+}
+function cacheTag(strategy) {
+    if (!strategy)
+        return '';
+    const tags = {
+        'static-immutable': `${c.green}[Static ∞]${c.reset}`,
+        'swr': `${c.cyan}[SWR]${c.reset}`,
+        'dynamic-no-store': `${c.yellow}[Dynamic]${c.reset}`,
+        'streaming-no-store': `${c.mag}[Stream]${c.reset}`,
+        'private-no-store': `${c.gray}[Private]${c.reset}`,
+    };
+    return '  ' + (tags[strategy] ?? `${c.gray}[${strategy}]${c.reset}`);
+}
+function durationColor(ms) {
+    if (ms < 50)
+        return c.green;
+    if (ms < 300)
+        return c.yellow;
+    return c.red;
+}
+function actionStatusColor(status) {
+    switch (status) {
+        case 'success': return c.green;
+        case 'cancelled': return c.yellow;
+        case 'queued': return c.cyan;
+        default: return c.red;
+    }
+}
+// ── Exported logger ───────────────────────────────────────────────────────────
+export const nexusLogger = {
+    /**
+     * Logs an SSR route render to the terminal.
+     * Called by @nexus_js/server after each page response.
+     */
+    route(entry) {
+        const sym = routeSymbol(entry);
+        const mCol = entry.method === 'GET' ? c.cyan : c.mag;
+        const sCol = entry.status >= 500 ? c.red : entry.status >= 400 ? c.yellow : c.green;
+        const tCol = durationColor(entry.duration);
+        const islands = typeof entry.islandCount === 'number' && entry.islandCount > 0
+            ? `  ${c.dim}${entry.islandCount} island${entry.islandCount !== 1 ? 's' : ''}${c.reset}`
+            : '';
+        const errTag = entry.errorMessage
+            ? `  ${c.red}${entry.errorMessage.slice(0, 60)}${c.reset}`
+            : '';
+        process.stdout.write(`  ${sym} ` +
+            `${c.gray}${now()}${c.reset}` +
+            `  ${mCol}${entry.method.padEnd(4)}${c.reset}` +
+            `  ${entry.path.padEnd(38)}` +
+            `  ${sCol}${entry.status}${c.reset}` +
+            `  ${tCol}${entry.duration}ms${c.reset}` +
+            cacheTag(entry.cacheStrategy) +
+            islands +
+            errTag +
+            '\n');
+    },
+    /**
+     * Logs a Server Action invocation.
+     * Called by @nexus_js/server/actions after each action resolves/rejects.
+     */
+    action(entry) {
+        const sCol = actionStatusColor(entry.status);
+        const sym = entry.status === 'success'
+            ? `${c.green}▲${c.reset}`
+            : entry.status === 'cancelled' || entry.status === 'queued'
+                ? `${c.yellow}▲${c.reset}`
+                : `${c.red}▲${c.reset}`;
+        const raceTag = entry.raceStrategy
+            ? `  ${c.dim}[race:${entry.raceStrategy}]${c.reset}`
+            : '';
+        const islandTag = entry.islandId
+            ? `  ${c.gray}↳ ${entry.islandId}${c.reset}`
+            : '';
+        const errTag = entry.errorMessage
+            ? `  ${c.red}${entry.errorMessage.slice(0, 60)}${c.reset}`
+            : '';
+        process.stdout.write(`  ${sym} ` +
+            `${c.gray}${now()}${c.reset}` +
+            `  ${c.mag}${c.bold}ACTION${c.reset}` +
+            `  ${c.white}${entry.name.padEnd(32)}${c.reset}` +
+            `  ${sCol}${entry.status.toUpperCase().padEnd(10)}${c.reset}` +
+            `  ${c.dim}+${entry.duration}ms${c.reset}` +
+            raceTag +
+            islandTag +
+            errTag +
+            '\n');
+    },
+    /**
+     * Logs a file-change event from the dev-mode watcher.
+     */
+    hmr(entry) {
+        process.stdout.write(`  ${c.mag}◈${c.reset}` +
+            `  ${c.gray}${now()}${c.reset}` +
+            `  ${c.mag}[HMR]${c.reset}` +
+            `  ${c.cyan}${entry.filename}${c.reset}` +
+            `  ${c.dim}${entry.event} — routes reloaded${c.reset}` +
+            '\n');
+    },
+    /**
+     * Startup banner. Printed by the CLI after the server port is bound.
+     * The server itself does NOT call this — the CLI (or host) controls when/whether to print.
+     */
+    banner(opts) {
+        if (process.stdout.isTTY)
+            process.stdout.write('\x1b[2J\x1b[H');
+        const env = opts.dev ? `${c.yellow}dev${c.reset}` : `${c.green}production${c.reset}`;
+        const ready = `${c.green}ready in ${opts.elapsed}ms${c.reset}`;
+        console.log(`\n  ${c.mag}${c.bold}◆ NEXUS${c.reset} ${c.dim}v${opts.version}${c.reset}` +
+            `  ${env}   ${ready}\n` +
+            `\n  ${c.green}➜${c.reset}  ${c.bold}Local${c.reset}    ${c.cyan}http://localhost:${opts.port}/${c.reset}` +
+            (opts.dev
+                ? `\n  ${c.green}➜${c.reset}  ${c.bold}Studio${c.reset}   ${c.cyan}http://localhost:7822/${c.reset}   ${c.dim}nexus studio${c.reset}`
+                : '') +
+            `\n\n  Symbol key:` +
+            `  ${c.green}○${c.reset} static  ` +
+            `${c.cyan}◑${c.reset} SWR  ` +
+            `${c.yellow}λ${c.reset} dynamic  ` +
+            `${c.mag}~${c.reset} stream  ` +
+            `${c.green}▲${c.reset} action  ` +
+            `${c.red}✖${c.reset} error` +
+            `\n\n  ${c.dim}press Ctrl+C to stop${c.reset}\n`);
+    },
+};
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

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

package/dist/navigate.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Nexus Navigation Server Handler
+ *
+ * Responds to /_nexus/navigate?path=... requests from the client router.
+ * Returns a JSON payload with the new page's HTML and metadata,
+ * optimized for the DOM morphing algorithm.
+ */
+import type { RouteManifest } from '@nexus_js/router';
+import type { RenderOptions } from './renderer.js';
+export interface NavigationPayload {
+    html: string;
+    headHTML: string;
+    islandManifest: Array<{
+        id: string;
+        componentPath: string;
+        strategy: string;
+    }>;
+    timestamp: number;
+}
+export declare function handleNavigationRequest(request: Request, manifest: RouteManifest, renderOpts: RenderOptions): Promise<Response>;
+//# sourceMappingURL=navigate.d.ts.map

package/dist/navigate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigate.d.ts","sourceRoot":"","sources":["../src/navigate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/E,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,aAAa,EACvB,UAAU,EAAE,aAAa,GACxB,OAAO,CAAC,QAAQ,CAAC,CAgDnB"}

package/dist/navigate.js

@@ -0,0 +1,45 @@
+/**
+ * Nexus Navigation Server Handler
+ *
+ * Responds to /_nexus/navigate?path=... requests from the client router.
+ * Returns a JSON payload with the new page's HTML and metadata,
+ * optimized for the DOM morphing algorithm.
+ */
+import { matchRoute } from '@nexus_js/router';
+import { createContext } from './context.js';
+import { renderRoute } from './renderer.js';
+export async function handleNavigationRequest(request, manifest, renderOpts) {
+    const url = new URL(request.url);
+    const path = url.searchParams.get('path') ?? '/';
+    const matched = matchRoute(path, manifest);
+    if (!matched) {
+        return new Response(JSON.stringify({ error: 'Route not found', path }), { status: 404, headers: { 'content-type': 'application/json' } });
+    }
+    // Create a mock request for the target path
+    const targetRequest = new Request(new URL(path, request.url).href, { headers: request.headers });
+    const ctx = createContext(targetRequest, matched.params);
+    try {
+        const result = await renderRoute(matched, ctx, renderOpts);
+        // Extract <head> content from the full HTML
+        const headMatch = /<head>([\s\S]*?)<\/head>/i.exec(result.html);
+        const bodyMatch = /<body[^>]*>([\s\S]*?)<\/body>/i.exec(result.html);
+        const payload = {
+            html: bodyMatch?.[1]?.trim() ?? result.html,
+            headHTML: headMatch?.[1]?.trim() ?? '',
+            islandManifest: [],
+            timestamp: Date.now(),
+        };
+        return new Response(JSON.stringify(payload), {
+            status: 200,
+            headers: {
+                'content-type': 'application/json',
+                'cache-control': 'no-store',
+                'x-nexus-navigate': '1',
+            },
+        });
+    }
+    catch (err) {
+        return new Response(JSON.stringify({ error: err instanceof Error ? err.message : String(err) }), { status: 500, headers: { 'content-type': 'application/json' } });
+    }
+}
+//# sourceMappingURL=navigate.js.map

package/dist/navigate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigate.js","sourceRoot":"","sources":["../src/navigate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAU5C,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,OAAgB,EAChB,QAAuB,EACvB,UAAyB;IAEzB,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACjC,MAAM,IAAI,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC;IAEjD,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAE3C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,IAAI,QAAQ,CACjB,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,EAClD,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,EAAE,CACjE,CAAC;IACJ,CAAC;IAED,4CAA4C;IAC5C,MAAM,aAAa,GAAG,IAAI,OAAO,CAC/B,IAAI,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAC/B,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAC7B,CAAC;IACF,MAAM,GAAG,GAAG,aAAa,CAAC,aAAa,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAEzD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,OAAO,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC;QAE3D,4CAA4C;QAC5C,MAAM,SAAS,GAAG,2BAA2B,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAChE,MAAM,SAAS,GAAG,gCAAgC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAErE,MAAM,OAAO,GAAsB;YACjC,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,MAAM,CAAC,IAAI;YAC3C,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE;YACtC,cAAc,EAAE,EAAE;YAClB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC;QAEF,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE;YAC3C,MAAM,EAAE,GAAG;YACX,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,eAAe,EAAE,UAAU;gBAC3B,kBAAkB,EAAE,GAAG;aACxB;SACF,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,IAAI,QAAQ,CACjB,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,EAC3E,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,EAAE,CACjE,CAAC;IACJ,CAAC;AACH,CAAC"}