@geekmidas/services 0.1.0 → 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,13 @@
+# @geekmidas/services
+
+## 1.0.0
+
+### Major Changes
+
+- [`ff7b115`](https://github.com/geekmidas/toolbox/commit/ff7b11599f60f84ac6cdc73714c853ecf786b2e8) Thanks [@geekmidas](https://github.com/geekmidas)! - Version 1 Stable release
+
+### Patch Changes
+
+- Updated dependencies [[`ff7b115`](https://github.com/geekmidas/toolbox/commit/ff7b11599f60f84ac6cdc73714c853ecf786b2e8)]:
+  - @geekmidas/envkit@1.0.0
+  - @geekmidas/logger@1.0.0

package/dist/ServiceDiscovery-BO2FzEGt.cjs

@@ -0,0 +1,200 @@
+const require_context = require('./context-DUTDtYd2.cjs');
+
+//#region src/ServiceDiscovery.ts
+/**
+* Service discovery container that manages service registration and retrieval.
+* Implements a singleton pattern with lazy initialization of services.
+*
+* @template TServices - Record type mapping service names to their instance types
+*
+* @example
+* ```typescript
+* // Define service types
+* interface MyServices {
+*   database: Database;
+*   cache: CacheService;
+*   auth: AuthService;
+* }
+*
+* // Get service discovery instance
+* const discovery = ServiceDiscovery.getInstance<MyServices>(envParser);
+*
+* // Register services
+* await discovery.register([
+*   databaseService,
+*   cacheService,
+*   authService
+* ]);
+*
+* // Retrieve services
+* const db = await discovery.get('database');
+* const { cache, auth } = await discovery.getMany(['cache', 'auth']);
+* ```
+*/
+var ServiceDiscovery = class ServiceDiscovery {
+	/** Singleton instance of ServiceDiscovery */
+	static _instance;
+	/** Map of registered service definitions */
+	services = /* @__PURE__ */ new Map();
+	/** Map of instantiated service instances */
+	instances = /* @__PURE__ */ new Map();
+	/**
+	* Gets the singleton instance of ServiceDiscovery.
+	* Creates a new instance if one doesn't exist.
+	*
+	* @template T - Record type mapping service names to their instance types
+	* @param envParser - Environment parser for service configuration
+	* @returns The ServiceDiscovery singleton instance
+	*
+	* @example
+	* ```typescript
+	* const services = ServiceDiscovery.getInstance<MyServices>(envParser);
+	* ```
+	*/
+	static getInstance(envParser) {
+		if (!ServiceDiscovery._instance) ServiceDiscovery._instance = new ServiceDiscovery(envParser);
+		return ServiceDiscovery._instance;
+	}
+	/**
+	* Resets the singleton instance. Use only for testing purposes.
+	* This clears all cached services and allows a fresh instance to be created.
+	*
+	* @example
+	* ```typescript
+	* // In test teardown
+	* afterEach(() => {
+	*   ServiceDiscovery.reset();
+	* });
+	* ```
+	*/
+	static reset() {
+		ServiceDiscovery._instance = void 0;
+	}
+	/**
+	* Private constructor to enforce singleton pattern.
+	*
+	* @param envParser - Environment parser for service configuration
+	* @private
+	*/
+	constructor(envParser) {
+		this.envParser = envParser;
+	}
+	/**
+	* Register multiple services with the service discovery.
+	* Services are instantiated lazily on first access.
+	* Already instantiated services are returned from cache.
+	*
+	* @template T - Array type of services to register
+	* @param services - Array of services to register
+	* @returns Promise resolving to a record of service names to instances
+	*
+	* @example
+	* ```typescript
+	* const services = await discovery.register([
+	*   databaseService,
+	*   cacheService,
+	*   authService
+	* ]);
+	*
+	* // services = {
+	* //   database: Database instance,
+	* //   cache: CacheService instance,
+	* //   auth: AuthService instance
+	* // }
+	* ```
+	*/
+	async register(services) {
+		const registeredServices = {};
+		for (const service of services) {
+			const name = service.serviceName;
+			if (this.instances.has(name)) {
+				registeredServices[name] = this.instances.get(name);
+				continue;
+			}
+			const instance = await service.register({
+				envParser: this.envParser,
+				context: require_context.serviceContext
+			});
+			this.instances.set(name, instance);
+			registeredServices[name] = instance;
+		}
+		return registeredServices;
+	}
+	/**
+	* Get a service from the service discovery.
+	* Services are instantiated on first access if not already cached.
+	*
+	* @template K - The service name key
+	* @param name - The name of the service to get
+	* @returns Promise resolving to the service instance
+	* @throws {Error} If the service is not registered
+	*
+	* @example
+	* ```typescript
+	* const database = await discovery.get('database');
+	* const users = await database.query('SELECT * FROM users');
+	* ```
+	*/
+	get(name) {
+		const service = this.services.get(name);
+		if (!service) throw new Error(`Service '${name}' not found in service discovery`);
+		return service.register({
+			envParser: this.envParser,
+			context: require_context.serviceContext
+		});
+	}
+	/**
+	* Get multiple services from the service discovery.
+	* Useful for retrieving multiple dependencies at once.
+	*
+	* @template K - Array of service name keys
+	* @param names - Array of service names to retrieve
+	* @returns Promise resolving to an object containing the service instances
+	*
+	* @example
+	* ```typescript
+	* const { database, cache, auth } = await discovery.getMany([
+	*   'database',
+	*   'cache',
+	*   'auth'
+	* ]);
+	* ```
+	*/
+	async getMany(names) {
+		const result = {};
+		for (const name of names) result[name] = await this.get(name);
+		return result;
+	}
+	/**
+	* Check if a service exists in the service discovery.
+	* Can check by service name or service instance.
+	*
+	* @param service - The service name or service instance to check
+	* @returns True if the service exists, false otherwise
+	*
+	* @example
+	* ```typescript
+	* if (discovery.has('database')) {
+	*   const db = await discovery.get('database');
+	* }
+	*
+	* // Or check with service instance
+	* if (!discovery.has(databaseService)) {
+	*   await discovery.register([databaseService]);
+	* }
+	* ```
+	*/
+	has(service) {
+		if (typeof service === "string") return this.services.has(service);
+		return this.services.has(service.serviceName);
+	}
+};
+
+//#endregion
+Object.defineProperty(exports, 'ServiceDiscovery', {
+  enumerable: true,
+  get: function () {
+    return ServiceDiscovery;
+  }
+});
+//# sourceMappingURL=ServiceDiscovery-BO2FzEGt.cjs.map

package/dist/ServiceDiscovery-BO2FzEGt.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceDiscovery-BO2FzEGt.cjs","names":["envParser: EnvironmentParser<{}>","services: T","serviceContext","name: K","names: [...K]","service: string | Service"],"sources":["../src/ServiceDiscovery.ts"],"sourcesContent":["import type { EnvironmentParser } from '@geekmidas/envkit';\nimport { serviceContext } from './context';\nimport type { Service } from './types';\n\n/**\n * Service discovery container that manages service registration and retrieval.\n * Implements a singleton pattern with lazy initialization of services.\n *\n * @template TServices - Record type mapping service names to their instance types\n *\n * @example\n * ```typescript\n * // Define service types\n * interface MyServices {\n *   database: Database;\n *   cache: CacheService;\n *   auth: AuthService;\n * }\n *\n * // Get service discovery instance\n * const discovery = ServiceDiscovery.getInstance<MyServices>(envParser);\n *\n * // Register services\n * await discovery.register([\n *   databaseService,\n *   cacheService,\n *   authService\n * ]);\n *\n * // Retrieve services\n * const db = await discovery.get('database');\n * const { cache, auth } = await discovery.getMany(['cache', 'auth']);\n * ```\n */\nexport class ServiceDiscovery<TServices extends Record<string, unknown> = {}> {\n\t/** Singleton instance of ServiceDiscovery */\n\tprivate static _instance: ServiceDiscovery<any>;\n\t/** Map of registered service definitions */\n\tprivate services = new Map<string, Service>();\n\t/** Map of instantiated service instances */\n\tprivate instances = new Map<keyof TServices, TServices[keyof TServices]>();\n\n\t/**\n\t * Gets the singleton instance of ServiceDiscovery.\n\t * Creates a new instance if one doesn't exist.\n\t *\n\t * @template T - Record type mapping service names to their instance types\n\t * @param envParser - Environment parser for service configuration\n\t * @returns The ServiceDiscovery singleton instance\n\t *\n\t * @example\n\t * ```typescript\n\t * const services = ServiceDiscovery.getInstance<MyServices>(envParser);\n\t * ```\n\t */\n\tstatic getInstance<T extends Record<any, unknown> = any>(\n\t\tenvParser: EnvironmentParser<{}>,\n\t): ServiceDiscovery<T> {\n\t\tif (!ServiceDiscovery._instance) {\n\t\t\tServiceDiscovery._instance = new ServiceDiscovery<T>(envParser);\n\t\t}\n\t\treturn ServiceDiscovery._instance as ServiceDiscovery<T>;\n\t}\n\n\t/**\n\t * Resets the singleton instance. Use only for testing purposes.\n\t * This clears all cached services and allows a fresh instance to be created.\n\t *\n\t * @example\n\t * ```typescript\n\t * // In test teardown\n\t * afterEach(() => {\n\t *   ServiceDiscovery.reset();\n\t * });\n\t * ```\n\t */\n\tstatic reset(): void {\n\t\tServiceDiscovery._instance = undefined as any;\n\t}\n\n\t/**\n\t * Private constructor to enforce singleton pattern.\n\t *\n\t * @param envParser - Environment parser for service configuration\n\t * @private\n\t */\n\tprivate constructor(readonly envParser: EnvironmentParser<{}>) {}\n\n\t/**\n\t * Register multiple services with the service discovery.\n\t * Services are instantiated lazily on first access.\n\t * Already instantiated services are returned from cache.\n\t *\n\t * @template T - Array type of services to register\n\t * @param services - Array of services to register\n\t * @returns Promise resolving to a record of service names to instances\n\t *\n\t * @example\n\t * ```typescript\n\t * const services = await discovery.register([\n\t *   databaseService,\n\t *   cacheService,\n\t *   authService\n\t * ]);\n\t *\n\t * // services = {\n\t * //   database: Database instance,\n\t * //   cache: CacheService instance,\n\t * //   auth: AuthService instance\n\t * // }\n\t * ```\n\t */\n\tasync register<T extends Service[]>(services: T): Promise<ServiceRecord<T>> {\n\t\tconst registeredServices = {} as ServiceRecord<T>;\n\t\tfor (const service of services) {\n\t\t\tconst name = service.serviceName as T[number]['serviceName'];\n\t\t\tif (this.instances.has(name)) {\n\t\t\t\t(registeredServices as any)[name] = this.instances.get(\n\t\t\t\t\tname,\n\t\t\t\t) as TServices[keyof TServices];\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\t// Pass both envParser and context to service\n\t\t\tconst instance = await service.register({\n\t\t\t\tenvParser: this.envParser,\n\t\t\t\tcontext: serviceContext,\n\t\t\t});\n\n\t\t\tthis.instances.set(name, instance as TServices[keyof TServices]);\n\t\t\t(registeredServices as any)[name] =\n\t\t\t\tinstance as TServices[keyof TServices];\n\t\t}\n\n\t\treturn registeredServices;\n\t}\n\n\t/**\n\t * Get a service from the service discovery.\n\t * Services are instantiated on first access if not already cached.\n\t *\n\t * @template K - The service name key\n\t * @param name - The name of the service to get\n\t * @returns Promise resolving to the service instance\n\t * @throws {Error} If the service is not registered\n\t *\n\t * @example\n\t * ```typescript\n\t * const database = await discovery.get('database');\n\t * const users = await database.query('SELECT * FROM users');\n\t * ```\n\t */\n\tget<K extends keyof TServices & string>(name: K): Promise<TServices[K]> {\n\t\tconst service = this.services.get(name);\n\n\t\tif (!service) {\n\t\t\tthrow new Error(`Service '${name}' not found in service discovery`);\n\t\t}\n\n\t\treturn service.register({\n\t\t\tenvParser: this.envParser,\n\t\t\tcontext: serviceContext,\n\t\t}) as Promise<TServices[K]>;\n\t}\n\t/**\n\t * Get multiple services from the service discovery.\n\t * Useful for retrieving multiple dependencies at once.\n\t *\n\t * @template K - Array of service name keys\n\t * @param names - Array of service names to retrieve\n\t * @returns Promise resolving to an object containing the service instances\n\t *\n\t * @example\n\t * ```typescript\n\t * const { database, cache, auth } = await discovery.getMany([\n\t *   'database',\n\t *   'cache',\n\t *   'auth'\n\t * ]);\n\t * ```\n\t */\n\tasync getMany<K extends (keyof TServices & string)[]>(\n\t\tnames: [...K],\n\t): Promise<{ [P in K[number]]: TServices[P] }> {\n\t\tconst result = {} as { [P in K[number]]: TServices[P] };\n\n\t\tfor (const name of names) {\n\t\t\tresult[name] = await this.get(name);\n\t\t}\n\n\t\treturn result;\n\t}\n\n\t/**\n\t * Check if a service exists in the service discovery.\n\t * Can check by service name or service instance.\n\t *\n\t * @param service - The service name or service instance to check\n\t * @returns True if the service exists, false otherwise\n\t *\n\t * @example\n\t * ```typescript\n\t * if (discovery.has('database')) {\n\t *   const db = await discovery.get('database');\n\t * }\n\t *\n\t * // Or check with service instance\n\t * if (!discovery.has(databaseService)) {\n\t *   await discovery.register([databaseService]);\n\t * }\n\t * ```\n\t */\n\thas(service: string | Service): boolean {\n\t\tif (typeof service === 'string') {\n\t\t\treturn this.services.has(service);\n\t\t}\n\n\t\treturn this.services.has(service.serviceName);\n\t}\n}\n\n/**\n * Utility type to extract service names from an array of services.\n *\n * @template T - Array of Service types\n *\n * @example\n * ```typescript\n * type Names = ExtractServiceNames<[typeof databaseService, typeof cacheService]>;\n * // type Names = 'database' | 'cache'\n * ```\n */\nexport type ExtractServiceNames<T extends Service[]> = T[number]['serviceName'];\n\n/**\n * Utility type to create a record type from an array of services.\n * Maps service names to their registered instance types.\n *\n * @template T - Array of Service types\n *\n * @example\n * ```typescript\n * type MyServiceRecord = ServiceRecord<[typeof databaseService, typeof cacheService]>;\n * // type MyServiceRecord = {\n * //   database: DatabaseInstance;\n * //   cache: CacheInstance;\n * // }\n * ```\n */\nexport type ServiceRecord<T extends Service[]> = {\n\t[K in T[number] as K['serviceName']]: K extends Service\n\t\t? Awaited<ReturnType<K['register']>>\n\t\t: never;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCA,IAAa,mBAAb,MAAa,iBAAiE;;CAE7E,OAAe;;CAEf,AAAQ,2BAAW,IAAI;;CAEvB,AAAQ,4BAAY,IAAI;;;;;;;;;;;;;;CAexB,OAAO,YACNA,WACsB;AACtB,OAAK,iBAAiB,UACrB,kBAAiB,YAAY,IAAI,iBAAoB;AAEtD,SAAO,iBAAiB;CACxB;;;;;;;;;;;;;CAcD,OAAO,QAAc;AACpB,mBAAiB;CACjB;;;;;;;CAQD,AAAQ,YAAqBA,WAAkC;EAAlC;CAAoC;;;;;;;;;;;;;;;;;;;;;;;;;CA0BjE,MAAM,SAA8BC,UAAwC;EAC3E,MAAM,qBAAqB,CAAE;AAC7B,OAAK,MAAM,WAAW,UAAU;GAC/B,MAAM,OAAO,QAAQ;AACrB,OAAI,KAAK,UAAU,IAAI,KAAK,EAAE;AAC7B,IAAC,mBAA2B,QAAQ,KAAK,UAAU,IAClD,KACA;AACD;GACA;GAGD,MAAM,WAAW,MAAM,QAAQ,SAAS;IACvC,WAAW,KAAK;IAChB,SAASC;GACT,EAAC;AAEF,QAAK,UAAU,IAAI,MAAM,SAAuC;AAChE,GAAC,mBAA2B,QAC3B;EACD;AAED,SAAO;CACP;;;;;;;;;;;;;;;;CAiBD,IAAwCC,MAAgC;EACvE,MAAM,UAAU,KAAK,SAAS,IAAI,KAAK;AAEvC,OAAK,QACJ,OAAM,IAAI,OAAO,WAAW,KAAK;AAGlC,SAAO,QAAQ,SAAS;GACvB,WAAW,KAAK;GAChB,SAASD;EACT,EAAC;CACF;;;;;;;;;;;;;;;;;;CAkBD,MAAM,QACLE,OAC8C;EAC9C,MAAM,SAAS,CAAE;AAEjB,OAAK,MAAM,QAAQ,MAClB,QAAO,QAAQ,MAAM,KAAK,IAAI,KAAK;AAGpC,SAAO;CACP;;;;;;;;;;;;;;;;;;;;CAqBD,IAAIC,SAAoC;AACvC,aAAW,YAAY,SACtB,QAAO,KAAK,SAAS,IAAI,QAAQ;AAGlC,SAAO,KAAK,SAAS,IAAI,QAAQ,YAAY;CAC7C;AACD"}

package/dist/ServiceDiscovery-CfVBrQHt.d.cts

@@ -0,0 +1,189 @@
+import { Service } from "./types-D7d_yeU5.cjs";
+import { EnvironmentParser } from "@geekmidas/envkit";
+
+//#region src/ServiceDiscovery.d.ts
+
+/**
+ * Service discovery container that manages service registration and retrieval.
+ * Implements a singleton pattern with lazy initialization of services.
+ *
+ * @template TServices - Record type mapping service names to their instance types
+ *
+ * @example
+ * ```typescript
+ * // Define service types
+ * interface MyServices {
+ *   database: Database;
+ *   cache: CacheService;
+ *   auth: AuthService;
+ * }
+ *
+ * // Get service discovery instance
+ * const discovery = ServiceDiscovery.getInstance<MyServices>(envParser);
+ *
+ * // Register services
+ * await discovery.register([
+ *   databaseService,
+ *   cacheService,
+ *   authService
+ * ]);
+ *
+ * // Retrieve services
+ * const db = await discovery.get('database');
+ * const { cache, auth } = await discovery.getMany(['cache', 'auth']);
+ * ```
+ */
+declare class ServiceDiscovery<TServices extends Record<string, unknown> = {}> {
+  readonly envParser: EnvironmentParser<{}>;
+  /** Singleton instance of ServiceDiscovery */
+  private static _instance;
+  /** Map of registered service definitions */
+  private services;
+  /** Map of instantiated service instances */
+  private instances;
+  /**
+   * Gets the singleton instance of ServiceDiscovery.
+   * Creates a new instance if one doesn't exist.
+   *
+   * @template T - Record type mapping service names to their instance types
+   * @param envParser - Environment parser for service configuration
+   * @returns The ServiceDiscovery singleton instance
+   *
+   * @example
+   * ```typescript
+   * const services = ServiceDiscovery.getInstance<MyServices>(envParser);
+   * ```
+   */
+  static getInstance<T extends Record<any, unknown> = any>(envParser: EnvironmentParser<{}>): ServiceDiscovery<T>;
+  /**
+   * Resets the singleton instance. Use only for testing purposes.
+   * This clears all cached services and allows a fresh instance to be created.
+   *
+   * @example
+   * ```typescript
+   * // In test teardown
+   * afterEach(() => {
+   *   ServiceDiscovery.reset();
+   * });
+   * ```
+   */
+  static reset(): void;
+  /**
+   * Private constructor to enforce singleton pattern.
+   *
+   * @param envParser - Environment parser for service configuration
+   * @private
+   */
+  private constructor();
+  /**
+   * Register multiple services with the service discovery.
+   * Services are instantiated lazily on first access.
+   * Already instantiated services are returned from cache.
+   *
+   * @template T - Array type of services to register
+   * @param services - Array of services to register
+   * @returns Promise resolving to a record of service names to instances
+   *
+   * @example
+   * ```typescript
+   * const services = await discovery.register([
+   *   databaseService,
+   *   cacheService,
+   *   authService
+   * ]);
+   *
+   * // services = {
+   * //   database: Database instance,
+   * //   cache: CacheService instance,
+   * //   auth: AuthService instance
+   * // }
+   * ```
+   */
+  register<T extends Service[]>(services: T): Promise<ServiceRecord<T>>;
+  /**
+   * Get a service from the service discovery.
+   * Services are instantiated on first access if not already cached.
+   *
+   * @template K - The service name key
+   * @param name - The name of the service to get
+   * @returns Promise resolving to the service instance
+   * @throws {Error} If the service is not registered
+   *
+   * @example
+   * ```typescript
+   * const database = await discovery.get('database');
+   * const users = await database.query('SELECT * FROM users');
+   * ```
+   */
+  get<K extends keyof TServices & string>(name: K): Promise<TServices[K]>;
+  /**
+   * Get multiple services from the service discovery.
+   * Useful for retrieving multiple dependencies at once.
+   *
+   * @template K - Array of service name keys
+   * @param names - Array of service names to retrieve
+   * @returns Promise resolving to an object containing the service instances
+   *
+   * @example
+   * ```typescript
+   * const { database, cache, auth } = await discovery.getMany([
+   *   'database',
+   *   'cache',
+   *   'auth'
+   * ]);
+   * ```
+   */
+  getMany<K extends (keyof TServices & string)[]>(names: [...K]): Promise<{ [P in K[number]]: TServices[P] }>;
+  /**
+   * Check if a service exists in the service discovery.
+   * Can check by service name or service instance.
+   *
+   * @param service - The service name or service instance to check
+   * @returns True if the service exists, false otherwise
+   *
+   * @example
+   * ```typescript
+   * if (discovery.has('database')) {
+   *   const db = await discovery.get('database');
+   * }
+   *
+   * // Or check with service instance
+   * if (!discovery.has(databaseService)) {
+   *   await discovery.register([databaseService]);
+   * }
+   * ```
+   */
+  has(service: string | Service): boolean;
+}
+/**
+ * Utility type to extract service names from an array of services.
+ *
+ * @template T - Array of Service types
+ *
+ * @example
+ * ```typescript
+ * type Names = ExtractServiceNames<[typeof databaseService, typeof cacheService]>;
+ * // type Names = 'database' | 'cache'
+ * ```
+ */
+type ExtractServiceNames<T extends Service[]> = T[number]['serviceName'];
+/**
+ * Utility type to create a record type from an array of services.
+ * Maps service names to their registered instance types.
+ *
+ * @template T - Array of Service types
+ *
+ * @example
+ * ```typescript
+ * type MyServiceRecord = ServiceRecord<[typeof databaseService, typeof cacheService]>;
+ * // type MyServiceRecord = {
+ * //   database: DatabaseInstance;
+ * //   cache: CacheInstance;
+ * // }
+ * ```
+ */
+type ServiceRecord<T extends Service[]> = { [K in T[number] as K['serviceName']]: K extends Service ? Awaited<ReturnType<K['register']>> : never };
+//# sourceMappingURL=ServiceDiscovery.d.ts.map
+//#endregion
+export { ExtractServiceNames, ServiceDiscovery, ServiceRecord };
+//# sourceMappingURL=ServiceDiscovery-CfVBrQHt.d.cts.map

package/dist/ServiceDiscovery-CfVBrQHt.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceDiscovery-CfVBrQHt.d.cts","names":[],"sources":["../src/ServiceDiscovery.ts"],"sourcesContent":[],"mappings":";;;;;;;AAkCA;;;;;;;;;;;;;;;;;;;;;;;;;AAkL8B;AAoB9B;;AAA0C,cAtM7B,gBAsM6B,CAAA,kBAtMM,MAsMN,CAAA,MAAA,EAAA,OAAA,CAAA,GAAA,CAAA,CAAA,CAAA,CAAA;EAAO,SAAM,SAAA,EAlJd,iBAkJc,CAAA,CAAA,CAAA,CAAA;EAAC;EAiB5C,eAAA,SAAa;EAAA;EAAA,QAAW,QAAA;EAAO;EACnC,QAAY,SAAA;EAAC;;;;;AACV;;;;;;;;+BApMmB,uCACjB,wBACT,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAuDK,qBAAqB,IAAI,QAAQ,cAAc;;;;;;;;;;;;;;;;sBAwCpD,0BAA0B,IAAI,QAAQ,UAAU;;;;;;;;;;;;;;;;;;2BA6BrC,kCACnB,KACT,gBAAgB,YAAY,UAAU;;;;;;;;;;;;;;;;;;;;wBA6BnB;;;;;;;;;;;;;KAoBX,8BAA8B,aAAa;;;;;;;;;;;;;;;;KAiB3C,wBAAwB,qBAC7B,aAAa,mBAAmB,UAAU,UAC7C,QAAQ,WAAW"}

package/dist/ServiceDiscovery-DLMyH_yM.mjs

@@ -0,0 +1,195 @@
+import { serviceContext } from "./context-B5YTspJR.mjs";
+
+//#region src/ServiceDiscovery.ts
+/**
+* Service discovery container that manages service registration and retrieval.
+* Implements a singleton pattern with lazy initialization of services.
+*
+* @template TServices - Record type mapping service names to their instance types
+*
+* @example
+* ```typescript
+* // Define service types
+* interface MyServices {
+*   database: Database;
+*   cache: CacheService;
+*   auth: AuthService;
+* }
+*
+* // Get service discovery instance
+* const discovery = ServiceDiscovery.getInstance<MyServices>(envParser);
+*
+* // Register services
+* await discovery.register([
+*   databaseService,
+*   cacheService,
+*   authService
+* ]);
+*
+* // Retrieve services
+* const db = await discovery.get('database');
+* const { cache, auth } = await discovery.getMany(['cache', 'auth']);
+* ```
+*/
+var ServiceDiscovery = class ServiceDiscovery {
+	/** Singleton instance of ServiceDiscovery */
+	static _instance;
+	/** Map of registered service definitions */
+	services = /* @__PURE__ */ new Map();
+	/** Map of instantiated service instances */
+	instances = /* @__PURE__ */ new Map();
+	/**
+	* Gets the singleton instance of ServiceDiscovery.
+	* Creates a new instance if one doesn't exist.
+	*
+	* @template T - Record type mapping service names to their instance types
+	* @param envParser - Environment parser for service configuration
+	* @returns The ServiceDiscovery singleton instance
+	*
+	* @example
+	* ```typescript
+	* const services = ServiceDiscovery.getInstance<MyServices>(envParser);
+	* ```
+	*/
+	static getInstance(envParser) {
+		if (!ServiceDiscovery._instance) ServiceDiscovery._instance = new ServiceDiscovery(envParser);
+		return ServiceDiscovery._instance;
+	}
+	/**
+	* Resets the singleton instance. Use only for testing purposes.
+	* This clears all cached services and allows a fresh instance to be created.
+	*
+	* @example
+	* ```typescript
+	* // In test teardown
+	* afterEach(() => {
+	*   ServiceDiscovery.reset();
+	* });
+	* ```
+	*/
+	static reset() {
+		ServiceDiscovery._instance = void 0;
+	}
+	/**
+	* Private constructor to enforce singleton pattern.
+	*
+	* @param envParser - Environment parser for service configuration
+	* @private
+	*/
+	constructor(envParser) {
+		this.envParser = envParser;
+	}
+	/**
+	* Register multiple services with the service discovery.
+	* Services are instantiated lazily on first access.
+	* Already instantiated services are returned from cache.
+	*
+	* @template T - Array type of services to register
+	* @param services - Array of services to register
+	* @returns Promise resolving to a record of service names to instances
+	*
+	* @example
+	* ```typescript
+	* const services = await discovery.register([
+	*   databaseService,
+	*   cacheService,
+	*   authService
+	* ]);
+	*
+	* // services = {
+	* //   database: Database instance,
+	* //   cache: CacheService instance,
+	* //   auth: AuthService instance
+	* // }
+	* ```
+	*/
+	async register(services) {
+		const registeredServices = {};
+		for (const service of services) {
+			const name = service.serviceName;
+			if (this.instances.has(name)) {
+				registeredServices[name] = this.instances.get(name);
+				continue;
+			}
+			const instance = await service.register({
+				envParser: this.envParser,
+				context: serviceContext
+			});
+			this.instances.set(name, instance);
+			registeredServices[name] = instance;
+		}
+		return registeredServices;
+	}
+	/**
+	* Get a service from the service discovery.
+	* Services are instantiated on first access if not already cached.
+	*
+	* @template K - The service name key
+	* @param name - The name of the service to get
+	* @returns Promise resolving to the service instance
+	* @throws {Error} If the service is not registered
+	*
+	* @example
+	* ```typescript
+	* const database = await discovery.get('database');
+	* const users = await database.query('SELECT * FROM users');
+	* ```
+	*/
+	get(name) {
+		const service = this.services.get(name);
+		if (!service) throw new Error(`Service '${name}' not found in service discovery`);
+		return service.register({
+			envParser: this.envParser,
+			context: serviceContext
+		});
+	}
+	/**
+	* Get multiple services from the service discovery.
+	* Useful for retrieving multiple dependencies at once.
+	*
+	* @template K - Array of service name keys
+	* @param names - Array of service names to retrieve
+	* @returns Promise resolving to an object containing the service instances
+	*
+	* @example
+	* ```typescript
+	* const { database, cache, auth } = await discovery.getMany([
+	*   'database',
+	*   'cache',
+	*   'auth'
+	* ]);
+	* ```
+	*/
+	async getMany(names) {
+		const result = {};
+		for (const name of names) result[name] = await this.get(name);
+		return result;
+	}
+	/**
+	* Check if a service exists in the service discovery.
+	* Can check by service name or service instance.
+	*
+	* @param service - The service name or service instance to check
+	* @returns True if the service exists, false otherwise
+	*
+	* @example
+	* ```typescript
+	* if (discovery.has('database')) {
+	*   const db = await discovery.get('database');
+	* }
+	*
+	* // Or check with service instance
+	* if (!discovery.has(databaseService)) {
+	*   await discovery.register([databaseService]);
+	* }
+	* ```
+	*/
+	has(service) {
+		if (typeof service === "string") return this.services.has(service);
+		return this.services.has(service.serviceName);
+	}
+};
+
+//#endregion
+export { ServiceDiscovery };
+//# sourceMappingURL=ServiceDiscovery-DLMyH_yM.mjs.map

package/dist/ServiceDiscovery-DLMyH_yM.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceDiscovery-DLMyH_yM.mjs","names":["envParser: EnvironmentParser<{}>","services: T","name: K","names: [...K]","service: string | Service"],"sources":["../src/ServiceDiscovery.ts"],"sourcesContent":["import type { EnvironmentParser } from '@geekmidas/envkit';\nimport { serviceContext } from './context';\nimport type { Service } from './types';\n\n/**\n * Service discovery container that manages service registration and retrieval.\n * Implements a singleton pattern with lazy initialization of services.\n *\n * @template TServices - Record type mapping service names to their instance types\n *\n * @example\n * ```typescript\n * // Define service types\n * interface MyServices {\n *   database: Database;\n *   cache: CacheService;\n *   auth: AuthService;\n * }\n *\n * // Get service discovery instance\n * const discovery = ServiceDiscovery.getInstance<MyServices>(envParser);\n *\n * // Register services\n * await discovery.register([\n *   databaseService,\n *   cacheService,\n *   authService\n * ]);\n *\n * // Retrieve services\n * const db = await discovery.get('database');\n * const { cache, auth } = await discovery.getMany(['cache', 'auth']);\n * ```\n */\nexport class ServiceDiscovery<TServices extends Record<string, unknown> = {}> {\n\t/** Singleton instance of ServiceDiscovery */\n\tprivate static _instance: ServiceDiscovery<any>;\n\t/** Map of registered service definitions */\n\tprivate services = new Map<string, Service>();\n\t/** Map of instantiated service instances */\n\tprivate instances = new Map<keyof TServices, TServices[keyof TServices]>();\n\n\t/**\n\t * Gets the singleton instance of ServiceDiscovery.\n\t * Creates a new instance if one doesn't exist.\n\t *\n\t * @template T - Record type mapping service names to their instance types\n\t * @param envParser - Environment parser for service configuration\n\t * @returns The ServiceDiscovery singleton instance\n\t *\n\t * @example\n\t * ```typescript\n\t * const services = ServiceDiscovery.getInstance<MyServices>(envParser);\n\t * ```\n\t */\n\tstatic getInstance<T extends Record<any, unknown> = any>(\n\t\tenvParser: EnvironmentParser<{}>,\n\t): ServiceDiscovery<T> {\n\t\tif (!ServiceDiscovery._instance) {\n\t\t\tServiceDiscovery._instance = new ServiceDiscovery<T>(envParser);\n\t\t}\n\t\treturn ServiceDiscovery._instance as ServiceDiscovery<T>;\n\t}\n\n\t/**\n\t * Resets the singleton instance. Use only for testing purposes.\n\t * This clears all cached services and allows a fresh instance to be created.\n\t *\n\t * @example\n\t * ```typescript\n\t * // In test teardown\n\t * afterEach(() => {\n\t *   ServiceDiscovery.reset();\n\t * });\n\t * ```\n\t */\n\tstatic reset(): void {\n\t\tServiceDiscovery._instance = undefined as any;\n\t}\n\n\t/**\n\t * Private constructor to enforce singleton pattern.\n\t *\n\t * @param envParser - Environment parser for service configuration\n\t * @private\n\t */\n\tprivate constructor(readonly envParser: EnvironmentParser<{}>) {}\n\n\t/**\n\t * Register multiple services with the service discovery.\n\t * Services are instantiated lazily on first access.\n\t * Already instantiated services are returned from cache.\n\t *\n\t * @template T - Array type of services to register\n\t * @param services - Array of services to register\n\t * @returns Promise resolving to a record of service names to instances\n\t *\n\t * @example\n\t * ```typescript\n\t * const services = await discovery.register([\n\t *   databaseService,\n\t *   cacheService,\n\t *   authService\n\t * ]);\n\t *\n\t * // services = {\n\t * //   database: Database instance,\n\t * //   cache: CacheService instance,\n\t * //   auth: AuthService instance\n\t * // }\n\t * ```\n\t */\n\tasync register<T extends Service[]>(services: T): Promise<ServiceRecord<T>> {\n\t\tconst registeredServices = {} as ServiceRecord<T>;\n\t\tfor (const service of services) {\n\t\t\tconst name = service.serviceName as T[number]['serviceName'];\n\t\t\tif (this.instances.has(name)) {\n\t\t\t\t(registeredServices as any)[name] = this.instances.get(\n\t\t\t\t\tname,\n\t\t\t\t) as TServices[keyof TServices];\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\t// Pass both envParser and context to service\n\t\t\tconst instance = await service.register({\n\t\t\t\tenvParser: this.envParser,\n\t\t\t\tcontext: serviceContext,\n\t\t\t});\n\n\t\t\tthis.instances.set(name, instance as TServices[keyof TServices]);\n\t\t\t(registeredServices as any)[name] =\n\t\t\t\tinstance as TServices[keyof TServices];\n\t\t}\n\n\t\treturn registeredServices;\n\t}\n\n\t/**\n\t * Get a service from the service discovery.\n\t * Services are instantiated on first access if not already cached.\n\t *\n\t * @template K - The service name key\n\t * @param name - The name of the service to get\n\t * @returns Promise resolving to the service instance\n\t * @throws {Error} If the service is not registered\n\t *\n\t * @example\n\t * ```typescript\n\t * const database = await discovery.get('database');\n\t * const users = await database.query('SELECT * FROM users');\n\t * ```\n\t */\n\tget<K extends keyof TServices & string>(name: K): Promise<TServices[K]> {\n\t\tconst service = this.services.get(name);\n\n\t\tif (!service) {\n\t\t\tthrow new Error(`Service '${name}' not found in service discovery`);\n\t\t}\n\n\t\treturn service.register({\n\t\t\tenvParser: this.envParser,\n\t\t\tcontext: serviceContext,\n\t\t}) as Promise<TServices[K]>;\n\t}\n\t/**\n\t * Get multiple services from the service discovery.\n\t * Useful for retrieving multiple dependencies at once.\n\t *\n\t * @template K - Array of service name keys\n\t * @param names - Array of service names to retrieve\n\t * @returns Promise resolving to an object containing the service instances\n\t *\n\t * @example\n\t * ```typescript\n\t * const { database, cache, auth } = await discovery.getMany([\n\t *   'database',\n\t *   'cache',\n\t *   'auth'\n\t * ]);\n\t * ```\n\t */\n\tasync getMany<K extends (keyof TServices & string)[]>(\n\t\tnames: [...K],\n\t): Promise<{ [P in K[number]]: TServices[P] }> {\n\t\tconst result = {} as { [P in K[number]]: TServices[P] };\n\n\t\tfor (const name of names) {\n\t\t\tresult[name] = await this.get(name);\n\t\t}\n\n\t\treturn result;\n\t}\n\n\t/**\n\t * Check if a service exists in the service discovery.\n\t * Can check by service name or service instance.\n\t *\n\t * @param service - The service name or service instance to check\n\t * @returns True if the service exists, false otherwise\n\t *\n\t * @example\n\t * ```typescript\n\t * if (discovery.has('database')) {\n\t *   const db = await discovery.get('database');\n\t * }\n\t *\n\t * // Or check with service instance\n\t * if (!discovery.has(databaseService)) {\n\t *   await discovery.register([databaseService]);\n\t * }\n\t * ```\n\t */\n\thas(service: string | Service): boolean {\n\t\tif (typeof service === 'string') {\n\t\t\treturn this.services.has(service);\n\t\t}\n\n\t\treturn this.services.has(service.serviceName);\n\t}\n}\n\n/**\n * Utility type to extract service names from an array of services.\n *\n * @template T - Array of Service types\n *\n * @example\n * ```typescript\n * type Names = ExtractServiceNames<[typeof databaseService, typeof cacheService]>;\n * // type Names = 'database' | 'cache'\n * ```\n */\nexport type ExtractServiceNames<T extends Service[]> = T[number]['serviceName'];\n\n/**\n * Utility type to create a record type from an array of services.\n * Maps service names to their registered instance types.\n *\n * @template T - Array of Service types\n *\n * @example\n * ```typescript\n * type MyServiceRecord = ServiceRecord<[typeof databaseService, typeof cacheService]>;\n * // type MyServiceRecord = {\n * //   database: DatabaseInstance;\n * //   cache: CacheInstance;\n * // }\n * ```\n */\nexport type ServiceRecord<T extends Service[]> = {\n\t[K in T[number] as K['serviceName']]: K extends Service\n\t\t? Awaited<ReturnType<K['register']>>\n\t\t: never;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCA,IAAa,mBAAb,MAAa,iBAAiE;;CAE7E,OAAe;;CAEf,AAAQ,2BAAW,IAAI;;CAEvB,AAAQ,4BAAY,IAAI;;;;;;;;;;;;;;CAexB,OAAO,YACNA,WACsB;AACtB,OAAK,iBAAiB,UACrB,kBAAiB,YAAY,IAAI,iBAAoB;AAEtD,SAAO,iBAAiB;CACxB;;;;;;;;;;;;;CAcD,OAAO,QAAc;AACpB,mBAAiB;CACjB;;;;;;;CAQD,AAAQ,YAAqBA,WAAkC;EAAlC;CAAoC;;;;;;;;;;;;;;;;;;;;;;;;;CA0BjE,MAAM,SAA8BC,UAAwC;EAC3E,MAAM,qBAAqB,CAAE;AAC7B,OAAK,MAAM,WAAW,UAAU;GAC/B,MAAM,OAAO,QAAQ;AACrB,OAAI,KAAK,UAAU,IAAI,KAAK,EAAE;AAC7B,IAAC,mBAA2B,QAAQ,KAAK,UAAU,IAClD,KACA;AACD;GACA;GAGD,MAAM,WAAW,MAAM,QAAQ,SAAS;IACvC,WAAW,KAAK;IAChB,SAAS;GACT,EAAC;AAEF,QAAK,UAAU,IAAI,MAAM,SAAuC;AAChE,GAAC,mBAA2B,QAC3B;EACD;AAED,SAAO;CACP;;;;;;;;;;;;;;;;CAiBD,IAAwCC,MAAgC;EACvE,MAAM,UAAU,KAAK,SAAS,IAAI,KAAK;AAEvC,OAAK,QACJ,OAAM,IAAI,OAAO,WAAW,KAAK;AAGlC,SAAO,QAAQ,SAAS;GACvB,WAAW,KAAK;GAChB,SAAS;EACT,EAAC;CACF;;;;;;;;;;;;;;;;;;CAkBD,MAAM,QACLC,OAC8C;EAC9C,MAAM,SAAS,CAAE;AAEjB,OAAK,MAAM,QAAQ,MAClB,QAAO,QAAQ,MAAM,KAAK,IAAI,KAAK;AAGpC,SAAO;CACP;;;;;;;;;;;;;;;;;;;;CAqBD,IAAIC,SAAoC;AACvC,aAAW,YAAY,SACtB,QAAO,KAAK,SAAS,IAAI,QAAQ;AAGlC,SAAO,KAAK,SAAS,IAAI,QAAQ,YAAY;CAC7C;AACD"}