Offline queue

Pass offline: true when constructing the client and the SDK exposes cstar.offlineQueue. Failed mutations buffer there and auto-flush when the network comes back. Optional localStorage persistence survives page reloads.

Enable

setup.js

import { CStarClient } from '@cstar.help/js';

const cstar = new CStarClient({
  apiKey: 'sk_live_...',
  teamId: 'your-team-id',
  offline: true                            // Memory storage, auto-flush on
});

// Or pass options:
const persistedClient = new CStarClient({
  apiKey: 'sk_live_...',
  teamId: 'your-team-id',
  offline: { storage: 'localStorage' }     // Survives page reloads in the browser
});

Without the offline flag, cstar.offlineQueue is null.

Enqueue manually

Most callers won't touch this — the SDK enqueues for you when a mutation fails to reach the network. But you can prime the queue yourself if you know you're working offline:

enqueue.js

const id = cstar.offlineQueue.enqueue('POST', '/tickets', {
  title: 'Bug report',
  priority: 'high'
});
// Returns the queue item ID for later inspection

Flush

Auto-flush kicks in on the browser's online event. Trigger manually if needed:

flush.js

const results = await cstar.offlineQueue.flush();

for (const r of results) {
  if (r.success) log.info('replayed', r.id);
  else log.error('replay failed', r.id, r.error);
}

Control auto-flush

control.js

// Pause replays — useful while testing
cstar.offlineQueue.disableAutoFlush();

// Re-enable
cstar.offlineQueue.enableAutoFlush();

// Drop everything (e.g. on logout)
cstar.offlineQueue.clear();

Pair with idempotency keys

Replays are at-least-once. If a queued POST succeeded server-side but the response was lost, the replay creates a duplicate row unless you sent an idempotencyKey on the original call. Pass one on every mutation that goes through the queue.

Next up

Idempotency The other half of safe replay. Retry & rate limits What the SDK retries automatically before queuing.