event-contract-builder 0.1.0

package/dist/src/schema/resolution.d.ts

@@ -0,0 +1,203 @@
+import { z } from "zod";
+/**
+ * ISO 8601 date-time **with explicit offset or Z**. Naive timestamps are
+ * rejected because timezone ambiguity is a classic resolution-dispute vector.
+ */
+export declare const IsoDateTime: z.ZodString;
+/** IANA timezone identifier, e.g. `America/New_York`. */
+export declare const IanaTimezone: z.ZodString;
+/** Stable machine identifier: lowercase kebab-case. */
+export declare const Slug: z.ZodString;
+/**
+ * CNL sentence: a single declarative English sentence in the controlled
+ * vocabulary (see docs/cnl-grammar.md). Structural checks only — must start
+ * with a capital letter, end with a period, and contain no hedging terms.
+ */
+export declare const CnlSentence: z.ZodString;
+/** A measured quantity with its unit and exact measurement method. */
+export declare const Metric: z.ZodObject<{
+    name: z.ZodString;
+    unit: z.ZodString;
+    extraction: z.ZodString;
+    revisionPolicy: z.ZodEnum<{
+        "first-published-value": "first-published-value";
+        "value-as-of-observation-time": "value-as-of-observation-time";
+        "final-revised-value": "final-revised-value";
+    }>;
+}, z.core.$strip>;
+/**
+ * Structured resolution criterion: the single decision rule that determines
+ * a contract's outcome. Exactly one variant applies per `Resolution`,
+ * selected by `kind`:
+ *
+ * - `threshold` — numeric comparison against one or two bounds.
+ * - `occurrence` — whether a discrete event did or did not occur.
+ * - `bucket-membership` — which contiguous bucket the metric falls into.
+ *
+ * `Resolution.canonicalStatement` is deterministically rendered from this
+ * value (see `COMPARATOR_PHRASES` and the CNL renderer), so the criterion
+ * and the human-readable prose can never diverge.
+ */
+export declare const Criterion: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"threshold">;
+    metric: z.ZodObject<{
+        name: z.ZodString;
+        unit: z.ZodString;
+        extraction: z.ZodString;
+        revisionPolicy: z.ZodEnum<{
+            "first-published-value": "first-published-value";
+            "value-as-of-observation-time": "value-as-of-observation-time";
+            "final-revised-value": "final-revised-value";
+        }>;
+    }, z.core.$strip>;
+    comparator: z.ZodEnum<{
+        "greater-than": "greater-than";
+        "greater-than-or-equal": "greater-than-or-equal";
+        "less-than": "less-than";
+        "less-than-or-equal": "less-than-or-equal";
+        "equal-to": "equal-to";
+        "between-inclusive": "between-inclusive";
+    }>;
+    threshold: z.ZodNumber;
+    thresholdUpper: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"occurrence">;
+    comparator: z.ZodEnum<{
+        occurs: "occurs";
+        "does-not-occur": "does-not-occur";
+    }>;
+    eventClause: z.ZodString;
+    evidenceStandard: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"bucket-membership">;
+    metric: z.ZodObject<{
+        name: z.ZodString;
+        unit: z.ZodString;
+        extraction: z.ZodString;
+        revisionPolicy: z.ZodEnum<{
+            "first-published-value": "first-published-value";
+            "value-as-of-observation-time": "value-as-of-observation-time";
+            "final-revised-value": "final-revised-value";
+        }>;
+    }, z.core.$strip>;
+}, z.core.$strip>], "kind">;
+/** A resolution data source with availability characteristics. */
+export declare const DataSource: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    publisher: z.ZodString;
+    url: z.ZodURL;
+    datasetId: z.ZodOptional<z.ZodString>;
+    publicationSchedule: z.ZodString;
+    publiclyAccessible: z.ZodBoolean;
+    independenceNote: z.ZodString;
+}, z.core.$strip>;
+/** Ordered fallback with an enumerated trigger — no discretionary switching. */
+export declare const Fallback: z.ZodObject<{
+    trigger: z.ZodEnum<{
+        "primary-not-published-by-deadline": "primary-not-published-by-deadline";
+        "primary-discontinued": "primary-discontinued";
+        "primary-methodology-materially-changed": "primary-methodology-materially-changed";
+        "primary-retracted-or-corrected": "primary-retracted-or-corrected";
+    }>;
+    sourceId: z.ZodString;
+    procedure: z.ZodString;
+}, z.core.$strip>;
+/** What happens if even the fallbacks fail or the outcome is undefined. */
+export declare const TerminalAmbiguityPolicy: z.ZodEnum<{
+    "resolve-no": "resolve-no";
+    "resolve-to-floor": "resolve-to-floor";
+    "void-and-refund": "void-and-refund";
+    "exchange-determination-per-rulebook": "exchange-determination-per-rulebook";
+}>;
+export declare const Resolution: z.ZodObject<{
+    criterion: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"threshold">;
+        metric: z.ZodObject<{
+            name: z.ZodString;
+            unit: z.ZodString;
+            extraction: z.ZodString;
+            revisionPolicy: z.ZodEnum<{
+                "first-published-value": "first-published-value";
+                "value-as-of-observation-time": "value-as-of-observation-time";
+                "final-revised-value": "final-revised-value";
+            }>;
+        }, z.core.$strip>;
+        comparator: z.ZodEnum<{
+            "greater-than": "greater-than";
+            "greater-than-or-equal": "greater-than-or-equal";
+            "less-than": "less-than";
+            "less-than-or-equal": "less-than-or-equal";
+            "equal-to": "equal-to";
+            "between-inclusive": "between-inclusive";
+        }>;
+        threshold: z.ZodNumber;
+        thresholdUpper: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"occurrence">;
+        comparator: z.ZodEnum<{
+            occurs: "occurs";
+            "does-not-occur": "does-not-occur";
+        }>;
+        eventClause: z.ZodString;
+        evidenceStandard: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"bucket-membership">;
+        metric: z.ZodObject<{
+            name: z.ZodString;
+            unit: z.ZodString;
+            extraction: z.ZodString;
+            revisionPolicy: z.ZodEnum<{
+                "first-published-value": "first-published-value";
+                "value-as-of-observation-time": "value-as-of-observation-time";
+                "final-revised-value": "final-revised-value";
+            }>;
+        }, z.core.$strip>;
+    }, z.core.$strip>], "kind">;
+    canonicalStatement: z.ZodString;
+    observationWindow: z.ZodObject<{
+        start: z.ZodString;
+        end: z.ZodString;
+        timezone: z.ZodString;
+    }, z.core.$strip>;
+    sources: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        publisher: z.ZodString;
+        url: z.ZodURL;
+        datasetId: z.ZodOptional<z.ZodString>;
+        publicationSchedule: z.ZodString;
+        publiclyAccessible: z.ZodBoolean;
+        independenceNote: z.ZodString;
+    }, z.core.$strip>>;
+    primarySourceId: z.ZodString;
+    fallbacks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        trigger: z.ZodEnum<{
+            "primary-not-published-by-deadline": "primary-not-published-by-deadline";
+            "primary-discontinued": "primary-discontinued";
+            "primary-methodology-materially-changed": "primary-methodology-materially-changed";
+            "primary-retracted-or-corrected": "primary-retracted-or-corrected";
+        }>;
+        sourceId: z.ZodString;
+        procedure: z.ZodString;
+    }, z.core.$strip>>>;
+    resolutionDeadline: z.ZodString;
+    earlyResolution: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        allowed: z.ZodLiteral<false>;
+    }, z.core.$strip>, z.ZodObject<{
+        allowed: z.ZodLiteral<true>;
+        condition: z.ZodString;
+    }, z.core.$strip>], "allowed">;
+    terminalAmbiguityPolicy: z.ZodEnum<{
+        "resolve-no": "resolve-no";
+        "resolve-to-floor": "resolve-to-floor";
+        "void-and-refund": "void-and-refund";
+        "exchange-determination-per-rulebook": "exchange-determination-per-rulebook";
+    }>;
+    edgeCases: z.ZodArray<z.ZodObject<{
+        scenario: z.ZodString;
+        disposition: z.ZodString;
+    }, z.core.$strip>>;
+    disputeWindowHours: z.ZodNumber;
+}, z.core.$strip>;
+//# sourceMappingURL=resolution.d.ts.map

