@classytic/arc 2.41.1 → 2.44.0

package/dist/integrations/websocket-redis.d.mts

@@ -1,14 +1,14 @@
 
-import { f as WebSocketAdapter } from "../websocket-BOXVggMf.mjs";
+import { f as WebSocketAdapter } from "../websocket-Cs4awVyD.mjs";
 //#region src/integrations/websocket-redis.d.ts
-interface RedisLike {
+export interface RedisLike {
   publish(channel: string, message: string): Promise<number>;
   subscribe(...channels: string[]): Promise<unknown>;
   on(event: string, handler: (...args: unknown[]) => void): unknown;
   duplicate(): RedisLike;
   quit(): Promise<unknown>;
 }
-interface RedisWebSocketAdapterOptions {
+export interface RedisWebSocketAdapterOptions {
   /**
    * Redis channel for WebSocket broadcasts.
    * @default 'arc-ws'
@@ -31,7 +31,7 @@ interface RedisWebSocketAdapterOptions {
  * 5. Each instance checks instanceId — skips if it's own message (prevents double delivery)
  * 6. Other instances call RoomManager.broadcast() to deliver to their local clients
  */
-declare class RedisWebSocketAdapter implements WebSocketAdapter {
+export declare class RedisWebSocketAdapter implements WebSocketAdapter {
   readonly name = "redis";
   private pub;
   private sub;
@@ -42,5 +42,4 @@ declare class RedisWebSocketAdapter implements WebSocketAdapter {
   subscribe(callback: (room: string, message: string) => void): Promise<void>;
   close(): Promise<void>;
 }
-//#endregion
-export { RedisLike, RedisWebSocketAdapter, RedisWebSocketAdapterOptions };
+//#endregion

package/dist/integrations/websocket-redis.mjs

@@ -1,4 +1,4 @@
-/*! @classytic/arc v2.41.1 | MIT | https://classytic.com */
+/*! @classytic/arc v2.44.0 | MIT | https://classytic.com */
 //#region src/integrations/websocket-redis.ts
 /**
 * Redis Pub/Sub adapter for cross-instance WebSocket broadcast.

package/dist/integrations/websocket.d.mts

@@ -1,4 +1,4 @@
 
-import { a as GeoRoomOptions, c as WebSocketClient, d as LocalWebSocketAdapter, f as WebSocketAdapter, i as GeoRoom, l as WebSocketMessage, n as GeoPoint, o as RoomManager, r as GeoPublishOpts, s as AuthResult, t as websocketPlugin, u as WebSocketPluginOptions } from "../websocket-BOXVggMf.mjs";
-import { a as PushRefRegistry, c as SerializedEntry, i as Principal, o as PushRefRegistryOptions, r as MemoryPushRefStore, s as PushRefStore } from "../pushref-registry-Dov9l4qE.mjs";
-export { type AuthResult, type GeoPoint, type GeoPublishOpts, GeoRoom, type GeoRoomOptions, LocalWebSocketAdapter, MemoryPushRefStore, type Principal, PushRefRegistry, type PushRefRegistryOptions, type PushRefStore, RoomManager, type SerializedEntry, type WebSocketAdapter, type WebSocketClient, type WebSocketMessage, type WebSocketPluginOptions, websocketPlugin };
+import { a as GeoRoomOptions, c as WebSocketClient, d as LocalWebSocketAdapter, f as WebSocketAdapter, i as GeoRoom, l as WebSocketMessage, n as GeoPoint, o as RoomManager, r as GeoPublishOpts, s as AuthResult, t as websocketPlugin, u as WebSocketPluginOptions } from "../websocket-Cs4awVyD.mjs";
+import { a as PushRefRegistry, c as SerializedEntry, i as Principal, o as PushRefRegistryOptions, r as MemoryPushRefStore, s as PushRefStore, u as DeadQueueEntry } from "../pushref-registry-UxCkoA4C.mjs";
+export { type AuthResult, type DeadQueueEntry, type GeoPoint, type GeoPublishOpts, GeoRoom, type GeoRoomOptions, LocalWebSocketAdapter, MemoryPushRefStore, type Principal, PushRefRegistry, type PushRefRegistryOptions, type PushRefStore, RoomManager, type SerializedEntry, type WebSocketAdapter, type WebSocketClient, type WebSocketMessage, type WebSocketPluginOptions, websocketPlugin };

package/dist/integrations/websocket.mjs

@@ -1,5 +1,5 @@
-/*! @classytic/arc v2.41.1 | MIT | https://classytic.com */
-import { n as declareRuntimeCapability } from "../runtimeCapabilities-CkhS6jn6.mjs";
+/*! @classytic/arc v2.44.0 | MIT | https://classytic.com */
+import { n as declareRuntimeCapability } from "../runtimeCapabilities-DIMKMV2G.mjs";
 import { randomUUID } from "node:crypto";
 import sjson from "secure-json-parse";
 import fp from "fastify-plugin";

package/dist/{interface-DEWNOMza.d.mts → interface-JJzwH4Ro.d.mts}

@@ -9,12 +9,20 @@
 interface IdempotencyResult {
   /** The idempotency key */
   key: string;
+  /**
+   * `fingerprintRequest` of the body the key was first used with. A retry under the same key
+   * with a different body is refused (422), never answered with this response. Absent on
+   * entries written before 2.43 — those replay without the check.
+   */
+  requestFingerprint?: string;
   /** HTTP status code of the cached response */
   statusCode: number;
   /** Response headers to replay */
   headers: Record<string, string>;
   /** Response body */
   body: unknown;
+  /** Binary responses are stored as base64 so JSON-backed stores preserve their bytes. */
+  bodyEncoding?: "base64";
   /** When this entry was created */
   createdAt: Date;
   /** When this entry expires */
@@ -30,9 +38,28 @@ interface IdempotencyLock {
   /** When the lock expires (auto-release) */
   expiresAt: Date;
 }
+/** What one atomic {@link IdempotencyStore.acquire} found. */
+type IdempotencyAcquisition = {
+  readonly status: "acquired";
+} | {
+  readonly status: "completed";
+  readonly result: IdempotencyResult;
+} | {
+  readonly status: "locked";
+};
 interface IdempotencyStore {
   /** Store name for logging */
   readonly name: string;
+  /** false when a conditional completion method cannot be atomic with this backing client. */
+  readonly supportsFencedCompletion?: boolean;
+  /** true when `setIfLocked` also releases the lock, so a completed request needs no `unlock`. */
+  readonly completionReleasesLock?: boolean;
+  /**
+   * ONE atomic step: an unexpired completion → `completed`; an unexpired lock → `locked`;
+   * otherwise `requestId` now holds the lock (first use, expired lease, or expired result).
+   * Optional — without it callers run `get` → `tryLock` → `get`.
+   */
+  acquire?(key: string, requestId: string, lockTtlMs: number): Promise<IdempotencyAcquisition>;
   /**
    * Get a cached result for an idempotency key.
    * Returns undefined if not found or expired.
@@ -43,6 +70,11 @@ interface IdempotencyStore {
    * TTL is handled by the store implementation.
    */
   set(key: string, result: Omit<IdempotencyResult, "key">): Promise<void>;
+  /**
+   * Atomically record only while requestId owns an unexpired lock. false means ownership lost.
+   * A store declaring `completionReleasesLock` clears the lock in the same write.
+   */
+  setIfLocked?(key: string, requestId: string, result: Omit<IdempotencyResult, "key">): Promise<boolean>;
   /**
    * Try to acquire a lock for processing a key.
    * Returns true if lock acquired, false if already locked.
@@ -73,6 +105,6 @@ interface IdempotencyStore {
 /**
  * Helper to create a result object
  */
-declare function createIdempotencyResult(statusCode: number, body: unknown, headers: Record<string, string>, ttlMs: number): Omit<IdempotencyResult, "key">;
+declare function createIdempotencyResult(statusCode: number, body: unknown, headers: Record<string, string>, ttlMs: number, requestFingerprint?: string): Omit<IdempotencyResult, "key">;
 //#endregion
-export { createIdempotencyResult as i, IdempotencyResult as n, IdempotencyStore as r, IdempotencyLock as t };
+export { createIdempotencyResult as a, IdempotencyStore as i, IdempotencyLock as n, IdempotencyResult as r, IdempotencyAcquisition as t };

package/dist/{jsonBody-ELR9lfeU.mjs → jsonBody-YIq-vGLv.mjs}

@@ -1,5 +1,5 @@
-/*! @classytic/arc v2.41.1 | MIT | https://classytic.com */
-import { t as ArcError } from "./errors-BH7YU_9O.mjs";
+/*! @classytic/arc v2.44.0 | MIT | https://classytic.com */
+import { t as ArcError } from "./errors-CW4anJBy.mjs";
 import sjson from "secure-json-parse";
 //#region src/utils/jsonBody.ts
 /**

package/dist/{keys-cpZCtcIE.mjs → keys-CpoiZ8hU.mjs}

@@ -1,4 +1,5 @@
-/*! @classytic/arc v2.41.1 | MIT | https://classytic.com */
+/*! @classytic/arc v2.44.0 | MIT | https://classytic.com */
+import { contentHash } from "@classytic/repo-core/hash";
 //#region src/cache/keys.ts
 /**
 * Cache Key Utilities
@@ -20,25 +21,13 @@ function tagVersionKey(tag) {
 	return `arc:tagver:${tag}`;
 }
 /**
-* Stable hash for query params.
-* Sorts keys recursively, serializes to JSON, then applies djb2 hash.
-* Returns hex string.
+* Digest of the query params for a cache key — repo-core's canonical serialiser (escaped,
+* type-preserving, key-order-free) under SHA-256. Two different queries never share a key: a
+* delimiter inside a value, `1` vs `"1"`, two dates or two regexes all stay distinct, and a
+* cryptographic digest leaves no crafted collision onto another caller's cached result.
 */
 function hashParams(params) {
-	return djb2(stableStringify(params)).toString(36);
-}
-function stableStringify(value) {
-	if (value === null || value === void 0) return "";
-	if (typeof value !== "object") return String(value);
-	if (Array.isArray(value)) return `[${value.map(stableStringify).join(",")}]`;
-	if (value instanceof RegExp) return `/${value.source}/${value.flags}`;
-	if (value instanceof Date) return `d${value.getTime()}`;
-	return "{" + Object.keys(value).sort().map((k) => `${k}:${stableStringify(value[k])}`).join(",") + "}";
-}
-function djb2(str) {
-	let hash = 5381;
-	for (let i = 0; i < str.length; i++) hash = (hash << 5) + hash + str.charCodeAt(i) >>> 0;
-	return hash;
+	return contentHash(params, { encoding: "base64url" });
 }
 //#endregion
 export { versionKey as i, hashParams as n, tagVersionKey as r, buildQueryKey as t };

package/dist/{loadResources-BPfWiI5s.mjs → loadResources-6jO52-RR.mjs}

@@ -1,6 +1,6 @@
-/*! @classytic/arc v2.41.1 | MIT | https://classytic.com */
-import { t as __exportAll } from "./rolldown-runtime-eysyzFAF.mjs";
-import { arcLog } from "./logger/index.mjs";
+/*! @classytic/arc v2.44.0 | MIT | https://classytic.com */
+import { r as __exportAll } from "./rolldown-runtime-MYrLNGnq.mjs";
+import { t as arcLog } from "./logger-D4V1zGLI.mjs";
 import { readdir } from "node:fs/promises";
 import { dirname, join, resolve } from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";

package/dist/{loadResourcesFromEntry-ixtfL3J2.mjs → loadResourcesFromEntry-MP8xEppu.mjs}

@@ -1,5 +1,5 @@
-/*! @classytic/arc v2.41.1 | MIT | https://classytic.com */
-import { t as ResourceRegistry } from "./ResourceRegistry-MGpXoxHZ.mjs";
+/*! @classytic/arc v2.44.0 | MIT | https://classytic.com */
+import { t as ResourceRegistry } from "./ResourceRegistry-DJxHUpE4.mjs";
 import { resolve } from "node:path";
 import { pathToFileURL } from "node:url";
 //#region src/cli/utils/loadResourcesFromEntry.ts

package/dist/logger/index.d.mts

@@ -27,7 +27,7 @@
  * log.warn('Something unexpected');
  * ```
  */
-interface ArcLoggerOptions {
+export interface ArcLoggerOptions {
   /**
    * Enable debug output.
    * - `true` or `'*'` — all modules
@@ -41,13 +41,13 @@ interface ArcLoggerOptions {
    */
   writer?: ArcLogWriter;
 }
-interface ArcLogWriter {
+export interface ArcLogWriter {
   debug: (...args: unknown[]) => void;
   info: (...args: unknown[]) => void;
   warn: (...args: unknown[]) => void;
   error: (...args: unknown[]) => void;
 }
-interface ArcLogger {
+export interface ArcLogger {
   debug: (...args: unknown[]) => void;
   info: (...args: unknown[]) => void;
   warn: (...args: unknown[]) => void;
@@ -61,14 +61,7 @@ interface ArcLogger {
  * constructed. Copying here would freeze the pre-Fastify view and send every
  * post-construction boot warning to the console instead of the app's logger.
  */
-declare function runWithArcLogger<T>(options: ArcLoggerOptions, fn: () => T): T;
-/**
- * Enter `options` for the remainder of the current async context.
- *
- * For Fastify's `onRequest` hook, where `run(store, done)` wraps the rest of
- * the request lifecycle. Outside a hook, prefer {@link runWithArcLogger}.
- */
-declare function enterArcLoggerScope(options: ArcLoggerOptions, done: () => void): void;
+export declare function runWithArcLogger<T>(options: ArcLoggerOptions, fn: () => T): T;
 /**
  * Configure the PROCESS-GLOBAL Arc logger — the fallback used outside any app.
  *
@@ -78,7 +71,7 @@ declare function enterArcLoggerScope(options: ArcLoggerOptions, done: () => void
  * standalone use — `defineResource()` at module import, CLI commands, and any
  * code running before or outside a `createApp` boot.
  */
-declare function configureArcLogger(options: ArcLoggerOptions): void;
+export declare function configureArcLogger(options: ArcLoggerOptions): void;
 /**
  * Create a module-scoped logger.
  *
@@ -96,13 +89,13 @@ declare function configureArcLogger(options: ArcLoggerOptions): void;
  * log.warn('No authenticate decorator found');
  * ```
  */
-declare function arcLog(module: string): ArcLogger;
+export declare function arcLog(module: string): ArcLogger;
 /**
  * Minimal structural slice of a pino-style logger (`fastify.log`). Each
  * level accepts `(msg)` or `(mergeObject, msg)` — the pino calling
  * convention, which differs from console's variadic `(...args)`.
  */
-interface PinoLike {
+export interface PinoLike {
   debug: (obj: unknown, msg?: string) => void;
   info: (obj: unknown, msg?: string) => void;
   warn: (obj: unknown, msg?: string) => void;
@@ -121,6 +114,5 @@ interface PinoLike {
  * `createApp` installs this automatically so arc-internal warnings flow
  * through the host's transports, level, and redaction config.
  */
-declare function createPinoWriter(logger: PinoLike): ArcLogWriter;
-//#endregion
-export { ArcLogWriter, ArcLogger, ArcLoggerOptions, PinoLike, arcLog, configureArcLogger, createPinoWriter, enterArcLoggerScope, runWithArcLogger };
+export declare function createPinoWriter(logger: PinoLike): ArcLogWriter;
+//#endregion

package/dist/logger/index.mjs

@@ -1,153 +1,2 @@
-/*! @classytic/arc v2.41.1 | MIT | https://classytic.com */
-import { AsyncLocalStorage } from "node:async_hooks";
-//#region src/logger/index.ts
-/**
-* Per-app logger options, resolved from the async context.
-*
-* The process-global below is a FALLBACK, not the source of truth. It used to
-* be both, and `configureArcLogger` overwrote it on every boot — so the
-* last-created app owned the writer for every app in the process. One app's
-* framework warnings then surfaced through another app's transports, level,
-* and redaction config. Fine for one-app-per-process; wrong for multi-app test
-* files and for serverless containers that reuse a warm process across apps.
-*
-* Follows the same shape as `requestContext`: the scope is entered once and
-* wraps everything downstream, so the 23 `arcLog()` call sites keep their
-* zero-argument signature and resolve correctly without threading a logger.
-*/
-const scope = new AsyncLocalStorage();
-let globalOptions = {};
-/** Active options: the app's if we're inside one, else the process fallback. */
-function resolveOptions() {
-	return scope.getStore() ?? globalOptions;
-}
-/**
-* Run `fn` with `options` as the active logger config.
-*
-* `options` is held BY REFERENCE deliberately: `createApp` enters the scope
-* before Fastify exists, then fills in the pino writer once `fastify.log` is
-* constructed. Copying here would freeze the pre-Fastify view and send every
-* post-construction boot warning to the console instead of the app's logger.
-*/
-function runWithArcLogger(options, fn) {
-	return scope.run(options, fn);
-}
-/**
-* Enter `options` for the remainder of the current async context.
-*
-* For Fastify's `onRequest` hook, where `run(store, done)` wraps the rest of
-* the request lifecycle. Outside a hook, prefer {@link runWithArcLogger}.
-*/
-function enterArcLoggerScope(options, done) {
-	scope.run(options, done);
-}
-/**
-* Configure the PROCESS-GLOBAL Arc logger — the fallback used outside any app.
-*
-* `createApp` no longer routes its writer through here; each app carries its
-* own scoped options (see {@link runWithArcLogger}) so two apps in one process
-* cannot overwrite each other's. This remains the way to configure arcLog for
-* standalone use — `defineResource()` at module import, CLI commands, and any
-* code running before or outside a `createApp` boot.
-*/
-function configureArcLogger(options) {
-	globalOptions = { ...options };
-}
-/**
-* Create a module-scoped logger.
-*
-* Debug and info messages are gated by the `ARC_DEBUG` env var or
-* `createApp({ debug })` option. Warnings always show (unless
-* `ARC_SUPPRESS_WARNINGS=1`). Errors always show.
-*
-* @param module - Module name (e.g., 'scope', 'elevation', 'sse', 'preset')
-* @returns Logger instance for that module
-*
-* @example
-* ```typescript
-* const log = arcLog('elevation');
-* log.debug('Checking elevation header');
-* log.warn('No authenticate decorator found');
-* ```
-*/
-function arcLog(module) {
-	const prefix = `[arc:${module}]`;
-	return {
-		debug(...args) {
-			if (isDebugEnabled(module)) getWriter().debug(prefix, ...args);
-		},
-		info(...args) {
-			if (isDebugEnabled(module)) getWriter().info(prefix, ...args);
-		},
-		warn(...args) {
-			if (isSuppressed()) return;
-			getWriter().warn(prefix, ...args);
-		},
-		error(...args) {
-			getWriter().error(prefix, ...args);
-		}
-	};
-}
-/**
-* Bridge an `ArcLogWriter` onto a pino-style logger (`fastify.log`).
-*
-* arcLog call sites use the console convention — positional args like
-* `log.warn("message", { userId })` — which pino would silently drop
-* (extra args are printf interpolation values there). The bridge folds
-* string args into the message, merges object args into the pino merge
-* object, and maps `Error` instances to `{ err }` so pino's error
-* serializer applies.
-*
-* `createApp` installs this automatically so arc-internal warnings flow
-* through the host's transports, level, and redaction config.
-*/
-function createPinoWriter(logger) {
-	const emit = (level) => (...args) => {
-		const parts = [];
-		let merge;
-		for (const arg of args) if (typeof arg === "string") parts.push(arg);
-		else if (arg instanceof Error) merge = {
-			...merge ?? {},
-			err: arg
-		};
-		else if (arg !== null && typeof arg === "object") merge = {
-			...merge ?? {},
-			...arg
-		};
-		else parts.push(String(arg));
-		const msg = parts.join(" ");
-		if (merge) logger[level](merge, msg);
-		else logger[level](msg);
-	};
-	return {
-		debug: emit("debug"),
-		info: emit("info"),
-		warn: emit("warn"),
-		error: emit("error")
-	};
-}
-function getWriter() {
-	return resolveOptions().writer ?? console;
-}
-function isDebugEnabled(module) {
-	const configDebug = resolveOptions().debug;
-	if (configDebug !== void 0 && configDebug !== false) return matchesModule(configDebug, module);
-	const envDebug = typeof process !== "undefined" ? process.env?.ARC_DEBUG : void 0;
-	if (envDebug) return matchesModule(envDebug, module);
-	return false;
-}
-function matchesModule(debug, module) {
-	if (debug === true) return true;
-	if (typeof debug === "string") {
-		const normalized = debug.trim();
-		if (normalized === "1" || normalized === "true" || normalized === "*") return true;
-		return normalized.split(",").map((s) => s.trim()).includes(module);
-	}
-	return false;
-}
-function isSuppressed() {
-	const env = typeof process !== "undefined" ? process.env?.ARC_SUPPRESS_WARNINGS : void 0;
-	return env === "1" || env === "true";
-}
-//#endregion
-export { arcLog, configureArcLogger, createPinoWriter, enterArcLoggerScope, runWithArcLogger };
+/*! @classytic/arc v2.44.0 | MIT | https://classytic.com */
+export { t as arcLog, n as configureArcLogger, r as createPinoWriter, i as runWithArcLogger } from "../logger-D4V1zGLI.mjs";

package/dist/logger-D4V1zGLI.mjs

@@ -0,0 +1,160 @@
+/*! @classytic/arc v2.44.0 | MIT | https://classytic.com */
+import { AsyncLocalStorage } from "node:async_hooks";
+//#region src/logger/scope.ts
+/**
+* Internal — NOT a package entry. The per-app logger scope that
+* `@classytic/arc/logger` resolves against, plus the one hook-shaped entry
+* point `createApp` needs. Kept off the public barrel: hosts use
+* `runWithArcLogger` from `@classytic/arc/logger`.
+*
+* Per-app logger options, resolved from the async context.
+*
+* The process-global in `./index.ts` is a FALLBACK, not the source of truth. It
+* used to be both, and `configureArcLogger` overwrote it on every boot — so the
+* last-created app owned the writer for every app in the process. One app's
+* framework warnings then surfaced through another app's transports, level,
+* and redaction config. Fine for one-app-per-process; wrong for multi-app test
+* files and for serverless containers that reuse a warm process across apps.
+*
+* Follows the same shape as `requestContext`: the scope is entered once and
+* wraps everything downstream, so the `arcLog()` call sites keep their
+* zero-argument signature and resolve correctly without threading a logger.
+*/
+const arcLoggerScope = new AsyncLocalStorage();
+/**
+* Enter `options` for the remainder of the current async context.
+*
+* For Fastify's `onRequest` hook, where `run(store, done)` wraps the rest of
+* the request lifecycle. Outside a hook, use `runWithArcLogger`.
+*/
+function enterArcLoggerScope(options, done) {
+	arcLoggerScope.run(options, done);
+}
+//#endregion
+//#region src/logger/index.ts
+let globalOptions = {};
+/** Active options: the app's if we're inside one, else the process fallback. */
+function resolveOptions() {
+	return arcLoggerScope.getStore() ?? globalOptions;
+}
+/**
+* Run `fn` with `options` as the active logger config.
+*
+* `options` is held BY REFERENCE deliberately: `createApp` enters the scope
+* before Fastify exists, then fills in the pino writer once `fastify.log` is
+* constructed. Copying here would freeze the pre-Fastify view and send every
+* post-construction boot warning to the console instead of the app's logger.
+*/
+function runWithArcLogger(options, fn) {
+	return arcLoggerScope.run(options, fn);
+}
+/**
+* Configure the PROCESS-GLOBAL Arc logger — the fallback used outside any app.
+*
+* `createApp` no longer routes its writer through here; each app carries its
+* own scoped options (see {@link runWithArcLogger}) so two apps in one process
+* cannot overwrite each other's. This remains the way to configure arcLog for
+* standalone use — `defineResource()` at module import, CLI commands, and any
+* code running before or outside a `createApp` boot.
+*/
+function configureArcLogger(options) {
+	globalOptions = { ...options };
+}
+/**
+* Create a module-scoped logger.
+*
+* Debug and info messages are gated by the `ARC_DEBUG` env var or
+* `createApp({ debug })` option. Warnings always show (unless
+* `ARC_SUPPRESS_WARNINGS=1`). Errors always show.
+*
+* @param module - Module name (e.g., 'scope', 'elevation', 'sse', 'preset')
+* @returns Logger instance for that module
+*
+* @example
+* ```typescript
+* const log = arcLog('elevation');
+* log.debug('Checking elevation header');
+* log.warn('No authenticate decorator found');
+* ```
+*/
+function arcLog(module) {
+	const prefix = `[arc:${module}]`;
+	return {
+		debug(...args) {
+			if (isDebugEnabled(module)) getWriter().debug(prefix, ...args);
+		},
+		info(...args) {
+			if (isDebugEnabled(module)) getWriter().info(prefix, ...args);
+		},
+		warn(...args) {
+			if (isSuppressed()) return;
+			getWriter().warn(prefix, ...args);
+		},
+		error(...args) {
+			getWriter().error(prefix, ...args);
+		}
+	};
+}
+/**
+* Bridge an `ArcLogWriter` onto a pino-style logger (`fastify.log`).
+*
+* arcLog call sites use the console convention — positional args like
+* `log.warn("message", { userId })` — which pino would silently drop
+* (extra args are printf interpolation values there). The bridge folds
+* string args into the message, merges object args into the pino merge
+* object, and maps `Error` instances to `{ err }` so pino's error
+* serializer applies.
+*
+* `createApp` installs this automatically so arc-internal warnings flow
+* through the host's transports, level, and redaction config.
+*/
+function createPinoWriter(logger) {
+	const emit = (level) => (...args) => {
+		const parts = [];
+		let merge;
+		for (const arg of args) if (typeof arg === "string") parts.push(arg);
+		else if (arg instanceof Error) merge = {
+			...merge ?? {},
+			err: arg
+		};
+		else if (arg !== null && typeof arg === "object") merge = {
+			...merge ?? {},
+			...arg
+		};
+		else parts.push(String(arg));
+		const msg = parts.join(" ");
+		if (merge) logger[level](merge, msg);
+		else logger[level](msg);
+	};
+	return {
+		debug: emit("debug"),
+		info: emit("info"),
+		warn: emit("warn"),
+		error: emit("error")
+	};
+}
+function getWriter() {
+	return resolveOptions().writer ?? console;
+}
+function isDebugEnabled(module) {
+	const configDebug = resolveOptions().debug;
+	if (configDebug !== void 0 && configDebug !== false) return matchesModule(configDebug, module);
+	const envDebug = typeof process !== "undefined" ? process.env?.ARC_DEBUG : void 0;
+	if (envDebug) return matchesModule(envDebug, module);
+	return false;
+}
+function matchesModule(debug, module) {
+	if (debug === true) return true;
+	if (typeof debug === "string") {
+		const normalized = debug.trim();
+		if (normalized === "1" || normalized === "true" || normalized === "*") return true;
+		return normalized.split(",").map((s) => s.trim()).includes(module);
+	}
+	return false;
+}
+function isSuppressed() {
+	const env = typeof process !== "undefined" ? process.env?.ARC_SUPPRESS_WARNINGS : void 0;
+	return env === "1" || env === "true";
+}
+//#endregion
+export { enterArcLoggerScope as a, runWithArcLogger as i, configureArcLogger as n, createPinoWriter as r, arcLog as t };