@serenity-js/core 3.41.2 → 3.42.0

package/esm/screenplay/time/index.js

@@ -0,0 +1,5 @@
+export * from './abilities/index.js';
+export * from './activities/index.js';
+export * from './models/index.js';
+export * from './TellsTime.js';
+//# sourceMappingURL=index.js.map

package/esm/screenplay/time/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/screenplay/time/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC"}

package/esm/screenplay/time/models/Clock.d.ts

@@ -0,0 +1,50 @@
+import { type JSONObject } from 'tiny-types';
+import { Duration } from './Duration.js';
+import { Timestamp } from './Timestamp.js';
+/**
+ * A [`Clock`](https://serenity-js.org/api/core/class/Clock/) tells the time. This abstraction allows Serenity/JS to have a single place
+ * in the framework responsible for telling the time, and one that can be easily mocked for internal testing.
+ *
+ * ```ts
+ * const now: Timestamp = new Clock().now()
+ * ```
+ *
+ * ## Learn more
+ * - [`Timestamp`](https://serenity-js.org/api/core/class/Timestamp/)
+ * - [`Duration`](https://serenity-js.org/api/core/class/Duration/)
+ *
+ * @group Time
+ */
+export declare class Clock {
+    private readonly checkTime;
+    private static resolution;
+    private timeAdjustment;
+    constructor(checkTime?: () => Date);
+    toJSON(): JSONObject;
+    /**
+     * Sets the clock ahead to force early resolution of promises
+     * returned by [`Clock.waitFor`](https://serenity-js.org/api/core/class/Clock/#waitFor).
+     *
+     * Useful for test purposes to avoid unnecessary delays.
+     *
+     * @param duration
+     */
+    setAhead(duration: Duration): void;
+    /**
+     * Returns a Promise that resolves after one tick of the clock.
+     *
+     * Useful for test purposes to avoid unnecessary delays.
+     */
+    tick(): Promise<void>;
+    /**
+     * Returns current time
+     */
+    now(): Timestamp;
+    /**
+     * Returns a Promise that will be resolved after the given duration
+     *
+     * @param duration
+     */
+    waitFor(duration: Duration): Promise<void>;
+}
+//# sourceMappingURL=Clock.d.ts.map

package/esm/screenplay/time/models/Clock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Clock.d.ts","sourceRoot":"","sources":["../../../../src/screenplay/time/models/Clock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAEhE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;;;;;;;;;;;;GAaG;AACH,qBAAa,KAAK;IAIF,OAAO,CAAC,QAAQ,CAAC,SAAS;IAHtC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAyC;IAClE,OAAO,CAAC,cAAc,CAAwC;gBAEjC,SAAS,GAAE,MAAM,IAAuB;IAGrE,MAAM,IAAI,UAAU;IAMpB;;;;;;;OAOG;IACH,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAIlC;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B;;OAEG;IACH,GAAG,IAAI,SAAS;IAIhB;;;;OAIG;IACG,OAAO,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CAcnD"}

package/esm/screenplay/time/models/Clock.js

@@ -0,0 +1,73 @@
+import { ensure, isDefined } from 'tiny-types';
+import { Duration } from './Duration.js';
+import { Timestamp } from './Timestamp.js';
+/**
+ * A [`Clock`](https://serenity-js.org/api/core/class/Clock/) tells the time. This abstraction allows Serenity/JS to have a single place
+ * in the framework responsible for telling the time, and one that can be easily mocked for internal testing.
+ *
+ * ```ts
+ * const now: Timestamp = new Clock().now()
+ * ```
+ *
+ * ## Learn more
+ * - [`Timestamp`](https://serenity-js.org/api/core/class/Timestamp/)
+ * - [`Duration`](https://serenity-js.org/api/core/class/Duration/)
+ *
+ * @group Time
+ */
+export class Clock {
+    checkTime;
+    static resolution = Duration.ofMilliseconds(10);
+    timeAdjustment = Duration.ofMilliseconds(0);
+    constructor(checkTime = () => new Date()) {
+        this.checkTime = checkTime;
+    }
+    toJSON() {
+        return {
+            timeAdjustment: this.timeAdjustment.toJSON(),
+        };
+    }
+    /**
+     * Sets the clock ahead to force early resolution of promises
+     * returned by [`Clock.waitFor`](https://serenity-js.org/api/core/class/Clock/#waitFor).
+     *
+     * Useful for test purposes to avoid unnecessary delays.
+     *
+     * @param duration
+     */
+    setAhead(duration) {
+        this.timeAdjustment = ensure('duration', duration, isDefined());
+    }
+    /**
+     * Returns a Promise that resolves after one tick of the clock.
+     *
+     * Useful for test purposes to avoid unnecessary delays.
+     */
+    async tick() {
+        return new Promise(resolve => setTimeout(resolve, Clock.resolution.inMilliseconds()));
+    }
+    /**
+     * Returns current time
+     */
+    now() {
+        return new Timestamp(this.checkTime()).plus(this.timeAdjustment);
+    }
+    /**
+     * Returns a Promise that will be resolved after the given duration
+     *
+     * @param duration
+     */
+    async waitFor(duration) {
+        const stopAt = this.now().plus(duration);
+        let timer;
+        return new Promise(resolve => {
+            timer = setInterval(() => {
+                if (this.now().isAfterOrEqual(stopAt)) {
+                    clearInterval(timer);
+                    return resolve();
+                }
+            }, Clock.resolution.inMilliseconds());
+        });
+    }
+}
+//# sourceMappingURL=Clock.js.map

