semola 0.5.0 → 0.5.2

package/dist/lib/cron/index.mjs

@@ -0,0 +1,277 @@
+import { err, mightThrow, ok } from "../errors/index.mjs";
+import { FieldAmount, Scanner } from "../../cron/scanner.mjs";
+//#region src/lib/cron/index.ts
+const RETRY_DELAY_MS = 3600 * 1e3;
+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 err("InvalidValueError", `'${rangePart}' is empty`);
+		if (!stepStr) return err("InvalidValueError", `'${stepStr}' is empty`);
+		const step = Number(stepStr);
+		if (!Number.isInteger(step)) return err("InvalidValueError", `'${step}' is not a valid number`);
+		if (step <= 0) return err("OutOfBoundError", `Expected ${step} > 0`);
+		if (rangePart === "*") {
+			for (let i = min; i <= max; i += step) values[i] = 1;
+			return 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 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 err("InvalidValueError", `'${start}' is not a valid number`);
+		if (!Number.isInteger(end)) return err("InvalidValueError", `'${end}' is not a valid number`);
+		if (start < min) return err("OutOfBoundError", `Expected ${start} >= ${min}`);
+		if (end > max) return err("OutOfBoundError", `Expected ${end} <= ${max}`);
+		if (start > end) return err("OutOfBoundError", `Expected ${start} <= ${end}`);
+		for (let i = start; i <= end; i += step) values[i] = 1;
+		return ok(true);
+	}
+	handleStepSingle(value, step, values, min, max) {
+		const start = Number(value);
+		if (!Number.isInteger(start)) return err("InvalidValueError", `'${start}' is not a valid number`);
+		if (start < min) return err("OutOfBoundError", `Expected ${start} >= ${min}`);
+		if (start > max) return err("OutOfBoundError", `Expected ${start} <= ${max}`);
+		for (let i = start; i <= max; i += step) values[i] = 1;
+		return ok(true);
+	}
+	handleRange(part, values, min, max) {
+		const [startStr, endStr] = part.split("-");
+		if (!startStr) return err("InvalidValueError", `'${startStr}' is empty`);
+		if (!endStr) return err("InvalidValueError", `'${endStr}' is empty`);
+		const start = Number(startStr);
+		const end = Number(endStr);
+		if (!Number.isInteger(start)) return err("InvalidValueError", `'${start}' is not a valid number`);
+		if (!Number.isInteger(end)) return err("InvalidValueError", `'${end}' is not a valid number`);
+		if (start < min) return err("OutOfBoundError", `Expected ${start} >= ${min}`);
+		if (end > max) return err("OutOfBoundError", `Expected ${end} <= ${max}`);
+		if (start > end) return err("OutOfBoundError", `Expected ${start} <= ${end}`);
+		for (let i = start; i <= end; i++) values[i] = 1;
+		return ok(true);
+	}
+	handleNumber(value, values, min, max) {
+		const n = Number(value);
+		if (!Number.isInteger(n)) return err("InvalidValueError", `'${value}' is not a valid number`);
+		if (n < min) return err("OutOfBoundError", `Expected ${n} >= ${min}`);
+		if (n > max) return err("OutOfBoundError", `Expected ${n} <= ${max}`);
+		values[n] = 1;
+		return ok(true);
+	}
+	constructor(options) {
+		this.options = options;
+		const expr = this.resolveAlias(options.schedule);
+		const [error, tokens] = new Scanner(expr).scan();
+		if (error) throw new Error(`${error.type}: ${error.message}`);
+		this.hasSeconds = expr.trim().split(/\s+/).length === 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 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 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 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 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 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 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 err(error.type, `${error.message} in field '${token.getField()}'`);
+					break;
+				}
+				default: return err("InvalidValueError", `Invalid field '${token.getField()}'`);
+			}
+		}
+		return 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 err(error.type, error.message);
+				break;
+			}
+			case "range": {
+				const component = token.getComponent();
+				const [error, _] = this.handleRange(component, field, min, max);
+				if (error) return err(error.type, error.message);
+				break;
+			}
+			case "step": {
+				const component = token.getComponent();
+				const [error, _] = this.handleStep(component, field, min, max);
+				if (error) return err(error.type, error.message);
+				break;
+			}
+			default: return err("InvalidValueError", `Invalid token type '${token.getTokenType()}'`);
+		}
+		return 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(/* @__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 maxIterations = this.hasSeconds ? 366 * 4 * 24 * 3600 : 366 * 4 * 24 * 60;
+		for (let i = 0; i < maxIterations; i++) {
+			if (this.matches(date)) {
+				if (date > /* @__PURE__ */ new Date()) return new Date(date);
+			}
+			if (this.hasSeconds) date.setSeconds(date.getSeconds() + 1);
+			else date.setMinutes(date.getMinutes() + 1);
+		}
+		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 mightThrow(Promise.resolve(handlerResult));
+		if (this.status === "running") this.next();
+	}
+};
+//#endregion
+export { Cron };
+
+//# sourceMappingURL=index.mjs.map

