@toa.io/definitions 1.0.0-alpha.324 → 1.0.0-alpha.326

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toa.io/definitions",
-  "version": "1.0.0-alpha.324",
+  "version": "1.0.0-alpha.326",
   "type": "module",
   "description": "What Toa packages declare, read without running them",
   "author": "temich <tema.gurtovoy@gmail.com>",
@@ -31,8 +31,9 @@
   ],
   "dependencies": {
     "@toa.io/generic": "1.0.0-alpha.311",
-    "@toa.io/pointer": "1.0.0-alpha.311",
-    "@toa.io/schemas": "1.0.0-alpha.311"
+    "@toa.io/pointer": "1.0.0-alpha.326",
+    "@toa.io/schemas": "1.0.0-alpha.326",
+    "croner": "10.0.1"
   },
   "scripts": {
     "transpile": "tsc",
@@ -44,18 +45,18 @@
     "./*": "./transpiled/*/index.js"
   },
   "devDependencies": {
-    "@aws-sdk/client-s3": "3.1140.0",
-    "@aws-sdk/lib-storage": "3.1140.0",
-    "@toa.io/core": "1.0.0-alpha.323",
+    "@aws-sdk/client-s3": "3.1145.0",
+    "@aws-sdk/lib-storage": "3.1145.0",
+    "@toa.io/core": "1.0.0-alpha.326",
     "cloudinary": "2.11.0",
     "openspan": "1.0.0-alpha.323",
-    "oxc-parser": "0.151.0"
+    "oxc-parser": "0.152.0"
   },
   "peerDependencies": {
-    "@aws-sdk/client-s3": "3.1140.0",
-    "@aws-sdk/lib-storage": "3.1140.0",
+    "@aws-sdk/client-s3": "3.1145.0",
+    "@aws-sdk/lib-storage": "3.1145.0",
     "cloudinary": "2.11.0",
-    "oxc-parser": "0.151.0"
+    "oxc-parser": "0.152.0"
   },
   "peerDependenciesMeta": {
     "@aws-sdk/client-s3": {
@@ -71,5 +72,5 @@
       "optional": true
     }
   },
-  "gitHead": "eedcbb7b90b3ea759f200b0d03c7ae13a8487b9d"
+  "gitHead": "60f11bdc805d0c39bcb06064b2218b11114a35ad"
 }

package/schemas/extensions.cadence/declaration.cos.yaml

@@ -1,25 +1,12 @@
-# manifest.toa.yaml cadence declaration: the operations called on a cadence
+# manifest.toa.yaml cadence declaration: the operations called on a cadence or at the moments
+# of a calendar, each by the entries it was given. What an entry may state is its kind's own
+# schema, `pulse` or `schedule`.
 type: object
 propertyNames:
   pattern: ^[a-zA-Z]+([_a-zA-Z0-9]*[a-zA-Z0-9]+)?$
 patternProperties:
   ".*":
-    type: object
-    properties:
-      cycle:
-        description: Seconds one whole cycle takes
-        type: integer
-        minimum: 1
-      intervals:
-        description: >
-          Intervals the cycle is split into. The gap between calls is `cycle / intervals`,
-          and the operation is told which interval it is running for.
-        type: integer
-        minimum: 1
-      scope:
-        description: >
-          Whose work this is: the component's, which one replica makes each call of, or every
-          replica's, for what lives inside a process.
-        enum: [group, replica]
-    required: [cycle]
-    additionalProperties: false
+    type: array
+    minItems: 1
+    items:
+      type: object

package/schemas/extensions.cadence/pulse.cos.yaml

@@ -0,0 +1,26 @@
+# an entry of a cadence declaration that states a cycle
+type: object
+properties:
+  cycle:
+    description: Seconds one whole cycle takes
+    type: integer
+    minimum: 1
+  intervals:
+    description: >
+      Intervals the cycle is split into. The gap between calls is `cycle / intervals`,
+      and the operation is told which interval it is running for.
+    type: integer
+    minimum: 1
+  scope:
+    description: >
+      Whose work this is: the component's, which one replica makes each call of, or every
+      replica's, for what lives inside a process.
+    enum: [group, replica]
+  region:
+    description: >
+      The rank of the region that makes the calls, where the work is one for an application
+      deployed as several. Every region makes them where none is stated.
+    type: integer
+    minimum: 0
+required: [cycle, intervals, scope]
+additionalProperties: false

package/schemas/extensions.cadence/schedule.cos.yaml

