@heroku/js-blanket 0.0.0 → 1.0.0

package/dist/esm/core/scrubber.test.js

@@ -0,0 +1,390 @@
+import { describe, it } from 'mocha';
+import { expect } from 'chai';
+import { Scrubber } from './scrubber.js';
+describe('Scrubber', () => {
+    describe('Field-based scrubbing', () => {
+        it('scrubs sensitive fields at any depth', () => {
+            const scrubber = new Scrubber({
+                fields: ['access_token'],
+            });
+            const input = {
+                user: {
+                    profile: {
+                        settings: {
+                            auth: { access_token: 'secret123' },
+                        },
+                    },
+                },
+            };
+            const { data } = scrubber.scrub(input);
+            expect(data.user.profile.settings.auth.access_token).to.equal('[SCRUBBED]');
+        });
+        it('handles case-insensitive field matching', () => {
+            const scrubber = new Scrubber({
+                fields: ['password'],
+            });
+            const input = {
+                Password: 'secret1',
+                PASSWORD: 'secret2',
+                password: 'secret3',
+            };
+            const { data } = scrubber.scrub(input);
+            expect(data.Password).to.equal('[SCRUBBED]');
+            expect(data.PASSWORD).to.equal('[SCRUBBED]');
+            expect(data.password).to.equal('[SCRUBBED]');
+        });
+        it('supports regex field patterns', () => {
+            const scrubber = new Scrubber({
+                fields: [/api[-_]?key/i], // Matches api_key, api-key, apikey (case insensitive)
+            });
+            const input = {
+                user_api_key: 'secret',
+                API_KEY_V2: 'secret',
+                myApiKeyHere: 'secret',
+            };
+            const { data } = scrubber.scrub(input);
+            expect(data.user_api_key).to.equal('[SCRUBBED]');
+            expect(data.API_KEY_V2).to.equal('[SCRUBBED]');
+            expect(data.myApiKeyHere).to.equal('[SCRUBBED]');
+        });
+    });
+    describe('Path-based scrubbing', () => {
+        it('scrubs specific paths only', () => {
+            const scrubber = new Scrubber({
+                paths: ['user.profile.email'],
+            });
+            const input = {
+                user: {
+                    profile: { email: 'bob@example.com', name: 'Bob' },
+                    settings: { email: 'notifications@example.com' },
+                },
+            };
+            const { data } = scrubber.scrub(input);
+            expect(data.user.profile.email).to.equal('[SCRUBBED]');
+            expect(data.user.settings.email).to.equal('notifications@example.com');
+        });
+        it('scrubs array items by index', () => {
+            const scrubber = new Scrubber({
+                paths: ['users[0].password'],
+            });
+            const input = {
+                users: [
+                    { name: 'bob', password: 'secret1' },
+                    { name: 'alice', password: 'secret2' },
+                ],
+            };
+            const { data } = scrubber.scrub(input);
+            expect(data.users?.[0]?.password).to.equal('[SCRUBBED]');
+            expect(data.users?.[1]?.password).to.equal('secret2');
+        });
+    });
+    describe('Pattern-based scrubbing', () => {
+        it('scrubs SSN patterns in strings', () => {
+            const scrubber = new Scrubber({
+                patterns: [/\b\d{3}-\d{2}-\d{4}\b/g],
+            });
+            const input = { message: 'User SSN is 123-45-6789' };
+            const { data } = scrubber.scrub(input);
+            expect(data.message).to.contain('[SCRUBBED]');
+            expect(data.message).not.to.contain('123-45-6789');
+        });
+        it('scrubs email patterns in strings', () => {
+            const scrubber = new Scrubber({
+                patterns: [/\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Z|a-z]{2,}\b/g],
+            });
+            const input = { log: 'Auth failed for user@example.com' };
+            const { data } = scrubber.scrub(input);
+            expect(data.log).to.contain('[SCRUBBED]');
+            expect(data.log).not.to.contain('user@example.com');
+        });
+        it('scrubs multiple patterns in same string', () => {
+            const scrubber = new Scrubber({
+                patterns: [
+                    /\b\d{3}-\d{2}-\d{4}\b/g, // SSN
+                    /\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Z|a-z]{2,}\b/g, // Email
+                ],
+            });
+            const input = {
+                log: 'User bob@example.com has SSN 123-45-6789',
+            };
+            const { data } = scrubber.scrub(input);
+            expect(data.log).not.to.contain('bob@example.com');
+            expect(data.log).not.to.contain('123-45-6789');
+        });
+    });
+    describe('Array handling', () => {
+        it('scrubs fields across all array items', () => {
+            const scrubber = new Scrubber({
+                fields: ['password'],
+            });
+            const users = [
+                { name: 'bob', password: 'secret' },
+                { name: 'alice', password: 'hidden' },
+            ];
+            const { data } = scrubber.scrub(users);
+            expect(data[0]?.password).to.equal('[SCRUBBED]');
+            expect(data[1]?.password).to.equal('[SCRUBBED]');
+            expect(data[0]?.name).to.equal('bob');
+            expect(data[1]?.name).to.equal('alice');
+        });
+        it('handles nested arrays', () => {
+            const scrubber = new Scrubber({
+                fields: ['api_key'],
+            });
+            const input = {
+                teams: [
+                    {
+                        members: [
+                            { name: 'bob', api_key: 'secret1' },
+                            { name: 'alice', api_key: 'secret2' },
+                        ],
+                    },
+                ],
+            };
+            const { data } = scrubber.scrub(input);
+            expect(data.teams?.[0]?.members?.[0]?.api_key).to.equal('[SCRUBBED]');
+            expect(data.teams?.[0]?.members?.[1]?.api_key).to.equal('[SCRUBBED]');
+        });
+    });
+    describe('Circular reference handling', () => {
+        it('handles circular references without crashing', () => {
+            const scrubber = new Scrubber({ fields: [] });
+            const input = { name: 'test' };
+            input.self = input;
+            const { data } = scrubber.scrub(input);
+            expect(data.self).to.equal('[Circular Reference]');
+        });
+        it('scrubs fields before detecting circular references', () => {
+            const scrubber = new Scrubber({ fields: ['password'] });
+            const input = { name: 'test', password: 'secret' };
+            input.self = input;
+            const { data } = scrubber.scrub(input);
+            expect(data.password).to.equal('[SCRUBBED]');
+            expect(data.self).to.equal('[Circular Reference]');
+        });
+        it('handles nested circular references', () => {
+            const scrubber = new Scrubber({ fields: [] });
+            const input = { name: 'test', nested: { level: 1 } };
+            input.self = input;
+            input.nested.parent = input;
+            const { data } = scrubber.scrub(input);
+            expect(data.self).to.equal('[Circular Reference]');
+            expect(data.nested.parent).to.equal('[Circular Reference]');
+        });
+    });
+    describe('Combined modes', () => {
+        it('applies field + path + pattern scrubbing together', () => {
+            const scrubber = new Scrubber({
+                fields: ['api_key'],
+                paths: ['user.email'],
+                patterns: [/\b\d{3}-\d{2}-\d{4}\b/g],
+            });
+            const input = {
+                user: {
+                    email: 'bob@example.com', // Path-based
+                    api_key: 'secret-key-123', // Field-based
+                },
+                log: 'SSN: 123-45-6789', // Pattern-based
+                nested: {
+                    service: {
+                        api_key: 'another-secret', // Field-based (any depth)
+                    },
+                },
+            };
+            const { data, scrubbedPaths } = scrubber.scrub(input);
+            expect(data.user?.email).to.equal('[SCRUBBED]');
+            expect(data.user?.api_key).to.equal('[SCRUBBED]');
+            expect(data.log).not.to.contain('123-45-6789');
+            expect(data.nested?.service?.api_key).to.equal('[SCRUBBED]');
+            expect(scrubbedPaths.length).to.be.greaterThan(0);
+        });
+    });
+    describe('Scrub result metadata', () => {
+        it('tracks scrubbed paths', () => {
+            const scrubber = new Scrubber({
+                fields: ['password'],
+                paths: ['user.email'],
+            });
+            const input = {
+                user: { email: 'test@example.com', password: 'secret' },
+            };
+            const result = scrubber.scrub(input);
+            expect(result.scrubbed).to.be.true;
+            expect(result.scrubbedPaths).to.include.members([
+                'user.email',
+                'user.password',
+            ]);
+        });
+        it('reports scrubbed=false when nothing was scrubbed', () => {
+            const scrubber = new Scrubber({
+                fields: ['password'],
+            });
+            const input = { name: 'Bob', age: 30 };
+            const result = scrubber.scrub(input);
+            expect(result.scrubbed).to.be.false;
+            expect(result.scrubbedPaths).to.have.length(0);
+        });
+    });
+    describe('Immutability', () => {
+        it('does not mutate original object', () => {
+            const scrubber = new Scrubber({
+                fields: ['password'],
+            });
+            const input = { user: { password: 'secret', name: 'Bob' } };
+            const original = JSON.stringify(input);
+            scrubber.scrub(input);
+            expect(JSON.stringify(input)).to.equal(original);
+            expect(input.user.password).to.equal('secret');
+        });
+    });
+    describe('Custom replacement text', () => {
+        it('uses custom replacement string', () => {
+            const scrubber = new Scrubber({
+                fields: ['password'],
+                replacement: '***REDACTED***',
+            });
+            const input = { password: 'secret' };
+            const { data } = scrubber.scrub(input);
+            expect(data.password).to.equal('***REDACTED***');
+        });
+    });
+    describe('Edge cases', () => {
+        it('handles null values', () => {
+            const scrubber = new Scrubber({ fields: ['password'] });
+            const input = { user: null };
+            const { data } = scrubber.scrub(input);
+            expect(data.user).to.be.null;
+        });
+        it('handles undefined values', () => {
+            const scrubber = new Scrubber({ fields: ['password'] });
+            const input = { user: undefined };
+            const { data } = scrubber.scrub(input);
+            expect(data.user).to.be.undefined;
+        });
+        it('handles empty objects', () => {
+            const scrubber = new Scrubber({ fields: ['password'] });
+            const input = {};
+            const { data } = scrubber.scrub(input);
+            expect(data).to.deep.equal({});
+        });
+        it('handles empty arrays', () => {
+            const scrubber = new Scrubber({ fields: ['password'] });
+            const input = [];
+            const { data } = scrubber.scrub(input);
+            expect(data).to.deep.equal([]);
+        });
+        it('handles primitive values', () => {
+            const scrubber = new Scrubber({ fields: ['password'] });
+            expect(scrubber.scrub('test').data).to.equal('test');
+            expect(scrubber.scrub(123).data).to.equal(123);
+            expect(scrubber.scrub(true).data).to.equal(true);
+        });
+        it('scrubs entire array element by index path', () => {
+            // Tests lines 76-78: scrubbing entire array element, not just a field
+            const scrubber = new Scrubber({
+                paths: ['users[0]', 'items[1]'], // Scrub specific array elements by full path
+            });
+            const input = {
+                users: [
+                    { name: 'bob', email: 'bob@example.com' }, // Should be scrubbed entirely
+                    { name: 'alice', email: 'alice@example.com' }, // Not scrubbed
+                ],
+                items: [
+                    { id: 1, value: 'keep' }, // Not scrubbed
+                    { id: 2, value: 'scrub' }, // Should be scrubbed entirely
+                ],
+            };
+            const { data } = scrubber.scrub(input);
+            expect(data.users?.[0]).to.equal('[SCRUBBED]');
+            expect(data.users?.[1]?.name).to.equal('alice'); // Not scrubbed
+            expect(data.items?.[0]?.value).to.equal('keep'); // Not scrubbed
+            expect(data.items?.[1]).to.equal('[SCRUBBED]'); // Entire element scrubbed
+        });
+        it('scrubs array index across all arrays', () => {
+            // Tests that index-only paths (e.g., '0') scrub that index in ALL arrays
+            const scrubber = new Scrubber({
+                paths: ['1'], // Scrub index 1 of ANY array
+            });
+            const input = {
+                users: [
+                    { name: 'bob' }, // Index 0 - not scrubbed
+                    { name: 'alice' }, // Index 1 - scrubbed
+                    { name: 'charlie' }, // Index 2 - not scrubbed
+                ],
+                teams: [
+                    { id: 'team-a' }, // Index 0 - not scrubbed
+                    { id: 'team-b' }, // Index 1 - scrubbed
+                ],
+            };
+            const { data } = scrubber.scrub(input);
+            expect(data.users?.[0]?.name).to.equal('bob');
+            expect(data.users?.[1]).to.equal('[SCRUBBED]'); // Scrubbed by index
+            expect(data.users?.[2]?.name).to.equal('charlie');
+            expect(data.teams?.[0]?.id).to.equal('team-a');
+            expect(data.teams?.[1]).to.equal('[SCRUBBED]'); // Scrubbed by index
+        });
+        it('handles deeply nested objects (10+ levels)', () => {
+            // Validates discovery doc requirement: "Scrubs nested objects 10+ levels deep"
+            const scrubber = new Scrubber({
+                fields: ['secret'],
+            });
+            // Build a 15-level deep object
+            const input = { level: 1 };
+            let current = input;
+            for (let i = 2; i <= 15; i++) {
+                current.nested = { level: i };
+                current = current.nested;
+            }
+            // Add secret at the deepest level
+            current.secret = 'deep-secret';
+            current.public = 'visible';
+            const { data } = scrubber.scrub(input);
+            // Navigate to the deepest level
+            let deepest = data;
+            for (let i = 1; i < 15; i++) {
+                expect(deepest.level).to.equal(i);
+                deepest = deepest.nested;
+            }
+            // Verify scrubbing worked at 15 levels deep
+            expect(deepest.level).to.equal(15);
+            expect(deepest.secret).to.equal('[SCRUBBED]');
+            expect(deepest.public).to.equal('visible');
+        });
+        it('handles circular references in deep clone fallback (arrays)', () => {
+            // Tests lines 166-172: circular reference deep clone for arrays
+            const scrubber = new Scrubber({
+                fields: ['password'],
+            });
+            // Create an object with circular references that will trigger the fallback clone
+            const parent = { name: 'parent', password: 'secret' };
+            const child1 = { name: 'child1', items: [] };
+            const child2 = { name: 'child2', password: 'hidden' };
+            // Create circular reference in an array
+            child1.items = [child2, parent]; // Array contains parent
+            parent.children = [child1]; // Parent contains array with circular ref
+            const { data } = scrubber.scrub(parent);
+            // Verify scrubbing happened
+            expect(data.password).to.equal('[SCRUBBED]');
+            expect(data.children?.[0]?.name).to.equal('child1');
+            // Verify circular reference was handled in the array
+            expect(data.children?.[0]?.items?.[1]).to.equal('[Circular Reference]');
+        });
+        it('handles arrays with circular self-reference', () => {
+            // Additional test for circular array deep cloning
+            const scrubber = new Scrubber({
+                fields: ['token'],
+            });
+            const obj = {
+                token: 'secret-token',
+                list: [{ name: 'item1' }],
+            };
+            // Array references the parent object
+            obj.list.push(obj);
+            const { data } = scrubber.scrub(obj);
+            expect(data.token).to.equal('[SCRUBBED]');
+            expect(data.list?.[0]?.name).to.equal('item1');
+            expect(data.list?.[1]).to.equal('[Circular Reference]');
+        });
+    });
+});
+//# sourceMappingURL=scrubber.test.js.map

