@mailwoman/registry 4.8.1

package/out/geojson.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Export resolved entities as GeoJSON — the bridge to QGIS and any web map. Each entity becomes a
+ *   Point at its resolved coordinate, carrying the properties an analyst needs: how many records
+ *   merged into it, how tightly (cohesion), the canonical name/org/address, and the geocode tier
+ *   (so rooftop-precise entities can be styled apart from admin-centroid guesses). Entities without
+ *   a coordinate are omitted (a Point feature needs one).
+ */
+import type { GeoJsonFeatureCollection, ResolvedEntity } from "./types.js";
+/**
+ * Convert resolved entities into a GeoJSON `FeatureCollection` of points, ready for QGIS. Entities
+ * with no resolved coordinate are skipped.
+ */
+export declare function toGeoJSON(entities: readonly ResolvedEntity[]): GeoJsonFeatureCollection;
+//# sourceMappingURL=geojson.d.ts.map

package/out/geojson.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geojson.d.ts","sourceRoot":"","sources":["../geojson.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAkB,wBAAwB,EAAE,cAAc,EAAgB,MAAM,YAAY,CAAA;AAmCxG;;;GAGG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,GAAG,wBAAwB,CAKvF"}

package/out/geojson.js

@@ -0,0 +1,54 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Export resolved entities as GeoJSON — the bridge to QGIS and any web map. Each entity becomes a
+ *   Point at its resolved coordinate, carrying the properties an analyst needs: how many records
+ *   merged into it, how tightly (cohesion), the canonical name/org/address, and the geocode tier
+ *   (so rooftop-precise entities can be styled apart from admin-centroid guesses). Entities without
+ *   a coordinate are omitted (a Point feature needs one).
+ */
+/** Assemble a display name from a record's parsed person name, if any. */
+function displayName(record) {
+    const name = record.name;
+    if (!name)
+        return null;
+    const joined = [name.prefix, name.given, name.middle, name.familyParticle, name.family, name.suffix]
+        .filter(Boolean)
+        .join(" ")
+        .trim();
+    return joined || null;
+}
+/** One entity → one GeoJSON Point feature. */
+function toFeature(entity) {
+    const rep = entity.representative;
+    return {
+        type: "Feature",
+        geometry: {
+            type: "Point",
+            coordinates: [entity.coordinate.longitude, entity.coordinate.latitude],
+        },
+        properties: {
+            entityId: entity.id,
+            recordCount: entity.records.length,
+            cohesion: entity.cohesion,
+            sourceIds: entity.records.map((r) => r.id),
+            name: displayName(rep),
+            organization: rep.organization?.canonical ?? null,
+            address: rep.address?.formatted ?? null,
+            geocodeTier: rep.address?.geocode?.tier ?? null,
+        },
+    };
+}
+/**
+ * Convert resolved entities into a GeoJSON `FeatureCollection` of points, ready for QGIS. Entities
+ * with no resolved coordinate are skipped.
+ */
+export function toGeoJSON(entities) {
+    return {
+        type: "FeatureCollection",
+        features: entities.filter((entity) => entity.coordinate).map(toFeature),
+    };
+}
+//# sourceMappingURL=geojson.js.map

package/out/geojson.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geojson.js","sourceRoot":"","sources":["../geojson.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,0EAA0E;AAC1E,SAAS,WAAW,CAAC,MAAoB;IACxC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAA;IACxB,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAA;IACtB,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;SAClG,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,GAAG,CAAC;SACT,IAAI,EAAE,CAAA;IACR,OAAO,MAAM,IAAI,IAAI,CAAA;AACtB,CAAC;AAED,8CAA8C;AAC9C,SAAS,SAAS,CAAC,MAAsB;IACxC,MAAM,GAAG,GAAG,MAAM,CAAC,cAAc,CAAA;IACjC,OAAO;QACN,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE;YACT,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,CAAC,MAAM,CAAC,UAAW,CAAC,SAAS,EAAE,MAAM,CAAC,UAAW,CAAC,QAAQ,CAAC;SACxE;QACD,UAAU,EAAE;YACX,QAAQ,EAAE,MAAM,CAAC,EAAE;YACnB,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM;YAClC,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1C,IAAI,EAAE,WAAW,CAAC,GAAG,CAAC;YACtB,YAAY,EAAE,GAAG,CAAC,YAAY,EAAE,SAAS,IAAI,IAAI;YACjD,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,SAAS,IAAI,IAAI;YACvC,WAAW,EAAE,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,IAAI,IAAI;SAC/C;KACD,CAAA;AACF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,QAAmC;IAC5D,OAAO;QACN,IAAI,EAAE,mBAAmB;QACzB,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC;KACvE,CAAA;AACF,CAAC"}

