@toa.io/extensions.cadence 1.0.0-alpha.324 → 1.0.0-alpha.326

package/components/cadence.metronome/operations/delay.js

@@ -1,31 +1,13 @@
-import { LANES } from '@toa.io/extensions.cadence'
+import { row } from '@toa.io/extensions.cadence'
 
 /**
  * A call to make later. The request carries no query, so the transition is handed a new object.
- *
- * The lane is random, not one this replica owns. An outbox row is written into an owned lane so
- * that in steady state a replica settles its own rows before it ever reads them — but a delayed
- * row has no immediate path to settle, so nothing is gained, and an even spread is what the
- * dispatchers want.
+ * What is stored of it is what `row` says, which a schedule stores as well.
  */
 export function transition(input, entry) {
-  const due = Date.now() + input.interval
+  const { endpoint, interval, overdue, request, trail } = input
 
-  entry.lane = Math.floor(Math.random() * LANES)
-  entry.due = due
-  entry.endpoint = input.endpoint
-
-  // absolute, because the bound is the caller's and a scan reads rows of many callers at once.
-  // No bound is the end of representable time rather than an absent field, so that one
-  // comparison answers for every row
-  entry.expires = input.overdue === null ? Number.MAX_SAFE_INTEGER : due + input.overdue
-
-  // a call that takes no request has none: the entity's `request` is an object where it is
-  // there at all, and a null would not fit it
-  if (input.request !== undefined) entry.request = input.request
-
-  // the chain that asked for the call, absent where the caller unchained it
-  if (input.trail !== undefined) entry.trail = input.trail
+  Object.assign(entry, row({ endpoint, due: Date.now() + interval, overdue, request, trail }))
 
   return entry.id
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toa.io/extensions.cadence",
-  "version": "1.0.0-alpha.324",
+  "version": "1.0.0-alpha.326",
   "type": "module",
   "description": "Toa Schedule",
   "author": "temich <tema.gurtovoy@gmail.com>",
@@ -26,14 +26,14 @@
     "!**/.env*"
   ],
   "dependencies": {
-    "@toa.io/core": "1.0.0-alpha.323",
-    "@toa.io/definitions": "1.0.0-alpha.324",
+    "@toa.io/core": "1.0.0-alpha.326",
+    "@toa.io/definitions": "1.0.0-alpha.326",
     "@toa.io/generic": "1.0.0-alpha.311",
-    "@toa.io/schemas": "1.0.0-alpha.311",
+    "@toa.io/schemas": "1.0.0-alpha.326",
     "openspan": "1.0.0-alpha.323"
   },
   "scripts": {
     "transpile": "tsc"
   },
-  "gitHead": "eedcbb7b90b3ea759f200b0d03c7ae13a8487b9d"
+  "gitHead": "60f11bdc805d0c39bcb06064b2218b11114a35ad"
 }

package/readme.md

@@ -2,12 +2,13 @@
 
 Calls a component makes to itself, and calls it puts off.
 
-A **pulse** calls an operation of its own component on a cadence its manifest states. A **delay**
-hands one call over to be made later.
+A **pulse** calls an operation of its own component on a cadence its manifest states. A
+**schedule** calls one at the moments of a calendar. A **delay** hands one call over to be made
+later.
 
-A delay, and a pulse that is the component's rather than each replica's, rest on
+A delay, a schedule, and a pulse that is the component's rather than each replica's, rest on
 [`atomicity`](/connectors/atomicity), which is what keeps two replicas from making one call and
