@smthrs/triggers 0.0.0-stage → 1.0.0-rc.4

package/dist/cjs/DispatchReader.d.ts

@@ -0,0 +1,77 @@
+/**
+ * The `@smthrs/control` `DispatchReader` port served from a `TriggerStore`.
+ *
+ * `Control.list` answers `{ _tag: "triggers" }` and `{ _tag: "fires" }` through
+ * the port declared in `@smthrs/control/DispatchReader`. The port lives there
+ * because this package depends on control (the scheduler launches runs through
+ * it); the adapter lives here because only this package can read the store.
+ * The host composes the two: {@link layer} over the same store the scheduler
+ * writes.
+ *
+ * @see packages/smithers/agent/triggers/docs/api.md
+ *
+ * @since 1.0.0-rc.0
+ */
+import { type FireSummary, type TriggerSummary } from "@smthrs/control/ControlSchema";
+import * as Port from "@smthrs/control/DispatchReader";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import type { TriggerError } from "./TriggerError.ts";
+import { type FireRecord, type Held, type Registered, TriggerStore } from "./TriggerStore.ts";
+/**
+ * How many upcoming occurrences a trigger summary carries.
+ *
+ * @category constants
+ * @since 1.0.0-rc.0
+ */
+export declare const nextOccurrenceCount = 5;
+/**
+ * The next {@link nextOccurrenceCount} occurrences strictly after `now`, as
+ * epoch milliseconds in ascending order.
+ *
+ * @category getters
+ * @since 1.0.0-rc.0
+ */
+export declare const nextOccurrences: (trigger: Pick<Registered, "cron" | "timezone">, now: number) => Effect.Effect<ReadonlyArray<number>, TriggerError>;
+/**
+ * Maps one stored trigger and what it holds to the control plane's summary.
+ *
+ * A launch reservation is not a run the runtime knows about, so it is
+ * reported as no active run; the ledger still shows the claimed occurrence.
+ *
+ * @category constructors
+ * @since 1.0.0-rc.0
+ */
+export declare const toTriggerSummary: (trigger: Registered, held: Held, nextOccurrencesMs: ReadonlyArray<number>, schedulerLastTickMs: Option.Option<number>) => TriggerSummary;
+/**
+ * Maps one ledger row to the control plane's fire summary.
+ *
+ * @category constructors
+ * @since 1.0.0-rc.0
+ */
+export declare const toFireSummary: (record: FireRecord) => FireSummary;
+/**
+ * Builds the port over the ambient {@link TriggerStore}.
+ *
+ * `list` answers every trigger the store holds, taking each row's held state
+ * from the listing itself; `fires` pushes the request's filters into the
+ * ledger query and answers the matching rows newest first, reading only as
+ * many as the requested page needs.
+ * `Control.list` applies the filters again and pages. A store failure is a
+ * `PersistenceError` naming the listing that failed.
+ *
+ * @category constructors
+ * @since 1.0.0-rc.0
+ */
+export declare const make: Effect.Effect<Port.Service, never, TriggerStore>;
+/**
+ * Provides the control plane's `DispatchReader` from the ambient
+ * {@link TriggerStore}, so `Control.list` answers `triggers` and `fires` from
+ * the store the scheduler writes.
+ *
+ * @category layers
+ * @since 1.0.0-rc.0
+ */
+export declare const layer: Layer.Layer<Port.DispatchReader, never, TriggerStore>;
+//# sourceMappingURL=DispatchReader.d.ts.map

package/dist/cjs/DispatchReader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DispatchReader.d.ts","sourceRoot":"","sources":["../../src/DispatchReader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,EAAmB,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,+BAA+B,CAAA;AACtG,OAAO,KAAK,IAAI,MAAM,gCAAgC,CAAA;AAEtD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAGvC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,IAAI,EAAiB,KAAK,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAE5G;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,IAAI,CAAA;AAmBpC;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAC1B,SAAS,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,CAAC,EAC9C,KAAK,MAAM,KACV,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,YAAY,CAUhD,CAAA;AAEJ;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,GAC3B,SAAS,UAAU,EACnB,MAAM,IAAI,EACV,mBAAmB,aAAa,CAAC,MAAM,CAAC,EACxC,qBAAqB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,KACzC,cAgBD,CAAA;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,QAAQ,UAAU,KAAG,WAMjD,CAAA;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,YAAY,CAkChE,CAAA;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,EAAE,KAAK,EAAE,YAAY,CAA2C,CAAA"}

