@geekmidas/services 0.1.0 → 0.2.0

package/dist/ServiceDiscovery-DpeEKNe2.d.mts

@@ -0,0 +1,189 @@
+import { Service } from "./types-CcHmCx_U.mjs";
+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-DpeEKNe2.d.mts.map

package/dist/ServiceDiscovery-DpeEKNe2.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceDiscovery-DpeEKNe2.d.mts","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.cjs

@@ -0,0 +1,4 @@
+require('./context-DUTDtYd2.cjs');
+const require_ServiceDiscovery = require('./ServiceDiscovery-BO2FzEGt.cjs');
+
+exports.ServiceDiscovery = require_ServiceDiscovery.ServiceDiscovery;

package/dist/ServiceDiscovery.d.cts

@@ -0,0 +1,3 @@
+import "./types-D7d_yeU5.cjs";
+import { ExtractServiceNames, ServiceDiscovery, ServiceRecord } from "./ServiceDiscovery-CfVBrQHt.cjs";
+export { ExtractServiceNames, ServiceDiscovery, ServiceRecord };

package/dist/ServiceDiscovery.d.mts

@@ -0,0 +1,3 @@
+import "./types-CcHmCx_U.mjs";
+import { ExtractServiceNames, ServiceDiscovery, ServiceRecord } from "./ServiceDiscovery-DpeEKNe2.mjs";
+export { ExtractServiceNames, ServiceDiscovery, ServiceRecord };

package/dist/ServiceDiscovery.mjs

@@ -0,0 +1,4 @@
+import "./context-B5YTspJR.mjs";
+import { ServiceDiscovery } from "./ServiceDiscovery-DLMyH_yM.mjs";
+
+export { ServiceDiscovery };

package/dist/context-B5YTspJR.mjs

@@ -0,0 +1,61 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+
+//#region src/context.ts
+/**
+* Internal AsyncLocalStorage instance for request context.
+* Not exported - use runWithRequestContext() to establish context
+* and serviceContext to access it.
+*/
+const requestContextStorage = new AsyncLocalStorage();
+/**
+* ServiceContext implementation.
+* Singleton that reads from AsyncLocalStorage.
+* Methods throw if called outside a request context (catches bugs early).
+*/
+const serviceContext = {
+	getLogger() {
+		const store = requestContextStorage.getStore();
+		if (!store) throw new Error("ServiceContext.getLogger() called outside request context. Ensure code runs within runWithRequestContext().");
+		return store.logger;
+	},
+	getRequestId() {
+		const store = requestContextStorage.getStore();
+		if (!store) throw new Error("ServiceContext.getRequestId() called outside request context. Ensure code runs within runWithRequestContext().");
+		return store.requestId;
+	},
+	getRequestStartTime() {
+		const store = requestContextStorage.getStore();
+		if (!store) throw new Error("ServiceContext.getRequestStartTime() called outside request context. Ensure code runs within runWithRequestContext().");
+		return store.startTime;
+	},
+	hasContext() {
+		return requestContextStorage.getStore() !== void 0;
+	}
+};
+/**
+* Run a function with request context.
+* Used by endpoint/function/subscriber adaptors.
+*
+* @param data - Request context data (logger, requestId, startTime)
+* @param fn - Function to run with context
+* @returns Result of the function
+*
+* @example
+* ```typescript
+* const result = await runWithRequestContext(
+*   { logger, requestId, startTime: Date.now() },
+*   async () => {
+*     // Inside here, serviceContext.getLogger() returns `logger`
+*     // serviceContext.getRequestId() returns `requestId`
+*     return await handleRequest();
+*   }
+* );
+* ```
+*/
+function runWithRequestContext(data, fn) {
+	return requestContextStorage.run(data, fn);
+}
+
+//#endregion
+export { runWithRequestContext, serviceContext };
+//# sourceMappingURL=context-B5YTspJR.mjs.map

