@cloudsnorkel/cdk-github-runners 0.14.23 → 0.15.0

package/node_modules/cron-parser/dist/types/CronDate.d.ts

@@ -0,0 +1,288 @@
+export declare enum TimeUnit {
+    Second = "Second",
+    Minute = "Minute",
+    Hour = "Hour",
+    Day = "Day",
+    Month = "Month",
+    Year = "Year"
+}
+export declare enum DateMathOp {
+    Add = "Add",
+    Subtract = "Subtract"
+}
+export declare const DAYS_IN_MONTH: readonly number[];
+/**
+ * CronDate class that wraps the Luxon DateTime object to provide
+ * a consistent API for working with dates and times in the context of cron.
+ */
+export 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;
+}
+export default CronDate;

package/node_modules/cron-parser/dist/types/CronExpression.d.ts

@@ -0,0 +1,118 @@
+import { CronDate } from './CronDate';
+import { CronFieldCollection } from './CronFieldCollection';
+export 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;
+};
+/**
+ * Error message for when the current date is outside the specified time span.
+ */
+export declare const TIME_SPAN_OUT_OF_BOUNDS_ERROR_MESSAGE = "Out of the time span range";
+/**
+ * Error message for when the loop limit is exceeded during iteration.
+ */
+export declare const LOOPS_LIMIT_EXCEEDED_ERROR_MESSAGE = "Invalid expression, loop limit exceeded";
+/**
+ * Class representing a Cron expression.
+ */
+export declare class CronExpression {
+    #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;
+    /**
+     * 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;
+    /**
+     * 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
+     */
+    hasPrev(): boolean;
+    /**
+     * 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
+     */
+    take(limit: number): CronDate[];
+    /**
+     * 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
+     */
+    reset(newDate?: Date | CronDate): void;
+    /**
+     * 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
+     */
+    stringify(includeSeconds?: boolean): string;
+    /**
+     * Check if the cron expression includes the given date
+     * @param {Date|CronDate} date
+     * @returns {boolean}
+     */
+    includesDate(date: Date | CronDate): boolean;
+    /**
+     * Returns the string representation of the cron expression.
+     * @returns {CronDate} - The next schedule date.
+     */
+    toString(): string;
+    /**
+     * 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.
+     */
+    [Symbol.iterator](): Iterator<CronDate>;
+}
+export default CronExpression;

package/node_modules/cron-parser/dist/types/CronExpressionParser.d.ts

@@ -0,0 +1,70 @@
+import { CronExpression, CronExpressionOptions } from './CronExpression';
+export declare enum PredefinedExpressions {
+    '@yearly' = "0 0 0 1 1 *",
+    '@annually' = "0 0 0 1 1 *",
+    '@monthly' = "0 0 0 1 * *",
+    '@weekly' = "0 0 0 * * 0",
+    '@daily' = "0 0 0 * * *",
+    '@hourly' = "0 0 * * * *",
+    '@minutely' = "0 * * * * *",
+    '@secondly' = "* * * * * *",
+    '@weekdays' = "0 0 0 * * 1-5",
+    '@weekends' = "0 0 0 * * 0,6"
+}
+export declare enum CronUnit {
+    Second = "Second",
+    Minute = "Minute",
+    Hour = "Hour",
+    DayOfMonth = "DayOfMonth",
+    Month = "Month",
+    DayOfWeek = "DayOfWeek"
+}
+export declare enum Months {
+    jan = 1,
+    feb = 2,
+    mar = 3,
+    apr = 4,
+    may = 5,
+    jun = 6,
+    jul = 7,
+    aug = 8,
+    sep = 9,
+    oct = 10,
+    nov = 11,
+    dec = 12
+}
+export declare enum DayOfWeek {
+    sun = 0,
+    mon = 1,
+    tue = 2,
+    wed = 3,
+    thu = 4,
+    fri = 5,
+    sat = 6
+}
+export type RawCronFields = {
+    second: string;
+    minute: string;
+    hour: string;
+    dayOfMonth: string;
+    month: string;
+    dayOfWeek: string;
+};
+/**
+ * Static class that parses a cron expression and returns a CronExpression object.
+ * @static
+ * @class CronExpressionParser
+ */
+export declare class CronExpressionParser {
+    #private;
+    /**
+     * Parses a cron expression and returns a CronExpression object.
+     * @param {string} expression - The cron expression to parse.
+     * @param {CronExpressionOptions} [options={}] - The options to use when parsing the expression.
+     * @param {boolean} [options.strict=false] - If true, will throw an error if the expression contains both dayOfMonth and dayOfWeek.
+     * @param {CronDate} [options.currentDate=new CronDate(undefined, 'UTC')] - The date to use when calculating the next/previous occurrence.
+     *
+     * @returns {CronExpression} A CronExpression object.
+     */
+    static parse(expression: string, options?: CronExpressionOptions): CronExpression;
+}

