@mailwoman/record 4.8.1

package/out/address.d.ts

@@ -0,0 +1,85 @@
+/**
+ * @copyright Sister Software
+ * @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.
+ *
+ *   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
+ *   database we reach for Kysely at the call site, not a model layer here.
+ *
+ *   The geocode fields mirror mailwoman's `GeocodeResult` (tier + calibrated uncertainty + hierarchy)
+ *   on purpose: that is the location signal the Fellegi-Sunter scorer weights its distance evidence
+ *   by — two records sharing a `address_point` coordinate is strong agreement; sharing an
+ *   `interpolated` centroid is weak; a PO-box / multi-unit coordinate is barely location agreement
+ *   at all (the NAACCR precedent, see the geocode-first record-matching concept doc).
+ */
+import { type ComponentDict, type FormatAddressOptions } from "@mailwoman/formatter";
+/** A geographic coordinate (WGS84 decimal degrees). */
+export interface GeoCoordinate {
+    latitude: number;
+    longitude: number;
+}
+/**
+ * The resolution tier that produced a coordinate, mirroring mailwoman's geocoder (`address_point` >
+ * `interpolated` > `admin`). Kept as a local plain union so this package stays decoupled from the
+ * heavy geocoder runtime; a `GeocodeResult.resolution_tier` maps in directly.
+ */
+export type ResolutionTier = "address_point" | "interpolated" | "admin";
+/** One resolved admin-hierarchy ancestor (most specific first), for spelling-invariant blocking. */
+export interface HierarchyNode {
+    tag: string;
+    value: string;
+    placeId?: string;
+}
+/** A resolved geocode attached to an address record — the location signal the matcher scores on. */
+export interface AddressGeocode {
+    coordinate: GeoCoordinate;
+    tier: ResolutionTier;
+    /** Calibrated uncertainty radius in meters; `null` for the admin tier (no sub-locality estimate). */
+    uncertaintyMeters: number | null;
+    /** Resolved admin hierarchy, locality → country (most specific first). */
+    hierarchy?: HierarchyNode[];
+    /** A delivery point, not a building — weakens location agreement even at a precise coordinate. */
+    poBox?: boolean;
+    /** A multi-unit building where many records share one coordinate — weakens unit-level agreement. */
+    multiUnit?: boolean;
+}
+/**
+ * The canonical address record. Composes the parser's components, the formatter's match key, an
+ * optional human-readable form, and an optional resolved geocode. Plain data — no behavior.
+ */
+export interface PostalAddress {
+    /** Parsed address components (`ComponentTag`-keyed). */
+    components: ComponentDict;
+    /** Normalized, deterministic match key for blocking (from `@mailwoman/formatter`). */
+    canonicalKey: string;
+    /** Optional human-readable single-line form, for display. */
+    formatted?: string;
+    /** Resolved location, when geocoded. */
+    geocode?: AddressGeocode;
+    /** The original free-text input, when known (provenance). */
+    raw?: string;
+}
+/** Options for {@linkcode toPostalAddress}. */
+export interface ToPostalAddressOptions {
+    /** Country (ISO-2 or name) for formatting. Defaults to the `country` component, else unset. */
+    country?: string;
+    /** The original free-text input to retain as provenance. */
+    raw?: string;
+    /** Also compute a human-readable `formatted` string. Default `true`. */
+    format?: boolean;
+    /** Formatting options forwarded to the formatter. Defaults to single-line (`", "`). */
+    formatOptions?: FormatAddressOptions;
+}
+/**
+ * Build a canonical {@linkcode PostalAddress} from parsed components: fills the match key (always)
+ * and a human-readable form (unless disabled). Attach a geocode separately with
+ * {@linkcode withGeocode} once the address is resolved.
+ */
+export declare function toPostalAddress(components: ComponentDict, opts?: ToPostalAddressOptions): PostalAddress;
+/** Attach (or replace) a resolved geocode on an address record, returning a new record. */
+export declare function withGeocode(record: PostalAddress, geocode: AddressGeocode): PostalAddress;
+//# sourceMappingURL=address.d.ts.map

