@fatagnus/dink-sync 1.0.0

package/dist/client/index.js

@@ -0,0 +1,233 @@
+import { ConnectionState } from './types.js';
+import { createSignal } from './signal.js';
+import { createCollection } from './collection.js';
+// Re-export types
+export { ConnectionState, SyncStatus, SyncErrorCode, SyncPriority, } from './types.js';
+// Validation exports
+export { CollectionValidationError, createZodValidator, } from './validation.js';
+/**
+ * Internal implementation of OfflineEdgeClient.
+ */
+class OfflineEdgeClientImpl {
+    persistence;
+    config;
+    collections = new Map();
+    _connectionState;
+    // Selective sync state
+    // null = sync all collections (default), Set = only sync specified collections
+    syncedCollections;
+    syncChangeCallbacks = new Set();
+    constructor(persistence, config) {
+        this.persistence = persistence;
+        this.config = config;
+        this._connectionState = createSignal(ConnectionState.Offline);
+        // Initialize selective sync based on config
+        if (config.syncCollections === undefined) {
+            // undefined = sync all collections (default behavior)
+            this.syncedCollections = null;
+        }
+        else {
+            // Array (empty or not) = only sync specified collections
+            this.syncedCollections = new Set(config.syncCollections);
+        }
+    }
+    collection(name) {
+        let col = this.collections.get(name);
+        if (!col) {
+            col = createCollection(name, this.persistence);
+            this.collections.set(name, col);
+        }
+        return col;
+    }
+    get connectionState() {
+        return this._connectionState;
+    }
+    /**
+     * Internal method to update connection state.
+     * @internal
+     */
+    setConnectionState(state) {
+        this._connectionState.set(state);
+    }
+    isSyncing(name) {
+        // If syncedCollections is null, all collections are synced
+        if (this.syncedCollections === null) {
+            return true;
+        }
+        return this.syncedCollections.has(name);
+    }
+    syncCollection(name) {
+        // If syncing all collections, nothing to do
+        if (this.syncedCollections === null) {
+            return;
+        }
+        // Check if already syncing
+        if (this.syncedCollections.has(name)) {
+            return;
+        }
+        // Add to sync list
+        this.syncedCollections.add(name);
+        // Notify callbacks
+        this.notifySyncChange(name, true);
+    }
+    async unsyncCollection(name) {
+        // If syncing all collections, we need to switch to explicit mode
+        if (this.syncedCollections === null) {
+            // Get all currently used collection names and create a Set excluding this one
+            const currentCollections = new Set(this.collections.keys());
+            currentCollections.delete(name);
+            this.syncedCollections = currentCollections;
+        }
+        else if (!this.syncedCollections.has(name)) {
+            // Not syncing this collection anyway
+            return;
+        }
+        else {
+            // Remove from sync list
+            this.syncedCollections.delete(name);
+        }
+        // Clean up local data for this collection
+        await this.clearCollectionData(name);
+        // Notify callbacks
+        this.notifySyncChange(name, false);
+    }
+    getSyncedCollections() {
+        if (this.syncedCollections === null) {
+            // When syncing all, return all known collection names
+            return Array.from(this.collections.keys());
+        }
+        return Array.from(this.syncedCollections);
+    }
+    onSyncCollectionsChange(callback) {
+        this.syncChangeCallbacks.add(callback);
+        return () => {
+            this.syncChangeCallbacks.delete(callback);
+        };
+    }
+    /**
+     * Clear all data for a collection from memory and persistence.
+     * @internal
+     */
+    async clearCollectionData(name) {
+        // Get existing collection if any
+        const collection = this.collections.get(name);
+        if (collection) {
+            // Use the collection's _clear method to clear in-memory and persisted data
+            await collection._clear();
+        }
+        else {
+            // No collection instance, clear directly from persistence
+            const docIds = await this.persistence.list(name);
+            for (const docId of docIds) {
+                await this.persistence.delete(name, docId);
+            }
+            // Also clear tombstones for this collection
+            const tombstoneCollection = `_tombstones_${name}`;
+            const tombstoneIds = await this.persistence.list(tombstoneCollection);
+            for (const tombstoneId of tombstoneIds) {
+                await this.persistence.delete(tombstoneCollection, tombstoneId);
+            }
+        }
+        // Remove the collection from the cache so it gets recreated fresh
+        this.collections.delete(name);
+    }
+    /**
+     * Notify all sync change callbacks.
+     * @internal
+     */
+    notifySyncChange(collection, syncing) {
+        for (const callback of this.syncChangeCallbacks) {
+            callback(collection, syncing);
+        }
+    }
+}
+/**
+ * Factory for creating offline-first edge clients.
+ *
+ * @example
+ * ```typescript
+ * import { offlineEdge, ConnectionState } from '@fatagnus/dink-sync';
+ * import { MemoryPersistence } from '@fatagnus/dink-sync/persistence';
+ *
+ * // Create the edge instance
+ * const edge = offlineEdge.create({
+ *   persistence: new MemoryPersistence(),
+ *   config: {
+ *     serverUrl: 'nats://localhost:4222',
+ *     apiKey: 'your-api-key',
+ *   },
+ * });
+ *
+ * // Initialize (loads persisted data)
+ * await edge.init();
+ *
+ * // Get the client
+ * const client = edge.get();
+ *
+ * // Use typed collections
+ * interface Task {
+ *   id: string;
+ *   title: string;
+ *   completed: boolean;
+ * }
+ *
+ * const tasks = client.collection<Task>('tasks');
+ * const task = await tasks.insert({ title: 'Buy milk', completed: false });
+ *
+ * // Subscribe to changes
+ * tasks.subscribe((docs) => {
+ *   console.log('Tasks updated:', docs);
+ * });
+ *
+ * // Check connection state
+ * client.connectionState.subscribe((state) => {
+ *   console.log('Connection state:', state);
+ * });
+ * ```
+ */
+export const offlineEdge = {
+    /**
+     * Create a new offline edge instance.
+     *
+     * @param options - Creation options including persistence and config
+     * @returns A lazy-initialized edge instance
+     */
+    create(options) {
+        const { persistence, config } = options;
+        let client = null;
+        let initialized = false;
+        return {
+            async init() {
+                if (initialized) {
+                    return;
+                }
+                // Create the client instance
+                client = new OfflineEdgeClientImpl(persistence, config);
+                initialized = true;
+            },
+            get() {
+                if (!initialized || !client) {
+                    throw new Error('Call init() before get()');
+                }
+                return client;
+            },
+        };
+    },
+};
+// Sync engine exports
+export { createSyncEngine, ConnectionState as SyncConnectionState, DEFAULT_DEBOUNCE_MS, DEFAULT_MAX_RETRIES, DEFAULT_BATCH_SIZE, SyncRejectionCode, } from './sync-engine.js';
+// Transport exports
+export { createNatsTransport, NatsTransport, } from './transport.js';
+// Mock transport for testing
+export { createMockTransport, MockTransport, } from './mock-transport.js';
+// Network detector exports
+export { createNetworkDetector, createBrowserNetworkDetector, createNodeNetworkDetector, NetworkState, } from './network-detector.js';
+// CRDT exports
+export { YjsDocument } from './crdt/index.js';
+// Attachment exports
+export { AttachmentManager, AttachmentStorage, DownloadPolicy, } from './attachment.js';
+// Provisioning exports (for demos and development)
+export { createAdminClient, readAdminKeyWithRetry, } from './provisioning.js';
+// SyncedOfflineEdge factory
+export { createSyncedOfflineEdge, } from './synced-offline-edge.js';
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

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

