joist-core 2.3.0 → 2.4.0-next.2

package/build/queries/parsedConditions.js

@@ -0,0 +1,20 @@
+import { assertNever } from "../utils.js";
+//#region src/queries/parsedConditions.ts
+/** Pulls out a flat list of all `ColumnCondition`s from a `ParsedExpressionFilter` tree. */
+function deepFindConditions(condition, filterPruneable) {
+	const todo = condition ? [condition] : [];
+	const result = [];
+	while (todo.length !== 0) {
+		const cc = todo.pop();
+		for (const c of cc.conditions) if (c.kind === "exp") todo.push(c);
+		else if (c.kind === "column" || c.kind === "raw") {
+			if (!filterPruneable || !c.pruneable) result.push(c);
+		} else if (c.kind === "exists") result.push(c);
+		else assertNever(c);
+	}
+	return result;
+}
+//#endregion
+export { deepFindConditions };
+
+//# sourceMappingURL=parsedConditions.js.map

package/build/queries/parsedConditions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsedConditions.js","names":[],"sources":["../../src/queries/parsedConditions.ts"],"sourcesContent":["import type { ParsedFindQuery } from \"src/queries/find/QueryParser.ts\";\nimport { assertNever } from \"src/utils.ts\";\n\n/** A tree of ANDs/ORs with conditions or nested conditions. */\nexport interface ParsedExpressionFilter {\n  kind: \"exp\";\n  op: \"and\" | \"or\";\n  conditions: ParsedExpressionCondition[];\n}\n\n/** A condition or nested condition in a `ParsedExpressionFilter`. */\nexport type ParsedExpressionCondition = ParsedExpressionFilter | ColumnCondition | RawCondition | ExistsCondition;\n\nexport interface ColumnCondition {\n  kind: \"column\";\n  alias: string;\n  column: string;\n  dbType: string;\n  cond: ParsedValueFilter<any>;\n  /**\n   * A pruneable condition is one that was auto-added by something like soft-delete, and shouldn't\n   * be something that marks a join as actually used by the user's query.\n   */\n  pruneable?: boolean;\n}\n\n/** A user-provided condition like `SUM(${alias}.amount) > 1000` or `a1.last_name = b1.title`. */\nexport interface RawCondition {\n  kind: \"raw\";\n  /** The aliases, i.e. `[a, b]`, used within the condition, to ensure we don't prune them. */\n  aliases: string[];\n  /** The condition itself, i.e. `SUM(a.age) DESC`. */\n  condition: string;\n  /** The bindings within `condition`, i.e. `SUM(${alias}.amount) > ?`. */\n  bindings: readonly any[];\n  /** Used to mark system-added conditions (like `LATERAL JOIN` conditions), which can be ignored when pruning unused joins. */\n  pruneable: boolean;\n}\n\n/** An EXISTS or NOT EXISTS subquery condition. */\nexport interface ExistsCondition {\n  kind: \"exists\";\n  /** When true, renders as NOT EXISTS. */\n  negate: boolean;\n  /** The subquery: SELECT 1 FROM child WHERE correlation AND filter. */\n  subquery: ParsedFindQuery;\n  /** Outer aliases referenced by the correlation predicate, for join pruning. */\n  outerAliases: string[];\n}\n\n/** An ADT version of `ValueFilter`. */\nexport type ParsedValueFilter<V> =\n  | { kind: \"eq\"; value: V }\n  | { kind: \"in\"; value: readonly V[] }\n  | { kind: \"nin\"; value: readonly V[] }\n  | { kind: \"gt\"; value: V }\n  | { kind: \"gte\"; value: V }\n  | { kind: \"ne\"; value: V }\n  | { kind: \"is-null\" }\n  | { kind: \"not-null\" }\n  | { kind: \"lt\"; value: V }\n  | { kind: \"lte\"; value: V }\n  | { kind: \"like\"; value: V }\n  | { kind: \"nlike\"; value: V }\n  | { kind: \"ilike\"; value: V }\n  | { kind: \"nilike\"; value: V }\n  | { kind: \"regex\"; value: V }\n  | { kind: \"nregex\"; value: V }\n  | { kind: \"iregex\"; value: V }\n  | { kind: \"niregex\"; value: V }\n  | { kind: \"contains\"; value: readonly V[] }\n  | { kind: \"ncontains\"; value: readonly V[] }\n  | { kind: \"overlaps\"; value: readonly V[] }\n  | { kind: \"noverlaps\"; value: readonly V[] }\n  | { kind: \"containedBy\"; value: readonly V[] }\n  | { kind: \"between\"; value: [V, V] }\n  | { kind: \"jsonPathExists\"; value: string }\n  | { kind: \"jsonPathPredicate\"; value: string };\n\n/** Pulls out a flat list of all `ColumnCondition`s from a `ParsedExpressionFilter` tree. */\nexport function deepFindConditions(\n  condition: ParsedExpressionFilter | undefined,\n  filterPruneable: boolean,\n): (ColumnCondition | RawCondition | ExistsCondition)[] {\n  const todo = condition ? [condition] : [];\n  const result: (ColumnCondition | RawCondition | ExistsCondition)[] = [];\n  while (todo.length !== 0) {\n    const cc = todo.pop()!;\n    for (const c of cc.conditions) {\n      if (c.kind === \"exp\") {\n        todo.push(c);\n      } else if (c.kind === \"column\" || c.kind === \"raw\") {\n        if (!filterPruneable || !c.pruneable) result.push(c);\n      } else if (c.kind === \"exists\") {\n        result.push(c);\n      } else {\n        assertNever(c);\n      }\n    }\n  }\n  return result;\n}\n"],"mappings":";;;AAgFA,SAAgB,mBACd,WACA,iBACsD;CACtD,MAAM,OAAO,YAAY,CAAC,SAAS,IAAI,CAAC;CACxC,MAAM,SAA+D,CAAC;CACtE,OAAO,KAAK,WAAW,GAAG;EACxB,MAAM,KAAK,KAAK,IAAI;EACpB,KAAK,MAAM,KAAK,GAAG,YACjB,IAAI,EAAE,SAAS,OACb,KAAK,KAAK,CAAC;OACN,IAAI,EAAE,SAAS,YAAY,EAAE,SAAS,OACvC;OAAA,CAAC,mBAAmB,CAAC,EAAE,WAAW,OAAO,KAAK,CAAC;EAAA,OAC9C,IAAI,EAAE,SAAS,UACpB,OAAO,KAAK,CAAC;OAEb,YAAY,CAAC;CAGnB;CACA,OAAO;AACT"}