package/out/address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.d.ts","sourceRoot":"","sources":["../address.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,oBAAoB,EAA+B,MAAM,sBAAsB,CAAA;AAEjH,uDAAuD;AACvD,MAAM,WAAW,aAAa;IAC7B,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;CACjB;AAED;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,eAAe,GAAG,cAAc,GAAG,OAAO,CAAA;AAEvE,oGAAoG;AACpG,MAAM,WAAW,aAAa;IAC7B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,oGAAoG;AACpG,MAAM,WAAW,cAAc;IAC9B,UAAU,EAAE,aAAa,CAAA;IACzB,IAAI,EAAE,cAAc,CAAA;IACpB,qGAAqG;IACrG,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,0EAA0E;IAC1E,SAAS,CAAC,EAAE,aAAa,EAAE,CAAA;IAC3B,kGAAkG;IAClG,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,oGAAoG;IACpG,SAAS,CAAC,EAAE,OAAO,CAAA;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC7B,wDAAwD;IACxD,UAAU,EAAE,aAAa,CAAA;IACzB,sFAAsF;IACtF,YAAY,EAAE,MAAM,CAAA;IACpB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,wCAAwC;IACxC,OAAO,CAAC,EAAE,cAAc,CAAA;IACxB,6DAA6D;IAC7D,GAAG,CAAC,EAAE,MAAM,CAAA;CACZ;AAED,+CAA+C;AAC/C,MAAM,WAAW,sBAAsB;IACtC,+FAA+F;IAC/F,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4DAA4D;IAC5D,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,wEAAwE;IACxE,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,uFAAuF;IACvF,aAAa,CAAC,EAAE,oBAAoB,CAAA;CACpC;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,aAAa,EAAE,IAAI,GAAE,sBAA2B,GAAG,aAAa,CAgB3G;AAED,2FAA2F;AAC3F,wBAAgB,WAAW,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,cAAc,GAAG,aAAa,CAEzF"}

package/out/address.js

@@ -0,0 +1,44 @@
+/**
+ * @copyright Sister Software
+ * @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.
+ *
+ *   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
+ *   database we reach for Kysely at the call site, not a model layer here.
+ *
+ *   The geocode fields mirror mailwoman's `GeocodeResult` (tier + calibrated uncertainty + hierarchy)
+ *   on purpose: that is the location signal the Fellegi-Sunter scorer weights its distance evidence
+ *   by — two records sharing a `address_point` coordinate is strong agreement; sharing an
+ *   `interpolated` centroid is weak; a PO-box / multi-unit coordinate is barely location agreement
+ *   at all (the NAACCR precedent, see the geocode-first record-matching concept doc).
+ */
+import { canonicalKey, formatAddress } from "@mailwoman/formatter";
+/**
+ * Build a canonical {@linkcode PostalAddress} from parsed components: fills the match key (always)
+ * and a human-readable form (unless disabled). Attach a geocode separately with
+ * {@linkcode withGeocode} once the address is resolved.
+ */
+export function toPostalAddress(components, opts = {}) {
+    const country = opts.country ?? components.country ?? "";
+    const record = {
+        components,
+        canonicalKey: canonicalKey(components),
+    };
+    if (opts.raw !== undefined)
+        record.raw = opts.raw;
+    if (opts.format !== false) {
+        const formatted = formatAddress(components, country, opts.formatOptions ?? { separator: ", " });
+        if (formatted)
+            record.formatted = formatted;
+    }
+    return record;
+}
+/** Attach (or replace) a resolved geocode on an address record, returning a new record. */
+export function withGeocode(record, geocode) {
+    return { ...record, geocode };
+}
+//# sourceMappingURL=address.js.map

