semola 0.5.0 → 0.5.2

package/dist/lib/cache/index.cjs

@@ -0,0 +1,74 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_lib_errors_index = require("../errors/index.cjs");
+//#region src/lib/cache/index.ts
+var Cache = class {
+	options;
+	serialize;
+	deserialize;
+	constructor(options) {
+		this.options = options;
+		this.serialize = options.serializer ?? JSON.stringify;
+		this.deserialize = options.deserializer ?? ((raw) => JSON.parse(raw));
+	}
+	async get(key) {
+		if (!this.isEnabled) return this.fail("NotFoundError", `Key ${key} not found`);
+		const resolvedKey = this.resolveKey(key);
+		const [error, value] = await require_lib_errors_index.mightThrow(this.options.redis.get(resolvedKey));
+		if (error) return this.fail("CacheError", `Unable to get value for key ${key}`);
+		if (value === null || value === void 0) return this.fail("NotFoundError", `Key ${key} not found`);
+		const [deserializeErr, deserialized] = require_lib_errors_index.mightThrowSync(() => this.deserialize(value));
+		if (deserializeErr) return this.fail("CacheError", `Unable to deserialize value for key ${key}`);
+		return require_lib_errors_index.ok(deserialized);
+	}
+	async set(key, value) {
+		if (!this.isEnabled) return require_lib_errors_index.ok(value);
+		const [serializeErr, serialized] = require_lib_errors_index.mightThrowSync(() => this.serialize(value));
+		if (serializeErr) return this.fail("CacheError", `Unable to serialize value for key ${key}`);
+		if (serialized === null || serialized === void 0) return this.fail("CacheError", `Unable to serialize value for key ${key}`);
+		const [ttlErr, ttl] = require_lib_errors_index.mightThrowSync(() => this.resolveTTL(key, value));
+		if (ttlErr) return this.fail("InvalidTTLError", `Unable to resolve ttl for key ${key}`);
+		if (!this.isTTLValid(ttl)) return this.fail("InvalidTTLError", `Unable to save records with ttl equal to ${ttl}`);
+		const resolvedKey = this.resolveKey(key);
+		const [setError] = await require_lib_errors_index.mightThrow(this.getSetPromise(resolvedKey, serialized, ttl));
+		if (setError) return this.fail("CacheError", `Unable to set value for key ${key}`);
+		return require_lib_errors_index.ok(value);
+	}
+	async delete(key) {
+		if (!this.isEnabled) return require_lib_errors_index.ok(0);
+		const resolvedKey = this.resolveKey(key);
+		const [error, data] = await require_lib_errors_index.mightThrow(this.options.redis.del(resolvedKey));
+		if (error) return this.fail("CacheError", `Unable to delete key ${key}`);
+		return require_lib_errors_index.ok(data);
+	}
+	fail(type, message) {
+		this.options.onError?.({
+			type,
+			message
+		});
+		return require_lib_errors_index.err(type, message);
+	}
+	get isEnabled() {
+		return this.options.enabled !== false;
+	}
+	resolveKey(key) {
+		if (this.options.prefix) return `${this.options.prefix}:${key}`;
+		return key;
+	}
+	resolveTTL(key, value) {
+		if (typeof this.options.ttl === "function") return this.options.ttl(key, value);
+		return this.options.ttl;
+	}
+	getSetPromise(key, value, ttl) {
+		if (ttl === void 0 || ttl === null) return this.options.redis.set(key, value);
+		return this.options.redis.set(key, value, "PX", ttl);
+	}
+	isTTLValid(ttl) {
+		if (ttl === void 0 || ttl === null) return true;
+		if (!Number.isFinite(ttl)) return false;
+		if (!Number.isInteger(ttl)) return false;
+		if (ttl < 0) return false;
+		return true;
+	}
+};
+//#endregion
+exports.Cache = Cache;

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

