@nifrajs/web 4.0.2 → 5.0.0

package/dist/server-components/types.d.ts

@@ -0,0 +1,107 @@
+import type { StandardSchemaV1 } from "@nifrajs/core/server";
+import type { LoaderContext } from "../manifest.js";
+export type ComponentKey = string | number;
+export type ComponentValue = null | boolean | number | string | readonly ComponentValue[] | {
+    readonly [key: string]: ComponentValue;
+};
+export interface ServerComponentContext extends LoaderContext {
+    readonly signal: AbortSignal;
+    readonly data: unknown;
+    readonly layoutData: readonly unknown[];
+}
+export interface ServerComponentDefinition<Input, Props, View> {
+    readonly input: StandardSchemaV1<unknown, Input>;
+    readonly props: StandardSchemaV1<unknown, Props>;
+    readonly authorize: (ctx: ServerComponentContext, input: Input) => void | Promise<void>;
+    readonly load: (ctx: ServerComponentContext, input: Input) => unknown | Promise<unknown>;
+    readonly view: (args: {
+        readonly props: Props;
+        readonly children?: readonly ComponentRecord[];
+    }) => View | Promise<View>;
+    readonly capabilities?: readonly string[];
+}
+export interface ServerComponent<Input = unknown, Props = unknown, View = unknown> {
+    /** Compiler-generated opaque reference; application authors do not assign module URLs. */
+    readonly reference?: string;
+    readonly view: (args: {
+        readonly props: Props;
+        readonly children?: readonly ComponentRecord[];
+    }) => View | Promise<View>;
+    readonly input: StandardSchemaV1<unknown, Input>;
+    readonly props: StandardSchemaV1<unknown, Props>;
+}
+export interface PreparedServerComponent<Props = unknown, View = unknown> {
+    readonly props: Props;
+    readonly view: (args: {
+        readonly props: Props;
+        readonly children?: readonly ComponentRecord[];
+    }) => View | Promise<View>;
+}
+export interface ComponentRenderContext {
+    readonly reference: string;
+    readonly instance: string;
+    readonly signal: AbortSignal;
+    readonly nonce?: string;
+    readonly children?: readonly ComponentRecord[];
+}
+export interface ComponentRender {
+    readonly html: string;
+    readonly payload?: ComponentValue;
+    readonly islands?: readonly ComponentIsland[];
+}
+export interface ComponentIsland {
+    readonly reference: string;
+    readonly key: ComponentKey;
+    readonly props: ComponentValue;
+    readonly renderId: string;
+    readonly slots?: Readonly<Record<string, string>>;
+}
+export interface ServerComponentRenderAdapter {
+    readonly name: "react" | "vue" | "svelte" | "solid" | "preact";
+    readonly version: 1;
+    render(view: unknown, props: unknown, context: ComponentRenderContext): ComponentRender | Promise<ComponentRender>;
+}
+export interface ComponentInstance {
+    readonly component: ServerComponentHandle;
+    readonly key: ComponentKey;
+    readonly input: unknown;
+    readonly parent?: string;
+}
+export interface ComponentOwner {
+    readonly components: readonly ServerComponentHandle[];
+    readonly capabilities?: readonly string[];
+    readonly instances: (ctx: ServerComponentContext) => readonly ComponentInstance[] | Promise<readonly ComponentInstance[]>;
+    /** A public, non-secret token supplied by the application's auth integration. */
+    readonly scope: "anonymous" | ((ctx: ServerComponentContext) => string | Promise<string>);
+}
+export interface ServerComponentHandle {
+    readonly reference?: string;
+    readonly input: StandardSchemaV1;
+    readonly props: StandardSchemaV1;
+    readonly view: (args: never) => unknown;
+}
+export interface ComponentRecord extends ComponentRender {
+    readonly instance: string;
+    readonly reference: string;
+    readonly key: ComponentKey;
+    readonly parent: string | null;
+    readonly input: ComponentValue;
+}
+export interface ComponentState {
+    readonly v: 1;
+    readonly build: string;
+    readonly adapter: "react" | "vue" | "svelte" | "solid" | "preact";
+    readonly owner: string;
+    readonly scope: string;
+    readonly records: readonly ComponentRecord[];
+}
+/** Optional seam passed to createWebApp; disabled applications have no runtime import of this feature. */
+export interface ServerComponentRuntime {
+    owns(routeId: string): boolean;
+    capabilities(routeId: string): readonly string[];
+    classify(request: Request, routeId: string): import("./protocol.js").ComponentRequest | undefined;
+    execute(routeId: string, context: ServerComponentContext, selection?: import("./protocol.js").ComponentRequest, nonce?: string): Promise<ComponentState>;
+    response(state: ComponentState, selection: import("./protocol.js").ComponentRequest): Response;
+    failure(error: unknown): Response;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/server-components/types.d.ts.map

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

package/dist/server-components/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/server-components/types.js.map

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

package/dist/server-components/typescript.d.ts

@@ -0,0 +1,11 @@
+import type * as TS from "typescript";
+/** The code of the error a TypeScript without the in-process compiler API raises here. */
+export declare const UNSUPPORTED_TYPESCRIPT = "NIFRA_TS_UNSUPPORTED";
+/**
+ * The TypeScript compiler API, resolved from `from` the way `import "typescript"` there would be.
+ * TypeScript 7's package ships no in-process compiler API (its root export is only `version`), so
+ * it raises an error that names the fix instead of a TypeError on first use.
+ */
+export declare function loadTypeScript(from?: string): typeof TS;
+export declare const ts: typeof TS;
+//# sourceMappingURL=typescript.d.ts.map

package/dist/server-components/typescript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript.d.ts","sourceRoot":"","sources":["../../src/server-components/typescript.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,EAAE,MAAM,YAAY,CAAA;AAErC,0FAA0F;AAC1F,eAAO,MAAM,sBAAsB,yBAAyB,CAAA;AAW5D;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,GAAE,MAAwB,GAAG,OAAO,EAAE,CAgBxE;AAED,eAAO,MAAM,EAAE,EAAE,OAAO,EAAqB,CAAA"}

package/dist/server-components/typescript.js

@@ -0,0 +1,28 @@
+import { createRequire } from "node:module";
+/** The code of the error a TypeScript without the in-process compiler API raises here. */
+export const UNSUPPORTED_TYPESCRIPT = "NIFRA_TS_UNSUPPORTED";
+function isCompiler(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "createSourceFile" in value &&
+        typeof value.createSourceFile === "function");
+}
+/**
+ * The TypeScript compiler API, resolved from `from` the way `import "typescript"` there would be.
+ * TypeScript 7's package ships no in-process compiler API (its root export is only `version`), so
+ * it raises an error that names the fix instead of a TypeError on first use.
+ */
+export function loadTypeScript(from = import.meta.url) {
+    const loaded = createRequire(from)("typescript");
+    if (isCompiler(loaded))
+        return loaded;
+    const version = typeof loaded === "object" &&
+        loaded !== null &&
+        "version" in loaded &&
+        typeof loaded.version === "string"
+        ? loaded.version
+        : "unknown";
+    throw Object.assign(new Error(`${UNSUPPORTED_TYPESCRIPT}: server components read component modules with the TypeScript compiler API, which TypeScript ${version} does not ship. Pin the project to TypeScript 6 (for example, \`bun add -d typescript@^6\`).`), { code: UNSUPPORTED_TYPESCRIPT, version });
+}
+export const ts = loadTypeScript();
+//# sourceMappingURL=typescript.js.map

