@tanstack/offline-transactions 0.0.0

package/dist/cjs/outbox/TransactionSerializer.cjs

@@ -0,0 +1,135 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+class TransactionSerializer {
+  constructor(collections) {
+    this.collections = collections;
+    this.collectionIdToKey = /* @__PURE__ */ new Map();
+    for (const [key, collection] of Object.entries(collections)) {
+      this.collectionIdToKey.set(collection.id, key);
+    }
+  }
+  serialize(transaction) {
+    const serialized = {
+      ...transaction,
+      createdAt: transaction.createdAt,
+      mutations: transaction.mutations.map(
+        (mutation) => this.serializeMutation(mutation)
+      )
+    };
+    return JSON.stringify(serialized, (key, value) => {
+      if (value instanceof Date) {
+        return value.toISOString();
+      }
+      return value;
+    });
+  }
+  deserialize(data) {
+    const parsed = JSON.parse(
+      data,
+      (key, value) => {
+        if (typeof value === `string` && /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}/.test(value)) {
+          return new Date(value);
+        }
+        return value;
+      }
+    );
+    return {
+      ...parsed,
+      mutations: parsed.mutations.map(
+        (mutationData) => this.deserializeMutation(mutationData)
+      )
+    };
+  }
+  serializeMutation(mutation) {
+    const registryKey = this.collectionIdToKey.get(mutation.collection.id);
+    if (!registryKey) {
+      throw new Error(
+        `Collection with id ${mutation.collection.id} not found in registry`
+      );
+    }
+    return {
+      globalKey: mutation.globalKey,
+      type: mutation.type,
+      modified: this.serializeValue(mutation.modified),
+      original: this.serializeValue(mutation.original),
+      collectionId: registryKey
+      // Store registry key instead of collection.id
+    };
+  }
+  deserializeMutation(data) {
+    const collection = this.collections[data.collectionId];
+    if (!collection) {
+      throw new Error(`Collection with id ${data.collectionId} not found`);
+    }
+    return {
+      globalKey: data.globalKey,
+      type: data.type,
+      modified: this.deserializeValue(data.modified),
+      original: this.deserializeValue(data.original),
+      collection,
+      // These fields would need to be reconstructed by the executor
+      mutationId: ``,
+      // Will be regenerated
+      key: null,
+      // Will be extracted from the data
+      changes: {},
+      // Will be recalculated
+      metadata: void 0,
+      syncMetadata: {},
+      optimistic: true,
+      createdAt: /* @__PURE__ */ new Date(),
+      updatedAt: /* @__PURE__ */ new Date()
+    };
+  }
+  serializeValue(value) {
+    if (value === null || value === void 0) {
+      return value;
+    }
+    if (value instanceof Date) {
+      return { __type: `Date`, value: value.toISOString() };
+    }
+    if (typeof value === `object`) {
+      const result = Array.isArray(value) ? [] : {};
+      for (const key in value) {
+        if (value.hasOwnProperty(key)) {
+          result[key] = this.serializeValue(value[key]);
+        }
+      }
+      return result;
+    }
+    return value;
+  }
+  deserializeValue(value) {
+    if (value === null || value === void 0) {
+      return value;
+    }
+    if (typeof value === `object` && value.__type === `Date`) {
+      return new Date(value.value);
+    }
+    if (typeof value === `object`) {
+      const result = Array.isArray(value) ? [] : {};
+      for (const key in value) {
+        if (value.hasOwnProperty(key)) {
+          result[key] = this.deserializeValue(value[key]);
+        }
+      }
+      return result;
+    }
+    return value;
+  }
+  serializeError(error) {
+    return {
+      name: error.name,
+      message: error.message,
+      stack: error.stack
+    };
+  }
+  deserializeError(data) {
+    const error = new Error(data.message);
+    error.name = data.name;
+    error.stack = data.stack;
+    return error;
+  }
+}
+exports.TransactionSerializer = TransactionSerializer;
+//# sourceMappingURL=TransactionSerializer.cjs.map