package/build/queries/renderConditions.cjs

@@ -0,0 +1,66 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_queries_sql_keywords = require("./sql/keywords.cjs");
+const require_utils = require("../utils.cjs");
+const require_queries_find_EntityGraphQLFilter = require("./find/EntityGraphQLFilter.cjs");
+const require_EntityManager = require("../EntityManager.cjs");
+//#region src/queries/renderConditions.ts
+/** Returns a tuple of `["cond AND (cond OR cond)", bindings]`. */
+function buildWhereClause(exp, topLevel = false, renderSubquery) {
+	const tuples = exp.conditions.map((c) => {
+		return c.kind === "exp" ? buildWhereClause(c, false, renderSubquery) : c.kind === "column" ? buildCondition(c) : c.kind === "raw" ? buildRawCondition(c) : c.kind === "exists" ? buildExistsCondition(c, renderSubquery) : require_utils.fail(`Invalid condition ${c}`);
+	}).filter(require_EntityManager.isDefined);
+	if (tuples.length === 0) return void 0;
+	let sql = tuples.map(([sql]) => sql).join(` ${exp.op.toUpperCase()} `);
+	if (!topLevel) sql = `(${sql})`;
+	return [sql, tuples.flatMap(([, bindings]) => bindings)];
+}
+function buildRawCondition(raw) {
+	return [raw.condition, raw.bindings];
+}
+/** Returns a tuple of `["column op ?"`, bindings]`. */
+function buildCondition(cc) {
+	const { alias, column, cond } = cc;
+	return buildValueCondition(require_queries_sql_keywords.kqDot(alias, column), cond);
+}
+/** Renders an encoded value filter against a SQL column expression. */
+function buildValueCondition(columnName, cond) {
+	switch (cond.kind) {
+		case "eq":
+		case "ne":
+		case "gte":
+		case "gt":
+		case "lte":
+		case "lt":
+		case "like":
+		case "nlike":
+		case "ilike":
+		case "nilike":
+		case "regex":
+		case "nregex":
+		case "iregex":
+		case "niregex":
+		case "jsonPathExists":
+		case "jsonPathPredicate":
+		case "contains":
+		case "containedBy":
+		case "overlaps": return [`${columnName} ${require_queries_find_EntityGraphQLFilter.opToFn[cond.kind] ?? require_utils.fail(`Invalid operator ${cond.kind}`)} ?`, [cond.value]];
+		case "noverlaps":
+		case "ncontains": return [`NOT (${columnName} ${require_queries_find_EntityGraphQLFilter.opToFn[cond.kind.substring(1)] ?? require_utils.fail(`Invalid operator ${cond.kind}`)} ?)`, [cond.value]];
+		case "is-null": return [`${columnName} IS NULL`, []];
+		case "not-null": return [`${columnName} IS NOT NULL`, []];
+		case "in": return [`${columnName} = ANY(?)`, [cond.value]];
+		case "nin": return [`${columnName} != ALL(?)`, [cond.value]];
+		case "between": return [`${columnName} BETWEEN ? AND ?`, cond.value];
+		default: require_utils.assertNever(cond);
+	}
+}
+function buildExistsCondition(c, renderSubquery) {
+	if (!renderSubquery) throw new Error("EXISTS condition requires a subquery renderer");
+	const { sql, bindings } = renderSubquery(c.subquery);
+	return [`${c.negate ? "NOT EXISTS" : "EXISTS"} (${sql})`, [...bindings]];
+}
+//#endregion
+exports.buildValueCondition = buildValueCondition;
+exports.buildWhereClause = buildWhereClause;
+
+//# sourceMappingURL=renderConditions.cjs.map

