@edgebasejs/client-core 0.1.7 → 0.1.9

package/dist/client-core/src/realtime/realtime-sync-manager.js

@@ -0,0 +1,208 @@
+/**
+ * Manages real-time sync between WebSocket changes and local storage
+ * Handles merging of server changes with local data
+ */
+export class RealtimeSyncManager {
+    constructor(storage) {
+        this.storage = storage;
+        this.changeListeners = new Map();
+    }
+    /**
+     * Subscribe to changes for a specific entity
+     */
+    onEntityChange(entity, listener) {
+        if (!this.changeListeners.has(entity)) {
+            this.changeListeners.set(entity, new Set());
+        }
+        this.changeListeners.get(entity).add(listener);
+        // Return unsubscribe function
+        return () => {
+            this.changeListeners.get(entity)?.delete(listener);
+        };
+    }
+    /**
+     * Handle incoming WebSocket change message
+     * Merges with local storage using server-authoritative conflict resolution
+     */
+    async handleChange(change) {
+        try {
+            const { entity, operation, record, recordId, version, timestamp } = change;
+            switch (operation) {
+                case 'create':
+                case 'update':
+                    if (!record || !recordId)
+                        break;
+                    // Store in local storage with new version
+                    const key = `entity:${entity}:${recordId}`;
+                    const storedData = {
+                        ...record,
+                        _version: version || 0,
+                        _syncedAt: timestamp || Date.now(),
+                        _synced: true, // Mark as synced from server
+                    };
+                    await this.storage.setItem(key, JSON.stringify(storedData));
+                    // Notify listeners
+                    this.notifyListeners(entity, change);
+                    break;
+                case 'delete':
+                    if (!recordId)
+                        break;
+                    // Remove from local storage
+                    const deleteKey = `entity:${entity}:${recordId}`;
+                    await this.storage.removeItem(deleteKey);
+                    // Notify listeners
+                    this.notifyListeners(entity, change);
+                    break;
+            }
+        }
+        catch (error) {
+            console.error('Failed to handle real-time change:', error);
+        }
+    }
+    /**
+     * Notify listeners about a change
+     */
+    notifyListeners(entity, change) {
+        const listeners = this.changeListeners.get(entity);
+        if (listeners) {
+            for (const listener of listeners) {
+                try {
+                    listener(change);
+                }
+                catch (error) {
+                    console.error('Listener error:', error);
+                }
+            }
+        }
+    }
+    /**
+     * Get all data for an entity from local storage
+     */
+    async getEntityData(entity) {
+        try {
+            const allKeys = await this.storage.getAllKeys();
+            const entityKeys = allKeys.filter((key) => key.startsWith(`entity:${entity}:`));
+            const results = [];
+            for (const key of entityKeys) {
+                const data = await this.storage.getItem(key);
+                if (data) {
+                    results.push(JSON.parse(data));
+                }
+            }
+            return results;
+        }
+        catch (error) {
+            console.error('Failed to get entity data:', error);
+            return [];
+        }
+    }
+    /**
+     * Get a single record by ID
+     */
+    async getRecord(entity, recordId) {
+        try {
+            const key = `entity:${entity}:${recordId}`;
+            const data = await this.storage.getItem(key);
+            if (data) {
+                return JSON.parse(data);
+            }
+            return null;
+        }
+        catch (error) {
+            console.error('Failed to get record:', error);
+            return null;
+        }
+    }
+    /**
+     * Merge outbox changes with server updates
+     * Used during sync to detect conflicts
+     */
+    async mergeWithOutbox(entity, recordId, serverRecord, serverVersion) {
+        try {
+            const key = `entity:${entity}:${recordId}`;
+            const stored = await this.storage.getItem(key);
+            let localData = stored ? JSON.parse(stored) : null;
+            if (!localData) {
+                // No local data, use server data
+                return {
+                    resolved: true,
+                    data: serverRecord,
+                };
+            }
+            // Check if there are local changes (indicated by _outbox flag)
+            if (localData._outbox) {
+                // Conflict: local changes conflict with server update
+                return {
+                    resolved: false,
+                    data: serverRecord, // Server wins (authoritative)
+                    conflict: true,
+                };
+            }
+            // No local changes, use server data
+            return {
+                resolved: true,
+                data: serverRecord,
+            };
+        }
+        catch (error) {
+            console.error('Failed to merge with outbox:', error);
+            return {
+                resolved: true,
+                data: serverRecord,
+            };
+        }
+    }
+    /**
+     * Clear all data for an entity
+     */
+    async clearEntity(entity) {
+        try {
+            const allKeys = await this.storage.getAllKeys();
+            const entityKeys = allKeys.filter((key) => key.startsWith(`entity:${entity}:`));
+            for (const key of entityKeys) {
+                await this.storage.removeItem(key);
+            }
+        }
+        catch (error) {
+            console.error('Failed to clear entity:', error);
+        }
+    }
+    /**
+     * Get sync metadata for entity
+     * Used to track which records have been synced
+     */
+    async getSyncStatus(entity) {
+        try {
+            const data = await this.getEntityData(entity);
+            return {
+                entity,
+                totalRecords: data.length,
+                syncedRecords: data.filter((d) => d._synced).length,
+                pendingRecords: data.filter((d) => d._outbox).length,
+                lastUpdate: Math.max(...data.map((d) => d._syncedAt || 0), 0),
+            };
+        }
+        catch (error) {
+            console.error('Failed to get sync status:', error);
+            return {
+                entity,
+                totalRecords: 0,
+                syncedRecords: 0,
+                pendingRecords: 0,
+                lastUpdate: 0,
+            };
+        }
+    }
+    /**
+     * Listen for all changes across entities
+     */
+    onAnyChange(listener) {
+        const allListener = (change) => {
+            listener(change.entity, change);
+        };
+        // This is a catch-all listener that would need to be managed separately
+        // For now, return a no-op unsubscribe since we don't have a global listener yet
+        return () => { };
+    }
+}
+//# sourceMappingURL=realtime-sync-manager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-sync-manager.js","sourceRoot":"","sources":["../../../../src/realtime/realtime-sync-manager.ts"],"names":[],"mappings":"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"}

