@fluojs/testing 1.0.0-beta.2 → 1.0.0-beta.3

package/dist/mock.js

@@ -1,6 +1,15 @@
 import { vi } from 'vitest';
+
+/**
+ * Defines the mocked methods type.
+ */
+
 /**
  * Creates a proxy mock object with optional strict missing-property checks.
+ *
+ * @param partial The partial.
+ * @param options The options.
+ * @returns The create mock result.
  */
 export function createMock(partial = {}, options = {}) {
   const autoMocks = new Map();
@@ -24,6 +33,9 @@ export function createMock(partial = {}, options = {}) {
 
 /**
  * Casts a function to a strongly typed Vitest mock.
+ *
+ * @param fn The fn.
+ * @returns The as mock result.
  */
 export function asMock(fn) {
   return vi.mocked(fn);
@@ -31,6 +43,9 @@ export function asMock(fn) {
 
 /**
  * Creates a deep mock by replacing prototype methods with `vi.fn()` spies.
+ *
+ * @param type The type.
+ * @returns The create deep mock result.
  */
 export function createDeepMock(type) {
   const spies = {};
@@ -51,6 +66,10 @@ export function createDeepMock(type) {
 
 /**
  * Creates a `useValue` provider for overriding a token in tests.
+ *
+ * @param token The token.
+ * @param partial The partial.
+ * @returns The mock token result.
  */
 export function mockToken(token, partial = {}) {
   return {

package/dist/module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,SAAS,EAId,KAAK,QAAQ,EACd,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAqC,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAMrF,OAAO,KAAK,EAA2B,oBAAoB,EAAE,oBAAoB,EAAoB,MAAM,YAAY,CAAC;AAExH;;;;;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;AAubD;;;;;;;;;;;;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,EAGL,KAAK,SAAS,EAId,KAAK,QAAQ,EACd,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAqC,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAMrF,OAAO,KAAK,EAA2B,oBAAoB,EAAE,oBAAoB,EAAoB,MAAM,YAAY,CAAC;AAExH;;;;;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;AAkkBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,oBAAoB,CAEvF;AAED;;GAEG;AACH,eAAO,MAAM,IAAI;;CAEhB,CAAC"}

package/dist/module.js

@@ -1,4 +1,4 @@
-import { getModuleMetadata } from '@fluojs/core/internal';
+import { getModuleMetadata } from '@fluojs/core';
 import { isForwardRef, isOptionalToken } from '@fluojs/di';
 import { bootstrapModule, defineModule } from '@fluojs/runtime';
 import { createDispatcher, createHandlerMapping } from '@fluojs/http';
@@ -97,7 +97,7 @@ function isContainerIntrospection(value) {
   const candidate = value;
   const parentValid = candidate.parent === undefined || isContainerIntrospection(candidate.parent);
   const requestScopeValid = candidate.requestScopeEnabled === undefined || typeof candidate.requestScopeEnabled === 'boolean';
-  return candidate.registrations instanceof Map && candidate.multiRegistrations instanceof Map && parentValid && requestScopeValid;
+  return candidate.registrations instanceof Map && candidate.multiRegistrations instanceof Map && candidate.singletonCache instanceof Map && parentValid && requestScopeValid;
 }
 function toContainerIntrospection(container) {
   if (!isContainerIntrospection(container)) {
@@ -108,6 +108,9 @@ function toContainerIntrospection(container) {
 function isPromiseLike(value) {
   return (typeof value === 'object' || typeof value === 'function') && value !== null && typeof value.then === 'function';
 }
+function rootContainerIntrospection(target) {
+  return target.parent ? rootContainerIntrospection(target.parent) : target;
+}
 function collectMultiProviders(target, token) {
   const fromParent = target.parent ? collectMultiProviders(target.parent, token) : [];
   const local = target.multiRegistrations.get(token) ?? [];
@@ -123,6 +126,70 @@ function lookupProvider(target, token) {
 function hasToken(state, token) {
   return lookupProvider(state.introspection, token) !== undefined || collectMultiProviders(state.introspection, token).length > 0;
 }
+function dependencyToken(entry) {
+  if (isOptionalToken(entry)) {
+    return entry.token;
+  }
+  if (isForwardRef(entry)) {
+    return entry.forwardRef();
+  }
+  return entry;
+}
+function trackFactoryResolutionKind(provider, factoryResolutionKinds) {
+  if (provider.type !== 'factory' || !provider.useFactory) {
+    return;
+  }
+  const originalFactory = provider.useFactory;
+  provider.useFactory = (...deps) => {
+    const value = originalFactory(...deps);
+    factoryResolutionKinds.set(provider, isPromiseLike(value) ? 'async' : 'sync');
+    return value;
+  };
+}
+function installFactoryResolutionTracking(target, factoryResolutionKinds) {
+  if (target.parent) {
+    installFactoryResolutionTracking(target.parent, factoryResolutionKinds);
+  }
+  for (const provider of target.registrations.values()) {
+    trackFactoryResolutionKind(provider, factoryResolutionKinds);
+  }
+  for (const providers of target.multiRegistrations.values()) {
+    for (const provider of providers) {
+      trackFactoryResolutionKind(provider, factoryResolutionKinds);
+    }
+  }
+}
+function providerGraphIsSyncResolvable(state, token, visited = new Set()) {
+  if (visited.has(token)) {
+    return true;
+  }
+  visited.add(token);
+  try {
+    const provider = lookupProvider(state.introspection, token);
+    const multiProviders = collectMultiProviders(state.introspection, token);
+    const providers = provider ? [provider, ...multiProviders] : multiProviders;
+    return providers.every(candidate => {
+      if (candidate.type === 'factory') {
+        return state.factoryResolutionKinds.get(candidate) === 'sync';
+      }
+      if (candidate.type === 'existing') {
+        return candidate.useExisting !== undefined && providerGraphIsSyncResolvable(state, candidate.useExisting, visited);
+      }
+      return candidate.inject.every(entry => {
+        if (isOptionalToken(entry) && !hasToken(state, entry.token)) {
+          return true;
+        }
+        return providerGraphIsSyncResolvable(state, dependencyToken(entry), visited);
+      });
+    });
+  } finally {
+    visited.delete(token);
+  }
+}
+function canPromoteCachedSingleton(state, token) {
+  const provider = lookupProvider(state.introspection, token);
+  return provider !== undefined && provider.scope !== 'request' && providerGraphIsSyncResolvable(state, token);
+}
 function resolveSyncDependency(entry, state) {
   if (isOptionalToken(entry)) {
     if (!hasToken(state, entry.token)) {
@@ -181,11 +248,15 @@ function resolveSyncProvider(provider, state) {
   if (provider.scope === 'transient') {
     return instantiateSyncProvider(provider, state);
   }
+  if (state.syncSingletonValues.has(provider.provide)) {
+    return state.syncSingletonValues.get(provider.provide);
+  }
   if (state.singletonCache.has(provider.provide)) {
-    return state.singletonCache.get(provider.provide);
+    throw new Error(`Token ${String(provider.provide)} was already resolved asynchronously. Use resolve() instead of get() for this provider.`);
   }
   const instance = instantiateSyncProvider(provider, state);
-  state.singletonCache.set(provider.provide, instance);
+  state.syncSingletonValues.set(provider.provide, instance);
+  state.singletonCache.set(provider.provide, Promise.resolve(instance));
   return instance;
 }
 function resolveSyncToken(token, state) {
@@ -208,12 +279,27 @@ function resolveSyncToken(token, state) {
   }
 }
 function createSyncResolver(container) {
+  const introspection = toContainerIntrospection(container);
+  const factoryResolutionKinds = new WeakMap();
+  installFactoryResolutionTracking(introspection, factoryResolutionKinds);
   const state = {
-    introspection: toContainerIntrospection(container),
+    factoryResolutionKinds,
+    introspection,
     resolutionChain: new Set(),
-    singletonCache: new Map()
+    singletonCache: rootContainerIntrospection(introspection).singletonCache,
+    syncSingletonValues: new Map()
+  };
+  return {
+    get: token => resolveSyncToken(token, state),
+    syncFromContainer: async () => {
+      for (const [token, promise] of state.singletonCache) {
+        if (!canPromoteCachedSingleton(state, token)) {
+          continue;
+        }
+        state.syncSingletonValues.set(token, await promise);
+      }
+    }
   };
-  return token => resolveSyncToken(token, state);
 }
 class DefaultOverrideProviderBuilder {
   constructor(builder, token) {
@@ -327,12 +413,16 @@ class DefaultTestingModuleBuilder {
   }
   createTestingModuleRef(bootstrapped) {
     const dispatcher = createTestingDispatcher(bootstrapped);
-    const getSync = createSyncResolver(bootstrapped.container);
+    const syncResolver = createSyncResolver(bootstrapped.container);
     return {
       ...bootstrapped,
       has: token => bootstrapped.container.has(token),
-      get: token => getSync(token),
-      resolve: token => bootstrapped.container.resolve(token),
+      get: token => syncResolver.get(token),
+      resolve: async token => {
+        const value = await bootstrapped.container.resolve(token);
+        await syncResolver.syncFromContainer();
+        return value;
+      },
       resolveAll: async tokens => {
         const results = [];
         const errors = [];
@@ -353,9 +443,14 @@ class DefaultTestingModuleBuilder {
           }) => `  - ${String(token)}: ${error instanceof Error ? error.message : String(error)}`).join('\n');
           throw new Error(`Failed to resolve ${errors.length} of ${tokens.length} tokens:\n${summary}`);
         }
+        await syncResolver.syncFromContainer();
         return results;
       },
-      dispatch: request => makeRequest(dispatcher, request)
+      dispatch: async request => {
+        const response = await makeRequest(dispatcher, request);
+        await syncResolver.syncFromContainer();
+        return response;
+      }
     };
   }
   _applyModuleReplacements(module) {

package/dist/portability/http-adapter-portability.d.ts

@@ -25,6 +25,14 @@ export interface HttpAdapterPortabilityHarnessOptions<TBootstrapOptions extends
      * @returns A promise that resolves to the application instance.
      */
     bootstrap: (rootModule: ModuleType, options: TBootstrapOptions) => Promise<TApp>;
+    /**
+     * Optional adapter-specific content type used by the exact-byte raw-body portability assertion.
+     */
+    exactRawBodyByteContentType?: string;
+    /**
+     * Optional adapter-specific preparation used before the exact-byte raw-body portability assertion.
+     */
+    prepareExactRawBodyByteTest?: (app: TApp) => void | Promise<void>;
     /**
      * The name of the adapter being tested.
      */
@@ -60,6 +68,7 @@ export declare class HttpAdapterPortabilityHarness<TBootstrapOptions extends obj
      */
     assertPreservesMalformedCookieValues(): Promise<void>;
     assertPreservesRawBodyForJsonAndText(): Promise<void>;
+    assertPreservesExactRawBodyBytesForByteSensitivePayloads(): Promise<void>;
     assertExcludesRawBodyForMultipart(): Promise<void>;
     assertDefaultsMultipartTotalLimitToMaxBodySize(): Promise<void>;
     assertSupportsSseStreaming(): Promise<void>;

package/dist/portability/http-adapter-portability.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http-adapter-portability.d.ts","sourceRoot":"","sources":["../../src/portability/http-adapter-portability.ts"],"names":[],"mappings":"AAUA,OAAO,EAGL,KAAK,UAAU,EACf,KAAK,YAAY,EAClB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,QAAQ,cAAc,CAAC;IAC5B,UAAU,gBAAgB;QACxB,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC;QACvB,OAAO,CAAC,EAAE,UAAU,CAAC;KACtB;CACF;AAED,KAAK,OAAO,GAAG;IACb,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,oCAAoC,CACnD,iBAAiB,SAAS,MAAM,EAChC,WAAW,SAAS,MAAM,EAC1B,IAAI,SAAS,OAAO,GAAG,OAAO;IAE9B;;;;;;OAMG;IACH,SAAS,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjF;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;;OAMG;IACH,GAAG,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACtE;AAuDD;;;;;;;GAOG;AACH,qBAAa,6BAA6B,CACxC,iBAAiB,SAAS,MAAM,EAChC,WAAW,SAAS,MAAM,EAC1B,IAAI,SAAS,OAAO,GAAG,OAAO;IAOlB,OAAO,CAAC,QAAQ,CAAC,OAAO;IALpC;;;;OAIG;gBAC0B,OAAO,EAAE,oCAAoC,CAAC,iBAAiB,EAAE,WAAW,EAAE,IAAI,CAAC;IAEhH;;;OAGG;IACG,oCAAoC,IAAI,OAAO,CAAC,IAAI,CAAC;IA+CrD,oCAAoC,IAAI,OAAO,CAAC,IAAI,CAAC;IA8DrD,iCAAiC,IAAI,OAAO,CAAC,IAAI,CAAC;IA8ClD,8CAA8C,IAAI,OAAO,CAAC,IAAI,CAAC;IAwD/D,0BAA0B,IAAI,OAAO,CAAC,IAAI,CAAC;IAkDjD;;;OAGG;IACG,mCAAmC,IAAI,OAAO,CAAC,IAAI,CAAC;IAqDpD,wCAAwC,IAAI,OAAO,CAAC,IAAI,CAAC;IAuDzD,4BAA4B,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAuDjF,8CAA8C,IAAI,OAAO,CAAC,IAAI,CAAC;CA2CtE;AAED;;;;;;;;GAQG;AACH,wBAAgB,mCAAmC,CACjD,iBAAiB,SAAS,MAAM,EAChC,WAAW,SAAS,MAAM,EAC1B,IAAI,SAAS,OAAO,GAAG,OAAO,EAE9B,OAAO,EAAE,oCAAoC,CAAC,iBAAiB,EAAE,WAAW,EAAE,IAAI,CAAC,GAClF,6BAA6B,CAAC,iBAAiB,EAAE,WAAW,EAAE,IAAI,CAAC,CAErE"}
+{"version":3,"file":"http-adapter-portability.d.ts","sourceRoot":"","sources":["../../src/portability/http-adapter-portability.ts"],"names":[],"mappings":"AAUA,OAAO,EAGL,KAAK,UAAU,EACf,KAAK,YAAY,EAClB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,QAAQ,cAAc,CAAC;IAC5B,UAAU,gBAAgB;QACxB,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC;QACvB,OAAO,CAAC,EAAE,UAAU,CAAC;KACtB;CACF;AAED,KAAK,OAAO,GAAG;IACb,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,oCAAoC,CACnD,iBAAiB,SAAS,MAAM,EAChC,WAAW,SAAS,MAAM,EAC1B,IAAI,SAAS,OAAO,GAAG,OAAO;IAE9B;;;;;;OAMG;IACH,SAAS,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjF;;OAEG;IACH,2BAA2B,CAAC,EAAE,MAAM,CAAC;IAErC;;OAEG;IACH,2BAA2B,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElE;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;;OAMG;IACH,GAAG,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACtE;AAuDD;;;;;;;GAOG;AACH,qBAAa,6BAA6B,CACxC,iBAAiB,SAAS,MAAM,EAChC,WAAW,SAAS,MAAM,EAC1B,IAAI,SAAS,OAAO,GAAG,OAAO;IAOlB,OAAO,CAAC,QAAQ,CAAC,OAAO;IALpC;;;;OAIG;gBAC0B,OAAO,EAAE,oCAAoC,CAAC,iBAAiB,EAAE,WAAW,EAAE,IAAI,CAAC;IAEhH;;;OAGG;IACG,oCAAoC,IAAI,OAAO,CAAC,IAAI,CAAC;IA+CrD,oCAAoC,IAAI,OAAO,CAAC,IAAI,CAAC;IA8DrD,wDAAwD,IAAI,OAAO,CAAC,IAAI,CAAC;IA6CzE,iCAAiC,IAAI,OAAO,CAAC,IAAI,CAAC;IA8ClD,8CAA8C,IAAI,OAAO,CAAC,IAAI,CAAC;IAwD/D,0BAA0B,IAAI,OAAO,CAAC,IAAI,CAAC;IAkDjD;;;OAGG;IACG,mCAAmC,IAAI,OAAO,CAAC,IAAI,CAAC;IAqDpD,wCAAwC,IAAI,OAAO,CAAC,IAAI,CAAC;IAuDzD,4BAA4B,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAuDjF,8CAA8C,IAAI,OAAO,CAAC,IAAI,CAAC;CA8CtE;AAED;;;;;;;;GAQG;AACH,wBAAgB,mCAAmC,CACjD,iBAAiB,SAAS,MAAM,EAChC,WAAW,SAAS,MAAM,EAC1B,IAAI,SAAS,OAAO,GAAG,OAAO,EAE9B,OAAO,EAAE,oCAAoC,CAAC,iBAAiB,EAAE,WAAW,EAAE,IAAI,CAAC,GAClF,6BAA6B,CAAC,iBAAiB,EAAE,WAAW,EAAE,IAAI,CAAC,CAErE"}

package/dist/portability/http-adapter-portability.js

@@ -210,18 +210,75 @@ export class HttpAdapterPortabilityHarness {
       await closeSilently(app);
     }
   }
-  async assertExcludesRawBodyForMultipart() {
+  async assertPreservesExactRawBodyBytesForByteSensitivePayloads() {
     let _initProto3, _initClass3;
+    let _WebhookController2;
+    class WebhookController {
+      static {
+        ({
+          e: [_initProto3],
+          c: [_WebhookController2, _initClass3]
+        } = _applyDecs(this, [Controller('/webhooks')], [[Post('/bytes'), 2, "handleBytes"]]));
+      }
+      constructor() {
+        _initProto3(this);
+      }
+      handleBytes(_input, context) {
+        return {
+          rawBytes: Array.from(context.request.rawBody ?? new Uint8Array())
+        };
+      }
+      static {
+        _initClass3();
+      }
+    }
+    class AppModule {}
+    defineModule(AppModule, {
+      controllers: [_WebhookController2]
+    });
+    const port = await findAvailablePort();
+    const app = await this.options.bootstrap(AppModule, {
+      cors: false,
+      port,
+      rawBody: true
+    });
+    await this.options.prepareExactRawBodyByteTest?.(app);
+    await app.listen();
+    try {
+      const payload = Uint8Array.from([0xe9, 0x41]);
+      const contentType = this.options.exactRawBodyByteContentType ?? 'text/plain; charset=latin1';
+      const response = await fetch(`http://127.0.0.1:${String(port)}/webhooks/bytes`, {
+        body: payload,
+        headers: {
+          'content-type': contentType
+        },
+        method: 'POST'
+      });
+      if (response.status !== 201) {
+        throw new Error(`${this.options.name} adapter changed byte-sensitive rawBody response status semantics.`);
+      }
+      const body = await response.json();
+      if (JSON.stringify(body) !== JSON.stringify({
+        rawBytes: Array.from(payload)
+      })) {
+        throw new Error(`${this.options.name} adapter changed exact-byte rawBody semantics.`);
+      }
+    } finally {
+      await closeSilently(app);
+    }
+  }
+  async assertExcludesRawBodyForMultipart() {
+    let _initProto4, _initClass4;
     let _UploadController;
     class UploadController {
       static {
         ({
-          e: [_initProto3],
-          c: [_UploadController, _initClass3]
+          e: [_initProto4],
+          c: [_UploadController, _initClass4]
         } = _applyDecs(this, [Controller('/uploads')], [[Post('/'), 2, "upload"]]));
       }
       constructor() {
-        _initProto3(this);
+        _initProto4(this);
       }
       upload(_input, context) {
         return {
@@ -231,7 +288,7 @@ export class HttpAdapterPortabilityHarness {
         };
       }
       static {
-        _initClass3();
+        _initClass4();
       }
     }
     class AppModule {}
@@ -273,17 +330,17 @@ export class HttpAdapterPortabilityHarness {
     }
   }
   async assertDefaultsMultipartTotalLimitToMaxBodySize() {
-    let _initProto4, _initClass4;
+    let _initProto5, _initClass5;
     let _UploadController2;
     class UploadController {
       static {
         ({
-          e: [_initProto4],
-          c: [_UploadController2, _initClass4]
+          e: [_initProto5],
+          c: [_UploadController2, _initClass5]
         } = _applyDecs(this, [Controller('/uploads')], [[Post('/'), 2, "upload"]]));
       }
       constructor() {
-        _initProto4(this);
+        _initProto5(this);
       }
       upload(_input, context) {
         return {
@@ -292,7 +349,7 @@ export class HttpAdapterPortabilityHarness {
         };
       }
       static {
-        _initClass4();
+        _initClass5();
       }
     }
     class AppModule {}
@@ -331,17 +388,17 @@ export class HttpAdapterPortabilityHarness {
     }
   }
   async assertSupportsSseStreaming() {
-    let _initProto5, _initClass5;
+    let _initProto6, _initClass6;
     let _EventsController;
     class EventsController {
       static {
         ({
-          e: [_initProto5],
-          c: [_EventsController, _initClass5]
+          e: [_initProto6],
+          c: [_EventsController, _initClass6]
         } = _applyDecs(this, [Controller('/events')], [[Get('/'), 2, "stream"]]));
       }
       constructor() {
-        _initProto5(this);
+        _initProto6(this);
       }
       stream(_input, context) {
         const stream = new SseResponse(context);
@@ -352,13 +409,13 @@ export class HttpAdapterPortabilityHarness {
           event: 'ready',
           id: 'evt-1'
         });
-        setTimeout(() => {
+        queueMicrotask(() => {
           stream.close();
-        }, 10);
+        });
         return stream;
       }
       static {
-        _initClass5();
+        _initClass6();
       }
     }
     class AppModule {}
@@ -398,7 +455,7 @@ export class HttpAdapterPortabilityHarness {
    * closes before a `drain` event is emitted.
    */
   async assertSettlesStreamDrainWaitOnClose() {
-    let _initProto6, _initClass6;
+    let _initProto7, _initClass7;
     const adapterName = this.options.name;
     let resolveDrainWait;
     const drainWaitSettled = new Promise(resolve => {
@@ -408,12 +465,12 @@ export class HttpAdapterPortabilityHarness {
     class EventsController {
       static {
         ({
-          e: [_initProto6],
-          c: [_EventsController2, _initClass6]
+          e: [_initProto7],
+          c: [_EventsController2, _initClass7]
         } = _applyDecs(this, [Controller('/events')], [[Get('/'), 2, "stream"]]));
       }
       constructor() {
-        _initProto6(this);
+        _initProto7(this);
       }
       async stream(_input, context) {
         const stream = new SseResponse(context);
@@ -428,7 +485,7 @@ export class HttpAdapterPortabilityHarness {
         return stream;
       }
       static {
-        _initClass6();
+        _initClass7();
       }
     }
     class AppModule {}
@@ -457,7 +514,7 @@ export class HttpAdapterPortabilityHarness {
     }
   }
   async assertReportsConfiguredHostInStartupLogs() {
-    let _initProto7, _initClass7;
+    let _initProto8, _initClass8;
     const loggerEvents = [];
     const logger = {
       debug() {},
@@ -473,12 +530,12 @@ export class HttpAdapterPortabilityHarness {
     class HealthController {
       static {
         ({
-          e: [_initProto7],
-          c: [_HealthController, _initClass7]
+          e: [_initProto8],
+          c: [_HealthController, _initClass8]
         } = _applyDecs(this, [Controller('/health')], [[Get('/'), 2, "getHealth"]]));
       }
       constructor() {
-        _initProto7(this);
+        _initProto8(this);
       }
       getHealth() {
         return {
@@ -486,7 +543,7 @@ export class HttpAdapterPortabilityHarness {
         };
       }
       static {
-        _initClass7();
+        _initClass8();
       }
     }
     class AppModule {}
@@ -520,7 +577,7 @@ export class HttpAdapterPortabilityHarness {
     }
   }
   async assertReportsHttpsStartupUrl(https) {
-    let _initProto8, _initClass8;
+    let _initProto9, _initClass9;
     const loggerEvents = [];
     const logger = {
       debug() {},
@@ -536,12 +593,12 @@ export class HttpAdapterPortabilityHarness {
     class HealthController {
       static {
         ({
-          e: [_initProto8],
-          c: [_HealthController2, _initClass8]
+          e: [_initProto9],
+          c: [_HealthController2, _initClass9]
         } = _applyDecs(this, [Controller('/health')], [[Get('/'), 2, "getHealth"]]));
       }
       constructor() {
-        _initProto8(this);
+        _initProto9(this);
       }
       getHealth() {
         return {
@@ -549,7 +606,7 @@ export class HttpAdapterPortabilityHarness {
         };
       }
       static {
-        _initClass8();
+        _initClass9();
       }
     }
     class AppModule {}
@@ -583,7 +640,7 @@ export class HttpAdapterPortabilityHarness {
     }
   }
   async assertRemovesShutdownSignalListenersAfterClose() {
-    let _initProto9, _initClass9;
+    let _initProto0, _initClass0;
     const logger = {
       debug() {},
       error() {},
@@ -594,12 +651,12 @@ export class HttpAdapterPortabilityHarness {
     class HealthController {
       static {
         ({
-          e: [_initProto9],
-          c: [_HealthController3, _initClass9]
+          e: [_initProto0],
+          c: [_HealthController3, _initClass0]
         } = _applyDecs(this, [Controller('/health')], [[Get('/'), 2, "getHealth"]]));
       }
       constructor() {
-        _initProto9(this);
+        _initProto0(this);
       }
       getHealth() {
         return {
@@ -607,7 +664,7 @@ export class HttpAdapterPortabilityHarness {
         };
       }
       static {
-        _initClass9();
+        _initClass0();
       }
     }
     class AppModule {}
@@ -615,7 +672,7 @@ export class HttpAdapterPortabilityHarness {
       controllers: [_HealthController3]
     });
     const signal = 'SIGTERM';
-    const listenersBefore = process.listeners(signal).length;
+    const listenersBefore = new Set(process.listeners(signal));
     const port = await findAvailablePort();
     const app = await this.options.run(AppModule, {
       cors: false,
@@ -623,14 +680,17 @@ export class HttpAdapterPortabilityHarness {
       port,
       shutdownSignals: [signal]
     });
+    const registeredListeners = process.listeners(signal).filter(listener => !listenersBefore.has(listener));
     try {
-      if (process.listeners(signal).length !== listenersBefore + 1) {
+      if (registeredListeners.length === 0) {
         throw new Error(`${this.options.name} adapter did not register the expected shutdown listener.`);
       }
     } finally {
       await closeSilently(app);
     }
-    if (process.listeners(signal).length !== listenersBefore) {
+    const remainingListeners = process.listeners(signal);
+    const leakedListeners = registeredListeners.filter(listener => remainingListeners.includes(listener));
+    if (leakedListeners.length > 0) {
       throw new Error(`${this.options.name} adapter leaked shutdown signal listeners after close().`);
     }
   }
@@ -648,14 +708,14 @@ export class HttpAdapterPortabilityHarness {
 export function createHttpAdapterPortabilityHarness(options) {
   return new HttpAdapterPortabilityHarness(options);
 }
-function withTimeout(promise, timeoutMs, message) {
+async function withTimeout(promise, timeoutMs, message) {
   let timeout;
   const timeoutPromise = new Promise((_resolve, reject) => {
     timeout = setTimeout(() => {
       reject(new Error(message));
     }, timeoutMs);
   });
-  return Promise.race([promise, timeoutPromise]).finally(() => {
+  return await Promise.race([promise, timeoutPromise]).finally(() => {
     if (timeout !== undefined) {
       clearTimeout(timeout);
     }

package/dist/portability/web-runtime-adapter-portability.d.ts

@@ -9,18 +9,31 @@ type WebRuntimePortabilityAppLike = {
     close(): Promise<void>;
     dispatch(request: Request): Promise<Response>;
 };
+/**
+ * Describes the web runtime http adapter portability harness options contract.
+ */
 export interface WebRuntimeHttpAdapterPortabilityHarnessOptions<TBootstrapOptions extends object, TApp extends WebRuntimePortabilityAppLike = WebRuntimePortabilityAppLike> {
     bootstrap: (rootModule: ModuleType, options: TBootstrapOptions) => Promise<TApp>;
     name: string;
 }
+/**
+ * Represents the web runtime http adapter portability harness.
+ */
 export declare class WebRuntimeHttpAdapterPortabilityHarness<TBootstrapOptions extends object, TApp extends WebRuntimePortabilityAppLike = WebRuntimePortabilityAppLike> {
     private readonly options;
     constructor(options: WebRuntimeHttpAdapterPortabilityHarnessOptions<TBootstrapOptions, TApp>);
+    assertPreservesQueryArraysAndDecoding(): Promise<void>;
     assertPreservesMalformedCookieValues(): Promise<void>;
     assertPreservesRawBodyForJsonAndText(): Promise<void>;
     assertExcludesRawBodyForMultipart(): Promise<void>;
     assertSupportsSseStreaming(): Promise<void>;
 }
+/**
+ * Create web runtime http adapter portability harness.
+ *
+ * @param options The options.
+ * @returns The create web runtime http adapter portability harness result.
+ */
 export declare function createWebRuntimeHttpAdapterPortabilityHarness<TBootstrapOptions extends object, TApp extends WebRuntimePortabilityAppLike = WebRuntimePortabilityAppLike>(options: WebRuntimeHttpAdapterPortabilityHarnessOptions<TBootstrapOptions, TApp>): WebRuntimeHttpAdapterPortabilityHarness<TBootstrapOptions, TApp>;
 export {};
 //# sourceMappingURL=web-runtime-adapter-portability.d.ts.map

package/dist/portability/web-runtime-adapter-portability.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"web-runtime-adapter-portability.d.ts","sourceRoot":"","sources":["../../src/portability/web-runtime-adapter-portability.ts"],"names":[],"mappings":"AAGA,OAAO,EAAgB,KAAK,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEnF,OAAO,QAAQ,cAAc,CAAC;IAC5B,UAAU,gBAAgB;QACxB,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC;QACvB,OAAO,CAAC,EAAE,UAAU,CAAC;KACtB;CACF;AAED,KAAK,4BAA4B,GAAG;IAClC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC/C,CAAC;AAEF,MAAM,WAAW,8CAA8C,CAC7D,iBAAiB,SAAS,MAAM,EAChC,IAAI,SAAS,4BAA4B,GAAG,4BAA4B;IAExE,SAAS,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjF,IAAI,EAAE,MAAM,CAAC;CACd;AAYD,qBAAa,uCAAuC,CAClD,iBAAiB,SAAS,MAAM,EAChC,IAAI,SAAS,4BAA4B,GAAG,4BAA4B;IAE5D,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,8CAA8C,CAAC,iBAAiB,EAAE,IAAI,CAAC;IAEvG,oCAAoC,IAAI,OAAO,CAAC,IAAI,CAAC;IA4CrD,oCAAoC,IAAI,OAAO,CAAC,IAAI,CAAC;IA2DrD,iCAAiC,IAAI,OAAO,CAAC,IAAI,CAAC;IA2ClD,0BAA0B,IAAI,OAAO,CAAC,IAAI,CAAC;CA4ClD;AAED,wBAAgB,6CAA6C,CAC3D,iBAAiB,SAAS,MAAM,EAChC,IAAI,SAAS,4BAA4B,GAAG,4BAA4B,EAExE,OAAO,EAAE,8CAA8C,CAAC,iBAAiB,EAAE,IAAI,CAAC,GAC/E,uCAAuC,CAAC,iBAAiB,EAAE,IAAI,CAAC,CAElE"}
+{"version":3,"file":"web-runtime-adapter-portability.d.ts","sourceRoot":"","sources":["../../src/portability/web-runtime-adapter-portability.ts"],"names":[],"mappings":"AAGA,OAAO,EAAgB,KAAK,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEnF,OAAO,QAAQ,cAAc,CAAC;IAC5B,UAAU,gBAAgB;QACxB,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC;QACvB,OAAO,CAAC,EAAE,UAAU,CAAC;KACtB;CACF;AAED,KAAK,4BAA4B,GAAG;IAClC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC/C,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,8CAA8C,CAC7D,iBAAiB,SAAS,MAAM,EAChC,IAAI,SAAS,4BAA4B,GAAG,4BAA4B;IAExE,SAAS,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjF,IAAI,EAAE,MAAM,CAAC;CACd;AAYD;;GAEG;AACH,qBAAa,uCAAuC,CAClD,iBAAiB,SAAS,MAAM,EAChC,IAAI,SAAS,4BAA4B,GAAG,4BAA4B;IAE5D,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,8CAA8C,CAAC,iBAAiB,EAAE,IAAI,CAAC;IAEvG,qCAAqC,IAAI,OAAO,CAAC,IAAI,CAAC;IAuCtD,oCAAoC,IAAI,OAAO,CAAC,IAAI,CAAC;IA4CrD,oCAAoC,IAAI,OAAO,CAAC,IAAI,CAAC;IA2DrD,iCAAiC,IAAI,OAAO,CAAC,IAAI,CAAC;IA2ClD,0BAA0B,IAAI,OAAO,CAAC,IAAI,CAAC;CA4ClD;AAED;;;;;GAKG;AACH,wBAAgB,6CAA6C,CAC3D,iBAAiB,SAAS,MAAM,EAChC,IAAI,SAAS,4BAA4B,GAAG,4BAA4B,EAExE,OAAO,EAAE,8CAA8C,CAAC,iBAAiB,EAAE,IAAI,CAAC,GAC/E,uCAAuC,CAAC,iBAAiB,EAAE,IAAI,CAAC,CAElE"}