@smthrs/run-store 0.0.0-stage → 1.0.0-rc.3

package/dist/cjs/index.js

@@ -0,0 +1,43 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var index_exports = {};
+__export(index_exports, {
+  AttemptStore: () => AttemptStore,
+  Migrations: () => Migrations,
+  Ownership: () => Ownership,
+  RunStore: () => RunStore,
+  RunStoreMetrics: () => RunStoreMetrics
+});
+module.exports = __toCommonJS(index_exports);
+var RunStore = __toESM(require("./RunStore.js"), 1);
+var RunStoreMetrics = __toESM(require("./RunStoreMetrics.js"), 1);
+var Ownership = __toESM(require("./Ownership.js"), 1);
+var AttemptStore = __toESM(require("./AttemptStore.js"), 1);
+var Migrations = __toESM(require("./Migrations.js"), 1);
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/index.ts"],
+  "sourcesContent": ["/**\n * Durable run state: what is running now, and who owns it.\n *\n * `RunStore` and `AttemptStore` hold the executable authoritative state that\n * recovery reads; `Ownership` supplies the liveness evidence and heartbeat\n * supervision that arbitrate it. The fencing token they trade in, `OwnerId`,\n * is defined by `@smthrs/journal`, because the journal is what it fences, and\n * is re-exported from `Ownership` here, so importing it needs no second\n * package.\n *\n * This entry point is browser-bundleable: every service here is written\n * against the driver-neutral `@smthrs/database` contract. The test double,\n * which binds a Node SQLite database, lives under an explicit subpath:\n *\n * ```ts\n * import { AttemptStore, Ownership, RunStore } from \"@smthrs/run-store\"\n * import * as TestRunStore from \"@smthrs/run-store/test/TestRunStore\"\n * ```\n *\n * @since 0.1.0\n */\n\n/**\n * @category services\n * @since 0.1.0\n */\nexport * as RunStore from \"./RunStore.ts\"\n\n/**\n * @category metrics\n * @since 0.1.0\n */\nexport * as RunStoreMetrics from \"./RunStoreMetrics.ts\"\n\n/**\n * @category ownership\n * @since 0.1.0\n */\nexport * as Ownership from \"./Ownership.ts\"\n\n/**\n * @category services\n * @since 0.1.0\n */\nexport * as AttemptStore from \"./AttemptStore.ts\"\n\n/**\n * @category migrations\n * @since 0.1.0\n */\nexport * as Migrations from \"./Migrations.ts\"\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA0BA,eAA0B;AAM1B,sBAAiC;AAMjC,gBAA2B;AAM3B,mBAA8B;AAM9B,iBAA4B;",
+  "names": []
+}

package/dist/cjs/internal/Boundary.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Inert text and JSON admission for values crossing run-store boundaries.
+ *
+ * @since 1.0.0-rc.0
+ * @private
+ */
+import * as BoundedJson from "@smthrs/canonical/BoundedJson";
+/**
+ * Maximum UTF-16 length of one durable identifier.
+ *
+ * @since 1.0.0-rc.0
+ * @private
+ */
+export declare const maximumIdentifierLength = 1024;
+/**
+ * Resource limits for one admitted JSON tree.
+ *
+ * @since 1.0.0-rc.0
+ * @private
+ */
+export type JsonLimits = Omit<BoundedJson.Limits, "maxTotalMembers">;
+/**
+ * Detached JSON value accepted by the persistence boundary.
+ *
+ * @since 1.0.0-rc.0
+ * @private
+ */
+export type Json = BoundedJson.Json;
+/**
+ * Compares admitted JSON trees while ignoring object key order.
+ *
+ * Array order remains significant. `undefined` represents an absent optional
+ * tree and equals only `undefined`.
+ *
+ * @since 1.0.0-rc.0
+ * @private
+ */
+export declare const sameJson: (left: Json | undefined, right: Json | undefined) => boolean;
+/**
+ * Result of admitting or refusing an unknown JSON candidate.
+ *
+ * @since 1.0.0-rc.0
+ * @private
+ */
+export type JsonResult = {
+    readonly ok: true;
+    readonly value: Json;
+    readonly bytes: number;
+} | {
+    readonly ok: false;
+    readonly complaint: string;
+};
+/**
+ * Whether text has a complete UTF-16 encoding and contains no NUL.
+ *
+ * @since 1.0.0-rc.0
+ * @private
+ */
+export declare const isDurableText: (value: unknown, maximum?: number) => value is string;
+/**
+ * Copies an inert JSON tree with a cumulative member budget for run state.
+ * @private
+ * @since 1.0.0
+ */
+export declare const admitJson: (input: unknown, limits: JsonLimits) => JsonResult;
+/**
+ * Parses and bounds JSON text while preserving the caller's original bytes.
+ *
+ * @since 1.0.0-rc.0
+ * @private
+ */
+export declare const admitJsonText: (input: unknown, limits: JsonLimits) => {
+    readonly ok: true;
+    readonly value: string;
+    readonly json: Json;
+} | {
+    readonly ok: false;
+    readonly complaint: string;
+};
+//# sourceMappingURL=Boundary.d.ts.map

package/dist/cjs/internal/Boundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Boundary.d.ts","sourceRoot":"","sources":["../../../src/internal/Boundary.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,WAAW,MAAM,+BAA+B,CAAA;AAE5D;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,OAAQ,CAAA;AAE5C;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAA;AAEpE;;;;;GAKG;AACH,MAAM,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAA;AAEnC;;;;;;;;GAQG;AACH,eAAO,MAAM,QAAQ,GAAI,MAAM,IAAI,GAAG,SAAS,EAAE,OAAO,IAAI,GAAG,SAAS,KAAG,OAqB1E,CAAA;AAED;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAClB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACnE;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAA;AAEtD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,OAAO,EAAE,gBAAiC,KAAG,KAAK,IAAI,MAU1F,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,OAAO,EAAE,QAAQ,UAAU,KAAG,UAG9D,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GACxB,OAAO,OAAO,EACd,QAAQ,UAAU,KAEhB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;CAAE,GAClE;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAenD,CAAA"}

package/dist/cjs/internal/Boundary.js