package/dist/src/schema/resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolution.d.ts","sourceRoot":"","sources":["../../../src/schema/resolution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;GAGG;AACH,eAAO,MAAM,WAAW,aAMmC,CAAC;AAE5D,yDAAyD;AACzD,eAAO,MAAM,YAAY,aAM6C,CAAC;AAEvE,uDAAuD;AACvD,eAAO,MAAM,IAAI,aAGoC,CAAC;AAEtD;;;;GAIG;AACH,eAAO,MAAM,WAAW,aAiBrB,CAAC;AAEJ,sEAAsE;AACtE,eAAO,MAAM,MAAM;;;;;;;;;iBAmBjB,CAAC;AA+CH;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAQnB,CAAC;AAEJ,kEAAkE;AAClE,eAAO,MAAM,UAAU;;;;;;;;;iBAkBrB,CAAC;AAEH,gFAAgF;AAChF,eAAO,MAAM,QAAQ;;;;;;;;;iBAUnB,CAAC;AAEH,2EAA2E;AAC3E,eAAO,MAAM,uBAAuB;;;;;EASjC,CAAC;AAEJ,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoGnB,CAAC"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "event-contract-builder",
+  "version": "0.1.0",
+  "description": "A TypeScript library, CLI, and MCP server for generating, validating, and converting YAML/JSON event contract specifications for prediction markets.",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./src": {
+      "types": "./dist/src/index.d.ts",
+      "default": "./dist/src/index.js"
+    },
+    "./cnl": {
+      "types": "./dist/src/cnl.d.ts",
+      "default": "./dist/src/cnl.js"
+    },
+    "./schema": {
+      "types": "./dist/src/schema/event-contract.d.ts",
+      "default": "./dist/src/schema/event-contract.js"
+    }
+  },
+  "license": "Apache-2.0",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "NOTICE",
+    "DISCLAIMER.md"
+  ],
+  "scripts": {
+    "build": "bun build ./index.ts ./src/index.ts ./src/cnl.ts ./src/schema/event-contract.ts --outdir ./dist --target node --format esm --external zod && tsc -p tsconfig.build.json",
+    "test": "bun run build && bun test"
+  },
+  "author": "Christopher Maximilian Altmann",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Chralt98/event-contract-builder.git"
+  },
+  "homepage": "https://github.com/Chralt98/event-contract-builder#readme",
+  "bugs": {
+    "url": "https://github.com/Chralt98/event-contract-builder/issues"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@types/node": "^25.9.3"
+  },
+  "peerDependencies": {
+    "typescript": "^6.0.3"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "yaml": "^2.9.0",
+    "zod": "^4.4.3"
+  }
+}