@ekkolyth/logging 0.1.0

package/dist/browser.d.ts

@@ -0,0 +1,7 @@
+import { a as Window, i as RateLimited, n as Logger, r as LoggerOptions, t as LogOutput } from "./logger-V7XF9Wuo.js";
+import { n as LogFormat, r as LogLevel, t as LogAttributes } from "./types-CieIrR8p.js";
+//#region src/browser.d.ts
+declare function createLogger(options?: LoggerOptions): Logger;
+//#endregion
+export { type LogAttributes, type LogFormat, type LogLevel, type LogOutput, type Logger, type LoggerOptions, type RateLimited, type Window, createLogger };
+//# sourceMappingURL=browser.d.ts.map

package/dist/browser.js

@@ -0,0 +1,27 @@
+import { n as resolveFormat, r as resolveLevel, t as resolveColors } from "./env-Dur55C_F.js";
+import { t as buildEngine } from "./logger-BxxJhfg8.js";
+//#region src/browser.ts
+function createLogger(options = {}) {
+	const level = resolveLevel(options.level, {});
+	const format = resolveFormat(options.format, {}, true);
+	const colors = resolveColors(options.colors, {}, false);
+	const defaultOutput = (line) => {
+		console.log(line.endsWith("\n") ? line.slice(0, -1) : line);
+	};
+	return buildEngine({
+		bindings: options.bindings ?? {},
+		colors,
+		format,
+		level,
+		onInternalError: options.onInternalError,
+		output: options.output ?? defaultOutput,
+		redact: options.redact ?? [],
+		scope: options.scope,
+		service: options.service,
+		stderrWrite: (message) => console.error(message)
+	});
+}
+//#endregion
+export { createLogger };
+
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","names":[],"sources":["../src/browser.ts"],"sourcesContent":["import { resolveColors, resolveFormat, resolveLevel } from './env'\nimport {\n    buildEngine,\n    type Logger,\n    type LoggerOptions,\n    type LogOutput,\n} from './logger'\n\nfunction createLogger(options: LoggerOptions = {}): Logger {\n    // browsers never inspect process.env — an empty env source plus fixed\n    // detection preferences reproduces \"auto selects uncolored pretty output\"\n    const level = resolveLevel(options.level, {})\n    const format = resolveFormat(options.format, {}, true)\n    const colors = resolveColors(options.colors, {}, false)\n\n    const defaultOutput: LogOutput = (line) => {\n        console.log(line.endsWith('\\n') ? line.slice(0, -1) : line)\n    }\n\n    return buildEngine({\n        bindings: options.bindings ?? {},\n        colors,\n        format,\n        level,\n        onInternalError: options.onInternalError,\n        output: options.output ?? defaultOutput,\n        redact: options.redact ?? [],\n        scope: options.scope,\n        service: options.service,\n        stderrWrite: (message) => console.error(message),\n    })\n}\n\nexport type { Logger, LoggerOptions, LogOutput, RateLimited } from './logger'\nexport type { Window } from './throttler'\nexport type { LogAttributes, LogFormat, LogLevel } from './types'\nexport { createLogger }\n"],"mappings":";;;AAQA,SAAS,aAAa,UAAyB,CAAC,GAAW;CAGvD,MAAM,QAAQ,aAAa,QAAQ,OAAO,CAAC,CAAC;CAC5C,MAAM,SAAS,cAAc,QAAQ,QAAQ,CAAC,GAAG,IAAI;CACrD,MAAM,SAAS,cAAc,QAAQ,QAAQ,CAAC,GAAG,KAAK;CAEtD,MAAM,iBAA4B,SAAS;EACvC,QAAQ,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,MAAM,GAAG,EAAE,IAAI,IAAI;CAC9D;CAEA,OAAO,YAAY;EACf,UAAU,QAAQ,YAAY,CAAC;EAC/B;EACA;EACA;EACA,iBAAiB,QAAQ;EACzB,QAAQ,QAAQ,UAAU;EAC1B,QAAQ,QAAQ,UAAU,CAAC;EAC3B,OAAO,QAAQ;EACf,SAAS,QAAQ;EACjB,cAAc,YAAY,QAAQ,MAAM,OAAO;CACnD,CAAC;AACL"}

package/dist/context-BU9CEJZ3.js

@@ -0,0 +1,25 @@
+import { n as setContextProvider } from "./context-seam-DzbwDxiY.js";
+import { AsyncLocalStorage } from "node:async_hooks";
+//#region src/context/context-store.ts
+const storage = new AsyncLocalStorage();
+function runWithContext(bindings, callback) {
+	const merged = {
+		...storage.getStore(),
+		...bindings
+	};
+	return storage.run(merged, callback);
+}
+function getStore() {
+	return storage.getStore();
+}
+//#endregion
+//#region src/context/index.ts
+setContextProvider(getStore);
+function currentContext() {
+	const store = getStore();
+	return store ? { ...store } : void 0;
+}
+//#endregion
+export { runWithContext as n, currentContext as t };
+
+//# sourceMappingURL=context-BU9CEJZ3.js.map

package/dist/context-BU9CEJZ3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-BU9CEJZ3.js","names":[],"sources":["../src/context/context-store.ts","../src/context/index.ts"],"sourcesContent":["import { AsyncLocalStorage } from 'node:async_hooks'\nimport type { LogAttributes } from '../types'\n\nconst storage = new AsyncLocalStorage<LogAttributes>()\n\nfunction runWithContext<T>(\n    bindings: LogAttributes,\n    callback: () => T | Promise<T>\n): T | Promise<T> {\n    const merged = { ...storage.getStore(), ...bindings }\n    return storage.run(merged, callback)\n}\n\nfunction getStore(): LogAttributes | undefined {\n    return storage.getStore()\n}\n\nexport { getStore, runWithContext }\n","import { setContextProvider } from '../context-seam'\nimport type { LogAttributes } from '../types'\nimport { getStore, runWithContext } from './context-store'\n\nsetContextProvider(getStore)\n\nfunction currentContext(): Readonly<LogAttributes> | undefined {\n    const store = getStore()\n    return store ? { ...store } : undefined\n}\n\nexport { currentContext, runWithContext }\n"],"mappings":";;;AAGA,MAAM,UAAU,IAAI,kBAAiC;AAErD,SAAS,eACL,UACA,UACc;CACd,MAAM,SAAS;EAAE,GAAG,QAAQ,SAAS;EAAG,GAAG;CAAS;CACpD,OAAO,QAAQ,IAAI,QAAQ,QAAQ;AACvC;AAEA,SAAS,WAAsC;CAC3C,OAAO,QAAQ,SAAS;AAC5B;;;ACXA,mBAAmB,QAAQ;AAE3B,SAAS,iBAAsD;CAC3D,MAAM,QAAQ,SAAS;CACvB,OAAO,QAAQ,EAAE,GAAG,MAAM,IAAI,KAAA;AAClC"}

package/dist/context-seam-DzbwDxiY.js

@@ -0,0 +1,12 @@
+//#region src/context-seam.ts
+let provider;
+function setContextProvider(next) {
+	provider = next;
+}
+function activeContext() {
+	return provider?.();
+}
+//#endregion
+export { setContextProvider as n, activeContext as t };
+
+//# sourceMappingURL=context-seam-DzbwDxiY.js.map

package/dist/context-seam-DzbwDxiY.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-seam-DzbwDxiY.js","names":[],"sources":["../src/context-seam.ts"],"sourcesContent":["import type { LogAttributes } from './types'\n\ntype ContextProvider = () => LogAttributes | undefined\n\nlet provider: ContextProvider | undefined\n\n// internal only — not re-exported by index.ts/browser.ts. The Node-only\n// `/context` entry calls this at module load to install its\n// AsyncLocalStorage-backed provider; the browser entry graph never imports\n// that module, so node:async_hooks never reaches it through this seam.\nfunction setContextProvider(next: ContextProvider | undefined): void {\n    provider = next\n}\n\nfunction activeContext(): LogAttributes | undefined {\n    return provider?.()\n}\n\nexport { activeContext, setContextProvider }\n"],"mappings":";AAIA,IAAI;AAMJ,SAAS,mBAAmB,MAAyC;CACjE,WAAW;AACf;AAEA,SAAS,gBAA2C;CAChD,OAAO,WAAW;AACtB"}

package/dist/context.browser.d.ts

@@ -0,0 +1,7 @@
+import { t as LogAttributes } from "./types-CieIrR8p.js";
+//#region src/context/browser.d.ts
+declare function runWithContext<T>(_bindings: LogAttributes, _callback: () => T | Promise<T>): T | Promise<T>;
+declare function currentContext(): Readonly<LogAttributes> | undefined;
+//#endregion
+export { currentContext, runWithContext };
+//# sourceMappingURL=context.browser.d.ts.map

package/dist/context.browser.js

@@ -0,0 +1,14 @@
+//#region src/context/browser.ts
+function throwUnsupported() {
+	throw new Error("@ekkolyth/logging/context is not supported in the browser — use log.with(bindings) instead");
+}
+function runWithContext(_bindings, _callback) {
+	throwUnsupported();
+}
+function currentContext() {
+	throwUnsupported();
+}
+//#endregion
+export { currentContext, runWithContext };
+
+//# sourceMappingURL=context.browser.js.map

package/dist/context.browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.browser.js","names":[],"sources":["../src/context/browser.ts"],"sourcesContent":["import type { LogAttributes } from '../types'\n\nfunction throwUnsupported(): never {\n    throw new Error(\n        '@ekkolyth/logging/context is not supported in the browser — use log.with(bindings) instead'\n    )\n}\n\nfunction runWithContext<T>(\n    _bindings: LogAttributes,\n    _callback: () => T | Promise<T>\n): T | Promise<T> {\n    throwUnsupported()\n}\n\nfunction currentContext(): Readonly<LogAttributes> | undefined {\n    throwUnsupported()\n}\n\nexport { currentContext, runWithContext }\n"],"mappings":";AAEA,SAAS,mBAA0B;CAC/B,MAAM,IAAI,MACN,4FACJ;AACJ;AAEA,SAAS,eACL,WACA,WACc;CACd,iBAAiB;AACrB;AAEA,SAAS,iBAAsD;CAC3D,iBAAiB;AACrB"}

package/dist/context.d.ts

@@ -0,0 +1,9 @@
+import { t as LogAttributes } from "./types-CieIrR8p.js";
+//#region src/context/context-store.d.ts
+declare function runWithContext<T>(bindings: LogAttributes, callback: () => T | Promise<T>): T | Promise<T>;
+//#endregion
+//#region src/context/index.d.ts
+declare function currentContext(): Readonly<LogAttributes> | undefined;
+//#endregion
+export { currentContext, runWithContext };
+//# sourceMappingURL=context.d.ts.map

package/dist/context.js

@@ -0,0 +1,2 @@
+import { n as runWithContext, t as currentContext } from "./context-BU9CEJZ3.js";
+export { currentContext, runWithContext };

package/dist/env-Dur55C_F.js

@@ -0,0 +1,50 @@
+//#region src/env.ts
+const LEVELS = [
+	"debug",
+	"info",
+	"warn",
+	"error",
+	"silent"
+];
+const FORMATS = [
+	"auto",
+	"json",
+	"pretty"
+];
+const assertLevel = (value) => {
+	if (!LEVELS.includes(value)) throw new TypeError(`@ekkolyth/logging: invalid level "${value}"`);
+	return value;
+};
+const assertFormat = (value) => {
+	if (!FORMATS.includes(value)) throw new TypeError(`@ekkolyth/logging: invalid format "${value}"`);
+	return value;
+};
+function resolveLevel(explicit, env) {
+	if (explicit !== void 0) return assertLevel(explicit);
+	const fromEnv = env.LOG_LEVEL;
+	if (fromEnv !== void 0 && fromEnv !== "") return assertLevel(fromEnv);
+	return "info";
+}
+function resolveFormat(explicit, env, preferPretty) {
+	if (explicit !== void 0) {
+		const valid = assertFormat(explicit);
+		if (valid !== "auto") return valid;
+	}
+	const fromEnv = env.LOG_FORMAT;
+	if (fromEnv !== void 0 && fromEnv !== "") {
+		const valid = assertFormat(fromEnv);
+		if (valid !== "auto") return valid;
+	}
+	return preferPretty ? "pretty" : "json";
+}
+function resolveColors(explicit, env, preferColor) {
+	if (typeof explicit === "boolean") return explicit;
+	if (env.NO_COLOR !== void 0) return false;
+	const forceColor = env.FORCE_COLOR;
+	if (forceColor !== void 0) return forceColor !== "0";
+	return preferColor;
+}
+//#endregion
+export { resolveFormat as n, resolveLevel as r, resolveColors as t };
+
+//# sourceMappingURL=env-Dur55C_F.js.map

package/dist/env-Dur55C_F.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-Dur55C_F.js","names":[],"sources":["../src/env.ts"],"sourcesContent":["import type { LogFormat, LogLevel } from './types'\n\ntype ColorOption = 'auto' | boolean | undefined\ntype EnvSource = Record<string, string | undefined>\n\nconst LEVELS: readonly LogLevel[] = ['debug', 'info', 'warn', 'error', 'silent']\nconst FORMATS: readonly LogFormat[] = ['auto', 'json', 'pretty']\n\nconst assertLevel = (value: string): LogLevel => {\n    if (!(LEVELS as readonly string[]).includes(value)) {\n        throw new TypeError(`@ekkolyth/logging: invalid level \"${value}\"`)\n    }\n    return value as LogLevel\n}\n\nconst assertFormat = (value: string): LogFormat => {\n    if (!(FORMATS as readonly string[]).includes(value)) {\n        throw new TypeError(`@ekkolyth/logging: invalid format \"${value}\"`)\n    }\n    return value as LogFormat\n}\n\nfunction resolveLevel(\n    explicit: LogLevel | undefined,\n    env: EnvSource\n): LogLevel {\n    if (explicit !== undefined) return assertLevel(explicit)\n    // set-but-empty means unset: compose interpolates an omitted host var\n    // to '', and an empty value carries no intent\n    const fromEnv = env.LOG_LEVEL\n    if (fromEnv !== undefined && fromEnv !== '') return assertLevel(fromEnv)\n    return 'info'\n}\n\nfunction resolveFormat(\n    explicit: LogFormat | undefined,\n    env: EnvSource,\n    preferPretty: boolean\n): Exclude<LogFormat, 'auto'> {\n    if (explicit !== undefined) {\n        const valid = assertFormat(explicit)\n        if (valid !== 'auto') return valid\n    }\n    const fromEnv = env.LOG_FORMAT\n    if (fromEnv !== undefined && fromEnv !== '') {\n        const valid = assertFormat(fromEnv)\n        if (valid !== 'auto') return valid\n    }\n    return preferPretty ? 'pretty' : 'json'\n}\n\nfunction resolveColors(\n    explicit: ColorOption,\n    env: EnvSource,\n    preferColor: boolean\n): boolean {\n    if (typeof explicit === 'boolean') return explicit\n    if (env.NO_COLOR !== undefined) return false\n    const forceColor = env.FORCE_COLOR\n    if (forceColor !== undefined) return forceColor !== '0'\n    return preferColor\n}\n\nexport type { ColorOption, EnvSource }\nexport { resolveColors, resolveFormat, resolveLevel }\n"],"mappings":";AAKA,MAAM,SAA8B;CAAC;CAAS;CAAQ;CAAQ;CAAS;AAAQ;AAC/E,MAAM,UAAgC;CAAC;CAAQ;CAAQ;AAAQ;AAE/D,MAAM,eAAe,UAA4B;CAC7C,IAAI,CAAE,OAA6B,SAAS,KAAK,GAC7C,MAAM,IAAI,UAAU,qCAAqC,MAAM,EAAE;CAErE,OAAO;AACX;AAEA,MAAM,gBAAgB,UAA6B;CAC/C,IAAI,CAAE,QAA8B,SAAS,KAAK,GAC9C,MAAM,IAAI,UAAU,sCAAsC,MAAM,EAAE;CAEtE,OAAO;AACX;AAEA,SAAS,aACL,UACA,KACQ;CACR,IAAI,aAAa,KAAA,GAAW,OAAO,YAAY,QAAQ;CAGvD,MAAM,UAAU,IAAI;CACpB,IAAI,YAAY,KAAA,KAAa,YAAY,IAAI,OAAO,YAAY,OAAO;CACvE,OAAO;AACX;AAEA,SAAS,cACL,UACA,KACA,cAC0B;CAC1B,IAAI,aAAa,KAAA,GAAW;EACxB,MAAM,QAAQ,aAAa,QAAQ;EACnC,IAAI,UAAU,QAAQ,OAAO;CACjC;CACA,MAAM,UAAU,IAAI;CACpB,IAAI,YAAY,KAAA,KAAa,YAAY,IAAI;EACzC,MAAM,QAAQ,aAAa,OAAO;EAClC,IAAI,UAAU,QAAQ,OAAO;CACjC;CACA,OAAO,eAAe,WAAW;AACrC;AAEA,SAAS,cACL,UACA,KACA,aACO;CACP,IAAI,OAAO,aAAa,WAAW,OAAO;CAC1C,IAAI,IAAI,aAAa,KAAA,GAAW,OAAO;CACvC,MAAM,aAAa,IAAI;CACvB,IAAI,eAAe,KAAA,GAAW,OAAO,eAAe;CACpD,OAAO;AACX"}

package/dist/http.browser.d.ts

@@ -0,0 +1,16 @@
+import { n as Logger } from "./logger-V7XF9Wuo.js";
+import { n as FetchOptions, t as FetchLike } from "./outbound-CQkyIyxd.js";
+//#region src/http/browser.d.ts
+type RequestHandler = (request: Request) => Response | Promise<Response>;
+interface HandlerOptions {
+  clientIp?: (request: Request) => string | undefined;
+  exclude?: (request: Request) => boolean;
+  route?: (request: Request) => string | undefined;
+  sampleRate?: number;
+  slowThresholdMs?: number;
+}
+declare function wrapHandler(_log: Logger, _handler: RequestHandler, _options?: HandlerOptions): RequestHandler;
+declare const wrapFetch: (log: Logger, fetchFn: FetchLike, options?: FetchOptions) => FetchLike;
+//#endregion
+export { type FetchLike, type FetchOptions, type HandlerOptions, type RequestHandler, wrapFetch, wrapHandler };
+//# sourceMappingURL=http.browser.d.ts.map

package/dist/http.browser.js

@@ -0,0 +1,23 @@
+import { n as getBindings } from "./logger-BxxJhfg8.js";
+import { t as createWrapFetch } from "./outbound-YYy-EfTF.js";
+//#region src/http/browser.ts
+function throwUnsupported() {
+	throw new Error("@ekkolyth/logging/http wrapHandler is not supported in the browser — concurrent request context has no platform adapter there. Use wrapFetch instead.");
+}
+function wrapHandler(_log, _handler, _options) {
+	return throwUnsupported();
+}
+function bindingsAsAmbient(log) {
+	const bindings = getBindings(log);
+	const asString = (value) => typeof value === "string" ? value : void 0;
+	return {
+		requestId: asString(bindings.request_id),
+		traceId: asString(bindings.trace_id),
+		spanId: asString(bindings.span_id)
+	};
+}
+const wrapFetch = createWrapFetch(bindingsAsAmbient);
+//#endregion
+export { wrapFetch, wrapHandler };
+
+//# sourceMappingURL=http.browser.js.map

package/dist/http.browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.browser.js","names":[],"sources":["../src/http/browser.ts"],"sourcesContent":["import { getBindings, type Logger } from '../logger'\nimport type { AmbientCorrelation } from './correlation'\nimport { createWrapFetch, type FetchLike, type FetchOptions } from './outbound'\n\ntype RequestHandler = (request: Request) => Response | Promise<Response>\n\ninterface HandlerOptions {\n    clientIp?: (request: Request) => string | undefined\n    exclude?: (request: Request) => boolean\n    route?: (request: Request) => string | undefined\n    sampleRate?: number\n    slowThresholdMs?: number\n}\n\nfunction throwUnsupported(): never {\n    throw new Error(\n        '@ekkolyth/logging/http wrapHandler is not supported in the browser — concurrent request context has no platform adapter there. Use wrapFetch instead.'\n    )\n}\n\n// Concurrent request context has no platform adapter in the browser, so\n// wrapHandler always throws — it never touches its arguments.\nfunction wrapHandler(\n    _log: Logger,\n    _handler: RequestHandler,\n    _options?: HandlerOptions\n): RequestHandler {\n    return throwUnsupported()\n}\n\nfunction bindingsAsAmbient(log: Logger): AmbientCorrelation {\n    const bindings = getBindings(log)\n    const asString = (value: unknown): string | undefined =>\n        typeof value === 'string' ? value : undefined\n    return {\n        requestId: asString(bindings.request_id),\n        traceId: asString(bindings.trace_id),\n        spanId: asString(bindings.span_id),\n    }\n}\n\n// Browser wrapFetch has no ambient async context, so it derives correlation\n// from explicit request headers and the bound attributes of the logger\n// passed to it (log.with({ request_id, trace_id, span_id })).\nconst wrapFetch = createWrapFetch(bindingsAsAmbient)\n\nexport type { FetchLike, FetchOptions, HandlerOptions, RequestHandler }\nexport { wrapFetch, wrapHandler }\n"],"mappings":";;;AAcA,SAAS,mBAA0B;CAC/B,MAAM,IAAI,MACN,uJACJ;AACJ;AAIA,SAAS,YACL,MACA,UACA,UACc;CACd,OAAO,iBAAiB;AAC5B;AAEA,SAAS,kBAAkB,KAAiC;CACxD,MAAM,WAAW,YAAY,GAAG;CAChC,MAAM,YAAY,UACd,OAAO,UAAU,WAAW,QAAQ,KAAA;CACxC,OAAO;EACH,WAAW,SAAS,SAAS,UAAU;EACvC,SAAS,SAAS,SAAS,QAAQ;EACnC,QAAQ,SAAS,SAAS,OAAO;CACrC;AACJ;AAKA,MAAM,YAAY,gBAAgB,iBAAiB"}

package/dist/http.d.ts

@@ -0,0 +1,22 @@
+import { n as Logger } from "./logger-V7XF9Wuo.js";
+import { n as FetchOptions, t as FetchLike } from "./outbound-CQkyIyxd.js";
+//#region src/http/index.d.ts
+type RequestHandler = (request: Request) => Response | Promise<Response>;
+interface HandlerOptions {
+  clientIp?: (request: Request) => string | undefined;
+  exclude?: (request: Request) => boolean;
+  /**
+   * Drops repeat fast-2xx completion records sharing method|path|status
+   * inside the window; warn, error, and slow records always emit.
+   * undefined means ten minutes, 0 disables.
+   */
+  quietWindowMs?: number;
+  route?: (request: Request) => string | undefined;
+  sampleRate?: number;
+  slowThresholdMs?: number;
+}
+declare const wrapFetch: (log: Logger, fetchFn: FetchLike, options?: FetchOptions) => FetchLike;
+declare function wrapHandler(log: Logger, handler: RequestHandler, options?: HandlerOptions): RequestHandler;
+//#endregion
+export { type FetchLike, type FetchOptions, type HandlerOptions, type RequestHandler, wrapFetch, wrapHandler };
+//# sourceMappingURL=http.d.ts.map

package/dist/http.js

@@ -0,0 +1,112 @@
+import { t as Throttler } from "./throttler-s0TCHZNK.js";
+import { n as runWithContext } from "./context-BU9CEJZ3.js";
+import { a as shouldSample, i as resolveSlowThresholdMs, n as samplingIdentifier, o as deriveInboundCorrelation, r as resolveSampleRate, t as createWrapFetch } from "./outbound-YYy-EfTF.js";
+import { AsyncLocalStorage } from "node:async_hooks";
+//#region src/http/index.ts
+const DEFAULT_QUIET_WINDOW_MS = 6e5;
+const correlationStore = new AsyncLocalStorage();
+const wrapFetch = createWrapFetch(() => correlationStore.getStore());
+function echoRequestId(response, requestId) {
+	try {
+		response.headers.set("x-request-id", requestId);
+		return response;
+	} catch {}
+	try {
+		const rebuilt = new Response(response.body, response);
+		rebuilt.headers.set("x-request-id", requestId);
+		return rebuilt;
+	} catch {
+		return response;
+	}
+}
+function wrapHandler(log, handler, options = {}) {
+	const sampleRate = resolveSampleRate(options.sampleRate);
+	const slowThresholdMs = resolveSlowThresholdMs(options.slowThresholdMs);
+	const quiet = new Throttler(options.quietWindowMs ?? DEFAULT_QUIET_WINDOW_MS);
+	return (request) => {
+		const correlation = deriveInboundCorrelation(request.headers);
+		const excluded = options.exclude?.(request) ?? false;
+		const start = performance.now();
+		return runWithContext({
+			request_id: correlation.requestId,
+			span_id: correlation.spanId,
+			trace_id: correlation.traceId
+		}, () => correlationStore.run(correlation, async () => {
+			let response;
+			let failure;
+			let didFail = false;
+			try {
+				response = await handler(request);
+			} catch (error) {
+				failure = error;
+				didFail = true;
+			}
+			const durationMs = performance.now() - start;
+			if (!excluded) emitInboundRecord({
+				correlation,
+				didFail,
+				durationMs,
+				failure,
+				log,
+				options,
+				quiet,
+				request,
+				response,
+				sampleRate,
+				slowThresholdMs
+			});
+			if (didFail) throw failure;
+			return echoRequestId(response, correlation.requestId);
+		}));
+	};
+}
+function classifyLevel(input) {
+	const { correlation, didFail, durationMs, sampleRate, slowThresholdMs, status } = input;
+	if (didFail) return "error";
+	if (status >= 500) return "error";
+	if (status >= 400) return "warn";
+	if (durationMs >= slowThresholdMs) return "warn";
+	if (!shouldSample(samplingIdentifier(correlation), sampleRate)) return void 0;
+	return "info";
+}
+function emitInboundRecord(input) {
+	const { correlation, didFail, durationMs, failure, log, options, quiet, request, response, sampleRate, slowThresholdMs } = input;
+	const status = didFail ? 500 : response?.status ?? 500;
+	const level = classifyLevel({
+		correlation,
+		didFail,
+		durationMs,
+		sampleRate,
+		slowThresholdMs,
+		status
+	});
+	if (level === void 0) return;
+	if (level === "info" && !quiet.shouldEmit(request.method, new URL(request.url).pathname, String(status))) return;
+	const attributes = {
+		method: request.method,
+		path: new URL(request.url).pathname
+	};
+	const route = options.route?.(request);
+	if (route) attributes.route = route;
+	attributes.status = status;
+	attributes.duration_ms = Math.trunc(durationMs);
+	const sizeHeader = response?.headers.get("content-length");
+	if (sizeHeader !== null && sizeHeader !== void 0) {
+		const size = Number(sizeHeader);
+		if (Number.isFinite(size)) attributes.response_size_bytes = size;
+	}
+	attributes.request_id = correlation.requestId;
+	attributes.trace_id = correlation.traceId;
+	attributes.span_id = correlation.spanId;
+	const ip = options.clientIp?.(request);
+	if (ip) attributes.ip = ip;
+	const userAgent = request.headers.get("user-agent");
+	if (userAgent) attributes.user_agent = userAgent;
+	if (level === "info" && sampleRate < 1) attributes.sample_rate = sampleRate;
+	if (didFail) attributes.error = failure;
+	log[level]("request completed", attributes);
+}
+//#endregion
+export { wrapFetch, wrapHandler };
+
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","names":[],"sources":["../src/http/index.ts"],"sourcesContent":["import { AsyncLocalStorage } from 'node:async_hooks'\n// importing runWithContext also runs ../context's module-load side effect\n// (setContextProvider(getStore)), which is what lets an application log\n// call anywhere inside a wrapped request pick up request_id/trace_id/\n// span_id even when the app never imports @ekkolyth/logging/context itself.\nimport { runWithContext } from '../context'\nimport type { Logger } from '../logger'\nimport { Throttler } from '../throttler'\nimport { type Correlation, deriveInboundCorrelation } from './correlation'\nimport {\n    createWrapFetch,\n    type FetchLike,\n    type FetchOptions,\n    type Level,\n    samplingIdentifier,\n} from './outbound'\nimport {\n    resolveSampleRate,\n    resolveSlowThresholdMs,\n    shouldSample,\n} from './sampling'\n\ntype RequestHandler = (request: Request) => Response | Promise<Response>\n\ninterface HandlerOptions {\n    clientIp?: (request: Request) => string | undefined\n    exclude?: (request: Request) => boolean\n    /**\n     * Drops repeat fast-2xx completion records sharing method|path|status\n     * inside the window; warn, error, and slow records always emit.\n     * undefined means ten minutes, 0 disables.\n     */\n    quietWindowMs?: number\n    route?: (request: Request) => string | undefined\n    sampleRate?: number\n    slowThresholdMs?: number\n}\n\nconst DEFAULT_QUIET_WINDOW_MS = 600_000\n\n// carries the full correlation (including flags/tracestate, which never\n// appear on an ordinary log line) between a wrapHandler invocation and any\n// wrapFetch call nested inside it — separate from the logging context,\n// which only ever exposes request_id/trace_id/span_id.\nconst correlationStore = new AsyncLocalStorage<Correlation>()\n\nconst wrapFetch = createWrapFetch(() => correlationStore.getStore())\n\n// Some Response instances guard their headers against mutation (a response\n// straight out of an upstream fetch(), Response.redirect(), Response.error()).\n// Rebuild a mutable copy rather than crash on the echo; if even the rebuild\n// fails (e.g. the body stream is already locked), fall back to the original\n// response untouched rather than losing it or throwing out of the handler.\nfunction echoRequestId(response: Response, requestId: string): Response {\n    try {\n        response.headers.set('x-request-id', requestId)\n        return response\n    } catch {\n        // fall through to the rebuild path below\n    }\n    try {\n        const rebuilt = new Response(response.body, response)\n        rebuilt.headers.set('x-request-id', requestId)\n        return rebuilt\n    } catch {\n        return response\n    }\n}\n\nfunction wrapHandler(\n    log: Logger,\n    handler: RequestHandler,\n    options: HandlerOptions = {}\n): RequestHandler {\n    const sampleRate = resolveSampleRate(options.sampleRate)\n    const slowThresholdMs = resolveSlowThresholdMs(options.slowThresholdMs)\n    const quiet = new Throttler(\n        options.quietWindowMs ?? DEFAULT_QUIET_WINDOW_MS\n    )\n\n    return (request: Request) => {\n        const correlation = deriveInboundCorrelation(request.headers)\n        const excluded = options.exclude?.(request) ?? false\n        const start = performance.now()\n\n        return runWithContext(\n            {\n                request_id: correlation.requestId,\n                span_id: correlation.spanId,\n                trace_id: correlation.traceId,\n            },\n            () =>\n                correlationStore.run(correlation, async () => {\n                    let response: Response | undefined\n                    let failure: unknown\n                    let didFail = false\n                    try {\n                        response = await handler(request)\n                    } catch (error) {\n                        failure = error\n                        didFail = true\n                    }\n                    const durationMs = performance.now() - start\n\n                    if (!excluded) {\n                        emitInboundRecord({\n                            correlation,\n                            didFail,\n                            durationMs,\n                            failure,\n                            log,\n                            options,\n                            quiet,\n                            request,\n                            response,\n                            sampleRate,\n                            slowThresholdMs,\n                        })\n                    }\n\n                    if (didFail) throw failure\n                    return echoRequestId(\n                        response as Response,\n                        correlation.requestId\n                    )\n                })\n        )\n    }\n}\n\nfunction classifyLevel(input: {\n    correlation: Pick<Correlation, 'requestId' | 'traceId'>\n    didFail: boolean\n    durationMs: number\n    sampleRate: number\n    slowThresholdMs: number\n    status: number\n}): Level | undefined {\n    const {\n        correlation,\n        didFail,\n        durationMs,\n        sampleRate,\n        slowThresholdMs,\n        status,\n    } = input\n    if (didFail) return 'error'\n    if (status >= 500) return 'error'\n    if (status >= 400) return 'warn'\n    if (durationMs >= slowThresholdMs) return 'warn'\n    if (!shouldSample(samplingIdentifier(correlation), sampleRate))\n        return undefined\n    return 'info'\n}\n\nfunction emitInboundRecord(input: {\n    correlation: Correlation\n    didFail: boolean\n    durationMs: number\n    failure: unknown\n    log: Logger\n    options: HandlerOptions\n    quiet: Throttler\n    request: Request\n    response: Response | undefined\n    sampleRate: number\n    slowThresholdMs: number\n}): void {\n    const {\n        correlation,\n        didFail,\n        durationMs,\n        failure,\n        log,\n        options,\n        quiet,\n        request,\n        response,\n        sampleRate,\n        slowThresholdMs,\n    } = input\n    const status = didFail ? 500 : (response?.status ?? 500)\n\n    const level = classifyLevel({\n        correlation,\n        didFail,\n        durationMs,\n        sampleRate,\n        slowThresholdMs,\n        status,\n    })\n    if (level === undefined) return\n    // same policy as the old request logger: only the fast-2xx class is\n    // quieted; warn, error, and slow records always emit\n    if (\n        level === 'info' &&\n        !quiet.shouldEmit(\n            request.method,\n            new URL(request.url).pathname,\n            String(status)\n        )\n    )\n        return\n\n    const attributes: Record<string, unknown> = {\n        method: request.method,\n        path: new URL(request.url).pathname,\n    }\n\n    const route = options.route?.(request)\n    if (route) attributes.route = route\n\n    attributes.status = status\n    attributes.duration_ms = Math.trunc(durationMs)\n\n    const sizeHeader = response?.headers.get('content-length')\n    if (sizeHeader !== null && sizeHeader !== undefined) {\n        const size = Number(sizeHeader)\n        if (Number.isFinite(size)) attributes.response_size_bytes = size\n    }\n\n    attributes.request_id = correlation.requestId\n    attributes.trace_id = correlation.traceId\n    attributes.span_id = correlation.spanId\n\n    const ip = options.clientIp?.(request)\n    if (ip) attributes.ip = ip\n\n    const userAgent = request.headers.get('user-agent')\n    if (userAgent) attributes.user_agent = userAgent\n\n    if (level === 'info' && sampleRate < 1) attributes.sample_rate = sampleRate\n    if (didFail) attributes.error = failure\n\n    log[level]('request completed', attributes)\n}\n\nexport type { FetchLike, FetchOptions, HandlerOptions, RequestHandler }\nexport { wrapFetch, wrapHandler }\n"],"mappings":";;;;;AAsCA,MAAM,0BAA0B;AAMhC,MAAM,mBAAmB,IAAI,kBAA+B;AAE5D,MAAM,YAAY,sBAAsB,iBAAiB,SAAS,CAAC;AAOnE,SAAS,cAAc,UAAoB,WAA6B;CACpE,IAAI;EACA,SAAS,QAAQ,IAAI,gBAAgB,SAAS;EAC9C,OAAO;CACX,QAAQ,CAER;CACA,IAAI;EACA,MAAM,UAAU,IAAI,SAAS,SAAS,MAAM,QAAQ;EACpD,QAAQ,QAAQ,IAAI,gBAAgB,SAAS;EAC7C,OAAO;CACX,QAAQ;EACJ,OAAO;CACX;AACJ;AAEA,SAAS,YACL,KACA,SACA,UAA0B,CAAC,GACb;CACd,MAAM,aAAa,kBAAkB,QAAQ,UAAU;CACvD,MAAM,kBAAkB,uBAAuB,QAAQ,eAAe;CACtE,MAAM,QAAQ,IAAI,UACd,QAAQ,iBAAiB,uBAC7B;CAEA,QAAQ,YAAqB;EACzB,MAAM,cAAc,yBAAyB,QAAQ,OAAO;EAC5D,MAAM,WAAW,QAAQ,UAAU,OAAO,KAAK;EAC/C,MAAM,QAAQ,YAAY,IAAI;EAE9B,OAAO,eACH;GACI,YAAY,YAAY;GACxB,SAAS,YAAY;GACrB,UAAU,YAAY;EAC1B,SAEI,iBAAiB,IAAI,aAAa,YAAY;GAC1C,IAAI;GACJ,IAAI;GACJ,IAAI,UAAU;GACd,IAAI;IACA,WAAW,MAAM,QAAQ,OAAO;GACpC,SAAS,OAAO;IACZ,UAAU;IACV,UAAU;GACd;GACA,MAAM,aAAa,YAAY,IAAI,IAAI;GAEvC,IAAI,CAAC,UACD,kBAAkB;IACd;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;GACJ,CAAC;GAGL,IAAI,SAAS,MAAM;GACnB,OAAO,cACH,UACA,YAAY,SAChB;EACJ,CAAC,CACT;CACJ;AACJ;AAEA,SAAS,cAAc,OAOD;CAClB,MAAM,EACF,aACA,SACA,YACA,YACA,iBACA,WACA;CACJ,IAAI,SAAS,OAAO;CACpB,IAAI,UAAU,KAAK,OAAO;CAC1B,IAAI,UAAU,KAAK,OAAO;CAC1B,IAAI,cAAc,iBAAiB,OAAO;CAC1C,IAAI,CAAC,aAAa,mBAAmB,WAAW,GAAG,UAAU,GACzD,OAAO,KAAA;CACX,OAAO;AACX;AAEA,SAAS,kBAAkB,OAYlB;CACL,MAAM,EACF,aACA,SACA,YACA,SACA,KACA,SACA,OACA,SACA,UACA,YACA,oBACA;CACJ,MAAM,SAAS,UAAU,MAAO,UAAU,UAAU;CAEpD,MAAM,QAAQ,cAAc;EACxB;EACA;EACA;EACA;EACA;EACA;CACJ,CAAC;CACD,IAAI,UAAU,KAAA,GAAW;CAGzB,IACI,UAAU,UACV,CAAC,MAAM,WACH,QAAQ,QACR,IAAI,IAAI,QAAQ,GAAG,CAAC,CAAC,UACrB,OAAO,MAAM,CACjB,GAEA;CAEJ,MAAM,aAAsC;EACxC,QAAQ,QAAQ;EAChB,MAAM,IAAI,IAAI,QAAQ,GAAG,CAAC,CAAC;CAC/B;CAEA,MAAM,QAAQ,QAAQ,QAAQ,OAAO;CACrC,IAAI,OAAO,WAAW,QAAQ;CAE9B,WAAW,SAAS;CACpB,WAAW,cAAc,KAAK,MAAM,UAAU;CAE9C,MAAM,aAAa,UAAU,QAAQ,IAAI,gBAAgB;CACzD,IAAI,eAAe,QAAQ,eAAe,KAAA,GAAW;EACjD,MAAM,OAAO,OAAO,UAAU;EAC9B,IAAI,OAAO,SAAS,IAAI,GAAG,WAAW,sBAAsB;CAChE;CAEA,WAAW,aAAa,YAAY;CACpC,WAAW,WAAW,YAAY;CAClC,WAAW,UAAU,YAAY;CAEjC,MAAM,KAAK,QAAQ,WAAW,OAAO;CACrC,IAAI,IAAI,WAAW,KAAK;CAExB,MAAM,YAAY,QAAQ,QAAQ,IAAI,YAAY;CAClD,IAAI,WAAW,WAAW,aAAa;CAEvC,IAAI,UAAU,UAAU,aAAa,GAAG,WAAW,cAAc;CACjE,IAAI,SAAS,WAAW,QAAQ;CAEhC,IAAI,MAAM,CAAC,qBAAqB,UAAU;AAC9C"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+import { a as Window, i as RateLimited, n as Logger, r as LoggerOptions, t as LogOutput } from "./logger-V7XF9Wuo.js";
+import { n as LogFormat, r as LogLevel, t as LogAttributes } from "./types-CieIrR8p.js";
+//#region src/index.d.ts
+declare function createLogger(options?: LoggerOptions): Logger;
+//#endregion
+export { type LogAttributes, type LogFormat, type LogLevel, type LogOutput, type Logger, type LoggerOptions, type RateLimited, type Window, createLogger };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,63 @@
+import { n as resolveFormat, r as resolveLevel, t as resolveColors } from "./env-Dur55C_F.js";
+import { t as buildEngine } from "./logger-BxxJhfg8.js";
+import { appendFileSync, openSync } from "node:fs";
+//#region src/file-output.ts
+const writers = /* @__PURE__ */ new Map();
+function resolveFileWriter(service, env) {
+	if (!service || env.LOG_SOURCE !== "file") return null;
+	for (const entry of (env.LOG_FILE_MAP ?? "").split(",")) {
+		const separator = entry.indexOf(":");
+		if (separator === -1) continue;
+		if (entry.slice(0, separator).trim() !== service) continue;
+		const path = entry.slice(separator + 1).trim();
+		if (!path) return null;
+		const cached = writers.get(path);
+		if (cached) return cached;
+		try {
+			const fd = openSync(path, "a");
+			const writer = (line) => {
+				try {
+					appendFileSync(fd, line);
+				} catch {}
+			};
+			writers.set(path, writer);
+			return writer;
+		} catch {
+			return null;
+		}
+	}
+	return null;
+}
+//#endregion
+//#region src/index.ts
+function createLogger(options = {}) {
+	const env = typeof process !== "undefined" && process.env ? process.env : {};
+	const isTTY = typeof process !== "undefined" && Boolean(process.stdout?.isTTY);
+	const level = resolveLevel(options.level, env);
+	const format = resolveFormat(options.format, env, isTTY);
+	const colors = resolveColors(options.colors, env, isTTY);
+	const toFile = resolveFileWriter(options.service, env);
+	const defaultOutput = (line) => {
+		if (typeof process !== "undefined" && process.stdout) process.stdout.write(line);
+		if (toFile) toFile(line);
+	};
+	const stderrWrite = (message) => {
+		if (typeof process !== "undefined" && process.stderr) process.stderr.write(message);
+	};
+	return buildEngine({
+		bindings: options.bindings ?? {},
+		colors,
+		format,
+		level,
+		onInternalError: options.onInternalError,
+		output: options.output ?? defaultOutput,
+		redact: options.redact ?? [],
+		scope: options.scope,
+		service: options.service,
+		stderrWrite
+	});
+}
+//#endregion
+export { createLogger };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/file-output.ts","../src/index.ts"],"sourcesContent":["import { appendFileSync, openSync } from 'node:fs'\n\ntype FileWriter = (line: string) => void\n\n// one handle per path for the process lifetime, shared by every logger that\n// resolves to it — never closed, same as stdout\nconst writers = new Map<string, FileWriter>()\n\n// LOG_SOURCE=file mirrors each service's lines into a file alongside stdout so\n// a log viewer can read processes that are not containers in local dev.\n// LOG_FILE_MAP is \"service:path\" pairs keyed by the logger's own service name.\nfunction resolveFileWriter(\n    service: string | undefined,\n    env: Record<string, string | undefined>\n): FileWriter | null {\n    if (!service || env.LOG_SOURCE !== 'file') return null\n\n    for (const entry of (env.LOG_FILE_MAP ?? '').split(',')) {\n        const separator = entry.indexOf(':')\n        if (separator === -1) continue\n        if (entry.slice(0, separator).trim() !== service) continue\n\n        const path = entry.slice(separator + 1).trim()\n        if (!path) return null\n\n        const cached = writers.get(path)\n        if (cached) return cached\n        try {\n            const fd = openSync(path, 'a')\n            const writer: FileWriter = (line) => {\n                try {\n                    appendFileSync(fd, line)\n                } catch {\n                    // disk full / fd revoked — a failed mirror never costs the\n                    // caller their log line on stdout\n                }\n            }\n            writers.set(path, writer)\n            return writer\n        } catch {\n            return null\n        }\n    }\n    return null\n}\n\nexport type { FileWriter }\nexport { resolveFileWriter }\n","import { resolveColors, resolveFormat, resolveLevel } from './env'\nimport { resolveFileWriter } from './file-output'\nimport {\n    buildEngine,\n    type Logger,\n    type LoggerOptions,\n    type LogOutput,\n} from './logger'\n\nfunction createLogger(options: LoggerOptions = {}): Logger {\n    const env = typeof process !== 'undefined' && process.env ? process.env : {}\n    const isTTY =\n        typeof process !== 'undefined' && Boolean(process.stdout?.isTTY)\n\n    const level = resolveLevel(options.level, env)\n    const format = resolveFormat(options.format, env, isTTY)\n    const colors = resolveColors(options.colors, env, isTTY)\n\n    // resolved against the real stdout, so mirroring to a file never changes\n    // the format or colors the terminal gets\n    const toFile = resolveFileWriter(options.service, env)\n    const defaultOutput: LogOutput = (line) => {\n        if (typeof process !== 'undefined' && process.stdout) {\n            process.stdout.write(line)\n        }\n        if (toFile) toFile(line)\n    }\n    const stderrWrite = (message: string): void => {\n        if (typeof process !== 'undefined' && process.stderr) {\n            process.stderr.write(message)\n        }\n    }\n\n    return buildEngine({\n        bindings: options.bindings ?? {},\n        colors,\n        format,\n        level,\n        onInternalError: options.onInternalError,\n        output: options.output ?? defaultOutput,\n        redact: options.redact ?? [],\n        scope: options.scope,\n        service: options.service,\n        stderrWrite,\n    })\n}\n\nexport type { Logger, LoggerOptions, LogOutput, RateLimited } from './logger'\nexport type { Window } from './throttler'\nexport type { LogAttributes, LogFormat, LogLevel } from './types'\nexport { createLogger }\n"],"mappings":";;;;AAMA,MAAM,0BAAU,IAAI,IAAwB;AAK5C,SAAS,kBACL,SACA,KACiB;CACjB,IAAI,CAAC,WAAW,IAAI,eAAe,QAAQ,OAAO;CAElD,KAAK,MAAM,UAAU,IAAI,gBAAgB,GAAA,CAAI,MAAM,GAAG,GAAG;EACrD,MAAM,YAAY,MAAM,QAAQ,GAAG;EACnC,IAAI,cAAc,IAAI;EACtB,IAAI,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,KAAK,MAAM,SAAS;EAElD,MAAM,OAAO,MAAM,MAAM,YAAY,CAAC,CAAC,CAAC,KAAK;EAC7C,IAAI,CAAC,MAAM,OAAO;EAElB,MAAM,SAAS,QAAQ,IAAI,IAAI;EAC/B,IAAI,QAAQ,OAAO;EACnB,IAAI;GACA,MAAM,KAAK,SAAS,MAAM,GAAG;GAC7B,MAAM,UAAsB,SAAS;IACjC,IAAI;KACA,eAAe,IAAI,IAAI;IAC3B,QAAQ,CAGR;GACJ;GACA,QAAQ,IAAI,MAAM,MAAM;GACxB,OAAO;EACX,QAAQ;GACJ,OAAO;EACX;CACJ;CACA,OAAO;AACX;;;ACnCA,SAAS,aAAa,UAAyB,CAAC,GAAW;CACvD,MAAM,MAAM,OAAO,YAAY,eAAe,QAAQ,MAAM,QAAQ,MAAM,CAAC;CAC3E,MAAM,QACF,OAAO,YAAY,eAAe,QAAQ,QAAQ,QAAQ,KAAK;CAEnE,MAAM,QAAQ,aAAa,QAAQ,OAAO,GAAG;CAC7C,MAAM,SAAS,cAAc,QAAQ,QAAQ,KAAK,KAAK;CACvD,MAAM,SAAS,cAAc,QAAQ,QAAQ,KAAK,KAAK;CAIvD,MAAM,SAAS,kBAAkB,QAAQ,SAAS,GAAG;CACrD,MAAM,iBAA4B,SAAS;EACvC,IAAI,OAAO,YAAY,eAAe,QAAQ,QAC1C,QAAQ,OAAO,MAAM,IAAI;EAE7B,IAAI,QAAQ,OAAO,IAAI;CAC3B;CACA,MAAM,eAAe,YAA0B;EAC3C,IAAI,OAAO,YAAY,eAAe,QAAQ,QAC1C,QAAQ,OAAO,MAAM,OAAO;CAEpC;CAEA,OAAO,YAAY;EACf,UAAU,QAAQ,YAAY,CAAC;EAC/B;EACA;EACA;EACA,iBAAiB,QAAQ;EACzB,QAAQ,QAAQ,UAAU;EAC1B,QAAQ,QAAQ,UAAU,CAAC;EAC3B,OAAO,QAAQ;EACf,SAAS,QAAQ;EACjB;CACJ,CAAC;AACL"}