@budiauktioner/buildi-primitives 0.1.0 → 0.2.0

package/dist/esm/person/person-masking.js

@@ -0,0 +1,28 @@
+const MaskedNamePart = "***";
+function maskGivenName(value, options) {
+  if (options?.useInitials) return value.names.map(toInitial).join(" ");
+  return value.names.map(() => MaskedNamePart).join(" ");
+}
+function maskFamilyName(value, options) {
+  if (options?.useInitials) return toInitial(value.value);
+  return MaskedNamePart;
+}
+function maskFullName(value, options) {
+  const family = maskFamilyName(value.familyName, options);
+  if (options?.showGivenName) return `${value.givenName.value} ${family}`;
+  return `${maskGivenName(value.givenName, options)} ${family}`;
+}
+function maskPersonAge(value) {
+  if (value.years >= 1) return `${"*".repeat(String(value.years).length)} \xE5r`;
+  return `${"*".repeat(String(value.totalMonths).length)} m\xE5nader`;
+}
+function toInitial(value) {
+  return `${value[0]}.`;
+}
+export {
+  maskFamilyName,
+  maskFullName,
+  maskGivenName,
+  maskPersonAge
+};
+//# sourceMappingURL=person-masking.js.map

package/dist/esm/person/person-masking.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/person/person-masking.ts"],
+  "sourcesContent": ["import { PersonAge } from \"./person-age.js\";\nimport { PersonFamilyName } from \"./person-family-name.js\";\nimport { PersonFullName } from \"./person-full-name.js\";\nimport { PersonGivenName } from \"./person-given-name.js\";\n\nconst MaskedNamePart = \"***\";\n\nexport interface PersonNameMaskingOptions {\n  readonly useInitials?: boolean;\n}\n\nexport interface FullNameMaskingOptions extends PersonNameMaskingOptions {\n  readonly showGivenName?: boolean;\n}\n\n/** Mask given names, e.g. `Anna Maria` -> `*** ***`. */\nexport function maskGivenName(value: PersonGivenName, options?: PersonNameMaskingOptions): string {\n  if (options?.useInitials) return value.names.map(toInitial).join(\" \");\n  return value.names.map(() => MaskedNamePart).join(\" \");\n}\n\n/** Mask a family name, e.g. `Andersson` -> `***`. */\nexport function maskFamilyName(\n  value: PersonFamilyName,\n  options?: PersonNameMaskingOptions,\n): string {\n  if (options?.useInitials) return toInitial(value.value);\n  return MaskedNamePart;\n}\n\n/** Mask a full name, e.g. `Anna Andersson` -> `*** ***`. */\nexport function maskFullName(value: PersonFullName, options?: FullNameMaskingOptions): string {\n  const family = maskFamilyName(value.familyName, options);\n  if (options?.showGivenName) return `${value.givenName.value} ${family}`;\n  return `${maskGivenName(value.givenName, options)} ${family}`;\n}\n\n/** Mask an age, keeping only its magnitude, e.g. `42` -> `** \u00E5r`. */\nexport function maskPersonAge(value: PersonAge): string {\n  if (value.years >= 1) return `${\"*\".repeat(String(value.years).length)} \u00E5r`;\n  return `${\"*\".repeat(String(value.totalMonths).length)} m\u00E5nader`;\n}\n\nfunction toInitial(value: string): string {\n  return `${value[0]}.`;\n}\n"],
+  "mappings": "AAKA,MAAM,iBAAiB;AAWhB,SAAS,cAAc,OAAwB,SAA4C;AAChG,MAAI,SAAS,YAAa,QAAO,MAAM,MAAM,IAAI,SAAS,EAAE,KAAK,GAAG;AACpE,SAAO,MAAM,MAAM,IAAI,MAAM,cAAc,EAAE,KAAK,GAAG;AACvD;AAGO,SAAS,eACd,OACA,SACQ;AACR,MAAI,SAAS,YAAa,QAAO,UAAU,MAAM,KAAK;AACtD,SAAO;AACT;AAGO,SAAS,aAAa,OAAuB,SAA0C;AAC5F,QAAM,SAAS,eAAe,MAAM,YAAY,OAAO;AACvD,MAAI,SAAS,cAAe,QAAO,GAAG,MAAM,UAAU,KAAK,IAAI,MAAM;AACrE,SAAO,GAAG,cAAc,MAAM,WAAW,OAAO,CAAC,IAAI,MAAM;AAC7D;AAGO,SAAS,cAAc,OAA0B;AACtD,MAAI,MAAM,SAAS,EAAG,QAAO,GAAG,IAAI,OAAO,OAAO,MAAM,KAAK,EAAE,MAAM,CAAC;AACtE,SAAO,GAAG,IAAI,OAAO,OAAO,MAAM,WAAW,EAAE,MAAM,CAAC;AACxD;AAEA,SAAS,UAAU,OAAuB;AACxC,SAAO,GAAG,MAAM,CAAC,CAAC;AACpB;",
+  "names": []
+}

package/dist/esm/person/person-name-normalization.js