package/out/address.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.js","sourceRoot":"","sources":["../address.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAiD,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAiEjH;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,UAAyB,EAAE,OAA+B,EAAE;IAC3F,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,UAAU,CAAC,OAAO,IAAI,EAAE,CAAA;IAExD,MAAM,MAAM,GAAkB;QAC7B,UAAU;QACV,YAAY,EAAE,YAAY,CAAC,UAAU,CAAC;KACtC,CAAA;IAED,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS;QAAE,MAAM,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAA;IAEjD,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,aAAa,CAAC,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC,aAAa,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAC/F,IAAI,SAAS;YAAE,MAAM,CAAC,SAAS,GAAG,SAAS,CAAA;IAC5C,CAAC;IAED,OAAO,MAAM,CAAA;AACd,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,WAAW,CAAC,MAAqB,EAAE,OAAuB;IACzE,OAAO,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,CAAA;AAC9B,CAAC"}

package/out/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `@mailwoman/record` — the canonicalize layer for the geocode-first matcher.
+ *
+ *   Address-first: {@linkcode PostalAddress} is the spine. 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.
+ */
+export * from "./address.js";
+export * from "./name.js";
+export * from "./organization.js";
+//# sourceMappingURL=index.d.ts.map

package/out/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,mBAAmB,CAAA"}

package/out/index.js

@@ -0,0 +1,16 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `@mailwoman/record` — the canonicalize layer for the geocode-first matcher.
+ *
+ *   Address-first: {@linkcode PostalAddress} is the spine. 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.
+ */
+export * from "./address.js";
+export * from "./name.js";
+export * from "./organization.js";
+//# sourceMappingURL=index.js.map

package/out/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,mBAAmB,CAAA"}

package/out/name.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Person-name parsing — split a full name into components for the matcher to canonicalize and
+ *   compare.
+ *
+ *   A rule-based positional parser, the portable recipe from `python-nameparser`: split on a comma to
+ *   detect `Last, First` inversion, then classify tokens by position against configurable title /
+ *   suffix / particle lists. We deliberately store the surname **particle** (`van`, `de la`, `von`)
+ *   separately from the bare surname (the `theiconic/name-parser` pattern) so the matcher can
+ *   compare `Vega` independent of `de la` — sources that drop or vary the particle still match.
+ *
+ *   Scope + honesty (per the name-canonicalization research pass):
+ *
+ *   - Western / romanized names only. Cultural given-family ORDER variation (East-Asian family-first)
+ *       and transliteration are not handled here — a documented follow-up.
+ *   - Nickname → canonical-root mapping is intentionally NOT done at parse time: it is lossy and
+ *       gendered (Bobbie → Robert _or_ Roberta), so equivalence belongs in the matcher as a fuzzy
+ *       agreement level, not a destructive rewrite. We only _extract_ a parenthetical/quoted
+ *       nickname.
+ *   - A CRF parser (probablepeople) is the gold-standard reference but too heavy to port; this
+ *       positional parser covers the documented hard cases (inversion, particles, generational +
+ *       professional suffixes) without a model.
+ */
+/** A parsed person name. All fields optional — the parser fills what it can identify. */
+export interface PersonName {
+    /** Title / salutation that preceded the name (`Dr`, `Mr`, `Capt`). */
+    prefix?: string;
+    /** First / given name. */
+    given?: string;
+    /** Middle name(s) or initial. */
+    middle?: string;
+    /** Surname, _without_ any particle (`Vega`, not `de la Vega`). */
+    family?: string;
+    /** Surname particle, stored separately (`de la`, `van der`, `von`). */
+    familyParticle?: string;
+    /** Generational or professional suffix (`Jr`, `III`, `PhD`, `MD`). */
+    suffix?: string;
+    /** A parenthetical or quoted nickname (`"Gob"` in `George "Gob" Bluth`). */
+    nickname?: string;
+}
+/**
+ * Parse a full name into components. Returns `null` for empty input. Best-effort and non-throwing —
+ * ambiguous input degrades gracefully rather than erroring.
+ */
+export declare function parsePersonName(input: string | null | undefined): PersonName | null;
+//# sourceMappingURL=name.d.ts.map

