@alchemy/common 0.0.0-alpha.0

package/dist/esm/errors/FetchError.js

@@ -0,0 +1,25 @@
+import { BaseError } from "./BaseError.js";
+/**
+ * Error class representing a "Fetch Error" error, typically thrown when a fetch request fails.
+ */
+export class FetchError extends BaseError {
+    /**
+     * Initializes a new instance of the error message with a default message indicating that no chain was supplied to the client.
+     *
+     * @param {string} route - The route that failed to fetch.
+     * @param {string} method - The HTTP method that was used.
+     * @param {Error} cause - The cause of the error.
+     */
+    constructor(route, method, cause) {
+        super(`[${method}] ${route} failed to fetch`, {
+            cause,
+        });
+        Object.defineProperty(this, "name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "FetchError"
+        });
+    }
+}
+//# sourceMappingURL=FetchError.js.map

package/dist/esm/errors/FetchError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FetchError.js","sourceRoot":"","sources":["../../../src/errors/FetchError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;GAEG;AACH,MAAM,OAAO,UAAW,SAAQ,SAAS;IAGvC;;;;;;OAMG;IACH,YAAY,KAAa,EAAE,MAAc,EAAE,KAAa;QACtD,KAAK,CAAC,IAAI,MAAM,KAAK,KAAK,kBAAkB,EAAE;YAC5C,KAAK;SACN,CAAC,CAAC;QAZI;;;;mBAAO,YAAY;WAAC;IAa7B,CAAC;CACF","sourcesContent":["import { BaseError } from \"./BaseError.js\";\n\n/**\n * Error class representing a \"Fetch Error\" error, typically thrown when a fetch request fails.\n */\nexport class FetchError extends BaseError {\n  override name = \"FetchError\";\n\n  /**\n   * Initializes a new instance of the error message with a default message indicating that no chain was supplied to the client.\n   *\n   * @param {string} route - The route that failed to fetch.\n   * @param {string} method - The HTTP method that was used.\n   * @param {Error} cause - The cause of the error.\n   */\n  constructor(route: string, method: string, cause?: Error) {\n    super(`[${method}] ${route} failed to fetch`, {\n      cause,\n    });\n  }\n}\n"]}

package/dist/esm/errors/InvalidRequestError.d.ts

@@ -0,0 +1,13 @@
+import { BaseError } from "./BaseError.js";
+/**
+ * This error is thrown when an invalid request is made. It extends the `BaseError` class.
+ */
+export declare class InvalidRequestError extends BaseError {
+    name: string;
+    /**
+     * Constructor for initializing an InvalidRequestError.
+     *
+     * @param {string} message - Optional error message. Defaults to "Invalid request" if not provided.
+     */
+    constructor(message?: string);
+}

package/dist/esm/errors/InvalidRequestError.js

@@ -0,0 +1,22 @@
+import { BaseError } from "./BaseError.js";
+/**
+ * This error is thrown when an invalid request is made. It extends the `BaseError` class.
+ */
+export class InvalidRequestError extends BaseError {
+    // TODO: extend this further using docs path as well
+    /**
+     * Constructor for initializing an InvalidRequestError.
+     *
+     * @param {string} message - Optional error message. Defaults to "Invalid request" if not provided.
+     */
+    constructor(message) {
+        super(message || "Invalid request");
+        Object.defineProperty(this, "name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "InvalidRequestError"
+        });
+    }
+}
+//# sourceMappingURL=InvalidRequestError.js.map

package/dist/esm/errors/InvalidRequestError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InvalidRequestError.js","sourceRoot":"","sources":["../../../src/errors/InvalidRequestError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,SAAS;IAGhD,oDAAoD;IAEpD;;;;OAIG;IACH,YAAY,OAAgB;QAC1B,KAAK,CAAC,OAAO,IAAI,iBAAiB,CAAC,CAAC;QAV7B;;;;mBAAO,qBAAqB;WAAC;IAWtC,CAAC;CACF","sourcesContent":["import { BaseError } from \"./BaseError.js\";\n\n/**\n * This error is thrown when an invalid request is made. It extends the `BaseError` class.\n */\nexport class InvalidRequestError extends BaseError {\n  override name = \"InvalidRequestError\";\n\n  // TODO: extend this further using docs path as well\n\n  /**\n   * Constructor for initializing an InvalidRequestError.\n   *\n   * @param {string} message - Optional error message. Defaults to \"Invalid request\" if not provided.\n   */\n  constructor(message?: string) {\n    super(message || \"Invalid request\");\n  }\n}\n"]}

