@atscript/db-sql-tools 0.1.38 → 0.1.40

package/README.md

@@ -0,0 +1,43 @@
+<p align="center">
+  <img src="https://atscript.dev/logo.svg" alt="Atscript" width="120" />
+</p>
+
+<h1 align="center">@atscript/db-sql-tools</h1>
+
+<p align="center">
+  <strong>Define your models once</strong> — get TypeScript types, runtime validation, and DB metadata from a single <code>.as</code> model.
+</p>
+
+<p align="center">
+  <a href="https://db.atscript.dev">Documentation</a> · <a href="https://db.atscript.dev/adapters/">DB Adapters</a>
+</p>
+
+---
+
+Shared SQL builder utilities for Atscript's SQL-based database adapters (`db-sqlite`, `db-mysql`, `db-postgres`). Provides parameterized query generation, MongoDB-style filter translation, and dialect abstraction.
+
+This is an internal package — not typically installed directly by end users.
+
+## Installation
+
+```bash
+pnpm add @atscript/db-sql-tools
+```
+
+## Features
+
+- `SqlDialect` interface abstracting identifier quoting, parameter placeholders, regex, and value serialization
+- `buildWhere` — translates MongoDB-style filters (`$gt`, `$in`, `$or`, `$regex`, etc.) to parameterized SQL
+- `buildInsert`, `buildSelect`, `buildUpdate`, `buildDelete` — full SQL statement builders
+- `buildAggregateSelect`, `buildAggregateCount` — GROUP BY, HAVING, aggregate functions
+- `buildCreateView` — CREATE VIEW with JOINs, filters, and GROUP BY from Atscript view plans
+- DDL helpers: query expression → SQL, referential actions, default value literals
+
+## Documentation
+
+- [DB Adapters Guide](https://db.atscript.dev/adapters/)
+- [Full Documentation](https://db.atscript.dev)
+
+## License
+
+MIT

package/dist/index.cjs

@@ -1,37 +1,16 @@
-"use strict";
-//#region rolldown:runtime
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-		key = keys[i];
-		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
-			get: ((k) => from[k]).bind(null, key),
-			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-		});
-	}
-	return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
-	value: mod,
-	enumerable: true
-}) : target, mod));
-
-//#endregion
-const __uniqu_core = __toESM(require("@uniqu/core"));
-const __atscript_db_agg = __toESM(require("@atscript/db/agg"));
-
-//#region packages/db-sql-tools/src/dialect.ts
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let _uniqu_core = require("@uniqu/core");
+let _atscript_db_agg = require("@atscript/db/agg");
+//#region src/dialect.ts
+/**
+* Replaces positional `?` placeholders with dialect-specific numbered placeholders
+* (e.g. `$1, $2, ...` for PostgreSQL). No-op when `dialect.paramPlaceholder` is not set.
+*/
 function finalizeParams(dialect, fragment) {
 	if (!dialect.paramPlaceholder) return fragment;
 	let idx = 0;
-	const sql = fragment.sql.replace(/\?/g, () => dialect.paramPlaceholder(++idx));
 	return {
-		sql,
+		sql: fragment.sql.replace(/\?/g, () => dialect.paramPlaceholder(++idx)),
 		params: fragment.params
 	};
 }
@@ -43,16 +22,18 @@ const EMPTY_OR = {
 	sql: "0=1",
 	params: []
 };
-
 //#endregion
