@budiauktioner/buildi-primitives 0.1.1 → 0.2.1

package/dist/cjs/contact/address-street.js

@@ -0,0 +1,220 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var address_street_exports = {};
+__export(address_street_exports, {
+  AddressStreet: () => AddressStreet
+});
+module.exports = __toCommonJS(address_street_exports);
+var import_primitives_defaults = require("../primitives-defaults.js");
+var import_input_sanitization = require("../internal/input-sanitization.js");
+const MAX_INPUT_LENGTH = 200;
+const ADDRESS_PATTERN = /^[\p{L}0-9\s,.:'/-]+$/u;
+const CARE_OF = /^c[/.]o\.?\s+/i;
+const APARTMENT = /[,\s]+(?:lgh\.?|lägenhet|apt\.?)\s*(\d+\w*)\s*$/iu;
+const BOX = /^(?:p\.?o\.?\s*)?box\s+(\d{1,7})\s*$/i;
+const STREET_NUMBER = /^(.*?)\s+(\d+[A-ZÅÄÖ]*)$/u;
+class AddressStreet {
+  static typeInfo = Object.freeze({
+    englishName: "Street Address",
+    localizedName: "Gatuadress",
+    emoji: "\u{1F6E3}\uFE0F",
+    sources: Object.freeze(["https://www.lantmateriet.se/"])
+  });
+  street;
+  streetName;
+  streetNumber;
+  apartmentNumber;
+  careOf;
+  postBox;
+  constructor(street, streetName, streetNumber, apartmentNumber, careOf, postBox) {
+    this.street = street;
+    this.streetName = streetName;
+    this.streetNumber = streetNumber;
+    this.apartmentNumber = apartmentNumber;
+    this.careOf = careOf;
+    this.postBox = postBox;
+  }
+  get isPostBox() {
+    return this.postBox !== null;
+  }
+  static tryParse(input, options) {
+    if (input == null || input.trim() === "") return null;
+    let text = (0, import_input_sanitization.collapseWhitespace)(input);
+    if (text.length === 0 || text.length > MAX_INPUT_LENGTH) return null;
+    let careOf = null;
+    const co = text.match(CARE_OF);
+    if (co) {
+      const after = text.slice(co[0].length);
+      const comma = after.indexOf(",");
+      if (comma >= 0) {
+        careOf = after.slice(0, comma).trim();
+        text = after.slice(comma + 1).trim();
+      } else {
+        careOf = after.trim();
+        text = "";
+      }
+      if (careOf.trim() === "") careOf = null;
+    }
+    if (text.trim() !== "") {
+      const boxText = (0, import_input_sanitization.collapseWhitespace)(text.replace(/,/g, " "));
+      const boxMatch = boxText.match(BOX);
+      if (boxMatch) {
+        const postBox = boxMatch[1];
+        return new AddressStreet(`Box ${postBox}`, null, null, null, careOf, postBox);
+      }
+    }
+    if (text.trim() === "") {
+      if (careOf !== null) {
+        return new AddressStreet(`c/o ${careOf}`, null, null, null, careOf, null);
+      }
+      return null;
+    }
+    let apartment = null;
+    const apt = text.match(APARTMENT);
+    if (apt) {
+      apartment = apt[1];
+      text = text.slice(0, apt.index).trim();
+    }
+    const normalized = normalizeStreet(text, options?.city ?? null, options?.zipCode ?? null);
+    if (!validateStreet(normalized)) return null;
+    let streetName = null;
+    let streetNumber = null;
+    const num = normalized.match(STREET_NUMBER);
+    if (num) {
+      streetName = num[1];
+      streetNumber = num[2];
+    }
+    return new AddressStreet(normalized, streetName, streetNumber, apartment, careOf, null);
+  }
+  static parse(input) {
+    const r = AddressStreet.tryParse(input);
+    if (r === null) throw new Error("Invalid street address.");
+    return r;
+  }
+  static isValid(input) {
+    return AddressStreet.tryParse(input) !== null;
+  }
+  static format(input, options) {
+    const r = AddressStreet.tryParse(input);
+    if (r) return r.street;
+    if (options?.fallbackToTrimmedInputWhenInvalid && input != null && input.trim() !== "") {
+      return input.trim();
+    }
+    return null;
+  }
+  static normalize(input, options) {
+    return AddressStreet.format(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && AddressStreet.normalize(input) === input;
+  }
+  toNormalizedString() {
+    return this.street;
+  }
+  toString() {
+    return this.street;
+  }
+  equals(other) {
+    return other != null && this.street === other.street;
+  }
+  compareTo(other) {
+    if (other == null) return 1;
+    return this.street < other.street ? -1 : this.street > other.street ? 1 : 0;
+  }
+}
+function normalizeStreet(input, city, zip) {
+  let cleaned = (0, import_input_sanitization.collapseWhitespace)(input);
+  if (cleaned === "") return "";
+  cleaned = (0, import_input_sanitization.collapseWhitespace)(cleaned.replace(/,/g, " "));
+  cleaned = cleaned.replace(/(\p{L})(\d+\p{L}*)$/u, "$1 $2");
+  cleaned = (0, import_input_sanitization.collapseWhitespace)(cleaned);
+  let stripped = removeTrailingCityAndZip(cleaned, city, zip);
+  if (shouldSentenceCase(stripped)) stripped = toSentenceCase(stripped);
+  stripped = uppercaseHouseNumberSuffixes(stripped);
+  return stripped;
+}
+function validateStreet(addr) {
+  if (!addr || addr.trim() === "") return false;
+  if (/[\p{Cc}]/u.test(addr)) return false;
+  if (addr !== addr.trim()) return false;
+  if (addr.includes("  ")) return false;
+  if (addr.length < 5 || addr.length > 50) return false;
+  if (/[\p{Cn}]/u.test(addr)) return false;
+  return ADDRESS_PATTERN.test(addr);
+}
+function shouldSentenceCase(input) {
+  if (!input || input.trim() === "") return false;
+  const letters = [...input].filter((c) => /\p{L}/u.test(c));
+  if (letters.length === 0) return false;
+  const allUpper = letters.every((c) => c === c.toLocaleUpperCase(import_primitives_defaults.PrimitivesDefaults.culture));
+  let firstLetterIndex = -1;
+  for (let i = 0; i < input.length; i++) {
+    if (/\p{L}/u.test(input[i])) {
+      firstLetterIndex = i;
+      break;
+    }
+  }
+  if (firstLetterIndex === -1) return allUpper;
+  const startsWithUpper = input[firstLetterIndex] === input[firstLetterIndex].toLocaleUpperCase(import_primitives_defaults.PrimitivesDefaults.culture);
+  return allUpper || !startsWithUpper;
+}
+function toSentenceCase(input) {
+  if (!input || input.trim() === "") return "";
+  const culture = import_primitives_defaults.PrimitivesDefaults.culture;
+  const lowered = input.toLocaleLowerCase(culture);
+  let out = lowered;
+  for (let i = 0; i < lowered.length; i++) {
+    if (/\p{L}/u.test(lowered[i])) {
+      out = lowered.slice(0, i) + lowered[i].toLocaleUpperCase(culture) + lowered.slice(i + 1);
+      break;
+    }
+  }
+  return uppercaseHouseNumberSuffixes(out);
+}
+function uppercaseHouseNumberSuffixes(input) {
+  return input.replace(
+    /(\d+)(\p{L}+)(?=[^\p{L}\d]|$)/gu,
+    (_, d, s) => d + s.toLocaleUpperCase(import_primitives_defaults.PrimitivesDefaults.culture)
+  );
+}
+function removeTrailingCityAndZip(street, city, zip) {
+  const cityNorm = city == null ? "" : (0, import_input_sanitization.collapseWhitespace)(city);
+  const zipNorm = zip == null ? "" : (0, import_input_sanitization.collapseWhitespace)(zip);
+  const cityU = cityNorm.toUpperCase();
+  const zipU = zipNorm.toUpperCase();
+  const zipNoSpaceU = zipNorm.replace(/ /g, "").toUpperCase();
+  const orig = (0, import_input_sanitization.collapseWhitespace)(street.replace(/,/g, " "));
+  const upper = orig.toUpperCase();
+  const has = (s) => s.length > 0;
+  const removeTail = (s, tail) => tail <= 0 || tail > s.length ? s : (0, import_input_sanitization.collapseWhitespace)(s.slice(0, s.length - tail));
+  if (has(cityU) && has(zipU) && upper.endsWith(` ${zipU} ${cityU}`))
+    return removeTail(orig, (zipU + " " + cityU).length);
+  if (has(cityU) && has(zipNoSpaceU) && upper.endsWith(` ${zipNoSpaceU} ${cityU}`))
+    return removeTail(orig, (zipNoSpaceU + " " + cityU).length);
+  if (has(cityU) && has(zipU) && upper.endsWith(` ${cityU} ${zipU}`))
+    return removeTail(orig, (cityU + " " + zipU).length);
+  if (has(cityU) && has(zipNoSpaceU) && upper.endsWith(` ${cityU} ${zipNoSpaceU}`))
+    return removeTail(orig, (cityU + " " + zipNoSpaceU).length);
+  if (has(cityU) && upper.endsWith(` ${cityU}`)) return removeTail(orig, cityU.length);
+  if (has(zipU) && upper.endsWith(` ${zipU}`)) return removeTail(orig, zipU.length);
+  if (has(zipNoSpaceU) && upper.endsWith(` ${zipNoSpaceU}`))
+    return removeTail(orig, zipNoSpaceU.length);
+  return orig;
+}
+//# sourceMappingURL=address-street.js.map

package/dist/cjs/contact/address-street.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/contact/address-street.ts"],
+  "sourcesContent": ["import { PrimitiveTypeInfo } from \"../primitive-type-info.js\";\nimport { PrimitivesDefaults } from \"../primitives-defaults.js\";\nimport { collapseWhitespace } from \"../internal/input-sanitization.js\";\n\nconst MAX_INPUT_LENGTH = 200;\n\nconst ADDRESS_PATTERN = /^[\\p{L}0-9\\s,.:'/-]+$/u;\nconst CARE_OF = /^c[/.]o\\.?\\s+/i;\nconst APARTMENT = /[,\\s]+(?:lgh\\.?|l\u00E4genhet|apt\\.?)\\s*(\\d+\\w*)\\s*$/iu;\nconst BOX = /^(?:p\\.?o\\.?\\s*)?box\\s+(\\d{1,7})\\s*$/i;\nconst STREET_NUMBER = /^(.*?)\\s+(\\d+[A-Z\u00C5\u00C4\u00D6]*)$/u;\n\n/**\n * A street address (`gatuadress`). Extracts care-of (c/o), apartment number\n * (lgh/apt), and post box (Box) when present.\n */\nexport class AddressStreet {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Street Address\",\n    localizedName: \"Gatuadress\",\n    emoji: \"\\u{1F6E3}\\uFE0F\",\n    sources: Object.freeze([\"https://www.lantmateriet.se/\"]),\n  });\n\n  readonly street: string;\n  readonly streetName: string | null;\n  readonly streetNumber: string | null;\n  readonly apartmentNumber: string | null;\n  readonly careOf: string | null;\n  readonly postBox: string | null;\n\n  private constructor(\n    street: string,\n    streetName: string | null,\n    streetNumber: string | null,\n    apartmentNumber: string | null,\n    careOf: string | null,\n    postBox: string | null,\n  ) {\n    this.street = street;\n    this.streetName = streetName;\n    this.streetNumber = streetNumber;\n    this.apartmentNumber = apartmentNumber;\n    this.careOf = careOf;\n    this.postBox = postBox;\n  }\n\n  get isPostBox(): boolean {\n    return this.postBox !== null;\n  }\n\n  static tryParse(\n    input: string | null | undefined,\n    options?: { city?: string | null; zipCode?: string | null },\n  ): AddressStreet | null {\n    if (input == null || input.trim() === \"\") return null;\n\n    let text = collapseWhitespace(input);\n    if (text.length === 0 || text.length > MAX_INPUT_LENGTH) return null;\n\n    let careOf: string | null = null;\n    const co = text.match(CARE_OF);\n    if (co) {\n      const after = text.slice(co[0].length);\n      const comma = after.indexOf(\",\");\n      if (comma >= 0) {\n        careOf = after.slice(0, comma).trim();\n        text = after.slice(comma + 1).trim();\n      } else {\n        careOf = after.trim();\n        text = \"\";\n      }\n      if (careOf.trim() === \"\") careOf = null;\n    }\n\n    if (text.trim() !== \"\") {\n      const boxText = collapseWhitespace(text.replace(/,/g, \" \"));\n      const boxMatch = boxText.match(BOX);\n      if (boxMatch) {\n        const postBox = boxMatch[1]!;\n        return new AddressStreet(`Box ${postBox}`, null, null, null, careOf, postBox);\n      }\n    }\n\n    if (text.trim() === \"\") {\n      if (careOf !== null) {\n        return new AddressStreet(`c/o ${careOf}`, null, null, null, careOf, null);\n      }\n      return null;\n    }\n\n    let apartment: string | null = null;\n    const apt = text.match(APARTMENT);\n    if (apt) {\n      apartment = apt[1]!;\n      text = text.slice(0, apt.index!).trim();\n    }\n\n    const normalized = normalizeStreet(text, options?.city ?? null, options?.zipCode ?? null);\n    if (!validateStreet(normalized)) return null;\n\n    let streetName: string | null = null;\n    let streetNumber: string | null = null;\n    const num = normalized.match(STREET_NUMBER);\n    if (num) {\n      streetName = num[1]!;\n      streetNumber = num[2]!;\n    }\n\n    return new AddressStreet(normalized, streetName, streetNumber, apartment, careOf, null);\n  }\n\n  static parse(input: string): AddressStreet {\n    const r = AddressStreet.tryParse(input);\n    if (r === null) throw new Error(\"Invalid street address.\");\n    return r;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return AddressStreet.tryParse(input) !== null;\n  }\n\n  static format(\n    input: string | null | undefined,\n    options?: { fallbackToTrimmedInputWhenInvalid?: boolean },\n  ): string | null {\n    const r = AddressStreet.tryParse(input);\n    if (r) return r.street;\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 AddressStreet.format(input, options);\n  }\n\n  static isNormalized(input: string | null | undefined): boolean {\n    return input != null && AddressStreet.normalize(input) === input;\n  }\n\n  toNormalizedString(): string {\n    return this.street;\n  }\n  toString(): string {\n    return this.street;\n  }\n\n  equals(other: AddressStreet | null | undefined): boolean {\n    return other != null && this.street === other.street;\n  }\n  compareTo(other: AddressStreet | null | undefined): number {\n    if (other == null) return 1;\n    return this.street < other.street ? -1 : this.street > other.street ? 1 : 0;\n  }\n}\n\nfunction normalizeStreet(input: string, city: string | null, zip: string | null): string {\n  let cleaned = collapseWhitespace(input);\n  if (cleaned === \"\") return \"\";\n  cleaned = collapseWhitespace(cleaned.replace(/,/g, \" \"));\n  cleaned = cleaned.replace(/(\\p{L})(\\d+\\p{L}*)$/u, \"$1 $2\");\n  cleaned = collapseWhitespace(cleaned);\n  let stripped = removeTrailingCityAndZip(cleaned, city, zip);\n  if (shouldSentenceCase(stripped)) stripped = toSentenceCase(stripped);\n  stripped = uppercaseHouseNumberSuffixes(stripped);\n  return stripped;\n}\n\nfunction validateStreet(addr: string): boolean {\n  if (!addr || addr.trim() === \"\") return false;\n  if (/[\\p{Cc}]/u.test(addr)) return false;\n  if (addr !== addr.trim()) return false;\n  if (addr.includes(\"  \")) return false;\n  if (addr.length < 5 || addr.length > 50) return false;\n  if (/[\\p{Cn}]/u.test(addr)) return false;\n  return ADDRESS_PATTERN.test(addr);\n}\n\nfunction shouldSentenceCase(input: string): boolean {\n  if (!input || input.trim() === \"\") return false;\n  const letters = [...input].filter((c) => /\\p{L}/u.test(c));\n  if (letters.length === 0) return false;\n  const allUpper = letters.every((c) => c === c.toLocaleUpperCase(PrimitivesDefaults.culture));\n  let firstLetterIndex = -1;\n  for (let i = 0; i < input.length; i++) {\n    if (/\\p{L}/u.test(input[i]!)) {\n      firstLetterIndex = i;\n      break;\n    }\n  }\n  if (firstLetterIndex === -1) return allUpper;\n  const startsWithUpper =\n    input[firstLetterIndex] ===\n    input[firstLetterIndex]!.toLocaleUpperCase(PrimitivesDefaults.culture);\n  return allUpper || !startsWithUpper;\n}\n\nfunction toSentenceCase(input: string): string {\n  if (!input || input.trim() === \"\") return \"\";\n  const culture = PrimitivesDefaults.culture;\n  const lowered = input.toLocaleLowerCase(culture);\n  let out = lowered;\n  for (let i = 0; i < lowered.length; i++) {\n    if (/\\p{L}/u.test(lowered[i]!)) {\n      out = lowered.slice(0, i) + lowered[i]!.toLocaleUpperCase(culture) + lowered.slice(i + 1);\n      break;\n    }\n  }\n  return uppercaseHouseNumberSuffixes(out);\n}\n\nfunction uppercaseHouseNumberSuffixes(input: string): string {\n  return input.replace(\n    /(\\d+)(\\p{L}+)(?=[^\\p{L}\\d]|$)/gu,\n    (_, d: string, s: string) => d + s.toLocaleUpperCase(PrimitivesDefaults.culture),\n  );\n}\n\nfunction removeTrailingCityAndZip(street: string, city: string | null, zip: string | null): string {\n  const cityNorm = city == null ? \"\" : collapseWhitespace(city);\n  const zipNorm = zip == null ? \"\" : collapseWhitespace(zip);\n  const cityU = cityNorm.toUpperCase();\n  const zipU = zipNorm.toUpperCase();\n  const zipNoSpaceU = zipNorm.replace(/ /g, \"\").toUpperCase();\n  const orig = collapseWhitespace(street.replace(/,/g, \" \"));\n  const upper = orig.toUpperCase();\n\n  const has = (s: string) => s.length > 0;\n  const removeTail = (s: string, tail: number) =>\n    tail <= 0 || tail > s.length ? s : collapseWhitespace(s.slice(0, s.length - tail));\n\n  if (has(cityU) && has(zipU) && upper.endsWith(` ${zipU} ${cityU}`))\n    return removeTail(orig, (zipU + \" \" + cityU).length);\n  if (has(cityU) && has(zipNoSpaceU) && upper.endsWith(` ${zipNoSpaceU} ${cityU}`))\n    return removeTail(orig, (zipNoSpaceU + \" \" + cityU).length);\n  if (has(cityU) && has(zipU) && upper.endsWith(` ${cityU} ${zipU}`))\n    return removeTail(orig, (cityU + \" \" + zipU).length);\n  if (has(cityU) && has(zipNoSpaceU) && upper.endsWith(` ${cityU} ${zipNoSpaceU}`))\n    return removeTail(orig, (cityU + \" \" + zipNoSpaceU).length);\n  if (has(cityU) && upper.endsWith(` ${cityU}`)) return removeTail(orig, cityU.length);\n  if (has(zipU) && upper.endsWith(` ${zipU}`)) return removeTail(orig, zipU.length);\n  if (has(zipNoSpaceU) && upper.endsWith(` ${zipNoSpaceU}`))\n    return removeTail(orig, zipNoSpaceU.length);\n  return orig;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/cjs/contact/address-zip-code.js

@@ -0,0 +1,195 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var address_zip_code_exports = {};
+__export(address_zip_code_exports, {
+  AddressZipCode: () => AddressZipCode,
+  maskZip: () => maskZip
+});
+module.exports = __toCommonJS(address_zip_code_exports);
+var import_primitives_defaults = require("../primitives-defaults.js");
+var import_input_sanitization = require("../internal/input-sanitization.js");
+var import_text_candidate_category = require("../text-scanning/text-candidate-category.js");
+var import_text_candidate = require("../text-scanning/text-candidate.js");
+var import_text_match_confidence = require("../text-scanning/text-match-confidence.js");
+var import_geography = require("../geography/index.js");
+const MAX_INPUT_LENGTH = 20;
+const SWEDISH_DIGITS = /^\d{5}$/;
+const INTERNATIONAL = /^(?:[0-9]{3}|[0-9]{4}|[0-9]{3}\s?[0-9]{2}|[0-9]{6}|[0-9]{7}|[0-9]{4}\s?[A-Z]{2}|[A-Z]{3}\s?[0-9]{4}|980[0-9]{2}|(?:[A-Z][0-9]|[A-Z][0-9][A-Z]|[A-Z]{2}[0-9]|[A-Z]{2}[0-9][A-Z])\s?[0-9][A-Z]{2}|[A-Z0-9]{7}|[A-Z]{2}[0-9]{3}|LT-?[0-9]{5}|LV-?[0-9]{4}|MD-?[0-9]{4}|DK[-\s]?[0-9]{4})$/;
+const SCAN = /(?<!\d)\d{3}\s?\d{2}(?!\d)/g;
+class AddressZipCode {
+  static typeInfo = Object.freeze({
+    englishName: "Zip Code",
+    localizedName: "Postnummer",
+    emoji: "\u{1F4EE}",
+    sources: Object.freeze([
+      "https://www.postnord.se/",
+      "https://sv.wikipedia.org/wiki/Postnummer_i_Sverige"
+    ])
+  });
+  value;
+  formatted;
+  country;
+  constructor(value, formatted, country) {
+    this.value = value;
+    this.formatted = formatted;
+    this.country = country;
+  }
+  get isSwedish() {
+    return this.country?.alpha2Code === "SE";
+  }
+  static tryParse(input, options) {
+    if (input == null) return null;
+    const sanitized = (0, import_input_sanitization.sanitizeInput)(input).trim();
+    if (sanitized.length === 0 || sanitized.length > MAX_INPUT_LENGTH) return null;
+    const country = options?.country ?? null;
+    const effectiveCountry = country?.alpha2Code ?? import_primitives_defaults.PrimitivesDefaults.countryAlpha2Code;
+    if (country?.alpha2Code === "SE") return AddressZipCode.tryParseSwedish(sanitized);
+    if (country) {
+      const intl = AddressZipCode.tryParseInternational(sanitized, country);
+      if (intl) return intl;
+      return null;
+    }
+    if (effectiveCountry === "SE") {
+      return AddressZipCode.tryParseSwedish(sanitized) ?? AddressZipCode.tryParseInternational(sanitized);
+    }
+    return AddressZipCode.tryParseInternational(sanitized) ?? AddressZipCode.tryParseSwedish(sanitized);
+  }
+  static parse(input, options) {
+    const r = AddressZipCode.tryParse(input, options);
+    if (r === null) throw new Error("Invalid zip code.");
+    return r;
+  }
+  static isValid(input, options) {
+    return AddressZipCode.tryParse(input, options) !== null;
+  }
+  /** Parse as a Swedish 5-digit postal code only. */
+  static tryParseSwedish(input) {
+    if (input == null) return null;
+    let cleaned = input.toString();
+    for (let i = 0; i < cleaned.length; i++) {
+      if (/\p{L}/u.test(cleaned[i])) {
+        cleaned = cleaned.slice(0, i).trimEnd();
+        break;
+      }
+    }
+    if (cleaned.length === 0) return null;
+    const digits = (0, import_input_sanitization.keepDigits)(cleaned);
+    if (!SWEDISH_DIGITS.test(digits)) return null;
+    const formatted = `${digits.slice(0, 3)} ${digits.slice(3)}`;
+    return new AddressZipCode(digits, formatted, import_geography.Country.Sweden);
+  }
+  /** Parse as a non-Swedish international postal code. */
+  static tryParseInternational(input, country = null) {
+    if (input == null) return null;
+    const trimmed = input.toString();
+    if (trimmed.length === 0) return null;
+    if (/[\p{Cc}]/u.test(trimmed)) return null;
+    if (![...trimmed].every((c) => /[\p{L}\p{N}]/u.test(c) || /\s/.test(c) || c === "-")) {
+      return null;
+    }
+    const normalized = normalizeInternational(trimmed);
+    if (!normalized) return null;
+    if (!INTERNATIONAL.test(normalized)) return null;
+    const resolved = country ?? inferCountryFromPrefix(normalized);
+    return new AddressZipCode(normalized, normalized, resolved);
+  }
+  static format(input, options) {
+    const r = AddressZipCode.tryParse(input, options);
+    if (r) return r.formatted;
+    if (options?.fallbackToTrimmedInputWhenInvalid && input != null && input.trim() !== "") {
+      return input.trim();
+    }
+    return null;
+  }
+  static normalize(input, options) {
+    const r = AddressZipCode.tryParse(input, options);
+    if (r) return r.value;
+    if (options?.fallbackToTrimmedInputWhenInvalid && input != null) {
+      const trimmed = input.trim();
+      return trimmed.length > 0 ? trimmed : null;
+    }
+    return null;
+  }
+  static isNormalized(input) {
+    return input != null && AddressZipCode.normalize(input) === input;
+  }
+  static findCandidatesInText(text) {
+    if (!text) return [];
+    const out = [];
+    SCAN.lastIndex = 0;
+    let m;
+    while ((m = SCAN.exec(text)) !== null) {
+      const zip = AddressZipCode.tryParseSwedish(m[0]);
+      if (!zip) continue;
+      out.push(
+        new import_text_candidate.TextCandidate({
+          startIndex: m.index,
+          length: m[0].length,
+          originalText: m[0],
+          typeName: "AddressZipCode",
+          category: import_text_candidate_category.TextCandidateCategory.Contact,
+          normalizedForm: zip.toNormalizedString(),
+          formattedForm: zip.toString(),
+          maskedForm: maskZip(zip),
+          confidence: import_text_match_confidence.TextMatchConfidence.Low,
+          value: zip
+        })
+      );
+    }
+    return out;
+  }
+  toNormalizedString() {
+    return this.value;
+  }
+  toString() {
+    return this.formatted;
+  }
+  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 normalizeInternational(input) {
+  let cleaned = input.trim().toUpperCase().replace(/\s+/g, "");
+  const digits = (0, import_input_sanitization.keepDigits)(cleaned);
+  if (cleaned.startsWith("DK") && digits.length === 4) return `DK-${digits}`;
+  if (cleaned.startsWith("LV") && digits.length === 4) return `LV-${digits}`;
+  if (cleaned.startsWith("MD") && digits.length === 4) return `MD-${digits}`;
+  if (cleaned.startsWith("AD") && digits.length === 3) return `AD${digits}`;
+  cleaned = cleaned.replace(/[^A-Z0-9-]/g, "");
+  if (/^\d+-\d+$/.test(cleaned)) return cleaned.replace(/-/g, "");
+  return cleaned;
+}
+function inferCountryFromPrefix(normalized) {
+  if (normalized.startsWith("DK-")) return import_geography.Country.Denmark;
+  if (normalized.startsWith("LV-")) return import_geography.Country.Latvia;
+  if (normalized.startsWith("MD-")) return import_geography.Country.tryParse("MD");
+  if (normalized.startsWith("AD") && normalized.length === 5 && /^\d+$/.test(normalized.slice(2))) {
+    return import_geography.Country.tryParse("AD");
+  }
+  return null;
+}
+function maskZip(zip) {
+  const f = zip.formatted;
+  return f.replace(/\d/g, "*");
+}
+//# sourceMappingURL=address-zip-code.js.map

package/dist/cjs/contact/address-zip-code.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/contact/address-zip-code.ts"],
+  "sourcesContent": ["import { PrimitiveTypeInfo } from \"../primitive-type-info.js\";\nimport { PrimitivesDefaults } from \"../primitives-defaults.js\";\nimport { keepDigits, sanitizeInput } from \"../internal/input-sanitization.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 { Country } from \"../geography/index.js\";\n\nconst MAX_INPUT_LENGTH = 20;\n\nconst SWEDISH_DIGITS = /^\\d{5}$/;\nconst INTERNATIONAL =\n  /^(?:[0-9]{3}|[0-9]{4}|[0-9]{3}\\s?[0-9]{2}|[0-9]{6}|[0-9]{7}|[0-9]{4}\\s?[A-Z]{2}|[A-Z]{3}\\s?[0-9]{4}|980[0-9]{2}|(?:[A-Z][0-9]|[A-Z][0-9][A-Z]|[A-Z]{2}[0-9]|[A-Z]{2}[0-9][A-Z])\\s?[0-9][A-Z]{2}|[A-Z0-9]{7}|[A-Z]{2}[0-9]{3}|LT-?[0-9]{5}|LV-?[0-9]{4}|MD-?[0-9]{4}|DK[-\\s]?[0-9]{4})$/;\n\nconst SCAN = /(?<!\\d)\\d{3}\\s?\\d{2}(?!\\d)/g;\n\n/**\n * A postal code (`postnummer`). Swedish 5-digit codes (formatted `NNN NN`) and\n * many international formats (Danish `DK-9000`, Dutch `1012 AB`, British `W1A 1AB`)\n * are accepted.\n */\nexport class AddressZipCode {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Zip Code\",\n    localizedName: \"Postnummer\",\n    emoji: \"\\u{1F4EE}\",\n    sources: Object.freeze([\n      \"https://www.postnord.se/\",\n      \"https://sv.wikipedia.org/wiki/Postnummer_i_Sverige\",\n    ]),\n  });\n\n  readonly value: string;\n  readonly formatted: string;\n  readonly country: Country | null;\n\n  private constructor(value: string, formatted: string, country: Country | null) {\n    this.value = value;\n    this.formatted = formatted;\n    this.country = country;\n  }\n\n  get isSwedish(): boolean {\n    return this.country?.alpha2Code === \"SE\";\n  }\n\n  static tryParse(\n    input: string | null | undefined,\n    options?: { country?: Country | null },\n  ): AddressZipCode | null {\n    if (input == null) return null;\n    const sanitized = sanitizeInput(input).trim();\n    if (sanitized.length === 0 || sanitized.length > MAX_INPUT_LENGTH) return null;\n\n    const country = options?.country ?? null;\n    const effectiveCountry = country?.alpha2Code ?? PrimitivesDefaults.countryAlpha2Code;\n\n    if (country?.alpha2Code === \"SE\") return AddressZipCode.tryParseSwedish(sanitized);\n\n    if (country) {\n      const intl = AddressZipCode.tryParseInternational(sanitized, country);\n      if (intl) return intl;\n      return null;\n    }\n\n    if (effectiveCountry === \"SE\") {\n      return (\n        AddressZipCode.tryParseSwedish(sanitized) ?? AddressZipCode.tryParseInternational(sanitized)\n      );\n    }\n    return (\n      AddressZipCode.tryParseInternational(sanitized) ?? AddressZipCode.tryParseSwedish(sanitized)\n    );\n  }\n\n  static parse(input: string, options?: { country?: Country | null }): AddressZipCode {\n    const r = AddressZipCode.tryParse(input, options);\n    if (r === null) throw new Error(\"Invalid zip code.\");\n    return r;\n  }\n\n  static isValid(\n    input: string | null | undefined,\n    options?: { country?: Country | null },\n  ): boolean {\n    return AddressZipCode.tryParse(input, options) !== null;\n  }\n\n  /** Parse as a Swedish 5-digit postal code only. */\n  static tryParseSwedish(input: string | null | undefined): AddressZipCode | null {\n    if (input == null) return null;\n    let cleaned = input.toString();\n    for (let i = 0; i < cleaned.length; i++) {\n      if (/\\p{L}/u.test(cleaned[i]!)) {\n        cleaned = cleaned.slice(0, i).trimEnd();\n        break;\n      }\n    }\n    if (cleaned.length === 0) return null;\n    const digits = keepDigits(cleaned);\n    if (!SWEDISH_DIGITS.test(digits)) return null;\n    const formatted = `${digits.slice(0, 3)} ${digits.slice(3)}`;\n    return new AddressZipCode(digits, formatted, Country.Sweden);\n  }\n\n  /** Parse as a non-Swedish international postal code. */\n  static tryParseInternational(\n    input: string | null | undefined,\n    country: Country | null = null,\n  ): AddressZipCode | null {\n    if (input == null) return null;\n    const trimmed = input.toString();\n    if (trimmed.length === 0) return null;\n    if (/[\\p{Cc}]/u.test(trimmed)) return null;\n    if (![...trimmed].every((c) => /[\\p{L}\\p{N}]/u.test(c) || /\\s/.test(c) || c === \"-\")) {\n      return null;\n    }\n    const normalized = normalizeInternational(trimmed);\n    if (!normalized) return null;\n    if (!INTERNATIONAL.test(normalized)) return null;\n    const resolved = country ?? inferCountryFromPrefix(normalized);\n    return new AddressZipCode(normalized, normalized, resolved);\n  }\n\n  static format(\n    input: string | null | undefined,\n    options?: { country?: Country | null; fallbackToTrimmedInputWhenInvalid?: boolean },\n  ): string | null {\n    const r = AddressZipCode.tryParse(input, options);\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?: { country?: Country | null; fallbackToTrimmedInputWhenInvalid?: boolean },\n  ): string | null {\n    const r = AddressZipCode.tryParse(input, options);\n    if (r) return r.value;\n    if (options?.fallbackToTrimmedInputWhenInvalid && input != null) {\n      const trimmed = input.trim();\n      return trimmed.length > 0 ? trimmed : null;\n    }\n    return null;\n  }\n\n  static isNormalized(input: string | null | undefined): boolean {\n    return input != null && AddressZipCode.normalize(input) === input;\n  }\n\n  static findCandidatesInText(text: string): readonly TextCandidate<AddressZipCode>[] {\n    if (!text) return [];\n    const out: TextCandidate<AddressZipCode>[] = [];\n    SCAN.lastIndex = 0;\n    let m: RegExpExecArray | null;\n    while ((m = SCAN.exec(text)) !== null) {\n      const zip = AddressZipCode.tryParseSwedish(m[0]);\n      if (!zip) continue;\n      out.push(\n        new TextCandidate<AddressZipCode>({\n          startIndex: m.index,\n          length: m[0].length,\n          originalText: m[0],\n          typeName: \"AddressZipCode\",\n          category: TextCandidateCategory.Contact,\n          normalizedForm: zip.toNormalizedString(),\n          formattedForm: zip.toString(),\n          maskedForm: maskZip(zip),\n          confidence: TextMatchConfidence.Low,\n          value: zip,\n        }),\n      );\n    }\n    return out;\n  }\n\n  toNormalizedString(): string {\n    return this.value;\n  }\n  toString(): string {\n    return this.formatted;\n  }\n\n  equals(other: AddressZipCode | null | undefined): boolean {\n    return other != null && this.value === other.value;\n  }\n  compareTo(other: AddressZipCode | 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 normalizeInternational(input: string): string {\n  let cleaned = input.trim().toUpperCase().replace(/\\s+/g, \"\");\n  const digits = keepDigits(cleaned);\n  if (cleaned.startsWith(\"DK\") && digits.length === 4) return `DK-${digits}`;\n  if (cleaned.startsWith(\"LV\") && digits.length === 4) return `LV-${digits}`;\n  if (cleaned.startsWith(\"MD\") && digits.length === 4) return `MD-${digits}`;\n  if (cleaned.startsWith(\"AD\") && digits.length === 3) return `AD${digits}`;\n  cleaned = cleaned.replace(/[^A-Z0-9-]/g, \"\");\n  if (/^\\d+-\\d+$/.test(cleaned)) return cleaned.replace(/-/g, \"\");\n  return cleaned;\n}\n\nfunction inferCountryFromPrefix(normalized: string): Country | null {\n  if (normalized.startsWith(\"DK-\")) return Country.Denmark;\n  if (normalized.startsWith(\"LV-\")) return Country.Latvia;\n  if (normalized.startsWith(\"MD-\")) return Country.tryParse(\"MD\");\n  if (normalized.startsWith(\"AD\") && normalized.length === 5 && /^\\d+$/.test(normalized.slice(2))) {\n    return Country.tryParse(\"AD\");\n  }\n  return null;\n}\n\n/** Internal masking for zip codes used in scan results. */\nexport function maskZip(zip: AddressZipCode): string {\n  const f = zip.formatted;\n  return f.replace(/\\d/g, \"*\");\n}\n"],
+  "mappings": "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",
+  "names": []
+}