@kensio/yulin 1.11.0 → 1.12.0

package/dist/util/schedule/cron/sim-cron-field-bounds.d.ts

@@ -0,0 +1,14 @@
+import type { SimCronFieldSpec } from "./sim-cron-field-spec.js";
+/**
+ * Read how far apart the values of a stepped part are.
+ */
+export declare function stepOf(spec: SimCronFieldSpec, written: string): number;
+/**
+ * The start and end of one comma separated part, before its step is applied.
+ *
+ * A bare number with a step behind it starts there and runs to the end of the
+ * field, which is what makes minutes `0/15` every quarter hour rather than only
+ * the hour itself.
+ */
+export declare function boundsOf(spec: SimCronFieldSpec, written: string, stepped: boolean): readonly [number, number];
+//# sourceMappingURL=sim-cron-field-bounds.d.ts.map

package/dist/util/schedule/cron/sim-cron-field-bounds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cron-field-bounds.d.ts","sourceRoot":"","sources":["../../../../src/util/schedule/cron/sim-cron-field-bounds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AA8CjE;;GAEG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAUtE;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,GACf,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAiB3B"}

package/dist/util/schedule/cron/sim-cron-field-bounds.js

@@ -0,0 +1,63 @@
+import { cronBadStep, cronOutOfRange, cronUnexpectedStep, cronUnreadable, cronUnsimulatedWildcard, } from "./sim-cron-refusals.js";
+/**
+ * A token using one of the wildcards this simulation reads no meaning from:
+ * `L` for the last day, `W` for the nearest weekday, and `#` for the nth
+ * weekday of a month.
+ */
+const unsimulatedWildcard = /^\d*[LW]$|#/u;
+const wholeNumber = /^\d+$/u;
+/**
+ * Read one number of a field, by name where the field has names for them.
+ */
+function valueOf(spec, token) {
+    const upper = token.toUpperCase();
+    const alias = spec.aliases.get(upper);
+    if (alias !== undefined) {
+        return alias;
+    }
+    if (unsimulatedWildcard.test(upper)) {
+        throw cronUnsimulatedWildcard(spec);
+    }
+    if (!wholeNumber.test(upper)) {
+        throw cronUnreadable(spec, token);
+    }
+    const value = Number(upper);
+    if (value < spec.minimum || value > spec.maximum) {
+        throw cronOutOfRange(spec, token);
+    }
+    return value;
+}
+/**
+ * Read how far apart the values of a stepped part are.
+ */
+export function stepOf(spec, written) {
+    if (!spec.allowsStep) {
+        throw cronUnexpectedStep(spec);
+    }
+    if (!wholeNumber.test(written) || Number(written) < 1) {
+        throw cronBadStep(written);
+    }
+    return Number(written);
+}
+/**
+ * The start and end of one comma separated part, before its step is applied.
+ *
+ * A bare number with a step behind it starts there and runs to the end of the
+ * field, which is what makes minutes `0/15` every quarter hour rather than only
+ * the hour itself.
+ */
+export function boundsOf(spec, written, stepped) {
+    if (written === "*") {
+        return [spec.minimum, spec.maximum];
+    }
+    const dash = written.indexOf("-");
+    if (dash > 0) {
+        return [
+            valueOf(spec, written.slice(0, dash)),
+            valueOf(spec, written.slice(dash + 1)),
+        ];
+    }
+    const only = valueOf(spec, written);
+    return stepped ? [only, spec.maximum] : [only, only];
+}
+//# sourceMappingURL=sim-cron-field-bounds.js.map