package/dist/client-core/src/realtime/subscription-handler.d.ts

@@ -0,0 +1,74 @@
+import type { ChangeMessage } from '@edgebasejs/core';
+export interface SubscriptionOptions {
+    entity: string;
+    filters?: Record<string, unknown>;
+    onData?: (change: ChangeMessage) => void;
+    onError?: (error: Error) => void;
+    onSubscribed?: (subscriptionId: string) => void;
+    onUnsubscribed?: () => void;
+}
+export interface ConnectionConfig {
+    url: string;
+    token: string;
+    reconnectAttempts?: number;
+    reconnectDelay?: number;
+    heartbeatInterval?: number;
+}
+/**
+ * Manages WebSocket connection and subscriptions on the client side
+ */
+export declare class ClientSubscriptionHandler {
+    private config;
+    private ws;
+    private subscriptions;
+    private reconnectAttempts;
+    private reconnectTimeout;
+    private heartbeatTimeout;
+    private messageHandlers;
+    constructor(config: ConnectionConfig);
+    /**
+     * Connect to WebSocket server
+     */
+    connect(): Promise<void>;
+    /**
+     * Subscribe to entity changes
+     */
+    subscribe(options: SubscriptionOptions): string;
+    /**
+     * Unsubscribe from entity changes
+     */
+    unsubscribe(subscriptionId: string): void;
+    /**
+     * Handle incoming WebSocket messages
+     */
+    private handleMessage;
+    /**
+     * Send heartbeat to server
+     */
+    private sendHeartbeat;
+    /**
+     * Setup periodic heartbeat
+     */
+    private setupHeartbeat;
+    /**
+     * Clear heartbeat
+     */
+    private clearHeartbeat;
+    /**
+     * Attempt to reconnect with exponential backoff
+     */
+    private attemptReconnect;
+    /**
+     * Disconnect from WebSocket
+     */
+    disconnect(): void;
+    /**
+     * Check if connected
+     */
+    isConnected(): boolean;
+    /**
+     * Get subscription count
+     */
+    getSubscriptionCount(): number;
+}
+//# sourceMappingURL=subscription-handler.d.ts.map

package/dist/client-core/src/realtime/subscription-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription-handler.d.ts","sourceRoot":"","sources":["../../../../src/realtime/subscription-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAuB,MAAM,kBAAkB,CAAC;AAE3E,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,CAAC;IACzC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,YAAY,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,qBAAa,yBAAyB;IAQxB,OAAO,CAAC,MAAM;IAP1B,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,aAAa,CAA0C;IAC/D,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,gBAAgB,CAA8C;IACtE,OAAO,CAAC,gBAAgB,CAA+C;IACvE,OAAO,CAAC,eAAe,CAA6C;gBAEhD,MAAM,EAAE,gBAAgB;IAE5C;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAiC9B;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM;IAsC/C;;OAEG;IACH,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI;IAkBzC;;OAEG;IACH,OAAO,CAAC,aAAa;IAsDrB;;OAEG;IACH,OAAO,CAAC,aAAa;IAUrB;;OAEG;IACH,OAAO,CAAC,cAAc;IAOtB;;OAEG;IACH,OAAO,CAAC,cAAc;IAOtB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAkBxB;;OAEG;IACH,UAAU,IAAI,IAAI;IAiBlB;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,oBAAoB,IAAI,MAAM;CAG/B"}

