@empressaio/atom-contract 1.21.0 → 1.23.0

package/dist/conformance/track2-supersession.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"track2-supersession.js","sourceRoot":"","sources":["../../src/conformance/track2-supersession.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAC/C,OAAO,EACL,qBAAqB,GAEtB,MAAM,4BAA4B,CAAC;AAEpC,MAAM,CAAC,MAAM,2BAA2B,GAAqB,qBAAqB,CAAC;IACjF,SAAS,EAAE,eAAe;IAC1B,IAAI,EAAE,KAAK,CAAC,sCAAsC,CAAC;IACnD,EAAE,EAAE,KAAK,CAAC,sCAAsC,CAAC;IACjD,QAAQ,EAAE,0BAA0B;CACrC,CAAC,CAAC"}

package/dist/derivation/derivation.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Derivation and derivesFrom — instrument contract item 2.3.
+ *
+ * derivesFrom is required on Derivation and absent on Record.
+ * A materialised row's identity is (selectorAtomId, storeVersion, method).
+ */
+export type DerivesFrom = {
+    readonly selectorAtomId: string;
+    readonly storeVersion: string;
+    readonly method: string;
+};
+export type Derivation = {
+    readonly class: "Derivation";
+    readonly formula: string;
+    readonly inputs: readonly string[];
+    readonly derivesFrom: DerivesFrom;
+};
+export declare class DerivationParseError extends Error {
+    readonly input: unknown;
+    readonly code: "DERIVES_FROM_REQUIRED";
+    constructor(message: string, input: unknown);
+}
+export declare function parseDerivesFrom(input: unknown): DerivesFrom;
+export declare function parseDerivation(input: unknown): Derivation;
+/** Runtime export so the Factory shim check observes `Derivation` on the module. */
+export declare const Derivation: Readonly<{
+    parse: typeof parseDerivation;
+    parseDerivesFrom: typeof parseDerivesFrom;
+}>;
+//# sourceMappingURL=derivation.d.ts.map

package/dist/derivation/derivation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derivation.d.ts","sourceRoot":"","sources":["../../src/derivation/derivation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;CACnC,CAAC;AAEF,qBAAa,oBAAqB,SAAQ,KAAK;IAK3C,QAAQ,CAAC,KAAK,EAAE,OAAO;IAJzB,QAAQ,CAAC,IAAI,EAAG,uBAAuB,CAAU;gBAG/C,OAAO,EAAE,MAAM,EACN,KAAK,EAAE,OAAO;CAK1B;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAuB5D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAoB1D;AAED,oFAAoF;AACpF,eAAO,MAAM,UAAU;;;EAGrB,CAAC"}

package/dist/derivation/derivation.js

@@ -0,0 +1,61 @@
+/**
+ * Derivation and derivesFrom — instrument contract item 2.3.
+ *
+ * derivesFrom is required on Derivation and absent on Record.
+ * A materialised row's identity is (selectorAtomId, storeVersion, method).
+ */
+export class DerivationParseError extends Error {
+    input;
+    code = "DERIVES_FROM_REQUIRED";
+    constructor(message, input) {
+        super(message);
+        this.input = input;
+        this.name = "DerivationParseError";
+    }
+}
+export function parseDerivesFrom(input) {
+    if (!input || typeof input !== "object") {
+        throw new DerivationParseError("Derivation requires derivesFrom", input);
+    }
+    const row = input;
+    if (typeof row.selectorAtomId !== "string" ||
+        row.selectorAtomId.length === 0 ||
+        typeof row.storeVersion !== "string" ||
+        row.storeVersion.length === 0 ||
+        typeof row.method !== "string" ||
+        row.method.length === 0) {
+        throw new DerivationParseError("derivesFrom requires selectorAtomId, storeVersion, method", input);
+    }
+    return {
+        selectorAtomId: row.selectorAtomId,
+        storeVersion: row.storeVersion,
+        method: row.method,
+    };
+}
+export function parseDerivation(input) {
+    if (!input || typeof input !== "object") {
+        throw new DerivationParseError("Derivation required", input);
+    }
+    const row = input;
+    if (row.class !== "Derivation") {
+        throw new DerivationParseError("Derivation class required", input);
+    }
+    if (typeof row.formula !== "string" || row.formula.length === 0) {
+        throw new DerivationParseError("Derivation requires formula", input);
+    }
+    if (!Array.isArray(row.inputs)) {
+        throw new DerivationParseError("Derivation requires inputs", input);
+    }
+    return {
+        class: "Derivation",
+        formula: row.formula,
+        inputs: row.inputs.map(String),
+        derivesFrom: parseDerivesFrom(row.derivesFrom),
+    };
+}
+/** Runtime export so the Factory shim check observes `Derivation` on the module. */
+export const Derivation = Object.freeze({
+    parse: parseDerivation,
+    parseDerivesFrom,
+});
+//# sourceMappingURL=derivation.js.map

