@budiauktioner/buildi-primitives 0.1.1 → 0.2.0

package/dist/esm/banking/swedish-bankgiro-number.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/banking/swedish-bankgiro-number.ts"],
+  "sourcesContent": ["import { PrimitiveTypeInfo } from \"../primitive-type-info.js\";\nimport { keepDigits, sanitizeInput } from \"../internal/input-sanitization.js\";\nimport { luhnIsValid } from \"../internal/luhn.js\";\nimport { TextCandidateCategory } from \"../text-scanning/text-candidate-category.js\";\nimport { TextCandidate } from \"../text-scanning/text-candidate.js\";\nimport { TextMatchConfidence } from \"../text-scanning/text-match-confidence.js\";\nimport { ValidationResult, validResult, invalidResult } from \"../validation/validation-result.js\";\nimport { ValidationErrorReason } from \"../validation/validation-error-reason.js\";\n\nconst MAX_INPUT_LENGTH = 20;\nconst DIGITS_7_OR_8 = /^\\d{7,8}$/;\n\n/**\n * A Swedish Bankgiro number (`bankgironummer`), e.g. `5805-6201`.\n * 7 or 8 digits with Luhn check digit.\n */\nexport class SwedishBankgiroNumber {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Bankgiro Number\",\n    localizedName: \"Bankgironummer\",\n    emoji: \"\\u{1F4B3}\",\n    sources: Object.freeze([\n      \"https://www.bankgirot.se/en/services/incoming-payments/bankgiro-number/\",\n      \"https://sv.wikipedia.org/wiki/Bankgirot\",\n    ]),\n  });\n\n  static readonly displayName = \"Bankgiro\";\n  static readonly displayNameShort = \"BG\";\n\n  /** Digit-only value, e.g. `58056201`. */\n  readonly digits: string;\n  /** Hyphenated display form, e.g. `5805-6201`. */\n  readonly formatted: string;\n\n  private constructor(digits: string, formatted: string) {\n    this.digits = digits;\n    this.formatted = formatted;\n  }\n\n  static tryParse(input: string | null | undefined): SwedishBankgiroNumber | null {\n    if (input == null || input.trim() === \"\") return null;\n    const digits = keepDigits(sanitizeInput(input));\n    if (digits.length > MAX_INPUT_LENGTH) return null;\n    if (!DIGITS_7_OR_8.test(digits)) return null;\n    if (!luhnIsValid(digits)) return null;\n\n    const formatted =\n      digits.length === 7\n        ? `${digits.slice(0, 3)}-${digits.slice(3)}`\n        : `${digits.slice(0, 4)}-${digits.slice(4)}`;\n    return new SwedishBankgiroNumber(digits, formatted);\n  }\n\n  static parse(input: string): SwedishBankgiroNumber {\n    const r = SwedishBankgiroNumber.tryParse(input);\n    if (r === null) throw new Error(\"Invalid Bankgiro number.\");\n    return r;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return SwedishBankgiroNumber.tryParse(input) !== null;\n  }\n\n  static format(\n    input: string | null | undefined,\n    options?: { fallbackToTrimmedInputWhenInvalid?: boolean },\n  ): string | null {\n    const r = SwedishBankgiroNumber.tryParse(input);\n    if (r) return r.formatted;\n    if (options?.fallbackToTrimmedInputWhenInvalid && input != null && input.trim() !== \"\") {\n      return input.trim();\n    }\n    return null;\n  }\n\n  static normalize(\n    input: string | null | undefined,\n    options?: { fallbackToTrimmedInputWhenInvalid?: boolean },\n  ): string | null {\n    return SwedishBankgiroNumber.format(input, options);\n  }\n\n  static isNormalized(input: string | null | undefined): boolean {\n    return input != null && SwedishBankgiroNumber.normalize(input) === input;\n  }\n\n  toNormalizedString(): string {\n    return this.formatted;\n  }\n\n  toDisplayString(): string {\n    return `${SwedishBankgiroNumber.displayName} ${this.formatted}`;\n  }\n\n  toShortDisplayString(): string {\n    return `${SwedishBankgiroNumber.displayNameShort} ${this.formatted}`;\n  }\n\n  toString(): string {\n    return this.formatted;\n  }\n\n  static validate(input: string | null | undefined): ValidationResult {\n    if (input == null || input.trim() === \"\")\n      return invalidResult(\n        input,\n        ValidationErrorReason.InputIsEmpty,\n        \"Input is empty or whitespace.\",\n        \"V\u00E4rdet \u00E4r tomt.\",\n      );\n\n    const digits = keepDigits(sanitizeInput(input));\n\n    if (digits.length > MAX_INPUT_LENGTH)\n      return invalidResult(\n        input,\n        ValidationErrorReason.InputTooLong,\n        \"Input contains too many characters.\",\n        \"V\u00E4rdet inneh\u00E5ller f\u00F6r m\u00E5nga tecken.\",\n      );\n\n    if (!DIGITS_7_OR_8.test(digits))\n      return invalidResult(\n        input,\n        ValidationErrorReason.InvalidLength,\n        \"Bankgiro number must be 7 or 8 digits.\",\n        \"Bankgironummer m\u00E5ste vara 7 eller 8 siffror.\",\n      );\n\n    if (!luhnIsValid(digits))\n      return invalidResult(\n        input,\n        ValidationErrorReason.InvalidCheckDigit,\n        \"Invalid Luhn check digit.\",\n        \"Ogiltig kontrollsiffra.\",\n      );\n\n    return validResult(input);\n  }\n\n  static findCandidatesInText(text: string): readonly TextCandidate<SwedishBankgiroNumber>[] {\n    if (!text) return [];\n    const out: TextCandidate<SwedishBankgiroNumber>[] = [];\n    const re = /(?<!\\d)\\d{3,4}-\\d{4}(?!\\d)/g;\n    let m: RegExpExecArray | null;\n    while ((m = re.exec(text)) !== null) {\n      const r = SwedishBankgiroNumber.tryParse(m[0]);\n      if (!r) continue;\n      out.push(\n        new TextCandidate<SwedishBankgiroNumber>({\n          startIndex: m.index,\n          length: m[0].length,\n          originalText: m[0],\n          typeName: \"SwedishBankgiroNumber\",\n          category: TextCandidateCategory.Financial,\n          normalizedForm: r.toNormalizedString(),\n          formattedForm: r.toString(),\n          maskedForm: maskSwedishBankgiroNumber(r),\n          confidence: TextMatchConfidence.High,\n          value: r,\n        }),\n      );\n    }\n    return out;\n  }\n\n  equals(other: SwedishBankgiroNumber | null | undefined): boolean {\n    return other != null && this.formatted === other.formatted;\n  }\n  compareTo(other: SwedishBankgiroNumber | null | undefined): number {\n    if (other == null) return 1;\n    return this.formatted < other.formatted ? -1 : this.formatted > other.formatted ? 1 : 0;\n  }\n}\n\n/** Returns the Bankgirot search URL for this Bankgiro number. */\nexport function getBankgirotUrl(bg: SwedishBankgiroNumber): string {\n  return `https://www.bankgirot.se/sok-bankgironummer/?bgnr=${bg.formatted}`;\n}\n\n/**\n * Returns a masked Bankgiro number, e.g. `****-6201` (default) or `5805-****` when\n * `showLastDigits` is `false`.\n */\nexport function maskSwedishBankgiroNumber(\n  bg: SwedishBankgiroNumber,\n  options?: { showLastDigits?: boolean },\n): string {\n  const showLastDigits = options?.showLastDigits ?? true;\n  const formatted = bg.formatted;\n  const dashIndex = formatted.indexOf(\"-\");\n  if (dashIndex < 0) return \"*\".repeat(formatted.length);\n  if (showLastDigits) {\n    return `${\"*\".repeat(dashIndex)}-${formatted.slice(dashIndex + 1)}`;\n  }\n  return `${formatted.slice(0, dashIndex)}-${\"*\".repeat(formatted.length - dashIndex - 1)}`;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/esm/banking/swedish-banking-number.js

@@ -0,0 +1,181 @@
+import { sanitizeInput } from "../internal/input-sanitization.js";
+import { Iban } from "./iban.js";
+import { Bic } from "./bic.js";
+import { SwedishBankgiroNumber } from "./swedish-bankgiro-number.js";
+import { SwedishPostgiroNumber } from "./swedish-postgiro-number.js";
+import { SwedishOcrReferenceNumber } from "./swedish-ocr-reference-number.js";
+import { SwedishBankAccount } from "./swedish-bank-account.js";
+const SwedishBankingNumberType = {
+  Unknown: "Unknown",
+  SwedishBankgiroNumber: "SwedishBankgiroNumber",
+  SwedishPostgiroNumber: "SwedishPostgiroNumber",
+  SwedishOcrReferenceNumber: "SwedishOcrReferenceNumber",
+  Iban: "Iban",
+  SwedishBankAccount: "SwedishBankAccount",
+  Bic: "Bic"
+};
+class SwedishBankingNumber {
+  type;
+  normalizedValue;
+  swedishBankgiroNumber;
+  swedishPostgiroNumber;
+  swedishOcrReferenceNumber;
+  iban;
+  swedishBankAccount;
+  bic;
+  /** @internal */
+  constructor(init) {
+    this.type = init.type;
+    this.normalizedValue = init.normalizedValue;
+    this.swedishBankgiroNumber = init.swedishBankgiroNumber ?? null;
+    this.swedishPostgiroNumber = init.swedishPostgiroNumber ?? null;
+    this.swedishOcrReferenceNumber = init.swedishOcrReferenceNumber ?? null;
+    this.iban = init.iban ?? null;
+    this.swedishBankAccount = init.swedishBankAccount ?? null;
+    this.bic = init.bic ?? null;
+  }
+  static unknown() {
+    return new SwedishBankingNumber({
+      type: SwedishBankingNumberType.Unknown,
+      normalizedValue: ""
+    });
+  }
+}
+const MAX_INPUT_LENGTH = 50;
+const BANKGIRO_PATTERN = /^\s*\d{3,4}\s*-\s*\d{4}\s*$/;
+const PLUSGIRO_PATTERN = /^\s*\d{1,7}\s*-\s*\d\s*$/;
+const TYPE_PREFIXES = [
+  ["Bankgiro ", SwedishBankingNumberType.SwedishBankgiroNumber],
+  ["Plusgiro ", SwedishBankingNumberType.SwedishPostgiroNumber],
+  ["Postgiro ", SwedishBankingNumberType.SwedishPostgiroNumber],
+  ["BG ", SwedishBankingNumberType.SwedishBankgiroNumber],
+  ["PG ", SwedishBankingNumberType.SwedishPostgiroNumber]
+];
+class SwedishBankingNumberParser {
+  static tryParse(input) {
+    if (input == null || input.trim() === "") return null;
+    const trimmed = sanitizeInput(input).trim();
+    if (trimmed.length > MAX_INPUT_LENGTH) return null;
+    const { hintedType, payload } = detectTypePrefix(trimmed);
+    if (hintedType === SwedishBankingNumberType.SwedishBankgiroNumber) {
+      const bg2 = SwedishBankgiroNumber.tryParse(payload);
+      if (bg2 !== null) {
+        return new SwedishBankingNumber({
+          type: SwedishBankingNumberType.SwedishBankgiroNumber,
+          normalizedValue: bg2.formatted,
+          swedishBankgiroNumber: bg2
+        });
+      }
+      return null;
+    }
+    if (hintedType === SwedishBankingNumberType.SwedishPostgiroNumber) {
+      const pg2 = SwedishPostgiroNumber.tryParse(payload);
+      if (pg2 !== null) {
+        return new SwedishBankingNumber({
+          type: SwedishBankingNumberType.SwedishPostgiroNumber,
+          normalizedValue: pg2.formatted,
+          swedishPostgiroNumber: pg2
+        });
+      }
+      return null;
+    }
+    if (containsLetters(trimmed)) {
+      const iban = Iban.tryParse(trimmed);
+      if (iban !== null) {
+        return new SwedishBankingNumber({
+          type: SwedishBankingNumberType.Iban,
+          normalizedValue: iban.value,
+          iban
+        });
+      }
+    }
+    if (containsLetters(trimmed)) {
+      const bic = Bic.tryParse(trimmed);
+      if (bic !== null) {
+        return new SwedishBankingNumber({
+          type: SwedishBankingNumberType.Bic,
+          normalizedValue: bic.code,
+          bic
+        });
+      }
+    }
+    if (BANKGIRO_PATTERN.test(trimmed)) {
+      const bg2 = SwedishBankgiroNumber.tryParse(trimmed);
+      if (bg2 !== null) {
+        return new SwedishBankingNumber({
+          type: SwedishBankingNumberType.SwedishBankgiroNumber,
+          normalizedValue: bg2.formatted,
+          swedishBankgiroNumber: bg2
+        });
+      }
+    }
+    if (PLUSGIRO_PATTERN.test(trimmed)) {
+      const pg2 = SwedishPostgiroNumber.tryParse(trimmed);
+      if (pg2 !== null) {
+        return new SwedishBankingNumber({
+          type: SwedishBankingNumberType.SwedishPostgiroNumber,
+          normalizedValue: pg2.formatted,
+          swedishPostgiroNumber: pg2
+        });
+      }
+    }
+    const account = SwedishBankAccount.tryParse(trimmed);
+    if (account !== null) {
+      return new SwedishBankingNumber({
+        type: SwedishBankingNumberType.SwedishBankAccount,
+        normalizedValue: account.toNormalizedString(),
+        swedishBankAccount: account
+      });
+    }
+    const bg = SwedishBankgiroNumber.tryParse(trimmed);
+    if (bg !== null) {
+      return new SwedishBankingNumber({
+        type: SwedishBankingNumberType.SwedishBankgiroNumber,
+        normalizedValue: bg.formatted,
+        swedishBankgiroNumber: bg
+      });
+    }
+    const pg = SwedishPostgiroNumber.tryParse(trimmed);
+    if (pg !== null) {
+      return new SwedishBankingNumber({
+        type: SwedishBankingNumberType.SwedishPostgiroNumber,
+        normalizedValue: pg.formatted,
+        swedishPostgiroNumber: pg
+      });
+    }
+    const ocr = SwedishOcrReferenceNumber.tryParse(trimmed);
+    if (ocr !== null) {
+      return new SwedishBankingNumber({
+        type: SwedishBankingNumberType.SwedishOcrReferenceNumber,
+        normalizedValue: ocr.value,
+        swedishOcrReferenceNumber: ocr
+      });
+    }
+    return null;
+  }
+  static parse(input) {
+    const r = SwedishBankingNumberParser.tryParse(input);
+    if (r === null) throw new Error("Could not parse input as a known banking number.");
+    return r;
+  }
+}
+function detectTypePrefix(input) {
+  const lower = input.toLowerCase();
+  for (const [prefix, type] of TYPE_PREFIXES) {
+    const lp = prefix.toLowerCase();
+    if (lower.startsWith(lp)) {
+      const payload = input.slice(prefix.length).trim();
+      if (payload.length > 0) return { hintedType: type, payload };
+    }
+  }
+  return { hintedType: SwedishBankingNumberType.Unknown, payload: input };
+}
+function containsLetters(input) {
+  return /\p{L}/u.test(input);
+}
+export {
+  SwedishBankingNumber,
+  SwedishBankingNumberParser,
+  SwedishBankingNumberType
+};
+//# sourceMappingURL=swedish-banking-number.js.map

package/dist/esm/banking/swedish-banking-number.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/banking/swedish-banking-number.ts"],
+  "sourcesContent": ["import { sanitizeInput } from \"../internal/input-sanitization.js\";\nimport { Iban } from \"./iban.js\";\nimport { Bic } from \"./bic.js\";\nimport { SwedishBankgiroNumber } from \"./swedish-bankgiro-number.js\";\nimport { SwedishPostgiroNumber } from \"./swedish-postgiro-number.js\";\nimport { SwedishOcrReferenceNumber } from \"./swedish-ocr-reference-number.js\";\nimport { SwedishBankAccount } from \"./swedish-bank-account.js\";\n\nexport const SwedishBankingNumberType = {\n  Unknown: \"Unknown\",\n  SwedishBankgiroNumber: \"SwedishBankgiroNumber\",\n  SwedishPostgiroNumber: \"SwedishPostgiroNumber\",\n  SwedishOcrReferenceNumber: \"SwedishOcrReferenceNumber\",\n  Iban: \"Iban\",\n  SwedishBankAccount: \"SwedishBankAccount\",\n  Bic: \"Bic\",\n} as const;\nexport type SwedishBankingNumberType =\n  (typeof SwedishBankingNumberType)[keyof typeof SwedishBankingNumberType];\n\n/**\n * Parsed banking identifier result from the unified banking parser.\n * The type field indicates which typed value (if any) was successfully parsed.\n */\nexport class SwedishBankingNumber {\n  readonly type: SwedishBankingNumberType;\n  readonly normalizedValue: string;\n\n  readonly swedishBankgiroNumber: SwedishBankgiroNumber | null;\n  readonly swedishPostgiroNumber: SwedishPostgiroNumber | null;\n  readonly swedishOcrReferenceNumber: SwedishOcrReferenceNumber | null;\n  readonly iban: Iban | null;\n  readonly swedishBankAccount: SwedishBankAccount | null;\n  readonly bic: Bic | null;\n\n  /** @internal */\n  constructor(init: {\n    type: SwedishBankingNumberType;\n    normalizedValue: string;\n    swedishBankgiroNumber?: SwedishBankgiroNumber | null;\n    swedishPostgiroNumber?: SwedishPostgiroNumber | null;\n    swedishOcrReferenceNumber?: SwedishOcrReferenceNumber | null;\n    iban?: Iban | null;\n    swedishBankAccount?: SwedishBankAccount | null;\n    bic?: Bic | null;\n  }) {\n    this.type = init.type;\n    this.normalizedValue = init.normalizedValue;\n    this.swedishBankgiroNumber = init.swedishBankgiroNumber ?? null;\n    this.swedishPostgiroNumber = init.swedishPostgiroNumber ?? null;\n    this.swedishOcrReferenceNumber = init.swedishOcrReferenceNumber ?? null;\n    this.iban = init.iban ?? null;\n    this.swedishBankAccount = init.swedishBankAccount ?? null;\n    this.bic = init.bic ?? null;\n  }\n\n  static unknown(): SwedishBankingNumber {\n    return new SwedishBankingNumber({\n      type: SwedishBankingNumberType.Unknown,\n      normalizedValue: \"\",\n    });\n  }\n}\n\nconst MAX_INPUT_LENGTH = 50;\nconst BANKGIRO_PATTERN = /^\\s*\\d{3,4}\\s*-\\s*\\d{4}\\s*$/;\nconst PLUSGIRO_PATTERN = /^\\s*\\d{1,7}\\s*-\\s*\\d\\s*$/;\n\nconst TYPE_PREFIXES: readonly [string, SwedishBankingNumberType][] = [\n  [\"Bankgiro \", SwedishBankingNumberType.SwedishBankgiroNumber],\n  [\"Plusgiro \", SwedishBankingNumberType.SwedishPostgiroNumber],\n  [\"Postgiro \", SwedishBankingNumberType.SwedishPostgiroNumber],\n  [\"BG \", SwedishBankingNumberType.SwedishBankgiroNumber],\n  [\"PG \", SwedishBankingNumberType.SwedishPostgiroNumber],\n];\n\n/**\n * A unified parser for common banking identifiers used in Swedish payment flows.\n * Attempts to classify input as Bankgiro, Plusgiro, OCR reference, BIC, IBAN,\n * or Swedish bank account.\n */\nexport class SwedishBankingNumberParser {\n  static tryParse(input: string | null | undefined): SwedishBankingNumber | null {\n    if (input == null || input.trim() === \"\") return null;\n\n    const trimmed = sanitizeInput(input).trim();\n    if (trimmed.length > MAX_INPUT_LENGTH) return null;\n\n    // 0. Explicit type prefix\n    const { hintedType, payload } = detectTypePrefix(trimmed);\n    if (hintedType === SwedishBankingNumberType.SwedishBankgiroNumber) {\n      const bg = SwedishBankgiroNumber.tryParse(payload);\n      if (bg !== null) {\n        return new SwedishBankingNumber({\n          type: SwedishBankingNumberType.SwedishBankgiroNumber,\n          normalizedValue: bg.formatted,\n          swedishBankgiroNumber: bg,\n        });\n      }\n      return null;\n    }\n    if (hintedType === SwedishBankingNumberType.SwedishPostgiroNumber) {\n      const pg = SwedishPostgiroNumber.tryParse(payload);\n      if (pg !== null) {\n        return new SwedishBankingNumber({\n          type: SwedishBankingNumberType.SwedishPostgiroNumber,\n          normalizedValue: pg.formatted,\n          swedishPostgiroNumber: pg,\n        });\n      }\n      return null;\n    }\n\n    // 1. IBAN \u2014 distinctive country letters + check digits\n    if (containsLetters(trimmed)) {\n      const iban = Iban.tryParse(trimmed);\n      if (iban !== null) {\n        return new SwedishBankingNumber({\n          type: SwedishBankingNumberType.Iban,\n          normalizedValue: iban.value,\n          iban,\n        });\n      }\n    }\n\n    // 2. BIC/SWIFT \u2014 letter heavy\n    if (containsLetters(trimmed)) {\n      const bic = Bic.tryParse(trimmed);\n      if (bic !== null) {\n        return new SwedishBankingNumber({\n          type: SwedishBankingNumberType.Bic,\n          normalizedValue: bic.code,\n          bic,\n        });\n      }\n    }\n\n    // 3. Explicit hyphenated formats\n    if (BANKGIRO_PATTERN.test(trimmed)) {\n      const bg = SwedishBankgiroNumber.tryParse(trimmed);\n      if (bg !== null) {\n        return new SwedishBankingNumber({\n          type: SwedishBankingNumberType.SwedishBankgiroNumber,\n          normalizedValue: bg.formatted,\n          swedishBankgiroNumber: bg,\n        });\n      }\n    }\n    if (PLUSGIRO_PATTERN.test(trimmed)) {\n      const pg = SwedishPostgiroNumber.tryParse(trimmed);\n      if (pg !== null) {\n        return new SwedishBankingNumber({\n          type: SwedishBankingNumberType.SwedishPostgiroNumber,\n          normalizedValue: pg.formatted,\n          swedishPostgiroNumber: pg,\n        });\n      }\n    }\n\n    // 4. Longer Swedish bank account numbers (more specific than OCR)\n    const account = SwedishBankAccount.tryParse(trimmed);\n    if (account !== null) {\n      return new SwedishBankingNumber({\n        type: SwedishBankingNumberType.SwedishBankAccount,\n        normalizedValue: account.toNormalizedString(),\n        swedishBankAccount: account,\n      });\n    }\n\n    // 5. Bankgiro before Plusgiro\n    const bg = SwedishBankgiroNumber.tryParse(trimmed);\n    if (bg !== null) {\n      return new SwedishBankingNumber({\n        type: SwedishBankingNumberType.SwedishBankgiroNumber,\n        normalizedValue: bg.formatted,\n        swedishBankgiroNumber: bg,\n      });\n    }\n    const pg = SwedishPostgiroNumber.tryParse(trimmed);\n    if (pg !== null) {\n      return new SwedishBankingNumber({\n        type: SwedishBankingNumberType.SwedishPostgiroNumber,\n        normalizedValue: pg.formatted,\n        swedishPostgiroNumber: pg,\n      });\n    }\n\n    // 6. OCR last (high false-positive rate)\n    const ocr = SwedishOcrReferenceNumber.tryParse(trimmed);\n    if (ocr !== null) {\n      return new SwedishBankingNumber({\n        type: SwedishBankingNumberType.SwedishOcrReferenceNumber,\n        normalizedValue: ocr.value,\n        swedishOcrReferenceNumber: ocr,\n      });\n    }\n\n    return null;\n  }\n\n  static parse(input: string): SwedishBankingNumber {\n    const r = SwedishBankingNumberParser.tryParse(input);\n    if (r === null) throw new Error(\"Could not parse input as a known banking number.\");\n    return r;\n  }\n}\n\nfunction detectTypePrefix(input: string): {\n  hintedType: SwedishBankingNumberType;\n  payload: string;\n} {\n  const lower = input.toLowerCase();\n  for (const [prefix, type] of TYPE_PREFIXES) {\n    const lp = prefix.toLowerCase();\n    if (lower.startsWith(lp)) {\n      const payload = input.slice(prefix.length).trim();\n      if (payload.length > 0) return { hintedType: type, payload };\n    }\n  }\n  return { hintedType: SwedishBankingNumberType.Unknown, payload: input };\n}\n\nfunction containsLetters(input: string): boolean {\n  return /\\p{L}/u.test(input);\n}\n"],
+  "mappings": "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",
+  "names": ["bg", "pg"]
+}

