@voltro/database 0.84.0 → 0.86.0

package/dist/sqlCompiler.js

@@ -0,0 +1,343 @@
+import { columnComparisonOperators as e, isColumnReference as t } from "./columnReference.js";
+import { authoredError as n } from "./dbCause.js";
+import { getTable as r } from "./tableRegistry.js";
+import { orderClausesOf as i } from "./queryBuilder.js";
+import { prepareProjectedColumn as a } from "./projectedColumn.js";
+import { hasEncodedSqliteDecimalSource as o } from "./sqliteDecimalQueryPlan.js";
+import { coerceValueForSqlite as s } from "./sqliteValueCoercion.js";
+import { jsonPathSql as c } from "./jsonPath.js";
+import { qualifyTable as l } from "./namespace.js";
+import { coercePredicateValue as u } from "./predicateCoercion.js";
+import { mssqlDecimalDistinct as d } from "./mssqlDecimalDistinct.js";
+import { compileSqliteDecimalSourcePredicate as f } from "./sqliteDecimalSource.js";
+import { compileSqliteDecimalQuery as p } from "./sqliteDecimalQuery.js";
+//#region src/sqlCompiler.ts
+var m = (e) => e.replace(/[A-Z]/g, (e) => e.toLowerCase()), h = (e, t) => {
+	let { strings: n, values: r } = e, i = t.unsafe(n[0] ?? "");
+	for (let e = 0; e < r.length; e++) i = t`${i}${r[e]}${t.unsafe(n[e + 1] ?? "")}`;
+	return t`${i}`;
+}, g = (e) => e.replace(/[\\%_]/g, (e) => `\\${e}`), _ = (i, a, o = null, l, d = /* @__PURE__ */ new Set()) => {
+	if ("not" in i) return a`NOT (${_(i.not, a, o, l, d)})`;
+	if ("and" in i) return i.and.length === 0 ? a`TRUE` : a.and(i.and.map((e) => _(e, a, o, l, d)));
+	if ("or" in i) return i.or.length === 0 ? a`FALSE` : a.or(i.or.map((e) => _(e, a, o, l, d)));
+	if (i.op === "subquery-in" || i.op === "subquery-not-in") {
+		let e = i, t = M(e.subquery, a, o, void 0, d);
+		return e.op === "subquery-in" ? a`${a(e.column)} IN (${t})` : a`${a(e.column)} NOT IN (${t})`;
+	}
+	if (i.op === "exists" || i.op === "not-exists") {
+		let e = i, t = M(e.subquery, a, o, void 0, d);
+		return e.op === "exists" ? a`EXISTS (${t})` : a`NOT EXISTS (${t})`;
+	}
+	let f = i;
+	if (t(f.value)) {
+		if (!e.some((e) => e === f.op) || f.path !== void 0) throw n("Column references require a scalar comparison without a JSON path");
+		let t = a(f.value.column), r = a(f.column);
+		switch (f.op) {
+			case "eq": return a`${r} = ${t}`;
+			case "neq": return a`${r} <> ${t}`;
+			case "gt": return a`${r} > ${t}`;
+			case "gte": return a`${r} >= ${t}`;
+			case "lt": return a`${r} < ${t}`;
+			case "lte": return a`${r} <= ${t}`;
+		}
+	}
+	let p = a(f.column), m = f.path, h = m !== void 0 && m.length > 0, v = () => a.onDialectOrElse({
+		mysql: () => a.unsafe(c(f.column, m, "mysql")),
+		mssql: () => a.unsafe(c(f.column, m, "mssql")),
+		sqlite: () => a.unsafe(c(f.column, m, "sqlite")),
+		orElse: () => a.unsafe(c(f.column, m, "postgres"))
+	}), y = () => a.onDialectOrElse({
+		mysql: () => a.unsafe(c(f.column, m, "mysql", { numeric: !0 })),
+		mssql: () => a.unsafe(c(f.column, m, "mssql", { numeric: !0 })),
+		sqlite: () => a.unsafe(c(f.column, m, "sqlite", { numeric: !0 })),
+		orElse: () => a.unsafe(c(f.column, m, "postgres", { numeric: !0 }))
+	}), b = h ? v() : p, x = h ? y() : p, S = (e) => h && e != null ? String(e) : e, C = (e) => h ? Number(e) : e, w = h || l === void 0 ? void 0 : r(l)?.fields?.[f.column]?.type, T = (e) => {
+		let t = u(w, e);
+		return t instanceof Date ? a.onDialectOrElse({
+			sqlite: () => s(t),
+			orElse: () => t
+		}) : t;
+	};
+	switch (f.op) {
+		case "eq": return a`${b} = ${S(T(f.value))}`;
+		case "neq": return a`${b} <> ${S(T(f.value))}`;
+		case "gt": return a`${x} > ${C(T(f.value))}`;
+		case "gte": return a`${x} >= ${C(T(f.value))}`;
+		case "lt": return a`${x} < ${C(T(f.value))}`;
+		case "lte": return a`${x} <= ${C(T(f.value))}`;
+		case "in": {
+			let e = f.value ?? [];
+			return e.length === 0 ? a`FALSE` : a`${b} IN ${a.in(h ? e.map((e) => S(e)) : e.map(T))}`;
+		}
+		case "notIn": {
+			let e = f.value ?? [];
+			return e.length === 0 ? a`TRUE` : a`${b} NOT IN ${a.in(h ? e.map((e) => S(e)) : e.map(T))}`;
+		}
+		case "contains": {
+			let e = `%${g(typeof f.value == "string" ? f.value : String(f.value ?? ""))}%`;
+			return a.onDialectOrElse({
+				mysql: () => a`LOWER(${b}) LIKE LOWER(${e})`,
+				mssql: () => a`LOWER(${b}) LIKE LOWER(${e})`,
+				sqlite: () => a`LOWER(${b}) LIKE LOWER(${e})`,
+				orElse: () => a`${b} ILIKE ${e} ESCAPE '\\'`
+			});
+		}
+		case "startsWith": {
+			let e = `${g(typeof f.value == "string" ? f.value : String(f.value ?? ""))}%`;
+			return a.onDialectOrElse({
+				mysql: () => a`${b} LIKE ${e}`,
+				orElse: () => a`${b} LIKE ${e} ESCAPE '\\'`
+			});
+		}
+		case "arrayContains": {
+			let e = f.value ?? [];
+			return e.length === 0 ? a`TRUE` : a.onDialectOrElse({
+				mysql: () => a`JSON_CONTAINS(${b}, ${JSON.stringify(e)})`,
+				mssql: () => a`(SELECT COUNT(DISTINCT value) FROM OPENJSON(${b}) WHERE value IN ${a.in(e)}) = ${e.length}`,
+				sqlite: () => a`(SELECT COUNT(DISTINCT value) FROM json_each(${b}) WHERE value IN ${a.in(e)}) = ${e.length}`,
+				orElse: () => a`${b} @> ${e}`
+			});
+		}
+		case "arrayOverlaps": {
+			let e = f.value ?? [];
+			return e.length === 0 ? a`FALSE` : a.onDialectOrElse({
+				mysql: () => a.or(e.map((e) => a`JSON_CONTAINS(${b}, ${JSON.stringify(e)})`)),
+				mssql: () => a`EXISTS (SELECT 1 FROM OPENJSON(${b}) WHERE value IN ${a.in(e)})`,
+				sqlite: () => a`EXISTS (SELECT 1 FROM json_each(${b}) WHERE value IN ${a.in(e)})`,
+				orElse: () => a`${b} && ${e}`
+			});
+		}
+		case "arrayHas": return a.onDialectOrElse({
+			mysql: () => a`JSON_CONTAINS(${b}, ${JSON.stringify(f.value)})`,
+			mssql: () => a`${f.value} IN (SELECT value FROM OPENJSON(${b}))`,
+			sqlite: () => a`EXISTS (SELECT 1 FROM json_each(${b}) WHERE value = ${f.value})`,
+			orElse: () => a`${f.value} = ANY(${b})`
+		});
+		case "isNull": return a`${b} IS NULL`;
+		case "isNotNull": return a`${b} IS NOT NULL`;
+		case "spatial": {
+			let e = f.value, t = a.unsafe("::geometry"), r = e.bufferMeters === void 0 ? a`${e.geom}${t}` : a`ST_Buffer(${e.geom}::geography, ${e.bufferMeters})::geometry`;
+			return a.onDialectOrElse({
+				mysql: () => {
+					throw n("@voltro/plugin-postgis: spatial predicates are postgres-only");
+				},
+				mssql: () => {
+					throw n("@voltro/plugin-postgis: spatial predicates are postgres-only");
+				},
+				sqlite: () => {
+					throw n("@voltro/plugin-postgis: spatial predicates are postgres-only");
+				},
+				orElse: () => e.fn === "ST_DWithin" ? a`ST_DWithin(${p}::geography, ${e.geom}::geography, ${e.distanceMeters})` : e.fn === "&&" ? a`${p}${t} && ${r}` : a`${a.unsafe(e.fn)}(${p}${t}, ${r})`
+			});
+		}
+	}
+}, v = (e, t) => {
+	let n = [];
+	return e.partitionBy && e.partitionBy.length > 0 && n.push(t`PARTITION BY ${t.join(", ", !1)(e.partitionBy.map((e) => t`${t(e)}`))}`), e.orderBy && e.orderBy.length > 0 && n.push(t`ORDER BY ${t.join(", ", !1)(e.orderBy.map((e) => e.direction === "desc" ? t`${t(e.column)} DESC` : t`${t(e.column)} ASC`))}`), n.length === 0 ? t`` : n.length === 1 ? n[0] : n.reduce((e, n, r) => r === 0 ? n : t`${e} ${n}`);
+}, y = (e, t) => t.join(", ", !1)(e.map((e) => {
+	let r = e.column === void 0 ? t.unsafe("*") : t`${t(e.column)}`;
+	if (e.op.startsWith("window-")) {
+		let i = v(e.window ?? {}, t);
+		switch (e.op) {
+			case "window-row-number": return t`ROW_NUMBER() OVER (${i}) AS ${t(e.alias)}`;
+			case "window-rank": return t`RANK() OVER (${i}) AS ${t(e.alias)}`;
+			case "window-dense-rank": return t`DENSE_RANK() OVER (${i}) AS ${t(e.alias)}`;
+			case "window-lag": return t`LAG(${r}, ${t.unsafe(String(e.offset ?? 1))}) OVER (${i}) AS ${t(e.alias)}`;
+			case "window-lead": return t`LEAD(${r}, ${t.unsafe(String(e.offset ?? 1))}) OVER (${i}) AS ${t(e.alias)}`;
+			case "window-sum-over": return t`SUM(${r}) OVER (${i}) AS ${t(e.alias)}`;
+			case "window-avg-over": return t`AVG(${r}) OVER (${i}) AS ${t(e.alias)}`;
+			default: throw n(`compileAggregateProjection: unknown window op '${e.op}'`);
+		}
+	}
+	switch (e.op) {
+		case "count": return t`COUNT(${r}) AS ${t(e.alias)}`;
+		case "count-distinct": return t`COUNT(DISTINCT ${r}) AS ${t(e.alias)}`;
+		case "sum": return t`SUM(${r}) AS ${t(e.alias)}`;
+		case "avg": return t`AVG(${r}) AS ${t(e.alias)}`;
+		case "min": return t`MIN(${r}) AS ${t(e.alias)}`;
+		case "max": return t`MAX(${r}) AS ${t(e.alias)}`;
+		case "column":
+			if (e.column === void 0) throw n(`compileAggregateProjection: 'column' projection requires a column name (alias '${e.alias}')`);
+			return t`${t(e.column)} AS ${t(e.alias)}`;
+		default: throw n(`compileAggregateProjection: unknown op '${e.op}'`);
+	}
+})), b = (e) => `[${e.join(",")}]`, x = (e, t) => {
+	if (e.queryVector === void 0) return null;
+	let n = t(e.column), r = b(e.queryVector), i = e.distance === "cosine" ? "<=>" : e.distance === "l2" ? "<->" : "<#>", a = e.distance === "cosine" ? "VEC_DISTANCE_COSINE" : "VEC_DISTANCE_EUCLIDEAN";
+	return t.onDialectOrElse({
+		mysql: () => t`${t.unsafe(a)}(${n}, ${r})`,
+		mssql: () => t`NULL`,
+		sqlite: () => t`NULL`,
+		orElse: () => t`${n} ${t.unsafe(i)} ${r}::vector`
+	});
+}, S = (e, t) => {
+	let n = t.unsafe(e.useGeography ? "::geography" : "::geometry");
+	return t`ST_Distance(${t(e.column)}${n}, ${e.geom}${n})`;
+}, C = (e, t) => t`${t(e.column)} <-> ${e.geom}::geometry`, w = (e, t) => t`${t(`${e.indexName}_tsv`)}`, T = (e, t) => `${t}_${e.indexName}_fts`, E = (e) => e.toLowerCase().split(/[^\p{L}\p{N}]+/u).filter((e) => e !== ""), D = (e) => {
+	if (e.prefix !== !0) return;
+	let t = E(e.query);
+	if (t.length !== 0) return {
+		pg: t.map((e) => `${e}:*`).join(" & "),
+		mysql: t.map((e) => `+${e}*`).join(" "),
+		sqlite: t.map((e) => `"${e}"*`).join(" ")
+	};
+}, O = (e, t, n) => {
+	let r = n.join(", ", !1)(e.columns.map((e) => n`${n(e)}`)), i = `%${g(e.query)}%`, a = D(e), o = () => n.or(e.columns.map((e) => n`LOWER(${n(e)}) LIKE LOWER(${i}) ESCAPE '\\'`));
+	return e.fallback === "like" ? o() : n.onDialectOrElse({
+		mysql: () => a === void 0 ? n`MATCH(${r}) AGAINST(${e.query} IN NATURAL LANGUAGE MODE)` : n`MATCH(${r}) AGAINST(${a.mysql} IN BOOLEAN MODE)`,
+		sqlite: () => {
+			let r = n(T(e, t));
+			return n`${n("id")} IN (SELECT ${n("row_id")} FROM ${r} WHERE ${r} MATCH ${a?.sqlite ?? e.query})`;
+		},
+		mssql: o,
+		orElse: () => a === void 0 ? n`${w(e, n)} @@ plainto_tsquery(${e.config ?? "english"}, ${e.query})` : n`${w(e, n)} @@ to_tsquery(${e.config ?? "english"}, ${a.pg})`
+	});
+}, k = (e, t, n) => {
+	let r = `%${g(e.query)}%`, i = D(e), a = () => e.columns.map((e) => n`(CASE WHEN LOWER(${n(e)}) LIKE LOWER(${r}) ESCAPE '\\' THEN 1 ELSE 0 END)`).reduce((e, t, r) => r === 0 ? t : n`${e} + ${t}`);
+	return e.fallback === "like" ? a() : n.onDialectOrElse({
+		mysql: () => i === void 0 ? n`MATCH(${n.join(", ", !1)(e.columns.map((e) => n`${n(e)}`))}) AGAINST(${e.query} IN NATURAL LANGUAGE MODE)` : n`MATCH(${n.join(", ", !1)(e.columns.map((e) => n`${n(e)}`))}) AGAINST(${i.mysql} IN BOOLEAN MODE)`,
+		sqlite: () => {
+			let r = n(T(e, t));
+			return n`COALESCE((SELECT -bm25(${r}) FROM ${r} WHERE ${r} MATCH ${i?.sqlite ?? e.query} AND ${r}.${n("row_id")} = ${n("id")}), 0)`;
+		},
+		mssql: a,
+		orElse: () => i === void 0 ? n`ts_rank(${w(e, n)}, plainto_tsquery(${e.config ?? "english"}, ${e.query}))` : n`ts_rank(${w(e, n)}, to_tsquery(${e.config ?? "english"}, ${i.pg}))`
+	});
+}, A = (e, t, n, r, i = !1) => {
+	let a = (e) => t(r && !e.includes(".") ? `${r}.${e}` : e), o = () => n?.length ? t.join(", ", !1)(n.map((e) => t`${a(e)}`)) : r ? t`${t(r)}.*` : t`*`, s = i && t.onDialectOrElse({
+		mssql: () => !0,
+		orElse: () => !1
+	});
+	return !e || !Object.values(e).some((e) => e.type === "bigint" || s && e.type === "decimal") ? o() : t.onDialectOrElse({
+		sqlite: () => t.join(", ", !1)((n?.length ? n : Object.keys(e)).map((n) => e[n]?.type === "bigint" ? t`CAST(${a(n)} AS TEXT) AS ${t(n)}` : t`${a(n)} AS ${t(n.slice(n.lastIndexOf(".") + 1))}`)),
+		mssql: () => s && Object.values(e).some((e) => e.type === "decimal") ? t.join(", ", !1)((n?.length ? n : Object.keys(e)).map((n) => e[n]?.type === "decimal" ? t`CONVERT(varchar(80), ${a(n)}) AS ${t(n)}` : t`${a(n)}`)) : o(),
+		orElse: o
+	});
+}, j = (e, t, n) => A(r(e)?.fields, t, n), M = (e, t, o = null, s, c = /* @__PURE__ */ new Set(), u = !1) => {
+	let d = a(e), f = /* @__PURE__ */ new Set([...c, ...(e.ctes ?? []).map((e) => m(e.name))]), p = (e) => f.has(m(e)) ? e : l(o, e), h = (e.ctes ?? []).map((e) => t`${t(e.name)} AS (${M(e.descriptor, t, o, e.recursive && t.onDialectOrElse({
+		sqlite: () => !0,
+		orElse: () => !1
+	}) ? e.name : void 0, f)})`), g = (e.ctes ?? []).some((e) => e.recursive === !0), v = h.length > 0 ? t`WITH ${t.unsafe(g ? "RECURSIVE " : "")}${t.join(", ", !1)(h)} ` : t``;
+	if (e.setOp && e.setOp.queries.length >= 2) {
+		let r = e.setOp.kind === "union" ? "UNION" : e.setOp.kind === "union-all" ? "UNION ALL" : e.setOp.kind === "intersect" ? "INTERSECT" : "EXCEPT", a = t.onDialectOrElse({
+			sqlite: () => !0,
+			orElse: () => !1
+		}), c = e.setOp.queries.map((e) => {
+			if (!a) return t`(${M(e, t, o, void 0, f)})`;
+			if (s !== void 0) {
+				if (!(i(e).length > 0 || e.take !== void 0 || e.skip !== void 0 || e.setOp !== void 0 || (e.ctes?.length ?? 0) > 0)) return M(e, t, o, void 0, f);
+				let r = (e) => e.replace(/[A-Z]/g, (e) => e.toLowerCase()), a = (e) => r(e) === r(s);
+				if (a(e.table) || e.joins?.some((e) => a(e.table))) throw n("Recursive SQLite terms cannot use branch-local ordering, pagination or nested compounds; apply ordering and pagination to the recursive compound or its outer query");
+			}
+			return t`SELECT * FROM (${M(e, t, o, void 0, f)})`;
+		}).reduce((e, n, i) => i === 0 ? n : t`${e} ${t.unsafe(r)} ${n}`), l = [];
+		if (i(e).length > 0 && l.push(t` ORDER BY ${t.join(", ", !1)(i(e).map((e) => e.direction === "desc" ? t`${t(e.column)} DESC` : t`${t(e.column)} ASC`))}`), e.take !== void 0) {
+			if (!Number.isInteger(e.take) || e.take < 0) throw n(`compileSelect: invalid take ${e.take}`);
+			l.push(t` LIMIT ${t.unsafe(String(e.take))}`);
+		}
+		if (e.skip !== void 0) {
+			if (a && e.take === void 0 && l.push(t` LIMIT -1`), !Number.isInteger(e.skip) || e.skip < 0) throw n(`compileSelect: invalid skip ${e.skip}`);
+			l.push(t` OFFSET ${t.unsafe(String(e.skip))}`);
+		}
+		return t`${v}${c}${l.reduce((e, n) => t`${e}${n}`, t``)}`;
+	}
+	let b = e.annClause === void 0 ? null : x(e.annClause, t);
+	e.spatialClause !== void 0 && t.onDialectOrElse({
+		mysql: () => {
+			throw n("@voltro/plugin-postgis: spatial distance / KNN ordering is postgres-only");
+		},
+		mssql: () => {
+			throw n("@voltro/plugin-postgis: spatial distance / KNN ordering is postgres-only");
+		},
+		sqlite: () => {
+			throw n("@voltro/plugin-postgis: spatial distance / KNN ordering is postgres-only");
+		},
+		orElse: () => t``
+	});
+	let w = e.spatialClause?.projectAs === void 0 ? null : S(e.spatialClause, t), T = e.aggregations && e.aggregations.length > 0 ? y(e.aggregations, t) : e.joinedProjection && e.joinedProjection.length > 0 ? t.join(", ", !1)(e.joinedProjection.map((e) => {
+		let n = t`${t(e.source)}`, r = d(e.source);
+		return t`${u && r?.type === "decimal" ? t.onDialectOrElse({
+			mssql: () => t`CONVERT(varchar(80), ${n})`,
+			orElse: () => n
+		}) : r?.type === "bigint" ? t.onDialectOrElse({
+			sqlite: () => t`CAST(${n} AS TEXT)`,
+			orElse: () => n
+		}) : n} AS ${t(e.outputKey)}`;
+	})) : A((e.sourceTable?.tableName === e.table ? e.sourceTable : r(e.table))?.fields, t, e.projection, (e.joins?.length ?? 0) > 0 ? e.alias ?? e.table : void 0, u), E = (e.aggregations && e.aggregations.length > 0) === !0, D = b !== null && !E ? t`${T}, ${b} AS ${t("distance")}` : T, j = e.fullTextSearch, N = j?.rank !== void 0 && !E ? k(j, e.table, t) : null, P = N !== null && j?.rank !== void 0 ? t`${D}, ${N} AS ${t(j.rank.alias)}` : D, F = w !== null && !E && e.spatialClause?.projectAs !== void 0 ? t`${P}, ${w} AS ${t(e.spatialClause.projectAs)}` : P, I = e.distinctOn && e.distinctOn.length > 0 ? t.onDialectOrElse({
+		orElse: () => t`DISTINCT ON (${t.join(", ", !1)(e.distinctOn.map((e) => t`${t(e)}`))}) `,
+		mysql: () => t`DISTINCT `,
+		mssql: () => t`DISTINCT `,
+		sqlite: () => t`DISTINCT `
+	}) : e.distinct ? t`DISTINCT ` : t``, L = e.lock === "update", R = L ? t.onDialectOrElse({
+		mssql: () => t` WITH (UPDLOCK, ROWLOCK)`,
+		orElse: () => t``
+	}) : t``, z = L ? t.onDialectOrElse({
+		mssql: () => t``,
+		sqlite: () => t``,
+		orElse: () => t` FOR UPDATE`
+	}) : t``, B = e.alias === void 0 ? t`${t(p(e.table))}${R}` : t`${t(p(e.table))} AS ${t(e.alias)}${R}`, V = (e.joins ?? []).map((e) => {
+		let n = e.kind === "inner" ? "INNER" : "LEFT";
+		return t` ${t.unsafe(n)} JOIN ${t(p(e.table))} AS ${t(e.alias)} ON ${_(e.on, t, o, void 0, f)}`;
+	}), H = V.length > 0 ? V.reduce((e, n) => t`${e}${n}`, B) : B, U = j === void 0 ? null : O(j, e.table, t), W = [e.predicate ? _(e.predicate, t, o, e.table, f) : null, U].filter((e) => e !== null), G = W.length > 0 ? t` WHERE ${t.and(W)}` : t``, K = e.groupBy && e.groupBy.length > 0 ? t` GROUP BY ${t.join(", ", !1)(e.groupBy.map((e) => t`${t(e)}`))}` : t``, q = e.having ? t` HAVING ${_(e.having, t, o, e.table, f)}` : t``, J = e.skip !== void 0, Y = [];
+	b !== null && Y.push(t`${b} ASC`), e.spatialClause?.order !== void 0 && Y.push(e.spatialClause.order === "desc" ? t`${C(e.spatialClause, t)} DESC` : t`${C(e.spatialClause, t)} ASC`), N !== null && j?.rank?.order === !0 && Y.push(t`${N} DESC`);
+	let X = i(e), Z = X.length >= 8 && (e.joinedProjection?.length ?? 0) >= 8 ? /* @__PURE__ */ new Map() : void 0;
+	if (Z) for (let t of e.joinedProjection ?? []) Z.has(t.outputKey) || Z.set(t.outputKey, t.source);
+	for (let n of X) {
+		let r = (Z === void 0 ? e.joinedProjection?.find((e) => e.outputKey === n.column)?.source : Z.get(n.column)) ?? n.column, i = u && !E && d(r)?.type === "decimal" ? t.onDialectOrElse({
+			mssql: () => t`${t(r.includes(".") ? r : `${e.alias ?? e.table}.${r}`)}`,
+			orElse: () => t`${t(n.column)}`
+		}) : !E && d(r)?.type === "bigint" ? t.onDialectOrElse({
+			sqlite: () => t`${t(r.includes(".") ? r : `${e.alias ?? e.table}.${r}`)}`,
+			orElse: () => t`${t(n.column)}`
+		}) : t`${t(n.column)}`;
+		Y.push(n.direction === "desc" ? t`${i} DESC` : t`${i} ASC`);
+	}
+	let Q = Y.length > 0 ? t` ORDER BY ${t.join(", ", !1)(Y)}` : J ? t.onDialectOrElse({
+		mssql: () => t` ORDER BY (SELECT NULL)`,
+		orElse: () => t``
+	}) : t``, $ = (e) => {
+		if (!Number.isFinite(e) || !Number.isInteger(e) || e < 0) throw n(`compileSelect: expected non-negative integer take/skip, got ${e}`);
+		return t.unsafe(String(e));
+	};
+	return t.onDialectOrElse({
+		mssql: () => {
+			let n = e.take !== void 0 && !J ? t`TOP ${$(e.take)} ` : t``, r = J ? t` OFFSET ${$(e.skip)} ROWS FETCH NEXT ${$(e.take ?? 2 ** 53 - 1)} ROWS ONLY` : t``;
+			return t`${v}SELECT ${n}${I}${F} FROM ${H}${G}${K}${q}${Q}${r}`;
+		},
+		orElse: () => {
+			let n = e.take === void 0 ? J ? t.onDialectOrElse({
+				sqlite: () => t` LIMIT -1`,
+				mysql: () => t` LIMIT 18446744073709551615`,
+				orElse: () => t``
+			}) : t`` : t` LIMIT ${$(e.take)}`, r = J ? t` OFFSET ${$(e.skip)}` : t``;
+			return t`${v}SELECT ${I}${F} FROM ${H}${G}${K}${q}${Q}${n}${r}${z}`;
+		}
+	});
+}, N = (e, t, n = null) => t.onDialectOrElse({
+	sqlite: () => !0,
+	orElse: () => !1
+}) && o(e) ? t`${p(e, t, { materialized: !1 }, n)}` : M(t.onDialectOrElse({
+	mssql: () => d(e) ?? e,
+	orElse: () => e
+}), t, n, void 0, /* @__PURE__ */ new Set(), !0), P = (e, t, n = null, r) => {
+	if (r !== void 0 && t.onDialectOrElse({
+		sqlite: () => !0,
+		orElse: () => !1
+	})) {
+		let i = {
+			table: r,
+			predicate: e,
+			order: [],
+			projection: void 0,
+			take: void 0,
+			skip: void 0
+		};
+		if (o(i)) return f(i, t, {
+			compile: (e) => N(e, t, n),
+			resultScale: void 0
+		}, e);
+	}
+	return _(e, t, n, r);
+}, F = (e, t, n = null, r) => _(e, t, n, r);
+//#endregion
+export { P as compilePredicate, h as compileRawFragment, j as compileRowProjection, N as compileSelect, F as compileStoragePredicate, g as escapeLike };