package/dist/derivation/derivation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"derivation.js","sourceRoot":"","sources":["../../src/derivation/derivation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAKlC;IAJF,IAAI,GAAG,uBAAgC,CAAC;IAEjD,YACE,OAAe,EACN,KAAc;QAEvB,KAAK,CAAC,OAAO,CAAC,CAAC;QAFN,UAAK,GAAL,KAAK,CAAS;QAGvB,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,MAAM,IAAI,oBAAoB,CAAC,iCAAiC,EAAE,KAAK,CAAC,CAAC;IAC3E,CAAC;IACD,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,IACE,OAAO,GAAG,CAAC,cAAc,KAAK,QAAQ;QACtC,GAAG,CAAC,cAAc,CAAC,MAAM,KAAK,CAAC;QAC/B,OAAO,GAAG,CAAC,YAAY,KAAK,QAAQ;QACpC,GAAG,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC;QAC7B,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ;QAC9B,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EACvB,CAAC;QACD,MAAM,IAAI,oBAAoB,CAC5B,2DAA2D,EAC3D,KAAK,CACN,CAAC;IACJ,CAAC;IACD,OAAO;QACL,cAAc,EAAE,GAAG,CAAC,cAAc;QAClC,YAAY,EAAE,GAAG,CAAC,YAAY;QAC9B,MAAM,EAAE,GAAG,CAAC,MAAM;KACnB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,MAAM,IAAI,oBAAoB,CAAC,qBAAqB,EAAE,KAAK,CAAC,CAAC;IAC/D,CAAC;IACD,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,IAAI,GAAG,CAAC,KAAK,KAAK,YAAY,EAAE,CAAC;QAC/B,MAAM,IAAI,oBAAoB,CAAC,2BAA2B,EAAE,KAAK,CAAC,CAAC;IACrE,CAAC;IACD,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,oBAAoB,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAC;IACvE,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,oBAAoB,CAAC,4BAA4B,EAAE,KAAK,CAAC,CAAC;IACtE,CAAC;IACD,OAAO;QACL,KAAK,EAAE,YAAY;QACnB,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC;QAC9B,WAAW,EAAE,gBAAgB,CAAC,GAAG,CAAC,WAAW,CAAC;KAC/C,CAAC;AACJ,CAAC;AAED,oFAAoF;AACpF,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC;IACtC,KAAK,EAAE,eAAe;IACtB,gBAAgB;CACjB,CAAC,CAAC"}

package/dist/derivation/index.d.ts

@@ -0,0 +1,3 @@
+export { Derivation, DerivationParseError, parseDerivation, parseDerivesFrom, } from "./derivation.js";
+export type { DerivesFrom } from "./derivation.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/derivation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/derivation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,oBAAoB,EACpB,eAAe,EACf,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/derivation/index.js

@@ -0,0 +1,2 @@
+export { Derivation, DerivationParseError, parseDerivation, parseDerivesFrom, } from "./derivation.js";
+//# sourceMappingURL=index.js.map

package/dist/derivation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/derivation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,oBAAoB,EACpB,eAAe,EACf,gBAAgB,GACjB,MAAM,iBAAiB,CAAC"}

package/dist/identity/alias.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Alias as an atom and lineage as edges — instrument contract item 2.10.
+ *
+ * An alias is claim type `identity.alias` with a validity era. Lineage is
+ * an edge (`mergedInto`, `dividedInto`, `unmerged`). No lineage column
+ * exists on the node.
+ */
+import { type NodeId } from "./node-id.js";
+export type AliasEntityType = "identity.alias";
+export type AliasAtom = {
+    readonly entityType: AliasEntityType;
+    readonly aliasKey: string;
+    readonly nodeId: NodeId;
+    readonly authority: string;
+    readonly validFrom: string;
+    readonly validTo: string | null;
+    readonly knowledgeAt: string;
+};
+export type LineageEdgeKind = "mergedInto" | "dividedInto" | "unmerged";
+export type LineageEdge = {
+    readonly kind: LineageEdgeKind;
+    readonly from: NodeId;
+    readonly to: NodeId;
+};
+export declare const LINEAGE_NODE_COLUMNS: readonly ["mergedInto", "dividedInto", "unmerged"];
+export type LineageNodeColumn = (typeof LINEAGE_NODE_COLUMNS)[number];
+/**
+ * A node identity record may not carry lineage columns. Those relations
+ * are edges. Assigning a type with any of those keys yields `never`.
+ */
+export type AssertNoLineageColumn<T> = Extract<keyof T, LineageNodeColumn> extends never ? T : never;
+export declare class AliasParseError extends Error {
+    readonly input: unknown;
+    readonly code: "ALIAS_ERA";
+    constructor(message: string, input: unknown);
+}
+export declare class LineageParseError extends Error {
+    readonly input: unknown;
+    readonly code: "LINEAGE_EDGE";
+    constructor(message: string, input: unknown);
+}
+export declare function parseAliasKey(input: string): string;
+export declare function parseAliasAtom(input: unknown): AliasAtom;
+export declare function parseLineageEdge(input: unknown): LineageEdge;
+export declare function acceptNodeWithoutLineage<T extends Record<string, unknown>>(node: AssertNoLineageColumn<T>): AssertNoLineageColumn<T>;
+/** Runtime export so the Factory shim check observes `AliasAtom` on the module. */
+export declare const AliasAtom: Readonly<{
+    entityType: "identity.alias";
+    parse: typeof parseAliasAtom;
+    parseKey: typeof parseAliasKey;
+    parseLineage: typeof parseLineageEdge;
+}>;
+//# sourceMappingURL=alias.d.ts.map

