@kensio/yulin 0.34.2 → 0.36.0

package/dist/service/sts/command/assume-role/assume-role.handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assume-role.handler.d.ts","sourceRoot":"","sources":["../../../../../src/service/sts/command/assume-role/assume-role.handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAC7E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mDAAmD,CAAC;AAC/F,OAAO,KAAK,EACV,oBAAoB,EACpB,0BAA0B,EAC3B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,KAAK,mBAAmB,EAEzB,MAAM,2CAA2C,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAMvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAG7E,UAAU,kCAAkC;IAC1C,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,qBAAqB,CAAC;IAC5C,QAAQ,CAAC,UAAU,CAAC,EAAE,mBAAmB,CAAC;CAC3C;AAED;;;;;;;;GAQG;AACH,qBAAa,wBAAyB,YAAW,cAAc,CAC7D,oBAAoB,EACpB,0BAA0B,CAC3B;IACC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsB;IACjD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA8B;IAC7D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAuC;IACrE,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAqC;IAC9E,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiC;IAChE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAElD,YAAY,UAAU,EAAE,kCAAkC,EAgBzD;IAED;;;;;OAKG;IACG,MAAM,CACV,OAAO,EAAE,oBAAoB,EAC7B,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,eAAe,CAAC;KAC1B,GACA,OAAO,CAAC,0BAA0B,CAAC,CAgCrC;CACF"}
+{"version":3,"file":"assume-role.handler.d.ts","sourceRoot":"","sources":["../../../../../src/service/sts/command/assume-role/assume-role.handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAC7E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mDAAmD,CAAC;AAC/F,OAAO,KAAK,EACV,oBAAoB,EACpB,0BAA0B,EAC3B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,KAAK,mBAAmB,EAEzB,MAAM,2CAA2C,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAMvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAG7E,UAAU,kCAAkC;IAC1C,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,qBAAqB,CAAC;IAC5C,QAAQ,CAAC,UAAU,CAAC,EAAE,mBAAmB,CAAC;CAC3C;AAED;;;;;;;;GAQG;AACH,qBAAa,wBAAyB,YAAW,cAAc,CAC7D,oBAAoB,EACpB,0BAA0B,CAC3B;IACC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsB;IACjD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA8B;IAC7D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAuC;IACrE,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAqC;IAC9E,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiC;IAChE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAElD,YAAY,UAAU,EAAE,kCAAkC,EAiBzD;IAED;;;;;OAKG;IACG,MAAM,CACV,OAAO,EAAE,oBAAoB,EAC7B,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,eAAe,CAAC;KAC1B,GACA,OAAO,CAAC,0BAA0B,CAAC,CAgCrC;CACF"}

package/dist/service/sts/command/assume-role/assume-role.handler.js

@@ -31,6 +31,7 @@ export class AssumeRoleCommandHandler {
         });
         this.sessionCreator = new SimStsAssumeRoleSessionCreator({
             iamResolver,
+            clock: background,
         });
     }
     /**

package/dist/service/sts/command/assume-role/assume-role.handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"assume-role.handler.js","sourceRoot":"","sources":["../../../../../src/service/sts/command/assume-role/assume-role.handler.ts"],"names":[],"mappings":"AAMA,OAAO,EAEL,eAAe,GAChB,MAAM,2CAA2C,CAAC;AAEnD,OAAO,EAAE,8BAA8B,EAAE,MAAM,uDAAuD,CAAC;AACvG,OAAO,EAAE,8BAA8B,EAAE,MAAM,qDAAqD,CAAC;AACrG,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AACnG,OAAO,EAAE,oBAAoB,EAAE,MAAM,gDAAgD,CAAC;AACtF,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAEzE,OAAO,EAAE,kCAAkC,EAAE,MAAM,gDAAgD,CAAC;AAQpG;;;;;;;;GAQG;AACH,MAAM,OAAO,wBAAwB;IAIlB,UAAU,CAAsB;IAChC,cAAc,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC5C,aAAa,GAAG,IAAI,6BAA6B,EAAE,CAAC;IACpD,wBAAwB,CAAqC;IAC7D,cAAc,CAAiC;IAC/C,eAAe,CAAkB;IAElD,YAAY,UAA8C;QACxD,MAAM,EACJ,eAAe,EACf,WAAW,EACX,UAAU,GAAG,IAAI,eAAe,EAAE,GACnC,GAAG,UAAU,CAAC;QAEf,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACvC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,wBAAwB,GAAG,IAAI,kCAAkC,CAAC;YACrE,eAAe;YACf,WAAW;SACZ,CAAC,CAAC;QACH,IAAI,CAAC,cAAc,GAAG,IAAI,8BAA8B,CAAC;YACvD,WAAW;SACZ,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,MAAM,CACV,OAA6B,EAC7B,OAEC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAClD,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,CACxC,OAAO,EAAE,MAAM,EACf,8BAA8B,CAAC,IAAI,CAAC,eAAe,CAAC,CACrD,CAAC;QAEF,oEAAoE;QACpE,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;QAEjC,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;YACpC,MAAM,IAAI,kBAAkB,CAAC;gBAC3B,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,MAAM,EAAE,gBAAgB;gBACxB,QAAQ,EAAE,OAAO,CAAC,OAAO;aAC1B,CAAC,CAAC;QACL,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,wBAAwB,CAAC,SAAS,CAAC;YACzD,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,MAAM,EAAE,MAAM,CAAC,SAAS;YACxB,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;SAC3C,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC;YAChC,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,IAAI;YACJ,eAAe,EAAE,OAAO,CAAC,eAAe;YACxC,eAAe,EAAE,MAAM,CAAC,SAAS;YACjC,eAAe,EAAE,OAAO,CAAC,eAAe;SACzC,CAAC,CAAC;IACL,CAAC;CACF"}
+{"version":3,"file":"assume-role.handler.js","sourceRoot":"","sources":["../../../../../src/service/sts/command/assume-role/assume-role.handler.ts"],"names":[],"mappings":"AAMA,OAAO,EAEL,eAAe,GAChB,MAAM,2CAA2C,CAAC;AAEnD,OAAO,EAAE,8BAA8B,EAAE,MAAM,uDAAuD,CAAC;AACvG,OAAO,EAAE,8BAA8B,EAAE,MAAM,qDAAqD,CAAC;AACrG,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AACnG,OAAO,EAAE,oBAAoB,EAAE,MAAM,gDAAgD,CAAC;AACtF,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAEzE,OAAO,EAAE,kCAAkC,EAAE,MAAM,gDAAgD,CAAC;AAQpG;;;;;;;;GAQG;AACH,MAAM,OAAO,wBAAwB;IAIlB,UAAU,CAAsB;IAChC,cAAc,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC5C,aAAa,GAAG,IAAI,6BAA6B,EAAE,CAAC;IACpD,wBAAwB,CAAqC;IAC7D,cAAc,CAAiC;IAC/C,eAAe,CAAkB;IAElD,YAAY,UAA8C;QACxD,MAAM,EACJ,eAAe,EACf,WAAW,EACX,UAAU,GAAG,IAAI,eAAe,EAAE,GACnC,GAAG,UAAU,CAAC;QAEf,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACvC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,wBAAwB,GAAG,IAAI,kCAAkC,CAAC;YACrE,eAAe;YACf,WAAW;SACZ,CAAC,CAAC;QACH,IAAI,CAAC,cAAc,GAAG,IAAI,8BAA8B,CAAC;YACvD,WAAW;YACX,KAAK,EAAE,UAAU;SAClB,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,MAAM,CACV,OAA6B,EAC7B,OAEC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAClD,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,CACxC,OAAO,EAAE,MAAM,EACf,8BAA8B,CAAC,IAAI,CAAC,eAAe,CAAC,CACrD,CAAC;QAEF,oEAAoE;QACpE,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;QAEjC,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;YACpC,MAAM,IAAI,kBAAkB,CAAC;gBAC3B,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,MAAM,EAAE,gBAAgB;gBACxB,QAAQ,EAAE,OAAO,CAAC,OAAO;aAC1B,CAAC,CAAC;QACL,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,wBAAwB,CAAC,SAAS,CAAC;YACzD,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,MAAM,EAAE,MAAM,CAAC,SAAS;YACxB,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;SAC3C,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC;YAChC,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,IAAI;YACJ,eAAe,EAAE,OAAO,CAAC,eAAe;YACxC,eAAe,EAAE,MAAM,CAAC,SAAS;YACjC,eAAe,EAAE,OAAO,CAAC,eAAe;SACzC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/service/sts/sim-sts.d.ts

@@ -1,6 +1,6 @@
 import { type BackgroundScheduler } from "../../util/background/background.js";
 import type { SimIamAccountResolver } from "../iam/registry/sim-iam-account-resolver.js";
-import type { SimAssumeRoleCommand, SimAssumeRoleCommandOutput } from "./command/assume-role/assume-role.cmd.js";
+import type { SimAssumeRoleCommand, SimAssumeRoleCommandOutput } from "./command/assume-role/assume-role.command.js";
 import type { SimAwsAccountRegionScope } from "../aws/sim-aws-account-region-scope.js";
 import type { SimAwsPrincipal } from "../aws/caller/sim-aws-caller.js";
 import type { SimSdkCommandRouter } from "../../sdk/index.js";

package/dist/service/sts/sim-sts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sim-sts.d.ts","sourceRoot":"","sources":["../../../src/service/sts/sim-sts.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,mBAAmB,EAEzB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6CAA6C,CAAC;AACzF,OAAO,KAAK,EACV,oBAAoB,EACpB,0BAA0B,EAC3B,MAAM,0CAA0C,CAAC;AAGlD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAC;AAEvF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAEvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,UAAU,gBAAgB;IACxB,QAAQ,CAAC,kBAAkB,CAAC,EAAE,wBAAwB,CAAC;IACvD,QAAQ,CAAC,WAAW,CAAC,EAAE,qBAAqB,CAAC;IAC7C,QAAQ,CAAC,UAAU,CAAC,EAAE,mBAAmB,CAAC;CAC3C;AAED;;;;;;GAMG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA2B;IAC9D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsB;IACjD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAwB;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoC;IAE9D,YAAY,UAAU,GAAE,gBAAqB,EAK5C;IAED;;OAEG;IACG,UAAU,CACd,OAAO,EAAE,oBAAoB,EAC7B,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,eAAe,CAAC;KAC1B,GACA,OAAO,CAAC,0BAA0B,CAAC,CAOrC;IAED;;OAEG;IACH,gBAAgB,IAAI,mBAAmB,CAEtC;CACF"}
+{"version":3,"file":"sim-sts.d.ts","sourceRoot":"","sources":["../../../src/service/sts/sim-sts.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,mBAAmB,EAEzB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6CAA6C,CAAC;AACzF,OAAO,KAAK,EACV,oBAAoB,EACpB,0BAA0B,EAC3B,MAAM,8CAA8C,CAAC;AAGtD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAC;AAEvF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAEvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,UAAU,gBAAgB;IACxB,QAAQ,CAAC,kBAAkB,CAAC,EAAE,wBAAwB,CAAC;IACvD,QAAQ,CAAC,WAAW,CAAC,EAAE,qBAAqB,CAAC;IAC7C,QAAQ,CAAC,UAAU,CAAC,EAAE,mBAAmB,CAAC;CAC3C;AAED;;;;;;GAMG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA2B;IAC9D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsB;IACjD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAwB;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoC;IAE9D,YAAY,UAAU,GAAE,gBAAqB,EAK5C;IAED;;OAEG;IACG,UAAU,CACd,OAAO,EAAE,oBAAoB,EAC7B,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,eAAe,CAAC;KAC1B,GACA,OAAO,CAAC,0BAA0B,CAAC,CAOrC;IAED;;OAEG;IACH,gBAAgB,IAAI,mBAAmB,CAEtC;CACF"}

package/dist/util/background/background-due-tasks.d.ts

@@ -0,0 +1,44 @@
+import type { BackgroundTask } from "./background.js";
+/**
+ * A background task waiting for simulated time to reach it.
+ */
+export declare class BackgroundDueTask {
+    readonly dueTime: Date;
+    readonly task: BackgroundTask;
+    constructor(dueTime: Date, task: BackgroundTask);
+    /**
+     * Whether simulated time reaching this instant makes this task due.
+     */
+    isDueBy(instant: Date): boolean;
+}
+/**
+ * Background work waiting on the clock rather than on the event loop.
+ *
+ * A simulator's asynchronous work divides in two. Most of it is due
+ * immediately and only needs to happen outside the current call stack, which is
+ * what the scheduler's pending set is for. The rest is due at a simulated
+ * instant, and should not happen at all until simulated time reaches it, no
+ * matter how long the host process runs. This queue holds the second kind, so
+ * advancing the clock is what releases it.
+ */
+export declare class BackgroundDueTasks {
+    private readonly queued;
+    /**
+     * Queue a task to become due at a simulated instant.
+     */
+    add(dueTime: Date, task: BackgroundTask): void;
+    /**
+     * Take the next task due at or before an instant, earliest first.
+     *
+     * Tasks due at the same instant come out in the order they were queued, so
+     * two things scheduled for the same simulated moment still happen in a
+     * predictable order.
+     */
+    takeNextDueBy(instant: Date): BackgroundDueTask | undefined;
+    /**
+     * See how many tasks are waiting for simulated time to reach them.
+     */
+    get size(): number;
+    private nextDueBy;
+}
+//# sourceMappingURL=background-due-tasks.d.ts.map

