@cmj/juice 0.0.1

package/dist/compiler/proxy.js

@@ -0,0 +1,80 @@
+/**
+ * Generates React Flight proxy modules that replace `'use client'` source
+ * modules in the server build.
+ *
+ * The proxy module exports `registerClientReference` calls for each export
+ * found in the original client component. This allows the React Flight
+ * serializer to emit a reference to the client chunk instead of attempting
+ * to render the component on the server.
+ *
+ * @module proxy
+ * @internal
+ */
+/**
+ * Generate the server-side proxy source code for a `'use client'` module.
+ *
+ * The emitted code replaces the original module in the server bundle.
+ * Each export becomes a `registerClientReference()` call that the React
+ * Flight serializer understands.
+ *
+ * @param moduleSpecifier - Root-relative module path used as the stable ID
+ *                          in the Flight wire format (e.g., `'components/Counter.tsx'`).
+ * @param exports - All exports extracted from the original module AST.
+ * @returns A complete ES module source string ready to feed into Vite's
+ *          `load` hook.
+ *
+ * @example
+ * ```ts
+ * const source = _generateProxyModule('components/Counter.tsx', [
+ *   { exportedName: 'default', localName: 'Counter' },
+ *   { exportedName: 'Badge', localName: 'Badge' },
+ * ]);
+ * // Returns:
+ * // import { registerClientReference } from 'react-server-dom-webpack/server';
+ * // export default registerClientReference({}, 'components/Counter.tsx', 'default');
+ * // export const Badge = registerClientReference({}, 'components/Counter.tsx', 'Badge');
+ * ```
+ *
+ * @internal
+ */
+export function _generateProxyModule(moduleSpecifier, exports) {
+    if (exports.length === 0) {
+        throw new Error(`[juice/compiler] _generateProxyModule called with zero exports ` +
+            `for "${moduleSpecifier}". This is a compiler bug — the transform ` +
+            `hook should reject directive modules with no exports before reaching proxy generation.`);
+    }
+    const lines = [
+        `import { registerClientReference } from 'react-server-dom-webpack/server';`,
+        '',
+    ];
+    for (const exp of exports) {
+        const ref = `registerClientReference({}, ${JSON.stringify(moduleSpecifier)}, ${JSON.stringify(exp.exportedName)})`;
+        if (exp.exportedName === 'default') {
+            lines.push(`export default ${ref};`);
+        }
+        else if (_isValidIdentifier(exp.exportedName)) {
+            lines.push(`export const ${exp.exportedName} = ${ref};`);
+        }
+        else {
+            // Non-identifier export names (e.g., "string-name") use re-export syntax
+            lines.push(`const _${_safeVarName(exp.exportedName)} = ${ref};`);
+            lines.push(`export { _${_safeVarName(exp.exportedName)} as ${JSON.stringify(exp.exportedName)} };`);
+        }
+    }
+    return lines.join('\n') + '\n';
+}
+/**
+ * Check whether a string is a valid JS identifier (safe for `export const X`).
+ * @internal
+ */
+function _isValidIdentifier(name) {
+    return /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(name);
+}
+/**
+ * Convert a non-identifier string to a safe variable name for internal use.
+ * @internal
+ */
+function _safeVarName(name) {
+    return name.replace(/[^a-zA-Z0-9_$]/g, '_');
+}
+//# sourceMappingURL=proxy.js.map