package/out/name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"name.d.ts","sourceRoot":"","sources":["../name.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,yFAAyF;AACzF,MAAM,WAAW,UAAU;IAC1B,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,0BAA0B;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,uEAAuE;IACvE,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAA;CACjB;AA8ID;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,UAAU,GAAG,IAAI,CAsFnF"}

package/out/name.js

@@ -0,0 +1,253 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Person-name parsing — split a full name into components for the matcher to canonicalize and
+ *   compare.
+ *
+ *   A rule-based positional parser, the portable recipe from `python-nameparser`: split on a comma to
+ *   detect `Last, First` inversion, then classify tokens by position against configurable title /
+ *   suffix / particle lists. We deliberately store the surname **particle** (`van`, `de la`, `von`)
+ *   separately from the bare surname (the `theiconic/name-parser` pattern) so the matcher can
+ *   compare `Vega` independent of `de la` — sources that drop or vary the particle still match.
+ *
+ *   Scope + honesty (per the name-canonicalization research pass):
+ *
+ *   - Western / romanized names only. Cultural given-family ORDER variation (East-Asian family-first)
+ *       and transliteration are not handled here — a documented follow-up.
+ *   - Nickname → canonical-root mapping is intentionally NOT done at parse time: it is lossy and
+ *       gendered (Bobbie → Robert _or_ Roberta), so equivalence belongs in the matcher as a fuzzy
+ *       agreement level, not a destructive rewrite. We only _extract_ a parenthetical/quoted
+ *       nickname.
+ *   - A CRF parser (probablepeople) is the gold-standard reference but too heavy to port; this
+ *       positional parser covers the documented hard cases (inversion, particles, generational +
+ *       professional suffixes) without a model.
+ */
+/** Titles / salutations that lead a name. Matched case-insensitively, trailing `.` ignored. */
+const TITLES = new Set([
+    "airman",
+    "br",
+    "brig",
+    "brigadier",
+    "capt",
+    "captain",
+    "cmdr",
+    "col",
+    "colonel",
+    "commander",
+    "commissioner",
+    "cpl",
+    "cpt",
+    "dep",
+    "deputy",
+    "doctor",
+    "dr",
+    "father",
+    "fr",
+    "gen",
+    "general",
+    "hon",
+    "honorable",
+    "judge",
+    "lt",
+    "ltcol",
+    "ltgen",
+    "maj",
+    "major",
+    "master",
+    "miss",
+    "mr",
+    "mrs",
+    "ms",
+    "mx",
+    "pastor",
+    "pfc",
+    "pres",
+    "president",
+    "private",
+    "prof",
+    "professor",
+    "pvt",
+    "rabbi",
+    "rep",
+    "representative",
+    "rev",
+    "reverend",
+    "sen",
+    "senator",
+    "sgt",
+    "sir",
+    "sister",
+]);
+/** Generational + professional suffixes that trail a name. */
+const SUFFIXES = new Set([
+    // generational
+    "jr",
+    "sr",
+    "i",
+    "ii",
+    "iii",
+    "iv",
+    "v",
+    "vi",
+    "vii",
+    "viii",
+    // professional / honorific
+    "phd",
+    "md",
+    "do",
+    "dds",
+    "dmd",
+    "dvm",
+    "esq",
+    "esquire",
+    "jd",
+    "llm",
+    "cpa",
+    "rn",
+    "lpn",
+    "pa",
+    "pe",
+    "od",
+    "dc",
+    "dpm",
+    "psyd",
+    "edd",
+    "mba",
+    "mfa",
+    "msw",
+    "pharmd",
+]);
+/**
+ * Surname particles. Consecutive particles fold together (`de` + `la` → `de la`), and the next
+ * non-particle token begins the bare surname.
+ */
+const PARTICLES = new Set([
+    "al",
+    "bin",
+    "da",
+    "das",
+    "de",
+    "del",
+    "della",
+    "den",
+    "der",
+    "di",
+    "do",
+    "dos",
+    "du",
+    "el",
+    "ibn",
+    "la",
+    "le",
+    "lo",
+    "mac",
+    "mc",
+    "san",
+    "santa",
+    "st",
+    "ter",
+    "van",
+    "vande",
+    "vanden",
+    "vander",
+    "vere",
+    "von",
+    "zu",
+    "zur",
+]);
+const isPresent = (s) => typeof s === "string" && s.trim().length > 0;
+const norm = (token) => token.replace(/\.$/, "").toLowerCase();
+const countChar = (s, c) => s.split(c).length - 1;
+/**
+ * Parse a full name into components. Returns `null` for empty input. Best-effort and non-throwing —
+ * ambiguous input degrades gracefully rather than erroring.
+ */
+export function parsePersonName(input) {
+    if (!isPresent(input))
+        return null;
+    const result = {};
+    // 1. Extract a parenthetical "(Jim)" or quoted "Jim" nickname, then strip it out.
+    let working = input
+        .replace(/\s*\(([^)]+)\)\s*/g, (_m, n) => {
+        if (!result.nickname)
+            result.nickname = n.trim();
+        return " ";
+    })
+        .replace(/\s*"([^"]+)"\s*/g, (_m, n) => {
+        if (!result.nickname)
+            result.nickname = n.trim();
+        return " ";
+    })
+        .replace(/\s+/g, " ")
+        .trim();
+    // 2. Resolve a single comma: "Last, First" inversion, unless the tail is a known suffix
+    //    ("John Smith, Jr."), in which case keep order and treat the tail as a suffix.
+    if (countChar(working, ",") === 1) {
+        const [head, tail] = working.split(",").map((p) => p.trim());
+        if (tail && tail.split(/\s+/).every((t) => SUFFIXES.has(norm(t)))) {
+            result.suffix = tail;
+            working = head;
+        }
+        else if (head && tail) {
+            working = `${tail} ${head}`;
+        }
+    }
+    const tokens = working.split(/\s+/).filter(Boolean);
+    if (tokens.length === 0)
+        return Object.keys(result).length ? result : null;
+    // 3. Leading titles → prefix.
+    const prefixParts = [];
+    while (tokens.length > 1 && TITLES.has(norm(tokens[0]))) {
+        prefixParts.push(tokens.shift());
+    }
+    if (prefixParts.length)
+        result.prefix = prefixParts.join(" ");
+    // 4. Trailing suffixes → suffix (a single name token must remain).
+    const suffixParts = [];
+    while (tokens.length > 1 && SUFFIXES.has(norm(tokens[tokens.length - 1]))) {
+        suffixParts.unshift(tokens.pop());
+    }
+    if (suffixParts.length) {
+        result.suffix = isPresent(result.suffix) ? `${suffixParts.join(" ")} ${result.suffix}` : suffixParts.join(" ");
+    }
+    if (tokens.length === 0)
+        return result;
+    // 5. Locate the surname particle run; everything from it onward is the (particled) surname.
+    let particleStart = -1;
+    for (let i = 0; i < tokens.length; i++) {
+        // A particle only starts a surname if a bare-surname token follows it.
+        if (PARTICLES.has(norm(tokens[i])) && i < tokens.length - 1) {
+            particleStart = i;
+            break;
+        }
+    }
+    if (particleStart >= 0) {
+        let i = particleStart;
+        const particleParts = [];
+        while (i < tokens.length - 1 && PARTICLES.has(norm(tokens[i]))) {
+            particleParts.push(tokens[i]);
+            i++;
+        }
+        result.familyParticle = particleParts.join(" ");
+        result.family = tokens.slice(i).join(" ");
+        const before = tokens.slice(0, particleStart);
+        if (before.length)
+            result.given = before[0];
+        if (before.length > 1)
+            result.middle = before.slice(1).join(" ");
+        return result;
+    }
+    // 6. No particle: last token is the surname, first is given, the rest is middle.
+    if (tokens.length === 1) {
+        result.given = tokens[0];
+        return result;
+    }
+    result.given = tokens[0];
+    result.family = tokens[tokens.length - 1];
+    if (tokens.length > 2)
+        result.middle = tokens.slice(1, -1).join(" ");
+    return result;
+}
+//# sourceMappingURL=name.js.map

