sync-later 1.0.0

package/README.ID.md

@@ -0,0 +1,137 @@
+# Rest Queue
+
+**Engine Mutasi Offline-First untuk Standar REST API**
+
+
+`sync-later` adalah perpustakaan (library) yang kuat dan ringan yang dirancang untuk memastikan mutasi data Anda (POST, PUT, DELETE, PATCH) tidak pernah gagal, bahkan dalam kondisi jaringan yang tidak stabil. Library ini menyimpan permintaan (request), menangani percobaan ulang (retry) dengan strategi exponential backoff, mengelola rantai dependensi yang kompleks antar permintaan, dan kini mendukung unggahan file serta pembaruan event yang reaktif.
+
+Berbeda dengan solusi berat seperti TanStack Query atau Apollo Client yang berfokus pada *fetching* (pengambilan data), `sync-later` berfokus murni pada *mutasi yang reliable*.
+
+## Fitur 🚀
+
+- **Tanpa Dependensi**: Murni TypeScript, ukuran bundle sangat kecil.
+- **Offline-First**: Permintaan disimpan ke IndexedDB secara langsung.
+- **Tangguh**: Percobaan ulang otomatis dengan strategi exponential backoff.
+- **Dependency Chaining**: Buat rantai permintaan orang tua-anak (misalnya, buat Post -> buat Komentar) di mana anak bergantung pada ID orang tua bahkan sebelum orang tua berhasil dibuat.
+- **Sistem Event Reaktif**: Berlangganan ke pembaruan antrean (`queue_update`, `process_success`, `process_fail`).
+- **Dukungan File**: Dukungan kelas satu untuk unggahan `FormData`, `Blob`, dan `File`.
+- **Dapat Dibatalkan**: Batalkan permintaan yang tertunda dengan mudah.
+- **Kontrol Konkurensi**: Pemrosesan serial menjamin urutan.
+
+## Instalasi
+
+```bash
+npm install sync-later
+# atau
+pnpm add sync-later
+# atau
+yarn add sync-later
+```
+
+## Mulai Cepat
+
+```typescript
+import { RequestQueue } from 'sync-later';
+
+// 1. Inisialisasi antrean
+const queue = new RequestQueue({
+  retryPolicy: { maxRetries: 3, initialDelayMs: 1000 },
+  onQueueChange: (items) => console.log('Antrean diperbarui:', items.length)
+});
+
+// 2. Tambahkan permintaan (mengembalikan ID unik)
+const id = await queue.add({
+  url: 'https://api.example.com/posts',
+  method: 'POST',
+  body: { title: 'Halo Dunia' }
+});
+
+// Selesai! Library ini menangani sisanya:
+// - Menyimpan ke IndexedDB
+// - Memeriksa status jaringan
+// - Mengirim permintaan
+// - Mencoba lagi jika gagal
+// - Menghapus jika berhasil
+```
+
+## Konsep Inti
+
+### 1. Dependency Chaining 🔗
+Eksekusi permintaan yang bergantung tanpa menunggu permintaan pertama selesai. Gunakan `tempId` yang akan diganti secara otomatis ketika permintaan parent berhasil.
+
+```typescript
+const tempId = 'temp-123';
+
+// 1. Buat parent (Post)
+await queue.add({
+  tempId, // Tetapkan ID sementara
+  url: '/posts',
+  method: 'POST',
+  body: { title: 'Postingan Baru' }
+});
+
+// 2. Buat child (Komentar) - Menggunakan tempId
+await queue.add({
+  url: '/comments',
+  method: 'POST',
+  body: { 
+    postId: tempId, // Akan diganti dengan ID asli (misal: 101) setelah parent sukses
+    content: 'Postingan bagus!' 
+  }
+});
+```
+
+### 2. Unggah File 📁
+Unggah file dengan mulus. Library mendeteksi `FormData` dan melewati serialisasi JSON.
+
+```typescript
+const formData = new FormData();
+formData.append('file', myFile);
+
+await queue.add({
+  url: '/upload',
+  method: 'POST',
+  body: formData
+});
+```
+
+### 3. Event & Reaktivitas ⚡
+Perbarui UI Anda secara real-time.
+
+```typescript
+queue.addListener('queue_update', (items) => {
+  // Perbarui UI Anda dengan status antrean terbaru
+  setQueueItems(items);
+});
+
+queue.addListener('process_success', ({ id, response }) => {
+  console.log(`Permintaan ${id} berhasil!`, response);
+});
+```
+
+## Referensi API
+
+### `RequestQueue`
+Kelas utama.
+
+#### Constructor `new RequestQueue(config?)`
+- `config.retryPolicy`: `{ maxRetries: number, initialDelayMs: number }`
+- `config.userId`: `string` (Opsional, untuk dukungan isolasi multi-pengguna)
+- `config.onBeforeSend`: `(item) => Promise<item>` (Hook untuk memodifikasi permintaan sebelum dikirim, misal: melampirkan token)
+- `config.onQueueChange`: `(items) => void` (Jalan pintas untuk event queue_update)
+
+#### Metode
+- `add(request)`: Menambahkan permintaan. Mengembalikan `Promise<string>` (ID permintaan).
+- `remove(id)`: Membatalkan permintaan yang tertunda.
+- `getQueue()`: Mengembalikan semua item antrean saat ini.
+- `addListener(event, callback)`: Berlangganan event.
+- `removeListener(event, callback)`: Berhenti berlangganan.
+
+### Event
+- `queue_update`: Dipicu setiap kali antrean menambahkan, menghapus, atau memperbarui item.
+- `process_success`: Dipicu ketika permintaan berhasil.
+- `process_fail`: Dipicu ketika permintaan gagal secara permanen (setelah percobaan ulang).
+
+## Lisensi
+
+ISC © 2026 denisetiya