package/dist/server-components/typescript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript.js","sourceRoot":"","sources":["../../src/server-components/typescript.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAG3C,0FAA0F;AAC1F,MAAM,CAAC,MAAM,sBAAsB,GAAG,sBAAsB,CAAA;AAE5D,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,kBAAkB,IAAI,KAAK;QAC3B,OAAO,KAAK,CAAC,gBAAgB,KAAK,UAAU,CAC7C,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe,MAAM,CAAC,IAAI,CAAC,GAAG;IAC3D,MAAM,MAAM,GAAY,aAAa,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,CAAA;IACzD,IAAI,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAA;IACrC,MAAM,OAAO,GACX,OAAO,MAAM,KAAK,QAAQ;QAC1B,MAAM,KAAK,IAAI;QACf,SAAS,IAAI,MAAM;QACnB,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ;QAChC,CAAC,CAAC,MAAM,CAAC,OAAO;QAChB,CAAC,CAAC,SAAS,CAAA;IACf,MAAM,MAAM,CAAC,MAAM,CACjB,IAAI,KAAK,CACP,GAAG,sBAAsB,iGAAiG,OAAO,8FAA8F,CAChO,EACD,EAAE,IAAI,EAAE,sBAAsB,EAAE,OAAO,EAAE,CAC1C,CAAA;AACH,CAAC;AAED,MAAM,CAAC,MAAM,EAAE,GAAc,cAAc,EAAE,CAAA"}

package/dist/server-components/value.d.ts

@@ -0,0 +1,5 @@
+import type { ComponentValue } from "./types.js";
+/** Property order does not identify a resource; callers supply already-validated DTO inputs. */
+export declare function componentInputKey(value: ComponentValue): string;
+export declare function componentValue(value: unknown, maxBytes?: number): ComponentValue;
+//# sourceMappingURL=value.d.ts.map

package/dist/server-components/value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"value.d.ts","sourceRoot":"","sources":["../../src/server-components/value.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhD,gGAAgG;AAChG,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAQ/D;AAKD,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,GAAE,MAAc,GAAG,cAAc,CAgEvF"}

package/dist/server-components/value.js

