@empressaio/atom-contract 1.7.0

package/dist/og/ownership-interest.d.ts

@@ -0,0 +1,163 @@
+import { z } from "zod";
+import type { AccessPolicy } from "../registration.js";
+import { type WidthedConfidence } from "../read-contract/common.js";
+import { type InterestType } from "./common.js";
+/**
+ * Ownership-interest atom instance per ADR-025 — single type with
+ * discriminator. Interest is a conclusion reasoned from recorded instruments,
+ * so it carries confidence, sourceCitation, and gaps[] where the record is
+ * broken.
+ * DID format: intr_<hash> (hashed derivation from source, externalId).
+ */
+export interface OwnershipInterestAtomInstance {
+    entityType: "ownership-interest";
+    interestDid: string;
+    interestType: InterestType;
+    ownerActorDid: string;
+    anchorTractDid?: string;
+    anchorLeaseDid?: string;
+    decimalInterest: number;
+    fraction?: string;
+    burdens?: string;
+    effectiveFrom: string;
+    effectiveTo?: string;
+    derivedFromInstrumentDids: ReadonlyArray<string>;
+    gaps?: ReadonlyArray<string>;
+    confidence: WidthedConfidence;
+    sourceCitation: string;
+    extractedAt: string;
+    asOf?: string;
+    accessPolicy: AccessPolicy;
+}
+export declare const OWNERSHIP_INTEREST_SCHEMA: z.ZodEffects<z.ZodObject<{
+    entityType: z.ZodLiteral<"ownership-interest">;
+    interestDid: z.ZodEffects<z.ZodString, string, string>;
+    interestType: z.ZodEnum<[InterestType, ...InterestType[]]>;
+    ownerActorDid: z.ZodString;
+    anchorTractDid: z.ZodOptional<z.ZodString>;
+    anchorLeaseDid: z.ZodOptional<z.ZodString>;
+    decimalInterest: z.ZodNumber;
+    fraction: z.ZodOptional<z.ZodString>;
+    burdens: z.ZodOptional<z.ZodString>;
+    effectiveFrom: z.ZodString;
+    effectiveTo: z.ZodOptional<z.ZodString>;
+    derivedFromInstrumentDids: z.ZodArray<z.ZodString, "many">;
+    gaps: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    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";
+    }>>;
+    sourceCitation: z.ZodString;
+    extractedAt: z.ZodString;
+    asOf: z.ZodOptional<z.ZodString>;
+    accessPolicy: z.ZodEnum<["public-free", "public-paid", "platform-internal", "tenant-private", "tenant-shared"]>;
+}, "strip", z.ZodTypeAny, {
+    accessPolicy: "public-free" | "public-paid" | "platform-internal" | "tenant-private" | "tenant-shared";
+    entityType: "ownership-interest";
+    confidence: Readonly<{
+        estimate: number;
+        n: number;
+        intervalWidth: number;
+        provenance: "asserted" | "backtest" | "seed" | "live";
+    }>;
+    sourceCitation: string;
+    extractedAt: string;
+    interestDid: string;
+    interestType: InterestType;
+    ownerActorDid: string;
+    decimalInterest: number;
+    effectiveFrom: string;
+    derivedFromInstrumentDids: string[];
+    asOf?: string | undefined;
+    anchorTractDid?: string | undefined;
+    anchorLeaseDid?: string | undefined;
+    fraction?: string | undefined;
+    burdens?: string | undefined;
+    effectiveTo?: string | undefined;
+    gaps?: string[] | undefined;
+}, {
+    accessPolicy: "public-free" | "public-paid" | "platform-internal" | "tenant-private" | "tenant-shared";
+    entityType: "ownership-interest";
+    confidence: Readonly<{
+        estimate: number;
+        n: number;
+        intervalWidth: number;
+        provenance: "asserted" | "backtest" | "seed" | "live";
+    }>;
+    sourceCitation: string;
+    extractedAt: string;
+    interestDid: string;
+    interestType: InterestType;
+    ownerActorDid: string;
+    decimalInterest: number;
+    effectiveFrom: string;
+    derivedFromInstrumentDids: string[];
+    asOf?: string | undefined;
+    anchorTractDid?: string | undefined;
+    anchorLeaseDid?: string | undefined;
+    fraction?: string | undefined;
+    burdens?: string | undefined;
+    effectiveTo?: string | undefined;
+    gaps?: string[] | undefined;
+}>, {
+    accessPolicy: "public-free" | "public-paid" | "platform-internal" | "tenant-private" | "tenant-shared";
+    entityType: "ownership-interest";
+    confidence: Readonly<{
+        estimate: number;
+        n: number;
+        intervalWidth: number;
+        provenance: "asserted" | "backtest" | "seed" | "live";
+    }>;
+    sourceCitation: string;
+    extractedAt: string;
+    interestDid: string;
+    interestType: InterestType;
+    ownerActorDid: string;
+    decimalInterest: number;
+    effectiveFrom: string;
+    derivedFromInstrumentDids: string[];
+    asOf?: string | undefined;
+    anchorTractDid?: string | undefined;
+    anchorLeaseDid?: string | undefined;
+    fraction?: string | undefined;
+    burdens?: string | undefined;
+    effectiveTo?: string | undefined;
+    gaps?: string[] | undefined;
+}, {
+    accessPolicy: "public-free" | "public-paid" | "platform-internal" | "tenant-private" | "tenant-shared";
+    entityType: "ownership-interest";
+    confidence: Readonly<{
+        estimate: number;
+        n: number;
+        intervalWidth: number;
+        provenance: "asserted" | "backtest" | "seed" | "live";
+    }>;
+    sourceCitation: string;
+    extractedAt: string;
+    interestDid: string;
+    interestType: InterestType;
+    ownerActorDid: string;
+    decimalInterest: number;
+    effectiveFrom: string;
+    derivedFromInstrumentDids: string[];
+    asOf?: string | undefined;
+    anchorTractDid?: string | undefined;
+    anchorLeaseDid?: string | undefined;
+    fraction?: string | undefined;
+    burdens?: string | undefined;
+    effectiveTo?: string | undefined;
+    gaps?: string[] | undefined;
+}>;
+//# sourceMappingURL=ownership-interest.d.ts.map

