@atscript/db-sql-tools 0.1.150 → 0.1.152

package/dist/index.cjs

@@ -6,15 +6,133 @@ let _atscript_db_agg = require("@atscript/db/agg");
 /**
 * Replaces positional `?` placeholders with dialect-specific numbered placeholders
 * (e.g. `$1, $2, ...` for PostgreSQL). No-op when `dialect.paramPlaceholder` is not set.
+*
+* Only a `?` in plain SQL text is a placeholder: one inside a string literal
+* (`'…'`, `E'…'`, `$tag$…$tag$`), a quoted identifier (`"…"`) or a comment
+* (`-- …`, `/* … *\/`) is left alone, and so are PostgreSQL's jsonb operators
+* `?|` / `?&` (a placeholder directly followed by `|` / `&` is only ever
+* `?||` / `?&&`, the concatenation / overlap). `??` is an escaped literal
+* `?` — how a builder writes the bare jsonb `?` operator and any other
+* operator that contains `?` (`@?` → `@??`, `?#` → `??#`, `?-` → `??-`).
+* Block comments nest, as in PostgreSQL.
 */
 function finalizeParams(dialect, fragment) {
-	if (!dialect.paramPlaceholder) return fragment;
+	const placeholder = dialect.paramPlaceholder;
+	if (!placeholder) return fragment;
+	const s = fragment.sql;
+	if (s.indexOf("?") === -1) return fragment;
+	let out = "";
+	let last = 0;
 	let idx = 0;
+	const n = s.length;
+	let i = 0;
+	while (i < n) {
+		const c = s.charCodeAt(i);
+		if (c === QMARK) {
+			const next = s.charCodeAt(i + 1);
+			if (next === QMARK) {
+				out += s.slice(last, i + 1);
+				last = i + 2;
+				i += 2;
+			} else if (next === PIPE && s.charCodeAt(i + 2) !== PIPE || next === AMP && s.charCodeAt(i + 2) !== AMP) i += 2;
+			else {
+				out += s.slice(last, i) + placeholder(++idx);
+				last = ++i;
+			}
+		} else if (c === DQUOTE) i = skipQuotedIdentifier(s, i);
+		else if (c === SQUOTE) i = skipStringLiteral(s, i);
+		else if (c === DASH && s.charCodeAt(i + 1) === DASH) {
+			const end = s.indexOf("\n", i + 2);
+			i = end === -1 ? n : end + 1;
+		} else if (c === SLASH && s.charCodeAt(i + 1) === STAR) i = skipBlockComment(s, i);
+		else if (c === DOLLAR) i = skipDollarQuoted(s, i);
+		else i++;
+	}
 	return {
-		sql: fragment.sql.replace(/\?/g, () => dialect.paramPlaceholder(++idx)),
+		sql: last === 0 ? s : out + s.slice(last),
 		params: fragment.params
 	};
 }
