@shware/workflow 0.0.0-stage → 0.1.0

package/dist/store/facts.cjs

@@ -0,0 +1,60 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_engine_condition = require("../engine/condition.cjs");
+//#region src/store/facts.ts
+/** The profile path that reads the user's own id (`u.userId`). */
+const USER_ID_PROPERTY = "userId";
+/** Single-user fact source over a JourneyStore: evaluation lives in engine/condition.ts, this only reads. */
+var JourneyFactSource = class {
+	store;
+	userId;
+	constructor(store, userId) {
+		this.store = store;
+		this.userId = userId;
+	}
+	async countEvents(event, opts) {
+		const window = {
+			...opts?.sinceMs === void 0 ? {} : { sinceMs: opts.sinceMs },
+			...opts?.untilMs === void 0 ? {} : { untilMs: opts.untilMs }
+		};
+		if (opts?.where === void 0) return this.store.countEvents(this.userId, event, window);
+		const where = opts.where;
+		return (await this.store.listEventPayloads(this.userId, event, window)).filter((payload) => require_engine_condition.matchesWhere(payload, where)).length;
+	}
+	/**
+	* The scalar boundary. Everything downstream — comparisons, subject
+	* placeholders, resolved message props — is typed ScalarIR, but nothing so
+	* far has checked that the stored JSON is one: /identify validates only that
+	* `props` is a plain object, and the merge stores whatever nesting it is
+	* handed. Left unchecked, `gt(score, 3)` on `['5']` coerces its way to true
+	* while `eq(score, 5)` is false, and `String(recipient)` on an object
+	* addresses an email to `[object Object]`.
+	*
+	* So a non-scalar value reads as absent, matching how matchesWhere treats a
+	* non-scalar payload leaf. The port cannot say "present but not a scalar",
+	* and guessing at a coercion is what produced the wrong branch in the first
+	* place.
+	*/
+	async getProperty(path) {
+		if (path === "userId") return this.userId;
+		const props = await this.store.getProfile(this.userId);
+		if (props === void 0) return void 0;
+		if (!Object.hasOwn(props, path)) return void 0;
+		const value = props[path];
+		if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") return value;
+	}
+	getSegmentCondition(name) {
+		return this.store.getSegmentCondition(name);
+	}
+	/** The user's registered devices; none, and push skips while `reachable('push')` is false. */
+	async isSuppressed(channel) {
+		return await this.store.isSuppressed?.(this.userId, channel) ?? false;
+	}
+	listDevices() {
+		return this.store.listDevices(this.userId);
+	}
+};
+//#endregion
+exports.JourneyFactSource = JourneyFactSource;
+exports.USER_ID_PROPERTY = USER_ID_PROPERTY;
+
+//# sourceMappingURL=facts.cjs.map

package/dist/store/facts.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"facts.cjs","names":["matchesWhere"],"sources":["../../src/store/facts.ts"],"sourcesContent":["import { matchesWhere } from '../engine/condition';\nimport type { FactSource, PushDevice } from '../engine/ports';\nimport type { ConditionIR, ScalarIR } from '../ir';\nimport type { JourneyStore } from './index';\n\n/** The profile path that reads the user's own id (`u.userId`). */\nexport const USER_ID_PROPERTY = 'userId';\n\n/** Single-user fact source over a JourneyStore: evaluation lives in engine/condition.ts, this only reads. */\nexport class JourneyFactSource implements FactSource {\n  constructor(\n    private readonly store: JourneyStore,\n    private readonly userId: string\n  ) {}\n\n  async countEvents(\n    event: string,\n    opts?: { sinceMs?: number; untilMs?: number; where?: ConditionIR }\n  ): Promise<number> {\n    const window = {\n      ...(opts?.sinceMs === undefined ? {} : { sinceMs: opts.sinceMs }),\n      ...(opts?.untilMs === undefined ? {} : { untilMs: opts.untilMs }),\n    };\n    if (opts?.where === undefined) return this.store.countEvents(this.userId, event, window);\n    // Payload filtering happens in JS via the shared evaluator — one set of\n    // where semantics with the in-memory FactSource; per-user row counts are small.\n    const where = opts.where;\n    const payloads = await this.store.listEventPayloads(this.userId, event, window);\n    return payloads.filter((payload) => matchesWhere(payload, where)).length;\n  }\n\n  /**\n   * The scalar boundary. Everything downstream — comparisons, subject\n   * placeholders, resolved message props — is typed ScalarIR, but nothing so\n   * far has checked that the stored JSON is one: /identify validates only that\n   * `props` is a plain object, and the merge stores whatever nesting it is\n   * handed. Left unchecked, `gt(score, 3)` on `['5']` coerces its way to true\n   * while `eq(score, 5)` is false, and `String(recipient)` on an object\n   * addresses an email to `[object Object]`.\n   *\n   * So a non-scalar value reads as absent, matching how matchesWhere treats a\n   * non-scalar payload leaf. The port cannot say \"present but not a scalar\",\n   * and guessing at a coercion is what produced the wrong branch in the first\n   * place.\n   */\n  async getProperty(path: string): Promise<ScalarIR | undefined> {\n    // The system field: the request's identity, never stored in the profile (contract.user.userId)\n    if (path === USER_ID_PROPERTY) return this.userId;\n    const props: Record<string, unknown> | undefined = await this.store.getProfile(this.userId);\n    if (props === undefined) return undefined;\n    // Own keys only: `props[path]` would otherwise find Object.prototype, so\n    // `exists(u.toString)` held for every user with a profile row and a subject\n    // placeholder rendered native-code text into the email.\n    if (!Object.hasOwn(props, path)) return undefined;\n    const value = props[path];\n    // An explicit null means \"unset\" and behaves as not_exists. /identify\n    // itself clears a property by removing the key (the merge drops nulls), so\n    // this covers profiles written by other means — a direct SQL fixup, a\n    // migration, an import.\n    if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {\n      return value;\n    }\n    return undefined;\n  }\n\n  getSegmentCondition(name: string): Promise<ConditionIR | undefined> {\n    return this.store.getSegmentCondition(name);\n  }\n\n  /** The user's registered devices; none, and push skips while `reachable('push')` is false. */\n  async isSuppressed(channel: string): Promise<boolean> {\n    return (await this.store.isSuppressed?.(this.userId, channel)) ?? false;\n  }\n\n  listDevices(): Promise<PushDevice[]> {\n    return this.store.listDevices(this.userId);\n  }\n}\n"],"mappings":";;;;AAMA,MAAa,mBAAmB;;AAGhC,IAAa,oBAAb,MAAqD;CAEhC;CACA;CAFnB,YACE,OACA,QACA;EAFiB,KAAA,QAAA;EACA,KAAA,SAAA;CAChB;CAEH,MAAM,YACJ,OACA,MACiB;EACjB,MAAM,SAAS;GACb,GAAI,MAAM,YAAY,KAAA,IAAY,CAAC,IAAI,EAAE,SAAS,KAAK,QAAQ;GAC/D,GAAI,MAAM,YAAY,KAAA,IAAY,CAAC,IAAI,EAAE,SAAS,KAAK,QAAQ;EACjE;EACA,IAAI,MAAM,UAAU,KAAA,GAAW,OAAO,KAAK,MAAM,YAAY,KAAK,QAAQ,OAAO,MAAM;EAGvF,MAAM,QAAQ,KAAK;EAEnB,QAAO,MADgB,KAAK,MAAM,kBAAkB,KAAK,QAAQ,OAAO,MAAM,EAAA,CAC9D,QAAQ,YAAYA,yBAAAA,aAAa,SAAS,KAAK,CAAC,CAAC,CAAC;CACpE;;;;;;;;;;;;;;;CAgBA,MAAM,YAAY,MAA6C;EAE7D,IAAI,SAAA,UAA2B,OAAO,KAAK;EAC3C,MAAM,QAA6C,MAAM,KAAK,MAAM,WAAW,KAAK,MAAM;EAC1F,IAAI,UAAU,KAAA,GAAW,OAAO,KAAA;EAIhC,IAAI,CAAC,OAAO,OAAO,OAAO,IAAI,GAAG,OAAO,KAAA;EACxC,MAAM,QAAQ,MAAM;EAKpB,IAAI,OAAO,UAAU,YAAY,OAAO,UAAU,YAAY,OAAO,UAAU,WAC7E,OAAO;CAGX;CAEA,oBAAoB,MAAgD;EAClE,OAAO,KAAK,MAAM,oBAAoB,IAAI;CAC5C;;CAGA,MAAM,aAAa,SAAmC;EACpD,OAAQ,MAAM,KAAK,MAAM,eAAe,KAAK,QAAQ,OAAO,KAAM;CACpE;CAEA,cAAqC;EACnC,OAAO,KAAK,MAAM,YAAY,KAAK,MAAM;CAC3C;AACF"}

