@andrew_l/context 0.3.21 → 0.4.0

package/dist/index.d.mts

@@ -1,5 +1,4 @@
-import { AnyFunction } from '@andrew_l/toolkit';
-
+import { AnyFunction } from "@andrew_l/toolkit";
 /**
  * Wrapper around `provide/inject` function to simple usage.
  *
@@ -27,7 +26,6 @@ import { AnyFunction } from '@andrew_l/toolkit';
  * @group Main
  */
 declare function createContext<ContextValue>(providerName: string | string[], contextName?: string): readonly [<T extends ContextValue | null | undefined = ContextValue>(fallback?: T | (() => T)) => T extends null ? ContextValue | null : ContextValue, (contextValue: ContextValue) => ContextValue];
-
 /**
  * The callback will be invoked when the associated context completes.
  *
@@ -51,7 +49,6 @@ declare function createContext<ContextValue>(providerName: string | string[], co
  * @group Main
  */
 declare function onScopeDispose(fn: () => void): void;
-
 type ProvideKey = symbol | string | number | object;
 type ProvideValue<T = unknown> = T | undefined;
 type InjectionKey = symbol | string | number | object;
@@ -71,39 +68,37 @@ declare function inject<T = any>(key: ProvideKey, defaultValue?: T | (() => T)):
  * @group Main
  */
 declare function hasInjectionContext(): boolean;
-
 declare class Scope {
-    detached: boolean;
-    /**
-     * @internal
-     */
-    id: number;
-    /**
-     * @internal
-     */
-    providers: Map<any, any>;
-    /**
-     * @internal
-     */
-    parent: Scope | null;
-    /**
-     * @internal
-     */
-    cleanups: (() => void)[];
-    /**
-     * @internal
-     */
-    private _activeRuns;
-    constructor(detached?: boolean);
-    run<T>(fn: () => T): T;
-    stop(): void;
-    get active(): boolean;
+  detached: boolean;
+  /**
+   * @internal
+   */
+  id: number;
+  /**
+   * @internal
+   */
+  providers: Map<any, any>;
+  /**
+   * @internal
+   */
+  parent: Scope | null;
+  /**
+   * @internal
+   */
+  cleanups: (() => void)[];
+  /**
+   * @internal
+   */
+  private _activeRuns;
+  constructor(detached?: boolean);
+  run<T>(fn: () => T): T;
+  stop(): void;
+  get active(): boolean;
 }
 /**
  * @group Main
  */
 declare function getCurrentScope(): Scope | null;
-
 /**
  * Creates a function within the injection context and returns its result. Providers/injections are only accessible within the callback function.
  * @param isolated Do not inject parent providers into this context (Default: `false`)
@@ -147,5 +142,5 @@ declare function runWithContext<T = any>(fn: () => T, isolated?: boolean): T;
  * @group Main
  */
 declare function bindContext<T>(fn: () => T): () => T;
-
-export { type InjectionKey, type ProvideKey, type ProvideValue, bindContext, createContext, getCurrentScope, hasInjectionContext, inject, onScopeDispose, provide, runWithContext, withContext };
+export { InjectionKey, ProvideKey, ProvideValue, bindContext, createContext, getCurrentScope, hasInjectionContext, inject, onScopeDispose, provide, runWithContext, withContext };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":["ContextValue","providerName","contextName","T","fallback","contextValue","fn","T","ProvideKey","key","value","enterWith","defaultValue","ProvideValue","detached","id","providers","Map","parent","Scope","cleanups","_activeRuns","constructor","run","T","fn","stop","active","scope","T","AnyFunction","fn","detached","isolated"],"sources":["../src/hooks/createContext.d.ts","../src/hooks/onScopeDispose.d.ts","../src/hooks/provide.d.ts","../src/scope.d.ts","../src/index.d.ts"],"mappings":";;;AA0BA;;;;;;;;;;;;;;;;;;;;;;;;iBAAwB,aAAA,eAA4BC,YAAAA,qBAAiCC,WAAAA,iCAA4C,YAAA,sBAAkC,YAAA,EAAcE,QAAAA,GAAW,CAAA,UAAW,CAAA,MAAO,CAAA,gBAAiB,YAAA,UAAsB,YAAA,GAAeC,YAAAA,EAAc,YAAA,KAAiB,YAAA;;;AAAnS;;;;;;;;;;;;;;;;;;;;iBCJwB,cAAA,CAAeC,EAAc;AAAA,KCtBzC,UAAA;AAAA,KACA,YAAA,gBAA4B,CAAC;AAAA,KAC7B,YAAA;;;;;;iBAMY,OAAA,CAAQG,GAAAA,EAAK,UAAU,EAAEC,KAAAA,OAAYC,SAAAA;;;;;iBAKrC,MAAA,UAAgBF,GAAAA,EAAK,UAAA,EAAYG,YAAAA,GAAe,CAAA,UAAW,CAAA,IAAK,YAAA,CAAa,CAAA;;;;;iBAK7E,mBAAA;AAAA,cClBH,KAAA;EACjBE,QAAAA;EHyBoB;;;EGrBpBC,EAAAA;EHqB+J;;;EGjB/JC,SAAAA,EAAW,GAAA;EHiBgN;;;EGb3NE,MAAAA,EAAQ,KAAA;EHamS;;;EGT3SE,QAAAA;EHSiFlB;;;EAAAA,QGLzEmB,WAAAA;EACRC,WAAAA,CAAYR,QAAAA;EACZS,GAAAA,IAAOE,EAAAA,QAAU,CAAA,GAAI,CAAA;EACrBC,IAAAA;EAAAA,IACIC,MAAAA;AAAAA;;AHCuS;;iBGQvR,eAAA,IAAmB,KAAK;;;;;;;;;;;;;;;;;;;;iBCVxB,WAAA,WAAsB,WAAA,EAAaI,EAAAA,EAAI,CAAA,EAAGC,QAAAA,aAAqB,CAAA;;;;;;iBAM/D,cAAA,UAAwBD,EAAAA,QAAU,CAAA,EAAGE,QAAAA,aAAqB,CAAC;;AJJ4N;;ACJ/S;;;;AAAqD;;ACtBrD;;;;AAAsB;AACtB;;iBE8CwB,WAAA,IAAeF,EAAAA,QAAU,CAAA,SAAU,CAAC"}

package/dist/index.mjs

@@ -1,195 +1,132 @@
-import { noop, isPromise, catchError, captureStackTrace, isFunction, assert } from '@andrew_l/toolkit';
-
+import { assert, captureStackTrace, catchError, isFunction, isPromise, noop } from "@andrew_l/toolkit";
 let idSec = 0;
 let ALS;
 let currentScope = null;
