@navios/core 0.8.0 → 0.9.0

package/lib/testing/index.mjs

@@ -1,6 +1,6 @@
-import { t as NaviosFactory } from "../src-gBAChVRL.mjs";
-import "../use-guards.decorator-CUww54Nt.mjs";
-import { TestContainer } from "@navios/di/testing";
+import { t as NaviosFactory } from "../src-Bo23RIo-.mjs";
+import "../use-guards.decorator-CzVXuLkz.mjs";
+import { TestContainer, UnitTestContainer } from "@navios/di/testing";
 
 export * from "@navios/di/testing"
 
@@ -8,32 +8,85 @@ export * from "@navios/di/testing"
 /**
 * A testing-optimized wrapper around NaviosApplication.
 * Provides utilities for setting up test environments with mock dependencies.
-*/ var TestingModule = class {
+*
+* When `init()` is called, a request scope is automatically started.
+* This means `get()` calls will resolve request-scoped services correctly,
+* simulating a real HTTP request context.
+*
+* @example
+* ```typescript
+* const module = await TestingModule.create(AppModule)
+*   .overrideProvider(DatabaseService)
+*   .useValue(mockDatabase)
+*   .init()
+*
+* const userService = await module.get(UserService)
+* // ... run tests ...
+*
+* await module.close()
+* ```
+*/ var TestingModule = class TestingModule {
 	appModule;
 	container;
 	options;
 	app = null;
+	scopedContainer = null;
+	requestId = `test-request-${Date.now()}-${Math.random().toString(36).slice(2)}`;
 	constructor(appModule, container, options) {
 		this.appModule = appModule;
 		this.container = container;
 		this.options = options;
 	}
 	/**
-	* Compiles the testing module and returns the NaviosApplication.
-	* Call this after setting up all overrides.
+	* Creates a new TestingModule for the given app module.
+	* This is the main entry point for setting up integration tests.
+	*
+	* @example
+	* ```typescript
+	* const module = await TestingModule.create(AppModule)
+	*   .overrideProvider(DatabaseService)
+	*   .useValue(mockDatabase)
+	*   .init()
+	* ```
+	*/ static create(appModule, options = { adapter: [] }) {
+		const container = options.container ?? new TestContainer({ parentRegistry: options.registry });
+		if (options.overrides) {
+			for (const override of options.overrides) if (override.useValue !== void 0) container.bind(override.token).toValue(override.useValue);
+			else if (override.useClass) container.bind(override.token).toClass(override.useClass);
+		}
+		return new TestingModule(appModule, container, options);
+	}
+	/**
+	* Compiles the testing module without initializing it.
+	* Call this if you need to access the app before initialization.
+	*
+	* @returns this for chaining
 	*/ async compile() {
-		this.app = await NaviosFactory.create(this.appModule, {
+		if (!this.app) this.app = await NaviosFactory.create(this.appModule, {
 			...this.options,
 			container: this.container
 		});
-		return this.app;
+		return this;
 	}
 	/**
-	* Initializes the application (loads modules, sets up HTTP if configured).
-	* This is equivalent to calling app.init() on the compiled application.
+	* Initializes the application and starts a request scope.
+	*
+	* This is equivalent to calling `compile()` followed by `app.init()`,
+	* plus starting a request context for proper request-scoped service resolution.
+	*
+	* @returns this for chaining
 	*/ async init() {
 		if (!this.app) await this.compile();
 		await this.app.init();
+		this.scopedContainer = this.container.beginRequest(this.requestId, { testingModule: true });
+		return this;
+	}
+	/**
+	* Gets the compiled application.
+	*
+	* @throws Error if the module has not been compiled yet
+	*/ getApp() {
+		if (!this.app) throw new Error("TestingModule not compiled. Call compile() or init() first.");
 		return this.app;
 	}
 	/**
@@ -42,13 +95,17 @@ export * from "@navios/di/testing"
 		return this.container;
 	}
 	/**
-	* Gets the compiled application. Throws if not yet compiled.
-	*/ getApplication() {
-		if (!this.app) throw new Error("TestingModule not compiled. Call compile() or init() first.");
-		return this.app;
+	* Gets the scoped container for the current test request.
+	* Only available after calling `init()`.
+	*
+	* @throws Error if init() has not been called
+	*/ getScopedContainer() {
+		if (!this.scopedContainer) throw new Error("No scoped container available. Call init() first.");
+		return this.scopedContainer;
 	}
 	/**
-	* Override a provider with a mock value.
+	* Override a provider with a mock value or class.
+	* Must be called before `compile()` or `init()`.
 	*/ overrideProvider(token) {
 		return {
 			useValue: (value) => {
@@ -63,38 +120,297 @@ export * from "@navios/di/testing"
 	}
 	/**
 	* Gets an instance from the container.
+	*
+	* If `init()` has been called, this uses the scoped container
+	* which properly resolves request-scoped services.
+	*
+	* If only `compile()` was called, this uses the root container
+	* and request-scoped services will throw.
 	*/ async get(token) {
+		if (this.scopedContainer) return this.scopedContainer.get(token);
 		return this.container.get(token);
 	}
 	/**
-	* Disposes the testing module and cleans up resources.
+	* Disposes the testing module and cleans up all resources.
+	*
+	* This will:
+	* 1. End the request scope (if started)
+	* 2. Close the application (if initialized)
+	* 3. Dispose the container
 	*/ async close() {
-		if (this.app) await this.app.close();
+		if (this.scopedContainer) {
+			await this.scopedContainer.endRequest();
+			this.scopedContainer = null;
+		}
+		if (this.app) {
+			await this.app.close();
+			this.app = null;
+		}
 		await this.container.dispose();
 	}
+	/**
+	* Asserts that a service has been resolved at least once.
+	*/ expectResolved(token) {
+		this.container.expectResolved(token);
+	}
+	/**
+	* Asserts that a service has NOT been resolved.
+	*/ expectNotResolved(token) {
+		this.container.expectNotResolved(token);
+	}
+	/**
+	* Asserts that a service is registered as singleton scope.
+	*/ expectSingleton(token) {
+		this.container.expectSingleton(token);
+	}
+	/**
+	* Asserts that a service is registered as transient scope.
+	*/ expectTransient(token) {
+		this.container.expectTransient(token);
+	}
+	/**
+	* Asserts that a service is registered as request scope.
+	*/ expectRequestScoped(token) {
+		this.container.expectRequestScoped(token);
+	}
+	/**
+	* Asserts that a method was called on a service.
+	* Note: You must use `recordMethodCall()` in your mocks for this to work.
+	*/ expectCalled(token, method) {
+		this.container.expectCalled(token, method);
+	}
+	/**
+	* Asserts that a method was called with specific arguments.
+	* Note: You must use `recordMethodCall()` in your mocks for this to work.
+	*/ expectCalledWith(token, method, expectedArgs) {
+		this.container.expectCalledWith(token, method, expectedArgs);
+	}
+	/**
+	* Asserts that a method was called a specific number of times.
+	* Note: You must use `recordMethodCall()` in your mocks for this to work.
+	*/ expectCallCount(token, method, count) {
+		this.container.expectCallCount(token, method, count);
+	}
+	/**
+	* Records a method call for tracking.
+	* Call this from your mock implementations to enable call assertions.
+	*/ recordMethodCall(token, method, args, result, error) {
+		this.container.recordMethodCall(token, method, args, result, error);
+	}
+	/**
+	* Gets all recorded method calls for a service.
+	*/ getMethodCalls(token) {
+		return this.container.getMethodCalls(token);
+	}
+	/**
+	* Gets the dependency graph for debugging or snapshot testing.
+	*/ getDependencyGraph() {
+		return this.container.getDependencyGraph();
+	}
+	/**
+	* Gets a simplified dependency graph showing only token relationships.
+	*/ getSimplifiedDependencyGraph() {
+		return this.container.getSimplifiedDependencyGraph();
+	}
 };
 /**
 * Creates a testing module for the given app module.
-* This is the main entry point for setting up tests.
+*
+* @deprecated Use `TestingModule.create()` instead.
 *
 * @example
 * ```typescript
-* const testingModule = await createTestingModule(AppModule, {
-*   adapter: [],
-* })
-*   .overrideProvider(DatabaseService)
-*   .useValue(mockDatabaseService)
-*   .compile()
+* // Old way (deprecated)
+* const module = createTestingModule(AppModule)
+*
+* // New way
+* const module = TestingModule.create(AppModule)
 * ```
 */ function createTestingModule(appModule, options = { adapter: [] }) {
-	const container = new TestContainer();
-	if (options.overrides) {
-		for (const override of options.overrides) if (override.useValue !== void 0) container.bind(override.token).toValue(override.useValue);
-		else if (override.useClass) container.bind(override.token).toClass(override.useClass);
-	}
-	return new TestingModule(appModule, container, options);
+	return TestingModule.create(appModule, options);
 }
 
 //#endregion
-export { TestingModule, createTestingModule };
+//#region src/testing/unit-testing-module.mts
+/**
+* A lightweight testing module for isolated unit tests.
+*
+* Unlike `TestingModule`, this does NOT load Navios modules or create an application.
+* It uses `UnitTestContainer` which:
+* - Only allows explicitly provided services
+* - Automatically tracks all method calls via proxies
+* - Can auto-mock unregistered dependencies
+*
+* This is ideal for testing services in isolation without the overhead
+* of full module loading.
+*
+* @example
+* ```typescript
+* const module = UnitTestingModule.create({
+*   providers: [
+*     { token: UserService, useClass: UserService },
+*     { token: DatabaseService, useValue: mockDatabase },
+*   ],
+* })
+*
+* const userService = await module.get(UserService)
+* await userService.findUser('123')
+*
+* // Method calls are automatically tracked
+* module.expectCalled(UserService, 'findUser')
+* module.expectCalledWith(UserService, 'findUser', ['123'])
+*
+* await module.close()
+* ```
+*/ var UnitTestingModule = class UnitTestingModule {
+	container;
+	constructor(container) {
+		this.container = container;
+	}
+	/**
+	* Creates a new UnitTestingModule with the given providers.
+	*
+	* @example
+	* ```typescript
+	* const module = UnitTestingModule.create({
+	*   providers: [
+	*     { token: UserService, useClass: UserService },
+	*     { token: ConfigToken, useValue: { apiUrl: 'test' } },
+	*   ],
+	* })
+	* ```
+	*/ static create(options) {
+		return new UnitTestingModule(options.container ?? new UnitTestContainer({
+			providers: options.providers,
+			allowUnregistered: options.allowUnregistered,
+			logger: options.logger
+		}));
+	}
+	/**
+	* Gets the underlying UnitTestContainer for direct manipulation.
+	*/ getContainer() {
+		return this.container;
+	}
+	/**
+	* Gets an instance from the container.
+	*
+	* All resolved instances are wrapped in tracking proxies,
+	* so method calls are automatically recorded.
+	*
+	* @throws Error if the token is not in the providers list
+	*         and `allowUnregistered` is false
+	*/ async get(token) {
+		return this.container.get(token);
+	}
+	/**
+	* Disposes the module and cleans up all resources.
+	*/ async close() {
+		await this.container.clear();
+	}
+	/**
+	* Enables auto-mocking for unregistered dependencies.
+	* Unregistered services will return a proxy that throws on method access.
+	*/ enableAutoMocking() {
+		this.container.enableAutoMocking();
+		return this;
+	}
+	/**
+	* Disables auto-mocking (strict mode).
+	* Unregistered dependencies will throw immediately on resolution.
+	*/ disableAutoMocking() {
+		this.container.disableAutoMocking();
+		return this;
+	}
+	/**
+	* Asserts that a service has been resolved at least once.
+	*/ expectResolved(token) {
+		this.container.expectResolved(token);
+	}
+	/**
+	* Asserts that a service has NOT been resolved.
+	*/ expectNotResolved(token) {
+		this.container.expectNotResolved(token);
+	}
+	/**
+	* Asserts that a service was auto-mocked (not in providers list).
+	*/ expectAutoMocked(token) {
+		this.container.expectAutoMocked(token);
+	}
+	/**
+	* Asserts that a service was NOT auto-mocked (is in providers list).
+	*/ expectNotAutoMocked(token) {
+		this.container.expectNotAutoMocked(token);
+	}
+	/**
+	* Asserts that a method was called on a service.
+	* Method calls are automatically tracked via proxy.
+	*/ expectCalled(token, method) {
+		this.container.expectCalled(token, method);
+	}
+	/**
+	* Asserts that a method was NOT called on a service.
+	*/ expectNotCalled(token, method) {
+		this.container.expectNotCalled(token, method);
+	}
+	/**
+	* Asserts that a method was called with specific arguments.
+	*/ expectCalledWith(token, method, expectedArgs) {
+		this.container.expectCalledWith(token, method, expectedArgs);
+	}
+	/**
+	* Asserts that a method was called a specific number of times.
+	*/ expectCallCount(token, method, count) {
+		this.container.expectCallCount(token, method, count);
+	}
+	/**
+	* Gets all recorded method calls for a service.
+	*/ getMethodCalls(token) {
+		return this.container.getMethodCalls(token);
+	}
+	/**
+	* Gets statistics about a service (instance count, method calls, lifecycle events).
+	*/ getServiceStats(token) {
+		return this.container.getServiceStats(token);
+	}
+	/**
+	* Clears all recorded method calls.
+	* Useful for resetting state between test assertions.
+	*/ clearMethodCalls() {
+		this.container.clearMethodCalls();
+	}
+	/**
+	* Gets list of all registered provider token IDs.
+	*/ getRegisteredTokenIds() {
+		return this.container.getRegisteredTokenIds();
+	}
+	/**
+	* Gets list of all auto-mocked token IDs.
+	*/ getAutoMockedTokenIds() {
+		return this.container.getAutoMockedTokenIds();
+	}
+	/**
+	* Asserts that a service's onServiceInit was called.
+	*/ expectInitialized(token) {
+		this.container.expectInitialized(token);
+	}
+	/**
+	* Asserts that a service's onServiceDestroy was called.
+	*/ expectDestroyed(token) {
+		this.container.expectDestroyed(token);
+	}
+	/**
+	* Asserts that a service has NOT been destroyed.
+	*/ expectNotDestroyed(token) {
+		this.container.expectNotDestroyed(token);
+	}
+	/**
+	* Records a lifecycle event for tracking.
+	* Call this from your mock implementations if needed.
+	*/ recordLifecycleEvent(token, event, instanceName) {
+		this.container.recordLifecycleEvent(token, event, instanceName);
+	}
+};
+
+//#endregion
+export { TestingModule, UnitTestingModule, createTestingModule };
 //# sourceMappingURL=index.mjs.map

package/lib/testing/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["TestContainer","NaviosFactory","TestingModule","app","appModule","container","options","compile","create","init","getContainer","getApplication","Error","overrideProvider","token","useValue","value","bind","toValue","useClass","target","toClass","get","close","dispose","createTestingModule","adapter","overrides","override","undefined"],"sources":["../../src/testing/testing-module.mts"],"sourcesContent":["import type { ClassType, ClassTypeWithInstance, InjectionToken } from '@navios/di'\nimport type { NaviosModule } from '../interfaces/index.mjs'\nimport type { NaviosApplicationOptions } from '../navios.application.mjs'\n\nimport { TestContainer } from '@navios/di/testing'\n\nimport { NaviosApplication } from '../navios.application.mjs'\nimport { NaviosFactory } from '../navios.factory.mjs'\n\n/**\n * Configuration for overriding a provider in the testing module.\n * \n * @typeParam T - The type of the provider being overridden\n */\nexport interface TestingModuleOverride<T = any> {\n  /**\n   * The injection token or class to override.\n   */\n  token: ClassType | InjectionToken<T, any>\n  /**\n   * Value to use instead of the original provider.\n   */\n  useValue?: T\n  /**\n   * Class to use instead of the original provider.\n   */\n  useClass?: ClassType\n}\n\n/**\n * Options for creating a testing module.\n * \n * Extends NaviosApplicationOptions but excludes the container option,\n * as TestingModule manages its own TestContainer.\n */\nexport interface TestingModuleOptions\n  extends Omit<NaviosApplicationOptions, 'container'> {\n  /**\n   * Initial provider overrides to apply when creating the testing module.\n   * \n   * You can also use `overrideProvider()` method for a fluent API.\n   */\n  overrides?: TestingModuleOverride[]\n}\n\n/**\n * A testing-optimized wrapper around NaviosApplication.\n * Provides utilities for setting up test environments with mock dependencies.\n */\nexport class TestingModule {\n  private app: NaviosApplication | null = null\n\n  constructor(\n    private readonly appModule: ClassTypeWithInstance<NaviosModule>,\n    private readonly container: TestContainer,\n    private readonly options: TestingModuleOptions,\n  ) {}\n\n  /**\n   * Compiles the testing module and returns the NaviosApplication.\n   * Call this after setting up all overrides.\n   */\n  async compile(): Promise<NaviosApplication> {\n    this.app = await NaviosFactory.create(this.appModule, {\n      ...this.options,\n      container: this.container,\n    })\n    return this.app\n  }\n\n  /**\n   * Initializes the application (loads modules, sets up HTTP if configured).\n   * This is equivalent to calling app.init() on the compiled application.\n   */\n  async init(): Promise<NaviosApplication> {\n    if (!this.app) {\n      await this.compile()\n    }\n    await this.app!.init()\n    return this.app!\n  }\n\n  /**\n   * Gets the underlying TestContainer for direct manipulation.\n   */\n  getContainer(): TestContainer {\n    return this.container\n  }\n\n  /**\n   * Gets the compiled application. Throws if not yet compiled.\n   */\n  getApplication(): NaviosApplication {\n    if (!this.app) {\n      throw new Error(\n        'TestingModule not compiled. Call compile() or init() first.',\n      )\n    }\n    return this.app\n  }\n\n  /**\n   * Override a provider with a mock value.\n   */\n  overrideProvider<T>(token: ClassType | InjectionToken<T, any>): {\n    useValue: (value: T) => TestingModule\n    useClass: (target: ClassType) => TestingModule\n  } {\n    return {\n      useValue: (value: T) => {\n        this.container.bind(token as any).toValue(value)\n        return this\n      },\n      useClass: (target: ClassType) => {\n        this.container.bind(token as any).toClass(target)\n        return this\n      },\n    }\n  }\n\n  /**\n   * Gets an instance from the container.\n   */\n  async get<T>(token: ClassTypeWithInstance<T> | InjectionToken<T, any>): Promise<T> {\n    return this.container.get(token as any)\n  }\n\n  /**\n   * Disposes the testing module and cleans up resources.\n   */\n  async close(): Promise<void> {\n    if (this.app) {\n      await this.app.close()\n    }\n    await this.container.dispose()\n  }\n}\n\n/**\n * Fluent builder interface for TestingModule.\n * \n * Provides a chainable API for configuring and using a testing module.\n */\nexport interface TestingModuleBuilder {\n  /**\n   * Override a provider with a mock value or class.\n   * \n   * @param token - The injection token or class to override\n   * @returns An object with `useValue` and `useClass` methods for chaining\n   * \n   * @example\n   * ```typescript\n   * const testingModule = await createTestingModule(AppModule)\n   *   .overrideProvider(DatabaseService)\n   *   .useValue(mockDatabaseService)\n   *   .compile()\n   * ```\n   */\n  overrideProvider<T>(token: ClassType | InjectionToken<T, any>): {\n    useValue: (value: T) => TestingModuleBuilder\n    useClass: (target: ClassType) => TestingModuleBuilder\n  }\n\n  /**\n   * Compiles the testing module and returns the NaviosApplication.\n   * \n   * This creates the application instance but does not initialize it.\n   * Call `init()` if you need the application to be fully initialized.\n   */\n  compile(): Promise<NaviosApplication>\n\n  /**\n   * Initializes the application (loads modules, sets up HTTP if configured).\n   * \n   * This is equivalent to calling `compile()` followed by `app.init()`.\n   */\n  init(): Promise<NaviosApplication>\n\n  /**\n   * Gets the underlying TestContainer for direct manipulation.\n   */\n  getContainer(): TestContainer\n\n  /**\n   * Gets an instance from the container.\n   * \n   * @typeParam T - The type of the instance to retrieve\n   * @param token - The injection token or class\n   * @returns The resolved instance\n   */\n  get<T>(token: ClassTypeWithInstance<T> | InjectionToken<T, any>): Promise<T>\n\n  /**\n   * Disposes the testing module and cleans up resources.\n   */\n  close(): Promise<void>\n}\n\n/**\n * Creates a testing module for the given app module.\n * This is the main entry point for setting up tests.\n *\n * @example\n * ```typescript\n * const testingModule = await createTestingModule(AppModule, {\n *   adapter: [],\n * })\n *   .overrideProvider(DatabaseService)\n *   .useValue(mockDatabaseService)\n *   .compile()\n * ```\n */\nexport function createTestingModule(\n  appModule: ClassTypeWithInstance<NaviosModule>,\n  options: TestingModuleOptions = { adapter: [] },\n): TestingModule {\n  const container = new TestContainer()\n\n  // Apply initial overrides if provided\n  if (options.overrides) {\n    for (const override of options.overrides) {\n      if (override.useValue !== undefined) {\n        container.bind(override.token as any).toValue(override.useValue)\n      } else if (override.useClass) {\n        container.bind(override.token as any).toClass(override.useClass)\n      }\n    }\n  }\n\n  return new TestingModule(appModule, container, options)\n}\n"],"mappings":";;;;;;;;;;GAiDA,IAAaE,gBAAb,MAAaA;;;;CACHC,MAAgC;CAExC,YACE,WACA,WACA,SACA;OAHiBC,YAAAA;OACAC,YAAAA;OACAC,UAAAA;;;;;IAOnB,MAAMC,UAAsC;AAC1C,OAAKJ,MAAM,MAAMF,cAAcO,OAAO,KAAKJ,WAAW;GACpD,GAAG,KAAKE;GACRD,WAAW,KAAKA;GAClB,CAAA;AACA,SAAO,KAAKF;;;;;IAOd,MAAMM,OAAmC;AACvC,MAAI,CAAC,KAAKN,IACR,OAAM,KAAKI,SAAO;AAEpB,QAAM,KAAKJ,IAAKM,MAAI;AACpB,SAAO,KAAKN;;;;IAMdO,eAA8B;AAC5B,SAAO,KAAKL;;;;IAMdM,iBAAoC;AAClC,MAAI,CAAC,KAAKR,IACR,OAAM,IAAIS,MACR,8DAAA;AAGJ,SAAO,KAAKT;;;;IAMdU,iBAAoBC,OAGlB;AACA,SAAO;GACLC,WAAWC,UAAAA;AACT,SAAKX,UAAUY,KAAKH,MAAAA,CAAcI,QAAQF,MAAAA;AAC1C,WAAO;;GAETG,WAAWC,WAAAA;AACT,SAAKf,UAAUY,KAAKH,MAAAA,CAAcO,QAAQD,OAAAA;AAC1C,WAAO;;GAEX;;;;IAMF,MAAME,IAAOR,OAAsE;AACjF,SAAO,KAAKT,UAAUiB,IAAIR,MAAAA;;;;IAM5B,MAAMS,QAAuB;AAC3B,MAAI,KAAKpB,IACP,OAAM,KAAKA,IAAIoB,OAAK;AAEtB,QAAM,KAAKlB,UAAUmB,SAAO;;;;;;;;;;;;;;;;GA8EhC,SAAgBC,oBACdrB,WACAE,UAAgC,EAAEoB,SAAS,EAAE,EAAE,EAAA;CAE/C,MAAMrB,YAAY,IAAIL,eAAAA;AAGtB,KAAIM,QAAQqB,WACV;OAAK,MAAMC,YAAYtB,QAAQqB,UAC7B,KAAIC,SAASb,aAAac,OACxBxB,WAAUY,KAAKW,SAASd,MAAK,CAASI,QAAQU,SAASb,SAAQ;WACtDa,SAAST,SAClBd,WAAUY,KAAKW,SAASd,MAAK,CAASO,QAAQO,SAAST,SAAQ;;AAKrE,QAAO,IAAIjB,cAAcE,WAAWC,WAAWC,QAAAA"}
+{"version":3,"file":"index.mjs","names":["TestContainer","NaviosFactory","TestingModule","app","scopedContainer","requestId","Date","now","Math","random","toString","slice","appModule","container","options","create","adapter","parentRegistry","registry","overrides","override","useValue","undefined","bind","token","toValue","useClass","toClass","compile","init","beginRequest","testingModule","getApp","Error","getContainer","getScopedContainer","overrideProvider","value","target","get","close","endRequest","dispose","expectResolved","expectNotResolved","expectSingleton","expectTransient","expectRequestScoped","expectCalled","method","expectCalledWith","expectedArgs","expectCallCount","count","recordMethodCall","args","result","error","getMethodCalls","getDependencyGraph","getSimplifiedDependencyGraph","createTestingModule","UnitTestContainer","UnitTestingModule","container","create","options","providers","allowUnregistered","logger","getContainer","get","token","close","clear","enableAutoMocking","disableAutoMocking","expectResolved","expectNotResolved","expectAutoMocked","expectNotAutoMocked","expectCalled","method","expectNotCalled","expectCalledWith","expectedArgs","expectCallCount","count","getMethodCalls","getServiceStats","clearMethodCalls","getRegisteredTokenIds","getAutoMockedTokenIds","expectInitialized","expectDestroyed","expectNotDestroyed","recordLifecycleEvent","event","instanceName"],"sources":["../../src/testing/testing-module.mts","../../src/testing/unit-testing-module.mts"],"sourcesContent":["import type {\n  ClassType,\n  ClassTypeWithInstance,\n  InjectionToken,\n  ScopedContainer,\n} from '@navios/di'\n\nimport { TestContainer } from '@navios/di/testing'\n\nimport type { NaviosModule } from '../interfaces/index.mjs'\nimport type { NaviosApplicationOptions } from '../navios.application.mjs'\n\nimport { NaviosApplication } from '../navios.application.mjs'\nimport { NaviosFactory } from '../navios.factory.mjs'\n\n/**\n * Configuration for overriding a provider in the testing module.\n *\n * @typeParam T - The type of the provider being overridden\n */\nexport interface TestingModuleOverride<T = any> {\n  /**\n   * The injection token or class to override.\n   */\n  token: ClassType | InjectionToken<T, any>\n  /**\n   * Value to use instead of the original provider.\n   */\n  useValue?: T\n  /**\n   * Class to use instead of the original provider.\n   */\n  useClass?: ClassType\n}\n\n/**\n * Options for creating a testing module.\n *\n * Extends NaviosApplicationOptions but excludes the container option,\n * as TestingModule manages its own TestContainer.\n */\nexport interface TestingModuleOptions extends Omit<\n  NaviosApplicationOptions,\n  'container'\n> {\n  /**\n   * Initial provider overrides to apply when creating the testing module.\n   *\n   * You can also use `overrideProvider()` method for a fluent API.\n   */\n  overrides?: TestingModuleOverride[]\n  /**\n   * Container to use for the testing module.\n   * If not provided, a new TestContainer will be created.\n   */\n  container?: TestContainer\n}\n\n/**\n * A testing-optimized wrapper around NaviosApplication.\n * Provides utilities for setting up test environments with mock dependencies.\n *\n * When `init()` is called, a request scope is automatically started.\n * This means `get()` calls will resolve request-scoped services correctly,\n * simulating a real HTTP request context.\n *\n * @example\n * ```typescript\n * const module = await TestingModule.create(AppModule)\n *   .overrideProvider(DatabaseService)\n *   .useValue(mockDatabase)\n *   .init()\n *\n * const userService = await module.get(UserService)\n * // ... run tests ...\n *\n * await module.close()\n * ```\n */\nexport class TestingModule {\n  private app: NaviosApplication | null = null\n  private scopedContainer: ScopedContainer | null = null\n  private requestId = `test-request-${Date.now()}-${Math.random().toString(36).slice(2)}`\n\n  private constructor(\n    private readonly appModule: ClassTypeWithInstance<NaviosModule>,\n    private readonly container: TestContainer,\n    private readonly options: TestingModuleOptions,\n  ) {}\n\n  /**\n   * Creates a new TestingModule for the given app module.\n   * This is the main entry point for setting up integration tests.\n   *\n   * @example\n   * ```typescript\n   * const module = await TestingModule.create(AppModule)\n   *   .overrideProvider(DatabaseService)\n   *   .useValue(mockDatabase)\n   *   .init()\n   * ```\n   */\n  static create(\n    appModule: ClassTypeWithInstance<NaviosModule>,\n    options: TestingModuleOptions = { adapter: [] },\n  ): TestingModule {\n    const container =\n      options.container ??\n      new TestContainer({\n        parentRegistry: options.registry,\n      })\n\n    // Apply initial overrides if provided\n    if (options.overrides) {\n      for (const override of options.overrides) {\n        if (override.useValue !== undefined) {\n          container.bind(override.token as any).toValue(override.useValue)\n        } else if (override.useClass) {\n          container.bind(override.token as any).toClass(override.useClass)\n        }\n      }\n    }\n\n    return new TestingModule(appModule, container, options)\n  }\n\n  /**\n   * Compiles the testing module without initializing it.\n   * Call this if you need to access the app before initialization.\n   *\n   * @returns this for chaining\n   */\n  async compile(): Promise<this> {\n    if (!this.app) {\n      this.app = await NaviosFactory.create(this.appModule, {\n        ...this.options,\n        container: this.container,\n      })\n    }\n    return this\n  }\n\n  /**\n   * Initializes the application and starts a request scope.\n   *\n   * This is equivalent to calling `compile()` followed by `app.init()`,\n   * plus starting a request context for proper request-scoped service resolution.\n   *\n   * @returns this for chaining\n   */\n  async init(): Promise<this> {\n    if (!this.app) {\n      await this.compile()\n    }\n    await this.app!.init()\n\n    // Begin a request scope so get() can resolve request-scoped services\n    this.scopedContainer = this.container.beginRequest(this.requestId, {\n      testingModule: true,\n    })\n\n    return this\n  }\n\n  /**\n   * Gets the compiled application.\n   *\n   * @throws Error if the module has not been compiled yet\n   */\n  getApp(): NaviosApplication {\n    if (!this.app) {\n      throw new Error(\n        'TestingModule not compiled. Call compile() or init() first.',\n      )\n    }\n    return this.app\n  }\n\n  /**\n   * Gets the underlying TestContainer for direct manipulation.\n   */\n  getContainer(): TestContainer {\n    return this.container\n  }\n\n  /**\n   * Gets the scoped container for the current test request.\n   * Only available after calling `init()`.\n   *\n   * @throws Error if init() has not been called\n   */\n  getScopedContainer(): ScopedContainer {\n    if (!this.scopedContainer) {\n      throw new Error('No scoped container available. Call init() first.')\n    }\n    return this.scopedContainer\n  }\n\n  /**\n   * Override a provider with a mock value or class.\n   * Must be called before `compile()` or `init()`.\n   */\n  overrideProvider<T>(token: ClassType | InjectionToken<T, any>): {\n    useValue: (value: T) => TestingModule\n    useClass: (target: ClassType) => TestingModule\n  } {\n    return {\n      useValue: (value: T) => {\n        this.container.bind(token as any).toValue(value)\n        return this\n      },\n      useClass: (target: ClassType) => {\n        this.container.bind(token as any).toClass(target)\n        return this\n      },\n    }\n  }\n\n  /**\n   * Gets an instance from the container.\n   *\n   * If `init()` has been called, this uses the scoped container\n   * which properly resolves request-scoped services.\n   *\n   * If only `compile()` was called, this uses the root container\n   * and request-scoped services will throw.\n   */\n  async get<T>(\n    token: ClassTypeWithInstance<T> | InjectionToken<T, any>,\n  ): Promise<T> {\n    // Use scoped container if available (after init)\n    if (this.scopedContainer) {\n      return this.scopedContainer.get(token as any)\n    }\n    // Fall back to root container (after compile only)\n    return this.container.get(token as any)\n  }\n\n  /**\n   * Disposes the testing module and cleans up all resources.\n   *\n   * This will:\n   * 1. End the request scope (if started)\n   * 2. Close the application (if initialized)\n   * 3. Dispose the container\n   */\n  async close(): Promise<void> {\n    // End the request scope first\n    if (this.scopedContainer) {\n      await this.scopedContainer.endRequest()\n      this.scopedContainer = null\n    }\n\n    // Close the app\n    if (this.app) {\n      await this.app.close()\n      this.app = null\n    }\n\n    // Dispose the container\n    await this.container.dispose()\n  }\n\n  // ===========================================================================\n  // ASSERTION HELPERS (delegated to TestContainer)\n  // ===========================================================================\n\n  /**\n   * Asserts that a service has been resolved at least once.\n   */\n  expectResolved(token: ClassType | InjectionToken<any, any>): void {\n    this.container.expectResolved(token)\n  }\n\n  /**\n   * Asserts that a service has NOT been resolved.\n   */\n  expectNotResolved(token: ClassType | InjectionToken<any, any>): void {\n    this.container.expectNotResolved(token)\n  }\n\n  /**\n   * Asserts that a service is registered as singleton scope.\n   */\n  expectSingleton(token: ClassType | InjectionToken<any, any>): void {\n    this.container.expectSingleton(token)\n  }\n\n  /**\n   * Asserts that a service is registered as transient scope.\n   */\n  expectTransient(token: ClassType | InjectionToken<any, any>): void {\n    this.container.expectTransient(token)\n  }\n\n  /**\n   * Asserts that a service is registered as request scope.\n   */\n  expectRequestScoped(token: ClassType | InjectionToken<any, any>): void {\n    this.container.expectRequestScoped(token)\n  }\n\n  /**\n   * Asserts that a method was called on a service.\n   * Note: You must use `recordMethodCall()` in your mocks for this to work.\n   */\n  expectCalled(\n    token: ClassType | InjectionToken<any, any>,\n    method: string,\n  ): void {\n    this.container.expectCalled(token, method)\n  }\n\n  /**\n   * Asserts that a method was called with specific arguments.\n   * Note: You must use `recordMethodCall()` in your mocks for this to work.\n   */\n  expectCalledWith(\n    token: ClassType | InjectionToken<any, any>,\n    method: string,\n    expectedArgs: unknown[],\n  ): void {\n    this.container.expectCalledWith(token, method, expectedArgs)\n  }\n\n  /**\n   * Asserts that a method was called a specific number of times.\n   * Note: You must use `recordMethodCall()` in your mocks for this to work.\n   */\n  expectCallCount(\n    token: ClassType | InjectionToken<any, any>,\n    method: string,\n    count: number,\n  ): void {\n    this.container.expectCallCount(token, method, count)\n  }\n\n  /**\n   * Records a method call for tracking.\n   * Call this from your mock implementations to enable call assertions.\n   */\n  recordMethodCall(\n    token: ClassType | InjectionToken<any, any>,\n    method: string,\n    args: unknown[],\n    result?: unknown,\n    error?: Error,\n  ): void {\n    this.container.recordMethodCall(token, method, args, result, error)\n  }\n\n  /**\n   * Gets all recorded method calls for a service.\n   */\n  getMethodCalls(token: ClassType | InjectionToken<any, any>) {\n    return this.container.getMethodCalls(token)\n  }\n\n  /**\n   * Gets the dependency graph for debugging or snapshot testing.\n   */\n  getDependencyGraph() {\n    return this.container.getDependencyGraph()\n  }\n\n  /**\n   * Gets a simplified dependency graph showing only token relationships.\n   */\n  getSimplifiedDependencyGraph() {\n    return this.container.getSimplifiedDependencyGraph()\n  }\n}\n\n/**\n * Creates a testing module for the given app module.\n *\n * @deprecated Use `TestingModule.create()` instead.\n *\n * @example\n * ```typescript\n * // Old way (deprecated)\n * const module = createTestingModule(AppModule)\n *\n * // New way\n * const module = TestingModule.create(AppModule)\n * ```\n */\nexport function createTestingModule(\n  appModule: ClassTypeWithInstance<NaviosModule>,\n  options: TestingModuleOptions = { adapter: [] },\n): TestingModule {\n  return TestingModule.create(appModule, options)\n}\n","import type {\n  ClassType,\n  ClassTypeWithInstance,\n  InjectionToken,\n} from '@navios/di'\nimport type {\n  MethodCallRecord,\n  MockServiceStats,\n  ProviderConfig,\n} from '@navios/di/testing'\n\nimport { UnitTestContainer } from '@navios/di/testing'\n\n/**\n * Options for creating a UnitTestingModule.\n */\nexport interface UnitTestingModuleOptions {\n  /**\n   * List of providers to register. Only these services can be resolved.\n   */\n  providers: ProviderConfig[]\n\n  /**\n   * If true, unregistered dependencies will be auto-mocked instead of throwing.\n   * Default: false (throws on unregistered dependencies)\n   */\n  allowUnregistered?: boolean\n\n  /**\n   * Logger for debugging.\n   */\n  logger?: Console | null\n\n  /**\n   * Container to use for the testing module.\n   * If not provided, a new UnitTestContainer will be created.\n   */\n  container?: UnitTestContainer\n}\n\n/**\n * A lightweight testing module for isolated unit tests.\n *\n * Unlike `TestingModule`, this does NOT load Navios modules or create an application.\n * It uses `UnitTestContainer` which:\n * - Only allows explicitly provided services\n * - Automatically tracks all method calls via proxies\n * - Can auto-mock unregistered dependencies\n *\n * This is ideal for testing services in isolation without the overhead\n * of full module loading.\n *\n * @example\n * ```typescript\n * const module = UnitTestingModule.create({\n *   providers: [\n *     { token: UserService, useClass: UserService },\n *     { token: DatabaseService, useValue: mockDatabase },\n *   ],\n * })\n *\n * const userService = await module.get(UserService)\n * await userService.findUser('123')\n *\n * // Method calls are automatically tracked\n * module.expectCalled(UserService, 'findUser')\n * module.expectCalledWith(UserService, 'findUser', ['123'])\n *\n * await module.close()\n * ```\n */\nexport class UnitTestingModule {\n  private constructor(private readonly container: UnitTestContainer) {}\n\n  /**\n   * Creates a new UnitTestingModule with the given providers.\n   *\n   * @example\n   * ```typescript\n   * const module = UnitTestingModule.create({\n   *   providers: [\n   *     { token: UserService, useClass: UserService },\n   *     { token: ConfigToken, useValue: { apiUrl: 'test' } },\n   *   ],\n   * })\n   * ```\n   */\n  static create(options: UnitTestingModuleOptions): UnitTestingModule {\n    const container =\n      options.container ??\n      new UnitTestContainer({\n        providers: options.providers,\n        allowUnregistered: options.allowUnregistered,\n        logger: options.logger,\n      })\n\n    return new UnitTestingModule(container)\n  }\n\n  /**\n   * Gets the underlying UnitTestContainer for direct manipulation.\n   */\n  getContainer(): UnitTestContainer {\n    return this.container\n  }\n\n  /**\n   * Gets an instance from the container.\n   *\n   * All resolved instances are wrapped in tracking proxies,\n   * so method calls are automatically recorded.\n   *\n   * @throws Error if the token is not in the providers list\n   *         and `allowUnregistered` is false\n   */\n  async get<T>(\n    token: ClassTypeWithInstance<T> | InjectionToken<T, any>,\n  ): Promise<T> {\n    return this.container.get(token as any)\n  }\n\n  /**\n   * Disposes the module and cleans up all resources.\n   */\n  async close(): Promise<void> {\n    await this.container.clear()\n  }\n\n  /**\n   * Enables auto-mocking for unregistered dependencies.\n   * Unregistered services will return a proxy that throws on method access.\n   */\n  enableAutoMocking(): this {\n    this.container.enableAutoMocking()\n    return this\n  }\n\n  /**\n   * Disables auto-mocking (strict mode).\n   * Unregistered dependencies will throw immediately on resolution.\n   */\n  disableAutoMocking(): this {\n    this.container.disableAutoMocking()\n    return this\n  }\n\n  // ===========================================================================\n  // ASSERTION HELPERS (delegated to UnitTestContainer)\n  // ===========================================================================\n\n  /**\n   * Asserts that a service has been resolved at least once.\n   */\n  expectResolved(token: ClassType | InjectionToken<any, any>): void {\n    this.container.expectResolved(token)\n  }\n\n  /**\n   * Asserts that a service has NOT been resolved.\n   */\n  expectNotResolved(token: ClassType | InjectionToken<any, any>): void {\n    this.container.expectNotResolved(token)\n  }\n\n  /**\n   * Asserts that a service was auto-mocked (not in providers list).\n   */\n  expectAutoMocked(token: ClassType | InjectionToken<any, any>): void {\n    this.container.expectAutoMocked(token)\n  }\n\n  /**\n   * Asserts that a service was NOT auto-mocked (is in providers list).\n   */\n  expectNotAutoMocked(token: ClassType | InjectionToken<any, any>): void {\n    this.container.expectNotAutoMocked(token)\n  }\n\n  /**\n   * Asserts that a method was called on a service.\n   * Method calls are automatically tracked via proxy.\n   */\n  expectCalled(\n    token: ClassType | InjectionToken<any, any>,\n    method: string,\n  ): void {\n    this.container.expectCalled(token, method)\n  }\n\n  /**\n   * Asserts that a method was NOT called on a service.\n   */\n  expectNotCalled(\n    token: ClassType | InjectionToken<any, any>,\n    method: string,\n  ): void {\n    this.container.expectNotCalled(token, method)\n  }\n\n  /**\n   * Asserts that a method was called with specific arguments.\n   */\n  expectCalledWith(\n    token: ClassType | InjectionToken<any, any>,\n    method: string,\n    expectedArgs: unknown[],\n  ): void {\n    this.container.expectCalledWith(token, method, expectedArgs)\n  }\n\n  /**\n   * Asserts that a method was called a specific number of times.\n   */\n  expectCallCount(\n    token: ClassType | InjectionToken<any, any>,\n    method: string,\n    count: number,\n  ): void {\n    this.container.expectCallCount(token, method, count)\n  }\n\n  /**\n   * Gets all recorded method calls for a service.\n   */\n  getMethodCalls(\n    token: ClassType | InjectionToken<any, any>,\n  ): MethodCallRecord[] {\n    return this.container.getMethodCalls(token)\n  }\n\n  /**\n   * Gets statistics about a service (instance count, method calls, lifecycle events).\n   */\n  getServiceStats(\n    token: ClassType | InjectionToken<any, any>,\n  ): MockServiceStats {\n    return this.container.getServiceStats(token)\n  }\n\n  /**\n   * Clears all recorded method calls.\n   * Useful for resetting state between test assertions.\n   */\n  clearMethodCalls(): void {\n    this.container.clearMethodCalls()\n  }\n\n  /**\n   * Gets list of all registered provider token IDs.\n   */\n  getRegisteredTokenIds(): ReadonlySet<string> {\n    return this.container.getRegisteredTokenIds()\n  }\n\n  /**\n   * Gets list of all auto-mocked token IDs.\n   */\n  getAutoMockedTokenIds(): ReadonlySet<string> {\n    return this.container.getAutoMockedTokenIds()\n  }\n\n  // ===========================================================================\n  // LIFECYCLE ASSERTIONS\n  // ===========================================================================\n\n  /**\n   * Asserts that a service's onServiceInit was called.\n   */\n  expectInitialized(token: ClassType | InjectionToken<any, any>): void {\n    this.container.expectInitialized(token)\n  }\n\n  /**\n   * Asserts that a service's onServiceDestroy was called.\n   */\n  expectDestroyed(token: ClassType | InjectionToken<any, any>): void {\n    this.container.expectDestroyed(token)\n  }\n\n  /**\n   * Asserts that a service has NOT been destroyed.\n   */\n  expectNotDestroyed(token: ClassType | InjectionToken<any, any>): void {\n    this.container.expectNotDestroyed(token)\n  }\n\n  /**\n   * Records a lifecycle event for tracking.\n   * Call this from your mock implementations if needed.\n   */\n  recordLifecycleEvent(\n    token: ClassType | InjectionToken<any, any>,\n    event: 'created' | 'initialized' | 'destroyed',\n    instanceName: string,\n  ): void {\n    this.container.recordLifecycleEvent(token, event, instanceName)\n  }\n}\n"],"mappings":"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"}

package/lib/{use-guards.decorator-COR-9mZY.cjs → use-guards.decorator-Bs8oDHOi.cjs}

@@ -1,4 +1,4 @@
-const require_src = require('./src-B6eISODM.cjs');
+const require_src = require('./src-BRPtJ9fG.cjs');
 let _navios_di = require("@navios/di");
 
 //#region src/metadata/handler.metadata.mts
@@ -120,7 +120,7 @@ function hasModuleMetadata(target) {
 *   }
 * }
 * ```
-*/ function Controller({ guards, registry } = {}) {
+*/ function Controller({ guards, registry, priority, scope } = {}) {
 	return function(target, context) {
 		if (context.kind !== "class") throw new Error("[Navios] @Controller decorator can only be used on classes.");
 		const token = _navios_di.InjectionToken.create(target);
@@ -130,7 +130,9 @@ function hasModuleMetadata(target) {
 		}
 		return (0, _navios_di.Injectable)({
 			token,
-			registry
+			registry,
+			priority,
+			scope
 		})(target, context);
 	};
 }
@@ -254,13 +256,13 @@ function Endpoint(endpoint) {
 //#region src/decorators/module.decorator.mts
 /**
 * Decorator that marks a class as a Navios module.
-* 
+*
 * Modules are the basic building blocks of a Navios application.
 * They organize controllers, services, and other modules into logical units.
-* 
+*
 * @param options - Module configuration options
 * @returns A class decorator
-* 
+*
 * @example
 * ```typescript
 * @Module({
@@ -270,7 +272,7 @@ function Endpoint(endpoint) {
 * })
 * export class AppModule {}
 * ```
-*/ function Module({ controllers = [], imports = [], guards = [] } = {
+*/ function Module({ controllers = [], imports = [], guards = [], priority, registry } = {
 	controllers: [],
 	imports: [],
 	guards: []
@@ -284,7 +286,9 @@ function Endpoint(endpoint) {
 		for (const guard of Array.from(guards).reverse()) moduleMetadata.guards.add(guard);
 		return (0, _navios_di.Injectable)({
 			token,
-			scope: _navios_di.InjectableScope.Singleton
+			scope: _navios_di.InjectableScope.Singleton,
+			priority,
+			registry
 		})(target, context);
 	};
 }
@@ -545,4 +549,4 @@ Object.defineProperty(exports, 'hasModuleMetadata', {
     return hasModuleMetadata;
   }
 });
-//# sourceMappingURL=use-guards.decorator-COR-9mZY.cjs.map
+//# sourceMappingURL=use-guards.decorator-Bs8oDHOi.cjs.map