package/dist/store/facts.d.cts

@@ -0,0 +1,38 @@
+import { ConditionIR, ScalarIR } from "../ir.cjs";
+import { FactSource, PushDevice } from "../engine/ports.cjs";
+import { JourneyStore } from "./index.cjs";
+//#region src/store/facts.d.ts
+/** The profile path that reads the user's own id (`u.userId`). */
+export declare const USER_ID_PROPERTY = "userId";
+/** Single-user fact source over a JourneyStore: evaluation lives in engine/condition.ts, this only reads. */
+export declare class JourneyFactSource implements FactSource {
+  private readonly store;
+  private readonly userId;
+  constructor(store: JourneyStore, userId: string);
+  countEvents(event: string, opts?: {
+    sinceMs?: number;
+    untilMs?: number;
+    where?: ConditionIR;
+  }): Promise<number>;
+  /**
+   * The scalar boundary. Everything downstream — comparisons, subject
+   * placeholders, resolved message props — is typed ScalarIR, but nothing so
+   * far has checked that the stored JSON is one: /identify validates only that
+   * `props` is a plain object, and the merge stores whatever nesting it is
+   * handed. Left unchecked, `gt(score, 3)` on `['5']` coerces its way to true
+   * while `eq(score, 5)` is false, and `String(recipient)` on an object
+   * addresses an email to `[object Object]`.
+   *
+   * So a non-scalar value reads as absent, matching how matchesWhere treats a
+   * non-scalar payload leaf. The port cannot say "present but not a scalar",
+   * and guessing at a coercion is what produced the wrong branch in the first
+   * place.
+   */
+  getProperty(path: string): Promise<ScalarIR | undefined>;
+  getSegmentCondition(name: string): Promise<ConditionIR | undefined>;
+  /** The user's registered devices; none, and push skips while `reachable('push')` is false. */
+  isSuppressed(channel: string): Promise<boolean>;
+  listDevices(): Promise<PushDevice[]>;
+}
+//#endregion
+//# sourceMappingURL=facts.d.cts.map

package/dist/store/facts.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"facts.d.cts","names":[],"sources":["../../src/store/facts.ts"],"mappings":";;;;;qBAMa;;qBAGA,6BAA6B;mBAErB;mBACA;EAFnB,YACmB,OAAO,cACP;EAGb,YACJ,eACA;IAAS;IAAkB;IAAkB,QAAQ;MACpD;;;;;;;;;;;;;;;EA2BG,YAAY,eAAe,QAAQ;EAoBzC,oBAAoB,eAAe,QAAQ;;EAKrC,aAAa,kBAAkB;EAIrC,eAAe,QAAQ"}

package/dist/store/facts.d.mts

@@ -0,0 +1,38 @@
+import { ConditionIR, ScalarIR } from "../ir.mjs";
+import { FactSource, PushDevice } from "../engine/ports.mjs";
+import { JourneyStore } from "./index.mjs";
+//#region src/store/facts.d.ts
+/** The profile path that reads the user's own id (`u.userId`). */
+export declare const USER_ID_PROPERTY = "userId";
+/** Single-user fact source over a JourneyStore: evaluation lives in engine/condition.ts, this only reads. */
+export declare class JourneyFactSource implements FactSource {
+  private readonly store;
+  private readonly userId;
+  constructor(store: JourneyStore, userId: string);
+  countEvents(event: string, opts?: {
+    sinceMs?: number;
+    untilMs?: number;
+    where?: ConditionIR;
+  }): Promise<number>;
+  /**
+   * The scalar boundary. Everything downstream — comparisons, subject
+   * placeholders, resolved message props — is typed ScalarIR, but nothing so
+   * far has checked that the stored JSON is one: /identify validates only that
+   * `props` is a plain object, and the merge stores whatever nesting it is
+   * handed. Left unchecked, `gt(score, 3)` on `['5']` coerces its way to true
+   * while `eq(score, 5)` is false, and `String(recipient)` on an object
+   * addresses an email to `[object Object]`.
+   *
+   * So a non-scalar value reads as absent, matching how matchesWhere treats a
+   * non-scalar payload leaf. The port cannot say "present but not a scalar",
+   * and guessing at a coercion is what produced the wrong branch in the first
+   * place.
+   */
+  getProperty(path: string): Promise<ScalarIR | undefined>;
+  getSegmentCondition(name: string): Promise<ConditionIR | undefined>;
+  /** The user's registered devices; none, and push skips while `reachable('push')` is false. */
+  isSuppressed(channel: string): Promise<boolean>;
+  listDevices(): Promise<PushDevice[]>;
+}
+//#endregion
+//# sourceMappingURL=facts.d.mts.map

package/dist/store/facts.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"facts.d.mts","names":[],"sources":["../../src/store/facts.ts"],"mappings":";;;;;qBAMa;;qBAGA,6BAA6B;mBAErB;mBACA;EAFnB,YACmB,OAAO,cACP;EAGb,YACJ,eACA;IAAS;IAAkB;IAAkB,QAAQ;MACpD;;;;;;;;;;;;;;;EA2BG,YAAY,eAAe,QAAQ;EAoBzC,oBAAoB,eAAe,QAAQ;;EAKrC,aAAa,kBAAkB;EAIrC,eAAe,QAAQ"}

