anbaric-tsapi 1.56.8 → 1.57.0

package/dist/api/actions/Action.d.ts

@@ -1,5 +1,6 @@
 import { Actor } from "../actors/Actor.js";
 import { Job } from "../jobs/Job.js";
+import { Reads } from "../jobs/Reads.js";
 type CodeRun = (job: Job) => Promise<Map<string, any>>;
 declare class Action {
     readonly id: string;
@@ -7,6 +8,7 @@ declare class Action {
     description: string;
     actor: Actor;
     constructor(name: string, actor: Actor, description?: string, id?: string);
+    reads: Reads;
     predicate: (_job: Job) => boolean;
     run: CodeRun;
 }

package/dist/api/actions/Action.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Action.d.ts","sourceRoot":"","sources":["../../../src/api/actions/Action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,EAAC,MAAM,oBAAoB,CAAC;AACzC,OAAO,EAAC,GAAG,EAAC,MAAM,gBAAgB,CAAC;AAEnC,KAAK,OAAO,GAAG,CAAC,GAAG,EAAG,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;AAExD,cAAM,MAAM;IAER,QAAQ,CAAC,EAAE,EAAG,MAAM,CAAC;IACrB,IAAI,EAAG,MAAM,CAAC;IACd,WAAW,EAAG,MAAM,CAAC;IACrB,KAAK,EAAG,KAAK,CAAC;IAEd,YAAY,IAAI,EAAG,MAAM,EAAE,KAAK,EAAG,KAAK,EAAE,WAAW,GAAG,MAAW,EAAE,EAAE,GAAG,MAA4B,EAKrG;IAED,SAAS,SAAW,GAAG,aAAU;IACjC,GAAG,EAAG,OAAO,CAAmC;CAEnD;AAED,OAAO,EAAE,MAAM,EAAE,CAAA"}
+{"version":3,"file":"Action.d.ts","sourceRoot":"","sources":["../../../src/api/actions/Action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,EAAC,MAAM,oBAAoB,CAAC;AACzC,OAAO,EAAC,GAAG,EAAC,MAAM,gBAAgB,CAAC;AACnC,OAAO,EAAC,KAAK,EAAC,MAAM,kBAAkB,CAAC;AAEvC,KAAK,OAAO,GAAG,CAAC,GAAG,EAAG,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;AAOxD,cAAM,MAAM;IAER,QAAQ,CAAC,EAAE,EAAG,MAAM,CAAC;IACrB,IAAI,EAAG,MAAM,CAAC;IACd,WAAW,EAAG,MAAM,CAAC;IACrB,KAAK,EAAG,KAAK,CAAC;IAEd,YAAY,IAAI,EAAG,MAAM,EAAE,KAAK,EAAG,KAAK,EAAE,WAAW,GAAG,MAAW,EAAE,EAAE,GAAG,MAA4B,EAKrG;IAED,KAAK,EAAG,KAAK,CAAoB;IACjC,SAAS,SAAW,GAAG,aAAU;IACjC,GAAG,EAAG,OAAO,CAAmC;CAEnD;AAED,OAAO,EAAE,MAAM,EAAE,CAAA"}

package/dist/api/actions/Action.js

@@ -1,3 +1,9 @@
+import { Reads } from "../jobs/Reads.js";
+/* A unit of work in a state. `reads` names the properties the action needs -
+   given the machine's definitions, so it can be "everything" (the default),
+   a fixed few, or whatever matches - and only those are loaded for the job
+   before `predicate` and `run` see it. Declare it on any action that reads a
+   little of a job that holds a lot. */
 class Action {
     id;
     name;
@@ -9,6 +15,7 @@ class Action {
         this.description = description;
         this.id = id;
     }
+    reads = Reads.everything;
     predicate = (_job) => true;
     run = async (_job) => new Map();
 }

package/dist/api/actions/Action.js.map

@@ -1 +1 @@
-{"version":3,"file":"Action.js","sourceRoot":"","sources":["../../../src/api/actions/Action.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM;IAEC,EAAE,CAAU;IACrB,IAAI,CAAU;IACd,WAAW,CAAU;IACrB,KAAK,CAAS;IAEd,YAAY,IAAa,EAAE,KAAa,EAAE,WAAW,GAAY,EAAE,EAAE,EAAE,GAAY,MAAM,CAAC,UAAU,EAAE;QAClG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IACjB,CAAC;IAED,SAAS,GAAG,CAAC,IAAU,EAAE,EAAE,CAAC,IAAI,CAAC;IACjC,GAAG,GAAa,KAAK,EAAE,IAAU,EAAE,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC;CAEnD;AAED,OAAO,EAAE,MAAM,EAAE,CAAA"}
+{"version":3,"file":"Action.js","sourceRoot":"","sources":["../../../src/api/actions/Action.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,KAAK,EAAC,MAAM,kBAAkB,CAAC;AAIvC;;;;uCAIuC;AACvC,MAAM,MAAM;IAEC,EAAE,CAAU;IACrB,IAAI,CAAU;IACd,WAAW,CAAU;IACrB,KAAK,CAAS;IAEd,YAAY,IAAa,EAAE,KAAa,EAAE,WAAW,GAAY,EAAE,EAAE,EAAE,GAAY,MAAM,CAAC,UAAU,EAAE;QAClG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IACjB,CAAC;IAED,KAAK,GAAW,KAAK,CAAC,UAAU,CAAC;IACjC,SAAS,GAAG,CAAC,IAAU,EAAE,EAAE,CAAC,IAAI,CAAC;IACjC,GAAG,GAAa,KAAK,EAAE,IAAU,EAAE,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC;CAEnD;AAED,OAAO,EAAE,MAAM,EAAE,CAAA"}

package/dist/api/actions/Await.d.ts

@@ -1,4 +1,5 @@
 import { Job } from "../jobs/Job.js";
+import { Reads } from "../jobs/Reads.js";
 import { AwaitParty, WaitForInput } from "./WaitForInput.js";
 declare class Await {
     readonly id: string;
@@ -9,6 +10,7 @@ declare class Await {
     resolveUrl: string | ((job: Job) => string);
     metadata: (job: Job) => Map<string, any>;
     notify: Array<string>;
+    reads: Reads;
     constructor(name: string, waitingFor?: AwaitParty, description?: string, id?: string, notify?: Array<string>);
     waitForInput(job: Job): WaitForInput;
 }

package/dist/api/actions/Await.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Await.d.ts","sourceRoot":"","sources":["../../../src/api/actions/Await.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,GAAG,EAAC,MAAM,gBAAgB,CAAC;AACnC,OAAO,EAAC,UAAU,EAAE,YAAY,EAAC,MAAM,mBAAmB,CAAC;AAe3D,cAAM,KAAK;IAEP,QAAQ,CAAC,EAAE,EAAG,MAAM,CAAC;IACrB,IAAI,EAAG,MAAM,CAAC;IACd,WAAW,EAAG,MAAM,CAAC;IACrB,UAAU,CAAC,EAAG,UAAU,CAAC;IACzB,MAAM,EAAG,KAAK,CAAC,MAAM,CAAC,CAAM;IAC5B,UAAU,EAAG,MAAM,GAAG,CAAC,CAAC,GAAG,EAAG,GAAG,KAAK,MAAM,CAAC,CAAM;IACnD,QAAQ,EAAG,CAAC,GAAG,EAAG,GAAG,KAAK,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAA6B;IACvE,MAAM,EAAG,KAAK,CAAC,MAAM,CAAC,CAAM;IAE5B,YAAY,IAAI,EAAG,MAAM,EAAE,UAAU,CAAC,EAAG,UAAU,EAAE,WAAW,GAAG,MAAW,EAClE,EAAE,GAAG,MAA4B,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAM,EAMzE;IAED,YAAY,CAAC,GAAG,EAAG,GAAG,GAAI,YAAY,CAGrC;CAEJ;AAED,OAAO,EAAE,KAAK,EAAE,CAAA"}
+{"version":3,"file":"Await.d.ts","sourceRoot":"","sources":["../../../src/api/actions/Await.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,GAAG,EAAC,MAAM,gBAAgB,CAAC;AACnC,OAAO,EAAC,KAAK,EAAC,MAAM,kBAAkB,CAAC;AACvC,OAAO,EAAC,UAAU,EAAE,YAAY,EAAC,MAAM,mBAAmB,CAAC;AAe3D,cAAM,KAAK;IAEP,QAAQ,CAAC,EAAE,EAAG,MAAM,CAAC;IACrB,IAAI,EAAG,MAAM,CAAC;IACd,WAAW,EAAG,MAAM,CAAC;IACrB,UAAU,CAAC,EAAG,UAAU,CAAC;IACzB,MAAM,EAAG,KAAK,CAAC,MAAM,CAAC,CAAM;IAC5B,UAAU,EAAG,MAAM,GAAG,CAAC,CAAC,GAAG,EAAG,GAAG,KAAK,MAAM,CAAC,CAAM;IACnD,QAAQ,EAAG,CAAC,GAAG,EAAG,GAAG,KAAK,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAA6B;IACvE,MAAM,EAAG,KAAK,CAAC,MAAM,CAAC,CAAM;IAE5B,KAAK,EAAG,KAAK,CAAoB;IAEjC,YAAY,IAAI,EAAG,MAAM,EAAE,UAAU,CAAC,EAAG,UAAU,EAAE,WAAW,GAAG,MAAW,EAClE,EAAE,GAAG,MAA4B,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAM,EAMzE;IAED,YAAY,CAAC,GAAG,EAAG,GAAG,GAAI,YAAY,CAGrC;CAEJ;AAED,OAAO,EAAE,KAAK,EAAE,CAAA"}

package/dist/api/actions/Await.js

@@ -1,3 +1,4 @@
+import { Reads } from "../jobs/Reads.js";
 import { WaitForInput } from "./WaitForInput.js";
 /* A pause point in a state's action list. When a job reaches an Await it runs
    nothing: the job is parked in the "Awaiting input" status and is not
@@ -21,6 +22,8 @@ class Await {
     resolveUrl = "";
     metadata = (_job) => new Map();
     notify = [];
+    // What resolveUrl and metadata read from the job; everything by default.
+    reads = Reads.everything;
     constructor(name, waitingFor, description = "", id = crypto.randomUUID(), notify = []) {
         this.name = name;
         this.waitingFor = waitingFor;

package/dist/api/actions/Await.js.map

@@ -1 +1 @@
-{"version":3,"file":"Await.js","sourceRoot":"","sources":["../../../src/api/actions/Await.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,YAAY,EAAC,MAAM,mBAAmB,CAAC;AAE3D;;;;;;;;;;;;iFAYiF;AACjF,MAAM,KAAK;IAEE,EAAE,CAAU;IACrB,IAAI,CAAU;IACd,WAAW,CAAU;IACrB,UAAU,CAAe;IACzB,MAAM,GAAmB,EAAE,CAAC;IAC5B,UAAU,GAAsC,EAAE,CAAC;IACnD,QAAQ,GAAqC,CAAC,IAAU,EAAE,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC;IACvE,MAAM,GAAmB,EAAE,CAAC;IAE5B,YAAY,IAAa,EAAE,UAAwB,EAAE,WAAW,GAAY,EAAE,EAClE,EAAE,GAAY,MAAM,CAAC,UAAU,EAAE,EAAE,MAAM,GAAmB,EAAE;QACtE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;IAED,YAAY,CAAC,GAAS;QAClB,MAAM,UAAU,GAAG,OAAO,IAAI,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC;QAClG,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IAC1F,CAAC;CAEJ;AAED,OAAO,EAAE,KAAK,EAAE,CAAA"}
+{"version":3,"file":"Await.js","sourceRoot":"","sources":["../../../src/api/actions/Await.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,KAAK,EAAC,MAAM,kBAAkB,CAAC;AACvC,OAAO,EAAa,YAAY,EAAC,MAAM,mBAAmB,CAAC;AAE3D;;;;;;;;;;;;iFAYiF;AACjF,MAAM,KAAK;IAEE,EAAE,CAAU;IACrB,IAAI,CAAU;IACd,WAAW,CAAU;IACrB,UAAU,CAAe;IACzB,MAAM,GAAmB,EAAE,CAAC;IAC5B,UAAU,GAAsC,EAAE,CAAC;IACnD,QAAQ,GAAqC,CAAC,IAAU,EAAE,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC;IACvE,MAAM,GAAmB,EAAE,CAAC;IAC5B,yEAAyE;IACzE,KAAK,GAAW,KAAK,CAAC,UAAU,CAAC;IAEjC,YAAY,IAAa,EAAE,UAAwB,EAAE,WAAW,GAAY,EAAE,EAClE,EAAE,GAAY,MAAM,CAAC,UAAU,EAAE,EAAE,MAAM,GAAmB,EAAE;QACtE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;IAED,YAAY,CAAC,GAAS;QAClB,MAAM,UAAU,GAAG,OAAO,IAAI,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC;QAClG,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IAC1F,CAAC;CAEJ;AAED,OAAO,EAAE,KAAK,EAAE,CAAA"}

package/dist/api/jobs/JobPersistence.d.ts

@@ -11,18 +11,26 @@ declare abstract class JobPersistence {
     countByState(actor: Actor): Promise<Array<JobPersistence.StateCount>>;
     private generatePropertiesDiff;
     private updateProperties;
-    retrieve(id: string, actor: Actor): Promise<Job>;
+    retrieve(id: string, actor: Actor, keys?: Array<string>): Promise<Job>;
     delete(id: string, actor: Actor): Promise<void>;
-    list(actor: Actor, pageSize?: number, page?: number): Promise<Array<Job>>;
-    protected abstract saveInternal(job: Job): Promise<void>;
-    protected abstract retrieveInternal(id: string): Promise<Job>;
+    list(actor: Actor, pageSize?: number, page?: number, query?: JobPersistence.Query): Promise<Array<Job>>;
+    protected abstract saveInternal(job: Job, properties?: Map<string, any>): Promise<void>;
+    protected abstract retrieveInternal(id: string, keys?: Array<string>): Promise<Job>;
     protected abstract deleteInternal(id: string): Promise<void>;
-    protected abstract listInternal(pageSize?: number, page?: number): Promise<Array<Job>>;
+    protected abstract listInternal(pageSize?: number, page?: number, query?: JobPersistence.Query): Promise<Array<Job>>;
     protected abstract killInternal(id: string): Promise<void>;
     protected abstract killOlderThanInternal(lastUpdatedBefore: Date): Promise<number>;
     protected abstract countByStateInternal(): Promise<Array<JobPersistence.StateCount>>;
 }
 declare namespace JobPersistence {
+    type Query = {
+        workflowId?: string;
+        appId?: string;
+        state?: string;
+        status?: string;
+        killed?: boolean;
+        order?: "oldest" | "newest";
+    };
     enum Interaction {
         CREATE = "CREATE",
         UPDATE_PROPERTIES = "UPDATE_PROPERTIES",

package/dist/api/jobs/JobPersistence.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"JobPersistence.d.ts","sourceRoot":"","sources":["../../../src/api/jobs/JobPersistence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,EAAC,MAAM,oBAAoB,CAAC;AACzC,OAAO,EAAC,OAAO,EAAC,MAAM,wBAAwB,CAAC;AAC/C,OAAO,EAAC,GAAG,EAAC,MAAM,UAAU,CAAC;AAO7B,uBAAe,cAAc;IAEb,SAAS,CAAC,OAAO,EAAG,OAAO;IAAvC,YAAsB,OAAO,EAAG,OAAO,EACtC;IAEK,MAAM,CAAC,KAAK,EAAG,KAAK,EACf,GAAG,EAAG,GAAG,GAAI,OAAO,CAAC,IAAI,CAAC,CAKpC;IAEK,IAAI,CAAC,KAAK,EAAG,KAAK,EACb,iBAAiB,EAAG,MAAM,EAC1B,GAAG,EAAG,GAAG,EACT,UAAU,CAAC,EAAG,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,EAC9B,KAAK,CAAC,EAAG,MAAM,GAAI,OAAO,CAAC,IAAI,CAAC,CAiC1C;IAEK,IAAI,CAAC,EAAE,EAAG,MAAM,EAAE,KAAK,EAAG,KAAK,GAAI,OAAO,CAAC,IAAI,CAAC,CAGrD;IAEK,aAAa,CAAC,iBAAiB,EAAG,IAAI,EAAE,KAAK,EAAG,KAAK,GAAI,OAAO,CAAC,MAAM,CAAC,CAI7E;IAEK,YAAY,CAAC,KAAK,EAAG,KAAK,GAAI,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAG5E;IAED,OAAO,CAAC,sBAAsB;IAS9B,OAAO,CAAC,gBAAgB;IAQlB,QAAQ,CAAC,EAAE,EAAG,MAAM,EAAE,KAAK,EAAG,KAAK,GAAI,OAAO,CAAC,GAAG,CAAC,CAGxD;IAEK,MAAM,CAAC,EAAE,EAAG,MAAM,EAAE,KAAK,EAAG,KAAK,GAAI,OAAO,CAAC,IAAI,CAAC,CAGvD;IAEK,IAAI,CAAC,KAAK,EAAG,KAAK,EAAE,QAAQ,CAAC,EAAG,MAAM,EAAE,IAAI,CAAC,EAAG,MAAM,GAAI,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAGlF;IAED,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,GAAG,EAAG,GAAG,GAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,SAAS,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,EAAG,MAAM,GAAI,OAAO,CAAC,GAAG,CAAC,CAAC;IAChE,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,EAAG,MAAM,GAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAG,MAAM,EAAE,IAAI,CAAC,EAAG,MAAM,GAAI,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1F,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,EAAG,MAAM,GAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,SAAS,CAAC,QAAQ,CAAC,qBAAqB,CAAC,iBAAiB,EAAG,IAAI,GAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACrF,SAAS,CAAC,QAAQ,CAAC,oBAAoB,IAAK,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC;CAEzF;AAED,kBAAU,cAAc,CAAC;IAErB,KAAY,WAAW;QACnB,MAAM,WAAW;QACjB,iBAAiB,sBAAsB;QACvC,YAAY,iBAAiB;QAC7B,KAAK,UAAU;QACf,MAAM,WAAW;QACjB,IAAI,SAAS;QACb,IAAI,SAAS;QACb,IAAI,SAAS;KAChB;IAED,KAAY,UAAU,GAAG;QACrB,KAAK,EAAG,MAAM,CAAC;QACf,MAAM,EAAG,OAAO,CAAC;QACjB,KAAK,EAAG,MAAM,CAAC;KAClB,CAAC;CAEL;AAED,OAAO,EAAE,cAAc,EAAE,CAAA"}
+{"version":3,"file":"JobPersistence.d.ts","sourceRoot":"","sources":["../../../src/api/jobs/JobPersistence.ts"],"names":[],"mappings":"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"}

package/dist/api/jobs/JobPersistence.js

@@ -11,7 +11,7 @@ class JobPersistence {
     }
     async create(actor, job) {
         await this.auditor.audit(job.appId, "job", job.id, actor, [JobPersistence.Interaction.CREATE], "Job created", job);
-        this.saveInternal(job);
+        await this.saveInternal(job, job.properties);
     }
     async save(actor, changeDescription, job, properties, state) {
         const change = {
@@ -29,7 +29,7 @@ class JobPersistence {
         }
         await this.auditor.audit(job.appId, "job", job.id, actor, interaction, changeDescription, change);
         const updatedJob = new Job(job.id, properties ? this.updateProperties(job.properties, properties) : job.properties, state ? state : job.state, job.workflowId, job.appId, job.startedBy, job.startedAt, new Date(), job.killed, job.status, job.awaitMetadata, job.waitingFor);
-        this.saveInternal(updatedJob);
+        await this.saveInternal(updatedJob, properties);
     }
     async kill(id, actor) {
         await this.auditor.audit(currentAppId(), "job", id, actor, [JobPersistence.Interaction.KILL], "Job killed", null);
@@ -57,17 +57,26 @@ class JobPersistence {
         }
         return updated;
     }
-    async retrieve(id, actor) {
+    /* The job, with either every property or only the `keys` asked for. A job
+       is read with the keys its next step declares it reads, so a job holding
+       a great deal of data costs a step only what that step needs. A property
+       that was not asked for is simply absent from the map. */
+    async retrieve(id, actor, keys) {
         await this.auditor.audit(currentAppId(), "job", id, actor, [JobPersistence.Interaction.READ], "", null);
-        return this.retrieveInternal(id);
+        return this.retrieveInternal(id, keys);
     }
     async delete(id, actor) {
         await this.auditor.audit(currentAppId(), "job", id, actor, [JobPersistence.Interaction.DELETE], "", null);
         await this.deleteInternal(id);
     }
-    async list(actor, pageSize, page) {
+    /* A page of jobs: `pageSize` of them (100 by default), page `page` (0 by
+       default), oldest first unless the query says otherwise. Every job the
+       store holds is reachable by paging - the size is a page, not a cap - and
+       a page shorter than `pageSize` is the last one. The query narrows the
+       set before paging, so page numbers count matching jobs only. */
+    async list(actor, pageSize, page, query) {
         await this.auditor.audit(currentAppId(), "job", "*", actor, [JobPersistence.Interaction.LIST], "", null);
-        return this.listInternal(pageSize, page);
+        return this.listInternal(pageSize, page, query);
     }
 }
 (function (JobPersistence) {

package/dist/api/jobs/JobPersistence.js.map

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

package/dist/api/jobs/Reads.d.ts

@@ -0,0 +1,10 @@
+import { PropertyDefinition } from "./PropertyDefinition.js";
+type Reads = (definitions: Array<PropertyDefinition>) => Array<string>;
+declare namespace Reads {
+    const everything: Reads;
+    const nothing: Reads;
+    const only: (...keys: Array<string>) => Reads;
+    const where: (predicate: (definition: PropertyDefinition) => boolean) => Reads;
+}
+export { Reads };
+//# sourceMappingURL=Reads.d.ts.map

package/dist/api/jobs/Reads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Reads.d.ts","sourceRoot":"","sources":["../../../src/api/jobs/Reads.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kBAAkB,EAAC,MAAM,yBAAyB,CAAC;AAO3D,KAAK,KAAK,GAAG,CAAC,WAAW,EAAG,KAAK,CAAC,kBAAkB,CAAC,KAAK,KAAK,CAAC,MAAM,CAAC,CAAC;AAExE,kBAAU,KAAK,CAAC;IAEL,MAAM,UAAU,EAAG,KAAmE,CAAC;IAEvF,MAAM,OAAO,EAAG,KAAgB,CAAC;IAEjC,MAAM,IAAI,YAAc,KAAK,CAAC,MAAM,CAAC,KAAI,KAAmB,CAAC;IAE7D,MAAM,KAAK,cAAgB,CAAC,UAAU,EAAG,kBAAkB,KAAK,OAAO,KAAI,KACD,CAAC;CAErF;AAED,OAAO,EAAE,KAAK,EAAE,CAAC"}

package/dist/api/jobs/Reads.js

@@ -0,0 +1,9 @@
+var Reads;
+(function (Reads) {
+    Reads.everything = definitions => definitions.map(definition => definition.id);
+    Reads.nothing = () => [];
+    Reads.only = (...keys) => () => keys;
+    Reads.where = (predicate) => definitions => definitions.filter(predicate).map(definition => definition.id);
+})(Reads || (Reads = {}));
+export { Reads };
+//# sourceMappingURL=Reads.js.map

package/dist/api/jobs/Reads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Reads.js","sourceRoot":"","sources":["../../../src/api/jobs/Reads.ts"],"names":[],"mappings":"AASA,IAAU,KAAK,CAWd;AAXD,WAAU,KAAK;IAEE,gBAAU,GAAW,WAAW,CAAC,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IAEjF,aAAO,GAAW,GAAG,EAAE,CAAC,EAAE,CAAC;IAE3B,UAAI,GAAG,CAAC,GAAG,IAAoB,EAAU,EAAE,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;IAEvD,WAAK,GAAG,CAAC,SAAwD,EAAU,EAAE,CACtF,WAAW,CAAC,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;AAEtF,CAAC,EAXS,KAAK,KAAL,KAAK,QAWd;AAED,OAAO,EAAE,KAAK,EAAE,CAAC"}

package/dist/api/transitions/Transition.d.ts

@@ -1,8 +1,10 @@
 import { Job } from "../jobs/Job.js";
+import { Reads } from "../jobs/Reads.js";
 declare class Transition {
     to: string;
     predicate: (job: Job) => boolean;
-    constructor(to: string, predicate?: (job: Job) => boolean);
+    reads: Reads;
+    constructor(to: string, predicate?: (job: Job) => boolean, reads?: Reads);
 }
 export { Transition };
 //# sourceMappingURL=Transition.d.ts.map

package/dist/api/transitions/Transition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Transition.d.ts","sourceRoot":"","sources":["../../../src/api/transitions/Transition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,GAAG,EAAC,MAAM,gBAAgB,CAAC;AAMnC,cAAM,UAAU;IAEZ,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC;IAEjC,YAAY,EAAE,EAAE,MAAM,EAAE,SAAS,GAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAoB,EAGpE;CAEJ;AAED,OAAO,EAAE,UAAU,EAAE,CAAA"}
+{"version":3,"file":"Transition.d.ts","sourceRoot":"","sources":["../../../src/api/transitions/Transition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,GAAG,EAAC,MAAM,gBAAgB,CAAC;AACnC,OAAO,EAAC,KAAK,EAAC,MAAM,kBAAkB,CAAC;AAQvC,cAAM,UAAU;IAEZ,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC;IACjC,KAAK,EAAG,KAAK,CAAC;IAEd,YAAY,EAAE,EAAE,MAAM,EAAE,SAAS,CAAC,EAAG,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,EAAE,KAAK,CAAC,EAAG,KAAK,EAIzE;CAEJ;AAED,OAAO,EAAE,UAAU,EAAE,CAAA"}

package/dist/api/transitions/Transition.js

@@ -1,13 +1,18 @@
+import { Reads } from "../jobs/Reads.js";
 /* A move to another state, taken by the first transition whose predicate holds.
    The predicate is optional: a transition with no guard always fires, which is
    what you want when a state's actions simply run and the job moves on. Guard
-   it only when the move is conditional. */
+   it only when the move is conditional. `reads` names the properties the
+   predicate looks at, everything by default; an unguarded transition reads
+   nothing. */
 class Transition {
     to;
     predicate;
-    constructor(to, predicate = () => true) {
+    reads;
+    constructor(to, predicate, reads) {
         this.to = to;
-        this.predicate = predicate;
+        this.predicate = predicate ?? (() => true);
+        this.reads = reads ?? (predicate ? Reads.everything : Reads.nothing);
     }
 }
 export { Transition };

package/dist/api/transitions/Transition.js.map

@@ -1 +1 @@
-{"version":3,"file":"Transition.js","sourceRoot":"","sources":["../../../src/api/transitions/Transition.ts"],"names":[],"mappings":"AAEA;;;2CAG2C;AAC3C,MAAM,UAAU;IAEZ,EAAE,CAAS;IACX,SAAS,CAAwB;IAEjC,YAAY,EAAU,EAAE,SAAS,GAA0B,GAAG,EAAE,CAAC,IAAI;QACjE,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC/B,CAAC;CAEJ;AAED,OAAO,EAAE,UAAU,EAAE,CAAA"}
+{"version":3,"file":"Transition.js","sourceRoot":"","sources":["../../../src/api/transitions/Transition.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,KAAK,EAAC,MAAM,kBAAkB,CAAC;AAEvC;;;;;cAKc;AACd,MAAM,UAAU;IAEZ,EAAE,CAAS;IACX,SAAS,CAAwB;IACjC,KAAK,CAAS;IAEd,YAAY,EAAU,EAAE,SAAkC,EAAE,KAAc;QACtE,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,SAAS,GAAG,SAAS,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK,GAAG,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACzE,CAAC;CAEJ;AAED,OAAO,EAAE,UAAU,EAAE,CAAA"}

package/dist/index.d.ts

@@ -2,6 +2,7 @@ export * from "./api/jobs/Job.js";
 export * from "./api/jobs/JobPersistence.js";
 export * from "./api/jobs/JobSerialization.js";
 export * from "./api/jobs/PropertyDefinition.js";
+export * from "./api/jobs/Reads.js";
 export * from "./api/states/State.js";
 export * from "./api/states/Terminal.js";
 export * from "./api/actions/Action.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,kCAAkC,CAAA;AAChD,cAAc,uBAAuB,CAAA;AACrC,cAAc,0BAA0B,CAAA;AACxC,cAAc,yBAAyB,CAAA;AACvC,cAAc,wBAAwB,CAAA;AACtC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,qCAAqC,CAAA;AACnD,cAAc,qCAAqC,CAAA;AACnD,cAAc,8BAA8B,CAAA;AAC5C,cAAc,2BAA2B,CAAA;AACzC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,iCAAiC,CAAA;AAC/C,cAAc,uBAAuB,CAAA;AACrC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,mCAAmC,CAAA;AACjD,cAAc,8BAA8B,CAAA;AAC5C,cAAc,8BAA8B,CAAA;AAC5C,cAAc,4BAA4B,CAAA;AAC1C,cAAc,oCAAoC,CAAA;AAClD,cAAc,gCAAgC,CAAA;AAC9C,cAAc,uBAAuB,CAAA;AACrC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,8BAA8B,CAAA;AAC5C,cAAc,iCAAiC,CAAA;AAC/C,cAAc,kDAAkD,CAAA;AAChE,cAAc,iCAAiC,CAAA;AAC/C,cAAc,6BAA6B,CAAA;AAC3C,cAAc,mCAAmC,CAAA;AACjD,cAAc,4BAA4B,CAAA;AAC1C,cAAc,yBAAyB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,kCAAkC,CAAA;AAChD,cAAc,qBAAqB,CAAA;AACnC,cAAc,uBAAuB,CAAA;AACrC,cAAc,0BAA0B,CAAA;AACxC,cAAc,yBAAyB,CAAA;AACvC,cAAc,wBAAwB,CAAA;AACtC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,qCAAqC,CAAA;AACnD,cAAc,qCAAqC,CAAA;AACnD,cAAc,8BAA8B,CAAA;AAC5C,cAAc,2BAA2B,CAAA;AACzC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,iCAAiC,CAAA;AAC/C,cAAc,uBAAuB,CAAA;AACrC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,mCAAmC,CAAA;AACjD,cAAc,8BAA8B,CAAA;AAC5C,cAAc,8BAA8B,CAAA;AAC5C,cAAc,4BAA4B,CAAA;AAC1C,cAAc,oCAAoC,CAAA;AAClD,cAAc,gCAAgC,CAAA;AAC9C,cAAc,uBAAuB,CAAA;AACrC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,8BAA8B,CAAA;AAC5C,cAAc,iCAAiC,CAAA;AAC/C,cAAc,kDAAkD,CAAA;AAChE,cAAc,iCAAiC,CAAA;AAC/C,cAAc,6BAA6B,CAAA;AAC3C,cAAc,mCAAmC,CAAA;AACjD,cAAc,4BAA4B,CAAA;AAC1C,cAAc,yBAAyB,CAAA"}

package/dist/index.js

@@ -2,6 +2,7 @@ export * from "./api/jobs/Job.js";
 export * from "./api/jobs/JobPersistence.js";
 export * from "./api/jobs/JobSerialization.js";
 export * from "./api/jobs/PropertyDefinition.js";
+export * from "./api/jobs/Reads.js";
 export * from "./api/states/State.js";
 export * from "./api/states/Terminal.js";
 export * from "./api/actions/Action.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,kCAAkC,CAAA;AAChD,cAAc,uBAAuB,CAAA;AACrC,cAAc,0BAA0B,CAAA;AACxC,cAAc,yBAAyB,CAAA;AACvC,cAAc,wBAAwB,CAAA;AACtC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,qCAAqC,CAAA;AACnD,cAAc,qCAAqC,CAAA;AACnD,cAAc,8BAA8B,CAAA;AAC5C,cAAc,2BAA2B,CAAA;AACzC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,iCAAiC,CAAA;AAC/C,cAAc,uBAAuB,CAAA;AACrC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,mCAAmC,CAAA;AACjD,cAAc,8BAA8B,CAAA;AAC5C,cAAc,8BAA8B,CAAA;AAC5C,cAAc,4BAA4B,CAAA;AAC1C,cAAc,oCAAoC,CAAA;AAClD,cAAc,gCAAgC,CAAA;AAC9C,cAAc,uBAAuB,CAAA;AACrC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,8BAA8B,CAAA;AAC5C,cAAc,iCAAiC,CAAA;AAC/C,cAAc,kDAAkD,CAAA;AAChE,cAAc,iCAAiC,CAAA;AAC/C,cAAc,6BAA6B,CAAA;AAC3C,cAAc,mCAAmC,CAAA;AACjD,cAAc,4BAA4B,CAAA;AAC1C,cAAc,yBAAyB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,kCAAkC,CAAA;AAChD,cAAc,qBAAqB,CAAA;AACnC,cAAc,uBAAuB,CAAA;AACrC,cAAc,0BAA0B,CAAA;AACxC,cAAc,yBAAyB,CAAA;AACvC,cAAc,wBAAwB,CAAA;AACtC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,qCAAqC,CAAA;AACnD,cAAc,qCAAqC,CAAA;AACnD,cAAc,8BAA8B,CAAA;AAC5C,cAAc,2BAA2B,CAAA;AACzC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,iCAAiC,CAAA;AAC/C,cAAc,uBAAuB,CAAA;AACrC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,mCAAmC,CAAA;AACjD,cAAc,8BAA8B,CAAA;AAC5C,cAAc,8BAA8B,CAAA;AAC5C,cAAc,4BAA4B,CAAA;AAC1C,cAAc,oCAAoC,CAAA;AAClD,cAAc,gCAAgC,CAAA;AAC9C,cAAc,uBAAuB,CAAA;AACrC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,8BAA8B,CAAA;AAC5C,cAAc,iCAAiC,CAAA;AAC/C,cAAc,kDAAkD,CAAA;AAChE,cAAc,iCAAiC,CAAA;AAC/C,cAAc,6BAA6B,CAAA;AAC3C,cAAc,mCAAmC,CAAA;AACjD,cAAc,4BAA4B,CAAA;AAC1C,cAAc,yBAAyB,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "anbaric-tsapi",
-  "version": "1.56.8",
+  "version": "1.57.0",
   "description": "These are the shared libraries - types, classes, etc - that both the public state-machine and hosting services share",
   "license": "MIT",
   "author": "chris@anbaric.ai",