@nolag/sync

import { NoLagApi } from "@nolag/js-sdk";

const api = new NoLagApi(process.env.NOLAG_API_KEY); // nlg_live_...
const app = await api.apps.create({ name: "My App", blueprintId: "nolag-sync-sdk" });
console.log(app.slug); // e.g. "my-app-a3f9": this is your appName

const actor = await api.actors.create({ name: "web-client", actorType: "user" });
console.log(actor.accessToken); // shown once; keep it

npm install @nolag/sync @nolag/js-sdk

import { NoLag } from '@nolag/js-sdk'
import { NoLagSync } from '@nolag/sync'

// The app owns one core client. In a browser, pass a token provider so the
// SDK can mint fresh short-lived client tokens from your backend.
const client = NoLag(async () => (await (await fetch('/api/nolag-token')).json()).token)

// Inject the client into the sync wrapper
const sync = new NoLagSync({
  client,
  appName: APP_SLUG, // the slug returned when you created the app
  username: 'Alice',
})

await client.connect()   // the app owns the connection
await sync.ready()       // wrapper setup complete

// Join a seeded collection (analogous to a database table)
const collection = sync.joinCollection('todos')

// React to changes. These fire for your own writes and for remote ones.
collection.on('documentCreated', (doc) => {
  console.log('New document:', doc.id, doc.data)
})

collection.on('documentUpdated', (doc) => {
  console.log('Updated:', doc.id, 'v' + doc.version, 'by', doc.updatedBy)
})

collection.on('documentDeleted', (doc) => {
  console.log('Deleted:', doc.id)
})

// Conflicts: equal versions from two writers, or a stale remote change
collection.on('conflict', ({ documentId, localChange, remoteChange, resolved }) => {
  console.warn(
    `Conflict on ${documentId}: local v${localChange.version} vs remote v${remoteChange.version};` +
      ` kept v${resolved.version} by ${resolved.updatedBy}`,
  )
})

// Fires after every remote change is applied, with the resulting document
collection.on('synced', (doc) => {
  console.log('Applied remote change to', doc.id)
})

// Create a document (collaborators see it instantly; version starts at 1)
const created = collection.createDocument('task-001', {
  title: 'Design new homepage',
  status: 'todo',
  assignee: 'alice',
  priority: 1,
})
console.log(created.version) // 1

// Update specific fields (merged into data; version becomes 2)
const updated = collection.updateDocument('task-001', {
  status: 'in-progress',
  assignee: 'bob',
})
console.log(updated?.version) // 2

// Read from the local cache (no network call)
const task = collection.getDocument('task-001')
console.log(task?.data.status) // 'in-progress'

const all = collection.getAllDocuments()
console.log(`${all.length} documents in collection`)

// Delete a document (soft delete: excluded from getAllDocuments)
collection.deleteDocument('task-001')

// Teardown: the wrapper releases its handlers; the app closes the socket.
sync.detach()
client.disconnect()