package/dist/cjs/DispatchReader.js

@@ -0,0 +1,121 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var DispatchReader_exports = {};
+__export(DispatchReader_exports, {
+  layer: () => layer,
+  make: () => make,
+  nextOccurrenceCount: () => nextOccurrenceCount,
+  nextOccurrences: () => nextOccurrences,
+  toFireSummary: () => toFireSummary,
+  toTriggerSummary: () => toTriggerSummary
+});
+module.exports = __toCommonJS(DispatchReader_exports);
+var import_ControlError = require("@smthrs/control/ControlError");
+var import_ControlSchema = require("@smthrs/control/ControlSchema");
+var Port = __toESM(require("@smthrs/control/DispatchReader"), 1);
+var Clock = __toESM(require("effect/Clock"), 1);
+var Effect = __toESM(require("effect/Effect"), 1);
+var Layer = __toESM(require("effect/Layer"), 1);
+var Option = __toESM(require("effect/Option"), 1);
+var Result = __toESM(require("effect/Result"), 1);
+var Cron = __toESM(require("./Cron.js"), 1);
+var import_TriggerStore = require("./TriggerStore.js");
+const nextOccurrenceCount = 5;
+const firesNeeded = (request) => {
+  const start = request.cursor === void 0 ? 0 : Number(request.cursor);
+  const size = request.limit ?? import_ControlSchema.defaultPageSize;
+  return Number.isSafeInteger(start) && start >= 0 && Number.isSafeInteger(size) && size >= 1 ? start + size + 1 : void 0;
+};
+const persistence = (operation) => (error) => new import_ControlError.PersistenceError({ operation, message: error.message, cause: error });
+const nextOccurrences = (trigger, now) => Effect.gen(function* () {
+  const cron = yield* Cron.parse(trigger.cron, trigger.timezone);
+  const occurrences = [];
+  let from = new Date(now);
+  while (occurrences.length < nextOccurrenceCount) {
+    from = yield* Cron.next(cron, from);
+    occurrences.push(from.getTime());
+  }
+  return occurrences;
+});
+const toTriggerSummary = (trigger, held, nextOccurrencesMs, schedulerLastTickMs) => ({
+  triggerId: trigger.id,
+  flowId: trigger.flowId,
+  input: trigger.input,
+  cron: trigger.cron,
+  ...trigger.timezone === void 0 ? {} : { timezone: trigger.timezone },
+  overlap: trigger.overlap,
+  catchUp: trigger.catchUp,
+  maxCatchUp: trigger.maxCatchUp,
+  enabled: trigger.enabled,
+  revision: trigger.revision,
+  ...trigger.lastFiredAt === void 0 ? {} : { lastFiredAtMs: trigger.lastFiredAt },
+  ...held.pendingAt === void 0 ? {} : { pendingAtMs: held.pendingAt },
+  ...held.activeRunId === void 0 || (0, import_TriggerStore.isReservation)(held.activeRunId) ? {} : { activeRunId: held.activeRunId },
+  nextOccurrencesMs,
+  ...Option.isSome(schedulerLastTickMs) ? { schedulerLastTickMs: schedulerLastTickMs.value } : {}
+});
+const toFireSummary = (record) => ({
+  triggerId: record.triggerId,
+  occurrenceAtMs: record.occurrence,
+  outcome: record.outcome,
+  ...record.runId === void 0 ? {} : { runId: record.runId },
+  ...record.error === void 0 ? {} : { error: record.error }
+});
+const make = Effect.gen(function* () {
+  const store = yield* import_TriggerStore.TriggerStore;
+  return Port.make({
+    list: Effect.fn("DispatchReader.list")(
+      () => Effect.gen(function* () {
+        const now = yield* Clock.currentTimeMillis;
+        const heartbeat = yield* store.lastHeartbeat();
+        const lastTick = Option.map(heartbeat, (beat) => beat.tickedAt);
+        const listing = yield* store.list();
+        return yield* Effect.forEach(listing, (row) => Effect.gen(function* () {
+          if (Result.isFailure(row.trigger)) return yield* Effect.fail(row.trigger.failure);
+          const trigger = row.trigger.success;
+          const upcoming = yield* nextOccurrences(trigger, now);
+          return toTriggerSummary(trigger, row, upcoming, lastTick);
+        }));
+      }).pipe(Effect.mapError(persistence("triggers")))
+    ),
+    fires: Effect.fn("DispatchReader.fires")(
+      (request) => store.history({
+        triggerId: request.filters?.triggerId,
+        runId: request.filters?.runId,
+        outcome: request.filters?.outcome,
+        limit: firesNeeded(request)
+      }).pipe(
+        Effect.map((page) => page.items.map(toFireSummary)),
+        Effect.mapError(persistence("fires"))
+      )
+    )
+  });
+});
+const layer = Layer.effect(Port.DispatchReader)(make);
+//# sourceMappingURL=DispatchReader.js.map

