@proteinjs/db 1.52.0 → 1.54.0

package/dist/generated/test/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../generated/test/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../generated/test/index.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -2,6 +2,8 @@ export * from './src/Db';
 export * from './src/DetachedDbOps';
 export * from './src/Table';
 export * from './src/RecordAccessError';
+export * from './src/DuplicateKeyError';
+export * from './src/TransactionRetryExhaustedError';
 export * from './src/auth/TableAuth';
 export * from './src/auth/TableServiceAuth';
 export * from './src/Columns';
@@ -22,6 +24,7 @@ export * from './src/TableWatcher';
 export * from './src/transaction/Transaction';
 export * from './src/transaction/TransactionRunner';
 export * from './src/transaction/TransactionContextFactory';
+export * from './src/transaction/TransactionRetryPolicy';
 export * from './src/schema/SchemaOperations';
 export * from './src/schema/SchemaMetadata';
 export * from './src/schema/TableManager';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oCAAoC,CAAC;AACnD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAG9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAC7E,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qCAAqC,CAAC;AACpD,cAAc,6CAA6C,CAAC;AAE5D,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAE1C,cAAc,oCAAoC,CAAC;AACnD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,qCAAqC,CAAC;AACpD,cAAc,yCAAyC,CAAC;AACxD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qCAAqC,CAAC;AACpD,cAAc,kCAAkC,CAAC;AACjD,cAAc,mCAAmC,CAAC;AAClD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,gDAAgD,CAAC;AAC/D,cAAc,mCAAmC,CAAC;AAClD,cAAc,wCAAwC,CAAC;AACvD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,4CAA4C,CAAC;AAC3D,cAAc,iDAAiD,CAAC;AAEhE,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAE5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,uCAAuC,CAAC;AACtD,cAAc,yCAAyC,CAAC;AAExD,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sCAAsC,CAAC;AACrD,cAAc,sBAAsB,CAAC;AACrC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oCAAoC,CAAC;AACnD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAG9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAC7E,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qCAAqC,CAAC;AACpD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,0CAA0C,CAAC;AAEzD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAE1C,cAAc,oCAAoC,CAAC;AACnD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,qCAAqC,CAAC;AACpD,cAAc,yCAAyC,CAAC;AACxD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qCAAqC,CAAC;AACpD,cAAc,kCAAkC,CAAC;AACjD,cAAc,mCAAmC,CAAC;AAClD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,gDAAgD,CAAC;AAC/D,cAAc,mCAAmC,CAAC;AAClD,cAAc,wCAAwC,CAAC;AACvD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,4CAA4C,CAAC;AAC3D,cAAc,iDAAiD,CAAC;AAEhE,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAE5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,uCAAuC,CAAC;AACtD,cAAc,yCAAyC,CAAC;AAExD,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -19,6 +19,8 @@ __exportStar(require("./src/Db"), exports);
 __exportStar(require("./src/DetachedDbOps"), exports);
 __exportStar(require("./src/Table"), exports);
 __exportStar(require("./src/RecordAccessError"), exports);
+__exportStar(require("./src/DuplicateKeyError"), exports);
+__exportStar(require("./src/TransactionRetryExhaustedError"), exports);
 __exportStar(require("./src/auth/TableAuth"), exports);
 __exportStar(require("./src/auth/TableServiceAuth"), exports);
 __exportStar(require("./src/Columns"), exports);
@@ -42,6 +44,7 @@ __exportStar(require("./src/TableWatcher"), exports);
 __exportStar(require("./src/transaction/Transaction"), exports);
 __exportStar(require("./src/transaction/TransactionRunner"), exports);
 __exportStar(require("./src/transaction/TransactionContextFactory"), exports);
