What’s syncMode "manual" for? Offline data and sync later?

[Crsk]

I noticed the store accepts a syncMode property ("auto" or "manual"), but there seem not to be docs about it.

I want users to create data without an account first. Is syncMode meant for this use case? Letting them sync data later after signing up?

[StevePhuc]

search the code and here is said

legend-state/src/sync/syncObservable.ts

Lines 1381 to 1382 in 5beaf70

	// If remote is not manual, then sync() is called automatically
	if ((syncOptions.get || syncOptions.subscribe) && syncOptions.syncMode === 'auto') {

https://legendapp.com/open-source/state/v3/sync/persist-sync/#syncstate
sync: () => Promise<void>: Re-run the get function

so this is only for sync get . how about we want to manual sync push.

tesed and work with my case allow for manual sync

// Provide a function to generate ids locally
const generateId = () => uuidv4();

// Create a configured sync function
const customSynced = configureSynced(syncedSupabase, {
  persist: {
    plugin: observablePersistSqlite(Storage)
  },
  generateId,
  supabase,
  changesSince: 'last-sync',
  fieldCreatedAt: 'created_at',
  fieldUpdatedAt: 'updated_at',
  // Optionally enable soft deletes
  fieldDeleted: 'deleted',
});

export const todos$ = observable(
  customSynced({
    supabase,
    collection: 'todos',
    select: (from) =>
      from.select('id,counter,text,done,created_at,updated_at,deleted'),
    actions: ['read', 'create', 'update', 'delete'],
    // realtime: true,
    // Persist data and pending changes locally
    persist: {
      name: 'todos-12',
      retrySync: true, // Persist pending changes and retry
    },
    retry: {
      infinite: true, // Retry changes with exponential backoff
    },
    syncMode: 'manual',
  }),

);

and then later when wanted to manually sync

export function syncTodos() {
  // getPendingChanges: () => Record<string, object>: Get all unsaved changed
  const pendingChanges = syncState(todos$).getPendingChanges()
  console.log('pendingChanges', pendingChanges)
  // error: Error: The latest error
  const error = syncState(todos$).error.get()
  console.log('error', error)
  syncState(todos$).sync()
}