package/dist/identity/alias.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alias.d.ts","sourceRoot":"","sources":["../../src/identity/alias.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAS,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,MAAM,eAAe,GAAG,gBAAgB,CAAC;AAE/C,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,YAAY,GAAG,aAAa,GAAG,UAAU,CAAC;AAExE,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,eAAO,MAAM,oBAAoB,oDAIvB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE;;;GAGG;AACH,MAAM,MAAM,qBAAqB,CAAC,CAAC,IACjC,OAAO,CAAC,MAAM,CAAC,EAAE,iBAAiB,CAAC,SAAS,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC;AAEhE,qBAAa,eAAgB,SAAQ,KAAK;IAKtC,QAAQ,CAAC,KAAK,EAAE,OAAO;IAJzB,QAAQ,CAAC,IAAI,EAAG,WAAW,CAAU;gBAGnC,OAAO,EAAE,MAAM,EACN,KAAK,EAAE,OAAO;CAK1B;AAED,qBAAa,iBAAkB,SAAQ,KAAK;IAKxC,QAAQ,CAAC,KAAK,EAAE,OAAO;IAJzB,QAAQ,CAAC,IAAI,EAAG,cAAc,CAAU;gBAGtC,OAAO,EAAE,MAAM,EACN,KAAK,EAAE,OAAO;CAK1B;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKnD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAmCxD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAgB5D;AAED,wBAAgB,wBAAwB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxE,IAAI,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAC7B,qBAAqB,CAAC,CAAC,CAAC,CAE1B;AAED,mFAAmF;AACnF,eAAO,MAAM,SAAS;;;;;EAKpB,CAAC"}

package/dist/identity/alias.js

@@ -0,0 +1,99 @@
+/**
+ * Alias as an atom and lineage as edges — instrument contract item 2.10.
+ *
+ * An alias is claim type `identity.alias` with a validity era. Lineage is
+ * an edge (`mergedInto`, `dividedInto`, `unmerged`). No lineage column
+ * exists on the node.
+ */
+import { parse } from "./node-id.js";
+export const LINEAGE_NODE_COLUMNS = [
+    "mergedInto",
+    "dividedInto",
+    "unmerged",
+];
+export class AliasParseError extends Error {
+    input;
+    code = "ALIAS_ERA";
+    constructor(message, input) {
+        super(message);
+        this.input = input;
+        this.name = "AliasParseError";
+    }
+}
+export class LineageParseError extends Error {
+    input;
+    code = "LINEAGE_EDGE";
+    constructor(message, input) {
+        super(message);
+        this.input = input;
+        this.name = "LineageParseError";
+    }
+}
+export function parseAliasKey(input) {
+    if (typeof input !== "string" || input.length === 0) {
+        throw new AliasParseError("alias key must be a non-empty string", input);
+    }
+    return input;
+}
+export function parseAliasAtom(input) {
+    if (!input || typeof input !== "object") {
+        throw new AliasParseError("alias atom required", input);
+    }
+    const row = input;
+    if (row.entityType !== "identity.alias") {
+        throw new AliasParseError("alias atom entityType must be identity.alias", input);
+    }
+    if (typeof row.aliasKey !== "string" || row.aliasKey.length === 0) {
+        throw new AliasParseError("alias atom requires aliasKey", input);
+    }
+    if (typeof row.nodeId !== "string") {
+        throw new AliasParseError("alias atom requires nodeId", input);
+    }
+    if (typeof row.authority !== "string" || row.authority.length === 0) {
+        throw new AliasParseError("alias atom requires authority, validFrom, knowledgeAt", input);
+    }
+    if (typeof row.validFrom !== "string" || row.validFrom.length === 0) {
+        throw new AliasParseError("alias atom requires a validity era (validFrom)", input);
+    }
+    if (typeof row.knowledgeAt !== "string" || row.knowledgeAt.length === 0) {
+        throw new AliasParseError("alias atom requires authority, validFrom, knowledgeAt", input);
+    }
+    if (row.validTo != null && typeof row.validTo !== "string") {
+        throw new AliasParseError("alias atom validTo must be a string or null", input);
+    }
+    return {
+        entityType: "identity.alias",
+        aliasKey: parseAliasKey(row.aliasKey),
+        nodeId: parse(row.nodeId),
+        authority: row.authority,
+        validFrom: row.validFrom,
+        validTo: row.validTo ?? null,
+        knowledgeAt: row.knowledgeAt,
+    };
+}
+export function parseLineageEdge(input) {
+    if (!input || typeof input !== "object") {
+        throw new LineageParseError("lineage edge required", input);
+    }
+    const row = input;
+    if (row.kind !== "mergedInto" &&
+        row.kind !== "dividedInto" &&
+        row.kind !== "unmerged") {
+        throw new LineageParseError("lineage kind must be mergedInto, dividedInto, or unmerged", input);
+    }
+    if (typeof row.from !== "string" || typeof row.to !== "string") {
+        throw new LineageParseError("lineage edge requires from and to node ids", input);
+    }
+    return { kind: row.kind, from: parse(row.from), to: parse(row.to) };
+}
+export function acceptNodeWithoutLineage(node) {
+    return node;
+}
+/** Runtime export so the Factory shim check observes `AliasAtom` on the module. */
+export const AliasAtom = Object.freeze({
+    entityType: "identity.alias",
+    parse: parseAliasAtom,
+    parseKey: parseAliasKey,
+    parseLineage: parseLineageEdge,
+});
+//# sourceMappingURL=alias.js.map

package/dist/identity/alias.js.map

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

