@lokalise/prisma-utils 1.2.0 → 1.4.0

package/dist/errors/cockroachdbError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cockroachdbError.js","sources":["../../src/errors/cockroachdbError.ts"],"sourcesContent":["import type { PrismaClientKnownRequestError } from '@prisma/client/runtime/library'\n\n/**\n * https://www.cockroachlabs.com/docs/stable/transaction-retry-error-reference#:~:text=To%20indicate%20that%20a%20transaction,the%20string%20%22restart%20transaction%22%20.\n *\n * All transaction retry errors use the SQLSTATE error code 40001\n */\nconst COCKROACHDB_RETRY_TRANSACTION_CODE = '40001'\n\n/**\n * Check if the error is a CockroachDB transaction retry error\n *\n * @param error\n */\nexport const isCockroachDBRetryTransaction = (error: PrismaClientKnownRequestError): boolean => {\n  const meta = error.meta\n  if (!meta) return false\n\n  return meta.code === COCKROACHDB_RETRY_TRANSACTION_CODE\n}\n"],"names":["COCKROACHDB_RETRY_TRANSACTION_CODE","isCockroachDBRetryTransaction","error","meta"],"mappings":"AAOA,MAAMA,IAAqC,SAO9BC,IAAgC,CAACC,MAAkD;AAC9F,QAAMC,IAAOD,EAAM;AACf,SAACC,IAEEA,EAAK,SAASH,IAFH;AAGpB;"}

package/dist/errors/index.d.ts

@@ -0,0 +1 @@
+export * from './prismaError';

package/dist/{prismaError.d.ts → errors/prismaError.d.ts}