package/dist/lib/cron/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/lib/cron/index.ts"],"sourcesContent":["import { err, mightThrow, ok } from \"../errors/index.js\";\nimport { FieldAmount, Scanner, type Token } from \"./scanner.js\";\nimport type { CronOptions, CronParsingError, CronStatus } from \"./types.js\";\n\nconst RETRY_DELAY_MS = 60 * 60 * 1000; // 1 hour\n\nconst ALIASES: Record<string, string> = {\n  \"@yearly\": \"0 0 1 1 *\",\n  \"@monthly\": \"0 0 1 * *\",\n  \"@weekly\": \"0 0 * * 0\",\n  \"@daily\": \"0 0 * * *\",\n  \"@hourly\": \"0 * * * *\",\n  \"@minutely\": \"* * * * *\",\n};\n\nconst CronSecondRange = {\n  min: 0,\n  max: 59,\n} as const;\n\nconst CronMinuteRange = {\n  min: 0,\n  max: 59,\n} as const;\n\nconst CronHourRange = {\n  min: 0,\n  max: 23,\n} as const;\n\nconst CronDayRange = {\n  min: 1,\n  max: 31,\n} as const;\n\nconst CronMonthRange = {\n  min: 1,\n  max: 12,\n} as const;\n\nconst CronDayOfWeekRange = {\n  min: 0,\n  max: 6,\n} as const;\n\nexport class Cron {\n  private options: CronOptions;\n  private status: CronStatus = \"idle\";\n  private timeoutId: NodeJS.Timeout | null = null;\n\n  // Array-based storage using 1-indexed slots (0 = don't run, 1 = run)\n  private second = Array<number>(CronSecondRange.max + 1).fill(0); // 0-59\n  private minute = Array<number>(CronMinuteRange.max + 1).fill(0); // 0-59\n  private hour = Array<number>(CronHourRange.max + 1).fill(0); // 0-23\n  private day = Array<number>(CronDayRange.max + 1).fill(0); // indices 1-31 (0 unused)\n  private month = Array<number>(CronMonthRange.max + 1).fill(0); // indices 1-12 (0 unused)\n  private dayOfWeek = Array<number>(CronDayOfWeekRange.max + 1).fill(0); // 0-6\n  private hasSeconds;\n  private _dayWildcard = false;\n  private _dowWildcard = false;\n\n  // Fill all values from min to max with 1\n  private fillRange(values: number[], min: number, max: number) {\n    for (let i = min; i <= max; i++) {\n      values[i] = 1;\n    }\n  }\n\n  private handleStep(part: string, values: number[], min: number, max: number) {\n    // Split step format into range and step components\n    const [rangePart, stepStr] = part.split(\"/\");\n\n    if (!rangePart) {\n      return err<CronParsingError>(\n        \"InvalidValueError\",\n        `'${rangePart}' is empty`,\n      );\n    }\n\n    if (!stepStr) {\n      return err<CronParsingError>(\n        \"InvalidValueError\",\n        `'${stepStr}' is empty`,\n      );\n    }\n\n    const step = Number(stepStr);\n\n    // Validate step is a positive integer\n    if (!Number.isInteger(step)) {\n      return err<CronParsingError>(\n        \"InvalidValueError\",\n        `'${step}' is not a valid number`,\n      );\n    }\n\n    if (step <= 0) {\n      return err<CronParsingError>(\"OutOfBoundError\", `Expected ${step} > 0`);\n    }\n\n    if (rangePart === \"*\") {\n      // Wildcard with step: apply step across entire range\n      for (let i = min; i <= max; i += step) {\n        values[i] = 1;\n      }\n\n      return ok(true);\n    }\n\n    if (rangePart.includes(\"-\")) {\n      // Range with step: delegate to specialized handler\n      return this.handleStepRange(rangePart, step, values, min, max);\n    }\n\n    // Single value with step: delegate to specialized handler\n    return this.handleStepSingle(rangePart, step, values, min, max);\n  }\n\n  private handleStepRange(\n    range: string,\n    step: number,\n    values: number[],\n    min: number,\n    max: number,\n  ) {\n    // Split range into start and end values\n    const [startStr, endStr] = range.split(\"-\");\n\n    if (!endStr) {\n      return err<CronParsingError>(\"InvalidValueError\", `'${endStr}' is empty`);\n    }\n\n    let start = min;\n    if (startStr && startStr.length > 0) {\n      start = Number(startStr);\n    }\n\n    const end = Number(endStr);\n\n    // Validate range boundaries are integers within bounds\n    if (!Number.isInteger(start)) {\n      return err<CronParsingError>(\n        \"InvalidValueError\",\n        `'${start}' is not a valid number`,\n      );\n    }\n\n    if (!Number.isInteger(end)) {\n      return err<CronParsingError>(\n        \"InvalidValueError\",\n        `'${end}' is not a valid number`,\n      );\n    }\n\n    if (start < min) {\n      return err<CronParsingError>(\n        \"OutOfBoundError\",\n        `Expected ${start} >= ${min}`,\n      );\n    }\n\n    if (end > max) {\n      return err<CronParsingError>(\n        \"OutOfBoundError\",\n        `Expected ${end} <= ${max}`,\n      );\n    }\n\n    if (start > end) {\n      return err<CronParsingError>(\n        \"OutOfBoundError\",\n        `Expected ${start} <= ${end}`,\n      );\n    }\n\n    // Apply step through range\n    for (let i = start; i <= end; i += step) {\n      values[i] = 1;\n    }\n\n    return ok(true);\n  }\n\n  private handleStepSingle(\n    value: string,\n    step: number,\n    values: number[],\n    min: number,\n    max: number,\n  ) {\n    const start = Number(value);\n\n    // Validate starting value is an integer within bounds\n    if (!Number.isInteger(start)) {\n      return err<CronParsingError>(\n        \"InvalidValueError\",\n        `'${start}' is not a valid number`,\n      );\n    }\n\n    if (start < min) {\n      return err<CronParsingError>(\n        \"OutOfBoundError\",\n        `Expected ${start} >= ${min}`,\n      );\n    }\n\n    if (start > max) {\n      return err<CronParsingError>(\n        \"OutOfBoundError\",\n        `Expected ${start} <= ${max}`,\n      );\n    }\n\n    // Apply step from start to end of range\n    for (let i = start; i <= max; i += step) {\n      values[i] = 1;\n    }\n\n    return ok(true);\n  }\n\n  private handleRange(\n    part: string,\n    values: number[],\n    min: number,\n    max: number,\n  ) {\n    // Split range into start and end values\n    const [startStr, endStr] = part.split(\"-\");\n\n    if (!startStr) {\n      return err<CronParsingError>(\n        \"InvalidValueError\",\n        `'${startStr}' is empty`,\n      );\n    }\n\n    if (!endStr) {\n      return err<CronParsingError>(\"InvalidValueError\", `'${endStr}' is empty`);\n    }\n\n    const start = Number(startStr);\n    const end = Number(endStr);\n\n    // Validate range boundaries are integers within bounds\n    if (!Number.isInteger(start)) {\n      return err<CronParsingError>(\n        \"InvalidValueError\",\n        `'${start}' is not a valid number`,\n      );\n    }\n\n    if (!Number.isInteger(end)) {\n      return err<CronParsingError>(\n        \"InvalidValueError\",\n        `'${end}' is not a valid number`,\n      );\n    }\n\n    if (start < min) {\n      return err<CronParsingError>(\n        \"OutOfBoundError\",\n        `Expected ${start} >= ${min}`,\n      );\n    }\n\n    if (end > max) {\n      return err<CronParsingError>(\n        \"OutOfBoundError\",\n        `Expected ${end} <= ${max}`,\n      );\n    }\n\n    if (start > end) {\n      return err<CronParsingError>(\n        \"OutOfBoundError\",\n        `Expected ${start} <= ${end}`,\n      );\n    }\n\n    // Mark all values in the range\n    for (let i = start; i <= end; i++) {\n      values[i] = 1;\n    }\n\n    return ok(true);\n  }\n\n  private handleNumber(\n    value: string,\n    values: number[],\n    min: number,\n    max: number,\n  ) {\n    const n = Number(value);\n\n    // Validate value is an integer within bounds\n    if (!Number.isInteger(n)) {\n      return err<CronParsingError>(\n        \"InvalidValueError\",\n        `'${value}' is not a valid number`,\n      );\n    }\n\n    if (n < min) {\n      return err<CronParsingError>(\n        \"OutOfBoundError\",\n        `Expected ${n} >= ${min}`,\n      );\n    }\n    if (n > max) {\n      return err<CronParsingError>(\n        \"OutOfBoundError\",\n        `Expected ${n} <= ${max}`,\n      );\n    }\n\n    values[n] = 1;\n\n    return ok(true);\n  }\n\n  public constructor(options: CronOptions) {\n    this.options = options;\n\n    // Resolve alias or use raw expression\n    const expr = this.resolveAlias(options.schedule);\n    const [error, tokens] = new Scanner(expr).scan();\n    if (error) throw new Error(`${error.type}: ${error.message}`);\n\n    const fields = expr.trim().split(/\\s+/);\n    this.hasSeconds = fields.length === FieldAmount.max;\n\n    // Parse and validate the cron expression\n    const [parsingError, _] = this.parse(tokens);\n\n    if (parsingError) {\n      throw new Error(`${parsingError.type}: ${parsingError.message}`);\n    }\n  }\n\n  // Map alias to standard cron expression if present\n  private resolveAlias(schedule: string) {\n    return ALIASES[schedule] || schedule;\n  }\n\n  private parse(tokens: Token[]) {\n    for (let i = 0; i < tokens.length; i++) {\n      const token = tokens[i];\n\n      if (!token) {\n        return err<CronParsingError>(\"InvalidValueError\", \"Undefined token\");\n      }\n\n      const tokenType = token.getTokenType();\n\n      switch (token.getField()) {\n        case \"second\": {\n          const [error, _] = this.handleField(\n            token,\n            this.second,\n            CronSecondRange.min,\n            CronSecondRange.max,\n          );\n\n          if (error) {\n            return err<CronParsingError>(\n              error.type,\n              `${error.message} in field '${token.getField()}'`,\n            );\n          }\n\n          break;\n        }\n        case \"minute\": {\n          const [error, _] = this.handleField(\n            token,\n            this.minute,\n            CronMinuteRange.min,\n            CronMinuteRange.max,\n          );\n\n          if (error) {\n            return err<CronParsingError>(\n              error.type,\n              `${error.message} in field '${token.getField()}'`,\n            );\n          }\n\n          break;\n        }\n        case \"hour\": {\n          const [error, _] = this.handleField(\n            token,\n            this.hour,\n            CronHourRange.min,\n            CronHourRange.max,\n          );\n\n          if (error) {\n            return err<CronParsingError>(\n              error.type,\n              `${error.message} in field '${token.getField()}'`,\n            );\n          }\n\n          break;\n        }\n        case \"day\": {\n          if (tokenType === \"any\") {\n            this._dayWildcard = true;\n          }\n\n          const [error, _] = this.handleField(\n            token,\n            this.day,\n            CronDayRange.min,\n            CronDayRange.max,\n          );\n\n          if (error) {\n            return err<CronParsingError>(\n              error.type,\n              `${error.message} in field '${token.getField()}'`,\n            );\n          }\n\n          break;\n        }\n        case \"month\": {\n          const [error, _] = this.handleField(\n            token,\n            this.month,\n            CronMonthRange.min,\n            CronMonthRange.max,\n          );\n\n          if (error) {\n            return err<CronParsingError>(\n              error.type,\n              `${error.message} in field '${token.getField()}'`,\n            );\n          }\n\n          break;\n        }\n        case \"weekday\": {\n          if (tokenType === \"any\") {\n            this._dowWildcard = true;\n          }\n\n          const [error, _] = this.handleField(\n            token,\n            this.dayOfWeek,\n            CronDayOfWeekRange.min,\n            CronDayOfWeekRange.max,\n          );\n\n          if (error) {\n            return err<CronParsingError>(\n              error.type,\n              `${error.message} in field '${token.getField()}'`,\n            );\n          }\n\n          break;\n        }\n        default:\n          return err<CronParsingError>(\n            \"InvalidValueError\",\n            `Invalid field '${token.getField()}'`,\n          );\n      }\n    }\n\n    return ok(true);\n  }\n\n  private handleField(token: Token, field: number[], min: number, max: number) {\n    switch (token.getTokenType()) {\n      case \"any\": {\n        this.fillRange(field, min, max);\n        break;\n      }\n      case \"number\": {\n        const [error, _] = this.handleNumber(\n          token.getComponent(),\n          field,\n          min,\n          max,\n        );\n        if (error) return err<CronParsingError>(error.type, error.message);\n\n        break;\n      }\n      case \"range\": {\n        const component = token.getComponent();\n        const [error, _] = this.handleRange(component, field, min, max);\n        if (error) return err<CronParsingError>(error.type, error.message);\n\n        break;\n      }\n      case \"step\": {\n        const component = token.getComponent();\n        const [error, _] = this.handleStep(component, field, min, max);\n        if (error) return err<CronParsingError>(error.type, error.message);\n\n        break;\n      }\n      default:\n        return err<CronParsingError>(\n          \"InvalidValueError\",\n          `Invalid token type '${token.getTokenType()}'`,\n        );\n    }\n\n    return ok(true);\n  }\n\n  public matches(date: Date) {\n    // Extract date/time components\n    const s = date.getSeconds();\n    const m = date.getMinutes();\n    const h = date.getHours();\n    const d = date.getDate();\n    const mon = date.getMonth();\n    const dow = date.getDay();\n\n    // Check each component against configured values\n    const isSecondMatch = this.hasSeconds ? this.second[s] === 1 : true;\n    const isMinuteMatch = this.minute[m] === 1;\n    const isHourMatch = this.hour[h] === 1;\n    const isMonthMatch = this.month[mon + 1] === 1;\n\n    // Standard cron: when both day-of-month and day-of-week are restricted (not *),\n    // fire if EITHER matches. When at least one is *, use AND (the wildcard is always 1).\n    let isDayOrDowMatch: boolean;\n\n    if (!this._dayWildcard && !this._dowWildcard) {\n      isDayOrDowMatch = this.day[d] === 1 || this.dayOfWeek[dow] === 1;\n    } else {\n      isDayOrDowMatch = this.day[d] === 1 && this.dayOfWeek[dow] === 1;\n    }\n\n    return (\n      isSecondMatch &&\n      isMinuteMatch &&\n      isHourMatch &&\n      isDayOrDowMatch &&\n      isMonthMatch\n    );\n  }\n\n  public getNextRun() {\n    const now = new Date();\n    const date = new Date(now);\n\n    // Start from next minute/second\n    if (this.hasSeconds) {\n      date.setMilliseconds(0);\n      date.setSeconds(date.getSeconds() + 1);\n    } else {\n      date.setSeconds(0, 0);\n      date.setMinutes(date.getMinutes() + 1);\n    }\n\n    // Search up to 4 years to cover leap-day schedules (next Feb 29 can be ~4 years away)\n    const maxIterations = this.hasSeconds\n      ? 366 * 4 * 24 * 3600\n      : 366 * 4 * 24 * 60;\n\n    for (let i = 0; i < maxIterations; i++) {\n      if (this.matches(date)) {\n        const freshNow = new Date();\n\n        // Ensure match is still in the future\n        if (date > freshNow) {\n          return new Date(date);\n        }\n      }\n\n      // Increment time\n      if (this.hasSeconds) {\n        date.setSeconds(date.getSeconds() + 1);\n      } else {\n        date.setMinutes(date.getMinutes() + 1);\n      }\n    }\n\n    return null;\n  }\n\n  public start() {\n    if (this.status !== \"idle\") return;\n\n    this.status = \"running\";\n    this.next();\n  }\n\n  public stop() {\n    this.status = \"idle\";\n\n    if (this.timeoutId) {\n      clearTimeout(this.timeoutId);\n      this.timeoutId = null;\n    }\n  }\n\n  public pause() {\n    if (this.status !== \"running\") return;\n\n    this.status = \"paused\";\n\n    if (this.timeoutId) {\n      clearTimeout(this.timeoutId);\n      this.timeoutId = null;\n    }\n  }\n\n  public resume() {\n    if (this.status !== \"paused\") return;\n\n    this.status = \"running\";\n    this.next();\n  }\n\n  public getStatus() {\n    return this.status;\n  }\n\n  private next() {\n    if (this.status !== \"running\") return;\n\n    const nextRun = this.getNextRun();\n\n    if (!nextRun) {\n      this.timeoutId = setTimeout(() => this.next(), RETRY_DELAY_MS);\n      return;\n    }\n\n    const delay = nextRun.getTime() - Date.now();\n\n    const actualDelay = Math.max(0, delay);\n\n    this.timeoutId = setTimeout(() => {\n      this.run();\n    }, actualDelay);\n  }\n\n  private async run() {\n    if (this.status !== \"running\") return;\n\n    const handlerResult = this.options.handler();\n    await mightThrow(Promise.resolve(handlerResult));\n\n    if (this.status === \"running\") {\n      this.next();\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/lib/errors/index.cjs

