@warlock.js/context 4.0.42 → 4.0.47

package/cjs/index.js

@@ -1,194 +1,21 @@
 'use strict';
 
-var async_hooks = require('async_hooks');
+var baseContext = require('./base-context');
+var contextManager = require('./context-manager');
 
-// ../../warlock.js/context/src/base-context.ts
-var Context = class {
-  storage = new async_hooks.AsyncLocalStorage();
-  /**
-   * Run a callback within a new context
-   *
-   * Creates a new async context with the provided store data.
-   * All operations within the callback will have access to this context.
-   *
-   * @param store - Initial context data
-   * @param callback - Async function to execute
-   * @returns Result of the callback
-   */
-  run(store, callback) {
-    return this.storage.run(store, callback);
-  }
-  /**
-   * Enter a new context without a callback
-   *
-   * Useful for middleware where you want to set context for the rest of the request.
-   * Unlike `run()`, this doesn't require a callback.
-   *
-   * @param store - Context data to set
-   */
-  enter(store) {
-    this.storage.enterWith(store);
-  }
-  /**
-   * Update the current context
-   *
-   * Merges new data into existing context, or enters new context if none exists.
-   *
-   * @param updates - Partial context data to merge
-   */
-  update(updates) {
-    const current = this.storage.getStore();
-    if (current) {
-      Object.assign(current, updates);
-    } else {
-      this.enter(updates);
-    }
-  }
-  /**
-   * Get the current context store
-   *
-   * @returns Current context or undefined if not in context
-   */
-  getStore() {
-    return this.storage.getStore();
-  }
-  /**
-   * Get a specific value from context
-   *
-   * @param key - Key to retrieve
-   * @returns Value or undefined
-   */
-  get(key) {
-    return this.storage.getStore()?.[key];
-  }
-  /**
-   * Set a specific value in context
-   *
-   * @param key - Key to set
-   * @param value - Value to store
-   */
-  set(key, value) {
-    this.update({ [key]: value });
-  }
-  /**
-   * Clear the context
-   */
-  clear() {
-    this.storage.enterWith({});
-  }
-  /**
-   * Check if currently in a context
-   */
-  hasContext() {
-    return this.storage.getStore() !== void 0;
-  }
-};
 
-// ../../warlock.js/context/src/context-manager.ts
-var ContextManager = class {
-  contexts = /* @__PURE__ */ new Map();
-  /**
-   * Register a context
-   *
-   * @param name - Unique context name
-   * @param context - Context instance
-   * @returns This instance for chaining
-   */
-  register(name, context) {
-    this.contexts.set(name, context);
-    return this;
-  }
-  /**
-   * Run all registered contexts together
-   *
-   * Nests all context.run() calls, ensuring all contexts are active
-   * for the duration of the callback.
-   *
-   * @param stores - Context stores keyed by context name
-   * @param callback - Async function to execute
-   * @returns Result of the callback
-   */
-  async runAll(stores, callback) {
-    const entries = Array.from(this.contexts.entries());
-    const runner = entries.reduceRight((next, [name, context]) => {
-      return () => context.run(stores[name] || {}, next);
-    }, callback);
-    return runner();
-  }
-  /**
-   * Enter all contexts at once (for middleware)
-   *
-   * @param stores - Context stores keyed by context name
-   */
-  enterAll(stores) {
-    for (const [name, context] of this.contexts.entries()) {
-      if (stores[name]) {
-        context.enter(stores[name]);
-      }
-    }
-  }
-  /**
-   * Clear all contexts
-   */
-  clearAll() {
-    for (const context of this.contexts.values()) {
-      context.clear();
-    }
-  }
-  /**
-   * Get a specific registered context
-   *
-   * @param name - Context name
-   * @returns Context instance or undefined
-   */
-  getContext(name) {
-    return this.contexts.get(name);
-  }
-  /**
-   * Check if a context is registered
-   *
-   * @param name - Context name
-   * @returns True if context is registered
-   */
-  hasContext(name) {
-    return this.contexts.has(name);
-  }
-  /**
-   * Build all context stores by calling each context's buildStore() method
-   *
-   * This is the immutable pattern - returns a new record of stores.
-   * Each context defines its own initialization logic.
-   *
-   * @param payload - Payload passed to each buildStore() (e.g., { request, response })
-   * @returns Record of context name -> store data
-   *
-   * @example
-   * ```typescript
-   * const httpContextStore = contextManager.buildStores({ request, response });
-   * await contextManager.runAll(httpContextStore, async () => { ... });
-   * ```
-   */
-  buildStores(payload) {
-    const stores = {};
-    for (const [name, context] of this.contexts.entries()) {
-      stores[name] = context.buildStore(payload) ?? {};
-    }
-    return stores;
-  }
-  /**
-   * Unregister a context
-   *
-   * @param name - Context name to remove
-   * @returns True if context was removed
-   */
-  unregister(name) {
-    return this.contexts.delete(name);
-  }
-};
-var contextManager = new ContextManager();
 
