@fluojs/testing 2.0.0 → 3.0.0

package/dist/conformance/platform-shell-lifecycle-conformance.js

@@ -0,0 +1,259 @@
+import { PlatformLifecycleConflictError } from '@fluojs/runtime';
+class Deferred {
+  promise;
+  settle = () => {
+    throw new Error('Deferred promise was not initialized.');
+  };
+  constructor() {
+    this.promise = new Promise(resolve => {
+      this.settle = resolve;
+    });
+  }
+  resolve() {
+    this.settle();
+  }
+}
+class ControlledPlatformComponent {
+  id = 'platform-shell-lifecycle-conformance';
+  kind = 'platform-shell-lifecycle-conformance';
+  entered = {
+    start: new Deferred(),
+    stop: new Deferred()
+  };
+  startCalls = 0;
+  stopCalls = 0;
+  currentState = 'created';
+  startFailuresRemaining;
+  stopFailuresRemaining;
+  constructor(options = {}) {
+    this.options = options;
+    this.startFailuresRemaining = options.failStartTimes ?? 0;
+    this.stopFailuresRemaining = options.failStopTimes ?? 0;
+  }
+  health() {
+    return Promise.resolve({
+      status: 'healthy'
+    });
+  }
+  ready() {
+    return Promise.resolve({
+      critical: true,
+      status: 'ready'
+    });
+  }
+  snapshot() {
+    return {
+      dependencies: [],
+      details: {},
+      health: {
+        status: 'healthy'
+      },
+      id: this.id,
+      kind: this.kind,
+      ownership: {
+        externallyManaged: false,
+        ownsResources: true
+      },
+      readiness: {
+        critical: true,
+        status: 'ready'
+      },
+      state: this.currentState,
+      telemetry: {
+        namespace: 'fluo.platform-shell-lifecycle-conformance',
+        tags: {}
+      }
+    };
+  }
+  async start() {
+    this.startCalls += 1;
+    this.entered.start.resolve();
+    await this.options.onStart?.();
+    await this.options.startGate;
+    if (this.startFailuresRemaining > 0) {
+      this.startFailuresRemaining -= 1;
+      throw new Error('controlled start failure');
+    }
+    this.currentState = 'ready';
+  }
+  state() {
+    return this.currentState;
+  }
+  async stop() {
+    this.stopCalls += 1;
+    this.entered.stop.resolve();
+    await this.options.onStop?.();
+    await this.options.stopGate;
+    if (this.stopFailuresRemaining > 0) {
+      this.stopFailuresRemaining -= 1;
+      throw new Error('controlled stop failure');
+    }
+    this.currentState = 'stopped';
+  }
+  validate() {
+    return Promise.resolve({
+      issues: [],
+      ok: true
+    });
+  }
+}
+
+/**
+ * Describes the PlatformShell lifecycle conformance harness options contract.
+ */
+
+/**
+ * Represents lifecycle exclusivity checks for a PlatformShell implementation.
+ */
+export class PlatformShellLifecycleConformanceHarness {
+  constructor(options) {
+    this.options = options;
+  }
+  async assertAll() {
+    await this.assertOverlappingTransitionsRejectImmediately();
+    await this.assertCallbackReentryRejects();
+    await this.assertSettledTransitionsPermitRetries();
+    await this.assertSequentialTransitionsRemainIdempotent();
+  }
+  async assertOverlappingTransitionsRejectImmediately() {
+    const overlapPairs = [['start', 'start'], ['start', 'stop'], ['stop', 'start'], ['stop', 'stop']];
+    for (const [active, requested] of overlapPairs) {
+      const gate = new Deferred();
+      const component = new ControlledPlatformComponent(active === 'start' ? {
+        startGate: gate.promise
+      } : {
+        stopGate: gate.promise
+      });
+      const shell = this.options.createShell(component);
+      if (active === 'stop') {
+        await shell.start();
+      }
+      const activeTransition = shell[active]();
+      await component.entered[active].promise;
+      try {
+        await assertLifecycleConflict(shell[requested](), active, requested);
+      } finally {
+        gate.resolve();
+      }
+      await activeTransition;
+      if (active === 'start') {
+        await shell.stop();
+      }
+    }
+  }
+  async assertCallbackReentryRejects() {
+    await this.assertSynchronousStartCallbackReentryRejects();
+    await this.assertAwaitedStopCallbackReentryRejects();
+  }
+  async assertSettledTransitionsPermitRetries() {
+    await this.assertFailedTransitionPermitsRetry('start');
+    await this.assertFailedTransitionPermitsRetry('stop');
+  }
+  async assertSequentialTransitionsRemainIdempotent() {
+    const component = new ControlledPlatformComponent();
+    const shell = this.options.createShell(component);
+    await shell.start();
+    await shell.start();
+    await shell.stop();
+    await shell.stop();
+    if (component.startCalls !== 1 || component.stopCalls !== 1) {
+      throw new Error(`Settled lifecycle calls must be idempotent. Received ${component.startCalls} start() and ${component.stopCalls} stop() calls.`);
+    }
+  }
+  async assertSynchronousStartCallbackReentryRejects() {
+    let reenter;
+    const component = new ControlledPlatformComponent({
+      onStart: async () => {
+        if (!reenter) {
+          throw new Error('Lifecycle reentry was not initialized.');
+        }
+        await assertLifecycleConflict(reenter(), 'start', 'stop');
+      }
+    });
+    const shell = this.options.createShell(component);
+    reenter = () => shell.stop();
+    await shell.start();
+    await shell.stop();
+  }
+  async assertAwaitedStopCallbackReentryRejects() {
+    let reenter;
+    const component = new ControlledPlatformComponent({
+      onStop: async () => {
+        await Promise.resolve();
+        await Promise.resolve();
+        if (!reenter) {
+          throw new Error('Lifecycle reentry was not initialized.');
+        }
+        await assertLifecycleConflict(reenter(), 'stop', 'start');
+      }
+    });
+    const shell = this.options.createShell(component);
+    reenter = () => shell.start();
+    await shell.start();
+    await shell.stop();
+  }
+  async assertFailedTransitionPermitsRetry(operation) {
+    const component = new ControlledPlatformComponent(operation === 'start' ? {
+      failStartTimes: 1
+    } : {
+      failStopTimes: 1
+    });
+    const shell = this.options.createShell(component);
+    if (operation === 'stop') {
+      await shell.start();
+    }
+    await expectTransitionFailure(shell[operation](), operation);
+    await shell[operation]();
+    const callCount = operation === 'start' ? component.startCalls : component.stopCalls;
+    if (callCount !== 2) {
+      throw new Error(`Failed ${operation}() transitions must permit one explicit retry after settlement.`);
+    }
+    if (operation === 'start') {
+      await shell.stop();
+    }
+  }
+}
+async function assertLifecycleConflict(transition, active, requested) {
+  const outcome = await Promise.race([transition.then(() => ({
+    status: 'fulfilled'
+  }), error => ({
+    error,
+    status: 'rejected'
+  })), Promise.resolve().then(() => ({
+    status: 'pending'
+  }))]);
+  if (outcome.status === 'pending') {
+    throw new Error(`${requested}() must reject with PlatformLifecycleConflictError while ${active}() is active.`);
+  }
+  if (outcome.status === 'fulfilled') {
+    throw new Error(`${requested}() must reject while ${active}() is active.`);
+  }
+  if (!(outcome.error instanceof PlatformLifecycleConflictError)) {
+    throw new Error(`${requested}() must reject with PlatformLifecycleConflictError while ${active}() is active.`);
+  }
+  const {
+    error
+  } = outcome;
+  const metadata = error.meta;
+  if (error.code !== 'PLATFORM_LIFECYCLE_CONFLICT' || error.activeOperation !== active || error.requestedOperation !== requested || metadata?.['activeOperation'] !== active || metadata?.['requestedOperation'] !== requested) {
+    throw new Error(`${requested}() returned incorrect PlatformLifecycleConflictError metadata.`);
+  }
+}
+async function expectTransitionFailure(transition, operation) {
+  try {
+    await transition;
+  } catch {
+    return;
+  }
+  throw new Error(`The first ${operation}() transition must fail before retry conformance is checked.`);
+}
+
+/**
+ * Create PlatformShell lifecycle conformance harness.
+ *
+ * @param options The options.
+ * @returns The create PlatformShell lifecycle conformance harness result.
+ */
+export function createPlatformShellLifecycleConformanceHarness(options) {
+  return new PlatformShellLifecycleConformanceHarness(options);
+}