@@ -0,0 +1,77 @@
+import { ServerComponentError } from "./error.js";
+/** Property order does not identify a resource; callers supply already-validated DTO inputs. */
+export function componentInputKey(value) {
+    if (Array.isArray(value))
+        return `[${value.map(componentInputKey).join(",")}]`;
+    if (typeof value === "object" && value !== null)
+        return `{${Object.keys(value)
+            .sort()
+            .map((key) => `${JSON.stringify(key)}:${componentInputKey(Reflect.get(value, key))}`)
+            .join(",")}}`;
+    return JSON.stringify(value);
+}
+const encoder = new TextEncoder();
+const forbidden = new Set(["__proto__", "prototype", "constructor"]);
+export function componentValue(value, maxBytes = 65536) {
+    const seen = new Set();
+    let nodes = 0;
+    let bytes = 0;
+    const charge = (text) => {
+        bytes += encoder.encode(text).byteLength;
+        if (bytes > maxBytes)
+            throw new ServerComponentError("component_limit", 413);
+    };
+    const visit = (item, depth) => {
+        if (++nodes > 8192 || depth > 16)
+            throw new ServerComponentError("component_limit", 413);
+        if (item === null ||
+            typeof item === "string" ||
+            typeof item === "boolean" ||
+            (typeof item === "number" && Number.isFinite(item))) {
+            charge(JSON.stringify(item));
+            return item;
+        }
+        if (typeof item !== "object" || item === null || seen.has(item))
+            throw new ServerComponentError("component_contract");
+        const array = Array.isArray(item);
+        const prototype = Object.getPrototypeOf(item);
+        if (array ? prototype !== Array.prototype : prototype !== Object.prototype && prototype !== null) {
+            throw new ServerComponentError("component_contract");
+        }
+        // Reject custom serializers without invoking them, including inherited serializers.
+        if ("toJSON" in item || Object.getOwnPropertySymbols(item).length > 0)
+            throw new ServerComponentError("component_contract");
+        const descriptors = Object.getOwnPropertyDescriptors(item);
+        const names = Object.keys(descriptors);
+        if (array && (item.length > 8192 || names.length !== item.length + 1))
+            throw new ServerComponentError("component_contract");
+        const result = array
+            ? []
+            : Object.create(null);
+        seen.add(item);
+        charge(array ? "[]" : "{}");
+        let count = 0;
+        for (const name of names) {
+            if (array && name === "length")
+                continue;
+            const property = descriptors[name];
+            if (forbidden.has(name) ||
+                !property.enumerable ||
+                !Object.hasOwn(property, "value") ||
+                (array && (!/^(0|[1-9][0-9]*)$/.test(name) || Number(name) >= item.length))) {
+                throw new ServerComponentError("component_contract");
+            }
+            charge((count++ === 0 ? "" : ",") + (array ? "" : `${JSON.stringify(name)}:`));
+            Object.defineProperty(result, name, {
+                value: visit(property.value, depth + 1),
+                enumerable: true,
+                writable: true,
+                configurable: true,
+            });
+        }
+        seen.delete(item);
+        return result;
+    };
+    return visit(value, 0);
+}
+//# sourceMappingURL=value.js.map

package/dist/server-components/value.js.map

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

package/dist/server-components/vite.d.ts

@@ -0,0 +1,12 @@
+import { type Plugin } from "vite";
+export interface ServerComponentsPluginOptions {
+    readonly root: string;
+    readonly adapter: "react" | "vue" | "svelte" | "solid" | "preact";
+}
+/** Compiler bridge. The ordinary build must continue rejecting arbitrary server imports. */
+export declare function serverComponentsPlugin(options: ServerComponentsPluginOptions): Plugin & {
+    readonly api: {
+        readonly componentModules: ReadonlySet<string>;
+    };
+};
+//# sourceMappingURL=vite.d.ts.map

package/dist/server-components/vite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.d.ts","sourceRoot":"","sources":["../../src/server-components/vite.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,MAAM,EAA0B,MAAM,MAAM,CAAA;AAmB1D,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAA;CAClE;AAiED,4FAA4F;AAC5F,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,6BAA6B,GACrC,MAAM,GAAG;IAAE,QAAQ,CAAC,GAAG,EAAE;QAAE,QAAQ,CAAC,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;KAAE,CAAA;CAAE,CAmJ/E"}

package/dist/server-components/vite.js