-exports.Context = Context;
-exports.ContextManager = ContextManager;
-exports.contextManager = contextManager;
+Object.keys(baseContext).forEach(function (k) {
+	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function () { return baseContext[k]; }
+	});
+});
+Object.keys(contextManager).forEach(function (k) {
+	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function () { return contextManager[k]; }
+	});
+});
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../warlock.js/context/src/base-context.ts","../../../../../../../warlock.js/context/src/context-manager.ts"],"names":["AsyncLocalStorage"],"mappings":"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","file":"index.js","sourcesContent":["import { AsyncLocalStorage } from \"async_hooks\";\n\n/**\n * Base class for all AsyncLocalStorage-based contexts\n *\n * Provides a consistent API for managing context across async operations.\n * All framework contexts (request, storage, database) extend this class.\n *\n * @template TStore - The type of data stored in context\n *\n * @example\n * ```typescript\n * interface MyContextStore {\n *   userId: string;\n *   tenant: string;\n * }\n *\n * class MyContext extends Context<MyContextStore> {}\n * const myContext = new MyContext();\n *\n * // Use it\n * await myContext.run({ userId: '123', tenant: 'acme' }, async () => {\n *   const userId = myContext.get('userId'); // '123'\n * });\n * ```\n */\nexport abstract class Context<TStore extends Record<string, any>> {\n  protected readonly storage: AsyncLocalStorage<TStore> = new AsyncLocalStorage<TStore>();\n\n  /**\n   * Run a callback within a new context\n   *\n   * Creates a new async context with the provided store data.\n   * All operations within the callback will have access to this context.\n   *\n   * @param store - Initial context data\n   * @param callback - Async function to execute\n   * @returns Result of the callback\n   */\n  public run<T>(store: TStore, callback: () => Promise<T>): Promise<T> {\n    return this.storage.run(store, callback);\n  }\n\n  /**\n   * Enter a new context without a callback\n   *\n   * Useful for middleware where you want to set context for the rest of the request.\n   * Unlike `run()`, this doesn't require a callback.\n   *\n   * @param store - Context data to set\n   */\n  public enter(store: TStore): void {\n    this.storage.enterWith(store);\n  }\n\n  /**\n   * Update the current context\n   *\n   * Merges new data into existing context, or enters new context if none exists.\n   *\n   * @param updates - Partial context data to merge\n   */\n  public update(updates: Partial<TStore>): void {\n    const current = this.storage.getStore();\n\n    if (current) {\n      Object.assign(current, updates);\n    } else {\n      this.enter(updates as TStore);\n    }\n  }\n\n  /**\n   * Get the current context store\n   *\n   * @returns Current context or undefined if not in context\n   */\n  public getStore(): TStore | undefined {\n    return this.storage.getStore();\n  }\n\n  /**\n   * Get a specific value from context\n   *\n   * @param key - Key to retrieve\n   * @returns Value or undefined\n   */\n  public get<K extends keyof TStore>(key: K): TStore[K] | undefined {\n    return this.storage.getStore()?.[key];\n  }\n\n  /**\n   * Set a specific value in context\n   *\n   * @param key - Key to set\n   * @param value - Value to store\n   */\n  public set<K extends keyof TStore>(key: K, value: TStore[K]): void {\n    this.update({ [key]: value } as any);\n  }\n\n  /**\n   * Clear the context\n   */\n  public clear(): void {\n    this.storage.enterWith({} as TStore);\n  }\n\n  /**\n   * Check if currently in a context\n   */\n  public hasContext(): boolean {\n    return this.storage.getStore() !== undefined;\n  }\n\n  /**\n   * Build the initial store for this context\n   *\n   * Override this method to provide custom initialization logic.\n   * Called by ContextManager.buildStores() for each registered context.\n   *\n   * @param payload - Generic payload (e.g., { request, response } for HTTP contexts)\n   * @returns Initial store data\n   */\n  public abstract buildStore(payload?: Record<string, any>): TStore;\n}\n","import type { Context } from \"./base-context\";\n\n/**\n * Context Manager - Orchestrates multiple contexts together\n *\n * Allows running multiple AsyncLocalStorage contexts in a single operation,\n * making it easy to link request, storage, database, and other contexts.\n *\n * @example\n * ```typescript\n * // Register contexts\n * contextManager\n *   .register('request', requestContext)\n *   .register('storage', storageDriverContext)\n *   .register('database', databaseDataSourceContext);\n *\n * // Run all contexts together\n * await contextManager.runAll({\n *   request: { request, response, user },\n *   storage: { driver, metadata: { tenantId: '123' } },\n *   database: { dataSource: 'primary' },\n * }, async () => {\n *   // All contexts active!\n *   await handleRequest();\n * });\n * ```\n */\nexport class ContextManager {\n  private contexts = new Map<string, Context<any>>();\n\n  /**\n   * Register a context\n   *\n   * @param name - Unique context name\n   * @param context - Context instance\n   * @returns This instance for chaining\n   */\n  public register(name: string, context: Context<any>): this {\n    this.contexts.set(name, context);\n    return this;\n  }\n\n  /**\n   * Run all registered contexts together\n   *\n   * Nests all context.run() calls, ensuring all contexts are active\n   * for the duration of the callback.\n   *\n   * @param stores - Context stores keyed by context name\n   * @param callback - Async function to execute\n   * @returns Result of the callback\n   */\n  public async runAll<T>(stores: Record<string, any>, callback: () => Promise<T>): Promise<T> {\n    const entries = Array.from(this.contexts.entries());\n\n    // Build nested context runners\n    const runner = entries.reduceRight((next, [name, context]) => {\n      return () => context.run(stores[name] || {}, next);\n    }, callback);\n\n    return runner();\n  }\n\n  /**\n   * Enter all contexts at once (for middleware)\n   *\n   * @param stores - Context stores keyed by context name\n   */\n  public enterAll(stores: Record<string, any>): void {\n    for (const [name, context] of this.contexts.entries()) {\n      if (stores[name]) {\n        context.enter(stores[name]);\n      }\n    }\n  }\n\n  /**\n   * Clear all contexts\n   */\n  public clearAll(): void {\n    for (const context of this.contexts.values()) {\n      context.clear();\n    }\n  }\n\n  /**\n   * Get a specific registered context\n   *\n   * @param name - Context name\n   * @returns Context instance or undefined\n   */\n  public getContext<T extends Context<any>>(name: string): T | undefined {\n    return this.contexts.get(name) as T | undefined;\n  }\n\n  /**\n   * Check if a context is registered\n   *\n   * @param name - Context name\n   * @returns True if context is registered\n   */\n  public hasContext(name: string): boolean {\n    return this.contexts.has(name);\n  }\n\n  /**\n   * Build all context stores by calling each context's buildStore() method\n   *\n   * This is the immutable pattern - returns a new record of stores.\n   * Each context defines its own initialization logic.\n   *\n   * @param payload - Payload passed to each buildStore() (e.g., { request, response })\n   * @returns Record of context name -> store data\n   *\n   * @example\n   * ```typescript\n   * const httpContextStore = contextManager.buildStores({ request, response });\n   * await contextManager.runAll(httpContextStore, async () => { ... });\n   * ```\n   */\n  public buildStores(payload?: Record<string, any>): Record<string, any> {\n    const stores: Record<string, any> = {};\n\n    for (const [name, context] of this.contexts.entries()) {\n      stores[name] = context.buildStore(payload) ?? {};\n    }\n\n    return stores;\n  }\n\n  /**\n   * Unregister a context\n   *\n   * @param name - Context name to remove\n   * @returns True if context was removed\n   */\n  public unregister(name: string): boolean {\n    return this.contexts.delete(name);\n  }\n}\n\n/**\n * Global context manager instance\n *\n * Use this singleton to register and manage all framework contexts.\n */\nexport const contextManager = new ContextManager();\n"]}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js","sourcesContent":[]}