package/dist/util/background/background-due-tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-due-tasks.d.ts","sourceRoot":"","sources":["../../../src/util/background/background-due-tasks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,SAAgB,OAAO,EAAE,IAAI,CAAC;IAC9B,SAAgB,IAAI,EAAE,cAAc,CAAC;IAErC,YAAY,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,EAG9C;IAED;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,IAAI,GAAG,OAAO,CAE9B;CACF;AAED;;;;;;;;;GASG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;IAElD;;OAEG;IACH,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI,CAE7C;IAED;;;;;;OAMG;IACH,aAAa,CAAC,OAAO,EAAE,IAAI,GAAG,iBAAiB,GAAG,SAAS,CAU1D;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,OAAO,CAAC,SAAS;CAkBlB"}

package/dist/util/background/background-due-tasks.js

@@ -0,0 +1,71 @@
+/**
+ * A background task waiting for simulated time to reach it.
+ */
+export class BackgroundDueTask {
+    dueTime;
+    task;
+    constructor(dueTime, task) {
+        this.dueTime = new Date(dueTime);
+        this.task = task;
+    }
+    /**
+     * Whether simulated time reaching this instant makes this task due.
+     */
+    isDueBy(instant) {
+        return this.dueTime.getTime() <= instant.getTime();
+    }
+}
+/**
+ * Background work waiting on the clock rather than on the event loop.
+ *
+ * A simulator's asynchronous work divides in two. Most of it is due
+ * immediately and only needs to happen outside the current call stack, which is
+ * what the scheduler's pending set is for. The rest is due at a simulated
+ * instant, and should not happen at all until simulated time reaches it, no
+ * matter how long the host process runs. This queue holds the second kind, so
+ * advancing the clock is what releases it.
+ */
+export class BackgroundDueTasks {
+    queued = [];
+    /**
+     * Queue a task to become due at a simulated instant.
+     */
+    add(dueTime, task) {
+        this.queued.push(new BackgroundDueTask(dueTime, task));
+    }
+    /**
+     * Take the next task due at or before an instant, earliest first.
+     *
+     * Tasks due at the same instant come out in the order they were queued, so
+     * two things scheduled for the same simulated moment still happen in a
+     * predictable order.
+     */
+    takeNextDueBy(instant) {
+        const next = this.nextDueBy(instant);
+        if (next === undefined) {
+            return undefined;
+        }
+        this.queued.splice(this.queued.indexOf(next), 1);
+        return next;
+    }
+    /**
+     * See how many tasks are waiting for simulated time to reach them.
+     */
+    get size() {
+        return this.queued.length;
+    }
+    nextDueBy(instant) {
+        let earliest;
+        for (const queued of this.queued) {
+            if (!queued.isDueBy(instant)) {
+                continue;
+            }
+            if (earliest === undefined ||
+                queued.dueTime.getTime() < earliest.dueTime.getTime()) {
+                earliest = queued;
+            }
+        }
+        return earliest;
+    }
+}
+//# sourceMappingURL=background-due-tasks.js.map