package/dist/og/ownership-interest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ownership-interest.d.ts","sourceRoot":"","sources":["../../src/og/ownership-interest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAA6B,KAAK,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/F,OAAO,EAA2C,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAEzF;;;;;;GAMG;AACH,MAAM,WAAW,6BAA6B;IAC5C,UAAU,EAAE,oBAAoB,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,YAAY,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yBAAyB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACjD,IAAI,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC7B,UAAU,EAAE,iBAAiB,CAAC;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkCnC,CAAC"}

package/dist/og/ownership-interest.js

@@ -0,0 +1,36 @@
+import { z } from "zod";
+import { WIDTHED_CONFIDENCE_SCHEMA } from "../read-contract/common.js";
+import { INTEREST_TYPES, OG_ACCESS_POLICY_SCHEMA } from "./common.js";
+export const OWNERSHIP_INTEREST_SCHEMA = z
+    .object({
+    entityType: z.literal("ownership-interest"),
+    interestDid: z
+        .string()
+        .min(1)
+        .refine((val) => /^intr_[0-9a-f]{16}$/.test(val), {
+        message: "interestDid must be in format intr_<16-hex-chars>",
+    }),
+    interestType: z.enum(INTEREST_TYPES),
+    ownerActorDid: z.string().min(1),
+    anchorTractDid: z.string().min(1).optional(),
+    anchorLeaseDid: z.string().min(1).optional(),
+    decimalInterest: z.number(),
+    fraction: z.string().min(1).optional(),
+    burdens: z.string().min(1).optional(),
+    effectiveFrom: z.string().min(1),
+    effectiveTo: z.string().min(1).optional(),
+    derivedFromInstrumentDids: z.array(z.string().min(1)),
+    gaps: z.array(z.string().min(1)).optional(),
+    confidence: WIDTHED_CONFIDENCE_SCHEMA,
+    sourceCitation: z.string().min(1),
+    extractedAt: z.string().min(1),
+    asOf: z.string().min(1).optional(),
+    accessPolicy: OG_ACCESS_POLICY_SCHEMA,
+})
+    .refine((data) => {
+    return data.anchorTractDid !== undefined || data.anchorLeaseDid !== undefined;
+}, {
+    message: "At least one of anchorTractDid or anchorLeaseDid is required",
+    path: ["anchorTractDid"],
+});
+//# sourceMappingURL=ownership-interest.js.map

