@mailwoman/record 4.10.0 → 4.12.0

package/README.md

@@ -0,0 +1,73 @@
+# @mailwoman/record
+
+**Record schema and per-field normalizers** for the geocode-first entity
+resolution matcher. Address-first design: the canonical `PostalAddress` record
+composes parsed address components, the formatter's match key, and a resolved
+geocode. Organization and contact records build on the same canonical record.
+
+```ts
+import { PostalAddress, parsePersonName, canonicalizeOrganizationName } from "@mailwoman/record";
+
+// Canonical address record (parser output → canonical form)
+const address: PostalAddress = {
+  components: { house_number: "1600", street: "Amphitheatre Parkway", ... },
+  canonicalKey: "1600 amphitheatre pkwy mountain view ca 94043",
+  coordinate: { lat: 37.4224, lon: -122.0842 },
+};
+
+// Person name parsing
+const name = parsePersonName("Jane L. Smith");
+// → { given: "Jane", middleInitial: "L", surname: "Smith" }
+
+// Organization name canonicalization (for dedup)
+canonicalizeOrganizationName("Baylor University Medical Center");
+// → "baylor university medical center"
+
+canonicalizeOrganizationName("Baylor Univ. Med. Ctr.");
+// → "baylor university medical center"  (same key)
+```
+
+## API
+
+```ts
+// Address record (the core of the record system)
+import { PostalAddress, createPostalAddress } from "@mailwoman/record/address"
+
+// Person name parsing → structured components
+import { parsePersonName, type ParsedPersonName } from "@mailwoman/record/name"
+
+// Organization name canonicalization → matchable key
+import { canonicalizeOrganizationName, type CanonicalizeOrgOpts } from "@mailwoman/record/organization"
+```
+
+## What it normalizes
+
+| Field            | Normalizer                     | Purpose                                                       |
+| ---------------- | ------------------------------ | ------------------------------------------------------------- |
+| **Address**      | `createPostalAddress`          | Parse components + formatter key + geocode → canonical record |
+| **Person name**  | `parsePersonName`              | "Jane L. Smith" → `{given, middleInitial, surname}`           |
+| **Organization** | `canonicalizeOrganizationName` | "Baylor Univ. Med. Ctr." → "baylor university medical center" |
+
+## Design
+
+- **Plain data, no classes.** Records are plain TypeScript objects with
+  branded types where needed.
+- **Address-first.** The `PostalAddress` is the canonical record — the geocode-first
+  matcher resolves places, not strings.
+- **Domain-scoped.** Organization canonicalization supports jurisdiction and
+  domain context (e.g., `{jurisdiction: "ID"}` for Indonesian legal designations,
+  `{domain: "healthcare"}` to protect PT/SCA from collision with medical
+  abbreviations).
+- **Lean dependencies.** Only depends on `@mailwoman/formatter` for the
+  canonical key.
+
+## Related
+
+- [`@mailwoman/match`](../match) — the fuzzy matcher that consumes these records
+- [`@mailwoman/formatter`](../formatter) — `canonicalKey` used by `PostalAddress`
+- [`@mailwoman/registry`](../registry) — high-level `resolveEntities` that uses records
+- [Geocode-First Record Matching](https://mailwoman.sister.software/articles/concepts/geocode-first-record-matching/)
+
+## License
+
+[AGPL-3.0-only](https://www.gnu.org/licenses/agpl-3.0.html)

package/out/address.d.ts

@@ -3,8 +3,8 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- *   The canonical address record — the matcher's unit of address identity, and the spine the
- *   organization and contact records build on.
+ *   The canonical address record — the matcher's unit of address identity, and the canonical record
+ *   the organization and contact records build on.
  *
  *   It is plain data: parser components + the formatter's match key + an optional resolved geocode,
  *   composed into one object. No ORM, no decorators, no schema-generation machinery — if we need a

package/out/address.js

@@ -3,8 +3,8 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- *   The canonical address record — the matcher's unit of address identity, and the spine the
- *   organization and contact records build on.
+ *   The canonical address record — the matcher's unit of address identity, and the canonical record
+ *   the organization and contact records build on.
  *
  *   It is plain data: parser components + the formatter's match key + an optional resolved geocode,
  *   composed into one object. No ORM, no decorators, no schema-generation machinery — if we need a

package/out/index.d.ts

@@ -5,7 +5,7 @@
  *
  *   `@mailwoman/record` — the canonicalize layer for the geocode-first matcher.
  *
- *   Address-first: {@linkcode PostalAddress} is the spine. The per-field normalizers
+ *   Address-first: {@linkcode PostalAddress} is the canonical record. The per-field normalizers
  *   ({@linkcode parsePersonName}, {@linkcode canonicalizeOrganizationName}) build on the same
  *   plain-data pattern. Contact records and the comparator/Fellegi-Sunter layer land in the
  *   matcher.

package/out/index.js

@@ -5,7 +5,7 @@
  *
  *   `@mailwoman/record` — the canonicalize layer for the geocode-first matcher.
  *
- *   Address-first: {@linkcode PostalAddress} is the spine. The per-field normalizers
+ *   Address-first: {@linkcode PostalAddress} is the canonical record. The per-field normalizers
  *   ({@linkcode parsePersonName}, {@linkcode canonicalizeOrganizationName}) build on the same
  *   plain-data pattern. Contact records and the comparator/Fellegi-Sunter layer land in the
  *   matcher.

package/out/organization.d.ts

@@ -10,13 +10,32 @@
  *   Corporation, LLC` collapse to the same key. We also split off a `doing business as` clause and
  *   normalize connectives (`&` → `and`), punctuation, accents, and a leading `The`.
  *
+ *   **The collision problem (#668).** A legal-form token in one jurisdiction is a meaningful word in
+ *   another domain. `PT` is Indonesia's `Perseroan Terbatas` (its LLC) — and US-healthcare
+ *   shorthand for _Physical Therapy_. `SCA` / `SCS` are French/Belgian/Luxembourg commandite forms
+ *   — and, in a clinic's name, _Sudden Cardiac Arrest_ / _Spinal Cord Stimulator_. A single
+ *   universal strip-list can't be right for both: strip `PT` and you corrupt `Lakeside PT`; keep it
+ *   and you leave the legal form on an Indonesian company. So the strip-set is computed on **two
+ *   axes**:
+ *
+ *   - **jurisdiction** (ISO 3166-1 alpha-2, e.g. from the resolved address country) — _adds_ the legal
+ *       forms valid in that country. Collision-prone forms (`pt`, `sca`, `scs`) live here, gated
+ *       behind a known jurisdiction, NOT in the universal base.
+ *   - **domain** (an ingest-config tag, e.g. `healthcare`) — _protects_ domain-meaningful tokens from
+ *       ever being stripped, even when a jurisdiction pack would add them. Domain protection wins.
+ *
+ *   `effective = (base ∪ jurisdiction-pack) − domain-protect-pack`. With no options the set is the
+ *   universal base and behavior is byte-for-byte unchanged — the new axes are strictly opt-in.
+ *
  *   Evidence honesty (per the name-canonicalization research pass): the PERSON-name side is well
  *   sourced; the ORGANIZATION side is a known evidence gap. This is a solid _canonicalization_
  *   baseline (the strip-designations principle is Winkler-grounded; the designation list draws on
- *   the ISO 20275 Entity Legal Forms register and `cleanco`). The harder org-_matching_ problems —
- *   acronym ↔ expansion (`IBM` ↔ `International Business Machines`), DBA/alias resolution beyond
- *   the simple clause, subsidiary/parent, and TF-IDF n-gram token matching — are deferred to a
- *   follow-up (a dedicated org-matching research pass + the matcher epic).
+ *   the ISO 20275 Entity Legal Forms register and `cleanco`). The jurisdiction/domain packs below
+ *   are grounded seeds, not exhaustive — extend them per ISO 20275 as locales are added. The harder
+ *   org-_matching_ problems — acronym ↔ expansion (`IBM` ↔ `International Business Machines`),
+ *   DBA/alias resolution beyond the simple clause, subsidiary/parent, and TF-IDF n-gram token
+ *   matching — are deferred to a follow-up (a dedicated org-matching research pass + the matcher
+ *   epic).
  */
 /** A canonicalized organization name. */
 export interface OrganizationName {
@@ -29,9 +48,37 @@ export interface OrganizationName {
     /** The `doing business as` / trade-name clause, canonicalized, when one was present. */
     dba?: string;
 }
+/**
+ * A domain pack name. Each protects the abbreviations that are meaningful in that domain from being
+ * stripped as legal forms (see {@link DOMAIN_PROTECTED}). `general` protects nothing — the explicit
+ * "no domain" choice. Add a pack here (and to {@link DOMAIN_PROTECTED}) per ingest domain.
+ */
+export type DesignationDomain = "general" | "healthcare";
+/**
+ * Context for {@link canonicalizeOrganizationName}. Omit both fields for the universal base
+ * behavior.
+ */
+export interface CanonicalizeOptions {
+    /**
+     * ISO 3166-1 alpha-2 country code of the org's jurisdiction (typically the resolved address
+     * country). Adds that country's legal forms — including collision-prone ones gated out of the
+     * base — to the strip-set. Case-insensitive; unknown codes add nothing.
+     */
+    jurisdiction?: string;
+    /**
+     * Ingest domain. Protects domain-meaningful abbreviations (e.g. `healthcare` protects `pt` /
+     * `sca` / `scs`) from being stripped, overriding any jurisdiction pack that would add them.
+     */
+    domain?: DesignationDomain;
+}
 /**
  * Canonicalize an organization name: split off any `doing business as` clause, then reduce the
  * legal name to a designation-stripped key. Returns `null` for empty input.
+ *
+ * Pass {@link CanonicalizeOptions} to resolve the jurisdiction × domain collision (#668): a
+ * `jurisdiction` adds that country's legal forms, a `domain` protects its meaningful abbreviations.
+ * With no options the universal base set is used and the result is byte-for-byte the legacy
+ * behavior.
  */
-export declare function canonicalizeOrganizationName(input: string | null | undefined): OrganizationName | null;
+export declare function canonicalizeOrganizationName(input: string | null | undefined, options?: CanonicalizeOptions): OrganizationName | null;
 //# sourceMappingURL=organization.d.ts.map

package/out/organization.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"organization.d.ts","sourceRoot":"","sources":["../organization.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,yCAAyC;AACzC,MAAM,WAAW,gBAAgB;IAChC,oCAAoC;IACpC,GAAG,EAAE,MAAM,CAAA;IACX,wEAAwE;IACxE,SAAS,EAAE,MAAM,CAAA;IACjB,wFAAwF;IACxF,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,wFAAwF;IACxF,GAAG,CAAC,EAAE,MAAM,CAAA;CACZ;AA8FD;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,gBAAgB,GAAG,IAAI,CAgBtG"}
+{"version":3,"file":"organization.d.ts","sourceRoot":"","sources":["../organization.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,yCAAyC;AACzC,MAAM,WAAW,gBAAgB;IAChC,oCAAoC;IACpC,GAAG,EAAE,MAAM,CAAA;IACX,wEAAwE;IACxE,SAAS,EAAE,MAAM,CAAA;IACjB,wFAAwF;IACxF,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,wFAAwF;IACxF,GAAG,CAAC,EAAE,MAAM,CAAA;CACZ;AAED;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,YAAY,CAAA;AAExD;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IACnC;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;;OAGG;IACH,MAAM,CAAC,EAAE,iBAAiB,CAAA;CAC1B;AAoJD;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAC3C,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAChC,OAAO,CAAC,EAAE,mBAAmB,GAC3B,gBAAgB,GAAG,IAAI,CAiBzB"}

package/out/organization.js

@@ -10,21 +10,42 @@
  *   Corporation, LLC` collapse to the same key. We also split off a `doing business as` clause and
  *   normalize connectives (`&` → `and`), punctuation, accents, and a leading `The`.
  *
+ *   **The collision problem (#668).** A legal-form token in one jurisdiction is a meaningful word in
+ *   another domain. `PT` is Indonesia's `Perseroan Terbatas` (its LLC) — and US-healthcare
+ *   shorthand for _Physical Therapy_. `SCA` / `SCS` are French/Belgian/Luxembourg commandite forms
+ *   — and, in a clinic's name, _Sudden Cardiac Arrest_ / _Spinal Cord Stimulator_. A single
+ *   universal strip-list can't be right for both: strip `PT` and you corrupt `Lakeside PT`; keep it
+ *   and you leave the legal form on an Indonesian company. So the strip-set is computed on **two
+ *   axes**:
+ *
+ *   - **jurisdiction** (ISO 3166-1 alpha-2, e.g. from the resolved address country) — _adds_ the legal
+ *       forms valid in that country. Collision-prone forms (`pt`, `sca`, `scs`) live here, gated
+ *       behind a known jurisdiction, NOT in the universal base.
+ *   - **domain** (an ingest-config tag, e.g. `healthcare`) — _protects_ domain-meaningful tokens from
+ *       ever being stripped, even when a jurisdiction pack would add them. Domain protection wins.
+ *
+ *   `effective = (base ∪ jurisdiction-pack) − domain-protect-pack`. With no options the set is the
+ *   universal base and behavior is byte-for-byte unchanged — the new axes are strictly opt-in.
+ *
  *   Evidence honesty (per the name-canonicalization research pass): the PERSON-name side is well
  *   sourced; the ORGANIZATION side is a known evidence gap. This is a solid _canonicalization_
  *   baseline (the strip-designations principle is Winkler-grounded; the designation list draws on
- *   the ISO 20275 Entity Legal Forms register and `cleanco`). The harder org-_matching_ problems —
- *   acronym ↔ expansion (`IBM` ↔ `International Business Machines`), DBA/alias resolution beyond
- *   the simple clause, subsidiary/parent, and TF-IDF n-gram token matching — are deferred to a
- *   follow-up (a dedicated org-matching research pass + the matcher epic).
+ *   the ISO 20275 Entity Legal Forms register and `cleanco`). The jurisdiction/domain packs below
+ *   are grounded seeds, not exhaustive — extend them per ISO 20275 as locales are added. The harder
+ *   org-_matching_ problems — acronym ↔ expansion (`IBM` ↔ `International Business Machines`),
+ *   DBA/alias resolution beyond the simple clause, subsidiary/parent, and TF-IDF n-gram token
+ *   matching — are deferred to a follow-up (a dedicated org-matching research pass + the matcher
+ *   epic).
  */
 /**
- * Legal-entity designations across jurisdictions, normalized to lowercase with punctuation removed
- * (so `L.L.C.` → `llc`). Drawn from the ISO 20275 Entity Legal Forms register + `cleanco`'s common
- * set. Stripped as whole tokens wherever they occur. Deliberately excludes name-meaningful words
- * (`group`, `holdings`, `partners`, `associates`).
+ * Universal legal-entity designations — the forms that are safe to strip regardless of jurisdiction
+ * or domain because they don't collide with common domain abbreviations. Normalized to lowercase
+ * with punctuation removed (so `L.L.C.` → `llc`). Drawn from the ISO 20275 register + `cleanco`'s
+ * common set. Stripped as whole tokens wherever they occur. Deliberately excludes name-meaningful
+ * words (`group`, `holdings`, `partners`, `associates`) AND the collision-prone forms (`pt`, `sca`,
+ * `scs`) — those last live in {@link JURISDICTION_DESIGNATIONS}, gated behind a known jurisdiction.
  */
-const DESIGNATIONS = new Set([
+const BASE_DESIGNATIONS = new Set([
     "inc",
     "incorporated",
     "corp",
@@ -74,7 +95,56 @@ const DESIGNATIONS = new Set([
     "doo",
     "ood",
     "ead",
+    // Belgian forms — safe to add to the base (no domain collision).
+    "bvba",
+    "sprl",
 ]);
+/**
+ * Jurisdiction-gated legal forms (ISO 3166-1 alpha-2 → forms), added only when the jurisdiction is
+ * known. This is where the collision-prone tokens live: `pt` (Indonesia), `sca` / `scs`
+ * (French/Belgian/Luxembourg commandite forms). Stripping these is correct ONLY when we know the
+ * org's country — never in the universal base. Grounded seeds, not exhaustive; extend per ISO
+ * 20275.
+ */
+const JURISDICTION_DESIGNATIONS = {
+    ID: ["pt", "tbk", "ud"], // Perseroan Terbatas / Terbuka (listed) / Usaha Dagang
+    FR: ["sca", "scs", "sci", "eurl", "sasu", "snc"],
+    BE: ["sca", "scs"],
+    LU: ["sca", "scs"],
+    ES: ["scs"], // Sociedad en Comandita Simple
+    IT: ["sapa", "snc"], // S.a.p.a. (commandite par actions) / società in nome collettivo
+};
+/**
+ * Domain protect-sets (domain → tokens never stripped). Overrides any jurisdiction pack: a token
+ * here stays in the name even if the org's jurisdiction would treat it as a legal form.
+ * `healthcare` guards the clinical abbreviations that collide with gated legal forms — `pt`
+ * (Physical Therapy), `sca` (Sudden Cardiac Arrest), `scs` (Spinal Cord Stimulator) — plus a couple
+ * of always-clinical ones for future-proofing.
+ */
+const DOMAIN_PROTECTED = {
+    general: [],
+    healthcare: ["pt", "sca", "scs", "ot", "dpt"],
+};
+/**
+ * Compute the effective designation strip-set for the given context: `(base ∪ jurisdiction-pack) −
+ * domain-protect-pack`. Returns the shared base set unchanged when no context is given (the
+ * byte-stable default), so the common path allocates nothing.
+ */
+function resolveDesignations(options) {
+    const jurisdiction = options?.jurisdiction?.trim().toUpperCase();
+    const jurisdictionPack = jurisdiction ? JURISDICTION_DESIGNATIONS[jurisdiction] : undefined;
+    const protectPack = options?.domain ? DOMAIN_PROTECTED[options.domain] : undefined;
+    if (!jurisdictionPack && !protectPack?.length)
+        return BASE_DESIGNATIONS;
+    const set = new Set(BASE_DESIGNATIONS);
+    if (jurisdictionPack)
+        for (const token of jurisdictionPack)
+            set.add(token);
+    if (protectPack)
+        for (const token of protectPack)
+            set.delete(token);
+    return set;
+}
 /** Splits a `doing business as` / trade-name clause from a legal name. */
 const DBA_PATTERN = /\s+(?:d\/b\/a|dba|doing business as|t\/a|trading as|a\/k\/a|aka|fka|f\/k\/a)\s+/i;
 /**
@@ -82,7 +152,7 @@ const DBA_PATTERN = /\s+(?:d\/b\/a|dba|doing business as|t\/a|trading as|a\/k\/a
  * remove a leading `the`, strip legal designations, collapse whitespace. Returns the key plus the
  * designations it removed.
  */
-function canonicalizeFragment(fragment) {
+function canonicalizeFragment(fragment, designationSet) {
     const normalized = fragment
         .normalize("NFKD")
         .replace(/[̀-ͯ]/g, "")
@@ -101,7 +171,7 @@ function canonicalizeFragment(fragment) {
     for (const token of normalized.split(" ")) {
         if (!token)
             continue;
-        if (DESIGNATIONS.has(token))
+        if (designationSet.has(token))
             designations.push(token);
         else
             kept.push(token);
@@ -111,16 +181,22 @@ function canonicalizeFragment(fragment) {
 /**
  * Canonicalize an organization name: split off any `doing business as` clause, then reduce the
  * legal name to a designation-stripped key. Returns `null` for empty input.
+ *
+ * Pass {@link CanonicalizeOptions} to resolve the jurisdiction × domain collision (#668): a
+ * `jurisdiction` adds that country's legal forms, a `domain` protects its meaningful abbreviations.
+ * With no options the universal base set is used and the result is byte-for-byte the legacy
+ * behavior.
  */
-export function canonicalizeOrganizationName(input) {
+export function canonicalizeOrganizationName(input, options) {
     if (typeof input !== "string" || !input.trim())
         return null;
     const raw = input;
+    const designationSet = resolveDesignations(options);
     const [legalPart, ...dbaParts] = input.split(DBA_PATTERN);
-    const { canonical, designations } = canonicalizeFragment(legalPart ?? "");
+    const { canonical, designations } = canonicalizeFragment(legalPart ?? "", designationSet);
     const result = { raw, canonical, designations };
     if (dbaParts.length) {
-        const dba = canonicalizeFragment(dbaParts.join(" ")).canonical;
+        const dba = canonicalizeFragment(dbaParts.join(" "), designationSet).canonical;
         if (dba)
             result.dba = dba;
     }

package/out/organization.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mailwoman/record",
-  "version": "4.10.0",
-  "description": "Lean, plain-TypeScript record schema + per-field normalizers for the geocode-first matcher. Address-first: the canonical PostalAddress record composes parser components, the formatter's match key, and a resolved geocode; organization + contact records build on the same spine.",
+  "version": "4.12.0",
+  "description": "Lean, plain-TypeScript record schema + per-field normalizers for the geocode-first matcher. Address-first: the canonical PostalAddress record composes parser components, the formatter's match key, and a resolved geocode; organization + contact records build on the same canonical record.",
   "license": "AGPL-3.0-only",
   "repository": {
     "type": "git",
@@ -17,7 +17,7 @@
     "./organization": "./out/organization.js"
   },
   "dependencies": {
-    "@mailwoman/formatter": "4.10.0"
+    "@mailwoman/formatter": "4.12.0"
   },
   "devDependencies": {
     "@types/node": "^25.9.2"