package/dist/util/schedule/cron/sim-cron-field-bounds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cron-field-bounds.js","sourceRoot":"","sources":["../../../../src/util/schedule/cron/sim-cron-field-bounds.ts"],"names":[],"mappings":"AACA,OAAO,EACL,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,uBAAuB,GACxB,MAAM,wBAAwB,CAAC;AAEhC;;;;GAIG;AACH,MAAM,mBAAmB,GAAG,cAAc,CAAC;AAE3C,MAAM,WAAW,GAAG,QAAQ,CAAC;AAE7B;;GAEG;AACH,SAAS,OAAO,CAAC,IAAsB,EAAE,KAAa;IACpD,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAClC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAEtC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACpC,MAAM,uBAAuB,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAE5B,IAAI,KAAK,GAAG,IAAI,CAAC,OAAO,IAAI,KAAK,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QACjD,MAAM,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,MAAM,CAAC,IAAsB,EAAE,OAAe;IAC5D,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;QACrB,MAAM,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACtD,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAED,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC;AACzB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CACtB,IAAsB,EACtB,OAAe,EACf,OAAgB;IAEhB,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAElC,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;QACb,OAAO;YACL,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;YACrC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;SACvC,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAEpC,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AACvD,CAAC"}

package/dist/util/schedule/cron/sim-cron-field-spec.d.ts

@@ -0,0 +1,38 @@
+/**
+ * What one field of a cron expression takes.
+ *
+ * A dialect is a list of these, in field order, which is what keeps the parser
+ * from having any one service's cron rules baked into it. The ranges are the
+ * same in most dialects and which wildcards a field allows is not, so both are
+ * described here rather than assumed.
+ */
+export interface SimCronFieldSpec {
+    /**
+     * What to call this field in a refusal, as its own documentation names it.
+     */
+    readonly name: string;
+    readonly minimum: number;
+    readonly maximum: number;
+    /**
+     * The names this field takes in place of numbers, such as `JAN` for 1.
+     */
+    readonly aliases: ReadonlyMap<string, number>;
+    /**
+     * Whether `?`, meaning "any", may be written in this field.
+     */
+    readonly allowsAny: boolean;
+    /**
+     * Whether `/`, meaning "in steps of", may be written in this field.
+     */
+    readonly allowsStep: boolean;
+}
+/**
+ * The six fields of an AWS cron expression: minutes, hours, day-of-month,
+ * month, day-of-week and year.
+ *
+ * This is the shape both EventBridge and EventBridge Scheduler use. A dialect
+ * that wanted different ranges would write its own list rather than change this
+ * one.
+ */
+export declare const awsCronFieldSpecs: readonly SimCronFieldSpec[];
+//# sourceMappingURL=sim-cron-field-spec.d.ts.map

package/dist/util/schedule/cron/sim-cron-field-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cron-field-spec.d.ts","sourceRoot":"","sources":["../../../../src/util/schedule/cron/sim-cron-field-spec.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE9C;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AA+BD;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,gBAAgB,EAiDxD,CAAC"}

package/dist/util/schedule/cron/sim-cron-field-spec.js

@@ -0,0 +1,85 @@
+const monthNames = [
+    "JAN",
+    "FEB",
+    "MAR",
+    "APR",
+    "MAY",
+    "JUN",
+    "JUL",
+    "AUG",
+    "SEP",
+    "OCT",
+    "NOV",
+    "DEC",
+];
+/**
+ * Sunday first, so `1` is Sunday and `7` is Saturday, which is how AWS numbers
+ * the day-of-week field. Unix cron numbers it from zero, and a rule written for
+ * one and read by the other is off by a day.
+ */
+const dayNames = ["SUN", "MON", "TUE", "WED", "THU", "FRI", "SAT"];
+/**
+ * The names a field takes, numbered from one.
+ */
+function aliasesFor(names) {
+    return new Map(names.map((name, index) => [name, index + 1]));
+}
+/**
+ * The six fields of an AWS cron expression: minutes, hours, day-of-month,
+ * month, day-of-week and year.
+ *
+ * This is the shape both EventBridge and EventBridge Scheduler use. A dialect
+ * that wanted different ranges would write its own list rather than change this
+ * one.
+ */
+export const awsCronFieldSpecs = [
+    {
+        name: "minutes",
+        minimum: 0,
+        maximum: 59,
+        aliases: new Map(),
+        allowsAny: false,
+        allowsStep: true,
+    },
+    {
+        name: "hours",
+        minimum: 0,
+        maximum: 23,
+        aliases: new Map(),
+        allowsAny: false,
+        allowsStep: true,
+    },
+    {
+        name: "day-of-month",
+        minimum: 1,
+        maximum: 31,
+        aliases: new Map(),
+        allowsAny: true,
+        allowsStep: true,
+    },
+    {
+        name: "month",
+        minimum: 1,
+        maximum: 12,
+        aliases: aliasesFor(monthNames),
+        allowsAny: false,
+        allowsStep: true,
+    },
+    {
+        name: "day-of-week",
+        minimum: 1,
+        maximum: 7,
+        aliases: aliasesFor(dayNames),
+        allowsAny: true,
+        allowsStep: false,
+    },
+    {
+        name: "year",
+        minimum: 1970,
+        maximum: 2199,
+        aliases: new Map(),
+        allowsAny: false,
+        allowsStep: true,
+    },
+];
+//# sourceMappingURL=sim-cron-field-spec.js.map

