@aztec-labs/foundation 6.0.0-nightly.20260829

package/dest/log/bigint-utils.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Converts bigint values to strings recursively in a log object to avoid serialization issues.
+ */
+export declare function convertBigintsToStrings(obj: unknown): unknown;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYmlnaW50LXV0aWxzLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvbG9nL2JpZ2ludC11dGlscy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7R0FFRztBQUNILHdCQUFnQix1QkFBdUIsQ0FBQyxHQUFHLEVBQUUsT0FBTyxHQUFHLE9BQU8sQ0FxQjdEIn0=

package/dest/log/bigint-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bigint-utils.d.ts","sourceRoot":"","sources":["../../src/log/bigint-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAqB7D"}

package/dest/log/bigint-utils.js

@@ -0,0 +1,21 @@
+/**
+ * Converts bigint values to strings recursively in a log object to avoid serialization issues.
+ */ export function convertBigintsToStrings(obj) {
+    if (typeof obj === 'bigint') {
+        return String(obj);
+    }
+    if (Array.isArray(obj)) {
+        return obj.map((item)=>convertBigintsToStrings(item));
+    }
+    if (obj !== null && typeof obj === 'object') {
+        if (typeof obj.toJSON === 'function') {
+            return convertBigintsToStrings(obj.toJSON());
+        }
+        const result = {};
+        for(const key in obj){
+            result[key] = convertBigintsToStrings(obj[key]);
+        }
+        return result;
+    }
+    return obj;
+}

package/dest/log/console.d.ts

@@ -0,0 +1,11 @@
+import type { LogFn } from './log_fn.js';
+/**
+ * Creates a Logger function with an optional prefix for log messages.
+ * If a prefix is provided, the created logger will prepend it to each log message.
+ * If no prefix is provided, the default console.log will be returned.
+ *
+ * @param prefix - The optional string to prepend to each log message.
+ * @returns A Logger function that accepts any number of arguments and logs them with the specified prefix.
+ */
+export declare function createConsoleLogger(prefix?: string): LogFn;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uc29sZS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2xvZy9jb25zb2xlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUNBLE9BQU8sS0FBSyxFQUFFLEtBQUssRUFBRSxNQUFNLGFBQWEsQ0FBQztBQTBCekM7Ozs7Ozs7R0FPRztBQUNILHdCQUFnQixtQkFBbUIsQ0FBQyxNQUFNLENBQUMsRUFBRSxNQUFNLEdBQUcsS0FBSyxDQU0xRCJ9

package/dest/log/console.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../../src/log/console.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AA0BzC;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAM1D"}

package/dest/log/console.js

@@ -0,0 +1,36 @@
+/* eslint-disable no-console */ /**
+ * ConsoleLogger is a utility class that provides customizable console logging functionality.
+ * It allows setting a custom prefix for log messages and an optional custom logger function,
+ * which can be useful for controlling the format of the output or redirecting logs to a different destination.
+ */ class ConsoleLogger {
+    prefix;
+    logger;
+    constructor(prefix, logger = console.log){
+        this.prefix = prefix;
+        this.logger = logger;
+    }
+    /**
+   * Log messages with the specified prefix using the provided logger.
+   * By default, it uses 'console.log' as the logger but can be overridden
+   * during ConsoleLogger instantiation. This method allows for easy
+   * organization and readability of log messages in the console.
+   *
+   * @param args - The data to be logged, any number of arguments can be passed to this function.
+   */ log(...args) {
+        this.logger(`${this.prefix}:`, ...args);
+    }
+}
+/**
+ * Creates a Logger function with an optional prefix for log messages.
+ * If a prefix is provided, the created logger will prepend it to each log message.
+ * If no prefix is provided, the default console.log will be returned.
+ *
+ * @param prefix - The optional string to prepend to each log message.
+ * @returns A Logger function that accepts any number of arguments and logs them with the specified prefix.
+ */ export function createConsoleLogger(prefix) {
+    if (prefix) {
+        const logger = new ConsoleLogger(prefix, console.log);
+        return (...args)=>logger.log(...args);
+    }
+    return console.log;
+}