package/build/queries/renderConditions.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderConditions.cjs","names":["fail","isDefined","kqDot","opToFn"],"sources":["../../src/queries/renderConditions.ts"],"sourcesContent":["import { isDefined } from \"src/EntityManager.ts\";\nimport { opToFn } from \"src/queries/find/EntityGraphQLFilter.ts\";\nimport type { ParsedFindQuery } from \"src/queries/find/QueryParser.ts\";\nimport type {\n  ColumnCondition,\n  ExistsCondition,\n  ParsedExpressionFilter,\n  ParsedValueFilter,\n  RawCondition,\n} from \"src/queries/parsedConditions.ts\";\nimport { kqDot } from \"src/queries/sql/keywords.ts\";\nimport { assertNever, fail } from \"src/utils.ts\";\n\n/** Renders a ParsedFindQuery subquery to SQL — passed in to avoid circular imports with buildFindQuery. */\nexport type SubqueryRenderer = (q: ParsedFindQuery) => { sql: string; bindings: readonly any[] };\n\n/** Returns a tuple of `[\"cond AND (cond OR cond)\", bindings]`. */\nexport function buildWhereClause(\n  exp: ParsedExpressionFilter,\n  topLevel = false,\n  renderSubquery?: SubqueryRenderer,\n): [string, any[]] | undefined {\n  const tuples = exp.conditions\n    .map((c) => {\n      return c.kind === \"exp\"\n        ? buildWhereClause(c, false, renderSubquery)\n        : c.kind === \"column\"\n          ? buildCondition(c)\n          : c.kind === \"raw\"\n            ? buildRawCondition(c)\n            : c.kind === \"exists\"\n              ? buildExistsCondition(c, renderSubquery)\n              : fail(`Invalid condition ${c}`);\n    })\n    .filter(isDefined);\n  // If we don't have any conditions to combine, just return undefined;\n  if (tuples.length === 0) return undefined;\n  // Wrap/join the sql strings together first, and then flatten the bindings.\n  let sql = tuples.map(([sql]) => sql).join(` ${exp.op.toUpperCase()} `);\n  if (!topLevel) sql = `(${sql})`;\n  return [sql, tuples.flatMap(([, bindings]) => bindings)];\n}\n\nfunction buildRawCondition(raw: RawCondition): [string, readonly any[]] {\n  return [raw.condition, raw.bindings];\n}\n\n/** Returns a tuple of `[\"column op ?\"`, bindings]`. */\nfunction buildCondition(cc: ColumnCondition): [string, any[]] {\n  const { alias, column, cond } = cc;\n  return buildValueCondition(kqDot(alias, column), cond);\n}\n\n/** Renders an encoded value filter against a SQL column expression. */\nexport function buildValueCondition(columnName: string, cond: ParsedValueFilter<unknown>): [string, any[]] {\n  switch (cond.kind) {\n    case \"eq\":\n    case \"ne\":\n    case \"gte\":\n    case \"gt\":\n    case \"lte\":\n    case \"lt\":\n    case \"like\":\n    case \"nlike\":\n    case \"ilike\":\n    case \"nilike\":\n    case \"regex\":\n    case \"nregex\":\n    case \"iregex\":\n    case \"niregex\":\n    case \"jsonPathExists\":\n    case \"jsonPathPredicate\":\n    case \"contains\":\n    case \"containedBy\":\n    case \"overlaps\": {\n      const fn = opToFn[cond.kind] ?? fail(`Invalid operator ${cond.kind}`);\n      return [`${columnName} ${fn} ?`, [cond.value]];\n    }\n    case \"noverlaps\":\n    case \"ncontains\": {\n      const fn = (opToFn as any)[cond.kind.substring(1)] ?? fail(`Invalid operator ${cond.kind}`);\n      return [`NOT (${columnName} ${fn} ?)`, [cond.value]];\n    }\n    case \"is-null\":\n      return [`${columnName} IS NULL`, []];\n    case \"not-null\":\n      return [`${columnName} IS NOT NULL`, []];\n    case \"in\":\n      return [`${columnName} = ANY(?)`, [cond.value]];\n    case \"nin\":\n      return [`${columnName} != ALL(?)`, [cond.value]];\n    case \"between\":\n      return [`${columnName} BETWEEN ? AND ?`, cond.value];\n    default:\n      assertNever(cond);\n  }\n}\n\nfunction buildExistsCondition(c: ExistsCondition, renderSubquery?: SubqueryRenderer): [string, any[]] {\n  if (!renderSubquery) throw new Error(\"EXISTS condition requires a subquery renderer\");\n  const { sql, bindings } = renderSubquery(c.subquery);\n  const prefix = c.negate ? \"NOT EXISTS\" : \"EXISTS\";\n  return [`${prefix} (${sql})`, [...bindings]];\n}\n"],"mappings":";;;;;;;AAiBA,SAAgB,iBACd,KACA,WAAW,OACX,gBAC6B;CAC7B,MAAM,SAAS,IAAI,WAChB,KAAK,MAAM;EACV,OAAO,EAAE,SAAS,QACd,iBAAiB,GAAG,OAAO,cAAc,IACzC,EAAE,SAAS,WACT,eAAe,CAAC,IAChB,EAAE,SAAS,QACT,kBAAkB,CAAC,IACnB,EAAE,SAAS,WACT,qBAAqB,GAAG,cAAc,IACtCA,cAAAA,KAAK,qBAAqB,GAAG;CACzC,CAAC,CAAC,CACD,OAAOC,sBAAAA,SAAS;CAEnB,IAAI,OAAO,WAAW,GAAG,OAAO,KAAA;CAEhC,IAAI,MAAM,OAAO,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,KAAK,IAAI,IAAI,GAAG,YAAY,EAAE,EAAE;CACrE,IAAI,CAAC,UAAU,MAAM,IAAI,IAAI;CAC7B,OAAO,CAAC,KAAK,OAAO,SAAS,GAAG,cAAc,QAAQ,CAAC;AACzD;AAEA,SAAS,kBAAkB,KAA6C;CACtE,OAAO,CAAC,IAAI,WAAW,IAAI,QAAQ;AACrC;;AAGA,SAAS,eAAe,IAAsC;CAC5D,MAAM,EAAE,OAAO,QAAQ,SAAS;CAChC,OAAO,oBAAoBC,6BAAAA,MAAM,OAAO,MAAM,GAAG,IAAI;AACvD;;AAGA,SAAgB,oBAAoB,YAAoB,MAAmD;CACzG,QAAQ,KAAK,MAAb;EACE,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK,YAEH,OAAO,CAAC,GAAG,WAAW,GADXC,yCAAAA,OAAO,KAAK,SAASH,cAAAA,KAAK,oBAAoB,KAAK,MAAM,EACxC,KAAK,CAAC,KAAK,KAAK,CAAC;EAE/C,KAAK;EACL,KAAK,aAEH,OAAO,CAAC,QAAQ,WAAW,GADfG,yCAAAA,OAAe,KAAK,KAAK,UAAU,CAAC,MAAMH,cAAAA,KAAK,oBAAoB,KAAK,MAAM,EACzD,MAAM,CAAC,KAAK,KAAK,CAAC;EAErD,KAAK,WACH,OAAO,CAAC,GAAG,WAAW,WAAW,CAAC,CAAC;EACrC,KAAK,YACH,OAAO,CAAC,GAAG,WAAW,eAAe,CAAC,CAAC;EACzC,KAAK,MACH,OAAO,CAAC,GAAG,WAAW,YAAY,CAAC,KAAK,KAAK,CAAC;EAChD,KAAK,OACH,OAAO,CAAC,GAAG,WAAW,aAAa,CAAC,KAAK,KAAK,CAAC;EACjD,KAAK,WACH,OAAO,CAAC,GAAG,WAAW,mBAAmB,KAAK,KAAK;EACrD,SACE,cAAA,YAAY,IAAI;CACpB;AACF;AAEA,SAAS,qBAAqB,GAAoB,gBAAoD;CACpG,IAAI,CAAC,gBAAgB,MAAM,IAAI,MAAM,+CAA+C;CACpF,MAAM,EAAE,KAAK,aAAa,eAAe,EAAE,QAAQ;CAEnD,OAAO,CAAC,GADO,EAAE,SAAS,eAAe,SACvB,IAAI,IAAI,IAAI,CAAC,GAAG,QAAQ,CAAC;AAC7C"}