@@ -8,6 +8,8 @@ import { PrismaClientKnownRequestError } from '@prisma/client/runtime/library';
  * 	4. code starts by `P` ([doc](https://www.prisma.io/docs/reference/api-reference/error-reference#error-codes))
  */
 export declare const isPrismaClientKnownRequestError: (error: unknown) => error is PrismaClientKnownRequestError;
+export declare const isPrismaTransactionClosedError: (error: PrismaClientKnownRequestError) => boolean;
 export declare const PRISMA_NOT_FOUND_ERROR = "P2025";
 export declare const PRISMA_SERIALIZATION_ERROR = "P2034";
 export declare const PRISMA_UNIQUE_CONSTRAINT_ERROR = "P2002";
+export declare const PRISMA_TRANSACTION_ERROR = "P2028";

package/dist/errors/prismaError.js

@@ -0,0 +1,11 @@
+import { isError as R } from "@lokalise/node-core";
+const n = (s) => !!s && R(s) && "code" in s && typeof s.code == "string" && s.code.startsWith("P"), c = (s) => s.code === o && s.message.includes("Transaction already closed"), i = "P2025", P = "P2034", a = "P2002", o = "P2028";
+export {
+  i as PRISMA_NOT_FOUND_ERROR,
+  P as PRISMA_SERIALIZATION_ERROR,
+  o as PRISMA_TRANSACTION_ERROR,
+  a as PRISMA_UNIQUE_CONSTRAINT_ERROR,
+  n as isPrismaClientKnownRequestError,
+  c as isPrismaTransactionClosedError
+};
+//# sourceMappingURL=prismaError.js.map

package/dist/errors/prismaError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prismaError.js","sources":["../../src/errors/prismaError.ts"],"sourcesContent":["import { isError } from '@lokalise/node-core'\nimport type { PrismaClientKnownRequestError } from '@prisma/client/runtime/library'\n\n/**\n * What is checked?\n * \t1. error is defined and not null\n * \t2. error is an `Error`\n * \t3. error contains the field code which is a string\n * \t4. code starts by `P` ([doc](https://www.prisma.io/docs/reference/api-reference/error-reference#error-codes))\n */\nexport const isPrismaClientKnownRequestError = (\n  error: unknown,\n): error is PrismaClientKnownRequestError =>\n  !!error &&\n  isError(error) &&\n  'code' in error &&\n  typeof error.code === 'string' &&\n  error.code.startsWith('P')\n\nexport const isPrismaTransactionClosedError = (error: PrismaClientKnownRequestError): boolean =>\n  error.code === PRISMA_TRANSACTION_ERROR && error.message.includes('Transaction already closed')\n\n/*\n * Prisma error code P2025 indicates that the operation failed because it depends on one or more\n * records that were required but not found\n */\nexport const PRISMA_NOT_FOUND_ERROR = 'P2025'\n\n/*\n * Prisma error code P2034 indicates a serialization error and that the transaction must be retried.\n * A different error code would indicate that an internal state error happened and that\n * the cluster itself is experiencing an issue which requires intervention\n */\nexport const PRISMA_SERIALIZATION_ERROR = 'P2034'\n\n/*\n * Prisma error code P2002 indicates that the operation failed because a unique constraint was\n * violated. This can happen if you try to create a record with a unique field that already exists\n */\nexport const PRISMA_UNIQUE_CONSTRAINT_ERROR = 'P2002'\n\n/*\n * Prisma error code P2028 indicates a transaction API error, essentially a placeholder for errors that do not fit into\n * a more specific category. You should look into the error message for more details\n */\nexport const PRISMA_TRANSACTION_ERROR = 'P2028'\n"],"names":["isPrismaClientKnownRequestError","error","isError","isPrismaTransactionClosedError","PRISMA_TRANSACTION_ERROR","PRISMA_NOT_FOUND_ERROR","PRISMA_SERIALIZATION_ERROR","PRISMA_UNIQUE_CONSTRAINT_ERROR"],"mappings":";AAUO,MAAMA,IAAkC,CAC7CC,MAEA,CAAC,CAACA,KACFC,EAAQD,CAAK,KACb,UAAUA,KACV,OAAOA,EAAM,QAAS,YACtBA,EAAM,KAAK,WAAW,GAAG,GAEdE,IAAiC,CAACF,MAC7CA,EAAM,SAASG,KAA4BH,EAAM,QAAQ,SAAS,4BAA4B,GAMnFI,IAAyB,SAOzBC,IAA6B,SAM7BC,IAAiC,SAMjCH,IAA2B;"}

package/dist/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("@lokalise/node-core"),R=require("node:timers/promises"),a=e=>!!e&&i.isError(e)&&"code"in e&&typeof e.code=="string"&&e.code.startsWith("P"),l="P2025",c="P2034",u="P2002",D={COCKROACHDB:"CockroachDb"},O="40001",y=e=>{const r=e.meta;return r?r.code===O:!1},A={retriesAllowed:3,DbDriver:"CockroachDb",baseRetryDelayMs:100,maxRetryDelayMs:3e4},T=async(e,r,t)=>{const o={...A,...t};let s,n=0;for(;n<o.retriesAllowed&&(n>0&&await R.setTimeout(E(n,o.baseRetryDelayMs,o.maxRetryDelayMs)),s=await _(e,r,t),!(s.result||!I(s,o.DbDriver)));)n++;return s??{error:new Error("No transaction retry executed")}},_=async(e,r,t)=>{try{return{result:await e.$transaction(r,t)}}catch(o){return{error:o}}},E=(e,r,t)=>{const o=Math.pow(2,e-1)*r;return Math.min(o,t)},I=(e,r)=>{if(a(e.error)){const t=e.error;if(t.code===c||r==="CockroachDb"&&y(t))return!0}return!1};exports.DbDriverEnum=D;exports.PRISMA_NOT_FOUND_ERROR=l;exports.PRISMA_SERIALIZATION_ERROR=c;exports.PRISMA_UNIQUE_CONSTRAINT_ERROR=u;exports.isPrismaClientKnownRequestError=a;exports.prismaTransaction=T;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("@lokalise/node-core"),T=require("node:timers/promises"),c=e=>!!e&&i.isError(e)&&"code"in e&&typeof e.code=="string"&&e.code.startsWith("P"),R=e=>e.code===u&&e.message.includes("Transaction already closed"),A="P2025",l="P2034",m="P2002",u="P2028",O="40001",_=e=>{const r=e.meta;return r?r.code===O:!1},d={retriesAllowed:2,DbDriver:"CockroachDb",baseRetryDelayMs:100,maxRetryDelayMs:3e4,timeout:5e3,maxTimeout:3e4},y=async(e,r,o)=>{let t={...d,...o},s,a=0;do{if(a>0&&await T.setTimeout(E(a,t.baseRetryDelayMs,t.maxRetryDelayMs)),s=await I(e,r,t),s.result)break;const n=N(s,t.DbDriver);if(!n)break;n==="increase-timeout"&&(t=i.deepClone(t),t.timeout=Math.min(t.timeout*2,t.maxTimeout)),a++}while(a<=t.retriesAllowed);return s??{error:new Error("No transaction executed")}},I=async(e,r,o)=>{try{return{result:await e.$transaction(r,o)}}catch(t){return{error:t}}},E=(e,r,o)=>{const t=Math.pow(2,e-1)*r;return Math.min(t,o)},N=(e,r)=>{if(c(e.error)){const o=e.error;if(o.code===l||r==="CockroachDb"&&_(o))return!0;if(R(o))return"increase-timeout"}return!1};exports.PRISMA_NOT_FOUND_ERROR=A;exports.PRISMA_SERIALIZATION_ERROR=l;exports.PRISMA_TRANSACTION_ERROR=u;exports.PRISMA_UNIQUE_CONSTRAINT_ERROR=m;exports.isPrismaClientKnownRequestError=c;exports.isPrismaTransactionClosedError=R;exports.prismaTransaction=y;
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../src/prismaError.ts","../src/types.ts","../src/cockroachdbError.ts","../src/prismaTransaction.ts"],"sourcesContent":["import { isError } from '@lokalise/node-core'\nimport type { PrismaClientKnownRequestError } from '@prisma/client/runtime/library'\n\n/**\n * What is checked?\n * \t1. error is defined and not null\n * \t2. error is an `Error`\n * \t3. error contains the field code which is a string\n * \t4. code starts by `P` ([doc](https://www.prisma.io/docs/reference/api-reference/error-reference#error-codes))\n */\nexport const isPrismaClientKnownRequestError = (\n\terror: unknown,\n): error is PrismaClientKnownRequestError =>\n\t!!error &&\n\tisError(error) &&\n\t'code' in error &&\n\ttypeof error.code === 'string' &&\n\terror.code.startsWith('P')\n\n/*\n * Prisma error code P2025 indicates that the operation failed because it depends on one or more\n * records that were required but not found\n */\nexport const PRISMA_NOT_FOUND_ERROR = 'P2025'\n\n/*\n * Prisma error code P2034 indicates a serialization error and that the transaction must be retried.\n * A different error code would indicate that an internal state error happened and that\n * the cluster itself is experiencing an issue which requires intervention\n */\nexport const PRISMA_SERIALIZATION_ERROR = 'P2034'\n\n/*\n * Prisma error code P2002 indicates that the operation failed because a unique constraint was\n * violated. This can happen if you try to create a record with a unique field that already exists\n */\nexport const PRISMA_UNIQUE_CONSTRAINT_ERROR = 'P2002'\n","import type * as runtime from '@prisma/client/runtime/library'\n\ntype ObjectValues<T> = T[keyof T]\n\nexport const DbDriverEnum = {\n\tCOCKROACHDB: 'CockroachDb',\n} as const\nexport type DbDriver = ObjectValues<typeof DbDriverEnum>\n\nexport type PrismaTransactionOptions = {\n\t// Prisma utils library custom options\n\tDbDriver?: DbDriver\n\tretriesAllowed?: number\n\tbaseRetryDelayMs?: number\n\tmaxRetryDelayMs?: number\n\n\t// Prisma $transaction options\n\tmaxWait?: number\n\ttimeout?: number\n\tisolationLevel?: string\n}\n\n// Prisma $transaction with array does not support maxWait and timeout options\nexport type PrismaTransactionBasicOptions = Omit<PrismaTransactionOptions, 'maxWait' | 'timeout'>\n\nexport type PrismaTransactionClient<P> = Omit<P, runtime.ITXClientDenyList>\n\nexport type PrismaTransactionFn<T, P> = (prisma: PrismaTransactionClient<P>) => Promise<T>\n","import type { PrismaClientKnownRequestError } from '@prisma/client/runtime/library'\n\n/**\n * https://www.cockroachlabs.com/docs/stable/transaction-retry-error-reference#:~:text=To%20indicate%20that%20a%20transaction,the%20string%20%22restart%20transaction%22%20.\n *\n * All transaction retry errors use the SQLSTATE error code 40001\n */\nconst COCKROACHDB_RETRY_TRANSACTION_CODE = '40001'\n\n/**\n * Check if the error is a CockroachDB transaction retry error\n *\n * @param error\n */\nexport const isCockroachDBRetryTransaction = (error: PrismaClientKnownRequestError): boolean => {\n\tconst meta = error.meta\n\tif (!meta) return false\n\n\treturn meta.code === COCKROACHDB_RETRY_TRANSACTION_CODE\n}\n","import { setTimeout } from 'node:timers/promises'\n\nimport type { Either } from '@lokalise/node-core'\nimport type { PrismaClient, Prisma } from '@prisma/client'\nimport type * as runtime from '@prisma/client/runtime/library'\n\nimport { isCockroachDBRetryTransaction } from './cockroachdbError'\nimport { isPrismaClientKnownRequestError, PRISMA_SERIALIZATION_ERROR } from './prismaError'\nimport type {\n\tDbDriver,\n\tPrismaTransactionBasicOptions,\n\tPrismaTransactionFn,\n\tPrismaTransactionOptions,\n} from './types'\n\ntype PrismaTransactionReturnType<T> = Either<\n\tunknown,\n\tT | runtime.Types.Utils.UnwrapTuple<Prisma.PrismaPromise<unknown>[]>\n>\n\nconst DEFAULT_OPTIONS = {\n\tretriesAllowed: 3,\n\tDbDriver: 'CockroachDb',\n\tbaseRetryDelayMs: 100,\n\tmaxRetryDelayMs: 30000, // 30s\n} satisfies Pick<\n\tPrismaTransactionOptions,\n\t'retriesAllowed' | 'DbDriver' | 'baseRetryDelayMs' | 'maxRetryDelayMs'\n>\n\n/**\n * Perform a Prisma DB transaction with automatic retries if needed.\n *\n * @template T | T extends Prisma.PrismaPromise<unknown>[]\n * @param {PrismaClient} prisma\n * @param {PrismaTransactionFn<T> | Prisma.PrismaPromise<unknown>[]} arg\t operation to perform into the transaction\n * @param {PrismaTransactionOptions | PrismaTransactionBasicOptions} options transaction configuration\n * @return {Promise<PrismaTransactionReturnType<T>>}\n */\nexport const prismaTransaction = (async <T, P extends PrismaClient>(\n\tprisma: P,\n\targ: PrismaTransactionFn<T, P> | Prisma.PrismaPromise<unknown>[],\n\toptions?: PrismaTransactionOptions | PrismaTransactionBasicOptions,\n): Promise<PrismaTransactionReturnType<T>> => {\n\tconst optionsWithDefaults = { ...DEFAULT_OPTIONS, ...options }\n\tlet result: PrismaTransactionReturnType<T> | undefined = undefined\n\n\tlet retries = 0\n\twhile (retries < optionsWithDefaults.retriesAllowed) {\n\t\tif (retries > 0) {\n\t\t\tawait setTimeout(\n\t\t\t\tcalculateRetryDelay(\n\t\t\t\t\tretries,\n\t\t\t\t\toptionsWithDefaults.baseRetryDelayMs,\n\t\t\t\t\toptionsWithDefaults.maxRetryDelayMs,\n\t\t\t\t),\n\t\t\t)\n\t\t}\n\n\t\tresult = await executeTransactionTry(prisma, arg, options)\n\t\tif (result.result || !isRetryAllowed(result, optionsWithDefaults.DbDriver)) {\n\t\t\tbreak\n\t\t}\n\n\t\tretries++\n\t}\n\n\treturn result ?? { error: new Error('No transaction retry executed') }\n}) as {\n\t<T, P extends PrismaClient>(\n\t\tprisma: P,\n\t\tfn: PrismaTransactionFn<T, P>,\n\t\toptions?: PrismaTransactionOptions,\n\t): Promise<Either<unknown, T>>\n\t<T extends Prisma.PrismaPromise<unknown>[], P extends PrismaClient>(\n\t\tprisma: P,\n\t\targs: [...T],\n\t\toptions?: PrismaTransactionBasicOptions,\n\t): Promise<Either<unknown, runtime.Types.Utils.UnwrapTuple<T>>>\n}\n\nconst executeTransactionTry = async <T, P extends PrismaClient>(\n\tprisma: P,\n\targ: PrismaTransactionFn<T, P> | Prisma.PrismaPromise<unknown>[],\n\toptions?: PrismaTransactionOptions,\n): Promise<PrismaTransactionReturnType<T>> => {\n\ttry {\n\t\treturn {\n\t\t\t// @ts-ignore\n\t\t\tresult: await prisma.$transaction<T>(arg, options),\n\t\t}\n\t} catch (error) {\n\t\treturn { error }\n\t}\n}\n\nconst calculateRetryDelay = (\n\tretries: number,\n\tbaseRetryDelayMs: number,\n\tmaxDelayMs: number,\n): number => {\n\t// exponential backoff -> 2^(retry-1) * baseRetryDelayMs\n\tconst expDelay = Math.pow(2, retries - 1) * baseRetryDelayMs\n\treturn Math.min(expDelay, maxDelayMs)\n}\n\nconst isRetryAllowed = <T>(result: PrismaTransactionReturnType<T>, dbDriver: DbDriver): boolean => {\n\tif (isPrismaClientKnownRequestError(result.error)) {\n\t\tconst error = result.error\n\t\tif (error.code === PRISMA_SERIALIZATION_ERROR) return true\n\t\tif (dbDriver === 'CockroachDb' && isCockroachDBRetryTransaction(error)) return true\n\t}\n\n\treturn false\n}\n"],"names":["isPrismaClientKnownRequestError","error","isError","PRISMA_NOT_FOUND_ERROR","PRISMA_SERIALIZATION_ERROR","PRISMA_UNIQUE_CONSTRAINT_ERROR","DbDriverEnum","COCKROACHDB_RETRY_TRANSACTION_CODE","isCockroachDBRetryTransaction","meta","DEFAULT_OPTIONS","prismaTransaction","prisma","arg","options","optionsWithDefaults","result","retries","setTimeout","calculateRetryDelay","executeTransactionTry","isRetryAllowed","baseRetryDelayMs","maxDelayMs","expDelay","dbDriver"],"mappings":"yJAUaA,EACZC,GAEA,CAAC,CAACA,GACFC,UAAQD,CAAK,GACb,SAAUA,GACV,OAAOA,EAAM,MAAS,UACtBA,EAAM,KAAK,WAAW,GAAG,EAMbE,EAAyB,QAOzBC,EAA6B,QAM7BC,EAAiC,QChCjCC,EAAe,CAC3B,YAAa,aACd,ECCMC,EAAqC,QAO9BC,EAAiCP,GAAkD,CAC/F,MAAMQ,EAAOR,EAAM,KACnB,OAAKQ,EAEEA,EAAK,OAASF,EAFH,EAGnB,ECCMG,EAAkB,CACvB,eAAgB,EAChB,SAAU,cACV,iBAAkB,IAClB,gBAAiB,GAClB,EAcaC,EAAqB,MACjCC,EACAC,EACAC,IAC6C,CAC7C,MAAMC,EAAsB,CAAE,GAAGL,EAAiB,GAAGI,CAAQ,EAC7D,IAAIE,EAEAC,EAAU,EACP,KAAAA,EAAUF,EAAoB,iBAChCE,EAAU,GACP,MAAAC,EAAA,WACLC,EACCF,EACAF,EAAoB,iBACpBA,EAAoB,eACrB,CAAA,EAIFC,EAAS,MAAMI,EAAsBR,EAAQC,EAAKC,CAAO,EACrD,EAAAE,EAAO,QAAU,CAACK,EAAeL,EAAQD,EAAoB,QAAQ,KAIzEE,IAGD,OAAOD,GAAU,CAAE,MAAO,IAAI,MAAM,+BAA+B,CAAE,CACtE,EAaMI,EAAwB,MAC7BR,EACAC,EACAC,IAC6C,CACzC,GAAA,CACI,MAAA,CAEN,OAAQ,MAAMF,EAAO,aAAgBC,EAAKC,CAAO,CAAA,QAE1Cb,EAAO,CACf,MAAO,CAAE,MAAAA,CAAM,CAChB,CACD,EAEMkB,EAAsB,CAC3BF,EACAK,EACAC,IACY,CAEZ,MAAMC,EAAW,KAAK,IAAI,EAAGP,EAAU,CAAC,EAAIK,EACrC,OAAA,KAAK,IAAIE,EAAUD,CAAU,CACrC,EAEMF,EAAiB,CAAIL,EAAwCS,IAAgC,CAC9F,GAAAzB,EAAgCgB,EAAO,KAAK,EAAG,CAClD,MAAMf,EAAQe,EAAO,MAEjB,GADAf,EAAM,OAASG,GACfqB,IAAa,eAAiBjB,EAA8BP,CAAK,EAAU,MAAA,EAChF,CAEO,MAAA,EACR"}
+{"version":3,"file":"index.cjs","sources":["../src/errors/prismaError.ts","../src/errors/cockroachdbError.ts","../src/prismaTransaction.ts"],"sourcesContent":["import { isError } from '@lokalise/node-core'\nimport type { PrismaClientKnownRequestError } from '@prisma/client/runtime/library'\n\n/**\n * What is checked?\n * \t1. error is defined and not null\n * \t2. error is an `Error`\n * \t3. error contains the field code which is a string\n * \t4. code starts by `P` ([doc](https://www.prisma.io/docs/reference/api-reference/error-reference#error-codes))\n */\nexport const isPrismaClientKnownRequestError = (\n  error: unknown,\n): error is PrismaClientKnownRequestError =>\n  !!error &&\n  isError(error) &&\n  'code' in error &&\n  typeof error.code === 'string' &&\n  error.code.startsWith('P')\n\nexport const isPrismaTransactionClosedError = (error: PrismaClientKnownRequestError): boolean =>\n  error.code === PRISMA_TRANSACTION_ERROR && error.message.includes('Transaction already closed')\n\n/*\n * Prisma error code P2025 indicates that the operation failed because it depends on one or more\n * records that were required but not found\n */\nexport const PRISMA_NOT_FOUND_ERROR = 'P2025'\n\n/*\n * Prisma error code P2034 indicates a serialization error and that the transaction must be retried.\n * A different error code would indicate that an internal state error happened and that\n * the cluster itself is experiencing an issue which requires intervention\n */\nexport const PRISMA_SERIALIZATION_ERROR = 'P2034'\n\n/*\n * Prisma error code P2002 indicates that the operation failed because a unique constraint was\n * violated. This can happen if you try to create a record with a unique field that already exists\n */\nexport const PRISMA_UNIQUE_CONSTRAINT_ERROR = 'P2002'\n\n/*\n * Prisma error code P2028 indicates a transaction API error, essentially a placeholder for errors that do not fit into\n * a more specific category. You should look into the error message for more details\n */\nexport const PRISMA_TRANSACTION_ERROR = 'P2028'\n","import type { PrismaClientKnownRequestError } from '@prisma/client/runtime/library'\n\n/**\n * https://www.cockroachlabs.com/docs/stable/transaction-retry-error-reference#:~:text=To%20indicate%20that%20a%20transaction,the%20string%20%22restart%20transaction%22%20.\n *\n * All transaction retry errors use the SQLSTATE error code 40001\n */\nconst COCKROACHDB_RETRY_TRANSACTION_CODE = '40001'\n\n/**\n * Check if the error is a CockroachDB transaction retry error\n *\n * @param error\n */\nexport const isCockroachDBRetryTransaction = (error: PrismaClientKnownRequestError): boolean => {\n  const meta = error.meta\n  if (!meta) return false\n\n  return meta.code === COCKROACHDB_RETRY_TRANSACTION_CODE\n}\n","import { setTimeout } from 'node:timers/promises'\n\nimport type { Either } from '@lokalise/node-core'\nimport { deepClone } from '@lokalise/node-core'\nimport type { Prisma, PrismaClient } from '@prisma/client'\nimport type * as runtime from '@prisma/client/runtime/library'\n\nimport { isCockroachDBRetryTransaction } from './errors/cockroachdbError'\nimport {\n  PRISMA_SERIALIZATION_ERROR,\n  isPrismaClientKnownRequestError,\n  isPrismaTransactionClosedError,\n} from './errors/prismaError'\nimport type {\n  DbDriver,\n  PrismaTransactionBasicOptions,\n  PrismaTransactionFn,\n  PrismaTransactionOptions,\n  PrismaTransactionReturnType,\n} from './types'\n\nconst DEFAULT_OPTIONS = {\n  retriesAllowed: 2, // first try + 2 retries = 3 tries\n  DbDriver: 'CockroachDb',\n  baseRetryDelayMs: 100,\n  maxRetryDelayMs: 30000, // 30s\n  timeout: 5000, // 5s\n  maxTimeout: 30000, // 30s\n} satisfies Partial<PrismaTransactionOptions>\n\n/**\n * Perform a Prisma DB transaction with automatic retries if needed.\n *\n * @template T | T extends Prisma.PrismaPromise<unknown>[]\n * @param {PrismaClient} prisma\n * @param {PrismaTransactionFn<T> | Prisma.PrismaPromise<unknown>[]} arg\t operation to perform into the transaction\n * @param {PrismaTransactionOptions | PrismaTransactionBasicOptions} options transaction configuration\n * @return {Promise<PrismaTransactionReturnType<T>>}\n */\nexport const prismaTransaction = (async <T, P extends PrismaClient>(\n  prisma: P,\n  arg: PrismaTransactionFn<T, P> | Prisma.PrismaPromise<unknown>[],\n  options?: PrismaTransactionOptions | PrismaTransactionBasicOptions,\n): Promise<PrismaTransactionReturnType<T>> => {\n  let optionsWithDefaults = { ...DEFAULT_OPTIONS, ...options }\n  let result: PrismaTransactionReturnType<T> | undefined = undefined\n\n  let retries = 0\n  do {\n    if (retries > 0) {\n      await setTimeout(\n        calculateRetryDelay(\n          retries,\n          optionsWithDefaults.baseRetryDelayMs,\n          optionsWithDefaults.maxRetryDelayMs,\n        ),\n      )\n    }\n\n    result = await executeTransactionTry(prisma, arg, optionsWithDefaults)\n    if (result.result) break\n\n    const retryAllowed = isRetryAllowed(result, optionsWithDefaults.DbDriver)\n    if (!retryAllowed) break\n\n    if (retryAllowed === 'increase-timeout') {\n      optionsWithDefaults = deepClone(optionsWithDefaults)\n      optionsWithDefaults.timeout = Math.min(\n        optionsWithDefaults.timeout * 2,\n        optionsWithDefaults.maxTimeout,\n      )\n    }\n\n    retries++\n  } while (retries <= optionsWithDefaults.retriesAllowed)\n\n  return result ?? { error: new Error('No transaction executed') }\n}) as {\n  <T, P extends PrismaClient>(\n    prisma: P,\n    fn: PrismaTransactionFn<T, P>,\n    options?: PrismaTransactionOptions,\n  ): Promise<Either<unknown, T>>\n  <T extends Prisma.PrismaPromise<unknown>[], P extends PrismaClient>(\n    prisma: P,\n    args: [...T],\n    options?: PrismaTransactionBasicOptions,\n  ): Promise<Either<unknown, runtime.Types.Utils.UnwrapTuple<T>>>\n}\n\nconst executeTransactionTry = async <T, P extends PrismaClient>(\n  prisma: P,\n  arg: PrismaTransactionFn<T, P> | Prisma.PrismaPromise<unknown>[],\n  options?: PrismaTransactionOptions,\n): Promise<PrismaTransactionReturnType<T>> => {\n  try {\n    return {\n      // @ts-ignore\n      result: await prisma.$transaction<T>(arg, options),\n    }\n  } catch (error) {\n    return { error }\n  }\n}\n\nconst calculateRetryDelay = (\n  retries: number,\n  baseRetryDelayMs: number,\n  maxDelayMs: number,\n): number => {\n  // exponential backoff -> 2^(retry-1) * baseRetryDelayMs\n  const expDelay = Math.pow(2, retries - 1) * baseRetryDelayMs\n  return Math.min(expDelay, maxDelayMs)\n}\n\ntype isRetryAllowedResult = boolean | 'increase-timeout'\n\nconst isRetryAllowed = <T>(\n  result: PrismaTransactionReturnType<T>,\n  dbDriver: DbDriver,\n): isRetryAllowedResult => {\n  if (isPrismaClientKnownRequestError(result.error)) {\n    const error = result.error\n    if (error.code === PRISMA_SERIALIZATION_ERROR) return true\n    if (dbDriver === 'CockroachDb' && isCockroachDBRetryTransaction(error)) return true\n    if (isPrismaTransactionClosedError(error)) return 'increase-timeout'\n  }\n\n  return false\n}\n"],"names":["isPrismaClientKnownRequestError","error","isError","isPrismaTransactionClosedError","PRISMA_TRANSACTION_ERROR","PRISMA_NOT_FOUND_ERROR","PRISMA_SERIALIZATION_ERROR","PRISMA_UNIQUE_CONSTRAINT_ERROR","COCKROACHDB_RETRY_TRANSACTION_CODE","isCockroachDBRetryTransaction","meta","DEFAULT_OPTIONS","prismaTransaction","prisma","arg","options","optionsWithDefaults","result","retries","setTimeout","calculateRetryDelay","executeTransactionTry","retryAllowed","isRetryAllowed","deepClone","baseRetryDelayMs","maxDelayMs","expDelay","dbDriver"],"mappings":"yJAUaA,EACXC,GAEA,CAAC,CAACA,GACFC,UAAQD,CAAK,GACb,SAAUA,GACV,OAAOA,EAAM,MAAS,UACtBA,EAAM,KAAK,WAAW,GAAG,EAEdE,EAAkCF,GAC7CA,EAAM,OAASG,GAA4BH,EAAM,QAAQ,SAAS,4BAA4B,EAMnFI,EAAyB,QAOzBC,EAA6B,QAM7BC,EAAiC,QAMjCH,EAA2B,QCtClCI,EAAqC,QAO9BC,EAAiCR,GAAkD,CAC9F,MAAMS,EAAOT,EAAM,KACf,OAACS,EAEEA,EAAK,OAASF,EAFH,EAGpB,ECEMG,EAAkB,CACtB,eAAgB,EAChB,SAAU,cACV,iBAAkB,IAClB,gBAAiB,IACjB,QAAS,IACT,WAAY,GACd,EAWaC,EAAqB,MAChCC,EACAC,EACAC,IAC4C,CAC5C,IAAIC,EAAsB,CAAE,GAAGL,EAAiB,GAAGI,CAAQ,EACvDE,EAEAC,EAAU,EACX,EAAA,CAYD,GAXIA,EAAU,GACN,MAAAC,EAAA,WACJC,EACEF,EACAF,EAAoB,iBACpBA,EAAoB,eACtB,CAAA,EAIJC,EAAS,MAAMI,EAAsBR,EAAQC,EAAKE,CAAmB,EACjEC,EAAO,OAAQ,MAEnB,MAAMK,EAAeC,EAAeN,EAAQD,EAAoB,QAAQ,EACxE,GAAI,CAACM,EAAc,MAEfA,IAAiB,qBACnBN,EAAsBQ,EAAAA,UAAUR,CAAmB,EACnDA,EAAoB,QAAU,KAAK,IACjCA,EAAoB,QAAU,EAC9BA,EAAoB,UAAA,GAIxBE,GAAA,OACOA,GAAWF,EAAoB,gBAExC,OAAOC,GAAU,CAAE,MAAO,IAAI,MAAM,yBAAyB,CAAE,CACjE,EAaMI,EAAwB,MAC5BR,EACAC,EACAC,IAC4C,CACxC,GAAA,CACK,MAAA,CAEL,OAAQ,MAAMF,EAAO,aAAgBC,EAAKC,CAAO,CAAA,QAE5Cd,EAAO,CACd,MAAO,CAAE,MAAAA,CAAM,CACjB,CACF,EAEMmB,EAAsB,CAC1BF,EACAO,EACAC,IACW,CAEX,MAAMC,EAAW,KAAK,IAAI,EAAGT,EAAU,CAAC,EAAIO,EACrC,OAAA,KAAK,IAAIE,EAAUD,CAAU,CACtC,EAIMH,EAAiB,CACrBN,EACAW,IACyB,CACrB,GAAA5B,EAAgCiB,EAAO,KAAK,EAAG,CACjD,MAAMhB,EAAQgB,EAAO,MAErB,GADIhB,EAAM,OAASK,GACfsB,IAAa,eAAiBnB,EAA8BR,CAAK,EAAU,MAAA,GAC3E,GAAAE,EAA+BF,CAAK,EAAU,MAAA,kBACpD,CAEO,MAAA,EACT"}

package/dist/index.d.ts

@@ -1,3 +1,3 @@
-export * from './prismaError';
-export * from './types';
+export type * from './types';
+export * from './errors';
 export { prismaTransaction } from './prismaTransaction';

package/dist/index.js

@@ -1,12 +1,12 @@
-import { PRISMA_NOT_FOUND_ERROR as o, PRISMA_SERIALIZATION_ERROR as I, PRISMA_UNIQUE_CONSTRAINT_ERROR as _, isPrismaClientKnownRequestError as e } from "./prismaError.js";
-import { DbDriverEnum as O } from "./types.js";
-import { prismaTransaction as m } from "./prismaTransaction.js";
+import { PRISMA_NOT_FOUND_ERROR as o, PRISMA_SERIALIZATION_ERROR as I, PRISMA_TRANSACTION_ERROR as _, PRISMA_UNIQUE_CONSTRAINT_ERROR as s, isPrismaClientKnownRequestError as A, isPrismaTransactionClosedError as O } from "./errors/prismaError.js";
+import { prismaTransaction as E } from "./prismaTransaction.js";
 export {
-  O as DbDriverEnum,
   o as PRISMA_NOT_FOUND_ERROR,
   I as PRISMA_SERIALIZATION_ERROR,
-  _ as PRISMA_UNIQUE_CONSTRAINT_ERROR,
-  e as isPrismaClientKnownRequestError,
-  m as prismaTransaction
+  _ as PRISMA_TRANSACTION_ERROR,
+  s as PRISMA_UNIQUE_CONSTRAINT_ERROR,
+  A as isPrismaClientKnownRequestError,
+  O as isPrismaTransactionClosedError,
+  E as prismaTransaction
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/isolation_level/isolationLevel.d.ts

@@ -0,0 +1,3 @@
+type IsolationLevel = 'Serializable' | 'ReadCommitted' | 'ReadUncommitted' | 'RepeatableRead' | 'Snapshot';
+export type CockroachDbIsolationLevel = Extract<IsolationLevel, 'ReadCommitted' | 'Serializable'>;
+export {};

package/dist/prismaTransaction.d.ts

@@ -1,5 +1,5 @@
 import { Either } from '@lokalise/node-core';
-import { PrismaClient, Prisma } from '@prisma/client';
+import { Prisma, PrismaClient } from '@prisma/client';
 import { PrismaTransactionBasicOptions, PrismaTransactionFn, PrismaTransactionOptions } from './types';
 
 import type * as runtime from '@prisma/client/runtime/library';
@@ -13,6 +13,6 @@ import type * as runtime from '@prisma/client/runtime/library';
  * @return {Promise<PrismaTransactionReturnType<T>>}
  */
 export declare const prismaTransaction: {
-    <T, P extends PrismaClient<Prisma.PrismaClientOptions, never, runtime.DefaultArgs>>(prisma: P, fn: PrismaTransactionFn<T, P>, options?: PrismaTransactionOptions): Promise<Either<unknown, T>>;
-    <T_1 extends Prisma.PrismaPromise<unknown>[], P_1 extends PrismaClient<Prisma.PrismaClientOptions, never, runtime.DefaultArgs>>(prisma: P_1, args: [...T_1], options?: PrismaTransactionBasicOptions): Promise<Either<unknown, runtime.UnwrapTuple<T_1>>>;
+    <T, P extends PrismaClient>(prisma: P, fn: PrismaTransactionFn<T, P>, options?: PrismaTransactionOptions): Promise<Either<unknown, T>>;
+    <T extends Prisma.PrismaPromise<unknown>[], P extends PrismaClient>(prisma: P, args: [...T], options?: PrismaTransactionBasicOptions): Promise<Either<unknown, runtime.Types.Utils.UnwrapTuple<T>>>;
 };

package/dist/prismaTransaction.js

@@ -1,45 +1,57 @@
-import { setTimeout as i } from "node:timers/promises";
-import { isCockroachDBRetryTransaction as n } from "./cockroachdbError.js";
-import { isPrismaClientKnownRequestError as c, PRISMA_SERIALIZATION_ERROR as l } from "./prismaError.js";
-const y = {
-  retriesAllowed: 3,
+import { setTimeout as n } from "node:timers/promises";
+import { deepClone as c } from "@lokalise/node-core";
+import { isCockroachDBRetryTransaction as l } from "./errors/cockroachdbError.js";
+import { isPrismaClientKnownRequestError as m, PRISMA_SERIALIZATION_ERROR as u, isPrismaTransactionClosedError as y } from "./errors/prismaError.js";
+const D = {
+  retriesAllowed: 2,
+  // first try + 2 retries = 3 tries
   DbDriver: "CockroachDb",
   baseRetryDelayMs: 100,
-  maxRetryDelayMs: 3e4
+  maxRetryDelayMs: 3e4,
   // 30s
-}, h = async (e, o, r) => {
-  const t = { ...y, ...r };
-  let a, s = 0;
-  for (; s < t.retriesAllowed && (s > 0 && await i(
-    D(
-      s,
-      t.baseRetryDelayMs,
-      t.maxRetryDelayMs
-    )
-  ), a = await u(e, o, r), !(a.result || !R(a, t.DbDriver))); )
-    s++;
-  return a ?? { error: new Error("No transaction retry executed") };
-}, u = async (e, o, r) => {
+  timeout: 5e3,
+  // 5s
+  maxTimeout: 3e4
+  // 30s
+}, b = async (t, o, e) => {
+  let r = { ...D, ...e }, a, i = 0;
+  do {
+    if (i > 0 && await n(
+      R(
+        i,
+        r.baseRetryDelayMs,
+        r.maxRetryDelayMs
+      )
+    ), a = await f(t, o, r), a.result) break;
+    const s = w(a, r.DbDriver);
+    if (!s) break;
+    s === "increase-timeout" && (r = c(r), r.timeout = Math.min(
+      r.timeout * 2,
+      r.maxTimeout
+    )), i++;
+  } while (i <= r.retriesAllowed);
+  return a ?? { error: new Error("No transaction executed") };
+}, f = async (t, o, e) => {
   try {
     return {
       // @ts-ignore
-      result: await e.$transaction(o, r)
+      result: await t.$transaction(o, e)
     };
-  } catch (t) {
-    return { error: t };
+  } catch (r) {
+    return { error: r };
   }
-}, D = (e, o, r) => {
-  const t = Math.pow(2, e - 1) * o;
-  return Math.min(t, r);
-}, R = (e, o) => {
-  if (c(e.error)) {
-    const r = e.error;
-    if (r.code === l || o === "CockroachDb" && n(r))
-      return !0;
+}, R = (t, o, e) => {
+  const r = Math.pow(2, t - 1) * o;
+  return Math.min(r, e);
+}, w = (t, o) => {
+  if (m(t.error)) {
+    const e = t.error;
+    if (e.code === u || o === "CockroachDb" && l(e)) return !0;
+    if (y(e)) return "increase-timeout";
   }
   return !1;
 };
 export {
-  h as prismaTransaction
+  b as prismaTransaction
 };
 //# sourceMappingURL=prismaTransaction.js.map

package/dist/prismaTransaction.js.map

@@ -1 +1 @@
-{"version":3,"file":"prismaTransaction.js","sources":["../src/prismaTransaction.ts"],"sourcesContent":["import { setTimeout } from 'node:timers/promises'\n\nimport type { Either } from '@lokalise/node-core'\nimport type { PrismaClient, Prisma } from '@prisma/client'\nimport type * as runtime from '@prisma/client/runtime/library'\n\nimport { isCockroachDBRetryTransaction } from './cockroachdbError'\nimport { isPrismaClientKnownRequestError, PRISMA_SERIALIZATION_ERROR } from './prismaError'\nimport type {\n\tDbDriver,\n\tPrismaTransactionBasicOptions,\n\tPrismaTransactionFn,\n\tPrismaTransactionOptions,\n} from './types'\n\ntype PrismaTransactionReturnType<T> = Either<\n\tunknown,\n\tT | runtime.Types.Utils.UnwrapTuple<Prisma.PrismaPromise<unknown>[]>\n>\n\nconst DEFAULT_OPTIONS = {\n\tretriesAllowed: 3,\n\tDbDriver: 'CockroachDb',\n\tbaseRetryDelayMs: 100,\n\tmaxRetryDelayMs: 30000, // 30s\n} satisfies Pick<\n\tPrismaTransactionOptions,\n\t'retriesAllowed' | 'DbDriver' | 'baseRetryDelayMs' | 'maxRetryDelayMs'\n>\n\n/**\n * Perform a Prisma DB transaction with automatic retries if needed.\n *\n * @template T | T extends Prisma.PrismaPromise<unknown>[]\n * @param {PrismaClient} prisma\n * @param {PrismaTransactionFn<T> | Prisma.PrismaPromise<unknown>[]} arg\t operation to perform into the transaction\n * @param {PrismaTransactionOptions | PrismaTransactionBasicOptions} options transaction configuration\n * @return {Promise<PrismaTransactionReturnType<T>>}\n */\nexport const prismaTransaction = (async <T, P extends PrismaClient>(\n\tprisma: P,\n\targ: PrismaTransactionFn<T, P> | Prisma.PrismaPromise<unknown>[],\n\toptions?: PrismaTransactionOptions | PrismaTransactionBasicOptions,\n): Promise<PrismaTransactionReturnType<T>> => {\n\tconst optionsWithDefaults = { ...DEFAULT_OPTIONS, ...options }\n\tlet result: PrismaTransactionReturnType<T> | undefined = undefined\n\n\tlet retries = 0\n\twhile (retries < optionsWithDefaults.retriesAllowed) {\n\t\tif (retries > 0) {\n\t\t\tawait setTimeout(\n\t\t\t\tcalculateRetryDelay(\n\t\t\t\t\tretries,\n\t\t\t\t\toptionsWithDefaults.baseRetryDelayMs,\n\t\t\t\t\toptionsWithDefaults.maxRetryDelayMs,\n\t\t\t\t),\n\t\t\t)\n\t\t}\n\n\t\tresult = await executeTransactionTry(prisma, arg, options)\n\t\tif (result.result || !isRetryAllowed(result, optionsWithDefaults.DbDriver)) {\n\t\t\tbreak\n\t\t}\n\n\t\tretries++\n\t}\n\n\treturn result ?? { error: new Error('No transaction retry executed') }\n}) as {\n\t<T, P extends PrismaClient>(\n\t\tprisma: P,\n\t\tfn: PrismaTransactionFn<T, P>,\n\t\toptions?: PrismaTransactionOptions,\n\t): Promise<Either<unknown, T>>\n\t<T extends Prisma.PrismaPromise<unknown>[], P extends PrismaClient>(\n\t\tprisma: P,\n\t\targs: [...T],\n\t\toptions?: PrismaTransactionBasicOptions,\n\t): Promise<Either<unknown, runtime.Types.Utils.UnwrapTuple<T>>>\n}\n\nconst executeTransactionTry = async <T, P extends PrismaClient>(\n\tprisma: P,\n\targ: PrismaTransactionFn<T, P> | Prisma.PrismaPromise<unknown>[],\n\toptions?: PrismaTransactionOptions,\n): Promise<PrismaTransactionReturnType<T>> => {\n\ttry {\n\t\treturn {\n\t\t\t// @ts-ignore\n\t\t\tresult: await prisma.$transaction<T>(arg, options),\n\t\t}\n\t} catch (error) {\n\t\treturn { error }\n\t}\n}\n\nconst calculateRetryDelay = (\n\tretries: number,\n\tbaseRetryDelayMs: number,\n\tmaxDelayMs: number,\n): number => {\n\t// exponential backoff -> 2^(retry-1) * baseRetryDelayMs\n\tconst expDelay = Math.pow(2, retries - 1) * baseRetryDelayMs\n\treturn Math.min(expDelay, maxDelayMs)\n}\n\nconst isRetryAllowed = <T>(result: PrismaTransactionReturnType<T>, dbDriver: DbDriver): boolean => {\n\tif (isPrismaClientKnownRequestError(result.error)) {\n\t\tconst error = result.error\n\t\tif (error.code === PRISMA_SERIALIZATION_ERROR) return true\n\t\tif (dbDriver === 'CockroachDb' && isCockroachDBRetryTransaction(error)) return true\n\t}\n\n\treturn false\n}\n"],"names":["DEFAULT_OPTIONS","prismaTransaction","prisma","arg","options","optionsWithDefaults","result","retries","setTimeout","calculateRetryDelay","executeTransactionTry","isRetryAllowed","error","baseRetryDelayMs","maxDelayMs","expDelay","dbDriver","isPrismaClientKnownRequestError","PRISMA_SERIALIZATION_ERROR","isCockroachDBRetryTransaction"],"mappings":";;;AAoBA,MAAMA,IAAkB;AAAA,EACvB,gBAAgB;AAAA,EAChB,UAAU;AAAA,EACV,kBAAkB;AAAA,EAClB,iBAAiB;AAAA;AAClB,GAcaC,IAAqB,OACjCC,GACAC,GACAC,MAC6C;AAC7C,QAAMC,IAAsB,EAAE,GAAGL,GAAiB,GAAGI,EAAQ;AAC7D,MAAIE,GAEAC,IAAU;AACP,SAAAA,IAAUF,EAAoB,mBAChCE,IAAU,KACP,MAAAC;AAAA,IACLC;AAAA,MACCF;AAAA,MACAF,EAAoB;AAAA,MACpBA,EAAoB;AAAA,IACrB;AAAA,EAAA,GAIFC,IAAS,MAAMI,EAAsBR,GAAQC,GAAKC,CAAO,GACrD,EAAAE,EAAO,UAAU,CAACK,EAAeL,GAAQD,EAAoB,QAAQ;AAIzE,IAAAE;AAGD,SAAOD,KAAU,EAAE,OAAO,IAAI,MAAM,+BAA+B,EAAE;AACtE,GAaMI,IAAwB,OAC7BR,GACAC,GACAC,MAC6C;AACzC,MAAA;AACI,WAAA;AAAA;AAAA,MAEN,QAAQ,MAAMF,EAAO,aAAgBC,GAAKC,CAAO;AAAA,IAAA;AAAA,WAE1CQ,GAAO;AACf,WAAO,EAAE,OAAAA,EAAM;AAAA,EAChB;AACD,GAEMH,IAAsB,CAC3BF,GACAM,GACAC,MACY;AAEZ,QAAMC,IAAW,KAAK,IAAI,GAAGR,IAAU,CAAC,IAAIM;AACrC,SAAA,KAAK,IAAIE,GAAUD,CAAU;AACrC,GAEMH,IAAiB,CAAIL,GAAwCU,MAAgC;AAC9F,MAAAC,EAAgCX,EAAO,KAAK,GAAG;AAClD,UAAMM,IAAQN,EAAO;AAEjB,QADAM,EAAM,SAASM,KACfF,MAAa,iBAAiBG,EAA8BP,CAAK;AAAU,aAAA;AAAA,EAChF;AAEO,SAAA;AACR;"}
+{"version":3,"file":"prismaTransaction.js","sources":["../src/prismaTransaction.ts"],"sourcesContent":["import { setTimeout } from 'node:timers/promises'\n\nimport type { Either } from '@lokalise/node-core'\nimport { deepClone } from '@lokalise/node-core'\nimport type { Prisma, PrismaClient } from '@prisma/client'\nimport type * as runtime from '@prisma/client/runtime/library'\n\nimport { isCockroachDBRetryTransaction } from './errors/cockroachdbError'\nimport {\n  PRISMA_SERIALIZATION_ERROR,\n  isPrismaClientKnownRequestError,\n  isPrismaTransactionClosedError,\n} from './errors/prismaError'\nimport type {\n  DbDriver,\n  PrismaTransactionBasicOptions,\n  PrismaTransactionFn,\n  PrismaTransactionOptions,\n  PrismaTransactionReturnType,\n} from './types'\n\nconst DEFAULT_OPTIONS = {\n  retriesAllowed: 2, // first try + 2 retries = 3 tries\n  DbDriver: 'CockroachDb',\n  baseRetryDelayMs: 100,\n  maxRetryDelayMs: 30000, // 30s\n  timeout: 5000, // 5s\n  maxTimeout: 30000, // 30s\n} satisfies Partial<PrismaTransactionOptions>\n\n/**\n * Perform a Prisma DB transaction with automatic retries if needed.\n *\n * @template T | T extends Prisma.PrismaPromise<unknown>[]\n * @param {PrismaClient} prisma\n * @param {PrismaTransactionFn<T> | Prisma.PrismaPromise<unknown>[]} arg\t operation to perform into the transaction\n * @param {PrismaTransactionOptions | PrismaTransactionBasicOptions} options transaction configuration\n * @return {Promise<PrismaTransactionReturnType<T>>}\n */\nexport const prismaTransaction = (async <T, P extends PrismaClient>(\n  prisma: P,\n  arg: PrismaTransactionFn<T, P> | Prisma.PrismaPromise<unknown>[],\n  options?: PrismaTransactionOptions | PrismaTransactionBasicOptions,\n): Promise<PrismaTransactionReturnType<T>> => {\n  let optionsWithDefaults = { ...DEFAULT_OPTIONS, ...options }\n  let result: PrismaTransactionReturnType<T> | undefined = undefined\n\n  let retries = 0\n  do {\n    if (retries > 0) {\n      await setTimeout(\n        calculateRetryDelay(\n          retries,\n          optionsWithDefaults.baseRetryDelayMs,\n          optionsWithDefaults.maxRetryDelayMs,\n        ),\n      )\n    }\n\n    result = await executeTransactionTry(prisma, arg, optionsWithDefaults)\n    if (result.result) break\n\n    const retryAllowed = isRetryAllowed(result, optionsWithDefaults.DbDriver)\n    if (!retryAllowed) break\n\n    if (retryAllowed === 'increase-timeout') {\n      optionsWithDefaults = deepClone(optionsWithDefaults)\n      optionsWithDefaults.timeout = Math.min(\n        optionsWithDefaults.timeout * 2,\n        optionsWithDefaults.maxTimeout,\n      )\n    }\n\n    retries++\n  } while (retries <= optionsWithDefaults.retriesAllowed)\n\n  return result ?? { error: new Error('No transaction executed') }\n}) as {\n  <T, P extends PrismaClient>(\n    prisma: P,\n    fn: PrismaTransactionFn<T, P>,\n    options?: PrismaTransactionOptions,\n  ): Promise<Either<unknown, T>>\n  <T extends Prisma.PrismaPromise<unknown>[], P extends PrismaClient>(\n    prisma: P,\n    args: [...T],\n    options?: PrismaTransactionBasicOptions,\n  ): Promise<Either<unknown, runtime.Types.Utils.UnwrapTuple<T>>>\n}\n\nconst executeTransactionTry = async <T, P extends PrismaClient>(\n  prisma: P,\n  arg: PrismaTransactionFn<T, P> | Prisma.PrismaPromise<unknown>[],\n  options?: PrismaTransactionOptions,\n): Promise<PrismaTransactionReturnType<T>> => {\n  try {\n    return {\n      // @ts-ignore\n      result: await prisma.$transaction<T>(arg, options),\n    }\n  } catch (error) {\n    return { error }\n  }\n}\n\nconst calculateRetryDelay = (\n  retries: number,\n  baseRetryDelayMs: number,\n  maxDelayMs: number,\n): number => {\n  // exponential backoff -> 2^(retry-1) * baseRetryDelayMs\n  const expDelay = Math.pow(2, retries - 1) * baseRetryDelayMs\n  return Math.min(expDelay, maxDelayMs)\n}\n\ntype isRetryAllowedResult = boolean | 'increase-timeout'\n\nconst isRetryAllowed = <T>(\n  result: PrismaTransactionReturnType<T>,\n  dbDriver: DbDriver,\n): isRetryAllowedResult => {\n  if (isPrismaClientKnownRequestError(result.error)) {\n    const error = result.error\n    if (error.code === PRISMA_SERIALIZATION_ERROR) return true\n    if (dbDriver === 'CockroachDb' && isCockroachDBRetryTransaction(error)) return true\n    if (isPrismaTransactionClosedError(error)) return 'increase-timeout'\n  }\n\n  return false\n}\n"],"names":["DEFAULT_OPTIONS","prismaTransaction","prisma","arg","options","optionsWithDefaults","result","retries","setTimeout","calculateRetryDelay","executeTransactionTry","retryAllowed","isRetryAllowed","deepClone","error","baseRetryDelayMs","maxDelayMs","expDelay","dbDriver","isPrismaClientKnownRequestError","PRISMA_SERIALIZATION_ERROR","isCockroachDBRetryTransaction","isPrismaTransactionClosedError"],"mappings":";;;;AAqBA,MAAMA,IAAkB;AAAA,EACtB,gBAAgB;AAAA;AAAA,EAChB,UAAU;AAAA,EACV,kBAAkB;AAAA,EAClB,iBAAiB;AAAA;AAAA,EACjB,SAAS;AAAA;AAAA,EACT,YAAY;AAAA;AACd,GAWaC,IAAqB,OAChCC,GACAC,GACAC,MAC4C;AAC5C,MAAIC,IAAsB,EAAE,GAAGL,GAAiB,GAAGI,EAAQ,GACvDE,GAEAC,IAAU;AACX,KAAA;AAYD,QAXIA,IAAU,KACN,MAAAC;AAAA,MACJC;AAAA,QACEF;AAAA,QACAF,EAAoB;AAAA,QACpBA,EAAoB;AAAA,MACtB;AAAA,IAAA,GAIJC,IAAS,MAAMI,EAAsBR,GAAQC,GAAKE,CAAmB,GACjEC,EAAO,OAAQ;AAEnB,UAAMK,IAAeC,EAAeN,GAAQD,EAAoB,QAAQ;AACxE,QAAI,CAACM,EAAc;AAEnB,IAAIA,MAAiB,uBACnBN,IAAsBQ,EAAUR,CAAmB,GACnDA,EAAoB,UAAU,KAAK;AAAA,MACjCA,EAAoB,UAAU;AAAA,MAC9BA,EAAoB;AAAA,IAAA,IAIxBE;AAAA,EAAA,SACOA,KAAWF,EAAoB;AAExC,SAAOC,KAAU,EAAE,OAAO,IAAI,MAAM,yBAAyB,EAAE;AACjE,GAaMI,IAAwB,OAC5BR,GACAC,GACAC,MAC4C;AACxC,MAAA;AACK,WAAA;AAAA;AAAA,MAEL,QAAQ,MAAMF,EAAO,aAAgBC,GAAKC,CAAO;AAAA,IAAA;AAAA,WAE5CU,GAAO;AACd,WAAO,EAAE,OAAAA,EAAM;AAAA,EACjB;AACF,GAEML,IAAsB,CAC1BF,GACAQ,GACAC,MACW;AAEX,QAAMC,IAAW,KAAK,IAAI,GAAGV,IAAU,CAAC,IAAIQ;AACrC,SAAA,KAAK,IAAIE,GAAUD,CAAU;AACtC,GAIMJ,IAAiB,CACrBN,GACAY,MACyB;AACrB,MAAAC,EAAgCb,EAAO,KAAK,GAAG;AACjD,UAAMQ,IAAQR,EAAO;AAErB,QADIQ,EAAM,SAASM,KACfF,MAAa,iBAAiBG,EAA8BP,CAAK,EAAU,QAAA;AAC3E,QAAAQ,EAA+BR,CAAK,EAAU,QAAA;AAAA,EACpD;AAEO,SAAA;AACT;"}

package/dist/types.d.ts

@@ -1,3 +1,7 @@
+import { Either } from '@lokalise/node-core';
+import { Prisma } from '@prisma/client';
+import { CockroachDbIsolationLevel } from './isolation_level/isolationLevel';
+
 import type * as runtime from '@prisma/client/runtime/library';
 type ObjectValues<T> = T[keyof T];
 export declare const DbDriverEnum: {
@@ -9,11 +13,13 @@ export type PrismaTransactionOptions = {
     retriesAllowed?: number;
     baseRetryDelayMs?: number;
     maxRetryDelayMs?: number;
+    maxTimeout?: number;
     maxWait?: number;
     timeout?: number;
-    isolationLevel?: string;
+    isolationLevel?: CockroachDbIsolationLevel;
 };
-export type PrismaTransactionBasicOptions = Omit<PrismaTransactionOptions, 'maxWait' | 'timeout'>;
+export type PrismaTransactionBasicOptions = Omit<PrismaTransactionOptions, 'maxWait' | 'timeout' | 'maxTimeout'>;
 export type PrismaTransactionClient<P> = Omit<P, runtime.ITXClientDenyList>;
 export type PrismaTransactionFn<T, P> = (prisma: PrismaTransactionClient<P>) => Promise<T>;
+export type PrismaTransactionReturnType<T> = Either<unknown, T | runtime.Types.Utils.UnwrapTuple<Prisma.PrismaPromise<unknown>[]>>;
 export {};

package/package.json

@@ -1,67 +1,65 @@
 {
-	"name": "@lokalise/prisma-utils",
-	"version": "1.2.0",
-	"type": "module",
-	"license": "Apache-2.0",
-	"files": [
-		"dist",
-		"README.md",
-		"LICENSE.md"
-	],
-	"main": "./dist/index.cjs",
-	"module": "./dist/index.js",
-	"types": "./dist/index.d.ts",
-	"homepage": "https://github.com/lokalise/shared-ts-libs",
-	"repository": {
-		"type": "git",
-		"url": "git://github.com/lokalise/shared-ts-libs.git"
-	},
-	"exports": {
-		".": {
-			"types": "./dist/index.d.ts",
-			"require": "./dist/index.cjs",
-			"import": "./dist/index.js"
-		}
-	},
-	"scripts": {
-		"build": "rimraf dist && npm run db:update-client && vite build",
-		"dev": "vite watch",
-		"clean": "rimraf dist .eslintcache",
-		"lint": "eslint --cache --max-warnings=0 . && prettier --check --log-level warn src \"**/*.{json,md,ts,tsx}\" && tsc --noEmit",
-		"lint:fix": "prettier --write src \"**/*.{json,md,ts,tsx}\" --log-level=warn && eslint . --fix",
-		"docker:start:ci": "docker compose up -d cockroachdb",
-		"db:migration:dev": "dotenv -c test -- dotenv prisma migrate dev",
-		"db:update-client": "dotenv -c test prisma generate",
-		"db:wait": "while ! echo \"SELECT 1;\" | dotenv -c test -- prisma db execute --stdin; do sleep 1; done",
-		"test": "vitest run",
-		"test:migrate": "cross-env NODE_ENV=test dotenv -c test -- prisma migrate reset --force",
-		"pretest:ci": "npm run docker:start:ci && npm run db:wait && npm run test:migrate",
-		"test:ci": "npm run test -- --coverage",
-		"test:ci:teardown": "docker compose down",
-		"prepublishOnly": "npm run build",
-		"package-version": "echo $npm_package_version"
-	},
-	"dependencies": {
-		"@lokalise/node-core": "^10.0.0"
-	},
-	"peerDependencies": {
-		"prisma": "^5.14.0",
-		"@prisma/client": "^5.14.0"
-	},
-	"devDependencies": {
-		"@prisma/client": "^5.14.0",
-		"@lokalise/eslint-config": "*",
-		"@lokalise/prettier-config": "*",
-		"@lokalise/package-vite-config": "*",
-		"@vitest/coverage-v8": "^1.6.0",
-		"cross-env": "^7.0.3",
-		"dotenv-cli": "^7.4.1",
-		"prisma": "^5.14.0",
-		"prettier": "^3.3.1",
-		"rimraf": "^5.0.7",
-		"typescript": "5.4.5",
-		"vite": "^5.2.13",
-		"vitest": "^1.6.0"
-	},
-	"prettier": "@lokalise/prettier-config"
+  "name": "@lokalise/prisma-utils",
+  "version": "1.4.0",
+  "type": "module",
+  "license": "Apache-2.0",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE.md"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "homepage": "https://github.com/lokalise/shared-ts-libs",
+  "repository": {
+    "type": "git",
+    "url": "git://github.com/lokalise/shared-ts-libs.git"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.cjs",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "rimraf dist && npm run db:update-client && vite build",
+    "dev": "vite watch",
+    "clean": "rimraf dist",
+    "lint": "biome check . && tsc --project tsconfig.lint.json --noEmit",
+    "lint:fix": "biome check --write",
+    "docker:start:ci": "docker compose up -d cockroachdb",
+    "db:migration:dev": "dotenv -c test -- dotenv prisma migrate dev",
+    "db:update-client": "dotenv -c test prisma generate",
+    "db:wait": "while ! echo \"SELECT 1;\" | dotenv -c test -- prisma db execute --stdin; do sleep 1; done",
+    "test": "vitest run",
+    "test:migrate": "cross-env NODE_ENV=test dotenv -c test -- prisma migrate reset --force",
+    "pretest:ci": "npm run docker:start:ci && npm run db:wait && npm run test:migrate",
+    "test:ci": "npm run test -- --coverage",
+    "test:ci:teardown": "docker compose down",
+    "prepublishOnly": "npm run build",
+    "package-version": "echo $npm_package_version"
+  },
+  "dependencies": {
+    "@lokalise/node-core": "^11.2.0"
+  },
+  "peerDependencies": {
+    "@prisma/client": "^5.16.1",
+    "prisma": "^5.16.1"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^1.8.3",
+    "@lokalise/biome-config": "*",
+    "@lokalise/package-vite-config": "*",
+    "@prisma/client": "^5.14.0",
+    "@vitest/coverage-v8": "^1.6.0",
+    "cross-env": "^7.0.3",
+    "dotenv-cli": "^7.4.1",
+    "prisma": "^5.14.0",
+    "rimraf": "^5.0.7",
+    "typescript": "5.5.3",
+    "vite": "^5.3.3",
+    "vitest": "^1.6.0"
+  }
 }

package/dist/cockroachdbError.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cockroachdbError.js","sources":["../src/cockroachdbError.ts"],"sourcesContent":["import type { PrismaClientKnownRequestError } from '@prisma/client/runtime/library'\n\n/**\n * https://www.cockroachlabs.com/docs/stable/transaction-retry-error-reference#:~:text=To%20indicate%20that%20a%20transaction,the%20string%20%22restart%20transaction%22%20.\n *\n * All transaction retry errors use the SQLSTATE error code 40001\n */\nconst COCKROACHDB_RETRY_TRANSACTION_CODE = '40001'\n\n/**\n * Check if the error is a CockroachDB transaction retry error\n *\n * @param error\n */\nexport const isCockroachDBRetryTransaction = (error: PrismaClientKnownRequestError): boolean => {\n\tconst meta = error.meta\n\tif (!meta) return false\n\n\treturn meta.code === COCKROACHDB_RETRY_TRANSACTION_CODE\n}\n"],"names":["COCKROACHDB_RETRY_TRANSACTION_CODE","isCockroachDBRetryTransaction","error","meta"],"mappings":"AAOA,MAAMA,IAAqC,SAO9BC,IAAgC,CAACC,MAAkD;AAC/F,QAAMC,IAAOD,EAAM;AACnB,SAAKC,IAEEA,EAAK,SAASH,IAFH;AAGnB;"}

package/dist/prismaError.js

@@ -1,9 +0,0 @@
-import { isError as t } from "@lokalise/node-core";
-const o = (R) => !!R && t(R) && "code" in R && typeof R.code == "string" && R.code.startsWith("P"), n = "P2025", i = "P2034", I = "P2002";
-export {
-  n as PRISMA_NOT_FOUND_ERROR,
-  i as PRISMA_SERIALIZATION_ERROR,
-  I as PRISMA_UNIQUE_CONSTRAINT_ERROR,
-  o as isPrismaClientKnownRequestError
-};
-//# sourceMappingURL=prismaError.js.map

package/dist/prismaError.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"prismaError.js","sources":["../src/prismaError.ts"],"sourcesContent":["import { isError } from '@lokalise/node-core'\nimport type { PrismaClientKnownRequestError } from '@prisma/client/runtime/library'\n\n/**\n * What is checked?\n * \t1. error is defined and not null\n * \t2. error is an `Error`\n * \t3. error contains the field code which is a string\n * \t4. code starts by `P` ([doc](https://www.prisma.io/docs/reference/api-reference/error-reference#error-codes))\n */\nexport const isPrismaClientKnownRequestError = (\n\terror: unknown,\n): error is PrismaClientKnownRequestError =>\n\t!!error &&\n\tisError(error) &&\n\t'code' in error &&\n\ttypeof error.code === 'string' &&\n\terror.code.startsWith('P')\n\n/*\n * Prisma error code P2025 indicates that the operation failed because it depends on one or more\n * records that were required but not found\n */\nexport const PRISMA_NOT_FOUND_ERROR = 'P2025'\n\n/*\n * Prisma error code P2034 indicates a serialization error and that the transaction must be retried.\n * A different error code would indicate that an internal state error happened and that\n * the cluster itself is experiencing an issue which requires intervention\n */\nexport const PRISMA_SERIALIZATION_ERROR = 'P2034'\n\n/*\n * Prisma error code P2002 indicates that the operation failed because a unique constraint was\n * violated. This can happen if you try to create a record with a unique field that already exists\n */\nexport const PRISMA_UNIQUE_CONSTRAINT_ERROR = 'P2002'\n"],"names":["isPrismaClientKnownRequestError","error","isError","PRISMA_NOT_FOUND_ERROR","PRISMA_SERIALIZATION_ERROR","PRISMA_UNIQUE_CONSTRAINT_ERROR"],"mappings":";AAUO,MAAMA,IAAkC,CAC9CC,MAEA,CAAC,CAACA,KACFC,EAAQD,CAAK,KACb,UAAUA,KACV,OAAOA,EAAM,QAAS,YACtBA,EAAM,KAAK,WAAW,GAAG,GAMbE,IAAyB,SAOzBC,IAA6B,SAM7BC,IAAiC;"}

package/dist/types.js

@@ -1,7 +0,0 @@
-const o = {
-  COCKROACHDB: "CockroachDb"
-};
-export {
-  o as DbDriverEnum
-};
-//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sources":["../src/types.ts"],"sourcesContent":["import type * as runtime from '@prisma/client/runtime/library'\n\ntype ObjectValues<T> = T[keyof T]\n\nexport const DbDriverEnum = {\n\tCOCKROACHDB: 'CockroachDb',\n} as const\nexport type DbDriver = ObjectValues<typeof DbDriverEnum>\n\nexport type PrismaTransactionOptions = {\n\t// Prisma utils library custom options\n\tDbDriver?: DbDriver\n\tretriesAllowed?: number\n\tbaseRetryDelayMs?: number\n\tmaxRetryDelayMs?: number\n\n\t// Prisma $transaction options\n\tmaxWait?: number\n\ttimeout?: number\n\tisolationLevel?: string\n}\n\n// Prisma $transaction with array does not support maxWait and timeout options\nexport type PrismaTransactionBasicOptions = Omit<PrismaTransactionOptions, 'maxWait' | 'timeout'>\n\nexport type PrismaTransactionClient<P> = Omit<P, runtime.ITXClientDenyList>\n\nexport type PrismaTransactionFn<T, P> = (prisma: PrismaTransactionClient<P>) => Promise<T>\n"],"names":["DbDriverEnum"],"mappings":"AAIO,MAAMA,IAAe;AAAA,EAC3B,aAAa;AACd;"}