+const QMARK = 63;
+const PIPE = 124;
+const AMP = 38;
+const BACKSLASH = 92;
+const SQUOTE = 39;
+const DQUOTE = 34;
+const DASH = 45;
+const SLASH = 47;
+const STAR = 42;
+const DOLLAR = 36;
+/** Index just past the `"…"` identifier opening at `at` (`""` escapes a quote). */
+function skipQuotedIdentifier(s, at) {
+	let i = at + 1;
+	for (;;) {
+		const end = s.indexOf("\"", i);
+		if (end === -1) return s.length;
+		if (s.charCodeAt(end + 1) !== DQUOTE) return end + 1;
+		i = end + 2;
+	}
+}
+/**
+* Index just past the `'…'` literal opening at `at` (`''` escapes a quote; in
+* a PostgreSQL `E'…'` escape string a backslash escapes the next char too).
+*/
+function skipStringLiteral(s, at) {
+	const prev = at > 0 ? s.charCodeAt(at - 1) : 0;
+	const escapes = (prev === 69 || prev === 101) && (at < 2 || !isIdentChar(s.charCodeAt(at - 2)));
+	let i = at + 1;
+	for (;;) {
+		const end = s.indexOf("'", i);
+		if (end === -1) return s.length;
+		if (escapes) {
+			let k = end - 1;
+			while (k > at && s.charCodeAt(k) === BACKSLASH) k--;
+			if ((end - 1 - k) % 2 === 1) {
+				i = end + 1;
+				continue;
+			}
+		}
+		if (s.charCodeAt(end + 1) !== SQUOTE) return end + 1;
+		i = end + 2;
+	}
+}
+/** Index just past the `/* … *\/` comment opening at `at` (comments nest, as in PostgreSQL). */
+function skipBlockComment(s, at) {
+	let depth = 1;
+	let i = at + 2;
+	while (i < s.length) {
+		const c = s.charCodeAt(i);
+		if (c === STAR && s.charCodeAt(i + 1) === SLASH) {
+			i += 2;
+			if (--depth === 0) return i;
+		} else if (c === SLASH && s.charCodeAt(i + 1) === STAR) {
+			depth++;
+			i += 2;
+		} else i++;
+	}
+	return s.length;
+}
+/**
+* Index just past the dollar-quoted string (`$$…$$`, `$tag$…$tag$`) opening at
+* `at`, or `at + 1` when the `$` opens none (a `$1` placeholder, a `$` inside
+* an identifier).
+*/
+function skipDollarQuoted(s, at) {
+	if (at > 0 && isIdentChar(s.charCodeAt(at - 1))) return at + 1;
+	let j = at + 1;
+	const first = s.charCodeAt(j);
+	if (first !== DOLLAR) {
+		if (!(first >= 65 && first <= 90 || first >= 97 && first <= 122 || first === 95)) return at + 1;
+		while (j < s.length && isIdentChar(s.charCodeAt(j)) && s.charCodeAt(j) !== DOLLAR) j++;
+		if (s.charCodeAt(j) !== DOLLAR) return at + 1;
+	}
+	const tag = s.slice(at, j + 1);
+	const end = s.indexOf(tag, j + 1);
+	return end === -1 ? s.length : end + tag.length;
+}
+function isIdentChar(c) {
+	return c >= 48 && c <= 57 || c >= 65 && c <= 90 || c >= 97 && c <= 122 || c === 95 || c === 36;
+}
 /**
 * How HAVING references a grouped NON-column expression (a calendar bucket, a
 * view's JSON-extracted dimension): its quoted SELECT `alias` on dialects that
@@ -952,6 +1070,59 @@ function buildInsert(dialect, table, data) {
 	});
 }
 /**
+* Single-row INSERT builder that reuses the statement text per column
+* signature — the same SQL {@link buildInsert} renders, built once per
+* distinct key list (in order) of the rows of one table instead of per row.
+* Bounded: once `max` signatures are held the cache starts over.
+* @since 0.1.151
+*/
+var InsertSqlCache = class {
+	_dialect;
+	_max;
+	_sql = /* @__PURE__ */ new Map();
+	_table;
+	/** The previous row's keys and SQL — a batch of one shape skips the signature. */
+	_lastKeys;
+	_lastSql = "";
+	constructor(_dialect, _max = 64) {
+		this._dialect = _dialect;
+		this._max = _max;
+	}
+	build(table, data) {
+		if (table !== this._table) {
+			this._sql.clear();
+			this._table = table;
+			this._lastKeys = void 0;
+		}
+		const keys = Object.keys(data);
+		let sql;
+		if (this._lastKeys !== void 0 && sameKeys(this._lastKeys, keys)) sql = this._lastSql;
+		else {
+			const signature = keys.join("\0");
+			sql = this._sql.get(signature);
+			if (sql === void 0) {
+				sql = buildInsert(this._dialect, table, data).sql;
+				if (this._sql.size >= this._max) this._sql.clear();
+				this._sql.set(signature, sql);
+			}
+			this._lastKeys = keys;
+			this._lastSql = sql;
+		}
+		const dialect = this._dialect;
+		const params = [];
+		for (const key of keys) params.push(dialect.toValue(data[key]));
+		return {
+			sql,
+			params
+		};
+	}
+};
+function sameKeys(a, b) {
+	if (a.length !== b.length) return false;
+	for (let i = 0; i < a.length; i++) if (a[i] !== b[i]) return false;
+	return true;
+}
+/**
 * The columns of a multi-row INSERT: the union of the rows' keys, in
 * first-seen order (rows may differ in shape — an optional field omitted on
 * some).
@@ -1459,6 +1630,7 @@ exports.AGG_FN_SQL = AGG_FN_SQL;
 exports.EMPTY_AND = EMPTY_AND;
 exports.EMPTY_OR = EMPTY_OR;
 exports.GEO_DISTANCE_ALIAS = GEO_DISTANCE_ALIAS;
+exports.InsertSqlCache = InsertSqlCache;
 exports.PARTITION_ROW_NUMBER_ALIAS = PARTITION_ROW_NUMBER_ALIAS;
 exports.SEARCH_SOURCE_ALIAS = SEARCH_SOURCE_ALIAS;
 exports.SQL_DEFAULT = SQL_DEFAULT;

package/dist/index.d.cts

@@ -150,6 +150,15 @@ interface SqlDialect {
 /**
  * Replaces positional `?` placeholders with dialect-specific numbered placeholders
  * (e.g. `$1, $2, ...` for PostgreSQL). No-op when `dialect.paramPlaceholder` is not set.
+ *
+ * Only a `?` in plain SQL text is a placeholder: one inside a string literal
+ * (`'…'`, `E'…'`, `$tag$…$tag$`), a quoted identifier (`"…"`) or a comment
+ * (`-- …`, `/* … *\/`) is left alone, and so are PostgreSQL's jsonb operators
+ * `?|` / `?&` (a placeholder directly followed by `|` / `&` is only ever
+ * `?||` / `?&&`, the concatenation / overlap). `??` is an escaped literal
+ * `?` — how a builder writes the bare jsonb `?` operator and any other
+ * operator that contains `?` (`@?` → `@??`, `?#` → `??#`, `?-` → `??-`).
+ * Block comments nest, as in PostgreSQL.
  */
 declare function finalizeParams(dialect: SqlDialect, fragment: TSqlFragment): TSqlFragment;
 /**
@@ -404,6 +413,24 @@ declare function buildCreateView(dialect: SqlDialect, viewName: string, plan: TV
  * Builds an INSERT statement.
  */
 declare function buildInsert(dialect: SqlDialect, table: string, data: Record<string, unknown>): TSqlFragment;