package/dist/cjs/outbox/TransactionSerializer.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransactionSerializer.cjs","sources":["../../../src/outbox/TransactionSerializer.ts"],"sourcesContent":["import type {\n  OfflineTransaction,\n  SerializedError,\n  SerializedMutation,\n  SerializedOfflineTransaction,\n} from \"../types\"\nimport type { Collection, PendingMutation } from \"@tanstack/db\"\n\nexport class TransactionSerializer {\n  private collections: Record<string, Collection>\n  private collectionIdToKey: Map<string, string>\n\n  constructor(collections: Record<string, Collection>) {\n    this.collections = collections\n    // Create reverse lookup from collection.id to registry key\n    this.collectionIdToKey = new Map()\n    for (const [key, collection] of Object.entries(collections)) {\n      this.collectionIdToKey.set(collection.id, key)\n    }\n  }\n\n  serialize(transaction: OfflineTransaction): string {\n    const serialized: SerializedOfflineTransaction = {\n      ...transaction,\n      createdAt: transaction.createdAt,\n      mutations: transaction.mutations.map((mutation) =>\n        this.serializeMutation(mutation)\n      ),\n    }\n    // Convert the whole object to JSON, handling dates\n    return JSON.stringify(serialized, (key, value) => {\n      if (value instanceof Date) {\n        return value.toISOString()\n      }\n      return value\n    })\n  }\n\n  deserialize(data: string): OfflineTransaction {\n    const parsed: SerializedOfflineTransaction = JSON.parse(\n      data,\n      (key, value) => {\n        // Parse ISO date strings back to Date objects\n        if (\n          typeof value === `string` &&\n          /^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}/.test(value)\n        ) {\n          return new Date(value)\n        }\n        return value\n      }\n    )\n\n    return {\n      ...parsed,\n      mutations: parsed.mutations.map((mutationData) =>\n        this.deserializeMutation(mutationData)\n      ),\n    }\n  }\n\n  private serializeMutation(mutation: PendingMutation): SerializedMutation {\n    const registryKey = this.collectionIdToKey.get(mutation.collection.id)\n    if (!registryKey) {\n      throw new Error(\n        `Collection with id ${mutation.collection.id} not found in registry`\n      )\n    }\n\n    return {\n      globalKey: mutation.globalKey,\n      type: mutation.type,\n      modified: this.serializeValue(mutation.modified),\n      original: this.serializeValue(mutation.original),\n      collectionId: registryKey, // Store registry key instead of collection.id\n    }\n  }\n\n  private deserializeMutation(data: SerializedMutation): PendingMutation {\n    const collection = this.collections[data.collectionId]\n    if (!collection) {\n      throw new Error(`Collection with id ${data.collectionId} not found`)\n    }\n\n    // Create a partial PendingMutation - we can't fully reconstruct it but\n    // we provide what we can. The executor will need to handle the rest.\n    return {\n      globalKey: data.globalKey,\n      type: data.type as any,\n      modified: this.deserializeValue(data.modified),\n      original: this.deserializeValue(data.original),\n      collection,\n      // These fields would need to be reconstructed by the executor\n      mutationId: ``, // Will be regenerated\n      key: null, // Will be extracted from the data\n      changes: {}, // Will be recalculated\n      metadata: undefined,\n      syncMetadata: {},\n      optimistic: true,\n      createdAt: new Date(),\n      updatedAt: new Date(),\n    } as PendingMutation\n  }\n\n  private serializeValue(value: any): any {\n    if (value === null || value === undefined) {\n      return value\n    }\n\n    if (value instanceof Date) {\n      return { __type: `Date`, value: value.toISOString() }\n    }\n\n    if (typeof value === `object`) {\n      const result: any = Array.isArray(value) ? [] : {}\n      for (const key in value) {\n        if (value.hasOwnProperty(key)) {\n          result[key] = this.serializeValue(value[key])\n        }\n      }\n      return result\n    }\n\n    return value\n  }\n\n  private deserializeValue(value: any): any {\n    if (value === null || value === undefined) {\n      return value\n    }\n\n    if (typeof value === `object` && value.__type === `Date`) {\n      return new Date(value.value)\n    }\n\n    if (typeof value === `object`) {\n      const result: any = Array.isArray(value) ? [] : {}\n      for (const key in value) {\n        if (value.hasOwnProperty(key)) {\n          result[key] = this.deserializeValue(value[key])\n        }\n      }\n      return result\n    }\n\n    return value\n  }\n\n  serializeError(error: Error): SerializedError {\n    return {\n      name: error.name,\n      message: error.message,\n      stack: error.stack,\n    }\n  }\n\n  deserializeError(data: SerializedError): Error {\n    const error = new Error(data.message)\n    error.name = data.name\n    error.stack = data.stack\n    return error\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/cjs/outbox/TransactionSerializer.d.cts

@@ -0,0 +1,15 @@
+import { OfflineTransaction, SerializedError } from '../types.cjs';
+import { Collection } from '@tanstack/db';
+export declare class TransactionSerializer {
+    private collections;
+    private collectionIdToKey;
+    constructor(collections: Record<string, Collection>);
+    serialize(transaction: OfflineTransaction): string;
+    deserialize(data: string): OfflineTransaction;
+    private serializeMutation;
+    private deserializeMutation;
+    private serializeValue;
+    private deserializeValue;
+    serializeError(error: Error): SerializedError;
+    deserializeError(data: SerializedError): Error;
+}

package/dist/cjs/retry/BackoffCalculator.cjs

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+class BackoffCalculator {
+  constructor(jitter = true) {
+    this.jitter = jitter;
+  }
+  calculate(retryCount) {
+    const baseDelay = Math.min(1e3 * Math.pow(2, retryCount), 6e4);
+    const jitterMultiplier = this.jitter ? Math.random() * 0.3 : 0;
+    return Math.floor(baseDelay * (1 + jitterMultiplier));
+  }
+}
+exports.BackoffCalculator = BackoffCalculator;
+//# sourceMappingURL=BackoffCalculator.cjs.map

package/dist/cjs/retry/BackoffCalculator.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"BackoffCalculator.cjs","sources":["../../../src/retry/BackoffCalculator.ts"],"sourcesContent":["export class BackoffCalculator {\n  private jitter: boolean\n\n  constructor(jitter = true) {\n    this.jitter = jitter\n  }\n\n  calculate(retryCount: number): number {\n    const baseDelay = Math.min(1000 * Math.pow(2, retryCount), 60000)\n    const jitterMultiplier = this.jitter ? Math.random() * 0.3 : 0\n    return Math.floor(baseDelay * (1 + jitterMultiplier))\n  }\n}\n"],"names":[],"mappings":";;AAAO,MAAM,kBAAkB;AAAA,EAG7B,YAAY,SAAS,MAAM;AACzB,SAAK,SAAS;AAAA,EAChB;AAAA,EAEA,UAAU,YAA4B;AACpC,UAAM,YAAY,KAAK,IAAI,MAAO,KAAK,IAAI,GAAG,UAAU,GAAG,GAAK;AAChE,UAAM,mBAAmB,KAAK,SAAS,KAAK,OAAA,IAAW,MAAM;AAC7D,WAAO,KAAK,MAAM,aAAa,IAAI,iBAAiB;AAAA,EACtD;AACF;;"}

package/dist/cjs/retry/BackoffCalculator.d.cts

@@ -0,0 +1,5 @@
+export declare class BackoffCalculator {
+    private jitter;
+    constructor(jitter?: boolean);
+    calculate(retryCount: number): number;
+}

package/dist/cjs/retry/NonRetriableError.d.cts

@@ -0,0 +1 @@
+export { NonRetriableError } from '../types.cjs';

