semola 0.5.1 → 0.5.3

package/dist/cron/core/scanner.mjs

@@ -0,0 +1,238 @@
+import { err, ok } from "../../lib/errors/index.mjs";
+//#region src/lib/cron/core/scanner.ts
+const FieldAmount = {
+	min: 5,
+	max: 6
+};
+var Token = class {
+	type;
+	component;
+	value;
+	field;
+	constructor(component, type, value, field) {
+		this.component = component;
+		this.type = type;
+		this.value = value;
+		this.field = field;
+	}
+	getComponent() {
+		return this.component;
+	}
+	getTokenType() {
+		return this.type;
+	}
+	getTokenValue() {
+		return this.value;
+	}
+	getField() {
+		return this.field;
+	}
+	toString() {
+		return `Token{${`component="${this.component}", type=${this.type}`}, ${`field="${this.field}", value=${this.value}`}}`;
+	}
+	equals(other) {
+		if (!other) return false;
+		const isComponentEqual = this.component === other.getComponent();
+		const isTokenTypeEqual = this.type === other.getTokenType();
+		const isTokenValueEqual = this.value === other.getTokenValue();
+		const isFieldEqual = this.field === other.getField();
+		return isComponentEqual && isTokenTypeEqual && isTokenValueEqual && isFieldEqual;
+	}
+};
+var Scanner = class {
+	expression;
+	current;
+	start;
+	tokens;
+	constructor(expression) {
+		this.expression = expression;
+		this.current = 0;
+		this.start = 0;
+		this.tokens = [];
+	}
+	scan() {
+		if (this.expression.length === 0) return err("EmptyCronExpressionError", "Cron expression have zero length");
+		const fields = this.expression.trim().split(/\s+/);
+		const hasMinLen = fields.length === FieldAmount.min;
+		const hasMaxLen = fields.length === FieldAmount.max;
+		if (!hasMinLen && !hasMaxLen) return err("CronLengthError", `Invalid number of fields for '${this.expression}'. Expected 5 or 6 fields but got ${fields.length} field(s)`);
+		const components = this.createComponent(fields);
+		for (let idx = 0; idx < components.length; idx++) {
+			const component = components[idx];
+			if (!component) return err("CronExpressionError", `Invalid cron expression: ${this.expression}`);
+			this.current = 0;
+			this.start = 0;
+			const [error, _] = this.scanComponent(component);
+			if (error) return err(error.type, error.message);
+		}
+		return ok(this.tokens);
+	}
+	scanComponent(component) {
+		const { field, content } = component;
+		while (this.current < content.length) {
+			let currentCh = this.advance(content);
+			switch (currentCh) {
+				case "*": {
+					const ch = this.peek(content);
+					if (this.match(content, "/")) {
+						const [error, _] = this.handleStep(component);
+						if (error) return err(error.type, error.message);
+					} else if (!ch || ch === ",") this.addToken("*", "any", "*", field);
+					else return err("CronExpressionError", `Invalid any expression '${content}' for field '${field}'`);
+					break;
+				}
+				case "-":
+					currentCh = this.advance(content);
+					if (this.isDigit(currentCh)) {
+						const [error, _] = this.handleRangeWithStep(component);
+						if (error) return err(error.type, error.message);
+					} else return err("CronExpressionError", `Invalid range expression '${content}' for field '${field}'`);
+					break;
+				case ",": {
+					if (this.current === 1 && this.start === 0) return err("CronExpressionError", `Invalid list expression '${content}' for field '${field}'`);
+					const next = this.peek(content);
+					if (!next || next === ",") return err("CronExpressionError", `Invalid list expression '${content}' for field '${field}'`);
+					break;
+				}
+				default:
+					if (this.isDigit(currentCh)) {
+						const [error, _] = this.handleNumber(component);
+						if (error) return err(error.type, error.message);
+					} else return err("CronExpressionError", `Invalid cron expression '${this.expression}' in field '${field}'`);
+					break;
+			}
+			this.start = this.current;
+		}
+		return ok(true);
+	}
+	addToken(component, type, value, field) {
+		const token = new Token(component, type, value, field);
+		this.tokens.push(token);
+	}
+	advance(content) {
+		const currentCh = content.charAt(this.current);
+		this.current += 1;
+		return currentCh;
+	}
+	match(content, expected) {
+		if (this.current >= content.length) return false;
+		if (content.charAt(this.current) !== expected) return false;
+		this.current += 1;
+		return true;
+	}
+	peek(content) {
+		if (this.current >= content.length) return void 0;
+		return content.charAt(this.current);
+	}
+	handleStep(component) {
+		const { field, content } = component;
+		let ch = this.peek(content);
+		const slashIdx = this.current - 1;
+		while (ch && this.isDigit(ch)) {
+			this.advance(content);
+			ch = this.peek(content);
+		}
+		if (ch && ch !== ",") return err("CronExpressionError", `Invalid step expression '${content}' for field '${field}'`);
+		const tokenContent = content.substring(this.start, this.current);
+		const value = content.slice(slashIdx + 1, this.current);
+		if (value.length === 0) return err("CronExpressionError", `Invalid step expression '${content}' for field '${field}'`);
+		this.addToken(tokenContent, "step", Number(value), field);
+		return ok(true);
+	}
+	handleRangeWithStep(component) {
+		const { field, content } = component;
+		let ch = this.peek(content);
+		while (ch && this.isDigit(ch)) {
+			this.advance(content);
+			ch = this.peek(content);
+		}
+		if (!ch) return err("CronExpressionError", `Invalid range expression '${content}' for field '${field}'`);
+		if (this.match(content, "/")) {
+			const [error, _] = this.handleStep(component);
+			if (error) return err(error.type, error.message);
+			return ok(true);
+		}
+		return err("CronExpressionError", `Invalid range expression '${content}' for field '${field}'`);
+	}
+	handleNumber(component) {
+		const { field, content } = component;
+		let ch = this.peek(content);
+		this.start = this.current - 1;
+		while (ch && this.isDigit(ch)) {
+			this.advance(content);
+			ch = this.peek(content);
+		}
+		if (!ch) {
+			const item = content.substring(this.start);
+			this.addToken(item, "number", Number(item), field);
+			return ok(true);
+		}
+		if (this.match(content, "-")) {
+			const [error, _] = this.handleRange(component);
+			if (error) return err(error.type, error.message);
+			return ok(true);
+		}
+		if (this.match(content, "/")) {
+			const [error, _] = this.handleStep(component);
+			if (error) return err(error.type, error.message);
+			return ok(true);
+		}
+		if (!this.isDigit(ch) && ch !== ",") return err("CronExpressionError", `Invalid number '${content}' for field '${field}'`);
+		const item = content.substring(this.start, this.current);
+		this.addToken(item, "number", Number(item), field);
+		return ok(true);
+	}
+	handleRange(component) {
+		const { field, content } = component;
+		let ch = this.peek(content);
+		if (!ch) return err("CronExpressionError", `Invalid range expression '${content}' for field '${field}'`);
+		while (ch && this.isDigit(ch)) {
+			this.advance(content);
+			ch = this.peek(content);
+		}
+		if (!ch) {
+			const tokenContent = content.substring(this.start);
+			this.addToken(tokenContent, "range", tokenContent, field);
+			return ok(true);
+		}
+		if (this.match(content, "/")) {
+			const [error, _] = this.handleStep(component);
+			if (error) return err(error.type, error.message);
+			return ok(true);
+		}
+		if (ch && ch !== ",") return err("CronExpressionError", `Invalid range expression '${content}' for field '${field}'`);
+		const tokenContent = content.substring(this.start, this.current);
+		this.addToken(tokenContent, "range", tokenContent, field);
+		return ok(true);
+	}
+	isDigit(ch) {
+		return ch >= "0" && ch <= "9";
+	}
+	createComponent(fields) {
+		const fieldNames = [
+			"second",
+			"minute",
+			"hour",
+			"day",
+			"month",
+			"weekday"
+		];
+		const components = [];
+		let offset = 1;
+		if (fields.length === FieldAmount.max) offset = 0;
+		for (let idx = 0; idx < fields.length; idx++) {
+			const fieldName = fieldNames[idx + offset];
+			const content = fields[idx];
+			if (!fieldName || !content) break;
+			components.push({
+				content,
+				field: fieldName
+			});
+		}
+		return components;
+	}
+};
+//#endregion
+export { FieldAmount, Scanner };
+
+//# sourceMappingURL=scanner.mjs.map

