@fragno-dev/db 0.1.14 → 0.2.0

package/dist/query/serialize/sql-serializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-serializer.js","names":[],"sources":["../../../src/query/serialize/sql-serializer.ts"],"sourcesContent":["import type { DriverConfig } from \"../../adapters/generic-sql/driver-config\";\nimport type { AnyColumn } from \"../../schema/create\";\n\n/**\n * Abstract base class for SQL value serialization/deserialization.\n *\n * Similar to SQLTypeMapper, this class provides a framework for converting values\n * between application format and database format. Each database dialect extends\n * this class and implements abstract methods for dialect-specific conversions.\n *\n * Handles:\n * - Type conversions (Date, boolean, BigInt, etc.)\n * - JSON handling (delegated to dialect-specific implementations)\n * - Binary data conversion (Uint8Array ↔ Buffer)\n */\nexport abstract class SQLSerializer {\n  protected readonly driverConfig: DriverConfig;\n\n  constructor(driverConfig: DriverConfig) {\n    this.driverConfig = driverConfig;\n  }\n\n  /**\n   * Deserialize a value from database format to application format.\n   *\n   * @param value - The raw database value\n   * @param col - The column schema definition\n   * @returns The deserialized value in application format\n   * @throws Error if value cannot be deserialized to the expected type\n   */\n  deserialize(value: unknown, col: AnyColumn): unknown {\n    if (value === null) {\n      return null;\n    }\n\n    // Handle JSON deserialization (delegated to subclass)\n    if (col.type === \"json\") {\n      return this.deserializeJson(value);\n    }\n\n    // Handle date/timestamp deserialization\n    if (col.type === \"timestamp\" || col.type === \"date\") {\n      return this.deserializeDate(value);\n    }\n\n    // Handle boolean deserialization\n    if (col.type === \"bool\") {\n      return this.deserializeBoolean(value);\n    }\n\n    // Handle bigint deserialization\n    if (col.type === \"bigint\") {\n      return this.deserializeBigInt(value);\n    }\n\n    // Handle binary deserialization (delegated to subclass for driver flexibility)\n    if (col.type === \"binary\") {\n      return this.deserializeBinary(value);\n    }\n\n    // Handle integer deserialization (delegated to subclass - drivers may return string/bigint)\n    if (col.type === \"integer\") {\n      return this.deserializeInteger(value);\n    }\n\n    // Handle decimal deserialization (delegated to subclass for driver flexibility)\n    if (col.type === \"decimal\") {\n      return this.deserializeDecimal(value);\n    }\n\n    // Handle string/varchar deserialization (delegated to subclass for consistency)\n    if (col.type === \"string\" || (typeof col.type === \"string\" && col.type.startsWith(\"varchar\"))) {\n      return this.deserializeString(value);\n    }\n\n    throw new Error(`Unsupported column type for deserialization: ${col.type}`);\n  }\n\n  /**\n   * Serialize a value from application format to database format.\n   *\n   * Note: This method expects FragnoId/FragnoReference objects to be resolved\n   * to primitive values before calling. Use resolveFragnoIdValue() from\n   * value-encoding.ts for this purpose.\n   *\n   * @param value - The application value to serialize (should not be FragnoId/FragnoReference)\n   * @param col - The column schema definition\n   * @param skipDriverConversions - Skip driver-level type conversions (Date->number, boolean->0/1, bigint->Buffer).\n   *                                 Set to true when using ORMs like Drizzle that handle these conversions internally.\n   * @returns The serialized value in database format\n   */\n  serialize(value: unknown, col: AnyColumn, skipDriverConversions = false): unknown {\n    if (value === null) {\n      return null;\n    }\n\n    // Handle JSON serialization (delegated to subclass)\n    if (col.type === \"json\") {\n      return this.serializeJson(value);\n    }\n\n    // Skip driver-specific type conversions when using ORMs that handle them internally\n    if (!skipDriverConversions) {\n      // Handle date/timestamp serialization\n      if (value instanceof Date) {\n        return this.serializeDate(value);\n      }\n\n      // Handle boolean serialization\n      if (typeof value === \"boolean\") {\n        return this.serializeBoolean(value);\n      }\n\n      // Handle bigint serialization\n      if (typeof value === \"bigint\") {\n        return this.serializeBigInt(value, col);\n      }\n    }\n\n    // Handle binary serialization (most drivers accept Buffer)\n    if (col.type === \"binary\" && value instanceof Uint8Array) {\n      return Buffer.from(value);\n    }\n\n    return value;\n  }\n\n  // Abstract methods for dialect-specific serialization\n  protected abstract serializeDate(value: Date): Date | number;\n  protected abstract serializeBoolean(value: boolean): boolean | number;\n  protected abstract serializeBigInt(value: bigint, col: AnyColumn): bigint | number | Buffer;\n  protected abstract serializeJson(value: unknown): unknown;\n\n  // Abstract methods for dialect-specific deserialization\n  protected abstract deserializeDate(value: unknown): Date;\n  protected abstract deserializeBoolean(value: unknown): boolean;\n  protected abstract deserializeBigInt(value: unknown): bigint;\n  protected abstract deserializeJson(value: unknown): unknown;\n  protected abstract deserializeBinary(value: unknown): Uint8Array;\n  protected abstract deserializeInteger(value: unknown): number;\n  protected abstract deserializeDecimal(value: unknown): number;\n  protected abstract deserializeString(value: unknown): string;\n}\n"],"mappings":";;;;;;;;;;;;;AAeA,IAAsB,gBAAtB,MAAoC;CAClC,AAAmB;CAEnB,YAAY,cAA4B;AACtC,OAAK,eAAe;;;;;;;;;;CAWtB,YAAY,OAAgB,KAAyB;AACnD,MAAI,UAAU,KACZ,QAAO;AAIT,MAAI,IAAI,SAAS,OACf,QAAO,KAAK,gBAAgB,MAAM;AAIpC,MAAI,IAAI,SAAS,eAAe,IAAI,SAAS,OAC3C,QAAO,KAAK,gBAAgB,MAAM;AAIpC,MAAI,IAAI,SAAS,OACf,QAAO,KAAK,mBAAmB,MAAM;AAIvC,MAAI,IAAI,SAAS,SACf,QAAO,KAAK,kBAAkB,MAAM;AAItC,MAAI,IAAI,SAAS,SACf,QAAO,KAAK,kBAAkB,MAAM;AAItC,MAAI,IAAI,SAAS,UACf,QAAO,KAAK,mBAAmB,MAAM;AAIvC,MAAI,IAAI,SAAS,UACf,QAAO,KAAK,mBAAmB,MAAM;AAIvC,MAAI,IAAI,SAAS,YAAa,OAAO,IAAI,SAAS,YAAY,IAAI,KAAK,WAAW,UAAU,CAC1F,QAAO,KAAK,kBAAkB,MAAM;AAGtC,QAAM,IAAI,MAAM,gDAAgD,IAAI,OAAO;;;;;;;;;;;;;;;CAgB7E,UAAU,OAAgB,KAAgB,wBAAwB,OAAgB;AAChF,MAAI,UAAU,KACZ,QAAO;AAIT,MAAI,IAAI,SAAS,OACf,QAAO,KAAK,cAAc,MAAM;AAIlC,MAAI,CAAC,uBAAuB;AAE1B,OAAI,iBAAiB,KACnB,QAAO,KAAK,cAAc,MAAM;AAIlC,OAAI,OAAO,UAAU,UACnB,QAAO,KAAK,iBAAiB,MAAM;AAIrC,OAAI,OAAO,UAAU,SACnB,QAAO,KAAK,gBAAgB,OAAO,IAAI;;AAK3C,MAAI,IAAI,SAAS,YAAY,iBAAiB,WAC5C,QAAO,OAAO,KAAK,MAAM;AAG3B,SAAO"}

