@mantajs/host-nitro 0.2.0-beta.0

package/dist/build.d.ts

@@ -0,0 +1,30 @@
+export interface BuildOptions {
+    /** Working directory */
+    cwd: string;
+    /** Deployment preset (vercel, node, cloudflare, etc.) */
+    preset: string;
+    /** Output directory (default: .output) */
+    outputDir?: string;
+}
+export interface BuildResult {
+    /** Output directory path */
+    outputDir: string;
+    /** Preset used */
+    preset: string;
+}
+/**
+ * Build a Manta project for production using Nitro.
+ *
+ * Runs `nitropack build` with the specified preset. The resulting output
+ * includes the compiled server (catch-all route + Manta bootstrap) and
+ * any static assets (admin dashboard).
+ *
+ * ```ts
+ * import { buildForProduction } from '@mantajs/host-nitro'
+ *
+ * await buildForProduction({ cwd: '.', preset: 'node' })
+ * // .output/server/index.mjs ready to run
+ * ```
+ */
+export declare function buildForProduction(options: BuildOptions): Promise<BuildResult>;
+//# sourceMappingURL=build.d.ts.map

package/dist/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../src/build.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,YAAY;IAC3B,wBAAwB;IACxB,GAAG,EAAE,MAAM,CAAA;IACX,yDAAyD;IACzD,MAAM,EAAE,MAAM,CAAA;IACd,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAA;IACjB,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAmHpF"}

package/dist/build.js

