n8n-nodes-redactor 2.0.0

package/dist/nodes/PiiRedactor/PiiRedactor.node.js

@@ -0,0 +1,872 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PiiRedactor = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const patterns_1 = require("./patterns");
+const vault_1 = require("./vault");
+const engine_1 = require("./engine");
+/**
+ * Curated high-precision pattern set. These patterns have low false-positive
+ * rates and are safe to enable by default. Excludes broad patterns like
+ * bare digit-only matches (postalCodeDE, postalCodeAT, bsnNL, etc.)
+ */
+const RECOMMENDED_PATTERNS = [
+    // Contact
+    'email', 'phone', 'phoneDE', 'phoneUK', 'phoneAT', 'phoneCH', 'phoneFR',
+    'phoneNL', 'phoneES', 'phoneIT', 'phoneAU', 'phoneIN', 'phoneBR',
+    // Identity - high precision
+    'personName', 'ssn', 'itinUS', 'sinCA', 'ninoUK', 'passportUS', 'passportEU',
+    'passportDE', 'nationalIdDE', 'nhsNumber', 'taxIdUS', 'taxIdDE',
+    'sozialversicherungDE', 'ahvCH', 'nationalIdFR', 'codiceFiscaleIT',
+    'dniES', 'nieES', 'nifES', 'peselPL', 'bsnNL', 'hetuFI', 'ppsIE',
+    'nricSG', 'panIN', 'cpfBR', 'driverLicenseCtx', 'employeeIdCtx',
+    'fullNameCtx', 'mothersMaidenName', 'passportCtx',
+    // Financial - validated
+    'creditCard', 'amex', 'iban', 'bic', 'vatEU', 'abaRouting', 'sortCodeUK',
+    'cardExpiry', 'cvvCtx', 'bankAccountCtx', 'insurancePolicyCtx',
+    'salaryCtx', 'loyaltyNumberCtx',
+    // Network
+    'ipv4', 'ipv6', 'macAddress', 'ipv4Port', 'url', 'privateIp',
+    // Location - validated formats
+    'postalCodeUK', 'postalCodeNL', 'postalCodePL', 'postalCodeCA',
+    'postalCodeJP', 'gpsCoordinates',
+    'addressDE', 'addressLabeledDE', 'addressLabeledEN', 'addressLabeledFR',
+    'addressEUStreetNumber',
+    // Dates
+    'dateSlash', 'dateDash', 'dateDot', 'dateOfBirth',
+    // Medical
+    'medicalRecordNumber', 'deaNumber', 'npiNumber', 'rxNumber',
+    'healthPlanCtx', 'bloodTypeCtx',
+    // Enterprise secrets
+    'internalHostname', 'uncPath', 'ldapDN', 'adUsername',
+    'dbConnectionString', 'connStringKV',
+    'awsAccessKey', 'gcpApiKey', 'stripeKey', 'openaiKey', 'githubToken',
+    'slackToken', 'bearerToken', 'jwtToken', 'pemPrivateKey', 'sshPublicKey',
+    'genericSecret', 'azureKey', 'slackWebhook',
+    'sendgridKey', 'twilioKey', 'anthropicKey', 'gitlabToken',
+    'x509Certificate', 'pgpPrivateKey', 'envSecrets',
+    // Crypto
+    'bitcoinAddress', 'ethereumAddress',
+    // Vehicle
+    'vin',
+    // Biometric
+    'uuid', 'imei', 'iccid',
+];
+class PiiRedactor {
+    constructor() {
+        this.description = {
+            displayName: 'Redactor',
+            name: 'redactor',
+            icon: 'file:redact.png',
+            group: ['transform'],
+            version: 1,
+            subtitle: '={{$parameter["operation"]}}',
+            usableAsTool: true,
+            description: 'Redact and remove sensitive data, PII, personal information, emails, phone numbers, addresses, IBAN, credit cards, names before sending to LLM. Anonymize, mask, sanitize, scrub customer data. Restore original values after. GDPR HIPAA CCPA compliant. Data privacy, data protection, data masking, data anonymization.',
+            defaults: {
+                name: 'Redactor',
+            },
+            inputs: ['main'],
+            // @ts-ignore dynamic outputs using n8n's function pattern (same as Switch node)
+            outputs: `={{((parameters) => parameters["includeReport"] ? [{ type: "main", displayName: "Data" }, { type: "main", displayName: "Report" }] : [{ type: "main", displayName: "Data" }])($parameter)}}`,
+            properties: [
+                // ═══════════════════════════════════════
+                // OPERATION
+                // ═══════════════════════════════════════
+                {
+                    displayName: 'Operation',
+                    name: 'operation',
+                    type: 'options',
+                    noDataExpression: true,
+                    options: [
+                        {
+                            name: 'Redact',
+                            value: 'redact',
+                            description: 'Detect and replace PII with tokens/masks/hashes',
+                        },
+                        {
+                            name: 'Restore',
+                            value: 'restore',
+                            description: 'Replace tokens back with original PII values from vault',
+                        },
+                        {
+                            name: 'Detect (Scan Only)',
+                            value: 'detect',
+                            description: 'Scan for PII without modifying the data. Returns a report of what was found.',
+                        },
+                        {
+                            name: 'Verify',
+                            value: 'verify',
+                            description: 'Re-scan redacted data to confirm no PII leaked through. Returns pass/fail.',
+                        },
+                        {
+                            name: 'Purge',
+                            value: 'purge',
+                            description: 'Delete vault sessions. Supports GDPR right to erasure.',
+                        },
+                        {
+                            name: 'Stats',
+                            value: 'stats',
+                            description: 'List active vault sessions and entry counts',
+                        },
+                    ],
+                    default: 'redact',
+                },
+                // ═══════════════════════════════════════
+                // SESSION ID (shared between Redact & Restore)
+                // ═══════════════════════════════════════
+                {
+                    displayName: 'Session ID',
+                    name: 'sessionId',
+                    type: 'string',
+                    default: '={{$execution.id}}',
+                    description: 'Unique ID linking a Redact and Restore step. Defaults to the current execution ID. Use the same value in both the Redact and Restore nodes.',
+                    required: true,
+                    displayOptions: {
+                        show: {
+                            operation: ['redact', 'restore'],
+                        },
+                    },
+                },
+                {
+                    displayName: 'Session ID to Purge',
+                    name: 'purgeSessionId',
+                    type: 'string',
+                    default: '',
+                    description: 'The session ID to purge. Leave empty is not needed when purging all.',
+                    displayOptions: {
+                        show: {
+                            operation: ['purge'],
+                            purgeScope: ['specific'],
+                        },
+                    },
+                },
+                // ═══════════════════════════════════════
+                // REDACTION MODE
+                // ═══════════════════════════════════════
+                {
+                    displayName: 'Redaction Mode',
+                    name: 'redactionMode',
+                    type: 'options',
+                    displayOptions: {
+                        show: {
+                            operation: ['redact'],
+                        },
+                    },
+                    options: [
+                        {
+                            name: 'Token (Reversible)',
+                            value: 'token',
+                            description: 'Replace PII with [EMAIL_0], [PHONE_1] etc. Restore via vault later. Best for LLM workflows.',
+                        },
+                        {
+                            name: 'Mask (Partial)',
+                            value: 'mask',
+                            description: 'Show partial values: j***@e***.com, ****-****-****-1234. NOT reversible.',
+                        },
+                        {
+                            name: 'Hash (Deterministic)',
+                            value: 'hash',
+                            description: 'Replace with truncated SHA-256 hash. Deterministic but NOT reversible.',
+                        },
+                        {
+                            name: 'Redact (Full Removal)',
+                            value: 'redact',
+                            description: 'Replace with [REDACTED]. NOT reversible.',
+                        },
+                    ],
+                    default: 'token',
+                },
+                // ═══════════════════════════════════════
+                // DETECTION SCOPE
+                // ═══════════════════════════════════════
+                {
+                    displayName: 'Detection Scope',
+                    name: 'detectionScope',
+                    type: 'options',
+                    displayOptions: {
+                        show: {
+                            operation: ['redact'],
+                        },
+                    },
+                    options: [
+                        {
+                            name: 'Recommended (High Precision)',
+                            value: 'recommended',
+                            description: 'Curated set of high-precision patterns. Best for most workflows. Minimal false positives.',
+                        },
+                        {
+                            name: 'All Patterns (Maximum Coverage)',
+                            value: 'all',
+                            description: 'All 200+ patterns including broad ones. May produce false positives on short numbers.',
+                        },
+                        {
+                            name: 'Select Specific Types',
+                            value: 'select',
+                            description: 'Choose which specific data types to detect.',
+                        },
+                    ],
+                    default: 'recommended',
+                    description: 'Detect all sensitive data types automatically, or select specific types to scan for.',
+                },
+                // ═══════════════════════════════════════
+                // PII TYPE SELECTION (only shown when scope is 'select')
+                // ═══════════════════════════════════════
+                {
+                    displayName: 'PII Types to Detect',
+                    name: 'piiTypes',
+                    type: 'multiOptions',
+                    displayOptions: {
+                        show: {
+                            operation: ['redact'],
+                            detectionScope: ['select'],
+                        },
+                    },
+                    options: (0, patterns_1.getPatternOptions)(),
+                    default: [
+                        'email',
+                        'phone',
+                        'phoneDE',
+                        'phoneUK',
+                        'personName',
+                        'ssn',
+                        'ninoUK',
+                        'creditCard',
+                        'iban',
+                        'bic',
+                        'ipv4',
+                        'privateIp',
+                        'addressDE',
+                        'addressLabeledEN',
+                        'addressLabeledDE',
+                        'awsAccessKey',
+                        'genericSecret',
+                        'dbConnectionString',
+                        'jwtToken',
+                        'pemPrivateKey',
+                    ],
+                    description: 'Select which PII types to detect. Each type uses optimized regex with validation where possible.',
+                },
+                // ═══════════════════════════════════════
+                // DEDUPLICATION
+                // ═══════════════════════════════════════
+                {
+                    displayName: 'Deduplicate',
+                    name: 'dedup',
+                    type: 'boolean',
+                    displayOptions: {
+                        show: {
+                            operation: ['redact'],
+                            redactionMode: ['token'],
+                        },
+                    },
+                    default: true,
+                    description: 'When enabled, the same PII value always gets the same token. This preserves relationships in the data (e.g. if an email appears in 3 fields, all 3 get [EMAIL_0]).',
+                },
+                // ═══════════════════════════════════════
+                // FIELD TARGETING
+                // ═══════════════════════════════════════
+                {
+                    displayName: 'Field Targeting',
+                    name: 'fieldMode',
+                    type: 'options',
+                    displayOptions: {
+                        show: {
+                            operation: ['redact'],
+                        },
+                    },
+                    options: [
+                        {
+                            name: 'All Fields',
+                            value: 'all',
+                            description: 'Scan every field in the JSON data',
+                        },
+                        {
+                            name: 'Allowlist -Only These Fields',
+                            value: 'allowlist',
+                            description: 'Only scan the fields listed below',
+                        },
+                        {
+                            name: 'Denylist -Skip These Fields',
+                            value: 'denylist',
+                            description: 'Scan everything except the fields listed below',
+                        },
+                    ],
+                    default: 'all',
+                    description: 'Control which JSON fields get scanned. Use allowlist to target specific fields, or denylist to skip fields like internal IDs.',
+                },
+                {
+                    displayName: 'Field Rules',
+                    name: 'fieldRules',
+                    type: 'fixedCollection',
+                    typeOptions: {
+                        multipleValues: true,
+                    },
+                    displayOptions: {
+                        show: {
+                            operation: ['redact'],
+                            fieldMode: ['allowlist', 'denylist'],
+                        },
+                    },
+                    default: {},
+                    options: [
+                        {
+                            name: 'rules',
+                            displayName: 'Rule',
+                            values: [
+                                {
+                                    displayName: 'Field Path',
+                                    name: 'field',
+                                    type: 'string',
+                                    default: '',
+                                    placeholder: 'e.g. user.email, contacts[*].phone, *.address',
+                                    description: 'JSON path to target. Supports dot notation and wildcards: "user.email", "*.phone", "items[*].name"',
+                                },
+                            ],
+                        },
+                    ],
+                },
+                // ═══════════════════════════════════════
+                // CONFIDENCE THRESHOLD
+                // ═══════════════════════════════════════
+                {
+                    displayName: 'Confidence Threshold',
+                    name: 'confidenceThreshold',
+                    type: 'number',
+                    displayOptions: {
+                        show: {
+                            operation: ['redact'],
+                        },
+                    },
+                    typeOptions: {
+                        minValue: 0,
+                        maxValue: 1,
+                        numberPrecision: 2,
+                    },
+                    default: 0,
+                    description: 'Only redact detections with confidence score above this threshold (0.0 to 1.0). Set to 0 to redact everything. Set to 0.7 to only redact high-confidence matches. Checksum-validated patterns score 0.95, regex-only patterns score 0.60-0.85.',
+                },
+                // ═══════════════════════════════════════
+                // ALLOW LIST (bypass specific values)
+                // ═══════════════════════════════════════
+                {
+                    displayName: 'Allow List (Never Redact)',
+                    name: 'allowList',
+                    type: 'fixedCollection',
+                    typeOptions: {
+                        multipleValues: true,
+                    },
+                    displayOptions: {
+                        show: {
+                            operation: ['redact'],
+                        },
+                    },
+                    default: {},
+                    options: [
+                        {
+                            name: 'entries',
+                            displayName: 'Entry',
+                            values: [
+                                {
+                                    displayName: 'Value',
+                                    name: 'value',
+                                    type: 'string',
+                                    default: '',
+                                    placeholder: 'e.g. @mycompany.com, +1-800-555-0100, support@acme.com',
+                                    description: 'Value to never redact, even if a pattern matches it',
+                                },
+                                {
+                                    displayName: 'Match Type',
+                                    name: 'type',
+                                    type: 'options',
+                                    options: [
+                                        { name: 'Exact Match', value: 'exact' },
+                                        { name: 'Contains', value: 'contains' },
+                                        { name: 'Regex', value: 'regex' },
+                                    ],
+                                    default: 'contains',
+                                    description: 'How to match the value',
+                                },
+                            ],
+                        },
+                    ],
+                    description: 'Values that should NEVER be redacted. Use this for company email domains, public phone numbers, or known-safe identifiers.',
+                },
+                // ═══════════════════════════════════════
+                // DENY LIST (always redact specific values)
+                // ═══════════════════════════════════════
+                {
+                    displayName: 'Deny List (Always Redact)',
+                    name: 'denyList',
+                    type: 'fixedCollection',
+                    typeOptions: {
+                        multipleValues: true,
+                    },
+                    displayOptions: {
+                        show: {
+                            operation: ['redact'],
+                        },
+                    },
+                    default: {},
+                    options: [
+                        {
+                            name: 'entries',
+                            displayName: 'Entry',
+                            values: [
+                                {
+                                    displayName: 'Value',
+                                    name: 'value',
+                                    type: 'string',
+                                    default: '',
+                                    placeholder: 'e.g. Project Falcon, INTERNAL-2024-SECRET',
+                                    description: 'Value to ALWAYS redact, even if no pattern matches it',
+                                },
+                                {
+                                    displayName: 'Match Type',
+                                    name: 'type',
+                                    type: 'options',
+                                    options: [
+                                        { name: 'Exact Match', value: 'exact' },
+                                        { name: 'Contains', value: 'contains' },
+                                        { name: 'Regex', value: 'regex' },
+                                    ],
+                                    default: 'exact',
+                                    description: 'How to match the value',
+                                },
+                            ],
+                        },
+                    ],
+                    description: 'Values that should ALWAYS be redacted, regardless of whether any pattern matches. Use for project codenames, internal secrets, or business-specific sensitive terms.',
+                },
+                // ═══════════════════════════════════════
+                // CUSTOM PATTERNS
+                // ═══════════════════════════════════════
+                {
+                    displayName: 'Custom Patterns',
+                    name: 'customPatterns',
+                    type: 'fixedCollection',
+                    typeOptions: {
+                        multipleValues: true,
+                    },
+                    displayOptions: {
+                        show: {
+                            operation: ['redact'],
+                        },
+                    },
+                    default: {},
+                    options: [
+                        {
+                            name: 'patterns',
+                            displayName: 'Pattern',
+                            values: [
+                                {
+                                    displayName: 'Label',
+                                    name: 'label',
+                                    type: 'string',
+                                    default: '',
+                                    placeholder: 'e.g. ORDER_ID, SKU, TICKET',
+                                    description: 'Label for the redacted placeholder',
+                                },
+                                {
+                                    displayName: 'Regex',
+                                    name: 'regex',
+                                    type: 'string',
+                                    default: '',
+                                    placeholder: 'e.g. ORD-\\d{6}, SKU-[A-Z0-9]{8}',
+                                    description: 'Regular expression to match this pattern',
+                                },
+                                {
+                                    displayName: 'Category',
+                                    name: 'category',
+                                    type: 'options',
+                                    options: [
+                                        { name: 'Identity', value: 'identity' },
+                                        { name: 'Financial', value: 'financial' },
+                                        { name: 'Contact', value: 'contact' },
+                                        { name: 'Network', value: 'network' },
+                                        { name: 'Location', value: 'location' },
+                                        { name: 'Medical', value: 'medical' },
+                                        { name: 'Other', value: 'other' },
+                                    ],
+                                    default: 'identity',
+                                    description: 'Category for audit reporting',
+                                },
+                            ],
+                        },
+                    ],
+                    description: 'Add your own regex patterns for business-specific identifiers (order IDs, SKUs, ticket numbers, etc.)',
+                },
+                // ═══════════════════════════════════════
+                // VAULT SETTINGS
+                // ═══════════════════════════════════════
+                {
+                    displayName: 'Vault Storage',
+                    name: 'vaultStorage',
+                    type: 'options',
+                    displayOptions: {
+                        show: {
+                            operation: ['redact', 'restore', 'stats', 'purge'],
+                        },
+                    },
+                    options: [
+                        {
+                            name: 'File-Based (Recommended, Persistent)',
+                            value: 'file',
+                        },
+                        {
+                            name: 'In-Memory (Fast, Lost on Restart)',
+                            value: 'memory',
+                        },
+                    ],
+                    default: 'file',
+                    description: 'File-based (recommended): Persists to disk, survives restarts, no memory bloat. Stored in ~/.n8n/pii-vault/. In-memory: Faster but lost on restart, capped at 1000 sessions to prevent memory bloat.',
+                },
+                {
+                    displayName: 'Vault Directory',
+                    name: 'vaultDir',
+                    type: 'string',
+                    displayOptions: {
+                        show: {
+                            operation: ['redact', 'restore', 'stats', 'purge'],
+                            vaultStorage: ['file'],
+                        },
+                    },
+                    default: '',
+                    placeholder: '/path/to/vault (default: ~/.n8n/pii-vault/)',
+                    description: 'Custom directory for file-based vault storage',
+                },
+                {
+                    displayName: 'Session TTL (minutes)',
+                    name: 'sessionTtl',
+                    type: 'number',
+                    displayOptions: {
+                        show: {
+                            operation: ['redact'],
+                        },
+                    },
+                    default: 60,
+                    description: 'Auto-expire vault sessions after this many minutes. Set to 0 for no expiry. Prevents vault from growing unbounded.',
+                },
+                // ═══════════════════════════════════════
+                // PURGE OPTIONS
+                // ═══════════════════════════════════════
+                {
+                    displayName: 'Purge Scope',
+                    name: 'purgeScope',
+                    type: 'options',
+                    displayOptions: {
+                        show: {
+                            operation: ['purge'],
+                        },
+                    },
+                    options: [
+                        {
+                            name: 'Purge All Sessions',
+                            value: 'all',
+                            description: 'Delete all vault sessions. GDPR right to erasure.',
+                        },
+                        {
+                            name: 'Purge Specific Session',
+                            value: 'specific',
+                            description: 'Delete a specific session by ID.',
+                        },
+                    ],
+                    default: 'all',
+                },
+                // ═══════════════════════════════════════
+                // RESTORE OPTIONS
+                // ═══════════════════════════════════════
+                {
+                    displayName: 'Delete Vault After Restore',
+                    name: 'deleteAfterRestore',
+                    type: 'boolean',
+                    displayOptions: {
+                        show: {
+                            operation: ['restore'],
+                        },
+                    },
+                    default: true,
+                    description: 'Delete the vault session after restoring. Disable for multi-step workflows that need multiple restores.',
+                },
+                // ═══════════════════════════════════════
+                // AUDIT REPORT
+                // ═══════════════════════════════════════
+                {
+                    displayName: 'Include Audit Report',
+                    name: 'includeReport',
+                    type: 'boolean',
+                    displayOptions: {
+                        show: {
+                            operation: ['redact', 'detect'],
+                        },
+                    },
+                    default: false,
+                    description: 'When enabled, adds a second output with an audit report listing all PII detected, categories, and counts. Useful for compliance logging.',
+                },
+            ],
+        };
+    }
+    async execute() {
+        const items = this.getInputData();
+        const operation = this.getNodeParameter('operation', 0);
+        // ─── DETECT / VERIFY (zero-config, scans everything) ──
+        if (operation === 'detect' || operation === 'verify') {
+            // Detect and Verify always scan ALL 216 patterns.
+            // No parameters needed. Simple, reliable, no "Could not get parameter".
+            const enabledPatterns = (0, patterns_1.getPatternOptions)().map((p) => p.value);
+            const customPatterns = [];
+            const tempVault = (0, vault_1.createVault)('memory');
+            const tempSessionId = `${operation}_${Date.now()}`;
+            tempVault.getOrCreateSession(tempSessionId, 60000);
+            const ctx = {
+                enabledPatterns,
+                customPatterns,
+                mode: 'token',
+                dedup: true,
+                fieldRules: [],
+                fieldMode: 'all',
+                // Verify mode: skip semantic field-name detection.
+                // Only check if actual PII VALUES leaked through (regex only).
+                skipSemantic: operation === 'verify',
+            };
+            const allHits = [];
+            for (let i = 0; i < items.length; i++) {
+                const hits = [];
+                (0, engine_1.redactValue)(items[i].json, ctx, tempVault, tempSessionId, hits, i);
+                allHits.push(...hits);
+            }
+            tempVault.deleteSession(tempSessionId);
+            if (operation === 'detect') {
+                // Always return original data + detection summary as last item
+                const returnData = items.map((item) => ({ json: item.json }));
+                const report = (0, engine_1.buildReport)(tempSessionId, allHits);
+                // Summary always appended so user sees results
+                const summary = {
+                    _redactorScan: true,
+                    status: allHits.length === 0 ? 'CLEAN' : 'PII_FOUND',
+                    totalPiiFound: allHits.length,
+                    itemsScanned: items.length,
+                    hitsByCategory: report.hitsByCategory,
+                    hitsByPattern: report.hitsByPattern,
+                    timestamp: report.timestamp,
+                };
+                let includeReport = false;
+                try {
+                    includeReport = this.getNodeParameter('includeReport', 0, false);
+                }
+                catch { }
+                if (includeReport) {
+                    // Full report on second output
+                    return [returnData, [{ json: { ...summary, hits: report.hits } }]];
+                }
+                // Append summary as last item in single output
+                returnData.push({ json: summary });
+                return [returnData];
+            }
+            // Verify
+            const passed = allHits.length === 0;
+            const verifyReport = (0, engine_1.buildReport)(tempSessionId, allHits);
+            return [[{
+                        json: {
+                            verified: passed,
+                            status: passed ? 'PASS' : 'FAIL',
+                            leaksFound: allHits.length,
+                            itemsScanned: items.length,
+                            message: passed
+                                ? 'No PII detected in values. Data appears properly redacted.'
+                                : `Found ${allHits.length} potential PII leak(s). Values contain detectable sensitive data.`,
+                            hitsByCategory: verifyReport.hitsByCategory,
+                            hitsByPattern: verifyReport.hitsByPattern,
+                            leaks: allHits.map((h) => ({
+                                field: h.field,
+                                patternLabel: h.patternLabel,
+                                category: h.category,
+                                itemIndex: h.itemIndex,
+                            })),
+                        },
+                    }]];
+        }
+        // All other operations (redact, restore, stats, purge) use vault
+        const vaultStorage = this.getNodeParameter('vaultStorage', 0, 'file');
+        const vaultDir = this.getNodeParameter('vaultDir', 0, '');
+        const vault = (0, vault_1.createVault)(vaultStorage, vaultDir || undefined);
+        // ─── STATS ───────────────────────────────
+        if (operation === 'stats') {
+            vault.cleanup();
+            const sessions = vault.listSessions();
+            const totalEntries = sessions.reduce((sum, s) => sum + s.entryCount, 0);
+            return [[
+                    {
+                        json: {
+                            totalSessions: sessions.length,
+                            totalEntries,
+                            vaultStorage: vaultStorage,
+                            timestamp: new Date().toISOString(),
+                            sessions: sessions.map((s) => ({
+                                sessionId: s.sessionId,
+                                entryCount: s.entryCount,
+                                createdAt: s.createdAt,
+                                ttl: s.ttl,
+                                ttlMinutes: s.ttl > 0 ? Math.round(s.ttl / 60000) : 'no expiry',
+                            })),
+                        },
+                    },
+                ]];
+        }
+        const sessionId = this.getNodeParameter('sessionId', 0);
+        if (!sessionId) {
+            throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'Session ID is required');
+        }
+        // ─── REDACT ──────────────────────────────
+        if (operation === 'redact') {
+            const mode = this.getNodeParameter('redactionMode', 0, 'token');
+            const detectionScope = this.getNodeParameter('detectionScope', 0, 'recommended');
+            let enabledPatterns;
+            if (detectionScope === 'all') {
+                enabledPatterns = (0, patterns_1.getPatternOptions)().map((p) => p.value);
+            }
+            else if (detectionScope === 'recommended') {
+                enabledPatterns = RECOMMENDED_PATTERNS;
+            }
+            else {
+                enabledPatterns = this.getNodeParameter('piiTypes', 0);
+            }
+            const dedup = this.getNodeParameter('dedup', 0, true);
+            const fieldMode = this.getNodeParameter('fieldMode', 0, 'all');
+            const sessionTtl = this.getNodeParameter('sessionTtl', 0, 60);
+            const includeReport = this.getNodeParameter('includeReport', 0, false);
+            const customPatternsRaw = this.getNodeParameter('customPatterns', 0, {});
+            const customPatterns = customPatternsRaw.patterns ?? [];
+            const fieldRulesRaw = this.getNodeParameter('fieldRules', 0, {});
+            const fieldRules = (fieldRulesRaw.rules ?? []).map((r) => ({
+                field: r.field,
+                mode: fieldMode === 'allowlist' ? 'include' : 'exclude',
+            }));
+            // Parse allow list
+            const allowListRaw = this.getNodeParameter('allowList', 0, {});
+            const allowList = (allowListRaw.entries ?? []).map((e) => ({
+                value: e.value,
+                type: (e.type || 'contains'),
+            }));
+            // Parse deny list
+            const denyListRaw = this.getNodeParameter('denyList', 0, {});
+            const denyList = (denyListRaw.entries ?? []).map((e) => ({
+                value: e.value,
+                type: (e.type || 'exact'),
+            }));
+            // Confidence threshold
+            const confidenceThreshold = this.getNodeParameter('confidenceThreshold', 0, 0);
+            // Initialize vault session
+            vault.getOrCreateSession(sessionId, sessionTtl * 60 * 1000);
+            const ctx = {
+                enabledPatterns,
+                customPatterns,
+                mode,
+                dedup,
+                fieldRules,
+                fieldMode,
+                allowList,
+                denyList,
+                confidenceThreshold,
+            };
+            const allHits = [];
+            const returnData = [];
+            for (let i = 0; i < items.length; i++) {
+                const item = items[i];
+                const hits = [];
+                const redacted = (0, engine_1.redactValue)(item.json, ctx, vault, sessionId, hits, i);
+                returnData.push({ json: redacted });
+                allHits.push(...hits);
+            }
+            // Persist vault
+            vault.save(sessionId);
+            if (includeReport) {
+                const report = (0, engine_1.buildReport)(sessionId, allHits);
+                return [returnData, [{ json: report }]];
+            }
+            return [returnData];
+        }
+        // ─── RESTORE ─────────────────────────────
+        if (operation === 'restore') {
+            const deleteAfterRestore = this.getNodeParameter('deleteAfterRestore', 0, true);
+            let session = vault.getSession(sessionId);
+            let actualSessionId = sessionId;
+            // Safe fallback: if exact session not found and there is EXACTLY ONE
+            // session in the vault, use it. This handles step-by-step testing in
+            // n8n where each "Execute step" creates a new execution ID.
+            // We ONLY fall back when there is no ambiguity (1 session).
+            // With multiple sessions, we refuse to guess to prevent cross-user leakage.
+            if (!session) {
+                const allSessions = vault.listSessions();
+                if (allSessions.length === 1) {
+                    actualSessionId = allSessions[0].sessionId;
+                    session = vault.getSession(actualSessionId);
+                }
+            }
+            if (!session) {
+                throw new n8n_workflow_1.NodeOperationError(this.getNode(), `No vault found for session "${sessionId}". Ensure a Redact node ran first with the same Session ID and vault storage type.`);
+            }
+            const returnData = [];
+            for (let i = 0; i < items.length; i++) {
+                const item = items[i];
+                const restored = (0, engine_1.restoreValue)(item.json, vault, actualSessionId);
+                returnData.push({ json: restored });
+            }
+            if (deleteAfterRestore) {
+                vault.deleteSession(actualSessionId);
+            }
+            return [returnData];
+        }
+        // ─── PURGE (delete vault sessions) ──
+        if (operation === 'purge') {
+            const purgeScope = this.getNodeParameter('purgeScope', 0, 'all');
+            if (purgeScope === 'specific') {
+                const purgeSessionId = this.getNodeParameter('purgeSessionId', 0, '');
+                if (!purgeSessionId) {
+                    throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'Session ID is required for purging a specific session.');
+                }
+                const session = vault.getSession(purgeSessionId);
+                if (session) {
+                    const entryCount = Object.keys(session.entries).length;
+                    vault.deleteSession(purgeSessionId);
+                    return [[{
+                                json: {
+                                    purged: true,
+                                    sessionId: purgeSessionId,
+                                    entriesDeleted: entryCount,
+                                    message: `Session purged successfully.`,
+                                },
+                            }]];
+                }
+                else {
+                    return [[{
+                                json: {
+                                    purged: false,
+                                    sessionId: purgeSessionId,
+                                    message: `No session found with this ID.`,
+                                },
+                            }]];
+                }
+            }
+            else {
+                // Purge ALL sessions
+                const sessions = vault.listSessions();
+                let totalEntries = 0;
+                for (const s of sessions) {
+                    totalEntries += s.entryCount;
+                    vault.deleteSession(s.sessionId);
+                }
+                return [[{
+                            json: {
+                                purged: true,
+                                sessionsPurged: sessions.length,
+                                totalEntriesDeleted: totalEntries,
+                                message: `All ${sessions.length} session(s) purged successfully.`,
+                            },
+                        }]];
+            }
+        }
+        return [[]];
+    }
+}
+exports.PiiRedactor = PiiRedactor;