@warlock.js/cascade 5.20.0 → 5.22.0

package/esm/query-builder/query-builder.d.mts

@@ -184,6 +184,16 @@ declare class QueryBuilder<T = unknown> {
   whereNotNull(field: string): this;
   /** WHERE field BETWEEN low AND high. */
   whereBetween(field: string, range: [unknown, unknown]): this;
+  /** OR field IN values. */
+  orWhereIn(field: string, values: unknown[]): this;
+  /** OR field NOT IN values. */
+  orWhereNotIn(field: string, values: unknown[]): this;
+  /** OR field IS NULL. */
+  orWhereNull(field: string): this;
+  /** OR field IS NOT NULL. */
+  orWhereNotNull(field: string): this;
+  /** OR field BETWEEN low AND high. */
+  orWhereBetween(field: string, range: [unknown, unknown]): this;
   /** WHERE field NOT BETWEEN low AND high. */
   whereNotBetween(field: string, range: [unknown, unknown]): this;
   /**
@@ -205,11 +215,11 @@ declare class QueryBuilder<T = unknown> {
    * a string (potentially request input) is a literal.
    */
   private likePatternData;
-  /** Starts with a prefix. */
+  /** Starts with a prefix (the value is literal text, `%` / `_` / `\` included). */
   whereStartsWith(field: string, value: string | number): this;
   /** Does NOT start with a prefix. */
   whereNotStartsWith(field: string, value: string | number): this;
-  /** Ends with a suffix. */
+  /** Ends with a suffix (the value is literal text, `%` / `_` / `\` included). */
   whereEndsWith(field: string, value: string | number): this;
   /** Does NOT end with a suffix. */
   whereNotEndsWith(field: string, value: string | number): this;
@@ -540,6 +550,15 @@ declare class QueryBuilder<T = unknown> {
   orderByRandom(limit?: number): this;
   /** Order ascending by a date column (oldest first). */
   oldest(column?: string): this;
+  /** The model's created-at column, falling back to `createdAt` without a model. */
+  protected defaultCreatedAtColumn(): string;
+  /**
+   * Quote a column reference for raw SQL fragments.
+   * The base builder is dialect-agnostic and returns it untouched; SQL drivers override.
+   */
+  protected quoteColumn(field: string): string;
+  /** Quote an operand only when it is a plain column name; expressions and literals pass through. */
+  protected quoteOperand(operand: unknown): string;
   /** Limit number of results. */
   limit(value: number): this;
   /** Skip N results (OFFSET). */

package/esm/query-builder/query-builder.d.mts.map

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

package/esm/query-builder/query-builder.mjs

@@ -335,6 +335,40 @@ var QueryBuilder = class QueryBuilder {
 		});
 		return this;
 	}