@@ -0,0 +1,197 @@
+import { existsSync, readFileSync } from "node:fs";
+import { createRequire } from "node:module";
+import { resolve } from "node:path";
+import { version as viteVersion } from "vite";
+import { compileComponentModule, componentReference, directive, exportedValues, guardCreateElementCalls, sourceFile, } from "./source.js";
+import { ts } from "./typescript.js";
+const componentFile = /\.component\.server\.[cm]?[jt]sx?$/;
+const islandFile = /\.island\.[cm]?[jt]sx?$/;
+const referencePrefix = "\0nifra-component-reference:";
+const nativeQuery = "nifra-native-client-reference";
+const reactRuntime = "\0nifra-component-react-runtime";
+// Vite uses forward slashes for module IDs even when the filesystem uses backslashes.
+const bare = (id) => (id.split("?")[0] ?? id).replaceAll("\\", "/");
+function nativeFacade(source, file) {
+    const prefix = file.replace(/\.[cm]?[jt]sx?$/, ".props.");
+    const extensions = /\.[cm]?jsx?$/.test(file)
+        ? ["js", "mjs", "cjs", "ts"]
+        : ["ts", "mts", "cts", "js"];
+    const companion = extensions.map((extension) => prefix + extension).find(existsSync) ?? prefix + extensions[0];
+    if (!existsSync(companion))
+        throw new Error(`[nifra/components] ${file} requires ${companion}: export a closed props schema for every native client component`);
+    const schemas = sourceFile(readFileSync(companion, "utf8"), companion);
+    const registered = new Set(exportedValues(schemas));
+    const slots = new Map();
+    for (const statement of schemas.statements) {
+        if (!ts.isVariableStatement(statement))
+            continue;
+        for (const declaration of statement.declarationList.declarations) {
+            if (!ts.isIdentifier(declaration.name) || !declaration.name.text.endsWith("Slots"))
+                continue;
+            let value = declaration.initializer;
+            if (value !== undefined && ts.isAsExpression(value))
+                value = value.expression;
+            if (value === undefined ||
+                !ts.isArrayLiteralExpression(value) ||
+                !value.elements.every(ts.isStringLiteral))
+                throw new Error("[nifra/components] Managed slot names must be a literal array");
+            // biome-ignore lint/plugin/requireSafetyCommentForTypeAssertion: The compiler inspects trusted AST/package metadata and its own populated stub map; application data never supplies these values.
+            const names = value.elements.map((node) => node.text);
+            if (names.some((name) => !/^[A-Za-z][A-Za-z0-9_]{0,63}$/.test(name) ||
+                name === "ref" ||
+                name === "key" ||
+                name === "constructor"))
+                throw new Error("[nifra/components] Invalid managed slot name");
+            slots.set(declaration.name.text.slice(0, -5), names);
+        }
+    }
+    const names = exportedValues(sourceFile(source, file));
+    const exports = names.map((name, index) => {
+        if (!registered.has(name))
+            throw new Error(`[nifra/components] Native client export ${name} in ${file} has no registered props schema`);
+        if (name !== "default" && !/^[$A-Z_a-z][$\w]*$/.test(name))
+            throw new Error("[nifra/components] Native client export names must be identifiers");
+        const local = `__nifra_client_${index}`;
+        const value = `__guard(__native[${JSON.stringify(name)}], __schemas[${JSON.stringify(name)}], ${JSON.stringify(slots.get(name) ?? [])})`;
+        return name === "default"
+            ? `const ${local} = ${value}; export default ${local};`
+            : `export const ${name} = ${value};`;
+    });
+    return [
+        'import { guardedClientReference as __guard } from "@nifrajs/web-react/server-components/guard";',
+        `import * as __native from ${JSON.stringify(`${file}?${nativeQuery}`)};`,
+        `import * as __schemas from ${JSON.stringify(companion)};`,
+        ...exports,
+    ].join("\n");
+}
+/** Compiler bridge. The ordinary build must continue rejecting arbitrary server imports. */
+export function serverComponentsPlugin(options) {
+    const stubs = new Map();
+    const internal = new Set();
+    const nativeReferences = new Set();
+    const componentModules = new Set();
+    return {
+        api: { componentModules },
+        name: "nifra:server-components",
+        enforce: "pre",
+        configResolved(config) {
+            if (viteVersion !== "8.2.1")
+                throw new Error("[nifra/components] Use the certified Vite 8.2.1 component pipeline; Bun remains a supported server runtime");
+            if (options.adapter === "react") {
+                const require = createRequire(resolve(config.root, "package.json"));
+                const versions = ["react", "react-dom", "react-server-dom-webpack"].map((name) => {
+                    try {
+                        // biome-ignore lint/plugin/requireSafetyCommentForTypeAssertion: The compiler inspects trusted AST/package metadata and its own populated stub map; application data never supplies these values.
+                        return require(`${name}/package.json`).version;
+                    }
+                    catch {
+                        throw new Error(`[nifra/components] Install ${name}@19.2.8 for the React component pipeline`);
+                    }
+                });
+                if (versions.some((version) => version !== "19.2.8"))
+                    throw new Error("[nifra/components] React, React DOM, and Flight must all use the matching 19.2.8 version");
+            }
+        },
+        async resolveId(source, importer) {
+            const environment = this.environment.name;
+            if (source === "react" && environment === "rsc" && !internal.has(bare(importer ?? ""))) {
+                internal.add(reactRuntime);
+                const guard = await this.resolve("@nifrajs/web-react/server-components/guard", importer, {
+                    skipSelf: true,
+                });
+                if (guard !== null)
+                    internal.add(bare(guard.id));
+                return reactRuntime;
+            }
+            if (source.startsWith("\0virtual:vite-rsc/") && environment !== "rsc")
+                return null;
+            if (source.startsWith("@nifrajs/web-react/server-components/")) {
+                const resolved = await this.resolve(source, importer, { skipSelf: true });
+                if (resolved !== null)
+                    internal.add(bare(resolved.id));
+                return resolved;
+            }
+            if (source.includes(nativeQuery)) {
+                const file = source.startsWith("/@fs/")
+                    ? source.slice("/@fs".length).replace(/^\/(?=[A-Za-z]:[\\/])/, "")
+                    : existsSync(bare(source))
+                        ? source
+                        : resolve(options.root, `.${source}`);
+                if (!nativeReferences.has(bare(file)) ||
+                    (environment === "rsc" && (importer === undefined || bare(importer) !== bare(file))))
+                    throw new Error("[nifra/components] Raw native client references are compiler-owned; import the registered client component");
+                return file;
+            }
+            if (source.startsWith(referencePrefix) || source.startsWith("\0"))
+                return null;
+            if (environment === "rsc" &&
+                options.adapter === "react" &&
+                (source === "react/jsx-runtime" || source === "react/jsx-dev-runtime") &&
+                !internal.has(bare(importer ?? ""))) {
+                const resolved = await this.resolve(`@nifrajs/web-react/server-components/${source.endsWith("dev-runtime") ? "jsx-dev-runtime" : "jsx-runtime"}`, importer, { skipSelf: true });
+                if (resolved === null)
+                    throw new Error("[nifra/components] Install the matching @nifrajs/web-react adapter");
+                internal.add(bare(resolved.id));
+                const guard = await this.resolve("@nifrajs/web-react/server-components/guard", importer, {
+                    skipSelf: true,
+                });
+                if (guard !== null)
+                    internal.add(bare(guard.id));
+                return resolved;
+            }
+            if (environment !== "client")
+                return null;
+            const resolved = await this.resolve(source, importer, { skipSelf: true });
+            if (resolved === null || !componentFile.test(bare(resolved.id)))
+                return null;
+            if (resolved.id !== bare(resolved.id))
+                throw new Error("[nifra/components] Server component source cannot be imported as an asset");
+            const compiled = compileComponentModule(readFileSync(resolved.id, "utf8"), resolved.id, options.root, "client");
+            const id = referencePrefix + componentReference(resolved.id, options.root, "module");
+            stubs.set(id, compiled.code);
+            return id;
+        },
+        load(id) {
+            if (id === reactRuntime)
+                return {
+                    code: 'import * as Native from "react"; import { guardedCreateElement as createElement, guardedCloneElement as cloneElement } from "@nifrajs/web-react/server-components/guard"; export { Children, Fragment, Profiler, StrictMode, Suspense, __SERVER_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE, cache, cacheSignal, captureOwnerStack, createRef, forwardRef, isValidElement, lazy, memo, use, useCallback, useDebugValue, useId, useMemo, version } from "react"; export { createElement, cloneElement }; export default { ...Native, createElement, cloneElement };',
+                    map: null,
+                };
+            // biome-ignore lint/plugin/requireSafetyCommentForTypeAssertion: The compiler inspects trusted AST/package metadata and its own populated stub map; application data never supplies these values.
+            if (stubs.has(id))
+                return { code: stubs.get(id), map: null };
+            const path = bare(id);
+            if (id.endsWith(`?${nativeQuery}`))
+                return { code: readFileSync(path, "utf8"), map: null };
+            if (!/\.[cm]?[jt]sx?$/.test(path) || !existsSync(path))
+                return null;
+            const source = readFileSync(path, "utf8");
+            const ast = sourceFile(source, path);
+            if (directive(ast, "use server"))
+                throw new Error(`[nifra/components] Native use-server actions in ${path} are unsupported; use a validated serverFn in a *.fn.ts module`);
+            if (this.environment.name === "rsc" &&
+                options.adapter === "react" &&
+                directive(ast, "use client")) {
+                nativeReferences.add(path);
+                return { code: nativeFacade(source, path), map: null };
+            }
+            return null;
+        },
+        transform(source, id) {
+            if (id.includes(nativeQuery) || internal.has(bare(id)))
+                return null;
+            const path = bare(id);
+            let code = source;
+            if (componentFile.test(path)) {
+                code = compileComponentModule(source, path, options.root, this.environment.name).code;
+                componentModules.add(path);
+            }
+            if (islandFile.test(path))
+                code = compileComponentModule(source, path, options.root, this.environment.name, "island").code;
+            if (this.environment.name === "rsc" && options.adapter === "react")
+                code = guardCreateElementCalls(code, path);
+            return code === source ? null : { code, map: null };
+        },
+    };
+}
+//# sourceMappingURL=vite.js.map

