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

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 {}
@@ -272,18 +329,76 @@ export class HttpAdapterPortabilityHarness {
       await closeSilently(app);
     }
   }
+  async assertDefaultsMultipartTotalLimitToMaxBodySize() {
+    let _initProto5, _initClass5;
+    let _UploadController2;
+    class UploadController {
+      static {
+        ({
+          e: [_initProto5],
+          c: [_UploadController2, _initClass5]
+        } = _applyDecs(this, [Controller('/uploads')], [[Post('/'), 2, "upload"]]));
+      }
+      constructor() {
+        _initProto5(this);
+      }
+      upload(_input, context) {
+        return {
+          body: context.request.body,
+          fileCount: context.request.files?.length ?? 0
+        };
+      }
+      static {
+        _initClass5();
+      }
+    }
+    class AppModule {}
+    defineModule(AppModule, {
+      controllers: [_UploadController2]
+    });
+    const port = await findAvailablePort();
+    const app = await this.options.bootstrap(AppModule, {
+      cors: false,
+      maxBodySize: 8,
+      multipart: {
+        maxFileSize: 1024
+      },
+      port
+    });
+    await app.listen();
+    try {
+      const form = new FormData();
+      form.set('name', 'Ada');
+      form.set('payload', new Blob(['12345678'], {
+        type: 'text/plain'
+      }), 'payload.txt');
+      const response = await fetch(`http://127.0.0.1:${String(port)}/uploads`, {
+        body: form,
+        method: 'POST'
+      });
+      if (response.status !== 413) {
+        throw new Error(`${this.options.name} adapter did not default multipart.maxTotalSize to maxBodySize.`);
+      }
+      const body = await response.json();
+      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 _initProto4, _initClass4;
+    let _initProto6, _initClass6;
     let _EventsController;
     class EventsController {
       static {
         ({
-          e: [_initProto4],
-          c: [_EventsController, _initClass4]
+          e: [_initProto6],
+          c: [_EventsController, _initClass6]
         } = _applyDecs(this, [Controller('/events')], [[Get('/'), 2, "stream"]]));
       }
       constructor() {
-        _initProto4(this);
+        _initProto6(this);
       }
       stream(_input, context) {
         const stream = new SseResponse(context);
@@ -294,13 +409,13 @@ export class HttpAdapterPortabilityHarness {
           event: 'ready',
           id: 'evt-1'
         });
-        setTimeout(() => {
+        queueMicrotask(() => {
           stream.close();
-        }, 10);
+        });
         return stream;
       }
       static {
-        _initClass4();
+        _initClass6();
       }
     }
     class AppModule {}
@@ -334,8 +449,72 @@ export class HttpAdapterPortabilityHarness {
       await closeSilently(app);
     }
   }
