@fluojs/testing 1.0.5 → 1.0.6

package/README.ko.md

@@ -2,7 +2,7 @@
 
 <p><a href="./README.md"><kbd>English</kbd></a> <strong><kbd>한국어</kbd></strong></p>
 
-fluo 애플리케이션을 위한 기본 request-level 테스트 헬퍼, 모듈 구성, 프로바이더 오버라이드 유틸리티입니다.
+Node.js 20+ fluo 애플리케이션을 위한 기본 request-level 테스트 헬퍼, 모듈 구성, 프로바이더 오버라이드 유틸리티입니다.
 
 `@fluojs/testing`은 fluo 애플리케이션 테스트를 위한 공식적인 기준(Baseline)을 제공합니다. 격리된 테스트 환경을 구축하고, 의존성을 가짜(Fake)나 목(Mock)으로 교체하며, 모듈 그래프에서 직접 컴포넌트를 resolve하거나 `createTestApp(...).request(...).send()`로 가상 HTTP 요청을 실행하여 e2e 스타일 테스트를 수행할 수 있게 합니다.
 
@@ -45,17 +45,19 @@ import { createTestApp } from '@fluojs/testing';
 
 const app = await createTestApp({ rootModule: AppModule });
 
-const response = await app
-  .request('POST', '/users/')
-  .header('x-request-id', 'test-request-1')
-  .query('include', 'profile')
-  .principal({ subject: 'user-1', roles: ['admin'] })
-  .body({ name: 'Ada' })
-  .send();
-
-expect(response.status).toBe(201);
-
-await app.close();
+try {
+  const response = await app
+    .request('POST', '/users/')
+    .header('x-request-id', 'test-request-1')
+    .query('include', 'profile')
+    .principal({ subject: 'user-1', roles: ['admin'] })
+    .body({ name: 'Ada' })
+    .send();
+
+  expect(response.status).toBe(201);
+} finally {
+  await app.close();
+}
 ```
 
 애플리케이션 route, guard, interceptor, DTO validation, request body, query parameter, header, synthetic principal, serialized response를 검증하는 기본 HTTP/e2e 스타일 경로로는 `createTestApp({ rootModule })`을 사용하세요. 하나의 slice 안에서 module wiring, provider visibility, provider/guard/interceptor override가 계약일 때는 `createTestingModule(...)`을 사용합니다.
@@ -77,7 +79,7 @@ const module = await createTestingModule({ rootModule: AppModule })
 const service = await module.resolve(UserService);
 ```
 
-Testing builder는 route-pipeline 테스트에서 cross-cutting behavior를 교체할 수 있도록 `overrideGuard(...)`, `overrideInterceptor(...)`, `overrideFilter(...)`도 지원합니다.
+Testing builder는 route-pipeline 테스트에서 cross-cutting behavior를 교체할 수 있도록 `overrideProviders([[token, value], ...])`, `overrideGuard(...)`, `overrideInterceptor(...)`, `overrideFilter(...)`도 지원합니다. Guard와 interceptor override는 route가 같은 token을 `@UseGuards(...)` 또는 `@UseInterceptors(...)`로 참조할 때 request path에서도 안전하게 검증할 수 있습니다. Filter override는 컴파일된 module graph의 token을 교체하므로, 해당 filter가 runtime app 표면에 등록되는 경우 request-level coverage와 함께 사용하세요.
 
 `compile()`은 lifecycle hook이 있는 singleton provider에 대해 production module bootstrap과 같은 의미를 따릅니다. effective provider graph를 해석하고, testing module을 반환하기 전에 provider 순서대로 각 instance의 `onModuleInit()`을 실행한 뒤 `onApplicationBootstrap()`을 실행합니다. `get()`은 synchronous singleton 및 multi-provider 경로에서도 DI ownership 의미를 보존하므로, 반복 sync read는 같은 singleton contribution을 재사용하고 `module.container.dispose()`가 해당 instance를 계속 정리할 수 있습니다.
 
@@ -101,20 +103,22 @@ import { createTestApp } from '@fluojs/testing';
 
 const app = await createTestApp({ rootModule: AppModule });
 
-const response = await app
-  .request('POST', '/users/')
-  .header('authorization', 'Bearer test-token')
-  .query('include', ['profile', 'settings'])
-  .principal({ subject: 'user-1', roles: ['member'] })
-  .body({ name: 'Ada' })
-  .send();
-
-expect(response.status).toBe(201);
-
-await app.close();
+try {
+  const response = await app
+    .request('POST', '/users/')
+    .header('authorization', 'Bearer test-token')
+    .query('include', ['profile', 'settings'])
+    .principal({ subject: 'user-1', roles: ['member'] })
+    .body({ name: 'Ada' })
+    .send();
+
+  expect(response.status).toBe(201);
+} finally {
+  await app.close();
+}
 ```
 
-`app.request(...).send()`는 수동 `FrameworkRequest`/`FrameworkResponse` stub 없이 HTTP 의미에 가까운 테스트를 작성하게 해 주므로 애플리케이션 개발자의 기본 경로입니다. `app.dispatch(...)`, `makeRequest(...)`, raw `FluoFactory.create(...)` 테스트는 adapter/runtime contract, framework internal, 또는 low-level dispatch boundary 자체를 증명해야 하는 compatibility case에 남겨 둡니다.
+`app.request(...).send()`는 수동 `FrameworkRequest`/`FrameworkResponse` stub 없이 HTTP 의미에 가까운 테스트를 작성하게 해 주므로 애플리케이션 개발자의 기본 경로입니다. Assertion 실패가 runtime resource 누수로 이어지지 않도록 반환된 app은 `finally` 블록에서 닫으세요. `app.dispatch(...)`, `makeRequest(...)`, raw `FluoFactory.create(...)` 테스트는 adapter/runtime contract, framework internal, 또는 low-level dispatch boundary 자체를 증명해야 하는 compatibility case에 남겨 둡니다.
 
 `createTestApp(...)`은 runtime HTTP bootstrap과 같은 application bootstrap option을 받습니다. 여기에는 `providers`, `filters`, `converters`, `interceptors`, `middleware`, `observers`, `versioning`, diagnostics option이 포함됩니다. 테스트 헬퍼는 request-context middleware를 앞에 추가하되, 호출자가 넘긴 middleware를 같은 app middleware chain 안에 보존합니다.
 
@@ -128,7 +132,7 @@ const repo = createMock<UserRepository>({ findById: vi.fn() });
 const mailer = createDeepMock(MailService);
 ```
 