@@ -0,0 +1,30 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/lib/errors/index.ts
+const ok = (data) => {
+	return [null, data];
+};
+const err = (type, message) => {
+	return [{
+		type,
+		message
+	}, null];
+};
+const mightThrowSync = (fn) => {
+	try {
+		return [null, fn()];
+	} catch (error) {
+		return [error, null];
+	}
+};
+const mightThrow = async (promise) => {
+	try {
+		return [null, await promise];
+	} catch (error) {
+		return [error, null];
+	}
+};
+//#endregion
+exports.err = err;
+exports.mightThrow = mightThrow;
+exports.mightThrowSync = mightThrowSync;
+exports.ok = ok;

package/dist/lib/errors/index.d.cts

@@ -0,0 +1,13 @@
+import { CommonError } from "../../errors/types.cjs";
+
+//#region src/lib/errors/index.d.ts
+declare const ok: <T>(data: T) => readonly [null, T];
+declare const err: <T extends CommonError>(type: T, message: string) => readonly [{
+  readonly type: T;
+  readonly message: string;
+}, null];
+declare const mightThrowSync: <T>(fn: () => T) => readonly [unknown, null] | readonly [null, T];
+declare const mightThrow: <T>(promise: Promise<T>) => Promise<readonly [null, Awaited<T>] | readonly [unknown, null]>;
+//#endregion
+export { err, mightThrow, mightThrowSync, ok };
+//# sourceMappingURL=index.d.cts.map

