@fluojs/testing 1.0.0 → 1.0.2

package/README.ko.md

@@ -23,7 +23,7 @@ fluo 애플리케이션을 위한 기본 request-level 테스트 헬퍼, 모듈
 pnpm add -D @fluojs/testing vitest
 ```
 
-`vitest`는 mock 헬퍼와 `@fluojs/testing/vitest` 엔트리포인트가 요구하는 peer dependency입니다.
+`vitest`는 mock 헬퍼와 `@fluojs/testing/vitest` 엔트리포인트가 요구하는 peer dependency입니다. `@babel/core`는 Vitest decorators plugin이 사용하는 워크스페이스의 Babel을 로드하기 때문에 peer로 선언되어 있습니다. 따라서 non-Vitest harness subpath만 사용하더라도 패키지 매니저가 해당 peer 경고를 표시할 수 있습니다.
 
 `@fluojs/testing/vitest`를 사용할 때는 `fluoBabelDecoratorsPlugin()`이 런타임에 Babel을 호출하므로, 사용하는 워크스페이스에 `@babel/core`도 함께 설치해야 합니다. Vitest 플러그인은 Vite query/hash suffix를 제거한 뒤 `.ts`, `.tsx`, `.mts`, `.cts` 소스 id를 변환하고, `node_modules`는 건너뛰며, 가장 가까운 root Babel config인 `babel.config.cjs`, `babel.config.mjs`, `babel.config.js`, `babel.config.json`을 해석합니다.
 
@@ -134,9 +134,11 @@ const mailer = createDeepMock(MailService);
 
 프레임워크 지향 플랫폼 패키지를 작성할 때는 `@fluojs/testing/platform-conformance`, `@fluojs/testing/http-adapter-portability`, `@fluojs/testing/web-runtime-adapter-portability` 같은 서브패스를 사용해 적합성 및 이식성 검증을 수행합니다.
 
-이식성 하니스의 cleanup도 계약에 포함됩니다. `app.close()`가 실패하면 하니스는 cleanup 실패를 보고하며, assertion이 이미 실패한 경우에는 assertion 실패와 cleanup 실패를 모두 보존하는 aggregate error를 발생시킵니다.
+이식성 하니스의 cleanup도 계약에 포함됩니다. 앱이 bootstrap된 뒤 setup, `listen()`, assertion이 실패하면 하니스는 해당 partial app을 닫습니다. `app.close()`가 실패하면 하니스는 cleanup 실패를 보고하며, setup 또는 assertion이 이미 실패한 경우에는 원래 실패와 cleanup 실패를 모두 보존하는 aggregate error를 발생시킵니다.
 
-`HttpAdapterPortabilityHarness` 메서드는 공개 어댑터 계약 체크입니다. 직접 같은 검증을 다시 만들기보다 `assertPreservesMalformedCookieValues()`, `assertSupportsSseStreaming()`, `assertPreservesRawBodyForJsonAndText()`, `assertPreservesExactRawBodyBytesForByteSensitivePayloads()`, `assertExcludesRawBodyForMultipart()`, `assertDefaultsMultipartTotalLimitToMaxBodySize()`, `assertSettlesStreamDrainWaitOnClose()`, `assertReportsConfiguredHostInStartupLogs()`, `assertReportsHttpsStartupUrl(...)`, `assertRemovesShutdownSignalListenersAfterClose()`처럼 초점이 분명한 assertion을 사용하세요.
+`HttpAdapterPortabilityHarness`와 web-runtime portability harness 메서드는 공개 어댑터 계약 체크입니다. 직접 같은 검증을 다시 만들기보다 `assertPreservesMalformedCookieValues()`, `assertSupportsSseStreaming()`, `assertPreservesRawBodyForJsonAndText()`, `assertPreservesExactRawBodyBytesForByteSensitivePayloads()`, `assertExcludesRawBodyForMultipart()`, `assertDefaultsMultipartTotalLimitToMaxBodySize()`, `assertSettlesStreamDrainWaitOnClose()`, `assertReportsConfiguredHostInStartupLogs()`, `assertReportsHttpsStartupUrl(...)`, `assertRemovesShutdownSignalListenersAfterClose()`처럼 초점이 분명한 assertion을 사용하세요.
+
+HTTP 어댑터가 런타임 전반에서 `rawBody`의 byte-sensitive payload byte를 그대로 보존하는지 증명해야 할 때는 `assertPreservesExactRawBodyBytesForByteSensitivePayloads()`를 사용하세요.
 
 ## canonical TDD ladder
 

package/README.md

@@ -21,7 +21,7 @@ Default request-level testing helpers, testing module construction, and provider
 npm install --save-dev @fluojs/testing vitest
 ```
 