package/dist/sqlError.js

@@ -0,0 +1,8 @@
+import { SqlError as e, UnknownError as t } from "effect/sql/SqlError";
+//#region src/sqlError.ts
+var n = (n, r) => new e({ reason: new t({
+	cause: r ?? Error(n),
+	message: n
+}) });
+//#endregion
+export { n as sqlError };

package/dist/sqlPoolCapacity.js

@@ -0,0 +1,12 @@
+//#region src/sqlPoolCapacity.ts
+var e = /* @__PURE__ */ new WeakMap(), t = (t, n) => {
+	n !== void 0 && Number.isInteger(n) && n > 0 && e.set(t, n);
+}, n = (t) => {
+	let n = e.get(t);
+	if (n !== void 0) return n;
+	if (!("config" in t) || typeof t.config != "object" || t.config === null || !("maxConnections" in t.config)) return;
+	let r = t.config.maxConnections;
+	return typeof r == "number" && Number.isInteger(r) && r > 0 ? r : void 0;
+};
+//#endregion
+export { t as registerSqlPoolCapacity, n as sqlPoolCapacity };

package/dist/sqliteDecimal.js

@@ -0,0 +1,22 @@
+//#region src/sqliteDecimal.ts
+var e = ({ precision: e, scale: t }) => {
+	if (!Number.isSafeInteger(e) || e <= 0 || !Number.isSafeInteger(t) || t < 0 || t > e) throw RangeError("Invalid fixed-point decimal precision or scale");
+	return 10n ** BigInt(e);
+}, t = (t, n) => {
+	let r = e(n);
+	if (typeof t != "string" || !/^[+-]?(?:\d+(?:\.\d*)?|\.\d+)$/.test(t)) throw TypeError("Expected a fixed-point decimal string");
+	let [i = "", a = ""] = t.replace(/^[+-]/, "").split(".");
+	if (/[1-9]/.test(a.slice(n.scale))) throw RangeError("Decimal value exceeds the declared scale");
+	let o = BigInt((i || "0") + a.slice(0, n.scale).padEnd(n.scale, "0"));
+	if (o >= r) throw RangeError("Decimal value exceeds the declared precision");
+	return "D" + ((t.startsWith("-") ? -o : o) + r).toString().padStart(n.precision + 1, "0");
+}, n = (t, n) => {
+	let r = e(n);
+	if (typeof t != "string" || t.length !== n.precision + 2 || !/^D\d+$/.test(t)) throw TypeError("Expected an encoded fixed-point decimal value");
+	let i = BigInt(t.slice(1)) - r;
+	if (i <= -r || i >= r) throw RangeError("Encoded decimal value exceeds the declared precision");
+	let a = (i < 0n ? -i : i).toString().padStart(n.scale + 1, "0"), o = n.scale === 0 ? a : a.slice(0, -n.scale) + "." + a.slice(-n.scale);
+	return (i < 0n ? "-" : "") + o;
+};
+//#endregion
+export { n as decodeSqliteDecimal, t as encodeSqliteDecimal };