@@ -0,0 +1,92 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var Boundary_exports = {};
+__export(Boundary_exports, {
+  admitJson: () => admitJson,
+  admitJsonText: () => admitJsonText,
+  isDurableText: () => isDurableText,
+  maximumIdentifierLength: () => maximumIdentifierLength,
+  sameJson: () => sameJson
+});
+module.exports = __toCommonJS(Boundary_exports);
+var BoundedJson = __toESM(require("@smthrs/canonical/BoundedJson"), 1);
+const maximumIdentifierLength = 1024;
+const sameJson = (left, right) => {
+  if (left === right) return true;
+  if (left === void 0 || right === void 0) return false;
+  if (left === null || right === null) return false;
+  if (typeof left !== "object" || typeof right !== "object") return false;
+  if (Array.isArray(left)) {
+    if (!Array.isArray(right) || left.length !== right.length) return false;
+    for (let index = 0; index < left.length; index++) {
+      if (!sameJson(left[index], right[index])) return false;
+    }
+    return true;
+  }
+  if (Array.isArray(right)) return false;
+  const leftObject = left;
+  const rightObject = right;
+  const leftKeys = Object.keys(leftObject);
+  if (leftKeys.length !== Object.keys(rightObject).length) return false;
+  for (const key of leftKeys) {
+    if (!Object.hasOwn(rightObject, key) || !sameJson(leftObject[key], rightObject[key])) return false;
+  }
+  return true;
+};
+const isDurableText = (value, maximum = maximumIdentifierLength) => {
+  if (typeof value !== "string" || value.length === 0 || value.length > maximum || value.includes("\0")) return false;
+  for (let index = 0; index < value.length; index++) {
+    const unit = value.charCodeAt(index);
+    if (unit >= 55296 && unit <= 56319) {
+      const low = value.charCodeAt(++index);
+      if (!(low >= 56320 && low <= 57343)) return false;
+    } else if (unit >= 56320 && unit <= 57343) return false;
+  }
+  return true;
+};
+const admitJson = (input, limits) => {
+  const result = BoundedJson.admit(input, { ...limits, maxTotalMembers: limits.maxMembers });
+  return result.ok ? result : { ok: false, complaint: result.complaint };
+};
+const admitJsonText = (input, limits) => {
+  if (typeof input !== "string" || input.length === 0) return { ok: false, complaint: "must be non-empty JSON text" };
+  let parsed;
+  try {
+    parsed = JSON.parse(input);
+  } catch {
+    return { ok: false, complaint: "must be valid JSON text" };
+  }
+  const admitted = admitJson(parsed, limits);
+  if (!admitted.ok) return admitted;
+  if (limits.maxBytes !== void 0 && new TextEncoder().encode(input).byteLength > limits.maxBytes) {
+    return { ok: false, complaint: "exceeds the JSON byte limit" };
+  }
+  return { ok: true, value: input, json: admitted.value };
+};
+//# sourceMappingURL=Boundary.js.map