-`vitest` is a required peer dependency for the mock helpers and the `@fluojs/testing/vitest` entrypoint.
+`vitest` is a required peer dependency for the mock helpers and the `@fluojs/testing/vitest` entrypoint. `@babel/core` is declared as a peer because the Vitest decorators plugin loads Babel from the consuming workspace; package managers may surface that peer even when you only use the non-Vitest harness subpaths.
 
 If you use `@fluojs/testing/vitest`, install `@babel/core` in the consuming workspace as well because `fluoBabelDecoratorsPlugin()` invokes Babel at runtime. The Vitest plugin transforms `.ts`, `.tsx`, `.mts`, and `.cts` source ids after removing Vite query/hash suffixes, skips `node_modules`, and resolves the nearest root Babel config named `babel.config.cjs`, `babel.config.mjs`, `babel.config.js`, or `babel.config.json`:
 
@@ -132,9 +132,11 @@ Install `vitest` in the consuming workspace before using the mock helpers so the
 
 Use subpaths like `@fluojs/testing/platform-conformance`, `@fluojs/testing/http-adapter-portability`, and `@fluojs/testing/web-runtime-adapter-portability` when authoring framework-facing platform packages.
 
-Portability harness cleanup is part of the contract: if `app.close()` fails, the harness reports that cleanup failure, and when an assertion already failed it raises an aggregate error that preserves both the assertion failure and the cleanup failure.
+Portability harness cleanup is part of the contract: if setup, `listen()`, or an assertion fails after an app has been bootstrapped, the harness closes that partial app. If `app.close()` fails, the harness reports that cleanup failure, and when setup or an assertion already failed it raises an aggregate error that preserves both the original failure and the cleanup failure.
 
-`HttpAdapterPortabilityHarness` methods are the public adapter contract checks. Prefer focused assertions such as `assertPreservesMalformedCookieValues()`, `assertSupportsSseStreaming()`, `assertPreservesRawBodyForJsonAndText()`, `assertPreservesExactRawBodyBytesForByteSensitivePayloads()`, `assertExcludesRawBodyForMultipart()`, `assertDefaultsMultipartTotalLimitToMaxBodySize()`, `assertSettlesStreamDrainWaitOnClose()`, `assertReportsConfiguredHostInStartupLogs()`, `assertReportsHttpsStartupUrl(...)`, and `assertRemovesShutdownSignalListenersAfterClose()` instead of hand-rolled equivalents.
+`HttpAdapterPortabilityHarness` and web-runtime portability harness methods are the public adapter contract checks. Prefer focused assertions such as `assertPreservesMalformedCookieValues()`, `assertSupportsSseStreaming()`, `assertPreservesRawBodyForJsonAndText()`, `assertPreservesExactRawBodyBytesForByteSensitivePayloads()`, `assertExcludesRawBodyForMultipart()`, `assertDefaultsMultipartTotalLimitToMaxBodySize()`, `assertSettlesStreamDrainWaitOnClose()`, `assertReportsConfiguredHostInStartupLogs()`, `assertReportsHttpsStartupUrl(...)`, and `assertRemovesShutdownSignalListenersAfterClose()` instead of hand-rolled equivalents.
+
+Use `assertPreservesExactRawBodyBytesForByteSensitivePayloads()` when an HTTP adapter must prove `rawBody` keeps byte-sensitive payload bytes intact across runtimes.
 
 ## Canonical TDD Ladder
 