+__exportStar(require("./src/transaction/TransactionRetryPolicy"), exports);
 __exportStar(require("./src/schema/SchemaOperations"), exports);
 __exportStar(require("./src/schema/SchemaMetadata"), exports);
 __exportStar(require("./src/schema/TableManager"), exports);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,sDAAoC;AACpC,8CAA4B;AAC5B,0DAAwC;AACxC,uDAAqC;AACrC,8DAA4C;AAC5C,gDAA8B;AAC9B,+CAA6B;AAC7B,iEAA+C;AAC/C,qEAAmD;AACnD,4DAA0C;AAC1C,yDAAuC;AACvC,iEAA+C;AAC/C,uDAAqC;AACrC,0DAAwC;AACxC,4DAA0C;AAC1C,gEAA8C;AAC9C,gGAAgG;AAChG,4EAA4E;AAC5E,8EAA6E;AAApE,gIAAA,sBAAsB,OAAA;AAC/B,wDAAsC;AACtC,4DAA0C;AAC1C,qDAAmC;AACnC,gEAA8C;AAC9C,sEAAoD;AACpD,8EAA4D;AAE5D,gEAA8C;AAC9C,8DAA4C;AAC5C,4DAA0C;AAE1C,qEAAmD;AACnD,6EAA2D;AAC3D,sEAAoD;AACpD,0EAAwD;AACxD,gEAA8C;AAC9C,sEAAoD;AACpD,mEAAiD;AACjD,oEAAkD;AAClD,6EAA2D;AAC3D,iFAA+D;AAC/D,oEAAkD;AAClD,yEAAuD;AACvD,8EAA4D;AAC5D,6EAA2D;AAC3D,kFAAgE;AAEhE,sDAAoC;AACpC,8DAA4C;AAE5C,2DAAyC;AACzC,wEAAsD;AACtD,0EAAwD;AAExD,sDAAoC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,sDAAoC;AACpC,8CAA4B;AAC5B,0DAAwC;AACxC,0DAAwC;AACxC,uEAAqD;AACrD,uDAAqC;AACrC,8DAA4C;AAC5C,gDAA8B;AAC9B,+CAA6B;AAC7B,iEAA+C;AAC/C,qEAAmD;AACnD,4DAA0C;AAC1C,yDAAuC;AACvC,iEAA+C;AAC/C,uDAAqC;AACrC,0DAAwC;AACxC,4DAA0C;AAC1C,gEAA8C;AAC9C,gGAAgG;AAChG,4EAA4E;AAC5E,8EAA6E;AAApE,gIAAA,sBAAsB,OAAA;AAC/B,wDAAsC;AACtC,4DAA0C;AAC1C,qDAAmC;AACnC,gEAA8C;AAC9C,sEAAoD;AACpD,8EAA4D;AAC5D,2EAAyD;AAEzD,gEAA8C;AAC9C,8DAA4C;AAC5C,4DAA0C;AAE1C,qEAAmD;AACnD,6EAA2D;AAC3D,sEAAoD;AACpD,0EAAwD;AACxD,gEAA8C;AAC9C,sEAAoD;AACpD,mEAAiD;AACjD,oEAAkD;AAClD,6EAA2D;AAC3D,iFAA+D;AAC/D,oEAAkD;AAClD,yEAAuD;AACvD,8EAA4D;AAC5D,6EAA2D;AAC3D,kFAAgE;AAEhE,sDAAoC;AACpC,8DAA4C;AAE5C,2DAAyC;AACzC,wEAAsD;AACtD,0EAAwD;AAExD,sDAAoC"}

package/dist/src/Db.d.ts

@@ -8,6 +8,7 @@ import { TableManager } from './schema/TableManager';
 import { DefaultTransactionContextFactory, PostCommitHook } from './transaction/TransactionContextFactory';
 import { ArrayMembershipUpdate } from './reference/ArrayMembershipOps';
 import { PreservedPath } from './UpdatePreserving';
+import { TransactionOptions } from './transaction/TransactionRetryPolicy';
 /** get `Db` if on server, and `DbService` if on browser */
 export declare const getDb: <R extends Record = Record>() => Db<R>;
 export declare const getDbAsSystem: <R extends Record = Record>() => Db<R>;
