@empressaio/atom-contract 1.16.0 → 1.18.0

package/dist/property/well-fact.js

@@ -0,0 +1,135 @@
+import { z } from "zod";
+import { REASONING_CHAIN_OBSERVED_SCHEMA } from "../reasoning-chain.js";
+import { PARCEL_NODE_ID_PATTERN, PROPERTY_ACCESS_POLICY_SCHEMA, PROPERTY_ATOM_TIER, PROPERTY_DEFAULT_ACCESS_POLICY, PROPERTY_QUALITY_GATE_FIELDS, PROPERTY_READ_CONTRACT_SCHEMA, SITE_LAYER_PROVENANCE_FIELDS, SITE_LAYER_VERIFIED_ABSENCE_SCHEMA, WELL_FACT_ABSENCE_SCHEMA, WELL_FACT_SOURCE_TIER_SCHEMA, WELL_PARCEL_RELATION_SCHEMA, WELL_STATUS_SCHEMA, WELL_SURFACE_LOCATION_SCHEMA, WELL_TYPE_SCHEMA, } from "./common.js";
+export const WELL_FACT_SCHEMA = z
+    .object({
+    entityType: z.literal("well-fact"),
+    atomDid: z
+        .string()
+        .min(1)
+        .refine((val) => /^wlfact_[0-9a-f]{16}$/.test(val), {
+        message: "atomDid must be in format wlfact_<16-hex-chars>",
+    }),
+    parcelNodeId: z
+        .string()
+        .min(1)
+        .refine((val) => PARCEL_NODE_ID_PATTERN.test(val), {
+        message: "parcelNodeId must match {county_fips}:{prop_id}",
+    }),
+    wellKey: z.string().min(1),
+    reasoningChain: REASONING_CHAIN_OBSERVED_SCHEMA,
+    sourceTier: WELL_FACT_SOURCE_TIER_SCHEMA,
+    apiNumber14: z
+        .string()
+        .min(10)
+        .max(14)
+        .regex(/^\d+$/, "apiNumber14 must be numeric")
+        .optional(),
+    wellStatus: WELL_STATUS_SCHEMA.optional(),
+    wellType: WELL_TYPE_SCHEMA.optional(),
+    orphaned: z.boolean().optional(),
+    operatorName: z.string().min(1).optional(),
+    surfaceLocation: WELL_SURFACE_LOCATION_SCHEMA.optional(),
+    parcelRelation: WELL_PARCEL_RELATION_SCHEMA.optional(),
+    proximityRadiusMeters: z.number().positive().optional(),
+    proximityDistanceMeters: z.number().nonnegative().optional(),
+    absence: WELL_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 hasWellClaim = data.apiNumber14 !== undefined &&
+        data.wellStatus !== undefined &&
+        data.wellType !== undefined &&
+        data.orphaned !== undefined &&
+        data.surfaceLocation !== undefined &&
+        data.parcelRelation !== undefined &&
+        data.proximityRadiusMeters !== undefined;
+    if (data.accessPolicy !== PROPERTY_DEFAULT_ACCESS_POLICY) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "well-fact must use accessPolicy public-free",
+            path: ["accessPolicy"],
+        });
+    }
+    if (hasWellClaim && hasAbsence) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "well claim fields and absence are mutually exclusive",
+            path: ["absence"],
+        });
+    }
+    if (isAbsentTier) {
+        if (!data.verifiedAbsence) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: "sourceTier absent requires verifiedAbsence (evaluated + provenanceScope)",
+                path: ["verifiedAbsence"],
+            });
+        }
+        if (hasWellClaim || hasAbsence) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: "sourceTier absent must not carry per-parcel well claims",
+                path: ["sourceTier"],
+            });
+        }
+    }
+    else if (hasAbsence) {
+        if (hasWellClaim) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: "absence must not coexist with well claim fields",
+                path: ["absence"],
+            });
+        }
+        if (data.proximityRadiusMeters === undefined) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: "absence atoms still carry proximityRadiusMeters so the evaluated radius is legible",
+                path: ["proximityRadiusMeters"],
+            });
+        }
+    }
+    else if (!hasWellClaim) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "texas-rrc-gis tier requires full well claim fields when no absence",
+            path: ["apiNumber14"],
+        });
+    }
+    else {
+        if (data.parcelRelation === "on-parcel") {
+            if (data.proximityDistanceMeters !== undefined &&
+                data.proximityDistanceMeters !== 0) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    message: "on-parcel claims must carry proximityDistanceMeters 0 or omit",
+                    path: ["proximityDistanceMeters"],
+                });
+            }
+        }
+        else if (data.parcelRelation === "near-parcel") {
+            const radius = data.proximityRadiusMeters ?? 0;
+            if (data.proximityDistanceMeters === undefined ||
+                data.proximityDistanceMeters <= 0 ||
+                data.proximityDistanceMeters > radius) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    message: "near-parcel claims require proximityDistanceMeters in (0, proximityRadiusMeters]",
+                    path: ["proximityDistanceMeters"],
+                });
+            }
+        }
+    }
+});
+export function createWellFact(input) {
+    return WELL_FACT_SCHEMA.parse(input);
+}
+//# sourceMappingURL=well-fact.js.map

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@empressaio/atom-contract",
-  "version": "1.16.0",
+  "version": "1.18.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",