package/out/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `@mailwoman/registry` — the geocode-first record-matching application.
+ *
+ *   {@link resolveEntities} runs the whole matcher (block → score → cluster) over normalized
+ *   contact/organization {@link SourceRecord}s and returns canonical {@link ResolvedEntity entities};
+ *   {@link toGeoJSON} exports them for QGIS. This is the clinic-funding use case mailwoman was built
+ *   for, finally standing on a calibrated, label-free matcher.
+ */
+export * from "./geojson.js";
+export * from "./ingest.js";
+export * from "./resolve.js";
+export * from "./types.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,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA"}

package/out/index.js

@@ -0,0 +1,17 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `@mailwoman/registry` — the geocode-first record-matching application.
+ *
+ *   {@link resolveEntities} runs the whole matcher (block → score → cluster) over normalized
+ *   contact/organization {@link SourceRecord}s and returns canonical {@link ResolvedEntity entities};
+ *   {@link toGeoJSON} exports them for QGIS. This is the clinic-funding use case mailwoman was built
+ *   for, finally standing on a calibrated, label-free matcher.
+ */
+export * from "./geojson.js";
+export * from "./ingest.js";
+export * from "./resolve.js";
+export * from "./types.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,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA"}

package/out/ingest.d.ts

@@ -0,0 +1,74 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Ingest — turn messy tabular data (CSV, SQLite, hand-keyed spreadsheets) into normalized
+ *   {@link SourceRecord}s, the front of the cascade.
+ *
+ *   Two concerns, kept separate:
+ *
+ *   1. **Column mapping + normalization** (this is pure): a {@link ColumnMapping} says which column(s)
+ *        hold the name, organization, address, phone, email; each row is normalized with
+ *        `@mailwoman/record` (parse the person name, canonicalize the org). This is deterministic
+ *        and testable with no heavy runtime.
+ *   2. **Geocoding** (the heavy part) is an injected seam — a {@link GeocodeAddress} the caller provides.
+ *        Ingest never imports the neural parser, the resolver, or the shards; it just calls the
+ *        seam per address. {@link geocodeAddressVia} builds that seam from mailwoman's real parse +
+ *        geocode primitives (which the CLI constructs with the model + data in hand), so the wiring
+ *        is concrete and testable without pinning the heavy runtime into this package.
+ *
+ *   LLM-assisted column mapping (infer the mapping from a header + samples) is a documented
+ *   fast-follow; the mapping is an explicit input here.
+ */
+import type { AddressGeocode, PostalAddress } from "@mailwoman/record";
+import { toPostalAddress } from "@mailwoman/record";
+import type { SourceRecord } from "./types.js";
+/** Resolve a raw address string into a {@link PostalAddress}. The seam to mailwoman's geocoder. */
+export type GeocodeAddress = (raw: string) => Promise<PostalAddress | null> | PostalAddress | null;
+/** Maps dataset columns to record fields. A field may draw from several columns (joined with
+spaces). */
+export interface ColumnMapping {
+    /** Column holding a stable row id. Falls back to the row index. */
+    id?: string;
+    /** A literal provenance label for every row (not a column). */
+    source?: string;
+    name?: string | string[];
+    organization?: string | string[];
+    address?: string | string[];
+    phone?: string;
+    email?: string;
+}
+/** Options for {@link ingestRows}. */
+export interface IngestOptions {
+    /** The geocoding seam. Without it, records carry name/org but no resolved address. */
+    geocodeAddress?: GeocodeAddress;
+}
+/** Parse a CSV string (with a header row) into row objects keyed by column name. */
+export declare function parseCsv(text: string): Record<string, string>[];
+/** Normalize tabular rows into {@link SourceRecord}s under a {@link ColumnMapping}. */
+export declare function ingestRows(rows: Iterable<Record<string, string>>, mapping: ColumnMapping, opts?: IngestOptions): Promise<SourceRecord[]>;
+/**
+ * The subset of mailwoman's `GeocodeResult` the adapter consumes — kept structural so this package
+ * never imports the heavy geocoder, yet a real `GeocodeResult` maps straight in.
+ */
+export interface RawGeocode {
+    lat: number | null;
+    lon: number | null;
+    resolution_tier: AddressGeocode["tier"];
+    uncertainty_m: number | null;
+    hierarchy?: AddressGeocode["hierarchy"];
+}
+/**
+ * Build a {@link GeocodeAddress} from mailwoman's real parse + geocode primitives (injected — the
+ * CLI constructs the neural parser, resolver, and shards and passes them in). Parse → components →
+ * {@link toPostalAddress} (which fills the canonical key + formatted form) → attach the resolved
+ * coordinate. When geocoding can't place the address, the parsed-but-unlocated address is still
+ * returned.
+ */
+export declare function geocodeAddressVia(deps: {
+    parse: (raw: string) => Promise<Parameters<typeof toPostalAddress>[0]> | Parameters<typeof toPostalAddress>[0];
+    geocode: (raw: string) => Promise<RawGeocode | null> | RawGeocode | null;
+    country?: string;
+}): GeocodeAddress;
+//# sourceMappingURL=ingest.d.ts.map