package/dist/identity/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Opaque node identity (`NodeId`) — mint/parse only constructors.
+ *
+ * Import from `@empressaio/atom-contract/identity`.
+ */
+export { COUNTY_PROP_ALIAS_KEY, NODE_ID_PATTERN, NodeId, NodeIdParseError, bindNodeIdForWrite, isCountyPropAliasKey, isNodeId, mint, nodeIdToString, parse, } from "./node-id.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/identity/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/identity/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,MAAM,EACN,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,QAAQ,EACR,IAAI,EACJ,cAAc,EACd,KAAK,GACN,MAAM,cAAc,CAAC"}

package/dist/identity/index.js

@@ -0,0 +1,7 @@
+/**
+ * Opaque node identity (`NodeId`) — mint/parse only constructors.
+ *
+ * Import from `@empressaio/atom-contract/identity`.
+ */
+export { COUNTY_PROP_ALIAS_KEY, NODE_ID_PATTERN, NodeId, NodeIdParseError, bindNodeIdForWrite, isCountyPropAliasKey, isNodeId, mint, nodeIdToString, parse, } from "./node-id.js";
+//# sourceMappingURL=index.js.map

package/dist/identity/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/identity/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,MAAM,EACN,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,QAAQ,EACR,IAAI,EACJ,cAAc,EACd,KAAK,GACN,MAAM,cAAc,CAAC"}

package/dist/identity/node-id.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Branded opaque {@link NodeId} — instrument contract item 2.1 (T1.2).
+ *
+ * Constructible only via {@link mint} or validating {@link parse}. A bare
+ * string does not satisfy write-boundary signatures that require `NodeId`.
+ * Salvaged from unpublished PR #22; grammar matches the Factory shim.
+ */
+/** Opaque node identity minted by the substrate; not a natural key alias. */
+export type NodeId = string & {
+    readonly __brand: "NodeId";
+};
+/** Typed refusal when {@link parse} rejects malformed input. */
+export declare class NodeIdParseError extends Error {
+    readonly input: string;
+    readonly code: "malformed_node_id";
+    constructor(message: string, input: string);
+}
+/** Canonical `nid_` + 32 lowercase hex chars (128-bit opaque payload). */
+export declare const NODE_ID_PATTERN: RegExp;
+/**
+ * County-prop natural key `{fips}:{propId}`. An alias key, never a NodeId.
+ * `parse` refuses this grammar; {@link isCountyPropAliasKey} accepts it.
+ */
+export declare const COUNTY_PROP_ALIAS_KEY: RegExp;
+/**
+ * Mint a fresh opaque node id. The only runtime constructor for new writes.
+ */
+export declare function mint(): NodeId;
+/**
+ * Validate and brand an existing id string. Refuses malformed input; no coercion.
+ * Refuses `{fips}:{propId}` — that grammar is an alias key, not a node id.
+ */
+export declare function parse(input: string): NodeId;
+/** True when `value` is a county-prop alias key, not a node id. */
+export declare function isCountyPropAliasKey(value: string): boolean;
+/** Runtime narrow for values that already passed {@link parse}. */
+export declare function isNodeId(value: unknown): value is NodeId;
+/**
+ * Write-boundary signature: accepts only a branded {@link NodeId}.
+ * Property/engine adapters call this (or take `NodeId` directly) so bare
+ * natural keys fail at compile time.
+ */
+export declare function bindNodeIdForWrite(nodeId: NodeId): {
+    readonly nodeId: NodeId;
+};
+/** String form for persistence layers that store plain text. */
+export declare function nodeIdToString(nodeId: NodeId): string;
+/** Runtime export so the Factory shim check observes `NodeId` on the module. */
+export declare const NodeId: Readonly<{
+    brand: "NodeId";
+    pattern: RegExp;
+    mint: typeof mint;
+    parse: typeof parse;
+    is: typeof isNodeId;
+}>;
+//# sourceMappingURL=node-id.d.ts.map

package/dist/identity/node-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-id.d.ts","sourceRoot":"","sources":["../../src/identity/node-id.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,6EAA6E;AAC7E,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAA;CAAE,CAAC;AAE7D,gEAAgE;AAChE,qBAAa,gBAAiB,SAAQ,KAAK;IAKvC,QAAQ,CAAC,KAAK,EAAE,MAAM;IAJxB,QAAQ,CAAC,IAAI,EAAG,mBAAmB,CAAU;gBAG3C,OAAO,EAAE,MAAM,EACN,KAAK,EAAE,MAAM;CAKzB;AAED,0EAA0E;AAC1E,eAAO,MAAM,eAAe,QAAuB,CAAC;AAEpD;;;GAGG;AACH,eAAO,MAAM,qBAAqB,QAAkB,CAAC;AASrD;;GAEG;AACH,wBAAgB,IAAI,IAAI,MAAM,CAG7B;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAoB3C;AAED,mEAAmE;AACnE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED,mEAAmE;AACnE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAE9E;AAED,gEAAgE;AAChE,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,gFAAgF;AAChF,eAAO,MAAM,MAAM;;;;;;EAMjB,CAAC"}

package/dist/identity/node-id.js