package/dist/esm/errors/MethodUnsupportedError.d.ts

@@ -0,0 +1,13 @@
+import { BaseError } from "./BaseError.js";
+/**
+ * This error is thrown when an unknown method is called. It extends the `BaseError` class.
+ */
+export declare class MethodUnsupportedError extends BaseError {
+    name: string;
+    /**
+     * Constructor for initializing an error message indicating the method name that is unsupported.
+     *
+     * @param {string} method - The name of the unsupported method
+     */
+    constructor(method: string);
+}

package/dist/esm/errors/MethodUnsupportedError.js

@@ -0,0 +1,21 @@
+import { BaseError } from "./BaseError.js";
+/**
+ * This error is thrown when an unknown method is called. It extends the `BaseError` class.
+ */
+export class MethodUnsupportedError extends BaseError {
+    /**
+     * Constructor for initializing an error message indicating the method name that is unsupported.
+     *
+     * @param {string} method - The name of the unsupported method
+     */
+    constructor(method) {
+        super(`Unsupported method: ${method}`);
+        Object.defineProperty(this, "name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "MethodUnsupportedError"
+        });
+    }
+}
+//# sourceMappingURL=MethodUnsupportedError.js.map

package/dist/esm/errors/MethodUnsupportedError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MethodUnsupportedError.js","sourceRoot":"","sources":["../../../src/errors/MethodUnsupportedError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;GAEG;AACH,MAAM,OAAO,sBAAuB,SAAQ,SAAS;IAGnD;;;;OAIG;IACH,YAAY,MAAc;QACxB,KAAK,CAAC,uBAAuB,MAAM,EAAE,CAAC,CAAC;QARhC;;;;mBAAO,wBAAwB;WAAC;IASzC,CAAC;CACF","sourcesContent":["import { BaseError } from \"./BaseError.js\";\n\n/**\n * This error is thrown when an unknown method is called. It extends the `BaseError` class.\n */\nexport class MethodUnsupportedError extends BaseError {\n  override name = \"MethodUnsupportedError\";\n\n  /**\n   * Constructor for initializing an error message indicating the method name that is unsupported.\n   *\n   * @param {string} method - The name of the unsupported method\n   */\n  constructor(method: string) {\n    super(`Unsupported method: ${method}`);\n  }\n}\n"]}

package/dist/esm/errors/ServerError.d.ts

@@ -0,0 +1,15 @@
+import { BaseError } from "./BaseError.js";
+/**
+ * Error class representing a "Server Error" error, typically thrown when a server request fails.
+ */
+export declare class ServerError extends BaseError {
+    name: string;
+    /**
+     * Initializes a new instance of the error message with a default message indicating that no chain was supplied to the client.
+     *
+     * @param {string} message - The error message.
+     * @param {number} status - The HTTP status code of the error.
+     * @param {Error} cause - The cause of the error.
+     */
+    constructor(message: string, status: number, cause?: Error);
+}

package/dist/esm/errors/ServerError.js

@@ -0,0 +1,25 @@
+import { BaseError } from "./BaseError.js";
+/**
+ * Error class representing a "Server Error" error, typically thrown when a server request fails.
+ */
+export class ServerError extends BaseError {
+    /**
+     * Initializes a new instance of the error message with a default message indicating that no chain was supplied to the client.
+     *
+     * @param {string} message - The error message.
+     * @param {number} status - The HTTP status code of the error.
+     * @param {Error} cause - The cause of the error.
+     */
+    constructor(message, status, cause) {
+        super(`HTTP request failed with status ${status}: ${message}`, {
+            cause,
+        });
+        Object.defineProperty(this, "name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "ServerError"
+        });
+    }
+}
+//# sourceMappingURL=ServerError.js.map

