semola 0.5.1 → 0.5.3

package/dist/cron/builder/types.d.cts

@@ -0,0 +1,79 @@
+//#region src/lib/cron/builder/types.d.ts
+declare const WeekDay: {
+  readonly sun: 0;
+  readonly mon: 1;
+  readonly tue: 2;
+  readonly wed: 3;
+  readonly thu: 4;
+  readonly fri: 5;
+  readonly sat: 6;
+};
+declare const Month: {
+  readonly jan: 1;
+  readonly feb: 2;
+  readonly mar: 3;
+  readonly apr: 4;
+  readonly may: 5;
+  readonly jun: 6;
+  readonly jul: 7;
+  readonly aug: 8;
+  readonly sep: 9;
+  readonly oct: 10;
+  readonly nov: 11;
+  readonly dec: 12;
+};
+type Enumerate<N extends number, Acc extends number[] = []> = Acc["length"] extends N ? Acc[number] : Enumerate<N, [...Acc, Acc["length"]]>;
+type IntRange<F extends number, T extends number> = Exclude<Enumerate<T>, Enumerate<F>>;
+type TimeType = IntRange<0, 60>;
+type HourType = IntRange<0, 24>;
+type DayType = IntRange<1, 32>;
+type MonthType = IntRange<1, 13>;
+type WeekDayType = IntRange<0, 7>;
+type CronRange<T> = {
+  min: NoInfer<T>;
+  max: NoInfer<T>;
+};
+type CronStep<T> = {
+  step: NoInfer<T>;
+  range?: {
+    min: NoInfer<T>;
+    max?: NoInfer<T>;
+  };
+};
+type CronField = "second" | "minute" | "hour" | "day" | "month" | "weekday";
+type CronListExpr<T> = Exclude<CronExpr<T>, {
+  type: "list";
+}>;
+type CronExpr<T> = {
+  type: "any";
+} | {
+  type: "value";
+  value: T;
+} | {
+  type: "range";
+  min: T;
+  max: T;
+} | {
+  type: "step";
+  step: T;
+  range?: {
+    min: T;
+    max?: T;
+  };
+} | {
+  type: "list";
+  values: CronListExpr<T>[];
+};
+interface IBuilder<Used extends CronField> {
+  second(expr: CronExpr<TimeType>): CronBuilderType<Used | "second">;
+  minute(expr: CronExpr<TimeType>): CronBuilderType<Used | "minute">;
+  hour(expr: CronExpr<HourType>): CronBuilderType<Used | "hour">;
+  day(expr: CronExpr<DayType>): CronBuilderType<Used | "day">;
+  month(expr: CronExpr<MonthType>): CronBuilderType<Used | "month">;
+  weekday(expr: CronExpr<WeekDayType>): CronBuilderType<Used | "weekday">;
+}
+type CronBuilderType<Used extends CronField = never> = Omit<IBuilder<Used>, Used>;
+type BuilderFn = (builder: CronBuilderType) => void;
+//#endregion
+export { BuilderFn, CronExpr, CronListExpr, CronRange, CronStep, Month, WeekDay };
+//# sourceMappingURL=types.d.cts.map

