@abloatai/ablo 0.24.0 → 0.26.0

package/dist/transactions/TransactionQueue.d.ts

@@ -13,50 +13,13 @@ import { Model } from '../Model.js';
 import { SyncPosition } from '../sync/syncPosition.js';
 import type { WriteOptions } from '../interfaces/index.js';
 import type { StaleNotification, ReadDependency } from '../coordination/schema.js';
-export interface UserContext {
-    userId: string;
-    organizationId: string;
-    role?: string;
-    teamIds?: string[];
-}
-/** Wire-format mutation payload (post-projection). */
-type MutationInput = Record<string, unknown>;
-export interface Transaction {
-    id: string;
-    type: 'create' | 'update' | 'delete' | 'archive' | 'unarchive';
-    modelName: string;
-    modelId: string;
-    modelKey: string;
-    data?: MutationInput;
-    previousData?: MutationInput | null;
-    context: UserContext;
-    status: 'pending' | 'executing' | 'awaiting_delta' | 'completed' | 'failed' | 'rolled_back';
-    createdAt: number;
-    attempts: number;
-    priority: 'normal' | 'high';
-    priorityScore: number;
-    writeOptions?: WriteOptions;
-    batchId?: string;
-    /** Completed locally without a server operation; no sync echo will arrive. */
-    localOnly?: boolean;
-    /** LINEAR PATTERN: syncId threshold - transaction confirms when delta.id >= this value */
-    syncIdNeededForCompletion?: number;
-    /**
-     * Resolves when the server has confirmed this transaction (delta arrived
-     * or HTTP ack). Rejects with the originating error if the transaction is
-     * permanently rolled back. Name matches the queue's existing `'confirmed'`
-     * status vocabulary (`commits.create({wait:'confirmed'})`,
-     * `waitForConfirmation`) — gives call sites a single `await` point for
-     * "did my write land?", so failures surface at the source instead of
-     * leaking via silent pool rollback. The rejection error is the same
-     * `AbloError` recorded on the queue's `transaction:failed` event.
-     */
-    confirmation?: Promise<void>;
-}
+import { type MutationInput, type Transaction, type UserContext } from './commitPayload.js';
+export type { Transaction, UserContext } from './commitPayload.js';
 /**
  * A raw multi-op commit transaction queued via `ablo.commits.create()`.
  *
- * Distinct from the per-model `Transaction` above: operations are
+ * Distinct from the per-model `Transaction` (see `./commitPayload.js`):
+ * operations are
  * pre-built by the caller and the envelope is atomic — no coalescing,
  * no FK reordering, no optimistic local apply. The lane shares the
  * same `mutationExecutor.commit()` underneath as the model-proxy
@@ -65,7 +28,7 @@ export interface Transaction {
 interface CommitTransaction {
     id: string;
     kind: 'commit';
-    operations: Array<{
+    operations: {
         type: string;
         model: string;
         id: string;
@@ -73,7 +36,7 @@ interface CommitTransaction {
         transactionId?: string;
         readAt?: number | null;
         onStale?: 'reject' | 'overwrite' | 'notify' | null;
-    }>;
+    }[];
     causedByTaskId?: string | null;
     /** Batch-level read dependencies (STORM read-set), forwarded to the executor. */
     reads?: ReadDependency[] | null;
@@ -143,7 +106,6 @@ export declare class TransactionQueue extends EventEmitter {
     private computePriorityScore;
     private ensureDerivedFields;
     private entityKey;
-    private isTransactionForModel;
     private resolveConfirmation;
     private takeUnsentCreateForModel;
     private cancelUnsentCreateForDelete;
@@ -151,13 +113,11 @@ export declare class TransactionQueue extends EventEmitter {
     private completeLocalDelete;
     private deferDeleteUntilCreateSettles;
     private releaseDeferredDeletesForCreate;
-    private mergeUpdateData;
     private config;
     private executingCount;
     private optimisticUpdates;
     private commitNotifications;
-    private deltaConfirmationTimeouts;
-    private deltaConfirmationRetries;
+    private readonly deltaConfirmation;
     private isConnectedFn;
     private commitOfflineGraceTimer;
     /**
@@ -171,9 +131,6 @@ export declare class TransactionQueue extends EventEmitter {
     /** Applied-cursor alias, kept so the many internal read sites stay legible. */
     private get lastSeenSyncId();
     private noteAck;
-    private static readonly DELTA_MAX_RETRIES;
-    private static readonly DELTA_INITIAL_TIMEOUT_MS;
-    private static readonly DELTA_MAX_TIMEOUT_MS;
     private batchIndex;
     /**
      * Resolvers for per-transaction `confirmation` promises. Populated in
@@ -288,13 +245,13 @@ export declare class TransactionQueue extends EventEmitter {
     /**
      * Batch upload attachments — delegates to MutationExecutor
      */
-    batchUploadAttachments(_files: File[], items: Array<{
+    batchUploadAttachments(_files: File[], items: {
         id: string;
         [key: string]: unknown;
-    }>, _context: UserContext): Promise<Array<{
+    }[], _context: UserContext): Promise<{
         id: string;
         url: string;
-    }>>;
+    }[]>;
     /**
      * Archive operation
      */
@@ -321,11 +278,11 @@ export declare class TransactionQueue extends EventEmitter {
     /**
      * LINEAR PATTERN: Confirm all awaiting transactions when delta with syncId >= threshold arrives.
      * This replaces clientMutationId echoing - transactions are confirmed by sync ID threshold.
+     * Policy + timeout maps live in the `./deltaConfirmation.js` leaf.
      * @param syncId - The sync ID of the received delta
      */
     onDeltaReceived(syncId: number): void;
     private scheduleDeltaConfirmationTimeout;
-    private cancelDeltaConfirmationTimeout;
     /**
      * Wait for a transaction to be confirmed via delta echo (Linear pattern)
      * Reuses existing timeout mechanism from scheduleDeltaConfirmationTimeout
@@ -388,7 +345,8 @@ export declare class TransactionQueue extends EventEmitter {
      */
     handleConflict(transaction: Transaction, serverData: MutationInput): Promise<void>;
     /**
-     * Optimistic updates
+     * Optimistic updates — apply/rollback rules live in `./optimistic.js`;
+     * these delegates bind the host-owned ledger + event emitter.
      */
     private applyOptimisticCreate;
     private applyOptimisticUpdate;
@@ -402,6 +360,13 @@ export declare class TransactionQueue extends EventEmitter {
      * Persistence
      */
     loadPersistedTransactions(database: Database): Promise<void>;
+    /**
+     * Validate + rehydrate one persisted row (the T1.8 IDB replay boundary).
+     * Rows written by other subsystems into the same store (`'queue'`,
+     * `'awaiting_delta'`) are skipped silently; rows that fail the
+     * persisted-transaction schema (older SDK versions, corruption) are
+     * DROPPED with an observability capture instead of replayed as commits.
+     */
     private deserializeTransaction;
     /**
      * Cancel transactions for a specific model
@@ -529,4 +494,3 @@ export declare class TransactionQueue extends EventEmitter {
      */
     dispose(): void;
 }
-export {};