@cmj/juice 0.0.1

package/dist/compiler/types.d.ts

@@ -0,0 +1,188 @@
+/**
+ * Core type definitions for the Juice Vite plugin compiler.
+ *
+ * @module types
+ * @internal These types are consumed internally by the compiler pipeline.
+ *           Only {@link JuicePluginOptions} is part of the public API surface.
+ */
+/**
+ * Configuration options for the Juice Vite plugin.
+ *
+ * @remarks
+ * v1 is zero-config. This interface exists as the extension point for future
+ * additive options, ensuring backward compatibility.
+ *
+ * @example
+ * ```ts
+ * import juice from '@cmj/juice/plugin';
+ * // Zero-config (default)
+ * juice();
+ * // With options (future)
+ * juice({ manifestFileName: 'custom-manifest.json' });
+ * ```
+ */
+export interface JuicePluginOptions {
+    /**
+     * Custom filename for the Flight manifest.
+     * @defaultValue `'flight-manifest.json'`
+     */
+    readonly manifestFileName?: string;
+    /**
+     * Route map: URL patterns → server component modules.
+     *
+     * @remarks
+     * In a future version, routes will be auto-discovered from the filesystem.
+     * For v1, the consumer passes them explicitly.
+     *
+     * @example
+     * ```ts
+     * juice({
+     *   routes: {
+     *     '/': { moduleId: './app/routes/home.tsx' },
+     *     '/product/:id': { moduleId: './app/routes/product.tsx' },
+     *   },
+     * });
+     * ```
+     */
+    readonly routes?: Readonly<Record<string, {
+        moduleId: string;
+        exportName?: string;
+    }>>;
+}
+/**
+ * Represents a single export extracted from a `'use client'` module.
+ *
+ * @internal
+ */
+export interface ExportRecord {
+    /** The exported name visible to importers (e.g., `'default'`, `'Badge'`). */
+    readonly exportedName: string;
+    /**
+     * The local binding name in the source module.
+     * May differ from `exportedName` for re-exports (e.g., `export { Foo as Bar }`).
+     */
+    readonly localName: string;
+}
+/**
+ * Information extracted from a confirmed `'use client'` module.
+ *
+ * @internal
+ */
+export interface ClientModuleInfo {
+    /** Root-relative module specifier (e.g., `'components/Counter.tsx'`). */
+    readonly moduleSpecifier: string;
+    /** The absolute file-system path to the source module. */
+    readonly absolutePath: string;
+    /** All exports found in the module. */
+    readonly exports: readonly ExportRecord[];
+}
+/**
+ * Information extracted from a confirmed `'use server'` module.
+ *
+ * @internal
+ */
+export interface ServerActionInfo {
+    /** Root-relative module specifier (e.g., `'actions/auth.ts'`). */
+    readonly moduleSpecifier: string;
+    /** The absolute file-system path to the source module. */
+    readonly absolutePath: string;
+    /** All exported server action functions. */
+    readonly exports: readonly ExportRecord[];
+}
+/**
+ * A single export entry within the Flight manifest.
+ *
+ * @internal
+ */
+export interface ManifestExportEntry {
+    /** Globally unique ID: `moduleSpecifier#exportName`. */
+    readonly id: string;
+    /** The export name (e.g., `'default'`, `'Badge'`). */
+    readonly name: string;
+    /** Chunk files required to load this export. */
+    readonly chunks: readonly string[];
+}
+/**
+ * A module entry within the Flight manifest.
+ *
+ * @internal
+ */
+export interface ManifestModuleEntry {
+    /** All chunk files associated with this module. */
+    readonly chunks: readonly string[];
+    /** Per-export chunk mappings. */
+    readonly exports: Readonly<Record<string, ManifestExportEntry>>;
+}
+/**
+ * A server action entry within the Flight manifest.
+ *
+ * Field names are aligned with the runtime's `ServerActionRef` contract
+ * so that `flight-manifest.json` can be consumed directly by `createRouter()`.
+ *
+ * @internal
+ */
+export interface ManifestServerActionEntry {
+    /** Globally unique action ID: `moduleSpecifier#exportName`. */
+    readonly id: string;
+    /** The export name (e.g., `'submitForm'`, `'default'`). */
+    readonly exportName: string;
+    /** Root-relative module specifier containing this action. */
+    readonly moduleId: string;
+}
+/**
+ * Route entry mapping a URL pattern to its server component module.
+ *
+ * Aligned with the runtime's `RouteEntry` contract.
+ *
+ * @internal
+ */
+export interface ManifestRouteEntry {
+    /** Root-relative module specifier (e.g., `'./app/routes/home.tsx'`). */
+    readonly moduleId: string;
+    /**
+     * Named export to use as the page component.
+     * @default 'default'
+     */
+    readonly exportName?: string;
+}
+/**
+ * The complete Flight manifest schema emitted as `flight-manifest.json`.
+ *
+ * This is the **sole bridge** between the compiler and the runtime.
+ * All field names are aligned with the runtime's `FlightManifest` type
+ * so that the output JSON can be passed directly to `createRouter()`.
+ *
+ * @see {@link https://juice.dev/schemas/flight-manifest.v1.json}
+ */
+export interface FlightManifest {
+    /** JSON Schema reference for tooling support. */
+    readonly $schema: string;
+    /** Schema version number. Always `1` for this release. */
+    readonly version: 1;
+    /** Maps URL patterns to their server component modules. */
+    readonly routes: Readonly<Record<string, ManifestRouteEntry>>;
+    /** Maps module specifiers to their client-side chunk metadata. */
+    readonly clientModules: Readonly<Record<string, ManifestModuleEntry>>;
+    /** Reserved for SSR-specific chunk resolution. Empty in v1. */
+    readonly ssrModules: Readonly<Record<string, ManifestModuleEntry>>;
+    /** Maps server action IDs to their module and export info. */
+    readonly serverActions: Readonly<Record<string, ManifestServerActionEntry>>;
+    /**
+     * Build-time metadata injected by the Vite plugin.
+     * The runtime reads these as defaults for `RouterOptions`, enabling
+     * zero-config `createRouter(manifest)`.
+     */
+    readonly _meta?: {
+        /** Absolute file URL of the Vite project root. */
+        readonly root?: string;
+        /** Build mode: `'development'` or `'production'`. */
+        readonly mode?: 'development' | 'production';
+        /** Vite HMR client URL (only in dev). */
+        readonly hmrUrl?: string;
+        /** Public URL prefix for client assets. */
+        readonly assetPrefix?: string;
+        /** Client entry script that calls `hydrateRoot()`. */
+        readonly clientEntry?: string;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/compiler/types.js

@@ -0,0 +1,9 @@
+/**
+ * Core type definitions for the Juice Vite plugin compiler.
+ *
+ * @module types
+ * @internal These types are consumed internally by the compiler pipeline.
+ *           Only {@link JuicePluginOptions} is part of the public API surface.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/compiler/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/compiler/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/runtime/actions.d.ts

@@ -0,0 +1,37 @@
+import type { FlightManifest, RouterOptions } from './types.js';
+/**
+ * Extracts the server action ID from the request.
+ *
+ * Resolution order:
+ * 1. `x-juice-action-id` header (set by React Flight client)
+ * 2. `$ACTION_ID` hidden form field (progressive enhancement)
+ *
+ * @param req - The incoming POST `Request`.
+ * @returns The action ID string, or `null` if not found.
+ *
+ * @internal
+ */
+export declare function _extractActionId(req: Request): Promise<string | null>;
+/**
+ * The POST server action pipeline.
+ *
+ * 1. Extracts the action ID from the request.
+ * 2. Looks up the action in the manifest.
+ * 3. Dynamically imports the action module.
+ * 4. Parses the request body.
+ * 5. Executes the action function.
+ * 6. Returns the result as a JSON response, or passes through
+ *    a thrown `Response` directly.
+ *
+ * @param req      - The incoming POST `Request`.
+ * @param manifest - The flight manifest for action resolution.
+ * @param options  - Router options (hooks).
+ * @returns A `Response` with the action result or error.
+ *
+ * @internal
+ */
+export declare function _serverActionPipeline(req: Request, manifest: FlightManifest, options: Required<Pick<RouterOptions, 'onError'>> & RouterOptions & {
+    isDev?: boolean;
+    hmrUrl?: string;
+}): Promise<Response>;
+//# sourceMappingURL=actions.d.ts.map

package/dist/runtime/actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/runtime/actions.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAIhE;;;;;;;;;;;GAWG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAoBxB;AAgCD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,OAAO,EACZ,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC,GAAG,aAAa,GAAG;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACvG,OAAO,CAAC,QAAQ,CAAC,CAoHnB"}

package/dist/runtime/actions.js

@@ -0,0 +1,167 @@
+// ── juice/runtime server actions ───────────────────────────────────
+// Handles POST requests: extracts the action ID, resolves the handler
+// from the manifest, parses the request body, and executes the action.
+// ────────────────────────────────────────────────────────────────────
+import { ActionNotFoundError, ModuleLoadError } from './errors.js';
+import { _resolveModulePath } from './resolve.js';
+import { _bustModuleCache } from './dev.js';
+/**
+ * Extracts the server action ID from the request.
+ *
+ * Resolution order:
+ * 1. `x-juice-action-id` header (set by React Flight client)
+ * 2. `$ACTION_ID` hidden form field (progressive enhancement)
+ *
+ * @param req - The incoming POST `Request`.
+ * @returns The action ID string, or `null` if not found.
+ *
+ * @internal
+ */
+export async function _extractActionId(req) {
+    // Priority 1: Header (set by React Flight client runtime)
+    const headerActionId = req.headers.get('x-juice-action-id');
+    if (headerActionId)
+        return headerActionId;
+    // Priority 2: Hidden form field (progressive enhancement / no-JS)
+    const contentType = req.headers.get('content-type') ?? '';
+    if (contentType.includes('multipart/form-data') ||
+        contentType.includes('application/x-www-form-urlencoded')) {
+        // Clone to avoid consuming the body — the action handler may need it.
+        const formData = await req.clone().formData();
+        const actionId = formData.get('$ACTION_ID');
+        if (typeof actionId === 'string' && actionId.length > 0) {
+            return actionId;
+        }
+    }
+    return null;
+}
+/**
+ * Parses the request body based on Content-Type.
+ *
+ * - `multipart/form-data` → `FormData`
+ * - `application/x-www-form-urlencoded` → `FormData`
+ * - `application/json` → parsed JSON object
+ * - Everything else → raw text
+ *
+ * @param req - The incoming POST `Request`.
+ * @returns The parsed body.
+ *
+ * @internal
+ */
+async function _parseBody(req) {
+    const contentType = req.headers.get('content-type') ?? '';
+    if (contentType.includes('multipart/form-data') ||
+        contentType.includes('application/x-www-form-urlencoded')) {
+        return req.formData();
+    }
+    if (contentType.includes('application/json')) {
+        return req.json();
+    }
+    return req.text();
+}
+/**
+ * The POST server action pipeline.
+ *
+ * 1. Extracts the action ID from the request.
+ * 2. Looks up the action in the manifest.
+ * 3. Dynamically imports the action module.
+ * 4. Parses the request body.
+ * 5. Executes the action function.
+ * 6. Returns the result as a JSON response, or passes through
+ *    a thrown `Response` directly.
+ *
+ * @param req      - The incoming POST `Request`.
+ * @param manifest - The flight manifest for action resolution.
+ * @param options  - Router options (hooks).
+ * @returns A `Response` with the action result or error.
+ *
+ * @internal
+ */
+export async function _serverActionPipeline(req, manifest, options) {
+    // ── 1. Extract action ID ─────────────────────────────────────
+    const actionId = await _extractActionId(req);
+    if (!actionId) {
+        return new Response(JSON.stringify({
+            error: 'Bad Request',
+            message: 'Missing server action ID. ' +
+                'Ensure your form includes a "$ACTION_ID" field or the request ' +
+                'sends an "x-juice-action-id" header.',
+        }), {
+            status: 400,
+            headers: { 'Content-Type': 'application/json' },
+        });
+    }
+    // ── 2. Lookup in manifest ────────────────────────────────
+    const actionRef = manifest.serverActions[actionId];
+    if (!actionRef) {
+        // Return a clean 404 JSON response instead of throwing.
+        // Throwing would leak stack traces in production.
+        return new Response(JSON.stringify({
+            error: 'Not Found',
+            message: `Server Action "${actionId}" not found in the manifest. ` +
+                `Ensure the function is exported with 'use server' and the manifest is up to date.`,
+        }), {
+            status: 404,
+            headers: { 'Content-Type': 'application/json' },
+        });
+    }
+    try {
+        // ── 3. Dynamic import ────────────────────────────────────
+        let importPath = _resolveModulePath(actionRef.moduleId, options.root);
+        if (options.isDev) {
+            importPath = _bustModuleCache(importPath);
+        }
+        let mod;
+        try {
+            mod = await import(importPath);
+        }
+        catch (cause) {
+            throw new ModuleLoadError(actionRef.moduleId, `Server Action "${actionId}"` +
+                (options.root
+                    ? ` (resolved to "${importPath}" from root "${options.root}")`
+                    : ' (no root option set — pass { root: import.meta.url } to createRouter)'), cause);
+        }
+        const actionFn = mod[actionRef.exportName];
+        if (typeof actionFn !== 'function') {
+            throw new Error(`[juice/runtime] Server Action "${actionId}" resolved to module ` +
+                `"${actionRef.moduleId}" but export "${actionRef.exportName}" ` +
+                `is not a function. Check your 'use server' exports.`);
+        }
+        // ── 4. Parse body ──────────────────────────────────────────
+        const body = await _parseBody(req);
+        // ── 5. Execute ─────────────────────────────────────────────
+        const result = await actionFn(body);
+        // ── 6. Return ──────────────────────────────────────────────
+        // If the action returns a Response directly, pass it through.
+        if (result instanceof Response) {
+            return result;
+        }
+        return new Response(JSON.stringify(result ?? null), {
+            status: 200,
+            headers: { 'Content-Type': 'application/json' },
+        });
+    }
+    catch (thrown) {
+        // ── Thrown Response: user intentionally signaled a non-200 ──
+        if (thrown instanceof Response) {
+            return thrown;
+        }
+        // ── Unexpected error ───────────────────────────────────────
+        // Dev mode: return rich error JSON with stack/cause details
+        if (options.isDev) {
+            const err = thrown instanceof Error ? thrown : new Error(String(thrown));
+            return new Response(JSON.stringify({
+                error: err.name,
+                message: err.message,
+                stack: err.stack,
+                actionId,
+                cause: err.cause instanceof Error ? err.cause.message : undefined,
+            }, null, 2), {
+                status: 500,
+                headers: { 'Content-Type': 'application/json' },
+            });
+        }
+        return options.onError(thrown, req);
+    }
+}
+//# sourceMappingURL=actions.js.map

package/dist/runtime/actions.js.map

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

package/dist/runtime/dev.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Generates a rich HTML error overlay for development mode.
+ *
+ * Features:
+ * - Dark theme with syntax-highlighted stack trace
+ * - Source file + line number parsed from Error stack
+ * - Request URL, method, and matched route context
+ * - Auto-refresh via HMR EventSource (if hmrUrl provided)
+ *
+ * @param error   - The caught error (may be Error or unknown).
+ * @param req     - The incoming request (for URL/method display).
+ * @param context - Optional context string (e.g., route path, action ID).
+ * @returns A full HTML string for the error overlay response.
+ *
+ * @internal
+ */
+export declare function _generateDevErrorOverlay(error: unknown, req: Request, context?: string): string;
+/**
+ * Generates the Vite HMR client `<script>` tag for SSR injection.
+ *
+ * @param hmrUrl - The HMR client URL (default: `'/@vite/client'`).
+ * @returns A `<script type="module">` string.
+ *
+ * @internal
+ */
+export declare function _generateHmrClientScript(hmrUrl?: string): string;
+/**
+ * Appends a cache-busting timestamp query parameter to a module ID.
+ *
+ * In development mode, this forces the JS runtime to re-evaluate
+ * the module on every `import()` call, ensuring edits are picked up
+ * immediately without a server restart.
+ *
+ * In production, this function should NOT be called — modules are
+ * cached normally for performance.
+ *
+ * @param moduleId - The original module path (e.g., `'./app/routes/home.tsx'`).
+ * @returns The module path with `?t={timestamp}` appended.
+ *
+ * @internal
+ */
+export declare function _bustModuleCache(moduleId: string): string;
+//# sourceMappingURL=dev.d.ts.map

package/dist/runtime/dev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/runtime/dev.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,OAAO,EACZ,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAgKR;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAGhE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGzD"}