package/dist/cron/builder/types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.cts","names":[],"sources":["../../../src/lib/cron/builder/types.ts"],"mappings":";cAAa,OAAA;EAAA;;;;;;;;cAUA,KAAA;EAAA;;;;;;;;;;;;;KAeR,SAAA,gDAGD,GAAA,mBAAsB,CAAA,GACtB,GAAA,WACA,SAAA,CAAU,CAAA,MAAO,GAAA,EAAK,GAAA;AAAA,KAErB,QAAA,uCAA+C,OAAA,CAClD,SAAA,CAAU,CAAA,GACV,SAAA,CAAU,CAAA;AAAA,KAGA,QAAA,GAAW,QAAA;AAAA,KACX,QAAA,GAAW,QAAA;AAAA,KACX,OAAA,GAAU,QAAA;AAAA,KACV,SAAA,GAAY,QAAA;AAAA,KACZ,WAAA,GAAc,QAAA;AAAA,KAEd,SAAA;EAAiB,GAAA,EAAK,OAAA,CAAQ,CAAA;EAAI,GAAA,EAAK,OAAA,CAAQ,CAAA;AAAA;AAAA,KAC/C,QAAA;EACV,IAAA,EAAM,OAAA,CAAQ,CAAA;EACd,KAAA;IAAU,GAAA,EAAK,OAAA,CAAQ,CAAA;IAAI,GAAA,GAAM,OAAA,CAAQ,CAAA;EAAA;AAAA;AAAA,KAG/B,SAAA;AAAA,KAQA,YAAA,MAAkB,OAAA,CAAQ,QAAA,CAAS,CAAA;EAAM,IAAA;AAAA;AAAA,KAEzC,QAAA;EACN,IAAA;AAAA;EACA,IAAA;EAAe,KAAA,EAAO,CAAA;AAAA;EACtB,IAAA;EAAe,GAAA,EAAK,CAAA;EAAG,GAAA,EAAK,CAAA;AAAA;EAC5B,IAAA;EAAc,IAAA,EAAM,CAAA;EAAG,KAAA;IAAU,GAAA,EAAK,CAAA;IAAG,GAAA,GAAM,CAAA;EAAA;AAAA;EAC/C,IAAA;EAAc,MAAA,EAAQ,YAAA,CAAa,CAAA;AAAA;AAAA,UAE/B,QAAA,cAAsB,SAAA;EAC9B,MAAA,CAAO,IAAA,EAAM,QAAA,CAAS,QAAA,IAAY,eAAA,CAAgB,IAAA;EAClD,MAAA,CAAO,IAAA,EAAM,QAAA,CAAS,QAAA,IAAY,eAAA,CAAgB,IAAA;EAClD,IAAA,CAAK,IAAA,EAAM,QAAA,CAAS,QAAA,IAAY,eAAA,CAAgB,IAAA;EAChD,GAAA,CAAI,IAAA,EAAM,QAAA,CAAS,OAAA,IAAW,eAAA,CAAgB,IAAA;EAC9C,KAAA,CAAM,IAAA,EAAM,QAAA,CAAS,SAAA,IAAa,eAAA,CAAgB,IAAA;EAClD,OAAA,CAAQ,IAAA,EAAM,QAAA,CAAS,WAAA,IAAe,eAAA,CAAgB,IAAA;AAAA;AAAA,KAG5C,eAAA,cAA6B,SAAA,YAAqB,IAAA,CAC5D,QAAA,CAAS,IAAA,GACT,IAAA;AAAA,KAGU,SAAA,IAAa,OAAA,EAAS,eAAA"}

package/dist/cron/builder/types.d.mts

@@ -0,0 +1,79 @@
+//#region src/lib/cron/builder/types.d.ts
+declare const WeekDay: {
+  readonly sun: 0;
+  readonly mon: 1;
+  readonly tue: 2;
+  readonly wed: 3;
+  readonly thu: 4;
+  readonly fri: 5;
+  readonly sat: 6;
+};
+declare const Month: {
+  readonly jan: 1;
+  readonly feb: 2;
+  readonly mar: 3;
+  readonly apr: 4;
+  readonly may: 5;
+  readonly jun: 6;
+  readonly jul: 7;
+  readonly aug: 8;
+  readonly sep: 9;
+  readonly oct: 10;
+  readonly nov: 11;
+  readonly dec: 12;
+};
+type Enumerate<N extends number, Acc extends number[] = []> = Acc["length"] extends N ? Acc[number] : Enumerate<N, [...Acc, Acc["length"]]>;
+type IntRange<F extends number, T extends number> = Exclude<Enumerate<T>, Enumerate<F>>;
+type TimeType = IntRange<0, 60>;
+type HourType = IntRange<0, 24>;
+type DayType = IntRange<1, 32>;
+type MonthType = IntRange<1, 13>;
+type WeekDayType = IntRange<0, 7>;
+type CronRange<T> = {
+  min: NoInfer<T>;
+  max: NoInfer<T>;
+};
+type CronStep<T> = {
+  step: NoInfer<T>;
+  range?: {
+    min: NoInfer<T>;
+    max?: NoInfer<T>;
+  };
+};
+type CronField = "second" | "minute" | "hour" | "day" | "month" | "weekday";
+type CronListExpr<T> = Exclude<CronExpr<T>, {
+  type: "list";
+}>;
+type CronExpr<T> = {
+  type: "any";
+} | {
+  type: "value";
+  value: T;
+} | {
+  type: "range";
+  min: T;
+  max: T;
+} | {
+  type: "step";
+  step: T;
+  range?: {
+    min: T;
+    max?: T;
+  };
+} | {
+  type: "list";
+  values: CronListExpr<T>[];
+};
+interface IBuilder<Used extends CronField> {
+  second(expr: CronExpr<TimeType>): CronBuilderType<Used | "second">;
+  minute(expr: CronExpr<TimeType>): CronBuilderType<Used | "minute">;
+  hour(expr: CronExpr<HourType>): CronBuilderType<Used | "hour">;
+  day(expr: CronExpr<DayType>): CronBuilderType<Used | "day">;
+  month(expr: CronExpr<MonthType>): CronBuilderType<Used | "month">;
+  weekday(expr: CronExpr<WeekDayType>): CronBuilderType<Used | "weekday">;
+}
+type CronBuilderType<Used extends CronField = never> = Omit<IBuilder<Used>, Used>;
+type BuilderFn = (builder: CronBuilderType) => void;
+//#endregion
+export { BuilderFn, CronExpr, CronListExpr, CronRange, CronStep, Month, WeekDay };
+//# sourceMappingURL=types.d.mts.map