package/dist/query/{query.d.ts → simple-query-interface.d.ts}

@@ -2,9 +2,9 @@ import { AnySchema, AnyTable, FragnoId, IdColumn, Relation } from "../schema/cre
 import { Condition, ConditionBuilder } from "./condition-builder.js";
 import { CursorResult } from "./cursor.js";
 import { Prettify } from "../util/types.js";
-import { DeleteBuilder, FindBuilder, UnitOfWork, UpdateBuilder, UpdateManyBuilder } from "./unit-of-work.js";
+import { DeleteBuilder, FindBuilder, TypedUnitOfWork, UpdateBuilder, UpdateManyBuilder } from "./unit-of-work/unit-of-work.js";
 
-//#region src/query/query.d.ts
+//#region src/query/simple-query-interface.d.ts
 type AnySelectClause = SelectClause<AnyTable>;
 type SelectClause<T extends AnyTable> = true | (keyof T["columns"])[];
 type RawColumnValues<T extends AnyTable> = { [K in keyof T["columns"] as string extends K ? never : K]: T["columns"][K]["$out"] };
@@ -42,7 +42,7 @@ type FindManyOptions<T extends AnyTable = AnyTable, Select extends SelectClause<
 } & (IsRoot extends true ? {
   offset?: number;
 } : {});