package/dist/cjs/retry/RetryPolicy.cjs

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const types = require("../types.cjs");
+const BackoffCalculator = require("./BackoffCalculator.cjs");
+class DefaultRetryPolicy {
+  constructor(maxRetries = 10, jitter = true) {
+    this.backoffCalculator = new BackoffCalculator.BackoffCalculator(jitter);
+    this.maxRetries = maxRetries;
+  }
+  calculateDelay(retryCount) {
+    return this.backoffCalculator.calculate(retryCount);
+  }
+  shouldRetry(error, retryCount) {
+    if (retryCount >= this.maxRetries) {
+      return false;
+    }
+    if (error instanceof types.NonRetriableError) {
+      return false;
+    }
+    if (error.name === `AbortError`) {
+      return false;
+    }
+    if (error.message.includes(`401`) || error.message.includes(`403`)) {
+      return false;
+    }
+    if (error.message.includes(`422`) || error.message.includes(`400`)) {
+      return false;
+    }
+    return true;
+  }
+}
+exports.DefaultRetryPolicy = DefaultRetryPolicy;
+//# sourceMappingURL=RetryPolicy.cjs.map

package/dist/cjs/retry/RetryPolicy.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"RetryPolicy.cjs","sources":["../../../src/retry/RetryPolicy.ts"],"sourcesContent":["import { NonRetriableError } from \"../types\"\nimport { BackoffCalculator } from \"./BackoffCalculator\"\nimport type { RetryPolicy } from \"../types\"\n\nexport class DefaultRetryPolicy implements RetryPolicy {\n  private backoffCalculator: BackoffCalculator\n  private maxRetries: number\n\n  constructor(maxRetries = 10, jitter = true) {\n    this.backoffCalculator = new BackoffCalculator(jitter)\n    this.maxRetries = maxRetries\n  }\n\n  calculateDelay(retryCount: number): number {\n    return this.backoffCalculator.calculate(retryCount)\n  }\n\n  shouldRetry(error: Error, retryCount: number): boolean {\n    if (retryCount >= this.maxRetries) {\n      return false\n    }\n\n    if (error instanceof NonRetriableError) {\n      return false\n    }\n\n    if (error.name === `AbortError`) {\n      return false\n    }\n\n    if (error.message.includes(`401`) || error.message.includes(`403`)) {\n      return false\n    }\n\n    if (error.message.includes(`422`) || error.message.includes(`400`)) {\n      return false\n    }\n\n    return true\n  }\n}\n"],"names":["BackoffCalculator","NonRetriableError"],"mappings":";;;;AAIO,MAAM,mBAA0C;AAAA,EAIrD,YAAY,aAAa,IAAI,SAAS,MAAM;AAC1C,SAAK,oBAAoB,IAAIA,kBAAAA,kBAAkB,MAAM;AACrD,SAAK,aAAa;AAAA,EACpB;AAAA,EAEA,eAAe,YAA4B;AACzC,WAAO,KAAK,kBAAkB,UAAU,UAAU;AAAA,EACpD;AAAA,EAEA,YAAY,OAAc,YAA6B;AACrD,QAAI,cAAc,KAAK,YAAY;AACjC,aAAO;AAAA,IACT;AAEA,QAAI,iBAAiBC,MAAAA,mBAAmB;AACtC,aAAO;AAAA,IACT;AAEA,QAAI,MAAM,SAAS,cAAc;AAC/B,aAAO;AAAA,IACT;AAEA,QAAI,MAAM,QAAQ,SAAS,KAAK,KAAK,MAAM,QAAQ,SAAS,KAAK,GAAG;AAClE,aAAO;AAAA,IACT;AAEA,QAAI,MAAM,QAAQ,SAAS,KAAK,KAAK,MAAM,QAAQ,SAAS,KAAK,GAAG;AAClE,aAAO;AAAA,IACT;AAEA,WAAO;AAAA,EACT;AACF;;"}

package/dist/cjs/retry/RetryPolicy.d.cts

@@ -0,0 +1,8 @@
+import { RetryPolicy } from '../types.cjs';
+export declare class DefaultRetryPolicy implements RetryPolicy {
+    private backoffCalculator;
+    private maxRetries;
+    constructor(maxRetries?: number, jitter?: boolean);
+    calculateDelay(retryCount: number): number;
+    shouldRetry(error: Error, retryCount: number): boolean;
+}

package/dist/cjs/storage/IndexedDBAdapter.cjs

@@ -0,0 +1,104 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const StorageAdapter = require("./StorageAdapter.cjs");
+class IndexedDBAdapter extends StorageAdapter.BaseStorageAdapter {
+  constructor(dbName = `offline-transactions`, storeName = `transactions`) {
+    super();
+    this.db = null;
+    this.dbName = dbName;
+    this.storeName = storeName;
+  }
+  async openDB() {
+    if (this.db) {
+      return this.db;
+    }
+    return new Promise((resolve, reject) => {
+      const request = indexedDB.open(this.dbName, 1);
+      request.onerror = () => reject(request.error);
+      request.onsuccess = () => {
+        this.db = request.result;
+        resolve(this.db);
+      };
+      request.onupgradeneeded = (event) => {
+        const db = event.target.result;
+        if (!db.objectStoreNames.contains(this.storeName)) {
+          db.createObjectStore(this.storeName);
+        }
+      };
+    });
+  }
+  async getStore(mode = `readonly`) {
+    const db = await this.openDB();
+    const transaction = db.transaction([this.storeName], mode);
+    return transaction.objectStore(this.storeName);
+  }
+  async get(key) {
+    try {
+      const store = await this.getStore(`readonly`);
+      return new Promise((resolve, reject) => {
+        const request = store.get(key);
+        request.onerror = () => reject(request.error);
+        request.onsuccess = () => resolve(request.result ?? null);
+      });
+    } catch (error) {
+      console.warn(`IndexedDB get failed:`, error);
+      return null;
+    }
+  }
+  async set(key, value) {
+    try {
+      const store = await this.getStore(`readwrite`);
+      return new Promise((resolve, reject) => {
+        const request = store.put(value, key);
+        request.onerror = () => reject(request.error);
+        request.onsuccess = () => resolve();
+      });
+    } catch (error) {
+      if (error instanceof DOMException && error.name === `QuotaExceededError`) {
+        throw new Error(
+          `Storage quota exceeded. Consider clearing old transactions.`
+        );
+      }
+      throw error;
+    }
+  }
+  async delete(key) {
+    try {
+      const store = await this.getStore(`readwrite`);
+      return new Promise((resolve, reject) => {
+        const request = store.delete(key);
+        request.onerror = () => reject(request.error);
+        request.onsuccess = () => resolve();
+      });
+    } catch (error) {
+      console.warn(`IndexedDB delete failed:`, error);
+    }
+  }
+  async keys() {
+    try {
+      const store = await this.getStore(`readonly`);
+      return new Promise((resolve, reject) => {
+        const request = store.getAllKeys();
+        request.onerror = () => reject(request.error);
+        request.onsuccess = () => resolve(request.result);
+      });
+    } catch (error) {
+      console.warn(`IndexedDB keys failed:`, error);
+      return [];
+    }
+  }
+  async clear() {
+    try {
+      const store = await this.getStore(`readwrite`);
+      return new Promise((resolve, reject) => {
+        const request = store.clear();
+        request.onerror = () => reject(request.error);
+        request.onsuccess = () => resolve();
+      });
+    } catch (error) {
+      console.warn(`IndexedDB clear failed:`, error);
+    }
+  }
+}
+exports.IndexedDBAdapter = IndexedDBAdapter;
+//# sourceMappingURL=IndexedDBAdapter.cjs.map