package/dist/esm/errors/ServerError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServerError.js","sourceRoot":"","sources":["../../../src/errors/ServerError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,SAAS;IAGxC;;;;;;OAMG;IACH,YAAY,OAAe,EAAE,MAAc,EAAE,KAAa;QACxD,KAAK,CAAC,mCAAmC,MAAM,KAAK,OAAO,EAAE,EAAE;YAC7D,KAAK;SACN,CAAC,CAAC;QAZI;;;;mBAAO,aAAa;WAAC;IAa9B,CAAC;CACF","sourcesContent":["import { BaseError } from \"./BaseError.js\";\n\n/**\n * Error class representing a \"Server Error\" error, typically thrown when a server request fails.\n */\nexport class ServerError extends BaseError {\n  override name = \"ServerError\";\n\n  /**\n   * Initializes a new instance of the error message with a default message indicating that no chain was supplied to the client.\n   *\n   * @param {string} message - The error message.\n   * @param {number} status - The HTTP status code of the error.\n   * @param {Error} cause - The cause of the error.\n   */\n  constructor(message: string, status: number, cause?: Error) {\n    super(`HTTP request failed with status ${status}: ${message}`, {\n      cause,\n    });\n  }\n}\n"]}

package/dist/esm/index.d.ts

@@ -0,0 +1,29 @@
+export type * from "./rest/restClient.js";
+export type * from "./rest/types.js";
+export { AlchemyRestClient } from "./rest/restClient.js";
+export type * from "./transport/alchemy.js";
+export { alchemyTransport, isAlchemyTransport } from "./transport/alchemy.js";
+export { getAlchemyRpcUrl, isChainSupported, getSupportedChainIds, } from "./transport/chainRegistry.js";
+export type * from "./utils/types.js";
+export { assertNever } from "./utils/assertNever.js";
+export { raise } from "./utils/raise.js";
+export { bigIntMultiply } from "./utils/bigint.js";
+export { lowerAddress } from "./utils/lowerAddress.js";
+export { createEip1193HandlerFactory } from "./utils/createEip1193HandlerFactory.js";
+export type { AlchemyConnectionConfig } from "./transport/connectionSchema.js";
+export { AlchemyConnectionConfigSchema, validateAlchemyConnectionConfig, isAlchemyConnectionConfig, } from "./transport/connectionSchema.js";
+export { BaseError } from "./errors/BaseError.js";
+export { ChainNotFoundError } from "./errors/ChainNotFoundError.js";
+export { AccountNotFoundError } from "./errors/AccountNotFoundError.js";
+export { ConnectionConfigError } from "./errors/ConnectionConfigError.js";
+export { FetchError } from "./errors/FetchError.js";
+export { ServerError } from "./errors/ServerError.js";
+export { InvalidRequestError } from "./errors/InvalidRequestError.js";
+export { MethodUnsupportedError } from "./errors/MethodUnsupportedError.js";
+export type * from "./actions/addBreadCrumb.js";
+export { addBreadCrumb } from "./actions/addBreadCrumb.js";
+export * from "./chains.js";
+export { createLogger } from "./logging/logger.js";
+export { setGlobalLoggerConfig, getGlobalLoggerConfig, LogLevel, isLevelEnabled, isNamespaceEnabled, } from "./logging/config.js";
+export type { DiagnosticsLogger } from "./logging/logger.js";
+export { InMemorySink } from "./logging/sinks.js";

package/dist/esm/index.js