package/dist/cron/builder/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../src/lib/cron/builder/types.ts"],"mappings":";cAAa,OAAA;EAAA;;;;;;;;cAUA,KAAA;EAAA;;;;;;;;;;;;;KAeR,SAAA,gDAGD,GAAA,mBAAsB,CAAA,GACtB,GAAA,WACA,SAAA,CAAU,CAAA,MAAO,GAAA,EAAK,GAAA;AAAA,KAErB,QAAA,uCAA+C,OAAA,CAClD,SAAA,CAAU,CAAA,GACV,SAAA,CAAU,CAAA;AAAA,KAGA,QAAA,GAAW,QAAA;AAAA,KACX,QAAA,GAAW,QAAA;AAAA,KACX,OAAA,GAAU,QAAA;AAAA,KACV,SAAA,GAAY,QAAA;AAAA,KACZ,WAAA,GAAc,QAAA;AAAA,KAEd,SAAA;EAAiB,GAAA,EAAK,OAAA,CAAQ,CAAA;EAAI,GAAA,EAAK,OAAA,CAAQ,CAAA;AAAA;AAAA,KAC/C,QAAA;EACV,IAAA,EAAM,OAAA,CAAQ,CAAA;EACd,KAAA;IAAU,GAAA,EAAK,OAAA,CAAQ,CAAA;IAAI,GAAA,GAAM,OAAA,CAAQ,CAAA;EAAA;AAAA;AAAA,KAG/B,SAAA;AAAA,KAQA,YAAA,MAAkB,OAAA,CAAQ,QAAA,CAAS,CAAA;EAAM,IAAA;AAAA;AAAA,KAEzC,QAAA;EACN,IAAA;AAAA;EACA,IAAA;EAAe,KAAA,EAAO,CAAA;AAAA;EACtB,IAAA;EAAe,GAAA,EAAK,CAAA;EAAG,GAAA,EAAK,CAAA;AAAA;EAC5B,IAAA;EAAc,IAAA,EAAM,CAAA;EAAG,KAAA;IAAU,GAAA,EAAK,CAAA;IAAG,GAAA,GAAM,CAAA;EAAA;AAAA;EAC/C,IAAA;EAAc,MAAA,EAAQ,YAAA,CAAa,CAAA;AAAA;AAAA,UAE/B,QAAA,cAAsB,SAAA;EAC9B,MAAA,CAAO,IAAA,EAAM,QAAA,CAAS,QAAA,IAAY,eAAA,CAAgB,IAAA;EAClD,MAAA,CAAO,IAAA,EAAM,QAAA,CAAS,QAAA,IAAY,eAAA,CAAgB,IAAA;EAClD,IAAA,CAAK,IAAA,EAAM,QAAA,CAAS,QAAA,IAAY,eAAA,CAAgB,IAAA;EAChD,GAAA,CAAI,IAAA,EAAM,QAAA,CAAS,OAAA,IAAW,eAAA,CAAgB,IAAA;EAC9C,KAAA,CAAM,IAAA,EAAM,QAAA,CAAS,SAAA,IAAa,eAAA,CAAgB,IAAA;EAClD,OAAA,CAAQ,IAAA,EAAM,QAAA,CAAS,WAAA,IAAe,eAAA,CAAgB,IAAA;AAAA;AAAA,KAG5C,eAAA,cAA6B,SAAA,YAAqB,IAAA,CAC5D,QAAA,CAAS,IAAA,GACT,IAAA;AAAA,KAGU,SAAA,IAAa,OAAA,EAAS,eAAA"}

package/dist/cron/builder/types.mjs