-where that promise is written down. Where it is not configured, neither is made at all. A pulse
+where that promise is written down. Where it is not configured, none of them is made at all. A pulse
 declared [`scope: replica`](#in-one-replica-or-in-every-one) asks nothing of it and is made
 either way.
 
@@ -48,8 +49,8 @@ for.
 
 A cycle is measured from the Unix epoch rather than from a calendar, so `86400` means UTC
 midnight and `3600` the top of the hour. A cycle that is not a divisor of a day lands on a
-boundary that is not any particular time of day. Time zones and calendar months are not
-supported.
+boundary that is not any particular time of day. A time of day in a time zone, a day of the week
+or of the month is what a [schedule](#schedule) states.
 
 ### In one replica, or in every one
 
@@ -88,8 +89,8 @@ what in its share is still due, rather than everything in its share, and a misse
 a delay instead of a day. An operation written the other way loses a day's work to a
 thirty-second rollout.
 
-Where a call has to happen even if nothing was running when it came due, it needs a stored
-schedule: [`delay`](#delay) is one.
+Where a call has to happen even if nothing was running when it came due, it has to be stored: a
+[schedule](#schedule) is, and so is a [`delay`](#delay).
 
 **An interval is called once.** Two calls for one interval need the clocks of two machines to
 disagree and the work to change hands in the same moment, which is a window the width of that
@@ -115,6 +116,126 @@ the day's calls: the cycle is spread over _time_, not over the fleet. Replicas b
 make none. How much of the fleet calls is what [`scope`](#in-one-replica-or-in-every-one) says,
 and it is the only thing that says it.
 
+## Schedule
+
+```yaml
+# manifest.toa.yaml
+cadence:
+  report: 0 12 * * 1-5 # noon UTC on weekdays
+  digest:
+    schedule: 0 9 * * 1 # nine on Monday morning
+    zone: Europe/Berlin # in Berlin
+    overdue: 3600 # seconds it may be late and still be made
+```
+
+A string is a schedule, where a number is a [pulse](#pulse). It is a cron expression of five
+fields — minute, hour, day of the month, month, day of the week — or of six, where the first is
+seconds.
+
+An expression that begins with `*` is quoted, because YAML reads a leading `*` as its own:
+
+```yaml
+# manifest.toa.yaml
+cadence:
+  poll: '*/5 * * * *' # every five minutes
+```
+
+|            |                                                                               |
+| ---------- | ----------------------------------------------------------------------------- |
+| `schedule` | the cron expression                                                           |
+| `zone`     | the [time zone](https://www.iana.org/time-zones) it is read in, `UTC` by default |
+| `overdue`  | seconds a call may be late and still be made; until the next one by default   |
+| `region`   | the region that makes it; see [Regions](#in-one-region-or-in-every-one)       |
+
+The operation is called with the moment the call was scheduled for:
+
+```javascript
+async function report({ at }, context) {}
+```
+
+`at` is milliseconds since the epoch, and it is the moment of the schedule rather than of the
+call: a report made twenty minutes late is still the report for noon. Compute the period from it
+and not from the clock.
+
+A schedule may name any operation a pulse may.
+
+### What to expect
+
+Each occurrence is a [delayed call](#delay), handed over ahead of its moment, and what a delayed
+call [may and may not do](#what-to-expect-2) holds for it.
+
+**A call is made late rather than lost.** An occurrence is stored as soon as the one before it
+comes due, so a component that is down at noon is called when it is back, with the `at` of noon.
+
+**It is not made once the next one is due.** At most one occurrence is ever owed: a component
+that was away from Friday to Monday is called for Monday and not for Friday, and an outage of a
+month does not come back as thirty calls. `overdue` states a tighter bound, in seconds, and is
+subject to [`discreteness`](#discreteness) as a delay's is.
+
+**An occurrence is lost where the component did not run at all** between the one before it and
+its own moment. Nothing was there to store it.
+
+**A call may be made more than once**, so where a second one would cost something the operation
+refuses it by `at`.
+
+**Nothing keeps a call from being made while the one before it is running.** A pulse skips an
+interval its work did not fit in; a schedule does not.
+
+**A schedule changed or removed may be called once more**, at the moment it had already been
+stored for.
+
+**Seconds are served as coarsely as delays are.** An occurrence closer than `discreteness` to the
+one before it is made at the next pass rather than at its moment.
+
+## Several entries
+
+An operation takes a list where it has more than one entry, of either kind:
+
+```yaml
+# manifest.toa.yaml
+cadence:
+  sweep:
+    - cycle: 3600 # what is due, every hour
+    - schedule: 0 3 1 * * # and everything, on the first of the month
+```
+
+The entries are independent of one another, and nothing keeps their calls apart. An operation
+given both kinds is called with `{ n, i }` by one and `{ at }` by the other. Two schedules of one
+operation that fall on the same moment are one call.
+
+## In one region, or in every one
+
+An application deployed as [several regions](/extensions/convergence) has every region make every
+pulse and every schedule, each for itself. An entry of either kind that is work for the whole
+application names the region that makes it, by rank:
+
+```yaml
+# manifest.toa.yaml
+cadence:
+  sweep:
+    cycle: 3600
+    region: 0 # a pulse only region 0 makes
+  invoice:
+    schedule: 0 6 1 * *
+    region: 0 # a schedule made once, however many regions there are
+  digest:
+    - schedule: 0 9 * * 1
+      zone: Europe/Berlin
+      region: 0
+    - schedule: 0 9 * * 1
+      zone: America/New_York
+      region: 1
+```
+
+**An entry that names a rank no region has is never made**, and nothing says so: a deployment
+reads only its own declaration. An application that is one place is rank `0`.
+
+A region that is gone has its entries made by the one that
+[takes its delayed calls over](#regions), by the same setting.
+
+`region` is not stated beside `scope: replica`: what lives in a process is that process's own in
+every region.
+
 ## Delay
 
 ```javascript
@@ -288,7 +409,8 @@ for the call, and a deployment makes the calls of the region it is. So there is
 for this to be right, and a single-region application never meets it.
 
 **`regions` is how a region that is gone is taken over.** Redeploy a surviving region naming the
-lost one's rank beside its own, and it makes both:
+lost one's rank beside its own, and it makes both — the delayed calls of the lost region, and the
+pulses and schedules [declared for it](#in-one-region-or-in-every-one):
 
 ```yaml
 cadence:

package/transpiled/Factory.d.ts

@@ -7,7 +7,7 @@ export declare class Factory implements extensions.Factory {
     constructor(host: Host);
     /**
      * What runs beside a component. Its own component gets the dispatcher; everyone else gets a
-     * timer per operation they declared a cadence for.
+     * timer per entry they declared.
      *
      * A tenant is created before the components of its composition are, which is why nothing here
      * reaches for one.

package/transpiled/Factory.js

@@ -1,10 +1,11 @@
 import { Connector, Locator } from '@toa.io/core';
 import { Composition } from './Composition.js';
-import { COMPONENT, NAMESPACE } from '@toa.io/definitions/extensions.cadence';
+import { COMPONENT, NAMESPACE, regions } from '@toa.io/definitions/extensions.cadence';
 import { Aspect } from './Aspect.js';
 import { Dispatcher } from './Dispatcher.js';
 import { Local } from './Local.js';
 import { Pulse } from './Pulse.js';
+import { Schedule } from './Schedule.js';
 export class Factory {
     host;
     /** one per component, however much of this extension calls through it */
@@ -14,7 +15,7 @@ export class Factory {
     }
     /**
      * What runs beside a component. Its own component gets the dispatcher; everyone else gets a
-     * timer per operation they declared a cadence for.
+     * timer per entry they declared.
      *
      * A tenant is created before the components of its composition are, which is why nothing here
      * reaches for one.
@@ -23,19 +24,32 @@ export class Factory {
         if (mine(locator))
             return new Dispatcher(this.metronome(), (target) => this.local(target), this.host.atom(locator.id));
         const tenant = new Connector();
-        const pulses = declaration;
+        const declared = declaration;
         // `cadence: ~` is a component that only delays calls
-        if (pulses === null)
+        if (declared === null)
+            return tenant;
+        /*
+         * An entry that names a region is made by the deployment of that rank and by no other —
+         * and by one that was told to make the work of a region that is gone. One that names none
+         * is every region's own.
+         */
+        const ranks = regions();
+        const entries = Object.entries(declared).flatMap(([endpoint, list]) => list
+            .filter((entry) => entry.region === undefined || ranks.includes(entry.region))
+            .map((entry) => ({ endpoint, entry })));
+        if (entries.length === 0)
             return tenant;
         const local = this.local(locator);
-        const entries = Object.entries(pulses);
         // a pulse every replica makes asks nobody whether it may, so a component whose pulses are
         // all of that kind decides nothing with its replicas and needs no atom at all
-        const atom = entries.some(([, pulse]) => pulse.scope === 'group')
+        const atom = entries.some(({ entry }) => 'cycle' in entry && entry.scope === 'group')
             ? this.host.atom(locator.id)
             : undefined;
-        for (const [endpoint, { cycle, intervals, scope }] of entries)
-            tenant.depends(new Pulse({ locator, endpoint, cycle, intervals }, local, scope === 'group' ? atom : undefined));
+        for (const { endpoint, entry } of entries)
+            if ('schedule' in entry)
+                tenant.depends(new Schedule({ locator, endpoint, ...entry }, this.metronome()));
+            else
+                tenant.depends(new Pulse({ locator, endpoint, cycle: entry.cycle, intervals: entry.intervals }, local, entry.scope === 'group' ? atom : undefined));
         return tenant;
     }
     /** `context.delay` — for every component but the one that keeps the calls. */

package/transpiled/Factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"Factory.js","sourceRoot":"","sources":["../source/Factory.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Factory.js","sourceRoot":"","sources":["../source/Factory.ts"],"names":[],"mappings":"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"}

package/transpiled/Local.js

@@ -16,7 +16,12 @@ export class Local extends Connector {
         this.locator = locator;
     }
     async invoke(endpoint, request) {
-        this.remote ??= this.locate();
+        // one that could not be found is looked for again by the next call, rather than kept as
+        // the answer: what hands a schedule over calls as it boots, and goes on calling
+        this.remote ??= this.locate().catch((error) => {
+            this.remote = undefined;
+            throw error;
+        });
         return await (await this.remote).invoke(endpoint, request);
     }
     async locate() {

package/transpiled/Local.js.map

@@ -1 +1 @@
-{"version":3,"file":"Local.js","sourceRoot":"","sources":["../source/Local.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAKxC;;;;;;GAMG;AACH,MAAM,OAAO,KAAM,SAAQ,SAAS;IACjB,IAAI,CAAM;IACV,OAAO,CAAS;IACzB,MAAM,CAAkB;IAEhC,YAAmB,IAAU,EAAE,OAAgB;QAC7C,KAAK,EAAE,CAAA;QAEP,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACxB,CAAC;IAEM,KAAK,CAAC,MAAM,CAAC,QAAgB,EAAE,OAAgB;QACpD,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,EAAE,CAAA;QAE7B,OAAO,MAAM,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IAC5D,CAAC;IAEO,KAAK,CAAC,MAAM;QAClB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;QAE3D,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;QAEpB,MAAM,MAAM,CAAC,OAAO,EAAE,CAAA;QAEtB,OAAO,MAAM,CAAA;IACf,CAAC;CACF;AAED,mFAAmF;AACnF,MAAM,MAAM,GAAW,EAAE,OAAO,EAAE,SAAS,EAAE,CAAA"}
+{"version":3,"file":"Local.js","sourceRoot":"","sources":["../source/Local.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAKxC;;;;;;GAMG;AACH,MAAM,OAAO,KAAM,SAAQ,SAAS;IACjB,IAAI,CAAM;IACV,OAAO,CAAS;IACzB,MAAM,CAAkB;IAEhC,YAAmB,IAAU,EAAE,OAAgB;QAC7C,KAAK,EAAE,CAAA;QAEP,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACxB,CAAC;IAEM,KAAK,CAAC,MAAM,CAAC,QAAgB,EAAE,OAAgB;QACpD,wFAAwF;QACxF,gFAAgF;QAChF,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YACrD,IAAI,CAAC,MAAM,GAAG,SAAS,CAAA;YAEvB,MAAM,KAAK,CAAA;QACb,CAAC,CAAC,CAAA;QAEF,OAAO,MAAM,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IAC5D,CAAC;IAEO,KAAK,CAAC,MAAM;QAClB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;QAE3D,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;QAEpB,MAAM,MAAM,CAAC,OAAO,EAAE,CAAA;QAEtB,OAAO,MAAM,CAAA;IACf,CAAC;CACF;AAED,mFAAmF;AACnF,MAAM,MAAM,GAAW,EAAE,OAAO,EAAE,SAAS,EAAE,CAAA"}

package/transpiled/Schedule.d.ts

@@ -0,0 +1,73 @@
+import { Connector } from '@toa.io/core';
+import type { Local } from './Local.ts';
+import type { Locator } from '@toa.io/core';
+/**
+ * A call to an operation of its own component at the moments its manifest states, as a cron
+ * expression.
+ *
+ * It makes no call. Each occurrence is a delayed call, and what runs here keeps the next one
+ * stored: at boot, and each time the one stored comes due. What makes it is what makes every
+ * delayed call, so it is made where nothing is running at its moment — which a pulse, storing
+ * nothing, cannot offer.
+ *
+ * Every replica stores every occurrence, and one row is kept: the id is derived from what the
+ * occurrence is, so nothing here asks which replica's it is. And nothing here is a chain. An
+ * occurrence is a function of the expression and the clock, so one that was not made, or not
+ * stored, has no bearing on the one after it.
+ */
+export declare class Schedule extends Connector {
+    private readonly endpoint;
+    private readonly label;
+    private readonly next;
+    /** milliseconds a call may be late, or absent where it is owed until the next one is due */
+    private readonly overdue?;
+    /** whose occurrence this is: the region the entry names, or the one this deployment is */
+    private readonly region;
+    private readonly metronome;
+    /** the occurrence being waited for, which is the one last handed over */
+    private at?;
+    private timer?;
+    private retry?;
+    private closing;
+    /** Whether the process has been told to go quiet, see `stop`. */
+    private quiesced;
+    constructor(definition: Definition, metronome: Local);
+    protected open(): Promise<void>;
+    protected close(): Promise<void>;
+    /**
+     * Stops storing. What is stored stays stored, and is made when the deployment is working
+     * again as any delayed call is; an occurrence that came due unstored while the process was
+     * quiet is not made up.
+     */
+    protected pause(): Promise<void>;
+    protected unpause(): void;
+    private disarm;
+    /**
+     * Hands over the next occurrence once the one waited for has come due, and waits again.
+     * Always the next one from now and never one already past: whether that one was made is not
+     * something this can know.
+     */
+    private tick;
+    /**
+     * The row a delayed call is, found or made under an id that is the occurrence's own — so every
+     * replica of the component, and every boot of one, stores the same row.
+     *
+     * It begins a chain of its own, as what is called from the clock does: no trail is stored.
+     */
+    private store;
+    /**
+     * How late the call may be. Owed until the next occurrence is due where nothing states a
+     * bound, so at most one is ever waiting and an outage does not come back as every call it
+     * covered; with no bound only where nothing ever comes after it.
+     */
+    private late;
+}
+export interface Definition {
+    locator: Locator;
+    endpoint: string;
+    schedule: string;
+    zone: string;
+    /** seconds */
+    overdue?: number;
+    region?: number;
+}

package/transpiled/Schedule.js

@@ -0,0 +1,149 @@
+import { console } from 'openspan';
+import { Connector, entities } from '@toa.io/core';
+import { occurrences, rank } from '@toa.io/definitions/extensions.cadence';
+import { row } from './row.js';
+/**
+ * A call to an operation of its own component at the moments its manifest states, as a cron
+ * expression.
+ *
+ * It makes no call. Each occurrence is a delayed call, and what runs here keeps the next one
+ * stored: at boot, and each time the one stored comes due. What makes it is what makes every
+ * delayed call, so it is made where nothing is running at its moment — which a pulse, storing
+ * nothing, cannot offer.
+ *
+ * Every replica stores every occurrence, and one row is kept: the id is derived from what the
+ * occurrence is, so nothing here asks which replica's it is. And nothing here is a chain. An
+ * occurrence is a function of the expression and the clock, so one that was not made, or not
+ * stored, has no bearing on the one after it.
+ */
+export class Schedule extends Connector {
+    endpoint;
+    label;
+    next;
+    /** milliseconds a call may be late, or absent where it is owed until the next one is due */
+    overdue;
+    /** whose occurrence this is: the region the entry names, or the one this deployment is */
+    region;
+    metronome;
+    /** the occurrence being waited for, which is the one last handed over */
+    at;
+    timer;
+    retry;
+    closing = false;
+    /** Whether the process has been told to go quiet, see `stop`. */
+    quiesced = false;
+    constructor(definition, metronome) {
+        super();
+        const { locator, endpoint, schedule, zone, overdue, region } = definition;
+        this.endpoint = `${locator.id}.${endpoint}`;
+        this.label = `${this.endpoint} schedule`;
+        this.next = occurrences(schedule, zone);
+        this.region = region ?? rank();
+        this.metronome = metronome;
+        if (overdue !== undefined)
+            this.overdue = overdue * 1000;
+        this.depends(metronome);
+    }
+    async open() {
+        this.tick();
+    }
+    async close() {
+        this.closing = true;
+        this.disarm();
+    }
+    /**
+     * Stops storing. What is stored stays stored, and is made when the deployment is working
+     * again as any delayed call is; an occurrence that came due unstored while the process was
+     * quiet is not made up.
+     */
+    async pause() {
+        this.quiesced = true;
+        this.disarm();
+    }
+    unpause() {
+        this.quiesced = false;
+        this.at = undefined;
+        this.tick();
+    }
+    disarm() {
+        clearTimeout(this.timer);
+        clearTimeout(this.retry);
+    }
+    /**
+     * Hands over the next occurrence once the one waited for has come due, and waits again.
+     * Always the next one from now and never one already past: whether that one was made is not
+     * something this can know.
+     */
+    tick() {
+        if (this.closing || this.quiesced)
+            return;
+        const now = Date.now();
+        // a timer may wake a millisecond before the moment it was set for, and a moment further
+        // out than one timer reaches is woken for several times on the way
+        let at = this.at;
+        if (at === undefined || now >= at) {
+            const next = this.next(now);
+            // an expression whose last moment has passed
+            if (next === null)
+                return;
+            at = this.at = next;
+            void this.store(at);
+        }
+        // a delay past this fires at once rather than late, so a long wait is taken in instalments
+        this.timer = setTimeout(() => this.tick(), Math.min(at - now, MAX_DELAY));
+        this.timer.unref();
+    }
+    /**
+     * The row a delayed call is, found or made under an id that is the occurrence's own — so every
+     * replica of the component, and every boot of one, stores the same row.
+     *
+     * It begins a chain of its own, as what is called from the clock does: no trail is stored.
+     */
+    async store(at) {
+        const id = entities.derive('cadence', this.region, this.endpoint, at);
+        const entity = {
+            id,
+            ...row({
+                endpoint: this.endpoint,
+                due: at,
+                overdue: this.late(at),
+                request: { input: { at } }
+            })
+        };
+        try {
+            await this.metronome.invoke('ensure', { query: { id }, entity });
+        }
+        catch (error) {
+            console.warn('Schedule could not store its next call, and will try again', {
+                schedule: this.label,
+                at,
+                error
+            });
+            /*
+             * Tried again for as long as it is the occurrence being waited for. Past that the next
+             * one is handed over instead, and this one is what the readme says may be lost.
+             */
+            this.retry = setTimeout(() => {
+                if (!this.closing && !this.quiesced && this.at === at)
+                    void this.store(at);
+            }, RETRY);
+            this.retry.unref();
+        }
+    }
+    /**
+     * How late the call may be. Owed until the next occurrence is due where nothing states a
+     * bound, so at most one is ever waiting and an outage does not come back as every call it
+     * covered; with no bound only where nothing ever comes after it.
+     */
+    late(at) {
+        if (this.overdue !== undefined)
+            return this.overdue;
+        const next = this.next(at);
+        return next === null ? null : next - at;
+    }
+}
+/** `setTimeout` fires immediately past this, so a longer wait is taken in instalments */
+const MAX_DELAY = 2 ** 31 - 1;
+/** milliseconds between attempts to store an occurrence the metronome was not there to take */
+const RETRY = 5_000;
+//# sourceMappingURL=Schedule.js.map

package/transpiled/Schedule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Schedule.js","sourceRoot":"","sources":["../source/Schedule.ts"],"names":[],"mappings":"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"}

package/transpiled/index.d.ts

@@ -1,4 +1,5 @@
 export { Factory } from './Factory.ts';
 export { components } from './Composition.ts';
 export { LANES } from '@toa.io/definitions/extensions.cadence';
-export type { Declaration, Delay, Pulse } from '@toa.io/definitions/extensions.cadence';
+export { row } from './row.ts';
+export type { Declaration, Delay, Entry, Pulse, Schedule } from '@toa.io/definitions/extensions.cadence';

package/transpiled/index.js

@@ -2,4 +2,5 @@ export { Factory } from './Factory.js';
 export { components } from './Composition.js';
 // what the metronome component is written against
 export { LANES } from '@toa.io/definitions/extensions.cadence';
+export { row } from './row.js';
 //# sourceMappingURL=index.js.map

package/transpiled/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../source/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,kDAAkD;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,wCAAwC,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../source/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,kDAAkD;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,wCAAwC,CAAA;AAC9D,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA"}

package/transpiled/row.d.ts

@@ -0,0 +1,29 @@
+/**
+ * What is stored of a call to make later, as whoever hands one over states it: `context.delay`,
+ * and a schedule storing its next occurrence. Written once, so that the two store one kind of
+ * row and the dispatcher reads one.
+ *
+ * The lane is random, not one this replica owns. An outbox row is written into an owned lane so
+ * that in steady state a replica settles its own rows before it ever reads them — but a delayed
+ * row has no immediate path to settle, so nothing is gained, and an even spread is what the
+ * dispatchers want.
+ */
+export declare function row(call: Call): Stored;
+export interface Call {
+    /** what to call, as `namespace.component.operation` */
+    endpoint: string;
+    /** when, in milliseconds since the epoch */
+    due: number;
+    /** milliseconds the call may be late and still be made, or `null` for no bound */
+    overdue: number | null;
+    request?: object;
+    trail?: string[];
+}
+export interface Stored {
+    lane: number;
+    due: number;
+    expires: number;
+    endpoint: string;
+    request?: object;
+    trail?: string[];
+}

package/transpiled/row.js

@@ -0,0 +1,32 @@
+import { LANES } from '@toa.io/definitions/extensions.cadence';
+/**
+ * What is stored of a call to make later, as whoever hands one over states it: `context.delay`,
+ * and a schedule storing its next occurrence. Written once, so that the two store one kind of
+ * row and the dispatcher reads one.
+ *
+ * The lane is random, not one this replica owns. An outbox row is written into an owned lane so
+ * that in steady state a replica settles its own rows before it ever reads them — but a delayed
+ * row has no immediate path to settle, so nothing is gained, and an even spread is what the
+ * dispatchers want.
+ */
+export function row(call) {
+    const { endpoint, due, overdue, request, trail } = call;
+    const stored = {
+        lane: Math.floor(Math.random() * LANES),
+        due,
+        endpoint,
+        // absolute, because the bound is the caller's and a scan reads rows of many callers at once.
+        // No bound is the end of representable time rather than an absent field, so that one
+        // comparison answers for every row
+        expires: overdue === null ? Number.MAX_SAFE_INTEGER : due + overdue
+    };
+    // a call that takes no request has none: the entity's `request` is an object where it is
+    // there at all, and a null would not fit it
+    if (request !== undefined)
+        stored.request = request;
+    // the chain that asked for the call, absent where the call begins one of its own
+    if (trail !== undefined)
+        stored.trail = trail;
+    return stored;
+}
+//# sourceMappingURL=row.js.map

package/transpiled/row.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"row.js","sourceRoot":"","sources":["../source/row.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,wCAAwC,CAAA;AAE9D;;;;;;;;;GASG;AACH,MAAM,UAAU,GAAG,CAAC,IAAU;IAC5B,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,IAAI,CAAA;IAEvD,MAAM,MAAM,GAAW;QACrB,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC;QACvC,GAAG;QACH,QAAQ;QAER,6FAA6F;QAC7F,qFAAqF;QACrF,mCAAmC;QACnC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,GAAG,GAAG,OAAO;KACpE,CAAA;IAED,yFAAyF;IACzF,4CAA4C;IAC5C,IAAI,OAAO,KAAK,SAAS;QAAE,MAAM,CAAC,OAAO,GAAG,OAAO,CAAA;IAEnD,iFAAiF;IACjF,IAAI,KAAK,KAAK,SAAS;QAAE,MAAM,CAAC,KAAK,GAAG,KAAK,CAAA;IAE7C,OAAO,MAAM,CAAA;AACf,CAAC"}