@@ -0,0 +1,82 @@
+/**
+ * Branded opaque {@link NodeId} — instrument contract item 2.1 (T1.2).
+ *
+ * Constructible only via {@link mint} or validating {@link parse}. A bare
+ * string does not satisfy write-boundary signatures that require `NodeId`.
+ * Salvaged from unpublished PR #22; grammar matches the Factory shim.
+ */
+import { randomBytes } from "node:crypto";
+/** Typed refusal when {@link parse} rejects malformed input. */
+export class NodeIdParseError extends Error {
+    input;
+    code = "malformed_node_id";
+    constructor(message, input) {
+        super(message);
+        this.input = input;
+        this.name = "NodeIdParseError";
+    }
+}
+/** Canonical `nid_` + 32 lowercase hex chars (128-bit opaque payload). */
+export const NODE_ID_PATTERN = /^nid_[0-9a-f]{32}$/;
+/**
+ * County-prop natural key `{fips}:{propId}`. An alias key, never a NodeId.
+ * `parse` refuses this grammar; {@link isCountyPropAliasKey} accepts it.
+ */
+export const COUNTY_PROP_ALIAS_KEY = /^[0-9]{5}:.+$/;
+const NODE_ID_PREFIX = "nid_";
+const NODE_ID_HEX_LENGTH = 32;
+function brandNodeId(value) {
+    return value;
+}
+/**
+ * Mint a fresh opaque node id. The only runtime constructor for new writes.
+ */
+export function mint() {
+    const hex = randomBytes(NODE_ID_HEX_LENGTH / 2).toString("hex");
+    return brandNodeId(`${NODE_ID_PREFIX}${hex}`);
+}
+/**
+ * Validate and brand an existing id string. Refuses malformed input; no coercion.
+ * Refuses `{fips}:{propId}` — that grammar is an alias key, not a node id.
+ */
+export function parse(input) {
+    if (typeof input !== "string" || input.length === 0) {
+        throw new NodeIdParseError("NodeId must be a non-empty string", String(input));
+    }
+    if (isCountyPropAliasKey(input)) {
+        throw new NodeIdParseError(`NodeId refuses county-prop alias key "${input}"; use it as an alias key only`, input);
+    }
+    if (!NODE_ID_PATTERN.test(input)) {
+        throw new NodeIdParseError(`NodeId must match ${NODE_ID_PATTERN}; got "${input}"`, input);
+    }
+    return brandNodeId(input);
+}
+/** True when `value` is a county-prop alias key, not a node id. */
+export function isCountyPropAliasKey(value) {
+    return typeof value === "string" && COUNTY_PROP_ALIAS_KEY.test(value);
+}
+/** Runtime narrow for values that already passed {@link parse}. */
+export function isNodeId(value) {
+    return typeof value === "string" && NODE_ID_PATTERN.test(value);
+}
+/**
+ * Write-boundary signature: accepts only a branded {@link NodeId}.
+ * Property/engine adapters call this (or take `NodeId` directly) so bare
+ * natural keys fail at compile time.
+ */
+export function bindNodeIdForWrite(nodeId) {
+    return { nodeId };
+}
+/** String form for persistence layers that store plain text. */
+export function nodeIdToString(nodeId) {
+    return nodeId;
+}
+/** Runtime export so the Factory shim check observes `NodeId` on the module. */
+export const NodeId = Object.freeze({
+    brand: "NodeId",
+    pattern: NODE_ID_PATTERN,
+    mint,
+    parse,
+    is: isNodeId,
+});
+//# sourceMappingURL=node-id.js.map

package/dist/identity/node-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-id.js","sourceRoot":"","sources":["../../src/identity/node-id.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAK1C,gEAAgE;AAChE,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAK9B;IAJF,IAAI,GAAG,mBAA4B,CAAC;IAE7C,YACE,OAAe,EACN,KAAa;QAEtB,KAAK,CAAC,OAAO,CAAC,CAAC;QAFN,UAAK,GAAL,KAAK,CAAQ;QAGtB,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED,0EAA0E;AAC1E,MAAM,CAAC,MAAM,eAAe,GAAG,oBAAoB,CAAC;AAEpD;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,eAAe,CAAC;AAErD,MAAM,cAAc,GAAG,MAAM,CAAC;AAC9B,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAE9B,SAAS,WAAW,CAAC,KAAa;IAChC,OAAO,KAAe,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,IAAI;IAClB,MAAM,GAAG,GAAG,WAAW,CAAC,kBAAkB,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAChE,OAAO,WAAW,CAAC,GAAG,cAAc,GAAG,GAAG,EAAE,CAAC,CAAC;AAChD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,KAAK,CAAC,KAAa;IACjC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,gBAAgB,CACxB,mCAAmC,EACnC,MAAM,CAAC,KAAK,CAAC,CACd,CAAC;IACJ,CAAC;IACD,IAAI,oBAAoB,CAAC,KAAK,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,gBAAgB,CACxB,yCAAyC,KAAK,gCAAgC,EAC9E,KAAK,CACN,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,gBAAgB,CACxB,qBAAqB,eAAe,UAAU,KAAK,GAAG,EACtD,KAAK,CACN,CAAC;IACJ,CAAC;IACD,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACxE,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAClE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,OAAO,EAAE,MAAM,EAAE,CAAC;AACpB,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,gFAAgF;AAChF,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAClC,KAAK,EAAE,QAAiB;IACxB,OAAO,EAAE,eAAe;IACxB,IAAI;IACJ,KAAK;IACL,EAAE,EAAE,QAAQ;CACb,CAAC,CAAC"}

package/dist/index.d.ts