package/dist/client/mock-transport.d.ts

@@ -0,0 +1,155 @@
+/**
+ * MockTransport - A mock transport for testing sync engine without real NATS
+ *
+ * Provides:
+ * - Configurable connection behavior
+ * - Manual control over sync responses
+ * - Ability to simulate rejections and errors
+ */
+import type { Transport, TransportState, StateChangeCallback, UpdateCallback, ErrorCallback, SyncChange, SyncResponse, SyncUpdate, StateVectorExchange, ForcePushResponse } from './transport.js';
+export interface MockTransportConfig {
+    /** App ID to use */
+    appId?: string;
+    /** Edge ID to use */
+    edgeId?: string;
+    /** If true, connect() will succeed immediately */
+    autoConnect?: boolean;
+    /** If true, connect() will throw an error */
+    failConnect?: boolean;
+    /** Error message for failed connection */
+    connectError?: string;
+    /** Default response for sync operations */
+    defaultResponse?: 'success' | 'reject' | 'error';
+    /** Rejection error details */
+    rejectionError?: {
+        code: string;
+        field?: string;
+        message: string;
+    };
+}
+/**
+ * MockTransport for testing
+ */
+export declare class MockTransport implements Transport {
+    private state;
+    private stateCallbacks;
+    private updateCallbacks;
+    private errorCallbacks;
+    config: Required<Omit<MockTransportConfig, 'rejectionError'>> & {
+        rejectionError?: MockTransportConfig['rejectionError'];
+    };
+    sentBatches: {
+        collection: string;
+        changes: SyncChange[];
+    }[];
+    publishedBatches: {
+        collection: string;
+        changes: SyncChange[];
+    }[];
+    stateVectorRequests: {
+        collection: string;
+        docId: string;
+        localVector?: Uint8Array;
+    }[];
+    lastStateVectorRequest: {
+        collection: string;
+        docId: string;
+        localVector?: Uint8Array;
+    } | null;
+    snapshotRequests: {
+        collection: string;
+        docId: string;
+    }[];
+    forcePushRequests: {
+        collection: string;
+        docId: string;
+        stateVector: Uint8Array;
+        changes: Uint8Array[];
+        force: true;
+    }[];
+    private responseQueue;
+    private updateQueue;
+    private stateVectorResponseQueue;
+    private forcePushResponseQueue;
+    constructor(config?: MockTransportConfig);
+    getState(): TransportState;
+    getAppId(): string;
+    getEdgeId(): string;
+    onStateChange(callback: StateChangeCallback): () => void;
+    onUpdate(callback: UpdateCallback): () => void;
+    onError(callback: ErrorCallback): () => void;
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    sendBatch(collection: string, changes: SyncChange[]): Promise<SyncResponse[]>;
+    publish(collection: string, changes: SyncChange[]): void;
+    exchangeStateVector(collection: string, docId: string, localVector?: Uint8Array): Promise<StateVectorExchange>;
+    requestSnapshot(collection: string, docId: string): Promise<Uint8Array | null>;
+    forcePush(collection: string, docId: string, stateVector: Uint8Array, changes: Uint8Array[]): Promise<ForcePushResponse>;
+    /**
+     * Manually set the transport state
+     */
+    setState(state: TransportState): void;
+    /**
+     * Queue a specific response for a document
+     */
+    queueResponse(collection: string, docId: string, response: SyncResponse): void;
+    /**
+     * Queue a rejection for a document
+     */
+    queueRejection(collection: string, docId: string, error: {
+        code: string;
+        field?: string;
+        message: string;
+    }): void;
+    /**
+     * Simulate an external update from center
+     */
+    simulateUpdate(update: SyncUpdate): void;
+    private nextSendBatchError;
+    /**
+     * Simulate an error from the transport
+     */
+    simulateError(error: Error): void;
+    /**
+     * Simulate a server rejection for the next sendBatch call.
+     * Sets the default response to 'reject' with the given error.
+     */
+    simulateRejection(error: {
+        code: string;
+        field?: string;
+        message: string;
+    }): void;
+    /**
+     * Simulate a disconnection
+     */
+    simulateDisconnect(): void;
+    /**
+     * Simulate a reconnection
+     */
+    simulateReconnect(): void;
+    /**
+     * Set a specific response for state vector exchange
+     */
+    setStateVectorResponse(collection: string, docId: string, response: StateVectorExchange): void;
+    /**
+     * Set a specific response for force push
+     */
+    setForcePushResponse(collection: string, docId: string, response: ForcePushResponse): void;
+    /**
+     * Reset all recorded calls
+     */
+    reset(): void;
+    /**
+     * Get the number of sendBatch calls made
+     */
+    getSendBatchCallCount(): number;
+    /**
+     * Get the list of collections that have been synced
+     */
+    getSyncedCollections(): string[];
+}
+/**
+ * Create a mock transport for testing
+ */
+export declare function createMockTransport(config?: MockTransportConfig): MockTransport;
+//# sourceMappingURL=mock-transport.d.ts.map

