alepha 0.20.5 → 0.20.7

package/dist/router/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/router/providers/RouterProvider.ts","../../src/router/TemplatedPathParser.ts"],"sourcesContent":["import { AlephaError } from \"alepha\";\n\nexport abstract class RouterProvider<T extends Route = Route> {\n  protected routePathRegex: RegExp = /^\\/[A-Za-z0-9._~!$&%'()*+,;=:@{}?/-]*$/;\n\n  protected tree: Tree<T> = { children: {} };\n  protected cache = new Map<string, RouteMatch<T>>();\n  protected maxCacheSize = 10_000;\n\n  public match(path: string): RouteMatch<T> {\n    const pathname = path.split(\"?\", 1)[0];\n    const hit = this.cache.get(pathname);\n    if (hit) {\n      return { route: hit.route, params: { ...hit.params } };\n    }\n    const result = this.mapParams(this.createRouteMatch(pathname));\n    if (this.cache.size >= this.maxCacheSize) this.cache.clear();\n    this.cache.set(pathname, result);\n    return { route: result.route, params: { ...result.params } };\n  }\n\n  protected test(path: string): void {\n    if (!this.routePathRegex.test(path)) {\n      throw new AlephaError(`Route '${path}' is not valid`);\n    }\n  }\n\n  protected push(route: T): void {\n    const path = route.path.replaceAll(\"//\", \"/\");\n\n    this.test(path);\n    this.cache.clear();\n\n    const parts = this.createParts(path);\n\n    let cursor = this.tree;\n    for (let i = 0; i < parts.length; i++) {\n      const isLast = i === parts.length - 1;\n      let part = parts[i].toLowerCase(); // url is case-insensitive\n      if (part === \"*\" && isLast) {\n        cursor.wildcard = { route };\n        break;\n      }\n\n      if (part.includes(\"*\")) {\n        throw new AlephaError(`Route '${path}' has an invalid wildcard syntax`);\n      }\n\n      if (part.includes(\"{\") || part.includes(\"}\")) {\n        if (part.startsWith(\"{\") && part.endsWith(\"}\")) {\n          part = `:${part.slice(1, -1)}`; // convert {param} to :param\n        } else {\n          throw new AlephaError(`Route '${path}' has an invalid param syntax`);\n        }\n      }\n\n      if (part.startsWith(\":\")) {\n        const name = parts[i].slice(1).replaceAll(\"}\", \"\");\n        if (!name) {\n          throw new AlephaError(`Route '${path}' has an empty param name`);\n        }\n        if (!cursor.param) {\n          cursor.param = { name, children: {} };\n        } else if (cursor.param.name !== name) {\n          // damn, 2 url params with different names\n          // got this case with /customers/:id and /customers/:userId/payments\n          route.mapParams ??= {};\n          route.mapParams[cursor.param.name] = name;\n        }\n\n        if (isLast) {\n          cursor.param.route = route;\n        }\n\n        cursor = cursor.param;\n        continue;\n      }\n\n      if (!cursor.children[part]) {\n        cursor.children[part] = { children: {} };\n      }\n\n      if (isLast) {\n        cursor.children[part].route = route;\n      }\n\n      cursor = cursor.children[part];\n    }\n  }\n\n  protected createRouteMatch(path: string): RouteMatch<T> {\n    if (path[0] !== \"/\") {\n      throw new AlephaError(`Path '${path}' must start with \"/\"`);\n    }\n\n    const parts = this.createParts(path);\n\n    let cursor = this.tree;\n    let wildcard: { route: T } | undefined;\n    const params: Record<string, string> = {};\n\n    for (let i = 0; i < parts.length; i++) {\n      const part = parts[i].toLowerCase(); // url is case-insensitive\n      if (cursor.children[part]) {\n        if (cursor.wildcard) {\n          wildcard = cursor.wildcard;\n        }\n        cursor = cursor.children[part];\n      } else if (cursor.param) {\n        if (cursor.wildcard) {\n          wildcard = cursor.wildcard;\n        }\n        params[cursor.param.name] = parts[i];\n        cursor = cursor.param;\n      } else if (cursor.wildcard) {\n        params[\"*\"] = parts.slice(i).join(\"/\");\n        return { route: cursor.wildcard.route, params };\n      } else {\n        return { route: wildcard?.route, params };\n      }\n    }\n\n    if (!cursor?.route) {\n      // when \"/a/*\" - trigger if \"/a\"\n      if (cursor.wildcard) {\n        return { route: cursor.wildcard.route, params };\n      }\n      // return deep wildcard or nothing\n      return { route: wildcard?.route, params };\n    }\n\n    return { route: cursor.route, params };\n  }\n\n  protected mapParams(match: RouteMatch<T>): RouteMatch<T> {\n    if (match.route?.mapParams && match.params) {\n      for (const [key, value] of Object.entries(match.route.mapParams)) {\n        if (match.params[key]) {\n          match.params[value] = match.params[key];\n          delete match.params[key];\n        }\n      }\n    }\n\n    return match;\n  }\n\n  protected createParts(path: string): string[] {\n    let pathname = path.split(\"?\")[0].replaceAll(\"//\", \"/\");\n\n    // remove trailing slash\n    if (pathname.endsWith(\"/\") && pathname.length > 1) {\n      pathname = pathname.slice(0, -1);\n    }\n\n    return pathname.split(\"/\").slice(1);\n  }\n}\n\nexport interface RouteMatch<T extends Route> {\n  route?: T;\n  params?: Record<string, string>;\n}\n\nexport interface Route {\n  path: string;\n\n  /**\n   * Rename a param in the route.\n   * This is automatically filled when you have scenarios like:\n   * `/customers/:id` and `/customers/:userId/payments`\n   *\n   * In this case, `:id` will be renamed to `:userId` in the second route.\n   */\n  mapParams?: Record<string, string>;\n}\n\nexport interface Tree<T extends Route> {\n  route?: T;\n  children: {\n    [key: string]: Tree<T>;\n  };\n  param?: {\n    route?: T;\n    name: string;\n    children: {\n      [key: string]: Tree<T>;\n    };\n  };\n  wildcard?: {\n    route: T;\n  };\n}\n","import { AlephaError } from \"alepha\";\n\n/**\n * Parses and manipulates templated paths with `{param}` placeholders.\n *\n * Used by both RouterProvider (HTTP routes) and TopicProvider (pub/sub topics)\n * to handle parameterized path templates in a unified way.\n *\n * @example\n * ```ts\n * const parser = new TemplatedPathParser(\"/users/{userId}/posts/{postId}\");\n * parser.interpolate({ userId: \"7\", postId: \"42\" }); // \"/users/7/posts/42\"\n * parser.extract(\"/users/7/posts/42\");               // { userId: \"7\", postId: \"42\" }\n * parser.wildcardize(\"+\");                           // \"/users/+/posts/+\"\n * ```\n *\n * @example\n * ```ts\n * // Redis-style colon-separated keys\n * const parser = new TemplatedPathParser(\"cache:{namespace}:{key}\", \":\");\n * parser.interpolate({ namespace: \"users\", key: \"42\" }); // \"cache:users:42\"\n * parser.wildcardize(\"*\");                               // \"cache:*:*\"\n * ```\n */\nexport class TemplatedPathParser {\n  protected static readonly PARAM_REGEX = /\\{([^}]+)\\}/g;\n\n  public readonly template: string;\n  public readonly separator: string;\n  public readonly paramNames: readonly string[];\n  public readonly hasParams: boolean;\n  protected readonly extractRegex: RegExp | null;\n\n  constructor(template: string, separator = \"/\") {\n    if (separator.length !== 1) {\n      throw new AlephaError(\n        `TemplatedPathParser separator must be a single character, got '${separator}'`,\n      );\n    }\n    this.template = template;\n    this.separator = separator;\n    this.paramNames = [\n      ...template.matchAll(TemplatedPathParser.PARAM_REGEX),\n    ].map((m) => m[1]);\n    this.hasParams = this.paramNames.length > 0;\n    this.extractRegex = this.hasParams ? this.buildExtractRegex() : null;\n  }\n\n  /**\n   * Replaces each `{param}` in the template with the corresponding value\n   * from the provided params record.\n   */\n  interpolate(params: Record<string, string>): string {\n    return this.template.replace(\n      TemplatedPathParser.PARAM_REGEX,\n      (_, name: string) => params[name] ?? `{${name}}`,\n    );\n  }\n\n  /**\n   * Extracts parameter values from a concrete path by matching it against\n   * the template structure.\n   *\n   * Returns `null` when the path does not match the template.\n   * Returns `{}` when the template has no parameters and the path matches.\n   */\n  extract(path: string): Record<string, string> | null {\n    if (!this.extractRegex) {\n      return path === this.template ? {} : null;\n    }\n\n    const match = this.extractRegex.exec(path);\n    if (!match) {\n      return null;\n    }\n\n    const result: Record<string, string> = {};\n    for (let i = 0; i < this.paramNames.length; i++) {\n      result[this.paramNames[i]] = match[i + 1];\n    }\n    return result;\n  }\n\n  /**\n   * Replaces each `{param}` placeholder in the template with the given\n   * wildcard string. Defaults to `\"+\"` (MQTT-style).\n   */\n  wildcardize(wildcard = \"+\"): string {\n    return this.template.replace(TemplatedPathParser.PARAM_REGEX, wildcard);\n  }\n\n  /**\n   * Normalises a path by collapsing repeated separators and stripping a\n   * trailing separator (unless the path is just the separator itself).\n   */\n  normalize(path: string): string {\n    const sep = this.separator;\n    const escapedSep = this.escapeRegex(sep);\n\n    let result = path.replace(new RegExp(`${escapedSep}{2,}`, \"g\"), sep);\n\n    if (result.endsWith(sep) && result.length > sep.length) {\n      result = result.slice(0, -sep.length);\n    }\n\n    return result;\n  }\n\n  protected buildExtractRegex(): RegExp {\n    const escapedSeparator = this.escapeRegex(this.separator);\n\n    const regexSource = this.template\n      .replace(/[.*+?^${}()|[\\]\\\\]/g, (char) => {\n        if (char === \"{\" || char === \"}\") {\n          return char;\n        }\n        return `\\\\${char}`;\n      })\n      .replace(/\\{[^}]+\\}/g, `([^${escapedSeparator}]+)`);\n\n    return new RegExp(`^${regexSource}$`);\n  }\n\n  protected escapeRegex(s: string): string {\n    return s.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/router/providers/RouterProvider.ts","../../src/router/TemplatedPathParser.ts"],"sourcesContent":["import { AlephaError } from \"alepha\";\n\nexport abstract class RouterProvider<T extends Route = Route> {\n  protected routePathRegex: RegExp = /^\\/[A-Za-z0-9._~!$&%'()*+,;=:@{}?/-]*$/;\n\n  protected tree: Tree<T> = { children: {} };\n  protected cache = new Map<string, RouteMatch<T>>();\n  protected maxCacheSize = 10_000;\n\n  public match(path: string): RouteMatch<T> {\n    const pathname = path.split(\"?\", 1)[0];\n    const hit = this.cache.get(pathname);\n    if (hit) {\n      return { route: hit.route, params: { ...hit.params } };\n    }\n    const result = this.mapParams(this.createRouteMatch(pathname));\n    if (this.cache.size >= this.maxCacheSize) this.cache.clear();\n    this.cache.set(pathname, result);\n    return { route: result.route, params: { ...result.params } };\n  }\n\n  protected test(path: string): void {\n    if (!this.routePathRegex.test(path)) {\n      throw new AlephaError(`Route '${path}' is not valid`);\n    }\n  }\n\n  protected push(route: T): void {\n    const path = route.path.replaceAll(\"//\", \"/\");\n\n    this.test(path);\n    this.cache.clear();\n\n    const parts = this.createParts(path);\n\n    let cursor = this.tree;\n    for (let i = 0; i < parts.length; i++) {\n      const isLast = i === parts.length - 1;\n      let part = parts[i].toLowerCase(); // url is case-insensitive\n      if (part === \"*\" && isLast) {\n        cursor.wildcard = { route };\n        break;\n      }\n\n      if (part.includes(\"*\")) {\n        throw new AlephaError(`Route '${path}' has an invalid wildcard syntax`);\n      }\n\n      if (part.includes(\"{\") || part.includes(\"}\")) {\n        if (part.startsWith(\"{\") && part.endsWith(\"}\")) {\n          part = `:${part.slice(1, -1)}`; // convert {param} to :param\n        } else {\n          throw new AlephaError(`Route '${path}' has an invalid param syntax`);\n        }\n      }\n\n      if (part.startsWith(\":\")) {\n        const name = parts[i].slice(1).replaceAll(\"}\", \"\");\n        if (!name) {\n          throw new AlephaError(`Route '${path}' has an empty param name`);\n        }\n        if (!cursor.param) {\n          cursor.param = { name, children: {} };\n        } else if (cursor.param.name !== name) {\n          // damn, 2 url params with different names\n          // got this case with /customers/:id and /customers/:userId/payments\n          route.mapParams ??= {};\n          route.mapParams[cursor.param.name] = name;\n        }\n\n        if (isLast) {\n          cursor.param.route = route;\n        }\n\n        cursor = cursor.param;\n        continue;\n      }\n\n      if (!cursor.children[part]) {\n        cursor.children[part] = { children: {} };\n      }\n\n      if (isLast) {\n        cursor.children[part].route = route;\n      }\n\n      cursor = cursor.children[part];\n    }\n  }\n\n  protected createRouteMatch(path: string): RouteMatch<T> {\n    if (path[0] !== \"/\") {\n      throw new AlephaError(`Path '${path}' must start with \"/\"`);\n    }\n\n    const parts = this.createParts(path);\n\n    let cursor = this.tree;\n    let wildcard: { route: T } | undefined;\n    const params: Record<string, string> = {};\n\n    for (let i = 0; i < parts.length; i++) {\n      const part = parts[i].toLowerCase(); // url is case-insensitive\n      if (cursor.children[part]) {\n        if (cursor.wildcard) {\n          wildcard = cursor.wildcard;\n        }\n        cursor = cursor.children[part];\n      } else if (cursor.param) {\n        if (cursor.wildcard) {\n          wildcard = cursor.wildcard;\n        }\n        params[cursor.param.name] = parts[i];\n        cursor = cursor.param;\n      } else if (cursor.wildcard) {\n        params[\"*\"] = parts.slice(i).join(\"/\");\n        return { route: cursor.wildcard.route, params };\n      } else {\n        return { route: wildcard?.route, params };\n      }\n    }\n\n    if (!cursor?.route) {\n      // when \"/a/*\" - trigger if \"/a\"\n      if (cursor.wildcard) {\n        return { route: cursor.wildcard.route, params };\n      }\n      // return deep wildcard or nothing\n      return { route: wildcard?.route, params };\n    }\n\n    return { route: cursor.route, params };\n  }\n\n  protected mapParams(match: RouteMatch<T>): RouteMatch<T> {\n    if (match.route?.mapParams && match.params) {\n      for (const [key, value] of Object.entries(match.route.mapParams)) {\n        if (match.params[key]) {\n          match.params[value] = match.params[key];\n          delete match.params[key];\n        }\n      }\n    }\n\n    return match;\n  }\n\n  protected createParts(path: string): string[] {\n    let pathname = path.split(\"?\")[0].replaceAll(\"//\", \"/\");\n\n    // remove trailing slash\n    if (pathname.endsWith(\"/\") && pathname.length > 1) {\n      pathname = pathname.slice(0, -1);\n    }\n\n    return pathname.split(\"/\").slice(1);\n  }\n}\n\nexport interface RouteMatch<T extends Route> {\n  route?: T;\n  params?: Record<string, string>;\n}\n\nexport interface Route {\n  path: string;\n\n  /**\n   * Rename a param in the route.\n   * This is automatically filled when you have scenarios like:\n   * `/customers/:id` and `/customers/:userId/payments`\n   *\n   * In this case, `:id` will be renamed to `:userId` in the second route.\n   */\n  mapParams?: Record<string, string>;\n}\n\nexport interface Tree<T extends Route> {\n  route?: T;\n  children: {\n    [key: string]: Tree<T>;\n  };\n  param?: {\n    route?: T;\n    name: string;\n    children: {\n      [key: string]: Tree<T>;\n    };\n  };\n  wildcard?: {\n    route: T;\n  };\n}\n","import { AlephaError } from \"alepha\";\n\n/**\n * Parses and manipulates templated paths with `{param}` placeholders.\n *\n * Used by both RouterProvider (HTTP routes) and TopicProvider (pub/sub topics)\n * to handle parameterized path templates in a unified way.\n *\n * @example\n * ```ts\n * const parser = new TemplatedPathParser(\"/users/{userId}/posts/{postId}\");\n * parser.interpolate({ userId: \"7\", postId: \"42\" }); // \"/users/7/posts/42\"\n * parser.extract(\"/users/7/posts/42\");               // { userId: \"7\", postId: \"42\" }\n * parser.wildcardize(\"+\");                           // \"/users/+/posts/+\"\n * ```\n *\n * @example\n * ```ts\n * // Redis-style colon-separated keys\n * const parser = new TemplatedPathParser(\"cache:{namespace}:{key}\", \":\");\n * parser.interpolate({ namespace: \"users\", key: \"42\" }); // \"cache:users:42\"\n * parser.wildcardize(\"*\");                               // \"cache:*:*\"\n * ```\n */\nexport class TemplatedPathParser {\n  protected static readonly PARAM_REGEX = /\\{([^}]+)\\}/g;\n\n  public readonly template: string;\n  public readonly separator: string;\n  public readonly paramNames: readonly string[];\n  public readonly hasParams: boolean;\n  protected readonly extractRegex: RegExp | null;\n\n  constructor(template: string, separator = \"/\") {\n    if (separator.length !== 1) {\n      throw new AlephaError(\n        `TemplatedPathParser separator must be a single character, got '${separator}'`,\n      );\n    }\n    this.template = template;\n    this.separator = separator;\n    this.paramNames = [\n      ...template.matchAll(TemplatedPathParser.PARAM_REGEX),\n    ].map((m) => m[1]);\n    this.hasParams = this.paramNames.length > 0;\n    this.extractRegex = this.hasParams ? this.buildExtractRegex() : null;\n  }\n\n  /**\n   * Replaces each `{param}` in the template with the corresponding value\n   * from the provided params record.\n   */\n  interpolate(params: Record<string, string>): string {\n    return this.template.replace(\n      TemplatedPathParser.PARAM_REGEX,\n      (_, name: string) => params[name] ?? `{${name}}`,\n    );\n  }\n\n  /**\n   * Extracts parameter values from a concrete path by matching it against\n   * the template structure.\n   *\n   * Returns `null` when the path does not match the template.\n   * Returns `{}` when the template has no parameters and the path matches.\n   */\n  extract(path: string): Record<string, string> | null {\n    if (!this.extractRegex) {\n      return path === this.template ? {} : null;\n    }\n\n    const match = this.extractRegex.exec(path);\n    if (!match) {\n      return null;\n    }\n\n    const result: Record<string, string> = {};\n    for (let i = 0; i < this.paramNames.length; i++) {\n      result[this.paramNames[i]] = match[i + 1];\n    }\n    return result;\n  }\n\n  /**\n   * Replaces each `{param}` placeholder in the template with the given\n   * wildcard string. Defaults to `\"+\"` (MQTT-style).\n   */\n  wildcardize(wildcard = \"+\"): string {\n    return this.template.replace(TemplatedPathParser.PARAM_REGEX, wildcard);\n  }\n\n  /**\n   * Normalises a path by collapsing repeated separators and stripping a\n   * trailing separator (unless the path is just the separator itself).\n   */\n  normalize(path: string): string {\n    const sep = this.separator;\n    const escapedSep = this.escapeRegex(sep);\n\n    let result = path.replace(new RegExp(`${escapedSep}{2,}`, \"g\"), sep);\n\n    if (result.endsWith(sep) && result.length > sep.length) {\n      result = result.slice(0, -sep.length);\n    }\n\n    return result;\n  }\n\n  protected buildExtractRegex(): RegExp {\n    const escapedSeparator = this.escapeRegex(this.separator);\n\n    const regexSource = this.template\n      .replace(/[.*+?^${}()|[\\]\\\\]/g, (char) => {\n        if (char === \"{\" || char === \"}\") {\n          return char;\n        }\n        return `\\\\${char}`;\n      })\n      .replace(/\\{[^}]+\\}/g, `([^${escapedSeparator}]+)`);\n\n    return new RegExp(`^${regexSource}$`);\n  }\n\n  protected escapeRegex(s: string): string {\n    return s.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n  }\n}\n"],"mappings":"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"}