package/dist/sqliteDecimalAggregateSql.js

@@ -0,0 +1,61 @@
+//#region src/sqliteDecimalAggregateSql.ts
+var e = (e, t, n) => {
+	let r = n ? t : `SELECT * FROM (${t}) LIMIT -1 OFFSET 0`;
+	return `${e} AS${n ? " MATERIALIZED" : ""} (${r})`;
+}, t = ({ sourceSql: t, precision: n, scope: r, materialized: i = !1, stages: a }) => {
+	if (!Number.isSafeInteger(n) || n <= 0) throw RangeError("Invalid decimal aggregate precision");
+	let o = 1e6, s = (9223372036854775807n / BigInt(o)).toString(), c = Math.ceil((n + 1) / 6), l = Math.ceil((n + 20) / 6) * 6, u = [];
+	if (a && !/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(a.prefix)) throw Error("Invalid decimal stage prefix");
+	let d = (e) => (a?.prefix ?? "") + e, f = (e) => a?.reference?.(d(e)) ?? d(e), p = (t, n) => {
+		a ? a.append(d(t), n, i) : u.push(e(t, n, i));
+	}, m = (e) => "\"" + e.replace(/"/g, "\"\"") + "\"", h = r?.kind === "group" ? r.columns.map((e, t) => `key${t}`) : r?.kind === "window" ? ["identity", ...(r.carryColumns ?? []).map((e, t) => `carry${t}`)] : [], g = h.length === 0 ? "" : h.join(",") + ",", _ = r?.kind === "group" ? r.columns.map((e, t) => `${m(e)} AS key${t}`).join(",") : r?.kind === "window" ? [`${m(r.identity)} AS identity`, ...(r.carryColumns ?? []).map((e, t) => `${m(e)} AS carry${t}`)].join(",") : "", v = r?.kind === "group" && r.columns.length > 0 ? ` GROUP BY ${r.columns.map(m).join(",")}` : "", y = r?.kind === "window" ? [...r.partitionBy?.length ? [`PARTITION BY ${r.partitionBy.map(m).join(",")}`] : [], ...r.orderBy?.length ? [`ORDER BY ${r.orderBy.map((e) => `${m(e.column)} ${e.direction === "desc" ? "DESC" : "ASC"}`).join(",")}`] : []] : [], b = r?.kind === "window" ? ` OVER (${y.join(" ")})` : "";
+	p("decimal_source", t);
+	let x = Array.from({ length: c }, (e, t) => `d${t}`), S = x.map((e, t) => {
+		let r = t === c - 1, i = r ? n + 1 - t * 6 : 6;
+		return `COALESCE(SUM(CAST(substr(value,${r ? 2 : -(t + 1) * 6},${i}) AS INTEGER))${b},0) AS ${e}`;
+	}), C = `COUNT(value)${b}`, w = `CASE WHEN ${C}>${s} THEN abs(-9223372036854775808) ELSE ${C} END`;
+	p("decimal_digits", `SELECT ${_ ? _ + "," : ""}${w} AS n,${S.join(",")} FROM ${f("decimal_source")}${v}`), p("decimal_add0", `SELECT *,0 AS carry,'' AS result FROM ${f("decimal_digits")}`);
+	for (let e = 0; e < c; e++) {
+		let t = `(carry+d${e})`;
+		p(`decimal_add${e + 1}`, `SELECT ${g}n,${x.join(",")},${t}/${o} AS carry,printf('%06d',${t}%${o})||result AS result FROM ${f(`decimal_add${e}`)}`);
+	}
+	p("decimal_operands", `SELECT ${g}COALESCE(NULLIF(ltrim(CASE WHEN carry>0 THEN CAST(carry AS TEXT) ELSE '' END||result,'0'),''),'0') AS a,CASE WHEN n=0 THEN '0' ELSE CAST(n AS TEXT)||'${"0".repeat(n)}' END AS b,n FROM ${f(`decimal_add${c}`)}`);
+	let T = "(length(a)>length(b) OR (length(a)=length(b) AND a>=b))";
+	p("decimal_magnitude", `SELECT ${g}CASE WHEN ${T} THEN a ELSE b END AS hi,CASE WHEN ${T} THEN b ELSE a END AS lo,CASE WHEN ${T} THEN '' ELSE '-' END AS sign,n FROM ${f("decimal_operands")}`);
+	let E = "0".repeat(l);
+	p("decimal_padded", `SELECT ${g}substr('${E}',1,${l}-length(hi))||hi AS hi,substr('${E}',1,${l}-length(lo))||lo AS lo,sign,n FROM ${f("decimal_magnitude")}`), p("decimal_sub0", `SELECT *,0 AS borrow,'' AS result FROM ${f("decimal_padded")}`);
+	let D = l / 6;
+	for (let e = 0; e < D; e++) {
+		let t = l + 1 - (e + 1) * 6, n = `(CAST(substr(hi,${t},6) AS INTEGER)-CAST(substr(lo,${t},6) AS INTEGER)-borrow)`;
+		p(`decimal_sub${e + 1}`, `SELECT ${g}hi,lo,sign,n,CASE WHEN ${n}<0 THEN 1 ELSE 0 END AS borrow,printf('%06d',(${n}+${o})%${o})||result AS result FROM ${f(`decimal_sub${e}`)}`);
+	}
+	return `${u.length ? `WITH ${u.join(",\n")} ` : ""}SELECT ${g}CASE WHEN n=0 THEN NULL WHEN ltrim(result,'0')='' THEN '0' ELSE sign||ltrim(result,'0') END AS units,CAST(n AS TEXT) AS count FROM ${f(`decimal_sub${D}`)}`;
+}, n = (n) => {
+	let { precision: r, inputScale: i, resultScale: a, rounding: o, scope: s, materialized: c = !1, stages: l } = n;
+	if (!Number.isSafeInteger(i) || i < 0 || i > r || !Number.isSafeInteger(a) || a < 0) throw RangeError("Invalid decimal average scale");
+	let u = t(n), d = s?.kind === "group" ? s.columns.map((e, t) => `key${t}`) : s?.kind === "window" ? ["identity", ...(s.carryColumns ?? []).map((e, t) => `carry${t}`)] : [], f = d.length === 0 ? "" : d.join(",") + ",", p = a - i, m = Math.ceil((r + 20) / 6) * 6 + Math.max(p, 0), h = m + Math.min(p, 0), g = Math.ceil(h / 6) * 6, _ = [];
+	if (l && !/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(l.prefix)) throw Error("Invalid decimal stage prefix");
+	let v = (e) => (l?.prefix ?? "") + e, y = (e) => l?.reference?.(v(e)) ?? v(e), b = (t, n) => {
+		l ? l.append(v(t), n, c) : _.push(e(t, n, c));
+	};
+	b("decimal_avg_sum", u), b("decimal_avg_input", `SELECT ${f}count,CASE WHEN substr(units,1,1)='-' THEN '-' ELSE '' END AS sign,${`COALESCE(ltrim(units,'-'),'0')||'${"0".repeat(Math.max(p, 0))}'`} AS magnitude FROM ${y("decimal_avg_sum")}`), b("decimal_avg_div0", `SELECT ${f}count,sign,substr('${"0".repeat(m)}',1,${m}-length(magnitude))||magnitude AS digits,CASE WHEN count='0' THEN 1 ELSE CAST(count AS INTEGER) END AS denominator,0 AS remainder,'' AS result FROM ${y("decimal_avg_input")}`);
+	let x = 0;
+	for (let e = 1; e <= m; e += 5) {
+		let t = Math.min(5, m - e + 1), n = `(remainder*${10 ** t}+CAST(substr(digits,${e},${t}) AS INTEGER))`, r = x++;
+		b(`decimal_avg_div${x}`, `SELECT ${f}count,sign,digits,denominator,${n}%denominator AS remainder,result||printf('%0${t}d',${n}/denominator) AS result FROM ${y(`decimal_avg_div${r}`)}`);
+	}
+	let S = p < 0 ? `substr(result,1,${h})` : "result", C = o === "half-away" ? "1" : `CAST(substr(${S},-1,1) AS INTEGER)%2`, w;
+	if (p < 0) {
+		let e = `substr(result,${h + 1})`, t = `'5${"0".repeat(-p - 1)}'`;
+		w = `${e}>${t} OR (${e}=${t} AND (remainder>0 OR ${C}=1))`;
+	} else w = `remainder*2>denominator OR (remainder*2=denominator AND ${C}=1)`;
+	b("decimal_avg_round0", `SELECT ${f}count,sign,substr('${"0".repeat(g)}',1,${g}-${h})||${S} AS quotient,CASE WHEN ${w} THEN 1 ELSE 0 END AS carry,'' AS result FROM ${y(`decimal_avg_div${x}`)}`);
+	let T = g / 6;
+	for (let e = 1; e <= T; e++) {
+		let t = `(CAST(substr(quotient,${g + 1 - e * 6},6) AS INTEGER)+carry)`;
+		b(`decimal_avg_round${e}`, `SELECT ${f}count,sign,quotient,${t}/1000000 AS carry,printf('%06d',${t}%1000000)||result AS result FROM ${y(`decimal_avg_round${e - 1}`)}`);
+	}
+	return `${_.length ? `WITH ${_.join(",\n")} ` : ""}SELECT ${f}CASE WHEN count='0' THEN NULL WHEN ltrim(result,'0')='' THEN '0' ELSE sign||ltrim(result,'0') END AS units,count FROM ${y(`decimal_avg_round${T}`)}`;
+};
+//#endregion
+export { n as compileSqliteDecimalAvg, t as compileSqliteDecimalSum };