package/dist/cjs/storage/IndexedDBAdapter.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"IndexedDBAdapter.cjs","sources":["../../../src/storage/IndexedDBAdapter.ts"],"sourcesContent":["import { BaseStorageAdapter } from \"./StorageAdapter\"\n\nexport class IndexedDBAdapter extends BaseStorageAdapter {\n  private dbName: string\n  private storeName: string\n  private db: IDBDatabase | null = null\n\n  constructor(dbName = `offline-transactions`, storeName = `transactions`) {\n    super()\n    this.dbName = dbName\n    this.storeName = storeName\n  }\n\n  private async openDB(): Promise<IDBDatabase> {\n    if (this.db) {\n      return this.db\n    }\n\n    return new Promise((resolve, reject) => {\n      const request = indexedDB.open(this.dbName, 1)\n\n      request.onerror = () => reject(request.error)\n      request.onsuccess = () => {\n        this.db = request.result\n        resolve(this.db)\n      }\n\n      request.onupgradeneeded = (event) => {\n        const db = (event.target as IDBOpenDBRequest).result\n        if (!db.objectStoreNames.contains(this.storeName)) {\n          db.createObjectStore(this.storeName)\n        }\n      }\n    })\n  }\n\n  private async getStore(\n    mode: IDBTransactionMode = `readonly`\n  ): Promise<IDBObjectStore> {\n    const db = await this.openDB()\n    const transaction = db.transaction([this.storeName], mode)\n    return transaction.objectStore(this.storeName)\n  }\n\n  async get(key: string): Promise<string | null> {\n    try {\n      const store = await this.getStore(`readonly`)\n      return new Promise((resolve, reject) => {\n        const request = store.get(key)\n        request.onerror = () => reject(request.error)\n        request.onsuccess = () => resolve(request.result ?? null)\n      })\n    } catch (error) {\n      console.warn(`IndexedDB get failed:`, error)\n      return null\n    }\n  }\n\n  async set(key: string, value: string): Promise<void> {\n    try {\n      const store = await this.getStore(`readwrite`)\n      return new Promise((resolve, reject) => {\n        const request = store.put(value, key)\n        request.onerror = () => reject(request.error)\n        request.onsuccess = () => resolve()\n      })\n    } catch (error) {\n      if (\n        error instanceof DOMException &&\n        error.name === `QuotaExceededError`\n      ) {\n        throw new Error(\n          `Storage quota exceeded. Consider clearing old transactions.`\n        )\n      }\n      throw error\n    }\n  }\n\n  async delete(key: string): Promise<void> {\n    try {\n      const store = await this.getStore(`readwrite`)\n      return new Promise((resolve, reject) => {\n        const request = store.delete(key)\n        request.onerror = () => reject(request.error)\n        request.onsuccess = () => resolve()\n      })\n    } catch (error) {\n      console.warn(`IndexedDB delete failed:`, error)\n    }\n  }\n\n  async keys(): Promise<Array<string>> {\n    try {\n      const store = await this.getStore(`readonly`)\n      return new Promise((resolve, reject) => {\n        const request = store.getAllKeys()\n        request.onerror = () => reject(request.error)\n        request.onsuccess = () => resolve(request.result as Array<string>)\n      })\n    } catch (error) {\n      console.warn(`IndexedDB keys failed:`, error)\n      return []\n    }\n  }\n\n  async clear(): Promise<void> {\n    try {\n      const store = await this.getStore(`readwrite`)\n      return new Promise((resolve, reject) => {\n        const request = store.clear()\n        request.onerror = () => reject(request.error)\n        request.onsuccess = () => resolve()\n      })\n    } catch (error) {\n      console.warn(`IndexedDB clear failed:`, error)\n    }\n  }\n}\n"],"names":["BaseStorageAdapter"],"mappings":"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"}

package/dist/cjs/storage/IndexedDBAdapter.d.cts

@@ -0,0 +1,14 @@
+import { BaseStorageAdapter } from './StorageAdapter.cjs';
+export declare class IndexedDBAdapter extends BaseStorageAdapter {
+    private dbName;
+    private storeName;
+    private db;
+    constructor(dbName?: string, storeName?: string);
+    private openDB;
+    private getStore;
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string): Promise<void>;
+    delete(key: string): Promise<void>;
+    keys(): Promise<Array<string>>;
+    clear(): Promise<void>;
+}