package/dist/og/ownership-interest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ownership-interest.js","sourceRoot":"","sources":["../../src/og/ownership-interest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,yBAAyB,EAA0B,MAAM,4BAA4B,CAAC;AAC/F,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAqB,MAAM,aAAa,CAAC;AA8BzF,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC;KACvC,MAAM,CAAC;IACN,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAAC;IAC3C,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;QAChD,OAAO,EAAE,mDAAmD;KAC7D,CAAC;IACJ,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,cAAmD,CAAC;IACzE,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAChC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC5C,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC5C,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;IAC3B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACtC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACrC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAChC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACzC,yBAAyB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACrD,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC3C,UAAU,EAAE,yBAAyB;IACrC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACjC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAClC,YAAY,EAAE,uBAAuB;CACtC,CAAC;KACD,MAAM,CACL,CAAC,IAAI,EAAE,EAAE;IACP,OAAO,IAAI,CAAC,cAAc,KAAK,SAAS,IAAI,IAAI,CAAC,cAAc,KAAK,SAAS,CAAC;AAChF,CAAC,EACD;IACE,OAAO,EAAE,8DAA8D;IACvE,IAAI,EAAE,CAAC,gBAAgB,CAAC;CACzB,CACF,CAAC"}

package/dist/og/pad.d.ts

@@ -0,0 +1,101 @@
+import { z } from "zod";
+import type { AccessPolicy } from "../registration.js";
+import { type WidthedConfidence } from "../read-contract/common.js";
+import { type GeoLocation } from "./common.js";
+/**
+ * Pad atom instance per ADR-025 — derived surface grouping of wells at a site.
+ * DID format: pad_<hash> (hashed derivation from source, externalId).
+ * Confidence on the grouping is asserted with the derivation method named.
+ */
+export interface PadAtomInstance {
+    entityType: "pad";
+    padDid: string;
+    wellDids: ReadonlyArray<string>;
+    surfaceLocation: GeoLocation;
+    derivationMethod: string;
+    confidence: WidthedConfidence;
+    sourceCitation: string;
+    extractedAt: string;
+    asOf?: string;
+    accessPolicy: AccessPolicy;
+}
+export declare const PAD_SCHEMA: 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<"pad">;
+    padDid: z.ZodEffects<z.ZodString, string, string>;
+    wellDids: z.ZodArray<z.ZodString, "many">;
+    surfaceLocation: z.ZodObject<{
+        latitude: z.ZodNumber;
+        longitude: z.ZodNumber;
+        datum: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        latitude: number;
+        longitude: number;
+        datum: string;
+    }, {
+        latitude: number;
+        longitude: number;
+        datum: string;
+    }>;
+    derivationMethod: 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";
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    accessPolicy: "public-free" | "public-paid" | "platform-internal" | "tenant-private" | "tenant-shared";
+    entityType: "pad";
+    confidence: Readonly<{
+        estimate: number;
+        n: number;
+        intervalWidth: number;
+        provenance: "asserted" | "backtest" | "seed" | "live";
+    }>;
+    sourceCitation: string;
+    extractedAt: string;
+    surfaceLocation: {
+        latitude: number;
+        longitude: number;
+        datum: string;
+    };
+    padDid: string;
+    wellDids: string[];
+    derivationMethod: string;
+    asOf?: string | undefined;
+}, {
+    accessPolicy: "public-free" | "public-paid" | "platform-internal" | "tenant-private" | "tenant-shared";
+    entityType: "pad";
+    confidence: Readonly<{
+        estimate: number;
+        n: number;
+        intervalWidth: number;
+        provenance: "asserted" | "backtest" | "seed" | "live";
+    }>;
+    sourceCitation: string;
+    extractedAt: string;
+    surfaceLocation: {
+        latitude: number;
+        longitude: number;
+        datum: string;
+    };
+    padDid: string;
+    wellDids: string[];
+    derivationMethod: string;
+    asOf?: string | undefined;
+}>;
+//# sourceMappingURL=pad.d.ts.map

