remote-components 0.4.3 → 0.4.5

package/dist/internal/host/server/types.d.ts

@@ -1,8 +1,10 @@
 import { RSC } from '../nextjs/dom-flight.js';
 import { ScriptDescriptor, LinkDescriptor } from '../shared/asset-descriptors.js';
+import { SharedModuleManifest, RemoteSharedModules } from '../shared/shared-broker.js';
 import { RemoteComponentMetadata } from '../../runtime/metadata.js';
 export { InternalResolveClientUrl, ResolveClientUrl } from '../../runtime/url/resolve-client-url.js';
 import 'parse5/dist/tree-adapters/default';
+import '../../utils/logger.js';
 
 interface NextData {
     props: {
@@ -11,6 +13,7 @@ interface NextData {
             bundle: string;
             runtime: string;
             shared?: Record<string, string>;
+            sharedManifest?: SharedModuleManifest;
         };
     };
     page?: string;
@@ -27,7 +30,7 @@ interface FetchRemoteComponentResponse {
     nextData: NextData | undefined;
     component: React.ReactNode | undefined;
     html: string;
-    remoteShared: Record<string, string>;
+    remoteShared: RemoteSharedModules;
 }
 
 export { FetchRemoteComponentResponse, NextData };

package/dist/internal/host/shared/pipeline.cjs

@@ -24,6 +24,7 @@ __export(pipeline_exports, {
   runPipelineFromParsed: () => runPipelineFromParsed
 });
 module.exports = __toCommonJS(pipeline_exports);
+var import_shared_broker = require("#internal/host/shared/shared-broker");
 var import_shared_module_resolver = require("#internal/host/shared/shared-module-resolver");
 var import_apply_origin = require("#internal/runtime/html/apply-origin");
 var import_parse_remote_html = require("#internal/runtime/html/parse-remote-html");
@@ -37,10 +38,9 @@ function preparePipeline(input) {
   const doc = parser.parseFromString(input.html, "text/html");
   const parsed = (0, import_parse_remote_html.parseRemoteComponentDocument)(doc, input.name, input.url);
   const remoteShared = input.remoteShared ?? parsed.remoteShared;
-  if ("__remote_components_missing_shared__" in remoteShared) {
-    throw new import_error.RemoteComponentsError(
-      remoteShared.__remote_components_missing_shared__
-    );
+  const missingSharedModulesMessage = (0, import_shared_broker.getMissingSharedModulesMessage)(remoteShared);
+  if (missingSharedModulesMessage) {
+    throw new import_error.RemoteComponentsError(missingSharedModulesMessage);
   }
   (0, import_apply_origin.applyOriginToNodes)(doc, input.url, input.resolveClientUrl);
   const scriptDescriptors = buildScriptDescriptors(parsed.scripts, input.url);
@@ -109,10 +109,9 @@ async function runPipelineFromParsed(input) {
       return { status: "aborted" };
     }
     const remoteShared = input.remoteShared ?? input.payload.remoteShared ?? {};
-    if ("__remote_components_missing_shared__" in remoteShared) {
-      throw new import_error.RemoteComponentsError(
-        remoteShared.__remote_components_missing_shared__
-      );
+    const missingSharedModulesMessage = (0, import_shared_broker.getMissingSharedModulesMessage)(remoteShared);
+    if (missingSharedModulesMessage) {
+      throw new import_error.RemoteComponentsError(missingSharedModulesMessage);
     }
     const result = await (0, import_component_loader.loadRemoteComponent)({
       url: input.url,

package/dist/internal/host/shared/pipeline.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/host/shared/pipeline.ts"],"sourcesContent":["import type { InternalResolveClientUrl } from '#internal/host/server/types';\nimport type { ScriptDescriptor } from '#internal/host/shared/asset-descriptors';\nimport type { ConsumeLoaderPayload } from '#internal/host/shared/server-handoff';\nimport { buildHostShared } from '#internal/host/shared/shared-module-resolver';\nimport { applyOriginToNodes } from '#internal/runtime/html/apply-origin';\nimport {\n  type ParsedRemoteComponent,\n  parseRemoteComponentDocument,\n} from '#internal/runtime/html/parse-remote-html';\nimport { loadRemoteComponent } from '#internal/runtime/loaders/component-loader';\nimport { loadStaticRemoteComponent } from '#internal/runtime/loaders/static-loader';\nimport type { RemoteComponentMetadata } from '#internal/runtime/metadata';\nimport {\n  collapseDoubleSlashes,\n  REMOTE_COMPONENT_REGEX,\n} from '#internal/runtime/patterns';\nimport type { MountOrUnmountFunction } from '#internal/runtime/types';\nimport { escapeString } from '#internal/utils';\nimport { RemoteComponentsError } from '#internal/utils/error';\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\ntype SharedModuleMap = Record<string, (bundle?: string) => Promise<unknown>>;\n\n/**\n * Input for {@link runPipeline} — the full post-fetch pipeline that starts\n * from raw HTML.\n */\nexport interface PipelineInput {\n  /** Resolved URL of the remote component. */\n  url: URL;\n  /** Raw HTML string returned by the remote. */\n  html: string;\n  /** Component name hint (may be refined during parsing). */\n  name: string;\n  /** Abort signal — the pipeline checks this between async steps. */\n  signal: AbortSignal;\n  /** Host-provided shared module factories (resolved or promise). */\n  shared: Promise<SharedModuleMap> | SharedModuleMap;\n  /** URL rewriter for client-side asset URLs. */\n  resolveClientUrl?: InternalResolveClientUrl;\n  /** Shadow root or element to mount into (for script-based components). */\n  container?: ShadowRoot | HTMLElement | null;\n}\n\n/**\n * Input for {@link runPipelineFromParsed} — the pipeline entry point for\n * hosts that receive pre-parsed SSR data (e.g. the App Router client).\n */\nexport interface ParsedPipelineInput {\n  /** Resolved URL of the remote component. */\n  url: URL;\n  /** Component name. */\n  name: string;\n  /** Abort signal. */\n  signal: AbortSignal;\n  /** Pre-resolved loader payload from the server component. */\n  payload: ConsumeLoaderPayload;\n  /** Host-provided shared module factories (resolved or promise). */\n  shared: Promise<SharedModuleMap> | SharedModuleMap;\n  /** Remote-requested shared modules. */\n  remoteShared?: Record<string, string>;\n  /** URL rewriter for client-side asset URLs. */\n  resolveClientUrl?: InternalResolveClientUrl;\n  /** Shadow root or element to mount into. */\n  container?: ShadowRoot | HTMLElement | null;\n  /** Optional RSC name override (used by App Router for scoped RSC data). */\n  rscName?: string;\n}\n\n/**\n * Successful dynamic component load — the component is a React element tree\n * ready to render.\n */\nexport interface PipelineLoaded {\n  status: 'loaded';\n  component: React.ReactNode;\n  metadata: RemoteComponentMetadata;\n  parsed: ParsedRemoteComponent;\n  doc: Document;\n}\n\n/**\n * Successful static component load — mount/unmount functions are returned\n * for the host to call.\n */\nexport interface PipelineStatic {\n  status: 'static';\n  mount: Set<MountOrUnmountFunction>;\n  unmount: Set<MountOrUnmountFunction>;\n  metadata: RemoteComponentMetadata;\n  parsed: ParsedRemoteComponent;\n  doc: Document;\n}\n\n/** The load was aborted before it could complete. */\nexport interface PipelineAborted {\n  status: 'aborted';\n}\n\n/** The load failed with an error. */\nexport interface PipelineError {\n  status: 'error';\n  error: Error;\n}\n\nexport type PipelineResult =\n  | PipelineLoaded\n  | PipelineStatic\n  | PipelineAborted\n  | PipelineError;\n\n/**\n * Intermediate result from {@link preparePipeline}. Hosts that need to run\n * framework-specific logic between parse and load (e.g. inline script\n * execution in the React host) use this to split the pipeline into two\n * phases.\n */\nexport interface PreparedPipeline {\n  doc: Document;\n  parsed: ParsedRemoteComponent;\n  /** Script descriptors ready to pass to `loadRemoteComponent`. */\n  scriptDescriptors: ScriptDescriptor[];\n}\n\n// ---------------------------------------------------------------------------\n// Pipeline phases\n// ---------------------------------------------------------------------------\n\n/**\n * Phase 1: Parse HTML, validate shared modules, and normalize URLs.\n *\n * This is the synchronous/cheap portion of the pipeline. Hosts that need to\n * inject logic between parse and load (e.g. executing inline scripts) call\n * this directly, then call {@link loadPrepared} when ready.\n */\nexport function preparePipeline(input: {\n  html: string;\n  name: string;\n  url: URL;\n  shared: SharedModuleMap;\n  remoteShared?: Record<string, string>;\n  resolveClientUrl?: InternalResolveClientUrl;\n}): PreparedPipeline {\n  const parser = new DOMParser();\n  const doc = parser.parseFromString(input.html, 'text/html');\n\n  const parsed = parseRemoteComponentDocument(doc, input.name, input.url);\n\n  // Validate shared modules — surface errors early before any script loading.\n  // Only check *remote* shared modules here. The host-side marker\n  // (`__remote_components_missing_shared__` in `input.shared`) is a callable\n  // error signal that the host may intentionally leave in place when\n  // `withRemoteComponentsConfig` is not used — blocking on it would break\n  // framework-agnostic hosts that don't configure shared modules.\n  const remoteShared = input.remoteShared ?? parsed.remoteShared;\n  if ('__remote_components_missing_shared__' in remoteShared) {\n    throw new RemoteComponentsError(\n      remoteShared.__remote_components_missing_shared__,\n    );\n  }\n\n  applyOriginToNodes(doc, input.url, input.resolveClientUrl);\n\n  const scriptDescriptors = buildScriptDescriptors(parsed.scripts, input.url);\n\n  return { doc, parsed, scriptDescriptors };\n}\n\n/**\n * Phase 2: Load the component from a prepared pipeline result.\n *\n * For dynamic components, delegates to `loadRemoteComponent`. For static\n * components (`isRemoteComponent`), delegates to `loadStaticRemoteComponent`.\n */\nexport async function loadPrepared(input: {\n  prepared: PreparedPipeline;\n  url: URL;\n  signal: AbortSignal;\n  shared: Promise<SharedModuleMap> | SharedModuleMap;\n  resolveClientUrl?: InternalResolveClientUrl;\n  container?: ShadowRoot | HTMLElement | null;\n  rscName?: string;\n}): Promise<PipelineResult> {\n  const { prepared, url, signal, resolveClientUrl, container, rscName } = input;\n  const { doc, parsed, scriptDescriptors } = prepared;\n\n  if (signal.aborted) {\n    return { status: 'aborted' };\n  }\n\n  const userShared = await input.shared;\n  if (signal.aborted) {\n    return { status: 'aborted' };\n  }\n\n  if (parsed.isRemoteComponent) {\n    return loadStaticPath({\n      parsed,\n      doc,\n      url,\n      resolveClientUrl,\n    });\n  }\n\n  return loadDynamicPath({\n    parsed,\n    doc,\n    url,\n    scriptDescriptors,\n    shared: userShared,\n    resolveClientUrl,\n    container,\n    rscName,\n  });\n}\n\n// ---------------------------------------------------------------------------\n// Full pipeline entry points\n// ---------------------------------------------------------------------------\n\n/**\n * Full post-fetch pipeline: parse → validate → normalize → load.\n *\n * Use this when starting from a raw HTML string (React host, HTML host).\n */\nexport async function runPipeline(\n  input: PipelineInput,\n): Promise<PipelineResult> {\n  try {\n    const userShared = await input.shared;\n    if (input.signal.aborted) {\n      return { status: 'aborted' };\n    }\n\n    const prepared = preparePipeline({\n      html: input.html,\n      name: input.name,\n      url: input.url,\n      shared: userShared,\n      resolveClientUrl: input.resolveClientUrl,\n    });\n\n    return await loadPrepared({\n      prepared,\n      url: input.url,\n      signal: input.signal,\n      shared: userShared,\n      resolveClientUrl: input.resolveClientUrl,\n      container: input.container,\n    });\n  } catch (error) {\n    return {\n      status: 'error',\n      error:\n        error instanceof Error\n          ? error\n          : new RemoteComponentsError(String(error)),\n    };\n  }\n}\n\n/**\n * Pipeline entry point for pre-parsed SSR data (App Router client).\n *\n * Skips HTML parsing and goes straight to `loadRemoteComponent` with the\n * pre-resolved payload from the server component.\n */\nexport async function runPipelineFromParsed(\n  input: ParsedPipelineInput,\n): Promise<\n  | { status: 'loaded'; component: React.ReactNode }\n  | PipelineAborted\n  | PipelineError\n> {\n  try {\n    if (input.signal.aborted) {\n      return { status: 'aborted' };\n    }\n\n    const remoteShared = input.remoteShared ?? input.payload.remoteShared ?? {};\n\n    if ('__remote_components_missing_shared__' in remoteShared) {\n      throw new RemoteComponentsError(\n        remoteShared.__remote_components_missing_shared__,\n      );\n    }\n\n    const result = await loadRemoteComponent({\n      url: input.url,\n      name: input.name,\n      rscName: input.rscName,\n      bundle: input.payload.bundle,\n      route: input.payload.route,\n      runtime: input.payload.runtime,\n      data: input.payload.data,\n      nextData: input.payload.nextData,\n      scripts: input.payload.scripts,\n      shared: input.shared,\n      remoteShared,\n      container: input.container,\n      resolveClientUrl: input.resolveClientUrl,\n    });\n\n    if (input.signal.aborted) {\n      return { status: 'aborted' };\n    }\n\n    if (result.error) {\n      return { status: 'error', error: result.error };\n    }\n    return { status: 'loaded', component: result.component };\n  } catch (error) {\n    return {\n      status: 'error',\n      error:\n        error instanceof Error\n          ? error\n          : new RemoteComponentsError(String(error)),\n    };\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Internal helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Converts parsed `<script>` elements into the `ScriptDescriptor[]` format\n * expected by `loadRemoteComponent`. Handles the `[bundle] id` URL format\n * and collapses double slashes.\n */\nfunction buildScriptDescriptors(\n  scripts: HTMLScriptElement[],\n  url: URL,\n): ScriptDescriptor[] {\n  return scripts.map((script) => {\n    const scriptSrc =\n      script.getAttribute('data-src') ||\n      script.getAttribute('src') ||\n      script.src;\n    const { prefix, id: path } = REMOTE_COMPONENT_REGEX.exec(scriptSrc)\n      ?.groups ?? {\n      prefix: undefined,\n      id: scriptSrc,\n    };\n    return {\n      src: new URL(collapseDoubleSlashes(`${prefix ?? ''}${path}`), url).href,\n    };\n  });\n}\n\nasync function loadStaticPath(input: {\n  parsed: ParsedRemoteComponent;\n  doc: Document;\n  url: URL;\n  resolveClientUrl?: InternalResolveClientUrl;\n}): Promise<PipelineStatic> {\n  const { parsed, doc, url, resolveClientUrl } = input;\n  const scripts = Array.from(\n    parsed.component.querySelectorAll<HTMLScriptElement>('script'),\n  );\n  const { mount, unmount } = await loadStaticRemoteComponent(\n    scripts,\n    url,\n    resolveClientUrl,\n  );\n  return {\n    status: 'static',\n    mount,\n    unmount,\n    metadata: parsed.metadata,\n    parsed,\n    doc,\n  };\n}\n\nasync function loadDynamicPath(input: {\n  parsed: ParsedRemoteComponent;\n  doc: Document;\n  url: URL;\n  scriptDescriptors: ScriptDescriptor[];\n  shared: SharedModuleMap;\n  resolveClientUrl?: InternalResolveClientUrl;\n  container?: ShadowRoot | HTMLElement | null;\n  rscName?: string;\n}): Promise<PipelineLoaded | PipelineError> {\n  const {\n    parsed,\n    doc,\n    url,\n    scriptDescriptors,\n    shared,\n    resolveClientUrl,\n    container,\n  } = input;\n\n  const rscName =\n    input.rscName ??\n    (parsed.rsc\n      ? `__remote_component_rsc_${escapeString(url.href)}_${escapeString(parsed.name)}`\n      : undefined);\n\n  const rscData = parsed.rsc\n    ? (parsed.rsc.textContent || '').split('\\n').filter(Boolean)\n    : [];\n\n  const result = await loadRemoteComponent({\n    url,\n    name: parsed.name,\n    rscName,\n    bundle: parsed.metadata.bundle,\n    route: parsed.metadata.route,\n    runtime: parsed.metadata.runtime,\n    data: rscData,\n    nextData: parsed.nextData,\n    scripts: scriptDescriptors,\n    shared: buildHostShared(shared, resolveClientUrl),\n    remoteShared: parsed.remoteShared,\n    container,\n    resolveClientUrl,\n  });\n\n  if (result.error) {\n    return { status: 'error', error: result.error };\n  }\n  return {\n    status: 'loaded',\n    component: result.component,\n    metadata: parsed.metadata,\n    parsed,\n    doc,\n  };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../../src/host/shared/pipeline.ts"],"sourcesContent":["import type { InternalResolveClientUrl } from '#internal/host/server/types';\nimport type { ScriptDescriptor } from '#internal/host/shared/asset-descriptors';\nimport type { ConsumeLoaderPayload } from '#internal/host/shared/server-handoff';\nimport {\n  getMissingSharedModulesMessage,\n  type RemoteSharedModules,\n} from '#internal/host/shared/shared-broker';\nimport { buildHostShared } from '#internal/host/shared/shared-module-resolver';\nimport { applyOriginToNodes } from '#internal/runtime/html/apply-origin';\nimport {\n  type ParsedRemoteComponent,\n  parseRemoteComponentDocument,\n} from '#internal/runtime/html/parse-remote-html';\nimport { loadRemoteComponent } from '#internal/runtime/loaders/component-loader';\nimport { loadStaticRemoteComponent } from '#internal/runtime/loaders/static-loader';\nimport type { RemoteComponentMetadata } from '#internal/runtime/metadata';\nimport {\n  collapseDoubleSlashes,\n  REMOTE_COMPONENT_REGEX,\n} from '#internal/runtime/patterns';\nimport type { MountOrUnmountFunction } from '#internal/runtime/types';\nimport { escapeString } from '#internal/utils';\nimport { RemoteComponentsError } from '#internal/utils/error';\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\ntype SharedModuleMap = Record<string, (bundle?: string) => Promise<unknown>>;\n\n/**\n * Input for {@link runPipeline} — the full post-fetch pipeline that starts\n * from raw HTML.\n */\nexport interface PipelineInput {\n  /** Resolved URL of the remote component. */\n  url: URL;\n  /** Raw HTML string returned by the remote. */\n  html: string;\n  /** Component name hint (may be refined during parsing). */\n  name: string;\n  /** Abort signal — the pipeline checks this between async steps. */\n  signal: AbortSignal;\n  /** Host-provided shared module factories (resolved or promise). */\n  shared: Promise<SharedModuleMap> | SharedModuleMap;\n  /** URL rewriter for client-side asset URLs. */\n  resolveClientUrl?: InternalResolveClientUrl;\n  /** Shadow root or element to mount into (for script-based components). */\n  container?: ShadowRoot | HTMLElement | null;\n}\n\n/**\n * Input for {@link runPipelineFromParsed} — the pipeline entry point for\n * hosts that receive pre-parsed SSR data (e.g. the App Router client).\n */\nexport interface ParsedPipelineInput {\n  /** Resolved URL of the remote component. */\n  url: URL;\n  /** Component name. */\n  name: string;\n  /** Abort signal. */\n  signal: AbortSignal;\n  /** Pre-resolved loader payload from the server component. */\n  payload: ConsumeLoaderPayload;\n  /** Host-provided shared module factories (resolved or promise). */\n  shared: Promise<SharedModuleMap> | SharedModuleMap;\n  /** Remote-requested shared modules. */\n  remoteShared?: RemoteSharedModules;\n  /** URL rewriter for client-side asset URLs. */\n  resolveClientUrl?: InternalResolveClientUrl;\n  /** Shadow root or element to mount into. */\n  container?: ShadowRoot | HTMLElement | null;\n  /** Optional RSC name override (used by App Router for scoped RSC data). */\n  rscName?: string;\n}\n\n/**\n * Successful dynamic component load — the component is a React element tree\n * ready to render.\n */\nexport interface PipelineLoaded {\n  status: 'loaded';\n  component: React.ReactNode;\n  metadata: RemoteComponentMetadata;\n  parsed: ParsedRemoteComponent;\n  doc: Document;\n}\n\n/**\n * Successful static component load — mount/unmount functions are returned\n * for the host to call.\n */\nexport interface PipelineStatic {\n  status: 'static';\n  mount: Set<MountOrUnmountFunction>;\n  unmount: Set<MountOrUnmountFunction>;\n  metadata: RemoteComponentMetadata;\n  parsed: ParsedRemoteComponent;\n  doc: Document;\n}\n\n/** The load was aborted before it could complete. */\nexport interface PipelineAborted {\n  status: 'aborted';\n}\n\n/** The load failed with an error. */\nexport interface PipelineError {\n  status: 'error';\n  error: Error;\n}\n\nexport type PipelineResult =\n  | PipelineLoaded\n  | PipelineStatic\n  | PipelineAborted\n  | PipelineError;\n\n/**\n * Intermediate result from {@link preparePipeline}. Hosts that need to run\n * framework-specific logic between parse and load (e.g. inline script\n * execution in the React host) use this to split the pipeline into two\n * phases.\n */\nexport interface PreparedPipeline {\n  doc: Document;\n  parsed: ParsedRemoteComponent;\n  /** Script descriptors ready to pass to `loadRemoteComponent`. */\n  scriptDescriptors: ScriptDescriptor[];\n}\n\n// ---------------------------------------------------------------------------\n// Pipeline phases\n// ---------------------------------------------------------------------------\n\n/**\n * Phase 1: Parse HTML, validate shared modules, and normalize URLs.\n *\n * This is the synchronous/cheap portion of the pipeline. Hosts that need to\n * inject logic between parse and load (e.g. executing inline scripts) call\n * this directly, then call {@link loadPrepared} when ready.\n */\nexport function preparePipeline(input: {\n  html: string;\n  name: string;\n  url: URL;\n  shared: SharedModuleMap;\n  remoteShared?: RemoteSharedModules;\n  resolveClientUrl?: InternalResolveClientUrl;\n}): PreparedPipeline {\n  const parser = new DOMParser();\n  const doc = parser.parseFromString(input.html, 'text/html');\n\n  const parsed = parseRemoteComponentDocument(doc, input.name, input.url);\n\n  // Validate shared modules — surface errors early before any script loading.\n  // Only check *remote* shared modules here. The host-side marker\n  // (`__remote_components_missing_shared__` in `input.shared`) is a callable\n  // error signal that the host may intentionally leave in place when\n  // `withRemoteComponentsConfig` is not used — blocking on it would break\n  // framework-agnostic hosts that don't configure shared modules.\n  const remoteShared = input.remoteShared ?? parsed.remoteShared;\n  const missingSharedModulesMessage =\n    getMissingSharedModulesMessage(remoteShared);\n  if (missingSharedModulesMessage) {\n    throw new RemoteComponentsError(missingSharedModulesMessage);\n  }\n\n  applyOriginToNodes(doc, input.url, input.resolveClientUrl);\n\n  const scriptDescriptors = buildScriptDescriptors(parsed.scripts, input.url);\n\n  return { doc, parsed, scriptDescriptors };\n}\n\n/**\n * Phase 2: Load the component from a prepared pipeline result.\n *\n * For dynamic components, delegates to `loadRemoteComponent`. For static\n * components (`isRemoteComponent`), delegates to `loadStaticRemoteComponent`.\n */\nexport async function loadPrepared(input: {\n  prepared: PreparedPipeline;\n  url: URL;\n  signal: AbortSignal;\n  shared: Promise<SharedModuleMap> | SharedModuleMap;\n  resolveClientUrl?: InternalResolveClientUrl;\n  container?: ShadowRoot | HTMLElement | null;\n  rscName?: string;\n}): Promise<PipelineResult> {\n  const { prepared, url, signal, resolveClientUrl, container, rscName } = input;\n  const { doc, parsed, scriptDescriptors } = prepared;\n\n  if (signal.aborted) {\n    return { status: 'aborted' };\n  }\n\n  const userShared = await input.shared;\n  if (signal.aborted) {\n    return { status: 'aborted' };\n  }\n\n  if (parsed.isRemoteComponent) {\n    return loadStaticPath({\n      parsed,\n      doc,\n      url,\n      resolveClientUrl,\n    });\n  }\n\n  return loadDynamicPath({\n    parsed,\n    doc,\n    url,\n    scriptDescriptors,\n    shared: userShared,\n    resolveClientUrl,\n    container,\n    rscName,\n  });\n}\n\n// ---------------------------------------------------------------------------\n// Full pipeline entry points\n// ---------------------------------------------------------------------------\n\n/**\n * Full post-fetch pipeline: parse → validate → normalize → load.\n *\n * Use this when starting from a raw HTML string (React host, HTML host).\n */\nexport async function runPipeline(\n  input: PipelineInput,\n): Promise<PipelineResult> {\n  try {\n    const userShared = await input.shared;\n    if (input.signal.aborted) {\n      return { status: 'aborted' };\n    }\n\n    const prepared = preparePipeline({\n      html: input.html,\n      name: input.name,\n      url: input.url,\n      shared: userShared,\n      resolveClientUrl: input.resolveClientUrl,\n    });\n\n    return await loadPrepared({\n      prepared,\n      url: input.url,\n      signal: input.signal,\n      shared: userShared,\n      resolveClientUrl: input.resolveClientUrl,\n      container: input.container,\n    });\n  } catch (error) {\n    return {\n      status: 'error',\n      error:\n        error instanceof Error\n          ? error\n          : new RemoteComponentsError(String(error)),\n    };\n  }\n}\n\n/**\n * Pipeline entry point for pre-parsed SSR data (App Router client).\n *\n * Skips HTML parsing and goes straight to `loadRemoteComponent` with the\n * pre-resolved payload from the server component.\n */\nexport async function runPipelineFromParsed(\n  input: ParsedPipelineInput,\n): Promise<\n  | { status: 'loaded'; component: React.ReactNode }\n  | PipelineAborted\n  | PipelineError\n> {\n  try {\n    if (input.signal.aborted) {\n      return { status: 'aborted' };\n    }\n\n    const remoteShared = input.remoteShared ?? input.payload.remoteShared ?? {};\n\n    const missingSharedModulesMessage =\n      getMissingSharedModulesMessage(remoteShared);\n    if (missingSharedModulesMessage) {\n      throw new RemoteComponentsError(missingSharedModulesMessage);\n    }\n\n    const result = await loadRemoteComponent({\n      url: input.url,\n      name: input.name,\n      rscName: input.rscName,\n      bundle: input.payload.bundle,\n      route: input.payload.route,\n      runtime: input.payload.runtime,\n      data: input.payload.data,\n      nextData: input.payload.nextData,\n      scripts: input.payload.scripts,\n      shared: input.shared,\n      remoteShared,\n      container: input.container,\n      resolveClientUrl: input.resolveClientUrl,\n    });\n\n    if (input.signal.aborted) {\n      return { status: 'aborted' };\n    }\n\n    if (result.error) {\n      return { status: 'error', error: result.error };\n    }\n    return { status: 'loaded', component: result.component };\n  } catch (error) {\n    return {\n      status: 'error',\n      error:\n        error instanceof Error\n          ? error\n          : new RemoteComponentsError(String(error)),\n    };\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Internal helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Converts parsed `<script>` elements into the `ScriptDescriptor[]` format\n * expected by `loadRemoteComponent`. Handles the `[bundle] id` URL format\n * and collapses double slashes.\n */\nfunction buildScriptDescriptors(\n  scripts: HTMLScriptElement[],\n  url: URL,\n): ScriptDescriptor[] {\n  return scripts.map((script) => {\n    const scriptSrc =\n      script.getAttribute('data-src') ||\n      script.getAttribute('src') ||\n      script.src;\n    const { prefix, id: path } = REMOTE_COMPONENT_REGEX.exec(scriptSrc)\n      ?.groups ?? {\n      prefix: undefined,\n      id: scriptSrc,\n    };\n    return {\n      src: new URL(collapseDoubleSlashes(`${prefix ?? ''}${path}`), url).href,\n    };\n  });\n}\n\nasync function loadStaticPath(input: {\n  parsed: ParsedRemoteComponent;\n  doc: Document;\n  url: URL;\n  resolveClientUrl?: InternalResolveClientUrl;\n}): Promise<PipelineStatic> {\n  const { parsed, doc, url, resolveClientUrl } = input;\n  const scripts = Array.from(\n    parsed.component.querySelectorAll<HTMLScriptElement>('script'),\n  );\n  const { mount, unmount } = await loadStaticRemoteComponent(\n    scripts,\n    url,\n    resolveClientUrl,\n  );\n  return {\n    status: 'static',\n    mount,\n    unmount,\n    metadata: parsed.metadata,\n    parsed,\n    doc,\n  };\n}\n\nasync function loadDynamicPath(input: {\n  parsed: ParsedRemoteComponent;\n  doc: Document;\n  url: URL;\n  scriptDescriptors: ScriptDescriptor[];\n  shared: SharedModuleMap;\n  resolveClientUrl?: InternalResolveClientUrl;\n  container?: ShadowRoot | HTMLElement | null;\n  rscName?: string;\n}): Promise<PipelineLoaded | PipelineError> {\n  const {\n    parsed,\n    doc,\n    url,\n    scriptDescriptors,\n    shared,\n    resolveClientUrl,\n    container,\n  } = input;\n\n  const rscName =\n    input.rscName ??\n    (parsed.rsc\n      ? `__remote_component_rsc_${escapeString(url.href)}_${escapeString(parsed.name)}`\n      : undefined);\n\n  const rscData = parsed.rsc\n    ? (parsed.rsc.textContent || '').split('\\n').filter(Boolean)\n    : [];\n\n  const result = await loadRemoteComponent({\n    url,\n    name: parsed.name,\n    rscName,\n    bundle: parsed.metadata.bundle,\n    route: parsed.metadata.route,\n    runtime: parsed.metadata.runtime,\n    data: rscData,\n    nextData: parsed.nextData,\n    scripts: scriptDescriptors,\n    shared: buildHostShared(shared, resolveClientUrl),\n    remoteShared: parsed.remoteShared,\n    container,\n    resolveClientUrl,\n  });\n\n  if (result.error) {\n    return { status: 'error', error: result.error };\n  }\n  return {\n    status: 'loaded',\n    component: result.component,\n    metadata: parsed.metadata,\n    parsed,\n    doc,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/internal/host/shared/pipeline.d.ts

@@ -1,9 +1,11 @@
+import { RemoteSharedModules } from './shared-broker.js';
 import { RemoteComponentMetadata } from '../../runtime/metadata.js';
 import { ScriptDescriptor } from './asset-descriptors.js';
 import { InternalResolveClientUrl } from '../../runtime/url/resolve-client-url.js';
-import { a as ConsumeLoaderPayload } from '../../../server-handoff-8c89b856.js';
+import { a as ConsumeLoaderPayload } from '../../../server-handoff-9e905049.js';
 import { ParsedRemoteComponent } from '../../runtime/html/parse-remote-html.js';
 import { M as MountOrUnmountFunction } from '../../../types-bd7be268.js';
+import '../../utils/logger.js';
 import 'react';
 import './config.js';
 import './fetch-interceptors.js';
@@ -50,7 +52,7 @@ interface ParsedPipelineInput {
     /** Host-provided shared module factories (resolved or promise). */
     shared: Promise<SharedModuleMap> | SharedModuleMap;
     /** Remote-requested shared modules. */
-    remoteShared?: Record<string, string>;
+    remoteShared?: RemoteSharedModules;
     /** URL rewriter for client-side asset URLs. */
     resolveClientUrl?: InternalResolveClientUrl;
     /** Shadow root or element to mount into. */
@@ -115,7 +117,7 @@ declare function preparePipeline(input: {
     name: string;
     url: URL;
     shared: SharedModuleMap;
-    remoteShared?: Record<string, string>;
+    remoteShared?: RemoteSharedModules;
     resolveClientUrl?: InternalResolveClientUrl;
 }): PreparedPipeline;
 /**

package/dist/internal/host/shared/pipeline.js

@@ -1,3 +1,6 @@
+import {
+  getMissingSharedModulesMessage
+} from "#internal/host/shared/shared-broker";
 import { buildHostShared } from "#internal/host/shared/shared-module-resolver";
 import { applyOriginToNodes } from "#internal/runtime/html/apply-origin";
 import {
@@ -16,10 +19,9 @@ function preparePipeline(input) {
   const doc = parser.parseFromString(input.html, "text/html");
   const parsed = parseRemoteComponentDocument(doc, input.name, input.url);
   const remoteShared = input.remoteShared ?? parsed.remoteShared;
-  if ("__remote_components_missing_shared__" in remoteShared) {
-    throw new RemoteComponentsError(
-      remoteShared.__remote_components_missing_shared__
-    );
+  const missingSharedModulesMessage = getMissingSharedModulesMessage(remoteShared);
+  if (missingSharedModulesMessage) {
+    throw new RemoteComponentsError(missingSharedModulesMessage);
   }
   applyOriginToNodes(doc, input.url, input.resolveClientUrl);
   const scriptDescriptors = buildScriptDescriptors(parsed.scripts, input.url);
@@ -88,10 +90,9 @@ async function runPipelineFromParsed(input) {
       return { status: "aborted" };
     }
     const remoteShared = input.remoteShared ?? input.payload.remoteShared ?? {};
-    if ("__remote_components_missing_shared__" in remoteShared) {
-      throw new RemoteComponentsError(
-        remoteShared.__remote_components_missing_shared__
-      );
+    const missingSharedModulesMessage = getMissingSharedModulesMessage(remoteShared);
+    if (missingSharedModulesMessage) {
+      throw new RemoteComponentsError(missingSharedModulesMessage);
     }
     const result = await loadRemoteComponent({
       url: input.url,

package/dist/internal/host/shared/pipeline.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/host/shared/pipeline.ts"],"sourcesContent":["import type { InternalResolveClientUrl } from '#internal/host/server/types';\nimport type { ScriptDescriptor } from '#internal/host/shared/asset-descriptors';\nimport type { ConsumeLoaderPayload } from '#internal/host/shared/server-handoff';\nimport { buildHostShared } from '#internal/host/shared/shared-module-resolver';\nimport { applyOriginToNodes } from '#internal/runtime/html/apply-origin';\nimport {\n  type ParsedRemoteComponent,\n  parseRemoteComponentDocument,\n} from '#internal/runtime/html/parse-remote-html';\nimport { loadRemoteComponent } from '#internal/runtime/loaders/component-loader';\nimport { loadStaticRemoteComponent } from '#internal/runtime/loaders/static-loader';\nimport type { RemoteComponentMetadata } from '#internal/runtime/metadata';\nimport {\n  collapseDoubleSlashes,\n  REMOTE_COMPONENT_REGEX,\n} from '#internal/runtime/patterns';\nimport type { MountOrUnmountFunction } from '#internal/runtime/types';\nimport { escapeString } from '#internal/utils';\nimport { RemoteComponentsError } from '#internal/utils/error';\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\ntype SharedModuleMap = Record<string, (bundle?: string) => Promise<unknown>>;\n\n/**\n * Input for {@link runPipeline} — the full post-fetch pipeline that starts\n * from raw HTML.\n */\nexport interface PipelineInput {\n  /** Resolved URL of the remote component. */\n  url: URL;\n  /** Raw HTML string returned by the remote. */\n  html: string;\n  /** Component name hint (may be refined during parsing). */\n  name: string;\n  /** Abort signal — the pipeline checks this between async steps. */\n  signal: AbortSignal;\n  /** Host-provided shared module factories (resolved or promise). */\n  shared: Promise<SharedModuleMap> | SharedModuleMap;\n  /** URL rewriter for client-side asset URLs. */\n  resolveClientUrl?: InternalResolveClientUrl;\n  /** Shadow root or element to mount into (for script-based components). */\n  container?: ShadowRoot | HTMLElement | null;\n}\n\n/**\n * Input for {@link runPipelineFromParsed} — the pipeline entry point for\n * hosts that receive pre-parsed SSR data (e.g. the App Router client).\n */\nexport interface ParsedPipelineInput {\n  /** Resolved URL of the remote component. */\n  url: URL;\n  /** Component name. */\n  name: string;\n  /** Abort signal. */\n  signal: AbortSignal;\n  /** Pre-resolved loader payload from the server component. */\n  payload: ConsumeLoaderPayload;\n  /** Host-provided shared module factories (resolved or promise). */\n  shared: Promise<SharedModuleMap> | SharedModuleMap;\n  /** Remote-requested shared modules. */\n  remoteShared?: Record<string, string>;\n  /** URL rewriter for client-side asset URLs. */\n  resolveClientUrl?: InternalResolveClientUrl;\n  /** Shadow root or element to mount into. */\n  container?: ShadowRoot | HTMLElement | null;\n  /** Optional RSC name override (used by App Router for scoped RSC data). */\n  rscName?: string;\n}\n\n/**\n * Successful dynamic component load — the component is a React element tree\n * ready to render.\n */\nexport interface PipelineLoaded {\n  status: 'loaded';\n  component: React.ReactNode;\n  metadata: RemoteComponentMetadata;\n  parsed: ParsedRemoteComponent;\n  doc: Document;\n}\n\n/**\n * Successful static component load — mount/unmount functions are returned\n * for the host to call.\n */\nexport interface PipelineStatic {\n  status: 'static';\n  mount: Set<MountOrUnmountFunction>;\n  unmount: Set<MountOrUnmountFunction>;\n  metadata: RemoteComponentMetadata;\n  parsed: ParsedRemoteComponent;\n  doc: Document;\n}\n\n/** The load was aborted before it could complete. */\nexport interface PipelineAborted {\n  status: 'aborted';\n}\n\n/** The load failed with an error. */\nexport interface PipelineError {\n  status: 'error';\n  error: Error;\n}\n\nexport type PipelineResult =\n  | PipelineLoaded\n  | PipelineStatic\n  | PipelineAborted\n  | PipelineError;\n\n/**\n * Intermediate result from {@link preparePipeline}. Hosts that need to run\n * framework-specific logic between parse and load (e.g. inline script\n * execution in the React host) use this to split the pipeline into two\n * phases.\n */\nexport interface PreparedPipeline {\n  doc: Document;\n  parsed: ParsedRemoteComponent;\n  /** Script descriptors ready to pass to `loadRemoteComponent`. */\n  scriptDescriptors: ScriptDescriptor[];\n}\n\n// ---------------------------------------------------------------------------\n// Pipeline phases\n// ---------------------------------------------------------------------------\n\n/**\n * Phase 1: Parse HTML, validate shared modules, and normalize URLs.\n *\n * This is the synchronous/cheap portion of the pipeline. Hosts that need to\n * inject logic between parse and load (e.g. executing inline scripts) call\n * this directly, then call {@link loadPrepared} when ready.\n */\nexport function preparePipeline(input: {\n  html: string;\n  name: string;\n  url: URL;\n  shared: SharedModuleMap;\n  remoteShared?: Record<string, string>;\n  resolveClientUrl?: InternalResolveClientUrl;\n}): PreparedPipeline {\n  const parser = new DOMParser();\n  const doc = parser.parseFromString(input.html, 'text/html');\n\n  const parsed = parseRemoteComponentDocument(doc, input.name, input.url);\n\n  // Validate shared modules — surface errors early before any script loading.\n  // Only check *remote* shared modules here. The host-side marker\n  // (`__remote_components_missing_shared__` in `input.shared`) is a callable\n  // error signal that the host may intentionally leave in place when\n  // `withRemoteComponentsConfig` is not used — blocking on it would break\n  // framework-agnostic hosts that don't configure shared modules.\n  const remoteShared = input.remoteShared ?? parsed.remoteShared;\n  if ('__remote_components_missing_shared__' in remoteShared) {\n    throw new RemoteComponentsError(\n      remoteShared.__remote_components_missing_shared__,\n    );\n  }\n\n  applyOriginToNodes(doc, input.url, input.resolveClientUrl);\n\n  const scriptDescriptors = buildScriptDescriptors(parsed.scripts, input.url);\n\n  return { doc, parsed, scriptDescriptors };\n}\n\n/**\n * Phase 2: Load the component from a prepared pipeline result.\n *\n * For dynamic components, delegates to `loadRemoteComponent`. For static\n * components (`isRemoteComponent`), delegates to `loadStaticRemoteComponent`.\n */\nexport async function loadPrepared(input: {\n  prepared: PreparedPipeline;\n  url: URL;\n  signal: AbortSignal;\n  shared: Promise<SharedModuleMap> | SharedModuleMap;\n  resolveClientUrl?: InternalResolveClientUrl;\n  container?: ShadowRoot | HTMLElement | null;\n  rscName?: string;\n}): Promise<PipelineResult> {\n  const { prepared, url, signal, resolveClientUrl, container, rscName } = input;\n  const { doc, parsed, scriptDescriptors } = prepared;\n\n  if (signal.aborted) {\n    return { status: 'aborted' };\n  }\n\n  const userShared = await input.shared;\n  if (signal.aborted) {\n    return { status: 'aborted' };\n  }\n\n  if (parsed.isRemoteComponent) {\n    return loadStaticPath({\n      parsed,\n      doc,\n      url,\n      resolveClientUrl,\n    });\n  }\n\n  return loadDynamicPath({\n    parsed,\n    doc,\n    url,\n    scriptDescriptors,\n    shared: userShared,\n    resolveClientUrl,\n    container,\n    rscName,\n  });\n}\n\n// ---------------------------------------------------------------------------\n// Full pipeline entry points\n// ---------------------------------------------------------------------------\n\n/**\n * Full post-fetch pipeline: parse → validate → normalize → load.\n *\n * Use this when starting from a raw HTML string (React host, HTML host).\n */\nexport async function runPipeline(\n  input: PipelineInput,\n): Promise<PipelineResult> {\n  try {\n    const userShared = await input.shared;\n    if (input.signal.aborted) {\n      return { status: 'aborted' };\n    }\n\n    const prepared = preparePipeline({\n      html: input.html,\n      name: input.name,\n      url: input.url,\n      shared: userShared,\n      resolveClientUrl: input.resolveClientUrl,\n    });\n\n    return await loadPrepared({\n      prepared,\n      url: input.url,\n      signal: input.signal,\n      shared: userShared,\n      resolveClientUrl: input.resolveClientUrl,\n      container: input.container,\n    });\n  } catch (error) {\n    return {\n      status: 'error',\n      error:\n        error instanceof Error\n          ? error\n          : new RemoteComponentsError(String(error)),\n    };\n  }\n}\n\n/**\n * Pipeline entry point for pre-parsed SSR data (App Router client).\n *\n * Skips HTML parsing and goes straight to `loadRemoteComponent` with the\n * pre-resolved payload from the server component.\n */\nexport async function runPipelineFromParsed(\n  input: ParsedPipelineInput,\n): Promise<\n  | { status: 'loaded'; component: React.ReactNode }\n  | PipelineAborted\n  | PipelineError\n> {\n  try {\n    if (input.signal.aborted) {\n      return { status: 'aborted' };\n    }\n\n    const remoteShared = input.remoteShared ?? input.payload.remoteShared ?? {};\n\n    if ('__remote_components_missing_shared__' in remoteShared) {\n      throw new RemoteComponentsError(\n        remoteShared.__remote_components_missing_shared__,\n      );\n    }\n\n    const result = await loadRemoteComponent({\n      url: input.url,\n      name: input.name,\n      rscName: input.rscName,\n      bundle: input.payload.bundle,\n      route: input.payload.route,\n      runtime: input.payload.runtime,\n      data: input.payload.data,\n      nextData: input.payload.nextData,\n      scripts: input.payload.scripts,\n      shared: input.shared,\n      remoteShared,\n      container: input.container,\n      resolveClientUrl: input.resolveClientUrl,\n    });\n\n    if (input.signal.aborted) {\n      return { status: 'aborted' };\n    }\n\n    if (result.error) {\n      return { status: 'error', error: result.error };\n    }\n    return { status: 'loaded', component: result.component };\n  } catch (error) {\n    return {\n      status: 'error',\n      error:\n        error instanceof Error\n          ? error\n          : new RemoteComponentsError(String(error)),\n    };\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Internal helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Converts parsed `<script>` elements into the `ScriptDescriptor[]` format\n * expected by `loadRemoteComponent`. Handles the `[bundle] id` URL format\n * and collapses double slashes.\n */\nfunction buildScriptDescriptors(\n  scripts: HTMLScriptElement[],\n  url: URL,\n): ScriptDescriptor[] {\n  return scripts.map((script) => {\n    const scriptSrc =\n      script.getAttribute('data-src') ||\n      script.getAttribute('src') ||\n      script.src;\n    const { prefix, id: path } = REMOTE_COMPONENT_REGEX.exec(scriptSrc)\n      ?.groups ?? {\n      prefix: undefined,\n      id: scriptSrc,\n    };\n    return {\n      src: new URL(collapseDoubleSlashes(`${prefix ?? ''}${path}`), url).href,\n    };\n  });\n}\n\nasync function loadStaticPath(input: {\n  parsed: ParsedRemoteComponent;\n  doc: Document;\n  url: URL;\n  resolveClientUrl?: InternalResolveClientUrl;\n}): Promise<PipelineStatic> {\n  const { parsed, doc, url, resolveClientUrl } = input;\n  const scripts = Array.from(\n    parsed.component.querySelectorAll<HTMLScriptElement>('script'),\n  );\n  const { mount, unmount } = await loadStaticRemoteComponent(\n    scripts,\n    url,\n    resolveClientUrl,\n  );\n  return {\n    status: 'static',\n    mount,\n    unmount,\n    metadata: parsed.metadata,\n    parsed,\n    doc,\n  };\n}\n\nasync function loadDynamicPath(input: {\n  parsed: ParsedRemoteComponent;\n  doc: Document;\n  url: URL;\n  scriptDescriptors: ScriptDescriptor[];\n  shared: SharedModuleMap;\n  resolveClientUrl?: InternalResolveClientUrl;\n  container?: ShadowRoot | HTMLElement | null;\n  rscName?: string;\n}): Promise<PipelineLoaded | PipelineError> {\n  const {\n    parsed,\n    doc,\n    url,\n    scriptDescriptors,\n    shared,\n    resolveClientUrl,\n    container,\n  } = input;\n\n  const rscName =\n    input.rscName ??\n    (parsed.rsc\n      ? `__remote_component_rsc_${escapeString(url.href)}_${escapeString(parsed.name)}`\n      : undefined);\n\n  const rscData = parsed.rsc\n    ? (parsed.rsc.textContent || '').split('\\n').filter(Boolean)\n    : [];\n\n  const result = await loadRemoteComponent({\n    url,\n    name: parsed.name,\n    rscName,\n    bundle: parsed.metadata.bundle,\n    route: parsed.metadata.route,\n    runtime: parsed.metadata.runtime,\n    data: rscData,\n    nextData: parsed.nextData,\n    scripts: scriptDescriptors,\n    shared: buildHostShared(shared, resolveClientUrl),\n    remoteShared: parsed.remoteShared,\n    container,\n    resolveClientUrl,\n  });\n\n  if (result.error) {\n    return { status: 'error', error: result.error };\n  }\n  return {\n    status: 'loaded',\n    component: result.component,\n    metadata: parsed.metadata,\n    parsed,\n    doc,\n  };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../../src/host/shared/pipeline.ts"],"sourcesContent":["import type { InternalResolveClientUrl } from '#internal/host/server/types';\nimport type { ScriptDescriptor } from '#internal/host/shared/asset-descriptors';\nimport type { ConsumeLoaderPayload } from '#internal/host/shared/server-handoff';\nimport {\n  getMissingSharedModulesMessage,\n  type RemoteSharedModules,\n} from '#internal/host/shared/shared-broker';\nimport { buildHostShared } from '#internal/host/shared/shared-module-resolver';\nimport { applyOriginToNodes } from '#internal/runtime/html/apply-origin';\nimport {\n  type ParsedRemoteComponent,\n  parseRemoteComponentDocument,\n} from '#internal/runtime/html/parse-remote-html';\nimport { loadRemoteComponent } from '#internal/runtime/loaders/component-loader';\nimport { loadStaticRemoteComponent } from '#internal/runtime/loaders/static-loader';\nimport type { RemoteComponentMetadata } from '#internal/runtime/metadata';\nimport {\n  collapseDoubleSlashes,\n  REMOTE_COMPONENT_REGEX,\n} from '#internal/runtime/patterns';\nimport type { MountOrUnmountFunction } from '#internal/runtime/types';\nimport { escapeString } from '#internal/utils';\nimport { RemoteComponentsError } from '#internal/utils/error';\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\ntype SharedModuleMap = Record<string, (bundle?: string) => Promise<unknown>>;\n\n/**\n * Input for {@link runPipeline} — the full post-fetch pipeline that starts\n * from raw HTML.\n */\nexport interface PipelineInput {\n  /** Resolved URL of the remote component. */\n  url: URL;\n  /** Raw HTML string returned by the remote. */\n  html: string;\n  /** Component name hint (may be refined during parsing). */\n  name: string;\n  /** Abort signal — the pipeline checks this between async steps. */\n  signal: AbortSignal;\n  /** Host-provided shared module factories (resolved or promise). */\n  shared: Promise<SharedModuleMap> | SharedModuleMap;\n  /** URL rewriter for client-side asset URLs. */\n  resolveClientUrl?: InternalResolveClientUrl;\n  /** Shadow root or element to mount into (for script-based components). */\n  container?: ShadowRoot | HTMLElement | null;\n}\n\n/**\n * Input for {@link runPipelineFromParsed} — the pipeline entry point for\n * hosts that receive pre-parsed SSR data (e.g. the App Router client).\n */\nexport interface ParsedPipelineInput {\n  /** Resolved URL of the remote component. */\n  url: URL;\n  /** Component name. */\n  name: string;\n  /** Abort signal. */\n  signal: AbortSignal;\n  /** Pre-resolved loader payload from the server component. */\n  payload: ConsumeLoaderPayload;\n  /** Host-provided shared module factories (resolved or promise). */\n  shared: Promise<SharedModuleMap> | SharedModuleMap;\n  /** Remote-requested shared modules. */\n  remoteShared?: RemoteSharedModules;\n  /** URL rewriter for client-side asset URLs. */\n  resolveClientUrl?: InternalResolveClientUrl;\n  /** Shadow root or element to mount into. */\n  container?: ShadowRoot | HTMLElement | null;\n  /** Optional RSC name override (used by App Router for scoped RSC data). */\n  rscName?: string;\n}\n\n/**\n * Successful dynamic component load — the component is a React element tree\n * ready to render.\n */\nexport interface PipelineLoaded {\n  status: 'loaded';\n  component: React.ReactNode;\n  metadata: RemoteComponentMetadata;\n  parsed: ParsedRemoteComponent;\n  doc: Document;\n}\n\n/**\n * Successful static component load — mount/unmount functions are returned\n * for the host to call.\n */\nexport interface PipelineStatic {\n  status: 'static';\n  mount: Set<MountOrUnmountFunction>;\n  unmount: Set<MountOrUnmountFunction>;\n  metadata: RemoteComponentMetadata;\n  parsed: ParsedRemoteComponent;\n  doc: Document;\n}\n\n/** The load was aborted before it could complete. */\nexport interface PipelineAborted {\n  status: 'aborted';\n}\n\n/** The load failed with an error. */\nexport interface PipelineError {\n  status: 'error';\n  error: Error;\n}\n\nexport type PipelineResult =\n  | PipelineLoaded\n  | PipelineStatic\n  | PipelineAborted\n  | PipelineError;\n\n/**\n * Intermediate result from {@link preparePipeline}. Hosts that need to run\n * framework-specific logic between parse and load (e.g. inline script\n * execution in the React host) use this to split the pipeline into two\n * phases.\n */\nexport interface PreparedPipeline {\n  doc: Document;\n  parsed: ParsedRemoteComponent;\n  /** Script descriptors ready to pass to `loadRemoteComponent`. */\n  scriptDescriptors: ScriptDescriptor[];\n}\n\n// ---------------------------------------------------------------------------\n// Pipeline phases\n// ---------------------------------------------------------------------------\n\n/**\n * Phase 1: Parse HTML, validate shared modules, and normalize URLs.\n *\n * This is the synchronous/cheap portion of the pipeline. Hosts that need to\n * inject logic between parse and load (e.g. executing inline scripts) call\n * this directly, then call {@link loadPrepared} when ready.\n */\nexport function preparePipeline(input: {\n  html: string;\n  name: string;\n  url: URL;\n  shared: SharedModuleMap;\n  remoteShared?: RemoteSharedModules;\n  resolveClientUrl?: InternalResolveClientUrl;\n}): PreparedPipeline {\n  const parser = new DOMParser();\n  const doc = parser.parseFromString(input.html, 'text/html');\n\n  const parsed = parseRemoteComponentDocument(doc, input.name, input.url);\n\n  // Validate shared modules — surface errors early before any script loading.\n  // Only check *remote* shared modules here. The host-side marker\n  // (`__remote_components_missing_shared__` in `input.shared`) is a callable\n  // error signal that the host may intentionally leave in place when\n  // `withRemoteComponentsConfig` is not used — blocking on it would break\n  // framework-agnostic hosts that don't configure shared modules.\n  const remoteShared = input.remoteShared ?? parsed.remoteShared;\n  const missingSharedModulesMessage =\n    getMissingSharedModulesMessage(remoteShared);\n  if (missingSharedModulesMessage) {\n    throw new RemoteComponentsError(missingSharedModulesMessage);\n  }\n\n  applyOriginToNodes(doc, input.url, input.resolveClientUrl);\n\n  const scriptDescriptors = buildScriptDescriptors(parsed.scripts, input.url);\n\n  return { doc, parsed, scriptDescriptors };\n}\n\n/**\n * Phase 2: Load the component from a prepared pipeline result.\n *\n * For dynamic components, delegates to `loadRemoteComponent`. For static\n * components (`isRemoteComponent`), delegates to `loadStaticRemoteComponent`.\n */\nexport async function loadPrepared(input: {\n  prepared: PreparedPipeline;\n  url: URL;\n  signal: AbortSignal;\n  shared: Promise<SharedModuleMap> | SharedModuleMap;\n  resolveClientUrl?: InternalResolveClientUrl;\n  container?: ShadowRoot | HTMLElement | null;\n  rscName?: string;\n}): Promise<PipelineResult> {\n  const { prepared, url, signal, resolveClientUrl, container, rscName } = input;\n  const { doc, parsed, scriptDescriptors } = prepared;\n\n  if (signal.aborted) {\n    return { status: 'aborted' };\n  }\n\n  const userShared = await input.shared;\n  if (signal.aborted) {\n    return { status: 'aborted' };\n  }\n\n  if (parsed.isRemoteComponent) {\n    return loadStaticPath({\n      parsed,\n      doc,\n      url,\n      resolveClientUrl,\n    });\n  }\n\n  return loadDynamicPath({\n    parsed,\n    doc,\n    url,\n    scriptDescriptors,\n    shared: userShared,\n    resolveClientUrl,\n    container,\n    rscName,\n  });\n}\n\n// ---------------------------------------------------------------------------\n// Full pipeline entry points\n// ---------------------------------------------------------------------------\n\n/**\n * Full post-fetch pipeline: parse → validate → normalize → load.\n *\n * Use this when starting from a raw HTML string (React host, HTML host).\n */\nexport async function runPipeline(\n  input: PipelineInput,\n): Promise<PipelineResult> {\n  try {\n    const userShared = await input.shared;\n    if (input.signal.aborted) {\n      return { status: 'aborted' };\n    }\n\n    const prepared = preparePipeline({\n      html: input.html,\n      name: input.name,\n      url: input.url,\n      shared: userShared,\n      resolveClientUrl: input.resolveClientUrl,\n    });\n\n    return await loadPrepared({\n      prepared,\n      url: input.url,\n      signal: input.signal,\n      shared: userShared,\n      resolveClientUrl: input.resolveClientUrl,\n      container: input.container,\n    });\n  } catch (error) {\n    return {\n      status: 'error',\n      error:\n        error instanceof Error\n          ? error\n          : new RemoteComponentsError(String(error)),\n    };\n  }\n}\n\n/**\n * Pipeline entry point for pre-parsed SSR data (App Router client).\n *\n * Skips HTML parsing and goes straight to `loadRemoteComponent` with the\n * pre-resolved payload from the server component.\n */\nexport async function runPipelineFromParsed(\n  input: ParsedPipelineInput,\n): Promise<\n  | { status: 'loaded'; component: React.ReactNode }\n  | PipelineAborted\n  | PipelineError\n> {\n  try {\n    if (input.signal.aborted) {\n      return { status: 'aborted' };\n    }\n\n    const remoteShared = input.remoteShared ?? input.payload.remoteShared ?? {};\n\n    const missingSharedModulesMessage =\n      getMissingSharedModulesMessage(remoteShared);\n    if (missingSharedModulesMessage) {\n      throw new RemoteComponentsError(missingSharedModulesMessage);\n    }\n\n    const result = await loadRemoteComponent({\n      url: input.url,\n      name: input.name,\n      rscName: input.rscName,\n      bundle: input.payload.bundle,\n      route: input.payload.route,\n      runtime: input.payload.runtime,\n      data: input.payload.data,\n      nextData: input.payload.nextData,\n      scripts: input.payload.scripts,\n      shared: input.shared,\n      remoteShared,\n      container: input.container,\n      resolveClientUrl: input.resolveClientUrl,\n    });\n\n    if (input.signal.aborted) {\n      return { status: 'aborted' };\n    }\n\n    if (result.error) {\n      return { status: 'error', error: result.error };\n    }\n    return { status: 'loaded', component: result.component };\n  } catch (error) {\n    return {\n      status: 'error',\n      error:\n        error instanceof Error\n          ? error\n          : new RemoteComponentsError(String(error)),\n    };\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Internal helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Converts parsed `<script>` elements into the `ScriptDescriptor[]` format\n * expected by `loadRemoteComponent`. Handles the `[bundle] id` URL format\n * and collapses double slashes.\n */\nfunction buildScriptDescriptors(\n  scripts: HTMLScriptElement[],\n  url: URL,\n): ScriptDescriptor[] {\n  return scripts.map((script) => {\n    const scriptSrc =\n      script.getAttribute('data-src') ||\n      script.getAttribute('src') ||\n      script.src;\n    const { prefix, id: path } = REMOTE_COMPONENT_REGEX.exec(scriptSrc)\n      ?.groups ?? {\n      prefix: undefined,\n      id: scriptSrc,\n    };\n    return {\n      src: new URL(collapseDoubleSlashes(`${prefix ?? ''}${path}`), url).href,\n    };\n  });\n}\n\nasync function loadStaticPath(input: {\n  parsed: ParsedRemoteComponent;\n  doc: Document;\n  url: URL;\n  resolveClientUrl?: InternalResolveClientUrl;\n}): Promise<PipelineStatic> {\n  const { parsed, doc, url, resolveClientUrl } = input;\n  const scripts = Array.from(\n    parsed.component.querySelectorAll<HTMLScriptElement>('script'),\n  );\n  const { mount, unmount } = await loadStaticRemoteComponent(\n    scripts,\n    url,\n    resolveClientUrl,\n  );\n  return {\n    status: 'static',\n    mount,\n    unmount,\n    metadata: parsed.metadata,\n    parsed,\n    doc,\n  };\n}\n\nasync function loadDynamicPath(input: {\n  parsed: ParsedRemoteComponent;\n  doc: Document;\n  url: URL;\n  scriptDescriptors: ScriptDescriptor[];\n  shared: SharedModuleMap;\n  resolveClientUrl?: InternalResolveClientUrl;\n  container?: ShadowRoot | HTMLElement | null;\n  rscName?: string;\n}): Promise<PipelineLoaded | PipelineError> {\n  const {\n    parsed,\n    doc,\n    url,\n    scriptDescriptors,\n    shared,\n    resolveClientUrl,\n    container,\n  } = input;\n\n  const rscName =\n    input.rscName ??\n    (parsed.rsc\n      ? `__remote_component_rsc_${escapeString(url.href)}_${escapeString(parsed.name)}`\n      : undefined);\n\n  const rscData = parsed.rsc\n    ? (parsed.rsc.textContent || '').split('\\n').filter(Boolean)\n    : [];\n\n  const result = await loadRemoteComponent({\n    url,\n    name: parsed.name,\n    rscName,\n    bundle: parsed.metadata.bundle,\n    route: parsed.metadata.route,\n    runtime: parsed.metadata.runtime,\n    data: rscData,\n    nextData: parsed.nextData,\n    scripts: scriptDescriptors,\n    shared: buildHostShared(shared, resolveClientUrl),\n    remoteShared: parsed.remoteShared,\n    container,\n    resolveClientUrl,\n  });\n\n  if (result.error) {\n    return { status: 'error', error: result.error };\n  }\n  return {\n    status: 'loaded',\n    component: result.component,\n    metadata: parsed.metadata,\n    parsed,\n    doc,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/internal/host/shared/shared-broker.cjs

@@ -18,12 +18,25 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var shared_broker_exports = {};
 __export(shared_broker_exports, {
+  SHARED_MODULE_MANIFEST_PROTOCOL: () => SHARED_MODULE_MANIFEST_PROTOCOL,
   createSharedModulePlan: () => createSharedModulePlan,
+  getMissingSharedModulesMessage: () => getMissingSharedModulesMessage,
   installSharedModulePlan: () => installSharedModulePlan,
+  isSharedModuleManifest: () => isSharedModuleManifest,
   resolveSharedModulePlan: () => resolveSharedModulePlan
 });
 module.exports = __toCommonJS(shared_broker_exports);
 var import_logger = require("#internal/utils/logger");
+const SHARED_MODULE_MANIFEST_PROTOCOL = "remote-components.shared.v1";
+function isSharedModuleManifest(value) {
+  return typeof value === "object" && value !== null && "protocol" in value && value.protocol === SHARED_MODULE_MANIFEST_PROTOCOL && "requirements" in value && Array.isArray(value.requirements);
+}
+function getMissingSharedModulesMessage(remoteShared) {
+  if (isSharedModuleManifest(remoteShared))
+    return void 0;
+  const message = remoteShared.__remote_components_missing_shared__;
+  return typeof message === "string" ? message : void 0;
+}
 function createSharedModulePlan({
   bundle,
   hostShared,
@@ -31,42 +44,63 @@ function createSharedModulePlan({
   scope = `remote:${bundle}`,
   callerTag = "SharedBroker"
 }) {
-  const entries = Object.entries(remoteShared).map(([id, rawSpecifier]) => {
-    const specifier = String(rawSpecifier);
+  const protocol = isSharedModuleManifest(remoteShared) ? remoteShared.protocol : "legacy";
+  const requirements = isSharedModuleManifest(remoteShared) ? remoteShared.requirements : (
+    // @legacy(remote-components<=0.4.x): normalize the historical shared
+    // map until hosts and remotes on 0.4.x are no longer supported.
+    Object.entries(remoteShared).map(([id, specifier]) => ({
+      id,
+      specifier: String(specifier),
+      required: true,
+      singleton: true
+    }))
+  );
+  const entries = requirements.map((requirement) => {
+    const specifier = String(requirement.specifier);
     const provider = hostShared[specifier];
     const entry = {
-      id,
+      id: String(requirement.id),
       specifier,
-      required: true,
-      singleton: true,
-      scope,
+      required: requirement.required ?? true,
+      singleton: requirement.singleton ?? true,
+      scope: requirement.scope ?? scope,
       provider,
       status: typeof provider === "undefined" ? "missing" : "resolved"
     };
     if (entry.status === "missing") {
       (0, import_logger.logDebug)(
         callerTag,
-        `Remote "${bundle}" requests "${specifier}" for "${id}" but the host does not provide it`
+        `Remote "${bundle}" requests "${specifier}" for "${entry.id}" but the host does not provide it`
       );
     }
     return entry;
   });
   (0, import_logger.logDebug)(
     callerTag,
-    `Share plan for "${bundle}": ${entries.map((entry) => `${entry.id}=>${entry.specifier}:${entry.status}`).join(", ")}`
+    `Share plan (${protocol}) for "${bundle}": ${entries.map((entry) => `${entry.id}=>${entry.specifier}:${entry.status}`).join(", ")}`
   );
   return {
-    protocol: "v0",
+    protocol,
     bundle,
     entries
   };
 }
+function missingRequiredSharedModuleMessage(plan, entry) {
+  return `Remote Component "${plan.bundle}" requires shared module "${entry.specifier}", but the host does not provide it. Add it to the host shared modules through \`withRemoteComponentsConfig({ shared: [...] })\` or the \`shared\` prop. This diagnostic runs when both host and remote support the shared-module manifest in remote-components >=0.5.0. The remote may load its bundled copy during the compatibility window; this will become a load error after remote-components <=0.4.x support is removed.`;
+}
+function logMissingRequiredSharedModule(callerTag, plan, entry) {
+  (0, import_logger.logError)(callerTag, missingRequiredSharedModuleMessage(plan, entry));
+}
 async function resolveSharedModulePlan(plan) {
   const resolved = {};
   await Promise.all(
     plan.entries.map(async (entry) => {
-      if (entry.status !== "resolved")
+      if (entry.status !== "resolved") {
+        if (plan.protocol === SHARED_MODULE_MANIFEST_PROTOCOL && entry.required) {
+          logMissingRequiredSharedModule("SharedBroker", plan, entry);
+        }
         return;
+      }
       const value = typeof entry.provider === "function" ? await entry.provider(plan.bundle) : entry.provider;
       resolved[entry.id] = value;
     })
@@ -82,6 +116,10 @@ async function installSharedModulePlan({
   return Promise.all(
     plan.entries.map(async (entry) => {
       if (entry.status !== "resolved") {
+        if (plan.protocol === SHARED_MODULE_MANIFEST_PROTOCOL && entry.required) {
+          logMissingRequiredSharedModule(callerTag, plan, entry);
+          return void 0;
+        }
         if (onMissing) {
           onMissing(entry);
         } else {
@@ -99,8 +137,11 @@ async function installSharedModulePlan({
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  SHARED_MODULE_MANIFEST_PROTOCOL,
   createSharedModulePlan,
+  getMissingSharedModulesMessage,
   installSharedModulePlan,
+  isSharedModuleManifest,
   resolveSharedModulePlan
 });
 //# sourceMappingURL=shared-broker.cjs.map

package/dist/internal/host/shared/shared-broker.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/host/shared/shared-broker.ts"],"sourcesContent":["import type { LogLocation } from '#internal/utils/logger';\nimport { logDebug, logError } from '#internal/utils/logger';\n\nexport type SharedModuleFactory = (bundle?: string) => Promise<unknown>;\n\nexport interface SharedModuleRequirement {\n  id: string;\n  specifier: string;\n  required: boolean;\n  singleton: boolean;\n  scope: string;\n}\n\nexport interface SharedModuleResolution extends SharedModuleRequirement {\n  provider?: SharedModuleFactory | unknown;\n  status: 'resolved' | 'missing';\n}\n\nexport interface SharedModulePlan {\n  protocol: 'v0';\n  bundle: string;\n  entries: SharedModuleResolution[];\n}\n\nexport function createSharedModulePlan({\n  bundle,\n  hostShared,\n  remoteShared,\n  scope = `remote:${bundle}`,\n  callerTag = 'SharedBroker',\n}: {\n  bundle: string;\n  hostShared: Record<string, SharedModuleFactory | unknown>;\n  remoteShared: Record<string, string | number>;\n  scope?: string;\n  callerTag?: LogLocation;\n}): SharedModulePlan {\n  const entries = Object.entries(remoteShared).map(([id, rawSpecifier]) => {\n    const specifier = String(rawSpecifier);\n    const provider = hostShared[specifier];\n    const entry: SharedModuleResolution = {\n      id,\n      specifier,\n      required: true,\n      singleton: true,\n      scope,\n      provider,\n      status: typeof provider === 'undefined' ? 'missing' : 'resolved',\n    };\n\n    if (entry.status === 'missing') {\n      logDebug(\n        callerTag,\n        `Remote \"${bundle}\" requests \"${specifier}\" for \"${id}\" but the host does not provide it`,\n      );\n    }\n\n    return entry;\n  });\n\n  logDebug(\n    callerTag,\n    `Share plan for \"${bundle}\": ${entries\n      .map((entry) => `${entry.id}=>${entry.specifier}:${entry.status}`)\n      .join(', ')}`,\n  );\n\n  return {\n    protocol: 'v0',\n    bundle,\n    entries,\n  };\n}\n\nexport async function resolveSharedModulePlan(\n  plan: SharedModulePlan,\n): Promise<Record<string, unknown>> {\n  const resolved: Record<string, unknown> = {};\n\n  await Promise.all(\n    plan.entries.map(async (entry) => {\n      if (entry.status !== 'resolved') return;\n      const value =\n        typeof entry.provider === 'function'\n          ? await (entry.provider as SharedModuleFactory)(plan.bundle)\n          : entry.provider;\n      resolved[entry.id] = value;\n    }),\n  );\n\n  return resolved;\n}\n\nexport async function installSharedModulePlan({\n  plan,\n  target,\n  callerTag = 'SharedBroker',\n  onMissing,\n}: {\n  plan: SharedModulePlan;\n  target: Record<string, unknown>;\n  callerTag?: LogLocation;\n  onMissing?: (entry: SharedModuleResolution) => void;\n}): Promise<undefined[]> {\n  return Promise.all(\n    plan.entries.map(async (entry) => {\n      if (entry.status !== 'resolved') {\n        if (onMissing) {\n          onMissing(entry);\n        } else {\n          logError(\n            callerTag,\n            `Shared module \"${entry.specifier}\" not found for \"${plan.bundle}\".`,\n          );\n        }\n        return undefined;\n      }\n\n      target[entry.id] =\n        typeof entry.provider === 'function'\n          ? await (entry.provider as SharedModuleFactory)(plan.bundle)\n          : entry.provider;\n      return undefined;\n    }),\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,oBAAmC;AAuB5B,SAAS,uBAAuB;AAAA,EACrC;AAAA,EACA;AAAA,EACA;AAAA,EACA,QAAQ,UAAU;AAAA,EAClB,YAAY;AACd,GAMqB;AACnB,QAAM,UAAU,OAAO,QAAQ,YAAY,EAAE,IAAI,CAAC,CAAC,IAAI,YAAY,MAAM;AACvE,UAAM,YAAY,OAAO,YAAY;AACrC,UAAM,WAAW,WAAW,SAAS;AACrC,UAAM,QAAgC;AAAA,MACpC;AAAA,MACA;AAAA,MACA,UAAU;AAAA,MACV,WAAW;AAAA,MACX;AAAA,MACA;AAAA,MACA,QAAQ,OAAO,aAAa,cAAc,YAAY;AAAA,IACxD;AAEA,QAAI,MAAM,WAAW,WAAW;AAC9B;AAAA,QACE;AAAA,QACA,WAAW,qBAAqB,mBAAmB;AAAA,MACrD;AAAA,IACF;AAEA,WAAO;AAAA,EACT,CAAC;AAED;AAAA,IACE;AAAA,IACA,mBAAmB,YAAY,QAC5B,IAAI,CAAC,UAAU,GAAG,MAAM,OAAO,MAAM,aAAa,MAAM,QAAQ,EAChE,KAAK,IAAI;AAAA,EACd;AAEA,SAAO;AAAA,IACL,UAAU;AAAA,IACV;AAAA,IACA;AAAA,EACF;AACF;AAEA,eAAsB,wBACpB,MACkC;AAClC,QAAM,WAAoC,CAAC;AAE3C,QAAM,QAAQ;AAAA,IACZ,KAAK,QAAQ,IAAI,OAAO,UAAU;AAChC,UAAI,MAAM,WAAW;AAAY;AACjC,YAAM,QACJ,OAAO,MAAM,aAAa,aACtB,MAAO,MAAM,SAAiC,KAAK,MAAM,IACzD,MAAM;AACZ,eAAS,MAAM,EAAE,IAAI;AAAA,IACvB,CAAC;AAAA,EACH;AAEA,SAAO;AACT;AAEA,eAAsB,wBAAwB;AAAA,EAC5C;AAAA,EACA;AAAA,EACA,YAAY;AAAA,EACZ;AACF,GAKyB;AACvB,SAAO,QAAQ;AAAA,IACb,KAAK,QAAQ,IAAI,OAAO,UAAU;AAChC,UAAI,MAAM,WAAW,YAAY;AAC/B,YAAI,WAAW;AACb,oBAAU,KAAK;AAAA,QACjB,OAAO;AACL;AAAA,YACE;AAAA,YACA,kBAAkB,MAAM,6BAA6B,KAAK;AAAA,UAC5D;AAAA,QACF;AACA,eAAO;AAAA,MACT;AAEA,aAAO,MAAM,EAAE,IACb,OAAO,MAAM,aAAa,aACtB,MAAO,MAAM,SAAiC,KAAK,MAAM,IACzD,MAAM;AACZ,aAAO;AAAA,IACT,CAAC;AAAA,EACH;AACF;","names":[]}
+{"version":3,"sources":["../../../../src/host/shared/shared-broker.ts"],"sourcesContent":["import type { LogLocation } from '#internal/utils/logger';\nimport { logDebug, logError } from '#internal/utils/logger';\n\nexport type SharedModuleFactory = (bundle?: string) => Promise<unknown>;\n\nexport const SHARED_MODULE_MANIFEST_PROTOCOL =\n  'remote-components.shared.v1' as const;\n\nexport type LegacySharedModuleMap = Record<string, string | number>;\n\nexport interface SharedModuleManifestRequirement {\n  id: string | number;\n  specifier: string;\n  required?: boolean;\n  singleton?: boolean;\n  scope?: string;\n}\n\nexport interface SharedModuleManifest {\n  protocol: typeof SHARED_MODULE_MANIFEST_PROTOCOL;\n  requirements: SharedModuleManifestRequirement[];\n}\n\nexport type RemoteSharedModules = LegacySharedModuleMap | SharedModuleManifest;\n\nexport interface SharedModuleRequirement {\n  id: string;\n  specifier: string;\n  required: boolean;\n  singleton: boolean;\n  scope: string;\n}\n\nexport interface SharedModuleResolution extends SharedModuleRequirement {\n  provider?: SharedModuleFactory | unknown;\n  status: 'resolved' | 'missing';\n}\n\nexport interface SharedModulePlan {\n  protocol: 'legacy' | typeof SHARED_MODULE_MANIFEST_PROTOCOL;\n  bundle: string;\n  entries: SharedModuleResolution[];\n}\n\nexport function isSharedModuleManifest(\n  value: unknown,\n): value is SharedModuleManifest {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    'protocol' in value &&\n    value.protocol === SHARED_MODULE_MANIFEST_PROTOCOL &&\n    'requirements' in value &&\n    Array.isArray(value.requirements)\n  );\n}\n\nexport function getMissingSharedModulesMessage(\n  remoteShared: RemoteSharedModules,\n): string | undefined {\n  if (isSharedModuleManifest(remoteShared)) return undefined;\n  const message = remoteShared.__remote_components_missing_shared__;\n  return typeof message === 'string' ? message : undefined;\n}\n\nexport function createSharedModulePlan({\n  bundle,\n  hostShared,\n  remoteShared,\n  scope = `remote:${bundle}`,\n  callerTag = 'SharedBroker',\n}: {\n  bundle: string;\n  hostShared: Record<string, SharedModuleFactory | unknown>;\n  remoteShared: RemoteSharedModules;\n  scope?: string;\n  callerTag?: LogLocation;\n}): SharedModulePlan {\n  const protocol = isSharedModuleManifest(remoteShared)\n    ? remoteShared.protocol\n    : 'legacy';\n  const requirements: SharedModuleManifestRequirement[] =\n    isSharedModuleManifest(remoteShared)\n      ? remoteShared.requirements\n      : // @legacy(remote-components<=0.4.x): normalize the historical shared\n        // map until hosts and remotes on 0.4.x are no longer supported.\n        Object.entries(remoteShared).map(([id, specifier]) => ({\n          id,\n          specifier: String(specifier),\n          required: true,\n          singleton: true,\n        }));\n\n  const entries = requirements.map((requirement) => {\n    const specifier = String(requirement.specifier);\n    const provider = hostShared[specifier];\n    const entry: SharedModuleResolution = {\n      id: String(requirement.id),\n      specifier,\n      required: requirement.required ?? true,\n      singleton: requirement.singleton ?? true,\n      scope: requirement.scope ?? scope,\n      provider,\n      status: typeof provider === 'undefined' ? 'missing' : 'resolved',\n    };\n\n    if (entry.status === 'missing') {\n      logDebug(\n        callerTag,\n        `Remote \"${bundle}\" requests \"${specifier}\" for \"${entry.id}\" but the host does not provide it`,\n      );\n    }\n\n    return entry;\n  });\n\n  logDebug(\n    callerTag,\n    `Share plan (${protocol}) for \"${bundle}\": ${entries\n      .map((entry) => `${entry.id}=>${entry.specifier}:${entry.status}`)\n      .join(', ')}`,\n  );\n\n  return {\n    protocol,\n    bundle,\n    entries,\n  };\n}\n\nfunction missingRequiredSharedModuleMessage(\n  plan: SharedModulePlan,\n  entry: SharedModuleResolution,\n): string {\n  return (\n    `Remote Component \"${plan.bundle}\" requires shared module \"${entry.specifier}\", but the host does not provide it. ` +\n    'Add it to the host shared modules through `withRemoteComponentsConfig({ shared: [...] })` or the `shared` prop. ' +\n    'This diagnostic runs when both host and remote support the shared-module manifest in remote-components >=0.5.0. ' +\n    'The remote may load its bundled copy during the compatibility window; this will become a load error after remote-components <=0.4.x support is removed.'\n  );\n}\n\nfunction logMissingRequiredSharedModule(\n  callerTag: LogLocation,\n  plan: SharedModulePlan,\n  entry: SharedModuleResolution,\n): void {\n  logError(callerTag, missingRequiredSharedModuleMessage(plan, entry));\n}\n\nexport async function resolveSharedModulePlan(\n  plan: SharedModulePlan,\n): Promise<Record<string, unknown>> {\n  const resolved: Record<string, unknown> = {};\n\n  await Promise.all(\n    plan.entries.map(async (entry) => {\n      if (entry.status !== 'resolved') {\n        if (\n          plan.protocol === SHARED_MODULE_MANIFEST_PROTOCOL &&\n          entry.required\n        ) {\n          logMissingRequiredSharedModule('SharedBroker', plan, entry);\n        }\n        return;\n      }\n      const value =\n        typeof entry.provider === 'function'\n          ? await (entry.provider as SharedModuleFactory)(plan.bundle)\n          : entry.provider;\n      resolved[entry.id] = value;\n    }),\n  );\n\n  return resolved;\n}\n\nexport async function installSharedModulePlan({\n  plan,\n  target,\n  callerTag = 'SharedBroker',\n  onMissing,\n}: {\n  plan: SharedModulePlan;\n  target: Record<string, unknown>;\n  callerTag?: LogLocation;\n  onMissing?: (entry: SharedModuleResolution) => void;\n}): Promise<undefined[]> {\n  return Promise.all(\n    plan.entries.map(async (entry) => {\n      if (entry.status !== 'resolved') {\n        if (\n          plan.protocol === SHARED_MODULE_MANIFEST_PROTOCOL &&\n          entry.required\n        ) {\n          logMissingRequiredSharedModule(callerTag, plan, entry);\n          return undefined;\n        }\n        if (onMissing) {\n          onMissing(entry);\n        } else {\n          logError(\n            callerTag,\n            `Shared module \"${entry.specifier}\" not found for \"${plan.bundle}\".`,\n          );\n        }\n        return undefined;\n      }\n\n      target[entry.id] =\n        typeof entry.provider === 'function'\n          ? await (entry.provider as SharedModuleFactory)(plan.bundle)\n          : entry.provider;\n      return undefined;\n    }),\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/internal/host/shared/shared-broker.d.ts

@@ -1,6 +1,20 @@
 import { LogLocation } from '../../utils/logger.js';
 
 type SharedModuleFactory = (bundle?: string) => Promise<unknown>;
+declare const SHARED_MODULE_MANIFEST_PROTOCOL: "remote-components.shared.v1";
+type LegacySharedModuleMap = Record<string, string | number>;
+interface SharedModuleManifestRequirement {
+    id: string | number;
+    specifier: string;
+    required?: boolean;
+    singleton?: boolean;
+    scope?: string;
+}
+interface SharedModuleManifest {
+    protocol: typeof SHARED_MODULE_MANIFEST_PROTOCOL;
+    requirements: SharedModuleManifestRequirement[];
+}
+type RemoteSharedModules = LegacySharedModuleMap | SharedModuleManifest;
 interface SharedModuleRequirement {
     id: string;
     specifier: string;
@@ -13,14 +27,16 @@ interface SharedModuleResolution extends SharedModuleRequirement {
     status: 'resolved' | 'missing';
 }
 interface SharedModulePlan {
-    protocol: 'v0';
+    protocol: 'legacy' | typeof SHARED_MODULE_MANIFEST_PROTOCOL;
     bundle: string;
     entries: SharedModuleResolution[];
 }
+declare function isSharedModuleManifest(value: unknown): value is SharedModuleManifest;
+declare function getMissingSharedModulesMessage(remoteShared: RemoteSharedModules): string | undefined;
 declare function createSharedModulePlan({ bundle, hostShared, remoteShared, scope, callerTag, }: {
     bundle: string;
     hostShared: Record<string, SharedModuleFactory | unknown>;
-    remoteShared: Record<string, string | number>;
+    remoteShared: RemoteSharedModules;
     scope?: string;
     callerTag?: LogLocation;
 }): SharedModulePlan;
@@ -32,4 +48,4 @@ declare function installSharedModulePlan({ plan, target, callerTag, onMissing, }
     onMissing?: (entry: SharedModuleResolution) => void;
 }): Promise<undefined[]>;
 
-export { SharedModuleFactory, SharedModulePlan, SharedModuleRequirement, SharedModuleResolution, createSharedModulePlan, installSharedModulePlan, resolveSharedModulePlan };
+export { LegacySharedModuleMap, RemoteSharedModules, SHARED_MODULE_MANIFEST_PROTOCOL, SharedModuleFactory, SharedModuleManifest, SharedModuleManifestRequirement, SharedModulePlan, SharedModuleRequirement, SharedModuleResolution, createSharedModulePlan, getMissingSharedModulesMessage, installSharedModulePlan, isSharedModuleManifest, resolveSharedModulePlan };

package/dist/internal/host/shared/shared-broker.js

@@ -1,4 +1,14 @@
 import { logDebug, logError } from "#internal/utils/logger";
+const SHARED_MODULE_MANIFEST_PROTOCOL = "remote-components.shared.v1";
+function isSharedModuleManifest(value) {
+  return typeof value === "object" && value !== null && "protocol" in value && value.protocol === SHARED_MODULE_MANIFEST_PROTOCOL && "requirements" in value && Array.isArray(value.requirements);
+}
+function getMissingSharedModulesMessage(remoteShared) {
+  if (isSharedModuleManifest(remoteShared))
+    return void 0;
+  const message = remoteShared.__remote_components_missing_shared__;
+  return typeof message === "string" ? message : void 0;
+}
 function createSharedModulePlan({
   bundle,
   hostShared,
@@ -6,42 +16,63 @@ function createSharedModulePlan({
   scope = `remote:${bundle}`,
   callerTag = "SharedBroker"
 }) {
-  const entries = Object.entries(remoteShared).map(([id, rawSpecifier]) => {
-    const specifier = String(rawSpecifier);
+  const protocol = isSharedModuleManifest(remoteShared) ? remoteShared.protocol : "legacy";
+  const requirements = isSharedModuleManifest(remoteShared) ? remoteShared.requirements : (
+    // @legacy(remote-components<=0.4.x): normalize the historical shared
+    // map until hosts and remotes on 0.4.x are no longer supported.
+    Object.entries(remoteShared).map(([id, specifier]) => ({
+      id,
+      specifier: String(specifier),
+      required: true,
+      singleton: true
+    }))
+  );
+  const entries = requirements.map((requirement) => {
+    const specifier = String(requirement.specifier);
     const provider = hostShared[specifier];
     const entry = {
-      id,
+      id: String(requirement.id),
       specifier,
-      required: true,
-      singleton: true,
-      scope,
+      required: requirement.required ?? true,
+      singleton: requirement.singleton ?? true,
+      scope: requirement.scope ?? scope,
       provider,
       status: typeof provider === "undefined" ? "missing" : "resolved"
     };
     if (entry.status === "missing") {
       logDebug(
         callerTag,
-        `Remote "${bundle}" requests "${specifier}" for "${id}" but the host does not provide it`
+        `Remote "${bundle}" requests "${specifier}" for "${entry.id}" but the host does not provide it`
       );
     }
     return entry;
   });
   logDebug(
     callerTag,
-    `Share plan for "${bundle}": ${entries.map((entry) => `${entry.id}=>${entry.specifier}:${entry.status}`).join(", ")}`
+    `Share plan (${protocol}) for "${bundle}": ${entries.map((entry) => `${entry.id}=>${entry.specifier}:${entry.status}`).join(", ")}`
   );
   return {
-    protocol: "v0",
+    protocol,
     bundle,
     entries
   };
 }
+function missingRequiredSharedModuleMessage(plan, entry) {
+  return `Remote Component "${plan.bundle}" requires shared module "${entry.specifier}", but the host does not provide it. Add it to the host shared modules through \`withRemoteComponentsConfig({ shared: [...] })\` or the \`shared\` prop. This diagnostic runs when both host and remote support the shared-module manifest in remote-components >=0.5.0. The remote may load its bundled copy during the compatibility window; this will become a load error after remote-components <=0.4.x support is removed.`;
+}
+function logMissingRequiredSharedModule(callerTag, plan, entry) {
+  logError(callerTag, missingRequiredSharedModuleMessage(plan, entry));
+}
 async function resolveSharedModulePlan(plan) {
   const resolved = {};
   await Promise.all(
     plan.entries.map(async (entry) => {
-      if (entry.status !== "resolved")
+      if (entry.status !== "resolved") {
+        if (plan.protocol === SHARED_MODULE_MANIFEST_PROTOCOL && entry.required) {
+          logMissingRequiredSharedModule("SharedBroker", plan, entry);
+        }
         return;
+      }
       const value = typeof entry.provider === "function" ? await entry.provider(plan.bundle) : entry.provider;
       resolved[entry.id] = value;
     })
@@ -57,6 +88,10 @@ async function installSharedModulePlan({
   return Promise.all(
     plan.entries.map(async (entry) => {
       if (entry.status !== "resolved") {
+        if (plan.protocol === SHARED_MODULE_MANIFEST_PROTOCOL && entry.required) {
+          logMissingRequiredSharedModule(callerTag, plan, entry);
+          return void 0;
+        }
         if (onMissing) {
           onMissing(entry);
         } else {
@@ -73,8 +108,11 @@ async function installSharedModulePlan({
   );
 }
 export {
+  SHARED_MODULE_MANIFEST_PROTOCOL,
   createSharedModulePlan,
+  getMissingSharedModulesMessage,
   installSharedModulePlan,
+  isSharedModuleManifest,
   resolveSharedModulePlan
 };
 //# sourceMappingURL=shared-broker.js.map