@atscript/db-sql-tools 0.1.154 → 0.1.155

package/dist/index.cjs

@@ -1470,6 +1470,19 @@ function buildProjection(dialect, select, qualifier) {
 	}
 	return sql || `${prefix}*`;
 }
+/**
+* One query counting the rows of `quotedTable` that `columns` cannot hold as
+* a primary key: rows with a NULL in one of them, plus every row of a group
+* sharing the same values. Schema sync asks it before rebuilding the key of
+* a populated table (result column `violations`).
+* @since 0.1.155
+*/
+function buildKeyViolationCount(dialect, quotedTable, columns) {
+	const cols = columns.map((c) => dialect.quoteIdentifier(c));
+	const anyNull = cols.map((c) => `${c} IS NULL`).join(" OR ");
+	const noNull = cols.map((c) => `${c} IS NOT NULL`).join(" AND ");
+	return `SELECT (SELECT COUNT(*) FROM ${quotedTable} WHERE ${anyNull}) + (SELECT COALESCE(SUM(${dialect.quoteIdentifier("n")}), 0) FROM (SELECT COUNT(*) AS ${dialect.quoteIdentifier("n")} FROM ${quotedTable} WHERE ${noNull} GROUP BY ${cols.join(", ")} HAVING COUNT(*) > 1) ${dialect.quoteIdentifier("d")}) AS ` + dialect.quoteIdentifier("violations");
+}
 //#endregion
 //#region src/geo.ts
 /**
@@ -1748,6 +1761,41 @@ function viewReadSource(dialect, readable, tableName, query, kind, partitionBy)
 	return source;
 }
 //#endregion
+//#region src/json-copy.ts
+/**
+* `UPDATE` copying the JSON values of the text column `source` into
+* `targets` (`BaseDbAdapter.copyFromJsonColumn`, since 0.1.155): each target
+* reads its path with the dialect's {@link SqlDialect.jsonExtractText} (a
+* `boolean` target with `jsonExtract(…, "boolean")`, a `json` one with
+* {@link SqlDialect.jsonExtractValue}), passed through `cast` (the
+* adapter's conversion to the column type). Only rows where `source` holds
+* a value and every target is NULL are touched, so a re-run never
+* overwrites values written since.
+*/
+function buildJsonColumnCopy(dialect, table, source, targets, cast = (expr) => expr) {
+	if (!dialect.jsonExtractText || !dialect.jsonExtractValue || !dialect.jsonExtract) throw new Error("Copying JSON values into columns is not supported by this adapter");
+	const src = dialect.quoteIdentifier(source);
+	const sets = [];
+	const empty = [];
+	for (const target of targets) {
+		const col = dialect.quoteIdentifier(target.column);
+		const expr = target.kind === "json" ? dialect.jsonExtractValue(src, target.path) : target.kind === "boolean" ? dialect.jsonExtract(src, target.path, "boolean") : dialect.jsonExtractText(src, target.path);
+		sets.push(`${col} = ${cast(expr, target)}`);
+		empty.push(`${col} IS NULL`);
+	}
+	return `UPDATE ${dialect.quoteTable(table)} SET ${sets.join(", ")} WHERE ${src} IS NOT NULL AND ${empty.join(" AND ")}`;
+}
+/**
+* `UPDATE` rewriting the text column `column` as JSON text
+* (`BaseDbAdapter.jsonifyTextColumn`, since 0.1.155): valid JSON stays, other
+* text becomes a JSON string — see {@link SqlDialect.jsonFromText}.
+*/
+function buildJsonifyText(dialect, table, column) {
+	if (!dialect.jsonFromText) throw new Error("Converting text values to JSON is not supported by this adapter");
+	const col = dialect.quoteIdentifier(column);
+	return `UPDATE ${dialect.quoteTable(table)} SET ${col} = ${dialect.jsonFromText(col)} WHERE ${col} IS NOT NULL`;
+}
+//#endregion
 exports.AGG_FN_SQL = AGG_FN_SQL;
 exports.EMPTY_AND = EMPTY_AND;
 exports.EMPTY_OR = EMPTY_OR;
@@ -1766,6 +1814,9 @@ exports.buildGeoSearchCount = buildGeoSearchCount;
 exports.buildGeoSearchSelect = buildGeoSearchSelect;
 exports.buildInsert = buildInsert;
 exports.buildInsertMany = buildInsertMany;
