veryfront 0.1.1047 → 0.1.1049

package/esm/src/server/services/rsc/orchestrators/manifest-handler.js

@@ -6,31 +6,83 @@
  *
  * @module server/services/rsc/orchestrators/manifest-handler
  */
-import { RSC_MANIFEST_CACHE_TTL_MS } from "../../../../utils/index.js";
+import { HASH_SEED_DJB2, RSC_MANIFEST_CACHE_TTL_MS } from "../../../../utils/index.js";
 import { buildClientManifest } from "../../../../rendering/rsc/component-analyzer.js";
+import { appendClientModuleVersion, buildClientModuleUrl, } from "../../../../rendering/rsc/client-module-strategy.js";
 /** TTL in seconds for external cache repository */
 const MANIFEST_CACHE_TTL_SECONDS = Math.floor(RSC_MANIFEST_CACHE_TTL_MS / 1000);
 /** Cache key for manifest data */
-const MANIFEST_CACHE_KEY = "rsc-manifest";
 export class ManifestHandler {
     projectDir;
     cache = null;
+    generation = 0;
+    inFlightBuild = null;
+    cacheMutation = Promise.resolve();
     cacheRepo;
+    appDir;
+    isLocalProject;
+    cacheKey;
+    fs;
     constructor(projectDir, options) {
         this.projectDir = projectDir;
         this.cacheRepo = options?.cacheRepo;
+        this.appDir = options?.appDir ?? "app";
+        this.isLocalProject = options?.isLocalProject ?? true;
+        this.fs = options?.fs;
+        this.cacheKey = [
+            "rsc-manifest",
+            this.isLocalProject ? "local" : "remote",
+            this.appDir,
+            options?.contentSourceId ?? "default",
+        ].join(":");
     }
     async handle(clientManifest) {
-        const cachedData = await this.getCachedData();
-        if (cachedData)
-            return this.createResponse(cachedData);
+        while (true) {
+            const generation = this.generation;
+            await this.cacheMutation;
+            if (generation !== this.generation)
+                continue;
+            const cachedData = await this.getCachedData();
+            if (generation !== this.generation)
+                continue;
+            if (cachedData)
+                return this.createResponse(cachedData);
+            const data = await this.getOrStartBuild(clientManifest, generation);
+            if (generation !== this.generation)
+                continue;
+            return this.createResponse(data);
+        }
+    }
+    getOrStartBuild(clientManifest, generation) {
+        if (this.inFlightBuild?.generation === generation)
+            return this.inFlightBuild.promise;
+        const promise = this.buildAndPublish(clientManifest, generation);
+        this.inFlightBuild = { generation, promise };
+        const clearBuild = () => {
+            if (this.inFlightBuild?.promise === promise)
+                this.inFlightBuild = null;
+        };
+        void promise.then(clearBuild, clearBuild);
+        return promise;
+    }
+    async buildAndPublish(clientManifest, generation) {
         const data = await this.buildManifest(clientManifest);
-        await this.setCachedData(data);
-        return this.createResponse(data);
+        if (generation !== this.generation)
+            return data;
+        await this.enqueueCacheMutation(async () => {
+            if (generation !== this.generation)
+                return;
+            await this.setCachedData(data);
+            if (generation === this.generation)
+                return;
+            this.cache = null;
+            await this.cacheRepo?.delete?.(this.cacheKey);
+        });
+        return data;
     }
     async getCachedData() {
         if (this.cacheRepo) {
-            const cached = await this.cacheRepo.get(MANIFEST_CACHE_KEY);
+            const cached = await this.cacheRepo.get(this.cacheKey);
             return cached ? JSON.parse(cached) : null;
         }
         if (!this.isCacheValid())
@@ -39,7 +91,7 @@ export class ManifestHandler {
     }
     async setCachedData(data) {
         if (this.cacheRepo) {
-            await this.cacheRepo.set(MANIFEST_CACHE_KEY, JSON.stringify(data), MANIFEST_CACHE_TTL_SECONDS);
+            await this.cacheRepo.set(this.cacheKey, JSON.stringify(data), MANIFEST_CACHE_TTL_SECONDS);
             return;
         }
         this.cache = { data, timestamp: Date.now() };
@@ -48,12 +100,53 @@ export class ManifestHandler {
         return this.cache !== null && Date.now() - this.cache.timestamp < RSC_MANIFEST_CACHE_TTL_MS;
     }
     async buildManifest(clientManifest) {
-        const manifest = clientManifest ?? (await buildClientManifest(this.projectDir));
+        const manifest = clientManifest ??
+            (await buildClientManifest(this.projectDir, this.appDir, this.fs));
         const components = {};
-        for (const [id, meta] of manifest) {
-            components[id] = meta.path;
+        const modules = [];
+        const graphIds = { client: [], server: [] };
+        const contentVersions = [];
+        for (const [id, meta] of [...manifest].sort(([a], [b]) => a.localeCompare(b))) {
+            const rel = meta.rel;
+            if (!this.isLocalProject && !rel) {
+                throw new Error(`Client component ${id} is missing its project-relative module path`);
+            }
+            const moduleUrl = this.isLocalProject
+                ? appendClientModuleVersion(meta.path, meta.contentHash)
+                : buildClientModuleUrl({
+                    strategy: "rsc-module",
+                    rel: rel,
+                    version: meta.contentHash,
+                });
+            if (!moduleUrl) {
+                throw new Error(`Client component ${id} has an invalid project-relative module path`);
+            }
+            const exportName = meta.exports.includes(id)
+                ? id
+                : meta.exports.includes("default")
+                    ? "default"
+                    : meta.exports[0] ?? "default";
+            const graphRel = rel ?? meta.path;
+            contentVersions.push(`${id}:${meta.contentHash ?? ""}`);
+            components[id] = moduleUrl;
+            modules.push({
+                id,
+                clientRef: `${moduleUrl}#${exportName}`,
+                exports: meta.exports,
+            });
+            graphIds.client.push({
+                id,
+                path: this.isLocalProject ? (meta.sourcePath ?? meta.path) : graphRel,
+                rel: graphRel,
+            });
         }
-        return { components };
+        return {
+            version: 1,
+            hash: hashManifest(graphIds.client, modules, contentVersions),
+            components,
+            modules,
+            graphIds,
+        };
     }
     createResponse(data) {
         return new Response(JSON.stringify(data), {
@@ -65,7 +158,24 @@ export class ManifestHandler {
      * Useful for testing or forcing rebuild.
      */
     clearCache() {
+        this.generation++;
+        this.inFlightBuild = null;
         this.cache = null;
-        void this.cacheRepo?.delete?.(MANIFEST_CACHE_KEY);
+        void this.enqueueCacheMutation(async () => {
+            this.cache = null;
+            await this.cacheRepo?.delete?.(this.cacheKey);
+        });
+    }
+    enqueueCacheMutation(operation) {
+        const mutation = this.cacheMutation.then(operation, operation);
+        this.cacheMutation = mutation.then(() => undefined, () => undefined);
+        return mutation;
     }
 }
+function hashManifest(graphIds, modules, contentVersions) {
+    const bytes = new TextEncoder().encode(JSON.stringify({ graphIds, modules, contentVersions }));
+    let hash = HASH_SEED_DJB2;
+    for (const byte of bytes)
+        hash = ((hash << 5) + hash) ^ byte;
+    return (hash >>> 0).toString(16);
+}

package/esm/src/server/services/rsc/orchestrators/page-handler.d.ts

@@ -1,4 +1,9 @@
+import type { ClientModuleStrategy } from "../../../../rendering/rsc/client-module-strategy.js";
 export declare class PageHandler {
+    private readonly isDevelopment;
+    private readonly reactVersion?;
+    private readonly clientModuleStrategy?;
+    constructor(isDevelopment?: boolean, reactVersion?: string | undefined, clientModuleStrategy?: ClientModuleStrategy | undefined);
     handle(pathname: string, searchParams: URLSearchParams, nonce?: string): Response;
     private buildHtml;
 }

package/esm/src/server/services/rsc/orchestrators/page-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"page-handler.d.ts","sourceRoot":"","sources":["../../../../../../src/src/server/services/rsc/orchestrators/page-handler.ts"],"names":[],"mappings":"AAwBA,qBAAa,WAAW;IACtB,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,eAAe,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ;IAQjF,OAAO,CAAC,SAAS;CAmDlB"}
+{"version":3,"file":"page-handler.d.ts","sourceRoot":"","sources":["../../../../../../src/src/server/services/rsc/orchestrators/page-handler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qDAAqD,CAAC;AAwBhG,qBAAa,WAAW;IAEpB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;IAC9B,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC;gBAFrB,aAAa,GAAE,OAAe,EAC9B,YAAY,CAAC,EAAE,MAAM,YAAA,EACrB,oBAAoB,CAAC,EAAE,oBAAoB,YAAA;IAG9D,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,eAAe,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ;IAQjF,OAAO,CAAC,SAAS;CAwDlB"}

package/esm/src/server/services/rsc/orchestrators/page-handler.js

@@ -1,5 +1,6 @@
 import { buildNonceAttribute } from "../../../../html/html-escape.js";
 import { buildTrustedHtmlValidatorScript } from "../../../../security/client/html-sanitizer.js";
+import { HYDRATION_DATA_ID } from "../../../../rendering/rsc/constants.js";
 /**
  * Serialize a value as a JSON string literal that is safe to embed inside an
  * inline HTML <script>. JSON already escapes quotes, backslashes, and control
@@ -21,6 +22,14 @@ function jsonForScript(value) {
         .replace(/\u2029/g, "\\u2029");
 }
 export class PageHandler {
+    isDevelopment;
+    reactVersion;
+    clientModuleStrategy;
+    constructor(isDevelopment = false, reactVersion, clientModuleStrategy) {
+        this.isDevelopment = isDevelopment;
+        this.reactVersion = reactVersion;
+        this.clientModuleStrategy = clientModuleStrategy;
+    }
     handle(pathname, searchParams, nonce) {
         const html = this.buildHtml(pathname, searchParams, nonce);
         return new Response(html, {
@@ -33,13 +42,19 @@ export class PageHandler {
         const nonceAttr = buildNonceAttribute(nonce);
         const renderUrlJs = jsonForScript(renderUrl);
         const trustedHtmlValidatorScript = buildTrustedHtmlValidatorScript();
+        const hydrationData = jsonForScript({
+            clientModuleStrategy: this.clientModuleStrategy,
+            dev: this.isDevelopment,
+            reactVersion: this.reactVersion,
+        });
         return `<!DOCTYPE html>
 <html lang="en">
 <head>
   <meta charset="UTF-8"/>
   <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
   <title>Veryfront RSC</title>
-  <script${nonceAttr}>window.__VERYFRONT_DEV__ = true;</script>
+  <script id="${HYDRATION_DATA_ID}" type="application/json"${nonceAttr}>${hydrationData}</script>
+  <script${nonceAttr}>window.__VERYFRONT_DEV__ = ${this.isDevelopment};</script>
 </head>
 <body>
   <div id="rsc-root"></div>
@@ -61,7 +76,6 @@ export class PageHandler {
       const renderUrl = ${renderUrlJs};
       const payload =
         (await fetchPayload(renderUrl)) ??
-        (await fetchPayload('/_veryfront/rsc/payload')) ??
         { html: '<p>RSC unavailable</p>', clientRefs: [] };
 
       const safeHtml = validateTrustedHtml(String(payload.html || ''));

package/esm/src/server/services/rsc/orchestrators/render-handler.d.ts

@@ -1,11 +1,22 @@
 import type { RSCRenderer } from "../../../../rendering/rsc/server-renderer/index.js";
+import type { RuntimeAdapter } from "../../../../platform/adapters/base.js";
+interface RenderHandlerModuleOptions {
+    adapter?: RuntimeAdapter;
+    projectId?: string;
+    projectSlug?: string;
+    contentSourceId?: string;
+    reactVersion?: Promise<string>;
+}
 export declare class RenderHandler {
     private projectDir;
     private getRenderer;
-    private isLocalProject;
-    constructor(projectDir: string, getRenderer: () => RSCRenderer | null, isLocalProject?: boolean);
+    private mode;
+    private appDir;
+    private moduleOptions;
+    constructor(projectDir: string, getRenderer: () => RSCRenderer | null, mode?: "development" | "production", appDir?: string, moduleOptions?: RenderHandlerModuleOptions);
     handle(pathname: string, searchParams: URLSearchParams, request?: Request): Promise<Response>;
     private loadComponent;
+    private loadComponentModule;
     private buildProps;
     private renderPayload;
     private createResponse;
@@ -13,4 +24,5 @@ export declare class RenderHandler {
     private buildHeaders;
     private createErrorResponse;
 }
+export {};
 //# sourceMappingURL=render-handler.d.ts.map

package/esm/src/server/services/rsc/orchestrators/render-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render-handler.d.ts","sourceRoot":"","sources":["../../../../../../src/src/server/services/rsc/orchestrators/render-handler.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oDAAoD,CAAC;AAWtF,qBAAa,aAAa;IAEtB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,cAAc;gBAFd,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,WAAW,GAAG,IAAI,EACrC,cAAc,GAAE,OAAe;IAGnC,MAAM,CACV,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,eAAe,EAC7B,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,QAAQ,CAAC;YAWN,aAAa;IA0B3B,OAAO,CAAC,UAAU;YAOJ,aAAa;IA2B3B,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,YAAY;IAmBpB,OAAO,CAAC,mBAAmB;CA6B5B"}
+{"version":3,"file":"render-handler.d.ts","sourceRoot":"","sources":["../../../../../../src/src/server/services/rsc/orchestrators/render-handler.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oDAAoD,CAAC;AAQtF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAM5E,UAAU,0BAA0B;IAClC,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;CAChC;AASD,qBAAa,aAAa;IAEtB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,aAAa;gBAJb,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,WAAW,GAAG,IAAI,EACrC,IAAI,GAAE,aAAa,GAAG,YAA2B,EACjD,MAAM,GAAE,MAAc,EACtB,aAAa,GAAE,0BAA+B;IAGlD,MAAM,CACV,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,eAAe,EAC7B,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,QAAQ,CAAC;YAWN,aAAa;YA+Bb,mBAAmB;IA2CjC,OAAO,CAAC,UAAU;YAOJ,aAAa;IA2B3B,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,YAAY;IAmBpB,OAAO,CAAC,mBAAmB;CA6B5B"}

package/esm/src/server/services/rsc/orchestrators/render-handler.js

@@ -5,15 +5,27 @@ import { COMPONENT_ERROR, PAGE_NOT_FOUND, RENDER_ERROR } from "../../../../error
 import { createErrorResponse } from "../../../../errors/http-error.js";
 import { wrapUnknownError } from "../../../../errors/middleware/wrap-unknown.js";
 import { extractParams, resolveComponentPath } from "./component-resolver.js";
+import { createFileSystem } from "../../../../platform/compat/fs.js";
+import { loadModuleFromSource } from "../../../../modules/react-loader/index.js";
+import { compileContent, extractFrontmatter } from "../../../../transforms/mdx/compiler/index.js";
+import { mdxRenderer } from "../../../../transforms/mdx/index.js";
 const logger = serverLogger.component("rsc");
+const fs = createFileSystem();
+function isContentComponent(componentPath) {
+    return /\.(?:md|mdx)$/i.test(componentPath);
+}
 export class RenderHandler {
     projectDir;
     getRenderer;
-    isLocalProject;
-    constructor(projectDir, getRenderer, isLocalProject = false) {
+    mode;
+    appDir;
+    moduleOptions;
+    constructor(projectDir, getRenderer, mode = "production", appDir = "app", moduleOptions = {}) {
         this.projectDir = projectDir;
         this.getRenderer = getRenderer;
-        this.isLocalProject = isLocalProject;
+        this.mode = mode;
+        this.appDir = appDir;
+        this.moduleOptions = moduleOptions;
     }
     async handle(pathname, searchParams, request) {
         try {
@@ -27,14 +39,14 @@ export class RenderHandler {
         }
     }
     async loadComponent(pathname) {
-        const componentPath = await resolveComponentPath(pathname, this.projectDir);
+        const componentPath = await resolveComponentPath(pathname, this.projectDir, this.moduleOptions.adapter?.fs, this.appDir);
         if (!componentPath) {
             throw toError(createError({
                 type: "render",
                 message: "Component not found",
             }));
         }
-        const module = (await import(componentPath));
+        const module = await this.loadComponentModule(componentPath);
         const Component = (module.default ?? module.Page ?? module);
         if (typeof Component !== "function") {
             throw toError(createError({
@@ -44,6 +56,29 @@ export class RenderHandler {
         }
         return Component;
     }
+    async loadComponentModule(componentPath) {
+        const adapter = this.moduleOptions.adapter;
+        if (isContentComponent(componentPath)) {
+            const source = adapter
+                ? await adapter.fs.readFile(componentPath)
+                : await fs.readTextFile(componentPath);
+            const { body, frontmatter } = extractFrontmatter(source);
+            const compiled = await compileContent(this.mode, this.projectDir, body, frontmatter, componentPath, "server");
+            return await mdxRenderer.loadModuleESM(compiled.compiledCode, adapter, this.moduleOptions.projectId ?? this.projectDir, this.projectDir, this.moduleOptions.projectSlug, this.moduleOptions.contentSourceId, await this.moduleOptions.reactVersion);
+        }
+        if (!adapter) {
+            return (await import(componentPath));
+        }
+        const source = await adapter.fs.readFile(componentPath);
+        return await loadModuleFromSource(source, componentPath, this.projectDir, adapter, {
+            projectId: this.moduleOptions.projectId ?? this.projectDir,
+            projectSlug: this.moduleOptions.projectSlug,
+            contentSourceId: this.moduleOptions.contentSourceId,
+            dev: this.mode === "development",
+            mode: this.mode === "development" ? "preview" : "production",
+            reactVersion: await this.moduleOptions.reactVersion,
+        });
+    }
     buildProps(pathname, searchParams) {
         return {
             params: extractParams(pathname),
@@ -65,7 +100,7 @@ export class RenderHandler {
                 message: "Failed to render RSC payload",
             }));
         }
-        return this.isLocalProject ? payload : RSCProductionOptimizer.optimizePayload(payload);
+        return this.mode === "development" ? payload : RSCProductionOptimizer.optimizePayload(payload);
     }
     createResponse(payload, request) {
         const etag = RSCProductionOptimizer.generateETag(payload);
@@ -80,7 +115,7 @@ export class RenderHandler {
         return RSCProductionOptimizer.checkETag(request.headers.get("if-none-match"), etag);
     }
     buildHeaders(etag) {
-        const isProd = !this.isLocalProject;
+        const isProd = this.mode === "production";
         const headers = {
             "content-type": "application/json",
             etag,

package/esm/src/server/services/rsc/orchestrators/types.d.ts

@@ -1,6 +1,25 @@
 import type { ClientComponentMeta } from "../../../../rendering/rsc/types.js";
 export interface ManifestData {
+    version: 1;
+    hash: string;
     components: Record<string, string>;
+    modules: Array<{
+        id: string;
+        clientRef: string;
+        exports: string[];
+    }>;
+    graphIds: {
+        client: Array<{
+            id: string;
+            path: string;
+            rel: string;
+        }>;
+        server: Array<{
+            id: string;
+            path: string;
+            rel: string;
+        }>;
+    };
 }
 export interface ManifestCacheEntry {
     data: ManifestData;

package/esm/src/server/services/rsc/orchestrators/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/src/server/services/rsc/orchestrators/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAE9E,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,YAAY,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IACjD,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,aAAa,GAAG,YAAY,CAAC;CACpC;AAED,MAAM,WAAW,WAAY,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC1D,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/src/server/services/rsc/orchestrators/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAE9E,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,CAAC,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,OAAO,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACrE,QAAQ,EAAE;QACR,MAAM,EAAE,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACzD,MAAM,EAAE,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC1D,CAAC;CACH;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,YAAY,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IACjD,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,aAAa,GAAG,YAAY,CAAC;CACpC;AAED,MAAM,WAAW,WAAY,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC1D,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd"}

package/esm/src/server/shared/browser-module-availability.d.ts

@@ -0,0 +1,38 @@
+export interface BrowserModuleBuildCoordinatorOptions {
+    maxEntries?: number;
+    maxBytes?: number;
+    globalLimit?: number;
+    perProjectLimit?: number;
+}
+export interface BrowserModuleBuildRequest<T> {
+    cacheKey: string;
+    projectKey: string;
+    build: () => Promise<T>;
+    validate: (value: T) => Promise<boolean>;
+    sizeOf: (value: T) => number;
+}
+export interface BrowserModuleBuildResult<T> {
+    value: T;
+    status: "hit" | "miss" | "shared";
+}
+export declare class BrowserModuleCapacityError extends Error {
+    readonly name = "BrowserModuleCapacityError";
+    constructor();
+}
+/**
+ * Coordinates expensive browser-module builds without an unbounded wait queue.
+ * Map insertion order provides deterministic least-recently-used eviction.
+ */
+export declare class BrowserModuleBuildCoordinator<T> {
+    #private;
+    constructor(options?: BrowserModuleBuildCoordinatorOptions);
+    getOrBuild(request: BrowserModuleBuildRequest<T>): Promise<BrowserModuleBuildResult<T>>;
+    resetForTesting(): void;
+    getStatsForTesting(): {
+        cacheEntries: number;
+        cacheBytes: number;
+        inFlight: number;
+        activeGlobal: number;
+    };
+}
+//# sourceMappingURL=browser-module-availability.d.ts.map

package/esm/src/server/shared/browser-module-availability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-module-availability.d.ts","sourceRoot":"","sources":["../../../../src/src/server/shared/browser-module-availability.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oCAAoC;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,yBAAyB,CAAC,CAAC;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;IACxB,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,wBAAwB,CAAC,CAAC;IACzC,KAAK,EAAE,CAAC,CAAC;IACT,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;CACnC;AAYD,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,SAAkB,IAAI,gCAAgC;;CAKvD;AAED;;;GAGG;AACH,qBAAa,6BAA6B,CAAC,CAAC;;gBAY9B,OAAO,GAAE,oCAAyC;IAUxD,UAAU,CACd,OAAO,EAAE,yBAAyB,CAAC,CAAC,CAAC,GACpC,OAAO,CAAC,wBAAwB,CAAC,CAAC,CAAC,CAAC;IA6EvC,eAAe,IAAI,IAAI;IASvB,kBAAkB,IAAI;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;KACtB;CAgCF"}

package/esm/src/server/shared/browser-module-availability.js

@@ -0,0 +1,140 @@
+const DEFAULT_MAX_ENTRIES = 64;
+const DEFAULT_MAX_BYTES = 8 * 1024 * 1024;
+const DEFAULT_GLOBAL_LIMIT = 8;
+const DEFAULT_PER_PROJECT_LIMIT = 2;
+export class BrowserModuleCapacityError extends Error {
+    name = "BrowserModuleCapacityError";
+    constructor() {
+        super("Browser module build capacity is exhausted");
+    }
+}
+/**
+ * Coordinates expensive browser-module builds without an unbounded wait queue.
+ * Map insertion order provides deterministic least-recently-used eviction.
+ */
+export class BrowserModuleBuildCoordinator {
+    #maxEntries;
+    #maxBytes;
+    #globalLimit;
+    #perProjectLimit;
+    #cache = new Map();
+    #inFlight = new Map();
+    #activeByProject = new Map();
+    #cacheBytes = 0;
+    #activeGlobal = 0;
+    #generation = 0;
+    constructor(options = {}) {
+        this.#maxEntries = positiveInteger(options.maxEntries, DEFAULT_MAX_ENTRIES);
+        this.#maxBytes = positiveInteger(options.maxBytes, DEFAULT_MAX_BYTES);
+        this.#globalLimit = positiveInteger(options.globalLimit, DEFAULT_GLOBAL_LIMIT);
+        this.#perProjectLimit = positiveInteger(options.perProjectLimit, DEFAULT_PER_PROJECT_LIMIT);
+    }
+    async getOrBuild(request) {
+        const existingOperation = this.#inFlight.get(request.cacheKey);
+        if (existingOperation) {
+            return { value: (await existingOperation).value, status: "shared" };
+        }
+        const projectActive = this.#activeByProject.get(request.projectKey) ?? 0;
+        if (this.#activeGlobal >= this.#globalLimit ||
+            projectActive >= this.#perProjectLimit) {
+            throw new BrowserModuleCapacityError();
+        }
+        this.#activeGlobal++;
+        this.#activeByProject.set(request.projectKey, projectActive + 1);
+        const generation = this.#generation;
+        const operation = this.#validateOrBuild(request, generation);
+        this.#inFlight.set(request.cacheKey, operation);
+        try {
+            return await operation;
+        }
+        finally {
+            if (Object.is(this.#inFlight.get(request.cacheKey), operation)) {
+                this.#inFlight.delete(request.cacheKey);
+            }
+            if (generation === this.#generation) {
+                this.#activeGlobal = Math.max(0, this.#activeGlobal - 1);
+                const remaining = (this.#activeByProject.get(request.projectKey) ?? 1) - 1;
+                if (remaining > 0)
+                    this.#activeByProject.set(request.projectKey, remaining);
+                else
+                    this.#activeByProject.delete(request.projectKey);
+            }
+        }
+    }
+    async #validateOrBuild(request, generation) {
+        while (generation === this.#generation) {
+            const cached = this.#cache.get(request.cacheKey);
+            if (!cached)
+                break;
+            let valid = false;
+            try {
+                valid = await request.validate(cached.value);
+            }
+            catch {
+                valid = false;
+            }
+            if (generation !== this.#generation) {
+                return this.getOrBuild(request);
+            }
+            if (this.#cache.get(request.cacheKey) !== cached) {
+                continue;
+            }
+            if (valid) {
+                this.#cache.delete(request.cacheKey);
+                this.#cache.set(request.cacheKey, cached);
+                return { value: cached.value, status: "hit" };
+            }
+            this.#removeCached(request.cacheKey);
+            break;
+        }
+        if (generation !== this.#generation) {
+            return this.getOrBuild(request);
+        }
+        const value = await request.build();
+        if (generation === this.#generation) {
+            this.#store(request.cacheKey, value, request.sizeOf(value));
+        }
+        return { value, status: "miss" };
+    }
+    resetForTesting() {
+        this.#generation++;
+        this.#cache.clear();
+        this.#inFlight.clear();
+        this.#activeByProject.clear();
+        this.#cacheBytes = 0;
+        this.#activeGlobal = 0;
+    }
+    getStatsForTesting() {
+        return {
+            cacheEntries: this.#cache.size,
+            cacheBytes: this.#cacheBytes,
+            inFlight: this.#inFlight.size,
+            activeGlobal: this.#activeGlobal,
+        };
+    }
+    #store(cacheKey, value, rawSize) {
+        const size = Number.isFinite(rawSize) ? Math.max(0, Math.ceil(rawSize)) : Infinity;
+        this.#removeCached(cacheKey);
+        if (size > this.#maxBytes)
+            return;
+        this.#cache.set(cacheKey, { value, size });
+        this.#cacheBytes += size;
+        while (this.#cache.size > this.#maxEntries ||
+            this.#cacheBytes > this.#maxBytes) {
+            const oldestKey = this.#cache.keys().next().value;
+            if (oldestKey === undefined)
+                break;
+            this.#removeCached(oldestKey);
+        }
+    }
+    #removeCached(cacheKey) {
+        const existing = this.#cache.get(cacheKey);
+        if (!existing)
+            return;
+        this.#cache.delete(cacheKey);
+        this.#cacheBytes = Math.max(0, this.#cacheBytes - existing.size);
+    }
+}
+function positiveInteger(value, fallback) {
+    return Number.isSafeInteger(value) && (value ?? 0) > 0 ? value : fallback;
+}

package/esm/src/server/shared/browser-module-boundary.d.ts

@@ -0,0 +1,18 @@
+export type BrowserModuleBoundaryViolation = {
+    kind: "conflicting";
+} | {
+    kind: "module-server";
+} | {
+    kind: "function-server";
+} | {
+    kind: "parse-error";
+};
+/**
+ * Find server-only boundaries that cannot be emitted in a browser bundle.
+ * Function directive semantics belong to the active parser implementation so
+ * this check does not depend on one provider's AST shape. Syntax or parser
+ * capabilities that cannot be analyzed fail closed.
+ */
+export declare function inspectBrowserModuleBoundary(source: string, path: string): Promise<BrowserModuleBoundaryViolation | null>;
+export declare function describeBrowserModuleBoundaryViolation(violation: BrowserModuleBoundaryViolation): string;
+//# sourceMappingURL=browser-module-boundary.d.ts.map

package/esm/src/server/shared/browser-module-boundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-module-boundary.d.ts","sourceRoot":"","sources":["../../../../src/src/server/shared/browser-module-boundary.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,8BAA8B,GACtC;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GACvB;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,GACzB;IAAE,IAAI,EAAE,iBAAiB,CAAA;CAAE,GAC3B;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,CAAC;AAE5B;;;;;GAKG;AACH,wBAAsB,4BAA4B,CAChD,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,8BAA8B,GAAG,IAAI,CAAC,CAsBhD;AAED,wBAAgB,sCAAsC,CACpD,SAAS,EAAE,8BAA8B,GACxC,MAAM,CAWR"}