@niscorp/tide 0.1.5 → 0.1.6

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.
@@ -0,0 +1,473 @@
1
+ import { PRIMARY_KEY, UNIQUE_BY } from './chunk-4CUQXWVY.js';
2
+ import { FactKindSchema, OpSchema } from './chunk-UEG3UZDG.js';
3
+ import { migrate } from '@niscorp/strata/postgres';
4
+ import { z } from 'zod';
5
+
6
+ var SQL_TABLE = {
7
+ fact: "tide_fact",
8
+ run: "tide_run",
9
+ task: "tide_work",
10
+ state: "tide_reflex_state"
11
+ };
12
+ var COLUMN_OVERRIDES = { as: "as_who" };
13
+ var snake = (field) => COLUMN_OVERRIDES[field] ?? field.replace(/[A-Z]/g, (c) => `_${c.toLowerCase()}`);
14
+ var camel = (column) => {
15
+ for (const [field, mapped] of Object.entries(COLUMN_OVERRIDES)) if (mapped === column) return field;
16
+ return column.replace(/_([a-z])/g, (_all, c) => c.toUpperCase());
17
+ };
18
+ var JSON_COLUMNS = /* @__PURE__ */ new Set(["row", "payload", "stats", "fact_ids", "env", "input", "output"]);
19
+ var BIGINT_COLUMNS = /* @__PURE__ */ new Set([
20
+ "at",
21
+ "not_before",
22
+ "delivered_at",
23
+ "depth",
24
+ "descendants",
25
+ "due_at",
26
+ "created_at",
27
+ "settled_at",
28
+ "claimed_until",
29
+ "armed_at",
30
+ "materialized_through",
31
+ "attempt",
32
+ "selected",
33
+ "total",
34
+ "done",
35
+ "failed"
36
+ ]);
37
+ var toColumn = (column, value) => {
38
+ if (value === void 0) return null;
39
+ if (JSON_COLUMNS.has(column)) return JSON.stringify(value);
40
+ return value;
41
+ };
42
+ var fromColumn = (column, value) => {
43
+ if (value === null) return void 0;
44
+ if (JSON_COLUMNS.has(column)) return typeof value === "string" ? JSON.parse(value) : value;
45
+ if (BIGINT_COLUMNS.has(column)) return Number(value);
46
+ return value;
47
+ };
48
+ var FactRowSchema = z.object({
49
+ id: z.string(),
50
+ kind: FactKindSchema,
51
+ entity: z.string().optional(),
52
+ op: OpSchema.optional(),
53
+ row: z.record(z.string(), z.unknown()).optional(),
54
+ name: z.string().optional(),
55
+ payload: z.unknown().optional(),
56
+ reflex: z.string().optional(),
57
+ runId: z.string().optional(),
58
+ occurrence: z.string().optional(),
59
+ stats: z.object({ total: z.number(), done: z.number(), failed: z.number() }).optional(),
60
+ target: z.string().optional(),
61
+ by: z.string().optional(),
62
+ at: z.number(),
63
+ notBefore: z.number().optional(),
64
+ dedupeKey: z.string().optional(),
65
+ cause: z.string().optional(),
66
+ depth: z.number(),
67
+ deliveredAt: z.number().optional(),
68
+ parked: z.string().optional(),
69
+ released: z.boolean().optional(),
70
+ as: z.string().optional(),
71
+ root: z.string().optional(),
72
+ descendants: z.number().optional()
73
+ });
74
+ var RunRowSchema = z.object({
75
+ id: z.string(),
76
+ reflexId: z.string(),
77
+ version: z.string(),
78
+ as: z.string().optional(),
79
+ cause: z.string(),
80
+ occurrence: z.string().optional(),
81
+ factIds: z.array(z.string()).optional(),
82
+ state: z.enum(["pending", "fanned", "settled", "skipped"]),
83
+ depth: z.number(),
84
+ selected: z.number().optional(),
85
+ total: z.number(),
86
+ done: z.number(),
87
+ failed: z.number(),
88
+ dueAt: z.number(),
89
+ createdAt: z.number(),
90
+ settledAt: z.number().optional(),
91
+ drained: z.boolean().optional(),
92
+ note: z.string().optional()
93
+ });
94
+ var TaskRowSchema = z.object({
95
+ id: z.string(),
96
+ runId: z.string(),
97
+ reflexId: z.string(),
98
+ unit: z.string(),
99
+ cause: z.string(),
100
+ env: z.record(z.string(), z.unknown()),
101
+ depth: z.number(),
102
+ state: z.enum(["pending", "claimed", "retrying", "done", "failed"]),
103
+ attempt: z.number(),
104
+ token: z.string().optional(),
105
+ claimedUntil: z.number(),
106
+ notBefore: z.number(),
107
+ input: z.unknown().optional(),
108
+ output: z.unknown().optional(),
109
+ error: z.string().optional(),
110
+ createdAt: z.number(),
111
+ settledAt: z.number().optional()
112
+ });
113
+ var StateRowSchema = z.object({
114
+ reflexId: z.string(),
115
+ armedAt: z.number(),
116
+ materializedThrough: z.number().optional()
117
+ });
118
+ var ROW_SCHEMAS = {
119
+ fact: FactRowSchema,
120
+ run: RunRowSchema,
121
+ task: TaskRowSchema,
122
+ state: StateRowSchema
123
+ };
124
+ var rowToEntity = (table, row) => {
125
+ const entity = {};
126
+ for (const [column, value] of Object.entries(row)) {
127
+ const mapped = fromColumn(column, value);
128
+ if (mapped !== void 0) entity[camel(column)] = mapped;
129
+ }
130
+ const read = ROW_SCHEMAS[table].safeParse(entity);
131
+ if (!read.success) {
132
+ const misfits = read.error.issues.map((issue) => `${issue.path.join(".")}: ${issue.message}`).join("; ");
133
+ throw new Error(`tide store: a row of ${SQL_TABLE[table]} does not read as a ${table} (${misfits})`);
134
+ }
135
+ return read.data;
136
+ };
137
+
138
+ // src/store/postgres/compile.ts
139
+ var COMPARATORS = [
140
+ ["eq", "="],
141
+ ["ne", "<>"],
142
+ ["lt", "<"],
143
+ ["lte", "<="],
144
+ ["gt", ">"],
145
+ ["gte", ">="]
146
+ ];
147
+ var ComparisonSchema = z.object({
148
+ eq: z.unknown().optional(),
149
+ ne: z.unknown().optional(),
150
+ lt: z.unknown().optional(),
151
+ lte: z.unknown().optional(),
152
+ gt: z.unknown().optional(),
153
+ gte: z.unknown().optional(),
154
+ in: z.array(z.unknown()).readonly().optional(),
155
+ notIn: z.array(z.unknown()).readonly().optional(),
156
+ isNull: z.boolean().optional()
157
+ });
158
+ var comparisonOn = (field, test) => {
159
+ const read = ComparisonSchema.safeParse(test);
160
+ if (read.success) return read.data;
161
+ const misfits = read.error.issues.map((issue) => `${issue.path.join(".")}: ${issue.message}`).join("; ");
162
+ throw new Error(`tide store: what "${field}" is compared with does not read as a comparison (${misfits})`);
163
+ };
164
+ var compileWhere = (where, start, alias = "") => {
165
+ const clauses = [];
166
+ const params = [];
167
+ const prefix = alias === "" ? "" : `${alias}.`;
168
+ const slot = (value) => {
169
+ params.push(value);
170
+ return `$${start + params.length - 1}`;
171
+ };
172
+ for (const [field, test] of Object.entries(where ?? {})) {
173
+ const column = `${prefix}${snake(field)}`;
174
+ const bare = snake(field);
175
+ if (test === null || typeof test !== "object" || Array.isArray(test)) {
176
+ clauses.push(test === void 0 ? `${column} IS NULL` : `${column} = ${slot(toColumn(bare, test))}`);
177
+ continue;
178
+ }
179
+ const comparison = comparisonOn(field, test);
180
+ for (const [op, symbol] of COMPARATORS) {
181
+ const operand = comparison[op];
182
+ if (operand === void 0) continue;
183
+ clauses.push(op === "ne" ? `(${column} IS NULL OR ${column} <> ${slot(toColumn(bare, operand))})` : `${column} ${symbol} ${slot(toColumn(bare, operand))}`);
184
+ }
185
+ if (comparison.in !== void 0) clauses.push(`${column} = ANY(${slot(comparison.in.map((value) => toColumn(bare, value)))})`);
186
+ if (comparison.notIn !== void 0) clauses.push(`NOT (${column} = ANY(${slot(comparison.notIn.map((value) => toColumn(bare, value)))}))`);
187
+ if (comparison.isNull !== void 0) clauses.push(comparison.isNull ? `${column} IS NULL` : `${column} IS NOT NULL`);
188
+ }
189
+ return { sql: clauses.length === 0 ? "TRUE" : clauses.join(" AND "), params };
190
+ };
191
+ var compileOrder = (order, alias = "") => {
192
+ if (order === void 0 || order.length === 0) return "";
193
+ const prefix = alias === "" ? "" : `${alias}.`;
194
+ return ` ORDER BY ${order.map((key) => `${prefix}${snake(key.by)} ${key.dir === "desc" ? "DESC" : "ASC"}`).join(", ")}`;
195
+ };
196
+ var sortRows = (rows, order) => {
197
+ if (order === void 0 || order.length === 0) return [...rows];
198
+ return [...rows].sort((left, right) => {
199
+ for (const key of order) {
200
+ const a = left[key.by];
201
+ const b = right[key.by];
202
+ const compared = typeof a === "number" && typeof b === "number" ? a - b : String(a) < String(b) ? -1 : String(a) > String(b) ? 1 : 0;
203
+ if (compared !== 0) return compared * (key.dir === "desc" ? -1 : 1);
204
+ }
205
+ return 0;
206
+ });
207
+ };
208
+ var compileSet = (set, start) => {
209
+ const assignments = [];
210
+ const params = [];
211
+ for (const [field, value] of Object.entries(set)) {
212
+ const column = snake(field);
213
+ if (value !== null && typeof value === "object" && "inc" in value) {
214
+ assignments.push(`${column} = coalesce(${column}, 0) + ${Number(value.inc)}`);
215
+ continue;
216
+ }
217
+ params.push(toColumn(column, value));
218
+ assignments.push(`${column} = $${start + params.length - 1}`);
219
+ }
220
+ return { sql: assignments.join(", "), params };
221
+ };
222
+
223
+ // src/store/postgres/claim.ts
224
+ var claimOver = ({ client, atomically, ready }) => async (spec) => {
225
+ await ready;
226
+ const table = SQL_TABLE[spec.table];
227
+ const order = compileOrder(spec.order, "c");
228
+ const take = async (db, extra, limit) => {
229
+ if (limit <= 0) return [];
230
+ const where = compileWhere({ ...spec.where, ...extra }, 1, "c");
231
+ const set = compileSet(spec.set, where.params.length + 1);
232
+ const result = await db.query(
233
+ `UPDATE ${table} SET ${set.sql}
234
+ WHERE ctid IN (
235
+ SELECT c.ctid FROM ${table} c WHERE ${where.sql}${order}
236
+ LIMIT ${Math.floor(limit)} FOR UPDATE SKIP LOCKED
237
+ )
238
+ RETURNING *`,
239
+ [...where.params, ...set.params]
240
+ );
241
+ return sortRows(result.rows.map((row) => rowToEntity(spec.table, row)), spec.order);
242
+ };
243
+ if (spec.onePer === void 0) return take(client, {}, spec.limit);
244
+ const { column, held, only } = spec.onePer;
245
+ const restricted = [...only];
246
+ const claimed = await take(client, { [column]: { notIn: restricted } }, spec.limit - restricted.length);
247
+ const takeOneOf = (group) => atomically(async (tx) => {
248
+ const lock = await tx.query("SELECT pg_try_advisory_xact_lock(hashtext($1), hashtext($2)) AS free", [`tide:${table}.${snake(column)}`, group]);
249
+ if (lock.rows[0]?.["free"] !== true) return [];
250
+ const busy = compileWhere({ ...held, [column]: group }, 1, "c");
251
+ const taken = await tx.query(`SELECT c.id FROM ${table} c WHERE ${busy.sql} LIMIT 1`, busy.params);
252
+ if (taken.rows.length > 0) return [];
253
+ return take(tx, { [column]: group }, 1);
254
+ });
255
+ for (const group of restricted) {
256
+ if (claimed.length >= spec.limit) break;
257
+ claimed.push(...await takeOneOf(group));
258
+ }
259
+ return claimed;
260
+ };
261
+
262
+ // src/store/postgres/tables.ts
263
+ var TIDE_TABLES = ["tide_fact", "tide_run", "tide_work", "tide_reflex_state"];
264
+ var TIDE_DDL = `
265
+ CREATE TABLE IF NOT EXISTS tide_fact (
266
+ id text PRIMARY KEY,
267
+ kind text NOT NULL CHECK (kind IN ('write','signal','manual','run')),
268
+ entity text,
269
+ op text CHECK (op IN ('insert','update','delete')),
270
+ row jsonb,
271
+ name text,
272
+ payload jsonb,
273
+ reflex text,
274
+ run_id text,
275
+ occurrence text,
276
+ stats jsonb,
277
+ target text,
278
+ by text,
279
+ at bigint NOT NULL,
280
+ not_before bigint,
281
+ dedupe_key text,
282
+ cause text,
283
+ depth integer NOT NULL DEFAULT 0,
284
+ delivered_at bigint,
285
+ parked text,
286
+ released boolean,
287
+ -- WHOSE FACT THIS IS. The identity of the reflex that minted it, absent on
288
+ -- anything the host ingested. The matcher refuses to hand a fact minted
289
+ -- under one identity to a reflex running under another, which is the only
290
+ -- thing standing between a carried row and somebody else's effect \u2014 tide is
291
+ -- the one place a row travels without being read, so no scope policy is
292
+ -- consulted on the way.
293
+ as_who text
294
+ );
295
+
296
+ -- A PARTIAL index, because a fact with no dedupeKey is not claiming to be
297
+ -- unique: it is a distinct occurrence of something, not a repeat of it.
298
+ -- entity is in the key: without it, two producers over different tables
299
+ -- that agreed on a key value silently ate each other's rows.
300
+ CREATE UNIQUE INDEX IF NOT EXISTS tide_fact_dedupe
301
+ ON tide_fact (kind, coalesce(entity,''), coalesce(name,''), dedupe_key)
302
+ WHERE dedupe_key IS NOT NULL;
303
+
304
+ -- The matcher's query, every advance.
305
+ CREATE INDEX IF NOT EXISTS tide_fact_due
306
+ ON tide_fact (at) WHERE delivered_at IS NULL AND parked IS NULL;
307
+ CREATE INDEX IF NOT EXISTS tide_fact_swept ON tide_fact (delivered_at);
308
+
309
+ CREATE TABLE IF NOT EXISTS tide_run (
310
+ id text PRIMARY KEY,
311
+ reflex_id text NOT NULL,
312
+ version text NOT NULL,
313
+ as_who text,
314
+ cause text NOT NULL,
315
+ occurrence text,
316
+ fact_ids jsonb,
317
+ state text NOT NULL CHECK (state IN ('pending','fanned','settled','skipped')),
318
+ depth integer NOT NULL DEFAULT 0,
319
+ selected integer,
320
+ total integer NOT NULL DEFAULT 0,
321
+ done integer NOT NULL DEFAULT 0,
322
+ failed integer NOT NULL DEFAULT 0,
323
+ due_at bigint NOT NULL,
324
+ created_at bigint NOT NULL,
325
+ settled_at bigint,
326
+ drained boolean,
327
+ note text,
328
+ -- THE IDEMPOTENCY. One constraint, every trigger kind: an occurrence
329
+ -- cannot open twice, a replayed fact cannot open twice, and two instances
330
+ -- ticking at the same moment contend instead of duplicating.
331
+ UNIQUE (reflex_id, cause)
332
+ );
333
+
334
+ CREATE INDEX IF NOT EXISTS tide_run_pending ON tide_run (state, due_at);
335
+ CREATE INDEX IF NOT EXISTS tide_run_ledger ON tide_run (reflex_id, created_at DESC);
336
+ CREATE INDEX IF NOT EXISTS tide_run_swept ON tide_run (settled_at);
337
+
338
+ CREATE TABLE IF NOT EXISTS tide_work (
339
+ id text PRIMARY KEY,
340
+ -- ON DELETE CASCADE, because a run and its work are one fact about the
341
+ -- world. Sweeping runs and leaving work destroys the UNIQUE(run_id, unit)
342
+ -- row that IS the "this unit already ran" record \u2014 and a restore then
343
+ -- re-charges the invoice.
344
+ run_id text NOT NULL REFERENCES tide_run(id) ON DELETE CASCADE,
345
+ reflex_id text NOT NULL,
346
+ unit text NOT NULL,
347
+ cause text NOT NULL,
348
+ env jsonb NOT NULL,
349
+ depth integer NOT NULL DEFAULT 0,
350
+ state text NOT NULL CHECK (state IN ('pending','claimed','retrying','done','failed')),
351
+ attempt integer NOT NULL DEFAULT 0,
352
+ token text,
353
+ -- Zero, never null, when unclaimed: "never claimed or lapsed" is then one
354
+ -- comparison rather than a disjunction.
355
+ claimed_until bigint NOT NULL DEFAULT 0,
356
+ not_before bigint NOT NULL,
357
+ input jsonb,
358
+ output jsonb,
359
+ error text,
360
+ created_at bigint NOT NULL,
361
+ settled_at bigint,
362
+ UNIQUE (run_id, unit)
363
+ );
364
+
365
+ CREATE INDEX IF NOT EXISTS tide_work_claimable ON tide_work (state, not_before, claimed_until);
366
+ CREATE INDEX IF NOT EXISTS tide_work_run ON tide_work (run_id);
367
+ CREATE INDEX IF NOT EXISTS tide_work_swept ON tide_work (settled_at);
368
+
369
+ CREATE TABLE IF NOT EXISTS tide_reflex_state (
370
+ reflex_id text PRIMARY KEY,
371
+ armed_at bigint NOT NULL DEFAULT 0,
372
+ materialized_through bigint
373
+ );
374
+
375
+ -- Polls are gone (the vex bridge pushes writes \u2014 a poll could only
376
+ -- re-discover them late), and their cursor state goes with them. IF EXISTS,
377
+ -- so a store created after the removal is not asked to drop what it never had.
378
+ ALTER TABLE tide_reflex_state DROP COLUMN IF EXISTS poll_cursor;
379
+ ALTER TABLE tide_reflex_state DROP COLUMN IF EXISTS poll_seen;
380
+ ALTER TABLE tide_reflex_state DROP COLUMN IF EXISTS polled_at;
381
+ `;
382
+ var statementsOf = (ddl) => ddl.split(";").map((chunk) => chunk.trim()).filter((chunk) => chunk.split("\n").some((line) => line.trim() !== "" && !line.trim().startsWith("--"))).map((sql) => ({ kind: "sql", sql }));
383
+ var TIDE_SEQUENCE = {
384
+ id: "nisc.moss.tide",
385
+ migrations: [
386
+ { description: "The tide store: facts, runs, work and reflex state, converged from any earlier shape", steps: statementsOf(TIDE_DDL) },
387
+ {
388
+ description: "A fact carries its chain root, and a root counts what its chain minted (tide maxChainFacts)",
389
+ steps: [
390
+ { kind: "sql", sql: "ALTER TABLE tide_fact ADD COLUMN IF NOT EXISTS root text" },
391
+ { kind: "sql", sql: "ALTER TABLE tide_fact ADD COLUMN IF NOT EXISTS descendants integer" }
392
+ ]
393
+ }
394
+ ]
395
+ };
396
+
397
+ // src/store/postgres/store.ts
398
+ var mintId = /* @__PURE__ */ (() => {
399
+ let sequence = 0;
400
+ return (table) => {
401
+ sequence += 1;
402
+ return `${table}_${Date.now().toString(36)}_${sequence.toString(36)}`;
403
+ };
404
+ })();
405
+ var createTideStore = (pool, options = {}) => {
406
+ const ready = options.migrate === false ? Promise.resolve() : migrate(pool, [TIDE_SEQUENCE]).then(() => void 0);
407
+ ready.catch(() => void 0);
408
+ const overPool = (fn) => {
409
+ if (pool.transaction === void 0)
410
+ throw new Error("tide store: this pool cannot transact \u2014 fan-out, attempt recording and a serial claim are transactions, not conventions");
411
+ return pool.transaction(fn);
412
+ };
413
+ const build = (client, atomically) => {
414
+ const store = {
415
+ query: async (spec) => {
416
+ await ready;
417
+ const where = compileWhere(spec.where, 1);
418
+ const limit = spec.limit === void 0 ? "" : ` LIMIT ${Math.max(0, Math.floor(spec.limit))}`;
419
+ const result = await client.query(
420
+ `SELECT * FROM ${SQL_TABLE[spec.table]} WHERE ${where.sql}${compileOrder(spec.order)}${limit}`,
421
+ where.params
422
+ );
423
+ return result.rows.map((row) => rowToEntity(spec.table, row));
424
+ },
425
+ // The refusal is the database's, decided under the constraint, not a read the caller races.
426
+ appendIfAbsent: async (table, input) => {
427
+ await ready;
428
+ const given = input;
429
+ const withId = PRIMARY_KEY[table] === "id" ? { ...given, id: input.id ?? mintId(table) } : given;
430
+ const entries = Object.entries(withId).filter(([, value]) => value !== void 0);
431
+ const columns = entries.map(([field]) => snake(field));
432
+ const params = entries.map(([field, value]) => toColumn(snake(field), value));
433
+ const unique = UNIQUE_BY[table];
434
+ const target = unique.when === void 0 ? `(${unique.by.map((column) => snake(column)).join(", ")})` : `(${unique.by.map((column) => column === "entity" || column === "name" ? `coalesce(${snake(column)},'')` : snake(column)).join(", ")}) WHERE ${snake(unique.when)} IS NOT NULL`;
435
+ const result = await client.query(
436
+ `INSERT INTO ${SQL_TABLE[table]} (${columns.join(", ")}) VALUES (${params.map((_value, index) => `$${index + 1}`).join(", ")})
437
+ ON CONFLICT ${target} DO NOTHING RETURNING *`,
438
+ params
439
+ );
440
+ const row = result.rows[0];
441
+ return row === void 0 ? void 0 : rowToEntity(table, row);
442
+ },
443
+ claim: claimOver({ client, atomically, ready }),
444
+ cas: async (table, id, expect, set) => {
445
+ await ready;
446
+ const key = snake(PRIMARY_KEY[table]);
447
+ const where = compileWhere(expect, 2);
448
+ const patch = compileSet(set, where.params.length + 2);
449
+ const result = await client.query(
450
+ `UPDATE ${SQL_TABLE[table]} SET ${patch.sql} WHERE ${key} = $1 AND ${where.sql} RETURNING ${key}`,
451
+ [id, ...where.params, ...patch.params]
452
+ );
453
+ return result.rows.length > 0;
454
+ },
455
+ remove: async (spec) => {
456
+ await ready;
457
+ const where = compileWhere(spec.where, 1);
458
+ const result = await client.query(`DELETE FROM ${SQL_TABLE[spec.table]} WHERE ${where.sql} RETURNING ${snake(PRIMARY_KEY[spec.table])}`, where.params);
459
+ return result.rows.length;
460
+ },
461
+ transact: async (fn) => {
462
+ await ready;
463
+ return atomically((tx) => fn(build(tx, (inner) => inner(tx))));
464
+ }
465
+ };
466
+ return store;
467
+ };
468
+ return { ...build(pool, overPool), ready };
469
+ };
470
+
471
+ export { TIDE_DDL, TIDE_SEQUENCE, TIDE_TABLES, createTideStore };
472
+ //# sourceMappingURL=postgres.js.map
473
+ //# sourceMappingURL=postgres.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/store/postgres/rows.ts","../src/store/postgres/compile.ts","../src/store/postgres/claim.ts","../src/store/postgres/tables.ts","../src/store/postgres/store.ts"],"names":["z","migrateLedger"],"mappings":"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","file":"postgres.js","sourcesContent":["import { z } from 'zod';\nimport { FactKindSchema, OpSchema } from '../../schemas';\nimport type { TableName, TideTables } from '../../types';\n\nexport const SQL_TABLE: Record<TableName, string> = {\n fact: 'tide_fact',\n run: 'tide_run',\n task: 'tide_work',\n state: 'tide_reflex_state',\n};\n\n// `as` is an SQL keyword: the one field whose column is named otherwise.\nconst COLUMN_OVERRIDES: Record<string, string> = { as: 'as_who' };\n\nexport const snake = (field: string): string => COLUMN_OVERRIDES[field] ?? field.replace(/[A-Z]/g, (c) => `_${c.toLowerCase()}`);\n\nconst camel = (column: string): string => {\n for (const [field, mapped] of Object.entries(COLUMN_OVERRIDES)) if (mapped === column) return field;\n return column.replace(/_([a-z])/g, (_all, c: string) => c.toUpperCase());\n};\n\nconst JSON_COLUMNS = new Set(['row', 'payload', 'stats', 'fact_ids', 'env', 'input', 'output']);\nconst BIGINT_COLUMNS = new Set([\n 'at',\n 'not_before',\n 'delivered_at',\n 'depth',\n 'descendants',\n 'due_at',\n 'created_at',\n 'settled_at',\n 'claimed_until',\n 'armed_at',\n 'materialized_through',\n 'attempt',\n 'selected',\n 'total',\n 'done',\n 'failed',\n]);\n\nexport const toColumn = (column: string, value: unknown): unknown => {\n if (value === undefined) return null;\n if (JSON_COLUMNS.has(column)) return JSON.stringify(value);\n return value;\n};\n\nconst fromColumn = (column: string, value: unknown): unknown => {\n if (value === null) return undefined;\n if (JSON_COLUMNS.has(column)) return typeof value === 'string' ? JSON.parse(value) : value;\n // `bigint` comes back as a string on some drivers and a number on others.\n // Tide compares these with `<`, so the difference is not cosmetic.\n if (BIGINT_COLUMNS.has(column)) return Number(value);\n return value;\n};\n\nconst FactRowSchema = z.object({\n id: z.string(),\n kind: FactKindSchema,\n entity: z.string().optional(),\n op: OpSchema.optional(),\n row: z.record(z.string(), z.unknown()).optional(),\n name: z.string().optional(),\n payload: z.unknown().optional(),\n reflex: z.string().optional(),\n runId: z.string().optional(),\n occurrence: z.string().optional(),\n stats: z.object({ total: z.number(), done: z.number(), failed: z.number() }).optional(),\n target: z.string().optional(),\n by: z.string().optional(),\n at: z.number(),\n notBefore: z.number().optional(),\n dedupeKey: z.string().optional(),\n cause: z.string().optional(),\n depth: z.number(),\n deliveredAt: z.number().optional(),\n parked: z.string().optional(),\n released: z.boolean().optional(),\n as: z.string().optional(),\n root: z.string().optional(),\n descendants: z.number().optional(),\n});\n\nconst RunRowSchema = z.object({\n id: z.string(),\n reflexId: z.string(),\n version: z.string(),\n as: z.string().optional(),\n cause: z.string(),\n occurrence: z.string().optional(),\n factIds: z.array(z.string()).optional(),\n state: z.enum(['pending', 'fanned', 'settled', 'skipped']),\n depth: z.number(),\n selected: z.number().optional(),\n total: z.number(),\n done: z.number(),\n failed: z.number(),\n dueAt: z.number(),\n createdAt: z.number(),\n settledAt: z.number().optional(),\n drained: z.boolean().optional(),\n note: z.string().optional(),\n});\n\nconst TaskRowSchema = z.object({\n id: z.string(),\n runId: z.string(),\n reflexId: z.string(),\n unit: z.string(),\n cause: z.string(),\n env: z.record(z.string(), z.unknown()),\n depth: z.number(),\n state: z.enum(['pending', 'claimed', 'retrying', 'done', 'failed']),\n attempt: z.number(),\n token: z.string().optional(),\n claimedUntil: z.number(),\n notBefore: z.number(),\n input: z.unknown().optional(),\n output: z.unknown().optional(),\n error: z.string().optional(),\n createdAt: z.number(),\n settledAt: z.number().optional(),\n});\n\nconst StateRowSchema = z.object({\n reflexId: z.string(),\n armedAt: z.number(),\n materializedThrough: z.number().optional(),\n});\n\nconst ROW_SCHEMAS: { [T in TableName]: z.ZodType<TideTables[T]> } = {\n fact: FactRowSchema,\n run: RunRowSchema,\n task: TaskRowSchema,\n state: StateRowSchema,\n};\n\nexport const rowToEntity = <T extends TableName>(table: T, row: Record<string, unknown>): TideTables[T] => {\n const entity: Record<string, unknown> = {};\n for (const [column, value] of Object.entries(row)) {\n const mapped = fromColumn(column, value);\n if (mapped !== undefined) entity[camel(column)] = mapped;\n }\n const read = ROW_SCHEMAS[table].safeParse(entity);\n if (!read.success) {\n const misfits = read.error.issues.map((issue) => `${issue.path.join('.')}: ${issue.message}`).join('; ');\n throw new Error(`tide store: a row of ${SQL_TABLE[table]} does not read as a ${table} (${misfits})`);\n }\n return read.data;\n};\n","import { z } from 'zod';\nimport type { Comparison, Order } from '../../types';\nimport { snake, toColumn } from './rows';\n\nexport type Fields = Readonly<Record<string, unknown>>;\ntype Ordering = readonly { by: string; dir?: 'asc' | 'desc' }[];\n\nconst COMPARATORS = [\n ['eq', '='],\n ['ne', '<>'],\n ['lt', '<'],\n ['lte', '<='],\n ['gt', '>'],\n ['gte', '>='],\n] as const;\n\nconst ComparisonSchema = z.object({\n eq: z.unknown().optional(),\n ne: z.unknown().optional(),\n lt: z.unknown().optional(),\n lte: z.unknown().optional(),\n gt: z.unknown().optional(),\n gte: z.unknown().optional(),\n in: z.array(z.unknown()).readonly().optional(),\n notIn: z.array(z.unknown()).readonly().optional(),\n isNull: z.boolean().optional(),\n}) satisfies z.ZodType<Comparison<unknown>>;\n\nconst comparisonOn = (field: string, test: object): Comparison<unknown> => {\n const read = ComparisonSchema.safeParse(test);\n if (read.success) return read.data;\n const misfits = read.error.issues.map((issue) => `${issue.path.join('.')}: ${issue.message}`).join('; ');\n throw new Error(`tide store: what \"${field}\" is compared with does not read as a comparison (${misfits})`);\n};\n\ntype Bind = { sql: string; params: unknown[] };\n\nexport const compileWhere = (where: Fields | undefined, start: number, alias = ''): Bind => {\n const clauses: string[] = [];\n const params: unknown[] = [];\n const prefix = alias === '' ? '' : `${alias}.`;\n const slot = (value: unknown): string => {\n params.push(value);\n return `$${start + params.length - 1}`;\n };\n\n for (const [field, test] of Object.entries(where ?? {})) {\n const column = `${prefix}${snake(field)}`;\n const bare = snake(field);\n if (test === null || typeof test !== 'object' || Array.isArray(test)) {\n // An equality on `undefined` means IS NULL, which is what the engine\n // means when it filters on a column it just cleared.\n clauses.push(test === undefined ? `${column} IS NULL` : `${column} = ${slot(toColumn(bare, test))}`);\n continue;\n }\n\n const comparison = comparisonOn(field, test);\n for (const [op, symbol] of COMPARATORS) {\n const operand = comparison[op];\n if (operand === undefined) continue;\n // `ne` must be true for a NULL column: a run that has never been\n // drained is not drained, and plain SQL `<>` answers NULL there.\n clauses.push(op === 'ne' ? `(${column} IS NULL OR ${column} <> ${slot(toColumn(bare, operand))})` : `${column} ${symbol} ${slot(toColumn(bare, operand))}`);\n }\n if (comparison.in !== undefined) clauses.push(`${column} = ANY(${slot(comparison.in.map((value) => toColumn(bare, value)))})`);\n if (comparison.notIn !== undefined) clauses.push(`NOT (${column} = ANY(${slot(comparison.notIn.map((value) => toColumn(bare, value)))}))`);\n if (comparison.isNull !== undefined) clauses.push(comparison.isNull ? `${column} IS NULL` : `${column} IS NOT NULL`);\n }\n\n return { sql: clauses.length === 0 ? 'TRUE' : clauses.join(' AND '), params };\n};\n\nexport const compileOrder = (order: Ordering | undefined, alias = ''): string => {\n if (order === undefined || order.length === 0) return '';\n const prefix = alias === '' ? '' : `${alias}.`;\n return ` ORDER BY ${order.map((key) => `${prefix}${snake(key.by)} ${key.dir === 'desc' ? 'DESC' : 'ASC'}`).join(', ')}`;\n};\n\nexport const sortRows = <R>(rows: readonly R[], order: Order<R> | undefined): R[] => {\n if (order === undefined || order.length === 0) return [...rows];\n return [...rows].sort((left, right) => {\n for (const key of order) {\n const a: unknown = left[key.by];\n const b: unknown = right[key.by];\n const compared = typeof a === 'number' && typeof b === 'number' ? a - b : String(a) < String(b) ? -1 : String(a) > String(b) ? 1 : 0;\n if (compared !== 0) return compared * (key.dir === 'desc' ? -1 : 1);\n }\n return 0;\n });\n};\n\nexport const compileSet = (set: Fields, start: number): Bind => {\n const assignments: string[] = [];\n const params: unknown[] = [];\n for (const [field, value] of Object.entries(set)) {\n const column = snake(field);\n if (value !== null && typeof value === 'object' && 'inc' in value) {\n // Column arithmetic, so two settling tasks cannot lose an increment\n // between a read and a write.\n assignments.push(`${column} = coalesce(${column}, 0) + ${Number(value.inc)}`);\n continue;\n }\n params.push(toColumn(column, value));\n assignments.push(`${column} = $${start + params.length - 1}`);\n }\n return { sql: assignments.join(', '), params };\n};\n","import type { ClaimSpec, TableName, TideStore } from '../../types';\nimport { compileOrder, compileSet, compileWhere, sortRows } from './compile';\nimport type { Fields } from './compile';\nimport type { Atomically, Client } from './pool';\nimport { SQL_TABLE, rowToEntity, snake } from './rows';\n\ntype ClaimParts = { client: Client; atomically: Atomically; ready: Promise<void> };\n\nexport const claimOver =\n ({ client, atomically, ready }: ClaimParts): TideStore['claim'] =>\n async <T extends TableName>(spec: ClaimSpec<T>) => {\n await ready;\n const table = SQL_TABLE[spec.table];\n const order = compileOrder(spec.order, 'c');\n\n const take =async (db: Client, extra: Fields, limit: number) => {\n if (limit <= 0) return [];\n const where = compileWhere({ ...spec.where, ...extra }, 1, 'c');\n const set = compileSet(spec.set, where.params.length + 1);\n const result = await db.query(\n `UPDATE ${table} SET ${set.sql}\n WHERE ctid IN (\n SELECT c.ctid FROM ${table} c WHERE ${where.sql}${order}\n LIMIT ${Math.floor(limit)} FOR UPDATE SKIP LOCKED\n )\n RETURNING *`,\n [...where.params, ...set.params],\n );\n // ORDER BY inside the subquery decides which rows are taken, not the order RETURNING hands them\n // back, and the engine runs tasks in the order a claim returns them: re-sorted, a fan-out runs\n // in insertion order here as it does in memory.\n return sortRows(result.rows.map((row) => rowToEntity(spec.table, row)), spec.order);\n };\n\n if (spec.onePer === undefined) return take(client, {}, spec.limit);\n\n // At most one held row per group, counting what an earlier claim already holds. Postgres refuses\n // a window function beside FOR UPDATE, so the restricted groups are claimed one at a time. Asking\n // whether a group is held and then claiming in it are two statements: they run in a transaction\n // behind an advisory lock on the group, because under READ COMMITTED two instances would both be\n // told nothing is held. Whoever does not get the lock leaves the group, as SKIP LOCKED leaves a\n // row.\n const { column, held, only } = spec.onePer;\n const restricted = [...only];\n // Room is reserved for the serial groups before the bulk claim, or a busy parallel reflex starves them.\n const claimed = await take(client, { [column]: { notIn: restricted } }, spec.limit - restricted.length);\n\n const takeOneOf = (group: string) =>\n atomically(async (tx) => {\n const lock = await tx.query('SELECT pg_try_advisory_xact_lock(hashtext($1), hashtext($2)) AS free', [`tide:${table}.${snake(column)}`, group]);\n if (lock.rows[0]?.['free'] !== true) return [];\n const busy = compileWhere({ ...held, [column]: group }, 1, 'c');\n const taken = await tx.query(`SELECT c.id FROM ${table} c WHERE ${busy.sql} LIMIT 1`, busy.params);\n if (taken.rows.length > 0) return [];\n return take(tx, { [column]: group }, 1);\n });\n\n for (const group of restricted) {\n if (claimed.length >= spec.limit) break;\n claimed.push(...(await takeOneOf(group)));\n }\n\n return claimed;\n };\n","import type { Sequence } from '@niscorp/strata';\n\nexport const TIDE_TABLES = ['tide_fact', 'tide_run', 'tide_work', 'tide_reflex_state'] as const;\n\n// Migration 1 of `nisc.moss.tide`: databases have run it, and editing it makes every one of them\n// refuse to boot (strata: EDITED). Change the tables by appending a migration to the sequence.\nexport const TIDE_DDL = `\nCREATE TABLE IF NOT EXISTS tide_fact (\n id text PRIMARY KEY,\n kind text NOT NULL CHECK (kind IN ('write','signal','manual','run')),\n entity text,\n op text CHECK (op IN ('insert','update','delete')),\n row jsonb,\n name text,\n payload jsonb,\n reflex text,\n run_id text,\n occurrence text,\n stats jsonb,\n target text,\n by text,\n at bigint NOT NULL,\n not_before bigint,\n dedupe_key text,\n cause text,\n depth integer NOT NULL DEFAULT 0,\n delivered_at bigint,\n parked text,\n released boolean,\n -- WHOSE FACT THIS IS. The identity of the reflex that minted it, absent on\n -- anything the host ingested. The matcher refuses to hand a fact minted\n -- under one identity to a reflex running under another, which is the only\n -- thing standing between a carried row and somebody else's effect — tide is\n -- the one place a row travels without being read, so no scope policy is\n -- consulted on the way.\n as_who text\n);\n\n-- A PARTIAL index, because a fact with no dedupeKey is not claiming to be\n-- unique: it is a distinct occurrence of something, not a repeat of it.\n-- entity is in the key: without it, two producers over different tables\n-- that agreed on a key value silently ate each other's rows.\nCREATE UNIQUE INDEX IF NOT EXISTS tide_fact_dedupe\n ON tide_fact (kind, coalesce(entity,''), coalesce(name,''), dedupe_key)\n WHERE dedupe_key IS NOT NULL;\n\n-- The matcher's query, every advance.\nCREATE INDEX IF NOT EXISTS tide_fact_due\n ON tide_fact (at) WHERE delivered_at IS NULL AND parked IS NULL;\nCREATE INDEX IF NOT EXISTS tide_fact_swept ON tide_fact (delivered_at);\n\nCREATE TABLE IF NOT EXISTS tide_run (\n id text PRIMARY KEY,\n reflex_id text NOT NULL,\n version text NOT NULL,\n as_who text,\n cause text NOT NULL,\n occurrence text,\n fact_ids jsonb,\n state text NOT NULL CHECK (state IN ('pending','fanned','settled','skipped')),\n depth integer NOT NULL DEFAULT 0,\n selected integer,\n total integer NOT NULL DEFAULT 0,\n done integer NOT NULL DEFAULT 0,\n failed integer NOT NULL DEFAULT 0,\n due_at bigint NOT NULL,\n created_at bigint NOT NULL,\n settled_at bigint,\n drained boolean,\n note text,\n -- THE IDEMPOTENCY. One constraint, every trigger kind: an occurrence\n -- cannot open twice, a replayed fact cannot open twice, and two instances\n -- ticking at the same moment contend instead of duplicating.\n UNIQUE (reflex_id, cause)\n);\n\nCREATE INDEX IF NOT EXISTS tide_run_pending ON tide_run (state, due_at);\nCREATE INDEX IF NOT EXISTS tide_run_ledger ON tide_run (reflex_id, created_at DESC);\nCREATE INDEX IF NOT EXISTS tide_run_swept ON tide_run (settled_at);\n\nCREATE TABLE IF NOT EXISTS tide_work (\n id text PRIMARY KEY,\n -- ON DELETE CASCADE, because a run and its work are one fact about the\n -- world. Sweeping runs and leaving work destroys the UNIQUE(run_id, unit)\n -- row that IS the \"this unit already ran\" record — and a restore then\n -- re-charges the invoice.\n run_id text NOT NULL REFERENCES tide_run(id) ON DELETE CASCADE,\n reflex_id text NOT NULL,\n unit text NOT NULL,\n cause text NOT NULL,\n env jsonb NOT NULL,\n depth integer NOT NULL DEFAULT 0,\n state text NOT NULL CHECK (state IN ('pending','claimed','retrying','done','failed')),\n attempt integer NOT NULL DEFAULT 0,\n token text,\n -- Zero, never null, when unclaimed: \"never claimed or lapsed\" is then one\n -- comparison rather than a disjunction.\n claimed_until bigint NOT NULL DEFAULT 0,\n not_before bigint NOT NULL,\n input jsonb,\n output jsonb,\n error text,\n created_at bigint NOT NULL,\n settled_at bigint,\n UNIQUE (run_id, unit)\n);\n\nCREATE INDEX IF NOT EXISTS tide_work_claimable ON tide_work (state, not_before, claimed_until);\nCREATE INDEX IF NOT EXISTS tide_work_run ON tide_work (run_id);\nCREATE INDEX IF NOT EXISTS tide_work_swept ON tide_work (settled_at);\n\nCREATE TABLE IF NOT EXISTS tide_reflex_state (\n reflex_id text PRIMARY KEY,\n armed_at bigint NOT NULL DEFAULT 0,\n materialized_through bigint\n);\n\n-- Polls are gone (the vex bridge pushes writes — a poll could only\n-- re-discover them late), and their cursor state goes with them. IF EXISTS,\n-- so a store created after the removal is not asked to drop what it never had.\nALTER TABLE tide_reflex_state DROP COLUMN IF EXISTS poll_cursor;\nALTER TABLE tide_reflex_state DROP COLUMN IF EXISTS poll_seen;\nALTER TABLE tide_reflex_state DROP COLUMN IF EXISTS polled_at;\n`;\n\n// Split on every `;`, for migration 1 only: a different split is a different history, and\n// this one's checksum is in every ledger. A new sequence uses strata's `sqlSteps`.\nconst statementsOf = (ddl: string): { kind: 'sql'; sql: string }[] =>\n ddl\n .split(';')\n .map((chunk) => chunk.trim())\n .filter((chunk) => chunk.split('\\n').some((line) => line.trim() !== '' && !line.trim().startsWith('--')))\n .map((sql) => ({ kind: 'sql', sql }));\n\n// The id says `moss` and stays: every ledger that has run this sequence holds its rows under it.\nexport const TIDE_SEQUENCE: Sequence = {\n id: 'nisc.moss.tide',\n migrations: [\n { description: 'The tide store: facts, runs, work and reflex state, converged from any earlier shape', steps: statementsOf(TIDE_DDL) },\n {\n description: 'A fact carries its chain root, and a root counts what its chain minted (tide maxChainFacts)',\n steps: [\n { kind: 'sql', sql: 'ALTER TABLE tide_fact ADD COLUMN IF NOT EXISTS root text' },\n { kind: 'sql', sql: 'ALTER TABLE tide_fact ADD COLUMN IF NOT EXISTS descendants integer' },\n ],\n },\n ],\n};\n","import { migrate as migrateLedger } from '@niscorp/strata/postgres';\nimport { PRIMARY_KEY, UNIQUE_BY } from '../../types';\nimport type { Mutation, QuerySpec, RemoveSpec, TableName, TideStore, TideTables, Where } from '../../types';\nimport { claimOver } from './claim';\nimport { compileOrder, compileSet, compileWhere } from './compile';\nimport type { Fields } from './compile';\nimport type { Atomically, Client, TidePool } from './pool';\nimport { SQL_TABLE, rowToEntity, snake, toColumn } from './rows';\nimport { TIDE_SEQUENCE } from './tables';\n\nconst mintId = ((): ((table: TableName) => string) => {\n let sequence = 0;\n return (table) => {\n sequence += 1;\n return `${table}_${Date.now().toString(36)}_${sequence.toString(36)}`;\n };\n})();\n\nexport type TideStoreOptions = {\n migrate?: boolean;\n};\n\nexport const createTideStore = (pool: TidePool, options: TideStoreOptions = {}): TideStore & { ready: Promise<void> } => {\n // Every method awaits this: on a real pool one that did not would race the DDL and throw `42P01 undefined_table`\n // inside a transaction, which the fan-out would turn into a permanently skipped run.\n const ready: Promise<void> = options.migrate === false ? Promise.resolve() : migrateLedger(pool, [TIDE_SEQUENCE]).then(() => undefined);\n // An unhandled rejection here is process-fatal on Node ≥ 15, and the\n // failure it reports would be a database that is not up yet.\n ready.catch(() => undefined);\n\n const overPool: Atomically = (fn) => {\n if (pool.transaction === undefined)\n throw new Error('tide store: this pool cannot transact — fan-out, attempt recording and a serial claim are transactions, not conventions');\n return pool.transaction(fn);\n };\n\n const build = (client: Client, atomically: Atomically): TideStore => {\n const store: TideStore = {\n query: async <T extends TableName>(spec: QuerySpec<T>) => {\n await ready;\n const where = compileWhere(spec.where, 1);\n const limit = spec.limit === undefined ? '' : ` LIMIT ${Math.max(0, Math.floor(spec.limit))}`;\n const result = await client.query(\n `SELECT * FROM ${SQL_TABLE[spec.table]} WHERE ${where.sql}${compileOrder(spec.order)}${limit}`,\n where.params,\n );\n return result.rows.map((row) => rowToEntity(spec.table, row));\n },\n\n // The refusal is the database's, decided under the constraint, not a read the caller races.\n appendIfAbsent: async <T extends TableName>(table: T, input: Omit<TideTables[T], 'id'> & { id?: string }) => {\n await ready;\n const given: Fields = input;\n const withId: Fields = PRIMARY_KEY[table] === 'id' ? { ...given, id: input.id ?? mintId(table) } : given;\n const entries = Object.entries(withId).filter(([, value]) => value !== undefined);\n const columns = entries.map(([field]) => snake(field));\n const params = entries.map(([field, value]) => toColumn(snake(field), value));\n\n const unique = UNIQUE_BY[table];\n const target =\n unique.when === undefined\n ? `(${unique.by.map((column) => snake(column)).join(', ')})`\n : `(${unique.by.map((column) => (column === 'entity' || column === 'name' ? `coalesce(${snake(column)},'')` : snake(column))).join(', ')}) WHERE ${snake(unique.when)} IS NOT NULL`;\n\n const result = await client.query(\n `INSERT INTO ${SQL_TABLE[table]} (${columns.join(', ')}) VALUES (${params.map((_value, index) => `$${index + 1}`).join(', ')})\n ON CONFLICT ${target} DO NOTHING RETURNING *`,\n params,\n );\n const row = result.rows[0];\n return row === undefined ? undefined : rowToEntity(table, row);\n },\n\n claim: claimOver({ client, atomically, ready }),\n\n cas: async <T extends TableName>(table: T, id: string, expect: Where<TideTables[T]>, set: Mutation<TideTables[T]>) => {\n await ready;\n const key = snake(PRIMARY_KEY[table]);\n const where = compileWhere(expect, 2);\n const patch = compileSet(set, where.params.length + 2);\n const result = await client.query(\n `UPDATE ${SQL_TABLE[table]} SET ${patch.sql} WHERE ${key} = $1 AND ${where.sql} RETURNING ${key}`,\n [id, ...where.params, ...patch.params],\n );\n return result.rows.length > 0;\n },\n\n remove: async <T extends TableName>(spec: RemoveSpec<T>) => {\n await ready;\n const where = compileWhere(spec.where, 1);\n // Work goes with its run through the foreign key, not through a\n // second statement somebody can forget.\n const result = await client.query(`DELETE FROM ${SQL_TABLE[spec.table]} WHERE ${where.sql} RETURNING ${snake(PRIMARY_KEY[spec.table])}`, where.params);\n return result.rows.length;\n },\n\n transact: async <T>(fn: (tx: TideStore) => Promise<T>): Promise<T> => {\n await ready;\n // Steps this store runs as one (`atomically`) run inside this transaction; none opens a second one.\n return atomically((tx) => fn(build(tx, (inner) => inner(tx))));\n },\n };\n return store;\n };\n\n return { ...build(pool, overPool), ready };\n};\n"]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@niscorp/tide",
3
- "version": "0.1.5",
3
+ "version": "0.1.6",
4
4
  "description": "Host-blind automation engine — a reflex turns the clock and the fact into one named effect, through a durable ledger.",