package/dist/lib/errors/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../../src/lib/errors/index.ts"],"mappings":";;;cAEa,EAAA,MAAS,IAAA,EAAM,CAAA,qBAAC,CAAA;AAAA,cAIhB,GAAA,aAAiB,WAAA,EAAa,IAAA,EAAM,CAAA,EAAG,OAAA;EAAA;;;cAIvC,cAAA,MAAqB,EAAA,QAAU,CAAA,gDAAC,CAAA;AAAA,cAShC,UAAA,MAAuB,OAAA,EAAS,OAAA,CAAQ,CAAA,MAAE,OAAA,iBAAA,OAAA,CAAA,CAAA"}

package/dist/lib/errors/index.d.mts

@@ -0,0 +1,13 @@
+import { CommonError } from "../../errors/types.mjs";
+
+//#region src/lib/errors/index.d.ts
+declare const ok: <T>(data: T) => readonly [null, T];
+declare const err: <T extends CommonError>(type: T, message: string) => readonly [{
+  readonly type: T;
+  readonly message: string;
+}, null];
+declare const mightThrowSync: <T>(fn: () => T) => readonly [unknown, null] | readonly [null, T];
+declare const mightThrow: <T>(promise: Promise<T>) => Promise<readonly [null, Awaited<T>] | readonly [unknown, null]>;
+//#endregion
+export { err, mightThrow, mightThrowSync, ok };
+//# sourceMappingURL=index.d.mts.map