package/dist/conformance/platform-conformance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"platform-conformance.d.ts","sourceRoot":"","sources":["../../src/conformance/platform-conformance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EACV,iBAAiB,EACjB,uBAAuB,EACvB,gBAAgB,EAChB,aAAa,EACb,wBAAwB,EACzB,MAAM,iBAAiB,CAAC;AAEzB;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,eAAe,EAAE,MAAM,iBAAiB,CAAC;IACzC,UAAU,EAAE,CAAC,SAAS,EAAE,iBAAiB,KAAK,YAAY,CAAC,IAAI,CAAC,CAAC;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,qCAAqC;IACpD,OAAO,CAAC,EAAE,CACR,SAAS,EAAE,iBAAiB,EAC5B,UAAU,EAAE,wBAAwB,KACjC,YAAY,CAAC,SAAS,uBAAuB,EAAE,CAAC,CAAC;IACtD,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,2BAA2B,CAAC,EAAE,aAAa,CAAC,uBAAuB,CAAC,UAAU,CAAC,CAAC,CAAC;CAClF;AAED;;GAEG;AACH,MAAM,WAAW,kCAAkC;IACjD,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IACrD,oBAAoB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,gBAAgB,CAAC;CAC7D;AAED;;GAEG;AACH,MAAM,WAAW,iCAAiC;IAChD,4BAA4B,CAAC,EAAE,CAAC,SAAS,EAAE,iBAAiB,KAAK,YAAY,CAAC,OAAO,CAAC,CAAC;IACvF,eAAe,EAAE,MAAM,iBAAiB,CAAC;IACzC,WAAW,CAAC,EAAE,qCAAqC,CAAC;IACpD,SAAS,CAAC,EAAE;QACV,QAAQ,EAAE,2BAA2B,CAAC;QACtC,MAAM,EAAE,2BAA2B,CAAC;KACrC,CAAC;IACF,QAAQ,CAAC,EAAE,kCAAkC,CAAC;CAC/C;AA4ED;;GAEG;AACH,qBAAa,0BAA0B;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,iCAAiC;IAEjE,yCAAyC,IAAI,OAAO,CAAC,IAAI,CAAC;IA4B1D,0BAA0B,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB3C,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC;IAkCvC,2CAA2C,IAAI,OAAO,CAAC,IAAI,CAAC;IA2B5D,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC;IAuCxC,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBxC,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;CAQjC;AAED;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,iCAAiC,GACzC,0BAA0B,CAE5B"}
+{"version":3,"file":"platform-conformance.d.ts","sourceRoot":"","sources":["../../src/conformance/platform-conformance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EACV,iBAAiB,EACjB,uBAAuB,EACvB,gBAAgB,EAChB,aAAa,EACb,wBAAwB,EACzB,MAAM,iBAAiB,CAAC;AAEzB;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,eAAe,EAAE,MAAM,iBAAiB,CAAC;IACzC,UAAU,EAAE,CAAC,SAAS,EAAE,iBAAiB,KAAK,YAAY,CAAC,IAAI,CAAC,CAAC;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,qCAAqC;IACpD,OAAO,CAAC,EAAE,CACR,SAAS,EAAE,iBAAiB,EAC5B,UAAU,EAAE,wBAAwB,KACjC,YAAY,CAAC,SAAS,uBAAuB,EAAE,CAAC,CAAC;IACtD,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,2BAA2B,CAAC,EAAE,aAAa,CAAC,uBAAuB,CAAC,UAAU,CAAC,CAAC,CAAC;CAClF;AAED;;GAEG;AACH,MAAM,WAAW,kCAAkC;IACjD,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IACrD,oBAAoB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,gBAAgB,CAAC;CAC7D;AAED;;GAEG;AACH,MAAM,WAAW,iCAAiC;IAChD,4BAA4B,CAAC,EAAE,CAAC,SAAS,EAAE,iBAAiB,KAAK,YAAY,CAAC,OAAO,CAAC,CAAC;IACvF,eAAe,EAAE,MAAM,iBAAiB,CAAC;IACzC,WAAW,CAAC,EAAE,qCAAqC,CAAC;IACpD,SAAS,CAAC,EAAE;QACV,QAAQ,EAAE,2BAA2B,CAAC;QACtC,MAAM,EAAE,2BAA2B,CAAC;KACrC,CAAC;IACF,QAAQ,CAAC,EAAE,kCAAkC,CAAC;CAC/C;AAmGD;;GAEG;AACH,qBAAa,0BAA0B;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,iCAAiC;IAEjE,yCAAyC,IAAI,OAAO,CAAC,IAAI,CAAC;IA4B1D,0BAA0B,IAAI,OAAO,CAAC,IAAI,CAAC;IA6B3C,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC;IAkCvC,2CAA2C,IAAI,OAAO,CAAC,IAAI,CAAC;IAoC5D,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC;IA4CxC,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBxC,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;CAQjC;AAED;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,iCAAiC,GACzC,0BAA0B,CAE5B"}

package/dist/conformance/platform-conformance.js

@@ -48,6 +48,19 @@ async function captureOutcome(action) {
     };
   }
 }