+exports.buildJsonColumnCopy = buildJsonColumnCopy;
+exports.buildJsonifyText = buildJsonifyText;
+exports.buildKeyViolationCount = buildKeyViolationCount;
 exports.buildPartitionedSelect = buildPartitionedSelect;
 exports.buildProjection = buildProjection;
 exports.buildSelect = buildSelect;

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { AtscriptExprNode, AtscriptQueryFieldRef, AtscriptQueryNode, DbControls, DbError, DbQuery, TDbDefaultFn, TDbFieldMeta, TDbForeignKey, TDbReferentialAction, TFieldOps, TReadColumnsKind, TResolvedBucket, TViewColumnMapping, TViewJsonType, TViewPlan, UniquSelect } from "@atscript/db";
+import { AtscriptExprNode, AtscriptQueryFieldRef, AtscriptQueryNode, DbControls, DbError, DbQuery, TDbDefaultFn, TDbFieldMeta, TDbForeignKey, TDbReferentialAction, TFieldOps, TJsonCopyTarget, TReadColumnsKind, TResolvedBucket, TViewColumnMapping, TViewJsonType, TViewPlan, UniquSelect } from "@atscript/db";
 import { FilterExpr, FilterVisitor, NullsPlacement } from "@uniqu/core";
 import { TDbAggregateFn } from "@atscript/db/agg";
 