package/build/queries/renderConditions.d.cts

@@ -0,0 +1,15 @@
+import { ParsedFindQuery } from "./find/QueryParser.cjs";
+import { ParsedExpressionFilter, ParsedValueFilter } from "./parsedConditions.cjs";
+//#region src/queries/renderConditions.d.ts
+/** Renders a ParsedFindQuery subquery to SQL — passed in to avoid circular imports with buildFindQuery. */
+type SubqueryRenderer = (q: ParsedFindQuery) => {
+  sql: string;
+  bindings: readonly any[];
+};
+/** Returns a tuple of `["cond AND (cond OR cond)", bindings]`. */
+declare function buildWhereClause(exp: ParsedExpressionFilter, topLevel?: boolean, renderSubquery?: SubqueryRenderer): [string, any[]] | undefined;
+/** Renders an encoded value filter against a SQL column expression. */
+declare function buildValueCondition(columnName: string, cond: ParsedValueFilter<unknown>): [string, any[]];
+//#endregion
+export { SubqueryRenderer, buildValueCondition, buildWhereClause };
+//# sourceMappingURL=renderConditions.d.cts.map

package/build/queries/renderConditions.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderConditions.d.cts","names":[],"sources":["../../src/queries/renderConditions.ts"],"mappings":";;;;KAcY,oBAAoB,GAAG;EAAsB;EAAa;;;iBAGtD,iBACd,KAAK,wBACL,oBACA,iBAAiB;;iBAkCH,oBAAoB,oBAAoB,MAAM"}

package/build/queries/renderConditions.d.mts

@@ -0,0 +1,15 @@
+import { ParsedFindQuery } from "./find/QueryParser.mjs";
+import { ParsedExpressionFilter, ParsedValueFilter } from "./parsedConditions.mjs";
+//#region src/queries/renderConditions.d.ts
+/** Renders a ParsedFindQuery subquery to SQL — passed in to avoid circular imports with buildFindQuery. */
+type SubqueryRenderer = (q: ParsedFindQuery) => {
+  sql: string;
+  bindings: readonly any[];
+};
+/** Returns a tuple of `["cond AND (cond OR cond)", bindings]`. */
+declare function buildWhereClause(exp: ParsedExpressionFilter, topLevel?: boolean, renderSubquery?: SubqueryRenderer): [string, any[]] | undefined;
+/** Renders an encoded value filter against a SQL column expression. */
+declare function buildValueCondition(columnName: string, cond: ParsedValueFilter<unknown>): [string, any[]];
+//#endregion
+export { SubqueryRenderer, buildValueCondition, buildWhereClause };
+//# sourceMappingURL=renderConditions.d.mts.map

package/build/queries/renderConditions.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderConditions.d.mts","names":[],"sources":["../../src/queries/renderConditions.ts"],"mappings":";;;;KAcY,oBAAoB,GAAG;EAAsB;EAAa;;;iBAGtD,iBACd,KAAK,wBACL,oBACA,iBAAiB;;iBAkCH,oBAAoB,oBAAoB,MAAM"}

package/build/queries/renderConditions.js

@@ -0,0 +1,64 @@
+import { kqDot } from "./sql/keywords.js";
+import { assertNever, fail } from "../utils.js";
+import { opToFn } from "./find/EntityGraphQLFilter.js";
+import { isDefined } from "../EntityManager.js";
+//#region src/queries/renderConditions.ts
+/** Returns a tuple of `["cond AND (cond OR cond)", bindings]`. */
+function buildWhereClause(exp, topLevel = false, renderSubquery) {
+	const tuples = exp.conditions.map((c) => {
+		return c.kind === "exp" ? buildWhereClause(c, false, renderSubquery) : c.kind === "column" ? buildCondition(c) : c.kind === "raw" ? buildRawCondition(c) : c.kind === "exists" ? buildExistsCondition(c, renderSubquery) : fail(`Invalid condition ${c}`);
+	}).filter(isDefined);
+	if (tuples.length === 0) return void 0;
+	let sql = tuples.map(([sql]) => sql).join(` ${exp.op.toUpperCase()} `);
+	if (!topLevel) sql = `(${sql})`;
+	return [sql, tuples.flatMap(([, bindings]) => bindings)];
+}
+function buildRawCondition(raw) {
+	return [raw.condition, raw.bindings];
+}
+/** Returns a tuple of `["column op ?"`, bindings]`. */
+function buildCondition(cc) {
+	const { alias, column, cond } = cc;
+	return buildValueCondition(kqDot(alias, column), cond);
+}
+/** Renders an encoded value filter against a SQL column expression. */
+function buildValueCondition(columnName, cond) {
+	switch (cond.kind) {
+		case "eq":
+		case "ne":
+		case "gte":
+		case "gt":
+		case "lte":
+		case "lt":
+		case "like":
+		case "nlike":
+		case "ilike":
+		case "nilike":
+		case "regex":
+		case "nregex":
+		case "iregex":
+		case "niregex":
+		case "jsonPathExists":
+		case "jsonPathPredicate":
+		case "contains":
+		case "containedBy":
+		case "overlaps": return [`${columnName} ${opToFn[cond.kind] ?? fail(`Invalid operator ${cond.kind}`)} ?`, [cond.value]];
+		case "noverlaps":
+		case "ncontains": return [`NOT (${columnName} ${opToFn[cond.kind.substring(1)] ?? fail(`Invalid operator ${cond.kind}`)} ?)`, [cond.value]];
+		case "is-null": return [`${columnName} IS NULL`, []];
+		case "not-null": return [`${columnName} IS NOT NULL`, []];
+		case "in": return [`${columnName} = ANY(?)`, [cond.value]];
+		case "nin": return [`${columnName} != ALL(?)`, [cond.value]];
+		case "between": return [`${columnName} BETWEEN ? AND ?`, cond.value];
+		default: assertNever(cond);
+	}
+}
+function buildExistsCondition(c, renderSubquery) {
+	if (!renderSubquery) throw new Error("EXISTS condition requires a subquery renderer");
+	const { sql, bindings } = renderSubquery(c.subquery);
+	return [`${c.negate ? "NOT EXISTS" : "EXISTS"} (${sql})`, [...bindings]];
+}
+//#endregion
+export { buildValueCondition, buildWhereClause };
+
+//# sourceMappingURL=renderConditions.js.map

