@starbemtech/star-db-query-builder 1.3.1 → 1.4.1

package/dist/src/core/utils.js

@@ -1,6 +1,206 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createOffsetClause = exports.createLimitClause = exports.createGroupByClause = exports.createOrderByClause = exports.createWhereClause = exports.generateSetClause = exports.generatePlaceholders = exports.createSelectFields = void 0;
+exports.createOffsetClause = exports.createLimitClause = exports.createGroupByClause = exports.createOrderByClause = exports.createWhereClause = exports.generateSetClause = exports.generatePlaceholders = exports.createSelectFields = exports.assertNoAutoManagedColumns = exports.quoteIdentifier = exports.assertSafeSqlFragment = exports.assertValidIdentifier = exports.stripUndefinedValues = exports.assertWithinBindParamLimit = exports.MAX_BIND_PARAMS = exports.MAX_IN_LIST_SIZE = void 0;
+/**
+ * Matches a bare SQL identifier, optionally schema/table-qualified
+ * (e.g. "id", "users", "users.id"). Used to validate table names, join
+ * tables, `where` field keys and delete-by fields, since those are always
+ * plain identifiers and never need SQL expressions. GROUP BY / ORDER BY
+ * fields are intentionally *not* restricted to this — they go through
+ * `assertSafeSqlFragment` instead, since both are documented to accept a
+ * full SQL expression (e.g. `COUNT(*) as total`), not just a bare column.
+ */
+const IDENTIFIER_PATTERN = /^[a-zA-Z_][a-zA-Z0-9_]*(\.[a-zA-Z_][a-zA-Z0-9_]*)?$/;
+/**
+ * Matches characters that have no legitimate use inside a SELECT
+ * expression or a JOIN ON condition (statement terminators, comment
+ * markers, backticks) but that are the building blocks of classic
+ * SQL injection (stacked queries, comment-based truncation). Includes `#`,
+ * MySQL's own single-line comment marker (distinct from the `--`/`/* *‍/`
+ * forms both dialects share) — previously missing here, so a fragment like
+ * `id # , (SELECT ...)` on a MySQL connection passed this check untouched.
+ */
+const DANGEROUS_SQL_PATTERN = /(;|--|\/\*|\*\/|`|#)/;
+/**
+ * Maximum number of values accepted in a single `IN`/`NOT IN`/`BETWEEN`
+ * condition array.
+ *
+ * This guards two real failure modes, both triggered by callers building a
+ * WHERE condition from an unbounded list (e.g. forwarding a large search
+ * result as an `IN` filter): pg's own wire protocol rejects a query with more
+ * than 65535 total bound parameters, and — well before that limit — building
+ * the values array with `values.push(...value)` throws
+ * `RangeError: Maximum call stack size exceeded` once `value.length` is large
+ * enough to overflow the JS engine's function-call argument limit. Chunk the
+ * list (e.g. multiple `IN` queries unioned, or a temp table / `= ANY($1::type[])`
+ * for pg) instead of growing a single condition past this size.
+ */
+exports.MAX_IN_LIST_SIZE = 10000;
+/**
+ * pg's wire protocol rejects a query with more than 65535 total bound
+ * parameters ("bind message has N parameter formats but M parameters" /
+ * "too many parameters"). Any function that can build a bind-parameter list
+ * proportional to caller input (a large `ids` array, a large batch insert)
+ * should check its total against this before building the query, rather
+ * than letting the database reject it with a cryptic protocol error.
+ */
+exports.MAX_BIND_PARAMS = 65535;
+/**
+ * Rejects a query that would exceed the maximum number of bind parameters
+ * a database driver accepts in a single statement
+ *
+ * @param count - The total number of bind parameters the query would use
+ * @param label - A human-readable label used in the error message
+ * @throws {Error} When `count` exceeds `MAX_BIND_PARAMS`
+ */
+const assertWithinBindParamLimit = (count, label) => {
+    if (count > exports.MAX_BIND_PARAMS) {
+        throw new Error(`${label} would use ${count} bind parameters, exceeding the maximum of ${exports.MAX_BIND_PARAMS} supported by the database driver. Chunk the operation into smaller batches.`);
+    }
+};
+exports.assertWithinBindParamLimit = assertWithinBindParamLimit;
+/**
+ * Every operator `createWhereClause` knows how to render. Kept in sync with
+ * `OperatorCondition['operator']` in `types.ts` — this is the runtime side of
+ * that compile-time union, since `key`/`operator` reach this function as
+ * plain strings regardless of what TypeScript enforced at the call site.
+ */
+const WHERE_OPERATOR_WHITELIST = new Set([
+    'ILIKE',
+    'LIKE',
+    '=',
+    '>',
+    '<',
+    'IN',
+    'BETWEEN',
+    '!=',
+    '<=',
+    '>=',
+    'NOT IN',
+    'NOT LIKE',
+    'IS NULL',
+    'IS NOT NULL',
+    'NOT EXISTS',
+]);
+/**
+ * Drops every key whose value is `undefined` from a write payload (`update`
+ * / `updateMany`'s `data`).
+ *
+ * A partial DTO built by spreading an object with an optional, unset field
+ * (`{ ...partial }`) routinely carries an explicit `undefined` for that key
+ * rather than omitting it — `Object.keys`/`Object.values` still see it. Left
+ * in, it reaches the driver as a real bind parameter: node-postgres silently
+ * coerces it to SQL `NULL` (overwriting the column instead of leaving it
+ * untouched), while mysql2 rejects it outright. Filtering it out here makes
+ * "didn't pass a value" behave the same way on both drivers: the column is
+ * left alone, matching how a plain REST PATCH body treats a missing field.
+ *
+ * @param data - The write payload to filter
+ * @returns A shallow copy of `data` with every `undefined`-valued key removed
+ */
+const stripUndefinedValues = (data) => {
+    const result = {};
+    for (const [key, value] of Object.entries(data)) {
+        if (value !== undefined) {
+            ;
+            result[key] = value;
+        }
+    }
+    return result;
+};
+exports.stripUndefinedValues = stripUndefinedValues;
+/**
+ * Validates that a value is a safe, bare SQL identifier
+ *
+ * This function throws when the value is anything other than a plain
+ * identifier (letters, digits, underscore, optionally schema/table-qualified
+ * with a single dot). It exists to stop identifiers coming from untrusted
+ * input (table names, column names) from being used to inject arbitrary SQL,
+ * since this library interpolates identifiers directly into the query string.
+ *
+ * @param value - The identifier to validate
+ * @param label - A human-readable label used in the error message
+ * @throws {Error} When the value is not a valid identifier
+ *
+ * @example
+ * assertValidIdentifier('users', 'table name') // ok
+ * assertValidIdentifier('users; DROP TABLE users', 'table name') // throws
+ */
+const assertValidIdentifier = (value, label) => {
+    if (typeof value !== 'string' || !IDENTIFIER_PATTERN.test(value)) {
+        throw new Error(`Invalid ${label}: "${value}". Only letters, numbers, underscores and a single dot (schema.table or table.column) are allowed.`);
+    }
+};
+exports.assertValidIdentifier = assertValidIdentifier;
+/**
+ * Validates that a raw SQL fragment does not contain statement terminators,
+ * comment markers or backticks
+ *
+ * Some parts of a query (SELECT fields, JOIN ON conditions) are allowed to
+ * be full SQL expressions (e.g. "COUNT(*) as total"), so they cannot be
+ * restricted to bare identifiers. This function instead blocks the
+ * characters that have no legitimate use in those positions and that are
+ * the building blocks of stacked-query and comment-based SQL injection.
+ *
+ * @param value - The SQL fragment to validate
+ * @param label - A human-readable label used in the error message
+ * @throws {Error} When the fragment contains disallowed characters
+ *
+ * @example
+ * assertSafeSqlFragment('COUNT(*) as total', 'select field') // ok
+ * assertSafeSqlFragment('id; DROP TABLE users; --', 'select field') // throws
+ */
+const assertSafeSqlFragment = (value, label) => {
+    if (typeof value !== 'string' || DANGEROUS_SQL_PATTERN.test(value)) {
+        throw new Error(`Invalid ${label}: "${value}" contains disallowed characters (; -- /* */ \`).`);
+    }
+};
+exports.assertSafeSqlFragment = assertSafeSqlFragment;
+/**
+ * Quotes a column identifier using the target database's quoting convention
+ *
+ * This wraps a validated identifier in double quotes for PostgreSQL or
+ * backticks for MySQL, so reserved words (e.g. "order", "group", "user",
+ * "authorization") can be used as column names without a per-column special
+ * case.
+ *
+ * @param identifier - The already-validated column identifier
+ * @param clientType - The type of database client
+ * @returns The quoted identifier
+ *
+ * @example
+ * quoteIdentifier('order', 'pg') // '"order"'
+ * quoteIdentifier('order', 'mysql') // '`order`'
+ */
+const quoteIdentifier = (identifier, clientType) => (clientType === 'pg' ? `"${identifier}"` : `\`${identifier}\``);
+exports.quoteIdentifier = quoteIdentifier;
+/**
+ * Columns that `insert`/`insertMany`/`upsert` always add themselves
+ * (a generated `id` and a refreshed `updated_at`) and therefore must not
+ * also appear in the caller-supplied `data`.
+ */
+const AUTO_MANAGED_COLUMNS = new Set(['id', 'updated_at']);
+/**
+ * Rejects a caller-supplied column list that includes a column the function
+ * manages itself (`id`, `updated_at`)
+ *
+ * Without this check, a `data` object containing `id` or `updated_at` ended
+ * up duplicated in the generated column list (e.g.
+ * `INSERT INTO t ("id", "id", ...)`), which the database rejects with a
+ * confusing syntax/duplicate-column error instead of a clear one from this
+ * library.
+ *
+ * @param keys - The column names from the caller-supplied `data` object
+ * @param fnName - The name of the calling function, used in the error message
+ * @throws {Error} When `keys` includes `id` or `updated_at`
+ */
+const assertNoAutoManagedColumns = (keys, fnName) => {
+    const found = keys.filter((key) => AUTO_MANAGED_COLUMNS.has(key));
+    if (found.length > 0) {
+        throw new Error(`${fnName}: data must not include [${found.join(', ')}] — ${fnName} manages these columns itself (generates "id", refreshes "updated_at").`);
+    }
+};
+exports.assertNoAutoManagedColumns = assertNoAutoManagedColumns;
 /**
  * Converts an array of strings to a comma-separated string with quotes
  *
@@ -67,9 +267,10 @@ const mysqlPlaceholderGenerator = () => `?`;
  * // result will be: "id, name, email"
  */
 const createSelectFields = (fields = [], clientType) => {
-    return fields && fields.length > 0
-        ? arrayToStringWithQuotes(fields, clientType)
-        : '*';
+    if (!fields || fields.length === 0)
+        return '*';
+    fields.forEach((field) => (0, exports.assertSafeSqlFragment)(field, 'select field'));
+    return arrayToStringWithQuotes(fields, clientType);
 };
 exports.createSelectFields = createSelectFields;
 /**
@@ -141,96 +342,151 @@ const createWhereClause = (conditions = {}, startIndex = 1, clientType, unaccent
     const whereParts = [];
     const values = [];
     const processCondition = (key, condition) => {
-        if (typeof condition === 'object' && condition !== null) {
-            if ('operator' in condition && 'value' in condition) {
-                const { operator, value } = condition;
-                if (operator === 'NOT EXISTS' && typeof value === 'string') {
-                    whereParts.push(`NOT EXISTS (${value})`);
-                }
-                else if (operator.includes('NULL')) {
-                    whereParts.push(`${key} ${operator}`);
-                }
-                else if (Array.isArray(value)) {
-                    const placeholders = value
-                        .map(() => clientType === 'pg'
-                        ? pgPlaceholderGenerator(index++)
-                        : mysqlPlaceholderGenerator())
-                        .join(', ');
-                    if (operator === 'BETWEEN') {
-                        whereParts.push(`${key} ${operator} ${placeholders.replace(', ', ' AND ')}`);
-                    }
-                    else if (operator === 'IN') {
-                        whereParts.push(`${key} ${operator} (${placeholders})`);
-                    }
-                    else {
-                        whereParts.push(`${key} ${operator} (${placeholders})`);
-                    }
-                    values.push(...value);
+        if (typeof condition !== 'object' ||
+            condition === null ||
+            !('operator' in condition) ||
+            !('value' in condition)) {
+            // A plain value (e.g. `{ status: 'active' }`) used to be silently
+            // dropped here instead of throwing — every field using that shape
+            // vanished from the WHERE clause with no error, which is how
+            // `updateMany`/`deleteMany` calls that meant to scope a write ended up
+            // running against the entire table. Fail loud instead.
+            throw new Error(`Invalid where condition for "${key}": expected { operator, value }, got ${JSON.stringify(condition)}. A plain value is not a supported shape — use { ${key}: { operator: '=', value: ... } } instead.`);
+        }
+        const { value } = condition;
+        // Normalized so callers that pass a lowercase/mixed-case operator (e.g.
+        // 'ilike', supported pre-1.4.0 since the operator used to be interpolated
+        // as-is) keep working instead of silently failing the whitelist check.
+        const operator = String(condition.operator).toUpperCase();
+        (0, exports.assertValidIdentifier)(key, 'where field');
+        if (!WHERE_OPERATOR_WHITELIST.has(operator)) {
+            throw new Error(`Invalid where operator: "${operator}". Only ${[...WHERE_OPERATOR_WHITELIST].join(', ')} are allowed.`);
+        }
+        if (operator === 'NOT EXISTS') {
+            if (typeof value !== 'string') {
+                throw new Error(`Where condition on "${key}" uses operator "NOT EXISTS" with a non-string value. NOT EXISTS requires a raw subquery string.`);
+            }
+            (0, exports.assertSafeSqlFragment)(value, 'where NOT EXISTS subquery');
+            whereParts.push(`NOT EXISTS (${value})`);
+        }
+        else if (operator.includes('NULL')) {
+            whereParts.push(`${key} ${operator}`);
+        }
+        else if (Array.isArray(value)) {
+            if (operator === 'BETWEEN' && value.length !== 2) {
+                throw new Error(`Where condition on "${key}" uses operator "BETWEEN" with ${value.length} values — BETWEEN requires exactly 2 (start and end).`);
+            }
+            if (value.length === 0 && operator !== 'BETWEEN') {
+                // `key IN ()` / `key NOT IN ()` is a SQL syntax error on both pg and
+                // MySQL (the list must have at least one element) — fail with a
+                // clear message instead of handing the caller that opaque driver
+                // error once the query reaches the database.
+                throw new Error(`Where condition on "${key}" uses operator "${operator}" with an empty array — this has no valid SQL translation. Pass at least one value, or omit the condition entirely if there is nothing to filter by.`);
+            }
+            if (value.length > exports.MAX_IN_LIST_SIZE) {
+                throw new Error(`Where condition on "${key}" has ${value.length} values for operator "${operator}", exceeding the maximum of ${exports.MAX_IN_LIST_SIZE}. Chunk the query instead of growing a single condition this large.`);
+            }
+            const placeholders = value
+                .map(() => clientType === 'pg'
+                ? pgPlaceholderGenerator(index++)
+                : mysqlPlaceholderGenerator())
+                .join(', ');
+            if (operator === 'BETWEEN') {
+                whereParts.push(`${key} ${operator} ${placeholders.replace(', ', ' AND ')}`);
+            }
+            else {
+                whereParts.push(`${key} ${operator} (${placeholders})`);
+            }
+            // Not `values.push(...value)`: spreading a large array into a
+            // function call can itself throw `RangeError: Maximum call stack
+            // size exceeded` (V8's function-call argument limit), independent
+            // of the MAX_IN_LIST_SIZE guard above catching merely-large lists.
+            for (const item of value) {
+                values.push(item);
+            }
+        }
+        else {
+            if (unaccent && clientType === 'pg') {
+                if (operator.toUpperCase() === 'ILIKE') {
+                    whereParts.push(`unaccent(${key}::text) ILIKE unaccent(${pgPlaceholderGenerator(index)})`);
                 }
                 else {
-                    if (unaccent && clientType === 'pg') {
-                        if (operator.toUpperCase() === 'ILIKE') {
-                            whereParts.push(`unaccent(${key}::text) ILIKE unaccent(${pgPlaceholderGenerator(index)})`);
-                        }
-                        else {
-                            whereParts.push(`unaccent(${key}::text) ${operator} unaccent(${pgPlaceholderGenerator(index)})`);
-                        }
-                    }
-                    else {
-                        whereParts.push(clientType === 'pg'
-                            ? `${key} ${operator} ${pgPlaceholderGenerator(index)}`
-                            : `${key} ${operator} ${mysqlPlaceholderGenerator()}`);
-                    }
-                    index++;
-                    values.push(value);
+                    whereParts.push(`unaccent(${key}::text) ${operator} unaccent(${pgPlaceholderGenerator(index)})`);
                 }
             }
+            else {
+                whereParts.push(clientType === 'pg'
+                    ? `${key} ${operator} ${pgPlaceholderGenerator(index)}`
+                    : `${key} ${operator} ${mysqlPlaceholderGenerator()}`);
+            }
+            index++;
+            values.push(value);
+        }
+    };
+    Object.entries(conditions).forEach(([key, value]) => {
+        if (key === 'JOINS' || key === 'OR' || key === 'AND')
+            return;
+        processCondition(key, value);
+    });
+    // A group element (one entry of an `OR`/`AND`/`JOINS` array) can carry more
+    // than one key, e.g. `{ status: ..., tenant_id: ... }` — those sibling keys
+    // are ANDed together, same as sibling keys at the top level of `where`.
+    // Only ever reading `Object.keys(subCondition)[0]` here used to silently
+    // drop every key past the first, which is how a scoping condition (e.g.
+    // `tenant_id`) placed alongside another key inside the same group element
+    // could vanish from the generated SQL with no error.
+    const processGroupElement = (subCondition) => {
+        if (typeof subCondition !== 'object' ||
+            Array.isArray(subCondition) ||
+            subCondition === null) {
+            return '';
+        }
+        const parts = Object.entries(subCondition).map(([key, condition]) => {
+            // Adiciona o tratamento de unaccent nas condições do grupo também
+            processCondition(key, condition);
+            return whereParts.pop();
+        });
+        // Parenthesized whenever there's more than one key so this element's
+        // AND binds as a unit regardless of the surrounding logical operator
+        // (matters when this element sits inside an `OR` group).
+        return parts.length > 1 ? `(${parts.join(' AND ')})` : parts.join(' AND ');
+    };
+    // An empty `AND`/`OR`/`JOINS` array has no unambiguous SQL meaning (and
+    // isn't valid SQL syntax either way) — it used to silently render as the
+    // bare fragment "()", producing a query like `WHERE ()` or `WHERE a = $1
+    // AND ()`. Fail loud instead of handing the caller that syntax error once
+    // it reaches the database.
+    const assertNonEmptyGroup = (compositeConditions, label) => {
+        if (compositeConditions.length === 0) {
+            throw new Error(`Where condition "${label}" is an empty array — remove the key instead of passing an empty group.`);
         }
     };
     if ('JOINS' in conditions) {
-        const logicalOperator = conditions.JOINS ? 'AND' : 'OR';
         const compositeConditions = conditions.JOINS;
         if (Array.isArray(compositeConditions)) {
+            assertNonEmptyGroup(compositeConditions, 'JOINS');
             const subWhereParts = compositeConditions
-                .map((subCondition) => {
-                if (typeof subCondition === 'object' &&
-                    !Array.isArray(subCondition) &&
-                    subCondition !== null) {
-                    const key = Object.keys(subCondition)[0];
-                    const condition = subCondition[key];
-                    // Adiciona o tratamento de unaccent nas condições de JOINS
-                    processCondition(key, condition);
-                    return whereParts.pop();
-                }
-                return '';
-            })
-                .filter((part) => part);
-            whereParts.push(`(${subWhereParts.join(` ${logicalOperator} `)})`);
-        }
-    }
-    else {
-        Object.entries(conditions).forEach(([key, value]) => processCondition(key, value));
-    }
-    if ('OR' in conditions || 'AND' in conditions) {
-        const logicalOperator = conditions.OR ? 'OR' : 'AND';
-        const compositeConditions = conditions.OR || conditions.AND;
-        if (Array.isArray(compositeConditions)) {
-            const subWhereParts = compositeConditions
-                .map((subCondition) => {
-                if (typeof subCondition === 'object' &&
-                    !Array.isArray(subCondition) &&
-                    subCondition !== null) {
-                    const key = Object.keys(subCondition)[0];
-                    const condition = subCondition[key];
-                    processCondition(key, condition); // Certifica que o unaccent é processado aqui também
-                    return whereParts.pop();
-                }
-                return '';
-            })
+                .map(processGroupElement)
                 .filter((part) => part);
-            whereParts.push(`(${subWhereParts.join(` ${logicalOperator} `)})`);
+            whereParts.push(`(${subWhereParts.join(' AND ')})`);
         }
     }
+    const pushLogicalGroup = (compositeConditions, logicalOperator) => {
+        if (!Array.isArray(compositeConditions))
+            return;
+        assertNonEmptyGroup(compositeConditions, logicalOperator);
+        const subWhereParts = compositeConditions
+            .map(processGroupElement)
+            .filter((part) => part);
+        whereParts.push(`(${subWhereParts.join(` ${logicalOperator} `)})`);
+    };
+    // Each processed independently — a `where` with both `OR` and `AND` groups
+    // used to only render whichever one `conditions.OR ? 'OR' : 'AND'` picked,
+    // silently dropping the other group from the generated SQL.
+    if ('OR' in conditions)
+        pushLogicalGroup(conditions.OR, 'OR');
+    if ('AND' in conditions)
+        pushLogicalGroup(conditions.AND, 'AND');
     const whereClause = whereParts.length > 0 ? ` WHERE ${whereParts.join(' AND ')}` : '';
     return [whereClause, values, index];
 };
@@ -252,7 +508,15 @@ exports.createWhereClause = createWhereClause;
 const createOrderByClause = (orderBy) => {
     if (!orderBy || orderBy.length === 0)
         return '';
-    const clause = orderBy.map((o) => `${o.field} ${o.direction}`).join(', ');
+    const clause = orderBy
+        .map((o) => {
+        (0, exports.assertSafeSqlFragment)(o.field, 'orderBy field');
+        if (o.direction !== 'ASC' && o.direction !== 'DESC') {
+            throw new Error(`Invalid orderBy direction: "${o.direction}". Only ASC or DESC are allowed.`);
+        }
+        return `${o.field} ${o.direction}`;
+    })
+        .join(', ');
     return ` ORDER BY ${clause}`;
 };
 exports.createOrderByClause = createOrderByClause;
@@ -273,6 +537,7 @@ exports.createOrderByClause = createOrderByClause;
 const createGroupByClause = (groupBy) => {
     if (!groupBy || groupBy.length === 0)
         return '';
+    groupBy.forEach((field) => (0, exports.assertSafeSqlFragment)(field, 'groupBy field'));
     return ` GROUP BY ${groupBy.join(', ')}`;
 };
 exports.createGroupByClause = createGroupByClause;
@@ -293,6 +558,9 @@ exports.createGroupByClause = createGroupByClause;
 const createLimitClause = (limit) => {
     if (!limit)
         return '';
+    if (!Number.isInteger(limit) || limit <= 0) {
+        throw new Error(`Invalid limit: "${limit}". Must be a positive integer.`);
+    }
     return ` LIMIT ${limit}`;
 };
 exports.createLimitClause = createLimitClause;
@@ -313,6 +581,9 @@ exports.createLimitClause = createLimitClause;
 const createOffsetClause = (offset) => {
     if (!offset)
         return '';
+    if (!Number.isInteger(offset) || offset < 0) {
+        throw new Error(`Invalid offset: "${offset}". Must be a non-negative integer.`);
+    }
     return ` OFFSET ${offset}`;
 };
 exports.createOffsetClause = createOffsetClause;

package/dist/src/core/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/core/utils.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,uBAAuB,GAAG,CAC9B,KAAe,EACf,UAAqB,EACb,EAAE;IACV,MAAM,eAAe,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACzC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,CAC5C,CAAA;IACD,OAAO,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACnC,CAAC,CAAA;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,sBAAsB,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,CAAA;AAE7D;;;;;;;;;;;GAWG;AACH,MAAM,yBAAyB,GAAG,GAAG,EAAE,CAAC,GAAG,CAAA;AAE3C;;;;;;;;;;;;;;;GAeG;AACI,MAAM,kBAAkB,GAAG,CAChC,SAAmB,EAAE,EACrB,UAAqB,EACb,EAAE;IACV,OAAO,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QAChC,CAAC,CAAC,uBAAuB,CAAC,MAAM,EAAE,UAAU,CAAC;QAC7C,CAAC,CAAC,GAAG,CAAA;AACT,CAAC,CAAA;AAPY,QAAA,kBAAkB,sBAO9B;AAED;;;;;;;;;;;;;;;GAeG;AACI,MAAM,oBAAoB,GAAG,CAClC,IAAW,EACX,UAAqB,EACb,EAAE;IACV,OAAO,IAAI;SACR,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;SAChE,IAAI,CAAC,IAAI,CAAC,CAAA;AACf,CAAC,CAAA;AAPY,QAAA,oBAAoB,wBAOhC;AAED;;;;;;;;;;;;;;;GAeG;AACI,MAAM,iBAAiB,GAAG,CAC/B,IAAW,EACX,UAAqB,EACb,EAAE;IACV,OAAO,IAAI;SACR,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAClB,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,OAAO,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,MAAM,CAC9D;SACA,IAAI,CAAC,IAAI,CAAC,CAAA;AACf,CAAC,CAAA;AATY,QAAA,iBAAiB,qBAS7B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACI,MAAM,iBAAiB,GAAG,CAC/B,aAA4B,EAAE,EAC9B,UAAU,GAAG,CAAC,EACd,UAAqB,EACrB,QAAkB,EACO,EAAE;IAC3B,IAAI,KAAK,GAAG,UAAU,CAAA;IACtB,MAAM,UAAU,GAAa,EAAE,CAAA;IAC/B,MAAM,MAAM,GAAU,EAAE,CAAA;IAExB,MAAM,gBAAgB,GAAG,CAAC,GAAW,EAAE,SAAuB,EAAE,EAAE;QAChE,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YACxD,IAAI,UAAU,IAAI,SAAS,IAAI,OAAO,IAAI,SAAS,EAAE,CAAC;gBACpD,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,SAAS,CAAA;gBAErC,IAAI,QAAQ,KAAK,YAAY,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;oBAC3D,UAAU,CAAC,IAAI,CAAC,eAAe,KAAK,GAAG,CAAC,CAAA;gBAC1C,CAAC;qBAAM,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;oBACrC,UAAU,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,QAAQ,EAAE,CAAC,CAAA;gBACvC,CAAC;qBAAM,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;oBAChC,MAAM,YAAY,GAAG,KAAK;yBACvB,GAAG,CAAC,GAAG,EAAE,CACR,UAAU,KAAK,IAAI;wBACjB,CAAC,CAAC,sBAAsB,CAAC,KAAK,EAAE,CAAC;wBACjC,CAAC,CAAC,yBAAyB,EAAE,CAChC;yBACA,IAAI,CAAC,IAAI,CAAC,CAAA;oBAEb,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;wBAC3B,UAAU,CAAC,IAAI,CACb,GAAG,GAAG,IAAI,QAAQ,IAAI,YAAY,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAC5D,CAAA;oBACH,CAAC;yBAAM,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;wBAC7B,UAAU,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,QAAQ,KAAK,YAAY,GAAG,CAAC,CAAA;oBACzD,CAAC;yBAAM,CAAC;wBACN,UAAU,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,QAAQ,KAAK,YAAY,GAAG,CAAC,CAAA;oBACzD,CAAC;oBACD,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAA;gBACvB,CAAC;qBAAM,CAAC;oBACN,IAAI,QAAQ,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;wBACpC,IAAI,QAAQ,CAAC,WAAW,EAAE,KAAK,OAAO,EAAE,CAAC;4BACvC,UAAU,CAAC,IAAI,CACb,YAAY,GAAG,0BAA0B,sBAAsB,CAAC,KAAK,CAAC,GAAG,CAC1E,CAAA;wBACH,CAAC;6BAAM,CAAC;4BACN,UAAU,CAAC,IAAI,CACb,YAAY,GAAG,WAAW,QAAQ,aAAa,sBAAsB,CAAC,KAAK,CAAC,GAAG,CAChF,CAAA;wBACH,CAAC;oBACH,CAAC;yBAAM,CAAC;wBACN,UAAU,CAAC,IAAI,CACb,UAAU,KAAK,IAAI;4BACjB,CAAC,CAAC,GAAG,GAAG,IAAI,QAAQ,IAAI,sBAAsB,CAAC,KAAK,CAAC,EAAE;4BACvD,CAAC,CAAC,GAAG,GAAG,IAAI,QAAQ,IAAI,yBAAyB,EAAE,EAAE,CACxD,CAAA;oBACH,CAAC;oBACD,KAAK,EAAE,CAAA;oBACP,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;gBACpB,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC,CAAA;IAED,IAAI,OAAO,IAAI,UAAU,EAAE,CAAC;QAC1B,MAAM,eAAe,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAA;QACvD,MAAM,mBAAmB,GAAG,UAAU,CAAC,KAAK,CAAA;QAE5C,IAAI,KAAK,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE,CAAC;YACvC,MAAM,aAAa,GAAG,mBAAmB;iBACtC,GAAG,CAAC,CAAC,YAAiB,EAAE,EAAE;gBACzB,IACE,OAAO,YAAY,KAAK,QAAQ;oBAChC,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC;oBAC5B,YAAY,KAAK,IAAI,EACrB,CAAC;oBACD,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAA;oBACxC,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,CAAC,CAAA;oBAEnC,2DAA2D;oBAC3D,gBAAgB,CAAC,GAAG,EAAE,SAAS,CAAC,CAAA;oBAChC,OAAO,UAAU,CAAC,GAAG,EAAE,CAAA;gBACzB,CAAC;gBACD,OAAO,EAAE,CAAA;YACX,CAAC,CAAC;iBACD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,CAAA;YAEzB,UAAU,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,eAAe,GAAG,CAAC,GAAG,CAAC,CAAA;QACpE,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAClD,gBAAgB,CAAC,GAAG,EAAE,KAAqB,CAAC,CAC7C,CAAA;IACH,CAAC;IAED,IAAI,IAAI,IAAI,UAAU,IAAI,KAAK,IAAI,UAAU,EAAE,CAAC;QAC9C,MAAM,eAAe,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAA;QACpD,MAAM,mBAAmB,GAAG,UAAU,CAAC,EAAE,IAAI,UAAU,CAAC,GAAG,CAAA;QAE3D,IAAI,KAAK,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE,CAAC;YACvC,MAAM,aAAa,GAAG,mBAAmB;iBACtC,GAAG,CAAC,CAAC,YAAiB,EAAE,EAAE;gBACzB,IACE,OAAO,YAAY,KAAK,QAAQ;oBAChC,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC;oBAC5B,YAAY,KAAK,IAAI,EACrB,CAAC;oBACD,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAA;oBACxC,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,CAAC,CAAA;oBACnC,gBAAgB,CAAC,GAAG,EAAE,SAAS,CAAC,CAAA,CAAC,oDAAoD;oBACrF,OAAO,UAAU,CAAC,GAAG,EAAE,CAAA;gBACzB,CAAC;gBAED,OAAO,EAAE,CAAA;YACX,CAAC,CAAC;iBACD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,CAAA;YAEzB,UAAU,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,eAAe,GAAG,CAAC,GAAG,CAAC,CAAA;QACpE,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GACf,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IACnE,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,CAAA;AACrC,CAAC,CAAA;AA3HY,QAAA,iBAAiB,qBA2H7B;AAED;;;;;;;;;;;;;GAaG;AACI,MAAM,mBAAmB,GAAG,CAAC,OAAiB,EAAE,EAAE;IACvD,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IAC/C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACzE,OAAO,aAAa,MAAM,EAAE,CAAA;AAC9B,CAAC,CAAA;AAJY,QAAA,mBAAmB,uBAI/B;AAED;;;;;;;;;;;;;GAaG;AACI,MAAM,mBAAmB,GAAG,CAAC,OAAkB,EAAE,EAAE;IACxD,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IAC/C,OAAO,aAAa,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAA;AAC1C,CAAC,CAAA;AAHY,QAAA,mBAAmB,uBAG/B;AAED;;;;;;;;;;;;;GAaG;AACI,MAAM,iBAAiB,GAAG,CAAC,KAAc,EAAE,EAAE;IAClD,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAA;IACrB,OAAO,UAAU,KAAK,EAAE,CAAA;AAC1B,CAAC,CAAA;AAHY,QAAA,iBAAiB,qBAG7B;AAED;;;;;;;;;;;;;GAaG;AACI,MAAM,kBAAkB,GAAG,CAAC,MAAe,EAAE,EAAE;IACpD,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAA;IACtB,OAAO,WAAW,MAAM,EAAE,CAAA;AAC5B,CAAC,CAAA;AAHY,QAAA,kBAAkB,sBAG9B"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/core/utils.ts"],"names":[],"mappings":"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"}

package/dist/src/db/IDatabaseClient.d.ts

@@ -1,14 +1,24 @@
 import { DBClients } from '../core/types';
-export interface ITransactionClient {
+/**
+ * What every query-executing function in `repository.ts` (`findFirst`,
+ * `insert`, `update`, ...) actually needs from a client: `clientType` (to
+ * pick the right placeholder/quoting dialect) and `query`. Kept separate
+ * from `IDatabaseClient` so a transaction client — which has no
+ * `beginTransaction` of its own — can be passed as `dbClient` to these
+ * functions too (`withTransaction(dbClient, (tx) => insert({ dbClient: tx, ... }))`,
+ * the pattern documented in `docs/methods/transactions.md` and the README).
+ */
+export interface IQueryClient {
+    clientType: DBClients;
     query: <T>(sql: string, params?: any[]) => Promise<T>;
+}
+export interface ITransactionClient extends IQueryClient {
     commit: () => Promise<void>;
     rollback: () => Promise<void>;
 }
 /**
  * Database client interface
  */
-export type IDatabaseClient = {
-    clientType: DBClients;
-    query: <T>(sql: string, params?: any[]) => Promise<T>;
+export type IDatabaseClient = IQueryClient & {
     beginTransaction: () => Promise<ITransactionClient>;
 };