@@ -0,0 +1,28 @@
+//#region src/lib/cron/builder/types.ts
+const WeekDay = {
+	sun: 0,
+	mon: 1,
+	tue: 2,
+	wed: 3,
+	thu: 4,
+	fri: 5,
+	sat: 6
+};
+const Month = {
+	jan: 1,
+	feb: 2,
+	mar: 3,
+	apr: 4,
+	may: 5,
+	jun: 6,
+	jul: 7,
+	aug: 8,
+	sep: 9,
+	oct: 10,
+	nov: 11,
+	dec: 12
+};
+//#endregion
+export { Month, WeekDay };
+
+//# sourceMappingURL=types.mjs.map

package/dist/cron/builder/types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.mjs","names":[],"sources":["../../../src/lib/cron/builder/types.ts"],"sourcesContent":["export const WeekDay = {\n  sun: 0,\n  mon: 1,\n  tue: 2,\n  wed: 3,\n  thu: 4,\n  fri: 5,\n  sat: 6,\n} as const;\n\nexport const Month = {\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} as const;\n\ntype Enumerate<\n  N extends number,\n  Acc extends number[] = [],\n> = Acc[\"length\"] extends N\n  ? Acc[number]\n  : Enumerate<N, [...Acc, Acc[\"length\"]]>;\n\ntype IntRange<F extends number, T extends number> = Exclude<\n  Enumerate<T>,\n  Enumerate<F>\n>;\n\nexport type TimeType = IntRange<0, 60>; // 0–59\nexport type HourType = IntRange<0, 24>; // 0–23\nexport type DayType = IntRange<1, 32>; // 1–31\nexport type MonthType = IntRange<1, 13>; // 1–12\nexport type WeekDayType = IntRange<0, 7>; // 0–6\n\nexport type CronRange<T> = { min: NoInfer<T>; max: NoInfer<T> };\nexport type CronStep<T> = {\n  step: NoInfer<T>;\n  range?: { min: NoInfer<T>; max?: NoInfer<T> };\n};\n\nexport type CronField =\n  | \"second\"\n  | \"minute\"\n  | \"hour\"\n  | \"day\"\n  | \"month\"\n  | \"weekday\";\n\nexport type CronListExpr<T> = Exclude<CronExpr<T>, { type: \"list\" }>;\n\nexport type CronExpr<T> =\n  | { type: \"any\" }\n  | { type: \"value\"; value: T }\n  | { type: \"range\"; min: T; max: T }\n  | { type: \"step\"; step: T; range?: { min: T; max?: T } }\n  | { type: \"list\"; values: CronListExpr<T>[] };\n\ninterface IBuilder<Used extends CronField> {\n  second(expr: CronExpr<TimeType>): CronBuilderType<Used | \"second\">;\n  minute(expr: CronExpr<TimeType>): CronBuilderType<Used | \"minute\">;\n  hour(expr: CronExpr<HourType>): CronBuilderType<Used | \"hour\">;\n  day(expr: CronExpr<DayType>): CronBuilderType<Used | \"day\">;\n  month(expr: CronExpr<MonthType>): CronBuilderType<Used | \"month\">;\n  weekday(expr: CronExpr<WeekDayType>): CronBuilderType<Used | \"weekday\">;\n}\n\nexport type CronBuilderType<Used extends CronField = never> = Omit<\n  IBuilder<Used>,\n  Used\n>;\n\nexport type BuilderFn = (builder: CronBuilderType) => void;\n"],"mappings":";AAAA,MAAa,UAAU;CACrB,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACN;AAED,MAAa,QAAQ;CACnB,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACN"}

package/dist/cron/core/index.cjs