package/README.md

@@ -0,0 +1,136 @@
+# Rest Queue
+
+**Offline Mutation Engine for Standard REST API**
+
+`sync-later` is a robust, lightweight library designed to ensure your data mutations (POST, PUT, DELETE, PATCH) never fail, even in unstable network conditions. It persists requests, handles retries with exponential backoff, manages complex dependency chains between requests, and now supports file uploads and reactive event updates.
+
+Unlike heavyweight solutions like TanStack Query or Apollo Client which focus on *fetching*, `sync-later` focuses purely on *reliable mutations*.
+
+## Features 🚀
+
+- **Zero Dependencies**: Pure TypeScript, tiny bundle size.
+- **Offline-First**: Requests are persisted to IndexedDB immediately.
+- **Resilient**: Automatic retries with exponential backoff strategy.
+- **Dependency Chaining**: Create parent-child request chains (e.g., create Post -> create Comment) where the child relies on the parent's ID before the parent even succeeds.
+- **Reactive Event System**: Subscribe to queue updates (`queue_update`, `process_success`, `process_fail`).
+- **File Support**: First-class support for `FormData`, `Blob`, and `File` uploads.
+- **Cancellable**: Cancel pending requests easily.
+- **Concurrency Control**: Serial processing guarantees order.
+
+## Installation
+
+```bash
+npm install sync-later
+# or
+pnpm add sync-later
+# or
+yarn add sync-later
+```
+
+## Quick Start
+
+```typescript
+import { RequestQueue } from 'sync-later';
+
+// 1. Initialize the queue
+const queue = new RequestQueue({
+  retryPolicy: { maxRetries: 3, initialDelayMs: 1000 },
+  onQueueChange: (items) => console.log('Queue updated:', items.length)
+});
+
+// 2. Add a request (returns a unique ID)
+const id = await queue.add({
+  url: 'https://api.example.com/posts',
+  method: 'POST',
+  body: { title: 'Hello World' }
+});
+
+// That's it! The library handles the rest:
+// - Saves to IndexedDB
+// - Checks network status
+// - Sends request
+// - Retries on failure
+// - Removes on success
+```
+
+## Core Concepts
+
+### 1. Dependency Chaining 🔗
+Execute dependent requests without waiting for the first one to finish. Use a `tempId` that gets replaced automatically when the parent request succeeds.
+
+```typescript
+const tempId = 'temp-123';
+
+// 1. Create Parent (Post)
+await queue.add({
+  tempId, // Assign a temporary ID
+  url: '/posts',
+  method: 'POST',
+  body: { title: 'New Post' }
+});
+
+// 2. Create Child (Comment) - Uses tempId
+await queue.add({
+  url: '/comments',
+  method: 'POST',
+  body: { 
+    postId: tempId, // Will be replaced by real ID (e.g., 101) after parent succeeds
+    content: 'Nice post!' 
+  }
+});
+```
+
+### 2. File Uploads 📁
+Upload files seamlessly. The library detects `FormData` and skips JSON serialization.
+
+```typescript
+const formData = new FormData();
+formData.append('file', myFile);
+
+await queue.add({
+  url: '/upload',
+  method: 'POST',
+  body: formData
+});
+```
+
+### 3. Events & Reactivity ⚡
+Update your UI in real-time.
+
+```typescript
+queue.addListener('queue_update', (items) => {
+  // Update your UI with the latest queue state
+  setQueueItems(items);
+});
+
+queue.addListener('process_success', ({ id, response }) => {
+  console.log(`Request ${id} succeeded!`, response);
+});
+```
+
+## API Reference
+
+### `RequestQueue`
+The main class.
+
+#### Constructor `new RequestQueue(config?)`
+- `config.retryPolicy`: `{ maxRetries: number, initialDelayMs: number }`
+- `config.userId`: `string` (Optional, for multi-user isolation support)
+- `config.onBeforeSend`: `(item) => Promise<item>` (Hook to modify request before sending, e.g., attach tokens)
+- `config.onQueueChange`: `(items) => void` (Shortcut for queue_update event)
+
+#### Methods
+- `add(request)`: Adds a request. Returns `Promise<string>` (the request ID).
+- `remove(id)`: Cancels a pending request.
+- `getQueue()`: Returns all current queue items.
+- `addListener(event, callback)`: Subscribe to events.
+- `removeListener(event, callback)`: Unsubscribe.
+
+### Events
+- `queue_update`: Fired whenever the queue adds, removes, or updates an item.
+- `process_success`: Fired when a request succeeds.
+- `process_fail`: Fired when a request permanently fails (after retries).
+
+## License
+
+ISC © 2026 denisetiya

