@fluxfast/vite 0.0.0-oidc-bootstrap.0

package/dist/esm/cli.js

@@ -0,0 +1,135 @@
+import { buildFluxViteApp } from "./build.js";
+import { createFluxViteServer } from "./server.js";
+import path from "node:path";
+const USAGE = `Usage:
+  fluxfast-vite init [--dry-run] [--yes] [--force]
+  fluxfast-vite init --check
+  fluxfast-vite generate [--check] [--schema-file PATH]
+  fluxfast-vite doctor
+  fluxfast-vite dev [--config PATH] [--hostname HOST] [--port PORT]
+  fluxfast-vite build [--config PATH]
+  fluxfast-vite start [--hostname HOST] [--port PORT]
+Build and serve use the configured fluxfast() Vite plugin; start reads built artifacts only.`;
+async function runSetup(command, args, io) {
+    const allowed = command === "init" ? ["--dry-run", "--yes", "--force", "--check"] : command === "generate" ? ["--check", "--schema-file"] : [];
+    const seen = new Set();
+    let schemaFile;
+    for (let index = 0; index < args.length; index++) {
+        const flag = args[index];
+        if (!allowed.includes(flag) || seen.has(flag)) {
+            io.stderr(USAGE);
+            return 2;
+        }
+        seen.add(flag);
+        if (flag === "--schema-file") {
+            schemaFile = args[++index];
+            if (!schemaFile || schemaFile.startsWith("--")) {
+                io.stderr(USAGE);
+                return 2;
+            }
+        }
+    }
+    if (command === "init" && seen.has("--check") && args.length !== 1) {
+        io.stderr(USAGE);
+        return 2;
+    }
+    try {
+        const { projectAt, relativeFile, validatePackages } = await import("./project.js");
+        const { planSetup, applySetup, checkSetup } = await import("./setup.js");
+        const { generateProject } = await import("./generation.js");
+        const project = projectAt(io.cwd);
+        validatePackages(project);
+        if (command === "generate") {
+            const result = generateProject(project, seen.has("--check"), schemaFile);
+            io.stdout(result.current ? (seen.has("--check") ? "Generated FluxFast files are current." : "Generated FluxFast registry/contracts.") : "Generated FluxFast files are missing or stale; rerun generation without --check.");
+            return result.current ? 0 : 1;
+        }
+        if (command === "doctor" || seen.has("--check")) {
+            const problems = [...checkSetup(project)];
+            if (!generateProject(project, true).current)
+                problems.push("Generated FluxFast files are missing or stale");
+            problems.forEach(problem => io.stderr(problem));
+            if (!problems.length)
+                io.stdout("FluxFast React/Vite setup and generated files are current. Production/runtime diagnostics remain separate.");
+            return problems.length ? 1 : 0;
+        }
+        const plan = planSetup(project, seen.has("--force"));
+        if (seen.has("--dry-run")) {
+            plan.changes.forEach(change => io.stdout("Would update " + relativeFile(project, change.file)));
+            io.stdout("Would generate the React registry/contracts. No files were changed.");
+            return 0;
+        }
+        applySetup(plan);
+        io.stdout("FluxFast React/Vite initialized. Existing SPA entries, configuration and scripts were preserved.");
+        io.stdout("Use npm run fluxfast:dev, fluxfast:build and fluxfast:start (or the project's package manager).");
+        return 0;
+    }
+    catch (error) {
+        io.stderr(error instanceof Error ? error.message : "FluxFast setup failed");
+        return 1;
+    }
+}
+export async function runViteCli(args, io = { cwd: process.cwd(), stdout: console.log, stderr: console.error }) {
+    if (!args.length || args.length === 1 && ["--help", "-h"].includes(args[0])) {
+        io.stdout(USAGE);
+        return 0;
+    }
+    const [command, ...flags] = args;
+    if (["init", "generate", "doctor"].includes(command))
+        return runSetup(command, flags, io);
+    if (!["dev", "build", "start"].includes(command)) {
+        io.stderr(USAGE);
+        return 2;
+    }
+    let host = "127.0.0.1";
+    let port = 3000;
+    let configFile;
+    const seen = new Set();
+    for (let index = 0; index < flags.length; index += 1) {
+        const flag = flags[index];
+        const value = flags[++index];
+        const allowed = command === "build" ? ["--config"] : command === "start" ? ["--hostname", "--port"] : ["--config", "--hostname", "--port"];
+        if (!allowed.includes(flag) || seen.has(flag) || !value || value.startsWith("--")) {
+            io.stderr(USAGE);
+            return 2;
+        }
+        seen.add(flag);
+        if (flag === "--config")
+            configFile = path.resolve(io.cwd, value);
+        else if (flag === "--hostname")
+            host = value;
+        else if (/^\d+$/.test(value) && Number(value) >= 1 && Number(value) <= 65535)
+            port = Number(value);
+        else {
+            io.stderr(USAGE);
+            return 2;
+        }
+    }
+    try {
+        if (command === "build") {
+            await buildFluxViteApp({ root: io.cwd, configFile });
+            return 0;
+        }
+        const server = await createFluxViteServer({ root: io.cwd, configFile, mode: command === "start" ? "production" : "development", host, port });
+        io.stdout(`FluxFast ${command === "start" ? "production" : "development"} host listening on ${server.url}`);
+        let stopping = false;
+        const stop = () => {
+            if (stopping)
+                return;
+            stopping = true;
+            void server.close().then(() => {
+                process.removeListener("SIGINT", stop);
+                process.removeListener("SIGTERM", stop);
+                process.exitCode = 0;
+            }, () => { process.exitCode = 1; });
+        };
+        process.on("SIGINT", stop);
+        process.on("SIGTERM", stop);
+        return 0;
+    }
+    catch {
+        io.stderr("FluxFast host failed. Check the application, fluxfast() configuration, built artifacts, and private backend configuration.");
+        return 1;
+    }
+}
+//# sourceMappingURL=cli.js.map