package/dist/server-components/vite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.js","sourceRoot":"","sources":["../../src/server-components/vite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,OAAO,EAAe,OAAO,IAAI,WAAW,EAAE,MAAM,MAAM,CAAA;AAC1D,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,SAAS,EACT,cAAc,EACd,uBAAuB,EACvB,UAAU,GACX,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAA;AAEpC,MAAM,aAAa,GAAG,oCAAoC,CAAA;AAC1D,MAAM,UAAU,GAAG,yBAAyB,CAAA;AAC5C,MAAM,eAAe,GAAG,8BAA8B,CAAA;AACtD,MAAM,WAAW,GAAG,+BAA+B,CAAA;AACnD,MAAM,YAAY,GAAG,iCAAiC,CAAA;AACtD,sFAAsF;AACtF,MAAM,IAAI,GAAG,CAAC,EAAU,EAAU,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;AAOnF,SAAS,YAAY,CAAC,MAAc,EAAE,IAAY;IAChD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,SAAS,CAAC,CAAA;IACzD,MAAM,UAAU,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC;QAC1C,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC;QAC5B,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,CAAA;IAC9B,MAAM,SAAS,GACb,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,CAAA;IAC9F,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,sBAAsB,IAAI,aAAa,SAAS,kEAAkE,CACnH,CAAA;IACH,MAAM,OAAO,GAAG,UAAU,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,SAAS,CAAC,CAAA;IACtE,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAA;IACnD,MAAM,KAAK,GAAG,IAAI,GAAG,EAA6B,CAAA;IAClD,KAAK,MAAM,SAAS,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QAC3C,IAAI,CAAC,EAAE,CAAC,mBAAmB,CAAC,SAAS,CAAC;YAAE,SAAQ;QAChD,KAAK,MAAM,WAAW,IAAI,SAAS,CAAC,eAAe,CAAC,YAAY,EAAE,CAAC;YACjE,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAAE,SAAQ;YAC5F,IAAI,KAAK,GAAG,WAAW,CAAC,WAAW,CAAA;YACnC,IAAI,KAAK,KAAK,SAAS,IAAI,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC;gBAAE,KAAK,GAAG,KAAK,CAAC,UAAU,CAAA;YAC7E,IACE,KAAK,KAAK,SAAS;gBACnB,CAAC,EAAE,CAAC,wBAAwB,CAAC,KAAK,CAAC;gBACnC,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,eAAe,CAAC;gBAEzC,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAA;YAClF,kMAAkM;YAClM,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAE,IAAyB,CAAC,IAAI,CAAC,CAAA;YAC3E,IACE,KAAK,CAAC,IAAI,CACR,CAAC,IAAI,EAAE,EAAE,CACP,CAAC,8BAA8B,CAAC,IAAI,CAAC,IAAI,CAAC;gBAC1C,IAAI,KAAK,KAAK;gBACd,IAAI,KAAK,KAAK;gBACd,IAAI,KAAK,aAAa,CACzB;gBAED,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAA;YACjE,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAA;QACtD,CAAC;IACH,CAAC;IACD,MAAM,KAAK,GAAG,cAAc,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAA;IACtD,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QACxC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC;YACvB,MAAM,IAAI,KAAK,CACb,2CAA2C,IAAI,OAAO,IAAI,iCAAiC,CAC5F,CAAA;QACH,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC;YACxD,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAA;QACtF,MAAM,KAAK,GAAG,kBAAkB,KAAK,EAAE,CAAA;QACvC,MAAM,KAAK,GAAG,oBAAoB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,gBAAgB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,CAAA;QACxI,OAAO,IAAI,KAAK,SAAS;YACvB,CAAC,CAAC,SAAS,KAAK,MAAM,KAAK,oBAAoB,KAAK,GAAG;YACvD,CAAC,CAAC,gBAAgB,IAAI,MAAM,KAAK,GAAG,CAAA;IACxC,CAAC,CAAC,CAAA;IACF,OAAO;QACL,iGAAiG;QACjG,6BAA6B,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,IAAI,WAAW,EAAE,CAAC,GAAG;QACxE,8BAA8B,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,GAAG;QAC1D,GAAG,OAAO;KACX,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,sBAAsB,CACpC,OAAsC;IAEtC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAA;IACvC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAA;IAClC,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAU,CAAA;IAC1C,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAU,CAAA;IAC1C,OAAO;QACL,GAAG,EAAE,EAAE,gBAAgB,EAAE;QACzB,IAAI,EAAE,yBAAyB;QAC/B,OAAO,EAAE,KAAK;QACd,cAAc,CAAC,MAAM;YACnB,IAAI,WAAW,KAAK,OAAO;gBACzB,MAAM,IAAI,KAAK,CACb,4GAA4G,CAC7G,CAAA;YACH,IAAI,OAAO,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;gBAChC,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAA;gBACnE,MAAM,QAAQ,GAAG,CAAC,OAAO,EAAE,WAAW,EAAE,0BAA0B,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;oBAC/E,IAAI,CAAC;wBACH,kMAAkM;wBAClM,OAAQ,OAAO,CAAC,GAAG,IAAI,eAAe,CAAyB,CAAC,OAAO,CAAA;oBACzE,CAAC;oBAAC,MAAM,CAAC;wBACP,MAAM,IAAI,KAAK,CACb,8BAA8B,IAAI,0CAA0C,CAC7E,CAAA;oBACH,CAAC;gBACH,CAAC,CAAC,CAAA;gBACF,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,QAAQ,CAAC;oBAClD,MAAM,IAAI,KAAK,CACb,0FAA0F,CAC3F,CAAA;YACL,CAAC;QACH,CAAC;QACD,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,QAAQ;YAC9B,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAA;YACzC,IAAI,MAAM,KAAK,OAAO,IAAI,WAAW,KAAK,KAAK,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;gBACvF,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,CAAA;gBAC1B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,4CAA4C,EAAE,QAAQ,EAAE;oBACvF,QAAQ,EAAE,IAAI;iBACf,CAAC,CAAA;gBACF,IAAI,KAAK,KAAK,IAAI;oBAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAA;gBAChD,OAAO,YAAY,CAAA;YACrB,CAAC;YACD,IAAI,MAAM,CAAC,UAAU,CAAC,qBAAqB,CAAC,IAAI,WAAW,KAAK,KAAK;gBAAE,OAAO,IAAI,CAAA;YAClF,IAAI,MAAM,CAAC,UAAU,CAAC,uCAAuC,CAAC,EAAE,CAAC;gBAC/D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAA;gBACzE,IAAI,QAAQ,KAAK,IAAI;oBAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAA;gBACtD,OAAO,QAAQ,CAAA;YACjB,CAAC;YACD,IAAI,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;gBACjC,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC;oBACrC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,uBAAuB,EAAE,EAAE,CAAC;oBAClE,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;wBACxB,CAAC,CAAC,MAAM;wBACR,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,MAAM,EAAE,CAAC,CAAA;gBACzC,IACE,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBACjC,CAAC,WAAW,KAAK,KAAK,IAAI,CAAC,QAAQ,KAAK,SAAS,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;oBAEpF,MAAM,IAAI,KAAK,CACb,4GAA4G,CAC7G,CAAA;gBACH,OAAO,IAAI,CAAA;YACb,CAAC;YACD,IAAI,MAAM,CAAC,UAAU,CAAC,eAAe,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC;gBAAE,OAAO,IAAI,CAAA;YAC9E,IACE,WAAW,KAAK,KAAK;gBACrB,OAAO,CAAC,OAAO,KAAK,OAAO;gBAC3B,CAAC,MAAM,KAAK,mBAAmB,IAAI,MAAM,KAAK,uBAAuB,CAAC;gBACtE,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,EACnC,CAAC;gBACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CACjC,wCAAwC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,aAAa,EAAE,EAC5G,QAAQ,EACR,EAAE,QAAQ,EAAE,IAAI,EAAE,CACnB,CAAA;gBACD,IAAI,QAAQ,KAAK,IAAI;oBACnB,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAA;gBACvF,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAA;gBAC/B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,4CAA4C,EAAE,QAAQ,EAAE;oBACvF,QAAQ,EAAE,IAAI;iBACf,CAAC,CAAA;gBACF,IAAI,KAAK,KAAK,IAAI;oBAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAA;gBAChD,OAAO,QAAQ,CAAA;YACjB,CAAC;YACD,IAAI,WAAW,KAAK,QAAQ;gBAAE,OAAO,IAAI,CAAA;YACzC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAA;YACzE,IAAI,QAAQ,KAAK,IAAI,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAA;YAC5E,IAAI,QAAQ,CAAC,EAAE,KAAK,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACnC,MAAM,IAAI,KAAK,CAAC,2EAA2E,CAAC,CAAA;YAC9F,MAAM,QAAQ,GAAG,sBAAsB,CACrC,YAAY,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC,EACjC,QAAQ,CAAC,EAAE,EACX,OAAO,CAAC,IAAI,EACZ,QAAQ,CACT,CAAA;YACD,MAAM,EAAE,GAAG,eAAe,GAAG,kBAAkB,CAAC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;YACpF,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAA;YAC5B,OAAO,EAAE,CAAA;QACX,CAAC;QACD,IAAI,CAAC,EAAE;YACL,IAAI,EAAE,KAAK,YAAY;gBACrB,OAAO;oBACL,IAAI,EAAE,+iBAA+iB;oBACrjB,GAAG,EAAE,IAAI;iBACV,CAAA;YACH,kMAAkM;YAClM,IAAI,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,CAAW,EAAE,GAAG,EAAE,IAAI,EAAE,CAAA;YACtE,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,CAAA;YACrB,IAAI,EAAE,CAAC,QAAQ,CAAC,IAAI,WAAW,EAAE,CAAC;gBAAE,OAAO,EAAE,IAAI,EAAE,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAA;YAC1F,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;gBAAE,OAAO,IAAI,CAAA;YACnE,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;YACzC,MAAM,GAAG,GAAG,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;YACpC,IAAI,SAAS,CAAC,GAAG,EAAE,YAAY,CAAC;gBAC9B,MAAM,IAAI,KAAK,CACb,mDAAmD,IAAI,gEAAgE,CACxH,CAAA;YACH,IACE,IAAI,CAAC,WAAW,CAAC,IAAI,KAAK,KAAK;gBAC/B,OAAO,CAAC,OAAO,KAAK,OAAO;gBAC3B,SAAS,CAAC,GAAG,EAAE,YAAY,CAAC,EAC5B,CAAC;gBACD,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;gBAC1B,OAAO,EAAE,IAAI,EAAE,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAA;YACxD,CAAC;YACD,OAAO,IAAI,CAAA;QACb,CAAC;QACD,SAAS,CAAC,MAAM,EAAE,EAAE;YAClB,IAAI,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAA;YACnE,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,CAAA;YACrB,IAAI,IAAI,GAAG,MAAM,CAAA;YACjB,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC7B,IAAI,GAAG,sBAAsB,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,CAAA;gBACrF,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;YAC5B,CAAC;YACD,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;gBACvB,IAAI,GAAG,sBAAsB,CAC3B,MAAM,EACN,IAAI,EACJ,OAAO,CAAC,IAAI,EACZ,IAAI,CAAC,WAAW,CAAC,IAAI,EACrB,QAAQ,CACT,CAAC,IAAI,CAAA;YACR,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,KAAK,KAAK,IAAI,OAAO,CAAC,OAAO,KAAK,OAAO;gBAChE,IAAI,GAAG,uBAAuB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;YAC5C,OAAO,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,CAAA;QACrD,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/server-components.d.ts

