@empressaio/atom-contract 1.19.0 → 1.21.0

package/dist/property/rrc-pipeline-fact.js

@@ -0,0 +1,119 @@
+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, RRC_PIPELINE_ABSENCE_SCHEMA, RRC_PIPELINE_SOURCE_TIER_SCHEMA, SITE_LAYER_PROVENANCE_FIELDS, SITE_LAYER_VERIFIED_ABSENCE_SCHEMA, } from "./common.js";
+function hasPipelineClaim(data) {
+    return (data.nearPipeline !== undefined ||
+        data.nearestPipelineDistanceMeters !== undefined ||
+        data.t4permit !== undefined ||
+        data.p5Num !== undefined ||
+        data.operatorName !== undefined ||
+        data.systemName !== undefined ||
+        data.commodity !== undefined ||
+        data.commodityDescription !== undefined ||
+        data.systemType !== undefined ||
+        data.status !== undefined ||
+        data.diameter !== undefined ||
+        data.interstate !== undefined);
+}
+export const RRC_PIPELINE_FACT_SCHEMA = z
+    .object({
+    entityType: z.literal("rrc-pipeline-fact"),
+    atomDid: z
+        .string()
+        .min(1)
+        .refine((val) => /^pipefact_[0-9a-f]{16}$/.test(val), {
+        message: "atomDid must be in format pipefact_<16-hex-chars>",
+    }),
+    parcelNodeId: z
+        .string()
+        .min(1)
+        .refine((val) => PARCEL_NODE_ID_PATTERN.test(val), {
+        message: "parcelNodeId must match {county_fips}:{prop_id}",
+    }),
+    reasoningChain: REASONING_CHAIN_OBSERVED_SCHEMA,
+    sourceTier: RRC_PIPELINE_SOURCE_TIER_SCHEMA,
+    bufferMeters: z.number().positive(),
+    nearPipeline: z.boolean().optional(),
+    nearestPipelineDistanceMeters: z.number().nonnegative().optional(),
+    t4permit: z.string().min(1).optional(),
+    p5Num: z.string().min(1).optional(),
+    operatorName: z.string().min(1).optional(),
+    systemName: z.string().min(1).optional(),
+    commodity: z.string().min(1).optional(),
+    commodityDescription: z.string().min(1).optional(),
+    systemType: z.string().min(1).optional(),
+    status: z.string().min(1).optional(),
+    diameter: z.number().optional(),
+    interstate: z.union([z.boolean(), z.string()]).optional(),
+    absence: RRC_PIPELINE_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 hasClaim = hasPipelineClaim(data);
+    if (data.accessPolicy !== PROPERTY_DEFAULT_ACCESS_POLICY) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "rrc-pipeline-fact must use accessPolicy public-free",
+            path: ["accessPolicy"],
+        });
+    }
+    if (hasClaim && hasAbsence) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "pipeline 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 (hasClaim || data.nearPipeline !== undefined) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: "sourceTier absent must not carry pipeline claim fields",
+                path: ["sourceTier"],
+            });
+        }
+    }
+    else if (hasAbsence) {
+        if (hasClaim || data.nearPipeline !== undefined) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: "absence must not coexist with pipeline claim fields",
+                path: ["absence"],
+            });
+        }
+    }
+    else if (data.nearPipeline === undefined) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "rrc-public-gis tier requires nearPipeline when no absence",
+            path: ["nearPipeline"],
+        });
+    }
+    else if (data.nearPipeline) {
+        if (data.nearestPipelineDistanceMeters === undefined) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: "nearPipeline true requires nearestPipelineDistanceMeters",
+                path: ["nearestPipelineDistanceMeters"],
+            });
+        }
+    }
+});
+export function createRrcPipelineFact(input) {
+    return RRC_PIPELINE_FACT_SCHEMA.parse(input);
+}
+//# sourceMappingURL=rrc-pipeline-fact.js.map

package/dist/property/rrc-pipeline-fact.js.map

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

package/dist/property/well-fact.d.ts

@@ -311,8 +311,8 @@ export declare const WELL_FACT_SCHEMA: z.ZodEffects<z.ZodObject<{
     }>;
     sourceTier: z.ZodEnum<["texas-rrc-gis", "absent"]>;
     apiNumber14: z.ZodOptional<z.ZodString>;
-    wellStatus: z.ZodOptional<z.ZodEnum<["producing", "permitted", "dry", "plugged-abandoned"]>>;
-    wellType: z.ZodOptional<z.ZodEnum<["oil", "gas", "injection", "disposal"]>>;
+    wellStatus: z.ZodOptional<z.ZodEnum<["producing", "permitted", "dry", "plugged-abandoned", "unknown"]>>;
+    wellType: z.ZodOptional<z.ZodEnum<["oil", "gas", "injection", "disposal", "unknown"]>>;
     orphaned: z.ZodOptional<z.ZodBoolean>;
     operatorName: z.ZodOptional<z.ZodString>;
     surfaceLocation: z.ZodOptional<z.ZodObject<{
@@ -408,7 +408,7 @@ export declare const WELL_FACT_SCHEMA: z.ZodEffects<z.ZodObject<{
         }> | undefined;
     }> | undefined;
     apiNumber14?: string | undefined;
