@shware/workflow 5.0.1 → 6.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (190) hide show
  1. package/README.md +224 -53
  2. package/dist/aws/index.cjs +1 -1
  3. package/dist/aws/index.mjs +1 -1
  4. package/dist/client.cjs +68 -4
  5. package/dist/client.cjs.map +1 -1
  6. package/dist/client.d.cts +39 -3
  7. package/dist/client.d.cts.map +1 -1
  8. package/dist/client.d.mts +39 -3
  9. package/dist/client.d.mts.map +1 -1
  10. package/dist/client.mjs +68 -4
  11. package/dist/client.mjs.map +1 -1
  12. package/dist/cloudflare/index.cjs +4 -4
  13. package/dist/cloudflare/index.mjs +4 -4
  14. package/dist/cloudflare/runner.cjs +1 -1
  15. package/dist/cloudflare/runner.d.cts +1 -1
  16. package/dist/cloudflare/runner.d.mts +1 -1
  17. package/dist/cloudflare/runner.mjs +1 -1
  18. package/dist/config.cjs +24 -3
  19. package/dist/config.cjs.map +1 -1
  20. package/dist/config.d.cts +15 -9
  21. package/dist/config.d.cts.map +1 -1
  22. package/dist/config.d.mts +15 -9
  23. package/dist/config.d.mts.map +1 -1
  24. package/dist/config.mjs +25 -4
  25. package/dist/config.mjs.map +1 -1
  26. package/dist/contract.cjs +11 -0
  27. package/dist/contract.cjs.map +1 -1
  28. package/dist/contract.d.cts +28 -7
  29. package/dist/contract.d.cts.map +1 -1
  30. package/dist/contract.d.mts +28 -7
  31. package/dist/contract.d.mts.map +1 -1
  32. package/dist/contract.mjs +11 -0
  33. package/dist/contract.mjs.map +1 -1
  34. package/dist/dsl/bundle.cjs +4 -3
  35. package/dist/dsl/bundle.cjs.map +1 -1
  36. package/dist/dsl/bundle.d.cts +5 -1
  37. package/dist/dsl/bundle.d.cts.map +1 -1
  38. package/dist/dsl/bundle.d.mts +5 -1
  39. package/dist/dsl/bundle.d.mts.map +1 -1
  40. package/dist/dsl/bundle.mjs +4 -3
  41. package/dist/dsl/bundle.mjs.map +1 -1
  42. package/dist/dsl/flow.cjs +2 -1
  43. package/dist/dsl/flow.cjs.map +1 -1
  44. package/dist/dsl/flow.d.cts +1 -1
  45. package/dist/dsl/flow.d.cts.map +1 -1
  46. package/dist/dsl/flow.d.mts +1 -1
  47. package/dist/dsl/flow.d.mts.map +1 -1
  48. package/dist/dsl/flow.mjs +2 -1
  49. package/dist/dsl/flow.mjs.map +1 -1
  50. package/dist/dsl/workflow.cjs +2 -2
  51. package/dist/dsl/workflow.mjs +2 -2
  52. package/dist/email-sender.cjs +3 -2
  53. package/dist/email-sender.cjs.map +1 -1
  54. package/dist/email-sender.d.cts +5 -4
  55. package/dist/email-sender.d.cts.map +1 -1
  56. package/dist/email-sender.d.mts +5 -4
  57. package/dist/email-sender.d.mts.map +1 -1
  58. package/dist/email-sender.mjs +3 -2
  59. package/dist/email-sender.mjs.map +1 -1
  60. package/dist/email.cjs +66 -11
  61. package/dist/email.cjs.map +1 -1
  62. package/dist/email.d.cts +72 -12
  63. package/dist/email.d.cts.map +1 -1
  64. package/dist/email.d.mts +72 -12
  65. package/dist/email.d.mts.map +1 -1
  66. package/dist/email.mjs +63 -12
  67. package/dist/email.mjs.map +1 -1
  68. package/dist/engine/condition.cjs.map +1 -1
  69. package/dist/engine/condition.d.cts.map +1 -1
  70. package/dist/engine/condition.d.mts.map +1 -1
  71. package/dist/engine/condition.mjs.map +1 -1
  72. package/dist/engine/index.cjs +1 -1
  73. package/dist/engine/index.mjs +1 -1
  74. package/dist/engine/interpreter.cjs +21 -4
  75. package/dist/engine/interpreter.cjs.map +1 -1
  76. package/dist/engine/interpreter.mjs +21 -4
  77. package/dist/engine/interpreter.mjs.map +1 -1
  78. package/dist/engine/ports.d.cts +14 -2
  79. package/dist/engine/ports.d.cts.map +1 -1
  80. package/dist/engine/ports.d.mts +14 -2
  81. package/dist/engine/ports.d.mts.map +1 -1
  82. package/dist/host/channels.cjs +1 -1
  83. package/dist/host/channels.mjs +1 -1
  84. package/dist/host/execute.cjs +2 -2
  85. package/dist/host/execute.d.cts +1 -1
  86. package/dist/host/execute.d.mts +1 -1
  87. package/dist/host/execute.mjs +2 -2
  88. package/dist/host/http.cjs +75 -5
  89. package/dist/host/http.cjs.map +1 -1
  90. package/dist/host/http.d.cts +2 -2
  91. package/dist/host/http.d.cts.map +1 -1
  92. package/dist/host/http.d.mts +2 -2
  93. package/dist/host/http.d.mts.map +1 -1
  94. package/dist/host/http.mjs +76 -6
  95. package/dist/host/http.mjs.map +1 -1
  96. package/dist/host/ingest.cjs +173 -4
  97. package/dist/host/ingest.cjs.map +1 -1
  98. package/dist/host/ingest.d.cts +99 -0
  99. package/dist/host/ingest.d.cts.map +1 -1
  100. package/dist/host/ingest.d.mts +99 -0
  101. package/dist/host/ingest.d.mts.map +1 -1
  102. package/dist/host/ingest.mjs +167 -5
  103. package/dist/host/ingest.mjs.map +1 -1
  104. package/dist/host/journey-host.cjs +10 -8
  105. package/dist/host/journey-host.cjs.map +1 -1
  106. package/dist/host/journey-host.mjs +10 -8
  107. package/dist/host/journey-host.mjs.map +1 -1
  108. package/dist/index.cjs +8 -2
  109. package/dist/index.d.cts +5 -5
  110. package/dist/index.d.mts +5 -5
  111. package/dist/index.mjs +5 -5
  112. package/dist/ir.cjs +11 -2
  113. package/dist/ir.cjs.map +1 -1
  114. package/dist/ir.d.cts +17 -0
  115. package/dist/ir.d.cts.map +1 -1
  116. package/dist/ir.d.mts +17 -0
  117. package/dist/ir.d.mts.map +1 -1
  118. package/dist/ir.mjs +11 -3
  119. package/dist/ir.mjs.map +1 -1
  120. package/dist/react-email.cjs +6 -5
  121. package/dist/react-email.cjs.map +1 -1
  122. package/dist/react-email.d.cts.map +1 -1
  123. package/dist/react-email.d.mts.map +1 -1
  124. package/dist/react-email.mjs +6 -5
  125. package/dist/react-email.mjs.map +1 -1
  126. package/dist/reporting/observer.cjs +4 -1
  127. package/dist/reporting/observer.cjs.map +1 -1
  128. package/dist/reporting/observer.d.cts +2 -1
  129. package/dist/reporting/observer.d.cts.map +1 -1
  130. package/dist/reporting/observer.d.mts +2 -1
  131. package/dist/reporting/observer.d.mts.map +1 -1
  132. package/dist/reporting/observer.mjs +4 -1
  133. package/dist/reporting/observer.mjs.map +1 -1
  134. package/dist/reporting/tracking.cjs +31 -10
  135. package/dist/reporting/tracking.cjs.map +1 -1
  136. package/dist/reporting/tracking.d.cts +15 -6
  137. package/dist/reporting/tracking.d.cts.map +1 -1
  138. package/dist/reporting/tracking.d.mts +15 -6
  139. package/dist/reporting/tracking.d.mts.map +1 -1
  140. package/dist/reporting/tracking.mjs +31 -11
  141. package/dist/reporting/tracking.mjs.map +1 -1
  142. package/dist/store/facts.cjs +3 -3
  143. package/dist/store/facts.cjs.map +1 -1
  144. package/dist/store/facts.d.cts +2 -2
  145. package/dist/store/facts.d.cts.map +1 -1
  146. package/dist/store/facts.d.mts +2 -2
  147. package/dist/store/facts.d.mts.map +1 -1
  148. package/dist/store/facts.mjs +3 -3
  149. package/dist/store/facts.mjs.map +1 -1
  150. package/dist/store/index.cjs +1 -1
  151. package/dist/store/index.cjs.map +1 -1
  152. package/dist/store/index.d.cts +44 -13
  153. package/dist/store/index.d.cts.map +1 -1
  154. package/dist/store/index.d.mts +44 -13
  155. package/dist/store/index.d.mts.map +1 -1
  156. package/dist/store/index.mjs +1 -1
  157. package/dist/store/index.mjs.map +1 -1
  158. package/dist/store/postgres-reporting.cjs +30 -10
  159. package/dist/store/postgres-reporting.cjs.map +1 -1
  160. package/dist/store/postgres-reporting.d.cts +4 -2
  161. package/dist/store/postgres-reporting.d.cts.map +1 -1
  162. package/dist/store/postgres-reporting.d.mts +4 -2
  163. package/dist/store/postgres-reporting.d.mts.map +1 -1
  164. package/dist/store/postgres-reporting.mjs +30 -10
  165. package/dist/store/postgres-reporting.mjs.map +1 -1
  166. package/dist/store/postgres.cjs +39 -3
  167. package/dist/store/postgres.cjs.map +1 -1
  168. package/dist/store/postgres.d.cts +4 -2
  169. package/dist/store/postgres.d.cts.map +1 -1
  170. package/dist/store/postgres.d.mts +4 -2
  171. package/dist/store/postgres.d.mts.map +1 -1
  172. package/dist/store/postgres.mjs +40 -4
  173. package/dist/store/postgres.mjs.map +1 -1
  174. package/dist/store/tables.cjs +75 -11
  175. package/dist/store/tables.cjs.map +1 -1
  176. package/dist/store/tables.d.cts +17 -1
  177. package/dist/store/tables.d.cts.map +1 -1
  178. package/dist/store/tables.d.mts +17 -1
  179. package/dist/store/tables.d.mts.map +1 -1
  180. package/dist/store/tables.mjs +74 -12
  181. package/dist/store/tables.mjs.map +1 -1
  182. package/dist/templates.cjs +60 -7
  183. package/dist/templates.cjs.map +1 -1
  184. package/dist/templates.d.cts +101 -13
  185. package/dist/templates.d.cts.map +1 -1
  186. package/dist/templates.d.mts +101 -13
  187. package/dist/templates.d.mts.map +1 -1
  188. package/dist/templates.mjs +61 -9
  189. package/dist/templates.mjs.map +1 -1
  190. package/package.json +1 -1
@@ -3,7 +3,7 @@ import { UserErasedError } from "./erasure.mjs";
3
3
  import { uuidv7 } from "./sql.mjs";
4
4
  import { lockUserTransaction } from "./user-lock.mjs";
5
5
  import { PostgresReporting } from "./postgres-reporting.mjs";
6
- import { DEFAULT_SCHEMA, TABLES, columnName } from "./tables.mjs";
6
+ import { DEFAULT_SCHEMA, TABLES, columnName, indexName, uniqueConstraintName } from "./tables.mjs";
7
7
  // src/store/postgres.ts
8
8
  /** information_schema's udt_name per column type. */
9
9
  const UDT = {
@@ -86,11 +86,18 @@ var PostgresJourneyStore = class {
86
86
  else if (row.is_nullable === "YES" !== (column.nullable === true)) problems.push(`column ${where}."${name}" should be ${column.nullable ? "nullable" : "NOT NULL"}`);
87
87
  }
88
88
  for (const keys of spec.uniqueIndexes ?? []) {
89
- const name = `${spec.name}_${keys.map(columnName).join("_")}_index`;
89
+ const name = indexName(spec, keys);
90
90
  const row = liveIndexes.get(`${spec.name}.${name}`);
91
91
  if (row === void 0) problems.push(`missing unique index "${this.schema}"."${name}"`);
92
92
  else if (!/^CREATE UNIQUE INDEX/i.test(row.indexdef)) problems.push(`index "${this.schema}"."${name}" is not unique`);
93
93
  }
94
+ for (const unique of spec.uniqueConstraints ?? []) {
95
+ const name = uniqueConstraintName(spec, unique);
96
+ const row = liveIndexes.get(`${spec.name}.${name}`);
97
+ if (row === void 0) problems.push(`missing unique constraint "${this.schema}"."${name}"`);
98
+ else if (!/^CREATE UNIQUE INDEX/i.test(row.indexdef)) problems.push(`index "${this.schema}"."${name}" is not unique`);
99
+ else if (!/NULLS NOT DISTINCT/i.test(row.indexdef)) problems.push(`unique constraint "${this.schema}"."${name}" must be NULLS NOT DISTINCT`);
100
+ }
94
101
  }
95
102
  return problems;
96
103
  }
@@ -258,6 +265,7 @@ var PostgresJourneyStore = class {
258
265
  this.t.subscription,
259
266
  this.t.segmentStart,
260
267
  this.t.segmentMember,
268
+ this.t.suppression,
261
269
  this.t.device,
262
270
  this.t.event,
263
271
  this.t.profile
@@ -265,8 +273,36 @@ var PostgresJourneyStore = class {
265
273
  await tx.query(`UPDATE ${this.t.erasure} SET erased_at = COALESCE(erased_at, ${TS("$2")}) WHERE user_id = $1`, [userId, at]);
266
274
  });
267
275
  }