package/esm/screenplay/time/models/Clock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Clock.js","sourceRoot":"","sources":["../../../../src/screenplay/time/models/Clock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,SAAS,EAAmB,MAAM,YAAY,CAAC;AAEhE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,KAAK;IAIe;IAHrB,MAAM,CAAC,UAAU,GAAa,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;IAC1D,cAAc,GAAa,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IAE9D,YAA6B,YAAwB,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE;QAAxC,cAAS,GAAT,SAAS,CAA+B;IACrE,CAAC;IAED,MAAM;QACF,OAAO;YACH,cAAc,EAAE,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE;SAC/C,CAAC;IACN,CAAC;IAED;;;;;;;OAOG;IACH,QAAQ,CAAC,QAAkB;QACvB,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;IACpE,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,IAAI;QACN,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,UAAU,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC;IAC1F,CAAC;IAED;;OAEG;IACH,GAAG;QACC,OAAO,IAAI,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACrE,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,QAAkB;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAEzC,IAAI,KAAqB,CAAC;QAE1B,OAAO,IAAI,OAAO,CAAO,OAAO,CAAC,EAAE;YAC/B,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;gBACrB,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;oBACpC,aAAa,CAAC,KAAK,CAAC,CAAC;oBACrB,OAAO,OAAO,EAAE,CAAC;gBACrB,CAAC;YACL,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC,cAAc,EAAE,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;IACP,CAAC"}

package/esm/screenplay/time/models/DelayedCallback.d.ts

@@ -0,0 +1,11 @@
+import type { Timestamp } from './Timestamp.js';
+/**
+ * @group Time
+ */
+export interface DelayedCallback<Result> {
+    (stats: {
+        currentTime: Timestamp;
+        i: number;
+    }): Promise<Result> | Result;
+}
+//# sourceMappingURL=DelayedCallback.d.ts.map

package/esm/screenplay/time/models/DelayedCallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DelayedCallback.d.ts","sourceRoot":"","sources":["../../../../src/screenplay/time/models/DelayedCallback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,MAAM;IACnC,CAAC,KAAK,EAAE;QAAE,WAAW,EAAE,SAAS,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;CAC5E"}

package/esm/screenplay/time/models/DelayedCallback.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=DelayedCallback.js.map

package/esm/screenplay/time/models/DelayedCallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DelayedCallback.js","sourceRoot":"","sources":["../../../../src/screenplay/time/models/DelayedCallback.ts"],"names":[],"mappings":""}

package/esm/screenplay/time/models/Duration.d.ts

@@ -0,0 +1,34 @@
+import type { JSONObject } from 'tiny-types';
+import { TinyType } from 'tiny-types';
+/**
+ * Represents a duration in milliseconds between two [timestamps](https://serenity-js.org/api/core/class/Timestamp/).
+ *
+ * @group Time
+ */
+export declare class Duration extends TinyType {
+    private readonly milliseconds;
+    private static msPerSecond;
+    private static msPerMinute;
+    private static msPerHour;
+    private static msPerDay;
+    private static msPerYear;
+    static ofMilliseconds: (milliseconds: number) => Duration;
+    static ofSeconds: (seconds: number) => Duration;
+    static ofMinutes: (minutes: number) => Duration;
+    static ofHours: (hours: number) => Duration;
+    static ofDays: (days: number) => Duration;
+    static ofYears: (years: number) => Duration;
+    static fromJSON({ milliseconds }: {
+        milliseconds: number;
+    }): Duration;
+    constructor(milliseconds: number);
+    isLessThan(another: Duration): boolean;
+    isLessThanOrEqualTo(another: Duration): boolean;
+    isGreaterThan(another: Duration): boolean;
+    isGreaterThanOrEqualTo(another: Duration): boolean;
+    plus(another: Duration): Duration;
+    inMilliseconds(): number;
+    toString(): string;
+    toJSON(): JSONObject;
+}
+//# sourceMappingURL=Duration.d.ts.map