package/dist/store/facts.mjs

@@ -0,0 +1,58 @@
+import { matchesWhere } from "../engine/condition.mjs";
+//#region src/store/facts.ts
+/** The profile path that reads the user's own id (`u.userId`). */
+const USER_ID_PROPERTY = "userId";
+/** Single-user fact source over a JourneyStore: evaluation lives in engine/condition.ts, this only reads. */
+var JourneyFactSource = class {
+	store;
+	userId;
+	constructor(store, userId) {
+		this.store = store;
+		this.userId = userId;
+	}
+	async countEvents(event, opts) {
+		const window = {
+			...opts?.sinceMs === void 0 ? {} : { sinceMs: opts.sinceMs },
+			...opts?.untilMs === void 0 ? {} : { untilMs: opts.untilMs }
+		};
+		if (opts?.where === void 0) return this.store.countEvents(this.userId, event, window);
+		const where = opts.where;
+		return (await this.store.listEventPayloads(this.userId, event, window)).filter((payload) => matchesWhere(payload, where)).length;
+	}
+	/**
+	* The scalar boundary. Everything downstream — comparisons, subject
+	* placeholders, resolved message props — is typed ScalarIR, but nothing so
+	* far has checked that the stored JSON is one: /identify validates only that
+	* `props` is a plain object, and the merge stores whatever nesting it is
+	* handed. Left unchecked, `gt(score, 3)` on `['5']` coerces its way to true
+	* while `eq(score, 5)` is false, and `String(recipient)` on an object
+	* addresses an email to `[object Object]`.
+	*
+	* So a non-scalar value reads as absent, matching how matchesWhere treats a
+	* non-scalar payload leaf. The port cannot say "present but not a scalar",
+	* and guessing at a coercion is what produced the wrong branch in the first
+	* place.
+	*/
+	async getProperty(path) {
+		if (path === "userId") return this.userId;
+		const props = await this.store.getProfile(this.userId);
+		if (props === void 0) return void 0;
+		if (!Object.hasOwn(props, path)) return void 0;
+		const value = props[path];
+		if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") return value;
+	}
+	getSegmentCondition(name) {
+		return this.store.getSegmentCondition(name);
+	}
+	/** The user's registered devices; none, and push skips while `reachable('push')` is false. */
+	async isSuppressed(channel) {
+		return await this.store.isSuppressed?.(this.userId, channel) ?? false;
+	}
+	listDevices() {
+		return this.store.listDevices(this.userId);
+	}
+};
+//#endregion
+export { JourneyFactSource, USER_ID_PROPERTY };
+
+//# sourceMappingURL=facts.mjs.map

package/dist/store/facts.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"facts.mjs","names":[],"sources":["../../src/store/facts.ts"],"sourcesContent":["import { matchesWhere } from '../engine/condition';\nimport type { FactSource, PushDevice } from '../engine/ports';\nimport type { ConditionIR, ScalarIR } from '../ir';\nimport type { JourneyStore } from './index';\n\n/** The profile path that reads the user's own id (`u.userId`). */\nexport const USER_ID_PROPERTY = 'userId';\n\n/** Single-user fact source over a JourneyStore: evaluation lives in engine/condition.ts, this only reads. */\nexport class JourneyFactSource implements FactSource {\n  constructor(\n    private readonly store: JourneyStore,\n    private readonly userId: string\n  ) {}\n\n  async countEvents(\n    event: string,\n    opts?: { sinceMs?: number; untilMs?: number; where?: ConditionIR }\n  ): Promise<number> {\n    const window = {\n      ...(opts?.sinceMs === undefined ? {} : { sinceMs: opts.sinceMs }),\n      ...(opts?.untilMs === undefined ? {} : { untilMs: opts.untilMs }),\n    };\n    if (opts?.where === undefined) return this.store.countEvents(this.userId, event, window);\n    // Payload filtering happens in JS via the shared evaluator — one set of\n    // where semantics with the in-memory FactSource; per-user row counts are small.\n    const where = opts.where;\n    const payloads = await this.store.listEventPayloads(this.userId, event, window);\n    return payloads.filter((payload) => matchesWhere(payload, where)).length;\n  }\n\n  /**\n   * The scalar boundary. Everything downstream — comparisons, subject\n   * placeholders, resolved message props — is typed ScalarIR, but nothing so\n   * far has checked that the stored JSON is one: /identify validates only that\n   * `props` is a plain object, and the merge stores whatever nesting it is\n   * handed. Left unchecked, `gt(score, 3)` on `['5']` coerces its way to true\n   * while `eq(score, 5)` is false, and `String(recipient)` on an object\n   * addresses an email to `[object Object]`.\n   *\n   * So a non-scalar value reads as absent, matching how matchesWhere treats a\n   * non-scalar payload leaf. The port cannot say \"present but not a scalar\",\n   * and guessing at a coercion is what produced the wrong branch in the first\n   * place.\n   */\n  async getProperty(path: string): Promise<ScalarIR | undefined> {\n    // The system field: the request's identity, never stored in the profile (contract.user.userId)\n    if (path === USER_ID_PROPERTY) return this.userId;\n    const props: Record<string, unknown> | undefined = await this.store.getProfile(this.userId);\n    if (props === undefined) return undefined;\n    // Own keys only: `props[path]` would otherwise find Object.prototype, so\n    // `exists(u.toString)` held for every user with a profile row and a subject\n    // placeholder rendered native-code text into the email.\n    if (!Object.hasOwn(props, path)) return undefined;\n    const value = props[path];\n    // An explicit null means \"unset\" and behaves as not_exists. /identify\n    // itself clears a property by removing the key (the merge drops nulls), so\n    // this covers profiles written by other means — a direct SQL fixup, a\n    // migration, an import.\n    if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {\n      return value;\n    }\n    return undefined;\n  }\n\n  getSegmentCondition(name: string): Promise<ConditionIR | undefined> {\n    return this.store.getSegmentCondition(name);\n  }\n\n  /** The user's registered devices; none, and push skips while `reachable('push')` is false. */\n  async isSuppressed(channel: string): Promise<boolean> {\n    return (await this.store.isSuppressed?.(this.userId, channel)) ?? false;\n  }\n\n  listDevices(): Promise<PushDevice[]> {\n    return this.store.listDevices(this.userId);\n  }\n}\n"],"mappings":";;;AAMA,MAAa,mBAAmB;;AAGhC,IAAa,oBAAb,MAAqD;CAEhC;CACA;CAFnB,YACE,OACA,QACA;EAFiB,KAAA,QAAA;EACA,KAAA,SAAA;CAChB;CAEH,MAAM,YACJ,OACA,MACiB;EACjB,MAAM,SAAS;GACb,GAAI,MAAM,YAAY,KAAA,IAAY,CAAC,IAAI,EAAE,SAAS,KAAK,QAAQ;GAC/D,GAAI,MAAM,YAAY,KAAA,IAAY,CAAC,IAAI,EAAE,SAAS,KAAK,QAAQ;EACjE;EACA,IAAI,MAAM,UAAU,KAAA,GAAW,OAAO,KAAK,MAAM,YAAY,KAAK,QAAQ,OAAO,MAAM;EAGvF,MAAM,QAAQ,KAAK;EAEnB,QAAO,MADgB,KAAK,MAAM,kBAAkB,KAAK,QAAQ,OAAO,MAAM,EAAA,CAC9D,QAAQ,YAAY,aAAa,SAAS,KAAK,CAAC,CAAC,CAAC;CACpE;;;;;;;;;;;;;;;CAgBA,MAAM,YAAY,MAA6C;EAE7D,IAAI,SAAA,UAA2B,OAAO,KAAK;EAC3C,MAAM,QAA6C,MAAM,KAAK,MAAM,WAAW,KAAK,MAAM;EAC1F,IAAI,UAAU,KAAA,GAAW,OAAO,KAAA;EAIhC,IAAI,CAAC,OAAO,OAAO,OAAO,IAAI,GAAG,OAAO,KAAA;EACxC,MAAM,QAAQ,MAAM;EAKpB,IAAI,OAAO,UAAU,YAAY,OAAO,UAAU,YAAY,OAAO,UAAU,WAC7E,OAAO;CAGX;CAEA,oBAAoB,MAAgD;EAClE,OAAO,KAAK,MAAM,oBAAoB,IAAI;CAC5C;;CAGA,MAAM,aAAa,SAAmC;EACpD,OAAQ,MAAM,KAAK,MAAM,eAAe,KAAK,QAAQ,OAAO,KAAM;CACpE;CAEA,cAAqC;EACnC,OAAO,KAAK,MAAM,YAAY,KAAK,MAAM;CAC3C;AACF"}