package/out/ingest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.d.ts","sourceRoot":"","sources":["../ingest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACtE,OAAO,EAAiD,eAAe,EAAe,MAAM,mBAAmB,CAAA;AAE/G,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,mGAAmG;AACnG,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,aAAa,GAAG,IAAI,CAAA;AAElG;WACW;AACX,MAAM,WAAW,aAAa;IAC7B,mEAAmE;IACnE,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IACxB,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IAChC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAED,sCAAsC;AACtC,MAAM,WAAW,aAAa;IAC7B,sFAAsF;IACtF,cAAc,CAAC,EAAE,cAAc,CAAA;CAC/B;AAED,oFAAoF;AACpF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAE/D;AAcD,uFAAuF;AACvF,wBAAsB,UAAU,CAC/B,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EACtC,OAAO,EAAE,aAAa,EACtB,IAAI,GAAE,aAAkB,GACtB,OAAO,CAAC,YAAY,EAAE,CAAC,CA2BzB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IAC1B,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,eAAe,EAAE,cAAc,CAAC,MAAM,CAAC,CAAA;IACvC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,SAAS,CAAC,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;CACvC;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACvC,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC,CAAC,CAAA;IAC9G,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,UAAU,GAAG,IAAI,CAAA;IACxE,OAAO,CAAC,EAAE,MAAM,CAAA;CAChB,GAAG,cAAc,CAgBjB"}

package/out/ingest.js