package/dist/cjs/storage/LocalStorageAdapter.cjs

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const StorageAdapter = require("./StorageAdapter.cjs");
+class LocalStorageAdapter extends StorageAdapter.BaseStorageAdapter {
+  constructor(prefix = `offline-tx:`) {
+    super();
+    this.prefix = prefix;
+  }
+  getKey(key) {
+    return `${this.prefix}${key}`;
+  }
+  get(key) {
+    try {
+      return Promise.resolve(localStorage.getItem(this.getKey(key)));
+    } catch (error) {
+      console.warn(`localStorage get failed:`, error);
+      return Promise.resolve(null);
+    }
+  }
+  set(key, value) {
+    try {
+      localStorage.setItem(this.getKey(key), value);
+      return Promise.resolve();
+    } catch (error) {
+      if (error instanceof DOMException && error.name === `QuotaExceededError`) {
+        return Promise.reject(
+          new Error(
+            `Storage quota exceeded. Consider clearing old transactions.`
+          )
+        );
+      }
+      return Promise.reject(error);
+    }
+  }
+  delete(key) {
+    try {
+      localStorage.removeItem(this.getKey(key));
+      return Promise.resolve();
+    } catch (error) {
+      console.warn(`localStorage delete failed:`, error);
+      return Promise.resolve();
+    }
+  }
+  keys() {
+    try {
+      const keys = [];
+      for (let i = 0; i < localStorage.length; i++) {
+        const key = localStorage.key(i);
+        if (key && key.startsWith(this.prefix)) {
+          keys.push(key.slice(this.prefix.length));
+        }
+      }
+      return Promise.resolve(keys);
+    } catch (error) {
+      console.warn(`localStorage keys failed:`, error);
+      return Promise.resolve([]);
+    }
+  }
+  async clear() {
+    try {
+      const keys = await this.keys();
+      for (const key of keys) {
+        localStorage.removeItem(this.getKey(key));
+      }
+    } catch (error) {
+      console.warn(`localStorage clear failed:`, error);
+    }
+  }
+}
+exports.LocalStorageAdapter = LocalStorageAdapter;
+//# sourceMappingURL=LocalStorageAdapter.cjs.map

package/dist/cjs/storage/LocalStorageAdapter.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalStorageAdapter.cjs","sources":["../../../src/storage/LocalStorageAdapter.ts"],"sourcesContent":["import { BaseStorageAdapter } from \"./StorageAdapter\"\n\nexport class LocalStorageAdapter extends BaseStorageAdapter {\n  private prefix: string\n\n  constructor(prefix = `offline-tx:`) {\n    super()\n    this.prefix = prefix\n  }\n\n  private getKey(key: string): string {\n    return `${this.prefix}${key}`\n  }\n\n  get(key: string): Promise<string | null> {\n    try {\n      return Promise.resolve(localStorage.getItem(this.getKey(key)))\n    } catch (error) {\n      console.warn(`localStorage get failed:`, error)\n      return Promise.resolve(null)\n    }\n  }\n\n  set(key: string, value: string): Promise<void> {\n    try {\n      localStorage.setItem(this.getKey(key), value)\n      return Promise.resolve()\n    } catch (error) {\n      if (\n        error instanceof DOMException &&\n        error.name === `QuotaExceededError`\n      ) {\n        return Promise.reject(\n          new Error(\n            `Storage quota exceeded. Consider clearing old transactions.`\n          )\n        )\n      }\n      return Promise.reject(error)\n    }\n  }\n\n  delete(key: string): Promise<void> {\n    try {\n      localStorage.removeItem(this.getKey(key))\n      return Promise.resolve()\n    } catch (error) {\n      console.warn(`localStorage delete failed:`, error)\n      return Promise.resolve()\n    }\n  }\n\n  keys(): Promise<Array<string>> {\n    try {\n      const keys: Array<string> = []\n      for (let i = 0; i < localStorage.length; i++) {\n        const key = localStorage.key(i)\n        if (key && key.startsWith(this.prefix)) {\n          keys.push(key.slice(this.prefix.length))\n        }\n      }\n      return Promise.resolve(keys)\n    } catch (error) {\n      console.warn(`localStorage keys failed:`, error)\n      return Promise.resolve([])\n    }\n  }\n\n  async clear(): Promise<void> {\n    try {\n      const keys = await this.keys()\n      for (const key of keys) {\n        localStorage.removeItem(this.getKey(key))\n      }\n    } catch (error) {\n      console.warn(`localStorage clear failed:`, error)\n    }\n  }\n}\n"],"names":["BaseStorageAdapter"],"mappings":";;;AAEO,MAAM,4BAA4BA,eAAAA,mBAAmB;AAAA,EAG1D,YAAY,SAAS,eAAe;AAClC,UAAA;AACA,SAAK,SAAS;AAAA,EAChB;AAAA,EAEQ,OAAO,KAAqB;AAClC,WAAO,GAAG,KAAK,MAAM,GAAG,GAAG;AAAA,EAC7B;AAAA,EAEA,IAAI,KAAqC;AACvC,QAAI;AACF,aAAO,QAAQ,QAAQ,aAAa,QAAQ,KAAK,OAAO,GAAG,CAAC,CAAC;AAAA,IAC/D,SAAS,OAAO;AACd,cAAQ,KAAK,4BAA4B,KAAK;AAC9C,aAAO,QAAQ,QAAQ,IAAI;AAAA,IAC7B;AAAA,EACF;AAAA,EAEA,IAAI,KAAa,OAA8B;AAC7C,QAAI;AACF,mBAAa,QAAQ,KAAK,OAAO,GAAG,GAAG,KAAK;AAC5C,aAAO,QAAQ,QAAA;AAAA,IACjB,SAAS,OAAO;AACd,UACE,iBAAiB,gBACjB,MAAM,SAAS,sBACf;AACA,eAAO,QAAQ;AAAA,UACb,IAAI;AAAA,YACF;AAAA,UAAA;AAAA,QACF;AAAA,MAEJ;AACA,aAAO,QAAQ,OAAO,KAAK;AAAA,IAC7B;AAAA,EACF;AAAA,EAEA,OAAO,KAA4B;AACjC,QAAI;AACF,mBAAa,WAAW,KAAK,OAAO,GAAG,CAAC;AACxC,aAAO,QAAQ,QAAA;AAAA,IACjB,SAAS,OAAO;AACd,cAAQ,KAAK,+BAA+B,KAAK;AACjD,aAAO,QAAQ,QAAA;AAAA,IACjB;AAAA,EACF;AAAA,EAEA,OAA+B;AAC7B,QAAI;AACF,YAAM,OAAsB,CAAA;AAC5B,eAAS,IAAI,GAAG,IAAI,aAAa,QAAQ,KAAK;AAC5C,cAAM,MAAM,aAAa,IAAI,CAAC;AAC9B,YAAI,OAAO,IAAI,WAAW,KAAK,MAAM,GAAG;AACtC,eAAK,KAAK,IAAI,MAAM,KAAK,OAAO,MAAM,CAAC;AAAA,QACzC;AAAA,MACF;AACA,aAAO,QAAQ,QAAQ,IAAI;AAAA,IAC7B,SAAS,OAAO;AACd,cAAQ,KAAK,6BAA6B,KAAK;AAC/C,aAAO,QAAQ,QAAQ,EAAE;AAAA,IAC3B;AAAA,EACF;AAAA,EAEA,MAAM,QAAuB;AAC3B,QAAI;AACF,YAAM,OAAO,MAAM,KAAK,KAAA;AACxB,iBAAW,OAAO,MAAM;AACtB,qBAAa,WAAW,KAAK,OAAO,GAAG,CAAC;AAAA,MAC1C;AAAA,IACF,SAAS,OAAO;AACd,cAAQ,KAAK,8BAA8B,KAAK;AAAA,IAClD;AAAA,EACF;AACF;;"}