@@ -100,6 +100,29 @@ interface SqlDialect {
    * @since 0.1.136
    */
   jsonExtract?(quotedCol: string, path: readonly string[], type: TViewJsonType): string;
+  /**
+   * Schema sync's copy out of a JSON text column ({@link buildJsonColumnCopy},
+   * since 0.1.155): the value at `path` as text — a JSON string unquoted, a
+   * number / boolean as its JSON text (SQLite: as the SQL value), an object
+   * or array as JSON text; NULL when the path is missing or the value is JSON
+   * `null`. A malformed JSON column value makes the statement fail.
+   * Parameter-free; dialects without it cannot run that copy.
+   * @since 0.1.155
+   */
+  jsonExtractText?(quotedCol: string, path: readonly string[]): string;
+  /**
+   * The value at `path` as JSON (for a JSON column), NULL when missing or
+   * JSON `null` — see {@link jsonExtractText}.
+   * @since 0.1.155
+   */
+  jsonExtractValue?(quotedCol: string, path: readonly string[]): string;
+  /**
+   * A text column's value as JSON text ({@link buildJsonifyText}, since
+   * 0.1.155): a valid JSON value is kept, any other text becomes a JSON
+   * string (`abc` → `"abc"`). Parameter-free.
+   * @since 0.1.155
+   */
+  jsonFromText?(quotedCol: string): string;
   /**
    * `expr` cast to an IEEE double — how a computed view column
    * (`@db.compute`) evaluates every field / literal leaf, so `7 / 2 = 3.5`
@@ -642,6 +665,14 @@ declare function derivedColumnExpr(dialect: SqlDialect, field: TDbFieldMeta): st
  *   or aliased source such as the geo / vector search subqueries (since 0.1.143).
  */
 declare function buildProjection(dialect: SqlDialect, select?: UniquSelect, qualifier?: string): string;
+/**
+ * One query counting the rows of `quotedTable` that `columns` cannot hold as
+ * a primary key: rows with a NULL in one of them, plus every row of a group
+ * sharing the same values. Schema sync asks it before rebuilding the key of
+ * a populated table (result column `violations`).
+ * @since 0.1.155
+ */
+declare function buildKeyViolationCount(dialect: SqlDialect, quotedTable: string, columns: readonly string[]): string;
 //#endregion
 //#region src/common.d.ts
 /** Formats a string value as a SQL literal with single-quote escaping. */
@@ -775,4 +806,23 @@ interface TReadableLike {
  */
 declare function viewReadSource(dialect: SqlDialect, readable: TReadableLike, tableName: string, query: DbQuery, kind: TReadColumnsKind, partitionBy?: readonly string[]): TSqlFromSource;
 //#endregion
-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 TSqlDerivedSource, type TSqlFragment, type TSqlFromSource, VECTOR_DISTANCE_ALIAS, arithOverflowError, buildAggregateCount, buildAggregateSelect, buildCreateView, buildDelete, buildGeoSearchCount, buildGeoSearchSelect, buildInsert, buildInsertMany, buildPartitionedSelect, buildProjection, buildSelect, buildUpdate, buildVectorSearchCount, buildVectorSearchSelect, buildViewSelect, buildWhere, chunkInsertRows, createFilterVisitor, defaultValueForType, defaultValueToSqlLiteral, derivedColumnExpr, fillReplacePayload, finalizeParams, foreignKeySql, fromSourceHint, fromSourceSql, geoWindowFromControls, groupKeySql, insertManyColumns, jsonDollarPath, mapQueryErrors, normalizeGeoPointValue, nullsOrderSql, nullsPlacementOf, numericOutOfRangeError, orFragment, orderByList, orderKeySql, parseRegexString, queryNodeToSql, queryOpToSql, quotedJsonPathSegments, refActionToSql, renameGeoDistance, renderArith, replaceColumnsFor, sqlStringLiteral, sqlTimeZoneLiteral, stripPartitionRowNumber, toSqlValue, vectorDistanceSource, viewReadSource };
+//#region src/json-copy.d.ts
+/**
+ * `UPDATE` copying the JSON values of the text column `source` into
+ * `targets` (`BaseDbAdapter.copyFromJsonColumn`, since 0.1.155): each target
+ * reads its path with the dialect's {@link SqlDialect.jsonExtractText} (a
+ * `boolean` target with `jsonExtract(…, "boolean")`, a `json` one with
+ * {@link SqlDialect.jsonExtractValue}), passed through `cast` (the
+ * adapter's conversion to the column type). Only rows where `source` holds
+ * a value and every target is NULL are touched, so a re-run never
+ * overwrites values written since.
+ */
+declare function buildJsonColumnCopy(dialect: SqlDialect, table: string, source: string, targets: readonly TJsonCopyTarget[], cast?: (expr: string, target: TJsonCopyTarget) => string): string;
+/**
+ * `UPDATE` rewriting the text column `column` as JSON text
+ * (`BaseDbAdapter.jsonifyTextColumn`, since 0.1.155): valid JSON stays, other
+ * text becomes a JSON string — see {@link SqlDialect.jsonFromText}.
+ */
+declare function buildJsonifyText(dialect: SqlDialect, table: string, column: string): string;
+//#endregion
+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 TSqlDerivedSource, type TSqlFragment, type TSqlFromSource, VECTOR_DISTANCE_ALIAS, arithOverflowError, buildAggregateCount, buildAggregateSelect, buildCreateView, buildDelete, buildGeoSearchCount, buildGeoSearchSelect, buildInsert, buildInsertMany, buildJsonColumnCopy, buildJsonifyText, buildKeyViolationCount, buildPartitionedSelect, buildProjection, buildSelect, buildUpdate, buildVectorSearchCount, buildVectorSearchSelect, buildViewSelect, buildWhere, chunkInsertRows, createFilterVisitor, defaultValueForType, defaultValueToSqlLiteral, derivedColumnExpr, fillReplacePayload, finalizeParams, foreignKeySql, fromSourceHint, fromSourceSql, geoWindowFromControls, groupKeySql, insertManyColumns, jsonDollarPath, mapQueryErrors, normalizeGeoPointValue, nullsOrderSql, nullsPlacementOf, numericOutOfRangeError, orFragment, orderByList, orderKeySql, parseRegexString, queryNodeToSql, queryOpToSql, quotedJsonPathSegments, refActionToSql, renameGeoDistance, renderArith, replaceColumnsFor, sqlStringLiteral, sqlTimeZoneLiteral, stripPartitionRowNumber, toSqlValue, vectorDistanceSource, viewReadSource };

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { AtscriptExprNode, AtscriptQueryFieldRef, AtscriptQueryNode, DbControls, DbError, DbQuery, TDbDefaultFn, TDbFieldMeta, TDbForeignKey, TDbReferentialAction, TFieldOps, TReadColumnsKind, TResolvedBucket, TViewColumnMapping, TViewJsonType, TViewPlan, UniquSelect } from "@atscript/db";
+import { AtscriptExprNode, AtscriptQueryFieldRef, AtscriptQueryNode, DbControls, DbError, DbQuery, TDbDefaultFn, TDbFieldMeta, TDbForeignKey, TDbReferentialAction, TFieldOps, TJsonCopyTarget, TReadColumnsKind, TResolvedBucket, TViewColumnMapping, TViewJsonType, TViewPlan, UniquSelect } from "@atscript/db";
 import { FilterExpr, FilterVisitor, NullsPlacement } from "@uniqu/core";
 import { TDbAggregateFn } from "@atscript/db/agg";
 
