field-redactor 1.1.0 → 1.5.0

package/dist/fieldRedactor.d.ts

@@ -1,13 +1,39 @@
-import { FieldRedactorConfig } from './types';
+import { DryRunResult, FieldRedactorConfig, RedactableInput } from './types';
 /**
  * FieldRedactor is a highly customizable JSON object field redactor. It conditionally redacts fields based on
  * the secrets, deepSecrets, fullSecrets, and custom objects provided in the configuration. Refer to the README.md
  * for more details.
+ *
+ * Defaults: `ignoreNullOrUndefined` is `true`, `ignoreBooleans` is `false`, `cloneInput` is `true`.
  */
 export declare class FieldRedactor {
-    private deepCopy;
+    private readonly deepCopy;
     private readonly objectRedactor;
+    private readonly customObjectManager;
+    private readonly secretManager;
+    private readonly usesAsyncRedactor;
+    private readonly cloneInput;
+    private readonly valuePatternMatcher;
+    /** Non-fatal configuration warnings from the last construction (empty when `strict` threw). */
+    readonly configWarnings: readonly string[];
     constructor(config?: FieldRedactorConfig);
+    /**
+     * Creates a FieldRedactor that requires at least one explicit redaction rule: Shallow (`secretKeys`),
+     * Deep (`deepSecretKeys`), Opaque (`fullSecretKeys`), Remove (`deleteSecretKeys`), Schema (`customObjects`),
+     * or Value-pattern (`valuePatterns`).
+     * Unlike `new FieldRedactor()`, omitting all rules does not default to redacting every value.
+     */
+    static createSafe(config: FieldRedactorConfig): FieldRedactor;
+    /**
+     * Redacts a copy of the input and returns an audit report of affected paths without mutating the original.
+     */
+    dryRun<T extends RedactableInput>(value: T): Promise<DryRunResult<T>>;
+    /**
+     * Synchronous {@link FieldRedactor.dryRun} without per-field Promise overhead.
+     */
+    dryRunSync<T extends RedactableInput>(value: T): DryRunResult<T>;
+    private emptyDryRunResult;
+    private toDryRunResult;
     /**
      * Conditionally redacts fields in the JSON object based on the configuration provided in the constructor and returns the
      * redacted result.
@@ -15,14 +41,26 @@ export declare class FieldRedactor {
      * @param value The JSON value to redact. If primitive it will be resolved as-is.
      * @returns The redacted JSON object.
      */
-    redact(value: any): Promise<any>;
+    redact<T extends RedactableInput>(value: T): Promise<T>;
+    /**
+     * Synchronously redacts fields and returns a copy without per-field Promise overhead.
+     * Uses copy-on-write structural sharing by default so only mutated branches are cloned.
+     */
+    redactSync<T extends RedactableInput>(value: T): T;
     /**
      * Conditionally redacts fields in the JSON object in place based on the configuration provided in the constructor.
      * If the value is a primitive, undefined, or date, returns the value as-is.
      * @param value The JSON value to redact in place. If primitive it will be resolved as-is.
-     * @returns The redacted JSON object.
      */
-    redactInPlace(value: any): Promise<void>;
+    redactInPlace<T extends RedactableInput>(value: T): Promise<void>;
+    /**
+     * Synchronously redacts fields in the JSON object in place without per-field Promise overhead.
+     * Requires a `syncRedactor` or the default redactor; throws when only an async `redactor` is configured.
+     */
+    redactInPlaceSync<T extends RedactableInput>(value: T): void;
+    private runTraversableRedactionSync;
+    private runTraversableRedactionAsync;
+    private toFieldRedactorError;
     private isPrimitiveOrUndefined;
 }
 //# sourceMappingURL=fieldRedactor.d.ts.map

package/dist/fieldRedactor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fieldRedactor.d.ts","sourceRoot":"","sources":["../src/fieldRedactor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAO9C;;;;GAIG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAwC;IACxD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;gBACpC,MAAM,CAAC,EAAE,mBAAmB;IAwBxC;;;;;;OAMG;IACU,MAAM,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAK7C;;;;;OAKG;IACU,aAAa,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAYrD,OAAO,CAAC,sBAAsB;CAG/B"}
+{"version":3,"file":"fieldRedactor.d.ts","sourceRoot":"","sources":["../src/fieldRedactor.ts"],"names":[],"mappings":"AACA,OAAO,EACL,YAAY,EACZ,mBAAmB,EAInB,eAAe,EAEhB,MAAM,SAAS,CAAC;AASjB;;;;;;GAMG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwC;IACjE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAsB;IAC1D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAU;IAC5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IACrC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAmE;IAEvG,+FAA+F;IAC/F,SAAgB,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;gBAEtC,MAAM,CAAC,EAAE,mBAAmB;IAgBxC;;;;;OAKG;WACW,UAAU,CAAC,MAAM,EAAE,mBAAmB,GAAG,aAAa;IAUpE;;OAEG;IACU,MAAM,CAAC,CAAC,SAAS,eAAe,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IASlF;;OAEG;IACI,UAAU,CAAC,CAAC,SAAS,eAAe,EAAE,KAAK,EAAE,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC;IASvE,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,cAAc;IAatB;;;;;;OAMG;IACU,MAAM,CAAC,CAAC,SAAS,eAAe,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAmBpE;;;OAGG;IACI,UAAU,CAAC,CAAC,SAAS,eAAe,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC;IAazD;;;;OAIG;IACU,aAAa,CAAC,CAAC,SAAS,eAAe,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAW9E;;;OAGG;IACI,iBAAiB,CAAC,CAAC,SAAS,eAAe,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAQnE,OAAO,CAAC,2BAA2B;YAYrB,4BAA4B;IAe1C,OAAO,CAAC,oBAAoB;IAK5B,OAAO,CAAC,sBAAsB;CAG/B"}