package/dist/cjs/DispatchReader.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/DispatchReader.ts"],
+  "sourcesContent": ["/**\n * The `@smthrs/control` `DispatchReader` port served from a `TriggerStore`.\n *\n * `Control.list` answers `{ _tag: \"triggers\" }` and `{ _tag: \"fires\" }` through\n * the port declared in `@smthrs/control/DispatchReader`. The port lives there\n * because this package depends on control (the scheduler launches runs through\n * it); the adapter lives here because only this package can read the store.\n * The host composes the two: {@link layer} over the same store the scheduler\n * writes.\n *\n * @see packages/smithers/agent/triggers/docs/api.md\n *\n * @since 1.0.0-rc.0\n */\n\nimport type { ControlError } from \"@smthrs/control/ControlError\"\nimport { PersistenceError } from \"@smthrs/control/ControlError\"\nimport { defaultPageSize, type FireSummary, type TriggerSummary } from \"@smthrs/control/ControlSchema\"\nimport * as Port from \"@smthrs/control/DispatchReader\"\nimport * as Clock from \"effect/Clock\"\nimport * as Effect from \"effect/Effect\"\nimport * as Layer from \"effect/Layer\"\nimport * as Option from \"effect/Option\"\nimport * as Result from \"effect/Result\"\nimport * as Cron from \"./Cron.ts\"\nimport type { TriggerError } from \"./TriggerError.ts\"\nimport { type FireRecord, type Held, isReservation, type Registered, TriggerStore } from \"./TriggerStore.ts\"\n\n/**\n * How many upcoming occurrences a trigger summary carries.\n *\n * @category constants\n * @since 1.0.0-rc.0\n */\nexport const nextOccurrenceCount = 5\n\n/**\n * How many ledger rows one `fires` page needs: every row before the page's\n * offset cursor, the page, and one more so `Control.list` can tell a next page\n * exists. A cursor Control will refuse reads nothing extra: it answers\n * `undefined`, and the refusal comes from Control.\n */\nconst firesNeeded = (request: Port.FiresRequest): number | undefined => {\n  const start = request.cursor === undefined ? 0 : Number(request.cursor)\n  const size = request.limit ?? defaultPageSize\n  return Number.isSafeInteger(start) && start >= 0 && Number.isSafeInteger(size) && size >= 1\n    ? start + size + 1\n    : undefined\n}\n\nconst persistence = (operation: string) => (error: TriggerError): ControlError =>\n  new PersistenceError({ operation, message: error.message, cause: error })\n\n/**\n * The next {@link nextOccurrenceCount} occurrences strictly after `now`, as\n * epoch milliseconds in ascending order.\n *\n * @category getters\n * @since 1.0.0-rc.0\n */\nexport const nextOccurrences = (\n  trigger: Pick<Registered, \"cron\" | \"timezone\">,\n  now: number\n): Effect.Effect<ReadonlyArray<number>, TriggerError> =>\n  Effect.gen(function*() {\n    const cron = yield* Cron.parse(trigger.cron, trigger.timezone)\n    const occurrences: Array<number> = []\n    let from = new Date(now)\n    while (occurrences.length < nextOccurrenceCount) {\n      from = yield* Cron.next(cron, from)\n      occurrences.push(from.getTime())\n    }\n    return occurrences\n  })\n\n/**\n * Maps one stored trigger and what it holds to the control plane's summary.\n *\n * A launch reservation is not a run the runtime knows about, so it is\n * reported as no active run; the ledger still shows the claimed occurrence.\n *\n * @category constructors\n * @since 1.0.0-rc.0\n */\nexport const toTriggerSummary = (\n  trigger: Registered,\n  held: Held,\n  nextOccurrencesMs: ReadonlyArray<number>,\n  schedulerLastTickMs: Option.Option<number>\n): TriggerSummary => ({\n  triggerId: trigger.id,\n  flowId: trigger.flowId,\n  input: trigger.input,\n  cron: trigger.cron,\n  ...(trigger.timezone === undefined ? {} : { timezone: trigger.timezone }),\n  overlap: trigger.overlap,\n  catchUp: trigger.catchUp,\n  maxCatchUp: trigger.maxCatchUp,\n  enabled: trigger.enabled,\n  revision: trigger.revision,\n  ...(trigger.lastFiredAt === undefined ? {} : { lastFiredAtMs: trigger.lastFiredAt }),\n  ...(held.pendingAt === undefined ? {} : { pendingAtMs: held.pendingAt }),\n  ...(held.activeRunId === undefined || isReservation(held.activeRunId) ? {} : { activeRunId: held.activeRunId }),\n  nextOccurrencesMs,\n  ...(Option.isSome(schedulerLastTickMs) ? { schedulerLastTickMs: schedulerLastTickMs.value } : {})\n})\n\n/**\n * Maps one ledger row to the control plane's fire summary.\n *\n * @category constructors\n * @since 1.0.0-rc.0\n */\nexport const toFireSummary = (record: FireRecord): FireSummary => ({\n  triggerId: record.triggerId,\n  occurrenceAtMs: record.occurrence,\n  outcome: record.outcome,\n  ...(record.runId === undefined ? {} : { runId: record.runId }),\n  ...(record.error === undefined ? {} : { error: record.error })\n})\n\n/**\n * Builds the port over the ambient {@link TriggerStore}.\n *\n * `list` answers every trigger the store holds, taking each row's held state\n * from the listing itself; `fires` pushes the request's filters into the\n * ledger query and answers the matching rows newest first, reading only as\n * many as the requested page needs.\n * `Control.list` applies the filters again and pages. A store failure is a\n * `PersistenceError` naming the listing that failed.\n *\n * @category constructors\n * @since 1.0.0-rc.0\n */\nexport const make: Effect.Effect<Port.Service, never, TriggerStore> = Effect.gen(function*() {\n  const store = yield* TriggerStore\n  return Port.make({\n    list: Effect.fn(\"DispatchReader.list\")(() =>\n      Effect.gen(function*() {\n        const now = yield* Clock.currentTimeMillis\n        const heartbeat = yield* store.lastHeartbeat()\n        const lastTick = Option.map(heartbeat, (beat) => beat.tickedAt)\n        const listing = yield* store.list()\n        return yield* Effect.forEach(listing, (row) =>\n          Effect.gen(function*() {\n            // A row the store could not decode fails the listing rather than\n            // being reported as a trigger with invented fields; the failure\n            // names the row. The listing already carries what `inspect` reads,\n            // so a summary costs no second read per trigger.\n            if (Result.isFailure(row.trigger)) return yield* Effect.fail(row.trigger.failure)\n            const trigger = row.trigger.success\n            const upcoming = yield* nextOccurrences(trigger, now)\n            return toTriggerSummary(trigger, row, upcoming, lastTick)\n          }))\n      }).pipe(Effect.mapError(persistence(\"triggers\")))\n    ),\n    fires: Effect.fn(\"DispatchReader.fires\")((request) =>\n      store.history({\n        triggerId: request.filters?.triggerId,\n        runId: request.filters?.runId,\n        outcome: request.filters?.outcome,\n        limit: firesNeeded(request)\n      }).pipe(\n        Effect.map((page) => page.items.map(toFireSummary)),\n        Effect.mapError(persistence(\"fires\"))\n      )\n    )\n  })\n})\n\n/**\n * Provides the control plane's `DispatchReader` from the ambient\n * {@link TriggerStore}, so `Control.list` answers `triggers` and `fires` from\n * the store the scheduler writes.\n *\n * @category layers\n * @since 1.0.0-rc.0\n */\nexport const layer: Layer.Layer<Port.DispatchReader, never, TriggerStore> = Layer.effect(Port.DispatchReader)(make)\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/cjs/Overlap.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Pure overlap policy decisions.
+ *
+ * @since 0.1.0
+ */
+import type { Overlap as Policy } from "./Schedule.ts";
+/**
+ * What the overlap decision is made from: whether a run is in flight, the
+ * buffered occurrence if any, and the occurrence now due.
+ *
+ * @category models
+ * @since 0.1.0
+ */
+export interface State {
+    readonly running: boolean;
+    readonly pending?: number | undefined;
+    readonly due: number;
+}
+/**
+ * What to do with an occurrence that arrived while a run was in flight.
+ *
+ * @category models
+ * @since 0.1.0
+ */
+export type Action = "fire" | "skip" | "buffer" | "supersede";
+/**
+ * Applies the overlap policy to the current state.
+ *
+ * @category decision
+ * @since 0.1.0
+ */
+export declare const decide: (policy: Policy, state: State) => Action;
+/**
+ * The occurrence left buffered after this decision.
+ *
+ * @category decision
+ * @since 0.1.0
+ */
+export declare const pendingAfter: (state: State) => number;
+//# sourceMappingURL=Overlap.d.ts.map

package/dist/cjs/Overlap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Overlap.d.ts","sourceRoot":"","sources":["../../src/Overlap.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,eAAe,CAAA;AAEtD;;;;;;GAMG;AACH,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACrC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CACrB;AACD;;;;;GAKG;AACH,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,CAAA;AAE7D;;;;;GAKG;AACH,eAAO,MAAM,MAAM,GAAI,QAAQ,MAAM,EAAE,OAAO,KAAK,KAAG,MAUrD,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,KAAK,KAAG,MAAwE,CAAA"}

package/dist/cjs/Overlap.js

@@ -0,0 +1,37 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var Overlap_exports = {};
+__export(Overlap_exports, {
+  decide: () => decide,
+  pendingAfter: () => pendingAfter
+});
+module.exports = __toCommonJS(Overlap_exports);
+const decide = (policy, state) => {
+  if (!state.running) return "fire";
+  switch (policy) {
+    case "skip":
+      return "skip";
+    case "buffer-one":
+      return "buffer";
+    case "supersede":
+      return "supersede";
+  }
+};
+const pendingAfter = (state) => Math.max(state.pending ?? Number.NEGATIVE_INFINITY, state.due);
+//# sourceMappingURL=Overlap.js.map

package/dist/cjs/Overlap.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/Overlap.ts"],
+  "sourcesContent": ["/**\n * Pure overlap policy decisions.\n *\n * @since 0.1.0\n */\n\nimport type { Overlap as Policy } from \"./Schedule.ts\"\n\n/**\n * What the overlap decision is made from: whether a run is in flight, the\n * buffered occurrence if any, and the occurrence now due.\n *\n * @category models\n * @since 0.1.0\n */\nexport interface State {\n  readonly running: boolean\n  readonly pending?: number | undefined\n  readonly due: number\n}\n/**\n * What to do with an occurrence that arrived while a run was in flight.\n *\n * @category models\n * @since 0.1.0\n */\nexport type Action = \"fire\" | \"skip\" | \"buffer\" | \"supersede\"\n\n/**\n * Applies the overlap policy to the current state.\n *\n * @category decision\n * @since 0.1.0\n */\nexport const decide = (policy: Policy, state: State): Action => {\n  if (!state.running) return \"fire\"\n  switch (policy) {\n    case \"skip\":\n      return \"skip\"\n    case \"buffer-one\":\n      return \"buffer\"\n    case \"supersede\":\n      return \"supersede\"\n  }\n}\n\n/**\n * The occurrence left buffered after this decision.\n *\n * @category decision\n * @since 0.1.0\n */\nexport const pendingAfter = (state: State): number => Math.max(state.pending ?? Number.NEGATIVE_INFINITY, state.due)\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAkCO,MAAM,SAAS,CAAC,QAAgB,UAAyB;AAC9D,MAAI,CAAC,MAAM,QAAS,QAAO;AAC3B,UAAQ,QAAQ;AAAA,IACd,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,EACX;AACF;AAQO,MAAM,eAAe,CAAC,UAAyB,KAAK,IAAI,MAAM,WAAW,OAAO,mBAAmB,MAAM,GAAG;",
+  "names": []
+}

package/dist/cjs/Schedule.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Reusable schedule declarations shared by triggers.
+ *
+ * @see packages/smithers/agent/triggers/docs/api.md
+ *
+ * @since 0.1.0
+ */
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+import { type TriggerError } from "./TriggerError.ts";
+/**
+ * Schedule overlap policies.
+ *
+ * @category schemas
+ * @since 0.1.0
+ */
+export declare const Overlap: Schema.Literals<readonly ["skip", "buffer-one", "supersede"]>;
+/**
+ * Schedule overlap policy.
+ *
+ * @category models
+ * @since 0.1.0
+ */
+export type Overlap = typeof Overlap.Type;
+/**
+ * Schedule catch-up policies.
+ *
+ * @category schemas
+ * @since 0.1.0
+ */
+export declare const CatchUp: Schema.Literals<readonly ["none", "one", "all"]>;
+/**
+ * Schedule catch-up policy.
+ *
+ * @category models
+ * @since 0.1.0
+ */
+export type CatchUp = typeof CatchUp.Type;
+/**
+ * The greatest catch-up bound a schedule may declare.
+ *
+ * A schedule may not owe more occurrences than one occurrence search returns,
+ * so the ceiling is the search's own cap.
+ *
+ * @category constants
+ * @since 0.1.0
+ */
+export declare const maxCatchUpLimit = 1000;
+/**
+ * A reusable cron schedule and its overlap and catch-up policies.
+ *
+ * All three policy fields are optional. `maxCatchUp` defaults to `0`, which
+ * pairs with the `catchUp` default of `none`: a schedule that states no
+ * catch-up intent owes nothing after downtime.
+ *
+ * @category schemas
+ * @since 0.1.0
+ */
+export declare const Schedule: Schema.Struct<{
+    readonly cron: Schema.NonEmptyString;
+    readonly timezone: Schema.optional<Schema.NonEmptyString>;
+    readonly overlap: Schema.withDecodingDefault<Schema.Literals<readonly ["skip", "buffer-one", "supersede"]>, never>;
+    readonly catchUp: Schema.withDecodingDefault<Schema.Literals<readonly ["none", "one", "all"]>, never>;
+    readonly maxCatchUp: Schema.withDecodingDefault<Schema.Int, never>;
+}>;
+/**
+ * A reusable cron schedule.
+ *
+ * @category models
+ * @since 0.1.0
+ */
+export type Schedule = typeof Schedule.Type;
+/**
+ * Refuses a declaration whose cron expression is malformed or which the
+ * calendar never satisfies.
+ *
+ * The schema types `cron` as a non-empty string, which is as much as a field
+ * schema can say: `0 0 30 2 *` passes every range check and matches no date.
+ * Only the occurrence search knows that, so every declaration path runs it
+ * here rather than leaving it to the tick that would have fired the trigger.
+ *
+ * @category constructors
+ * @since 0.1.0
+ */
+export declare const validate: <A extends {
+    readonly cron: string;
+    readonly timezone?: string | undefined;
+}>(declaration: A) => Effect.Effect<A, TriggerError>;
+/**
+ * Decodes and validates a schedule declaration.
+ *
+ * @category constructors
+ * @since 0.1.0
+ */
+export declare const make: (input: unknown) => Effect.Effect<Schedule, TriggerError>;
+//# sourceMappingURL=Schedule.d.ts.map

package/dist/cjs/Schedule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Schedule.d.ts","sourceRoot":"","sources":["../../src/Schedule.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAEtE;;;;;GAKG;AACH,eAAO,MAAM,OAAO,+DAAuD,CAAA;AAE3E;;;;;GAKG;AACH,MAAM,MAAM,OAAO,GAAG,OAAO,OAAO,CAAC,IAAI,CAAA;AAEzC;;;;;GAKG;AACH,eAAO,MAAM,OAAO,kDAA0C,CAAA;AAE9D;;;;;GAKG;AACH,MAAM,MAAM,OAAO,GAAG,OAAO,OAAO,CAAC,IAAI,CAAA;AAEzC;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,OAAsB,CAAA;AAElD;;;;;;;;;GASG;AACH,eAAO,MAAM,QAAQ;;;;;;EASnB,CAAA;AAEF;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,QAAQ,CAAC,IAAI,CAAA;AAE3C;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,SAAS;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,EAClG,aAAa,CAAC,KACb,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,YAAY,CAA+E,CAAA;AAE/G;;;;;GAKG;AACH,eAAO,MAAM,IAAI,GAAI,OAAO,OAAO,KAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,YAAY,CAIvE,CAAA"}

package/dist/cjs/Schedule.js

@@ -0,0 +1,61 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var Schedule_exports = {};
+__export(Schedule_exports, {
+  CatchUp: () => CatchUp,
+  Overlap: () => Overlap,
+  Schedule: () => Schedule,
+  make: () => make,
+  maxCatchUpLimit: () => maxCatchUpLimit,
+  validate: () => validate
+});
+module.exports = __toCommonJS(Schedule_exports);
+var Effect = __toESM(require("effect/Effect"), 1);
+var Schema = __toESM(require("effect/Schema"), 1);
+var Cron = __toESM(require("./Cron.js"), 1);
+var import_TriggerError = require("./TriggerError.js");
+const Overlap = Schema.Literals(["skip", "buffer-one", "supersede"]);
+const CatchUp = Schema.Literals(["none", "one", "all"]);
+const maxCatchUpLimit = Cron.maxOccurrences;
+const Schedule = Schema.Struct({
+  cron: Schema.NonEmptyString,
+  timezone: Schema.optional(Schema.NonEmptyString),
+  overlap: Overlap.pipe(Schema.withDecodingDefault(Effect.succeed("skip"))),
+  catchUp: CatchUp.pipe(Schema.withDecodingDefault(Effect.succeed("none"))),
+  maxCatchUp: Schema.Int.check(
+    Schema.isGreaterThanOrEqualTo(0),
+    Schema.isLessThanOrEqualTo(maxCatchUpLimit)
+  ).pipe(Schema.withDecodingDefault(Effect.succeed(0)))
+});
+const validate = (declaration) => Effect.as(Cron.parse(declaration.cron, declaration.timezone), declaration);
+const make = (input) => Schema.decodeUnknownEffect(Schedule)(input).pipe(
+  Effect.mapError((cause) => (0, import_TriggerError.fromSchemaError)("invalid_schedule", "Schedule declaration is invalid", cause)),
+  Effect.flatMap(validate)
+);
+//# sourceMappingURL=Schedule.js.map

package/dist/cjs/Schedule.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/Schedule.ts"],
+  "sourcesContent": ["/**\n * Reusable schedule declarations shared by triggers.\n *\n * @see packages/smithers/agent/triggers/docs/api.md\n *\n * @since 0.1.0\n */\n\nimport * as Effect from \"effect/Effect\"\nimport * as Schema from \"effect/Schema\"\nimport * as Cron from \"./Cron.ts\"\nimport { fromSchemaError, type TriggerError } from \"./TriggerError.ts\"\n\n/**\n * Schedule overlap policies.\n *\n * @category schemas\n * @since 0.1.0\n */\nexport const Overlap = Schema.Literals([\"skip\", \"buffer-one\", \"supersede\"])\n\n/**\n * Schedule overlap policy.\n *\n * @category models\n * @since 0.1.0\n */\nexport type Overlap = typeof Overlap.Type\n\n/**\n * Schedule catch-up policies.\n *\n * @category schemas\n * @since 0.1.0\n */\nexport const CatchUp = Schema.Literals([\"none\", \"one\", \"all\"])\n\n/**\n * Schedule catch-up policy.\n *\n * @category models\n * @since 0.1.0\n */\nexport type CatchUp = typeof CatchUp.Type\n\n/**\n * The greatest catch-up bound a schedule may declare.\n *\n * A schedule may not owe more occurrences than one occurrence search returns,\n * so the ceiling is the search's own cap.\n *\n * @category constants\n * @since 0.1.0\n */\nexport const maxCatchUpLimit = Cron.maxOccurrences\n\n/**\n * A reusable cron schedule and its overlap and catch-up policies.\n *\n * All three policy fields are optional. `maxCatchUp` defaults to `0`, which\n * pairs with the `catchUp` default of `none`: a schedule that states no\n * catch-up intent owes nothing after downtime.\n *\n * @category schemas\n * @since 0.1.0\n */\nexport const Schedule = Schema.Struct({\n  cron: Schema.NonEmptyString,\n  timezone: Schema.optional(Schema.NonEmptyString),\n  overlap: Overlap.pipe(Schema.withDecodingDefault(Effect.succeed(\"skip\" as const))),\n  catchUp: CatchUp.pipe(Schema.withDecodingDefault(Effect.succeed(\"none\" as const))),\n  maxCatchUp: Schema.Int.check(\n    Schema.isGreaterThanOrEqualTo(0),\n    Schema.isLessThanOrEqualTo(maxCatchUpLimit)\n  ).pipe(Schema.withDecodingDefault(Effect.succeed(0)))\n})\n\n/**\n * A reusable cron schedule.\n *\n * @category models\n * @since 0.1.0\n */\nexport type Schedule = typeof Schedule.Type\n\n/**\n * Refuses a declaration whose cron expression is malformed or which the\n * calendar never satisfies.\n *\n * The schema types `cron` as a non-empty string, which is as much as a field\n * schema can say: `0 0 30 2 *` passes every range check and matches no date.\n * Only the occurrence search knows that, so every declaration path runs it\n * here rather than leaving it to the tick that would have fired the trigger.\n *\n * @category constructors\n * @since 0.1.0\n */\nexport const validate = <A extends { readonly cron: string; readonly timezone?: string | undefined }>(\n  declaration: A\n): Effect.Effect<A, TriggerError> => Effect.as(Cron.parse(declaration.cron, declaration.timezone), declaration)\n\n/**\n * Decodes and validates a schedule declaration.\n *\n * @category constructors\n * @since 0.1.0\n */\nexport const make = (input: unknown): Effect.Effect<Schedule, TriggerError> =>\n  Schema.decodeUnknownEffect(Schedule)(input).pipe(\n    Effect.mapError((cause) => fromSchemaError(\"invalid_schedule\", \"Schedule declaration is invalid\", cause)),\n    Effect.flatMap(validate)\n  )\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAQA,aAAwB;AACxB,aAAwB;AACxB,WAAsB;AACtB,0BAAmD;AAQ5C,MAAM,UAAU,OAAO,SAAS,CAAC,QAAQ,cAAc,WAAW,CAAC;AAgBnE,MAAM,UAAU,OAAO,SAAS,CAAC,QAAQ,OAAO,KAAK,CAAC;AAmBtD,MAAM,kBAAkB,KAAK;AAY7B,MAAM,WAAW,OAAO,OAAO;AAAA,EACpC,MAAM,OAAO;AAAA,EACb,UAAU,OAAO,SAAS,OAAO,cAAc;AAAA,EAC/C,SAAS,QAAQ,KAAK,OAAO,oBAAoB,OAAO,QAAQ,MAAe,CAAC,CAAC;AAAA,EACjF,SAAS,QAAQ,KAAK,OAAO,oBAAoB,OAAO,QAAQ,MAAe,CAAC,CAAC;AAAA,EACjF,YAAY,OAAO,IAAI;AAAA,IACrB,OAAO,uBAAuB,CAAC;AAAA,IAC/B,OAAO,oBAAoB,eAAe;AAAA,EAC5C,EAAE,KAAK,OAAO,oBAAoB,OAAO,QAAQ,CAAC,CAAC,CAAC;AACtD,CAAC;AAsBM,MAAM,WAAW,CACtB,gBACmC,OAAO,GAAG,KAAK,MAAM,YAAY,MAAM,YAAY,QAAQ,GAAG,WAAW;AAQvG,MAAM,OAAO,CAAC,UACnB,OAAO,oBAAoB,QAAQ,EAAE,KAAK,EAAE;AAAA,EAC1C,OAAO,SAAS,CAAC,cAAU,qCAAgB,oBAAoB,mCAAmC,KAAK,CAAC;AAAA,EACxG,OAAO,QAAQ,QAAQ;AACzB;",
+  "names": []
+}