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

package/dist/mock.js

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

package/dist/module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,SAAS,EAId,KAAK,QAAQ,EACd,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAqC,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAMrF,OAAO,KAAK,EAA2B,oBAAoB,EAAE,oBAAoB,EAAoB,MAAM,YAAY,CAAC;AAExH;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,UAAU,GAAG,QAAQ,EAAE,CAQzE;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,UAAU,GAAG,SAAS,EAAE,CAQ5E;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU,EAAE,CAQzE;AAiaD;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,oBAAoB,CAEvF;AAED;;GAEG;AACH,eAAO,MAAM,IAAI;;CAEhB,CAAC"}
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,SAAS,EAId,KAAK,QAAQ,EACd,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAqC,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAMrF,OAAO,KAAK,EAA2B,oBAAoB,EAAE,oBAAoB,EAAoB,MAAM,YAAY,CAAC;AAExH;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,UAAU,GAAG,QAAQ,EAAE,CAQzE;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,UAAU,GAAG,SAAS,EAAE,CAQ5E;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU,EAAE,CAQzE;AAkkBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,oBAAoB,CAEvF;AAED;;GAEG;AACH,eAAO,MAAM,IAAI;;CAEhB,CAAC"}

package/dist/module.js

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

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

@@ -25,6 +25,14 @@ export interface HttpAdapterPortabilityHarnessOptions<TBootstrapOptions extends
      * @returns A promise that resolves to the application instance.
      */
     bootstrap: (rootModule: ModuleType, options: TBootstrapOptions) => Promise<TApp>;
+    /**
+     * Optional adapter-specific content type used by the exact-byte raw-body portability assertion.
+     */
+    exactRawBodyByteContentType?: string;
+    /**
+     * Optional adapter-specific preparation used before the exact-byte raw-body portability assertion.
+     */
+    prepareExactRawBodyByteTest?: (app: TApp) => void | Promise<void>;
     /**
      * The name of the adapter being tested.
      */
@@ -60,8 +68,15 @@ export declare class HttpAdapterPortabilityHarness<TBootstrapOptions extends obj
      */
     assertPreservesMalformedCookieValues(): Promise<void>;
     assertPreservesRawBodyForJsonAndText(): Promise<void>;
+    assertPreservesExactRawBodyBytesForByteSensitivePayloads(): Promise<void>;
     assertExcludesRawBodyForMultipart(): Promise<void>;
+    assertDefaultsMultipartTotalLimitToMaxBodySize(): Promise<void>;
     assertSupportsSseStreaming(): Promise<void>;
+    /**
+     * Asserts that adapter stream backpressure waiters settle when the response
+     * closes before a `drain` event is emitted.
+     */
+    assertSettlesStreamDrainWaitOnClose(): Promise<void>;
     assertReportsConfiguredHostInStartupLogs(): Promise<void>;
     assertReportsHttpsStartupUrl(https: {
         cert: string;

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

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