@@ -0,0 +1,128 @@
+// SPEC-039 — Nitro production build for Manta
+// Delegates to nitropack build (v2) or nitro build (v3 when stable).
+/**
+ * Build a Manta project for production using Nitro.
+ *
+ * Runs `nitropack build` with the specified preset. The resulting output
+ * includes the compiled server (catch-all route + Manta bootstrap) and
+ * any static assets (admin dashboard).
+ *
+ * ```ts
+ * import { buildForProduction } from '@mantajs/host-nitro'
+ *
+ * await buildForProduction({ cwd: '.', preset: 'node' })
+ * // .output/server/index.mjs ready to run
+ * ```
+ */
+export async function buildForProduction(options) {
+    const { cwd, preset, outputDir = '.output' } = options;
+    const { resolve, dirname } = await import('node:path');
+    const { execFileSync } = await import('node:child_process');
+    const { copyFileSync, mkdirSync, existsSync, writeFileSync } = await import('node:fs');
+    const { createRequire } = await import('node:module');
+    const { fileURLToPath } = await import('node:url');
+    // Copy framework server templates to .manta/server/ BEFORE running Nitro build.
+    // In dev mode, dev.ts handles this. In build mode, we must do it here because
+    // nitro.config.ts has `srcDir: '.manta/server'` — without these files, Nitro
+    // compiles an empty server with no routes and the deploy 404s on everything.
+    const __dirname = dirname(fileURLToPath(import.meta.url));
+    const templatesDir = resolve(__dirname, '..', 'templates', 'server');
+    const targetDir = resolve(cwd, '.manta', 'server');
+    const routesDir = resolve(targetDir, 'routes');
+    if (!existsSync(targetDir))
+        mkdirSync(targetDir, { recursive: true });
+    if (!existsSync(routesDir))
+        mkdirSync(routesDir, { recursive: true });
+    copyFileSync(resolve(templatesDir, 'routes', '[...].ts'), resolve(routesDir, '[...].ts'));
+    // Copy manta.config.ts
+    const configSrc = resolve(cwd, 'manta.config.ts');
+    if (existsSync(configSrc)) {
+        copyFileSync(configSrc, resolve(targetDir, 'manta.config.ts'));
+    }
+    // Generate a PRODUCTION bootstrap that statically imports the manifest.
+    // The dev template uses require('./manifest') which DOES NOT WORK in ESM bundles
+    // (require is a CommonJS thing, the Nitro bundle is ESM). The prod bootstrap uses
+    // a static `import ... from './manifest'` which Nitro/rolldown traces and bundles.
+    //
+    // If no manifest.ts exists (non-serverless preset), fall back to the dev template.
+    const manifestPath = resolve(targetDir, 'manifest.ts');
+    if (existsSync(manifestPath)) {
+        const deploymentPreset = preset === 'cloudflare' ? 'cloudflare' : preset === 'vercel' ? 'vercel' : '';
+        const prodBootstrap = `// @ts-nocheck — Auto-generated PRODUCTION bootstrap (manifest with lazy imports)
+import { bootstrapApp } from '@mantajs/cli/bootstrap'
+import { moduleImports, preloadedResources, preloadedPluginResources } from './manifest'
+
+const deploymentPreset = ${JSON.stringify(deploymentPreset)}
+let _bootstrapped: any = null
+let _promise: Promise<any> | null = null
+
+async function bootstrap() {
+  if (_bootstrapped) return _bootstrapped
+  const cwd = typeof process.cwd === 'function' ? process.cwd() : '/'
+
+  // Cloudflare exposes env during the request lifecycle. Do not read .env from
+  // the filesystem or include the load-env module in the Worker bundle.
+${deploymentPreset === 'cloudflare' ? "  const cfEnv = (globalThis as any).__env__ as Record<string, unknown> | undefined\n  if (cfEnv) {\n    for (const [key, value] of Object.entries(cfEnv)) {\n      if (process.env[key] === undefined && ['string', 'number', 'boolean'].includes(typeof value)) {\n        process.env[key] = String(value)\n      }\n    }\n  }\n" : "  const { loadEnv } = await import('@mantajs/cli/env')\n  loadEnv(cwd)\n"}
+  if (deploymentPreset) {
+    process.env.MANTA_DEPLOY_PRESET = deploymentPreset
+  }
+
+  const mantaConfigModule = await import('./manta.config')
+  const rawConfig = mantaConfigModule.default ?? mantaConfigModule
+  const config = deploymentPreset && !rawConfig.preset ? { ...rawConfig, preset: deploymentPreset } : rawConfig
+
+  // Resolve all lazy imports AFTER globals are registered inside bootstrapApp.
+  // The lazy imports are () => import('...') functions that only execute when called.
+  // bootstrapApp's importFn calls them on demand → user code runs AFTER
+  // defineModel/field/etc. are set on globalThis.
+  const importFn = async (path: string): Promise<Record<string, unknown>> => {
+    const lazyFn = moduleImports[path]
+    if (lazyFn) return lazyFn()
+    // Fallback: try without/with extension
+    const withoutExt = path.replace(/\\.tsx?$/, '')
+    for (const [key, fn] of Object.entries(moduleImports)) {
+      if (key.replace(/\\.tsx?$/, '') === withoutExt) return fn()
+    }
+    return {}
+  }
+
+  _bootstrapped = await bootstrapApp({
+    config,
+    cwd,
+    mode: 'dev',
+    preloadedResources: preloadedResources as any,
+    preloadedPluginResources: preloadedPluginResources as any,
+    importFn,
+  })
+  return _bootstrapped
+}
+
+function bootPromise() {
+  if (!_promise) _promise = bootstrap()
+  return _promise
+}
+
+export async function getMantaAdapter() { const { adapter } = await bootPromise(); return adapter }
+export async function getMantaApp() { const { app } = await bootPromise(); return app }
+`;
+        writeFileSync(resolve(targetDir, 'manta-bootstrap.ts'), prodBootstrap);
+    }
+    else {
+        // No manifest → use the dev template (jiti-based runtime discovery)
+        copyFileSync(resolve(templatesDir, 'manta-bootstrap.ts'), resolve(targetDir, 'manta-bootstrap.ts'));
+    }
+    const presetArg = preset === 'node' ? 'node-server' : preset === 'cloudflare' ? 'cloudflare_module' : preset;
+    const nodeRequire = createRequire(import.meta.url);
+    const nitroPkgPath = nodeRequire.resolve('nitro/package.json');
+    const nitroCliPath = resolve(dirname(nitroPkgPath), 'dist', 'cli', 'index.mjs');
+    execFileSync(process.execPath, [nitroCliPath, 'build', '--preset', presetArg], {
+        cwd,
+        stdio: 'inherit',
+        env: { ...process.env, NODE_ENV: 'production' },
+    });
+    return {
+        outputDir: resolve(cwd, outputDir),
+        preset,
+    };
+}
+//# sourceMappingURL=build.js.map