package/dist/util/background/background-due-tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-due-tasks.js","sourceRoot":"","sources":["../../../src/util/background/background-due-tasks.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,OAAO,iBAAiB;IACZ,OAAO,CAAO;IACd,IAAI,CAAiB;IAErC,YAAY,OAAa,EAAE,IAAoB;QAC7C,IAAI,CAAC,OAAO,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,OAAa;QACnB,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IACrD,CAAC;CACF;AAED;;;;;;;;;GASG;AACH,MAAM,OAAO,kBAAkB;IACZ,MAAM,GAAwB,EAAE,CAAC;IAElD;;OAEG;IACH,GAAG,CAAC,OAAa,EAAE,IAAoB;QACrC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,iBAAiB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IACzD,CAAC;IAED;;;;;;OAMG;IACH,aAAa,CAAC,OAAa;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAErC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAEjD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC5B,CAAC;IAEO,SAAS,CAAC,OAAa;QAC7B,IAAI,QAAuC,CAAC;QAE5C,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACjC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC7B,SAAS;YACX,CAAC;YAED,IACE,QAAQ,KAAK,SAAS;gBACtB,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,EACrD,CAAC;gBACD,QAAQ,GAAG,MAAM,CAAC;YACpB,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF"}

package/dist/util/background/background-jitter.d.ts