@@ -0,0 +1,36 @@
+import { CacheOptions } from "../../cache/types.cjs";
+
+//#region src/lib/cache/index.d.ts
+declare class Cache<T> {
+  private options;
+  private serialize;
+  private deserialize;
+  constructor(options: CacheOptions<T>);
+  get(key: string): Promise<readonly [{
+    readonly type: "NotFoundError";
+    readonly message: string;
+  }, null] | readonly [{
+    readonly type: "CacheError";
+    readonly message: string;
+  }, null] | readonly [null, T | null]>;
+  set(key: string, value: T): Promise<readonly [{
+    readonly type: "CacheError";
+    readonly message: string;
+  }, null] | readonly [null, T] | readonly [{
+    readonly type: "InvalidTTLError";
+    readonly message: string;
+  }, null]>;
+  delete(key: string): Promise<readonly [{
+    readonly type: "CacheError";
+    readonly message: string;
+  }, null] | readonly [null, number | null]>;
+  private fail;
+  private get isEnabled();
+  private resolveKey;
+  private resolveTTL;
+  private getSetPromise;
+  private isTTLValid;
+}
+//#endregion
+export { Cache };
+//# sourceMappingURL=index.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../../src/lib/cache/index.ts"],"mappings":";;;cAGa,KAAA;EAAA,QACH,OAAA;EAAA,QACA,SAAA;EAAA,QACA,WAAA;cAEW,OAAA,EAAS,YAAA,CAAa,CAAA;EAM5B,GAAA,CAAI,GAAA,WAAW,OAAA;IAAA;;;;;;EAiCf,GAAA,CAAI,GAAA,UAAa,KAAA,EAAO,CAAA,GAAC,OAAA;IAAA;;;;;;EAoDzB,MAAA,CAAO,GAAA,WAAW,OAAA;IAAA;;;UAgBvB,IAAA;EAAA,YAMI,SAAA,CAAA;EAAA,QAIJ,UAAA;EAAA,QAQA,UAAA;EAAA,QAQA,aAAA;EAAA,QAYA,UAAA;AAAA"}

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

@@ -0,0 +1,36 @@
+import { CacheOptions } from "../../cache/types.mjs";
+
+//#region src/lib/cache/index.d.ts
+declare class Cache<T> {
+  private options;
+  private serialize;
+  private deserialize;
+  constructor(options: CacheOptions<T>);
+  get(key: string): Promise<readonly [{
+    readonly type: "NotFoundError";
+    readonly message: string;
+  }, null] | readonly [{
+    readonly type: "CacheError";
+    readonly message: string;
+  }, null] | readonly [null, T | null]>;
+  set(key: string, value: T): Promise<readonly [{
+    readonly type: "CacheError";
+    readonly message: string;
+  }, null] | readonly [null, T] | readonly [{
+    readonly type: "InvalidTTLError";
+    readonly message: string;
+  }, null]>;
+  delete(key: string): Promise<readonly [{
+    readonly type: "CacheError";
+    readonly message: string;
+  }, null] | readonly [null, number | null]>;
+  private fail;
+  private get isEnabled();
+  private resolveKey;
+  private resolveTTL;
+  private getSetPromise;
+  private isTTLValid;
+}
+//#endregion
+export { Cache };
+//# sourceMappingURL=index.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../src/lib/cache/index.ts"],"mappings":";;;cAGa,KAAA;EAAA,QACH,OAAA;EAAA,QACA,SAAA;EAAA,QACA,WAAA;cAEW,OAAA,EAAS,YAAA,CAAa,CAAA;EAM5B,GAAA,CAAI,GAAA,WAAW,OAAA;IAAA;;;;;;EAiCf,GAAA,CAAI,GAAA,UAAa,KAAA,EAAO,CAAA,GAAC,OAAA;IAAA;;;;;;EAoDzB,MAAA,CAAO,GAAA,WAAW,OAAA;IAAA;;;UAgBvB,IAAA;EAAA,YAMI,SAAA,CAAA;EAAA,QAIJ,UAAA;EAAA,QAQA,UAAA;EAAA,QAQA,aAAA;EAAA,QAYA,UAAA;AAAA"}

package/dist/lib/cache/index.mjs