package/dist/context-B5YTspJR.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-B5YTspJR.mjs","names":["serviceContext: ServiceContext","data: RequestContextData","fn: () => T | Promise<T>"],"sources":["../src/context.ts"],"sourcesContent":["import { AsyncLocalStorage } from 'node:async_hooks';\nimport type { Logger } from '@geekmidas/logger';\nimport type { ServiceContext } from './types';\n\n/**\n * Internal storage for request context data.\n * Not exported - services use ServiceContext interface.\n */\nexport interface RequestContextData {\n\tlogger: Logger;\n\trequestId: string;\n\tstartTime: number;\n}\n\n/**\n * Internal AsyncLocalStorage instance for request context.\n * Not exported - use runWithRequestContext() to establish context\n * and serviceContext to access it.\n */\nconst requestContextStorage = new AsyncLocalStorage<RequestContextData>();\n\n/**\n * ServiceContext implementation.\n * Singleton that reads from AsyncLocalStorage.\n * Methods throw if called outside a request context (catches bugs early).\n */\nexport const serviceContext: ServiceContext = {\n\tgetLogger() {\n\t\tconst store = requestContextStorage.getStore();\n\t\tif (!store) {\n\t\t\tthrow new Error(\n\t\t\t\t'ServiceContext.getLogger() called outside request context. ' +\n\t\t\t\t\t'Ensure code runs within runWithRequestContext().',\n\t\t\t);\n\t\t}\n\t\treturn store.logger;\n\t},\n\n\tgetRequestId() {\n\t\tconst store = requestContextStorage.getStore();\n\t\tif (!store) {\n\t\t\tthrow new Error(\n\t\t\t\t'ServiceContext.getRequestId() called outside request context. ' +\n\t\t\t\t\t'Ensure code runs within runWithRequestContext().',\n\t\t\t);\n\t\t}\n\t\treturn store.requestId;\n\t},\n\n\tgetRequestStartTime() {\n\t\tconst store = requestContextStorage.getStore();\n\t\tif (!store) {\n\t\t\tthrow new Error(\n\t\t\t\t'ServiceContext.getRequestStartTime() called outside request context. ' +\n\t\t\t\t\t'Ensure code runs within runWithRequestContext().',\n\t\t\t);\n\t\t}\n\t\treturn store.startTime;\n\t},\n\n\thasContext() {\n\t\treturn requestContextStorage.getStore() !== undefined;\n\t},\n};\n\n/**\n * Run a function with request context.\n * Used by endpoint/function/subscriber adaptors.\n *\n * @param data - Request context data (logger, requestId, startTime)\n * @param fn - Function to run with context\n * @returns Result of the function\n *\n * @example\n * ```typescript\n * const result = await runWithRequestContext(\n *   { logger, requestId, startTime: Date.now() },\n *   async () => {\n *     // Inside here, serviceContext.getLogger() returns `logger`\n *     // serviceContext.getRequestId() returns `requestId`\n *     return await handleRequest();\n *   }\n * );\n * ```\n */\nexport function runWithRequestContext<T>(\n\tdata: RequestContextData,\n\tfn: () => T | Promise<T>,\n): T | Promise<T> {\n\treturn requestContextStorage.run(data, fn);\n}\n"],"mappings":";;;;;;;;AAmBA,MAAM,wBAAwB,IAAI;;;;;;AAOlC,MAAaA,iBAAiC;CAC7C,YAAY;EACX,MAAM,QAAQ,sBAAsB,UAAU;AAC9C,OAAK,MACJ,OAAM,IAAI,MACT;AAIF,SAAO,MAAM;CACb;CAED,eAAe;EACd,MAAM,QAAQ,sBAAsB,UAAU;AAC9C,OAAK,MACJ,OAAM,IAAI,MACT;AAIF,SAAO,MAAM;CACb;CAED,sBAAsB;EACrB,MAAM,QAAQ,sBAAsB,UAAU;AAC9C,OAAK,MACJ,OAAM,IAAI,MACT;AAIF,SAAO,MAAM;CACb;CAED,aAAa;AACZ,SAAO,sBAAsB,UAAU;CACvC;AACD;;;;;;;;;;;;;;;;;;;;;AAsBD,SAAgB,sBACfC,MACAC,IACiB;AACjB,QAAO,sBAAsB,IAAI,MAAM,GAAG;AAC1C"}

package/dist/context-BVeZOvOd.d.cts