package/dist/util/schedule/cron/sim-cron-field-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cron-field-spec.js","sourceRoot":"","sources":["../../../../src/util/schedule/cron/sim-cron-field-spec.ts"],"names":[],"mappings":"AAiCA,MAAM,UAAU,GAAG;IACjB,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;CACN,CAAC;AAEF;;;;GAIG;AACH,MAAM,QAAQ,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;AAEnE;;GAEG;AACH,SAAS,UAAU,CAAC,KAAwB;IAC1C,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AAChE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAgC;IAC5D;QACE,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,EAAE;QACX,OAAO,EAAE,IAAI,GAAG,EAAE;QAClB,SAAS,EAAE,KAAK;QAChB,UAAU,EAAE,IAAI;KACjB;IACD;QACE,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,EAAE;QACX,OAAO,EAAE,IAAI,GAAG,EAAE;QAClB,SAAS,EAAE,KAAK;QAChB,UAAU,EAAE,IAAI;KACjB;IACD;QACE,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,EAAE;QACX,OAAO,EAAE,IAAI,GAAG,EAAE;QAClB,SAAS,EAAE,IAAI;QACf,UAAU,EAAE,IAAI;KACjB;IACD;QACE,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,EAAE;QACX,OAAO,EAAE,UAAU,CAAC,UAAU,CAAC;QAC/B,SAAS,EAAE,KAAK;QAChB,UAAU,EAAE,IAAI;KACjB;IACD;QACE,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,UAAU,CAAC,QAAQ,CAAC;QAC7B,SAAS,EAAE,IAAI;QACf,UAAU,EAAE,KAAK;KAClB;IACD;QACE,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,IAAI,GAAG,EAAE;QAClB,SAAS,EAAE,KAAK;QAChB,UAAU,EAAE,IAAI;KACjB;CACF,CAAC"}

package/dist/util/schedule/cron/sim-cron-field.d.ts

@@ -0,0 +1,31 @@
+import type { SimCronFieldSpec } from "./sim-cron-field-spec.js";
+/**
+ * One field of a cron expression, read into the values it allows.
+ *
+ * Whether a field was written as `?` is kept, because that is not a fact about
+ * which values it allows: `?` and `*` allow the same ones, and only `?` says
+ * "this field is not the one deciding the day".
+ */
+export declare class SimCronField {
+    /**
+     * Whether this field was written as `?`, meaning "any".
+     */
+    readonly isAny: boolean;
+    /**
+     * The highest value this field's position takes, whether or not it is
+     * allowed. A search for the next occurrence stops once it has run past the
+     * highest year, so it needs to know what that is.
+     */
+    readonly maximum: number;
+    private readonly allowed;
+    private constructor();
+    /**
+     * Read one field of an expression against what its position takes.
+     */
+    static of(spec: SimCronFieldSpec, source: string): SimCronField;
+    /**
+     * Whether this field allows a value.
+     */
+    allows(value: number): boolean;
+}
+//# sourceMappingURL=sim-cron-field.d.ts.map

package/dist/util/schedule/cron/sim-cron-field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cron-field.d.ts","sourceRoot":"","sources":["../../../../src/util/schedule/cron/sim-cron-field.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAyDjE;;;;;;GAMG;AACH,qBAAa,YAAY;IACvB;;OAEG;IACH,SAAgB,KAAK,EAAE,OAAO,CAAC;IAE/B;;;;OAIG;IACH,SAAgB,OAAO,EAAE,MAAM,CAAC;IAEhC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAE9C,OAAO,eAQN;IAED;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,CAc9D;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE7B;CACF"}

