@lafken/schedule 0.12.24 → 0.12.26

package/lib/main/schedule/schedule.types.d.ts

@@ -44,6 +44,63 @@ export interface EventCronProps {
      *   - Each field can be a number, '*', '?', a range `${number}-${number}`
      */
     schedule: string | ScheduleTime;
+    /**
+     * Timezone in which the schedule expression is evaluated.
+     *
+     * Accepts an IANA timezone name (e.g. `'America/Santiago'`, `'UTC'`).
+     * If omitted, the schedule is evaluated in UTC.
+     *
+     * Maps to the `scheduleExpressionTimezone` attribute of the EventBridge
+     * Scheduler resource. Note that the timezone is independent from the cron
+     * expression itself.
+     *
+     * @example
+     * timezone: 'America/Santiago'
+     */
+    timezone?: string;
+    /**
+     * Human-readable description of the schedule.
+     *
+     * Useful for documentation purposes; shown in the AWS console.
+     */
+    description?: string;
+    /**
+     * State of the schedule.
+     *
+     * Allows pausing the schedule without deleting it:
+     * - `'enabled'` (default): the schedule is active.
+     * - `'disabled'`: the schedule will not trigger its target.
+     */
+    state?: 'enabled' | 'disabled';
+    /**
+     * Date and time, in ISO 8601 format, after which the schedule can begin
+     * invoking its target.
+     *
+     * @example
+     * startDate: '2026-07-01T00:00:00Z'
+     */
+    startDate?: string;
+    /**
+     * Date and time, in ISO 8601 format, before which the schedule can invoke
+     * its target. After this point the schedule stops triggering.
+     *
+     * @example
+     * endDate: '2026-12-31T23:59:59Z'
+     */
+    endDate?: string;
+    /**
+     * Maximum flexible time window, in minutes, within which the schedule can be
+     * invoked.
+     *
+     * When provided, the schedule runs in `FLEXIBLE` mode and EventBridge may
+     * invoke the target at any point inside this window (useful to spread load
+     * and avoid thundering-herd effects). If omitted, the schedule runs in `OFF`
+     * mode and triggers at the exact scheduled time.
+     *
+     * @example
+     * flexibleWindowMinutes: 15
+     */
+    flexibleWindowMinutes?: number;
     /**
      * Defines which EventBridge Scheduler attributes should be exported.
      *

package/lib/resolver/cron/cron.js

@@ -22,7 +22,17 @@ class Cron extends resolver_1.lafkenResource.make(scheduler_schedule_1.Scheduler
         super(scope, `${handler.name}-cron`, {
             name: handler.name,
             scheduleExpression: Cron.buildScheduleExpression(handler.schedule),
-            flexibleTimeWindow: { mode: 'OFF' },
+            scheduleExpressionTimezone: handler.timezone,
+            description: handler.description,
+            state: handler.state?.toUpperCase(),
+            startDate: handler.startDate,
+            endDate: handler.endDate,
+            flexibleTimeWindow: handler.flexibleWindowMinutes
+                ? {
+                    mode: 'FLEXIBLE',
+                    maximumWindowInMinutes: handler.flexibleWindowMinutes,
+                }
+                : { mode: 'OFF' },
             target: {
                 arn: lambdaHandler.arn,
                 roleArn: schedulerRole.arn,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lafken/schedule",
-  "version": "0.12.24",
+  "version": "0.12.26",
   "private": false,
   "description": "Define EventBridge scheduled rules and cron jobs using TypeScript decorators with Lafken",
   "keywords": [
@@ -50,7 +50,7 @@
   ],
   "dependencies": {
     "reflect-metadata": "^0.2.2",
-    "@lafken/resolver": "0.12.24"
+    "@lafken/resolver": "0.12.26"
   },
   "devDependencies": {
     "@cdktn/provider-aws": "^24.4.0",
@@ -63,7 +63,7 @@
     "typescript": "6.0.3",
     "unplugin-swc": "^1.5.9",
     "vitest": "^4.1.8",
-    "@lafken/common": "0.12.24"
+    "@lafken/common": "0.12.26"
   },
   "peerDependencies": {
     "@cdktn/provider-aws": ">=23.0.0",