package/build/queries/renderConditions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderConditions.js","names":[],"sources":["../../src/queries/renderConditions.ts"],"sourcesContent":["import { isDefined } from \"src/EntityManager.ts\";\nimport { opToFn } from \"src/queries/find/EntityGraphQLFilter.ts\";\nimport type { ParsedFindQuery } from \"src/queries/find/QueryParser.ts\";\nimport type {\n  ColumnCondition,\n  ExistsCondition,\n  ParsedExpressionFilter,\n  ParsedValueFilter,\n  RawCondition,\n} from \"src/queries/parsedConditions.ts\";\nimport { kqDot } from \"src/queries/sql/keywords.ts\";\nimport { assertNever, fail } from \"src/utils.ts\";\n\n/** Renders a ParsedFindQuery subquery to SQL — passed in to avoid circular imports with buildFindQuery. */\nexport type SubqueryRenderer = (q: ParsedFindQuery) => { sql: string; bindings: readonly any[] };\n\n/** Returns a tuple of `[\"cond AND (cond OR cond)\", bindings]`. */\nexport function buildWhereClause(\n  exp: ParsedExpressionFilter,\n  topLevel = false,\n  renderSubquery?: SubqueryRenderer,\n): [string, any[]] | undefined {\n  const tuples = exp.conditions\n    .map((c) => {\n      return c.kind === \"exp\"\n        ? buildWhereClause(c, false, renderSubquery)\n        : c.kind === \"column\"\n          ? buildCondition(c)\n          : c.kind === \"raw\"\n            ? buildRawCondition(c)\n            : c.kind === \"exists\"\n              ? buildExistsCondition(c, renderSubquery)\n              : fail(`Invalid condition ${c}`);\n    })\n    .filter(isDefined);\n  // If we don't have any conditions to combine, just return undefined;\n  if (tuples.length === 0) return undefined;\n  // Wrap/join the sql strings together first, and then flatten the bindings.\n  let sql = tuples.map(([sql]) => sql).join(` ${exp.op.toUpperCase()} `);\n  if (!topLevel) sql = `(${sql})`;\n  return [sql, tuples.flatMap(([, bindings]) => bindings)];\n}\n\nfunction buildRawCondition(raw: RawCondition): [string, readonly any[]] {\n  return [raw.condition, raw.bindings];\n}\n\n/** Returns a tuple of `[\"column op ?\"`, bindings]`. */\nfunction buildCondition(cc: ColumnCondition): [string, any[]] {\n  const { alias, column, cond } = cc;\n  return buildValueCondition(kqDot(alias, column), cond);\n}\n\n/** Renders an encoded value filter against a SQL column expression. */\nexport function buildValueCondition(columnName: string, cond: ParsedValueFilter<unknown>): [string, any[]] {\n  switch (cond.kind) {\n    case \"eq\":\n    case \"ne\":\n    case \"gte\":\n    case \"gt\":\n    case \"lte\":\n    case \"lt\":\n    case \"like\":\n    case \"nlike\":\n    case \"ilike\":\n    case \"nilike\":\n    case \"regex\":\n    case \"nregex\":\n    case \"iregex\":\n    case \"niregex\":\n    case \"jsonPathExists\":\n    case \"jsonPathPredicate\":\n    case \"contains\":\n    case \"containedBy\":\n    case \"overlaps\": {\n      const fn = opToFn[cond.kind] ?? fail(`Invalid operator ${cond.kind}`);\n      return [`${columnName} ${fn} ?`, [cond.value]];\n    }\n    case \"noverlaps\":\n    case \"ncontains\": {\n      const fn = (opToFn as any)[cond.kind.substring(1)] ?? fail(`Invalid operator ${cond.kind}`);\n      return [`NOT (${columnName} ${fn} ?)`, [cond.value]];\n    }\n    case \"is-null\":\n      return [`${columnName} IS NULL`, []];\n    case \"not-null\":\n      return [`${columnName} IS NOT NULL`, []];\n    case \"in\":\n      return [`${columnName} = ANY(?)`, [cond.value]];\n    case \"nin\":\n      return [`${columnName} != ALL(?)`, [cond.value]];\n    case \"between\":\n      return [`${columnName} BETWEEN ? AND ?`, cond.value];\n    default:\n      assertNever(cond);\n  }\n}\n\nfunction buildExistsCondition(c: ExistsCondition, renderSubquery?: SubqueryRenderer): [string, any[]] {\n  if (!renderSubquery) throw new Error(\"EXISTS condition requires a subquery renderer\");\n  const { sql, bindings } = renderSubquery(c.subquery);\n  const prefix = c.negate ? \"NOT EXISTS\" : \"EXISTS\";\n  return [`${prefix} (${sql})`, [...bindings]];\n}\n"],"mappings":";;;;;;AAiBA,SAAgB,iBACd,KACA,WAAW,OACX,gBAC6B;CAC7B,MAAM,SAAS,IAAI,WAChB,KAAK,MAAM;EACV,OAAO,EAAE,SAAS,QACd,iBAAiB,GAAG,OAAO,cAAc,IACzC,EAAE,SAAS,WACT,eAAe,CAAC,IAChB,EAAE,SAAS,QACT,kBAAkB,CAAC,IACnB,EAAE,SAAS,WACT,qBAAqB,GAAG,cAAc,IACtC,KAAK,qBAAqB,GAAG;CACzC,CAAC,CAAC,CACD,OAAO,SAAS;CAEnB,IAAI,OAAO,WAAW,GAAG,OAAO,KAAA;CAEhC,IAAI,MAAM,OAAO,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,KAAK,IAAI,IAAI,GAAG,YAAY,EAAE,EAAE;CACrE,IAAI,CAAC,UAAU,MAAM,IAAI,IAAI;CAC7B,OAAO,CAAC,KAAK,OAAO,SAAS,GAAG,cAAc,QAAQ,CAAC;AACzD;AAEA,SAAS,kBAAkB,KAA6C;CACtE,OAAO,CAAC,IAAI,WAAW,IAAI,QAAQ;AACrC;;AAGA,SAAS,eAAe,IAAsC;CAC5D,MAAM,EAAE,OAAO,QAAQ,SAAS;CAChC,OAAO,oBAAoB,MAAM,OAAO,MAAM,GAAG,IAAI;AACvD;;AAGA,SAAgB,oBAAoB,YAAoB,MAAmD;CACzG,QAAQ,KAAK,MAAb;EACE,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK,YAEH,OAAO,CAAC,GAAG,WAAW,GADX,OAAO,KAAK,SAAS,KAAK,oBAAoB,KAAK,MAAM,EACxC,KAAK,CAAC,KAAK,KAAK,CAAC;EAE/C,KAAK;EACL,KAAK,aAEH,OAAO,CAAC,QAAQ,WAAW,GADf,OAAe,KAAK,KAAK,UAAU,CAAC,MAAM,KAAK,oBAAoB,KAAK,MAAM,EACzD,MAAM,CAAC,KAAK,KAAK,CAAC;EAErD,KAAK,WACH,OAAO,CAAC,GAAG,WAAW,WAAW,CAAC,CAAC;EACrC,KAAK,YACH,OAAO,CAAC,GAAG,WAAW,eAAe,CAAC,CAAC;EACzC,KAAK,MACH,OAAO,CAAC,GAAG,WAAW,YAAY,CAAC,KAAK,KAAK,CAAC;EAChD,KAAK,OACH,OAAO,CAAC,GAAG,WAAW,aAAa,CAAC,KAAK,KAAK,CAAC;EACjD,KAAK,WACH,OAAO,CAAC,GAAG,WAAW,mBAAmB,KAAK,KAAK;EACrD,SACE,YAAY,IAAI;CACpB;AACF;AAEA,SAAS,qBAAqB,GAAoB,gBAAoD;CACpG,IAAI,CAAC,gBAAgB,MAAM,IAAI,MAAM,+CAA+C;CACpF,MAAM,EAAE,KAAK,aAAa,eAAe,EAAE,QAAQ;CAEnD,OAAO,CAAC,GADO,EAAE,SAAS,eAAe,SACvB,IAAI,IAAI,IAAI,CAAC,GAAG,QAAQ,CAAC;AAC7C"}