package/dist/util/schedule/cron/sim-cron-field.js

@@ -0,0 +1,83 @@
+import { boundsOf, stepOf } from "./sim-cron-field-bounds.js";
+import { cronRepeatedStep, cronUnexpectedAny } from "./sim-cron-refusals.js";
+/**
+ * Every value a range covers, counting around the end of the field.
+ *
+ * A range whose start is after its end wraps, so hours `20-2` is ten at night
+ * through two in the morning rather than nothing at all.
+ */
+function rangeValues(spec, [from, to], step) {
+    const span = spec.maximum - spec.minimum + 1;
+    const covered = from <= to ? to - from : span - (from - to);
+    const values = [];
+    for (let offset = 0; offset <= covered; offset += step) {
+        values.push(spec.minimum + ((from - spec.minimum + offset) % span));
+    }
+    return values;
+}
+/**
+ * Every value one comma separated part of a field covers.
+ */
+function partValues(spec, part) {
+    const [written = "", step, ...extra] = part.split("/");
+    if (extra.length > 0) {
+        throw cronRepeatedStep(spec, part);
+    }
+    return rangeValues(spec, boundsOf(spec, written, step !== undefined), step === undefined ? 1 : stepOf(spec, step));
+}
+/**
+ * Every value a whole field covers.
+ */
+function fieldValues(spec, source) {
+    const allowed = new Set();
+    for (const part of source.split(",")) {
+        for (const value of partValues(spec, part)) {
+            allowed.add(value);
+        }
+    }
+    return allowed;
+}
+/**
+ * One field of a cron expression, read into the values it allows.
+ *
+ * Whether a field was written as `?` is kept, because that is not a fact about
+ * which values it allows: `?` and `*` allow the same ones, and only `?` says
+ * "this field is not the one deciding the day".
+ */
+export class SimCronField {
+    /**
+     * Whether this field was written as `?`, meaning "any".
+     */
+    isAny;
+    /**
+     * The highest value this field's position takes, whether or not it is
+     * allowed. A search for the next occurrence stops once it has run past the
+     * highest year, so it needs to know what that is.
+     */
+    maximum;
+    allowed;
+    constructor(isAny, maximum, allowed) {
+        this.isAny = isAny;
+        this.maximum = maximum;
+        this.allowed = allowed;
+    }
+    /**
+     * Read one field of an expression against what its position takes.
+     */
+    static of(spec, source) {
+        if (source !== "?") {
+            return new this(false, spec.maximum, fieldValues(spec, source));
+        }
+        if (!spec.allowsAny) {
+            throw cronUnexpectedAny(spec);
+        }
+        return new this(true, spec.maximum, new Set(rangeValues(spec, [spec.minimum, spec.maximum], 1)));
+    }
+    /**
+     * Whether this field allows a value.
+     */
+    allows(value) {
+        return this.allowed.has(value);
+    }
+}
+//# sourceMappingURL=sim-cron-field.js.map

package/dist/util/schedule/cron/sim-cron-field.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cron-field.js","sourceRoot":"","sources":["../../../../src/util/schedule/cron/sim-cron-field.ts"],"names":[],"mappings":"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"}

package/dist/util/schedule/cron/sim-cron-fields.d.ts

@@ -0,0 +1,18 @@
+import { SimCronField } from "./sim-cron-field.js";
+import type { SimCronFieldSpec } from "./sim-cron-field-spec.js";
+/**
+ * The six fields of a cron expression, once each has been read.
+ */
+export interface SimCronFields {
+    readonly minutes: SimCronField;
+    readonly hours: SimCronField;
+    readonly dayOfMonth: SimCronField;
+    readonly month: SimCronField;
+    readonly dayOfWeek: SimCronField;
+    readonly year: SimCronField;
+}
+/**
+ * Read every field of an expression, in the positions the dialect describes.
+ */
+export declare function readFields(specs: readonly SimCronFieldSpec[], written: readonly string[]): SimCronFields;
+//# sourceMappingURL=sim-cron-fields.d.ts.map