+	/** OR field IN values. */
+	orWhereIn(field, values) {
+		this.addOperation("orWhereIn", {
+			field,
+			values
+		});
+		return this;
+	}
+	/** OR field NOT IN values. */
+	orWhereNotIn(field, values) {
+		this.addOperation("orWhereNotIn", {
+			field,
+			values
+		});
+		return this;
+	}
+	/** OR field IS NULL. */
+	orWhereNull(field) {
+		this.addOperation("orWhereNull", { field });
+		return this;
+	}
+	/** OR field IS NOT NULL. */
+	orWhereNotNull(field) {
+		this.addOperation("orWhereNotNull", { field });
+		return this;
+	}
+	/** OR field BETWEEN low AND high. */
+	orWhereBetween(field, range) {
+		this.addOperation("orWhereBetween", {
+			field,
+			range
+		});
+		return this;
+	}
 	/** WHERE field NOT BETWEEN low AND high. */
 	whereNotBetween(field, range) {
 		this.addOperation("whereNotBetween", {
@@ -379,21 +413,45 @@ var QueryBuilder = class QueryBuilder {
 			isRegExp: true
 		} : { pattern };
 	}
-	/** Starts with a prefix. */
+	/** Starts with a prefix (the value is literal text, `%` / `_` / `\` included). */
 	whereStartsWith(field, value) {
-		return this.whereLike(field, `${value}%`);
+		this.addOperation("whereLike", {
+			field,
+			pattern: `${value}%`,
+			value: String(value),
+			mode: "startsWith"
+		});
+		return this;
 	}
 	/** Does NOT start with a prefix. */
 	whereNotStartsWith(field, value) {
-		return this.whereNotLike(field, `${value}%`);
+		this.addOperation("whereNotLike", {
+			field,
+			pattern: `${value}%`,
+			value: String(value),
+			mode: "startsWith"
+		});
+		return this;
 	}
-	/** Ends with a suffix. */
+	/** Ends with a suffix (the value is literal text, `%` / `_` / `\` included). */
 	whereEndsWith(field, value) {
-		return this.whereLike(field, `%${value}`);
+		this.addOperation("whereLike", {
+			field,
+			pattern: `%${value}`,
+			value: String(value),
+			mode: "endsWith"
+		});
+		return this;
 	}
 	/** Does NOT end with a suffix. */
 	whereNotEndsWith(field, value) {
-		return this.whereNotLike(field, `%${value}`);
+		this.addOperation("whereNotLike", {
+			field,
+			pattern: `%${value}`,
+			value: String(value),
+			mode: "endsWith"
+		});
+		return this;
 	}
 	/**
 	* Match on date portion only (time ignored).
@@ -449,7 +507,7 @@ var QueryBuilder = class QueryBuilder {
 	*/
 	whereTime(field, value) {
 		this.addOperation("whereRaw", {
-			expression: `TIME(${field}) = ?`,
+			expression: `TIME(${this.quoteColumn(field)}) = ?`,
 			bindings: [value]
 		});
 		return this;
@@ -461,7 +519,7 @@ var QueryBuilder = class QueryBuilder {
 	*/
 	whereDay(field, value) {
 		this.addOperation("whereRaw", {
-			expression: `EXTRACT(DAY FROM ${field}) = ?`,
+			expression: `EXTRACT(DAY FROM ${this.quoteColumn(field)}) = ?`,
 			bindings: [value]
 		});
 		return this;
@@ -469,7 +527,7 @@ var QueryBuilder = class QueryBuilder {
 	/** Month extracted from a date field (1–12). */
 	whereMonth(field, value) {
 		this.addOperation("whereRaw", {
-			expression: `EXTRACT(MONTH FROM ${field}) = ?`,
+			expression: `EXTRACT(MONTH FROM ${this.quoteColumn(field)}) = ?`,
 			bindings: [value]
 		});
 		return this;
@@ -477,7 +535,7 @@ var QueryBuilder = class QueryBuilder {
 	/** Year extracted from a date field. */
 	whereYear(field, value) {
 		this.addOperation("whereRaw", {
-			expression: `EXTRACT(YEAR FROM ${field}) = ?`,
+			expression: `EXTRACT(YEAR FROM ${this.quoteColumn(field)}) = ?`,
 			bindings: [value]
 		});
 		return this;
@@ -518,7 +576,7 @@ var QueryBuilder = class QueryBuilder {
 	*/
 	whereJsonLength(path, operator, value) {
 		this.addOperation("whereRaw", {
-			expression: `jsonb_array_length(${path}) ${operator} ?`,
+			expression: `jsonb_array_length(${this.quoteColumn(path)}) ${operator} ?`,
 			bindings: [value]
 		});
 		return this;
@@ -552,11 +610,11 @@ var QueryBuilder = class QueryBuilder {
 	}
 	/** WHERE id = value. */
 	whereId(value) {
-		return this.where("id", value);
+		return this.where(this.modelClass?.primaryKey ?? "id", value);
 	}
 	/** WHERE id IN values. */
 	whereIds(values) {
-		return this.whereIn("id", values);
+		return this.whereIn(this.modelClass?.primaryKey ?? "id", values);
 	}
 	/** WHERE uuid = value. */
 	whereUuid(value) {
@@ -579,7 +637,11 @@ var QueryBuilder = class QueryBuilder {
 	}
 	/** Full-text search (OR). */
 	orWhereFullText(fields, query) {
-		return this.whereFullText(fields, query);
+		this.addOperation("orWhereFullText", {
+			fields: Array.isArray(fields) ? fields : [fields],
+			query
+		});
+		return this;
 	}
 	/** Alias for whereFullText with a single field. */
 	whereSearch(field, query) {
@@ -590,8 +652,7 @@ var QueryBuilder = class QueryBuilder {
 	* MongoDB-style convenience shorthand.
 	*/
 	textSearch(query, filters) {
-		if (filters) for (const [key, value] of Object.entries(filters)) this.where(key, value);
-		return this;
+		throw new Error(`textSearch("${query}") is not supported by this query builder; use whereFullText(fields, query).`);
 	}
 	whereExists(param) {
 		if (typeof param === "function") {
@@ -922,7 +983,7 @@ var QueryBuilder = class QueryBuilder {
 	* @example q.selectAggregate("price", "sum", "totalRevenue")
 	*/
 	selectAggregate(field, aggregate, alias) {
-		return this.selectRaw({ [alias]: `${aggregate.toUpperCase()}(${field})` });
+		return this.selectRaw({ [alias]: `${aggregate.toUpperCase()}(${field === "*" ? field : this.quoteColumn(field)})` });
 	}
 	/** Existence check as a projected boolean field. */
 	selectExists(field, alias) {
@@ -969,11 +1030,11 @@ var QueryBuilder = class QueryBuilder {
 	}
 	/** String concatenation as a projected field. */
 	selectConcat(fields, alias) {
-		return this.selectRaw({ [alias]: fields.join(" || ") });
+		return this.selectRaw({ [alias]: fields.map((field) => this.quoteOperand(field)).join(" || ") });
 	}
 	/** COALESCE (first non-null) as a projected field. */
 	selectCoalesce(fields, alias) {
-		return this.selectRaw({ [alias]: `COALESCE(${fields.join(", ")})` });
+		return this.selectRaw({ [alias]: `COALESCE(${fields.map((field) => this.quoteOperand(field)).join(", ")})` });
 	}
 	/** Window function expression. */
 	selectWindow(spec) {
@@ -1056,9 +1117,25 @@ var QueryBuilder = class QueryBuilder {
 		return this;
 	}
 	/** Order ascending by a date column (oldest first). */
-	oldest(column = "createdAt") {
+	oldest(column = this.defaultCreatedAtColumn()) {
 		return this.orderBy(column, "asc");
 	}
+	/** The model's created-at column, falling back to `createdAt` without a model. */
+	defaultCreatedAtColumn() {
+		return this.modelClass?.createdAtColumn ?? "createdAt";
+	}
+	/**
+	* Quote a column reference for raw SQL fragments.
+	* The base builder is dialect-agnostic and returns it untouched; SQL drivers override.
+	*/
+	quoteColumn(field) {
+		return field;
+	}
+	/** Quote an operand only when it is a plain column name; expressions and literals pass through. */
+	quoteOperand(operand) {
+		if (typeof operand === "string" && /^[A-Za-z_]\w*(\.[A-Za-z_]\w*)*$/.test(operand)) return this.quoteColumn(operand);
+		return String(operand);
+	}
 	/** Limit number of results. */
 	limit(value) {
 		this.addOperation("limit", { value });