@logtape/logtape 2.3.0-dev.791 → 2.3.0-dev.792

package/README.md

@@ -47,9 +47,8 @@ The highlights of LogTape are:
  -  *[Dead simple sinks]*: You can easily add your own sinks to LogTape.
 
  -  *[Framework integrations]*: First-class support for popular frameworks
-    like [Express], [Fastify], [GraphQL Yoga], [Hono], [Koa], and [Drizzle ORM]
-    with automatic HTTP request logging, GraphQL server logging, and database
-    query logging.
+    like [Express], [Fastify], [Hono], [Koa], and [Drizzle ORM] with automatic
+    HTTP request logging and database query logging.
 
 ![LogTape web console output](https://raw.githubusercontent.com/dahlia/logtape/refs/heads/main/screenshots/web-console.png)
 ![LogTape terminal output](https://raw.githubusercontent.com/dahlia/logtape/refs/heads/main/screenshots/terminal.png)
@@ -74,7 +73,6 @@ The highlights of LogTape are:
 [Framework integrations]: https://logtape.org/manual/integrations
 [Express]: https://expressjs.com/
 [Fastify]: https://fastify.dev/
-[GraphQL Yoga]: https://the-guild.dev/graphql/yoga-server
 [Hono]: https://hono.dev/
 [Koa]: https://koajs.com/
 [Drizzle ORM]: https://orm.drizzle.team/
@@ -118,7 +116,6 @@ list of the packages in the LogTape monorepo:
 | [*@logtape/elysia*](/packages/elysia/)                     | [JSR][jsr:@logtape/elysia]           | [npm][npm:@logtape/elysia]           | [Elysia] integration          |
 | [*@logtape/express*](/packages/express/)                   | [JSR][jsr:@logtape/express]          | [npm][npm:@logtape/express]          | [Express] integration         |
 | [*@logtape/fastify*](/packages/fastify/)                   | [JSR][jsr:@logtape/fastify]          | [npm][npm:@logtape/fastify]          | [Fastify] integration         |
-| [*@logtape/graphql-yoga*](/packages/graphql-yoga/)         | [JSR][jsr:@logtape/graphql-yoga]     | [npm][npm:@logtape/graphql-yoga]     | [GraphQL Yoga] integration    |
 | [*@logtape/hono*](/packages/hono/)                         | [JSR][jsr:@logtape/hono]             | [npm][npm:@logtape/hono]             | [Hono] integration            |
 | [*@logtape/koa*](/packages/koa/)                           | [JSR][jsr:@logtape/koa]              | [npm][npm:@logtape/koa]              | [Koa] integration             |
 | [*@logtape/lint*](/packages/lint/)                         | [JSR][jsr:@logtape/lint]             | [npm][npm:@logtape/lint]             | ESLint/Oxlint/Deno Lint rules |
@@ -159,8 +156,6 @@ list of the packages in the LogTape monorepo:
 [npm:@logtape/express]: https://www.npmjs.com/package/@logtape/express
 [jsr:@logtape/fastify]: https://jsr.io/@logtape/fastify
 [npm:@logtape/fastify]: https://www.npmjs.com/package/@logtape/fastify
-[jsr:@logtape/graphql-yoga]: https://jsr.io/@logtape/graphql-yoga
-[npm:@logtape/graphql-yoga]: https://www.npmjs.com/package/@logtape/graphql-yoga
 [jsr:@logtape/hono]: https://jsr.io/@logtape/hono
 [npm:@logtape/hono]: https://www.npmjs.com/package/@logtape/hono
 [jsr:@logtape/koa]: https://jsr.io/@logtape/koa

package/dist/config.cjs

@@ -1,4 +1,5 @@
 const require_filter = require('./filter.cjs');
+const require_scoped_config = require('./scoped-config.cjs');
 const require_logger = require('./logger.cjs');
 const require_sink = require('./sink.cjs');
 
@@ -7,6 +8,7 @@ const require_sink = require('./sink.cjs');
 * The current configuration, if any.  Otherwise, `null`.
 */
 let currentConfig = null;
+let activeScopedConfigCount = 0;
 /**
 * Strong references to the loggers.
 * This is to prevent the loggers from being garbage collected so that their
@@ -91,6 +93,7 @@ function registerDisposeHook(allowAsync) {
 * @param config The configuration.
 */
 async function configure(config) {
+	assertNoScopedConfig("configure()");
 	if (currentConfig != null && !config.reset) throw new ConfigError("Already configured; if you want to reset, turn on the reset flag.");
 	await reset();
 	try {
@@ -134,6 +137,7 @@ async function configure(config) {
 * @since 0.9.0
 */
 function configureSync(config) {
+	assertNoScopedConfig("configureSync()");
 	if (currentConfig != null && !config.reset) throw new ConfigError("Already configured; if you want to reset, turn on the reset flag.");
 	if (asyncFilterDisposables.size > 0 || asyncSinkDisposables.size > 0) throw new ConfigError("Previously configured async disposables are still active. Use configure() instead or explicitly dispose them using dispose().");
 	resetSync();
@@ -144,6 +148,86 @@ function configureSync(config) {
 		throw e;
 	}
 }
+/**
+* Runs a callback with a LogTape configuration scoped to the current execution
+* context.
+*
+* The process-global configuration must already provide
+* `contextLocalStorage`.  The scoped configuration fully overrides global
+* logger routing while the callback and its async work run.
+*
+* @param config The scoped configuration.
+* @param callback The callback to run.
+* @returns The callback's resolved return value.
+* @since 2.3.0
+*/
+async function withConfig(config, callback) {
+	const contextLocalStorage = getConfiguredContextLocalStorage("withConfig()");
+	const scopedConfig = require_scoped_config.compileScopedConfig(config, true, (message) => new ConfigError(message));
+	let result;
+	let callbackError;
+	let callbackFailed = false;
+	activeScopedConfigCount++;
+	try {
+		result = await require_scoped_config.runWithScopedConfig(contextLocalStorage, scopedConfig, callback);
+	} catch (error) {
+		callbackFailed = true;
+		callbackError = error;
+	}
+	try {
+		await require_scoped_config.disposeScopedConfig(scopedConfig);
+	} catch (disposeError) {
+		if (callbackFailed) require_scoped_config.throwCombinedErrors(callbackError, disposeError);
+		throw disposeError;
+	} finally {
+		activeScopedConfigCount--;
+	}
+	if (callbackFailed) throw callbackError;
+	return result;
+}
+/**
+* Runs a synchronous callback with a LogTape configuration scoped to the
+* current execution context.
+*
+* The scoped configuration must not contain async disposable sinks or filters.
+*
+* @param config The scoped configuration.
+* @param callback The callback to run.
+* @returns The callback's return value.
+* @since 2.3.0
+*/
+function withConfigSync(config, callback) {
+	const contextLocalStorage = getConfiguredContextLocalStorage("withConfigSync()");
+	const scopedConfig = require_scoped_config.compileScopedConfig(config, false, (message) => new ConfigError(message));
+	let result;
+	let callbackError;
+	let callbackFailed = false;
+	activeScopedConfigCount++;
+	try {
+		result = require_scoped_config.runWithScopedConfig(contextLocalStorage, scopedConfig, callback);
+		if (isThenable(result)) {
+			Promise.resolve(result).catch(() => {});
+			callbackFailed = true;
+			callbackError = new ConfigError("withConfigSync() callback must not return a promise. Use withConfig() for async callbacks.");
+		}
+	} catch (error) {
+		callbackFailed = true;
+		callbackError = error;
+	}
+	try {
+		require_scoped_config.disposeScopedConfigSync(scopedConfig);
+	} catch (disposeError) {
+		if (callbackFailed) require_scoped_config.throwCombinedErrors(callbackError, disposeError);
+		throw disposeError;
+	} finally {
+		activeScopedConfigCount--;
+	}
+	if (callbackFailed) throw callbackError;
+	return result;
+}
+function isThenable(value) {
+	return value != null && (typeof value === "object" || typeof value === "function") && "then" in value && typeof value.then === "function";
+}
 function configureInternal(config, allowAsync) {
 	currentConfig = config;
 	let metaConfigured = false;
@@ -205,6 +289,7 @@ function getConfig() {
 * Reset the configuration.  Mostly for testing purposes.
 */
 async function reset() {
+	assertNoScopedConfig("reset()");
 	await dispose();
 	resetInternal();
 }
@@ -214,6 +299,7 @@ async function reset() {
 * @since 0.9.0
 */
 function resetSync() {
+	assertNoScopedConfig("resetSync()");
 	disposeSync();
 	resetInternal();
 }
@@ -228,6 +314,7 @@ function resetInternal() {
 * Dispose of the disposables.
 */
 async function dispose() {
+	assertNoScopedConfig("dispose()");
 	const errors = [];
 	try {
 		disposeSyncFilters();
@@ -257,6 +344,7 @@ async function dispose() {
 * @since 0.9.0
 */
 function disposeSync() {
+	assertNoScopedConfig("disposeSync()");
 	const errors = [];
 	try {
 		disposeSyncFilters();
@@ -270,6 +358,15 @@ function disposeSync() {
 	}
 	throwDisposeErrors(errors);
 }
+function getConfiguredContextLocalStorage(functionName) {
+	if (currentConfig == null) throw new ConfigError(`${functionName} requires LogTape to be configured first.`);
+	const contextLocalStorage = require_logger.LoggerImpl.getLogger().contextLocalStorage;
+	if (contextLocalStorage == null) throw new ConfigError(`${functionName} requires Config.contextLocalStorage to be configured.`);
+	return contextLocalStorage;
+}
+function assertNoScopedConfig(functionName) {
+	if (activeScopedConfigCount > 0) throw new ConfigError(`${functionName} cannot be called while a scoped configuration is active. Use nested withConfig() instead.`);
+}
 function disposeSyncFilters() {
 	disposeSyncDisposables(filterDisposables);
 }
@@ -343,4 +440,6 @@ exports.dispose = dispose;
 exports.disposeSync = disposeSync;
 exports.getConfig = getConfig;
 exports.reset = reset;
-exports.resetSync = resetSync;
+exports.resetSync = resetSync;
+exports.withConfig = withConfig;
+exports.withConfigSync = withConfigSync;

package/dist/config.d.cts

@@ -2,6 +2,7 @@ import { ContextLocalStorage } from "./context.cjs";
 import { LogLevel } from "./level.cjs";
 import { FilterLike } from "./filter.cjs";
 import { Sink } from "./sink.cjs";
+import { ScopedConfigLike } from "./scoped-config.cjs";
 
 //#region src/config.d.ts
 
@@ -33,6 +34,18 @@ interface Config<TSinkId extends string, TFilterId extends string> {
    */
   reset?: boolean;
 }
+/**
+ * A scoped configuration for the current execution context.
+ *
+ * Unlike {@link Config}, this type does not include `reset` or
+ * `contextLocalStorage`.  Scoped configuration changes only the logging policy
+ * for a callback; the context-local storage must already be initialized by the
+ * process-global configuration.
+ *
+ * @since 2.3.0
+ */
+type ScopedConfig<TSinkId extends string, TFilterId extends string> = ScopedConfigLike<TSinkId, TFilterId>;
+type SyncCallbackResult<TResult> = TResult extends PromiseLike<unknown> ? never : TResult;
 /**
  * A logger configuration.
  */
@@ -141,6 +154,32 @@ declare function configure<TSinkId extends string, TFilterId extends string>(con
  * @since 0.9.0
  */
 declare function configureSync<TSinkId extends string, TFilterId extends string>(config: Config<TSinkId, TFilterId>): void;
+/**
+ * Runs a callback with a LogTape configuration scoped to the current execution
+ * context.
+ *
+ * The process-global configuration must already provide
+ * `contextLocalStorage`.  The scoped configuration fully overrides global
+ * logger routing while the callback and its async work run.
+ *
+ * @param config The scoped configuration.
+ * @param callback The callback to run.
+ * @returns The callback's resolved return value.
+ * @since 2.3.0
+ */
+declare function withConfig<TSinkId extends string, TFilterId extends string, TResult>(config: ScopedConfig<TSinkId, TFilterId>, callback: () => TResult): Promise<Awaited<TResult>>;
+/**
+ * Runs a synchronous callback with a LogTape configuration scoped to the
+ * current execution context.
+ *
+ * The scoped configuration must not contain async disposable sinks or filters.
+ *
+ * @param config The scoped configuration.
+ * @param callback The callback to run.
+ * @returns The callback's return value.
+ * @since 2.3.0
+ */
+declare function withConfigSync<TSinkId extends string, TFilterId extends string, TResult>(config: ScopedConfig<TSinkId, TFilterId>, callback: () => SyncCallbackResult<TResult>): SyncCallbackResult<TResult>;
 /**
  * Get the current configuration, if any.  Otherwise, `null`.
  * @returns The current configuration, if any.  Otherwise, `null`.
@@ -176,7 +215,6 @@ declare class ConfigError extends Error {
    */
   constructor(message: string);
 }
-//# sourceMappingURL=config.d.ts.map
 //#endregion
-export { Config, ConfigError, LoggerConfig, configure, configureSync, dispose, disposeSync, getConfig, reset, resetSync };
+export { Config, ConfigError, LoggerConfig, ScopedConfig, configure, configureSync, dispose, disposeSync, getConfig, reset, resetSync, withConfig, withConfigSync };
 //# sourceMappingURL=config.d.cts.map

package/dist/config.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.cts","names":[],"sources":["../src/config.ts"],"sourcesContent":[],"mappings":";;;;;;;;;AASA;AAAuB,UAAN,MAAM,CAAA,gBAAA,MAAA,EAAA,kBAAA,MAAA,CAAA,CAAA;EAAA;;;;EAUK,KAAE,EALrB,MAKqB,CALd,OAKc,EALL,IAKK,CAAA;EAAU;;;;EAKjB,OAMqB,CAAA,EAXhC,MAWgC,CAXzB,SAWyB,EAXd,UAWc,CAAA;EAAM;AAAP;AAW3C;EAA6B,OAAA,EAjBlB,YAiBkB,CAjBL,OAiBK,EAjBI,SAiBJ,CAAA,EAAA;EAAA;;;AAoCL;EAwHF,mBAAS,CAAA,EAvKP,mBAuKO,CAvKa,MAuKb,CAAA,MAAA,EAAA,OAAA,CAAA,CAAA;EAAA;;;EAGI,KAAzB,CAAA,EAAA,OAAA;;AAAoC;AAgD9C;;AACiB,UAhNA,YAgNA,CAAA,gBAAA,MAAA,EAAA,kBAAA,MAAA,CAAA,CAAA;EAAO;;AAAR;AA4HhB;EAOsB,QAAK,EAAA,MAAA,GAAI,MAAA,EAAO;EAUtB;AAgBhB;AA8BA;EA8Fa,KAAA,CAAA,EA5dH,OA4de,EAAA;;;;;;;;;;;;;;YA5cb;;;;;;gBAOI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAwHM,oEAGZ,OAAO,SAAS,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAgDvB,wEACN,OAAO,SAAS;;;;;iBA4HV,SAAA,CAAA,GAAa;;;;iBAOP,KAAA,CAAA,GAAS;;;;;;iBAUf,SAAA,CAAA;;;;iBAgBM,OAAA,CAAA,GAAW;;;;;;iBA8BjB,WAAA,CAAA;;;;cA8FH,WAAA,SAAoB,KAAK"}
+{"version":3,"file":"config.d.cts","names":[],"sources":["../src/config.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;AAiBA;AAAuB,UAAN,MAAM,CAAA,gBAAA,MAAA,EAAA,kBAAA,MAAA,CAAA,CAAA;EAAA;;;;EAUK,KAAE,EALrB,MAKqB,CALd,OAKc,EALL,IAKK,CAAA;EAAU;;;;EAKjB,OAMqB,CAAA,EAXhC,MAWgC,CAXzB,SAWyB,EAXd,UAWc,CAAA;EAAM;AAAP;AAkB3C;EAAwB,OAAA,EAxBb,YAwBa,CAxBA,OAwBA,EAxBS,SAwBT,CAAA,EAAA;EAAA;;;AACN;EAEb,mBAAA,CAAA,EArBmB,mBAqBD,CArBqB,MAqBrB,CAAA,MAAA,EAAA,OAAA,CAAA,CAAA;EAAA;;;EAAuC,KAC1D,CAAA,EAAA,OAAA;AAAO;AAKX;;;;;AAoCwB;AAyHxB;;;;AAGU,KAzKE,YAyKF,CAAA,gBAAA,MAAA,EAAA,kBAAA,MAAA,CAAA,GAxKR,gBAwKQ,CAxKS,OAwKT,EAxKkB,SAwKlB,CAAA;KAtKL,kBAsKkC,CAAA,OAAA,CAAA,GAtKJ,OAsKI,SAtKY,WAsKZ,CAAA,OAAA,CAAA,GAAA,KAAA,GArKnC,OAqKmC;AAAO;AAiD9C;;AACiB,UAlNA,YAkNA,CAAA,gBAAA,MAAA,EAAA,kBAAA,MAAA,CAAA,CAAA;EAAO;;AAAR;AAoChB;EAAgC,QAAA,EAAA,MAAA,GAAA,MAAA,EAAA;EAAA;;;EAKV,KACJ,CAAA,EA/OR,OA+OQ,EAAA;EAAO;;;AACf;AAiDV;;;;;EAKsB,WACe,CAAA,EAAA,SAAA,GAAA,UAAA;EAAO;;;EACvB,OAAA,CAAA,EAxRT,SAwRS,EAAA;EAyJL;AAOhB;AAWA;AAiBA;AA+BA;EAyHa,WAAA,CAAA,EArmBG,QAqmBS,GAAQ,IAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA5eX,oEAGZ,OAAO,SAAS,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiDvB,wEACN,OAAO,SAAS;;;;;;;;;;;;;;iBAoCJ,8EAKZ,aAAa,SAAS,4BACd,UACf,QAAQ,QAAQ;;;;;;;;;;;;iBAiDH,kFAKN,aAAa,SAAS,4BACd,mBAAmB,WAClC,mBAAmB;;;;;iBAyJN,SAAA,CAAA,GAAa;;;;iBAOP,KAAA,CAAA,GAAS;;;;;;iBAWf,SAAA,CAAA;;;;iBAiBM,OAAA,CAAA,GAAW;;;;;;iBA+BjB,WAAA,CAAA;;;;cAyHH,WAAA,SAAoB,KAAK"}

package/dist/config.d.ts

@@ -2,6 +2,7 @@ import { ContextLocalStorage } from "./context.js";
 import { LogLevel } from "./level.js";
 import { FilterLike } from "./filter.js";
 import { Sink } from "./sink.js";
+import { ScopedConfigLike } from "./scoped-config.js";
 
 //#region src/config.d.ts
 
@@ -33,6 +34,18 @@ interface Config<TSinkId extends string, TFilterId extends string> {
    */
   reset?: boolean;
 }
+/**
+ * A scoped configuration for the current execution context.
+ *
+ * Unlike {@link Config}, this type does not include `reset` or
+ * `contextLocalStorage`.  Scoped configuration changes only the logging policy
+ * for a callback; the context-local storage must already be initialized by the
+ * process-global configuration.
+ *
+ * @since 2.3.0
+ */
+type ScopedConfig<TSinkId extends string, TFilterId extends string> = ScopedConfigLike<TSinkId, TFilterId>;
+type SyncCallbackResult<TResult> = TResult extends PromiseLike<unknown> ? never : TResult;
 /**
  * A logger configuration.
  */
@@ -141,6 +154,32 @@ declare function configure<TSinkId extends string, TFilterId extends string>(con
  * @since 0.9.0
  */
 declare function configureSync<TSinkId extends string, TFilterId extends string>(config: Config<TSinkId, TFilterId>): void;
+/**
+ * Runs a callback with a LogTape configuration scoped to the current execution
+ * context.
+ *
+ * The process-global configuration must already provide
+ * `contextLocalStorage`.  The scoped configuration fully overrides global
+ * logger routing while the callback and its async work run.
+ *
+ * @param config The scoped configuration.
+ * @param callback The callback to run.
+ * @returns The callback's resolved return value.
+ * @since 2.3.0
+ */
+declare function withConfig<TSinkId extends string, TFilterId extends string, TResult>(config: ScopedConfig<TSinkId, TFilterId>, callback: () => TResult): Promise<Awaited<TResult>>;
+/**
+ * Runs a synchronous callback with a LogTape configuration scoped to the
+ * current execution context.
+ *
+ * The scoped configuration must not contain async disposable sinks or filters.
+ *
+ * @param config The scoped configuration.
+ * @param callback The callback to run.
+ * @returns The callback's return value.
+ * @since 2.3.0
+ */
+declare function withConfigSync<TSinkId extends string, TFilterId extends string, TResult>(config: ScopedConfig<TSinkId, TFilterId>, callback: () => SyncCallbackResult<TResult>): SyncCallbackResult<TResult>;
 /**
  * Get the current configuration, if any.  Otherwise, `null`.
  * @returns The current configuration, if any.  Otherwise, `null`.
@@ -176,7 +215,6 @@ declare class ConfigError extends Error {
    */
   constructor(message: string);
 }
-//# sourceMappingURL=config.d.ts.map
 //#endregion
-export { Config, ConfigError, LoggerConfig, configure, configureSync, dispose, disposeSync, getConfig, reset, resetSync };
+export { Config, ConfigError, LoggerConfig, ScopedConfig, configure, configureSync, dispose, disposeSync, getConfig, reset, resetSync, withConfig, withConfigSync };
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","names":[],"sources":["../src/config.ts"],"sourcesContent":[],"mappings":";;;;;;;;;AASA;AAAuB,UAAN,MAAM,CAAA,gBAAA,MAAA,EAAA,kBAAA,MAAA,CAAA,CAAA;EAAA;;;;EAUK,KAAE,EALrB,MAKqB,CALd,OAKc,EALL,IAKK,CAAA;EAAU;;;;EAKjB,OAMqB,CAAA,EAXhC,MAWgC,CAXzB,SAWyB,EAXd,UAWc,CAAA;EAAM;AAAP;AAW3C;EAA6B,OAAA,EAjBlB,YAiBkB,CAjBL,OAiBK,EAjBI,SAiBJ,CAAA,EAAA;EAAA;;;AAoCL;EAwHF,mBAAS,CAAA,EAvKP,mBAuKO,CAvKa,MAuKb,CAAA,MAAA,EAAA,OAAA,CAAA,CAAA;EAAA;;;EAGI,KAAzB,CAAA,EAAA,OAAA;;AAAoC;AAgD9C;;AACiB,UAhNA,YAgNA,CAAA,gBAAA,MAAA,EAAA,kBAAA,MAAA,CAAA,CAAA;EAAO;;AAAR;AA4HhB;EAOsB,QAAK,EAAA,MAAA,GAAI,MAAA,EAAO;EAUtB;AAgBhB;AA8BA;EA8Fa,KAAA,CAAA,EA5dH,OA4de,EAAA;;;;;;;;;;;;;;YA5cb;;;;;;gBAOI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAwHM,oEAGZ,OAAO,SAAS,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAgDvB,wEACN,OAAO,SAAS;;;;;iBA4HV,SAAA,CAAA,GAAa;;;;iBAOP,KAAA,CAAA,GAAS;;;;;;iBAUf,SAAA,CAAA;;;;iBAgBM,OAAA,CAAA,GAAW;;;;;;iBA8BjB,WAAA,CAAA;;;;cA8FH,WAAA,SAAoB,KAAK"}
+{"version":3,"file":"config.d.ts","names":[],"sources":["../src/config.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;AAiBA;AAAuB,UAAN,MAAM,CAAA,gBAAA,MAAA,EAAA,kBAAA,MAAA,CAAA,CAAA;EAAA;;;;EAUK,KAAE,EALrB,MAKqB,CALd,OAKc,EALL,IAKK,CAAA;EAAU;;;;EAKjB,OAMqB,CAAA,EAXhC,MAWgC,CAXzB,SAWyB,EAXd,UAWc,CAAA;EAAM;AAAP;AAkB3C;EAAwB,OAAA,EAxBb,YAwBa,CAxBA,OAwBA,EAxBS,SAwBT,CAAA,EAAA;EAAA;;;AACN;EAEb,mBAAA,CAAA,EArBmB,mBAqBD,CArBqB,MAqBrB,CAAA,MAAA,EAAA,OAAA,CAAA,CAAA;EAAA;;;EAAuC,KAC1D,CAAA,EAAA,OAAA;AAAO;AAKX;;;;;AAoCwB;AAyHxB;;;;AAGU,KAzKE,YAyKF,CAAA,gBAAA,MAAA,EAAA,kBAAA,MAAA,CAAA,GAxKR,gBAwKQ,CAxKS,OAwKT,EAxKkB,SAwKlB,CAAA;KAtKL,kBAsKkC,CAAA,OAAA,CAAA,GAtKJ,OAsKI,SAtKY,WAsKZ,CAAA,OAAA,CAAA,GAAA,KAAA,GArKnC,OAqKmC;AAAO;AAiD9C;;AACiB,UAlNA,YAkNA,CAAA,gBAAA,MAAA,EAAA,kBAAA,MAAA,CAAA,CAAA;EAAO;;AAAR;AAoChB;EAAgC,QAAA,EAAA,MAAA,GAAA,MAAA,EAAA;EAAA;;;EAKV,KACJ,CAAA,EA/OR,OA+OQ,EAAA;EAAO;;;AACf;AAiDV;;;;;EAKsB,WACe,CAAA,EAAA,SAAA,GAAA,UAAA;EAAO;;;EACvB,OAAA,CAAA,EAxRT,SAwRS,EAAA;EAyJL;AAOhB;AAWA;AAiBA;AA+BA;EAyHa,WAAA,CAAA,EArmBG,QAqmBS,GAAQ,IAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA5eX,oEAGZ,OAAO,SAAS,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiDvB,wEACN,OAAO,SAAS;;;;;;;;;;;;;;iBAoCJ,8EAKZ,aAAa,SAAS,4BACd,UACf,QAAQ,QAAQ;;;;;;;;;;;;iBAiDH,kFAKN,aAAa,SAAS,4BACd,mBAAmB,WAClC,mBAAmB;;;;;iBAyJN,SAAA,CAAA,GAAa;;;;iBAOP,KAAA,CAAA,GAAS;;;;;;iBAWf,SAAA,CAAA;;;;iBAiBM,OAAA,CAAA,GAAW;;;;;;iBA+BjB,WAAA,CAAA;;;;cAyHH,WAAA,SAAoB,KAAK"}

package/dist/config.js

@@ -1,4 +1,5 @@
 import { toFilter } from "./filter.js";
+import { compileScopedConfig, disposeScopedConfig, disposeScopedConfigSync, runWithScopedConfig, throwCombinedErrors } from "./scoped-config.js";
 import { LoggerImpl } from "./logger.js";
 import { getConsoleSink } from "./sink.js";
 
@@ -7,6 +8,7 @@ import { getConsoleSink } from "./sink.js";
 * The current configuration, if any.  Otherwise, `null`.
 */
 let currentConfig = null;
+let activeScopedConfigCount = 0;
 /**
 * Strong references to the loggers.
 * This is to prevent the loggers from being garbage collected so that their
@@ -91,6 +93,7 @@ function registerDisposeHook(allowAsync) {
 * @param config The configuration.
 */
 async function configure(config) {
+	assertNoScopedConfig("configure()");
 	if (currentConfig != null && !config.reset) throw new ConfigError("Already configured; if you want to reset, turn on the reset flag.");
 	await reset();
 	try {
@@ -134,6 +137,7 @@ async function configure(config) {
 * @since 0.9.0
 */
 function configureSync(config) {
+	assertNoScopedConfig("configureSync()");
 	if (currentConfig != null && !config.reset) throw new ConfigError("Already configured; if you want to reset, turn on the reset flag.");
 	if (asyncFilterDisposables.size > 0 || asyncSinkDisposables.size > 0) throw new ConfigError("Previously configured async disposables are still active. Use configure() instead or explicitly dispose them using dispose().");
 	resetSync();
@@ -144,6 +148,86 @@ function configureSync(config) {
 		throw e;
 	}
 }
+/**
+* Runs a callback with a LogTape configuration scoped to the current execution
+* context.
+*
+* The process-global configuration must already provide
+* `contextLocalStorage`.  The scoped configuration fully overrides global
+* logger routing while the callback and its async work run.
+*
+* @param config The scoped configuration.
+* @param callback The callback to run.
+* @returns The callback's resolved return value.
+* @since 2.3.0
+*/
+async function withConfig(config, callback) {
+	const contextLocalStorage = getConfiguredContextLocalStorage("withConfig()");
+	const scopedConfig = compileScopedConfig(config, true, (message) => new ConfigError(message));
+	let result;
+	let callbackError;
+	let callbackFailed = false;
+	activeScopedConfigCount++;
+	try {
+		result = await runWithScopedConfig(contextLocalStorage, scopedConfig, callback);
+	} catch (error) {
+		callbackFailed = true;
+		callbackError = error;
+	}
+	try {
+		await disposeScopedConfig(scopedConfig);
+	} catch (disposeError) {
+		if (callbackFailed) throwCombinedErrors(callbackError, disposeError);
+		throw disposeError;
+	} finally {
+		activeScopedConfigCount--;
+	}
+	if (callbackFailed) throw callbackError;
+	return result;
+}
+/**
+* Runs a synchronous callback with a LogTape configuration scoped to the
+* current execution context.
+*
+* The scoped configuration must not contain async disposable sinks or filters.
+*
+* @param config The scoped configuration.
+* @param callback The callback to run.
+* @returns The callback's return value.
+* @since 2.3.0
+*/
+function withConfigSync(config, callback) {
+	const contextLocalStorage = getConfiguredContextLocalStorage("withConfigSync()");
+	const scopedConfig = compileScopedConfig(config, false, (message) => new ConfigError(message));
+	let result;
+	let callbackError;
+	let callbackFailed = false;
+	activeScopedConfigCount++;
+	try {
+		result = runWithScopedConfig(contextLocalStorage, scopedConfig, callback);
+		if (isThenable(result)) {
+			Promise.resolve(result).catch(() => {});
+			callbackFailed = true;
+			callbackError = new ConfigError("withConfigSync() callback must not return a promise. Use withConfig() for async callbacks.");
+		}
+	} catch (error) {
+		callbackFailed = true;
+		callbackError = error;
+	}
+	try {
+		disposeScopedConfigSync(scopedConfig);
+	} catch (disposeError) {
+		if (callbackFailed) throwCombinedErrors(callbackError, disposeError);
+		throw disposeError;
+	} finally {
+		activeScopedConfigCount--;
+	}
+	if (callbackFailed) throw callbackError;
+	return result;
+}
+function isThenable(value) {
+	return value != null && (typeof value === "object" || typeof value === "function") && "then" in value && typeof value.then === "function";
+}
 function configureInternal(config, allowAsync) {
 	currentConfig = config;
 	let metaConfigured = false;
@@ -205,6 +289,7 @@ function getConfig() {
 * Reset the configuration.  Mostly for testing purposes.
 */
 async function reset() {
+	assertNoScopedConfig("reset()");
 	await dispose();
 	resetInternal();
 }
@@ -214,6 +299,7 @@ async function reset() {
 * @since 0.9.0
 */
 function resetSync() {
+	assertNoScopedConfig("resetSync()");
 	disposeSync();
 	resetInternal();
 }
@@ -228,6 +314,7 @@ function resetInternal() {
 * Dispose of the disposables.
 */
 async function dispose() {
+	assertNoScopedConfig("dispose()");
 	const errors = [];
 	try {
 		disposeSyncFilters();
@@ -257,6 +344,7 @@ async function dispose() {
 * @since 0.9.0
 */
 function disposeSync() {
+	assertNoScopedConfig("disposeSync()");
 	const errors = [];
 	try {
 		disposeSyncFilters();
@@ -270,6 +358,15 @@ function disposeSync() {
 	}
 	throwDisposeErrors(errors);
 }
+function getConfiguredContextLocalStorage(functionName) {
+	if (currentConfig == null) throw new ConfigError(`${functionName} requires LogTape to be configured first.`);
+	const contextLocalStorage = LoggerImpl.getLogger().contextLocalStorage;
+	if (contextLocalStorage == null) throw new ConfigError(`${functionName} requires Config.contextLocalStorage to be configured.`);
+	return contextLocalStorage;
+}
+function assertNoScopedConfig(functionName) {
+	if (activeScopedConfigCount > 0) throw new ConfigError(`${functionName} cannot be called while a scoped configuration is active. Use nested withConfig() instead.`);
+}
 function disposeSyncFilters() {
 	disposeSyncDisposables(filterDisposables);
 }
@@ -336,5 +433,5 @@ var ConfigError = class extends Error {
 };
 
 //#endregion
-export { ConfigError, configure, configureSync, dispose, disposeSync, getConfig, reset, resetSync };
+export { ConfigError, configure, configureSync, dispose, disposeSync, getConfig, reset, resetSync, withConfig, withConfigSync };
 //# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","names":["currentConfig: Config<string, string> | null","strongRefs: Set<LoggerImpl>","filterDisposables: Set<Disposable>","sinkDisposables: Set<Disposable>","asyncFilterDisposables: Set<AsyncDisposable>","asyncSinkDisposables: Set<AsyncDisposable>","cfg: LoggerConfig<TSinkId, TFilterId>","allowAsync: boolean","config: Config<TSinkId, TFilterId>","errors: unknown[]","disposables: Set<Disposable>","disposables: Set<AsyncDisposable>","promises: PromiseLike<void>[]","promises: readonly PromiseLike<void>[]","errors: readonly unknown[]","message: string"],"sources":["../src/config.ts"],"sourcesContent":["import type { ContextLocalStorage } from \"./context.ts\";\nimport { type FilterLike, toFilter } from \"./filter.ts\";\nimport type { LogLevel } from \"./level.ts\";\nimport { LoggerImpl } from \"./logger.ts\";\nimport { getConsoleSink, type Sink } from \"./sink.ts\";\n\n/**\n * A configuration for the loggers.\n */\nexport interface Config<TSinkId extends string, TFilterId extends string> {\n  /**\n   * The sinks to use.  The keys are the sink identifiers, and the values are\n   * {@link Sink}s.\n   */\n  sinks: Record<TSinkId, Sink>;\n  /**\n   * The filters to use.  The keys are the filter identifiers, and the values\n   * are either {@link Filter}s or {@link LogLevel}s.\n   */\n  filters?: Record<TFilterId, FilterLike>;\n\n  /**\n   * The loggers to configure.\n   */\n  loggers: LoggerConfig<TSinkId, TFilterId>[];\n\n  /**\n   * The context-local storage to use for implicit contexts.\n   * @since 0.7.0\n   */\n  contextLocalStorage?: ContextLocalStorage<Record<string, unknown>>;\n\n  /**\n   * Whether to reset the configuration before applying this one.\n   */\n  reset?: boolean;\n}\n\n/**\n * A logger configuration.\n */\nexport interface LoggerConfig<\n  TSinkId extends string,\n  TFilterId extends string,\n> {\n  /**\n   * The category of the logger.  If a string, it is equivalent to an array\n   * with one element.\n   */\n  category: string | string[];\n\n  /**\n   * The sink identifiers to use.\n   */\n  sinks?: TSinkId[];\n\n  /**\n   * Whether to inherit the parent's sinks.  If `inherit`, the parent's sinks\n   * are used along with the specified sinks.  If `override`, the parent's\n   * sinks are not used, and only the specified sinks are used.\n   *\n   * The default is `inherit`.\n   * @default `\"inherit\"\n   * @since 0.6.0\n   */\n  parentSinks?: \"inherit\" | \"override\";\n\n  /**\n   * The filter identifiers to use.\n   */\n  filters?: TFilterId[];\n\n  /**\n   * The lowest log level to accept.  If `null`, the logger will reject all\n   * records.\n   * @since 0.8.0\n   */\n  lowestLevel?: LogLevel | null;\n}\n\n/**\n * The current configuration, if any.  Otherwise, `null`.\n */\nlet currentConfig: Config<string, string> | null = null;\n\n/**\n * Strong references to the loggers.\n * This is to prevent the loggers from being garbage collected so that their\n * sinks and filters are not removed.\n */\nconst strongRefs: Set<LoggerImpl> = new Set();\n\n/**\n * Sync filter disposables to dispose when resetting the configuration.\n */\nconst filterDisposables: Set<Disposable> = new Set();\n\n/**\n * Sync sink disposables to dispose when resetting the configuration.\n */\nconst sinkDisposables: Set<Disposable> = new Set();\n\n/**\n * Async filter disposables to dispose when resetting the configuration.\n */\nconst asyncFilterDisposables: Set<AsyncDisposable> = new Set();\n\n/**\n * Async sink disposables to dispose when resetting the configuration.\n */\nconst asyncSinkDisposables: Set<AsyncDisposable> = new Set();\n\n/**\n * Check if a config is for the meta logger.\n */\nfunction isLoggerConfigMeta<TSinkId extends string, TFilterId extends string>(\n  cfg: LoggerConfig<TSinkId, TFilterId>,\n): boolean {\n  const category = Array.isArray(cfg.category) ? cfg.category : [cfg.category];\n  return category.length === 0 ||\n    (category.length === 1 && category[0] === \"logtape\") ||\n    (category.length === 2 &&\n      category[0] === \"logtape\" &&\n      category[1] === \"meta\");\n}\n\nfunction registerDisposeHook(allowAsync: boolean): void {\n  const handler = allowAsync ? dispose : disposeSync;\n\n  if (\n    // deno-lint-ignore no-explicit-any\n    typeof (globalThis as any).EdgeRuntime !== \"string\" &&\n    \"process\" in globalThis &&\n    !(\"Deno\" in globalThis)\n  ) {\n    // deno-lint-ignore no-explicit-any\n    const proc = (globalThis as any).process;\n    // Use bracket notation to avoid static analysis detection in Edge Runtime.\n    const onMethod = proc?.[\"on\"];\n    if (typeof onMethod === \"function\") {\n      onMethod.call(proc, \"exit\", handler);\n      return;\n    }\n  }\n\n  // Some edge runtimes expose neither process.on() nor addEventListener().\n  // In those environments users can still call dispose()/disposeSync() manually.\n  // deno-lint-ignore no-explicit-any\n  const addEventListenerMethod = (globalThis as any).addEventListener;\n  if (typeof addEventListenerMethod !== \"function\") return;\n\n  if (\"Deno\" in globalThis) {\n    addEventListenerMethod.call(globalThis, \"unload\", handler);\n  } else {\n    addEventListenerMethod.call(globalThis, \"pagehide\", handler);\n  }\n}\n\n/**\n * Configure the loggers with the specified configuration.\n *\n * Note that if the given sinks or filters are disposable, they will be\n * disposed when the configuration is reset, or when the process exits.\n *\n * @example\n * ```typescript\n * await configure({\n *   sinks: {\n *     console: getConsoleSink(),\n *   },\n *   filters: {\n *     slow: (log) =>\n *       \"duration\" in log.properties &&\n *       log.properties.duration as number > 1000,\n *   },\n *   loggers: [\n *     {\n *       category: \"my-app\",\n *       sinks: [\"console\"],\n *       lowestLevel: \"info\",\n *     },\n *     {\n *       category: [\"my-app\", \"sql\"],\n *       filters: [\"slow\"],\n *       lowestLevel: \"debug\",\n *     },\n *     {\n *       category: \"logtape\",\n *       sinks: [\"console\"],\n *       lowestLevel: \"error\",\n *     },\n *   ],\n * });\n * ```\n *\n * @param config The configuration.\n */\nexport async function configure<\n  TSinkId extends string,\n  TFilterId extends string,\n>(config: Config<TSinkId, TFilterId>): Promise<void> {\n  if (currentConfig != null && !config.reset) {\n    throw new ConfigError(\n      \"Already configured; if you want to reset, turn on the reset flag.\",\n    );\n  }\n  await reset();\n  try {\n    configureInternal(config, true);\n  } catch (e) {\n    if (e instanceof ConfigError) await reset();\n    throw e;\n  }\n}\n\n/**\n * Configure sync loggers with the specified configuration.\n *\n * Note that if the given sinks or filters are disposable, they will be\n * disposed when the configuration is reset, or when the process exits.\n *\n * Also note that passing async sinks or filters will throw. If\n * necessary use {@link resetSync} or {@link disposeSync}.\n *\n * @example\n * ```typescript\n * configureSync({\n *   sinks: {\n *     console: getConsoleSink(),\n *   },\n *   loggers: [\n *     {\n *       category: \"my-app\",\n *       sinks: [\"console\"],\n *       lowestLevel: \"info\",\n *     },\n *     {\n *       category: \"logtape\",\n *       sinks: [\"console\"],\n *       lowestLevel: \"error\",\n *     },\n *   ],\n * });\n * ```\n *\n * @param config The configuration.\n * @since 0.9.0\n */\nexport function configureSync<TSinkId extends string, TFilterId extends string>(\n  config: Config<TSinkId, TFilterId>,\n): void {\n  if (currentConfig != null && !config.reset) {\n    throw new ConfigError(\n      \"Already configured; if you want to reset, turn on the reset flag.\",\n    );\n  }\n  if (asyncFilterDisposables.size > 0 || asyncSinkDisposables.size > 0) {\n    throw new ConfigError(\n      \"Previously configured async disposables are still active. \" +\n        \"Use configure() instead or explicitly dispose them using dispose().\",\n    );\n  }\n  resetSync();\n  try {\n    configureInternal(config, false);\n  } catch (e) {\n    if (e instanceof ConfigError) resetSync();\n    throw e;\n  }\n}\n\nfunction configureInternal<\n  TSinkId extends string,\n  TFilterId extends string,\n>(config: Config<TSinkId, TFilterId>, allowAsync: boolean): void {\n  currentConfig = config;\n\n  let metaConfigured = false;\n  const configuredCategories = new Set<string>();\n\n  for (const cfg of config.loggers) {\n    if (isLoggerConfigMeta(cfg)) {\n      metaConfigured = true;\n    }\n\n    // Check for duplicate logger categories\n    const categoryKey = Array.isArray(cfg.category)\n      ? JSON.stringify(cfg.category)\n      : JSON.stringify([cfg.category]);\n    if (configuredCategories.has(categoryKey)) {\n      throw new ConfigError(\n        `Duplicate logger configuration for category: ${categoryKey}. ` +\n          `Each category can only be configured once.`,\n      );\n    }\n    configuredCategories.add(categoryKey);\n\n    const logger = LoggerImpl.getLogger(cfg.category);\n    for (const sinkId of cfg.sinks ?? []) {\n      const sink = config.sinks[sinkId];\n      if (!sink) {\n        throw new ConfigError(`Sink not found: ${sinkId}.`);\n      }\n      logger.sinks.push(sink);\n    }\n    logger.parentSinks = cfg.parentSinks ?? \"inherit\";\n    if (cfg.lowestLevel !== undefined) {\n      logger.lowestLevel = cfg.lowestLevel;\n    }\n    for (const filterId of cfg.filters ?? []) {\n      const filter = config.filters?.[filterId];\n      if (filter === undefined) {\n        throw new ConfigError(`Filter not found: ${filterId}.`);\n      }\n      logger.filters.push(toFilter(filter));\n    }\n    strongRefs.add(logger);\n  }\n\n  LoggerImpl.getLogger().contextLocalStorage = config.contextLocalStorage;\n\n  for (const sink of Object.values<Sink>(config.sinks)) {\n    if (Symbol.asyncDispose in sink) {\n      if (allowAsync) asyncSinkDisposables.add(sink as AsyncDisposable);\n      else {\n        throw new ConfigError(\n          \"Async disposables cannot be used with configureSync().\",\n        );\n      }\n    }\n    if (Symbol.dispose in sink) sinkDisposables.add(sink as Disposable);\n  }\n\n  for (const filter of Object.values<FilterLike>(config.filters ?? {})) {\n    if (filter == null || typeof filter === \"string\") continue;\n    if (Symbol.asyncDispose in filter) {\n      if (allowAsync) asyncFilterDisposables.add(filter as AsyncDisposable);\n      else {\n        throw new ConfigError(\n          \"Async disposables cannot be used with configureSync().\",\n        );\n      }\n      asyncSinkDisposables.delete(filter as AsyncDisposable);\n    }\n    if (Symbol.dispose in filter) {\n      filterDisposables.add(filter as Disposable);\n      sinkDisposables.delete(filter as Disposable);\n    }\n  }\n\n  registerDisposeHook(allowAsync);\n  const meta = LoggerImpl.getLogger([\"logtape\", \"meta\"]);\n  if (!metaConfigured) {\n    meta.sinks.push(getConsoleSink());\n  }\n\n  meta.info(\n    \"LogTape loggers are configured.  Note that LogTape itself uses the meta \" +\n      \"logger, which has category {metaLoggerCategory}.  The meta logger is \" +\n      \"used to log internal diagnostics such as sink exceptions.  \" +\n      \"It's recommended to configure the meta logger with a separate sink \" +\n      \"so that you can easily notice if logging itself fails or is \" +\n      \"misconfigured.  To turn off this message, configure the meta logger \" +\n      \"with higher log levels than {dismissLevel}.  See also \" +\n      \"<https://logtape.org/manual/categories#meta-logger>.\",\n    { metaLoggerCategory: [\"logtape\", \"meta\"], dismissLevel: \"info\" },\n  );\n}\n\n/**\n * Get the current configuration, if any.  Otherwise, `null`.\n * @returns The current configuration, if any.  Otherwise, `null`.\n */\nexport function getConfig(): Config<string, string> | null {\n  return currentConfig;\n}\n\n/**\n * Reset the configuration.  Mostly for testing purposes.\n */\nexport async function reset(): Promise<void> {\n  await dispose();\n  resetInternal();\n}\n\n/**\n * Reset the configuration.  Mostly for testing purposes. Will not clear async\n * sinks, only use with sync sinks. Use {@link reset} if you have async sinks.\n * @since 0.9.0\n */\nexport function resetSync(): void {\n  disposeSync();\n  resetInternal();\n}\n\nfunction resetInternal(): void {\n  const rootLogger = LoggerImpl.getLogger([]);\n  rootLogger.resetDescendants();\n  delete rootLogger.contextLocalStorage;\n  strongRefs.clear();\n  currentConfig = null;\n}\n\n/**\n * Dispose of the disposables.\n */\nexport async function dispose(): Promise<void> {\n  const errors: unknown[] = [];\n  try {\n    disposeSyncFilters();\n  } catch (error) {\n    errors.push(error);\n  }\n  try {\n    await disposeAsyncFilters();\n  } catch (error) {\n    errors.push(error);\n  }\n  try {\n    disposeSyncSinks();\n  } catch (error) {\n    errors.push(error);\n  }\n  try {\n    await disposeAsyncSinks();\n  } catch (error) {\n    errors.push(error);\n  }\n  throwDisposeErrors(errors);\n}\n\n/**\n * Dispose of the sync disposables. Async disposables will be untouched,\n * use {@link dispose} if you have async sinks.\n * @since 0.9.0\n */\nexport function disposeSync(): void {\n  const errors: unknown[] = [];\n  try {\n    disposeSyncFilters();\n  } catch (error) {\n    errors.push(error);\n  }\n  try {\n    disposeSyncSinks();\n  } catch (error) {\n    errors.push(error);\n  }\n  throwDisposeErrors(errors);\n}\n\nfunction disposeSyncFilters(): void {\n  disposeSyncDisposables(filterDisposables);\n}\n\nfunction disposeSyncSinks(): void {\n  disposeSyncDisposables(sinkDisposables);\n}\n\nfunction disposeSyncDisposables(disposables: Set<Disposable>): void {\n  const errors: unknown[] = [];\n  try {\n    for (const disposable of disposables) {\n      try {\n        disposable[Symbol.dispose]();\n      } catch (error) {\n        errors.push(error);\n      } finally {\n        disposables.delete(disposable);\n      }\n    }\n  } finally {\n    disposables.clear();\n  }\n  throwDisposeErrors(errors);\n}\n\nasync function disposeAsyncFilters(): Promise<void> {\n  await disposeAsyncDisposables(asyncFilterDisposables);\n}\n\nasync function disposeAsyncSinks(): Promise<void> {\n  await disposeAsyncDisposables(asyncSinkDisposables);\n}\n\nasync function disposeAsyncDisposables(\n  disposables: Set<AsyncDisposable>,\n): Promise<void> {\n  const promises: PromiseLike<void>[] = [];\n  try {\n    for (const disposable of disposables) {\n      try {\n        promises.push(Promise.resolve(disposable[Symbol.asyncDispose]()));\n      } catch (error) {\n        promises.push(Promise.reject(error));\n      } finally {\n        disposables.delete(disposable);\n      }\n    }\n  } finally {\n    disposables.clear();\n  }\n  await settleDisposePromises(promises);\n}\n\nasync function settleDisposePromises(\n  promises: readonly PromiseLike<void>[],\n): Promise<void> {\n  const results = await Promise.allSettled(promises);\n  throwDisposeErrors(\n    results\n      .filter((result): result is PromiseRejectedResult =>\n        result.status === \"rejected\"\n      )\n      .map((result) => result.reason),\n  );\n}\n\nfunction throwDisposeErrors(errors: readonly unknown[]): void {\n  if (errors.length < 1) return;\n  if (errors.length === 1) throw errors[0];\n  throw new AggregateError(\n    errors,\n    \"Multiple errors occurred while disposing LogTape resources.\",\n  );\n}\n\n/**\n * A configuration error.\n */\nexport class ConfigError extends Error {\n  /**\n   * Constructs a new configuration error.\n   * @param message The error message.\n   */\n  constructor(message: string) {\n    super(message);\n    this.name = \"ConfigError\";\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"config.js","names":["currentConfig: Config<string, string> | null","strongRefs: Set<LoggerImpl>","filterDisposables: Set<Disposable>","sinkDisposables: Set<Disposable>","asyncFilterDisposables: Set<AsyncDisposable>","asyncSinkDisposables: Set<AsyncDisposable>","cfg: LoggerConfig<TSinkId, TFilterId>","allowAsync: boolean","config: Config<TSinkId, TFilterId>","config: ScopedConfig<TSinkId, TFilterId>","callback: () => TResult","result: Awaited<TResult>","callbackError: unknown","callback: () => SyncCallbackResult<TResult>","result: SyncCallbackResult<TResult>","value: unknown","errors: unknown[]","functionName: string","disposables: Set<Disposable>","disposables: Set<AsyncDisposable>","promises: PromiseLike<void>[]","promises: readonly PromiseLike<void>[]","errors: readonly unknown[]","message: string"],"sources":["../src/config.ts"],"sourcesContent":["import type { ContextLocalStorage } from \"./context.ts\";\nimport { type FilterLike, toFilter } from \"./filter.ts\";\nimport type { LogLevel } from \"./level.ts\";\nimport { LoggerImpl } from \"./logger.ts\";\nimport {\n  compileScopedConfig,\n  disposeScopedConfig,\n  disposeScopedConfigSync,\n  runWithScopedConfig,\n  type ScopedConfigLike,\n  throwCombinedErrors,\n} from \"./scoped-config.ts\";\nimport { getConsoleSink, type Sink } from \"./sink.ts\";\n\n/**\n * A configuration for the loggers.\n */\nexport interface Config<TSinkId extends string, TFilterId extends string> {\n  /**\n   * The sinks to use.  The keys are the sink identifiers, and the values are\n   * {@link Sink}s.\n   */\n  sinks: Record<TSinkId, Sink>;\n  /**\n   * The filters to use.  The keys are the filter identifiers, and the values\n   * are either {@link Filter}s or {@link LogLevel}s.\n   */\n  filters?: Record<TFilterId, FilterLike>;\n\n  /**\n   * The loggers to configure.\n   */\n  loggers: LoggerConfig<TSinkId, TFilterId>[];\n\n  /**\n   * The context-local storage to use for implicit contexts.\n   * @since 0.7.0\n   */\n  contextLocalStorage?: ContextLocalStorage<Record<string, unknown>>;\n\n  /**\n   * Whether to reset the configuration before applying this one.\n   */\n  reset?: boolean;\n}\n\n/**\n * A scoped configuration for the current execution context.\n *\n * Unlike {@link Config}, this type does not include `reset` or\n * `contextLocalStorage`.  Scoped configuration changes only the logging policy\n * for a callback; the context-local storage must already be initialized by the\n * process-global configuration.\n *\n * @since 2.3.0\n */\nexport type ScopedConfig<TSinkId extends string, TFilterId extends string> =\n  ScopedConfigLike<TSinkId, TFilterId>;\n\ntype SyncCallbackResult<TResult> = TResult extends PromiseLike<unknown> ? never\n  : TResult;\n\n/**\n * A logger configuration.\n */\nexport interface LoggerConfig<\n  TSinkId extends string,\n  TFilterId extends string,\n> {\n  /**\n   * The category of the logger.  If a string, it is equivalent to an array\n   * with one element.\n   */\n  category: string | string[];\n\n  /**\n   * The sink identifiers to use.\n   */\n  sinks?: TSinkId[];\n\n  /**\n   * Whether to inherit the parent's sinks.  If `inherit`, the parent's sinks\n   * are used along with the specified sinks.  If `override`, the parent's\n   * sinks are not used, and only the specified sinks are used.\n   *\n   * The default is `inherit`.\n   * @default `\"inherit\"\n   * @since 0.6.0\n   */\n  parentSinks?: \"inherit\" | \"override\";\n\n  /**\n   * The filter identifiers to use.\n   */\n  filters?: TFilterId[];\n\n  /**\n   * The lowest log level to accept.  If `null`, the logger will reject all\n   * records.\n   * @since 0.8.0\n   */\n  lowestLevel?: LogLevel | null;\n}\n\n/**\n * The current configuration, if any.  Otherwise, `null`.\n */\nlet currentConfig: Config<string, string> | null = null;\nlet activeScopedConfigCount = 0;\n\n/**\n * Strong references to the loggers.\n * This is to prevent the loggers from being garbage collected so that their\n * sinks and filters are not removed.\n */\nconst strongRefs: Set<LoggerImpl> = new Set();\n\n/**\n * Sync filter disposables to dispose when resetting the configuration.\n */\nconst filterDisposables: Set<Disposable> = new Set();\n\n/**\n * Sync sink disposables to dispose when resetting the configuration.\n */\nconst sinkDisposables: Set<Disposable> = new Set();\n\n/**\n * Async filter disposables to dispose when resetting the configuration.\n */\nconst asyncFilterDisposables: Set<AsyncDisposable> = new Set();\n\n/**\n * Async sink disposables to dispose when resetting the configuration.\n */\nconst asyncSinkDisposables: Set<AsyncDisposable> = new Set();\n\n/**\n * Check if a config is for the meta logger.\n */\nfunction isLoggerConfigMeta<TSinkId extends string, TFilterId extends string>(\n  cfg: LoggerConfig<TSinkId, TFilterId>,\n): boolean {\n  const category = Array.isArray(cfg.category) ? cfg.category : [cfg.category];\n  return category.length === 0 ||\n    (category.length === 1 && category[0] === \"logtape\") ||\n    (category.length === 2 &&\n      category[0] === \"logtape\" &&\n      category[1] === \"meta\");\n}\n\nfunction registerDisposeHook(allowAsync: boolean): void {\n  const handler = allowAsync ? dispose : disposeSync;\n\n  if (\n    // deno-lint-ignore no-explicit-any\n    typeof (globalThis as any).EdgeRuntime !== \"string\" &&\n    \"process\" in globalThis &&\n    !(\"Deno\" in globalThis)\n  ) {\n    // deno-lint-ignore no-explicit-any\n    const proc = (globalThis as any).process;\n    // Use bracket notation to avoid static analysis detection in Edge Runtime.\n    const onMethod = proc?.[\"on\"];\n    if (typeof onMethod === \"function\") {\n      onMethod.call(proc, \"exit\", handler);\n      return;\n    }\n  }\n\n  // Some edge runtimes expose neither process.on() nor addEventListener().\n  // In those environments users can still call dispose()/disposeSync() manually.\n  // deno-lint-ignore no-explicit-any\n  const addEventListenerMethod = (globalThis as any).addEventListener;\n  if (typeof addEventListenerMethod !== \"function\") return;\n\n  if (\"Deno\" in globalThis) {\n    addEventListenerMethod.call(globalThis, \"unload\", handler);\n  } else {\n    addEventListenerMethod.call(globalThis, \"pagehide\", handler);\n  }\n}\n\n/**\n * Configure the loggers with the specified configuration.\n *\n * Note that if the given sinks or filters are disposable, they will be\n * disposed when the configuration is reset, or when the process exits.\n *\n * @example\n * ```typescript\n * await configure({\n *   sinks: {\n *     console: getConsoleSink(),\n *   },\n *   filters: {\n *     slow: (log) =>\n *       \"duration\" in log.properties &&\n *       log.properties.duration as number > 1000,\n *   },\n *   loggers: [\n *     {\n *       category: \"my-app\",\n *       sinks: [\"console\"],\n *       lowestLevel: \"info\",\n *     },\n *     {\n *       category: [\"my-app\", \"sql\"],\n *       filters: [\"slow\"],\n *       lowestLevel: \"debug\",\n *     },\n *     {\n *       category: \"logtape\",\n *       sinks: [\"console\"],\n *       lowestLevel: \"error\",\n *     },\n *   ],\n * });\n * ```\n *\n * @param config The configuration.\n */\nexport async function configure<\n  TSinkId extends string,\n  TFilterId extends string,\n>(config: Config<TSinkId, TFilterId>): Promise<void> {\n  assertNoScopedConfig(\"configure()\");\n  if (currentConfig != null && !config.reset) {\n    throw new ConfigError(\n      \"Already configured; if you want to reset, turn on the reset flag.\",\n    );\n  }\n  await reset();\n  try {\n    configureInternal(config, true);\n  } catch (e) {\n    if (e instanceof ConfigError) await reset();\n    throw e;\n  }\n}\n\n/**\n * Configure sync loggers with the specified configuration.\n *\n * Note that if the given sinks or filters are disposable, they will be\n * disposed when the configuration is reset, or when the process exits.\n *\n * Also note that passing async sinks or filters will throw. If\n * necessary use {@link resetSync} or {@link disposeSync}.\n *\n * @example\n * ```typescript\n * configureSync({\n *   sinks: {\n *     console: getConsoleSink(),\n *   },\n *   loggers: [\n *     {\n *       category: \"my-app\",\n *       sinks: [\"console\"],\n *       lowestLevel: \"info\",\n *     },\n *     {\n *       category: \"logtape\",\n *       sinks: [\"console\"],\n *       lowestLevel: \"error\",\n *     },\n *   ],\n * });\n * ```\n *\n * @param config The configuration.\n * @since 0.9.0\n */\nexport function configureSync<TSinkId extends string, TFilterId extends string>(\n  config: Config<TSinkId, TFilterId>,\n): void {\n  assertNoScopedConfig(\"configureSync()\");\n  if (currentConfig != null && !config.reset) {\n    throw new ConfigError(\n      \"Already configured; if you want to reset, turn on the reset flag.\",\n    );\n  }\n  if (asyncFilterDisposables.size > 0 || asyncSinkDisposables.size > 0) {\n    throw new ConfigError(\n      \"Previously configured async disposables are still active. \" +\n        \"Use configure() instead or explicitly dispose them using dispose().\",\n    );\n  }\n  resetSync();\n  try {\n    configureInternal(config, false);\n  } catch (e) {\n    if (e instanceof ConfigError) resetSync();\n    throw e;\n  }\n}\n\n/**\n * Runs a callback with a LogTape configuration scoped to the current execution\n * context.\n *\n * The process-global configuration must already provide\n * `contextLocalStorage`.  The scoped configuration fully overrides global\n * logger routing while the callback and its async work run.\n *\n * @param config The scoped configuration.\n * @param callback The callback to run.\n * @returns The callback's resolved return value.\n * @since 2.3.0\n */\nexport async function withConfig<\n  TSinkId extends string,\n  TFilterId extends string,\n  TResult,\n>(\n  config: ScopedConfig<TSinkId, TFilterId>,\n  callback: () => TResult,\n): Promise<Awaited<TResult>> {\n  const contextLocalStorage = getConfiguredContextLocalStorage(\"withConfig()\");\n  const scopedConfig = compileScopedConfig(\n    config,\n    true,\n    (message) => new ConfigError(message),\n  );\n\n  let result: Awaited<TResult>;\n  let callbackError: unknown;\n  let callbackFailed = false;\n  activeScopedConfigCount++;\n  try {\n    result = await runWithScopedConfig(\n      contextLocalStorage,\n      scopedConfig,\n      callback,\n    );\n  } catch (error) {\n    callbackFailed = true;\n    callbackError = error;\n  }\n\n  try {\n    await disposeScopedConfig(scopedConfig);\n  } catch (disposeError) {\n    if (callbackFailed) {\n      throwCombinedErrors(callbackError, disposeError);\n    }\n    throw disposeError;\n  } finally {\n    activeScopedConfigCount--;\n  }\n\n  if (callbackFailed) throw callbackError;\n  return result!;\n}\n\n/**\n * Runs a synchronous callback with a LogTape configuration scoped to the\n * current execution context.\n *\n * The scoped configuration must not contain async disposable sinks or filters.\n *\n * @param config The scoped configuration.\n * @param callback The callback to run.\n * @returns The callback's return value.\n * @since 2.3.0\n */\nexport function withConfigSync<\n  TSinkId extends string,\n  TFilterId extends string,\n  TResult,\n>(\n  config: ScopedConfig<TSinkId, TFilterId>,\n  callback: () => SyncCallbackResult<TResult>,\n): SyncCallbackResult<TResult> {\n  const contextLocalStorage = getConfiguredContextLocalStorage(\n    \"withConfigSync()\",\n  );\n  const scopedConfig = compileScopedConfig(\n    config,\n    false,\n    (message) => new ConfigError(message),\n  );\n\n  let result: SyncCallbackResult<TResult>;\n  let callbackError: unknown;\n  let callbackFailed = false;\n  activeScopedConfigCount++;\n  try {\n    result = runWithScopedConfig(contextLocalStorage, scopedConfig, callback);\n    if (isThenable(result)) {\n      void Promise.resolve(result).catch(() => {});\n      callbackFailed = true;\n      callbackError = new ConfigError(\n        \"withConfigSync() callback must not return a promise. \" +\n          \"Use withConfig() for async callbacks.\",\n      );\n    }\n  } catch (error) {\n    callbackFailed = true;\n    callbackError = error;\n  }\n\n  try {\n    disposeScopedConfigSync(scopedConfig);\n  } catch (disposeError) {\n    if (callbackFailed) {\n      throwCombinedErrors(callbackError, disposeError);\n    }\n    throw disposeError;\n  } finally {\n    activeScopedConfigCount--;\n  }\n\n  if (callbackFailed) throw callbackError;\n  return result!;\n}\n\nfunction isThenable(value: unknown): value is PromiseLike<unknown> {\n  return value != null &&\n    (typeof value === \"object\" || typeof value === \"function\") &&\n    \"then\" in value &&\n    typeof value.then === \"function\";\n}\n\nfunction configureInternal<\n  TSinkId extends string,\n  TFilterId extends string,\n>(config: Config<TSinkId, TFilterId>, allowAsync: boolean): void {\n  currentConfig = config;\n\n  let metaConfigured = false;\n  const configuredCategories = new Set<string>();\n\n  for (const cfg of config.loggers) {\n    if (isLoggerConfigMeta(cfg)) {\n      metaConfigured = true;\n    }\n\n    // Check for duplicate logger categories\n    const categoryKey = Array.isArray(cfg.category)\n      ? JSON.stringify(cfg.category)\n      : JSON.stringify([cfg.category]);\n    if (configuredCategories.has(categoryKey)) {\n      throw new ConfigError(\n        `Duplicate logger configuration for category: ${categoryKey}. ` +\n          `Each category can only be configured once.`,\n      );\n    }\n    configuredCategories.add(categoryKey);\n\n    const logger = LoggerImpl.getLogger(cfg.category);\n    for (const sinkId of cfg.sinks ?? []) {\n      const sink = config.sinks[sinkId];\n      if (!sink) {\n        throw new ConfigError(`Sink not found: ${sinkId}.`);\n      }\n      logger.sinks.push(sink);\n    }\n    logger.parentSinks = cfg.parentSinks ?? \"inherit\";\n    if (cfg.lowestLevel !== undefined) {\n      logger.lowestLevel = cfg.lowestLevel;\n    }\n    for (const filterId of cfg.filters ?? []) {\n      const filter = config.filters?.[filterId];\n      if (filter === undefined) {\n        throw new ConfigError(`Filter not found: ${filterId}.`);\n      }\n      logger.filters.push(toFilter(filter));\n    }\n    strongRefs.add(logger);\n  }\n\n  LoggerImpl.getLogger().contextLocalStorage = config.contextLocalStorage;\n\n  for (const sink of Object.values<Sink>(config.sinks)) {\n    if (Symbol.asyncDispose in sink) {\n      if (allowAsync) asyncSinkDisposables.add(sink as AsyncDisposable);\n      else {\n        throw new ConfigError(\n          \"Async disposables cannot be used with configureSync().\",\n        );\n      }\n    }\n    if (Symbol.dispose in sink) sinkDisposables.add(sink as Disposable);\n  }\n\n  for (const filter of Object.values<FilterLike>(config.filters ?? {})) {\n    if (filter == null || typeof filter === \"string\") continue;\n    if (Symbol.asyncDispose in filter) {\n      if (allowAsync) asyncFilterDisposables.add(filter as AsyncDisposable);\n      else {\n        throw new ConfigError(\n          \"Async disposables cannot be used with configureSync().\",\n        );\n      }\n      asyncSinkDisposables.delete(filter as AsyncDisposable);\n    }\n    if (Symbol.dispose in filter) {\n      filterDisposables.add(filter as Disposable);\n      sinkDisposables.delete(filter as Disposable);\n    }\n  }\n\n  registerDisposeHook(allowAsync);\n  const meta = LoggerImpl.getLogger([\"logtape\", \"meta\"]);\n  if (!metaConfigured) {\n    meta.sinks.push(getConsoleSink());\n  }\n\n  meta.info(\n    \"LogTape loggers are configured.  Note that LogTape itself uses the meta \" +\n      \"logger, which has category {metaLoggerCategory}.  The meta logger is \" +\n      \"used to log internal diagnostics such as sink exceptions.  \" +\n      \"It's recommended to configure the meta logger with a separate sink \" +\n      \"so that you can easily notice if logging itself fails or is \" +\n      \"misconfigured.  To turn off this message, configure the meta logger \" +\n      \"with higher log levels than {dismissLevel}.  See also \" +\n      \"<https://logtape.org/manual/categories#meta-logger>.\",\n    { metaLoggerCategory: [\"logtape\", \"meta\"], dismissLevel: \"info\" },\n  );\n}\n\n/**\n * Get the current configuration, if any.  Otherwise, `null`.\n * @returns The current configuration, if any.  Otherwise, `null`.\n */\nexport function getConfig(): Config<string, string> | null {\n  return currentConfig;\n}\n\n/**\n * Reset the configuration.  Mostly for testing purposes.\n */\nexport async function reset(): Promise<void> {\n  assertNoScopedConfig(\"reset()\");\n  await dispose();\n  resetInternal();\n}\n\n/**\n * Reset the configuration.  Mostly for testing purposes. Will not clear async\n * sinks, only use with sync sinks. Use {@link reset} if you have async sinks.\n * @since 0.9.0\n */\nexport function resetSync(): void {\n  assertNoScopedConfig(\"resetSync()\");\n  disposeSync();\n  resetInternal();\n}\n\nfunction resetInternal(): void {\n  const rootLogger = LoggerImpl.getLogger([]);\n  rootLogger.resetDescendants();\n  delete rootLogger.contextLocalStorage;\n  strongRefs.clear();\n  currentConfig = null;\n}\n\n/**\n * Dispose of the disposables.\n */\nexport async function dispose(): Promise<void> {\n  assertNoScopedConfig(\"dispose()\");\n  const errors: unknown[] = [];\n  try {\n    disposeSyncFilters();\n  } catch (error) {\n    errors.push(error);\n  }\n  try {\n    await disposeAsyncFilters();\n  } catch (error) {\n    errors.push(error);\n  }\n  try {\n    disposeSyncSinks();\n  } catch (error) {\n    errors.push(error);\n  }\n  try {\n    await disposeAsyncSinks();\n  } catch (error) {\n    errors.push(error);\n  }\n  throwDisposeErrors(errors);\n}\n\n/**\n * Dispose of the sync disposables. Async disposables will be untouched,\n * use {@link dispose} if you have async sinks.\n * @since 0.9.0\n */\nexport function disposeSync(): void {\n  assertNoScopedConfig(\"disposeSync()\");\n  const errors: unknown[] = [];\n  try {\n    disposeSyncFilters();\n  } catch (error) {\n    errors.push(error);\n  }\n  try {\n    disposeSyncSinks();\n  } catch (error) {\n    errors.push(error);\n  }\n  throwDisposeErrors(errors);\n}\n\nfunction getConfiguredContextLocalStorage(\n  functionName: string,\n): ContextLocalStorage<Record<string, unknown>> {\n  if (currentConfig == null) {\n    throw new ConfigError(\n      `${functionName} requires LogTape to be configured first.`,\n    );\n  }\n  const contextLocalStorage = LoggerImpl.getLogger().contextLocalStorage;\n  if (contextLocalStorage == null) {\n    throw new ConfigError(\n      `${functionName} requires Config.contextLocalStorage to be configured.`,\n    );\n  }\n  return contextLocalStorage;\n}\n\nfunction assertNoScopedConfig(functionName: string): void {\n  if (activeScopedConfigCount > 0) {\n    throw new ConfigError(\n      `${functionName} cannot be called while a scoped configuration is ` +\n        \"active. Use nested withConfig() instead.\",\n    );\n  }\n}\n\nfunction disposeSyncFilters(): void {\n  disposeSyncDisposables(filterDisposables);\n}\n\nfunction disposeSyncSinks(): void {\n  disposeSyncDisposables(sinkDisposables);\n}\n\nfunction disposeSyncDisposables(disposables: Set<Disposable>): void {\n  const errors: unknown[] = [];\n  try {\n    for (const disposable of disposables) {\n      try {\n        disposable[Symbol.dispose]();\n      } catch (error) {\n        errors.push(error);\n      } finally {\n        disposables.delete(disposable);\n      }\n    }\n  } finally {\n    disposables.clear();\n  }\n  throwDisposeErrors(errors);\n}\n\nasync function disposeAsyncFilters(): Promise<void> {\n  await disposeAsyncDisposables(asyncFilterDisposables);\n}\n\nasync function disposeAsyncSinks(): Promise<void> {\n  await disposeAsyncDisposables(asyncSinkDisposables);\n}\n\nasync function disposeAsyncDisposables(\n  disposables: Set<AsyncDisposable>,\n): Promise<void> {\n  const promises: PromiseLike<void>[] = [];\n  try {\n    for (const disposable of disposables) {\n      try {\n        promises.push(Promise.resolve(disposable[Symbol.asyncDispose]()));\n      } catch (error) {\n        promises.push(Promise.reject(error));\n      } finally {\n        disposables.delete(disposable);\n      }\n    }\n  } finally {\n    disposables.clear();\n  }\n  await settleDisposePromises(promises);\n}\n\nasync function settleDisposePromises(\n  promises: readonly PromiseLike<void>[],\n): Promise<void> {\n  const results = await Promise.allSettled(promises);\n  throwDisposeErrors(\n    results\n      .filter((result): result is PromiseRejectedResult =>\n        result.status === \"rejected\"\n      )\n      .map((result) => result.reason),\n  );\n}\n\nfunction throwDisposeErrors(errors: readonly unknown[]): void {\n  if (errors.length < 1) return;\n  if (errors.length === 1) throw errors[0];\n  throw new AggregateError(\n    errors,\n    \"Multiple errors occurred while disposing LogTape resources.\",\n  );\n}\n\n/**\n * A configuration error.\n */\nexport class ConfigError extends Error {\n  /**\n   * Constructs a new configuration error.\n   * @param message The error message.\n   */\n  constructor(message: string) {\n    super(message);\n    this.name = \"ConfigError\";\n  }\n}\n"],"mappings":"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"}