package/dist/util/schedule/cron/sim-cron-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cron-fields.d.ts","sourceRoot":"","sources":["../../../../src/util/schedule/cron/sim-cron-fields.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;CAC7B;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,SAAS,gBAAgB,EAAE,EAClC,OAAO,EAAE,SAAS,MAAM,EAAE,GACzB,aAAa,CA8Bf"}

package/dist/util/schedule/cron/sim-cron-fields.js

@@ -0,0 +1,26 @@
+import { SimScheduleExpressionError } from "../sim-schedule.error.js";
+import { SimCronField } from "./sim-cron-field.js";
+/**
+ * Read every field of an expression, in the positions the dialect describes.
+ */
+export function readFields(specs, written) {
+    const [minutes, hours, dayOfMonth, month, dayOfWeek, year] = specs.map((spec, index) => SimCronField.of(spec, written.at(index) ?? ""));
+    if (minutes === undefined ||
+        hours === undefined ||
+        dayOfMonth === undefined ||
+        month === undefined ||
+        dayOfWeek === undefined ||
+        year === undefined) {
+        throw new SimScheduleExpressionError("a cron dialect describes six fields: minutes, hours, day-of-month, " +
+            "month, day-of-week and year");
+    }
+    // AWS asks for `?` in one of the two day fields, since a rule naming both
+    // the 1st and Monday has no obvious meaning: one reading is the 1st when it
+    // falls on a Monday, and the other is the 1st and also every Monday.
+    if (!dayOfMonth.isAny && !dayOfWeek.isAny) {
+        throw new SimScheduleExpressionError("the day-of-month and day-of-week fields cannot both be given: use " +
+            "'?' in whichever of the two is not deciding the day");
+    }
+    return { minutes, hours, dayOfMonth, month, dayOfWeek, year };
+}
+//# sourceMappingURL=sim-cron-fields.js.map

package/dist/util/schedule/cron/sim-cron-fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cron-fields.js","sourceRoot":"","sources":["../../../../src/util/schedule/cron/sim-cron-fields.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAenD;;GAEG;AACH,MAAM,UAAU,UAAU,CACxB,KAAkC,EAClC,OAA0B;IAE1B,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,KAAK,CAAC,GAAG,CACpE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAChE,CAAC;IAEF,IACE,OAAO,KAAK,SAAS;QACrB,KAAK,KAAK,SAAS;QACnB,UAAU,KAAK,SAAS;QACxB,KAAK,KAAK,SAAS;QACnB,SAAS,KAAK,SAAS;QACvB,IAAI,KAAK,SAAS,EAClB,CAAC;QACD,MAAM,IAAI,0BAA0B,CAClC,qEAAqE;YACnE,6BAA6B,CAChC,CAAC;IACJ,CAAC;IAED,0EAA0E;IAC1E,4EAA4E;IAC5E,qEAAqE;IACrE,IAAI,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QAC1C,MAAM,IAAI,0BAA0B,CAClC,oEAAoE;YAClE,qDAAqD,CACxD,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AAChE,CAAC"}

package/dist/util/schedule/cron/sim-cron-refusals.d.ts

