@emkodev/emroute 1.6.2 → 1.6.3

package/dist/server/emroute.server.js

@@ -0,0 +1,314 @@
+/**
+ * Emroute Server
+ *
+ * Runtime-agnostic server that handles SSR rendering, manifest resolution,
+ * static file serving, and route matching. Works with any Runtime implementation.
+ *
+ * Usage (standalone):
+ * ```ts
+ * import { createEmrouteServer } from '@emkodev/emroute/server';
+ * import { BunFsRuntime } from '@emkodev/emroute/runtime/bun/fs';
+ *
+ * const runtime = new BunFsRuntime('.', { routesDir: '/routes' });
+ * const emroute = await createEmrouteServer({ spa: 'root' }, runtime);
+ *
+ * Bun.serve({ fetch: (req) => emroute.handleRequest(req) ?? new Response('Not Found', { status: 404 }) });
+ * ```
+ *
+ * Usage (composable):
+ * ```ts
+ * const emroute = await createEmrouteServer(config, runtime);
+ *
+ * Bun.serve({ async fetch(req) {
+ *   if (isApiRoute(req)) return handleApi(req);
+ *   const response = await emroute.handleRequest(req);
+ *   if (response) return response;
+ *   return new Response('Not Found', { status: 404 });
+ * }});
+ * ```
+ */
+import { DEFAULT_BASE_PATH, prefixManifest } from "../src/route/route.core.js";
+import { SsrHtmlRouter } from "../src/renderer/ssr/html.renderer.js";
+import { SsrMdRouter } from "../src/renderer/ssr/md.renderer.js";
+import { WidgetRegistry } from "../src/widget/widget.registry.js";
+import { escapeHtml } from "../src/util/html.util.js";
+import { ROUTES_MANIFEST_PATH, WIDGETS_MANIFEST_PATH, } from "../runtime/abstract.runtime.js";
+// ── Module loaders ─────────────────────────────────────────────────────
+/**
+ * Create module loaders for server-side SSR imports.
+ * Uses `runtime.loadModule()` — each runtime decides how to load modules
+ * (filesystem import, SQLite transpile + blob URL, etc.).
+ */
+function createModuleLoaders(manifest, runtime) {
+    const loaders = {};
+    const modulePaths = new Set();
+    for (const route of manifest.routes) {
+        if (route.files?.ts)
+            modulePaths.add(route.files.ts);
+        if (route.modulePath.endsWith('.ts'))
+            modulePaths.add(route.modulePath);
+    }
+    for (const boundary of manifest.errorBoundaries) {
+        modulePaths.add(boundary.modulePath);
+    }
+    if (manifest.errorHandler) {
+        modulePaths.add(manifest.errorHandler.modulePath);
+    }
+    for (const [_, statusRoute] of manifest.statusPages) {
+        if (statusRoute.modulePath.endsWith('.ts')) {
+            modulePaths.add(statusRoute.modulePath);
+        }
+    }
+    for (const path of modulePaths) {
+        loaders[path] = () => runtime.loadModule(path);
+    }
+    return loaders;
+}
+// ── Widget helpers ─────────────────────────────────────────────────────
+/** Find a WidgetComponent export from a module. */
+function extractWidgetExport(mod) {
+    for (const value of Object.values(mod)) {
+        if (!value)
+            continue;
+        if (typeof value === 'object' && 'getData' in value) {
+            return value;
+        }
+        if (typeof value === 'function' && value.prototype?.getData) {
+            return new value();
+        }
+    }
+    return null;
+}
+/** Import widget modules for SSR via runtime.loadModule(). */
+async function importWidgets(entries, runtime, manual) {
+    const registry = new WidgetRegistry();
+    for (const entry of entries) {
+        try {
+            const runtimePath = entry.modulePath.startsWith('/')
+                ? entry.modulePath
+                : `/${entry.modulePath}`;
+            const mod = await runtime.loadModule(runtimePath);
+            const instance = extractWidgetExport(mod);
+            if (!instance)
+                continue;
+            registry.add(instance);
+        }
+        catch (e) {
+            console.error(`[emroute] Failed to load widget ${entry.modulePath}:`, e);
+        }
+    }
+    if (manual) {
+        for (const widget of manual) {
+            registry.add(widget);
+        }
+    }
+    const widgetFiles = {};
+    for (const entry of entries) {
+        if (entry.files)
+            widgetFiles[entry.name] = entry.files;
+    }
+    return { registry, widgetFiles };
+}
+// ── HTML shell ─────────────────────────────────────────────────────────
+/** Build a default HTML shell. */
+function buildHtmlShell(title) {
+    return `<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>${escapeHtml(title)}</title>
+  <style>@view-transition { navigation: auto; } router-slot { display: contents; }</style>
+</head>
+<body>
+  <router-slot></router-slot>
+</body>
+</html>`;
+}
+/** Inject SSR-rendered content into an HTML shell. */
+function injectSsrContent(html, content, title, ssrRoute) {
+    const slotPattern = /<router-slot\b[^>]*>.*?<\/router-slot>/s;
+    if (!slotPattern.test(html))
+        return html;
+    const ssrAttr = ssrRoute ? ` data-ssr-route="${ssrRoute}"` : '';
+    html = html.replace(slotPattern, `<router-slot${ssrAttr}>${content}</router-slot>`);
+    if (title) {
+        html = html.replace(/<title>[^<]*<\/title>/, `<title>${escapeHtml(title)}</title>`);
+    }
+    return html;
+}
+/** Read the HTML shell from runtime, with fallback to a default shell. */
+async function resolveShell(runtime, title) {
+    const response = await runtime.query('/index.html');
+    if (response.status !== 404)
+        return await response.text();
+    return buildHtmlShell(title);
+}
+// ── More path helpers ─────────────────────────────────────────────────
+/** Deserialize a routes manifest from JSON (statusPages array → Map). */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function deserializeManifest(raw) {
+    return {
+        routes: raw.routes,
+        errorBoundaries: raw.errorBoundaries,
+        statusPages: new Map(raw.statusPages ?? []),
+        errorHandler: raw.errorHandler,
+    };
+}
+// ── createEmrouteServer ────────────────────────────────────────────────
+/**
+ * Create an emroute server.
+ *
+ * All paths are Runtime-relative (starting with `/`). Runtime root = appRoot.
+ */
+export async function createEmrouteServer(config, runtime) {
+    const { spa = 'root', } = config;
+    // Let the runtime know the SPA mode so bundle() can skip when 'none'.
+    runtime.config.spa = spa;
+    const { html: htmlBase, md: mdBase } = config.basePath ?? DEFAULT_BASE_PATH;
+    // ── Routes manifest (read from runtime) ─────────────────────────────
+    let routesManifest;
+    if (config.routesManifest) {
+        routesManifest = config.routesManifest;
+    }
+    else {
+        const manifestResponse = await runtime.query(ROUTES_MANIFEST_PATH);
+        if (manifestResponse.status === 404) {
+            throw new Error(`[emroute] ${ROUTES_MANIFEST_PATH} not found in runtime. ` +
+                'Provide routesManifest in config or ensure the runtime produces it.');
+        }
+        const raw = await manifestResponse.json();
+        routesManifest = deserializeManifest(raw);
+    }
+    routesManifest.moduleLoaders = createModuleLoaders(routesManifest, runtime);
+    // ── Widgets (read from runtime) ────────────────────────────────────
+    let widgets = config.widgets;
+    let widgetFiles = {};
+    let discoveredWidgetEntries = [];
+    const widgetsResponse = await runtime.query(WIDGETS_MANIFEST_PATH);
+    if (widgetsResponse.status !== 404) {
+        discoveredWidgetEntries = await widgetsResponse.json();
+        const imported = await importWidgets(discoveredWidgetEntries, runtime, config.widgets);
+        widgets = imported.registry;
+        widgetFiles = imported.widgetFiles;
+    }
+    // ── SSR routers ──────────────────────────────────────────────────────
+    let ssrHtmlRouter = null;
+    let ssrMdRouter = null;
+    function buildSsrRouters() {
+        if (spa === 'only') {
+            ssrHtmlRouter = null;
+            ssrMdRouter = null;
+            return;
+        }
+        ssrHtmlRouter = new SsrHtmlRouter(prefixManifest(routesManifest, htmlBase), {
+            fileReader: (path) => runtime.query(path, { as: 'text' }),
+            basePath: htmlBase,
+            markdownRenderer: config.markdownRenderer,
+            extendContext: config.extendContext,
+            widgets,
+            widgetFiles,
+        });
+        ssrMdRouter = new SsrMdRouter(prefixManifest(routesManifest, mdBase), {
+            fileReader: (path) => runtime.query(path, { as: 'text' }),
+            basePath: mdBase,
+            extendContext: config.extendContext,
+            widgets,
+            widgetFiles,
+        });
+    }
+    buildSsrRouters();
+    // ── Bundling (runtime decides whether/how to bundle) ────────────────
+    await runtime.bundle();
+    // ── HTML shell ───────────────────────────────────────────────────────
+    const title = config.title ?? 'emroute';
+    let shell = await resolveShell(runtime, title);
+    // Auto-discover main.css and inject <link> into <head>
+    if ((await runtime.query('/main.css')).status !== 404) {
+        shell = shell.replace('</head>', '  <link rel="stylesheet" href="/main.css">\n</head>');
+    }
+    // ── handleRequest ────────────────────────────────────────────────────
+    async function handleRequest(req) {
+        const url = new URL(req.url);
+        const pathname = url.pathname;
+        const mdPrefix = mdBase + '/';
+        const htmlPrefix = htmlBase + '/';
+        // SSR Markdown: /md/*
+        if (ssrMdRouter &&
+            (pathname.startsWith(mdPrefix) || pathname === mdBase)) {
+            try {
+                const { content, status, redirect } = await ssrMdRouter.render(pathname);
+                if (redirect) {
+                    return Response.redirect(new URL(redirect, url.origin), status);
+                }
+                return new Response(content, {
+                    status,
+                    headers: { 'Content-Type': 'text/markdown; charset=utf-8; variant=CommonMark' },
+                });
+            }
+            catch (e) {
+                console.error(`[emroute] Error rendering ${pathname}:`, e);
+                return new Response('Internal Server Error', { status: 500 });
+            }
+        }
+        // SSR HTML: /html/*
+        if (ssrHtmlRouter &&
+            (pathname.startsWith(htmlPrefix) || pathname === htmlBase)) {
+            try {
+                const result = await ssrHtmlRouter.render(pathname);
+                if (result.redirect) {
+                    return Response.redirect(new URL(result.redirect, url.origin), result.status);
+                }
+                const ssrTitle = result.title ?? title;
+                const html = injectSsrContent(shell, result.content, ssrTitle, pathname);
+                return new Response(html, {
+                    status: result.status,
+                    headers: { 'Content-Type': 'text/html; charset=utf-8' },
+                });
+            }
+            catch (e) {
+                console.error(`[emroute] Error rendering ${pathname}:`, e);
+                return new Response('Internal Server Error', { status: 500 });
+            }
+        }
+        // /html/* or /md/* that wasn't handled by SSR (e.g. 'only' mode) — serve SPA shell
+        if (pathname.startsWith(htmlPrefix) || pathname === htmlBase ||
+            pathname.startsWith(mdPrefix) || pathname === mdBase) {
+            return new Response(shell, {
+                status: 200,
+                headers: { 'Content-Type': 'text/html; charset=utf-8' },
+            });
+        }
+        // Static files — only try runtime for paths with a file extension
+        const lastSegment = pathname.split('/').pop() ?? '';
+        if (lastSegment.includes('.')) {
+            const fileResponse = await runtime.handle(pathname);
+            if (fileResponse.status === 200)
+                return fileResponse;
+            return null;
+        }
+        // Bare paths — redirect to /html/* in all modes.
+        const bare = pathname === '/' ? '' : pathname.slice(1).replace(/\/$/, '');
+        return Response.redirect(new URL(`${htmlBase}/${bare}`, url.origin), 302);
+    }
+    // ── Return ───────────────────────────────────────────────────────────
+    return {
+        handleRequest,
+        get htmlRouter() {
+            return ssrHtmlRouter;
+        },
+        get mdRouter() {
+            return ssrMdRouter;
+        },
+        get manifest() {
+            return routesManifest;
+        },
+        get widgetEntries() {
+            return discoveredWidgetEntries;
+        },
+        get shell() {
+            return shell;
+        },
+    };
+}
+//# sourceMappingURL=emroute.server.js.map