package/dist/cron/core/scanner.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.mjs","names":[],"sources":["../../../src/lib/cron/core/scanner.ts"],"sourcesContent":["import { err, ok } from \"../../errors/index.js\";\nimport type { CronScannerError } from \"./types.js\";\n\nexport const FieldAmount = {\n  min: 5,\n  max: 6,\n} as const;\n\ntype TokenValueType = string | number;\ntype CronFieldType = \"second\" | \"minute\" | \"hour\" | \"day\" | \"month\" | \"weekday\";\ntype ComponentType = {\n  content: string;\n  field: CronFieldType;\n};\n\ntype TokenType = \"any\" | \"range\" | \"step\" | \"number\";\n\nexport class Token {\n  private readonly type: TokenType;\n  private readonly component: string;\n  private readonly value: TokenValueType;\n\n  private readonly field: CronFieldType;\n\n  public constructor(\n    component: string,\n    type: TokenType,\n    value: TokenValueType,\n    field: CronFieldType,\n  ) {\n    this.component = component;\n    this.type = type;\n    this.value = value;\n    this.field = field;\n  }\n\n  public getComponent() {\n    return this.component;\n  }\n\n  public getTokenType() {\n    return this.type;\n  }\n\n  public getTokenValue() {\n    return this.value;\n  }\n\n  public getField() {\n    return this.field;\n  }\n\n  public toString() {\n    const header = `component=\"${this.component}\", type=${this.type}`;\n    const body = `field=\"${this.field}\", value=${this.value}`;\n\n    return `Token{${header}, ${body}}`;\n  }\n\n  public equals(other: Token) {\n    if (!other) return false;\n\n    const isComponentEqual = this.component === other.getComponent();\n    const isTokenTypeEqual = this.type === other.getTokenType();\n    const isTokenValueEqual = this.value === other.getTokenValue();\n    const isFieldEqual = this.field === other.getField();\n\n    return (\n      isComponentEqual && isTokenTypeEqual && isTokenValueEqual && isFieldEqual\n    );\n  }\n}\n\nexport class Scanner {\n  private expression: string;\n  private current: number;\n  private start: number;\n  private tokens: Token[];\n\n  public constructor(expression: string) {\n    this.expression = expression;\n    this.current = 0;\n    this.start = 0;\n    this.tokens = [];\n  }\n\n  public scan() {\n    if (this.expression.length === 0) {\n      return err<CronScannerError>(\n        \"EmptyCronExpressionError\",\n        \"Cron expression have zero length\",\n      );\n    }\n\n    const fields = this.expression.trim().split(/\\s+/);\n    const hasMinLen = fields.length === FieldAmount.min;\n    const hasMaxLen = fields.length === FieldAmount.max;\n\n    if (!hasMinLen && !hasMaxLen) {\n      return err<CronScannerError>(\n        \"CronLengthError\",\n        `Invalid number of fields for '${this.expression}'. Expected 5 or 6 fields but got ${fields.length} field(s)`,\n      );\n    }\n\n    const components = this.createComponent(fields);\n\n    for (let idx = 0; idx < components.length; idx++) {\n      const component = components[idx];\n      if (!component) {\n        return err<CronScannerError>(\n          \"CronExpressionError\",\n          `Invalid cron expression: ${this.expression}`,\n        );\n      }\n\n      this.current = 0;\n      this.start = 0;\n      const [error, _] = this.scanComponent(component);\n      if (error) return err<CronScannerError>(error.type, error.message);\n    }\n\n    return ok(this.tokens);\n  }\n\n  private scanComponent(component: ComponentType) {\n    const { field, content } = component;\n    while (this.current < content.length) {\n      let currentCh = this.advance(content);\n\n      switch (currentCh) {\n        case \"*\": {\n          const ch = this.peek(content);\n          if (this.match(content, \"/\")) {\n            const [error, _] = this.handleStep(component);\n            if (error) return err<CronScannerError>(error.type, error.message);\n          } else if (!ch || ch === \",\") {\n            this.addToken(\"*\", \"any\", \"*\", field);\n          } else {\n            return err<CronScannerError>(\n              \"CronExpressionError\",\n              `Invalid any expression '${content}' for field '${field}'`,\n            );\n          }\n\n          break;\n        }\n        case \"-\": {\n          currentCh = this.advance(content);\n          if (this.isDigit(currentCh)) {\n            const [error, _] = this.handleRangeWithStep(component);\n            if (error) return err<CronScannerError>(error.type, error.message);\n          } else {\n            return err<CronScannerError>(\n              \"CronExpressionError\",\n              `Invalid range expression '${content}' for field '${field}'`,\n            );\n          }\n          break;\n        }\n        case \",\": {\n          if (this.current === 1 && this.start === 0) {\n            return err<CronScannerError>(\n              \"CronExpressionError\",\n              `Invalid list expression '${content}' for field '${field}'`,\n            );\n          }\n\n          const next = this.peek(content);\n          if (!next || next === \",\") {\n            return err<CronScannerError>(\n              \"CronExpressionError\",\n              `Invalid list expression '${content}' for field '${field}'`,\n            );\n          }\n\n          break;\n        }\n        default: {\n          if (this.isDigit(currentCh)) {\n            const [error, _] = this.handleNumber(component);\n            if (error) return err<CronScannerError>(error.type, error.message);\n          } else {\n            return err<CronScannerError>(\n              \"CronExpressionError\",\n              `Invalid cron expression '${this.expression}' in field '${field}'`,\n            );\n          }\n\n          break;\n        }\n      }\n\n      this.start = this.current;\n    }\n\n    return ok(true);\n  }\n\n  private addToken(\n    component: string,\n    type: TokenType,\n    value: TokenValueType,\n    field: CronFieldType,\n  ) {\n    const token = new Token(component, type, value, field);\n    this.tokens.push(token);\n  }\n\n  private advance(content: string) {\n    const currentCh = content.charAt(this.current);\n    this.current += 1;\n\n    return currentCh;\n  }\n\n  private match(content: string, expected: string) {\n    if (this.current >= content.length) return false;\n    if (content.charAt(this.current) !== expected) return false;\n\n    this.current += 1;\n    return true;\n  }\n\n  private peek(content: string) {\n    if (this.current >= content.length) return undefined;\n\n    return content.charAt(this.current);\n  }\n\n  private handleStep(component: ComponentType) {\n    const { field, content } = component;\n    let ch = this.peek(content);\n    const slashIdx = this.current - 1;\n\n    while (ch && this.isDigit(ch)) {\n      this.advance(content);\n      ch = this.peek(content);\n    }\n\n    if (ch && ch !== \",\") {\n      return err<CronScannerError>(\n        \"CronExpressionError\",\n        `Invalid step expression '${content}' for field '${field}'`,\n      );\n    }\n\n    const tokenContent = content.substring(this.start, this.current);\n    const value = content.slice(slashIdx + 1, this.current);\n\n    if (value.length === 0) {\n      return err<CronScannerError>(\n        \"CronExpressionError\",\n        `Invalid step expression '${content}' for field '${field}'`,\n      );\n    }\n\n    this.addToken(tokenContent, \"step\", Number(value), field);\n    return ok(true);\n  }\n\n  private handleRangeWithStep(component: ComponentType) {\n    const { field, content } = component;\n    let ch = this.peek(content);\n\n    while (ch && this.isDigit(ch)) {\n      this.advance(content);\n      ch = this.peek(content);\n    }\n\n    if (!ch) {\n      return err<CronScannerError>(\n        \"CronExpressionError\",\n        `Invalid range expression '${content}' for field '${field}'`,\n      );\n    }\n\n    if (this.match(content, \"/\")) {\n      const [error, _] = this.handleStep(component);\n      if (error) return err<CronScannerError>(error.type, error.message);\n\n      return ok(true);\n    }\n\n    return err<CronScannerError>(\n      \"CronExpressionError\",\n      `Invalid range expression '${content}' for field '${field}'`,\n    );\n  }\n\n  private handleNumber(component: ComponentType) {\n    const { field, content } = component;\n    let ch = this.peek(content);\n    this.start = this.current - 1;\n\n    while (ch && this.isDigit(ch)) {\n      this.advance(content);\n      ch = this.peek(content);\n    }\n\n    if (!ch) {\n      // Reached the end of the component\n      const item = content.substring(this.start);\n      this.addToken(item, \"number\", Number(item), field);\n      return ok(true);\n    }\n\n    if (this.match(content, \"-\")) {\n      const [error, _] = this.handleRange(component);\n      if (error) return err<CronScannerError>(error.type, error.message);\n\n      return ok(true);\n    }\n\n    if (this.match(content, \"/\")) {\n      const [error, _] = this.handleStep(component);\n      if (error) return err<CronScannerError>(error.type, error.message);\n\n      return ok(true);\n    }\n\n    if (!this.isDigit(ch) && ch !== \",\") {\n      return err<CronScannerError>(\n        \"CronExpressionError\",\n        `Invalid number '${content}' for field '${field}'`,\n      );\n    }\n\n    const item = content.substring(this.start, this.current);\n    this.addToken(item, \"number\", Number(item), field);\n    return ok(true);\n  }\n\n  private handleRange(component: ComponentType) {\n    const { field, content } = component;\n    let ch = this.peek(content);\n\n    if (!ch) {\n      return err<CronScannerError>(\n        \"CronExpressionError\",\n        `Invalid range expression '${content}' for field '${field}'`,\n      );\n    }\n\n    while (ch && this.isDigit(ch)) {\n      this.advance(content);\n      ch = this.peek(content);\n    }\n\n    if (!ch) {\n      // Reached the end of the component\n      const tokenContent = content.substring(this.start);\n      this.addToken(tokenContent, \"range\", tokenContent, field);\n\n      return ok(true);\n    }\n\n    if (this.match(content, \"/\")) {\n      const [error, _] = this.handleStep(component);\n      if (error) return err<CronScannerError>(error.type, error.message);\n\n      return ok(true);\n    }\n\n    if (ch && ch !== \",\") {\n      return err<CronScannerError>(\n        \"CronExpressionError\",\n        `Invalid range expression '${content}' for field '${field}'`,\n      );\n    }\n\n    const tokenContent = content.substring(this.start, this.current);\n    this.addToken(tokenContent, \"range\", tokenContent, field);\n    return ok(true);\n  }\n\n  private isDigit(ch: string) {\n    return ch >= \"0\" && ch <= \"9\";\n  }\n\n  private createComponent(fields: string[]) {\n    const fieldNames = [\n      \"second\",\n      \"minute\",\n      \"hour\",\n      \"day\",\n      \"month\",\n      \"weekday\",\n    ] as const;\n    const components = [];\n    let offset = 1;\n    if (fields.length === FieldAmount.max) offset = 0;\n\n    for (let idx = 0; idx < fields.length; idx++) {\n      const fieldName = fieldNames[idx + offset];\n      const content = fields[idx];\n      if (!fieldName || !content) break;\n\n      components.push({ content, field: fieldName });\n    }\n\n    return components;\n  }\n}\n"],"mappings":";;AAGA,MAAa,cAAc;CACzB,KAAK;CACL,KAAK;CACN;AAWD,IAAa,QAAb,MAAmB;CACjB;CACA;CACA;CAEA;CAEA,YACE,WACA,MACA,OACA,OACA;AACA,OAAK,YAAY;AACjB,OAAK,OAAO;AACZ,OAAK,QAAQ;AACb,OAAK,QAAQ;;CAGf,eAAsB;AACpB,SAAO,KAAK;;CAGd,eAAsB;AACpB,SAAO,KAAK;;CAGd,gBAAuB;AACrB,SAAO,KAAK;;CAGd,WAAkB;AAChB,SAAO,KAAK;;CAGd,WAAkB;AAIhB,SAAO,SAHQ,cAAc,KAAK,UAAU,UAAU,KAAK,OAGpC,IAFV,UAAU,KAAK,MAAM,WAAW,KAAK,QAElB;;CAGlC,OAAc,OAAc;AAC1B,MAAI,CAAC,MAAO,QAAO;EAEnB,MAAM,mBAAmB,KAAK,cAAc,MAAM,cAAc;EAChE,MAAM,mBAAmB,KAAK,SAAS,MAAM,cAAc;EAC3D,MAAM,oBAAoB,KAAK,UAAU,MAAM,eAAe;EAC9D,MAAM,eAAe,KAAK,UAAU,MAAM,UAAU;AAEpD,SACE,oBAAoB,oBAAoB,qBAAqB;;;AAKnE,IAAa,UAAb,MAAqB;CACnB;CACA;CACA;CACA;CAEA,YAAmB,YAAoB;AACrC,OAAK,aAAa;AAClB,OAAK,UAAU;AACf,OAAK,QAAQ;AACb,OAAK,SAAS,EAAE;;CAGlB,OAAc;AACZ,MAAI,KAAK,WAAW,WAAW,EAC7B,QAAO,IACL,4BACA,mCACD;EAGH,MAAM,SAAS,KAAK,WAAW,MAAM,CAAC,MAAM,MAAM;EAClD,MAAM,YAAY,OAAO,WAAW,YAAY;EAChD,MAAM,YAAY,OAAO,WAAW,YAAY;AAEhD,MAAI,CAAC,aAAa,CAAC,UACjB,QAAO,IACL,mBACA,iCAAiC,KAAK,WAAW,oCAAoC,OAAO,OAAO,WACpG;EAGH,MAAM,aAAa,KAAK,gBAAgB,OAAO;AAE/C,OAAK,IAAI,MAAM,GAAG,MAAM,WAAW,QAAQ,OAAO;GAChD,MAAM,YAAY,WAAW;AAC7B,OAAI,CAAC,UACH,QAAO,IACL,uBACA,4BAA4B,KAAK,aAClC;AAGH,QAAK,UAAU;AACf,QAAK,QAAQ;GACb,MAAM,CAAC,OAAO,KAAK,KAAK,cAAc,UAAU;AAChD,OAAI,MAAO,QAAO,IAAsB,MAAM,MAAM,MAAM,QAAQ;;AAGpE,SAAO,GAAG,KAAK,OAAO;;CAGxB,cAAsB,WAA0B;EAC9C,MAAM,EAAE,OAAO,YAAY;AAC3B,SAAO,KAAK,UAAU,QAAQ,QAAQ;GACpC,IAAI,YAAY,KAAK,QAAQ,QAAQ;AAErC,WAAQ,WAAR;IACE,KAAK,KAAK;KACR,MAAM,KAAK,KAAK,KAAK,QAAQ;AAC7B,SAAI,KAAK,MAAM,SAAS,IAAI,EAAE;MAC5B,MAAM,CAAC,OAAO,KAAK,KAAK,WAAW,UAAU;AAC7C,UAAI,MAAO,QAAO,IAAsB,MAAM,MAAM,MAAM,QAAQ;gBACzD,CAAC,MAAM,OAAO,IACvB,MAAK,SAAS,KAAK,OAAO,KAAK,MAAM;SAErC,QAAO,IACL,uBACA,2BAA2B,QAAQ,eAAe,MAAM,GACzD;AAGH;;IAEF,KAAK;AACH,iBAAY,KAAK,QAAQ,QAAQ;AACjC,SAAI,KAAK,QAAQ,UAAU,EAAE;MAC3B,MAAM,CAAC,OAAO,KAAK,KAAK,oBAAoB,UAAU;AACtD,UAAI,MAAO,QAAO,IAAsB,MAAM,MAAM,MAAM,QAAQ;WAElE,QAAO,IACL,uBACA,6BAA6B,QAAQ,eAAe,MAAM,GAC3D;AAEH;IAEF,KAAK,KAAK;AACR,SAAI,KAAK,YAAY,KAAK,KAAK,UAAU,EACvC,QAAO,IACL,uBACA,4BAA4B,QAAQ,eAAe,MAAM,GAC1D;KAGH,MAAM,OAAO,KAAK,KAAK,QAAQ;AAC/B,SAAI,CAAC,QAAQ,SAAS,IACpB,QAAO,IACL,uBACA,4BAA4B,QAAQ,eAAe,MAAM,GAC1D;AAGH;;IAEF;AACE,SAAI,KAAK,QAAQ,UAAU,EAAE;MAC3B,MAAM,CAAC,OAAO,KAAK,KAAK,aAAa,UAAU;AAC/C,UAAI,MAAO,QAAO,IAAsB,MAAM,MAAM,MAAM,QAAQ;WAElE,QAAO,IACL,uBACA,4BAA4B,KAAK,WAAW,cAAc,MAAM,GACjE;AAGH;;AAIJ,QAAK,QAAQ,KAAK;;AAGpB,SAAO,GAAG,KAAK;;CAGjB,SACE,WACA,MACA,OACA,OACA;EACA,MAAM,QAAQ,IAAI,MAAM,WAAW,MAAM,OAAO,MAAM;AACtD,OAAK,OAAO,KAAK,MAAM;;CAGzB,QAAgB,SAAiB;EAC/B,MAAM,YAAY,QAAQ,OAAO,KAAK,QAAQ;AAC9C,OAAK,WAAW;AAEhB,SAAO;;CAGT,MAAc,SAAiB,UAAkB;AAC/C,MAAI,KAAK,WAAW,QAAQ,OAAQ,QAAO;AAC3C,MAAI,QAAQ,OAAO,KAAK,QAAQ,KAAK,SAAU,QAAO;AAEtD,OAAK,WAAW;AAChB,SAAO;;CAGT,KAAa,SAAiB;AAC5B,MAAI,KAAK,WAAW,QAAQ,OAAQ,QAAO,KAAA;AAE3C,SAAO,QAAQ,OAAO,KAAK,QAAQ;;CAGrC,WAAmB,WAA0B;EAC3C,MAAM,EAAE,OAAO,YAAY;EAC3B,IAAI,KAAK,KAAK,KAAK,QAAQ;EAC3B,MAAM,WAAW,KAAK,UAAU;AAEhC,SAAO,MAAM,KAAK,QAAQ,GAAG,EAAE;AAC7B,QAAK,QAAQ,QAAQ;AACrB,QAAK,KAAK,KAAK,QAAQ;;AAGzB,MAAI,MAAM,OAAO,IACf,QAAO,IACL,uBACA,4BAA4B,QAAQ,eAAe,MAAM,GAC1D;EAGH,MAAM,eAAe,QAAQ,UAAU,KAAK,OAAO,KAAK,QAAQ;EAChE,MAAM,QAAQ,QAAQ,MAAM,WAAW,GAAG,KAAK,QAAQ;AAEvD,MAAI,MAAM,WAAW,EACnB,QAAO,IACL,uBACA,4BAA4B,QAAQ,eAAe,MAAM,GAC1D;AAGH,OAAK,SAAS,cAAc,QAAQ,OAAO,MAAM,EAAE,MAAM;AACzD,SAAO,GAAG,KAAK;;CAGjB,oBAA4B,WAA0B;EACpD,MAAM,EAAE,OAAO,YAAY;EAC3B,IAAI,KAAK,KAAK,KAAK,QAAQ;AAE3B,SAAO,MAAM,KAAK,QAAQ,GAAG,EAAE;AAC7B,QAAK,QAAQ,QAAQ;AACrB,QAAK,KAAK,KAAK,QAAQ;;AAGzB,MAAI,CAAC,GACH,QAAO,IACL,uBACA,6BAA6B,QAAQ,eAAe,MAAM,GAC3D;AAGH,MAAI,KAAK,MAAM,SAAS,IAAI,EAAE;GAC5B,MAAM,CAAC,OAAO,KAAK,KAAK,WAAW,UAAU;AAC7C,OAAI,MAAO,QAAO,IAAsB,MAAM,MAAM,MAAM,QAAQ;AAElE,UAAO,GAAG,KAAK;;AAGjB,SAAO,IACL,uBACA,6BAA6B,QAAQ,eAAe,MAAM,GAC3D;;CAGH,aAAqB,WAA0B;EAC7C,MAAM,EAAE,OAAO,YAAY;EAC3B,IAAI,KAAK,KAAK,KAAK,QAAQ;AAC3B,OAAK,QAAQ,KAAK,UAAU;AAE5B,SAAO,MAAM,KAAK,QAAQ,GAAG,EAAE;AAC7B,QAAK,QAAQ,QAAQ;AACrB,QAAK,KAAK,KAAK,QAAQ;;AAGzB,MAAI,CAAC,IAAI;GAEP,MAAM,OAAO,QAAQ,UAAU,KAAK,MAAM;AAC1C,QAAK,SAAS,MAAM,UAAU,OAAO,KAAK,EAAE,MAAM;AAClD,UAAO,GAAG,KAAK;;AAGjB,MAAI,KAAK,MAAM,SAAS,IAAI,EAAE;GAC5B,MAAM,CAAC,OAAO,KAAK,KAAK,YAAY,UAAU;AAC9C,OAAI,MAAO,QAAO,IAAsB,MAAM,MAAM,MAAM,QAAQ;AAElE,UAAO,GAAG,KAAK;;AAGjB,MAAI,KAAK,MAAM,SAAS,IAAI,EAAE;GAC5B,MAAM,CAAC,OAAO,KAAK,KAAK,WAAW,UAAU;AAC7C,OAAI,MAAO,QAAO,IAAsB,MAAM,MAAM,MAAM,QAAQ;AAElE,UAAO,GAAG,KAAK;;AAGjB,MAAI,CAAC,KAAK,QAAQ,GAAG,IAAI,OAAO,IAC9B,QAAO,IACL,uBACA,mBAAmB,QAAQ,eAAe,MAAM,GACjD;EAGH,MAAM,OAAO,QAAQ,UAAU,KAAK,OAAO,KAAK,QAAQ;AACxD,OAAK,SAAS,MAAM,UAAU,OAAO,KAAK,EAAE,MAAM;AAClD,SAAO,GAAG,KAAK;;CAGjB,YAAoB,WAA0B;EAC5C,MAAM,EAAE,OAAO,YAAY;EAC3B,IAAI,KAAK,KAAK,KAAK,QAAQ;AAE3B,MAAI,CAAC,GACH,QAAO,IACL,uBACA,6BAA6B,QAAQ,eAAe,MAAM,GAC3D;AAGH,SAAO,MAAM,KAAK,QAAQ,GAAG,EAAE;AAC7B,QAAK,QAAQ,QAAQ;AACrB,QAAK,KAAK,KAAK,QAAQ;;AAGzB,MAAI,CAAC,IAAI;GAEP,MAAM,eAAe,QAAQ,UAAU,KAAK,MAAM;AAClD,QAAK,SAAS,cAAc,SAAS,cAAc,MAAM;AAEzD,UAAO,GAAG,KAAK;;AAGjB,MAAI,KAAK,MAAM,SAAS,IAAI,EAAE;GAC5B,MAAM,CAAC,OAAO,KAAK,KAAK,WAAW,UAAU;AAC7C,OAAI,MAAO,QAAO,IAAsB,MAAM,MAAM,MAAM,QAAQ;AAElE,UAAO,GAAG,KAAK;;AAGjB,MAAI,MAAM,OAAO,IACf,QAAO,IACL,uBACA,6BAA6B,QAAQ,eAAe,MAAM,GAC3D;EAGH,MAAM,eAAe,QAAQ,UAAU,KAAK,OAAO,KAAK,QAAQ;AAChE,OAAK,SAAS,cAAc,SAAS,cAAc,MAAM;AACzD,SAAO,GAAG,KAAK;;CAGjB,QAAgB,IAAY;AAC1B,SAAO,MAAM,OAAO,MAAM;;CAG5B,gBAAwB,QAAkB;EACxC,MAAM,aAAa;GACjB;GACA;GACA;GACA;GACA;GACA;GACD;EACD,MAAM,aAAa,EAAE;EACrB,IAAI,SAAS;AACb,MAAI,OAAO,WAAW,YAAY,IAAK,UAAS;AAEhD,OAAK,IAAI,MAAM,GAAG,MAAM,OAAO,QAAQ,OAAO;GAC5C,MAAM,YAAY,WAAW,MAAM;GACnC,MAAM,UAAU,OAAO;AACvB,OAAI,CAAC,aAAa,CAAC,QAAS;AAE5B,cAAW,KAAK;IAAE;IAAS,OAAO;IAAW,CAAC;;AAGhD,SAAO"}

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

