SyncManager

The SyncManager class in SignalDB is designed to handle the synchronization of collections between your local storage and a remote source. It manages both pushing local changes to the server and pulling updates from the server, ensuring that your data remains consistent and up-to-date.

Key Features

• Automatic Syncing: Synchronizes local changes with a remote source and updates local data from the server.
• Error Handling: Provides options to handle errors that occur during the sync process.
• Debouncing: Uses debouncing to limit the frequency of sync operations, reducing unnecessary network requests.
• Collection Management: Easily add and manage collections that require synchronization.

Constructor

new SyncManager(options)

Creates a new instance of SyncManager.

Parameters

• options (Options): Configuration options for the sync manager.

  • pull: Function to fetch data from the remote source.
  • push: Function to send changes to the remote source.
  • registerRemoteChange: Optional function to register a callback for remote changes.
  • id: Optional unique identifier for the sync manager.
  • persistenceAdapter: Optional function to create a persistence adapter.
  • reactivity: Optional reactivity adapter for handling reactivity.
  • onError: Optional function to handle errors.

Methods

addCollection(collection, options)

Adds a collection to the sync manager.

Parameters

• collection (Collection): The collection to add.
• options (SyncOptions): Configuration options for the collection.

getCollection(name)

Retrieves a collection and its options by name.

Parameters

• name (string): The name of the collection.

Returns

• Tuple<Collection, SyncOptions>: The collection and its options.

syncAll()

Starts the sync process for all collections managed by the sync manager.

isSyncing(name?)

Checks if a specific collection or any collection is currently being synced.

Parameters

• name (string, optional): The name of the collection. If omitted, checks all collections.

Returns

• boolean: true if syncing, false otherwise.

sync(name, options)

Starts the sync process for a specific collection.

Parameters

• name (string): The name of the collection.
• options (object, optional): Sync options.
  • force (boolean, optional): If true, forces the sync process even if no changes are detected.
  • onlyWithChanges (boolean, optional): If true, syncs only if there are changes.

pushChanges(name)

Initiates the push process for a collection, syncing only if there are changes.

Parameters

• name (string): The name of the collection.