@@ -0,0 +1,79 @@
+import { PrimitivesDefaults } from "../primitives-defaults.js";
+import { collapseWhitespace as baseCollapse } from "../internal/input-sanitization.js";
+const SINGLE_PART_PATTERN = /^(?:[\p{L}\p{M}]+|['\p{L}\p{M}]{2,}|[\p{Lo}])(?:['\p{Zs}-][\p{L}\p{M}]+)*$/u;
+const FULL_NAME_PATTERN = /^[\p{L}\p{M}][\p{L}\p{M}']*(?:\s+[\p{L}\p{M}][\p{L}\p{M}']*)+$/u;
+const HONORIFICS = [
+  "fr\xF6ken",
+  "froken",
+  "froeken",
+  "prof",
+  "miss",
+  "mrs",
+  "mr",
+  "ms",
+  "dr",
+  "herr",
+  "fru"
+];
+function collapseWhitespace(input) {
+  let result = baseCollapse(input);
+  result = result.replace(/\s*-\s*/g, "-");
+  const parts = result.split(" ").map((p) => p.replace(/^\.+|\.+$/g, "")).filter((p) => p.length > 0);
+  result = parts.join(" ");
+  return stripLeadingHonorific(result);
+}
+function stripLeadingHonorific(input) {
+  const lower = input.toLowerCase();
+  for (const h of HONORIFICS) {
+    if (input.length <= h.length) continue;
+    if (!lower.startsWith(h)) continue;
+    if (input[h.length] !== " ") continue;
+    return input.slice(h.length + 1);
+  }
+  return input;
+}
+function normalizeCasing(input) {
+  const letters = [...input].filter((c) => /\p{L}/u.test(c));
+  if (letters.length === 0) return input;
+  const culture = PrimitivesDefaults.culture;
+  const allLower = letters.every((c) => c === c.toLocaleLowerCase(culture));
+  const allUpper = letters.every((c) => c === c.toLocaleUpperCase(culture));
+  return allLower || allUpper ? capitalizeEachWord(input) : input;
+}
+function validateNamePart(value) {
+  if (value == null || value.trim() === "") return false;
+  if (/[\p{Cc}]/u.test(value)) return false;
+  if (/[\p{Cn}]/u.test(value)) return false;
+  return SINGLE_PART_PATTERN.test(value);
+}
+function validateGivenNames(value) {
+  if (value == null || value.trim() === "") return false;
+  const parts = value.split(" ").filter((p) => p !== "");
+  return parts.length > 0 && parts.every(validateNamePart);
+}
+function capitalizeEachWord(input) {
+  return input.split(" ").filter(Boolean).map(capitalizeHyphenated).join(" ");
+}
+function capitalizeHyphenated(word) {
+  return word.split("-").map(capitalizeWord).join("-");
+}
+function capitalizeWord(word) {
+  if (!word) return word;
+  const culture = PrimitivesDefaults.culture;
+  const lowered = word.toLocaleLowerCase(culture);
+  for (let i = 0; i < lowered.length; i++) {
+    if (/\p{L}/u.test(lowered[i])) {
+      return lowered.slice(0, i) + lowered[i].toLocaleUpperCase(culture) + lowered.slice(i + 1);
+    }
+  }
+  return lowered;
+}
+export {
+  FULL_NAME_PATTERN,
+  SINGLE_PART_PATTERN,
+  collapseWhitespace,
+  normalizeCasing,
+  validateGivenNames,
+  validateNamePart
+};
+//# sourceMappingURL=person-name-normalization.js.map