package/dest/log/gcloud-logger-config.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Pino configuration for google cloud observability. Tweaks message and timestamp,
+ * adds trace context attributes, and injects severity level.
+ * Adapted from https://cloud.google.com/trace/docs/setup/nodejs-ot#config-structured-logging.
+ */
+export declare const GoogleCloudLoggerConfig: {
+    messageKey: string;
+    formatters: {
+        log(object: Record<string, unknown>): Record<string, unknown>;
+        level(label: string, level: number): object;
+    };
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZ2Nsb3VkLWxvZ2dlci1jb25maWcuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9sb2cvZ2Nsb3VkLWxvZ2dlci1jb25maWcudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBVUE7Ozs7R0FJRztBQUNILGVBQU8sTUFBTSx1QkFBdUI7Ozs7OztDQXFETixDQUFDIn0=

package/dest/log/gcloud-logger-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gcloud-logger-config.d.ts","sourceRoot":"","sources":["../../src/log/gcloud-logger-config.ts"],"names":[],"mappings":"AAUA;;;;GAIG;AACH,eAAO,MAAM,uBAAuB;;;;;;CAqDN,CAAC"}

package/dest/log/gcloud-logger-config.js

@@ -0,0 +1,61 @@
+import { convertBigintsToStrings } from './bigint-utils.js';
+/* eslint-disable camelcase */ const GOOGLE_CLOUD_TRACE_ID = 'logging.googleapis.com/trace';
+const GOOGLE_CLOUD_SPAN_ID = 'logging.googleapis.com/spanId';
+const GOOGLE_CLOUD_TRACE_SAMPLED = 'logging.googleapis.com/trace_sampled';
+/**
+ * Pino configuration for google cloud observability. Tweaks message and timestamp,
+ * adds trace context attributes, and injects severity level.
+ * Adapted from https://cloud.google.com/trace/docs/setup/nodejs-ot#config-structured-logging.
+ */ export const GoogleCloudLoggerConfig = {
+    messageKey: 'message',
+    formatters: {
+        log (object) {
+            // Convert bigints to strings recursively to avoid serialization issues
+            object = convertBigintsToStrings(object);
+            // Add trace context attributes following Cloud Logging structured log format described
+            // in https://cloud.google.com/logging/docs/structured-logging#special-payload-fields
+            const { trace_id, span_id, trace_flags, ...rest } = object;
+            if (trace_id && span_id) {
+                return {
+                    [GOOGLE_CLOUD_TRACE_ID]: trace_id,
+                    [GOOGLE_CLOUD_SPAN_ID]: span_id,
+                    [GOOGLE_CLOUD_TRACE_SAMPLED]: trace_flags ? trace_flags === '01' : undefined,
+                    trace_flags,
+                    ...rest
+                };
+            }
+            return object;
+        },
+        level (label, level) {
+            // Inspired by https://github.com/pinojs/pino/issues/726#issuecomment-605814879
+            // Severity labels https://cloud.google.com/logging/docs/reference/v2/rest/v2/LogEntry#LogSeverity
+            let severity;
+            switch(label){
+                case 'trace':
+                case 'debug':
+                case 'verbose':
+                    severity = 'DEBUG';
+                    break;
+                case 'info':
+                    severity = 'INFO';
+                    break;
+                case 'warn':
+                    severity = 'WARNING';
+                    break;
+                case 'error':
+                    severity = 'ERROR';
+                    break;
+                case 'fatal':
+                    severity = 'CRITICAL';
+                    break;
+                default:
+                    severity = 'DEFAULT';
+                    break;
+            }
+            return {
+                severity,
+                level
+            };
+        }
+    }
+};

package/dest/log/index.d.ts

@@ -0,0 +1,7 @@
+export * from './console.js';
+export * from './libp2p_logger.js';
+export * from './log_fn.js';
+export * from './noir_debug_log_util.js';
+export * from './pino-logger.js';
+export * from './log-levels.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9sb2cvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsY0FBYyxjQUFjLENBQUM7QUFDN0IsY0FBYyxvQkFBb0IsQ0FBQztBQUNuQyxjQUFjLGFBQWEsQ0FBQztBQUM1QixjQUFjLDBCQUEwQixDQUFDO0FBQ3pDLGNBQWMsa0JBQWtCLENBQUM7QUFDakMsY0FBYyxpQkFBaUIsQ0FBQyJ9

package/dest/log/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/log/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC"}

package/dest/log/index.js

@@ -0,0 +1,6 @@
+export * from './console.js';
+export * from './libp2p_logger.js';
+export * from './log_fn.js';
+export * from './noir_debug_log_util.js';
+export * from './pino-logger.js';
+export * from './log-levels.js';

package/dest/log/libp2p_logger.d.ts

@@ -0,0 +1,10 @@
+import type { ComponentLogger } from '@libp2p/interface';
+import { type LoggerBindings } from './pino-logger.js';
+/**
+ * Creates a libp2p compatible logger that wraps our pino logger.
+ * This adapter implements the ComponentLogger interface required by libp2p.
+ * @param namespace - Base namespace for the logger
+ * @param bindings - Optional bindings to pass to the logger (actor, instanceId)
+ */
+export declare function createLibp2pComponentLogger(namespace: string, bindings?: LoggerBindings): ComponentLogger;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibGlicDJwX2xvZ2dlci5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2xvZy9saWJwMnBfbG9nZ2VyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxFQUFFLGVBQWUsRUFBVSxNQUFNLG1CQUFtQixDQUFDO0FBSWpFLE9BQU8sRUFBRSxLQUFLLGNBQWMsRUFBc0IsTUFBTSxrQkFBa0IsQ0FBQztBQUUzRTs7Ozs7R0FLRztBQUNILHdCQUFnQiwyQkFBMkIsQ0FBQyxTQUFTLEVBQUUsTUFBTSxFQUFFLFFBQVEsQ0FBQyxFQUFFLGNBQWMsR0FBRyxlQUFlLENBSXpHIn0=

package/dest/log/libp2p_logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"libp2p_logger.d.ts","sourceRoot":"","sources":["../../src/log/libp2p_logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAU,MAAM,mBAAmB,CAAC;AAIjE,OAAO,EAAE,KAAK,cAAc,EAAsB,MAAM,kBAAkB,CAAC;AAE3E;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,eAAe,CAIzG"}

package/dest/log/libp2p_logger.js

@@ -0,0 +1,76 @@
+import { getLogLevelFromFilters } from './log-filters.js';
+import { logFilters, logger } from './pino-logger.js';
+/**
+ * Creates a libp2p compatible logger that wraps our pino logger.
+ * This adapter implements the ComponentLogger interface required by libp2p.
+ * @param namespace - Base namespace for the logger
+ * @param bindings - Optional bindings to pass to the logger (actor, instanceId)
+ */ export function createLibp2pComponentLogger(namespace, bindings) {
+    return {
+        forComponent: (component)=>createLibp2pLogger(`${namespace}:${component}`, bindings)
+    };
+}
+// Lipp2p libraries use arbitrary string substitutions, so we need to replace them with %s, this is slow so avoid doing it unless trace debugging
+function replaceFormatting(message) {
+    // Message can sometimes not be a string, e.g. an error object, just return it as is
+    if (!message?.replace) {
+        return message;
+    }
+    return message.replace(/(%p|%a)/g, '%s');
+}
+function createLibp2pLogger(component, bindings) {
+    // Create a direct pino logger instance for libp2p that supports string interpolation
+    const actor = bindings?.actor;
+    const instanceId = bindings?.instanceId;
+    const log = logger.child({
+        module: component,
+        ...actor && {
+            actor
+        },
+        ...instanceId && {
+            instanceId
+        }
+    }, {
+        level: getLogLevelFromFilters(logFilters, component)
+    });
+    const logIfEnabled = (level, message, ...args)=>{
+        if (!log.isLevelEnabled(level)) {
+            return;
+        }
+        log[level](replaceFormatting(message), ...formatArgs(message, args));
+    };
+    // Default log level is trace as this is super super noisy
+    const logFn = (message, ...args)=>{
+        logIfEnabled('trace', message, ...args);
+    };
+    return Object.assign(logFn, {
+        enabled: log.isLevelEnabled('debug'),
+        error (message, ...args) {
+            // We write error outputs as debug as they are often expected, e.g. connection errors can happen in happy paths
+            logIfEnabled('debug', `error: ${message}`, ...args);
+        },
+        debug (message, ...args) {
+            logIfEnabled('debug', message, ...args);
+        },
+        info (message, ...args) {
+            logIfEnabled('info', message, ...args);
+        },
+        warn (message, ...args) {
+            logIfEnabled('warn', message, ...args);
+        },
+        trace (message, ...args) {
+            logIfEnabled('trace', message, ...args);
+        }
+    });
+}
+function formatArgs(message, args) {
+    if (!args) {
+        return args;
+    }
+    return args.map((arg)=>{
+        if (typeof arg === 'object' && arg && 'err' in arg && arg.err instanceof Error && 'type' in arg.err && arg.err.type === 'AbortError') {
+            delete arg.err; // Remove the AbortError from the logs
+        }
+        return arg;
+    });
+}

package/dest/log/log-filters.d.ts

@@ -0,0 +1,20 @@
+import { type LogLevel } from './log-levels.js';
+export type LogFilters = [string, LogLevel][];
+export declare function getLogLevelFromFilters(filters: LogFilters, module: string): LogLevel | undefined;
+/**
+ * Parses the LOG_LEVEL env string into a default level and per-module filter overrides.
+ *
+ * Format: `<default_level>;<level>:<module1>,<module2>;<level>:<module3>;...`
+ * - First segment (before the first `;`) is the default log level for all modules.
+ * - Remaining segments are `level:module` pairs: apply the given level to the listed modules (comma-separated).
+ * - Later filters override earlier ones for overlapping module matches.
+ * - The `aztec:` prefix is stripped from module names; spaces are trimmed.
+ *
+ * @example
+ * ```ts
+ * parseLogLevel('debug;warn:module1,module2;error:module3', 'info')
+ * // => ['debug', [['module3', 'error'], ['module2', 'warn'], ['module1', 'warn']]]
+ * ```
+ */
+export declare function parseLogLevelEnvVar(logLevelEnvVar: string | undefined, defaultLevel: LogLevel): [LogLevel, LogFilters];
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibG9nLWZpbHRlcnMuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9sb2cvbG9nLWZpbHRlcnMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLEtBQUssUUFBUSxFQUFhLE1BQU0saUJBQWlCLENBQUM7QUFFM0QsTUFBTSxNQUFNLFVBQVUsR0FBRyxDQUFDLE1BQU0sRUFBRSxRQUFRLENBQUMsRUFBRSxDQUFDO0FBRTlDLHdCQUFnQixzQkFBc0IsQ0FBQyxPQUFPLEVBQUUsVUFBVSxFQUFFLE1BQU0sRUFBRSxNQUFNLEdBQUcsUUFBUSxHQUFHLFNBQVMsQ0FlaEc7QUFFRDs7Ozs7Ozs7Ozs7Ozs7R0FjRztBQUNILHdCQUFnQixtQkFBbUIsQ0FDakMsY0FBYyxFQUFFLE1BQU0sR0FBRyxTQUFTLEVBQ2xDLFlBQVksRUFBRSxRQUFRLEdBQ3JCLENBQUMsUUFBUSxFQUFFLFVBQVUsQ0FBQyxDQU94QiJ9

package/dest/log/log-filters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-filters.d.ts","sourceRoot":"","sources":["../../src/log/log-filters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAa,MAAM,iBAAiB,CAAC;AAE3D,MAAM,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC;AAE9C,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAehG;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CACjC,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,YAAY,EAAE,QAAQ,GACrB,CAAC,QAAQ,EAAE,UAAU,CAAC,CAOxB"}

package/dest/log/log-filters.js

@@ -0,0 +1,73 @@
+import { LogLevels } from './log-levels.js';
+export function getLogLevelFromFilters(filters, module) {
+    for (const [filterModule, level] of filters){
+        try {
+            const regex = new RegExp(filterModule);
+            if (regex.test(module)) {
+                return level;
+            }
+        } catch  {
+            // If regex is invalid, fall back to startsWith check
+            if (module.startsWith(filterModule)) {
+                return level;
+            }
+        }
+    }
+    return undefined;
+}
+/**
+ * Parses the LOG_LEVEL env string into a default level and per-module filter overrides.
+ *
+ * Format: `<default_level>;<level>:<module1>,<module2>;<level>:<module3>;...`
+ * - First segment (before the first `;`) is the default log level for all modules.
+ * - Remaining segments are `level:module` pairs: apply the given level to the listed modules (comma-separated).
+ * - Later filters override earlier ones for overlapping module matches.
+ * - The `aztec:` prefix is stripped from module names; spaces are trimmed.
+ *
+ * @example
+ * ```ts
+ * parseLogLevel('debug;warn:module1,module2;error:module3', 'info')
+ * // => ['debug', [['module3', 'error'], ['module2', 'warn'], ['module1', 'warn']]]
+ * ```
+ */ export function parseLogLevelEnvVar(logLevelEnvVar, defaultLevel) {
+    if (!logLevelEnvVar) {
+        return [
+            defaultLevel,
+            []
+        ];
+    }
+    const [level] = logLevelEnvVar.split(';', 1);
+    assertValidLogLevel(level);
+    return [
+        level,
+        parseFilters(logLevelEnvVar.slice(level.length + 1))
+    ];
+}
+function assertValidLogLevel(level) {
+    if (!LogLevels.includes(level)) {
+        throw new Error(`Invalid log level: ${level}`);
+    }
+}
+function parseFilters(definition) {
+    if (!definition) {
+        return [];
+    }
+    const statements = definition.split(';');
+    const filters = [];
+    for (const statement of statements){
+        const [level] = statement.split(':', 1);
+        const modules = statement.slice(level.length + 1);
+        if (!modules || !level) {
+            throw new Error(`Invalid log filter statement: ${statement}`);
+        }
+        const sanitizedLevel = level.trim().toLowerCase();
+        assertValidLogLevel(sanitizedLevel);
+        for (const module of modules.split(',')){
+            filters.push([
+                module.trim().toLowerCase().replace(/^aztec:/, ''),
+                sanitizedLevel
+            ]);
+        }
+    }
+    return filters.reverse();
+}

package/dest/log/log-levels.d.ts

@@ -0,0 +1,3 @@
+export declare const LogLevels: readonly ["silent", "fatal", "error", "warn", "info", "verbose", "debug", "trace"];
+export type LogLevel = (typeof LogLevels)[number];
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibG9nLWxldmVscy5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2xvZy9sb2ctbGV2ZWxzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLGVBQU8sTUFBTSxTQUFTLG9GQUFxRixDQUFDO0FBRTVHLE1BQU0sTUFBTSxRQUFRLEdBQUcsQ0FBQyxPQUFPLFNBQVMsQ0FBQyxDQUFDLE1BQU0sQ0FBQyxDQUFDIn0=

package/dest/log/log-levels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-levels.d.ts","sourceRoot":"","sources":["../../src/log/log-levels.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS,oFAAqF,CAAC;AAE5G,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dest/log/log-levels.js

@@ -0,0 +1,10 @@
+export const LogLevels = [
+    'silent',
+    'fatal',
+    'error',
+    'warn',
+    'info',
+    'verbose',
+    'debug',
+    'trace'
+];

package/dest/log/log_fn.d.ts

@@ -0,0 +1,7 @@
+/** Structured log data to include with the message. */
+export type LogData = Record<string, string | number | bigint | boolean | {
+    toString(): string;
+} | undefined | null>;
+/** A callable logger instance. */
+export type LogFn = (msg: string, data?: unknown) => void;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibG9nX2ZuLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvbG9nL2xvZ19mbi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSx1REFBdUQ7QUFDdkQsTUFBTSxNQUFNLE9BQU8sR0FBRyxNQUFNLENBQUMsTUFBTSxFQUFFLE1BQU0sR0FBRyxNQUFNLEdBQUcsTUFBTSxHQUFHLE9BQU8sR0FBRztJQUFFLFFBQVEsSUFBSSxNQUFNLENBQUE7Q0FBRSxHQUFHLFNBQVMsR0FBRyxJQUFJLENBQUMsQ0FBQztBQUVySCxrQ0FBa0M7QUFDbEMsTUFBTSxNQUFNLEtBQUssR0FBRyxDQUFDLEdBQUcsRUFBRSxNQUFNLEVBQUUsSUFBSSxDQUFDLEVBQUUsT0FBTyxLQUFLLElBQUksQ0FBQyJ9

package/dest/log/log_fn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log_fn.d.ts","sourceRoot":"","sources":["../../src/log/log_fn.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG;IAAE,QAAQ,IAAI,MAAM,CAAA;CAAE,GAAG,SAAS,GAAG,IAAI,CAAC,CAAC;AAErH,kCAAkC;AAClC,MAAM,MAAM,KAAK,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC"}

package/dest/log/log_fn.js

@@ -0,0 +1 @@
+/** Structured log data to include with the message. */ /** A callable logger instance. */ export { };

package/dest/log/noir_debug_log_util.d.ts

@@ -0,0 +1,14 @@
+interface Printable {
+    toString(): string;
+}
+/**
+ * Format a debug string filling in `'{0}'` entries with their
+ * corresponding values from the args array, amd `'{}'` with the whole array.
+ *
+ * @param formatStr - str of form `'this is a string with some entries like {0} and {1}'`
+ * @param args - array of fields to fill in the string format entries with
+ * @returns formatted string
+ */
+export declare function applyStringFormatting(formatStr: string, args: Printable[]): string;
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibm9pcl9kZWJ1Z19sb2dfdXRpbC5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2xvZy9ub2lyX2RlYnVnX2xvZ191dGlsLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLFVBQVUsU0FBUztJQUNqQixRQUFRLElBQUksTUFBTSxDQUFDO0NBQ3BCO0FBRUQ7Ozs7Ozs7R0FPRztBQUNILHdCQUFnQixxQkFBcUIsQ0FBQyxTQUFTLEVBQUUsTUFBTSxFQUFFLElBQUksRUFBRSxTQUFTLEVBQUUsR0FBRyxNQUFNLENBUWxGIn0=

package/dest/log/noir_debug_log_util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"noir_debug_log_util.d.ts","sourceRoot":"","sources":["../../src/log/noir_debug_log_util.ts"],"names":[],"mappings":"AAAA,UAAU,SAAS;IACjB,QAAQ,IAAI,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,MAAM,CAQlF"}