package/dist/lib/errors/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../src/lib/errors/index.ts"],"mappings":";;;cAEa,EAAA,MAAS,IAAA,EAAM,CAAA,qBAAC,CAAA;AAAA,cAIhB,GAAA,aAAiB,WAAA,EAAa,IAAA,EAAM,CAAA,EAAG,OAAA;EAAA;;;cAIvC,cAAA,MAAqB,EAAA,QAAU,CAAA,gDAAC,CAAA;AAAA,cAShC,UAAA,MAAuB,OAAA,EAAS,OAAA,CAAQ,CAAA,MAAE,OAAA,iBAAA,OAAA,CAAA,CAAA"}

package/dist/lib/errors/index.mjs

@@ -0,0 +1,28 @@
+//#region src/lib/errors/index.ts
+const ok = (data) => {
+	return [null, data];
+};
+const err = (type, message) => {
+	return [{
+		type,
+		message
+	}, null];
+};
+const mightThrowSync = (fn) => {
+	try {
+		return [null, fn()];
+	} catch (error) {
+		return [error, null];
+	}
+};
+const mightThrow = async (promise) => {
+	try {
+		return [null, await promise];
+	} catch (error) {
+		return [error, null];
+	}
+};
+//#endregion
+export { err, mightThrow, mightThrowSync, ok };
+
+//# sourceMappingURL=index.mjs.map

