@agentforge/tools 0.16.38 → 0.16.39

package/dist/index.d.cts

@@ -5230,11 +5230,6 @@ interface QueryExecutionContext {
  */
 declare function executeQuery(manager: ConnectionManager, input: QueryInput, context?: QueryExecutionContext): Promise<QueryExecutionResult>;
 
-/**
- * Query builder helpers for relational CRUD operations.
- * @module query/query-builder
- */
-
 /**
  * Supported scalar values for INSERT payloads.
  */
@@ -5277,10 +5272,6 @@ interface BuiltInsertQuery {
     idColumn: string;
     supportsReturning: boolean;
 }
-/**
- * Build a safe parameterized INSERT query from structured input.
- */
-declare function buildInsertQuery(input: InsertQueryInput): BuiltInsertQuery;
 /**
  * Supported scalar values for UPDATE payloads.
  */
@@ -5290,17 +5281,19 @@ type UpdateValue = InsertValue;
  */
 type UpdateData = Record<string, UpdateValue>;
 /**
- * WHERE operator types for UPDATE conditions.
+ * WHERE operator types shared by UPDATE/DELETE/SELECT conditions.
  */
 type UpdateWhereOperator = 'eq' | 'ne' | 'gt' | 'lt' | 'gte' | 'lte' | 'like' | 'in' | 'notIn' | 'isNull' | 'isNotNull';
-/**
- * WHERE condition for UPDATE queries.
- */
-interface UpdateWhereCondition {
+type WhereConditionValue = string | number | boolean | null | Array<string | number>;
+interface BaseWhereCondition {
     column: string;
     operator: UpdateWhereOperator;
-    value?: string | number | boolean | null | Array<string | number>;
+    value?: WhereConditionValue;
 }
+/**
+ * WHERE condition for UPDATE queries.
+ */
+type UpdateWhereCondition = BaseWhereCondition;
 /**
  * Optional optimistic lock condition appended to WHERE.
  */
@@ -5330,11 +5323,7 @@ interface BuiltUpdateQuery {
 /**
  * WHERE condition for DELETE queries.
  */
-interface DeleteWhereCondition {
-    column: string;
-    operator: UpdateWhereOperator;
-    value?: string | number | boolean | null | Array<string | number>;
-}
+type DeleteWhereCondition = BaseWhereCondition;
 /**
  * Soft-delete configuration.
  */
@@ -5361,14 +5350,6 @@ interface BuiltDeleteQuery {
     usesSoftDelete: boolean;
     softDeleteColumn?: string;
 }
-/**
- * Build a safe parameterized UPDATE query from structured input.
- */
-declare function buildUpdateQuery(input: UpdateQueryInput): BuiltUpdateQuery;
-/**
- * Build a safe parameterized DELETE query from structured input.
- */
-declare function buildDeleteQuery(input: DeleteQueryInput): BuiltDeleteQuery;
 /**
  * ORDER BY direction for SELECT queries.
  */
@@ -5383,11 +5364,7 @@ interface SelectOrderBy {
 /**
  * WHERE condition for SELECT queries.
  */
-interface SelectWhereCondition {
-    column: string;
-    operator: UpdateWhereOperator;
-    value?: string | number | boolean | null | Array<string | number>;
-}
+type SelectWhereCondition = BaseWhereCondition;
 /**
  * Builder input for SELECT queries.
  */
@@ -5400,9 +5377,12 @@ interface SelectQueryInput {
     offset?: number;
     vendor: DatabaseVendor;
 }
-/**
- * Build a safe parameterized SELECT query from structured input.
- */
+
+declare function buildInsertQuery(input: InsertQueryInput): BuiltInsertQuery;
+
+declare function buildUpdateQuery(input: UpdateQueryInput): BuiltUpdateQuery;
+declare function buildDeleteQuery(input: DeleteQueryInput): BuiltDeleteQuery;
+
 declare function buildSelectQuery(input: SelectQueryInput): SQL;
 
 /**

package/dist/index.d.ts

@@ -5230,11 +5230,6 @@ interface QueryExecutionContext {
  */
 declare function executeQuery(manager: ConnectionManager, input: QueryInput, context?: QueryExecutionContext): Promise<QueryExecutionResult>;
 
-/**
- * Query builder helpers for relational CRUD operations.
- * @module query/query-builder
- */
-
 /**
  * Supported scalar values for INSERT payloads.
  */
@@ -5277,10 +5272,6 @@ interface BuiltInsertQuery {
     idColumn: string;
     supportsReturning: boolean;
 }
-/**
- * Build a safe parameterized INSERT query from structured input.
- */
-declare function buildInsertQuery(input: InsertQueryInput): BuiltInsertQuery;
 /**
  * Supported scalar values for UPDATE payloads.
  */
@@ -5290,17 +5281,19 @@ type UpdateValue = InsertValue;
  */
 type UpdateData = Record<string, UpdateValue>;
 /**
- * WHERE operator types for UPDATE conditions.
+ * WHERE operator types shared by UPDATE/DELETE/SELECT conditions.
  */
 type UpdateWhereOperator = 'eq' | 'ne' | 'gt' | 'lt' | 'gte' | 'lte' | 'like' | 'in' | 'notIn' | 'isNull' | 'isNotNull';
-/**
- * WHERE condition for UPDATE queries.
- */
-interface UpdateWhereCondition {
+type WhereConditionValue = string | number | boolean | null | Array<string | number>;
+interface BaseWhereCondition {
     column: string;
     operator: UpdateWhereOperator;
-    value?: string | number | boolean | null | Array<string | number>;
+    value?: WhereConditionValue;
 }
+/**
+ * WHERE condition for UPDATE queries.
+ */
+type UpdateWhereCondition = BaseWhereCondition;
 /**
  * Optional optimistic lock condition appended to WHERE.
  */
@@ -5330,11 +5323,7 @@ interface BuiltUpdateQuery {
 /**
  * WHERE condition for DELETE queries.
  */
-interface DeleteWhereCondition {
-    column: string;
-    operator: UpdateWhereOperator;
-    value?: string | number | boolean | null | Array<string | number>;
-}
+type DeleteWhereCondition = BaseWhereCondition;
 /**
  * Soft-delete configuration.
  */
@@ -5361,14 +5350,6 @@ interface BuiltDeleteQuery {
     usesSoftDelete: boolean;
     softDeleteColumn?: string;
 }
-/**
- * Build a safe parameterized UPDATE query from structured input.
- */
-declare function buildUpdateQuery(input: UpdateQueryInput): BuiltUpdateQuery;
-/**
- * Build a safe parameterized DELETE query from structured input.
- */
-declare function buildDeleteQuery(input: DeleteQueryInput): BuiltDeleteQuery;
 /**
  * ORDER BY direction for SELECT queries.
  */
@@ -5383,11 +5364,7 @@ interface SelectOrderBy {
 /**
  * WHERE condition for SELECT queries.
  */
-interface SelectWhereCondition {
-    column: string;
-    operator: UpdateWhereOperator;
-    value?: string | number | boolean | null | Array<string | number>;
-}
+type SelectWhereCondition = BaseWhereCondition;
 /**
  * Builder input for SELECT queries.
  */
@@ -5400,9 +5377,12 @@ interface SelectQueryInput {
     offset?: number;
     vendor: DatabaseVendor;
 }
-/**
- * Build a safe parameterized SELECT query from structured input.
- */
+
+declare function buildInsertQuery(input: InsertQueryInput): BuiltInsertQuery;
+
+declare function buildUpdateQuery(input: UpdateQueryInput): BuiltUpdateQuery;
+declare function buildDeleteQuery(input: DeleteQueryInput): BuiltDeleteQuery;
+
 declare function buildSelectQuery(input: SelectQueryInput): SQL;
 
 /**

package/dist/index.js

@@ -5065,11 +5065,9 @@ function rowsHaveHomogeneousColumns(rows) {
 function buildSingleRowInsert(table, row, vendor) {
   const columns = Object.keys(row);
   if (columns.length === 0) {
-    const quotedTable2 = quoteQualifiedIdentifier(table, vendor);
-    return sql.raw(`INSERT INTO ${quotedTable2} DEFAULT VALUES`);
+    return sql.raw(`INSERT INTO ${quoteQualifiedIdentifier(table, vendor)} DEFAULT VALUES`);
   }
   columns.forEach((column) => validateIdentifier(column, "Insert column"));
-  const quotedTable = quoteQualifiedIdentifier(table, vendor);
   const quotedColumns = columns.map((column) => quoteIdentifier(column, vendor)).join(", ");
   const valueFragments = columns.map((column) => {
     const value = row[column];
@@ -5080,7 +5078,9 @@ function buildSingleRowInsert(table, row, vendor) {
   });
   return sql.join(
     [
-      sql.raw(`INSERT INTO ${quotedTable} (${quotedColumns}) VALUES (`),
+      sql.raw(
+        `INSERT INTO ${quoteQualifiedIdentifier(table, vendor)} (${quotedColumns}) VALUES (`
+      ),
       sql.join(valueFragments, sql.raw(", ")),
       sql.raw(")")
     ],
@@ -5091,12 +5091,13 @@ function buildInsertValuesQuery(table, columns, rows, vendor) {
   if (vendor === "sqlite" && !rowsHaveHomogeneousColumns(rows)) {
     return rows.map((row) => buildSingleRowInsert(table, row, vendor));
   }
-  const quotedTable = quoteQualifiedIdentifier(table, vendor);
   const quotedColumns = columns.map((column) => quoteIdentifier(column, vendor)).join(", ");
   const rowTuples = rows.map((row) => buildValuesTuple(columns, row));
   return sql.join(
     [
-      sql.raw(`INSERT INTO ${quotedTable} (${quotedColumns}) VALUES `),
+      sql.raw(
+        `INSERT INTO ${quoteQualifiedIdentifier(table, vendor)} (${quotedColumns}) VALUES `
+      ),
       sql.join(rowTuples, sql.raw(", "))
     ],
     sql.raw("")
@@ -5106,8 +5107,7 @@ function buildInsertDefaultValuesQuery(table, rowCount, vendor) {
   if (rowCount > 1) {
     throw new Error("Batch INSERT with only DEFAULT VALUES is not supported");
   }
-  const quotedTable = quoteQualifiedIdentifier(table, vendor);
-  return sql.raw(`INSERT INTO ${quotedTable} DEFAULT VALUES`);
+  return sql.raw(`INSERT INTO ${quoteQualifiedIdentifier(table, vendor)} DEFAULT VALUES`);
 }
 function buildInsertQuery(input) {
   validateQualifiedIdentifier(input.table, "Table name");
@@ -5130,9 +5130,7 @@ function buildInsertQuery(input) {
     let queries = valuesResult;
     if (returningMode !== "none" && supportsReturning) {
       const returningClause = returningMode === "id" ? sql.raw(` RETURNING ${quoteIdentifier(idColumn, input.vendor)}`) : sql.raw(" RETURNING *");
-      queries = queries.map(
-        (q) => sql.join([q, returningClause], sql.raw(""))
-      );
+      queries = queries.map((query2) => sql.join([query2, returningClause], sql.raw("")));
     }
     return {
       query: queries,
@@ -5144,14 +5142,10 @@ function buildInsertQuery(input) {
   }
   let query = valuesResult;
   if (returningMode !== "none" && supportsReturning) {
-    if (returningMode === "id") {
-      query = sql.join(
-        [query, sql.raw(` RETURNING ${quoteIdentifier(idColumn, input.vendor)}`)],
-        sql.raw("")
-      );
-    } else {
-      query = sql.join([query, sql.raw(" RETURNING *")], sql.raw(""));
-    }
+    query = returningMode === "id" ? sql.join(
+      [query, sql.raw(` RETURNING ${quoteIdentifier(idColumn, input.vendor)}`)],
+      sql.raw("")
+    ) : sql.join([query, sql.raw(" RETURNING *")], sql.raw(""));
   }
   return {
     query,
@@ -5161,23 +5155,7 @@ function buildInsertQuery(input) {
     supportsReturning
   };
 }
-function normalizeUpdateData(data) {
-  if (!data || typeof data !== "object" || Array.isArray(data)) {
-    throw new Error("Update data must be an object");
-  }
-  const keys = Object.keys(data);
-  if (keys.length === 0) {
-    throw new Error("Update data must not be empty");
-  }
-  keys.forEach((column) => {
-    validateIdentifier(column, "Update column");
-    if (data[column] === void 0) {
-      throw new Error(`Update value for column "${column}" must not be undefined`);
-    }
-  });
-  return data;
-}
-function buildUpdateWhereCondition(condition, vendor) {
+function buildWhereCondition(condition, vendor) {
   validateIdentifier(condition.column, "WHERE column");
   const column = sql.raw(quoteIdentifier(condition.column, vendor));
   switch (condition.operator) {
@@ -5226,12 +5204,12 @@ function buildUpdateWhereCondition(condition, vendor) {
       if (!Array.isArray(condition.value) || condition.value.length === 0) {
         throw new Error(`IN operator requires a non-empty array value for column ${condition.column}`);
       }
-      return sql`${column} IN (${sql.join(condition.value.map((v) => sql`${v}`), sql.raw(", "))})`;
+      return sql`${column} IN (${sql.join(condition.value.map((value) => sql`${value}`), sql.raw(", "))})`;
     case "notIn":
       if (!Array.isArray(condition.value) || condition.value.length === 0) {
         throw new Error(`NOT IN operator requires a non-empty array value for column ${condition.column}`);
       }
-      return sql`${column} NOT IN (${sql.join(condition.value.map((v) => sql`${v}`), sql.raw(", "))})`;
+      return sql`${column} NOT IN (${sql.join(condition.value.map((value) => sql`${value}`), sql.raw(", "))})`;
     case "isNull":
       if (condition.value !== void 0) {
         throw new Error(`IS NULL operator must not include value for column ${condition.column}`);
@@ -5244,6 +5222,24 @@ function buildUpdateWhereCondition(condition, vendor) {
       return sql`${column} IS NOT NULL`;
   }
 }
+
+// src/data/relational/query/query-builder-mutation.ts
+function normalizeUpdateData(data) {
+  if (!data || typeof data !== "object" || Array.isArray(data)) {
+    throw new Error("Update data must be an object");
+  }
+  const keys = Object.keys(data);
+  if (keys.length === 0) {
+    throw new Error("Update data must not be empty");
+  }
+  keys.forEach((column) => {
+    validateIdentifier(column, "Update column");
+    if (data[column] === void 0) {
+      throw new Error(`Update value for column "${column}" must not be undefined`);
+    }
+  });
+  return data;
+}
 function buildUpdateQuery(input) {
   validateQualifiedIdentifier(input.table, "Table name");
   const normalizedData = normalizeUpdateData(input.data);
@@ -5252,7 +5248,7 @@ function buildUpdateQuery(input) {
     return sql`${quotedColumn} = ${value}`;
   });
   const whereConditions = (input.where ?? []).map(
-    (condition) => buildUpdateWhereCondition(condition, input.vendor)
+    (condition) => buildWhereCondition(condition, input.vendor)
   );
   if (input.optimisticLock) {
     validateIdentifier(input.optimisticLock.column, "Optimistic lock column");
@@ -5263,7 +5259,9 @@ function buildUpdateQuery(input) {
     whereConditions.push(sql`${lockColumn} = ${input.optimisticLock.expectedValue}`);
   }
   if (whereConditions.length === 0 && !input.allowFullTableUpdate) {
-    throw new Error("WHERE conditions are required for UPDATE queries. Set allowFullTableUpdate=true to override.");
+    throw new Error(
+      "WHERE conditions are required for UPDATE queries. Set allowFullTableUpdate=true to override."
+    );
   }
   let query = sql.join(
     [
@@ -5273,7 +5271,10 @@ function buildUpdateQuery(input) {
     sql.raw("")
   );
   if (whereConditions.length > 0) {
-    query = sql.join([query, sql.raw(" WHERE "), sql.join(whereConditions, sql.raw(" AND "))], sql.raw(""));
+    query = sql.join(
+      [query, sql.raw(" WHERE "), sql.join(whereConditions, sql.raw(" AND "))],
+      sql.raw("")
+    );
   }
   return {
     query,
@@ -5284,10 +5285,12 @@ function buildUpdateQuery(input) {
 function buildDeleteQuery(input) {
   validateQualifiedIdentifier(input.table, "Table name");
   const whereConditions = (input.where ?? []).map(
-    (condition) => buildUpdateWhereCondition(condition, input.vendor)
+    (condition) => buildWhereCondition(condition, input.vendor)
   );
   if (whereConditions.length === 0 && !input.allowFullTableDelete) {
-    throw new Error("WHERE conditions are required for DELETE queries. Set allowFullTableDelete=true to override.");
+    throw new Error(
+      "WHERE conditions are required for DELETE queries. Set allowFullTableDelete=true to override."
+    );
   }
   const softDeleteColumn = input.softDelete?.column ?? "deleted_at";
   const softDeleteValue = input.softDelete?.value ?? (/* @__PURE__ */ new Date()).toISOString();
@@ -5306,7 +5309,10 @@ function buildDeleteQuery(input) {
     query = sql.raw(`DELETE FROM ${quoteQualifiedIdentifier(input.table, input.vendor)}`);
   }
   if (whereConditions.length > 0) {
-    query = sql.join([query, sql.raw(" WHERE "), sql.join(whereConditions, sql.raw(" AND "))], sql.raw(""));
+    query = sql.join(
+      [query, sql.raw(" WHERE "), sql.join(whereConditions, sql.raw(" AND "))],
+      sql.raw("")
+    );
   }
   return {
     query,
@@ -5315,73 +5321,6 @@ function buildDeleteQuery(input) {
     softDeleteColumn: input.softDelete ? softDeleteColumn : void 0
   };
 }
-function buildSelectWhereCondition(condition, vendor) {
-  validateIdentifier(condition.column, "WHERE column");
-  const column = sql.raw(quoteIdentifier(condition.column, vendor));
-  switch (condition.operator) {
-    case "eq":
-      if (condition.value === void 0) {
-        throw new Error(`EQ operator requires a value for column ${condition.column}`);
-      }
-      if (condition.value === null) {
-        throw new Error("null is only allowed with isNull/isNotNull operators");
-      }
-      return sql`${column} = ${condition.value}`;
-    case "ne":
-      if (condition.value === void 0) {
-        throw new Error(`NE operator requires a value for column ${condition.column}`);
-      }
-      if (condition.value === null) {
-        throw new Error("null is only allowed with isNull/isNotNull operators");
-      }
-      return sql`${column} != ${condition.value}`;
-    case "gt":
-      if (typeof condition.value !== "string" && typeof condition.value !== "number") {
-        throw new Error(`GT operator requires a string or number value for column ${condition.column}`);
-      }
-      return sql`${column} > ${condition.value}`;
-    case "lt":
-      if (typeof condition.value !== "string" && typeof condition.value !== "number") {
-        throw new Error(`LT operator requires a string or number value for column ${condition.column}`);
-      }
-      return sql`${column} < ${condition.value}`;
-    case "gte":
-      if (typeof condition.value !== "string" && typeof condition.value !== "number") {
-        throw new Error(`GTE operator requires a string or number value for column ${condition.column}`);
-      }
-      return sql`${column} >= ${condition.value}`;
-    case "lte":
-      if (typeof condition.value !== "string" && typeof condition.value !== "number") {
-        throw new Error(`LTE operator requires a string or number value for column ${condition.column}`);
-      }
-      return sql`${column} <= ${condition.value}`;
-    case "like":
-      if (typeof condition.value !== "string") {
-        throw new Error(`LIKE operator requires a string value for column ${condition.column}`);
-      }
-      return sql`${column} LIKE ${condition.value}`;
-    case "in":
-      if (!Array.isArray(condition.value) || condition.value.length === 0) {
-        throw new Error(`IN operator requires a non-empty array value for column ${condition.column}`);
-      }
-      return sql`${column} IN (${sql.join(condition.value.map((v) => sql`${v}`), sql.raw(", "))})`;
-    case "notIn":
-      if (!Array.isArray(condition.value) || condition.value.length === 0) {
-        throw new Error(`NOT IN operator requires a non-empty array value for column ${condition.column}`);
-      }
-      return sql`${column} NOT IN (${sql.join(condition.value.map((v) => sql`${v}`), sql.raw(", "))})`;
-    case "isNull":
-      if (condition.value !== void 0) {
-        throw new Error(`IS NULL operator must not include value for column ${condition.column}`);
-      }
-      return sql`${column} IS NULL`;
-    case "isNotNull":
-      if (condition.value !== void 0) {
-        throw new Error(`IS NOT NULL operator must not include value for column ${condition.column}`);
-      }
-      return sql`${column} IS NOT NULL`;
-  }
-}
 function buildSelectQuery(input) {
   validateQualifiedIdentifier(input.table, "Table name");
   let query = sql.raw("SELECT ");
@@ -5399,7 +5338,9 @@ function buildSelectQuery(input) {
     sql.raw("")
   );
   if (input.where && input.where.length > 0) {
-    const whereConditions = input.where.map((condition) => buildSelectWhereCondition(condition, input.vendor));
+    const whereConditions = input.where.map(
+      (condition) => buildWhereCondition(condition, input.vendor)
+    );
     query = sql.join(
       [query, sql.raw(" WHERE "), sql.join(whereConditions, sql.raw(" AND "))],
       sql.raw("")