package/dist/http.d.ts

@@ -1,4 +1,4 @@
-import type { Dispatcher, Middleware } from '@fluojs/http';
+import type { Dispatcher, FrameworkRequest, Middleware } from '@fluojs/http';
 /**
  * Principal payload used by testing request helpers.
  */
@@ -20,6 +20,7 @@ export interface TestRequest {
     body?: unknown;
     headers?: Record<string, string>;
     query?: Record<string, string | string[]>;
+    cookies?: FrameworkRequest['cookies'];
     principal?: TestPrincipal;
 }
 /**

package/dist/http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAmD,UAAU,EAAa,MAAM,cAAc,CAAC;AAEvH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IAC1C,SAAS,CAAC,EAAE,aAAa,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,WAAW;IACzD,SAAS,CAAC,EAAE,aAAa,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;CAC5C;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAAC;IACtC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAAC;IACpC,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAAC;IACrC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc,CAAC;IACpD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,cAAc,CAAC;IAC7D,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,cAAc,CAAC;IAChD,IAAI,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;CAC/B;AA2ED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,sBAAsB,GAAG,cAAc,CAqD5G;AAED;;;;GAIG;AACH,wBAAgB,kCAAkC,IAAI,UAAU,CAa/D;AAuFD;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,UAAU,EAAE,UAAU,EAAE,GAAG,EAAE,sBAAsB,GAAG,OAAO,CAAC,YAAY,CAAC,CAO5G"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAiC,UAAU,EAAa,MAAM,cAAc,CAAC;AAEvH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;IACtC,SAAS,CAAC,EAAE,aAAa,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,WAAW;IACzD,SAAS,CAAC,EAAE,aAAa,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;CAC5C;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAAC;IACtC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAAC;IACpC,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAAC;IACrC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc,CAAC;IACpD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,cAAc,CAAC;IAC7D,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,cAAc,CAAC;IAChD,IAAI,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;CAC/B;AA2ED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,sBAAsB,GAAG,cAAc,CAsD5G;AAED;;;;GAIG;AACH,wBAAgB,kCAAkC,IAAI,UAAU,CAa/D;AA4FD;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,UAAU,EAAE,UAAU,EAAE,GAAG,EAAE,sBAAsB,GAAG,OAAO,CAAC,YAAY,CAAC,CAO5G"}

package/dist/http.js

@@ -79,6 +79,9 @@ export function createRequestBuilder(dispatcher, request) {
     query: request.query ? {
       ...request.query
     } : undefined,
+    cookies: request.cookies ? {
+      ...request.cookies
+    } : undefined,
     principal: request.principal
   };
   return {
@@ -162,7 +165,7 @@ function buildFrameworkRequest(req) {
     url: req.path + queryString,
     headers: req.headers ?? {},
     query: req.query ?? {},
-    cookies: {},
+    cookies: req.cookies ?? {},
     params: {},
     body: req.body,
     raw: req,
@@ -197,8 +200,10 @@ function buildFrameworkResponse() {
       const lowerName = name.toLowerCase();
       const responseHeaders = this.headers;
       if (lowerName === 'set-cookie') {
-        result.headers[name] = mergeHeaderValue(result.headers[name], value);
-        responseHeaders[name] = mergeHeaderValue(responseHeaders[name], value);
+        const existingHeaderName = Object.keys(result.headers).find(headerName => headerName.toLowerCase() === lowerName);
+        const canonicalHeaderName = existingHeaderName ?? name;
+        result.headers[canonicalHeaderName] = mergeHeaderValue(result.headers[canonicalHeaderName], value);
+        responseHeaders[canonicalHeaderName] = mergeHeaderValue(responseHeaders[canonicalHeaderName], value);
         return;
       }
       result.headers[name] = value;

package/dist/mock.js

@@ -38,7 +38,7 @@ export function createMock(partial = {}, options = {}) {
  * @returns The as mock result.
  */
 export function asMock(fn) {
-  return vi.mocked(fn);
+  return fn;
 }
 
 /**

package/dist/module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,SAAS,EAKd,KAAK,QAAQ,EAGd,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAGV,UAAU,EACX,MAAM,iBAAiB,CAAC;AAMzB,OAAO,KAAK,EAA2B,oBAAoB,EAAE,oBAAoB,EAAoB,MAAM,YAAY,CAAC;AAYxH;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,UAAU,GAAG,QAAQ,EAAE,CAQzE;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,UAAU,GAAG,SAAS,EAAE,CAQ5E;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU,EAAE,CAQzE;AAyuBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,oBAAoB,CAEvF;AAED;;GAEG;AACH,eAAO,MAAM,IAAI;;CAEhB,CAAC"}
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,SAAS,EAOd,KAAK,QAAQ,EAEd,MAAM,YAAY,CAAC;AAIpB,OAAO,KAAK,EAGV,UAAU,EACX,MAAM,iBAAiB,CAAC;AAGzB,OAAO,KAAK,EAA2B,oBAAoB,EAAE,oBAAoB,EAAoB,MAAM,YAAY,CAAC;AAYxH;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,UAAU,GAAG,QAAQ,EAAE,CAQzE;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,UAAU,GAAG,SAAS,EAAE,CAQ5E;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU,EAAE,CAQzE;AA2rBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,oBAAoB,CAEvF;AAED;;GAEG;AACH,eAAO,MAAM,IAAI;;CAEhB,CAAC"}

package/dist/module.js

@@ -1,7 +1,8 @@
 import { getModuleMetadata } from '@fluojs/core';
-import { isForwardRef, isOptionalToken, RequestScopeResolutionError, Scope } from '@fluojs/di';
-import { bootstrapModule } from '@fluojs/runtime';
+import { isForwardRef, isOptionalToken, Scope } from '@fluojs/di';
+import { resolveMultiContribution } from '@fluojs/di/internal';
 import { createDispatcher, createHandlerMapping } from '@fluojs/http';
+import { bootstrapModule } from '@fluojs/runtime';
 import { createTestRequestContextMiddleware, makeRequest } from './http.js';
 /**
  * Returns providers declared on a module metadata definition.
@@ -118,33 +119,7 @@ function isSingletonLifecycleProvider(provider) {
   if (provider.scope !== Scope.DEFAULT) {
     return false;
   }
-  return provider.type === 'class' || provider.type === 'value' && hasAnyBootstrapLifecycleHook(provider.useValue);
-}
-async function resolveLifecycleDependency(entry, bootstrapped, introspection) {
-  if (isOptionalToken(entry) && !hasTokenInContainer(introspection, entry.token)) {
-    return undefined;
-  }
-  return bootstrapped.container.resolve(dependencyToken(entry));
-}
-async function instantiateLifecycleProvider(provider, bootstrapped, introspection) {
-  if (provider.type !== 'class' || !provider.useClass) {
-    throw new Error(`Lifecycle provider ${String(provider.provide)} must use a class provider.`);
-  }
-  const dependencies = await Promise.all(provider.inject.map(entry => resolveLifecycleDependency(entry, bootstrapped, introspection)));
-  return new provider.useClass(...dependencies);
-}
-async function resolveMultiLifecycleProvider(provider, bootstrapped, introspection) {
-  const rootIntrospection = rootContainerIntrospection(introspection);
-  const cached = rootIntrospection.multiSingletonCache.get(provider);
-  if (cached) {
-    return cached;
-  }
-  const instance = instantiateLifecycleProvider(provider, bootstrapped, introspection).catch(error => {
-    rootIntrospection.cacheOwner.deleteMultiSingleton(provider);
-    throw error;
-  });
-  rootIntrospection.cacheOwner.setMultiSingleton(provider, instance);
-  return instance;
+  return provider.type === 'class' || provider.type === 'factory' || provider.type === 'value' && hasAnyBootstrapLifecycleHook(provider.useValue);
 }
 async function resolveTestingLifecycleInstances(bootstrapped, overrides = []) {
   const lifecycleProviders = [...bootstrapped.effectiveProviders.runtimeProviders, ...bootstrapped.effectiveProviders.moduleProviders, ...overrides];
@@ -154,35 +129,27 @@ async function resolveTestingLifecycleInstances(bootstrapped, overrides = []) {
   for (const provider of lifecycleProviders) {
     const token = providerToken(provider);
     const effectiveProviders = effectiveProvidersForToken(introspection, token);
-    for (let index = 0; index < effectiveProviders.length; index += 1) {
-      const effectiveProvider = effectiveProviders[index];
-      if (!effectiveProvider) {
-        continue;
-      }
-      if (seenProviders.has(effectiveProvider)) {
-        continue;
-      }
-      seenProviders.add(effectiveProvider);
-      if (!isSingletonLifecycleProvider(effectiveProvider)) {
-        continue;
-      }
-      if (effectiveProvider.type === 'value') {
-        instances.push(effectiveProvider.useValue);
-        continue;
-      }
-      try {
-        if (effectiveProvider.multi === true) {
-          instances.push(await resolveMultiLifecycleProvider(effectiveProvider, bootstrapped, introspection));
-          continue;
-        }
-        instances.push(await bootstrapped.container.resolve(token));
-      } catch (error) {
-        if (error instanceof RequestScopeResolutionError) {
-          continue;
-        }
-        throw error;
-      }
+    const nextUnseenProviderIndex = effectiveProviders.findIndex(effectiveProvider => !seenProviders.has(effectiveProvider));
+    if (nextUnseenProviderIndex === -1) {
+      continue;
+    }
+    const effectiveProvider = effectiveProviders[nextUnseenProviderIndex];
+    if (!effectiveProvider) {
+      continue;
     }
+    seenProviders.add(effectiveProvider);
+    if (!isSingletonLifecycleProvider(effectiveProvider)) {
+      continue;
+    }
+    if (effectiveProvider.type === 'value') {
+      instances.push(effectiveProvider.useValue);
+      continue;
+    }
+    if (effectiveProvider.multi === true) {
+      instances.push(await resolveMultiContribution(bootstrapped.container, token, nextUnseenProviderIndex));
+      continue;
+    }
+    instances.push(await bootstrapped.container.resolve(token));
   }
   return instances;
 }
@@ -540,24 +507,29 @@ class DefaultTestingModuleBuilder {
     return this;
   }
   async compile() {
-    const bootstrapped = this.bootstrapTestingModule();
-    const syncResolver = createSyncResolver(bootstrapped.container);
-    await runTestingBootstrapLifecycle(bootstrapped, this.overrides);
-    await syncResolver.syncFromContainer();
-    const resolve = bootstrapped.container.resolve.bind(bootstrapped.container);
-    bootstrapped.container.resolve = async token => {
-      const value = await resolve(token);
-      await syncResolver.syncFromContainer();
-      return value;
-    };
-    return this.createTestingModuleRef(bootstrapped, syncResolver);
-  }
-  bootstrapTestingModule() {
     const bootstrapped = this.bootstrapWithModuleReplacements();
-    if (this.overrides.length > 0) {
-      bootstrapped.container.override(...this.overrides);
+    try {
+      if (this.overrides.length > 0) {
+        bootstrapped.container.override(...this.overrides);
+      }
+      const syncResolver = createSyncResolver(bootstrapped.container);
+      await runTestingBootstrapLifecycle(bootstrapped, this.overrides);
+      await syncResolver.syncFromContainer();
+      const resolve = bootstrapped.container.resolve.bind(bootstrapped.container);
+      bootstrapped.container.resolve = async token => {
+        const value = await resolve(token);
+        await syncResolver.syncFromContainer();
+        return value;
+      };
+      return this.createTestingModuleRef(bootstrapped, syncResolver);
+    } catch (error) {
+      try {
+        await bootstrapped.container.dispose();
+      } catch (cleanupError) {
+        throw new AggregateError([error, cleanupError], 'Testing module compilation and container cleanup both failed.');
+      }
+      throw error;
     }
-    return bootstrapped;
   }
   bootstrapWithModuleReplacements() {
     return bootstrapModule(this.options.rootModule, this.createBootstrapModuleOptions());

package/dist/portability/error-representation-abort-portability.d.ts

@@ -0,0 +1,36 @@
+import { type ModuleType } from '@fluojs/runtime';
+import type { NetworkHttpErrorRepresentationBootstrapOptions, WebHttpErrorRepresentationBootstrapOptions } from './error-representation-portability.js';
+type NetworkApp = {
+    close(): Promise<void>;
+    listen(): Promise<void>;
+};
+type WebApp = {
+    close(): Promise<void>;
+    dispatch(request: Request): Promise<Response>;
+};
+type NetworkHarnessOptions<TBootstrapOptions extends object, TApp extends NetworkApp> = {
+    readonly bootstrap: (rootModule: ModuleType, options: TBootstrapOptions) => Promise<TApp>;
+    readonly createBootstrapOptions: (options: NetworkHttpErrorRepresentationBootstrapOptions) => TBootstrapOptions;
+    readonly name: string;
+};
+type WebHarnessOptions<TBootstrapOptions extends object, TApp extends WebApp> = {
+    readonly bootstrap: (rootModule: ModuleType, options: TBootstrapOptions) => Promise<TApp>;
+    readonly createBootstrapOptions: (options: WebHttpErrorRepresentationBootstrapOptions) => TBootstrapOptions;
+    readonly name: string;
+};
+/**
+ * Verifies that a disconnected network request commits neither HTML nor canonical JSON fallback.
+ *
+ * @param options Adapter bootstrap and identity callbacks.
+ * @returns A promise that resolves after native disconnect and no-representation-write checks pass.
+ */
+export declare function assertNetworkHttpErrorRepresentationAbortPortability<TBootstrapOptions extends object, TApp extends NetworkApp>(options: NetworkHarnessOptions<TBootstrapOptions, TApp>): Promise<void>;
+/**
+ * Verifies that an aborted Web request commits neither HTML nor canonical JSON fallback.
+ *
+ * @param options Adapter bootstrap and identity callbacks.
+ * @returns A promise that resolves after Web abort and no-representation-write checks pass.
+ */
+export declare function assertWebHttpErrorRepresentationAbortPortability<TBootstrapOptions extends object, TApp extends WebApp>(options: WebHarnessOptions<TBootstrapOptions, TApp>): Promise<void>;
+export {};
+//# sourceMappingURL=error-representation-abort-portability.d.ts.map

