@niscorp/tide 0.1.4 → 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.
- package/CHANGELOG.md +66 -0
- package/DESIGN.md +40 -14
- package/DOCS.md +93 -6
- package/README.md +16 -4
- package/dist/chunk-4CUQXWVY.js +20 -0
- package/dist/chunk-4CUQXWVY.js.map +1 -0
- package/dist/index.cjs +95 -0
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +19 -1
- package/dist/index.d.ts +19 -1
- package/dist/index.js +97 -18
- package/dist/index.js.map +1 -1
- package/dist/postgres.cjs +596 -0
- package/dist/postgres.cjs.map +1 -0
- package/dist/postgres.d.cts +26 -0
- package/dist/postgres.d.ts +26 -0
- package/dist/postgres.js +473 -0
- package/dist/postgres.js.map +1 -0
- package/package.json +20 -3
package/dist/index.d.cts
CHANGED
|
@@ -270,6 +270,24 @@ type MemoryStore = TideStore & {
|
|
|
270
270
|
};
|
|
271
271
|
declare const createMemoryStore: () => MemoryStore;
|
|
272
272
|
|
|
273
|
+
type TideDriver = {
|
|
274
|
+
ingest: Tide['ingest'];
|
|
275
|
+
fire: (reflexId: string, options: {
|
|
276
|
+
now: number;
|
|
277
|
+
input?: unknown;
|
|
278
|
+
by?: string;
|
|
279
|
+
}) => Promise<Fact | undefined>;
|
|
280
|
+
wake: () => Promise<void>;
|
|
281
|
+
stop: () => Promise<void>;
|
|
282
|
+
};
|
|
283
|
+
type TideDriverConfig = {
|
|
284
|
+
tide: Tide;
|
|
285
|
+
now?: () => number;
|
|
286
|
+
janitorMs?: number;
|
|
287
|
+
retention?: Retention;
|
|
288
|
+
};
|
|
289
|
+
declare const createTideDriver: (config: TideDriverConfig) => TideDriver;
|
|
290
|
+
|
|
273
291
|
type LocalParts = {
|
|
274
292
|
year: number;
|
|
275
293
|
month: number;
|
|
@@ -299,4 +317,4 @@ declare const anchorDraft: (draft: ReflexDraft, anchor: {
|
|
|
299
317
|
tz: string;
|
|
300
318
|
}) => Reflex;
|
|
301
319
|
|
|
302
|
-
export { type AdvanceOptions, AdvanceReport, type Clock, type ClockOnce, ClockOnceSchema, type ClockRecurring, ClockRecurringSchema, ClockTriggerSchema, ClockUnitSchema, type Edge, Fact, FactInput, type GraphReport, LoadReport, type LocalDay, type LocalParts, ManualTriggerSchema, type MemoryStore, type Occurrence, type Op, OpSchema, type Policy, PolicySchema, type PreviewOptions, PreviewReport, Reflex, ReflexDraft, ReflexInput, ReflexState, Retention, type Retry, RetrySchema, Run, RunTriggerSchema, SignalTriggerSchema, Task, TaskState, type Tide, TideConfig, TideError, type TideErrorCode, TideStore, Timer, type Trigger, TriggerSchema, WEEKDAYS, type Weekday, WriteTriggerSchema, anchorDraft, createMemoryStore, createTide, daysInMonth, isTideError, occurrenceKey, occurrencesBetween, timerMs, versionOf, zonedParts, zonedToUtc };
|
|
320
|
+
export { type AdvanceOptions, AdvanceReport, type Clock, type ClockOnce, ClockOnceSchema, type ClockRecurring, ClockRecurringSchema, ClockTriggerSchema, ClockUnitSchema, type Edge, Fact, FactInput, type GraphReport, LoadReport, type LocalDay, type LocalParts, ManualTriggerSchema, type MemoryStore, type Occurrence, type Op, OpSchema, type Policy, PolicySchema, type PreviewOptions, PreviewReport, Reflex, ReflexDraft, ReflexInput, ReflexState, Retention, type Retry, RetrySchema, Run, RunTriggerSchema, SignalTriggerSchema, Task, TaskState, type Tide, TideConfig, type TideDriver, type TideDriverConfig, TideError, type TideErrorCode, TideStore, Timer, type Trigger, TriggerSchema, WEEKDAYS, type Weekday, WriteTriggerSchema, anchorDraft, createMemoryStore, createTide, createTideDriver, daysInMonth, isTideError, occurrenceKey, occurrencesBetween, timerMs, versionOf, zonedParts, zonedToUtc };
|
package/dist/index.d.ts
CHANGED
|
@@ -270,6 +270,24 @@ type MemoryStore = TideStore & {
|
|
|
270
270
|
};
|
|
271
271
|
declare const createMemoryStore: () => MemoryStore;
|
|
272
272
|
|
|
273
|
+
type TideDriver = {
|
|
274
|
+
ingest: Tide['ingest'];
|
|
275
|
+
fire: (reflexId: string, options: {
|
|
276
|
+
now: number;
|
|
277
|
+
input?: unknown;
|
|
278
|
+
by?: string;
|
|
279
|
+
}) => Promise<Fact | undefined>;
|
|
280
|
+
wake: () => Promise<void>;
|
|
281
|
+
stop: () => Promise<void>;
|
|
282
|
+
};
|
|
283
|
+
type TideDriverConfig = {
|
|
284
|
+
tide: Tide;
|
|
285
|
+
now?: () => number;
|
|
286
|
+
janitorMs?: number;
|
|
287
|
+
retention?: Retention;
|
|
288
|
+
};
|
|
289
|
+
declare const createTideDriver: (config: TideDriverConfig) => TideDriver;
|
|
290
|
+
|
|
273
291
|
type LocalParts = {
|
|
274
292
|
year: number;
|
|
275
293
|
month: number;
|
|
@@ -299,4 +317,4 @@ declare const anchorDraft: (draft: ReflexDraft, anchor: {
|
|
|
299
317
|
tz: string;
|
|
300
318
|
}) => Reflex;
|
|
301
319
|
|
|
302
|
-
export { type AdvanceOptions, AdvanceReport, type Clock, type ClockOnce, ClockOnceSchema, type ClockRecurring, ClockRecurringSchema, ClockTriggerSchema, ClockUnitSchema, type Edge, Fact, FactInput, type GraphReport, LoadReport, type LocalDay, type LocalParts, ManualTriggerSchema, type MemoryStore, type Occurrence, type Op, OpSchema, type Policy, PolicySchema, type PreviewOptions, PreviewReport, Reflex, ReflexDraft, ReflexInput, ReflexState, Retention, type Retry, RetrySchema, Run, RunTriggerSchema, SignalTriggerSchema, Task, TaskState, type Tide, TideConfig, TideError, type TideErrorCode, TideStore, Timer, type Trigger, TriggerSchema, WEEKDAYS, type Weekday, WriteTriggerSchema, anchorDraft, createMemoryStore, createTide, daysInMonth, isTideError, occurrenceKey, occurrencesBetween, timerMs, versionOf, zonedParts, zonedToUtc };
|
|
320
|
+
export { type AdvanceOptions, AdvanceReport, type Clock, type ClockOnce, ClockOnceSchema, type ClockRecurring, ClockRecurringSchema, ClockTriggerSchema, ClockUnitSchema, type Edge, Fact, FactInput, type GraphReport, LoadReport, type LocalDay, type LocalParts, ManualTriggerSchema, type MemoryStore, type Occurrence, type Op, OpSchema, type Policy, PolicySchema, type PreviewOptions, PreviewReport, Reflex, ReflexDraft, ReflexInput, ReflexState, Retention, type Retry, RetrySchema, Run, RunTriggerSchema, SignalTriggerSchema, Task, TaskState, type Tide, TideConfig, type TideDriver, type TideDriverConfig, TideError, type TideErrorCode, TideStore, Timer, type Trigger, TriggerSchema, WEEKDAYS, type Weekday, WriteTriggerSchema, anchorDraft, createMemoryStore, createTide, createTideDriver, daysInMonth, isTideError, occurrenceKey, occurrencesBetween, timerMs, versionOf, zonedParts, zonedToUtc };
|
package/dist/index.js
CHANGED
|
@@ -1,3 +1,5 @@
|
|
|
1
|
+
import { UNIQUE_BY, PRIMARY_KEY, COMPARISON_OPS } from './chunk-4CUQXWVY.js';
|
|
2
|
+
export { COMPARISON_OPS, PRIMARY_KEY, UNIQUE_BY } from './chunk-4CUQXWVY.js';
|
|
1
3
|
import { isRecurring, ReflexSchema, FactInputSchema, clockOf, factOf, WEEKDAYS, isManual } from './chunk-UEG3UZDG.js';
|
|
2
4
|
export { ClockOnceSchema, ClockRecurringSchema, ClockTriggerSchema, ClockUnitSchema, DRAFT_TRIGGERS, EffectRefSchema, FactInputSchema, FactKindSchema, ManualTriggerSchema, OpSchema, PolicySchema, ReflexDraftSchema, ReflexSchema, RetrySchema, RunTriggerSchema, SelectionSchema, SignalTriggerSchema, TimerSchema, TimerTriggerSchema, TriggerSchema, WEEKDAYS, WriteTriggerSchema, draftSchemaOf } from './chunk-UEG3UZDG.js';
|
|
3
5
|
|
|
@@ -1149,23 +1151,6 @@ var createTide = (config) => {
|
|
|
1149
1151
|
};
|
|
1150
1152
|
};
|
|
1151
1153
|
|
|
1152
|
-
// src/types.ts
|
|
1153
|
-
var PRIMARY_KEY = {
|
|
1154
|
-
fact: "id",
|
|
1155
|
-
run: "id",
|
|
1156
|
-
task: "id",
|
|
1157
|
-
state: "reflexId"
|
|
1158
|
-
};
|
|
1159
|
-
var UNIQUE_BY = {
|
|
1160
|
-
// `entity` is part of the key. Without it two polls over different tables
|
|
1161
|
-
// that happened to agree on a cursor value silently ate each other's rows.
|
|
1162
|
-
fact: { by: ["kind", "entity", "name", "dedupeKey"], when: "dedupeKey" },
|
|
1163
|
-
run: { by: ["reflexId", "cause"] },
|
|
1164
|
-
task: { by: ["runId", "unit"] },
|
|
1165
|
-
state: { by: ["reflexId"] }
|
|
1166
|
-
};
|
|
1167
|
-
var COMPARISON_OPS = ["eq", "ne", "lt", "lte", "gt", "gte", "in", "notIn", "isNull"];
|
|
1168
|
-
|
|
1169
1154
|
// src/store/memory.ts
|
|
1170
1155
|
var ID_PREFIX = { fact: "fact", run: "run", task: "task", state: "st" };
|
|
1171
1156
|
var isComparison = (value) => {
|
|
@@ -1315,6 +1300,100 @@ var createMemoryStore = () => {
|
|
|
1315
1300
|
return store;
|
|
1316
1301
|
};
|
|
1317
1302
|
|
|
1303
|
+
// src/driver.ts
|
|
1304
|
+
var DEFAULT_JANITOR_MS = 3e5;
|
|
1305
|
+
var MAX_STEPS_PER_DRAIN = 1e4;
|
|
1306
|
+
var LONGEST_TIMER_MS = 2 ** 31 - 1;
|
|
1307
|
+
var waitable = (ms) => Math.min(ms, LONGEST_TIMER_MS);
|
|
1308
|
+
var letProcessEnd = (timer) => {
|
|
1309
|
+
if (typeof timer !== "object" || timer === null || !("unref" in timer)) return;
|
|
1310
|
+
const unref = timer.unref;
|
|
1311
|
+
if (typeof unref === "function") Reflect.apply(unref, timer, []);
|
|
1312
|
+
};
|
|
1313
|
+
var progressOf = (report) => report.materialized + report.skippedOccurrences + report.factsMatched + report.runsCreated + report.tasksCreated + report.executed + report.reclaimed + report.runsSettled + report.parked;
|
|
1314
|
+
var createTideDriver = (config) => {
|
|
1315
|
+
const { tide } = config;
|
|
1316
|
+
const now = config.now ?? (() => Date.now());
|
|
1317
|
+
const janitorMs = waitable(config.janitorMs ?? DEFAULT_JANITOR_MS);
|
|
1318
|
+
let running = false;
|
|
1319
|
+
let queued = false;
|
|
1320
|
+
let stopped = false;
|
|
1321
|
+
let cycle;
|
|
1322
|
+
let scheduling;
|
|
1323
|
+
let timer;
|
|
1324
|
+
const drain = async () => {
|
|
1325
|
+
for (let steps = 0; steps < MAX_STEPS_PER_DRAIN; steps += 1) {
|
|
1326
|
+
const report = await tide.advance({ now: now() });
|
|
1327
|
+
if (progressOf(report) === 0) return;
|
|
1328
|
+
}
|
|
1329
|
+
console.error(`[tide:driver] a drain exceeded ${MAX_STEPS_PER_DRAIN} steps \u2014 stopping this pass; the janitor will resume it`);
|
|
1330
|
+
};
|
|
1331
|
+
const schedule = async () => {
|
|
1332
|
+
if (stopped) return;
|
|
1333
|
+
let due;
|
|
1334
|
+
try {
|
|
1335
|
+
due = await tide.nextDue(now());
|
|
1336
|
+
} catch (err) {
|
|
1337
|
+
if (!stopped) console.error("[tide:driver] next due", err);
|
|
1338
|
+
return;
|
|
1339
|
+
}
|
|
1340
|
+
if (stopped) return;
|
|
1341
|
+
if (timer !== void 0) clearTimeout(timer);
|
|
1342
|
+
if (due === void 0) return;
|
|
1343
|
+
const delay = due - now();
|
|
1344
|
+
timer = setTimeout(() => void wake(), delay > 0 ? waitable(delay) : janitorMs);
|
|
1345
|
+
letProcessEnd(timer);
|
|
1346
|
+
};
|
|
1347
|
+
const wake = () => {
|
|
1348
|
+
if (stopped) return Promise.resolve();
|
|
1349
|
+
queued = true;
|
|
1350
|
+
if (running) return cycle ?? Promise.resolve();
|
|
1351
|
+
running = true;
|
|
1352
|
+
cycle = (async () => {
|
|
1353
|
+
try {
|
|
1354
|
+
while (queued) {
|
|
1355
|
+
queued = false;
|
|
1356
|
+
await drain();
|
|
1357
|
+
}
|
|
1358
|
+
} catch (err) {
|
|
1359
|
+
console.error("[tide:driver]", err);
|
|
1360
|
+
} finally {
|
|
1361
|
+
running = false;
|
|
1362
|
+
cycle = void 0;
|
|
1363
|
+
scheduling = schedule();
|
|
1364
|
+
}
|
|
1365
|
+
})();
|
|
1366
|
+
return cycle;
|
|
1367
|
+
};
|
|
1368
|
+
const janitor = setInterval(() => {
|
|
1369
|
+
if (config.retention !== void 0) {
|
|
1370
|
+
void tide.sweep(now(), config.retention).catch((err) => console.error("[tide:driver] sweep", err));
|
|
1371
|
+
}
|
|
1372
|
+
void wake();
|
|
1373
|
+
}, janitorMs);
|
|
1374
|
+
letProcessEnd(janitor);
|
|
1375
|
+
return {
|
|
1376
|
+
ingest: async (fact, options) => {
|
|
1377
|
+
const stored = await tide.ingest(fact, options);
|
|
1378
|
+
if (stored !== void 0) void wake();
|
|
1379
|
+
return stored;
|
|
1380
|
+
},
|
|
1381
|
+
fire: async (reflexId, options) => {
|
|
1382
|
+
const fact = await tide.fire(reflexId, options);
|
|
1383
|
+
void wake();
|
|
1384
|
+
return fact;
|
|
1385
|
+
},
|
|
1386
|
+
wake,
|
|
1387
|
+
stop: async () => {
|
|
1388
|
+
stopped = true;
|
|
1389
|
+
clearInterval(janitor);
|
|
1390
|
+
if (timer !== void 0) clearTimeout(timer);
|
|
1391
|
+
await cycle;
|
|
1392
|
+
await scheduling;
|
|
1393
|
+
}
|
|
1394
|
+
};
|
|
1395
|
+
};
|
|
1396
|
+
|
|
1318
1397
|
// src/engine/anchor.ts
|
|
1319
1398
|
var timerMs = (timer) => (((timer.hours ?? 0) * 60 + (timer.minutes ?? 0)) * 60 + (timer.seconds ?? 0)) * 1e3;
|
|
1320
1399
|
var pad22 = (value) => String(value).padStart(2, "0");
|
|
@@ -1328,6 +1407,6 @@ var anchorDraft = (draft, anchor) => {
|
|
|
1328
1407
|
return ReflexSchema.parse({ ...draft, on: { clock: { at: localDateTime(fires, anchor.tz), tz: anchor.tz } } });
|
|
1329
1408
|
};
|
|
1330
1409
|
|
|
1331
|
-
export {
|
|
1410
|
+
export { TideError, anchorDraft, createMemoryStore, createTide, createTideDriver, daysInMonth, isTideError, occurrenceKey, occurrencesBetween, timerMs, versionOf, zonedParts, zonedToUtc };
|
|
1332
1411
|
//# sourceMappingURL=index.js.map
|
|
1333
1412
|
//# sourceMappingURL=index.js.map
|