@kensio/yulin 1.11.0 → 1.12.0

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

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

package/dist/util/schedule/sim-schedule-dialect.d.ts

@@ -0,0 +1,28 @@
+import type { SimCronFieldSpec } from "./cron/sim-cron-field-spec.js";
+/**
+ * One service's rules for reading a schedule expression.
+ *
+ * `rate(...)` and `cron(...)` look the same across AWS and are not read
+ * identically: EventBridge insists a rate's unit agrees with its value, and
+ * EventBridge Scheduler does not. Keeping the differences here is what lets one
+ * parser serve both, rather than one service's rules being the parser's.
+ */
+export interface SimScheduleDialect {
+    /**
+     * The fields of a cron expression, in order.
+     */
+    readonly cronFields: readonly SimCronFieldSpec[];
+    /**
+     * Whether a rate's unit has to agree with its value, so that `rate(1 hours)`
+     * is refused rather than read as one hour.
+     */
+    readonly requiresRateAgreement: boolean;
+    /**
+     * Whether `at(...)`, a single instant, is one of the forms this dialect
+     * takes. EventBridge Scheduler has one-time schedules and an EventBridge
+     * rule has no equivalent, so a rule written with one is refused rather than
+     * created as a rule that never fires.
+     */
+    readonly allowsOneTime: boolean;
+}
+//# sourceMappingURL=sim-schedule-dialect.d.ts.map

package/dist/util/schedule/sim-schedule-dialect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-schedule-dialect.d.ts","sourceRoot":"","sources":["../../../src/util/schedule/sim-schedule-dialect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEtE;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAEjD;;;OAGG;IACH,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAC;IAExC;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC"}

package/dist/util/schedule/sim-schedule-dialect.js

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

package/dist/util/schedule/sim-schedule-dialect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-schedule-dialect.js","sourceRoot":"","sources":["../../../src/util/schedule/sim-schedule-dialect.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,30 @@
+import type { SimScheduleDialect } from "./sim-schedule-dialect.js";
+/**
+ * One schedule expression, whichever form it was written in.
+ *
+ * The two forms answer the same question and answer it differently: a rate
+ * counts from where it is asked, and a cron expression names absolute instants
+ * and ignores where it is asked from beyond needing somewhere to start.
+ */
+export declare class SimSchedule {
+    /**
+     * The expression as it was written, which a describe reports back.
+     */
+    readonly source: string;
+    private readonly occurrences;
+    private constructor();
+    /**
+     * Read a schedule expression under a dialect's rules.
+     */
+    static of(source: string, dialect: SimScheduleDialect): SimSchedule;
+    /**
+     * Read the body of whichever form the expression was written in.
+     */
+    private static occurrencesOf;
+    /**
+     * The next instant this schedule falls due after an instant, or nothing when
+     * it never falls due again.
+     */
+    nextAfter(instant: Date): Date | undefined;
+}
+//# sourceMappingURL=sim-schedule.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-schedule.d.ts","sourceRoot":"","sources":["../../../src/util/schedule/sim-schedule.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAgBpE;;;;;;GAMG;AACH,qBAAa,WAAW;IACtB;;OAEG;IACH,SAAgB,MAAM,EAAE,MAAM,CAAC;IAE/B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAyB;IAErD,OAAO,eAGN;IAED;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAWlE;IAED;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IA4B5B;;;OAGG;IACH,SAAS,CAAC,OAAO,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,CAEzC;CACF"}

package/dist/util/schedule/sim-schedule.error.d.ts

@@ -0,0 +1,20 @@
+/**
+ * A schedule expression the dialect reading it will not take.
+ *
+ * Parsing lives apart from any one service, so what it throws is generic and
+ * whoever asked for the parse turns it into their own API error. That is what
+ * lets two services share a parser and still refuse a bad expression the way
+ * each of their callers expects.
+ */
+export declare class SimScheduleExpressionError extends Error {
+}
+/**
+ * A schedule expression that real AWS takes and this simulation does not.
+ *
+ * Held apart from a plain refusal because the two mean different things to
+ * whoever reads them: one says the expression is wrong, and this one says the
+ * expression is right and the simulator does not go that far.
+ */
+export declare class SimUnsimulatedScheduleExpressionError extends SimScheduleExpressionError {
+}
+//# sourceMappingURL=sim-schedule.error.d.ts.map