@@ -0,0 +1,11 @@
+//#region src/lib/cron/core/types.d.ts
+type CronAlias = "@yearly" | "@monthly" | "@weekly" | "@daily" | "@hourly" | "@minutely";
+type CronStatus = "idle" | "running" | "paused";
+type CronOptions = {
+  name: string;
+  schedule: CronAlias | (string & {});
+  handler: () => void | Promise<void>;
+};
+//#endregion
+export { CronOptions, CronStatus };
+//# sourceMappingURL=types.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.cts","names":[],"sources":["../../../src/lib/cron/core/types.ts"],"mappings":";KAAY,SAAA;AAAA,KAQA,UAAA;AAAA,KASA,WAAA;EACV,IAAA;EACA,QAAA,EAAU,SAAA;EACV,OAAA,eAAsB,OAAA;AAAA"}

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

@@ -0,0 +1,11 @@
+//#region src/lib/cron/core/types.d.ts
+type CronAlias = "@yearly" | "@monthly" | "@weekly" | "@daily" | "@hourly" | "@minutely";
+type CronStatus = "idle" | "running" | "paused";
+type CronOptions = {
+  name: string;
+  schedule: CronAlias | (string & {});
+  handler: () => void | Promise<void>;
+};
+//#endregion
+export { CronOptions, CronStatus };
+//# sourceMappingURL=types.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../src/lib/cron/core/types.ts"],"mappings":";KAAY,SAAA;AAAA,KAQA,UAAA;AAAA,KASA,WAAA;EACV,IAAA;EACA,QAAA,EAAU,SAAA;EACV,OAAA,eAAsB,OAAA;AAAA"}