@@ -0,0 +1,5 @@
+export { defineServerComponent, inheritOwnerAuthorization, isServerComponent, prepareServerComponent, } from "./server-components/definition.js";
+export { type ComponentErrorCode, ServerComponentError } from "./server-components/error.js";
+export { createServerComponents, defineComponentOwner, type ServerComponentsOptions, serverComponentIdentity, serverComponentInstance, } from "./server-components/runtime.js";
+export type { ComponentInstance, ComponentIsland, ComponentKey, ComponentOwner, ComponentRecord, ComponentRender, ComponentRenderContext, ComponentState, ComponentValue, PreparedServerComponent, ServerComponent, ServerComponentContext, ServerComponentDefinition, ServerComponentHandle, ServerComponentRenderAdapter, ServerComponentRuntime, } from "./server-components/types.js";
+//# sourceMappingURL=server-components.d.ts.map

package/dist/server-components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-components.d.ts","sourceRoot":"","sources":["../src/server-components.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,yBAAyB,EACzB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,mCAAmC,CAAA;AAC1C,OAAO,EAAE,KAAK,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAA;AAC5F,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,KAAK,uBAAuB,EAC5B,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,gCAAgC,CAAA;AACvC,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,cAAc,EACd,eAAe,EACf,eAAe,EACf,sBAAsB,EACtB,cAAc,EACd,cAAc,EACd,uBAAuB,EACvB,eAAe,EACf,sBAAsB,EACtB,yBAAyB,EACzB,qBAAqB,EACrB,4BAA4B,EAC5B,sBAAsB,GACvB,MAAM,8BAA8B,CAAA"}

