@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/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 { COMPARISON_OPS, PRIMARY_KEY, TideError, UNIQUE_BY, anchorDraft, createMemoryStore, createTide, daysInMonth, isTideError, occurrenceKey, occurrencesBetween, timerMs, versionOf, zonedParts, zonedToUtc };
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