@@ -0,0 +1,27 @@
+export { AlchemyRestClient } from "./rest/restClient.js";
+export { alchemyTransport, isAlchemyTransport } from "./transport/alchemy.js";
+// chain registry utilities
+export { getAlchemyRpcUrl, isChainSupported, getSupportedChainIds, } from "./transport/chainRegistry.js";
+export { assertNever } from "./utils/assertNever.js";
+export { raise } from "./utils/raise.js";
+export { bigIntMultiply } from "./utils/bigint.js";
+export { lowerAddress } from "./utils/lowerAddress.js";
+export { createEip1193HandlerFactory } from "./utils/createEip1193HandlerFactory.js";
+export { AlchemyConnectionConfigSchema, validateAlchemyConnectionConfig, isAlchemyConnectionConfig, } from "./transport/connectionSchema.js";
+// errors
+export { BaseError } from "./errors/BaseError.js";
+export { ChainNotFoundError } from "./errors/ChainNotFoundError.js";
+export { AccountNotFoundError } from "./errors/AccountNotFoundError.js";
+export { ConnectionConfigError } from "./errors/ConnectionConfigError.js";
+export { FetchError } from "./errors/FetchError.js";
+export { ServerError } from "./errors/ServerError.js";
+export { InvalidRequestError } from "./errors/InvalidRequestError.js";
+export { MethodUnsupportedError } from "./errors/MethodUnsupportedError.js";
+export { addBreadCrumb } from "./actions/addBreadCrumb.js";
+// chains (convenience exports for Alchemy-supported chains)
+export * from "./chains.js";
+// diagnostics logging
+export { createLogger } from "./logging/logger.js";
+export { setGlobalLoggerConfig, getGlobalLoggerConfig, LogLevel, isLevelEnabled, isNamespaceEnabled, } from "./logging/config.js";
+export { InMemorySink } from "./logging/sinks.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAIzD,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE9E,2BAA2B;AAC3B,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,8BAA8B,CAAC;AAItC,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,2BAA2B,EAAE,MAAM,wCAAwC,CAAC;AAIrF,OAAO,EACL,6BAA6B,EAC7B,+BAA+B,EAC/B,yBAAyB,GAC1B,MAAM,iCAAiC,CAAC;AAEzC,SAAS;AACT,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAI5E,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,4DAA4D;AAC5D,cAAc,aAAa,CAAC;AAE5B,sBAAsB;AACtB,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,QAAQ,EACR,cAAc,EACd,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC","sourcesContent":["// http\nexport type * from \"./rest/restClient.js\";\nexport type * from \"./rest/types.js\";\nexport { AlchemyRestClient } from \"./rest/restClient.js\";\n\n// transport\nexport type * from \"./transport/alchemy.js\";\nexport { alchemyTransport, isAlchemyTransport } from \"./transport/alchemy.js\";\n\n// chain registry utilities\nexport {\n  getAlchemyRpcUrl,\n  isChainSupported,\n  getSupportedChainIds,\n} from \"./transport/chainRegistry.js\";\n\n// utils\nexport type * from \"./utils/types.js\";\nexport { assertNever } from \"./utils/assertNever.js\";\nexport { raise } from \"./utils/raise.js\";\nexport { bigIntMultiply } from \"./utils/bigint.js\";\nexport { lowerAddress } from \"./utils/lowerAddress.js\";\nexport { createEip1193HandlerFactory } from \"./utils/createEip1193HandlerFactory.js\";\n\n// config\nexport type { AlchemyConnectionConfig } from \"./transport/connectionSchema.js\";\nexport {\n  AlchemyConnectionConfigSchema,\n  validateAlchemyConnectionConfig,\n  isAlchemyConnectionConfig,\n} from \"./transport/connectionSchema.js\";\n\n// errors\nexport { BaseError } from \"./errors/BaseError.js\";\nexport { ChainNotFoundError } from \"./errors/ChainNotFoundError.js\";\nexport { AccountNotFoundError } from \"./errors/AccountNotFoundError.js\";\nexport { ConnectionConfigError } from \"./errors/ConnectionConfigError.js\";\nexport { FetchError } from \"./errors/FetchError.js\";\nexport { ServerError } from \"./errors/ServerError.js\";\nexport { InvalidRequestError } from \"./errors/InvalidRequestError.js\";\nexport { MethodUnsupportedError } from \"./errors/MethodUnsupportedError.js\";\n\n// actions\nexport type * from \"./actions/addBreadCrumb.js\";\nexport { addBreadCrumb } from \"./actions/addBreadCrumb.js\";\n\n// chains (convenience exports for Alchemy-supported chains)\nexport * from \"./chains.js\";\n\n// diagnostics logging\nexport { createLogger } from \"./logging/logger.js\";\nexport {\n  setGlobalLoggerConfig,\n  getGlobalLoggerConfig,\n  LogLevel,\n  isLevelEnabled,\n  isNamespaceEnabled,\n} from \"./logging/config.js\";\nexport type { DiagnosticsLogger } from \"./logging/logger.js\";\nexport { InMemorySink } from \"./logging/sinks.js\";\n"]}