package/dist/server-components.js

@@ -0,0 +1,4 @@
+export { defineServerComponent, inheritOwnerAuthorization, isServerComponent, prepareServerComponent, } from "./server-components/definition.js";
+export { ServerComponentError } from "./server-components/error.js";
+export { createServerComponents, defineComponentOwner, serverComponentIdentity, serverComponentInstance, } from "./server-components/runtime.js";
+//# sourceMappingURL=server-components.js.map

package/dist/server-components.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-components.js","sourceRoot":"","sources":["../src/server-components.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,yBAAyB,EACzB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,mCAAmC,CAAA;AAC1C,OAAO,EAA2B,oBAAoB,EAAE,MAAM,8BAA8B,CAAA;AAC5F,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EAEpB,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,gCAAgC,CAAA"}

package/dist/service-worker.d.ts

@@ -13,6 +13,10 @@
  *   - **GET, same-origin, `ok`, and not `no-store`.** Anything else goes straight to the network.
  *   - **The cache name carries the build id.** A deploy that changed the assets gets a new cache, and
  *     activation deletes every older one, so a stale worker cannot pin an old build indefinitely.
+ *     Only caches named `<cacheName>:<buildId>` are the worker's: the origin's other caches - another
+ *     app's, or data the page stored itself - are never read, written or deleted.
+ *   - **Only this build's precached URLs are answered.** Every other request, an API call included,
+ *     goes to the network untouched.
  *
  * It is opt-in and generated at build time; an app that does not call this ships nothing.
  */