-    wellType?: "oil" | "gas" | "injection" | "disposal" | undefined;
+    wellType?: "unknown" | "oil" | "gas" | "injection" | "disposal" | undefined;
     surfaceLocation?: {
         lng: number;
         lat: number;
@@ -422,9 +422,9 @@ export declare const WELL_FACT_SCHEMA: z.ZodEffects<z.ZodObject<{
         provenanceScope: string[];
     } | undefined;
     sourceVintage?: string | undefined;
-    wellStatus?: "dry" | "producing" | "permitted" | "plugged-abandoned" | undefined;
-    orphaned?: boolean | undefined;
     operatorName?: string | undefined;
+    wellStatus?: "unknown" | "dry" | "producing" | "permitted" | "plugged-abandoned" | undefined;
+    orphaned?: boolean | undefined;
     parcelRelation?: "on-parcel" | "near-parcel" | undefined;
     proximityRadiusMeters?: number | undefined;
     proximityDistanceMeters?: number | undefined;
@@ -487,7 +487,7 @@ export declare const WELL_FACT_SCHEMA: z.ZodEffects<z.ZodObject<{
         }> | undefined;
     }> | undefined;
     apiNumber14?: string | undefined;
-    wellType?: "oil" | "gas" | "injection" | "disposal" | undefined;
+    wellType?: "unknown" | "oil" | "gas" | "injection" | "disposal" | undefined;
     surfaceLocation?: {
         lng: number;
         lat: number;
@@ -501,9 +501,9 @@ export declare const WELL_FACT_SCHEMA: z.ZodEffects<z.ZodObject<{
         provenanceScope: string[];
     } | undefined;
     sourceVintage?: string | undefined;
-    wellStatus?: "dry" | "producing" | "permitted" | "plugged-abandoned" | undefined;
-    orphaned?: boolean | undefined;
     operatorName?: string | undefined;
+    wellStatus?: "unknown" | "dry" | "producing" | "permitted" | "plugged-abandoned" | undefined;
+    orphaned?: boolean | undefined;
     parcelRelation?: "on-parcel" | "near-parcel" | undefined;
     proximityRadiusMeters?: number | undefined;
     proximityDistanceMeters?: number | undefined;
@@ -566,7 +566,7 @@ export declare const WELL_FACT_SCHEMA: z.ZodEffects<z.ZodObject<{
         }> | undefined;
     }> | undefined;
     apiNumber14?: string | undefined;
-    wellType?: "oil" | "gas" | "injection" | "disposal" | undefined;
+    wellType?: "unknown" | "oil" | "gas" | "injection" | "disposal" | undefined;
     surfaceLocation?: {
         lng: number;
         lat: number;
@@ -580,9 +580,9 @@ export declare const WELL_FACT_SCHEMA: z.ZodEffects<z.ZodObject<{
         provenanceScope: string[];
     } | undefined;
     sourceVintage?: string | undefined;
-    wellStatus?: "dry" | "producing" | "permitted" | "plugged-abandoned" | undefined;
-    orphaned?: boolean | undefined;
     operatorName?: string | undefined;
+    wellStatus?: "unknown" | "dry" | "producing" | "permitted" | "plugged-abandoned" | undefined;
+    orphaned?: boolean | undefined;
     parcelRelation?: "on-parcel" | "near-parcel" | undefined;
     proximityRadiusMeters?: number | undefined;
     proximityDistanceMeters?: number | undefined;
@@ -645,7 +645,7 @@ export declare const WELL_FACT_SCHEMA: z.ZodEffects<z.ZodObject<{
         }> | undefined;
     }> | undefined;
     apiNumber14?: string | undefined;
-    wellType?: "oil" | "gas" | "injection" | "disposal" | undefined;
+    wellType?: "unknown" | "oil" | "gas" | "injection" | "disposal" | undefined;
     surfaceLocation?: {
         lng: number;
         lat: number;
@@ -659,9 +659,9 @@ export declare const WELL_FACT_SCHEMA: z.ZodEffects<z.ZodObject<{
         provenanceScope: string[];
     } | undefined;
     sourceVintage?: string | undefined;
-    wellStatus?: "dry" | "producing" | "permitted" | "plugged-abandoned" | undefined;
-    orphaned?: boolean | undefined;
     operatorName?: string | undefined;
+    wellStatus?: "unknown" | "dry" | "producing" | "permitted" | "plugged-abandoned" | undefined;
+    orphaned?: boolean | undefined;
     parcelRelation?: "on-parcel" | "near-parcel" | undefined;
     proximityRadiusMeters?: number | undefined;
     proximityDistanceMeters?: number | undefined;

package/package.json

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