@@ -0,0 +1,75 @@
+import { err, mightThrow, mightThrowSync, ok } from "../errors/index.mjs";
+//#region src/lib/cache/index.ts
+var Cache = class {
+	options;
+	serialize;
+	deserialize;
+	constructor(options) {
+		this.options = options;
+		this.serialize = options.serializer ?? JSON.stringify;
+		this.deserialize = options.deserializer ?? ((raw) => JSON.parse(raw));
+	}
+	async get(key) {
+		if (!this.isEnabled) return this.fail("NotFoundError", `Key ${key} not found`);
+		const resolvedKey = this.resolveKey(key);
+		const [error, value] = await mightThrow(this.options.redis.get(resolvedKey));
+		if (error) return this.fail("CacheError", `Unable to get value for key ${key}`);
+		if (value === null || value === void 0) return this.fail("NotFoundError", `Key ${key} not found`);
+		const [deserializeErr, deserialized] = mightThrowSync(() => this.deserialize(value));
+		if (deserializeErr) return this.fail("CacheError", `Unable to deserialize value for key ${key}`);
+		return ok(deserialized);
+	}
+	async set(key, value) {
+		if (!this.isEnabled) return ok(value);
+		const [serializeErr, serialized] = mightThrowSync(() => this.serialize(value));
+		if (serializeErr) return this.fail("CacheError", `Unable to serialize value for key ${key}`);
+		if (serialized === null || serialized === void 0) return this.fail("CacheError", `Unable to serialize value for key ${key}`);
+		const [ttlErr, ttl] = mightThrowSync(() => this.resolveTTL(key, value));
+		if (ttlErr) return this.fail("InvalidTTLError", `Unable to resolve ttl for key ${key}`);
+		if (!this.isTTLValid(ttl)) return this.fail("InvalidTTLError", `Unable to save records with ttl equal to ${ttl}`);
+		const resolvedKey = this.resolveKey(key);
+		const [setError] = await mightThrow(this.getSetPromise(resolvedKey, serialized, ttl));
+		if (setError) return this.fail("CacheError", `Unable to set value for key ${key}`);
+		return ok(value);
+	}
+	async delete(key) {
+		if (!this.isEnabled) return ok(0);
+		const resolvedKey = this.resolveKey(key);
+		const [error, data] = await mightThrow(this.options.redis.del(resolvedKey));
+		if (error) return this.fail("CacheError", `Unable to delete key ${key}`);
+		return ok(data);
+	}
+	fail(type, message) {
+		this.options.onError?.({
+			type,
+			message
+		});
+		return err(type, message);
+	}
+	get isEnabled() {
+		return this.options.enabled !== false;
+	}
+	resolveKey(key) {
+		if (this.options.prefix) return `${this.options.prefix}:${key}`;
+		return key;
+	}
+	resolveTTL(key, value) {
+		if (typeof this.options.ttl === "function") return this.options.ttl(key, value);
+		return this.options.ttl;
+	}
+	getSetPromise(key, value, ttl) {
+		if (ttl === void 0 || ttl === null) return this.options.redis.set(key, value);
+		return this.options.redis.set(key, value, "PX", ttl);
+	}
+	isTTLValid(ttl) {
+		if (ttl === void 0 || ttl === null) return true;
+		if (!Number.isFinite(ttl)) return false;
+		if (!Number.isInteger(ttl)) return false;
+		if (ttl < 0) return false;
+		return true;
+	}
+};
+//#endregion
+export { Cache };
+
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/lib/cache/index.ts"],"sourcesContent":["import { err, mightThrow, mightThrowSync, ok } from \"../errors/index.js\";\nimport type { CacheError, CacheOptions } from \"./types.js\";\n\nexport class Cache<T> {\n  private options: CacheOptions<T>;\n  private serialize: (value: T) => string;\n  private deserialize: (raw: string) => T;\n\n  public constructor(options: CacheOptions<T>) {\n    this.options = options;\n    this.serialize = options.serializer ?? JSON.stringify;\n    this.deserialize = options.deserializer ?? ((raw) => JSON.parse(raw));\n  }\n\n  public async get(key: string) {\n    if (!this.isEnabled) {\n      return this.fail(\"NotFoundError\", `Key ${key} not found`);\n    }\n\n    const resolvedKey = this.resolveKey(key);\n\n    const [error, value] = await mightThrow(\n      this.options.redis.get(resolvedKey),\n    );\n\n    if (error) {\n      return this.fail(\"CacheError\", `Unable to get value for key ${key}`);\n    }\n\n    if (value === null || value === undefined) {\n      return this.fail(\"NotFoundError\", `Key ${key} not found`);\n    }\n\n    const [deserializeErr, deserialized] = mightThrowSync<T>(() =>\n      this.deserialize(value),\n    );\n\n    if (deserializeErr) {\n      return this.fail(\n        \"CacheError\",\n        `Unable to deserialize value for key ${key}`,\n      );\n    }\n\n    return ok(deserialized);\n  }\n\n  public async set(key: string, value: T) {\n    if (!this.isEnabled) {\n      return ok(value);\n    }\n\n    const [serializeErr, serialized] = mightThrowSync(() =>\n      this.serialize(value),\n    );\n\n    if (serializeErr) {\n      return this.fail(\n        \"CacheError\",\n        `Unable to serialize value for key ${key}`,\n      );\n    }\n\n    if (serialized === null || serialized === undefined) {\n      return this.fail(\n        \"CacheError\",\n        `Unable to serialize value for key ${key}`,\n      );\n    }\n\n    const [ttlErr, ttl] = mightThrowSync(() => this.resolveTTL(key, value));\n\n    if (ttlErr) {\n      return this.fail(\n        \"InvalidTTLError\",\n        `Unable to resolve ttl for key ${key}`,\n      );\n    }\n\n    if (!this.isTTLValid(ttl)) {\n      return this.fail(\n        \"InvalidTTLError\",\n        `Unable to save records with ttl equal to ${ttl}`,\n      );\n    }\n\n    const resolvedKey = this.resolveKey(key);\n\n    const setPromise = this.getSetPromise(resolvedKey, serialized, ttl);\n\n    const [setError] = await mightThrow(setPromise);\n\n    if (setError) {\n      return this.fail(\"CacheError\", `Unable to set value for key ${key}`);\n    }\n\n    return ok(value);\n  }\n\n  public async delete(key: string) {\n    if (!this.isEnabled) {\n      return ok(0);\n    }\n\n    const resolvedKey = this.resolveKey(key);\n\n    const [error, data] = await mightThrow(this.options.redis.del(resolvedKey));\n\n    if (error) {\n      return this.fail(\"CacheError\", `Unable to delete key ${key}`);\n    }\n\n    return ok(data);\n  }\n\n  private fail<E extends CacheError>(type: E, message: string) {\n    this.options.onError?.({ type, message });\n\n    return err(type, message);\n  }\n\n  private get isEnabled() {\n    return this.options.enabled !== false;\n  }\n\n  private resolveKey(key: string) {\n    if (this.options.prefix) {\n      return `${this.options.prefix}:${key}`;\n    }\n\n    return key;\n  }\n\n  private resolveTTL(key: string, value: T) {\n    if (typeof this.options.ttl === \"function\") {\n      return this.options.ttl(key, value);\n    }\n\n    return this.options.ttl;\n  }\n\n  private getSetPromise(\n    key: string,\n    value: string,\n    ttl: number | undefined | null,\n  ) {\n    if (ttl === undefined || ttl === null) {\n      return this.options.redis.set(key, value);\n    }\n\n    return this.options.redis.set(key, value, \"PX\", ttl);\n  }\n\n  private isTTLValid(ttl: number | undefined | null) {\n    if (ttl === undefined || ttl === null) return true;\n\n    if (!Number.isFinite(ttl)) return false;\n\n    if (!Number.isInteger(ttl)) return false;\n\n    if (ttl < 0) return false;\n\n    return true;\n  }\n}\n"],"mappings":"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"}