@@ -0,0 +1,16 @@
+/**
+ * A short random pause between scheduling a task and running it.
+ *
+ * This is what makes a non-deterministic scheduler non-deterministic: real
+ * distributed operations do not finish in the order they were started, and
+ * jitter is how that gets simulated.
+ */
+export declare class BackgroundJitter {
+    private readonly maxMs;
+    constructor(maxMs?: number);
+    /**
+     * Wait for somewhere between no time at all and the maximum jitter.
+     */
+    wait(): Promise<void>;
+}
+//# sourceMappingURL=background-jitter.d.ts.map

package/dist/util/background/background-jitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-jitter.d.ts","sourceRoot":"","sources":["../../../src/util/background/background-jitter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAE/B,YAAY,KAAK,SAAI,EAEpB;IAED;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAM1B;CACF"}

package/dist/util/background/background-jitter.js

@@ -0,0 +1,23 @@
+/**
+ * A short random pause between scheduling a task and running it.
+ *
+ * This is what makes a non-deterministic scheduler non-deterministic: real
+ * distributed operations do not finish in the order they were started, and
+ * jitter is how that gets simulated.
+ */
+export class BackgroundJitter {
+    maxMs;
+    constructor(maxMs = 5) {
+        this.maxMs = maxMs;
+    }
+    /**
+     * Wait for somewhere between no time at all and the maximum jitter.
+     */
+    async wait() {
+        const milliseconds = Math.random() * this.maxMs;
+        await new Promise((resolve) => {
+            setTimeout(resolve, milliseconds);
+        });
+    }
+}
+//# sourceMappingURL=background-jitter.js.map

package/dist/util/background/background-jitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-jitter.js","sourceRoot":"","sources":["../../../src/util/background/background-jitter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,OAAO,gBAAgB;IACV,KAAK,CAAS;IAE/B,YAAY,KAAK,GAAG,CAAC;QACnB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;QAEhD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC5B,UAAU,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/util/background/background-settled-tasks.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The outcome of waiting on a batch of background tasks.
+ *
+ * Background work runs outside the call that scheduled it, so a task that
+ * throws has nowhere to report to. Waiting for tasks to settle is that
+ * moment: this is what turns a settled batch back into a thrown error, so a
+ * failure in the background surfaces to whoever waited rather than vanishing.
+ */
+export declare class BackgroundSettledTasks {
+    private readonly results;
+    constructor(results: PromiseSettledResult<void>[]);
+    /**
+     * Throw the first task failure in the batch, if there was one.
+     */
+    throwFirstFailure(): void;
+}
+//# sourceMappingURL=background-settled-tasks.d.ts.map

package/dist/util/background/background-settled-tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-settled-tasks.d.ts","sourceRoot":"","sources":["../../../src/util/background/background-settled-tasks.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+B;IAEvD,YAAY,OAAO,EAAE,oBAAoB,CAAC,IAAI,CAAC,EAAE,EAEhD;IAED;;OAEG;IACH,iBAAiB,IAAI,IAAI,CAQxB;CACF"}

package/dist/util/background/background-settled-tasks.js

@@ -0,0 +1,24 @@
+/**
+ * The outcome of waiting on a batch of background tasks.
+ *
+ * Background work runs outside the call that scheduled it, so a task that
+ * throws has nowhere to report to. Waiting for tasks to settle is that
+ * moment: this is what turns a settled batch back into a thrown error, so a
+ * failure in the background surfaces to whoever waited rather than vanishing.
+ */
+export class BackgroundSettledTasks {
+    results;
+    constructor(results) {
+        this.results = results;
+    }
+    /**
+     * Throw the first task failure in the batch, if there was one.
+     */
+    throwFirstFailure() {
+        const rejected = this.results.find((result) => result.status === "rejected");
+        if (rejected !== undefined) {
+            throw rejected.reason;
+        }
+    }
+}
+//# sourceMappingURL=background-settled-tasks.js.map