package/dist/esm/person/person-name-normalization.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/person/person-name-normalization.ts"],
+  "sourcesContent": ["import { PrimitivesDefaults } from \"../primitives-defaults.js\";\nimport { collapseWhitespace as baseCollapse } from \"../internal/input-sanitization.js\";\n\n// Single-letter name parts (e.g. \"B N\" returned by an identity provider) are\n// not officially valid full names in most jurisdictions, but they appear in\n// real-world data from Skatteverket, BankID and other identity providers.\n// Normalization must preserve them rather than discard the name.\nexport const SINGLE_PART_PATTERN =\n  /^(?:[\\p{L}\\p{M}]+|['\\p{L}\\p{M}]{2,}|[\\p{Lo}])(?:['\\p{Zs}-][\\p{L}\\p{M}]+)*$/u;\n\nexport const FULL_NAME_PATTERN = /^[\\p{L}\\p{M}][\\p{L}\\p{M}']*(?:\\s+[\\p{L}\\p{M}][\\p{L}\\p{M}']*)+$/u;\n\nconst HONORIFICS = [\n  \"fr\u00F6ken\",\n  \"froken\",\n  \"froeken\",\n  \"prof\",\n  \"miss\",\n  \"mrs\",\n  \"mr\",\n  \"ms\",\n  \"dr\",\n  \"herr\",\n  \"fru\",\n];\n\nexport function collapseWhitespace(input: string | null | undefined): string {\n  let result = baseCollapse(input);\n  result = result.replace(/\\s*-\\s*/g, \"-\");\n  const parts = result\n    .split(\" \")\n    .map((p) => p.replace(/^\\.+|\\.+$/g, \"\"))\n    .filter((p) => p.length > 0);\n  result = parts.join(\" \");\n  return stripLeadingHonorific(result);\n}\n\nfunction stripLeadingHonorific(input: string): string {\n  const lower = input.toLowerCase();\n  for (const h of HONORIFICS) {\n    if (input.length <= h.length) continue;\n    if (!lower.startsWith(h)) continue;\n    if (input[h.length] !== \" \") continue;\n    return input.slice(h.length + 1);\n  }\n  return input;\n}\n\n/**\n * If every letter in `input` has the same case (all lower or all upper),\n * capitalize each word and hyphenated sub-word. Otherwise keep original casing.\n */\nexport function normalizeCasing(input: string): string {\n  const letters = [...input].filter((c) => /\\p{L}/u.test(c));\n  if (letters.length === 0) return input;\n  const culture = PrimitivesDefaults.culture;\n  const allLower = letters.every((c) => c === c.toLocaleLowerCase(culture));\n  const allUpper = letters.every((c) => c === c.toLocaleUpperCase(culture));\n  return allLower || allUpper ? capitalizeEachWord(input) : input;\n}\n\nexport function validateNamePart(value: string | null | undefined): boolean {\n  if (value == null || value.trim() === \"\") return false;\n  if (/[\\p{Cc}]/u.test(value)) return false;\n  if (/[\\p{Cn}]/u.test(value)) return false;\n  return SINGLE_PART_PATTERN.test(value);\n}\n\nexport function validateGivenNames(value: string | null | undefined): boolean {\n  if (value == null || value.trim() === \"\") return false;\n  const parts = value.split(\" \").filter((p) => p !== \"\");\n  return parts.length > 0 && parts.every(validateNamePart);\n}\n\nfunction capitalizeEachWord(input: string): string {\n  return input.split(\" \").filter(Boolean).map(capitalizeHyphenated).join(\" \");\n}\n\nfunction capitalizeHyphenated(word: string): string {\n  return word.split(\"-\").map(capitalizeWord).join(\"-\");\n}\n\nfunction capitalizeWord(word: string): string {\n  if (!word) return word;\n  const culture = PrimitivesDefaults.culture;\n  const lowered = word.toLocaleLowerCase(culture);\n  for (let i = 0; i < lowered.length; i++) {\n    if (/\\p{L}/u.test(lowered[i]!)) {\n      return lowered.slice(0, i) + lowered[i]!.toLocaleUpperCase(culture) + lowered.slice(i + 1);\n    }\n  }\n  return lowered;\n}\n"],
+  "mappings": "AAAA,SAAS,0BAA0B;AACnC,SAAS,sBAAsB,oBAAoB;AAM5C,MAAM,sBACX;AAEK,MAAM,oBAAoB;AAEjC,MAAM,aAAa;AAAA,EACjB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEO,SAAS,mBAAmB,OAA0C;AAC3E,MAAI,SAAS,aAAa,KAAK;AAC/B,WAAS,OAAO,QAAQ,YAAY,GAAG;AACvC,QAAM,QAAQ,OACX,MAAM,GAAG,EACT,IAAI,CAAC,MAAM,EAAE,QAAQ,cAAc,EAAE,CAAC,EACtC,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC;AAC7B,WAAS,MAAM,KAAK,GAAG;AACvB,SAAO,sBAAsB,MAAM;AACrC;AAEA,SAAS,sBAAsB,OAAuB;AACpD,QAAM,QAAQ,MAAM,YAAY;AAChC,aAAW,KAAK,YAAY;AAC1B,QAAI,MAAM,UAAU,EAAE,OAAQ;AAC9B,QAAI,CAAC,MAAM,WAAW,CAAC,EAAG;AAC1B,QAAI,MAAM,EAAE,MAAM,MAAM,IAAK;AAC7B,WAAO,MAAM,MAAM,EAAE,SAAS,CAAC;AAAA,EACjC;AACA,SAAO;AACT;AAMO,SAAS,gBAAgB,OAAuB;AACrD,QAAM,UAAU,CAAC,GAAG,KAAK,EAAE,OAAO,CAAC,MAAM,SAAS,KAAK,CAAC,CAAC;AACzD,MAAI,QAAQ,WAAW,EAAG,QAAO;AACjC,QAAM,UAAU,mBAAmB;AACnC,QAAM,WAAW,QAAQ,MAAM,CAAC,MAAM,MAAM,EAAE,kBAAkB,OAAO,CAAC;AACxE,QAAM,WAAW,QAAQ,MAAM,CAAC,MAAM,MAAM,EAAE,kBAAkB,OAAO,CAAC;AACxE,SAAO,YAAY,WAAW,mBAAmB,KAAK,IAAI;AAC5D;AAEO,SAAS,iBAAiB,OAA2C;AAC1E,MAAI,SAAS,QAAQ,MAAM,KAAK,MAAM,GAAI,QAAO;AACjD,MAAI,YAAY,KAAK,KAAK,EAAG,QAAO;AACpC,MAAI,YAAY,KAAK,KAAK,EAAG,QAAO;AACpC,SAAO,oBAAoB,KAAK,KAAK;AACvC;AAEO,SAAS,mBAAmB,OAA2C;AAC5E,MAAI,SAAS,QAAQ,MAAM,KAAK,MAAM,GAAI,QAAO;AACjD,QAAM,QAAQ,MAAM,MAAM,GAAG,EAAE,OAAO,CAAC,MAAM,MAAM,EAAE;AACrD,SAAO,MAAM,SAAS,KAAK,MAAM,MAAM,gBAAgB;AACzD;AAEA,SAAS,mBAAmB,OAAuB;AACjD,SAAO,MAAM,MAAM,GAAG,EAAE,OAAO,OAAO,EAAE,IAAI,oBAAoB,EAAE,KAAK,GAAG;AAC5E;AAEA,SAAS,qBAAqB,MAAsB;AAClD,SAAO,KAAK,MAAM,GAAG,EAAE,IAAI,cAAc,EAAE,KAAK,GAAG;AACrD;AAEA,SAAS,eAAe,MAAsB;AAC5C,MAAI,CAAC,KAAM,QAAO;AAClB,QAAM,UAAU,mBAAmB;AACnC,QAAM,UAAU,KAAK,kBAAkB,OAAO;AAC9C,WAAS,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK;AACvC,QAAI,SAAS,KAAK,QAAQ,CAAC,CAAE,GAAG;AAC9B,aAAO,QAAQ,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,EAAG,kBAAkB,OAAO,IAAI,QAAQ,MAAM,IAAI,CAAC;AAAA,IAC3F;AAAA,EACF;AACA,SAAO;AACT;",
+  "names": []
+}