package/dist/fieldRedactor.js

@@ -14,34 +14,75 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FieldRedactor = void 0;
 const rfdc_1 = __importDefault(require("rfdc"));
-const objectRedactor_1 = require("./objectRedactor");
-const primitiveRedactor_1 = require("./primitiveRedactor");
-const secretManager_1 = require("./secretManager");
-const customObjectManager_1 = require("./customObjectManager");
 const errors_1 = require("./errors");
+const configValidator_1 = require("./configValidator");
+const dryRun_1 = require("./dryRun");
+const fieldRedactorDeps_1 = require("./fieldRedactorDeps");
 /**
  * FieldRedactor is a highly customizable JSON object field redactor. It conditionally redacts fields based on
  * the secrets, deepSecrets, fullSecrets, and custom objects provided in the configuration. Refer to the README.md
  * for more details.
+ *
+ * Defaults: `ignoreNullOrUndefined` is `true`, `ignoreBooleans` is `false`, `cloneInput` is `true`.
  */
 class FieldRedactor {
     constructor(config) {
+        var _a;
         this.deepCopy = (0, rfdc_1.default)({ proto: true, circles: true });
-        const { redactor, secretKeys, deepSecretKeys, fullSecretKeys, customObjects } = config || {};
-        const ignoreNullOrUndefined = typeof (config === null || config === void 0 ? void 0 : config.ignoreNullOrUndefined) === 'boolean' ? config.ignoreNullOrUndefined : true;
-        const ignoreBooleans = typeof (config === null || config === void 0 ? void 0 : config.ignoreBooleans) === 'boolean' ? config.ignoreBooleans : true;
-        const primitiveRedactor = new primitiveRedactor_1.PrimitiveRedactor({
-            ignoreBooleans,
-            ignoreNullOrUndefined,
-            redactor
-        });
-        const secretManager = new secretManager_1.SecretManager({
-            secretKeys,
-            deepSecretKeys,
-            fullSecretKeys
+        this.configWarnings = (0, configValidator_1.validateFieldRedactorConfig)(config);
+        for (const warning of this.configWarnings) {
+            (_a = config === null || config === void 0 ? void 0 : config.onConfigWarning) === null || _a === void 0 ? void 0 : _a.call(config, warning);
+        }
+        const deps = (0, fieldRedactorDeps_1.buildFieldRedactorDeps)(config);
+        this.usesAsyncRedactor = deps.usesAsyncRedactor;
+        this.cloneInput = deps.cloneInput;
+        this.secretManager = deps.secretManager;
+        this.valuePatternMatcher = deps.valuePatternMatcher;
+        this.customObjectManager = deps.customObjectManager;
+        this.objectRedactor = deps.objectRedactor;
+    }
+    /**
+     * Creates a FieldRedactor that requires at least one explicit redaction rule: Shallow (`secretKeys`),
+     * Deep (`deepSecretKeys`), Opaque (`fullSecretKeys`), Remove (`deleteSecretKeys`), Schema (`customObjects`),
+     * or Value-pattern (`valuePatterns`).
+     * Unlike `new FieldRedactor()`, omitting all rules does not default to redacting every value.
+     */
+    static createSafe(config) {
+        if (!(0, configValidator_1.hasExplicitRedactionRules)(config)) {
+            throw new errors_1.FieldRedactorConfigurationError('FieldRedactor.createSafe() requires at least one non-empty secretKeys, deepSecretKeys, fullSecretKeys, deleteSecretKeys, customObjects, or valuePatterns entry. Without explicit rules, new FieldRedactor() redacts all values by default.');
+        }
+        return new FieldRedactor(config);
+    }
+    /**
+     * Redacts a copy of the input and returns an audit report of affected paths without mutating the original.
+     */
+    dryRun(value) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.isPrimitiveOrUndefined(value)) {
+                return this.emptyDryRunResult(value);
+            }
+            const snapshot = this.deepCopy(value);
+            return this.toDryRunResult(snapshot, yield this.redact(value));
         });