package/esm/screenplay/time/models/Duration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Duration.d.ts","sourceRoot":"","sources":["../../../../src/screenplay/time/models/Duration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAC,MAAM,YAAY,CAAC;AAC5C,OAAO,EAA6C,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEjF;;;;GAIG;AACH,qBAAa,QAAS,SAAQ,QAAQ;IAmBtB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAjBzC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAQ;IAClC,OAAO,CAAC,MAAM,CAAC,WAAW,CAA6B;IACvD,OAAO,CAAC,MAAM,CAAC,SAAS,CAA+B;IACvD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA8B;IACrD,OAAO,CAAC,MAAM,CAAC,SAAS,CAA6B;IAErD,MAAM,CAAC,cAAc,GAAM,cAAc,MAAM,KAAG,QAAQ,CAA+B;IACzF,MAAM,CAAC,SAAS,GAAW,SAAS,MAAM,KAAG,QAAQ,CAAkE;IACvH,MAAM,CAAC,SAAS,GAAW,SAAS,MAAM,KAAG,QAAQ,CAAkE;IACvH,MAAM,CAAC,OAAO,GAAa,OAAO,MAAM,KAAG,QAAQ,CAAkE;IACrH,MAAM,CAAC,MAAM,GAAc,MAAM,MAAM,KAAG,QAAQ,CAAkE;IACpH,MAAM,CAAC,OAAO,GAAa,OAAO,MAAM,KAAG,QAAQ,CAAkE;IAErH,MAAM,CAAC,QAAQ,CAAC,EAAE,YAAY,EAAE,EAAE;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,GAAG,QAAQ;gBAIxC,YAAY,EAAE,MAAM;IAKjD,UAAU,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO;IAItC,mBAAmB,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO;IAI/C,aAAa,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO;IAIzC,sBAAsB,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO;IAIlD,IAAI,CAAC,OAAO,EAAE,QAAQ,GAAG,QAAQ;IAIjC,cAAc,IAAI,MAAM;IAIxB,QAAQ,IAAI,MAAM;IAkBlB,MAAM,IAAI,UAAU;CAKvB"}

package/esm/screenplay/time/models/Duration.js

@@ -0,0 +1,66 @@
+import { ensure, isGreaterThanOrEqualTo, isInteger, TinyType } from 'tiny-types';
+/**
+ * Represents a duration in milliseconds between two [timestamps](https://serenity-js.org/api/core/class/Timestamp/).
+ *
+ * @group Time
+ */
+export class Duration extends TinyType {
+    milliseconds;
+    static msPerSecond = 1000;
+    static msPerMinute = Duration.msPerSecond * 60;
+    static msPerHour = Duration.msPerMinute * 60;
+    static msPerDay = Duration.msPerHour * 24;
+    static msPerYear = Duration.msPerDay * 365;
+    static ofMilliseconds = (milliseconds) => new Duration(milliseconds);
+    static ofSeconds = (seconds) => Duration.ofMilliseconds(seconds * Duration.msPerSecond);
+    static ofMinutes = (minutes) => Duration.ofMilliseconds(minutes * Duration.msPerMinute);
+    static ofHours = (hours) => Duration.ofMilliseconds(hours * Duration.msPerHour);
+    static ofDays = (days) => Duration.ofMilliseconds(days * Duration.msPerDay);
+    static ofYears = (years) => Duration.ofMilliseconds(years * Duration.msPerYear);
+    static fromJSON({ milliseconds }) {
+        return Duration.ofMilliseconds(milliseconds);
+    }
+    constructor(milliseconds) {
+        super();
+        this.milliseconds = milliseconds;
+        ensure('duration', milliseconds, isInteger(), isGreaterThanOrEqualTo(0));
+    }
+    isLessThan(another) {
+        return this.milliseconds < another.milliseconds;
+    }
+    isLessThanOrEqualTo(another) {
+        return this.milliseconds <= another.milliseconds;
+    }
+    isGreaterThan(another) {
+        return this.milliseconds > another.milliseconds;
+    }
+    isGreaterThanOrEqualTo(another) {
+        return this.milliseconds >= another.milliseconds;
+    }
+    plus(another) {
+        return new Duration(this.milliseconds + another.milliseconds);
+    }
+    inMilliseconds() {
+        return this.milliseconds;
+    }
+    toString() {
+        const ms = this.milliseconds;
+        const levels = [
+            [Math.floor(ms / Duration.msPerYear), 'y'],
+            [Math.floor((ms % Duration.msPerYear) / Duration.msPerDay), 'd'],
+            [Math.floor(((ms % Duration.msPerYear) % Duration.msPerDay) / Duration.msPerHour), 'h'],
+            [Math.floor((((ms % Duration.msPerYear) % Duration.msPerDay) % Duration.msPerHour) / Duration.msPerMinute), 'm'],
+            [Math.floor((((ms % Duration.msPerYear) % Duration.msPerDay) % Duration.msPerHour) % Duration.msPerMinute / Duration.msPerSecond), 's'],
+            [(((ms % Duration.msPerYear) % Duration.msPerDay) % Duration.msPerHour) % Duration.msPerMinute % Duration.msPerSecond, 'ms'],
+        ];
+        return levels.reduce((acc, l, i) => l[0] > 0 || i === levels.length
+            ? `${acc} ${l[0]}${l[1]}`
+            : acc, '').trim() || '0ms';
+    }
+    toJSON() {
+        return {
+            milliseconds: this.milliseconds,
+        };
+    }
+}
+//# sourceMappingURL=Duration.js.map

