@lokalise/prisma-utils 6.0.1 → 7.0.0

package/README.md

@@ -30,7 +30,7 @@ const prisma = prismaClientFactory(PrismaClient, {
 ```typescript
 import { prismaClientFactory } from '@lokalise/prisma-utils'
 import { PrismaClient } from '@prisma/client'
-import * as promClient from 'prom-client'
+import * as promClient from '@prometheus-io/client'
 
 const prisma = prismaClientFactory(
   PrismaClient,
@@ -142,3 +142,63 @@ when multiple transactions compete for the same resources. This helper abstracts
 errors, providing a robust and efficient way to ensure your transactions succeed even under high contention.
 By automatically retrying failed transactions with an intelligent backoff strategy, you can significantly improve the 
 reliability and performance of your application when using distributed databases.
+
+### Prisma Bulk Update
+
+Updates many rows in a single atomic SQL statement (`UPDATE ... FROM (VALUES ...)`), instead of issuing one `UPDATE` per row. Because it is a single statement, it either fully applies or fully rolls back, so no surrounding transaction is required. Works on both CockroachDB and PostgreSQL.
+
+#### Basic Usage
+
+```typescript
+import { prismaBulkUpdate } from '@lokalise/prisma-utils'
+
+await prismaBulkUpdate(prisma, 'segment', {
+  dbDriver: 'CockroachDb',
+  typeByColumn: { id: 'uuid', value: 'text', words_count: 'int4' },
+}, [
+  { where: { id: id1 }, data: { value: 'a', words_count: 1 } },
+  { where: { id: id2 }, data: { value: 'b', words_count: 2 } },
+])
+```
+
+The above executes a single statement of the form:
+
+```sql
+UPDATE "segment"
+SET "value" = updates."value"::text, "words_count" = updates."words_count"::int4
+FROM (VALUES ($1::uuid, $2::text, $3::int4), ($4::uuid, $5::text, $6::int4))
+    AS updates("id", "value", "words_count")
+WHERE "segment"."id" = updates."id"::uuid
+```
+
+#### Parameters
+
+- **`prisma`** — a Prisma client or a transaction client (e.g. the `tx` passed to `prismaTransaction`'s callback).
+- **`tableName`** — target table, optionally schema-qualified (e.g. `'translation.segment'`).
+- **`options`**:
+  - **`dbDriver`** — `'CockroachDb'` or `'Postgres'`. Selects which column-type vocabulary `typeByColumn` autocompletes; the emitted SQL is identical for both.
+  - **`typeByColumn`** — explicit SQL type for every `where` column and every defined `data` column. The explicit `::type` cast is required by CockroachDB (it will not infer placeholder types inside a `VALUES` list) and is also valid PostgreSQL.
+  - **`returning`** (optional) — map of DB column name to the result alias to expose via a `RETURNING` clause.
+- **`entries`** — the rows to update; every entry must specify the same `where` columns and the same set of defined `data` columns.
+
+#### Behavior Notes
+
+- **`undefined` vs `null`** — following Prisma's convention, an `undefined` value in `data` leaves that column untouched (it is dropped from the statement), while `null` sets the column to SQL `NULL`.
+- **JSON columns** — values for `json`/`jsonb` columns are `JSON.stringify`-ed automatically; everything else is bound natively.
+- **Returning rows** — when `returning` is provided (and non-empty), the updated rows are returned aliased per the map; when it is omitted or an empty map, an empty array is returned. The row type can be set via the generic:
+
+```typescript
+const updated = await prismaBulkUpdate<{ id: string; value: string }>(
+  prisma,
+  'segment',
+  {
+    dbDriver: 'CockroachDb',
+    typeByColumn: { id: 'uuid', value: 'text' },
+    returning: { id: 'id', value: 'value' },
+  },
+  [{ where: { id: id1 }, data: { value: 'a' } }],
+)
+```
+
+- **Limits** — at most 1000 entries per call, and the total bound parameters (`entries × (where columns + data columns)`) must not exceed 65535 — the shared protocol limit for PostgreSQL and CockroachDB. Both are validated up front. A column may not appear in both `where` and `data`.
+- **Trusted identifiers** — `tableName`, all column names, the column types, and the `returning` keys/aliases are interpolated as raw SQL identifiers (only row values are bound). They must be static, trusted configuration, never end-user input.

package/dist/bulk-update/index.d.ts

@@ -0,0 +1,2 @@
+export { prismaBulkUpdate } from './prismaBulkUpdate.ts';
+export type * from './types.ts';

package/dist/bulk-update/index.js

@@ -0,0 +1,2 @@
+export { prismaBulkUpdate } from './prismaBulkUpdate.js';
+//# sourceMappingURL=index.js.map

package/dist/bulk-update/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/bulk-update/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/bulk-update/prismaBulkUpdate.d.ts

@@ -0,0 +1,55 @@
+import type { PrismaClient } from 'db-client/client.ts';
+import type { PrismaTransactionClient } from '../transaction/types.ts';
+import type { BulkUpdateEntry, PrismaBulkUpdateOptions } from './types.ts';
+/**
+ * Performs a full bulk update operation using Prisma in a single SQL statement.
+ * Because it is a single statement, the update is atomic: it either fully applies
+ * or fully rolls back, so no surrounding transaction is required. Works on both
+ * CockroachDB and PostgreSQL (selected via `options.dbDriver`).
+ *
+ * The executed query follows the below structure for provided example data:
+ * [
+ *   { where: { id: 1 }, data: { col1: 11, col2: 12 } },
+ *   { where: { id: 2 }, data: { col1: 21, col2: 22 } },
+ * ]
+ *
+ * UPDATE "tbl"
+ * SET "col1" = updates."col1", "col2" = updates."col2"
+ * FROM (
+ *   VALUES
+ *     (1, 11, 12),
+ *     (2, 21, 22)
+ * ) AS updates("id", "col1", "col2")
+ * WHERE "tbl"."id" = updates."id"
+ *
+ * "data" values follow Prisma's convention: an `undefined` value leaves the
+ * column untouched (it is dropped from the statement), while `null` sets it to
+ * SQL `NULL`. Every entry must specify the same "where" columns and the same set
+ * of defined (non-`undefined`) "data" columns.
+ *
+ * When `options.returning` is provided, the updated rows are returned via a
+ * `RETURNING` clause built from it: each entry maps a DB column name to the alias
+ * the row should expose (e.g. `content_unit_id` -> `contentUnitId`). Columns are
+ * qualified with the target table (e.g. `"translation"."segment"."value"`) to
+ * avoid ambiguity with the `updates` source. Without it (or with an empty map)
+ * the statement runs as a plain update and an empty array is returned.
+ *
+ * Note on identifiers: `tableName`, the column names (`typeByColumn` keys and the
+ * `where`/`data` keys), the column `type`s, and the `returning` keys/aliases are
+ * interpolated into the SQL as raw identifiers — only the row *values* are bound
+ * as parameters. These must therefore be trusted, static configuration, never
+ * end-user input: a name containing a `"` would break out of its quoted
+ * identifier, and any string assigned to a `(string & {})` column type reaches
+ * the SQL verbatim.
+ *
+ * @template T - The shape of each row returned via `options.returning`.
+ * @template P - The concrete Prisma client type, inferred from `prisma` so that both
+ *   a full client and its derived transaction client (`PrismaTransactionClient<P>`) are accepted.
+ * @param prisma - The Prisma client instance (or a transaction client, e.g. inside `prismaTransaction`).
+ * @param tableName - The name of the table to update (may be schema-qualified, e.g. `translation.segment`).
+ * @param options - `dbDriver`, the `typeByColumn` map (must map every "where" column and every
+ *   "data" column that has a defined value), and an optional `returning` map.
+ * @param entries - The entries containing the match condition and column values for the update.
+ * @returns The updated rows (aliased per `options.returning`), or an empty array when it is omitted.
+ */
+export declare const prismaBulkUpdate: <T = unknown, P extends PrismaClient = PrismaClient>(prisma: P | PrismaTransactionClient<P>, tableName: string, options: PrismaBulkUpdateOptions, entries: BulkUpdateEntry[]) => Promise<T[]>;

package/dist/bulk-update/prismaBulkUpdate.js

@@ -0,0 +1,195 @@
+import { join, raw, sqltag as sql } from '@prisma/client/runtime/client';
+const JSON_COLUMN_TYPES = new Set(['json', 'jsonb']);
+const ENTRIES_LIMIT = 1000;
+/**
+ * Every value (each "where" and each defined "data" cell) becomes one bound
+ * placeholder in the `VALUES` list, so the statement uses
+ * `entries × (whereColumns + dataColumns)` parameters. PostgreSQL caps a single
+ * statement at 65535 bound parameters and CockroachDB has its own ceiling, so we
+ * guard the total up front to fail with a clear message instead of an opaque
+ * driver error. The effective row cap therefore shrinks as the statement widens.
+ */
+const BIND_PARAMETERS_LIMIT = 65535;
+/**
+ * Performs a full bulk update operation using Prisma in a single SQL statement.
+ * Because it is a single statement, the update is atomic: it either fully applies
+ * or fully rolls back, so no surrounding transaction is required. Works on both
+ * CockroachDB and PostgreSQL (selected via `options.dbDriver`).
+ *
+ * The executed query follows the below structure for provided example data:
+ * [
+ *   { where: { id: 1 }, data: { col1: 11, col2: 12 } },
+ *   { where: { id: 2 }, data: { col1: 21, col2: 22 } },
+ * ]
+ *
+ * UPDATE "tbl"
+ * SET "col1" = updates."col1", "col2" = updates."col2"
+ * FROM (
+ *   VALUES
+ *     (1, 11, 12),
+ *     (2, 21, 22)
+ * ) AS updates("id", "col1", "col2")
+ * WHERE "tbl"."id" = updates."id"
+ *
+ * "data" values follow Prisma's convention: an `undefined` value leaves the
+ * column untouched (it is dropped from the statement), while `null` sets it to
+ * SQL `NULL`. Every entry must specify the same "where" columns and the same set
+ * of defined (non-`undefined`) "data" columns.
+ *
+ * When `options.returning` is provided, the updated rows are returned via a
+ * `RETURNING` clause built from it: each entry maps a DB column name to the alias
+ * the row should expose (e.g. `content_unit_id` -> `contentUnitId`). Columns are
+ * qualified with the target table (e.g. `"translation"."segment"."value"`) to
+ * avoid ambiguity with the `updates` source. Without it (or with an empty map)
+ * the statement runs as a plain update and an empty array is returned.
+ *
+ * Note on identifiers: `tableName`, the column names (`typeByColumn` keys and the
+ * `where`/`data` keys), the column `type`s, and the `returning` keys/aliases are
+ * interpolated into the SQL as raw identifiers — only the row *values* are bound
+ * as parameters. These must therefore be trusted, static configuration, never
+ * end-user input: a name containing a `"` would break out of its quoted
+ * identifier, and any string assigned to a `(string & {})` column type reaches
+ * the SQL verbatim.
+ *
+ * @template T - The shape of each row returned via `options.returning`.
+ * @template P - The concrete Prisma client type, inferred from `prisma` so that both
+ *   a full client and its derived transaction client (`PrismaTransactionClient<P>`) are accepted.
+ * @param prisma - The Prisma client instance (or a transaction client, e.g. inside `prismaTransaction`).
+ * @param tableName - The name of the table to update (may be schema-qualified, e.g. `translation.segment`).
+ * @param options - `dbDriver`, the `typeByColumn` map (must map every "where" column and every
+ *   "data" column that has a defined value), and an optional `returning` map.
+ * @param entries - The entries containing the match condition and column values for the update.
+ * @returns The updated rows (aliased per `options.returning`), or an empty array when it is omitted.
+ */
+export const prismaBulkUpdate = (prisma, tableName, options, entries) => {
+    const { typeByColumn, returning } = options;
+    const [firstEntry] = entries;
+    if (!firstEntry) {
+        throw new Error('Entries array must not be empty');
+    }
+    if (entries.length > ENTRIES_LIMIT) {
+        throw new Error(`Entries array length must not exceed ${ENTRIES_LIMIT}`);
+    }
+    const whereColumns = resolveColumns(typeByColumn, Object.keys(firstEntry.where));
+    const dataColumns = resolveColumns(typeByColumn, definedColumnNames(firstEntry.data));
+    if (whereColumns.length === 0) {
+        throw new Error('Entry "where" object must not be empty');
+    }
+    if (dataColumns.length === 0) {
+        throw new Error('Entry "data" object must not be empty');
+    }
+    const undefinedWhereColumn = Object.keys(firstEntry.where).find((columnName) => firstEntry.where[columnName] === undefined);
+    if (undefinedWhereColumn) {
+        throw new Error(`Entry "where" column "${undefinedWhereColumn}" must not be undefined`);
+    }
+    // A column appearing in both "where" and "data" would be emitted twice in the
+    // `updates(...)` alias list, producing an invalid derived-table column list.
+    const overlappingColumn = dataColumns.find((dataColumn) => whereColumns.some((whereColumn) => whereColumn.name === dataColumn.name));
+    if (overlappingColumn) {
+        throw new Error(`Column "${overlappingColumn.name}" must not appear in both "where" and "data"`);
+    }
+    const bindParametersCount = entries.length * (whereColumns.length + dataColumns.length);
+    if (bindParametersCount > BIND_PARAMETERS_LIMIT) {
+        throw new Error(`Bulk update would use ${bindParametersCount} bind parameters ` +
+            `(${entries.length} entries × ${whereColumns.length + dataColumns.length} columns), ` +
+            `exceeding the limit of ${BIND_PARAMETERS_LIMIT}`);
+    }
+    // Quote each part of a (possibly schema-qualified) table name separately,
+    // so that "translation.segment" becomes "translation"."segment" rather than a
+    // single identifier named "translation.segment".
+    const quotedTableName = tableName
+        .split('.')
+        .map((part) => `"${part}"`)
+        .join('.');
+    const sqlSetExpressions = dataColumns.map((column) => {
+        return sql([`"${column.name}" = updates."${column.name}"::${column.type}`]);
+    });
+    const sqlValuesExpressions = entries.map((entry, index) => prepareSqlValuesExpression(entry, index, whereColumns, dataColumns));
+    const sqlValuesColumnAliases = [...whereColumns, ...dataColumns].map((column) => {
+        return sql([`"${column.name}"`]);
+    });
+    const sqlWhereConditions = whereColumns.map((column) => {
+        return sql([`${quotedTableName}."${column.name}" = updates."${column.name}"::${column.type}`]);
+    });
+    const updateStatement = sql `
+    UPDATE ${sql([quotedTableName])}
+    SET ${join(sqlSetExpressions, ', ')}
+    FROM (
+        VALUES ${join(sqlValuesExpressions, ',\n')}
+    ) AS updates(${join(sqlValuesColumnAliases, ', ')})
+    WHERE ${join(sqlWhereConditions, ' AND ')}
+  `;
+    if (!returning || Object.keys(returning).length === 0) {
+        return prisma.$executeRaw(updateStatement).then(() => []);
+    }
+    const sqlReturningExpressions = Object.entries(returning).map(([column, alias]) => {
+        return sql([`${quotedTableName}."${column}" AS "${alias}"`]);
+    });
+    return prisma.$queryRaw(sql `${updateStatement} RETURNING ${join(sqlReturningExpressions, ', ')}`);
+};
+/**
+ * Builds the parenthesized `(where..., set...)` tuple for a single entry — one
+ * row of the `VALUES` source. The entry must supply exactly the given `where`
+ * columns and the same set of defined `data` columns (the shape established by
+ * the first entry); a mismatch throws so the generated `VALUES` list stays
+ * rectangular and aligned with the column aliases.
+ */
+const prepareSqlValuesExpression = (entry, index, whereColumns, dataColumns) => {
+    if (whereColumns.length !== Object.keys(entry.where).length) {
+        throw new Error(`Entry "where" columns are not the same (at index ${index})`);
+    }
+    const sqlWhereValues = whereColumns.map((whereConditionColumn) => {
+        const whereConditionValue = entry.where[whereConditionColumn.name];
+        if (whereConditionValue === undefined) {
+            throw new Error(`Entry "where" column "${whereConditionColumn.name}" was not found (at index ${index})`);
+        }
+        return renderTypedValue(whereConditionValue, whereConditionColumn.type);
+    });
+    if (dataColumns.length !== definedColumnNames(entry.data).length) {
+        throw new Error(`Entry "data" columns are not the same (at index ${index})`);
+    }
+    const sqlSetValues = dataColumns.map((setExpressionColumn) => {
+        const setExpressionValue = entry.data[setExpressionColumn.name];
+        if (setExpressionValue === undefined) {
+            throw new Error(`Entry "data" column "${setExpressionColumn.name}" was not found (at index ${index})`);
+        }
+        return renderTypedValue(setExpressionValue, setExpressionColumn.type);
+    });
+    return sql `(${join(sqlWhereValues, ',')},${join(sqlSetValues, ',')})`;
+};
+/**
+ * Pairs each requested column name with its SQL type from `typeByColumn`,
+ * throwing when a column has no type mapping (it would otherwise produce an
+ * uncasted, ambiguous placeholder).
+ */
+const resolveColumns = (typeByColumn, columnNames) => columnNames.map((columnName) => {
+    const type = typeByColumn[columnName];
+    if (!type) {
+        throw new Error(`Column type mapping is missing for "${columnName}"`);
+    }
+    return { name: columnName, type };
+});
+/**
+ * `data` follows Prisma's convention: an `undefined` value means "leave the
+ * column untouched", so such keys are dropped from the statement (a `null` value
+ * is kept and becomes a SQL `NULL`). `where` columns are never dropped — they form
+ * the match condition.
+ */
+const definedColumnNames = (columnRecord) => Object.keys(columnRecord).filter((columnName) => columnRecord[columnName] !== undefined);
+/**
+ * Renders a single value as a typed SQL placeholder (e.g. `$1::uuid`).
+ *
+ * The explicit `::type` cast is required by CockroachDB, which (unlike
+ * PostgreSQL) refuses to infer the data type of an untyped placeholder inside a
+ * `VALUES` list ("could not determine data type of placeholder"). The cast is
+ * also valid PostgreSQL, so the same statement runs on both drivers.
+ *
+ * Whether a value is JSON-serialized is decided by the column type, not the
+ * runtime value: `json`/`jsonb` columns get the value stringified, everything
+ * else is bound directly (Prisma binds `Date`, numbers, etc. natively). A `null`
+ * is always bound directly so it becomes a SQL `NULL` rather than a JSON `null`.
+ */
+const renderTypedValue = (value, type) => value !== null && JSON_COLUMN_TYPES.has(type)
+    ? sql `${JSON.stringify(value)}::${raw(type)}`
+    : sql `${value}::${raw(type)}`;
+//# sourceMappingURL=prismaBulkUpdate.js.map

package/dist/bulk-update/prismaBulkUpdate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prismaBulkUpdate.js","sourceRoot":"","sources":["../../src/bulk-update/prismaBulkUpdate.ts"],"names":[],"mappings":"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"}

package/dist/bulk-update/types.d.ts

@@ -0,0 +1,41 @@
+import type { DbDriverEnum } from '../types.ts';
+/**
+ * One row of a bulk update: `where` identifies the row(s) to match and `data`
+ * holds the new column values. An `undefined` value in `data` follows Prisma's
+ * convention and leaves that column untouched; `null` sets a SQL NULL.
+ */
+export type BulkUpdateEntry = {
+    where: Record<string, unknown>;
+    data: Record<string, unknown>;
+};
+/**
+ * SQL type names shared by CockroachDB and PostgreSQL, used to render the
+ * explicit `::type` cast on every bound value.
+ */
+type CommonColumnSqlType = 'uuid' | 'text' | 'bool' | 'int2' | 'int4' | 'int8' | 'float4' | 'float8' | 'numeric' | 'date' | 'timestamptz' | 'json' | 'jsonb';
+/**
+ * The literal union provides autocomplete for the common types, while the
+ * `(string & {})` member keeps any other type assignable — e.g. schema-qualified
+ * enums like `translation.segment_status`.
+ */
+export type CockroachDbColumnSqlType = CommonColumnSqlType | 'bytes' | (string & {});
+export type PostgresColumnSqlType = CommonColumnSqlType | 'bytea' | 'varchar' | (string & {});
+/**
+ * Options for `prismaBulkUpdate`. `dbDriver` selects which column-type
+ * vocabulary `typeByColumn` autocompletes; the emitted SQL is identical for both.
+ * `typeByColumn` must map every `where` column and every defined `data` column.
+ */
+export type PrismaBulkUpdateOptions = {
+    /**
+     * Optional map of DB column name to the result alias to expose via a
+     * `RETURNING` clause. When omitted, no rows are returned.
+     */
+    returning?: Record<string, string>;
+} & ({
+    dbDriver: typeof DbDriverEnum.COCKROACH_DB;
+    typeByColumn: Record<string, CockroachDbColumnSqlType>;
+} | {
+    dbDriver: typeof DbDriverEnum.POSTGRES;
+    typeByColumn: Record<string, PostgresColumnSqlType>;
+});
+export {};

package/dist/bulk-update/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/bulk-update/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/bulk-update/types.ts"],"names":[],"mappings":""}

package/dist/errors/index.js

@@ -1,2 +1,2 @@
-export * from "./prismaError.js";
+export * from './prismaError.js';
 //# sourceMappingURL=index.js.map

package/dist/factory/extendPrismaClientWithMetrics.d.ts

@@ -1,3 +1,3 @@
+import type Prometheus from '@prometheus-io/client';
 import type { PrismaClient } from 'db-client/client.ts';
-import type Prometheus from 'prom-client';
 export declare const extendPrismaClientWithMetrics: <Client extends PrismaClient>(prisma: Client, promClient: typeof Prometheus) => Client;

package/dist/factory/index.js

@@ -1,2 +1,2 @@
-export { prismaClientFactory } from "./prismaClientFactory.js";
+export { prismaClientFactory } from './prismaClientFactory.js';
 //# sourceMappingURL=index.js.map

package/dist/factory/prismaClientFactory.d.ts

@@ -1,7 +1,7 @@
 import type * as RuntimePrisma from '@prisma/client/runtime/client';
+import type Prometheus from '@prometheus-io/client';
 import type { PrismaClient } from 'db-client/client.ts';
 import type { PrismaClientConstructor } from 'db-client/internal/class.ts';
-import type Prometheus from 'prom-client';
 export type prismaClientFactoryOptions = {
     promClient?: typeof Prometheus;
 };

package/dist/factory/prismaClientFactory.js

@@ -1,4 +1,4 @@
-import { extendPrismaClientWithMetrics } from "./extendPrismaClientWithMetrics.js";
+import { extendPrismaClientWithMetrics } from './extendPrismaClientWithMetrics.js';
 /**
  * Factory function to create a Prisma client instance with default configuration
  * and optional Prometheus metrics integration.

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+export * from './bulk-update/index.ts';
 export * from './errors/index.ts';
 export * from './factory/index.ts';
 export * from './transaction/index.ts';

package/dist/index.js

@@ -1,4 +1,5 @@
-export * from "./errors/index.js";
-export * from "./factory/index.js";
-export * from "./transaction/index.js";
+export * from './bulk-update/index.js';
+export * from './errors/index.js';
+export * from './factory/index.js';
+export * from './transaction/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAClC,cAAc,wBAAwB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAA;AACtC,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAClC,cAAc,wBAAwB,CAAA"}

package/dist/transaction/index.js

@@ -1,2 +1,2 @@
-export { prismaTransaction } from "./prismaTransaction.js";
+export { prismaTransaction } from './prismaTransaction.js';
 //# sourceMappingURL=index.js.map

package/dist/transaction/prismaTransaction.js

@@ -1,7 +1,7 @@
 import { setTimeout } from 'node:timers/promises';
 import { deepClone } from '@lokalise/node-core';
-import { isCockroachDBRetryTransaction } from "../errors/cockroachdbError.js";
-import { isPrismaClientKnownRequestError, isPrismaTransactionClosedError, PRISMA_SERIALIZATION_ERROR, PRISMA_SERVER_CLOSED_CONNECTION_ERROR, PRISMA_TRANSACTION_ERROR, } from "../errors/index.js";
+import { isCockroachDBRetryTransaction } from '../errors/cockroachdbError.js';
+import { isPrismaClientKnownRequestError, isPrismaTransactionClosedError, PRISMA_SERIALIZATION_ERROR, PRISMA_SERVER_CLOSED_CONNECTION_ERROR, PRISMA_TRANSACTION_ERROR, } from '../errors/index.js';
 const DEFAULT_OPTIONS = {
     retriesAllowed: 2, // first try + 2 retries = 3 tries
     baseRetryDelayMs: 100,

package/dist/types.d.ts

@@ -1,7 +1,7 @@
 type ObjectValues<T> = T[keyof T];
 export declare const DbDriverEnum: {
-    readonly COCKROACH_DB: "CockroachDb";
-    readonly POSTGRES: "Postgres";
+    readonly COCKROACH_DB: 'CockroachDb';
+    readonly POSTGRES: 'Postgres';
 };
 export type DbDriver = ObjectValues<typeof DbDriverEnum>;
 export {};

package/package.json

@@ -1,56 +1,57 @@
 {
-    "name": "@lokalise/prisma-utils",
-    "version": "6.0.1",
-    "type": "module",
-    "license": "Apache-2.0",
-    "files": [
-        "dist",
-        "README.md",
-        "LICENSE.md"
-    ],
-    "main": "./dist/index.js",
-    "exports": {
-        ".": "./dist/index.js",
-        "./package.json": "./package.json"
-    },
-    "homepage": "https://github.com/lokalise/shared-ts-libs",
-    "repository": {
-        "type": "git",
-        "url": "https://github.com/lokalise/shared-ts-libs.git"
-    },
-    "scripts": {
-        "build": "rimraf dist && npm run db:update-client && tsc --project tsconfig.build.json",
-        "clean": "rimraf dist",
-        "lint": "biome check . && tsc",
-        "lint:fix": "biome check --write",
-        "db:migration:dev": "prisma migrate dev --config=./prisma/prisma.config",
-        "db:update-client": "prisma generate",
-        "test": "vitest run",
-        "test:migrate": "cross-env NODE_ENV=test prisma migrate reset --config=./prisma/prisma.config --force",
-        "pretest:ci": "docker compose up -d --wait && npm run test:migrate",
-        "test:ci": "npm run test",
-        "posttest:ci": "docker compose down",
-        "prepublishOnly": "npm run build",
-        "package-version": "echo $npm_package_version",
-        "postversion": "biome check --write package.json"
-    },
-    "peerDependencies": {
-        "@lokalise/node-core": ">=14.7.4",
-        "@prisma/client": "^7.0.0",
-        "prisma": "^7.0.0",
-        "prom-client": ">=15.0.0"
-    },
-    "devDependencies": {
-        "@biomejs/biome": "^2.3.7",
-        "@lokalise/biome-config": "^3.1.0",
-        "@lokalise/tsconfig": "^3.1.0",
-        "@prisma/adapter-pg": "^7.4.0",
-        "@prisma/client": "^7.4.0",
-        "@vitest/coverage-v8": "^4.0.15",
-        "cross-env": "^10.0.0",
-        "prisma": "^7.4.0",
-        "rimraf": "^6.0.1",
-        "typescript": "5.9.3",
-        "vitest": "^4.0.15"
-    }
-}
+  "name": "@lokalise/prisma-utils",
+  "version": "7.0.0",
+  "type": "module",
+  "license": "Apache-2.0",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE.md"
+  ],
+  "main": "./dist/index.js",
+  "exports": {
+    ".": "./dist/index.js",
+    "./package.json": "./package.json"
+  },
+  "homepage": "https://github.com/lokalise/shared-ts-libs",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lokalise/shared-ts-libs.git",
+    "directory": "packages/app/prisma-utils"
+  },
+  "peerDependencies": {
+    "@lokalise/node-core": ">=14.7.4",
+    "@prisma/client": "^7.0.0",
+    "@prometheus-io/client": "^0.16.1",
+    "prisma": "^7.0.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.5.9",
+    "dotenv": "^17.0.0",
+    "@prisma/adapter-pg": "^7.4.0",
+    "@prisma/client": "^7.4.0",
+    "@vitest/coverage-v8": "^4.1.11",
+    "cross-env": "^10.0.0",
+    "prisma": "^7.10.0",
+    "rimraf": "^6.1.3",
+    "typescript": "7.0.2",
+    "vitest": "^4.1.11",
+    "@lokalise/biome-config": "^3.1.1",
+    "@lokalise/tsconfig": "^5.0.0"
+  },
+  "scripts": {
+    "build": "rimraf dist && pnpm run db:update-client && tsc --project tsconfig.build.json",
+    "clean": "rimraf dist",
+    "lint": "biome check . && tsc",
+    "lint:fix": "biome check --write",
+    "db:migration:dev": "prisma migrate dev --config=./prisma/prisma.config",
+    "db:update-client": "prisma generate",
+    "test": "vitest run",
+    "test:migrate": "cross-env NODE_ENV=test prisma migrate reset --config=./prisma/prisma.config --force",
+    "pretest:ci": "docker compose up -d --wait && pnpm run test:migrate",
+    "test:ci": "pnpm run test",
+    "posttest:ci": "docker compose down",
+    "package-version": "echo $npm_package_version",
+    "postversion": "biome check --write package.json"
+  }
+}