@empressaio/atom-contract 1.7.0

package/dist/og/revenue-allocation-unit.d.ts

@@ -0,0 +1,762 @@
+import { z } from "zod";
+import type { AccessPolicy } from "../registration.js";
+import { type WidthedConfidence } from "../read-contract/common.js";
+/**
+ * Allocation method for tract participation factors. Per ADR-025 Herbert review,
+ * the method is operator-asserted and must be tagged on every factor — no bare
+ * factors without method + source are representable.
+ */
+export type AllocationMethod = "stated-fraction" | "acreage" | "lateral-length" | "take-points" | "acre-feet" | "oil-in-place" | "other";
+export declare const ALLOCATION_METHODS: ReadonlyArray<AllocationMethod>;
+/**
+ * Unit basis discriminator: pooled-unit (county instruments), allocation-well
+ * (RRC plat), or psa (pooling and spacing agreement).
+ */
+export type UnitBasis = "pooled-unit" | "allocation-well" | "psa";
+export declare const UNIT_BASES: ReadonlyArray<UnitBasis>;
+/**
+ * Tract participation entry carrying operator-asserted factor, allocation
+ * method, and source. Per ADR-025, the schema must NOT allow a bare factor
+ * without allocationMethod + source.
+ */
+export interface TractParticipation {
+    tractDid: string;
+    factor: number;
+    allocationMethod: AllocationMethod;
+    source: string;
+    confidence: WidthedConfidence;
+    /** For allocation-well basis: take points on this tract */
+    takePoints?: number;
+    /** For allocation-well basis: productive lateral footage on this tract */
+    productiveLateralFootage?: number;
+}
+export declare const TRACT_PARTICIPATION_SCHEMA: z.ZodObject<{
+    tractDid: z.ZodString;
+    factor: z.ZodNumber;
+    allocationMethod: z.ZodEnum<[AllocationMethod, ...AllocationMethod[]]>;
+    source: z.ZodString;
+    confidence: z.ZodReadonly<z.ZodObject<{
+        readonly estimate: z.ZodNumber;
+        readonly n: z.ZodNumber;
+        readonly intervalWidth: z.ZodNumber;
+        readonly provenance: z.ZodEnum<["asserted", "backtest", "seed", "live"]>;
+    }, "strip", z.ZodTypeAny, {
+        estimate: number;
+        n: number;
+        intervalWidth: number;
+        provenance: "asserted" | "backtest" | "seed" | "live";
+    }, {
+        estimate: number;
+        n: number;
+        intervalWidth: number;
+        provenance: "asserted" | "backtest" | "seed" | "live";
+    }>>;
+    takePoints: z.ZodOptional<z.ZodNumber>;
+    productiveLateralFootage: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    confidence: Readonly<{
+        estimate: number;
+        n: number;
+        intervalWidth: number;
+        provenance: "asserted" | "backtest" | "seed" | "live";
+    }>;
+    source: string;
+    tractDid: string;
+    factor: number;
+    allocationMethod: AllocationMethod;
+    takePoints?: number | undefined;
+    productiveLateralFootage?: number | undefined;
+}, {
+    confidence: Readonly<{
+        estimate: number;
+        n: number;
+        intervalWidth: number;
+        provenance: "asserted" | "backtest" | "seed" | "live";
+    }>;
+    source: string;
+    tractDid: string;
+    factor: number;
+    allocationMethod: AllocationMethod;
+    takePoints?: number | undefined;
+    productiveLateralFootage?: number | undefined;
+}>;
+/**
+ * Per-tract ratification gap for pooled-unit basis. Mirrors the gaps[] pattern
+ * on ownership-interest: ratifications are load-bearing (pooling often not
+ * binding until ratified), so the model renders gaps as gaps rather than
+ * asserting clean coverage over a broken record.
+ */
+export interface RatificationGap {
+    tractDid: string;
+    gapDescription: string;
+}
+export declare const RATIFICATION_GAP_SCHEMA: z.ZodObject<{
+    tractDid: z.ZodString;
+    gapDescription: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    tractDid: string;
+    gapDescription: string;
+}, {
+    tractDid: string;
+    gapDescription: string;
+}>;
+/**
+ * Revenue-allocation-unit atom instance per ADR-025 Herbert review
+ * (2026-07-06). One first-class object with two source adapters (pooled-unit
+ * from county instruments; allocation-well from RRC plat), discriminated by
+ * `basis`. Defines how production revenue allocates across tracts for a well
+ * or well set.
+ *
+ * Per ADR-025: "The DOI is derived, never source." Computed owner decimals
+ * (allocation factor × NMI × lease royalty) are engine-run outputs
+ * (procedure-execution). Obtained operator DOIs / signed division orders enter
+ * as external assertions linked by a `reconciles-with` edge to the computed
+ * value; discrepancies surface as disputes, never silent overwrites.
+ *
+ * DID format: unit_<hash> (hashed derivation from source, externalId).
+ */
+export interface RevenueAllocationUnitAtomInstance {
+    entityType: "revenue-allocation-unit";
+    unitDid: string;
+    basis: UnitBasis;
+    wellDids: ReadonlyArray<string>;
+    operatorActorDid: string;
+    effectiveFrom: string;
+    effectiveTo?: string;
+    tractParticipations: ReadonlyArray<TractParticipation>;
+    sourceInstrumentDids?: ReadonlyArray<string>;
+    ratificationInstrumentDids?: ReadonlyArray<string>;
+    ratificationGaps?: ReadonlyArray<RatificationGap>;
+    sourcePlatCid?: string;
+    sourceNote?: string;
+    sourceCitation: string;
+    extractedAt: string;
+    asOf?: string;
+    accessPolicy: AccessPolicy;
+}
+/**
+ * Revenue-allocation-unit schema with discriminated union on basis. Each basis
+ * variant enforces its required fields; for example, pooled-unit requires
+ * sourceInstrumentDids, allocation-well requires sourcePlatCid.
+ * PSA basis requires either sourceInstrumentDids or sourceNote (validated post-parse).
+ */
+export declare const REVENUE_ALLOCATION_UNIT_SCHEMA: z.ZodEffects<z.ZodDiscriminatedUnion<"basis", [z.ZodObject<{
+    accessPolicy: z.ZodEnum<["public-free", "public-paid", "platform-internal", "tenant-private", "tenant-shared"]>;
+    sourceCitation: z.ZodString;
+    extractedAt: z.ZodString;
+    asOf: z.ZodOptional<z.ZodString>;
+    entityType: z.ZodLiteral<"revenue-allocation-unit">;
+    unitDid: z.ZodEffects<z.ZodString, string, string>;
+    wellDids: z.ZodArray<z.ZodString, "many">;
+    operatorActorDid: z.ZodString;
+    effectiveFrom: z.ZodString;
+    effectiveTo: z.ZodOptional<z.ZodString>;
+    tractParticipations: z.ZodArray<z.ZodObject<{
+        tractDid: z.ZodString;
+        factor: z.ZodNumber;
+        allocationMethod: z.ZodEnum<[AllocationMethod, ...AllocationMethod[]]>;
+        source: z.ZodString;
+        confidence: z.ZodReadonly<z.ZodObject<{
+            readonly estimate: z.ZodNumber;
+            readonly n: z.ZodNumber;
+            readonly intervalWidth: z.ZodNumber;
+            readonly provenance: z.ZodEnum<["asserted", "backtest", "seed", "live"]>;
+        }, "strip", z.ZodTypeAny, {
+            estimate: number;
+            n: number;
+            intervalWidth: number;
+            provenance: "asserted" | "backtest" | "seed" | "live";
+        }, {
+            estimate: number;
+            n: number;
+            intervalWidth: number;
+            provenance: "asserted" | "backtest" | "seed" | "live";
+        }>>;
+        takePoints: z.ZodOptional<z.ZodNumber>;
+        productiveLateralFootage: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        confidence: Readonly<{
+            estimate: number;
+            n: number;
+            intervalWidth: number;
+            provenance: "asserted" | "backtest" | "seed" | "live";
+        }>;
+        source: string;
+        tractDid: string;
+        factor: number;
+        allocationMethod: AllocationMethod;
+        takePoints?: number | undefined;
+        productiveLateralFootage?: number | undefined;
+    }, {
+        confidence: Readonly<{
+            estimate: number;
+            n: number;
+            intervalWidth: number;
+            provenance: "asserted" | "backtest" | "seed" | "live";
+        }>;
+        source: string;
+        tractDid: string;
+        factor: number;
+        allocationMethod: AllocationMethod;
+        takePoints?: number | undefined;
+        productiveLateralFootage?: number | undefined;
+    }>, "many">;
+} & {
+    basis: z.ZodLiteral<"pooled-unit">;
+    sourceInstrumentDids: z.ZodArray<z.ZodString, "many">;
+    ratificationInstrumentDids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    ratificationGaps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        tractDid: z.ZodString;
+        gapDescription: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        tractDid: string;
+        gapDescription: string;
+    }, {
+        tractDid: string;
+        gapDescription: string;
+    }>, "many">>;
+    sourcePlatCid: z.ZodUndefined;
+    sourceNote: z.ZodUndefined;
+}, "strip", z.ZodTypeAny, {
+    accessPolicy: "public-free" | "public-paid" | "platform-internal" | "tenant-private" | "tenant-shared";
+    entityType: "revenue-allocation-unit";
+    sourceCitation: string;
+    extractedAt: string;
+    basis: "pooled-unit";
+    wellDids: string[];
+    operatorActorDid: string;
+    effectiveFrom: string;
+    unitDid: string;
+    tractParticipations: {
+        confidence: Readonly<{
+            estimate: number;
+            n: number;
+            intervalWidth: number;
+            provenance: "asserted" | "backtest" | "seed" | "live";
+        }>;
+        source: string;
+        tractDid: string;
+        factor: number;
+        allocationMethod: AllocationMethod;
+        takePoints?: number | undefined;
+        productiveLateralFootage?: number | undefined;
+    }[];
+    sourceInstrumentDids: string[];
+    asOf?: string | undefined;
+    effectiveTo?: string | undefined;
+    ratificationInstrumentDids?: string[] | undefined;
+    ratificationGaps?: {
+        tractDid: string;
+        gapDescription: string;
+    }[] | undefined;
+    sourcePlatCid?: undefined;
+    sourceNote?: undefined;
+}, {
+    accessPolicy: "public-free" | "public-paid" | "platform-internal" | "tenant-private" | "tenant-shared";
+    entityType: "revenue-allocation-unit";
+    sourceCitation: string;
+    extractedAt: string;
+    basis: "pooled-unit";
+    wellDids: string[];
+    operatorActorDid: string;
+    effectiveFrom: string;
+    unitDid: string;
+    tractParticipations: {
+        confidence: Readonly<{
+            estimate: number;
+            n: number;
+            intervalWidth: number;
+            provenance: "asserted" | "backtest" | "seed" | "live";
+        }>;
+        source: string;
+        tractDid: string;
+        factor: number;
+        allocationMethod: AllocationMethod;
+        takePoints?: number | undefined;
+        productiveLateralFootage?: number | undefined;
+    }[];
+    sourceInstrumentDids: string[];
+    asOf?: string | undefined;
+    effectiveTo?: string | undefined;
+    ratificationInstrumentDids?: string[] | undefined;
+    ratificationGaps?: {
+        tractDid: string;
+        gapDescription: string;
+    }[] | undefined;
+    sourcePlatCid?: undefined;
+    sourceNote?: undefined;
+}>, z.ZodObject<{
+    accessPolicy: z.ZodEnum<["public-free", "public-paid", "platform-internal", "tenant-private", "tenant-shared"]>;
+    sourceCitation: z.ZodString;
+    extractedAt: z.ZodString;
+    asOf: z.ZodOptional<z.ZodString>;
+    entityType: z.ZodLiteral<"revenue-allocation-unit">;
+    unitDid: z.ZodEffects<z.ZodString, string, string>;
+    wellDids: z.ZodArray<z.ZodString, "many">;
+    operatorActorDid: z.ZodString;
+    effectiveFrom: z.ZodString;
+    effectiveTo: z.ZodOptional<z.ZodString>;
+    tractParticipations: z.ZodArray<z.ZodObject<{
+        tractDid: z.ZodString;
+        factor: z.ZodNumber;
+        allocationMethod: z.ZodEnum<[AllocationMethod, ...AllocationMethod[]]>;
+        source: z.ZodString;
+        confidence: z.ZodReadonly<z.ZodObject<{
+            readonly estimate: z.ZodNumber;
+            readonly n: z.ZodNumber;
+            readonly intervalWidth: z.ZodNumber;
+            readonly provenance: z.ZodEnum<["asserted", "backtest", "seed", "live"]>;
+        }, "strip", z.ZodTypeAny, {
+            estimate: number;
+            n: number;
+            intervalWidth: number;
+            provenance: "asserted" | "backtest" | "seed" | "live";
+        }, {
+            estimate: number;
+            n: number;
+            intervalWidth: number;
+            provenance: "asserted" | "backtest" | "seed" | "live";
+        }>>;
+        takePoints: z.ZodOptional<z.ZodNumber>;
+        productiveLateralFootage: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        confidence: Readonly<{
+            estimate: number;
+            n: number;
+            intervalWidth: number;
+            provenance: "asserted" | "backtest" | "seed" | "live";
+        }>;
+        source: string;
+        tractDid: string;
+        factor: number;
+        allocationMethod: AllocationMethod;
+        takePoints?: number | undefined;
+        productiveLateralFootage?: number | undefined;
+    }, {
+        confidence: Readonly<{
+            estimate: number;
+            n: number;
+            intervalWidth: number;
+            provenance: "asserted" | "backtest" | "seed" | "live";
+        }>;
+        source: string;
+        tractDid: string;
+        factor: number;
+        allocationMethod: AllocationMethod;
+        takePoints?: number | undefined;
+        productiveLateralFootage?: number | undefined;
+    }>, "many">;
+} & {
+    basis: z.ZodLiteral<"allocation-well">;
+    sourcePlatCid: z.ZodString;
+    sourceInstrumentDids: z.ZodUndefined;
+    ratificationInstrumentDids: z.ZodUndefined;
+    ratificationGaps: z.ZodUndefined;
+    sourceNote: z.ZodUndefined;
+}, "strip", z.ZodTypeAny, {
+    accessPolicy: "public-free" | "public-paid" | "platform-internal" | "tenant-private" | "tenant-shared";
+    entityType: "revenue-allocation-unit";
+    sourceCitation: string;
+    extractedAt: string;
+    basis: "allocation-well";
+    wellDids: string[];
+    operatorActorDid: string;
+    effectiveFrom: string;
+    unitDid: string;
+    tractParticipations: {
+        confidence: Readonly<{
+            estimate: number;
+            n: number;
+            intervalWidth: number;
+            provenance: "asserted" | "backtest" | "seed" | "live";
+        }>;
+        source: string;
+        tractDid: string;
+        factor: number;
+        allocationMethod: AllocationMethod;
+        takePoints?: number | undefined;
+        productiveLateralFootage?: number | undefined;
+    }[];
+    sourcePlatCid: string;
+    asOf?: string | undefined;
+    effectiveTo?: string | undefined;
+    sourceInstrumentDids?: undefined;
+    ratificationInstrumentDids?: undefined;
+    ratificationGaps?: undefined;
+    sourceNote?: undefined;
+}, {
+    accessPolicy: "public-free" | "public-paid" | "platform-internal" | "tenant-private" | "tenant-shared";
+    entityType: "revenue-allocation-unit";
+    sourceCitation: string;
+    extractedAt: string;
+    basis: "allocation-well";
+    wellDids: string[];
+    operatorActorDid: string;
+    effectiveFrom: string;
+    unitDid: string;
+    tractParticipations: {
+        confidence: Readonly<{
+            estimate: number;
+            n: number;
+            intervalWidth: number;
+            provenance: "asserted" | "backtest" | "seed" | "live";
+        }>;
+        source: string;
+        tractDid: string;
+        factor: number;
+        allocationMethod: AllocationMethod;
+        takePoints?: number | undefined;
+        productiveLateralFootage?: number | undefined;
+    }[];
+    sourcePlatCid: string;
+    asOf?: string | undefined;
+    effectiveTo?: string | undefined;
+    sourceInstrumentDids?: undefined;
+    ratificationInstrumentDids?: undefined;
+    ratificationGaps?: undefined;
+    sourceNote?: undefined;
+}>, z.ZodObject<{
+    accessPolicy: z.ZodEnum<["public-free", "public-paid", "platform-internal", "tenant-private", "tenant-shared"]>;
+    sourceCitation: z.ZodString;
+    extractedAt: z.ZodString;
+    asOf: z.ZodOptional<z.ZodString>;
+    entityType: z.ZodLiteral<"revenue-allocation-unit">;
+    unitDid: z.ZodEffects<z.ZodString, string, string>;
+    wellDids: z.ZodArray<z.ZodString, "many">;
+    operatorActorDid: z.ZodString;
+    effectiveFrom: z.ZodString;
+    effectiveTo: z.ZodOptional<z.ZodString>;
+    tractParticipations: z.ZodArray<z.ZodObject<{
+        tractDid: z.ZodString;
+        factor: z.ZodNumber;
+        allocationMethod: z.ZodEnum<[AllocationMethod, ...AllocationMethod[]]>;
+        source: z.ZodString;
+        confidence: z.ZodReadonly<z.ZodObject<{
+            readonly estimate: z.ZodNumber;
+            readonly n: z.ZodNumber;
+            readonly intervalWidth: z.ZodNumber;
+            readonly provenance: z.ZodEnum<["asserted", "backtest", "seed", "live"]>;
+        }, "strip", z.ZodTypeAny, {
+            estimate: number;
+            n: number;
+            intervalWidth: number;
+            provenance: "asserted" | "backtest" | "seed" | "live";
+        }, {
+            estimate: number;
+            n: number;
+            intervalWidth: number;
+            provenance: "asserted" | "backtest" | "seed" | "live";
+        }>>;
+        takePoints: z.ZodOptional<z.ZodNumber>;
+        productiveLateralFootage: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        confidence: Readonly<{
+            estimate: number;
+            n: number;
+            intervalWidth: number;
+            provenance: "asserted" | "backtest" | "seed" | "live";
+        }>;
+        source: string;
+        tractDid: string;
+        factor: number;
+        allocationMethod: AllocationMethod;
+        takePoints?: number | undefined;
+        productiveLateralFootage?: number | undefined;
+    }, {
+        confidence: Readonly<{
+            estimate: number;
+            n: number;
+            intervalWidth: number;
+            provenance: "asserted" | "backtest" | "seed" | "live";
+        }>;
+        source: string;
+        tractDid: string;
+        factor: number;
+        allocationMethod: AllocationMethod;
+        takePoints?: number | undefined;
+        productiveLateralFootage?: number | undefined;
+    }>, "many">;
+} & {
+    basis: z.ZodLiteral<"psa">;
+    sourceInstrumentDids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    sourceNote: z.ZodOptional<z.ZodString>;
+    ratificationInstrumentDids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    ratificationGaps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        tractDid: z.ZodString;
+        gapDescription: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        tractDid: string;
+        gapDescription: string;
+    }, {
+        tractDid: string;
+        gapDescription: string;
+    }>, "many">>;
+    sourcePlatCid: z.ZodUndefined;
+}, "strip", z.ZodTypeAny, {
+    accessPolicy: "public-free" | "public-paid" | "platform-internal" | "tenant-private" | "tenant-shared";
+    entityType: "revenue-allocation-unit";
+    sourceCitation: string;
+    extractedAt: string;
+    basis: "psa";
+    wellDids: string[];
+    operatorActorDid: string;
+    effectiveFrom: string;
+    unitDid: string;
+    tractParticipations: {
+        confidence: Readonly<{
+            estimate: number;
+            n: number;
+            intervalWidth: number;
+            provenance: "asserted" | "backtest" | "seed" | "live";
+        }>;
+        source: string;
+        tractDid: string;
+        factor: number;
+        allocationMethod: AllocationMethod;
+        takePoints?: number | undefined;
+        productiveLateralFootage?: number | undefined;
+    }[];
+    asOf?: string | undefined;
+    effectiveTo?: string | undefined;
+    sourceInstrumentDids?: string[] | undefined;
+    ratificationInstrumentDids?: string[] | undefined;
+    ratificationGaps?: {
+        tractDid: string;
+        gapDescription: string;
+    }[] | undefined;
+    sourcePlatCid?: undefined;
+    sourceNote?: string | undefined;
+}, {
+    accessPolicy: "public-free" | "public-paid" | "platform-internal" | "tenant-private" | "tenant-shared";
+    entityType: "revenue-allocation-unit";
+    sourceCitation: string;
+    extractedAt: string;
+    basis: "psa";
+    wellDids: string[];
+    operatorActorDid: string;
+    effectiveFrom: string;
+    unitDid: string;
+    tractParticipations: {
+        confidence: Readonly<{
+            estimate: number;
+            n: number;
+            intervalWidth: number;
+            provenance: "asserted" | "backtest" | "seed" | "live";
+        }>;
+        source: string;
+        tractDid: string;
+        factor: number;
+        allocationMethod: AllocationMethod;
+        takePoints?: number | undefined;
+        productiveLateralFootage?: number | undefined;
+    }[];
+    asOf?: string | undefined;
+    effectiveTo?: string | undefined;
+    sourceInstrumentDids?: string[] | undefined;
+    ratificationInstrumentDids?: string[] | undefined;
+    ratificationGaps?: {
+        tractDid: string;
+        gapDescription: string;
+    }[] | undefined;
+    sourcePlatCid?: undefined;
+    sourceNote?: string | undefined;
+}>]>, {
+    accessPolicy: "public-free" | "public-paid" | "platform-internal" | "tenant-private" | "tenant-shared";
+    entityType: "revenue-allocation-unit";
+    sourceCitation: string;
+    extractedAt: string;
+    basis: "pooled-unit";
+    wellDids: string[];
+    operatorActorDid: string;
+    effectiveFrom: string;
+    unitDid: string;
+    tractParticipations: {
+        confidence: Readonly<{
+            estimate: number;
+            n: number;
+            intervalWidth: number;
+            provenance: "asserted" | "backtest" | "seed" | "live";
+        }>;
+        source: string;
+        tractDid: string;
+        factor: number;
+        allocationMethod: AllocationMethod;
+        takePoints?: number | undefined;
+        productiveLateralFootage?: number | undefined;
+    }[];
+    sourceInstrumentDids: string[];
+    asOf?: string | undefined;
+    effectiveTo?: string | undefined;
+    ratificationInstrumentDids?: string[] | undefined;
+    ratificationGaps?: {
+        tractDid: string;
+        gapDescription: string;
+    }[] | undefined;
+    sourcePlatCid?: undefined;
+    sourceNote?: undefined;
+} | {
+    accessPolicy: "public-free" | "public-paid" | "platform-internal" | "tenant-private" | "tenant-shared";
+    entityType: "revenue-allocation-unit";
+    sourceCitation: string;
+    extractedAt: string;
+    basis: "allocation-well";
+    wellDids: string[];
+    operatorActorDid: string;
+    effectiveFrom: string;
+    unitDid: string;
+    tractParticipations: {
+        confidence: Readonly<{
+            estimate: number;
+            n: number;
+            intervalWidth: number;
+            provenance: "asserted" | "backtest" | "seed" | "live";
+        }>;
+        source: string;
+        tractDid: string;
+        factor: number;
+        allocationMethod: AllocationMethod;
+        takePoints?: number | undefined;
+        productiveLateralFootage?: number | undefined;
+    }[];
+    sourcePlatCid: string;
+    asOf?: string | undefined;
+    effectiveTo?: string | undefined;
+    sourceInstrumentDids?: undefined;
+    ratificationInstrumentDids?: undefined;
+    ratificationGaps?: undefined;
+    sourceNote?: undefined;
+} | {
+    accessPolicy: "public-free" | "public-paid" | "platform-internal" | "tenant-private" | "tenant-shared";
+    entityType: "revenue-allocation-unit";
+    sourceCitation: string;
+    extractedAt: string;
+    basis: "psa";
+    wellDids: string[];
+    operatorActorDid: string;
+    effectiveFrom: string;
+    unitDid: string;
+    tractParticipations: {
+        confidence: Readonly<{
+            estimate: number;
+            n: number;
+            intervalWidth: number;
+            provenance: "asserted" | "backtest" | "seed" | "live";
+        }>;
+        source: string;
+        tractDid: string;
+        factor: number;
+        allocationMethod: AllocationMethod;
+        takePoints?: number | undefined;
+        productiveLateralFootage?: number | undefined;
+    }[];
+    asOf?: string | undefined;
+    effectiveTo?: string | undefined;
+    sourceInstrumentDids?: string[] | undefined;
+    ratificationInstrumentDids?: string[] | undefined;
+    ratificationGaps?: {
+        tractDid: string;
+        gapDescription: string;
+    }[] | undefined;
+    sourcePlatCid?: undefined;
+    sourceNote?: string | undefined;
+}, {
+    accessPolicy: "public-free" | "public-paid" | "platform-internal" | "tenant-private" | "tenant-shared";
+    entityType: "revenue-allocation-unit";
+    sourceCitation: string;
+    extractedAt: string;
+    basis: "pooled-unit";
+    wellDids: string[];
+    operatorActorDid: string;
+    effectiveFrom: string;
+    unitDid: string;
+    tractParticipations: {
+        confidence: Readonly<{
+            estimate: number;
+            n: number;
+            intervalWidth: number;
+            provenance: "asserted" | "backtest" | "seed" | "live";
+        }>;
+        source: string;
+        tractDid: string;
+        factor: number;
+        allocationMethod: AllocationMethod;
+        takePoints?: number | undefined;
+        productiveLateralFootage?: number | undefined;
+    }[];
+    sourceInstrumentDids: string[];
+    asOf?: string | undefined;
+    effectiveTo?: string | undefined;
+    ratificationInstrumentDids?: string[] | undefined;
+    ratificationGaps?: {
+        tractDid: string;
+        gapDescription: string;
+    }[] | undefined;
+    sourcePlatCid?: undefined;
+    sourceNote?: undefined;
+} | {
+    accessPolicy: "public-free" | "public-paid" | "platform-internal" | "tenant-private" | "tenant-shared";
+    entityType: "revenue-allocation-unit";
+    sourceCitation: string;
+    extractedAt: string;
+    basis: "allocation-well";
+    wellDids: string[];
+    operatorActorDid: string;
+    effectiveFrom: string;
+    unitDid: string;
+    tractParticipations: {
+        confidence: Readonly<{
+            estimate: number;
+            n: number;
+            intervalWidth: number;
+            provenance: "asserted" | "backtest" | "seed" | "live";
+        }>;
+        source: string;
+        tractDid: string;
+        factor: number;
+        allocationMethod: AllocationMethod;
+        takePoints?: number | undefined;
+        productiveLateralFootage?: number | undefined;
+    }[];
+    sourcePlatCid: string;
+    asOf?: string | undefined;
+    effectiveTo?: string | undefined;
+    sourceInstrumentDids?: undefined;
+    ratificationInstrumentDids?: undefined;
+    ratificationGaps?: undefined;
+    sourceNote?: undefined;
+} | {
+    accessPolicy: "public-free" | "public-paid" | "platform-internal" | "tenant-private" | "tenant-shared";
+    entityType: "revenue-allocation-unit";
+    sourceCitation: string;
+    extractedAt: string;
+    basis: "psa";
+    wellDids: string[];
+    operatorActorDid: string;
+    effectiveFrom: string;
+    unitDid: string;
+    tractParticipations: {
+        confidence: Readonly<{
+            estimate: number;
+            n: number;
+            intervalWidth: number;
+            provenance: "asserted" | "backtest" | "seed" | "live";
+        }>;
+        source: string;
+        tractDid: string;
+        factor: number;
+        allocationMethod: AllocationMethod;
+        takePoints?: number | undefined;
+        productiveLateralFootage?: number | undefined;
+    }[];
+    asOf?: string | undefined;
+    effectiveTo?: string | undefined;
+    sourceInstrumentDids?: string[] | undefined;
+    ratificationInstrumentDids?: string[] | undefined;
+    ratificationGaps?: {
+        tractDid: string;
+        gapDescription: string;
+    }[] | undefined;
+    sourcePlatCid?: undefined;
+    sourceNote?: string | undefined;
+}>;
+//# sourceMappingURL=revenue-allocation-unit.d.ts.map