package/dist/build.js.map

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

package/dist/dev.d.ts

@@ -0,0 +1,34 @@
+export interface SpaEntry {
+    /** SPA name (e.g. 'admin', 'vendor') — served on /{name} */
+    name: string;
+    /** Vite config path for this SPA */
+    viteConfigPath: string;
+    /** Vite dev server port */
+    vitePort: number;
+}
+export interface DevServerOptions {
+    /** Working directory */
+    cwd: string;
+    /** Dev server port */
+    port: number;
+    /** Vite config path for admin dashboard (starts Vite alongside Nitro) */
+    viteConfigPath?: string;
+    /** Vite dev server port (default: 5199) */
+    vitePort?: number;
+    /** V2: SPAs to serve (generalizes viteConfigPath for N SPAs) */
+    spas?: SpaEntry[];
+}
+export interface DevServerHandle {
+    /** Close the dev server and cleanup */
+    close(): Promise<void>;
+    /** The port the server is running on */
+    port: number;
+}
+/**
+ * Start a Nitro dev server programmatically.
+ *
+ * Copies framework templates to .manta/server/ then starts Nitro.
+ * The dev project has NO server/ directory — this is all framework.
+ */
+export declare function startDevServer(options: DevServerOptions): Promise<DevServerHandle>;
+//# sourceMappingURL=dev.d.ts.map

package/dist/dev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../src/dev.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,QAAQ;IACvB,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAA;IACZ,oCAAoC;IACpC,cAAc,EAAE,MAAM,CAAA;IACtB,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,wBAAwB;IACxB,GAAG,EAAE,MAAM,CAAA;IACX,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,yEAAyE;IACzE,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,gEAAgE;IAChE,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAA;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACtB,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAwJxF"}

package/dist/dev.js