package/dist/og/pad.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pad.d.ts","sourceRoot":"","sources":["../../src/og/pad.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAA6B,KAAK,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/F,OAAO,EAAwE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAErH;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,KAAK,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAChC,eAAe,EAAE,WAAW,CAAC;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAcrB,CAAC"}

package/dist/og/pad.js

@@ -0,0 +1,19 @@
+import { z } from "zod";
+import { WIDTHED_CONFIDENCE_SCHEMA } from "../read-contract/common.js";
+import { GEO_LOCATION_SCHEMA, OG_ACCESS_POLICY_SCHEMA, OG_QUALITY_GATE_FIELDS } from "./common.js";
+export const PAD_SCHEMA = z.object({
+    entityType: z.literal("pad"),
+    padDid: z
+        .string()
+        .min(1)
+        .refine((val) => /^pad_[0-9a-f]{16}$/.test(val), {
+        message: "padDid must be in format pad_<16-hex-chars>",
+    }),
+    wellDids: z.array(z.string().min(1)),
+    surfaceLocation: GEO_LOCATION_SCHEMA,
+    derivationMethod: z.string().min(1),
+    confidence: WIDTHED_CONFIDENCE_SCHEMA,
+    ...OG_QUALITY_GATE_FIELDS,
+    accessPolicy: OG_ACCESS_POLICY_SCHEMA,
+});
+//# sourceMappingURL=pad.js.map

package/dist/og/pad.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pad.js","sourceRoot":"","sources":["../../src/og/pad.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,yBAAyB,EAA0B,MAAM,4BAA4B,CAAC;AAC/F,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,sBAAsB,EAAoB,MAAM,aAAa,CAAC;AAoBrH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IAC5B,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;QAC/C,OAAO,EAAE,6CAA6C;KACvD,CAAC;IACJ,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACpC,eAAe,EAAE,mBAAmB;IACpC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACnC,UAAU,EAAE,yBAAyB;IACrC,GAAG,sBAAsB;IACzB,YAAY,EAAE,uBAAuB;CACtC,CAAC,CAAC"}

package/dist/og/production-timeseries.d.ts