package/dist/lib/cron/index.cjs

@@ -0,0 +1,276 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_lib_errors_index = require("../errors/index.cjs");
+const require_scanner = require("../../cron/scanner.cjs");
+//#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 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(/* @__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 require_lib_errors_index.mightThrow(Promise.resolve(handlerResult));
+		if (this.status === "running") this.next();
+	}
+};
+//#endregion
+exports.Cron = Cron;

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

@@ -0,0 +1,39 @@
+import { CronOptions, CronStatus } from "../../cron/types.cjs";
+
+//#region src/lib/cron/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/lib/cron/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../../src/lib/cron/index.ts"],"mappings":";;;cA6Ca,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;EAuCV,KAAA,CAAA;EAOA,IAAA,CAAA;EASA,KAAA,CAAA;EAWA,MAAA,CAAA;EAOA,SAAA,CAAA,GAAS,UAAA;EAAA,QAIR,IAAA;EAAA,QAmBM,GAAA;AAAA"}

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

@@ -0,0 +1,39 @@
+import { CronOptions, CronStatus } from "../../cron/types.mjs";
+
+//#region src/lib/cron/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/lib/cron/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../src/lib/cron/index.ts"],"mappings":";;;cA6Ca,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;EAuCV,KAAA,CAAA;EAOA,IAAA,CAAA;EASA,KAAA,CAAA;EAWA,MAAA,CAAA;EAOA,SAAA,CAAA,GAAS,UAAA;EAAA,QAIR,IAAA;EAAA,QAmBM,GAAA;AAAA"}