package/dist/server/emroute.server.js.map

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

package/dist/server/esbuild-manifest.plugin.d.ts

@@ -0,0 +1,26 @@
+/**
+ * esbuild Virtual Manifest Plugin
+ *
+ * Intercepts `emroute:routes` and `emroute:widgets` import specifiers.
+ * Reads JSON manifests from the runtime and generates TypeScript modules
+ * with `moduleLoaders` (dynamic `import()` calls) in-memory — no .g.ts
+ * files on disk.
+ *
+ * This is the single source of truth: JSON manifest → esbuild bundle.
+ */
+import type { Runtime } from '../runtime/abstract.runtime.ts';
+interface ManifestPluginOptions {
+    runtime: Runtime;
+    /** HTML base path prefix for route patterns (e.g. '/html'). */
+    basePath?: string;
+    /**
+     * Directory prefix to strip from module paths so that import() calls
+     * are relative to the entry point (e.g. 'routes/' strips '/routes/').
+     */
+    stripPrefix?: string;
+    /** Absolute directory for resolving relative import() paths in generated code. */
+    resolveDir: string;
+}
+type EsbuildPlugin = any;
+export declare function createManifestPlugin(options: ManifestPluginOptions): EsbuildPlugin;
+export {};

package/dist/server/esbuild-manifest.plugin.js