@@ -0,0 +1,308 @@
+const require_lib_errors_index = require("../../lib/errors/index.cjs");
+const require_scanner = require("./scanner.cjs");
+//#region src/lib/cron/core/index.ts
+const RETRY_DELAY_MS = 3600 * 1e3;
+const MAX_YEARS = 4;
+const ALIASES = {
+	"@yearly": "0 0 1 1 *",
+	"@monthly": "0 0 1 * *",
+	"@weekly": "0 0 * * 0",
+	"@daily": "0 0 * * *",
+	"@hourly": "0 * * * *",
+	"@minutely": "* * * * *"
+};
+const CronSecondRange = {
+	min: 0,
+	max: 59
+};
+const CronMinuteRange = {
+	min: 0,
+	max: 59
+};
+const CronHourRange = {
+	min: 0,
+	max: 23
+};
+const CronDayRange = {
+	min: 1,
+	max: 31
+};
+const CronMonthRange = {
+	min: 1,
+	max: 12
+};
+const CronDayOfWeekRange = {
+	min: 0,
+	max: 6
+};
+var Cron = class {
+	options;
+	status = "idle";
+	timeoutId = null;
+	second = Array(CronSecondRange.max + 1).fill(0);
+	minute = Array(CronMinuteRange.max + 1).fill(0);
+	hour = Array(CronHourRange.max + 1).fill(0);
+	day = Array(CronDayRange.max + 1).fill(0);
+	month = Array(CronMonthRange.max + 1).fill(0);
+	dayOfWeek = Array(CronDayOfWeekRange.max + 1).fill(0);
+	hasSeconds;
+	_dayWildcard = false;
+	_dowWildcard = false;
+	fillRange(values, min, max) {
+		for (let i = min; i <= max; i++) values[i] = 1;
+	}
+	handleStep(part, values, min, max) {
+		const [rangePart, stepStr] = part.split("/");
+		if (!rangePart) return require_lib_errors_index.err("InvalidValueError", `'${rangePart}' is empty`);
+		if (!stepStr) return require_lib_errors_index.err("InvalidValueError", `'${stepStr}' is empty`);
+		const step = Number(stepStr);
+		if (!Number.isInteger(step)) return require_lib_errors_index.err("InvalidValueError", `'${step}' is not a valid number`);
+		if (step <= 0) return require_lib_errors_index.err("OutOfBoundError", `Expected ${step} > 0`);
+		if (rangePart === "*") {
+			for (let i = min; i <= max; i += step) values[i] = 1;
+			return require_lib_errors_index.ok(true);
+		}
+		if (rangePart.includes("-")) return this.handleStepRange(rangePart, step, values, min, max);
+		return this.handleStepSingle(rangePart, step, values, min, max);
+	}
+	handleStepRange(range, step, values, min, max) {
+		const [startStr, endStr] = range.split("-");
+		if (!endStr) return require_lib_errors_index.err("InvalidValueError", `'${endStr}' is empty`);
+		let start = min;
+		if (startStr && startStr.length > 0) start = Number(startStr);
+		const end = Number(endStr);
+		if (!Number.isInteger(start)) return require_lib_errors_index.err("InvalidValueError", `'${start}' is not a valid number`);
+		if (!Number.isInteger(end)) return require_lib_errors_index.err("InvalidValueError", `'${end}' is not a valid number`);
+		if (start < min) return require_lib_errors_index.err("OutOfBoundError", `Expected ${start} >= ${min}`);
+		if (end > max) return require_lib_errors_index.err("OutOfBoundError", `Expected ${end} <= ${max}`);
+		if (start > end) return require_lib_errors_index.err("OutOfBoundError", `Expected ${start} <= ${end}`);
+		for (let i = start; i <= end; i += step) values[i] = 1;
+		return require_lib_errors_index.ok(true);
+	}
+	handleStepSingle(value, step, values, min, max) {
+		const start = Number(value);
+		if (!Number.isInteger(start)) return require_lib_errors_index.err("InvalidValueError", `'${start}' is not a valid number`);
+		if (start < min) return require_lib_errors_index.err("OutOfBoundError", `Expected ${start} >= ${min}`);
+		if (start > max) return require_lib_errors_index.err("OutOfBoundError", `Expected ${start} <= ${max}`);
+		for (let i = start; i <= max; i += step) values[i] = 1;
+		return require_lib_errors_index.ok(true);
+	}
+	handleRange(part, values, min, max) {
+		const [startStr, endStr] = part.split("-");
+		if (!startStr) return require_lib_errors_index.err("InvalidValueError", `'${startStr}' is empty`);
+		if (!endStr) return require_lib_errors_index.err("InvalidValueError", `'${endStr}' is empty`);
+		const start = Number(startStr);
+		const end = Number(endStr);
+		if (!Number.isInteger(start)) return require_lib_errors_index.err("InvalidValueError", `'${start}' is not a valid number`);
+		if (!Number.isInteger(end)) return require_lib_errors_index.err("InvalidValueError", `'${end}' is not a valid number`);
+		if (start < min) return require_lib_errors_index.err("OutOfBoundError", `Expected ${start} >= ${min}`);
+		if (end > max) return require_lib_errors_index.err("OutOfBoundError", `Expected ${end} <= ${max}`);
+		if (start > end) return require_lib_errors_index.err("OutOfBoundError", `Expected ${start} <= ${end}`);
+		for (let i = start; i <= end; i++) values[i] = 1;
+		return require_lib_errors_index.ok(true);
+	}
+	handleNumber(value, values, min, max) {
+		const n = Number(value);
+		if (!Number.isInteger(n)) return require_lib_errors_index.err("InvalidValueError", `'${value}' is not a valid number`);
+		if (n < min) return require_lib_errors_index.err("OutOfBoundError", `Expected ${n} >= ${min}`);
+		if (n > max) return require_lib_errors_index.err("OutOfBoundError", `Expected ${n} <= ${max}`);
+		values[n] = 1;
+		return require_lib_errors_index.ok(true);
+	}
+	constructor(options) {
+		this.options = options;
+		const expr = this.resolveAlias(options.schedule);
+		const [error, tokens] = new require_scanner.Scanner(expr).scan();
+		if (error) throw new Error(`${error.type}: ${error.message}`);
+		this.hasSeconds = expr.trim().split(/\s+/).length === require_scanner.FieldAmount.max;
+		const [parsingError, _] = this.parse(tokens);
+		if (parsingError) throw new Error(`${parsingError.type}: ${parsingError.message}`);
+	}
+	resolveAlias(schedule) {
+		return ALIASES[schedule] || schedule;
+	}
+	parse(tokens) {
+		for (let i = 0; i < tokens.length; i++) {
+			const token = tokens[i];
+			if (!token) return require_lib_errors_index.err("InvalidValueError", "Undefined token");
+			const tokenType = token.getTokenType();
+			switch (token.getField()) {
+				case "second": {
+					const [error, _] = this.handleField(token, this.second, CronSecondRange.min, CronSecondRange.max);
+					if (error) return require_lib_errors_index.err(error.type, `${error.message} in field '${token.getField()}'`);
+					break;
+				}
+				case "minute": {
+					const [error, _] = this.handleField(token, this.minute, CronMinuteRange.min, CronMinuteRange.max);
+					if (error) return require_lib_errors_index.err(error.type, `${error.message} in field '${token.getField()}'`);
+					break;
+				}
+				case "hour": {
+					const [error, _] = this.handleField(token, this.hour, CronHourRange.min, CronHourRange.max);
+					if (error) return require_lib_errors_index.err(error.type, `${error.message} in field '${token.getField()}'`);
+					break;
+				}
+				case "day": {
+					if (tokenType === "any") this._dayWildcard = true;
+					const [error, _] = this.handleField(token, this.day, CronDayRange.min, CronDayRange.max);
+					if (error) return require_lib_errors_index.err(error.type, `${error.message} in field '${token.getField()}'`);
+					break;
+				}
+				case "month": {
+					const [error, _] = this.handleField(token, this.month, CronMonthRange.min, CronMonthRange.max);
+					if (error) return require_lib_errors_index.err(error.type, `${error.message} in field '${token.getField()}'`);
+					break;
+				}
+				case "weekday": {
+					if (tokenType === "any") this._dowWildcard = true;
+					const [error, _] = this.handleField(token, this.dayOfWeek, CronDayOfWeekRange.min, CronDayOfWeekRange.max);
+					if (error) return require_lib_errors_index.err(error.type, `${error.message} in field '${token.getField()}'`);
+					break;
+				}
+				default: return require_lib_errors_index.err("InvalidValueError", `Invalid field '${token.getField()}'`);
+			}
+		}
+		return require_lib_errors_index.ok(true);
+	}
+	handleField(token, field, min, max) {
+		switch (token.getTokenType()) {
+			case "any":
+				this.fillRange(field, min, max);
+				break;
+			case "number": {
+				const [error, _] = this.handleNumber(token.getComponent(), field, min, max);
+				if (error) return require_lib_errors_index.err(error.type, error.message);
+				break;
+			}
+			case "range": {
+				const component = token.getComponent();
+				const [error, _] = this.handleRange(component, field, min, max);
+				if (error) return require_lib_errors_index.err(error.type, error.message);
+				break;
+			}
+			case "step": {
+				const component = token.getComponent();
+				const [error, _] = this.handleStep(component, field, min, max);
+				if (error) return require_lib_errors_index.err(error.type, error.message);
+				break;
+			}
+			default: return require_lib_errors_index.err("InvalidValueError", `Invalid token type '${token.getTokenType()}'`);
+		}
+		return require_lib_errors_index.ok(true);
+	}
+	matches(date) {
+		const s = date.getSeconds();
+		const m = date.getMinutes();
+		const h = date.getHours();
+		const d = date.getDate();
+		const mon = date.getMonth();
+		const dow = date.getDay();
+		const isSecondMatch = this.hasSeconds ? this.second[s] === 1 : true;
+		const isMinuteMatch = this.minute[m] === 1;
+		const isHourMatch = this.hour[h] === 1;
+		const isMonthMatch = this.month[mon + 1] === 1;
+		let isDayOrDowMatch;
+		if (!this._dayWildcard && !this._dowWildcard) isDayOrDowMatch = this.day[d] === 1 || this.dayOfWeek[dow] === 1;
+		else isDayOrDowMatch = this.day[d] === 1 && this.dayOfWeek[dow] === 1;
+		return isSecondMatch && isMinuteMatch && isHourMatch && isDayOrDowMatch && isMonthMatch;
+	}
+	getNextRun() {
+		const date = /* @__PURE__ */ new Date();
+		if (this.hasSeconds) {
+			date.setMilliseconds(0);
+			date.setSeconds(date.getSeconds() + 1);
+		} else {
+			date.setSeconds(0, 0);
+			date.setMinutes(date.getMinutes() + 1);
+		}
+		const deadline = new Date(date);
+		deadline.setFullYear(deadline.getFullYear() + MAX_YEARS);
+		while (date < deadline) {
+			const s = date.getSeconds();
+			const m = date.getMinutes();
+			const h = date.getHours();
+			const d = date.getDate();
+			const mon = date.getMonth();
+			const dow = date.getDay();
+			if (this.month[mon + 1] === 0) {
+				date.setDate(1);
+				date.setMonth(mon + 1);
+				date.setHours(0, 0, 0, 0);
+				continue;
+			}
+			let isDayOrDowMatch;
+			if (!this._dayWildcard && !this._dowWildcard) isDayOrDowMatch = this.day[d] === 0 && this.dayOfWeek[dow] === 0;
+			else isDayOrDowMatch = this.day[d] === 0 || this.dayOfWeek[dow] === 0;
+			if (isDayOrDowMatch) {
+				date.setDate(d + 1);
+				date.setHours(0, 0, 0, 0);
+				continue;
+			}
+			if (this.hour[h] === 0) {
+				date.setHours(h + 1);
+				date.setMinutes(0, 0, 0);
+				continue;
+			}
+			if (this.minute[m] === 0) {
+				date.setMinutes(m + 1);
+				date.setSeconds(0, 0);
+				continue;
+			}
+			if (this.hasSeconds && this.second[s] === 0) {
+				date.setSeconds(s + 1);
+				date.setMilliseconds(0);
+				continue;
+			}
+			return new Date(date);
+		}
+		return null;
+	}
+	start() {
+		if (this.status !== "idle") return;
+		this.status = "running";
+		this.next();
+	}
+	stop() {
+		this.status = "idle";
+		if (this.timeoutId) {
+			clearTimeout(this.timeoutId);
+			this.timeoutId = null;
+		}
+	}
+	pause() {
+		if (this.status !== "running") return;
+		this.status = "paused";
+		if (this.timeoutId) {
+			clearTimeout(this.timeoutId);
+			this.timeoutId = null;
+		}
+	}
+	resume() {
+		if (this.status !== "paused") return;
+		this.status = "running";
+		this.next();
+	}
+	getStatus() {
+		return this.status;
+	}
+	next() {
+		if (this.status !== "running") return;
+		const nextRun = this.getNextRun();
+		if (!nextRun) {
+			this.timeoutId = setTimeout(() => this.next(), RETRY_DELAY_MS);
+			return;
+		}
+		const delay = nextRun.getTime() - Date.now();
+		this.timeoutId = setTimeout(() => {
+			this.run();
+		}, Math.max(0, delay));
+	}
+	async run() {
+		if (this.status !== "running") return;
+		const handlerResult = this.options.handler();
+		await require_lib_errors_index.mightThrow(Promise.resolve(handlerResult));
+		if (this.status === "running") this.next();
+	}
+};
+//#endregion
+exports.Cron = Cron;

