@fluxfast/vite 0.0.0-oidc-bootstrap.0

package/dist/cli.js

@@ -0,0 +1,141 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runViteCli = runViteCli;
+const build_js_1 = require("./build.js");
+const server_js_1 = require("./server.js");
+const node_path_1 = __importDefault(require("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;
+    }
+}
+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 = node_path_1.default.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 (0, build_js_1.buildFluxViteApp)({ root: io.cwd, configFile });
+            return 0;
+        }
+        const server = await (0, server_js_1.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/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/agent-knowledge.js

@@ -0,0 +1,152 @@
+import { relativeFile, HOST_CONFIG } from "./project.js";
+export const KNOWLEDGE_MARKER = "<!-- GENERATED BY FLUXFAST. Run `fluxfast-vite init` to refresh this file. -->";
+const START = "<!-- fluxfast-agent-knowledge:start -->";
+const END = "<!-- fluxfast-agent-knowledge:end -->";
+/** Replace only the one bounded managed block; preserve surrounding text and CRLF. */
+export function mergeAgentBlock(existing, knowledge) {
+    const newline = existing.includes("\r\n") ? "\r\n" : "\n";
+    const block = [START, "## FluxFast", "", "@" + knowledge, "",
+        `Read [the generated FluxFast knowledge](${knowledge}) before changing FluxFast application code or configuration.`, END].join(newline);
+    const start = existing.indexOf(START);
+    const end = existing.indexOf(END);
+    if ((start === -1) !== (end === -1) || end < start ||
+        start !== -1 && (existing.indexOf(START, start + 1) !== -1 || existing.indexOf(END, end + 1) !== -1))
+        throw new Error("Malformed or duplicate FluxFast agent blocks; repair the markers without deleting user instructions");
+    if (start === -1)
+        return existing + (existing ? (existing.endsWith("\n") ? newline : newline + newline) : "") + block + newline;
+    return existing.slice(0, start) + block + existing.slice(end + END.length);
+}
+export function renderKnowledge(project) {
+    const pages = relativeFile(project, project.pages);
+    const generated = relativeFile(project, project.generated);
+    return `${KNOWLEDGE_MARKER}
+
+# FluxFast React/Vite agent knowledge
+
+This is generated integration knowledge, not user instructions. Do not edit this
+file; refresh it with the installed \`fluxfast-vite init\` command. Resolve exact
+package versions from the lockfile, not framework or protocol version guesses.
+
+## Architecture and ownership
+
+- FastAPI owns application URLs, authentication, authorization, input validation,
+  named resources, mutations, redirects and selected component identifiers.
+- \`@fluxfast/core\` owns the framework-neutral stores, router, reconciliation,
+  deferred/live lifecycle and protocol validation. Never put framework imports in Core.
+- \`@fluxfast/react\` provides hooks, registry rendering, SSR and exact-envelope
+  hydration. \`@fluxfast/vite\` provides compilation, assets and the Node host.
+- The allowlist in \`${generated}/pages.generated.ts\` selects modules under
+  \`${pages}/\`. Never dynamically import arbitrary backend component strings.
+- Python package, JavaScript packages, \`fluxfast/1\` and \`fluxfast-schema/2\`
+  are separate versioned contracts; do not infer a protocol version from a package.
+
+## Files and commands
+
+The dedicated host config is \`${HOST_CONFIG}\`, extending an existing Vite
+config when present. It is evaluated during development/build, never production
+startup. \`fluxfast.html\` contains exactly one SSR marker inside
+\`#fluxfast-root\` and one payload marker outside it. Preserve both.
+
+Existing SPA entry files and scripts are user-owned. Use the scoped host scripts:
+
+\`\`\`sh
+npm run fluxfast:dev
+npm run fluxfast:build
+npm run fluxfast:start
+npm exec --no -- fluxfast-vite generate
+npm exec --no -- fluxfast-vite generate --check
+npm exec --no -- fluxfast-vite init --check
+npm exec --no -- fluxfast-vite doctor
+\`\`\`
+
+With matching Python and JavaScript packages, run the whole application from its
+backend project directory. Python detects \`@fluxfast/vite\` and selects the
+scoped scripts without changing your SPA scripts:
+
+\`\`\`sh
+fluxfast types backend.main:app --frontend frontend
+fluxfast types backend.main:app --frontend frontend --check
+fluxfast dev backend.main:app --frontend frontend
+fluxfast build --app backend.main:app --frontend frontend
+fluxfast doctor --production --app backend.main:app --frontend frontend --strict
+fluxfast start backend.main:app --frontend frontend
+\`\`\`
+
+Development and production supervise FastAPI and the Node host behind one public
+origin. Do not run a second FastAPI service alongside these supervised commands.
+The frontend-only scripts above are for advanced, manually supervised hosts;
+only that mode requires setting the private backend URL yourself.
+
+Use the project's installed npm, pnpm, Yarn or Bun tooling; initialization never
+downloads dependencies. Full-stack generation starts from the authoritative Python
+contracts and the developer schema. Do not patch generated TypeScript to pass a build.
+All six artifacts under \`${generated}/\` and this guide are generated.
+
+## Page declaration and input/output
+
+\`\`\`python
+from fastapi import FastAPI
+from fluxfast import FluxFast, Page, resource, scope
+
+app = FastAPI()
+flux = FluxFast(app)
+GREETING = flux.define_resource("greeting", str)
+
+@flux.page("/", name="home")
+async def home() -> Page:
+    return Page(component="home/index", resources=[
+        resource(GREETING, lambda: "Hello", scope=scope.public(), ttl=30),
+    ])
+\`\`\`
+
+\`\`\`tsx
+import { useResource, Link } from "@fluxfast/react";
+
+export default function Home() {
+  const greeting = useResource<string>("greeting");
+  return <main><h1>{greeting}</h1><Link href="/rooms">Rooms</Link></main>;
+}
+\`\`\`
+
+The backend selects \`home/index\` and the canonical greeting. The matching
+\`${pages}/home/index.tsx\` (or JSX) produces \`<h1>Hello</h1>\` in the initial
+HTML. Hydration must reuse that exact envelope and opaque resource version,
+not perform an immediate duplicate initial fetch or replace SSR with an empty SPA.
+
+## Resources, mutations and isolation
+
+- Public scope is only for values identical for every caller. Protected caches
+  require \`scope.user(id)\`, \`scope.tenant(id)\`, request scope or no caching.
+- Authorize every page, partial/deferred load, mutation and live subscription.
+  Consider logout, tenant changes and multiple FastAPI workers in every change.
+- Keep canonical loaders and structured mutation patches/invalidation. Cancellation
+  does not imply that a server mutation rolled back.
+- Use \`useDeferredResource\` for pending/error/retry UI and \`useLiveStatus\`
+  for connection state. Do not add a competing store or ad hoc SSE/fetch lifecycle.
+- Redis coordinates shared caches and live brokers across workers; memory is local.
+- Pydantic validation and authorization remain authoritative even with client validators.
+
+## Same-origin runtime and review
+
+The browser sees one public host for documents, assets and protocol requests.
+Only Node receives server-private \`FLUXFAST_BACKEND_URL\`; never put it in a
+\`VITE_*\` variable, browser source or serialized page data. The incoming Host
+and forwarded headers must not select the backend. Forward only bounded safe headers.
+Production uses \`dist/fluxfast/\`, not source config or a Vite development server;
+starting must never install, generate or build implicitly. Keep session cookies,
+multiple Set-Cookie fields, streams and cancellation intact. Health probes are minimal.
+
+For synchronization bugs, reproduce with development \`@fluxfast/devtools\`
+and inspect Timeline/Resources/Cache/Mutations/Live/Protocol evidence. Diagnostics
+must remain value-free and inert in production. Never log credentials, resource
+values, request bodies or cache scope identities to compensate.
+
+Before finishing: regenerate/check contracts, run relevant Python and frontend
+typecheck/build/tests, inspect the browser graph for server/tooling imports, and
+verify SSR, hydration, navigation, deferred/live cleanup and tenant isolation.
+Keep FastAPI authoritative and fix the layer that owns the observed behavior.
+
+References: https://el37628.github.io/FluxFast-Docs/ and the installed package README.
+`;
+}
+//# sourceMappingURL=agent-knowledge.js.map

package/dist/esm/agent-knowledge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-knowledge.js","sourceRoot":"","sources":["../../src/agent-knowledge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAwB,MAAM,cAAc,CAAC;AAE/E,MAAM,CAAC,MAAM,gBAAgB,GAAG,gFAAgF,CAAC;AACjH,MAAM,KAAK,GAAG,yCAAyC,CAAC;AACxD,MAAM,GAAG,GAAG,uCAAuC,CAAC;AAEpD,sFAAsF;AACtF,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,SAAiB;IACjE,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1D,MAAM,KAAK,GAAG,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE,EAAE,GAAG,GAAG,SAAS,EAAE,EAAE;QAC1D,2CAA2C,SAAS,+DAA+D,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1I,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,GAAG,KAAK;QAC9C,KAAK,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,qGAAqG,CAAC,CAAC;IACjO,IAAI,KAAK,KAAK,CAAC,CAAC;QAAE,OAAO,QAAQ,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,GAAG,OAAO,CAAC;IAChI,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAwB;IACtD,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACnD,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAC3D,OAAO,GAAG,gBAAgB;;;;;;;;;;;;;;;;uBAgBL,SAAS;MAC1B,KAAK;;;;;;iCAMsB,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BAsChB,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA6BjC,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsCR,CAAC;AACF,CAAC"}

package/dist/esm/assets.js

@@ -0,0 +1,65 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { Readable } from "node:stream";
+import { createReadStream } from "node:fs";
+import { safeAssetName } from "./options.js";
+const CONTENT_TYPES = {
+    ".js": "text/javascript; charset=utf-8", ".mjs": "text/javascript; charset=utf-8", ".css": "text/css; charset=utf-8",
+    ".json": "application/json; charset=utf-8", ".svg": "image/svg+xml", ".png": "image/png", ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg", ".webp": "image/webp", ".gif": "image/gif", ".ico": "image/x-icon", ".woff": "font/woff", ".woff2": "font/woff2",
+};
+export function readHostManifest(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new Error("Invalid FluxFast production manifest");
+    const data = value;
+    if (data.version !== 1 || typeof data.template !== "string" || !safeAssetName(data.template.replace(/\.html?$/i, ".template")) ||
+        !/\.html?$/i.test(data.template) || !Array.isArray(data.assets) ||
+        data.assets.some(name => typeof name !== "string" || !safeAssetName(name)) ||
+        new Set(data.assets).size !== data.assets.length)
+        throw new Error("Invalid FluxFast production manifest");
+    return { version: 1, template: data.template, assets: data.assets };
+}
+export async function containedFile(root, name) {
+    const realRoot = await fs.realpath(root);
+    const candidate = await fs.realpath(path.join(root, name));
+    const relative = path.relative(realRoot, candidate);
+    if (!relative || relative.startsWith(".." + path.sep) || relative === ".." || path.isAbsolute(relative) ||
+        !(await fs.stat(candidate)).isFile())
+        throw new Error("FluxFast output is not a contained regular file");
+    return candidate;
+}
+export function createAssetHandler(root, names, templateName = "fluxfast.html") {
+    const assets = new Set(names);
+    return async (request) => {
+        const pathname = new URL(request.url).pathname;
+        let name;
+        try {
+            name = decodeURIComponent(pathname.slice(1));
+        }
+        catch {
+            return new Response(null, { status: 400 });
+        }
+        if (!assets.has(name)) {
+            // Reserved tooling/output paths and missing assets cannot become a SPA
+            // fallback or expose the raw SSR template, source or renderer.
+            if (name === templateName || /^\/(?:assets(?:\/|$)|@|src(?:\/|$)|node_modules(?:\/|$)|dist(?:\/|$)|\.)(?:.*)$/.test("/" + name)) {
+                return new Response(null, { status: 404, headers: { "cache-control": "no-store" } });
+            }
+            return;
+        }
+        if (request.method !== "GET" && request.method !== "HEAD")
+            return new Response(null, { status: 405, headers: { allow: "GET, HEAD" } });
+        try {
+            const file = await containedFile(root, name);
+            const headers = { "content-type": CONTENT_TYPES[path.extname(file).toLowerCase()] ?? "application/octet-stream", "cache-control": "public, max-age=0, must-revalidate", "x-content-type-options": "nosniff" };
+            if (request.method === "HEAD")
+                return new Response(null, { headers });
+            const stream = createReadStream(file);
+            return new Response(Readable.toWeb(stream), { headers });
+        }
+        catch {
+            return new Response(null, { status: 404, headers: { "cache-control": "no-store" } });
+        }
+    };
+}
+//# sourceMappingURL=assets.js.map

package/dist/esm/assets.js.map

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

package/dist/esm/bridge.js

@@ -0,0 +1,62 @@
+import { Readable } from "node:stream";
+import { once } from "node:events";
+import { removeFluxHopByHopHeaders } from "@fluxfast/core/server";
+/** Preserve raw path/query; neither Host nor forwarded headers select a target. */
+export function webRequest(incoming, signal) {
+    const raw = incoming.url ?? "/";
+    if (!raw.startsWith("/") || raw.startsWith("//") || /[\\\x00-\x1f\x7f]/.test(raw)) {
+        throw new TypeError("Invalid request path");
+    }
+    const headers = new Headers();
+    for (let index = 0; index < incoming.rawHeaders.length; index += 2) {
+        headers.append(incoming.rawHeaders[index], incoming.rawHeaders[index + 1]);
+    }
+    // Cookie uses '; ', not Fetch Headers' generic comma separator. Node already
+    // combines repeated Cookie fields correctly (including HTTP/2 compatibility).
+    if (typeof incoming.headers.cookie === "string")
+        headers.set("cookie", incoming.headers.cookie);
+    const method = incoming.method ?? "GET";
+    const body = method === "GET" || method === "HEAD" ? undefined : Readable.toWeb(incoming);
+    return new Request("http://fluxfast.invalid" + raw, {
+        method, headers, signal, ...(body === undefined ? {} : { body, duplex: "half" }),
+    });
+}
+/** Unbuffered response bridge with cookie separation, backpressure, cancellation. */
+export async function writeWebResponse(response, outgoing, signal) {
+    const headers = removeFluxHopByHopHeaders(response.headers);
+    outgoing.statusCode = response.status;
+    for (const [name, value] of headers)
+        if (name !== "set-cookie")
+            outgoing.setHeader(name, value);
+    const cookies = headers.getSetCookie();
+    if (cookies.length)
+        outgoing.setHeader("set-cookie", cookies);
+    const reader = response.body?.getReader();
+    const cancel = () => { void reader?.cancel().catch(() => undefined); };
+    signal.addEventListener("abort", cancel, { once: true });
+    try {
+        if (signal.aborted) {
+            cancel();
+            return;
+        }
+        outgoing.flushHeaders();
+        if (reader) {
+            while (!signal.aborted) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                if (!outgoing.write(value))
+                    await once(outgoing, "drain", { signal });
+            }
+        }
+        if (!signal.aborted)
+            outgoing.end();
+    }
+    finally {
+        signal.removeEventListener("abort", cancel);
+        if (signal.aborted)
+            cancel();
+        reader?.releaseLock();
+    }
+}
+//# sourceMappingURL=bridge.js.map

