export declare const LOG_REDACTION_MARKER = "[REDACTED]"; /** Owns structured logging redaction and request-local sensitive values. */ export default class LogRedactor { _extendedSensitiveNames: string[]; /** * Builds a structured logging redactor. * @param {object} [args] - Redaction policy options. * @param {string[]} [args.sensitiveNames] - Application-defined sensitive names. */ constructor({ sensitiveNames }?: { sensitiveNames?: string[]; }); /** * Checks a structured name against the default and application policy. * @param {string} name - Header or parameter name. * @returns {boolean} - Whether values under the name are sensitive. */ isSensitiveName(name: string): boolean; /** * Collects values found below sensitive structured names. * @param {ReturnType} value - Structured value. * @param {Set} [initialValues] - Values already registered for this request. * @returns {Set} - A new set containing all registered representations. */ sensitiveValues(value: ReturnType, initialValues?: Set): Set; /** * Collects sensitive values from every structured request surface. * @param {import("./http-server/client/request.js").default | import("./http-server/client/websocket-request.js").default} request - Incoming request. * @param {Set} [initialValues] - Values already registered for this request. * @returns {Set} - Request-local sensitive values. */ requestSensitiveValues(request: import("./http-server/client/request.js").default | import("./http-server/client/websocket-request.js").default, initialValues?: Set): Set; /** * Redacts a structured value without mutating it. * @param {ReturnType} value - Value to redact. * @param {Set} [sensitiveValues] - Request-local sensitive values. * @returns {ReturnType} - Redacted structural copy. */ redactStructured(value: ReturnType, sensitiveValues?: Set): ReturnType; /** * Replaces exact known sensitive values in diagnostic text. * @param {string} value - Diagnostic text. * @param {Set} [sensitiveValues] - Request-local sensitive values. * @returns {string} - Redacted text. */ redactString(value: string, sensitiveValues?: Set): string; /** * Builds an Error-compatible diagnostic with redacted message and backtrace. * @param {Error} error - Original error. * @param {Set} [sensitiveValues] - Request-local sensitive values. * @returns {Error} - Redacted error diagnostic. */ redactError(error: Error, sensitiveValues?: Set): Error; /** * Redacts named query values and registered path values without parsing SQL-like text. * @param {string} path - Request path, optionally including a query string. * @param {Set} [sensitiveValues] - Request-local sensitive values. * @returns {string} - Redacted request path. */ redactPath(path: string, sensitiveValues?: Set): string; /** * Traverses structured values to find sensitive-name descendants. * @param {ReturnType} value - Current structured value. * @param {string} key - Owning structured name. * @param {Set} values - Collected sensitive values. * @param {WeakSet} seen - Visited object references. * @returns {void} - No return value. */ _collectSensitiveValues(value: ReturnType, key: string, values: Set, seen: WeakSet): void; /** * Registers primitive leaves below a sensitive structured name. * @param {ReturnType} value - Value below a sensitive name. * @param {string} key - Sensitive structured name. * @param {Set} values - Collected sensitive values. * @param {WeakSet} seen - Visited object references. * @returns {void} - No return value. */ _collectLeafValues(value: ReturnType, key: string, values: Set, seen: WeakSet): void; /** * Registers common encoded and credential-bearing representations. * @param {string} value - Sensitive string. * @param {string} key - Sensitive structured name. * @param {Set} values - Collected sensitive values. * @returns {void} - No return value. */ _addSensitiveString(value: string, key: string, values: Set): void; /** * Produces a recursively redacted structural copy. * @param {ReturnType} value - Current structured value. * @param {string} key - Owning structured name. * @param {Set} sensitiveValues - Request-local sensitive values. * @param {WeakSet} seen - Visited object references. * @returns {ReturnType} - Redacted value. */ _redactStructured(value: ReturnType, key: string, sensitiveValues: Set, seen: WeakSet): ReturnType; } //# sourceMappingURL=log-redactor.d.ts.map