package/dist/index.d.mts

@@ -0,0 +1,59 @@
+type HttpMethod = 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+type QueueItemStatus = 'PENDING' | 'PROCESSING' | 'RETRYING' | 'COMPLETED' | 'FAILED';
+interface QueueItem {
+    id: string;
+    tempId?: string;
+    url: string;
+    method: HttpMethod;
+    body?: unknown;
+    headers?: Record<string, string>;
+    createdAt: number;
+    status: QueueItemStatus;
+    retryCount: number;
+    userId?: string;
+    error?: string;
+}
+interface QueueConfig {
+    remoteUrl?: string;
+    retryPolicy?: {
+        maxRetries: number;
+        initialDelayMs: number;
+    };
+    userId?: string;
+    onBeforeSend?: (request: QueueItem) => Promise<QueueItem | void>;
+    onQueueChange?: (queue: QueueItem[]) => void;
+}
+type QueueEventType = 'queue_update' | 'process_success' | 'process_fail';
+type QueueEventCallback = (data?: unknown) => void;
+
+declare class RequestQueue {
+    private queue;
+    private isProcessing;
+    private config;
+    private storage;
+    private readyPromise;
+    private listeners;
+    constructor(config?: QueueConfig);
+    addListener(type: QueueEventType, callback: QueueEventCallback): void;
+    removeListener(type: QueueEventType, callback: QueueEventCallback): void;
+    private emit;
+    private setupNetworkListener;
+    private hydrate;
+    /**
+     * Add a request to the queue
+     */
+    add(request: Omit<QueueItem, 'id' | 'createdAt' | 'status' | 'retryCount'>): Promise<string>;
+    /**
+    * Remove a request (Cancel)
+    */
+    remove(id: string): Promise<void>;
+    /**
+     * Process the queue serially
+     */
+    private process;
+    private resolveDependencies;
+    private performRequest;
+    getQueue(): Promise<QueueItem[]>;
+}
+
+export { type HttpMethod, type QueueConfig, type QueueEventCallback, type QueueEventType, type QueueItem, type QueueItemStatus, RequestQueue };

package/dist/index.d.ts