package/dist/lib/errors/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/lib/errors/index.ts"],"sourcesContent":["import type { CommonError } from \"./types.js\";\n\nexport const ok = <T>(data: T) => {\n  return [null, data] as const;\n};\n\nexport const err = <T extends CommonError>(type: T, message: string) => {\n  return [{ type, message }, null] as const;\n};\n\nexport const mightThrowSync = <T>(fn: () => T) => {\n  try {\n    const result = fn();\n    return [null, result] as const;\n  } catch (error) {\n    return [error, null] as const;\n  }\n};\n\nexport const mightThrow = async <T>(promise: Promise<T>) => {\n  try {\n    const data = await promise;\n    return [null, data] as const;\n  } catch (error) {\n    return [error, null] as const;\n  }\n};\n"],"mappings":";AAEA,MAAa,MAAS,SAAY;AAChC,QAAO,CAAC,MAAM,KAAK;;AAGrB,MAAa,OAA8B,MAAS,YAAoB;AACtE,QAAO,CAAC;EAAE;EAAM;EAAS,EAAE,KAAK;;AAGlC,MAAa,kBAAqB,OAAgB;AAChD,KAAI;AAEF,SAAO,CAAC,MADO,IAAI,CACE;UACd,OAAO;AACd,SAAO,CAAC,OAAO,KAAK;;;AAIxB,MAAa,aAAa,OAAU,YAAwB;AAC1D,KAAI;AAEF,SAAO,CAAC,MADK,MAAM,QACA;UACZ,OAAO;AACd,SAAO,CAAC,OAAO,KAAK"}

package/dist/lib/i18n/index.cjs

@@ -0,0 +1,37 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/lib/i18n/index.ts
+var I18n = class {
+	locales;
+	currentLocale;
+	defaultLocale;
+	constructor(config) {
+		this.defaultLocale = config.defaultLocale;
+		this.currentLocale = config.defaultLocale;
+		this.locales = config.locales;
+	}
+	setLocale(locale) {
+		this.currentLocale = locale;
+	}
+	getLocale() {
+		return this.currentLocale;
+	}
+	translate(key, ...params) {
+		const currentTranslations = this.locales[this.currentLocale];
+		const defaultTranslations = this.locales[this.defaultLocale];
+		const translation = this.getNestedValue(currentTranslations, key) ?? this.getNestedValue(defaultTranslations, key);
+		if (!translation) return key;
+		const paramObj = params[0];
+		return this.substituteParams(translation, paramObj);
+	}
+	getNestedValue(obj, path) {
+		return path.split(".").reduce((current, key) => current?.[key], obj);
+	}
+	substituteParams(template, params) {
+		if (!params) return template;
+		return template.replace(/\{(\w+):(\w+)\}/g, (_match, name) => {
+			return String(params[name]);
+		});
+	}
+};
+//#endregion
+exports.I18n = I18n;

package/dist/lib/i18n/index.d.cts