package/dist/esm/person/personnummer-parser.js

@@ -0,0 +1,136 @@
+import { luhnIsValid } from "../internal/luhn.js";
+import { systemClock } from "../internal/clock.js";
+const defaultClock = systemClock;
+const TWELVE = /^(\d{4})(\d{2})(\d{2})(\d{3})(\d)$/;
+const TEN = /^(\d{2})(\d{2})(\d{2})(\d{3})(\d)$/;
+const TEN_WITH_SEP = /^(\d{2})(\d{2})(\d{2})([-+])(\d{3})(\d)$/;
+const TWELVE_WITH_SEP = /^(\d{4})(\d{2})(\d{2})([-+])(\d{3})(\d)$/;
+function parsePin(input, clock = defaultClock) {
+  if (!input) return null;
+  const cleaned = input.trim();
+  if (cleaned.length === 0) return null;
+  let year, month, day;
+  let individual, check;
+  let hadPlus = false;
+  let isTwelve = false;
+  let m = TWELVE.exec(cleaned);
+  if (m) {
+    year = +m[1];
+    month = +m[2];
+    day = +m[3];
+    individual = m[4];
+    check = m[5];
+    isTwelve = true;
+  } else if (m = TEN.exec(cleaned)) {
+    const yy = +m[1];
+    year = inferCenturyForTenDigit(yy, false, clock);
+    month = +m[2];
+    day = +m[3];
+    individual = m[4];
+    check = m[5];
+  } else if (m = TEN_WITH_SEP.exec(cleaned)) {
+    const yy = +m[1];
+    hadPlus = m[4] === "+";
+    year = inferCenturyForTenDigit(yy, hadPlus, clock);
+    month = +m[2];
+    day = +m[3];
+    individual = m[5];
+    check = m[6];
+  } else if (m = TWELVE_WITH_SEP.exec(cleaned)) {
+    year = +m[1];
+    month = +m[2];
+    day = +m[3];
+    individual = m[5];
+    check = m[6];
+    if (m[4] === "+") return null;
+  } else {
+    return null;
+  }
+  if (month < 1 || month > 12) return null;
+  const isCoordination = day >= 60 && day <= 91;
+  let realDay;
+  let kind;
+  if (isCoordination) {
+    kind = "coordination";
+    realDay = day === 60 ? 0 : day - 60;
+    if (realDay !== 0 && !isValidDay(year, month, realDay)) return null;
+  } else {
+    kind = "personal";
+    if (!isValidDay(year, month, day)) return null;
+    realDay = day;
+  }
+  const luhnInput = String(year % 100).padStart(2, "0") + String(month).padStart(2, "0") + String(day).padStart(2, "0") + individual + check;
+  if (!luhnIsValid(luhnInput)) return null;
+  if (isTwelve && (year < 1800 || year > 2200)) return null;
+  return {
+    kind,
+    year,
+    month,
+    realDay,
+    individual,
+    checkDigit: check,
+    hadPlusSeparator: hadPlus
+  };
+}
+function isValidDay(year, month, day) {
+  if (day < 1) return false;
+  const dim = daysInMonth(year, month);
+  return day <= dim;
+}
+function daysInMonth(year, month) {
+  if (month === 2) {
+    const leap = year % 4 === 0 && year % 100 !== 0 || year % 400 === 0;
+    return leap ? 29 : 28;
+  }
+  if ([4, 6, 9, 11].includes(month)) return 30;
+  return 31;
+}
+function inferCenturyForTenDigit(yy, plusSeparator, clock) {
+  const now = clock.now();
+  const currentYear = now.getUTCFullYear();
+  const currentCentury = Math.floor(currentYear / 100);
+  const candidate = currentCentury * 100 + yy;
+  let year = candidate;
+  if (year > currentYear) year -= 100;
+  if (plusSeparator) year -= 100;
+  return year;
+}
+function pinTo12Digit(p) {
+  const day = p.kind === "coordination" ? p.realDay === 0 ? 60 : p.realDay + 60 : p.realDay;
+  return String(p.year).padStart(4, "0") + String(p.month).padStart(2, "0") + String(day).padStart(2, "0") + p.individual + p.checkDigit;
+}
+function pinTo10Digit(p, clock = defaultClock) {
+  const day = p.kind === "coordination" ? p.realDay === 0 ? 60 : p.realDay + 60 : p.realDay;
+  const yy = String(p.year % 100).padStart(2, "0");
+  const sep = ageInYears(p, clock) >= 100 ? "+" : "-";
+  return yy + String(p.month).padStart(2, "0") + String(day).padStart(2, "0") + sep + p.individual + p.checkDigit;
+}
+function ageInYears(p, clock) {
+  if (p.kind === "coordination" && p.realDay === 0) return 0;
+  const now = clock.now();
+  const day = p.kind === "coordination" ? p.realDay : p.realDay;
+  const birth = new Date(Date.UTC(p.year, p.month - 1, day || 1));
+  const ms = now.getTime() - birth.getTime();
+  return Math.floor(ms / (365.25 * 24 * 3600 * 1e3));
+}
+function pinGender(p) {
+  const d = parseInt(p.individual.charAt(p.individual.length - 1), 10);
+  return d % 2 === 0 ? "female" : "male";
+}
+function pinDateOfBirth(p) {
+  if (p.kind === "coordination" && p.realDay === 0) return null;
+  return new Date(Date.UTC(p.year, p.month - 1, p.realDay));
+}
+function pinAgeInYears(p, clock = defaultClock) {
+  if (p.kind === "coordination" && p.realDay === 0) return null;
+  return ageInYears(p, clock);
+}
+export {
+  parsePin,
+  pinAgeInYears,
+  pinDateOfBirth,
+  pinGender,
+  pinTo10Digit,
+  pinTo12Digit
+};
+//# sourceMappingURL=personnummer-parser.js.map