-        const customObjectChecker = new customObjectManager_1.CustomObjectManager(customObjects);
-        this.objectRedactor = new objectRedactor_1.ObjectRedactor(primitiveRedactor, secretManager, customObjectChecker);
+    }
+    /**
+     * Synchronous {@link FieldRedactor.dryRun} without per-field Promise overhead.
+     */
+    dryRunSync(value) {
+        if (this.isPrimitiveOrUndefined(value)) {
+            return this.emptyDryRunResult(value);
+        }
+        const snapshot = this.deepCopy(value);
+        return this.toDryRunResult(snapshot, this.redactSync(value));
+    }
+    emptyDryRunResult(value) {
+        return { result: value, report: dryRun_1.EMPTY_DRY_RUN_REPORT };
+    }
+    toDryRunResult(snapshot, result) {
+        return {
+            result,
+            report: (0, dryRun_1.buildDryRunReport)(snapshot, result, this.customObjectManager, this.secretManager, this.valuePatternMatcher)
+        };
     }
     /**
      * Conditionally redacts fields in the JSON object based on the configuration provided in the constructor and returns the
@@ -52,29 +93,89 @@ class FieldRedactor {
      */
     redact(value) {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this.isPrimitiveOrUndefined(value)) {
+                return value;
+            }
+            if (!this.cloneInput) {
+                yield this.redactInPlace(value);
+                return value;
+            }
+            if (!this.usesAsyncRedactor) {
+                return Promise.resolve(this.redactSync(value));
+            }
             const copy = this.deepCopy(value);
-            return this.redactInPlace(copy);
+            yield this.redactInPlace(copy);
+            return copy;
         });
     }
+    /**
+     * Synchronously redacts fields and returns a copy without per-field Promise overhead.
+     * Uses copy-on-write structural sharing by default so only mutated branches are cloned.
+     */
+    redactSync(value) {
+        if (this.isPrimitiveOrUndefined(value)) {
+            return value;
+        }
+        if (!this.cloneInput) {
+            this.redactInPlaceSync(value);
+            return value;
+        }
+        return this.objectRedactor.redactCopyOnWrite(value);
+    }
     /**
      * Conditionally redacts fields in the JSON object in place based on the configuration provided in the constructor.
      * If the value is a primitive, undefined, or date, returns the value as-is.
      * @param value The JSON value to redact in place. If primitive it will be resolved as-is.
-     * @returns The redacted JSON object.
      */
     redactInPlace(value) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.usesAsyncRedactor) {
+                this.redactInPlaceSync(value);
+                return;
+            }
+            yield this.runTraversableRedactionAsync(value, () => __awaiter(this, void 0, void 0, function* () {
+                yield this.objectRedactor.redactInPlace(value);
+            }));
+        });
+    }
+    /**
+     * Synchronously redacts fields in the JSON object in place without per-field Promise overhead.
+     * Requires a `syncRedactor` or the default redactor; throws when only an async `redactor` is configured.
+     */
+    redactInPlaceSync(value) {
+        if (this.usesAsyncRedactor) {
+            throw new errors_1.FieldRedactorError('redactInPlaceSync requires syncRedactor configuration or the default redactor');
+        }
+        this.runTraversableRedactionSync(value, () => this.objectRedactor.redactInPlaceSync(value));
+    }
+    runTraversableRedactionSync(value, redact) {
+        if (this.isPrimitiveOrUndefined(value)) {
+            return;
+        }
+        try {
+            redact();
+        }
+        catch (e) {
+            throw this.toFieldRedactorError(e);
+        }
+    }
+    runTraversableRedactionAsync(value, redact) {
         return __awaiter(this, void 0, void 0, function* () {
             if (this.isPrimitiveOrUndefined(value)) {
-                return value;
+                return;
             }
             try {
-                return this.objectRedactor.redactInPlace(value);
+                yield redact();
             }
             catch (e) {
-                throw new errors_1.FieldRedactorError(e.message);
+                throw this.toFieldRedactorError(e);
             }
         });
     }
+    toFieldRedactorError(error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return new errors_1.FieldRedactorError(message);
+    }
     isPrimitiveOrUndefined(value) {
         return !value || typeof value !== 'object' || value instanceof Date;
     }

package/dist/fieldRedactor.js.map