@@ -0,0 +1,154 @@
+import { z } from "zod";
+import type { AccessPolicy } from "../registration.js";
+import { type WidthedConfidence } from "../read-contract/common.js";
+import { type AnchorKind, type Granularity, type ProductType } from "./common.js";
+/**
+ * Stream kind discriminator per ADR-025 C1c finding #6.
+ * Reported streams are as-reported from source; derived streams require
+ * derivationMethod, confidence, and a derivesFromStreamDid link.
+ */
+export type StreamKind = "reported" | "derived-allocation";
+export declare const STREAM_KINDS: ReadonlyArray<StreamKind>;
+/**
+ * Production-timeseries atom instance per ADR-025 — one atom per stream,
+ * where a stream is (anchor, product, source). Models the reporting split:
+ * Texas oil production anchors to rrc-lease; gas anchors to well.
+ * DID format: prodts_<hash> (hashed derivation from source, externalId).
+ *
+ * A derived allocation must never be contract-indistinguishable from reported
+ * fact (ADR line ~86); streamKind discriminates them.
+ */
+export interface ProductionTimeseriesAtomInstance {
+    entityType: "production-timeseries";
+    streamDid: string;
+    streamKind: StreamKind;
+    anchorKind: AnchorKind;
+    anchorDid: string;
+    product: ProductType;
+    granularity: Granularity;
+    sourceAdapter: string;
+    derivationMethod?: string;
+    derivesFromStreamDid?: string;
+    confidence?: WidthedConfidence;
+    sourceCitation: string;
+    extractedAt: string;
+    asOf?: string;
+    accessPolicy: AccessPolicy;
+}
+export declare const PRODUCTION_TIMESERIES_SCHEMA: z.ZodEffects<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<"production-timeseries">;
+    streamDid: z.ZodEffects<z.ZodString, string, string>;
+    streamKind: z.ZodEnum<[StreamKind, ...StreamKind[]]>;
+    anchorKind: z.ZodEnum<[AnchorKind, ...AnchorKind[]]>;
+    anchorDid: z.ZodString;
+    product: z.ZodEnum<[ProductType, ...ProductType[]]>;
+    granularity: z.ZodEnum<[Granularity, ...Granularity[]]>;
+    sourceAdapter: z.ZodString;
+    derivationMethod: z.ZodOptional<z.ZodString>;
+    derivesFromStreamDid: z.ZodOptional<z.ZodString>;
+    confidence: z.ZodOptional<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";
+    }>>>;
+}, "strip", z.ZodTypeAny, {
+    accessPolicy: "public-free" | "public-paid" | "platform-internal" | "tenant-private" | "tenant-shared";
+    entityType: "production-timeseries";
+    sourceCitation: string;
+    anchorDid: string;
+    anchorKind: AnchorKind;
+    extractedAt: string;
+    sourceAdapter: string;
+    streamDid: string;
+    streamKind: StreamKind;
+    product: ProductType;
+    granularity: Granularity;
+    confidence?: Readonly<{
+        estimate: number;
+        n: number;
+        intervalWidth: number;
+        provenance: "asserted" | "backtest" | "seed" | "live";
+    }> | undefined;
+    asOf?: string | undefined;
+    derivationMethod?: string | undefined;
+    derivesFromStreamDid?: string | undefined;
+}, {
+    accessPolicy: "public-free" | "public-paid" | "platform-internal" | "tenant-private" | "tenant-shared";
+    entityType: "production-timeseries";
+    sourceCitation: string;
+    anchorDid: string;
+    anchorKind: AnchorKind;
+    extractedAt: string;
+    sourceAdapter: string;
+    streamDid: string;
+    streamKind: StreamKind;
+    product: ProductType;
+    granularity: Granularity;
+    confidence?: Readonly<{
+        estimate: number;
+        n: number;
+        intervalWidth: number;
+        provenance: "asserted" | "backtest" | "seed" | "live";
+    }> | undefined;
+    asOf?: string | undefined;
+    derivationMethod?: string | undefined;
+    derivesFromStreamDid?: string | undefined;
+}>, {
+    accessPolicy: "public-free" | "public-paid" | "platform-internal" | "tenant-private" | "tenant-shared";
+    entityType: "production-timeseries";
+    sourceCitation: string;
+    anchorDid: string;
+    anchorKind: AnchorKind;
+    extractedAt: string;
+    sourceAdapter: string;
+    streamDid: string;
+    streamKind: StreamKind;
+    product: ProductType;
+    granularity: Granularity;
+    confidence?: Readonly<{
+        estimate: number;
+        n: number;
+        intervalWidth: number;
+        provenance: "asserted" | "backtest" | "seed" | "live";
+    }> | undefined;
+    asOf?: string | undefined;
+    derivationMethod?: string | undefined;
+    derivesFromStreamDid?: string | undefined;
+}, {
+    accessPolicy: "public-free" | "public-paid" | "platform-internal" | "tenant-private" | "tenant-shared";
+    entityType: "production-timeseries";
+    sourceCitation: string;
+    anchorDid: string;
+    anchorKind: AnchorKind;
+    extractedAt: string;
+    sourceAdapter: string;
+    streamDid: string;
+    streamKind: StreamKind;
+    product: ProductType;
+    granularity: Granularity;
+    confidence?: Readonly<{
+        estimate: number;
+        n: number;
+        intervalWidth: number;
+        provenance: "asserted" | "backtest" | "seed" | "live";
+    }> | undefined;
+    asOf?: string | undefined;
+    derivationMethod?: string | undefined;
+    derivesFromStreamDid?: string | undefined;
+}>;
+//# sourceMappingURL=production-timeseries.d.ts.map

package/dist/og/production-timeseries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"production-timeseries.d.ts","sourceRoot":"","sources":["../../src/og/production-timeseries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAA6B,KAAK,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/F,OAAO,EAML,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,WAAW,EACjB,MAAM,aAAa,CAAC;AAErB;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,oBAAoB,CAAC;AAE3D,eAAO,MAAM,YAAY,EAAE,aAAa,CAAC,UAAU,CAAsC,CAAC;AAE1F;;;;;;;;GAQG;AACH,MAAM,WAAW,gCAAgC;IAC/C,UAAU,EAAE,uBAAuB,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,UAAU,CAAC;IACvB,UAAU,EAAE,UAAU,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,WAAW,CAAC;IACrB,WAAW,EAAE,WAAW,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqCtC,CAAC"}