268
- async isSuppressed(userId, channel) {
269
- return (await this.sql.query(`SELECT 1 AS x FROM ${this.t.suppression} WHERE user_id = $1 AND channel = $2`, [userId, channel])).length > 0;
276
+ async isSuppressed(userId, channel, topic) {
277
+ return (await this.sql.query(`SELECT 1 AS x FROM ${this.t.suppression}
278
+ WHERE user_id = $1 AND channel = $2 AND (topic IS NULL OR topic = $3::text)`, [
279
+ userId,
280
+ channel,
281
+ topic ?? null
282
+ ])).length > 0;
283
+ }
284
+ async listSuppressions(userId, channel) {
285
+ return (await this.sql.query(`SELECT topic FROM ${this.t.suppression} WHERE user_id = $1 AND channel = $2
286
+ ORDER BY topic NULLS FIRST`, [userId, channel])).map((row) => row.topic);
287
+ }
288
+ async updateSuppressions(userId, channel, changes, at) {
289
+ if (changes.length === 0) return;
290
+ await this.sql.transaction(async (tx) => {
291
+ await this.lockUser(tx, userId);
292
+ for (const { topic, suppressed } of changes) if (suppressed) await tx.query(`INSERT INTO ${this.t.suppression} (user_id, channel, topic, ts)
293
+ VALUES ($1, $2, $3::text, ${TS("$4")}) ON CONFLICT DO NOTHING`, [
294
+ userId,
295
+ channel,
296
+ topic,
297
+ at
298
+ ]);
299
+ else await tx.query(`DELETE FROM ${this.t.suppression}
300
+ WHERE user_id = $1 AND channel = $2 AND topic IS NOT DISTINCT FROM $3::text`, [
301
+ userId,
302
+ channel,
303
+ topic
304
+ ]);
305
+ });
270
306
  }
271
307
  async removeDevice(token) {
272
308
  return (await this.sql.query(`DELETE FROM ${this.t.device} WHERE token = $1 RETURNING user_id`, [token]))[0]?.user_id ?? void 0;
@@ -1 +1 @@
1
- {"version":3,"file":"postgres.mjs","names":[],"sources":["../../src/store/postgres.ts"],"sourcesContent":["import type { PushDevice } from '../engine/ports';\nimport { type BundleIR, ConditionIR, WorkflowIR } from '../ir';\nimport { type ErasureState, UserErasedError } from './erasure';\nimport type {\n BundleVersion,\n DeviceInput,\n EntryInput,\n EntryOutcome,\n EventInput,\n EventWindow,\n ExecutionRecord,\n ExecutionRegistry,\n ExecutionStart,\n JourneyReporting,\n JourneyStore,\n ProfileProps,\n RunningInstance,\n SegmentTriggerRoute,\n TriggerRoute,\n} from './index';\nimport { PostgresReporting } from './postgres-reporting';\nimport { type SqlClientLike, uuidv7 } from './sql';\nimport { type ColumnType, DEFAULT_SCHEMA, TABLES, type TableKey, columnName } from './tables';\nimport { lockUserTransaction } from './user-lock';\n\nexport { DEFAULT_SCHEMA } from './tables';\nexport { type SqlClientLike, uuidv7 } from './sql';\n\nexport interface PostgresJourneyStoreOptions {\n /**\n * The Postgres schema the engine's tables live in — `workflow` by default, the config's\n * `database.schema` under journeyWorker. A schema of its own keeps the tables apart from the\n * app's. The host creates them with its own migrations, from the drizzle file\n * `renderDrizzleSchema` generates (or the plain `renderPostgresDdl`).\n */\n schema?: string;\n}\n\n/** information_schema's udt_name per column type. */\nconst UDT: Record<ColumnType, string> = {\n uuid: 'uuid',\n text: 'text',\n jsonb: 'jsonb',\n timestamptz: 'timestamptz',\n integer: 'int4',\n boolean: 'bool',\n};\n\n/** Epoch milliseconds → timestamptz, so the tables keep the database's native type. */\nconst TS = (param: string) => `to_timestamp(${param}::double precision / 1000)`;\n\nfunction asJson<T>(value: unknown): T {\n return (typeof value === 'string' ? JSON.parse(value) : value) as T;\n}\n\n/**\n * The journey data plane on Postgres: native types where Postgres has them\n * (jsonb, timestamptz), and the concurrency guarantees come from the database: ON CONFLICT for the once policy and\n * idempotent subscriptions, a transaction for the route swap, a jsonb merge\n * for /identify. The tables are declared in tables.ts.\n *\n * Every write about a user is conditional on their erasure tombstone not existing\n * (`INSERT ... SELECT ... WHERE NOT EXISTS`, see `notErased`), and runs in a transaction that\n * holds the user's advisory lock (`lockUser`, the protocol in user-lock.ts): an event, a\n * profile merge, a device, a subscription, a segment membership with its starts, an entry, an\n * admission, and the reporting's instance and message rows (postgres-reporting.ts). The\n * erasure's two steps, `requestErasure` and `forgetUser`, take the same lock. Under READ\n * COMMITTED a conditional write sees only what was committed when its statement began, and an\n * erasure sees only rows committed when it looked — so without the lock a write's transaction\n * could commit its rows after the erase deleted everything (the user comes back), and a runner\n * could admit itself after the tombstone (the instance runs on). With it, every write and the\n * erasure of one user run one after another: a write either commits before the tombstone,\n * where the erasure finds and deletes it, or waits for the lock, reads the tombstone and is\n * refused (`UserErasedError`). Nothing lands after the erase, so there is no second pass. The\n * conditional statement stays the in-transaction check; a write that wrote nothing reads the\n * tombstone on that path only, to tell a refusal from a plain no-op (`refuseIfErased`).\n * Suppressions are the one exception: an opt-out is written whatever the user's state.\n */\nexport class PostgresJourneyStore implements JourneyStore {\n private readonly t: Record<TableKey, string>;\n private readonly schema: string;\n readonly reporting: JourneyReporting;\n readonly executions: ExecutionRegistry;\n\n constructor(\n private readonly sql: SqlClientLike,\n options: PostgresJourneyStoreOptions = {}\n ) {\n this.schema = options.schema ?? DEFAULT_SCHEMA;\n const qualify = (name: string) => `\"${this.schema}\".\"${name}\"`;\n this.t = Object.fromEntries(\n (Object.keys(TABLES) as TableKey[]).map((key) => [key, qualify(TABLES[key].name)])\n ) as Record<TableKey, string>;\n this.reporting = new PostgresReporting(sql, this.t, this.schema);\n this.executions = new PostgresExecutions(sql, this.t.execution, this.t.entry);\n }\n\n /**\n * What the live database lacks against tables.ts: missing tables, missing columns, a column\n * of another type or nullability, and missing unique indexes (the store's ON CONFLICT targets\n * — without one the first ingest fails, not the deploy). Read-only — the engine never migrates\n * the host's database; a deploy fails with these problems listed, and the fix is to regenerate\n * the drizzle file and run the host's migrations.\n */\n async checkSchema(): Promise<string[]> {\n // In a transaction, so Hyperdrive answers from the database, not from its read cache — a\n // deploy right after the migration must see the new columns\n const { columns, indexes } = await this.sql.transaction(async (tx) => ({\n columns: await tx.query<{\n table_name: string;\n column_name: string;\n udt_name: string;\n is_nullable: string;\n }>(\n `SELECT table_name, column_name, udt_name, is_nullable FROM information_schema.columns WHERE table_schema = $1`,\n [this.schema]\n ),\n indexes: await tx.query<{ tablename: string; indexname: string; indexdef: string }>(\n `SELECT tablename, indexname, indexdef FROM pg_indexes WHERE schemaname = $1`,\n [this.schema]\n ),\n }));\n const live = new Map(columns.map((row) => [`${row.table_name}.${row.column_name}`, row]));\n const tables = new Set(columns.map((row) => row.table_name));\n const liveIndexes = new Map(indexes.map((row) => [`${row.tablename}.${row.indexname}`, row]));\n const problems: string[] = [];\n for (const spec of Object.values(TABLES)) {\n const where = `\"${this.schema}\".\"${spec.name}\"`;\n if (!tables.has(spec.name)) {\n problems.push(`table ${where} is missing`);\n continue;\n }\n for (const [key, column] of Object.entries(spec.columns)) {\n const name = columnName(key);\n const row = live.get(`${spec.name}.${name}`);\n if (row === undefined) problems.push(`column ${where}.\"${name}\" is missing`);\n else if (row.udt_name !== UDT[column.type])\n problems.push(\n `column ${where}.\"${name}\" is ${row.udt_name}, expected ${UDT[column.type]}`\n );\n else if ((row.is_nullable === 'YES') !== (column.nullable === true))\n problems.push(\n `column ${where}.\"${name}\" should be ${column.nullable ? 'nullable' : 'NOT NULL'}`\n );\n }\n // The names drizzle-kit and renderPostgresDdl both give an unnamed unique index\n for (const keys of spec.uniqueIndexes ?? []) {\n const name = `${spec.name}_${keys.map(columnName).join('_')}_index`;\n const row = liveIndexes.get(`${spec.name}.${name}`);\n if (row === undefined) problems.push(`missing unique index \"${this.schema}\".\"${name}\"`);\n else if (!/^CREATE UNIQUE INDEX/i.test(row.indexdef))\n problems.push(`index \"${this.schema}\".\"${name}\" is not unique`);\n }\n }\n return problems;\n }\n\n async insertEvent(input: EventInput): Promise<boolean> {\n // The row key stays a UUID v7 (the house rule for every table); the\n // sender's occurrence id lives in event_id, unique per user, which is\n // what makes a second delivery a no-op. ON CONFLICT DO NOTHING + RETURNING\n // reports which of the two happened without a second round trip.\n return this.sql.transaction(async (tx) => {\n await this.lockUser(tx, input.userId);\n const rows = await tx.query(\n `INSERT INTO ${this.t.event} (id, event_id, user_id, name, ts, payload)\n SELECT $1::uuid, $2, $3, $4, ${TS('$5')}, $6::text::jsonb ${this.notErased('$3')}\n ON CONFLICT (user_id, event_id) DO NOTHING RETURNING id`,\n [\n uuidv7(input.ts),\n input.id,\n input.userId,\n input.event,\n input.ts,\n JSON.stringify(input.payload),\n ]\n );\n if (rows.length > 0) return true;\n // Nothing written: a duplicate, unless the tombstone refused it\n await this.refuseIfErased(tx, input.userId);\n return false;\n });\n }\n\n /** The condition every write about a user carries: no erasure tombstone for `$user`. */\n private notErased(user: string): string {\n return `WHERE NOT EXISTS (SELECT 1 FROM ${this.t.erasure} WHERE user_id = ${user})`;\n }\n\n /**\n * A conditional write wrote nothing: on that path only, read why. Throws when the tombstone\n * refused it; returns when the statement had another reason (a duplicate, an entry taken).\n */\n private async refuseIfErased(sql: SqlClientLike, userId: string): Promise<void> {\n const rows = await sql.query(`SELECT 1 AS x FROM ${this.t.erasure} WHERE user_id = $1`, [\n userId,\n ]);\n if (rows.length > 0) throw new UserErasedError(userId);\n }\n\n /**\n * The first two statements of every transaction that writes about the user (user-lock.ts):\n * READ COMMITTED, then the user's advisory lock, held until the transaction ends. Any read\n * about the user comes after, on a snapshot taken once the lock is held.\n */\n private lockUser(tx: SqlClientLike, userId: string): Promise<void> {\n return lockUserTransaction(tx, this.schema, userId);\n }\n\n /** The event rows of one user and name, within the window's bounds (both inclusive). */\n private eventWindow(userId: string, event: string, window?: EventWindow) {\n const params: unknown[] = [userId, event];\n let where = 'user_id = $1 AND name = $2';\n if (window?.sinceMs !== undefined) {\n params.push(window.sinceMs);\n where += ` AND ts >= ${TS(`$${params.length}`)}`;\n }\n if (window?.untilMs !== undefined) {\n params.push(window.untilMs);\n where += ` AND ts <= ${TS(`$${params.length}`)}`;\n }\n return { where, params };\n }\n\n async countEvents(userId: string, event: string, window?: EventWindow): Promise<number> {\n const { where, params } = this.eventWindow(userId, event, window);\n const rows = await this.sql.query<{ c: number | string }>(\n `SELECT count(*)::int AS c FROM ${this.t.event} WHERE ${where}`,\n params\n );\n return Number(rows.at(0)?.c ?? 0);\n }\n\n async listEventPayloads(\n userId: string,\n event: string,\n window?: EventWindow\n ): Promise<Record<string, unknown>[]> {\n const { where, params } = this.eventWindow(userId, event, window);\n const rows = await this.sql.query<{ payload: unknown }>(\n `SELECT payload FROM ${this.t.event} WHERE ${where}`,\n params\n );\n return rows.map((row) => asJson<Record<string, unknown>>(row.payload));\n }\n\n async getProfile(userId: string): Promise<ProfileProps | undefined> {\n const rows = await this.sql.query<{ props: unknown }>(\n `SELECT props FROM ${this.t.profile} WHERE user_id = $1`,\n [userId]\n );\n const row = rows.at(0);\n return row === undefined ? undefined : asJson<ProfileProps>(row.props);\n }\n\n async mergeProfile(userId: string, props: ProfileProps): Promise<ProfileProps> {\n // RFC 7386 merge-patch in one statement: jsonb `||` overwrites key by key\n // and jsonb_strip_nulls then drops the keys the patch set to null (the\n // API's only way to unset a property). Atomic in the database, so two\n // concurrent identifies cannot lose each other's keys.\n return this.sql.transaction(async (tx) => {\n await this.lockUser(tx, userId);\n const rows = await tx.query<{ props: unknown }>(\n `INSERT INTO ${this.t.profile} (user_id, props)\n SELECT $1, jsonb_strip_nulls($2::text::jsonb) ${this.notErased('$1')}\n ON CONFLICT (user_id) DO UPDATE SET props = jsonb_strip_nulls(${this.t.profile}.props || $3::text::jsonb)\n RETURNING props`,\n // EXCLUDED.props would be the stripped insert value, so the update merges the raw patch again\n [userId, JSON.stringify(props), JSON.stringify(props)]\n );\n // The upsert always yields its row — unless the tombstone refused it\n if (rows.length === 0) throw new UserErasedError(userId);\n return asJson<ProfileProps>(rows[0].props);\n });\n }\n\n async listUserIds(page?: {\n after?: string | undefined;\n limit?: number | undefined;\n }): Promise<string[]> {\n // Ascending user_id with a keyset bound, so a sweep can resume past the last id it saw\n const params: unknown[] = [];\n let where = '';\n if (page?.after !== undefined) {\n params.push(page.after);\n where = ` WHERE user_id > $${params.length}`;\n }\n let limit = '';\n if (page?.limit !== undefined) {\n params.push(page.limit);\n limit = ` LIMIT $${params.length}`;\n }\n const rows = await this.sql.query<{ user_id: string }>(\n `SELECT user_id FROM (SELECT user_id FROM ${this.t.profile} UNION SELECT user_id FROM ${this.t.event}) u${where} ORDER BY user_id${limit}`,\n params\n );\n return rows.map((row) => row.user_id);\n }\n\n listDevices(userId: string): Promise<PushDevice[]> {\n return this.sql.query<PushDevice>(\n `SELECT token, platform FROM ${this.t.device} WHERE user_id = $1 ORDER BY ts DESC`,\n [userId]\n );\n }\n\n async upsertDevice(device: DeviceInput): Promise<void> {\n await this.sql.transaction(async (tx) => {\n await this.lockUser(tx, device.userId);\n const rows = await tx.query(\n `INSERT INTO ${this.t.device} (token, user_id, platform, ts)\n SELECT $1, $2, $3, ${TS('$4')} ${this.notErased('$2')}\n ON CONFLICT (token) DO UPDATE SET user_id = EXCLUDED.user_id, platform = EXCLUDED.platform, ts = EXCLUDED.ts\n RETURNING token`,\n [device.token, device.userId, device.platform, device.ts]\n );\n if (rows.length === 0) throw new UserErasedError(device.userId);\n });\n }\n\n async requestErasure(userId: string, at: number): Promise<void> {\n // Under the user's lock: a write in flight commits before the tombstone (and is found by\n // the erase) or reads it after (and is refused)\n await this.sql.transaction(async (tx) => {\n await this.lockUser(tx, userId);\n await tx.query(\n `INSERT INTO ${this.t.erasure} (user_id, requested_at) VALUES ($1, ${TS('$2')})\n ON CONFLICT DO NOTHING`,\n [userId, at]\n );\n });\n }\n\n async pendingErasures(): Promise<string[]> {\n const rows = await this.sql.query<{ user_id: string }>(\n `SELECT user_id FROM ${this.t.erasure} WHERE erased_at IS NULL ORDER BY requested_at`\n );\n return rows.map((row) => row.user_id);\n }\n\n async erasureState(userId: string): Promise<ErasureState> {\n const rows = await this.sql.query<{ erased: boolean }>(\n `SELECT erased_at IS NOT NULL AS erased FROM ${this.t.erasure} WHERE user_id = $1`,\n [userId]\n );\n const row = rows.at(0);\n if (row === undefined) return 'none';\n return row.erased ? 'erased' : 'erasing';\n }\n\n async runningInstances(userId: string): Promise<RunningInstance[]> {\n const rows = await this.sql.query<{ instance_id: string; admitted: boolean }>(\n `SELECT instance_id, admitted_at IS NOT NULL AS admitted\n FROM ${this.t.entry} WHERE user_id = $1 AND status = 'running'`,\n [userId]\n );\n return rows.map((row) => ({ instanceId: row.instance_id, admitted: row.admitted }));\n }\n\n async admitInstance(instanceId: string, userId: string): Promise<boolean> {\n return this.sql.transaction(async (tx) => {\n await this.lockUser(tx, userId);\n // A first admission needs a running entry; an instance once admitted may replay its\n // finalisation after the entry reached a terminal status, under its own instance id (a\n // reclaim resets `admitted_at`, so a superseded attempt cannot). The first admission's\n // time is kept, the status never touched, and the tombstone refuses both.\n const rows = await tx.query(\n `UPDATE ${this.t.entry} SET admitted_at = COALESCE(admitted_at, ${TS('$3')})\n WHERE instance_id = $1 AND user_id = $2\n AND (status = 'running' OR admitted_at IS NOT NULL)\n AND NOT EXISTS (SELECT 1 FROM ${this.t.erasure} WHERE user_id = $2)\n RETURNING instance_id`,\n [instanceId, userId, Date.now()]\n );\n return rows.length > 0;\n });\n }\n\n async forgetUser(userId: string, at: number): Promise<void> {\n await this.sql.transaction(async (tx) => {\n // Under the user's lock, every row committed before the tombstone is visible from here,\n // and no write about the user can commit until this transaction ends\n await this.lockUser(tx, userId);\n // Children before the copies they belong to\n for (const child of [this.t.messageOpen, this.t.messageClick, this.t.messageLink]) {\n await tx.query(\n `DELETE FROM ${child} WHERE message_id IN (SELECT id FROM ${this.t.message} WHERE user_id = $1)`,\n [userId]\n );\n }\n for (const table of [\n this.t.message,\n this.t.instance,\n this.t.entry,\n this.t.execution,\n this.t.subscription,\n this.t.segmentStart,\n this.t.segmentMember,\n // Not suppression: an opt-out is a compliance record keyed by an opaque id, and it\n // outlives the erasure\n this.t.device,\n this.t.event,\n this.t.profile,\n ]) {\n await tx.query(`DELETE FROM ${table} WHERE user_id = $1`, [userId]);\n }\n // The tombstone stays, now marked erased; the first erase's time is kept by a repeat\n await tx.query(\n `UPDATE ${this.t.erasure} SET erased_at = COALESCE(erased_at, ${TS('$2')}) WHERE user_id = $1`,\n [userId, at]\n );\n });\n }\n\n async isSuppressed(userId: string, channel: string): Promise<boolean> {\n const rows = await this.sql.query(\n `SELECT 1 AS x FROM ${this.t.suppression} WHERE user_id = $1 AND channel = $2`,\n [userId, channel]\n );\n return rows.length > 0;\n }\n\n async removeDevice(token: string): Promise<string | undefined> {\n const rows = await this.sql.query<{ user_id: string | null }>(\n `DELETE FROM ${this.t.device} WHERE token = $1 RETURNING user_id`,\n [token]\n );\n return rows[0]?.user_id ?? undefined;\n }\n\n async unbindDevice(token: string): Promise<string | undefined> {\n // The owner as it was before the update: RETURNING alone would only show the null\n const rows = await this.sql.query<{ user_id: string | null }>(\n `WITH old AS (SELECT token, user_id FROM ${this.t.device} WHERE token = $1 FOR UPDATE)\n UPDATE ${this.t.device} d SET user_id = NULL FROM old WHERE d.token = old.token\n RETURNING old.user_id`,\n [token]\n );\n return rows[0]?.user_id ?? undefined;\n }\n\n async listSegments(): Promise<{ id: string; condition: ConditionIR }[]> {\n const rows = await this.sql.query<{ id: string; condition: unknown }>(\n `SELECT id, condition FROM ${this.t.segment} ORDER BY id`\n );\n return rows.map((row) => ({\n id: row.id,\n condition: ConditionIR.parse(asJson(row.condition)),\n }));\n }\n\n async getSegmentCondition(id: string): Promise<ConditionIR | undefined> {\n const rows = await this.sql.query<{ condition: unknown }>(\n `SELECT condition FROM ${this.t.segment} WHERE id = $1`,\n [id]\n );\n const row = rows.at(0);\n return row === undefined ? undefined : ConditionIR.parse(asJson(row.condition));\n }\n\n async findTriggers(event: string): Promise<TriggerRoute[]> {\n const rows = await this.sql.query<{\n workflow: string;\n hash: string;\n where_clause: unknown;\n filter: unknown;\n version: string | null;\n }>(\n `SELECT workflow, hash, \"where\" AS where_clause, filter, version FROM ${this.t.trigger} WHERE event = $1`,\n [event]\n );\n return rows.map((row) => ({\n workflow: row.workflow,\n hash: row.hash,\n where: row.where_clause === null ? null : ConditionIR.parse(asJson(row.where_clause)),\n filter: row.filter === null ? null : ConditionIR.parse(asJson(row.filter)),\n version: row.version ?? undefined,\n }));\n }\n\n async listSegmentTriggers(): Promise<SegmentTriggerRoute[]> {\n const rows = await this.sql.query<{\n workflow: string;\n hash: string;\n segment: string;\n version: string | null;\n }>(`SELECT workflow, hash, segment, version FROM ${this.t.segmentTrigger}`);\n return rows.map((row) => ({\n workflow: row.workflow,\n hash: row.hash,\n segment: row.segment,\n version: row.version ?? undefined,\n }));\n }\n\n async putWorkflowIR(workflow: WorkflowIR): Promise<void> {\n await this.sql.query(\n `INSERT INTO ${this.t.ir} (content_hash, ir) VALUES ($1, $2::text::jsonb)\n ON CONFLICT (content_hash) DO UPDATE SET ir = EXCLUDED.ir`,\n [workflow.contentHash, JSON.stringify(workflow)]\n );\n }\n\n async getWorkflowIR(contentHash: string): Promise<WorkflowIR | undefined> {\n const rows = await this.sql.query<{ ir: unknown }>(\n `SELECT ir FROM ${this.t.ir} WHERE content_hash = $1`,\n [contentHash]\n );\n const row = rows.at(0);\n return row === undefined ? undefined : WorkflowIR.parse(asJson(row.ir));\n }\n\n replaceRoutes(bundle: BundleIR): Promise<void> {\n return this.sql.transaction((tx) => this.swapRoutes(tx, bundle));\n }\n\n async liveBundleVersion(): Promise<BundleVersion | undefined> {\n // In a transaction, so Hyperdrive answers from the database, not from its read cache\n const rows = await this.sql.transaction((tx) =>\n tx.query<{ version_id: string; created_at: number | string }>(\n `SELECT version_id, (extract(epoch FROM version_created_at) * 1000)::double precision AS created_at\n FROM ${this.t.deployment} WHERE scope = 'routes'`\n )\n );\n const row = rows.at(0);\n return row === undefined\n ? undefined\n : { id: row.version_id, createdAt: Number(row.created_at) };\n }\n\n replaceRoutesIfNewer(bundle: BundleIR, version: BundleVersion): Promise<boolean> {\n return this.sql.transaction(async (tx) => {\n // The row lock decides between versions applying at once: the loser's WHERE re-reads the\n // winner's committed row and updates nothing\n const claimed = await tx.query(\n `INSERT INTO ${this.t.deployment} AS live (scope, version_id, version_created_at, applied_at)\n VALUES ('routes', $1, ${TS('$2')}, ${TS('$3')})\n ON CONFLICT (scope) DO UPDATE SET version_id = EXCLUDED.version_id,\n version_created_at = EXCLUDED.version_created_at, applied_at = EXCLUDED.applied_at\n WHERE live.version_created_at < EXCLUDED.version_created_at\n RETURNING scope`,\n [version.id, version.createdAt, Date.now()]\n );\n if (claimed.length === 0) return false;\n await this.swapRoutes(tx, bundle, version.id);\n return true;\n });\n }\n\n /** `version`: the code version applying the bundle, kept on every route it writes. */\n private async swapRoutes(tx: SqlClientLike, bundle: BundleIR, version?: string): Promise<void> {\n await tx.query(`DELETE FROM ${this.t.trigger}`);\n await tx.query(`DELETE FROM ${this.t.segmentTrigger}`);\n await tx.query(`DELETE FROM ${this.t.segment}`);\n for (const segment of bundle.segments) {\n await tx.query(\n `INSERT INTO ${this.t.segment} (id, condition, hash) VALUES ($1, $2::text::jsonb, $3)`,\n [segment.id, JSON.stringify(segment.condition), segment.contentHash]\n );\n }\n for (const workflow of bundle.workflows) {\n if (workflow.trigger.type === 'event') {\n await tx.query(\n `INSERT INTO ${this.t.trigger} (workflow, hash, event, \"where\", filter, version) VALUES ($1, $2, $3, $4::text::jsonb, $5::text::jsonb, $6)`,\n [\n workflow.id,\n workflow.contentHash,\n workflow.trigger.event,\n workflow.trigger.where === undefined ? null : JSON.stringify(workflow.trigger.where),\n workflow.trigger.filter === undefined ? null : JSON.stringify(workflow.trigger.filter),\n version ?? null,\n ]\n );\n } else if (workflow.trigger.type === 'segment') {\n await tx.query(\n `INSERT INTO ${this.t.segmentTrigger} (workflow, hash, segment, version) VALUES ($1, $2, $3, $4)`,\n [workflow.id, workflow.contentHash, workflow.trigger.segment, version ?? null]\n );\n }\n }\n }\n\n async isSegmentMember(segment: string, userId: string): Promise<boolean> {\n const rows = await this.sql.query(\n `SELECT 1 AS x FROM ${this.t.segmentMember} WHERE segment = $1 AND user_id = $2`,\n [segment, userId]\n );\n return rows.length > 0;\n }\n\n async addSegmentMember(\n segment: string,\n userId: string,\n ts: number,\n workflows: readonly string[]\n ): Promise<void> {\n // One locked transaction: the membership and the starts it owes commit together\n await this.sql.transaction(async (tx) => {\n await this.lockUser(tx, userId);\n const member = await tx.query(\n `INSERT INTO ${this.t.segmentMember} (segment, user_id, ts)\n SELECT $1, $2, ${TS('$3')} ${this.notErased('$2')}\n ON CONFLICT DO NOTHING RETURNING segment`,\n [segment, userId, ts]\n );\n // Already a member, or refused: either way the starts below write nothing new\n if (member.length === 0) await this.refuseIfErased(tx, userId);\n for (const workflow of workflows) {\n await tx.query(\n `INSERT INTO ${this.t.segmentStart} (segment, workflow, user_id, ts)\n SELECT $1, $2, $3, ${TS('$4')} ${this.notErased('$3')}\n ON CONFLICT DO NOTHING`,\n [segment, workflow, userId, ts]\n );\n }\n });\n }\n\n async pendingSegmentStarts(segment: string, userId: string): Promise<string[]> {\n const rows = await this.sql.query<{ workflow: string }>(\n `SELECT workflow FROM ${this.t.segmentStart} WHERE segment = $1 AND user_id = $2`,\n [segment, userId]\n );\n return rows.map((row) => row.workflow);\n }\n\n async completeSegmentStart(segment: string, userId: string, workflow: string): Promise<void> {\n await this.sql.query(\n `DELETE FROM ${this.t.segmentStart} WHERE segment = $1 AND user_id = $2 AND workflow = $3`,\n [segment, userId, workflow]\n );\n }\n\n async removeSegmentMember(segment: string, userId: string): Promise<void> {\n await this.sql.transaction(async (tx) => {\n await tx.query(`DELETE FROM ${this.t.segmentStart} WHERE segment = $1 AND user_id = $2`, [\n segment,\n userId,\n ]);\n await tx.query(`DELETE FROM ${this.t.segmentMember} WHERE segment = $1 AND user_id = $2`, [\n segment,\n userId,\n ]);\n });\n }\n\n async enterJourney(entry: EntryInput): Promise<EntryOutcome> {\n const { execution } = entry;\n // One transaction under the user's lock: the claim (or reclaim) and the start it owes commit\n // together — a crash between them would leave a running entry no retry could ever start —\n // and before or after an erasure of the user, never astride it\n return this.sql.transaction(async (tx) => {\n await this.lockUser(tx, entry.userId);\n const outcome = await this.claimEntry(tx, entry);\n if (outcome !== null && execution !== undefined) {\n await this.recordStart(tx, entry, execution);\n }\n return outcome;\n });\n }\n\n private async claimEntry(sql: SqlClientLike, entry: EntryInput): Promise<EntryOutcome> {\n // The (workflow, user_id) primary key makes the once policy atomic:\n // concurrent ingests race on the insert and exactly one wins.\n const inserted = await sql.query(\n `INSERT INTO ${this.t.entry} (workflow, user_id, instance_id, hash, status, ts)\n SELECT $1, $2, $3, $4, 'running', ${TS('$5')} ${this.notErased('$2')}\n ON CONFLICT (workflow, user_id) DO NOTHING RETURNING instance_id`,\n [entry.workflow, entry.userId, entry.instanceId, entry.hash, entry.ts]\n );\n if (inserted.length > 0) return 'entered';\n\n // An existing row blocks the entry unless it records an instance that died:\n // 'failed' is reclaimed rather than barring the user forever over one\n // outage. The status test is inside the UPDATE, so of two concurrent\n // retries exactly one gets a row back. The reclaim is a new attempt: it\n // starts unadmitted, even under the same instance id, so the previous\n // attempt's admission is not inherited (`runningInstances` would report a\n // runner that has not been created yet).\n const claimed = await sql.query(\n `UPDATE ${this.t.entry} SET instance_id = $1, hash = $2, status = 'running', ts = ${TS('$3')},\n admitted_at = NULL\n WHERE workflow = $4 AND user_id = $5 AND status = 'failed'\n AND NOT EXISTS (SELECT 1 FROM ${this.t.erasure} WHERE user_id = $5)\n RETURNING instance_id`,\n [entry.instanceId, entry.hash, entry.ts, entry.workflow, entry.userId]\n );\n if (claimed.length > 0) return 'reclaimed';\n // Taken by a live instance, or refused by the tombstone: tell them apart\n await this.refuseIfErased(sql, entry.userId);\n return null;\n }\n\n /**\n * Only an entry this call claimed records a start, so a row already there is a previous\n * attempt's — a failed entry reclaimed under the same instance id (an event replayed with its\n * ts). It is replaced whole: the new attempt's name and payload, nothing submitted yet.\n */\n private async recordStart(\n tx: SqlClientLike,\n entry: EntryInput,\n execution: ExecutionStart\n ): Promise<void> {\n const rows = await tx.query(\n `INSERT INTO ${this.t.execution} (instance_id, workflow, user_id, name, target, input, created_at, generation)\n SELECT $1, $2, $3, $4, $5, $6, ${TS('$7')}, 0 ${this.notErased('$3')}\n ON CONFLICT (instance_id) DO UPDATE SET\n name = EXCLUDED.name, target = EXCLUDED.target, input = EXCLUDED.input,\n created_at = EXCLUDED.created_at, generation = 0, submitted_at = NULL, arn = NULL,\n unresolved_at = NULL, callback_id = NULL, deadline_at = NULL, checked_at = NULL,\n stopped_at = NULL\n RETURNING instance_id`,\n [\n entry.instanceId,\n entry.workflow,\n entry.userId,\n execution.name,\n execution.target,\n execution.input,\n // The start's own age (the retry budget), not the event's ts, which the producer chose\n Date.now(),\n ]\n );\n // Refused between the claim and this: the throw rolls the claimed entry back with it\n if (rows.length === 0) throw new UserErasedError(entry.userId);\n }\n\n async removeEntry(instanceId: string): Promise<void> {\n await this.sql.query(`DELETE FROM ${this.t.entry} WHERE instance_id = $1`, [instanceId]);\n }\n\n async setEntryStatus(instanceId: string, status: string): Promise<void> {\n await this.sql.query(`UPDATE ${this.t.entry} SET status = $1 WHERE instance_id = $2`, [\n status,\n instanceId,\n ]);\n }\n\n async findWakeHandles(userId: string, event: string): Promise<string[]> {\n const rows = await this.sql.query<{ handle: string }>(\n `SELECT DISTINCT wake_handle AS handle FROM ${this.t.subscription} WHERE user_id = $1 AND event = $2`,\n [userId, event]\n );\n return rows.map((row) => row.handle);\n }\n\n async subscribe(\n handle: string,\n userId: string,\n events: readonly string[],\n ts: number\n ): Promise<void> {\n // One locked transaction for the call's registrations: all of them, or none\n await this.sql.transaction(async (tx) => {\n await this.lockUser(tx, userId);\n let skipped = false;\n for (const event of events) {\n const rows = await tx.query(\n `INSERT INTO ${this.t.subscription} (user_id, event, wake_handle, ts)\n SELECT $1, $2, $3, ${TS('$4')} ${this.notErased('$1')}\n ON CONFLICT DO NOTHING RETURNING event`,\n [userId, event, handle, ts]\n );\n if (rows.length === 0) skipped = true;\n }\n // A registration already there, or refused: one read tells which\n if (skipped) await this.refuseIfErased(tx, userId);\n });\n }\n\n async unsubscribe(handle: string): Promise<void> {\n await this.sql.query(`DELETE FROM ${this.t.subscription} WHERE wake_handle = $1`, [handle]);\n }\n}\n\ninterface ExecutionRow {\n instance_id: string;\n workflow: string;\n user_id: string;\n name: string;\n target: string;\n input: string;\n // float8 comes back as a number from most drivers, as a string from some\n created_at: number | string;\n submitted_at: number | string | null;\n arn: string | null;\n unresolved_at: number | string | null;\n callback_id: string | null;\n generation: number | string;\n deadline_at: number | string | null;\n checked_at: number | string | null;\n stopped_at: number | string | null;\n}\n\nconst PLAIN_COLUMNS = ['instance_id', 'workflow', 'user_id', 'name', 'target', 'input', 'arn'];\nconst MORE_PLAIN = ['callback_id', 'generation'];\nconst TIME_COLUMNS = [\n 'created_at',\n 'submitted_at',\n 'unresolved_at',\n 'deadline_at',\n 'checked_at',\n 'stopped_at',\n];\n\n/** The execution columns, timestamps as epoch ms; `alias` qualifies them in a join. */\nfunction executionColumns(alias = ''): string {\n const q = alias === '' ? '' : `${alias}.`;\n return [\n ...[...PLAIN_COLUMNS, ...MORE_PLAIN].map((column) => `${q}${column}`),\n ...TIME_COLUMNS.map(\n (column) => `(extract(epoch from ${q}${column}) * 1000)::double precision AS ${column}`\n ),\n ].join(', ');\n}\n\nconst optional = <T>(value: T | null): T | undefined => value ?? undefined;\nconst ms = (value: number | string | null): number | undefined =>\n value === null ? undefined : Number(value);\n\nfunction toRecord(row: ExecutionRow): ExecutionRecord {\n return {\n instanceId: row.instance_id,\n workflow: row.workflow,\n userId: row.user_id,\n name: row.name,\n target: row.target,\n input: row.input,\n createdAt: Number(row.created_at),\n submittedAt: ms(row.submitted_at),\n arn: optional(row.arn),\n unresolvedAt: ms(row.unresolved_at),\n callbackId: optional(row.callback_id),\n generation: Number(row.generation),\n deadlineAt: ms(row.deadline_at),\n checkedAt: ms(row.checked_at),\n stoppedAt: ms(row.stopped_at),\n };\n}\n\n/** The execution table (tables.ts): starts to confirm, and the callback each wait parks on. */\nclass PostgresExecutions implements ExecutionRegistry {\n constructor(\n private readonly sql: SqlClientLike,\n private readonly table: string,\n private readonly entry: string\n ) {}\n\n async get(instanceId: string): Promise<ExecutionRecord | undefined> {\n const rows = await this.sql.query<ExecutionRow>(\n `SELECT ${executionColumns()} FROM ${this.table} WHERE instance_id = $1`,\n [instanceId]\n );\n return rows.length === 0 ? undefined : toRecord(rows[0]);\n }\n\n async pendingStarts(filter: {\n workflow?: string;\n userId?: string;\n createdBefore?: number;\n limit: number;\n }): Promise<ExecutionRecord[]> {\n const where = ['x.submitted_at IS NULL', 'x.unresolved_at IS NULL', \"e.status = 'running'\"];\n const params: unknown[] = [];\n if (filter.workflow !== undefined) {\n params.push(filter.workflow);\n where.push(`x.workflow = $${params.length}`);\n }\n if (filter.userId !== undefined) {\n params.push(filter.userId);\n where.push(`x.user_id = $${params.length}`);\n }\n if (filter.createdBefore !== undefined) {\n params.push(filter.createdBefore);\n where.push(`x.created_at < ${TS(`$${params.length}`)}`);\n }\n params.push(filter.limit);\n // Only the start the entry still names: a reclaimed entry's old start is history\n const rows = await this.sql.query<ExecutionRow>(\n `SELECT ${executionColumns('x')}\n FROM ${this.table} x JOIN ${this.entry} e ON e.instance_id = x.instance_id\n WHERE ${where.join(' AND ')} ORDER BY x.created_at LIMIT $${params.length}`,\n params\n );\n return rows.map(toRecord);\n }\n\n async markSubmitted(instanceId: string, arn: string | undefined, at: number): Promise<void> {\n await this.sql.query(\n `UPDATE ${this.table} SET submitted_at = COALESCE(submitted_at, ${TS('$2')}), arn = COALESCE($3, arn) WHERE instance_id = $1`,\n [instanceId, at, arn ?? null]\n );\n }\n\n async markUnresolved(instanceId: string, at: number): Promise<void> {\n await this.sql.query(\n `UPDATE ${this.table} SET unresolved_at = ${TS('$2')} WHERE instance_id = $1 AND submitted_at IS NULL`,\n [instanceId, at]\n );\n }\n\n async setArn(instanceId: string, arn: string): Promise<void> {\n await this.sql.query(`UPDATE ${this.table} SET arn = $2 WHERE instance_id = $1`, [\n instanceId,\n arn,\n ]);\n }\n\n async armCallback(\n instanceId: string,\n callback: { id: string; generation: number; deadlineAt?: number | undefined }\n ): Promise<boolean> {\n // The generation test is inside the UPDATE: a retried arm of an older wait cannot overwrite\n // the callback a newer one parks on\n const rows = await this.sql.query(\n `UPDATE ${this.table} SET callback_id = $2, generation = $3,\n deadline_at = CASE WHEN $4::double precision IS NULL THEN NULL ELSE ${TS('$4')} END\n WHERE instance_id = $1 AND generation <= $3 RETURNING instance_id`,\n [instanceId, callback.id, callback.generation, callback.deadlineAt ?? null]\n );\n return rows.length > 0;\n }\n\n async clearCallback(instanceId: string, generation: number): Promise<void> {\n await this.sql.query(\n `UPDATE ${this.table} SET callback_id = NULL, deadline_at = NULL WHERE instance_id = $1 AND generation = $2`,\n [instanceId, generation]\n );\n }\n\n async toReconcile(limit: number, checkedBefore: number): Promise<ExecutionRecord[]> {\n const rows = await this.sql.query<ExecutionRow>(\n `SELECT ${executionColumns('x')}\n FROM ${this.table} x JOIN ${this.entry} e ON e.instance_id = x.instance_id\n WHERE e.status = 'running' AND x.submitted_at IS NOT NULL\n AND (x.checked_at IS NULL OR x.checked_at < ${TS('$1')})\n ORDER BY x.checked_at NULLS FIRST LIMIT $2`,\n [checkedBefore, limit]\n );\n return rows.map(toRecord);\n }\n\n async markStopped(instanceId: string, at: number): Promise<void> {\n await this.sql.query(\n `UPDATE ${this.table} SET stopped_at = COALESCE(stopped_at, ${TS('$2')}) WHERE instance_id = $1`,\n [instanceId, at]\n );\n }\n\n async markChecked(instanceId: string, at: number): Promise<void> {\n await this.sql.query(\n `UPDATE ${this.table} SET checked_at = ${TS('$2')} WHERE instance_id = $1`,\n [instanceId, at]\n );\n }\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"postgres.mjs","names":[],"sources":["../../src/store/postgres.ts"],"sourcesContent":["import type { PushDevice } from '../engine/ports';\nimport { type BundleIR, ConditionIR, WorkflowIR } from '../ir';\nimport { type ErasureState, UserErasedError } from './erasure';\nimport type {\n BundleVersion,\n DeviceInput,\n EntryInput,\n EntryOutcome,\n EventInput,\n EventWindow,\n ExecutionRecord,\n ExecutionRegistry,\n ExecutionStart,\n JourneyReporting,\n JourneyStore,\n ProfileProps,\n RunningInstance,\n SegmentTriggerRoute,\n SuppressionChange,\n TriggerRoute,\n} from './index';\nimport { PostgresReporting } from './postgres-reporting';\nimport { type SqlClientLike, uuidv7 } from './sql';\nimport {\n type ColumnType,\n DEFAULT_SCHEMA,\n TABLES,\n type TableKey,\n columnName,\n indexName,\n uniqueConstraintName,\n} from './tables';\nimport { lockUserTransaction } from './user-lock';\n\nexport { DEFAULT_SCHEMA } from './tables';\nexport { type SqlClientLike, uuidv7 } from './sql';\n\nexport interface PostgresJourneyStoreOptions {\n /**\n * The Postgres schema the engine's tables live in — `workflow` by default, the config's\n * `database.schema` under journeyWorker. A schema of its own keeps the tables apart from the\n * app's. The host creates them with its own migrations, from the drizzle file\n * `renderDrizzleSchema` generates (or the plain `renderPostgresDdl`).\n */\n schema?: string;\n}\n\n/** information_schema's udt_name per column type. */\nconst UDT: Record<ColumnType, string> = {\n uuid: 'uuid',\n text: 'text',\n jsonb: 'jsonb',\n timestamptz: 'timestamptz',\n integer: 'int4',\n boolean: 'bool',\n};\n\n/** Epoch milliseconds → timestamptz, so the tables keep the database's native type. */\nconst TS = (param: string) => `to_timestamp(${param}::double precision / 1000)`;\n\nfunction asJson<T>(value: unknown): T {\n return (typeof value === 'string' ? JSON.parse(value) : value) as T;\n}\n\n/**\n * The journey data plane on Postgres: native types where Postgres has them\n * (jsonb, timestamptz), and the concurrency guarantees come from the database: ON CONFLICT for the once policy and\n * idempotent subscriptions, a transaction for the route swap, a jsonb merge\n * for /identify. The tables are declared in tables.ts.\n *\n * Every write about a user is conditional on their erasure tombstone not existing\n * (`INSERT ... SELECT ... WHERE NOT EXISTS`, see `notErased`), and runs in a transaction that\n * holds the user's advisory lock (`lockUser`, the protocol in user-lock.ts): an event, a\n * profile merge, a device, a subscription, a segment membership with its starts, an entry, an\n * admission, and the reporting's instance and message rows (postgres-reporting.ts). The\n * erasure's two steps, `requestErasure` and `forgetUser`, take the same lock. Under READ\n * COMMITTED a conditional write sees only what was committed when its statement began, and an\n * erasure sees only rows committed when it looked — so without the lock a write's transaction\n * could commit its rows after the erase deleted everything (the user comes back), and a runner\n * could admit itself after the tombstone (the instance runs on). With it, every write and the\n * erasure of one user run one after another: a write either commits before the tombstone,\n * where the erasure finds and deletes it, or waits for the lock, reads the tombstone and is\n * refused (`UserErasedError`). Nothing lands after the erase, so there is no second pass. The\n * conditional statement stays the in-transaction check; a write that wrote nothing reads the\n * tombstone on that path only, to tell a refusal from a plain no-op (`refuseIfErased`).\n * Suppressions are the one exception: an opt-out is written whatever the user's state.\n */\nexport class PostgresJourneyStore implements JourneyStore {\n private readonly t: Record<TableKey, string>;\n private readonly schema: string;\n readonly reporting: JourneyReporting;\n readonly executions: ExecutionRegistry;\n\n constructor(\n private readonly sql: SqlClientLike,\n options: PostgresJourneyStoreOptions = {}\n ) {\n this.schema = options.schema ?? DEFAULT_SCHEMA;\n const qualify = (name: string) => `\"${this.schema}\".\"${name}\"`;\n this.t = Object.fromEntries(\n (Object.keys(TABLES) as TableKey[]).map((key) => [key, qualify(TABLES[key].name)])\n ) as Record<TableKey, string>;\n this.reporting = new PostgresReporting(sql, this.t, this.schema);\n this.executions = new PostgresExecutions(sql, this.t.execution, this.t.entry);\n }\n\n /**\n * What the live database lacks against tables.ts: missing tables, missing columns, a column\n * of another type or nullability, and missing unique indexes (the store's ON CONFLICT targets\n * — without one the first ingest fails, not the deploy). Read-only — the engine never migrates\n * the host's database; a deploy fails with these problems listed, and the fix is to regenerate\n * the drizzle file and run the host's migrations.\n */\n async checkSchema(): Promise<string[]> {\n // In a transaction, so Hyperdrive answers from the database, not from its read cache — a\n // deploy right after the migration must see the new columns\n const { columns, indexes } = await this.sql.transaction(async (tx) => ({\n columns: await tx.query<{\n table_name: string;\n column_name: string;\n udt_name: string;\n is_nullable: string;\n }>(\n `SELECT table_name, column_name, udt_name, is_nullable FROM information_schema.columns WHERE table_schema = $1`,\n [this.schema]\n ),\n indexes: await tx.query<{ tablename: string; indexname: string; indexdef: string }>(\n `SELECT tablename, indexname, indexdef FROM pg_indexes WHERE schemaname = $1`,\n [this.schema]\n ),\n }));\n const live = new Map(columns.map((row) => [`${row.table_name}.${row.column_name}`, row]));\n const tables = new Set(columns.map((row) => row.table_name));\n const liveIndexes = new Map(indexes.map((row) => [`${row.tablename}.${row.indexname}`, row]));\n const problems: string[] = [];\n for (const spec of Object.values(TABLES)) {\n const where = `\"${this.schema}\".\"${spec.name}\"`;\n if (!tables.has(spec.name)) {\n problems.push(`table ${where} is missing`);\n continue;\n }\n for (const [key, column] of Object.entries(spec.columns)) {\n const name = columnName(key);\n const row = live.get(`${spec.name}.${name}`);\n if (row === undefined) problems.push(`column ${where}.\"${name}\" is missing`);\n else if (row.udt_name !== UDT[column.type])\n problems.push(\n `column ${where}.\"${name}\" is ${row.udt_name}, expected ${UDT[column.type]}`\n );\n else if ((row.is_nullable === 'YES') !== (column.nullable === true))\n problems.push(\n `column ${where}.\"${name}\" should be ${column.nullable ? 'nullable' : 'NOT NULL'}`\n );\n }\n // The names drizzle-kit and renderPostgresDdl both give an unnamed unique index\n for (const keys of spec.uniqueIndexes ?? []) {\n const name = indexName(spec, keys);\n const row = liveIndexes.get(`${spec.name}.${name}`);\n if (row === undefined) problems.push(`missing unique index \"${this.schema}\".\"${name}\"`);\n else if (!/^CREATE UNIQUE INDEX/i.test(row.indexdef))\n problems.push(`index \"${this.schema}\".\"${name}\" is not unique`);\n }\n // A unique constraint is backed by an index of its name; its definition says how nulls compare\n for (const unique of spec.uniqueConstraints ?? []) {\n const name = uniqueConstraintName(spec, unique);\n const row = liveIndexes.get(`${spec.name}.${name}`);\n if (row === undefined) {\n problems.push(`missing unique constraint \"${this.schema}\".\"${name}\"`);\n } else if (!/^CREATE UNIQUE INDEX/i.test(row.indexdef)) {\n problems.push(`index \"${this.schema}\".\"${name}\" is not unique`);\n } else if (!/NULLS NOT DISTINCT/i.test(row.indexdef)) {\n problems.push(`unique constraint \"${this.schema}\".\"${name}\" must be NULLS NOT DISTINCT`);\n }\n }\n }\n return problems;\n }\n\n async insertEvent(input: EventInput): Promise<boolean> {\n // The row key stays a UUID v7 (the house rule for every table); the\n // sender's occurrence id lives in event_id, unique per user, which is\n // what makes a second delivery a no-op. ON CONFLICT DO NOTHING + RETURNING\n // reports which of the two happened without a second round trip.\n return this.sql.transaction(async (tx) => {\n await this.lockUser(tx, input.userId);\n const rows = await tx.query(\n `INSERT INTO ${this.t.event} (id, event_id, user_id, name, ts, payload)\n SELECT $1::uuid, $2, $3, $4, ${TS('$5')}, $6::text::jsonb ${this.notErased('$3')}\n ON CONFLICT (user_id, event_id) DO NOTHING RETURNING id`,\n [\n uuidv7(input.ts),\n input.id,\n input.userId,\n input.event,\n input.ts,\n JSON.stringify(input.payload),\n ]\n );\n if (rows.length > 0) return true;\n // Nothing written: a duplicate, unless the tombstone refused it\n await this.refuseIfErased(tx, input.userId);\n return false;\n });\n }\n\n /** The condition every write about a user carries: no erasure tombstone for `$user`. */\n private notErased(user: string): string {\n return `WHERE NOT EXISTS (SELECT 1 FROM ${this.t.erasure} WHERE user_id = ${user})`;\n }\n\n /**\n * A conditional write wrote nothing: on that path only, read why. Throws when the tombstone\n * refused it; returns when the statement had another reason (a duplicate, an entry taken).\n */\n private async refuseIfErased(sql: SqlClientLike, userId: string): Promise<void> {\n const rows = await sql.query(`SELECT 1 AS x FROM ${this.t.erasure} WHERE user_id = $1`, [\n userId,\n ]);\n if (rows.length > 0) throw new UserErasedError(userId);\n }\n\n /**\n * The first two statements of every transaction that writes about the user (user-lock.ts):\n * READ COMMITTED, then the user's advisory lock, held until the transaction ends. Any read\n * about the user comes after, on a snapshot taken once the lock is held.\n */\n private lockUser(tx: SqlClientLike, userId: string): Promise<void> {\n return lockUserTransaction(tx, this.schema, userId);\n }\n\n /** The event rows of one user and name, within the window's bounds (both inclusive). */\n private eventWindow(userId: string, event: string, window?: EventWindow) {\n const params: unknown[] = [userId, event];\n let where = 'user_id = $1 AND name = $2';\n if (window?.sinceMs !== undefined) {\n params.push(window.sinceMs);\n where += ` AND ts >= ${TS(`$${params.length}`)}`;\n }\n if (window?.untilMs !== undefined) {\n params.push(window.untilMs);\n where += ` AND ts <= ${TS(`$${params.length}`)}`;\n }\n return { where, params };\n }\n\n async countEvents(userId: string, event: string, window?: EventWindow): Promise<number> {\n const { where, params } = this.eventWindow(userId, event, window);\n const rows = await this.sql.query<{ c: number | string }>(\n `SELECT count(*)::int AS c FROM ${this.t.event} WHERE ${where}`,\n params\n );\n return Number(rows.at(0)?.c ?? 0);\n }\n\n async listEventPayloads(\n userId: string,\n event: string,\n window?: EventWindow\n ): Promise<Record<string, unknown>[]> {\n const { where, params } = this.eventWindow(userId, event, window);\n const rows = await this.sql.query<{ payload: unknown }>(\n `SELECT payload FROM ${this.t.event} WHERE ${where}`,\n params\n );\n return rows.map((row) => asJson<Record<string, unknown>>(row.payload));\n }\n\n async getProfile(userId: string): Promise<ProfileProps | undefined> {\n const rows = await this.sql.query<{ props: unknown }>(\n `SELECT props FROM ${this.t.profile} WHERE user_id = $1`,\n [userId]\n );\n const row = rows.at(0);\n return row === undefined ? undefined : asJson<ProfileProps>(row.props);\n }\n\n async mergeProfile(userId: string, props: ProfileProps): Promise<ProfileProps> {\n // RFC 7386 merge-patch in one statement: jsonb `||` overwrites key by key\n // and jsonb_strip_nulls then drops the keys the patch set to null (the\n // API's only way to unset a property). Atomic in the database, so two\n // concurrent identifies cannot lose each other's keys.\n return this.sql.transaction(async (tx) => {\n await this.lockUser(tx, userId);\n const rows = await tx.query<{ props: unknown }>(\n `INSERT INTO ${this.t.profile} (user_id, props)\n SELECT $1, jsonb_strip_nulls($2::text::jsonb) ${this.notErased('$1')}\n ON CONFLICT (user_id) DO UPDATE SET props = jsonb_strip_nulls(${this.t.profile}.props || $3::text::jsonb)\n RETURNING props`,\n // EXCLUDED.props would be the stripped insert value, so the update merges the raw patch again\n [userId, JSON.stringify(props), JSON.stringify(props)]\n );\n // The upsert always yields its row — unless the tombstone refused it\n if (rows.length === 0) throw new UserErasedError(userId);\n return asJson<ProfileProps>(rows[0].props);\n });\n }\n\n async listUserIds(page?: {\n after?: string | undefined;\n limit?: number | undefined;\n }): Promise<string[]> {\n // Ascending user_id with a keyset bound, so a sweep can resume past the last id it saw\n const params: unknown[] = [];\n let where = '';\n if (page?.after !== undefined) {\n params.push(page.after);\n where = ` WHERE user_id > $${params.length}`;\n }\n let limit = '';\n if (page?.limit !== undefined) {\n params.push(page.limit);\n limit = ` LIMIT $${params.length}`;\n }\n const rows = await this.sql.query<{ user_id: string }>(\n `SELECT user_id FROM (SELECT user_id FROM ${this.t.profile} UNION SELECT user_id FROM ${this.t.event}) u${where} ORDER BY user_id${limit}`,\n params\n );\n return rows.map((row) => row.user_id);\n }\n\n listDevices(userId: string): Promise<PushDevice[]> {\n return this.sql.query<PushDevice>(\n `SELECT token, platform FROM ${this.t.device} WHERE user_id = $1 ORDER BY ts DESC`,\n [userId]\n );\n }\n\n async upsertDevice(device: DeviceInput): Promise<void> {\n await this.sql.transaction(async (tx) => {\n await this.lockUser(tx, device.userId);\n const rows = await tx.query(\n `INSERT INTO ${this.t.device} (token, user_id, platform, ts)\n SELECT $1, $2, $3, ${TS('$4')} ${this.notErased('$2')}\n ON CONFLICT (token) DO UPDATE SET user_id = EXCLUDED.user_id, platform = EXCLUDED.platform, ts = EXCLUDED.ts\n RETURNING token`,\n [device.token, device.userId, device.platform, device.ts]\n );\n if (rows.length === 0) throw new UserErasedError(device.userId);\n });\n }\n\n async requestErasure(userId: string, at: number): Promise<void> {\n // Under the user's lock: a write in flight commits before the tombstone (and is found by\n // the erase) or reads it after (and is refused)\n await this.sql.transaction(async (tx) => {\n await this.lockUser(tx, userId);\n await tx.query(\n `INSERT INTO ${this.t.erasure} (user_id, requested_at) VALUES ($1, ${TS('$2')})\n ON CONFLICT DO NOTHING`,\n [userId, at]\n );\n });\n }\n\n async pendingErasures(): Promise<string[]> {\n const rows = await this.sql.query<{ user_id: string }>(\n `SELECT user_id FROM ${this.t.erasure} WHERE erased_at IS NULL ORDER BY requested_at`\n );\n return rows.map((row) => row.user_id);\n }\n\n async erasureState(userId: string): Promise<ErasureState> {\n const rows = await this.sql.query<{ erased: boolean }>(\n `SELECT erased_at IS NOT NULL AS erased FROM ${this.t.erasure} WHERE user_id = $1`,\n [userId]\n );\n const row = rows.at(0);\n if (row === undefined) return 'none';\n return row.erased ? 'erased' : 'erasing';\n }\n\n async runningInstances(userId: string): Promise<RunningInstance[]> {\n const rows = await this.sql.query<{ instance_id: string; admitted: boolean }>(\n `SELECT instance_id, admitted_at IS NOT NULL AS admitted\n FROM ${this.t.entry} WHERE user_id = $1 AND status = 'running'`,\n [userId]\n );\n return rows.map((row) => ({ instanceId: row.instance_id, admitted: row.admitted }));\n }\n\n async admitInstance(instanceId: string, userId: string): Promise<boolean> {\n return this.sql.transaction(async (tx) => {\n await this.lockUser(tx, userId);\n // A first admission needs a running entry; an instance once admitted may replay its\n // finalisation after the entry reached a terminal status, under its own instance id (a\n // reclaim resets `admitted_at`, so a superseded attempt cannot). The first admission's\n // time is kept, the status never touched, and the tombstone refuses both.\n const rows = await tx.query(\n `UPDATE ${this.t.entry} SET admitted_at = COALESCE(admitted_at, ${TS('$3')})\n WHERE instance_id = $1 AND user_id = $2\n AND (status = 'running' OR admitted_at IS NOT NULL)\n AND NOT EXISTS (SELECT 1 FROM ${this.t.erasure} WHERE user_id = $2)\n RETURNING instance_id`,\n [instanceId, userId, Date.now()]\n );\n return rows.length > 0;\n });\n }\n\n async forgetUser(userId: string, at: number): Promise<void> {\n await this.sql.transaction(async (tx) => {\n // Under the user's lock, every row committed before the tombstone is visible from here,\n // and no write about the user can commit until this transaction ends\n await this.lockUser(tx, userId);\n // Children before the copies they belong to\n for (const child of [this.t.messageOpen, this.t.messageClick, this.t.messageLink]) {\n await tx.query(\n `DELETE FROM ${child} WHERE message_id IN (SELECT id FROM ${this.t.message} WHERE user_id = $1)`,\n [userId]\n );\n }\n for (const table of [\n this.t.message,\n this.t.instance,\n this.t.entry,\n this.t.execution,\n this.t.subscription,\n this.t.segmentStart,\n this.t.segmentMember,\n // The opt-outs too: the tombstone keeps the id from ever being sent to again\n this.t.suppression,\n this.t.device,\n this.t.event,\n this.t.profile,\n ]) {\n await tx.query(`DELETE FROM ${table} WHERE user_id = $1`, [userId]);\n }\n // The tombstone stays, now marked erased; the first erase's time is kept by a repeat\n await tx.query(\n `UPDATE ${this.t.erasure} SET erased_at = COALESCE(erased_at, ${TS('$2')}) WHERE user_id = $1`,\n [userId, at]\n );\n });\n }\n\n async isSuppressed(userId: string, channel: string, topic?: string): Promise<boolean> {\n // The channel-wide row (topic null) covers every topic; a topic's row covers that topic\n const rows = await this.sql.query(\n `SELECT 1 AS x FROM ${this.t.suppression}\n WHERE user_id = $1 AND channel = $2 AND (topic IS NULL OR topic = $3::text)`,\n [userId, channel, topic ?? null]\n );\n return rows.length > 0;\n }\n\n async listSuppressions(userId: string, channel: string): Promise<(string | null)[]> {\n const rows = await this.sql.query<{ topic: string | null }>(\n `SELECT topic FROM ${this.t.suppression} WHERE user_id = $1 AND channel = $2\n ORDER BY topic NULLS FIRST`,\n [userId, channel]\n );\n return rows.map((row) => row.topic);\n }\n\n async updateSuppressions(\n userId: string,\n channel: string,\n changes: readonly SuppressionChange[],\n at: number\n ): Promise<void> {\n if (changes.length === 0) return;\n await this.sql.transaction(async (tx) => {\n await this.lockUser(tx, userId);\n for (const { topic, suppressed } of changes) {\n if (suppressed) {\n // The first opt-out sets the time; a repeat keeps it\n await tx.query(\n `INSERT INTO ${this.t.suppression} (user_id, channel, topic, ts)\n VALUES ($1, $2, $3::text, ${TS('$4')}) ON CONFLICT DO NOTHING`,\n [userId, channel, topic, at]\n );\n } else {\n await tx.query(\n `DELETE FROM ${this.t.suppression}\n WHERE user_id = $1 AND channel = $2 AND topic IS NOT DISTINCT FROM $3::text`,\n [userId, channel, topic]\n );\n }\n }\n });\n }\n\n async removeDevice(token: string): Promise<string | undefined> {\n const rows = await this.sql.query<{ user_id: string | null }>(\n `DELETE FROM ${this.t.device} WHERE token = $1 RETURNING user_id`,\n [token]\n );\n return rows[0]?.user_id ?? undefined;\n }\n\n async unbindDevice(token: string): Promise<string | undefined> {\n // The owner as it was before the update: RETURNING alone would only show the null\n const rows = await this.sql.query<{ user_id: string | null }>(\n `WITH old AS (SELECT token, user_id FROM ${this.t.device} WHERE token = $1 FOR UPDATE)\n UPDATE ${this.t.device} d SET user_id = NULL FROM old WHERE d.token = old.token\n RETURNING old.user_id`,\n [token]\n );\n return rows[0]?.user_id ?? undefined;\n }\n\n async listSegments(): Promise<{ id: string; condition: ConditionIR }[]> {\n const rows = await this.sql.query<{ id: string; condition: unknown }>(\n `SELECT id, condition FROM ${this.t.segment} ORDER BY id`\n );\n return rows.map((row) => ({\n id: row.id,\n condition: ConditionIR.parse(asJson(row.condition)),\n }));\n }\n\n async getSegmentCondition(id: string): Promise<ConditionIR | undefined> {\n const rows = await this.sql.query<{ condition: unknown }>(\n `SELECT condition FROM ${this.t.segment} WHERE id = $1`,\n [id]\n );\n const row = rows.at(0);\n return row === undefined ? undefined : ConditionIR.parse(asJson(row.condition));\n }\n\n async findTriggers(event: string): Promise<TriggerRoute[]> {\n const rows = await this.sql.query<{\n workflow: string;\n hash: string;\n where_clause: unknown;\n filter: unknown;\n version: string | null;\n }>(\n `SELECT workflow, hash, \"where\" AS where_clause, filter, version FROM ${this.t.trigger} WHERE event = $1`,\n [event]\n );\n return rows.map((row) => ({\n workflow: row.workflow,\n hash: row.hash,\n where: row.where_clause === null ? null : ConditionIR.parse(asJson(row.where_clause)),\n filter: row.filter === null ? null : ConditionIR.parse(asJson(row.filter)),\n version: row.version ?? undefined,\n }));\n }\n\n async listSegmentTriggers(): Promise<SegmentTriggerRoute[]> {\n const rows = await this.sql.query<{\n workflow: string;\n hash: string;\n segment: string;\n version: string | null;\n }>(`SELECT workflow, hash, segment, version FROM ${this.t.segmentTrigger}`);\n return rows.map((row) => ({\n workflow: row.workflow,\n hash: row.hash,\n segment: row.segment,\n version: row.version ?? undefined,\n }));\n }\n\n async putWorkflowIR(workflow: WorkflowIR): Promise<void> {\n await this.sql.query(\n `INSERT INTO ${this.t.ir} (content_hash, ir) VALUES ($1, $2::text::jsonb)\n ON CONFLICT (content_hash) DO UPDATE SET ir = EXCLUDED.ir`,\n [workflow.contentHash, JSON.stringify(workflow)]\n );\n }\n\n async getWorkflowIR(contentHash: string): Promise<WorkflowIR | undefined> {\n const rows = await this.sql.query<{ ir: unknown }>(\n `SELECT ir FROM ${this.t.ir} WHERE content_hash = $1`,\n [contentHash]\n );\n const row = rows.at(0);\n return row === undefined ? undefined : WorkflowIR.parse(asJson(row.ir));\n }\n\n replaceRoutes(bundle: BundleIR): Promise<void> {\n return this.sql.transaction((tx) => this.swapRoutes(tx, bundle));\n }\n\n async liveBundleVersion(): Promise<BundleVersion | undefined> {\n // In a transaction, so Hyperdrive answers from the database, not from its read cache\n const rows = await this.sql.transaction((tx) =>\n tx.query<{ version_id: string; created_at: number | string }>(\n `SELECT version_id, (extract(epoch FROM version_created_at) * 1000)::double precision AS created_at\n FROM ${this.t.deployment} WHERE scope = 'routes'`\n )\n );\n const row = rows.at(0);\n return row === undefined\n ? undefined\n : { id: row.version_id, createdAt: Number(row.created_at) };\n }\n\n replaceRoutesIfNewer(bundle: BundleIR, version: BundleVersion): Promise<boolean> {\n return this.sql.transaction(async (tx) => {\n // The row lock decides between versions applying at once: the loser's WHERE re-reads the\n // winner's committed row and updates nothing\n const claimed = await tx.query(\n `INSERT INTO ${this.t.deployment} AS live (scope, version_id, version_created_at, applied_at)\n VALUES ('routes', $1, ${TS('$2')}, ${TS('$3')})\n ON CONFLICT (scope) DO UPDATE SET version_id = EXCLUDED.version_id,\n version_created_at = EXCLUDED.version_created_at, applied_at = EXCLUDED.applied_at\n WHERE live.version_created_at < EXCLUDED.version_created_at\n RETURNING scope`,\n [version.id, version.createdAt, Date.now()]\n );\n if (claimed.length === 0) return false;\n await this.swapRoutes(tx, bundle, version.id);\n return true;\n });\n }\n\n /** `version`: the code version applying the bundle, kept on every route it writes. */\n private async swapRoutes(tx: SqlClientLike, bundle: BundleIR, version?: string): Promise<void> {\n await tx.query(`DELETE FROM ${this.t.trigger}`);\n await tx.query(`DELETE FROM ${this.t.segmentTrigger}`);\n await tx.query(`DELETE FROM ${this.t.segment}`);\n for (const segment of bundle.segments) {\n await tx.query(\n `INSERT INTO ${this.t.segment} (id, condition, hash) VALUES ($1, $2::text::jsonb, $3)`,\n [segment.id, JSON.stringify(segment.condition), segment.contentHash]\n );\n }\n for (const workflow of bundle.workflows) {\n if (workflow.trigger.type === 'event') {\n await tx.query(\n `INSERT INTO ${this.t.trigger} (workflow, hash, event, \"where\", filter, version) VALUES ($1, $2, $3, $4::text::jsonb, $5::text::jsonb, $6)`,\n [\n workflow.id,\n workflow.contentHash,\n workflow.trigger.event,\n workflow.trigger.where === undefined ? null : JSON.stringify(workflow.trigger.where),\n workflow.trigger.filter === undefined ? null : JSON.stringify(workflow.trigger.filter),\n version ?? null,\n ]\n );\n } else if (workflow.trigger.type === 'segment') {\n await tx.query(\n `INSERT INTO ${this.t.segmentTrigger} (workflow, hash, segment, version) VALUES ($1, $2, $3, $4)`,\n [workflow.id, workflow.contentHash, workflow.trigger.segment, version ?? null]\n );\n }\n }\n }\n\n async isSegmentMember(segment: string, userId: string): Promise<boolean> {\n const rows = await this.sql.query(\n `SELECT 1 AS x FROM ${this.t.segmentMember} WHERE segment = $1 AND user_id = $2`,\n [segment, userId]\n );\n return rows.length > 0;\n }\n\n async addSegmentMember(\n segment: string,\n userId: string,\n ts: number,\n workflows: readonly string[]\n ): Promise<void> {\n // One locked transaction: the membership and the starts it owes commit together\n await this.sql.transaction(async (tx) => {\n await this.lockUser(tx, userId);\n const member = await tx.query(\n `INSERT INTO ${this.t.segmentMember} (segment, user_id, ts)\n SELECT $1, $2, ${TS('$3')} ${this.notErased('$2')}\n ON CONFLICT DO NOTHING RETURNING segment`,\n [segment, userId, ts]\n );\n // Already a member, or refused: either way the starts below write nothing new\n if (member.length === 0) await this.refuseIfErased(tx, userId);\n for (const workflow of workflows) {\n await tx.query(\n `INSERT INTO ${this.t.segmentStart} (segment, workflow, user_id, ts)\n SELECT $1, $2, $3, ${TS('$4')} ${this.notErased('$3')}\n ON CONFLICT DO NOTHING`,\n [segment, workflow, userId, ts]\n );\n }\n });\n }\n\n async pendingSegmentStarts(segment: string, userId: string): Promise<string[]> {\n const rows = await this.sql.query<{ workflow: string }>(\n `SELECT workflow FROM ${this.t.segmentStart} WHERE segment = $1 AND user_id = $2`,\n [segment, userId]\n );\n return rows.map((row) => row.workflow);\n }\n\n async completeSegmentStart(segment: string, userId: string, workflow: string): Promise<void> {\n await this.sql.query(\n `DELETE FROM ${this.t.segmentStart} WHERE segment = $1 AND user_id = $2 AND workflow = $3`,\n [segment, userId, workflow]\n );\n }\n\n async removeSegmentMember(segment: string, userId: string): Promise<void> {\n await this.sql.transaction(async (tx) => {\n await tx.query(`DELETE FROM ${this.t.segmentStart} WHERE segment = $1 AND user_id = $2`, [\n segment,\n userId,\n ]);\n await tx.query(`DELETE FROM ${this.t.segmentMember} WHERE segment = $1 AND user_id = $2`, [\n segment,\n userId,\n ]);\n });\n }\n\n async enterJourney(entry: EntryInput): Promise<EntryOutcome> {\n const { execution } = entry;\n // One transaction under the user's lock: the claim (or reclaim) and the start it owes commit\n // together — a crash between them would leave a running entry no retry could ever start —\n // and before or after an erasure of the user, never astride it\n return this.sql.transaction(async (tx) => {\n await this.lockUser(tx, entry.userId);\n const outcome = await this.claimEntry(tx, entry);\n if (outcome !== null && execution !== undefined) {\n await this.recordStart(tx, entry, execution);\n }\n return outcome;\n });\n }\n\n private async claimEntry(sql: SqlClientLike, entry: EntryInput): Promise<EntryOutcome> {\n // The (workflow, user_id) primary key makes the once policy atomic:\n // concurrent ingests race on the insert and exactly one wins.\n const inserted = await sql.query(\n `INSERT INTO ${this.t.entry} (workflow, user_id, instance_id, hash, status, ts)\n SELECT $1, $2, $3, $4, 'running', ${TS('$5')} ${this.notErased('$2')}\n ON CONFLICT (workflow, user_id) DO NOTHING RETURNING instance_id`,\n [entry.workflow, entry.userId, entry.instanceId, entry.hash, entry.ts]\n );\n if (inserted.length > 0) return 'entered';\n\n // An existing row blocks the entry unless it records an instance that died:\n // 'failed' is reclaimed rather than barring the user forever over one\n // outage. The status test is inside the UPDATE, so of two concurrent\n // retries exactly one gets a row back. The reclaim is a new attempt: it\n // starts unadmitted, even under the same instance id, so the previous\n // attempt's admission is not inherited (`runningInstances` would report a\n // runner that has not been created yet).\n const claimed = await sql.query(\n `UPDATE ${this.t.entry} SET instance_id = $1, hash = $2, status = 'running', ts = ${TS('$3')},\n admitted_at = NULL\n WHERE workflow = $4 AND user_id = $5 AND status = 'failed'\n AND NOT EXISTS (SELECT 1 FROM ${this.t.erasure} WHERE user_id = $5)\n RETURNING instance_id`,\n [entry.instanceId, entry.hash, entry.ts, entry.workflow, entry.userId]\n );\n if (claimed.length > 0) return 'reclaimed';\n // Taken by a live instance, or refused by the tombstone: tell them apart\n await this.refuseIfErased(sql, entry.userId);\n return null;\n }\n\n /**\n * Only an entry this call claimed records a start, so a row already there is a previous\n * attempt's — a failed entry reclaimed under the same instance id (an event replayed with its\n * ts). It is replaced whole: the new attempt's name and payload, nothing submitted yet.\n */\n private async recordStart(\n tx: SqlClientLike,\n entry: EntryInput,\n execution: ExecutionStart\n ): Promise<void> {\n const rows = await tx.query(\n `INSERT INTO ${this.t.execution} (instance_id, workflow, user_id, name, target, input, created_at, generation)\n SELECT $1, $2, $3, $4, $5, $6, ${TS('$7')}, 0 ${this.notErased('$3')}\n ON CONFLICT (instance_id) DO UPDATE SET\n name = EXCLUDED.name, target = EXCLUDED.target, input = EXCLUDED.input,\n created_at = EXCLUDED.created_at, generation = 0, submitted_at = NULL, arn = NULL,\n unresolved_at = NULL, callback_id = NULL, deadline_at = NULL, checked_at = NULL,\n stopped_at = NULL\n RETURNING instance_id`,\n [\n entry.instanceId,\n entry.workflow,\n entry.userId,\n execution.name,\n execution.target,\n execution.input,\n // The start's own age (the retry budget), not the event's ts, which the producer chose\n Date.now(),\n ]\n );\n // Refused between the claim and this: the throw rolls the claimed entry back with it\n if (rows.length === 0) throw new UserErasedError(entry.userId);\n }\n\n async removeEntry(instanceId: string): Promise<void> {\n await this.sql.query(`DELETE FROM ${this.t.entry} WHERE instance_id = $1`, [instanceId]);\n }\n\n async setEntryStatus(instanceId: string, status: string): Promise<void> {\n await this.sql.query(`UPDATE ${this.t.entry} SET status = $1 WHERE instance_id = $2`, [\n status,\n instanceId,\n ]);\n }\n\n async findWakeHandles(userId: string, event: string): Promise<string[]> {\n const rows = await this.sql.query<{ handle: string }>(\n `SELECT DISTINCT wake_handle AS handle FROM ${this.t.subscription} WHERE user_id = $1 AND event = $2`,\n [userId, event]\n );\n return rows.map((row) => row.handle);\n }\n\n async subscribe(\n handle: string,\n userId: string,\n events: readonly string[],\n ts: number\n ): Promise<void> {\n // One locked transaction for the call's registrations: all of them, or none\n await this.sql.transaction(async (tx) => {\n await this.lockUser(tx, userId);\n let skipped = false;\n for (const event of events) {\n const rows = await tx.query(\n `INSERT INTO ${this.t.subscription} (user_id, event, wake_handle, ts)\n SELECT $1, $2, $3, ${TS('$4')} ${this.notErased('$1')}\n ON CONFLICT DO NOTHING RETURNING event`,\n [userId, event, handle, ts]\n );\n if (rows.length === 0) skipped = true;\n }\n // A registration already there, or refused: one read tells which\n if (skipped) await this.refuseIfErased(tx, userId);\n });\n }\n\n async unsubscribe(handle: string): Promise<void> {\n await this.sql.query(`DELETE FROM ${this.t.subscription} WHERE wake_handle = $1`, [handle]);\n }\n}\n\ninterface ExecutionRow {\n instance_id: string;\n workflow: string;\n user_id: string;\n name: string;\n target: string;\n input: string;\n // float8 comes back as a number from most drivers, as a string from some\n created_at: number | string;\n submitted_at: number | string | null;\n arn: string | null;\n unresolved_at: number | string | null;\n callback_id: string | null;\n generation: number | string;\n deadline_at: number | string | null;\n checked_at: number | string | null;\n stopped_at: number | string | null;\n}\n\nconst PLAIN_COLUMNS = ['instance_id', 'workflow', 'user_id', 'name', 'target', 'input', 'arn'];\nconst MORE_PLAIN = ['callback_id', 'generation'];\nconst TIME_COLUMNS = [\n 'created_at',\n 'submitted_at',\n 'unresolved_at',\n 'deadline_at',\n 'checked_at',\n 'stopped_at',\n];\n\n/** The execution columns, timestamps as epoch ms; `alias` qualifies them in a join. */\nfunction executionColumns(alias = ''): string {\n const q = alias === '' ? '' : `${alias}.`;\n return [\n ...[...PLAIN_COLUMNS, ...MORE_PLAIN].map((column) => `${q}${column}`),\n ...TIME_COLUMNS.map(\n (column) => `(extract(epoch from ${q}${column}) * 1000)::double precision AS ${column}`\n ),\n ].join(', ');\n}\n\nconst optional = <T>(value: T | null): T | undefined => value ?? undefined;\nconst ms = (value: number | string | null): number | undefined =>\n value === null ? undefined : Number(value);\n\nfunction toRecord(row: ExecutionRow): ExecutionRecord {\n return {\n instanceId: row.instance_id,\n workflow: row.workflow,\n userId: row.user_id,\n name: row.name,\n target: row.target,\n input: row.input,\n createdAt: Number(row.created_at),\n submittedAt: ms(row.submitted_at),\n arn: optional(row.arn),\n unresolvedAt: ms(row.unresolved_at),\n callbackId: optional(row.callback_id),\n generation: Number(row.generation),\n deadlineAt: ms(row.deadline_at),\n checkedAt: ms(row.checked_at),\n stoppedAt: ms(row.stopped_at),\n };\n}\n\n/** The execution table (tables.ts): starts to confirm, and the callback each wait parks on. */\nclass PostgresExecutions implements ExecutionRegistry {\n constructor(\n private readonly sql: SqlClientLike,\n private readonly table: string,\n private readonly entry: string\n ) {}\n\n async get(instanceId: string): Promise<ExecutionRecord | undefined> {\n const rows = await this.sql.query<ExecutionRow>(\n `SELECT ${executionColumns()} FROM ${this.table} WHERE instance_id = $1`,\n [instanceId]\n );\n return rows.length === 0 ? undefined : toRecord(rows[0]);\n }\n\n async pendingStarts(filter: {\n workflow?: string;\n userId?: string;\n createdBefore?: number;\n limit: number;\n }): Promise<ExecutionRecord[]> {\n const where = ['x.submitted_at IS NULL', 'x.unresolved_at IS NULL', \"e.status = 'running'\"];\n const params: unknown[] = [];\n if (filter.workflow !== undefined) {\n params.push(filter.workflow);\n where.push(`x.workflow = $${params.length}`);\n }\n if (filter.userId !== undefined) {\n params.push(filter.userId);\n where.push(`x.user_id = $${params.length}`);\n }\n if (filter.createdBefore !== undefined) {\n params.push(filter.createdBefore);\n where.push(`x.created_at < ${TS(`$${params.length}`)}`);\n }\n params.push(filter.limit);\n // Only the start the entry still names: a reclaimed entry's old start is history\n const rows = await this.sql.query<ExecutionRow>(\n `SELECT ${executionColumns('x')}\n FROM ${this.table} x JOIN ${this.entry} e ON e.instance_id = x.instance_id\n WHERE ${where.join(' AND ')} ORDER BY x.created_at LIMIT $${params.length}`,\n params\n );\n return rows.map(toRecord);\n }\n\n async markSubmitted(instanceId: string, arn: string | undefined, at: number): Promise<void> {\n await this.sql.query(\n `UPDATE ${this.table} SET submitted_at = COALESCE(submitted_at, ${TS('$2')}), arn = COALESCE($3, arn) WHERE instance_id = $1`,\n [instanceId, at, arn ?? null]\n );\n }\n\n async markUnresolved(instanceId: string, at: number): Promise<void> {\n await this.sql.query(\n `UPDATE ${this.table} SET unresolved_at = ${TS('$2')} WHERE instance_id = $1 AND submitted_at IS NULL`,\n [instanceId, at]\n );\n }\n\n async setArn(instanceId: string, arn: string): Promise<void> {\n await this.sql.query(`UPDATE ${this.table} SET arn = $2 WHERE instance_id = $1`, [\n instanceId,\n arn,\n ]);\n }\n\n async armCallback(\n instanceId: string,\n callback: { id: string; generation: number; deadlineAt?: number | undefined }\n ): Promise<boolean> {\n // The generation test is inside the UPDATE: a retried arm of an older wait cannot overwrite\n // the callback a newer one parks on\n const rows = await this.sql.query(\n `UPDATE ${this.table} SET callback_id = $2, generation = $3,\n deadline_at = CASE WHEN $4::double precision IS NULL THEN NULL ELSE ${TS('$4')} END\n WHERE instance_id = $1 AND generation <= $3 RETURNING instance_id`,\n [instanceId, callback.id, callback.generation, callback.deadlineAt ?? null]\n );\n return rows.length > 0;\n }\n\n async clearCallback(instanceId: string, generation: number): Promise<void> {\n await this.sql.query(\n `UPDATE ${this.table} SET callback_id = NULL, deadline_at = NULL WHERE instance_id = $1 AND generation = $2`,\n [instanceId, generation]\n );\n }\n\n async toReconcile(limit: number, checkedBefore: number): Promise<ExecutionRecord[]> {\n const rows = await this.sql.query<ExecutionRow>(\n `SELECT ${executionColumns('x')}\n FROM ${this.table} x JOIN ${this.entry} e ON e.instance_id = x.instance_id\n WHERE e.status = 'running' AND x.submitted_at IS NOT NULL\n AND (x.checked_at IS NULL OR x.checked_at < ${TS('$1')})\n ORDER BY x.checked_at NULLS FIRST LIMIT $2`,\n [checkedBefore, limit]\n );\n return rows.map(toRecord);\n }\n\n async markStopped(instanceId: string, at: number): Promise<void> {\n await this.sql.query(\n `UPDATE ${this.table} SET stopped_at = COALESCE(stopped_at, ${TS('$2')}) WHERE instance_id = $1`,\n [instanceId, at]\n );\n }\n\n async markChecked(instanceId: string, at: number): Promise<void> {\n await this.sql.query(\n `UPDATE ${this.table} SET checked_at = ${TS('$2')} WHERE instance_id = $1`,\n [instanceId, at]\n );\n }\n}\n"],"mappings":"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"}
@@ -68,13 +68,21 @@ const TABLES = {
68
68
  }),
69
69
  suppression: table({
70
70
  name: "suppression",
71
- doc: "Channels a user opted out of (an email unsubscribe): the engine sends nothing there, and `reachable(channel)` is false.",
71
+ doc: "What a user opted out of: a topic on a channel (an email unsubscribe from one topic, a push topic switched off in the app), or the whole channel when `topic` is null — the engine sends nothing there, and `reachable(channel)` is false. One row per (user, channel, topic), nulls included.",
72
72
  columns: {
73
73
  userId: text,
74
74
  channel: text,
75
+ topic: nullable(text, "The subscription topic opted out of; null for the whole channel (every row from before topics existed)."),
75
76
  ts
76
77
  },
77
- primaryKey: ["userId", "channel"]
78
+ uniqueConstraints: [{
79
+ columns: [
80
+ "userId",
81
+ "channel",
82
+ "topic"
83
+ ],
84
+ nullsNotDistinct: true
85
+ }]
78
86
  }),
79
87
  segment: table({
80
88
  name: "segment",
@@ -250,6 +258,7 @@ const TABLES = {
250
258
  template: text,
251
259
  channel: text,
252
260
  userId: text,
261
+ topic: nullable(text, "An email or push copy: its template's subscription topic (what an email's unsubscribe link opts out of); null for a transactional message, and for every other channel."),
253
262
  sentAt: ts,
254
263
  deliveredAt: nullable(ts, "The transport accepted it."),
255
264
  deviceDeliveredAt: nullable(ts, "A push: the device reported it received (iOS's notification service extension, a browser's service worker)."),
@@ -336,6 +345,14 @@ function columnName(key) {
336
345
  return key.replace(/[A-Z]/g, (c) => `_${c.toLowerCase()}`);
337
346
  }
338
347
  const quote = (name) => `"${name.replace(/"/g, "\"\"")}"`;
348
+ /** `<table>_<columns>_unique`: drizzle's name for an unnamed `unique()`, and the index behind it. */
349
+ function uniqueConstraintName(spec, unique) {
350
+ return `${spec.name}_${unique.columns.map(columnName).join("_")}_unique`;
351
+ }
352
+ /** `<table>_<columns>_index`: the name drizzle-kit and `renderPostgresDdl` both give an unnamed index. */
353
+ function indexName(spec, keys) {
354
+ return `${spec.name}_${keys.map(columnName).join("_")}_index`;
355
+ }
339
356
  const SQL_TYPES = {
340
357
  uuid: "uuid",
341
358
  text: "text",
@@ -354,7 +371,11 @@ function renderPostgresDdl(schema = DEFAULT_SCHEMA) {
354
371
  const out = [`CREATE SCHEMA IF NOT EXISTS ${s};`];
355
372
  for (const spec of Object.values(TABLES)) {
356
373
  const lines = Object.entries(spec.columns).map(([key, column]) => ` ${quote(columnName(key))} ${SQL_TYPES[column.type]}${column.nullable ? "" : " NOT NULL"}`);
357
- lines.push(` PRIMARY KEY (${spec.primaryKey.map((k) => quote(columnName(k))).join(", ")})`);
374
+ if (spec.primaryKey !== void 0) lines.push(` PRIMARY KEY (${spec.primaryKey.map((k) => quote(columnName(k))).join(", ")})`);
375
+ for (const unique of spec.uniqueConstraints ?? []) {
376
+ const cols = unique.columns.map(columnName);
377
+ lines.push(` CONSTRAINT ${quote(uniqueConstraintName(spec, unique))} UNIQUE NULLS NOT DISTINCT (${cols.map(quote).join(", ")})`);
378
+ }
358
379
  if (spec.uuidV7 !== void 0) lines.push(` CONSTRAINT ${quote(`${spec.name}_uuid_v7`)} CHECK (substring(${quote(columnName(spec.uuidV7))}::text, 15, 1) = '7')`);
359
380
  for (const ref of spec.references ?? []) {
360
381
  const target = TABLES[ref.table];
@@ -363,21 +384,57 @@ function renderPostgresDdl(schema = DEFAULT_SCHEMA) {
363
384
  out.push(`CREATE TABLE IF NOT EXISTS ${s}.${quote(spec.name)} (\n${lines.join(",\n")}\n);`);
364
385
  const index = (unique) => (keys) => {
365
386
  const cols = keys.map(columnName);
366
- out.push(`CREATE ${unique ? "UNIQUE " : ""}INDEX IF NOT EXISTS ${quote(`${spec.name}_${cols.join("_")}_index`)} ON ${s}.${quote(spec.name)} (${cols.map(quote).join(", ")});`);
387
+ out.push(`CREATE ${unique ? "UNIQUE " : ""}INDEX IF NOT EXISTS ${quote(indexName(spec, keys))} ON ${s}.${quote(spec.name)} (${cols.map(quote).join(", ")});`);
367
388
  };
368
389
  (spec.uniqueIndexes ?? []).forEach(index(true));
369
390
  (spec.indexes ?? []).forEach(index(false));
370
391
  }
371
392
  return `${out.join("\n")}\n`;
372
393
  }
394
+ const TIMESTAMP_OPTIONS = "{ mode: 'string', withTimezone: true }";
373
395
  const DRIZZLE_TYPES = {
374
396
  uuid: (c) => `uuid('${c}')`,
375
397
  text: (c) => `text('${c}')`,
376
398
  jsonb: (c) => `jsonb('${c}')`,
377
- timestamptz: (c) => `timestamp('${c}', { mode: 'string', withTimezone: true })`,
399
+ timestamptz: (c) => `timestamp('${c}', ${TIMESTAMP_OPTIONS})`,
378
400
  integer: (c) => `integer('${c}')`,
379
401
  boolean: (c) => `boolean('${c}')`
380
402
  };
403
+ /** The line width the generated file is laid out for: the formatters' common default. */
404
+ const PRINT_WIDTH = 100;
405
+ /**
406
+ * One `workflowSchema.table(...)` statement, laid out the way a prettier-compatible formatter
407
+ * (prettier, oxfmt, biome) at `PRINT_WIDTH` lays it out, so that formatting the generated file
408
+ * changes nothing and a regeneration shows only real changes: on one line when it fits; else
409
+ * with the last argument "hugged" (the columns object, or the constraints arrow when the columns
410
+ * fit on the first line) and its items one per line; else every argument on its own line, the
411
+ * constraints array still collapsed when it fits. A column with a doc comment keeps the columns
412
+ * object expanded, as a comment does for a formatter.
413
+ */
414
+ /** A column line past the width: a formatter breaks the timestamp options object, so this does too. */
415
+ function wrapColumn(text, indent) {
416
+ if (`${indent}${text},`.length <= PRINT_WIDTH || !text.includes(TIMESTAMP_OPTIONS)) return text;
417
+ return text.replace(TIMESTAMP_OPTIONS, `{\n${indent} mode: 'string',\n${indent} withTimezone: true,\n${indent}}`);
418
+ }
419
+ function renderTable(name, table, columns, extras) {
420
+ const head = `export const ${name} = workflowSchema.table(`;
421
+ const flatColumns = columns.some((c) => c.doc !== void 0) ? void 0 : `{ ${columns.map((c) => c.text).join(", ")} }`;
422
+ const expandedColumns = (indent) => `{\n${columns.map((c) => `${c.doc === void 0 ? "" : `${indent} /** ${c.doc} */\n`}${indent} ${wrapColumn(c.text, `${indent} `)},`).join("\n")}\n${indent}}`;
423
+ const flatExtras = `(table) => [${extras.join(", ")}]`;
424
+ const expandedExtras = (indent) => `(table) => [\n${extras.map((e) => `${indent} ${e},`).join("\n")}\n${indent}]`;
425
+ const fits = (line) => line.length <= PRINT_WIDTH;
426
+ if (flatColumns !== void 0) {
427
+ const oneLine = `${head}'${table}', ${flatColumns}${extras.length === 0 ? "" : `, ${flatExtras}`});`;
428
+ if (fits(oneLine)) return oneLine;
429
+ }
430
+ if (extras.length === 0) return `${head}'${table}', ${expandedColumns("")});`;
431
+ if (flatColumns !== void 0) {
432
+ const first = `${head}'${table}', ${flatColumns}, (table) => [`;
433
+ if (fits(first)) return `${first}\n${extras.map((e) => ` ${e},`).join("\n")}\n]);`;
434
+ }
435
+ const third = fits(` ${flatExtras}`) ? flatExtras : expandedExtras(" ");
436
+ return `${head}\n '${table}',\n ${expandedColumns(" ")},\n ${third}\n);`;
437
+ }
381
438
  const exportName = (key) => `workflow${key.charAt(0).toUpperCase()}${key.slice(1)}`;
382
439
  /**
383
440
  * The tables as one drizzle file: `export const workflowSchema = pgSchema(<schema>)` and every
@@ -394,12 +451,14 @@ function renderDrizzleSchema(schema = DEFAULT_SCHEMA) {
394
451
  for (const [key, spec] of specs) {
395
452
  const columns = Object.entries(spec.columns).map(([prop, column]) => {
396
453
  used.add(column.type === "timestamptz" ? "timestamp" : column.type);
397
- const doc = column.doc === void 0 ? "" : ` /** ${column.doc} */\n`;
398
- const key = spec.primaryKey.length === 1 && spec.primaryKey[0] === prop ? ".primaryKey()" : "";
399
- return `${doc} ${prop}: ${DRIZZLE_TYPES[column.type](columnName(prop))}${key}${column.nullable ? "" : ".notNull()"},`;
454
+ const key = spec.primaryKey?.length === 1 && spec.primaryKey[0] === prop ? ".primaryKey()" : "";
455
+ return {
456
+ doc: column.doc,
457
+ text: `${prop}: ${DRIZZLE_TYPES[column.type](columnName(prop))}${key}${column.nullable ? "" : ".notNull()"}`
458
+ };
400
459
  });
401
460
  const extras = [];
402
- if (spec.primaryKey.length > 1) {
461
+ if (spec.primaryKey !== void 0 && spec.primaryKey.length > 1) {
403
462
  used.add("primaryKey");
404
463
  extras.push(`primaryKey({ columns: [${spec.primaryKey.map((k) => `table.${k}`).join(", ")}] })`);
405
464
  }
@@ -407,6 +466,10 @@ function renderDrizzleSchema(schema = DEFAULT_SCHEMA) {
407
466
  used.add("uniqueIndex");
408
467
  extras.push(`uniqueIndex().on(${keys.map((k) => `table.${k}`).join(", ")})`);
409
468
  }
469
+ for (const unique of spec.uniqueConstraints ?? []) {
470
+ used.add("unique");
471
+ extras.push(`unique().on(${unique.columns.map((k) => `table.${k}`).join(", ")}).nullsNotDistinct()`);
472
+ }
410
473
  for (const keys of spec.indexes ?? []) {
411
474
  used.add("index");
412
475
  extras.push(`index().on(${keys.map((k) => `table.${k}`).join(", ")})`);
@@ -420,8 +483,7 @@ function renderDrizzleSchema(schema = DEFAULT_SCHEMA) {
420
483
  needsSql = true;
421
484
  extras.push(`check('${spec.name}_uuid_v7', sql\`substring(\${table.${spec.uuidV7}}::text, 15, 1) = '7'\`)`);
422
485
  }
423
- const third = extras.length === 0 ? "" : `,\n (table) => [\n${extras.map((e) => ` ${e},`).join("\n")}\n ]`;
424
- body.push(`/** ${spec.doc} */\nexport const ${exportName(key)} = workflowSchema.table(\n '${spec.name}',\n {\n${columns.join("\n")}\n }${third}\n);`);
486
+ body.push(`/** ${spec.doc} */\n${renderTable(exportName(key), spec.name, columns, extras)}`);
425
487
  }
426
488
  const imports = [...used].sort();
427
489
  return [
@@ -439,7 +501,9 @@ function renderDrizzleSchema(schema = DEFAULT_SCHEMA) {
439
501
  exports.DEFAULT_SCHEMA = DEFAULT_SCHEMA;
440
502
  exports.TABLES = TABLES;
441
503
  exports.columnName = columnName;
504
+ exports.indexName = indexName;
442
505
  exports.renderDrizzleSchema = renderDrizzleSchema;
443
506
  exports.renderPostgresDdl = renderPostgresDdl;
507
+ exports.uniqueConstraintName = uniqueConstraintName;
444
508
 
445
509
  //# sourceMappingURL=tables.cjs.map