package/esm/index.js

@@ -1,190 +1,4 @@
-import { AsyncLocalStorage } from 'async_hooks';
-
-// ../../warlock.js/context/src/base-context.ts
-var Context = class {
-  storage = new AsyncLocalStorage();
-  /**
-   * Run a callback within a new context
-   *
-   * Creates a new async context with the provided store data.
-   * All operations within the callback will have access to this context.
-   *
-   * @param store - Initial context data
-   * @param callback - Async function to execute
-   * @returns Result of the callback
-   */
-  run(store, callback) {
-    return this.storage.run(store, callback);
-  }
-  /**
-   * Enter a new context without a callback
-   *
-   * Useful for middleware where you want to set context for the rest of the request.
-   * Unlike `run()`, this doesn't require a callback.
-   *
-   * @param store - Context data to set
-   */
-  enter(store) {
-    this.storage.enterWith(store);
-  }
-  /**
-   * Update the current context
-   *
-   * Merges new data into existing context, or enters new context if none exists.
-   *
-   * @param updates - Partial context data to merge
-   */
-  update(updates) {
-    const current = this.storage.getStore();
-    if (current) {
-      Object.assign(current, updates);
-    } else {
-      this.enter(updates);
-    }
-  }
-  /**
-   * Get the current context store
-   *
-   * @returns Current context or undefined if not in context
-   */
-  getStore() {
-    return this.storage.getStore();
-  }
-  /**
-   * Get a specific value from context
-   *
-   * @param key - Key to retrieve
-   * @returns Value or undefined
-   */
-  get(key) {
-    return this.storage.getStore()?.[key];
-  }
-  /**
-   * Set a specific value in context
-   *
-   * @param key - Key to set
-   * @param value - Value to store
-   */
-  set(key, value) {
-    this.update({ [key]: value });
-  }
-  /**
-   * Clear the context
-   */
-  clear() {
-    this.storage.enterWith({});
-  }
-  /**
-   * Check if currently in a context
-   */
-  hasContext() {
-    return this.storage.getStore() !== void 0;
-  }
-};
-
-// ../../warlock.js/context/src/context-manager.ts
-var ContextManager = class {
-  contexts = /* @__PURE__ */ new Map();
-  /**
-   * Register a context
-   *
-   * @param name - Unique context name
-   * @param context - Context instance
-   * @returns This instance for chaining
-   */
-  register(name, context) {
-    this.contexts.set(name, context);
-    return this;
-  }
-  /**
-   * Run all registered contexts together
-   *
-   * Nests all context.run() calls, ensuring all contexts are active
-   * for the duration of the callback.
-   *
-   * @param stores - Context stores keyed by context name
-   * @param callback - Async function to execute
-   * @returns Result of the callback
-   */
-  async runAll(stores, callback) {
-    const entries = Array.from(this.contexts.entries());
-    const runner = entries.reduceRight((next, [name, context]) => {
-      return () => context.run(stores[name] || {}, next);
-    }, callback);
-    return runner();
-  }
-  /**
-   * Enter all contexts at once (for middleware)
-   *
-   * @param stores - Context stores keyed by context name
-   */
-  enterAll(stores) {
-    for (const [name, context] of this.contexts.entries()) {
-      if (stores[name]) {
-        context.enter(stores[name]);
-      }
-    }
-  }
-  /**
-   * Clear all contexts
-   */
-  clearAll() {
-    for (const context of this.contexts.values()) {
-      context.clear();
-    }
-  }
-  /**
-   * Get a specific registered context
-   *
-   * @param name - Context name
-   * @returns Context instance or undefined
-   */
-  getContext(name) {
-    return this.contexts.get(name);
-  }
-  /**
-   * Check if a context is registered
-   *
-   * @param name - Context name
-   * @returns True if context is registered
-   */
-  hasContext(name) {
-    return this.contexts.has(name);
-  }
-  /**
-   * Build all context stores by calling each context's buildStore() method
-   *
-   * This is the immutable pattern - returns a new record of stores.
-   * Each context defines its own initialization logic.
-   *
-   * @param payload - Payload passed to each buildStore() (e.g., { request, response })
-   * @returns Record of context name -> store data
-   *
-   * @example
-   * ```typescript
-   * const httpContextStore = contextManager.buildStores({ request, response });
-   * await contextManager.runAll(httpContextStore, async () => { ... });
-   * ```
-   */
-  buildStores(payload) {
-    const stores = {};
-    for (const [name, context] of this.contexts.entries()) {
-      stores[name] = context.buildStore(payload) ?? {};
-    }
-    return stores;
-  }
-  /**
-   * Unregister a context
-   *
-   * @param name - Context name to remove
-   * @returns True if context was removed
-   */
-  unregister(name) {
-    return this.contexts.delete(name);
-  }
-};
-var contextManager = new ContextManager();
-
-export { Context, ContextManager, contextManager };
+export * from './base-context';
+export * from './context-manager';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../warlock.js/context/src/base-context.ts","../../../../../../../warlock.js/context/src/context-manager.ts"],"names":[],"mappings":";;;AA0BO,IAAe,UAAf,MAA2D;AAAA,EAC7C,OAAA,GAAqC,IAAI,iBAAA,EAA0B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAY/E,GAAA,CAAO,OAAe,QAAA,EAAwC;AACnE,IAAA,OAAO,IAAA,CAAK,OAAA,CAAQ,GAAA,CAAI,KAAA,EAAO,QAAQ,CAAA;AAAA,EACzC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUO,MAAM,KAAA,EAAqB;AAChC,IAAA,IAAA,CAAK,OAAA,CAAQ,UAAU,KAAK,CAAA;AAAA,EAC9B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASO,OAAO,OAAA,EAAgC;AAC5C,IAAA,MAAM,OAAA,GAAU,IAAA,CAAK,OAAA,CAAQ,QAAA,EAAS;AAEtC,IAAA,IAAI,OAAA,EAAS;AACX,MAAA,MAAA,CAAO,MAAA,CAAO,SAAS,OAAO,CAAA;AAAA,IAChC,CAAA,MAAO;AACL,MAAA,IAAA,CAAK,MAAM,OAAiB,CAAA;AAAA,IAC9B;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOO,QAAA,GAA+B;AACpC,IAAA,OAAO,IAAA,CAAK,QAAQ,QAAA,EAAS;AAAA,EAC/B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQO,IAA4B,GAAA,EAA+B;AAChE,IAAA,OAAO,IAAA,CAAK,OAAA,CAAQ,QAAA,EAAS,GAAI,GAAG,CAAA;AAAA,EACtC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQO,GAAA,CAA4B,KAAQ,KAAA,EAAwB;AACjE,IAAA,IAAA,CAAK,OAAO,EAAE,CAAC,GAAG,GAAG,OAAc,CAAA;AAAA,EACrC;AAAA;AAAA;AAAA;AAAA,EAKO,KAAA,GAAc;AACnB,IAAA,IAAA,CAAK,OAAA,CAAQ,SAAA,CAAU,EAAY,CAAA;AAAA,EACrC;AAAA;AAAA;AAAA;AAAA,EAKO,UAAA,GAAsB;AAC3B,IAAA,OAAO,IAAA,CAAK,OAAA,CAAQ,QAAA,EAAS,KAAM,MAAA;AAAA,EACrC;AAYF;;;AClGO,IAAM,iBAAN,MAAqB;AAAA,EAClB,QAAA,uBAAe,GAAA,EAA0B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAS1C,QAAA,CAAS,MAAc,OAAA,EAA6B;AACzD,IAAA,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,IAAA,EAAM,OAAO,CAAA;AAC/B,IAAA,OAAO,IAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,MAAa,MAAA,CAAU,MAAA,EAA6B,QAAA,EAAwC;AAC1F,IAAA,MAAM,UAAU,KAAA,CAAM,IAAA,CAAK,IAAA,CAAK,QAAA,CAAS,SAAS,CAAA;AAGlD,IAAA,MAAM,MAAA,GAAS,QAAQ,WAAA,CAAY,CAAC,MAAM,CAAC,IAAA,EAAM,OAAO,CAAA,KAAM;AAC5D,MAAA,OAAO,MAAM,QAAQ,GAAA,CAAI,MAAA,CAAO,IAAI,CAAA,IAAK,IAAI,IAAI,CAAA;AAAA,IACnD,GAAG,QAAQ,CAAA;AAEX,IAAA,OAAO,MAAA,EAAO;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOO,SAAS,MAAA,EAAmC;AACjD,IAAA,KAAA,MAAW,CAAC,IAAA,EAAM,OAAO,KAAK,IAAA,CAAK,QAAA,CAAS,SAAQ,EAAG;AACrD,MAAA,IAAI,MAAA,CAAO,IAAI,CAAA,EAAG;AAChB,QAAA,OAAA,CAAQ,KAAA,CAAM,MAAA,CAAO,IAAI,CAAC,CAAA;AAAA,MAC5B;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKO,QAAA,GAAiB;AACtB,IAAA,KAAA,MAAW,OAAA,IAAW,IAAA,CAAK,QAAA,CAAS,MAAA,EAAO,EAAG;AAC5C,MAAA,OAAA,CAAQ,KAAA,EAAM;AAAA,IAChB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQO,WAAmC,IAAA,EAA6B;AACrE,IAAA,OAAO,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,IAAI,CAAA;AAAA,EAC/B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQO,WAAW,IAAA,EAAuB;AACvC,IAAA,OAAO,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,IAAI,CAAA;AAAA,EAC/B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiBO,YAAY,OAAA,EAAoD;AACrE,IAAA,MAAM,SAA8B,EAAC;AAErC,IAAA,KAAA,MAAW,CAAC,IAAA,EAAM,OAAO,KAAK,IAAA,CAAK,QAAA,CAAS,SAAQ,EAAG;AACrD,MAAA,MAAA,CAAO,IAAI,CAAA,GAAI,OAAA,CAAQ,UAAA,CAAW,OAAO,KAAK,EAAC;AAAA,IACjD;AAEA,IAAA,OAAO,MAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQO,WAAW,IAAA,EAAuB;AACvC,IAAA,OAAO,IAAA,CAAK,QAAA,CAAS,MAAA,CAAO,IAAI,CAAA;AAAA,EAClC;AACF;AAOO,IAAM,cAAA,GAAiB,IAAI,cAAA","file":"index.js","sourcesContent":["import { AsyncLocalStorage } from \"async_hooks\";\n\n/**\n * Base class for all AsyncLocalStorage-based contexts\n *\n * Provides a consistent API for managing context across async operations.\n * All framework contexts (request, storage, database) extend this class.\n *\n * @template TStore - The type of data stored in context\n *\n * @example\n * ```typescript\n * interface MyContextStore {\n *   userId: string;\n *   tenant: string;\n * }\n *\n * class MyContext extends Context<MyContextStore> {}\n * const myContext = new MyContext();\n *\n * // Use it\n * await myContext.run({ userId: '123', tenant: 'acme' }, async () => {\n *   const userId = myContext.get('userId'); // '123'\n * });\n * ```\n */\nexport abstract class Context<TStore extends Record<string, any>> {\n  protected readonly storage: AsyncLocalStorage<TStore> = new AsyncLocalStorage<TStore>();\n\n  /**\n   * Run a callback within a new context\n   *\n   * Creates a new async context with the provided store data.\n   * All operations within the callback will have access to this context.\n   *\n   * @param store - Initial context data\n   * @param callback - Async function to execute\n   * @returns Result of the callback\n   */\n  public run<T>(store: TStore, callback: () => Promise<T>): Promise<T> {\n    return this.storage.run(store, callback);\n  }\n\n  /**\n   * Enter a new context without a callback\n   *\n   * Useful for middleware where you want to set context for the rest of the request.\n   * Unlike `run()`, this doesn't require a callback.\n   *\n   * @param store - Context data to set\n   */\n  public enter(store: TStore): void {\n    this.storage.enterWith(store);\n  }\n\n  /**\n   * Update the current context\n   *\n   * Merges new data into existing context, or enters new context if none exists.\n   *\n   * @param updates - Partial context data to merge\n   */\n  public update(updates: Partial<TStore>): void {\n    const current = this.storage.getStore();\n\n    if (current) {\n      Object.assign(current, updates);\n    } else {\n      this.enter(updates as TStore);\n    }\n  }\n\n  /**\n   * Get the current context store\n   *\n   * @returns Current context or undefined if not in context\n   */\n  public getStore(): TStore | undefined {\n    return this.storage.getStore();\n  }\n\n  /**\n   * Get a specific value from context\n   *\n   * @param key - Key to retrieve\n   * @returns Value or undefined\n   */\n  public get<K extends keyof TStore>(key: K): TStore[K] | undefined {\n    return this.storage.getStore()?.[key];\n  }\n\n  /**\n   * Set a specific value in context\n   *\n   * @param key - Key to set\n   * @param value - Value to store\n   */\n  public set<K extends keyof TStore>(key: K, value: TStore[K]): void {\n    this.update({ [key]: value } as any);\n  }\n\n  /**\n   * Clear the context\n   */\n  public clear(): void {\n    this.storage.enterWith({} as TStore);\n  }\n\n  /**\n   * Check if currently in a context\n   */\n  public hasContext(): boolean {\n    return this.storage.getStore() !== undefined;\n  }\n\n  /**\n   * Build the initial store for this context\n   *\n   * Override this method to provide custom initialization logic.\n   * Called by ContextManager.buildStores() for each registered context.\n   *\n   * @param payload - Generic payload (e.g., { request, response } for HTTP contexts)\n   * @returns Initial store data\n   */\n  public abstract buildStore(payload?: Record<string, any>): TStore;\n}\n","import type { Context } from \"./base-context\";\n\n/**\n * Context Manager - Orchestrates multiple contexts together\n *\n * Allows running multiple AsyncLocalStorage contexts in a single operation,\n * making it easy to link request, storage, database, and other contexts.\n *\n * @example\n * ```typescript\n * // Register contexts\n * contextManager\n *   .register('request', requestContext)\n *   .register('storage', storageDriverContext)\n *   .register('database', databaseDataSourceContext);\n *\n * // Run all contexts together\n * await contextManager.runAll({\n *   request: { request, response, user },\n *   storage: { driver, metadata: { tenantId: '123' } },\n *   database: { dataSource: 'primary' },\n * }, async () => {\n *   // All contexts active!\n *   await handleRequest();\n * });\n * ```\n */\nexport class ContextManager {\n  private contexts = new Map<string, Context<any>>();\n\n  /**\n   * Register a context\n   *\n   * @param name - Unique context name\n   * @param context - Context instance\n   * @returns This instance for chaining\n   */\n  public register(name: string, context: Context<any>): this {\n    this.contexts.set(name, context);\n    return this;\n  }\n\n  /**\n   * Run all registered contexts together\n   *\n   * Nests all context.run() calls, ensuring all contexts are active\n   * for the duration of the callback.\n   *\n   * @param stores - Context stores keyed by context name\n   * @param callback - Async function to execute\n   * @returns Result of the callback\n   */\n  public async runAll<T>(stores: Record<string, any>, callback: () => Promise<T>): Promise<T> {\n    const entries = Array.from(this.contexts.entries());\n\n    // Build nested context runners\n    const runner = entries.reduceRight((next, [name, context]) => {\n      return () => context.run(stores[name] || {}, next);\n    }, callback);\n\n    return runner();\n  }\n\n  /**\n   * Enter all contexts at once (for middleware)\n   *\n   * @param stores - Context stores keyed by context name\n   */\n  public enterAll(stores: Record<string, any>): void {\n    for (const [name, context] of this.contexts.entries()) {\n      if (stores[name]) {\n        context.enter(stores[name]);\n      }\n    }\n  }\n\n  /**\n   * Clear all contexts\n   */\n  public clearAll(): void {\n    for (const context of this.contexts.values()) {\n      context.clear();\n    }\n  }\n\n  /**\n   * Get a specific registered context\n   *\n   * @param name - Context name\n   * @returns Context instance or undefined\n   */\n  public getContext<T extends Context<any>>(name: string): T | undefined {\n    return this.contexts.get(name) as T | undefined;\n  }\n\n  /**\n   * Check if a context is registered\n   *\n   * @param name - Context name\n   * @returns True if context is registered\n   */\n  public hasContext(name: string): boolean {\n    return this.contexts.has(name);\n  }\n\n  /**\n   * Build all context stores by calling each context's buildStore() method\n   *\n   * This is the immutable pattern - returns a new record of stores.\n   * Each context defines its own initialization logic.\n   *\n   * @param payload - Payload passed to each buildStore() (e.g., { request, response })\n   * @returns Record of context name -> store data\n   *\n   * @example\n   * ```typescript\n   * const httpContextStore = contextManager.buildStores({ request, response });\n   * await contextManager.runAll(httpContextStore, async () => { ... });\n   * ```\n   */\n  public buildStores(payload?: Record<string, any>): Record<string, any> {\n    const stores: Record<string, any> = {};\n\n    for (const [name, context] of this.contexts.entries()) {\n      stores[name] = context.buildStore(payload) ?? {};\n    }\n\n    return stores;\n  }\n\n  /**\n   * Unregister a context\n   *\n   * @param name - Context name to remove\n   * @returns True if context was removed\n   */\n  public unregister(name: string): boolean {\n    return this.contexts.delete(name);\n  }\n}\n\n/**\n * Global context manager instance\n *\n * Use this singleton to register and manage all framework contexts.\n */\nexport const contextManager = new ContextManager();\n"]}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js","sourcesContent":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warlock.js/context",
-  "version": "4.0.42",
+  "version": "4.0.47",
   "description": "A simple and unified way to share context using AsyncLocalStorage for the Warlock.js framework",
   "keywords": [
     "warlock",