package/dist/sqliteDecimalColumnSql.js

@@ -0,0 +1,108 @@
+import { encodeSqliteDecimal as e } from "./sqliteDecimal.js";
+//#region src/sqliteDecimalColumnSql.ts
+var t = {
+	eq: "=",
+	neq: "<>",
+	gt: ">",
+	gte: ">=",
+	lt: "<",
+	lte: "<="
+}, n = (n, r, i) => {
+	e("0", n.shape), e("0", i.shape);
+	let a = t[r];
+	if (a === void 0) throw RangeError("Invalid decimal column comparison");
+	let o = Math.max(n.shape.scale, i.shape.scale), s = Math.max(n.shape.precision - n.shape.scale, i.shape.precision - i.shape.scale), c = ({ expression: e, shape: t }) => {
+		let n = s - (t.precision - t.scale), r = "0".repeat(o - t.scale);
+		return `(CASE WHEN substr((${e}), 2, 1) = '1' THEN '1${"0".repeat(n)}' ELSE '0${"9".repeat(n)}' END || substr((${e}), 3) || '${r}') COLLATE BINARY`;
+	};
+	return `(${c(n)} ${a} ${c(i)})`;
+}, r = ({ expression: e, shape: t }) => {
+	let n = i(t, (e) => e), r = [`decimal_decode_input AS (SELECT (${e}) AS encoded LIMIT -1 OFFSET 0)`], a = "decimal_decode_input";
+	for (let [e, t] of n.steps) {
+		let n = `decimal_decode_${e}`;
+		r.push(`${n} AS (SELECT *,${t.join(",")} FROM ${a} LIMIT -1 OFFSET 0)`), a = n;
+	}
+	return `(WITH ${r.join(",")} SELECT ${n.value} AS value FROM ${a})`;
+}, i = (t, n) => {
+	e("0", t);
+	let r = n("encoded"), i = n("payload"), a = n("negative"), o = n("trimmed"), s = n("units"), c = n("magnitude"), l = n("padded"), u = `substr(${o},1,length(${o})-1)`;
+	for (let e = 0; e < 10; e++) u = `replace(${u},'${e}','${String.fromCharCode(97 + e)}')`;
+	let d = n("alphabetic");
+	for (let e = 0; e < 10; e++) d = `replace(${d},'${String.fromCharCode(97 + e)}','${9 - e}')`;
+	let f = [
+		["parts", [`substr(${r},3) AS ${i}`, `substr(${r},2,1)='0' AS ${a}`]],
+		["trimmed", [`rtrim(${i},'0') AS ${o}`]],
+		["alphabetic", [`${u} AS ${n("alphabetic")}`]],
+		["complement", [`${d} AS ${n("complement")}`]],
+		["units", [`CASE WHEN ${a} THEN ${n("complement")}||CAST(10-CAST(substr(${o},-1) AS INTEGER) AS TEXT)||substr(${i},length(${o})+1) ELSE ${i} END AS ${s}`]],
+		["magnitude", [`COALESCE(NULLIF(ltrim(${s},'0'),''),'0') AS ${c}`]],
+		["padded", [`substr('${"0".repeat(t.scale + 1)}'||${c},-max(length(${c}),${t.scale + 1})) AS ${l}`]]
+	], p = t.scale === 0 ? c : `substr(${l},1,length(${l})-${t.scale})||'.'||substr(${l},-${t.scale})`;
+	return {
+		steps: f,
+		retained: [
+			["payload", "negative"],
+			[
+				"payload",
+				"negative",
+				"trimmed"
+			],
+			[
+				"payload",
+				"negative",
+				"trimmed",
+				"alphabetic"
+			],
+			[
+				"payload",
+				"negative",
+				"trimmed",
+				"complement"
+			],
+			[
+				"negative",
+				"trimmed",
+				"units"
+			],
+			[
+				"negative",
+				"trimmed",
+				"magnitude"
+			],
+			[
+				"negative",
+				"trimmed",
+				"magnitude",
+				"padded"
+			]
+		],
+		value: `CASE WHEN ${r} IS NULL THEN NULL WHEN ${`typeof(${r})<>'text' OR length(${r})<>${t.precision + 2} OR substr(${r},1,1)<>'D' OR substr(${r},2,1) NOT IN ('0','1') OR substr(${r},2) GLOB '*[^0-9]*' OR (${a} AND length(${o})=0)`} THEN abs(-9223372036854775808) ELSE (CASE WHEN ${a} THEN '-' ELSE '' END)||${p} END`
+	};
+}, a = (e, t, n, r) => {
+	if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(r.prefix)) throw Error("Invalid decimal decoder stage prefix");
+	if (new Set(t.map((e) => e.name)).size !== t.length || t.some((e) => !/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(e.name))) throw Error("Invalid decimal decoder columns");
+	let a = new Set(n);
+	if (a.size !== n.length || n.some((e) => !/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(e)) || t.some((e) => !a.has(e.name))) throw Error("Invalid decimal decoder input columns");
+	let o = t.map((e, t) => {
+		let n = (n) => n === "encoded" ? e.name : `${r.prefix}d${t}_${n}`;
+		return {
+			column: e,
+			ref: n,
+			plan: i(e.shape, n)
+		};
+	});
+	for (let t = 0; t < (o[0]?.plan.steps.length ?? 0); t++) {
+		let i = `${r.prefix}decode_${t}`, a = o.flatMap(({ plan: e }) => e.steps[t][1]), s = o.flatMap(({ plan: e, ref: n }) => t === 0 ? [] : e.retained[t - 1].filter((n) => e.retained[t].includes(n)).map(n));
+		r.append(i, `SELECT ${[
+			...n,
+			...s,
+			...a
+		].join(",")} FROM ${e} LIMIT -1 OFFSET 0`), e = i;
+	}
+	return {
+		source: e,
+		values: new Map(o.map(({ column: e, plan: t }) => [e.name, t.value]))
+	};
+};
+//#endregion
+export { n as compileSqliteDecimalColumnComparison, r as compileSqliteDecimalColumnValue, a as compileSqliteDecimalDecodedRows };