package/esm/screenplay/time/models/Duration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Duration.js","sourceRoot":"","sources":["../../../../src/screenplay/time/models/Duration.ts"],"names":[],"mappings":"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"}

package/esm/screenplay/time/models/RepeatUntilLimits.d.ts

@@ -0,0 +1,12 @@
+import type { Duration } from './Duration.js';
+/**
+ * @group Time
+ */
+export interface RepeatUntilLimits<Result> {
+    exitCondition?: (result: Result) => boolean;
+    maxInvocations?: number;
+    delayBetweenInvocations?: (i: number) => Duration;
+    timeout?: Duration;
+    errorHandler?: (error: Error, result?: Result) => void;
+}
+//# sourceMappingURL=RepeatUntilLimits.d.ts.map

package/esm/screenplay/time/models/RepeatUntilLimits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RepeatUntilLimits.d.ts","sourceRoot":"","sources":["../../../../src/screenplay/time/models/RepeatUntilLimits.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,MAAM;IACrC,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAC5C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uBAAuB,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,QAAQ,CAAC;IAClD,OAAO,CAAC,EAAE,QAAQ,CAAA;IAClB,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1D"}

package/esm/screenplay/time/models/RepeatUntilLimits.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=RepeatUntilLimits.js.map

package/esm/screenplay/time/models/RepeatUntilLimits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RepeatUntilLimits.js","sourceRoot":"","sources":["../../../../src/screenplay/time/models/RepeatUntilLimits.ts"],"names":[],"mappings":""}

package/esm/screenplay/time/models/Scheduler.d.ts

@@ -0,0 +1,42 @@
+import type { JSONObject } from 'tiny-types';
+import type { Clock } from './Clock.js';
+import type { DelayedCallback } from './DelayedCallback.js';
+import { Duration } from './Duration.js';
+import type { RepeatUntilLimits } from './RepeatUntilLimits.js';
+/**
+ * @group Time
+ */
+export declare class Scheduler {
+    private readonly clock;
+    private readonly interactionTimeout;
+    private scheduledOperations;
+    /**
+     * @param clock
+     * @param interactionTimeout
+     *  The maximum amount of time to give to a callback to complete before throwing an error
+     */
+    constructor(clock: Clock, interactionTimeout: Duration);
+    toJSON(): JSONObject;
+    /**
+     * Schedules a callback function to be invoked after a delay
+     *
+     * @param delay
+     * @param callback
+     */
+    after<Result>(delay: Duration, callback: DelayedCallback<Result>): Promise<Result>;
+    /**
+     * Returns a `Promise` to be resolved after a `delay`
+     *
+     * @param delay
+     */
+    waitFor(delay: Duration): Promise<void>;
+    /**
+     * Schedules a callback function to be repeated, according to configured limits.
+     *
+     * @param callback
+     * @param limits
+     */
+    repeatUntil<Result>(callback: DelayedCallback<Result>, limits?: RepeatUntilLimits<Result>): Promise<Result>;
+    stop(): void;
+}
+//# sourceMappingURL=Scheduler.d.ts.map

