@fragno-dev/db 0.2.0 → 0.2.2

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

@@ -1 +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":";;;;;;;AAUA,IAAa,2BAAb,cAA8C,MAAM;CAClD,YAAY,UAAU,4CAA4C;AAChE,QAAM,QAAQ;AACd,OAAK,OAAO;;;;;;AAiChB,eAAe,sBAAyB,KAA6C;AACnF,KAAI,QAAQ,QAAQ,QAAQ,OAC1B,QAAO;AAGT,KAAI,OAAO,QAAQ,SACjB,QAAO;AAIT,KAAI,eAAe,QACjB,QAAQ,MAAM;AAIhB,KAAI,MAAM,QAAQ,IAAI,CAIpB,QAHgB,MAAM,QAAQ,IAC5B,IAAI,KAAK,SAAU,gBAAgB,UAAU,OAAO,QAAQ,QAAQ,KAAK,CAAE,CAC5E;CAKH,MAAM,SAAS,EAAE;CACjB,MAAM,UAAU,OAAO,QAAQ,IAA+B;CAC9D,MAAM,iBAAiB,MAAM,QAAQ,IACnC,QAAQ,IAAI,OAAO,CAAC,KAAK,WAAW;AAElC,SAAO,CAAC,KADa,iBAAiB,UAAU,MAAM,QAAQ,MACpC;GAC1B,CACH;AAED,MAAK,MAAM,CAAC,KAAK,UAAU,eACzB,CAAC,OAAmC,OAAO;AAG7C,QAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgJT,eAAsB,kBAMpB,WACA,SACsE;AAEtE,KAAI,CAAC,UAAU,YAAY,CAAC,UAAU,OACpC,OAAM,IAAI,MAAM,oEAAoE;CAGtF,MAAM,cAAc,QAAQ,eAAe,IAAI,eAAe;CAC9D,MAAM,SAAS,QAAQ;CACvB,IAAI,UAAU;AAEd,QAAO,MAAM;AAEX,MAAI,QAAQ,QACV,QAAO;GAAE,SAAS;GAAO,QAAQ;GAAW;AAG9C,MAAI;GAEF,MAAM,MAAM,QAAQ,kBAAkB;GAGtC,IAAIA;AACJ,OAAI,UAAU,SACZ,gBAAe,UAAU,SAAS,IAAI;OAItC,gBAAe;GAIjB,MAAM,UAAW,MAAM,aAAa,iBAAiB;GAGrD,IAAIC;AACJ,OAAI,UAAU,OACZ,kBAAiB,MAAM,UAAU,OAAO,cAAc,QAAQ;OAE9D,kBAAiB;GAInB,MAAM,EAAE,YAAY,MAAM,aAAa,kBAAkB;AAEzD,OAAI,SAAS;IAEX,MAAM,aAAa,aAAa,eAAe;IAC/C,MAAM,QAAQ,aAAa;IAG3B,MAAM,wBAAwB,MAAM,sBAAsB,eAAe;AAEzE,QAAI,UAAU,UACZ,OAAM,UAAU,UAAU;KACxB;KACA,gBAAgB;KAChB;KACA;KACD,CAAC;AAGJ,WAAO;KACL,SAAS;KACT;KACA,gBAAgB;KAChB;KACA;KACD;;AAKH,OAAI,CAAC,YAAY,YAAY,SAAS,QAAW,OAAO,CAEtD,QAAO;IAAE,SAAS;IAAO,QAAQ;IAAY;GAI/C,MAAM,UAAU,YAAY,WAAW,QAAQ;AAC/C,OAAI,UAAU,EACZ,OAAM,IAAI,SAAS,YAAY,WAAW,SAAS,QAAQ,CAAC;AAI9D;WACO,OAAO;AAEd,UAAO;IAAE,SAAS;IAAO,QAAQ;IAAS;IAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2EvD,eAAsB,4BACpB,UAUA,SAC2C;CAE3C,MAAM,cACJ,QAAQ,eACR,IAAI,8BAA8B;EAChC,YAAY;EACZ,gBAAgB;EAChB,YAAY;EACb,CAAC;CACJ,MAAM,SAAS,QAAQ;CACvB,IAAI,UAAU;AAEd,QAAO,MAAM;AAEX,MAAI,QAAQ,QACV,OAAM,IAAI,MAAM,iCAAiC;AAGnD,MAAI;GAEF,MAAM,UAAU,QAAQ,kBAAkB;AA2C1C,UAHsB,MAAM,sBAHb,MAAM,SAnCL;IACd,YAA8D,QAAW,UAAc;AACrF,YAAO,QAAQ,UAAU,QAAQ,MAAM;;IAEzC,iBAAiB,YAAY;AAC3B,WAAM,QAAQ,iBAAiB;;IAEjC,eAAe,YAAY;AACzB,SAAI,QAAQ,UAAU,WACpB;AAGF,SAAI,QAAQ,UAAU,qBACpB,OAAM,QAAQ,iBAAiB;AAIjC,SAAI,QAAQ,eACV,SAAQ,eAAe,QAAQ;AAIjC,SAAI,EADW,MAAM,QAAQ,kBAAkB,EACnC,QACV,OAAM,IAAI,0BAA0B;AAGtC,SAAI,QAAQ,UACV,OAAM,QAAQ,UAAU,QAAQ;;IAGpC,OAAO,QAAQ;IACf,gBAAgB;IACjB,CAGqC,CAGmB;WAIlD,OAAO;AACd,OAAI,QAAQ,QACV,OAAM,IAAI,MAAM,iCAAiC;AAInD,OAAI,EAAE,iBAAiB,0BAErB,OAAM;AAGR,OAAI,CAAC,YAAY,YAAY,SAAS,OAAO,OAAO,EAAE;AAEpD,QAAI,QAAQ,QACV,OAAM,IAAI,MAAM,iCAAiC;AAEnD,UAAM,IAAI,MAAM,kEAAkE,EAChF,OAAO,OACR,CAAC;;GAIJ,MAAM,UAAU,YAAY,WAAW,QAAQ;AAC/C,OAAI,UAAU,EACZ,OAAM,IAAI,SAAS,YAAY,WAAW,SAAS,QAAQ,CAAC;AAI9D"}
+{"version":3,"file":"execute-unit-of-work.js","names":["serviceCalls: TServiceCalls | undefined","typedUow: TypedUnitOfWork<TSchema, TRetrieveResults, unknown, THooks> | undefined","internal: TxResultInternal<\n    TSchema,\n    TRetrieveResults,\n    TRetrieveSuccessResult,\n    TServiceCalls,\n    TMutateResult,\n    TSuccessResult,\n    THooks\n  >","collected: TxResult<unknown>[]","serviceResults: unknown[]","serviceIntermediateResults: unknown[]","serviceFinalResults: unknown[]","context: HandlerTxContext<THooks>","retrieveResult: TRetrieveResults","retrieveSuccessResult: TRetrieveSuccessResult","mutateResult: TMutateResult | undefined","mutateCtx: HandlerTxMutateContext<\n          TRetrieveSuccessResult,\n          ExtractServiceRetrieveResults<TServiceCalls>,\n          THooks\n        >","finalResult: unknown","#state","callbacks: ServiceTxCallbacks<\n      TSchema,\n      TRetrieveResults,\n      TRetrieveSuccessResult,\n      TServiceCalls,\n      TMutateResult,\n      TTransformResult,\n      THooks\n    >"],"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 { ExponentialBackoffRetryPolicy, type RetryPolicy } from \"./retry-policy\";\n\n/**\n * Symbol to identify TxResult objects\n */\nconst TX_RESULT_BRAND = Symbol(\"TxResult\");\n\n/**\n * Check if a value is a TxResult\n */\nexport function isTxResult(value: unknown): value is TxResult<unknown> {\n  return (\n    value !== null &&\n    typeof value === \"object\" &&\n    TX_RESULT_BRAND in value &&\n    (value as Record<symbol, boolean>)[TX_RESULT_BRAND] === true\n  );\n}\n\n/**\n * Extract the retrieve success result type from a TxResult.\n * If the TxResult has retrieveSuccess, returns its return type.\n * Otherwise returns the raw retrieve results type.\n * Handles undefined (for optional service patterns like optionalService?.method()).\n */\nexport type ExtractTxRetrieveSuccessResult<T> = T extends undefined\n  ? undefined\n  : T extends TxResult<unknown, infer R>\n    ? R\n    : never;\n\n/**\n * Extract the final result type from a TxResult.\n * Handles undefined (for optional service patterns like optionalService?.method()).\n */\nexport type ExtractTxFinalResult<T> = T extends undefined\n  ? undefined\n  : T extends TxResult<infer R, infer _>\n    ? R\n    : Awaited<T>;\n\n/**\n * Map over service calls array to extract retrieve success results from each service call.\n * Preserves tuple structure while extracting the retrieve success result type from each element.\n */\nexport type ExtractServiceRetrieveResults<T extends readonly unknown[]> = {\n  [K in keyof T]: ExtractTxRetrieveSuccessResult<T[K]>;\n};\n\n/**\n * Map over service calls array to extract final results from each service call.\n * Preserves tuple structure while extracting the final result type from each element.\n */\nexport type ExtractServiceFinalResults<T extends readonly unknown[]> = {\n  [K in keyof T]: ExtractTxFinalResult<T[K]>;\n};\n\n/**\n * Context passed to mutate callback for service methods\n */\nexport interface ServiceTxMutateContext<\n  TSchema extends AnySchema,\n  TRetrieveSuccessResult,\n  TServiceRetrieveResults extends readonly unknown[],\n  THooks extends HooksMap,\n> {\n  /** Unit of work for scheduling mutations */\n  uow: TypedUnitOfWork<TSchema, [], unknown, THooks>;\n  /** Result from retrieveSuccess callback (or raw retrieve results if no retrieveSuccess) */\n  retrieveResult: TRetrieveSuccessResult;\n  /** Array of retrieve success results from service calls (intermediate results, not final) */\n  serviceIntermediateResult: TServiceRetrieveResults;\n}\n\n/**\n * Context passed to handler-level callbacks\n */\nexport interface HandlerTxContext<THooks extends HooksMap> {\n  /** Get a typed Unit of Work for the given schema */\n  forSchema: <S extends AnySchema, H extends HooksMap = THooks>(\n    schema: S,\n    hooks?: H,\n  ) => TypedUnitOfWork<S, [], unknown, H>;\n  /** Unique key for this transaction attempt (for idempotency/deduplication) */\n  idempotencyKey: string;\n  /** Current attempt number (0-based) */\n  currentAttempt: number;\n}\n\n/**\n * Context passed to handler mutate callback\n */\nexport interface HandlerTxMutateContext<\n  TRetrieveSuccessResult,\n  TServiceRetrieveResults extends readonly unknown[],\n  THooks extends HooksMap,\n> extends HandlerTxContext<THooks> {\n  /** Result from retrieveSuccess callback (or raw retrieve results if no retrieveSuccess) */\n  retrieveResult: TRetrieveSuccessResult;\n  /** Array of retrieve success results from service calls (intermediate results, not final) */\n  serviceIntermediateResult: TServiceRetrieveResults;\n}\n\n/**\n * Context passed to success callback when mutate IS provided\n */\nexport interface TxSuccessContextWithMutate<\n  TRetrieveSuccessResult,\n  TMutateResult,\n  TServiceFinalResults extends readonly unknown[],\n  TServiceRetrieveResults extends readonly unknown[],\n> {\n  /** Result from retrieveSuccess callback (or raw retrieve results if no retrieveSuccess) */\n  retrieveResult: TRetrieveSuccessResult;\n  /** Result from mutate callback */\n  mutateResult: TMutateResult;\n  /** Array of final results from service calls */\n  serviceResult: TServiceFinalResults;\n  /** Array of retrieve success results from service calls (same as what mutate receives) */\n  serviceIntermediateResult: TServiceRetrieveResults;\n}\n\n/**\n * Context passed to success callback when mutate is NOT provided\n */\nexport interface TxSuccessContextWithoutMutate<\n  TRetrieveSuccessResult,\n  TServiceFinalResults extends readonly unknown[],\n  TServiceRetrieveResults extends readonly unknown[],\n> {\n  /** Result from retrieveSuccess callback (or raw retrieve results if no retrieveSuccess) */\n  retrieveResult: TRetrieveSuccessResult;\n  /** No mutate callback was provided */\n  mutateResult: undefined;\n  /** Array of final results from service calls */\n  serviceResult: TServiceFinalResults;\n  /** Array of retrieve success results from service calls (same as what mutate receives) */\n  serviceIntermediateResult: TServiceRetrieveResults;\n}\n\n/**\n * Context passed to success callback.\n * Union of TxSuccessContextWithMutate and TxSuccessContextWithoutMutate to handle\n * both cases in a single callback signature.\n */\nexport type TxSuccessContext<\n  TRetrieveSuccessResult,\n  TMutateResult,\n  TServiceFinalResults extends readonly unknown[],\n  TServiceRetrieveResults extends readonly unknown[] = readonly unknown[],\n> =\n  | TxSuccessContextWithMutate<\n      TRetrieveSuccessResult,\n      TMutateResult,\n      TServiceFinalResults,\n      TServiceRetrieveResults\n    >\n  | TxSuccessContextWithoutMutate<\n      TRetrieveSuccessResult,\n      TServiceFinalResults,\n      TServiceRetrieveResults\n    >;\n\n/**\n * Callbacks for service-level TxResult.\n *\n * Return type priority:\n * 1. If success exists: ReturnType<success>\n * 2. Else if mutate exists: ReturnType<mutate>\n * 3. Else if retrieveSuccess exists: ReturnType<retrieveSuccess>\n * 4. Else if retrieve exists: TRetrieveResults\n * 5. Else: serviceResult array type\n */\nexport interface ServiceTxCallbacks<\n  TSchema extends AnySchema,\n  TRetrieveResults extends unknown[],\n  TRetrieveSuccessResult,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  TServiceCalls extends readonly (TxResult<any, any> | undefined)[],\n  TMutateResult,\n  TSuccessResult,\n  THooks extends HooksMap,\n> {\n  /**\n   * Service calls - other TxResults to execute first.\n   */\n  serviceCalls?: () => TServiceCalls;\n\n  /**\n   * Retrieval phase callback - schedules retrieval operations.\n   */\n  retrieve?: (\n    uow: TypedUnitOfWork<TSchema, [], unknown, THooks>,\n  ) => TypedUnitOfWork<TSchema, TRetrieveResults, unknown, THooks>;\n\n  /**\n   * Transform retrieve results before passing to mutate.\n   */\n  retrieveSuccess?: (\n    retrieveResult: TRetrieveResults,\n    serviceResult: ExtractServiceRetrieveResults<TServiceCalls>,\n  ) => TRetrieveSuccessResult;\n\n  /**\n   * Mutation phase callback - schedules mutations based on retrieve results.\n   */\n  mutate?: (\n    ctx: ServiceTxMutateContext<\n      TSchema,\n      TRetrieveSuccessResult,\n      ExtractServiceRetrieveResults<TServiceCalls>,\n      THooks\n    >,\n  ) => TMutateResult;\n\n  /**\n   * Success callback - final transformation after mutations complete.\n   */\n  success?: (\n    ctx: TxSuccessContext<\n      TRetrieveSuccessResult,\n      TMutateResult,\n      ExtractServiceFinalResults<TServiceCalls>,\n      ExtractServiceRetrieveResults<TServiceCalls>\n    >,\n  ) => TSuccessResult;\n}\n\n/**\n * Callbacks for handler-level executeTx.\n * Uses context-based callbacks that provide forSchema() method.\n */\nexport interface HandlerTxCallbacks<\n  TRetrieveResults extends unknown[],\n  TRetrieveSuccessResult,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  TServiceCalls extends readonly (TxResult<any, any> | undefined)[],\n  TMutateResult,\n  TSuccessResult,\n  THooks extends HooksMap,\n> {\n  /**\n   * Service calls - other TxResults to execute first.\n   */\n  serviceCalls?: () => TServiceCalls;\n\n  /**\n   * Retrieval phase callback - schedules retrieval operations using context.forSchema().\n   * Return a TypedUnitOfWork to get typed results, or void for no retrieval.\n   */\n  retrieve?: (\n    context: HandlerTxContext<THooks>,\n  ) => TypedUnitOfWork<AnySchema, TRetrieveResults, unknown, HooksMap> | void;\n\n  /**\n   * Transform retrieve results before passing to mutate.\n   */\n  retrieveSuccess?: (\n    retrieveResult: TRetrieveResults,\n    serviceResult: ExtractServiceRetrieveResults<TServiceCalls>,\n  ) => TRetrieveSuccessResult;\n\n  /**\n   * Mutation phase callback - schedules mutations based on retrieve results.\n   */\n  mutate?: (\n    ctx: HandlerTxMutateContext<\n      TRetrieveSuccessResult,\n      ExtractServiceRetrieveResults<TServiceCalls>,\n      THooks\n    >,\n  ) => TMutateResult;\n\n  /**\n   * Success callback - final transformation after mutations complete.\n   */\n  success?: (\n    ctx: TxSuccessContext<\n      TRetrieveSuccessResult,\n      TMutateResult,\n      ExtractServiceFinalResults<TServiceCalls>,\n      ExtractServiceRetrieveResults<TServiceCalls>\n    >,\n  ) => TSuccessResult;\n}\n\n/**\n * Internal structure storing TxResult callbacks and state.\n */\ninterface TxResultInternal<\n  TSchema extends AnySchema,\n  TRetrieveResults extends unknown[],\n  TRetrieveSuccessResult,\n  TServiceCalls extends readonly (TxResult<unknown> | undefined)[],\n  TMutateResult,\n  TSuccessResult,\n  THooks extends HooksMap,\n> {\n  schema: TSchema | undefined;\n  callbacks: ServiceTxCallbacks<\n    TSchema,\n    TRetrieveResults,\n    TRetrieveSuccessResult,\n    TServiceCalls,\n    TMutateResult,\n    TSuccessResult,\n    THooks\n  >;\n  /** The typed UOW created during retrieve callback */\n  typedUow: TypedUnitOfWork<TSchema, TRetrieveResults, unknown, THooks> | undefined;\n  /** The restricted UOW for signaling (used when typedUow is undefined) */\n  restrictedUow: IUnitOfWork;\n  /** Promise that resolves when retrieve phase is complete */\n  retrievePhase: Promise<TRetrieveResults>;\n  /** Resolve function for retrievePhase */\n  resolveRetrievePhase: (results: TRetrieveResults) => void;\n  /** Reject function for retrievePhase */\n  rejectRetrievePhase: (error: unknown) => void;\n  /** Computed retrieve success result (set after retrieveSuccess runs) */\n  retrieveSuccessResult: TRetrieveSuccessResult | undefined;\n  /** Computed mutate result (set after mutate runs) */\n  mutateResult: TMutateResult | undefined;\n  /** Computed final result (set after success runs or defaults) */\n  finalResult: TSuccessResult | undefined;\n  /** Service calls resolved */\n  serviceCalls: TServiceCalls | undefined;\n}\n\n/**\n * TxResult represents a transaction definition (not yet executed).\n * It describes the work to be done: retrieve operations, transformations, and mutations.\n *\n * Service methods return TxResult objects, and the handler's executeTx function\n * orchestrates their execution with retry support.\n *\n * @template TResult - The final result type (determined by return type priority)\n * @template TRetrieveSuccessResult - The retrieve success result type (what serviceCalls receive).\n *   Defaults to TResult, meaning serviceCalls receive the same type as the final result.\n */\nexport interface TxResult<TResult, TRetrieveSuccessResult = TResult> {\n  /** Brand to identify TxResult objects */\n  readonly [TX_RESULT_BRAND]: true;\n\n  /** Internal structure - do not access directly */\n  readonly _internal: TxResultInternal<\n    AnySchema,\n    unknown[],\n    TRetrieveSuccessResult,\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    readonly TxResult<any, any>[],\n    unknown,\n    TResult,\n    HooksMap\n  >;\n}\n\n/**\n * Create a TxResult for service context.\n * Schedules retrieve operations on the baseUow and returns a TxResult with callbacks stored.\n * @internal Used by ServiceTxBuilder.build()\n */\nfunction createServiceTx<\n  TSchema extends AnySchema,\n  TRetrieveResults extends unknown[],\n  TRetrieveSuccessResult,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  TServiceCalls extends readonly (TxResult<any, any> | undefined)[],\n  TMutateResult,\n  TSuccessResult,\n  THooks extends HooksMap = {},\n>(\n  schema: TSchema | undefined,\n  callbacks: ServiceTxCallbacks<\n    TSchema,\n    TRetrieveResults,\n    TRetrieveSuccessResult,\n    TServiceCalls,\n    TMutateResult,\n    TSuccessResult,\n    THooks\n  >,\n  baseUow: IUnitOfWork,\n): TxResult<unknown, unknown> {\n  // Create deferred promise for retrieve phase\n  const {\n    promise: retrievePhase,\n    resolve: resolveRetrievePhase,\n    reject: rejectRetrievePhase,\n  } = Promise.withResolvers<TRetrieveResults>();\n\n  // Get a restricted view that signals readiness\n  const restrictedUow = baseUow.restrict({ readyFor: \"none\" });\n\n  // Call serviceCalls factory if provided - this invokes other services which schedule their operations\n  let serviceCalls: TServiceCalls | undefined;\n  try {\n    if (callbacks.serviceCalls) {\n      serviceCalls = callbacks.serviceCalls();\n    }\n  } catch (error) {\n    restrictedUow.signalReadyForRetrieval();\n    restrictedUow.signalReadyForMutation();\n    retrievePhase.catch(() => {});\n    rejectRetrievePhase(error);\n    throw error;\n  }\n  let typedUow: TypedUnitOfWork<TSchema, TRetrieveResults, unknown, THooks> | undefined;\n  try {\n    if (schema && callbacks.retrieve) {\n      const emptyUow = restrictedUow.forSchema<TSchema, THooks>(schema);\n      typedUow = callbacks.retrieve(emptyUow);\n    }\n  } catch (error) {\n    restrictedUow.signalReadyForRetrieval();\n    restrictedUow.signalReadyForMutation();\n    retrievePhase.catch(() => {});\n    rejectRetrievePhase(error);\n    throw error;\n  }\n  restrictedUow.signalReadyForRetrieval();\n\n  // Set up the retrieve phase promise to resolve when the handler executes retrieve\n  if (typedUow) {\n    typedUow.retrievalPhase.then(\n      (results) => resolveRetrievePhase(results as TRetrieveResults),\n      (error) => rejectRetrievePhase(error),\n    );\n  } else if (!callbacks.retrieve) {\n    // No retrieve callback - resolve immediately with empty array\n    resolveRetrievePhase([] as unknown as TRetrieveResults);\n  }\n\n  const internal: TxResultInternal<\n    TSchema,\n    TRetrieveResults,\n    TRetrieveSuccessResult,\n    TServiceCalls,\n    TMutateResult,\n    TSuccessResult,\n    THooks\n  > = {\n    schema,\n    callbacks,\n    typedUow,\n    restrictedUow,\n    retrievePhase,\n    resolveRetrievePhase,\n    rejectRetrievePhase,\n    retrieveSuccessResult: undefined,\n    mutateResult: undefined,\n    finalResult: undefined,\n    serviceCalls,\n  };\n\n  return {\n    [TX_RESULT_BRAND]: true as const,\n    // Cast through unknown to avoid type incompatibility issues with generic constraints\n    _internal: internal as unknown as TxResultInternal<\n      AnySchema,\n      unknown[],\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      any,\n      readonly TxResult<unknown>[],\n      unknown,\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      any,\n      HooksMap\n    >,\n  };\n}\n\n/**\n * Options for executing transactions\n */\nexport interface ExecuteTxOptions {\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  onAfterMutate?: (uow: IUnitOfWork) => Promise<void>;\n}\n\n/**\n * Recursively collect all TxResults from a service call tree.\n * Returns them in a flat array in dependency order (serviceCalls before their dependents).\n * Skips undefined values (which can occur with optional service patterns like\n * optionalService?.method()).\n */\nfunction collectAllTxResults(\n  txResults: readonly (TxResult<unknown> | undefined)[],\n): TxResult<unknown>[] {\n  const collected: TxResult<unknown>[] = [];\n  const seen = new Set<TxResult<unknown>>();\n\n  function collect(txResult: TxResult<unknown> | undefined) {\n    if (txResult === undefined) {\n      return;\n    }\n\n    if (seen.has(txResult)) {\n      return;\n    }\n    seen.add(txResult);\n\n    // First collect serviceCalls (so they come before this TxResult)\n    const serviceCalls = txResult._internal.serviceCalls;\n    if (serviceCalls) {\n      for (const serviceCall of serviceCalls) {\n        collect(serviceCall);\n      }\n    }\n\n    collected.push(txResult);\n  }\n\n  for (const txResult of txResults) {\n    collect(txResult);\n  }\n\n  return collected;\n}\n\n/**\n * Execute a single TxResult's callbacks after retrieve phase completes.\n * This processes retrieveSuccess, mutate, and success callbacks in order.\n */\nasync function processTxResultAfterRetrieve<T>(\n  txResult: TxResult<T>,\n  baseUow: IUnitOfWork,\n): Promise<void> {\n  const internal = txResult._internal;\n  const callbacks = internal.callbacks;\n\n  // Wait for retrieve phase to complete\n  const retrieveResults = await internal.retrievePhase;\n\n  // Collect serviceCalls' retrieve success results (or mutate results if no retrieve was provided)\n  // When a serviceCall has no retrieve/retrieveSuccess but has mutate, its mutate has already run\n  // (due to service call execution order), so we use its mutate result as the \"retrieve success result\".\n  const serviceResults: unknown[] = [];\n  if (internal.serviceCalls) {\n    for (const serviceCall of internal.serviceCalls) {\n      if (serviceCall === undefined) {\n        serviceResults.push(undefined);\n        continue;\n      }\n\n      const serviceCallInternal = serviceCall._internal;\n      // Check if this is a mutate-only service call (empty array sentinel with mutate callback)\n      // In that case, prefer mutateResult over the empty array retrieveSuccessResult\n      if (\n        serviceCallInternal.retrieveSuccessResult !== undefined &&\n        !(\n          Array.isArray(serviceCallInternal.retrieveSuccessResult) &&\n          serviceCallInternal.retrieveSuccessResult.length === 0 &&\n          serviceCallInternal.callbacks.mutate\n        )\n      ) {\n        serviceResults.push(serviceCallInternal.retrieveSuccessResult);\n      } else if (serviceCallInternal.mutateResult !== undefined) {\n        serviceResults.push(serviceCallInternal.mutateResult);\n      } else {\n        serviceResults.push(serviceCallInternal.retrieveSuccessResult);\n      }\n    }\n  }\n\n  if (callbacks.retrieveSuccess) {\n    internal.retrieveSuccessResult = callbacks.retrieveSuccess(\n      retrieveResults,\n      serviceResults as ExtractServiceRetrieveResults<readonly TxResult<unknown>[]>,\n    );\n  } else {\n    internal.retrieveSuccessResult = retrieveResults as typeof internal.retrieveSuccessResult;\n  }\n\n  if (callbacks.mutate) {\n    const mutateCtx = {\n      uow: internal.schema\n        ? baseUow.forSchema(internal.schema)\n        : (undefined as unknown as TypedUnitOfWork<AnySchema, [], unknown, HooksMap>),\n      // At this point retrieveSuccessResult has been set (either by retrieveSuccess\n      // callback or defaulted to retrieveResults)\n      retrieveResult: internal.retrieveSuccessResult as NonNullable<\n        typeof internal.retrieveSuccessResult\n      >,\n      serviceIntermediateResult: serviceResults as ExtractServiceRetrieveResults<\n        readonly TxResult<unknown>[]\n      >,\n    };\n    internal.mutateResult = callbacks.mutate(mutateCtx);\n  }\n\n  if (internal.typedUow) {\n    internal.typedUow.signalReadyForMutation();\n  } else {\n    // For TxResults without retrieve callback, signal via the restricted UOW\n    internal.restrictedUow.signalReadyForMutation();\n  }\n}\n\n/**\n * Execute a single TxResult's success callback after mutations complete.\n */\nasync function processTxResultAfterMutate<T>(txResult: TxResult<T>): Promise<T> {\n  const internal = txResult._internal;\n  const callbacks = internal.callbacks;\n\n  const serviceIntermediateResults: unknown[] = [];\n  const serviceFinalResults: unknown[] = [];\n  if (internal.serviceCalls) {\n    for (const serviceCall of internal.serviceCalls) {\n      if (serviceCall === undefined) {\n        serviceIntermediateResults.push(undefined);\n        serviceFinalResults.push(undefined);\n        continue;\n      }\n\n      // Mirror the logic from processTxResultAfterRetrieve/executeTx:\n      // For mutate-only serviceCalls (no retrieve phase, just mutations), use mutateResult instead of retrieveSuccessResult\n      const serviceCallInternal = serviceCall._internal;\n      // Check if this is a mutate-only service call (empty array sentinel with mutate callback)\n      // In that case, prefer mutateResult over the empty array retrieveSuccessResult\n      if (\n        serviceCallInternal.retrieveSuccessResult !== undefined &&\n        !(\n          Array.isArray(serviceCallInternal.retrieveSuccessResult) &&\n          serviceCallInternal.retrieveSuccessResult.length === 0 &&\n          serviceCallInternal.callbacks.mutate\n        )\n      ) {\n        serviceIntermediateResults.push(serviceCallInternal.retrieveSuccessResult);\n      } else if (serviceCallInternal.mutateResult !== undefined) {\n        serviceIntermediateResults.push(serviceCallInternal.mutateResult);\n      } else {\n        serviceIntermediateResults.push(serviceCallInternal.retrieveSuccessResult);\n      }\n      serviceFinalResults.push(serviceCallInternal.finalResult);\n    }\n  }\n\n  if (callbacks.success) {\n    const successCtx = {\n      retrieveResult: internal.retrieveSuccessResult as NonNullable<\n        typeof internal.retrieveSuccessResult\n      >,\n      mutateResult: internal.mutateResult,\n      serviceResult: serviceFinalResults as ExtractServiceFinalResults<\n        readonly TxResult<unknown>[]\n      >,\n      serviceIntermediateResult: serviceIntermediateResults as ExtractServiceRetrieveResults<\n        readonly TxResult<unknown>[]\n      >,\n    };\n    internal.finalResult = callbacks.success(successCtx) as T;\n  } else if (callbacks.mutate) {\n    internal.finalResult = (await awaitPromisesInObject(internal.mutateResult)) as T;\n  } else if (callbacks.retrieveSuccess || callbacks.retrieve) {\n    internal.finalResult = internal.retrieveSuccessResult as T;\n  } else {\n    internal.finalResult = serviceFinalResults as T;\n  }\n\n  return internal.finalResult as T;\n}\n\n/**\n * Execute a transaction with the unified TxResult pattern.\n *\n * This is the handler-level function that actually executes TxResults with retry support.\n *\n * @param callbacks - Transaction callbacks (serviceCalls, retrieve, retrieveSuccess, mutate, success)\n * @param options - Configuration including UOW factory, retry policy, and abort signal\n * @returns Promise resolving to the result determined by return type priority\n *\n * @example\n * ```ts\n * // Simple retrieve + transform\n * const user = await executeTx({\n *   retrieve: (ctx) => ctx.forSchema(usersSchema).find(\"users\", ...),\n *   retrieveSuccess: ([users]) => users[0] ?? null,\n * }, { createUnitOfWork });\n * @internal Used by HandlerTxBuilder.execute()\n */\nasync function executeTx(\n  callbacks: HandlerTxCallbacks<\n    unknown[],\n    unknown,\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    readonly (TxResult<any, any> | undefined)[],\n    unknown,\n    unknown,\n    HooksMap\n  >,\n  options: ExecuteTxOptions,\n): Promise<unknown> {\n  type TRetrieveResults = unknown[];\n  type TRetrieveSuccessResult = unknown;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  type TServiceCalls = readonly (TxResult<any, any> | undefined)[];\n  type TMutateResult = unknown;\n  type THooks = HooksMap;\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(\"Transaction execution aborted\");\n    }\n\n    try {\n      // Create a fresh UOW for this attempt\n      const baseUow = options.createUnitOfWork();\n\n      // Create handler context\n      const context: HandlerTxContext<THooks> = {\n        forSchema: <S extends AnySchema, H extends HooksMap = THooks>(schema: S, hooks?: H) => {\n          return baseUow.forSchema(schema, hooks);\n        },\n        idempotencyKey: baseUow.idempotencyKey,\n        currentAttempt: attempt,\n      };\n\n      // Call serviceCalls factory if provided - this creates TxResults that schedule operations\n      let serviceCalls: TServiceCalls | undefined;\n      if (callbacks.serviceCalls) {\n        serviceCalls = callbacks.serviceCalls();\n      }\n\n      // Call retrieve callback - it returns a TypedUnitOfWork with scheduled operations or void\n      const typedUowFromRetrieve = callbacks.retrieve?.(context);\n\n      const allServiceCallTxResults = serviceCalls ? collectAllTxResults([...serviceCalls]) : [];\n\n      await baseUow.executeRetrieve();\n\n      // Get retrieve results from TypedUnitOfWork's retrievalPhase or default to empty array\n      const retrieveResult: TRetrieveResults = typedUowFromRetrieve\n        ? await typedUowFromRetrieve.retrievalPhase\n        : ([] as unknown as TRetrieveResults);\n\n      for (const txResult of allServiceCallTxResults) {\n        await processTxResultAfterRetrieve(txResult, baseUow);\n      }\n\n      const serviceResults: unknown[] = [];\n      if (serviceCalls) {\n        for (const serviceCall of serviceCalls) {\n          if (serviceCall === undefined) {\n            serviceResults.push(undefined);\n            continue;\n          }\n          const serviceCallInternal = serviceCall._internal;\n          // Check if this is a mutate-only service call (empty array sentinel with mutate callback)\n          // In that case, prefer mutateResult over the empty array retrieveSuccessResult\n          if (\n            serviceCallInternal.retrieveSuccessResult !== undefined &&\n            !(\n              Array.isArray(serviceCallInternal.retrieveSuccessResult) &&\n              serviceCallInternal.retrieveSuccessResult.length === 0 &&\n              serviceCallInternal.callbacks.mutate\n            )\n          ) {\n            serviceResults.push(serviceCallInternal.retrieveSuccessResult);\n          } else if (serviceCallInternal.mutateResult !== undefined) {\n            serviceResults.push(serviceCallInternal.mutateResult);\n          } else {\n            serviceResults.push(serviceCallInternal.retrieveSuccessResult);\n          }\n        }\n      }\n\n      // Call retrieveSuccess if provided\n      let retrieveSuccessResult: TRetrieveSuccessResult;\n      if (callbacks.retrieveSuccess) {\n        retrieveSuccessResult = callbacks.retrieveSuccess(\n          retrieveResult,\n          serviceResults as ExtractServiceRetrieveResults<TServiceCalls>,\n        );\n      } else {\n        retrieveSuccessResult = retrieveResult as unknown as TRetrieveSuccessResult;\n      }\n\n      let mutateResult: TMutateResult | undefined;\n      if (callbacks.mutate) {\n        const mutateCtx: HandlerTxMutateContext<\n          TRetrieveSuccessResult,\n          ExtractServiceRetrieveResults<TServiceCalls>,\n          THooks\n        > = {\n          ...context,\n          retrieveResult: retrieveSuccessResult,\n          serviceIntermediateResult: serviceResults as ExtractServiceRetrieveResults<TServiceCalls>,\n        };\n        mutateResult = callbacks.mutate(mutateCtx);\n      }\n\n      if (options.onBeforeMutate) {\n        options.onBeforeMutate(baseUow);\n      }\n      const result = await baseUow.executeMutations();\n      if (!result.success) {\n        throw new ConcurrencyConflictError();\n      }\n\n      // Process each serviceCall TxResult's success callback\n      for (const txResult of allServiceCallTxResults) {\n        await processTxResultAfterMutate(txResult);\n      }\n\n      const serviceFinalResults: unknown[] = [];\n      if (serviceCalls) {\n        for (const serviceCall of serviceCalls) {\n          if (serviceCall === undefined) {\n            serviceFinalResults.push(undefined);\n            continue;\n          }\n          serviceFinalResults.push(serviceCall._internal.finalResult);\n        }\n      }\n\n      let finalResult: unknown;\n      if (callbacks.success) {\n        // The success context type is determined by the overload - we construct it at runtime\n        // and the type safety is guaranteed by the discriminated overloads\n        const successCtx = {\n          retrieveResult: retrieveSuccessResult,\n          mutateResult,\n          serviceResult: serviceFinalResults as ExtractServiceFinalResults<TServiceCalls>,\n          serviceIntermediateResult: serviceResults as ExtractServiceRetrieveResults<TServiceCalls>,\n        } as Parameters<NonNullable<typeof callbacks.success>>[0];\n        finalResult = callbacks.success(successCtx);\n      } else if (callbacks.mutate) {\n        finalResult = await awaitPromisesInObject(mutateResult);\n      } else if (callbacks.retrieveSuccess || callbacks.retrieve) {\n        finalResult = retrieveSuccessResult;\n      } else {\n        finalResult = serviceFinalResults;\n      }\n\n      if (options.onAfterMutate) {\n        await options.onAfterMutate(baseUow);\n      }\n\n      return await awaitPromisesInObject(finalResult);\n    } catch (error) {\n      if (signal?.aborted) {\n        throw new Error(\"Transaction execution aborted\");\n      }\n\n      // Only retry concurrency conflicts, not other errors\n      if (!(error instanceof ConcurrencyConflictError)) {\n        throw error;\n      }\n\n      if (!retryPolicy.shouldRetry(attempt, error, signal)) {\n        if (signal?.aborted) {\n          throw new Error(\"Transaction execution aborted\");\n        }\n        throw new ConcurrencyConflictError();\n      }\n\n      const delayMs = retryPolicy.getDelayMs(attempt);\n      if (delayMs > 0) {\n        await new Promise((resolve) => setTimeout(resolve, delayMs));\n      }\n\n      attempt++;\n    }\n  }\n}\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 executeTx.\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  if (obj.constructor !== Object) {\n    return obj as AwaitedPromisesInObject<T>;\n  }\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// Builder Pattern Types and Classes\n// ============================================================================\n\n/**\n * Context passed to service-level mutate callback in builder pattern.\n */\nexport interface ServiceBuilderMutateContext<\n  TSchema extends AnySchema,\n  TRetrieveSuccessResult,\n  TServiceResult extends readonly unknown[],\n  THooks extends HooksMap,\n> {\n  /** Unit of work for scheduling mutations */\n  uow: TypedUnitOfWork<TSchema, [], unknown, THooks>;\n  /** Result from transformRetrieve callback (or raw retrieve results if no transformRetrieve) */\n  retrieveResult: TRetrieveSuccessResult;\n  /** Array of retrieve success results from service calls (intermediate results, not final: retrieve results if service has retrieve, mutate result if service only mutates) */\n  serviceIntermediateResult: TServiceResult;\n}\n\n/**\n * Context passed to handler-level mutate callback in builder pattern.\n */\nexport interface HandlerBuilderMutateContext<\n  TRetrieveSuccessResult,\n  TServiceResult extends readonly unknown[],\n  THooks extends HooksMap,\n> {\n  /** Get a typed Unit of Work for the given schema */\n  forSchema: <S extends AnySchema, H extends HooksMap = THooks>(\n    schema: S,\n    hooks?: H,\n  ) => TypedUnitOfWork<S, [], unknown, H>;\n  /** Unique key for this transaction (for idempotency/deduplication) */\n  idempotencyKey: string;\n  /** Current attempt number (0-based) */\n  currentAttempt: number;\n  /** Result from transformRetrieve callback (or raw retrieve results if no transformRetrieve) */\n  retrieveResult: TRetrieveSuccessResult;\n  /** Array of retrieve success results from service calls (intermediate results, not final: retrieve results if service has retrieve, mutate result if service only mutates) */\n  serviceIntermediateResult: TServiceResult;\n}\n\n/**\n * Context passed to transform callback when mutate IS provided.\n */\nexport interface BuilderTransformContextWithMutate<\n  TRetrieveSuccessResult,\n  TMutateResult,\n  TServiceFinalResult extends readonly unknown[],\n  TServiceIntermediateResult extends readonly unknown[],\n> {\n  /** Result from transformRetrieve callback (or raw retrieve results if no transformRetrieve) */\n  retrieveResult: TRetrieveSuccessResult;\n  /** Result from mutate callback */\n  mutateResult: TMutateResult;\n  /** Array of final results from service calls (after success/transform callbacks) */\n  serviceResult: TServiceFinalResult;\n  /** Array of retrieve success results from service calls (same as what mutate receives: retrieve results if service has retrieve, mutate result if service only mutates) */\n  serviceIntermediateResult: TServiceIntermediateResult;\n}\n\n/**\n * Context passed to transform callback when mutate is NOT provided.\n */\nexport interface BuilderTransformContextWithoutMutate<\n  TRetrieveSuccessResult,\n  TServiceFinalResult extends readonly unknown[],\n  TServiceIntermediateResult extends readonly unknown[],\n> {\n  /** Result from transformRetrieve callback (or raw retrieve results if no transformRetrieve) */\n  retrieveResult: TRetrieveSuccessResult;\n  /** No mutate callback was provided */\n  mutateResult: undefined;\n  /** Array of final results from service calls (after success/transform callbacks) */\n  serviceResult: TServiceFinalResult;\n  /** Array of retrieve success results from service calls (same as what mutate receives: retrieve results if service has retrieve, mutate result if service only mutates) */\n  serviceIntermediateResult: TServiceIntermediateResult;\n}\n\n/**\n * Infer the final result type from builder state:\n * 1. transform → TTransformResult\n * 2. mutate → AwaitedPromisesInObject<TMutateResult>\n * 3. transformRetrieve → TRetrieveSuccessResult\n * 4. retrieve → TRetrieveResults\n * 5. withServiceCalls → ExtractServiceFinalResults<TServiceCalls>\n */\nexport type InferBuilderResultType<\n  TRetrieveResults extends unknown[],\n  TRetrieveSuccessResult,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  TServiceCalls extends readonly (TxResult<any, any> | undefined)[],\n  TMutateResult,\n  TTransformResult,\n  HasTransform extends boolean,\n  HasMutate extends boolean,\n  HasTransformRetrieve extends boolean,\n  HasRetrieve extends boolean,\n> = HasTransform extends true\n  ? TTransformResult\n  : HasMutate extends true\n    ? AwaitedPromisesInObject<TMutateResult>\n    : HasTransformRetrieve extends true\n      ? TRetrieveSuccessResult\n      : HasRetrieve extends true\n        ? TRetrieveResults\n        : ExtractServiceFinalResults<TServiceCalls>;\n\n/**\n * Infer the retrieve success result type for the builder:\n * - If transformRetrieve exists: TRetrieveSuccessResult\n * - Else if retrieve exists: TRetrieveResults (raw retrieve results)\n * - Else if mutate exists: AwaitedPromisesInObject<TMutateResult>\n *   (mutate result becomes retrieve result for dependents)\n * - Else: TRetrieveResults (raw retrieve results, typically [])\n */\nexport type InferBuilderRetrieveSuccessResult<\n  TRetrieveResults extends unknown[],\n  TRetrieveSuccessResult,\n  TMutateResult,\n  HasTransformRetrieve extends boolean,\n  HasRetrieve extends boolean,\n  HasMutate extends boolean,\n> = HasTransformRetrieve extends true\n  ? TRetrieveSuccessResult\n  : HasRetrieve extends true\n    ? TRetrieveResults\n    : HasMutate extends true\n      ? AwaitedPromisesInObject<TMutateResult>\n      : TRetrieveResults;\n\n/**\n * Internal state for ServiceTxBuilder\n */\ninterface ServiceTxBuilderState<\n  TSchema extends AnySchema,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  TServiceCalls extends readonly (TxResult<any, any> | undefined)[],\n  TRetrieveResults extends unknown[],\n  TRetrieveSuccessResult,\n  TMutateResult,\n  TTransformResult,\n  THooks extends HooksMap,\n> {\n  schema: TSchema;\n  baseUow: IUnitOfWork;\n  hooks?: THooks;\n  withServiceCallsFn?: () => TServiceCalls;\n  retrieveFn?: (\n    uow: TypedUnitOfWork<TSchema, [], unknown, THooks>,\n  ) => TypedUnitOfWork<TSchema, TRetrieveResults, unknown, THooks>;\n  transformRetrieveFn?: (\n    retrieveResult: TRetrieveResults,\n    serviceRetrieveResult: ExtractServiceRetrieveResults<TServiceCalls>,\n  ) => TRetrieveSuccessResult;\n  mutateFn?: (\n    ctx: ServiceBuilderMutateContext<\n      TSchema,\n      TRetrieveSuccessResult,\n      ExtractServiceRetrieveResults<TServiceCalls>,\n      THooks\n    >,\n  ) => TMutateResult;\n  transformFn?: (\n    ctx:\n      | BuilderTransformContextWithMutate<\n          TRetrieveSuccessResult,\n          TMutateResult,\n          ExtractServiceFinalResults<TServiceCalls>,\n          ExtractServiceRetrieveResults<TServiceCalls>\n        >\n      | BuilderTransformContextWithoutMutate<\n          TRetrieveSuccessResult,\n          ExtractServiceFinalResults<TServiceCalls>,\n          ExtractServiceRetrieveResults<TServiceCalls>\n        >,\n  ) => TTransformResult;\n}\n\n/**\n * Builder for service-level transactions.\n * Uses a fluent API to build up transaction callbacks with proper type inference.\n *\n * @example\n * ```ts\n * return serviceTx(schema)\n *   .withServiceCalls(() => [otherService.getData()])\n *   .retrieve((uow) => uow.find(\"users\", ...))\n *   .transformRetrieve(([users], serviceResult) => users[0])\n *   .mutate(({ uow, retrieveResult, serviceIntermediateResult }) =>\n *     uow.create(\"records\", { ... })\n *   )\n *   .transform(({ mutateResult, serviceResult, serviceIntermediateResult }) => ({ id: mutateResult }))\n *   .build();\n * ```\n */\nexport class ServiceTxBuilder<\n  TSchema extends AnySchema,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  TServiceCalls extends readonly (TxResult<any, any> | undefined)[],\n  TRetrieveResults extends unknown[],\n  TRetrieveSuccessResult,\n  TMutateResult,\n  TTransformResult,\n  HasRetrieve extends boolean,\n  HasTransformRetrieve extends boolean,\n  HasMutate extends boolean,\n  HasTransform extends boolean,\n  THooks extends HooksMap,\n> {\n  readonly #state: ServiceTxBuilderState<\n    TSchema,\n    TServiceCalls,\n    TRetrieveResults,\n    TRetrieveSuccessResult,\n    TMutateResult,\n    TTransformResult,\n    THooks\n  >;\n\n  constructor(\n    state: ServiceTxBuilderState<\n      TSchema,\n      TServiceCalls,\n      TRetrieveResults,\n      TRetrieveSuccessResult,\n      TMutateResult,\n      TTransformResult,\n      THooks\n    >,\n  ) {\n    this.#state = state;\n  }\n\n  /**\n   * Add dependencies to execute before this transaction.\n   */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  withServiceCalls<TNewDeps extends readonly (TxResult<any, any> | undefined)[]>(\n    fn: () => TNewDeps,\n  ): ServiceTxBuilder<\n    TSchema,\n    TNewDeps,\n    TRetrieveResults,\n    TRetrieveSuccessResult,\n    TMutateResult,\n    TTransformResult,\n    HasRetrieve,\n    HasTransformRetrieve,\n    HasMutate,\n    HasTransform,\n    THooks\n  > {\n    return new ServiceTxBuilder({\n      ...this.#state,\n      withServiceCallsFn: fn,\n    } as ServiceTxBuilderState<\n      TSchema,\n      TNewDeps,\n      TRetrieveResults,\n      TRetrieveSuccessResult,\n      TMutateResult,\n      TTransformResult,\n      THooks\n    >);\n  }\n\n  /**\n   * Add retrieval operations to the transaction.\n   */\n  retrieve<TNewRetrieveResults extends unknown[]>(\n    fn: (\n      uow: TypedUnitOfWork<TSchema, [], unknown, THooks>,\n    ) => TypedUnitOfWork<TSchema, TNewRetrieveResults, unknown, THooks>,\n  ): ServiceTxBuilder<\n    TSchema,\n    TServiceCalls,\n    TNewRetrieveResults,\n    TNewRetrieveResults, // Default TRetrieveSuccessResult to TNewRetrieveResults\n    TMutateResult,\n    TTransformResult,\n    true, // HasRetrieve = true\n    false, // Reset HasTransformRetrieve since retrieve results changed\n    HasMutate,\n    HasTransform,\n    THooks\n  > {\n    return new ServiceTxBuilder({\n      ...this.#state,\n      retrieveFn: fn,\n      transformRetrieveFn: undefined, // Clear any existing transformRetrieve since results shape changed\n    } as unknown as ServiceTxBuilderState<\n      TSchema,\n      TServiceCalls,\n      TNewRetrieveResults,\n      TNewRetrieveResults,\n      TMutateResult,\n      TTransformResult,\n      THooks\n    >);\n  }\n\n  /**\n   * Transform retrieve results before passing to mutate.\n   */\n  transformRetrieve<TNewRetrieveSuccessResult>(\n    fn: (\n      retrieveResult: TRetrieveResults,\n      serviceResult: ExtractServiceRetrieveResults<TServiceCalls>,\n    ) => TNewRetrieveSuccessResult,\n  ): ServiceTxBuilder<\n    TSchema,\n    TServiceCalls,\n    TRetrieveResults,\n    TNewRetrieveSuccessResult,\n    TMutateResult,\n    TTransformResult,\n    HasRetrieve,\n    true, // HasTransformRetrieve = true\n    HasMutate,\n    HasTransform,\n    THooks\n  > {\n    return new ServiceTxBuilder({\n      ...this.#state,\n      transformRetrieveFn: fn,\n    } as unknown as ServiceTxBuilderState<\n      TSchema,\n      TServiceCalls,\n      TRetrieveResults,\n      TNewRetrieveSuccessResult,\n      TMutateResult,\n      TTransformResult,\n      THooks\n    >);\n  }\n\n  /**\n   * Add mutation operations based on retrieve results.\n   */\n  mutate<TNewMutateResult>(\n    fn: (\n      ctx: ServiceBuilderMutateContext<\n        TSchema,\n        HasTransformRetrieve extends true ? TRetrieveSuccessResult : TRetrieveResults,\n        ExtractServiceRetrieveResults<TServiceCalls>,\n        THooks\n      >,\n    ) => TNewMutateResult,\n  ): ServiceTxBuilder<\n    TSchema,\n    TServiceCalls,\n    TRetrieveResults,\n    HasTransformRetrieve extends true ? TRetrieveSuccessResult : TRetrieveResults,\n    TNewMutateResult,\n    TTransformResult,\n    HasRetrieve,\n    HasTransformRetrieve,\n    true, // HasMutate = true\n    HasTransform,\n    THooks\n  > {\n    return new ServiceTxBuilder({\n      ...this.#state,\n      mutateFn: fn,\n    } as unknown as ServiceTxBuilderState<\n      TSchema,\n      TServiceCalls,\n      TRetrieveResults,\n      HasTransformRetrieve extends true ? TRetrieveSuccessResult : TRetrieveResults,\n      TNewMutateResult,\n      TTransformResult,\n      THooks\n    >);\n  }\n\n  /**\n   * Add final transformation after mutations complete.\n   */\n  transform<TNewTransformResult>(\n    fn: (\n      ctx: HasMutate extends true\n        ? BuilderTransformContextWithMutate<\n            HasTransformRetrieve extends true ? TRetrieveSuccessResult : TRetrieveResults,\n            TMutateResult,\n            ExtractServiceFinalResults<TServiceCalls>,\n            ExtractServiceRetrieveResults<TServiceCalls>\n          >\n        : BuilderTransformContextWithoutMutate<\n            HasTransformRetrieve extends true ? TRetrieveSuccessResult : TRetrieveResults,\n            ExtractServiceFinalResults<TServiceCalls>,\n            ExtractServiceRetrieveResults<TServiceCalls>\n          >,\n    ) => TNewTransformResult,\n  ): ServiceTxBuilder<\n    TSchema,\n    TServiceCalls,\n    TRetrieveResults,\n    HasTransformRetrieve extends true ? TRetrieveSuccessResult : TRetrieveResults,\n    TMutateResult,\n    TNewTransformResult,\n    HasRetrieve,\n    HasTransformRetrieve,\n    HasMutate,\n    true, // HasTransform = true\n    THooks\n  > {\n    return new ServiceTxBuilder({\n      ...this.#state,\n      transformFn: fn,\n    } as unknown as ServiceTxBuilderState<\n      TSchema,\n      TServiceCalls,\n      TRetrieveResults,\n      HasTransformRetrieve extends true ? TRetrieveSuccessResult : TRetrieveResults,\n      TMutateResult,\n      TNewTransformResult,\n      THooks\n    >);\n  }\n\n  /**\n   * Build and return the TxResult.\n   */\n  build(): TxResult<\n    InferBuilderResultType<\n      TRetrieveResults,\n      TRetrieveSuccessResult,\n      TServiceCalls,\n      TMutateResult,\n      TTransformResult,\n      HasTransform,\n      HasMutate,\n      HasTransformRetrieve,\n      HasRetrieve\n    >,\n    InferBuilderRetrieveSuccessResult<\n      TRetrieveResults,\n      TRetrieveSuccessResult,\n      TMutateResult,\n      HasTransformRetrieve,\n      HasRetrieve,\n      HasMutate\n    >\n  > {\n    const state = this.#state;\n\n    // Convert builder state to legacy callbacks format\n    const callbacks: ServiceTxCallbacks<\n      TSchema,\n      TRetrieveResults,\n      TRetrieveSuccessResult,\n      TServiceCalls,\n      TMutateResult,\n      TTransformResult,\n      THooks\n    > = {\n      serviceCalls: state.withServiceCallsFn,\n      retrieve: state.retrieveFn,\n      retrieveSuccess: state.transformRetrieveFn,\n      mutate: state.mutateFn\n        ? (ctx) => {\n            return state.mutateFn!({\n              uow: ctx.uow,\n              retrieveResult: ctx.retrieveResult,\n              serviceIntermediateResult: ctx.serviceIntermediateResult,\n            });\n          }\n        : undefined,\n      success: state.transformFn\n        ? (ctx) => {\n            return state.transformFn!({\n              retrieveResult: ctx.retrieveResult,\n              mutateResult: ctx.mutateResult,\n              serviceResult: ctx.serviceResult,\n              serviceIntermediateResult: ctx.serviceIntermediateResult,\n            } as BuilderTransformContextWithMutate<\n              TRetrieveSuccessResult,\n              TMutateResult,\n              ExtractServiceFinalResults<TServiceCalls>,\n              ExtractServiceRetrieveResults<TServiceCalls>\n            >);\n          }\n        : undefined,\n    };\n\n    // Use the existing createServiceTx implementation\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    return createServiceTx(state.schema, callbacks as any, state.baseUow) as unknown as TxResult<\n      InferBuilderResultType<\n        TRetrieveResults,\n        TRetrieveSuccessResult,\n        TServiceCalls,\n        TMutateResult,\n        TTransformResult,\n        HasTransform,\n        HasMutate,\n        HasTransformRetrieve,\n        HasRetrieve\n      >,\n      InferBuilderRetrieveSuccessResult<\n        TRetrieveResults,\n        TRetrieveSuccessResult,\n        TMutateResult,\n        HasTransformRetrieve,\n        HasRetrieve,\n        HasMutate\n      >\n    >;\n  }\n}\n\n/**\n * Create a new ServiceTxBuilder for the given schema.\n */\nexport function createServiceTxBuilder<TSchema extends AnySchema, THooks extends HooksMap = {}>(\n  schema: TSchema,\n  baseUow: IUnitOfWork,\n  hooks?: THooks,\n): ServiceTxBuilder<\n  TSchema,\n  readonly [],\n  [],\n  [],\n  unknown,\n  unknown,\n  false,\n  false,\n  false,\n  false,\n  THooks\n> {\n  return new ServiceTxBuilder({\n    schema,\n    baseUow,\n    hooks,\n  });\n}\n\n/**\n * Internal state for HandlerTxBuilder\n */\ninterface HandlerTxBuilderState<\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  TServiceCalls extends readonly (TxResult<any, any> | undefined)[],\n  TRetrieveResults extends unknown[],\n  TRetrieveSuccessResult,\n  TMutateResult,\n  TTransformResult,\n  THooks extends HooksMap,\n> {\n  options: ExecuteTxOptions;\n  hooks?: THooks;\n  withServiceCallsFn?: () => TServiceCalls;\n  retrieveFn?: (context: {\n    forSchema: <S extends AnySchema, H extends HooksMap = THooks>(\n      schema: S,\n      hooks?: H,\n    ) => TypedUnitOfWork<S, [], unknown, H>;\n    idempotencyKey: string;\n    currentAttempt: number;\n  }) => TypedUnitOfWork<AnySchema, TRetrieveResults, unknown, HooksMap> | void;\n  transformRetrieveFn?: (\n    retrieveResult: TRetrieveResults,\n    serviceResult: ExtractServiceRetrieveResults<TServiceCalls>,\n  ) => TRetrieveSuccessResult;\n  mutateFn?: (\n    ctx: HandlerBuilderMutateContext<\n      TRetrieveSuccessResult,\n      ExtractServiceRetrieveResults<TServiceCalls>,\n      THooks\n    >,\n  ) => TMutateResult;\n  transformFn?: (\n    ctx:\n      | BuilderTransformContextWithMutate<\n          TRetrieveSuccessResult,\n          TMutateResult,\n          ExtractServiceFinalResults<TServiceCalls>,\n          ExtractServiceRetrieveResults<TServiceCalls>\n        >\n      | BuilderTransformContextWithoutMutate<\n          TRetrieveSuccessResult,\n          ExtractServiceFinalResults<TServiceCalls>,\n          ExtractServiceRetrieveResults<TServiceCalls>\n        >,\n  ) => TTransformResult;\n}\n\n/**\n * Builder for handler-level transactions.\n * Uses a fluent API to build up transaction callbacks with proper type inference.\n *\n * @example\n * ```ts\n * const result = await handlerTx()\n *   .withServiceCalls(() => [userService.getUser(id)])\n *   .mutate(({ forSchema, idempotencyKey, currentAttempt, serviceIntermediateResult }) => {\n *     return forSchema(ordersSchema).create(\"orders\", { ... });\n *   })\n *   .transform(({ mutateResult, serviceResult }) => ({ ... }))\n *   .execute();\n * ```\n */\nexport class HandlerTxBuilder<\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  TServiceCalls extends readonly (TxResult<any, any> | undefined)[],\n  TRetrieveResults extends unknown[],\n  TRetrieveSuccessResult,\n  TMutateResult,\n  TTransformResult,\n  HasRetrieve extends boolean,\n  HasTransformRetrieve extends boolean,\n  HasMutate extends boolean,\n  HasTransform extends boolean,\n  THooks extends HooksMap,\n> {\n  readonly #state: HandlerTxBuilderState<\n    TServiceCalls,\n    TRetrieveResults,\n    TRetrieveSuccessResult,\n    TMutateResult,\n    TTransformResult,\n    THooks\n  >;\n\n  constructor(\n    state: HandlerTxBuilderState<\n      TServiceCalls,\n      TRetrieveResults,\n      TRetrieveSuccessResult,\n      TMutateResult,\n      TTransformResult,\n      THooks\n    >,\n  ) {\n    this.#state = state;\n  }\n\n  /**\n   * Add dependencies to execute before this transaction.\n   */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  withServiceCalls<TNewDeps extends readonly (TxResult<any, any> | undefined)[]>(\n    fn: () => TNewDeps,\n  ): HandlerTxBuilder<\n    TNewDeps,\n    TRetrieveResults,\n    TRetrieveSuccessResult,\n    TMutateResult,\n    TTransformResult,\n    HasRetrieve,\n    HasTransformRetrieve,\n    HasMutate,\n    HasTransform,\n    THooks\n  > {\n    return new HandlerTxBuilder({\n      ...this.#state,\n      withServiceCallsFn: fn,\n    } as HandlerTxBuilderState<\n      TNewDeps,\n      TRetrieveResults,\n      TRetrieveSuccessResult,\n      TMutateResult,\n      TTransformResult,\n      THooks\n    >);\n  }\n\n  /**\n   * Add retrieval operations to the transaction.\n   * Return a TypedUnitOfWork from forSchema().find() to get typed results.\n   */\n  retrieve<TNewRetrieveResults extends unknown[]>(\n    fn: (context: {\n      forSchema: <S extends AnySchema, H extends HooksMap = THooks>(\n        schema: S,\n        hooks?: H,\n      ) => TypedUnitOfWork<S, [], unknown, H>;\n      idempotencyKey: string;\n      currentAttempt: number;\n    }) => TypedUnitOfWork<AnySchema, TNewRetrieveResults, unknown, HooksMap> | void,\n  ): HandlerTxBuilder<\n    TServiceCalls,\n    TNewRetrieveResults,\n    TNewRetrieveResults, // Default TRetrieveSuccessResult to TNewRetrieveResults\n    TMutateResult,\n    TTransformResult,\n    true, // HasRetrieve = true\n    false, // Reset HasTransformRetrieve since retrieve results changed\n    HasMutate,\n    HasTransform,\n    THooks\n  > {\n    return new HandlerTxBuilder({\n      ...this.#state,\n      retrieveFn: fn,\n      transformRetrieveFn: undefined, // Clear any existing transformRetrieve since results shape changed\n    } as unknown as HandlerTxBuilderState<\n      TServiceCalls,\n      TNewRetrieveResults,\n      TNewRetrieveResults,\n      TMutateResult,\n      TTransformResult,\n      THooks\n    >);\n  }\n\n  /**\n   * Transform retrieve results before passing to mutate.\n   */\n  transformRetrieve<TNewRetrieveSuccessResult>(\n    fn: (\n      retrieveResult: TRetrieveResults,\n      serviceResult: ExtractServiceRetrieveResults<TServiceCalls>,\n    ) => TNewRetrieveSuccessResult,\n  ): HandlerTxBuilder<\n    TServiceCalls,\n    TRetrieveResults,\n    TNewRetrieveSuccessResult,\n    TMutateResult,\n    TTransformResult,\n    HasRetrieve,\n    true, // HasTransformRetrieve = true\n    HasMutate,\n    HasTransform,\n    THooks\n  > {\n    return new HandlerTxBuilder({\n      ...this.#state,\n      transformRetrieveFn: fn,\n    } as unknown as HandlerTxBuilderState<\n      TServiceCalls,\n      TRetrieveResults,\n      TNewRetrieveSuccessResult,\n      TMutateResult,\n      TTransformResult,\n      THooks\n    >);\n  }\n\n  /**\n   * Add mutation operations based on retrieve results.\n   */\n  mutate<TNewMutateResult>(\n    fn: (\n      ctx: HandlerBuilderMutateContext<\n        HasTransformRetrieve extends true ? TRetrieveSuccessResult : TRetrieveResults,\n        ExtractServiceRetrieveResults<TServiceCalls>,\n        THooks\n      >,\n    ) => TNewMutateResult,\n  ): HandlerTxBuilder<\n    TServiceCalls,\n    TRetrieveResults,\n    HasTransformRetrieve extends true ? TRetrieveSuccessResult : TRetrieveResults,\n    TNewMutateResult,\n    TTransformResult,\n    HasRetrieve,\n    HasTransformRetrieve,\n    true, // HasMutate = true\n    HasTransform,\n    THooks\n  > {\n    return new HandlerTxBuilder({\n      ...this.#state,\n      mutateFn: fn,\n    } as unknown as HandlerTxBuilderState<\n      TServiceCalls,\n      TRetrieveResults,\n      HasTransformRetrieve extends true ? TRetrieveSuccessResult : TRetrieveResults,\n      TNewMutateResult,\n      TTransformResult,\n      THooks\n    >);\n  }\n\n  /**\n   * Add final transformation after mutations complete.\n   */\n  transform<TNewTransformResult>(\n    fn: (\n      ctx: HasMutate extends true\n        ? BuilderTransformContextWithMutate<\n            HasTransformRetrieve extends true ? TRetrieveSuccessResult : TRetrieveResults,\n            TMutateResult,\n            ExtractServiceFinalResults<TServiceCalls>,\n            ExtractServiceRetrieveResults<TServiceCalls>\n          >\n        : BuilderTransformContextWithoutMutate<\n            HasTransformRetrieve extends true ? TRetrieveSuccessResult : TRetrieveResults,\n            ExtractServiceFinalResults<TServiceCalls>,\n            ExtractServiceRetrieveResults<TServiceCalls>\n          >,\n    ) => TNewTransformResult,\n  ): HandlerTxBuilder<\n    TServiceCalls,\n    TRetrieveResults,\n    HasTransformRetrieve extends true ? TRetrieveSuccessResult : TRetrieveResults,\n    TMutateResult,\n    TNewTransformResult,\n    HasRetrieve,\n    HasTransformRetrieve,\n    HasMutate,\n    true, // HasTransform = true\n    THooks\n  > {\n    return new HandlerTxBuilder({\n      ...this.#state,\n      transformFn: fn,\n    } as unknown as HandlerTxBuilderState<\n      TServiceCalls,\n      TRetrieveResults,\n      HasTransformRetrieve extends true ? TRetrieveSuccessResult : TRetrieveResults,\n      TMutateResult,\n      TNewTransformResult,\n      THooks\n    >);\n  }\n\n  /**\n   * Execute the transaction and return the result.\n   */\n  execute(): Promise<\n    AwaitedPromisesInObject<\n      InferBuilderResultType<\n        TRetrieveResults,\n        TRetrieveSuccessResult,\n        TServiceCalls,\n        TMutateResult,\n        TTransformResult,\n        HasTransform,\n        HasMutate,\n        HasTransformRetrieve,\n        HasRetrieve\n      >\n    >\n  > {\n    const state = this.#state;\n\n    // Convert builder state to legacy callbacks format\n    const callbacks: HandlerTxCallbacks<\n      TRetrieveResults,\n      TRetrieveSuccessResult,\n      TServiceCalls,\n      TMutateResult,\n      TTransformResult,\n      THooks\n    > = {\n      serviceCalls: state.withServiceCallsFn,\n      retrieve: state.retrieveFn\n        ? (context) => {\n            return state.retrieveFn!({\n              forSchema: context.forSchema,\n              idempotencyKey: context.idempotencyKey,\n              currentAttempt: context.currentAttempt,\n            });\n          }\n        : undefined,\n      retrieveSuccess: state.transformRetrieveFn,\n      mutate: state.mutateFn\n        ? (ctx) => {\n            return state.mutateFn!({\n              forSchema: ctx.forSchema,\n              idempotencyKey: ctx.idempotencyKey,\n              currentAttempt: ctx.currentAttempt,\n              retrieveResult: ctx.retrieveResult,\n              serviceIntermediateResult: ctx.serviceIntermediateResult,\n            });\n          }\n        : undefined,\n      success: state.transformFn\n        ? (ctx) => {\n            return state.transformFn!({\n              retrieveResult: ctx.retrieveResult,\n              mutateResult: ctx.mutateResult,\n              serviceResult: ctx.serviceResult,\n              serviceIntermediateResult: ctx.serviceIntermediateResult,\n            } as BuilderTransformContextWithMutate<\n              TRetrieveSuccessResult,\n              TMutateResult,\n              ExtractServiceFinalResults<TServiceCalls>,\n              ExtractServiceRetrieveResults<TServiceCalls>\n            >);\n          }\n        : undefined,\n    };\n\n    // Use the existing executeTx implementation\n    return executeTx(callbacks as Parameters<typeof executeTx>[0], state.options) as Promise<\n      AwaitedPromisesInObject<\n        InferBuilderResultType<\n          TRetrieveResults,\n          TRetrieveSuccessResult,\n          TServiceCalls,\n          TMutateResult,\n          TTransformResult,\n          HasTransform,\n          HasMutate,\n          HasTransformRetrieve,\n          HasRetrieve\n        >\n      >\n    >;\n  }\n}\n\n/**\n * Create a new HandlerTxBuilder with the given options.\n */\nexport function createHandlerTxBuilder<THooks extends HooksMap = {}>(\n  options: ExecuteTxOptions,\n  hooks?: THooks,\n): HandlerTxBuilder<readonly [], [], [], unknown, unknown, false, false, false, false, THooks> {\n  return new HandlerTxBuilder({\n    options,\n    hooks,\n  });\n}\n"],"mappings":"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"}

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