package/out/name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"name.js","sourceRoot":"","sources":["../name.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAoBH,+FAA+F;AAC/F,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC;IACtB,QAAQ;IACR,IAAI;IACJ,MAAM;IACN,WAAW;IACX,MAAM;IACN,SAAS;IACT,MAAM;IACN,KAAK;IACL,SAAS;IACT,WAAW;IACX,cAAc;IACd,KAAK;IACL,KAAK;IACL,KAAK;IACL,QAAQ;IACR,QAAQ;IACR,IAAI;IACJ,QAAQ;IACR,IAAI;IACJ,KAAK;IACL,SAAS;IACT,KAAK;IACL,WAAW;IACX,OAAO;IACP,IAAI;IACJ,OAAO;IACP,OAAO;IACP,KAAK;IACL,OAAO;IACP,QAAQ;IACR,MAAM;IACN,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,IAAI;IACJ,QAAQ;IACR,KAAK;IACL,MAAM;IACN,WAAW;IACX,SAAS;IACT,MAAM;IACN,WAAW;IACX,KAAK;IACL,OAAO;IACP,KAAK;IACL,gBAAgB;IAChB,KAAK;IACL,UAAU;IACV,KAAK;IACL,SAAS;IACT,KAAK;IACL,KAAK;IACL,QAAQ;CACR,CAAC,CAAA;AAEF,8DAA8D;AAC9D,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC;IACxB,eAAe;IACf,IAAI;IACJ,IAAI;IACJ,GAAG;IACH,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,GAAG;IACH,IAAI;IACJ,KAAK;IACL,MAAM;IACN,2BAA2B;IAC3B,KAAK;IACL,IAAI;IACJ,IAAI;IACJ,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,SAAS;IACT,IAAI;IACJ,KAAK;IACL,KAAK;IACL,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,KAAK;IACL,MAAM;IACN,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,QAAQ;CACR,CAAC,CAAA;AAEF;;;GAGG;AACH,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC;IACzB,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,KAAK;IACL,OAAO;IACP,KAAK;IACL,KAAK;IACL,IAAI;IACJ,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,KAAK;IACL,OAAO;IACP,IAAI;IACJ,KAAK;IACL,KAAK;IACL,OAAO;IACP,QAAQ;IACR,QAAQ;IACR,MAAM;IACN,KAAK;IACL,IAAI;IACJ,KAAK;CACL,CAAC,CAAA;AAEF,MAAM,SAAS,GAAG,CAAC,CAA4B,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAA;AAC7G,MAAM,IAAI,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAA;AAC9E,MAAM,SAAS,GAAG,CAAC,CAAS,EAAE,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAA;AAEzE;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,KAAgC;IAC/D,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IAElC,MAAM,MAAM,GAAe,EAAE,CAAA;IAE7B,kFAAkF;IAClF,IAAI,OAAO,GAAG,KAAK;SACjB,OAAO,CAAC,oBAAoB,EAAE,CAAC,EAAE,EAAE,CAAS,EAAE,EAAE;QAChD,IAAI,CAAC,MAAM,CAAC,QAAQ;YAAE,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC,IAAI,EAAE,CAAA;QAChD,OAAO,GAAG,CAAA;IACX,CAAC,CAAC;SACD,OAAO,CAAC,kBAAkB,EAAE,CAAC,EAAE,EAAE,CAAS,EAAE,EAAE;QAC9C,IAAI,CAAC,MAAM,CAAC,QAAQ;YAAE,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC,IAAI,EAAE,CAAA;QAChD,OAAO,GAAG,CAAA;IACX,CAAC,CAAC;SACD,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,IAAI,EAAE,CAAA;IAER,wFAAwF;IACxF,mFAAmF;IACnF,IAAI,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACnC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;QAC5D,IAAI,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACnE,MAAM,CAAC,MAAM,GAAG,IAAI,CAAA;YACpB,OAAO,GAAG,IAAK,CAAA;QAChB,CAAC;aAAM,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;YACzB,OAAO,GAAG,GAAG,IAAI,IAAI,IAAI,EAAE,CAAA;QAC5B,CAAC;IACF,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IACnD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAA;IAE1E,8BAA8B;IAC9B,MAAM,WAAW,GAAa,EAAE,CAAA;IAChC,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,CAAC,EAAE,CAAC;QAC1D,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAG,CAAC,CAAA;IAClC,CAAC;IACD,IAAI,WAAW,CAAC,MAAM;QAAE,MAAM,CAAC,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAE7D,mEAAmE;IACnE,MAAM,WAAW,GAAa,EAAE,CAAA;IAChC,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,CAAC,EAAE,CAAC;QAC5E,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,EAAG,CAAC,CAAA;IACnC,CAAC;IACD,IAAI,WAAW,CAAC,MAAM,EAAE,CAAC;QACxB,MAAM,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC/G,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAA;IAEtC,4FAA4F;IAC5F,IAAI,aAAa,GAAG,CAAC,CAAC,CAAA;IACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,uEAAuE;QACvE,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9D,aAAa,GAAG,CAAC,CAAA;YACjB,MAAK;QACN,CAAC;IACF,CAAC;IAED,IAAI,aAAa,IAAI,CAAC,EAAE,CAAC;QACxB,IAAI,CAAC,GAAG,aAAa,CAAA;QACrB,MAAM,aAAa,GAAa,EAAE,CAAA;QAClC,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,CAAC,EAAE,CAAC;YACjE,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,CAAA;YAC9B,CAAC,EAAE,CAAA;QACJ,CAAC;QACD,MAAM,CAAC,cAAc,GAAG,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAC/C,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACzC,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,aAAa,CAAC,CAAA;QAC7C,IAAI,MAAM,CAAC,MAAM;YAAE,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAA;QAC3C,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAChE,OAAO,MAAM,CAAA;IACd,CAAC;IAED,iFAAiF;IACjF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAA;QACxB,OAAO,MAAM,CAAA;IACd,CAAC;IACD,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAA;IACxB,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IACzC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAEpE,OAAO,MAAM,CAAA;AACd,CAAC"}