package/esm/screenplay/time/models/Scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Scheduler.d.ts","sourceRoot":"","sources":["../../../../src/screenplay/time/models/Scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG7C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAGhE;;GAEG;AACH,qBAAa,SAAS;IAUd,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IATvC,OAAO,CAAC,mBAAmB,CAA0C;IAErE;;;;OAIG;gBAEkB,KAAK,EAAE,KAAK,EACZ,kBAAkB,EAAE,QAAQ;IAIjD,MAAM,IAAI,UAAU;IAOpB;;;;;OAKG;IACH,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAWlF;;;;OAIG;IACH,OAAO,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAavC;;;;;OAKG;IACG,WAAW,CAAC,MAAM,EACpB,QAAQ,EAAE,eAAe,CAAC,MAAM,CAAC,EACjC,MAAM,GAAE,iBAAiB,CAAC,MAAM,CAAM,GACvC,OAAO,CAAC,MAAM,CAAC;IA0BlB,IAAI,IAAI,IAAI;CAKf"}

package/esm/screenplay/time/models/Scheduler.js

@@ -0,0 +1,150 @@
+import { OperationInterruptedError, TimeoutExpiredError } from '../../../errors/index.js';
+import { Duration } from './Duration.js';
+/**
+ * @group Time
+ */
+export class Scheduler {
+    clock;
+    interactionTimeout;
+    scheduledOperations = [];
+    /**
+     * @param clock
+     * @param interactionTimeout
+     *  The maximum amount of time to give to a callback to complete before throwing an error
+     */
+    constructor(clock, interactionTimeout) {
+        this.clock = clock;
+        this.interactionTimeout = interactionTimeout;
+    }
+    toJSON() {
+        return {
+            clock: this.clock.toJSON(),
+            interactionTimeout: this.interactionTimeout.toJSON(),
+        };
+    }
+    /**
+     * Schedules a callback function to be invoked after a delay
+     *
+     * @param delay
+     * @param callback
+     */
+    after(delay, callback) {
+        return this.repeatUntil(callback, {
+            maxInvocations: 1,
+            delayBetweenInvocations: () => delay,
+            timeout: this.interactionTimeout.plus(delay),
+        });
+    }
+    /**
+     * Returns a `Promise` to be resolved after a `delay`
+     *
+     * @param delay
+     */
+    waitFor(delay) {
+        return this.repeatUntil(() => void 0, {
+            maxInvocations: 1,
+            delayBetweenInvocations: () => delay,
+            // make sure waitFor doesn't get terminated before it's resolved
+            timeout: this.interactionTimeout.plus(delay),
+        });
+    }
+    /**
+     * Schedules a callback function to be repeated, according to configured limits.
+     *
+     * @param callback
+     * @param limits
+     */
+    async repeatUntil(callback, limits = {}) {
+        const { maxInvocations = Number.POSITIVE_INFINITY, delayBetweenInvocations = noDelay, timeout = this.interactionTimeout, exitCondition = noEarlyExit, errorHandler = rethrowErrors, } = limits;
+        const operation = new ScheduledOperation(this.clock, callback, {
+            exitCondition,
+            maxInvocations,
+            delayBetweenInvocations,
+            timeout,
+            errorHandler,
+        });
+        this.scheduledOperations.push(operation);
+        return operation.start();
+    }
+    stop() {
+        for (const operation of this.scheduledOperations) {
+            operation.cancel();
+        }
+    }
+}
+class ScheduledOperation {
+    clock;
+    callback;
+    limits;
+    currentInvocation = 0;
+    invocationsLeft = 0;
+    startedAt;
+    lastResult;
+    isCancelled = false;
+    constructor(clock, callback, limits = {}) {
+        this.clock = clock;
+        this.callback = callback;
+        this.limits = limits;
+    }
+    async start() {
+        this.currentInvocation = 0;
+        this.invocationsLeft = this.limits.maxInvocations;
+        this.startedAt = this.clock.now();
+        return await this.poll();
+    }
+    async poll() {
+        await this.clock.waitFor(this.limits.delayBetweenInvocations(this.currentInvocation));
+        if (this.isCancelled) {
+            throw new OperationInterruptedError('Scheduler stopped before executing callback');
+        }
+        const receipt = await this.invoke();
+        if (receipt.hasCompleted) {
+            return receipt.result;
+        }
+        this.currentInvocation++;
+        this.invocationsLeft--;
+        return await this.poll();
+    }
+    async invoke() {
+        const timeoutExpired = this.startedAt.plus(this.limits.timeout).isBefore(this.clock.now());
+        const isLastInvocation = this.invocationsLeft === 1;
+        if (this.invocationsLeft === 0) {
+            return {
+                result: this.lastResult,
+                hasCompleted: true,
+            };
+        }
+        try {
+            if (timeoutExpired) {
+                throw new TimeoutExpiredError(`Timeout of ${this.limits.timeout} has expired`);
+            }
+            this.lastResult = await this.callback({ currentTime: this.clock.now(), i: this.currentInvocation });
+            return {
+                result: this.lastResult,
+                hasCompleted: this.limits.exitCondition(this.lastResult) || isLastInvocation,
+            };
+        }
+        catch (error) {
+            this.limits.errorHandler(error, this.lastResult);
+            // if the errorHandler didn't throw, it's a recoverable error
+            return {
+                result: this.lastResult,
+                error,
+                hasCompleted: isLastInvocation,
+            };
+        }
+    }
+    cancel() {
+        this.isCancelled = true;
+    }
+}
+function noDelay() {
+    return Duration.ofMilliseconds(0);
+}
+function noEarlyExit() {
+    return false;
+}
+function rethrowErrors(error) {
+    throw error;
+}
+//# sourceMappingURL=Scheduler.js.map