package/dist/compiler/proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.js","sourceRoot":"","sources":["../../src/compiler/proxy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,oBAAoB,CAClC,eAAuB,EACvB,OAAgC;IAEhC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,iEAAiE;YACjE,QAAQ,eAAe,4CAA4C;YACnE,wFAAwF,CACzF,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAa;QACtB,4EAA4E;QAC5E,EAAE;KACH,CAAC;IAEF,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,MAAM,GAAG,GAAG,+BAA+B,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC;QAEnH,IAAI,GAAG,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YACnC,KAAK,CAAC,IAAI,CAAC,kBAAkB,GAAG,GAAG,CAAC,CAAC;QACvC,CAAC;aAAM,IAAI,kBAAkB,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;YAChD,KAAK,CAAC,IAAI,CAAC,gBAAgB,GAAG,CAAC,YAAY,MAAM,GAAG,GAAG,CAAC,CAAC;QAC3D,CAAC;aAAM,CAAC;YACN,yEAAyE;YACzE,KAAK,CAAC,IAAI,CAAC,UAAU,YAAY,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;YACjE,KAAK,CAAC,IAAI,CAAC,aAAa,YAAY,CAAC,GAAG,CAAC,YAAY,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QACtG,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AACjC,CAAC;AAED;;;GAGG;AACH,SAAS,kBAAkB,CAAC,IAAY;IACtC,OAAO,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjD,CAAC;AAED;;;GAGG;AACH,SAAS,YAAY,CAAC,IAAY;IAChC,OAAO,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;AAC9C,CAAC"}

package/dist/compiler/registry.d.ts

@@ -0,0 +1,58 @@
+/**
+ * In-memory registry of detected `'use client'` modules.
+ *
+ * Shared between the server and client Vite builds via the same plugin
+ * instance. The registry is a simple `Map` keyed by the root-relative
+ * module specifier.
+ *
+ * @module registry
+ * @internal
+ */
+import type { ClientModuleInfo } from './types.js';
+/**
+ * Registry tracking all modules that declared `'use client'`.
+ *
+ * @remarks
+ * This map is populated during the `transform` hook of the server build and
+ * consumed during the `buildStart` / `generateBundle` hooks of the client build.
+ * Because both builds share the same plugin object, the map persists across builds.
+ *
+ * @internal
+ */
+export declare class ClientModuleRegistry {
+    private readonly _modules;
+    /**
+     * Register a client module.
+     *
+     * @param info - The parsed client module information.
+     */
+    register(info: ClientModuleInfo): void;
+    /**
+     * Check if a module specifier has been registered as a client module.
+     *
+     * @param moduleSpecifier - Root-relative module path.
+     */
+    has(moduleSpecifier: string): boolean;
+    /**
+     * Retrieve the info for a registered client module.
+     *
+     * @param moduleSpecifier - Root-relative module path.
+     * @returns The module info, or `undefined` if not registered.
+     */
+    get(moduleSpecifier: string): ClientModuleInfo | undefined;
+    /**
+     * Iterate over all registered client modules.
+     */
+    entries(): IterableIterator<[string, ClientModuleInfo]>;
+    /**
+     * Number of registered client modules.
+     */
+    get size(): number;
+    /**
+     * Clear all registrations. Used between test runs.
+     *
+     * @internal
+     */
+    _clear(): void;
+}
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/compiler/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;;;;;;;;GASG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuC;IAEhE;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI;IAgBtC;;;;OAIG;IACH,GAAG,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO;IAIrC;;;;;OAKG;IACH,GAAG,CAAC,eAAe,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAI1D;;OAEG;IACH,OAAO,IAAI,gBAAgB,CAAC,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAIvD;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;OAIG;IACH,MAAM,IAAI,IAAI;CAGf"}

package/dist/compiler/registry.js