-`asMock(value)`는 기존 값을 mock-friendly 타입으로 좁히고, `mockToken(token, value)`는 token 기반 dependency를 위한 provider override tuple을 만듭니다. `createMock(..., { strict: true })`는 지정하지 않은 member 접근을 거부합니다.
+`asMock(value)`는 기존 값을 mock-friendly 타입으로 좁히고, `mockToken(token, value)`는 token 기반 dependency를 위한 provider override tuple을 만듭니다. `createMock(..., { strict: true })`는 지정하지 않은 member 접근을 거부합니다. `DeepMocked<T>`는 호환성을 위해 공용 testing type에서 노출되며 Vitest mock type boundary를 의도적으로 반영합니다. Vitest를 사용하지 않는 소비자는 `@fluojs/testing/app`, `@fluojs/testing/module`, 또는 harness subpath에서 non-mock helper만 import하세요.
 
 배포된 런타임 import가 안정적으로 해석되도록, mock 헬퍼를 사용할 워크스페이스에는 `vitest`를 함께 설치해야 합니다.
 
@@ -136,7 +140,7 @@ const mailer = createDeepMock(MailService);
 
 프레임워크 지향 플랫폼 패키지를 작성할 때는 `@fluojs/testing/platform-conformance`, `@fluojs/testing/http-adapter-portability`, `@fluojs/testing/web-runtime-adapter-portability` 같은 서브패스를 사용해 적합성 및 이식성 검증을 수행합니다.
 
-이식성 하니스의 cleanup도 계약에 포함됩니다. 앱이 bootstrap된 뒤 setup, `listen()`, assertion이 실패하면 하니스는 해당 partial app을 닫습니다. `app.close()`가 실패하면 하니스는 cleanup 실패를 보고하며, setup 또는 assertion이 이미 실패한 경우에는 원래 실패와 cleanup 실패를 모두 보존하는 aggregate error를 발생시킵니다.
+이식성 하니스의 cleanup도 계약에 포함됩니다. 앱이 bootstrap된 뒤 setup, `listen()`, partial app을 노출한 run callback, assertion이 실패하면 하니스는 해당 partial app을 닫습니다. `app.close()`가 실패하면 하니스는 cleanup 실패를 보고하며, setup 또는 assertion이 이미 실패한 경우에는 원래 실패와 cleanup 실패를 모두 보존하는 aggregate error를 발생시킵니다.
 
 `HttpAdapterPortabilityHarness`와 web-runtime portability harness 메서드는 공개 어댑터 계약 체크입니다. 직접 같은 검증을 다시 만들기보다 `assertPreservesMalformedCookieValues()`, `assertSupportsSseStreaming()`, `assertPreservesRawBodyForJsonAndText()`, `assertPreservesExactRawBodyBytesForByteSensitivePayloads()`, `assertExcludesRawBodyForMultipart()`, `assertDefaultsMultipartTotalLimitToMaxBodySize()`, `assertSettlesStreamDrainWaitOnClose()`, `assertReportsConfiguredHostInStartupLogs()`, `assertReportsHttpsStartupUrl(...)`, `assertRemovesShutdownSignalListenersAfterClose()`처럼 초점이 분명한 assertion을 사용하세요.
 
@@ -170,6 +174,10 @@ fluo는 테스트가 명시적인 `rootModule`을 이름으로 지정해야 한
 - **하니스 서브패스**: `platform-conformance`, `http-adapter-portability`, `web-runtime-adapter-portability`, `fetch-style-websocket-conformance`
 - **도구 지원**: `@fluojs/testing/vitest`의 `fluoBabelDecoratorsPlugin()` 및 `@fluojs/testing/vitest/tooling`의 Vitest workspace config helper (`vitest`와 `@babel/core`를 함께 요구)
 
+Package manifest는 `engines.node >=20.0.0`을 선언합니다. 문서화된 경우 non-Node runtime 애플리케이션 테스트에서 runtime-native 도구를 사용할 수 있지만, 배포된 `@fluojs/testing` 패키지 자체는 이 Node.js engine floor를 따릅니다.
+
+`@fluojs/testing/vitest/tooling`은 각 package의 공개 `exports`에 선언된 entrypoint만 workspace alias로 매핑합니다. Private source file, internal helper, export되지 않은 source entrypoint는 의도적으로 제외하므로 테스트가 published package 소비자에게 제공되는 import boundary와 같은 경계를 검증합니다.
+
 ## 관련 패키지
 
 - `@fluojs/di`: 테스트 컨테이너가 사용하는 기반 DI 시스템입니다.

package/README.md

@@ -2,7 +2,7 @@
 
 <p><strong><kbd>English</kbd></strong> <a href="./README.ko.md"><kbd>한국어</kbd></a></p>
 
-Default request-level testing helpers, testing module construction, and provider overrides for fluo applications.
+Node.js 20+ request-level testing helpers, testing module construction, and provider overrides for fluo applications.
 
 ## Table of Contents
 