package/dest/log/noir_debug_log_util.js

@@ -0,0 +1,14 @@
+/**
+ * Format a debug string filling in `'{0}'` entries with their
+ * corresponding values from the args array, amd `'{}'` with the whole array.
+ *
+ * @param formatStr - str of form `'this is a string with some entries like {0} and {1}'`
+ * @param args - array of fields to fill in the string format entries with
+ * @returns formatted string
+ */ export function applyStringFormatting(formatStr, args) {
+    return formatStr.replace(/{(\d+)}/g, (match, index)=>{
+        return typeof args[index] === 'undefined' ? match : args[index].toString();
+    }).replace(/{}/g, (_match, _index)=>{
+        return args.toString();
+    });
+}

package/dest/log/pino-logger-server.d.ts

@@ -0,0 +1,9 @@
+import { type LoggerBindings } from './pino-logger.js';
+/** Returns the current bindings from AsyncLocalStorage, if any. */
+export declare function getBindings(): LoggerBindings | undefined;
+/**
+ * Runs a callback within a bindings context. All loggers created within the callback
+ * will automatically inherit the bindings (actor, instanceId) via the log bindings handler.
+ */
+export declare function withLoggerBindings<T>(bindings: LoggerBindings, callback: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGluby1sb2dnZXItc2VydmVyLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvbG9nL3Bpbm8tbG9nZ2VyLXNlcnZlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFFQSxPQUFPLEVBQUUsS0FBSyxjQUFjLEVBQW1ELE1BQU0sa0JBQWtCLENBQUM7QUFLeEcsbUVBQW1FO0FBQ25FLHdCQUFnQixXQUFXLElBQUksY0FBYyxHQUFHLFNBQVMsQ0FFeEQ7QUFFRDs7O0dBR0c7QUFDSCx3QkFBc0Isa0JBQWtCLENBQUMsQ0FBQyxFQUFFLFFBQVEsRUFBRSxjQUFjLEVBQUUsUUFBUSxFQUFFLE1BQU0sT0FBTyxDQUFDLENBQUMsQ0FBQyxHQUFHLE9BQU8sQ0FBQyxDQUFDLENBQUMsQ0FRNUcifQ==

package/dest/log/pino-logger-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pino-logger-server.d.ts","sourceRoot":"","sources":["../../src/log/pino-logger-server.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,cAAc,EAAmD,MAAM,kBAAkB,CAAC;AAKxG,mEAAmE;AACnE,wBAAgB,WAAW,IAAI,cAAc,GAAG,SAAS,CAExD;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EAAE,QAAQ,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAQ5G"}

package/dest/log/pino-logger-server.js

@@ -0,0 +1,18 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { addLogBindingsHandler, removeLogBindingsHandler } from './pino-logger.js';
+/** AsyncLocalStorage for logger bindings context propagation (Node.js only). */ const bindingsStorage = new AsyncLocalStorage();
+/** Returns the current bindings from AsyncLocalStorage, if any. */ export function getBindings() {
+    return bindingsStorage.getStore();
+}
+/**
+ * Runs a callback within a bindings context. All loggers created within the callback
+ * will automatically inherit the bindings (actor, instanceId) via the log bindings handler.
+ */ export async function withLoggerBindings(bindings, callback) {
+    const handler = ()=>bindingsStorage.getStore();
+    addLogBindingsHandler(handler);
+    try {
+        return await bindingsStorage.run(bindings, callback);
+    } finally{
+        removeLogBindingsHandler(handler);
+    }
+}

package/dest/log/pino-logger.d.ts

@@ -0,0 +1,86 @@
+import { type Color } from 'colorette';
+import type { Writable } from 'stream';
+import type { LogLevel } from './log-levels.js';
+import type { LogData, LogFn } from './log_fn.js';
+/** Optional bindings to pass to createLogger for additional context. */
+export type LoggerBindings = {
+    /** Actor label shown in logs (e.g., 'MAIN', 'prover-node'). */
+    actor?: string;
+    /** Instance identifier for distinguishing multiple instances of the same component. */
+    instanceId?: string;
+};
+type LogBindingsHandler = () => LoggerBindings | undefined;
+export declare function addLogBindingsHandler(handler: LogBindingsHandler): void;
+export declare function removeLogBindingsHandler(handler: LogBindingsHandler): void;
+export declare function createLogger(module: string, bindings?: LoggerBindings): Logger;
+/**
+ * Returns a logger for the given module. If loggerOrBindings is already a Logger, returns it directly.
+ * Otherwise, creates a new logger with the given module name and bindings.
+ */
+export declare function resolveLogger(module: string, loggerOrBindings?: Logger | LoggerBindings): Logger;
+type LogDataHandler = (data: LogData) => LogData;
+export declare function addLogDataHandler(handler: LogDataHandler): void;
+export declare const logLevel: "debug" | "error" | "fatal" | "info" | "silent" | "trace" | "verbose" | "warn", logFilters: import("./log-filters.js").LogFilters;
+export declare const levels: {
+    labels: any;
+    values: {
+        verbose: number;
+    };
+};
+/** Returns the color function assigned to a given actor, assigning a new one if needed. */
+export declare function getActorColor(actor: string): Color;
+/** Resets the actor-to-color mapping. Useful for testing. */
+export declare function resetActorColors(): void;
+type LogObject = {
+    actor?: string;
+    module?: string;
+    instanceId?: string;
+    msg?: string;
+};
+/** Formats a log message with per-actor coloring. Actor, module, and instanceId share the same color. */
+export declare function formatLogMessage(log: LogObject, messageKey: string): string;
+/**
+ * Pino-pretty options for direct use (e.g., jest/setup.mjs).
+ * Includes function-based messageFormat for per-actor coloring when enabled.
+ */
+export declare const pinoPrettyOpts: {
+    destination: number;
+    sync: boolean;
+    colorize: boolean;
+    ignore: string;
+    customLevels: string;
+    customColors: string;
+    minimumLevel: "trace";
+    singleLine: boolean;
+    messageFormat: string | typeof formatLogMessage;
+};
+export declare const logger: import("pino").Logger<"verbose", boolean>;
+/**
+ * Overwrites the logging stream with a different destination.
+ * Used by jest/setup.mjs to set up a pretty logger.
+ */
+export declare function overwriteLoggingStream(stream: Writable): void;
+/**
+ * Registers an additional destination to the pino logger.
+ * Use only when working with destinations, not worker transports.
+ */
+export declare function registerLoggingStream(stream: Writable): void;
+/** Log function that accepts an exception object */
+type ErrorLogFn = (msg: string, err?: unknown, data?: LogData) => void;
+/**
+ * Logger that supports multiple severity levels.
+ */
+export type Logger = {
+    [K in LogLevel]: LogFn;
+} & {
+    error: ErrorLogFn;
+} & {
+    level: LogLevel;
+    isLevelEnabled: (level: LogLevel) => boolean;
+    module: string;
+    createChild: (childModule: string) => Logger;
+    /** Returns the bindings (actor, instanceId) for this logger. */
+    getBindings: () => LoggerBindings;
+};
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGluby1sb2dnZXIuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9sb2cvcGluby1sb2dnZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLEtBQUssS0FBSyxFQUFrQyxNQUFNLFdBQVcsQ0FBQztBQUd2RSxPQUFPLEtBQUssRUFBRSxRQUFRLEVBQUUsTUFBTSxRQUFRLENBQUM7QUFVdkMsT0FBTyxLQUFLLEVBQUUsUUFBUSxFQUFFLE1BQU0saUJBQWlCLENBQUM7QUFDaEQsT0FBTyxLQUFLLEVBQUUsT0FBTyxFQUFFLEtBQUssRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUVsRCx3RUFBd0U7QUFDeEUsTUFBTSxNQUFNLGNBQWMsR0FBRztJQUMzQiwrREFBK0Q7SUFDL0QsS0FBSyxDQUFDLEVBQUUsTUFBTSxDQUFDO0lBQ2YsdUZBQXVGO0lBQ3ZGLFVBQVUsQ0FBQyxFQUFFLE1BQU0sQ0FBQztDQUNyQixDQUFDO0FBTUYsS0FBSyxrQkFBa0IsR0FBRyxNQUFNLGNBQWMsR0FBRyxTQUFTLENBQUM7QUFHM0Qsd0JBQWdCLHFCQUFxQixDQUFDLE9BQU8sRUFBRSxrQkFBa0IsR0FBRyxJQUFJLENBRXZFO0FBRUQsd0JBQWdCLHdCQUF3QixDQUFDLE9BQU8sRUFBRSxrQkFBa0IsUUFLbkU7QUFZRCx3QkFBZ0IsWUFBWSxDQUFDLE1BQU0sRUFBRSxNQUFNLEVBQUUsUUFBUSxDQUFDLEVBQUUsY0FBYyxHQUFHLE1BQU0sQ0E2QzlFO0FBRUQ7OztHQUdHO0FBQ0gsd0JBQWdCLGFBQWEsQ0FBQyxNQUFNLEVBQUUsTUFBTSxFQUFFLGdCQUFnQixDQUFDLEVBQUUsTUFBTSxHQUFHLGNBQWMsR0FBRyxNQUFNLENBS2hHO0FBSUQsS0FBSyxjQUFjLEdBQUcsQ0FBQyxJQUFJLEVBQUUsT0FBTyxLQUFLLE9BQU8sQ0FBQztBQUdqRCx3QkFBZ0IsaUJBQWlCLENBQUMsT0FBTyxFQUFFLGNBQWMsR0FBRyxJQUFJLENBRS9EO0FBZUQsZUFBTyxNQUFPLFFBQVEsa0ZBQUUsVUFBVSx1Q0FBK0QsQ0FBQztBQXNEbEcsZUFBTyxNQUFNLE1BQU07Ozs7O0NBR2xCLENBQUM7QUFlRiwyRkFBMkY7QUFDM0Ysd0JBQWdCLGFBQWEsQ0FBQyxLQUFLLEVBQUUsTUFBTSxHQUFHLEtBQUssQ0FRbEQ7QUFFRCw2REFBNkQ7QUFDN0Qsd0JBQWdCLGdCQUFnQixJQUFJLElBQUksQ0FHdkM7QUFNRCxLQUFLLFNBQVMsR0FBRztJQUFFLEtBQUssQ0FBQyxFQUFFLE1BQU0sQ0FBQztJQUFDLE1BQU0sQ0FBQyxFQUFFLE1BQU0sQ0FBQztJQUFDLFVBQVUsQ0FBQyxFQUFFLE1BQU0sQ0FBQztJQUFDLEdBQUcsQ0FBQyxFQUFFLE1BQU0sQ0FBQTtDQUFFLENBQUM7QUFFeEYseUdBQXlHO0FBQ3pHLHdCQUFnQixnQkFBZ0IsQ0FBQyxHQUFHLEVBQUUsU0FBUyxFQUFFLFVBQVUsRUFBRSxNQUFNLEdBQUcsTUFBTSxDQWtCM0U7QUFjRDs7O0dBR0c7QUFDSCxlQUFPLE1BQU0sY0FBYzs7Ozs7Ozs7OztDQUcxQixDQUFDO0FBMERGLGVBQU8sTUFBTSxNQUFNLDJDQUFlLENBQUM7QUFhbkM7OztHQUdHO0FBQ0gsd0JBQWdCLHNCQUFzQixDQUFDLE1BQU0sRUFBRSxRQUFRLEdBQUcsSUFBSSxDQUU3RDtBQUVEOzs7R0FHRztBQUNILHdCQUFnQixxQkFBcUIsQ0FBQyxNQUFNLEVBQUUsUUFBUSxHQUFHLElBQUksQ0FlNUQ7QUFFRCxvREFBb0Q7QUFDcEQsS0FBSyxVQUFVLEdBQUcsQ0FBQyxHQUFHLEVBQUUsTUFBTSxFQUFFLEdBQUcsQ0FBQyxFQUFFLE9BQU8sRUFBRSxJQUFJLENBQUMsRUFBRSxPQUFPLEtBQUssSUFBSSxDQUFDO0FBRXZFOztHQUVHO0FBQ0gsTUFBTSxNQUFNLE1BQU0sR0FBRztLQUFHLENBQUMsSUFBSSxRQUFRLEdBQUcsS0FBSztDQUFFLEdBQUc7SUFBNEIsS0FBSyxFQUFFLFVBQVUsQ0FBQTtDQUFFLEdBQUc7SUFDbEcsS0FBSyxFQUFFLFFBQVEsQ0FBQztJQUNoQixjQUFjLEVBQUUsQ0FBQyxLQUFLLEVBQUUsUUFBUSxLQUFLLE9BQU8sQ0FBQztJQUM3QyxNQUFNLEVBQUUsTUFBTSxDQUFDO0lBQ2YsV0FBVyxFQUFFLENBQUMsV0FBVyxFQUFFLE1BQU0sS0FBSyxNQUFNLENBQUM7SUFDN0MsZ0VBQWdFO0lBQ2hFLFdBQVcsRUFBRSxNQUFNLGNBQWMsQ0FBQztDQUNuQyxDQUFDIn0=

package/dest/log/pino-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pino-logger.d.ts","sourceRoot":"","sources":["../../src/log/pino-logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,KAAK,EAAkC,MAAM,WAAW,CAAC;AAGvE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAUvC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAElD,wEAAwE;AACxE,MAAM,MAAM,cAAc,GAAG;IAC3B,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uFAAuF;IACvF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAMF,KAAK,kBAAkB,GAAG,MAAM,cAAc,GAAG,SAAS,CAAC;AAG3D,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAEvE;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,kBAAkB,QAKnE;AAYD,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,MAAM,CA6C9E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,cAAc,GAAG,MAAM,CAKhG;AAID,KAAK,cAAc,GAAG,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC;AAGjD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAE/D;AAeD,eAAO,MAAO,QAAQ,kFAAE,UAAU,uCAA+D,CAAC;AAsDlG,eAAO,MAAM,MAAM;;;;;CAGlB,CAAC;AAeF,2FAA2F;AAC3F,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAQlD;AAED,6DAA6D;AAC7D,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC;AAMD,KAAK,SAAS,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAExF,yGAAyG;AACzG,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAkB3E;AAcD;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;CAG1B,CAAC;AA0DF,eAAO,MAAM,MAAM,2CAAe,CAAC;AAanC;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI,CAE7D;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI,CAe5D;AAED,oDAAoD;AACpD,KAAK,UAAU,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;AAEvE;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG;KAAG,CAAC,IAAI,QAAQ,GAAG,KAAK;CAAE,GAAG;IAA4B,KAAK,EAAE,UAAU,CAAA;CAAE,GAAG;IAClG,KAAK,EAAE,QAAQ,CAAC;IAChB,cAAc,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,OAAO,CAAC;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,MAAM,CAAC;IAC7C,gEAAgE;IAChE,WAAW,EAAE,MAAM,cAAc,CAAC;CACnC,CAAC"}