@@ -0,0 +1,25 @@
+# an entry of a cadence declaration that states a schedule
+type: object
+properties:
+  schedule:
+    description: >
+      A cron expression of five fields, or of six where the first is seconds. The operation is
+      told the moment each call was scheduled for.
+    type: string
+  zone:
+    description: The time zone the expression is read in, as the IANA database names it
+    type: string
+  overdue:
+    description: >
+      Seconds a call may be late and still be made. Where none is stated it is made until the
+      next one comes due.
+    type: integer
+    minimum: 0
+  region:
+    description: >
+      The rank of the region that makes the calls, where the work is one for an application
+      deployed as several. Every region makes them where none is stated.
+    type: integer
+    minimum: 0
+required: [schedule, zone]
+additionalProperties: false

package/schemas/extensions.exposition/routes.cos.yaml

@@ -5,14 +5,17 @@ additionalProperties:
   type: object
   properties:
     key:
-      description: The properties of the event that are the keys of the streams it goes to
+      description: >-
+        The properties of the event that are the keys of the streams it goes to, or literal keys:
+        `~` and the key
+      # a property, or `~` and at least one character of a literal
       oneOf:
         - type: string
-          minLength: 1
+          pattern: ^(?:[^~]|~.)
         - type: array
           items:
             type: string
-            minLength: 1
+            pattern: ^(?:[^~]|~.)
           minItems: 1
     expose:
       description: What of the event its streams are given; nothing is given that is not named

package/transpiled/extensions.cadence/const.d.ts

@@ -33,3 +33,5 @@ export declare const REGIONS = "TOA_CADENCE_REGIONS";
  * carry.
  */
 export declare function regions(): number[];
+/** The rank of the region this deployment is, which is zero where it is no region at all. */
+export declare function rank(): number;

package/transpiled/extensions.cadence/const.js

@@ -40,7 +40,11 @@ export const REGIONS = 'TOA_CADENCE_REGIONS';
 export function regions() {
     const declared = environment.get(REGIONS);
     if (declared === undefined)
-        return [Number(environment.get(REGION) ?? 0)];
+        return [rank()];
     return declared.split(' ').map(Number);
 }
+/** The rank of the region this deployment is, which is zero where it is no region at all. */
+export function rank() {
+    return Number(environment.get(REGION) ?? 0);
+}
 //# sourceMappingURL=const.js.map

package/transpiled/extensions.cadence/const.js.map

