@kensio/yulin 1.20.4 → 1.20.6

package/dist/util/clock/sim-clock-control.d.ts

@@ -61,6 +61,10 @@ export declare class SimClockControl implements SimClock {
      * due time rather than at the instant asked for. Simulated time got that far
      * and then something broke, and saying so is more use than claiming the whole
      * interval elapsed. Whatever was still queued stays queued.
+     *
+     * The clock freezes where it reads before any of that happens. Simulated time
+     * then moves only where this method moves it, and a task scheduling its own
+     * follow-up measures the delay from a still instant.
      */
     setTo(instant: Date): Promise<void>;
     /**
@@ -68,6 +72,10 @@ export declare class SimClockControl implements SimClock {
      *
      * Returns once the simulation has settled, so a test can advance and then
      * assert without waiting again.
+     *
+     * The duration is measured from a frozen instant. Advancing by exactly a
+     * buffering interval or a schedule period lands on the due instant every
+     * time, whatever the host clock does while the advance runs.
      */
     advanceBy(duration: SimDuration | SimDurationInput): Promise<void>;
     /**

package/dist/util/clock/sim-clock-control.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sim-clock-control.d.ts","sourceRoot":"","sources":["../../../src/util/clock/sim-clock-control.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACpB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAEvE;;;GAGG;AACH,MAAM,MAAM,yBAAyB,GAAG,mBAAmB,GACzD,mBAAmB,GACnB,uBAAuB,CAAC;AAE1B,UAAU,yBAAyB;IACjC,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAC;IACrC,QAAQ,CAAC,UAAU,EAAE,yBAAyB,CAAC;CAChD;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,eAAgB,YAAW,QAAQ;IAC9C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuB;IAC7C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA4B;IAEvD,YAAY,UAAU,EAAE,yBAAyB,EAGhD;IAED;;OAEG;IACH,GAAG,IAAI,IAAI,CAEV;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;;;;OAKG;IACH,MAAM,IAAI,IAAI,CAEb;IAED;;;;;OAKG;IACH,MAAM,IAAI,IAAI,CAEb;IAED;;;;;;;;;;OAUG;IACG,KAAK,CAAC,OAAO,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAQxC;IAED;;;;;OAKG;IACG,SAAS,CAAC,QAAQ,EAAE,WAAW,GAAG,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAIvE;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;YACW,eAAe;IAgB7B;;;OAGG;IACH,OAAO,CAAC,UAAU;CASnB"}
+{"version":3,"file":"sim-clock-control.d.ts","sourceRoot":"","sources":["../../../src/util/clock/sim-clock-control.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACpB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAEvE;;;GAGG;AACH,MAAM,MAAM,yBAAyB,GAAG,mBAAmB,GACzD,mBAAmB,GACnB,uBAAuB,CAAC;AAE1B,UAAU,yBAAyB;IACjC,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAC;IACrC,QAAQ,CAAC,UAAU,EAAE,yBAAyB,CAAC;CAChD;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,eAAgB,YAAW,QAAQ;IAC9C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuB;IAC7C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA4B;IAEvD,YAAY,UAAU,EAAE,yBAAyB,EAGhD;IAED;;OAEG;IACH,GAAG,IAAI,IAAI,CAEV;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;;;;OAKG;IACH,MAAM,IAAI,IAAI,CAEb;IAED;;;;;OAKG;IACH,MAAM,IAAI,IAAI,CAEb;IAED;;;;;;;;;;;;;;OAcG;IACG,KAAK,CAAC,OAAO,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAUxC;IAED;;;;;;;;;OASG;IACG,SAAS,CAAC,QAAQ,EAAE,WAAW,GAAG,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAMvE;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;YACW,eAAe;IAgB7B;;;OAGG;IACH,OAAO,CAAC,UAAU;CASnB"}

package/dist/util/clock/sim-clock-control.js

@@ -60,8 +60,13 @@ export class SimClockControl {
      * due time rather than at the instant asked for. Simulated time got that far
      * and then something broke, and saying so is more use than claiming the whole
      * interval elapsed. Whatever was still queued stays queued.
+     *
+     * The clock freezes where it reads before any of that happens. Simulated time
+     * then moves only where this method moves it, and a task scheduling its own
+     * follow-up measures the delay from a still instant.
      */
     async setTo(instant) {
+        this.clock.freeze();
         if (instant.getTime() >= this.now().getTime()) {
             await this.runDueTasksUpTo(instant);
         }
@@ -73,8 +78,13 @@ export class SimClockControl {
      *
      * Returns once the simulation has settled, so a test can advance and then
      * assert without waiting again.
+     *
+     * The duration is measured from a frozen instant. Advancing by exactly a
+     * buffering interval or a schedule period lands on the due instant every
+     * time, whatever the host clock does while the advance runs.
      */
     async advanceBy(duration) {
+        this.clock.freeze();
         const milliseconds = SimDuration.of(duration).toMilliseconds();
         await this.setTo(new Date(this.now().getTime() + milliseconds));
     }

package/dist/util/clock/sim-clock-control.js.map

@@ -1 +1 @@
-{"version":3,"file":"sim-clock-control.js","sourceRoot":"","sources":["../../../src/util/clock/sim-clock-control.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,WAAW,EAAyB,MAAM,mBAAmB,CAAC;AAevE;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,eAAe;IACT,KAAK,CAAuB;IAC5B,UAAU,CAA4B;IAEvD,YAAY,UAAqC;QAC/C,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC;QAC9B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,UAAU,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,GAAG;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;IAC7B,CAAC;IAED;;;;;OAKG;IACH,MAAM;QACJ,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;IACtB,CAAC;IAED;;;;;OAKG;IACH,MAAM;QACJ,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;IACtB,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,KAAK,CAAC,OAAa;QACvB,IAAI,OAAO,CAAC,OAAO,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC;YAC9C,MAAM,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QACtC,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAE1B,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;IACnC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,SAAS,CAAC,QAAwC;QACtD,MAAM,YAAY,GAAG,WAAW,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,cAAc,EAAE,CAAC;QAE/D,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,GAAG,YAAY,CAAC,CAAC,CAAC;IAClE,CAAC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACK,KAAK,CAAC,eAAe,CAAC,OAAa;QACzC,IAAI,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAEjD,OAAO,GAAG,KAAK,SAAS,EAAE,CAAC;YACzB,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;YAE/C,4CAA4C;YAC5C,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;YAEjB,4CAA4C;YAC5C,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;YAEjC,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,UAAU,CAAC,OAAa;QAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,IAAI,OAAO,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;YACtC,OAAO,GAAG,CAAC;QACb,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}
+{"version":3,"file":"sim-clock-control.js","sourceRoot":"","sources":["../../../src/util/clock/sim-clock-control.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,WAAW,EAAyB,MAAM,mBAAmB,CAAC;AAevE;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,eAAe;IACT,KAAK,CAAuB;IAC5B,UAAU,CAA4B;IAEvD,YAAY,UAAqC;QAC/C,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC;QAC9B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,UAAU,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,GAAG;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;IAC7B,CAAC;IAED;;;;;OAKG;IACH,MAAM;QACJ,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;IACtB,CAAC;IAED;;;;;OAKG;IACH,MAAM;QACJ,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;IACtB,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,KAAK,CAAC,OAAa;QACvB,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAEpB,IAAI,OAAO,CAAC,OAAO,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC;YAC9C,MAAM,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QACtC,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAE1B,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;IACnC,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,SAAS,CAAC,QAAwC;QACtD,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAEpB,MAAM,YAAY,GAAG,WAAW,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,cAAc,EAAE,CAAC;QAE/D,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,GAAG,YAAY,CAAC,CAAC,CAAC;IAClE,CAAC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACK,KAAK,CAAC,eAAe,CAAC,OAAa;QACzC,IAAI,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAEjD,OAAO,GAAG,KAAK,SAAS,EAAE,CAAC;YACzB,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;YAE/C,4CAA4C;YAC5C,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;YAEjB,4CAA4C;YAC5C,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;YAEjC,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,UAAU,CAAC,OAAa;QAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,IAAI,OAAO,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;YACtC,OAAO,GAAG,CAAC;QACb,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kensio/yulin",
-  "version": "1.20.4",
+  "version": "1.20.6",
   "description": "AWS system behaviour simulation for isolated unit testing",
   "repository": "https://github.com/KensioSoftware/yulin",
   "homepage": "https://yulinsim.dev/",