@warlock.js/core 5.19.1 → 5.21.0

package/esm/repositories/adapters/cascade/filter-applicator.mjs

@@ -1,4 +1,9 @@
+import { BadRequestError } from "../../../http/errors/errors.mjs";
+import dayjs from "dayjs";
+import customParseFormat from "dayjs/plugin/customParseFormat.js";
+
 //#region ../core/src/repositories/adapters/cascade/filter-applicator.ts
+dayjs.extend(customParseFormat);
 /**
 * Applies repository filters to a Cascade-Next query builder
 * Translates repository filter rules into Cascade query builder method calls
@@ -118,6 +123,31 @@ var FilterApplicator = class {
 		}[type];
 	}
 	/**
+	* `like` is a contains match on every driver: a value without an explicit
+	* `%` is wrapped as `%value%` (Postgres would otherwise match exactly while
+	* Mongo matched a substring). Values carrying their own `%` are kept as-is.
+	*/
+	likePattern(value) {
+		if (typeof value !== "string" || value.includes("%")) return value;
+		return `%${value}%`;
+	}
+	/**
+	* Coerce a client value to an integer or reject with a 400.
+	*/
+	toInt(value) {
+		const parsed = parseInt(value);
+		if (Number.isNaN(parsed)) throw new BadRequestError(`Invalid integer filter value "${value}"`);
+		return parsed;
+	}
+	/**
+	* Coerce a client value to a number or reject with a 400.
+	*/
+	toNumber(value) {
+		const parsed = Number(value);
+		if (value === "" || value === null || Number.isNaN(parsed)) throw new BadRequestError(`Invalid number filter value "${value}"`);
+		return parsed;
+	}
+	/**
 	* Apply standard where operators
 	*/
 	applyWhereOperator(query, operator, column, columns, value, ruleName) {
@@ -143,7 +173,13 @@ var FilterApplicator = class {
 				query.whereNotIn(column, Array.isArray(value) ? value : [value]);
 				break;
 			case "like":
-				query.whereLike(column, value);
+				query.whereLike(column, this.likePattern(value));
+				break;
+			case "startsWith":
+				query.whereLike(column, `${value}%`);
+				break;
+			case "endsWith":
+				query.whereLike(column, `%${value}`);
 				break;
 			case "not like":
 				query.whereNotLike(column, value);
@@ -155,17 +191,24 @@ var FilterApplicator = class {
 				query.whereNotBetween(column, value);
 				break;
 		}
-		else if (columns) if (operator === "=") {
-			const conditions = {};
-			for (const col of columns) conditions[col] = value;
-			query.orWhere(conditions);
-		} else if (operator === "like") query.orWhere((sub) => {
+		else if (columns) if (operator === "=") this.anyOf(query, columns, (q, col) => q.where(col, value));
+		else if (operator === "like") this.anyOf(query, columns, (q, col) => q.where(col, "like", this.likePattern(value)));
+		else throw new Error(`Unsupported multi-column filter operator "${operator}" for rule "${ruleName ?? columns.join(",")}". Multi-column filters only support "=" and "like".`);
+	}
+	/**
+	* Apply a condition across several columns as ONE grouped OR: `(a OR b OR ...)`.
+	* The group is ANDed with the rest of the query, so a tenant filter
+	* (`org_id = 5`) can never be widened by a multi-column search. Never emit a
+	* top-level `orWhere` for multi-column filters.
+	*/
+	anyOf(query, columns, apply) {
+		query.where((group) => {
 			columns.forEach((col, index) => {
-				if (index === 0) sub.where(col, "like", value);
-				else sub.orWhere(col, "like", value);
+				const build = (q) => apply(q, col);
+				if (index === 0) group.where(build);
+				else group.orWhere(build);
 			});
 		});
-		else throw new Error(`Unsupported multi-column filter operator "${operator}" for rule "${ruleName ?? columns.join(",")}". Multi-column filters only support "=" and "like".`);
 	}
 	/**
 	* Coerce a filter value to a boolean.
@@ -186,66 +229,50 @@ var FilterApplicator = class {
 	handleBoolean(query, column, columns, value) {
 		const boolValue = this.coerceBoolean(value);
 		if (column) query.where(column, boolValue);
-		else if (columns) {
-			const conditions = {};
-			for (const col of columns) conditions[col] = boolValue;
-			query.orWhere(conditions);
-		}
+		else if (columns) this.anyOf(query, columns, (q, col) => q.where(col, boolValue));
 	}
 	handleInt(query, column, columns, value) {
-		const intValue = parseInt(value);
+		const intValue = this.toInt(value);
 		if (column) query.where(column, intValue);
-		else if (columns) {
-			const conditions = {};
-			for (const col of columns) conditions[col] = intValue;
-			query.orWhere(conditions);
-		}
+		else if (columns) this.anyOf(query, columns, (q, col) => q.where(col, intValue));
 	}
 	handleNotInt(query, column, columns, value) {
-		const intValue = parseInt(value);
+		const intValue = this.toInt(value);
 		if (column) query.where(column, "!=", intValue);
-		else if (columns) for (const col of columns) query.orWhere(col, "!=", intValue);
+		else if (columns) this.anyOf(query, columns, (q, col) => q.where(col, "!=", intValue));
 	}
 	handleIntComparison(query, column, columns, value, operator) {
-		const intValue = parseInt(value);
+		const intValue = this.toInt(value);
 		if (column) query.where(column, operator, intValue);
-		else if (columns) for (const col of columns) query.orWhere(col, operator, intValue);
+		else if (columns) this.anyOf(query, columns, (q, col) => q.where(col, operator, intValue));
 	}
 	handleInInt(query, column, columns, value) {
-		const values = (Array.isArray(value) ? value : [value]).map((v) => parseInt(v));
+		const values = (Array.isArray(value) ? value : [value]).map((v) => this.toInt(v));
 		if (column) query.whereIn(column, values);
-		else if (columns) for (const col of columns) query.orWhere((q) => q.whereIn(col, values));
+		else if (columns) this.anyOf(query, columns, (q, col) => q.whereIn(col, values));
 	}
 	handleNumber(query, column, columns, value) {
-		const numValue = Number(value);
+		const numValue = this.toNumber(value);
 		if (column) query.where(column, numValue);
-		else if (columns) {
-			const conditions = {};
-			for (const col of columns) conditions[col] = numValue;
-			query.orWhere(conditions);
-		}
+		else if (columns) this.anyOf(query, columns, (q, col) => q.where(col, numValue));
 	}
 	handleInNumber(query, column, columns, value) {
-		const values = (Array.isArray(value) ? value : [value]).map((v) => Number(v));
+		const values = (Array.isArray(value) ? value : [value]).map((v) => this.toNumber(v));
 		if (column) query.whereIn(column, values);
-		else if (columns) for (const col of columns) query.orWhere((q) => q.whereIn(col, values));
+		else if (columns) this.anyOf(query, columns, (q, col) => q.whereIn(col, values));
 	}
 	handleFloat(query, column, columns, value) {
 		const floatValue = parseFloat(value);
 		if (column) query.where(column, floatValue);
-		else if (columns) {
-			const conditions = {};
-			for (const col of columns) conditions[col] = floatValue;
-			query.orWhere(conditions);
-		}
+		else if (columns) this.anyOf(query, columns, (q, col) => q.where(col, floatValue));
 	}
 	handleNull(query, column, columns) {
 		if (column) query.whereNull(column);
-		else if (columns) for (const col of columns) query.orWhere({ [col]: null });
+		else if (columns) this.anyOf(query, columns, (q, col) => q.whereNull(col));
 	}
 	handleNotNull(query, column, columns) {
 		if (column) query.whereNotNull(column);
-		else if (columns) for (const col of columns) query.orWhere((q) => q.whereNotNull(col));
+		else if (columns) this.anyOf(query, columns, (q, col) => q.whereNotNull(col));
 	}
 	/**
 	* Handle scope filter - applies local scope and passes the filter value.
@@ -339,67 +366,67 @@ var FilterApplicator = class {
 	handleDate(query, column, columns, value, options) {
 		const dateValue = this.parseDate(value, options?.dateFormat);
 		if (column) query.whereDate(column, dateValue);
-		else if (columns) for (const col of columns) query.orWhere((q) => q.whereDate(col, dateValue));
+		else if (columns) this.anyOf(query, columns, (q, col) => q.whereDate(col, dateValue));
 	}
 	handleDateComparison(query, column, columns, value, options, operator) {
 		const dateValue = this.parseDate(value, options?.dateFormat);
 		if (column) if (operator === ">" || operator === ">=") query.whereDateAfter(column, dateValue);
 		else query.whereDateBefore(column, dateValue);
-		else if (columns) for (const col of columns) if (operator === ">" || operator === ">=") query.orWhere((q) => q.whereDateAfter(col, dateValue));
-		else query.orWhere((q) => q.whereDateBefore(col, dateValue));
+		else if (columns) {
+			const after = operator === ">" || operator === ">=";
+			this.anyOf(query, columns, (q, col) => after ? q.whereDateAfter(col, dateValue) : q.whereDateBefore(col, dateValue));
+		}
 	}
 	handleDateBetween(query, column, columns, value, options) {
 		if (!Array.isArray(value) || value.length !== 2) return;
 		const [start, end] = value.map((v) => this.parseDate(v, options?.dateFormat));
 		if (start === void 0 || end === void 0) return;
 		if (column) query.whereDateBetween(column, [start, end]);
-		else if (columns) for (const col of columns) query.orWhere((q) => q.whereDateBetween(col, [start, end]));
+		else if (columns) this.anyOf(query, columns, (q, col) => q.whereDateBetween(col, [start, end]));
 	}
 	handleInDate(query, column, columns, value, options) {
 		const dates = (Array.isArray(value) ? value : [value]).map((v) => this.parseDate(v, options?.dateFormat));
 		if (column) query.whereIn(column, dates);
-		else if (columns) for (const col of columns) query.orWhere((q) => q.whereIn(col, dates));
+		else if (columns) this.anyOf(query, columns, (q, col) => q.whereIn(col, dates));
 	}
 	handleDateTime(query, column, columns, value, options) {
 		const dateValue = this.parseDateTime(value, options?.dateTimeFormat);
 		if (column) query.where(column, dateValue);
-		else if (columns) {
-			const conditions = {};
-			for (const col of columns) conditions[col] = dateValue;
-			query.orWhere(conditions);
-		}
+		else if (columns) this.anyOf(query, columns, (q, col) => q.where(col, dateValue));
 	}
 	handleDateTimeComparison(query, column, columns, value, options, operator) {
 		const dateValue = this.parseDateTime(value, options?.dateTimeFormat);
 		if (column) query.where(column, operator, dateValue);
-		else if (columns) for (const col of columns) query.orWhere(col, operator, dateValue);
+		else if (columns) this.anyOf(query, columns, (q, col) => q.where(col, operator, dateValue));
 	}
 	handleDateTimeBetween(query, column, columns, value, options) {
 		if (!Array.isArray(value) || value.length !== 2) return;
 		const [start, end] = value.map((v) => this.parseDateTime(v, options?.dateTimeFormat));
 		if (column) query.whereBetween(column, [start, end]);
-		else if (columns) for (const col of columns) query.orWhere((q) => q.whereBetween(col, [start, end]));
+		else if (columns) this.anyOf(query, columns, (q, col) => q.whereBetween(col, [start, end]));
 	}
 	handleInDateTime(query, column, columns, value, options) {
 		const dates = (Array.isArray(value) ? value : [value]).map((v) => this.parseDateTime(v, options?.dateTimeFormat));
 		if (column) query.whereIn(column, dates);
-		else if (columns) for (const col of columns) query.orWhere((q) => q.whereIn(col, dates));
+		else if (columns) this.anyOf(query, columns, (q, col) => q.whereIn(col, dates));
 	}
 	/**
-	* Parse date string to Date object
-	* TODO: Implement proper date parsing with format support
+	* Parse a date string with the declared format; invalid input is a 400.
 	*/
 	parseDate(value, format) {
-		if (value instanceof Date) return value;
-		return new Date(value);
+		return this.parseWithFormat(value, format);
 	}
 	/**
-	* Parse datetime string to Date object
-	* TODO: Implement proper datetime parsing with format support
+	* Parse a datetime string with the declared format; invalid input is a 400.
 	*/
 	parseDateTime(value, format) {
+		return this.parseWithFormat(value, format);
+	}
+	parseWithFormat(value, format) {
 		if (value instanceof Date) return value;
-		return new Date(value);
+		const parsed = format ? dayjs(String(value), format, true) : dayjs(value);
+		if (!parsed.isValid()) throw new BadRequestError(`Invalid date filter value "${value}"${format ? ` (expected ${format})` : ""}`);
+		return parsed.toDate();
 	}
 };
 

package/esm/repositories/adapters/cascade/filter-applicator.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"filter-applicator.mjs","names":[],"sources":["../../../../../../../../../core/src/repositories/adapters/cascade/filter-applicator.ts"],"sourcesContent":["import type {\n  QueryBuilderContract as CascadeQueryBuilder,\n  QueryBuilderContract,\n} from \"@warlock.js/cascade\";\nimport type { FilterOptions, FilterRule, FilterRules } from \"../../contracts\";\n\n/**\n * Applies repository filters to a Cascade-Next query builder\n * Translates repository filter rules into Cascade query builder method calls\n */\nexport class FilterApplicator {\n  /**\n   * Apply filters to a Cascade query builder\n   *\n   * @param query - Cascade query builder instance\n   * @param filters - Filter structure defining how to filter\n   * @param data - Data containing filter values\n   * @param options - Additional filter options (date formats, etc.)\n   */\n  public apply(\n    query: CascadeQueryBuilder<any>,\n    filters: FilterRules,\n    data: any,\n    options: FilterOptions,\n  ): void {\n    // `Object.entries` hands the rule over already narrowed; a `for...in` index\n    // read is `FilterRule | undefined` under the strictness contract.\n    for (const [key, filterRule] of Object.entries(filters)) {\n      const value = data[key];\n\n      if (value === undefined) continue;\n      if (filterRule === undefined) continue;\n\n      const rule = this.parseFilterRule(key, filterRule);\n      this.applyFilterRule(query, rule, value, data, options);\n    }\n  }\n\n  /**\n   * Parse a filter rule into a structured format\n   */\n  private parseFilterRule(key: string, rule: FilterRule) {\n    // Handle custom function\n    if (typeof rule === \"function\") {\n      return { type: \"function\", fn: rule, column: key, key };\n    }\n\n    // Handle array format: [\"operator\"] or [\"operator\", \"column\"] or [\"operator\", [\"col1\", \"col2\"]]\n    if (Array.isArray(rule)) {\n      const [operator, target] = rule;\n\n      if (target === undefined) {\n        return { type: operator, column: key, columns: undefined, key };\n      }\n\n      if (Array.isArray(target)) {\n        return { type: operator, column: undefined, columns: target, key };\n      }\n\n      return { type: operator, column: target, columns: undefined, key };\n    }\n\n    // Handle simple operator string\n    return { type: rule, column: key, columns: undefined, key };\n  }\n\n  /**\n   * Apply a single filter rule to the query\n   */\n  private applyFilterRule(\n    query: CascadeQueryBuilder<any>,\n    rule: any,\n    value: any,\n    data: any,\n    options: FilterOptions,\n  ): void {\n    // 1. Custom function filter\n    if (rule.type === \"function\") {\n      rule.fn(value, query, data);\n      return;\n    }\n\n    // 2. Predefined filter types\n    const handler = this.getFilterHandler(rule.type);\n    if (handler) {\n      handler.call(this, query, rule.column, rule.columns, value, options);\n      return;\n    }\n\n    // 3. Standard where operators\n    this.applyWhereOperator(query, rule.type, rule.column, rule.columns, value, rule.key);\n  }\n\n  /**\n   * Get filter handler for predefined types\n   */\n  private getFilterHandler(type: string): Function | undefined {\n    const handlers: Record<string, Function> = {\n      // Boolean filters\n      bool: this.handleBoolean,\n      boolean: this.handleBoolean,\n\n      // Numeric filters\n      int: this.handleInt,\n      integer: this.handleInt,\n      \"!int\": this.handleNotInt,\n      \"int>\": (q: any, col: any, cols: any, val: any) =>\n        this.handleIntComparison(q, col, cols, val, \">\"),\n      \"int>=\": (q: any, col: any, cols: any, val: any) =>\n        this.handleIntComparison(q, col, cols, val, \">=\"),\n      \"int<\": (q: any, col: any, cols: any, val: any) =>\n        this.handleIntComparison(q, col, cols, val, \"<\"),\n      \"int<=\": (q: any, col: any, cols: any, val: any) =>\n        this.handleIntComparison(q, col, cols, val, \"<=\"),\n      inInt: this.handleInInt,\n      number: this.handleNumber,\n      inNumber: this.handleInNumber,\n      float: this.handleFloat,\n      double: this.handleFloat,\n      inFloat: this.handleInNumber,\n\n      // Null filters\n      null: this.handleNull,\n      notNull: this.handleNotNull,\n      \"!null\": this.handleNotNull,\n\n      // Date filters\n      date: this.handleDate,\n      \"date>\": (q: any, col: any, cols: any, val: any, opts: any) =>\n        this.handleDateComparison(q, col, cols, val, opts, \">\"),\n      \"date>=\": (q: any, col: any, cols: any, val: any, opts: any) =>\n        this.handleDateComparison(q, col, cols, val, opts, \">=\"),\n      \"date<\": (q: any, col: any, cols: any, val: any, opts: any) =>\n        this.handleDateComparison(q, col, cols, val, opts, \"<\"),\n      \"date<=\": (q: any, col: any, cols: any, val: any, opts: any) =>\n        this.handleDateComparison(q, col, cols, val, opts, \"<=\"),\n      dateBetween: this.handleDateBetween,\n      inDate: this.handleInDate,\n\n      // DateTime filters\n      dateTime: this.handleDateTime,\n      \"dateTime>\": (q: any, col: any, cols: any, val: any, opts: any) =>\n        this.handleDateTimeComparison(q, col, cols, val, opts, \">\"),\n      \"dateTime>=\": (q: any, col: any, cols: any, val: any, opts: any) =>\n        this.handleDateTimeComparison(q, col, cols, val, opts, \">=\"),\n      \"dateTime<\": (q: any, col: any, cols: any, val: any, opts: any) =>\n        this.handleDateTimeComparison(q, col, cols, val, opts, \"<\"),\n      \"dateTime<=\": (q: any, col: any, cols: any, val: any, opts: any) =>\n        this.handleDateTimeComparison(q, col, cols, val, opts, \"<=\"),\n      dateTimeBetween: this.handleDateTimeBetween,\n      inDateTime: this.handleInDateTime,\n\n      // Scope filter - applies local scope when value is truthy\n      scope: this.handleScope,\n\n      // With filter - eager-loads a relation when value is truthy\n      with: this.handleWith,\n\n      // JoinWith filter - eager-loads a relation via SQL JOIN when value is truthy\n      joinWith: this.handleJoinWith,\n\n      // Vector similarity search — calls similarTo(column, embedding[])\n      similarTo: this.handleSimilarTo,\n    };\n\n    return handlers[type];\n  }\n\n  /**\n   * Apply standard where operators\n   */\n  private applyWhereOperator(\n    query: QueryBuilderContract,\n    operator: string,\n    column?: string,\n    columns?: string[],\n    value?: any,\n    ruleName?: string,\n  ): void {\n    // Handle \"in\" prefix for array values\n    if (operator.startsWith(\"in\") && operator !== \"int\" && !Array.isArray(value)) {\n      value = [value];\n    }\n\n    // Single column\n    if (column) {\n      switch (operator) {\n        case \"=\":\n          query.where(column, value);\n          break;\n        case \"!=\":\n        case \"<>\":\n          query.where(column, \"!=\", value);\n          break;\n        case \">\":\n        case \">=\":\n        case \"<\":\n        case \"<=\":\n          query.where(column, operator, value);\n          break;\n        case \"in\":\n          query.whereIn(column, Array.isArray(value) ? value : [value]);\n          break;\n        case \"not in\":\n          query.whereNotIn(column, Array.isArray(value) ? value : [value]);\n          break;\n        case \"like\":\n          query.whereLike(column, value);\n          break;\n        case \"not like\":\n          query.whereNotLike(column, value);\n          break;\n        case \"between\":\n          query.whereBetween(column, value);\n          break;\n        case \"not between\":\n          query.whereNotBetween(column, value);\n          break;\n      }\n    }\n    // Multiple columns (OR condition)\n    else if (columns) {\n      if (operator === \"=\") {\n        const conditions: any = {};\n        for (const col of columns) {\n          conditions[col] = value;\n        }\n        query.orWhere(conditions);\n      } else if (operator === \"like\") {\n        // (col0 LIKE value OR col1 LIKE value OR ...), OR'd with prior conditions —\n        // the object form of orWhere() only ever emits \"=\", so \"like\" needs the\n        // callback/group form to keep the operator instead of silently degrading\n        // to equality (D1).\n        query.orWhere((sub: QueryBuilderContract) => {\n          columns.forEach((col, index) => {\n            if (index === 0) {\n              sub.where(col, \"like\", value);\n            } else {\n              sub.orWhere(col, \"like\", value);\n            }\n          });\n        });\n      } else {\n        // Every other operator silently degraded to equality via the object form\n        // of orWhere() — refuse instead of returning a correct-looking, wrong query.\n        throw new Error(\n          `Unsupported multi-column filter operator \"${operator}\" for rule \"${ruleName ?? columns.join(\",\")}\". ` +\n            `Multi-column filters only support \"=\" and \"like\".`,\n        );\n      }\n    }\n  }\n\n  // ============================================================================\n  // BOOLEAN FILTERS\n  // ============================================================================\n\n  /**\n   * Coerce a filter value to a boolean.\n   *\n   * Recognized truthy forms: `true`, `1`, `\"true\"`, `\"1\"`.\n   * Recognized falsy forms:  `false`, `0`, `\"false\"`, `\"0\"`.\n   * Anything else falls back to `Boolean(value)`.\n   *\n   * NOTE: this intentionally does NOT treat \"non-empty\" as true — the previous\n   * `|| !isEmpty(value)` fallback coerced `false`/`0` to `true`, inverting the\n   * filter for explicitly-false values.\n   */\n  private coerceBoolean(value: any): boolean {\n    if (value === true || value === 1 || value === \"true\" || value === \"1\") {\n      return true;\n    }\n\n    if (value === false || value === 0 || value === \"false\" || value === \"0\") {\n      return false;\n    }\n\n    return Boolean(value);\n  }\n\n  private handleBoolean(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n  ) {\n    const boolValue = this.coerceBoolean(value);\n    if (column) {\n      query.where(column, boolValue);\n    } else if (columns) {\n      const conditions: any = {};\n      for (const col of columns) {\n        conditions[col] = boolValue;\n      }\n\n      query.orWhere(conditions);\n    }\n  }\n\n  // ============================================================================\n  // NUMERIC FILTERS\n  // ============================================================================\n  private handleInt(query: QueryBuilderContract, column?: string, columns?: string[], value?: any) {\n    const intValue = parseInt(value);\n    if (column) {\n      query.where(column, intValue);\n    } else if (columns) {\n      const conditions: any = {};\n      for (const col of columns) {\n        conditions[col] = intValue;\n      }\n\n      query.orWhere(conditions);\n    }\n  }\n\n  private handleNotInt(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n  ) {\n    const intValue = parseInt(value);\n    if (column) {\n      query.where(column, \"!=\", intValue);\n    } else if (columns) {\n      // Use multiple orWhere calls for OR logic across columns\n      for (const col of columns) {\n        query.orWhere(col, \"!=\", intValue);\n      }\n    }\n  }\n\n  private handleIntComparison(\n    query: QueryBuilderContract,\n    column: any,\n    columns: any,\n    value: any,\n    operator: string,\n  ) {\n    const intValue = parseInt(value);\n    if (column) {\n      query.where(column, operator, intValue);\n    } else if (columns) {\n      for (const col of columns) {\n        query.orWhere(col, operator, intValue);\n      }\n    }\n  }\n\n  private handleInInt(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n  ) {\n    const values = (Array.isArray(value) ? value : [value]).map((v: any) => parseInt(v));\n    if (column) {\n      query.whereIn(column, values);\n    } else if (columns) {\n      // Use multiple orWhere calls with whereIn for each column\n      for (const col of columns) {\n        query.orWhere((q: any) => q.whereIn(col, values));\n      }\n    }\n  }\n\n  private handleNumber(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n  ) {\n    const numValue = Number(value);\n    if (column) {\n      query.where(column, numValue);\n    } else if (columns) {\n      const conditions: any = {};\n      for (const col of columns) {\n        conditions[col] = numValue;\n      }\n\n      query.orWhere(conditions);\n    }\n  }\n\n  private handleInNumber(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n  ) {\n    const values = (Array.isArray(value) ? value : [value]).map((v: any) => Number(v));\n    if (column) {\n      query.whereIn(column, values);\n    } else if (columns) {\n      // Use multiple orWhere calls with whereIn for each column\n      for (const col of columns) {\n        query.orWhere((q: any) => q.whereIn(col, values));\n      }\n    }\n  }\n\n  private handleFloat(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n  ) {\n    const floatValue = parseFloat(value);\n    if (column) {\n      query.where(column, floatValue);\n    } else if (columns) {\n      const conditions: any = {};\n      for (const col of columns) {\n        conditions[col] = floatValue;\n      }\n\n      query.orWhere(conditions);\n    }\n  }\n\n  // ============================================================================\n  // NULL FILTERS\n  // ============================================================================\n\n  private handleNull(query: QueryBuilderContract, column?: string, columns?: string[]) {\n    if (column) {\n      query.whereNull(column);\n    } else if (columns) {\n      for (const col of columns) {\n        query.orWhere({ [col]: null });\n      }\n    }\n  }\n\n  private handleNotNull(query: QueryBuilderContract, column?: string, columns?: string[]) {\n    if (column) {\n      query.whereNotNull(column);\n    } else if (columns) {\n      // Use whereNotNull for each column\n      for (const col of columns) {\n        query.orWhere((q: any) => q.whereNotNull(col));\n      }\n    }\n  }\n\n  // ============================================================================\n  // SCOPE FILTER\n  // ============================================================================\n\n  /**\n   * Handle scope filter - applies local scope and passes the filter value.\n   *\n   * Usage in filterBy:\n   * ```typescript\n   * filterBy: {\n   *   active: \"scope\",           // Uses the filter key as scope name\n   *   isAdmin: [\"scope\", \"admin\"] // Uses custom scope name\n   * }\n   * ```\n   *\n   * When list({ active: true }) is called, it will call query.scope(\"active\", true)\n   * When list({ status: \"pending\" }) is called, it will call query.scope(\"status\", \"pending\")\n   */\n  private handleScope(\n    query: QueryBuilderContract,\n    column?: string,\n    _columns?: string[],\n    value?: any,\n  ) {\n    // column holds the scope name (either the filter key or custom name from array format)\n    if (column) {\n      query.scope(column, value);\n    }\n  }\n\n  // ============================================================================\n  // WITH (EAGER LOAD) FILTER\n  // ============================================================================\n\n  /**\n   * Handle with filter - eager-loads a relation when the filter value is truthy.\n   *\n   * Usage in filterBy:\n   * ```typescript\n   * filterBy: {\n   *   with_ai_model: [\"with\", \"ai_model\"],         // load single relation\n   *   with_all:      [\"with\", [\"ai_model\", \"unit\"]] // load multiple relations\n   * }\n   * ```\n   *\n   * When list({ with_ai_model: true }) is called, it will call query.with(\"ai_model\")\n   */\n  private handleWith(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n  ) {\n    if (!value) return;\n\n    // Load a single named relation\n    if (column) {\n      if (query.with) {\n        query.with(column);\n      }\n      return;\n    }\n\n    // Load multiple relations from the columns array\n    if (columns) {\n      for (const relation of columns) {\n        if (query.with) {\n          query.with(relation);\n        }\n      }\n    }\n  }\n\n  /**\n   * Handle joinWith filter - eager-loads a relation via SQL JOIN when the filter value is truthy.\n   *\n   * Usage in filterBy:\n   * ```typescript\n   * filterBy: {\n   *   with_ai_model: [\"joinWith\", \"ai_model\"],         // load single relation via join\n   *   with_all:      [\"joinWith\", [\"ai_model\", \"unit\"]] // load multiple relations via join\n   * }\n   * ```\n   *\n   * When list({ with_ai_model: true }) is called, it will call query.joinWith(\"ai_model\")\n   */\n  private handleJoinWith(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n  ) {\n    if (!value) return;\n\n    if (!query.joinWith) {\n      console.warn(\n        \"[Repository] joinWith is not supported by the query builder. using with instead.\",\n      );\n      return this.handleWith(query, column, columns, value);\n    }\n\n    // Load a single named relation\n    if (column) {\n      query.joinWith(column);\n      return;\n    }\n\n    // Load multiple relations from the columns array\n    if (columns) {\n      query.joinWith(...columns);\n    }\n  }\n\n  // ============================================================================\n  // VECTOR FILTER\n  // ============================================================================\n\n  /**\n   * Handle similarTo filter — performs vector similarity search.\n   *\n   * The filter value must be a `number[]` (pre-computed embedding).\n   * Delegates to `query.similarTo(column, embedding)` which is handled\n   * driver-specifically (pgvector or MongoDB Atlas $vectorSearch).\n   *\n   * Usage in filterBy:\n   * ```typescript\n   * filterBy: {\n   *   organization_id: \"=\",\n   *   embedding: \"similarTo\",\n   * }\n   * ```\n   *\n   * Then in the service:\n   * ```typescript\n   * await vectorsRepository.list({ embedding: queryEmbedding, organization_id: orgId });\n   * ```\n   */\n  private handleSimilarTo(\n    query: QueryBuilderContract,\n    column?: string,\n    _columns?: string[],\n    value?: any,\n  ) {\n    if (!column || !Array.isArray(value)) return;\n\n    // Cast to any: Cascade's internal QueryBuilderContract still uses nearestTo;\n    // our wrapper (CascadeQueryBuilder.similarTo) delegates to it correctly.\n    (query as any).similarTo(column, value);\n  }\n\n  // ============================================================================\n  // DATE FILTERS\n  // ============================================================================\n\n  private handleDate(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n    options?: FilterOptions,\n  ) {\n    const dateValue = this.parseDate(value, options?.dateFormat);\n    if (column) {\n      query.whereDate(column, dateValue);\n    } else if (columns) {\n      for (const col of columns) {\n        query.orWhere((q: any) => q.whereDate(col, dateValue));\n      }\n    }\n  }\n\n  private handleDateComparison(\n    query: QueryBuilderContract,\n    column: any,\n    columns: any,\n    value: any,\n    options: any,\n    operator: string,\n  ) {\n    const dateValue = this.parseDate(value, options?.dateFormat);\n    if (column) {\n      if (operator === \">\" || operator === \">=\") {\n        query.whereDateAfter(column, dateValue);\n      } else {\n        query.whereDateBefore(column, dateValue);\n      }\n    } else if (columns) {\n      for (const col of columns) {\n        if (operator === \">\" || operator === \">=\") {\n          query.orWhere((q: any) => q.whereDateAfter(col, dateValue));\n        } else {\n          query.orWhere((q: any) => q.whereDateBefore(col, dateValue));\n        }\n      }\n    }\n  }\n\n  private handleDateBetween(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n    options?: FilterOptions,\n  ) {\n    if (!Array.isArray(value) || value.length !== 2) return;\n    const [start, end] = value.map((v: any) => this.parseDate(v, options?.dateFormat));\n\n    // `value.length === 2` is checked above, so both exist — but the compiler\n    // does not narrow destructured elements from a length test. Returning\n    // rather than defaulting: this builds a date RANGE for a query, and a\n    // half-formed range would silently filter on a boundary the caller never\n    // asked for.\n    if (start === undefined || end === undefined) return;\n\n    if (column) {\n      query.whereDateBetween(column, [start, end]);\n    } else if (columns) {\n      for (const col of columns) {\n        query.orWhere((q: any) => q.whereDateBetween(col, [start, end]));\n      }\n    }\n  }\n\n  private handleInDate(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n    options?: FilterOptions,\n  ) {\n    const dates = (Array.isArray(value) ? value : [value]).map((v: any) =>\n      this.parseDate(v, options?.dateFormat),\n    );\n    if (column) {\n      query.whereIn(column, dates);\n    } else if (columns) {\n      // Use multiple orWhere calls with whereIn for each column\n      for (const col of columns) {\n        query.orWhere((q: any) => q.whereIn(col, dates));\n      }\n    }\n  }\n\n  // ============================================================================\n  // DATETIME FILTERS\n  // ============================================================================\n\n  private handleDateTime(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n    options?: FilterOptions,\n  ) {\n    const dateValue = this.parseDateTime(value, options?.dateTimeFormat);\n    if (column) {\n      query.where(column, dateValue);\n    } else if (columns) {\n      const conditions: any = {};\n      for (const col of columns) {\n        conditions[col] = dateValue;\n      }\n\n      query.orWhere(conditions);\n    }\n  }\n\n  private handleDateTimeComparison(\n    query: QueryBuilderContract,\n    column: any,\n    columns: any,\n    value: any,\n    options: any,\n    operator: string,\n  ) {\n    const dateValue = this.parseDateTime(value, options?.dateTimeFormat);\n    if (column) {\n      query.where(column, operator, dateValue);\n    } else if (columns) {\n      for (const col of columns) {\n        query.orWhere(col, operator, dateValue);\n      }\n    }\n  }\n\n  private handleDateTimeBetween(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n    options?: FilterOptions,\n  ) {\n    if (!Array.isArray(value) || value.length !== 2) return;\n    const [start, end] = value.map((v: any) => this.parseDateTime(v, options?.dateTimeFormat));\n    if (column) {\n      query.whereBetween(column, [start, end]);\n    } else if (columns) {\n      for (const col of columns) {\n        query.orWhere((q: any) => q.whereBetween(col, [start, end]));\n      }\n    }\n  }\n\n  private handleInDateTime(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n    options?: FilterOptions,\n  ) {\n    const dates = (Array.isArray(value) ? value : [value]).map((v: any) =>\n      this.parseDateTime(v, options?.dateTimeFormat),\n    );\n    if (column) {\n      query.whereIn(column, dates);\n    } else if (columns) {\n      // Use multiple orWhere calls with whereIn for each column\n      for (const col of columns) {\n        query.orWhere((q: any) => q.whereIn(col, dates));\n      }\n    }\n  }\n\n  // ============================================================================\n  // DATE PARSING UTILITIES\n  // ============================================================================\n\n  /**\n   * Parse date string to Date object\n   * TODO: Implement proper date parsing with format support\n   */\n  private parseDate(value: any, format?: string): Date {\n    if (value instanceof Date) return value;\n    return new Date(value);\n  }\n\n  /**\n   * Parse datetime string to Date object\n   * TODO: Implement proper datetime parsing with format support\n   */\n  private parseDateTime(value: any, format?: string): Date {\n    if (value instanceof Date) return value;\n    return new Date(value);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"filter-applicator.mjs","names":[],"sources":["../../../../../../../../../core/src/repositories/adapters/cascade/filter-applicator.ts"],"sourcesContent":["import type {\n  QueryBuilderContract as CascadeQueryBuilder,\n  QueryBuilderContract,\n} from \"@warlock.js/cascade\";\nimport dayjs from \"dayjs\";\nimport customParseFormat from \"dayjs/plugin/customParseFormat.js\";\nimport { BadRequestError } from \"../../../http/errors/errors\";\nimport type { FilterOptions, FilterRule, FilterRules } from \"../../contracts\";\n\ndayjs.extend(customParseFormat);\n\n/**\n * Applies repository filters to a Cascade-Next query builder\n * Translates repository filter rules into Cascade query builder method calls\n */\nexport class FilterApplicator {\n  /**\n   * Apply filters to a Cascade query builder\n   *\n   * @param query - Cascade query builder instance\n   * @param filters - Filter structure defining how to filter\n   * @param data - Data containing filter values\n   * @param options - Additional filter options (date formats, etc.)\n   */\n  public apply(\n    query: CascadeQueryBuilder<any>,\n    filters: FilterRules,\n    data: any,\n    options: FilterOptions,\n  ): void {\n    // `Object.entries` hands the rule over already narrowed; a `for...in` index\n    // read is `FilterRule | undefined` under the strictness contract.\n    for (const [key, filterRule] of Object.entries(filters)) {\n      const value = data[key];\n\n      if (value === undefined) continue;\n      if (filterRule === undefined) continue;\n\n      const rule = this.parseFilterRule(key, filterRule);\n      this.applyFilterRule(query, rule, value, data, options);\n    }\n  }\n\n  /**\n   * Parse a filter rule into a structured format\n   */\n  private parseFilterRule(key: string, rule: FilterRule) {\n    // Handle custom function\n    if (typeof rule === \"function\") {\n      return { type: \"function\", fn: rule, column: key, key };\n    }\n\n    // Handle array format: [\"operator\"] or [\"operator\", \"column\"] or [\"operator\", [\"col1\", \"col2\"]]\n    if (Array.isArray(rule)) {\n      const [operator, target] = rule;\n\n      if (target === undefined) {\n        return { type: operator, column: key, columns: undefined, key };\n      }\n\n      if (Array.isArray(target)) {\n        return { type: operator, column: undefined, columns: target, key };\n      }\n\n      return { type: operator, column: target, columns: undefined, key };\n    }\n\n    // Handle simple operator string\n    return { type: rule, column: key, columns: undefined, key };\n  }\n\n  /**\n   * Apply a single filter rule to the query\n   */\n  private applyFilterRule(\n    query: CascadeQueryBuilder<any>,\n    rule: any,\n    value: any,\n    data: any,\n    options: FilterOptions,\n  ): void {\n    // 1. Custom function filter\n    if (rule.type === \"function\") {\n      rule.fn(value, query, data);\n      return;\n    }\n\n    // 2. Predefined filter types\n    const handler = this.getFilterHandler(rule.type);\n    if (handler) {\n      handler.call(this, query, rule.column, rule.columns, value, options);\n      return;\n    }\n\n    // 3. Standard where operators\n    this.applyWhereOperator(query, rule.type, rule.column, rule.columns, value, rule.key);\n  }\n\n  /**\n   * Get filter handler for predefined types\n   */\n  private getFilterHandler(type: string): Function | undefined {\n    const handlers: Record<string, Function> = {\n      // Boolean filters\n      bool: this.handleBoolean,\n      boolean: this.handleBoolean,\n\n      // Numeric filters\n      int: this.handleInt,\n      integer: this.handleInt,\n      \"!int\": this.handleNotInt,\n      \"int>\": (q: any, col: any, cols: any, val: any) =>\n        this.handleIntComparison(q, col, cols, val, \">\"),\n      \"int>=\": (q: any, col: any, cols: any, val: any) =>\n        this.handleIntComparison(q, col, cols, val, \">=\"),\n      \"int<\": (q: any, col: any, cols: any, val: any) =>\n        this.handleIntComparison(q, col, cols, val, \"<\"),\n      \"int<=\": (q: any, col: any, cols: any, val: any) =>\n        this.handleIntComparison(q, col, cols, val, \"<=\"),\n      inInt: this.handleInInt,\n      number: this.handleNumber,\n      inNumber: this.handleInNumber,\n      float: this.handleFloat,\n      double: this.handleFloat,\n      inFloat: this.handleInNumber,\n\n      // Null filters\n      null: this.handleNull,\n      notNull: this.handleNotNull,\n      \"!null\": this.handleNotNull,\n\n      // Date filters\n      date: this.handleDate,\n      \"date>\": (q: any, col: any, cols: any, val: any, opts: any) =>\n        this.handleDateComparison(q, col, cols, val, opts, \">\"),\n      \"date>=\": (q: any, col: any, cols: any, val: any, opts: any) =>\n        this.handleDateComparison(q, col, cols, val, opts, \">=\"),\n      \"date<\": (q: any, col: any, cols: any, val: any, opts: any) =>\n        this.handleDateComparison(q, col, cols, val, opts, \"<\"),\n      \"date<=\": (q: any, col: any, cols: any, val: any, opts: any) =>\n        this.handleDateComparison(q, col, cols, val, opts, \"<=\"),\n      dateBetween: this.handleDateBetween,\n      inDate: this.handleInDate,\n\n      // DateTime filters\n      dateTime: this.handleDateTime,\n      \"dateTime>\": (q: any, col: any, cols: any, val: any, opts: any) =>\n        this.handleDateTimeComparison(q, col, cols, val, opts, \">\"),\n      \"dateTime>=\": (q: any, col: any, cols: any, val: any, opts: any) =>\n        this.handleDateTimeComparison(q, col, cols, val, opts, \">=\"),\n      \"dateTime<\": (q: any, col: any, cols: any, val: any, opts: any) =>\n        this.handleDateTimeComparison(q, col, cols, val, opts, \"<\"),\n      \"dateTime<=\": (q: any, col: any, cols: any, val: any, opts: any) =>\n        this.handleDateTimeComparison(q, col, cols, val, opts, \"<=\"),\n      dateTimeBetween: this.handleDateTimeBetween,\n      inDateTime: this.handleInDateTime,\n\n      // Scope filter - applies local scope when value is truthy\n      scope: this.handleScope,\n\n      // With filter - eager-loads a relation when value is truthy\n      with: this.handleWith,\n\n      // JoinWith filter - eager-loads a relation via SQL JOIN when value is truthy\n      joinWith: this.handleJoinWith,\n\n      // Vector similarity search — calls similarTo(column, embedding[])\n      similarTo: this.handleSimilarTo,\n    };\n\n    return handlers[type];\n  }\n\n  /**\n   * `like` is a contains match on every driver: a value without an explicit\n   * `%` is wrapped as `%value%` (Postgres would otherwise match exactly while\n   * Mongo matched a substring). Values carrying their own `%` are kept as-is.\n   */\n  private likePattern(value: any): any {\n    if (typeof value !== \"string\" || value.includes(\"%\")) return value;\n    return `%${value}%`;\n  }\n\n  /**\n   * Coerce a client value to an integer or reject with a 400.\n   */\n  private toInt(value: any): number {\n    const parsed = parseInt(value);\n    if (Number.isNaN(parsed)) {\n      throw new BadRequestError(`Invalid integer filter value \"${value}\"`);\n    }\n    return parsed;\n  }\n\n  /**\n   * Coerce a client value to a number or reject with a 400.\n   */\n  private toNumber(value: any): number {\n    const parsed = Number(value);\n    if (value === \"\" || value === null || Number.isNaN(parsed)) {\n      throw new BadRequestError(`Invalid number filter value \"${value}\"`);\n    }\n    return parsed;\n  }\n\n  /**\n   * Apply standard where operators\n   */\n  private applyWhereOperator(\n    query: QueryBuilderContract,\n    operator: string,\n    column?: string,\n    columns?: string[],\n    value?: any,\n    ruleName?: string,\n  ): void {\n    // Handle \"in\" prefix for array values\n    if (operator.startsWith(\"in\") && operator !== \"int\" && !Array.isArray(value)) {\n      value = [value];\n    }\n\n    // Single column\n    if (column) {\n      switch (operator) {\n        case \"=\":\n          query.where(column, value);\n          break;\n        case \"!=\":\n        case \"<>\":\n          query.where(column, \"!=\", value);\n          break;\n        case \">\":\n        case \">=\":\n        case \"<\":\n        case \"<=\":\n          query.where(column, operator, value);\n          break;\n        case \"in\":\n          query.whereIn(column, Array.isArray(value) ? value : [value]);\n          break;\n        case \"not in\":\n          query.whereNotIn(column, Array.isArray(value) ? value : [value]);\n          break;\n        case \"like\":\n          query.whereLike(column, this.likePattern(value));\n          break;\n        case \"startsWith\":\n          query.whereLike(column, `${value}%`);\n          break;\n        case \"endsWith\":\n          query.whereLike(column, `%${value}`);\n          break;\n        case \"not like\":\n          query.whereNotLike(column, value);\n          break;\n        case \"between\":\n          query.whereBetween(column, value);\n          break;\n        case \"not between\":\n          query.whereNotBetween(column, value);\n          break;\n      }\n    }\n    // Multiple columns (OR condition)\n    else if (columns) {\n      if (operator === \"=\") {\n        this.anyOf(query, columns, (q, col) => q.where(col, value));\n      } else if (operator === \"like\") {\n        // (col0 LIKE value OR col1 LIKE value OR ...), OR'd with prior conditions —\n        // the object form of orWhere() only ever emits \"=\", so \"like\" needs the\n        // callback/group form to keep the operator instead of silently degrading\n        // to equality (D1).\n        this.anyOf(query, columns, (q, col) => q.where(col, \"like\", this.likePattern(value)));\n      } else {\n        // Every other operator silently degraded to equality via the object form\n        // of orWhere() — refuse instead of returning a correct-looking, wrong query.\n        throw new Error(\n          `Unsupported multi-column filter operator \"${operator}\" for rule \"${ruleName ?? columns.join(\",\")}\". ` +\n            `Multi-column filters only support \"=\" and \"like\".`,\n        );\n      }\n    }\n  }\n\n  /**\n   * Apply a condition across several columns as ONE grouped OR: `(a OR b OR ...)`.\n   * The group is ANDed with the rest of the query, so a tenant filter\n   * (`org_id = 5`) can never be widened by a multi-column search. Never emit a\n   * top-level `orWhere` for multi-column filters.\n   */\n  private anyOf(\n    query: QueryBuilderContract,\n    columns: string[],\n    apply: (q: QueryBuilderContract, col: string) => void,\n  ) {\n    query.where((group: QueryBuilderContract) => {\n      columns.forEach((col, index) => {\n        const build = (q: QueryBuilderContract) => apply(q, col);\n\n        if (index === 0) {\n          group.where(build);\n        } else {\n          group.orWhere(build);\n        }\n      });\n    });\n  }\n\n  // ============================================================================\n  // BOOLEAN FILTERS\n  // ============================================================================\n\n  /**\n   * Coerce a filter value to a boolean.\n   *\n   * Recognized truthy forms: `true`, `1`, `\"true\"`, `\"1\"`.\n   * Recognized falsy forms:  `false`, `0`, `\"false\"`, `\"0\"`.\n   * Anything else falls back to `Boolean(value)`.\n   *\n   * NOTE: this intentionally does NOT treat \"non-empty\" as true — the previous\n   * `|| !isEmpty(value)` fallback coerced `false`/`0` to `true`, inverting the\n   * filter for explicitly-false values.\n   */\n  private coerceBoolean(value: any): boolean {\n    if (value === true || value === 1 || value === \"true\" || value === \"1\") {\n      return true;\n    }\n\n    if (value === false || value === 0 || value === \"false\" || value === \"0\") {\n      return false;\n    }\n\n    return Boolean(value);\n  }\n\n  private handleBoolean(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n  ) {\n    const boolValue = this.coerceBoolean(value);\n    if (column) {\n      query.where(column, boolValue);\n    } else if (columns) {\n      this.anyOf(query, columns, (q, col) => q.where(col, boolValue));\n    }\n  }\n\n  // ============================================================================\n  // NUMERIC FILTERS\n  // ============================================================================\n  private handleInt(query: QueryBuilderContract, column?: string, columns?: string[], value?: any) {\n    const intValue = this.toInt(value);\n    if (column) {\n      query.where(column, intValue);\n    } else if (columns) {\n      this.anyOf(query, columns, (q, col) => q.where(col, intValue));\n    }\n  }\n\n  private handleNotInt(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n  ) {\n    const intValue = this.toInt(value);\n    if (column) {\n      query.where(column, \"!=\", intValue);\n    } else if (columns) {\n      // Grouped OR across columns\n      this.anyOf(query, columns, (q, col) => q.where(col, \"!=\", intValue));\n    }\n  }\n\n  private handleIntComparison(\n    query: QueryBuilderContract,\n    column: any,\n    columns: any,\n    value: any,\n    operator: string,\n  ) {\n    const intValue = this.toInt(value);\n    if (column) {\n      query.where(column, operator, intValue);\n    } else if (columns) {\n      this.anyOf(query, columns, (q, col) => q.where(col, operator, intValue));\n    }\n  }\n\n  private handleInInt(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n  ) {\n    const values = (Array.isArray(value) ? value : [value]).map((v: any) => this.toInt(v));\n    if (column) {\n      query.whereIn(column, values);\n    } else if (columns) {\n      // Grouped OR of whereIn across columns\n      this.anyOf(query, columns, (q, col) => q.whereIn(col, values));\n    }\n  }\n\n  private handleNumber(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n  ) {\n    const numValue = this.toNumber(value);\n    if (column) {\n      query.where(column, numValue);\n    } else if (columns) {\n      this.anyOf(query, columns, (q, col) => q.where(col, numValue));\n    }\n  }\n\n  private handleInNumber(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n  ) {\n    const values = (Array.isArray(value) ? value : [value]).map((v: any) => this.toNumber(v));\n    if (column) {\n      query.whereIn(column, values);\n    } else if (columns) {\n      // Grouped OR of whereIn across columns\n      this.anyOf(query, columns, (q, col) => q.whereIn(col, values));\n    }\n  }\n\n  private handleFloat(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n  ) {\n    const floatValue = parseFloat(value);\n    if (column) {\n      query.where(column, floatValue);\n    } else if (columns) {\n      this.anyOf(query, columns, (q, col) => q.where(col, floatValue));\n    }\n  }\n\n  // ============================================================================\n  // NULL FILTERS\n  // ============================================================================\n\n  private handleNull(query: QueryBuilderContract, column?: string, columns?: string[]) {\n    if (column) {\n      query.whereNull(column);\n    } else if (columns) {\n      this.anyOf(query, columns, (q, col) => q.whereNull(col));\n    }\n  }\n\n  private handleNotNull(query: QueryBuilderContract, column?: string, columns?: string[]) {\n    if (column) {\n      query.whereNotNull(column);\n    } else if (columns) {\n      // Use whereNotNull for each column\n      this.anyOf(query, columns, (q, col) => q.whereNotNull(col));\n    }\n  }\n\n  // ============================================================================\n  // SCOPE FILTER\n  // ============================================================================\n\n  /**\n   * Handle scope filter - applies local scope and passes the filter value.\n   *\n   * Usage in filterBy:\n   * ```typescript\n   * filterBy: {\n   *   active: \"scope\",           // Uses the filter key as scope name\n   *   isAdmin: [\"scope\", \"admin\"] // Uses custom scope name\n   * }\n   * ```\n   *\n   * When list({ active: true }) is called, it will call query.scope(\"active\", true)\n   * When list({ status: \"pending\" }) is called, it will call query.scope(\"status\", \"pending\")\n   */\n  private handleScope(\n    query: QueryBuilderContract,\n    column?: string,\n    _columns?: string[],\n    value?: any,\n  ) {\n    // column holds the scope name (either the filter key or custom name from array format)\n    if (column) {\n      query.scope(column, value);\n    }\n  }\n\n  // ============================================================================\n  // WITH (EAGER LOAD) FILTER\n  // ============================================================================\n\n  /**\n   * Handle with filter - eager-loads a relation when the filter value is truthy.\n   *\n   * Usage in filterBy:\n   * ```typescript\n   * filterBy: {\n   *   with_ai_model: [\"with\", \"ai_model\"],         // load single relation\n   *   with_all:      [\"with\", [\"ai_model\", \"unit\"]] // load multiple relations\n   * }\n   * ```\n   *\n   * When list({ with_ai_model: true }) is called, it will call query.with(\"ai_model\")\n   */\n  private handleWith(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n  ) {\n    if (!value) return;\n\n    // Load a single named relation\n    if (column) {\n      if (query.with) {\n        query.with(column);\n      }\n      return;\n    }\n\n    // Load multiple relations from the columns array\n    if (columns) {\n      for (const relation of columns) {\n        if (query.with) {\n          query.with(relation);\n        }\n      }\n    }\n  }\n\n  /**\n   * Handle joinWith filter - eager-loads a relation via SQL JOIN when the filter value is truthy.\n   *\n   * Usage in filterBy:\n   * ```typescript\n   * filterBy: {\n   *   with_ai_model: [\"joinWith\", \"ai_model\"],         // load single relation via join\n   *   with_all:      [\"joinWith\", [\"ai_model\", \"unit\"]] // load multiple relations via join\n   * }\n   * ```\n   *\n   * When list({ with_ai_model: true }) is called, it will call query.joinWith(\"ai_model\")\n   */\n  private handleJoinWith(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n  ) {\n    if (!value) return;\n\n    if (!query.joinWith) {\n      console.warn(\n        \"[Repository] joinWith is not supported by the query builder. using with instead.\",\n      );\n      return this.handleWith(query, column, columns, value);\n    }\n\n    // Load a single named relation\n    if (column) {\n      query.joinWith(column);\n      return;\n    }\n\n    // Load multiple relations from the columns array\n    if (columns) {\n      query.joinWith(...columns);\n    }\n  }\n\n  // ============================================================================\n  // VECTOR FILTER\n  // ============================================================================\n\n  /**\n   * Handle similarTo filter — performs vector similarity search.\n   *\n   * The filter value must be a `number[]` (pre-computed embedding).\n   * Delegates to `query.similarTo(column, embedding)` which is handled\n   * driver-specifically (pgvector or MongoDB Atlas $vectorSearch).\n   *\n   * Usage in filterBy:\n   * ```typescript\n   * filterBy: {\n   *   organization_id: \"=\",\n   *   embedding: \"similarTo\",\n   * }\n   * ```\n   *\n   * Then in the service:\n   * ```typescript\n   * await vectorsRepository.list({ embedding: queryEmbedding, organization_id: orgId });\n   * ```\n   */\n  private handleSimilarTo(\n    query: QueryBuilderContract,\n    column?: string,\n    _columns?: string[],\n    value?: any,\n  ) {\n    if (!column || !Array.isArray(value)) return;\n\n    // Cast to any: Cascade's internal QueryBuilderContract still uses nearestTo;\n    // our wrapper (CascadeQueryBuilder.similarTo) delegates to it correctly.\n    (query as any).similarTo(column, value);\n  }\n\n  // ============================================================================\n  // DATE FILTERS\n  // ============================================================================\n\n  private handleDate(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n    options?: FilterOptions,\n  ) {\n    const dateValue = this.parseDate(value, options?.dateFormat);\n    if (column) {\n      query.whereDate(column, dateValue);\n    } else if (columns) {\n      this.anyOf(query, columns, (q, col) => q.whereDate(col, dateValue));\n    }\n  }\n\n  private handleDateComparison(\n    query: QueryBuilderContract,\n    column: any,\n    columns: any,\n    value: any,\n    options: any,\n    operator: string,\n  ) {\n    const dateValue = this.parseDate(value, options?.dateFormat);\n    if (column) {\n      if (operator === \">\" || operator === \">=\") {\n        query.whereDateAfter(column, dateValue);\n      } else {\n        query.whereDateBefore(column, dateValue);\n      }\n    } else if (columns) {\n      const after = operator === \">\" || operator === \">=\";\n      this.anyOf(query, columns, (q, col) =>\n        after ? q.whereDateAfter(col, dateValue) : q.whereDateBefore(col, dateValue),\n      );\n    }\n  }\n\n  private handleDateBetween(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n    options?: FilterOptions,\n  ) {\n    if (!Array.isArray(value) || value.length !== 2) return;\n    const [start, end] = value.map((v: any) => this.parseDate(v, options?.dateFormat));\n\n    // `value.length === 2` is checked above, so both exist — but the compiler\n    // does not narrow destructured elements from a length test. Returning\n    // rather than defaulting: this builds a date RANGE for a query, and a\n    // half-formed range would silently filter on a boundary the caller never\n    // asked for.\n    if (start === undefined || end === undefined) return;\n\n    if (column) {\n      query.whereDateBetween(column, [start, end]);\n    } else if (columns) {\n      this.anyOf(query, columns, (q, col) => q.whereDateBetween(col, [start, end]));\n    }\n  }\n\n  private handleInDate(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n    options?: FilterOptions,\n  ) {\n    const dates = (Array.isArray(value) ? value : [value]).map((v: any) =>\n      this.parseDate(v, options?.dateFormat),\n    );\n    if (column) {\n      query.whereIn(column, dates);\n    } else if (columns) {\n      // Grouped OR of whereIn across columns\n      this.anyOf(query, columns, (q, col) => q.whereIn(col, dates));\n    }\n  }\n\n  // ============================================================================\n  // DATETIME FILTERS\n  // ============================================================================\n\n  private handleDateTime(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n    options?: FilterOptions,\n  ) {\n    const dateValue = this.parseDateTime(value, options?.dateTimeFormat);\n    if (column) {\n      query.where(column, dateValue);\n    } else if (columns) {\n      this.anyOf(query, columns, (q, col) => q.where(col, dateValue));\n    }\n  }\n\n  private handleDateTimeComparison(\n    query: QueryBuilderContract,\n    column: any,\n    columns: any,\n    value: any,\n    options: any,\n    operator: string,\n  ) {\n    const dateValue = this.parseDateTime(value, options?.dateTimeFormat);\n    if (column) {\n      query.where(column, operator, dateValue);\n    } else if (columns) {\n      this.anyOf(query, columns, (q, col) => q.where(col, operator, dateValue));\n    }\n  }\n\n  private handleDateTimeBetween(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n    options?: FilterOptions,\n  ) {\n    if (!Array.isArray(value) || value.length !== 2) return;\n    const [start, end] = value.map((v: any) => this.parseDateTime(v, options?.dateTimeFormat));\n    if (column) {\n      query.whereBetween(column, [start, end]);\n    } else if (columns) {\n      this.anyOf(query, columns, (q, col) => q.whereBetween(col, [start, end]));\n    }\n  }\n\n  private handleInDateTime(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n    options?: FilterOptions,\n  ) {\n    const dates = (Array.isArray(value) ? value : [value]).map((v: any) =>\n      this.parseDateTime(v, options?.dateTimeFormat),\n    );\n    if (column) {\n      query.whereIn(column, dates);\n    } else if (columns) {\n      // Grouped OR of whereIn across columns\n      this.anyOf(query, columns, (q, col) => q.whereIn(col, dates));\n    }\n  }\n\n  // ============================================================================\n  // DATE PARSING UTILITIES\n  // ============================================================================\n\n  /**\n   * Parse a date string with the declared format; invalid input is a 400.\n   */\n  private parseDate(value: any, format?: string): Date {\n    return this.parseWithFormat(value, format);\n  }\n\n  /**\n   * Parse a datetime string with the declared format; invalid input is a 400.\n   */\n  private parseDateTime(value: any, format?: string): Date {\n    return this.parseWithFormat(value, format);\n  }\n\n  private parseWithFormat(value: any, format?: string): Date {\n    if (value instanceof Date) return value;\n\n    const parsed = format ? dayjs(String(value), format, true) : dayjs(value);\n\n    if (!parsed.isValid()) {\n      throw new BadRequestError(\n        `Invalid date filter value \"${value}\"${format ? ` (expected ${format})` : \"\"}`,\n      );\n    }\n\n    return parsed.toDate();\n  }\n}\n"],"mappings":"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"}

package/esm/repositories/adapters/cascade/index.d.mts

@@ -1,2 +1,2 @@
-import { CascadeAdapter } from "./cascade-adapter.mjs";
+import { CascadeAdapter, UPDATE_MANY_BATCH_SIZE } from "./cascade-adapter.mjs";
 import { CascadeQueryBuilder } from "./cascade-query-builder.mjs";

package/esm/repositories/adapters/cascade/index.mjs

@@ -1,4 +1,4 @@
 import { CascadeQueryBuilder } from "./cascade-query-builder.mjs";
-import { CascadeAdapter } from "./cascade-adapter.mjs";
+import { CascadeAdapter, UPDATE_MANY_BATCH_SIZE } from "./cascade-adapter.mjs";
 
 export {  };

package/esm/repositories/contracts/query-builder.contract.d.mts

@@ -286,21 +286,21 @@ interface QueryBuilderContract<T> {
    * @example
    * await query.where("status", "paid").avg("total")
    */
-  avg(field: string): Promise<number>;
+  avg(field: string): Promise<number | null>;
   /**
    * Minimum value of a field across all matching records.
    *
    * @param field - Field name
    * @returns Promise resolving to the minimum value (0 when no records match)
    */
-  min(field: string): Promise<number>;
+  min(field: string): Promise<number | null>;
   /**
    * Maximum value of a field across all matching records.
    *
    * @param field - Field name
    * @returns Promise resolving to the maximum value (0 when no records match)
    */
-  max(field: string): Promise<number>;
+  max(field: string): Promise<number | null>;
   /**
    * Group matching records by one or more fields and compute aggregates.
    *

package/esm/repositories/contracts/types.d.mts

@@ -155,6 +155,11 @@ type PaginationMode = "pages" | "cursor";
  * Repository list options
  */
 type RepositoryOptions = {
+  /**
+   * Explicit cache key for `listCached()`. Required to cache a call whose
+   * options contain callback filters, which cannot be keyed safely.
+   */
+  cacheKey?: string;
   /**
    * Pagination mode - "pages" for traditional pagination, "cursor" for cursor-based
    * @default "pages"

package/esm/repositories/contracts/types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../../core/src/repositories/contracts/types.ts"],"mappings":"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"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../../core/src/repositories/contracts/types.ts"],"mappings":"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"}

package/esm/repositories/index.d.mts

@@ -2,5 +2,5 @@ import { RepositoryManager } from "./repository.manager.mjs";
 import { RepositoryAdapterContract } from "./contracts/repository-adapter.contract.mjs";
 import { AllRepositoryOptions, CachedRepositoryOptions, ChunkCallback, CursorPaginationOptions, CursorPaginationResult, FilterFunction, FilterOperator, FilterOptions, FilterRule, FilterRules, PaginationMode, PaginationResult, RepositoryConfigurations, RepositoryEvent, RepositoryOptions, RepositoryOptionsWithCursor, RepositoryOptionsWithPages, SaveMode, TypedAllRepositoryOptions, TypedRepositoryOptions, TypedRepositoryOptionsWithCursor, TypedRepositoryOptionsWithPages, WhereOperator } from "./contracts/types.mjs";
 import { AggregateExpressionInput, AggregateExpressions, GroupByFields, QueryBuilderContract } from "./contracts/query-builder.contract.mjs";
-import { CascadeAdapter } from "./adapters/cascade/cascade-adapter.mjs";
+import { CascadeAdapter, UPDATE_MANY_BATCH_SIZE } from "./adapters/cascade/cascade-adapter.mjs";
 import { CascadeQueryBuilder } from "./adapters/cascade/cascade-query-builder.mjs";

package/esm/repositories/index.mjs

@@ -1,5 +1,5 @@
 import { CascadeQueryBuilder } from "./adapters/cascade/cascade-query-builder.mjs";
-import { CascadeAdapter } from "./adapters/cascade/cascade-adapter.mjs";
+import { CascadeAdapter, UPDATE_MANY_BATCH_SIZE } from "./adapters/cascade/cascade-adapter.mjs";
 import "./adapters/cascade/index.mjs";
 import { RepositoryManager } from "./repository.manager.mjs";
 

package/esm/repositories/repository.manager.d.mts

@@ -40,6 +40,25 @@ declare class RepositoryManager<T = unknown, F = Record<string, any>> {
    * @protected
    */
   protected filterBy: FilterRules;
+  /**
+   * Columns a client may sort by (`orderBy` / `sortBy` / `cursorColumn`) when the
+   * options come from a request. `id` and the declared `filterBy` keys are always
+   * allowed; anything else is ignored.
+   * @protected
+   */
+  protected sortable: string[];
+  /**
+   * Columns a client may request through `select`. Empty by default: a client
+   * `select` is ignored unless the repository whitelists the columns here.
+   * @protected
+   */
+  protected selectable: string[];
+  /**
+   * Hard cap on `limit` / `perPage` for every list, all and cursor query.
+   * @default 100
+   * @protected
+   */
+  protected maxPerPage: number;
   /**
    * Get adapter instance (lazy-loaded)
    * Resolution order:
@@ -150,6 +169,14 @@ declare class RepositoryManager<T = unknown, F = Record<string, any>> {
   protected getIsActiveFilter(): {
     [x: string]: any;
   };
+  /**
+   * Attach the active scope to the options. It travels under its own key (after
+   * the caller's options, so it can't be overridden) and is applied as a real
+   * `where` by `applyOptionsToQuery`, independent of `filterBy`.
+   */
+  protected withActive<O extends object>(options?: O): O & {
+    activeScope: Record<string, any>;
+  };
   /**
    * Find a record by ID
    * @param id - Record ID or model instance
@@ -358,6 +385,33 @@ declare class RepositoryManager<T = unknown, F = Record<string, any>> {
    */
   protected asTyped(opts: RepositoryOptions): TypedRepositoryOptions<F>;
   protected asTypedAll(opts: AllRepositoryOptions): TypedAllRepositoryOptions<F>;
+  /**
+   * Option keys that control the query rather than filter it.
+   */
+  private static readonly controlKeys;
+  /**
+   * Columns `orderBy` / `sortBy` / `cursorColumn` may target.
+   */
+  protected getSortableColumns(): Set<string>;
+  /**
+   * Split client-controllable control options from filters: `limit` is capped by
+   * `maxPerPage`, sort / cursor columns must be whitelisted (`sortable`, `filterBy`
+   * keys or `id`) and `select` must be within `selectable`. Anything else is
+   * dropped, so `list({ ...request.all() })` cannot steer the query.
+   */
+  protected sanitizeControls(options: RepositoryOptions): RepositoryOptions;
+  /**
+   * Read the active scope only when it is exactly what `getIsActiveFilter()`
+   * produces, so a client can't smuggle an arbitrary `where` through it.
+   */
+  protected readActiveScope(options: RepositoryOptions): Record<string, any> | undefined;
+  /**
+   * Apply plain `{ column: scalar }` lookups that are not declared in `filterBy`
+   * as equality wheres. Used by `first` (and so `exists`, `findOrCreate`,
+   * `updateOrCreate`) so an undeclared key is never silently dropped and can't
+   * match the wrong row.
+   */
+  protected applyLookupFilters(query: QueryBuilderContract<T>, options: RepositoryOptions): void;
   /**
    * Apply repository options to query
    * @param query - Query builder instance
@@ -583,7 +637,7 @@ declare class RepositoryManager<T = unknown, F = Record<string, any>> {
    * @returns Promise resolving to the filtered numeric average
    * @public
    */
-  avg(field: string, options?: TypedRepositoryOptions<F>): Promise<number>;
+  avg(field: string, options?: TypedRepositoryOptions<F>): Promise<number | null>;
   /**
    * Minimum value of a field across records matching options.
    *
@@ -595,7 +649,7 @@ declare class RepositoryManager<T = unknown, F = Record<string, any>> {
    * @returns Promise resolving to the filtered minimum value
    * @public
    */
-  min(field: string, options?: TypedRepositoryOptions<F>): Promise<number>;
+  min(field: string, options?: TypedRepositoryOptions<F>): Promise<number | null>;
   /**
    * Maximum value of a field across records matching options.
    *
@@ -607,7 +661,7 @@ declare class RepositoryManager<T = unknown, F = Record<string, any>> {
    * @returns Promise resolving to the filtered maximum value
    * @public
    */
-  max(field: string, options?: TypedRepositoryOptions<F>): Promise<number>;
+  max(field: string, options?: TypedRepositoryOptions<F>): Promise<number | null>;
   /**
    * Group records by one or more fields and compute aggregates.
    *
@@ -674,6 +728,10 @@ declare class RepositoryManager<T = unknown, F = Record<string, any>> {
    * @protected
    */
   protected cacheKey(key: string | Record<string, any>, moreOptions?: Record<string, any>): string;
+  /**
+   * Whether a value holds a function at any depth (cycle-safe).
+   */
+  protected containsFunction(value: any, seen?: WeakSet<object>): boolean;
   /**
    * Deterministically serialize a value for use in a cache key.
    *
@@ -768,6 +826,10 @@ declare class RepositoryManager<T = unknown, F = Record<string, any>> {
    * export const cleanup = usersRepository.cleanup.bind(usersRepository);
    */
   $cleanup(): Promise<void>;
+  /**
+   * Cache read that treats a driver failure (e.g. Redis down) as a miss.
+   */
+  private safeCacheGet;
   /**
    * Clear all cache for this repository
    * @public