@@ -0,0 +1,187 @@
+/**
+ * esbuild Virtual Manifest Plugin
+ *
+ * Intercepts `emroute:routes` and `emroute:widgets` import specifiers.
+ * Reads JSON manifests from the runtime and generates TypeScript modules
+ * with `moduleLoaders` (dynamic `import()` calls) in-memory — no .g.ts
+ * files on disk.
+ *
+ * This is the single source of truth: JSON manifest → esbuild bundle.
+ */
+import { ROUTES_MANIFEST_PATH, WIDGETS_MANIFEST_PATH } from "../runtime/abstract.runtime.js";
+/** Escape a string for use inside a single-quoted JS/TS string literal. */
+function esc(value) {
+    return value.replace(/\\/g, '\\\\').replace(/'/g, "\\'");
+}
+export function createManifestPlugin(options) {
+    const { runtime, basePath = '', stripPrefix = '', resolveDir } = options;
+    const prefixPattern = (pattern) => basePath ? (pattern === '/' ? basePath : basePath + pattern) : pattern;
+    const strip = (p) => stripPrefix && p.startsWith(stripPrefix) ? p.slice(stripPrefix.length) : p;
+    return {
+        name: 'emroute-manifest',
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        setup(build) {
+            // ── Resolve virtual specifiers ──────────────────────────────────
+            build.onResolve({ filter: /^emroute:/ }, 
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            (args) => ({ path: args.path, namespace: 'emroute' }));
+            // ── Load virtual modules ────────────────────────────────────────
+            build.onLoad({ filter: /.*/, namespace: 'emroute' }, 
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            async (args) => {
+                if (args.path === 'emroute:routes') {
+                    return { contents: await generateRoutesModule(), loader: 'ts', resolveDir };
+                }
+                if (args.path === 'emroute:widgets') {
+                    return { contents: await generateWidgetsModule(), loader: 'ts', resolveDir };
+                }
+                return undefined;
+            });
+        },
+    };
+    // ── Routes module generator ───────────────────────────────────────
+    async function generateRoutesModule() {
+        const response = await runtime.query(ROUTES_MANIFEST_PATH);
+        if (response.status === 404) {
+            return `export const routesManifest = { routes: [], errorBoundaries: [], statusPages: new Map(), moduleLoaders: {} };`;
+        }
+        const raw = await response.json();
+        // Routes array
+        const routesArray = (raw.routes ?? [])
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            .map((r) => {
+            const filesStr = r.files
+                ? `\n    files: { ${Object.entries(r.files)
+                    .filter(([_, v]) => v)
+                    .map(([k, v]) => `${k}: '${esc(strip(v))}'`)
+                    .join(', ')} },`
+                : '';
+            return `  {
+    pattern: '${esc(prefixPattern(r.pattern))}',
+    type: '${esc(r.type)}',
+    modulePath: '${esc(strip(r.modulePath))}',${filesStr}${r.parent ? `\n    parent: '${esc(prefixPattern(r.parent))}',` : ''}${r.statusCode ? `\n    statusCode: ${r.statusCode},` : ''}
+  }`;
+        })
+            .join(',\n');
+        // Error boundaries
+        const errorBoundariesArray = (raw.errorBoundaries ?? [])
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            .map((e) => `  {
+    pattern: '${esc(prefixPattern(e.pattern))}',
+    modulePath: '${esc(strip(e.modulePath))}',
+  }`)
+            .join(',\n');
+        // Status pages
+        const statusPagesEntries = (raw.statusPages ?? [])
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            .map(([status, route]) => {
+            const filesStr = route.files
+                ? `, files: { ${Object.entries(route.files)
+                    .map(([k, v]) => `${k}: '${esc(strip(v))}'`)
+                    .join(', ')} }`
+                : '';
+            return `  [${status}, { pattern: '${esc(prefixPattern(route.pattern))}', type: '${esc(route.type)}', modulePath: '${esc(strip(route.modulePath))}', statusCode: ${status}${filesStr} }]`;
+        })
+            .join(',\n');
+        // Error handler
+        const errorHandlerCode = raw.errorHandler
+            ? `{
+  pattern: '${esc(prefixPattern(raw.errorHandler.pattern))}',
+  type: '${esc(raw.errorHandler.type)}',
+  modulePath: '${esc(strip(raw.errorHandler.modulePath))}',
+}`
+            : 'undefined';
+        // Module loaders — collect all .ts module paths
+        const tsModulePaths = new Set();
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        for (const route of (raw.routes ?? [])) {
+            if (route.files?.ts)
+                tsModulePaths.add(route.files.ts);
+            if (route.modulePath.endsWith('.ts'))
+                tsModulePaths.add(route.modulePath);
+        }
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        for (const boundary of (raw.errorBoundaries ?? [])) {
+            tsModulePaths.add(boundary.modulePath);
+        }
+        if (raw.errorHandler) {
+            tsModulePaths.add(raw.errorHandler.modulePath);
+        }
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        for (const [_, statusRoute] of (raw.statusPages ?? [])) {
+            if (statusRoute.modulePath.endsWith('.ts')) {
+                tsModulePaths.add(statusRoute.modulePath);
+            }
+        }
+        const moduleLoadersCode = [...tsModulePaths]
+            .map((p) => {
+            const key = strip(p);
+            const rel = key.replace(/^\.?\//, '');
+            return `    '${esc(key)}': () => import('./${esc(rel)}'),`;
+        })
+            .join('\n');
+        return `import type { RoutesManifest } from '@emkodev/emroute';
+
+export const routesManifest: RoutesManifest = {
+  routes: [
+${routesArray}
+  ],
+
+  errorBoundaries: [
+${errorBoundariesArray}
+  ],
+
+  statusPages: new Map([
+${statusPagesEntries}
+  ]),
+
+  errorHandler: ${errorHandlerCode},
+
+  moduleLoaders: {
+${moduleLoadersCode}
+  },
+};
+`;
+    }
+    // ── Widgets module generator ──────────────────────────────────────
+    async function generateWidgetsModule() {
+        const response = await runtime.query(WIDGETS_MANIFEST_PATH);
+        if (response.status === 404) {
+            return `export const widgetsManifest = { widgets: [], moduleLoaders: {} };`;
+        }
+        const entries = await response.json();
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const widgetEntries = entries.map((e) => {
+            const filesStr = e.files
+                ? `\n      files: { ${Object.entries(e.files)
+                    .filter(([_, v]) => v)
+                    .map(([k, v]) => `${k}: '${esc(strip(v))}'`)
+                    .join(', ')} },`
+                : '';
+            return `    {
+      name: '${esc(e.name)}',
+      modulePath: '${esc(strip(e.modulePath))}',
+      tagName: '${esc(e.tagName)}',${filesStr}
+    }`;
+        }).join(',\n');
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const loaderEntries = entries.map((e) => {
+            const key = strip(e.modulePath);
+            const rel = key.replace(/^\.?\//, '');
+            return `    '${esc(key)}': () => import('./${esc(rel)}'),`;
+        }).join('\n');
+        return `import type { WidgetsManifest } from '@emkodev/emroute';
+
+export const widgetsManifest: WidgetsManifest = {
+  widgets: [
+${widgetEntries}
+  ],
+
+  moduleLoaders: {
+${loaderEntries}
+  },
+};
+`;
+    }
+}
+//# sourceMappingURL=esbuild-manifest.plugin.js.map

package/dist/server/esbuild-manifest.plugin.js.map

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

package/dist/server/scanner.util.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Standalone Scanning Utilities
+ *
+ * Runtime-agnostic route and widget scanning. Works with any Runtime
+ * that implements query() — used by tests with mock runtimes and by
+ * the CLI generate command.
+ *
+ * Note: BunFsRuntime has these as instance methods with lazy caching.
+ * These standalone functions are the same logic without caching.
+ */
+import type { Runtime } from '../runtime/abstract.runtime.ts';
+import type { RoutesManifest } from '../src/type/route.type.ts';
+import type { WidgetManifestEntry } from '../src/type/widget.type.ts';
+export interface GeneratorResult extends RoutesManifest {
+    warnings: string[];
+}
+/** Generate routes manifest by scanning a directory via Runtime. */
+export declare function generateRoutesManifest(routesDir: string, runtime: Runtime): Promise<GeneratorResult>;
+/**
+ * Discover widget modules and companion files by scanning a directory.
+ */
+export declare function discoverWidgets(widgetsDir: string, runtime: Runtime, pathPrefix?: string): Promise<WidgetManifestEntry[]>;