semola 0.5.1 → 0.5.3

package/dist/api/validation/index.cjs

@@ -0,0 +1,64 @@
+const require_lib_errors_index = require("../../lib/errors/index.cjs");
+//#region src/lib/api/validation/index.ts
+const validateSchema = async (schema, data) => {
+	const result = await schema["~standard"].validate(data);
+	if (!result.issues) return require_lib_errors_index.ok(result.value);
+	return require_lib_errors_index.err("ValidationError", result.issues.map((issue) => {
+		let path = "unknown";
+		if (Array.isArray(issue.path)) path = issue.path.map(String).join(".");
+		return `${path}: ${issue.message ?? "validation failed"}`;
+	}).join(", "));
+};
+const validateBody = async (req, bodySchema, bodyCache) => {
+	if (!bodySchema) return require_lib_errors_index.ok(true);
+	if (!(req.headers.get("content-type") ?? "").includes("application/json")) return require_lib_errors_index.ok(void 0);
+	if (bodyCache?.parsed) return validateSchema(bodySchema, bodyCache.value);
+	const [parseError, parsedBody] = await require_lib_errors_index.mightThrow(req.json());
+	if (parseError) return require_lib_errors_index.err("ParseError", "Invalid JSON body");
+	if (bodyCache) {
+		bodyCache.parsed = true;
+		bodyCache.value = parsedBody;
+	}
+	return validateSchema(bodySchema, parsedBody);
+};
+const validateQuery = async (req, querySchema) => {
+	if (!querySchema) return require_lib_errors_index.ok(true);
+	const qIndex = req.url.indexOf("?");
+	if (qIndex === -1) return validateSchema(querySchema, {});
+	const hashIndex = req.url.indexOf("#", qIndex + 1);
+	const queryString = hashIndex === -1 ? req.url.slice(qIndex + 1) : req.url.slice(qIndex + 1, hashIndex);
+	const searchParams = new URLSearchParams(queryString);
+	const queryParams = {};
+	for (const key of searchParams.keys()) {
+		const values = searchParams.getAll(key);
+		const [firstValue] = values;
+		if (values.length === 1) queryParams[key] = firstValue;
+		else queryParams[key] = values;
+	}
+	return validateSchema(querySchema, queryParams);
+};
+const validateHeaders = async (req, headersSchema) => {
+	if (!headersSchema) return require_lib_errors_index.ok(true);
+	const headers = {};
+	req.headers.forEach((value, key) => {
+		headers[key] = value;
+	});
+	return validateSchema(headersSchema, headers);
+};
+const validateCookies = async (req, cookiesSchema) => {
+	if (!cookiesSchema) return require_lib_errors_index.ok(true);
+	const cookieHeader = req.headers.get("cookie") ?? "";
+	const cookieMap = new Bun.CookieMap(cookieHeader);
+	return validateSchema(cookiesSchema, Object.fromEntries(cookieMap));
+};
+const validateParams = async (req, paramsSchema) => {
+	if (!paramsSchema) return require_lib_errors_index.ok(true);
+	return validateSchema(paramsSchema, req.params);
+};
+//#endregion
+exports.validateBody = validateBody;
+exports.validateCookies = validateCookies;
+exports.validateHeaders = validateHeaders;
+exports.validateParams = validateParams;
+exports.validateQuery = validateQuery;
+exports.validateSchema = validateSchema;

package/dist/api/validation/index.mjs