@@ -0,0 +1,215 @@
+// SPEC-039 — Programmatic Nitro dev server for Manta
+// Copies framework-owned server templates to .manta/server/
+// The dev project has NO server/ directory.
+import { copyFileSync, mkdirSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * Start a Nitro dev server programmatically.
+ *
+ * Copies framework templates to .manta/server/ then starts Nitro.
+ * The dev project has NO server/ directory — this is all framework.
+ */
+export async function startDevServer(options) {
+    const { cwd, port, viteConfigPath, vitePort = 5199, spas = [] } = options;
+    // Collect all SPA entries (legacy viteConfigPath + V2 spas)
+    const allSpas = [...spas];
+    if (viteConfigPath && !allSpas.some((s) => s.name === 'admin')) {
+        allSpas.push({ name: 'admin', viteConfigPath, vitePort });
+    }
+    // Start Vite dev servers for each SPA
+    // biome-ignore lint/suspicious/noExplicitAny: child process handles
+    const viteProcesses = [];
+    for (const spa of allSpas) {
+        const proc = await startViteDev(cwd, spa.viteConfigPath, spa.vitePort);
+        viteProcesses.push(proc);
+    }
+    // Expose Vite port so the catch-all route handler can proxy SPA fallback in dev
+    if (allSpas.length > 0) {
+        process.env.__MANTA_VITE_PORT = String(allSpas[0].vitePort);
+    }
+    // Copy framework server templates to .manta/server/
+    copyServerTemplates(cwd);
+    // Build devProxy config for all SPAs
+    // Each SPA gets: /{name}, /{name}/, /{name}/** proxied to its Vite dev server
+    // Vite internals (/@vite, /@fs, /node_modules/.vite) also proxied for HMR
+    // ws: true enables WebSocket upgrade proxying (Vite HMR)
+    const devProxy = {};
+    for (const spa of allSpas) {
+        const target = `http://localhost:${spa.vitePort}`;
+        devProxy[`/${spa.name}/**`] = { target, ws: true };
+        devProxy[`/${spa.name}/`] = { target, ws: true };
+        devProxy[`/${spa.name}`] = { target, ws: true };
+    }
+    if (allSpas.length > 0) {
+        const target = `http://localhost:${allSpas[0].vitePort}`;
+        devProxy['/@vite/**'] = { target, ws: true };
+        devProxy['/@fs/**'] = { target, ws: true };
+        devProxy['/node_modules/.vite/**'] = { target, ws: true };
+    }
+    // Programmatic Nitro v3 dev server
+    const { createNitro, createDevServer, prepare, build } = await import('nitro/builder');
+    const nitro = await createNitro({
+        rootDir: cwd,
+        dev: true,
+        preset: 'nitro-dev',
+        scanDirs: [resolve(cwd, '.manta', 'server')],
+        // nitro-dev externalizes node_modules by default. Manta workspace packages
+        // intentionally expose TS source during development, so let Nitro bundle
+        // them instead of asking Node ESM to load directory-style source exports.
+        noExternals: [/@mantajs\//],
+        ...(Object.keys(devProxy).length > 0 ? { devProxy } : {}),
+    });
+    const server = createDevServer(nitro);
+    const listener = await server.listen({ port, hostname: 'localhost' });
+    // SPA fallback: intercept SPA sub-routes (e.g. /admin/paniers) at the raw HTTP
+    // level BEFORE Nitro's serveStatic. Proxy to Vite with Accept: text/html so
+    // Vite returns index.html for client-side routing.
+    // biome-ignore lint/suspicious/noExplicitAny: listhen internal
+    const httpServer = listener?.node?.server;
+    if (httpServer && allSpas.length > 0) {
+        const spaNames = allSpas.map((s) => s.name);
+        const originalListeners = httpServer.listeners('request').slice();
+        httpServer.removeAllListeners('request');
+        httpServer.on('request', async (req, res) => {
+            const url = req.url ?? '';
+            const matchedSpa = spaNames.find((name) => url.startsWith(`/${name}/`) || url === `/${name}`);
+            // Proxy ALL SPA requests to Vite (HTML pages, .tsx, .js, .css, assets)
+            // Only skip /api/* routes which are handled by Nitro
+            if (matchedSpa && !url.startsWith('/api/') && req.method === 'GET') {
+                const spaVitePort = allSpas.find((s) => s.name === matchedSpa)?.vitePort;
+                if (spaVitePort) {
+                    try {
+                        const isHtmlRoute = !url.match(/\.\w+(\?|$)/);
+                        const headers = isHtmlRoute ? { Accept: 'text/html' } : {};
+                        const viteRes = await fetch(`http://localhost:${spaVitePort}${url}`, { headers });
+                        if (viteRes.ok) {
+                            const contentType = viteRes.headers.get('content-type') ?? 'application/octet-stream';
+                            const body = Buffer.from(await viteRes.arrayBuffer());
+                            res.writeHead(200, { 'Content-Type': contentType });
+                            res.end(body);
+                            return;
+                        }
+                    }
+                    catch {
+                        // Vite not ready — fall through to Nitro
+                    }
+                }
+            }
+            // Also proxy Vite internal paths (HMR, source maps, etc.)
+            if (url.startsWith('/@vite/') || url.startsWith('/@fs/') || url.startsWith('/node_modules/.vite/')) {
+                const spaVitePort = allSpas[0]?.vitePort;
+                if (spaVitePort) {
+                    try {
+                        const viteRes = await fetch(`http://localhost:${spaVitePort}${url}`);
+                        if (viteRes.ok) {
+                            const contentType = viteRes.headers.get('content-type') ?? 'application/javascript';
+                            const body = Buffer.from(await viteRes.arrayBuffer());
+                            res.writeHead(200, { 'Content-Type': contentType });
+                            res.end(body);
+                            return;
+                        }
+                    }
+                    catch {
+                        // fall through
+                    }
+                }
+            }
+            // Fall through to original Nitro handlers
+            for (const listener of originalListeners) {
+                ;
+                listener.call(httpServer, req, res);
+            }
+        });
+    }
+    // Nitro's dev server always registers an `upgrade` handler (crossws) that routes
+    // WebSocket upgrades to the catch-all route handler — which crashes because our
+    // handler is HTTP-only. Replace it with a proper WS proxy to Vite for HMR.
+    if (httpServer && allSpas.length > 0) {
+        httpServer.removeAllListeners('upgrade');
+        const { createProxyServer } = await import('httpxy');
+        const wsProxy = createProxyServer({ ws: true });
+        wsProxy.on('error', () => { }); // swallow — Vite reconnects
+        httpServer.on('upgrade', (req, socket, head) => {
+            const spa = allSpas.find((s) => req.url?.startsWith(`/${s.name}`));
+            const target = `http://localhost:${(spa ?? allSpas[0]).vitePort}`;
+            // httpxy signature: (req, socket, opts, head?) — target goes in opts.
+            // Cast socket: Node's http 'upgrade' event yields a Duplex subtype; net.Socket is the expected type.
+            wsProxy.ws(req, socket, { target }, head);
+        });
+    }
+    await prepare(nitro);
+    await build(nitro);
+    return {
+        port,
+        async close() {
+            for (const proc of viteProcesses) {
+                if (proc)
+                    proc.kill();
+            }
+            await server.close();
+            await nitro.close();
+        },
+    };
+}
+/**
+ * Copy framework server templates from packages/host-nitro/templates/ to .manta/server/
+ */
+function copyServerTemplates(cwd) {
+    const templatesDir = resolve(__dirname, '..', 'templates', 'server');
+    const targetDir = resolve(cwd, '.manta', 'server');
+    mkdirSync(resolve(targetDir, 'routes'), { recursive: true });
+    mkdirSync(resolve(targetDir, 'middleware'), { recursive: true });
+    // Copy bootstrap
+    copyFileSync(resolve(templatesDir, 'manta-bootstrap.ts'), resolve(targetDir, 'manta-bootstrap.ts'));
+    // Copy catch-all route
+    copyFileSync(resolve(templatesDir, 'routes', '[...].ts'), resolve(targetDir, 'routes', '[...].ts'));
+    // Copy SPA fallback middleware (dev-only: proxies /admin/* to Vite for client-side routing)
+    copyFileSync(resolve(templatesDir, 'middleware', 'spa-fallback.ts'), resolve(targetDir, 'middleware', 'spa-fallback.ts'));
+    // Copy manta.config.ts so the bootstrap's static import resolves.
+    // In dev mode, the manifest doesn't exist → bootstrap falls back to jiti for
+    // module loading. But the config import is always static (no jiti needed for config).
+    const { existsSync } = require('node:fs');
+    const configSrc = resolve(cwd, 'manta.config.ts');
+    if (existsSync(configSrc)) {
+        copyFileSync(configSrc, resolve(targetDir, 'manta.config.ts'));
+    }
+}
+// biome-ignore lint/suspicious/noExplicitAny: child process return
+async function startViteDev(cwd, viteConfigPath, vitePort) {
+    const { spawn } = await import('node:child_process');
+    console.log(`  Starting Vite admin dashboard on port ${vitePort}...`);
+    const child = spawn('npx', ['vite', '--config', viteConfigPath, '--port', String(vitePort)], {
+        cwd,
+        stdio: ['ignore', 'pipe', 'pipe'],
+        env: { ...process.env, FORCE_COLOR: '1' },
+    });
+    child.stdout?.on('data', (data) => {
+        const msg = data.toString().trim();
+        if (msg)
+            console.log(`[vite] ${msg}`);
+    });
+    child.stderr?.on('data', (data) => {
+        const msg = data.toString().trim();
+        if (msg && !msg.includes('ExperimentalWarning'))
+            console.warn(`[vite] ${msg}`);
+    });
+    // Wait for Vite to be ready
+    for (let i = 0; i < 20; i++) {
+        await new Promise((r) => setTimeout(r, 500));
+        try {
+            const res = await fetch(`http://localhost:${vitePort}/admin/`);
+            if (res.ok) {
+                console.log(`  Admin dashboard: http://localhost:${vitePort}/admin/`);
+                break;
+            }
+        }
+        catch {
+            /* not ready yet */
+        }
+    }
+    return child;
+}
+//# sourceMappingURL=dev.js.map

package/dist/dev.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { type BuildOptions, type BuildResult, buildForProduction } from './build';
+export { type DevServerHandle, type DevServerOptions, startDevServer } from './dev';
+export { type StartHandle, type StartOptions, startProduction } from './start';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AACjF,OAAO,EAAE,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAAE,cAAc,EAAE,MAAM,OAAO,CAAA;AACnF,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA"}

package/dist/index.js

@@ -0,0 +1,6 @@
+// @mantajs/host-nitro — Nitro host integration for Manta
+// Three commands: dev, build, start. That's it.
+export { buildForProduction } from './build';
+export { startDevServer } from './dev';
+export { startProduction } from './start';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,gDAAgD;AAEhD,OAAO,EAAuC,kBAAkB,EAAE,MAAM,SAAS,CAAA;AACjF,OAAO,EAA+C,cAAc,EAAE,MAAM,OAAO,CAAA;AACnF,OAAO,EAAuC,eAAe,EAAE,MAAM,SAAS,CAAA"}

package/dist/start.d.ts

@@ -0,0 +1,21 @@
+export interface StartOptions {
+    /** Output directory (default: .output) */
+    outputDir?: string;
+    /** Port override (if supported by the preset) */
+    port?: number;
+}
+export interface StartHandle {
+    /** Close the production server */
+    close(): Promise<void>;
+}
+/**
+ * Start a production server from Nitro build output.
+ *
+ * ```ts
+ * import { startProduction } from '@mantajs/host-nitro'
+ *
+ * await startProduction({ outputDir: '.output' })
+ * ```
+ */
+export declare function startProduction(options?: StartOptions): Promise<StartHandle>;
+//# sourceMappingURL=start.d.ts.map

package/dist/start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../src/start.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,YAAY;IAC3B,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,kCAAkC;IAClC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB;AAED;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CA2BtF"}

package/dist/start.js

@@ -0,0 +1,36 @@
+// SPEC-039 — Start production Nitro output
+// Runs the compiled .output/server/index.mjs from a Nitro build.
+/**
+ * Start a production server from Nitro build output.
+ *
+ * ```ts
+ * import { startProduction } from '@mantajs/host-nitro'
+ *
+ * await startProduction({ outputDir: '.output' })
+ * ```
+ */
+export async function startProduction(options = {}) {
+    const { outputDir = '.output', port } = options;
+    const { resolve } = await import('node:path');
+    const { existsSync } = await import('node:fs');
+    const { spawn } = await import('node:child_process');
+    const entryPath = resolve(outputDir, 'server', 'index.mjs');
+    if (!existsSync(entryPath)) {
+        throw new Error(`Production build not found at ${entryPath}. Run 'manta build' first.`);
+    }
+    const env = { ...process.env };
+    if (port) {
+        env.PORT = String(port);
+        env.NITRO_PORT = String(port);
+    }
+    const child = spawn('node', [entryPath], {
+        stdio: 'inherit',
+        env,
+    });
+    return {
+        async close() {
+            child.kill();
+        },
+    };
+}
+//# sourceMappingURL=start.js.map

package/dist/start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../src/start.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,iEAAiE;AAcjE;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,UAAwB,EAAE;IAC9D,MAAM,EAAE,SAAS,GAAG,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAA;IAC/C,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAA;IAC7C,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAA;IAC9C,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAA;IAEpD,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAA;IAC3D,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,iCAAiC,SAAS,4BAA4B,CAAC,CAAA;IACzF,CAAC;IAED,MAAM,GAAG,GAA2B,EAAE,GAAI,OAAO,CAAC,GAA8B,EAAE,CAAA;IAClF,IAAI,IAAI,EAAE,CAAC;QACT,GAAG,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAA;QACvB,GAAG,CAAC,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,CAAA;IAC/B,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,EAAE;QACvC,KAAK,EAAE,SAAS;QAChB,GAAG;KACJ,CAAC,CAAA;IAEF,OAAO;QACL,KAAK,CAAC,KAAK;YACT,KAAK,CAAC,IAAI,EAAE,CAAA;QACd,CAAC;KACF,CAAA;AACH,CAAC"}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@mantajs/host-nitro",
+  "version": "0.2.0-beta.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "nitro": "3.0.260311-beta",
+    "httpxy": "^0.5.3",
+    "jiti": "^2.6.0",
+    "vite": "^7.0.0",
+    "@vitejs/plugin-react": "^5.2.0"
+  },
+  "files": [
+    "dist",
+    "templates"
+  ]
+}