+/**
+ * Single-row INSERT builder that reuses the statement text per column
+ * signature — the same SQL {@link buildInsert} renders, built once per
+ * distinct key list (in order) of the rows of one table instead of per row.
+ * Bounded: once `max` signatures are held the cache starts over.
+ * @since 0.1.151
+ */
+declare class InsertSqlCache {
+  private readonly _dialect;
+  private readonly _max;
+  private readonly _sql;
+  private _table?;
+  /** The previous row's keys and SQL — a batch of one shape skips the signature. */
+  private _lastKeys?;
+  private _lastSql;
+  constructor(_dialect: SqlDialect, _max?: number);
+  build(table: string, data: Record<string, unknown>): TSqlFragment;
+}
 /**
  * The columns of a multi-row INSERT: the union of the rows' keys, in
  * first-seen order (rows may differ in shape — an optional field omitted on
@@ -638,4 +665,4 @@ declare function parseRegexString(value: unknown): {
   flags: string;
 };
 //#endregion
-export { AGG_FN_SQL, EMPTY_AND, EMPTY_OR, GEO_DISTANCE_ALIAS, PARTITION_ROW_NUMBER_ALIAS, SEARCH_SOURCE_ALIAS, SQL_DEFAULT, type SqlDialect, type TArithFailure, type TFilterVisitorOptions, type TGeoCircle, type TGeoSearchControls, type TGeoWindow, type TReplaceColumn, type TSqlFragment, VECTOR_DISTANCE_ALIAS, arithOverflowError, buildAggregateCount, buildAggregateSelect, buildCreateView, buildDelete, buildGeoSearchCount, buildGeoSearchSelect, buildInsert, buildInsertMany, buildPartitionedSelect, buildProjection, buildSelect, buildUpdate, buildVectorSearchCount, buildVectorSearchSelect, buildWhere, chunkInsertRows, createFilterVisitor, defaultValueForType, defaultValueToSqlLiteral, derivedColumnExpr, fillReplacePayload, finalizeParams, foreignKeySql, geoWindowFromControls, groupKeySql, insertManyColumns, jsonDollarPath, mapQueryErrors, normalizeGeoPointValue, numericOutOfRangeError, orFragment, orderKeySql, parseRegexString, queryNodeToSql, queryOpToSql, quotedJsonPathSegments, refActionToSql, renameGeoDistance, renderArith, replaceColumnsFor, sqlStringLiteral, sqlTimeZoneLiteral, stripPartitionRowNumber, toSqlValue, vectorDistanceSource };
+export { AGG_FN_SQL, EMPTY_AND, EMPTY_OR, GEO_DISTANCE_ALIAS, InsertSqlCache, PARTITION_ROW_NUMBER_ALIAS, SEARCH_SOURCE_ALIAS, SQL_DEFAULT, type SqlDialect, type TArithFailure, type TFilterVisitorOptions, type TGeoCircle, type TGeoSearchControls, type TGeoWindow, type TReplaceColumn, type TSqlFragment, VECTOR_DISTANCE_ALIAS, arithOverflowError, buildAggregateCount, buildAggregateSelect, buildCreateView, buildDelete, buildGeoSearchCount, buildGeoSearchSelect, buildInsert, buildInsertMany, buildPartitionedSelect, buildProjection, buildSelect, buildUpdate, buildVectorSearchCount, buildVectorSearchSelect, buildWhere, chunkInsertRows, createFilterVisitor, defaultValueForType, defaultValueToSqlLiteral, derivedColumnExpr, fillReplacePayload, finalizeParams, foreignKeySql, geoWindowFromControls, groupKeySql, insertManyColumns, jsonDollarPath, mapQueryErrors, normalizeGeoPointValue, numericOutOfRangeError, orFragment, orderKeySql, parseRegexString, queryNodeToSql, queryOpToSql, quotedJsonPathSegments, refActionToSql, renameGeoDistance, renderArith, replaceColumnsFor, sqlStringLiteral, sqlTimeZoneLiteral, stripPartitionRowNumber, toSqlValue, vectorDistanceSource };

package/dist/index.d.mts

@@ -150,6 +150,15 @@ interface SqlDialect {
 /**
  * Replaces positional `?` placeholders with dialect-specific numbered placeholders
  * (e.g. `$1, $2, ...` for PostgreSQL). No-op when `dialect.paramPlaceholder` is not set.
+ *
+ * Only a `?` in plain SQL text is a placeholder: one inside a string literal
+ * (`'…'`, `E'…'`, `$tag$…$tag$`), a quoted identifier (`"…"`) or a comment
+ * (`-- …`, `/* … *\/`) is left alone, and so are PostgreSQL's jsonb operators
+ * `?|` / `?&` (a placeholder directly followed by `|` / `&` is only ever
+ * `?||` / `?&&`, the concatenation / overlap). `??` is an escaped literal
+ * `?` — how a builder writes the bare jsonb `?` operator and any other
+ * operator that contains `?` (`@?` → `@??`, `?#` → `??#`, `?-` → `??-`).
+ * Block comments nest, as in PostgreSQL.
  */
 declare function finalizeParams(dialect: SqlDialect, fragment: TSqlFragment): TSqlFragment;
 /**
@@ -404,6 +413,24 @@ declare function buildCreateView(dialect: SqlDialect, viewName: string, plan: TV
  * Builds an INSERT statement.
  */
 declare function buildInsert(dialect: SqlDialect, table: string, data: Record<string, unknown>): TSqlFragment;