@@ -30,4 +30,5 @@ export type { AtomInputRef, AtomInputRefRole, ReasoningChain, } from "./reasonin
 export { ATOM_INPUT_REF_ROLES, ATOM_INPUT_REF_SCHEMA, REASONING_CHAIN_SCHEMA, REASONING_CHAIN_OBSERVED_SCHEMA, REASONING_CHAIN_DERIVED_SCHEMA, createReasoningChain, validateReasoningChain, } from "./reasoning-chain.js";
 export type { ActorRecordAtomInstance, ActorLicensingTerms, ActorType, ActorTrustLevel, OrganizationTenantKind, } from "./actor-record.js";
 export { ACTOR_RECORD_SCHEMA, ACTOR_LICENSING_TERMS_SCHEMA, ACTOR_TYPES, ACTOR_TRUST_LEVELS, ORGANIZATION_TENANT_KINDS, ICC_ACTOR_RECORD_FIXTURE, createActorRecord, } from "./actor-record.js";
+export { COUNTY_PROP_ALIAS_KEY, NODE_ID_PATTERN, NodeId, NodeIdParseError, bindNodeIdForWrite, isCountyPropAliasKey, isNodeId, mint, nodeIdToString, parse, } from "./identity/node-id.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,YAAY,EACV,YAAY,EACZ,QAAQ,EACR,aAAa,EACb,SAAS,EACT,UAAU,EACV,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,YAAY,EACV,cAAc,EACd,SAAS,EACT,iBAAiB,EACjB,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,YAAY,EACV,eAAe,EACf,aAAa,EACb,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,OAAO,EACL,cAAc,EACd,WAAW,GACZ,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EACV,UAAU,EACV,gBAAgB,EAChB,SAAS,EACT,kBAAkB,EAClB,qBAAqB,EACrB,aAAa,GACd,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAE7D,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7D,YAAY,EACV,YAAY,EACZ,aAAa,EACb,cAAc,EACd,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAE3E,YAAY,EACV,sBAAsB,EACtB,cAAc,EACd,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,cAAc,GACf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,+BAA+B,EAC/B,8BAA8B,EAC9B,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,uBAAuB,EACvB,mBAAmB,EACnB,SAAS,EACT,eAAe,EACf,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,mBAAmB,EACnB,4BAA4B,EAC5B,WAAW,EACX,kBAAkB,EAClB,yBAAyB,EACzB,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,YAAY,EACV,YAAY,EACZ,QAAQ,EACR,aAAa,EACb,SAAS,EACT,UAAU,EACV,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,YAAY,EACV,cAAc,EACd,SAAS,EACT,iBAAiB,EACjB,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,YAAY,EACV,eAAe,EACf,aAAa,EACb,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,OAAO,EACL,cAAc,EACd,WAAW,GACZ,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EACV,UAAU,EACV,gBAAgB,EAChB,SAAS,EACT,kBAAkB,EAClB,qBAAqB,EACrB,aAAa,GACd,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAE7D,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7D,YAAY,EACV,YAAY,EACZ,aAAa,EACb,cAAc,EACd,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAE3E,YAAY,EACV,sBAAsB,EACtB,cAAc,EACd,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,cAAc,GACf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,+BAA+B,EAC/B,8BAA8B,EAC9B,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,uBAAuB,EACvB,mBAAmB,EACnB,SAAS,EACT,eAAe,EACf,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,mBAAmB,EACnB,4BAA4B,EAC5B,WAAW,EACX,kBAAkB,EAClB,yBAAyB,EACzB,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,MAAM,EACN,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,QAAQ,EACR,IAAI,EACJ,cAAc,EACd,KAAK,GACN,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -19,4 +19,5 @@ export { createAtomRegistry, AtomNotRegisteredError } from "./registry.js";
 export { OBLIGATION_SCHEMA, OBLIGATION_TYPES, OBLIGATION_STATUSES, LICENSE_OBLIGATION_TYPES, } from "./obligation.js";
 export { ATOM_INPUT_REF_ROLES, ATOM_INPUT_REF_SCHEMA, REASONING_CHAIN_SCHEMA, REASONING_CHAIN_OBSERVED_SCHEMA, REASONING_CHAIN_DERIVED_SCHEMA, createReasoningChain, validateReasoningChain, } from "./reasoning-chain.js";
 export { ACTOR_RECORD_SCHEMA, ACTOR_LICENSING_TERMS_SCHEMA, ACTOR_TYPES, ACTOR_TRUST_LEVELS, ORGANIZATION_TENANT_KINDS, ICC_ACTOR_RECORD_FIXTURE, createActorRecord, } from "./actor-record.js";
+export { COUNTY_PROP_ALIAS_KEY, NODE_ID_PATTERN, NodeId, NodeIdParseError, bindNodeIdForWrite, isCountyPropAliasKey, isNodeId, mint, nodeIdToString, parse, } from "./identity/node-id.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAcH,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAS1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAOlD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,OAAO,EACL,cAAc,EACd,WAAW,GACZ,MAAM,aAAa,CAAC;AAOrB,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAU/B,OAAO,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAG7D,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAS7D,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAO3E,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AAOzB,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,+BAA+B,EAC/B,8BAA8B,EAC9B,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAS9B,OAAO,EACL,mBAAmB,EACnB,4BAA4B,EAC5B,WAAW,EACX,kBAAkB,EAClB,yBAAyB,EACzB,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAcH,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAS1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAOlD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,OAAO,EACL,cAAc,EACd,WAAW,GACZ,MAAM,aAAa,CAAC;AAOrB,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAU/B,OAAO,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAG7D,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAS7D,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAO3E,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AAOzB,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,+BAA+B,EAC/B,8BAA8B,EAC9B,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAS9B,OAAO,EACL,mBAAmB,EACnB,4BAA4B,EAC5B,WAAW,EACX,kBAAkB,EAClB,yBAAyB,EACzB,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,MAAM,EACN,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,QAAQ,EACR,IAAI,EACJ,cAAc,EACd,KAAK,GACN,MAAM,uBAAuB,CAAC"}