@@ -100,6 +100,29 @@ interface SqlDialect {
    * @since 0.1.136
    */
   jsonExtract?(quotedCol: string, path: readonly string[], type: TViewJsonType): string;
+  /**
+   * Schema sync's copy out of a JSON text column ({@link buildJsonColumnCopy},
+   * since 0.1.155): the value at `path` as text — a JSON string unquoted, a
+   * number / boolean as its JSON text (SQLite: as the SQL value), an object
+   * or array as JSON text; NULL when the path is missing or the value is JSON
+   * `null`. A malformed JSON column value makes the statement fail.
+   * Parameter-free; dialects without it cannot run that copy.
+   * @since 0.1.155
+   */
+  jsonExtractText?(quotedCol: string, path: readonly string[]): string;
+  /**
+   * The value at `path` as JSON (for a JSON column), NULL when missing or
+   * JSON `null` — see {@link jsonExtractText}.
+   * @since 0.1.155
+   */
+  jsonExtractValue?(quotedCol: string, path: readonly string[]): string;
+  /**
+   * A text column's value as JSON text ({@link buildJsonifyText}, since
+   * 0.1.155): a valid JSON value is kept, any other text becomes a JSON
+   * string (`abc` → `"abc"`). Parameter-free.
+   * @since 0.1.155
+   */
+  jsonFromText?(quotedCol: string): string;
   /**
    * `expr` cast to an IEEE double — how a computed view column
    * (`@db.compute`) evaluates every field / literal leaf, so `7 / 2 = 3.5`
@@ -642,6 +665,14 @@ declare function derivedColumnExpr(dialect: SqlDialect, field: TDbFieldMeta): st
  *   or aliased source such as the geo / vector search subqueries (since 0.1.143).
  */
 declare function buildProjection(dialect: SqlDialect, select?: UniquSelect, qualifier?: string): string;
+/**
+ * One query counting the rows of `quotedTable` that `columns` cannot hold as
+ * a primary key: rows with a NULL in one of them, plus every row of a group
+ * sharing the same values. Schema sync asks it before rebuilding the key of
+ * a populated table (result column `violations`).
+ * @since 0.1.155
+ */
+declare function buildKeyViolationCount(dialect: SqlDialect, quotedTable: string, columns: readonly string[]): string;
 //#endregion
 //#region src/common.d.ts
 /** Formats a string value as a SQL literal with single-quote escaping. */
@@ -775,4 +806,23 @@ interface TReadableLike {
  */
 declare function viewReadSource(dialect: SqlDialect, readable: TReadableLike, tableName: string, query: DbQuery, kind: TReadColumnsKind, partitionBy?: readonly string[]): TSqlFromSource;
 //#endregion
-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 TSqlDerivedSource, type TSqlFragment, type TSqlFromSource, VECTOR_DISTANCE_ALIAS, arithOverflowError, buildAggregateCount, buildAggregateSelect, buildCreateView, buildDelete, buildGeoSearchCount, buildGeoSearchSelect, buildInsert, buildInsertMany, buildPartitionedSelect, buildProjection, buildSelect, buildUpdate, buildVectorSearchCount, buildVectorSearchSelect, buildViewSelect, buildWhere, chunkInsertRows, createFilterVisitor, defaultValueForType, defaultValueToSqlLiteral, derivedColumnExpr, fillReplacePayload, finalizeParams, foreignKeySql, fromSourceHint, fromSourceSql, geoWindowFromControls, groupKeySql, insertManyColumns, jsonDollarPath, mapQueryErrors, normalizeGeoPointValue, nullsOrderSql, nullsPlacementOf, numericOutOfRangeError, orFragment, orderByList, orderKeySql, parseRegexString, queryNodeToSql, queryOpToSql, quotedJsonPathSegments, refActionToSql, renameGeoDistance, renderArith, replaceColumnsFor, sqlStringLiteral, sqlTimeZoneLiteral, stripPartitionRowNumber, toSqlValue, vectorDistanceSource, viewReadSource };
+//#region src/json-copy.d.ts
+/**
+ * `UPDATE` copying the JSON values of the text column `source` into
+ * `targets` (`BaseDbAdapter.copyFromJsonColumn`, since 0.1.155): each target
+ * reads its path with the dialect's {@link SqlDialect.jsonExtractText} (a
+ * `boolean` target with `jsonExtract(…, "boolean")`, a `json` one with
+ * {@link SqlDialect.jsonExtractValue}), passed through `cast` (the
+ * adapter's conversion to the column type). Only rows where `source` holds
+ * a value and every target is NULL are touched, so a re-run never
+ * overwrites values written since.
+ */
+declare function buildJsonColumnCopy(dialect: SqlDialect, table: string, source: string, targets: readonly TJsonCopyTarget[], cast?: (expr: string, target: TJsonCopyTarget) => string): string;
+/**
+ * `UPDATE` rewriting the text column `column` as JSON text
+ * (`BaseDbAdapter.jsonifyTextColumn`, since 0.1.155): valid JSON stays, other
+ * text becomes a JSON string — see {@link SqlDialect.jsonFromText}.
+ */
+declare function buildJsonifyText(dialect: SqlDialect, table: string, column: string): string;
+//#endregion
+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 TSqlDerivedSource, type TSqlFragment, type TSqlFromSource, VECTOR_DISTANCE_ALIAS, arithOverflowError, buildAggregateCount, buildAggregateSelect, buildCreateView, buildDelete, buildGeoSearchCount, buildGeoSearchSelect, buildInsert, buildInsertMany, buildJsonColumnCopy, buildJsonifyText, buildKeyViolationCount, buildPartitionedSelect, buildProjection, buildSelect, buildUpdate, buildVectorSearchCount, buildVectorSearchSelect, buildViewSelect, buildWhere, chunkInsertRows, createFilterVisitor, defaultValueForType, defaultValueToSqlLiteral, derivedColumnExpr, fillReplacePayload, finalizeParams, foreignKeySql, fromSourceHint, fromSourceSql, geoWindowFromControls, groupKeySql, insertManyColumns, jsonDollarPath, mapQueryErrors, normalizeGeoPointValue, nullsOrderSql, nullsPlacementOf, numericOutOfRangeError, orFragment, orderByList, orderKeySql, parseRegexString, queryNodeToSql, queryOpToSql, quotedJsonPathSegments, refActionToSql, renameGeoDistance, renderArith, replaceColumnsFor, sqlStringLiteral, sqlTimeZoneLiteral, stripPartitionRowNumber, toSqlValue, vectorDistanceSource, viewReadSource };