package/dist/cron/core/index.d.cts

@@ -0,0 +1,39 @@
+import { CronOptions, CronStatus } from "./types.cjs";
+
+//#region src/lib/cron/core/index.d.ts
+declare class Cron {
+  private options;
+  private status;
+  private timeoutId;
+  private second;
+  private minute;
+  private hour;
+  private day;
+  private month;
+  private dayOfWeek;
+  private hasSeconds;
+  private _dayWildcard;
+  private _dowWildcard;
+  private fillRange;
+  private handleStep;
+  private handleStepRange;
+  private handleStepSingle;
+  private handleRange;
+  private handleNumber;
+  constructor(options: CronOptions);
+  private resolveAlias;
+  private parse;
+  private handleField;
+  matches(date: Date): boolean;
+  getNextRun(): Date | null;
+  start(): void;
+  stop(): void;
+  pause(): void;
+  resume(): void;
+  getStatus(): CronStatus;
+  private next;
+  private run;
+}
+//#endregion
+export { Cron };
+//# sourceMappingURL=index.d.cts.map

package/dist/cron/core/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../../src/lib/cron/core/index.ts"],"mappings":";;;cA8Ca,IAAA;EAAA,QACH,OAAA;EAAA,QACA,MAAA;EAAA,QACA,SAAA;EAAA,QAGA,MAAA;EAAA,QACA,MAAA;EAAA,QACA,IAAA;EAAA,QACA,GAAA;EAAA,QACA,KAAA;EAAA,QACA,SAAA;EAAA,QACA,UAAA;EAAA,QACA,YAAA;EAAA,QACA,YAAA;EAAA,QAGA,SAAA;EAAA,QAMA,UAAA;EAAA,QAkDA,eAAA;EAAA,QAiEA,gBAAA;EAAA,QAuCA,WAAA;EAAA,QAmEA,YAAA;cAkCW,OAAA,EAAS,WAAA;EAAA,QAoBpB,YAAA;EAAA,QAIA,KAAA;EAAA,QAoIA,WAAA;EAyCD,OAAA,CAAQ,IAAA,EAAM,IAAA;EAkCd,UAAA,CAAA,GAAU,IAAA;EAoEV,KAAA,CAAA;EAOA,IAAA,CAAA;EASA,KAAA,CAAA;EAWA,MAAA,CAAA;EAOA,SAAA,CAAA,GAAS,UAAA;EAAA,QAIR,IAAA;EAAA,QAkBM,GAAA;AAAA"}