package/dist/esm/bridge.js.map

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

package/dist/esm/build.js

@@ -0,0 +1,62 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { BUILD_DIRECTORY, SERVER_ENTRY, configuredFluxOptions, safeAssetName } from "./options.js";
+/** Produce separate client assets and a Node renderer; never contact FastAPI. */
+export async function buildFluxViteApp(options = {}) {
+    if (process.env.NODE_ENV !== undefined && process.env.NODE_ENV !== "production") {
+        throw new Error("FluxFast production builds require NODE_ENV=production (or unset)");
+    }
+    const vite = await import("vite");
+    const root = path.resolve(options.root ?? process.cwd());
+    const common = { root, ...(options.configFile === undefined ? {} : { configFile: options.configFile }), mode: "production" };
+    const config = await vite.resolveConfig(common, "build");
+    const flux = configuredFluxOptions(config);
+    const output = path.join(config.root, BUILD_DIRECTORY);
+    const templateSource = await fs.readFile(flux.template, "utf8");
+    for (const marker of ["<!--fluxfast:ssr-->", "<!--fluxfast:payload-->"]) {
+        if (templateSource.split(marker).length !== 2)
+            throw new Error("FluxFast template requires exactly one SSR and payload marker");
+    }
+    // Reject output symlinks before either build can clear a directory.
+    for (const name of ["dist", BUILD_DIRECTORY, BUILD_DIRECTORY + "/client", BUILD_DIRECTORY + "/server"]) {
+        try {
+            const stat = await fs.lstat(path.join(config.root, name));
+            if (!stat.isDirectory() || stat.isSymbolicLink())
+                throw new Error("FluxFast build output must use regular, non-symlinked directories");
+        }
+        catch (error) {
+            if (error.code !== "ENOENT")
+                throw error;
+        }
+    }
+    await fs.unlink(path.join(output, "host.json")).catch(error => { if (error.code !== "ENOENT")
+        throw error; });
+    // Fixed, owned leaf directories only. Never clear an arbitrary config outDir.
+    await vite.build({ ...common, build: {
+            outDir: path.join(output, "client"), emptyOutDir: true, sourcemap: false,
+            rollupOptions: { input: flux.template },
+        } });
+    await vite.build({ ...common, build: {
+            ssr: true, outDir: path.join(output, "server"), emptyOutDir: true,
+            sourcemap: false, copyPublicDir: false,
+            rollupOptions: { input: SERVER_ENTRY, output: { format: "es", entryFileNames: "renderer.mjs", chunkFileNames: "chunks/[name]-[hash].mjs" } },
+        } });
+    const client = path.join(output, "client");
+    const template = path.relative(config.root, flux.template).replace(/\\/g, "/");
+    // Vite emits the HTML at its relative input path. Record exactly what built,
+    // rather than evaluating configuration again during production startup.
+    await fs.access(path.join(client, template));
+    const assets = [];
+    async function scan(directory, prefix = "") {
+        for (const item of await fs.readdir(directory, { withFileTypes: true })) {
+            const name = prefix + item.name;
+            if (item.isDirectory() && !item.name.startsWith("."))
+                await scan(path.join(directory, item.name), name + "/");
+            else if (item.isFile() && safeAssetName(name))
+                assets.push(name);
+        }
+    }
+    await scan(client);
+    await fs.writeFile(path.join(output, "host.json"), JSON.stringify({ version: 1, template, assets: assets.sort() }) + "\n");
+}
+//# sourceMappingURL=build.js.map

package/dist/esm/build.js.map

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