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

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

@@ -57,10 +57,26 @@ async function requestHttps(url) {
     request.end();
   });
 }
-async function closeSilently(app) {
+async function runWithCleanup(app, adapterName, assertion) {
+  let hasAssertionError = false;
+  let assertionError;
+  try {
+    await assertion();
+  } catch (error) {
+    hasAssertionError = true;
+    assertionError = error;
+  }
   try {
     await app.close();
-  } catch {}
+  } catch (cleanupError) {
+    if (hasAssertionError) {
+      throw new AggregateError([assertionError, cleanupError], `${adapterName} adapter portability assertion failed and app.close() also failed during harness cleanup.`);
+    }
+    throw new AggregateError([cleanupError], `${adapterName} adapter app.close() failed during portability harness cleanup.`);
+  }
+  if (hasAssertionError) {
+    throw assertionError;
+  }
 }
 
 /**
@@ -115,7 +131,7 @@ export class HttpAdapterPortabilityHarness {
       port
     });
     await app.listen();
-    try {
+    await runWithCleanup(app, this.options.name, async () => {
       const response = await fetch(`http://127.0.0.1:${String(port)}/cookies`, {
         headers: {
           cookie: 'good=hello%20world; bad=%E0%A4%A'
@@ -128,9 +144,7 @@ export class HttpAdapterPortabilityHarness {
       if (typeof body !== 'object' || body === null || !('bad' in body) || !('good' in body) || body.bad !== '%E0%A4%A' || body.good !== 'hello world' || Object.keys(body).length !== 2) {
         throw new Error(`${this.options.name} adapter changed malformed-cookie normalization.`);
       }
-    } finally {
-      await closeSilently(app);
-    }
+    });
   }
   async assertPreservesRawBodyForJsonAndText() {
     let _initProto2, _initClass2;
@@ -172,7 +186,7 @@ export class HttpAdapterPortabilityHarness {
       rawBody: true
     });
     await app.listen();
-    try {
+    await runWithCleanup(app, this.options.name, async () => {
       const [jsonResponse, textResponse] = await Promise.all([fetch(`http://127.0.0.1:${String(port)}/webhooks/json`, {
         body: JSON.stringify({
           provider: 'stripe'
@@ -206,22 +220,75 @@ export class HttpAdapterPortabilityHarness {
       })) {
         throw new Error(`${this.options.name} adapter changed text rawBody semantics.`);
       }
-    } finally {
-      await closeSilently(app);
+    });
+  }
+  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();
+    await runWithCleanup(app, this.options.name, async () => {
+      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.`);
+      }
+    });
   }
   async assertExcludesRawBodyForMultipart() {
-    let _initProto3, _initClass3;
+    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 +298,7 @@ export class HttpAdapterPortabilityHarness {
         };
       }
       static {
-        _initClass3();
+        _initClass4();
       }
     }
     class AppModule {}
@@ -245,7 +312,7 @@ export class HttpAdapterPortabilityHarness {
       rawBody: true
     });
     await app.listen();
-    try {
+    await runWithCleanup(app, this.options.name, async () => {
       const form = new FormData();
       form.set('name', 'Ada');
       form.set('payload', new Blob(['hello'], {
@@ -268,22 +335,20 @@ export class HttpAdapterPortabilityHarness {
       })) {
         throw new Error(`${this.options.name} adapter changed multipart rawBody semantics.`);
       }
-    } finally {
-      await closeSilently(app);
-    }
+    });
   }
   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 +357,7 @@ export class HttpAdapterPortabilityHarness {
         };
       }
       static {
-        _initClass4();
+        _initClass5();
       }
     }
     class AppModule {}
@@ -309,7 +374,7 @@ export class HttpAdapterPortabilityHarness {
       port
     });
     await app.listen();
-    try {
+    await runWithCleanup(app, this.options.name, async () => {
       const form = new FormData();
       form.set('name', 'Ada');
       form.set('payload', new Blob(['12345678'], {
@@ -326,22 +391,20 @@ export class HttpAdapterPortabilityHarness {
       if (typeof body !== 'object' || body === null || body.error?.code !== 'PAYLOAD_TOO_LARGE') {
         throw new Error(`${this.options.name} adapter changed multipart limit error semantics.`);
       }
-    } finally {
-      await closeSilently(app);
-    }
+    });
   }
   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 +415,13 @@ export class HttpAdapterPortabilityHarness {
           event: 'ready',
           id: 'evt-1'
         });
-        setTimeout(() => {
+        queueMicrotask(() => {
           stream.close();
-        }, 10);
+        });
         return stream;
       }
       static {
-        _initClass5();
+        _initClass6();
       }
     }
     class AppModule {}
@@ -371,7 +434,7 @@ export class HttpAdapterPortabilityHarness {
       port
     });
     await app.listen();
-    try {
+    await runWithCleanup(app, this.options.name, async () => {
       const response = await fetch(`http://127.0.0.1:${String(port)}/events`, {
         headers: {
           accept: 'text/event-stream'
@@ -388,9 +451,7 @@ export class HttpAdapterPortabilityHarness {
       if (!body.includes('event: ready') || !body.includes('data: {"ready":true}')) {
         throw new Error(`${this.options.name} adapter changed SSE body framing.`);
       }
-    } finally {
-      await closeSilently(app);
-    }
+    });
   }
 
   /**
@@ -398,7 +459,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 +469,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 +489,7 @@ export class HttpAdapterPortabilityHarness {
         return stream;
       }
       static {
-        _initClass6();
+        _initClass7();
       }
     }
     class AppModule {}
@@ -441,7 +502,7 @@ export class HttpAdapterPortabilityHarness {
       port
     });
     await app.listen();
-    try {
+    await runWithCleanup(app, this.options.name, async () => {
       const response = await fetch(`http://127.0.0.1:${String(port)}/events`, {
         headers: {
           accept: 'text/event-stream'
@@ -452,12 +513,10 @@ export class HttpAdapterPortabilityHarness {
       }
       await response.text();
       await withTimeout(drainWaitSettled, 2_000, `${this.options.name} adapter left response.stream.waitForDrain() pending after close.`);
-    } finally {
-      await closeSilently(app);
-    }
+    });
   }
   async assertReportsConfiguredHostInStartupLogs() {
-    let _initProto7, _initClass7;
+    let _initProto8, _initClass8;
     const loggerEvents = [];
     const logger = {
       debug() {},
@@ -473,12 +532,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 +545,7 @@ export class HttpAdapterPortabilityHarness {
         };
       }
       static {
-        _initClass7();
+        _initClass8();
       }
     }
     class AppModule {}
@@ -500,7 +559,7 @@ export class HttpAdapterPortabilityHarness {
       logger,
       port
     });
-    try {
+    await runWithCleanup(app, this.options.name, async () => {
       const response = await fetch(`http://127.0.0.1:${String(port)}/health`);
       if (response.status !== 200) {
         throw new Error(`${this.options.name} adapter changed host-bound health response semantics.`);
@@ -515,12 +574,10 @@ export class HttpAdapterPortabilityHarness {
       if (!loggerEvents.includes(expectedLog)) {
         throw new Error(`${this.options.name} adapter changed startup host logging.`);
       }
-    } finally {
-      await closeSilently(app);
-    }
+    });
   }
   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 {}
@@ -564,7 +621,7 @@ export class HttpAdapterPortabilityHarness {
       logger,
       port
     });
-    try {
+    await runWithCleanup(app, this.options.name, async () => {
       const response = await requestHttps(`https://127.0.0.1:${String(port)}/health`);
       if (response.statusCode !== 200) {
         throw new Error(`${this.options.name} adapter changed HTTPS response status semantics.`);
@@ -578,12 +635,10 @@ export class HttpAdapterPortabilityHarness {
       if (!loggerEvents.includes(expectedLog)) {
         throw new Error(`${this.options.name} adapter changed HTTPS startup logging.`);
       }
-    } finally {
-      await closeSilently(app);
-    }
+    });
   }
   async assertRemovesShutdownSignalListenersAfterClose() {
-    let _initProto9, _initClass9;
+    let _initProto0, _initClass0;
     const logger = {
       debug() {},
       error() {},
@@ -594,12 +649,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 +662,7 @@ export class HttpAdapterPortabilityHarness {
         };
       }
       static {
-        _initClass9();
+        _initClass0();
       }
     }
     class AppModule {}
@@ -615,7 +670,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 +678,15 @@ export class HttpAdapterPortabilityHarness {
       port,
       shutdownSignals: [signal]
     });
-    try {
-      if (process.listeners(signal).length !== listenersBefore + 1) {
+    const registeredListeners = process.listeners(signal).filter(listener => !listenersBefore.has(listener));
+    await runWithCleanup(app, this.options.name, async () => {
+      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 +704,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":"AACA,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;AA0CD;;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;IAyCtD,oCAAoC,IAAI,OAAO,CAAC,IAAI,CAAC;IAgDrD,oCAAoC,IAAI,OAAO,CAAC,IAAI,CAAC;IAsErD,iCAAiC,IAAI,OAAO,CAAC,IAAI,CAAC;IAqDlD,0BAA0B,IAAI,OAAO,CAAC,IAAI,CAAC;CA8ClD;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"}