package/dist/esm/person/personnummer-parser.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/person/personnummer-parser.ts"],
+  "sourcesContent": ["/**\n * Local parser for Swedish personnummer and samordningsnummer.\n *\n * Replaces the .NET dependency on ActiveLogin.Identity with an in-house\n * implementation that supports the same input shapes:\n *\n * - 12 digits: `199908072391`\n * - 10 digits: `9908072391` (century inferred)\n * - Separator forms: `YYMMDD-NNNC` or `YYYYMMDD-NNNC`. The separator may be\n *   `-` (standard) or `+` (used when the person is 100 years or older;\n *   only valid when the input was given in 10-digit form).\n *\n * For coordination numbers (`samordningsnummer`) the day-of-month is shifted\n * by 60 (i.e. real day = day - 60), so valid days for coordination numbers\n * are 61-91 (or 60 when day-of-month is unknown).\n */\n\nimport { luhnIsValid } from \"../internal/luhn.js\";\nimport { Clock, systemClock } from \"../internal/clock.js\";\n\nconst defaultClock: Clock = systemClock;\n\nexport type PinKind = \"personal\" | \"coordination\";\n\nexport interface ParsedPin {\n  kind: PinKind;\n  /** Full 4-digit year. */\n  year: number;\n  /** 1-12. */\n  month: number;\n  /**\n   * For personal numbers: 1-31. For coordination numbers: realDay (1-31) or\n   * `0` when the day-of-month is unknown (raw day was 60).\n   */\n  realDay: number;\n  /** Three-digit individual number. */\n  individual: string;\n  /** Single check digit. */\n  checkDigit: string;\n  /** Whether the input had a `+` separator (indicates 100+ years old at parse time). */\n  hadPlusSeparator: boolean;\n}\n\nconst TWELVE = /^(\\d{4})(\\d{2})(\\d{2})(\\d{3})(\\d)$/;\nconst TEN = /^(\\d{2})(\\d{2})(\\d{2})(\\d{3})(\\d)$/;\nconst TEN_WITH_SEP = /^(\\d{2})(\\d{2})(\\d{2})([-+])(\\d{3})(\\d)$/;\nconst TWELVE_WITH_SEP = /^(\\d{4})(\\d{2})(\\d{2})([-+])(\\d{3})(\\d)$/;\n\nexport function parsePin(input: string, clock: Clock = defaultClock): ParsedPin | null {\n  if (!input) return null;\n  const cleaned = input.trim();\n  if (cleaned.length === 0) return null;\n\n  let year: number, month: number, day: number;\n  let individual: string, check: string;\n  let hadPlus = false;\n  let isTwelve = false;\n\n  let m = TWELVE.exec(cleaned);\n  if (m) {\n    year = +m[1]!;\n    month = +m[2]!;\n    day = +m[3]!;\n    individual = m[4]!;\n    check = m[5]!;\n    isTwelve = true;\n  } else if ((m = TEN.exec(cleaned))) {\n    const yy = +m[1]!;\n    year = inferCenturyForTenDigit(yy, false, clock);\n    month = +m[2]!;\n    day = +m[3]!;\n    individual = m[4]!;\n    check = m[5]!;\n  } else if ((m = TEN_WITH_SEP.exec(cleaned))) {\n    const yy = +m[1]!;\n    hadPlus = m[4] === \"+\";\n    year = inferCenturyForTenDigit(yy, hadPlus, clock);\n    month = +m[2]!;\n    day = +m[3]!;\n    individual = m[5]!;\n    check = m[6]!;\n  } else if ((m = TWELVE_WITH_SEP.exec(cleaned))) {\n    year = +m[1]!;\n    month = +m[2]!;\n    day = +m[3]!;\n    individual = m[5]!;\n    check = m[6]!;\n    if (m[4] === \"+\") return null;\n  } else {\n    return null;\n  }\n\n  if (month < 1 || month > 12) return null;\n\n  const isCoordination = day >= 60 && day <= 91;\n  let realDay: number;\n  let kind: PinKind;\n  if (isCoordination) {\n    kind = \"coordination\";\n    realDay = day === 60 ? 0 : day - 60;\n    if (realDay !== 0 && !isValidDay(year, month, realDay)) return null;\n  } else {\n    kind = \"personal\";\n    if (!isValidDay(year, month, day)) return null;\n    realDay = day;\n  }\n\n  const luhnInput =\n    String(year % 100).padStart(2, \"0\") +\n    String(month).padStart(2, \"0\") +\n    String(day).padStart(2, \"0\") +\n    individual +\n    check;\n  if (!luhnIsValid(luhnInput)) return null;\n\n  // 12-digit form must use a 4-digit year that matches the inferred century.\n  if (isTwelve && (year < 1800 || year > 2200)) return null;\n\n  return {\n    kind,\n    year,\n    month,\n    realDay,\n    individual,\n    checkDigit: check,\n    hadPlusSeparator: hadPlus,\n  };\n}\n\nfunction isValidDay(year: number, month: number, day: number): boolean {\n  if (day < 1) return false;\n  const dim = daysInMonth(year, month);\n  return day <= dim;\n}\n\nfunction daysInMonth(year: number, month: number): number {\n  if (month === 2) {\n    const leap = (year % 4 === 0 && year % 100 !== 0) || year % 400 === 0;\n    return leap ? 29 : 28;\n  }\n  if ([4, 6, 9, 11].includes(month)) return 30;\n  return 31;\n}\n\nfunction inferCenturyForTenDigit(yy: number, plusSeparator: boolean, clock: Clock): number {\n  const now = clock.now();\n  const currentYear = now.getUTCFullYear();\n  const currentCentury = Math.floor(currentYear / 100);\n  const candidate = currentCentury * 100 + yy;\n  let year = candidate;\n  if (year > currentYear) year -= 100;\n  if (plusSeparator) year -= 100;\n  return year;\n}\n\n/** Build the canonical 12-digit form. */\nexport function pinTo12Digit(p: ParsedPin): string {\n  const day = p.kind === \"coordination\" ? (p.realDay === 0 ? 60 : p.realDay + 60) : p.realDay;\n  return (\n    String(p.year).padStart(4, \"0\") +\n    String(p.month).padStart(2, \"0\") +\n    String(day).padStart(2, \"0\") +\n    p.individual +\n    p.checkDigit\n  );\n}\n\n/** Build the canonical 10-digit display form (`YYMMDD-NNNC` or `YYMMDD+NNNC`). */\nexport function pinTo10Digit(p: ParsedPin, clock: Clock = defaultClock): string {\n  const day = p.kind === \"coordination\" ? (p.realDay === 0 ? 60 : p.realDay + 60) : p.realDay;\n  const yy = String(p.year % 100).padStart(2, \"0\");\n  const sep = ageInYears(p, clock) >= 100 ? \"+\" : \"-\";\n  return (\n    yy +\n    String(p.month).padStart(2, \"0\") +\n    String(day).padStart(2, \"0\") +\n    sep +\n    p.individual +\n    p.checkDigit\n  );\n}\n\nfunction ageInYears(p: ParsedPin, clock: Clock): number {\n  if (p.kind === \"coordination\" && p.realDay === 0) return 0;\n  const now = clock.now();\n  const day = p.kind === \"coordination\" ? p.realDay : p.realDay;\n  const birth = new Date(Date.UTC(p.year, p.month - 1, day || 1));\n  const ms = now.getTime() - birth.getTime();\n  return Math.floor(ms / (365.25 * 24 * 3600 * 1000));\n}\n\n/** Estimate gender. The third digit of the individual portion is even for female, odd for male. */\nexport function pinGender(p: ParsedPin): \"female\" | \"male\" {\n  const d = parseInt(p.individual.charAt(p.individual.length - 1), 10);\n  return d % 2 === 0 ? \"female\" : \"male\";\n}\n\n/** Best-effort date of birth (`null` if coordination day is unknown). */\nexport function pinDateOfBirth(p: ParsedPin): Date | null {\n  if (p.kind === \"coordination\" && p.realDay === 0) return null;\n  return new Date(Date.UTC(p.year, p.month - 1, p.realDay));\n}\n\n/** Age in whole years (`null` if coordination day is unknown). */\nexport function pinAgeInYears(p: ParsedPin, clock: Clock = defaultClock): number | null {\n  if (p.kind === \"coordination\" && p.realDay === 0) return null;\n  return ageInYears(p, clock);\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/esm/person/swedish-coordination-number.js

@@ -0,0 +1,173 @@
+import { systemClock } from "../internal/clock.js";
+import { sanitizeInput } from "../internal/input-sanitization.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 { ValidationErrorReason } from "../validation/index.js";
+import { invalidResult, validResult } from "../validation/validation-result.js";
+import {
+  parsePin,
+  pinAgeInYears,
+  pinDateOfBirth,
+  pinGender,
+  pinTo10Digit,
+  pinTo12Digit
+} from "./personnummer-parser.js";
+const MAX_INPUT_LENGTH = 20;
+const SCAN_PATTERN = /(?<!\d)(\d{6,8})([-+])(\d{4})(?!\d)/g;
+class SwedishCoordinationNumber {
+  static typeInfo = Object.freeze({
+    englishName: "Coordination Number",
+    localizedName: "Samordningsnummer",
+    emoji: "\u{1F194}",
+    sources: Object.freeze([
+      "https://skatteverket.se/privat/folkbokforing/samordningsnummer.4.5c281c7015abecc2e201130b.html",
+      "https://sv.wikipedia.org/wiki/Samordningsnummer"
+    ])
+  });
+  _pin;
+  _clock;
+  constructor(pin, clock) {
+    this._pin = pin;
+    this._clock = clock;
+  }
+  get formatted() {
+    return pinTo10Digit(this._pin, this._clock);
+  }
+  get value() {
+    return pinTo12Digit(this._pin);
+  }
+  get realDay() {
+    return this._pin.realDay;
+  }
+  get dateOfBirthHint() {
+    return pinDateOfBirth(this._pin);
+  }
+  get ageHint() {
+    return pinAgeInYears(this._pin, this._clock);
+  }
+  get genderHint() {
+    return pinGender(this._pin);
+  }
+  static tryParse(input, options) {
+    if (input == null || input.trim() === "") return null;
+    const sanitized = sanitizeInput(input).trim();
+    if (sanitized.length === 0 || sanitized.length > MAX_INPUT_LENGTH) return null;
+    const clock = options?.clock ?? systemClock;
+    const pin = parsePin(sanitized, clock);
+    if (pin === null) return null;
+    if (pin.kind !== "coordination") return null;
+    return new SwedishCoordinationNumber(pin, clock);
+  }
+  static parse(input, options) {
+    const r = SwedishCoordinationNumber.tryParse(input, options);
+    if (r === null) throw new Error("Invalid Swedish coordination number.");
+    return r;
+  }
+  static isValid(input) {
+    return SwedishCoordinationNumber.tryParse(input) !== null;
+  }
+  static format(input, options) {
+    const r = SwedishCoordinationNumber.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 = SwedishCoordinationNumber.tryParse(input, options);
+    if (r) return r.value;
+    if (options?.fallbackToTrimmedInputWhenInvalid && input != null) {
+      const t = input.trim();
+      return t.length > 0 ? t : null;
+    }
+    return null;
+  }
+  static isNormalized(input) {
+    return input != null && SwedishCoordinationNumber.normalize(input) === input;
+  }
+  static validate(input) {
+    if (input == null || input.trim() === "") {
+      return invalidResult(
+        input,
+        ValidationErrorReason.InputIsEmpty,
+        "Input is empty or whitespace.",
+        "V\xE4rdet \xE4r tomt."
+      );
+    }
+    const sanitized = sanitizeInput(input).trim();
+    if (sanitized.length > MAX_INPUT_LENGTH) {
+      return invalidResult(
+        input,
+        ValidationErrorReason.InputTooLong,
+        "Input contains too many characters.",
+        "V\xE4rdet inneh\xE5ller f\xF6r m\xE5nga tecken."
+      );
+    }
+    const pin = parsePin(sanitized);
+    if (pin === null || pin.kind !== "coordination") {
+      return invalidResult(
+        input,
+        ValidationErrorReason.InvalidFormat,
+        "Invalid coordination number format.",
+        "Ogiltigt format f\xF6r samordningsnummer."
+      );
+    }
+    return validResult(input);
+  }
+  toNormalizedString() {
+    return this.value;
+  }
+  toString() {
+    return this.formatted;
+  }
+  to10DigitString() {
+    return this.formatted;
+  }
+  to12DigitString() {
+    return this.value;
+  }
+  static findCandidatesInText(text) {
+    if (!text) return [];
+    const out = [];
+    SCAN_PATTERN.lastIndex = 0;
+    let m;
+    while ((m = SCAN_PATTERN.exec(text)) !== null) {
+      const cn = SwedishCoordinationNumber.tryParse(m[0]);
+      if (!cn) continue;
+      out.push(
+        new TextCandidate({
+          startIndex: m.index,
+          length: m[0].length,
+          originalText: m[0],
+          typeName: "SwedishCoordinationNumber",
+          category: TextCandidateCategory.PersonalIdentifier,
+          normalizedForm: cn.toNormalizedString(),
+          formattedForm: cn.toString(),
+          maskedForm: maskCoordinationNumber(cn),
+          confidence: TextMatchConfidence.High,
+          value: cn
+        })
+      );
+    }
+    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 maskCoordinationNumber(c, options) {
+  const f = c.formatted;
+  if (options?.maskBirthDate) return "******-****";
+  return f.slice(0, f.length - 4) + "****";
+}
+export {
+  SwedishCoordinationNumber,
+  maskCoordinationNumber
+};
+//# sourceMappingURL=swedish-coordination-number.js.map

package/dist/esm/person/swedish-coordination-number.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/person/swedish-coordination-number.ts"],
+  "sourcesContent": ["import { PrimitiveTypeInfo } from \"../primitive-type-info.js\";\nimport { Clock, systemClock } from \"../internal/clock.js\";\nimport { 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 { ValidationErrorReason, ValidationResult } from \"../validation/index.js\";\nimport { invalidResult, validResult } from \"../validation/validation-result.js\";\nimport {\n  ParsedPin,\n  parsePin,\n  pinAgeInYears,\n  pinDateOfBirth,\n  pinGender,\n  pinTo10Digit,\n  pinTo12Digit,\n} from \"./personnummer-parser.js\";\n\nconst MAX_INPUT_LENGTH = 20;\n\nconst SCAN_PATTERN = /(?<!\\d)(\\d{6,8})([-+])(\\d{4})(?!\\d)/g;\n\n/** A Swedish Coordination Number (`samordningsnummer`). */\nexport class SwedishCoordinationNumber {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Coordination Number\",\n    localizedName: \"Samordningsnummer\",\n    emoji: \"\\u{1F194}\",\n    sources: Object.freeze([\n      \"https://skatteverket.se/privat/folkbokforing/samordningsnummer.4.5c281c7015abecc2e201130b.html\",\n      \"https://sv.wikipedia.org/wiki/Samordningsnummer\",\n    ]),\n  });\n\n  readonly _pin: ParsedPin;\n  readonly _clock: Clock;\n\n  private constructor(pin: ParsedPin, clock: Clock) {\n    this._pin = pin;\n    this._clock = clock;\n  }\n\n  get formatted(): string {\n    return pinTo10Digit(this._pin, this._clock);\n  }\n  get value(): string {\n    return pinTo12Digit(this._pin);\n  }\n  get realDay(): number {\n    return this._pin.realDay;\n  }\n  get dateOfBirthHint(): Date | null {\n    return pinDateOfBirth(this._pin);\n  }\n  get ageHint(): number | null {\n    return pinAgeInYears(this._pin, this._clock);\n  }\n  get genderHint(): \"female\" | \"male\" {\n    return pinGender(this._pin);\n  }\n\n  static tryParse(\n    input: string | null | undefined,\n    options?: { clock?: Clock },\n  ): SwedishCoordinationNumber | null {\n    if (input == null || input.trim() === \"\") return null;\n    const sanitized = sanitizeInput(input).trim();\n    if (sanitized.length === 0 || sanitized.length > MAX_INPUT_LENGTH) return null;\n    const clock = options?.clock ?? systemClock;\n    const pin = parsePin(sanitized, clock);\n    if (pin === null) return null;\n    if (pin.kind !== \"coordination\") return null;\n    return new SwedishCoordinationNumber(pin, clock);\n  }\n\n  static parse(input: string, options?: { clock?: Clock }): SwedishCoordinationNumber {\n    const r = SwedishCoordinationNumber.tryParse(input, options);\n    if (r === null) throw new Error(\"Invalid Swedish coordination number.\");\n    return r;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return SwedishCoordinationNumber.tryParse(input) !== null;\n  }\n\n  static format(\n    input: string | null | undefined,\n    options?: { fallbackToTrimmedInputWhenInvalid?: boolean; clock?: Clock },\n  ): string | null {\n    const r = SwedishCoordinationNumber.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?: { fallbackToTrimmedInputWhenInvalid?: boolean; clock?: Clock },\n  ): string | null {\n    const r = SwedishCoordinationNumber.tryParse(input, options);\n    if (r) return r.value;\n    if (options?.fallbackToTrimmedInputWhenInvalid && input != null) {\n      const t = input.trim();\n      return t.length > 0 ? t : null;\n    }\n    return null;\n  }\n\n  static isNormalized(input: string | null | undefined): boolean {\n    return input != null && SwedishCoordinationNumber.normalize(input) === input;\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 sanitized = sanitizeInput(input).trim();\n    if (sanitized.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    const pin = parsePin(sanitized);\n    if (pin === null || pin.kind !== \"coordination\") {\n      return invalidResult(\n        input,\n        ValidationErrorReason.InvalidFormat,\n        \"Invalid coordination number format.\",\n        \"Ogiltigt format f\u00F6r samordningsnummer.\",\n      );\n    }\n    return validResult(input);\n  }\n\n  toNormalizedString(): string {\n    return this.value;\n  }\n  toString(): string {\n    return this.formatted;\n  }\n  to10DigitString(): string {\n    return this.formatted;\n  }\n  to12DigitString(): string {\n    return this.value;\n  }\n\n  static findCandidatesInText(text: string): readonly TextCandidate<SwedishCoordinationNumber>[] {\n    if (!text) return [];\n    const out: TextCandidate<SwedishCoordinationNumber>[] = [];\n    SCAN_PATTERN.lastIndex = 0;\n    let m: RegExpExecArray | null;\n    while ((m = SCAN_PATTERN.exec(text)) !== null) {\n      const cn = SwedishCoordinationNumber.tryParse(m[0]);\n      if (!cn) continue;\n      out.push(\n        new TextCandidate<SwedishCoordinationNumber>({\n          startIndex: m.index,\n          length: m[0].length,\n          originalText: m[0],\n          typeName: \"SwedishCoordinationNumber\",\n          category: TextCandidateCategory.PersonalIdentifier,\n          normalizedForm: cn.toNormalizedString(),\n          formattedForm: cn.toString(),\n          maskedForm: maskCoordinationNumber(cn),\n          confidence: TextMatchConfidence.High,\n          value: cn,\n        }),\n      );\n    }\n    return out;\n  }\n\n  equals(other: SwedishCoordinationNumber | null | undefined): boolean {\n    return other != null && this.value === other.value;\n  }\n  compareTo(other: SwedishCoordinationNumber | 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\n/** Mask a coordination number, e.g. `680164-2395` -> `680164-****`. */\nexport function maskCoordinationNumber(\n  c: SwedishCoordinationNumber,\n  options?: { maskBirthDate?: boolean },\n): string {\n  const f = c.formatted;\n  if (options?.maskBirthDate) return \"******-****\";\n  return f.slice(0, f.length - 4) + \"****\";\n}\n"],
+  "mappings": "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",
+  "names": []
+}