@@ -0,0 +1,61 @@
+import { err, mightThrow, ok } from "../../lib/errors/index.mjs";
+//#region src/lib/api/validation/index.ts
+const validateSchema = async (schema, data) => {
+	const result = await schema["~standard"].validate(data);
+	if (!result.issues) return ok(result.value);
+	return err("ValidationError", result.issues.map((issue) => {
+		let path = "unknown";
+		if (Array.isArray(issue.path)) path = issue.path.map(String).join(".");
+		return `${path}: ${issue.message ?? "validation failed"}`;
+	}).join(", "));
+};
+const validateBody = async (req, bodySchema, bodyCache) => {
+	if (!bodySchema) return ok(true);
+	if (!(req.headers.get("content-type") ?? "").includes("application/json")) return ok(void 0);
+	if (bodyCache?.parsed) return validateSchema(bodySchema, bodyCache.value);
+	const [parseError, parsedBody] = await mightThrow(req.json());
+	if (parseError) return err("ParseError", "Invalid JSON body");
+	if (bodyCache) {
+		bodyCache.parsed = true;
+		bodyCache.value = parsedBody;
+	}
+	return validateSchema(bodySchema, parsedBody);
+};
+const validateQuery = async (req, querySchema) => {
+	if (!querySchema) return ok(true);
+	const qIndex = req.url.indexOf("?");
+	if (qIndex === -1) return validateSchema(querySchema, {});
+	const hashIndex = req.url.indexOf("#", qIndex + 1);
+	const queryString = hashIndex === -1 ? req.url.slice(qIndex + 1) : req.url.slice(qIndex + 1, hashIndex);
+	const searchParams = new URLSearchParams(queryString);
+	const queryParams = {};
+	for (const key of searchParams.keys()) {
+		const values = searchParams.getAll(key);
+		const [firstValue] = values;
+		if (values.length === 1) queryParams[key] = firstValue;
+		else queryParams[key] = values;
+	}
+	return validateSchema(querySchema, queryParams);
+};
+const validateHeaders = async (req, headersSchema) => {
+	if (!headersSchema) return ok(true);
+	const headers = {};
+	req.headers.forEach((value, key) => {
+		headers[key] = value;
+	});
+	return validateSchema(headersSchema, headers);
+};
+const validateCookies = async (req, cookiesSchema) => {
+	if (!cookiesSchema) return ok(true);
+	const cookieHeader = req.headers.get("cookie") ?? "";
+	const cookieMap = new Bun.CookieMap(cookieHeader);
+	return validateSchema(cookiesSchema, Object.fromEntries(cookieMap));
+};
+const validateParams = async (req, paramsSchema) => {
+	if (!paramsSchema) return ok(true);
+	return validateSchema(paramsSchema, req.params);
+};
+//#endregion
+export { validateBody, validateCookies, validateHeaders, validateParams, validateQuery, validateSchema };
+
+//# sourceMappingURL=index.mjs.map