@@ -0,0 +1,79 @@
+/**
+ * In-memory registry of detected `'use client'` modules.
+ *
+ * Shared between the server and client Vite builds via the same plugin
+ * instance. The registry is a simple `Map` keyed by the root-relative
+ * module specifier.
+ *
+ * @module registry
+ * @internal
+ */
+/**
+ * Registry tracking all modules that declared `'use client'`.
+ *
+ * @remarks
+ * This map is populated during the `transform` hook of the server build and
+ * consumed during the `buildStart` / `generateBundle` hooks of the client build.
+ * Because both builds share the same plugin object, the map persists across builds.
+ *
+ * @internal
+ */
+export class ClientModuleRegistry {
+    _modules = new Map();
+    /**
+     * Register a client module.
+     *
+     * @param info - The parsed client module information.
+     */
+    register(info) {
+        if (this._modules.has(info.moduleSpecifier)) {
+            // HMR re-processing is expected — only warn in non-HMR contexts
+            // (i.e., when the exports change between registrations)
+            const existing = this._modules.get(info.moduleSpecifier);
+            if (existing.exports.length !== info.exports.length) {
+                console.warn(`[juice] Client module "${info.moduleSpecifier}" re-registered ` +
+                    `with different exports (${existing.exports.length} → ${info.exports.length}). ` +
+                    `This may indicate a stale build cache.`);
+            }
+        }
+        this._modules.set(info.moduleSpecifier, info);
+    }
+    /**
+     * Check if a module specifier has been registered as a client module.
+     *
+     * @param moduleSpecifier - Root-relative module path.
+     */
+    has(moduleSpecifier) {
+        return this._modules.has(moduleSpecifier);
+    }
+    /**
+     * Retrieve the info for a registered client module.
+     *
+     * @param moduleSpecifier - Root-relative module path.
+     * @returns The module info, or `undefined` if not registered.
+     */
+    get(moduleSpecifier) {
+        return this._modules.get(moduleSpecifier);
+    }
+    /**
+     * Iterate over all registered client modules.
+     */
+    entries() {
+        return this._modules.entries();
+    }
+    /**
+     * Number of registered client modules.
+     */
+    get size() {
+        return this._modules.size;
+    }
+    /**
+     * Clear all registrations. Used between test runs.
+     *
+     * @internal
+     */
+    _clear() {
+        this._modules.clear();
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/compiler/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/compiler/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH;;;;;;;;;GASG;AACH,MAAM,OAAO,oBAAoB;IACd,QAAQ,GAAG,IAAI,GAAG,EAA4B,CAAC;IAEhE;;;;OAIG;IACH,QAAQ,CAAC,IAAsB;QAC7B,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC;YAC5C,gEAAgE;YAChE,wDAAwD;YACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,CAAE,CAAC;YAC1D,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,KAAK,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;gBACpD,OAAO,CAAC,IAAI,CACV,0BAA0B,IAAI,CAAC,eAAe,kBAAkB;oBAChE,2BAA2B,QAAQ,CAAC,OAAO,CAAC,MAAM,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK;oBAChF,wCAAwC,CACzC,CAAC;YACJ,CAAC;QACH,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;IAChD,CAAC;IAED;;;;OAIG;IACH,GAAG,CAAC,eAAuB;QACzB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,eAAuB;QACzB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,OAAO;QACL,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACH,MAAM;QACJ,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;CACF"}

package/dist/compiler/server-action-registry.d.ts

@@ -0,0 +1,57 @@
+/**
+ * In-memory registry of detected `'use server'` modules.
+ *
+ * Mirrors {@link ClientModuleRegistry} but tracks server action modules.
+ * Shared between builds via the same plugin instance.
+ *
+ * @module server-action-registry
+ * @internal
+ */
+import type { ServerActionInfo } from './types.js';
+/**
+ * Registry tracking all modules that declared `'use server'`.
+ *
+ * @remarks
+ * This map is populated during the `transform` hook and consumed during
+ * manifest emission. Each entry maps a root-relative module specifier
+ * to its server action info.
+ *
+ * @internal
+ */
+export declare class ServerActionRegistry {
+    private readonly _modules;
+    /**
+     * Register a server action module.
+     *
+     * @param info - The parsed server action module information.
+     */
+    register(info: ServerActionInfo): void;
+    /**
+     * Check if a module specifier has been registered as a server action module.
+     *
+     * @param moduleSpecifier - Root-relative module path.
+     */
+    has(moduleSpecifier: string): boolean;
+    /**
+     * Retrieve the info for a registered server action module.
+     *
+     * @param moduleSpecifier - Root-relative module path.
+     * @returns The module info, or `undefined` if not registered.
+     */
+    get(moduleSpecifier: string): ServerActionInfo | undefined;
+    /**
+     * Iterate over all registered server action modules.
+     */
+    entries(): IterableIterator<[string, ServerActionInfo]>;
+    /**
+     * Number of registered server action modules.
+     */
+    get size(): number;
+    /**
+     * Clear all registrations. Used between test runs.
+     *
+     * @internal
+     */
+    _clear(): void;
+}
+//# sourceMappingURL=server-action-registry.d.ts.map

package/dist/compiler/server-action-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-action-registry.d.ts","sourceRoot":"","sources":["../../src/compiler/server-action-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;;;;;;;;GASG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuC;IAEhE;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI;IActC;;;;OAIG;IACH,GAAG,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO;IAIrC;;;;;OAKG;IACH,GAAG,CAAC,eAAe,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAI1D;;OAEG;IACH,OAAO,IAAI,gBAAgB,CAAC,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAIvD;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;OAIG;IACH,MAAM,IAAI,IAAI;CAGf"}

package/dist/compiler/server-action-registry.js

@@ -0,0 +1,76 @@
+/**
+ * In-memory registry of detected `'use server'` modules.
+ *
+ * Mirrors {@link ClientModuleRegistry} but tracks server action modules.
+ * Shared between builds via the same plugin instance.
+ *
+ * @module server-action-registry
+ * @internal
+ */
+/**
+ * Registry tracking all modules that declared `'use server'`.
+ *
+ * @remarks
+ * This map is populated during the `transform` hook and consumed during
+ * manifest emission. Each entry maps a root-relative module specifier
+ * to its server action info.
+ *
+ * @internal
+ */
+export class ServerActionRegistry {
+    _modules = new Map();
+    /**
+     * Register a server action module.
+     *
+     * @param info - The parsed server action module information.
+     */
+    register(info) {
+        if (this._modules.has(info.moduleSpecifier)) {
+            const existing = this._modules.get(info.moduleSpecifier);
+            if (existing.exports.length !== info.exports.length) {
+                console.warn(`[juice] Server action module "${info.moduleSpecifier}" re-registered ` +
+                    `with different exports (${existing.exports.length} → ${info.exports.length}). ` +
+                    `This may indicate a stale build cache.`);
+            }
+        }
+        this._modules.set(info.moduleSpecifier, info);
+    }
+    /**
+     * Check if a module specifier has been registered as a server action module.
+     *
+     * @param moduleSpecifier - Root-relative module path.
+     */
+    has(moduleSpecifier) {
+        return this._modules.has(moduleSpecifier);
+    }
+    /**
+     * Retrieve the info for a registered server action module.
+     *
+     * @param moduleSpecifier - Root-relative module path.
+     * @returns The module info, or `undefined` if not registered.
+     */
+    get(moduleSpecifier) {
+        return this._modules.get(moduleSpecifier);
+    }
+    /**
+     * Iterate over all registered server action modules.
+     */
+    entries() {
+        return this._modules.entries();
+    }
+    /**
+     * Number of registered server action modules.
+     */
+    get size() {
+        return this._modules.size;
+    }
+    /**
+     * Clear all registrations. Used between test runs.
+     *
+     * @internal
+     */
+    _clear() {
+        this._modules.clear();
+    }
+}
+//# sourceMappingURL=server-action-registry.js.map

package/dist/compiler/server-action-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-action-registry.js","sourceRoot":"","sources":["../../src/compiler/server-action-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;;;;;;GASG;AACH,MAAM,OAAO,oBAAoB;IACd,QAAQ,GAAG,IAAI,GAAG,EAA4B,CAAC;IAEhE;;;;OAIG;IACH,QAAQ,CAAC,IAAsB;QAC7B,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC;YAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,CAAE,CAAC;YAC1D,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,KAAK,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;gBACpD,OAAO,CAAC,IAAI,CACV,iCAAiC,IAAI,CAAC,eAAe,kBAAkB;oBACvE,2BAA2B,QAAQ,CAAC,OAAO,CAAC,MAAM,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK;oBAChF,wCAAwC,CACzC,CAAC;YACJ,CAAC;QACH,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;IAChD,CAAC;IAED;;;;OAIG;IACH,GAAG,CAAC,eAAuB;QACzB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,eAAuB;QACzB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,OAAO;QACL,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACH,MAAM;QACJ,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;CACF"}

package/dist/compiler/server-actions.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Generates client-side proxy modules for `'use server'` actions.
+ *
+ * When a client component calls a server action, it needs a proxy that
+ * serializes the call into a Flight request. This module generates those
+ * proxies for the client build.
+ *
+ * In the **server build**, `'use server'` modules pass through unchanged —
+ * they are real functions that execute on the server.
+ *
+ * In the **client build**, `'use server'` modules are replaced with proxies
+ * that call `createServerReference()`, which the React Flight client uses
+ * to make server-side RPC calls.
+ *
+ * @module server-actions
+ * @internal
+ */
+import type { ExportRecord } from './types.js';
+/**
+ * Generate the client-side proxy source code for a `'use server'` module.
+ *
+ * Each export becomes a `createServerReference()` call that the React
+ * Flight client uses to invoke the corresponding server function.
+ *
+ * @param moduleSpecifier - Root-relative module path used as the stable ID
+ *                          (e.g., `'actions/auth.ts'`).
+ * @param exports - All exported server actions extracted from the module AST.
+ * @param callServerImport - The import path for the `callServer` function that
+ *                           handles the actual RPC transport. Defaults to the
+ *                           Juice runtime entrypoint.
+ * @returns A complete ES module source string for the client build.
+ *
+ * @example
+ * ```ts
+ * const source = _generateServerActionProxy('actions/auth.ts', [
+ *   { exportedName: 'login', localName: 'login' },
+ *   { exportedName: 'logout', localName: 'logout' },
+ * ]);
+ * // Returns:
+ * // import { createServerReference } from 'react-server-dom-webpack/client';
+ * // import { callServer } from '@cmj/juice/runtime';
+ * // export const login = createServerReference('actions/auth.ts#login', callServer);
+ * // export const logout = createServerReference('actions/auth.ts#logout', callServer);
+ * ```
+ *
+ * @internal
+ */
+export declare function _generateServerActionProxy(moduleSpecifier: string, exports: readonly ExportRecord[], callServerImport?: string): string;
+//# sourceMappingURL=server-actions.d.ts.map

package/dist/compiler/server-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-actions.d.ts","sourceRoot":"","sources":["../../src/compiler/server-actions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,0BAA0B,CACxC,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,SAAS,YAAY,EAAE,EAChC,gBAAgB,GAAE,MAA6B,GAC9C,MAAM,CA+BR"}

package/dist/compiler/server-actions.js

@@ -0,0 +1,89 @@
+/**
+ * Generates client-side proxy modules for `'use server'` actions.
+ *
+ * When a client component calls a server action, it needs a proxy that
+ * serializes the call into a Flight request. This module generates those
+ * proxies for the client build.
+ *
+ * In the **server build**, `'use server'` modules pass through unchanged —
+ * they are real functions that execute on the server.
+ *
+ * In the **client build**, `'use server'` modules are replaced with proxies
+ * that call `createServerReference()`, which the React Flight client uses
+ * to make server-side RPC calls.
+ *
+ * @module server-actions
+ * @internal
+ */
+/**
+ * Generate the client-side proxy source code for a `'use server'` module.
+ *
+ * Each export becomes a `createServerReference()` call that the React
+ * Flight client uses to invoke the corresponding server function.
+ *
+ * @param moduleSpecifier - Root-relative module path used as the stable ID
+ *                          (e.g., `'actions/auth.ts'`).
+ * @param exports - All exported server actions extracted from the module AST.
+ * @param callServerImport - The import path for the `callServer` function that
+ *                           handles the actual RPC transport. Defaults to the
+ *                           Juice runtime entrypoint.
+ * @returns A complete ES module source string for the client build.
+ *
+ * @example
+ * ```ts
+ * const source = _generateServerActionProxy('actions/auth.ts', [
+ *   { exportedName: 'login', localName: 'login' },
+ *   { exportedName: 'logout', localName: 'logout' },
+ * ]);
+ * // Returns:
+ * // import { createServerReference } from 'react-server-dom-webpack/client';
+ * // import { callServer } from '@cmj/juice/runtime';
+ * // export const login = createServerReference('actions/auth.ts#login', callServer);
+ * // export const logout = createServerReference('actions/auth.ts#logout', callServer);
+ * ```
+ *
+ * @internal
+ */
+export function _generateServerActionProxy(moduleSpecifier, exports, callServerImport = '@cmj/juice/runtime') {
+    if (exports.length === 0) {
+        throw new Error(`[juice/compiler] _generateServerActionProxy called with zero exports ` +
+            `for "${moduleSpecifier}". This is a compiler bug — the transform ` +
+            `hook should reject directive modules with no exports before reaching proxy generation.`);
+    }
+    const lines = [
+        `import { createServerReference } from 'react-server-dom-webpack/client';`,
+        `import { callServer } from ${JSON.stringify(callServerImport)};`,
+        '',
+    ];
+    for (const exp of exports) {
+        const actionId = `${moduleSpecifier}#${exp.exportedName}`;
+        const ref = `createServerReference(${JSON.stringify(actionId)}, callServer)`;
+        if (exp.exportedName === 'default') {
+            lines.push(`export default ${ref};`);
+        }
+        else if (_isValidIdentifier(exp.exportedName)) {
+            lines.push(`export const ${exp.exportedName} = ${ref};`);
+        }
+        else {
+            const safeName = `_${_safeVarName(exp.exportedName)}`;
+            lines.push(`const ${safeName} = ${ref};`);
+            lines.push(`export { ${safeName} as ${JSON.stringify(exp.exportedName)} };`);
+        }
+    }
+    return lines.join('\n') + '\n';
+}
+/**
+ * Check whether a string is a valid JS identifier.
+ * @internal
+ */
+function _isValidIdentifier(name) {
+    return /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(name);
+}
+/**
+ * Convert a non-identifier string to a safe variable name.
+ * @internal
+ */
+function _safeVarName(name) {
+    return name.replace(/[^a-zA-Z0-9_$]/g, '_');
+}
+//# sourceMappingURL=server-actions.js.map

package/dist/compiler/server-actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-actions.js","sourceRoot":"","sources":["../../src/compiler/server-actions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,0BAA0B,CACxC,eAAuB,EACvB,OAAgC,EAChC,mBAA2B,oBAAoB;IAE/C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,uEAAuE;YACvE,QAAQ,eAAe,4CAA4C;YACnE,wFAAwF,CACzF,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAa;QACtB,0EAA0E;QAC1E,8BAA8B,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,GAAG;QACjE,EAAE;KACH,CAAC;IAEF,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,GAAG,eAAe,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;QAC1D,MAAM,GAAG,GAAG,yBAAyB,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,eAAe,CAAC;QAE7E,IAAI,GAAG,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YACnC,KAAK,CAAC,IAAI,CAAC,kBAAkB,GAAG,GAAG,CAAC,CAAC;QACvC,CAAC;aAAM,IAAI,kBAAkB,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;YAChD,KAAK,CAAC,IAAI,CAAC,gBAAgB,GAAG,CAAC,YAAY,MAAM,GAAG,GAAG,CAAC,CAAC;QAC3D,CAAC;aAAM,CAAC;YACN,MAAM,QAAQ,GAAG,IAAI,YAAY,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;YACtD,KAAK,CAAC,IAAI,CAAC,SAAS,QAAQ,MAAM,GAAG,GAAG,CAAC,CAAC;YAC1C,KAAK,CAAC,IAAI,CAAC,YAAY,QAAQ,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AACjC,CAAC;AAED;;;GAGG;AACH,SAAS,kBAAkB,CAAC,IAAY;IACtC,OAAO,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjD,CAAC;AAED;;;GAGG;AACH,SAAS,YAAY,CAAC,IAAY;IAChC,OAAO,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;AAC9C,CAAC"}