@elanlanguages/bridge-anonymization 0.1.0

package/dist/pipeline/validator.js

@@ -0,0 +1,264 @@
+/**
+ * Output Validator
+ * Validates anonymized output and performs leak scan
+ */
+import { PIIType } from '../types/index.js';
+import { spansOverlap } from '../utils/offsets.js';
+import { extractTags, isValidTag } from './tagger.js';
+/**
+ * Validation error codes
+ */
+export var ValidationErrorCode;
+(function (ValidationErrorCode) {
+    ValidationErrorCode["OVERLAPPING_ENTITIES"] = "OVERLAPPING_ENTITIES";
+    ValidationErrorCode["DUPLICATE_IDS"] = "DUPLICATE_IDS";
+    ValidationErrorCode["MALFORMED_TAG"] = "MALFORMED_TAG";
+    ValidationErrorCode["ID_MISMATCH"] = "ID_MISMATCH";
+    ValidationErrorCode["MISSING_IN_MAP"] = "MISSING_IN_MAP";
+    ValidationErrorCode["POTENTIAL_PII_LEAK"] = "POTENTIAL_PII_LEAK";
+})(ValidationErrorCode || (ValidationErrorCode = {}));
+/**
+ * Leak scan patterns for common structured PII
+ * These are simplified patterns for quick scanning
+ */
+const LEAK_SCAN_PATTERNS = [
+    {
+        type: PIIType.EMAIL,
+        pattern: /[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}/g,
+        name: 'Email',
+    },
+    {
+        type: PIIType.PHONE,
+        pattern: /(?:\+|00)[1-9][0-9]{7,14}|0[1-9][0-9]{6,11}/g,
+        name: 'Phone',
+    },
+    {
+        type: PIIType.IBAN,
+        pattern: /[A-Z]{2}[0-9]{2}[A-Z0-9]{11,30}/gi,
+        name: 'IBAN',
+    },
+    {
+        type: PIIType.CREDIT_CARD,
+        pattern: /[0-9]{4}[\s-]?[0-9]{4}[\s-]?[0-9]{4}[\s-]?[0-9]{4}/g,
+        name: 'Credit Card',
+    },
+    {
+        type: PIIType.IP_ADDRESS,
+        pattern: /(?:\d{1,3}\.){3}\d{1,3}/g,
+        name: 'IP Address',
+    },
+];
+/**
+ * Validates anonymization output
+ */
+export function validateOutput(anonymizedText, entities, piiMapKeys, policy) {
+    const errors = [];
+    // Validate no overlapping entities
+    const overlapErrors = checkOverlappingEntities(entities);
+    errors.push(...overlapErrors);
+    // Validate unique IDs (per type or globally)
+    const idErrors = checkUniqueIds(entities);
+    errors.push(...idErrors);
+    // Validate tags in text are well-formed
+    const tagErrors = checkTags(anonymizedText);
+    errors.push(...tagErrors);
+    // Validate tag count matches entity count
+    const countErrors = checkTagEntityMatch(anonymizedText, entities);
+    errors.push(...countErrors);
+    // Validate all entities have entries in PII map
+    const mapErrors = checkPIIMapCompleteness(entities, piiMapKeys);
+    errors.push(...mapErrors);
+    // Perform leak scan if enabled
+    let leakScanPassed;
+    let potentialLeaks;
+    if (policy.enableLeakScan) {
+        const leakResult = performLeakScan(anonymizedText, policy);
+        potentialLeaks = leakResult.matches;
+        leakScanPassed = potentialLeaks.length === 0;
+        if (!leakScanPassed) {
+            errors.push({
+                code: ValidationErrorCode.POTENTIAL_PII_LEAK,
+                message: `Leak scan found ${potentialLeaks.length} potential PII leak(s)`,
+                details: { leaks: potentialLeaks },
+            });
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        leakScanPassed,
+        potentialLeaks,
+    };
+}
+/**
+ * Checks for overlapping entities
+ */
+function checkOverlappingEntities(entities) {
+    const errors = [];
+    for (let i = 0; i < entities.length; i++) {
+        for (let j = i + 1; j < entities.length; j++) {
+            const a = entities[i];
+            const b = entities[j];
+            if (spansOverlap(a, b)) {
+                errors.push({
+                    code: ValidationErrorCode.OVERLAPPING_ENTITIES,
+                    message: `Entities ${a.id} (${a.type}) and ${b.id} (${b.type}) overlap`,
+                    details: {
+                        entity1: { id: a.id, type: a.type, start: a.start, end: a.end },
+                        entity2: { id: b.id, type: b.type, start: b.start, end: b.end },
+                    },
+                });
+            }
+        }
+    }
+    return errors;
+}
+/**
+ * Checks for duplicate IDs
+ */
+function checkUniqueIds(entities) {
+    const errors = [];
+    const seenIds = new Map();
+    for (const entity of entities) {
+        const existing = seenIds.get(entity.id);
+        if (existing !== undefined) {
+            // Duplicate ID - only an error if they have different original text
+            // (reuse of IDs for same text is allowed with policy.reuseIdsForRepeatedPII)
+            if (existing.original !== entity.original) {
+                errors.push({
+                    code: ValidationErrorCode.DUPLICATE_IDS,
+                    message: `Duplicate ID ${entity.id} used for different text values`,
+                    details: {
+                        id: entity.id,
+                        first: { type: existing.type, text: existing.original },
+                        second: { type: entity.type, text: entity.original },
+                    },
+                });
+            }
+        }
+        else {
+            seenIds.set(entity.id, entity);
+        }
+    }
+    return errors;
+}
+/**
+ * Checks that all tags in text are well-formed
+ */
+function checkTags(anonymizedText) {
+    const errors = [];
+    // Find anything that looks like a PII tag
+    const tagLikePattern = /<PII[^>]*>/g;
+    let match;
+    while ((match = tagLikePattern.exec(anonymizedText)) !== null) {
+        // Check if it ends with /> for self-closing
+        const fullTag = match[0].endsWith('/>') ? match[0] : match[0] + '/>';
+        if (!isValidTag(fullTag) && !match[0].endsWith('/>')) {
+            errors.push({
+                code: ValidationErrorCode.MALFORMED_TAG,
+                message: `Malformed PII tag at position ${match.index}`,
+                details: { tag: match[0], position: match.index },
+            });
+        }
+    }
+    return errors;
+}
+/**
+ * Checks that tag count matches entity count
+ */
+function checkTagEntityMatch(anonymizedText, entities) {
+    const errors = [];
+    const tags = extractTags(anonymizedText);
+    // Get unique entity IDs
+    const entityIds = new Set(entities.map((e) => e.id));
+    const tagIds = new Set(tags.map((t) => t.id));
+    // Check for mismatches
+    for (const id of entityIds) {
+        if (!tagIds.has(id)) {
+            errors.push({
+                code: ValidationErrorCode.ID_MISMATCH,
+                message: `Entity ID ${id} not found in anonymized text`,
+                details: { missingId: id },
+            });
+        }
+    }
+    return errors;
+}
+/**
+ * Checks that all entities have entries in PII map
+ */
+function checkPIIMapCompleteness(entities, piiMapKeys) {
+    const errors = [];
+    const keySet = new Set(piiMapKeys);
+    for (const entity of entities) {
+        const expectedKey = `${entity.type}_${entity.id}`;
+        if (!keySet.has(expectedKey)) {
+            errors.push({
+                code: ValidationErrorCode.MISSING_IN_MAP,
+                message: `Entity ${entity.id} (${entity.type}) missing from PII map`,
+                details: { entityId: entity.id, entityType: entity.type, expectedKey },
+            });
+        }
+    }
+    return errors;
+}
+/**
+ * Performs leak scan on anonymized text
+ */
+function performLeakScan(anonymizedText, policy) {
+    const matches = [];
+    // Skip scanning inside PII tags
+    const textWithoutTags = anonymizedText.replace(/<PII[^>]*\/>/g, ' '.repeat(20));
+    for (const { type, pattern, name } of LEAK_SCAN_PATTERNS) {
+        // Skip if type not enabled in policy
+        if (!policy.enabledTypes.has(type)) {
+            continue;
+        }
+        const globalPattern = new RegExp(pattern.source, 'g');
+        let match;
+        while ((match = globalPattern.exec(textWithoutTags)) !== null) {
+            // Double-check this isn't inside a tag
+            const position = match.index;
+            const isInTag = isPositionInsideTag(anonymizedText, position);
+            if (!isInTag) {
+                matches.push({
+                    type,
+                    text: match[0],
+                    position,
+                    pattern: name,
+                });
+            }
+        }
+    }
+    return { matches };
+}
+/**
+ * Checks if a position is inside a PII tag
+ */
+function isPositionInsideTag(text, position) {
+    // Find the nearest < before position
+    const before = text.lastIndexOf('<', position);
+    if (before === -1)
+        return false;
+    // Find the nearest > after the <
+    const after = text.indexOf('>', before);
+    if (after === -1)
+        return false;
+    // Position is inside tag if it's between < and >
+    return position > before && position < after;
+}
+/**
+ * Validates that no overlaps exist (fast check)
+ */
+export function hasNoOverlaps(entities) {
+    if (entities.length <= 1)
+        return true;
+    const sorted = [...entities].sort((a, b) => a.start - b.start);
+    for (let i = 0; i < sorted.length - 1; i++) {
+        if (sorted[i].end > sorted[i + 1].start) {
+            return false;
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=validator.js.map

package/dist/pipeline/validator.js.map

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

package/dist/recognizers/base.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Base Recognizer Interface
+ * Defines the contract for all PII recognizers (regex-based)
+ */
+import { PIIType, SpanMatch } from '../types/index.js';
+/**
+ * Base interface for all PII recognizers
+ */
+export interface Recognizer {
+    /** The PII type this recognizer detects */
+    readonly type: PIIType;
+    /** Human-readable name for logging/debugging */
+    readonly name: string;
+    /** Default confidence score for matches (0.0 to 1.0) */
+    readonly defaultConfidence: number;
+    /**
+     * Finds all matches of this PII type in the given text
+     * @param text - The text to search
+     * @returns Array of span matches
+     */
+    find(text: string): SpanMatch[];
+    /**
+     * Optional validation of a match (e.g., checksum validation)
+     * @param match - The matched text
+     * @returns true if the match is valid
+     */
+    validate?(match: string): boolean;
+    /**
+     * Optional normalization of a match for storage
+     * @param match - The matched text
+     * @returns Normalized version of the match
+     */
+    normalize?(match: string): string;
+}
+/**
+ * Base class for regex-based recognizers
+ */
+export declare abstract class RegexRecognizer implements Recognizer {
+    abstract readonly type: PIIType;
+    abstract readonly name: string;
+    readonly defaultConfidence: number;
+    /** Compiled regex pattern(s) for matching */
+    protected abstract readonly patterns: RegExp[];
+    /**
+     * Finds all matches using the configured patterns
+     */
+    find(text: string): SpanMatch[];
+    /**
+     * Removes duplicate matches (same span matched by multiple patterns)
+     */
+    protected deduplicateMatches(matches: SpanMatch[]): SpanMatch[];
+    /**
+     * Default validation (always passes)
+     * Override in subclasses for checksum validation etc.
+     */
+    validate?(match: string): boolean;
+    /**
+     * Default normalization (returns as-is)
+     * Override in subclasses for specific normalization
+     */
+    normalize?(match: string): string;
+}
+/**
+ * Configuration for a regex recognizer created from patterns
+ */
+export interface RegexRecognizerConfig {
+    type: PIIType;
+    name: string;
+    patterns: RegExp[];
+    defaultConfidence?: number;
+    validate?: (match: string) => boolean;
+    normalize?: (match: string) => string;
+}
+/**
+ * Creates a simple regex recognizer from configuration
+ */
+export declare function createRegexRecognizer(config: RegexRecognizerConfig): Recognizer;
+//# sourceMappingURL=base.d.ts.map

package/dist/recognizers/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/recognizers/base.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,SAAS,EAAmB,MAAM,mBAAmB,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAEvB,gDAAgD;IAChD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,wDAAwD;IACxD,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IAEnC;;;;OAIG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,CAAC;IAEhC;;;;OAIG;IACH,QAAQ,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAElC;;;;OAIG;IACH,SAAS,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;CACnC;AAED;;GAEG;AACH,8BAAsB,eAAgB,YAAW,UAAU;IACzD,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAQ;IAE1C,6CAA6C;IAC7C,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;IAE/C;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE;IAiC/B;;OAEG;IACH,SAAS,CAAC,kBAAkB,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE;IAe/D;;;OAGG;IACH,QAAQ,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAEjC;;;OAGG;IACH,SAAS,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IACtC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;CACvC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG,UAAU,CA8C/E"}

package/dist/recognizers/base.js

@@ -0,0 +1,100 @@
+/**
+ * Base Recognizer Interface
+ * Defines the contract for all PII recognizers (regex-based)
+ */
+import { DetectionSource } from '../types/index.js';
+/**
+ * Base class for regex-based recognizers
+ */
+export class RegexRecognizer {
+    defaultConfidence = 0.95;
+    /**
+     * Finds all matches using the configured patterns
+     */
+    find(text) {
+        const matches = [];
+        for (const pattern of this.patterns) {
+            // Ensure pattern has global flag for matchAll
+            const globalPattern = pattern.global
+                ? pattern
+                : new RegExp(pattern.source, pattern.flags + 'g');
+            for (const match of text.matchAll(globalPattern)) {
+                if (match.index === undefined)
+                    continue;
+                const matchText = match[0];
+                // Skip if validation fails
+                if (this.validate !== undefined && !this.validate(matchText)) {
+                    continue;
+                }
+                matches.push({
+                    type: this.type,
+                    start: match.index,
+                    end: match.index + matchText.length,
+                    confidence: this.defaultConfidence,
+                    source: DetectionSource.REGEX,
+                    text: matchText,
+                });
+            }
+        }
+        return this.deduplicateMatches(matches);
+    }
+    /**
+     * Removes duplicate matches (same span matched by multiple patterns)
+     */
+    deduplicateMatches(matches) {
+        const seen = new Set();
+        const unique = [];
+        for (const match of matches) {
+            const key = `${match.start}:${match.end}`;
+            if (!seen.has(key)) {
+                seen.add(key);
+                unique.push(match);
+            }
+        }
+        return unique;
+    }
+}
+/**
+ * Creates a simple regex recognizer from configuration
+ */
+export function createRegexRecognizer(config) {
+    return {
+        type: config.type,
+        name: config.name,
+        defaultConfidence: config.defaultConfidence ?? 0.95,
+        find(text) {
+            const matches = [];
+            const seen = new Set();
+            for (const pattern of config.patterns) {
+                const globalPattern = pattern.global
+                    ? pattern
+                    : new RegExp(pattern.source, pattern.flags + 'g');
+                for (const match of text.matchAll(globalPattern)) {
+                    if (match.index === undefined)
+                        continue;
+                    const matchText = match[0];
+                    const key = `${match.index}:${match.index + matchText.length}`;
+                    if (seen.has(key))
+                        continue;
+                    // Skip if validation fails
+                    if (config.validate !== undefined && !config.validate(matchText)) {
+                        continue;
+                    }
+                    seen.add(key);
+                    matches.push({
+                        type: config.type,
+                        start: match.index,
+                        end: match.index + matchText.length,
+                        confidence: config.defaultConfidence ?? 0.95,
+                        source: DetectionSource.REGEX,
+                        text: matchText,
+                    });
+                }
+            }
+            return matches;
+        },
+        validate: config.validate,
+        normalize: config.normalize,
+    };
+}
+//# sourceMappingURL=base.js.map

package/dist/recognizers/base.js.map

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

package/dist/recognizers/bic-swift.d.ts

@@ -0,0 +1,10 @@
+/**
+ * BIC/SWIFT Code Recognizer
+ * Bank Identifier Code (ISO 9362)
+ */
+import type { Recognizer } from './base.js';
+/**
+ * BIC/SWIFT code recognizer
+ */
+export declare const bicSwiftRecognizer: Recognizer;
+//# sourceMappingURL=bic-swift.d.ts.map

package/dist/recognizers/bic-swift.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bic-swift.d.ts","sourceRoot":"","sources":["../../src/recognizers/bic-swift.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AA2C5C;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,UAsEhC,CAAC"}

package/dist/recognizers/bic-swift.js

@@ -0,0 +1,107 @@
+/**
+ * BIC/SWIFT Code Recognizer
+ * Bank Identifier Code (ISO 9362)
+ */
+import { PIIType, DetectionSource } from '../types/index.js';
+/**
+ * BIC/SWIFT code pattern
+ * Format: AAAA BB CC DDD (8 or 11 characters)
+ * - AAAA: Bank code (4 letters)
+ * - BB: Country code (2 letters, ISO 3166-1)
+ * - CC: Location code (2 alphanumeric)
+ * - DDD: Branch code (3 alphanumeric, optional)
+ */
+const BIC_PATTERN = /\b[A-Z]{4}[A-Z]{2}[A-Z0-9]{2}(?:[A-Z0-9]{3})?\b/g;
+/**
+ * Valid ISO 3166-1 alpha-2 country codes (common subset)
+ */
+const VALID_COUNTRY_CODES = new Set([
+    'AD', 'AE', 'AF', 'AG', 'AI', 'AL', 'AM', 'AO', 'AR', 'AS', 'AT', 'AU', 'AW', 'AZ',
+    'BA', 'BB', 'BD', 'BE', 'BF', 'BG', 'BH', 'BI', 'BJ', 'BM', 'BN', 'BO', 'BR', 'BS', 'BT', 'BW', 'BY', 'BZ',
+    'CA', 'CD', 'CF', 'CG', 'CH', 'CI', 'CK', 'CL', 'CM', 'CN', 'CO', 'CR', 'CU', 'CV', 'CY', 'CZ',
+    'DE', 'DJ', 'DK', 'DM', 'DO', 'DZ',
+    'EC', 'EE', 'EG', 'ER', 'ES', 'ET',
+    'FI', 'FJ', 'FK', 'FM', 'FO', 'FR',
+    'GA', 'GB', 'GD', 'GE', 'GF', 'GH', 'GI', 'GL', 'GM', 'GN', 'GP', 'GQ', 'GR', 'GT', 'GU', 'GW', 'GY',
+    'HK', 'HN', 'HR', 'HT', 'HU',
+    'ID', 'IE', 'IL', 'IN', 'IQ', 'IR', 'IS', 'IT',
+    'JM', 'JO', 'JP',
+    'KE', 'KG', 'KH', 'KI', 'KM', 'KN', 'KP', 'KR', 'KW', 'KY', 'KZ',
+    'LA', 'LB', 'LC', 'LI', 'LK', 'LR', 'LS', 'LT', 'LU', 'LV', 'LY',
+    'MA', 'MC', 'MD', 'ME', 'MG', 'MH', 'MK', 'ML', 'MM', 'MN', 'MO', 'MP', 'MQ', 'MR', 'MS', 'MT', 'MU', 'MV', 'MW', 'MX', 'MY', 'MZ',
+    'NA', 'NC', 'NE', 'NF', 'NG', 'NI', 'NL', 'NO', 'NP', 'NR', 'NU', 'NZ',
+    'OM',
+    'PA', 'PE', 'PF', 'PG', 'PH', 'PK', 'PL', 'PM', 'PN', 'PR', 'PS', 'PT', 'PW', 'PY',
+    'QA',
+    'RE', 'RO', 'RS', 'RU', 'RW',
+    'SA', 'SB', 'SC', 'SD', 'SE', 'SG', 'SH', 'SI', 'SK', 'SL', 'SM', 'SN', 'SO', 'SR', 'SS', 'ST', 'SV', 'SY', 'SZ',
+    'TC', 'TD', 'TF', 'TG', 'TH', 'TJ', 'TK', 'TL', 'TM', 'TN', 'TO', 'TR', 'TT', 'TV', 'TW', 'TZ',
+    'UA', 'UG', 'US', 'UY', 'UZ',
+    'VA', 'VC', 'VE', 'VG', 'VI', 'VN', 'VU',
+    'WF', 'WS',
+    'YE', 'YT',
+    'ZA', 'ZM', 'ZW',
+]);
+/**
+ * BIC/SWIFT code recognizer
+ */
+export const bicSwiftRecognizer = {
+    type: PIIType.BIC_SWIFT,
+    name: 'BIC/SWIFT Code',
+    defaultConfidence: 0.95,
+    find(text) {
+        const matches = [];
+        const pattern = new RegExp(BIC_PATTERN.source, 'g');
+        for (const match of text.matchAll(pattern)) {
+            if (match.index === undefined)
+                continue;
+            const bic = match[0];
+            // Validate the BIC code
+            if (!this.validate(bic))
+                continue;
+            matches.push({
+                type: PIIType.BIC_SWIFT,
+                start: match.index,
+                end: match.index + bic.length,
+                confidence: this.defaultConfidence,
+                source: DetectionSource.REGEX,
+                text: bic,
+            });
+        }
+        return matches;
+    },
+    validate(bic) {
+        const normalized = bic.toUpperCase();
+        // Check length (8 or 11 characters)
+        if (normalized.length !== 8 && normalized.length !== 11) {
+            return false;
+        }
+        // Extract and validate country code (characters 5-6)
+        const countryCode = normalized.slice(4, 6);
+        if (!VALID_COUNTRY_CODES.has(countryCode)) {
+            return false;
+        }
+        // Bank code should be letters only
+        const bankCode = normalized.slice(0, 4);
+        if (!/^[A-Z]{4}$/.test(bankCode)) {
+            return false;
+        }
+        // Location code should be alphanumeric
+        const locationCode = normalized.slice(6, 8);
+        if (!/^[A-Z0-9]{2}$/.test(locationCode)) {
+            return false;
+        }
+        // Branch code (if present) should be alphanumeric
+        if (normalized.length === 11) {
+            const branchCode = normalized.slice(8, 11);
+            if (!/^[A-Z0-9]{3}$/.test(branchCode)) {
+                return false;
+            }
+        }
+        return true;
+    },
+    normalize(bic) {
+        return bic.toUpperCase().trim();
+    },
+};
+//# sourceMappingURL=bic-swift.js.map

package/dist/recognizers/bic-swift.js.map

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

package/dist/recognizers/credit-card.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Credit Card Number Recognizer
+ * Detects major card types with Luhn checksum validation
+ */
+import type { Recognizer } from './base.js';
+/**
+ * Credit card patterns for major card types
+ * All patterns allow optional separators (spaces, dashes)
+ */
+declare const CARD_PATTERNS: {
+    visa: RegExp;
+    mastercard: RegExp;
+    amex: RegExp;
+    discover: RegExp;
+    diners: RegExp;
+    jcb: RegExp;
+    generic: RegExp;
+};
+/**
+ * Card type names for identification
+ */
+type CardType = keyof typeof CARD_PATTERNS;
+/**
+ * Credit card recognizer with Luhn validation
+ */
+export declare const creditCardRecognizer: Recognizer;
+/**
+ * Identifies the card type from a card number
+ */
+export declare function identifyCardType(cardNumber: string): CardType | 'unknown';
+export {};
+//# sourceMappingURL=credit-card.d.ts.map

package/dist/recognizers/credit-card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credit-card.d.ts","sourceRoot":"","sources":["../../src/recognizers/credit-card.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAG5C;;;GAGG;AACH,QAAA,MAAM,aAAa;;;;;;;;CAuBlB,CAAC;AAEF;;GAEG;AACH,KAAK,QAAQ,GAAG,MAAM,OAAO,aAAa,CAAC;AAE3C;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,UAuElC,CAAC;AA6DF;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAWzE"}