package/dist/api/validation/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/lib/api/validation/index.ts"],"sourcesContent":["import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport { err, mightThrow, ok } from \"../../errors/index.js\";\n\nexport const validateSchema = async <T>(\n  schema: StandardSchemaV1,\n  data: unknown,\n) => {\n  const result = await schema[\"~standard\"].validate(data);\n\n  if (!result.issues) {\n    return ok(result.value as T);\n  }\n\n  const issues = result.issues.map((issue) => {\n    let path = \"unknown\";\n\n    if (Array.isArray(issue.path)) {\n      path = issue.path.map(String).join(\".\");\n    }\n\n    return `${path}: ${issue.message ?? \"validation failed\"}`;\n  });\n\n  const message = issues.join(\", \");\n\n  return err(\"ValidationError\", message);\n};\n\nexport type BodyCache = { parsed: boolean; value: unknown };\n\n// Body cache prevents re-parsing JSON when multiple middlewares validate the same body\nexport const validateBody = async (\n  req: Request,\n  bodySchema?: StandardSchemaV1,\n  bodyCache?: BodyCache,\n) => {\n  if (!bodySchema) {\n    return ok(true);\n  }\n\n  const contentType = req.headers.get(\"content-type\") ?? \"\";\n\n  if (!contentType.includes(\"application/json\")) {\n    return ok(undefined);\n  }\n\n  if (bodyCache?.parsed) {\n    return validateSchema(bodySchema, bodyCache.value);\n  }\n\n  const [parseError, parsedBody] = await mightThrow(req.json());\n\n  if (parseError) {\n    return err(\"ParseError\", \"Invalid JSON body\");\n  }\n\n  if (bodyCache) {\n    bodyCache.parsed = true;\n    bodyCache.value = parsedBody;\n  }\n\n  return validateSchema(bodySchema, parsedBody);\n};\n\nexport const validateQuery = async (\n  req: Request,\n  querySchema?: StandardSchemaV1,\n) => {\n  if (!querySchema) {\n    return ok(true);\n  }\n\n  const qIndex = req.url.indexOf(\"?\");\n\n  if (qIndex === -1) {\n    return validateSchema(querySchema, {});\n  }\n\n  // Handle both query strings and URL fragments\n  const hashIndex = req.url.indexOf(\"#\", qIndex + 1);\n  const queryString =\n    hashIndex === -1\n      ? req.url.slice(qIndex + 1)\n      : req.url.slice(qIndex + 1, hashIndex);\n\n  const searchParams = new URLSearchParams(queryString);\n  const queryParams: Record<string, string | string[]> = {};\n\n  for (const key of searchParams.keys()) {\n    const values = searchParams.getAll(key);\n    const [firstValue] = values;\n\n    if (values.length === 1) {\n      queryParams[key] = firstValue as string;\n    } else {\n      queryParams[key] = values;\n    }\n  }\n\n  return validateSchema(querySchema, queryParams);\n};\n\nexport const validateHeaders = async (\n  req: Request,\n  headersSchema?: StandardSchemaV1,\n) => {\n  if (!headersSchema) {\n    return ok(true);\n  }\n\n  const headers: Record<string, string> = {};\n\n  req.headers.forEach((value, key) => {\n    headers[key] = value;\n  });\n\n  return validateSchema(headersSchema, headers);\n};\n\nexport const validateCookies = async (\n  req: Request,\n  cookiesSchema?: StandardSchemaV1,\n) => {\n  if (!cookiesSchema) {\n    return ok(true);\n  }\n\n  // Use Bun's native CookieMap for efficient cookie parsing\n  const cookieHeader = req.headers.get(\"cookie\") ?? \"\";\n  const cookieMap = new Bun.CookieMap(cookieHeader);\n  const cookies = Object.fromEntries(cookieMap);\n\n  return validateSchema(cookiesSchema, cookies);\n};\n\nexport const validateParams = async (\n  req: Bun.BunRequest,\n  paramsSchema?: StandardSchemaV1,\n) => {\n  if (!paramsSchema) {\n    return ok(true);\n  }\n\n  return validateSchema(paramsSchema, req.params);\n};\n"],"mappings":";;AAGA,MAAa,iBAAiB,OAC5B,QACA,SACG;CACH,MAAM,SAAS,MAAM,OAAO,aAAa,SAAS,KAAK;AAEvD,KAAI,CAAC,OAAO,OACV,QAAO,GAAG,OAAO,MAAW;AAe9B,QAAO,IAAI,mBAZI,OAAO,OAAO,KAAK,UAAU;EAC1C,IAAI,OAAO;AAEX,MAAI,MAAM,QAAQ,MAAM,KAAK,CAC3B,QAAO,MAAM,KAAK,IAAI,OAAO,CAAC,KAAK,IAAI;AAGzC,SAAO,GAAG,KAAK,IAAI,MAAM,WAAW;GACpC,CAEqB,KAAK,KAAK,CAEK;;AAMxC,MAAa,eAAe,OAC1B,KACA,YACA,cACG;AACH,KAAI,CAAC,WACH,QAAO,GAAG,KAAK;AAKjB,KAAI,EAFgB,IAAI,QAAQ,IAAI,eAAe,IAAI,IAEtC,SAAS,mBAAmB,CAC3C,QAAO,GAAG,KAAA,EAAU;AAGtB,KAAI,WAAW,OACb,QAAO,eAAe,YAAY,UAAU,MAAM;CAGpD,MAAM,CAAC,YAAY,cAAc,MAAM,WAAW,IAAI,MAAM,CAAC;AAE7D,KAAI,WACF,QAAO,IAAI,cAAc,oBAAoB;AAG/C,KAAI,WAAW;AACb,YAAU,SAAS;AACnB,YAAU,QAAQ;;AAGpB,QAAO,eAAe,YAAY,WAAW;;AAG/C,MAAa,gBAAgB,OAC3B,KACA,gBACG;AACH,KAAI,CAAC,YACH,QAAO,GAAG,KAAK;CAGjB,MAAM,SAAS,IAAI,IAAI,QAAQ,IAAI;AAEnC,KAAI,WAAW,GACb,QAAO,eAAe,aAAa,EAAE,CAAC;CAIxC,MAAM,YAAY,IAAI,IAAI,QAAQ,KAAK,SAAS,EAAE;CAClD,MAAM,cACJ,cAAc,KACV,IAAI,IAAI,MAAM,SAAS,EAAE,GACzB,IAAI,IAAI,MAAM,SAAS,GAAG,UAAU;CAE1C,MAAM,eAAe,IAAI,gBAAgB,YAAY;CACrD,MAAM,cAAiD,EAAE;AAEzD,MAAK,MAAM,OAAO,aAAa,MAAM,EAAE;EACrC,MAAM,SAAS,aAAa,OAAO,IAAI;EACvC,MAAM,CAAC,cAAc;AAErB,MAAI,OAAO,WAAW,EACpB,aAAY,OAAO;MAEnB,aAAY,OAAO;;AAIvB,QAAO,eAAe,aAAa,YAAY;;AAGjD,MAAa,kBAAkB,OAC7B,KACA,kBACG;AACH,KAAI,CAAC,cACH,QAAO,GAAG,KAAK;CAGjB,MAAM,UAAkC,EAAE;AAE1C,KAAI,QAAQ,SAAS,OAAO,QAAQ;AAClC,UAAQ,OAAO;GACf;AAEF,QAAO,eAAe,eAAe,QAAQ;;AAG/C,MAAa,kBAAkB,OAC7B,KACA,kBACG;AACH,KAAI,CAAC,cACH,QAAO,GAAG,KAAK;CAIjB,MAAM,eAAe,IAAI,QAAQ,IAAI,SAAS,IAAI;CAClD,MAAM,YAAY,IAAI,IAAI,UAAU,aAAa;AAGjD,QAAO,eAAe,eAFN,OAAO,YAAY,UAAU,CAEA;;AAG/C,MAAa,iBAAiB,OAC5B,KACA,iBACG;AACH,KAAI,CAAC,aACH,QAAO,GAAG,KAAK;AAGjB,QAAO,eAAe,cAAc,IAAI,OAAO"}