package/templates/server/manta-bootstrap.ts

@@ -0,0 +1,73 @@
+// @ts-nocheck — Template file: deps (@mantajs/cli, jiti) are resolved in the target project
+// Auto-generated by @mantajs/host-nitro — DO NOT EDIT
+//
+// Uses STATIC imports everywhere (bundled by Nitro at build time):
+//  - @mantajs/cli subpaths (not the barrel) to avoid pulling in dev tooling
+//  - manifest.ts (generated by manta build) with pre-imported user modules
+//  - No jiti, no readdirSync, no dynamic import of .ts files
+//
+// This is the serverless-safe bootstrap: all user code is statically traced
+// and bundled by Nitro/rolldown. No filesystem access at runtime.
+
+import { bootstrapApp } from '@mantajs/cli/bootstrap'
+import { loadEnv } from '@mantajs/cli/env'
+import mantaConfigModule from './manta.config'
+
+// Build-time manifest: pre-discovered resources + pre-imported modules.
+// Generated by `manta build --preset vercel` in packages/cli/src/build/generate-manifest.ts.
+// If the manifest doesn't exist (dev mode), fallback to runtime discovery.
+let manifest: {
+  moduleExports: Record<string, unknown>
+  preloadedResources: unknown
+  preloadedPluginResources: unknown[]
+} | null = null
+try {
+  manifest = require('./manifest')
+} catch {
+  // Manifest not available (dev mode or non-serverless build) — runtime discovery will be used
+}
+
+// biome-ignore lint/suspicious/noExplicitAny: dynamic bootstrap result
+let _bootstrapped: any = null
+
+async function bootstrap() {
+  if (_bootstrapped) return _bootstrapped
+
+  const cwd = process.cwd()
+  loadEnv(cwd)
+
+  const config = mantaConfigModule.default ?? mantaConfigModule
+
+  if (manifest) {
+    // Serverless path: use build-time manifest (no filesystem access, no jiti)
+    _bootstrapped = await bootstrapApp({
+      config,
+      cwd,
+      mode: 'dev',
+      preloadedResources: manifest.preloadedResources as any,
+      preloadedImports: manifest.moduleExports as Record<string, Record<string, unknown>>,
+    })
+  } else {
+    // Dev path: use jiti for runtime .ts loading
+    const { createJiti } = await import('@mantajs/cli/jiti')
+    const jiti = createJiti(cwd)
+    // biome-ignore lint/suspicious/noExplicitAny: dynamic module import
+    const importFn = (path: string) => jiti.import(path) as Promise<any>
+
+    _bootstrapped = await bootstrapApp({ config, cwd, mode: 'dev', importFn })
+  }
+
+  return _bootstrapped
+}
+
+const _promise = bootstrap()
+
+export async function getMantaAdapter() {
+  const { adapter } = await _promise
+  return adapter
+}
+
+export async function getMantaApp() {
+  const { app } = await _promise
+  return app
+}