package/node_modules/cron-parser/dist/types/CronFieldCollection.d.ts

@@ -0,0 +1,153 @@
+import { CronSecond, CronMinute, CronHour, CronDayOfMonth, CronMonth, CronDayOfWeek, CronField, SerializedCronField, CronChars } from './fields';
+import { SixtyRange, HourRange, DayOfMonthRange, MonthRange, DayOfWeekRange } from './fields/types';
+export type FieldRange = {
+    start: number | CronChars;
+    count: number;
+    end?: number;
+    step?: number;
+};
+export type CronFields = {
+    second: CronSecond;
+    minute: CronMinute;
+    hour: CronHour;
+    dayOfMonth: CronDayOfMonth;
+    month: CronMonth;
+    dayOfWeek: CronDayOfWeek;
+};
+export type CronFieldOverride = {
+    second?: CronSecond | SixtyRange[];
+    minute?: CronMinute | SixtyRange[];
+    hour?: CronHour | HourRange[];
+    dayOfMonth?: CronDayOfMonth | DayOfMonthRange[];
+    month?: CronMonth | MonthRange[];
+    dayOfWeek?: CronDayOfWeek | DayOfWeekRange[];
+};
+export type SerializedCronFields = {
+    second: SerializedCronField;
+    minute: SerializedCronField;
+    hour: SerializedCronField;
+    dayOfMonth: SerializedCronField;
+    month: SerializedCronField;
+    dayOfWeek: SerializedCronField;
+};
+/**
+ * Represents a complete set of cron fields.
+ * @class CronFieldCollection
+ */
+export 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({ 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): 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;
+}

package/node_modules/cron-parser/dist/types/CronFileParser.d.ts

@@ -0,0 +1,30 @@
+import { CronExpression } from './CronExpression';
+export type CronFileParserResult = {
+    variables: {
+        [key: string]: string;
+    };
+    expressions: CronExpression[];
+    errors: {
+        [key: string]: unknown;
+    };
+};
+/**
+ * Parser for crontab files that handles both synchronous and asynchronous operations.
+ */
+export declare class CronFileParser {
+    #private;
+    /**
+     * Parse a crontab file asynchronously
+     * @param filePath Path to crontab file
+     * @returns Promise resolving to parse results
+     * @throws If file cannot be read
+     */
+    static parseFile(filePath: string): Promise<CronFileParserResult>;
+    /**
+     * Parse a crontab file synchronously
+     * @param filePath Path to crontab file
+     * @returns Parse results
+     * @throws If file cannot be read
+     */
+    static parseFileSync(filePath: string): CronFileParserResult;
+}

package/node_modules/cron-parser/dist/types/fields/CronDayOfMonth.d.ts

@@ -0,0 +1,25 @@
+import { CronField, CronFieldOptions } from './CronField';
+import { CronChars, CronMax, CronMin, DayOfMonthRange } from './types';
+/**
+ * Represents the "day of the month" field within a cron expression.
+ * @class CronDayOfMonth
+ * @extends CronField
+ */
+export declare class CronDayOfMonth extends CronField {
+    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[];
+}