@@ -0,0 +1,59 @@
+type HttpMethod = 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+type QueueItemStatus = 'PENDING' | 'PROCESSING' | 'RETRYING' | 'COMPLETED' | 'FAILED';
+interface QueueItem {
+    id: string;
+    tempId?: string;
+    url: string;
+    method: HttpMethod;
+    body?: unknown;
+    headers?: Record<string, string>;
+    createdAt: number;
+    status: QueueItemStatus;
+    retryCount: number;
+    userId?: string;
+    error?: string;
+}
+interface QueueConfig {
+    remoteUrl?: string;
+    retryPolicy?: {
+        maxRetries: number;
+        initialDelayMs: number;
+    };
+    userId?: string;
+    onBeforeSend?: (request: QueueItem) => Promise<QueueItem | void>;
+    onQueueChange?: (queue: QueueItem[]) => void;
+}
+type QueueEventType = 'queue_update' | 'process_success' | 'process_fail';
+type QueueEventCallback = (data?: unknown) => void;
+
+declare class RequestQueue {
+    private queue;
+    private isProcessing;
+    private config;
+    private storage;
+    private readyPromise;
+    private listeners;
+    constructor(config?: QueueConfig);
+    addListener(type: QueueEventType, callback: QueueEventCallback): void;
+    removeListener(type: QueueEventType, callback: QueueEventCallback): void;
+    private emit;
+    private setupNetworkListener;
+    private hydrate;
+    /**
+     * Add a request to the queue
+     */
+    add(request: Omit<QueueItem, 'id' | 'createdAt' | 'status' | 'retryCount'>): Promise<string>;
+    /**
+    * Remove a request (Cancel)
+    */
+    remove(id: string): Promise<void>;
+    /**
+     * Process the queue serially
+     */
+    private process;
+    private resolveDependencies;
+    private performRequest;
+    getQueue(): Promise<QueueItem[]>;
+}
+
+export { type HttpMethod, type QueueConfig, type QueueEventCallback, type QueueEventType, type QueueItem, type QueueItemStatus, RequestQueue };

package/dist/index.js