package/dist/lineage/index.d.ts

@@ -0,0 +1,3 @@
+export { SUPERSEDED_BY, SUPERSEDED_BY_COLUMN, SupersessionEdge, SupersessionParseError, acceptAtomWithoutSupersededBy, parseSupersessionEdge, } from "./supersession.js";
+export type { AssertNoSupersededByColumn, SupersededByColumn, } from "./supersession.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/lineage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lineage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,6BAA6B,EAC7B,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,mBAAmB,CAAC"}

package/dist/lineage/index.js

@@ -0,0 +1,2 @@
+export { SUPERSEDED_BY, SUPERSEDED_BY_COLUMN, SupersessionEdge, SupersessionParseError, acceptAtomWithoutSupersededBy, parseSupersessionEdge, } from "./supersession.js";
+//# sourceMappingURL=index.js.map

package/dist/lineage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lineage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,6BAA6B,EAC7B,qBAAqB,GACtB,MAAM,mBAAmB,CAAC"}

package/dist/lineage/supersession.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Supersession as an edge — instrument contract item 2.8.
+ *
+ * No `supersededBy` column exists to write. SUPERSEDED_BY is an edge
+ * type with `closedAt` on the prior window.
+ */
+import { type NodeId } from "../identity/node-id.js";
+export declare const SUPERSEDED_BY: "SUPERSEDED_BY";
+export type SupersessionEdge = {
+    readonly link_type: typeof SUPERSEDED_BY;
+    readonly from: NodeId;
+    readonly to: NodeId;
+    readonly closedAt: string;
+};
+export declare const SUPERSEDED_BY_COLUMN: "supersededBy";
+export type SupersededByColumn = typeof SUPERSEDED_BY_COLUMN;
+/**
+ * An atom record may not carry a supersededBy column. Assigning a type
+ * with that key yields `never`.
+ */
+export type AssertNoSupersededByColumn<T> = Extract<keyof T, SupersededByColumn> extends never ? T : never;
+export declare class SupersessionParseError extends Error {
+    readonly input: unknown;
+    readonly code: "SUPERSESSION_EDGE";
+    constructor(message: string, input: unknown);
+}
+export declare function parseSupersessionEdge(input: unknown): SupersessionEdge;
+export declare function acceptAtomWithoutSupersededBy<T extends Record<string, unknown>>(atom: AssertNoSupersededByColumn<T>): AssertNoSupersededByColumn<T>;
+/** Runtime export so the Factory shim check observes `SupersessionEdge` on the module. */
+export declare const SupersessionEdge: Readonly<{
+    linkType: "SUPERSEDED_BY";
+    parse: typeof parseSupersessionEdge;
+}>;
+//# sourceMappingURL=supersession.d.ts.map

package/dist/lineage/supersession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supersession.d.ts","sourceRoot":"","sources":["../../src/lineage/supersession.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAS,KAAK,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAE5D,eAAO,MAAM,aAAa,EAAG,eAAwB,CAAC;AAEtD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,SAAS,EAAE,OAAO,aAAa,CAAC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAG,cAAuB,CAAC;AAE5D,MAAM,MAAM,kBAAkB,GAAG,OAAO,oBAAoB,CAAC;AAE7D;;;GAGG;AACH,MAAM,MAAM,0BAA0B,CAAC,CAAC,IACtC,OAAO,CAAC,MAAM,CAAC,EAAE,kBAAkB,CAAC,SAAS,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC;AAEjE,qBAAa,sBAAuB,SAAQ,KAAK;IAK7C,QAAQ,CAAC,KAAK,EAAE,OAAO;IAJzB,QAAQ,CAAC,IAAI,EAAG,mBAAmB,CAAU;gBAG3C,OAAO,EAAE,MAAM,EACN,KAAK,EAAE,OAAO;CAK1B;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAoBtE;AAED,wBAAgB,6BAA6B,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7E,IAAI,EAAE,0BAA0B,CAAC,CAAC,CAAC,GAClC,0BAA0B,CAAC,CAAC,CAAC,CAE/B;AAED,0FAA0F;AAC1F,eAAO,MAAM,gBAAgB;;;EAG3B,CAAC"}

package/dist/lineage/supersession.js