+/**
+ * Single-row INSERT builder that reuses the statement text per column
+ * signature — the same SQL {@link buildInsert} renders, built once per
+ * distinct key list (in order) of the rows of one table instead of per row.
+ * Bounded: once `max` signatures are held the cache starts over.
+ * @since 0.1.151
+ */
+declare class InsertSqlCache {
+  private readonly _dialect;
+  private readonly _max;
+  private readonly _sql;
+  private _table?;
+  /** The previous row's keys and SQL — a batch of one shape skips the signature. */
+  private _lastKeys?;
+  private _lastSql;
+  constructor(_dialect: SqlDialect, _max?: number);
+  build(table: string, data: Record<string, unknown>): TSqlFragment;
+}
 /**
  * The columns of a multi-row INSERT: the union of the rows' keys, in
  * first-seen order (rows may differ in shape — an optional field omitted on
@@ -638,4 +665,4 @@ declare function parseRegexString(value: unknown): {
   flags: string;
 };
 //#endregion
-export { AGG_FN_SQL, EMPTY_AND, EMPTY_OR, GEO_DISTANCE_ALIAS, PARTITION_ROW_NUMBER_ALIAS, SEARCH_SOURCE_ALIAS, SQL_DEFAULT, type SqlDialect, type TArithFailure, type TFilterVisitorOptions, type TGeoCircle, type TGeoSearchControls, type TGeoWindow, type TReplaceColumn, type TSqlFragment, VECTOR_DISTANCE_ALIAS, arithOverflowError, buildAggregateCount, buildAggregateSelect, buildCreateView, buildDelete, buildGeoSearchCount, buildGeoSearchSelect, buildInsert, buildInsertMany, buildPartitionedSelect, buildProjection, buildSelect, buildUpdate, buildVectorSearchCount, buildVectorSearchSelect, buildWhere, chunkInsertRows, createFilterVisitor, defaultValueForType, defaultValueToSqlLiteral, derivedColumnExpr, fillReplacePayload, finalizeParams, foreignKeySql, geoWindowFromControls, groupKeySql, insertManyColumns, jsonDollarPath, mapQueryErrors, normalizeGeoPointValue, numericOutOfRangeError, orFragment, orderKeySql, parseRegexString, queryNodeToSql, queryOpToSql, quotedJsonPathSegments, refActionToSql, renameGeoDistance, renderArith, replaceColumnsFor, sqlStringLiteral, sqlTimeZoneLiteral, stripPartitionRowNumber, toSqlValue, vectorDistanceSource };
+export { AGG_FN_SQL, EMPTY_AND, EMPTY_OR, GEO_DISTANCE_ALIAS, InsertSqlCache, PARTITION_ROW_NUMBER_ALIAS, SEARCH_SOURCE_ALIAS, SQL_DEFAULT, type SqlDialect, type TArithFailure, type TFilterVisitorOptions, type TGeoCircle, type TGeoSearchControls, type TGeoWindow, type TReplaceColumn, type TSqlFragment, VECTOR_DISTANCE_ALIAS, arithOverflowError, buildAggregateCount, buildAggregateSelect, buildCreateView, buildDelete, buildGeoSearchCount, buildGeoSearchSelect, buildInsert, buildInsertMany, buildPartitionedSelect, buildProjection, buildSelect, buildUpdate, buildVectorSearchCount, buildVectorSearchSelect, buildWhere, chunkInsertRows, createFilterVisitor, defaultValueForType, defaultValueToSqlLiteral, derivedColumnExpr, fillReplacePayload, finalizeParams, foreignKeySql, geoWindowFromControls, groupKeySql, insertManyColumns, jsonDollarPath, mapQueryErrors, normalizeGeoPointValue, numericOutOfRangeError, orFragment, orderKeySql, parseRegexString, queryNodeToSql, queryOpToSql, quotedJsonPathSegments, refActionToSql, renameGeoDistance, renderArith, replaceColumnsFor, sqlStringLiteral, sqlTimeZoneLiteral, stripPartitionRowNumber, toSqlValue, vectorDistanceSource };

package/dist/index.mjs

@@ -5,15 +5,133 @@ import { assertAggregateFn, resolveAlias } from "@atscript/db/agg";
 /**
 * Replaces positional `?` placeholders with dialect-specific numbered placeholders
 * (e.g. `$1, $2, ...` for PostgreSQL). No-op when `dialect.paramPlaceholder` is not set.
+*
+* Only a `?` in plain SQL text is a placeholder: one inside a string literal
+* (`'…'`, `E'…'`, `$tag$…$tag$`), a quoted identifier (`"…"`) or a comment
+* (`-- …`, `/* … *\/`) is left alone, and so are PostgreSQL's jsonb operators
+* `?|` / `?&` (a placeholder directly followed by `|` / `&` is only ever
+* `?||` / `?&&`, the concatenation / overlap). `??` is an escaped literal
+* `?` — how a builder writes the bare jsonb `?` operator and any other
+* operator that contains `?` (`@?` → `@??`, `?#` → `??#`, `?-` → `??-`).
+* Block comments nest, as in PostgreSQL.
 */
 function finalizeParams(dialect, fragment) {
-	if (!dialect.paramPlaceholder) return fragment;
+	const placeholder = dialect.paramPlaceholder;
+	if (!placeholder) return fragment;
+	const s = fragment.sql;
+	if (s.indexOf("?") === -1) return fragment;
+	let out = "";
+	let last = 0;
 	let idx = 0;
+	const n = s.length;
+	let i = 0;
+	while (i < n) {
+		const c = s.charCodeAt(i);
+		if (c === QMARK) {
+			const next = s.charCodeAt(i + 1);
+			if (next === QMARK) {
+				out += s.slice(last, i + 1);
+				last = i + 2;
+				i += 2;
+			} else if (next === PIPE && s.charCodeAt(i + 2) !== PIPE || next === AMP && s.charCodeAt(i + 2) !== AMP) i += 2;
+			else {
+				out += s.slice(last, i) + placeholder(++idx);
+				last = ++i;
+			}
+		} else if (c === DQUOTE) i = skipQuotedIdentifier(s, i);
+		else if (c === SQUOTE) i = skipStringLiteral(s, i);
+		else if (c === DASH && s.charCodeAt(i + 1) === DASH) {
+			const end = s.indexOf("\n", i + 2);
+			i = end === -1 ? n : end + 1;
+		} else if (c === SLASH && s.charCodeAt(i + 1) === STAR) i = skipBlockComment(s, i);
+		else if (c === DOLLAR) i = skipDollarQuoted(s, i);
+		else i++;
+	}
 	return {
-		sql: fragment.sql.replace(/\?/g, () => dialect.paramPlaceholder(++idx)),
+		sql: last === 0 ? s : out + s.slice(last),
 		params: fragment.params
 	};
 }