package/dist/esm/banking/swedish-ocr-reference-number.js

@@ -0,0 +1,195 @@
+import { keepDigits, sanitizeInput } from "../internal/input-sanitization.js";
+import { luhnIsValid } from "../internal/luhn.js";
+import { TextCandidateCategory } from "../text-scanning/text-candidate-category.js";
+import { TextCandidate } from "../text-scanning/text-candidate.js";
+import { TextMatchConfidence } from "../text-scanning/text-match-confidence.js";
+import { validResult, invalidResult } from "../validation/validation-result.js";
+import { ValidationErrorReason } from "../validation/validation-error-reason.js";
+const OcrReferenceControlType = {
+  CheckDigitOnly: "CheckDigitOnly",
+  VariableLengthDigit: "VariableLengthDigit",
+  FixedLength: "FixedLength"
+};
+class OcrReferenceOptions {
+  static Default = new OcrReferenceOptions(
+    OcrReferenceControlType.CheckDigitOnly
+  );
+  static VariableLengthDigit = new OcrReferenceOptions(
+    OcrReferenceControlType.VariableLengthDigit
+  );
+  controlType;
+  allowedLengths;
+  constructor(controlType = OcrReferenceControlType.CheckDigitOnly, allowedLengths = []) {
+    this.controlType = controlType;
+    this.allowedLengths = Object.freeze([...allowedLengths]);
+  }
+  static fixedLength(...allowedLengths) {
+    return new OcrReferenceOptions(OcrReferenceControlType.FixedLength, allowedLengths);
+  }
+}
+class SwedishOcrReferenceNumber {
+  static typeInfo = Object.freeze({
+    englishName: "OCR Reference Number",
+    localizedName: "OCR-referens",
+    emoji: "\u{1F4DD}",
+    sources: Object.freeze([
+      "https://www.bankgirot.se/en/services/incoming-payments/bankgiro-receivables/ocr-reference-control/",
+      "https://www.bankgirot.se/en/services/incoming-payments/bankgiro-receivables/technical-information/"
+    ])
+  });
+  static displayName = "OCR";
+  static displayNameShort = "OCR";
+  value;
+  formatted;
+  lengthDigit;
+  get length() {
+    return this.value.length;
+  }
+  get checkDigit() {
+    return this.value.charCodeAt(this.value.length - 1) - 48;
+  }
+  constructor(value, lengthDigit) {
+    this.value = value;
+    this.formatted = value;
+    this.lengthDigit = lengthDigit;
+  }
+  static tryParse(input, options = OcrReferenceOptions.Default) {
+    if (input == null || input.trim() === "") return null;
+    const digits = keepDigits(sanitizeInput(input));
+    if (digits.length < 2 || digits.length > 25) return null;
+    if (!luhnIsValid(digits)) return null;
+    const lengthDigit = validateByOptions(digits, options);
+    if (lengthDigit === false) return null;
+    return new SwedishOcrReferenceNumber(digits, lengthDigit);
+  }
+  static tryParseVariableLengthDigit(input) {
+    return SwedishOcrReferenceNumber.tryParse(input, OcrReferenceOptions.VariableLengthDigit);
+  }
+  static tryParseFixedLength(input, fixedLengths) {
+    const lengths = typeof fixedLengths === "number" ? [fixedLengths] : [...fixedLengths];
+    return SwedishOcrReferenceNumber.tryParse(input, OcrReferenceOptions.fixedLength(...lengths));
+  }
+  static parse(input, options = OcrReferenceOptions.Default) {
+    const r = SwedishOcrReferenceNumber.tryParse(input, options);
+    if (r === null) throw new Error("Invalid OCR reference number.");
+    return r;
+  }
+  static isValid(input, options = OcrReferenceOptions.Default) {
+    return SwedishOcrReferenceNumber.tryParse(input, options) !== null;
+  }
+  static format(input, options) {
+    const r = SwedishOcrReferenceNumber.tryParse(input);
+    if (r) return r.formatted;
+    if (options?.fallbackToTrimmedInputWhenInvalid && input != null && input.trim() !== "") {
+      return input.trim();
+    }
+    return null;
+  }
+  static normalize(input, options) {
+    const r = SwedishOcrReferenceNumber.tryParse(input);
+    if (r) return r.value;
+    if (options?.fallbackToTrimmedInputWhenInvalid && input != null && input.trim() !== "") {
+      return input.trim();
+    }
+    return null;
+  }
+  static isNormalized(input) {
+    return input != null && SwedishOcrReferenceNumber.normalize(input) === input;
+  }
+  toNormalizedString() {
+    return this.value;
+  }
+  toDisplayString() {
+    return `${SwedishOcrReferenceNumber.displayName} ${this.formatted}`;
+  }
+  toShortDisplayString() {
+    return `${SwedishOcrReferenceNumber.displayNameShort} ${this.formatted}`;
+  }
+  toString() {
+    return this.formatted;
+  }
+  static validate(input) {
+    if (input == null || input.trim() === "")
+      return invalidResult(
+        input,
+        ValidationErrorReason.InputIsEmpty,
+        "Input is empty or whitespace.",
+        "V\xE4rdet \xE4r tomt."
+      );
+    const digits = keepDigits(sanitizeInput(input));
+    if (digits.length < 2 || digits.length > 25)
+      return invalidResult(
+        input,
+        ValidationErrorReason.InvalidLength,
+        "OCR reference must be 2\u201325 digits.",
+        "OCR-referens m\xE5ste vara 2\u201325 siffror."
+      );
+    if (!luhnIsValid(digits))
+      return invalidResult(
+        input,
+        ValidationErrorReason.InvalidCheckDigit,
+        "Invalid Luhn check digit.",
+        "Ogiltig kontrollsiffra."
+      );
+    return validResult(input);
+  }
+  static findCandidatesInText(text) {
+    if (!text) return [];
+    const out = [];
+    const re = /(?<!\d)\d{2,25}(?!\d)/g;
+    let m;
+    while ((m = re.exec(text)) !== null) {
+      const r = SwedishOcrReferenceNumber.tryParse(m[0]);
+      if (!r) continue;
+      out.push(
+        new TextCandidate({
+          startIndex: m.index,
+          length: m[0].length,
+          originalText: m[0],
+          typeName: "SwedishOcrReferenceNumber",
+          category: TextCandidateCategory.Financial,
+          normalizedForm: r.toNormalizedString(),
+          formattedForm: r.toString(),
+          maskedForm: maskSwedishOcrReferenceNumber(r),
+          confidence: TextMatchConfidence.Low,
+          value: r
+        })
+      );
+    }
+    return out;
+  }
+  equals(other) {
+    return other != null && this.value === other.value;
+  }
+  compareTo(other) {
+    if (other == null) return 1;
+    return this.value < other.value ? -1 : this.value > other.value ? 1 : 0;
+  }
+}
+function validateByOptions(digits, options) {
+  switch (options.controlType) {
+    case OcrReferenceControlType.CheckDigitOnly:
+      return null;
+    case OcrReferenceControlType.VariableLengthDigit: {
+      if (digits.length < 3) return false;
+      const expected = digits.length % 10;
+      const actual = digits.charCodeAt(digits.length - 2) - 48;
+      if (actual !== expected) return false;
+      return actual;
+    }
+    case OcrReferenceControlType.FixedLength:
+      return options.allowedLengths.length > 0 && options.allowedLengths.includes(digits.length) ? null : false;
+    default:
+      return false;
+  }
+}
+function maskSwedishOcrReferenceNumber(ocr) {
+  return "*".repeat(ocr.value.length);
+}
+export {
+  OcrReferenceControlType,
+  OcrReferenceOptions,
+  SwedishOcrReferenceNumber,
+  maskSwedishOcrReferenceNumber
+};
+//# sourceMappingURL=swedish-ocr-reference-number.js.map