package/dist/cjs/storage/LocalStorageAdapter.d.cts

@@ -0,0 +1,11 @@
+import { BaseStorageAdapter } from './StorageAdapter.cjs';
+export declare class LocalStorageAdapter extends BaseStorageAdapter {
+    private prefix;
+    constructor(prefix?: string);
+    private getKey;
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string): Promise<void>;
+    delete(key: string): Promise<void>;
+    keys(): Promise<Array<string>>;
+    clear(): Promise<void>;
+}

package/dist/cjs/storage/StorageAdapter.cjs

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+class BaseStorageAdapter {
+}
+exports.BaseStorageAdapter = BaseStorageAdapter;
+//# sourceMappingURL=StorageAdapter.cjs.map

package/dist/cjs/storage/StorageAdapter.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorageAdapter.cjs","sources":["../../../src/storage/StorageAdapter.ts"],"sourcesContent":["import type { StorageAdapter } from \"../types\"\n\nexport abstract class BaseStorageAdapter implements StorageAdapter {\n  abstract get(key: string): Promise<string | null>\n  abstract set(key: string, value: string): Promise<void>\n  abstract delete(key: string): Promise<void>\n  abstract keys(): Promise<Array<string>>\n  abstract clear(): Promise<void>\n}\n\nexport { type StorageAdapter }\n"],"names":[],"mappings":";;AAEO,MAAe,mBAA6C;AAMnE;;"}

package/dist/cjs/storage/StorageAdapter.d.cts

@@ -0,0 +1,9 @@
+import { StorageAdapter } from '../types.cjs';
+export declare abstract class BaseStorageAdapter implements StorageAdapter {
+    abstract get(key: string): Promise<string | null>;
+    abstract set(key: string, value: string): Promise<void>;
+    abstract delete(key: string): Promise<void>;
+    abstract keys(): Promise<Array<string>>;
+    abstract clear(): Promise<void>;
+}
+export { type StorageAdapter };

package/dist/cjs/telemetry/tracer.cjs

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const api = require("@opentelemetry/api");
+const TRACER = api.trace.getTracer("@tanstack/offline-transactions", "0.0.1");
+function getParentContext(options) {
+  if (options?.parentContext) {
+    const parentSpan = api.trace.wrapSpanContext(options.parentContext);
+    return api.trace.setSpan(api.context.active(), parentSpan);
+  }
+  return api.context.active();
+}
+async function withSpan(name, attrs, fn, options) {
+  const parentCtx = getParentContext(options);
+  const span = TRACER.startSpan(name, void 0, parentCtx);
+  const filteredAttrs = {};
+  for (const [key, value] of Object.entries(attrs)) {
+    if (value !== void 0) {
+      filteredAttrs[key] = value;
+    }
+  }
+  span.setAttributes(filteredAttrs);
+  try {
+    const result = await fn(span);
+    span.setStatus({ code: api.SpanStatusCode.OK });
+    return result;
+  } catch (error) {
+    span.setStatus({
+      code: api.SpanStatusCode.ERROR,
+      message: error instanceof Error ? error.message : String(error)
+    });
+    span.recordException(error);
+    throw error;
+  } finally {
+    span.end();
+  }
+}
+async function withNestedSpan(name, attrs, fn, options) {
+  const parentCtx = getParentContext(options);
+  const span = TRACER.startSpan(name, void 0, parentCtx);
+  const filteredAttrs = {};
+  for (const [key, value] of Object.entries(attrs)) {
+    if (value !== void 0) {
+      filteredAttrs[key] = value;
+    }
+  }
+  span.setAttributes(filteredAttrs);
+  const ctx = api.trace.setSpan(parentCtx, span);
+  try {
+    const result = await api.context.with(ctx, () => fn(span));
+    span.setStatus({ code: api.SpanStatusCode.OK });
+    return result;
+  } catch (error) {
+    span.setStatus({
+      code: api.SpanStatusCode.ERROR,
+      message: error instanceof Error ? error.message : String(error)
+    });
+    span.recordException(error);
+    throw error;
+  } finally {
+    span.end();
+  }
+}
+function withSyncSpan(name, attrs, fn, options) {
+  const parentCtx = getParentContext(options);
+  const span = TRACER.startSpan(name, void 0, parentCtx);
+  const filteredAttrs = {};
+  for (const [key, value] of Object.entries(attrs)) {
+    if (value !== void 0) {
+      filteredAttrs[key] = value;
+    }
+  }
+  span.setAttributes(filteredAttrs);
+  try {
+    const result = fn(span);
+    span.setStatus({ code: api.SpanStatusCode.OK });
+    return result;
+  } catch (error) {
+    span.setStatus({
+      code: api.SpanStatusCode.ERROR,
+      message: error instanceof Error ? error.message : String(error)
+    });
+    span.recordException(error);
+    throw error;
+  } finally {
+    span.end();
+  }
+}
+exports.withNestedSpan = withNestedSpan;
+exports.withSpan = withSpan;
+exports.withSyncSpan = withSyncSpan;
+//# sourceMappingURL=tracer.cjs.map

