@edgebasejs/client-core 0.1.8 → 0.1.9

package/README.md

@@ -0,0 +1,15 @@
+# @edgebasejs/client-core
+
+Core client sync engine and storage abstractions for EdgeBase.
+
+## Install
+
+```bash
+pnpm add @edgebasejs/client-core
+```
+
+## Usage
+
+```ts
+import { ClientSyncEngine, OutboxManager } from '@edgebasejs/client-core';
+```

package/dist/client-core/src/index.d.ts

@@ -3,4 +3,8 @@ export * from './outbox';
 export * from './storage';
 export * from './auth';
 export * from './conflict';
+export * from './realtime/subscription-handler';
+export * from './realtime/realtime-sync-manager';
+export * from './mutations/transaction-hook';
+export * from './mutations/batch-processor-client';
 //# sourceMappingURL=index.d.ts.map

package/dist/client-core/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,iCAAiC,CAAC;AAChD,cAAc,kCAAkC,CAAC;AACjD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oCAAoC,CAAC"}

package/dist/client-core/src/index.js

@@ -3,4 +3,8 @@ export * from './outbox';
 export * from './storage';
 export * from './auth';
 export * from './conflict';
+export * from './realtime/subscription-handler';
+export * from './realtime/realtime-sync-manager';
+export * from './mutations/transaction-hook';
+export * from './mutations/batch-processor-client';
 //# sourceMappingURL=index.js.map

package/dist/client-core/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,iCAAiC,CAAC;AAChD,cAAc,kCAAkC,CAAC;AACjD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oCAAoC,CAAC"}

package/dist/client-core/src/mutations/batch-processor-client.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Client-side batch processor for coordinating batch mutations
+ */
+export interface BatchOperation {
+    entity: string;
+    id: string;
+    operation: 'create' | 'update' | 'delete';
+    data?: Record<string, any>;
+    version?: number;
+}
+export interface BatchRequest {
+    create?: BatchOperation[];
+    update?: BatchOperation[];
+    delete?: BatchOperation[];
+    atomic?: boolean;
+    isolationLevel?: 'READ_UNCOMMITTED' | 'READ_COMMITTED' | 'SERIALIZABLE';
+}
+export interface BatchResult {
+    applied: Array<BatchOperation & {
+        version: number;
+        serverTimestamp: number;
+    }>;
+    conflicts: Array<{
+        entity: string;
+        id: string;
+        operation: string;
+        clientVersion?: number;
+        serverVersion: number;
+        serverData: Record<string, any>;
+    }>;
+    errors: Array<{
+        entity: string;
+        id: string;
+        operation: string;
+        error: string;
+        code: string;
+    }>;
+    appliedCount: number;
+    conflictCount: number;
+    errorCount: number;
+}
+/**
+ * Client-side batch processor for batch mutations
+ */
+export declare class ClientBatchProcessor {
+    private apiUrl;
+    private accessToken;
+    private batchListeners;
+    constructor(apiUrl: string, accessToken: string);
+    /**
+     * Process a batch of operations
+     */
+    processBatch(request: BatchRequest): Promise<BatchResult>;
+    /**
+     * Subscribe to batch operation results
+     */
+    subscribe(listener: (result: BatchResult) => void): () => void;
+    /**
+     * Notify listeners of batch results
+     */
+    private notifyListeners;
+    /**
+     * Reset processor state
+     */
+    reset(): void;
+}
+//# sourceMappingURL=batch-processor-client.d.ts.map

package/dist/client-core/src/mutations/batch-processor-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-processor-client.d.ts","sourceRoot":"","sources":["../../../../src/mutations/batch-processor-client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC;IAC1B,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC;IAC1B,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,kBAAkB,GAAG,gBAAgB,GAAG,cAAc,CAAC;CACzE;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,KAAK,CAAC,cAAc,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9E,SAAS,EAAE,KAAK,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,EAAE,EAAE,MAAM,CAAC;QACX,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,aAAa,EAAE,MAAM,CAAC;QACtB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KACjC,CAAC,CAAC;IACH,MAAM,EAAE,KAAK,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,EAAE,EAAE,MAAM,CAAC;QACX,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,cAAc,CAA4C;gBAEtD,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAK/C;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAuB/D;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,GAAG,MAAM,IAAI;IAK9D;;OAEG;IACH,OAAO,CAAC,eAAe;IAUvB;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}