@@ -18,7 +18,7 @@ Default request-level testing helpers, testing module construction, and provider
 ## Installation
 
 ```bash
-npm install --save-dev @fluojs/testing vitest
+pnpm add -D @fluojs/testing vitest
 ```
 
 `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.
@@ -26,7 +26,7 @@ npm install --save-dev @fluojs/testing vitest
 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`:
 
 ```bash
-npm install --save-dev @babel/core
+pnpm add -D @babel/core
 ```
 
 ## When to Use
@@ -43,17 +43,19 @@ import { createTestApp } from '@fluojs/testing';
 
 const app = await createTestApp({ rootModule: AppModule });
 
-const response = await app
-  .request('POST', '/users/')
-  .header('x-request-id', 'test-request-1')
-  .query('include', 'profile')
-  .principal({ subject: 'user-1', roles: ['admin'] })
-  .body({ name: 'Ada' })
-  .send();
-
-expect(response.status).toBe(201);
-
-await app.close();
+try {
+  const response = await app
+    .request('POST', '/users/')
+    .header('x-request-id', 'test-request-1')
+    .query('include', 'profile')
+    .principal({ subject: 'user-1', roles: ['admin'] })
+    .body({ name: 'Ada' })
+    .send();
+
+  expect(response.status).toBe(201);
+} finally {
+  await app.close();
+}
 ```
 
 Use `createTestApp({ rootModule })` as the default HTTP/e2e-style path for application routes, guards, interceptors, DTO validation, request bodies, query parameters, headers, synthetic principals, and serialized responses. Reach for `createTestingModule(...)` when the contract is module wiring, provider visibility, or provider/guard/interceptor overrides inside one slice.
@@ -75,7 +77,7 @@ const module = await createTestingModule({ rootModule: AppModule })
 const service = await module.resolve(UserService);
 ```
 
-The testing builder also supports `overrideGuard(...)`, `overrideInterceptor(...)`, and `overrideFilter(...)` for route-pipeline tests that need to replace cross-cutting behavior.
+The testing builder also supports `overrideProviders([[token, value], ...])`, `overrideGuard(...)`, `overrideInterceptor(...)`, and `overrideFilter(...)` for route-pipeline tests that need to replace cross-cutting behavior. Guard and interceptor overrides are request-path safe when the route references the same token via `@UseGuards(...)` or `@UseInterceptors(...)`; filter overrides replace the token in the compiled module graph and should be paired with request-level coverage where that filter is registered in the runtime app surface.
 
 `compile()` follows production module-bootstrap semantics for lifecycle-bearing singleton providers: it resolves the effective provider graph, runs `onModuleInit()` for each resolved instance, then runs `onApplicationBootstrap()` in the same provider order before the testing module is returned. `get()` keeps DI ownership semantics for synchronous singleton and multi-provider paths, so repeated sync reads reuse the same singleton contributions and `module.container.dispose()` can still clean them up.
 
@@ -99,20 +101,22 @@ import { createTestApp } from '@fluojs/testing';
 
 const app = await createTestApp({ rootModule: AppModule });
 
-const response = await app
-  .request('POST', '/users/')
-  .header('authorization', 'Bearer test-token')
-  .query('include', ['profile', 'settings'])
-  .principal({ subject: 'user-1', roles: ['member'] })
-  .body({ name: 'Ada' })
-  .send();
-
-expect(response.status).toBe(201);
-
-await app.close();
+try {
+  const response = await app
+    .request('POST', '/users/')
+    .header('authorization', 'Bearer test-token')
+    .query('include', ['profile', 'settings'])
+    .principal({ subject: 'user-1', roles: ['member'] })
+    .body({ name: 'Ada' })
+    .send();
+
+  expect(response.status).toBe(201);
+} finally {
+  await app.close();
+}
 ```
 
-`app.request(...).send()` is the preferred app-developer path because it keeps tests close to HTTP semantics without manual `FrameworkRequest`/`FrameworkResponse` stubs. Keep `app.dispatch(...)`, `makeRequest(...)`, and raw `FluoFactory.create(...)` tests for adapter/runtime contracts, framework internals, or compatibility cases where the low-level dispatch boundary itself is what the test must prove.
+`app.request(...).send()` is the preferred app-developer path because it keeps tests close to HTTP semantics without manual `FrameworkRequest`/`FrameworkResponse` stubs. Close the returned app from a `finally` block so assertion failures do not leak runtime resources. Keep `app.dispatch(...)`, `makeRequest(...)`, and raw `FluoFactory.create(...)` tests for adapter/runtime contracts, framework internals, or compatibility cases where the low-level dispatch boundary itself is what the test must prove.
 
 `createTestApp(...)` accepts the same application bootstrap options as the runtime HTTP bootstrap, including `providers`, `filters`, `converters`, `interceptors`, `middleware`, `observers`, `versioning`, and diagnostics options. The testing helper prepends its request-context middleware while preserving caller-provided middleware in the same app middleware chain.
 
@@ -126,7 +130,7 @@ const repo = createMock<UserRepository>({ findById: vi.fn() });
 const mailer = createDeepMock(MailService);
 ```
 
-`asMock(value)` narrows an existing value to a mock-friendly type, and `mockToken(token, value)` creates a provider override tuple for token-based dependencies. `createMock(..., { strict: true })` rejects access to unspecified members.
+`asMock(value)` narrows an existing value to a mock-friendly type, and `mockToken(token, value)` creates a provider override tuple for token-based dependencies. `createMock(..., { strict: true })` rejects access to unspecified members. `DeepMocked<T>` is exposed from the shared testing types for compatibility and intentionally reflects the Vitest mock type boundary; consumers that do not use Vitest should import only non-mock helpers from `@fluojs/testing/app`, `@fluojs/testing/module`, or the harness subpaths.
 
 Install `vitest` in the consuming workspace before using the mock helpers so the published runtime import resolves consistently.
 