package/dist/cjs/telemetry/tracer.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracer.cjs","sources":["../../../src/telemetry/tracer.ts"],"sourcesContent":["import {\n  trace,\n  type Span,\n  SpanStatusCode,\n  context,\n  type SpanContext,\n} from \"@opentelemetry/api\"\n\nconst TRACER = trace.getTracer(\"@tanstack/offline-transactions\", \"0.0.1\")\n\nexport interface SpanAttrs {\n  [key: string]: string | number | boolean | undefined\n}\n\ninterface WithSpanOptions {\n  parentContext?: SpanContext\n}\n\nfunction getParentContext(options?: WithSpanOptions) {\n  if (options?.parentContext) {\n    const parentSpan = trace.wrapSpanContext(options.parentContext)\n    return trace.setSpan(context.active(), parentSpan)\n  }\n\n  return context.active()\n}\n\n/**\n * Lightweight span wrapper with error handling.\n * Uses OpenTelemetry API which is no-op when tracing is disabled.\n *\n * By default, creates spans at the current context level (siblings).\n * Use withNestedSpan if you want parent-child relationships.\n */\nexport async function withSpan<T>(\n  name: string,\n  attrs: SpanAttrs,\n  fn: (span: Span) => Promise<T>,\n  options?: WithSpanOptions\n): Promise<T> {\n  const parentCtx = getParentContext(options)\n  const span = TRACER.startSpan(name, undefined, parentCtx)\n\n  // Filter out undefined attributes\n  const filteredAttrs: Record<string, string | number | boolean> = {}\n  for (const [key, value] of Object.entries(attrs)) {\n    if (value !== undefined) {\n      filteredAttrs[key] = value\n    }\n  }\n\n  span.setAttributes(filteredAttrs)\n\n  try {\n    const result = await fn(span)\n    span.setStatus({ code: SpanStatusCode.OK })\n    return result\n  } catch (error) {\n    span.setStatus({\n      code: SpanStatusCode.ERROR,\n      message: error instanceof Error ? error.message : String(error),\n    })\n    span.recordException(error as Error)\n    throw error\n  } finally {\n    span.end()\n  }\n}\n\n/**\n * Like withSpan but propagates context so child spans nest properly.\n * Use this when you want operations inside fn to be child spans.\n */\nexport async function withNestedSpan<T>(\n  name: string,\n  attrs: SpanAttrs,\n  fn: (span: Span) => Promise<T>,\n  options?: WithSpanOptions\n): Promise<T> {\n  const parentCtx = getParentContext(options)\n  const span = TRACER.startSpan(name, undefined, parentCtx)\n\n  // Filter out undefined attributes\n  const filteredAttrs: Record<string, string | number | boolean> = {}\n  for (const [key, value] of Object.entries(attrs)) {\n    if (value !== undefined) {\n      filteredAttrs[key] = value\n    }\n  }\n\n  span.setAttributes(filteredAttrs)\n\n  // Set the span as active context so child spans nest properly\n  const ctx = trace.setSpan(parentCtx, span)\n\n  try {\n    // Execute the function within the span's context\n    const result = await context.with(ctx, () => fn(span))\n    span.setStatus({ code: SpanStatusCode.OK })\n    return result\n  } catch (error) {\n    span.setStatus({\n      code: SpanStatusCode.ERROR,\n      message: error instanceof Error ? error.message : String(error),\n    })\n    span.recordException(error as Error)\n    throw error\n  } finally {\n    span.end()\n  }\n}\n\n/**\n * Creates a synchronous span for non-async operations\n */\nexport function withSyncSpan<T>(\n  name: string,\n  attrs: SpanAttrs,\n  fn: (span: Span) => T,\n  options?: WithSpanOptions\n): T {\n  const parentCtx = getParentContext(options)\n  const span = TRACER.startSpan(name, undefined, parentCtx)\n\n  // Filter out undefined attributes\n  const filteredAttrs: Record<string, string | number | boolean> = {}\n  for (const [key, value] of Object.entries(attrs)) {\n    if (value !== undefined) {\n      filteredAttrs[key] = value\n    }\n  }\n\n  span.setAttributes(filteredAttrs)\n\n  try {\n    const result = fn(span)\n    span.setStatus({ code: SpanStatusCode.OK })\n    return result\n  } catch (error) {\n    span.setStatus({\n      code: SpanStatusCode.ERROR,\n      message: error instanceof Error ? error.message : String(error),\n    })\n    span.recordException(error as Error)\n    throw error\n  } finally {\n    span.end()\n  }\n}\n\n/**\n * Get the current tracer instance\n */\nexport function getTracer() {\n  return TRACER\n}\n"],"names":["trace","context","SpanStatusCode"],"mappings":";;;AAQA,MAAM,SAASA,IAAAA,MAAM,UAAU,kCAAkC,OAAO;AAUxE,SAAS,iBAAiB,SAA2B;AACnD,MAAI,SAAS,eAAe;AAC1B,UAAM,aAAaA,IAAAA,MAAM,gBAAgB,QAAQ,aAAa;AAC9D,WAAOA,IAAAA,MAAM,QAAQC,IAAAA,QAAQ,OAAA,GAAU,UAAU;AAAA,EACnD;AAEA,SAAOA,IAAAA,QAAQ,OAAA;AACjB;AASA,eAAsB,SACpB,MACA,OACA,IACA,SACY;AACZ,QAAM,YAAY,iBAAiB,OAAO;AAC1C,QAAM,OAAO,OAAO,UAAU,MAAM,QAAW,SAAS;AAGxD,QAAM,gBAA2D,CAAA;AACjE,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,KAAK,GAAG;AAChD,QAAI,UAAU,QAAW;AACvB,oBAAc,GAAG,IAAI;AAAA,IACvB;AAAA,EACF;AAEA,OAAK,cAAc,aAAa;AAEhC,MAAI;AACF,UAAM,SAAS,MAAM,GAAG,IAAI;AAC5B,SAAK,UAAU,EAAE,MAAMC,IAAAA,eAAe,IAAI;AAC1C,WAAO;AAAA,EACT,SAAS,OAAO;AACd,SAAK,UAAU;AAAA,MACb,MAAMA,IAAAA,eAAe;AAAA,MACrB,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,IAAA,CAC/D;AACD,SAAK,gBAAgB,KAAc;AACnC,UAAM;AAAA,EACR,UAAA;AACE,SAAK,IAAA;AAAA,EACP;AACF;AAMA,eAAsB,eACpB,MACA,OACA,IACA,SACY;AACZ,QAAM,YAAY,iBAAiB,OAAO;AAC1C,QAAM,OAAO,OAAO,UAAU,MAAM,QAAW,SAAS;AAGxD,QAAM,gBAA2D,CAAA;AACjE,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,KAAK,GAAG;AAChD,QAAI,UAAU,QAAW;AACvB,oBAAc,GAAG,IAAI;AAAA,IACvB;AAAA,EACF;AAEA,OAAK,cAAc,aAAa;AAGhC,QAAM,MAAMF,IAAAA,MAAM,QAAQ,WAAW,IAAI;AAEzC,MAAI;AAEF,UAAM,SAAS,MAAMC,YAAQ,KAAK,KAAK,MAAM,GAAG,IAAI,CAAC;AACrD,SAAK,UAAU,EAAE,MAAMC,IAAAA,eAAe,IAAI;AAC1C,WAAO;AAAA,EACT,SAAS,OAAO;AACd,SAAK,UAAU;AAAA,MACb,MAAMA,IAAAA,eAAe;AAAA,MACrB,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,IAAA,CAC/D;AACD,SAAK,gBAAgB,KAAc;AACnC,UAAM;AAAA,EACR,UAAA;AACE,SAAK,IAAA;AAAA,EACP;AACF;AAKO,SAAS,aACd,MACA,OACA,IACA,SACG;AACH,QAAM,YAAY,iBAAiB,OAAO;AAC1C,QAAM,OAAO,OAAO,UAAU,MAAM,QAAW,SAAS;AAGxD,QAAM,gBAA2D,CAAA;AACjE,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,KAAK,GAAG;AAChD,QAAI,UAAU,QAAW;AACvB,oBAAc,GAAG,IAAI;AAAA,IACvB;AAAA,EACF;AAEA,OAAK,cAAc,aAAa;AAEhC,MAAI;AACF,UAAM,SAAS,GAAG,IAAI;AACtB,SAAK,UAAU,EAAE,MAAMA,IAAAA,eAAe,IAAI;AAC1C,WAAO;AAAA,EACT,SAAS,OAAO;AACd,SAAK,UAAU;AAAA,MACb,MAAMA,IAAAA,eAAe;AAAA,MACrB,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,IAAA,CAC/D;AACD,SAAK,gBAAgB,KAAc;AACnC,UAAM;AAAA,EACR,UAAA;AACE,SAAK,IAAA;AAAA,EACP;AACF;;;;"}