@@ -0,0 +1 @@
+"use strict";var d=Object.defineProperty;var h=Object.getOwnPropertyDescriptor;var f=Object.getOwnPropertyNames;var p=Object.prototype.hasOwnProperty;var y=(u,e)=>{for(var s in e)d(u,s,{get:e[s],enumerable:!0})},m=(u,e,s,t)=>{if(e&&typeof e=="object"||typeof e=="function")for(let i of f(e))!p.call(u,i)&&i!==s&&d(u,i,{get:()=>e[i],enumerable:!(t=h(e,i))||t.enumerable});return u};var g=u=>m(d({},"__esModule",{value:!0}),u);var b={};y(b,{RequestQueue:()=>l});module.exports=g(b);var w="sync-later-db";var a="queue",c=class{dbPromise;constructor(){this.dbPromise=this.openDB()}openDB(){return typeof window>"u"||!window.indexedDB?Promise.reject(new Error("IndexedDB not supported")):new Promise((e,s)=>{let t=window.indexedDB.open(w,1);t.onupgradeneeded=i=>{let r=i.target.result;r.objectStoreNames.contains(a)||r.createObjectStore(a,{keyPath:"id"})},t.onsuccess=i=>{e(i.target.result)},t.onerror=i=>{s(i.target.error)}})}async getAll(){let e=await this.dbPromise;return new Promise((s,t)=>{let o=e.transaction(a,"readonly").objectStore(a).getAll();o.onsuccess=()=>s(o.result),o.onerror=()=>t(o.error)})}async save(e){let s=await this.dbPromise;return new Promise((t,i)=>{let n=s.transaction(a,"readwrite").objectStore(a).put(e);n.onsuccess=()=>t(),n.onerror=()=>i(n.error)})}async delete(e){let s=await this.dbPromise;return new Promise((t,i)=>{let n=s.transaction(a,"readwrite").objectStore(a).delete(e);n.onsuccess=()=>t(),n.onerror=()=>i(n.error)})}async clear(){let e=await this.dbPromise;return new Promise((s,t)=>{let o=e.transaction(a,"readwrite").objectStore(a).clear();o.onsuccess=()=>s(),o.onerror=()=>t(o.error)})}};var l=class{queue=[];isProcessing=!1;config;storage;readyPromise;listeners=new Map;constructor(e={}){this.config=e,this.storage=new c,this.setupNetworkListener(),this.readyPromise=this.hydrate()}addListener(e,s){this.listeners.has(e)||this.listeners.set(e,new Set),this.listeners.get(e)?.add(s)}removeListener(e,s){this.listeners.get(e)?.delete(s)}emit(e,s){this.listeners.get(e)?.forEach(t=>t(s)),e==="queue_update"&&this.config.onQueueChange&&this.config.onQueueChange(this.queue)}setupNetworkListener(){typeof window<"u"&&window.addEventListener&&window.addEventListener("online",()=>{console.log("Network online, processing queue..."),this.process()})}async hydrate(){try{let e=await this.storage.getAll();e&&e.length>0&&(this.queue=e.sort((s,t)=>s.createdAt-t.createdAt))}catch(e){console.warn("Failed to hydrate queue from storage",e)}}async add(e){if(await this.readyPromise,!e.body||typeof e.body=="object"&&!(e.body instanceof Blob)&&!(e.body instanceof FormData)){let r=e.body?JSON.stringify(e.body):"",o=this.queue.find(n=>n.status==="PENDING"&&n.url===e.url&&n.method===e.method&&(n.body?JSON.stringify(n.body):"")===r);if(o)return console.warn("Duplicate request detected, ignoring.",e),o.id}let t=crypto.randomUUID(),i={...e,id:t,createdAt:Date.now(),status:"PENDING",retryCount:0};return this.queue.push(i),await this.storage.save(i),this.emit("queue_update",this.queue),typeof navigator<"u"&&navigator.onLine===!1||this.process(),t}async remove(e){await this.readyPromise;let s=this.queue.findIndex(i=>i.id===e);if(s===-1)return;if(this.queue[s].status==="PROCESSING"){console.warn("Cannot cancel a request that is currently processing:",e);return}this.queue.splice(s,1),await this.storage.delete(e),this.emit("queue_update",this.queue)}async process(){if(!this.isProcessing&&(await this.readyPromise,this.queue.length!==0&&!(typeof navigator<"u"&&navigator.onLine===!1))){this.isProcessing=!0;try{let e=this.queue[0];if(this.config.userId&&e.userId&&e.userId!==this.config.userId){this.isProcessing=!1;return}if(e.status==="RETRYING"){let i=(this.config.retryPolicy||{maxRetries:3,initialDelayMs:1e3}).initialDelayMs*Math.pow(2,e.retryCount-1);await new Promise(r=>setTimeout(r,i))}e.status="PROCESSING",await this.storage.save(e),this.emit("queue_update",this.queue);let s=e;if(this.config.onBeforeSend){let t=await this.config.onBeforeSend(e);t&&(s=t)}try{let t=await this.performRequest(s);if(e.status="COMPLETED",this.emit("process_success",{id:e.id,response:t}),e.tempId&&t&&typeof t=="object"&&"id"in t){let i=String(t.id);await this.resolveDependencies(e.tempId,i)}this.queue.shift(),await this.storage.delete(e.id),this.emit("queue_update",this.queue)}catch(t){console.error("Request failed",t);let i=this.config.retryPolicy?.maxRetries??3;e.retryCount<i?(e.status="RETRYING",e.retryCount++,e.error=String(t),await this.storage.save(e),this.emit("queue_update",this.queue)):(e.status="FAILED",e.error=String(t),this.queue.shift(),await this.storage.delete(e.id),this.emit("process_fail",{id:e.id,error:t}),this.emit("queue_update",this.queue))}}finally{this.isProcessing=!1,this.queue.length>0&&this.process()}}}async resolveDependencies(e,s){for(let t of this.queue){if(t.status!=="PENDING")continue;let i=!1;if(t.url.includes(e)&&(t.url=t.url.replace(e,s),i=!0),t.body){let r=JSON.stringify(t.body);if(r.includes(e)){let o=r.replaceAll(e,s);t.body=JSON.parse(o),i=!0}}i&&await this.storage.save(t)}}async performRequest(e){let s={...e.headers},t;e.body instanceof FormData||e.body instanceof Blob||e.body instanceof File?t=e.body:e.body&&(t=JSON.stringify(e.body),s["Content-Type"]||(s["Content-Type"]="application/json"));let i=await fetch(e.url,{method:e.method,body:t,headers:s});if(!i.ok)throw new Error(`HTTP Error ${i.status}`);let r=await i.text();try{return r?JSON.parse(r):{}}catch{return{}}}async getQueue(){return await this.readyPromise,[...this.queue]}};0&&(module.exports={RequestQueue});