@@ -0,0 +1,48 @@
+/**
+ * Supersession as an edge — instrument contract item 2.8.
+ *
+ * No `supersededBy` column exists to write. SUPERSEDED_BY is an edge
+ * type with `closedAt` on the prior window.
+ */
+import { parse } from "../identity/node-id.js";
+export const SUPERSEDED_BY = "SUPERSEDED_BY";
+export const SUPERSEDED_BY_COLUMN = "supersededBy";
+export class SupersessionParseError extends Error {
+    input;
+    code = "SUPERSESSION_EDGE";
+    constructor(message, input) {
+        super(message);
+        this.input = input;
+        this.name = "SupersessionParseError";
+    }
+}
+export function parseSupersessionEdge(input) {
+    if (!input || typeof input !== "object") {
+        throw new SupersessionParseError("SUPERSEDED_BY edge required", input);
+    }
+    const row = input;
+    if (row.link_type !== SUPERSEDED_BY) {
+        throw new SupersessionParseError("link_type must be SUPERSEDED_BY", input);
+    }
+    if (typeof row.from !== "string" || typeof row.to !== "string") {
+        throw new SupersessionParseError("SUPERSEDED_BY edge requires from and to", input);
+    }
+    if (typeof row.closedAt !== "string" || row.closedAt.length === 0) {
+        throw new SupersessionParseError("SUPERSEDED_BY edge requires closedAt on the prior window", input);
+    }
+    return {
+        link_type: SUPERSEDED_BY,
+        from: parse(row.from),
+        to: parse(row.to),
+        closedAt: row.closedAt,
+    };
+}
+export function acceptAtomWithoutSupersededBy(atom) {
+    return atom;
+}
+/** Runtime export so the Factory shim check observes `SupersessionEdge` on the module. */
+export const SupersessionEdge = Object.freeze({
+    linkType: SUPERSEDED_BY,
+    parse: parseSupersessionEdge,
+});
+//# sourceMappingURL=supersession.js.map

package/dist/lineage/supersession.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supersession.js","sourceRoot":"","sources":["../../src/lineage/supersession.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAe,MAAM,wBAAwB,CAAC;AAE5D,MAAM,CAAC,MAAM,aAAa,GAAG,eAAwB,CAAC;AAStD,MAAM,CAAC,MAAM,oBAAoB,GAAG,cAAuB,CAAC;AAW5D,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAKpC;IAJF,IAAI,GAAG,mBAA4B,CAAC;IAE7C,YACE,OAAe,EACN,KAAc;QAEvB,KAAK,CAAC,OAAO,CAAC,CAAC;QAFN,UAAK,GAAL,KAAK,CAAS;QAGvB,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,MAAM,IAAI,sBAAsB,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAC;IACzE,CAAC;IACD,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,IAAI,GAAG,CAAC,SAAS,KAAK,aAAa,EAAE,CAAC;QACpC,MAAM,IAAI,sBAAsB,CAAC,iCAAiC,EAAE,KAAK,CAAC,CAAC;IAC7E,CAAC;IACD,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,GAAG,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;QAC/D,MAAM,IAAI,sBAAsB,CAAC,yCAAyC,EAAE,KAAK,CAAC,CAAC;IACrF,CAAC;IACD,IAAI,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClE,MAAM,IAAI,sBAAsB,CAAC,0DAA0D,EAAE,KAAK,CAAC,CAAC;IACtG,CAAC;IACD,OAAO;QACL,SAAS,EAAE,aAAa;QACxB,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;QACrB,EAAE,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACjB,QAAQ,EAAE,GAAG,CAAC,QAAQ;KACvB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,IAAmC;IAEnC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,0FAA0F;AAC1F,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC5C,QAAQ,EAAE,aAAa;IACvB,KAAK,EAAE,qBAAqB;CAC7B,CAAC,CAAC"}

package/dist/property/common.d.ts

@@ -818,12 +818,12 @@ export declare const FLOOD_HAZARD_ABSENCE_SCHEMA: z.ZodObject<{
 export type FloodHazardAbsence = z.infer<typeof FLOOD_HAZARD_ABSENCE_SCHEMA>;
 export type RailCorridorSourceTier = "ntad-narn" | "absent";
 export declare const RAIL_CORRIDOR_SOURCE_TIER_SCHEMA: z.ZodEnum<["ntad-narn", "absent"]>;
-export declare const RAIL_CORRIDOR_STATUS_VALUES: readonly ["active", "abandoned", "rail-trail"];
+export declare const RAIL_CORRIDOR_STATUS_VALUES: readonly ["active", "abandoned", "rail-trail", "unknown"];
 export type RailCorridorStatus = (typeof RAIL_CORRIDOR_STATUS_VALUES)[number];
-export declare const RAIL_CORRIDOR_STATUS_SCHEMA: z.ZodEnum<["active", "abandoned", "rail-trail"]>;
-export declare const RAIL_CORRIDOR_CLASS_VALUES: readonly ["mainline", "spur", "yard"];
+export declare const RAIL_CORRIDOR_STATUS_SCHEMA: z.ZodEnum<["active", "abandoned", "rail-trail", "unknown"]>;
+export declare const RAIL_CORRIDOR_CLASS_VALUES: readonly ["mainline", "spur", "yard", "unknown"];
 export type RailCorridorClass = (typeof RAIL_CORRIDOR_CLASS_VALUES)[number];
-export declare const RAIL_CORRIDOR_CLASS_SCHEMA: z.ZodEnum<["mainline", "spur", "yard"]>;
+export declare const RAIL_CORRIDOR_CLASS_SCHEMA: z.ZodEnum<["mainline", "spur", "yard", "unknown"]>;
 export declare const RAIL_CORRIDOR_ABSENCE_KINDS: readonly ["no-rail-coverage", "no-parcel-geometry"];
 export type RailCorridorAbsenceKind = (typeof RAIL_CORRIDOR_ABSENCE_KINDS)[number];
 export declare const RAIL_CORRIDOR_ABSENCE_SCHEMA: z.ZodObject<{