package/dist/cjs/internal/Boundary.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/internal/Boundary.ts"],
+  "sourcesContent": ["/**\n * Inert text and JSON admission for values crossing run-store boundaries.\n *\n * @since 1.0.0-rc.0\n * @private\n */\n\nimport * as BoundedJson from \"@smthrs/canonical/BoundedJson\"\n\n/**\n * Maximum UTF-16 length of one durable identifier.\n *\n * @since 1.0.0-rc.0\n * @private\n */\nexport const maximumIdentifierLength = 1_024\n\n/**\n * Resource limits for one admitted JSON tree.\n *\n * @since 1.0.0-rc.0\n * @private\n */\nexport type JsonLimits = Omit<BoundedJson.Limits, \"maxTotalMembers\">\n\n/**\n * Detached JSON value accepted by the persistence boundary.\n *\n * @since 1.0.0-rc.0\n * @private\n */\nexport type Json = BoundedJson.Json\n\n/**\n * Compares admitted JSON trees while ignoring object key order.\n *\n * Array order remains significant. `undefined` represents an absent optional\n * tree and equals only `undefined`.\n *\n * @since 1.0.0-rc.0\n * @private\n */\nexport const sameJson = (left: Json | undefined, right: Json | undefined): boolean => {\n  if (left === right) return true\n  if (left === undefined || right === undefined) return false\n  if (left === null || right === null) return false\n  if (typeof left !== \"object\" || typeof right !== \"object\") return false\n  if (Array.isArray(left)) {\n    if (!Array.isArray(right) || left.length !== right.length) return false\n    for (let index = 0; index < left.length; index++) {\n      if (!sameJson(left[index], right[index])) return false\n    }\n    return true\n  }\n  if (Array.isArray(right)) return false\n  const leftObject = left as { readonly [key: string]: Json }\n  const rightObject = right as { readonly [key: string]: Json }\n  const leftKeys = Object.keys(leftObject)\n  if (leftKeys.length !== Object.keys(rightObject).length) return false\n  for (const key of leftKeys) {\n    if (!Object.hasOwn(rightObject, key) || !sameJson(leftObject[key], rightObject[key])) return false\n  }\n  return true\n}\n\n/**\n * Result of admitting or refusing an unknown JSON candidate.\n *\n * @since 1.0.0-rc.0\n * @private\n */\nexport type JsonResult =\n  | { readonly ok: true; readonly value: Json; readonly bytes: number }\n  | { readonly ok: false; readonly complaint: string }\n\n/**\n * Whether text has a complete UTF-16 encoding and contains no NUL.\n *\n * @since 1.0.0-rc.0\n * @private\n */\nexport const isDurableText = (value: unknown, maximum = maximumIdentifierLength): value is string => {\n  if (typeof value !== \"string\" || value.length === 0 || value.length > maximum || value.includes(\"\\0\")) return false\n  for (let index = 0; index < value.length; index++) {\n    const unit = value.charCodeAt(index)\n    if (unit >= 0xd800 && unit <= 0xdbff) {\n      const low = value.charCodeAt(++index)\n      if (!(low >= 0xdc00 && low <= 0xdfff)) return false\n    } else if (unit >= 0xdc00 && unit <= 0xdfff) return false\n  }\n  return true\n}\n\n/**\n * Copies an inert JSON tree with a cumulative member budget for run state.\n * @private\n * @since 1.0.0\n */\nexport const admitJson = (input: unknown, limits: JsonLimits): JsonResult => {\n  const result = BoundedJson.admit(input, { ...limits, maxTotalMembers: limits.maxMembers })\n  return result.ok ? result : { ok: false, complaint: result.complaint }\n}\n\n/**\n * Parses and bounds JSON text while preserving the caller's original bytes.\n *\n * @since 1.0.0-rc.0\n * @private\n */\nexport const admitJsonText = (\n  input: unknown,\n  limits: JsonLimits\n):\n  | { readonly ok: true; readonly value: string; readonly json: Json }\n  | { readonly ok: false; readonly complaint: string } =>\n{\n  if (typeof input !== \"string\" || input.length === 0) return { ok: false, complaint: \"must be non-empty JSON text\" }\n  let parsed: unknown\n  try {\n    parsed = JSON.parse(input) as unknown\n  } catch {\n    return { ok: false, complaint: \"must be valid JSON text\" }\n  }\n  const admitted = admitJson(parsed, limits)\n  if (!admitted.ok) return admitted\n  if (limits.maxBytes !== undefined && new TextEncoder().encode(input).byteLength > limits.maxBytes) {\n    return { ok: false, complaint: \"exceeds the JSON byte limit\" }\n  }\n  return { ok: true, value: input, json: admitted.value }\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAOA,kBAA6B;AAQtB,MAAM,0BAA0B;AA2BhC,MAAM,WAAW,CAAC,MAAwB,UAAqC;AACpF,MAAI,SAAS,MAAO,QAAO;AAC3B,MAAI,SAAS,UAAa,UAAU,OAAW,QAAO;AACtD,MAAI,SAAS,QAAQ,UAAU,KAAM,QAAO;AAC5C,MAAI,OAAO,SAAS,YAAY,OAAO,UAAU,SAAU,QAAO;AAClE,MAAI,MAAM,QAAQ,IAAI,GAAG;AACvB,QAAI,CAAC,MAAM,QAAQ,KAAK,KAAK,KAAK,WAAW,MAAM,OAAQ,QAAO;AAClE,aAAS,QAAQ,GAAG,QAAQ,KAAK,QAAQ,SAAS;AAChD,UAAI,CAAC,SAAS,KAAK,KAAK,GAAG,MAAM,KAAK,CAAC,EAAG,QAAO;AAAA,IACnD;AACA,WAAO;AAAA,EACT;AACA,MAAI,MAAM,QAAQ,KAAK,EAAG,QAAO;AACjC,QAAM,aAAa;AACnB,QAAM,cAAc;AACpB,QAAM,WAAW,OAAO,KAAK,UAAU;AACvC,MAAI,SAAS,WAAW,OAAO,KAAK,WAAW,EAAE,OAAQ,QAAO;AAChE,aAAW,OAAO,UAAU;AAC1B,QAAI,CAAC,OAAO,OAAO,aAAa,GAAG,KAAK,CAAC,SAAS,WAAW,GAAG,GAAG,YAAY,GAAG,CAAC,EAAG,QAAO;AAAA,EAC/F;AACA,SAAO;AACT;AAkBO,MAAM,gBAAgB,CAAC,OAAgB,UAAU,4BAA6C;AACnG,MAAI,OAAO,UAAU,YAAY,MAAM,WAAW,KAAK,MAAM,SAAS,WAAW,MAAM,SAAS,IAAI,EAAG,QAAO;AAC9G,WAAS,QAAQ,GAAG,QAAQ,MAAM,QAAQ,SAAS;AACjD,UAAM,OAAO,MAAM,WAAW,KAAK;AACnC,QAAI,QAAQ,SAAU,QAAQ,OAAQ;AACpC,YAAM,MAAM,MAAM,WAAW,EAAE,KAAK;AACpC,UAAI,EAAE,OAAO,SAAU,OAAO,OAAS,QAAO;AAAA,IAChD,WAAW,QAAQ,SAAU,QAAQ,MAAQ,QAAO;AAAA,EACtD;AACA,SAAO;AACT;AAOO,MAAM,YAAY,CAAC,OAAgB,WAAmC;AAC3E,QAAM,SAAS,YAAY,MAAM,OAAO,EAAE,GAAG,QAAQ,iBAAiB,OAAO,WAAW,CAAC;AACzF,SAAO,OAAO,KAAK,SAAS,EAAE,IAAI,OAAO,WAAW,OAAO,UAAU;AACvE;AAQO,MAAM,gBAAgB,CAC3B,OACA,WAIF;AACE,MAAI,OAAO,UAAU,YAAY,MAAM,WAAW,EAAG,QAAO,EAAE,IAAI,OAAO,WAAW,8BAA8B;AAClH,MAAI;AACJ,MAAI;AACF,aAAS,KAAK,MAAM,KAAK;AAAA,EAC3B,QAAQ;AACN,WAAO,EAAE,IAAI,OAAO,WAAW,0BAA0B;AAAA,EAC3D;AACA,QAAM,WAAW,UAAU,QAAQ,MAAM;AACzC,MAAI,CAAC,SAAS,GAAI,QAAO;AACzB,MAAI,OAAO,aAAa,UAAa,IAAI,YAAY,EAAE,OAAO,KAAK,EAAE,aAAa,OAAO,UAAU;AACjG,WAAO,EAAE,IAAI,OAAO,WAAW,8BAA8B;AAAA,EAC/D;AACA,SAAO,EAAE,IAAI,MAAM,OAAO,OAAO,MAAM,SAAS,MAAM;AACxD;",
+  "names": []
+}

package/dist/cjs/internal/Companion.d.ts

@@ -0,0 +1,44 @@
+/**
+ * The run store's companion journal stream.
+ *
+ * Facts the run store records about a run go to the run's `run-store`
+ * companion stream (`JournalEvent.companionRunId`), never to the run's own
+ * stream: engine, control, and time-travel consumers read that stream by
+ * position, and a rewind or compaction of it must not truncate a store fact.
+ *
+ * @since 1.0.0
+ * @private
+ */
+import { type JournalError } from "@smthrs/journal/Journal";
+import { Effect } from "effect";
+/**
+ * The companion stream name.
+ *
+ * @since 1.0.0
+ * @private
+ */
+export declare const stream = "run-store";
+/**
+ * The producer every run-store fact is appended under.
+ *
+ * @since 1.0.0
+ * @private
+ */
+export declare const sourceId = "flows.run-store";
+/**
+ * Appends one fact to the run's companion stream through the journal in the
+ * caller's context.
+ *
+ * The journal is resolved at call time: the ordinary composition builds the
+ * store beside the journal (`Layer.mergeAll(SqlJournal.layer(...),
+ * RunStore.layer)`), so the journal reaches the store only through the
+ * caller's context. A caller running without a journal records nothing. The
+ * append is unfenced — the store arbitrated the change in the same serialized
+ * transaction — and joins that transaction as a savepoint, so a rolled-back
+ * change leaves no fact.
+ *
+ * @since 1.0.0
+ * @private
+ */
+export declare const append: (runId: string, eventType: string, payload: Readonly<Record<string, unknown>>) => Effect.Effect<void, JournalError>;
+//# sourceMappingURL=Companion.d.ts.map

package/dist/cjs/internal/Companion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Companion.d.ts","sourceRoot":"","sources":["../../../src/internal/Companion.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAW,KAAK,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAEpE,OAAO,EAAE,MAAM,EAAU,MAAM,QAAQ,CAAA;AAEvC;;;;;GAKG;AACH,eAAO,MAAM,MAAM,cAAc,CAAA;AAEjC;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,oBAAoB,CAAA;AAEzC;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,MAAM,GACjB,OAAO,MAAM,EACb,WAAW,MAAM,EACjB,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KACzC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,YAAY,CAYP,CAAA"}