package/dist/store/index.cjs

@@ -0,0 +1,31 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_store_postgres_reporting = require("./postgres-reporting.cjs");
+const require_store_tables = require("./tables.cjs");
+const require_store_postgres = require("./postgres.cjs");
+const require_store_facts = require("./facts.cjs");
+const require_store_d1 = require("./d1.cjs");
+//#region src/store/index.ts
+/**
+* The live database lacks tables or columns the engine reads (an SDK upgrade added them, or the
+* host never ran the migration). Raised before a deploy writes anything.
+*/
+var SchemaMismatchError = class extends Error {
+	problems;
+	name = "SchemaMismatchError";
+	constructor(problems) {
+		super(`the database does not match @shware/workflow's tables — regenerate the drizzle schema (workflow-ui generate) and run your migrations:\n  ${problems.join("\n  ")}`);
+		this.problems = problems;
+	}
+};
+//#endregion
+exports.D1JourneyStore = require_store_d1.D1JourneyStore;
+exports.DEFAULT_SCHEMA = require_store_tables.DEFAULT_SCHEMA;
+exports.JourneyFactSource = require_store_facts.JourneyFactSource;
+exports.PostgresJourneyStore = require_store_postgres.PostgresJourneyStore;
+exports.PostgresReporting = require_store_postgres_reporting.PostgresReporting;
+exports.SchemaMismatchError = SchemaMismatchError;
+exports.TABLES = require_store_tables.TABLES;
+exports.renderDrizzleSchema = require_store_tables.renderDrizzleSchema;
+exports.renderPostgresDdl = require_store_tables.renderPostgresDdl;
+
+//# sourceMappingURL=index.cjs.map