package/dist/cron/core/index.d.mts

@@ -0,0 +1,39 @@
+import { CronOptions, CronStatus } from "./types.mjs";
+
+//#region src/lib/cron/core/index.d.ts
+declare class Cron {
+  private options;
+  private status;
+  private timeoutId;
+  private second;
+  private minute;
+  private hour;
+  private day;
+  private month;
+  private dayOfWeek;
+  private hasSeconds;
+  private _dayWildcard;
+  private _dowWildcard;
+  private fillRange;
+  private handleStep;
+  private handleStepRange;
+  private handleStepSingle;
+  private handleRange;
+  private handleNumber;
+  constructor(options: CronOptions);
+  private resolveAlias;
+  private parse;
+  private handleField;
+  matches(date: Date): boolean;
+  getNextRun(): Date | null;
+  start(): void;
+  stop(): void;
+  pause(): void;
+  resume(): void;
+  getStatus(): CronStatus;
+  private next;
+  private run;
+}
+//#endregion
+export { Cron };
+//# sourceMappingURL=index.d.mts.map

package/dist/cron/core/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../src/lib/cron/core/index.ts"],"mappings":";;;cA8Ca,IAAA;EAAA,QACH,OAAA;EAAA,QACA,MAAA;EAAA,QACA,SAAA;EAAA,QAGA,MAAA;EAAA,QACA,MAAA;EAAA,QACA,IAAA;EAAA,QACA,GAAA;EAAA,QACA,KAAA;EAAA,QACA,SAAA;EAAA,QACA,UAAA;EAAA,QACA,YAAA;EAAA,QACA,YAAA;EAAA,QAGA,SAAA;EAAA,QAMA,UAAA;EAAA,QAkDA,eAAA;EAAA,QAiEA,gBAAA;EAAA,QAuCA,WAAA;EAAA,QAmEA,YAAA;cAkCW,OAAA,EAAS,WAAA;EAAA,QAoBpB,YAAA;EAAA,QAIA,KAAA;EAAA,QAoIA,WAAA;EAyCD,OAAA,CAAQ,IAAA,EAAM,IAAA;EAkCd,UAAA,CAAA,GAAU,IAAA;EAoEV,KAAA,CAAA;EAOA,IAAA,CAAA;EASA,KAAA,CAAA;EAWA,MAAA,CAAA;EAOA,SAAA,CAAA,GAAS,UAAA;EAAA,QAIR,IAAA;EAAA,QAkBM,GAAA;AAAA"}