package/dist/cjs/internal/Companion.js

@@ -0,0 +1,50 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var Companion_exports = {};
+__export(Companion_exports, {
+  append: () => append,
+  sourceId: () => sourceId,
+  stream: () => stream
+});
+module.exports = __toCommonJS(Companion_exports);
+var import_Journal = require("@smthrs/journal/Journal");
+var JournalEvent = __toESM(require("@smthrs/journal/JournalEvent"), 1);
+var import_effect = require("effect");
+const stream = "run-store";
+const sourceId = "flows.run-store";
+const append = (runId, eventType, payload) => import_effect.Effect.flatMap(import_effect.Effect.serviceOption(import_Journal.Journal), (journal) => import_effect.Option.isNone(journal) ? import_effect.Effect.void : journal.value.emitDurableUnfenced(
+  new JournalEvent.Input({
+    runId: JournalEvent.companionRunId(stream, runId),
+    sourceId,
+    eventType,
+    payload: { runId, ...payload },
+    meta: { runId }
+  })
+).pipe(import_effect.Effect.asVoid));
+//# sourceMappingURL=Companion.js.map

package/dist/cjs/internal/Companion.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/internal/Companion.ts"],
+  "sourcesContent": ["/**\n * The run store's companion journal stream.\n *\n * Facts the run store records about a run go to the run's `run-store`\n * companion stream (`JournalEvent.companionRunId`), never to the run's own\n * stream: engine, control, and time-travel consumers read that stream by\n * position, and a rewind or compaction of it must not truncate a store fact.\n *\n * @since 1.0.0\n * @private\n */\n\nimport { Journal, type JournalError } from \"@smthrs/journal/Journal\"\nimport * as JournalEvent from \"@smthrs/journal/JournalEvent\"\nimport { Effect, Option } from \"effect\"\n\n/**\n * The companion stream name.\n *\n * @since 1.0.0\n * @private\n */\nexport const stream = \"run-store\"\n\n/**\n * The producer every run-store fact is appended under.\n *\n * @since 1.0.0\n * @private\n */\nexport const sourceId = \"flows.run-store\"\n\n/**\n * Appends one fact to the run's companion stream through the journal in the\n * caller's context.\n *\n * The journal is resolved at call time: the ordinary composition builds the\n * store beside the journal (`Layer.mergeAll(SqlJournal.layer(...),\n * RunStore.layer)`), so the journal reaches the store only through the\n * caller's context. A caller running without a journal records nothing. The\n * append is unfenced \u2014 the store arbitrated the change in the same serialized\n * transaction \u2014 and joins that transaction as a savepoint, so a rolled-back\n * change leaves no fact.\n *\n * @since 1.0.0\n * @private\n */\nexport const append = (\n  runId: string,\n  eventType: string,\n  payload: Readonly<Record<string, unknown>>\n): Effect.Effect<void, JournalError> =>\n  Effect.flatMap(Effect.serviceOption(Journal), (journal) =>\n    Option.isNone(journal)\n      ? Effect.void\n      : journal.value.emitDurableUnfenced(\n        new JournalEvent.Input({\n          runId: JournalEvent.companionRunId(stream, runId),\n          sourceId: sourceId as JournalEvent.SourceId,\n          eventType,\n          payload: { runId, ...payload },\n          meta: { runId }\n        })\n      ).pipe(Effect.asVoid))\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAYA,qBAA2C;AAC3C,mBAA8B;AAC9B,oBAA+B;AAQxB,MAAM,SAAS;AAQf,MAAM,WAAW;AAiBjB,MAAM,SAAS,CACpB,OACA,WACA,YAEA,qBAAO,QAAQ,qBAAO,cAAc,sBAAO,GAAG,CAAC,YAC7C,qBAAO,OAAO,OAAO,IACjB,qBAAO,OACP,QAAQ,MAAM;AAAA,EACd,IAAI,aAAa,MAAM;AAAA,IACrB,OAAO,aAAa,eAAe,QAAQ,KAAK;AAAA,IAChD;AAAA,IACA;AAAA,IACA,SAAS,EAAE,OAAO,GAAG,QAAQ;AAAA,IAC7B,MAAM,EAAE,MAAM;AAAA,EAChB,CAAC;AACH,EAAE,KAAK,qBAAO,MAAM,CAAC;",
+  "names": []
+}

package/dist/cjs/internal/SpanOutcome.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Closes every store operation span with an `outcome` attribute, so a trace
+ * viewer never sees a span that ended without saying how. `RunStore` and
+ * `AttemptStore` share these observers so the guide can describe one rule.
+ *
+ * @since 1.0.0-rc.0
+ * @private
+ */
+import * as Effect from "effect/Effect";
+import * as Metric from "effect/Metric";
+/**
+ * Observes a store operation's exit onto its span, and, when the operation
+ * has an outcome-keyed counter, updates it in the same observation: the
+ * domain tag (`claimed`, `fence_lost`) on success, `failure` or `interrupt`
+ * otherwise, so a span never closes without saying how and a failed write
+ * still lands in the counter. `exitMetric` is the counter view carrying every
+ * attribute but `outcome`, which this observer adds for a non-success exit.
+ * `Effect.onExit` only reads the exit; the value, cause, and interruption
+ * propagate byte-identically.
+ *
+ * @since 1.0.0-rc.0
+ * @private
+ */
+export declare const observeOutcome: <A extends {
+    readonly _tag: string;
+}>(metricOf?: ((outcome: A) => Metric.Metric<number, Metric.CounterState<number>>) | undefined, exitMetric?: Metric.Metric<number, Metric.CounterState<number>> | undefined) => <E, R>(effect: Effect.Effect<A, E, R>) => Effect.Effect<A, E, R>;
+/**
+ * `observeOutcome` for operations whose success carries no domain outcome
+ * tag: `create` inserts or fails, `get` returns the row or fails, and
+ * `acknowledgeCancel` reports whether the guarded update matched. The span
+ * still closes with `success`, `failure`, or `interrupt`.
+ *
+ * @since 1.0.0-rc.0
+ * @private
+ */
+export declare const observeExit: <A, E, R>(effect: Effect.Effect<A, E, R>) => Effect.Effect<A, E, R>;
+//# sourceMappingURL=SpanOutcome.d.ts.map

package/dist/cjs/internal/SpanOutcome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpanOutcome.d.ts","sourceRoot":"","sources":["../../../src/internal/SpanOutcome.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AASvC;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAChE,WAAW,CAAC,CAAC,OAAO,EAAE,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,SAAS,EAC3F,aAAa,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,GAAG,SAAS,MAE5E,CAAC,EAAE,CAAC,EAAE,QAAQ,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAG,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAe1D,CAAA;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,QAAQ,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAG,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAOxF,CAAA"}