package/dist/esm/cli.js.map

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

package/dist/esm/generation.js

@@ -0,0 +1,30 @@
+import fs from "node:fs";
+import path from "node:path";
+import { checkFluxFastProject, createPagesRegistrySnapshot, generateFluxFastProject } from "@fluxfast/codegen";
+import { assertSafePath, GENERATED_ARTIFACTS } from "./project.js";
+export function generationOptions(project, schemaFile) {
+    assertSafePath(project.root, project.pages);
+    assertSafePath(project.root, project.registry);
+    // The existing schema is also an input; do not read it through a symlink.
+    for (const name of GENERATED_ARTIFACTS)
+        assertSafePath(project.root, path.join(project.generated, name));
+    return {
+        registry: createPagesRegistrySnapshot({ pagesDir: project.pages, outputFile: project.registry,
+            target: { runtimeImport: "@fluxfast/react", rootExport: "FluxRoot", applicationPropsExport: "FluxApplicationProps", clientDirective: false } }),
+        generatedDir: project.generated, log: false,
+        ...(schemaFile === undefined ? {} : { schemaContent: fs.readFileSync(path.resolve(project.root, schemaFile), "utf8") }),
+    };
+}
+export function generateProject(project, check, schemaFile) {
+    const options = generationOptions(project, schemaFile);
+    if (check) {
+        const result = checkFluxFastProject(options);
+        return { current: result.current, files: result.staleFiles };
+    }
+    return { current: true, files: generateFluxFastProject(options).generatedFiles };
+}
+/** Compile existing contracts before initialization can write any scaffold. */
+export function validateGeneration(project) {
+    checkFluxFastProject(generationOptions(project));
+}
+//# sourceMappingURL=generation.js.map