@@ -0,0 +1,45 @@
+import { ServiceContext } from "./types-D7d_yeU5.cjs";
+import { Logger } from "@geekmidas/logger";
+
+//#region src/context.d.ts
+
+/**
+ * Internal storage for request context data.
+ * Not exported - services use ServiceContext interface.
+ */
+interface RequestContextData {
+  logger: Logger;
+  requestId: string;
+  startTime: number;
+}
+/**
+ * ServiceContext implementation.
+ * Singleton that reads from AsyncLocalStorage.
+ * Methods throw if called outside a request context (catches bugs early).
+ */
+declare const serviceContext: ServiceContext;
+/**
+ * Run a function with request context.
+ * Used by endpoint/function/subscriber adaptors.
+ *
+ * @param data - Request context data (logger, requestId, startTime)
+ * @param fn - Function to run with context
+ * @returns Result of the function
+ *
+ * @example
+ * ```typescript
+ * const result = await runWithRequestContext(
+ *   { logger, requestId, startTime: Date.now() },
+ *   async () => {
+ *     // Inside here, serviceContext.getLogger() returns `logger`
+ *     // serviceContext.getRequestId() returns `requestId`
+ *     return await handleRequest();
+ *   }
+ * );
+ * ```
+ */
+declare function runWithRequestContext<T>(data: RequestContextData, fn: () => T | Promise<T>): T | Promise<T>;
+//# sourceMappingURL=context.d.ts.map
+//#endregion
+export { RequestContextData, runWithRequestContext, serviceContext };
+//# sourceMappingURL=context-BVeZOvOd.d.cts.map

package/dist/context-BVeZOvOd.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-BVeZOvOd.d.cts","names":[],"sources":["../src/context.ts"],"sourcesContent":[],"mappings":";;;;;;;AAQA;AAkBA;AA2DgB,UA7EC,kBAAA,CA6EoB;EAAA,MAAA,EA5E5B,MA4E4B;EAAA,SAC9B,EAAA,MAAA;EAAkB,SACd,EAAA,MAAA;;;;;;AACG;cA9DD,gBAAgB;;;;;;;;;;;;;;;;;;;;;iBA2Db,+BACT,8BACI,IAAI,QAAQ,KACpB,IAAI,QAAQ"}

package/dist/context-DMExgNzl.d.mts

@@ -0,0 +1,45 @@
+import { ServiceContext } from "./types-CcHmCx_U.mjs";
+import { Logger } from "@geekmidas/logger";
+
+//#region src/context.d.ts
+
+/**
+ * Internal storage for request context data.
+ * Not exported - services use ServiceContext interface.
+ */
+interface RequestContextData {
+  logger: Logger;
+  requestId: string;
+  startTime: number;
+}
+/**
+ * ServiceContext implementation.
+ * Singleton that reads from AsyncLocalStorage.
+ * Methods throw if called outside a request context (catches bugs early).
+ */
+declare const serviceContext: ServiceContext;
+/**
+ * Run a function with request context.
+ * Used by endpoint/function/subscriber adaptors.
+ *
+ * @param data - Request context data (logger, requestId, startTime)
+ * @param fn - Function to run with context
+ * @returns Result of the function
+ *
+ * @example
+ * ```typescript
+ * const result = await runWithRequestContext(
+ *   { logger, requestId, startTime: Date.now() },
+ *   async () => {
+ *     // Inside here, serviceContext.getLogger() returns `logger`
+ *     // serviceContext.getRequestId() returns `requestId`
+ *     return await handleRequest();
+ *   }
+ * );
+ * ```
+ */
+declare function runWithRequestContext<T>(data: RequestContextData, fn: () => T | Promise<T>): T | Promise<T>;
+//# sourceMappingURL=context.d.ts.map
+//#endregion
+export { RequestContextData, runWithRequestContext, serviceContext };
+//# sourceMappingURL=context-DMExgNzl.d.mts.map