@@ -46,8 +47,20 @@ export interface DbDriver {
     stop?(): Promise<void>;
     getTableManager(): TableManager;
     runQuery(generateStatement: (config: DbDriverQueryStatementConfig) => Statement, transaction?: any): Promise<SerializedRecord[]>;
-    runDml(generateStatement: (config: DbDriverDmlStatementConfig) => Statement, transaction?: any): Promise<number>;
-    runTransaction<T>(fn: (transaction: any) => Promise<T>): Promise<T>;
+    /**
+     * Run one write statement. On `transaction` it rides that transaction; without one it is a
+     * transaction of its own, and `options.retry` (`TransactionRetryPolicy`) is how the driver
+     * re-runs it when the database aborts it — the driver's own road when omitted, else the bound
+     * named, past which the driver throws `TransactionRetryExhaustedError`. A driver that never
+     * re-runs an aborted statement (the abort reaches the caller at once) already satisfies every
+     * policy.
+     */
+    runDml(generateStatement: (config: DbDriverDmlStatementConfig) => Statement, transaction?: any, options?: TransactionOptions): Promise<number>;
+    /**
+     * Run `fn` as one transaction. `options.retry` (`TransactionRetryPolicy`) is how the driver
+     * re-runs the whole body when the database aborts the transaction — see `runDml`.
+     */
+    runTransaction<T>(fn: (transaction: any) => Promise<T>, options?: TransactionOptions): Promise<T>;
     /**
      * The driver's per-operation deadline, in milliseconds: the longest one statement it runs may
      * take before the driver fails it — the bound the driver enforces, as configured. Not a whole
@@ -65,6 +78,13 @@ export interface DbDriver {
      * and a batch on it is always one statement.
      */
     getStatementParameterLimit?(): number;
+    /**
+     * Whether `error` — what this driver's `runDml` threw — is the backend refusing a row because a
+     * row with the same key is already there (the primary key, or a unique index). `Db.insert` and
+     * `Db.insertMany` rethrow such a refusal as the typed `DuplicateKeyError`, so a caller can take
+     * it by type. A driver that declares no classifier lets the backend's error through as it came.
+     */
+    isDuplicateKeyError?(error: unknown): boolean;
 }
 export declare class Db<R extends Record = Record> implements DbService<R> {
     private runAsSystem;
@@ -92,7 +112,14 @@ export declare class Db<R extends Record = Record> implements DbService<R> {
     init(): Promise<void>;
     tableExists<T extends R>(table: Table<T>): Promise<boolean>;
     get<T extends R>(table: Table<T>, query: Query<T>, options?: QueryOptions<T>): Promise<T>;
-    insert<T extends R>(table: Table<T>, record: Omit<T, keyof R>): Promise<T>;
+    /**
+     * Insert one row. Outside a transaction the insert is a transaction of its own, and
+     * `options.retry` names how it is re-run when the database aborts it (`TransactionRetryPolicy`:
+     * the driver's own road when omitted; a bounded policy for a best-effort write, past which the
+     * caller takes `TransactionRetryExhaustedError`). Inside a transaction the transaction's policy
+     * governs, and an insert naming one of its own is refused.
+     */
+    insert<T extends R>(table: Table<T>, record: Omit<T, keyof R>, options?: TransactionOptions): Promise<T>;
     /**
      * Insert `records` as ONE statement (a multi-row INSERT) instead of one statement per row,
      * each row keeping every contract {@link insert} gives a single one: the table's default field
@@ -112,7 +139,15 @@ export declare class Db<R extends Record = Record> implements DbService<R> {
      * empty list inserts nothing and returns [].
      */
     insertMany<T extends R>(table: Table<T>, records: Omit<T, keyof R>[]): Promise<T[]>;
-    update<T extends R>(table: Table<T>, record: Partial<T>, query?: Query<T>): Promise<number>;
+    /**
+     * Update the rows `query` selects (the one row `record.id` names when there is no query).
+     * Outside a transaction the update is a transaction of its own, and `options.retry` names how
+     * it is re-run when the database aborts it (`TransactionRetryPolicy`: the driver's own road when
+     * omitted; a bounded policy for a best-effort write — a live progress row the next step
+     * rewrites anyway — past which the caller takes `TransactionRetryExhaustedError`). Inside a
+     * transaction the transaction's policy governs, and an update naming one of its own is refused.
+     */
+    update<T extends R>(table: Table<T>, record: Partial<T>, query?: Query<T>, options?: TransactionOptions): Promise<number>;
     /**
      * Apply commutative membership ops (add/remove/move) to a `ReferenceArrayColumn`
      * read-modify-write against COMMITTED truth, so concurrent membership writers
@@ -219,6 +254,11 @@ export declare class Db<R extends Record = Record> implements DbService<R> {
      *
      * Note: Nested transactions are not supported; will throw.
      *
+     * `options.retry` names how the driver re-runs the whole body when the database aborts the
+     * transaction (`TransactionRetryPolicy`: the driver's own road when omitted; a bounded policy
+     * for best-effort work, past which this throws `TransactionRetryExhaustedError`). Every write
+     * inside the body rides this policy; none may name one of its own.
+     *
      * Note: work spawned inside the body but NOT awaited by it escapes the transaction's
      * lifetime while still holding its context — such work fails loudly on its next db
      * operation (see TransactionContextData.ended). Await everything inside the body, or run
@@ -237,7 +277,7 @@ export declare class Db<R extends Record = Record> implements DbService<R> {
      * });
      * ```
      */
-    runTransaction<T>(fn: () => Promise<T>): Promise<T>;
+    runTransaction<T>(fn: () => Promise<T>, options?: TransactionOptions): Promise<T>;
     /**
      * Run `hook` once the write unit currently executing is durably committed.
      *
@@ -260,6 +300,12 @@ export declare class Db<R extends Record = Record> implements DbService<R> {
      * exactly as before.
      */
     private encryptionWriteContext;
+    /**
+     * What an insert statement's failure becomes for the caller: the typed `DuplicateKeyError` when
+     * the driver classifies the backend's refusal as a row already there; any other failure as it
+     * came.
+     */
+    private insertFailure;
     private updateTouchesEncryptedColumns;
     /**
      * Update path for payloads touching encrypted columns. Ciphertext is keyed per row OWNER
@@ -295,6 +341,13 @@ export declare class Db<R extends Record = Record> implements DbService<R> {
      * handing the driver an ended transaction would fail anyway, with a far worse error.
      */
     private transactionForDriver;
+    /**
+     * A write's transaction options as the driver takes them: its own, when the write runs outside
+     * any transaction and so is a transaction of its own. Inside a transaction the write rides the
+     * transaction, whose policy was named on `runTransaction`; a policy named on the write would be
+     * one nothing honours — refused by name, never dropped.
+     */
+    private ownTransactionOptions;
     /**
      * The rows of one multi-row insert split into the fewest statements the driver's statement
      * parameter bound admits (`insertMany`): each statement binds `columns × rows` parameters,

package/dist/src/Db.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Db.d.ts","sourceRoot":"","sources":["../../src/Db.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAe,KAAK,EAAE,YAAY,EAAgB,MAAM,sBAAsB,CAAC;AACjG,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAoB,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAEL,KAAK,EAKN,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,MAAM,EAAoB,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAGtE,OAAO,EAAE,sBAAsB,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,EAAoB,MAAM,qBAAqB,CAAC;AAGnH,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAIrD,OAAO,EACL,gCAAgC,EAChC,cAAc,EAGf,MAAM,yCAAyC,CAAC;AAKjD,OAAO,EAAE,qBAAqB,EAA2B,MAAM,gCAAgC,CAAC;AAChG,OAAO,EAAE,aAAa,EAAyB,MAAM,oBAAoB,CAAC;AAE1E,2DAA2D;AAC3D,eAAO,MAAM,KAAK,wCACqD,CAAC;AACxE,eAAO,MAAM,aAAa,wCAAoF,CAAC;AAkB/G,MAAM,MAAM,4BAA4B,GAAG,sBAAsB,GAAG;IAClE,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,mBAAmB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,MAAM,CAAC;IACxE,qBAAqB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,KAAK,MAAM,CAAC;IACjG,gGAAgG;IAChG,mBAAmB,CAAC,EAAE,CAAC,kBAAkB,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,KAAK,MAAM,CAAC;IAC9F,kHAAkH;IAClH,eAAe,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,KAAK,MAAM,CAAC;CACpE,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG,sBAAsB,GAAG;IAChE,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,mBAAmB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,MAAM,CAAC;IACxE,kHAAkH;IAClH,eAAe,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,KAAK,MAAM,CAAC;CACpE,CAAC;AAEF,MAAM,WAAW,sBAAuB,SAAQ,QAAQ;IACtD,WAAW,IAAI,QAAQ,CAAC;CACzB;AAED,MAAM,WAAW,QAAQ;IACvB,SAAS,IAAI,MAAM,CAAC;IACpB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,+BAA+B;IAC/B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,eAAe,IAAI,YAAY,CAAC;IAChC,QAAQ,CACN,iBAAiB,EAAE,CAAC,MAAM,EAAE,4BAA4B,KAAK,SAAS,EACtE,WAAW,CAAC,EAAE,GAAG,GAChB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAC/B,MAAM,CAAC,iBAAiB,EAAE,CAAC,MAAM,EAAE,0BAA0B,KAAK,SAAS,EAAE,WAAW,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACjH,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,WAAW,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACpE;;;;;;;OAOG;IACH,sBAAsB,IAAI,MAAM,CAAC;IACjC;;;;;;OAMG;IACH,0BAA0B,CAAC,IAAI,MAAM,CAAC;CACvC;AAED,qBAAa,EAAE,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAE,YAAW,SAAS,CAAC,CAAC,CAAC;IAkB9D,OAAO,CAAC,WAAW;IAjBrB,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,QAAQ,CAAoC;IACpD,OAAO,CAAC,MAAM,CAA2F;IACzG,OAAO,CAAC,sBAAsB,CAAyB;IACvD,OAAO,CAAC,IAAI,CAAmB;IAC/B,OAAO,CAAC,kBAAkB,CAA+B;IACzD,OAAO,CAAC,yBAAyB,CAAmC;IAC7D,eAAe,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAIhD;gBAGA,QAAQ,CAAC,EAAE,QAAQ,EACnB,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,KAAK,CAAC,GAAG,CAAC,EAC5C,yBAAyB,CAAC,EAAE,gCAAgC,EACpD,WAAW,GAAE,OAAe;IAUtC,MAAM,CAAC,kBAAkB,IAAI,QAAQ;IAiBrC,OAAO,CAAC,mCAAmC;IAS3C;;;;;;;;;OASG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAerB,WAAW,CAAC,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAI3D,GAAG,CAAC,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAIzF,MAAM,CAAC,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAmChF;;;;;;;;;;;;;;;;;OAiBG;IACG,UAAU,CAAC,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAqDnF,MAAM,CAAC,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAsDjG;;;;;;;;;;OAUG;IACG,qBAAqB,CAAC,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAyCzG;;;;;;;OAOG;IACG,gBAAgB,CAAC,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IA0C9G,MAAM,CAAC,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;YAiC9D,sBAAsB;YAetB,mBAAmB;IAmCjC;;;;;;;;OAQG;YACW,gCAAgC;IA8C9C;;;;;;OAMG;YACW,kCAAkC;IA4DhD;;;;;;;;;OASG;IACG,KAAK,CAAC,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;YASrF,MAAM;IAgBpB;;;;;;;;OAQG;YACW,iBAAiB;IA4EzB,WAAW,CAAC,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAclF;;;;;;;;;;;OAWG;IACG,eAAe,CAAC,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,EAAE,CAAC;YAWjG,gBAAgB;YA4BhB,oBAAoB;IASlC,2FAA2F;YAC7E,yBAAyB;IASvC;;;;;;;OAOG;IACH,OAAO,CAAC,iBAAiB;YAWX,4BAA4B;IAS1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACG,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAwCzD;;;;;;;;;;;;;OAaG;IACG,cAAc,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBzD;;;;;OAKG;YACW,sBAAsB;YAYtB,6BAA6B;IAO3C;;;;;;OAMG;YACW,eAAe;IA4C7B,uGAAuG;YACzF,yBAAyB;IAKvC;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAInB;;;;;;;OAOG;IACH,OAAO,CAAC,aAAa;IAIrB;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IAW5B;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;IAiB7B,OAAO,CAAC,KAAK;CAUd"}
+{"version":3,"file":"Db.d.ts","sourceRoot":"","sources":["../../src/Db.ts"],"names":[],"mappings":"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"}

package/dist/src/Db.js

@@ -89,6 +89,7 @@ var ReferenceArray_1 = require("./reference/ReferenceArray");
 var ReferenceCache_1 = require("./reference/ReferenceCache");
 var ArrayMembershipOps_1 = require("./reference/ArrayMembershipOps");
 var UpdatePreserving_1 = require("./UpdatePreserving");
+var DuplicateKeyError_1 = require("./DuplicateKeyError");
 /** get `Db` if on server, and `DbService` if on browser */
 var getDb = function () {
     return typeof self === 'undefined' ? new Db() : (0, DbService_1.getDbService)();
@@ -201,9 +202,16 @@ var Db = /** @class */ (function () {
             });
         });
     };
