@tanstack/offline-transactions 0.0.0 → 0.1.0

package/dist/cjs/telemetry/tracer.cjs

@@ -1,7 +1,7 @@
 "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");
+const TRACER = api.trace.getTracer(`@tanstack/offline-transactions`, `0.0.1`);
 function getParentContext(options) {
   if (options?.parentContext) {
     const parentSpan = api.trace.wrapSpanContext(options.parentContext);

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

@@ -1 +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;;;;"}
+{"version":3,"file":"tracer.cjs","sources":["../../../src/telemetry/tracer.ts"],"sourcesContent":["import { SpanStatusCode, context, trace } from \"@opentelemetry/api\"\nimport type { Span, SpanContext } 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":";;;AAGA,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/types.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"types.cjs","sources":["../../src/types.ts"],"sourcesContent":["import type {\n  Collection,\n  MutationFnParams,\n  PendingMutation,\n} from \"@tanstack/db\"\n\n// Extended mutation function that includes idempotency key\nexport type OfflineMutationFnParams<\n  T extends object = Record<string, unknown>,\n> = MutationFnParams<T> & {\n  idempotencyKey: string\n}\n\nexport type OfflineMutationFn<T extends object = Record<string, unknown>> = (\n  params: OfflineMutationFnParams<T>\n) => Promise<any>\n\n// Simplified mutation structure for serialization\nexport interface SerializedMutation {\n  globalKey: string\n  type: string\n  modified: any\n  original: any\n  collectionId: string\n}\n\nexport interface SerializedError {\n  name: string\n  message: string\n  stack?: string\n}\n\nexport interface SerializedSpanContext {\n  traceId: string\n  spanId: string\n  traceFlags: number\n  traceState?: string\n}\n\n// In-memory representation with full PendingMutation objects\nexport interface OfflineTransaction {\n  id: string\n  mutationFnName: string\n  mutations: Array<PendingMutation>\n  keys: Array<string>\n  idempotencyKey: string\n  createdAt: Date\n  retryCount: number\n  nextAttemptAt: number\n  lastError?: SerializedError\n  metadata?: Record<string, any>\n  spanContext?: SerializedSpanContext\n  version: 1\n}\n\n// Serialized representation for storage\nexport interface SerializedOfflineTransaction {\n  id: string\n  mutationFnName: string\n  mutations: Array<SerializedMutation>\n  keys: Array<string>\n  idempotencyKey: string\n  createdAt: Date\n  retryCount: number\n  nextAttemptAt: number\n  lastError?: SerializedError\n  metadata?: Record<string, any>\n  spanContext?: SerializedSpanContext\n  version: 1\n}\n\nexport interface OfflineConfig {\n  collections: Record<string, Collection>\n  mutationFns: Record<string, OfflineMutationFn>\n  storage?: StorageAdapter\n  maxConcurrency?: number\n  jitter?: boolean\n  beforeRetry?: (\n    transactions: Array<OfflineTransaction>\n  ) => Array<OfflineTransaction>\n  onUnknownMutationFn?: (name: string, tx: OfflineTransaction) => void\n  onLeadershipChange?: (isLeader: boolean) => void\n  leaderElection?: LeaderElection\n  otel?: {\n    endpoint: string\n    headers?: Record<string, string>\n  }\n}\n\nexport interface StorageAdapter {\n  get: (key: string) => Promise<string | null>\n  set: (key: string, value: string) => Promise<void>\n  delete: (key: string) => Promise<void>\n  keys: () => Promise<Array<string>>\n  clear: () => Promise<void>\n}\n\nexport interface RetryPolicy {\n  calculateDelay: (retryCount: number) => number\n  shouldRetry: (error: Error, retryCount: number) => boolean\n}\n\nexport interface LeaderElection {\n  requestLeadership: () => Promise<boolean>\n  releaseLeadership: () => void\n  isLeader: () => boolean\n  onLeadershipChange: (callback: (isLeader: boolean) => void) => () => void\n}\n\nexport interface OnlineDetector {\n  subscribe: (callback: () => void) => () => void\n  notifyOnline: () => void\n}\n\nexport interface CreateOfflineTransactionOptions {\n  id?: string\n  mutationFnName: string\n  autoCommit?: boolean\n  idempotencyKey?: string\n  metadata?: Record<string, any>\n}\n\nexport interface CreateOfflineActionOptions<T> {\n  mutationFnName: string\n  onMutate: (variables: T) => void\n}\n\nexport class NonRetriableError extends Error {\n  constructor(message: string) {\n    super(message)\n    this.name = `NonRetriableError`\n  }\n}\n"],"names":[],"mappings":";;AA+HO,MAAM,0BAA0B,MAAM;AAAA,EAC3C,YAAY,SAAiB;AAC3B,UAAM,OAAO;AACb,SAAK,OAAO;AAAA,EACd;AACF;;"}
+{"version":3,"file":"types.cjs","sources":["../../src/types.ts"],"sourcesContent":["import type {\n  Collection,\n  MutationFnParams,\n  PendingMutation,\n} from \"@tanstack/db\"\n\n// Extended mutation function that includes idempotency key\nexport type OfflineMutationFnParams<\n  T extends object = Record<string, unknown>,\n> = MutationFnParams<T> & {\n  idempotencyKey: string\n}\n\nexport type OfflineMutationFn<T extends object = Record<string, unknown>> = (\n  params: OfflineMutationFnParams<T>\n) => Promise<any>\n\n// Simplified mutation structure for serialization\nexport interface SerializedMutation {\n  globalKey: string\n  type: string\n  modified: any\n  original: any\n  collectionId: string\n}\n\nexport interface SerializedError {\n  name: string\n  message: string\n  stack?: string\n}\n\nexport interface SerializedSpanContext {\n  traceId: string\n  spanId: string\n  traceFlags: number\n  traceState?: string\n}\n\n// In-memory representation with full PendingMutation objects\nexport interface OfflineTransaction {\n  id: string\n  mutationFnName: string\n  mutations: Array<PendingMutation>\n  keys: Array<string>\n  idempotencyKey: string\n  createdAt: Date\n  retryCount: number\n  nextAttemptAt: number\n  lastError?: SerializedError\n  metadata?: Record<string, any>\n  spanContext?: SerializedSpanContext\n  version: 1\n}\n\n// Serialized representation for storage\nexport interface SerializedOfflineTransaction {\n  id: string\n  mutationFnName: string\n  mutations: Array<SerializedMutation>\n  keys: Array<string>\n  idempotencyKey: string\n  createdAt: Date\n  retryCount: number\n  nextAttemptAt: number\n  lastError?: SerializedError\n  metadata?: Record<string, any>\n  spanContext?: SerializedSpanContext\n  version: 1\n}\n\n// Storage diagnostics and mode\nexport type OfflineMode = `offline` | `online-only`\n\nexport type StorageDiagnosticCode =\n  | `STORAGE_AVAILABLE`\n  | `INDEXEDDB_UNAVAILABLE`\n  | `LOCALSTORAGE_UNAVAILABLE`\n  | `STORAGE_BLOCKED`\n  | `QUOTA_EXCEEDED`\n  | `UNKNOWN_ERROR`\n\nexport interface StorageDiagnostic {\n  code: StorageDiagnosticCode\n  mode: OfflineMode\n  message: string\n  error?: Error\n}\n\nexport interface OfflineConfig {\n  collections: Record<string, Collection>\n  mutationFns: Record<string, OfflineMutationFn>\n  storage?: StorageAdapter\n  maxConcurrency?: number\n  jitter?: boolean\n  beforeRetry?: (\n    transactions: Array<OfflineTransaction>\n  ) => Array<OfflineTransaction>\n  onUnknownMutationFn?: (name: string, tx: OfflineTransaction) => void\n  onLeadershipChange?: (isLeader: boolean) => void\n  onStorageFailure?: (diagnostic: StorageDiagnostic) => void\n  leaderElection?: LeaderElection\n}\n\nexport interface StorageAdapter {\n  get: (key: string) => Promise<string | null>\n  set: (key: string, value: string) => Promise<void>\n  delete: (key: string) => Promise<void>\n  keys: () => Promise<Array<string>>\n  clear: () => Promise<void>\n}\n\nexport interface RetryPolicy {\n  calculateDelay: (retryCount: number) => number\n  shouldRetry: (error: Error, retryCount: number) => boolean\n}\n\nexport interface LeaderElection {\n  requestLeadership: () => Promise<boolean>\n  releaseLeadership: () => void\n  isLeader: () => boolean\n  onLeadershipChange: (callback: (isLeader: boolean) => void) => () => void\n}\n\nexport interface OnlineDetector {\n  subscribe: (callback: () => void) => () => void\n  notifyOnline: () => void\n}\n\nexport interface CreateOfflineTransactionOptions {\n  id?: string\n  mutationFnName: string\n  autoCommit?: boolean\n  idempotencyKey?: string\n  metadata?: Record<string, any>\n}\n\nexport interface CreateOfflineActionOptions<T> {\n  mutationFnName: string\n  onMutate: (variables: T) => void\n}\n\nexport class NonRetriableError extends Error {\n  constructor(message: string) {\n    super(message)\n    this.name = `NonRetriableError`\n  }\n}\n"],"names":[],"mappings":";;AA8IO,MAAM,0BAA0B,MAAM;AAAA,EAC3C,YAAY,SAAiB;AAC3B,UAAM,OAAO;AACb,SAAK,OAAO;AAAA,EACd;AACF;;"}

package/dist/cjs/types.d.cts

@@ -49,6 +49,14 @@ export interface SerializedOfflineTransaction {
     spanContext?: SerializedSpanContext;
     version: 1;
 }
+export type OfflineMode = `offline` | `online-only`;
+export type StorageDiagnosticCode = `STORAGE_AVAILABLE` | `INDEXEDDB_UNAVAILABLE` | `LOCALSTORAGE_UNAVAILABLE` | `STORAGE_BLOCKED` | `QUOTA_EXCEEDED` | `UNKNOWN_ERROR`;
+export interface StorageDiagnostic {
+    code: StorageDiagnosticCode;
+    mode: OfflineMode;
+    message: string;
+    error?: Error;
+}
 export interface OfflineConfig {
     collections: Record<string, Collection>;
     mutationFns: Record<string, OfflineMutationFn>;
@@ -58,11 +66,8 @@ export interface OfflineConfig {
     beforeRetry?: (transactions: Array<OfflineTransaction>) => Array<OfflineTransaction>;
     onUnknownMutationFn?: (name: string, tx: OfflineTransaction) => void;
     onLeadershipChange?: (isLeader: boolean) => void;
+    onStorageFailure?: (diagnostic: StorageDiagnostic) => void;
     leaderElection?: LeaderElection;
-    otel?: {
-        endpoint: string;
-        headers?: Record<string, string>;
-    };
 }
 export interface StorageAdapter {
     get: (key: string) => Promise<string | null>;

package/dist/esm/OfflineExecutor.d.ts

@@ -1,6 +1,6 @@
 import { DefaultOnlineDetector } from './connectivity/OnlineDetector.js';
 import { OfflineTransaction as OfflineTransactionAPI } from './api/OfflineTransaction.js';
-import { CreateOfflineActionOptions, CreateOfflineTransactionOptions, OfflineConfig, OfflineTransaction } from './types.js';
+import { CreateOfflineActionOptions, CreateOfflineTransactionOptions, OfflineConfig, OfflineMode, OfflineTransaction, StorageDiagnostic } from './types.js';
 import { Transaction } from '@tanstack/db';
 export declare class OfflineExecutor {
     private config;
@@ -13,8 +13,17 @@ export declare class OfflineExecutor {
     private isLeaderState;
     private unsubscribeOnline;
     private unsubscribeLeadership;
+    readonly mode: OfflineMode;
+    readonly storageDiagnostic: StorageDiagnostic;
+    private initPromise;
+    private initResolve;
+    private initReject;
     private pendingTransactionPromises;
     constructor(config: OfflineConfig);
+    /**
+     * Probe storage availability and create appropriate adapter.
+     * Returns null if no storage is available (online-only mode).
+     */
     private createStorage;
     private createLeaderElection;
     private setupEventListeners;

package/dist/esm/OfflineExecutor.js

@@ -17,33 +17,85 @@ class OfflineExecutor {
     this.unsubscribeLeadership = null;
     this.pendingTransactionPromises = /* @__PURE__ */ new Map();
     this.config = config;
-    this.storage = this.createStorage();
-    this.outbox = new OutboxManager(this.storage, this.config.collections);
     this.scheduler = new KeyScheduler();
-    this.executor = new TransactionExecutor(
-      this.scheduler,
-      this.outbox,
-      this.config,
-      this
-    );
-    this.leaderElection = this.createLeaderElection();
     this.onlineDetector = new DefaultOnlineDetector();
-    this.setupEventListeners();
+    this.storage = null;
+    this.outbox = null;
+    this.executor = null;
+    this.leaderElection = null;
+    this.mode = `offline`;
+    this.storageDiagnostic = {
+      code: `STORAGE_AVAILABLE`,
+      mode: `offline`,
+      message: `Initializing storage...`
+    };
+    this.initPromise = new Promise((resolve, reject) => {
+      this.initResolve = resolve;
+      this.initReject = reject;
+    });
     this.initialize();
   }
-  createStorage() {
+  /**
+   * Probe storage availability and create appropriate adapter.
+   * Returns null if no storage is available (online-only mode).
+   */
+  async createStorage() {
     if (this.config.storage) {
-      return this.config.storage;
+      return {
+        storage: this.config.storage,
+        diagnostic: {
+          code: `STORAGE_AVAILABLE`,
+          mode: `offline`,
+          message: `Using custom storage adapter`
+        }
+      };
     }
-    try {
-      return new IndexedDBAdapter();
-    } catch (error) {
-      console.warn(
-        `IndexedDB not available, falling back to localStorage:`,
-        error
-      );
-      return new LocalStorageAdapter();
+    const idbProbe = await IndexedDBAdapter.probe();
+    if (idbProbe.available) {
+      return {
+        storage: new IndexedDBAdapter(),
+        diagnostic: {
+          code: `STORAGE_AVAILABLE`,
+          mode: `offline`,
+          message: `Using IndexedDB for offline storage`
+        }
+      };
+    }
+    const lsProbe = LocalStorageAdapter.probe();
+    if (lsProbe.available) {
+      return {
+        storage: new LocalStorageAdapter(),
+        diagnostic: {
+          code: `INDEXEDDB_UNAVAILABLE`,
+          mode: `offline`,
+          message: `IndexedDB unavailable, using localStorage fallback`,
+          error: idbProbe.error
+        }
+      };
+    }
+    const isSecurityError = idbProbe.error?.name === `SecurityError` || lsProbe.error?.name === `SecurityError`;
+    const isQuotaError = idbProbe.error?.name === `QuotaExceededError` || lsProbe.error?.name === `QuotaExceededError`;
+    let code;
+    let message;
+    if (isSecurityError) {
+      code = `STORAGE_BLOCKED`;
+      message = `Storage blocked (private mode or security restrictions). Running in online-only mode.`;
+    } else if (isQuotaError) {
+      code = `QUOTA_EXCEEDED`;
+      message = `Storage quota exceeded. Running in online-only mode.`;
+    } else {
+      code = `UNKNOWN_ERROR`;
+      message = `Storage unavailable due to unknown error. Running in online-only mode.`;
     }
+    return {
+      storage: null,
+      diagnostic: {
+        code,
+        mode: `online-only`,
+        message,
+        error: idbProbe.error || lsProbe.error
+      }
+    };
   }
   createLeaderElection() {
     if (this.config.leaderElection) {
@@ -65,19 +117,21 @@ class OfflineExecutor {
     }
   }
   setupEventListeners() {
-    this.unsubscribeLeadership = this.leaderElection.onLeadershipChange(
-      (isLeader) => {
-        this.isLeaderState = isLeader;
-        if (this.config.onLeadershipChange) {
-          this.config.onLeadershipChange(isLeader);
+    if (this.leaderElection) {
+      this.unsubscribeLeadership = this.leaderElection.onLeadershipChange(
+        (isLeader) => {
+          this.isLeaderState = isLeader;
+          if (this.config.onLeadershipChange) {
+            this.config.onLeadershipChange(isLeader);
+          }
+          if (isLeader) {
+            this.loadAndReplayTransactions();
+          }
         }
-        if (isLeader) {
-          this.loadAndReplayTransactions();
-        }
-      }
-    );
+      );
+    }
     this.unsubscribeOnline = this.onlineDetector.subscribe(() => {
-      if (this.isOfflineEnabled) {
+      if (this.isOfflineEnabled && this.executor) {
         this.executor.resetRetryDelays();
         this.executor.executeAll().catch((error) => {
           console.warn(
@@ -91,17 +145,49 @@ class OfflineExecutor {
   async initialize() {
     return withSpan(`executor.initialize`, {}, async (span) => {
       try {
+        const { storage, diagnostic } = await this.createStorage();
+        this.storage = storage;
+        this.storageDiagnostic = diagnostic;
+        this.mode = diagnostic.mode;
+        span.setAttribute(`storage.mode`, diagnostic.mode);
+        span.setAttribute(`storage.code`, diagnostic.code);
+        if (!storage) {
+          if (this.config.onStorageFailure) {
+            this.config.onStorageFailure(diagnostic);
+          }
+          span.setAttribute(`result`, `online-only`);
+          this.initResolve();
+          return;
+        }
+        this.outbox = new OutboxManager(storage, this.config.collections);
+        this.executor = new TransactionExecutor(
+          this.scheduler,
+          this.outbox,
+          this.config,
+          this
+        );
+        this.leaderElection = this.createLeaderElection();
         const isLeader = await this.leaderElection.requestLeadership();
         span.setAttribute(`isLeader`, isLeader);
+        this.setupEventListeners();
         if (isLeader) {
           await this.loadAndReplayTransactions();
         }
+        span.setAttribute(`result`, `offline-enabled`);
+        this.initResolve();
       } catch (error) {
         console.warn(`Failed to initialize offline executor:`, error);
+        span.setAttribute(`result`, `failed`);
+        this.initReject(
+          error instanceof Error ? error : new Error(String(error))
+        );
       }
     });
   }
   async loadAndReplayTransactions() {
+    if (!this.executor) {
+      return;
+    }
     try {
       await this.executor.loadPendingTransactions();
       await this.executor.executeAll();
@@ -110,7 +196,7 @@ class OfflineExecutor {
     }
   }
   get isOfflineEnabled() {
-    return this.isLeaderState;
+    return this.mode === `offline` && this.isLeaderState;
   }
   createOfflineTransaction(options) {
     const mutationFn = this.config.mutationFns[options.mutationFnName];
@@ -161,6 +247,7 @@ class OfflineExecutor {
     };
   }
   async persistTransaction(transaction) {
+    await this.initPromise;
     return withNestedSpan(
       `executor.persistTransaction`,
       {
@@ -168,7 +255,7 @@ class OfflineExecutor {
         "transaction.mutationFnName": transaction.mutationFnName
       },
       async (span) => {
-        if (!this.isOfflineEnabled) {
+        if (!this.isOfflineEnabled || !this.outbox || !this.executor) {
           span.setAttribute(`result`, `skipped_not_leader`);
           this.resolveTransaction(transaction.id, void 0);
           return;
@@ -219,12 +306,21 @@ class OfflineExecutor {
     }
   }
   async removeFromOutbox(id) {
+    if (!this.outbox) {
+      return;
+    }
     await this.outbox.remove(id);
   }
   async peekOutbox() {
+    if (!this.outbox) {
+      return [];
+    }
     return this.outbox.getAll();
   }
   async clearOutbox() {
+    if (!this.outbox || !this.executor) {
+      return;
+    }
     await this.outbox.clear();
     this.executor.clear();
   }
@@ -232,9 +328,15 @@ class OfflineExecutor {
     this.onlineDetector.notifyOnline();
   }
   getPendingCount() {
+    if (!this.executor) {
+      return 0;
+    }
     return this.executor.getPendingCount();
   }
   getRunningCount() {
+    if (!this.executor) {
+      return 0;
+    }
     return this.executor.getRunningCount();
   }
   getOnlineDetector() {
@@ -249,11 +351,13 @@ class OfflineExecutor {
       this.unsubscribeLeadership();
       this.unsubscribeLeadership = null;
     }
-    this.leaderElection.releaseLeadership();
-    this.onlineDetector.dispose();
-    if (`dispose` in this.leaderElection) {
-      this.leaderElection.dispose();
+    if (this.leaderElection) {
+      this.leaderElection.releaseLeadership();
+      if (`dispose` in this.leaderElection) {
+        this.leaderElection.dispose();
+      }
     }
+    this.onlineDetector.dispose();
   }
 }
 function startOfflineExecutor(config) {

package/dist/esm/OfflineExecutor.js.map

@@ -1 +1 @@
-{"version":3,"file":"OfflineExecutor.js","sources":["../../src/OfflineExecutor.ts"],"sourcesContent":["// Storage adapters\nimport { createOptimisticAction, createTransaction } from \"@tanstack/db\"\nimport { IndexedDBAdapter } from \"./storage/IndexedDBAdapter\"\nimport { LocalStorageAdapter } from \"./storage/LocalStorageAdapter\"\n\n// Core components\nimport { OutboxManager } from \"./outbox/OutboxManager\"\nimport { KeyScheduler } from \"./executor/KeyScheduler\"\nimport { TransactionExecutor } from \"./executor/TransactionExecutor\"\n\n// Coordination\nimport { WebLocksLeader } from \"./coordination/WebLocksLeader\"\nimport { BroadcastChannelLeader } from \"./coordination/BroadcastChannelLeader\"\n\n// Connectivity\nimport { DefaultOnlineDetector } from \"./connectivity/OnlineDetector\"\n\n// API\nimport { OfflineTransaction as OfflineTransactionAPI } from \"./api/OfflineTransaction\"\nimport { createOfflineAction } from \"./api/OfflineAction\"\n\n// TanStack DB primitives\n\n// Replay\nimport { withNestedSpan, withSpan } from \"./telemetry/tracer\"\nimport type {\n  CreateOfflineActionOptions,\n  CreateOfflineTransactionOptions,\n  LeaderElection,\n  OfflineConfig,\n  OfflineTransaction,\n  StorageAdapter,\n} from \"./types\"\nimport type { Transaction } from \"@tanstack/db\"\n\nexport class OfflineExecutor {\n  private config: OfflineConfig\n  private storage: StorageAdapter\n  private outbox: OutboxManager\n  private scheduler: KeyScheduler\n  private executor: TransactionExecutor\n  private leaderElection: LeaderElection\n  private onlineDetector: DefaultOnlineDetector\n  private isLeaderState = false\n  private unsubscribeOnline: (() => void) | null = null\n  private unsubscribeLeadership: (() => void) | null = null\n\n  // Coordination mechanism for blocking transactions\n  private pendingTransactionPromises: Map<\n    string,\n    {\n      promise: Promise<any>\n      resolve: (result: any) => void\n      reject: (error: Error) => void\n    }\n  > = new Map()\n\n  constructor(config: OfflineConfig) {\n    this.config = config\n    this.storage = this.createStorage()\n    this.outbox = new OutboxManager(this.storage, this.config.collections)\n    this.scheduler = new KeyScheduler()\n    this.executor = new TransactionExecutor(\n      this.scheduler,\n      this.outbox,\n      this.config,\n      this\n    )\n    this.leaderElection = this.createLeaderElection()\n    this.onlineDetector = new DefaultOnlineDetector()\n\n    this.setupEventListeners()\n    this.initialize()\n  }\n\n  private createStorage(): StorageAdapter {\n    if (this.config.storage) {\n      return this.config.storage\n    }\n\n    try {\n      return new IndexedDBAdapter()\n    } catch (error) {\n      console.warn(\n        `IndexedDB not available, falling back to localStorage:`,\n        error\n      )\n      return new LocalStorageAdapter()\n    }\n  }\n\n  private createLeaderElection(): LeaderElection {\n    if (this.config.leaderElection) {\n      return this.config.leaderElection\n    }\n\n    if (WebLocksLeader.isSupported()) {\n      return new WebLocksLeader()\n    } else if (BroadcastChannelLeader.isSupported()) {\n      return new BroadcastChannelLeader()\n    } else {\n      // Fallback: always be leader in environments without multi-tab support\n      return {\n        requestLeadership: () => Promise.resolve(true),\n        releaseLeadership: () => {},\n        isLeader: () => true,\n        onLeadershipChange: () => () => {},\n      }\n    }\n  }\n\n  private setupEventListeners(): void {\n    this.unsubscribeLeadership = this.leaderElection.onLeadershipChange(\n      (isLeader) => {\n        this.isLeaderState = isLeader\n\n        if (this.config.onLeadershipChange) {\n          this.config.onLeadershipChange(isLeader)\n        }\n\n        if (isLeader) {\n          this.loadAndReplayTransactions()\n        }\n      }\n    )\n\n    this.unsubscribeOnline = this.onlineDetector.subscribe(() => {\n      if (this.isOfflineEnabled) {\n        // Reset retry delays so transactions can execute immediately when back online\n        this.executor.resetRetryDelays()\n        this.executor.executeAll().catch((error) => {\n          console.warn(\n            `Failed to execute transactions on connectivity change:`,\n            error\n          )\n        })\n      }\n    })\n  }\n\n  private async initialize(): Promise<void> {\n    return withSpan(`executor.initialize`, {}, async (span) => {\n      try {\n        const isLeader = await this.leaderElection.requestLeadership()\n        span.setAttribute(`isLeader`, isLeader)\n\n        if (isLeader) {\n          await this.loadAndReplayTransactions()\n        }\n      } catch (error) {\n        console.warn(`Failed to initialize offline executor:`, error)\n      }\n    })\n  }\n\n  private async loadAndReplayTransactions(): Promise<void> {\n    try {\n      await this.executor.loadPendingTransactions()\n      await this.executor.executeAll()\n    } catch (error) {\n      console.warn(`Failed to load and replay transactions:`, error)\n    }\n  }\n\n  get isOfflineEnabled(): boolean {\n    return this.isLeaderState\n  }\n\n  createOfflineTransaction(\n    options: CreateOfflineTransactionOptions\n  ): Transaction | OfflineTransactionAPI {\n    const mutationFn = this.config.mutationFns[options.mutationFnName]\n\n    if (!mutationFn) {\n      throw new Error(`Unknown mutation function: ${options.mutationFnName}`)\n    }\n\n    // Check leadership immediately and use the appropriate primitive\n    if (!this.isOfflineEnabled) {\n      // Non-leader: use createTransaction directly with the resolved mutation function\n      // We need to wrap it to add the idempotency key\n      return createTransaction({\n        autoCommit: options.autoCommit ?? true,\n        mutationFn: (params) =>\n          mutationFn({\n            ...params,\n            idempotencyKey: options.idempotencyKey || crypto.randomUUID(),\n          }),\n        metadata: options.metadata,\n      })\n    }\n\n    // Leader: use OfflineTransaction wrapper for offline persistence\n    return new OfflineTransactionAPI(\n      options,\n      mutationFn,\n      this.persistTransaction.bind(this),\n      this\n    )\n  }\n\n  createOfflineAction<T>(options: CreateOfflineActionOptions<T>) {\n    const mutationFn = this.config.mutationFns[options.mutationFnName]\n\n    if (!mutationFn) {\n      throw new Error(`Unknown mutation function: ${options.mutationFnName}`)\n    }\n\n    // Return a wrapper that checks leadership status at call time\n    return (variables: T) => {\n      // Check leadership when action is called, not when it's created\n      if (!this.isOfflineEnabled) {\n        // Non-leader: use createOptimisticAction directly\n        const action = createOptimisticAction({\n          mutationFn: (vars, params) =>\n            mutationFn({\n              ...vars,\n              ...params,\n              idempotencyKey: crypto.randomUUID(),\n            }),\n          onMutate: options.onMutate,\n        })\n        return action(variables)\n      }\n\n      // Leader: use the offline action wrapper\n      const action = createOfflineAction(\n        options,\n        mutationFn,\n        this.persistTransaction.bind(this),\n        this\n      )\n      return action(variables)\n    }\n  }\n\n  private async persistTransaction(\n    transaction: OfflineTransaction\n  ): Promise<void> {\n    return withNestedSpan(\n      `executor.persistTransaction`,\n      {\n        \"transaction.id\": transaction.id,\n        \"transaction.mutationFnName\": transaction.mutationFnName,\n      },\n      async (span) => {\n        if (!this.isOfflineEnabled) {\n          span.setAttribute(`result`, `skipped_not_leader`)\n          this.resolveTransaction(transaction.id, undefined)\n          return\n        }\n\n        try {\n          await this.outbox.add(transaction)\n          await this.executor.execute(transaction)\n          span.setAttribute(`result`, `persisted`)\n        } catch (error) {\n          console.error(\n            `Failed to persist offline transaction ${transaction.id}:`,\n            error\n          )\n          span.setAttribute(`result`, `failed`)\n          throw error\n        }\n      }\n    )\n  }\n\n  // Method for OfflineTransaction to wait for completion\n  async waitForTransactionCompletion(transactionId: string): Promise<any> {\n    const existing = this.pendingTransactionPromises.get(transactionId)\n    if (existing) {\n      return existing.promise\n    }\n\n    const deferred: {\n      promise: Promise<any>\n      resolve: (result: any) => void\n      reject: (error: Error) => void\n    } = {} as any\n\n    deferred.promise = new Promise((resolve, reject) => {\n      deferred.resolve = resolve\n      deferred.reject = reject\n    })\n\n    this.pendingTransactionPromises.set(transactionId, deferred)\n    return deferred.promise\n  }\n\n  // Method for TransactionExecutor to signal completion\n  resolveTransaction(transactionId: string, result: any): void {\n    const deferred = this.pendingTransactionPromises.get(transactionId)\n    if (deferred) {\n      deferred.resolve(result)\n      this.pendingTransactionPromises.delete(transactionId)\n    }\n  }\n\n  // Method for TransactionExecutor to signal failure\n  rejectTransaction(transactionId: string, error: Error): void {\n    const deferred = this.pendingTransactionPromises.get(transactionId)\n    if (deferred) {\n      deferred.reject(error)\n      this.pendingTransactionPromises.delete(transactionId)\n    }\n  }\n\n  async removeFromOutbox(id: string): Promise<void> {\n    await this.outbox.remove(id)\n  }\n\n  async peekOutbox(): Promise<Array<OfflineTransaction>> {\n    return this.outbox.getAll()\n  }\n\n  async clearOutbox(): Promise<void> {\n    await this.outbox.clear()\n    this.executor.clear()\n  }\n\n  notifyOnline(): void {\n    this.onlineDetector.notifyOnline()\n  }\n\n  getPendingCount(): number {\n    return this.executor.getPendingCount()\n  }\n\n  getRunningCount(): number {\n    return this.executor.getRunningCount()\n  }\n\n  getOnlineDetector(): DefaultOnlineDetector {\n    return this.onlineDetector\n  }\n\n  dispose(): void {\n    if (this.unsubscribeOnline) {\n      this.unsubscribeOnline()\n      this.unsubscribeOnline = null\n    }\n\n    if (this.unsubscribeLeadership) {\n      this.unsubscribeLeadership()\n      this.unsubscribeLeadership = null\n    }\n\n    this.leaderElection.releaseLeadership()\n    this.onlineDetector.dispose()\n\n    if (`dispose` in this.leaderElection) {\n      ;(this.leaderElection as any).dispose()\n    }\n  }\n}\n\nexport function startOfflineExecutor(config: OfflineConfig): OfflineExecutor {\n  return new OfflineExecutor(config)\n}\n"],"names":["OfflineTransactionAPI","action"],"mappings":";;;;;;;;;;;;AAmCO,MAAM,gBAAgB;AAAA,EAsB3B,YAAY,QAAuB;AAdnC,SAAQ,gBAAgB;AACxB,SAAQ,oBAAyC;AACjD,SAAQ,wBAA6C;AAGrD,SAAQ,iDAOA,IAAA;AAGN,SAAK,SAAS;AACd,SAAK,UAAU,KAAK,cAAA;AACpB,SAAK,SAAS,IAAI,cAAc,KAAK,SAAS,KAAK,OAAO,WAAW;AACrE,SAAK,YAAY,IAAI,aAAA;AACrB,SAAK,WAAW,IAAI;AAAA,MAClB,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK;AAAA,MACL;AAAA,IAAA;AAEF,SAAK,iBAAiB,KAAK,qBAAA;AAC3B,SAAK,iBAAiB,IAAI,sBAAA;AAE1B,SAAK,oBAAA;AACL,SAAK,WAAA;AAAA,EACP;AAAA,EAEQ,gBAAgC;AACtC,QAAI,KAAK,OAAO,SAAS;AACvB,aAAO,KAAK,OAAO;AAAA,IACrB;AAEA,QAAI;AACF,aAAO,IAAI,iBAAA;AAAA,IACb,SAAS,OAAO;AACd,cAAQ;AAAA,QACN;AAAA,QACA;AAAA,MAAA;AAEF,aAAO,IAAI,oBAAA;AAAA,IACb;AAAA,EACF;AAAA,EAEQ,uBAAuC;AAC7C,QAAI,KAAK,OAAO,gBAAgB;AAC9B,aAAO,KAAK,OAAO;AAAA,IACrB;AAEA,QAAI,eAAe,eAAe;AAChC,aAAO,IAAI,eAAA;AAAA,IACb,WAAW,uBAAuB,eAAe;AAC/C,aAAO,IAAI,uBAAA;AAAA,IACb,OAAO;AAEL,aAAO;AAAA,QACL,mBAAmB,MAAM,QAAQ,QAAQ,IAAI;AAAA,QAC7C,mBAAmB,MAAM;AAAA,QAAC;AAAA,QAC1B,UAAU,MAAM;AAAA,QAChB,oBAAoB,MAAM,MAAM;AAAA,QAAC;AAAA,MAAA;AAAA,IAErC;AAAA,EACF;AAAA,EAEQ,sBAA4B;AAClC,SAAK,wBAAwB,KAAK,eAAe;AAAA,MAC/C,CAAC,aAAa;AACZ,aAAK,gBAAgB;AAErB,YAAI,KAAK,OAAO,oBAAoB;AAClC,eAAK,OAAO,mBAAmB,QAAQ;AAAA,QACzC;AAEA,YAAI,UAAU;AACZ,eAAK,0BAAA;AAAA,QACP;AAAA,MACF;AAAA,IAAA;AAGF,SAAK,oBAAoB,KAAK,eAAe,UAAU,MAAM;AAC3D,UAAI,KAAK,kBAAkB;AAEzB,aAAK,SAAS,iBAAA;AACd,aAAK,SAAS,WAAA,EAAa,MAAM,CAAC,UAAU;AAC1C,kBAAQ;AAAA,YACN;AAAA,YACA;AAAA,UAAA;AAAA,QAEJ,CAAC;AAAA,MACH;AAAA,IACF,CAAC;AAAA,EACH;AAAA,EAEA,MAAc,aAA4B;AACxC,WAAO,SAAS,uBAAuB,CAAA,GAAI,OAAO,SAAS;AACzD,UAAI;AACF,cAAM,WAAW,MAAM,KAAK,eAAe,kBAAA;AAC3C,aAAK,aAAa,YAAY,QAAQ;AAEtC,YAAI,UAAU;AACZ,gBAAM,KAAK,0BAAA;AAAA,QACb;AAAA,MACF,SAAS,OAAO;AACd,gBAAQ,KAAK,0CAA0C,KAAK;AAAA,MAC9D;AAAA,IACF,CAAC;AAAA,EACH;AAAA,EAEA,MAAc,4BAA2C;AACvD,QAAI;AACF,YAAM,KAAK,SAAS,wBAAA;AACpB,YAAM,KAAK,SAAS,WAAA;AAAA,IACtB,SAAS,OAAO;AACd,cAAQ,KAAK,2CAA2C,KAAK;AAAA,IAC/D;AAAA,EACF;AAAA,EAEA,IAAI,mBAA4B;AAC9B,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,yBACE,SACqC;AACrC,UAAM,aAAa,KAAK,OAAO,YAAY,QAAQ,cAAc;AAEjE,QAAI,CAAC,YAAY;AACf,YAAM,IAAI,MAAM,8BAA8B,QAAQ,cAAc,EAAE;AAAA,IACxE;AAGA,QAAI,CAAC,KAAK,kBAAkB;AAG1B,aAAO,kBAAkB;AAAA,QACvB,YAAY,QAAQ,cAAc;AAAA,QAClC,YAAY,CAAC,WACX,WAAW;AAAA,UACT,GAAG;AAAA,UACH,gBAAgB,QAAQ,kBAAkB,OAAO,WAAA;AAAA,QAAW,CAC7D;AAAA,QACH,UAAU,QAAQ;AAAA,MAAA,CACnB;AAAA,IACH;AAGA,WAAO,IAAIA;AAAAA,MACT;AAAA,MACA;AAAA,MACA,KAAK,mBAAmB,KAAK,IAAI;AAAA,MACjC;AAAA,IAAA;AAAA,EAEJ;AAAA,EAEA,oBAAuB,SAAwC;AAC7D,UAAM,aAAa,KAAK,OAAO,YAAY,QAAQ,cAAc;AAEjE,QAAI,CAAC,YAAY;AACf,YAAM,IAAI,MAAM,8BAA8B,QAAQ,cAAc,EAAE;AAAA,IACxE;AAGA,WAAO,CAAC,cAAiB;AAEvB,UAAI,CAAC,KAAK,kBAAkB;AAE1B,cAAMC,UAAS,uBAAuB;AAAA,UACpC,YAAY,CAAC,MAAM,WACjB,WAAW;AAAA,YACT,GAAG;AAAA,YACH,GAAG;AAAA,YACH,gBAAgB,OAAO,WAAA;AAAA,UAAW,CACnC;AAAA,UACH,UAAU,QAAQ;AAAA,QAAA,CACnB;AACD,eAAOA,QAAO,SAAS;AAAA,MACzB;AAGA,YAAM,SAAS;AAAA,QACb;AAAA,QACA;AAAA,QACA,KAAK,mBAAmB,KAAK,IAAI;AAAA,QACjC;AAAA,MAAA;AAEF,aAAO,OAAO,SAAS;AAAA,IACzB;AAAA,EACF;AAAA,EAEA,MAAc,mBACZ,aACe;AACf,WAAO;AAAA,MACL;AAAA,MACA;AAAA,QACE,kBAAkB,YAAY;AAAA,QAC9B,8BAA8B,YAAY;AAAA,MAAA;AAAA,MAE5C,OAAO,SAAS;AACd,YAAI,CAAC,KAAK,kBAAkB;AAC1B,eAAK,aAAa,UAAU,oBAAoB;AAChD,eAAK,mBAAmB,YAAY,IAAI,MAAS;AACjD;AAAA,QACF;AAEA,YAAI;AACF,gBAAM,KAAK,OAAO,IAAI,WAAW;AACjC,gBAAM,KAAK,SAAS,QAAQ,WAAW;AACvC,eAAK,aAAa,UAAU,WAAW;AAAA,QACzC,SAAS,OAAO;AACd,kBAAQ;AAAA,YACN,yCAAyC,YAAY,EAAE;AAAA,YACvD;AAAA,UAAA;AAEF,eAAK,aAAa,UAAU,QAAQ;AACpC,gBAAM;AAAA,QACR;AAAA,MACF;AAAA,IAAA;AAAA,EAEJ;AAAA;AAAA,EAGA,MAAM,6BAA6B,eAAqC;AACtE,UAAM,WAAW,KAAK,2BAA2B,IAAI,aAAa;AAClE,QAAI,UAAU;AACZ,aAAO,SAAS;AAAA,IAClB;AAEA,UAAM,WAIF,CAAA;AAEJ,aAAS,UAAU,IAAI,QAAQ,CAAC,SAAS,WAAW;AAClD,eAAS,UAAU;AACnB,eAAS,SAAS;AAAA,IACpB,CAAC;AAED,SAAK,2BAA2B,IAAI,eAAe,QAAQ;AAC3D,WAAO,SAAS;AAAA,EAClB;AAAA;AAAA,EAGA,mBAAmB,eAAuB,QAAmB;AAC3D,UAAM,WAAW,KAAK,2BAA2B,IAAI,aAAa;AAClE,QAAI,UAAU;AACZ,eAAS,QAAQ,MAAM;AACvB,WAAK,2BAA2B,OAAO,aAAa;AAAA,IACtD;AAAA,EACF;AAAA;AAAA,EAGA,kBAAkB,eAAuB,OAAoB;AAC3D,UAAM,WAAW,KAAK,2BAA2B,IAAI,aAAa;AAClE,QAAI,UAAU;AACZ,eAAS,OAAO,KAAK;AACrB,WAAK,2BAA2B,OAAO,aAAa;AAAA,IACtD;AAAA,EACF;AAAA,EAEA,MAAM,iBAAiB,IAA2B;AAChD,UAAM,KAAK,OAAO,OAAO,EAAE;AAAA,EAC7B;AAAA,EAEA,MAAM,aAAiD;AACrD,WAAO,KAAK,OAAO,OAAA;AAAA,EACrB;AAAA,EAEA,MAAM,cAA6B;AACjC,UAAM,KAAK,OAAO,MAAA;AAClB,SAAK,SAAS,MAAA;AAAA,EAChB;AAAA,EAEA,eAAqB;AACnB,SAAK,eAAe,aAAA;AAAA,EACtB;AAAA,EAEA,kBAA0B;AACxB,WAAO,KAAK,SAAS,gBAAA;AAAA,EACvB;AAAA,EAEA,kBAA0B;AACxB,WAAO,KAAK,SAAS,gBAAA;AAAA,EACvB;AAAA,EAEA,oBAA2C;AACzC,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,UAAgB;AACd,QAAI,KAAK,mBAAmB;AAC1B,WAAK,kBAAA;AACL,WAAK,oBAAoB;AAAA,IAC3B;AAEA,QAAI,KAAK,uBAAuB;AAC9B,WAAK,sBAAA;AACL,WAAK,wBAAwB;AAAA,IAC/B;AAEA,SAAK,eAAe,kBAAA;AACpB,SAAK,eAAe,QAAA;AAEpB,QAAI,aAAa,KAAK,gBAAgB;AAClC,WAAK,eAAuB,QAAA;AAAA,IAChC;AAAA,EACF;AACF;AAEO,SAAS,qBAAqB,QAAwC;AAC3E,SAAO,IAAI,gBAAgB,MAAM;AACnC;"}
+{"version":3,"file":"OfflineExecutor.js","sources":["../../src/OfflineExecutor.ts"],"sourcesContent":["// Storage adapters\nimport { createOptimisticAction, createTransaction } from \"@tanstack/db\"\nimport { IndexedDBAdapter } from \"./storage/IndexedDBAdapter\"\nimport { LocalStorageAdapter } from \"./storage/LocalStorageAdapter\"\n\n// Core components\nimport { OutboxManager } from \"./outbox/OutboxManager\"\nimport { KeyScheduler } from \"./executor/KeyScheduler\"\nimport { TransactionExecutor } from \"./executor/TransactionExecutor\"\n\n// Coordination\nimport { WebLocksLeader } from \"./coordination/WebLocksLeader\"\nimport { BroadcastChannelLeader } from \"./coordination/BroadcastChannelLeader\"\n\n// Connectivity\nimport { DefaultOnlineDetector } from \"./connectivity/OnlineDetector\"\n\n// API\nimport { OfflineTransaction as OfflineTransactionAPI } from \"./api/OfflineTransaction\"\nimport { createOfflineAction } from \"./api/OfflineAction\"\n\n// TanStack DB primitives\n\n// Replay\nimport { withNestedSpan, withSpan } from \"./telemetry/tracer\"\nimport type {\n  CreateOfflineActionOptions,\n  CreateOfflineTransactionOptions,\n  LeaderElection,\n  OfflineConfig,\n  OfflineMode,\n  OfflineTransaction,\n  StorageAdapter,\n  StorageDiagnostic,\n} from \"./types\"\nimport type { Transaction } from \"@tanstack/db\"\n\nexport class OfflineExecutor {\n  private config: OfflineConfig\n\n  // @ts-expect-error - Set during async initialization in initialize()\n  private storage: StorageAdapter | null\n  private outbox: OutboxManager | null\n  private scheduler: KeyScheduler\n  private executor: TransactionExecutor | null\n  private leaderElection: LeaderElection | null\n  private onlineDetector: DefaultOnlineDetector\n  private isLeaderState = false\n  private unsubscribeOnline: (() => void) | null = null\n  private unsubscribeLeadership: (() => void) | null = null\n\n  // Public diagnostic properties\n  public readonly mode: OfflineMode\n  public readonly storageDiagnostic: StorageDiagnostic\n\n  // Track initialization completion\n  private initPromise: Promise<void>\n  private initResolve!: () => void\n  private initReject!: (error: Error) => void\n\n  // Coordination mechanism for blocking transactions\n  private pendingTransactionPromises: Map<\n    string,\n    {\n      promise: Promise<any>\n      resolve: (result: any) => void\n      reject: (error: Error) => void\n    }\n  > = new Map()\n\n  constructor(config: OfflineConfig) {\n    this.config = config\n    this.scheduler = new KeyScheduler()\n    this.onlineDetector = new DefaultOnlineDetector()\n\n    // Initialize as pending - will be set by async initialization\n    this.storage = null\n    this.outbox = null\n    this.executor = null\n    this.leaderElection = null\n\n    // Temporary diagnostic - will be updated by async initialization\n    this.mode = `offline`\n    this.storageDiagnostic = {\n      code: `STORAGE_AVAILABLE`,\n      mode: `offline`,\n      message: `Initializing storage...`,\n    }\n\n    // Create initialization promise\n    this.initPromise = new Promise((resolve, reject) => {\n      this.initResolve = resolve\n      this.initReject = reject\n    })\n\n    this.initialize()\n  }\n\n  /**\n   * Probe storage availability and create appropriate adapter.\n   * Returns null if no storage is available (online-only mode).\n   */\n  private async createStorage(): Promise<{\n    storage: StorageAdapter | null\n    diagnostic: StorageDiagnostic\n  }> {\n    // If user provided custom storage, use it without probing\n    if (this.config.storage) {\n      return {\n        storage: this.config.storage,\n        diagnostic: {\n          code: `STORAGE_AVAILABLE`,\n          mode: `offline`,\n          message: `Using custom storage adapter`,\n        },\n      }\n    }\n\n    // Probe IndexedDB first\n    const idbProbe = await IndexedDBAdapter.probe()\n    if (idbProbe.available) {\n      return {\n        storage: new IndexedDBAdapter(),\n        diagnostic: {\n          code: `STORAGE_AVAILABLE`,\n          mode: `offline`,\n          message: `Using IndexedDB for offline storage`,\n        },\n      }\n    }\n\n    // IndexedDB failed, try localStorage\n    const lsProbe = LocalStorageAdapter.probe()\n    if (lsProbe.available) {\n      return {\n        storage: new LocalStorageAdapter(),\n        diagnostic: {\n          code: `INDEXEDDB_UNAVAILABLE`,\n          mode: `offline`,\n          message: `IndexedDB unavailable, using localStorage fallback`,\n          error: idbProbe.error,\n        },\n      }\n    }\n\n    // Both failed - determine the diagnostic code\n    const isSecurityError =\n      idbProbe.error?.name === `SecurityError` ||\n      lsProbe.error?.name === `SecurityError`\n    const isQuotaError =\n      idbProbe.error?.name === `QuotaExceededError` ||\n      lsProbe.error?.name === `QuotaExceededError`\n\n    let code: StorageDiagnostic[`code`]\n    let message: string\n\n    if (isSecurityError) {\n      code = `STORAGE_BLOCKED`\n      message = `Storage blocked (private mode or security restrictions). Running in online-only mode.`\n    } else if (isQuotaError) {\n      code = `QUOTA_EXCEEDED`\n      message = `Storage quota exceeded. Running in online-only mode.`\n    } else {\n      code = `UNKNOWN_ERROR`\n      message = `Storage unavailable due to unknown error. Running in online-only mode.`\n    }\n\n    return {\n      storage: null,\n      diagnostic: {\n        code,\n        mode: `online-only`,\n        message,\n        error: idbProbe.error || lsProbe.error,\n      },\n    }\n  }\n\n  private createLeaderElection(): LeaderElection {\n    if (this.config.leaderElection) {\n      return this.config.leaderElection\n    }\n\n    if (WebLocksLeader.isSupported()) {\n      return new WebLocksLeader()\n    } else if (BroadcastChannelLeader.isSupported()) {\n      return new BroadcastChannelLeader()\n    } else {\n      // Fallback: always be leader in environments without multi-tab support\n      return {\n        requestLeadership: () => Promise.resolve(true),\n        releaseLeadership: () => {},\n        isLeader: () => true,\n        onLeadershipChange: () => () => {},\n      }\n    }\n  }\n\n  private setupEventListeners(): void {\n    // Only set up leader election listeners if we have storage\n    if (this.leaderElection) {\n      this.unsubscribeLeadership = this.leaderElection.onLeadershipChange(\n        (isLeader) => {\n          this.isLeaderState = isLeader\n\n          if (this.config.onLeadershipChange) {\n            this.config.onLeadershipChange(isLeader)\n          }\n\n          if (isLeader) {\n            this.loadAndReplayTransactions()\n          }\n        }\n      )\n    }\n\n    this.unsubscribeOnline = this.onlineDetector.subscribe(() => {\n      if (this.isOfflineEnabled && this.executor) {\n        // Reset retry delays so transactions can execute immediately when back online\n        this.executor.resetRetryDelays()\n        this.executor.executeAll().catch((error) => {\n          console.warn(\n            `Failed to execute transactions on connectivity change:`,\n            error\n          )\n        })\n      }\n    })\n  }\n\n  private async initialize(): Promise<void> {\n    return withSpan(`executor.initialize`, {}, async (span) => {\n      try {\n        // Probe storage and create adapter\n        const { storage, diagnostic } = await this.createStorage()\n\n        // Cast to writable to set readonly properties\n        ;(this as any).storage = storage\n        ;(this as any).storageDiagnostic = diagnostic\n        ;(this as any).mode = diagnostic.mode\n\n        span.setAttribute(`storage.mode`, diagnostic.mode)\n        span.setAttribute(`storage.code`, diagnostic.code)\n\n        if (!storage) {\n          // Online-only mode - notify callback and skip offline setup\n          if (this.config.onStorageFailure) {\n            this.config.onStorageFailure(diagnostic)\n          }\n          span.setAttribute(`result`, `online-only`)\n          this.initResolve()\n          return\n        }\n\n        // Storage available - set up offline components\n        this.outbox = new OutboxManager(storage, this.config.collections)\n        this.executor = new TransactionExecutor(\n          this.scheduler,\n          this.outbox,\n          this.config,\n          this\n        )\n        this.leaderElection = this.createLeaderElection()\n\n        // Request leadership first\n        const isLeader = await this.leaderElection.requestLeadership()\n        span.setAttribute(`isLeader`, isLeader)\n\n        // Set up event listeners after leadership is established\n        // This prevents the callback from being called multiple times\n        this.setupEventListeners()\n\n        if (isLeader) {\n          await this.loadAndReplayTransactions()\n        }\n        span.setAttribute(`result`, `offline-enabled`)\n        this.initResolve()\n      } catch (error) {\n        console.warn(`Failed to initialize offline executor:`, error)\n        span.setAttribute(`result`, `failed`)\n        this.initReject(\n          error instanceof Error ? error : new Error(String(error))\n        )\n      }\n    })\n  }\n\n  private async loadAndReplayTransactions(): Promise<void> {\n    if (!this.executor) {\n      return\n    }\n\n    try {\n      await this.executor.loadPendingTransactions()\n      await this.executor.executeAll()\n    } catch (error) {\n      console.warn(`Failed to load and replay transactions:`, error)\n    }\n  }\n\n  get isOfflineEnabled(): boolean {\n    return this.mode === `offline` && this.isLeaderState\n  }\n\n  createOfflineTransaction(\n    options: CreateOfflineTransactionOptions\n  ): Transaction | OfflineTransactionAPI {\n    const mutationFn = this.config.mutationFns[options.mutationFnName]\n\n    if (!mutationFn) {\n      throw new Error(`Unknown mutation function: ${options.mutationFnName}`)\n    }\n\n    // Check leadership immediately and use the appropriate primitive\n    if (!this.isOfflineEnabled) {\n      // Non-leader: use createTransaction directly with the resolved mutation function\n      // We need to wrap it to add the idempotency key\n      return createTransaction({\n        autoCommit: options.autoCommit ?? true,\n        mutationFn: (params) =>\n          mutationFn({\n            ...params,\n            idempotencyKey: options.idempotencyKey || crypto.randomUUID(),\n          }),\n        metadata: options.metadata,\n      })\n    }\n\n    // Leader: use OfflineTransaction wrapper for offline persistence\n    return new OfflineTransactionAPI(\n      options,\n      mutationFn,\n      this.persistTransaction.bind(this),\n      this\n    )\n  }\n\n  createOfflineAction<T>(options: CreateOfflineActionOptions<T>) {\n    const mutationFn = this.config.mutationFns[options.mutationFnName]\n\n    if (!mutationFn) {\n      throw new Error(`Unknown mutation function: ${options.mutationFnName}`)\n    }\n\n    // Return a wrapper that checks leadership status at call time\n    return (variables: T) => {\n      // Check leadership when action is called, not when it's created\n      if (!this.isOfflineEnabled) {\n        // Non-leader: use createOptimisticAction directly\n        const action = createOptimisticAction({\n          mutationFn: (vars, params) =>\n            mutationFn({\n              ...vars,\n              ...params,\n              idempotencyKey: crypto.randomUUID(),\n            }),\n          onMutate: options.onMutate,\n        })\n        return action(variables)\n      }\n\n      // Leader: use the offline action wrapper\n      const action = createOfflineAction(\n        options,\n        mutationFn,\n        this.persistTransaction.bind(this),\n        this\n      )\n      return action(variables)\n    }\n  }\n\n  private async persistTransaction(\n    transaction: OfflineTransaction\n  ): Promise<void> {\n    // Wait for initialization to complete\n    await this.initPromise\n\n    return withNestedSpan(\n      `executor.persistTransaction`,\n      {\n        \"transaction.id\": transaction.id,\n        \"transaction.mutationFnName\": transaction.mutationFnName,\n      },\n      async (span) => {\n        if (!this.isOfflineEnabled || !this.outbox || !this.executor) {\n          span.setAttribute(`result`, `skipped_not_leader`)\n          this.resolveTransaction(transaction.id, undefined)\n          return\n        }\n\n        try {\n          await this.outbox.add(transaction)\n          await this.executor.execute(transaction)\n          span.setAttribute(`result`, `persisted`)\n        } catch (error) {\n          console.error(\n            `Failed to persist offline transaction ${transaction.id}:`,\n            error\n          )\n          span.setAttribute(`result`, `failed`)\n          throw error\n        }\n      }\n    )\n  }\n\n  // Method for OfflineTransaction to wait for completion\n  async waitForTransactionCompletion(transactionId: string): Promise<any> {\n    const existing = this.pendingTransactionPromises.get(transactionId)\n    if (existing) {\n      return existing.promise\n    }\n\n    const deferred: {\n      promise: Promise<any>\n      resolve: (result: any) => void\n      reject: (error: Error) => void\n    } = {} as any\n\n    deferred.promise = new Promise((resolve, reject) => {\n      deferred.resolve = resolve\n      deferred.reject = reject\n    })\n\n    this.pendingTransactionPromises.set(transactionId, deferred)\n    return deferred.promise\n  }\n\n  // Method for TransactionExecutor to signal completion\n  resolveTransaction(transactionId: string, result: any): void {\n    const deferred = this.pendingTransactionPromises.get(transactionId)\n    if (deferred) {\n      deferred.resolve(result)\n      this.pendingTransactionPromises.delete(transactionId)\n    }\n  }\n\n  // Method for TransactionExecutor to signal failure\n  rejectTransaction(transactionId: string, error: Error): void {\n    const deferred = this.pendingTransactionPromises.get(transactionId)\n    if (deferred) {\n      deferred.reject(error)\n      this.pendingTransactionPromises.delete(transactionId)\n    }\n  }\n\n  async removeFromOutbox(id: string): Promise<void> {\n    if (!this.outbox) {\n      return\n    }\n    await this.outbox.remove(id)\n  }\n\n  async peekOutbox(): Promise<Array<OfflineTransaction>> {\n    if (!this.outbox) {\n      return []\n    }\n    return this.outbox.getAll()\n  }\n\n  async clearOutbox(): Promise<void> {\n    if (!this.outbox || !this.executor) {\n      return\n    }\n    await this.outbox.clear()\n    this.executor.clear()\n  }\n\n  notifyOnline(): void {\n    this.onlineDetector.notifyOnline()\n  }\n\n  getPendingCount(): number {\n    if (!this.executor) {\n      return 0\n    }\n    return this.executor.getPendingCount()\n  }\n\n  getRunningCount(): number {\n    if (!this.executor) {\n      return 0\n    }\n    return this.executor.getRunningCount()\n  }\n\n  getOnlineDetector(): DefaultOnlineDetector {\n    return this.onlineDetector\n  }\n\n  dispose(): void {\n    if (this.unsubscribeOnline) {\n      this.unsubscribeOnline()\n      this.unsubscribeOnline = null\n    }\n\n    if (this.unsubscribeLeadership) {\n      this.unsubscribeLeadership()\n      this.unsubscribeLeadership = null\n    }\n\n    if (this.leaderElection) {\n      this.leaderElection.releaseLeadership()\n\n      if (`dispose` in this.leaderElection) {\n        ;(this.leaderElection as any).dispose()\n      }\n    }\n\n    this.onlineDetector.dispose()\n  }\n}\n\nexport function startOfflineExecutor(config: OfflineConfig): OfflineExecutor {\n  return new OfflineExecutor(config)\n}\n"],"names":["OfflineTransactionAPI","action"],"mappings":";;;;;;;;;;;;AAqCO,MAAM,gBAAgB;AAAA,EAiC3B,YAAY,QAAuB;AAvBnC,SAAQ,gBAAgB;AACxB,SAAQ,oBAAyC;AACjD,SAAQ,wBAA6C;AAYrD,SAAQ,iDAOA,IAAA;AAGN,SAAK,SAAS;AACd,SAAK,YAAY,IAAI,aAAA;AACrB,SAAK,iBAAiB,IAAI,sBAAA;AAG1B,SAAK,UAAU;AACf,SAAK,SAAS;AACd,SAAK,WAAW;AAChB,SAAK,iBAAiB;AAGtB,SAAK,OAAO;AACZ,SAAK,oBAAoB;AAAA,MACvB,MAAM;AAAA,MACN,MAAM;AAAA,MACN,SAAS;AAAA,IAAA;AAIX,SAAK,cAAc,IAAI,QAAQ,CAAC,SAAS,WAAW;AAClD,WAAK,cAAc;AACnB,WAAK,aAAa;AAAA,IACpB,CAAC;AAED,SAAK,WAAA;AAAA,EACP;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAc,gBAGX;AAED,QAAI,KAAK,OAAO,SAAS;AACvB,aAAO;AAAA,QACL,SAAS,KAAK,OAAO;AAAA,QACrB,YAAY;AAAA,UACV,MAAM;AAAA,UACN,MAAM;AAAA,UACN,SAAS;AAAA,QAAA;AAAA,MACX;AAAA,IAEJ;AAGA,UAAM,WAAW,MAAM,iBAAiB,MAAA;AACxC,QAAI,SAAS,WAAW;AACtB,aAAO;AAAA,QACL,SAAS,IAAI,iBAAA;AAAA,QACb,YAAY;AAAA,UACV,MAAM;AAAA,UACN,MAAM;AAAA,UACN,SAAS;AAAA,QAAA;AAAA,MACX;AAAA,IAEJ;AAGA,UAAM,UAAU,oBAAoB,MAAA;AACpC,QAAI,QAAQ,WAAW;AACrB,aAAO;AAAA,QACL,SAAS,IAAI,oBAAA;AAAA,QACb,YAAY;AAAA,UACV,MAAM;AAAA,UACN,MAAM;AAAA,UACN,SAAS;AAAA,UACT,OAAO,SAAS;AAAA,QAAA;AAAA,MAClB;AAAA,IAEJ;AAGA,UAAM,kBACJ,SAAS,OAAO,SAAS,mBACzB,QAAQ,OAAO,SAAS;AAC1B,UAAM,eACJ,SAAS,OAAO,SAAS,wBACzB,QAAQ,OAAO,SAAS;AAE1B,QAAI;AACJ,QAAI;AAEJ,QAAI,iBAAiB;AACnB,aAAO;AACP,gBAAU;AAAA,IACZ,WAAW,cAAc;AACvB,aAAO;AACP,gBAAU;AAAA,IACZ,OAAO;AACL,aAAO;AACP,gBAAU;AAAA,IACZ;AAEA,WAAO;AAAA,MACL,SAAS;AAAA,MACT,YAAY;AAAA,QACV;AAAA,QACA,MAAM;AAAA,QACN;AAAA,QACA,OAAO,SAAS,SAAS,QAAQ;AAAA,MAAA;AAAA,IACnC;AAAA,EAEJ;AAAA,EAEQ,uBAAuC;AAC7C,QAAI,KAAK,OAAO,gBAAgB;AAC9B,aAAO,KAAK,OAAO;AAAA,IACrB;AAEA,QAAI,eAAe,eAAe;AAChC,aAAO,IAAI,eAAA;AAAA,IACb,WAAW,uBAAuB,eAAe;AAC/C,aAAO,IAAI,uBAAA;AAAA,IACb,OAAO;AAEL,aAAO;AAAA,QACL,mBAAmB,MAAM,QAAQ,QAAQ,IAAI;AAAA,QAC7C,mBAAmB,MAAM;AAAA,QAAC;AAAA,QAC1B,UAAU,MAAM;AAAA,QAChB,oBAAoB,MAAM,MAAM;AAAA,QAAC;AAAA,MAAA;AAAA,IAErC;AAAA,EACF;AAAA,EAEQ,sBAA4B;AAElC,QAAI,KAAK,gBAAgB;AACvB,WAAK,wBAAwB,KAAK,eAAe;AAAA,QAC/C,CAAC,aAAa;AACZ,eAAK,gBAAgB;AAErB,cAAI,KAAK,OAAO,oBAAoB;AAClC,iBAAK,OAAO,mBAAmB,QAAQ;AAAA,UACzC;AAEA,cAAI,UAAU;AACZ,iBAAK,0BAAA;AAAA,UACP;AAAA,QACF;AAAA,MAAA;AAAA,IAEJ;AAEA,SAAK,oBAAoB,KAAK,eAAe,UAAU,MAAM;AAC3D,UAAI,KAAK,oBAAoB,KAAK,UAAU;AAE1C,aAAK,SAAS,iBAAA;AACd,aAAK,SAAS,WAAA,EAAa,MAAM,CAAC,UAAU;AAC1C,kBAAQ;AAAA,YACN;AAAA,YACA;AAAA,UAAA;AAAA,QAEJ,CAAC;AAAA,MACH;AAAA,IACF,CAAC;AAAA,EACH;AAAA,EAEA,MAAc,aAA4B;AACxC,WAAO,SAAS,uBAAuB,CAAA,GAAI,OAAO,SAAS;AACzD,UAAI;AAEF,cAAM,EAAE,SAAS,WAAA,IAAe,MAAM,KAAK,cAAA;AAGzC,aAAa,UAAU;AACvB,aAAa,oBAAoB;AACjC,aAAa,OAAO,WAAW;AAEjC,aAAK,aAAa,gBAAgB,WAAW,IAAI;AACjD,aAAK,aAAa,gBAAgB,WAAW,IAAI;AAEjD,YAAI,CAAC,SAAS;AAEZ,cAAI,KAAK,OAAO,kBAAkB;AAChC,iBAAK,OAAO,iBAAiB,UAAU;AAAA,UACzC;AACA,eAAK,aAAa,UAAU,aAAa;AACzC,eAAK,YAAA;AACL;AAAA,QACF;AAGA,aAAK,SAAS,IAAI,cAAc,SAAS,KAAK,OAAO,WAAW;AAChE,aAAK,WAAW,IAAI;AAAA,UAClB,KAAK;AAAA,UACL,KAAK;AAAA,UACL,KAAK;AAAA,UACL;AAAA,QAAA;AAEF,aAAK,iBAAiB,KAAK,qBAAA;AAG3B,cAAM,WAAW,MAAM,KAAK,eAAe,kBAAA;AAC3C,aAAK,aAAa,YAAY,QAAQ;AAItC,aAAK,oBAAA;AAEL,YAAI,UAAU;AACZ,gBAAM,KAAK,0BAAA;AAAA,QACb;AACA,aAAK,aAAa,UAAU,iBAAiB;AAC7C,aAAK,YAAA;AAAA,MACP,SAAS,OAAO;AACd,gBAAQ,KAAK,0CAA0C,KAAK;AAC5D,aAAK,aAAa,UAAU,QAAQ;AACpC,aAAK;AAAA,UACH,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC;AAAA,QAAA;AAAA,MAE5D;AAAA,IACF,CAAC;AAAA,EACH;AAAA,EAEA,MAAc,4BAA2C;AACvD,QAAI,CAAC,KAAK,UAAU;AAClB;AAAA,IACF;AAEA,QAAI;AACF,YAAM,KAAK,SAAS,wBAAA;AACpB,YAAM,KAAK,SAAS,WAAA;AAAA,IACtB,SAAS,OAAO;AACd,cAAQ,KAAK,2CAA2C,KAAK;AAAA,IAC/D;AAAA,EACF;AAAA,EAEA,IAAI,mBAA4B;AAC9B,WAAO,KAAK,SAAS,aAAa,KAAK;AAAA,EACzC;AAAA,EAEA,yBACE,SACqC;AACrC,UAAM,aAAa,KAAK,OAAO,YAAY,QAAQ,cAAc;AAEjE,QAAI,CAAC,YAAY;AACf,YAAM,IAAI,MAAM,8BAA8B,QAAQ,cAAc,EAAE;AAAA,IACxE;AAGA,QAAI,CAAC,KAAK,kBAAkB;AAG1B,aAAO,kBAAkB;AAAA,QACvB,YAAY,QAAQ,cAAc;AAAA,QAClC,YAAY,CAAC,WACX,WAAW;AAAA,UACT,GAAG;AAAA,UACH,gBAAgB,QAAQ,kBAAkB,OAAO,WAAA;AAAA,QAAW,CAC7D;AAAA,QACH,UAAU,QAAQ;AAAA,MAAA,CACnB;AAAA,IACH;AAGA,WAAO,IAAIA;AAAAA,MACT;AAAA,MACA;AAAA,MACA,KAAK,mBAAmB,KAAK,IAAI;AAAA,MACjC;AAAA,IAAA;AAAA,EAEJ;AAAA,EAEA,oBAAuB,SAAwC;AAC7D,UAAM,aAAa,KAAK,OAAO,YAAY,QAAQ,cAAc;AAEjE,QAAI,CAAC,YAAY;AACf,YAAM,IAAI,MAAM,8BAA8B,QAAQ,cAAc,EAAE;AAAA,IACxE;AAGA,WAAO,CAAC,cAAiB;AAEvB,UAAI,CAAC,KAAK,kBAAkB;AAE1B,cAAMC,UAAS,uBAAuB;AAAA,UACpC,YAAY,CAAC,MAAM,WACjB,WAAW;AAAA,YACT,GAAG;AAAA,YACH,GAAG;AAAA,YACH,gBAAgB,OAAO,WAAA;AAAA,UAAW,CACnC;AAAA,UACH,UAAU,QAAQ;AAAA,QAAA,CACnB;AACD,eAAOA,QAAO,SAAS;AAAA,MACzB;AAGA,YAAM,SAAS;AAAA,QACb;AAAA,QACA;AAAA,QACA,KAAK,mBAAmB,KAAK,IAAI;AAAA,QACjC;AAAA,MAAA;AAEF,aAAO,OAAO,SAAS;AAAA,IACzB;AAAA,EACF;AAAA,EAEA,MAAc,mBACZ,aACe;AAEf,UAAM,KAAK;AAEX,WAAO;AAAA,MACL;AAAA,MACA;AAAA,QACE,kBAAkB,YAAY;AAAA,QAC9B,8BAA8B,YAAY;AAAA,MAAA;AAAA,MAE5C,OAAO,SAAS;AACd,YAAI,CAAC,KAAK,oBAAoB,CAAC,KAAK,UAAU,CAAC,KAAK,UAAU;AAC5D,eAAK,aAAa,UAAU,oBAAoB;AAChD,eAAK,mBAAmB,YAAY,IAAI,MAAS;AACjD;AAAA,QACF;AAEA,YAAI;AACF,gBAAM,KAAK,OAAO,IAAI,WAAW;AACjC,gBAAM,KAAK,SAAS,QAAQ,WAAW;AACvC,eAAK,aAAa,UAAU,WAAW;AAAA,QACzC,SAAS,OAAO;AACd,kBAAQ;AAAA,YACN,yCAAyC,YAAY,EAAE;AAAA,YACvD;AAAA,UAAA;AAEF,eAAK,aAAa,UAAU,QAAQ;AACpC,gBAAM;AAAA,QACR;AAAA,MACF;AAAA,IAAA;AAAA,EAEJ;AAAA;AAAA,EAGA,MAAM,6BAA6B,eAAqC;AACtE,UAAM,WAAW,KAAK,2BAA2B,IAAI,aAAa;AAClE,QAAI,UAAU;AACZ,aAAO,SAAS;AAAA,IAClB;AAEA,UAAM,WAIF,CAAA;AAEJ,aAAS,UAAU,IAAI,QAAQ,CAAC,SAAS,WAAW;AAClD,eAAS,UAAU;AACnB,eAAS,SAAS;AAAA,IACpB,CAAC;AAED,SAAK,2BAA2B,IAAI,eAAe,QAAQ;AAC3D,WAAO,SAAS;AAAA,EAClB;AAAA;AAAA,EAGA,mBAAmB,eAAuB,QAAmB;AAC3D,UAAM,WAAW,KAAK,2BAA2B,IAAI,aAAa;AAClE,QAAI,UAAU;AACZ,eAAS,QAAQ,MAAM;AACvB,WAAK,2BAA2B,OAAO,aAAa;AAAA,IACtD;AAAA,EACF;AAAA;AAAA,EAGA,kBAAkB,eAAuB,OAAoB;AAC3D,UAAM,WAAW,KAAK,2BAA2B,IAAI,aAAa;AAClE,QAAI,UAAU;AACZ,eAAS,OAAO,KAAK;AACrB,WAAK,2BAA2B,OAAO,aAAa;AAAA,IACtD;AAAA,EACF;AAAA,EAEA,MAAM,iBAAiB,IAA2B;AAChD,QAAI,CAAC,KAAK,QAAQ;AAChB;AAAA,IACF;AACA,UAAM,KAAK,OAAO,OAAO,EAAE;AAAA,EAC7B;AAAA,EAEA,MAAM,aAAiD;AACrD,QAAI,CAAC,KAAK,QAAQ;AAChB,aAAO,CAAA;AAAA,IACT;AACA,WAAO,KAAK,OAAO,OAAA;AAAA,EACrB;AAAA,EAEA,MAAM,cAA6B;AACjC,QAAI,CAAC,KAAK,UAAU,CAAC,KAAK,UAAU;AAClC;AAAA,IACF;AACA,UAAM,KAAK,OAAO,MAAA;AAClB,SAAK,SAAS,MAAA;AAAA,EAChB;AAAA,EAEA,eAAqB;AACnB,SAAK,eAAe,aAAA;AAAA,EACtB;AAAA,EAEA,kBAA0B;AACxB,QAAI,CAAC,KAAK,UAAU;AAClB,aAAO;AAAA,IACT;AACA,WAAO,KAAK,SAAS,gBAAA;AAAA,EACvB;AAAA,EAEA,kBAA0B;AACxB,QAAI,CAAC,KAAK,UAAU;AAClB,aAAO;AAAA,IACT;AACA,WAAO,KAAK,SAAS,gBAAA;AAAA,EACvB;AAAA,EAEA,oBAA2C;AACzC,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,UAAgB;AACd,QAAI,KAAK,mBAAmB;AAC1B,WAAK,kBAAA;AACL,WAAK,oBAAoB;AAAA,IAC3B;AAEA,QAAI,KAAK,uBAAuB;AAC9B,WAAK,sBAAA;AACL,WAAK,wBAAwB;AAAA,IAC/B;AAEA,QAAI,KAAK,gBAAgB;AACvB,WAAK,eAAe,kBAAA;AAEpB,UAAI,aAAa,KAAK,gBAAgB;AAClC,aAAK,eAAuB,QAAA;AAAA,MAChC;AAAA,IACF;AAEA,SAAK,eAAe,QAAA;AAAA,EACtB;AACF;AAEO,SAAS,qBAAqB,QAAwC;AAC3E,SAAO,IAAI,gBAAgB,MAAM;AACnC;"}

package/dist/esm/api/OfflineAction.js

@@ -1,5 +1,9 @@
 import { trace, context, SpanStatusCode } from "@opentelemetry/api";
+import { OnMutateMustBeSynchronousError } from "@tanstack/db";
 import { OfflineTransaction } from "./OfflineTransaction.js";
+function isPromiseLike(value) {
+  return !!value && (typeof value === `object` || typeof value === `function`) && typeof value.then === `function`;
+}
 function createOfflineAction(options, mutationFn, persistTransaction, executor) {
   const { mutationFnName, onMutate } = options;
   console.log(`createOfflineAction 2`, options);
@@ -15,7 +19,10 @@ function createOfflineAction(options, mutationFn, persistTransaction, executor)
     );
     const transaction = offlineTransaction.mutate(() => {
       console.log(`mutate`);
-      onMutate(variables);
+      const maybePromise = onMutate(variables);
+      if (isPromiseLike(maybePromise)) {
+        throw new OnMutateMustBeSynchronousError();
+      }
     });
     const tracer = trace.getTracer(`@tanstack/offline-transactions`, `0.0.1`);
     const span = tracer.startSpan(`offlineAction.${mutationFnName}`);

package/dist/esm/api/OfflineAction.js.map

@@ -1 +1 @@
-{"version":3,"file":"OfflineAction.js","sources":["../../../src/api/OfflineAction.ts"],"sourcesContent":["import { SpanStatusCode, context, trace } from \"@opentelemetry/api\"\nimport { OfflineTransaction } from \"./OfflineTransaction\"\nimport type { Transaction } from \"@tanstack/db\"\nimport type {\n  CreateOfflineActionOptions,\n  OfflineMutationFn,\n  OfflineTransaction as OfflineTransactionType,\n} from \"../types\"\n\nexport function createOfflineAction<T>(\n  options: CreateOfflineActionOptions<T>,\n  mutationFn: OfflineMutationFn,\n  persistTransaction: (tx: OfflineTransactionType) => Promise<void>,\n  executor: any\n): (variables: T) => Transaction {\n  const { mutationFnName, onMutate } = options\n  console.log(`createOfflineAction 2`, options)\n\n  return (variables: T): Transaction => {\n    const offlineTransaction = new OfflineTransaction(\n      {\n        mutationFnName,\n        autoCommit: false,\n      },\n      mutationFn,\n      persistTransaction,\n      executor\n    )\n\n    const transaction = offlineTransaction.mutate(() => {\n      console.log(`mutate`)\n      onMutate(variables)\n    })\n\n    // Immediately commit with span instrumentation\n    const tracer = trace.getTracer(`@tanstack/offline-transactions`, `0.0.1`)\n    const span = tracer.startSpan(`offlineAction.${mutationFnName}`)\n    const ctx = trace.setSpan(context.active(), span)\n    console.log(`starting offlineAction span`, { tracer, span, ctx })\n\n    // Execute the commit within the span context\n    // The key is to return the promise synchronously from context.with() so context binds to it\n    const commitPromise = context.with(ctx, () => {\n      // Return the promise synchronously - this is critical for context propagation in browsers\n      return (async () => {\n        try {\n          await transaction.commit()\n          span.setStatus({ code: SpanStatusCode.OK })\n          span.end()\n          console.log(`ended offlineAction span - success`)\n        } catch (error) {\n          span.recordException(error as Error)\n          span.setStatus({ code: SpanStatusCode.ERROR })\n          span.end()\n          console.log(`ended offlineAction span - error`)\n        }\n      })()\n    })\n\n    // Don't await - this is fire-and-forget for optimistic actions\n    // But catch to prevent unhandled rejection\n    commitPromise.catch(() => {\n      // Already handled in try/catch above\n    })\n\n    return transaction\n  }\n}\n"],"names":[],"mappings":";;AASO,SAAS,oBACd,SACA,YACA,oBACA,UAC+B;AAC/B,QAAM,EAAE,gBAAgB,SAAA,IAAa;AACrC,UAAQ,IAAI,yBAAyB,OAAO;AAE5C,SAAO,CAAC,cAA8B;AACpC,UAAM,qBAAqB,IAAI;AAAA,MAC7B;AAAA,QACE;AAAA,QACA,YAAY;AAAA,MAAA;AAAA,MAEd;AAAA,MACA;AAAA,MACA;AAAA,IAAA;AAGF,UAAM,cAAc,mBAAmB,OAAO,MAAM;AAClD,cAAQ,IAAI,QAAQ;AACpB,eAAS,SAAS;AAAA,IACpB,CAAC;AAGD,UAAM,SAAS,MAAM,UAAU,kCAAkC,OAAO;AACxE,UAAM,OAAO,OAAO,UAAU,iBAAiB,cAAc,EAAE;AAC/D,UAAM,MAAM,MAAM,QAAQ,QAAQ,OAAA,GAAU,IAAI;AAChD,YAAQ,IAAI,+BAA+B,EAAE,QAAQ,MAAM,KAAK;AAIhE,UAAM,gBAAgB,QAAQ,KAAK,KAAK,MAAM;AAE5C,cAAQ,YAAY;AAClB,YAAI;AACF,gBAAM,YAAY,OAAA;AAClB,eAAK,UAAU,EAAE,MAAM,eAAe,IAAI;AAC1C,eAAK,IAAA;AACL,kBAAQ,IAAI,oCAAoC;AAAA,QAClD,SAAS,OAAO;AACd,eAAK,gBAAgB,KAAc;AACnC,eAAK,UAAU,EAAE,MAAM,eAAe,OAAO;AAC7C,eAAK,IAAA;AACL,kBAAQ,IAAI,kCAAkC;AAAA,QAChD;AAAA,MACF,GAAA;AAAA,IACF,CAAC;AAID,kBAAc,MAAM,MAAM;AAAA,IAE1B,CAAC;AAED,WAAO;AAAA,EACT;AACF;"}
+{"version":3,"file":"OfflineAction.js","sources":["../../../src/api/OfflineAction.ts"],"sourcesContent":["import { SpanStatusCode, context, trace } from \"@opentelemetry/api\"\nimport { OnMutateMustBeSynchronousError } from \"@tanstack/db\"\nimport { OfflineTransaction } from \"./OfflineTransaction\"\nimport type { Transaction } from \"@tanstack/db\"\nimport type {\n  CreateOfflineActionOptions,\n  OfflineMutationFn,\n  OfflineTransaction as OfflineTransactionType,\n} from \"../types\"\n\nfunction isPromiseLike(value: unknown): value is PromiseLike<unknown> {\n  return (\n    !!value &&\n    (typeof value === `object` || typeof value === `function`) &&\n    typeof (value as { then?: unknown }).then === `function`\n  )\n}\n\nexport function createOfflineAction<T>(\n  options: CreateOfflineActionOptions<T>,\n  mutationFn: OfflineMutationFn,\n  persistTransaction: (tx: OfflineTransactionType) => Promise<void>,\n  executor: any\n): (variables: T) => Transaction {\n  const { mutationFnName, onMutate } = options\n  console.log(`createOfflineAction 2`, options)\n\n  return (variables: T): Transaction => {\n    const offlineTransaction = new OfflineTransaction(\n      {\n        mutationFnName,\n        autoCommit: false,\n      },\n      mutationFn,\n      persistTransaction,\n      executor\n    )\n\n    const transaction = offlineTransaction.mutate(() => {\n      console.log(`mutate`)\n      const maybePromise = onMutate(variables) as unknown\n\n      if (isPromiseLike(maybePromise)) {\n        throw new OnMutateMustBeSynchronousError()\n      }\n    })\n\n    // Immediately commit with span instrumentation\n    const tracer = trace.getTracer(`@tanstack/offline-transactions`, `0.0.1`)\n    const span = tracer.startSpan(`offlineAction.${mutationFnName}`)\n    const ctx = trace.setSpan(context.active(), span)\n    console.log(`starting offlineAction span`, { tracer, span, ctx })\n\n    // Execute the commit within the span context\n    // The key is to return the promise synchronously from context.with() so context binds to it\n    const commitPromise = context.with(ctx, () => {\n      // Return the promise synchronously - this is critical for context propagation in browsers\n      return (async () => {\n        try {\n          await transaction.commit()\n          span.setStatus({ code: SpanStatusCode.OK })\n          span.end()\n          console.log(`ended offlineAction span - success`)\n        } catch (error) {\n          span.recordException(error as Error)\n          span.setStatus({ code: SpanStatusCode.ERROR })\n          span.end()\n          console.log(`ended offlineAction span - error`)\n        }\n      })()\n    })\n\n    // Don't await - this is fire-and-forget for optimistic actions\n    // But catch to prevent unhandled rejection\n    commitPromise.catch(() => {\n      // Already handled in try/catch above\n    })\n\n    return transaction\n  }\n}\n"],"names":[],"mappings":";;;AAUA,SAAS,cAAc,OAA+C;AACpE,SACE,CAAC,CAAC,UACD,OAAO,UAAU,YAAY,OAAO,UAAU,eAC/C,OAAQ,MAA6B,SAAS;AAElD;AAEO,SAAS,oBACd,SACA,YACA,oBACA,UAC+B;AAC/B,QAAM,EAAE,gBAAgB,SAAA,IAAa;AACrC,UAAQ,IAAI,yBAAyB,OAAO;AAE5C,SAAO,CAAC,cAA8B;AACpC,UAAM,qBAAqB,IAAI;AAAA,MAC7B;AAAA,QACE;AAAA,QACA,YAAY;AAAA,MAAA;AAAA,MAEd;AAAA,MACA;AAAA,MACA;AAAA,IAAA;AAGF,UAAM,cAAc,mBAAmB,OAAO,MAAM;AAClD,cAAQ,IAAI,QAAQ;AACpB,YAAM,eAAe,SAAS,SAAS;AAEvC,UAAI,cAAc,YAAY,GAAG;AAC/B,cAAM,IAAI,+BAAA;AAAA,MACZ;AAAA,IACF,CAAC;AAGD,UAAM,SAAS,MAAM,UAAU,kCAAkC,OAAO;AACxE,UAAM,OAAO,OAAO,UAAU,iBAAiB,cAAc,EAAE;AAC/D,UAAM,MAAM,MAAM,QAAQ,QAAQ,OAAA,GAAU,IAAI;AAChD,YAAQ,IAAI,+BAA+B,EAAE,QAAQ,MAAM,KAAK;AAIhE,UAAM,gBAAgB,QAAQ,KAAK,KAAK,MAAM;AAE5C,cAAQ,YAAY;AAClB,YAAI;AACF,gBAAM,YAAY,OAAA;AAClB,eAAK,UAAU,EAAE,MAAM,eAAe,IAAI;AAC1C,eAAK,IAAA;AACL,kBAAQ,IAAI,oCAAoC;AAAA,QAClD,SAAS,OAAO;AACd,eAAK,gBAAgB,KAAc;AACnC,eAAK,UAAU,EAAE,MAAM,eAAe,OAAO;AAC7C,eAAK,IAAA;AACL,kBAAQ,IAAI,kCAAkC;AAAA,QAChD;AAAA,MACF,GAAA;AAAA,IACF,CAAC;AAID,kBAAc,MAAM,MAAM;AAAA,IAE1B,CAAC;AAED,WAAO;AAAA,EACT;AACF;"}

package/dist/esm/index.d.ts

@@ -1,5 +1,5 @@
 export { OfflineExecutor, startOfflineExecutor } from './OfflineExecutor.js';
-export type { OfflineTransaction, OfflineConfig, StorageAdapter, RetryPolicy, LeaderElection, OnlineDetector, CreateOfflineTransactionOptions, CreateOfflineActionOptions, SerializedError, SerializedMutation, } from './types.js';
+export type { OfflineTransaction, OfflineConfig, OfflineMode, StorageAdapter, StorageDiagnostic, StorageDiagnosticCode, RetryPolicy, LeaderElection, OnlineDetector, CreateOfflineTransactionOptions, CreateOfflineActionOptions, SerializedError, SerializedMutation, } from './types.js';
 export { NonRetriableError } from './types.js';
 export { IndexedDBAdapter } from './storage/IndexedDBAdapter.js';
 export { LocalStorageAdapter } from './storage/LocalStorageAdapter.js';

package/dist/esm/storage/IndexedDBAdapter.d.ts

@@ -4,6 +4,14 @@ export declare class IndexedDBAdapter extends BaseStorageAdapter {
     private storeName;
     private db;
     constructor(dbName?: string, storeName?: string);
+    /**
+     * Probe IndexedDB availability by attempting to open a test database.
+     * This catches private mode and other restrictions that block IndexedDB.
+     */
+    static probe(): Promise<{
+        available: boolean;
+        error?: Error;
+    }>;
     private openDB;
     private getStore;
     get(key: string): Promise<string | null>;

package/dist/esm/storage/IndexedDBAdapter.js

@@ -6,6 +6,45 @@ class IndexedDBAdapter extends BaseStorageAdapter {
     this.dbName = dbName;
     this.storeName = storeName;
   }
+  /**
+   * Probe IndexedDB availability by attempting to open a test database.
+   * This catches private mode and other restrictions that block IndexedDB.
+   */
+  static async probe() {
+    if (typeof indexedDB === `undefined`) {
+      return {
+        available: false,
+        error: new Error(`IndexedDB is not available in this environment`)
+      };
+    }
+    try {
+      const testDbName = `__offline-tx-probe__`;
+      const request = indexedDB.open(testDbName, 1);
+      return new Promise((resolve) => {
+        request.onerror = () => {
+          const error = request.error || new Error(`IndexedDB open failed`);
+          resolve({ available: false, error });
+        };
+        request.onsuccess = () => {
+          const db = request.result;
+          db.close();
+          indexedDB.deleteDatabase(testDbName);
+          resolve({ available: true });
+        };
+        request.onblocked = () => {
+          resolve({
+            available: false,
+            error: new Error(`IndexedDB is blocked`)
+          });
+        };
+      });
+    } catch (error) {
+      return {
+        available: false,
+        error: error instanceof Error ? error : new Error(String(error))
+      };
+    }
+  }
   async openDB() {
     if (this.db) {
       return this.db;

package/dist/esm/storage/IndexedDBAdapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"IndexedDBAdapter.js","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":[],"mappings":"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"}
+{"version":3,"file":"IndexedDBAdapter.js","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  /**\n   * Probe IndexedDB availability by attempting to open a test database.\n   * This catches private mode and other restrictions that block IndexedDB.\n   */\n  static async probe(): Promise<{ available: boolean; error?: Error }> {\n    // Check if IndexedDB exists\n    if (typeof indexedDB === `undefined`) {\n      return {\n        available: false,\n        error: new Error(`IndexedDB is not available in this environment`),\n      }\n    }\n\n    // Try to actually open a test database to verify it works\n    try {\n      const testDbName = `__offline-tx-probe__`\n      const request = indexedDB.open(testDbName, 1)\n\n      return new Promise((resolve) => {\n        request.onerror = () => {\n          const error = request.error || new Error(`IndexedDB open failed`)\n          resolve({ available: false, error })\n        }\n\n        request.onsuccess = () => {\n          // Clean up test database\n          const db = request.result\n          db.close()\n          indexedDB.deleteDatabase(testDbName)\n          resolve({ available: true })\n        }\n\n        request.onblocked = () => {\n          resolve({\n            available: false,\n            error: new Error(`IndexedDB is blocked`),\n          })\n        }\n      })\n    } catch (error) {\n      return {\n        available: false,\n        error: error instanceof Error ? error : new Error(String(error)),\n      }\n    }\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":[],"mappings":"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"}