@mapletip/data 0.1.0

package/generated/quest-evidence-pack-2.d.ts

@@ -0,0 +1,269 @@
+/* Generated automatically from Rust-owned wire definitions. Do not edit. */
+
+/**
+ * Shared collection state. `Known` is non-empty; absence requires complete
+ * source coverage and is never inferred from a missing row.
+ */
+export type CollectionState =
+  | {
+      items: NonEmptyVec_QuestEvidenceOccurrence;
+      state: "known";
+    }
+  | {
+      coverageKey: CoverageKey;
+      state: "absent";
+    }
+  | {
+      items: QuestEvidenceOccurrence[];
+      reason: StateReason;
+      state: "partial";
+    }
+  | {
+      reason: StateReason;
+      state: "unknown";
+    }
+  | {
+      capability: Capability;
+      state: "unsupported";
+    };
+/**
+ * @minItems 1
+ */
+export type NonEmptyVec_QuestEvidenceOccurrence = [QuestEvidenceOccurrence, ...QuestEvidenceOccurrence[]];
+/**
+ * Shared collection state. `Known` is non-empty; absence requires complete
+ * source coverage and is never inferred from a missing row.
+ */
+export type CollectionState2 =
+  | {
+      items: NonEmptyVecString;
+      state: "known";
+    }
+  | {
+      coverageKey: CoverageKey;
+      state: "absent";
+    }
+  | {
+      items: string[];
+      reason: StateReason;
+      state: "partial";
+    }
+  | {
+      reason: StateReason;
+      state: "unknown";
+    }
+  | {
+      capability: Capability;
+      state: "unsupported";
+    };
+/**
+ * @minItems 1
+ */
+export type NonEmptyVecString = [string, ...string[]];
+export type CoverageKey = string;
+export type StateReason = string;
+export type Capability = string;
+/**
+ * Shared fact state. SQL NULL is represented by `Unknown` with reason
+ * `source-null`; only `Absent` carries a complete-coverage witness.
+ */
+export type FactState =
+  | {
+      source?: SourceRef | null;
+      state: "known";
+      value: string;
+    }
+  | {
+      reason: StateReason;
+      source?: SourceRef | null;
+      state: "unknown";
+    }
+  | {
+      coverageKey: CoverageKey;
+      state: "absent";
+    }
+  | {
+      capability: Capability;
+      source?: SourceRef | null;
+      state: "unsupported";
+    };
+export type LogicalSourceAddress = string;
+/**
+ * Shared collection state. `Known` is non-empty; absence requires complete
+ * source coverage and is never inferred from a missing row.
+ */
+export type CollectionState3 =
+  | {
+      items: NonEmptyVec_QuestEvidenceLink;
+      state: "known";
+    }
+  | {
+      coverageKey: CoverageKey;
+      state: "absent";
+    }
+  | {
+      items: QuestEvidenceLink[];
+      reason: StateReason;
+      state: "partial";
+    }
+  | {
+      reason: StateReason;
+      state: "unknown";
+    }
+  | {
+      capability: Capability;
+      state: "unsupported";
+    };
+/**
+ * @minItems 1
+ */
+export type NonEmptyVec_QuestEvidenceLink = [QuestEvidenceLink, ...QuestEvidenceLink[]];
+/**
+ * Shared fact state. SQL NULL is represented by `Unknown` with reason
+ * `source-null`; only `Absent` carries a complete-coverage witness.
+ */
+export type FactState2 =
+  | {
+      source?: SourceRef | null;
+      state: "known";
+      value: RawValue;
+    }
+  | {
+      reason: StateReason;
+      source?: SourceRef | null;
+      state: "unknown";
+    }
+  | {
+      coverageKey: CoverageKey;
+      state: "absent";
+    }
+  | {
+      capability: Capability;
+      source?: SourceRef | null;
+      state: "unsupported";
+    };
+/**
+ * A scalar source observation that preserves the source value kind.
+ */
+export type RawScalar =
+  | {
+      kind: "integer";
+      value: SafeInt64;
+    }
+  | {
+      kind: "real";
+      value: number;
+    }
+  | {
+      kind: "text";
+      value: string;
+    }
+  | {
+      kind: "boolean";
+      value: boolean;
+    }
+  | {
+      kind: "bytes";
+      value: number[];
+    }
+  | {
+      kind: "source-null";
+    };
+export type SafeInt64 = number;
+
+/**
+ * Bounded pack of Quest evidence pages keyed by stable page key.
+ */
+export interface QuestEvidencePack {
+  contractVersion: "2.0";
+  format: "mapletip.quest-evidence-pack-2";
+  records: {
+    [k: string]: QuestEvidencePage | undefined;
+  };
+  scope: BuildScope;
+}
+/**
+ * Lazy evidence page for a Quest or Quest-owned relationship.
+ */
+export interface QuestEvidencePage {
+  occurrences: CollectionState;
+  recordKey: string;
+}
+/**
+ * Evidence occurrence for a source-backed Quest fact.
+ */
+export interface QuestEvidenceOccurrence {
+  authorityReference: CollectionState2;
+  confidence: FactState;
+  fieldName: string;
+  links: CollectionState3;
+  logicalAddress: LogicalSourceAddress;
+  occurrenceKey: string;
+  /**
+   * Shared fact state. SQL NULL is represented by `Unknown` with reason
+   * `source-null`; only `Absent` carries a complete-coverage witness.
+   */
+  sourceLayout:
+    | {
+        source?: SourceRef | null;
+        state: "known";
+        value: string;
+      }
+    | {
+        reason: StateReason;
+        source?: SourceRef | null;
+        state: "unknown";
+      }
+    | {
+        coverageKey: CoverageKey;
+        state: "absent";
+      }
+    | {
+        capability: Capability;
+        source?: SourceRef | null;
+        state: "unsupported";
+      };
+  sourceValue: FactState2;
+  transform: FactState;
+}
+/**
+ * Source attribution for a fact or raw observation.
+ */
+export interface SourceRef {
+  /**
+   * Optional logical address within the source; never a local file path.
+   */
+  logicalAddress?: LogicalSourceAddress | null;
+  /**
+   * Source family or source kind, preserved as supplied by the producer.
+   */
+  sourceKind: string;
+}
+/**
+ * Evidence link to an exact-build public Quest record or page.
+ */
+export interface QuestEvidenceLink {
+  recordKey: string;
+  relation: string;
+}
+/**
+ * A raw value and its optional source attribution.
+ */
+export interface RawValue {
+  scalar: RawScalar;
+  source?: SourceRef | null;
+}
+/**
+ * Build scope specifying the game family and concrete build identity.
+ */
+export interface BuildScope {
+  /**
+   * Exact build identity (e.g., 'gms-v83', 'cw-cot2').
+   */
+  build_id: string;
+  /**
+   * Family identity (e.g., 'gms', 'classic-world').
+   */
+  family_id: string;
+  [k: string]: unknown | undefined;
+}