@@ -0,0 +1,39 @@
+import { SimScheduleExpressionError, SimUnsimulatedScheduleExpressionError } from "../sim-schedule.error.js";
+import type { SimCronFieldSpec } from "./sim-cron-field-spec.js";
+/**
+ * Every way one field of a cron expression can be refused, in one place.
+ *
+ * Each says which field it is about, since a six-field expression gives a
+ * reader nothing to go on otherwise, and each says what was written, since a
+ * cron expression is usually wrong by one character.
+ */
+export declare function cronFieldRefusal(spec: SimCronFieldSpec, reason: string): SimScheduleExpressionError;
+/**
+ * A value outside the range its field takes.
+ */
+export declare function cronOutOfRange(spec: SimCronFieldSpec, token: string): SimScheduleExpressionError;
+/**
+ * A part that is neither a number, a name, nor a wildcard.
+ */
+export declare function cronUnreadable(spec: SimCronFieldSpec, token: string): SimScheduleExpressionError;
+/**
+ * One of the wildcards real AWS reads and this simulation does not.
+ */
+export declare function cronUnsimulatedWildcard(spec: SimCronFieldSpec): SimUnsimulatedScheduleExpressionError;
+/**
+ * A `?` written in a field that is not one of the two day fields.
+ */
+export declare function cronUnexpectedAny(spec: SimCronFieldSpec): SimScheduleExpressionError;
+/**
+ * A `/` written in a field that does not take a step.
+ */
+export declare function cronUnexpectedStep(spec: SimCronFieldSpec): SimScheduleExpressionError;
+/**
+ * A step that is not a whole number of at least one.
+ */
+export declare function cronBadStep(written: string): SimScheduleExpressionError;
+/**
+ * A part carrying more than one step.
+ */
+export declare function cronRepeatedStep(spec: SimCronFieldSpec, part: string): SimScheduleExpressionError;
+//# sourceMappingURL=sim-cron-refusals.d.ts.map

package/dist/util/schedule/cron/sim-cron-refusals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cron-refusals.d.ts","sourceRoot":"","sources":["../../../../src/util/schedule/cron/sim-cron-refusals.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,qCAAqC,EACtC,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjE;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,gBAAgB,EACtB,MAAM,EAAE,MAAM,GACb,0BAA0B,CAE5B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,gBAAgB,EACtB,KAAK,EAAE,MAAM,GACZ,0BAA0B,CAM5B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,gBAAgB,EACtB,KAAK,EAAE,MAAM,GACZ,0BAA0B,CAE5B;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,gBAAgB,GACrB,qCAAqC,CAKvC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,gBAAgB,GACrB,0BAA0B,CAK5B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,gBAAgB,GACrB,0BAA0B,CAE5B;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,0BAA0B,CAIvE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,gBAAgB,EACtB,IAAI,EAAE,MAAM,GACX,0BAA0B,CAE5B"}

package/dist/util/schedule/cron/sim-cron-refusals.js

@@ -0,0 +1,56 @@
+import { SimScheduleExpressionError, SimUnsimulatedScheduleExpressionError, } from "../sim-schedule.error.js";
+/**
+ * Every way one field of a cron expression can be refused, in one place.
+ *
+ * Each says which field it is about, since a six-field expression gives a
+ * reader nothing to go on otherwise, and each says what was written, since a
+ * cron expression is usually wrong by one character.
+ */
+export function cronFieldRefusal(spec, reason) {
+    return new SimScheduleExpressionError(`the ${spec.name} field ${reason}`);
+}
+/**
+ * A value outside the range its field takes.
+ */
+export function cronOutOfRange(spec, token) {
+    return cronFieldRefusal(spec, `takes ${String(spec.minimum)} to ${String(spec.maximum)}, and this one ` +
+        `has '${token}'`);
+}
+/**
+ * A part that is neither a number, a name, nor a wildcard.
+ */
+export function cronUnreadable(spec, token) {
+    return cronFieldRefusal(spec, `cannot be read: '${token}'`);
+}
+/**
+ * One of the wildcards real AWS reads and this simulation does not.
+ */
+export function cronUnsimulatedWildcard(spec) {
+    return new SimUnsimulatedScheduleExpressionError(`the ${spec.name} field uses 'L', 'W' or '#', which real AWS reads and ` +
+        `this simulation does not: only ',', '-', '*', '?' and '/' are read here`);
+}
+/**
+ * A `?` written in a field that is not one of the two day fields.
+ */
+export function cronUnexpectedAny(spec) {
+    return cronFieldRefusal(spec, `does not take '?', which only the day-of-month and day-of-week fields do`);
+}
+/**
+ * A `/` written in a field that does not take a step.
+ */
+export function cronUnexpectedStep(spec) {
+    return cronFieldRefusal(spec, `does not take '/'`);
+}
+/**
+ * A step that is not a whole number of at least one.
+ */
+export function cronBadStep(written) {
+    return new SimScheduleExpressionError(`a '/' step is a whole number of at least one, and this one is '${written}'`);
+}
+/**
+ * A part carrying more than one step.
+ */
+export function cronRepeatedStep(spec, part) {
+    return cronFieldRefusal(spec, `has a part with more than one '/': '${part}'`);
+}
+//# sourceMappingURL=sim-cron-refusals.js.map

