Collaborative Loader Gateway

Build a small wrapper that uses the dependency's loader features to compose URL resolution, document service creation, and runtime code loading, then resolve collaborative container requests while supporting pending-state recovery and telemetry-aware options. The gateway should create one loader instance and reuse it for every request it handles.

Capabilities

Compose loader services

• Building the gateway with a resolver, document service factory, runtime code loader, telemetry logger, loader options, and optional protocol handler builder constructs a loader through the dependency and retains the provided services for reuse. @test

Resolve container requests

• Calling load with a request object resolves a container using the dependency's loader, returning the resolved URL string and the loaded container instance. @test

Resume pending local edits

• When pendingState is provided, load feeds it into the dependency so pending operations are applied before the container is returned. @test

Expose loader and services

• The gateway surfaces the constructed loader instance alongside the composed services so downstream components can reuse them without reconfiguration. @test

Implementation

@generates

API

export interface LoaderGatewayConfig {
  urlResolver: unknown;
  documentServiceFactory: unknown;
  codeLoader: unknown;
  logger?: unknown;
  options?: Record<string, any>;
  protocolHandlerBuilder?: unknown;
  scope?: Record<string, unknown>;
}

export interface LoaderRequest {
  url: string;
  headers?: Record<string, string>;
}

export interface LoadedContainerResult {
  loader: unknown;
  container: unknown;
  resolvedUrl: string;
  services: LoaderGatewayConfig;
}

export interface LoaderGateway {
  services: LoaderGatewayConfig;
  loader: unknown;
  load(request: LoaderRequest, pendingState?: string): Promise<LoadedContainerResult>;
}

export function createLoaderGateway(config: LoaderGatewayConfig): LoaderGateway;

Dependencies { .dependencies }

@fluidframework/container-loader { .dependency }

Provides loader composition, request resolution, telemetry integration, and pending-state handling for collaborative containers.

@satisfied-by