@@ -1 +1 @@
-{"version":3,"file":"fieldRedactor.js","sourceRoot":"","sources":["../src/fieldRedactor.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,gDAAwB;AAExB,qDAAkD;AAClD,2DAAwD;AACxD,mDAAgD;AAChD,+DAA4D;AAC5D,qCAA8C;AAE9C;;;;GAIG;AACH,MAAa,aAAa;IAGxB,YAAY,MAA4B;QAFhC,aAAQ,GAAG,IAAA,cAAI,EAAC,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAGtD,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QAE7F,MAAM,qBAAqB,GACzB,OAAO,CAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,qBAAqB,CAAA,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC,CAAC,IAAI,CAAC;QAC3F,MAAM,cAAc,GAAG,OAAO,CAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,cAAc,CAAA,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC;QAElG,MAAM,iBAAiB,GAAG,IAAI,qCAAiB,CAAC;YAC9C,cAAc;YACd,qBAAqB;YACrB,QAAQ;SACT,CAAC,CAAC;QAEH,MAAM,aAAa,GAAG,IAAI,6BAAa,CAAC;YACtC,UAAU;YACV,cAAc;YACd,cAAc;SACf,CAAC,CAAC;QAEH,MAAM,mBAAmB,GAAG,IAAI,yCAAmB,CAAC,aAAa,CAAC,CAAC;QAEnE,IAAI,CAAC,cAAc,GAAG,IAAI,+BAAc,CAAC,iBAAiB,EAAE,aAAa,EAAE,mBAAmB,CAAC,CAAC;IAClG,CAAC;IAED;;;;;;OAMG;IACU,MAAM,CAAC,KAAU;;YAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YAClC,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC;KAAA;IAED;;;;;OAKG;IACU,aAAa,CAAC,KAAU;;YACnC,IAAI,IAAI,CAAC,sBAAsB,CAAC,KAAK,CAAC,EAAE,CAAC;gBACvC,OAAO,KAAK,CAAC;YACf,CAAC;YAED,IAAI,CAAC;gBACH,OAAO,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;YAClD,CAAC;YAAC,OAAO,CAAM,EAAE,CAAC;gBAChB,MAAM,IAAI,2BAAkB,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;KAAA;IAEO,sBAAsB,CAAC,KAAU;QACvC,OAAO,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,YAAY,IAAI,CAAC;IACtE,CAAC;CACF;AA5DD,sCA4DC"}
+{"version":3,"file":"fieldRedactor.js","sourceRoot":"","sources":["../src/fieldRedactor.ts"],"names":[],"mappings":"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"}

package/dist/fieldRedactorConfigBuilder.d.ts

@@ -0,0 +1,49 @@
+import { FieldRedactor } from './fieldRedactor';
+import { CustomObject, FieldRedactorConfig, Redactor, SyncRedactor } from './types';
+export type SchemaOptions = {
+    /** Optional label surfaced in {@link FieldRedactor.dryRun} `matchedSchemas` reports. */
+    name?: string;
+};
+/**
+ * Fluent builder for {@link FieldRedactorConfig} using doc labels (Shallow, Deep, Opaque, Remove, Schema).
+ */
+export declare class FieldRedactorConfigBuilder {
+    private config;
+    private schemas;
+    static create(): FieldRedactorConfigBuilder;
+    /** Shallow — redact matching keys' scalar values (`secretKeys`). */
+    shallow(...patterns: RegExp[]): this;
+    /** Deep — redact matching keys and descendants (`deepSecretKeys`). */
+    deep(...patterns: RegExp[]): this;
+    /** Opaque — stringify entire values at matching keys (`fullSecretKeys`). */
+    opaque(...patterns: RegExp[]): this;
+    /** Remove — delete matching keys from output (`deleteSecretKeys`). */
+    remove(...patterns: RegExp[]): this;
+    /** Alias for {@link FieldRedactorConfigBuilder.remove}. */
+    delete(...patterns: RegExp[]): this;
+    /** Register an object schema (`customObjects`). */
+    schema(customObject: CustomObject, options?: SchemaOptions): this;
+    /**
+     * Value-pattern — redact scalar fields whose string form matches a pattern, regardless of key name (`valuePatterns`).
+     * Lowest precedence; opt-in defense in depth beyond key-name rules.
+     */
+    valuePattern(...patterns: RegExp[]): this;
+    /**
+     * Merge a {@link presets} return value (or any partial config) into the builder.
+     * Regex arrays and schemas accumulate; scalar options apply only when not already set.
+     */
+    usePreset(preset: Partial<FieldRedactorConfig>): this;
+    redactor(fn: Redactor): this;
+    syncRedactor(fn: SyncRedactor): this;
+    ignoreBooleans(value: boolean): this;
+    ignoreNullOrUndefined(value: boolean): this;
+    cloneInput(value: boolean): this;
+    strict(value?: boolean): this;
+    onConfigWarning(handler: (message: string) => void): this;
+    build(): FieldRedactorConfig;
+    buildRedactor(): FieldRedactor;
+    buildSafeRedactor(): FieldRedactor;
+    private appendRegex;
+    private set;
+}
+//# sourceMappingURL=fieldRedactorConfigBuilder.d.ts.map

package/dist/fieldRedactorConfigBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldRedactorConfigBuilder.d.ts","sourceRoot":"","sources":["../src/fieldRedactorConfigBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAShD,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEpF,MAAM,MAAM,aAAa,GAAG;IAC1B,wFAAwF;IACxF,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;GAEG;AACH,qBAAa,0BAA0B;IACrC,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,OAAO,CAA0B;IAEzC,MAAM,CAAC,MAAM,IAAI,0BAA0B;IAI3C,oEAAoE;IACpE,OAAO,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;IAIpC,sEAAsE;IACtE,IAAI,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;IAIjC,4EAA4E;IAC5E,MAAM,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;IAInC,sEAAsE;IACtE,MAAM,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;IAInC,2DAA2D;IAC3D,MAAM,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;IAInC,mDAAmD;IACnD,MAAM,CAAC,YAAY,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI;IAKjE;;;OAGG;IACH,YAAY,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;IAKzC;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,IAAI;IAKrD,QAAQ,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI;IAI5B,YAAY,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI;IAIpC,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAIpC,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAI3C,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAIhC,MAAM,CAAC,KAAK,UAAO,GAAG,IAAI;IAI1B,eAAe,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAIzD,KAAK,IAAI,mBAAmB;IAI5B,aAAa,IAAI,aAAa;IAI9B,iBAAiB,IAAI,aAAa;IAIlC,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,GAAG;CAIZ"}

package/dist/fieldRedactorConfigBuilder.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FieldRedactorConfigBuilder = void 0;
+const fieldRedactor_1 = require("./fieldRedactor");
+const redactionRules_1 = require("./redactionRules");
+/**
+ * Fluent builder for {@link FieldRedactorConfig} using doc labels (Shallow, Deep, Opaque, Remove, Schema).
+ */
+class FieldRedactorConfigBuilder {
+    constructor() {
+        this.config = {};
+        this.schemas = [];
+    }
+    static create() {
+        return new FieldRedactorConfigBuilder();
+    }
+    /** Shallow — redact matching keys' scalar values (`secretKeys`). */
+    shallow(...patterns) {
+        return this.appendRegex('secretKeys', patterns);
+    }
+    /** Deep — redact matching keys and descendants (`deepSecretKeys`). */
+    deep(...patterns) {
+        return this.appendRegex('deepSecretKeys', patterns);
+    }
+    /** Opaque — stringify entire values at matching keys (`fullSecretKeys`). */
+    opaque(...patterns) {
+        return this.appendRegex('fullSecretKeys', patterns);
+    }
+    /** Remove — delete matching keys from output (`deleteSecretKeys`). */
+    remove(...patterns) {
+        return this.appendRegex('deleteSecretKeys', patterns);
+    }
+    /** Alias for {@link FieldRedactorConfigBuilder.remove}. */
+    delete(...patterns) {
+        return this.remove(...patterns);
+    }
+    /** Register an object schema (`customObjects`). */
+    schema(customObject, options) {
+        this.schemas.push({ object: customObject, name: options === null || options === void 0 ? void 0 : options.name });
+        return this;
+    }
+    /**
+     * Value-pattern — redact scalar fields whose string form matches a pattern, regardless of key name (`valuePatterns`).
+     * Lowest precedence; opt-in defense in depth beyond key-name rules.
+     */
+    valuePattern(...patterns) {
+        (0, redactionRules_1.appendRegExpArray)(this.config, 'valuePatterns', patterns);
+        return this;
+    }
+    /**
+     * Merge a {@link presets} return value (or any partial config) into the builder.
+     * Regex arrays and schemas accumulate; scalar options apply only when not already set.
+     */
+    usePreset(preset) {
+        (0, redactionRules_1.mergePartialConfig)(this.config, this.schemas, preset);
+        return this;
+    }
+    redactor(fn) {
+        return this.set('redactor', fn);
+    }
+    syncRedactor(fn) {
+        return this.set('syncRedactor', fn);
+    }
+    ignoreBooleans(value) {
+        return this.set('ignoreBooleans', value);
+    }
+    ignoreNullOrUndefined(value) {
+        return this.set('ignoreNullOrUndefined', value);
+    }
+    cloneInput(value) {
+        return this.set('cloneInput', value);
+    }
+    strict(value = true) {
+        return this.set('strict', value);
+    }
+    onConfigWarning(handler) {
+        return this.set('onConfigWarning', handler);
+    }
+    build() {
+        return Object.assign(Object.assign({}, this.config), (0, redactionRules_1.finalizeRegisteredSchemas)(this.schemas));
+    }
+    buildRedactor() {
+        return new fieldRedactor_1.FieldRedactor(this.build());
+    }
+    buildSafeRedactor() {
+        return fieldRedactor_1.FieldRedactor.createSafe(this.build());
+    }
+    appendRegex(field, patterns) {
+        (0, redactionRules_1.appendRegexToConfig)(this.config, field, patterns);
+        return this;
+    }
+    set(key, value) {
+        this.config[key] = value;
+        return this;
+    }
+}
+exports.FieldRedactorConfigBuilder = FieldRedactorConfigBuilder;
+//# sourceMappingURL=fieldRedactorConfigBuilder.js.map

package/dist/fieldRedactorConfigBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldRedactorConfigBuilder.js","sourceRoot":"","sources":["../src/fieldRedactorConfigBuilder.ts"],"names":[],"mappings":"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"}

package/dist/fieldRedactorDeps.d.ts

@@ -0,0 +1,17 @@
+import { CustomObjectManager } from './customObjectManager';
+import { ObjectRedactor } from './objectRedactor';
+import { PrimitiveRedactor } from './primitiveRedactor';
+import { SecretManager } from './secretManager';
+import { FieldRedactorConfig } from './types';
+import { ValuePatternMatcher } from './valuePatternMatcher';
+export type FieldRedactorDeps = {
+    primitiveRedactor: PrimitiveRedactor;
+    secretManager: SecretManager;
+    valuePatternMatcher: ValuePatternMatcher;
+    customObjectManager: CustomObjectManager;
+    objectRedactor: ObjectRedactor;
+    usesAsyncRedactor: boolean;
+    cloneInput: boolean;
+};
+export declare const buildFieldRedactorDeps: (config?: FieldRedactorConfig) => FieldRedactorDeps;
+//# sourceMappingURL=fieldRedactorDeps.d.ts.map

package/dist/fieldRedactorDeps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldRedactorDeps.d.ts","sourceRoot":"","sources":["../src/fieldRedactorDeps.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAA+B,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEzF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,aAAa,EAAE,aAAa,CAAC;IAC7B,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,cAAc,EAAE,cAAc,CAAC;IAC/B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,UAAU,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,eAAO,MAAM,sBAAsB,YAAa,mBAAmB,KAAG,iBA+CrE,CAAC"}

package/dist/fieldRedactorDeps.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildFieldRedactorDeps = void 0;
+const customObjectManager_1 = require("./customObjectManager");
+const objectRedactor_1 = require("./objectRedactor");
+const primitiveRedactor_1 = require("./primitiveRedactor");
+const redactionRules_1 = require("./redactionRules");
+const secretManager_1 = require("./secretManager");
+const valuePatternMatcher_1 = require("./valuePatternMatcher");
+const buildFieldRedactorDeps = (config) => {
+    const { redactor, syncRedactor, deepSecretKeys, fullSecretKeys, deleteSecretKeys, customObjects, valuePatterns } = config !== null && config !== void 0 ? config : {};
+    const ignoreNullOrUndefined = typeof (config === null || config === void 0 ? void 0 : config.ignoreNullOrUndefined) === 'boolean' ? config.ignoreNullOrUndefined : true;
+    const ignoreBooleans = typeof (config === null || config === void 0 ? void 0 : config.ignoreBooleans) === 'boolean' ? config.ignoreBooleans : false;
+    const cloneInput = (config === null || config === void 0 ? void 0 : config.cloneInput) !== false;
+    const primitiveRedactor = new primitiveRedactor_1.PrimitiveRedactor({
+        ignoreBooleans,
+        ignoreNullOrUndefined,
+        redactor,
+        syncRedactor
+    });
+    const secretManager = new secretManager_1.SecretManager({
+        secretKeys: (0, redactionRules_1.resolveSecretKeys)(config),
+        deepSecretKeys,
+        fullSecretKeys,
+        deleteSecretKeys
+    });
+    const valuePatternMatcher = (valuePatterns === null || valuePatterns === void 0 ? void 0 : valuePatterns.length) ? new valuePatternMatcher_1.ValuePatternMatcher(valuePatterns) : valuePatternMatcher_1.EMPTY_VALUE_PATTERN_MATCHER;
+    const customObjectManager = new customObjectManager_1.CustomObjectManager(customObjects, config === null || config === void 0 ? void 0 : config.schemaNames);
+    const objectRedactor = new objectRedactor_1.ObjectRedactor(primitiveRedactor, secretManager, customObjectManager, valuePatternMatcher);
+    return {
+        primitiveRedactor,
+        secretManager,
+        valuePatternMatcher,
+        customObjectManager,
+        objectRedactor,
+        usesAsyncRedactor: primitiveRedactor.usesAsyncRedactor(),
+        cloneInput
+    };
+};
+exports.buildFieldRedactorDeps = buildFieldRedactorDeps;
+//# sourceMappingURL=fieldRedactorDeps.js.map

package/dist/fieldRedactorDeps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldRedactorDeps.js","sourceRoot":"","sources":["../src/fieldRedactorDeps.ts"],"names":[],"mappings":";;;AAAA,+DAA4D;AAC5D,qDAAkD;AAClD,2DAAwD;AACxD,qDAAqD;AACrD,mDAAgD;AAEhD,+DAAyF;AAYlF,MAAM,sBAAsB,GAAG,CAAC,MAA4B,EAAqB,EAAE;IACxF,MAAM,EACJ,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,aAAa,EACd,GAAG,MAAM,aAAN,MAAM,cAAN,MAAM,GAAI,EAAE,CAAC;IAEjB,MAAM,qBAAqB,GACzB,OAAO,CAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,qBAAqB,CAAA,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3F,MAAM,cAAc,GAAG,OAAO,CAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,cAAc,CAAA,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC;IACnG,MAAM,UAAU,GAAG,CAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,UAAU,MAAK,KAAK,CAAC;IAEhD,MAAM,iBAAiB,GAAG,IAAI,qCAAiB,CAAC;QAC9C,cAAc;QACd,qBAAqB;QACrB,QAAQ;QACR,YAAY;KACb,CAAC,CAAC;IAEH,MAAM,aAAa,GAAG,IAAI,6BAAa,CAAC;QACtC,UAAU,EAAE,IAAA,kCAAiB,EAAC,MAAM,CAAC;QACrC,cAAc;QACd,cAAc;QACd,gBAAgB;KACjB,CAAC,CAAC;IACH,MAAM,mBAAmB,GAAG,CAAA,aAAa,aAAb,aAAa,uBAAb,aAAa,CAAE,MAAM,EAAC,CAAC,CAAC,IAAI,yCAAmB,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,iDAA2B,CAAC;IACzH,MAAM,mBAAmB,GAAG,IAAI,yCAAmB,CAAC,aAAa,EAAE,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,WAAW,CAAC,CAAC;IACxF,MAAM,cAAc,GAAG,IAAI,+BAAc,CACvC,iBAAiB,EACjB,aAAa,EACb,mBAAmB,EACnB,mBAAmB,CACpB,CAAC;IAEF,OAAO;QACL,iBAAiB;QACjB,aAAa;QACb,mBAAmB;QACnB,mBAAmB;QACnB,cAAc;QACd,iBAAiB,EAAE,iBAAiB,CAAC,iBAAiB,EAAE;QACxD,UAAU;KACX,CAAC;AACJ,CAAC,CAAC;AA/CW,QAAA,sBAAsB,0BA+CjC"}

package/dist/index.d.ts

@@ -1,4 +1,10 @@
 import { FieldRedactor } from './fieldRedactor';
-export { CustomObjectMatchType, Redactor, FieldRedactorConfig, CustomObject } from './types';
+export { CustomObjectMatchType, Redactor, FieldRedactorConfig, CustomObject, DryRunReport, DryRunResult, DryRunPathRule, MatchedSchemaReport, RedactionRuleLabel, JsonArray, JsonFunction, JsonLeafValue, JsonObject, JsonPrimitive, JsonValue, RedactableInput, RedactablePrimitive, RedactedPrimitive, RedactorInput, SecretSpecifierValue, SyncRedactor, TraversableJson, isJsonObject } from './types';
+export { FieldRedactorError, FieldRedactorConfigurationError } from './errors';
+export { validateFieldRedactorConfig, hasExplicitRedactionRules } from './configValidator';
+export { EMPTY_DRY_RUN_REPORT } from './dryRun';
+export { presets } from './presets';
+export { FieldRedactorConfigBuilder } from './fieldRedactorConfigBuilder';
+export type { SchemaOptions } from './fieldRedactorConfigBuilder';
 export { FieldRedactor };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,QAAQ,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC7F,OAAO,EAAE,aAAa,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EACL,qBAAqB,EACrB,QAAQ,EACR,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,SAAS,EACT,YAAY,EACZ,aAAa,EACb,UAAU,EACV,aAAa,EACb,SAAS,EACT,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,EACb,oBAAoB,EACpB,YAAY,EACZ,eAAe,EACf,YAAY,EACb,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,kBAAkB,EAAE,+BAA+B,EAAE,MAAM,UAAU,CAAC;AAC/E,OAAO,EAAE,2BAA2B,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAC3F,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,YAAY,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/dist/index.js

@@ -1,8 +1,21 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FieldRedactor = exports.CustomObjectMatchType = void 0;
+exports.FieldRedactor = exports.FieldRedactorConfigBuilder = exports.presets = exports.EMPTY_DRY_RUN_REPORT = exports.hasExplicitRedactionRules = exports.validateFieldRedactorConfig = exports.FieldRedactorConfigurationError = exports.FieldRedactorError = exports.isJsonObject = exports.CustomObjectMatchType = void 0;
 const fieldRedactor_1 = require("./fieldRedactor");
 Object.defineProperty(exports, "FieldRedactor", { enumerable: true, get: function () { return fieldRedactor_1.FieldRedactor; } });
 var types_1 = require("./types");
 Object.defineProperty(exports, "CustomObjectMatchType", { enumerable: true, get: function () { return types_1.CustomObjectMatchType; } });
+Object.defineProperty(exports, "isJsonObject", { enumerable: true, get: function () { return types_1.isJsonObject; } });
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "FieldRedactorError", { enumerable: true, get: function () { return errors_1.FieldRedactorError; } });
+Object.defineProperty(exports, "FieldRedactorConfigurationError", { enumerable: true, get: function () { return errors_1.FieldRedactorConfigurationError; } });
+var configValidator_1 = require("./configValidator");
+Object.defineProperty(exports, "validateFieldRedactorConfig", { enumerable: true, get: function () { return configValidator_1.validateFieldRedactorConfig; } });
+Object.defineProperty(exports, "hasExplicitRedactionRules", { enumerable: true, get: function () { return configValidator_1.hasExplicitRedactionRules; } });
+var dryRun_1 = require("./dryRun");
+Object.defineProperty(exports, "EMPTY_DRY_RUN_REPORT", { enumerable: true, get: function () { return dryRun_1.EMPTY_DRY_RUN_REPORT; } });
+var presets_1 = require("./presets");
+Object.defineProperty(exports, "presets", { enumerable: true, get: function () { return presets_1.presets; } });
+var fieldRedactorConfigBuilder_1 = require("./fieldRedactorConfigBuilder");
+Object.defineProperty(exports, "FieldRedactorConfigBuilder", { enumerable: true, get: function () { return fieldRedactorConfigBuilder_1.FieldRedactorConfigBuilder; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,mDAAgD;AAEvC,8FAFA,6BAAa,OAEA;AADtB,iCAA6F;AAApF,8GAAA,qBAAqB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,mDAAgD;AAgCvC,8FAhCA,6BAAa,OAgCA;AA/BtB,iCAwBiB;AAvBf,8GAAA,qBAAqB,OAAA;AAsBrB,qGAAA,YAAY,OAAA;AAEd,mCAA+E;AAAtE,4GAAA,kBAAkB,OAAA;AAAE,yHAAA,+BAA+B,OAAA;AAC5D,qDAA2F;AAAlF,8HAAA,2BAA2B,OAAA;AAAE,4HAAA,yBAAyB,OAAA;AAC/D,mCAAgD;AAAvC,8GAAA,oBAAoB,OAAA;AAC7B,qCAAoC;AAA3B,kGAAA,OAAO,OAAA;AAChB,2EAA0E;AAAjE,wIAAA,0BAA0B,OAAA"}

package/dist/jsonWalk.d.ts

@@ -0,0 +1,11 @@
+import { JsonArray, JsonObject, JsonValue } from './types';
+export declare const parseJsonPath: (path: string) => Array<string | number>;
+export declare const getJsonValueAtPath: (value: JsonValue | undefined, segments: Array<string | number>) => JsonValue | undefined;
+export declare const getParentContext: (value: JsonValue | undefined, segments: Array<string | number>) => {
+    parent: JsonObject | JsonArray | undefined;
+    leaf: string | number | undefined;
+};
+export declare const joinPath: (base: string, segment: string | number) => string;
+export declare const isTraversableJson: (value: JsonValue | undefined) => value is JsonObject | JsonValue[];
+export declare const walkTraversableJson: (value: JsonValue | undefined, path: string, visit: (value: JsonValue, path: string) => void) => void;
+//# sourceMappingURL=jsonWalk.d.ts.map

package/dist/jsonWalk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonWalk.d.ts","sourceRoot":"","sources":["../src/jsonWalk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzE,eAAO,MAAM,aAAa,SAAU,MAAM,KAAG,KAAK,CAAC,MAAM,GAAG,MAAM,CAuCjE,CAAC;AAEF,eAAO,MAAM,kBAAkB,UAAW,SAAS,GAAG,SAAS,YAAY,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,KAAG,SAAS,GAAG,SAsB/G,CAAC;AAEF,eAAO,MAAM,gBAAgB,UACpB,SAAS,GAAG,SAAS,YAClB,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,KAC/B;IAAE,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;CAUjF,CAAC;AAEF,eAAO,MAAM,QAAQ,SAAU,MAAM,WAAW,MAAM,GAAG,MAAM,KAAG,MACqD,CAAC;AAExH,eAAO,MAAM,iBAAiB,UAAW,SAAS,GAAG,SAAS,KAAG,KAAK,IAAI,UAAU,GAAG,SAAS,EAC9B,CAAC;AAEnE,eAAO,MAAM,mBAAmB,UACvB,SAAS,GAAG,SAAS,QACtB,MAAM,SACL,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,KAC9C,IAgBF,CAAC"}