@@ -0,0 +1,89 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Ingest — turn messy tabular data (CSV, SQLite, hand-keyed spreadsheets) into normalized
+ *   {@link SourceRecord}s, the front of the cascade.
+ *
+ *   Two concerns, kept separate:
+ *
+ *   1. **Column mapping + normalization** (this is pure): a {@link ColumnMapping} says which column(s)
+ *        hold the name, organization, address, phone, email; each row is normalized with
+ *        `@mailwoman/record` (parse the person name, canonicalize the org). This is deterministic
+ *        and testable with no heavy runtime.
+ *   2. **Geocoding** (the heavy part) is an injected seam — a {@link GeocodeAddress} the caller provides.
+ *        Ingest never imports the neural parser, the resolver, or the shards; it just calls the
+ *        seam per address. {@link geocodeAddressVia} builds that seam from mailwoman's real parse +
+ *        geocode primitives (which the CLI constructs with the model + data in hand), so the wiring
+ *        is concrete and testable without pinning the heavy runtime into this package.
+ *
+ *   LLM-assisted column mapping (infer the mapping from a header + samples) is a documented
+ *   fast-follow; the mapping is an explicit input here.
+ */
+import { canonicalizeOrganizationName, parsePersonName, toPostalAddress, withGeocode } from "@mailwoman/record";
+import { parse as parseCsvSync } from "csv-parse/sync";
+/** Parse a CSV string (with a header row) into row objects keyed by column name. */
+export function parseCsv(text) {
+    return parseCsvSync(text, { columns: true, skip_empty_lines: true, trim: true, relax_column_count: true });
+}
+/** Join the named column(s) of a row into a single trimmed string, or undefined if empty. */
+function pick(row, columns) {
+    if (!columns)
+        return undefined;
+    const list = Array.isArray(columns) ? columns : [columns];
+    const value = list
+        .map((c) => row[c]?.trim())
+        .filter(Boolean)
+        .join(" ")
+        .trim();
+    return value || undefined;
+}
+/** Normalize tabular rows into {@link SourceRecord}s under a {@link ColumnMapping}. */
+export async function ingestRows(rows, mapping, opts = {}) {
+    const records = [];
+    let index = 0;
+    for (const row of rows) {
+        const id = (mapping.id ? row[mapping.id]?.trim() : "") || String(index);
+        const nameValue = pick(row, mapping.name);
+        const orgValue = pick(row, mapping.organization);
+        const addressValue = pick(row, mapping.address);
+        const record = {
+            id,
+            source: mapping.source,
+            name: nameValue ? parsePersonName(nameValue) : undefined,
+            organization: orgValue ? canonicalizeOrganizationName(orgValue) : undefined,
+            phone: (mapping.phone && row[mapping.phone]?.trim()) || undefined,
+            email: (mapping.email && row[mapping.email]?.trim()?.toLowerCase()) || undefined,
+            address: addressValue && opts.geocodeAddress ? ((await opts.geocodeAddress(addressValue)) ?? undefined) : undefined,
+            raw: row,
+        };
+        records.push(record);
+        index++;
+    }
+    return records;
+}
+/**
+ * Build a {@link GeocodeAddress} from mailwoman's real parse + geocode primitives (injected — the
+ * CLI constructs the neural parser, resolver, and shards and passes them in). Parse → components →
+ * {@link toPostalAddress} (which fills the canonical key + formatted form) → attach the resolved
+ * coordinate. When geocoding can't place the address, the parsed-but-unlocated address is still
+ * returned.
+ */
+export function geocodeAddressVia(deps) {
+    return async (raw) => {
+        const components = await deps.parse(raw);
+        const base = toPostalAddress(components, { country: deps.country, raw });
+        const resolved = await deps.geocode(raw);
+        if (!resolved || resolved.lat === null || resolved.lon === null)
+            return base;
+        const geocode = {
+            coordinate: { latitude: resolved.lat, longitude: resolved.lon },
+            tier: resolved.resolution_tier,
+            uncertaintyMeters: resolved.uncertainty_m,
+            hierarchy: resolved.hierarchy,
+        };
+        return withGeocode(base, geocode);
+    };
+}
+//# sourceMappingURL=ingest.js.map