package/dist/errors/types.d.cts

@@ -0,0 +1,5 @@
+//#region src/lib/errors/types.d.ts
+type CommonError = "NotFoundError" | "UnauthorizedError" | "InternalServerError" | "ValidationError" | "MigrationError" | "SchemaError" | (string & {});
+//#endregion
+export { CommonError };
+//# sourceMappingURL=types.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.cts","names":[],"sources":["../../src/lib/errors/types.ts"],"mappings":";KAAY,WAAA"}

package/dist/errors/types.d.mts

@@ -0,0 +1,5 @@
+//#region src/lib/errors/types.d.ts
+type CommonError = "NotFoundError" | "UnauthorizedError" | "InternalServerError" | "ValidationError" | "MigrationError" | "SchemaError" | (string & {});
+//#endregion
+export { CommonError };
+//# sourceMappingURL=types.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../src/lib/errors/types.ts"],"mappings":";KAAY,WAAA"}

package/dist/i18n/types.d.cts

@@ -0,0 +1,13 @@
+//#region src/lib/i18n/types.d.ts
+type ExtractParamType<T extends string> = T extends "string" ? string : T extends "number" ? number : T extends "boolean" ? boolean : never;
+type BuildParamObject<T extends string, Acc = {}> = T extends `${infer _Start}{${infer Name}:${infer Type}}${infer Rest}` ? BuildParamObject<Rest, Acc & Record<Name, ExtractParamType<Type>>> : Acc;
+type IsString<T> = T extends string ? true : false;
+type IsArray<T> = T extends readonly unknown[] ? true : false;
+type IsObject<T> = T extends object ? T extends readonly unknown[] ? false : true : false;
+type ArrayKeys<T extends readonly unknown[]> = { [K in keyof T & `${number}`]: `${K}` }[keyof T & `${number}`];
+type ObjectPropertyKeys<K extends string, V> = IsString<V> extends true ? K : IsArray<V> extends true ? V extends readonly unknown[] ? `${K}.${NestedKeyOf<V>}` : never : IsObject<V> extends true ? `${K}.${NestedKeyOf<V>}` : never;
+type NestedKeyOf<T> = IsArray<T> extends true ? T extends readonly unknown[] ? ArrayKeys<T> : never : IsObject<T> extends true ? { [K in keyof T & string]: ObjectPropertyKeys<K, T[K]> }[keyof T & string] : never;
+type GetNestedValue<T, K extends string> = K extends `${infer First}.${infer Rest}` ? First extends keyof T ? GetNestedValue<T[First], Rest> : never : K extends keyof T ? T[K] : never;
+//#endregion
+export { BuildParamObject, GetNestedValue, NestedKeyOf };
+//# sourceMappingURL=types.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.cts","names":[],"sources":["../../src/lib/i18n/types.ts"],"mappings":";KACY,gBAAA,qBAAqC,CAAA,6BAE7C,CAAA,6BAEE,CAAA;AAAA,KAIM,gBAAA,+BAGR,CAAA,uEACA,gBAAA,CAAiB,IAAA,EAAM,GAAA,GAAM,MAAA,CAAO,IAAA,EAAM,gBAAA,CAAiB,IAAA,MAC3D,GAAA;AAAA,KAGC,QAAA,MAAc,CAAA;AAAA,KACd,OAAA,MAAa,CAAA;AAAA,KACb,QAAA,MAAc,CAAA,kBACf,CAAA;AAAA,KAMC,SAAA,+CACS,CAAA,oBAAqB,CAAA,WAC3B,CAAA;AAAA,KAGH,kBAAA,wBAA0C,QAAA,CAAS,CAAA,iBACpD,CAAA,GACA,OAAA,CAAQ,CAAA,iBACN,CAAA,iCACK,CAAA,IAAK,WAAA,CAAY,CAAA,cAEtB,QAAA,CAAS,CAAA,oBACJ,CAAA,IAAK,WAAA,CAAY,CAAA;AAAA,KAIhB,WAAA,MACV,OAAA,CAAQ,CAAA,iBACJ,CAAA,8BACE,SAAA,CAAU,CAAA,YAEZ,QAAA,CAAS,CAAA,+BAEO,CAAA,YAAa,kBAAA,CAAmB,CAAA,EAAG,CAAA,CAAE,CAAA,WAC3C,CAAA;AAAA,KAIJ,cAAA,wBAGR,CAAA,0CACA,KAAA,eAAoB,CAAA,GAClB,cAAA,CAAe,CAAA,CAAE,KAAA,GAAQ,IAAA,YAE3B,CAAA,eAAgB,CAAA,GACd,CAAA,CAAE,CAAA"}