5
5
  "license": "Apache-2.0",
6
6
  "repository": {
@@ -41,6 +41,16 @@
41
41
  "default": "./dist/testing.cjs"
42
42
  }
43
43
  },
44
+ "./postgres": {
45
+ "import": {
46
+ "types": "./dist/postgres.d.ts",
47
+ "default": "./dist/postgres.js"
48
+ },
49
+ "require": {
50
+ "types": "./dist/postgres.d.cts",
51
+ "default": "./dist/postgres.cjs"
52
+ }
53
+ },
44
54
  "./package.json": "./package.json"
45
55
  },
46
56
  "files": [
@@ -56,18 +66,25 @@
56
66
  },
57
67
  "peerDependencies": {
58
68
  "zod": "^4.2.0",
59
- "@niscorp/cortex": "^0.1.3"
69
+ "@niscorp/cortex": "^0.1.3",
70
+ "@niscorp/strata": "^0.1.6"
60
71
  },
61
72
  "devDependencies": {
73
+ "@electric-sql/pglite": "^0.5.1",
74
+ "@types/node": "^26.1.1",
62
75
  "tsup": "^8.5.1",
63
76
  "typescript": "^6.0.2",
64
77
  "vitest": "^4.1.2",
65
78
  "zod": "^4.6.5",
66
- "@niscorp/cortex": "^0.1.3"
79
+ "@niscorp/cortex": "^0.1.3",
80
+ "@niscorp/strata": "^0.1.6"
67
81
  },
68
82
  "peerDependenciesMeta": {
69
83
  "@niscorp/cortex": {
70
84
  "optional": true
85
+ },
86
+ "@niscorp/strata": {
87
+ "optional": true
71
88
  }
72
89
  },
73
90
  "scripts": {