@keystrokehq/keystroke 0.1.30 → 0.1.31

package/dist/trigger.d.cts

@@ -3,87 +3,859 @@ import { n as Agent } from "./index-Mr9EjUhy.cjs";
 import { v as WorkflowDefinition } from "./index-DHCs9z3O.cjs";
 import { z } from "zod";
 
-//#region ../../node_modules/.pnpm/cron-schedule@6.0.0/node_modules/cron-schedule/dist/cron.d.ts
+//#region ../../node_modules/.pnpm/cron-parser@5.5.0/node_modules/cron-parser/dist/types/CronDate.d.ts
+declare enum TimeUnit {
+  Second = "Second",
+  Minute = "Minute",
+  Hour = "Hour",
+  Day = "Day",
+  Month = "Month",
+  Year = "Year"
+}
+declare enum DateMathOp {
+  Add = "Add",
+  Subtract = "Subtract"
+}
 /**
- * An object with contains for each element of a date, which values are allowed.
- * Everything starting at 0, except for days.
+ * CronDate class that wraps the Luxon DateTime object to provide
+ * a consistent API for working with dates and times in the context of cron.
  */
-interface ICronDefinition {
-  readonly seconds: Set<number>;
-  readonly minutes: Set<number>;
-  readonly hours: Set<number>;
-  readonly days: Set<number>;
-  readonly months: Set<number>;
-  readonly weekdays: Set<number>;
+declare class CronDate {
+  #private;
+  /**
+   * Constructs a new CronDate instance.
+   * @param {CronDate | Date | number | string} [timestamp] - The timestamp to initialize the CronDate with.
+   * @param {string} [tz] - The timezone to use for the CronDate.
+   */
+  constructor(timestamp?: CronDate | Date | number | string, tz?: string);
+  /**
+   * Returns daylight savings start time.
+   * @returns {number | null}
+   */
+  get dstStart(): number | null;
+  /**
+   * Sets daylight savings start time.
+   * @param {number | null} value
+   */
+  set dstStart(value: number | null);
+  /**
+   * Returns daylight savings end time.
+   * @returns {number | null}
+   */
+  get dstEnd(): number | null;
+  /**
+   * Sets daylight savings end time.
+   * @param {number | null} value
+   */
+  set dstEnd(value: number | null);
+  /**
+   * Adds one year to the current CronDate.
+   */
+  addYear(): void;
+  /**
+   * Adds one month to the current CronDate.
+   */
+  addMonth(): void;
+  /**
+   * Adds one day to the current CronDate.
+   */
+  addDay(): void;
+  /**
+   * Adds one hour to the current CronDate.
+   */
+  addHour(): void;
+  /**
+   * Adds one minute to the current CronDate.
+   */
+  addMinute(): void;
+  /**
+   * Adds one second to the current CronDate.
+   */
+  addSecond(): void;
+  /**
+   * Subtracts one year from the current CronDate.
+   */
+  subtractYear(): void;
+  /**
+   * Subtracts one month from the current CronDate.
+   * If the month is 1, it will subtract one year instead.
+   */
+  subtractMonth(): void;
+  /**
+   * Subtracts one day from the current CronDate.
+   * If the day is 1, it will subtract one month instead.
+   */
+  subtractDay(): void;
+  /**
+   * Subtracts one hour from the current CronDate.
+   * If the hour is 0, it will subtract one day instead.
+   */
+  subtractHour(): void;
+  /**
+   * Subtracts one minute from the current CronDate.
+   * If the minute is 0, it will subtract one hour instead.
+   */
+  subtractMinute(): void;
+  /**
+   * Subtracts one second from the current CronDate.
+   * If the second is 0, it will subtract one minute instead.
+   */
+  subtractSecond(): void;
+  /**
+   * Adds a unit of time to the current CronDate.
+   * @param {TimeUnit} unit
+   */
+  addUnit(unit: TimeUnit): void;
+  /**
+   * Subtracts a unit of time from the current CronDate.
+   * @param {TimeUnit} unit
+   */
+  subtractUnit(unit: TimeUnit): void;
+  /**
+   * Handles a math operation.
+   * @param {DateMathOp} verb - {'add' | 'subtract'}
+   * @param {TimeUnit} unit - {'year' | 'month' | 'day' | 'hour' | 'minute' | 'second'}
+   */
+  invokeDateOperation(verb: DateMathOp, unit: TimeUnit): void;
+  /**
+   * Returns the day.
+   * @returns {number}
+   */
+  getDate(): number;
+  /**
+   * Returns the year.
+   * @returns {number}
+   */
+  getFullYear(): number;
+  /**
+   * Returns the day of the week.
+   * @returns {number}
+   */
+  getDay(): number;
+  /**
+   * Returns the month.
+   * @returns {number}
+   */
+  getMonth(): number;
+  /**
+   * Returns the hour.
+   * @returns {number}
+   */
+  getHours(): number;
+  /**
+   * Returns the minutes.
+   * @returns {number}
+   */
+  getMinutes(): number;
+  /**
+   * Returns the seconds.
+   * @returns {number}
+   */
+  getSeconds(): number;
+  /**
+   * Returns the milliseconds.
+   * @returns {number}
+   */
+  getMilliseconds(): number;
+  /**
+   * Returns the timezone offset from UTC in minutes (e.g. UTC+2 => 120).
+   * Useful for detecting DST transition days.
+   *
+   * @returns {number} UTC offset in minutes
+   */
+  getUTCOffset(): number;
+  /**
+   * Sets the time to the start of the day (00:00:00.000) in the current timezone.
+   */
+  setStartOfDay(): void;
+  /**
+   * Sets the time to the end of the day (23:59:59.999) in the current timezone.
+   */
+  setEndOfDay(): void;
+  /**
+   * Returns the time.
+   * @returns {number}
+   */
+  getTime(): number;
+  /**
+   * Returns the UTC day.
+   * @returns {number}
+   */
+  getUTCDate(): number;
+  /**
+   * Returns the UTC year.
+   * @returns {number}
+   */
+  getUTCFullYear(): number;
+  /**
+   * Returns the UTC day of the week.
+   * @returns {number}
+   */
+  getUTCDay(): number;
+  /**
+   * Returns the UTC month.
+   * @returns {number}
+   */
+  getUTCMonth(): number;
+  /**
+   * Returns the UTC hour.
+   * @returns {number}
+   */
+  getUTCHours(): number;
+  /**
+   * Returns the UTC minutes.
+   * @returns {number}
+   */
+  getUTCMinutes(): number;
+  /**
+   * Returns the UTC seconds.
+   * @returns {number}
+   */
+  getUTCSeconds(): number;
+  /**
+   * Returns the UTC milliseconds.
+   * @returns {string | null}
+   */
+  toISOString(): string | null;
+  /**
+   * Returns the date as a JSON string.
+   * @returns {string | null}
+   */
+  toJSON(): string | null;
+  /**
+   * Sets the day.
+   * @param d
+   */
+  setDate(d: number): void;
+  /**
+   * Sets the year.
+   * @param y
+   */
+  setFullYear(y: number): void;
+  /**
+   * Sets the day of the week.
+   * @param d
+   */
+  setDay(d: number): void;
+  /**
+   * Sets the month.
+   * @param m
+   */
+  setMonth(m: number): void;
+  /**
+   * Sets the hour.
+   * @param h
+   */
+  setHours(h: number): void;
+  /**
+   * Sets the minutes.
+   * @param m
+   */
+  setMinutes(m: number): void;
+  /**
+   * Sets the seconds.
+   * @param s
+   */
+  setSeconds(s: number): void;
+  /**
+   * Sets the milliseconds.
+   * @param s
+   */
+  setMilliseconds(s: number): void;
+  /**
+   * Returns the date as a string.
+   * @returns {string}
+   */
+  toString(): string;
+  /**
+   * Returns the date as a Date object.
+   * @returns {Date}
+   */
+  toDate(): Date;
+  /**
+   * Returns true if the day is the last day of the month.
+   * @returns {boolean}
+   */
+  isLastDayOfMonth(): boolean;
+  /**
+   * Returns true if the day is the last weekday of the month.
+   * @returns {boolean}
+   */
+  isLastWeekdayOfMonth(): boolean;
+  /**
+   * Primarily for internal use.
+   * @param {DateMathOp} op - The operation to perform.
+   * @param {TimeUnit} unit - The unit of time to use.
+   * @param {number} [hoursLength] - The length of the hours. Required when unit is not month or day.
+   */
+  applyDateOperation(op: DateMathOp, unit: TimeUnit, hoursLength?: number): void;
 }
-declare class Cron {
-  readonly seconds: ReadonlyArray<number>;
-  readonly minutes: ReadonlyArray<number>;
-  readonly hours: ReadonlyArray<number>;
-  readonly days: ReadonlyArray<number>;
-  readonly months: ReadonlyArray<number>;
-  readonly weekdays: ReadonlyArray<number>;
-  readonly reversed: {
-    seconds: ReadonlyArray<number>;
-    minutes: ReadonlyArray<number>;
-    hours: ReadonlyArray<number>;
-    days: ReadonlyArray<number>;
-    months: ReadonlyArray<number>;
-    weekdays: ReadonlyArray<number>;
+//#endregion
+//#region ../../node_modules/.pnpm/cron-parser@5.5.0/node_modules/cron-parser/dist/types/fields/types.d.ts
+type RangeFrom<LENGTH extends number, ACC extends unknown[] = []> = ACC['length'] extends LENGTH ? ACC : RangeFrom<LENGTH, [...ACC, 1]>;
+type IntRange<FROM extends number[], TO extends number, ACC extends number = never> = FROM['length'] extends TO ? ACC | TO : IntRange<[...FROM, 1], TO, ACC | FROM['length']>;
+type SixtyRange = IntRange<RangeFrom<0>, 59>;
+type HourRange = IntRange<RangeFrom<0>, 23>;
+type DayOfMonthRange = IntRange<RangeFrom<1>, 31> | 'L';
+type MonthRange = IntRange<RangeFrom<1>, 12>;
+type DayOfWeekRange = IntRange<RangeFrom<0>, 7> | 'L';
+type CronFieldType = SixtyRange[] | HourRange[] | DayOfMonthRange[] | MonthRange[] | DayOfWeekRange[];
+type CronChars = 'L' | 'W';
+type CronMin = 0 | 1;
+type CronMax = 7 | 12 | 23 | 31 | 59;
+type CronConstraints = {
+  min: CronMin;
+  max: CronMax;
+  chars: readonly CronChars[];
+  validChars: RegExp;
+};
+//#endregion
+//#region ../../node_modules/.pnpm/cron-parser@5.5.0/node_modules/cron-parser/dist/types/fields/CronField.d.ts
+/**
+ * Represents the serialized form of a cron field.
+ * @typedef {Object} SerializedCronField
+ * @property {boolean} wildcard - Indicates if the field is a wildcard.
+ * @property {(number|string)[]} values - The values of the field.
+ */
+type SerializedCronField = {
+  wildcard: boolean;
+  values: (number | string)[];
+};
+/**
+ * Represents the options for a cron field.
+ * @typedef {Object} CronFieldOptions
+ * @property {string} rawValue - The raw value of the field.
+ * @property {boolean} [wildcard] - Indicates if the field is a wildcard.
+ * @property {number} [nthDayOfWeek] - The nth day of the week.
+ */
+type CronFieldOptions = {
+  rawValue?: string;
+  wildcard?: boolean;
+  nthDayOfWeek?: number;
+};
+/**
+ * Represents a field within a cron expression.
+ * This is a base class and should not be instantiated directly.
+ * @class CronField
+ */
+declare abstract class CronField$1 {
+  #private;
+  protected readonly options: CronFieldOptions & {
+    rawValue: string;
   };
+  /**
+   * Returns the minimum value allowed for this field.
+   */
+  static get min(): CronMin;
+  /**
+   * Returns the maximum value allowed for this field.
+   */
+  static get max(): CronMax;
+  /**
+   * Returns the allowed characters for this field.
+   */
+  static get chars(): readonly CronChars[];
+  /**
+   * Returns the regular expression used to validate this field.
+   */
+  static get validChars(): RegExp;
+  /**
+   * Returns the constraints for this field.
+   */
+  static get constraints(): CronConstraints;
+  /**
+   * CronField constructor. Initializes the field with the provided values.
+   * @param {number[] | string[]} values - Values for this field
+   * @param {CronFieldOptions} [options] - Options provided by the parser
+   * @throws {TypeError} if the constructor is called directly
+   * @throws {Error} if validation fails
+   */
+  protected constructor(values: (number | string)[], options?: CronFieldOptions);
+  /**
+   * Returns the minimum value allowed for this field.
+   * @returns {number}
+   */
+  get min(): number;
+  /**
+   * Returns the maximum value allowed for this field.
+   * @returns {number}
+   */
+  get max(): number;
+  /**
+   * Returns an array of allowed special characters for this field.
+   * @returns {string[]}
+   */
+  get chars(): readonly string[];
+  /**
+   * Indicates whether this field has a "last" character.
+   * @returns {boolean}
+   */
+  get hasLastChar(): boolean;
+  /**
+   * Indicates whether this field has a "question mark" character.
+   * @returns {boolean}
+   */
+  get hasQuestionMarkChar(): boolean;
+  /**
+   * Indicates whether this field is a wildcard.
+   * @returns {boolean}
+   */
+  get isWildcard(): boolean;
+  /**
+   * Returns an array of allowed values for this field.
+   * @returns {CronFieldType}
+   */
+  get values(): CronFieldType;
+  /**
+   * Helper function to sort values in ascending order.
+   * @param {number | string} a - First value to compare
+   * @param {number | string} b - Second value to compare
+   * @returns {number} - A negative, zero, or positive value, depending on the sort order
+   */
+  static sorter(a: number | string, b: number | string): number;
+  /**
+   * Find the next (or previous when `reverse` is true) numeric value in a sorted list.
+   * Returns null if there's no value strictly after/before the current one.
+   *
+   * @param values - Sorted numeric values
+   * @param currentValue - Current value to compare against
+   * @param reverse - When true, search in reverse for previous smaller value
+   */
+  static findNearestValueInList(values: number[], currentValue: number, reverse?: boolean): number | null;
+  /**
+   * Instance helper that operates on this field's numeric `values`.
+   *
+   * @param currentValue - Current value to compare against
+   * @param reverse - When true, search in reverse for previous smaller value
+   */
+  findNearestValue(currentValue: number, reverse?: boolean): number | null;
+  /**
+   * Serializes the field to an object.
+   * @returns {SerializedCronField}
+   */
+  serialize(): SerializedCronField;
+  /**
+   * Validates the field values against the allowed range and special characters.
+   * @throws {Error} if validation fails
+   */
+  validate(): void;
+}
+//#endregion
+//#region ../../node_modules/.pnpm/cron-parser@5.5.0/node_modules/cron-parser/dist/types/fields/CronDayOfMonth.d.ts
+/**
+ * Represents the "day of the month" field within a cron expression.
+ * @class CronDayOfMonth
+ * @extends CronField
+ */
+declare class CronDayOfMonth extends CronField$1 {
+  static get min(): CronMin;
+  static get max(): CronMax;
+  static get chars(): CronChars[];
+  static get validChars(): RegExp;
+  /**
+   * CronDayOfMonth constructor. Initializes the "day of the month" field with the provided values.
+   * @param {DayOfMonthRange[]} values - Values for the "day of the month" field
+   * @param {CronFieldOptions} [options] - Options provided by the parser
+   * @throws {Error} if validation fails
+   */
+  constructor(values: DayOfMonthRange[], options?: CronFieldOptions);
+  /**
+   * Returns an array of allowed values for the "day of the month" field.
+   * @returns {DayOfMonthRange[]}
+   */
+  get values(): DayOfMonthRange[];
+}
+//#endregion
+//#region ../../node_modules/.pnpm/cron-parser@5.5.0/node_modules/cron-parser/dist/types/fields/CronDayOfWeek.d.ts
+/**
+ * Represents the "day of the week" field within a cron expression.
+ * @class CronDayOfTheWeek
+ * @extends CronField
+ */
+declare class CronDayOfWeek extends CronField$1 {
+  static get min(): CronMin;
+  static get max(): CronMax;
+  static get chars(): readonly CronChars[];
+  static get validChars(): RegExp;
+  /**
+   * CronDayOfTheWeek constructor. Initializes the "day of the week" field with the provided values.
+   * @param {DayOfWeekRange[]} values - Values for the "day of the week" field
+   * @param {CronFieldOptions} [options] - Options provided by the parser
+   */
+  constructor(values: DayOfWeekRange[], options?: CronFieldOptions);
+  /**
+   * Returns an array of allowed values for the "day of the week" field.
+   * @returns {DayOfWeekRange[]}
+   */
+  get values(): DayOfWeekRange[];
+  /**
+   * Returns the nth day of the week if specified in the cron expression.
+   * This is used for the '#' character in the cron expression.
+   * @returns {number} The nth day of the week (1-5) or 0 if not specified.
+   */
+  get nthDay(): number;
+}
+//#endregion
+//#region ../../node_modules/.pnpm/cron-parser@5.5.0/node_modules/cron-parser/dist/types/fields/CronHour.d.ts
+/**
+ * Represents the "hour" field within a cron expression.
+ * @class CronHour
+ * @extends CronField
+ */
+declare class CronHour extends CronField$1 {
+  static get min(): CronMin;
+  static get max(): CronMax;
+  static get chars(): readonly CronChars[];
+  /**
+   * CronHour constructor. Initializes the "hour" field with the provided values.
+   * @param {HourRange[]} values - Values for the "hour" field
+   * @param {CronFieldOptions} [options] - Options provided by the parser
+   */
+  constructor(values: HourRange[], options?: CronFieldOptions);
+  /**
+   * Returns an array of allowed values for the "hour" field.
+   * @returns {HourRange[]}
+   */
+  get values(): HourRange[];
+}
+//#endregion
+//#region ../../node_modules/.pnpm/cron-parser@5.5.0/node_modules/cron-parser/dist/types/fields/CronMinute.d.ts
+/**
+ * Represents the "second" field within a cron expression.
+ * @class CronSecond
+ * @extends CronField
+ */
+declare class CronMinute extends CronField$1 {
+  static get min(): CronMin;
+  static get max(): CronMax;
+  static get chars(): readonly CronChars[];
+  /**
+   * CronSecond constructor. Initializes the "second" field with the provided values.
+   * @param {SixtyRange[]} values - Values for the "second" field
+   * @param {CronFieldOptions} [options] - Options provided by the parser
+   */
+  constructor(values: SixtyRange[], options?: CronFieldOptions);
+  /**
+   * Returns an array of allowed values for the "second" field.
+   * @returns {SixtyRange[]}
+   */
+  get values(): SixtyRange[];
+}
+//#endregion
+//#region ../../node_modules/.pnpm/cron-parser@5.5.0/node_modules/cron-parser/dist/types/fields/CronMonth.d.ts
+/**
+ * Represents the "day of the month" field within a cron expression.
+ * @class CronDayOfMonth
+ * @extends CronField
+ */
+declare class CronMonth extends CronField$1 {
+  static get min(): CronMin;
+  static get max(): CronMax;
+  static get chars(): readonly CronChars[];
+  static get daysInMonth(): readonly number[];
+  /**
+   * CronDayOfMonth constructor. Initializes the "day of the month" field with the provided values.
+   * @param {MonthRange[]} values - Values for the "day of the month" field
+   * @param {CronFieldOptions} [options] - Options provided by the parser
+   */
+  constructor(values: MonthRange[], options?: CronFieldOptions);
+  /**
+   * Returns an array of allowed values for the "day of the month" field.
+   * @returns {MonthRange[]}
+   */
+  get values(): MonthRange[];
+}
+//#endregion
+//#region ../../node_modules/.pnpm/cron-parser@5.5.0/node_modules/cron-parser/dist/types/fields/CronSecond.d.ts
+/**
+ * Represents the "second" field within a cron expression.
+ * @class CronSecond
+ * @extends CronField
+ */
+declare class CronSecond extends CronField$1 {
+  static get min(): CronMin;
+  static get max(): CronMax;
+  static get chars(): readonly CronChars[];
+  /**
+   * CronSecond constructor. Initializes the "second" field with the provided values.
+   * @param {SixtyRange[]} values - Values for the "second" field
+   * @param {CronFieldOptions} [options] - Options provided by the parser
+   */
+  constructor(values: SixtyRange[], options?: CronFieldOptions);
+  /**
+   * Returns an array of allowed values for the "second" field.
+   * @returns {SixtyRange[]}
+   */
+  get values(): SixtyRange[];
+}
+//#endregion
+//#region ../../node_modules/.pnpm/cron-parser@5.5.0/node_modules/cron-parser/dist/types/CronFieldCollection.d.ts
+type FieldRange = {
+  start: number | CronChars;
+  count: number;
+  end?: number;
+  step?: number;
+};
+type CronFields = {
+  second: CronSecond;
+  minute: CronMinute;
+  hour: CronHour;
+  dayOfMonth: CronDayOfMonth;
+  month: CronMonth;
+  dayOfWeek: CronDayOfWeek;
+};
+type CronFieldOverride = {
+  second?: CronSecond | SixtyRange[];
+  minute?: CronMinute | SixtyRange[];
+  hour?: CronHour | HourRange[];
+  dayOfMonth?: CronDayOfMonth | DayOfMonthRange[];
+  month?: CronMonth | MonthRange[];
+  dayOfWeek?: CronDayOfWeek | DayOfWeekRange[];
+};
+type SerializedCronFields = {
+  second: SerializedCronField;
+  minute: SerializedCronField;
+  hour: SerializedCronField;
+  dayOfMonth: SerializedCronField;
+  month: SerializedCronField;
+  dayOfWeek: SerializedCronField;
+};
+/**
+ * Represents a complete set of cron fields.
+ * @class CronFieldCollection
+ */
+declare class CronFieldCollection {
+  #private;
+  /**
+   * Creates a new CronFieldCollection instance by partially overriding fields from an existing one.
+   * @param {CronFieldCollection} base - The base CronFieldCollection to copy fields from
+   * @param {CronFieldOverride} fields - The fields to override, can be CronField instances or raw values
+   * @returns {CronFieldCollection} A new CronFieldCollection instance
+   * @example
+   * const base = new CronFieldCollection({
+   *   second: new CronSecond([0]),
+   *   minute: new CronMinute([0]),
+   *   hour: new CronHour([12]),
+   *   dayOfMonth: new CronDayOfMonth([1]),
+   *   month: new CronMonth([1]),
+   *   dayOfWeek: new CronDayOfWeek([1])
+   * });
+   *
+   * // Using CronField instances
+   * const modified1 = CronFieldCollection.from(base, {
+   *   hour: new CronHour([15]),
+   *   minute: new CronMinute([30])
+   * });
+   *
+   * // Using raw values
+   * const modified2 = CronFieldCollection.from(base, {
+   *   hour: [15],        // Will create new CronHour
+   *   minute: [30]       // Will create new CronMinute
+   * });
+   */
+  static from(base: CronFieldCollection, fields: CronFieldOverride): CronFieldCollection;
+  /**
+   * Resolves a field value, either using the provided CronField instance or creating a new one from raw values.
+   * @param constructor - The constructor for creating new field instances
+   * @param baseField - The base field to use if no override is provided
+   * @param fieldValue - The override value, either a CronField instance or raw values
+   * @returns The resolved CronField instance
+   * @private
+   */
+  private static resolveField;
+  /**
+   * CronFieldCollection constructor. Initializes the cron fields with the provided values.
+   * @param {CronFields} param0 - The cron fields values
+   * @throws {Error} if validation fails
+   * @example
+   * const cronFields = new CronFieldCollection({
+   *   second: new CronSecond([0]),
+   *   minute: new CronMinute([0, 30]),
+   *   hour: new CronHour([9]),
+   *   dayOfMonth: new CronDayOfMonth([15]),
+   *   month: new CronMonth([1]),
+   *   dayOfWeek: new CronDayOfTheWeek([1, 2, 3, 4, 5]),
+   * })
+   *
+   * console.log(cronFields.second.values); // [0]
+   * console.log(cronFields.minute.values); // [0, 30]
+   * console.log(cronFields.hour.values); // [9]
+   * console.log(cronFields.dayOfMonth.values); // [15]
+   * console.log(cronFields.month.values); // [1]
+   * console.log(cronFields.dayOfWeek.values); // [1, 2, 3, 4, 5]
+   */
   constructor({
-    seconds,
-    minutes,
-    hours,
-    days,
-    months,
-    weekdays
-  }: ICronDefinition);
+    second,
+    minute,
+    hour,
+    dayOfMonth,
+    month,
+    dayOfWeek
+  }: CronFields);
+  /**
+   * Returns the second field.
+   * @returns {CronSecond}
+   */
+  get second(): CronSecond;
+  /**
+   * Returns the minute field.
+   * @returns {CronMinute}
+   */
+  get minute(): CronMinute;
+  /**
+   * Returns the hour field.
+   * @returns {CronHour}
+   */
+  get hour(): CronHour;
+  /**
+   * Returns the day of the month field.
+   * @returns {CronDayOfMonth}
+   */
+  get dayOfMonth(): CronDayOfMonth;
+  /**
+   * Returns the month field.
+   * @returns {CronMonth}
+   */
+  get month(): CronMonth;
+  /**
+   * Returns the day of the week field.
+   * @returns {CronDayOfWeek}
+   */
+  get dayOfWeek(): CronDayOfWeek;
+  /**
+   * Returns a string representation of the cron fields.
+   * @param {(number | CronChars)[]} input - The cron fields values
+   * @static
+   * @returns {FieldRange[]} - The compacted cron fields
+   */
+  static compactField(input: (number | CronChars)[]): FieldRange[];
+  /**
+   * Returns a string representation of the cron fields.
+   * @param {CronField} field - The cron field to stringify
+   * @static
+   * @returns {string} - The stringified cron field
+   */
+  stringifyField(field: CronField$1): string;
+  /**
+   * Returns a string representation of the cron field values.
+   * @param {boolean} includeSeconds - Whether to include seconds in the output
+   * @returns {string} The formatted cron string
+   */
+  stringify(includeSeconds?: boolean): string;
+  /**
+   * Returns a serialized representation of the cron fields values.
+   * @returns {SerializedCronFields} An object containing the cron field values
+   */
+  serialize(): SerializedCronFields;
+}
+//#endregion
+//#region ../../node_modules/.pnpm/cron-parser@5.5.0/node_modules/cron-parser/dist/types/CronExpression.d.ts
+type CronExpressionOptions = {
+  currentDate?: Date | string | number | CronDate;
+  endDate?: Date | string | number | CronDate;
+  startDate?: Date | string | number | CronDate;
+  tz?: string;
+  expression?: string;
+  hashSeed?: string;
+  strict?: boolean;
+};
+/**
+ * Class representing a Cron expression.
+ */
+declare class CronExpression$1 {
+  #private;
+  /**
+   * Creates a new CronExpression instance.
+   *
+   * @param {CronFieldCollection} fields - Cron fields.
+   * @param {CronExpressionOptions} options - Parser options.
+   */
+  constructor(fields: CronFieldCollection, options: CronExpressionOptions);
+  /**
+   * Getter for the cron fields.
+   *
+   * @returns {CronFieldCollection} Cron fields.
+   */
+  get fields(): CronFieldCollection;
+  /**
+   * Converts cron fields back to a CronExpression instance.
+   *
+   * @public
+   * @param {Record<string, number[]>} fields - The input cron fields object.
+   * @param {CronExpressionOptions} [options] - Optional parsing options.
+   * @returns {CronExpression} - A new CronExpression instance.
+   */
+  static fieldsToExpression(fields: CronFieldCollection, options?: CronExpressionOptions): CronExpression$1;
+  /**
+   * Find the next scheduled date based on the cron expression.
+   * @returns {CronDate} - The next scheduled date or an ES6 compatible iterator object.
+   * @memberof CronExpression
+   * @public
+   */
+  next(): CronDate;
+  /**
+   * Find the previous scheduled date based on the cron expression.
+   * @returns {CronDate} - The previous scheduled date or an ES6 compatible iterator object.
+   * @memberof CronExpression
+   * @public
+   */
+  prev(): CronDate;
+  /**
+   * Check if there is a next scheduled date based on the current date and cron expression.
+   * @returns {boolean} - Returns true if there is a next scheduled date, false otherwise.
+   * @memberof CronExpression
+   * @public
+   */
+  hasNext(): boolean;
   /**
-   * Find the next or previous hour, starting from the given start hour that matches the hour constraint.
-   * startHour itself might also be allowed.
+   * Check if there is a previous scheduled date based on the current date and cron expression.
+   * @returns {boolean} - Returns true if there is a previous scheduled date, false otherwise.
+   * @memberof CronExpression
+   * @public
    */
-  private findAllowedHour;
+  hasPrev(): boolean;
   /**
-   * Find the next or previous minute, starting from the given start minute that matches the minute constraint.
-   * startMinute itself might also be allowed.
+   * Iterate over a specified number of steps and optionally execute a callback function for each step.
+   * @param {number} steps - The number of steps to iterate. Positive value iterates forward, negative value iterates backward.
+   * @returns {CronDate[]} - An array of iterator fields or CronDate objects.
+   * @memberof CronExpression
+   * @public
    */
-  private findAllowedMinute;
+  take(limit: number): CronDate[];
   /**
-   * Find the next or previous second, starting from the given start second that matches the second constraint.
-   * startSecond itself IS NOT allowed.
+   * Reset the iterators current date to a new date or the initial date.
+   * @param {Date | CronDate} [newDate] - Optional new date to reset to. If not provided, it will reset to the initial date.
+   * @memberof CronExpression
+   * @public
    */
-  private findAllowedSecond;
+  reset(newDate?: Date | CronDate): void;
   /**
-   * Find the next or previous time, starting from the given start time that matches the hour, minute
-   * and second constraints. startTime itself might also be allowed.
+   * Generate a string representation of the cron expression.
+   * @param {boolean} [includeSeconds=false] - Whether to include the seconds field in the string representation.
+   * @returns {string} - The string representation of the cron expression.
+   * @memberof CronExpression
+   * @public
    */
-  private findAllowedTime;
+  stringify(includeSeconds?: boolean): string;
   /**
-   * Find the next or previous day in the given month, starting from the given startDay
-   * that matches either the day or the weekday constraint. startDay itself might also be allowed.
+   * Check if the cron expression includes the given date
+   * @param {Date|CronDate} date
+   * @returns {boolean}
    */
-  private findAllowedDayInMonth;
-  /** Gets the next date starting from the given start date or now. */
-  getNextDate(startDate?: Date): Date;
-  /** Gets the specified amount of future dates starting from the given start date or now. */
-  getNextDates(amount: number, startDate?: Date): Date[];
+  includesDate(date: Date | CronDate): boolean;
   /**
-   * Get an ES6 compatible iterator which iterates over the next dates starting from startDate or now.
-   * The iterator runs until the optional endDate is reached or forever.
+   * Returns the string representation of the cron expression.
+   * @returns {CronDate} - The next schedule date.
    */
-  getNextDatesIterator(startDate?: Date, endDate?: Date): Generator<Date, undefined, undefined>;
-  /** Gets the previous date starting from the given start date or now. */
-  getPrevDate(startDate?: Date): Date;
-  /** Gets the specified amount of previous dates starting from the given start date or now. */
-  getPrevDates(amount: number, startDate?: Date): Date[];
+  toString(): string;
   /**
-   * Get an ES6 compatible iterator which iterates over the previous dates starting from startDate or now.
-   * The iterator runs until the optional endDate is reached or forever.
+   * Returns an iterator for iterating through future CronDate instances
+   *
+   * @name Symbol.iterator
+   * @memberof CronExpression
+   * @returns {Iterator<CronDate>} An iterator object for CronExpression that returns CronDate values.
    */
-  getPrevDatesIterator(startDate?: Date, endDate?: Date): Generator<Date, undefined, undefined>;
-  /** Returns true when there is a cron date at the given date. */
-  matchDate(date: Date): boolean;
+  [Symbol.iterator](): Iterator<CronDate>;
 }
 //#endregion
 //#region ../trigger/dist/index.d.mts
@@ -108,7 +880,7 @@ type CronField = "*" | `${number}` | `${number}-${number}` | `*/${number}` | `${
  */
 type CronExpression = `${CronField} ${CronField} ${CronField} ${CronField} ${CronField}`;
 /**
- * Validates and brands a cron expression. Accepts anything the `cron-schedule`
+ * Validates and brands a cron expression. Accepts anything the `cron-parser`
  * engine accepts (5/6 fields, named months/weekdays, `@daily`-style nicknames)
  * so authoring validation never rejects a schedule the scheduler can run. The
  * `.brand()` makes `CronSchedule` nominally distinct from a plain `string`, so
@@ -130,8 +902,8 @@ declare function resolveCronSchedule(attachmentId: string, schedule: string, opt
   cronScheduleOverride?: string;
   attachmentScheduleOverrides?: Record<string, string>;
 }): string;
-/** Parse a schedule into a `cron-schedule` `Cron` instance (throws on invalid input). */
-declare function parseTriggerSchedule(schedule: string): Cron;
+/** Parse a schedule into a `cron-parser` expression (throws on invalid input). */
+declare function parseTriggerSchedule(schedule: string): CronExpression$1;
 /** The next time the schedule fires at or after `from`. */
 declare function nextTriggerRunAt(schedule: string, from?: Date): Date; //#endregion
 //#region src/attach-options.d.ts