package/dist/i18n/types.d.mts

@@ -0,0 +1,13 @@
+//#region src/lib/i18n/types.d.ts
+type ExtractParamType<T extends string> = T extends "string" ? string : T extends "number" ? number : T extends "boolean" ? boolean : never;
+type BuildParamObject<T extends string, Acc = {}> = T extends `${infer _Start}{${infer Name}:${infer Type}}${infer Rest}` ? BuildParamObject<Rest, Acc & Record<Name, ExtractParamType<Type>>> : Acc;
+type IsString<T> = T extends string ? true : false;
+type IsArray<T> = T extends readonly unknown[] ? true : false;
+type IsObject<T> = T extends object ? T extends readonly unknown[] ? false : true : false;
+type ArrayKeys<T extends readonly unknown[]> = { [K in keyof T & `${number}`]: `${K}` }[keyof T & `${number}`];
+type ObjectPropertyKeys<K extends string, V> = IsString<V> extends true ? K : IsArray<V> extends true ? V extends readonly unknown[] ? `${K}.${NestedKeyOf<V>}` : never : IsObject<V> extends true ? `${K}.${NestedKeyOf<V>}` : never;
+type NestedKeyOf<T> = IsArray<T> extends true ? T extends readonly unknown[] ? ArrayKeys<T> : never : IsObject<T> extends true ? { [K in keyof T & string]: ObjectPropertyKeys<K, T[K]> }[keyof T & string] : never;
+type GetNestedValue<T, K extends string> = K extends `${infer First}.${infer Rest}` ? First extends keyof T ? GetNestedValue<T[First], Rest> : never : K extends keyof T ? T[K] : never;
+//#endregion
+export { BuildParamObject, GetNestedValue, NestedKeyOf };
+//# sourceMappingURL=types.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../src/lib/i18n/types.ts"],"mappings":";KACY,gBAAA,qBAAqC,CAAA,6BAE7C,CAAA,6BAEE,CAAA;AAAA,KAIM,gBAAA,+BAGR,CAAA,uEACA,gBAAA,CAAiB,IAAA,EAAM,GAAA,GAAM,MAAA,CAAO,IAAA,EAAM,gBAAA,CAAiB,IAAA,MAC3D,GAAA;AAAA,KAGC,QAAA,MAAc,CAAA;AAAA,KACd,OAAA,MAAa,CAAA;AAAA,KACb,QAAA,MAAc,CAAA,kBACf,CAAA;AAAA,KAMC,SAAA,+CACS,CAAA,oBAAqB,CAAA,WAC3B,CAAA;AAAA,KAGH,kBAAA,wBAA0C,QAAA,CAAS,CAAA,iBACpD,CAAA,GACA,OAAA,CAAQ,CAAA,iBACN,CAAA,iCACK,CAAA,IAAK,WAAA,CAAY,CAAA,cAEtB,QAAA,CAAS,CAAA,oBACJ,CAAA,IAAK,WAAA,CAAY,CAAA;AAAA,KAIhB,WAAA,MACV,OAAA,CAAQ,CAAA,iBACJ,CAAA,8BACE,SAAA,CAAU,CAAA,YAEZ,QAAA,CAAS,CAAA,+BAEO,CAAA,YAAa,kBAAA,CAAmB,CAAA,EAAG,CAAA,CAAE,CAAA,WAC3C,CAAA;AAAA,KAIJ,cAAA,wBAGR,CAAA,0CACA,KAAA,eAAoB,CAAA,GAClB,cAAA,CAAe,CAAA,CAAE,KAAA,GAAQ,IAAA,YAE3B,CAAA,eAAgB,CAAA,GACd,CAAA,CAAE,CAAA"}