+
+  /**
+   * Asserts that adapter stream backpressure waiters settle when the response
+   * closes before a `drain` event is emitted.
+   */
+  async assertSettlesStreamDrainWaitOnClose() {
+    let _initProto7, _initClass7;
+    const adapterName = this.options.name;
+    let resolveDrainWait;
+    const drainWaitSettled = new Promise(resolve => {
+      resolveDrainWait = resolve;
+    });
+    let _EventsController2;
+    class EventsController {
+      static {
+        ({
+          e: [_initProto7],
+          c: [_EventsController2, _initClass7]
+        } = _applyDecs(this, [Controller('/events')], [[Get('/'), 2, "stream"]]));
+      }
+      constructor() {
+        _initProto7(this);
+      }
+      async stream(_input, context) {
+        const stream = new SseResponse(context);
+        const responseStream = context.response.stream;
+        if (!responseStream?.waitForDrain) {
+          throw new Error(`${adapterName} adapter did not expose response.stream.waitForDrain().`);
+        }
+        const drainWait = responseStream.waitForDrain();
+        stream.close();
+        await drainWait;
+        resolveDrainWait();
+        return stream;
+      }
+      static {
+        _initClass7();
+      }
+    }
+    class AppModule {}
+    defineModule(AppModule, {
+      controllers: [_EventsController2]
+    });
+    const port = await findAvailablePort();
+    const app = await this.options.bootstrap(AppModule, {
+      cors: false,
+      port
+    });
+    await app.listen();
+    try {
+      const response = await fetch(`http://127.0.0.1:${String(port)}/events`, {
+        headers: {
+          accept: 'text/event-stream'
+        }
+      });
+      if (response.status !== 200) {
+        throw new Error(`${this.options.name} adapter changed closed stream response status semantics.`);
+      }
+      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 _initProto5, _initClass5;
+    let _initProto8, _initClass8;
     const loggerEvents = [];
     const logger = {
       debug() {},
@@ -351,12 +530,12 @@ export class HttpAdapterPortabilityHarness {
     class HealthController {
       static {
         ({
-          e: [_initProto5],
-          c: [_HealthController, _initClass5]
+          e: [_initProto8],
+          c: [_HealthController, _initClass8]
         } = _applyDecs(this, [Controller('/health')], [[Get('/'), 2, "getHealth"]]));
       }
       constructor() {
-        _initProto5(this);
+        _initProto8(this);
       }
       getHealth() {
         return {
@@ -364,7 +543,7 @@ export class HttpAdapterPortabilityHarness {
         };
       }
       static {
-        _initClass5();
+        _initClass8();
       }
     }
     class AppModule {}
@@ -398,7 +577,7 @@ export class HttpAdapterPortabilityHarness {
     }
   }
   async assertReportsHttpsStartupUrl(https) {
-    let _initProto6, _initClass6;
+    let _initProto9, _initClass9;
     const loggerEvents = [];
     const logger = {
       debug() {},
@@ -414,12 +593,12 @@ export class HttpAdapterPortabilityHarness {
     class HealthController {
       static {
         ({
-          e: [_initProto6],
-          c: [_HealthController2, _initClass6]
+          e: [_initProto9],
+          c: [_HealthController2, _initClass9]
         } = _applyDecs(this, [Controller('/health')], [[Get('/'), 2, "getHealth"]]));
       }
       constructor() {
-        _initProto6(this);
+        _initProto9(this);
       }
       getHealth() {
         return {
@@ -427,7 +606,7 @@ export class HttpAdapterPortabilityHarness {
         };
       }
       static {
-        _initClass6();
+        _initClass9();
       }
     }
     class AppModule {}
@@ -461,7 +640,7 @@ export class HttpAdapterPortabilityHarness {
     }
   }
   async assertRemovesShutdownSignalListenersAfterClose() {
-    let _initProto7, _initClass7;
+    let _initProto0, _initClass0;
     const logger = {
       debug() {},
       error() {},
@@ -472,12 +651,12 @@ export class HttpAdapterPortabilityHarness {
     class HealthController {
       static {
         ({
-          e: [_initProto7],
-          c: [_HealthController3, _initClass7]
+          e: [_initProto0],
+          c: [_HealthController3, _initClass0]
         } = _applyDecs(this, [Controller('/health')], [[Get('/'), 2, "getHealth"]]));
       }
       constructor() {
-        _initProto7(this);
+        _initProto0(this);
       }
       getHealth() {
         return {
@@ -485,7 +664,7 @@ export class HttpAdapterPortabilityHarness {
         };
       }
       static {
-        _initClass7();
+        _initClass0();
       }
     }
     class AppModule {}
@@ -493,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,
@@ -501,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().`);
     }
   }
@@ -525,4 +707,17 @@ export class HttpAdapterPortabilityHarness {
  */
 export function createHttpAdapterPortabilityHarness(options) {
   return new HttpAdapterPortabilityHarness(options);
+}
+async function withTimeout(promise, timeoutMs, message) {
+  let timeout;
+  const timeoutPromise = new Promise((_resolve, reject) => {
+    timeout = setTimeout(() => {
+      reject(new Error(message));
+    }, timeoutMs);
+  });
+  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"}

package/dist/portability/web-runtime-adapter-portability.js

@@ -7,6 +7,11 @@ function _checkInRHS(e) { if (Object(e) !== e) throw TypeError("right-hand side
 import { Controller, Get, Post, SseResponse } from '@fluojs/http';
 // @ts-ignore Worktree-local LSP does not resolve workspace package aliases.
 import { defineModule } from '@fluojs/runtime';
+
+/**
+ * Describes the web runtime http adapter portability harness options contract.
+ */
+
 function decodeUtf8(input) {
   return new TextDecoder().decode(input ?? new Uint8Array());
 }
@@ -15,28 +20,72 @@ async function closeSilently(app) {
     await app.close();
   } catch {}
 }
+
+/**
+ * Represents the web runtime http adapter portability harness.
+ */
 export class WebRuntimeHttpAdapterPortabilityHarness {
   constructor(options) {
     this.options = options;
   }
-  async assertPreservesMalformedCookieValues() {
+  async assertPreservesQueryArraysAndDecoding() {
     let _initProto, _initClass;
+    let _QueryController;
+    class QueryController {
+      static {
+        ({
+          e: [_initProto],
+          c: [_QueryController, _initClass]
+        } = _applyDecs(this, [Controller('/query')], [[Get('/'), 2, "readQuery"]]));
+      }
+      constructor() {
+        _initProto(this);
+      }
+      readQuery(_input, context) {
+        return context.request.query;
+      }
+      static {
+        _initClass();
+      }
+    }
+    class AppModule {}
+    defineModule(AppModule, {
+      controllers: [_QueryController]
+    });
+    const app = await this.options.bootstrap(AppModule, {
+      cors: false
+    });
+    try {
+      const response = await app.dispatch(new Request('https://runtime.test/query?tag=one&tag=two&encoded=hello+world&flag&bad=%E0%A4%A'));
+      if (response.status !== 200) {
+        throw new Error(`${this.options.name} adapter changed query response status semantics.`);
+      }
+      const body = await response.json();
+      if (typeof body !== 'object' || body === null || body.bad !== '�%A' || body.encoded !== 'hello world' || !Array.isArray(body.tag) || JSON.stringify(body.tag) !== JSON.stringify(['one', 'two'])) {
+        throw new Error(`${this.options.name} adapter changed query decoding semantics.`);
+      }
+    } finally {
+      await closeSilently(app);
+    }
+  }
+  async assertPreservesMalformedCookieValues() {
+    let _initProto2, _initClass2;
     let _CookieController;
     class CookieController {
       static {
         ({
-          e: [_initProto],
-          c: [_CookieController, _initClass]
+          e: [_initProto2],
+          c: [_CookieController, _initClass2]
         } = _applyDecs(this, [Controller('/cookies')], [[Get('/'), 2, "readCookies"]]));
       }
       constructor() {
-        _initProto(this);
+        _initProto2(this);
       }
       readCookies(_input, context) {
         return context.request.cookies;
       }
       static {
-        _initClass();
+        _initClass2();
       }
     }
     class AppModule {}
@@ -64,17 +113,17 @@ export class WebRuntimeHttpAdapterPortabilityHarness {
     }
   }
   async assertPreservesRawBodyForJsonAndText() {
-    let _initProto2, _initClass2;
+    let _initProto3, _initClass3;
     let _WebhookController;
     class WebhookController {
       static {
         ({
-          e: [_initProto2],
-          c: [_WebhookController, _initClass2]
+          e: [_initProto3],
+          c: [_WebhookController, _initClass3]
         } = _applyDecs(this, [Controller('/webhooks')], [[Post('/json'), 2, "handleJson"], [Post('/text'), 2, "handleText"]]));
       }
       constructor() {
-        _initProto2(this);
+        _initProto3(this);
       }
       handleJson(_input, context) {
         return {
@@ -89,7 +138,7 @@ export class WebRuntimeHttpAdapterPortabilityHarness {
         };
       }
       static {
-        _initClass2();
+        _initClass3();
       }
     }
     class AppModule {}
@@ -139,17 +188,17 @@ export class WebRuntimeHttpAdapterPortabilityHarness {
     }
   }
   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 {
@@ -159,7 +208,7 @@ export class WebRuntimeHttpAdapterPortabilityHarness {
         };
       }
       static {
-        _initClass3();
+        _initClass4();
       }
     }
     class AppModule {}
@@ -198,17 +247,17 @@ export class WebRuntimeHttpAdapterPortabilityHarness {
     }
   }
   async assertSupportsSseStreaming() {
-    let _initProto4, _initClass4;
+    let _initProto5, _initClass5;
     let _EventsController;
     class EventsController {
       static {
         ({
-          e: [_initProto4],
-          c: [_EventsController, _initClass4]
+          e: [_initProto5],
+          c: [_EventsController, _initClass5]
         } = _applyDecs(this, [Controller('/events')], [[Get('/'), 2, "stream"]]));
       }
       constructor() {
-        _initProto4(this);
+        _initProto5(this);
       }
       stream(_input, context) {
         const stream = new SseResponse(context);
@@ -223,7 +272,7 @@ export class WebRuntimeHttpAdapterPortabilityHarness {
         return stream;
       }
       static {
-        _initClass4();
+        _initClass5();
       }
     }
     class AppModule {}
@@ -255,6 +304,13 @@ export class WebRuntimeHttpAdapterPortabilityHarness {
     }
   }
 }
+
+/**
+ * Create web runtime http adapter portability harness.
+ *
+ * @param options The options.
+ * @returns The create web runtime http adapter portability harness result.
+ */
 export function createWebRuntimeHttpAdapterPortabilityHarness(options) {
   return new WebRuntimeHttpAdapterPortabilityHarness(options);
 }

package/dist/types.d.ts

@@ -1,7 +1,7 @@
 import type { Mock } from 'vitest';
 import type { MaybePromise, Token } from '@fluojs/core';
 import type { ClassType, Container, ForwardRefFn, OptionalToken, Provider } from '@fluojs/di';
-import type { BootstrapResult, BootstrapModuleOptions, ModuleType } from '@fluojs/runtime';
+import type { BootstrapApplicationOptions, BootstrapResult, BootstrapModuleOptions, ModuleType } from '@fluojs/runtime';
 import type { Guard, Interceptor } from '@fluojs/http';
 import type { RequestBuilder, TestPrincipal, TestRequest, TestRequestWithOptions, TestResponse } from './http.js';
 /**
@@ -10,6 +10,12 @@ import type { RequestBuilder, TestPrincipal, TestRequest, TestRequestWithOptions
 export interface TestingModuleOptions extends BootstrapModuleOptions {
     rootModule: ModuleType;
 }
+/**
+ * Bootstrap options accepted by `createTestApp(...)`.
+ */
+export interface TestingApplicationOptions extends BootstrapApplicationOptions {
+    rootModule: ModuleType;
+}
 /**
  * Optional request extras accepted by `TestApp.request(...)` overloads.
  */

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}