package/templates/server/middleware/spa-fallback.ts

@@ -0,0 +1,32 @@
+// SPA fallback middleware — runs BEFORE route handlers.
+// In dev mode, proxies SPA routes (e.g. /admin/paniers) to Vite dev server
+// with Accept: text/html so Vite returns index.html for client-side routing.
+
+import { defineEventHandler, setResponseHeader } from '@mantajs/adapter-h3'
+
+export default defineEventHandler(async (event) => {
+  const pathname = event.path ?? ''
+  const vitePort = process.env.__MANTA_VITE_PORT
+
+  // Only in dev (vitePort set), only GET, only SPA sub-routes (not root, not API, not files)
+  if (!vitePort) return
+  if (event.method !== 'GET') return
+  if (pathname === '/admin' || pathname === '/admin/') return // root is handled by devProxy
+  if (!pathname.startsWith('/admin/')) return
+  if (pathname.startsWith('/api/')) return
+  if (pathname.match(/\.\w{2,5}$/)) return // skip .js, .css, .png etc
+
+  // Fetch from Vite with Accept: text/html — triggers Vite's SPA fallback
+  try {
+    const viteRes = await fetch(`http://localhost:${vitePort}${pathname}`, {
+      headers: { Accept: 'text/html' },
+    })
+    if (viteRes.ok) {
+      const html = await viteRes.text()
+      setResponseHeader(event, 'content-type', 'text/html; charset=utf-8')
+      return html
+    }
+  } catch {
+    // Vite not ready yet — fall through
+  }
+})