package/dist/esm/generation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generation.js","sourceRoot":"","sources":["../../src/generation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC/G,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAwB,MAAM,cAAc,CAAC;AAEzF,MAAM,UAAU,iBAAiB,CAAC,OAAwB,EAAE,UAAmB;IAC7E,cAAc,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAC5C,cAAc,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/C,0EAA0E;IAC1E,KAAK,MAAM,IAAI,IAAI,mBAAmB;QAAE,cAAc,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC;IACzG,OAAO;QACL,QAAQ,EAAE,2BAA2B,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,QAAQ;YAC3F,MAAM,EAAE,EAAE,aAAa,EAAE,iBAAiB,EAAE,UAAU,EAAE,UAAU,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,eAAe,EAAE,KAAK,EAAE,EAAE,CAAC;QACjJ,YAAY,EAAE,OAAO,CAAC,SAAS,EAAE,GAAG,EAAE,KAAK;QAC3C,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC;KACxH,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAwB,EAAE,KAAc,EAAE,UAAmB;IAC3F,MAAM,OAAO,GAAG,iBAAiB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACvD,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,MAAM,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;QAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;IAC/D,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,uBAAuB,CAAC,OAAO,CAAC,CAAC,cAAc,EAAE,CAAC;AACnF,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,kBAAkB,CAAC,OAAwB;IACzD,oBAAoB,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC;AACnD,CAAC"}

package/dist/esm/health.js

@@ -0,0 +1,55 @@
+/** Host-owned minimal probes. No authentication, ports, paths, or upstream text. */
+export function healthProbe(request) {
+    const path = new URL(request.url).pathname.replace(/\/$/, "");
+    return /^\/(?:_?fluxfast)\/(healthz|readyz)$/.exec(path)?.[1];
+}
+function statusResponse(status, code, head) {
+    return new Response(head ? null : JSON.stringify({ status }), {
+        status: code, headers: { "content-type": "application/json; charset=utf-8", "cache-control": "no-store" },
+    });
+}
+export async function serveHealth(request, backendUrl, stopping) {
+    const probe = healthProbe(request);
+    const head = request.method === "HEAD";
+    if (request.method !== "GET" && !head)
+        return new Response(null, { status: 405, headers: { allow: "GET, HEAD" } });
+    if (!probe || stopping)
+        return statusResponse("not_ready", 503, head);
+    const signal = AbortSignal.any([request.signal, AbortSignal.timeout(3_000)]);
+    try {
+        const target = backendUrl.replace(/\/$/, "") + "/_fluxfast/" + probe;
+        const upstream = await fetch(target, { headers: { accept: "application/json" }, redirect: "manual", cache: "no-store", signal });
+        const reader = upstream.body?.getReader();
+        if (!reader)
+            return statusResponse("not_ready", 503, head);
+        const chunks = [];
+        let bytes = 0;
+        try {
+            while (true) {
+                const { value, done } = await reader.read();
+                if (done)
+                    break;
+                bytes += value.byteLength;
+                if (bytes > 4_096) {
+                    void reader.cancel().catch(() => undefined);
+                    return statusResponse("not_ready", 503, head);
+                }
+                chunks.push(value);
+            }
+        }
+        finally {
+            reader.releaseLock();
+        }
+        const payload = JSON.parse(Buffer.concat(chunks).toString("utf8"));
+        const status = payload && typeof payload === "object" && "status" in payload ? payload.status : undefined;
+        if (probe === "healthz" && upstream.status === 200 && status === "ok")
+            return statusResponse("ok", 200, head);
+        if (probe === "readyz" && upstream.status === 200 && status === "ready")
+            return statusResponse("ready", 200, head);
+        return statusResponse("not_ready", 503, head);
+    }
+    catch {
+        return statusResponse("not_ready", 503, head);
+    }
+}
+//# sourceMappingURL=health.js.map

package/dist/esm/health.js.map

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

package/dist/esm/index.js

@@ -0,0 +1,3 @@
+export { fluxfast } from "./plugin.js";
+export { buildFluxViteApp } from "./build.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/esm/options.js

