@farm.js/plugin 0.1.0-beta.10 → 0.1.0-beta.100

package/dist/rsc/server-fn-transform.js

@@ -0,0 +1,152 @@
+const SERVER_FUNCTION_FACTORY_IMPORT_RE = /\bimport\s+(?:type\s+)?(?:[A-Za-z_$][\w$]*\s*,\s*)?(\{[^}]*\})\s+from\s*["']@farm.js\/core(?:\/(?:server-fn|server-query))?["']\s*;?/g;
+const EXPORT_SERVER_FUNCTION_FACTORY_RE = /\bexport\s+(?:const|let|var)\s+([A-Za-z_$][\w$]*)\s*=\s*([A-Za-z_$][\w$]*)\s*(?:<[^<>]*(?:<[^<>]*>[^<>]*)*>)?\s*\(/g;
+const MODULE_EXT_RE = /\.[cm]?[jt]sx?$/;
+const DECLARATION_RE = /(^|\n)\s*["']([^"']+)["']\s*;?/g;
+export function transformFarmServerFns(code, id) {
+    if (!isTransformableModule(id) ||
+        (!code.includes("createServerFn") && !code.includes("createServerQuery"))) {
+        return null;
+    }
+    const factoryNames = findServerFunctionFactoryImportNames(code);
+    if (factoryNames.size === 0)
+        return null;
+    const replacements = findServerFnExportReplacements(code, factoryNames);
+    if (replacements.length === 0)
+        return null;
+    if (hasModuleDirective(code, "use client")) {
+        throw new Error("createServerFn and createServerQuery exports must live in a server module. Move them out of the 'use client' file.");
+    }
+    let output = code;
+    for (const replacement of [...replacements].sort((a, b) => b.start - a.start)) {
+        output = output.slice(0, replacement.start) + replacement.code + output.slice(replacement.end);
+    }
+    if (!hasModuleDirective(output, "use server")) {
+        output = `"use server";\n${output}`;
+    }
+    return {
+        code: output,
+        exports: replacements.map((replacement) => replacement.exportName),
+    };
+}
+function isTransformableModule(id) {
+    const cleanId = id.split("?", 1)[0];
+    return MODULE_EXT_RE.test(cleanId) && !/\.d\.[cm]?ts$/.test(cleanId);
+}
+function findServerFunctionFactoryImportNames(code) {
+    const names = new Map();
+    for (const match of code.matchAll(SERVER_FUNCTION_FACTORY_IMPORT_RE)) {
+        const importClause = match[1] ?? "";
+        const namedStart = importClause.indexOf("{");
+        const namedEnd = importClause.lastIndexOf("}");
+        if (namedStart === -1 || namedEnd === -1 || namedEnd <= namedStart)
+            continue;
+        const namedImports = importClause.slice(namedStart + 1, namedEnd).split(",");
+        for (const specifier of namedImports) {
+            const normalized = specifier.trim().replace(/^type\s+/, "");
+            const specifierMatch = normalized.match(/^(createServerFn|createServerQuery)(?:\s+as\s+([A-Za-z_$][\w$]*))?$/);
+            if (specifierMatch) {
+                const factory = specifierMatch[1];
+                names.set(specifierMatch[2] ?? factory, factory === "createServerFn" ? "fn" : "query");
+            }
+        }
+    }
+    return names;
+}
+function findServerFnExportReplacements(code, factoryNames) {
+    const replacements = [];
+    for (const match of code.matchAll(EXPORT_SERVER_FUNCTION_FACTORY_RE)) {
+        const exportName = match[1];
+        const calleeName = match[2];
+        const factory = calleeName ? factoryNames.get(calleeName) : undefined;
+        if (!exportName || !calleeName || !factory)
+            continue;
+        const openParenIndex = (match.index ?? 0) + match[0].length - 1;
+        const callEnd = findMatchingParen(code, openParenIndex);
+        if (callEnd === -1)
+            continue;
+        let declarationEnd = callEnd + 1;
+        while (/\s/.test(code[declarationEnd] ?? ""))
+            declarationEnd++;
+        if (code[declarationEnd] === ";")
+            declarationEnd++;
+        const calleeIndex = code.indexOf(calleeName, match.index);
+        const callExpression = code.slice(calleeIndex, callEnd + 1);
+        const privateName = `$$farm_server_${factory}_${exportName}`;
+        replacements.push({
+            start: match.index ?? 0,
+            end: declarationEnd,
+            exportName,
+            code: `const ${privateName} = ${callExpression};\nexport async function ${exportName}(input) {\n  return ${privateName}(input);\n}`,
+        });
+    }
+    return replacements;
+}
+function hasModuleDirective(code, directive) {
+    for (const match of code.matchAll(DECLARATION_RE)) {
+        const value = match[2];
+        if (value === directive)
+            return true;
+        if (value !== "use strict" && value !== "use client" && value !== "use server")
+            return false;
+    }
+    return false;
+}
+function findMatchingParen(code, openParenIndex) {
+    let depth = 0;
+    let quote = null;
+    let lineComment = false;
+    let blockComment = false;
+    let escaped = false;
+    for (let index = openParenIndex; index < code.length; index++) {
+        const char = code[index];
+        const next = code[index + 1];
+        if (lineComment) {
+            if (char === "\n" || char === "\r")
+                lineComment = false;
+            continue;
+        }
+        if (blockComment) {
+            if (char === "*" && next === "/") {
+                blockComment = false;
+                index++;
+            }
+            continue;
+        }
+        if (quote) {
+            if (escaped) {
+                escaped = false;
+                continue;
+            }
+            if (char === "\\") {
+                escaped = true;
+                continue;
+            }
+            if (char === quote) {
+                quote = null;
+            }
+            continue;
+        }
+        if (char === "/" && next === "/") {
+            lineComment = true;
+            index++;
+            continue;
+        }
+        if (char === "/" && next === "*") {
+            blockComment = true;
+            index++;
+            continue;
+        }
+        if (char === "'" || char === '"' || char === "`") {
+            quote = char;
+            continue;
+        }
+        if (char === "(")
+            depth++;
+        if (char === ")") {
+            depth--;
+            if (depth === 0)
+                return index;
+        }
+    }
+    return -1;
+}

package/dist/rsc/test-fixture-dependencies.d.ts

@@ -0,0 +1,2 @@
+export declare function linkRscFixtureDependencies(root: string): void;
+//# sourceMappingURL=test-fixture-dependencies.d.ts.map

package/dist/rsc/test-fixture-dependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-fixture-dependencies.d.ts","sourceRoot":"","sources":["../../src/rsc/test-fixture-dependencies.ts"],"names":[],"mappings":"AAaA,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAY7D"}

package/dist/rsc/test-fixture-dependencies.js

@@ -0,0 +1,23 @@
+import { existsSync, mkdirSync, realpathSync, symlinkSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const RSC_FIXTURE_PACKAGES = [
+    "react",
+    "react-dom",
+    "react-server-dom-webpack",
+    "@vitejs/plugin-rsc",
+];
+const repositoryRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../../../..");
+export function linkRscFixtureDependencies(root) {
+    for (const packageName of RSC_FIXTURE_PACKAGES) {
+        const source = [
+            path.join(repositoryRoot, "node_modules", packageName),
+            path.join(repositoryRoot, "examples/rsc-demo/node_modules", packageName),
+        ].find((candidate) => existsSync(candidate));
+        if (!source)
+            throw new Error(`Missing RSC fixture dependency: ${packageName}`);
+        const target = path.join(root, "node_modules", packageName);
+        mkdirSync(path.dirname(target), { recursive: true });
+        symlinkSync(realpathSync(source), target, process.platform === "win32" ? "junction" : "dir");
+    }
+}

package/dist/rsc/types.d.ts

@@ -0,0 +1,132 @@
+import type { FarmServerActionsConfig, ResolvedFarmServerActionsConfig } from "@farm.js/core/server-action-security";
+/**
+ * Configuration options for the Farm.js RSC plugin.
+ */
+export interface FarmRscPluginOptions {
+    /** Security policy applied to server action requests. */
+    serverActions?: FarmServerActionsConfig;
+    /** Build identifier used to reject requests from stale browser deployments. */
+    deploymentId?: string;
+    /**
+     * Override the auto-generated virtual entries with custom files.
+     * If not provided, virtual entries are generated automatically based on
+     * the user's project structure.
+     */
+    entries?: {
+        /** Custom RSC environment entry file */
+        rsc?: string;
+        /** Custom SSR environment entry file */
+        ssr?: string;
+        /** Custom client environment entry file */
+        client?: string;
+    };
+    /**
+     * Enable encryption for server action bound arguments.
+     * This prevents exposing sensitive closure data in the client bundle.
+     * @default true
+     */
+    encryptActions?: boolean;
+    /**
+     * Subdirectory within srcDir containing route files.
+     * If empty, routes are discovered directly in srcDir.
+     * @default 'app'
+     */
+    routesDir?: string;
+    /**
+     * Custom CSS injection function.
+     * If not provided, uses import.meta.viteRsc.loadCss().
+     */
+    cssLoader?: string;
+    /**
+     * Enable verbose logging for debugging.
+     * @default false
+     */
+    debug?: boolean;
+}
+/**
+ * Internal context passed to entry generators.
+ * Contains resolved configuration values needed to generate entry files.
+ */
+export interface EntryContext {
+    /** User's source directory, e.g. 'src' */
+    srcDir: string;
+    /** Build output directory, e.g. 'dist' */
+    outDir: string;
+    /** Base URL path, e.g. '/' */
+    basePath: string;
+    /** Resolved same-origin mount for canonical /api routes. */
+    apiBasePath?: string;
+    /** Route files subdirectory within srcDir */
+    routesDir?: string;
+    /** Root-relative Vite URL for an existing global stylesheet. */
+    globalCssPath?: string;
+    /** Ordered route roots. Modules from later roots override matching earlier modules. */
+    routeRoots?: Array<{
+        name: string;
+        base: string;
+        glob: string;
+    }>;
+    /** Whether server actions are enabled */
+    actionsEnabled: boolean;
+    /** Normalized server action request security policy. */
+    serverActions: ResolvedFarmServerActionsConfig;
+    /** Resolved build identifier embedded into the server and browser entries. */
+    deploymentId: string;
+    /** Whether debug mode is enabled */
+    debug: boolean;
+    /** True only for the Vite serve command, never for a production build. */
+    development?: boolean;
+    /** Generated import/init fragments for `cache.client.adapter` persistence. */
+    clientCachePersistence?: {
+        imports: string;
+        init: string;
+    };
+}
+/**
+ * Matched route information from the file-based router.
+ */
+export interface MatchedRoute {
+    /** The page component's default export */
+    Page: React.ComponentType<any>;
+    /** The file pattern that matched, e.g. '/src/about/page.tsx' */
+    pattern: string;
+    /** Dynamic route parameters, e.g. { slug: 'my-post' } */
+    params: Record<string, string>;
+}
+/**
+ * RSC payload structure sent from server to client.
+ */
+export interface RscPayload {
+    /** The root React element tree (full document for SSR) */
+    root: React.ReactElement;
+    /** Content for div#root only (for client hydration to avoid double/repeated content) */
+    rootContent?: React.ReactElement;
+    /** Serializable document metadata used during client-side navigation. */
+    metadata?: {
+        title?: string;
+        description?: string;
+    };
+    /** Server action return value (if action was executed) */
+    returnValue?: {
+        ok: boolean;
+        data: unknown;
+    };
+    /** Form state for progressive enhancement */
+    formState?: unknown;
+}
+/**
+ * Vite RSC module augmentation for import.meta.
+ */
+declare global {
+    interface ImportMeta {
+        readonly viteRsc: {
+            /** Load CSS for server components */
+            loadCss(): React.ReactElement[];
+            /** Load a module from another environment */
+            loadModule<T = unknown>(env: string, entry: string): Promise<T>;
+            /** Load bootstrap script content for hydration */
+            loadBootstrapScriptContent(entry: string): Promise<string>;
+        };
+    }
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/rsc/types.js

@@ -0,0 +1 @@
+export {};

package/dist/rsc/vite-plugin-nitro.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Vite plugin for the Nitro RSC deployment pipeline. It forces per-environment
+ * output dirs (`Step 1`), captures the server (RSC) Rollup bundle in `writeBundle`
+ * (`Step 2`), and exposes `runNitroFromBuildApp()`, which builds Nitro from the
+ * captured outputs once all environments have finished writing.
+ *
+ * Farm's RSC builder invokes `runNitroFromBuildApp()` after every environment
+ * has written its output, so a single `vite build` still produces the
+ * deployment bundle.
+ *
+ * The plugin no longer triggers Nitro itself from a Rollup hook: the previous
+ * `buildEnd` trigger fired before its own environment's `prepareOutDir`/`writeBundle`,
+ * so on a rebuild it observed the previous build's stale outputs and built Nitro
+ * against them (and set `__FARM_NITRO_PLUGIN_RAN`, suppressing the proper run).
+ * Removing it keeps Nitro from running against stale artifacts while the post-app
+ * hook preserves the one-command build contract.
+ *
+ * - Step 1: Force per-environment output dirs to `.nitro/vite/dist/${name}` so Nitro can locate artifacts.
+ * - Step 2: Capture the server (RSC) Rollup bundle in `writeBundle`.
+ *
+ * @example
+ * ```ts
+ * import { defineConfig, nitro } from '@farm.js/plugin/rsc'
+ * export default defineConfig({
+ *   srcDir: 'src',
+ *   plugins: [rsc(), react(), nitro({ server: { environmentName: 'rsc' }, config: { preset: 'vercel' } })],
+ * })
+ * ```
+ */
+import type { Plugin } from "vite";
+export interface NitroPluginOptions {
+    server?: {
+        environmentName?: string;
+        /** Entry name in rollupOptions.input (default: 'index'). */
+        entryName?: string;
+    };
+    config?: {
+        preset?: string;
+    };
+    /** Base output dir when not using .nitro/vite/dist (fallback). */
+    outDir?: string;
+}
+export default function nitro(options?: NitroPluginOptions): Plugin;
+/** Called by RSC plugin buildApp (post) to run Nitro with the captured bundle. */
+export declare function runNitroFromBuildApp(): Promise<void>;
+//# sourceMappingURL=vite-plugin-nitro.d.ts.map

package/dist/rsc/vite-plugin-nitro.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite-plugin-nitro.d.ts","sourceRoot":"","sources":["../../src/rsc/vite-plugin-nitro.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAenC,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE;QACP,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,4DAA4D;QAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,MAAM,CAAC,EAAE;QACP,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAID,MAAM,CAAC,OAAO,UAAU,KAAK,CAAC,OAAO,GAAE,kBAAuB,GAAG,MAAM,CAqEtE;AAED,kFAAkF;AAClF,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAkC1D"}

package/dist/rsc/vite-plugin-nitro.js

@@ -0,0 +1,148 @@
+/**
+ * Vite plugin for the Nitro RSC deployment pipeline. It forces per-environment
+ * output dirs (`Step 1`), captures the server (RSC) Rollup bundle in `writeBundle`
+ * (`Step 2`), and exposes `runNitroFromBuildApp()`, which builds Nitro from the
+ * captured outputs once all environments have finished writing.
+ *
+ * Farm's RSC builder invokes `runNitroFromBuildApp()` after every environment
+ * has written its output, so a single `vite build` still produces the
+ * deployment bundle.
+ *
+ * The plugin no longer triggers Nitro itself from a Rollup hook: the previous
+ * `buildEnd` trigger fired before its own environment's `prepareOutDir`/`writeBundle`,
+ * so on a rebuild it observed the previous build's stale outputs and built Nitro
+ * against them (and set `__FARM_NITRO_PLUGIN_RAN`, suppressing the proper run).
+ * Removing it keeps Nitro from running against stale artifacts while the post-app
+ * hook preserves the one-command build contract.
+ *
+ * - Step 1: Force per-environment output dirs to `.nitro/vite/dist/${name}` so Nitro can locate artifacts.
+ * - Step 2: Capture the server (RSC) Rollup bundle in `writeBundle`.
+ *
+ * @example
+ * ```ts
+ * import { defineConfig, nitro } from '@farm.js/plugin/rsc'
+ * export default defineConfig({
+ *   srcDir: 'src',
+ *   plugins: [rsc(), react(), nitro({ server: { environmentName: 'rsc' }, config: { preset: 'vercel' } })],
+ * })
+ * ```
+ */
+import path from "path";
+import { buildRscNitro } from "./nitro-build.js";
+import { waitForRscOutputs } from "./nitro-build.js";
+import { resolveRscBuildOutputPath } from "./build-paths.js";
+const NITRO_VITE_DIST = ".nitro/vite/dist";
+export default function nitro(options = {}) {
+    const serverEnvName = options.server?.environmentName ?? "rsc";
+    const serverEntryName = options.server?.entryName ?? "index";
+    let resolvedRoot = process.cwd();
+    let rscOutDir = path.join(NITRO_VITE_DIST, "rsc");
+    let ssrOutDir = path.join(NITRO_VITE_DIST, "ssr");
+    let clientOutDir = path.join(NITRO_VITE_DIST, "client");
+    let clientAssetsDir = "assets";
+    return {
+        name: "vite-plugin-nitro",
+        apply: "build",
+        // Step 1: Force per-environment output dirs so Nitro can locate artifacts.
+        config() {
+            delete globalThis.__FARM_NITRO_SERVER_BUNDLE;
+            delete globalThis.__FARM_NITRO_PATHS;
+            delete globalThis.__FARM_NITRO_BUILD_PROMISE;
+            return {
+                environments: {
+                    rsc: { build: { outDir: path.join(NITRO_VITE_DIST, "rsc") } },
+                    ssr: { build: { outDir: path.join(NITRO_VITE_DIST, "ssr") } },
+                    client: { build: { outDir: path.join(NITRO_VITE_DIST, "client") } },
+                },
+            };
+        },
+        configResolved(config) {
+            resolvedRoot = path.resolve(config.root ?? process.cwd());
+            const envs = config.environments;
+            if (envs?.rsc?.build?.outDir && envs?.ssr?.build?.outDir && envs?.client?.build?.outDir) {
+                rscOutDir = envs.rsc.build.outDir;
+                ssrOutDir = envs.ssr.build.outDir;
+                clientOutDir = envs.client.build.outDir;
+            }
+            else {
+                const baseOutDir = options.outDir ?? "dist";
+                rscOutDir = path.join(baseOutDir, "rsc");
+                ssrOutDir = path.join(baseOutDir, "ssr");
+                clientOutDir = path.join(baseOutDir, "client");
+            }
+            const clientBuildAssetsDir = envs?.client?.build?.assetsDir;
+            clientAssetsDir =
+                typeof clientBuildAssetsDir === "string" && clientBuildAssetsDir
+                    ? clientBuildAssetsDir
+                    : "assets";
+        },
+        // Step 2: Capture the server (RSC) Rollup bundle when that environment writes.
+        writeBundle(_options, bundle) {
+            if (this.environment?.name === serverEnvName) {
+                delete globalThis.__FARM_NITRO_BUILD_PROMISE;
+                globalThis.__FARM_NITRO_SERVER_BUNDLE = bundle;
+                globalThis.__FARM_NITRO_PATHS = {
+                    root: resolvedRoot,
+                    rscOutDir,
+                    ssrOutDir,
+                    clientOutDir,
+                    serverEntryName,
+                    preset: options.config?.preset ?? process.env.NITRO_PRESET ?? "vercel",
+                    clientAssetsDir,
+                };
+            }
+        },
+    };
+}
+/** Called by RSC plugin buildApp (post) to run Nitro with the captured bundle. */
+export async function runNitroFromBuildApp() {
+    const paths = globalThis.__FARM_NITRO_PATHS;
+    const bundle = globalThis.__FARM_NITRO_SERVER_BUNDLE;
+    if (!paths)
+        return;
+    const existing = globalThis.__FARM_NITRO_BUILD_PROMISE;
+    if (existing) {
+        await existing;
+        return;
+    }
+    const run = runCapturedNitroBuild(paths, bundle);
+    globalThis.__FARM_NITRO_BUILD_PROMISE = run;
+    try {
+        await run;
+    }
+    catch (error) {
+        if (globalThis.__FARM_NITRO_BUILD_PROMISE === run) {
+            delete globalThis.__FARM_NITRO_BUILD_PROMISE;
+        }
+        throw error;
+    }
+}
+async function runCapturedNitroBuild(paths, bundle) {
+    const root = paths.root;
+    const preset = paths.preset;
+    const baseOutDir = path.dirname(paths.rscOutDir);
+    await waitForRscOutputs(root, baseOutDir, { timeoutMs: 25_000 });
+    let rendererPath = resolveRscBuildOutputPath(root, paths.rscOutDir, "index.js");
+    if (bundle) {
+        const serverEntryChunks = [];
+        for (const chunk of Object.values(bundle)) {
+            if (chunk.type === "chunk" && chunk.isEntry && chunk.fileName) {
+                serverEntryChunks.push(chunk);
+            }
+        }
+        const selected = paths.serverEntryName
+            ? serverEntryChunks.find((c) => (c.name ?? c.fileName) === paths.serverEntryName)
+            : serverEntryChunks[0];
+        if (selected?.fileName) {
+            rendererPath = resolveRscBuildOutputPath(root, paths.rscOutDir, selected.fileName);
+        }
+    }
+    await buildRscNitro({
+        root,
+        rendererPath,
+        publicDir: resolveRscBuildOutputPath(root, paths.clientOutDir),
+        ssrPath: resolveRscBuildOutputPath(root, paths.ssrOutDir, "index.js"),
+        assetsDir: paths.clientAssetsDir ?? "assets",
+        preset,
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farm.js/plugin",
-  "version": "0.1.0-beta.10",
+  "version": "0.1.0-beta.100",
   "description": "Official plugins for Farm.js framework",
   "license": "MIT",
   "author": "Farm.js Team",
@@ -61,7 +61,7 @@
     "nitro": "3.0.1-alpha.0",
     "picocolors": "^1.0.0",
     "rsc-html-stream": "^0.0.4",
-    "@farm.js/core": "0.1.0-beta.10"
+    "@farm.js/core": "0.1.0-beta.100"
   },
   "devDependencies": {
     "@types/node": "^20.19.21",
@@ -74,7 +74,7 @@
     "tsdown": "^0.15.7",
     "typescript": "^5.5.3",
     "vite": "^6.0.0",
-    "vitest": "^1.1.0"
+    "vitest": "^3.2.7"
   },
   "peerDependencies": {
     "@vitejs/plugin-rsc": "0.5.32",
@@ -82,7 +82,7 @@
     "react-dom": "19.2.8",
     "react-server-dom-webpack": "19.2.8",
     "vite": ">=6.0.0",
-    "@farm.js/core": "0.1.0-beta.10"
+    "@farm.js/core": "0.1.0-beta.100"
   },
   "peerDependenciesMeta": {
     "@vitejs/plugin-rsc": {