package/build/queries/skipCondition.cjs

@@ -0,0 +1,14 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/queries/skipCondition.ts
+/** An undefined predicate is pruned by either query parser. */
+const skipCondition = {
+	kind: "column",
+	alias: "skip",
+	column: "skip",
+	dbType: "skip",
+	cond: void 0
+};
+//#endregion
+exports.skipCondition = skipCondition;
+
+//# sourceMappingURL=skipCondition.cjs.map

package/build/queries/skipCondition.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"skipCondition.cjs","names":[],"sources":["../../src/queries/skipCondition.ts"],"sourcesContent":["import type { ColumnCondition } from \"src/queries/parsedConditions.ts\";\n\n/** An undefined predicate is pruned by either query parser. */\nexport const skipCondition: ColumnCondition = {\n  kind: \"column\",\n  alias: \"skip\",\n  column: \"skip\",\n  dbType: \"skip\",\n  cond: undefined as any,\n};\n"],"mappings":";;;AAGA,MAAa,gBAAiC;CAC5C,MAAM;CACN,OAAO;CACP,QAAQ;CACR,QAAQ;CACR,MAAM,KAAA;AACR"}

package/build/queries/skipCondition.d.cts

@@ -0,0 +1,7 @@
+import { ColumnCondition } from "./parsedConditions.cjs";
+//#region src/queries/skipCondition.d.ts
+/** An undefined predicate is pruned by either query parser. */
+declare const skipCondition: ColumnCondition;
+//#endregion
+export { skipCondition };
+//# sourceMappingURL=skipCondition.d.cts.map

package/build/queries/skipCondition.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skipCondition.d.cts","names":[],"sources":["../../src/queries/skipCondition.ts"],"mappings":";;;cAGa,eAAe"}

package/build/queries/skipCondition.d.mts

@@ -0,0 +1,7 @@
+import { ColumnCondition } from "./parsedConditions.mjs";
+//#region src/queries/skipCondition.d.ts
+/** An undefined predicate is pruned by either query parser. */
+declare const skipCondition: ColumnCondition;
+//#endregion
+export { skipCondition };
+//# sourceMappingURL=skipCondition.d.mts.map

package/build/queries/skipCondition.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skipCondition.d.mts","names":[],"sources":["../../src/queries/skipCondition.ts"],"mappings":";;;cAGa,eAAe"}

package/build/queries/skipCondition.js

@@ -0,0 +1,13 @@
+//#region src/queries/skipCondition.ts
+/** An undefined predicate is pruned by either query parser. */
+const skipCondition = {
+	kind: "column",
+	alias: "skip",
+	column: "skip",
+	dbType: "skip",
+	cond: void 0
+};
+//#endregion
+export { skipCondition };
+
+//# sourceMappingURL=skipCondition.js.map

package/build/queries/skipCondition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skipCondition.js","names":[],"sources":["../../src/queries/skipCondition.ts"],"sourcesContent":["import type { ColumnCondition } from \"src/queries/parsedConditions.ts\";\n\n/** An undefined predicate is pruned by either query parser. */\nexport const skipCondition: ColumnCondition = {\n  kind: \"column\",\n  alias: \"skip\",\n  column: \"skip\",\n  dbType: \"skip\",\n  cond: undefined as any,\n};\n"],"mappings":";;AAGA,MAAa,gBAAiC;CAC5C,MAAM;CACN,OAAO;CACP,QAAQ;CACR,QAAQ;CACR,MAAM,KAAA;AACR"}