@@ -0,0 +1,20 @@
+import { BuildParamObject, GetNestedValue, NestedKeyOf } from "../../i18n/types.cjs";
+
+//#region src/lib/i18n/index.d.ts
+declare class I18n<const TLocales extends Record<string, Record<string, unknown>>, TDefaultLocale extends keyof TLocales> {
+  private locales;
+  private currentLocale;
+  private defaultLocale;
+  constructor(config: {
+    defaultLocale: TDefaultLocale;
+    locales: TLocales;
+  });
+  setLocale(locale: keyof TLocales): void;
+  getLocale(): keyof TLocales;
+  translate<TKey extends NestedKeyOf<TLocales[TDefaultLocale]>>(key: TKey, ...params: BuildParamObject<GetNestedValue<TLocales[TDefaultLocale], TKey> extends string ? GetNestedValue<TLocales[TDefaultLocale], TKey> : never> extends Record<string, never> ? [] : [BuildParamObject<GetNestedValue<TLocales[TDefaultLocale], TKey> extends string ? GetNestedValue<TLocales[TDefaultLocale], TKey> : never>]): string;
+  private getNestedValue;
+  private substituteParams;
+}
+//#endregion
+export { I18n };
+//# sourceMappingURL=index.d.cts.map

package/dist/lib/i18n/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../../src/lib/i18n/index.ts"],"mappings":";;;cAEa,IAAA,wBACY,MAAA,SAAe,MAAA,iDACT,QAAA;EAAA,QAErB,OAAA;EAAA,QACA,aAAA;EAAA,QACA,aAAA;cAEW,MAAA;IACjB,aAAA,EAAe,cAAA;IACf,OAAA,EAAS,QAAA;EAAA;EAOJ,SAAA,CAAU,MAAA,QAAc,QAAA;EAIxB,SAAA,CAAA,SAAS,QAAA;EAIT,SAAA,cAAuB,WAAA,CAAY,QAAA,CAAS,cAAA,GAAA,CACjD,GAAA,EAAK,IAAA,KACF,MAAA,EAAQ,gBAAA,CACT,cAAA,CAAe,QAAA,CAAS,cAAA,GAAiB,IAAA,mBACrC,cAAA,CAAe,QAAA,CAAS,cAAA,GAAiB,IAAA,mBAErC,MAAA,wBAGJ,gBAAA,CACE,cAAA,CAAe,QAAA,CAAS,cAAA,GAAiB,IAAA,mBACrC,cAAA,CAAe,QAAA,CAAS,cAAA,GAAiB,IAAA;EAAA,QAoB/C,cAAA;EAAA,QAOA,gBAAA;AAAA"}

package/dist/lib/i18n/index.d.mts

@@ -0,0 +1,20 @@
+import { BuildParamObject, GetNestedValue, NestedKeyOf } from "../../i18n/types.mjs";
+
+//#region src/lib/i18n/index.d.ts
+declare class I18n<const TLocales extends Record<string, Record<string, unknown>>, TDefaultLocale extends keyof TLocales> {
+  private locales;
+  private currentLocale;
+  private defaultLocale;
+  constructor(config: {
+    defaultLocale: TDefaultLocale;
+    locales: TLocales;
+  });
+  setLocale(locale: keyof TLocales): void;
+  getLocale(): keyof TLocales;
+  translate<TKey extends NestedKeyOf<TLocales[TDefaultLocale]>>(key: TKey, ...params: BuildParamObject<GetNestedValue<TLocales[TDefaultLocale], TKey> extends string ? GetNestedValue<TLocales[TDefaultLocale], TKey> : never> extends Record<string, never> ? [] : [BuildParamObject<GetNestedValue<TLocales[TDefaultLocale], TKey> extends string ? GetNestedValue<TLocales[TDefaultLocale], TKey> : never>]): string;
+  private getNestedValue;
+  private substituteParams;
+}
+//#endregion
+export { I18n };
+//# sourceMappingURL=index.d.mts.map

package/dist/lib/i18n/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../src/lib/i18n/index.ts"],"mappings":";;;cAEa,IAAA,wBACY,MAAA,SAAe,MAAA,iDACT,QAAA;EAAA,QAErB,OAAA;EAAA,QACA,aAAA;EAAA,QACA,aAAA;cAEW,MAAA;IACjB,aAAA,EAAe,cAAA;IACf,OAAA,EAAS,QAAA;EAAA;EAOJ,SAAA,CAAU,MAAA,QAAc,QAAA;EAIxB,SAAA,CAAA,SAAS,QAAA;EAIT,SAAA,cAAuB,WAAA,CAAY,QAAA,CAAS,cAAA,GAAA,CACjD,GAAA,EAAK,IAAA,KACF,MAAA,EAAQ,gBAAA,CACT,cAAA,CAAe,QAAA,CAAS,cAAA,GAAiB,IAAA,mBACrC,cAAA,CAAe,QAAA,CAAS,cAAA,GAAiB,IAAA,mBAErC,MAAA,wBAGJ,gBAAA,CACE,cAAA,CAAe,QAAA,CAAS,cAAA,GAAiB,IAAA,mBACrC,cAAA,CAAe,QAAA,CAAS,cAAA,GAAiB,IAAA;EAAA,QAoB/C,cAAA;EAAA,QAOA,gBAAA;AAAA"}

package/dist/lib/i18n/index.mjs