-//#region packages/db-sql-tools/src/filter-builder.ts
+//#region src/filter-builder.ts
+/**
+* Creates a dialect-specific filter visitor for `walkFilter`.
+*/
 function createFilterVisitor(dialect) {
 	return {
 		comparison(field, op, value) {
 			const col = dialect.quoteIdentifier(field);
 			const v = dialect.toParam(value);
 			switch (op) {
-				case "$eq": {
+				case "$eq":
 					if (v === null) return {
 						sql: `${col} IS NULL`,
 						params: []
@@ -61,8 +42,7 @@ function createFilterVisitor(dialect) {
 						sql: `${col} = ?`,
 						params: [v]
 					};
-				}
-				case "$ne": {
+				case "$ne":
 					if (v === null) return {
 						sql: `${col} IS NOT NULL`,
 						params: []
@@ -71,7 +51,6 @@ function createFilterVisitor(dialect) {
 						sql: `${col} != ?`,
 						params: [v]
 					};
-				}
 				case "$gt": return {
 					sql: `${col} > ?`,
 					params: [v]
@@ -91,18 +70,16 @@ function createFilterVisitor(dialect) {
 				case "$in": {
 					const arr = value.map((x) => dialect.toParam(x));
 					if (arr.length === 0) return EMPTY_OR;
-					const placeholders = arr.map(() => "?").join(", ");
 					return {
-						sql: `${col} IN (${placeholders})`,
+						sql: `${col} IN (${arr.map(() => "?").join(", ")})`,
 						params: arr
 					};
 				}
 				case "$nin": {
 					const arr = value.map((x) => dialect.toParam(x));
 					if (arr.length === 0) return EMPTY_AND;
-					const placeholders = arr.map(() => "?").join(", ");
 					return {
-						sql: `${col} NOT IN (${placeholders})`,
+						sql: `${col} NOT IN (${arr.map(() => "?").join(", ")})`,
 						params: arr
 					};
 				}
@@ -114,7 +91,7 @@ function createFilterVisitor(dialect) {
 					params: []
 				};
 				case "$regex": return dialect.regex(col, value);
-				default: throw new Error(`Unsupported filter operator: ${op}`);
+				default: throw new Error(`Unsupported filter operator: ${String(op)}`);
 			}
 		},
 		and(children) {
@@ -139,7 +116,7 @@ function createFilterVisitor(dialect) {
 		}
 	};
 }
-const visitorCache = new WeakMap();
+const visitorCache = /* @__PURE__ */ new WeakMap();
 function getVisitor(dialect) {
 	let visitor = visitorCache.get(dialect);
 	if (!visitor) {
@@ -148,18 +125,22 @@ function getVisitor(dialect) {
 	}
 	return visitor;
 }
+/**
+* Translates a filter expression into a parameterized SQL WHERE clause.
+*/
 function buildWhere(dialect, filter) {
 	if (!filter || Object.keys(filter).length === 0) return EMPTY_AND;
-	return (0, __uniqu_core.walkFilter)(filter, getVisitor(dialect)) ?? EMPTY_AND;
+	return (0, _uniqu_core.walkFilter)(filter, getVisitor(dialect)) ?? EMPTY_AND;
 }
-
 //#endregion
-//#region packages/db-sql-tools/src/common.ts
+//#region src/common.ts
+/** Formats a string value as a SQL literal with single-quote escaping. */
 function sqlStringLiteral(value) {
 	return `'${value.replace(/'/g, "''")}'`;
 }
+/** Converts a JS value to a SQL-bindable parameter. Objects/arrays -> JSON, booleans -> 0/1. */
 function toSqlValue(value) {
-	if (value === undefined) return null;
+	if (value === void 0) return null;
 	if (value === null) return null;
 	if (typeof value === "object") return JSON.stringify(value);
 	if (typeof value === "boolean") return value ? 1 : 0;
@@ -174,6 +155,7 @@ function refActionToSql(action) {
 		default: return "NO ACTION";
 	}
 }
+/** Returns a safe SQL DEFAULT literal for a given design type. */
 function defaultValueForType(designType) {
 	switch (designType) {
 		case "number":
@@ -183,6 +165,11 @@ function defaultValueForType(designType) {
 		default: return "''";
 	}
 }
+/**
+* Converts a stored default value string to a SQL DEFAULT literal,
+* respecting the field's designType. Booleans become 0/1, numbers stay unquoted,
+* strings are single-quote-escaped.
+*/
 function defaultValueToSqlLiteral(designType, value) {
 	switch (designType) {
 		case "boolean": return value === "true" || value === "1" ? "1" : "0";
@@ -203,27 +190,23 @@ const queryOpToSql = {
 	$lt: "<",
 	$lte: "<="
 };
+/**
+* Renders an AtscriptQueryNode tree to raw SQL (no parameters -- for DDL use only).
+*/
 function queryNodeToSql(node, resolveFieldRef) {
-	if ("$and" in node) {
-		const children = node.$and;
-		return children.map((n) => queryNodeToSql(n, resolveFieldRef)).join(" AND ");
-	}
-	if ("$or" in node) {
-		const children = node.$or;
-		return `(${children.map((n) => queryNodeToSql(n, resolveFieldRef)).join(" OR ")})`;
-	}
+	if ("$and" in node) return node.$and.map((n) => queryNodeToSql(n, resolveFieldRef)).join(" AND ");
+	if ("$or" in node) return `(${node.$or.map((n) => queryNodeToSql(n, resolveFieldRef)).join(" OR ")})`;
 	if ("$not" in node) return `NOT (${queryNodeToSql(node.$not, resolveFieldRef)})`;
 	const comp = node;
 	const leftSql = resolveFieldRef(comp.left);
 	const sqlOp = queryOpToSql[comp.op] || "=";
 	if (comp.right && typeof comp.right === "object" && "field" in comp.right) return `${leftSql} ${sqlOp} ${resolveFieldRef(comp.right)}`;
-	if (comp.right === null || comp.right === undefined) return comp.op === "$ne" ? `${leftSql} IS NOT NULL` : `${leftSql} IS NULL`;
+	if (comp.right === null || comp.right === void 0) return comp.op === "$ne" ? `${leftSql} IS NOT NULL` : `${leftSql} IS NULL`;
 	if (typeof comp.right === "string") return `${leftSql} ${sqlOp} '${comp.right.replace(/'/g, "''")}'`;
 	return `${leftSql} ${sqlOp} ${comp.right}`;
 }
-
 //#endregion
-//#region packages/db-sql-tools/src/agg.ts
+//#region src/agg.ts
 const AGG_FN_SQL = {
 	sum: "SUM",
 	avg: "AVG",
@@ -233,18 +216,19 @@ const AGG_FN_SQL = {
 };
 function buildAggExpr(dialect, expr) {
 	const fn = AGG_FN_SQL[expr.$fn] ?? expr.$fn.toUpperCase();
-	const alias = dialect.quoteIdentifier((0, __atscript_db_agg.resolveAlias)(expr));
-	const field = expr.$field === "*" ? "*" : dialect.quoteIdentifier(expr.$field);
-	return `${fn}(${field}) AS ${alias}`;
+	const alias = dialect.quoteIdentifier((0, _atscript_db_agg.resolveAlias)(expr));
+	return `${fn}(${expr.$field === "*" ? "*" : dialect.quoteIdentifier(expr.$field)}) AS ${alias}`;
 }
+/**
+* Builds a SELECT ... GROUP BY statement with aggregate functions.
+*/
 function buildAggregateSelect(dialect, table, where, controls) {
 	const selectParts = [];
 	const plainFields = controls.$select?.asArray;
 	if (plainFields) for (const f of plainFields) selectParts.push(dialect.quoteIdentifier(f));
 	const aggregates = controls.$select?.aggregates;
 	if (aggregates) for (const expr of aggregates) selectParts.push(buildAggExpr(dialect, expr));
-	const cols = selectParts.length > 0 ? selectParts.join(", ") : "*";
-	let sql = `SELECT ${cols} FROM ${dialect.quoteTable(table)} WHERE ${where.sql}`;
+	let sql = `SELECT ${selectParts.length > 0 ? selectParts.join(", ") : "*"} FROM ${dialect.quoteTable(table)} WHERE ${where.sql}`;
 	const params = [...where.params];
 	const groupBy = controls.$groupBy;
 	if (groupBy?.length) {
@@ -263,12 +247,12 @@ function buildAggregateSelect(dialect, table, where, controls) {
 		for (const [col, dir] of Object.entries(controls.$sort)) orderParts.push(`${dialect.quoteIdentifier(col)} ${dir === -1 ? "DESC" : "ASC"}`);
 		if (orderParts.length > 0) sql += ` ORDER BY ${orderParts.join(", ")}`;
 	}
-	if (controls.$limit !== undefined) {
+	if (controls.$limit !== void 0) {
 		sql += ` LIMIT ?`;
 		params.push(controls.$limit);
 	}
-	if (controls.$skip !== undefined) {
-		if (controls.$limit === undefined) sql += ` LIMIT ${dialect.unlimitedLimit}`;
+	if (controls.$skip !== void 0) {
+		if (controls.$limit === void 0) sql += ` LIMIT ${dialect.unlimitedLimit}`;
 		sql += ` OFFSET ?`;
 		params.push(controls.$skip);
 	}
@@ -277,25 +261,27 @@ function buildAggregateSelect(dialect, table, where, controls) {
 		params
 	});
 }
+/**
+* Builds a COUNT query for the number of distinct groups.
+* Returns `{ count: N }` when executed.
+*/
 function buildAggregateCount(dialect, table, where, controls) {
 	const groupFields = controls.$groupBy;
-	if (!groupFields?.length) {
-		const sql$1 = `SELECT COUNT(*) AS ${dialect.quoteIdentifier("count")} FROM ${dialect.quoteTable(table)} WHERE ${where.sql}`;
-		return finalizeParams(dialect, {
-			sql: sql$1,
-			params: where.params
-		});
-	}
+	if (!groupFields?.length) return finalizeParams(dialect, {
+		sql: `SELECT COUNT(*) AS ${dialect.quoteIdentifier("count")} FROM ${dialect.quoteTable(table)} WHERE ${where.sql}`,
+		params: where.params
+	});
 	const groupCols = groupFields.map((f) => dialect.quoteIdentifier(f)).join(", ");
-	const sql = `SELECT COUNT(*) AS ${dialect.quoteIdentifier("count")} FROM (SELECT 1 FROM ${dialect.quoteTable(table)} WHERE ${where.sql} GROUP BY ${groupCols}) AS ${dialect.quoteIdentifier("_groups")}`;
 	return finalizeParams(dialect, {
-		sql,
+		sql: `SELECT COUNT(*) AS ${dialect.quoteIdentifier("count")} FROM (SELECT 1 FROM ${dialect.quoteTable(table)} WHERE ${where.sql} GROUP BY ${groupCols}) AS ${dialect.quoteIdentifier("_groups")}`,
 		params: where.params
 	});
 }
-
 //#endregion
-//#region packages/db-sql-tools/src/sql-builder.ts
+//#region src/sql-builder.ts
+/**
+* Builds an INSERT statement.
+*/
 function buildInsert(dialect, table, data) {
 	const keys = Object.keys(data);
 	const cols = keys.map((k) => dialect.quoteIdentifier(k)).join(", ");
@@ -305,21 +291,23 @@ function buildInsert(dialect, table, data) {
 		params: keys.map((k) => dialect.toValue(data[k]))
 	});
 }
+/**
+* Builds a SELECT statement with optional sort, limit, offset, projection.
+*/
 function buildSelect(dialect, table, where, controls) {
-	const cols = buildProjection(dialect, controls?.$select);
-	let sql = `SELECT ${cols} FROM ${dialect.quoteTable(table)} WHERE ${where.sql}`;
+	let sql = `SELECT ${buildProjection(dialect, controls?.$select)} FROM ${dialect.quoteTable(table)} WHERE ${where.sql}`;
 	const params = [...where.params];
 	if (controls?.$sort) {
 		const orderParts = [];
 		for (const [col, dir] of Object.entries(controls.$sort)) orderParts.push(`${dialect.quoteIdentifier(col)} ${dir === -1 ? "DESC" : "ASC"}`);
 		if (orderParts.length > 0) sql += ` ORDER BY ${orderParts.join(", ")}`;
 	}
-	if (controls?.$limit !== undefined) {
+	if (controls?.$limit !== void 0) {
 		sql += ` LIMIT ?`;
 		params.push(controls.$limit);
 	}
-	if (controls?.$skip !== undefined) {
-		if (controls.$limit === undefined) sql += ` LIMIT ${dialect.unlimitedLimit}`;
+	if (controls?.$skip !== void 0) {
+		if (controls.$limit === void 0) sql += ` LIMIT ${dialect.unlimitedLimit}`;
 		sql += ` OFFSET ?`;
 		params.push(controls.$skip);
 	}
@@ -328,28 +316,47 @@ function buildSelect(dialect, table, where, controls) {
 		params
 	});
 }
-function buildUpdate(dialect, table, data, where, limit) {
+/**
+* Builds an UPDATE ... SET ... WHERE statement with optional LIMIT.
+*/
+function buildUpdate(dialect, table, data, where, limit, ops) {
 	const setClauses = [];
 	const params = [];
 	for (const [key, value] of Object.entries(data)) {
 		setClauses.push(`${dialect.quoteIdentifier(key)} = ?`);
 		params.push(dialect.toValue(value));
 	}
+	if (ops?.inc) for (const key in ops.inc) {
+		const col = dialect.quoteIdentifier(key);
+		setClauses.push(`${col} = ${col} + ?`);
+		params.push(ops.inc[key]);
+	}
+	if (ops?.mul) for (const key in ops.mul) {
+		const col = dialect.quoteIdentifier(key);
+		setClauses.push(`${col} = ${col} * ?`);
+		params.push(ops.mul[key]);
+	}
 	let sql = `UPDATE ${dialect.quoteTable(table)} SET ${setClauses.join(", ")} WHERE ${where.sql}`;
-	if (limit !== undefined) sql += ` LIMIT ${limit}`;
+	if (limit !== void 0) sql += ` LIMIT ${limit}`;
 	return finalizeParams(dialect, {
 		sql,
 		params: [...params, ...where.params]
 	});
 }
+/**
+* Builds a DELETE ... WHERE statement with optional LIMIT.
+*/
 function buildDelete(dialect, table, where, limit) {
 	let sql = `DELETE FROM ${dialect.quoteTable(table)} WHERE ${where.sql}`;
-	if (limit !== undefined) sql += ` LIMIT ${limit}`;
+	if (limit !== void 0) sql += ` LIMIT ${limit}`;
 	return finalizeParams(dialect, {
 		sql,
 		params: where.params
 	});
 }
+/**
+* Builds a column projection (SELECT clause fields).
+*/
 function buildProjection(dialect, select) {
 	const fields = select?.asArray;
 	if (!fields) return "*";
@@ -360,11 +367,13 @@ function buildProjection(dialect, select) {
 	}
 	return sql || "*";
 }
-/** Builds the SQL expression for a single aggregate column. */ function buildAggColExpr(dialect, c) {
-	const fn = AGG_FN_SQL[c.aggFn] ?? c.aggFn.toUpperCase();
-	const arg = c.aggField === "*" ? "*" : `${dialect.quoteIdentifier(c.sourceTable)}.${dialect.quoteIdentifier(c.sourceColumn)}`;
-	return `${fn}(${arg})`;
+/** Builds the SQL expression for a single aggregate column. */
+function buildAggColExpr(dialect, c) {
+	return `${AGG_FN_SQL[c.aggFn] ?? c.aggFn.toUpperCase()}(${c.aggField === "*" ? "*" : `${dialect.quoteIdentifier(c.sourceTable)}.${dialect.quoteIdentifier(c.sourceColumn)}`})`;
 }
+/**
+* Builds a CREATE VIEW statement from a view plan and column mappings.
+*/
 function buildCreateView(dialect, viewName, plan, columns, resolveFieldRef) {
 	const selectCols = columns.map((c) => {
 		if (c.aggFn) return `${buildAggColExpr(dialect, c)} AS ${dialect.quoteIdentifier(c.viewColumn)}`;
@@ -379,15 +388,14 @@ function buildCreateView(dialect, viewName, plan, columns, resolveFieldRef) {
 		const whereClause = queryNodeToSql(plan.filter, resolveFieldRef);
 		sql += ` WHERE ${whereClause}`;
 	}
-	const hasAggregates = columns.some((c) => c.aggFn);
-	if (hasAggregates) {
+	if (columns.some((c) => c.aggFn)) {
 		const dimensionCols = columns.filter((c) => !c.aggFn);
 		if (dimensionCols.length > 0) {
 			const groupByCols = dimensionCols.map((c) => `${dialect.quoteIdentifier(c.sourceTable)}.${dialect.quoteIdentifier(c.sourceColumn)}`).join(", ");
 			sql += ` GROUP BY ${groupByCols}`;
 		}
 		if (plan.having) {
-			const columnMap = new Map();
+			const columnMap = /* @__PURE__ */ new Map();
 			for (const c of columns) columnMap.set(c.viewColumn, c);
 			const havingResolver = (ref) => {
 				if (!ref.type) {
@@ -403,26 +411,25 @@ function buildCreateView(dialect, viewName, plan, columns, resolveFieldRef) {
 	}
 	return sql;
 }
-
 //#endregion
-exports.AGG_FN_SQL = AGG_FN_SQL
-exports.EMPTY_AND = EMPTY_AND
-exports.EMPTY_OR = EMPTY_OR
-exports.buildAggregateCount = buildAggregateCount
-exports.buildAggregateSelect = buildAggregateSelect
-exports.buildCreateView = buildCreateView
-exports.buildDelete = buildDelete
-exports.buildInsert = buildInsert
-exports.buildProjection = buildProjection
-exports.buildSelect = buildSelect
-exports.buildUpdate = buildUpdate
-exports.buildWhere = buildWhere
-exports.createFilterVisitor = createFilterVisitor
-exports.defaultValueForType = defaultValueForType
-exports.defaultValueToSqlLiteral = defaultValueToSqlLiteral
-exports.finalizeParams = finalizeParams
-exports.queryNodeToSql = queryNodeToSql
-exports.queryOpToSql = queryOpToSql
-exports.refActionToSql = refActionToSql
-exports.sqlStringLiteral = sqlStringLiteral
-exports.toSqlValue = toSqlValue
+exports.AGG_FN_SQL = AGG_FN_SQL;
+exports.EMPTY_AND = EMPTY_AND;
+exports.EMPTY_OR = EMPTY_OR;
+exports.buildAggregateCount = buildAggregateCount;
+exports.buildAggregateSelect = buildAggregateSelect;
+exports.buildCreateView = buildCreateView;
+exports.buildDelete = buildDelete;
+exports.buildInsert = buildInsert;
+exports.buildProjection = buildProjection;
+exports.buildSelect = buildSelect;
+exports.buildUpdate = buildUpdate;
+exports.buildWhere = buildWhere;
+exports.createFilterVisitor = createFilterVisitor;
+exports.defaultValueForType = defaultValueForType;
+exports.defaultValueToSqlLiteral = defaultValueToSqlLiteral;
+exports.finalizeParams = finalizeParams;
+exports.queryNodeToSql = queryNodeToSql;
+exports.queryOpToSql = queryOpToSql;
+exports.refActionToSql = refActionToSql;
+exports.sqlStringLiteral = sqlStringLiteral;
+exports.toSqlValue = toSqlValue;

package/dist/{index.d.ts → index.d.cts}

@@ -1,27 +1,28 @@
-import { FilterExpr, FilterVisitor } from '@uniqu/core';
-import { TViewPlan, TViewColumnMapping, AtscriptQueryFieldRef, UniquSelect, DbControls, AtscriptQueryNode, TDbReferentialAction } from '@atscript/db';
+import { FilterExpr, FilterVisitor } from "@uniqu/core";
+import { AtscriptQueryFieldRef, AtscriptQueryNode, DbControls, TDbReferentialAction, TFieldOps, TViewColumnMapping, TViewPlan, UniquSelect } from "@atscript/db";
 
+//#region src/dialect.d.ts
 interface TSqlFragment {
-    sql: string;
-    params: unknown[];
+  sql: string;
+  params: unknown[];
 }
 interface SqlDialect {
-    /** Quotes a column/table name */
-    quoteIdentifier(name: string): string;
-    /** Quotes a possibly schema-qualified table name */
-    quoteTable(name: string): string;
-    /** SQL literal for unlimited LIMIT (SQLite: '-1', MySQL: '18446744073709551615') */
-    unlimitedLimit: string;
-    /** Convert JS value to SQL-bindable param for DML */
-    toValue(value: unknown): unknown;
-    /** Convert JS value to SQL-bindable param for filters (lighter) */
-    toParam(value: unknown): unknown;
-    /** Handle $regex filter */
-    regex(quotedCol: string, value: unknown): TSqlFragment;
-    /** e.g. 'CREATE VIEW IF NOT EXISTS' or 'CREATE OR REPLACE VIEW' */
-    createViewPrefix: string;
-    /** Returns a parameter placeholder for the given 1-based index. When absent, '?' is used. */
-    paramPlaceholder?: (index: number) => string;
+  /** Quotes a column/table name */
+  quoteIdentifier(name: string): string;
+  /** Quotes a possibly schema-qualified table name */
+  quoteTable(name: string): string;
+  /** SQL literal for unlimited LIMIT (SQLite: '-1', MySQL: '18446744073709551615') */
+  unlimitedLimit: string;
+  /** Convert JS value to SQL-bindable param for DML */
+  toValue(value: unknown): unknown;
+  /** Convert JS value to SQL-bindable param for filters (lighter) */
+  toParam(value: unknown): unknown;
+  /** Handle $regex filter */
+  regex(quotedCol: string, value: unknown): TSqlFragment;
+  /** e.g. 'CREATE VIEW IF NOT EXISTS' or 'CREATE OR REPLACE VIEW' */
+  createViewPrefix: string;
+  /** Returns a parameter placeholder for the given 1-based index. When absent, '?' is used. */
+  paramPlaceholder?: (index: number) => string;
 }
 /**
  * Replaces positional `?` placeholders with dialect-specific numbered placeholders
@@ -30,7 +31,8 @@ interface SqlDialect {
 declare function finalizeParams(dialect: SqlDialect, fragment: TSqlFragment): TSqlFragment;
 declare const EMPTY_AND: TSqlFragment;
 declare const EMPTY_OR: TSqlFragment;
-
+//#endregion
+//#region src/filter-builder.d.ts
 /**
  * Creates a dialect-specific filter visitor for `walkFilter`.
  */
@@ -39,7 +41,8 @@ declare function createFilterVisitor(dialect: SqlDialect): FilterVisitor<TSqlFra
  * Translates a filter expression into a parameterized SQL WHERE clause.
  */
 declare function buildWhere(dialect: SqlDialect, filter: FilterExpr): TSqlFragment;
-
+//#endregion
+//#region src/sql-builder.d.ts
 /**
  * Builds an INSERT statement.
  */
@@ -51,7 +54,7 @@ declare function buildSelect(dialect: SqlDialect, table: string, where: TSqlFrag
 /**
  * Builds an UPDATE ... SET ... WHERE statement with optional LIMIT.
  */
-declare function buildUpdate(dialect: SqlDialect, table: string, data: Record<string, unknown>, where: TSqlFragment, limit?: number): TSqlFragment;
+declare function buildUpdate(dialect: SqlDialect, table: string, data: Record<string, unknown>, where: TSqlFragment, limit?: number, ops?: TFieldOps): TSqlFragment;
 /**
  * Builds a DELETE ... WHERE statement with optional LIMIT.
  */
@@ -64,7 +67,8 @@ declare function buildProjection(dialect: SqlDialect, select?: UniquSelect): str
  * Builds a CREATE VIEW statement from a view plan and column mappings.
  */
 declare function buildCreateView(dialect: SqlDialect, viewName: string, plan: TViewPlan, columns: TViewColumnMapping[], resolveFieldRef: (ref: AtscriptQueryFieldRef) => string): string;
-
+//#endregion
+//#region src/common.d.ts
 /** Formats a string value as a SQL literal with single-quote escaping. */
 declare function sqlStringLiteral(value: string): string;
 /** Converts a JS value to a SQL-bindable parameter. Objects/arrays -> JSON, booleans -> 0/1. */
@@ -83,7 +87,8 @@ declare const queryOpToSql: Record<string, string>;
  * Renders an AtscriptQueryNode tree to raw SQL (no parameters -- for DDL use only).
  */
 declare function queryNodeToSql(node: AtscriptQueryNode, resolveFieldRef: (ref: AtscriptQueryFieldRef) => string): string;
-
+//#endregion
+//#region src/agg.d.ts
 declare const AGG_FN_SQL: Record<string, string>;
 /**
  * Builds a SELECT ... GROUP BY statement with aggregate functions.
@@ -94,6 +99,5 @@ declare function buildAggregateSelect(dialect: SqlDialect, table: string, where:
  * Returns `{ count: N }` when executed.
  */
 declare function buildAggregateCount(dialect: SqlDialect, table: string, where: TSqlFragment, controls: DbControls): TSqlFragment;
-
-export { AGG_FN_SQL, EMPTY_AND, EMPTY_OR, buildAggregateCount, buildAggregateSelect, buildCreateView, buildDelete, buildInsert, buildProjection, buildSelect, buildUpdate, buildWhere, createFilterVisitor, defaultValueForType, defaultValueToSqlLiteral, finalizeParams, queryNodeToSql, queryOpToSql, refActionToSql, sqlStringLiteral, toSqlValue };
-export type { SqlDialect, TSqlFragment };
+//#endregion
+export { AGG_FN_SQL, EMPTY_AND, EMPTY_OR, type SqlDialect, type TSqlFragment, buildAggregateCount, buildAggregateSelect, buildCreateView, buildDelete, buildInsert, buildProjection, buildSelect, buildUpdate, buildWhere, createFilterVisitor, defaultValueForType, defaultValueToSqlLiteral, finalizeParams, queryNodeToSql, queryOpToSql, refActionToSql, sqlStringLiteral, toSqlValue };

package/dist/index.d.mts

@@ -0,0 +1,103 @@
+import { FilterExpr, FilterVisitor } from "@uniqu/core";
+import { AtscriptQueryFieldRef, AtscriptQueryNode, DbControls, TDbReferentialAction, TFieldOps, TViewColumnMapping, TViewPlan, UniquSelect } from "@atscript/db";
+
+//#region src/dialect.d.ts
+interface TSqlFragment {
+  sql: string;
+  params: unknown[];
+}
+interface SqlDialect {
+  /** Quotes a column/table name */
+  quoteIdentifier(name: string): string;
+  /** Quotes a possibly schema-qualified table name */
+  quoteTable(name: string): string;
+  /** SQL literal for unlimited LIMIT (SQLite: '-1', MySQL: '18446744073709551615') */
+  unlimitedLimit: string;
+  /** Convert JS value to SQL-bindable param for DML */
+  toValue(value: unknown): unknown;
+  /** Convert JS value to SQL-bindable param for filters (lighter) */
+  toParam(value: unknown): unknown;
+  /** Handle $regex filter */
+  regex(quotedCol: string, value: unknown): TSqlFragment;
+  /** e.g. 'CREATE VIEW IF NOT EXISTS' or 'CREATE OR REPLACE VIEW' */
+  createViewPrefix: string;
+  /** Returns a parameter placeholder for the given 1-based index. When absent, '?' is used. */
+  paramPlaceholder?: (index: number) => string;
+}
+/**
+ * Replaces positional `?` placeholders with dialect-specific numbered placeholders
+ * (e.g. `$1, $2, ...` for PostgreSQL). No-op when `dialect.paramPlaceholder` is not set.
+ */
+declare function finalizeParams(dialect: SqlDialect, fragment: TSqlFragment): TSqlFragment;
+declare const EMPTY_AND: TSqlFragment;
+declare const EMPTY_OR: TSqlFragment;
+//#endregion
+//#region src/filter-builder.d.ts
+/**
+ * Creates a dialect-specific filter visitor for `walkFilter`.
+ */
+declare function createFilterVisitor(dialect: SqlDialect): FilterVisitor<TSqlFragment>;
+/**
+ * Translates a filter expression into a parameterized SQL WHERE clause.
+ */
+declare function buildWhere(dialect: SqlDialect, filter: FilterExpr): TSqlFragment;
+//#endregion
+//#region src/sql-builder.d.ts
+/**
+ * Builds an INSERT statement.
+ */
+declare function buildInsert(dialect: SqlDialect, table: string, data: Record<string, unknown>): TSqlFragment;
+/**
+ * Builds a SELECT statement with optional sort, limit, offset, projection.
+ */
+declare function buildSelect(dialect: SqlDialect, table: string, where: TSqlFragment, controls?: DbControls): TSqlFragment;
+/**
+ * Builds an UPDATE ... SET ... WHERE statement with optional LIMIT.
+ */
+declare function buildUpdate(dialect: SqlDialect, table: string, data: Record<string, unknown>, where: TSqlFragment, limit?: number, ops?: TFieldOps): TSqlFragment;
+/**
+ * Builds a DELETE ... WHERE statement with optional LIMIT.
+ */
+declare function buildDelete(dialect: SqlDialect, table: string, where: TSqlFragment, limit?: number): TSqlFragment;
+/**
+ * Builds a column projection (SELECT clause fields).
+ */
+declare function buildProjection(dialect: SqlDialect, select?: UniquSelect): string;
+/**
+ * Builds a CREATE VIEW statement from a view plan and column mappings.
+ */
+declare function buildCreateView(dialect: SqlDialect, viewName: string, plan: TViewPlan, columns: TViewColumnMapping[], resolveFieldRef: (ref: AtscriptQueryFieldRef) => string): string;
+//#endregion
+//#region src/common.d.ts
+/** Formats a string value as a SQL literal with single-quote escaping. */
+declare function sqlStringLiteral(value: string): string;
+/** Converts a JS value to a SQL-bindable parameter. Objects/arrays -> JSON, booleans -> 0/1. */
+declare function toSqlValue(value: unknown): unknown;
+declare function refActionToSql(action: TDbReferentialAction): string;
+/** Returns a safe SQL DEFAULT literal for a given design type. */
+declare function defaultValueForType(designType: string): string;
+/**
+ * Converts a stored default value string to a SQL DEFAULT literal,
+ * respecting the field's designType. Booleans become 0/1, numbers stay unquoted,
+ * strings are single-quote-escaped.
+ */
+declare function defaultValueToSqlLiteral(designType: string, value: string): string;
+declare const queryOpToSql: Record<string, string>;
+/**
+ * Renders an AtscriptQueryNode tree to raw SQL (no parameters -- for DDL use only).
+ */
+declare function queryNodeToSql(node: AtscriptQueryNode, resolveFieldRef: (ref: AtscriptQueryFieldRef) => string): string;
+//#endregion
+//#region src/agg.d.ts
+declare const AGG_FN_SQL: Record<string, string>;
+/**
+ * Builds a SELECT ... GROUP BY statement with aggregate functions.
+ */
+declare function buildAggregateSelect(dialect: SqlDialect, table: string, where: TSqlFragment, controls: DbControls): TSqlFragment;
+/**
+ * Builds a COUNT query for the number of distinct groups.
+ * Returns `{ count: N }` when executed.
+ */
+declare function buildAggregateCount(dialect: SqlDialect, table: string, where: TSqlFragment, controls: DbControls): TSqlFragment;
+//#endregion
+export { AGG_FN_SQL, EMPTY_AND, EMPTY_OR, type SqlDialect, type TSqlFragment, buildAggregateCount, buildAggregateSelect, buildCreateView, buildDelete, buildInsert, buildProjection, buildSelect, buildUpdate, buildWhere, createFilterVisitor, defaultValueForType, defaultValueToSqlLiteral, finalizeParams, queryNodeToSql, queryOpToSql, refActionToSql, sqlStringLiteral, toSqlValue };

package/dist/index.mjs

@@ -1,13 +1,15 @@
 import { walkFilter } from "@uniqu/core";
 import { resolveAlias } from "@atscript/db/agg";
-
-//#region packages/db-sql-tools/src/dialect.ts
+//#region src/dialect.ts
+/**
+* Replaces positional `?` placeholders with dialect-specific numbered placeholders
+* (e.g. `$1, $2, ...` for PostgreSQL). No-op when `dialect.paramPlaceholder` is not set.
+*/
 function finalizeParams(dialect, fragment) {
 	if (!dialect.paramPlaceholder) return fragment;
 	let idx = 0;
-	const sql = fragment.sql.replace(/\?/g, () => dialect.paramPlaceholder(++idx));
 	return {
-		sql,
+		sql: fragment.sql.replace(/\?/g, () => dialect.paramPlaceholder(++idx)),
 		params: fragment.params
 	};
 }
@@ -19,16 +21,18 @@ const EMPTY_OR = {
 	sql: "0=1",
 	params: []
 };
-
 //#endregion
-//#region packages/db-sql-tools/src/filter-builder.ts
+//#region src/filter-builder.ts
+/**
+* Creates a dialect-specific filter visitor for `walkFilter`.
+*/
 function createFilterVisitor(dialect) {
 	return {
 		comparison(field, op, value) {
 			const col = dialect.quoteIdentifier(field);
 			const v = dialect.toParam(value);
 			switch (op) {
-				case "$eq": {
+				case "$eq":
 					if (v === null) return {
 						sql: `${col} IS NULL`,
 						params: []
@@ -37,8 +41,7 @@ function createFilterVisitor(dialect) {
 						sql: `${col} = ?`,
 						params: [v]
 					};
-				}
-				case "$ne": {
+				case "$ne":
 					if (v === null) return {
 						sql: `${col} IS NOT NULL`,
 						params: []
@@ -47,7 +50,6 @@ function createFilterVisitor(dialect) {
 						sql: `${col} != ?`,
 						params: [v]
 					};
-				}
 				case "$gt": return {
 					sql: `${col} > ?`,
 					params: [v]
@@ -67,18 +69,16 @@ function createFilterVisitor(dialect) {
 				case "$in": {
 					const arr = value.map((x) => dialect.toParam(x));
 					if (arr.length === 0) return EMPTY_OR;
-					const placeholders = arr.map(() => "?").join(", ");
 					return {
-						sql: `${col} IN (${placeholders})`,
+						sql: `${col} IN (${arr.map(() => "?").join(", ")})`,
 						params: arr
 					};
 				}
 				case "$nin": {
 					const arr = value.map((x) => dialect.toParam(x));
 					if (arr.length === 0) return EMPTY_AND;
-					const placeholders = arr.map(() => "?").join(", ");
 					return {
-						sql: `${col} NOT IN (${placeholders})`,
+						sql: `${col} NOT IN (${arr.map(() => "?").join(", ")})`,
 						params: arr
 					};
 				}
@@ -90,7 +90,7 @@ function createFilterVisitor(dialect) {
 					params: []
 				};
 				case "$regex": return dialect.regex(col, value);
-				default: throw new Error(`Unsupported filter operator: ${op}`);
+				default: throw new Error(`Unsupported filter operator: ${String(op)}`);
 			}
 		},
 		and(children) {
@@ -115,7 +115,7 @@ function createFilterVisitor(dialect) {
 		}
 	};
 }
-const visitorCache = new WeakMap();
+const visitorCache = /* @__PURE__ */ new WeakMap();
 function getVisitor(dialect) {
 	let visitor = visitorCache.get(dialect);
 	if (!visitor) {
@@ -124,18 +124,22 @@ function getVisitor(dialect) {
 	}
 	return visitor;
 }
+/**
+* Translates a filter expression into a parameterized SQL WHERE clause.
+*/
 function buildWhere(dialect, filter) {
 	if (!filter || Object.keys(filter).length === 0) return EMPTY_AND;
 	return walkFilter(filter, getVisitor(dialect)) ?? EMPTY_AND;
 }
-
 //#endregion
-//#region packages/db-sql-tools/src/common.ts
+//#region src/common.ts
+/** Formats a string value as a SQL literal with single-quote escaping. */
 function sqlStringLiteral(value) {
 	return `'${value.replace(/'/g, "''")}'`;
 }
+/** Converts a JS value to a SQL-bindable parameter. Objects/arrays -> JSON, booleans -> 0/1. */
 function toSqlValue(value) {
-	if (value === undefined) return null;
+	if (value === void 0) return null;
 	if (value === null) return null;
 	if (typeof value === "object") return JSON.stringify(value);
 	if (typeof value === "boolean") return value ? 1 : 0;
@@ -150,6 +154,7 @@ function refActionToSql(action) {
 		default: return "NO ACTION";
 	}
 }
+/** Returns a safe SQL DEFAULT literal for a given design type. */
 function defaultValueForType(designType) {
 	switch (designType) {
 		case "number":
@@ -159,6 +164,11 @@ function defaultValueForType(designType) {
 		default: return "''";
 	}
 }
+/**
+* Converts a stored default value string to a SQL DEFAULT literal,
+* respecting the field's designType. Booleans become 0/1, numbers stay unquoted,
+* strings are single-quote-escaped.
+*/
 function defaultValueToSqlLiteral(designType, value) {
 	switch (designType) {
 		case "boolean": return value === "true" || value === "1" ? "1" : "0";
@@ -179,27 +189,23 @@ const queryOpToSql = {
 	$lt: "<",
 	$lte: "<="
 };
+/**
+* Renders an AtscriptQueryNode tree to raw SQL (no parameters -- for DDL use only).
+*/
 function queryNodeToSql(node, resolveFieldRef) {
-	if ("$and" in node) {
-		const children = node.$and;
-		return children.map((n) => queryNodeToSql(n, resolveFieldRef)).join(" AND ");
-	}
-	if ("$or" in node) {
-		const children = node.$or;
-		return `(${children.map((n) => queryNodeToSql(n, resolveFieldRef)).join(" OR ")})`;
-	}
+	if ("$and" in node) return node.$and.map((n) => queryNodeToSql(n, resolveFieldRef)).join(" AND ");
+	if ("$or" in node) return `(${node.$or.map((n) => queryNodeToSql(n, resolveFieldRef)).join(" OR ")})`;
 	if ("$not" in node) return `NOT (${queryNodeToSql(node.$not, resolveFieldRef)})`;
 	const comp = node;
 	const leftSql = resolveFieldRef(comp.left);
 	const sqlOp = queryOpToSql[comp.op] || "=";
 	if (comp.right && typeof comp.right === "object" && "field" in comp.right) return `${leftSql} ${sqlOp} ${resolveFieldRef(comp.right)}`;
-	if (comp.right === null || comp.right === undefined) return comp.op === "$ne" ? `${leftSql} IS NOT NULL` : `${leftSql} IS NULL`;
+	if (comp.right === null || comp.right === void 0) return comp.op === "$ne" ? `${leftSql} IS NOT NULL` : `${leftSql} IS NULL`;
 	if (typeof comp.right === "string") return `${leftSql} ${sqlOp} '${comp.right.replace(/'/g, "''")}'`;
 	return `${leftSql} ${sqlOp} ${comp.right}`;
 }
-
 //#endregion
-//#region packages/db-sql-tools/src/agg.ts
+//#region src/agg.ts
 const AGG_FN_SQL = {
 	sum: "SUM",
 	avg: "AVG",
@@ -210,17 +216,18 @@ const AGG_FN_SQL = {
 function buildAggExpr(dialect, expr) {
 	const fn = AGG_FN_SQL[expr.$fn] ?? expr.$fn.toUpperCase();
 	const alias = dialect.quoteIdentifier(resolveAlias(expr));
-	const field = expr.$field === "*" ? "*" : dialect.quoteIdentifier(expr.$field);
-	return `${fn}(${field}) AS ${alias}`;
+	return `${fn}(${expr.$field === "*" ? "*" : dialect.quoteIdentifier(expr.$field)}) AS ${alias}`;
 }
+/**
+* Builds a SELECT ... GROUP BY statement with aggregate functions.
+*/
 function buildAggregateSelect(dialect, table, where, controls) {
 	const selectParts = [];
 	const plainFields = controls.$select?.asArray;
 	if (plainFields) for (const f of plainFields) selectParts.push(dialect.quoteIdentifier(f));
 	const aggregates = controls.$select?.aggregates;
 	if (aggregates) for (const expr of aggregates) selectParts.push(buildAggExpr(dialect, expr));
-	const cols = selectParts.length > 0 ? selectParts.join(", ") : "*";
-	let sql = `SELECT ${cols} FROM ${dialect.quoteTable(table)} WHERE ${where.sql}`;
+	let sql = `SELECT ${selectParts.length > 0 ? selectParts.join(", ") : "*"} FROM ${dialect.quoteTable(table)} WHERE ${where.sql}`;
 	const params = [...where.params];
 	const groupBy = controls.$groupBy;
 	if (groupBy?.length) {
@@ -239,12 +246,12 @@ function buildAggregateSelect(dialect, table, where, controls) {
 		for (const [col, dir] of Object.entries(controls.$sort)) orderParts.push(`${dialect.quoteIdentifier(col)} ${dir === -1 ? "DESC" : "ASC"}`);
 		if (orderParts.length > 0) sql += ` ORDER BY ${orderParts.join(", ")}`;
 	}
-	if (controls.$limit !== undefined) {
+	if (controls.$limit !== void 0) {
 		sql += ` LIMIT ?`;
 		params.push(controls.$limit);
 	}
-	if (controls.$skip !== undefined) {
-		if (controls.$limit === undefined) sql += ` LIMIT ${dialect.unlimitedLimit}`;
+	if (controls.$skip !== void 0) {
+		if (controls.$limit === void 0) sql += ` LIMIT ${dialect.unlimitedLimit}`;
 		sql += ` OFFSET ?`;
 		params.push(controls.$skip);
 	}
@@ -253,25 +260,27 @@ function buildAggregateSelect(dialect, table, where, controls) {
 		params
 	});
 }
+/**
+* Builds a COUNT query for the number of distinct groups.
+* Returns `{ count: N }` when executed.
+*/
 function buildAggregateCount(dialect, table, where, controls) {
 	const groupFields = controls.$groupBy;
-	if (!groupFields?.length) {
-		const sql$1 = `SELECT COUNT(*) AS ${dialect.quoteIdentifier("count")} FROM ${dialect.quoteTable(table)} WHERE ${where.sql}`;
-		return finalizeParams(dialect, {
-			sql: sql$1,
-			params: where.params
-		});
-	}
+	if (!groupFields?.length) return finalizeParams(dialect, {
+		sql: `SELECT COUNT(*) AS ${dialect.quoteIdentifier("count")} FROM ${dialect.quoteTable(table)} WHERE ${where.sql}`,
+		params: where.params
+	});
 	const groupCols = groupFields.map((f) => dialect.quoteIdentifier(f)).join(", ");
-	const sql = `SELECT COUNT(*) AS ${dialect.quoteIdentifier("count")} FROM (SELECT 1 FROM ${dialect.quoteTable(table)} WHERE ${where.sql} GROUP BY ${groupCols}) AS ${dialect.quoteIdentifier("_groups")}`;
 	return finalizeParams(dialect, {
-		sql,
+		sql: `SELECT COUNT(*) AS ${dialect.quoteIdentifier("count")} FROM (SELECT 1 FROM ${dialect.quoteTable(table)} WHERE ${where.sql} GROUP BY ${groupCols}) AS ${dialect.quoteIdentifier("_groups")}`,
 		params: where.params
 	});
 }
-
 //#endregion
-//#region packages/db-sql-tools/src/sql-builder.ts
+//#region src/sql-builder.ts
+/**
+* Builds an INSERT statement.
+*/
 function buildInsert(dialect, table, data) {
 	const keys = Object.keys(data);
 	const cols = keys.map((k) => dialect.quoteIdentifier(k)).join(", ");
@@ -281,21 +290,23 @@ function buildInsert(dialect, table, data) {
 		params: keys.map((k) => dialect.toValue(data[k]))
 	});
 }
+/**
+* Builds a SELECT statement with optional sort, limit, offset, projection.
+*/
 function buildSelect(dialect, table, where, controls) {
-	const cols = buildProjection(dialect, controls?.$select);
-	let sql = `SELECT ${cols} FROM ${dialect.quoteTable(table)} WHERE ${where.sql}`;
+	let sql = `SELECT ${buildProjection(dialect, controls?.$select)} FROM ${dialect.quoteTable(table)} WHERE ${where.sql}`;
 	const params = [...where.params];
 	if (controls?.$sort) {
 		const orderParts = [];
 		for (const [col, dir] of Object.entries(controls.$sort)) orderParts.push(`${dialect.quoteIdentifier(col)} ${dir === -1 ? "DESC" : "ASC"}`);
 		if (orderParts.length > 0) sql += ` ORDER BY ${orderParts.join(", ")}`;
 	}
-	if (controls?.$limit !== undefined) {
+	if (controls?.$limit !== void 0) {
 		sql += ` LIMIT ?`;
 		params.push(controls.$limit);
 	}
-	if (controls?.$skip !== undefined) {
-		if (controls.$limit === undefined) sql += ` LIMIT ${dialect.unlimitedLimit}`;
+	if (controls?.$skip !== void 0) {
+		if (controls.$limit === void 0) sql += ` LIMIT ${dialect.unlimitedLimit}`;
 		sql += ` OFFSET ?`;
 		params.push(controls.$skip);
 	}
@@ -304,28 +315,47 @@ function buildSelect(dialect, table, where, controls) {
 		params
 	});
 }
-function buildUpdate(dialect, table, data, where, limit) {
+/**
+* Builds an UPDATE ... SET ... WHERE statement with optional LIMIT.
+*/
+function buildUpdate(dialect, table, data, where, limit, ops) {
 	const setClauses = [];
 	const params = [];
 	for (const [key, value] of Object.entries(data)) {
 		setClauses.push(`${dialect.quoteIdentifier(key)} = ?`);
 		params.push(dialect.toValue(value));
 	}
+	if (ops?.inc) for (const key in ops.inc) {
+		const col = dialect.quoteIdentifier(key);
+		setClauses.push(`${col} = ${col} + ?`);
+		params.push(ops.inc[key]);
+	}
+	if (ops?.mul) for (const key in ops.mul) {
+		const col = dialect.quoteIdentifier(key);
+		setClauses.push(`${col} = ${col} * ?`);
+		params.push(ops.mul[key]);
+	}
 	let sql = `UPDATE ${dialect.quoteTable(table)} SET ${setClauses.join(", ")} WHERE ${where.sql}`;
-	if (limit !== undefined) sql += ` LIMIT ${limit}`;
+	if (limit !== void 0) sql += ` LIMIT ${limit}`;
 	return finalizeParams(dialect, {
 		sql,
 		params: [...params, ...where.params]
 	});
 }
+/**
+* Builds a DELETE ... WHERE statement with optional LIMIT.
+*/
 function buildDelete(dialect, table, where, limit) {
 	let sql = `DELETE FROM ${dialect.quoteTable(table)} WHERE ${where.sql}`;
-	if (limit !== undefined) sql += ` LIMIT ${limit}`;
+	if (limit !== void 0) sql += ` LIMIT ${limit}`;
 	return finalizeParams(dialect, {
 		sql,
 		params: where.params
 	});
 }
+/**
+* Builds a column projection (SELECT clause fields).
+*/
 function buildProjection(dialect, select) {
 	const fields = select?.asArray;
 	if (!fields) return "*";
@@ -336,11 +366,13 @@ function buildProjection(dialect, select) {
 	}
 	return sql || "*";
 }
-/** Builds the SQL expression for a single aggregate column. */ function buildAggColExpr(dialect, c) {
-	const fn = AGG_FN_SQL[c.aggFn] ?? c.aggFn.toUpperCase();
-	const arg = c.aggField === "*" ? "*" : `${dialect.quoteIdentifier(c.sourceTable)}.${dialect.quoteIdentifier(c.sourceColumn)}`;
-	return `${fn}(${arg})`;
+/** Builds the SQL expression for a single aggregate column. */
+function buildAggColExpr(dialect, c) {
+	return `${AGG_FN_SQL[c.aggFn] ?? c.aggFn.toUpperCase()}(${c.aggField === "*" ? "*" : `${dialect.quoteIdentifier(c.sourceTable)}.${dialect.quoteIdentifier(c.sourceColumn)}`})`;
 }
+/**
+* Builds a CREATE VIEW statement from a view plan and column mappings.
+*/
 function buildCreateView(dialect, viewName, plan, columns, resolveFieldRef) {
 	const selectCols = columns.map((c) => {
 		if (c.aggFn) return `${buildAggColExpr(dialect, c)} AS ${dialect.quoteIdentifier(c.viewColumn)}`;
@@ -355,15 +387,14 @@ function buildCreateView(dialect, viewName, plan, columns, resolveFieldRef) {
 		const whereClause = queryNodeToSql(plan.filter, resolveFieldRef);
 		sql += ` WHERE ${whereClause}`;
 	}
-	const hasAggregates = columns.some((c) => c.aggFn);
-	if (hasAggregates) {
+	if (columns.some((c) => c.aggFn)) {
 		const dimensionCols = columns.filter((c) => !c.aggFn);
 		if (dimensionCols.length > 0) {
 			const groupByCols = dimensionCols.map((c) => `${dialect.quoteIdentifier(c.sourceTable)}.${dialect.quoteIdentifier(c.sourceColumn)}`).join(", ");
 			sql += ` GROUP BY ${groupByCols}`;
 		}
 		if (plan.having) {
-			const columnMap = new Map();
+			const columnMap = /* @__PURE__ */ new Map();
 			for (const c of columns) columnMap.set(c.viewColumn, c);
 			const havingResolver = (ref) => {
 				if (!ref.type) {
@@ -379,6 +410,5 @@ function buildCreateView(dialect, viewName, plan, columns, resolveFieldRef) {
 	}
 	return sql;
 }
-
 //#endregion
-export { AGG_FN_SQL, EMPTY_AND, EMPTY_OR, buildAggregateCount, buildAggregateSelect, buildCreateView, buildDelete, buildInsert, buildProjection, buildSelect, buildUpdate, buildWhere, createFilterVisitor, defaultValueForType, defaultValueToSqlLiteral, finalizeParams, queryNodeToSql, queryOpToSql, refActionToSql, sqlStringLiteral, toSqlValue };
+export { AGG_FN_SQL, EMPTY_AND, EMPTY_OR, buildAggregateCount, buildAggregateSelect, buildCreateView, buildDelete, buildInsert, buildProjection, buildSelect, buildUpdate, buildWhere, createFilterVisitor, defaultValueForType, defaultValueToSqlLiteral, finalizeParams, queryNodeToSql, queryOpToSql, refActionToSql, sqlStringLiteral, toSqlValue };

package/package.json

@@ -1,21 +1,21 @@
 {
   "name": "@atscript/db-sql-tools",
-  "version": "0.1.38",
+  "version": "0.1.40",
   "description": "Shared SQL builder utilities for @atscript database adapters.",
   "keywords": [
     "atscript",
     "database",
     "sql"
   ],
-  "homepage": "https://github.com/moostjs/atscript/tree/main/packages/db-sql-tools#readme",
+  "homepage": "https://github.com/moostjs/atscript-db/tree/main/packages/db-sql-tools#readme",
   "bugs": {
-    "url": "https://github.com/moostjs/atscript/issues"
+    "url": "https://github.com/moostjs/atscript-db/issues"
   },
   "license": "MIT",
   "author": "Artem Maltsev",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/moostjs/atscript.git",
+    "url": "git+https://github.com/moostjs/atscript-db.git",
     "directory": "packages/db-sql-tools"
   },
   "files": [
@@ -23,24 +23,31 @@
   ],
   "type": "module",
   "main": "dist/index.mjs",
-  "types": "dist/index.d.ts",
+  "module": "./dist/index.mjs",
+  "types": "dist/index.d.mts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
+      "types": "./dist/index.d.mts",
       "import": "./dist/index.mjs",
       "require": "./dist/index.cjs"
     },
     "./package.json": "./package.json"
   },
+  "publishConfig": {
+    "access": "public"
+  },
   "devDependencies": {
-    "vitest": "3.2.4"
+    "@uniqu/core": "^0.1.2",
+    "unplugin-atscript": "^0.1.39"
   },
   "peerDependencies": {
     "@uniqu/core": "^0.1.2",
-    "@atscript/db": "^0.1.38"
+    "@atscript/db": "^0.1.40"
   },
   "scripts": {
-    "pub": "pnpm publish --access public",
-    "test": "vitest"
+    "build": "vp pack",
+    "dev": "vp pack --watch",
+    "test": "vp test",
+    "check": "vp check"
   }
 }

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2025-present Artem Maltsev
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.