+const QMARK = 63;
+const PIPE = 124;
+const AMP = 38;
+const BACKSLASH = 92;
+const SQUOTE = 39;
+const DQUOTE = 34;
+const DASH = 45;
+const SLASH = 47;
+const STAR = 42;
+const DOLLAR = 36;
+/** Index just past the `"…"` identifier opening at `at` (`""` escapes a quote). */
+function skipQuotedIdentifier(s, at) {
+	let i = at + 1;
+	for (;;) {
+		const end = s.indexOf("\"", i);
+		if (end === -1) return s.length;
+		if (s.charCodeAt(end + 1) !== DQUOTE) return end + 1;
+		i = end + 2;
+	}
+}
+/**
+* Index just past the `'…'` literal opening at `at` (`''` escapes a quote; in
+* a PostgreSQL `E'…'` escape string a backslash escapes the next char too).
+*/
+function skipStringLiteral(s, at) {
+	const prev = at > 0 ? s.charCodeAt(at - 1) : 0;
+	const escapes = (prev === 69 || prev === 101) && (at < 2 || !isIdentChar(s.charCodeAt(at - 2)));
+	let i = at + 1;
+	for (;;) {
+		const end = s.indexOf("'", i);
+		if (end === -1) return s.length;
+		if (escapes) {
+			let k = end - 1;
+			while (k > at && s.charCodeAt(k) === BACKSLASH) k--;
+			if ((end - 1 - k) % 2 === 1) {
+				i = end + 1;
+				continue;
+			}
+		}
+		if (s.charCodeAt(end + 1) !== SQUOTE) return end + 1;
+		i = end + 2;
+	}
+}
+/** Index just past the `/* … *\/` comment opening at `at` (comments nest, as in PostgreSQL). */
+function skipBlockComment(s, at) {
+	let depth = 1;
+	let i = at + 2;
+	while (i < s.length) {
+		const c = s.charCodeAt(i);
+		if (c === STAR && s.charCodeAt(i + 1) === SLASH) {
+			i += 2;
+			if (--depth === 0) return i;
+		} else if (c === SLASH && s.charCodeAt(i + 1) === STAR) {
+			depth++;
+			i += 2;
+		} else i++;
+	}
+	return s.length;
+}
+/**
+* Index just past the dollar-quoted string (`$$…$$`, `$tag$…$tag$`) opening at
+* `at`, or `at + 1` when the `$` opens none (a `$1` placeholder, a `$` inside
+* an identifier).
+*/
+function skipDollarQuoted(s, at) {
+	if (at > 0 && isIdentChar(s.charCodeAt(at - 1))) return at + 1;
+	let j = at + 1;
+	const first = s.charCodeAt(j);
+	if (first !== DOLLAR) {
+		if (!(first >= 65 && first <= 90 || first >= 97 && first <= 122 || first === 95)) return at + 1;
+		while (j < s.length && isIdentChar(s.charCodeAt(j)) && s.charCodeAt(j) !== DOLLAR) j++;
+		if (s.charCodeAt(j) !== DOLLAR) return at + 1;
+	}
+	const tag = s.slice(at, j + 1);
+	const end = s.indexOf(tag, j + 1);
+	return end === -1 ? s.length : end + tag.length;
+}
+function isIdentChar(c) {
+	return c >= 48 && c <= 57 || c >= 65 && c <= 90 || c >= 97 && c <= 122 || c === 95 || c === 36;
+}
 /**
 * How HAVING references a grouped NON-column expression (a calendar bucket, a
 * view's JSON-extracted dimension): its quoted SELECT `alias` on dialects that
@@ -951,6 +1069,59 @@ function buildInsert(dialect, table, data) {
 	});
 }
 /**
+* Single-row INSERT builder that reuses the statement text per column
+* signature — the same SQL {@link buildInsert} renders, built once per
+* distinct key list (in order) of the rows of one table instead of per row.
+* Bounded: once `max` signatures are held the cache starts over.
+* @since 0.1.151
+*/
+var InsertSqlCache = class {
+	_dialect;
+	_max;
+	_sql = /* @__PURE__ */ new Map();
+	_table;
+	/** The previous row's keys and SQL — a batch of one shape skips the signature. */
+	_lastKeys;
+	_lastSql = "";
+	constructor(_dialect, _max = 64) {
+		this._dialect = _dialect;
+		this._max = _max;
+	}
+	build(table, data) {
+		if (table !== this._table) {
+			this._sql.clear();
+			this._table = table;
+			this._lastKeys = void 0;
+		}
+		const keys = Object.keys(data);
+		let sql;
+		if (this._lastKeys !== void 0 && sameKeys(this._lastKeys, keys)) sql = this._lastSql;
+		else {
+			const signature = keys.join("\0");
+			sql = this._sql.get(signature);
+			if (sql === void 0) {
+				sql = buildInsert(this._dialect, table, data).sql;
+				if (this._sql.size >= this._max) this._sql.clear();
+				this._sql.set(signature, sql);
+			}
+			this._lastKeys = keys;
+			this._lastSql = sql;
+		}
+		const dialect = this._dialect;
+		const params = [];
+		for (const key of keys) params.push(dialect.toValue(data[key]));
+		return {
+			sql,
+			params
+		};
+	}
+};
+function sameKeys(a, b) {
+	if (a.length !== b.length) return false;
+	for (let i = 0; i < a.length; i++) if (a[i] !== b[i]) return false;
+	return true;
+}
+/**
 * The columns of a multi-row INSERT: the union of the rows' keys, in
 * first-seen order (rows may differ in shape — an optional field omitted on
 * some).
@@ -1454,4 +1625,4 @@ function parseRegexString(value) {
 	};
 }
 //#endregion
-export { AGG_FN_SQL, EMPTY_AND, EMPTY_OR, GEO_DISTANCE_ALIAS, PARTITION_ROW_NUMBER_ALIAS, SEARCH_SOURCE_ALIAS, SQL_DEFAULT, VECTOR_DISTANCE_ALIAS, arithOverflowError, buildAggregateCount, buildAggregateSelect, buildCreateView, buildDelete, buildGeoSearchCount, buildGeoSearchSelect, buildInsert, buildInsertMany, buildPartitionedSelect, buildProjection, buildSelect, buildUpdate, buildVectorSearchCount, buildVectorSearchSelect, buildWhere, chunkInsertRows, createFilterVisitor, defaultValueForType, defaultValueToSqlLiteral, derivedColumnExpr, fillReplacePayload, finalizeParams, foreignKeySql, geoWindowFromControls, groupKeySql, insertManyColumns, jsonDollarPath, mapQueryErrors, normalizeGeoPointValue, numericOutOfRangeError, orFragment, orderKeySql, parseRegexString, queryNodeToSql, queryOpToSql, quotedJsonPathSegments, refActionToSql, renameGeoDistance, renderArith, replaceColumnsFor, sqlStringLiteral, sqlTimeZoneLiteral, stripPartitionRowNumber, toSqlValue, vectorDistanceSource };
+export { AGG_FN_SQL, EMPTY_AND, EMPTY_OR, GEO_DISTANCE_ALIAS, InsertSqlCache, PARTITION_ROW_NUMBER_ALIAS, SEARCH_SOURCE_ALIAS, SQL_DEFAULT, VECTOR_DISTANCE_ALIAS, arithOverflowError, buildAggregateCount, buildAggregateSelect, buildCreateView, buildDelete, buildGeoSearchCount, buildGeoSearchSelect, buildInsert, buildInsertMany, buildPartitionedSelect, buildProjection, buildSelect, buildUpdate, buildVectorSearchCount, buildVectorSearchSelect, buildWhere, chunkInsertRows, createFilterVisitor, defaultValueForType, defaultValueToSqlLiteral, derivedColumnExpr, fillReplacePayload, finalizeParams, foreignKeySql, geoWindowFromControls, groupKeySql, insertManyColumns, jsonDollarPath, mapQueryErrors, normalizeGeoPointValue, numericOutOfRangeError, orFragment, orderKeySql, parseRegexString, queryNodeToSql, queryOpToSql, quotedJsonPathSegments, refActionToSql, renameGeoDistance, renderArith, replaceColumnsFor, sqlStringLiteral, sqlTimeZoneLiteral, stripPartitionRowNumber, toSqlValue, vectorDistanceSource };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atscript/db-sql-tools",
-  "version": "0.1.150",
+  "version": "0.1.152",
   "description": "Shared SQL builder utilities for @atscript database adapters.",
   "keywords": [
     "atscript",
@@ -37,12 +37,12 @@
     "access": "public"
   },
   "devDependencies": {
-    "@uniqu/core": "^0.1.13",
-    "unplugin-atscript": "^0.1.101"
+    "@uniqu/core": "^0.1.14",
+    "unplugin-atscript": "^0.1.102"
   },
   "peerDependencies": {
-    "@uniqu/core": "^0.1.13",
-    "@atscript/db": "^0.1.150"
+    "@uniqu/core": "^0.1.14",
+    "@atscript/db": "^0.1.152"
   },
   "scripts": {
     "build": "vp pack",