package/dist/util/schedule/cron/sim-cron-refusals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cron-refusals.js","sourceRoot":"","sources":["../../../../src/util/schedule/cron/sim-cron-refusals.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,qCAAqC,GACtC,MAAM,0BAA0B,CAAC;AAGlC;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAsB,EACtB,MAAc;IAEd,OAAO,IAAI,0BAA0B,CAAC,OAAO,IAAI,CAAC,IAAI,UAAU,MAAM,EAAE,CAAC,CAAC;AAC5E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAsB,EACtB,KAAa;IAEb,OAAO,gBAAgB,CACrB,IAAI,EACJ,SAAS,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,iBAAiB;QACvE,QAAQ,KAAK,GAAG,CACnB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAsB,EACtB,KAAa;IAEb,OAAO,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,KAAK,GAAG,CAAC,CAAC;AAC9D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CACrC,IAAsB;IAEtB,OAAO,IAAI,qCAAqC,CAC9C,OAAO,IAAI,CAAC,IAAI,wDAAwD;QACtE,yEAAyE,CAC5E,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAsB;IAEtB,OAAO,gBAAgB,CACrB,IAAI,EACJ,0EAA0E,CAC3E,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAsB;IAEtB,OAAO,gBAAgB,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,IAAI,0BAA0B,CACnC,kEAAkE,OAAO,GAAG,CAC7E,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAsB,EACtB,IAAY;IAEZ,OAAO,gBAAgB,CAAC,IAAI,EAAE,uCAAuC,IAAI,GAAG,CAAC,CAAC;AAChF,CAAC"}

package/dist/util/schedule/rate/sim-rate-expression.d.ts

@@ -0,0 +1,29 @@
+/**
+ * One rate expression, as an interval between occurrences.
+ *
+ * A rate runs from whenever the thing carrying it was created rather than from
+ * a wall clock boundary, so this holds only how long the interval is. Where the
+ * interval is counted from is the caller's, which is what makes a `rate(1 day)`
+ * rule created at half past nine fire at half past nine.
+ */
+export declare class SimRateExpression {
+    readonly source: string;
+    private readonly interval;
+    private constructor();
+    /**
+     * Read the value and unit inside a `rate(...)`.
+     */
+    static of(source: string, requireAgreement: boolean): SimRateExpression;
+    /**
+     * The next instant this rate falls due after an instant.
+     *
+     * One interval on from whatever it is asked about, so asking it about each
+     * due time in turn walks the schedule from where it started.
+     *
+     * Nothing comes back when that lands past the end of representable time. A
+     * schedule that has run out of instants is not armed again, which is a better
+     * answer than a due time of Not a Number that quietly never arrives.
+     */
+    nextAfter(instant: Date): Date | undefined;
+}
+//# sourceMappingURL=sim-rate-expression.d.ts.map

package/dist/util/schedule/rate/sim-rate-expression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rate-expression.d.ts","sourceRoot":"","sources":["../../../../src/util/schedule/rate/sim-rate-expression.ts"],"names":[],"mappings":"AAgFA;;;;;;;GAOG;AACH,qBAAa,iBAAiB;IAC5B,SAAgB,MAAM,EAAE,MAAM,CAAC;IAE/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAElC,OAAO,eAGN;IAED;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,GAAG,iBAAiB,CA6BtE;IAED;;;;;;;;;OASG;IACH,SAAS,CAAC,OAAO,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,CAQzC;CACF"}

package/dist/util/schedule/rate/sim-rate-expression.js