package/dist/lib/api/index.cjs

@@ -0,0 +1,5 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_index = require("../../api/core/index.cjs");
+const require_index$1 = require("../../api/middleware/index.cjs");
+exports.Api = require_index.Api;
+exports.Middleware = require_index$1.Middleware;

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

@@ -0,0 +1,5 @@
+import { InferMiddlewareExtension, MergeMiddlewareExtensions, MiddlewareHandler, MiddlewareOptions } from "../../api/middleware/types.cjs";
+import { ApiOptions, Context, ExtractStatusCodes, InferInput, InferOutput, OpenApiOptions, RequestSchema, ResponseSchema, RouteConfig, RouteHandler, SecurityScheme, SecuritySchemeApiKey, SecuritySchemeHttp, SecuritySchemeOAuth2, SecuritySchemeOAuth2Flow, SecuritySchemeOpenIdConnect } from "../../api/core/types.cjs";
+import { Middleware } from "../../api/middleware/index.cjs";
+import { Api } from "../../api/core/index.cjs";
+export { Api, type ApiOptions, type Context, type ExtractStatusCodes, type InferInput, type InferMiddlewareExtension, type InferOutput, type MergeMiddlewareExtensions, Middleware, type MiddlewareHandler, type MiddlewareOptions, type OpenApiOptions, type RequestSchema, type ResponseSchema, type RouteConfig, type RouteHandler, type SecurityScheme, type SecuritySchemeApiKey, type SecuritySchemeHttp, type SecuritySchemeOAuth2, type SecuritySchemeOAuth2Flow, type SecuritySchemeOpenIdConnect };

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