package/dist/client-core/src/mutations/batch-processor-client.js

@@ -0,0 +1,64 @@
+/**
+ * Client-side batch processor for coordinating batch mutations
+ */
+/**
+ * Client-side batch processor for batch mutations
+ */
+export class ClientBatchProcessor {
+    constructor(apiUrl, accessToken) {
+        this.batchListeners = new Set();
+        this.apiUrl = apiUrl;
+        this.accessToken = accessToken;
+    }
+    /**
+     * Process a batch of operations
+     */
+    async processBatch(request) {
+        try {
+            const response = await fetch(`${this.apiUrl}/sync/batch`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    Authorization: `Bearer ${this.accessToken}`,
+                },
+                body: JSON.stringify(request),
+            });
+            if (!response.ok) {
+                throw new Error(`Failed to process batch: ${response.statusText}`);
+            }
+            const result = await response.json();
+            this.notifyListeners(result);
+            return result;
+        }
+        catch (error) {
+            throw new Error(`Batch processing failed: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Subscribe to batch operation results
+     */
+    subscribe(listener) {
+        this.batchListeners.add(listener);
+        return () => this.batchListeners.delete(listener);
+    }
+    /**
+     * Notify listeners of batch results
+     */
+    notifyListeners(result) {
+        for (const listener of this.batchListeners) {
+            try {
+                listener(result);
+            }
+            catch (error) {
+                console.error('Listener error:', error);
+            }
+        }
+    }
+    /**
+     * Reset processor state
+     */
+    reset() {
+        this.batchListeners.clear();
+    }
+}
+//# sourceMappingURL=batch-processor-client.js.map

package/dist/client-core/src/mutations/batch-processor-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-processor-client.js","sourceRoot":"","sources":["../../../../src/mutations/batch-processor-client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAwCH;;GAEG;AACH,MAAM,OAAO,oBAAoB;IAK/B,YAAY,MAAc,EAAE,WAAmB;QAFvC,mBAAc,GAAG,IAAI,GAAG,EAAiC,CAAC;QAGhE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAAC,OAAqB;QACtC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,aAAa,EAAE;gBACxD,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;oBAClC,aAAa,EAAE,UAAU,IAAI,CAAC,WAAW,EAAE;iBAC5C;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;aAC9B,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,4BAA4B,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;YACrE,CAAC;YAED,MAAM,MAAM,GAAgB,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YAClD,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;YAC7B,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,4BAA4B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC;QAC1G,CAAC;IACH,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,QAAuC;QAC/C,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAClC,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACpD,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,MAAmB;QACzC,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YAC3C,IAAI,CAAC;gBACH,QAAQ,CAAC,MAAM,CAAC,CAAC;YACnB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;IAC9B,CAAC;CACF"}

package/dist/client-core/src/mutations/transaction-hook.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Client-side transaction management
+ * Provides useTransaction hook for ACID transactions
+ */
+export interface TransactionChange {
+    entity: string;
+    recordId: string;
+    operation: 'create' | 'update' | 'delete';
+    data: Record<string, any>;
+}
+export interface PendingTransaction {
+    id: string;
+    changes: TransactionChange[];
+    status: 'pending' | 'committing' | 'committed' | 'rolled_back' | 'failed';
+    error?: string;
+    appliedCount?: number;
+    conflictCount?: number;
+}
+export interface TransactionOptions {
+    isolationLevel?: 'READ_UNCOMMITTED' | 'READ_COMMITTED' | 'SERIALIZABLE';
+    autoRetry?: boolean;
+    maxRetries?: number;
+    onStatusChange?: (status: string) => void;
+}
+/**
+ * Transaction manager for coordinating client-side transactions
+ */
+export declare class ClientTransactionManager {
+    private apiUrl;
+    private accessToken;
+    private currentTransaction;
+    private transactionListeners;
+    constructor(apiUrl: string, accessToken: string);
+    /**
+     * Begin a new transaction
+     */
+    begin(options?: TransactionOptions): Promise<string>;
+    /**
+     * Add a change to the current transaction
+     */
+    addChange(entity: string, recordId: string, operation: 'create' | 'update' | 'delete', data: Record<string, any>): void;
+    /**
+     * Commit the current transaction
+     */
+    commit(): Promise<{
+        success: boolean;
+        appliedCount: number;
+        errors: string[];
+    }>;
+    /**
+     * Rollback the current transaction
+     */
+    rollback(): Promise<void>;
+    /**
+     * Get current transaction status
+     */
+    getStatus(): Promise<{
+        status: string;
+        changeCount: number;
+        appliedCount?: number;
+        conflictCount?: number;
+    }>;
+    /**
+     * Get current transaction
+     */
+    getCurrentTransaction(): PendingTransaction | null;
+    /**
+     * Subscribe to transaction changes
+     */
+    subscribe(listener: (txn: PendingTransaction) => void): () => void;
+    /**
+     * Notify listeners of transaction changes
+     */
+    private notifyListeners;
+    /**
+     * Reset transaction state (useful for cleanup)
+     */
+    reset(): void;
+}
+//# sourceMappingURL=transaction-hook.d.ts.map

package/dist/client-core/src/mutations/transaction-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-hook.d.ts","sourceRoot":"","sources":["../../../../src/mutations/transaction-hook.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC1C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,MAAM,EAAE,SAAS,GAAG,YAAY,GAAG,WAAW,GAAG,aAAa,GAAG,QAAQ,CAAC;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,cAAc,CAAC,EAAE,kBAAkB,GAAG,gBAAgB,GAAG,cAAc,CAAC;IACxE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3C;AAED;;GAEG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,kBAAkB,CAAmC;IAC7D,OAAO,CAAC,oBAAoB,CAAgD;gBAEhE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAK/C;;OAEG;IACG,KAAK,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC;IAsC9D;;OAEG;IACH,SAAS,CACP,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,EACzC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACxB,IAAI;IAmBP;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC;QACtB,OAAO,EAAE,OAAO,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC;IAiDF;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IA4B/B;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC;QACzB,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;IA4BF;;OAEG;IACH,qBAAqB,IAAI,kBAAkB,GAAG,IAAI;IAIlD;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,kBAAkB,KAAK,IAAI,GAAG,MAAM,IAAI;IAKlE;;OAEG;IACH,OAAO,CAAC,eAAe;IAYvB;;OAEG;IACH,KAAK,IAAI,IAAI;CAId"}

package/dist/client-core/src/mutations/transaction-hook.js

@@ -0,0 +1,204 @@
+/**
+ * Client-side transaction management
+ * Provides useTransaction hook for ACID transactions
+ */
+/**
+ * Transaction manager for coordinating client-side transactions
+ */
+export class ClientTransactionManager {
+    constructor(apiUrl, accessToken) {
+        this.currentTransaction = null;
+        this.transactionListeners = new Set();
+        this.apiUrl = apiUrl;
+        this.accessToken = accessToken;
+    }
+    /**
+     * Begin a new transaction
+     */
+    async begin(options = {}) {
+        if (this.currentTransaction && this.currentTransaction.status === 'pending') {
+            throw new Error('Transaction already in progress');
+        }
+        try {
+            const response = await fetch(`${this.apiUrl}/transactions/begin`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    Authorization: `Bearer ${this.accessToken}`,
+                },
+                body: JSON.stringify({
+                    isolationLevel: options.isolationLevel || 'READ_COMMITTED',
+                }),
+            });
+            if (!response.ok) {
+                throw new Error(`Failed to begin transaction: ${response.statusText}`);
+            }
+            const data = await response.json();
+            const transactionId = data.transactionId;
+            // Create pending transaction
+            this.currentTransaction = {
+                id: transactionId,
+                changes: [],
+                status: 'pending',
+            };
+            this.notifyListeners();
+            return transactionId;
+        }
+        catch (error) {
+            throw new Error(`Transaction begin failed: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Add a change to the current transaction
+     */
+    addChange(entity, recordId, operation, data) {
+        if (!this.currentTransaction) {
+            throw new Error('No transaction in progress');
+        }
+        if (this.currentTransaction.status !== 'pending') {
+            throw new Error(`Cannot add changes to ${this.currentTransaction.status} transaction`);
+        }
+        this.currentTransaction.changes.push({
+            entity,
+            recordId,
+            operation,
+            data,
+        });
+        this.notifyListeners();
+    }
+    /**
+     * Commit the current transaction
+     */
+    async commit() {
+        if (!this.currentTransaction) {
+            throw new Error('No transaction in progress');
+        }
+        const transactionId = this.currentTransaction.id;
+        try {
+            this.currentTransaction.status = 'committing';
+            this.notifyListeners();
+            const response = await fetch(`${this.apiUrl}/transactions/${transactionId}/commit`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    Authorization: `Bearer ${this.accessToken}`,
+                },
+            });
+            if (!response.ok) {
+                this.currentTransaction.status = 'failed';
+                const error = await response.text();
+                this.currentTransaction.error = error;
+                this.notifyListeners();
+                throw new Error(`Failed to commit transaction: ${response.statusText}`);
+            }
+            const data = await response.json();
+            this.currentTransaction.status = 'committed';
+            this.currentTransaction.appliedCount = data.appliedCount;
+            this.currentTransaction.conflictCount = data.errors?.length || 0;
+            this.notifyListeners();
+            const result = {
+                success: true,
+                appliedCount: data.appliedCount,
+                errors: data.errors || [],
+            };
+            return result;
+        }
+        catch (error) {
+            this.currentTransaction.status = 'failed';
+            this.currentTransaction.error = error instanceof Error ? error.message : 'Unknown error';
+            this.notifyListeners();
+            throw error;
+        }
+    }
+    /**
+     * Rollback the current transaction
+     */
+    async rollback() {
+        if (!this.currentTransaction) {
+            throw new Error('No transaction in progress');
+        }
+        const transactionId = this.currentTransaction.id;
+        try {
+            const response = await fetch(`${this.apiUrl}/transactions/${transactionId}/rollback`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    Authorization: `Bearer ${this.accessToken}`,
+                },
+            });
+            if (!response.ok) {
+                throw new Error(`Failed to rollback transaction: ${response.statusText}`);
+            }
+            this.currentTransaction.status = 'rolled_back';
+            this.notifyListeners();
+            this.currentTransaction = null;
+        }
+        catch (error) {
+            throw new Error(`Transaction rollback failed: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Get current transaction status
+     */
+    async getStatus() {
+        if (!this.currentTransaction) {
+            throw new Error('No transaction in progress');
+        }
+        try {
+            const response = await fetch(`${this.apiUrl}/transactions/${this.currentTransaction.id}`, {
+                headers: {
+                    Authorization: `Bearer ${this.accessToken}`,
+                },
+            });
+            if (!response.ok) {
+                throw new Error(`Failed to get transaction status: ${response.statusText}`);
+            }
+            const data = await response.json();
+            return {
+                status: data.status,
+                changeCount: data.changeCount,
+                appliedCount: this.currentTransaction.appliedCount,
+                conflictCount: this.currentTransaction.conflictCount,
+            };
+        }
+        catch (error) {
+            throw new Error(`Failed to get status: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Get current transaction
+     */
+    getCurrentTransaction() {
+        return this.currentTransaction;
+    }
+    /**
+     * Subscribe to transaction changes
+     */
+    subscribe(listener) {
+        this.transactionListeners.add(listener);
+        return () => this.transactionListeners.delete(listener);
+    }
+    /**
+     * Notify listeners of transaction changes
+     */
+    notifyListeners() {
+        if (this.currentTransaction) {
+            for (const listener of this.transactionListeners) {
+                try {
+                    listener(this.currentTransaction);
+                }
+                catch (error) {
+                    console.error('Listener error:', error);
+                }
+            }
+        }
+    }
+    /**
+     * Reset transaction state (useful for cleanup)
+     */
+    reset() {
+        this.currentTransaction = null;
+        this.transactionListeners.clear();
+    }
+}
+//# sourceMappingURL=transaction-hook.js.map

package/dist/client-core/src/mutations/transaction-hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-hook.js","sourceRoot":"","sources":["../../../../src/mutations/transaction-hook.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAyBH;;GAEG;AACH,MAAM,OAAO,wBAAwB;IAMnC,YAAY,MAAc,EAAE,WAAmB;QAHvC,uBAAkB,GAA8B,IAAI,CAAC;QACrD,yBAAoB,GAAG,IAAI,GAAG,EAAqC,CAAC;QAG1E,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CAAC,UAA8B,EAAE;QAC1C,IAAI,IAAI,CAAC,kBAAkB,IAAI,IAAI,CAAC,kBAAkB,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC5E,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACrD,CAAC;QAED,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,qBAAqB,EAAE;gBAChE,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;oBAClC,aAAa,EAAE,UAAU,IAAI,CAAC,WAAW,EAAE;iBAC5C;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,gBAAgB;iBAC3D,CAAC;aACH,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,gCAAgC,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;YACzE,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;YAEzC,6BAA6B;YAC7B,IAAI,CAAC,kBAAkB,GAAG;gBACxB,EAAE,EAAE,aAAa;gBACjB,OAAO,EAAE,EAAE;gBACX,MAAM,EAAE,SAAS;aAClB,CAAC;YAEF,IAAI,CAAC,eAAe,EAAE,CAAC;YACvB,OAAO,aAAa,CAAC;QACvB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,6BAA6B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC;QAC3G,CAAC;IACH,CAAC;IAED;;OAEG;IACH,SAAS,CACP,MAAc,EACd,QAAgB,EAChB,SAAyC,EACzC,IAAyB;QAEzB,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAChD,CAAC;QAED,IAAI,IAAI,CAAC,kBAAkB,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACjD,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,CAAC,kBAAkB,CAAC,MAAM,cAAc,CAAC,CAAC;QACzF,CAAC;QAED,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,IAAI,CAAC;YACnC,MAAM;YACN,QAAQ;YACR,SAAS;YACT,IAAI;SACL,CAAC,CAAC;QAEH,IAAI,CAAC,eAAe,EAAE,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM;QAKV,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAChD,CAAC;QAED,MAAM,aAAa,GAAG,IAAI,CAAC,kBAAkB,CAAC,EAAE,CAAC;QAEjD,IAAI,CAAC;YACH,IAAI,CAAC,kBAAkB,CAAC,MAAM,GAAG,YAAY,CAAC;YAC9C,IAAI,CAAC,eAAe,EAAE,CAAC;YAEvB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,iBAAiB,aAAa,SAAS,EAAE;gBAClF,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;oBAClC,aAAa,EAAE,UAAU,IAAI,CAAC,WAAW,EAAE;iBAC5C;aACF,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,IAAI,CAAC,kBAAkB,CAAC,MAAM,GAAG,QAAQ,CAAC;gBAC1C,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACpC,IAAI,CAAC,kBAAkB,CAAC,KAAK,GAAG,KAAK,CAAC;gBACtC,IAAI,CAAC,eAAe,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CAAC,iCAAiC,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;YAC1E,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YAEnC,IAAI,CAAC,kBAAkB,CAAC,MAAM,GAAG,WAAW,CAAC;YAC7C,IAAI,CAAC,kBAAkB,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;YACzD,IAAI,CAAC,kBAAkB,CAAC,aAAa,GAAG,IAAI,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,CAAC;YACjE,IAAI,CAAC,eAAe,EAAE,CAAC;YAEvB,MAAM,MAAM,GAAG;gBACb,OAAO,EAAE,IAAI;gBACb,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE;aAC1B,CAAC;YAEF,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,kBAAkB,CAAC,MAAM,GAAG,QAAQ,CAAC;YAC1C,IAAI,CAAC,kBAAkB,CAAC,KAAK,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;YACzF,IAAI,CAAC,eAAe,EAAE,CAAC;YACvB,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAChD,CAAC;QAED,MAAM,aAAa,GAAG,IAAI,CAAC,kBAAkB,CAAC,EAAE,CAAC;QAEjD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,iBAAiB,aAAa,WAAW,EAAE;gBACpF,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;oBAClC,aAAa,EAAE,UAAU,IAAI,CAAC,WAAW,EAAE;iBAC5C;aACF,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,mCAAmC,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;YAC5E,CAAC;YAED,IAAI,CAAC,kBAAkB,CAAC,MAAM,GAAG,aAAa,CAAC;YAC/C,IAAI,CAAC,eAAe,EAAE,CAAC;YACvB,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC;QACjC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,gCAAgC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC;QAC9G,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS;QAMb,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAChD,CAAC;QAED,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,iBAAiB,IAAI,CAAC,kBAAkB,CAAC,EAAE,EAAE,EAAE;gBACxF,OAAO,EAAE;oBACP,aAAa,EAAE,UAAU,IAAI,CAAC,WAAW,EAAE;iBAC5C;aACF,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,qCAAqC,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;YAC9E,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,OAAO;gBACL,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,YAAY,EAAE,IAAI,CAAC,kBAAkB,CAAC,YAAY;gBAClD,aAAa,EAAE,IAAI,CAAC,kBAAkB,CAAC,aAAa;aACrD,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,yBAAyB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC;QACvG,CAAC;IACH,CAAC;IAED;;OAEG;IACH,qBAAqB;QACnB,OAAO,IAAI,CAAC,kBAAkB,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,QAA2C;QACnD,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACxC,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC1D,CAAC;IAED;;OAEG;IACK,eAAe;QACrB,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC5B,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;gBACjD,IAAI,CAAC;oBACH,QAAQ,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;gBACpC,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,CAAC,KAAK,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;gBAC1C,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC;QAC/B,IAAI,CAAC,oBAAoB,CAAC,KAAK,EAAE,CAAC;IACpC,CAAC;CACF"}

package/dist/client-core/src/realtime/realtime-sync-manager.d.ts

@@ -0,0 +1,55 @@
+import type { IStorageAdapter } from '../storage';
+import type { ChangeMessage } from '@edgebasejs/core';
+/**
+ * Manages real-time sync between WebSocket changes and local storage
+ * Handles merging of server changes with local data
+ */
+export declare class RealtimeSyncManager {
+    private storage;
+    private changeListeners;
+    constructor(storage: IStorageAdapter);
+    /**
+     * Subscribe to changes for a specific entity
+     */
+    onEntityChange(entity: string, listener: (change: ChangeMessage) => void): () => void;
+    /**
+     * Handle incoming WebSocket change message
+     * Merges with local storage using server-authoritative conflict resolution
+     */
+    handleChange(change: ChangeMessage): Promise<void>;
+    /**
+     * Notify listeners about a change
+     */
+    private notifyListeners;
+    /**
+     * Get all data for an entity from local storage
+     */
+    getEntityData<T = any>(entity: string): Promise<T[]>;
+    /**
+     * Get a single record by ID
+     */
+    getRecord<T = any>(entity: string, recordId: string): Promise<T | null>;
+    /**
+     * Merge outbox changes with server updates
+     * Used during sync to detect conflicts
+     */
+    mergeWithOutbox(entity: string, recordId: string, serverRecord: Record<string, any>, serverVersion: number): Promise<{
+        resolved: boolean;
+        data: Record<string, any>;
+        conflict?: boolean;
+    }>;
+    /**
+     * Clear all data for an entity
+     */
+    clearEntity(entity: string): Promise<void>;
+    /**
+     * Get sync metadata for entity
+     * Used to track which records have been synced
+     */
+    getSyncStatus(entity: string): Promise<Record<string, any>>;
+    /**
+     * Listen for all changes across entities
+     */
+    onAnyChange(listener: (entity: string, change: ChangeMessage) => void): () => void;
+}
+//# sourceMappingURL=realtime-sync-manager.d.ts.map

package/dist/client-core/src/realtime/realtime-sync-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-sync-manager.d.ts","sourceRoot":"","sources":["../../../../src/realtime/realtime-sync-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD;;;GAGG;AACH,qBAAa,mBAAmB;IAGlB,OAAO,CAAC,OAAO;IAF3B,OAAO,CAAC,eAAe,CAA2D;gBAE9D,OAAO,EAAE,eAAe;IAE5C;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,IAAI;IAarF;;;OAGG;IACG,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAwCxD;;OAEG;IACH,OAAO,CAAC,eAAe;IAavB;;OAEG;IACG,aAAa,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAoB1D;;OAEG;IACG,SAAS,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAc7E;;;OAGG;IACG,eAAe,CACnB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACjC,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAsChF;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAahD;;;OAGG;IACG,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAsBjE;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,IAAI;CASnF"}