package/dist/cache/types.d.cts

@@ -0,0 +1,17 @@
+//#region src/lib/cache/types.d.ts
+type CacheError = "CacheError" | "InvalidTTLError" | "NotFoundError";
+type CacheOptions<T> = {
+  redis: Bun.RedisClient;
+  ttl?: number | ((key: string, value: T) => number);
+  enabled?: boolean;
+  prefix?: string;
+  serializer?: (value: T) => string;
+  deserializer?: (raw: string) => T;
+  onError?: (error: {
+    type: CacheError;
+    message: string;
+  }) => void;
+};
+//#endregion
+export { CacheOptions };
+//# sourceMappingURL=types.d.cts.map

package/dist/cache/types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.cts","names":[],"sources":["../../src/lib/cache/types.ts"],"mappings":";KAAY,UAAA;AAAA,KAEA,YAAA;EACV,KAAA,EAAO,GAAA,CAAI,WAAA;EACX,GAAA,cAAiB,GAAA,UAAa,KAAA,EAAO,CAAA;EACrC,OAAA;EACA,MAAA;EACA,UAAA,IAAc,KAAA,EAAO,CAAA;EACrB,YAAA,IAAgB,GAAA,aAAgB,CAAA;EAChC,OAAA,IAAW,KAAA;IAAS,IAAA,EAAM,UAAA;IAAY,OAAA;EAAA;AAAA"}

package/dist/cache/types.d.mts

@@ -0,0 +1,17 @@
+//#region src/lib/cache/types.d.ts
+type CacheError = "CacheError" | "InvalidTTLError" | "NotFoundError";
+type CacheOptions<T> = {
+  redis: Bun.RedisClient;
+  ttl?: number | ((key: string, value: T) => number);
+  enabled?: boolean;
+  prefix?: string;
+  serializer?: (value: T) => string;
+  deserializer?: (raw: string) => T;
+  onError?: (error: {
+    type: CacheError;
+    message: string;
+  }) => void;
+};
+//#endregion
+export { CacheOptions };
+//# sourceMappingURL=types.d.mts.map

package/dist/cache/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../src/lib/cache/types.ts"],"mappings":";KAAY,UAAA;AAAA,KAEA,YAAA;EACV,KAAA,EAAO,GAAA,CAAI,WAAA;EACX,GAAA,cAAiB,GAAA,UAAa,KAAA,EAAO,CAAA;EACrC,OAAA;EACA,MAAA;EACA,UAAA,IAAc,KAAA,EAAO,CAAA;EACrB,YAAA,IAAgB,GAAA,aAAgB,CAAA;EAChC,OAAA,IAAW,KAAA;IAAS,IAAA,EAAM,UAAA;IAAY,OAAA;EAAA;AAAA"}

package/dist/cron/builder/index.cjs