package/dist/util/schedule/sim-schedule.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-schedule.error.d.ts","sourceRoot":"","sources":["../../../src/util/schedule/sim-schedule.error.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,qBAAa,0BAA2B,SAAQ,KAAK;CAAG;AAExD;;;;;;GAMG;AACH,qBAAa,qCAAsC,SAAQ,0BAA0B;CAAG"}

package/dist/util/schedule/sim-schedule.error.js

@@ -0,0 +1,20 @@
+/**
+ * A schedule expression the dialect reading it will not take.
+ *
+ * Parsing lives apart from any one service, so what it throws is generic and
+ * whoever asked for the parse turns it into their own API error. That is what
+ * lets two services share a parser and still refuse a bad expression the way
+ * each of their callers expects.
+ */
+export class SimScheduleExpressionError extends Error {
+}
+/**
+ * A schedule expression that real AWS takes and this simulation does not.
+ *
+ * Held apart from a plain refusal because the two mean different things to
+ * whoever reads them: one says the expression is wrong, and this one says the
+ * expression is right and the simulator does not go that far.
+ */
+export class SimUnsimulatedScheduleExpressionError extends SimScheduleExpressionError {
+}
+//# sourceMappingURL=sim-schedule.error.js.map

package/dist/util/schedule/sim-schedule.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-schedule.error.js","sourceRoot":"","sources":["../../../src/util/schedule/sim-schedule.error.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,OAAO,0BAA2B,SAAQ,KAAK;CAAG;AAExD;;;;;;GAMG;AACH,MAAM,OAAO,qCAAsC,SAAQ,0BAA0B;CAAG"}

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

@@ -0,0 +1,62 @@
+import { SimAtExpression } from "./at/sim-at-expression.js";
+import { SimCronExpression } from "./cron/sim-cron-expression.js";
+import { SimRateExpression } from "./rate/sim-rate-expression.js";
+import { SimScheduleExpressionError } from "./sim-schedule.error.js";
+const expression = /^(?<kind>[a-z]+)\((?<body>.*)\)$/su;
+/**
+ * One schedule expression, whichever form it was written in.
+ *
+ * The two forms answer the same question and answer it differently: a rate
+ * counts from where it is asked, and a cron expression names absolute instants
+ * and ignores where it is asked from beyond needing somewhere to start.
+ */
+export class SimSchedule {
+    /**
+     * The expression as it was written, which a describe reports back.
+     */
+    source;
+    occurrences;
+    constructor(source, occurrences) {
+        this.source = source;
+        this.occurrences = occurrences;
+    }
+    /**
+     * Read a schedule expression under a dialect's rules.
+     */
+    static of(source, dialect) {
+        const read = expression.exec(source.trim())?.groups;
+        if (read === undefined) {
+            throw new SimScheduleExpressionError(`a schedule expression is 'rate(<value> <unit>)' or ` +
+                `'cron(<fields>)', and this one is '${source}'`);
+        }
+        return new this(source, this.occurrencesOf(read, dialect));
+    }
+    /**
+     * Read the body of whichever form the expression was written in.
+     */
+    static occurrencesOf(read, dialect) {
+        const body = read["body"] ?? "";
+        if (read["kind"] === "rate") {
+            return SimRateExpression.of(body, dialect.requiresRateAgreement);
+        }
+        if (read["kind"] === "cron") {
+            return SimCronExpression.of(dialect.cronFields, body);
+        }
+        if (read["kind"] === "at" && dialect.allowsOneTime) {
+            return SimAtExpression.of(body);
+        }
+        const forms = dialect.allowsOneTime
+            ? "an 'at(...)', a 'rate(...)' or a 'cron(...)'"
+            : "a 'rate(...)' or a 'cron(...)'";
+        throw new SimScheduleExpressionError(`a schedule expression is ${forms}, and this one is a ` +
+            `'${String(read["kind"])}(...)'`);
+    }
+    /**
+     * The next instant this schedule falls due after an instant, or nothing when
+     * it never falls due again.
+     */
+    nextAfter(instant) {
+        return this.occurrences.nextAfter(instant);
+    }
+}
+//# sourceMappingURL=sim-schedule.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-schedule.js","sourceRoot":"","sources":["../../../src/util/schedule/sim-schedule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAElE,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAarE,MAAM,UAAU,GAAG,oCAAoC,CAAC;AAExD;;;;;;GAMG;AACH,MAAM,OAAO,WAAW;IACtB;;OAEG;IACa,MAAM,CAAS;IAEd,WAAW,CAAyB;IAErD,YAAoB,MAAc,EAAE,WAAmC;QACrE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,MAAc,EAAE,OAA2B;QACnD,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC;QAEpD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,MAAM,IAAI,0BAA0B,CAClC,qDAAqD;gBACnD,sCAAsC,MAAM,GAAG,CAClD,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,aAAa,CAC1B,IAAqC,EACrC,OAA2B;QAE3B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAEhC,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,MAAM,EAAE,CAAC;YAC5B,OAAO,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;QACnE,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,MAAM,EAAE,CAAC;YAC5B,OAAO,iBAAiB,CAAC,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QACxD,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;YACnD,OAAO,eAAe,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC;QAED,MAAM,KAAK,GAAG,OAAO,CAAC,aAAa;YACjC,CAAC,CAAC,8CAA8C;YAChD,CAAC,CAAC,gCAAgC,CAAC;QAErC,MAAM,IAAI,0BAA0B,CAClC,4BAA4B,KAAK,sBAAsB;YACrD,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,QAAQ,CACnC,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,SAAS,CAAC,OAAa;QACrB,OAAO,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kensio/yulin",
-  "version": "1.11.0",
+  "version": "1.12.0",
   "description": "AWS system behaviour simulation for isolated unit testing",
   "repository": "https://github.com/KensioSoftware/yulin",
   "homepage": "https://yulinsim.dev/",