@@ -0,0 +1,38 @@
+//#region src/lib/i18n/index.ts
+var I18n = class {
+	locales;
+	currentLocale;
+	defaultLocale;
+	constructor(config) {
+		this.defaultLocale = config.defaultLocale;
+		this.currentLocale = config.defaultLocale;
+		this.locales = config.locales;
+	}
+	setLocale(locale) {
+		this.currentLocale = locale;
+	}
+	getLocale() {
+		return this.currentLocale;
+	}
+	translate(key, ...params) {
+		const currentTranslations = this.locales[this.currentLocale];
+		const defaultTranslations = this.locales[this.defaultLocale];
+		const translation = this.getNestedValue(currentTranslations, key) ?? this.getNestedValue(defaultTranslations, key);
+		if (!translation) return key;
+		const paramObj = params[0];
+		return this.substituteParams(translation, paramObj);
+	}
+	getNestedValue(obj, path) {
+		return path.split(".").reduce((current, key) => current?.[key], obj);
+	}
+	substituteParams(template, params) {
+		if (!params) return template;
+		return template.replace(/\{(\w+):(\w+)\}/g, (_match, name) => {
+			return String(params[name]);
+		});
+	}
+};
+//#endregion
+export { I18n };
+
+//# sourceMappingURL=index.mjs.map

package/dist/lib/i18n/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/lib/i18n/index.ts"],"sourcesContent":["import type { BuildParamObject, GetNestedValue, NestedKeyOf } from \"./types.js\";\n\nexport class I18n<\n  const TLocales extends Record<string, Record<string, unknown>>,\n  TDefaultLocale extends keyof TLocales,\n> {\n  private locales: TLocales;\n  private currentLocale: keyof TLocales;\n  private defaultLocale: TDefaultLocale;\n\n  public constructor(config: {\n    defaultLocale: TDefaultLocale;\n    locales: TLocales;\n  }) {\n    this.defaultLocale = config.defaultLocale;\n    this.currentLocale = config.defaultLocale;\n    this.locales = config.locales;\n  }\n\n  public setLocale(locale: keyof TLocales) {\n    this.currentLocale = locale;\n  }\n\n  public getLocale() {\n    return this.currentLocale;\n  }\n\n  public translate<TKey extends NestedKeyOf<TLocales[TDefaultLocale]>>(\n    key: TKey,\n    ...params: BuildParamObject<\n      GetNestedValue<TLocales[TDefaultLocale], TKey> extends string\n        ? GetNestedValue<TLocales[TDefaultLocale], TKey>\n        : never\n    > extends Record<string, never>\n      ? []\n      : [\n          BuildParamObject<\n            GetNestedValue<TLocales[TDefaultLocale], TKey> extends string\n              ? GetNestedValue<TLocales[TDefaultLocale], TKey>\n              : never\n          >,\n        ]\n  ) {\n    const currentTranslations = this.locales[this.currentLocale];\n    const defaultTranslations = this.locales[this.defaultLocale];\n\n    const translation =\n      this.getNestedValue(currentTranslations, key) ??\n      this.getNestedValue(defaultTranslations, key);\n\n    if (!translation) {\n      return key;\n    }\n\n    const paramObj = params[0] as Record<string, unknown> | undefined;\n    return this.substituteParams(translation, paramObj);\n  }\n\n  private getNestedValue(\n    obj: Record<string, unknown> | undefined,\n    path: string,\n  ) {\n    return path.split(\".\").reduce((current: any, key) => current?.[key], obj);\n  }\n\n  private substituteParams(template: string, params?: Record<string, unknown>) {\n    if (!params) return template;\n\n    return template.replace(/\\{(\\w+):(\\w+)\\}/g, (_match, name) => {\n      return String(params[name]);\n    });\n  }\n}\n"],"mappings":";AAEA,IAAa,OAAb,MAGE;CACA;CACA;CACA;CAEA,YAAmB,QAGhB;AACD,OAAK,gBAAgB,OAAO;AAC5B,OAAK,gBAAgB,OAAO;AAC5B,OAAK,UAAU,OAAO;;CAGxB,UAAiB,QAAwB;AACvC,OAAK,gBAAgB;;CAGvB,YAAmB;AACjB,SAAO,KAAK;;CAGd,UACE,KACA,GAAG,QAaH;EACA,MAAM,sBAAsB,KAAK,QAAQ,KAAK;EAC9C,MAAM,sBAAsB,KAAK,QAAQ,KAAK;EAE9C,MAAM,cACJ,KAAK,eAAe,qBAAqB,IAAI,IAC7C,KAAK,eAAe,qBAAqB,IAAI;AAE/C,MAAI,CAAC,YACH,QAAO;EAGT,MAAM,WAAW,OAAO;AACxB,SAAO,KAAK,iBAAiB,aAAa,SAAS;;CAGrD,eACE,KACA,MACA;AACA,SAAO,KAAK,MAAM,IAAI,CAAC,QAAQ,SAAc,QAAQ,UAAU,MAAM,IAAI;;CAG3E,iBAAyB,UAAkB,QAAkC;AAC3E,MAAI,CAAC,OAAQ,QAAO;AAEpB,SAAO,SAAS,QAAQ,qBAAqB,QAAQ,SAAS;AAC5D,UAAO,OAAO,OAAO,MAAM;IAC3B"}