package/dist/store/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":[],"sources":["../../src/store/index.ts"],"sourcesContent":["import type { PushDevice } from '../engine/ports';\nimport type { BundleIR, ConditionIR, ScalarIR, WorkflowIR } from '../ir';\n\n/**\n * The journey engine's data plane as a port. Everything the ingest router, the\n * runner and the fact source persist or look up goes through this interface,\n * so the storage engine is a deployment choice: D1 + KV (`D1JourneyStore`,\n * the original), Postgres (`PostgresJourneyStore`), or anything else that can\n * satisfy the contract below. Execution (durable steps, sleeps, wake-ups) is\n * the workflow runtime's job and stays out of here.\n *\n * Timestamps are epoch milliseconds throughout; a store may persist them in\n * its native type as long as `sinceMs` comparisons behave.\n */\n\n/**\n * A profile patch or a stored profile. On the way in, `null` means \"remove\n * this property\" (RFC 7386 merge-patch, the only way the API has to unset\n * one); a stored profile never contains null.\n */\nexport type ProfileProps = Record<string, ScalarIR | null | undefined>;\n\nexport interface EventInput {\n  /** The occurrence's identity, chosen by the sender; a second insert with the same id is a no-op. */\n  id: string;\n  userId: string;\n  event: string;\n  ts: number;\n  payload: Record<string, unknown>;\n}\n\nexport interface TriggerRoute {\n  workflow: string;\n  hash: string;\n  /** Payload gate (payload-only condition tree), or null when the trigger has none. */\n  where: ConditionIR | null;\n  /** Profile gate, or null. */\n  filter: ConditionIR | null;\n}\n\nexport interface SegmentTriggerRoute {\n  workflow: string;\n  hash: string;\n  segment: string;\n}\n\nexport interface EntryInput {\n  workflow: string;\n  userId: string;\n  instanceId: string;\n  hash: string;\n  ts: number;\n}\n\n/**\n * How an entry attempt ended: a fresh row, a 'failed' row of a dead instance\n * taken over (the once policy does not bar a user over one outage), or\n * refused because the pair already entered and is still alive.\n */\nexport type EntryOutcome = 'entered' | 'reclaimed' | null;\n\n/** A device registered for pushes: its provider token belongs to the user who registered it last. */\nexport interface DeviceInput {\n  userId: string;\n  token: string;\n  /** `ios` (APNs) or `android` (FCM): which provider the token belongs to. */\n  platform: string;\n  ts: number;\n}\n\n/** A store plus how to release what opening it acquired (a connection, say). */\nexport interface StoreLease {\n  store: JourneyStore;\n  close?: () => Promise<void>;\n}\n\n/**\n * The live database lacks tables or columns the engine reads (an SDK upgrade added them, or the\n * host never ran the migration). Raised before a deploy writes anything.\n */\nexport class SchemaMismatchError extends Error {\n  override readonly name = 'SchemaMismatchError';\n\n  constructor(readonly problems: readonly string[]) {\n    super(\n      `the database does not match @shware/workflow's tables — regenerate the drizzle schema (workflow-ui generate) and run your migrations:\\n  ${problems.join('\\n  ')}`\n    );\n  }\n}\n\n/** A message copy as reporting records it, before it goes out. */\nexport interface MessageRecord {\n  idempotencyKey: string;\n  workflow: string;\n  instanceId: string;\n  nodeId: string;\n  template: string;\n  /** Where the copy lands: `email`, `push_ios`, `push_android`. */\n  channel: string;\n  userId: string;\n  sentAt: number;\n}\n\n/** What a click is judged by. */\nexport interface ClickContext {\n  url: string;\n  deliveredAt: number;\n  linkCount: number;\n  /** The copy's clicks in the window before this one. */\n  recent: { position: number; at: number }[];\n}\n\n/** An open or a click, with the verdict on who made it and where it came from. */\nexport interface Engagement {\n  at: number;\n  machine: boolean;\n  /** The rule that called it a machine; null for a person. */\n  reason: string | null;\n  userAgent: string | null;\n  /** The network the request came from (Cloudflare's `cf.asn`, `cf.asOrganization`, `cf.country`), never the address. */\n  asn: number | null;\n  organization: string | null;\n  country: string | null;\n}\n\n/**\n * Journey reporting: where each instance stands, every copy and how it was engaged with, segment\n * sizes. A store that keeps it (Postgres) exposes it as `reporting`; the Worker then records it\n * and serves email tracking. Every write is idempotent — a retried step reports again.\n */\n/** Bounds on when an event happened, both inclusive (epoch ms); an absent side is open. */\nexport interface EventWindow {\n  sinceMs?: number;\n  untilMs?: number;\n}\n\nexport interface JourneyReporting {\n  /** The instance entered: its row exists from here, so one a guard ends at once still counts. */\n  instanceStarted(input: {\n    workflow: string;\n    instanceId: string;\n    userId: string;\n    at: number;\n  }): Promise<void>;\n  nodeReached(input: {\n    workflow: string;\n    instanceId: string;\n    userId: string;\n    nodeId: string;\n    at: number;\n  }): Promise<void>;\n  instanceFinished(input: {\n    workflow: string;\n    instanceId: string;\n    userId: string;\n    status: string;\n    at: number;\n    convertedAt?: number;\n  }): Promise<void>;\n  /** The copy's row id; the row a retry already wrote, when there is one. */\n  recordMessage(message: MessageRecord): Promise<string>;\n  settleMessage(\n    idempotencyKey: string,\n    result: { delivered: true } | { delivered: false; reason: string },\n    at: number\n  ): Promise<void>;\n  /** An email's tracked links, in document order. */\n  recordLinks(messageId: string, urls: readonly string[]): Promise<void>;\n  /**\n   * Record an open of the copy, judged by `judge` against the copy (its recipient and when it was\n   * delivered — when it was sent, before the transport answered); `undefined` from the judge\n   * records nothing. Read and written in one transaction. False for an unknown copy.\n   */\n  recordOpen(\n    messageId: string,\n    judge: (message: { userId: string; deliveredAt: number }) => Engagement | undefined\n  ): Promise<boolean>;\n  /**\n   * Record a click on the copy's link at `position`, judged by `judge` against the link, how\n   * many links the copy has and its clicks of the last `windowMs`. The copy is locked for the\n   * transaction, so clicks arriving together (a scanner following every link at once) are\n   * judged one after another, each seeing the ones before. When the judge asks to `backdate`,\n   * the window's earlier clicks are reclassified with this one's verdict. A click implies an\n   * open. Undefined for an unknown link.\n   */\n  recordClick(\n    messageId: string,\n    position: number,\n    at: number,\n    windowMs: number,\n    judge: (link: ClickContext) => { engagement: Engagement; backdate: boolean }\n  ): Promise<{ url: string; engagement: Engagement } | undefined>;\n  /** The email copy's recipient opted out of email: recorded on the copy and as a suppression. False for an unknown copy. */\n  recordUnsubscribe(messageId: string, at: number): Promise<boolean>;\n  /** A push copy the device reported it received. False for an unknown copy. */\n  recordDeviceDelivered(messageId: string, at: number): Promise<boolean>;\n  /** Drop members of segments no longer deployed, then record every deployed segment's size. */\n  snapshotSegments(at: number): Promise<{ segment: string; size: number }[]>;\n}\n\nexport interface JourneyStore {\n  /** Reporting, when the store keeps it (Postgres); D1 stores none. */\n  readonly reporting?: JourneyReporting;\n\n  /**\n   * Record that the user's data must go (a deleted account), before anything is erased: the\n   * request outlives a failure to stop their instances, and the sweep retries it.\n   */\n  requestErasure(userId: string, at: number): Promise<void>;\n  /** Users whose erasure was requested and not finished yet. */\n  pendingErasures(): Promise<string[]>;\n  /** The user's journey instances still running, by the entry ledger. */\n  runningInstances(userId: string): Promise<string[]>;\n  /**\n   * Erase everything kept about the user — profile, devices, events, wake subscriptions, segment\n   * memberships, suppressions, entries and reporting — and the erasure request last. Run only\n   * once no instance of theirs runs any more, or one could write some of it back.\n   */\n  forgetUser(userId: string): Promise<void>;\n\n  /** The user opted out of the channel (recorded by an unsubscribe); stores without reporting omit it. */\n  isSuppressed?(userId: string, channel: string): Promise<boolean>;\n\n  /**\n   * What the live database lacks against the engine's tables (read-only); a deploy refuses to\n   * run while it lists anything. Stores whose schema the engine owns (D1) omit it.\n   */\n  checkSchema?(): Promise<string[]>;\n\n  /* ---------------------------------- events --------------------------------- */\n  /** Append the occurrence; false when its id was already in the log (nothing written). */\n  insertEvent(input: EventInput): Promise<boolean>;\n  /** Occurrences of `event` for the user, optionally only those within the window. */\n  countEvents(userId: string, event: string, window?: EventWindow): Promise<number>;\n  /** The payloads of those occurrences — the caller filters them with the shared evaluator. */\n  listEventPayloads(\n    userId: string,\n    event: string,\n    window?: EventWindow\n  ): Promise<Record<string, unknown>[]>;\n\n  /* --------------------------------- profiles -------------------------------- */\n  getProfile(userId: string): Promise<ProfileProps | undefined>;\n  /**\n   * Merge-patch `props` into the stored profile in one statement (a null\n   * removes the property) and return the result. One statement, because a\n   * read-modify-write loses one of two concurrent identifies.\n   */\n  mergeProfile(userId: string, props: ProfileProps): Promise<ProfileProps>;\n\n  /** Every user the engine knows (a profile or an event): who the segment sweep evaluates. */\n  listUserIds(): Promise<string[]>;\n\n  /* ---------------------------------- devices --------------------------------- */\n  /** The user's push devices, most recently registered first. */\n  listDevices(userId: string): Promise<PushDevice[]>;\n  /**\n   * Register a device: one row per token, so a token registered again moves to the user who\n   * registered it last (a phone signed into another account) and to the front of their list.\n   */\n  upsertDevice(device: DeviceInput): Promise<void>;\n  /** Forget a token (reported dead by APNs / FCM); the user it belonged to, if any. */\n  removeDevice(token: string): Promise<string | undefined>;\n  /**\n   * The user signed out on the device: the token is kept, bound to nobody, until the next sign-in\n   * binds it again. The user it belonged to, if any.\n   */\n  unbindDevice(token: string): Promise<string | undefined>;\n\n  /* ---------------------------- deployed definitions -------------------------- */\n  getSegmentCondition(id: string): Promise<ConditionIR | undefined>;\n  /** Every deployed segment with its definition: what the segment sweep evaluates. */\n  listSegments(): Promise<{ id: string; condition: ConditionIR }[]>;\n  findTriggers(event: string): Promise<TriggerRoute[]>;\n  listSegmentTriggers(): Promise<SegmentTriggerRoute[]>;\n  putWorkflowIR(workflow: WorkflowIR): Promise<void>;\n  getWorkflowIR(contentHash: string): Promise<WorkflowIR | undefined>;\n  /**\n   * Swap the routing tables (segments, event triggers, segment triggers) for\n   * the bundle's — atomically, so a concurrent ingest never sees them half\n   * empty. Workflow bodies are stored separately (`putWorkflowIR`) because they\n   * are content-addressed and outlive the routes that point at them.\n   */\n  replaceRoutes(bundle: BundleIR): Promise<void>;\n\n  /* ----------------------------- segment membership --------------------------- */\n  isSegmentMember(segment: string, userId: string): Promise<boolean>;\n  /** Record the membership, with the workflows its entry has to start (see segment_start). */\n  addSegmentMember(\n    segment: string,\n    userId: string,\n    ts: number,\n    workflows: readonly string[]\n  ): Promise<void>;\n  /** The workflows the member's entry has not started yet. */\n  pendingSegmentStarts(segment: string, userId: string): Promise<string[]>;\n  completeSegmentStart(segment: string, userId: string, workflow: string): Promise<void>;\n  /** Drop the membership and any start it still owed. */\n  removeSegmentMember(segment: string, userId: string): Promise<void>;\n\n  /* ------------------------------- entry ledger ------------------------------- */\n  /**\n   * Record the entry (the once policy). Atomic under concurrent ingests: of\n   * two racing attempts exactly one is 'entered' (or 'reclaimed', when the\n   * pair's previous instance is recorded as 'failed') and the other null.\n   */\n  enterJourney(entry: EntryInput): Promise<EntryOutcome>;\n  removeEntry(instanceId: string): Promise<void>;\n  setEntryStatus(instanceId: string, status: string): Promise<void>;\n\n  /* ------------------------------ wake subscriptions --------------------------- */\n  /** Distinct wake handles registered for (user, event). */\n  findWakeHandles(userId: string, event: string): Promise<string[]>;\n  /** Register the handle for each event; repeated registrations are idempotent. */\n  subscribe(handle: string, userId: string, events: readonly string[], ts: number): Promise<void>;\n  /** Drop every registration the handle holds. */\n  unsubscribe(handle: string): Promise<void>;\n}\n\nexport { D1JourneyStore } from './d1';\nexport { JourneyFactSource } from './facts';\nexport { PostgresJourneyStore } from './postgres';\nexport { PostgresReporting } from './postgres-reporting';\nexport {\n  DEFAULT_SCHEMA,\n  TABLES,\n  renderDrizzleSchema,\n  renderPostgresDdl,\n  type TableSpec,\n} from './tables';\nexport type { PostgresJourneyStoreOptions, SqlClientLike } from './postgres';\n"],"mappings":";;;;;;;;;;;AAgFA,IAAa,sBAAb,cAAyC,MAAM;CAGxB;CAFrB,OAAyB;CAEzB,YAAY,UAAsC;EAChD,MACE,4IAA4I,SAAS,KAAK,MAAM,GAClK;EAHmB,KAAA,WAAA;CAIrB;AACF"}