package/out/ingest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.js","sourceRoot":"","sources":["../ingest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,EAAE,4BAA4B,EAAE,eAAe,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/G,OAAO,EAAE,KAAK,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAA;AA0BtD,oFAAoF;AACpF,MAAM,UAAU,QAAQ,CAAC,IAAY;IACpC,OAAO,YAAY,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC,CAAA;AAC3G,CAAC;AAED,6FAA6F;AAC7F,SAAS,IAAI,CAAC,GAA2B,EAAE,OAA2B;IACrE,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAA;IAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;IACzD,MAAM,KAAK,GAAG,IAAI;SAChB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;SAC1B,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,GAAG,CAAC;SACT,IAAI,EAAE,CAAA;IACR,OAAO,KAAK,IAAI,SAAS,CAAA;AAC1B,CAAC;AAED,uFAAuF;AACvF,MAAM,CAAC,KAAK,UAAU,UAAU,CAC/B,IAAsC,EACtC,OAAsB,EACtB,OAAsB,EAAE;IAExB,MAAM,OAAO,GAAmB,EAAE,CAAA;IAClC,IAAI,KAAK,GAAG,CAAC,CAAA;IAEb,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACxB,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAA;QACvE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;QACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,YAAY,CAAC,CAAA;QAChD,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;QAE/C,MAAM,MAAM,GAAiB;YAC5B,EAAE;YACF,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS;YACxD,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC,4BAA4B,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS;YAC3E,KAAK,EAAE,CAAC,OAAO,CAAC,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,IAAI,SAAS;YACjE,KAAK,EAAE,CAAC,OAAO,CAAC,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,EAAE,WAAW,EAAE,CAAC,IAAI,SAAS;YAChF,OAAO,EACN,YAAY,IAAI,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS;YAC3G,GAAG,EAAE,GAAG;SACR,CAAA;QAED,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACpB,KAAK,EAAE,CAAA;IACR,CAAC;IAED,OAAO,OAAO,CAAA;AACf,CAAC;AAcD;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAIjC;IACA,OAAO,KAAK,EAAE,GAAW,EAAiC,EAAE;QAC3D,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QACxC,MAAM,IAAI,GAAG,eAAe,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,CAAA;QAExE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QACxC,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,GAAG,KAAK,IAAI,IAAI,QAAQ,CAAC,GAAG,KAAK,IAAI;YAAE,OAAO,IAAI,CAAA;QAE5E,MAAM,OAAO,GAAmB;YAC/B,UAAU,EAAE,EAAE,QAAQ,EAAE,QAAQ,CAAC,GAAG,EAAE,SAAS,EAAE,QAAQ,CAAC,GAAG,EAAE;YAC/D,IAAI,EAAE,QAAQ,CAAC,eAAe;YAC9B,iBAAiB,EAAE,QAAQ,CAAC,aAAa;YACzC,SAAS,EAAE,QAAQ,CAAC,SAAS;SAC7B,CAAA;QACD,OAAO,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IAClC,CAAC,CAAA;AACF,CAAC"}