@@ -0,0 +1,5 @@
+import { InferMiddlewareExtension, MergeMiddlewareExtensions, MiddlewareHandler, MiddlewareOptions } from "../../api/middleware/types.mjs";
+import { ApiOptions, Context, ExtractStatusCodes, InferInput, InferOutput, OpenApiOptions, RequestSchema, ResponseSchema, RouteConfig, RouteHandler, SecurityScheme, SecuritySchemeApiKey, SecuritySchemeHttp, SecuritySchemeOAuth2, SecuritySchemeOAuth2Flow, SecuritySchemeOpenIdConnect } from "../../api/core/types.mjs";
+import { Middleware } from "../../api/middleware/index.mjs";
+import { Api } from "../../api/core/index.mjs";
+export { Api, type ApiOptions, type Context, type ExtractStatusCodes, type InferInput, type InferMiddlewareExtension, type InferOutput, type MergeMiddlewareExtensions, Middleware, type MiddlewareHandler, type MiddlewareOptions, type OpenApiOptions, type RequestSchema, type ResponseSchema, type RouteConfig, type RouteHandler, type SecurityScheme, type SecuritySchemeApiKey, type SecuritySchemeHttp, type SecuritySchemeOAuth2, type SecuritySchemeOAuth2Flow, type SecuritySchemeOpenIdConnect };

package/dist/lib/api/index.mjs

@@ -0,0 +1,3 @@
+import { Api } from "../../api/core/index.mjs";
+import { Middleware } from "../../api/middleware/index.mjs";
+export { Api, Middleware };

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]>;
+  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 [null, number] | readonly [{
+    readonly type: "CacheError";
+    readonly message: string;
+  }, 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]>;
+  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 [null, number] | readonly [{
+    readonly type: "CacheError";
+    readonly message: string;
+  }, 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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"}