package/dist/index.mjs

@@ -0,0 +1 @@
+var l="sync-later-db";var a="queue",u=class{dbPromise;constructor(){this.dbPromise=this.openDB()}openDB(){return typeof window>"u"||!window.indexedDB?Promise.reject(new Error("IndexedDB not supported")):new Promise((e,s)=>{let t=window.indexedDB.open(l,1);t.onupgradeneeded=i=>{let r=i.target.result;r.objectStoreNames.contains(a)||r.createObjectStore(a,{keyPath:"id"})},t.onsuccess=i=>{e(i.target.result)},t.onerror=i=>{s(i.target.error)}})}async getAll(){let e=await this.dbPromise;return new Promise((s,t)=>{let o=e.transaction(a,"readonly").objectStore(a).getAll();o.onsuccess=()=>s(o.result),o.onerror=()=>t(o.error)})}async save(e){let s=await this.dbPromise;return new Promise((t,i)=>{let n=s.transaction(a,"readwrite").objectStore(a).put(e);n.onsuccess=()=>t(),n.onerror=()=>i(n.error)})}async delete(e){let s=await this.dbPromise;return new Promise((t,i)=>{let n=s.transaction(a,"readwrite").objectStore(a).delete(e);n.onsuccess=()=>t(),n.onerror=()=>i(n.error)})}async clear(){let e=await this.dbPromise;return new Promise((s,t)=>{let o=e.transaction(a,"readwrite").objectStore(a).clear();o.onsuccess=()=>s(),o.onerror=()=>t(o.error)})}};var c=class{queue=[];isProcessing=!1;config;storage;readyPromise;listeners=new Map;constructor(e={}){this.config=e,this.storage=new u,this.setupNetworkListener(),this.readyPromise=this.hydrate()}addListener(e,s){this.listeners.has(e)||this.listeners.set(e,new Set),this.listeners.get(e)?.add(s)}removeListener(e,s){this.listeners.get(e)?.delete(s)}emit(e,s){this.listeners.get(e)?.forEach(t=>t(s)),e==="queue_update"&&this.config.onQueueChange&&this.config.onQueueChange(this.queue)}setupNetworkListener(){typeof window<"u"&&window.addEventListener&&window.addEventListener("online",()=>{console.log("Network online, processing queue..."),this.process()})}async hydrate(){try{let e=await this.storage.getAll();e&&e.length>0&&(this.queue=e.sort((s,t)=>s.createdAt-t.createdAt))}catch(e){console.warn("Failed to hydrate queue from storage",e)}}async add(e){if(await this.readyPromise,!e.body||typeof e.body=="object"&&!(e.body instanceof Blob)&&!(e.body instanceof FormData)){let r=e.body?JSON.stringify(e.body):"",o=this.queue.find(n=>n.status==="PENDING"&&n.url===e.url&&n.method===e.method&&(n.body?JSON.stringify(n.body):"")===r);if(o)return console.warn("Duplicate request detected, ignoring.",e),o.id}let t=crypto.randomUUID(),i={...e,id:t,createdAt:Date.now(),status:"PENDING",retryCount:0};return this.queue.push(i),await this.storage.save(i),this.emit("queue_update",this.queue),typeof navigator<"u"&&navigator.onLine===!1||this.process(),t}async remove(e){await this.readyPromise;let s=this.queue.findIndex(i=>i.id===e);if(s===-1)return;if(this.queue[s].status==="PROCESSING"){console.warn("Cannot cancel a request that is currently processing:",e);return}this.queue.splice(s,1),await this.storage.delete(e),this.emit("queue_update",this.queue)}async process(){if(!this.isProcessing&&(await this.readyPromise,this.queue.length!==0&&!(typeof navigator<"u"&&navigator.onLine===!1))){this.isProcessing=!0;try{let e=this.queue[0];if(this.config.userId&&e.userId&&e.userId!==this.config.userId){this.isProcessing=!1;return}if(e.status==="RETRYING"){let i=(this.config.retryPolicy||{maxRetries:3,initialDelayMs:1e3}).initialDelayMs*Math.pow(2,e.retryCount-1);await new Promise(r=>setTimeout(r,i))}e.status="PROCESSING",await this.storage.save(e),this.emit("queue_update",this.queue);let s=e;if(this.config.onBeforeSend){let t=await this.config.onBeforeSend(e);t&&(s=t)}try{let t=await this.performRequest(s);if(e.status="COMPLETED",this.emit("process_success",{id:e.id,response:t}),e.tempId&&t&&typeof t=="object"&&"id"in t){let i=String(t.id);await this.resolveDependencies(e.tempId,i)}this.queue.shift(),await this.storage.delete(e.id),this.emit("queue_update",this.queue)}catch(t){console.error("Request failed",t);let i=this.config.retryPolicy?.maxRetries??3;e.retryCount<i?(e.status="RETRYING",e.retryCount++,e.error=String(t),await this.storage.save(e),this.emit("queue_update",this.queue)):(e.status="FAILED",e.error=String(t),this.queue.shift(),await this.storage.delete(e.id),this.emit("process_fail",{id:e.id,error:t}),this.emit("queue_update",this.queue))}}finally{this.isProcessing=!1,this.queue.length>0&&this.process()}}}async resolveDependencies(e,s){for(let t of this.queue){if(t.status!=="PENDING")continue;let i=!1;if(t.url.includes(e)&&(t.url=t.url.replace(e,s),i=!0),t.body){let r=JSON.stringify(t.body);if(r.includes(e)){let o=r.replaceAll(e,s);t.body=JSON.parse(o),i=!0}}i&&await this.storage.save(t)}}async performRequest(e){let s={...e.headers},t;e.body instanceof FormData||e.body instanceof Blob||e.body instanceof File?t=e.body:e.body&&(t=JSON.stringify(e.body),s["Content-Type"]||(s["Content-Type"]="application/json"));let i=await fetch(e.url,{method:e.method,body:t,headers:s});if(!i.ok)throw new Error(`HTTP Error ${i.status}`);let r=await i.text();try{return r?JSON.parse(r):{}}catch{return{}}}async getQueue(){return await this.readyPromise,[...this.queue]}};export{c as RequestQueue};