package/build/queries/sql/AliasAssigner.cjs

@@ -0,0 +1,35 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_utils = require("../../utils.cjs");
+//#region src/queries/sql/AliasAssigner.ts
+var AliasAssigner = class {
+	#aliases = {};
+	constructor(query) {
+		this.getAlias = this.getAlias.bind(this);
+		this.getLiteralAlias = this.getLiteralAlias.bind(this);
+		if (query) for (const table of query.tables) {
+			if (table.alias.includes("_")) continue;
+			const abbrev = require_utils.abbreviation(table.table);
+			const i = this.#aliases[abbrev] || 0;
+			const j = Number(table.alias.replace(abbrev, "")) + 1;
+			this.#aliases[abbrev] = Math.max(i, j);
+		}
+	}
+	/** Returns an abbreviated alias for a table name, e.g. `"books"` → `"b"`, `"book_reviews"` → `"br"`. */
+	getAlias(tableName) {
+		const abbrev = require_utils.abbreviation(tableName);
+		return this.#nextAlias(abbrev);
+	}
+	/** Returns an alias using the name as-is (no abbreviation), e.g. `"prequel"` → `"prequel"`. */
+	getLiteralAlias(name) {
+		return this.#nextAlias(name);
+	}
+	#nextAlias(key) {
+		const i = this.#aliases[key] || 0;
+		this.#aliases[key] = i + 1;
+		return i === 0 ? key : `${key}${i}`;
+	}
+};
+//#endregion
+exports.AliasAssigner = AliasAssigner;
+
+//# sourceMappingURL=AliasAssigner.cjs.map

package/build/queries/sql/AliasAssigner.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"AliasAssigner.cjs","names":["abbreviation","#aliases","#nextAlias"],"sources":["../../../src/queries/sql/AliasAssigner.ts"],"sourcesContent":["import type { ParsedFindQuery } from \"src/queries/find/QueryParser.ts\";\nimport { abbreviation } from \"src/utils.ts\";\n\nexport class AliasAssigner {\n  #aliases: Record<string, number> = {};\n\n  constructor(query?: ParsedFindQuery) {\n    this.getAlias = this.getAlias.bind(this);\n    this.getLiteralAlias = this.getLiteralAlias.bind(this);\n    // If we're assigning aliases into an existing query, get the current assignments\n    if (query) {\n      for (const table of query.tables) {\n        // Ignore CTI base/sub aliases\n        if (table.alias.includes(\"_\")) continue;\n        const abbrev = abbreviation(table.table);\n        const i = this.#aliases[abbrev] || 0;\n        const j = Number(table.alias.replace(abbrev, \"\")) + 1;\n        this.#aliases[abbrev] = Math.max(i, j);\n      }\n    }\n  }\n\n  /** Returns an abbreviated alias for a table name, e.g. `\"books\"` → `\"b\"`, `\"book_reviews\"` → `\"br\"`. */\n  getAlias(tableName: string): string {\n    const abbrev = abbreviation(tableName);\n    return this.#nextAlias(abbrev);\n  }\n\n  /** Returns an alias using the name as-is (no abbreviation), e.g. `\"prequel\"` → `\"prequel\"`. */\n  getLiteralAlias(name: string): string {\n    return this.#nextAlias(name);\n  }\n\n  #nextAlias(key: string): string {\n    const i = this.#aliases[key] || 0;\n    this.#aliases[key] = i + 1;\n    return i === 0 ? key : `${key}${i}`;\n  }\n}\n"],"mappings":";;;AAGA,IAAa,gBAAb,MAA2B;CACzB,WAAmC,CAAC;CAEpC,YAAY,OAAyB;EACnC,KAAK,WAAW,KAAK,SAAS,KAAK,IAAI;EACvC,KAAK,kBAAkB,KAAK,gBAAgB,KAAK,IAAI;EAErD,IAAI,OACF,KAAK,MAAM,SAAS,MAAM,QAAQ;GAEhC,IAAI,MAAM,MAAM,SAAS,GAAG,GAAG;GAC/B,MAAM,SAASA,cAAAA,aAAa,MAAM,KAAK;GACvC,MAAM,IAAI,KAAKC,SAAS,WAAW;GACnC,MAAM,IAAI,OAAO,MAAM,MAAM,QAAQ,QAAQ,EAAE,CAAC,IAAI;GACpD,KAAKA,SAAS,UAAU,KAAK,IAAI,GAAG,CAAC;EACvC;CAEJ;;CAGA,SAAS,WAA2B;EAClC,MAAM,SAASD,cAAAA,aAAa,SAAS;EACrC,OAAO,KAAKE,WAAW,MAAM;CAC/B;;CAGA,gBAAgB,MAAsB;EACpC,OAAO,KAAKA,WAAW,IAAI;CAC7B;CAEA,WAAW,KAAqB;EAC9B,MAAM,IAAI,KAAKD,SAAS,QAAQ;EAChC,KAAKA,SAAS,OAAO,IAAI;EACzB,OAAO,MAAM,IAAI,MAAM,GAAG,MAAM;CAClC;AACF"}

package/build/queries/sql/AliasAssigner.d.cts

@@ -0,0 +1,13 @@
+import { ParsedFindQuery } from "../find/QueryParser.cjs";
+//#region src/queries/sql/AliasAssigner.d.ts
+declare class AliasAssigner {
+  #private;
+  constructor(query?: ParsedFindQuery);
+  /** Returns an abbreviated alias for a table name, e.g. `"books"` → `"b"`, `"book_reviews"` → `"br"`. */
+  getAlias(tableName: string): string;
+  /** Returns an alias using the name as-is (no abbreviation), e.g. `"prequel"` → `"prequel"`. */
+  getLiteralAlias(name: string): string;
+}
+//#endregion
+export { AliasAssigner };
+//# sourceMappingURL=AliasAssigner.d.cts.map

package/build/queries/sql/AliasAssigner.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AliasAssigner.d.cts","names":[],"sources":["../../../src/queries/sql/AliasAssigner.ts"],"mappings":";;cAGa;;EAGX,YAAY,QAAQ;;EAiBpB,SAAS;;EAMT,gBAAgB"}