package/dist/store/index.d.cts

@@ -0,0 +1,291 @@
+import { BundleIR, ConditionIR, ScalarIR, WorkflowIR } from "../ir.cjs";
+import { PushDevice } from "../engine/ports.cjs";
+import { D1JourneyStore } from "./d1.cjs";
+import { JourneyFactSource } from "./facts.cjs";
+import { SqlClientLike } from "./sql.cjs";
+import { DEFAULT_SCHEMA, TABLES, TableSpec, renderDrizzleSchema, renderPostgresDdl } from "./tables.cjs";
+import { PostgresJourneyStore, PostgresJourneyStoreOptions } from "./postgres.cjs";
+import { PostgresReporting } from "./postgres-reporting.cjs";
+//#region src/store/index.d.ts
+/**
+ * The journey engine's data plane as a port. Everything the ingest router, the
+ * runner and the fact source persist or look up goes through this interface,
+ * so the storage engine is a deployment choice: D1 + KV (`D1JourneyStore`,
+ * the original), Postgres (`PostgresJourneyStore`), or anything else that can
+ * satisfy the contract below. Execution (durable steps, sleeps, wake-ups) is
+ * the workflow runtime's job and stays out of here.
+ *
+ * Timestamps are epoch milliseconds throughout; a store may persist them in
+ * its native type as long as `sinceMs` comparisons behave.
+ */
+/**
+ * A profile patch or a stored profile. On the way in, `null` means "remove
+ * this property" (RFC 7386 merge-patch, the only way the API has to unset
+ * one); a stored profile never contains null.
+ */
+export type ProfileProps = Record<string, ScalarIR | null | undefined>;
+export interface EventInput {
+  /** The occurrence's identity, chosen by the sender; a second insert with the same id is a no-op. */
+  id: string;
+  userId: string;
+  event: string;
+  ts: number;
+  payload: Record<string, unknown>;
+}
+export interface TriggerRoute {
+  workflow: string;
+  hash: string;
+  /** Payload gate (payload-only condition tree), or null when the trigger has none. */
+  where: ConditionIR | null;
+  /** Profile gate, or null. */
+  filter: ConditionIR | null;
+}
+export interface SegmentTriggerRoute {
+  workflow: string;
+  hash: string;
+  segment: string;
+}
+export interface EntryInput {
+  workflow: string;
+  userId: string;
+  instanceId: string;
+  hash: string;
+  ts: number;
+}
+/**
+ * How an entry attempt ended: a fresh row, a 'failed' row of a dead instance
+ * taken over (the once policy does not bar a user over one outage), or
+ * refused because the pair already entered and is still alive.
+ */
+export type EntryOutcome = 'entered' | 'reclaimed' | null;
+/** A device registered for pushes: its provider token belongs to the user who registered it last. */
+export interface DeviceInput {
+  userId: string;
+  token: string;
+  /** `ios` (APNs) or `android` (FCM): which provider the token belongs to. */
+  platform: string;
+  ts: number;
+}
+/** A store plus how to release what opening it acquired (a connection, say). */
+export interface StoreLease {
+  store: JourneyStore;
+  close?: () => Promise<void>;
+}
+/**
+ * The live database lacks tables or columns the engine reads (an SDK upgrade added them, or the
+ * host never ran the migration). Raised before a deploy writes anything.
+ */
+export declare class SchemaMismatchError extends Error {
+  readonly problems: readonly string[];
+  readonly name = "SchemaMismatchError";
+  constructor(problems: readonly string[]);
+}
+/** A message copy as reporting records it, before it goes out. */
+export interface MessageRecord {
+  idempotencyKey: string;
+  workflow: string;
+  instanceId: string;
+  nodeId: string;
+  template: string;
+  /** Where the copy lands: `email`, `push_ios`, `push_android`. */
+  channel: string;
+  userId: string;
+  sentAt: number;
+}
+/** What a click is judged by. */
+export interface ClickContext {
+  url: string;
+  deliveredAt: number;
+  linkCount: number;
+  /** The copy's clicks in the window before this one. */
+  recent: {
+    position: number;
+    at: number;
+  }[];
+}
+/** An open or a click, with the verdict on who made it and where it came from. */
+export interface Engagement {
+  at: number;
+  machine: boolean;
+  /** The rule that called it a machine; null for a person. */
+  reason: string | null;
+  userAgent: string | null;
+  /** The network the request came from (Cloudflare's `cf.asn`, `cf.asOrganization`, `cf.country`), never the address. */
+  asn: number | null;
+  organization: string | null;
+  country: string | null;
+}
+/**
+ * Journey reporting: where each instance stands, every copy and how it was engaged with, segment
+ * sizes. A store that keeps it (Postgres) exposes it as `reporting`; the Worker then records it
+ * and serves email tracking. Every write is idempotent — a retried step reports again.
+ */
+/** Bounds on when an event happened, both inclusive (epoch ms); an absent side is open. */
+export interface EventWindow {
+  sinceMs?: number;
+  untilMs?: number;
+}
+export interface JourneyReporting {
+  /** The instance entered: its row exists from here, so one a guard ends at once still counts. */
+  instanceStarted(input: {
+    workflow: string;
+    instanceId: string;
+    userId: string;
+    at: number;
+  }): Promise<void>;
+  nodeReached(input: {
+    workflow: string;
+    instanceId: string;
+    userId: string;
+    nodeId: string;
+    at: number;
+  }): Promise<void>;
+  instanceFinished(input: {
+    workflow: string;
+    instanceId: string;
+    userId: string;
+    status: string;
+    at: number;
+    convertedAt?: number;
+  }): Promise<void>;
+  /** The copy's row id; the row a retry already wrote, when there is one. */
+  recordMessage(message: MessageRecord): Promise<string>;
+  settleMessage(idempotencyKey: string, result: {
+    delivered: true;
+  } | {
+    delivered: false;
+    reason: string;
+  }, at: number): Promise<void>;
+  /** An email's tracked links, in document order. */
+  recordLinks(messageId: string, urls: readonly string[]): Promise<void>;
+  /**
+   * Record an open of the copy, judged by `judge` against the copy (its recipient and when it was
+   * delivered — when it was sent, before the transport answered); `undefined` from the judge
+   * records nothing. Read and written in one transaction. False for an unknown copy.
+   */
+  recordOpen(messageId: string, judge: (message: {
+    userId: string;
+    deliveredAt: number;
+  }) => Engagement | undefined): Promise<boolean>;
+  /**
+   * Record a click on the copy's link at `position`, judged by `judge` against the link, how
+   * many links the copy has and its clicks of the last `windowMs`. The copy is locked for the
+   * transaction, so clicks arriving together (a scanner following every link at once) are
+   * judged one after another, each seeing the ones before. When the judge asks to `backdate`,
+   * the window's earlier clicks are reclassified with this one's verdict. A click implies an
+   * open. Undefined for an unknown link.
+   */
+  recordClick(messageId: string, position: number, at: number, windowMs: number, judge: (link: ClickContext) => {
+    engagement: Engagement;
+    backdate: boolean;
+  }): Promise<{
+    url: string;
+    engagement: Engagement;
+  } | undefined>;
+  /** The email copy's recipient opted out of email: recorded on the copy and as a suppression. False for an unknown copy. */
+  recordUnsubscribe(messageId: string, at: number): Promise<boolean>;
+  /** A push copy the device reported it received. False for an unknown copy. */
+  recordDeviceDelivered(messageId: string, at: number): Promise<boolean>;
+  /** Drop members of segments no longer deployed, then record every deployed segment's size. */
+  snapshotSegments(at: number): Promise<{
+    segment: string;
+    size: number;
+  }[]>;
+}
+export interface JourneyStore {
+  /** Reporting, when the store keeps it (Postgres); D1 stores none. */
+  readonly reporting?: JourneyReporting;
+  /**
+   * Record that the user's data must go (a deleted account), before anything is erased: the
+   * request outlives a failure to stop their instances, and the sweep retries it.
+   */
+  requestErasure(userId: string, at: number): Promise<void>;
+  /** Users whose erasure was requested and not finished yet. */
+  pendingErasures(): Promise<string[]>;
+  /** The user's journey instances still running, by the entry ledger. */
+  runningInstances(userId: string): Promise<string[]>;
+  /**
+   * Erase everything kept about the user — profile, devices, events, wake subscriptions, segment
+   * memberships, suppressions, entries and reporting — and the erasure request last. Run only
+   * once no instance of theirs runs any more, or one could write some of it back.
+   */
+  forgetUser(userId: string): Promise<void>;
+  /** The user opted out of the channel (recorded by an unsubscribe); stores without reporting omit it. */
+  isSuppressed?(userId: string, channel: string): Promise<boolean>;
+  /**
+   * What the live database lacks against the engine's tables (read-only); a deploy refuses to
+   * run while it lists anything. Stores whose schema the engine owns (D1) omit it.
+   */
+  checkSchema?(): Promise<string[]>;
+  /** Append the occurrence; false when its id was already in the log (nothing written). */
+  insertEvent(input: EventInput): Promise<boolean>;
+  /** Occurrences of `event` for the user, optionally only those within the window. */
+  countEvents(userId: string, event: string, window?: EventWindow): Promise<number>;
+  /** The payloads of those occurrences — the caller filters them with the shared evaluator. */
+  listEventPayloads(userId: string, event: string, window?: EventWindow): Promise<Record<string, unknown>[]>;
+  getProfile(userId: string): Promise<ProfileProps | undefined>;
+  /**
+   * Merge-patch `props` into the stored profile in one statement (a null
+   * removes the property) and return the result. One statement, because a
+   * read-modify-write loses one of two concurrent identifies.
+   */
+  mergeProfile(userId: string, props: ProfileProps): Promise<ProfileProps>;
+  /** Every user the engine knows (a profile or an event): who the segment sweep evaluates. */
+  listUserIds(): Promise<string[]>;
+  /** The user's push devices, most recently registered first. */
+  listDevices(userId: string): Promise<PushDevice[]>;
+  /**
+   * Register a device: one row per token, so a token registered again moves to the user who
+   * registered it last (a phone signed into another account) and to the front of their list.
+   */
+  upsertDevice(device: DeviceInput): Promise<void>;
+  /** Forget a token (reported dead by APNs / FCM); the user it belonged to, if any. */
+  removeDevice(token: string): Promise<string | undefined>;
+  /**
+   * The user signed out on the device: the token is kept, bound to nobody, until the next sign-in
+   * binds it again. The user it belonged to, if any.
+   */
+  unbindDevice(token: string): Promise<string | undefined>;
+  getSegmentCondition(id: string): Promise<ConditionIR | undefined>;
+  /** Every deployed segment with its definition: what the segment sweep evaluates. */
+  listSegments(): Promise<{
+    id: string;
+    condition: ConditionIR;
+  }[]>;
+  findTriggers(event: string): Promise<TriggerRoute[]>;
+  listSegmentTriggers(): Promise<SegmentTriggerRoute[]>;
+  putWorkflowIR(workflow: WorkflowIR): Promise<void>;
+  getWorkflowIR(contentHash: string): Promise<WorkflowIR | undefined>;
+  /**
+   * Swap the routing tables (segments, event triggers, segment triggers) for
+   * the bundle's — atomically, so a concurrent ingest never sees them half
+   * empty. Workflow bodies are stored separately (`putWorkflowIR`) because they
+   * are content-addressed and outlive the routes that point at them.
+   */
+  replaceRoutes(bundle: BundleIR): Promise<void>;
+  isSegmentMember(segment: string, userId: string): Promise<boolean>;
+  /** Record the membership, with the workflows its entry has to start (see segment_start). */
+  addSegmentMember(segment: string, userId: string, ts: number, workflows: readonly string[]): Promise<void>;
+  /** The workflows the member's entry has not started yet. */
+  pendingSegmentStarts(segment: string, userId: string): Promise<string[]>;
+  completeSegmentStart(segment: string, userId: string, workflow: string): Promise<void>;
+  /** Drop the membership and any start it still owed. */
+  removeSegmentMember(segment: string, userId: string): Promise<void>;
+  /**
+   * Record the entry (the once policy). Atomic under concurrent ingests: of
+   * two racing attempts exactly one is 'entered' (or 'reclaimed', when the
+   * pair's previous instance is recorded as 'failed') and the other null.
+   */
+  enterJourney(entry: EntryInput): Promise<EntryOutcome>;
+  removeEntry(instanceId: string): Promise<void>;
+  setEntryStatus(instanceId: string, status: string): Promise<void>;
+  /** Distinct wake handles registered for (user, event). */
+  findWakeHandles(userId: string, event: string): Promise<string[]>;
+  /** Register the handle for each event; repeated registrations are idempotent. */
+  subscribe(handle: string, userId: string, events: readonly string[], ts: number): Promise<void>;
+  /** Drop every registration the handle holds. */
+  unsubscribe(handle: string): Promise<void>;
+}
+//#endregion
+export { D1JourneyStore, DEFAULT_SCHEMA, JourneyFactSource, PostgresJourneyStore, type PostgresJourneyStoreOptions, PostgresReporting, type SqlClientLike, TABLES, type TableSpec, renderDrizzleSchema, renderPostgresDdl };
+//# sourceMappingURL=index.d.cts.map