@@ -1 +1 @@
-{"version":3,"file":"const.js","sourceRoot":"","sources":["../../source/extensions.cadence/const.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAA;AAE3D,+DAA+D;AAC/D,MAAM,CAAC,MAAM,SAAS,GAAG,SAAS,CAAA;AAClC,MAAM,CAAC,MAAM,SAAS,GAAG,WAAW,CAAA;AAEpC;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,GAAG,CAAA;AAExB,+FAA+F;AAC/F,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,CAAA;AAE9B,gCAAgC;AAChC,MAAM,CAAC,MAAM,KAAK,GAAG,GAAG,CAAA;AAExB,oFAAoF;AACpF,MAAM,UAAU,MAAM,CAAC,QAAgB,EAAE,QAAgB;IACvD,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;IAE/C,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAA;AAC7D,CAAC;AAED,sEAAsE;AACtE,MAAM,CAAC,MAAM,OAAO,GAAG,qBAAqB,CAAA;AAE5C;;;;;;;;;;GAUG;AACH,MAAM,UAAU,OAAO;IACrB,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;IAEzC,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAEzE,OAAO,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;AACxC,CAAC"}
+{"version":3,"file":"const.js","sourceRoot":"","sources":["../../source/extensions.cadence/const.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAA;AAE3D,+DAA+D;AAC/D,MAAM,CAAC,MAAM,SAAS,GAAG,SAAS,CAAA;AAClC,MAAM,CAAC,MAAM,SAAS,GAAG,WAAW,CAAA;AAEpC;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,GAAG,CAAA;AAExB,+FAA+F;AAC/F,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,CAAA;AAE9B,gCAAgC;AAChC,MAAM,CAAC,MAAM,KAAK,GAAG,GAAG,CAAA;AAExB,oFAAoF;AACpF,MAAM,UAAU,MAAM,CAAC,QAAgB,EAAE,QAAgB;IACvD,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;IAE/C,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAA;AAC7D,CAAC;AAED,sEAAsE;AACtE,MAAM,CAAC,MAAM,OAAO,GAAG,qBAAqB,CAAA;AAE5C;;;;;;;;;;GAUG;AACH,MAAM,UAAU,OAAO;IACrB,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;IAEzC,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;IAE3C,OAAO,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;AACxC,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,IAAI;IAClB,OAAO,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAA;AAC7C,CAAC"}

package/transpiled/extensions.cadence/deployment.js

@@ -14,10 +14,6 @@ export function deployment(_, annotation) {
     const variables = [
         { name: 'TOA_CADENCE_DISCRETENESS', value: String(discreteness) }
     ];
-    // absent, the metronome makes the calls of the region it is deployed as, which is what a
-    // deployment that has never heard of regions does anyway
-    if (annotation?.regions !== undefined)
-        variables.push({ name: REGIONS, value: annotation.regions.join(' ') });
     const service = {
         group: NAMESPACE,
         name: 'metronome',
@@ -25,7 +21,18 @@ export function deployment(_, annotation) {
         components: components().labels,
         variables
     };
-    return { services: [service] };
+    // absent, a deployment makes the calls of the region it is deployed as, which is what one
+    // that has never heard of regions does anyway
+    if (annotation?.regions === undefined)
+        return { services: [service] };
+    const regions = { name: REGIONS, value: annotation.regions.join(' ') };
+    variables.push(regions);
+    /*
+     * Every composition is given it as well as the metronome: a pulse and a schedule that name a
+     * region are made by the components that declare them, and the region that takes over the
+     * delayed calls of one that is gone has to take those over with them.
+     */
+    return { services: [service], variables: { global: [regions] } };
 }
 /** The extension is deployed for the sake of `delay`, which nothing has to declare to use. */
 export const standalone = true;

package/transpiled/extensions.cadence/deployment.js.map

@@ -1 +1 @@
-{"version":3,"file":"deployment.js","sourceRoot":"","sources":["../../source/extensions.cadence/deployment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAC7D,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAIvC;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,CAAU,EAAE,UAA8B;IACnE,OAAO,CAAC,UAAU,CAAC,QAAQ,CACzB,UAAU,IAAI,IAAI,EAClB,4BAA4B,CAC7B,CAAA;IAED,4FAA4F;IAC5F,uCAAuC;IACvC,MAAM,YAAY,GAAG,CAAC,UAAU,EAAE,YAAY,IAAI,YAAY,CAAC,GAAG,IAAI,CAAA;IACtE,MAAM,SAAS,GAAe;QAC5B,EAAE,IAAI,EAAE,0BAA0B,EAAE,KAAK,EAAE,MAAM,CAAC,YAAY,CAAC,EAAE;KAClE,CAAA;IAED,yFAAyF;IACzF,yDAAyD;IACzD,IAAI,UAAU,EAAE,OAAO,KAAK,SAAS;QACnC,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IAExE,MAAM,OAAO,GAAY;QACvB,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,WAAW;QACjB,OAAO;QACP,UAAU,EAAE,UAAU,EAAE,CAAC,MAAM;QAC/B,SAAS;KACV,CAAA;IAED,OAAO,EAAE,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAA;AAChC,CAAC;AAED,8FAA8F;AAC9F,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,CAAA"}
+{"version":3,"file":"deployment.js","sourceRoot":"","sources":["../../source/extensions.cadence/deployment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAC7D,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAIvC;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,CAAU,EAAE,UAA8B;IACnE,OAAO,CAAC,UAAU,CAAC,QAAQ,CACzB,UAAU,IAAI,IAAI,EAClB,4BAA4B,CAC7B,CAAA;IAED,4FAA4F;IAC5F,uCAAuC;IACvC,MAAM,YAAY,GAAG,CAAC,UAAU,EAAE,YAAY,IAAI,YAAY,CAAC,GAAG,IAAI,CAAA;IACtE,MAAM,SAAS,GAAe;QAC5B,EAAE,IAAI,EAAE,0BAA0B,EAAE,KAAK,EAAE,MAAM,CAAC,YAAY,CAAC,EAAE;KAClE,CAAA;IAED,MAAM,OAAO,GAAY;QACvB,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,WAAW;QACjB,OAAO;QACP,UAAU,EAAE,UAAU,EAAE,CAAC,MAAM;QAC/B,SAAS;KACV,CAAA;IAED,0FAA0F;IAC1F,8CAA8C;IAC9C,IAAI,UAAU,EAAE,OAAO,KAAK,SAAS;QAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAA;IAErE,MAAM,OAAO,GAAa,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAA;IAEhF,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAEvB;;;;OAIG;IACH,OAAO,EAAE,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,CAAA;AAClE,CAAC;AAED,8FAA8F;AAC9F,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,CAAA"}

package/transpiled/extensions.cadence/index.d.ts

@@ -2,6 +2,8 @@ export { manifest } from './manifest.ts';
 export { components } from './components.ts';
 export { deployment, standalone } from './deployment.ts';
 export { context } from './context.ts';
+export { occurrences } from './schedule.ts';
 export * from './const.ts';
 export * as schemas from './schemas.ts';
-export type { Annotation, Declaration, Declared, Delay, Options, Pulse, Scope } from './types.ts';
+export type { Annotation, Declaration, Declared, Delay, Entry, Options, Pulse, Schedule, Scope, Stated } from './types.ts';
+export type { Occurrences } from './schedule.ts';

package/transpiled/extensions.cadence/index.js

@@ -2,6 +2,7 @@ export { manifest } from './manifest.js';
 export { components } from './components.js';
 export { deployment, standalone } from './deployment.js';
 export { context } from './context.js';
+export { occurrences } from './schedule.js';
 export * from './const.js';
 export * as schemas from './schemas.js';
 //# sourceMappingURL=index.js.map

package/transpiled/extensions.cadence/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../source/extensions.cadence/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,cAAc,YAAY,CAAA;AAC1B,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../source/extensions.cadence/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,cAAc,YAAY,CAAA;AAC1B,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA"}

package/transpiled/extensions.cadence/manifest.d.ts

@@ -1,9 +1,9 @@
 import type { Declaration, Declared } from './types.ts';
 import type { Manifest } from '@toa.io/norm';
 /**
- * The `cadence:` block of a component manifest: the operations called on a cadence, by the
- * operation each one calls. Norm hands over the whole manifest, so what the declaration refers
- * to is checked here rather than left to fail at boot.
+ * The `cadence:` block of a component manifest: the operations called on a cadence or at the
+ * moments of a calendar, by the operation each entry calls. Norm hands over the whole manifest,
+ * so what the declaration refers to is checked here rather than left to fail at boot.
  *
  * A component that declares nothing still has a declaration. `cadence: ~` is how one that only
  * delays calls says so, and it has to produce a value or norm rejects the extension.

package/transpiled/extensions.cadence/manifest.js

@@ -1,8 +1,9 @@
 import * as schemas from './schemas.js';
+import { occurrences } from './schedule.js';
 /**
- * The `cadence:` block of a component manifest: the operations called on a cadence, by the
- * operation each one calls. Norm hands over the whole manifest, so what the declaration refers
- * to is checked here rather than left to fail at boot.
+ * The `cadence:` block of a component manifest: the operations called on a cadence or at the
+ * moments of a calendar, by the operation each entry calls. Norm hands over the whole manifest,
+ * so what the declaration refers to is checked here rather than left to fail at boot.
  *
  * A component that declares nothing still has a declaration. `cadence: ~` is how one that only
  * delays calls says so, and it has to produce a value or norm rejects the extension.
@@ -10,31 +11,83 @@ import * as schemas from './schemas.js';
 export function manifest(declaration, component) {
     const normalized = expand(declaration);
     schemas.declaration.validate(normalized, 'Invalid cadence declaration');
-    for (const [endpoint, pulse] of Object.entries(normalized)) {
+    for (const [endpoint, entries] of Object.entries(normalized)) {
         const operation = component.operations?.[endpoint];
         if (operation === undefined)
-            throw new Error(`Pulse refers to undefined operation '${endpoint}'`);
+            throw new Error(`Cadence refers to undefined operation '${endpoint}'`);
         if (!TYPES.has(operation.type))
-            throw new Error(`Pulse '${endpoint}' must refer to an operation of the allowed types: ` +
+            throw new Error(`Cadence of '${endpoint}' must refer to an operation of the allowed types: ` +
                 [...TYPES].join(', '));
-        if (pulse.intervals > pulse.cycle)
-            throw new Error(`Pulse '${endpoint}' splits a cycle of ${pulse.cycle} seconds into ` +
-                `${pulse.intervals} intervals, which is less than a second each`);
+        for (const entry of entries)
+            check(endpoint, entry);
     }
     return normalized;
 }
-/** A pulse whose cycle is not split has nothing to state but the cycle. */
+/**
+ * An entry is one kind or the other, and each kind is a closed shape: what belongs to a pulse
+ * is refused beside a schedule and the other way round, by the schema of the kind it is.
+ */
+function check(endpoint, entry) {
+    const pulse = 'cycle' in entry;
+    const schedule = 'schedule' in entry;
+    if (pulse && schedule)
+        throw new Error(`Cadence of '${endpoint}' states both a cycle and a schedule`);
+    if (schedule)
+        return scheduled(endpoint, entry);
+    if (pulse)
+        return pulsed(endpoint, entry);
+    throw new Error(`Cadence of '${endpoint}' states neither a cycle nor a schedule`);
+}
+function pulsed(endpoint, pulse) {
+    schemas.pulse.validate(pulse, `Invalid pulse '${endpoint}'`);
+    if (pulse.intervals > pulse.cycle)
+        throw new Error(`Pulse '${endpoint}' splits a cycle of ${pulse.cycle} seconds into ` +
+            `${pulse.intervals} intervals, which is less than a second each`);
+    // what lives in a process is that process's own in every region
+    if (pulse.scope === 'replica' && pulse.region !== undefined)
+        throw new Error(`Pulse '${endpoint}' is every replica's and cannot name a region`);
+}
+function scheduled(endpoint, schedule) {
+    // read before the schema, which takes a null for the number it coerces it to: no bound at all
+    // is what a delay may state and a schedule may not, because nothing would then keep the
+    // occurrences of an outage from all being owed at once
+    if (schedule.overdue === null)
+        throw new Error(`Invalid schedule '${endpoint}': a schedule states a bound or none, not null`);
+    schemas.schedule.validate(schedule, `Invalid schedule '${endpoint}'`);
+    try {
+        occurrences(schedule.schedule, schedule.zone);
+    }
+    catch (error) {
+        throw new Error(`Invalid schedule '${endpoint}': ${error.message}`, {
+            cause: error
+        });
+    }
+}
+/** An operation has a list of entries, and an entry states everything its kind has. */
 function expand(declaration) {
     if (declaration === null || declaration === undefined)
         return {};
-    // a cycle nothing splits is one interval, which is what the shorthand declares
-    return Object.fromEntries(Object.entries(declaration).map(([endpoint, pulse]) => {
-        const declared = typeof pulse === 'number' ? { cycle: pulse } : { ...pulse };
+    return Object.fromEntries(Object.entries(declaration).map(([endpoint, stated]) => [
+        endpoint,
+        (Array.isArray(stated) ? stated : [stated]).map(entry)
+    ]));
+}
+function entry(stated) {
+    // a number is a cycle nothing splits and a string is an expression, which is what the
+    // shorthands declare
+    const declared = typeof stated === 'number'
+        ? { cycle: stated }
+        : typeof stated === 'string'
+            ? { schedule: stated }
+            : { ...stated };
+    if ('schedule' in declared)
+        declared.zone ??= 'UTC';
+    else if ('cycle' in declared) {
         declared.intervals ??= 1;
         // a pulse that does not say whose work it is is the component's, as every pulse was
         declared.scope ??= 'group';
-        return [endpoint, declared];
-    }));
+    }
+    return declared;
 }
 /**
  * The types a receiver may refer to. An operation that produces no side effects has nothing to

package/transpiled/extensions.cadence/manifest.js.map

@@ -1 +1 @@
-{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../source/extensions.cadence/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAIvC;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CACtB,WAAwC,EACxC,SAAmB;IAEnB,MAAM,UAAU,GAA4B,MAAM,CAAC,WAAW,CAAC,CAAA;IAE/D,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAc,UAAU,EAAE,6BAA6B,CAAC,CAAA;IAEpF,KAAK,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3D,MAAM,SAAS,GAAG,SAAS,CAAC,UAAU,EAAE,CAAC,QAAQ,CAAC,CAAA;QAElD,IAAI,SAAS,KAAK,SAAS;YACzB,MAAM,IAAI,KAAK,CAAC,wCAAwC,QAAQ,GAAG,CAAC,CAAA;QAEtE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC;YAC5B,MAAM,IAAI,KAAK,CACb,UAAU,QAAQ,qDAAqD;gBACrE,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CACxB,CAAA;QAEH,IAAI,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,KAAK;YAC/B,MAAM,IAAI,KAAK,CACb,UAAU,QAAQ,uBAAuB,KAAK,CAAC,KAAK,gBAAgB;gBAClE,GAAG,KAAK,CAAC,SAAS,8CAA8C,CACnE,CAAA;IACL,CAAC;IAED,OAAO,UAAU,CAAA;AACnB,CAAC;AAED,2EAA2E;AAC3E,SAAS,MAAM,CAAC,WAAwC;IACtD,IAAI,WAAW,KAAK,IAAI,IAAI,WAAW,KAAK,SAAS;QAAE,OAAO,EAAE,CAAA;IAEhE,+EAA+E;IAC/E,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,EAAE;QACpD,MAAM,QAAQ,GACZ,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAA;QAE7D,QAAQ,CAAC,SAAS,KAAK,CAAC,CAAA;QAExB,oFAAoF;QACpF,QAAQ,CAAC,KAAK,KAAK,OAAO,CAAA;QAE1B,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;IAC7B,CAAC,CAAC,CACH,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAA"}
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../source/extensions.cadence/manifest.ts"],"names":[],"mappings":"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"}

package/transpiled/extensions.cadence/schedule.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The moments a schedule states, as a function of the clock: what comes first after a moment,
+ * in milliseconds since the epoch. Nothing is kept between two questions, so every process that
+ * holds the same expression answers the same.
+ *
+ * Raises where the expression or the zone does not parse, and where the expression names a
+ * moment no calendar has — which is what reading a manifest refuses.
+ */
+export declare function occurrences(expression: string, zone: string): Occurrences;
+/** What comes first after `after`, or `null` where nothing ever does again. */
+export type Occurrences = (after: number) => number | null;

package/transpiled/extensions.cadence/schedule.js

@@ -0,0 +1,25 @@
+import { Cron } from 'croner';
+/**
+ * The moments a schedule states, as a function of the clock: what comes first after a moment,
+ * in milliseconds since the epoch. Nothing is kept between two questions, so every process that
+ * holds the same expression answers the same.
+ *
+ * Raises where the expression or the zone does not parse, and where the expression names a
+ * moment no calendar has — which is what reading a manifest refuses.
+ */
+export function occurrences(expression, zone) {
+    const fields = expression.trim().split(/\s+/).length;
+    // what the parser reads beyond these — a year, a nickname — is not what is documented
+    if (fields !== 5 && fields !== 6)
+        throw new Error(`'${expression}' is not a cron expression of five or six fields`);
+    // given nothing to run, so it keeps no timer and is only ever asked
+    const cron = new Cron(expression, { timezone: zone });
+    function next(after) {
+        return cron.nextRun(new Date(after))?.getTime() ?? null;
+    }
+    // the zone is not read until a moment is asked for
+    if (next(Date.now()) === null)
+        throw new Error(`'${expression}' never comes due`);
+    return next;
+}
+//# sourceMappingURL=schedule.js.map

package/transpiled/extensions.cadence/schedule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule.js","sourceRoot":"","sources":["../../source/extensions.cadence/schedule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAE7B;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,UAAkB,EAAE,IAAY;IAC1D,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAA;IAEpD,sFAAsF;IACtF,IAAI,MAAM,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,IAAI,UAAU,kDAAkD,CAAC,CAAA;IAEnF,oEAAoE;IACpE,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,UAAU,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAA;IAErD,SAAS,IAAI,CAAC,KAAa;QACzB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,IAAI,CAAA;IACzD,CAAC;IAED,mDAAmD;IACnD,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,IAAI,UAAU,mBAAmB,CAAC,CAAA;IAEjF,OAAO,IAAI,CAAA;AACb,CAAC"}

package/transpiled/extensions.cadence/schemas.d.ts

@@ -1,4 +1,6 @@
 import type { Schema } from '@toa.io/schemas';
-import type { Annotation, Declaration } from './types.ts';
+import type { Annotation, Declaration, Pulse, Schedule } from './types.ts';
 export declare const declaration: Schema<Declaration>;
+export declare const pulse: Schema<Pulse>;
+export declare const schedule: Schema<Schedule>;
 export declare const annotation: Schema<Annotation>;

package/transpiled/extensions.cadence/schemas.js

@@ -3,5 +3,7 @@ import * as schemas from '@toa.io/schemas';
 const path = resolve(import.meta.dirname, '../../schemas/extensions.cadence');
 const namespace = schemas.namespace(path);
 export const declaration = namespace.schema('declaration');
+export const pulse = namespace.schema('pulse');
+export const schedule = namespace.schema('schedule');
 export const annotation = namespace.schema('annotation');
 //# sourceMappingURL=schemas.js.map

package/transpiled/extensions.cadence/schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../source/extensions.cadence/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,KAAK,OAAO,MAAM,iBAAiB,CAAA;AAI1C,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,EAAE,kCAAkC,CAAC,CAAA;AAC7E,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;AAEzC,MAAM,CAAC,MAAM,WAAW,GAAwB,SAAS,CAAC,MAAM,CAAC,aAAa,CAAC,CAAA;AAC/E,MAAM,CAAC,MAAM,UAAU,GAAuB,SAAS,CAAC,MAAM,CAAC,YAAY,CAAC,CAAA"}
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../source/extensions.cadence/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,KAAK,OAAO,MAAM,iBAAiB,CAAA;AAI1C,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,EAAE,kCAAkC,CAAC,CAAA;AAC7E,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;AAEzC,MAAM,CAAC,MAAM,WAAW,GAAwB,SAAS,CAAC,MAAM,CAAC,aAAa,CAAC,CAAA;AAC/E,MAAM,CAAC,MAAM,KAAK,GAAkB,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;AAC7D,MAAM,CAAC,MAAM,QAAQ,GAAqB,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;AACtE,MAAM,CAAC,MAAM,UAAU,GAAuB,SAAS,CAAC,MAAM,CAAC,YAAY,CAAC,CAAA"}

package/transpiled/extensions.cadence/types.d.ts

@@ -1,12 +1,17 @@
-/** What one component declares under `cadence:`, by the operation each one calls. */
-export type Declaration = Record<string, Pulse>;
+/** What one component declares under `cadence:`, by the operation each entry calls. */
+export type Declaration = Record<string, Entry[]>;
+/** One way an operation is called: on a cadence, or at the moments of a calendar. */
+export type Entry = Pulse | Schedule;
 /**
- * What a manifest may state: a whole pulse, one with what it leaves to the default left out,
- * or the cycle alone.
+ * What a manifest may state for an operation: one entry or a list of them, each a whole entry,
+ * one with what it leaves to the default left out, or its cycle or its expression alone.
  */
-export type Declared = Record<string, number | (Partial<Pulse> & {
+export type Declared = Record<string, Stated | Stated[]>;
+export type Stated = number | string | (Partial<Pulse> & {
     cycle: number;
-})>;
+}) | (Partial<Schedule> & {
+    schedule: string;
+});
 export interface Pulse {
     /** seconds one whole cycle takes */
     cycle: number;
@@ -17,6 +22,21 @@ export interface Pulse {
      * is every replica's own, for what lives inside a process.
      */
     scope: Scope;
+    /** the rank of the region that makes the calls; every region makes them where absent */
+    region?: number;
+}
+export interface Schedule {
+    /** a cron expression of five fields, or of six where the first is seconds */
+    schedule: string;
+    /** the time zone the expression is read in */
+    zone: string;
+    /**
+     * Seconds a call may be late and still be made. Absent, it is made until the next one comes
+     * due, so that at most one occurrence is ever owed.
+     */
+    overdue?: number;
+    /** the rank of the region that makes the calls; every region makes them where absent */
+    region?: number;
 }
 export type Scope = 'group' | 'replica';
 /** `context.delay` — a call to be made later, answering the id that cancels it. */

package/transpiled/extensions.exposition/manifest.js

@@ -31,9 +31,9 @@ function specifyMethod(method, manifest) {
         throw new Error(`Operation '${method.mapping.endpoint}' not found`);
     if (method.mapping.query === undefined)
         method.mapping.query = operation.query === false ? null : {};
-    // a page is taken of a collection, and of nothing else: an operation that answers one object
-    // takes no `omit` and no `limit`, and refuses a request that carries them
-    method.mapping.paged = operation.type === 'observation' && operation.scope === 'entries';
+    // a page is taken of a set, whatever is done with it, and of nothing else: an operation over
+    // one object takes no `omit` and no `limit`, and refuses a request that carries them
+    method.mapping.paged = operation.scope === 'entries';
     method.mapping.streamed = operation.scope === 'stream';
     projects(method, operation.type);
     streams(method, operation);

package/transpiled/extensions.exposition/manifest.js.map

@@ -1 +1 @@
-{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../source/extensions.exposition/manifest.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../source/extensions.exposition/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAsC,MAAM,mBAAmB,CAAA;AAC7E,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAGvC,MAAM,UAAU,QAAQ,CAAC,WAAmB,EAAE,QAAkB;IAC9D,IAAI,CAAC,CAAC,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,KAAK,IAAI,CAAC;QAC5D,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAA;IAE7D,WAAW,GAAG,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAA;IAElE,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,EAAE,SAAS,CAAC,CAAA;IAE1C,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IACvB,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;IAE3B,OAAO,IAAI,CAAA;AACb,CAAC;AAED,SAAS,IAAI,CAAC,WAAmB,EAAE,SAAiB,EAAE,IAAY;IAChE,MAAM,IAAI,GACR,CAAC,SAAS,KAAK,SAAS,IAAI,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,SAAS,CAAC;QAC3E,GAAG;QACH,IAAI,CAAA;IAEN,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,CAAA;AAChC,CAAC;AAED,SAAS,OAAO,CAAC,IAAU,EAAE,QAAkB;IAC7C,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChC,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO;YAAE,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;QAExE,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IAC/B,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,MAAc,EAAE,QAAkB;IACvD,IAAI,MAAM,CAAC,OAAO,EAAE,QAAQ,KAAK,SAAS;QAAE,OAAM;IAElD,MAAM,SAAS,GAAG,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;IAE9D,IAAI,SAAS,KAAK,SAAS;QACzB,MAAM,IAAI,KAAK,CAAC,cAAc,MAAM,CAAC,OAAO,CAAC,QAAQ,aAAa,CAAC,CAAA;IAErE,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS;QACpC,MAAM,CAAC,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAE,EAAuB,CAAA;IAEpF,6FAA6F;IAC7F,qFAAqF;IACrF,MAAM,CAAC,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,KAAK,KAAK,SAAS,CAAA;IACpD,MAAM,CAAC,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,KAAK,KAAK,QAAQ,CAAA;IAEtD,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI,CAAC,CAAA;IAChC,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IAE1B,MAAM,CAAC,OAAO,CAAC,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAA;IAC7C,MAAM,CAAC,OAAO,CAAC,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAA;AAC1C,CAAC;AAED;;;GAGG;AACH,SAAS,OAAO,CAAC,MAAc,EAAE,SAA8B;IAC7D,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CACnC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,KAAK,KAAK,IAAI,SAAS,CAAC,IAAI,KAAK,QAAQ,CACzE,CAAA;IAED,IAAI,MAAM,KAAK,SAAS;QAAE,OAAM;IAEhC,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAA;IAEzC,IAAI,SAAS,CAAC,MAAM,KAAK,SAAS;QAChC,MAAM,IAAI,KAAK,CACb,cAAc,QAAQ,oDAAoD,CAC3E,CAAA;IAEH,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CACrC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,KAAK,KAAK,IAAI,SAAS,CAAC,IAAI,KAAK,QAAQ,CACzE,CAAA;IAED,IAAI,QAAQ;QACV,MAAM,IAAI,KAAK,CACb,cAAc,QAAQ,+DAA+D,CACtF,CAAA;AACL,CAAC;AAED;;;GAGG;AACH,SAAS,QAAQ,CAAC,MAAc,EAAE,IAAY;IAC5C,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,UAAU,CAAA;IAEpD,IAAI,UAAU,KAAK,SAAS;QAAE,OAAM;IAEpC,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAA;IAEzC,IAAI,IAAI,KAAK,aAAa;QACxB,MAAM,IAAI,KAAK,CACb,cAAc,QAAQ,sDAAsD;YAC1E,IAAI,IAAI,iBAAiB,CAC5B,CAAA;IAEH,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,kBAAkB,QAAQ,oCAAoC,CAAC,CAAA;AACnF,CAAC"}

package/transpiled/extensions.exposition/realtime/index.d.ts

@@ -1,6 +1,6 @@
 export { deployment } from './deployment.ts';
 export { manifest } from './manifest.ts';
-export { parse } from './routes.ts';
+export { literal, parse } from './routes.ts';
 export { EXPIRE, STREAMS } from './const.ts';
 export type { Annotation } from './deployment.ts';
 export type { Declaration, Route, RouteDeclaration } from './routes.ts';

package/transpiled/extensions.exposition/realtime/index.js

@@ -1,5 +1,5 @@
 export { deployment } from './deployment.js';
 export { manifest } from './manifest.js';
-export { parse } from './routes.js';
+export { literal, parse } from './routes.js';
 export { EXPIRE, STREAMS } from './const.js';
 //# sourceMappingURL=index.js.map

package/transpiled/extensions.exposition/realtime/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../source/extensions.exposition/realtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AACnC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../source/extensions.exposition/realtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA"}

package/transpiled/extensions.exposition/realtime/routes.d.ts

@@ -1,11 +1,14 @@
 /**
  * A realtime route: an event of a component, the properties of its payload that are the keys of
- * the streams it goes to, and what of it they are given.
+ * the streams it goes to, the literal keys it goes to whatever its payload, and what of it they
+ * are given.
  */
 export interface Route {
     /** the event's label within its component */
     event: string;
     properties: string[];
+    /** keys as they are, `~` included */
+    literals: string[];
     expose: string[];
 }
 /** A component's `realtime` declaration, by event label. */
@@ -16,3 +19,9 @@ export interface RouteDeclaration {
     expose: string[];
 }
 export declare function parse(declaration: Declaration): Route[];
+/**
+ * A key that begins with `~` is the key itself. No property is named so, and no value of a
+ * property is taken for a key so, which keeps a literal's stream out of reach of whoever writes
+ * the values.
+ */
+export declare function literal(key: string): boolean;

package/transpiled/extensions.exposition/realtime/routes.js

@@ -1,8 +1,20 @@
 export function parse(declaration) {
-    return Object.entries(declaration).map(([event, { key, expose }]) => ({
-        event,
-        properties: Array.isArray(key) ? key : [key],
-        expose
-    }));
+    return Object.entries(declaration).map(([event, { key, expose }]) => {
+        const keys = Array.isArray(key) ? key : [key];
+        return {
+            event,
+            properties: keys.filter((one) => !literal(one)),
+            literals: keys.filter(literal),
+            expose
+        };
+    });
+}
+/**
+ * A key that begins with `~` is the key itself. No property is named so, and no value of a
+ * property is taken for a key so, which keeps a literal's stream out of reach of whoever writes
+ * the values.
+ */
+export function literal(key) {
+    return key.startsWith('~');
 }
 //# sourceMappingURL=routes.js.map

package/transpiled/extensions.exposition/realtime/routes.js.map

@@ -1 +1 @@
-{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../../source/extensions.exposition/realtime/routes.ts"],"names":[],"mappings":"AAqBA,MAAM,UAAU,KAAK,CAAC,WAAwB;IAC5C,OAAO,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QACpE,KAAK;QACL,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QAC5C,MAAM;KACP,CAAC,CAAC,CAAA;AACL,CAAC"}
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../../source/extensions.exposition/realtime/routes.ts"],"names":[],"mappings":"AAyBA,MAAM,UAAU,KAAK,CAAC,WAAwB;IAC5C,OAAO,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE;QAClE,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;QAE7C,OAAO;YACL,KAAK;YACL,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC/C,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;YAC9B,MAAM;SACP,CAAA;IACH,CAAC,CAAC,CAAA;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,GAAW;IACjC,OAAO,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAA;AAC5B,CAAC"}