package/dist/context-DMExgNzl.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-DMExgNzl.d.mts","names":[],"sources":["../src/context.ts"],"sourcesContent":[],"mappings":";;;;;;;AAQA;AAkBA;AA2DgB,UA7EC,kBAAA,CA6EoB;EAAA,MAAA,EA5E5B,MA4E4B;EAAA,SAC9B,EAAA,MAAA;EAAkB,SACd,EAAA,MAAA;;;;;;AACG;cA9DD,gBAAgB;;;;;;;;;;;;;;;;;;;;;iBA2Db,+BACT,8BACI,IAAI,QAAQ,KACpB,IAAI,QAAQ"}

package/dist/context-DUTDtYd2.cjs

@@ -0,0 +1,95 @@
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+const node_async_hooks = __toESM(require("node:async_hooks"));
+
+//#region src/context.ts
+/**
+* Internal AsyncLocalStorage instance for request context.
+* Not exported - use runWithRequestContext() to establish context
+* and serviceContext to access it.
+*/
+const requestContextStorage = new node_async_hooks.AsyncLocalStorage();
+/**
+* ServiceContext implementation.
+* Singleton that reads from AsyncLocalStorage.
+* Methods throw if called outside a request context (catches bugs early).
+*/
+const serviceContext = {
+	getLogger() {
+		const store = requestContextStorage.getStore();
+		if (!store) throw new Error("ServiceContext.getLogger() called outside request context. Ensure code runs within runWithRequestContext().");
+		return store.logger;
+	},
+	getRequestId() {
+		const store = requestContextStorage.getStore();
+		if (!store) throw new Error("ServiceContext.getRequestId() called outside request context. Ensure code runs within runWithRequestContext().");
+		return store.requestId;
+	},
+	getRequestStartTime() {
+		const store = requestContextStorage.getStore();
+		if (!store) throw new Error("ServiceContext.getRequestStartTime() called outside request context. Ensure code runs within runWithRequestContext().");
+		return store.startTime;
+	},
+	hasContext() {
+		return requestContextStorage.getStore() !== void 0;
+	}
+};
+/**
+* Run a function with request context.
+* Used by endpoint/function/subscriber adaptors.
+*
+* @param data - Request context data (logger, requestId, startTime)
+* @param fn - Function to run with context
+* @returns Result of the function
+*
+* @example
+* ```typescript
+* const result = await runWithRequestContext(
+*   { logger, requestId, startTime: Date.now() },
+*   async () => {
+*     // Inside here, serviceContext.getLogger() returns `logger`
+*     // serviceContext.getRequestId() returns `requestId`
+*     return await handleRequest();
+*   }
+* );
+* ```
+*/
+function runWithRequestContext(data, fn) {
+	return requestContextStorage.run(data, fn);
+}
+
+//#endregion
+Object.defineProperty(exports, 'runWithRequestContext', {
+  enumerable: true,
+  get: function () {
+    return runWithRequestContext;
+  }
+});
+Object.defineProperty(exports, 'serviceContext', {
+  enumerable: true,
+  get: function () {
+    return serviceContext;
+  }
+});
+//# sourceMappingURL=context-DUTDtYd2.cjs.map