@@ -0,0 +1,166 @@
+//#region src/lib/cron/builder/index.ts
+const CRON_FIELD_ORDER = [
+	"second",
+	"minute",
+	"hour",
+	"day",
+	"month",
+	"weekday"
+];
+var FieldWrapper = class {
+	fields = [];
+	add(expr) {
+		this.fields.push(expr);
+	}
+	read() {
+		return this.fields;
+	}
+};
+var CronListBuilder = class {
+	wrapper;
+	constructor(wrapper) {
+		this.wrapper = wrapper;
+	}
+	any() {
+		this.wrapper.add({ type: "any" });
+		return this;
+	}
+	range(options) {
+		this.wrapper.add({
+			type: "range",
+			...options
+		});
+		return this;
+	}
+	step(options) {
+		this.wrapper.add({
+			type: "step",
+			...options
+		});
+		return this;
+	}
+	number(value) {
+		this.wrapper.add({
+			type: "value",
+			value
+		});
+		return this;
+	}
+};
+function range(options) {
+	return {
+		type: "range",
+		...options
+	};
+}
+function any() {
+	return { type: "any" };
+}
+function step(options) {
+	return {
+		type: "step",
+		...options
+	};
+}
+function list(builderFn) {
+	const wrapper = new FieldWrapper();
+	builderFn(new CronListBuilder(wrapper));
+	return {
+		type: "list",
+		values: wrapper.read()
+	};
+}
+function number(value) {
+	return {
+		type: "value",
+		value
+	};
+}
+function cronJobBuilder(buildFn) {
+	const fields = {
+		second: void 0,
+		minute: void 0,
+		hour: void 0,
+		day: void 0,
+		month: void 0,
+		weekday: void 0
+	};
+	const obj = {
+		second(expr) {
+			fields.second = checkExpr(expr);
+			return obj;
+		},
+		minute(expr) {
+			fields.minute = checkExpr(expr);
+			return obj;
+		},
+		hour(expr) {
+			fields.hour = checkExpr(expr);
+			return obj;
+		},
+		day(expr) {
+			fields.day = checkExpr(expr);
+			return obj;
+		},
+		month(expr) {
+			fields.month = checkExpr(expr);
+			return obj;
+		},
+		weekday(expr) {
+			fields.weekday = checkExpr(expr);
+			return obj;
+		}
+	};
+	buildFn(obj);
+	return generate(fields);
+}
+function checkExpr(expr) {
+	if (expr.type === "list") {
+		const { values } = expr;
+		if (values.length === 0) throw new Error("EmptyListError: List expression cannot be empty");
+		return values.map((e) => handleSimpleExpression(e)).join(",");
+	}
+	return handleSimpleExpression(expr);
+}
+function handleSimpleExpression(expr) {
+	switch (expr.type) {
+		case "any": return "*";
+		case "value": return `${expr.value}`;
+		case "range": {
+			const { min, max } = expr;
+			if (min > max) throw new Error(`OutOfBoundError: Expected ${min} <= ${max}`);
+			return `${min}-${max}`;
+		}
+		case "step": {
+			const { step, range } = expr;
+			if (step === 0) throw new Error(`OutOfBoundError: Expected step value greater than zero`);
+			if (!range) return `*/${step}`;
+			const { min, max } = range;
+			if (max === 0) {
+				if (min > max) throw new Error(`OutOfBoundError: Expected max value greater than zero`);
+				return `${min}-${max}/${step}`;
+			}
+			if (!max) return `${min}/${step}`;
+			if (min > max) throw new Error(`OutOfBoundError: Expected ${min} <= ${max}`);
+			return `${min}-${max}/${step}`;
+		}
+		default: return "*";
+	}
+}
+function generate(fields) {
+	const parts = [];
+	for (let index = 0; index < CRON_FIELD_ORDER.length; index++) {
+		const key = CRON_FIELD_ORDER[index];
+		if (!key) return "";
+		if (key === "second" && !fields[key]) continue;
+		parts.push(fields[key] ?? "*");
+	}
+	return parts.join(" ");
+}
+//#endregion
+exports.any = any;
+exports.cronJobBuilder = cronJobBuilder;
+exports.list = list;
+exports.number = number;
+exports.range = range;
+exports.step = step;

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

@@ -0,0 +1,28 @@
+import { BuilderFn, CronExpr, CronListExpr, CronRange, CronStep } from "./types.cjs";
+
+//#region src/lib/cron/builder/index.d.ts
+declare class FieldWrapper<T> {
+  private fields;
+  add(expr: CronListExpr<T>): void;
+  read(): CronListExpr<T>[];
+}
+declare class CronListBuilder<T> {
+  private wrapper;
+  constructor(wrapper: FieldWrapper<T>);
+  any(): CronListBuilder<T>;
+  range(options: CronRange<T>): CronListBuilder<T>;
+  step(options: CronStep<T>): CronListBuilder<T>;
+  number(value: T): CronListBuilder<T>;
+}
+declare function range<T>(options: CronRange<T>): CronExpr<T>;
+declare function any<T>(): CronExpr<T>;
+declare function step<T>(options: CronStep<T>): CronExpr<T>;
+declare function list<T>(builderFn: (builder: CronListBuilder<T>) => CronListBuilder<T>): CronExpr<T>;
+declare function number<T>(value: T): {
+  type: "value";
+  value: T;
+};
+declare function cronJobBuilder(buildFn: BuilderFn): string;
+//#endregion
+export { any, cronJobBuilder, list, number, range, step };
+//# sourceMappingURL=index.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../../src/lib/cron/builder/index.ts"],"mappings":";;;cAwBM,YAAA;EAAA,QACI,MAAA;EAED,GAAA,CAAI,IAAA,EAAM,YAAA,CAAa,CAAA;EAIvB,IAAA,CAAA,GAAI,YAAA,CAAA,CAAA;AAAA;AAAA,cAKP,eAAA;EAAA,QACI,OAAA;cAEW,OAAA,EAAS,YAAA,CAAa,CAAA;EAIlC,GAAA,CAAA,GAAO,eAAA,CAAgB,CAAA;EAKvB,KAAA,CAAM,OAAA,EAAS,SAAA,CAAU,CAAA,IAAK,eAAA,CAAgB,CAAA;EAK9C,IAAA,CAAK,OAAA,EAAS,QAAA,CAAS,CAAA,IAAK,eAAA,CAAgB,CAAA;EAK5C,MAAA,CAAO,KAAA,EAAO,CAAA,GAAI,eAAA,CAAgB,CAAA;AAAA;AAAA,iBAM3B,KAAA,GAAA,CAAS,OAAA,EAAS,SAAA,CAAU,CAAA,IAAK,QAAA,CAAS,CAAA;AAAA,iBAI1C,GAAA,GAAA,CAAA,GAAU,QAAA,CAAS,CAAA;AAAA,iBAInB,IAAA,GAAA,CAAQ,OAAA,EAAS,QAAA,CAAS,CAAA,IAAK,QAAA,CAAS,CAAA;AAAA,iBAIxC,IAAA,GAAA,CACd,SAAA,GAAY,OAAA,EAAS,eAAA,CAAgB,CAAA,MAAO,eAAA,CAAgB,CAAA,IAC3D,QAAA,CAAS,CAAA;AAAA,iBAOI,MAAA,GAAA,CAAU,KAAA,EAAO,CAAA;;SAAA,CAAA;AAAA;AAAA,iBAIjB,cAAA,CAAe,OAAA,EAAS,SAAA"}

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