package/dist/cjs/internal/SpanOutcome.js

@@ -0,0 +1,62 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var SpanOutcome_exports = {};
+__export(SpanOutcome_exports, {
+  observeExit: () => observeExit,
+  observeOutcome: () => observeOutcome
+});
+module.exports = __toCommonJS(SpanOutcome_exports);
+var Cause = __toESM(require("effect/Cause"), 1);
+var Effect = __toESM(require("effect/Effect"), 1);
+var Metric = __toESM(require("effect/Metric"), 1);
+const outcomeValue = (tag) => tag.replace(/(?<=[a-z0-9])(?=[A-Z])/g, "_").toLowerCase();
+const causeOutcome = (cause) => Cause.hasInterruptsOnly(cause) ? "interrupt" : "failure";
+const observeOutcome = (metricOf, exitMetric) => (effect) => effect.pipe(
+  Effect.onExit((exit) => {
+    if (exit._tag === "Success") {
+      return Effect.annotateCurrentSpan({ outcome: outcomeValue(exit.value._tag) }).pipe(
+        Effect.andThen(metricOf === void 0 ? Effect.void : Metric.update(metricOf(exit.value), 1))
+      );
+    }
+    const outcome = causeOutcome(exit.cause);
+    return Effect.annotateCurrentSpan({ outcome }).pipe(
+      Effect.andThen(
+        exitMetric === void 0 ? Effect.void : Metric.update(Metric.withAttributes(exitMetric, { outcome }), 1)
+      )
+    );
+  })
+);
+const observeExit = (effect) => effect.pipe(
+  Effect.onExit(
+    (exit) => Effect.annotateCurrentSpan({
+      outcome: exit._tag === "Success" ? "success" : causeOutcome(exit.cause)
+    })
+  )
+);
+//# sourceMappingURL=SpanOutcome.js.map

package/dist/cjs/internal/SpanOutcome.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/internal/SpanOutcome.ts"],
+  "sourcesContent": ["/**\n * Closes every store operation span with an `outcome` attribute, so a trace\n * viewer never sees a span that ended without saying how. `RunStore` and\n * `AttemptStore` share these observers so the guide can describe one rule.\n *\n * @since 1.0.0-rc.0\n * @private\n */\n\nimport * as Cause from \"effect/Cause\"\nimport * as Effect from \"effect/Effect\"\nimport * as Metric from \"effect/Metric\"\n\n/** Maps a PascalCase outcome tag to its snake_case span attribute. */\nconst outcomeValue = (tag: string): string => tag.replace(/(?<=[a-z0-9])(?=[A-Z])/g, \"_\").toLowerCase()\n\n/** Classifies a non-success exit for the span `outcome` attribute. */\nconst causeOutcome = <E>(cause: Cause.Cause<E>): \"failure\" | \"interrupt\" =>\n  Cause.hasInterruptsOnly(cause) ? \"interrupt\" : \"failure\"\n\n/**\n * Observes a store operation's exit onto its span, and, when the operation\n * has an outcome-keyed counter, updates it in the same observation: the\n * domain tag (`claimed`, `fence_lost`) on success, `failure` or `interrupt`\n * otherwise, so a span never closes without saying how and a failed write\n * still lands in the counter. `exitMetric` is the counter view carrying every\n * attribute but `outcome`, which this observer adds for a non-success exit.\n * `Effect.onExit` only reads the exit; the value, cause, and interruption\n * propagate byte-identically.\n *\n * @since 1.0.0-rc.0\n * @private\n */\nexport const observeOutcome = <A extends { readonly _tag: string }>(\n  metricOf?: ((outcome: A) => Metric.Metric<number, Metric.CounterState<number>>) | undefined,\n  exitMetric?: Metric.Metric<number, Metric.CounterState<number>> | undefined\n) =>\n<E, R>(effect: Effect.Effect<A, E, R>): Effect.Effect<A, E, R> =>\n  effect.pipe(\n    Effect.onExit((exit) => {\n      if (exit._tag === \"Success\") {\n        return Effect.annotateCurrentSpan({ outcome: outcomeValue(exit.value._tag) }).pipe(\n          Effect.andThen(metricOf === undefined ? Effect.void : Metric.update(metricOf(exit.value), 1))\n        )\n      }\n      const outcome = causeOutcome(exit.cause)\n      return Effect.annotateCurrentSpan({ outcome }).pipe(\n        Effect.andThen(\n          exitMetric === undefined ? Effect.void : Metric.update(Metric.withAttributes(exitMetric, { outcome }), 1)\n        )\n      )\n    })\n  )\n\n/**\n * `observeOutcome` for operations whose success carries no domain outcome\n * tag: `create` inserts or fails, `get` returns the row or fails, and\n * `acknowledgeCancel` reports whether the guarded update matched. The span\n * still closes with `success`, `failure`, or `interrupt`.\n *\n * @since 1.0.0-rc.0\n * @private\n */\nexport const observeExit = <A, E, R>(effect: Effect.Effect<A, E, R>): Effect.Effect<A, E, R> =>\n  effect.pipe(\n    Effect.onExit((exit) =>\n      Effect.annotateCurrentSpan({\n        outcome: exit._tag === \"Success\" ? \"success\" : causeOutcome(exit.cause)\n      })\n    )\n  )\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AASA,YAAuB;AACvB,aAAwB;AACxB,aAAwB;AAGxB,MAAM,eAAe,CAAC,QAAwB,IAAI,QAAQ,2BAA2B,GAAG,EAAE,YAAY;AAGtG,MAAM,eAAe,CAAI,UACvB,MAAM,kBAAkB,KAAK,IAAI,cAAc;AAe1C,MAAM,iBAAiB,CAC5B,UACA,eAEF,CAAO,WACL,OAAO;AAAA,EACL,OAAO,OAAO,CAAC,SAAS;AACtB,QAAI,KAAK,SAAS,WAAW;AAC3B,aAAO,OAAO,oBAAoB,EAAE,SAAS,aAAa,KAAK,MAAM,IAAI,EAAE,CAAC,EAAE;AAAA,QAC5E,OAAO,QAAQ,aAAa,SAAY,OAAO,OAAO,OAAO,OAAO,SAAS,KAAK,KAAK,GAAG,CAAC,CAAC;AAAA,MAC9F;AAAA,IACF;AACA,UAAM,UAAU,aAAa,KAAK,KAAK;AACvC,WAAO,OAAO,oBAAoB,EAAE,QAAQ,CAAC,EAAE;AAAA,MAC7C,OAAO;AAAA,QACL,eAAe,SAAY,OAAO,OAAO,OAAO,OAAO,OAAO,eAAe,YAAY,EAAE,QAAQ,CAAC,GAAG,CAAC;AAAA,MAC1G;AAAA,IACF;AAAA,EACF,CAAC;AACH;AAWK,MAAM,cAAc,CAAU,WACnC,OAAO;AAAA,EACL,OAAO;AAAA,IAAO,CAAC,SACb,OAAO,oBAAoB;AAAA,MACzB,SAAS,KAAK,SAAS,YAAY,YAAY,aAAa,KAAK,KAAK;AAAA,IACxE,CAAC;AAAA,EACH;AACF;",
+  "names": []
+}