package/dist/context-DUTDtYd2.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-DUTDtYd2.cjs","names":["AsyncLocalStorage","serviceContext: ServiceContext","data: RequestContextData","fn: () => T | Promise<T>"],"sources":["../src/context.ts"],"sourcesContent":["import { AsyncLocalStorage } from 'node:async_hooks';\nimport type { Logger } from '@geekmidas/logger';\nimport type { ServiceContext } from './types';\n\n/**\n * Internal storage for request context data.\n * Not exported - services use ServiceContext interface.\n */\nexport interface RequestContextData {\n\tlogger: Logger;\n\trequestId: string;\n\tstartTime: number;\n}\n\n/**\n * Internal AsyncLocalStorage instance for request context.\n * Not exported - use runWithRequestContext() to establish context\n * and serviceContext to access it.\n */\nconst requestContextStorage = new AsyncLocalStorage<RequestContextData>();\n\n/**\n * ServiceContext implementation.\n * Singleton that reads from AsyncLocalStorage.\n * Methods throw if called outside a request context (catches bugs early).\n */\nexport const serviceContext: ServiceContext = {\n\tgetLogger() {\n\t\tconst store = requestContextStorage.getStore();\n\t\tif (!store) {\n\t\t\tthrow new Error(\n\t\t\t\t'ServiceContext.getLogger() called outside request context. ' +\n\t\t\t\t\t'Ensure code runs within runWithRequestContext().',\n\t\t\t);\n\t\t}\n\t\treturn store.logger;\n\t},\n\n\tgetRequestId() {\n\t\tconst store = requestContextStorage.getStore();\n\t\tif (!store) {\n\t\t\tthrow new Error(\n\t\t\t\t'ServiceContext.getRequestId() called outside request context. ' +\n\t\t\t\t\t'Ensure code runs within runWithRequestContext().',\n\t\t\t);\n\t\t}\n\t\treturn store.requestId;\n\t},\n\n\tgetRequestStartTime() {\n\t\tconst store = requestContextStorage.getStore();\n\t\tif (!store) {\n\t\t\tthrow new Error(\n\t\t\t\t'ServiceContext.getRequestStartTime() called outside request context. ' +\n\t\t\t\t\t'Ensure code runs within runWithRequestContext().',\n\t\t\t);\n\t\t}\n\t\treturn store.startTime;\n\t},\n\n\thasContext() {\n\t\treturn requestContextStorage.getStore() !== undefined;\n\t},\n};\n\n/**\n * Run a function with request context.\n * Used by endpoint/function/subscriber adaptors.\n *\n * @param data - Request context data (logger, requestId, startTime)\n * @param fn - Function to run with context\n * @returns Result of the function\n *\n * @example\n * ```typescript\n * const result = await runWithRequestContext(\n *   { logger, requestId, startTime: Date.now() },\n *   async () => {\n *     // Inside here, serviceContext.getLogger() returns `logger`\n *     // serviceContext.getRequestId() returns `requestId`\n *     return await handleRequest();\n *   }\n * );\n * ```\n */\nexport function runWithRequestContext<T>(\n\tdata: RequestContextData,\n\tfn: () => T | Promise<T>,\n): T | Promise<T> {\n\treturn requestContextStorage.run(data, fn);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmBA,MAAM,wBAAwB,IAAIA;;;;;;AAOlC,MAAaC,iBAAiC;CAC7C,YAAY;EACX,MAAM,QAAQ,sBAAsB,UAAU;AAC9C,OAAK,MACJ,OAAM,IAAI,MACT;AAIF,SAAO,MAAM;CACb;CAED,eAAe;EACd,MAAM,QAAQ,sBAAsB,UAAU;AAC9C,OAAK,MACJ,OAAM,IAAI,MACT;AAIF,SAAO,MAAM;CACb;CAED,sBAAsB;EACrB,MAAM,QAAQ,sBAAsB,UAAU;AAC9C,OAAK,MACJ,OAAM,IAAI,MACT;AAIF,SAAO,MAAM;CACb;CAED,aAAa;AACZ,SAAO,sBAAsB,UAAU;CACvC;AACD;;;;;;;;;;;;;;;;;;;;;AAsBD,SAAgB,sBACfC,MACAC,IACiB;AACjB,QAAO,sBAAsB,IAAI,MAAM,GAAG;AAC1C"}

package/dist/context.cjs

@@ -0,0 +1,4 @@
+const require_context = require('./context-DUTDtYd2.cjs');
+
+exports.runWithRequestContext = require_context.runWithRequestContext;
+exports.serviceContext = require_context.serviceContext;

package/dist/context.d.cts

@@ -0,0 +1,3 @@
+import "./types-D7d_yeU5.cjs";
+import { RequestContextData, runWithRequestContext, serviceContext } from "./context-BVeZOvOd.cjs";
+export { RequestContextData, runWithRequestContext, serviceContext };

package/dist/context.d.mts

@@ -0,0 +1,3 @@
+import "./types-CcHmCx_U.mjs";
+import { RequestContextData, runWithRequestContext, serviceContext } from "./context-DMExgNzl.mjs";
+export { RequestContextData, runWithRequestContext, serviceContext };

package/dist/context.mjs

@@ -0,0 +1,3 @@
+import { runWithRequestContext, serviceContext } from "./context-B5YTspJR.mjs";
+
+export { runWithRequestContext, serviceContext };