@mailwoman/core 2.1.0 → 2.2.0

package/out/decoder/build-tree.js

@@ -27,25 +27,50 @@ function bioParts(label) {
     const dash = label.indexOf("-");
     return { prefix: label.slice(0, dash), tag: label.slice(dash + 1) };
 }
-function flush(open, raw, out) {
+// Unicode-aware boundary trim: shrink (start, end) past leading/trailing chars that aren't letters
+// or numbers. Reason: BIO span boundaries from the model occasionally include a preceding comma+
+// space or trailing punctuation token (the "boundary slip" diagnosed in v0.4.0 — see PHASE_2's
+// v0.4.0 entry). The model's tag attribution is correct, only the boundary is fuzzy. Trimming
+// produces a clean canonical value AND clean start/end offsets so downstream consumers slicing
+// raw[start:end] get the same string as node.value.
+function trimBoundary(raw, start, end) {
+    let s = start;
+    let e = end;
+    const isWordChar = (i) => /[\p{L}\p{N}]/u.test(raw[i] ?? "");
+    while (s < e && !isWordChar(s))
+        s++;
+    while (e > s && !isWordChar(e - 1))
+        e--;
+    return { start: s, end: e };
+}
+function flush(open, raw, out, attribution) {
     if (!open)
         return null;
-    const value = raw.slice(open.start, open.end);
+    const { start, end } = trimBoundary(raw, open.start, open.end);
+    // A span that trims to empty (all-punctuation) is meaningless — drop it. Confidence is moot.
+    if (start >= end)
+        return null;
+    const value = raw.slice(start, end);
     const confidence = open.confidences.reduce((a, b) => a + b, 0) / open.confidences.length;
-    out.push({ tag: open.tag, start: open.start, end: open.end, value, confidence, children: [] });
+    const node = { tag: open.tag, start, end, value, confidence, children: [] };
+    if (attribution.source !== undefined)
+        node.source = attribution.source;
+    if (attribution.sourceId !== undefined)
+        node.sourceId = attribution.sourceId;
+    out.push(node);
     return null;
 }
-function emitSpans(raw, tokens) {
+function emitSpans(raw, tokens, attribution) {
     const out = [];
     let open = null;
     for (const tok of tokens) {
         const { prefix, tag } = bioParts(tok.label);
         if (prefix === "O") {
-            open = flush(open, raw, out);
+            open = flush(open, raw, out, attribution);
             continue;
         }
         if (prefix === "B" || open === null || open.tag !== tag) {
-            open = flush(open, raw, out);
+            open = flush(open, raw, out, attribution);
             open = { tag: tag, start: tok.start, end: tok.end, confidences: [tok.confidence] };
             continue;
         }
@@ -53,7 +78,7 @@ function emitSpans(raw, tokens) {
         open.end = tok.end;
         open.confidences.push(tok.confidence);
     }
-    flush(open, raw, out);
+    flush(open, raw, out, attribution);
     return out;
 }
 function distance(a, b) {
@@ -83,9 +108,12 @@ function sortByStart(nodes) {
  *
  * @param raw The original input as fed to the tokenizer.
  * @param tokens Model output: one entry per piece with predicted BIO label + confidence.
+ * @param opts Optional attribution stamped on every emitted node. Callers in the neural pipeline
+ *   pass `{ source: "neural", sourceId: <model-card-version> }` to mark provenance for the XML
+ *   serializer's `src` attribute.
  */
-export function buildAddressTree(raw, tokens) {
-    const spans = emitSpans(raw, tokens);
+export function buildAddressTree(raw, tokens, opts = {}) {
+    const spans = emitSpans(raw, tokens, opts);
     const roots = [];
     for (const span of spans) {
         const parent = findParent(span, spans);

package/out/decoder/build-tree.js.map

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

package/out/decoder/proposals-to-tree.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"proposals-to-tree.d.ts","sourceRoot":"","sources":["../../decoder/proposals-to-tree.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAgB,MAAM,mBAAmB,CAAA;AAC7E,OAAO,KAAK,EAAe,WAAW,EAAE,MAAM,YAAY,CAAA;AAE1D,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,sBAAsB,EAAE,GAAG,WAAW,CAWtG"}
+{"version":3,"file":"proposals-to-tree.d.ts","sourceRoot":"","sources":["../../decoder/proposals-to-tree.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAgB,MAAM,mBAAmB,CAAA;AAC7E,OAAO,KAAK,EAAe,WAAW,EAAE,MAAM,YAAY,CAAA;AAE1D,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,sBAAsB,EAAE,GAAG,WAAW,CAatG"}

package/out/decoder/proposals-to-tree.js

@@ -21,6 +21,8 @@ export function proposalsToTree(raw, proposals) {
         end: p.span.end,
         confidence: p.confidence,
         children: [],
+        source: p.source,
+        sourceId: p.source_id,
     }));
     roots.sort((a, b) => a.start - b.start);
     return { raw, roots };

package/out/decoder/proposals-to-tree.js.map

@@ -1 +1 @@
-{"version":3,"file":"proposals-to-tree.js","sourceRoot":"","sources":["../../decoder/proposals-to-tree.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,MAAM,UAAU,eAAe,CAAC,GAAW,EAAE,SAA4C;IACxF,MAAM,KAAK,GAAkB,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAClD,GAAG,EAAE,CAAC,CAAC,SAAyB;QAChC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI;QAClB,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK;QACnB,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG;QACf,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,QAAQ,EAAE,EAAE;KACZ,CAAC,CAAC,CAAA;IACH,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAA;IACvC,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,CAAA;AACtB,CAAC"}
+{"version":3,"file":"proposals-to-tree.js","sourceRoot":"","sources":["../../decoder/proposals-to-tree.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,MAAM,UAAU,eAAe,CAAC,GAAW,EAAE,SAA4C;IACxF,MAAM,KAAK,GAAkB,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAClD,GAAG,EAAE,CAAC,CAAC,SAAyB;QAChC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI;QAClB,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK;QACnB,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG;QACf,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,QAAQ,EAAE,CAAC,CAAC,SAAS;KACrB,CAAC,CAAC,CAAA;IACH,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAA;IACvC,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,CAAA;AACtB,CAAC"}

package/out/decoder/serialize-xml.d.ts

@@ -14,8 +14,15 @@
  *   - `conf` — aggregated confidence in [0, 1], two decimal places.
  *   - `start` / `end` — character offsets in the raw input. Preserves source order alongside the
  *       containment-derived element order.
+ *   - `src` — provenance for the assertion. Formatted as `<source>:<sourceId>` when both fields are
+ *       present on the node, `<source>` when only the broad category is set, omitted when neither
+ *       is. Phase 4.1 surfaces classifier provenance (`rule:whos_on_first`, `neural:v0.3.1-en-us`);
+ *       Phase 4.3 overlays resolver provenance (`resolver:wof-admin:101751119`).
+ *   - `lat` / `lon` — resolver-supplied centroid (Phase 4.3). Emitted only when both are set.
+ *   - `place` — resolver-supplied normalized place URI like `wof:101751119` (Phase 4.3). Emitted only
+ *       when `node.placeId` is set; distinct from `src` so callers that want the bare place id
+ *       without the vendor prefix have a direct attribute to read.
  *   - Root `<address>` carries `raw` — the full input string for round-trip.
- *   - `src` is reserved for Phase 4 (Resolver source provenance) and not emitted here.
  *
  *   ⚠ DOM gotcha: `element.textContent` on a mixed-content node returns the concatenation of all
  *   descendant text (parent value + children values). Use `Array.from(el.childNodes).filter(n =>
@@ -30,6 +37,20 @@ export interface SerializeXmlOpts {
     includeConf?: boolean;
     /** Include `start` + `end` char-offset attributes. Default true. */
     includeOffsets?: boolean;
+    /** Include `src` provenance attribute when the node carries source info. Default true. */
+    includeSrc?: boolean;
+    /** Include `lat` + `lon` resolver-supplied centroid attrs when set on the node. Default true. */
+    includeGeo?: boolean;
+    /** Include `place` resolver-supplied normalized place URI when set. Default true. */
+    includePlace?: boolean;
+    /**
+     * Include `<alternative>` child elements for each runner-up resolver candidate on the node. When
+     * set + node.alternatives is populated, each runner-up is emitted as a self-closing element with
+     * `place`, `name`, `lat`, `lon`, `score` attributes. Default false — keeps output
+     * libpostal-compat when not explicitly requested (Springfield-class disambiguation surfaces only
+     * when the caller asks).
+     */
+    includeAlternatives?: boolean;
 }
 /** Project an `AddressTree` to nested XML with optional confidence/offset attributes. */
 export declare function decodeAsXml(tree: AddressTree, opts?: SerializeXmlOpts): string;

package/out/decoder/serialize-xml.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serialize-xml.d.ts","sourceRoot":"","sources":["../../decoder/serialize-xml.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAe,WAAW,EAAE,MAAM,YAAY,CAAA;AAE1D,MAAM,WAAW,gBAAgB;IAChC,mEAAmE;IACnE,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,iEAAiE;IACjE,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,oEAAoE;IACpE,cAAc,CAAC,EAAE,OAAO,CAAA;CACxB;AA2BD,yFAAyF;AACzF,wBAAgB,WAAW,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,GAAE,gBAAqB,GAAG,MAAM,CAWlF"}
+{"version":3,"file":"serialize-xml.d.ts","sourceRoot":"","sources":["../../decoder/serialize-xml.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,KAAK,EAAe,WAAW,EAAE,MAAM,YAAY,CAAA;AAE1D,MAAM,WAAW,gBAAgB;IAChC,mEAAmE;IACnE,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,iEAAiE;IACjE,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,oEAAoE;IACpE,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,0FAA0F;IAC1F,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,iGAAiG;IACjG,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,qFAAqF;IACrF,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB;;;;;;OAMG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAA;CAC7B;AAoFD,yFAAyF;AACzF,wBAAgB,WAAW,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,GAAE,gBAAqB,GAAG,MAAM,CAelF"}

package/out/decoder/serialize-xml.js

@@ -14,8 +14,15 @@
  *   - `conf` — aggregated confidence in [0, 1], two decimal places.
  *   - `start` / `end` — character offsets in the raw input. Preserves source order alongside the
  *       containment-derived element order.
+ *   - `src` — provenance for the assertion. Formatted as `<source>:<sourceId>` when both fields are
+ *       present on the node, `<source>` when only the broad category is set, omitted when neither
+ *       is. Phase 4.1 surfaces classifier provenance (`rule:whos_on_first`, `neural:v0.3.1-en-us`);
+ *       Phase 4.3 overlays resolver provenance (`resolver:wof-admin:101751119`).
+ *   - `lat` / `lon` — resolver-supplied centroid (Phase 4.3). Emitted only when both are set.
+ *   - `place` — resolver-supplied normalized place URI like `wof:101751119` (Phase 4.3). Emitted only
+ *       when `node.placeId` is set; distinct from `src` so callers that want the bare place id
+ *       without the vendor prefix have a direct attribute to read.
  *   - Root `<address>` carries `raw` — the full input string for round-trip.
- *   - `src` is reserved for Phase 4 (Resolver source provenance) and not emitted here.
  *
  *   ⚠ DOM gotcha: `element.textContent` on a mixed-content node returns the concatenation of all
  *   descendant text (parent value + children values). Use `Array.from(el.childNodes).filter(n =>
@@ -25,24 +32,73 @@
 function escapeXml(s) {
     return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
 }
+function srcAttrValue(node) {
+    if (node.source && node.sourceId)
+        return `${node.source}:${node.sourceId}`;
+    if (node.source)
+        return node.source;
+    if (node.sourceId)
+        return node.sourceId;
+    return null;
+}
+/**
+ * Centroid precision for resolver-supplied lat/lon. 6 decimal places is ~11 cm at the equator —
+ * more than enough for any postal-address resolver and short enough to stay readable.
+ */
+const GEO_PRECISION = 6;
 function attrs(node, opts) {
     const parts = [];
     if (opts.includeOffsets)
         parts.push(`start="${node.start}"`, `end="${node.end}"`);
     if (opts.includeConf)
         parts.push(`conf="${node.confidence.toFixed(2)}"`);
+    if (opts.includeSrc) {
+        const src = srcAttrValue(node);
+        if (src !== null)
+            parts.push(`src="${escapeXml(src)}"`);
+    }
+    // Emit lat + lon together — a centroid is meaningless with only one coordinate. Resolvers that
+    // can produce one but not the other shouldn't decorate the node at all.
+    if (opts.includeGeo && node.lat !== undefined && node.lon !== undefined) {
+        parts.push(`lat="${node.lat.toFixed(GEO_PRECISION)}"`, `lon="${node.lon.toFixed(GEO_PRECISION)}"`);
+    }
+    if (opts.includePlace && node.placeId !== undefined) {
+        parts.push(`place="${escapeXml(node.placeId)}"`);
+    }
     return parts.length === 0 ? "" : " " + parts.join(" ");
 }
+function serializeAlternatives(node, indent) {
+    if (!node.alternatives || node.alternatives.length === 0)
+        return "";
+    const lines = node.alternatives.map((raw) => {
+        const alt = raw;
+        const place = `wof:${alt.id}`;
+        const parts = [
+            `place="${escapeXml(place)}"`,
+            `name="${escapeXml(alt.name)}"`,
+            `placetype="${escapeXml(alt.placetype)}"`,
+            `lat="${alt.lat.toFixed(GEO_PRECISION)}"`,
+            `lon="${alt.lon.toFixed(GEO_PRECISION)}"`,
+            `score="${alt.score.toFixed(3)}"`,
+        ];
+        return `${indent}<alternative ${parts.join(" ")} />`;
+    });
+    return lines.join("\n");
+}
 function serializeNode(node, indent, opts) {
     const a = attrs(node, opts);
     const text = escapeXml(node.value);
     const nl = opts.pretty ? "\n" : "";
     const childIndent = opts.pretty ? indent + "\t" : "";
-    if (node.children.length === 0) {
+    const altsBlock = opts.includeAlternatives ? serializeAlternatives(node, childIndent) : "";
+    const hasChildren = node.children.length > 0;
+    const hasAlts = altsBlock.length > 0;
+    if (!hasChildren && !hasAlts) {
         return `${indent}<${node.tag}${a}>${text}</${node.tag}>`;
     }
-    const children = node.children.map((c) => serializeNode(c, childIndent, opts)).join(nl);
-    return `${indent}<${node.tag}${a}>${text}${nl}${children}${nl}${indent}</${node.tag}>`;
+    const childrenStr = node.children.map((c) => serializeNode(c, childIndent, opts)).join(nl);
+    const inner = [childrenStr, altsBlock].filter(Boolean).join(nl);
+    return `${indent}<${node.tag}${a}>${text}${nl}${inner}${nl}${indent}</${node.tag}>`;
 }
 /** Project an `AddressTree` to nested XML with optional confidence/offset attributes. */
 export function decodeAsXml(tree, opts = {}) {
@@ -50,6 +106,10 @@ export function decodeAsXml(tree, opts = {}) {
         pretty: opts.pretty ?? true,
         includeConf: opts.includeConf ?? true,
         includeOffsets: opts.includeOffsets ?? true,
+        includeSrc: opts.includeSrc ?? true,
+        includeGeo: opts.includeGeo ?? true,
+        includePlace: opts.includePlace ?? true,
+        includeAlternatives: opts.includeAlternatives ?? false,
     };
     const rawAttr = escapeXml(tree.raw);
     const nl = full.pretty ? "\n" : "";

package/out/decoder/serialize-xml.js.map

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

package/out/decoder/types.d.ts

@@ -18,6 +18,12 @@
  *       parser availability.
  *
  *   See `containment.ts` for the parent-of mapping that drives nesting.
+ *
+ *   Phase 4.1 added optional `source` / `sourceId` on `AddressNode` so the XML serializer can emit
+ *   provenance via `src="<source>:<sourceId>"`. The neural pipeline stamps these via
+ *   `BuildTreeOpts`; the proposal-derived path threads them through from `ClassificationProposal`.
+ *   JSON / tuple projections deliberately do not surface provenance — libpostal compat is
+ *   load-bearing.
  */
 import type { BioLabel, ComponentTag } from "../types/component.js";
 export type { BioLabel, ComponentTag };
@@ -55,6 +61,45 @@ export interface AddressNode {
     end: number;
     confidence: number;
     children: AddressNode[];
+    /**
+     * Broad category of the assertion's origin. `"rule"` and `"neural"` come from classifier
+     * proposals; `"resolver"` is set by Phase 4.3's resolver when it overwrites the classifier
+     * attribution (the displaced classifier source lands in `metadata.classifier_source`).
+     */
+    source?: string;
+    /**
+     * Specific identifier within `source`: a rule classifier id like `"whos_on_first"`, a neural
+     * model card version like `"neural-v0.3.1-en-us"`, or a resolver-supplied place id like
+     * `"wof-admin:101751119"`.
+     */
+    sourceId?: string;
+    /** Resolver-supplied centroid latitude (Phase 4.3). Optional — only set when a resolver wins. */
+    lat?: number;
+    /** Resolver-supplied centroid longitude (Phase 4.3). Optional — only set when a resolver wins. */
+    lon?: number;
+    /**
+     * Resolver-supplied normalized place URI (Phase 4.3) — `"wof:101751119"` for a WOF place.
+     * Distinct from `sourceId` (which includes the resolver vendor) so consumers that want the
+     * canonical place id without the vendor prefix have one.
+     */
+    placeId?: string;
+    /**
+     * Opaque per-node metadata bag. Phase 4.3 uses keys `classifier_source` and
+     * `classifier_source_id` to preserve the displaced classifier attribution when a resolver wins.
+     * Never consulted by the decoder or serializers — debugging + downstream telemetry only.
+     */
+    metadata?: Record<string, unknown>;
+    /**
+     * Top-k alternative resolutions for this node, ranked by score (highest first). The winning
+     * candidate is reflected in `placeId` / `lat` / `lon` / `sourceId`. Surfaced for failure mode #8
+     * (Springfield-class ambiguity) — callers needing disambiguation see the runners-up. Empty /
+     * absent when the resolver returned a single candidate.
+     *
+     * Typed as `unknown[]` here to avoid a circular import on `ResolvedPlace`; resolver-emitting code
+     * sets the concrete shape, consumers may cast to `ResolvedPlace[]` from
+     * `@mailwoman/core/resolver`.
+     */
+    alternatives?: ReadonlyArray<unknown>;
 }
 /**
  * The full decoded tree for one parsed address.

package/out/decoder/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../decoder/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAEnE,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAA;AAEtC;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC5B,+FAA+F;IAC/F,KAAK,EAAE,MAAM,CAAA;IACb,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAA;IACb,0DAA0D;IAC1D,GAAG,EAAE,MAAM,CAAA;IACX,2CAA2C;IAC3C,KAAK,EAAE,QAAQ,CAAA;IACf,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAA;CAClB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,WAAW;IAC3B,GAAG,EAAE,YAAY,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,WAAW,EAAE,CAAA;CACvB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC3B,0FAA0F;IAC1F,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,WAAW,EAAE,CAAA;CACpB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../decoder/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAEnE,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAA;AAEtC;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC5B,+FAA+F;IAC/F,KAAK,EAAE,MAAM,CAAA;IACb,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAA;IACb,0DAA0D;IAC1D,GAAG,EAAE,MAAM,CAAA;IACX,2CAA2C;IAC3C,KAAK,EAAE,QAAQ,CAAA;IACf,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAA;CAClB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,WAAW;IAC3B,GAAG,EAAE,YAAY,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,WAAW,EAAE,CAAA;IACvB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iGAAiG;IACjG,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,kGAAkG;IAClG,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAClC;;;;;;;;;OASG;IACH,YAAY,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;CACrC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC3B,0FAA0F;IAC1F,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,WAAW,EAAE,CAAA;CACpB"}

package/out/decoder/types.js

@@ -18,6 +18,12 @@
  *       parser availability.
  *
  *   See `containment.ts` for the parent-of mapping that drives nesting.
+ *
+ *   Phase 4.1 added optional `source` / `sourceId` on `AddressNode` so the XML serializer can emit
+ *   provenance via `src="<source>:<sourceId>"`. The neural pipeline stamps these via
+ *   `BuildTreeOpts`; the proposal-derived path threads them through from `ClassificationProposal`.
+ *   JSON / tuple projections deliberately do not surface provenance — libpostal compat is
+ *   load-bearing.
  */
 export {};
 //# sourceMappingURL=types.js.map

package/out/decoder/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../decoder/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../decoder/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG"}

package/out/errors/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @copyright Sister Software.
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Utilities for working with errors.
+ */
+export * from "./schema.js";
+//# sourceMappingURL=index.d.ts.map

package/out/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../errors/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,aAAa,CAAA"}

package/out/errors/index.js

@@ -0,0 +1,9 @@
+/**
+ * @copyright Sister Software.
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Utilities for working with errors.
+ */
+export * from "./schema.js";
+//# sourceMappingURL=index.js.map

package/out/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../errors/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,aAAa,CAAA"}

package/out/errors/schema.d.ts

@@ -0,0 +1,69 @@
+/**
+ * @copyright Sister Software.
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+import type { StatusCodes } from "http-status-codes";
+/**
+ * Type-helper to extract the status code from a `ResourceError`.
+ */
+export type ExtractResourceErrorStatusCode<T> = T extends ResourceError<infer S> ? S : never;
+declare const kResourceError = "_kResourceError";
+/**
+ * An entity registered with the Federal Communications Commission (FCC) that provides
+ * telecommunications services.
+ */
+export declare class ResourceError<S extends StatusCodes = StatusCodes> extends Error {
+    static DefaultStatus: number;
+    static DefaultMessage: string;
+    [kResourceError]: boolean;
+    static [Symbol.hasInstance](input: unknown): input is ResourceError;
+    static from<S extends StatusCodes = StatusCodes>(statusCode: S, message: string, ...urnSegments: string[]): ResourceError<S>;
+    /**
+     * Given an error, wraps it in a ResourceError instance.
+     */
+    static wrap<E extends Error>(error: E, message?: string, ...urnSegments: string[]): E extends ResourceError<infer ActualStatusCode> ? ResourceError<ActualStatusCode> : ResourceError;
+    /**
+     * Given a possible instance of `Error`, wraps it in a `ResourceError` instance.
+     *
+     * Note that if the error is already an instance of `ResourceError`, it will be returned as-is.
+     */
+    static wrap<S extends StatusCodes>(error: unknown, message?: string, ...urnSegments: string[]): ResourceError<S>;
+    get [Symbol.toStringTag](): string;
+    /**
+     * @title HTTP status code.
+     *
+     * A numeric status code conforming to the HTTP standard.
+     */
+    status: S;
+    /**
+     * @title Error message.
+     *
+     * A human-readable error message explaining the error.
+     */
+    message: string;
+    /**
+     * @title URN identifier.
+     *
+     * A unique identifier for the error, used to reference it in logs and other systems.
+     *
+     * @format uri
+     */
+    name: string;
+    constructor(status: S | undefined, urn: string, message?: string);
+    toJSON(): {
+        name: string;
+        status: S;
+        message: string;
+    };
+    toString(): string;
+}
+/**
+ * @public
+ * @title Resource Error
+ *
+ * An error response from a resource, such as an API, database, or file.
+ */
+export type ResourceErrorSchema = Pick<ResourceError, "status" | "message" | "name">;
+export {};
+//# sourceMappingURL=schema.d.ts.map

package/out/errors/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../errors/schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAEpD;;GAEG;AACH,MAAM,MAAM,8BAA8B,CAAC,CAAC,IAAI,CAAC,SAAS,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;AAE5F,QAAA,MAAM,cAAc,oBAAoB,CAAA;AAExC;;;GAGG;AACH,qBAAa,aAAa,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,CAAE,SAAQ,KAAK;IAC5E,MAAM,CAAC,aAAa,SAAM;IAC1B,MAAM,CAAC,cAAc,SAA+B;IAI7C,CAAC,cAAc,CAAC,UAAO;WAEd,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa;IAS5E,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EAC9C,UAAU,EAAE,CAAC,EACb,OAAO,EAAE,MAAM,EACf,GAAG,WAAW,EAAE,MAAM,EAAE,GACtB,aAAa,CAAC,CAAC,CAAC;IAInB;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,KAAK,EAC1B,KAAK,EAAE,CAAC,EACR,OAAO,CAAC,EAAE,MAAM,EAChB,GAAG,WAAW,EAAE,MAAM,EAAE,GACtB,CAAC,SAAS,aAAa,CAAC,MAAM,gBAAgB,CAAC,GAAG,aAAa,CAAC,gBAAgB,CAAC,GAAG,aAAa;IACpG;;;;OAIG;IACH,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,WAAW,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE,MAAM,EAAE,GAAG,aAAa,CAAC,CAAC,CAAC;IAsChH,IAAW,CAAC,MAAM,CAAC,WAAW,CAAC,WAE9B;IAED;;;;OAIG;IACH,MAAM,EAAE,CAAC,CAAA;IACT;;;;OAIG;IACM,OAAO,EAAG,MAAM,CAAA;IAEzB;;;;;;OAMG;IACM,IAAI,EAAE,MAAM,CAAA;gBAET,MAAM,EAAE,CAAC,YAAW,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,SAA+B;IAQ9E,MAAM;;;;;IAQG,QAAQ,IAAI,MAAM;CASlC;AAED;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,aAAa,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC,CAAA"}

package/out/errors/schema.js

@@ -0,0 +1,102 @@
+/**
+ * @copyright Sister Software.
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+const kResourceError = "_kResourceError";
+/**
+ * An entity registered with the Federal Communications Commission (FCC) that provides
+ * telecommunications services.
+ */
+export class ResourceError extends Error {
+    static DefaultStatus = 500;
+    static DefaultMessage = "An unknown error occurred.";
+    // public readonly $schema = $ResourceError.pathname
+    [kResourceError] = true;
+    static [Symbol.hasInstance](input) {
+        if (!input)
+            return false;
+        if (typeof input !== "object")
+            return false;
+        if (kResourceError in input)
+            return true;
+        return false;
+    }
+    static from(statusCode, message, ...urnSegments) {
+        return new ResourceError(statusCode, urnSegments.length ? urnSegments.join(":") : "unknown", message);
+    }
+    /**
+     * Given a possible instance of `Error`, wraps it in a `ResourceError` instance.
+     *
+     * Note that if the error is already an instance of `ResourceError`, it will be returned as-is.
+     */
+    static wrap(error, message, ...urnSegments) {
+        if (error instanceof ResourceError) {
+            return error;
+        }
+        let status = this.DefaultStatus;
+        if (error instanceof Error) {
+            message ||= error.message || this.DefaultMessage;
+            if ("status" in error) {
+                switch (typeof error.status) {
+                    case "number":
+                        status = error.status;
+                        break;
+                    case "string":
+                        status = parseInt(error.status, 10) || this.DefaultStatus;
+                        break;
+                }
+            }
+        }
+        else {
+            message ||= this.DefaultMessage;
+        }
+        const wrapper = this.from(status, message, ...urnSegments);
+        wrapper.cause = error;
+        return wrapper;
+    }
+    get [Symbol.toStringTag]() {
+        return `ResourceError<${this.name}>`;
+    }
+    /**
+     * @title HTTP status code.
+     *
+     * A numeric status code conforming to the HTTP standard.
+     */
+    status;
+    /**
+     * @title Error message.
+     *
+     * A human-readable error message explaining the error.
+     */
+    message;
+    /**
+     * @title URN identifier.
+     *
+     * A unique identifier for the error, used to reference it in logs and other systems.
+     *
+     * @format uri
+     */
+    name;
+    constructor(status = 500, urn, message = "An unknown error occurred.") {
+        super(message);
+        this.message = message;
+        this.name = urn || [status, "nexus", "isp"].join(":");
+        this.status = status;
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            status: this.status,
+            message: this.message,
+        };
+    }
+    toString() {
+        const messageSegments = [`[${this.status}] (${this.name}) ${this.message}`];
+        if (this.cause instanceof Error && this.cause.message && this.cause !== this) {
+            messageSegments.push(`\nCaused by: ${this.cause.message}`);
+        }
+        return messageSegments.join("\n");
+    }
+}
+//# sourceMappingURL=schema.js.map

package/out/errors/schema.js.map

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

package/out/identifiers.d.ts

@@ -0,0 +1,18 @@
+import type { CamelCase, SnakeCase } from "type-fest";
+/**
+ * Converts a name to snake_case, unless the name is already in all caps.
+ */
+export declare function smartSnakeCase<T extends string>(name: T): T extends Uppercase<T> ? T : SnakeCase<T>;
+/**
+ * Converts a name to camelCase, unless the name is already in all caps.
+ */
+export declare function smartCamelCase<T extends string>(name: T): T extends Uppercase<T> ? T : CamelCase<T>;
+/**
+ * Predicate to determine if a given string is uniformly cased, i.e. all uppercase or all lowercase.
+ */
+export declare function isUniformlyCased(input: string | null): boolean;
+/**
+ * Capitalizes a string, unless the string is uniformly cased, or an email address.
+ */
+export declare function smartCapitalCase(input: string): string;
+//# sourceMappingURL=identifiers.d.ts.map

package/out/identifiers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identifiers.d.ts","sourceRoot":"","sources":["../identifiers.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAErD;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAiBnG;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAMnG;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAE9D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKtD"}