-import('node:async_hooks').then((r) => {
-  ALS = new r.AsyncLocalStorage();
+import("node:async_hooks").then((r) => {
+	ALS = new r.AsyncLocalStorage();
 }).catch(noop);
-class Scope {
-  constructor(detached = false) {
-    this.detached = detached;
-    this.id = ++idSec;
-    if (!detached) {
-      this.parent = getCurrentScope();
-    }
-  }
-  /**
-   * @internal
-   */
-  id;
-  /**
-   * @internal
-   */
-  providers = /* @__PURE__ */ new Map();
-  /**
-   * @internal
-   */
-  parent = null;
-  /**
-   * @internal
-   */
-  cleanups = [];
-  /**
-   * @internal
-   */
-  _activeRuns = 0;
-  run(fn) {
-    this._activeRuns++;
-    const onComplete = ([err, result]) => {
-      this._activeRuns--;
-      if (this._activeRuns === 0) {
-        this.stop();
-      }
-      if (err) {
-        throw err;
-      }
-      return result;
-    };
-    const r = runInScope(this, fn);
-    if (isPromise(r)) {
-      return r.then(onComplete);
-    }
-    return onComplete(r);
-  }
-  stop() {
-    for (let i = 0, l = this.cleanups.length; i < l; i++) {
-      this.cleanups[i]();
-    }
-    this.cleanups.length = 0;
-  }
-  get active() {
-    return this._activeRuns > 0;
-  }
-}
+var Scope = class {
+	detached;
+	id;
+	providers = /* @__PURE__ */ new Map();
+	parent = null;
+	cleanups = [];
+	_activeRuns = 0;
+	constructor(detached = false) {
+		this.detached = detached;
+		this.id = ++idSec;
+		if (!detached) this.parent = getCurrentScope();
+	}
+	run(fn) {
+		this._activeRuns++;
+		const onComplete = ([err, result]) => {
+			this._activeRuns--;
+			if (this._activeRuns === 0) this.stop();
+			if (err) throw err;
+			return result;
+		};
+		const r = runInScope(this, fn);
+		if (isPromise(r)) return r.then(onComplete);
+		return onComplete(r);
+	}
+	stop() {
+		for (let i = 0, l = this.cleanups.length; i < l; i++) this.cleanups[i]();
+		this.cleanups.length = 0;
+	}
+	get active() {
+		return this._activeRuns > 0;
+	}
+};
 function createScope(detached) {
-  return new Scope(detached);
+	return new Scope(detached);
 }
 function getCurrentScope() {
-  if (ALS) {
-    return ALS.getStore() ?? null;
-  }
-  return currentScope;
+	if (ALS) return ALS.getStore() ?? null;
+	return currentScope;
 }
 function setCurrentScope(scope) {
-  if (ALS) {
-    ALS.enterWith(scope);
-  } else {
-    currentScope = scope;
-  }
+	if (ALS) ALS.enterWith(scope);
+	else currentScope = scope;
 }
 function runInScope(scope, fn) {
-  if (ALS) {
-    return catchError(() => ALS.run(scope, fn));
-  }
-  const prevScope = getCurrentScope();
-  const onComplete = ([err, result2]) => {
-    if (prevScope) {
-      setCurrentScope(prevScope);
-    } else {
-      unsetCurrentScope();
-    }
-    return [err, result2];
-  };
-  const result = catchError(fn);
-  if (isPromise(result)) {
-    return result.then(onComplete);
-  }
-  return onComplete(result);
+	if (ALS) return catchError(() => ALS.run(scope, fn));
+	const prevScope = getCurrentScope();
+	const onComplete = ([err, result]) => {
+		if (prevScope) setCurrentScope(prevScope);
+		else unsetCurrentScope();
+		return [err, result];
+	};
+	const result = catchError(fn);
+	if (isPromise(result)) return result.then(onComplete);
+	return onComplete(result);
 }
 const unsetCurrentScope = () => {
-  if (ALS) {
-    ALS.enterWith(null);
-  } else {
-    currentScope = null;
-  }
+	if (ALS) ALS.enterWith(null);
+	else currentScope = null;
 };
-
 function provide(key, value, enterWith) {
-  let currentScope = getCurrentScope();
-  if (!currentScope) {
-    if (enterWith) {
-      currentScope = new Scope();
-      setCurrentScope(currentScope);
-    } else {
-      console.warn(
-        `provide() is called when there is no active scope to be associated with.
-` + captureStackTrace(provide)
-      );
-      return;
-    }
-  }
-  currentScope.providers.set(key, value);
+	let currentScope = getCurrentScope();
+	if (!currentScope) if (enterWith) {
+		currentScope = new Scope();
+		setCurrentScope(currentScope);
+	} else {
+		console.warn(`provide() is called when there is no active scope to be associated with.\n` + captureStackTrace(provide));
+		return;
+	}
+	currentScope.providers.set(key, value);
 }
 function inject(key, defaultValue) {
-  let currentScope = getCurrentScope();
-  if (!currentScope) {
-    console.warn(
-      `inject() is called when there is no active scope to be associated with.
-` + captureStackTrace(inject)
-    );
-    return;
-  }
-  const handled = /* @__PURE__ */ new WeakSet();
-  let value;
-  do {
-    value = currentScope.providers.get(key);
-    handled.add(currentScope);
-    currentScope = currentScope.parent;
-  } while (currentScope && value === void 0 && !handled.has(currentScope));
-  if (value === void 0 && defaultValue !== void 0) {
-    value = isFunction(defaultValue) ? defaultValue() : defaultValue;
-  }
-  return value;
+	let currentScope = getCurrentScope();
+	if (!currentScope) {
+		console.warn(`inject() is called when there is no active scope to be associated with.\n` + captureStackTrace(inject));
+		return;
+	}
+	const handled = /* @__PURE__ */ new WeakSet();
+	let value;
+	do {
+		value = currentScope.providers.get(key);
+		handled.add(currentScope);
+		currentScope = currentScope.parent;
+	} while (currentScope && value === void 0 && !handled.has(currentScope));
+	if (value === void 0 && defaultValue !== void 0) value = isFunction(defaultValue) ? defaultValue() : defaultValue;
+	return value;
 }
 function hasInjectionContext() {
-  return !!getCurrentScope();
+	return !!getCurrentScope();
 }
-
 function createContext(providerName, contextName) {
-  const symbolDescription = typeof providerName === "string" && !contextName ? `${providerName}Context` : contextName;
-  const injectionKey = Symbol(symbolDescription);
-  const injectContext = (fallback) => {
-    const context = inject(injectionKey, fallback);
-    if (context) return context;
-    if (context === null) return context;
-    throw new Error(
-      `Injection \`${injectionKey.toString()}\` not found. Must be used within ${Array.isArray(providerName) ? `one of the following providers: ${providerName.join(", ")}` : `\`${providerName}\``}`
-    );
-  };
-  const provideContext = (contextValue) => {
-    provide(injectionKey, contextValue);
-    return contextValue;
-  };
-  return [injectContext, provideContext];
+	const symbolDescription = typeof providerName === "string" && !contextName ? `${providerName}Context` : contextName;
+	const injectionKey = Symbol(symbolDescription);
+	const injectContext = (fallback) => {
+		const context = inject(injectionKey, fallback);
+		if (context) return context;
+		if (context === null) return context;
+		throw new Error(`Injection \`${injectionKey.toString()}\` not found. Must be used within ${Array.isArray(providerName) ? `one of the following providers: ${providerName.join(", ")}` : `\`${providerName}\``}`);
+	};
+	const provideContext = (contextValue) => {
+		provide(injectionKey, contextValue);
+		return contextValue;
+	};
+	return [injectContext, provideContext];
 }
-
 function onScopeDispose(fn) {
-  const activeScope = getCurrentScope();
-  assert.ok(
-    activeScope,
-    "onScopeDispose() is called when there is no active scope to be associated with." + captureStackTrace(onScopeDispose)
-  );
-  activeScope.cleanups.push(fn);
+	const activeScope = getCurrentScope();
+	assert.ok(activeScope, "onScopeDispose() is called when there is no active scope to be associated with." + captureStackTrace(onScopeDispose));
+	activeScope.cleanups.push(fn);
 }
-
 function withContext(fn, detached = false) {
-  return function(...args) {
-    const scope = createScope(detached);
-    return scope.run(fn.bind(this, ...args));
-  };
+	return function(...args) {
+		return createScope(detached).run(fn.bind(this, ...args));
+	};
 }
 function runWithContext(fn, isolated = false) {
-  return withContext(fn, isolated)();
+	return withContext(fn, isolated)();
 }
 function bindContext(fn) {
-  const activeScope = getCurrentScope();
-  assert.ok(
-    activeScope,
-    "bindContext() is called when there is no active scope to be associated with."
-  );
-  return () => activeScope.run(fn);
+	const activeScope = getCurrentScope();
+	assert.ok(activeScope, "bindContext() is called when there is no active scope to be associated with.");
+	return () => activeScope.run(fn);
 }
-
 export { bindContext, createContext, getCurrentScope, hasInjectionContext, inject, onScopeDispose, provide, runWithContext, withContext };
-//# sourceMappingURL=index.mjs.map
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sources":["../src/scope.ts","../src/hooks/provide.ts","../src/hooks/createContext.ts","../src/hooks/onScopeDispose.ts","../src/index.ts"],"sourcesContent":["import { type Awaitable, catchError, isPromise, noop } from '@andrew_l/toolkit';\nimport type { AsyncLocalStorage } from 'node:async_hooks';\n\nlet idSec = 0;\nlet ALS: AsyncLocalStorage<Scope | null> | undefined;\nlet currentScope: Scope | null = null;\n\nimport('node:async_hooks')\n  .then(r => {\n    ALS = new r.AsyncLocalStorage<Scope | null>();\n  })\n  .catch(noop);\n\nexport class Scope {\n  /**\n   * @internal\n   */\n  id: number;\n\n  /**\n   * @internal\n   */\n  providers = new Map<any, any>();\n\n  /**\n   * @internal\n   */\n  parent: Scope | null = null;\n\n  /**\n   * @internal\n   */\n  cleanups: (() => void)[] = [];\n\n  /**\n   * @internal\n   */\n  private _activeRuns: number = 0;\n\n  constructor(public detached = false) {\n    this.id = ++idSec;\n\n    if (!detached) {\n      this.parent = getCurrentScope();\n    }\n  }\n\n  run<T>(fn: () => T): T {\n    this._activeRuns++;\n\n    const onComplete = ([err, result]: [Error | undefined, any]): T => {\n      this._activeRuns--;\n\n      if (this._activeRuns === 0) {\n        this.stop();\n      }\n\n      if (err) {\n        throw err;\n      }\n\n      return result;\n    };\n\n    const r = runInScope(this, fn);\n\n    if (isPromise<any>(r)) {\n      return r.then(onComplete) as T;\n    }\n\n    return onComplete(r);\n  }\n\n  stop() {\n    for (let i = 0, l = this.cleanups.length; i < l; i++) {\n      this.cleanups[i]();\n    }\n\n    this.cleanups.length = 0;\n  }\n\n  get active(): boolean {\n    return this._activeRuns > 0;\n  }\n}\n\n/**\n * @param detached - Can be used to create a \"detached\" scope.\n */\nexport function createScope(detached?: boolean): Scope {\n  return new Scope(detached);\n}\n\n/**\n * @group Main\n */\nexport function getCurrentScope(): Scope | null {\n  if (ALS) {\n    return ALS.getStore() ?? null;\n  }\n\n  return currentScope;\n}\n\nexport function setCurrentScope(scope: Scope) {\n  if (ALS) {\n    ALS.enterWith(scope);\n  } else {\n    currentScope = scope;\n  }\n}\n\nfunction runInScope<T>(\n  scope: Scope,\n  fn: () => T,\n): Awaitable<[Error | undefined, any]> {\n  if (ALS) {\n    return catchError(() => ALS!.run(scope, fn));\n  }\n\n  const prevScope = getCurrentScope();\n\n  const onComplete = ([err, result]: [Error | undefined, any]): [\n    Error | undefined,\n    any,\n  ] => {\n    if (prevScope) {\n      setCurrentScope(prevScope);\n    } else {\n      unsetCurrentScope();\n    }\n\n    return [err, result];\n  };\n\n  const result = catchError(fn);\n\n  if (isPromise<any>(result)) {\n    return result.then(onComplete);\n  }\n\n  return onComplete(result);\n}\n\nconst unsetCurrentScope = (): void => {\n  if (ALS) {\n    ALS.enterWith(null);\n  } else {\n    currentScope = null;\n  }\n};\n","import { captureStackTrace, isFunction } from '@andrew_l/toolkit';\nimport { Scope, getCurrentScope, setCurrentScope } from '../scope';\n\nexport type ProvideKey = symbol | string | number | object;\nexport type ProvideValue<T = unknown> = T | undefined;\nexport type InjectionKey = symbol | string | number | object;\n\n/**\n * To provide data to a descendants\n * @param enterWith Enter into injection context (Experimental)\n * @group Main\n */\nexport function provide(key: ProvideKey, value: any, enterWith?: boolean) {\n  let currentScope = getCurrentScope();\n\n  if (!currentScope) {\n    if (enterWith) {\n      currentScope = new Scope();\n      setCurrentScope(currentScope);\n    } else {\n      console.warn(\n        `provide() is called when there is no active scope to be associated with.\\n` +\n          captureStackTrace(provide),\n      );\n      return;\n    }\n  }\n\n  currentScope.providers.set(key, value);\n}\n\n/**\n * Inject previously provided data\n * @group Main\n */\nexport function inject<T = any>(\n  key: ProvideKey,\n  defaultValue?: T | (() => T),\n): ProvideValue<T> {\n  let currentScope = getCurrentScope();\n\n  if (!currentScope) {\n    console.warn(\n      `inject() is called when there is no active scope to be associated with.\\n` +\n        captureStackTrace(inject),\n    );\n    return;\n  }\n\n  const handled = new WeakSet();\n\n  let value;\n\n  do {\n    value = currentScope!.providers.get(key);\n    handled.add(currentScope!);\n    currentScope = currentScope!.parent;\n  } while (currentScope && value === undefined && !handled.has(currentScope));\n\n  if (value === undefined && defaultValue !== undefined) {\n    value = isFunction(defaultValue) ? defaultValue() : defaultValue;\n  }\n\n  return value;\n}\n\n/**\n * Returns true if `inject()` can be used without warning about being called in the wrong place.\n * @group Main\n */\nexport function hasInjectionContext() {\n  return !!getCurrentScope();\n}\n","import { type InjectionKey, inject, provide } from './provide';\n\n/**\n * Wrapper around `provide/inject` function to simple usage.\n *\n * @param providerName - The name(s) of the providing the context.\n *\n * There are situations where context can come from multiple scopes. In such cases, you might need to give an array of names to provide your context, instead of just a single string.\n *\n * @param contextName The description for injection key symbol.\n *\n * @example\n * const [injectTraceId, provideTraceId] = createContext<string>('withContext');\n *\n * // this function will returns the same trace if for execution context\n * export const useTraceId = () => {\n *   let traceId = injectTraceId(null);\n *\n *   if (!traceId) {\n *     traceId = uuidv4();\n *     provideTraceId(traceId);\n *   }\n *\n *   return traceId;\n * };\n *\n * @group Main\n */\nexport function createContext<ContextValue>(\n  providerName: string | string[],\n  contextName?: string,\n) {\n  const symbolDescription =\n    typeof providerName === 'string' && !contextName\n      ? `${providerName}Context`\n      : contextName;\n\n  const injectionKey: InjectionKey = Symbol(symbolDescription);\n\n  /**\n   * @param fallback The context value to return if the injection fails.\n   *\n   * @throws When context injection failed and no fallback is specified.\n   * This happens when the scope injecting the context is not a child of the root scope providing the context.\n   */\n  const injectContext = <\n    T extends ContextValue | null | undefined = ContextValue,\n  >(\n    fallback?: T | (() => T),\n  ): T extends null ? ContextValue | null : ContextValue => {\n    const context = inject(injectionKey, fallback);\n    if (context) return context;\n\n    if (context === null) return context as any;\n\n    throw new Error(\n      `Injection \\`${injectionKey.toString()}\\` not found. Must be used within ${\n        Array.isArray(providerName)\n          ? `one of the following providers: ${providerName.join(', ')}`\n          : `\\`${providerName}\\``\n      }`,\n    );\n  };\n\n  const provideContext = (contextValue: ContextValue) => {\n    provide(injectionKey, contextValue);\n    return contextValue;\n  };\n\n  return [injectContext, provideContext] as const;\n}\n","import { assert, captureStackTrace } from '@andrew_l/toolkit';\nimport { getCurrentScope } from '../scope';\n\n/**\n * The callback will be invoked when the associated context completes.\n *\n * @example\n * const fn = withContext(() => {\n *   onScopeDispose(() => {\n *     console.log(2);\n *   });\n *\n *   console.log(1);\n * });\n *\n * fn();\n *\n * console.log(3);\n *\n * // 1\n * // 2\n * // 3\n *\n * @group Main\n */\nexport function onScopeDispose(fn: () => void) {\n  const activeScope = getCurrentScope();\n\n  assert.ok(\n    activeScope,\n    'onScopeDispose() is called when there is no active scope to be associated with.' +\n      captureStackTrace(onScopeDispose),\n  );\n\n  activeScope.cleanups.push(fn);\n}\n","import { type AnyFunction, assert } from '@andrew_l/toolkit';\nimport { createScope, getCurrentScope } from './scope';\n\nexport * from './hooks/createContext';\nexport * from './hooks/onScopeDispose';\nexport * from './hooks/provide';\nexport { getCurrentScope } from './scope';\n\n/**\n * Creates a function within the injection context and returns its result. Providers/injections are only accessible within the callback function.\n * @param isolated Do not inject parent providers into this context (Default: `false`)\n *\n * @example\n * const main = withContext(() => {\n *     provide('user', { id: 1, name: 'Andrew' });\n *     doCoolStaff();\n * });\n *\n * const doCoolStaff = () => {\n *     const user = inject('user');\n *     console.log(user); // { id: 1, name: 'Andrew' }\n * };\n *\n * main();\n *\n * @group Main\n */\nexport function withContext<T extends AnyFunction>(fn: T, detached = false): T {\n  return function (this: any, ...args: any[]) {\n    const scope = createScope(detached);\n    return scope.run(fn.bind(this, ...args));\n  } as T;\n}\n\n/**\n * Runs a function within the injection context and returns its result. Providers/injections are only accessible inside the callback function.\n * @param isolated Do not inject parent providers into this context (Default: `false`)\n * @group Main\n */\nexport function runWithContext<T = any>(fn: () => T, isolated = false): T {\n  return withContext(fn, isolated)();\n}\n\n/**\n * Binds the current context to the provided function. Useful for creating callbacks with the current context, such as `setTimeout` or `EventEmitter` handlers.\n * @example\n * const main = withContext(() => {\n *   provide(\"user\", { id: 1, name: \"Andrew\" });\n *\n *   setInterval(bindContext(() => {\n *     const user = inject(\"user\");\n *     console.log(user); // { id: 1, name: 'Andrew' }\n *   }));\n * });\n *\n * main();\n *\n * @group Main\n */\nexport function bindContext<T>(fn: () => T): () => T {\n  const activeScope = getCurrentScope();\n\n  assert.ok(\n    activeScope,\n    'bindContext() is called when there is no active scope to be associated with.',\n  );\n\n  return () => activeScope.run(fn);\n}\n"],"names":["result"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/scope.ts","../src/hooks/provide.ts","../src/hooks/createContext.ts","../src/hooks/onScopeDispose.ts","../src/index.ts"],"sourcesContent":["import { type Awaitable, catchError, isPromise, noop } from '@andrew_l/toolkit';\nimport type { AsyncLocalStorage } from 'node:async_hooks';\n\nlet idSec = 0;\nlet ALS: AsyncLocalStorage<Scope | null> | undefined;\nlet currentScope: Scope | null = null;\n\nimport('node:async_hooks')\n  .then(r => {\n    ALS = new r.AsyncLocalStorage<Scope | null>();\n  })\n  .catch(noop);\n\nexport class Scope {\n  /**\n   * @internal\n   */\n  id: number;\n\n  /**\n   * @internal\n   */\n  providers = new Map<any, any>();\n\n  /**\n   * @internal\n   */\n  parent: Scope | null = null;\n\n  /**\n   * @internal\n   */\n  cleanups: (() => void)[] = [];\n\n  /**\n   * @internal\n   */\n  private _activeRuns: number = 0;\n\n  constructor(public detached = false) {\n    this.id = ++idSec;\n\n    if (!detached) {\n      this.parent = getCurrentScope();\n    }\n  }\n\n  run<T>(fn: () => T): T {\n    this._activeRuns++;\n\n    const onComplete = ([err, result]: [Error | undefined, any]): T => {\n      this._activeRuns--;\n\n      if (this._activeRuns === 0) {\n        this.stop();\n      }\n\n      if (err) {\n        throw err;\n      }\n\n      return result;\n    };\n\n    const r = runInScope(this, fn);\n\n    if (isPromise<any>(r)) {\n      return r.then(onComplete) as T;\n    }\n\n    return onComplete(r);\n  }\n\n  stop() {\n    for (let i = 0, l = this.cleanups.length; i < l; i++) {\n      this.cleanups[i]();\n    }\n\n    this.cleanups.length = 0;\n  }\n\n  get active(): boolean {\n    return this._activeRuns > 0;\n  }\n}\n\n/**\n * @param detached - Can be used to create a \"detached\" scope.\n */\nexport function createScope(detached?: boolean): Scope {\n  return new Scope(detached);\n}\n\n/**\n * @group Main\n */\nexport function getCurrentScope(): Scope | null {\n  if (ALS) {\n    return ALS.getStore() ?? null;\n  }\n\n  return currentScope;\n}\n\nexport function setCurrentScope(scope: Scope) {\n  if (ALS) {\n    ALS.enterWith(scope);\n  } else {\n    currentScope = scope;\n  }\n}\n\nfunction runInScope<T>(\n  scope: Scope,\n  fn: () => T,\n): Awaitable<[Error | undefined, any]> {\n  if (ALS) {\n    return catchError(() => ALS!.run(scope, fn));\n  }\n\n  const prevScope = getCurrentScope();\n\n  const onComplete = ([err, result]: [Error | undefined, any]): [\n    Error | undefined,\n    any,\n  ] => {\n    if (prevScope) {\n      setCurrentScope(prevScope);\n    } else {\n      unsetCurrentScope();\n    }\n\n    return [err, result];\n  };\n\n  const result = catchError(fn);\n\n  if (isPromise<any>(result)) {\n    return result.then(onComplete);\n  }\n\n  return onComplete(result);\n}\n\nconst unsetCurrentScope = (): void => {\n  if (ALS) {\n    ALS.enterWith(null);\n  } else {\n    currentScope = null;\n  }\n};\n","import { captureStackTrace, isFunction } from '@andrew_l/toolkit';\nimport { Scope, getCurrentScope, setCurrentScope } from '../scope';\n\nexport type ProvideKey = symbol | string | number | object;\nexport type ProvideValue<T = unknown> = T | undefined;\nexport type InjectionKey = symbol | string | number | object;\n\n/**\n * To provide data to a descendants\n * @param enterWith Enter into injection context (Experimental)\n * @group Main\n */\nexport function provide(key: ProvideKey, value: any, enterWith?: boolean) {\n  let currentScope = getCurrentScope();\n\n  if (!currentScope) {\n    if (enterWith) {\n      currentScope = new Scope();\n      setCurrentScope(currentScope);\n    } else {\n      console.warn(\n        `provide() is called when there is no active scope to be associated with.\\n` +\n          captureStackTrace(provide),\n      );\n      return;\n    }\n  }\n\n  currentScope.providers.set(key, value);\n}\n\n/**\n * Inject previously provided data\n * @group Main\n */\nexport function inject<T = any>(\n  key: ProvideKey,\n  defaultValue?: T | (() => T),\n): ProvideValue<T> {\n  let currentScope = getCurrentScope();\n\n  if (!currentScope) {\n    console.warn(\n      `inject() is called when there is no active scope to be associated with.\\n` +\n        captureStackTrace(inject),\n    );\n    return;\n  }\n\n  const handled = new WeakSet();\n\n  let value;\n\n  do {\n    value = currentScope!.providers.get(key);\n    handled.add(currentScope!);\n    currentScope = currentScope!.parent;\n  } while (currentScope && value === undefined && !handled.has(currentScope));\n\n  if (value === undefined && defaultValue !== undefined) {\n    value = isFunction(defaultValue) ? defaultValue() : defaultValue;\n  }\n\n  return value;\n}\n\n/**\n * Returns true if `inject()` can be used without warning about being called in the wrong place.\n * @group Main\n */\nexport function hasInjectionContext() {\n  return !!getCurrentScope();\n}\n","import { type InjectionKey, inject, provide } from './provide';\n\n/**\n * Wrapper around `provide/inject` function to simple usage.\n *\n * @param providerName - The name(s) of the providing the context.\n *\n * There are situations where context can come from multiple scopes. In such cases, you might need to give an array of names to provide your context, instead of just a single string.\n *\n * @param contextName The description for injection key symbol.\n *\n * @example\n * const [injectTraceId, provideTraceId] = createContext<string>('withContext');\n *\n * // this function will returns the same trace if for execution context\n * export const useTraceId = () => {\n *   let traceId = injectTraceId(null);\n *\n *   if (!traceId) {\n *     traceId = uuidv4();\n *     provideTraceId(traceId);\n *   }\n *\n *   return traceId;\n * };\n *\n * @group Main\n */\nexport function createContext<ContextValue>(\n  providerName: string | string[],\n  contextName?: string,\n) {\n  const symbolDescription =\n    typeof providerName === 'string' && !contextName\n      ? `${providerName}Context`\n      : contextName;\n\n  const injectionKey: InjectionKey = Symbol(symbolDescription);\n\n  /**\n   * @param fallback The context value to return if the injection fails.\n   *\n   * @throws When context injection failed and no fallback is specified.\n   * This happens when the scope injecting the context is not a child of the root scope providing the context.\n   */\n  const injectContext = <\n    T extends ContextValue | null | undefined = ContextValue,\n  >(\n    fallback?: T | (() => T),\n  ): T extends null ? ContextValue | null : ContextValue => {\n    const context = inject(injectionKey, fallback);\n    if (context) return context;\n\n    if (context === null) return context as any;\n\n    throw new Error(\n      `Injection \\`${injectionKey.toString()}\\` not found. Must be used within ${\n        Array.isArray(providerName)\n          ? `one of the following providers: ${providerName.join(', ')}`\n          : `\\`${providerName}\\``\n      }`,\n    );\n  };\n\n  const provideContext = (contextValue: ContextValue) => {\n    provide(injectionKey, contextValue);\n    return contextValue;\n  };\n\n  return [injectContext, provideContext] as const;\n}\n","import { assert, captureStackTrace } from '@andrew_l/toolkit';\nimport { getCurrentScope } from '../scope';\n\n/**\n * The callback will be invoked when the associated context completes.\n *\n * @example\n * const fn = withContext(() => {\n *   onScopeDispose(() => {\n *     console.log(2);\n *   });\n *\n *   console.log(1);\n * });\n *\n * fn();\n *\n * console.log(3);\n *\n * // 1\n * // 2\n * // 3\n *\n * @group Main\n */\nexport function onScopeDispose(fn: () => void) {\n  const activeScope = getCurrentScope();\n\n  assert.ok(\n    activeScope,\n    'onScopeDispose() is called when there is no active scope to be associated with.' +\n      captureStackTrace(onScopeDispose),\n  );\n\n  activeScope.cleanups.push(fn);\n}\n","import { type AnyFunction, assert } from '@andrew_l/toolkit';\nimport { createScope, getCurrentScope } from './scope';\n\nexport * from './hooks/createContext';\nexport * from './hooks/onScopeDispose';\nexport * from './hooks/provide';\nexport { getCurrentScope } from './scope';\n\n/**\n * Creates a function within the injection context and returns its result. Providers/injections are only accessible within the callback function.\n * @param isolated Do not inject parent providers into this context (Default: `false`)\n *\n * @example\n * const main = withContext(() => {\n *     provide('user', { id: 1, name: 'Andrew' });\n *     doCoolStaff();\n * });\n *\n * const doCoolStaff = () => {\n *     const user = inject('user');\n *     console.log(user); // { id: 1, name: 'Andrew' }\n * };\n *\n * main();\n *\n * @group Main\n */\nexport function withContext<T extends AnyFunction>(fn: T, detached = false): T {\n  return function (this: any, ...args: any[]) {\n    const scope = createScope(detached);\n    return scope.run(fn.bind(this, ...args));\n  } as T;\n}\n\n/**\n * Runs a function within the injection context and returns its result. Providers/injections are only accessible inside the callback function.\n * @param isolated Do not inject parent providers into this context (Default: `false`)\n * @group Main\n */\nexport function runWithContext<T = any>(fn: () => T, isolated = false): T {\n  return withContext(fn, isolated)();\n}\n\n/**\n * Binds the current context to the provided function. Useful for creating callbacks with the current context, such as `setTimeout` or `EventEmitter` handlers.\n * @example\n * const main = withContext(() => {\n *   provide(\"user\", { id: 1, name: \"Andrew\" });\n *\n *   setInterval(bindContext(() => {\n *     const user = inject(\"user\");\n *     console.log(user); // { id: 1, name: 'Andrew' }\n *   }));\n * });\n *\n * main();\n *\n * @group Main\n */\nexport function bindContext<T>(fn: () => T): () => T {\n  const activeScope = getCurrentScope();\n\n  assert.ok(\n    activeScope,\n    'bindContext() is called when there is no active scope to be associated with.',\n  );\n\n  return () => activeScope.run(fn);\n}\n"],"mappings":";AAGA,IAAI,QAAQ;AACZ,IAAI;AACJ,IAAI,eAA6B;AAEjC,OAAO,mBAAmB,CACvB,MAAK,MAAK;CACT,MAAM,IAAI,EAAE,kBAAgC;AAC9C,CAAC,CAAC,CACD,MAAM,IAAI;AAEb,IAAa,QAAb,MAAmB;CA0BE;;CAtBnB,4BAAA,IAAA,IAAA;;CAKA,WAAA,CAAA;;;EAKA,KAAA,WAAuB;;;;CAKvB,IAAA,IAAA;;;;GAKQ,IAAA,KAAA,gBAAsB,GAAA,KAAA,KAAA;GAE9B,IAAA,KAAA,MAAmB;GAAA,OAAA;EACjB;EAEA,MAAK,IAAA,WACE,MAAA,EAAS;EAElB,IAAA,UAAA,CAAA,GAAA,OAAA,EAAA,KAAA,UAAA;EAEA,OAAuB,WAAA,CAAA;;QAGf;OACJ,IAAK,IAAA,GAAA,IAAA,KAAA,SAAA,QAAA,IAAA,GAAA,KAAA,KAAA,SAAA,EAAA,CAAA;OAED,SAAK,SAAA;;KAQT,SAAO;EACT,OAAA,KAAA,cAAA;;;SASF,YAAA,UAAA;CAEA,OAAO,IAAA,MAAA,QAAA;;SAMP,kBAAA;CAEA,IAAI,KAAA,OAAkB,IAAA,SAAA,KAAA;QACpB;;AAEJ,SAAA,gBAAA,OAAA;;;;AAKA,SAAgB,WAAA,OAAY,IAA2B;CACrD,IAAA,KAAO,OAAI,iBAAc,IAAA,IAAA,OAAA,EAAA,CAAA;CAC3B,MAAA,YAAA,gBAAA;;;;EAKA,OAAgB,CAAA,KAAA,MAAA;CACd;CAIA,MAAA,SAAO,WAAA,EAAA;CACT,IAAA,UAAA,MAAA,GAAA,OAAA,OAAA,KAAA,UAAA;CAEA,OAAA,WAAgB,MAAgB;;MAI5B,0BAAe;CAEnB,IAAA,KAAA,IAAA,UAAA,IAAA;MAEA,eACE;;SAaM,QACF,KAAA,OAAA,WAAgB;oBAEhB,gBAAkB;KAGpB,CAAA,cAAa,IAAM,WAAA;EACrB,eAAA,IAAA,MAAA;EAEA,gBAAe,YAAa;CAE5B,OAAI;EAIJ,QAAO,KAAA,+EAAiB,kBAAA,OAAA,CAAA;EAC1B;CAEA;CACE,aACM,UAAU,IAAI,KAAA,KAAA;;;;;;;;CCtItB,MAAA,0BAAqD,IAAA,QAAqB;CACxE,IAAI;CAEJ,GAAA;EAEI,QAAA,aAAmB,UAAM,IAAA,GAAA;EACzB,QAAA,IAAA,YAAgB;EAClB,eAAO,aAAA;UACG,gBACN,UAAA,KAAA,KAAA,CAAA,QAAA,IAAA,YAAA;KAGF,UAAA,KAAA,KAAA,iBAAA,KAAA,GAAA,QAAA,WAAA,YAAA,IAAA,aAAA,IAAA;CACF,OAAA;;;;;SAcE,cAAe,cAAgB,aAAA;CAEnC,MAAK,oBAAc,OAAA,iBAAA,YAAA,CAAA,cAAA,GAAA,aAAA,WAAA;OACjB,eACE,OAAA,iBAAA;CAIJ,MAAA,iBAAA,aAAA;EAEA,MAAM,UAAA,OAAA,cAAc,QAAQ;EAE5B,IAAI,SAAA,OAAA;EAEJ,IAAG,YAAA,MAAA,OAAA;EACD,MAAA,IAAQ,MAAA,eAAwB,aAAO,SAAA,EAAA,oCAAA,MAAA,QAAA,YAAA,IAAA,mCAAA,aAAA,KAAA,IAAA,MAAA,KAAA,aAAA,KAAA;;OAEvC,kBAAe,iBAAc;EAC/B,QAAS,cAAA,YAA0B;EAEnC,OAAI;CAIJ;CACF,OAAA,CAAA,eAAA,cAAA;;;CAMA,MAAA,cAAgB,gBAAsB;CACpC,OAAO,GAAE,aAAA,oFAAgB,kBAAA,cAAA,CAAA;CAC3B,YAAA,SAAA,KAAA,EAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@andrew_l/context",
-  "version": "0.3.21",
+  "version": "0.4.0",
   "description": "Like composition api but for Node.",
   "license": "MIT",
   "type": "module",
@@ -21,26 +21,27 @@
   "exports": {
     ".": {
       "import": "./dist/index.mjs",
-      "require": "./dist/index.cjs"
+      "require": "./dist/index.mjs",
+      "types": "./dist/index.d.mts"
     }
   },
-  "main": "./dist/index.cjs",
-  "types": "./dist/index.d.ts",
+  "main": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
   "files": [
     "dist"
   ],
   "devDependencies": {
     "@types/node": "22.10.5",
-    "typescript": "~5.8.3",
-    "unbuild": "3.5.0",
+    "obuild": "^0.4.37",
+    "typescript": "6.0.3",
     "vitest": "^3.2.4"
   },
   "dependencies": {
-    "@andrew_l/toolkit": "0.3.21"
+    "@andrew_l/toolkit": "0.4.0"
   },
   "scripts": {
     "check-types": "tsc --noEmit",
-    "build": "unbuild",
+    "build": "obuild",
     "test": "vitest run --typecheck",
     "test:watch": "vitest watch --typecheck"
   }

package/dist/index.cjs

@@ -1,205 +0,0 @@
-'use strict';
-
-const toolkit = require('@andrew_l/toolkit');
-
-let idSec = 0;
-let ALS;
-let currentScope = null;
-import('node:async_hooks').then((r) => {
-  ALS = new r.AsyncLocalStorage();
-}).catch(toolkit.noop);
-class Scope {
-  constructor(detached = false) {
-    this.detached = detached;
-    this.id = ++idSec;
-    if (!detached) {
-      this.parent = getCurrentScope();
-    }
-  }
-  /**
-   * @internal
-   */
-  id;
-  /**
-   * @internal
-   */
-  providers = /* @__PURE__ */ new Map();
-  /**
-   * @internal
-   */
-  parent = null;
-  /**
-   * @internal
-   */
-  cleanups = [];
-  /**
-   * @internal
-   */
-  _activeRuns = 0;
-  run(fn) {
-    this._activeRuns++;
-    const onComplete = ([err, result]) => {
-      this._activeRuns--;
-      if (this._activeRuns === 0) {
-        this.stop();
-      }
-      if (err) {
-        throw err;
-      }
-      return result;
-    };
-    const r = runInScope(this, fn);
-    if (toolkit.isPromise(r)) {
-      return r.then(onComplete);
-    }
-    return onComplete(r);
-  }
-  stop() {
-    for (let i = 0, l = this.cleanups.length; i < l; i++) {
-      this.cleanups[i]();
-    }
-    this.cleanups.length = 0;
-  }
-  get active() {
-    return this._activeRuns > 0;
-  }
-}
-function createScope(detached) {
-  return new Scope(detached);
-}
-function getCurrentScope() {
-  if (ALS) {
-    return ALS.getStore() ?? null;
-  }
-  return currentScope;
-}
-function setCurrentScope(scope) {
-  if (ALS) {
-    ALS.enterWith(scope);
-  } else {
-    currentScope = scope;
-  }
-}
-function runInScope(scope, fn) {
-  if (ALS) {
-    return toolkit.catchError(() => ALS.run(scope, fn));
-  }
-  const prevScope = getCurrentScope();
-  const onComplete = ([err, result2]) => {
-    if (prevScope) {
-      setCurrentScope(prevScope);
-    } else {
-      unsetCurrentScope();
-    }
-    return [err, result2];
-  };
-  const result = toolkit.catchError(fn);
-  if (toolkit.isPromise(result)) {
-    return result.then(onComplete);
-  }
-  return onComplete(result);
-}
-const unsetCurrentScope = () => {
-  if (ALS) {
-    ALS.enterWith(null);
-  } else {
-    currentScope = null;
-  }
-};
-
-function provide(key, value, enterWith) {
-  let currentScope = getCurrentScope();
-  if (!currentScope) {
-    if (enterWith) {
-      currentScope = new Scope();
-      setCurrentScope(currentScope);
-    } else {
-      console.warn(
-        `provide() is called when there is no active scope to be associated with.
-` + toolkit.captureStackTrace(provide)
-      );
-      return;
-    }
-  }
-  currentScope.providers.set(key, value);
-}
-function inject(key, defaultValue) {
-  let currentScope = getCurrentScope();
-  if (!currentScope) {
-    console.warn(
-      `inject() is called when there is no active scope to be associated with.
-` + toolkit.captureStackTrace(inject)
-    );
-    return;
-  }
-  const handled = /* @__PURE__ */ new WeakSet();
-  let value;
-  do {
-    value = currentScope.providers.get(key);
-    handled.add(currentScope);
-    currentScope = currentScope.parent;
-  } while (currentScope && value === void 0 && !handled.has(currentScope));
-  if (value === void 0 && defaultValue !== void 0) {
-    value = toolkit.isFunction(defaultValue) ? defaultValue() : defaultValue;
-  }
-  return value;
-}
-function hasInjectionContext() {
-  return !!getCurrentScope();
-}
-
-function createContext(providerName, contextName) {
-  const symbolDescription = typeof providerName === "string" && !contextName ? `${providerName}Context` : contextName;
-  const injectionKey = Symbol(symbolDescription);
-  const injectContext = (fallback) => {
-    const context = inject(injectionKey, fallback);
-    if (context) return context;
-    if (context === null) return context;
-    throw new Error(
-      `Injection \`${injectionKey.toString()}\` not found. Must be used within ${Array.isArray(providerName) ? `one of the following providers: ${providerName.join(", ")}` : `\`${providerName}\``}`
-    );
-  };
-  const provideContext = (contextValue) => {
-    provide(injectionKey, contextValue);
-    return contextValue;
-  };
-  return [injectContext, provideContext];
-}
-
-function onScopeDispose(fn) {
-  const activeScope = getCurrentScope();
-  toolkit.assert.ok(
-    activeScope,
-    "onScopeDispose() is called when there is no active scope to be associated with." + toolkit.captureStackTrace(onScopeDispose)
-  );
-  activeScope.cleanups.push(fn);
-}
-
-function withContext(fn, detached = false) {
-  return function(...args) {
-    const scope = createScope(detached);
-    return scope.run(fn.bind(this, ...args));
-  };
-}
-function runWithContext(fn, isolated = false) {
-  return withContext(fn, isolated)();
-}
-function bindContext(fn) {
-  const activeScope = getCurrentScope();
-  toolkit.assert.ok(
-    activeScope,
-    "bindContext() is called when there is no active scope to be associated with."
-  );
-  return () => activeScope.run(fn);
-}
-
-exports.bindContext = bindContext;
-exports.createContext = createContext;
-exports.getCurrentScope = getCurrentScope;
-exports.hasInjectionContext = hasInjectionContext;
-exports.inject = inject;
-exports.onScopeDispose = onScopeDispose;
-exports.provide = provide;
-exports.runWithContext = runWithContext;
-exports.withContext = withContext;
-//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.cjs","sources":["../src/scope.ts","../src/hooks/provide.ts","../src/hooks/createContext.ts","../src/hooks/onScopeDispose.ts","../src/index.ts"],"sourcesContent":["import { type Awaitable, catchError, isPromise, noop } from '@andrew_l/toolkit';\nimport type { AsyncLocalStorage } from 'node:async_hooks';\n\nlet idSec = 0;\nlet ALS: AsyncLocalStorage<Scope | null> | undefined;\nlet currentScope: Scope | null = null;\n\nimport('node:async_hooks')\n  .then(r => {\n    ALS = new r.AsyncLocalStorage<Scope | null>();\n  })\n  .catch(noop);\n\nexport class Scope {\n  /**\n   * @internal\n   */\n  id: number;\n\n  /**\n   * @internal\n   */\n  providers = new Map<any, any>();\n\n  /**\n   * @internal\n   */\n  parent: Scope | null = null;\n\n  /**\n   * @internal\n   */\n  cleanups: (() => void)[] = [];\n\n  /**\n   * @internal\n   */\n  private _activeRuns: number = 0;\n\n  constructor(public detached = false) {\n    this.id = ++idSec;\n\n    if (!detached) {\n      this.parent = getCurrentScope();\n    }\n  }\n\n  run<T>(fn: () => T): T {\n    this._activeRuns++;\n\n    const onComplete = ([err, result]: [Error | undefined, any]): T => {\n      this._activeRuns--;\n\n      if (this._activeRuns === 0) {\n        this.stop();\n      }\n\n      if (err) {\n        throw err;\n      }\n\n      return result;\n    };\n\n    const r = runInScope(this, fn);\n\n    if (isPromise<any>(r)) {\n      return r.then(onComplete) as T;\n    }\n\n    return onComplete(r);\n  }\n\n  stop() {\n    for (let i = 0, l = this.cleanups.length; i < l; i++) {\n      this.cleanups[i]();\n    }\n\n    this.cleanups.length = 0;\n  }\n\n  get active(): boolean {\n    return this._activeRuns > 0;\n  }\n}\n\n/**\n * @param detached - Can be used to create a \"detached\" scope.\n */\nexport function createScope(detached?: boolean): Scope {\n  return new Scope(detached);\n}\n\n/**\n * @group Main\n */\nexport function getCurrentScope(): Scope | null {\n  if (ALS) {\n    return ALS.getStore() ?? null;\n  }\n\n  return currentScope;\n}\n\nexport function setCurrentScope(scope: Scope) {\n  if (ALS) {\n    ALS.enterWith(scope);\n  } else {\n    currentScope = scope;\n  }\n}\n\nfunction runInScope<T>(\n  scope: Scope,\n  fn: () => T,\n): Awaitable<[Error | undefined, any]> {\n  if (ALS) {\n    return catchError(() => ALS!.run(scope, fn));\n  }\n\n  const prevScope = getCurrentScope();\n\n  const onComplete = ([err, result]: [Error | undefined, any]): [\n    Error | undefined,\n    any,\n  ] => {\n    if (prevScope) {\n      setCurrentScope(prevScope);\n    } else {\n      unsetCurrentScope();\n    }\n\n    return [err, result];\n  };\n\n  const result = catchError(fn);\n\n  if (isPromise<any>(result)) {\n    return result.then(onComplete);\n  }\n\n  return onComplete(result);\n}\n\nconst unsetCurrentScope = (): void => {\n  if (ALS) {\n    ALS.enterWith(null);\n  } else {\n    currentScope = null;\n  }\n};\n","import { captureStackTrace, isFunction } from '@andrew_l/toolkit';\nimport { Scope, getCurrentScope, setCurrentScope } from '../scope';\n\nexport type ProvideKey = symbol | string | number | object;\nexport type ProvideValue<T = unknown> = T | undefined;\nexport type InjectionKey = symbol | string | number | object;\n\n/**\n * To provide data to a descendants\n * @param enterWith Enter into injection context (Experimental)\n * @group Main\n */\nexport function provide(key: ProvideKey, value: any, enterWith?: boolean) {\n  let currentScope = getCurrentScope();\n\n  if (!currentScope) {\n    if (enterWith) {\n      currentScope = new Scope();\n      setCurrentScope(currentScope);\n    } else {\n      console.warn(\n        `provide() is called when there is no active scope to be associated with.\\n` +\n          captureStackTrace(provide),\n      );\n      return;\n    }\n  }\n\n  currentScope.providers.set(key, value);\n}\n\n/**\n * Inject previously provided data\n * @group Main\n */\nexport function inject<T = any>(\n  key: ProvideKey,\n  defaultValue?: T | (() => T),\n): ProvideValue<T> {\n  let currentScope = getCurrentScope();\n\n  if (!currentScope) {\n    console.warn(\n      `inject() is called when there is no active scope to be associated with.\\n` +\n        captureStackTrace(inject),\n    );\n    return;\n  }\n\n  const handled = new WeakSet();\n\n  let value;\n\n  do {\n    value = currentScope!.providers.get(key);\n    handled.add(currentScope!);\n    currentScope = currentScope!.parent;\n  } while (currentScope && value === undefined && !handled.has(currentScope));\n\n  if (value === undefined && defaultValue !== undefined) {\n    value = isFunction(defaultValue) ? defaultValue() : defaultValue;\n  }\n\n  return value;\n}\n\n/**\n * Returns true if `inject()` can be used without warning about being called in the wrong place.\n * @group Main\n */\nexport function hasInjectionContext() {\n  return !!getCurrentScope();\n}\n","import { type InjectionKey, inject, provide } from './provide';\n\n/**\n * Wrapper around `provide/inject` function to simple usage.\n *\n * @param providerName - The name(s) of the providing the context.\n *\n * There are situations where context can come from multiple scopes. In such cases, you might need to give an array of names to provide your context, instead of just a single string.\n *\n * @param contextName The description for injection key symbol.\n *\n * @example\n * const [injectTraceId, provideTraceId] = createContext<string>('withContext');\n *\n * // this function will returns the same trace if for execution context\n * export const useTraceId = () => {\n *   let traceId = injectTraceId(null);\n *\n *   if (!traceId) {\n *     traceId = uuidv4();\n *     provideTraceId(traceId);\n *   }\n *\n *   return traceId;\n * };\n *\n * @group Main\n */\nexport function createContext<ContextValue>(\n  providerName: string | string[],\n  contextName?: string,\n) {\n  const symbolDescription =\n    typeof providerName === 'string' && !contextName\n      ? `${providerName}Context`\n      : contextName;\n\n  const injectionKey: InjectionKey = Symbol(symbolDescription);\n\n  /**\n   * @param fallback The context value to return if the injection fails.\n   *\n   * @throws When context injection failed and no fallback is specified.\n   * This happens when the scope injecting the context is not a child of the root scope providing the context.\n   */\n  const injectContext = <\n    T extends ContextValue | null | undefined = ContextValue,\n  >(\n    fallback?: T | (() => T),\n  ): T extends null ? ContextValue | null : ContextValue => {\n    const context = inject(injectionKey, fallback);\n    if (context) return context;\n\n    if (context === null) return context as any;\n\n    throw new Error(\n      `Injection \\`${injectionKey.toString()}\\` not found. Must be used within ${\n        Array.isArray(providerName)\n          ? `one of the following providers: ${providerName.join(', ')}`\n          : `\\`${providerName}\\``\n      }`,\n    );\n  };\n\n  const provideContext = (contextValue: ContextValue) => {\n    provide(injectionKey, contextValue);\n    return contextValue;\n  };\n\n  return [injectContext, provideContext] as const;\n}\n","import { assert, captureStackTrace } from '@andrew_l/toolkit';\nimport { getCurrentScope } from '../scope';\n\n/**\n * The callback will be invoked when the associated context completes.\n *\n * @example\n * const fn = withContext(() => {\n *   onScopeDispose(() => {\n *     console.log(2);\n *   });\n *\n *   console.log(1);\n * });\n *\n * fn();\n *\n * console.log(3);\n *\n * // 1\n * // 2\n * // 3\n *\n * @group Main\n */\nexport function onScopeDispose(fn: () => void) {\n  const activeScope = getCurrentScope();\n\n  assert.ok(\n    activeScope,\n    'onScopeDispose() is called when there is no active scope to be associated with.' +\n      captureStackTrace(onScopeDispose),\n  );\n\n  activeScope.cleanups.push(fn);\n}\n","import { type AnyFunction, assert } from '@andrew_l/toolkit';\nimport { createScope, getCurrentScope } from './scope';\n\nexport * from './hooks/createContext';\nexport * from './hooks/onScopeDispose';\nexport * from './hooks/provide';\nexport { getCurrentScope } from './scope';\n\n/**\n * Creates a function within the injection context and returns its result. Providers/injections are only accessible within the callback function.\n * @param isolated Do not inject parent providers into this context (Default: `false`)\n *\n * @example\n * const main = withContext(() => {\n *     provide('user', { id: 1, name: 'Andrew' });\n *     doCoolStaff();\n * });\n *\n * const doCoolStaff = () => {\n *     const user = inject('user');\n *     console.log(user); // { id: 1, name: 'Andrew' }\n * };\n *\n * main();\n *\n * @group Main\n */\nexport function withContext<T extends AnyFunction>(fn: T, detached = false): T {\n  return function (this: any, ...args: any[]) {\n    const scope = createScope(detached);\n    return scope.run(fn.bind(this, ...args));\n  } as T;\n}\n\n/**\n * Runs a function within the injection context and returns its result. Providers/injections are only accessible inside the callback function.\n * @param isolated Do not inject parent providers into this context (Default: `false`)\n * @group Main\n */\nexport function runWithContext<T = any>(fn: () => T, isolated = false): T {\n  return withContext(fn, isolated)();\n}\n\n/**\n * Binds the current context to the provided function. Useful for creating callbacks with the current context, such as `setTimeout` or `EventEmitter` handlers.\n * @example\n * const main = withContext(() => {\n *   provide(\"user\", { id: 1, name: \"Andrew\" });\n *\n *   setInterval(bindContext(() => {\n *     const user = inject(\"user\");\n *     console.log(user); // { id: 1, name: 'Andrew' }\n *   }));\n * });\n *\n * main();\n *\n * @group Main\n */\nexport function bindContext<T>(fn: () => T): () => T {\n  const activeScope = getCurrentScope();\n\n  assert.ok(\n    activeScope,\n    'bindContext() is called when there is no active scope to be associated with.',\n  );\n\n  return () => activeScope.run(fn);\n}\n"],"names":["noop","isPromise","catchError","result","captureStackTrace","isFunction","assert"],"mappings":"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"}

package/dist/index.d.cts

@@ -1,151 +0,0 @@
-import { AnyFunction } from '@andrew_l/toolkit';
-
-/**
- * Wrapper around `provide/inject` function to simple usage.
- *
- * @param providerName - The name(s) of the providing the context.
- *
- * There are situations where context can come from multiple scopes. In such cases, you might need to give an array of names to provide your context, instead of just a single string.
- *
- * @param contextName The description for injection key symbol.
- *
- * @example
- * const [injectTraceId, provideTraceId] = createContext<string>('withContext');
- *
- * // this function will returns the same trace if for execution context
- * export const useTraceId = () => {
- *   let traceId = injectTraceId(null);
- *
- *   if (!traceId) {
- *     traceId = uuidv4();
- *     provideTraceId(traceId);
- *   }
- *
- *   return traceId;
- * };
- *
- * @group Main
- */
-declare function createContext<ContextValue>(providerName: string | string[], contextName?: string): readonly [<T extends ContextValue | null | undefined = ContextValue>(fallback?: T | (() => T)) => T extends null ? ContextValue | null : ContextValue, (contextValue: ContextValue) => ContextValue];
-
-/**
- * The callback will be invoked when the associated context completes.
- *
- * @example
- * const fn = withContext(() => {
- *   onScopeDispose(() => {
- *     console.log(2);
- *   });
- *
- *   console.log(1);
- * });
- *
- * fn();
- *
- * console.log(3);
- *
- * // 1
- * // 2
- * // 3
- *
- * @group Main
- */
-declare function onScopeDispose(fn: () => void): void;
-
-type ProvideKey = symbol | string | number | object;
-type ProvideValue<T = unknown> = T | undefined;
-type InjectionKey = symbol | string | number | object;
-/**
- * To provide data to a descendants
- * @param enterWith Enter into injection context (Experimental)
- * @group Main
- */
-declare function provide(key: ProvideKey, value: any, enterWith?: boolean): void;
-/**
- * Inject previously provided data
- * @group Main
- */
-declare function inject<T = any>(key: ProvideKey, defaultValue?: T | (() => T)): ProvideValue<T>;
-/**
- * Returns true if `inject()` can be used without warning about being called in the wrong place.
- * @group Main
- */
-declare function hasInjectionContext(): boolean;
-
-declare class Scope {
-    detached: boolean;
-    /**
-     * @internal
-     */
-    id: number;
-    /**
-     * @internal
-     */
-    providers: Map<any, any>;
-    /**
-     * @internal
-     */
-    parent: Scope | null;
-    /**
-     * @internal
-     */
-    cleanups: (() => void)[];
-    /**
-     * @internal
-     */
-    private _activeRuns;
-    constructor(detached?: boolean);
-    run<T>(fn: () => T): T;
-    stop(): void;
-    get active(): boolean;
-}
-/**
- * @group Main
- */
-declare function getCurrentScope(): Scope | null;
-
-/**
- * Creates a function within the injection context and returns its result. Providers/injections are only accessible within the callback function.
- * @param isolated Do not inject parent providers into this context (Default: `false`)
- *
- * @example
- * const main = withContext(() => {
- *     provide('user', { id: 1, name: 'Andrew' });
- *     doCoolStaff();
- * });
- *
- * const doCoolStaff = () => {
- *     const user = inject('user');
- *     console.log(user); // { id: 1, name: 'Andrew' }
- * };
- *
- * main();
- *
- * @group Main
- */
-declare function withContext<T extends AnyFunction>(fn: T, detached?: boolean): T;
-/**
- * Runs a function within the injection context and returns its result. Providers/injections are only accessible inside the callback function.
- * @param isolated Do not inject parent providers into this context (Default: `false`)
- * @group Main
- */
-declare function runWithContext<T = any>(fn: () => T, isolated?: boolean): T;
-/**
- * Binds the current context to the provided function. Useful for creating callbacks with the current context, such as `setTimeout` or `EventEmitter` handlers.
- * @example
- * const main = withContext(() => {
- *   provide("user", { id: 1, name: "Andrew" });
- *
- *   setInterval(bindContext(() => {
- *     const user = inject("user");
- *     console.log(user); // { id: 1, name: 'Andrew' }
- *   }));
- * });
- *
- * main();
- *
- * @group Main
- */
-declare function bindContext<T>(fn: () => T): () => T;
-
-export { type InjectionKey, type ProvideKey, type ProvideValue, bindContext, createContext, getCurrentScope, hasInjectionContext, inject, onScopeDispose, provide, runWithContext, withContext };

package/dist/index.d.ts

@@ -1,151 +0,0 @@
-import { AnyFunction } from '@andrew_l/toolkit';
-
-/**
- * Wrapper around `provide/inject` function to simple usage.
- *
- * @param providerName - The name(s) of the providing the context.
- *
- * There are situations where context can come from multiple scopes. In such cases, you might need to give an array of names to provide your context, instead of just a single string.
- *
- * @param contextName The description for injection key symbol.
- *
- * @example
- * const [injectTraceId, provideTraceId] = createContext<string>('withContext');
- *
- * // this function will returns the same trace if for execution context
- * export const useTraceId = () => {
- *   let traceId = injectTraceId(null);
- *
- *   if (!traceId) {
- *     traceId = uuidv4();
- *     provideTraceId(traceId);
- *   }
- *
- *   return traceId;
- * };
- *
- * @group Main
- */
-declare function createContext<ContextValue>(providerName: string | string[], contextName?: string): readonly [<T extends ContextValue | null | undefined = ContextValue>(fallback?: T | (() => T)) => T extends null ? ContextValue | null : ContextValue, (contextValue: ContextValue) => ContextValue];
-
-/**
- * The callback will be invoked when the associated context completes.
- *
- * @example
- * const fn = withContext(() => {
- *   onScopeDispose(() => {
- *     console.log(2);
- *   });
- *
- *   console.log(1);
- * });
- *
- * fn();
- *
- * console.log(3);
- *
- * // 1
- * // 2
- * // 3
- *
- * @group Main
- */
-declare function onScopeDispose(fn: () => void): void;
-
-type ProvideKey = symbol | string | number | object;
-type ProvideValue<T = unknown> = T | undefined;
-type InjectionKey = symbol | string | number | object;
-/**
- * To provide data to a descendants
- * @param enterWith Enter into injection context (Experimental)
- * @group Main
- */
-declare function provide(key: ProvideKey, value: any, enterWith?: boolean): void;
-/**
- * Inject previously provided data
- * @group Main
- */
-declare function inject<T = any>(key: ProvideKey, defaultValue?: T | (() => T)): ProvideValue<T>;
-/**
- * Returns true if `inject()` can be used without warning about being called in the wrong place.
- * @group Main
- */
-declare function hasInjectionContext(): boolean;
-
-declare class Scope {
-    detached: boolean;
-    /**
-     * @internal
-     */
-    id: number;
-    /**
-     * @internal
-     */
-    providers: Map<any, any>;
-    /**
-     * @internal
-     */
-    parent: Scope | null;
-    /**
-     * @internal
-     */
-    cleanups: (() => void)[];
-    /**
-     * @internal
-     */
-    private _activeRuns;
-    constructor(detached?: boolean);
-    run<T>(fn: () => T): T;
-    stop(): void;
-    get active(): boolean;
-}
-/**
- * @group Main
- */
-declare function getCurrentScope(): Scope | null;
-
-/**
- * Creates a function within the injection context and returns its result. Providers/injections are only accessible within the callback function.
- * @param isolated Do not inject parent providers into this context (Default: `false`)
- *
- * @example
- * const main = withContext(() => {
- *     provide('user', { id: 1, name: 'Andrew' });
- *     doCoolStaff();
- * });
- *
- * const doCoolStaff = () => {
- *     const user = inject('user');
- *     console.log(user); // { id: 1, name: 'Andrew' }
- * };
- *
- * main();
- *
- * @group Main
- */
-declare function withContext<T extends AnyFunction>(fn: T, detached?: boolean): T;
-/**
- * Runs a function within the injection context and returns its result. Providers/injections are only accessible inside the callback function.
- * @param isolated Do not inject parent providers into this context (Default: `false`)
- * @group Main
- */
-declare function runWithContext<T = any>(fn: () => T, isolated?: boolean): T;
-/**
- * Binds the current context to the provided function. Useful for creating callbacks with the current context, such as `setTimeout` or `EventEmitter` handlers.
- * @example
- * const main = withContext(() => {
- *   provide("user", { id: 1, name: "Andrew" });
- *
- *   setInterval(bindContext(() => {
- *     const user = inject("user");
- *     console.log(user); // { id: 1, name: 'Andrew' }
- *   }));
- * });
- *
- * main();
- *
- * @group Main
- */
-declare function bindContext<T>(fn: () => T): () => T;
-
-export { type InjectionKey, type ProvideKey, type ProvideValue, bindContext, createContext, getCurrentScope, hasInjectionContext, inject, onScopeDispose, provide, runWithContext, withContext };