package/dist/client/mock-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-transport.d.ts","sourceRoot":"","sources":["../../src/client/mock-transport.ts"],"names":[],"mappings":"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"}

package/dist/client/mock-transport.js

@@ -0,0 +1,292 @@
+/**
+ * MockTransport - A mock transport for testing sync engine without real NATS
+ *
+ * Provides:
+ * - Configurable connection behavior
+ * - Manual control over sync responses
+ * - Ability to simulate rejections and errors
+ */
+/**
+ * MockTransport for testing
+ */
+export class MockTransport {
+    state = 'disconnected';
+    stateCallbacks = new Set();
+    updateCallbacks = new Set();
+    errorCallbacks = new Set();
+    config;
+    // Recorded calls for assertions
+    sentBatches = [];
+    publishedBatches = [];
+    stateVectorRequests = [];
+    lastStateVectorRequest = null;
+    snapshotRequests = [];
+    forcePushRequests = [];
+    // Queued responses for specific documents
+    responseQueue = new Map();
+    updateQueue = [];
+    stateVectorResponseQueue = new Map();
+    forcePushResponseQueue = new Map();
+    constructor(config = {}) {
+        this.config = {
+            appId: config.appId ?? 'test-app',
+            edgeId: config.edgeId ?? 'test-edge',
+            autoConnect: config.autoConnect ?? true,
+            failConnect: config.failConnect ?? false,
+            connectError: config.connectError ?? 'Mock connection failed',
+            defaultResponse: config.defaultResponse ?? 'success',
+            rejectionError: config.rejectionError,
+        };
+    }
+    getState() {
+        return this.state;
+    }
+    getAppId() {
+        return this.config.appId;
+    }
+    getEdgeId() {
+        return this.config.edgeId;
+    }
+    onStateChange(callback) {
+        this.stateCallbacks.add(callback);
+        callback(this.state);
+        return () => this.stateCallbacks.delete(callback);
+    }
+    onUpdate(callback) {
+        this.updateCallbacks.add(callback);
+        // Deliver any queued updates
+        for (const update of this.updateQueue) {
+            callback(update);
+        }
+        this.updateQueue = [];
+        return () => this.updateCallbacks.delete(callback);
+    }
+    onError(callback) {
+        this.errorCallbacks.add(callback);
+        return () => this.errorCallbacks.delete(callback);
+    }
+    async connect() {
+        if (this.config.failConnect) {
+            throw new Error(this.config.connectError);
+        }
+        this.setState('connecting');
+        if (this.config.autoConnect) {
+            // Simulate async connection
+            await new Promise(resolve => setTimeout(resolve, 0));
+            this.setState('connected');
+        }
+    }
+    async disconnect() {
+        this.setState('disconnected');
+    }
+    async sendBatch(collection, changes) {
+        this.sentBatches.push({ collection, changes });
+        if (this.state !== 'connected') {
+            throw new Error('Not connected');
+        }
+        // Check if we should throw an error
+        if (this.nextSendBatchError) {
+            const error = this.nextSendBatchError;
+            this.nextSendBatchError = null;
+            throw error;
+        }
+        return changes.map(change => {
+            const key = `${change.collection}:${change.docId}`;
+            const queuedResponse = this.responseQueue.get(key);
+            if (queuedResponse) {
+                this.responseQueue.delete(key);
+                return queuedResponse;
+            }
+            // Use default response
+            if (this.config.defaultResponse === 'reject') {
+                return {
+                    success: false,
+                    docId: change.docId,
+                    collection: change.collection,
+                    error: this.config.rejectionError ?? {
+                        code: 'UNKNOWN',
+                        message: 'Mock rejection',
+                    },
+                };
+            }
+            if (this.config.defaultResponse === 'error') {
+                throw new Error('Mock sync error');
+            }
+            return {
+                success: true,
+                docId: change.docId,
+                collection: change.collection,
+            };
+        });
+    }
+    publish(collection, changes) {
+        this.publishedBatches.push({ collection, changes });
+        if (this.state !== 'connected') {
+            throw new Error('Not connected');
+        }
+    }
+    async exchangeStateVector(collection, docId, localVector) {
+        const request = { collection, docId, localVector };
+        this.stateVectorRequests.push(request);
+        this.lastStateVectorRequest = request;
+        // Check for queued response
+        const key = `${collection}:${docId}`;
+        const queuedResponse = this.stateVectorResponseQueue.get(key);
+        if (queuedResponse) {
+            return queuedResponse;
+        }
+        return {
+            collection,
+            docId,
+            vector: new Uint8Array(0),
+        };
+    }
+    async requestSnapshot(collection, docId) {
+        this.snapshotRequests.push({ collection, docId });
+        return null;
+    }
+    async forcePush(collection, docId, stateVector, changes) {
+        this.forcePushRequests.push({
+            collection,
+            docId,
+            stateVector,
+            changes,
+            force: true,
+        });
+        if (this.state !== 'connected') {
+            throw new Error('Not connected');
+        }
+        // Check for queued response
+        const key = `${collection}:${docId}`;
+        const queuedResponse = this.forcePushResponseQueue.get(key);
+        if (queuedResponse) {
+            this.forcePushResponseQueue.delete(key);
+            return queuedResponse;
+        }
+        // Default success response
+        return { success: true };
+    }
+    // Test helper methods
+    /**
+     * Manually set the transport state
+     */
+    setState(state) {
+        if (this.state !== state) {
+            this.state = state;
+            for (const callback of this.stateCallbacks) {
+                callback(state);
+            }
+        }
+    }
+    /**
+     * Queue a specific response for a document
+     */
+    queueResponse(collection, docId, response) {
+        this.responseQueue.set(`${collection}:${docId}`, response);
+    }
+    /**
+     * Queue a rejection for a document
+     */
+    queueRejection(collection, docId, error) {
+        this.queueResponse(collection, docId, {
+            success: false,
+            docId,
+            collection,
+            error,
+        });
+    }
+    /**
+     * Simulate an external update from center
+     */
+    simulateUpdate(update) {
+        if (this.updateCallbacks.size === 0) {
+            this.updateQueue.push(update);
+        }
+        else {
+            for (const callback of this.updateCallbacks) {
+                callback(update);
+            }
+        }
+    }
+    // Store the next error to throw on sendBatch
+    nextSendBatchError = null;
+    /**
+     * Simulate an error from the transport
+     */
+    simulateError(error) {
+        this.nextSendBatchError = error;
+        for (const callback of this.errorCallbacks) {
+            callback(error);
+        }
+    }
+    /**
+     * Simulate a server rejection for the next sendBatch call.
+     * Sets the default response to 'reject' with the given error.
+     */
+    simulateRejection(error) {
+        this.config.defaultResponse = 'reject';
+        this.config.rejectionError = error;
+    }
+    /**
+     * Simulate a disconnection
+     */
+    simulateDisconnect() {
+        this.setState('reconnecting');
+    }
+    /**
+     * Simulate a reconnection
+     */
+    simulateReconnect() {
+        this.setState('connected');
+    }
+    /**
+     * Set a specific response for state vector exchange
+     */
+    setStateVectorResponse(collection, docId, response) {
+        this.stateVectorResponseQueue.set(`${collection}:${docId}`, response);
+    }
+    /**
+     * Set a specific response for force push
+     */
+    setForcePushResponse(collection, docId, response) {
+        this.forcePushResponseQueue.set(`${collection}:${docId}`, response);
+    }
+    /**
+     * Reset all recorded calls
+     */
+    reset() {
+        this.sentBatches = [];
+        this.publishedBatches = [];
+        this.stateVectorRequests = [];
+        this.lastStateVectorRequest = null;
+        this.stateVectorResponseQueue.clear();
+        this.snapshotRequests = [];
+        this.responseQueue.clear();
+        this.updateQueue = [];
+        this.forcePushRequests = [];
+        this.forcePushResponseQueue.clear();
+    }
+    /**
+     * Get the number of sendBatch calls made
+     */
+    getSendBatchCallCount() {
+        return this.sentBatches.length;
+    }
+    /**
+     * Get the list of collections that have been synced
+     */
+    getSyncedCollections() {
+        const collections = new Set();
+        for (const batch of this.sentBatches) {
+            collections.add(batch.collection);
+        }
+        return Array.from(collections);
+    }
+}
+/**
+ * Create a mock transport for testing
+ */
+export function createMockTransport(config = {}) {
+    return new MockTransport(config);
+}
+//# sourceMappingURL=mock-transport.js.map