package/dist/store/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/store/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;YAoBY,eAAe,eAAe;iBAEzB;;EAEf;EACA;EACA;EACA;EACA,SAAS;;iBAGM;EACf;EACA;;EAEA,OAAO;;EAEP,QAAQ;;iBAGO;EACf;EACA;EACA;;iBAGe;EACf;EACA;EACA;EACA;EACA;;;;;;;YAQU;;iBAGK;EACf;EACA;;EAEA;EACA;;;iBAIe;EACf,OAAO;EACP,cAAc;;;;;;qBAOH,4BAA4B;WAGlB;WAFH;EAElB,YAAqB;;;iBAQN;EACf;EACA;EACA;EACA;EACA;;EAEA;EACA;EACA;;;iBAIe;EACf;EACA;EACA;;EAEA;IAAU;IAAkB;;;;iBAIb;EACf;EACA;;EAEA;EACA;;EAEA;EACA;EACA;;;;;;;;iBASe;EACf;EACA;;iBAGe;;EAEf,gBAAgB;IACd;IACA;IACA;IACA;MACE;EACJ,YAAY;IACV;IACA;IACA;IACA;IACA;MACE;EACJ,iBAAiB;IACf;IACA;IACA;IACA;IACA;IACA;MACE;;EAEJ,cAAc,SAAS,gBAAgB;EACvC,cACE,wBACA;IAAU;;IAAsB;IAAkB;KAClD,aACC;;EAEH,YAAY,mBAAmB,0BAA0B;;;;;;EAMzD,WACE,mBACA,QAAQ;IAAW;IAAgB;QAA0B,yBAC5D;;;;;;;;;EASH,YACE,mBACA,kBACA,YACA,kBACA,QAAQ,MAAM;IAAmB,YAAY;IAAY;MACxD;IAAU;IAAa,YAAY;;;EAEtC,kBAAkB,mBAAmB,aAAa;;EAElD,sBAAsB,mBAAmB,aAAa;;EAEtD,iBAAiB,aAAa;IAAU;IAAiB;;;iBAG1C;;WAEN,YAAY;;;;;EAMrB,eAAe,gBAAgB,aAAa;;EAE5C,mBAAmB;;EAEnB,iBAAiB,iBAAiB;;;;;;EAMlC,WAAW,iBAAiB;;EAG5B,cAAc,gBAAgB,kBAAkB;;;;;EAMhD,gBAAgB;;EAIhB,YAAY,OAAO,aAAa;;EAEhC,YAAY,gBAAgB,eAAe,SAAS,cAAc;;EAElE,kBACE,gBACA,eACA,SAAS,cACR,QAAQ;EAGX,WAAW,iBAAiB,QAAQ;;;;;;EAMpC,aAAa,gBAAgB,OAAO,eAAe,QAAQ;;EAG3D,eAAe;;EAIf,YAAY,iBAAiB,QAAQ;;;;;EAKrC,aAAa,QAAQ,cAAc;;EAEnC,aAAa,gBAAgB;;;;;EAK7B,aAAa,gBAAgB;EAG7B,oBAAoB,aAAa,QAAQ;;EAEzC,gBAAgB;IAAU;IAAY,WAAW;;EACjD,aAAa,gBAAgB,QAAQ;EACrC,uBAAuB,QAAQ;EAC/B,cAAc,UAAU,aAAa;EACrC,cAAc,sBAAsB,QAAQ;;;;;;;EAO5C,cAAc,QAAQ,WAAW;EAGjC,gBAAgB,iBAAiB,iBAAiB;;EAElD,iBACE,iBACA,gBACA,YACA,+BACC;;EAEH,qBAAqB,iBAAiB,iBAAiB;EACvD,qBAAqB,iBAAiB,gBAAgB,mBAAmB;;EAEzE,oBAAoB,iBAAiB,iBAAiB;;;;;;EAQtD,aAAa,OAAO,aAAa,QAAQ;EACzC,YAAY,qBAAqB;EACjC,eAAe,oBAAoB,iBAAiB;;EAIpD,gBAAgB,gBAAgB,gBAAgB;;EAEhD,UAAU,gBAAgB,gBAAgB,2BAA2B,aAAa;;EAElF,YAAY,iBAAiB"}