package/dist/cjs/telemetry/tracer.d.cts

@@ -0,0 +1,29 @@
+import { Span, SpanContext } from '@opentelemetry/api';
+export interface SpanAttrs {
+    [key: string]: string | number | boolean | undefined;
+}
+interface WithSpanOptions {
+    parentContext?: SpanContext;
+}
+/**
+ * Lightweight span wrapper with error handling.
+ * Uses OpenTelemetry API which is no-op when tracing is disabled.
+ *
+ * By default, creates spans at the current context level (siblings).
+ * Use withNestedSpan if you want parent-child relationships.
+ */
+export declare function withSpan<T>(name: string, attrs: SpanAttrs, fn: (span: Span) => Promise<T>, options?: WithSpanOptions): Promise<T>;
+/**
+ * Like withSpan but propagates context so child spans nest properly.
+ * Use this when you want operations inside fn to be child spans.
+ */
+export declare function withNestedSpan<T>(name: string, attrs: SpanAttrs, fn: (span: Span) => Promise<T>, options?: WithSpanOptions): Promise<T>;
+/**
+ * Creates a synchronous span for non-async operations
+ */
+export declare function withSyncSpan<T>(name: string, attrs: SpanAttrs, fn: (span: Span) => T, options?: WithSpanOptions): T;
+/**
+ * Get the current tracer instance
+ */
+export declare function getTracer(): import('@opentelemetry/api').Tracer;
+export {};

package/dist/cjs/types.cjs

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+class NonRetriableError extends Error {
+  constructor(message) {
+    super(message);
+    this.name = `NonRetriableError`;
+  }
+}
+exports.NonRetriableError = NonRetriableError;
+//# sourceMappingURL=types.cjs.map