package/dist/portability/error-representation-abort-portability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-representation-abort-portability.d.ts","sourceRoot":"","sources":["../../src/portability/error-representation-abort-portability.ts"],"names":[],"mappings":"AAKA,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAEhE,OAAO,KAAK,EACV,8CAA8C,EAC9C,0CAA0C,EAC3C,MAAM,uCAAuC,CAAC;AAE/C,KAAK,UAAU,GAAG;IAChB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB,CAAC;AAEF,KAAK,MAAM,GAAG;IACZ,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC/C,CAAC;AAEF,KAAK,qBAAqB,CAAC,iBAAiB,SAAS,MAAM,EAAE,IAAI,SAAS,UAAU,IAAI;IACtF,QAAQ,CAAC,SAAS,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1F,QAAQ,CAAC,sBAAsB,EAAE,CAC/B,OAAO,EAAE,8CAA8C,KACpD,iBAAiB,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,KAAK,iBAAiB,CAAC,iBAAiB,SAAS,MAAM,EAAE,IAAI,SAAS,MAAM,IAAI;IAC9E,QAAQ,CAAC,SAAS,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1F,QAAQ,CAAC,sBAAsB,EAAE,CAC/B,OAAO,EAAE,0CAA0C,KAChD,iBAAiB,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,CAAC;AAoKF;;;;;GAKG;AACH,wBAAsB,oDAAoD,CACxE,iBAAiB,SAAS,MAAM,EAChC,IAAI,SAAS,UAAU,EACvB,OAAO,EAAE,qBAAqB,CAAC,iBAAiB,EAAE,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CA8BxE;AAED;;;;;GAKG;AACH,wBAAsB,gDAAgD,CACpE,iBAAiB,SAAS,MAAM,EAChC,IAAI,SAAS,MAAM,EACnB,OAAO,EAAE,iBAAiB,CAAC,iBAAiB,EAAE,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBpE"}