package/dist/og/production-timeseries.js

@@ -0,0 +1,37 @@
+import { z } from "zod";
+import { WIDTHED_CONFIDENCE_SCHEMA } from "../read-contract/common.js";
+import { ANCHOR_KINDS, GRANULARITIES, OG_ACCESS_POLICY_SCHEMA, OG_QUALITY_GATE_FIELDS, PRODUCT_TYPES, } from "./common.js";
+export const STREAM_KINDS = ["reported", "derived-allocation"];
+export const PRODUCTION_TIMESERIES_SCHEMA = z
+    .object({
+    entityType: z.literal("production-timeseries"),
+    streamDid: z
+        .string()
+        .min(1)
+        .refine((val) => /^prodts_[0-9a-f]{16}$/.test(val), {
+        message: "streamDid must be in format prodts_<16-hex-chars>",
+    }),
+    streamKind: z.enum(STREAM_KINDS),
+    anchorKind: z.enum(ANCHOR_KINDS),
+    anchorDid: z.string().min(1),
+    product: z.enum(PRODUCT_TYPES),
+    granularity: z.enum(GRANULARITIES),
+    sourceAdapter: z.string().min(1),
+    derivationMethod: z.string().min(1).optional(),
+    derivesFromStreamDid: z.string().min(1).optional(),
+    confidence: WIDTHED_CONFIDENCE_SCHEMA.optional(),
+    ...OG_QUALITY_GATE_FIELDS,
+    accessPolicy: OG_ACCESS_POLICY_SCHEMA,
+})
+    .refine((data) => {
+    if (data.streamKind === "derived-allocation") {
+        return (data.derivationMethod !== undefined &&
+            data.confidence !== undefined &&
+            data.derivesFromStreamDid !== undefined);
+    }
+    return true;
+}, {
+    message: "Derived streams require derivationMethod, confidence, and derivesFromStreamDid",
+    path: ["streamKind"],
+});
+//# sourceMappingURL=production-timeseries.js.map

package/dist/og/production-timeseries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"production-timeseries.js","sourceRoot":"","sources":["../../src/og/production-timeseries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,yBAAyB,EAA0B,MAAM,4BAA4B,CAAC;AAC/F,OAAO,EACL,YAAY,EACZ,aAAa,EACb,uBAAuB,EACvB,sBAAsB,EACtB,aAAa,GAId,MAAM,aAAa,CAAC;AASrB,MAAM,CAAC,MAAM,YAAY,GAA8B,CAAC,UAAU,EAAE,oBAAoB,CAAC,CAAC;AA6B1F,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC;KAC1C,MAAM,CAAC;IACN,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC;IAC9C,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,uBAAuB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;QAClD,OAAO,EAAE,mDAAmD;KAC7D,CAAC;IACJ,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,YAA6C,CAAC;IACjE,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,YAA6C,CAAC;IACjE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,aAAgD,CAAC;IACjE,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,aAAgD,CAAC;IACrE,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAChC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC9C,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAClD,UAAU,EAAE,yBAAyB,CAAC,QAAQ,EAAE;IAChD,GAAG,sBAAsB;IACzB,YAAY,EAAE,uBAAuB;CACtC,CAAC;KACD,MAAM,CACL,CAAC,IAAI,EAAE,EAAE;IACP,IAAI,IAAI,CAAC,UAAU,KAAK,oBAAoB,EAAE,CAAC;QAC7C,OAAO,CACL,IAAI,CAAC,gBAAgB,KAAK,SAAS;YACnC,IAAI,CAAC,UAAU,KAAK,SAAS;YAC7B,IAAI,CAAC,oBAAoB,KAAK,SAAS,CACxC,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,EACD;IACE,OAAO,EACL,gFAAgF;IAClF,IAAI,EAAE,CAAC,YAAY,CAAC;CACrB,CACF,CAAC"}