@jagoankasir/offline

Offline-first sync queue untuk POS. Transaksi disimpan di IndexedDB (Dexie.js) dan dikirim otomatis saat koneksi pulih. Idempotency key mencegah struk ganda.

Install

npm install @jagoankasir/offline

Usage

import { useOfflineSync } from '@jagoankasir/offline'

// You provide a sync adapter that talks to your backend
const sync = useOfflineSync({
  adapter: {
    async insertTransaction(tx) {
      const res = await fetch('/api/transactions', {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify(tx),
      })
      if (res.status === 409) return { ok: false, conflict: true }
      return { ok: res.ok }
    },
    async reduceStock(items) {
      await fetch('/api/stock/decrement', {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify(items),
      })
    },
  },
})

// Enqueue when offline
sync.enqueue({
  localId: 'tx_123',
  items: [...],
  subtotal: 50000,
  discountPct: 0,
  discountValue: 0,
  taxValue: 5500,
  total: 55500,
  paid: 60000,
  change: 4500,
})

// sync.pendingCount — jumlah antrian
// sync.isOnline — status koneksi
// sync.flush() — kirim manual

How it works

1. Saat offline, transaksi disimpan ke IndexedDB via Dexie.js
2. Saat browser mendeteksi koneksi kembali, antrian otomatis dikirim
3. localId berfungsi sebagai idempotency key — jika backend mengembalikan konflik (409), transaksi ditandai sudah tersinkron
4. Setelah berhasil, reduceStock dipanggil untuk mengurangi stok

License

MIT