@@ -0,0 +1,28 @@
+import { BuilderFn, CronExpr, CronListExpr, CronRange, CronStep } from "./types.mjs";
+
+//#region src/lib/cron/builder/index.d.ts
+declare class FieldWrapper<T> {
+  private fields;
+  add(expr: CronListExpr<T>): void;
+  read(): CronListExpr<T>[];
+}
+declare class CronListBuilder<T> {
+  private wrapper;
+  constructor(wrapper: FieldWrapper<T>);
+  any(): CronListBuilder<T>;
+  range(options: CronRange<T>): CronListBuilder<T>;
+  step(options: CronStep<T>): CronListBuilder<T>;
+  number(value: T): CronListBuilder<T>;
+}
+declare function range<T>(options: CronRange<T>): CronExpr<T>;
+declare function any<T>(): CronExpr<T>;
+declare function step<T>(options: CronStep<T>): CronExpr<T>;
+declare function list<T>(builderFn: (builder: CronListBuilder<T>) => CronListBuilder<T>): CronExpr<T>;
+declare function number<T>(value: T): {
+  type: "value";
+  value: T;
+};
+declare function cronJobBuilder(buildFn: BuilderFn): string;
+//#endregion
+export { any, cronJobBuilder, list, number, range, step };
+//# sourceMappingURL=index.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../src/lib/cron/builder/index.ts"],"mappings":";;;cAwBM,YAAA;EAAA,QACI,MAAA;EAED,GAAA,CAAI,IAAA,EAAM,YAAA,CAAa,CAAA;EAIvB,IAAA,CAAA,GAAI,YAAA,CAAA,CAAA;AAAA;AAAA,cAKP,eAAA;EAAA,QACI,OAAA;cAEW,OAAA,EAAS,YAAA,CAAa,CAAA;EAIlC,GAAA,CAAA,GAAO,eAAA,CAAgB,CAAA;EAKvB,KAAA,CAAM,OAAA,EAAS,SAAA,CAAU,CAAA,IAAK,eAAA,CAAgB,CAAA;EAK9C,IAAA,CAAK,OAAA,EAAS,QAAA,CAAS,CAAA,IAAK,eAAA,CAAgB,CAAA;EAK5C,MAAA,CAAO,KAAA,EAAO,CAAA,GAAI,eAAA,CAAgB,CAAA;AAAA;AAAA,iBAM3B,KAAA,GAAA,CAAS,OAAA,EAAS,SAAA,CAAU,CAAA,IAAK,QAAA,CAAS,CAAA;AAAA,iBAI1C,GAAA,GAAA,CAAA,GAAU,QAAA,CAAS,CAAA;AAAA,iBAInB,IAAA,GAAA,CAAQ,OAAA,EAAS,QAAA,CAAS,CAAA,IAAK,QAAA,CAAS,CAAA;AAAA,iBAIxC,IAAA,GAAA,CACd,SAAA,GAAY,OAAA,EAAS,eAAA,CAAgB,CAAA,MAAO,eAAA,CAAgB,CAAA,IAC3D,QAAA,CAAS,CAAA;AAAA,iBAOI,MAAA,GAAA,CAAU,KAAA,EAAO,CAAA;;SAAA,CAAA;AAAA;AAAA,iBAIjB,cAAA,CAAe,OAAA,EAAS,SAAA"}

package/dist/cron/builder/index.mjs