package/out/organization.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Organization-name canonicalization — reduce a company name to a stable, comparable key.
+ *
+ *   Winkler's record-linkage recipe: words of little distinguishing power (the legal designation —
+ *   `Corporation`, `Limited`, `LLC`) are normalized away before matching, so `Acme Corp` and `Acme
+ *   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`.
+ *
+ *   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).
+ */
+/** A canonicalized organization name. */
+export interface OrganizationName {
+    /** The original input, verbatim. */
+    raw: string;
+    /** Normalized, designation-stripped key for blocking and comparison. */
+    canonical: string;
+    /** Legal designations that were stripped (`llc`, `inc`, `gmbh`), in encounter order. */
+    designations: string[];
+    /** The `doing business as` / trade-name clause, canonicalized, when one was present. */
+    dba?: string;
+}
+/**
+ * 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.
+ */
+export declare function canonicalizeOrganizationName(input: string | null | undefined): OrganizationName | null;
+//# sourceMappingURL=organization.d.ts.map

package/out/organization.d.ts.map

@@ -0,0 +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"}

package/out/organization.js

@@ -0,0 +1,129 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Organization-name canonicalization — reduce a company name to a stable, comparable key.
+ *
+ *   Winkler's record-linkage recipe: words of little distinguishing power (the legal designation —
+ *   `Corporation`, `Limited`, `LLC`) are normalized away before matching, so `Acme Corp` and `Acme
+ *   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`.
+ *
+ *   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).
+ */
+/**
+ * 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`).
+ */
+const DESIGNATIONS = new Set([
+    "inc",
+    "incorporated",
+    "corp",
+    "corporation",
+    "co",
+    "company",
+    "llc",
+    "lllp",
+    "llp",
+    "pllc",
+    "lp",
+    "ltd",
+    "limited",
+    "plc",
+    "pc",
+    "pa",
+    "ag",
+    "sa",
+    "sas",
+    "sarl",
+    "sl",
+    "gmbh",
+    "mbh",
+    "ug",
+    "bv",
+    "nv",
+    "oy",
+    "oyj",
+    "ab",
+    "as",
+    "asa",
+    "spa",
+    "srl",
+    "kg",
+    "kgaa",
+    "kk",
+    "pty",
+    "proprietary",
+    "bhd",
+    "sdn",
+    "cc",
+    "cv",
+    "ulc",
+    "aps",
+    "kft",
+    "zrt",
+    "doo",
+    "ood",
+    "ead",
+]);
+/** 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;
+/**
+ * Canonicalize one name fragment: lowercase, strip accents, connectives → `and`, drop punctuation,
+ * remove a leading `the`, strip legal designations, collapse whitespace. Returns the key plus the
+ * designations it removed.
+ */
+function canonicalizeFragment(fragment) {
+    const normalized = fragment
+        .normalize("NFKD")
+        .replace(/[̀-ͯ]/g, "")
+        .toLowerCase()
+        // connective punctuation joins words rather than vanishing: "AT&T" → "at and t"
+        .replace(/&/g, " and ")
+        .replace(/\+/g, " and ")
+        // periods + apostrophes are intra-token, so remove (not space): "S.A." → "sa", "Macy's" → "macys"
+        .replace(/[.'’]/g, "")
+        .replace(/[^a-z0-9\s]/g, " ")
+        .replace(/\s+/g, " ")
+        .trim()
+        .replace(/^the\s+/, "");
+    const designations = [];
+    const kept = [];
+    for (const token of normalized.split(" ")) {
+        if (!token)
+            continue;
+        if (DESIGNATIONS.has(token))
+            designations.push(token);
+        else
+            kept.push(token);
+    }
+    return { canonical: kept.join(" "), designations };
+}
+/**
+ * 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.
+ */
+export function canonicalizeOrganizationName(input) {
+    if (typeof input !== "string" || !input.trim())
+        return null;
+    const raw = input;
+    const [legalPart, ...dbaParts] = input.split(DBA_PATTERN);
+    const { canonical, designations } = canonicalizeFragment(legalPart ?? "");
+    const result = { raw, canonical, designations };
+    if (dbaParts.length) {
+        const dba = canonicalizeFragment(dbaParts.join(" ")).canonical;
+        if (dba)
+            result.dba = dba;
+    }
+    return result;
+}
+//# sourceMappingURL=organization.js.map

package/out/organization.js.map

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

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@mailwoman/record",
+  "version": "4.8.1",
+  "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.",
+  "license": "AGPL-3.0-only",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sister-software/mailwoman.git",
+    "directory": "record"
+  },
+  "type": "module",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": "./out/index.js",
+    "./address": "./out/address.js",
+    "./name": "./out/name.js",
+    "./organization": "./out/organization.js"
+  },
+  "dependencies": {
+    "@mailwoman/formatter": "4.8.1"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.2"
+  },
+  "files": [
+    "out/**/*.js",
+    "out/**/*.js.map",
+    "out/**/*.d.ts",
+    "out/**/*.d.ts.map"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}