package/out/resolve.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   The resolve pipeline — the whole matcher, wired over concrete contact/organization records: block
+ *   (geo-first) → score (Fellegi-Sunter) → cluster → canonical entities.
+ *
+ *   `resolveEntities` ships sensible geocode-first defaults — block on location / canonical key /
+ *   phone / email; score on name, organization, address key, and great-circle distance — and can
+ *   fit the scorer's `m`/`u` to the data with EM (`trainEM`), so it runs with no labels and no
+ *   per-dataset tuning. Everything is overridable: pass your own model, blocking keys, or
+ *   threshold.
+ *
+ *   Geocoding is assumed already done upstream (each `address` carries its coordinate + canonical
+ *   key). Wiring mailwoman's parser + geocoder to turn raw rows into `SourceRecord`s is the ingest
+ *   layer that sits in front of this.
+ */
+import { type BlockingKey, type FellegiSunterModel } from "@mailwoman/match";
+import type { ResolvedEntity, SourceRecord } from "./types.js";
+/**
+ * The default geocode-first scoring model: name + organization + address key + great-circle
+ * distance.
+ */
+export declare function buildDefaultModel(): FellegiSunterModel<SourceRecord>;
+/** The default blocking keys: a union of location, canonical address, phone, and email. */
+export declare function defaultBlockingKeys(): BlockingKey<SourceRecord>[];
+/** Options for {@link resolveEntities}. */
+export interface ResolveConfig {
+    /** Scoring model. Default {@link buildDefaultModel}. */
+    model?: FellegiSunterModel<SourceRecord>;
+    /** Blocking keys (their union). Default {@link defaultBlockingKeys}. */
+    blockingKeys?: BlockingKey<SourceRecord>[];
+    /** Link two records into the same entity at or above this match weight (bits). Default 0. */
+    threshold?: number;
+    /** Skip and report blocks larger than this rather than scanning them. */
+    maxBlockSize?: number;
+    /**
+     * Fit the model's `m`/`u` to the candidate pairs with EM before scoring (label-free). Default
+     * false.
+     */
+    trainEM?: boolean;
+}
+/** The outcome of a resolve pass. */
+export interface ResolveResult {
+    entities: ResolvedEntity[];
+    /** Number of candidate pairs blocking produced. */
+    candidatePairs: number;
+    /** Blocks too large to scan, surfaced so coverage limits are visible. */
+    droppedBlocks: Array<{
+        key: string;
+        size: number;
+    }>;
+}
+/**
+ * Resolve source records into canonical entities: block → score → cluster. Every record lands in
+ * exactly one entity (a record with no confident link is its own singleton entity).
+ */
+export declare function resolveEntities(records: readonly SourceRecord[], config?: ResolveConfig): ResolveResult;
+//# sourceMappingURL=resolve.d.ts.map

package/out/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../resolve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EACN,KAAK,WAAW,EAChB,KAAK,kBAAkB,EAavB,MAAM,kBAAkB,CAAA;AACzB,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAS9D;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,kBAAkB,CAAC,YAAY,CAAC,CAepE;AAED,2FAA2F;AAC3F,wBAAgB,mBAAmB,IAAI,WAAW,CAAC,YAAY,CAAC,EAAE,CAOjE;AAED,2CAA2C;AAC3C,MAAM,WAAW,aAAa;IAC7B,wDAAwD;IACxD,KAAK,CAAC,EAAE,kBAAkB,CAAC,YAAY,CAAC,CAAA;IACxC,wEAAwE;IACxE,YAAY,CAAC,EAAE,WAAW,CAAC,YAAY,CAAC,EAAE,CAAA;IAC1C,6FAA6F;IAC7F,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,yEAAyE;IACzE,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,qCAAqC;AACrC,MAAM,WAAW,aAAa;IAC7B,QAAQ,EAAE,cAAc,EAAE,CAAA;IAC1B,mDAAmD;IACnD,cAAc,EAAE,MAAM,CAAA;IACtB,yEAAyE;IACzE,aAAa,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CACnD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,EAAE,MAAM,GAAE,aAAkB,GAAG,aAAa,CAsC3G"}

package/out/resolve.js