@@ -134,7 +138,7 @@ 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 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.
+Portability harness cleanup is part of the contract: if setup, `listen()`, a run callback that surfaces a partial app, 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` 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.
 
@@ -168,6 +172,10 @@ fluo differs from NestJS by requiring tests to name an explicit `rootModule`. Th
 - **Harness subpaths**: `platform-conformance`, `http-adapter-portability`, `web-runtime-adapter-portability`, `fetch-style-websocket-conformance`
 - **Tooling**: `@fluojs/testing/vitest` with `fluoBabelDecoratorsPlugin()` and `@fluojs/testing/vitest/tooling` with Vitest workspace config helpers (requires `vitest` and `@babel/core` in the consuming workspace)
 
+The package manifest declares `engines.node >=20.0.0`. Non-Node runtime application tests can still use runtime-native tools where documented, but the published `@fluojs/testing` package itself is governed by that Node.js engine floor.
+
+`@fluojs/testing/vitest/tooling` maps workspace aliases only for each package's declared public `exports`. Private source files, internal helpers, and unexported source entrypoints are intentionally excluded so tests exercise the same import boundaries that consumers receive from published packages.
+
 ## Related Packages
 
 - `@fluojs/di`: powers provider resolution in compiled test containers

package/dist/app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,OAAO,EACP,yBAAyB,EAE1B,MAAM,YAAY,CAAC;AA6BpB;;;;;;;;;;;;GAYG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,OAAO,CAAC,CAyBxF"}
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,OAAO,EACP,yBAAyB,EAE1B,MAAM,YAAY,CAAC;AA6BpB;;;;;;;;;;;;GAYG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,OAAO,CAAC,CA2BxF"}

package/dist/app.js

@@ -38,6 +38,7 @@ export async function createTestApp(options) {
     ...options,
     middleware: [createTestRequestContextMiddleware(), ...(options.middleware ?? [])]
   });
+  let closePromise;
   const request = (methodOrRequest, pathOrOptions, options) => {
     return createRequestBuilder(app.dispatcher, normalizeRequestInput(methodOrRequest, pathOrOptions, options));
   };
@@ -48,7 +49,8 @@ export async function createTestApp(options) {
     request,
     dispatch,
     close: async () => {
-      await app.close();
+      closePromise ??= app.close();
+      await closePromise;
     }
   };
 }

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;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"}
+{"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;IAwC1D,0BAA0B,IAAI,OAAO,CAAC,IAAI,CAAC;IA6B3C,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC;IAyCvC,2CAA2C,IAAI,OAAO,CAAC,IAAI,CAAC;IAoC5D,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC;IAoDxC,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC;IAwBxC,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

@@ -91,20 +91,27 @@ export class PlatformConformanceHarness {
   }
   async assertValidationHasNoLongLivedSideEffects() {
     const component = this.options.createComponent();
-    const beforeState = component.state();
-    const beforeEffects = this.options.captureValidationSideEffects ? await this.options.captureValidationSideEffects(component) : undefined;
-    await component.validate();
-    const afterState = component.state();
-    if (beforeState !== afterState) {
-      throw new Error(`validate() must not transition component state. Expected "${beforeState}" but received "${afterState}".`);
-    }
-    if (!this.options.captureValidationSideEffects) {
-      return;
-    }
-    const compare = this.options.snapshot?.compare ?? defaultCompare;
-    const afterEffects = await this.options.captureValidationSideEffects(component);
-    if (!compare(beforeEffects, afterEffects)) {
-      throw new Error('validate() introduced long-lived side effects.');
+    let assertionError;
+    try {
+      const beforeState = component.state();
+      const beforeEffects = this.options.captureValidationSideEffects ? await this.options.captureValidationSideEffects(component) : undefined;
+      await component.validate();
+      const afterState = component.state();
+      if (beforeState !== afterState) {
+        throw new Error(`validate() must not transition component state. Expected "${beforeState}" but received "${afterState}".`);
+      }
+      if (!this.options.captureValidationSideEffects) {
+        return;
+      }
+      const compare = this.options.snapshot?.compare ?? defaultCompare;
+      const afterEffects = await this.options.captureValidationSideEffects(component);
+      if (!compare(beforeEffects, afterEffects)) {
+        throw new Error('validate() introduced long-lived side effects.');
+      }
+    } catch (error) {
+      assertionError = error;
+    } finally {
+      await runCleanupWithAssertionContext(() => component.stop(), 'stop() after validation side-effect check', assertionError);
     }
   }
   async assertStartIsDeterministic() {
@@ -133,27 +140,34 @@ export class PlatformConformanceHarness {
   async assertStopIsIdempotent() {
     const component = this.options.createComponent();
     const compare = this.options.snapshot?.compare ?? defaultCompare;
-    const startOutcome = await captureOutcome(() => component.start());
-    if (!startOutcome.ok) {
-      throw new Error(`stop() idempotency check requires a startable component: ${startOutcome.message}`);
-    }
-    const firstStop = await captureOutcome(() => component.stop());
-    if (!firstStop.ok) {
-      throw new Error(`first stop() call failed: ${firstStop.message}`);
-    }
-    const firstState = component.state();
-    const firstSnapshot = component.snapshot();
-    const secondStop = await captureOutcome(() => component.stop());
-    if (!secondStop.ok) {
-      throw new Error(`stop() is not idempotent: second call failed with "${secondStop.message}".`);
-    }
-    const secondState = component.state();
-    const secondSnapshot = component.snapshot();
-    if (firstState !== secondState) {
-      throw new Error(`stop() changed state across duplicate calls (${firstState} -> ${secondState}).`);
-    }
-    if (!compare(firstSnapshot, secondSnapshot)) {
-      throw new Error('stop() is not idempotent: duplicate calls changed component snapshot output.');
+    let assertionError;
+    try {
+      const startOutcome = await captureOutcome(() => component.start());
+      if (!startOutcome.ok) {
+        throw new Error(`stop() idempotency check requires a startable component: ${startOutcome.message}`);
+      }
+      const firstStop = await captureOutcome(() => component.stop());
+      if (!firstStop.ok) {
+        throw new Error(`first stop() call failed: ${firstStop.message}`);
+      }
+      const firstState = component.state();
+      const firstSnapshot = component.snapshot();
+      const secondStop = await captureOutcome(() => component.stop());
+      if (!secondStop.ok) {
+        throw new Error(`stop() is not idempotent: second call failed with "${secondStop.message}".`);
+      }
+      const secondState = component.state();
+      const secondSnapshot = component.snapshot();
+      if (firstState !== secondState) {
+        throw new Error(`stop() changed state across duplicate calls (${firstState} -> ${secondState}).`);
+      }
+      if (!compare(firstSnapshot, secondSnapshot)) {
+        throw new Error('stop() is not idempotent: duplicate calls changed component snapshot output.');
+      }
+    } catch (error) {
+      assertionError = error;
+    } finally {
+      await runCleanupWithAssertionContext(() => component.stop(), 'final stop() after stop() idempotency check', assertionError);
     }
   }
   async assertSnapshotSafeInDegradedAndFailedStates() {
@@ -178,44 +192,58 @@ export class PlatformConformanceHarness {
   }
   async assertStableDiagnostics() {
     const component = this.options.createComponent();
-    const validation = await component.validate();
-    const diagnostics = [...validation.issues, ...(validation.warnings ?? [])];
-    if (this.options.diagnostics?.collect) {
-      const extra = await this.options.diagnostics.collect(component, validation);
-      diagnostics.push(...extra);
-    }
-    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. Received message: ${issue.message}`);
+    let assertionError;
+    try {
+      const validation = await component.validate();
+      const diagnostics = [...validation.issues, ...(validation.warnings ?? [])];
+      if (this.options.diagnostics?.collect) {
+        const extra = await this.options.diagnostics.collect(component, validation);
+        diagnostics.push(...extra);
       }
-      if (requiredFixHintSeverities.includes(issue.severity) && (!issue.fixHint || issue.fixHint.trim().length === 0)) {
-        throw new Error(`Diagnostic ${issue.code} (${issue.severity}) must provide a fixHint. Message: ${issue.message}`);
+      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. 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. Message: ${issue.message}`);
+        }
       }
-    }
-    const expectedCodes = this.options.diagnostics?.expectedCodes;
-    if (!expectedCodes) {
-      return;
-    }
-    const normalizeCodes = codes => [...new Set(codes)].sort();
-    const actualCodes = normalizeCodes(diagnostics.map(diagnostic => diagnostic.code));
-    const normalizedExpectedCodes = normalizeCodes(expectedCodes);
-    if (!defaultCompare(actualCodes, normalizedExpectedCodes)) {
-      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}`);
+      const expectedCodes = this.options.diagnostics?.expectedCodes;
+      if (!expectedCodes) {
+        return;
+      }
+      const normalizeCodes = codes => [...new Set(codes)].sort();
+      const actualCodes = normalizeCodes(diagnostics.map(diagnostic => diagnostic.code));
+      const normalizedExpectedCodes = normalizeCodes(expectedCodes);
+      if (!defaultCompare(actualCodes, normalizedExpectedCodes)) {
+        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}`);
+      }
+    } catch (error) {
+      assertionError = error;
+    } finally {
+      await runCleanupWithAssertionContext(() => component.stop(), 'stop() after stable diagnostics check', assertionError);
     }
   }
   async assertSnapshotSanitized() {
     const component = this.options.createComponent();
-    const snapshot = component.snapshot();
-    const sanitize = this.options.snapshot?.sanitize;
-    const candidate = sanitize ? sanitize(snapshot) : snapshot;
-    const forbiddenPatterns = this.options.snapshot?.forbiddenKeyPatterns ?? DEFAULT_FORBIDDEN_KEY_PATTERNS;
-    const allowPatterns = this.options.snapshot?.allowKeyPatterns ?? [];
-    const violations = [];
-    collectForbiddenKeyPaths(candidate, forbiddenPatterns, allowPatterns, '', violations);
-    if (violations.length > 0) {
-      throw new Error(`snapshot() contains unsanitized keys: ${violations.join(', ')}`);
+    let assertionError;
+    try {
+      const snapshot = component.snapshot();
+      const sanitize = this.options.snapshot?.sanitize;
+      const candidate = sanitize ? sanitize(snapshot) : snapshot;
+      const forbiddenPatterns = this.options.snapshot?.forbiddenKeyPatterns ?? DEFAULT_FORBIDDEN_KEY_PATTERNS;
+      const allowPatterns = this.options.snapshot?.allowKeyPatterns ?? [];
+      const violations = [];
+      collectForbiddenKeyPaths(candidate, forbiddenPatterns, allowPatterns, '', violations);
+      if (violations.length > 0) {
+        throw new Error(`snapshot() contains unsanitized keys: ${violations.join(', ')}`);
+      }
+    } catch (error) {
+      assertionError = error;
+    } finally {
+      await runCleanupWithAssertionContext(() => component.stop(), 'stop() after snapshot sanitization check', assertionError);
     }
   }
   async assertAll() {

package/dist/module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,SAAS,EAKd,KAAK,QAAQ,EAEd,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;AA+vBD;;;;;;;;;;;;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,EAKd,KAAK,QAAQ,EAEd,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAGV,UAAU,EACX,MAAM,iBAAiB,CAAC;AAMzB,OAAO,KAAK,EAA2B,oBAAoB,EAAE,oBAAoB,EAAoB,MAAM,YAAY,CAAC;AAYxH;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,UAAU,GAAG,QAAQ,EAAE,CAQzE;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,UAAU,GAAG,SAAS,EAAE,CAQ5E;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU,EAAE,CAQzE;AA6tBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,oBAAoB,CAEvF;AAED;;GAEG;AACH,eAAO,MAAM,IAAI;;CAEhB,CAAC"}

package/dist/module.js

@@ -1,6 +1,6 @@
 import { getModuleMetadata } from '@fluojs/core';
 import { isForwardRef, isOptionalToken, Scope } from '@fluojs/di';
-import { bootstrapModule, defineModule } from '@fluojs/runtime';
+import { bootstrapModule } from '@fluojs/runtime';
 import { createDispatcher, createHandlerMapping } from '@fluojs/http';
 import { createTestRequestContextMiddleware, makeRequest } from './http.js';
 /**
@@ -469,7 +469,6 @@ class DefaultOverrideProviderBuilder {
 class DefaultTestingModuleBuilder {
   overrides = [];
   moduleReplacements = new Map();
-  originalModuleDefinitions = new Map();
   constructor(options) {
     this.options = options;
   }
@@ -531,21 +530,14 @@ class DefaultTestingModuleBuilder {
     return this.createTestingModuleRef(bootstrapped, syncResolver);
   }
   bootstrapTestingModule() {
-    const bootstrapped = this.bootstrapWithPatchedModuleImports();
+    const bootstrapped = this.bootstrapWithModuleReplacements();
     if (this.overrides.length > 0) {
       bootstrapped.container.override(...this.overrides);
     }
     return bootstrapped;
   }
-  bootstrapWithPatchedModuleImports() {
-    try {
-      const rootModule = this._applyModuleReplacements(this.options.rootModule);
-      return bootstrapModule(rootModule, {
-        providers: this.options.providers
-      });
-    } finally {
-      this.restorePatchedModuleImports();
-    }
+  bootstrapWithModuleReplacements() {
+    return bootstrapModule(this.options.rootModule, this.createBootstrapModuleOptions());
   }
   createTestingModuleRef(bootstrapped, syncResolver) {
     const dispatcher = createTestingDispatcher(bootstrapped);
@@ -588,43 +580,26 @@ class DefaultTestingModuleBuilder {
       }
     };
   }
-  _applyModuleReplacements(module) {
-    if (this.moduleReplacements.size === 0) {
-      return module;
-    }
-    const replacement = this.moduleReplacements.get(module);
-    if (replacement) {
-      return replacement;
-    }
-    const metadata = getModuleMetadata(module);
-    if (!metadata?.imports || metadata.imports.length === 0) {
-      return module;
-    }
-    const rewrittenImports = this.rewriteModuleImports(metadata.imports);
-    const hasChange = rewrittenImports.some((imp, i) => imp !== metadata.imports[i]);
-    if (!hasChange) {
-      return module;
-    }
-    this.patchModuleImports(module, metadata, rewrittenImports);
-    return module;
-  }
-  rewriteModuleImports(imports) {
-    return imports.map(moduleImport => this._applyModuleReplacements(moduleImport));
+  createBootstrapModuleOptions() {
+    const moduleReplacements = this.createModuleReplacements();
+    return {
+      duplicateProviderPolicy: this.options.duplicateProviderPolicy,
+      logger: this.options.logger,
+      moduleGraphCache: this.options.moduleGraphCache,
+      moduleReplacements,
+      providers: this.options.providers,
+      validationTokens: this.options.validationTokens
+    };
   }
-  patchModuleImports(module, metadata, imports) {
-    if (!this.originalModuleDefinitions.has(module)) {
-      this.originalModuleDefinitions.set(module, metadata);
+  createModuleReplacements() {
+    if (!this.options.moduleReplacements && this.moduleReplacements.size === 0) {
+      return undefined;
     }
-    defineModule(module, {
-      ...metadata,
-      imports
-    });
-  }
-  restorePatchedModuleImports() {
-    for (const [module, metadata] of this.originalModuleDefinitions) {
-      defineModule(module, metadata);
+    const moduleReplacements = new Map(this.options.moduleReplacements);
+    for (const [moduleType, replacement] of this.moduleReplacements) {
+      moduleReplacements.set(moduleType, replacement);
     }
-    this.originalModuleDefinitions.clear();
+    return moduleReplacements;
   }
 }
 

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":"AAGA,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;AAUF;;;;;;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;AA6HD;;;;;;;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;IAiDrD,oCAAoC,IAAI,OAAO,CAAC,IAAI,CAAC;IAqErD,wDAAwD,IAAI,OAAO,CAAC,IAAI,CAAC;IA8CzE,iCAAiC,IAAI,OAAO,CAAC,IAAI,CAAC;IAsDlD,8CAA8C,IAAI,OAAO,CAAC,IAAI,CAAC;IAqD/D,0BAA0B,IAAI,OAAO,CAAC,IAAI,CAAC;IAkDjD;;;OAGG;IACG,mCAAmC,IAAI,OAAO,CAAC,IAAI,CAAC;IAyDpD,wCAAwC,IAAI,OAAO,CAAC,IAAI,CAAC;IAyCzD,4BAA4B,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAyCjF,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":"AAGA,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;AAcF;;;;;;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;AAqKD;;;;;;;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;IAiDrD,oCAAoC,IAAI,OAAO,CAAC,IAAI,CAAC;IAqErD,wDAAwD,IAAI,OAAO,CAAC,IAAI,CAAC;IA8CzE,iCAAiC,IAAI,OAAO,CAAC,IAAI,CAAC;IAsDlD,8CAA8C,IAAI,OAAO,CAAC,IAAI,CAAC;IAqD/D,0BAA0B,IAAI,OAAO,CAAC,IAAI,CAAC;IAkDjD;;;OAGG;IACG,mCAAmC,IAAI,OAAO,CAAC,IAAI,CAAC;IAyDpD,wCAAwC,IAAI,OAAO,CAAC,IAAI,CAAC;IA6CzD,4BAA4B,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA6CjF,8CAA8C,IAAI,OAAO,CAAC,IAAI,CAAC;CA+CtE;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

@@ -18,6 +18,13 @@ import { defineModule } from '@fluojs/runtime';
 function hasListenTarget(value) {
   return typeof value === 'object' && value !== null && 'getListenTarget' in value && typeof value.getListenTarget === 'function';
 }
+function hasRejectedApp(value) {
+  if (typeof value !== 'object' || value === null || !('app' in value)) {
+    return false;
+  }
+  const app = Reflect.get(value, 'app');
+  return typeof app === 'object' && app !== null && 'close' in app && typeof Reflect.get(app, 'close') === 'function' && 'listen' in app && typeof Reflect.get(app, 'listen') === 'function';
+}
 function resolveListeningUrl(app, adapterName) {
   const adapter = Reflect.get(app, 'adapter');
   if (!hasListenTarget(adapter)) {
@@ -100,6 +107,21 @@ async function prepareAndListenWithCleanup(app, adapterName, prepare) {
     throw setupError;
   }
 }
+async function runApplicationWithRejectedAppCleanup(run, adapterName) {
+  try {
+    return await run();
+  } catch (runError) {
+    if (!hasRejectedApp(runError)) {
+      throw runError;
+    }
+    try {
+      await runError.app.close();
+    } catch (cleanupError) {
+      throw new AggregateError([runError, cleanupError], `${adapterName} adapter run() rejected and app.close() also failed during portability harness cleanup.`);
+    }
+    throw runError;
+  }
+}
 
 /**
  * A portability harness for testing HTTP adapters to ensure they behave
@@ -558,12 +580,12 @@ export class HttpAdapterPortabilityHarness {
     defineModule(AppModule, {
       controllers: [_HealthController]
     });
-    const app = await this.options.run(AppModule, {
+    const app = await runApplicationWithRejectedAppCleanup(() => this.options.run(AppModule, {
       cors: false,
       host: '127.0.0.1',
       logger,
       port: 0
-    });
+    }), this.options.name);
     await runWithListeningUrlCleanup(app, this.options.name, async baseUrl => {
       const response = await fetch(`${baseUrl}/health`);
       if (response.status !== 200) {
@@ -607,13 +629,13 @@ export class HttpAdapterPortabilityHarness {
     defineModule(AppModule, {
       controllers: [_HealthController2]
     });
-    const app = await this.options.run(AppModule, {
+    const app = await runApplicationWithRejectedAppCleanup(() => this.options.run(AppModule, {
       cors: false,
       host: '127.0.0.1',
       https,
       logger,
       port: 0
-    });
+    }), this.options.name);
     await runWithListeningUrlCleanup(app, this.options.name, async baseUrl => {
       const response = await requestHttps(`${baseUrl}/health`);
       if (response.statusCode !== 200) {
@@ -663,12 +685,12 @@ export class HttpAdapterPortabilityHarness {
     });
     const signal = 'SIGTERM';
     const listenersBefore = new Set(process.listeners(signal));
-    const app = await this.options.run(AppModule, {
+    const app = await runApplicationWithRejectedAppCleanup(() => this.options.run(AppModule, {
       cors: false,
       logger,
       port: 0,
       shutdownSignals: [signal]
-    });
+    }), this.options.name);
     const registeredListeners = process.listeners(signal).filter(listener => !listenersBefore.has(listener));
     await runWithCleanup(app, this.options.name, async () => {
       if (registeredListeners.length === 0) {

package/dist/vitest/tooling.d.ts

@@ -1,8 +1,8 @@
 /**
- * Collects source-file aliases for a fluo monorepo checkout.
+ * Collects package-export aliases for a fluo monorepo checkout.
  *
  * @param repoRootUrl - Repository root as a file URL or absolute path URL string.
- * @returns A Vite/Vitest alias map that points public package imports at workspace source files.
+ * @returns A Vite/Vitest alias map that points exported package imports at workspace source files.
  */
 export declare function collectWorkspaceAliases(repoRootUrl: string | URL): Record<string, string>;
 /**

package/dist/vitest/tooling.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tooling.d.ts","sourceRoot":"","sources":["../../src/vitest/tooling.ts"],"names":[],"mappings":"AA8EA;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAYzF;AAED;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAAC,WAAW,EAAE,MAAM,GAAG,GAAG,EAAE,SAAS,KAAK,uBAaxF;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,wBAErC"}
+{"version":3,"file":"tooling.d.ts","sourceRoot":"","sources":["../../src/vitest/tooling.ts"],"names":[],"mappings":"AAmJA;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAYzF;AAED;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAAC,WAAW,EAAE,MAAM,GAAG,GAAG,EAAE,SAAS,KAAK,uBAaxF;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,wBAErC"}

package/dist/vitest/tooling.js

@@ -1,62 +1,117 @@
-import { existsSync, readFileSync, readdirSync } from 'node:fs';
-import { extname, join, relative, sep } from 'node:path';
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { defineConfig, mergeConfig } from 'vitest/config';
 import { fluoBabelDecoratorsPlugin } from '../vitest.js';
 const workspaceAliasCache = new Map();
-function collectSourceEntries(sourceRoot) {
-  const entries = [];
-  for (const directoryEntry of readdirSync(sourceRoot, {
-    withFileTypes: true
-  })) {
-    const entryPath = join(sourceRoot, directoryEntry.name);
-    if (directoryEntry.isDirectory()) {
-      entries.push(...collectSourceEntries(entryPath));
+const runtimeExportConditions = ['import', 'default', 'node', 'browser', 'worker'];
+const typeOnlyExportConditions = new Set(['types', 'typings']);
+const javascriptExtensions = ['.js', '.mjs', '.cjs'];
+function isRecord(value) {
+  return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function collectExportEntries(exportsField) {
+  if (typeof exportsField === 'string' || Array.isArray(exportsField)) {
+    return [['.', exportsField]];
+  }
+  if (!isRecord(exportsField)) {
+    return [];
+  }
+  const entries = Object.entries(exportsField);
+  const hasSubpathKeys = entries.some(([subpath]) => subpath === '.' || subpath.startsWith('./'));
+  if (!hasSubpathKeys) {
+    return [['.', exportsField]];
+  }
+  return entries.filter(([subpath]) => subpath === '.' || subpath.startsWith('./'));
+}
+function resolveRuntimeExportTarget(exportTarget) {
+  if (typeof exportTarget === 'string') {
+    return exportTarget;
+  }
+  if (Array.isArray(exportTarget)) {
+    for (const candidate of exportTarget) {
+      const resolvedCandidate = resolveRuntimeExportTarget(candidate);
+      if (resolvedCandidate) {
+        return resolvedCandidate;
+      }
+    }
+    return undefined;
+  }
+  if (!isRecord(exportTarget)) {
+    return undefined;
+  }
+  for (const condition of runtimeExportConditions) {
+    const resolvedCondition = resolveRuntimeExportTarget(exportTarget[condition]);
+    if (resolvedCondition) {
+      return resolvedCondition;
+    }
+  }
+  for (const [condition, nestedTarget] of Object.entries(exportTarget)) {
+    if (typeOnlyExportConditions.has(condition)) {
       continue;
     }
-    if (directoryEntry.isFile()) {
-      entries.push(entryPath);
+    const resolvedNestedTarget = resolveRuntimeExportTarget(nestedTarget);
+    if (resolvedNestedTarget) {
+      return resolvedNestedTarget;
     }
   }
-  return entries;
+  return undefined;
+}
+function resolveSourcePathFromExportTarget(packageRoot, exportTarget) {
+  const runtimeTarget = resolveRuntimeExportTarget(exportTarget);
+  if (!runtimeTarget?.startsWith('./dist/')) {
+    return undefined;
+  }
+  for (const extension of javascriptExtensions) {
+    if (!runtimeTarget.endsWith(extension)) {
+      continue;
+    }
+    const sourcePath = join(packageRoot, 'src', `${runtimeTarget.slice('./dist/'.length, -extension.length)}.ts`);
+    if (existsSync(sourcePath)) {
+      return sourcePath;
+    }
+  }
+  return undefined;
+}
+function toAliasName(packageName, exportSubpath) {
+  if (exportSubpath === '.') {
+    return packageName;
+  }
+  return `${packageName}/${exportSubpath.slice('./'.length)}`;
 }
 function collectWorkspaceAliasesFromRoot(repoRoot) {
   const packagesRoot = join(repoRoot, 'packages');
   const aliases = {};
   for (const packageDirectoryName of readdirSync(packagesRoot)) {
     const packageRoot = join(packagesRoot, packageDirectoryName);
-    const sourceRoot = join(packageRoot, 'src');
     const manifestPath = join(packageRoot, 'package.json');
-    if (!existsSync(sourceRoot) || !existsSync(manifestPath)) {
+    if (!existsSync(manifestPath)) {
       continue;
     }
     const manifest = JSON.parse(readFileSync(manifestPath, 'utf8'));
-    const scopeName = manifest.name ?? `@fluojs/${packageDirectoryName}`;
-    for (const sourceEntryPath of collectSourceEntries(sourceRoot)) {
-      const relativeSourceEntry = relative(sourceRoot, sourceEntryPath);
-      if (extname(sourceEntryPath) !== '.ts' || relativeSourceEntry.endsWith('.test.ts') || relativeSourceEntry === 'index.ts') {
-        continue;
-      }
-      const subpath = relativeSourceEntry.slice(0, -3).split(sep).join('/');
-      aliases[`${scopeName}/${subpath}`] = sourceEntryPath;
-    }
-    const indexPath = join(sourceRoot, 'index.ts');
-    if (existsSync(indexPath)) {
-      aliases[scopeName] = indexPath;
+    const packageName = manifest.name ?? `@fluojs/${packageDirectoryName}`;
+    const exportAliases = collectExportEntries(manifest.exports).map(([exportSubpath, exportTarget]) => {
+      const sourcePath = resolveSourcePathFromExportTarget(packageRoot, exportTarget);
+      return sourcePath ? {
+        aliasName: toAliasName(packageName, exportSubpath),
+        sourcePath
+      } : undefined;
+    }).filter(entry => entry !== undefined).sort((left, right) => right.aliasName.length - left.aliasName.length);
+    for (const {
+      aliasName,
+      sourcePath
+    } of exportAliases) {
+      aliases[aliasName] = sourcePath;
     }
   }
-  return {
-    '@fluojs/runtime/internal/http-adapter': join(packagesRoot, 'runtime', 'src', 'internal-http-adapter.ts'),
-    '@fluojs/runtime/internal/request-response-factory': join(packagesRoot, 'runtime', 'src', 'internal-request-response-factory.ts'),
-    ...aliases
-  };
+  return aliases;
 }
 
 /**
- * Collects source-file aliases for a fluo monorepo checkout.
+ * Collects package-export aliases for a fluo monorepo checkout.
  *
  * @param repoRootUrl - Repository root as a file URL or absolute path URL string.
- * @returns A Vite/Vitest alias map that points public package imports at workspace source files.
+ * @returns A Vite/Vitest alias map that points exported package imports at workspace source files.
  */
 export function collectWorkspaceAliases(repoRootUrl) {
   const repoRoot = fileURLToPath(repoRootUrl);

package/package.json

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