package/dist/esm/core/scrubber.test.js.map

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

package/dist/esm/core/types.d.ts

@@ -0,0 +1,169 @@
+/**
+ * Configuration for the Scrubber
+ *
+ * Defines how the scrubber should identify and replace sensitive data.
+ * Supports three complementary scrubbing strategies:
+ *
+ * 1. **Field-based scrubbing** (`fields`): Matches field names at any depth in the object tree
+ * 2. **Path-based scrubbing** (`paths`): Matches specific dot-notation paths
+ * 3. **Pattern-based scrubbing** (`patterns`): Matches regex patterns in string content
+ *
+ * All three strategies can be used together for comprehensive data scrubbing.
+ *
+ * @example Field-based configuration
+ * ```typescript
+ * const config: ScrubConfig = {
+ *   fields: ['password', 'apiToken', /api[-_]?key/i], // Strings and regex patterns
+ *   replacement: '[REDACTED]'
+ * };
+ * ```
+ *
+ * @example Path-based configuration
+ * ```typescript
+ * const config: ScrubConfig = {
+ *   paths: [
+ *     'user.email',
+ *     'request.headers.authorization',
+ *     'items[0].password'  // Array index notation
+ *   ]
+ * };
+ * ```
+ *
+ * @example Pattern-based configuration
+ * ```typescript
+ * const config: ScrubConfig = {
+ *   patterns: [
+ *     /\b\d{3}-\d{2}-\d{4}\b/g,           // SSN
+ *     /\d{4}-\d{4}-\d{4}-\d{4}/g,        // Credit card
+ *     /[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Z|a-z]{2,}/g  // Email
+ *   ]
+ * };
+ * ```
+ */
+export interface ScrubConfig {
+    /**
+     * Field-based scrubbing: matches field names at any depth
+     *
+     * Supports both exact string matches and regular expressions for flexible matching.
+     * String matches are case-insensitive and use substring matching.
+     *
+     * @example
+     * ```typescript
+     * fields: [
+     *   'password',           // Matches 'password', 'Password', 'old_password', etc.
+     *   'apiToken',           // Matches 'apiToken', 'api_token', etc.
+     *   /api[-_]?key/i,       // Regex: matches 'api_key', 'api-key', 'apikey' (case insensitive)
+     *   /^secret$/            // Exact match: only 'secret', not 'my_secret'
+     * ]
+     * ```
+     */
+    fields?: (string | RegExp)[];
+    /**
+     * Path-based scrubbing: matches specific dot-notation paths
+     *
+     * Use dot notation to target specific fields in nested objects.
+     * Supports array index notation (e.g., `items[0].password`).
+     *
+     * @example
+     * ```typescript
+     * paths: [
+     *   'user.email',                        // Scrubs obj.user.email
+     *   'request.headers.authorization',     // Nested path
+     *   'items[0].secret',                   // Array index notation
+     *   'users[0]'                           // Scrubs entire array element
+     * ]
+     * ```
+     */
+    paths?: string[];
+    /**
+     * Pattern-based scrubbing: regex patterns for content scrubbing
+     *
+     * Scans string values and replaces content matching the patterns.
+     * Use the global flag (`/pattern/g`) to replace all matches in a string.
+     *
+     * **Note**: Patterns are applied to string values only, not to field names or paths.
+     *
+     * @example
+     * ```typescript
+     * patterns: [
+     *   /\b\d{3}-\d{2}-\d{4}\b/g,      // Social Security Number
+     *   /\d{4}-\d{4}-\d{4}-\d{4}/g,    // Credit Card
+     *   /Bearer\s+[A-Za-z0-9._-]+/g    // Bearer tokens
+     * ]
+     * ```
+     */
+    patterns?: RegExp[];
+    /**
+     * Replacement string for scrubbed values
+     *
+     * @default '[SCRUBBED]'
+     *
+     * @example
+     * ```typescript
+     * replacement: '[REDACTED]'     // Custom replacement text
+     * replacement: '***'            // Simple masking
+     * replacement: ''               // Empty string (removes content)
+     * ```
+     */
+    replacement?: string;
+    /**
+     * Whether to recursively scrub nested objects
+     *
+     * When `true`, the scrubber traverses the entire object tree.
+     * When `false`, only top-level fields are scrubbed.
+     *
+     * @default true
+     *
+     * @example
+     * ```typescript
+     * recursive: false  // Only scrub top-level fields
+     * ```
+     */
+    recursive?: boolean;
+}
+/**
+ * Result of a scrub operation
+ *
+ * Contains the scrubbed data along with metadata about what was scrubbed.
+ *
+ * @template T - The type of the scrubbed data (same as input type)
+ *
+ * @example
+ * ```typescript
+ * const scrubber = new Scrubber({ fields: ['password'] });
+ * const result = scrubber.scrub({ user: 'john', password: 'secret' });
+ *
+ * console.log(result.data);           // { user: 'john', password: '[SCRUBBED]' }
+ * console.log(result.scrubbed);       // true
+ * console.log(result.scrubbedPaths);  // ['password']
+ * ```
+ */
+export interface ScrubResult<T> {
+    /**
+     * The scrubbed data with sensitive values replaced
+     *
+     * This is a deep clone of the input with scrubbed values replaced.
+     * The original input is never mutated.
+     */
+    data: T;
+    /**
+     * Whether any scrubbing occurred
+     *
+     * `true` if at least one value was scrubbed, `false` if no sensitive data was found.
+     *
+     * Useful for logging or metrics to track scrubbing activity.
+     */
+    scrubbed: boolean;
+    /**
+     * Array of paths that were scrubbed
+     *
+     * Contains dot-notation paths for all fields that were scrubbed.
+     * Useful for debugging, auditing, or understanding what data was redacted.
+     *
+     * @example
+     * ```typescript
+     * ['password', 'user.email', 'request.headers.authorization']
+     * ```
+     */
+    scrubbedPaths: string[];
+}

package/dist/esm/core/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/types.ts"],"names":[],"mappings":""}

package/dist/esm/core/types.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Type Safety Tests for Core Scrubber
+ *
+ * These tests validate that TypeScript types are preserved correctly through scrubbing operations.
+ * They use compile-time type assertions to ensure type safety without runtime overhead.
+ *
+ * Run with: pnpm test (type-checked during pretest)
+ */
+export {};