package/templates/server/routes/[...].ts

@@ -0,0 +1,45 @@
+// Auto-generated by @mantajs/host-nitro — DO NOT EDIT
+// Catch-all: every request goes through the Manta H3 adapter.
+// SPA fallback: if the adapter returns 404 for a SPA path (e.g. /admin/paniers),
+// fetch index.html from the Vite dev server for client-side routing.
+
+import { defineEventHandler, getRequestHeaders, getRequestURL, readRawBody } from '@mantajs/adapter-h3'
+import { getMantaAdapter } from '../manta-bootstrap'
+
+export default defineEventHandler(async (event) => {
+  const adapter = await getMantaAdapter()
+
+  const url = getRequestURL(event)
+  const method = event.method ?? 'GET'
+  const headers = getRequestHeaders(event)
+
+  let body: Uint8Array | undefined
+  if (method !== 'GET' && method !== 'HEAD') {
+    body = ((await readRawBody(event, false)) as Uint8Array | undefined) ?? undefined
+  }
+
+  const request = new Request(url.toString(), {
+    method,
+    headers,
+    body: (body || undefined) as BodyInit | undefined,
+  })
+  const response = await adapter.handleRequest(request)
+
+  // SPA fallback for dev mode: if the adapter returned 404 for a GET on a SPA path,
+  // fetch the SPA index.html from Vite. In prod, Vercel rewrites handle this.
+  if (response.status === 404 && method === 'GET') {
+    const pathname = url.pathname
+    const vitePort = process.env.__MANTA_VITE_PORT
+    if (vitePort && pathname.startsWith('/admin') && !pathname.startsWith('/api/') && !pathname.match(/\.\w+$/)) {
+      const viteRes = await fetch(`http://localhost:${vitePort}/admin/`)
+      if (viteRes.ok) {
+        return new Response(viteRes.body, {
+          status: 200,
+          headers: { 'content-type': 'text/html; charset=utf-8' },
+        })
+      }
+    }
+  }
+
+  return response
+})