-    Db.prototype.insert = function (table, record) {
+    /**
+     * Insert one row. Outside a transaction the insert is a transaction of its own, and
+     * `options.retry` names how it is re-run when the database aborts it (`TransactionRetryPolicy`:
+     * the driver's own road when omitted; a bounded policy for a best-effort write, past which the
+     * caller takes `TransactionRetryExhaustedError`). Inside a transaction the transaction's policy
+     * governs, and an insert naming one of its own is refused.
+     */
+    Db.prototype.insert = function (table, record, options) {
         return __awaiter(this, void 0, void 0, function () {
-            var recordCopy, encryptionContext, recordSerializer, serializedRecord, generateInsert, EncryptionTokenMaintenance;
+            var driverOptions, recordCopy, encryptionContext, recordSerializer, serializedRecord, generateInsert, error_1, EncryptionTokenMaintenance;
             var _this = this;
             return __generator(this, function (_a) {
                 switch (_a.label) {
@@ -211,6 +219,7 @@ var Db = /** @class */ (function () {
                         if (!this.runAsSystem) {
                             this.auth.canInsert(table);
                         }
+                        driverOptions = this.ownTransactionOptions(options);
                         recordCopy = Object.assign({}, record);
                         return [4 /*yield*/, (0, Table_1.addDefaultFieldValues)(table, recordCopy, this.runAsSystem)];
                     case 1:
@@ -231,22 +240,30 @@ var Db = /** @class */ (function () {
                         generateInsert = function (config) {
                             return new db_query_1.StatementFactory().insert(table.name, serializedRecord, _this.statementConfigFactory.getStatementConfig(config));
                         };
-                        return [4 /*yield*/, this.dbDriver.runDml(generateInsert, this.transactionForDriver())];
+                        _a.label = 6;
                     case 6:
+                        _a.trys.push([6, 8, , 9]);
+                        return [4 /*yield*/, this.dbDriver.runDml(generateInsert, this.transactionForDriver(), driverOptions)];
+                    case 7:
                         _a.sent();
-                        if (!encryptionContext) return [3 /*break*/, 9];
+                        return [3 /*break*/, 9];
+                    case 8:
+                        error_1 = _a.sent();
+                        throw this.insertFailure(table, error_1);
+                    case 9:
+                        if (!encryptionContext) return [3 /*break*/, 12];
                         return [4 /*yield*/, Promise.resolve().then(function () { return __importStar(require('./encryption/EncryptionTokenMaintenance')); })];
-                    case 7:
+                    case 10:
                         EncryptionTokenMaintenance = (_a.sent()).EncryptionTokenMaintenance;
                         return [4 /*yield*/, new EncryptionTokenMaintenance().afterInsert(table, recordCopy, encryptionContext.keyOwner, this.newSystemDb())];
-                    case 8:
+                    case 11:
                         _a.sent();
-                        _a.label = 9;
-                    case 9: return [4 /*yield*/, this.runColumnAfterInsertHooks(table, recordCopy)];
-                    case 10:
+                        _a.label = 12;
+                    case 12: return [4 /*yield*/, this.runColumnAfterInsertHooks(table, recordCopy)];
+                    case 13:
                         _a.sent();
                         return [4 /*yield*/, this.tableWatcherRunner.runAfterInsertTableWatchers(table, recordCopy)];
-                    case 11:
+                    case 14:
                         _a.sent();
                         return [2 /*return*/, recordCopy];
                 }
@@ -323,17 +340,24 @@ var Db = /** @class */ (function () {
                         return [3 /*break*/, 3];
                     case 10:
                         _loop_1 = function (statementRows) {
-                            var generateInsert;
+                            var generateInsert, error_2;
                             return __generator(this, function (_f) {
                                 switch (_f.label) {
                                     case 0:
                                         generateInsert = function (config) {
                                             return new db_query_1.StatementFactory().insertMany(table.name, statementRows, _this.statementConfigFactory.getStatementConfig(config));
                                         };
-                                        return [4 /*yield*/, this_1.dbDriver.runDml(generateInsert, this_1.transactionForDriver())];
+                                        _f.label = 1;
                                     case 1:
+                                        _f.trys.push([1, 3, , 4]);
+                                        return [4 /*yield*/, this_1.dbDriver.runDml(generateInsert, this_1.transactionForDriver())];
+                                    case 2:
                                         _f.sent();
-                                        return [2 /*return*/];
+                                        return [3 /*break*/, 4];
+                                    case 3:
+                                        error_2 = _f.sent();
+                                        throw this_1.insertFailure(table, error_2);
+                                    case 4: return [2 /*return*/];
                                 }
                             });
                         };
@@ -379,10 +403,18 @@ var Db = /** @class */ (function () {
             });
         });
     };
-    Db.prototype.update = function (table, record, query) {
+    /**
+     * Update the rows `query` selects (the one row `record.id` names when there is no query).
+     * Outside a transaction the update is a transaction of its own, and `options.retry` names how
+     * it is re-run when the database aborts it (`TransactionRetryPolicy`: the driver's own road when
+     * omitted; a bounded policy for a best-effort write — a live progress row the next step
+     * rewrites anyway — past which the caller takes `TransactionRetryExhaustedError`). Inside a
+     * transaction the transaction's policy governs, and an update naming one of its own is refused.
+     */
+    Db.prototype.update = function (table, record, query, options) {
         var _a;
         return __awaiter(this, void 0, void 0, function () {
-            var recordCopy, columnPropertyName, column, immutable, qb, recordUpdateCount, recordSerializer, serializedRecord_1, generateUpdate, id;
+            var driverOptions, recordCopy, columnPropertyName, column, immutable, qb, recordUpdateCount, recordSerializer, serializedRecord_1, generateUpdate, id;
             var _this = this;
             return __generator(this, function (_b) {
                 switch (_b.label) {
@@ -393,6 +425,7 @@ var Db = /** @class */ (function () {
                         if (!query && !record.id) {
                             throw new Error("Update must be called with either a Query or a record with an id property");
                         }
+                        driverOptions = this.ownTransactionOptions(options);
                         recordCopy = Object.assign({}, record);
                         // Immutable columns can never be rewritten through an update — strip them from the payload
                         // (e.g. a ScopedRecord's `scope`: forced on insert; a client-path update rewriting it would
@@ -420,7 +453,7 @@ var Db = /** @class */ (function () {
                         return [4 /*yield*/, this.updateTouchesEncryptedColumns(table, recordCopy)];
                     case 4:
                         if (!_b.sent()) return [3 /*break*/, 6];
-                        return [4 /*yield*/, this.updateEncrypted(table, recordCopy, qb)];
+                        return [4 /*yield*/, this.updateEncrypted(table, recordCopy, qb, driverOptions)];
                     case 5:
                         recordUpdateCount = _b.sent();
                         return [3 /*break*/, 9];
@@ -433,7 +466,7 @@ var Db = /** @class */ (function () {
                         generateUpdate = function (config) {
                             return new db_query_1.StatementFactory().update(table.name, serializedRecord_1, qb, _this.statementConfigFactory.getStatementConfig(config));
                         };
-                        return [4 /*yield*/, this.dbDriver.runDml(generateUpdate, this.transactionForDriver())];
+                        return [4 /*yield*/, this.dbDriver.runDml(generateUpdate, this.transactionForDriver(), driverOptions)];
                     case 8:
                         recordUpdateCount = _b.sent();
                         _b.label = 9;
@@ -1273,6 +1306,11 @@ var Db = /** @class */ (function () {
      *
      * Note: Nested transactions are not supported; will throw.
      *
+     * `options.retry` names how the driver re-runs the whole body when the database aborts the
+     * transaction (`TransactionRetryPolicy`: the driver's own road when omitted; a bounded policy
+     * for best-effort work, past which this throws `TransactionRetryExhaustedError`). Every write
+     * inside the body rides this policy; none may name one of its own.
+     *
      * Note: work spawned inside the body but NOT awaited by it escapes the transaction's
      * lifetime while still holding its context — such work fails loudly on its next db
      * operation (see TransactionContextData.ended). Await everything inside the body, or run
@@ -1291,9 +1329,9 @@ var Db = /** @class */ (function () {
      * });
      * ```
      */
-    Db.prototype.runTransaction = function (fn) {
+    Db.prototype.runTransaction = function (fn, options) {
         return __awaiter(this, void 0, void 0, function () {
-            var postCommitHooks, result, _i, postCommitHooks_1, postCommitHook, error_1;
+            var postCommitHooks, result, _i, postCommitHooks_1, postCommitHook, error_3;
             var _this = this;
             return __generator(this, function (_a) {
                 switch (_a.label) {
@@ -1326,7 +1364,7 @@ var Db = /** @class */ (function () {
                                         case 4: return [2 /*return*/];
                                     }
                                 });
-                            }); })];
+                            }); }, options)];
                     case 1:
                         result = _a.sent();
                         _i = 0, postCommitHooks_1 = postCommitHooks;
@@ -1342,8 +1380,8 @@ var Db = /** @class */ (function () {
                         _a.sent();
                         return [3 /*break*/, 6];
                     case 5:
-                        error_1 = _a.sent();
-                        this.logger.error({ message: "Post-commit hook failed", error: error_1 });
+                        error_3 = _a.sent();
+                        this.logger.error({ message: "Post-commit hook failed", error: error_3 });
                         return [3 /*break*/, 6];
                     case 6:
                         _i++;
@@ -1422,6 +1460,15 @@ var Db = /** @class */ (function () {
             });
         });
     };
+    /**
+     * What an insert statement's failure becomes for the caller: the typed `DuplicateKeyError` when
+     * the driver classifies the backend's refusal as a row already there; any other failure as it
+     * came.
+     */
+    Db.prototype.insertFailure = function (table, error) {
+        var _a, _b;
+        return ((_b = (_a = this.dbDriver).isDuplicateKeyError) === null || _b === void 0 ? void 0 : _b.call(_a, error)) ? new DuplicateKeyError_1.DuplicateKeyError(table.name, error) : error;
+    };
     Db.prototype.updateTouchesEncryptedColumns = function (table, record) {
         return __awaiter(this, void 0, void 0, function () {
             var EncryptedColumns, encryptedColumns;
@@ -1444,7 +1491,7 @@ var Db = /** @class */ (function () {
      * same query-then-act shape `delete` uses), grouped by owner, and updated one DML per
      * owner group with that owner's ciphertext, companions, and search tokens.
      */
-    Db.prototype.updateEncrypted = function (table, recordCopy, qb) {
+    Db.prototype.updateEncrypted = function (table, recordCopy, qb, options) {
         var _a;
         return __awaiter(this, void 0, void 0, function () {
             var targetRows, EncryptionRecordHooks, EncryptionTokenMaintenance, hooks, idsByOwner, _i, targetRows_1, row, owner, ids, recordUpdateCount, tokenMaintenance, _loop_3, this_2, _b, _c, _d, owner, ids;
@@ -1500,7 +1547,7 @@ var Db = /** @class */ (function () {
                                             return new db_query_1.StatementFactory().update(table.name, serializedRecord, groupQb, _this.statementConfigFactory.getStatementConfig(config));
                                         };
                                         _f = recordUpdateCount;
-                                        return [4 /*yield*/, this_2.dbDriver.runDml(generateUpdate, this_2.transactionForDriver())];
+                                        return [4 /*yield*/, this_2.dbDriver.runDml(generateUpdate, this_2.transactionForDriver(), options)];
                                     case 2:
                                         recordUpdateCount = _f + _g.sent();
                                         return [4 /*yield*/, tokenMaintenance.afterUpdate(table, ids, recordCopy, owner, this_2.newSystemDb())];
@@ -1579,6 +1626,18 @@ var Db = /** @class */ (function () {
         }
         return context.currentTransaction;
     };
+    /**
+     * A write's transaction options as the driver takes them: its own, when the write runs outside
+     * any transaction and so is a transaction of its own. Inside a transaction the write rides the
+     * transaction, whose policy was named on `runTransaction`; a policy named on the write would be
+     * one nothing honours — refused by name, never dropped.
+     */
+    Db.prototype.ownTransactionOptions = function (options) {
+        if ((options === null || options === void 0 ? void 0 : options.retry) !== undefined && this.transactionContextFactory.getTransactionContext().currentTransaction) {
+            throw new Error("A write inside a transaction cannot name a retry policy of its own: the transaction's policy (runTransaction's options) governs every write in it");
+        }
+        return options;
+    };
     /**
      * The rows of one multi-row insert split into the fewest statements the driver's statement
      * parameter bound admits (`insertMany`): each statement binds `columns × rows` parameters,