fix(ssr): preserve pinned module transport after #3290

src/modules/server/module-server.test.ts

@@ -2486,12 +2486,11 @@ describe({ name: "serveModule", sanitizeResources: false, sanitizeOps: false },
           ssrParentUrl.searchParams.set("ssr", "true");
           const ssrParentResponse = await serve(new Request(ssrParentUrl), projectDir);
           assertEquals(ssrParentResponse.status, 200);
-          for (const childName of ["Absolute.js", "Protocol.js"]) {
-            const childFetch = nestedFetches.find((href) =>
-              new URL(href).pathname.endsWith(`/shared/${childName}`)
-            );
-            assertEquals(childFetch !== undefined, true);
-            const childUrl = new URL(childFetch!);
+          const ssrParentCode = await ssrParentResponse.text();
+          assertStringIncludes(ssrParentCode, absolutePath);
+          assertStringIncludes(ssrParentCode, protocolPath);
+          for (const childFetch of nestedFetches) {
+            const childUrl = new URL(childFetch);
             assertEquals(childUrl.searchParams.get("ssr"), "true");
             assertEquals(childUrl.searchParams.get("pins"), snapshot.cacheKey);
           }

src/rendering/factories/service-factories.ts

@@ -80,6 +80,7 @@ export function createPageRenderer(
     componentRegistry,
     compileMDX,
     moduleServerUrl: ctx.moduleServerUrl,
+    isLocalProject: ctx.isLocalProject === true,
   });
 }
 

src/rendering/layouts/layout-applicator.ts