@@ -0,0 +1,163 @@
+//#region src/lib/cron/builder/index.ts
+const CRON_FIELD_ORDER = [
+	"second",
+	"minute",
+	"hour",
+	"day",
+	"month",
+	"weekday"
+];
+var FieldWrapper = class {
+	fields = [];
+	add(expr) {
+		this.fields.push(expr);
+	}
+	read() {
+		return this.fields;
+	}
+};
+var CronListBuilder = class {
+	wrapper;
+	constructor(wrapper) {
+		this.wrapper = wrapper;
+	}
+	any() {
+		this.wrapper.add({ type: "any" });
+		return this;
+	}
+	range(options) {
+		this.wrapper.add({
+			type: "range",
+			...options
+		});
+		return this;
+	}
+	step(options) {
+		this.wrapper.add({
+			type: "step",
+			...options
+		});
+		return this;
+	}
+	number(value) {
+		this.wrapper.add({
+			type: "value",
+			value
+		});
+		return this;
+	}
+};
+function range(options) {
+	return {
+		type: "range",
+		...options
+	};
+}
+function any() {
+	return { type: "any" };
+}
+function step(options) {
+	return {
+		type: "step",
+		...options
+	};
+}
+function list(builderFn) {
+	const wrapper = new FieldWrapper();
+	builderFn(new CronListBuilder(wrapper));
+	return {
+		type: "list",
+		values: wrapper.read()
+	};
+}
+function number(value) {
+	return {
+		type: "value",
+		value
+	};
+}
+function cronJobBuilder(buildFn) {
+	const fields = {
+		second: void 0,
+		minute: void 0,
+		hour: void 0,
+		day: void 0,
+		month: void 0,
+		weekday: void 0
+	};
+	const obj = {
+		second(expr) {
+			fields.second = checkExpr(expr);
+			return obj;
+		},
+		minute(expr) {
+			fields.minute = checkExpr(expr);
+			return obj;
+		},
+		hour(expr) {
+			fields.hour = checkExpr(expr);
+			return obj;
+		},
+		day(expr) {
+			fields.day = checkExpr(expr);
+			return obj;
+		},
+		month(expr) {
+			fields.month = checkExpr(expr);
+			return obj;
+		},
+		weekday(expr) {
+			fields.weekday = checkExpr(expr);
+			return obj;
+		}
+	};
+	buildFn(obj);
+	return generate(fields);
+}
+function checkExpr(expr) {
+	if (expr.type === "list") {
+		const { values } = expr;
+		if (values.length === 0) throw new Error("EmptyListError: List expression cannot be empty");
+		return values.map((e) => handleSimpleExpression(e)).join(",");
+	}
+	return handleSimpleExpression(expr);
+}
+function handleSimpleExpression(expr) {
+	switch (expr.type) {
+		case "any": return "*";
+		case "value": return `${expr.value}`;
+		case "range": {
+			const { min, max } = expr;
+			if (min > max) throw new Error(`OutOfBoundError: Expected ${min} <= ${max}`);
+			return `${min}-${max}`;
+		}
+		case "step": {
+			const { step, range } = expr;
+			if (step === 0) throw new Error(`OutOfBoundError: Expected step value greater than zero`);
+			if (!range) return `*/${step}`;
+			const { min, max } = range;
+			if (max === 0) {
+				if (min > max) throw new Error(`OutOfBoundError: Expected max value greater than zero`);
+				return `${min}-${max}/${step}`;
+			}
+			if (!max) return `${min}/${step}`;
+			if (min > max) throw new Error(`OutOfBoundError: Expected ${min} <= ${max}`);
+			return `${min}-${max}/${step}`;
+		}
+		default: return "*";
+	}
+}
+function generate(fields) {
+	const parts = [];
+	for (let index = 0; index < CRON_FIELD_ORDER.length; index++) {
+		const key = CRON_FIELD_ORDER[index];
+		if (!key) return "";
+		if (key === "second" && !fields[key]) continue;
+		parts.push(fields[key] ?? "*");
+	}
+	return parts.join(" ");
+}
+//#endregion
+export { any, cronJobBuilder, list, number, range, step };
+
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/lib/cron/builder/index.ts"],"sourcesContent":["import type {\n  BuilderFn,\n  CronBuilderType,\n  CronExpr,\n  CronField,\n  CronListExpr,\n  CronRange,\n  CronStep,\n  DayType,\n  HourType,\n  MonthType,\n  TimeType,\n  WeekDayType,\n} from \"./types.js\";\n\nconst CRON_FIELD_ORDER: CronField[] = [\n  \"second\",\n  \"minute\",\n  \"hour\",\n  \"day\",\n  \"month\",\n  \"weekday\",\n] as const;\n\nclass FieldWrapper<T> {\n  private fields: CronListExpr<T>[] = [];\n\n  public add(expr: CronListExpr<T>) {\n    this.fields.push(expr);\n  }\n\n  public read() {\n    return this.fields;\n  }\n}\n\nclass CronListBuilder<T> {\n  private wrapper: FieldWrapper<T>;\n\n  public constructor(wrapper: FieldWrapper<T>) {\n    this.wrapper = wrapper;\n  }\n\n  public any(): CronListBuilder<T> {\n    this.wrapper.add({ type: \"any\" });\n    return this;\n  }\n\n  public range(options: CronRange<T>): CronListBuilder<T> {\n    this.wrapper.add({ type: \"range\", ...options });\n    return this;\n  }\n\n  public step(options: CronStep<T>): CronListBuilder<T> {\n    this.wrapper.add({ type: \"step\", ...options });\n    return this;\n  }\n\n  public number(value: T): CronListBuilder<T> {\n    this.wrapper.add({ type: \"value\", value: value });\n    return this;\n  }\n}\n\nexport function range<T>(options: CronRange<T>): CronExpr<T> {\n  return { type: \"range\", ...options };\n}\n\nexport function any<T>(): CronExpr<T> {\n  return { type: \"any\" };\n}\n\nexport function step<T>(options: CronStep<T>): CronExpr<T> {\n  return { type: \"step\", ...options };\n}\n\nexport function list<T>(\n  builderFn: (builder: CronListBuilder<T>) => CronListBuilder<T>,\n): CronExpr<T> {\n  const wrapper = new FieldWrapper<T>();\n  builderFn(new CronListBuilder<T>(wrapper));\n\n  return { type: \"list\", values: wrapper.read() };\n}\n\nexport function number<T>(value: T) {\n  return { type: \"value\", value: value } satisfies CronExpr<T>;\n}\n\nexport function cronJobBuilder(buildFn: BuilderFn) {\n  const fields: Partial<Record<CronField, string>> = {\n    second: undefined,\n    minute: undefined,\n    hour: undefined,\n    day: undefined,\n    month: undefined,\n    weekday: undefined,\n  };\n\n  const obj: CronBuilderType = {\n    second(expr: CronExpr<TimeType>) {\n      fields.second = checkExpr(expr);\n      return obj;\n    },\n    minute(expr: CronExpr<TimeType>) {\n      fields.minute = checkExpr(expr);\n      return obj;\n    },\n    hour(expr: CronExpr<HourType>) {\n      fields.hour = checkExpr(expr);\n      return obj;\n    },\n    day(expr: CronExpr<DayType>) {\n      fields.day = checkExpr(expr);\n      return obj;\n    },\n    month(expr: CronExpr<MonthType>) {\n      fields.month = checkExpr(expr);\n      return obj;\n    },\n    weekday(expr: CronExpr<WeekDayType>) {\n      fields.weekday = checkExpr(expr);\n      return obj;\n    },\n  };\n\n  buildFn(obj);\n  return generate(fields);\n}\n\nfunction checkExpr<T>(expr: CronExpr<T>) {\n  if (expr.type === \"list\") {\n    const { values } = expr;\n    if (values.length === 0) {\n      throw new Error(\"EmptyListError: List expression cannot be empty\");\n    }\n\n    const data = values.map((e) => handleSimpleExpression(e));\n\n    return data.join(\",\");\n  }\n\n  return handleSimpleExpression(expr);\n}\n\nfunction handleSimpleExpression<T>(expr: CronExpr<T>) {\n  switch (expr.type) {\n    case \"any\": {\n      return \"*\";\n    }\n\n    case \"value\": {\n      return `${expr.value}`;\n    }\n\n    case \"range\": {\n      const { min, max } = expr;\n      if (min > max) {\n        throw new Error(`OutOfBoundError: Expected ${min} <= ${max}`);\n      }\n\n      return `${min}-${max}`;\n    }\n\n    case \"step\": {\n      const { step, range } = expr;\n\n      if (step === 0) {\n        throw new Error(\n          `OutOfBoundError: Expected step value greater than zero`,\n        );\n      }\n\n      if (!range) {\n        return `*/${step}`;\n      }\n\n      const { min, max } = range;\n\n      if (max === 0) {\n        if (min > max) {\n          throw new Error(\n            `OutOfBoundError: Expected max value greater than zero`,\n          );\n        }\n\n        return `${min}-${max}/${step}`;\n      }\n\n      if (!max) {\n        return `${min}/${step}`;\n      }\n\n      if (min > max) {\n        throw new Error(`OutOfBoundError: Expected ${min} <= ${max}`);\n      }\n\n      return `${min}-${max}/${step}`;\n    }\n\n    default: {\n      return \"*\";\n    }\n  }\n}\n\nfunction generate(fields: Partial<Record<CronField, string>>): string {\n  const parts: string[] = [];\n\n  for (let index = 0; index < CRON_FIELD_ORDER.length; index++) {\n    const key = CRON_FIELD_ORDER[index];\n    if (!key) return \"\";\n    if (key === \"second\" && !fields[key]) {\n      continue;\n    }\n\n    parts.push(fields[key] ?? \"*\");\n  }\n\n  return parts.join(\" \");\n}\n"],"mappings":"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"}

package/dist/cron/builder/types.cjs

@@ -0,0 +1,27 @@
+//#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
+exports.Month = Month;
+exports.WeekDay = WeekDay;