package/dist/cjs/migrations/0001_initial.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Initial durable run and attempt schema.
+ *
+ * @since 0.1.0
+ */
+import * as Effect from "effect/Effect";
+import * as SqlClient from "effect/unstable/sql/SqlClient";
+/**
+ * Creates the `flows_runs` and `flows_attempts` tables and their indexes.
+ *
+ * @category migrations
+ * @since 0.1.0
+ */
+export declare const initial: Effect.Effect<void, unknown, SqlClient.SqlClient>;
+//# sourceMappingURL=0001_initial.d.ts.map

package/dist/cjs/migrations/0001_initial.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"0001_initial.d.ts","sourceRoot":"","sources":["../../../src/migrations/0001_initial.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,SAAS,MAAM,+BAA+B,CAAA;AAE1D;;;;;GAKG;AACH,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,SAAS,CAiGpE,CAAA"}

package/dist/cjs/migrations/0001_initial.js

@@ -0,0 +1,110 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var initial_exports = {};
+__export(initial_exports, {
+  initial: () => initial
+});
+module.exports = __toCommonJS(initial_exports);
+var Dialect = __toESM(require("@smthrs/database/Dialect"), 1);
+var Effect = __toESM(require("effect/Effect"), 1);
+var SqlClient = __toESM(require("effect/unstable/sql/SqlClient"), 1);
+const initial = Effect.gen(function* () {
+  const sql = yield* SqlClient.SqlClient;
+  yield* sql`CREATE TABLE flows_runs (
+    ${Dialect.rowId(sql)}
+    run_id TEXT PRIMARY KEY CHECK (length(run_id) > 0),
+    status TEXT NOT NULL,
+    created_at_ms ${Dialect.integer(sql)} NOT NULL CHECK (${Dialect.isInteger(sql, sql`created_at_ms`)} AND created_at_ms >= 0 AND created_at_ms <= 9007199254740991),
+    started_at_ms ${Dialect.integer(sql)} CHECK (started_at_ms IS NULL OR (${Dialect.isInteger(sql, sql`started_at_ms`)} AND started_at_ms >= 0 AND started_at_ms <= 9007199254740991)),
+    finished_at_ms ${Dialect.integer(sql)} CHECK (finished_at_ms IS NULL OR (${Dialect.isInteger(sql, sql`finished_at_ms`)} AND finished_at_ms >= 0 AND finished_at_ms <= 9007199254740991)),
+    owner_host_id TEXT,
+    owner_pid ${Dialect.integer(sql)},
+    owner_nonce TEXT,
+    heartbeat_at_ms ${Dialect.integer(sql)} CHECK (heartbeat_at_ms IS NULL OR (${Dialect.isInteger(sql, sql`heartbeat_at_ms`)} AND heartbeat_at_ms >= 0 AND heartbeat_at_ms <= 9007199254740991)),
+    claim_host_id TEXT,
+    claim_pid ${Dialect.integer(sql)},
+    claim_nonce TEXT,
+    claimed_at_ms ${Dialect.integer(sql)} CHECK (claimed_at_ms IS NULL OR (${Dialect.isInteger(sql, sql`claimed_at_ms`)} AND claimed_at_ms >= 0 AND claimed_at_ms <= 9007199254740991)),
+    parent_run_id TEXT CHECK (parent_run_id IS NULL OR length(parent_run_id) > 0),
+    cancel_requested_at_ms ${Dialect.integer(sql)} CHECK (cancel_requested_at_ms IS NULL OR (${Dialect.isInteger(sql, sql`cancel_requested_at_ms`)} AND cancel_requested_at_ms >= 0 AND cancel_requested_at_ms <= 9007199254740991)),
+    waiting_reason TEXT CHECK (waiting_reason IS NULL OR length(waiting_reason) > 0),
+    waiting_wake_at_ms ${Dialect.integer(sql)} CHECK (waiting_wake_at_ms IS NULL OR (${Dialect.isInteger(sql, sql`waiting_wake_at_ms`)} AND waiting_wake_at_ms >= 0 AND waiting_wake_at_ms <= 9007199254740991)),
+    waiting_token TEXT CHECK (waiting_token IS NULL OR length(waiting_token) > 0),
+    state_json TEXT NOT NULL CHECK (${Dialect.jsonValid(sql, sql`state_json`)}),
+    CHECK (status IN ('pending', 'running', 'suspended', 'completed', 'failed', 'cancelled')),
+    CHECK (
+      (
+        status = 'running' AND
+        owner_host_id IS NOT NULL AND
+        length(owner_host_id) > 0 AND
+        owner_pid IS NOT NULL AND
+        ${Dialect.isInteger(sql, sql`owner_pid`)} AND owner_pid >= 0 AND
+        owner_nonce IS NOT NULL AND
+        length(owner_nonce) > 0 AND
+        heartbeat_at_ms IS NOT NULL
+      ) OR (
+        status <> 'running' AND
+        owner_host_id IS NULL AND
+        owner_pid IS NULL AND
+        owner_nonce IS NULL AND
+        heartbeat_at_ms IS NULL
+      )
+    ),
+    CHECK (
+      (claim_host_id IS NULL AND claim_pid IS NULL AND claim_nonce IS NULL AND claimed_at_ms IS NULL) OR
+      (claim_host_id IS NOT NULL AND length(claim_host_id) > 0 AND
+       claim_pid IS NOT NULL AND ${Dialect.isInteger(sql, sql`claim_pid`)} AND claim_pid >= 0 AND
+       claim_nonce IS NOT NULL AND length(claim_nonce) > 0 AND claimed_at_ms IS NOT NULL)
+    ),
+    CHECK (
+      (waiting_reason IS NULL AND waiting_wake_at_ms IS NULL AND waiting_token IS NULL) OR
+      waiting_reason IS NOT NULL
+    ),
+    FOREIGN KEY (parent_run_id) REFERENCES flows_runs (run_id)
+  )`;
+  yield* sql`CREATE INDEX flows_runs_parent_run_id_idx ON flows_runs (parent_run_id)`;
+  yield* sql`CREATE INDEX flows_runs_cancel_requested_idx ON flows_runs (cancel_requested_at_ms) WHERE cancel_requested_at_ms IS NOT NULL`;
+  yield* sql`CREATE INDEX flows_runs_waiting_reason_wake_at_idx ON flows_runs (waiting_reason, waiting_wake_at_ms) WHERE waiting_reason IS NOT NULL`;
+  yield* sql`CREATE TABLE flows_attempts (
+    run_id TEXT NOT NULL CHECK (length(run_id) > 0),
+    step_key_digest TEXT NOT NULL CHECK (length(step_key_digest) > 0),
+    attempt ${Dialect.integer(sql)} NOT NULL CHECK (${Dialect.isInteger(sql, sql`attempt`)} AND attempt >= 0 AND attempt <= 9007199254740991),
+    state TEXT NOT NULL CHECK (length(state) > 0),
+    started_at_ms ${Dialect.integer(sql)} NOT NULL CHECK (${Dialect.isInteger(sql, sql`started_at_ms`)} AND started_at_ms >= 0 AND started_at_ms <= 9007199254740991),
+    finished_at_ms ${Dialect.integer(sql)} CHECK (finished_at_ms IS NULL OR (${Dialect.isInteger(sql, sql`finished_at_ms`)} AND finished_at_ms >= 0 AND finished_at_ms <= 9007199254740991)),
+    heartbeat_at_ms ${Dialect.integer(sql)} CHECK (heartbeat_at_ms IS NULL OR (${Dialect.isInteger(sql, sql`heartbeat_at_ms`)} AND heartbeat_at_ms >= 0 AND heartbeat_at_ms <= 9007199254740991)),
+    checkpoint_json TEXT CHECK (checkpoint_json IS NULL OR ${Dialect.jsonValid(sql, sql`checkpoint_json`)}),
+    error_json TEXT CHECK (error_json IS NULL OR ${Dialect.jsonValid(sql, sql`error_json`)}),
+    outcome_json TEXT CHECK (outcome_json IS NULL OR ${Dialect.jsonValid(sql, sql`outcome_json`)}),
+    meta_json TEXT NOT NULL CHECK (${Dialect.jsonValid(sql, sql`meta_json`)}),
+    PRIMARY KEY (run_id, step_key_digest, attempt),
+    FOREIGN KEY (run_id) REFERENCES flows_runs (run_id)
+  )`;
+});
+//# sourceMappingURL=0001_initial.js.map