package/build/queries/sql/AliasAssigner.d.mts

@@ -0,0 +1,13 @@
+import { ParsedFindQuery } from "../find/QueryParser.mjs";
+//#region src/queries/sql/AliasAssigner.d.ts
+declare class AliasAssigner {
+  #private;
+  constructor(query?: ParsedFindQuery);
+  /** Returns an abbreviated alias for a table name, e.g. `"books"` → `"b"`, `"book_reviews"` → `"br"`. */
+  getAlias(tableName: string): string;
+  /** Returns an alias using the name as-is (no abbreviation), e.g. `"prequel"` → `"prequel"`. */
+  getLiteralAlias(name: string): string;
+}
+//#endregion
+export { AliasAssigner };
+//# sourceMappingURL=AliasAssigner.d.mts.map

package/build/queries/sql/AliasAssigner.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AliasAssigner.d.mts","names":[],"sources":["../../../src/queries/sql/AliasAssigner.ts"],"mappings":";;cAGa;;EAGX,YAAY,QAAQ;;EAiBpB,SAAS;;EAMT,gBAAgB"}

package/build/queries/sql/AliasAssigner.js

@@ -0,0 +1,34 @@
+import { abbreviation } from "../../utils.js";
+//#region src/queries/sql/AliasAssigner.ts
+var AliasAssigner = class {
+	#aliases = {};
+	constructor(query) {
+		this.getAlias = this.getAlias.bind(this);
+		this.getLiteralAlias = this.getLiteralAlias.bind(this);
+		if (query) for (const table of query.tables) {
+			if (table.alias.includes("_")) continue;
+			const abbrev = abbreviation(table.table);
+			const i = this.#aliases[abbrev] || 0;
+			const j = Number(table.alias.replace(abbrev, "")) + 1;
+			this.#aliases[abbrev] = Math.max(i, j);
+		}
+	}
+	/** Returns an abbreviated alias for a table name, e.g. `"books"` → `"b"`, `"book_reviews"` → `"br"`. */
+	getAlias(tableName) {
+		const abbrev = abbreviation(tableName);
+		return this.#nextAlias(abbrev);
+	}
+	/** Returns an alias using the name as-is (no abbreviation), e.g. `"prequel"` → `"prequel"`. */
+	getLiteralAlias(name) {
+		return this.#nextAlias(name);
+	}
+	#nextAlias(key) {
+		const i = this.#aliases[key] || 0;
+		this.#aliases[key] = i + 1;
+		return i === 0 ? key : `${key}${i}`;
+	}
+};
+//#endregion
+export { AliasAssigner };
+
+//# sourceMappingURL=AliasAssigner.js.map

package/build/queries/sql/AliasAssigner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AliasAssigner.js","names":["#aliases","#nextAlias"],"sources":["../../../src/queries/sql/AliasAssigner.ts"],"sourcesContent":["import type { ParsedFindQuery } from \"src/queries/find/QueryParser.ts\";\nimport { abbreviation } from \"src/utils.ts\";\n\nexport class AliasAssigner {\n  #aliases: Record<string, number> = {};\n\n  constructor(query?: ParsedFindQuery) {\n    this.getAlias = this.getAlias.bind(this);\n    this.getLiteralAlias = this.getLiteralAlias.bind(this);\n    // If we're assigning aliases into an existing query, get the current assignments\n    if (query) {\n      for (const table of query.tables) {\n        // Ignore CTI base/sub aliases\n        if (table.alias.includes(\"_\")) continue;\n        const abbrev = abbreviation(table.table);\n        const i = this.#aliases[abbrev] || 0;\n        const j = Number(table.alias.replace(abbrev, \"\")) + 1;\n        this.#aliases[abbrev] = Math.max(i, j);\n      }\n    }\n  }\n\n  /** Returns an abbreviated alias for a table name, e.g. `\"books\"` → `\"b\"`, `\"book_reviews\"` → `\"br\"`. */\n  getAlias(tableName: string): string {\n    const abbrev = abbreviation(tableName);\n    return this.#nextAlias(abbrev);\n  }\n\n  /** Returns an alias using the name as-is (no abbreviation), e.g. `\"prequel\"` → `\"prequel\"`. */\n  getLiteralAlias(name: string): string {\n    return this.#nextAlias(name);\n  }\n\n  #nextAlias(key: string): string {\n    const i = this.#aliases[key] || 0;\n    this.#aliases[key] = i + 1;\n    return i === 0 ? key : `${key}${i}`;\n  }\n}\n"],"mappings":";;AAGA,IAAa,gBAAb,MAA2B;CACzB,WAAmC,CAAC;CAEpC,YAAY,OAAyB;EACnC,KAAK,WAAW,KAAK,SAAS,KAAK,IAAI;EACvC,KAAK,kBAAkB,KAAK,gBAAgB,KAAK,IAAI;EAErD,IAAI,OACF,KAAK,MAAM,SAAS,MAAM,QAAQ;GAEhC,IAAI,MAAM,MAAM,SAAS,GAAG,GAAG;GAC/B,MAAM,SAAS,aAAa,MAAM,KAAK;GACvC,MAAM,IAAI,KAAKA,SAAS,WAAW;GACnC,MAAM,IAAI,OAAO,MAAM,MAAM,QAAQ,QAAQ,EAAE,CAAC,IAAI;GACpD,KAAKA,SAAS,UAAU,KAAK,IAAI,GAAG,CAAC;EACvC;CAEJ;;CAGA,SAAS,WAA2B;EAClC,MAAM,SAAS,aAAa,SAAS;EACrC,OAAO,KAAKC,WAAW,MAAM;CAC/B;;CAGA,gBAAgB,MAAsB;EACpC,OAAO,KAAKA,WAAW,IAAI;CAC7B;CAEA,WAAW,KAAqB;EAC9B,MAAM,IAAI,KAAKD,SAAS,QAAQ;EAChC,KAAKA,SAAS,OAAO,IAAI;EACzB,OAAO,MAAM,IAAI,MAAM,GAAG,MAAM;CAClC;AACF"}