package/esm/screenplay/time/models/Scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Scheduler.js","sourceRoot":"","sources":["../../../../src/screenplay/time/models/Scheduler.ts"],"names":[],"mappings":"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"}

package/esm/screenplay/time/models/Timestamp.d.ts

@@ -0,0 +1,36 @@
+import { inspect } from 'node:util';
+import { TinyType } from 'tiny-types';
+import { Duration } from './Duration.js';
+/**
+ * Represents a point in time.
+ *
+ * `Timestamp` makes it easier for you to work with information related to time, like [Serenity/JS domain events](https://serenity-js.org/api/core-events/class/DomainEvent/).
+ *
+ * ## Learn more
+ * - [`Duration`](https://serenity-js.org/api/core/class/Duration/)
+ * - [Date](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date)
+ *
+ * @group Time
+ */
+export declare class Timestamp extends TinyType {
+    readonly value: Date;
+    static fromJSON(v: string): Timestamp;
+    static fromTimestampInSeconds(value: number): Timestamp;
+    static fromTimestampInMilliseconds(value: number): Timestamp;
+    static now(): Timestamp;
+    constructor(value?: Date);
+    diff(another: Timestamp): Duration;
+    plus(duration: Duration): Timestamp;
+    less(duration: Duration): Timestamp;
+    isBefore(another: Timestamp): boolean;
+    isBeforeOrEqual(another: Timestamp): boolean;
+    isAfter(another: Timestamp): boolean;
+    isAfterOrEqual(another: Timestamp): boolean;
+    toMilliseconds(): number;
+    toSeconds(): number;
+    toJSON(): string;
+    toISOString(): string;
+    toString(): string;
+    [inspect.custom](): string;
+}
+//# sourceMappingURL=Timestamp.d.ts.map

package/esm/screenplay/time/models/Timestamp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Timestamp.d.ts","sourceRoot":"","sources":["../../../../src/screenplay/time/models/Timestamp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAA8C,QAAQ,EAAE,MAAM,YAAY,CAAC;AAElF,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;;;;;;;;;GAUG;AACH,qBAAa,SAAU,SAAQ,QAAQ;aAiBP,KAAK,EAAE,IAAI;IAhBvC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS;IAIrC,MAAM,CAAC,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS;IAIvD,MAAM,CAAC,2BAA2B,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS;IAI5D,MAAM,CAAC,GAAG,IAAI,SAAS;gBAIK,KAAK,GAAE,IAAiB;IAKpD,IAAI,CAAC,OAAO,EAAE,SAAS,GAAG,QAAQ;IAKlC,IAAI,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS;IAKnC,IAAI,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS;IAKnC,QAAQ,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO;IAKrC,eAAe,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO;IAK5C,OAAO,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO;IAKpC,cAAc,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO;IAK3C,cAAc,IAAI,MAAM;IAIxB,SAAS,IAAI,MAAM;IAInB,MAAM,IAAI,MAAM;IAIhB,WAAW,IAAI,MAAM;IAIrB,QAAQ,IAAI,MAAM;IAIlB,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM;CAG7B"}