package/dist/esm/banking/swedish-ocr-reference-number.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/banking/swedish-ocr-reference-number.ts"],
+  "sourcesContent": ["import { PrimitiveTypeInfo } from \"../primitive-type-info.js\";\nimport { keepDigits, sanitizeInput } from \"../internal/input-sanitization.js\";\nimport { luhnIsValid } from \"../internal/luhn.js\";\nimport { TextCandidateCategory } from \"../text-scanning/text-candidate-category.js\";\nimport { TextCandidate } from \"../text-scanning/text-candidate.js\";\nimport { TextMatchConfidence } from \"../text-scanning/text-match-confidence.js\";\nimport { ValidationResult, validResult, invalidResult } from \"../validation/validation-result.js\";\nimport { ValidationErrorReason } from \"../validation/validation-error-reason.js\";\n\n/** OCR reference control type. */\nexport const OcrReferenceControlType = {\n  CheckDigitOnly: \"CheckDigitOnly\",\n  VariableLengthDigit: \"VariableLengthDigit\",\n  FixedLength: \"FixedLength\",\n} as const;\nexport type OcrReferenceControlType =\n  (typeof OcrReferenceControlType)[keyof typeof OcrReferenceControlType];\n\n/** Options controlling OCR reference parsing. */\nexport class OcrReferenceOptions {\n  static readonly Default: OcrReferenceOptions = new OcrReferenceOptions(\n    OcrReferenceControlType.CheckDigitOnly,\n  );\n  static readonly VariableLengthDigit: OcrReferenceOptions = new OcrReferenceOptions(\n    OcrReferenceControlType.VariableLengthDigit,\n  );\n\n  readonly controlType: OcrReferenceControlType;\n  readonly allowedLengths: readonly number[];\n\n  constructor(\n    controlType: OcrReferenceControlType = OcrReferenceControlType.CheckDigitOnly,\n    allowedLengths: readonly number[] = [],\n  ) {\n    this.controlType = controlType;\n    this.allowedLengths = Object.freeze([...allowedLengths]);\n  }\n\n  static fixedLength(...allowedLengths: number[]): OcrReferenceOptions {\n    return new OcrReferenceOptions(OcrReferenceControlType.FixedLength, allowedLengths);\n  }\n}\n\n/**\n * A Swedish OCR reference number (`OCR-nummer`), used in payment flows.\n * 2\u201325 digits with Luhn check digit; optional length-digit and fixed-length variants.\n */\nexport class SwedishOcrReferenceNumber {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"OCR Reference Number\",\n    localizedName: \"OCR-referens\",\n    emoji: \"\\u{1F4DD}\",\n    sources: Object.freeze([\n      \"https://www.bankgirot.se/en/services/incoming-payments/bankgiro-receivables/ocr-reference-control/\",\n      \"https://www.bankgirot.se/en/services/incoming-payments/bankgiro-receivables/technical-information/\",\n    ]),\n  });\n\n  static readonly displayName = \"OCR\";\n  static readonly displayNameShort = \"OCR\";\n\n  readonly value: string;\n  readonly formatted: string;\n  readonly lengthDigit: number | null;\n\n  get length(): number {\n    return this.value.length;\n  }\n  get checkDigit(): number {\n    return this.value.charCodeAt(this.value.length - 1) - 0x30;\n  }\n\n  private constructor(value: string, lengthDigit: number | null) {\n    this.value = value;\n    this.formatted = value;\n    this.lengthDigit = lengthDigit;\n  }\n\n  static tryParse(\n    input: string | null | undefined,\n    options: OcrReferenceOptions = OcrReferenceOptions.Default,\n  ): SwedishOcrReferenceNumber | null {\n    if (input == null || input.trim() === \"\") return null;\n    const digits = keepDigits(sanitizeInput(input));\n    if (digits.length < 2 || digits.length > 25) return null;\n    if (!luhnIsValid(digits)) return null;\n    const lengthDigit = validateByOptions(digits, options);\n    if (lengthDigit === false) return null;\n    return new SwedishOcrReferenceNumber(digits, lengthDigit);\n  }\n\n  static tryParseVariableLengthDigit(\n    input: string | null | undefined,\n  ): SwedishOcrReferenceNumber | null {\n    return SwedishOcrReferenceNumber.tryParse(input, OcrReferenceOptions.VariableLengthDigit);\n  }\n\n  static tryParseFixedLength(\n    input: string | null | undefined,\n    fixedLengths: number | readonly number[],\n  ): SwedishOcrReferenceNumber | null {\n    const lengths = typeof fixedLengths === \"number\" ? [fixedLengths] : [...fixedLengths];\n    return SwedishOcrReferenceNumber.tryParse(input, OcrReferenceOptions.fixedLength(...lengths));\n  }\n\n  static parse(\n    input: string,\n    options: OcrReferenceOptions = OcrReferenceOptions.Default,\n  ): SwedishOcrReferenceNumber {\n    const r = SwedishOcrReferenceNumber.tryParse(input, options);\n    if (r === null) throw new Error(\"Invalid OCR reference number.\");\n    return r;\n  }\n\n  static isValid(\n    input: string | null | undefined,\n    options: OcrReferenceOptions = OcrReferenceOptions.Default,\n  ): boolean {\n    return SwedishOcrReferenceNumber.tryParse(input, options) !== null;\n  }\n\n  static format(\n    input: string | null | undefined,\n    options?: { fallbackToTrimmedInputWhenInvalid?: boolean },\n  ): string | null {\n    const r = SwedishOcrReferenceNumber.tryParse(input);\n    if (r) return r.formatted;\n    if (options?.fallbackToTrimmedInputWhenInvalid && input != null && input.trim() !== \"\") {\n      return input.trim();\n    }\n    return null;\n  }\n\n  static normalize(\n    input: string | null | undefined,\n    options?: { fallbackToTrimmedInputWhenInvalid?: boolean },\n  ): string | null {\n    const r = SwedishOcrReferenceNumber.tryParse(input);\n    if (r) return r.value;\n    if (options?.fallbackToTrimmedInputWhenInvalid && input != null && input.trim() !== \"\") {\n      return input.trim();\n    }\n    return null;\n  }\n\n  static isNormalized(input: string | null | undefined): boolean {\n    return input != null && SwedishOcrReferenceNumber.normalize(input) === input;\n  }\n\n  toNormalizedString(): string {\n    return this.value;\n  }\n\n  toDisplayString(): string {\n    return `${SwedishOcrReferenceNumber.displayName} ${this.formatted}`;\n  }\n\n  toShortDisplayString(): string {\n    return `${SwedishOcrReferenceNumber.displayNameShort} ${this.formatted}`;\n  }\n\n  toString(): string {\n    return this.formatted;\n  }\n\n  static validate(input: string | null | undefined): ValidationResult {\n    if (input == null || input.trim() === \"\")\n      return invalidResult(\n        input,\n        ValidationErrorReason.InputIsEmpty,\n        \"Input is empty or whitespace.\",\n        \"V\u00E4rdet \u00E4r tomt.\",\n      );\n\n    const digits = keepDigits(sanitizeInput(input));\n\n    if (digits.length < 2 || digits.length > 25)\n      return invalidResult(\n        input,\n        ValidationErrorReason.InvalidLength,\n        \"OCR reference must be 2\u201325 digits.\",\n        \"OCR-referens m\u00E5ste vara 2\u201325 siffror.\",\n      );\n\n    if (!luhnIsValid(digits))\n      return invalidResult(\n        input,\n        ValidationErrorReason.InvalidCheckDigit,\n        \"Invalid Luhn check digit.\",\n        \"Ogiltig kontrollsiffra.\",\n      );\n\n    return validResult(input);\n  }\n\n  static findCandidatesInText(text: string): readonly TextCandidate<SwedishOcrReferenceNumber>[] {\n    if (!text) return [];\n    const out: TextCandidate<SwedishOcrReferenceNumber>[] = [];\n    const re = /(?<!\\d)\\d{2,25}(?!\\d)/g;\n    let m: RegExpExecArray | null;\n    while ((m = re.exec(text)) !== null) {\n      const r = SwedishOcrReferenceNumber.tryParse(m[0]);\n      if (!r) continue;\n      out.push(\n        new TextCandidate<SwedishOcrReferenceNumber>({\n          startIndex: m.index,\n          length: m[0].length,\n          originalText: m[0],\n          typeName: \"SwedishOcrReferenceNumber\",\n          category: TextCandidateCategory.Financial,\n          normalizedForm: r.toNormalizedString(),\n          formattedForm: r.toString(),\n          maskedForm: maskSwedishOcrReferenceNumber(r),\n          confidence: TextMatchConfidence.Low,\n          value: r,\n        }),\n      );\n    }\n    return out;\n  }\n\n  equals(other: SwedishOcrReferenceNumber | null | undefined): boolean {\n    return other != null && this.value === other.value;\n  }\n  compareTo(other: SwedishOcrReferenceNumber | null | undefined): number {\n    if (other == null) return 1;\n    return this.value < other.value ? -1 : this.value > other.value ? 1 : 0;\n  }\n}\n\nfunction validateByOptions(digits: string, options: OcrReferenceOptions): number | null | false {\n  switch (options.controlType) {\n    case OcrReferenceControlType.CheckDigitOnly:\n      return null;\n    case OcrReferenceControlType.VariableLengthDigit: {\n      if (digits.length < 3) return false;\n      const expected = digits.length % 10;\n      const actual = digits.charCodeAt(digits.length - 2) - 0x30;\n      if (actual !== expected) return false;\n      return actual;\n    }\n    case OcrReferenceControlType.FixedLength:\n      return options.allowedLengths.length > 0 && options.allowedLengths.includes(digits.length)\n        ? null\n        : false;\n    default:\n      return false;\n  }\n}\n\n/** Returns a fully masked OCR reference, e.g. `12345678901` \u2192 `***********`. */\nexport function maskSwedishOcrReferenceNumber(ocr: SwedishOcrReferenceNumber): string {\n  return \"*\".repeat(ocr.value.length);\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/esm/banking/swedish-postgiro-number.js

@@ -0,0 +1,153 @@
+import { keepDigits, sanitizeInput } from "../internal/input-sanitization.js";
+import { luhnIsValid } from "../internal/luhn.js";
+import { TextCandidateCategory } from "../text-scanning/text-candidate-category.js";
+import { TextCandidate } from "../text-scanning/text-candidate.js";
+import { TextMatchConfidence } from "../text-scanning/text-match-confidence.js";
+import { validResult, invalidResult } from "../validation/validation-result.js";
+import { ValidationErrorReason } from "../validation/validation-error-reason.js";
+const MAX_INPUT_LENGTH = 20;
+const DIGITS_2_TO_8 = /^\d{2,8}$/;
+class SwedishPostgiroNumber {
+  static typeInfo = Object.freeze({
+    englishName: "Plusgiro Number",
+    localizedName: "Plusgironummer",
+    emoji: "\u{1F4EE}",
+    sources: Object.freeze([
+      "https://www.bankgirot.se/",
+      "https://sv.wikipedia.org/wiki/Plusgirot"
+    ])
+  });
+  static displayName = "Plusgiro";
+  static displayNameShort = "PG";
+  /** Digit-only value, e.g. `41313008`. */
+  digits;
+  /** Hyphenated display form, e.g. `4131300-8`. */
+  formatted;
+  constructor(digits, formatted) {
+    this.digits = digits;
+    this.formatted = formatted;
+  }
+  static tryParse(input) {
+    if (input == null || input.trim() === "") return null;
+    const digits = keepDigits(sanitizeInput(input));
+    if (digits.length > MAX_INPUT_LENGTH) return null;
+    if (!DIGITS_2_TO_8.test(digits)) return null;
+    if (!luhnIsValid(digits)) return null;
+    const base = digits.slice(0, digits.length - 1);
+    const control = digits.slice(digits.length - 1);
+    return new SwedishPostgiroNumber(digits, `${base}-${control}`);
+  }
+  static parse(input) {
+    const r = SwedishPostgiroNumber.tryParse(input);
+    if (r === null) throw new Error("Invalid Plusgiro number.");
+    return r;
+  }
+  static isValid(input) {
+    return SwedishPostgiroNumber.tryParse(input) !== null;
+  }
+  static format(input, options) {
+    const r = SwedishPostgiroNumber.tryParse(input);
+    if (r) return r.formatted;
+    if (options?.fallbackToTrimmedInputWhenInvalid && input != null && input.trim() !== "") {
+      return input.trim();
+    }
+    return null;
+  }
+  static normalize(input, options) {
+    return SwedishPostgiroNumber.format(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && SwedishPostgiroNumber.normalize(input) === input;
+  }
+  toNormalizedString() {
+    return this.formatted;
+  }
+  toDisplayString() {
+    return `${SwedishPostgiroNumber.displayName} ${this.formatted}`;
+  }
+  toShortDisplayString() {
+    return `${SwedishPostgiroNumber.displayNameShort} ${this.formatted}`;
+  }
+  toString() {
+    return this.formatted;
+  }
+  static validate(input) {
+    if (input == null || input.trim() === "")
+      return invalidResult(
+        input,
+        ValidationErrorReason.InputIsEmpty,
+        "Input is empty or whitespace.",
+        "V\xE4rdet \xE4r tomt."
+      );
+    const digits = keepDigits(sanitizeInput(input));
+    if (digits.length > MAX_INPUT_LENGTH)
+      return invalidResult(
+        input,
+        ValidationErrorReason.InputTooLong,
+        "Input contains too many characters.",
+        "V\xE4rdet inneh\xE5ller f\xF6r m\xE5nga tecken."
+      );
+    if (!DIGITS_2_TO_8.test(digits))
+      return invalidResult(
+        input,
+        ValidationErrorReason.InvalidLength,
+        "Plusgiro number must be 2\u20138 digits.",
+        "Plusgironummer m\xE5ste vara 2\u20138 siffror."
+      );
+    if (!luhnIsValid(digits))
+      return invalidResult(
+        input,
+        ValidationErrorReason.InvalidCheckDigit,
+        "Invalid Luhn check digit.",
+        "Ogiltig kontrollsiffra."
+      );
+    return validResult(input);
+  }
+  static findCandidatesInText(text) {
+    if (!text) return [];
+    const out = [];
+    const re = /(?<!\d)\d{1,7}-\d(?!\d)/g;
+    let m;
+    while ((m = re.exec(text)) !== null) {
+      const r = SwedishPostgiroNumber.tryParse(m[0]);
+      if (!r) continue;
+      out.push(
+        new TextCandidate({
+          startIndex: m.index,
+          length: m[0].length,
+          originalText: m[0],
+          typeName: "SwedishPostgiroNumber",
+          category: TextCandidateCategory.Financial,
+          normalizedForm: r.toNormalizedString(),
+          formattedForm: r.toString(),
+          maskedForm: maskSwedishPostgiroNumber(r),
+          confidence: TextMatchConfidence.Medium,
+          value: r
+        })
+      );
+    }
+    return out;
+  }
+  equals(other) {
+    return other != null && this.formatted === other.formatted;
+  }
+  compareTo(other) {
+    if (other == null) return 1;
+    return this.formatted < other.formatted ? -1 : this.formatted > other.formatted ? 1 : 0;
+  }
+}
+function maskSwedishPostgiroNumber(pg, options) {
+  const showControlDigit = options?.showControlDigit ?? true;
+  const formatted = pg.formatted;
+  const dashIndex = formatted.indexOf("-");
+  if (dashIndex < 0) return "*".repeat(formatted.length);
+  if (showControlDigit) {
+    return `${"*".repeat(dashIndex)}-${formatted.slice(dashIndex + 1)}`;
+  }
+  return `${formatted.slice(0, dashIndex)}-${"*".repeat(formatted.length - dashIndex - 1)}`;
+}
+export {
+  SwedishPostgiroNumber,
+  maskSwedishPostgiroNumber
+};
+//# sourceMappingURL=swedish-postgiro-number.js.map

package/dist/esm/banking/swedish-postgiro-number.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/banking/swedish-postgiro-number.ts"],
+  "sourcesContent": ["import { PrimitiveTypeInfo } from \"../primitive-type-info.js\";\nimport { keepDigits, sanitizeInput } from \"../internal/input-sanitization.js\";\nimport { luhnIsValid } from \"../internal/luhn.js\";\nimport { TextCandidateCategory } from \"../text-scanning/text-candidate-category.js\";\nimport { TextCandidate } from \"../text-scanning/text-candidate.js\";\nimport { TextMatchConfidence } from \"../text-scanning/text-match-confidence.js\";\nimport { ValidationResult, validResult, invalidResult } from \"../validation/validation-result.js\";\nimport { ValidationErrorReason } from \"../validation/validation-error-reason.js\";\n\nconst MAX_INPUT_LENGTH = 20;\nconst DIGITS_2_TO_8 = /^\\d{2,8}$/;\n\n/**\n * A Swedish Plusgiro number (`plusgironummer`), e.g. `1234567-9`.\n * 2\u20138 digits with Luhn check digit.\n */\nexport class SwedishPostgiroNumber {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Plusgiro Number\",\n    localizedName: \"Plusgironummer\",\n    emoji: \"\\u{1F4EE}\",\n    sources: Object.freeze([\n      \"https://www.bankgirot.se/\",\n      \"https://sv.wikipedia.org/wiki/Plusgirot\",\n    ]),\n  });\n\n  static readonly displayName = \"Plusgiro\";\n  static readonly displayNameShort = \"PG\";\n\n  /** Digit-only value, e.g. `41313008`. */\n  readonly digits: string;\n  /** Hyphenated display form, e.g. `4131300-8`. */\n  readonly formatted: string;\n\n  private constructor(digits: string, formatted: string) {\n    this.digits = digits;\n    this.formatted = formatted;\n  }\n\n  static tryParse(input: string | null | undefined): SwedishPostgiroNumber | null {\n    if (input == null || input.trim() === \"\") return null;\n    const digits = keepDigits(sanitizeInput(input));\n    if (digits.length > MAX_INPUT_LENGTH) return null;\n    if (!DIGITS_2_TO_8.test(digits)) return null;\n    if (!luhnIsValid(digits)) return null;\n\n    const base = digits.slice(0, digits.length - 1);\n    const control = digits.slice(digits.length - 1);\n    return new SwedishPostgiroNumber(digits, `${base}-${control}`);\n  }\n\n  static parse(input: string): SwedishPostgiroNumber {\n    const r = SwedishPostgiroNumber.tryParse(input);\n    if (r === null) throw new Error(\"Invalid Plusgiro number.\");\n    return r;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return SwedishPostgiroNumber.tryParse(input) !== null;\n  }\n\n  static format(\n    input: string | null | undefined,\n    options?: { fallbackToTrimmedInputWhenInvalid?: boolean },\n  ): string | null {\n    const r = SwedishPostgiroNumber.tryParse(input);\n    if (r) return r.formatted;\n    if (options?.fallbackToTrimmedInputWhenInvalid && input != null && input.trim() !== \"\") {\n      return input.trim();\n    }\n    return null;\n  }\n\n  static normalize(\n    input: string | null | undefined,\n    options?: { fallbackToTrimmedInputWhenInvalid?: boolean },\n  ): string | null {\n    return SwedishPostgiroNumber.format(input, options);\n  }\n\n  static isNormalized(input: string | null | undefined): boolean {\n    return input != null && SwedishPostgiroNumber.normalize(input) === input;\n  }\n\n  toNormalizedString(): string {\n    return this.formatted;\n  }\n\n  toDisplayString(): string {\n    return `${SwedishPostgiroNumber.displayName} ${this.formatted}`;\n  }\n\n  toShortDisplayString(): string {\n    return `${SwedishPostgiroNumber.displayNameShort} ${this.formatted}`;\n  }\n\n  toString(): string {\n    return this.formatted;\n  }\n\n  static validate(input: string | null | undefined): ValidationResult {\n    if (input == null || input.trim() === \"\")\n      return invalidResult(\n        input,\n        ValidationErrorReason.InputIsEmpty,\n        \"Input is empty or whitespace.\",\n        \"V\u00E4rdet \u00E4r tomt.\",\n      );\n\n    const digits = keepDigits(sanitizeInput(input));\n\n    if (digits.length > MAX_INPUT_LENGTH)\n      return invalidResult(\n        input,\n        ValidationErrorReason.InputTooLong,\n        \"Input contains too many characters.\",\n        \"V\u00E4rdet inneh\u00E5ller f\u00F6r m\u00E5nga tecken.\",\n      );\n\n    if (!DIGITS_2_TO_8.test(digits))\n      return invalidResult(\n        input,\n        ValidationErrorReason.InvalidLength,\n        \"Plusgiro number must be 2\u20138 digits.\",\n        \"Plusgironummer m\u00E5ste vara 2\u20138 siffror.\",\n      );\n\n    if (!luhnIsValid(digits))\n      return invalidResult(\n        input,\n        ValidationErrorReason.InvalidCheckDigit,\n        \"Invalid Luhn check digit.\",\n        \"Ogiltig kontrollsiffra.\",\n      );\n\n    return validResult(input);\n  }\n\n  static findCandidatesInText(text: string): readonly TextCandidate<SwedishPostgiroNumber>[] {\n    if (!text) return [];\n    const out: TextCandidate<SwedishPostgiroNumber>[] = [];\n    const re = /(?<!\\d)\\d{1,7}-\\d(?!\\d)/g;\n    let m: RegExpExecArray | null;\n    while ((m = re.exec(text)) !== null) {\n      const r = SwedishPostgiroNumber.tryParse(m[0]);\n      if (!r) continue;\n      out.push(\n        new TextCandidate<SwedishPostgiroNumber>({\n          startIndex: m.index,\n          length: m[0].length,\n          originalText: m[0],\n          typeName: \"SwedishPostgiroNumber\",\n          category: TextCandidateCategory.Financial,\n          normalizedForm: r.toNormalizedString(),\n          formattedForm: r.toString(),\n          maskedForm: maskSwedishPostgiroNumber(r),\n          confidence: TextMatchConfidence.Medium,\n          value: r,\n        }),\n      );\n    }\n    return out;\n  }\n\n  equals(other: SwedishPostgiroNumber | null | undefined): boolean {\n    return other != null && this.formatted === other.formatted;\n  }\n  compareTo(other: SwedishPostgiroNumber | null | undefined): number {\n    if (other == null) return 1;\n    return this.formatted < other.formatted ? -1 : this.formatted > other.formatted ? 1 : 0;\n  }\n}\n\n/**\n * Returns a masked Plusgiro number, e.g. `******-9` (default, showing the control digit) or\n * `123456-*` when `showControlDigit` is `false`.\n */\nexport function maskSwedishPostgiroNumber(\n  pg: SwedishPostgiroNumber,\n  options?: { showControlDigit?: boolean },\n): string {\n  const showControlDigit = options?.showControlDigit ?? true;\n  const formatted = pg.formatted;\n  const dashIndex = formatted.indexOf(\"-\");\n  if (dashIndex < 0) return \"*\".repeat(formatted.length);\n  if (showControlDigit) {\n    return `${\"*\".repeat(dashIndex)}-${formatted.slice(dashIndex + 1)}`;\n  }\n  return `${formatted.slice(0, dashIndex)}-${\"*\".repeat(formatted.length - dashIndex - 1)}`;\n}\n"],
+  "mappings": "AACA,SAAS,YAAY,qBAAqB;AAC1C,SAAS,mBAAmB;AAC5B,SAAS,6BAA6B;AACtC,SAAS,qBAAqB;AAC9B,SAAS,2BAA2B;AACpC,SAA2B,aAAa,qBAAqB;AAC7D,SAAS,6BAA6B;AAEtC,MAAM,mBAAmB;AACzB,MAAM,gBAAgB;AAMf,MAAM,sBAAsB;AAAA,EACjC,OAAgB,WAA8B,OAAO,OAAO;AAAA,IAC1D,aAAa;AAAA,IACb,eAAe;AAAA,IACf,OAAO;AAAA,IACP,SAAS,OAAO,OAAO;AAAA,MACrB;AAAA,MACA;AAAA,IACF,CAAC;AAAA,EACH,CAAC;AAAA,EAED,OAAgB,cAAc;AAAA,EAC9B,OAAgB,mBAAmB;AAAA;AAAA,EAG1B;AAAA;AAAA,EAEA;AAAA,EAED,YAAY,QAAgB,WAAmB;AACrD,SAAK,SAAS;AACd,SAAK,YAAY;AAAA,EACnB;AAAA,EAEA,OAAO,SAAS,OAAgE;AAC9E,QAAI,SAAS,QAAQ,MAAM,KAAK,MAAM,GAAI,QAAO;AACjD,UAAM,SAAS,WAAW,cAAc,KAAK,CAAC;AAC9C,QAAI,OAAO,SAAS,iBAAkB,QAAO;AAC7C,QAAI,CAAC,cAAc,KAAK,MAAM,EAAG,QAAO;AACxC,QAAI,CAAC,YAAY,MAAM,EAAG,QAAO;AAEjC,UAAM,OAAO,OAAO,MAAM,GAAG,OAAO,SAAS,CAAC;AAC9C,UAAM,UAAU,OAAO,MAAM,OAAO,SAAS,CAAC;AAC9C,WAAO,IAAI,sBAAsB,QAAQ,GAAG,IAAI,IAAI,OAAO,EAAE;AAAA,EAC/D;AAAA,EAEA,OAAO,MAAM,OAAsC;AACjD,UAAM,IAAI,sBAAsB,SAAS,KAAK;AAC9C,QAAI,MAAM,KAAM,OAAM,IAAI,MAAM,0BAA0B;AAC1D,WAAO;AAAA,EACT;AAAA,EAEA,OAAO,QAAQ,OAA2C;AACxD,WAAO,sBAAsB,SAAS,KAAK,MAAM;AAAA,EACnD;AAAA,EAEA,OAAO,OACL,OACA,SACe;AACf,UAAM,IAAI,sBAAsB,SAAS,KAAK;AAC9C,QAAI,EAAG,QAAO,EAAE;AAChB,QAAI,SAAS,qCAAqC,SAAS,QAAQ,MAAM,KAAK,MAAM,IAAI;AACtF,aAAO,MAAM,KAAK;AAAA,IACpB;AACA,WAAO;AAAA,EACT;AAAA,EAEA,OAAO,UACL,OACA,SACe;AACf,WAAO,sBAAsB,OAAO,OAAO,OAAO;AAAA,EACpD;AAAA,EAEA,OAAO,aAAa,OAA2C;AAC7D,WAAO,SAAS,QAAQ,sBAAsB,UAAU,KAAK,MAAM;AAAA,EACrE;AAAA,EAEA,qBAA6B;AAC3B,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,kBAA0B;AACxB,WAAO,GAAG,sBAAsB,WAAW,IAAI,KAAK,SAAS;AAAA,EAC/D;AAAA,EAEA,uBAA+B;AAC7B,WAAO,GAAG,sBAAsB,gBAAgB,IAAI,KAAK,SAAS;AAAA,EACpE;AAAA,EAEA,WAAmB;AACjB,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,OAAO,SAAS,OAAoD;AAClE,QAAI,SAAS,QAAQ,MAAM,KAAK,MAAM;AACpC,aAAO;AAAA,QACL;AAAA,QACA,sBAAsB;AAAA,QACtB;AAAA,QACA;AAAA,MACF;AAEF,UAAM,SAAS,WAAW,cAAc,KAAK,CAAC;AAE9C,QAAI,OAAO,SAAS;AAClB,aAAO;AAAA,QACL;AAAA,QACA,sBAAsB;AAAA,QACtB;AAAA,QACA;AAAA,MACF;AAEF,QAAI,CAAC,cAAc,KAAK,MAAM;AAC5B,aAAO;AAAA,QACL;AAAA,QACA,sBAAsB;AAAA,QACtB;AAAA,QACA;AAAA,MACF;AAEF,QAAI,CAAC,YAAY,MAAM;AACrB,aAAO;AAAA,QACL;AAAA,QACA,sBAAsB;AAAA,QACtB;AAAA,QACA;AAAA,MACF;AAEF,WAAO,YAAY,KAAK;AAAA,EAC1B;AAAA,EAEA,OAAO,qBAAqB,MAA+D;AACzF,QAAI,CAAC,KAAM,QAAO,CAAC;AACnB,UAAM,MAA8C,CAAC;AACrD,UAAM,KAAK;AACX,QAAI;AACJ,YAAQ,IAAI,GAAG,KAAK,IAAI,OAAO,MAAM;AACnC,YAAM,IAAI,sBAAsB,SAAS,EAAE,CAAC,CAAC;AAC7C,UAAI,CAAC,EAAG;AACR,UAAI;AAAA,QACF,IAAI,cAAqC;AAAA,UACvC,YAAY,EAAE;AAAA,UACd,QAAQ,EAAE,CAAC,EAAE;AAAA,UACb,cAAc,EAAE,CAAC;AAAA,UACjB,UAAU;AAAA,UACV,UAAU,sBAAsB;AAAA,UAChC,gBAAgB,EAAE,mBAAmB;AAAA,UACrC,eAAe,EAAE,SAAS;AAAA,UAC1B,YAAY,0BAA0B,CAAC;AAAA,UACvC,YAAY,oBAAoB;AAAA,UAChC,OAAO;AAAA,QACT,CAAC;AAAA,MACH;AAAA,IACF;AACA,WAAO;AAAA,EACT;AAAA,EAEA,OAAO,OAA0D;AAC/D,WAAO,SAAS,QAAQ,KAAK,cAAc,MAAM;AAAA,EACnD;AAAA,EACA,UAAU,OAAyD;AACjE,QAAI,SAAS,KAAM,QAAO;AAC1B,WAAO,KAAK,YAAY,MAAM,YAAY,KAAK,KAAK,YAAY,MAAM,YAAY,IAAI;AAAA,EACxF;AACF;AAMO,SAAS,0BACd,IACA,SACQ;AACR,QAAM,mBAAmB,SAAS,oBAAoB;AACtD,QAAM,YAAY,GAAG;AACrB,QAAM,YAAY,UAAU,QAAQ,GAAG;AACvC,MAAI,YAAY,EAAG,QAAO,IAAI,OAAO,UAAU,MAAM;AACrD,MAAI,kBAAkB;AACpB,WAAO,GAAG,IAAI,OAAO,SAAS,CAAC,IAAI,UAAU,MAAM,YAAY,CAAC,CAAC;AAAA,EACnE;AACA,SAAO,GAAG,UAAU,MAAM,GAAG,SAAS,CAAC,IAAI,IAAI,OAAO,UAAU,SAAS,YAAY,CAAC,CAAC;AACzF;",
+  "names": []
+}