package/dist/index.mjs

@@ -1469,6 +1469,19 @@ function buildProjection(dialect, select, qualifier) {
 	}
 	return sql || `${prefix}*`;
 }
+/**
+* One query counting the rows of `quotedTable` that `columns` cannot hold as
+* a primary key: rows with a NULL in one of them, plus every row of a group
+* sharing the same values. Schema sync asks it before rebuilding the key of
+* a populated table (result column `violations`).
+* @since 0.1.155
+*/
+function buildKeyViolationCount(dialect, quotedTable, columns) {
+	const cols = columns.map((c) => dialect.quoteIdentifier(c));
+	const anyNull = cols.map((c) => `${c} IS NULL`).join(" OR ");
+	const noNull = cols.map((c) => `${c} IS NOT NULL`).join(" AND ");
+	return `SELECT (SELECT COUNT(*) FROM ${quotedTable} WHERE ${anyNull}) + (SELECT COALESCE(SUM(${dialect.quoteIdentifier("n")}), 0) FROM (SELECT COUNT(*) AS ${dialect.quoteIdentifier("n")} FROM ${quotedTable} WHERE ${noNull} GROUP BY ${cols.join(", ")} HAVING COUNT(*) > 1) ${dialect.quoteIdentifier("d")}) AS ` + dialect.quoteIdentifier("violations");
+}
 //#endregion
 //#region src/geo.ts
 /**
@@ -1747,4 +1760,39 @@ function viewReadSource(dialect, readable, tableName, query, kind, partitionBy)
 	return source;
 }
 //#endregion
-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, buildViewSelect, buildWhere, chunkInsertRows, createFilterVisitor, defaultValueForType, defaultValueToSqlLiteral, derivedColumnExpr, fillReplacePayload, finalizeParams, foreignKeySql, fromSourceHint, fromSourceSql, geoWindowFromControls, groupKeySql, insertManyColumns, jsonDollarPath, mapQueryErrors, normalizeGeoPointValue, nullsOrderSql, nullsPlacementOf, numericOutOfRangeError, orFragment, orderByList, orderKeySql, parseRegexString, queryNodeToSql, queryOpToSql, quotedJsonPathSegments, refActionToSql, renameGeoDistance, renderArith, replaceColumnsFor, sqlStringLiteral, sqlTimeZoneLiteral, stripPartitionRowNumber, toSqlValue, vectorDistanceSource, viewReadSource };
+//#region src/json-copy.ts
+/**
+* `UPDATE` copying the JSON values of the text column `source` into
+* `targets` (`BaseDbAdapter.copyFromJsonColumn`, since 0.1.155): each target
+* reads its path with the dialect's {@link SqlDialect.jsonExtractText} (a
+* `boolean` target with `jsonExtract(…, "boolean")`, a `json` one with
+* {@link SqlDialect.jsonExtractValue}), passed through `cast` (the
+* adapter's conversion to the column type). Only rows where `source` holds
+* a value and every target is NULL are touched, so a re-run never
+* overwrites values written since.
+*/
+function buildJsonColumnCopy(dialect, table, source, targets, cast = (expr) => expr) {
+	if (!dialect.jsonExtractText || !dialect.jsonExtractValue || !dialect.jsonExtract) throw new Error("Copying JSON values into columns is not supported by this adapter");
+	const src = dialect.quoteIdentifier(source);
+	const sets = [];
+	const empty = [];
+	for (const target of targets) {
+		const col = dialect.quoteIdentifier(target.column);
+		const expr = target.kind === "json" ? dialect.jsonExtractValue(src, target.path) : target.kind === "boolean" ? dialect.jsonExtract(src, target.path, "boolean") : dialect.jsonExtractText(src, target.path);
+		sets.push(`${col} = ${cast(expr, target)}`);
+		empty.push(`${col} IS NULL`);
+	}
+	return `UPDATE ${dialect.quoteTable(table)} SET ${sets.join(", ")} WHERE ${src} IS NOT NULL AND ${empty.join(" AND ")}`;
+}
+/**
+* `UPDATE` rewriting the text column `column` as JSON text
+* (`BaseDbAdapter.jsonifyTextColumn`, since 0.1.155): valid JSON stays, other
+* text becomes a JSON string — see {@link SqlDialect.jsonFromText}.
+*/
+function buildJsonifyText(dialect, table, column) {
+	if (!dialect.jsonFromText) throw new Error("Converting text values to JSON is not supported by this adapter");
+	const col = dialect.quoteIdentifier(column);
+	return `UPDATE ${dialect.quoteTable(table)} SET ${col} = ${dialect.jsonFromText(col)} WHERE ${col} IS NOT NULL`;
+}
+//#endregion
+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, buildJsonColumnCopy, buildJsonifyText, buildKeyViolationCount, buildPartitionedSelect, buildProjection, buildSelect, buildUpdate, buildVectorSearchCount, buildVectorSearchSelect, buildViewSelect, buildWhere, chunkInsertRows, createFilterVisitor, defaultValueForType, defaultValueToSqlLiteral, derivedColumnExpr, fillReplacePayload, finalizeParams, foreignKeySql, fromSourceHint, fromSourceSql, geoWindowFromControls, groupKeySql, insertManyColumns, jsonDollarPath, mapQueryErrors, normalizeGeoPointValue, nullsOrderSql, nullsPlacementOf, numericOutOfRangeError, orFragment, orderByList, orderKeySql, parseRegexString, queryNodeToSql, queryOpToSql, quotedJsonPathSegments, refActionToSql, renameGeoDistance, renderArith, replaceColumnsFor, sqlStringLiteral, sqlTimeZoneLiteral, stripPartitionRowNumber, toSqlValue, vectorDistanceSource, viewReadSource };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atscript/db-sql-tools",
-  "version": "0.1.154",
+  "version": "0.1.155",
   "description": "Shared SQL builder utilities for @atscript database adapters.",
   "keywords": [
     "atscript",
@@ -38,11 +38,11 @@
   },
   "devDependencies": {
     "@uniqu/core": "^0.1.15",
-    "unplugin-atscript": "^0.1.103"
+    "unplugin-atscript": "^0.1.105"
   },
   "peerDependencies": {
     "@uniqu/core": "^0.1.15",
-    "@atscript/db": "^0.1.154"
+    "@atscript/db": "^0.1.155"
   },
   "scripts": {
     "build": "vp pack",