-interface AbstractQuery<TSchema extends AnySchema, TUOWConfig = void> {
+interface SimpleQueryInterface<TSchema extends AnySchema, TUOWConfig = void> {
   /**
    * Find multiple records using a builder pattern
    */
@@ -93,8 +93,8 @@ interface AbstractQuery<TSchema extends AnySchema, TUOWConfig = void> {
   /**
    * Create a Unit of Work bound to this query engine
    */
-  createUnitOfWork: (name?: string, config?: TUOWConfig) => UnitOfWork<TSchema, []>;
+  createUnitOfWork: (name?: string, config?: TUOWConfig) => TypedUnitOfWork<TSchema, [], unknown>;
 }
 //#endregion
-export { AbstractQuery, AnySelectClause, ExtractJoinOut, ExtractSelect, FindFirstOptions, FindManyOptions, JoinBuilder, OrderBy, RawColumnValues, SelectClause, SelectResult, TableToColumnValues, TableToInsertValues, TableToUpdateValues };
-//# sourceMappingURL=query.d.ts.map
+export { AnySelectClause, ExtractJoinOut, ExtractSelect, FindFirstOptions, FindManyOptions, JoinBuilder, OrderBy, RawColumnValues, SelectClause, SelectResult, SimpleQueryInterface, TableToColumnValues, TableToInsertValues, TableToUpdateValues };
+//# sourceMappingURL=simple-query-interface.d.ts.map

package/dist/query/simple-query-interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simple-query-interface.d.ts","names":[],"sources":["../../src/query/simple-query-interface.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/query/unit-of-work/execute-unit-of-work.d.ts

@@ -0,0 +1,133 @@
+import { AnySchema, FragnoId } from "../../schema/create.js";
+import { RetryPolicy } from "./retry-policy.js";
+import { IUnitOfWork, TypedUnitOfWork } from "./unit-of-work.js";
+
+//#region src/query/unit-of-work/execute-unit-of-work.d.ts
+
+/**
+ * Type utility that unwraps promises 1 level deep in objects, arrays, or direct promises
+ * Handles tuples, arrays, objects, and direct promises
+ */
+type AwaitedPromisesInObject<T> = T extends Promise<infer U> ? Awaited<U> : T extends readonly [unknown, ...unknown[]] ? { [K in keyof T]: AwaitedPromisesInObject<T[K]> } : T extends [unknown, ...unknown[]] ? { [K in keyof T]: AwaitedPromisesInObject<T[K]> } : T extends (infer U)[] ? Awaited<U>[] : T extends readonly (infer U)[] ? readonly Awaited<U>[] : T extends Record<string, unknown> ? { [K in keyof T]: T[K] extends Promise<infer U> ? Awaited<U> : T[K] } : T;
+/**
+ * Result of executing a Unit of Work with retry support
+ * Promises in mutationResult are unwrapped 1 level deep
+ */
+type ExecuteUnitOfWorkResult<TRetrievalResults, TMutationResult> = {
+  success: true;
+  results: TRetrievalResults;
+  mutationResult: AwaitedPromisesInObject<TMutationResult>;
+  createdIds: FragnoId[];
+  nonce: string;
+} | {
+  success: false;
+  reason: "conflict";
+} | {
+  success: false;
+  reason: "aborted";
+} | {
+  success: false;
+  reason: "error";
+  error: unknown;
+};
+/**
+ * Callbacks for executing a Unit of Work
+ */
+interface ExecuteUnitOfWorkCallbacks<TSchema extends AnySchema, TRetrievalResults extends unknown[], TMutationResult, TRawInput> {
+  /**
+   * Retrieval phase callback - adds retrieval operations to the UOW
+   */
+  retrieve?: (uow: TypedUnitOfWork<TSchema, [], TRawInput>) => TypedUnitOfWork<TSchema, TRetrievalResults, TRawInput>;
+  /**
+   * Mutation phase callback - receives UOW and retrieval results, adds mutation operations
+   */
+  mutate?: (uow: TypedUnitOfWork<TSchema, TRetrievalResults, TRawInput>, results: TRetrievalResults) => TMutationResult | Promise<TMutationResult>;
+  /**
+   * Success callback - invoked after successful execution
+   * Promises in mutationResult are already unwrapped 1 level deep
+   */
+  onSuccess?: (result: {
+    results: TRetrievalResults;
+    mutationResult: AwaitedPromisesInObject<TMutationResult>;
+    createdIds: FragnoId[];
+    nonce: string;
+  }) => void | Promise<void>;
+}
+/**
+ * Options for executing a Unit of Work
+ */
+interface ExecuteUnitOfWorkOptions<TSchema extends AnySchema, TRawInput> {
+  /**
+   * Factory function that creates or resets a UOW instance for each attempt
+   */
+  createUnitOfWork: () => TypedUnitOfWork<TSchema, [], TRawInput>;
+  /**
+   * Retry policy for handling optimistic concurrency conflicts
+   */
+  retryPolicy?: RetryPolicy;
+  /**
+   * Abort signal to cancel execution
+   */
+  signal?: AbortSignal;
+}
+/**
+ * Execute a Unit of Work with automatic retry support for optimistic concurrency conflicts.
+ *
+ * This function orchestrates the two-phase execution (retrieval + mutation) with retry logic.
+ * It creates fresh UOW instances for each attempt.
+ *
+ * @param callbacks - Object containing retrieve, mutate, and onSuccess callbacks
+ * @param options - Configuration including UOW factory, retry policy, and abort signal
+ * @returns Promise resolving to the execution result
+ *
+ * @example
+ * ```ts
+ * const result = await executeUnitOfWork(
+ *   {
+ *     retrieve: (uow) => uow.find("users", (b) => b.whereIndex("primary")),
+ *     mutate: (uow, [users]) => {
+ *       const user = users[0];
+ *       uow.update("users", user.id, (b) => b.set({ balance: newBalance }));
+ *     },
+ *     onSuccess: async ({ results, mutationResult }) => {
+ *       console.log("Update successful!");
+ *     }
+ *   },
+ *   {
+ *     createUnitOfWork: () => queryEngine.createUnitOfWork(),
+ *     retryPolicy: new ExponentialBackoffRetryPolicy({ maxRetries: 3 })
+ *   }
+ * );
+ * ```
+ */
+declare function executeUnitOfWork<TSchema extends AnySchema, TRetrievalResults extends unknown[], TMutationResult = void, TRawInput = unknown>(callbacks: ExecuteUnitOfWorkCallbacks<TSchema, TRetrievalResults, TMutationResult, TRawInput>, options: ExecuteUnitOfWorkOptions<TSchema, TRawInput>): Promise<ExecuteUnitOfWorkResult<TRetrievalResults, TMutationResult>>;
+/**
+ * Options for executing a Unit of Work with restricted access
+ */
+interface ExecuteRestrictedUnitOfWorkOptions {
+  /**
+   * Factory function that creates or resets a UOW instance for each attempt
+   */
+  createUnitOfWork: () => IUnitOfWork;
+  /**
+   * Retry policy for handling optimistic concurrency conflicts
+   */
+  retryPolicy?: RetryPolicy;
+  /**
+   * Abort signal to cancel execution
+   */
+  signal?: AbortSignal;
+  /**
+   * Callback invoked before mutations are executed.
+   * Use this to add additional mutation operations (e.g., hook event records).
+   */
+  onBeforeMutate?: (uow: IUnitOfWork) => void;
+  /**
+   * Callback invoked after successful mutation phase.
+   * Use this for post-mutation processing like hook execution.
+   */
+  onSuccess?: (uow: IUnitOfWork) => Promise<void>;
+}
+//#endregion
+export { AwaitedPromisesInObject, ExecuteRestrictedUnitOfWorkOptions, ExecuteUnitOfWorkCallbacks, ExecuteUnitOfWorkOptions, ExecuteUnitOfWorkResult, executeUnitOfWork };
+//# sourceMappingURL=execute-unit-of-work.d.ts.map

package/dist/query/unit-of-work/execute-unit-of-work.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-unit-of-work.d.ts","names":[],"sources":["../../../src/query/unit-of-work/execute-unit-of-work.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;AA6BwB,KARZ,uBAQY,CAAA,CAAA,CAAA,GANtB,CAMsB,SANZ,OAMY,CAAA,KAAA,EAAA,CAAA,GALlB,OAKkB,CALV,CAKU,CAAA,GAHlB,CAGkB,SAAA,SAAA,CAAA,OAAA,EAAA,GAAA,OAAA,EAAA,CAAA,GAAA,QAA4B,MAF9B,CAE8B,GAF1B,uBAE0B,CAFF,CAEE,CAFA,CAEA,CAAA,CAAA,EAAE,GAD9C,CAC8C,SAAA,CAAA,OAAA,EAAA,GAAA,OAAA,EAAA,CAAA,GAAA,QAA1B,MAAJ,CAAI,GAAA,uBAAA,CAAwB,CAAxB,CAA0B,CAA1B,CAAA,CAAA,EAElB,GAAA,CAAA,SAAA,CAAA,KAAA,EAAA,CAAA,EAAA,GACE,OADF,CACU,CADV,CAAA,EAAA,GAEE,CAFF,SAAA,SAAA,CAAA,KAAA,EAAA,CAAA,EAAA,GAAA,SAGa,OAHb,CAGqB,CAHrB,CAAA,EAAA,GAKI,CALJ,SAKc,MALd,CAAA,MAAA,EAAA,OAAA,CAAA,GAAA,QACU,MAMU,CANV,GAMc,CANd,CAMgB,CANhB,CAAA,SAM2B,OAN3B,CAAA,KAAA,EAAA,CAAA,GAM8C,OAN9C,CAMsD,CANtD,CAAA,GAM2D,CAN3D,CAM6D,CAN7D,CAAA,EAAR,GASI,CATJ;;;;;AAIY,KAqDZ,uBArDY,CAAA,iBAAA,EAAA,eAAA,CAAA,GAAA;EAEM,OAAA,EAAA,IAAA;EAAI,OAAA,EAsDnB,iBAtDmB;EAAE,cAAA,EAuDd,uBAvDc,CAuDU,eAvDV,CAAA;EAAW,UAAA,EAwD7B,QAxD6B,EAAA;EAA2B,KAAA,EAAA,MAAA;CAAR,GAAA;EAAa,OAAA,EAAA,KAAA;EAAE,MAAA,EAAA,UAAA;CAGjE,GAAA;EAAC,OAAA,EAAA,KAAA;EAgDL,MAAA,EAAA,SAAA;CAGG,GAAA;EAC+B,OAAA,EAAA,KAAA;EAAxB,MAAA,EAAA,OAAA;EACJ,KAAA,EAAA,OAAA;CAAQ;AAoB1B;;;AAUsC,UAVrB,0BAUqB,CAAA,gBATpB,SASoB,EAAA,0BAAA,OAAA,EAAA,EAAA,eAAA,EAAA,SAAA,CAAA,CAAA;EAA7B;;;EAC0C,QAAA,CAAA,EAAA,CAAA,GAAA,EAD1C,eAC0C,CAD1B,OAC0B,EAAA,EAAA,EADb,SACa,CAAA,EAAA,GAA5C,eAA4C,CAA5B,OAA4B,EAAnB,iBAAmB,EAAA,SAAA,CAAA;EAA5C;;;EAM8C,MAAA,CAAA,EAAA,CAAA,GAAA,EAA5C,eAA4C,CAA5B,OAA4B,EAAnB,iBAAmB,EAAA,SAAA,CAAA,EAAA,OAAA,EACxC,iBADwC,EAAA,GAE9C,eAF8C,GAE5B,OAF4B,CAEpB,eAFoB,CAAA;EAA5C;;;;EAEgB,SAAA,CAAA,EAAA,CAAA,MAAA,EAAA;IAOZ,OAAA,EAAA,iBAAA;IAC+B,cAAA,EAAxB,uBAAwB,CAAA,eAAA,CAAA;IAAxB,UAAA,EACJ,QADI,EAAA;IACJ,KAAA,EAAA,MAAA;EAED,CAAA,EAAA,GAAA,IAAA,GAAA,OAAA,CAAA,IAAA,CAAA;;AAMf;;;AAIuD,UAJtC,wBAIsC,CAAA,gBAJG,SAIH,EAAA,SAAA,CAAA,CAAA;EAA7B;;;EAUJ,gBAAA,EAAA,GAAA,GAVI,eAUJ,CAVoB,OAUpB,EAAA,EAAA,EAViC,SAUjC,CAAA;EA8DA;;;EAM2B,WAAA,CAAA,EAzEjC,WAyEiC;EAAmB;;;EAChC,MAAA,CAAA,EArEzB,WAqEyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAPd,kCACJ,wGAKL,2BAA2B,SAAS,mBAAmB,iBAAiB,qBAC1E,yBAAyB,SAAS,aAC1C,QAAQ,wBAAwB,mBAAmB;;;;UA+FrC,kCAAA;;;;0BAIS;;;;gBAKV;;;;WAKL;;;;;yBAMc;;;;;oBAML,gBAAgB"}

package/dist/query/unit-of-work/execute-unit-of-work.js

@@ -0,0 +1,197 @@
+import { ExponentialBackoffRetryPolicy, NoRetryPolicy } from "./retry-policy.js";
+
+//#region src/query/unit-of-work/execute-unit-of-work.ts
+/**
+* Error thrown when a Unit of Work execution fails due to optimistic concurrency conflict.
+* This error triggers automatic retry behavior in executeRestrictedUnitOfWork.
+*/
+var ConcurrencyConflictError = class extends Error {
+	constructor(message = "Optimistic concurrency conflict detected") {
+		super(message);
+		this.name = "ConcurrencyConflictError";
+	}
+};
+/**
+* Await promises in an object 1 level deep
+*/
+async function awaitPromisesInObject(obj) {
+	if (obj === null || obj === void 0) return obj;
+	if (typeof obj !== "object") return obj;
+	if (obj instanceof Promise) return await obj;
+	if (Array.isArray(obj)) return await Promise.all(obj.map((item) => item instanceof Promise ? item : Promise.resolve(item)));
+	const result = {};
+	const entries = Object.entries(obj);
+	const awaitedEntries = await Promise.all(entries.map(async ([key, value]) => {
+		return [key, value instanceof Promise ? await value : value];
+	}));
+	for (const [key, value] of awaitedEntries) result[key] = value;
+	return result;
+}
+/**
+* Execute a Unit of Work with automatic retry support for optimistic concurrency conflicts.
+*
+* This function orchestrates the two-phase execution (retrieval + mutation) with retry logic.
+* It creates fresh UOW instances for each attempt.
+*
+* @param callbacks - Object containing retrieve, mutate, and onSuccess callbacks
+* @param options - Configuration including UOW factory, retry policy, and abort signal
+* @returns Promise resolving to the execution result
+*
+* @example
+* ```ts
+* const result = await executeUnitOfWork(
+*   {
+*     retrieve: (uow) => uow.find("users", (b) => b.whereIndex("primary")),
+*     mutate: (uow, [users]) => {
+*       const user = users[0];
+*       uow.update("users", user.id, (b) => b.set({ balance: newBalance }));
+*     },
+*     onSuccess: async ({ results, mutationResult }) => {
+*       console.log("Update successful!");
+*     }
+*   },
+*   {
+*     createUnitOfWork: () => queryEngine.createUnitOfWork(),
+*     retryPolicy: new ExponentialBackoffRetryPolicy({ maxRetries: 3 })
+*   }
+* );
+* ```
+*/
+async function executeUnitOfWork(callbacks, options) {
+	if (!callbacks.retrieve && !callbacks.mutate) throw new Error("At least one of 'retrieve' or 'mutate' callbacks must be provided");
+	const retryPolicy = options.retryPolicy ?? new NoRetryPolicy();
+	const signal = options.signal;
+	let attempt = 0;
+	while (true) {
+		if (signal?.aborted) return {
+			success: false,
+			reason: "aborted"
+		};
+		try {
+			const uow = options.createUnitOfWork();
+			let retrievalUow;
+			if (callbacks.retrieve) retrievalUow = callbacks.retrieve(uow);
+			else retrievalUow = uow;
+			const results = await retrievalUow.executeRetrieve();
+			let mutationResult;
+			if (callbacks.mutate) mutationResult = await callbacks.mutate(retrievalUow, results);
+			else mutationResult = void 0;
+			const { success } = await retrievalUow.executeMutations();
+			if (success) {
+				const createdIds = retrievalUow.getCreatedIds();
+				const nonce = retrievalUow.nonce;
+				const awaitedMutationResult = await awaitPromisesInObject(mutationResult);
+				if (callbacks.onSuccess) await callbacks.onSuccess({
+					results,
+					mutationResult: awaitedMutationResult,
+					createdIds,
+					nonce
+				});
+				return {
+					success: true,
+					results,
+					mutationResult: awaitedMutationResult,
+					createdIds,
+					nonce
+				};
+			}
+			if (!retryPolicy.shouldRetry(attempt, void 0, signal)) return {
+				success: false,
+				reason: "conflict"
+			};
+			const delayMs = retryPolicy.getDelayMs(attempt);
+			if (delayMs > 0) await new Promise((resolve) => setTimeout(resolve, delayMs));
+			attempt++;
+		} catch (error) {
+			return {
+				success: false,
+				reason: "error",
+				error
+			};
+		}
+	}
+}
+/**
+* Execute a Unit of Work with explicit phase control and automatic retry support.
+*
+* This function provides an alternative API where users write a single callback that receives
+* a context object with forSchema, executeRetrieve, and executeMutate methods. The user can
+* create schema-specific UOWs via forSchema, then call executeRetrieve() and executeMutate()
+* to execute the retrieval and mutation phases. The entire callback is re-executed on optimistic
+* concurrency conflicts, ensuring retries work properly.
+*
+* @param callback - Async function that receives a context with forSchema, executeRetrieve, executeMutate, nonce, and currentAttempt
+* @param options - Configuration including UOW factory, retry policy, and abort signal
+* @returns Promise resolving to the callback's return value
+* @throws Error if retries are exhausted or callback throws an error
+*
+* @example
+* ```ts
+* const { userId, profileId } = await executeRestrictedUnitOfWork(
+*   async ({ forSchema, executeRetrieve, executeMutate, nonce, currentAttempt }) => {
+*     const uow = forSchema(schema);
+*     const userId = uow.create("users", { name: "John" });
+*
+*     // Execute retrieval phase
+*     await executeRetrieve();
+*
+*     const profileId = uow.create("profiles", { userId });
+*
+*     // Execute mutation phase
+*     await executeMutate();
+*
+*     return { userId, profileId };
+*   },
+*   {
+*     createUnitOfWork: () => db.createUnitOfWork(),
+*     retryPolicy: new ExponentialBackoffRetryPolicy({ maxRetries: 5 })
+*   }
+* );
+* ```
+*/
+async function executeRestrictedUnitOfWork(callback, options) {
+	const retryPolicy = options.retryPolicy ?? new ExponentialBackoffRetryPolicy({
+		maxRetries: 5,
+		initialDelayMs: 10,
+		maxDelayMs: 100
+	});
+	const signal = options.signal;
+	let attempt = 0;
+	while (true) {
+		if (signal?.aborted) throw new Error("Unit of Work execution aborted");
+		try {
+			const baseUow = options.createUnitOfWork();
+			return await awaitPromisesInObject(await callback({
+				forSchema: (schema, hooks) => {
+					return baseUow.forSchema(schema, hooks);
+				},
+				executeRetrieve: async () => {
+					await baseUow.executeRetrieve();
+				},
+				executeMutate: async () => {
+					if (baseUow.state === "executed") return;
+					if (baseUow.state === "building-retrieval") await baseUow.executeRetrieve();
+					if (options.onBeforeMutate) options.onBeforeMutate(baseUow);
+					if (!(await baseUow.executeMutations()).success) throw new ConcurrencyConflictError();
+					if (options.onSuccess) await options.onSuccess(baseUow);
+				},
+				nonce: baseUow.nonce,
+				currentAttempt: attempt
+			}));
+		} catch (error) {
+			if (signal?.aborted) throw new Error("Unit of Work execution aborted");
+			if (!(error instanceof ConcurrencyConflictError)) throw error;
+			if (!retryPolicy.shouldRetry(attempt, error, signal)) {
+				if (signal?.aborted) throw new Error("Unit of Work execution aborted");
+				throw new Error("Unit of Work execution failed: optimistic concurrency conflict", { cause: error });
+			}
+			const delayMs = retryPolicy.getDelayMs(attempt);
+			if (delayMs > 0) await new Promise((resolve) => setTimeout(resolve, delayMs));
+			attempt++;
+		}
+	}
+}
+
+//#endregion
+export { executeRestrictedUnitOfWork, executeUnitOfWork };
+//# sourceMappingURL=execute-unit-of-work.js.map

package/dist/query/unit-of-work/execute-unit-of-work.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-unit-of-work.js","names":["retrievalUow: TypedUnitOfWork<TSchema, TRetrievalResults, TRawInput>","mutationResult: TMutationResult"],"sources":["../../../src/query/unit-of-work/execute-unit-of-work.ts"],"sourcesContent":["import type { AnySchema } from \"../../schema/create\";\nimport type { TypedUnitOfWork, IUnitOfWork } from \"./unit-of-work\";\nimport type { HooksMap } from \"../../hooks/hooks\";\nimport { NoRetryPolicy, ExponentialBackoffRetryPolicy, type RetryPolicy } from \"./retry-policy\";\nimport type { FragnoId } from \"../../schema/create\";\n\n/**\n * Error thrown when a Unit of Work execution fails due to optimistic concurrency conflict.\n * This error triggers automatic retry behavior in executeRestrictedUnitOfWork.\n */\nexport class ConcurrencyConflictError extends Error {\n  constructor(message = \"Optimistic concurrency conflict detected\") {\n    super(message);\n    this.name = \"ConcurrencyConflictError\";\n  }\n}\n\n/**\n * Type utility that unwraps promises 1 level deep in objects, arrays, or direct promises\n * Handles tuples, arrays, objects, and direct promises\n */\nexport type AwaitedPromisesInObject<T> =\n  // First check if it's a Promise\n  T extends Promise<infer U>\n    ? Awaited<U>\n    : // Check for arrays with known length (tuples) - preserves tuple structure\n      T extends readonly [unknown, ...unknown[]]\n      ? { [K in keyof T]: AwaitedPromisesInObject<T[K]> }\n      : T extends [unknown, ...unknown[]]\n        ? { [K in keyof T]: AwaitedPromisesInObject<T[K]> }\n        : // Check for regular arrays (unknown length)\n          T extends (infer U)[]\n          ? Awaited<U>[]\n          : T extends readonly (infer U)[]\n            ? readonly Awaited<U>[]\n            : // Check for objects\n              T extends Record<string, unknown>\n              ? {\n                  [K in keyof T]: T[K] extends Promise<infer U> ? Awaited<U> : T[K];\n                }\n              : // Otherwise return as-is\n                T;\n\n/**\n * Await promises in an object 1 level deep\n */\nasync function awaitPromisesInObject<T>(obj: T): Promise<AwaitedPromisesInObject<T>> {\n  if (obj === null || obj === undefined) {\n    return obj as AwaitedPromisesInObject<T>;\n  }\n\n  if (typeof obj !== \"object\") {\n    return obj as AwaitedPromisesInObject<T>;\n  }\n\n  // Check if it's a Promise\n  if (obj instanceof Promise) {\n    return (await obj) as AwaitedPromisesInObject<T>;\n  }\n\n  // Check if it's an array\n  if (Array.isArray(obj)) {\n    const awaited = await Promise.all(\n      obj.map((item) => (item instanceof Promise ? item : Promise.resolve(item))),\n    );\n    return awaited as AwaitedPromisesInObject<T>;\n  }\n\n  // It's a plain object - await promises in each property\n  const result = {} as T;\n  const entries = Object.entries(obj as Record<string, unknown>);\n  const awaitedEntries = await Promise.all(\n    entries.map(async ([key, value]) => {\n      const awaitedValue = value instanceof Promise ? await value : value;\n      return [key, awaitedValue] as const;\n    }),\n  );\n\n  for (const [key, value] of awaitedEntries) {\n    (result as Record<string, unknown>)[key] = value;\n  }\n\n  return result as AwaitedPromisesInObject<T>;\n}\n\n/**\n * Result of executing a Unit of Work with retry support\n * Promises in mutationResult are unwrapped 1 level deep\n */\nexport type ExecuteUnitOfWorkResult<TRetrievalResults, TMutationResult> =\n  | {\n      success: true;\n      results: TRetrievalResults;\n      mutationResult: AwaitedPromisesInObject<TMutationResult>;\n      createdIds: FragnoId[];\n      nonce: string;\n    }\n  | {\n      success: false;\n      reason: \"conflict\";\n    }\n  | {\n      success: false;\n      reason: \"aborted\";\n    }\n  | {\n      success: false;\n      reason: \"error\";\n      error: unknown;\n    };\n\n/**\n * Callbacks for executing a Unit of Work\n */\nexport interface ExecuteUnitOfWorkCallbacks<\n  TSchema extends AnySchema,\n  TRetrievalResults extends unknown[],\n  TMutationResult,\n  TRawInput,\n> {\n  /**\n   * Retrieval phase callback - adds retrieval operations to the UOW\n   */\n  retrieve?: (\n    uow: TypedUnitOfWork<TSchema, [], TRawInput>,\n  ) => TypedUnitOfWork<TSchema, TRetrievalResults, TRawInput>;\n\n  /**\n   * Mutation phase callback - receives UOW and retrieval results, adds mutation operations\n   */\n  mutate?: (\n    uow: TypedUnitOfWork<TSchema, TRetrievalResults, TRawInput>,\n    results: TRetrievalResults,\n  ) => TMutationResult | Promise<TMutationResult>;\n\n  /**\n   * Success callback - invoked after successful execution\n   * Promises in mutationResult are already unwrapped 1 level deep\n   */\n  onSuccess?: (result: {\n    results: TRetrievalResults;\n    mutationResult: AwaitedPromisesInObject<TMutationResult>;\n    createdIds: FragnoId[];\n    nonce: string;\n  }) => void | Promise<void>;\n}\n\n/**\n * Options for executing a Unit of Work\n */\nexport interface ExecuteUnitOfWorkOptions<TSchema extends AnySchema, TRawInput> {\n  /**\n   * Factory function that creates or resets a UOW instance for each attempt\n   */\n  createUnitOfWork: () => TypedUnitOfWork<TSchema, [], TRawInput>;\n\n  /**\n   * Retry policy for handling optimistic concurrency conflicts\n   */\n  retryPolicy?: RetryPolicy;\n\n  /**\n   * Abort signal to cancel execution\n   */\n  signal?: AbortSignal;\n}\n\n/**\n * Create a bound version of executeUnitOfWork with a pre-configured UOW factory.\n * This is useful for handler contexts where the factory is already known.\n *\n * @param createUnitOfWork - Factory function that creates a fresh UOW instance\n * @returns A bound executeUnitOfWork function that doesn't require the factory parameter\n *\n * @example\n * ```ts\n * const boundExecute = createExecuteUnitOfWork(() => db.createUnitOfWork());\n * const result = await boundExecute({\n *   retrieve: (uow) => uow.find(\"users\", (b) => b.whereIndex(\"primary\")),\n *   mutate: (uow, [users]) => {\n *     uow.update(\"users\", users[0].id, (b) => b.set({ balance: newBalance }));\n *   }\n * });\n * ```\n */\nexport function createExecuteUnitOfWork<TSchema extends AnySchema, TRawInput>(\n  createUnitOfWork: () => TypedUnitOfWork<TSchema, [], TRawInput>,\n) {\n  return async function <TRetrievalResults extends unknown[], TMutationResult = void>(\n    callbacks: ExecuteUnitOfWorkCallbacks<TSchema, TRetrievalResults, TMutationResult, TRawInput>,\n    options?: Omit<ExecuteUnitOfWorkOptions<TSchema, TRawInput>, \"createUnitOfWork\">,\n  ): Promise<ExecuteUnitOfWorkResult<TRetrievalResults, TMutationResult>> {\n    return executeUnitOfWork(callbacks, { ...options, createUnitOfWork });\n  };\n}\n\n/**\n * Execute a Unit of Work with automatic retry support for optimistic concurrency conflicts.\n *\n * This function orchestrates the two-phase execution (retrieval + mutation) with retry logic.\n * It creates fresh UOW instances for each attempt.\n *\n * @param callbacks - Object containing retrieve, mutate, and onSuccess callbacks\n * @param options - Configuration including UOW factory, retry policy, and abort signal\n * @returns Promise resolving to the execution result\n *\n * @example\n * ```ts\n * const result = await executeUnitOfWork(\n *   {\n *     retrieve: (uow) => uow.find(\"users\", (b) => b.whereIndex(\"primary\")),\n *     mutate: (uow, [users]) => {\n *       const user = users[0];\n *       uow.update(\"users\", user.id, (b) => b.set({ balance: newBalance }));\n *     },\n *     onSuccess: async ({ results, mutationResult }) => {\n *       console.log(\"Update successful!\");\n *     }\n *   },\n *   {\n *     createUnitOfWork: () => queryEngine.createUnitOfWork(),\n *     retryPolicy: new ExponentialBackoffRetryPolicy({ maxRetries: 3 })\n *   }\n * );\n * ```\n */\nexport async function executeUnitOfWork<\n  TSchema extends AnySchema,\n  TRetrievalResults extends unknown[],\n  TMutationResult = void,\n  TRawInput = unknown,\n>(\n  callbacks: ExecuteUnitOfWorkCallbacks<TSchema, TRetrievalResults, TMutationResult, TRawInput>,\n  options: ExecuteUnitOfWorkOptions<TSchema, TRawInput>,\n): Promise<ExecuteUnitOfWorkResult<TRetrievalResults, TMutationResult>> {\n  // Validate that at least one of retrieve or mutate is provided\n  if (!callbacks.retrieve && !callbacks.mutate) {\n    throw new Error(\"At least one of 'retrieve' or 'mutate' callbacks must be provided\");\n  }\n\n  const retryPolicy = options.retryPolicy ?? new NoRetryPolicy();\n  const signal = options.signal;\n  let attempt = 0;\n\n  while (true) {\n    // Check if aborted before starting attempt\n    if (signal?.aborted) {\n      return { success: false, reason: \"aborted\" };\n    }\n\n    try {\n      // Create a fresh UOW for this attempt\n      const uow = options.createUnitOfWork();\n\n      // Apply retrieval phase if provided\n      let retrievalUow: TypedUnitOfWork<TSchema, TRetrievalResults, TRawInput>;\n      if (callbacks.retrieve) {\n        retrievalUow = callbacks.retrieve(uow);\n      } else {\n        // No retrieval phase, use empty UOW with type cast\n        // This is safe because when there's no retrieve, TRetrievalResults should be []\n        retrievalUow = uow as unknown as TypedUnitOfWork<TSchema, TRetrievalResults, TRawInput>;\n      }\n\n      // Execute retrieval phase\n      const results = (await retrievalUow.executeRetrieve()) as TRetrievalResults;\n\n      // Invoke mutation phase callback if provided\n      let mutationResult: TMutationResult;\n      if (callbacks.mutate) {\n        mutationResult = await callbacks.mutate(retrievalUow, results);\n      } else {\n        mutationResult = undefined as TMutationResult;\n      }\n\n      // Execute mutation phase\n      const { success } = await retrievalUow.executeMutations();\n\n      if (success) {\n        // Success! Get created IDs and nonce, then invoke onSuccess if provided\n        const createdIds = retrievalUow.getCreatedIds();\n        const nonce = retrievalUow.nonce;\n\n        // Await promises in mutationResult (1 level deep)\n        const awaitedMutationResult = await awaitPromisesInObject(mutationResult);\n\n        if (callbacks.onSuccess) {\n          await callbacks.onSuccess({\n            results,\n            mutationResult: awaitedMutationResult,\n            createdIds,\n            nonce,\n          });\n        }\n\n        return {\n          success: true,\n          results,\n          mutationResult: awaitedMutationResult,\n          createdIds,\n          nonce,\n        };\n      }\n\n      // Failed - check if we should retry\n      // attempt represents the number of attempts completed so far\n      if (!retryPolicy.shouldRetry(attempt, undefined, signal)) {\n        // No more retries\n        return { success: false, reason: \"conflict\" };\n      }\n\n      // Wait before retrying\n      const delayMs = retryPolicy.getDelayMs(attempt);\n      if (delayMs > 0) {\n        await new Promise((resolve) => setTimeout(resolve, delayMs));\n      }\n\n      // Increment attempt counter for next iteration\n      attempt++;\n    } catch (error) {\n      // An error was thrown during execution\n      return { success: false, reason: \"error\", error };\n    }\n  }\n}\n\n/**\n * Options for executing a Unit of Work with restricted access\n */\nexport interface ExecuteRestrictedUnitOfWorkOptions {\n  /**\n   * Factory function that creates or resets a UOW instance for each attempt\n   */\n  createUnitOfWork: () => IUnitOfWork;\n\n  /**\n   * Retry policy for handling optimistic concurrency conflicts\n   */\n  retryPolicy?: RetryPolicy;\n\n  /**\n   * Abort signal to cancel execution\n   */\n  signal?: AbortSignal;\n\n  /**\n   * Callback invoked before mutations are executed.\n   * Use this to add additional mutation operations (e.g., hook event records).\n   */\n  onBeforeMutate?: (uow: IUnitOfWork) => void;\n\n  /**\n   * Callback invoked after successful mutation phase.\n   * Use this for post-mutation processing like hook execution.\n   */\n  onSuccess?: (uow: IUnitOfWork) => Promise<void>;\n}\n\n/**\n * Execute a Unit of Work with explicit phase control and automatic retry support.\n *\n * This function provides an alternative API where users write a single callback that receives\n * a context object with forSchema, executeRetrieve, and executeMutate methods. The user can\n * create schema-specific UOWs via forSchema, then call executeRetrieve() and executeMutate()\n * to execute the retrieval and mutation phases. The entire callback is re-executed on optimistic\n * concurrency conflicts, ensuring retries work properly.\n *\n * @param callback - Async function that receives a context with forSchema, executeRetrieve, executeMutate, nonce, and currentAttempt\n * @param options - Configuration including UOW factory, retry policy, and abort signal\n * @returns Promise resolving to the callback's return value\n * @throws Error if retries are exhausted or callback throws an error\n *\n * @example\n * ```ts\n * const { userId, profileId } = await executeRestrictedUnitOfWork(\n *   async ({ forSchema, executeRetrieve, executeMutate, nonce, currentAttempt }) => {\n *     const uow = forSchema(schema);\n *     const userId = uow.create(\"users\", { name: \"John\" });\n *\n *     // Execute retrieval phase\n *     await executeRetrieve();\n *\n *     const profileId = uow.create(\"profiles\", { userId });\n *\n *     // Execute mutation phase\n *     await executeMutate();\n *\n *     return { userId, profileId };\n *   },\n *   {\n *     createUnitOfWork: () => db.createUnitOfWork(),\n *     retryPolicy: new ExponentialBackoffRetryPolicy({ maxRetries: 5 })\n *   }\n * );\n * ```\n */\nexport async function executeRestrictedUnitOfWork<TResult, THooks extends HooksMap = {}>(\n  callback: (context: {\n    forSchema: <S extends AnySchema, H extends HooksMap = THooks>(\n      schema: S,\n      hooks?: H,\n    ) => TypedUnitOfWork<S, [], unknown, H>;\n    executeRetrieve: () => Promise<void>;\n    executeMutate: () => Promise<void>;\n    nonce: string;\n    currentAttempt: number;\n  }) => Promise<TResult>,\n  options: ExecuteRestrictedUnitOfWorkOptions,\n): Promise<AwaitedPromisesInObject<TResult>> {\n  // Default retry policy with small, fast retries for optimistic concurrency\n  const retryPolicy =\n    options.retryPolicy ??\n    new ExponentialBackoffRetryPolicy({\n      maxRetries: 5,\n      initialDelayMs: 10,\n      maxDelayMs: 100,\n    });\n  const signal = options.signal;\n  let attempt = 0;\n\n  while (true) {\n    // Check if aborted before starting attempt\n    if (signal?.aborted) {\n      throw new Error(\"Unit of Work execution aborted\");\n    }\n\n    try {\n      // Create a fresh UOW for this attempt\n      const baseUow = options.createUnitOfWork();\n\n      const context = {\n        forSchema: <S extends AnySchema, H extends HooksMap = THooks>(schema: S, hooks?: H) => {\n          return baseUow.forSchema(schema, hooks);\n        },\n        executeRetrieve: async () => {\n          await baseUow.executeRetrieve();\n        },\n        executeMutate: async () => {\n          if (baseUow.state === \"executed\") {\n            return;\n          }\n\n          if (baseUow.state === \"building-retrieval\") {\n            await baseUow.executeRetrieve();\n          }\n\n          // Add hook mutations before executing\n          if (options.onBeforeMutate) {\n            options.onBeforeMutate(baseUow);\n          }\n\n          const result = await baseUow.executeMutations();\n          if (!result.success) {\n            throw new ConcurrencyConflictError();\n          }\n\n          if (options.onSuccess) {\n            await options.onSuccess(baseUow);\n          }\n        },\n        nonce: baseUow.nonce,\n        currentAttempt: attempt,\n      };\n\n      // Execute the callback which will call executeRetrieve and executeMutate\n      const result = await callback(context);\n\n      // Await promises in the result object (1 level deep)\n      const awaitedResult = await awaitPromisesInObject(result);\n\n      // Return the awaited result\n      return awaitedResult;\n    } catch (error) {\n      if (signal?.aborted) {\n        throw new Error(\"Unit of Work execution aborted\");\n      }\n\n      // Only retry concurrency conflicts, not other errors\n      if (!(error instanceof ConcurrencyConflictError)) {\n        // Not a concurrency conflict - throw immediately without retry\n        throw error;\n      }\n\n      if (!retryPolicy.shouldRetry(attempt, error, signal)) {\n        // No more retries - check again if aborted or throw conflict error\n        if (signal?.aborted) {\n          throw new Error(\"Unit of Work execution aborted\");\n        }\n        throw new Error(\"Unit of Work execution failed: optimistic concurrency conflict\", {\n          cause: error,\n        });\n      }\n\n      // Wait before retrying\n      const delayMs = retryPolicy.getDelayMs(attempt);\n      if (delayMs > 0) {\n        await new Promise((resolve) => setTimeout(resolve, delayMs));\n      }\n\n      // Increment attempt counter for next iteration\n      attempt++;\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/query/unit-of-work/retry-policy.d.ts

@@ -0,0 +1,88 @@
+//#region src/query/unit-of-work/retry-policy.d.ts
+/**
+ * Policy for retrying failed Unit of Work operations
+ */
+interface RetryPolicy {
+  /**
+   * Determines if the operation should be retried
+   * @param attempt - The current attempt number (0-indexed)
+   * @param error - Optional error from the previous attempt
+   * @param signal - Optional AbortSignal to check for cancellation
+   * @returns true if the operation should be retried, false otherwise
+   */
+  shouldRetry(attempt: number, error?: unknown, signal?: AbortSignal): boolean;
+  /**
+   * Gets the delay in milliseconds before the next retry attempt
+   * @param attempt - The current attempt number (0-indexed)
+   * @returns Delay in milliseconds
+   */
+  getDelayMs(attempt: number): number;
+}
+/**
+ * Options for exponential backoff retry policy
+ */
+interface ExponentialBackoffRetryPolicyOptions {
+  /**
+   * Maximum number of retry attempts (default: 3)
+   */
+  maxRetries?: number;
+  /**
+   * Initial delay in milliseconds (default: 100)
+   */
+  initialDelayMs?: number;
+  /**
+   * Maximum delay in milliseconds (default: 10000)
+   */
+  maxDelayMs?: number;
+  /**
+   * Multiplier for exponential backoff (default: 2)
+   */
+  backoffMultiplier?: number;
+}
+/**
+ * Exponential backoff retry policy
+ * Delay increases exponentially: initialDelay * (multiplier ^ attempt)
+ */
+declare class ExponentialBackoffRetryPolicy implements RetryPolicy {
+  #private;
+  constructor(options?: ExponentialBackoffRetryPolicyOptions);
+  shouldRetry(attempt: number, _error?: unknown, signal?: AbortSignal): boolean;
+  getDelayMs(attempt: number): number;
+}
+/**
+ * Options for linear backoff retry policy
+ */
+interface LinearBackoffRetryPolicyOptions {
+  /**
+   * Maximum number of retry attempts (default: 3)
+   */
+  maxRetries?: number;
+  /**
+   * Base delay in milliseconds (default: 100)
+   */
+  delayMs?: number;
+  /**
+   * Increment added to delay for each attempt in milliseconds (default: 100)
+   */
+  incrementMs?: number;
+}
+/**
+ * Linear backoff retry policy
+ * Delay increases linearly: delayMs + (attempt * incrementMs)
+ */
+declare class LinearBackoffRetryPolicy implements RetryPolicy {
+  #private;
+  constructor(options?: LinearBackoffRetryPolicyOptions);
+  shouldRetry(attempt: number, _error?: unknown, signal?: AbortSignal): boolean;
+  getDelayMs(attempt: number): number;
+}
+/**
+ * No retry policy - never retries failed operations
+ */
+declare class NoRetryPolicy implements RetryPolicy {
+  shouldRetry(_attempt: number, _error?: unknown, _signal?: AbortSignal): boolean;
+  getDelayMs(_attempt: number): number;
+}
+//#endregion
+export { ExponentialBackoffRetryPolicy, LinearBackoffRetryPolicy, NoRetryPolicy, RetryPolicy };
+//# sourceMappingURL=retry-policy.d.ts.map

package/dist/query/unit-of-work/retry-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-policy.d.ts","names":[],"sources":["../../../src/query/unit-of-work/retry-policy.ts"],"sourcesContent":[],"mappings":";;AAGA;AAqBA;AA0Ba,UA/CI,WAAA,CA+CJ;EAMU;;;;AA0BvB;AAqBA;;EAW0D,WAAA,CAAA,OAAA,EAAA,MAAA,EAAA,KAAA,CAAA,EAAA,OAAA,EAAA,MAAA,CAAA,EAvGD,WAuGC,CAAA,EAAA,OAAA;EAXT;;AA6BjD;;;;;;;;UA5GiB,oCAAA;;;;;;;;;;;;;;;;;;;;;;cA0BJ,6BAAA,YAAyC;;wBAM/B;0DAOmC;;;;;;UAmBzC,+BAAA;;;;;;;;;;;;;;;;;;cAqBJ,wBAAA,YAAoC;;wBAK1B;0DAMmC;;;;;;cAkB7C,aAAA,YAAyB;4DACsB"}

package/dist/query/unit-of-work/retry-policy.js

@@ -0,0 +1,61 @@
+//#region src/query/unit-of-work/retry-policy.ts
+/**
+* Exponential backoff retry policy
+* Delay increases exponentially: initialDelay * (multiplier ^ attempt)
+*/
+var ExponentialBackoffRetryPolicy = class {
+	#maxRetries;
+	#initialDelayMs;
+	#maxDelayMs;
+	#backoffMultiplier;
+	constructor(options = {}) {
+		this.#maxRetries = options.maxRetries ?? 3;
+		this.#initialDelayMs = options.initialDelayMs ?? 100;
+		this.#maxDelayMs = options.maxDelayMs ?? 1e4;
+		this.#backoffMultiplier = options.backoffMultiplier ?? 2;
+	}
+	shouldRetry(attempt, _error, signal) {
+		if (signal?.aborted) return false;
+		return attempt < this.#maxRetries;
+	}
+	getDelayMs(attempt) {
+		const delay = this.#initialDelayMs * Math.pow(this.#backoffMultiplier, attempt);
+		return Math.min(delay, this.#maxDelayMs);
+	}
+};
+/**
+* Linear backoff retry policy
+* Delay increases linearly: delayMs + (attempt * incrementMs)
+*/
+var LinearBackoffRetryPolicy = class {
+	#maxRetries;
+	#delayMs;
+	#incrementMs;
+	constructor(options = {}) {
+		this.#maxRetries = options.maxRetries ?? 3;
+		this.#delayMs = options.delayMs ?? 100;
+		this.#incrementMs = options.incrementMs ?? 100;
+	}
+	shouldRetry(attempt, _error, signal) {
+		if (signal?.aborted) return false;
+		return attempt < this.#maxRetries;
+	}
+	getDelayMs(attempt) {
+		return this.#delayMs + attempt * this.#incrementMs;
+	}
+};
+/**
+* No retry policy - never retries failed operations
+*/
+var NoRetryPolicy = class {
+	shouldRetry(_attempt, _error, _signal) {
+		return false;
+	}
+	getDelayMs(_attempt) {
+		return 0;
+	}
+};
+
+//#endregion
+export { ExponentialBackoffRetryPolicy, LinearBackoffRetryPolicy, NoRetryPolicy };
+//# sourceMappingURL=retry-policy.js.map

package/dist/query/unit-of-work/retry-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-policy.js","names":["#maxRetries","#initialDelayMs","#maxDelayMs","#backoffMultiplier","#delayMs","#incrementMs"],"sources":["../../../src/query/unit-of-work/retry-policy.ts"],"sourcesContent":["/**\n * Policy for retrying failed Unit of Work operations\n */\nexport interface RetryPolicy {\n  /**\n   * Determines if the operation should be retried\n   * @param attempt - The current attempt number (0-indexed)\n   * @param error - Optional error from the previous attempt\n   * @param signal - Optional AbortSignal to check for cancellation\n   * @returns true if the operation should be retried, false otherwise\n   */\n  shouldRetry(attempt: number, error?: unknown, signal?: AbortSignal): boolean;\n\n  /**\n   * Gets the delay in milliseconds before the next retry attempt\n   * @param attempt - The current attempt number (0-indexed)\n   * @returns Delay in milliseconds\n   */\n  getDelayMs(attempt: number): number;\n}\n\n/**\n * Options for exponential backoff retry policy\n */\nexport interface ExponentialBackoffRetryPolicyOptions {\n  /**\n   * Maximum number of retry attempts (default: 3)\n   */\n  maxRetries?: number;\n\n  /**\n   * Initial delay in milliseconds (default: 100)\n   */\n  initialDelayMs?: number;\n\n  /**\n   * Maximum delay in milliseconds (default: 10000)\n   */\n  maxDelayMs?: number;\n\n  /**\n   * Multiplier for exponential backoff (default: 2)\n   */\n  backoffMultiplier?: number;\n}\n\n/**\n * Exponential backoff retry policy\n * Delay increases exponentially: initialDelay * (multiplier ^ attempt)\n */\nexport class ExponentialBackoffRetryPolicy implements RetryPolicy {\n  readonly #maxRetries: number;\n  readonly #initialDelayMs: number;\n  readonly #maxDelayMs: number;\n  readonly #backoffMultiplier: number;\n\n  constructor(options: ExponentialBackoffRetryPolicyOptions = {}) {\n    this.#maxRetries = options.maxRetries ?? 3;\n    this.#initialDelayMs = options.initialDelayMs ?? 100;\n    this.#maxDelayMs = options.maxDelayMs ?? 10000;\n    this.#backoffMultiplier = options.backoffMultiplier ?? 2;\n  }\n\n  shouldRetry(attempt: number, _error?: unknown, signal?: AbortSignal): boolean {\n    // Check if operation was aborted\n    if (signal?.aborted) {\n      return false;\n    }\n\n    // Check if we've exceeded max retries\n    return attempt < this.#maxRetries;\n  }\n\n  getDelayMs(attempt: number): number {\n    const delay = this.#initialDelayMs * Math.pow(this.#backoffMultiplier, attempt);\n    return Math.min(delay, this.#maxDelayMs);\n  }\n}\n\n/**\n * Options for linear backoff retry policy\n */\nexport interface LinearBackoffRetryPolicyOptions {\n  /**\n   * Maximum number of retry attempts (default: 3)\n   */\n  maxRetries?: number;\n\n  /**\n   * Base delay in milliseconds (default: 100)\n   */\n  delayMs?: number;\n\n  /**\n   * Increment added to delay for each attempt in milliseconds (default: 100)\n   */\n  incrementMs?: number;\n}\n\n/**\n * Linear backoff retry policy\n * Delay increases linearly: delayMs + (attempt * incrementMs)\n */\nexport class LinearBackoffRetryPolicy implements RetryPolicy {\n  readonly #maxRetries: number;\n  readonly #delayMs: number;\n  readonly #incrementMs: number;\n\n  constructor(options: LinearBackoffRetryPolicyOptions = {}) {\n    this.#maxRetries = options.maxRetries ?? 3;\n    this.#delayMs = options.delayMs ?? 100;\n    this.#incrementMs = options.incrementMs ?? 100;\n  }\n\n  shouldRetry(attempt: number, _error?: unknown, signal?: AbortSignal): boolean {\n    // Check if operation was aborted\n    if (signal?.aborted) {\n      return false;\n    }\n\n    // Check if we've exceeded max retries\n    return attempt < this.#maxRetries;\n  }\n\n  getDelayMs(attempt: number): number {\n    return this.#delayMs + attempt * this.#incrementMs;\n  }\n}\n\n/**\n * No retry policy - never retries failed operations\n */\nexport class NoRetryPolicy implements RetryPolicy {\n  shouldRetry(_attempt: number, _error?: unknown, _signal?: AbortSignal): boolean {\n    return false;\n  }\n\n  getDelayMs(_attempt: number): number {\n    return 0;\n  }\n}\n"],"mappings":";;;;;AAkDA,IAAa,gCAAb,MAAkE;CAChE,CAASA;CACT,CAASC;CACT,CAASC;CACT,CAASC;CAET,YAAY,UAAgD,EAAE,EAAE;AAC9D,QAAKH,aAAc,QAAQ,cAAc;AACzC,QAAKC,iBAAkB,QAAQ,kBAAkB;AACjD,QAAKC,aAAc,QAAQ,cAAc;AACzC,QAAKC,oBAAqB,QAAQ,qBAAqB;;CAGzD,YAAY,SAAiB,QAAkB,QAA+B;AAE5E,MAAI,QAAQ,QACV,QAAO;AAIT,SAAO,UAAU,MAAKH;;CAGxB,WAAW,SAAyB;EAClC,MAAM,QAAQ,MAAKC,iBAAkB,KAAK,IAAI,MAAKE,mBAAoB,QAAQ;AAC/E,SAAO,KAAK,IAAI,OAAO,MAAKD,WAAY;;;;;;;AA4B5C,IAAa,2BAAb,MAA6D;CAC3D,CAASF;CACT,CAASI;CACT,CAASC;CAET,YAAY,UAA2C,EAAE,EAAE;AACzD,QAAKL,aAAc,QAAQ,cAAc;AACzC,QAAKI,UAAW,QAAQ,WAAW;AACnC,QAAKC,cAAe,QAAQ,eAAe;;CAG7C,YAAY,SAAiB,QAAkB,QAA+B;AAE5E,MAAI,QAAQ,QACV,QAAO;AAIT,SAAO,UAAU,MAAKL;;CAGxB,WAAW,SAAyB;AAClC,SAAO,MAAKI,UAAW,UAAU,MAAKC;;;;;;AAO1C,IAAa,gBAAb,MAAkD;CAChD,YAAY,UAAkB,QAAkB,SAAgC;AAC9E,SAAO;;CAGT,WAAW,UAA0B;AACnC,SAAO"}