package/dist/client-core/src/realtime/subscription-handler.js

@@ -0,0 +1,224 @@
+/**
+ * Manages WebSocket connection and subscriptions on the client side
+ */
+export class ClientSubscriptionHandler {
+    constructor(config) {
+        this.config = config;
+        this.ws = null;
+        this.subscriptions = new Map();
+        this.reconnectAttempts = 0;
+        this.reconnectTimeout = null;
+        this.heartbeatTimeout = null;
+        this.messageHandlers = new Map();
+    }
+    /**
+     * Connect to WebSocket server
+     */
+    async connect() {
+        return new Promise((resolve, reject) => {
+            try {
+                const wsUrl = this.config.url.replace(/^http/, 'ws');
+                this.ws = new WebSocket(wsUrl);
+                this.ws.onopen = () => {
+                    console.log('WebSocket connected');
+                    this.reconnectAttempts = 0;
+                    this.setupHeartbeat();
+                    resolve();
+                };
+                this.ws.onmessage = (event) => {
+                    this.handleMessage(event.data);
+                };
+                this.ws.onerror = (error) => {
+                    console.error('WebSocket error:', error);
+                    reject(new Error('WebSocket connection failed'));
+                };
+                this.ws.onclose = () => {
+                    console.log('WebSocket disconnected');
+                    this.clearHeartbeat();
+                    this.attemptReconnect();
+                };
+            }
+            catch (error) {
+                reject(error);
+            }
+        });
+    }
+    /**
+     * Subscribe to entity changes
+     */
+    subscribe(options) {
+        const subscriptionId = `csub_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+        // Store subscription locally
+        this.subscriptions.set(subscriptionId, options);
+        // Register message handler for this subscription
+        this.messageHandlers.set(subscriptionId, (message) => {
+            if (message.entity === options.entity) {
+                // Check if filters match
+                if (options.filters && message.record) {
+                    let matches = true;
+                    for (const [key, value] of Object.entries(options.filters)) {
+                        if (message.record[key] !== value) {
+                            matches = false;
+                            break;
+                        }
+                    }
+                    if (!matches)
+                        return;
+                }
+                options.onData?.(message);
+            }
+        });
+        // Send subscription message to server
+        if (this.ws?.readyState === WebSocket.OPEN) {
+            const message = {
+                type: 'subscribe',
+                entity: options.entity,
+                filters: options.filters,
+            };
+            this.ws.send(JSON.stringify(message));
+        }
+        return subscriptionId;
+    }
+    /**
+     * Unsubscribe from entity changes
+     */
+    unsubscribe(subscriptionId) {
+        const options = this.subscriptions.get(subscriptionId);
+        if (!options)
+            return;
+        // Remove subscription
+        this.subscriptions.delete(subscriptionId);
+        this.messageHandlers.delete(subscriptionId);
+        // Send unsubscribe message to server
+        if (this.ws?.readyState === WebSocket.OPEN) {
+            const message = {
+                type: 'unsubscribe',
+                entity: options.entity,
+            };
+            this.ws.send(JSON.stringify(message));
+        }
+    }
+    /**
+     * Handle incoming WebSocket messages
+     */
+    handleMessage(data) {
+        try {
+            const message = JSON.parse(data);
+            switch (message.type) {
+                case 'change':
+                    // Broadcast to all registered handlers
+                    for (const handler of this.messageHandlers.values()) {
+                        handler(message);
+                    }
+                    break;
+                case 'subscribed':
+                    // Find the subscription that was just created
+                    const subOptions = Array.from(this.subscriptions.values()).find((sub) => sub.entity === message.entity);
+                    if (subOptions) {
+                        subOptions.onSubscribed?.(message.subscriptionId);
+                    }
+                    break;
+                case 'unsubscribed':
+                    const unsubOptions = Array.from(this.subscriptions.values()).find((sub) => sub.entity === message.entity);
+                    if (unsubOptions) {
+                        unsubOptions.onUnsubscribed?.();
+                    }
+                    break;
+                case 'error':
+                    console.error(`Server error: ${message.code} - ${message.message}`);
+                    for (const sub of this.subscriptions.values()) {
+                        sub.onError?.(new Error(message.message));
+                    }
+                    break;
+                case 'connected':
+                    console.log(`Connected to server with connectionId: ${message.connectionId}`);
+                    break;
+                case 'heartbeat':
+                    // Server heartbeat - no action needed
+                    break;
+                default:
+                    console.warn(`Unknown message type: ${message.type}`);
+            }
+        }
+        catch (error) {
+            console.error('Failed to parse WebSocket message:', error);
+        }
+    }
+    /**
+     * Send heartbeat to server
+     */
+    sendHeartbeat() {
+        if (this.ws?.readyState === WebSocket.OPEN) {
+            const message = {
+                type: 'heartbeat',
+                timestamp: Date.now(),
+            };
+            this.ws.send(JSON.stringify(message));
+        }
+    }
+    /**
+     * Setup periodic heartbeat
+     */
+    setupHeartbeat() {
+        const interval = this.config.heartbeatInterval || 30000;
+        this.heartbeatTimeout = setInterval(() => {
+            this.sendHeartbeat();
+        }, interval);
+    }
+    /**
+     * Clear heartbeat
+     */
+    clearHeartbeat() {
+        if (this.heartbeatTimeout) {
+            clearInterval(this.heartbeatTimeout);
+            this.heartbeatTimeout = null;
+        }
+    }
+    /**
+     * Attempt to reconnect with exponential backoff
+     */
+    attemptReconnect() {
+        const maxAttempts = this.config.reconnectAttempts || 5;
+        if (this.reconnectAttempts >= maxAttempts) {
+            console.error('Max reconnection attempts reached');
+            return;
+        }
+        this.reconnectAttempts++;
+        const delay = (this.config.reconnectDelay || 1000) * Math.pow(2, this.reconnectAttempts - 1);
+        console.log(`Attempting to reconnect in ${delay}ms...`);
+        this.reconnectTimeout = setTimeout(() => {
+            this.connect().catch((error) => {
+                console.error('Reconnection failed:', error);
+            });
+        }, delay);
+    }
+    /**
+     * Disconnect from WebSocket
+     */
+    disconnect() {
+        if (this.reconnectTimeout) {
+            clearTimeout(this.reconnectTimeout);
+            this.reconnectTimeout = null;
+        }
+        this.clearHeartbeat();
+        if (this.ws) {
+            this.ws.close();
+            this.ws = null;
+        }
+        this.subscriptions.clear();
+        this.messageHandlers.clear();
+    }
+    /**
+     * Check if connected
+     */
+    isConnected() {
+        return this.ws?.readyState === WebSocket.OPEN;
+    }
+    /**
+     * Get subscription count
+     */
+    getSubscriptionCount() {
+        return this.subscriptions.size;
+    }
+}
+//# sourceMappingURL=subscription-handler.js.map

package/dist/client-core/src/realtime/subscription-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription-handler.js","sourceRoot":"","sources":["../../../../src/realtime/subscription-handler.ts"],"names":[],"mappings":"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"}

package/dist/client-core/src/sync/sync-engine.d.ts

@@ -5,6 +5,7 @@ export interface ClientSyncOptions {
     accessToken: string;
     storage: IStorageAdapter;
     outboxManager: OutboxManager;
+    autoSync?: boolean;
     onConflict?: (entity: string, recordId: string, serverData: Record<string, any>) => void;
     onError?: (error: Error) => void;
 }
@@ -24,6 +25,7 @@ export declare class ClientSyncEngine {
     private outboxManager;
     private onConflict?;
     private onError?;
+    private autoSync;
     private isSyncing;
     private lastSyncTimestamp;
     private syncStatusKey;
@@ -36,6 +38,10 @@ export declare class ClientSyncEngine {
      * Update access token (for when user logs in)
      */
     setAccessToken(token: string): void;
+    /**
+     * Enable or disable automatic synchronization
+     */
+    setAutoSync(enabled: boolean): void;
     /**
      * Get current sync status
      */
@@ -44,6 +50,10 @@ export declare class ClientSyncEngine {
      * Sync with server
      */
     sync(): Promise<void>;
+    /**
+     * Force a full sync (ignore lastSyncTimestamp)
+     */
+    syncFull(): Promise<void>;
     /**
      * Send sync request to server
      */

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

@@ -1 +1 @@
-{"version":3,"file":"sync-engine.d.ts","sourceRoot":"","sources":["../../../../src/sync/sync-engine.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAoB,MAAM,0BAA0B,CAAC;AAC3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAElE,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,eAAe,CAAC;IACzB,aAAa,EAAE,aAAa,CAAC;IAC7B,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,CAAC;IACzF,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,KAAK,CAAC;CACnB;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,UAAU,CAAC,CAA8E;IACjG,OAAO,CAAC,OAAO,CAAC,CAAyB;IACzC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,iBAAiB,CAAuB;IAChD,OAAO,CAAC,aAAa,CAAwB;gBAEjC,OAAO,EAAE,iBAAiB;IAStC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAInC;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,UAAU,CAAC;IAStC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA0C3B;;OAEG;YACW,SAAS;IAiBvB;;OAEG;YACW,eAAe;IAgF7B;;OAEG;IACG,SAAS,CACb,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,EACzC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzB,OAAO,GAAE,MAAU,GAClB,OAAO,CAAC,IAAI,CAAC;IAkBhB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAK7B;AAED,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"sync-engine.d.ts","sourceRoot":"","sources":["../../../../src/sync/sync-engine.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAoB,MAAM,0BAA0B,CAAC;AAC3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAElE,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,eAAe,CAAC;IACzB,aAAa,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,CAAC;IACzF,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,KAAK,CAAC;CACnB;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,UAAU,CAAC,CAA8E;IACjG,OAAO,CAAC,OAAO,CAAC,CAAyB;IACzC,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,iBAAiB,CAAuB;IAChD,OAAO,CAAC,aAAa,CAAwB;gBAEjC,OAAO,EAAE,iBAAiB;IAUtC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAInC;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAInC;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,UAAU,CAAC;IAStC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA0C3B;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAM/B;;OAEG;YACW,SAAS;IAiBvB;;OAEG;YACW,eAAe;IAiG7B;;OAEG;IACG,SAAS,CACb,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,EACzC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzB,OAAO,GAAE,MAAU,GAClB,OAAO,CAAC,IAAI,CAAC;IAoBhB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAK7B;AAED,eAAe,gBAAgB,CAAC"}

package/dist/client-core/src/sync/sync-engine.js

@@ -14,6 +14,7 @@ export class ClientSyncEngine {
         this.outboxManager = options.outboxManager;
         this.onConflict = options.onConflict;
         this.onError = options.onError;
+        this.autoSync = options.autoSync ?? true;
     }
     /**
      * Initialize sync engine
@@ -29,6 +30,12 @@ export class ClientSyncEngine {
     setAccessToken(token) {
         this.accessToken = token;
     }
+    /**
+     * Enable or disable automatic synchronization
+     */
+    setAutoSync(enabled) {
+        this.autoSync = enabled;
+    }
     /**
      * Get current sync status
      */
@@ -80,6 +87,14 @@ export class ClientSyncEngine {
             this.isSyncing = false;
         }
     }
+    /**
+     * Force a full sync (ignore lastSyncTimestamp)
+     */
+    async syncFull() {
+        this.lastSyncTimestamp = null;
+        await this.storage.removeItem(this.syncStatusKey);
+        await this.sync();
+    }
     /**
      * Send sync request to server
      */
@@ -111,7 +126,19 @@ export class ClientSyncEngine {
             }
             // Update local storage with server version
             const storageKey = `entity:${change.entity}:${change.id}`;
-            await this.storage.setItem(storageKey, JSON.stringify(change.data));
+            if (change.operation === 'delete') {
+                await this.storage.removeItem(storageKey);
+            }
+            else {
+                const existingRaw = await this.storage.getItem(storageKey);
+                const existing = existingRaw ? JSON.parse(existingRaw) : {};
+                const payload = {
+                    ...existing,
+                    ...(change.data || {}),
+                    _version: change.version ?? (change.operation === 'create' ? 1 : 0),
+                };
+                await this.storage.setItem(storageKey, JSON.stringify(payload));
+            }
         }
         // Process conflicts
         for (const conflict of response.conflicts) {
@@ -126,7 +153,10 @@ export class ClientSyncEngine {
             });
             // Update local storage with resolved data
             const storageKey = `entity:${conflict.entity}:${conflict.id}`;
-            await this.storage.setItem(storageKey, JSON.stringify(resolution.resolvedData));
+            await this.storage.setItem(storageKey, JSON.stringify({
+                ...resolution.resolvedData,
+                _version: conflict.serverVersion,
+            }));
             // Notify caller of conflict
             this.onConflict?.(conflict.entity, conflict.id, conflict.serverData);
             // Remove from outbox since server won
@@ -173,9 +203,11 @@ export class ClientSyncEngine {
         });
         // Try to sync (will be handled by background sync if fails)
         // Don't await to allow optimistic updates
-        this.sync().catch(() => {
-            // Sync failed - will retry in background
-        });
+        if (this.autoSync) {
+            this.sync().catch(() => {
+                // Sync failed - will retry in background
+            });
+        }
     }
     /**
      * Clear sync state (for logout/reset)