@@ -56,6 +56,8 @@ export interface LayoutApplicationOptions {
   dependencyPinningCacheKey?: string;
   dependencyPinningDependencies?: Readonly<Record<string, string>>;
   dependencyPinningSource?: DependencyPinningSourceInput;
+  /** Server-trusted local-project identity. */
+  isLocalProject?: boolean;
 }
 
 export class LayoutApplicator {
@@ -78,6 +80,7 @@ export class LayoutApplicator {
   private readonly dependencyPinningCacheKey?: string;
   private readonly dependencyPinningDependencies?: Readonly<Record<string, string>>;
   private readonly dependencyPinningSource?: DependencyPinningSourceInput;
+  private readonly isLocalProject: boolean;
   private reactVersionPromise: Promise<string> | null = null;
   private frameworkProviderModulesPromise?: Promise<{
     PageContextProvider: BundledReact.ComponentType<Record<string, unknown>>;
@@ -104,6 +107,7 @@ export class LayoutApplicator {
     this.dependencyPinningCacheKey = options.dependencyPinningCacheKey;
     this.dependencyPinningDependencies = options.dependencyPinningDependencies;
     this.dependencyPinningSource = options.dependencyPinningSource;
+    this.isLocalProject = options.isLocalProject === true;
   }
 
   private getReactVersion(): Promise<string> {
@@ -288,6 +292,7 @@ export class LayoutApplicator {
             this.dependencyPinningDependencies,
             this.dependencyPinningSource,
             this.requestUrl?.origin,
+            this.isLocalProject,
           );
         }
 

src/rendering/layouts/utils/applicator.ts

@@ -33,6 +33,7 @@ export function applyLayoutsESM(
   dependencyPinningDependencies?: Readonly<Record<string, string>>,
   dependencyPinningSource?: DependencyPinningSourceInput,
   moduleServerOrigin?: string,
+  isLocalProject?: boolean,
 ): Promise<BundledReact.ReactElement> {
   return withSpan(
     SpanNames.LAYOUT_APPLY_LAYOUTS_ESM,
@@ -83,6 +84,7 @@ export function applyLayoutsESM(
                   dependencyPinningDependencies,
                   dependencyPinningSource,
                   moduleServerOrigin,
+                  isLocalProject,
                 ),
               spanAttrs,
             );
@@ -145,6 +147,7 @@ export function applyLayoutsESM(
             dependencyPinningDependencies,
             dependencyPinningSource,
             moduleServerOrigin,
+            isLocalProject,
           ),
         { "layout.kind": "mdx", "layout.type": "named" },
       );

src/rendering/layouts/utils/component-loader.ts

@@ -346,6 +346,7 @@ export function loadMDXLayout(
   dependencyPinningDependencies?: Readonly<Record<string, string>>,
   dependencyPinningSource?: DependencyPinningSourceInput,
   moduleServerOrigin?: string,
+  isLocalProject?: boolean,
 ): Promise<BundledReact.ComponentType<{ components?: MDXComponents }> | undefined> {
   return withSpan(
     SpanNames.LAYOUT_LOAD_MDX,
@@ -378,6 +379,7 @@ export function loadMDXLayout(
         dependencyPinningDependencies,
         dependencyPinningSource,
         moduleServerOrigin,
+        isLocalProject,
       )) as MDXModule;
 
       loadMdxLayoutLog.debug("loadModuleESM DONE", {
@@ -408,6 +410,7 @@ export async function preloadMDXLayoutModule(
   dependencyPinningDependencies?: Readonly<Record<string, string>>,
   dependencyPinningSource?: DependencyPinningSourceInput,
   moduleServerOrigin?: string,
+  isLocalProject?: boolean,
 ): Promise<void> {
   await loadMDXLayout(
     bundle,
@@ -422,6 +425,7 @@ export async function preloadMDXLayoutModule(
     dependencyPinningDependencies,
     dependencyPinningSource,
     moduleServerOrigin,
+    isLocalProject,
   );
 }
 
@@ -508,6 +512,7 @@ export async function applyMDXLayout(
   dependencyPinningDependencies?: Readonly<Record<string, string>>,
   dependencyPinningSource?: DependencyPinningSourceInput,
   moduleServerOrigin?: string,
+  isLocalProject?: boolean,
 ): Promise<BundledReact.ReactElement> {
   const React = await getProjectReact(reactVersion);
   const LayoutFn = await loadMDXLayout(
@@ -523,6 +528,7 @@ export async function applyMDXLayout(
     dependencyPinningDependencies,
     dependencyPinningSource,
     moduleServerOrigin,
+    isLocalProject,
   );
 
   if (!LayoutFn) {

src/rendering/orchestrator/layout.test.ts

@@ -0,0 +1,50 @@
+import "#veryfront/schemas/_test-setup.ts";
+import { assertEquals } from "#veryfront/testing/assert.ts";
+import { describe, it } from "#veryfront/testing/bdd.ts";
+import { createMockAdapter } from "#veryfront/platform/adapters/mock.ts";
+import { mdxRenderer } from "#veryfront/transforms/mdx/index.ts";
+import type { LayoutItem } from "#veryfront/types";
+import { LayoutOrchestrator } from "./layout.ts";
+
+describe("rendering/orchestrator/layout", () => {
+  it("threads the trusted local-project identity through MDX layout preloading", async () => {
+    const originalLoadModuleESM = mdxRenderer.loadModuleESM;
+    const mutableRenderer = mdxRenderer as unknown as {
+      loadModuleESM: typeof mdxRenderer.loadModuleESM;
+    };
+    let observedIsLocalProject: unknown;
+    mutableRenderer.loadModuleESM = ((...args: unknown[]) => {
+      observedIsLocalProject = args[11];
+      return Promise.resolve({ default: () => null });
+    }) as typeof mdxRenderer.loadModuleESM;
+
+    const orchestrator = new LayoutOrchestrator({
+      projectDir: "/project",
+      projectId: "local-project",
+      projectSlug: "local-project",
+      contentSourceId: "local-main",
+      adapter: createMockAdapter(),
+      config: { react: { version: "19.1.1" } },
+      mode: "development",
+      layoutCollector: {} as never,
+      layoutCompiler: {} as never,
+      layoutCache: {} as never,
+      componentRegistry: {},
+      isLocalProject: true,
+    });
+    const layouts = [{
+      kind: "mdx",
+      path: "/project/layout.mdx",
+      bundle: { compiledCode: "export default function Layout() { return null; }" },
+    }] as LayoutItem[];
+
+    try {
+      const result = await orchestrator.preloadLayoutModules(layouts);
+
+      assertEquals(result.mdxSuccess, 1);
+      assertEquals(observedIsLocalProject, true);
+    } finally {
+      mutableRenderer.loadModuleESM = originalLoadModuleESM;
+    }
+  });
+});

src/rendering/orchestrator/layout.ts

@@ -33,6 +33,8 @@ export interface LayoutOrchestratorConfig {
   layoutCompiler: LayoutCompiler;
   layoutCache: LayoutComponentCache;
   componentRegistry: MDXComponents | ComponentRegistry;
+  /** Server-trusted local-project identity. */
+  isLocalProject?: boolean;
 }
 
 function isSnapshotAwareComponentRegistry(
@@ -249,6 +251,7 @@ export class LayoutOrchestrator {
                   dependencyPinningDependencies,
                   dependencyPinningSource,
                   moduleServerOrigin,
+                  this.config.isLocalProject === true,
                 );
                 return { type: "mdx" as const, path: layout.path, success: true };
               } catch (error) {
@@ -376,6 +379,7 @@ export class LayoutOrchestrator {
           dependencyPinningCacheKey,
           dependencyPinningDependencies,
           dependencyPinningSource,
+          isLocalProject: this.config.isLocalProject === true,
         });
 
         const pageType = pageElement.type;

src/rendering/orchestrator/lifecycle.ts

@@ -38,6 +38,8 @@ export interface LifecycleOptions {
   projectId?: string;
   /** Content source identifier for cache isolation (branch or release) */
   contentSourceId?: string;
+  /** Server-trusted local-project identity. */
+  isLocalProject?: boolean;
   /** Injectable factory for testing — bypasses real service construction */
   servicesFactory?: (adapter: RuntimeAdapter) => RendererServices;
 }
@@ -62,6 +64,7 @@ export class RendererLifecycle {
   private moduleServerUrl?: string;
   private projectId?: string;
   private contentSourceId?: string;
+  private isLocalProject: boolean;
   private services?: RendererServices;
   private adapter!: RuntimeAdapter;
   private servicesFactory?: (adapter: RuntimeAdapter) => RendererServices;
@@ -72,6 +75,7 @@ export class RendererLifecycle {
     this.moduleServerUrl = options.moduleServerUrl;
     this.projectId = options.projectId;
     this.contentSourceId = options.contentSourceId;
+    this.isLocalProject = options.isLocalProject === true;
     this.servicesFactory = options.servicesFactory;
   }
 
@@ -181,6 +185,7 @@ export class RendererLifecycle {
       componentRegistry,
       compileMDX: compileMDXProxy,
       moduleServerUrl: this.moduleServerUrl,
+      isLocalProject: this.isLocalProject,
     });
 
     const pageResolver = new PageResolver({

src/rendering/orchestrator/ssr.ts

@@ -90,6 +90,7 @@ export class VeryfrontRenderer {
           moduleServerUrl: this.moduleServerUrl,
           projectId: this.projectId,
           contentSourceId: this.contentSourceId,
+          isLocalProject: this.isLocalProject,
         });
         this.services = await this.lifecycle.initialize();
 
@@ -127,6 +128,7 @@ export class VeryfrontRenderer {
       layoutCompiler: this.services.layoutCompiler,
       layoutCache: createLayoutComponentCache(),
       componentRegistry: this.services.componentRegistry,
+      isLocalProject: this.isLocalProject,
     });
 
     this.htmlGenerator = new HTMLGenerator({

src/rendering/page-renderer.ts

@@ -58,6 +58,7 @@ export class PageRenderer {
     filePath?: string,
   ) => Promise<PageBundle>;
   private readonly moduleServerUrl?: string;
+  private readonly isLocalProject: boolean;
   private reactVersionPromise: Promise<string> | null = null;
 
   constructor(options: {
@@ -72,6 +73,8 @@ export class PageRenderer {
       filePath?: string,
     ) => Promise<PageBundle>;
     moduleServerUrl?: string;
+    /** Server-trusted local-project identity. */
+    isLocalProject?: boolean;
   }) {
     this.projectDir = options.projectDir;
     this.mode = options.mode;
@@ -80,6 +83,7 @@ export class PageRenderer {
     this.componentRegistry = options.componentRegistry;
     this.compileMDX = options.compileMDX;
     this.moduleServerUrl = options.moduleServerUrl;
+    this.isLocalProject = options.isLocalProject === true;
   }
 
   private async getMergedComponents(
@@ -266,6 +270,7 @@ export class PageRenderer {
                 dependencyPinningCacheKey: options?.dependencyPinningCacheKey,
                 dependencyPinningDependencies: options?.dependencyPinningDependencies,
                 dependencyPinningSource: options?.dependencyPinningSource,
+                isLocalProject: this.isLocalProject,
               },
             ),
           { "render.mdx_path": pageInfo.entity.path },

src/rendering/page-rendering.test.ts

@@ -7,6 +7,7 @@ import type { RuntimeAdapter } from "#veryfront/platform/adapters/base.ts";
 import { mdxRenderer } from "#veryfront/transforms/mdx/index.ts";
 import type { EntityInfo } from "#veryfront/types";
 import { handleMDXPage, prepareMDXPageBundles } from "./page-rendering.ts";
+import { PageRenderer } from "./page-renderer.ts";
 import {
   __setServerModuleLoaderForTests,
   resetReactCache,
@@ -188,4 +189,49 @@ describe("rendering/page-rendering", () => {
       mutableRenderer.loadModuleESM = originalLoadModuleESM;
     }
   });
+
+  it("threads the trusted local-project identity from PageRenderer into MDX loading", async () => {
+    __setServerModuleLoaderForTests(() => Promise.resolve({ default: React }));
+
+    const originalLoadModuleESM = mdxRenderer.loadModuleESM;
+    const mutableRenderer = mdxRenderer as unknown as {
+      loadModuleESM: typeof mdxRenderer.loadModuleESM;
+    };
+    let observedIsLocalProject: unknown;
+    mutableRenderer.loadModuleESM = ((...args: unknown[]) => {
+      observedIsLocalProject = args[11];
+      return Promise.resolve({ default: () => null });
+    }) as typeof mdxRenderer.loadModuleESM;
+
+    const renderer = new PageRenderer({
+      projectDir: "/project",
+      mode: "development",
+      config: { react: { version: "19.1.1" } },
+      adapter: { fs: {} } as unknown as RuntimeAdapter,
+      componentRegistry: {
+        prepareDependencySnapshot: () => Promise.resolve("off"),
+        getAllAsComponents: () => ({}),
+      } as never,
+      compileMDX: async () => ({ compiledCode: "", frontmatter: {}, headings: [] }),
+      isLocalProject: true,
+    });
+
+    try {
+      await renderer.preparePageBundles(
+        createMDXPageInfo("# Local MDX probe"),
+        "probe",
+        undefined,
+        {
+          projectId: "local-project",
+          projectSlug: "local-project",
+          contentSourceId: "local-main",
+          url: new URL("http://localhost/probe"),
+        },
+      );
+
+      assertEquals(observedIsLocalProject, true);
+    } finally {
+      mutableRenderer.loadModuleESM = originalLoadModuleESM;
+    }
+  });
 });

src/rendering/page-rendering.ts

@@ -156,6 +156,8 @@ export function handleMDXPage(
     dependencyPinningDependencies?: Readonly<Record<string, string>>;
     /** Exact package source namespace paired with the immutable snapshot. */
     dependencyPinningSource?: DependencyPinningSourceInput;
+    /** Server-trusted local-project identity for dev-only module-server fallback. */
+    isLocalProject?: boolean;
   },
 ): Promise<MDXPageResult> {
   return withSpan(
@@ -182,6 +184,7 @@ export function handleMDXPage(
           options?.dependencyPinningDependencies,
           options?.dependencyPinningSource,
           options?.url?.origin,
+          options?.isLocalProject,
         )) as MDXModule;
 
         const MDXComp = mod.MDXContent || mod.default;

src/rendering/renderer.ts

@@ -1172,6 +1172,7 @@ export class Renderer {
       layoutCompiler,
       layoutCache: this.layoutComponentCache,
       componentRegistry,
+      isLocalProject: ctx.isLocalProject === true,
     });
 
     const htmlGenerator = new HTMLGenerator({