@toa.io/extensions.cadence 1.0.0-alpha.320 → 1.0.0-alpha.322

package/components/cadence.metronome/manifest.toa.yaml

@@ -27,7 +27,7 @@ entity:
       description: >
         The chain of hops that asked for the call, which the call is then made by. A delay is a
         hop like any other, so a circle routed through one is still a circle. Absent where the
-        caller detached the call, and on a row written before this existed.
+        caller unchained the call, and on a row written before this existed.
       type: array
       items:
         type: string

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

@@ -24,7 +24,7 @@ export function transition(input, entry) {
   // 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 detached it
+  // the chain that asked for the call, absent where the caller unchained it
   if (input.trail !== undefined) entry.trail = input.trail
 
   return entry.id

package/components/cadence.metronome/types/toa.d.ts

@@ -15,7 +15,7 @@ export interface Entity {
   endpoint: string
   /** The request to make, as it was handed over */
   request?: Record<string, unknown>
-  /** The chain of hops that asked for the call, which the call is then made by. A delay is a hop like any other, so a circle routed through one is still a circle. Absent where the caller detached the call, and on a row written before this existed. */
+  /** The chain of hops that asked for the call, which the call is then made by. A delay is a hop like any other, so a circle routed through one is still a circle. Absent where the caller unchained the call, and on a row written before this existed. */
   trail?: string[]
   id: string
   VERSION: number
@@ -25,6 +25,8 @@ export interface Entity {
   REGION: number
 }
 
+export type State = Entity & { DISCARD: boolean, TRAILERS: Record<string, unknown> }
+
 export type DelayInput = {
   endpoint: string
   request?: Record<string, unknown>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toa.io/extensions.cadence",
-  "version": "1.0.0-alpha.320",
+  "version": "1.0.0-alpha.322",
   "type": "module",
   "description": "Toa Schedule",
   "author": "temich <tema.gurtovoy@gmail.com>",
@@ -26,8 +26,8 @@
     "!**/.env*"
   ],
   "dependencies": {
-    "@toa.io/core": "1.0.0-alpha.320",
-    "@toa.io/definitions": "1.0.0-alpha.320",
+    "@toa.io/core": "1.0.0-alpha.322",
+    "@toa.io/definitions": "1.0.0-alpha.322",
     "@toa.io/generic": "1.0.0-alpha.311",
     "@toa.io/schemas": "1.0.0-alpha.311",
     "openspan": "1.0.0-alpha.305"
@@ -35,5 +35,5 @@
   "scripts": {
     "transpile": "tsc"
   },
-  "gitHead": "5ef92ab939a596e4ac820965c59c015820eba7b2"
+  "gitHead": "ef65352a8bd7bc0ef400fcc8cde0e19a3bb92199"
 }

package/readme.md

@@ -127,11 +127,11 @@ const id = await context.delay(
 await context.delay.cancel(id)
 ```
 
-|            |                                                                             |
-| ---------- | --------------------------------------------------------------------------- |
-| `interval` | milliseconds from now                                                       |
-| `overdue`  | milliseconds the call may be late and still be made, or `null` for no bound |
-| `detached` | whether the call begins a chain of its own; see below                       |
+|             |                                                                             |
+| ----------- | --------------------------------------------------------------------------- |
+| `interval`  | milliseconds from now                                                       |
+| `overdue`   | milliseconds the call may be late and still be made, or `null` for no bound |
+| `unchained` | whether the call begins a chain of its own; see below                       |
 
 The call is made once the delay has passed, and waits for the target where it is not there to
 take it. The id it answers cancels it, and `cancel` raises where the id was never issued.
@@ -149,8 +149,8 @@ The call is made by the chain that asked for it, so an operation that delays a c
 going round in a circle and is refused on its third round — see
 [call cycles](/documentation/cycles.md). A delay makes it a slow circle rather than not one.
 
-Nothing here repeats a call: a delayed call is made **once**, and `detached` does not change
-that. What repeats is an operation that re-arms itself, and `detached: true` is how that
+Nothing here repeats a call: a delayed call is made **once**, and `unchained` does not change
+that. What repeats is an operation that re-arms itself, and `unchained: true` is how that
 operation says the call it is arming begins a chain of its own rather than continuing the one it
 is running in:
 
@@ -162,7 +162,7 @@ export async function effect (input, context) {
   await context.delay(
     'billing.dunning.chase',
     { input },
-    { interval: DAY, overdue: null, detached: true }
+    { interval: DAY, overdue: null, unchained: true }
   )
 }
 ```
@@ -170,8 +170,11 @@ export async function effect (input, context) {
 Without it the second chase is hop two of one chain and the third is refused. With it each chase
 is its own chain, and they go on for as long as the operation keeps arming them.
 
+An operation declared [`unchained`](/documentation/cycles.md#an-operation-meant-to-be-re-entered)
+begins a chain of its own on every call, delayed or not, and needs no option here.
+
 A [pulse](#pulse) is the other way to write recurring work, and where it fits it is the simpler
-one: one timer for the component rather than a row per item, and no chain to detach, because it
+one: one timer for the component rather than a row per item, and no chain to break, because it
 is called from the clock. Reach for a delay instead when each item has its own schedule — this
 invoice a day from now, that one in a week.
 

package/transpiled/Aspect.js

@@ -52,7 +52,7 @@ export class Aspect extends Connector {
          * It rides the row rather than the request, because the request is the caller's and a call
          * that carries none must go on carrying none.
          */
-        const hops = options.detached === true ? undefined : trail.current()?.hops;
+        const hops = options.unchained === true ? undefined : trail.current()?.hops;
         if (hops !== undefined)
             input.trail = hops;
         /*

package/transpiled/Aspect.js.map

@@ -1 +1 @@
-{"version":3,"file":"Aspect.js","sourceRoot":"","sources":["../source/Aspect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AAG3D,OAAO,KAAK,OAAO,MAAM,mBAAmB,CAAA;AAU5C;;;;;;;;GAQG;AACH,MAAM,OAAO,MAAO,SAAQ,SAAS;IACnB,IAAI,GAAG,OAAO,CAAA;IAEb,SAAS,CAAO;IAEjC,YAAmB,SAAgB;QACjC,KAAK,EAAE,CAAA;QAEP,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAE1B,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IACzB,CAAC;IAED,0FAA0F;IAC1F,4DAA4D;IACrD,KAAK,CAAC,MAAM,CAAC,MAAc,EAAE,GAAG,IAAW;QAChD,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,OAAO;gBACV,OAAO,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;YACpD,KAAK,QAAQ;gBACX,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;YACnC;gBACE,MAAM,IAAI,KAAK,CAAC,wBAAwB,MAAM,UAAU,CAAC,CAAA;QAC7D,CAAC;IACH,CAAC;IAED,mEAAmE;IAC3D,KAAK,CAAC,KAAK,CACjB,QAAgB,EAChB,OAAsB,EACtB,OAAgB;QAEhB;;;WAGG;QACH,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS,IAAI,UAAU,IAAI,OAAO;YACpE,MAAM,IAAI,UAAU,CAAC,wBAAwB,CAAC,oCAAoC,CAAC,CAAA;QAErF,MAAM,KAAK,GAAU;YACnB,QAAQ;YACR,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAA;QAED,oEAAoE;QACpE,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS;YAAE,KAAK,CAAC,OAAO,GAAG,OAAO,CAAA;QAEtE,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;QAEtD;;;;;WAKG;QACH,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,CAAA;QAE1E,IAAI,IAAI,KAAK,SAAS;YAAE,KAAK,CAAC,KAAK,GAAG,IAAI,CAAA;QAE1C;;;;WAIG;QACH,OAAO,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAA;IACxD,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,MAAM,CAAC,EAAU;QAC7B,OAAO,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IACjF,CAAC;CACF"}
+{"version":3,"file":"Aspect.js","sourceRoot":"","sources":["../source/Aspect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AAG3D,OAAO,KAAK,OAAO,MAAM,mBAAmB,CAAA;AAU5C;;;;;;;;GAQG;AACH,MAAM,OAAO,MAAO,SAAQ,SAAS;IACnB,IAAI,GAAG,OAAO,CAAA;IAEb,SAAS,CAAO;IAEjC,YAAmB,SAAgB;QACjC,KAAK,EAAE,CAAA;QAEP,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAE1B,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IACzB,CAAC;IAED,0FAA0F;IAC1F,4DAA4D;IACrD,KAAK,CAAC,MAAM,CAAC,MAAc,EAAE,GAAG,IAAW;QAChD,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,OAAO;gBACV,OAAO,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;YACpD,KAAK,QAAQ;gBACX,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;YACnC;gBACE,MAAM,IAAI,KAAK,CAAC,wBAAwB,MAAM,UAAU,CAAC,CAAA;QAC7D,CAAC;IACH,CAAC;IAED,mEAAmE;IAC3D,KAAK,CAAC,KAAK,CACjB,QAAgB,EAChB,OAAsB,EACtB,OAAgB;QAEhB;;;WAGG;QACH,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS,IAAI,UAAU,IAAI,OAAO;YACpE,MAAM,IAAI,UAAU,CAAC,wBAAwB,CAAC,oCAAoC,CAAC,CAAA;QAErF,MAAM,KAAK,GAAU;YACnB,QAAQ;YACR,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAA;QAED,oEAAoE;QACpE,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS;YAAE,KAAK,CAAC,OAAO,GAAG,OAAO,CAAA;QAEtE,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;QAEtD;;;;;WAKG;QACH,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,CAAA;QAE3E,IAAI,IAAI,KAAK,SAAS;YAAE,KAAK,CAAC,KAAK,GAAG,IAAI,CAAA;QAE1C;;;;WAIG;QACH,OAAO,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAA;IACxD,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,MAAM,CAAC,EAAU;QAC7B,OAAO,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IACjF,CAAC;CACF"}

package/transpiled/Dispatcher.js

@@ -266,7 +266,7 @@ export class Dispatcher extends Connector {
         /*
          * Set after the stored request is spread, so a stored field of that name cannot stand in
          * for it: the row's chain is the one that was in scope when the call was asked for. Absent
-         * — the caller detached the call — `Call` starts one under cadence's own name.
+         * — the caller unchained the call — `Call` starts one under cadence's own name.
          */
         if (row.trail !== undefined)
             request.trail = row.trail;