package/dist/sqliteDecimalConversion.js

@@ -0,0 +1,15 @@
+import { decodeSqliteDecimal as e, encodeSqliteDecimal as t } from "./sqliteDecimal.js";
+//#region src/sqliteDecimalConversion.ts
+var n = (n, r) => {
+	if (t("0", r), n.kind === "sortable-v1" && t("0", n.shape), n.value === null) return null;
+	if (n.kind === "sortable-v1") return t(e(n.value, n.shape), r);
+	if (n.kind === "numeric") {
+		if (!(typeof n.value == "bigint" || typeof n.value == "number" && Number.isFinite(n.value) || typeof n.value == "string" && /^[+-]?(?:\d+(?:\.\d*)?|\.\d+)(?:e[+-]?\d+)?$/i.test(n.value))) throw TypeError("NUMERIC decimal conversion requires an observed numeric source");
+		if (n.resolution?.acknowledgePriorRounding !== !0) throw TypeError("NUMERIC decimal conversion requires an explicit decimal source and acknowledgement of possible prior rounding");
+		return t(n.resolution.decimal, r);
+	}
+	if (typeof n.value != "string") throw TypeError("Decimal text conversion requires an exact string source");
+	return t(n.value, r);
+};
+//#endregion
+export { n as convertSqliteDecimalValue };