package/package.json

@@ -0,0 +1,90 @@
+{
+  "name": "sync-later",
+  "version": "1.0.0",
+  "description": "Zero-dependency, offline-first mutation engine for REST APIs. Features reliable persistence, dependency chaining, automatic retries with backoff, and file upload support.",
+  "keywords": [
+    "rest-api",
+    "offline-first",
+    "queue",
+    "request-queue",
+    "mutation-queue",
+    "fetch",
+    "retry",
+    "backoff",
+    "persistence",
+    "indexeddb",
+    "network-resilience",
+    "typescript",
+    "zero-dependency",
+    "file-upload",
+    "resilience"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts --minify --clean",
+    "test": "vitest --environment happy-dom",
+    "lint": "eslint ."
+  },
+  "author": "denisetiya",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/denisetiya/sync-later.git"
+  },
+  "homepage": "https://github.com/denisetiya/sync-later#readme",
+  "bugs": {
+    "url": "https://github.com/denisetiya/sync-later/issues"
+  },
+  "license": "ISC",
+  "release": {
+    "branches": [
+      "main"
+    ],
+    "plugins": [
+      "@semantic-release/commit-analyzer",
+      "@semantic-release/release-notes-generator",
+      "@semantic-release/changelog",
+      "@semantic-release/npm",
+      [
+        "@semantic-release/git",
+        {
+          "assets": [
+            "package.json",
+            "CHANGELOG.md"
+          ],
+          "message": "chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}"
+        }
+      ],
+      "@semantic-release/github"
+    ]
+  },
+  "packageManager": "pnpm@10.27.0",
+  "devDependencies": {
+    "@eslint/js": "^9.39.2",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^12.0.2",
+    "@semantic-release/npm": "^13.1.3",
+    "@types/node": "^25.0.3",
+    "conventional-changelog-conventionalcommits": "^9.1.0",
+    "eslint": "^9.39.2",
+    "globals": "^17.0.0",
+    "happy-dom": "^20.0.11",
+    "semantic-release": "^25.0.2",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.51.0",
+    "vitest": "^4.0.16"
+  }
+}