@@ -34,7 +38,10 @@ export interface ServiceWorkerOptions {
      * bytes. Omit it and failed navigations simply fail, which is the honest default.
      */
     readonly offlineUrl?: string;
-    /** Cache name prefix. Default `nifra`. */
+    /**
+     * Cache name prefix, and the namespace activation cleans: every cache named `<cacheName>:<id>` other
+     * than this build's is deleted. Give each worker sharing an origin its own. Default `nifra`.
+     */
     readonly cacheName?: string;
     /** Extra same-origin URLs to precache. Only pass immutable ones. */
     readonly additionalPrecache?: readonly string[];

package/dist/service-worker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service-worker.d.ts","sourceRoot":"","sources":["../src/service-worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,oGAAoG;AACpG,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACjC;AAED,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,0CAA0C;IAC1C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,oEAAoE;IACpE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAChD;AAuBD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,qBAAqB,EAC/B,OAAO,EAAE,oBAAoB,GAC5B,MAAM,CAiFR;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,SAAW,GAAG,MAAM,CAGtE"}
+{"version":3,"file":"service-worker.d.ts","sourceRoot":"","sources":["../src/service-worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,oGAAoG;AACpG,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACjC;AAED,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,oEAAoE;IACpE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAChD;AAuBD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,qBAAqB,EAC/B,OAAO,EAAE,oBAAoB,GAC5B,MAAM,CA2FR;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,SAAW,GAAG,MAAM,CAGtE"}

package/dist/service-worker.js

@@ -13,6 +13,10 @@
  *   - **GET, same-origin, `ok`, and not `no-store`.** Anything else goes straight to the network.
  *   - **The cache name carries the build id.** A deploy that changed the assets gets a new cache, and
  *     activation deletes every older one, so a stale worker cannot pin an old build indefinitely.
+ *     Only caches named `<cacheName>:<buildId>` are the worker's: the origin's other caches - another
+ *     app's, or data the page stored itself - are never read, written or deleted.
+ *   - **Only this build's precached URLs are answered.** Every other request, an API call included,
+ *     goes to the network untouched.
  *
  * It is opt-in and generated at build time; an app that does not call this ships nothing.
  */
@@ -62,8 +66,11 @@ export function generateServiceWorker(manifest, options) {
     // means the browser does not treat it as an update.
     const urls = [...new Set(offline === undefined ? precache : [...precache, offline])].sort();
     return `// Generated by @nifrajs/web/service-worker. Do not edit.
-const CACHE = ${JSON.stringify(`${prefix}-${options.buildId}`)}
+const OWNED = ${JSON.stringify(`${prefix}:`)}
+const CACHE = OWNED + ${JSON.stringify(options.buildId)}
 const PRECACHE = ${JSON.stringify(urls)}
+const OWN_URLS = new Set(PRECACHE)
+const OWN = { cacheName: CACHE }
 const OFFLINE = ${offline === undefined ? "null" : JSON.stringify(offline)}
 
 self.addEventListener("install", (event) => {
@@ -76,7 +83,9 @@ self.addEventListener("activate", (event) => {
   event.waitUntil(
     caches
       .keys()
-      .then((keys) => Promise.all(keys.filter((k) => k !== CACHE).map((k) => caches.delete(k))))
+      // Neither the prefix nor a build id can hold a colon, so the first one ends the namespace.
+      .then((keys) => keys.filter((k) => k !== CACHE && k.startsWith(OWNED)))
+      .then((old) => Promise.all(old.map((k) => caches.delete(k))))
       .then(() => self.clients.claim()),
   )
 })
@@ -91,20 +100,25 @@ self.addEventListener("fetch", (event) => {
   // how one user gets served the page rendered for another, so nothing is stored here.
   if (request.mode === "navigate") {
     if (OFFLINE === null) return
-    event.respondWith(fetch(request).catch(() => caches.match(OFFLINE).then((r) => r ?? Response.error())))
+    event.respondWith(
+      fetch(request).catch(() => caches.match(OFFLINE, OWN).then((r) => r ?? Response.error())),
+    )
     return
   }
 
-  // Assets: cache first, because every precached URL is content-hashed and therefore immutable.
+  // Assets: cache first, because every precached URL is content-hashed and therefore immutable. Only
+  // this build's URLs are answered, and only from this build's cache: every other request, an API
+  // call included, goes to the network, and another cache on the origin is never read.
+  if (!OWN_URLS.has(url.pathname)) return
   event.respondWith(
-    caches.match(request).then((hit) => {
+    caches.match(request, OWN).then((hit) => {
       if (hit !== undefined) return hit
       return fetch(request).then((response) => {
         const cacheable =
           response.ok &&
           response.type === "basic" &&
           !(response.headers.get("cache-control") ?? "").includes("no-store")
-        if (cacheable && PRECACHE.includes(url.pathname)) {
+        if (cacheable) {
           const copy = response.clone()
           void caches.open(CACHE).then((c) => c.put(request, copy))
         }