@empressaio/atom-contract 1.14.0 → 1.16.0

package/dist/property/owner-fact.d.ts.map

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

package/dist/property/owner-fact.js

@@ -0,0 +1,112 @@
+import { z } from "zod";
+import { REASONING_CHAIN_OBSERVED_SCHEMA } from "../reasoning-chain.js";
+import { CAD_ROLL_SOURCE_TIER_SCHEMA, OWNER_FACT_ABSENCE_SCHEMA, PARCEL_NODE_ID_PATTERN, PROPERTY_ACCESS_POLICY_SCHEMA, PROPERTY_ATOM_TIER, PROPERTY_PAID_ACCESS_POLICY, PROPERTY_QUALITY_GATE_FIELDS, PROPERTY_READ_CONTRACT_SCHEMA, SITE_LAYER_PROVENANCE_FIELDS, SITE_LAYER_VERIFIED_ABSENCE_SCHEMA, } from "./common.js";
+export const OWNER_EXEMPTION_FLAGS_SCHEMA = z
+    .object({
+    /** Any homestead exemption present — implies owner-occupied. */
+    homestead: z.boolean(),
+    /** Over-65 or disability exemption present. */
+    seniorOrDisability: z.boolean(),
+    /** Agricultural / open-space / timber valuation present. */
+    agricultural: z.boolean(),
+    /** Veteran exemption present. */
+    veteran: z.boolean(),
+})
+    .strict();
+export const OWNER_FACT_SCHEMA = z
+    .object({
+    entityType: z.literal("owner-fact"),
+    atomDid: z
+        .string()
+        .min(1)
+        .refine((val) => /^ownfact_[0-9a-f]{16}$/.test(val), {
+        message: "atomDid must be in format ownfact_<16-hex-chars>",
+    }),
+    parcelNodeId: z
+        .string()
+        .min(1)
+        .refine((val) => PARCEL_NODE_ID_PATTERN.test(val), {
+        message: "parcelNodeId must match {county_fips}:{prop_id}",
+    }),
+    taxYear: z.number().int(),
+    reasoningChain: REASONING_CHAIN_OBSERVED_SCHEMA,
+    sourceTier: CAD_ROLL_SOURCE_TIER_SCHEMA,
+    ownerName: z.string().min(1).optional(),
+    ownerMailingAddress: z.string().min(1).optional(),
+    exemptionFlags: OWNER_EXEMPTION_FLAGS_SCHEMA.optional(),
+    absence: OWNER_FACT_ABSENCE_SCHEMA.optional(),
+    verifiedAbsence: SITE_LAYER_VERIFIED_ABSENCE_SCHEMA.optional(),
+    accessPolicy: PROPERTY_ACCESS_POLICY_SCHEMA,
+    ...PROPERTY_QUALITY_GATE_FIELDS,
+    ...SITE_LAYER_PROVENANCE_FIELDS,
+    atomTier: z.literal(PROPERTY_ATOM_TIER),
+    readContract: PROPERTY_READ_CONTRACT_SCHEMA.optional(),
+})
+    .superRefine((data, ctx) => {
+    const hasAbsence = data.absence !== undefined;
+    const isAbsentTier = data.sourceTier === "absent";
+    const hasOwnerName = data.ownerName !== undefined;
+    const hasMailing = data.ownerMailingAddress !== undefined;
+    const hasExemptions = data.exemptionFlags !== undefined;
+    const hasClaimField = hasOwnerName || hasMailing || hasExemptions;
+    // The load-bearing inversion: owner is paid, every sibling is free.
+    if (data.accessPolicy !== PROPERTY_PAID_ACCESS_POLICY) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "owner-fact must use accessPolicy public-paid (owner identity is the paid facet; a public-free owner atom would leak it)",
+            path: ["accessPolicy"],
+        });
+    }
+    if (hasClaimField && hasAbsence) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "owner fields and absence are mutually exclusive",
+            path: ["absence"],
+        });
+    }
+    // A mailing address with no owner name is a dangling PII fragment: it
+    // names a household without naming the claim it supports.
+    if (hasMailing && !hasOwnerName) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "ownerMailingAddress requires ownerName (a bare mailing address is a dangling PII fragment)",
+            path: ["ownerMailingAddress"],
+        });
+    }
+    if (isAbsentTier) {
+        if (!data.verifiedAbsence) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: "sourceTier absent requires verifiedAbsence (evaluated + provenanceScope)",
+                path: ["verifiedAbsence"],
+            });
+        }
+        if (hasClaimField) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: "sourceTier absent must not carry owner claim fields",
+                path: ["sourceTier"],
+            });
+        }
+    }
+    else if (hasAbsence) {
+        if (hasClaimField) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: "absence must not coexist with owner claim fields",
+                path: ["absence"],
+            });
+        }
+    }
+    else if (!hasOwnerName) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "cad-authoritative tier requires ownerName when no absence",
+            path: ["ownerName"],
+        });
+    }
+});
+export function createOwnerFact(input) {
+    return OWNER_FACT_SCHEMA.parse(input);
+}
+//# sourceMappingURL=owner-fact.js.map

package/dist/property/owner-fact.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@empressaio/atom-contract",
-  "version": "1.14.0",
+  "version": "1.16.0",
   "description": "The typed-data substrate every Empressa atom satisfies: identity, context interface, composition declaration, and history anchoring. Peer to the Hauska SDK (`@hauska-sdk/*`); consumed directly by every product surface and MCP server.",
   "type": "module",
   "main": "./dist/index.js",