@@ -0,0 +1,91 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   The resolve pipeline — the whole matcher, wired over concrete contact/organization records: block
+ *   (geo-first) → score (Fellegi-Sunter) → cluster → canonical entities.
+ *
+ *   `resolveEntities` ships sensible geocode-first defaults — block on location / canonical key /
+ *   phone / email; score on name, organization, address key, and great-circle distance — and can
+ *   fit the scorer's `m`/`u` to the data with EM (`trainEM`), so it runs with no labels and no
+ *   per-dataset tuning. Everything is overridable: pass your own model, blocking keys, or
+ *   threshold.
+ *
+ *   Geocoding is assumed already done upstream (each `address` carries its coordinate + canonical
+ *   key). Wiring mailwoman's parser + geocoder to turn raw rows into `SourceRecord`s is the ingest
+ *   layer that sits in front of this.
+ */
+import { DEFAULT_DISTANCE_LEVELS, agreementPattern, block, cluster, distanceComparison, estimateParameters, exactKey, geoCellKey, representative, scorePair, similarityComparison, } from "@mailwoman/match";
+/** Default tiered levels for a name-like text field. `m`/`u` are EM-estimable seeds. */
+const NAME_LEVELS = [
+    { label: "exact", minSimilarity: 1.0, m: 0.8, u: 0.01 },
+    { label: "high", minSimilarity: 0.88, m: 0.15, u: 0.03 },
+    { label: "different", minSimilarity: 0, m: 0.05, u: 0.96 },
+];
+/**
+ * The default geocode-first scoring model: name + organization + address key + great-circle
+ * distance.
+ */
+export function buildDefaultModel() {
+    return {
+        lambda: 0.0001,
+        comparisons: [
+            similarityComparison({ name: "given", extract: (r) => r.name?.given, levels: NAME_LEVELS }),
+            similarityComparison({ name: "family", extract: (r) => r.name?.family, levels: NAME_LEVELS }),
+            similarityComparison({ name: "organization", extract: (r) => r.organization?.canonical, levels: NAME_LEVELS }),
+            similarityComparison({ name: "address", extract: (r) => r.address?.canonicalKey, levels: NAME_LEVELS }),
+            distanceComparison({
+                name: "distance",
+                extract: (r) => r.address?.geocode?.coordinate,
+                levels: DEFAULT_DISTANCE_LEVELS,
+            }),
+        ],
+    };
+}
+/** The default blocking keys: a union of location, canonical address, phone, and email. */
+export function defaultBlockingKeys() {
+    return [
+        geoCellKey((r) => r.address?.geocode?.coordinate),
+        exactKey((r) => r.address?.canonicalKey),
+        exactKey((r) => r.phone),
+        exactKey((r) => r.email),
+    ];
+}
+/**
+ * Resolve source records into canonical entities: block → score → cluster. Every record lands in
+ * exactly one entity (a record with no confident link is its own singleton entity).
+ */
+export function resolveEntities(records, config = {}) {
+    const model = config.model ?? buildDefaultModel();
+    const blockingKeys = config.blockingKeys ?? defaultBlockingKeys();
+    const threshold = config.threshold ?? 0;
+    const { pairs, droppedBlocks } = block(records, blockingKeys, { maxBlockSize: config.maxBlockSize });
+    let scoringModel = model;
+    if (config.trainEM && pairs.length > 0) {
+        const patterns = pairs.map(([a, b]) => agreementPattern(model.comparisons, a, b));
+        scoringModel = estimateParameters(model, patterns).model;
+    }
+    const links = pairs.map(([a, b]) => ({
+        a,
+        b,
+        weight: scorePair(scoringModel, a, b).weight,
+    }));
+    const clusters = cluster(records, links, { threshold });
+    const entities = clusters.map((group, i) => {
+        const members = new Set(group);
+        const intraWeights = links
+            .filter((link) => link.weight >= threshold && members.has(link.a) && members.has(link.b))
+            .map((link) => link.weight);
+        const rep = representative(group) ?? group[0];
+        return {
+            id: `entity-${i}`,
+            records: group,
+            representative: rep,
+            coordinate: rep.address?.geocode?.coordinate ?? undefined,
+            cohesion: group.length > 1 && intraWeights.length > 0 ? Math.min(...intraWeights) : null,
+        };
+    });
+    return { entities, candidatePairs: pairs.length, droppedBlocks };
+}
+//# sourceMappingURL=resolve.js.map

package/out/resolve.js.map

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

