Extract Card Numbers

import { extractCardNumber } from "@persian-tools/persian-tools";

const text = "Cards: 6037701689095443 and 6219-8610-3452-9007";
const cards = extractCardNumber(text, {
	checkValidation: true,
	detectBankNumber: true,
});

// [
//   { index: 1, base: "6037701689095443", pure: "6037701689095443",
//     startIndex: 7, endIndex: 23, isValid: true, bankName: "بانک کشاورزی" },
//   { index: 2, base: "6219-8610-3452-9007", pure: "6219861034529007",
//     startIndex: 28, endIndex: 47, isValid: true, bankName: "بانک سامان" },
// ]

{
	index: number; // 1-based ordinal in this run
	base: string; // raw matched text (may contain separators)
	pure: string; // normalized digits-only form
	startIndex: number; // byte offset in source
	endIndex: number;
}

extractCardNumber("کارت: ۶۰۳۷۷۰۱۶۸۹۰۹۵۴۴۳"); // pure: "6037701689095443"
extractCardNumber("6037_7016_8909_5443"); // pure: "6037701689095443"

extractCardNumber("My card: 6037-****-8909-5443", {
	enableFuzzyMatching: true,
	checkValidation: false,
});

extractCardNumber(hugeDocument, {
	optimizeForLargeText: true,
	maxResults: 10,
});

extractCardNumber(text, { includeContext: true, contextLength: 20 });
// each match: { ..., context: { before, after } }

extractCardNumber(s, { checkValidation: true, detectBankNumber: true });
// → ExtractCardNumberComplete[]   (isValid + bankName)

extractCardNumber(s, { checkValidation: true, detectBankNumber: false });
// → ExtractCardNumberWithValidation[]

extractCardNumber(s);
// → ExtractCardNumber[]   (base shape)

import {
	cleanCardNumber,
	extractContext,
	splitTextIntoChunks,
	quickCardNumberCheck,
	getOptimalChunkConfig,
	shouldUseFuzzyMatching,
	isValidCardNumberFormat,
	sortCardNumbersByPosition,
	removeDuplicateCardNumbers,
	cardNumberRegex,
	fuzzyCardNumberRegex,
	defaultFuzzyConfig,
	performanceThresholds,
} from "@persian-tools/persian-tools";