package/dist/cjs/migrations/0001_initial.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/migrations/0001_initial.ts"],
+  "sourcesContent": ["/**\n * Initial durable run and attempt schema.\n *\n * @since 0.1.0\n */\n\nimport * as Dialect from \"@smthrs/database/Dialect\"\nimport * as Effect from \"effect/Effect\"\nimport * as SqlClient from \"effect/unstable/sql/SqlClient\"\n\n/**\n * Creates the `flows_runs` and `flows_attempts` tables and their indexes.\n *\n * @category migrations\n * @since 0.1.0\n */\nexport const initial: Effect.Effect<void, unknown, SqlClient.SqlClient> = Effect.gen(function*() {\n  const sql = yield* SqlClient.SqlClient\n\n  yield* sql`CREATE TABLE flows_runs (\n    ${Dialect.rowId(sql)}\n    run_id TEXT PRIMARY KEY CHECK (length(run_id) > 0),\n    status TEXT NOT NULL,\n    created_at_ms ${Dialect.integer(sql)} NOT NULL CHECK (${\n    Dialect.isInteger(sql, sql`created_at_ms`)\n  } AND created_at_ms >= 0 AND created_at_ms <= 9007199254740991),\n    started_at_ms ${Dialect.integer(sql)} CHECK (started_at_ms IS NULL OR (${\n    Dialect.isInteger(sql, sql`started_at_ms`)\n  } AND started_at_ms >= 0 AND started_at_ms <= 9007199254740991)),\n    finished_at_ms ${Dialect.integer(sql)} CHECK (finished_at_ms IS NULL OR (${\n    Dialect.isInteger(sql, sql`finished_at_ms`)\n  } AND finished_at_ms >= 0 AND finished_at_ms <= 9007199254740991)),\n    owner_host_id TEXT,\n    owner_pid ${Dialect.integer(sql)},\n    owner_nonce TEXT,\n    heartbeat_at_ms ${Dialect.integer(sql)} CHECK (heartbeat_at_ms IS NULL OR (${\n    Dialect.isInteger(sql, sql`heartbeat_at_ms`)\n  } AND heartbeat_at_ms >= 0 AND heartbeat_at_ms <= 9007199254740991)),\n    claim_host_id TEXT,\n    claim_pid ${Dialect.integer(sql)},\n    claim_nonce TEXT,\n    claimed_at_ms ${Dialect.integer(sql)} CHECK (claimed_at_ms IS NULL OR (${\n    Dialect.isInteger(sql, sql`claimed_at_ms`)\n  } AND claimed_at_ms >= 0 AND claimed_at_ms <= 9007199254740991)),\n    parent_run_id TEXT CHECK (parent_run_id IS NULL OR length(parent_run_id) > 0),\n    cancel_requested_at_ms ${Dialect.integer(sql)} CHECK (cancel_requested_at_ms IS NULL OR (${\n    Dialect.isInteger(sql, sql`cancel_requested_at_ms`)\n  } AND cancel_requested_at_ms >= 0 AND cancel_requested_at_ms <= 9007199254740991)),\n    waiting_reason TEXT CHECK (waiting_reason IS NULL OR length(waiting_reason) > 0),\n    waiting_wake_at_ms ${Dialect.integer(sql)} CHECK (waiting_wake_at_ms IS NULL OR (${\n    Dialect.isInteger(sql, sql`waiting_wake_at_ms`)\n  } AND waiting_wake_at_ms >= 0 AND waiting_wake_at_ms <= 9007199254740991)),\n    waiting_token TEXT CHECK (waiting_token IS NULL OR length(waiting_token) > 0),\n    state_json TEXT NOT NULL CHECK (${Dialect.jsonValid(sql, sql`state_json`)}),\n    CHECK (status IN ('pending', 'running', 'suspended', 'completed', 'failed', 'cancelled')),\n    CHECK (\n      (\n        status = 'running' AND\n        owner_host_id IS NOT NULL AND\n        length(owner_host_id) > 0 AND\n        owner_pid IS NOT NULL AND\n        ${Dialect.isInteger(sql, sql`owner_pid`)} AND owner_pid >= 0 AND\n        owner_nonce IS NOT NULL AND\n        length(owner_nonce) > 0 AND\n        heartbeat_at_ms IS NOT NULL\n      ) OR (\n        status <> 'running' AND\n        owner_host_id IS NULL AND\n        owner_pid IS NULL AND\n        owner_nonce IS NULL AND\n        heartbeat_at_ms IS NULL\n      )\n    ),\n    CHECK (\n      (claim_host_id IS NULL AND claim_pid IS NULL AND claim_nonce IS NULL AND claimed_at_ms IS NULL) OR\n      (claim_host_id IS NOT NULL AND length(claim_host_id) > 0 AND\n       claim_pid IS NOT NULL AND ${Dialect.isInteger(sql, sql`claim_pid`)} AND claim_pid >= 0 AND\n       claim_nonce IS NOT NULL AND length(claim_nonce) > 0 AND claimed_at_ms IS NOT NULL)\n    ),\n    CHECK (\n      (waiting_reason IS NULL AND waiting_wake_at_ms IS NULL AND waiting_token IS NULL) OR\n      waiting_reason IS NOT NULL\n    ),\n    FOREIGN KEY (parent_run_id) REFERENCES flows_runs (run_id)\n  )`\n\n  yield* sql`CREATE INDEX flows_runs_parent_run_id_idx ON flows_runs (parent_run_id)`\n  yield* sql`CREATE INDEX flows_runs_cancel_requested_idx ON flows_runs (cancel_requested_at_ms) WHERE cancel_requested_at_ms IS NOT NULL`\n  yield* sql`CREATE INDEX flows_runs_waiting_reason_wake_at_idx ON flows_runs (waiting_reason, waiting_wake_at_ms) WHERE waiting_reason IS NOT NULL`\n\n  yield* sql`CREATE TABLE flows_attempts (\n    run_id TEXT NOT NULL CHECK (length(run_id) > 0),\n    step_key_digest TEXT NOT NULL CHECK (length(step_key_digest) > 0),\n    attempt ${Dialect.integer(sql)} NOT NULL CHECK (${\n    Dialect.isInteger(sql, sql`attempt`)\n  } AND attempt >= 0 AND attempt <= 9007199254740991),\n    state TEXT NOT NULL CHECK (length(state) > 0),\n    started_at_ms ${Dialect.integer(sql)} NOT NULL CHECK (${\n    Dialect.isInteger(sql, sql`started_at_ms`)\n  } AND started_at_ms >= 0 AND started_at_ms <= 9007199254740991),\n    finished_at_ms ${Dialect.integer(sql)} CHECK (finished_at_ms IS NULL OR (${\n    Dialect.isInteger(sql, sql`finished_at_ms`)\n  } AND finished_at_ms >= 0 AND finished_at_ms <= 9007199254740991)),\n    heartbeat_at_ms ${Dialect.integer(sql)} CHECK (heartbeat_at_ms IS NULL OR (${\n    Dialect.isInteger(sql, sql`heartbeat_at_ms`)\n  } AND heartbeat_at_ms >= 0 AND heartbeat_at_ms <= 9007199254740991)),\n    checkpoint_json TEXT CHECK (checkpoint_json IS NULL OR ${Dialect.jsonValid(sql, sql`checkpoint_json`)}),\n    error_json TEXT CHECK (error_json IS NULL OR ${Dialect.jsonValid(sql, sql`error_json`)}),\n    outcome_json TEXT CHECK (outcome_json IS NULL OR ${Dialect.jsonValid(sql, sql`outcome_json`)}),\n    meta_json TEXT NOT NULL CHECK (${Dialect.jsonValid(sql, sql`meta_json`)}),\n    PRIMARY KEY (run_id, step_key_digest, attempt),\n    FOREIGN KEY (run_id) REFERENCES flows_runs (run_id)\n  )`\n})\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,cAAyB;AACzB,aAAwB;AACxB,gBAA2B;AAQpB,MAAM,UAA6D,OAAO,IAAI,aAAY;AAC/F,QAAM,MAAM,OAAO,UAAU;AAE7B,SAAO;AAAA,MACH,QAAQ,MAAM,GAAG,CAAC;AAAA;AAAA;AAAA,oBAGJ,QAAQ,QAAQ,GAAG,CAAC,oBACpC,QAAQ,UAAU,KAAK,kBAAkB,CAC3C;AAAA,oBACkB,QAAQ,QAAQ,GAAG,CAAC,qCACpC,QAAQ,UAAU,KAAK,kBAAkB,CAC3C;AAAA,qBACmB,QAAQ,QAAQ,GAAG,CAAC,sCACrC,QAAQ,UAAU,KAAK,mBAAmB,CAC5C;AAAA;AAAA,gBAEc,QAAQ,QAAQ,GAAG,CAAC;AAAA;AAAA,sBAEd,QAAQ,QAAQ,GAAG,CAAC,uCACtC,QAAQ,UAAU,KAAK,oBAAoB,CAC7C;AAAA;AAAA,gBAEc,QAAQ,QAAQ,GAAG,CAAC;AAAA;AAAA,oBAEhB,QAAQ,QAAQ,GAAG,CAAC,qCACpC,QAAQ,UAAU,KAAK,kBAAkB,CAC3C;AAAA;AAAA,6BAE2B,QAAQ,QAAQ,GAAG,CAAC,8CAC7C,QAAQ,UAAU,KAAK,2BAA2B,CACpD;AAAA;AAAA,yBAEuB,QAAQ,QAAQ,GAAG,CAAC,0CACzC,QAAQ,UAAU,KAAK,uBAAuB,CAChD;AAAA;AAAA,sCAEoC,QAAQ,UAAU,KAAK,eAAe,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,UAQnE,QAAQ,UAAU,KAAK,cAAc,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mCAeb,QAAQ,UAAU,KAAK,cAAc,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAUvE,SAAO;AACP,SAAO;AACP,SAAO;AAEP,SAAO;AAAA;AAAA;AAAA,cAGK,QAAQ,QAAQ,GAAG,CAAC,oBAC9B,QAAQ,UAAU,KAAK,YAAY,CACrC;AAAA;AAAA,oBAEkB,QAAQ,QAAQ,GAAG,CAAC,oBACpC,QAAQ,UAAU,KAAK,kBAAkB,CAC3C;AAAA,qBACmB,QAAQ,QAAQ,GAAG,CAAC,sCACrC,QAAQ,UAAU,KAAK,mBAAmB,CAC5C;AAAA,sBACoB,QAAQ,QAAQ,GAAG,CAAC,uCACtC,QAAQ,UAAU,KAAK,oBAAoB,CAC7C;AAAA,6DAC2D,QAAQ,UAAU,KAAK,oBAAoB,CAAC;AAAA,mDACtD,QAAQ,UAAU,KAAK,eAAe,CAAC;AAAA,uDACnC,QAAQ,UAAU,KAAK,iBAAiB,CAAC;AAAA,qCAC3D,QAAQ,UAAU,KAAK,cAAc,CAAC;AAAA;AAAA;AAAA;AAI3E,CAAC;",
+  "names": []
+}