package/out/types.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   The application's data shapes — the messy record that goes in, and the canonical entity that
+ *   comes out. Plain interfaces over the `@mailwoman/record` types.
+ */
+import type { OrganizationName, PersonName, PostalAddress } from "@mailwoman/record";
+/** A single source record: one row of a messy contact/organization dataset, after normalization. */
+export interface SourceRecord {
+    /** Stable identifier within the input (row id, primary key…). */
+    id: string;
+    /** Provenance: which file / dataset this came from. */
+    source?: string | null;
+    /** Parsed person name, when the record is a contact. */
+    name?: PersonName | null;
+    /** Canonicalized organization name, when the record is an org. */
+    organization?: OrganizationName | null;
+    /** The address, normalized + (ideally) geocoded. */
+    address?: PostalAddress | null;
+    phone?: string | null;
+    email?: string | null;
+    /** The original row, verbatim, for audit. */
+    raw?: Record<string, string>;
+}
+/** A resolved canonical entity: a cluster of source records judged to be the same real-world thing. */
+export interface ResolvedEntity {
+    /** Identifier assigned to the entity. */
+    id: string;
+    /** The source records that resolved to this entity. */
+    records: SourceRecord[];
+    /** The most complete record, used as the entity's canonical face. */
+    representative: SourceRecord;
+    /** The entity's location, from the representative's geocode. */
+    coordinate?: {
+        latitude: number;
+        longitude: number;
+    };
+    /**
+     * Weakest within-cluster link weight in bits (how tightly it holds together); `null` for a
+     * singleton.
+     */
+    cohesion: number | null;
+}
+export interface GeoJsonPoint {
+    type: "Point";
+    /** `[longitude, latitude]`, per the GeoJSON spec. */
+    coordinates: [number, number];
+}
+export interface GeoJsonFeature {
+    type: "Feature";
+    geometry: GeoJsonPoint;
+    properties: Record<string, unknown>;
+}
+export interface GeoJsonFeatureCollection {
+    type: "FeatureCollection";
+    features: GeoJsonFeature[];
+}
+//# sourceMappingURL=types.d.ts.map

package/out/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAEpF,oGAAoG;AACpG,MAAM,WAAW,YAAY;IAC5B,iEAAiE;IACjE,EAAE,EAAE,MAAM,CAAA;IACV,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,wDAAwD;IACxD,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;IACxB,kEAAkE;IAClE,YAAY,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAA;IACtC,oDAAoD;IACpD,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,CAAA;IAC9B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,6CAA6C;IAC7C,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC5B;AAED,uGAAuG;AACvG,MAAM,WAAW,cAAc;IAC9B,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAA;IACV,uDAAuD;IACvD,OAAO,EAAE,YAAY,EAAE,CAAA;IACvB,qEAAqE;IACrE,cAAc,EAAE,YAAY,CAAA;IAC5B,gEAAgE;IAChE,UAAU,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;IACpD;;;OAGG;IACH,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB;AAID,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,OAAO,CAAA;IACb,qDAAqD;IACrD,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC7B;AAED,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,SAAS,CAAA;IACf,QAAQ,EAAE,YAAY,CAAA;IACtB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED,MAAM,WAAW,wBAAwB;IACxC,IAAI,EAAE,mBAAmB,CAAA;IACzB,QAAQ,EAAE,cAAc,EAAE,CAAA;CAC1B"}

package/out/types.js

@@ -0,0 +1,11 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   The application's data shapes — the messy record that goes in, and the canonical entity that
+ *   comes out. Plain interfaces over the `@mailwoman/record` types.
+ */
+export {};
+//#endregion
+//# sourceMappingURL=types.js.map

package/out/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;;AA0DH,YAAY"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@mailwoman/registry",
+  "version": "4.8.1",
+  "description": "The geocode-first record-matching application: resolve messy contact/organization records into canonical, geocoded entities (block → score → cluster) and export them as GeoJSON for spatial analysis. The clinic-funding use case mailwoman was built for.",
+  "license": "AGPL-3.0-only",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sister-software/mailwoman.git",
+    "directory": "registry"
+  },
+  "type": "module",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": "./out/index.js",
+    "./resolve": "./out/resolve.js",
+    "./geojson": "./out/geojson.js",
+    "./ingest": "./out/ingest.js"
+  },
+  "dependencies": {
+    "@mailwoman/match": "4.8.1",
+    "@mailwoman/record": "4.8.1",
+    "csv-parse": "^5.6.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.2"
+  },
+  "files": [
+    "out/**/*.js",
+    "out/**/*.js.map",
+    "out/**/*.d.ts",
+    "out/**/*.d.ts.map"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}