package/dist/util/background/background-settled-tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-settled-tasks.js","sourceRoot":"","sources":["../../../src/util/background/background-settled-tasks.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,OAAO,sBAAsB;IAChB,OAAO,CAA+B;IAEvD,YAAY,OAAqC;QAC/C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,iBAAiB;QACf,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAChC,CAAC,MAAM,EAAmC,EAAE,CAAC,MAAM,CAAC,MAAM,KAAK,UAAU,CAC1E,CAAC;QAEF,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,QAAQ,CAAC,MAAM,CAAC;QACxB,CAAC;IACH,CAAC;CACF"}

package/dist/util/background/background.d.ts

@@ -1,5 +1,15 @@
+import { type SimClock } from "../clock/sim-clock.js";
+import { type BackgroundDueTask } from "./background-due-tasks.js";
 export type BackgroundTask = () => Promise<void>;
-export interface BackgroundScheduler {
+/**
+ * Scheduler for a simulator's asynchronous work, and the source of its time.
+ *
+ * Timekeeping and scheduling stay separate responsibilities: a scheduler holds
+ * a SimClock and delegates to it, rather than implementing time itself. They
+ * are combined in one interface because they travel together, so anything
+ * already given a scheduler can read simulated time without extra wiring.
+ */
+export interface BackgroundScheduler extends SimClock {
     /**
      * Wait at a simulator sequencing point.
      *
@@ -9,18 +19,52 @@ export interface BackgroundScheduler {
      */
     sequence(): Promise<void>;
     schedule(task: BackgroundTask): void;
+    /**
+     * Schedule a task to happen once simulated time reaches an instant.
+     *
+     * Nothing dispatches it until the clock gets there, so scheduled work
+     * happens on the simulation's timeline rather than the host's.
+     */
+    scheduleAt(dueTime: Date, task: BackgroundTask): void;
+}
+interface BackgroundTasksProperties {
+    readonly clock?: SimClock;
 }
 export interface BackgroundCompleter {
     complete(): Promise<void>;
 }
+/**
+ * Source of background work waiting on the clock.
+ *
+ * Whatever controls simulated time pulls due work from here as it moves the
+ * clock, which is what makes advancing time dispatch what falls due during the
+ * interval rather than everything at once at the end.
+ */
+export interface BackgroundDueTaskSource {
+    /**
+     * Take the next task due at or before an instant, earliest first.
+     */
+    takeNextDueBy(instant: Date): BackgroundDueTask | undefined;
+    /**
+     * See how many tasks are waiting for simulated time to reach them.
+     */
+    readonly dueTaskCount: number;
+}
 /**
  * Deterministic async background tasks scheduler.
  *
  * Tasks still run asynchronously, outside the current call stack, but dispatch in
  * the order they were scheduled.
  */
-export declare class BackgroundTasks implements BackgroundScheduler, BackgroundCompleter {
+export declare class BackgroundTasks implements BackgroundScheduler, BackgroundCompleter, BackgroundDueTaskSource {
     private readonly pending;
+    private readonly dueTasks;
+    private readonly clock;
+    constructor(properties?: BackgroundTasksProperties);
+    /**
+     * Get the current time in this simulation.
+     */
+    now(): Date;
     /**
      * Wait at a deterministic sequencing point.
      */
@@ -29,14 +73,31 @@ export declare class BackgroundTasks implements BackgroundScheduler, BackgroundC
      * Schedule a task to happen asynchronously in the background.
      */
     schedule(task: BackgroundTask): void;
+    /**
+     * Schedule a task to happen once simulated time reaches an instant.
+     */
+    scheduleAt(dueTime: Date, task: BackgroundTask): void;
+    /**
+     * Take the next task due at or before an instant, earliest first.
+     */
+    takeNextDueBy(instant: Date): BackgroundDueTask | undefined;
     /**
      * Wait until all tasks currently scheduled have finished.
      * If tasks schedule more tasks, this will continue draining until idle.
+     *
+     * Work waiting on the clock is not waited for: it is not outstanding, it is
+     * scheduled for a simulated instant that has not arrived. Only moving the
+     * clock releases it.
      */
     complete(): Promise<void>;
     /**
      * See how many outstanding background tasks are scheduled.
      */
     get pendingTaskCount(): number;
+    /**
+     * See how many tasks are waiting for simulated time to reach them.
+     */
+    get dueTaskCount(): number;
 }
+export {};
 //# sourceMappingURL=background.d.ts.map

package/dist/util/background/background.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"background.d.ts","sourceRoot":"","sources":["../../../src/util/background/background.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;AAEjD,MAAM,WAAW,mBAAmB;IAClC;;;;;;OAMG;IACH,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1B,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;CACtC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED;;;;;GAKG;AACH,qBAAa,eACX,YAAW,mBAAmB,EAAE,mBAAmB;IAEnD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IAEpD;;OAEG;IACH,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAExB;IAED;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAqBnC;IAED;;;OAGG;IACU,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAKrC;IAED;;OAEG;IACH,IAAW,gBAAgB,IAAI,MAAM,CAEpC;CACF"}
+{"version":3,"file":"background.d.ts","sourceRoot":"","sources":["../../../src/util/background/background.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,QAAQ,EAAgB,MAAM,uBAAuB,CAAC;AACpE,OAAO,EACL,KAAK,iBAAiB,EAEvB,MAAM,2BAA2B,CAAC;AAEnC,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;AAEjD;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAoB,SAAQ,QAAQ;IACnD;;;;;;OAMG;IACH,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1B,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;IAErC;;;;;OAKG;IACH,UAAU,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;CACvD;AAED,UAAU,yBAAyB;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,IAAI,GAAG,iBAAiB,GAAG,SAAS,CAAC;IAE5D;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;GAKG;AACH,qBAAa,eACX,YAAW,mBAAmB,EAAE,mBAAmB,EAAE,uBAAuB;IAE5E,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IACpD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;IACrD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAW;IAEjC,YAAY,UAAU,GAAE,yBAA8B,EAErD;IAED;;OAEG;IACH,GAAG,IAAI,IAAI,CAEV;IAED;;OAEG;IACH,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAExB;IAED;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAqBnC;IAED;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI,CAEpD;IAED;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,IAAI,GAAG,iBAAiB,GAAG,SAAS,CAE1D;IAED;;;;;;;OAOG;IACU,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAKrC;IAED;;OAEG;IACH,IAAW,gBAAgB,IAAI,MAAM,CAEpC;IAED;;OAEG;IACH,IAAW,YAAY,IAAI,MAAM,CAEhC;CACF"}

package/dist/util/background/background.js

@@ -1,4 +1,6 @@
 /* eslint-disable unicorn/prefer-await  */
+import { SimRealClock } from "../clock/sim-clock.js";
+import { BackgroundDueTasks, } from "./background-due-tasks.js";
 /**
  * Deterministic async background tasks scheduler.
  *
@@ -7,6 +9,17 @@
  */
 export class BackgroundTasks {
     pending = new Set();
+    dueTasks = new BackgroundDueTasks();
+    clock;
+    constructor(properties = {}) {
+        this.clock = properties.clock ?? new SimRealClock();
+    }
+    /**
+     * Get the current time in this simulation.
+     */
+    now() {
+        return this.clock.now();
+    }
     /**
      * Wait at a deterministic sequencing point.
      */
@@ -33,9 +46,25 @@ export class BackgroundTasks {
         });
         this.pending.add(promise);
     }
+    /**
+     * Schedule a task to happen once simulated time reaches an instant.
+     */
+    scheduleAt(dueTime, task) {
+        this.dueTasks.add(dueTime, task);
+    }
+    /**
+     * Take the next task due at or before an instant, earliest first.
+     */
+    takeNextDueBy(instant) {
+        return this.dueTasks.takeNextDueBy(instant);
+    }
     /**
      * Wait until all tasks currently scheduled have finished.
      * If tasks schedule more tasks, this will continue draining until idle.
+     *
+     * Work waiting on the clock is not waited for: it is not outstanding, it is
+     * scheduled for a simulated instant that has not arrived. Only moving the
+     * clock releases it.
      */
     async complete() {
         while (this.pending.size > 0) {
@@ -49,5 +78,11 @@ export class BackgroundTasks {
     get pendingTaskCount() {
         return this.pending.size;
     }
+    /**
+     * See how many tasks are waiting for simulated time to reach them.
+     */
+    get dueTaskCount() {
+        return this.dueTasks.size;
+    }
 }
 //# sourceMappingURL=background.js.map

package/dist/util/background/background.js.map

@@ -1 +1 @@
-{"version":3,"file":"background.js","sourceRoot":"","sources":["../../../src/util/background/background.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAqB1C;;;;;GAKG;AACH,MAAM,OAAO,eAAe;IAGT,OAAO,GAAG,IAAI,GAAG,EAAiB,CAAC;IAEpD;;OAEG;IACH,QAAQ;QACN,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,IAAoB;QAC3B,MAAM,OAAO,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAC5C,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QACzB,CAAC,CAAC;aAEC,IAAI,CAAC,IAAI,CAAC;aACV,IAAI,CACH,GAAG,EAAE;YACH,EAAE;QACJ,CAAC,EACD,CAAC,KAAc,EAAE,EAAE;YACjB,+DAA+D;YAC/D,qBAAqB;YACrB,MAAM,KAAK,CAAC;QACd,CAAC,CACF;aACA,OAAO,CAAC,GAAG,EAAE;YACZ,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;QAEL,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,QAAQ;QACnB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YAC7B,4CAA4C;YAC5C,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAW,gBAAgB;QACzB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;CACF"}
+{"version":3,"file":"background.js","sourceRoot":"","sources":["../../../src/util/background/background.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAE1C,OAAO,EAAiB,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAEL,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AA4DnC;;;;;GAKG;AACH,MAAM,OAAO,eAAe;IAGT,OAAO,GAAG,IAAI,GAAG,EAAiB,CAAC;IACnC,QAAQ,GAAG,IAAI,kBAAkB,EAAE,CAAC;IACpC,KAAK,CAAW;IAEjC,YAAY,UAAU,GAA8B,EAAE;QACpD,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,IAAI,IAAI,YAAY,EAAE,CAAC;IACtD,CAAC;IAED;;OAEG;IACH,GAAG;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,IAAoB;QAC3B,MAAM,OAAO,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAC5C,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QACzB,CAAC,CAAC;aAEC,IAAI,CAAC,IAAI,CAAC;aACV,IAAI,CACH,GAAG,EAAE;YACH,EAAE;QACJ,CAAC,EACD,CAAC,KAAc,EAAE,EAAE;YACjB,+DAA+D;YAC/D,qBAAqB;YACrB,MAAM,KAAK,CAAC;QACd,CAAC,CACF;aACA,OAAO,CAAC,GAAG,EAAE;YACZ,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;QAEL,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,OAAa,EAAE,IAAoB;QAC5C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,OAAa;QACzB,OAAO,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;;;OAOG;IACI,KAAK,CAAC,QAAQ;QACnB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YAC7B,4CAA4C;YAC5C,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAW,gBAAgB;QACzB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,IAAW,YAAY;QACrB,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC5B,CAAC;CACF"}

package/dist/util/background/non-deterministic-background.d.ts

@@ -1,16 +1,25 @@
-import type { BackgroundCompleter, BackgroundScheduler, BackgroundTask } from "./background.js";
+import type { BackgroundCompleter, BackgroundDueTaskSource, BackgroundScheduler, BackgroundTask } from "./background.js";
+import { type SimClock } from "../clock/sim-clock.js";
+import { type BackgroundDueTask } from "./background-due-tasks.js";
 /**
  * Non-deterministic async background tasks scheduler.
  *
  * Use this when you want to simulate asynchronous distributed operations
  * potentially completing out of sequence.
  */
-export declare class NonDeterministicBackgroundTasks implements BackgroundScheduler, BackgroundCompleter {
+export declare class NonDeterministicBackgroundTasks implements BackgroundScheduler, BackgroundCompleter, BackgroundDueTaskSource {
     private readonly pending;
-    private readonly maxJitterMs;
+    private readonly dueTasks;
+    private readonly jitter;
+    private readonly clock;
     constructor(properties?: {
         maxJitterMs?: number;
+        clock?: SimClock;
     });
+    /**
+     * Get the current time in this simulation.
+     */
+    now(): Date;
     /**
      * Wait at a non-deterministic sequencing point.
      */
@@ -19,6 +28,14 @@ export declare class NonDeterministicBackgroundTasks implements BackgroundSchedu
      * Schedule a task to happen asynchronously in the background.
      */
     schedule(task: BackgroundTask): void;
+    /**
+     * Schedule a task to happen once simulated time reaches an instant.
+     */
+    scheduleAt(dueTime: Date, task: BackgroundTask): void;
+    /**
+     * Take the next task due at or before an instant, earliest first.
+     */
+    takeNextDueBy(instant: Date): BackgroundDueTask | undefined;
     /**
      * Wait until all tasks currently scheduled have finished.
      * If tasks schedule more tasks, this will continue draining until idle.
@@ -28,6 +45,9 @@ export declare class NonDeterministicBackgroundTasks implements BackgroundSchedu
      * See how many outstanding background tasks are scheduled.
      */
     get pendingTaskCount(): number;
-    private sleep;
+    /**
+     * See how many tasks are waiting for simulated time to reach them.
+     */
+    get dueTaskCount(): number;
 }
 //# sourceMappingURL=non-deterministic-background.d.ts.map

package/dist/util/background/non-deterministic-background.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"non-deterministic-background.d.ts","sourceRoot":"","sources":["../../../src/util/background/non-deterministic-background.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACf,MAAM,iBAAiB,CAAC;AAIzB;;;;;GAKG;AACH,qBAAa,+BACX,YAAW,mBAAmB,EAAE,mBAAmB;IAEnD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IACpD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IAErC,YAAY,UAAU,GAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAO,EAGpD;IAED;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAE9B;IAED;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAkBnC;IAED;;;OAGG;IACU,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAcrC;IAED;;OAEG;IACH,IAAW,gBAAgB,IAAI,MAAM,CAEpC;YAEa,KAAK;CAKpB"}
+{"version":3,"file":"non-deterministic-background.d.ts","sourceRoot":"","sources":["../../../src/util/background/non-deterministic-background.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACnB,cAAc,EACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,KAAK,QAAQ,EAAgB,MAAM,uBAAuB,CAAC;AACpE,OAAO,EACL,KAAK,iBAAiB,EAEvB,MAAM,2BAA2B,CAAC;AAMnC;;;;;GAKG;AACH,qBAAa,+BACX,YAAW,mBAAmB,EAAE,mBAAmB,EAAE,uBAAuB;IAE5E,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IACpD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;IACrD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAW;IAEjC,YAAY,UAAU,GAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,QAAQ,CAAA;KAAO,EAItE;IAED;;OAEG;IACH,GAAG,IAAI,IAAI,CAEV;IAED;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAE9B;IAED;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAkBnC;IAED;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI,CAEpD;IAED;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,IAAI,GAAG,iBAAiB,GAAG,SAAS,CAE1D;IAED;;;OAGG;IACU,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAQrC;IAED;;OAEG;IACH,IAAW,gBAAgB,IAAI,MAAM,CAEpC;IAED;;OAEG;IACH,IAAW,YAAY,IAAI,MAAM,CAEhC;CACF"}

package/dist/util/background/non-deterministic-background.js

@@ -1,3 +1,7 @@
+import { SimRealClock } from "../clock/sim-clock.js";
+import { BackgroundDueTasks, } from "./background-due-tasks.js";
+import { BackgroundJitter } from "./background-jitter.js";
+import { BackgroundSettledTasks } from "./background-settled-tasks.js";
 /* eslint-disable unicorn/prefer-await  */
 /**
  * Non-deterministic async background tasks scheduler.
@@ -7,16 +11,25 @@
  */
 export class NonDeterministicBackgroundTasks {
     pending = new Set();
-    maxJitterMs;
+    dueTasks = new BackgroundDueTasks();
+    jitter;
+    clock;
     constructor(properties = {}) {
-        const { maxJitterMs = 5 } = properties;
-        this.maxJitterMs = maxJitterMs;
+        const { maxJitterMs, clock = new SimRealClock() } = properties;
+        this.jitter = new BackgroundJitter(maxJitterMs);
+        this.clock = clock;
+    }
+    /**
+     * Get the current time in this simulation.
+     */
+    now() {
+        return this.clock.now();
     }
     /**
      * Wait at a non-deterministic sequencing point.
      */
     async sequence() {
-        await this.sleep(Math.random() * this.maxJitterMs);
+        await this.jitter.wait();
     }
     /**
      * Schedule a task to happen asynchronously in the background.
@@ -36,6 +49,18 @@ export class NonDeterministicBackgroundTasks {
         });
         this.pending.add(promise);
     }
+    /**
+     * Schedule a task to happen once simulated time reaches an instant.
+     */
+    scheduleAt(dueTime, task) {
+        this.dueTasks.add(dueTime, task);
+    }
+    /**
+     * Take the next task due at or before an instant, earliest first.
+     */
+    takeNextDueBy(instant) {
+        return this.dueTasks.takeNextDueBy(instant);
+    }
     /**
      * Wait until all tasks currently scheduled have finished.
      * If tasks schedule more tasks, this will continue draining until idle.
@@ -44,11 +69,8 @@ export class NonDeterministicBackgroundTasks {
         while (this.pending.size > 0) {
             // eslint-disable-next-line no-await-in-loop
             const results = await Promise.allSettled(this.pending);
-            // Check if any promises rejected and capture the first error
-            const firstRejected = results.find((result) => result.status === "rejected");
-            if (firstRejected !== undefined) {
-                throw firstRejected.reason;
-            }
+            // Surface a task that failed in the background to whoever waited here.
+            new BackgroundSettledTasks(results).throwFirstFailure();
         }
     }
     /**
@@ -57,10 +79,11 @@ export class NonDeterministicBackgroundTasks {
     get pendingTaskCount() {
         return this.pending.size;
     }
-    async sleep(ms = 0) {
-        await new Promise((resolve) => {
-            setTimeout(resolve, ms);
-        });
+    /**
+     * See how many tasks are waiting for simulated time to reach them.
+     */
+    get dueTaskCount() {
+        return this.dueTasks.size;
     }
 }
 //# sourceMappingURL=non-deterministic-background.js.map

package/dist/util/background/non-deterministic-background.js.map

@@ -1 +1 @@
-{"version":3,"file":"non-deterministic-background.js","sourceRoot":"","sources":["../../../src/util/background/non-deterministic-background.ts"],"names":[],"mappings":"AAMA,0CAA0C;AAE1C;;;;;GAKG;AACH,MAAM,OAAO,+BAA+B;IAGzB,OAAO,GAAG,IAAI,GAAG,EAAiB,CAAC;IACnC,WAAW,CAAS;IAErC,YAAY,UAAU,GAA6B,EAAE;QACnD,MAAM,EAAE,WAAW,GAAG,CAAC,EAAE,GAAG,UAAU,CAAC;QACvC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ;QACZ,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC;IACrD,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,IAAoB;QAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,EAAE;aAC5B,IAAI,CAAC,IAAI,CAAC;aACV,IAAI,CACH,GAAG,EAAE;YACH,EAAE;QACJ,CAAC,EACD,CAAC,KAAc,EAAE,EAAE;YACjB,+DAA+D;YAC/D,qBAAqB;YACrB,MAAM,KAAK,CAAC;QACd,CAAC,CACF;aACA,OAAO,CAAC,GAAG,EAAE;YACZ,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;QAEL,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,QAAQ;QACnB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YAC7B,4CAA4C;YAC5C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACvD,6DAA6D;YAC7D,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,CAChC,CAAC,MAAM,EAAmC,EAAE,CAC1C,MAAM,CAAC,MAAM,KAAK,UAAU,CAC/B,CAAC;YAEF,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;gBAChC,MAAM,aAAa,CAAC,MAAM,CAAC;YAC7B,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAW,gBAAgB;QACzB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;IAEO,KAAK,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC;QACxB,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC5B,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}
+{"version":3,"file":"non-deterministic-background.js","sourceRoot":"","sources":["../../../src/util/background/non-deterministic-background.ts"],"names":[],"mappings":"AAMA,OAAO,EAAiB,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAEL,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAEvE,0CAA0C;AAE1C;;;;;GAKG;AACH,MAAM,OAAO,+BAA+B;IAGzB,OAAO,GAAG,IAAI,GAAG,EAAiB,CAAC;IACnC,QAAQ,GAAG,IAAI,kBAAkB,EAAE,CAAC;IACpC,MAAM,CAAmB;IACzB,KAAK,CAAW;IAEjC,YAAY,UAAU,GAA+C,EAAE;QACrE,MAAM,EAAE,WAAW,EAAE,KAAK,GAAG,IAAI,YAAY,EAAE,EAAE,GAAG,UAAU,CAAC;QAC/D,IAAI,CAAC,MAAM,GAAG,IAAI,gBAAgB,CAAC,WAAW,CAAC,CAAC;QAChD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,GAAG;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ;QACZ,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,IAAoB;QAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,EAAE;aAC5B,IAAI,CAAC,IAAI,CAAC;aACV,IAAI,CACH,GAAG,EAAE;YACH,EAAE;QACJ,CAAC,EACD,CAAC,KAAc,EAAE,EAAE;YACjB,+DAA+D;YAC/D,qBAAqB;YACrB,MAAM,KAAK,CAAC;QACd,CAAC,CACF;aACA,OAAO,CAAC,GAAG,EAAE;YACZ,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;QAEL,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,OAAa,EAAE,IAAoB;QAC5C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,OAAa;QACzB,OAAO,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,QAAQ;QACnB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YAC7B,4CAA4C;YAC5C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAEvD,uEAAuE;YACvE,IAAI,sBAAsB,CAAC,OAAO,CAAC,CAAC,iBAAiB,EAAE,CAAC;QAC1D,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAW,gBAAgB;QACzB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,IAAW,YAAY;QACrB,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC5B,CAAC;CACF"}