+async function runCleanupWithAssertionContext(cleanup, cleanupLabel, assertionError) {
+  try {
+    await cleanup();
+  } catch (cleanupError) {
+    if (assertionError !== undefined) {
+      throw new AggregateError([assertionError, cleanupError], `${cleanupLabel} failed while preserving the original conformance assertion failure.`);
+    }
+    throw new AggregateError([cleanupError], `${cleanupLabel} failed during platform conformance cleanup.`);
+  }
+  if (assertionError !== undefined) {
+    throw assertionError;
+  }
+}
 function collectForbiddenKeyPaths(value, patterns, allowPatterns, currentPath, violations) {
   if (Array.isArray(value)) {
     value.forEach((entry, index) => {
@@ -97,20 +110,25 @@ export class PlatformConformanceHarness {
   async assertStartIsDeterministic() {
     const component = this.options.createComponent();
     const compare = this.options.snapshot?.compare ?? defaultCompare;
-    const firstStart = await captureOutcome(() => component.start());
-    const firstSnapshot = component.snapshot();
-    const secondStart = await captureOutcome(() => component.start());
-    const secondSnapshot = component.snapshot();
-    if (firstStart.ok !== secondStart.ok) {
-      throw new Error('start() is not deterministic: first and second calls had different outcomes.');
-    }
-    if (!firstStart.ok && !secondStart.ok && firstStart.message !== secondStart.message) {
-      throw new Error('start() rejection messages changed across duplicate calls.');
-    }
-    if (firstStart.ok && secondStart.ok && !compare(firstSnapshot, secondSnapshot)) {
-      throw new Error('start() is not idempotent: duplicate calls changed component snapshot output.');
+    let assertionError;
+    try {
+      const firstStart = await captureOutcome(() => component.start());
+      const firstSnapshot = component.snapshot();
+      const secondStart = await captureOutcome(() => component.start());
+      const secondSnapshot = component.snapshot();
+      if (firstStart.ok !== secondStart.ok) {
+        throw new Error('start() is not deterministic: first and second calls had different outcomes.');
+      }
+      if (!firstStart.ok && !secondStart.ok && firstStart.message !== secondStart.message) {
+        throw new Error('start() rejection messages changed across duplicate calls.');
+      }
+      if (firstStart.ok && secondStart.ok && !compare(firstSnapshot, secondSnapshot)) {
+        throw new Error('start() is not idempotent: duplicate calls changed component snapshot output.');
+      }
+    } catch (error) {
+      assertionError = error;
     }
-    await captureOutcome(() => component.stop());
+    await runCleanupWithAssertionContext(() => component.stop(), 'stop() after start() determinism check', assertionError);
   }
   async assertStopIsIdempotent() {
     const component = this.options.createComponent();
@@ -145,17 +163,17 @@ export class PlatformConformanceHarness {
     }
     for (const scenario of [scenarios.degraded, scenarios.failed]) {
       const component = scenario.createComponent();
-      await scenario.enterState(component);
-      if (scenario.expectedState !== undefined && component.state() !== scenario.expectedState) {
-        throw new Error(`Scenario "${scenario.name}" expected state "${scenario.expectedState}" but received "${component.state()}".`);
-      }
       try {
+        await scenario.enterState(component);
+        if (scenario.expectedState !== undefined && component.state() !== scenario.expectedState) {
+          throw new Error(`Scenario "${scenario.name}" expected state "${scenario.expectedState}" but received "${component.state()}".`);
+        }
         component.snapshot();
       } catch (error) {
-        throw new Error(`snapshot() must be safe in "${scenario.name}" state: ${toErrorMessage(error)}`);
-      } finally {
-        await captureOutcome(() => component.stop());
+        const assertionError = error instanceof Error && error.message.startsWith('Scenario ') ? error : new Error(`snapshot() must be safe in "${scenario.name}" state: ${toErrorMessage(error)}`);
+        await runCleanupWithAssertionContext(() => component.stop(), `stop() after "${scenario.name}" snapshot scenario`, assertionError);
       }
+      await runCleanupWithAssertionContext(() => component.stop(), `stop() after "${scenario.name}" snapshot scenario`);
     }
   }
   async assertStableDiagnostics() {
@@ -169,10 +187,10 @@ export class PlatformConformanceHarness {
     const requiredFixHintSeverities = this.options.diagnostics?.requireFixHintForSeverities ?? DEFAULT_REQUIRED_FIX_HINT_SEVERITIES;
     for (const issue of diagnostics) {
       if (issue.code.trim().length === 0) {
-        throw new Error('Diagnostics must provide a stable non-empty code.');
+        throw new Error(`Diagnostics must provide a stable non-empty code. Received message: ${issue.message}`);
       }
       if (requiredFixHintSeverities.includes(issue.severity) && (!issue.fixHint || issue.fixHint.trim().length === 0)) {
-        throw new Error(`Diagnostic ${issue.code} (${issue.severity}) must provide a fixHint.`);
+        throw new Error(`Diagnostic ${issue.code} (${issue.severity}) must provide a fixHint. Message: ${issue.message}`);
       }
     }
     const expectedCodes = this.options.diagnostics?.expectedCodes;
@@ -183,7 +201,8 @@ export class PlatformConformanceHarness {
     const actualCodes = normalizeCodes(diagnostics.map(diagnostic => diagnostic.code));
     const normalizedExpectedCodes = normalizeCodes(expectedCodes);
     if (!defaultCompare(actualCodes, normalizedExpectedCodes)) {
-      throw new Error(`Diagnostic code set changed. Expected [${normalizedExpectedCodes.join(', ')}] but received [${actualCodes.join(', ')}].`);
+      const actualDetails = diagnostics.map(diagnostic => `${diagnostic.code}(${diagnostic.severity}): ${diagnostic.message}`).join('; ');
+      throw new Error(`Diagnostic code set changed. Expected [${normalizedExpectedCodes.join(', ')}] but received [${actualCodes.join(', ')}]. Actual diagnostics: ${actualDetails}`);
     }
   }
   async assertSnapshotSanitized() {

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":"AAIA,OAAO,EAAwC,KAAK,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE3G,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;AAiFD;;;;;;;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;IAkDrD,oCAAoC,IAAI,OAAO,CAAC,IAAI,CAAC;IAsErD,wDAAwD,IAAI,OAAO,CAAC,IAAI,CAAC;IA+CzE,iCAAiC,IAAI,OAAO,CAAC,IAAI,CAAC;IAuDlD,8CAA8C,IAAI,OAAO,CAAC,IAAI,CAAC;IAsD/D,0BAA0B,IAAI,OAAO,CAAC,IAAI,CAAC;IAmDjD;;;OAGG;IACG,mCAAmC,IAAI,OAAO,CAAC,IAAI,CAAC;IA0DpD,wCAAwC,IAAI,OAAO,CAAC,IAAI,CAAC;IAqDzD,4BAA4B,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAqDjF,8CAA8C,IAAI,OAAO,CAAC,IAAI,CAAC;CA4CtE;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":"AAIA,OAAO,EAAwC,KAAK,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE3G,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;AAuGD;;;;;;;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;IAkDrD,oCAAoC,IAAI,OAAO,CAAC,IAAI,CAAC;IAsErD,wDAAwD,IAAI,OAAO,CAAC,IAAI,CAAC;IA+CzE,iCAAiC,IAAI,OAAO,CAAC,IAAI,CAAC;IAuDlD,8CAA8C,IAAI,OAAO,CAAC,IAAI,CAAC;IAsD/D,0BAA0B,IAAI,OAAO,CAAC,IAAI,CAAC;IAmDjD;;;OAGG;IACG,mCAAmC,IAAI,OAAO,CAAC,IAAI,CAAC;IA0DpD,wCAAwC,IAAI,OAAO,CAAC,IAAI,CAAC;IAqDzD,4BAA4B,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAqDjF,8CAA8C,IAAI,OAAO,CAAC,IAAI,CAAC;CA4CtE;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

@@ -78,6 +78,19 @@ async function runWithCleanup(app, adapterName, assertion) {
     throw assertionError;
   }
 }
+async function prepareAndListenWithCleanup(app, adapterName, prepare) {
+  try {
+    await prepare?.();
+    await app.listen();
+  } catch (setupError) {
+    try {
+      await app.close();
+    } catch (cleanupError) {
+      throw new AggregateError([setupError, cleanupError], `${adapterName} adapter portability setup failed and app.close() also failed during harness cleanup.`);
+    }
+    throw setupError;
+  }
+}
 
 /**
  * A portability harness for testing HTTP adapters to ensure they behave
@@ -130,7 +143,7 @@ export class HttpAdapterPortabilityHarness {
       cors: false,
       port
     });
-    await app.listen();
+    await prepareAndListenWithCleanup(app, this.options.name);
     await runWithCleanup(app, this.options.name, async () => {
       const response = await fetch(`http://127.0.0.1:${String(port)}/cookies`, {
         headers: {
@@ -185,7 +198,7 @@ export class HttpAdapterPortabilityHarness {
       port,
       rawBody: true
     });
-    await app.listen();
+    await prepareAndListenWithCleanup(app, this.options.name);
     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({
@@ -254,8 +267,9 @@ export class HttpAdapterPortabilityHarness {
       port,
       rawBody: true
     });
-    await this.options.prepareExactRawBodyByteTest?.(app);
-    await app.listen();
+    await prepareAndListenWithCleanup(app, this.options.name, async () => {
+      await this.options.prepareExactRawBodyByteTest?.(app);
+    });
     await runWithCleanup(app, this.options.name, async () => {
       const payload = Uint8Array.from([0xe9, 0x41]);
       const contentType = this.options.exactRawBodyByteContentType ?? 'text/plain; charset=latin1';
@@ -311,7 +325,7 @@ export class HttpAdapterPortabilityHarness {
       port,
       rawBody: true
     });
-    await app.listen();
+    await prepareAndListenWithCleanup(app, this.options.name);
     await runWithCleanup(app, this.options.name, async () => {
       const form = new FormData();
       form.set('name', 'Ada');
@@ -373,7 +387,7 @@ export class HttpAdapterPortabilityHarness {
       },
       port
     });
-    await app.listen();
+    await prepareAndListenWithCleanup(app, this.options.name);
     await runWithCleanup(app, this.options.name, async () => {
       const form = new FormData();
       form.set('name', 'Ada');
@@ -433,7 +447,7 @@ export class HttpAdapterPortabilityHarness {
       cors: false,
       port
     });
-    await app.listen();
+    await prepareAndListenWithCleanup(app, this.options.name);
     await runWithCleanup(app, this.options.name, async () => {
       const response = await fetch(`http://127.0.0.1:${String(port)}/events`, {
         headers: {
@@ -501,7 +515,7 @@ export class HttpAdapterPortabilityHarness {
       cors: false,
       port
     });
-    await app.listen();
+    await prepareAndListenWithCleanup(app, this.options.name);
     await runWithCleanup(app, this.options.name, async () => {
       const response = await fetch(`http://127.0.0.1:${String(port)}/events`, {
         headers: {

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

@@ -25,6 +25,10 @@ export declare class WebRuntimeHttpAdapterPortabilityHarness<TBootstrapOptions e
     assertPreservesQueryArraysAndDecoding(): Promise<void>;
     assertPreservesMalformedCookieValues(): Promise<void>;
     assertPreservesRawBodyForJsonAndText(): Promise<void>;
+    /**
+     * Asserts that byte-sensitive request bodies preserve their exact raw bytes.
+     */
+    assertPreservesExactRawBodyBytesForByteSensitivePayloads(): Promise<void>;
     assertExcludesRawBodyForMultipart(): Promise<void>;
     assertSupportsSseStreaming(): Promise<void>;
 }

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":"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"}
+{"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;IAsE3D;;OAEG;IACG,wDAAwD,IAAI,OAAO,CAAC,IAAI,CAAC;IA0CzE,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"}

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

@@ -195,18 +195,72 @@ export class WebRuntimeHttpAdapterPortabilityHarness {
       }
     });
   }
-  async assertExcludesRawBodyForMultipart() {
+
+  /**
+   * Asserts that byte-sensitive request bodies preserve their exact raw bytes.
+   */
+  async assertPreservesExactRawBodyBytesForByteSensitivePayloads() {
     let _initProto4, _initClass4;
+    let _WebhookController2;
+    class WebhookController {
+      static {
+        ({
+          e: [_initProto4],
+          c: [_WebhookController2, _initClass4]
+        } = _applyDecs(this, [Controller('/webhooks')], [[Post('/bytes'), 2, "handleBytes"]]));
+      }
+      constructor() {
+        _initProto4(this);
+      }
+      handleBytes(_input, context) {
+        return {
+          rawBytes: Array.from(context.request.rawBody ?? new Uint8Array())
+        };
+      }
+      static {
+        _initClass4();
+      }
+    }
+    class AppModule {}
+    defineModule(AppModule, {
+      controllers: [_WebhookController2]
+    });
+    const app = await this.options.bootstrap(AppModule, {
+      cors: false,
+      rawBody: true
+    });
+    await runWithCleanup(app, this.options.name, async () => {
+      const payload = Uint8Array.from([0xe9, 0x41]);
+      const response = await app.dispatch(new Request('https://runtime.test/webhooks/bytes', {
+        body: payload,
+        headers: {
+          'content-type': 'application/octet-stream'
+        },
+        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 _initProto5, _initClass5;
     let _UploadController;
     class UploadController {
       static {
         ({
-          e: [_initProto4],
-          c: [_UploadController, _initClass4]
+          e: [_initProto5],
+          c: [_UploadController, _initClass5]
         } = _applyDecs(this, [Controller('/uploads')], [[Post('/'), 2, "upload"]]));
       }
       constructor() {
-        _initProto4(this);
+        _initProto5(this);
       }
       upload(_input, context) {
         return {
@@ -216,7 +270,7 @@ export class WebRuntimeHttpAdapterPortabilityHarness {
         };
       }
       static {
-        _initClass4();
+        _initClass5();
       }
     }
     class AppModule {}
@@ -253,17 +307,17 @@ export class WebRuntimeHttpAdapterPortabilityHarness {
     });
   }
   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);
@@ -278,7 +332,7 @@ export class WebRuntimeHttpAdapterPortabilityHarness {
         return stream;
       }
       static {
-        _initClass5();
+        _initClass6();
       }
     }
     class AppModule {}

package/package.json

@@ -9,7 +9,7 @@
     "override",
     "module-builder"
   ],
-  "version": "1.0.0",
+  "version": "1.0.2",
   "private": false,
   "license": "MIT",
   "repository": {
@@ -76,11 +76,11 @@
     "dist"
   ],
   "dependencies": {
-    "@fluojs/config": "^1.0.0",
-    "@fluojs/core": "^1.0.0",
+    "@fluojs/config": "^1.0.2",
+    "@fluojs/core": "^1.0.2",
     "@fluojs/http": "^1.0.0",
-    "@fluojs/di": "^1.0.0",
-    "@fluojs/runtime": "^1.0.0"
+    "@fluojs/di": "^1.0.2",
+    "@fluojs/runtime": "^1.1.0"
   },
   "peerDependencies": {
     "@babel/core": ">=7.0.0",
@@ -88,12 +88,12 @@
   },
   "devDependencies": {
     "vitest": "^3.2.4",
-    "@fluojs/platform-bun": "^1.0.0",
-    "@fluojs/platform-cloudflare-workers": "^1.0.0",
-    "@fluojs/platform-deno": "^1.0.0",
-    "@fluojs/platform-nodejs": "^1.0.0",
-    "@fluojs/platform-express": "^1.0.0",
-    "@fluojs/platform-fastify": "^1.0.0"
+    "@fluojs/platform-bun": "^1.0.2",
+    "@fluojs/platform-cloudflare-workers": "^1.0.2",
+    "@fluojs/platform-deno": "^1.0.2",
+    "@fluojs/platform-nodejs": "^1.0.2",
+    "@fluojs/platform-express": "^1.0.2",
+    "@fluojs/platform-fastify": "^1.0.2"
   },
   "scripts": {
     "prebuild": "node ../../tooling/scripts/clean-dist.mjs",