package/dist/scheduler/index.d.ts

@@ -2,6 +2,7 @@ import * as _$alepha from "alepha";
 import { Alepha, Async, KIND, Primitive, Static } from "alepha";
 import { DateTime, DateTimeProvider, DurationLike } from "alepha/datetime";
 import * as _$alepha_logger0 from "alepha/logger";
+import * as _$typebox from "typebox";
 
 //#region ../../src/scheduler/constants/CRON.d.ts
 declare const CRON: {
@@ -105,6 +106,13 @@ declare class CronProvider {
   getCronJobs(): Array<CronJob>;
   protected readonly start: _$alepha.HookPrimitive<"start">;
   protected readonly stop: _$alepha.HookPrimitive<"stop">;
+  /**
+   * Generic serverless cron trigger. Vercel's platform-emitted entry
+   * point fires `serverless:cron` with the job name; we run the matching
+   * job in-process. On long-running runtimes this listener is harmless
+   * (no one fires the event).
+   */
+  protected readonly onServerlessCron: _$alepha.HookPrimitive<"serverless:cron">;
   protected boot(name: string | CronJob): void;
   abort(name: string | CronJob): void;
   /**
@@ -183,8 +191,8 @@ type SchedulerPrimitiveOptions = {
 /**
  * Scheduler configuration atom.
  */
-declare const schedulerOptions: _$alepha.Atom<_$alepha.TObject<{
-  prefix: _$alepha.TOptional<_$alepha.TString>;
+declare const schedulerOptions: _$alepha.Atom<_$typebox.TObject<{
+  prefix: _$typebox.TOptional<_$typebox.TString>;
 }>, "alepha.scheduler.options">;
 type SchedulerAtomOptions = Static<typeof schedulerOptions.schema>;
 declare module "alepha" {
@@ -278,6 +286,21 @@ declare module "alepha" {
       name: string;
       context: string;
     };
+    /**
+     * Generic serverless cron trigger event.
+     *
+     * Emitted by serverless platform entry points (Vercel `/api/cron/...`,
+     * etc.) to trigger a registered cron job by name. `CronProvider`
+     * listens to this and calls `trigger(name)` so the same `$scheduler`
+     * / `$job({ cron })` declarations work across runtimes.
+     *
+     * Cloudflare Workers uses the platform-specific `cloudflare:scheduled`
+     * event instead (matched by cron expression), see
+     * `WorkerdCronProvider`.
+     */
+    "serverless:cron": {
+      name: string;
+    };
   }
 }
 /**

package/dist/scheduler/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":["ICronDefinition","Set","seconds","minutes","hours","days","months","weekdays","Cron","ReadonlyArray","Date","Generator","reversed","constructor","findAllowedHour","findAllowedMinute","findAllowedSecond","findAllowedTime","findAllowedDayInMonth","getNextDate","startDate","getNextDates","amount","getNextDatesIterator","endDate","getPrevDate","getPrevDates","getPrevDatesIterator","matchDate","date"],"sources":["../../src/scheduler/constants/CRON.ts","../../../../node_modules/cron-schedule/dist/cron.d.ts","../../src/scheduler/providers/CronProvider.ts","../../src/scheduler/primitives/$scheduler.ts","../../src/scheduler/providers/WorkerdCronProvider.ts","../../src/scheduler/index.ts"],"x_google_ignoreList":[1],"mappings":"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"}
+{"version":3,"file":"index.d.ts","names":["ICronDefinition","Set","seconds","minutes","hours","days","months","weekdays","Cron","ReadonlyArray","Date","Generator","reversed","constructor","findAllowedHour","findAllowedMinute","findAllowedSecond","findAllowedTime","findAllowedDayInMonth","getNextDate","startDate","getNextDates","amount","getNextDatesIterator","endDate","getPrevDate","getPrevDates","getPrevDatesIterator","matchDate","date"],"sources":["../../src/scheduler/constants/CRON.ts","../../../../node_modules/cron-schedule/dist/cron.d.ts","../../src/scheduler/providers/CronProvider.ts","../../src/scheduler/primitives/$scheduler.ts","../../src/scheduler/providers/WorkerdCronProvider.ts","../../src/scheduler/index.ts"],"x_google_ignoreList":[1],"mappings":"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"}

package/dist/scheduler/index.js

@@ -421,6 +421,18 @@ var CronProvider = class {
 			for (const cron of this.cronJobs) this.abort(cron);
 		}
 	});
+	/**
+	* Generic serverless cron trigger. Vercel's platform-emitted entry
+	* point fires `serverless:cron` with the job name; we run the matching
+	* job in-process. On long-running runtimes this listener is harmless
+	* (no one fires the event).
+	*/
+	onServerlessCron = $hook({
+		on: "serverless:cron",
+		handler: async ({ name }) => {
+			await this.trigger(name);
+		}
+	});
 	boot(name) {
 		const cron = typeof name === "string" ? this.cronJobs.find((c) => c.name === name) : name;
 		if (!cron) return;

package/dist/scheduler/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../../node_modules/cron-schedule/dist/utils.js","../../../../node_modules/cron-schedule/dist/cron.js","../../../../node_modules/cron-schedule/dist/cron-parser.js","../../src/scheduler/providers/CronProvider.ts","../../src/scheduler/primitives/$scheduler.ts","../../src/scheduler/constants/CRON.ts","../../src/scheduler/providers/WorkerdCronProvider.ts","../../src/scheduler/index.ts"],"sourcesContent":["export const TIMEOUT_MAX = 2147483647; // 2^31-1\n/**\n * Creates a new timeout, which can exceed the max timeout limit of 2^31-1.\n * Since multiple timeouts are used internally, the timeoutId used to clear the timeout\n * is returned as a handle (object) and changes whenever the max timeout limit is exceeded.\n * The handle parameter can be ignored, it is used internally for updating the timeoutId\n * in the handle after creating the next timeout.\n */\nexport function longTimeout(fn, timeout, previousHandle) {\n    let nextTimeout = timeout;\n    let remainingTimeout = 0;\n    if (nextTimeout > TIMEOUT_MAX) {\n        remainingTimeout = nextTimeout - TIMEOUT_MAX;\n        nextTimeout = TIMEOUT_MAX;\n    }\n    const handle = previousHandle !== null && previousHandle !== void 0 ? previousHandle : {\n        timeoutId: undefined,\n    };\n    handle.timeoutId = setTimeout(() => {\n        if (remainingTimeout > 0) {\n            longTimeout(fn, remainingTimeout, previousHandle);\n        }\n        else {\n            fn();\n        }\n    }, nextTimeout);\n    return handle;\n}\n/* Extracts second, minute, hour, date, month and the weekday from a date. */\nexport function extractDateElements(date) {\n    return {\n        second: date.getSeconds(),\n        minute: date.getMinutes(),\n        hour: date.getHours(),\n        day: date.getDate(),\n        month: date.getMonth(),\n        weekday: date.getDay(),\n        year: date.getFullYear(),\n    };\n}\n/* Gets the amount of days in the given month (indexed by 0) of the given year. */\nexport function getDaysInMonth(year, month) {\n    return new Date(year, month + 1, 0).getDate();\n}\n/* Gets the amount of days from weekday1 to weekday2. */\nexport function getDaysBetweenWeekdays(weekday1, weekday2) {\n    if (weekday1 <= weekday2) {\n        return weekday2 - weekday1;\n    }\n    return 6 - weekday1 + weekday2 + 1;\n}\nexport function wrapFunction(fn, errorHandler) {\n    return () => {\n        try {\n            const res = fn();\n            if (res instanceof Promise) {\n                res.catch((err) => {\n                    if (errorHandler) {\n                        errorHandler(err);\n                    }\n                });\n            }\n        }\n        catch (err) {\n            if (errorHandler) {\n                errorHandler(err);\n            }\n        }\n    };\n}\n//# sourceMappingURL=utils.js.map","import { extractDateElements, getDaysBetweenWeekdays, getDaysInMonth, } from './utils.js';\nexport class Cron {\n    constructor({ seconds, minutes, hours, days, months, weekdays, }) {\n        // Validate that there are values provided.\n        if (!seconds || seconds.size === 0)\n            throw new Error('There must be at least one allowed second.');\n        if (!minutes || minutes.size === 0)\n            throw new Error('There must be at least one allowed minute.');\n        if (!hours || hours.size === 0)\n            throw new Error('There must be at least one allowed hour.');\n        if (!months || months.size === 0)\n            throw new Error('There must be at least one allowed month.');\n        if ((!weekdays || weekdays.size === 0) && (!days || days.size === 0))\n            throw new Error('There must be at least one allowed day or weekday.');\n        // Convert set to array and sort in ascending order.\n        this.seconds = Array.from(seconds).sort((a, b) => a - b);\n        this.minutes = Array.from(minutes).sort((a, b) => a - b);\n        this.hours = Array.from(hours).sort((a, b) => a - b);\n        this.days = Array.from(days).sort((a, b) => a - b);\n        this.months = Array.from(months).sort((a, b) => a - b);\n        this.weekdays = Array.from(weekdays).sort((a, b) => a - b);\n        // Validate that all values are integers within the constraint.\n        const validateData = (name, data, constraint) => {\n            if (data.some((x) => typeof x !== 'number' ||\n                x % 1 !== 0 ||\n                x < constraint.min ||\n                x > constraint.max)) {\n                throw new Error(`${name} must only consist of integers which are within the range of ${constraint.min} and ${constraint.max}`);\n            }\n        };\n        validateData('seconds', this.seconds, { min: 0, max: 59 });\n        validateData('minutes', this.minutes, { min: 0, max: 59 });\n        validateData('hours', this.hours, { min: 0, max: 23 });\n        validateData('days', this.days, { min: 1, max: 31 });\n        validateData('months', this.months, { min: 0, max: 11 });\n        validateData('weekdays', this.weekdays, { min: 0, max: 6 });\n        // For each element, store a reversed copy in the reversed attribute for finding prev dates.\n        this.reversed = {\n            seconds: this.seconds.map((x) => x).reverse(),\n            minutes: this.minutes.map((x) => x).reverse(),\n            hours: this.hours.map((x) => x).reverse(),\n            days: this.days.map((x) => x).reverse(),\n            months: this.months.map((x) => x).reverse(),\n            weekdays: this.weekdays.map((x) => x).reverse(),\n        };\n    }\n    /**\n     * Find the next or previous hour, starting from the given start hour that matches the hour constraint.\n     * startHour itself might also be allowed.\n     */\n    findAllowedHour(dir, startHour) {\n        return dir === 'next'\n            ? this.hours.find((x) => x >= startHour)\n            : this.reversed.hours.find((x) => x <= startHour);\n    }\n    /**\n     * Find the next or previous minute, starting from the given start minute that matches the minute constraint.\n     * startMinute itself might also be allowed.\n     */\n    findAllowedMinute(dir, startMinute) {\n        return dir === 'next'\n            ? this.minutes.find((x) => x >= startMinute)\n            : this.reversed.minutes.find((x) => x <= startMinute);\n    }\n    /**\n     * Find the next or previous second, starting from the given start second that matches the second constraint.\n     * startSecond itself IS NOT allowed.\n     */\n    findAllowedSecond(dir, startSecond) {\n        return dir === 'next'\n            ? this.seconds.find((x) => x > startSecond)\n            : this.reversed.seconds.find((x) => x < startSecond);\n    }\n    /**\n     * Find the next or previous time, starting from the given start time that matches the hour, minute\n     * and second constraints. startTime itself might also be allowed.\n     */\n    findAllowedTime(dir, startTime) {\n        // Try to find an allowed hour.\n        let hour = this.findAllowedHour(dir, startTime.hour);\n        if (hour !== undefined) {\n            if (hour === startTime.hour) {\n                // We found an hour that is the start hour. Try to find an allowed minute.\n                let minute = this.findAllowedMinute(dir, startTime.minute);\n                if (minute !== undefined) {\n                    if (minute === startTime.minute) {\n                        // We found a minute that is the start minute. Try to find an allowed second.\n                        const second = this.findAllowedSecond(dir, startTime.second);\n                        if (second !== undefined) {\n                            // We found a second within the start hour and minute.\n                            return { hour, minute, second };\n                        }\n                        // We did not find a valid second within the start minute. Try to find another minute.\n                        minute = this.findAllowedMinute(dir, dir === 'next' ? startTime.minute + 1 : startTime.minute - 1);\n                        if (minute !== undefined) {\n                            // We found a minute which is not the start minute. Return that minute together with the hour and the first / last allowed second.\n                            return {\n                                hour,\n                                minute,\n                                second: dir === 'next' ? this.seconds[0] : this.reversed.seconds[0],\n                            };\n                        }\n                    }\n                    else {\n                        // We found a minute which is not the start minute. Return that minute together with the hour and the first / last allowed second.\n                        return {\n                            hour,\n                            minute,\n                            second: dir === 'next' ? this.seconds[0] : this.reversed.seconds[0],\n                        };\n                    }\n                }\n                // We did not find an allowed minute / second combination inside the start hour. Try to find the next / previous allowed hour.\n                hour = this.findAllowedHour(dir, dir === 'next' ? startTime.hour + 1 : startTime.hour - 1);\n                if (hour !== undefined) {\n                    // We found an allowed hour which is not the start hour. Return that hour together with the first / last allowed minutes / seconds.\n                    return {\n                        hour,\n                        minute: dir === 'next' ? this.minutes[0] : this.reversed.minutes[0],\n                        second: dir === 'next' ? this.seconds[0] : this.reversed.seconds[0],\n                    };\n                }\n            }\n            else {\n                // We found an allowed hour which is not the start hour. Return that hour together with the first / last allowed minutes / seconds.\n                return {\n                    hour,\n                    minute: dir === 'next' ? this.minutes[0] : this.reversed.minutes[0],\n                    second: dir === 'next' ? this.seconds[0] : this.reversed.seconds[0],\n                };\n            }\n        }\n        // No allowed time found.\n        return undefined;\n    }\n    /**\n     * Find the next or previous day in the given month, starting from the given startDay\n     * that matches either the day or the weekday constraint. startDay itself might also be allowed.\n     */\n    findAllowedDayInMonth(dir, year, month, startDay) {\n        var _a, _b;\n        if (startDay < 1)\n            throw new Error('startDay must not be smaller than 1.');\n        // If only days are restricted: allow day based on day constraint only.\n        // If only weekdays are restricted: allow day based on weekday constraint only.\n        // If both are restricted: allow day based on both day and weekday constraint. pick day that is closer to startDay.\n        // If none are restricted: return the day closest to startDay (respecting dir) that is allowed (or startDay itself).\n        const daysInMonth = getDaysInMonth(year, month);\n        const daysRestricted = this.days.length !== 31;\n        const weekdaysRestricted = this.weekdays.length !== 7;\n        if (!daysRestricted && !weekdaysRestricted) {\n            if (startDay > daysInMonth) {\n                return dir === 'next' ? undefined : daysInMonth;\n            }\n            return startDay;\n        }\n        // Try to find a day based on the days constraint.\n        let allowedDayByDays;\n        if (daysRestricted) {\n            allowedDayByDays =\n                dir === 'next'\n                    ? this.days.find((x) => x >= startDay)\n                    : this.reversed.days.find((x) => x <= startDay);\n            // Make sure the day does not exceed the amount of days in month.\n            if (allowedDayByDays !== undefined && allowedDayByDays > daysInMonth) {\n                allowedDayByDays = undefined;\n            }\n        }\n        // Try to find a day based on the weekday constraint.\n        let allowedDayByWeekdays;\n        if (weekdaysRestricted) {\n            const startWeekday = new Date(year, month, startDay).getDay();\n            const nearestAllowedWeekday = dir === 'next'\n                ? ((_a = this.weekdays.find((x) => x >= startWeekday)) !== null && _a !== void 0 ? _a : this.weekdays[0])\n                : ((_b = this.reversed.weekdays.find((x) => x <= startWeekday)) !== null && _b !== void 0 ? _b : this.reversed.weekdays[0]);\n            if (nearestAllowedWeekday !== undefined) {\n                const daysBetweenWeekdays = dir === 'next'\n                    ? getDaysBetweenWeekdays(startWeekday, nearestAllowedWeekday)\n                    : getDaysBetweenWeekdays(nearestAllowedWeekday, startWeekday);\n                allowedDayByWeekdays =\n                    dir === 'next'\n                        ? startDay + daysBetweenWeekdays\n                        : startDay - daysBetweenWeekdays;\n                // Make sure the day does not exceed the month boundaries.\n                if (allowedDayByWeekdays > daysInMonth || allowedDayByWeekdays < 1) {\n                    allowedDayByWeekdays = undefined;\n                }\n            }\n        }\n        if (allowedDayByDays !== undefined && allowedDayByWeekdays !== undefined) {\n            // If a day is found both via the days and the weekdays constraint, pick the day\n            // that is closer to start date.\n            return dir === 'next'\n                ? Math.min(allowedDayByDays, allowedDayByWeekdays)\n                : Math.max(allowedDayByDays, allowedDayByWeekdays);\n        }\n        if (allowedDayByDays !== undefined) {\n            return allowedDayByDays;\n        }\n        if (allowedDayByWeekdays !== undefined) {\n            return allowedDayByWeekdays;\n        }\n        return undefined;\n    }\n    /** Gets the next date starting from the given start date or now. */\n    getNextDate(startDate = new Date()) {\n        const startDateElements = extractDateElements(startDate);\n        let minYear = startDateElements.year;\n        let startIndexMonth = this.months.findIndex((x) => x >= startDateElements.month);\n        if (startIndexMonth === -1) {\n            startIndexMonth = 0;\n            minYear++;\n        }\n        // We try every month within the next 5 years to make sure that we tried to\n        // find a matching date insidde a whole leap year.\n        const maxIterations = this.months.length * 5;\n        for (let i = 0; i < maxIterations; i++) {\n            // Get the next year and month.\n            const year = minYear + Math.floor((startIndexMonth + i) / this.months.length);\n            const month = this.months[(startIndexMonth + i) % this.months.length];\n            const isStartMonth = year === startDateElements.year && month === startDateElements.month;\n            // Find the next day.\n            let day = this.findAllowedDayInMonth('next', year, month, isStartMonth ? startDateElements.day : 1);\n            let isStartDay = isStartMonth && day === startDateElements.day;\n            // If we found a day and it is the start day, try to find a valid time beginning from the start date time.\n            if (day !== undefined && isStartDay) {\n                const nextTime = this.findAllowedTime('next', startDateElements);\n                if (nextTime !== undefined) {\n                    return new Date(year, month, day, nextTime.hour, nextTime.minute, nextTime.second);\n                }\n                // If no valid time has been found for the start date, try the next day.\n                day = this.findAllowedDayInMonth('next', year, month, day + 1);\n                isStartDay = false;\n            }\n            // If we found a next day and it is not the start day, just use the next day with the first allowed values\n            // for hours, minutes and seconds.\n            if (day !== undefined && !isStartDay) {\n                return new Date(year, month, day, this.hours[0], this.minutes[0], this.seconds[0]);\n            }\n            // No allowed day has been found for this month. Continue to search in next month.\n        }\n        throw new Error('No valid next date was found.');\n    }\n    /** Gets the specified amount of future dates starting from the given start date or now. */\n    getNextDates(amount, startDate) {\n        const dates = [];\n        let nextDate;\n        for (let i = 0; i < amount; i++) {\n            nextDate = this.getNextDate(nextDate !== null && nextDate !== void 0 ? nextDate : startDate);\n            dates.push(nextDate);\n        }\n        return dates;\n    }\n    /**\n     * Get an ES6 compatible iterator which iterates over the next dates starting from startDate or now.\n     * The iterator runs until the optional endDate is reached or forever.\n     */\n    *getNextDatesIterator(startDate, endDate) {\n        let nextDate;\n        while (true) {\n            nextDate = this.getNextDate(nextDate !== null && nextDate !== void 0 ? nextDate : startDate);\n            if (endDate && endDate.getTime() < nextDate.getTime()) {\n                return;\n            }\n            yield nextDate;\n        }\n    }\n    /** Gets the previous date starting from the given start date or now. */\n    getPrevDate(startDate = new Date()) {\n        const startDateElements = extractDateElements(startDate);\n        let maxYear = startDateElements.year;\n        let startIndexMonth = this.reversed.months.findIndex((x) => x <= startDateElements.month);\n        if (startIndexMonth === -1) {\n            startIndexMonth = 0;\n            maxYear--;\n        }\n        // We try every month within the past 5 years to make sure that we tried to\n        // find a matching date inside a whole leap year.\n        const maxIterations = this.reversed.months.length * 5;\n        for (let i = 0; i < maxIterations; i++) {\n            // Get the next year and month.\n            const year = maxYear -\n                Math.floor((startIndexMonth + i) / this.reversed.months.length);\n            const month = this.reversed.months[(startIndexMonth + i) % this.reversed.months.length];\n            const isStartMonth = year === startDateElements.year && month === startDateElements.month;\n            // Find the previous day.\n            let day = this.findAllowedDayInMonth('prev', year, month, isStartMonth\n                ? startDateElements.day\n                : // Start searching from the last day of the month.\n                    getDaysInMonth(year, month));\n            let isStartDay = isStartMonth && day === startDateElements.day;\n            // If we found a day and it is the start day, try to find a valid time beginning from the start date time.\n            if (day !== undefined && isStartDay) {\n                const prevTime = this.findAllowedTime('prev', startDateElements);\n                if (prevTime !== undefined) {\n                    return new Date(year, month, day, prevTime.hour, prevTime.minute, prevTime.second);\n                }\n                // If no valid time has been found for the start date, try the previous day.\n                if (day > 1) {\n                    day = this.findAllowedDayInMonth('prev', year, month, day - 1);\n                    isStartDay = false;\n                }\n            }\n            // If we found a previous day and it is not the start day, just use the previous day with the first allowed values\n            // for hours, minutes and seconds (which will be the latest time due to using the reversed array).\n            if (day !== undefined && !isStartDay) {\n                return new Date(year, month, day, this.reversed.hours[0], this.reversed.minutes[0], this.reversed.seconds[0]);\n            }\n            // No allowed day has been found for this month. Continue to search in previous month.\n        }\n        throw new Error('No valid previous date was found.');\n    }\n    /** Gets the specified amount of previous dates starting from the given start date or now. */\n    getPrevDates(amount, startDate) {\n        const dates = [];\n        let prevDate;\n        for (let i = 0; i < amount; i++) {\n            prevDate = this.getPrevDate(prevDate !== null && prevDate !== void 0 ? prevDate : startDate);\n            dates.push(prevDate);\n        }\n        return dates;\n    }\n    /**\n     * Get an ES6 compatible iterator which iterates over the previous dates starting from startDate or now.\n     * The iterator runs until the optional endDate is reached or forever.\n     */\n    *getPrevDatesIterator(startDate, endDate) {\n        let prevDate;\n        while (true) {\n            prevDate = this.getPrevDate(prevDate !== null && prevDate !== void 0 ? prevDate : startDate);\n            if (endDate && endDate.getTime() > prevDate.getTime()) {\n                return;\n            }\n            yield prevDate;\n        }\n    }\n    /** Returns true when there is a cron date at the given date. */\n    matchDate(date) {\n        const { second, minute, hour, day, month, weekday } = extractDateElements(date);\n        if (this.seconds.indexOf(second) === -1 ||\n            this.minutes.indexOf(minute) === -1 ||\n            this.hours.indexOf(hour) === -1 ||\n            this.months.indexOf(month) === -1) {\n            return false;\n        }\n        if (this.days.length !== 31 && this.weekdays.length !== 7) {\n            return (this.days.indexOf(day) !== -1 || this.weekdays.indexOf(weekday) !== -1);\n        }\n        return (this.days.indexOf(day) !== -1 && this.weekdays.indexOf(weekday) !== -1);\n    }\n}\n//# sourceMappingURL=cron.js.map","import { Cron } from './cron.js';\nconst secondConstraint = {\n    min: 0,\n    max: 59,\n};\nconst minuteConstraint = {\n    min: 0,\n    max: 59,\n};\nconst hourConstraint = {\n    min: 0,\n    max: 23,\n};\nconst dayConstraint = {\n    min: 1,\n    max: 31,\n};\nconst monthConstraint = {\n    min: 1,\n    max: 12,\n    aliases: {\n        jan: '1',\n        feb: '2',\n        mar: '3',\n        apr: '4',\n        may: '5',\n        jun: '6',\n        jul: '7',\n        aug: '8',\n        sep: '9',\n        oct: '10',\n        nov: '11',\n        dec: '12',\n    },\n};\nconst weekdayConstraint = {\n    min: 0,\n    max: 7,\n    aliases: {\n        mon: '1',\n        tue: '2',\n        wed: '3',\n        thu: '4',\n        fri: '5',\n        sat: '6',\n        sun: '7',\n    },\n};\nconst timeNicknames = {\n    '@yearly': '0 0 1 1 *',\n    '@annually': '0 0 1 1 *',\n    '@monthly': '0 0 1 * *',\n    '@weekly': '0 0 * * 0',\n    '@daily': '0 0 * * *',\n    '@hourly': '0 * * * *',\n    '@minutely': '* * * * *',\n};\nfunction parseElement(element, constraint) {\n    const result = new Set();\n    // If returned set of numbers is empty, the scheduler class interpretes the emtpy set of numbers as all valid values of the constraint\n    if (element === '*') {\n        for (let i = constraint.min; i <= constraint.max; i = i + 1) {\n            result.add(i);\n        }\n        return result;\n    }\n    // If the element is a list, parse each element in the list.\n    const listElements = element.split(',');\n    if (listElements.length > 1) {\n        for (const listElement of listElements) {\n            const parsedListElement = parseElement(listElement, constraint);\n            for (const x of parsedListElement) {\n                result.add(x);\n            }\n        }\n        return result;\n    }\n    // Helper function to parse a single element, which includes checking for alias, valid number and constraint min and max.\n    const parseSingleElement = (singleElement) => {\n        var _a, _b;\n        singleElement =\n            (_b = (_a = constraint.aliases) === null || _a === void 0 ? void 0 : _a[singleElement.toLowerCase()]) !== null && _b !== void 0 ? _b : singleElement;\n        const parsedElement = Number.parseInt(singleElement, 10);\n        if (Number.isNaN(parsedElement)) {\n            throw new Error(`Failed to parse ${element}: ${singleElement} is NaN.`);\n        }\n        if (parsedElement < constraint.min || parsedElement > constraint.max) {\n            throw new Error(`Failed to parse ${element}: ${singleElement} is outside of constraint range of ${constraint.min} - ${constraint.max}.`);\n        }\n        return parsedElement;\n    };\n    // Detect if the element is a range.\n    // Possible range formats: 'start-end', 'start-end/step', '*', '*/step'.\n    // Where start and end can be numbers or aliases.\n    // Capture groups: 1: start-end, 2: start, 3: end, 4: /step, 5: step.\n    const rangeSegments = /^(([0-9a-zA-Z]+)-([0-9a-zA-Z]+)|\\*)(\\/([0-9]+))?$/.exec(element);\n    // If not, it must be a single element.\n    if (rangeSegments === null) {\n        result.add(parseSingleElement(element));\n        return result;\n    }\n    // If it is a range, get start and end of the range.\n    let parsedStart = rangeSegments[1] === '*'\n        ? constraint.min\n        : parseSingleElement(rangeSegments[2]);\n    const parsedEnd = rangeSegments[1] === '*'\n        ? constraint.max\n        : parseSingleElement(rangeSegments[3]);\n    // need to catch Sunday, which gets parsed here as 7, but is also legitimate at the start of a range as 0, to avoid the out of order error\n    if (constraint === weekdayConstraint &&\n        parsedStart === 7 &&\n        // this check ensures that sun-sun is not incorrectly parsed as [0,1,2,3,4,5,6]\n        parsedEnd !== 7) {\n        parsedStart = 0;\n    }\n    if (parsedStart > parsedEnd) {\n        throw new Error(`Failed to parse ${element}: Invalid range (start: ${parsedStart}, end: ${parsedEnd}).`);\n    }\n    // Check whether there is a custom step defined for the range, defaulting to 1.\n    const step = rangeSegments[5];\n    let parsedStep = 1;\n    if (step !== undefined) {\n        parsedStep = Number.parseInt(step, 10);\n        if (Number.isNaN(parsedStep)) {\n            throw new Error(`Failed to parse step: ${step} is NaN.`);\n        }\n        if (parsedStep < 1) {\n            throw new Error(`Failed to parse step: Expected ${step} to be greater than 0.`);\n        }\n    }\n    // Go from start to end of the range by the given steps.\n    for (let i = parsedStart; i <= parsedEnd; i = i + parsedStep) {\n        result.add(i);\n    }\n    return result;\n}\n/** Parses a cron expression into a Cron instance. */\nexport function parseCronExpression(cronExpression) {\n    var _a;\n    if (typeof cronExpression !== 'string') {\n        throw new TypeError('Invalid cron expression: must be of type string.');\n    }\n    // Convert time nicknames.\n    cronExpression = (_a = timeNicknames[cronExpression.toLowerCase()]) !== null && _a !== void 0 ? _a : cronExpression;\n    // Split the cron expression into its elements, removing empty elements (extra whitespaces).\n    const elements = cronExpression.split(' ').filter((elem) => elem.length > 0);\n    if (elements.length < 5 || elements.length > 6) {\n        throw new Error('Invalid cron expression: expected 5 or 6 elements.');\n    }\n    const rawSeconds = elements.length === 6 ? elements[0] : '0';\n    const rawMinutes = elements.length === 6 ? elements[1] : elements[0];\n    const rawHours = elements.length === 6 ? elements[2] : elements[1];\n    const rawDays = elements.length === 6 ? elements[3] : elements[2];\n    const rawMonths = elements.length === 6 ? elements[4] : elements[3];\n    const rawWeekdays = elements.length === 6 ? elements[5] : elements[4];\n    return new Cron({\n        seconds: parseElement(rawSeconds, secondConstraint),\n        minutes: parseElement(rawMinutes, minuteConstraint),\n        hours: parseElement(rawHours, hourConstraint),\n        days: parseElement(rawDays, dayConstraint),\n        // months in cron are indexed by 1, but Cron expects indexes by 0, so we need to reduce all set values by one.\n        months: new Set(Array.from(parseElement(rawMonths, monthConstraint)).map((x) => x - 1)),\n        weekdays: new Set(Array.from(parseElement(rawWeekdays, weekdayConstraint)).map((x) => x % 7)),\n    });\n}\n//# sourceMappingURL=cron-parser.js.map","import { $hook, $inject, Alepha } from \"alepha\";\nimport { type DateTime, DateTimeProvider } from \"alepha/datetime\";\nimport { $logger } from \"alepha/logger\";\nimport { type Cron, parseCronExpression } from \"cron-schedule\";\n\nexport class CronProvider {\n  protected readonly dt = $inject(DateTimeProvider);\n  protected readonly alepha = $inject(Alepha);\n  protected readonly log = $logger();\n  protected readonly cronJobs: Array<CronJob> = [];\n\n  public getCronJobs(): Array<CronJob> {\n    return this.cronJobs;\n  }\n\n  protected readonly start = $hook({\n    on: \"start\",\n    handler: () => {\n      if (this.alepha.isServerless()) {\n        this.log.info(\"Ignoring cron jobs in serverless environment\");\n        return;\n      }\n\n      for (const cron of this.cronJobs) {\n        if (!cron.running) {\n          cron.running = true;\n          this.log.debug(\n            `Starting cron task '${cron.name}' with '${cron.expression}'`,\n          );\n          this.run(cron);\n        }\n      }\n    },\n  });\n\n  protected readonly stop = $hook({\n    on: \"stop\",\n    handler: () => {\n      for (const cron of this.cronJobs) {\n        this.abort(cron);\n      }\n    },\n  });\n\n  protected boot(name: string | CronJob) {\n    const cron =\n      typeof name === \"string\"\n        ? this.cronJobs.find((c) => c.name === name)\n        : name;\n\n    if (!cron) {\n      return;\n    }\n\n    cron.running = true;\n\n    this.log.debug(\n      `Starting cron task '${cron.name}' with '${cron.expression}'`,\n    );\n\n    this.run(cron);\n  }\n\n  public abort(name: string | CronJob): void {\n    const cron =\n      typeof name === \"string\"\n        ? this.cronJobs.find((c) => c.name === name)\n        : name;\n\n    if (!cron?.running) {\n      return;\n    }\n\n    cron.running = false;\n    cron.abort?.abort();\n    this.log.debug(`Cron task '${cron.name}' stopped`);\n  }\n\n  /**\n   * Registers a cron job.\n   *\n   * It's automatically done when using the `$scheduler` primitive but can also be used manually.\n   */\n  public createCronJob(\n    name: string,\n    expression: string,\n    handler: (context: { now: DateTime }) => Promise<void>,\n    start?: boolean,\n  ): void {\n    const cron: CronJob = {\n      name,\n      cron: parseCronExpression(expression),\n      expression,\n      handler,\n      loop: true,\n      abort: new AbortController(),\n    };\n\n    this.cronJobs.push(cron);\n\n    if (start && this.alepha.isStarted()) {\n      this.boot(cron);\n    }\n  }\n\n  protected run(task: CronJob, now = this.dt.now()): void {\n    if (!task.running) {\n      return;\n    }\n\n    const [next] = task.cron.getNextDates(1, now.toDate());\n    if (!next) {\n      return;\n    }\n\n    const duration = next.getTime() - now.toDate().getTime();\n    const abort = new AbortController();\n    task.abort = abort;\n\n    this.dt\n      .wait(duration, {\n        now: now.valueOf(),\n        signal: abort.signal,\n      })\n      .then(() => {\n        if (!task.running) {\n          this.log.trace(\"Cron task stopped before execution\");\n          return;\n        }\n\n        this.log.trace(\"Running cron task\");\n\n        if (task.executing) {\n          this.log.warn(\n            `Cron task '${task.name}' is still running, skipping this invocation`,\n          );\n          if (task.loop) {\n            this.run(task, this.dt.of(next));\n          }\n          return;\n        }\n\n        task.executing = true;\n        task\n          .handler({ now: this.dt.of(next) })\n          .catch((err) => {\n            if (task.onError) {\n              task.onError(err);\n            } else {\n              this.log.error(\"Error in cron task:\", err);\n            }\n          })\n          .finally(() => {\n            task.executing = false;\n          });\n\n        if (task.loop) {\n          this.run(task, this.dt.of(next));\n        }\n      })\n      .catch((err) => {\n        this.log.warn(\"Issue during cron waiting timer\", err as Error);\n      });\n  }\n\n  /**\n   * Trigger a specific cron job by name.\n   */\n  public async trigger(name: string): Promise<void> {\n    const job = this.cronJobs.find((j) => j.name === name);\n    if (!job) {\n      this.log.warn(`Cron job '${name}' not found`);\n      return;\n    }\n    await this.runJobs([job], this.dt.now());\n  }\n\n  /**\n   * Trigger all registered cron jobs.\n   */\n  public async triggerAll(): Promise<void> {\n    await this.runJobs(this.cronJobs, this.dt.now());\n  }\n\n  /**\n   * Run multiple cron jobs in parallel.\n   */\n  protected async runJobs(jobs: CronJob[], now: DateTime): Promise<void> {\n    const results = await Promise.allSettled(\n      jobs.map(async (job) => {\n        this.log.debug(`Running cron job '${job.name}'`);\n        try {\n          await job.handler({ now });\n          this.log.debug(`Cron job '${job.name}' completed`);\n        } catch (error) {\n          this.log.error(`Cron job '${job.name}' failed`, error);\n          throw error;\n        }\n      }),\n    );\n\n    const failures = results.filter((r) => r.status === \"rejected\");\n    if (failures.length > 0) {\n      this.log.error(`${failures.length}/${jobs.length} cron jobs failed`);\n    }\n  }\n}\n\nexport interface CronJob {\n  name: string;\n  expression: string;\n  handler: (context: { now: DateTime }) => Promise<void>;\n  cron: Cron;\n  loop: boolean;\n  running?: boolean;\n  executing?: boolean;\n  onError?: (error: Error) => void;\n  abort?: AbortController;\n}\n","import {\n  $atom,\n  $inject,\n  $pipeline,\n  $state,\n  Alepha,\n  type Async,\n  createPrimitive,\n  KIND,\n  Primitive,\n  type Static,\n  t,\n} from \"alepha\";\nimport {\n  type DateTime,\n  DateTimeProvider,\n  type DurationLike,\n} from \"alepha/datetime\";\nimport { $lock } from \"alepha/lock\";\nimport { $logger } from \"alepha/logger\";\nimport { CronProvider } from \"../providers/CronProvider.ts\";\n\n/**\n * Scheduler primitive.\n */\nexport const $scheduler = (\n  options: SchedulerPrimitiveOptions,\n): SchedulerPrimitive => {\n  return createPrimitive(SchedulerPrimitive, options);\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport type SchedulerPrimitiveOptions = {\n  /**\n   * Function to run on schedule.\n   */\n  handler: (args: SchedulerHandlerArguments) => Async<void>;\n\n  /**\n   * Name of the scheduler. Defaults to the function name.\n   */\n  name?: string;\n\n  /**\n   * Optional description of the scheduler.\n   */\n  description?: string;\n\n  /**\n   * Cron expression or interval to run the scheduler.\n   */\n  cron?: string;\n\n  /**\n   * Cron expression or interval to run the scheduler.\n   */\n  interval?: DurationLike;\n\n  /**\n   * If true, the scheduler will be locked and only one instance will run at a time.\n   * You probably need to import {@link AlephaLockRedis} for distributed locking.\n   *\n   * @default true\n   */\n  lock?: boolean;\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Scheduler configuration atom.\n */\nexport const schedulerOptions = $atom({\n  name: \"alepha.scheduler.options\",\n  schema: t.object({\n    prefix: t.optional(\n      t.text({\n        description: \"Prefix for scheduler lock keys.\",\n      }),\n    ),\n  }),\n  default: {},\n});\n\nexport type SchedulerAtomOptions = Static<typeof schedulerOptions.schema>;\n\ndeclare module \"alepha\" {\n  interface State {\n    [schedulerOptions.key]: SchedulerAtomOptions;\n  }\n}\n\nexport class SchedulerPrimitive extends Primitive<SchedulerPrimitiveOptions> {\n  protected readonly log = $logger();\n  protected readonly settings = $state(schedulerOptions);\n  protected readonly alepha = $inject(Alepha);\n  protected readonly dateTimeProvider = $inject(DateTimeProvider);\n  protected readonly cronProvider = $inject(CronProvider);\n\n  public get name(): string {\n    return (\n      this.options.name ??\n      `${this.config.service.name}.${this.config.propertyKey}`\n    );\n  }\n\n  protected onInit() {\n    if (this.options.interval) {\n      this.dateTimeProvider.createInterval(\n        () => this.trigger(),\n        this.options.interval,\n      );\n    }\n    if (this.options.cron) {\n      this.cronProvider.createCronJob(this.name, this.options.cron, () =>\n        this.trigger(),\n      );\n    }\n  }\n\n  public async trigger(): Promise<void> {\n    if (!this.alepha.isStarted()) {\n      return;\n    }\n\n    const context = this.alepha.context.createContextId();\n\n    await this.alepha.context.run(\n      async () => {\n        try {\n          const now = this.dateTimeProvider.now();\n\n          await this.alepha.events.emit(\"scheduler:begin\", {\n            name: this.name,\n            now,\n            context,\n          });\n\n          if (this.options.lock !== false) {\n            await this.schedulerLock.run({ now });\n          } else {\n            await this.options.handler({ now });\n          }\n\n          await this.alepha.events.emit(\n            \"scheduler:success\",\n            {\n              name: this.name,\n              context,\n            },\n            {\n              catch: true,\n            },\n          );\n        } catch (error) {\n          await this.alepha.events.emit(\n            \"scheduler:error\",\n            {\n              name: this.name,\n              error: error as Error,\n              context,\n            },\n            {\n              catch: true,\n            },\n          );\n\n          this.log.error(\"Error running scheduler:\", error);\n        }\n\n        await this.alepha.events.emit(\n          \"scheduler:end\",\n          {\n            name: this.name,\n            context,\n          },\n          {\n            catch: true,\n          },\n        );\n      },\n      {\n        context,\n      },\n    );\n  }\n\n  protected schedulerLock = $pipeline({\n    use: [\n      $lock({\n        name: () => {\n          const prefix = this.settings.prefix ? `${this.settings.prefix}:` : \"\";\n          return `${prefix}scheduler:${this.name}`;\n        },\n      }),\n    ],\n    handler: async (args: SchedulerHandlerArguments) => {\n      await this.options.handler(args);\n    },\n  });\n}\n\n$scheduler[KIND] = SchedulerPrimitive;\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface SchedulerHandlerArguments {\n  now: DateTime;\n}\n","export const CRON = {\n  EVERY_MINUTE: \"* * * * *\",\n  EVERY_5_MINUTES: \"*/5 * * * *\",\n  EVERY_15_MINUTES: \"*/15 * * * *\",\n  EVERY_30_MINUTES: \"*/30 * * * *\",\n  EVERY_HOUR: \"0 * * * *\",\n  EVERY_DAY_AT_MIDNIGHT: \"0 0 * * *\",\n};\n","import { $hook } from \"alepha\";\nimport type { DateTime } from \"alepha/datetime\";\nimport { parseCronExpression } from \"cron-schedule\";\nimport { CronProvider } from \"./CronProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\ndeclare module \"alepha\" {\n  interface Hooks {\n    /**\n     * Cloudflare Workers scheduled event.\n     *\n     * Emitted when a cron trigger fires in Cloudflare Workers.\n     */\n    \"cloudflare:scheduled\": {\n      cron: string;\n      scheduledTime: number;\n    };\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Cloudflare Workers cron provider.\n *\n * This provider handles scheduled events from Cloudflare Workers Cron Triggers.\n * Unlike the Node.js CronProvider, this doesn't use intervals/timeouts - instead,\n * it reacts to scheduled events triggered by Cloudflare.\n *\n * **Usage:**\n * 1. Define schedulers with `$scheduler({ cron: \"0 * * * *\", handler: ... })`\n * 2. Build your app with `alepha build` - cron triggers are automatically added to `wrangler.jsonc`\n * 3. Deploy to Cloudflare Workers\n *\n * **How it works:**\n * - During build, all registered `$scheduler` cron expressions are collected\n * - The build generates `wrangler.jsonc` with `triggers.crons` automatically filled\n * - When Cloudflare fires a cron trigger, the `scheduled` handler emits `cloudflare:scheduled`\n * - This provider listens to that event and runs matching schedulers\n *\n * @see https://developers.cloudflare.com/workers/configuration/cron-triggers/\n */\nexport class WorkerdCronProvider extends CronProvider {\n  /**\n   * Override to avoid creating AbortController in global scope.\n   * Cloudflare Workers doesn't allow this during initialization.\n   */\n  public override createCronJob(\n    name: string,\n    expression: string,\n    handler: (context: { now: DateTime }) => Promise<void>,\n  ): void {\n    this.cronJobs.push({\n      name,\n      cron: parseCronExpression(expression),\n      expression,\n      handler,\n      loop: false,\n    });\n  }\n\n  /**\n   * Handle a scheduled event from Cloudflare Workers.\n   */\n  protected readonly onScheduledEvent = $hook({\n    on: \"cloudflare:scheduled\",\n    handler: async (event) => {\n      const now = this.dt.of(event.scheduledTime);\n\n      this.log.info(\"Received scheduled event\", {\n        cron: event.cron,\n        scheduledTime: now.format(),\n      });\n\n      // Find jobs that match this cron expression\n      const matchingJobs = this.cronJobs.filter(\n        (job) => job.expression === event.cron,\n      );\n\n      if (matchingJobs.length === 0) {\n        // No exact match - try to find jobs that would fire at this time\n        const matchingByTime = this.cronJobs.filter((job) =>\n          job.cron.matchDate(now.toDate()),\n        );\n\n        if (matchingByTime.length > 0) {\n          this.log.debug(\n            `No exact cron match for '${event.cron}', found ${matchingByTime.length} jobs matching by time`,\n          );\n          await this.runJobs(matchingByTime, now);\n          return;\n        }\n\n        this.log.warn(`No cron jobs found for expression '${event.cron}'`);\n        return;\n      }\n\n      await this.runJobs(matchingJobs, now);\n    },\n  });\n}\n","import { $module } from \"alepha\";\nimport type { DateTime } from \"alepha/datetime\";\nimport { AlephaLock } from \"alepha/lock\";\nimport { $scheduler } from \"./primitives/$scheduler.ts\";\nimport { CronProvider } from \"./providers/CronProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./constants/CRON.ts\";\nexport * from \"./primitives/$scheduler.ts\";\nexport * from \"./providers/CronProvider.ts\";\nexport * from \"./providers/WorkerdCronProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\ndeclare module \"alepha\" {\n  interface Hooks {\n    \"scheduler:begin\": {\n      name: string;\n      now: DateTime;\n      context: string;\n    };\n\n    \"scheduler:success\": { name: string; context: string };\n\n    \"scheduler:error\": {\n      name: string;\n      error: Error;\n      context: string;\n    };\n\n    \"scheduler:end\": { name: string; context: string };\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Cron and interval-based task execution.\n *\n * **Features:**\n * - Scheduled tasks with cron expressions (e.g., `0 0 * * *`)\n * - Interval-based scheduling\n * - Distributed locking to prevent duplicate execution\n * - Lifecycle hooks: `begin`, `success`, `error`, `end`\n *\n * @module alepha.scheduler\n */\nexport const AlephaScheduler = $module({\n  name: \"alepha.scheduler\",\n  primitives: [$scheduler],\n  services: [AlephaLock, CronProvider],\n});\n"],"x_google_ignoreList":[0,1,2],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../../node_modules/cron-schedule/dist/utils.js","../../../../node_modules/cron-schedule/dist/cron.js","../../../../node_modules/cron-schedule/dist/cron-parser.js","../../src/scheduler/providers/CronProvider.ts","../../src/scheduler/primitives/$scheduler.ts","../../src/scheduler/constants/CRON.ts","../../src/scheduler/providers/WorkerdCronProvider.ts","../../src/scheduler/index.ts"],"sourcesContent":["export const TIMEOUT_MAX = 2147483647; // 2^31-1\n/**\n * Creates a new timeout, which can exceed the max timeout limit of 2^31-1.\n * Since multiple timeouts are used internally, the timeoutId used to clear the timeout\n * is returned as a handle (object) and changes whenever the max timeout limit is exceeded.\n * The handle parameter can be ignored, it is used internally for updating the timeoutId\n * in the handle after creating the next timeout.\n */\nexport function longTimeout(fn, timeout, previousHandle) {\n    let nextTimeout = timeout;\n    let remainingTimeout = 0;\n    if (nextTimeout > TIMEOUT_MAX) {\n        remainingTimeout = nextTimeout - TIMEOUT_MAX;\n        nextTimeout = TIMEOUT_MAX;\n    }\n    const handle = previousHandle !== null && previousHandle !== void 0 ? previousHandle : {\n        timeoutId: undefined,\n    };\n    handle.timeoutId = setTimeout(() => {\n        if (remainingTimeout > 0) {\n            longTimeout(fn, remainingTimeout, previousHandle);\n        }\n        else {\n            fn();\n        }\n    }, nextTimeout);\n    return handle;\n}\n/* Extracts second, minute, hour, date, month and the weekday from a date. */\nexport function extractDateElements(date) {\n    return {\n        second: date.getSeconds(),\n        minute: date.getMinutes(),\n        hour: date.getHours(),\n        day: date.getDate(),\n        month: date.getMonth(),\n        weekday: date.getDay(),\n        year: date.getFullYear(),\n    };\n}\n/* Gets the amount of days in the given month (indexed by 0) of the given year. */\nexport function getDaysInMonth(year, month) {\n    return new Date(year, month + 1, 0).getDate();\n}\n/* Gets the amount of days from weekday1 to weekday2. */\nexport function getDaysBetweenWeekdays(weekday1, weekday2) {\n    if (weekday1 <= weekday2) {\n        return weekday2 - weekday1;\n    }\n    return 6 - weekday1 + weekday2 + 1;\n}\nexport function wrapFunction(fn, errorHandler) {\n    return () => {\n        try {\n            const res = fn();\n            if (res instanceof Promise) {\n                res.catch((err) => {\n                    if (errorHandler) {\n                        errorHandler(err);\n                    }\n                });\n            }\n        }\n        catch (err) {\n            if (errorHandler) {\n                errorHandler(err);\n            }\n        }\n    };\n}\n//# sourceMappingURL=utils.js.map","import { extractDateElements, getDaysBetweenWeekdays, getDaysInMonth, } from './utils.js';\nexport class Cron {\n    constructor({ seconds, minutes, hours, days, months, weekdays, }) {\n        // Validate that there are values provided.\n        if (!seconds || seconds.size === 0)\n            throw new Error('There must be at least one allowed second.');\n        if (!minutes || minutes.size === 0)\n            throw new Error('There must be at least one allowed minute.');\n        if (!hours || hours.size === 0)\n            throw new Error('There must be at least one allowed hour.');\n        if (!months || months.size === 0)\n            throw new Error('There must be at least one allowed month.');\n        if ((!weekdays || weekdays.size === 0) && (!days || days.size === 0))\n            throw new Error('There must be at least one allowed day or weekday.');\n        // Convert set to array and sort in ascending order.\n        this.seconds = Array.from(seconds).sort((a, b) => a - b);\n        this.minutes = Array.from(minutes).sort((a, b) => a - b);\n        this.hours = Array.from(hours).sort((a, b) => a - b);\n        this.days = Array.from(days).sort((a, b) => a - b);\n        this.months = Array.from(months).sort((a, b) => a - b);\n        this.weekdays = Array.from(weekdays).sort((a, b) => a - b);\n        // Validate that all values are integers within the constraint.\n        const validateData = (name, data, constraint) => {\n            if (data.some((x) => typeof x !== 'number' ||\n                x % 1 !== 0 ||\n                x < constraint.min ||\n                x > constraint.max)) {\n                throw new Error(`${name} must only consist of integers which are within the range of ${constraint.min} and ${constraint.max}`);\n            }\n        };\n        validateData('seconds', this.seconds, { min: 0, max: 59 });\n        validateData('minutes', this.minutes, { min: 0, max: 59 });\n        validateData('hours', this.hours, { min: 0, max: 23 });\n        validateData('days', this.days, { min: 1, max: 31 });\n        validateData('months', this.months, { min: 0, max: 11 });\n        validateData('weekdays', this.weekdays, { min: 0, max: 6 });\n        // For each element, store a reversed copy in the reversed attribute for finding prev dates.\n        this.reversed = {\n            seconds: this.seconds.map((x) => x).reverse(),\n            minutes: this.minutes.map((x) => x).reverse(),\n            hours: this.hours.map((x) => x).reverse(),\n            days: this.days.map((x) => x).reverse(),\n            months: this.months.map((x) => x).reverse(),\n            weekdays: this.weekdays.map((x) => x).reverse(),\n        };\n    }\n    /**\n     * Find the next or previous hour, starting from the given start hour that matches the hour constraint.\n     * startHour itself might also be allowed.\n     */\n    findAllowedHour(dir, startHour) {\n        return dir === 'next'\n            ? this.hours.find((x) => x >= startHour)\n            : this.reversed.hours.find((x) => x <= startHour);\n    }\n    /**\n     * Find the next or previous minute, starting from the given start minute that matches the minute constraint.\n     * startMinute itself might also be allowed.\n     */\n    findAllowedMinute(dir, startMinute) {\n        return dir === 'next'\n            ? this.minutes.find((x) => x >= startMinute)\n            : this.reversed.minutes.find((x) => x <= startMinute);\n    }\n    /**\n     * Find the next or previous second, starting from the given start second that matches the second constraint.\n     * startSecond itself IS NOT allowed.\n     */\n    findAllowedSecond(dir, startSecond) {\n        return dir === 'next'\n            ? this.seconds.find((x) => x > startSecond)\n            : this.reversed.seconds.find((x) => x < startSecond);\n    }\n    /**\n     * Find the next or previous time, starting from the given start time that matches the hour, minute\n     * and second constraints. startTime itself might also be allowed.\n     */\n    findAllowedTime(dir, startTime) {\n        // Try to find an allowed hour.\n        let hour = this.findAllowedHour(dir, startTime.hour);\n        if (hour !== undefined) {\n            if (hour === startTime.hour) {\n                // We found an hour that is the start hour. Try to find an allowed minute.\n                let minute = this.findAllowedMinute(dir, startTime.minute);\n                if (minute !== undefined) {\n                    if (minute === startTime.minute) {\n                        // We found a minute that is the start minute. Try to find an allowed second.\n                        const second = this.findAllowedSecond(dir, startTime.second);\n                        if (second !== undefined) {\n                            // We found a second within the start hour and minute.\n                            return { hour, minute, second };\n                        }\n                        // We did not find a valid second within the start minute. Try to find another minute.\n                        minute = this.findAllowedMinute(dir, dir === 'next' ? startTime.minute + 1 : startTime.minute - 1);\n                        if (minute !== undefined) {\n                            // We found a minute which is not the start minute. Return that minute together with the hour and the first / last allowed second.\n                            return {\n                                hour,\n                                minute,\n                                second: dir === 'next' ? this.seconds[0] : this.reversed.seconds[0],\n                            };\n                        }\n                    }\n                    else {\n                        // We found a minute which is not the start minute. Return that minute together with the hour and the first / last allowed second.\n                        return {\n                            hour,\n                            minute,\n                            second: dir === 'next' ? this.seconds[0] : this.reversed.seconds[0],\n                        };\n                    }\n                }\n                // We did not find an allowed minute / second combination inside the start hour. Try to find the next / previous allowed hour.\n                hour = this.findAllowedHour(dir, dir === 'next' ? startTime.hour + 1 : startTime.hour - 1);\n                if (hour !== undefined) {\n                    // We found an allowed hour which is not the start hour. Return that hour together with the first / last allowed minutes / seconds.\n                    return {\n                        hour,\n                        minute: dir === 'next' ? this.minutes[0] : this.reversed.minutes[0],\n                        second: dir === 'next' ? this.seconds[0] : this.reversed.seconds[0],\n                    };\n                }\n            }\n            else {\n                // We found an allowed hour which is not the start hour. Return that hour together with the first / last allowed minutes / seconds.\n                return {\n                    hour,\n                    minute: dir === 'next' ? this.minutes[0] : this.reversed.minutes[0],\n                    second: dir === 'next' ? this.seconds[0] : this.reversed.seconds[0],\n                };\n            }\n        }\n        // No allowed time found.\n        return undefined;\n    }\n    /**\n     * Find the next or previous day in the given month, starting from the given startDay\n     * that matches either the day or the weekday constraint. startDay itself might also be allowed.\n     */\n    findAllowedDayInMonth(dir, year, month, startDay) {\n        var _a, _b;\n        if (startDay < 1)\n            throw new Error('startDay must not be smaller than 1.');\n        // If only days are restricted: allow day based on day constraint only.\n        // If only weekdays are restricted: allow day based on weekday constraint only.\n        // If both are restricted: allow day based on both day and weekday constraint. pick day that is closer to startDay.\n        // If none are restricted: return the day closest to startDay (respecting dir) that is allowed (or startDay itself).\n        const daysInMonth = getDaysInMonth(year, month);\n        const daysRestricted = this.days.length !== 31;\n        const weekdaysRestricted = this.weekdays.length !== 7;\n        if (!daysRestricted && !weekdaysRestricted) {\n            if (startDay > daysInMonth) {\n                return dir === 'next' ? undefined : daysInMonth;\n            }\n            return startDay;\n        }\n        // Try to find a day based on the days constraint.\n        let allowedDayByDays;\n        if (daysRestricted) {\n            allowedDayByDays =\n                dir === 'next'\n                    ? this.days.find((x) => x >= startDay)\n                    : this.reversed.days.find((x) => x <= startDay);\n            // Make sure the day does not exceed the amount of days in month.\n            if (allowedDayByDays !== undefined && allowedDayByDays > daysInMonth) {\n                allowedDayByDays = undefined;\n            }\n        }\n        // Try to find a day based on the weekday constraint.\n        let allowedDayByWeekdays;\n        if (weekdaysRestricted) {\n            const startWeekday = new Date(year, month, startDay).getDay();\n            const nearestAllowedWeekday = dir === 'next'\n                ? ((_a = this.weekdays.find((x) => x >= startWeekday)) !== null && _a !== void 0 ? _a : this.weekdays[0])\n                : ((_b = this.reversed.weekdays.find((x) => x <= startWeekday)) !== null && _b !== void 0 ? _b : this.reversed.weekdays[0]);\n            if (nearestAllowedWeekday !== undefined) {\n                const daysBetweenWeekdays = dir === 'next'\n                    ? getDaysBetweenWeekdays(startWeekday, nearestAllowedWeekday)\n                    : getDaysBetweenWeekdays(nearestAllowedWeekday, startWeekday);\n                allowedDayByWeekdays =\n                    dir === 'next'\n                        ? startDay + daysBetweenWeekdays\n                        : startDay - daysBetweenWeekdays;\n                // Make sure the day does not exceed the month boundaries.\n                if (allowedDayByWeekdays > daysInMonth || allowedDayByWeekdays < 1) {\n                    allowedDayByWeekdays = undefined;\n                }\n            }\n        }\n        if (allowedDayByDays !== undefined && allowedDayByWeekdays !== undefined) {\n            // If a day is found both via the days and the weekdays constraint, pick the day\n            // that is closer to start date.\n            return dir === 'next'\n                ? Math.min(allowedDayByDays, allowedDayByWeekdays)\n                : Math.max(allowedDayByDays, allowedDayByWeekdays);\n        }\n        if (allowedDayByDays !== undefined) {\n            return allowedDayByDays;\n        }\n        if (allowedDayByWeekdays !== undefined) {\n            return allowedDayByWeekdays;\n        }\n        return undefined;\n    }\n    /** Gets the next date starting from the given start date or now. */\n    getNextDate(startDate = new Date()) {\n        const startDateElements = extractDateElements(startDate);\n        let minYear = startDateElements.year;\n        let startIndexMonth = this.months.findIndex((x) => x >= startDateElements.month);\n        if (startIndexMonth === -1) {\n            startIndexMonth = 0;\n            minYear++;\n        }\n        // We try every month within the next 5 years to make sure that we tried to\n        // find a matching date insidde a whole leap year.\n        const maxIterations = this.months.length * 5;\n        for (let i = 0; i < maxIterations; i++) {\n            // Get the next year and month.\n            const year = minYear + Math.floor((startIndexMonth + i) / this.months.length);\n            const month = this.months[(startIndexMonth + i) % this.months.length];\n            const isStartMonth = year === startDateElements.year && month === startDateElements.month;\n            // Find the next day.\n            let day = this.findAllowedDayInMonth('next', year, month, isStartMonth ? startDateElements.day : 1);\n            let isStartDay = isStartMonth && day === startDateElements.day;\n            // If we found a day and it is the start day, try to find a valid time beginning from the start date time.\n            if (day !== undefined && isStartDay) {\n                const nextTime = this.findAllowedTime('next', startDateElements);\n                if (nextTime !== undefined) {\n                    return new Date(year, month, day, nextTime.hour, nextTime.minute, nextTime.second);\n                }\n                // If no valid time has been found for the start date, try the next day.\n                day = this.findAllowedDayInMonth('next', year, month, day + 1);\n                isStartDay = false;\n            }\n            // If we found a next day and it is not the start day, just use the next day with the first allowed values\n            // for hours, minutes and seconds.\n            if (day !== undefined && !isStartDay) {\n                return new Date(year, month, day, this.hours[0], this.minutes[0], this.seconds[0]);\n            }\n            // No allowed day has been found for this month. Continue to search in next month.\n        }\n        throw new Error('No valid next date was found.');\n    }\n    /** Gets the specified amount of future dates starting from the given start date or now. */\n    getNextDates(amount, startDate) {\n        const dates = [];\n        let nextDate;\n        for (let i = 0; i < amount; i++) {\n            nextDate = this.getNextDate(nextDate !== null && nextDate !== void 0 ? nextDate : startDate);\n            dates.push(nextDate);\n        }\n        return dates;\n    }\n    /**\n     * Get an ES6 compatible iterator which iterates over the next dates starting from startDate or now.\n     * The iterator runs until the optional endDate is reached or forever.\n     */\n    *getNextDatesIterator(startDate, endDate) {\n        let nextDate;\n        while (true) {\n            nextDate = this.getNextDate(nextDate !== null && nextDate !== void 0 ? nextDate : startDate);\n            if (endDate && endDate.getTime() < nextDate.getTime()) {\n                return;\n            }\n            yield nextDate;\n        }\n    }\n    /** Gets the previous date starting from the given start date or now. */\n    getPrevDate(startDate = new Date()) {\n        const startDateElements = extractDateElements(startDate);\n        let maxYear = startDateElements.year;\n        let startIndexMonth = this.reversed.months.findIndex((x) => x <= startDateElements.month);\n        if (startIndexMonth === -1) {\n            startIndexMonth = 0;\n            maxYear--;\n        }\n        // We try every month within the past 5 years to make sure that we tried to\n        // find a matching date inside a whole leap year.\n        const maxIterations = this.reversed.months.length * 5;\n        for (let i = 0; i < maxIterations; i++) {\n            // Get the next year and month.\n            const year = maxYear -\n                Math.floor((startIndexMonth + i) / this.reversed.months.length);\n            const month = this.reversed.months[(startIndexMonth + i) % this.reversed.months.length];\n            const isStartMonth = year === startDateElements.year && month === startDateElements.month;\n            // Find the previous day.\n            let day = this.findAllowedDayInMonth('prev', year, month, isStartMonth\n                ? startDateElements.day\n                : // Start searching from the last day of the month.\n                    getDaysInMonth(year, month));\n            let isStartDay = isStartMonth && day === startDateElements.day;\n            // If we found a day and it is the start day, try to find a valid time beginning from the start date time.\n            if (day !== undefined && isStartDay) {\n                const prevTime = this.findAllowedTime('prev', startDateElements);\n                if (prevTime !== undefined) {\n                    return new Date(year, month, day, prevTime.hour, prevTime.minute, prevTime.second);\n                }\n                // If no valid time has been found for the start date, try the previous day.\n                if (day > 1) {\n                    day = this.findAllowedDayInMonth('prev', year, month, day - 1);\n                    isStartDay = false;\n                }\n            }\n            // If we found a previous day and it is not the start day, just use the previous day with the first allowed values\n            // for hours, minutes and seconds (which will be the latest time due to using the reversed array).\n            if (day !== undefined && !isStartDay) {\n                return new Date(year, month, day, this.reversed.hours[0], this.reversed.minutes[0], this.reversed.seconds[0]);\n            }\n            // No allowed day has been found for this month. Continue to search in previous month.\n        }\n        throw new Error('No valid previous date was found.');\n    }\n    /** Gets the specified amount of previous dates starting from the given start date or now. */\n    getPrevDates(amount, startDate) {\n        const dates = [];\n        let prevDate;\n        for (let i = 0; i < amount; i++) {\n            prevDate = this.getPrevDate(prevDate !== null && prevDate !== void 0 ? prevDate : startDate);\n            dates.push(prevDate);\n        }\n        return dates;\n    }\n    /**\n     * Get an ES6 compatible iterator which iterates over the previous dates starting from startDate or now.\n     * The iterator runs until the optional endDate is reached or forever.\n     */\n    *getPrevDatesIterator(startDate, endDate) {\n        let prevDate;\n        while (true) {\n            prevDate = this.getPrevDate(prevDate !== null && prevDate !== void 0 ? prevDate : startDate);\n            if (endDate && endDate.getTime() > prevDate.getTime()) {\n                return;\n            }\n            yield prevDate;\n        }\n    }\n    /** Returns true when there is a cron date at the given date. */\n    matchDate(date) {\n        const { second, minute, hour, day, month, weekday } = extractDateElements(date);\n        if (this.seconds.indexOf(second) === -1 ||\n            this.minutes.indexOf(minute) === -1 ||\n            this.hours.indexOf(hour) === -1 ||\n            this.months.indexOf(month) === -1) {\n            return false;\n        }\n        if (this.days.length !== 31 && this.weekdays.length !== 7) {\n            return (this.days.indexOf(day) !== -1 || this.weekdays.indexOf(weekday) !== -1);\n        }\n        return (this.days.indexOf(day) !== -1 && this.weekdays.indexOf(weekday) !== -1);\n    }\n}\n//# sourceMappingURL=cron.js.map","import { Cron } from './cron.js';\nconst secondConstraint = {\n    min: 0,\n    max: 59,\n};\nconst minuteConstraint = {\n    min: 0,\n    max: 59,\n};\nconst hourConstraint = {\n    min: 0,\n    max: 23,\n};\nconst dayConstraint = {\n    min: 1,\n    max: 31,\n};\nconst monthConstraint = {\n    min: 1,\n    max: 12,\n    aliases: {\n        jan: '1',\n        feb: '2',\n        mar: '3',\n        apr: '4',\n        may: '5',\n        jun: '6',\n        jul: '7',\n        aug: '8',\n        sep: '9',\n        oct: '10',\n        nov: '11',\n        dec: '12',\n    },\n};\nconst weekdayConstraint = {\n    min: 0,\n    max: 7,\n    aliases: {\n        mon: '1',\n        tue: '2',\n        wed: '3',\n        thu: '4',\n        fri: '5',\n        sat: '6',\n        sun: '7',\n    },\n};\nconst timeNicknames = {\n    '@yearly': '0 0 1 1 *',\n    '@annually': '0 0 1 1 *',\n    '@monthly': '0 0 1 * *',\n    '@weekly': '0 0 * * 0',\n    '@daily': '0 0 * * *',\n    '@hourly': '0 * * * *',\n    '@minutely': '* * * * *',\n};\nfunction parseElement(element, constraint) {\n    const result = new Set();\n    // If returned set of numbers is empty, the scheduler class interpretes the emtpy set of numbers as all valid values of the constraint\n    if (element === '*') {\n        for (let i = constraint.min; i <= constraint.max; i = i + 1) {\n            result.add(i);\n        }\n        return result;\n    }\n    // If the element is a list, parse each element in the list.\n    const listElements = element.split(',');\n    if (listElements.length > 1) {\n        for (const listElement of listElements) {\n            const parsedListElement = parseElement(listElement, constraint);\n            for (const x of parsedListElement) {\n                result.add(x);\n            }\n        }\n        return result;\n    }\n    // Helper function to parse a single element, which includes checking for alias, valid number and constraint min and max.\n    const parseSingleElement = (singleElement) => {\n        var _a, _b;\n        singleElement =\n            (_b = (_a = constraint.aliases) === null || _a === void 0 ? void 0 : _a[singleElement.toLowerCase()]) !== null && _b !== void 0 ? _b : singleElement;\n        const parsedElement = Number.parseInt(singleElement, 10);\n        if (Number.isNaN(parsedElement)) {\n            throw new Error(`Failed to parse ${element}: ${singleElement} is NaN.`);\n        }\n        if (parsedElement < constraint.min || parsedElement > constraint.max) {\n            throw new Error(`Failed to parse ${element}: ${singleElement} is outside of constraint range of ${constraint.min} - ${constraint.max}.`);\n        }\n        return parsedElement;\n    };\n    // Detect if the element is a range.\n    // Possible range formats: 'start-end', 'start-end/step', '*', '*/step'.\n    // Where start and end can be numbers or aliases.\n    // Capture groups: 1: start-end, 2: start, 3: end, 4: /step, 5: step.\n    const rangeSegments = /^(([0-9a-zA-Z]+)-([0-9a-zA-Z]+)|\\*)(\\/([0-9]+))?$/.exec(element);\n    // If not, it must be a single element.\n    if (rangeSegments === null) {\n        result.add(parseSingleElement(element));\n        return result;\n    }\n    // If it is a range, get start and end of the range.\n    let parsedStart = rangeSegments[1] === '*'\n        ? constraint.min\n        : parseSingleElement(rangeSegments[2]);\n    const parsedEnd = rangeSegments[1] === '*'\n        ? constraint.max\n        : parseSingleElement(rangeSegments[3]);\n    // need to catch Sunday, which gets parsed here as 7, but is also legitimate at the start of a range as 0, to avoid the out of order error\n    if (constraint === weekdayConstraint &&\n        parsedStart === 7 &&\n        // this check ensures that sun-sun is not incorrectly parsed as [0,1,2,3,4,5,6]\n        parsedEnd !== 7) {\n        parsedStart = 0;\n    }\n    if (parsedStart > parsedEnd) {\n        throw new Error(`Failed to parse ${element}: Invalid range (start: ${parsedStart}, end: ${parsedEnd}).`);\n    }\n    // Check whether there is a custom step defined for the range, defaulting to 1.\n    const step = rangeSegments[5];\n    let parsedStep = 1;\n    if (step !== undefined) {\n        parsedStep = Number.parseInt(step, 10);\n        if (Number.isNaN(parsedStep)) {\n            throw new Error(`Failed to parse step: ${step} is NaN.`);\n        }\n        if (parsedStep < 1) {\n            throw new Error(`Failed to parse step: Expected ${step} to be greater than 0.`);\n        }\n    }\n    // Go from start to end of the range by the given steps.\n    for (let i = parsedStart; i <= parsedEnd; i = i + parsedStep) {\n        result.add(i);\n    }\n    return result;\n}\n/** Parses a cron expression into a Cron instance. */\nexport function parseCronExpression(cronExpression) {\n    var _a;\n    if (typeof cronExpression !== 'string') {\n        throw new TypeError('Invalid cron expression: must be of type string.');\n    }\n    // Convert time nicknames.\n    cronExpression = (_a = timeNicknames[cronExpression.toLowerCase()]) !== null && _a !== void 0 ? _a : cronExpression;\n    // Split the cron expression into its elements, removing empty elements (extra whitespaces).\n    const elements = cronExpression.split(' ').filter((elem) => elem.length > 0);\n    if (elements.length < 5 || elements.length > 6) {\n        throw new Error('Invalid cron expression: expected 5 or 6 elements.');\n    }\n    const rawSeconds = elements.length === 6 ? elements[0] : '0';\n    const rawMinutes = elements.length === 6 ? elements[1] : elements[0];\n    const rawHours = elements.length === 6 ? elements[2] : elements[1];\n    const rawDays = elements.length === 6 ? elements[3] : elements[2];\n    const rawMonths = elements.length === 6 ? elements[4] : elements[3];\n    const rawWeekdays = elements.length === 6 ? elements[5] : elements[4];\n    return new Cron({\n        seconds: parseElement(rawSeconds, secondConstraint),\n        minutes: parseElement(rawMinutes, minuteConstraint),\n        hours: parseElement(rawHours, hourConstraint),\n        days: parseElement(rawDays, dayConstraint),\n        // months in cron are indexed by 1, but Cron expects indexes by 0, so we need to reduce all set values by one.\n        months: new Set(Array.from(parseElement(rawMonths, monthConstraint)).map((x) => x - 1)),\n        weekdays: new Set(Array.from(parseElement(rawWeekdays, weekdayConstraint)).map((x) => x % 7)),\n    });\n}\n//# sourceMappingURL=cron-parser.js.map","import { $hook, $inject, Alepha } from \"alepha\";\nimport { type DateTime, DateTimeProvider } from \"alepha/datetime\";\nimport { $logger } from \"alepha/logger\";\nimport { type Cron, parseCronExpression } from \"cron-schedule\";\n\nexport class CronProvider {\n  protected readonly dt = $inject(DateTimeProvider);\n  protected readonly alepha = $inject(Alepha);\n  protected readonly log = $logger();\n  protected readonly cronJobs: Array<CronJob> = [];\n\n  public getCronJobs(): Array<CronJob> {\n    return this.cronJobs;\n  }\n\n  protected readonly start = $hook({\n    on: \"start\",\n    handler: () => {\n      if (this.alepha.isServerless()) {\n        this.log.info(\"Ignoring cron jobs in serverless environment\");\n        return;\n      }\n\n      for (const cron of this.cronJobs) {\n        if (!cron.running) {\n          cron.running = true;\n          this.log.debug(\n            `Starting cron task '${cron.name}' with '${cron.expression}'`,\n          );\n          this.run(cron);\n        }\n      }\n    },\n  });\n\n  protected readonly stop = $hook({\n    on: \"stop\",\n    handler: () => {\n      for (const cron of this.cronJobs) {\n        this.abort(cron);\n      }\n    },\n  });\n\n  /**\n   * Generic serverless cron trigger. Vercel's platform-emitted entry\n   * point fires `serverless:cron` with the job name; we run the matching\n   * job in-process. On long-running runtimes this listener is harmless\n   * (no one fires the event).\n   */\n  protected readonly onServerlessCron = $hook({\n    on: \"serverless:cron\",\n    handler: async ({ name }) => {\n      await this.trigger(name);\n    },\n  });\n\n  protected boot(name: string | CronJob) {\n    const cron =\n      typeof name === \"string\"\n        ? this.cronJobs.find((c) => c.name === name)\n        : name;\n\n    if (!cron) {\n      return;\n    }\n\n    cron.running = true;\n\n    this.log.debug(\n      `Starting cron task '${cron.name}' with '${cron.expression}'`,\n    );\n\n    this.run(cron);\n  }\n\n  public abort(name: string | CronJob): void {\n    const cron =\n      typeof name === \"string\"\n        ? this.cronJobs.find((c) => c.name === name)\n        : name;\n\n    if (!cron?.running) {\n      return;\n    }\n\n    cron.running = false;\n    cron.abort?.abort();\n    this.log.debug(`Cron task '${cron.name}' stopped`);\n  }\n\n  /**\n   * Registers a cron job.\n   *\n   * It's automatically done when using the `$scheduler` primitive but can also be used manually.\n   */\n  public createCronJob(\n    name: string,\n    expression: string,\n    handler: (context: { now: DateTime }) => Promise<void>,\n    start?: boolean,\n  ): void {\n    const cron: CronJob = {\n      name,\n      cron: parseCronExpression(expression),\n      expression,\n      handler,\n      loop: true,\n      abort: new AbortController(),\n    };\n\n    this.cronJobs.push(cron);\n\n    if (start && this.alepha.isStarted()) {\n      this.boot(cron);\n    }\n  }\n\n  protected run(task: CronJob, now = this.dt.now()): void {\n    if (!task.running) {\n      return;\n    }\n\n    const [next] = task.cron.getNextDates(1, now.toDate());\n    if (!next) {\n      return;\n    }\n\n    const duration = next.getTime() - now.toDate().getTime();\n    const abort = new AbortController();\n    task.abort = abort;\n\n    this.dt\n      .wait(duration, {\n        now: now.valueOf(),\n        signal: abort.signal,\n      })\n      .then(() => {\n        if (!task.running) {\n          this.log.trace(\"Cron task stopped before execution\");\n          return;\n        }\n\n        this.log.trace(\"Running cron task\");\n\n        if (task.executing) {\n          this.log.warn(\n            `Cron task '${task.name}' is still running, skipping this invocation`,\n          );\n          if (task.loop) {\n            this.run(task, this.dt.of(next));\n          }\n          return;\n        }\n\n        task.executing = true;\n        task\n          .handler({ now: this.dt.of(next) })\n          .catch((err) => {\n            if (task.onError) {\n              task.onError(err);\n            } else {\n              this.log.error(\"Error in cron task:\", err);\n            }\n          })\n          .finally(() => {\n            task.executing = false;\n          });\n\n        if (task.loop) {\n          this.run(task, this.dt.of(next));\n        }\n      })\n      .catch((err) => {\n        this.log.warn(\"Issue during cron waiting timer\", err as Error);\n      });\n  }\n\n  /**\n   * Trigger a specific cron job by name.\n   */\n  public async trigger(name: string): Promise<void> {\n    const job = this.cronJobs.find((j) => j.name === name);\n    if (!job) {\n      this.log.warn(`Cron job '${name}' not found`);\n      return;\n    }\n    await this.runJobs([job], this.dt.now());\n  }\n\n  /**\n   * Trigger all registered cron jobs.\n   */\n  public async triggerAll(): Promise<void> {\n    await this.runJobs(this.cronJobs, this.dt.now());\n  }\n\n  /**\n   * Run multiple cron jobs in parallel.\n   */\n  protected async runJobs(jobs: CronJob[], now: DateTime): Promise<void> {\n    const results = await Promise.allSettled(\n      jobs.map(async (job) => {\n        this.log.debug(`Running cron job '${job.name}'`);\n        try {\n          await job.handler({ now });\n          this.log.debug(`Cron job '${job.name}' completed`);\n        } catch (error) {\n          this.log.error(`Cron job '${job.name}' failed`, error);\n          throw error;\n        }\n      }),\n    );\n\n    const failures = results.filter((r) => r.status === \"rejected\");\n    if (failures.length > 0) {\n      this.log.error(`${failures.length}/${jobs.length} cron jobs failed`);\n    }\n  }\n}\n\nexport interface CronJob {\n  name: string;\n  expression: string;\n  handler: (context: { now: DateTime }) => Promise<void>;\n  cron: Cron;\n  loop: boolean;\n  running?: boolean;\n  executing?: boolean;\n  onError?: (error: Error) => void;\n  abort?: AbortController;\n}\n","import {\n  $atom,\n  $inject,\n  $pipeline,\n  $state,\n  Alepha,\n  type Async,\n  createPrimitive,\n  KIND,\n  Primitive,\n  type Static,\n  t,\n} from \"alepha\";\nimport {\n  type DateTime,\n  DateTimeProvider,\n  type DurationLike,\n} from \"alepha/datetime\";\nimport { $lock } from \"alepha/lock\";\nimport { $logger } from \"alepha/logger\";\nimport { CronProvider } from \"../providers/CronProvider.ts\";\n\n/**\n * Scheduler primitive.\n */\nexport const $scheduler = (\n  options: SchedulerPrimitiveOptions,\n): SchedulerPrimitive => {\n  return createPrimitive(SchedulerPrimitive, options);\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport type SchedulerPrimitiveOptions = {\n  /**\n   * Function to run on schedule.\n   */\n  handler: (args: SchedulerHandlerArguments) => Async<void>;\n\n  /**\n   * Name of the scheduler. Defaults to the function name.\n   */\n  name?: string;\n\n  /**\n   * Optional description of the scheduler.\n   */\n  description?: string;\n\n  /**\n   * Cron expression or interval to run the scheduler.\n   */\n  cron?: string;\n\n  /**\n   * Cron expression or interval to run the scheduler.\n   */\n  interval?: DurationLike;\n\n  /**\n   * If true, the scheduler will be locked and only one instance will run at a time.\n   * You probably need to import {@link AlephaLockRedis} for distributed locking.\n   *\n   * @default true\n   */\n  lock?: boolean;\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Scheduler configuration atom.\n */\nexport const schedulerOptions = $atom({\n  name: \"alepha.scheduler.options\",\n  schema: t.object({\n    prefix: t.optional(\n      t.text({\n        description: \"Prefix for scheduler lock keys.\",\n      }),\n    ),\n  }),\n  default: {},\n});\n\nexport type SchedulerAtomOptions = Static<typeof schedulerOptions.schema>;\n\ndeclare module \"alepha\" {\n  interface State {\n    [schedulerOptions.key]: SchedulerAtomOptions;\n  }\n}\n\nexport class SchedulerPrimitive extends Primitive<SchedulerPrimitiveOptions> {\n  protected readonly log = $logger();\n  protected readonly settings = $state(schedulerOptions);\n  protected readonly alepha = $inject(Alepha);\n  protected readonly dateTimeProvider = $inject(DateTimeProvider);\n  protected readonly cronProvider = $inject(CronProvider);\n\n  public get name(): string {\n    return (\n      this.options.name ??\n      `${this.config.service.name}.${this.config.propertyKey}`\n    );\n  }\n\n  protected onInit() {\n    if (this.options.interval) {\n      this.dateTimeProvider.createInterval(\n        () => this.trigger(),\n        this.options.interval,\n      );\n    }\n    if (this.options.cron) {\n      this.cronProvider.createCronJob(this.name, this.options.cron, () =>\n        this.trigger(),\n      );\n    }\n  }\n\n  public async trigger(): Promise<void> {\n    if (!this.alepha.isStarted()) {\n      return;\n    }\n\n    const context = this.alepha.context.createContextId();\n\n    await this.alepha.context.run(\n      async () => {\n        try {\n          const now = this.dateTimeProvider.now();\n\n          await this.alepha.events.emit(\"scheduler:begin\", {\n            name: this.name,\n            now,\n            context,\n          });\n\n          if (this.options.lock !== false) {\n            await this.schedulerLock.run({ now });\n          } else {\n            await this.options.handler({ now });\n          }\n\n          await this.alepha.events.emit(\n            \"scheduler:success\",\n            {\n              name: this.name,\n              context,\n            },\n            {\n              catch: true,\n            },\n          );\n        } catch (error) {\n          await this.alepha.events.emit(\n            \"scheduler:error\",\n            {\n              name: this.name,\n              error: error as Error,\n              context,\n            },\n            {\n              catch: true,\n            },\n          );\n\n          this.log.error(\"Error running scheduler:\", error);\n        }\n\n        await this.alepha.events.emit(\n          \"scheduler:end\",\n          {\n            name: this.name,\n            context,\n          },\n          {\n            catch: true,\n          },\n        );\n      },\n      {\n        context,\n      },\n    );\n  }\n\n  protected schedulerLock = $pipeline({\n    use: [\n      $lock({\n        name: () => {\n          const prefix = this.settings.prefix ? `${this.settings.prefix}:` : \"\";\n          return `${prefix}scheduler:${this.name}`;\n        },\n      }),\n    ],\n    handler: async (args: SchedulerHandlerArguments) => {\n      await this.options.handler(args);\n    },\n  });\n}\n\n$scheduler[KIND] = SchedulerPrimitive;\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface SchedulerHandlerArguments {\n  now: DateTime;\n}\n","export const CRON = {\n  EVERY_MINUTE: \"* * * * *\",\n  EVERY_5_MINUTES: \"*/5 * * * *\",\n  EVERY_15_MINUTES: \"*/15 * * * *\",\n  EVERY_30_MINUTES: \"*/30 * * * *\",\n  EVERY_HOUR: \"0 * * * *\",\n  EVERY_DAY_AT_MIDNIGHT: \"0 0 * * *\",\n};\n","import { $hook } from \"alepha\";\nimport type { DateTime } from \"alepha/datetime\";\nimport { parseCronExpression } from \"cron-schedule\";\nimport { CronProvider } from \"./CronProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\ndeclare module \"alepha\" {\n  interface Hooks {\n    /**\n     * Cloudflare Workers scheduled event.\n     *\n     * Emitted when a cron trigger fires in Cloudflare Workers.\n     */\n    \"cloudflare:scheduled\": {\n      cron: string;\n      scheduledTime: number;\n    };\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Cloudflare Workers cron provider.\n *\n * This provider handles scheduled events from Cloudflare Workers Cron Triggers.\n * Unlike the Node.js CronProvider, this doesn't use intervals/timeouts - instead,\n * it reacts to scheduled events triggered by Cloudflare.\n *\n * **Usage:**\n * 1. Define schedulers with `$scheduler({ cron: \"0 * * * *\", handler: ... })`\n * 2. Build your app with `alepha build` - cron triggers are automatically added to `wrangler.jsonc`\n * 3. Deploy to Cloudflare Workers\n *\n * **How it works:**\n * - During build, all registered `$scheduler` cron expressions are collected\n * - The build generates `wrangler.jsonc` with `triggers.crons` automatically filled\n * - When Cloudflare fires a cron trigger, the `scheduled` handler emits `cloudflare:scheduled`\n * - This provider listens to that event and runs matching schedulers\n *\n * @see https://developers.cloudflare.com/workers/configuration/cron-triggers/\n */\nexport class WorkerdCronProvider extends CronProvider {\n  /**\n   * Override to avoid creating AbortController in global scope.\n   * Cloudflare Workers doesn't allow this during initialization.\n   */\n  public override createCronJob(\n    name: string,\n    expression: string,\n    handler: (context: { now: DateTime }) => Promise<void>,\n  ): void {\n    this.cronJobs.push({\n      name,\n      cron: parseCronExpression(expression),\n      expression,\n      handler,\n      loop: false,\n    });\n  }\n\n  /**\n   * Handle a scheduled event from Cloudflare Workers.\n   */\n  protected readonly onScheduledEvent = $hook({\n    on: \"cloudflare:scheduled\",\n    handler: async (event) => {\n      const now = this.dt.of(event.scheduledTime);\n\n      this.log.info(\"Received scheduled event\", {\n        cron: event.cron,\n        scheduledTime: now.format(),\n      });\n\n      // Find jobs that match this cron expression\n      const matchingJobs = this.cronJobs.filter(\n        (job) => job.expression === event.cron,\n      );\n\n      if (matchingJobs.length === 0) {\n        // No exact match - try to find jobs that would fire at this time\n        const matchingByTime = this.cronJobs.filter((job) =>\n          job.cron.matchDate(now.toDate()),\n        );\n\n        if (matchingByTime.length > 0) {\n          this.log.debug(\n            `No exact cron match for '${event.cron}', found ${matchingByTime.length} jobs matching by time`,\n          );\n          await this.runJobs(matchingByTime, now);\n          return;\n        }\n\n        this.log.warn(`No cron jobs found for expression '${event.cron}'`);\n        return;\n      }\n\n      await this.runJobs(matchingJobs, now);\n    },\n  });\n}\n","import { $module } from \"alepha\";\nimport type { DateTime } from \"alepha/datetime\";\nimport { AlephaLock } from \"alepha/lock\";\nimport { $scheduler } from \"./primitives/$scheduler.ts\";\nimport { CronProvider } from \"./providers/CronProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./constants/CRON.ts\";\nexport * from \"./primitives/$scheduler.ts\";\nexport * from \"./providers/CronProvider.ts\";\nexport * from \"./providers/WorkerdCronProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\ndeclare module \"alepha\" {\n  interface Hooks {\n    \"scheduler:begin\": {\n      name: string;\n      now: DateTime;\n      context: string;\n    };\n\n    \"scheduler:success\": { name: string; context: string };\n\n    \"scheduler:error\": {\n      name: string;\n      error: Error;\n      context: string;\n    };\n\n    \"scheduler:end\": { name: string; context: string };\n\n    /**\n     * Generic serverless cron trigger event.\n     *\n     * Emitted by serverless platform entry points (Vercel `/api/cron/...`,\n     * etc.) to trigger a registered cron job by name. `CronProvider`\n     * listens to this and calls `trigger(name)` so the same `$scheduler`\n     * / `$job({ cron })` declarations work across runtimes.\n     *\n     * Cloudflare Workers uses the platform-specific `cloudflare:scheduled`\n     * event instead (matched by cron expression), see\n     * `WorkerdCronProvider`.\n     */\n    \"serverless:cron\": { name: string };\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Cron and interval-based task execution.\n *\n * **Features:**\n * - Scheduled tasks with cron expressions (e.g., `0 0 * * *`)\n * - Interval-based scheduling\n * - Distributed locking to prevent duplicate execution\n * - Lifecycle hooks: `begin`, `success`, `error`, `end`\n *\n * @module alepha.scheduler\n */\nexport const AlephaScheduler = $module({\n  name: \"alepha.scheduler\",\n  primitives: [$scheduler],\n  services: [AlephaLock, CronProvider],\n});\n"],"x_google_ignoreList":[0,1,2],"mappings":"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"}

package/dist/scheduler/index.workerd.js

@@ -421,6 +421,18 @@ var CronProvider = class {
 			for (const cron of this.cronJobs) this.abort(cron);
 		}
 	});
+	/**
+	* Generic serverless cron trigger. Vercel's platform-emitted entry
+	* point fires `serverless:cron` with the job name; we run the matching
+	* job in-process. On long-running runtimes this listener is harmless
+	* (no one fires the event).
+	*/
+	onServerlessCron = $hook({
+		on: "serverless:cron",
+		handler: async ({ name }) => {
+			await this.trigger(name);
+		}
+	});
 	boot(name) {
 		const cron = typeof name === "string" ? this.cronJobs.find((c) => c.name === name) : name;
 		if (!cron) return;