package/dist/esm/logging/config.d.ts

@@ -0,0 +1,190 @@
+/**
+ * Log level constants for controlling diagnostics output.
+ * Lower numeric values indicate higher priority (more restrictive filtering).
+ *
+ * @example
+ * ```ts
+ * import { LogLevel, setGlobalLoggerConfig } from "@alchemy/common";
+ *
+ * setGlobalLoggerConfig({ level: LogLevel.DEBUG });
+ * ```
+ */
+export declare const LogLevel: {
+    /** Critical errors only */
+    readonly ERROR: 0;
+    /** Warnings and errors */
+    readonly WARN: 1;
+    /** Informational messages, warnings, and errors */
+    readonly INFO: 2;
+    /** Debug messages and all above */
+    readonly DEBUG: 3;
+    /** All messages including verbose details */
+    readonly VERBOSE: 4;
+};
+export type LogLevel = (typeof LogLevel)[keyof typeof LogLevel];
+/**
+ * Configuration for redacting sensitive data in log output.
+ */
+export type RedactConfig = {
+    /** Predicate function to test if a key should be redacted. Returns true if the key should be redacted. */
+    keys?: (key: string) => boolean;
+    /** Function to replace redacted values. Defaults to returning "[REDACTED]". */
+    replacer?: (value: unknown, key?: string) => unknown;
+};
+/**
+ * Configuration for the diagnostics logging system.
+ * All properties are optional and will use sensible defaults if not provided.
+ */
+export type DiagnosticsConfig = {
+    /** Minimum log level to emit. Defaults to INFO in development, ERROR in production. */
+    level?: LogLevel;
+    /** Configuration for redacting sensitive data in logs. */
+    redact?: RedactConfig;
+    /** Array of sink functions to receive log entries. Defaults to console sink. */
+    sinks?: Array<(entry: LogEntry) => void>;
+    /** Disable telemetry headers in requests. Defaults to false. */
+    disableTelemetryHeaders?: boolean;
+    /** Array of exact namespace strings to allow. If undefined or empty, all namespaces are enabled. Example: ["aa-infra", "wallet-apis"] */
+    enabledNamespaces?: string[];
+};
+/**
+ * Base context attached to all log entries from a logger instance.
+ */
+export type LoggerContextBase = {
+    /** Package name (e.g., "@alchemy/aa-infra") */
+    package: string;
+    /** Package version (e.g., "1.0.0") */
+    version: string;
+};
+/**
+ * A single log entry emitted by the diagnostics logger.
+ */
+export type LogEntry = {
+    /** Timestamp in milliseconds since epoch (Date.now()) */
+    ts: number;
+    /** Log level of this entry */
+    level: LogLevel;
+    /** Optional namespace for filtering/grouping (e.g., "aa-infra", "wallet-apis") */
+    namespace: string | undefined;
+    /** The log message */
+    message: string;
+    /** Optional structured data attached to this log entry */
+    data?: Record<string, unknown>;
+    /** Package context (name and version) */
+    context: LoggerContextBase;
+};
+/**
+ * Gets the current global logger configuration.
+ * If not yet initialized, returns default configuration based on environment.
+ *
+ * @returns {Required<DiagnosticsConfig>} The current global configuration with all fields populated
+ * @example
+ * ```ts
+ * import { getGlobalLoggerConfig } from "@alchemy/common";
+ *
+ * const config = getGlobalLoggerConfig();
+ * console.log("Current log level:", config.level);
+ * ```
+ */
+export declare function getGlobalLoggerConfig(): Required<DiagnosticsConfig>;
+/**
+ * Sets the global logger configuration.
+ * Partial configuration is supported - unspecified fields retain their current values.
+ *
+ * Configuration precedence (highest to lowest):
+ * 1. Explicit setGlobalLoggerConfig calls
+ * 2. ALCHEMY_LOG_LEVEL environment variable
+ * 3. Defaults (INFO in dev, ERROR in prod)
+ *
+ * @param {DiagnosticsConfig} cfg - Partial configuration to apply
+ * @example
+ * ```ts
+ * import { setGlobalLoggerConfig, LogLevel } from "@alchemy/common";
+ *
+ * // Set log level only
+ * setGlobalLoggerConfig({ level: LogLevel.DEBUG });
+ *
+ * // Add custom sink
+ * setGlobalLoggerConfig({
+ *   sinks: [(entry) => console.log(JSON.stringify(entry))]
+ * });
+ *
+ * // Filter to specific namespaces
+ * setGlobalLoggerConfig({
+ *   enabledNamespaces: ["aa-infra", "wallet-apis"]
+ * });
+ * ```
+ */
+export declare function setGlobalLoggerConfig(cfg: DiagnosticsConfig): void;
+/**
+ * Checks if a given log level is enabled based on current global configuration.
+ * Used internally by logger to short-circuit disabled log statements.
+ *
+ * @param {LogLevel} level - The log level to check
+ * @returns {boolean} True if the level is enabled (will be logged), false otherwise
+ * @example
+ * ```ts
+ * import { isLevelEnabled, LogLevel } from "@alchemy/common";
+ *
+ * if (isLevelEnabled(LogLevel.DEBUG)) {
+ *   // Perform expensive debug computation
+ * }
+ * ```
+ */
+export declare function isLevelEnabled(level: LogLevel): boolean;
+/**
+ * Checks if a given namespace is enabled based on current global configuration.
+ * Used internally by logger to short-circuit logs from disabled namespaces.
+ *
+ * @param {string | undefined} namespace - The namespace to check
+ * @returns {boolean} True if the namespace is enabled (will be logged), false otherwise
+ * @example
+ * ```ts
+ * import { isNamespaceEnabled } from "@alchemy/common";
+ *
+ * if (isNamespaceEnabled("aa-infra")) {
+ *   // This namespace is enabled
+ * }
+ * ```
+ */
+export declare function isNamespaceEnabled(namespace: string | undefined): boolean;
+/**
+ * Redacts sensitive keys in an object based on global redaction configuration.
+ * Performs deep redaction by recursively processing nested objects and arrays.
+ * Default redaction includes: authorization, apiKey, jwt, privateKey, secret, password.
+ *
+ * @param {Record<string, unknown> | undefined} obj - The object to redact
+ * @returns {Record<string, unknown> | undefined} A new object with sensitive values redacted, or undefined if input was undefined
+ * @example
+ * ```ts
+ * import { redactObject } from "@alchemy/common";
+ *
+ * const data = {
+ *   apiKey: "secret123",
+ *   userId: "user-456",
+ *   nested: { secret: "hidden" }
+ * };
+ *
+ * const redacted = redactObject(data);
+ * // { apiKey: "[REDACTED]", userId: "user-456", nested: { secret: "[REDACTED]" } }
+ * ```
+ */
+export declare function redactObject(obj: Record<string, unknown> | undefined): Record<string, unknown> | undefined;
+/**
+ * Default console sink for diagnostics logging.
+ * Routes log entries to appropriate console methods based on log level.
+ *
+ * Format: [HH:MM:SS.mmm] [package@version] message {data}
+ *
+ * @param {LogEntry} entry - The log entry to output
+ * @example
+ * ```ts
+ * import { consoleSink, setGlobalLoggerConfig } from "@alchemy/common";
+ *
+ * // Console sink is used by default, but can be explicitly configured
+ * setGlobalLoggerConfig({
+ *   sinks: [consoleSink]
+ * });
+ * ```
+ */
+export declare function consoleSink(entry: LogEntry): void;