@@ -0,0 +1,58 @@
+import path from "node:path";
+import { createFluxReactHandler } from "@fluxfast/react/server";
+export const CLIENT_ENTRY = "/@fluxfast/client";
+export const SERVER_ENTRY = "virtual:fluxfast/server";
+export const CLIENT_ID = "\0fluxfast:client";
+export const SERVER_ID = "\0fluxfast:server";
+export const BUILD_DIRECTORY = "dist/fluxfast";
+export function resolveOptions(root, options) {
+    const application = options.application ?? "src/.fluxfast/pages.generated.ts";
+    const applicationExport = options.applicationExport ?? "FluxApplication";
+    const template = options.template ?? "fluxfast.html";
+    if (typeof application !== "string" || !application || typeof template !== "string" || !template ||
+        !/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(applicationExport)) {
+        throw new TypeError("FluxFast requires an application module, template, and valid export identifier");
+    }
+    if (options.diagnostics !== undefined && typeof options.diagnostics !== "boolean") {
+        throw new TypeError("FluxFast diagnostics must be boolean");
+    }
+    if (options.forwardHeaders !== undefined && (!Array.isArray(options.forwardHeaders) || options.forwardHeaders.some(name => typeof name !== "string"))) {
+        throw new TypeError("FluxFast forwardHeaders must be an array of header names");
+    }
+    // Reuse the SSR boundary's runtime validation without fetching or rendering.
+    // Configuration failure should precede build output replacement/listening.
+    createFluxReactHandler({ backendUrl: "http://fluxfast.invalid", render: async () => "", template: "",
+        ...(options.cache === undefined ? {} : { cache: options.cache }),
+        ...(options.timeoutMs === undefined ? {} : { timeoutMs: options.timeoutMs }),
+    });
+    const templatePath = path.resolve(root, template);
+    const relativeTemplate = path.relative(root, templatePath);
+    if (!relativeTemplate || relativeTemplate.startsWith("..") || path.isAbsolute(relativeTemplate) || !/\.html?$/i.test(template)) {
+        throw new TypeError("FluxFast template must be an HTML file inside the frontend root");
+    }
+    return {
+        application: path.resolve(root, application).replace(/\\/g, "/"),
+        applicationExport,
+        template: templatePath,
+        diagnostics: options.diagnostics === true,
+        settings: {
+            ...(options.forwardHeaders === undefined ? {} : { forwardHeaders: options.forwardHeaders }),
+            ...(options.cache === undefined ? {} : { cache: options.cache }),
+            ...(options.timeoutMs === undefined ? {} : { timeoutMs: options.timeoutMs }),
+        },
+    };
+}
+/** Internal plugin metadata, not a separate consumer configuration API. */
+export function configuredFluxOptions(config) {
+    const plugins = config.plugins.filter(plugin => plugin.name === "fluxfast");
+    const value = plugins.length === 1 ? plugins[0].api?.fluxfast : undefined;
+    if (!value)
+        throw new Error("Configure exactly one fluxfast() plugin in vite.config before building or serving");
+    return value;
+}
+export function safeAssetName(name) {
+    return !name.startsWith("/") && !/[\\\x00-\x1f\x7f%?#]/.test(name) &&
+        name.split("/").every(part => part.length > 0 && !part.startsWith(".")) &&
+        !/\.(?:html?|map)$/i.test(name);
+}
+//# sourceMappingURL=options.js.map

package/dist/esm/options.js.map

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

package/dist/esm/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/dist/esm/plugin.js

@@ -0,0 +1,46 @@
+import { CLIENT_ENTRY, CLIENT_ID, SERVER_ENTRY, SERVER_ID, resolveOptions } from "./options.js";
+/** Vite module/build integration; application URLs continue to belong to FastAPI. */
+export function fluxfast(options = {}) {
+    let configured;
+    const plugin = {
+        name: "fluxfast",
+        config(config) {
+            if (config.base !== undefined && config.base !== "/")
+                throw new Error("FluxFast Vite currently requires base '/' for same-origin application routing");
+            return {
+                appType: "custom", esbuild: { jsx: "automatic" }, resolve: { dedupe: ["react", "react-dom"] },
+                // The document uses a virtual client entry rather than a SPA script.
+                // Scan the real application (including lazy registry pages) up front so
+                // a first navigation cannot trigger dependency discovery and a reload.
+                optimizeDeps: {
+                    entries: [options.application ?? "src/.fluxfast/pages.generated.ts"],
+                    include: ["@fluxfast/react/client", "react", "react-dom", "react-dom/client", "react/jsx-runtime", "react/jsx-dev-runtime"],
+                },
+            };
+        },
+        configResolved(config) {
+            if (config.base !== "/")
+                throw new Error("FluxFast Vite currently requires base '/' for same-origin application routing");
+            configured = resolveOptions(config.root, options);
+            plugin.api = { fluxfast: configured };
+        },
+        resolveId(id) {
+            if (id === CLIENT_ENTRY || id === CLIENT_ID)
+                return CLIENT_ID;
+            if (id === SERVER_ENTRY || id === SERVER_ID)
+                return SERVER_ID;
+        },
+        load(id) {
+            if (id !== CLIENT_ID && id !== SERVER_ID)
+                return;
+            const application = JSON.stringify(configured.application);
+            const component = configured.applicationExport;
+            if (id === CLIENT_ID) {
+                return `import { ${component} as Application } from ${application};\nimport { hydrateFluxApplication } from "@fluxfast/react/client";\nhydrateFluxApplication(Application);\n`;
+            }
+            return `import { ${component} as Application } from ${application};\nimport { renderFluxApplication } from "@fluxfast/react/server";\nexport const settings = ${JSON.stringify(configured.settings)};\nexport function render(props, options) { return renderFluxApplication(Application, props, options); }\n`;
+        },
+    };
+    return plugin;
+}
+//# sourceMappingURL=plugin.js.map

package/dist/esm/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../src/plugin.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,cAAc,EAAkD,MAAM,cAAc,CAAC;AAEhJ,qFAAqF;AACrF,MAAM,UAAU,QAAQ,CAAC,OAAO,GAAoB,EAAE;IACpD,IAAI,UAA+B,CAAC;IACpC,MAAM,MAAM,GAAW;QACrB,IAAI,EAAE,UAAU;QAChB,MAAM,CAAC,MAAM;YACX,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,KAAK,GAAG;gBAAE,MAAM,IAAI,KAAK,CAAC,+EAA+E,CAAC,CAAC;YACvJ,OAAO;gBACL,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE;gBAC7F,qEAAqE;gBACrE,wEAAwE;gBACxE,uEAAuE;gBACvE,YAAY,EAAE;oBACZ,OAAO,EAAE,CAAC,OAAO,CAAC,WAAW,IAAI,kCAAkC,CAAC;oBACpE,OAAO,EAAE,CAAC,wBAAwB,EAAE,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,uBAAuB,CAAC;iBAC5H;aACF,CAAC;QACJ,CAAC;QACD,cAAc,CAAC,MAAM;YACnB,IAAI,MAAM,CAAC,IAAI,KAAK,GAAG;gBAAE,MAAM,IAAI,KAAK,CAAC,+EAA+E,CAAC,CAAC;YAC1H,UAAU,GAAG,cAAc,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAClD,MAAM,CAAC,GAAG,GAAG,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;QACxC,CAAC;QACD,SAAS,CAAC,EAAE;YACV,IAAI,EAAE,KAAK,YAAY,IAAI,EAAE,KAAK,SAAS;gBAAE,OAAO,SAAS,CAAC;YAC9D,IAAI,EAAE,KAAK,YAAY,IAAI,EAAE,KAAK,SAAS;gBAAE,OAAO,SAAS,CAAC;QAChE,CAAC;QACD,IAAI,CAAC,EAAE;YACL,IAAI,EAAE,KAAK,SAAS,IAAI,EAAE,KAAK,SAAS;gBAAE,OAAO;YACjD,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;YAC3D,MAAM,SAAS,GAAG,UAAU,CAAC,iBAAiB,CAAC;YAC/C,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;gBACrB,OAAO,YAAY,SAAS,0BAA0B,WAAW,6GAA6G,CAAC;YACjL,CAAC;YACD,OAAO,YAAY,SAAS,0BAA0B,WAAW,+FAA+F,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAC,4GAA4G,CAAC;QAClT,CAAC;KACF,CAAC;IACF,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/esm/project.js

@@ -0,0 +1,88 @@
+import fs from "node:fs";
+import path from "node:path";
+export const HOST_CONFIG = "fluxfast.vite.config.mjs";
+export const HOST_TEMPLATE = "fluxfast.html";
+export const GENERATED_ARTIFACTS = Object.freeze([
+    "pages.generated.ts", "schema.generated.json", "types.generated.ts",
+    "validators.generated.ts", "routes.generated.ts", "mutations.generated.ts",
+]);
+export const HOST_SCRIPTS = Object.freeze({
+    "fluxfast:dev": `fluxfast-vite dev --config ${HOST_CONFIG}`,
+    "fluxfast:build": `fluxfast-vite build --config ${HOST_CONFIG}`,
+    "fluxfast:start": "fluxfast-vite start",
+});
+export function projectAt(start) {
+    let root = path.resolve(start);
+    while (!fs.existsSync(path.join(root, "package.json"))) {
+        const parent = path.dirname(root);
+        if (parent === root)
+            throw new Error("No frontend package.json found in this directory or its parents");
+        root = parent;
+    }
+    assertSafePath(root, path.join(root, "package.json"));
+    const manifestContent = fs.readFileSync(path.join(root, "package.json"), "utf8");
+    let manifest;
+    try {
+        manifest = JSON.parse(manifestContent);
+    }
+    catch {
+        throw new Error("Frontend package.json must contain valid JSON");
+    }
+    if (!manifest || typeof manifest !== "object" || Array.isArray(manifest))
+        throw new Error("Frontend package.json must contain an object");
+    const source = fs.existsSync(path.join(root, "src")) ? path.join(root, "src") : root;
+    assertSafePath(root, source);
+    if (!fs.statSync(source).isDirectory())
+        throw new Error("Frontend src must be a directory when present");
+    const generated = path.join(source, ".fluxfast");
+    return { root, source, pages: path.join(source, "flux-pages"), generated,
+        registry: path.join(generated, "pages.generated.ts"), manifest: manifest, manifestContent };
+}
+/** No scaffold or generated artifact may traverse a symlink, even an internal one. */
+export function assertSafePath(root, target) {
+    const relative = path.relative(root, target);
+    if (relative === ".." || relative.startsWith(".." + path.sep) || path.isAbsolute(relative))
+        throw new Error("FluxFast output must stay inside the frontend root");
+    let current = root;
+    for (const segment of ["", ...relative.split(path.sep).filter(Boolean)]) {
+        current = path.join(current, segment);
+        try {
+            if (fs.lstatSync(current).isSymbolicLink())
+                throw new Error("FluxFast refuses to follow a scaffold or generated-output symlink");
+        }
+        catch (error) {
+            if (error.code === "ENOENT")
+                break;
+            throw error;
+        }
+    }
+}
+export function validatePackages(project) {
+    const declarations = {};
+    for (const section of ["dependencies", "devDependencies"]) {
+        const value = project.manifest[section] ?? {};
+        if (!value || typeof value !== "object" || Array.isArray(value) ||
+            Object.values(value).some(version => typeof version !== "string" || !version.trim()))
+            throw new Error("Package dependencies must be objects of non-empty version strings");
+        Object.assign(declarations, value);
+    }
+    if (declarations["@fluxfast/next"])
+        throw new Error("Initialize a separate React/Vite frontend rather than mixing Next and Vite adapters");
+    for (const name of ["@fluxfast/vite", "react", "react-dom", "vite"]) {
+        if (!declarations[name])
+            throw new Error(`Declare and install ${name} before initializing the React/Vite frontend; no packages are downloaded by this command`);
+    }
+}
+export function sourceViteConfig(project) {
+    const candidates = ["ts", "mts", "cts", "js", "mjs", "cjs"].map(extension => "vite.config." + extension)
+        .filter(name => fs.existsSync(path.join(project.root, name)));
+    if (candidates.length > 1)
+        throw new Error("Multiple source Vite configs found; keep one authoritative vite.config file before initializing");
+    if (candidates[0])
+        assertSafePath(project.root, path.join(project.root, candidates[0]));
+    return candidates[0];
+}
+export function relativeFile(project, target) {
+    return path.relative(project.root, target).replace(/\\/g, "/");
+}
+//# sourceMappingURL=project.js.map

package/dist/esm/project.js.map

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