@@ -190,12 +190,8 @@ type MutationResult = {
  * Executor interface for Unit of Work operations
  */
 interface UOWExecutor<TOutput, TRawResult = unknown> {
-  /**
-   * Execute the retrieval phase - all queries run in a single transaction for snapshot isolation
-   */
   executeRetrievalPhase(retrievalBatch: TOutput[]): Promise<TRawResult[]>;
   /**
-   * Execute the mutation phase - all queries run in a transaction with version checks
    * Returns success status indicating if mutations completed without conflicts,
    * and internal IDs for create operations (null if database doesn't support RETURNING)
    */
@@ -384,7 +380,7 @@ declare function buildJoinIndexed<TTable extends AnyTable, TJoinOut>(table: TTab
 interface IUnitOfWork {
   readonly state: UOWState;
   readonly name: string | undefined;
-  readonly nonce: string;
+  readonly idempotencyKey: string;
   readonly retrievalPhase: Promise<unknown[]>;
   readonly mutationPhase: Promise<void>;
   executeRetrieve(): Promise<unknown[]>;
@@ -394,7 +390,11 @@ interface IUnitOfWork {
   getRetrievalOperations(): ReadonlyArray<RetrievalOperation<AnySchema>>;
   getMutationOperations(): ReadonlyArray<MutationOperation<AnySchema>>;
   getCreatedIds(): FragnoId[];
-  restrict(): IUnitOfWork;
+  restrict(options?: {
+    readyFor?: "mutation" | "retrieval" | "none";
+  }): IUnitOfWork;
+  signalReadyForRetrieval(): void;
+  signalReadyForMutation(): void;
   reset(): void;
   forSchema<TOtherSchema extends AnySchema, TOtherHooks extends HooksMap = {}>(schema: TOtherSchema, hooks?: TOtherHooks): TypedUnitOfWork<TOtherSchema, [], any, TOtherHooks>;
   registerSchema(schema: AnySchema, namespace: string): void;
@@ -413,7 +413,7 @@ declare function createUnitOfWork(compiler: UOWCompiler<unknown>, executor: UOWE
 interface UnitOfWorkConfig {
   dryRun?: boolean;
   onQuery?: (query: unknown) => void;
-  nonce?: string;
+  idempotencyKey?: string;
 }
 /**
  * Unit of Work implementation with optimistic concurrency control
@@ -467,8 +467,15 @@ declare class UnitOfWork<const TRawInput = unknown> implements IUnitOfWork {
    * Create a restricted child UOW that cannot execute phases.
    * The child shares the same operation storage but must signal readiness
    * before the parent can execute each phase.
+   *
+   * @param options.readyFor - Controls automatic readiness signaling:
+   *   - "mutation" (default): Signals ready for both retrieval and mutation immediately
+   *   - "retrieval": Signals ready for retrieval only
+   *   - "none": No automatic signaling, caller must signal manually
    */
-  restrict(): UnitOfWork<TRawInput>;
+  restrict(options?: {
+    readyFor?: "mutation" | "retrieval" | "none";
+  }): UnitOfWork<TRawInput>;
   /**
    * Signal that this child is ready for retrieval phase execution.
    * Only valid for restricted (child) UOWs.
@@ -494,7 +501,7 @@ declare class UnitOfWork<const TRawInput = unknown> implements IUnitOfWork {
   getTriggeredHooks(): ReadonlyArray<TriggeredHook>;
   get state(): UOWState;
   get name(): string | undefined;
-  get nonce(): string;
+  get idempotencyKey(): string;
   /**
    * Promise that resolves when the retrieval phase is executed
    * Service methods can await this to coordinate multi-phase logic
@@ -565,7 +572,7 @@ declare class TypedUnitOfWork<const TSchema extends AnySchema, const TRetrievalR
   get $results(): Prettify<TRetrievalResults>;
   get schema(): TSchema;
   get name(): string | undefined;
-  get nonce(): string;
+  get idempotencyKey(): string;
   get state(): UOWState;
   get retrievalPhase(): Promise<TRetrievalResults>;
   get mutationPhase(): Promise<void>;
@@ -576,7 +583,11 @@ declare class TypedUnitOfWork<const TSchema extends AnySchema, const TRetrievalR
   executeMutations(): Promise<{
     success: boolean;
   }>;
-  restrict(): IUnitOfWork;
+  restrict(options?: {
+    readyFor?: "mutation" | "retrieval" | "none";
+  }): IUnitOfWork;
+  signalReadyForRetrieval(): void;
+  signalReadyForMutation(): void;
   reset(): void;
   forSchema<TOtherSchema extends AnySchema, TOtherHooks extends HooksMap = {}>(schema: TOtherSchema, hooks?: TOtherHooks): TypedUnitOfWork<TOtherSchema, [], TRawInput, TOtherHooks>;
   registerSchema(schema: AnySchema, namespace: string): void;
@@ -590,6 +601,19 @@ declare class TypedUnitOfWork<const TSchema extends AnySchema, const TRetrievalR
   findFirst<TTableName extends keyof TSchema["tables"] & string, const TBuilderResult>(tableName: TTableName, builderFn: (builder: Omit<FindBuilder<TSchema["tables"][TTableName]>, "build">) => TBuilderResult): TypedUnitOfWork<TSchema, [...TRetrievalResults, SelectResult<TSchema["tables"][TTableName], ExtractJoinOut<TBuilderResult>, Extract<ExtractSelect<TBuilderResult>, SelectClause<TSchema["tables"][TTableName]>>> | null], TRawInput, THooks>;
   findFirst<TTableName extends keyof TSchema["tables"] & string>(tableName: TTableName): TypedUnitOfWork<TSchema, [...TRetrievalResults, SelectResult<TSchema["tables"][TTableName], {}, true> | null], TRawInput, THooks>;
   findWithCursor<TTableName extends keyof TSchema["tables"] & string, const TBuilderResult>(tableName: TTableName, builderFn: (builder: Omit<FindBuilder<TSchema["tables"][TTableName]>, "build">) => TBuilderResult): TypedUnitOfWork<TSchema, [...TRetrievalResults, CursorResult<SelectResult<TSchema["tables"][TTableName], ExtractJoinOut<TBuilderResult>, Extract<ExtractSelect<TBuilderResult>, SelectClause<TSchema["tables"][TTableName]>>>>], TRawInput, THooks>;
+  /**
+   * Generate a new ID for a table without creating a record.
+   * This is useful when you need to reference an ID before actually creating the record,
+   * or when you need to pass the ID to external services.
+   *
+   * @example
+   * ```ts
+   * const userId = uow.generateId("users");
+   * // Use userId in related records or pass to external services
+   * uow.create("users", { id: userId, name: "John" });
+   * ```
+   */
+  generateId<TableName extends keyof TSchema["tables"] & string>(tableName: TableName): FragnoId;
   create<TableName extends keyof TSchema["tables"] & string>(tableName: TableName, values: TableToInsertValues<TSchema["tables"][TableName]>): FragnoId;
   update<TableName extends keyof TSchema["tables"] & string>(tableName: TableName, id: FragnoId | string, builderFn: (builder: Omit<UpdateBuilder<TSchema["tables"][TableName]>, "build">) => Omit<UpdateBuilder<TSchema["tables"][TableName]>, "build"> | void): void;
   delete<TableName extends keyof TSchema["tables"] & string>(tableName: TableName, id: FragnoId | string, builderFn?: (builder: Omit<DeleteBuilder, "build">) => Omit<DeleteBuilder, "build"> | void): void;

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

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

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

@@ -1,6 +1,7 @@
+import { generateId } from "../../schema/generate-id.js";
 import { FragnoId } from "../../schema/create.js";
-import { buildCondition } from "../condition-builder.js";
 import { Cursor } from "../cursor.js";
+import { buildCondition } from "../condition-builder.js";
 
 //#region src/query/unit-of-work/unit-of-work.ts
 /**
@@ -535,7 +536,7 @@ var UOWChildCoordinator = class {
 var UnitOfWork = class UnitOfWork {
 	#name;
 	#config;
-	#nonce;
+	#idempotencyKey;
 	#state = "building-retrieval";
 	#retrievalOps = [];
 	#mutationOps = [];
@@ -558,7 +559,7 @@ var UnitOfWork = class UnitOfWork {
 		this.#schemaNamespaceMap = schemaNamespaceMap ?? /* @__PURE__ */ new WeakMap();
 		this.#name = name;
 		this.#config = config;
-		this.#nonce = config?.nonce ?? crypto.randomUUID();
+		this.#idempotencyKey = config?.idempotencyKey ?? crypto.randomUUID();
 	}
 	/**
 	* Register a schema with its namespace for cross-fragment operations.
@@ -582,14 +583,19 @@ var UnitOfWork = class UnitOfWork {
 	* Create a restricted child UOW that cannot execute phases.
 	* The child shares the same operation storage but must signal readiness
 	* before the parent can execute each phase.
+	*
+	* @param options.readyFor - Controls automatic readiness signaling:
+	*   - "mutation" (default): Signals ready for both retrieval and mutation immediately
+	*   - "retrieval": Signals ready for retrieval only
+	*   - "none": No automatic signaling, caller must signal manually
 	*/
-	restrict() {
+	restrict(options) {
+		const readyFor = options?.readyFor ?? "mutation";
 		const child = new UnitOfWork(this.#compiler, this.#executor, this.#decoder, this.#name, {
 			...this.#config,
-			nonce: this.#nonce
+			idempotencyKey: this.#idempotencyKey
 		}, this.#schemaNamespaceMap);
 		child.#coordinator.setAsRestricted(this, this.#coordinator);
-		child.#state = this.#state;
 		child.#retrievalOps = this.#retrievalOps;
 		child.#mutationOps = this.#mutationOps;
 		child.#retrievalResults = this.#retrievalResults;
@@ -600,8 +606,8 @@ var UnitOfWork = class UnitOfWork {
 		child.#mutationError = this.#mutationError;
 		child.#triggeredHooks = this.#triggeredHooks;
 		this.#coordinator.addChild(child);
-		child.signalReadyForRetrieval();
-		child.signalReadyForMutation();
+		if (readyFor === "mutation" || readyFor === "retrieval") child.signalReadyForRetrieval();
+		if (readyFor === "mutation") child.signalReadyForMutation();
 		return child;
 	}
 	/**
@@ -653,13 +659,13 @@ var UnitOfWork = class UnitOfWork {
 		return this.#triggeredHooks;
 	}
 	get state() {
-		return this.#state;
+		return this.#coordinator.parent?.state ?? this.#state;
 	}
 	get name() {
 		return this.#name;
 	}
-	get nonce() {
-		return this.#nonce;
+	get idempotencyKey() {
+		return this.#idempotencyKey;
 	}
 	/**
 	* Promise that resolves when the retrieval phase is executed
@@ -738,7 +744,10 @@ var UnitOfWork = class UnitOfWork {
 			}
 			const result = await this.#executor.executeMutationPhase(mutationBatch);
 			this.#state = "executed";
-			if (result.success) this.#createdInternalIds = result.createdInternalIds;
+			if (result.success) {
+				this.#createdInternalIds.length = 0;
+				this.#createdInternalIds.push(...result.createdInternalIds);
+			}
 			this.#mutationPhaseDeferred.resolve();
 			return { success: result.success };
 		} catch (error) {
@@ -763,7 +772,7 @@ var UnitOfWork = class UnitOfWork {
 	* Add a retrieval operation (used by TypedUnitOfWork)
 	*/
 	addRetrievalOperation(op) {
-		if (this.#state !== "building-retrieval") throw new Error(`Cannot add retrieval operation in state ${this.#state}. Must be in building-retrieval state.`);
+		if (this.state !== "building-retrieval") throw new Error(`Cannot add retrieval operation in state ${this.state}. Must be in building-retrieval state.`);
 		this.#retrievalOps.push(op);
 		return this.#retrievalOps.length - 1;
 	}
@@ -772,7 +781,7 @@ var UnitOfWork = class UnitOfWork {
 	* Add a mutation operation (used by TypedUnitOfWork)
 	*/
 	addMutationOperation(op) {
-		if (this.#state === "executed") throw new Error(`Cannot add mutation operation in executed state.`);
+		if (this.state === "executed") throw new Error(`Cannot add mutation operation in executed state.`);
 		this.#mutationOps.push(op);
 	}
 	/**
@@ -784,7 +793,7 @@ var UnitOfWork = class UnitOfWork {
 	* @returns Array of FragnoIds in the same order as create() calls
 	*/
 	getCreatedIds() {
-		if (this.#state !== "executed") throw new Error(`getCreatedIds() can only be called after executeMutations(). Current state: ${this.#state}`);
+		if (this.state !== "executed") throw new Error(`getCreatedIds() can only be called after executeMutations(). Current state: ${this.state}`);
 		const createdIds = [];
 		let createIndex = 0;
 		for (const op of this.#mutationOps) if (op.type === "create") {
@@ -845,8 +854,8 @@ var TypedUnitOfWork = class {
 	get name() {
 		return this.#uow.name;
 	}
-	get nonce() {
-		return this.#uow.nonce;
+	get idempotencyKey() {
+		return this.#uow.idempotencyKey;
 	}
 	get state() {
 		return this.#uow.state;
@@ -881,8 +890,14 @@ var TypedUnitOfWork = class {
 	async executeMutations() {
 		return this.#uow.executeMutations();
 	}
-	restrict() {
-		return this.#uow.restrict();
+	restrict(options) {
+		return this.#uow.restrict(options);
+	}
+	signalReadyForRetrieval() {
+		this.#uow.signalReadyForRetrieval();
+	}
+	signalReadyForMutation() {
+		this.#uow.signalReadyForMutation();
 	}
 	reset() {
 		return this.#uow.reset();
@@ -952,6 +967,21 @@ var TypedUnitOfWork = class {
 		this.#operationIndices.push(operationIndex);
 		return this;
 	}
+	/**
+	* Generate a new ID for a table without creating a record.
+	* This is useful when you need to reference an ID before actually creating the record,
+	* or when you need to pass the ID to external services.
+	*
+	* @example
+	* ```ts
+	* const userId = uow.generateId("users");
+	* // Use userId in related records or pass to external services
+	* uow.create("users", { id: userId, name: "John" });
+	* ```
+	*/
+	generateId(tableName) {
+		return generateId(this.#schema, tableName);
+	}
 	create(tableName, values) {
 		const tableSchema = this.#schema.tables[tableName];
 		if (!tableSchema) throw new Error(`Table ${tableName} not found in schema`);