@@ -74,6 +74,10 @@
       "import": "./dist/config/eslint/index.js",
       "types": "./dist/config/eslint/index.d.ts"
     },
+    "./eventbridge": {
+      "import": "./dist/service/eventbridge/index.js",
+      "types": "./dist/service/eventbridge/index.d.ts"
+    },
     "./iam": {
       "import": "./dist/service/iam/index.js",
       "types": "./dist/service/iam/index.d.ts"
@@ -104,6 +108,10 @@
       "import": "./dist/service/route53/index.js",
       "types": "./dist/service/route53/index.d.ts"
     },
+    "./scheduler": {
+      "import": "./dist/service/scheduler/index.js",
+      "types": "./dist/service/scheduler/index.d.ts"
+    },
     "./sdk": {
       "import": "./dist/sdk/index.js",
       "types": "./dist/sdk/index.d.ts"
@@ -151,12 +159,14 @@
     "@aws-sdk/client-cognito-identity-provider": "^3.1101.0",
     "@aws-sdk/client-dynamodb": "^3.1101.0",
     "@aws-sdk/client-dynamodb-streams": "^3.1101.0",
+    "@aws-sdk/client-eventbridge": "^3.1109.0",
     "@aws-sdk/client-iam": "^3.1101.0",
     "@aws-sdk/client-kms": "^3.1101.0",
     "@aws-sdk/client-lambda": "^3.1101.0",
     "@aws-sdk/client-rekognition": "^3.1101.0",
     "@aws-sdk/client-route-53": "^3.1101.0",
     "@aws-sdk/client-s3": "^3.1101.0",
+    "@aws-sdk/client-scheduler": "^3.1109.0",
     "@aws-sdk/client-secrets-manager": "^3.1101.0",
     "@aws-sdk/client-sns": "^3.1104.0",
     "@aws-sdk/client-sqs": "^3.1101.0",
@@ -184,7 +194,7 @@
     "eslint-plugin-jsdoc": "^63.3.2",
     "eslint-plugin-no-secrets": "^2.3.3",
     "eslint-plugin-security": "^4.0.1",
-    "eslint-plugin-unicorn": "^71.0.0",
+    "eslint-plugin-unicorn": "^72.0.0",
     "execa": "^9.6.1",
     "fta-cli": "^3.0.0",
     "oxfmt": "^0.62.0",