@@ -0,0 +1,114 @@
+import { SimScheduleExpressionError } from "../sim-schedule.error.js";
+const millisecondsPerMinute = 60_000;
+/**
+ * The furthest apart two instants can be, which is the whole span a JavaScript
+ * Date reaches either side of the epoch.
+ */
+const maximumInterval = 2 * 8_640_000_000_000_000;
+const wholeNumber = /^\d+$/u;
+const whitespace = /\s+/u;
+/**
+ * How long each unit a rate expression takes is, in minutes.
+ *
+ * Seconds are absent because AWS has none: the finest schedule it runs is one a
+ * minute, so a rate under that has no unit to be written in.
+ */
+const unitMinutes = new Map([
+    ["minute", 1],
+    ["hour", 60],
+    ["day", 24 * 60],
+]);
+/**
+ * The unit a rate is in, without its plural.
+ */
+function readUnit(written) {
+    const singular = written.toLowerCase().replace(/s$/u, "");
+    const minutes = unitMinutes.get(singular);
+    if (minutes === undefined) {
+        throw new SimScheduleExpressionError(`a rate is in minutes, hours or days, and this one is in ` +
+            `'${written}'. AWS runs no schedule finer than one a minute, so ` +
+            `there is no smaller unit to ask for.`);
+    }
+    return { singular, minutes };
+}
+/**
+ * The number of units a rate is, which has to be a whole one or more.
+ */
+function readValue(written) {
+    if (!wholeNumber.test(written) || Number(written) < 1) {
+        throw new SimScheduleExpressionError(`a rate is a positive whole number of units, and this one is ` +
+            `'${written}'`);
+    }
+    return Number(written);
+}
+/**
+ * Refuse a value and unit that do not agree, as AWS does.
+ *
+ * `rate(1 hours)` and `rate(5 hour)` are both refused by real EventBridge, and
+ * both are the kind of thing that is written by accident, so refusing them here
+ * is what stops a rule failing to deploy after the tests passed.
+ */
+function refuseDisagreement(value, written, singular) {
+    const expected = value === 1 ? singular : `${singular}s`;
+    if (written.toLowerCase() !== expected) {
+        throw new SimScheduleExpressionError(`a rate of ${String(value)} is written '${String(value)} ${expected}', ` +
+            `not '${String(value)} ${written}'`);
+    }
+}
+/**
+ * One rate expression, as an interval between occurrences.
+ *
+ * A rate runs from whenever the thing carrying it was created rather than from
+ * a wall clock boundary, so this holds only how long the interval is. Where the
+ * interval is counted from is the caller's, which is what makes a `rate(1 day)`
+ * rule created at half past nine fire at half past nine.
+ */
+export class SimRateExpression {
+    source;
+    interval;
+    constructor(source, interval) {
+        this.source = source;
+        this.interval = interval;
+    }
+    /**
+     * Read the value and unit inside a `rate(...)`.
+     */
+    static of(source, requireAgreement) {
+        const [value, unit, ...extra] = source.trim().split(whitespace);
+        if (value === undefined || unit === undefined || extra.length > 0) {
+            throw new SimScheduleExpressionError(`a rate expression is a value and a unit separated by a space, such ` +
+                `as '5 minutes', and this one is '${source}'`);
+        }
+        const count = readValue(value);
+        const read = readUnit(unit);
+        if (requireAgreement) {
+            refuseDisagreement(count, unit, read.singular);
+        }
+        const interval = count * read.minutes * millisecondsPerMinute;
+        // A rate longer than time itself would otherwise arrive as an interval no
+        // Date can hold, and a rule armed for an instant that is not one never
+        // fires and never says why.
+        if (interval > maximumInterval) {
+            throw new SimScheduleExpressionError(`a rate of '${source}' is longer than any two instants can be apart`);
+        }
+        return new this(source, interval);
+    }
+    /**
+     * The next instant this rate falls due after an instant.
+     *
+     * One interval on from whatever it is asked about, so asking it about each
+     * due time in turn walks the schedule from where it started.
+     *
+     * Nothing comes back when that lands past the end of representable time. A
+     * schedule that has run out of instants is not armed again, which is a better
+     * answer than a due time of Not a Number that quietly never arrives.
+     */
+    nextAfter(instant) {
+        const due = new Date(instant.getTime() + this.interval);
+        if (Number.isNaN(due.getTime())) {
+            return undefined;
+        }
+        return due;
+    }
+}
+//# sourceMappingURL=sim-rate-expression.js.map