@arkade-os/boltz-swap 0.3.29 → 0.3.31

package/dist/expo/index.d.cts

@@ -1,75 +1,10 @@
 import { I as IArkadeSwaps, A as ArkadeSwaps, V as VhtlcTimeouts } from '../arkade-swaps-CS8FZSVL.cjs';
-import { A as ArkadeSwapsConfig, m as SwapRepository, p as BoltzSwapProvider, N as Network, n as SwapManagerClient, C as CreateLightningInvoiceRequest, e as CreateLightningInvoiceResponse, S as SendLightningPaymentRequest, f as SendLightningPaymentResponse, c as BoltzSubmarineSwap, b as BoltzReverseSwap, g as SubmarineRefundOutcome, h as SubmarineRecoveryInfo, i as SubmarineRecoveryResult, F as FeesResponse, a as BoltzChainSwap, k as ArkToBtcResponse, l as BtcToArkResponse, d as Chain, j as ChainFeesResponse, L as LimitsResponse, G as GetSwapStatusResponse, B as BoltzSwap } from '../types-BBI7-KJ0.cjs';
-import { Identity, ArkProvider, IndexerProvider, IWallet, ArkInfo, ArkTxInput, VHTLC } from '@arkade-os/sdk';
-import { AsyncStorageTaskQueue, TaskProcessor } from '@arkade-os/sdk/worker/expo';
+import { n as SwapManagerClient, C as CreateLightningInvoiceRequest, e as CreateLightningInvoiceResponse, S as SendLightningPaymentRequest, f as SendLightningPaymentResponse, c as BoltzSubmarineSwap, b as BoltzReverseSwap, g as SubmarineRefundOutcome, h as SubmarineRecoveryInfo, i as SubmarineRecoveryResult, F as FeesResponse, a as BoltzChainSwap, k as ArkToBtcResponse, l as BtcToArkResponse, d as Chain, j as ChainFeesResponse, L as LimitsResponse, G as GetSwapStatusResponse, B as BoltzSwap } from '../types-BBI7-KJ0.cjs';
+import { E as ExpoArkadeSwapsConfig } from '../swapsPollProcessor-BF3uTFae.cjs';
+export { D as DefineSwapBackgroundTaskOptions, c as ExpoArkadeLightningConfig, b as ExpoSwapBackgroundConfig, P as PersistedSwapBackgroundConfig, S as SWAP_POLL_TASK_TYPE, a as SwapTaskDependencies } from '../swapsPollProcessor-BF3uTFae.cjs';
+import { ArkInfo, Identity, ArkTxInput, VHTLC } from '@arkade-os/sdk';
 import { TransactionOutput } from '@scure/btc-signer/psbt.js';
-
-/**
- * Dependencies injected into every swap processor at runtime.
- *
- * Unlike the wallet's `TaskDependencies`, these are swap-specific:
- * we need the Boltz provider, swap repository, and identity to
- * poll status and attempt claim/refund.
- */
-interface SwapTaskDependencies {
-    swapRepository: SwapRepository;
-    swapProvider: BoltzSwapProvider;
-    arkProvider: ArkProvider;
-    indexerProvider: IndexerProvider;
-    identity: Identity;
-    wallet: IWallet;
-}
-/**
- * Minimal config persisted to AsyncStorage for background rehydration.
- *
- * The background handler runs in a fresh JS context without access to
- * the foreground's in-memory state, so we persist just enough to
- * reconstruct providers and identity.
- */
-interface PersistedSwapBackgroundConfig {
-    boltzApiUrl: string;
-    arkServerUrl: string;
-    network: Network;
-}
-/**
- * Background scheduling configuration for {@link ExpoArkadeSwaps}.
- */
-interface ExpoSwapBackgroundConfig {
-    /** Identifier registered with expo-background-task. */
-    taskName: string;
-    /** Persistence layer for foreground ↔ background handoff. */
-    taskQueue: AsyncStorageTaskQueue;
-    /** If set, acknowledges background results at this interval (ms) while the app is in the foreground. */
-    foregroundIntervalMs?: number;
-    /** If set, registers the background task with the OS at this interval (minutes, min 15). */
-    minimumBackgroundInterval?: number;
-}
-/**
- * Options for {@link defineExpoSwapBackgroundTask}.
- */
-interface DefineSwapBackgroundTaskOptions {
-    /** AsyncStorage-backed queue (must match the one passed to ExpoArkadeSwaps.setup). */
-    taskQueue: AsyncStorageTaskQueue;
-    /** Swap repository (fresh instance is fine — connects to the same DB). */
-    swapRepository: SwapRepository;
-    /** Factory to reconstruct Identity from secure storage in the background. */
-    identityFactory: () => Promise<Identity>;
-}
-/**
- * Configuration for {@link ExpoArkadeSwaps.setup}.
- */
-interface ExpoArkadeSwapsConfig extends ArkadeSwapsConfig {
-    /**
-     * Ark server base URL (e.g. "https://ark.example.com").
-     *
-     * Recommended for type-safe background rehydration. If omitted,
-     * ExpoArkadeSwaps will attempt to derive it from the ArkProvider.
-     */
-    arkServerUrl?: string;
-    background: ExpoSwapBackgroundConfig;
-}
-/** @deprecated Use ExpoArkadeSwapsConfig instead */
-type ExpoArkadeLightningConfig = ExpoArkadeSwapsConfig;
+import '@arkade-os/sdk/worker/expo';
 
 /**
  * Expo/React Native wrapper for ArkadeSwaps with background task support.
@@ -86,21 +21,31 @@ type ExpoArkadeLightningConfig = ExpoArkadeSwapsConfig;
  * acknowledges background outbox results and re-seeds the task queue
  * for the next background wake.
  *
+ * OS-level task registration is the consumer's responsibility — call
+ * `registerExpoSwapBackgroundTask` from
+ * `@arkade-os/boltz-swap/expo/background` after `setup()`. Keeping
+ * registration out of `setup()` lets this entrypoint avoid pulling
+ * `expo-task-manager` / `expo-background-task` into the `/expo` bundle.
+ *
  * @example
  * ```ts
+ * import { ExpoArkadeSwaps } from "@arkade-os/boltz-swap/expo";
+ * import { registerExpoSwapBackgroundTask } from "@arkade-os/boltz-swap/expo/background";
+ *
  * const arkSwaps = await ExpoArkadeSwaps.setup({
  *     wallet,
  *     arkServerUrl: "https://ark.example.com",
  *     swapProvider,
  *     swapManager: true,
  *     background: {
- *         taskName: "ark-swap-poll",
  *         taskQueue: swapTaskQueue,
  *         foregroundIntervalMs: 20_000,
- *         minimumBackgroundInterval: 15,
  *     },
  * });
  *
+ * // Activate the OS scheduler (Expo Android/iOS only)
+ * await registerExpoSwapBackgroundTask("ark-swap-poll", { minimumInterval: 15 });
+ *
  * await arkSwaps.createLightningInvoice({ amount: 1000 });
  * ```
  */
@@ -109,16 +54,18 @@ declare class ExpoArkadeSwaps implements IArkadeSwaps {
     private readonly config;
     readonly swapRepository: ArkadeSwaps["swapRepository"];
     private foregroundIntervalId?;
-    private readonly taskName;
     private constructor();
     /**
-     * Create an ExpoArkadeSwaps with background task support.
+     * Create an ExpoArkadeSwaps with foreground/background queue handoff.
      *
      * 1. Creates the inner {@link ArkadeSwaps} with SwapManager enabled.
      * 2. Persists {@link PersistedSwapBackgroundConfig} for background rehydration.
      * 3. Seeds the task queue with a swap-poll task.
-     * 4. Registers the background task with the OS scheduler (if configured).
-     * 5. Starts foreground interval (if configured).
+     * 4. Starts the foreground interval (if configured).
+     *
+     * OS-level scheduling lives in
+     * `@arkade-os/boltz-swap/expo/background` and is invoked separately
+     * by the consumer.
      */
     static setup(config: ExpoArkadeSwapsConfig): Promise<ExpoArkadeSwaps>;
     private startForegroundPolling;
@@ -224,67 +171,4 @@ declare class ExpoArkadeSwaps implements IArkadeSwaps {
 /** @deprecated Use ExpoArkadeSwaps instead */
 declare const ExpoArkadeLightning: typeof ExpoArkadeSwaps;
 
-/**
- * Define the Expo background task handler for swap polling.
- *
- * **Must be called at module/global scope** (before React mounts).
- * Internally calls `TaskManager.defineTask()`.
- *
- * @example
- * ```ts
- * // At the top of your app entry file (_layout.tsx)
- * import { defineExpoSwapBackgroundTask } from "@arkade-os/boltz-swap/expo";
- * import { AsyncStorageTaskQueue } from "@arkade-os/sdk/worker/expo";
- * import AsyncStorage from "@react-native-async-storage/async-storage";
- *
- * const taskQueue = new AsyncStorageTaskQueue(AsyncStorage, "ark:swap-queue");
- * defineExpoSwapBackgroundTask("ark-swap-poll", {
- *     taskQueue,
- *     swapRepository,
- *     identityFactory: async () => {
- *         const key = await SecureStore.getItemAsync("ark-private-key");
- *         return SingleKey.fromHex(key!);
- *     },
- * });
- * ```
- */
-declare function defineExpoSwapBackgroundTask(taskName: string, options: DefineSwapBackgroundTaskOptions): void;
-/**
- * Activate the OS-level background task scheduler.
- *
- * Call this after {@link defineExpoSwapBackgroundTask} (typically inside
- * {@link ExpoArkadeSwaps.setup}).
- *
- * @param taskName - The task name registered with defineExpoSwapBackgroundTask.
- * @param options - Optional configuration.
- * @param options.minimumInterval - Minimum interval in minutes (default 15).
- */
-declare function registerExpoSwapBackgroundTask(taskName: string, options?: {
-    minimumInterval?: number;
-}): Promise<void>;
-/**
- * Unregister the swap background task from the OS scheduler.
- */
-declare function unregisterExpoSwapBackgroundTask(taskName: string): Promise<void>;
-
-/**
- * Task type identifier for {@link swapsPollProcessor}.
- */
-declare const SWAP_POLL_TASK_TYPE = "swap-poll";
-/**
- * Stateless processor that polls Boltz for swap status updates and
- * attempts best-effort claim/refund for actionable swaps.
- *
- * Designed for Expo background tasks (~30s window) and follows the
- * same `TaskProcessor` pattern as `contractPollProcessor` in ts-sdk.
- *
- * Steps:
- * 1. Read all non-final swaps from SwapRepository
- * 2. Poll Boltz HTTP API for each swap's current status
- * 3. Persist status changes immediately
- * 4. For actionable statuses: attempt claimVHTLC / refundVHTLC (best-effort)
- * 5. Return summary metrics
- */
-declare const swapsPollProcessor: TaskProcessor<SwapTaskDependencies>;
-
-export { type DefineSwapBackgroundTaskOptions, ExpoArkadeLightning, type ExpoArkadeLightningConfig, ExpoArkadeSwaps, type ExpoArkadeSwapsConfig, type ExpoSwapBackgroundConfig, type PersistedSwapBackgroundConfig, SWAP_POLL_TASK_TYPE, type SwapTaskDependencies, defineExpoSwapBackgroundTask, registerExpoSwapBackgroundTask, swapsPollProcessor, unregisterExpoSwapBackgroundTask };
+export { ExpoArkadeLightning, ExpoArkadeSwaps, ExpoArkadeSwapsConfig };

package/dist/expo/index.d.ts

@@ -1,75 +1,10 @@
 import { I as IArkadeSwaps, A as ArkadeSwaps, V as VhtlcTimeouts } from '../arkade-swaps-WiKCanCL.js';
-import { A as ArkadeSwapsConfig, m as SwapRepository, p as BoltzSwapProvider, N as Network, n as SwapManagerClient, C as CreateLightningInvoiceRequest, e as CreateLightningInvoiceResponse, S as SendLightningPaymentRequest, f as SendLightningPaymentResponse, c as BoltzSubmarineSwap, b as BoltzReverseSwap, g as SubmarineRefundOutcome, h as SubmarineRecoveryInfo, i as SubmarineRecoveryResult, F as FeesResponse, a as BoltzChainSwap, k as ArkToBtcResponse, l as BtcToArkResponse, d as Chain, j as ChainFeesResponse, L as LimitsResponse, G as GetSwapStatusResponse, B as BoltzSwap } from '../types-BBI7-KJ0.js';
-import { Identity, ArkProvider, IndexerProvider, IWallet, ArkInfo, ArkTxInput, VHTLC } from '@arkade-os/sdk';
-import { AsyncStorageTaskQueue, TaskProcessor } from '@arkade-os/sdk/worker/expo';
+import { n as SwapManagerClient, C as CreateLightningInvoiceRequest, e as CreateLightningInvoiceResponse, S as SendLightningPaymentRequest, f as SendLightningPaymentResponse, c as BoltzSubmarineSwap, b as BoltzReverseSwap, g as SubmarineRefundOutcome, h as SubmarineRecoveryInfo, i as SubmarineRecoveryResult, F as FeesResponse, a as BoltzChainSwap, k as ArkToBtcResponse, l as BtcToArkResponse, d as Chain, j as ChainFeesResponse, L as LimitsResponse, G as GetSwapStatusResponse, B as BoltzSwap } from '../types-BBI7-KJ0.js';
+import { E as ExpoArkadeSwapsConfig } from '../swapsPollProcessor-wYOMzldd.js';
+export { D as DefineSwapBackgroundTaskOptions, c as ExpoArkadeLightningConfig, b as ExpoSwapBackgroundConfig, P as PersistedSwapBackgroundConfig, S as SWAP_POLL_TASK_TYPE, a as SwapTaskDependencies } from '../swapsPollProcessor-wYOMzldd.js';
+import { ArkInfo, Identity, ArkTxInput, VHTLC } from '@arkade-os/sdk';
 import { TransactionOutput } from '@scure/btc-signer/psbt.js';
-
-/**
- * Dependencies injected into every swap processor at runtime.
- *
- * Unlike the wallet's `TaskDependencies`, these are swap-specific:
- * we need the Boltz provider, swap repository, and identity to
- * poll status and attempt claim/refund.
- */
-interface SwapTaskDependencies {
-    swapRepository: SwapRepository;
-    swapProvider: BoltzSwapProvider;
-    arkProvider: ArkProvider;
-    indexerProvider: IndexerProvider;
-    identity: Identity;
-    wallet: IWallet;
-}
-/**
- * Minimal config persisted to AsyncStorage for background rehydration.
- *
- * The background handler runs in a fresh JS context without access to
- * the foreground's in-memory state, so we persist just enough to
- * reconstruct providers and identity.
- */
-interface PersistedSwapBackgroundConfig {
-    boltzApiUrl: string;
-    arkServerUrl: string;
-    network: Network;
-}
-/**
- * Background scheduling configuration for {@link ExpoArkadeSwaps}.
- */
-interface ExpoSwapBackgroundConfig {
-    /** Identifier registered with expo-background-task. */
-    taskName: string;
-    /** Persistence layer for foreground ↔ background handoff. */
-    taskQueue: AsyncStorageTaskQueue;
-    /** If set, acknowledges background results at this interval (ms) while the app is in the foreground. */
-    foregroundIntervalMs?: number;
-    /** If set, registers the background task with the OS at this interval (minutes, min 15). */
-    minimumBackgroundInterval?: number;
-}
-/**
- * Options for {@link defineExpoSwapBackgroundTask}.
- */
-interface DefineSwapBackgroundTaskOptions {
-    /** AsyncStorage-backed queue (must match the one passed to ExpoArkadeSwaps.setup). */
-    taskQueue: AsyncStorageTaskQueue;
-    /** Swap repository (fresh instance is fine — connects to the same DB). */
-    swapRepository: SwapRepository;
-    /** Factory to reconstruct Identity from secure storage in the background. */
-    identityFactory: () => Promise<Identity>;
-}
-/**
- * Configuration for {@link ExpoArkadeSwaps.setup}.
- */
-interface ExpoArkadeSwapsConfig extends ArkadeSwapsConfig {
-    /**
-     * Ark server base URL (e.g. "https://ark.example.com").
-     *
-     * Recommended for type-safe background rehydration. If omitted,
-     * ExpoArkadeSwaps will attempt to derive it from the ArkProvider.
-     */
-    arkServerUrl?: string;
-    background: ExpoSwapBackgroundConfig;
-}
-/** @deprecated Use ExpoArkadeSwapsConfig instead */
-type ExpoArkadeLightningConfig = ExpoArkadeSwapsConfig;
+import '@arkade-os/sdk/worker/expo';
 
 /**
  * Expo/React Native wrapper for ArkadeSwaps with background task support.
@@ -86,21 +21,31 @@ type ExpoArkadeLightningConfig = ExpoArkadeSwapsConfig;
  * acknowledges background outbox results and re-seeds the task queue
  * for the next background wake.
  *
+ * OS-level task registration is the consumer's responsibility — call
+ * `registerExpoSwapBackgroundTask` from
+ * `@arkade-os/boltz-swap/expo/background` after `setup()`. Keeping
+ * registration out of `setup()` lets this entrypoint avoid pulling
+ * `expo-task-manager` / `expo-background-task` into the `/expo` bundle.
+ *
  * @example
  * ```ts
+ * import { ExpoArkadeSwaps } from "@arkade-os/boltz-swap/expo";
+ * import { registerExpoSwapBackgroundTask } from "@arkade-os/boltz-swap/expo/background";
+ *
  * const arkSwaps = await ExpoArkadeSwaps.setup({
  *     wallet,
  *     arkServerUrl: "https://ark.example.com",
  *     swapProvider,
  *     swapManager: true,
  *     background: {
- *         taskName: "ark-swap-poll",
  *         taskQueue: swapTaskQueue,
  *         foregroundIntervalMs: 20_000,
- *         minimumBackgroundInterval: 15,
  *     },
  * });
  *
+ * // Activate the OS scheduler (Expo Android/iOS only)
+ * await registerExpoSwapBackgroundTask("ark-swap-poll", { minimumInterval: 15 });
+ *
  * await arkSwaps.createLightningInvoice({ amount: 1000 });
  * ```
  */
@@ -109,16 +54,18 @@ declare class ExpoArkadeSwaps implements IArkadeSwaps {
     private readonly config;
     readonly swapRepository: ArkadeSwaps["swapRepository"];
     private foregroundIntervalId?;
-    private readonly taskName;
     private constructor();
     /**
-     * Create an ExpoArkadeSwaps with background task support.
+     * Create an ExpoArkadeSwaps with foreground/background queue handoff.
      *
      * 1. Creates the inner {@link ArkadeSwaps} with SwapManager enabled.
      * 2. Persists {@link PersistedSwapBackgroundConfig} for background rehydration.
      * 3. Seeds the task queue with a swap-poll task.
-     * 4. Registers the background task with the OS scheduler (if configured).
-     * 5. Starts foreground interval (if configured).
+     * 4. Starts the foreground interval (if configured).
+     *
+     * OS-level scheduling lives in
+     * `@arkade-os/boltz-swap/expo/background` and is invoked separately
+     * by the consumer.
      */
     static setup(config: ExpoArkadeSwapsConfig): Promise<ExpoArkadeSwaps>;
     private startForegroundPolling;
@@ -224,67 +171,4 @@ declare class ExpoArkadeSwaps implements IArkadeSwaps {
 /** @deprecated Use ExpoArkadeSwaps instead */
 declare const ExpoArkadeLightning: typeof ExpoArkadeSwaps;
 
-/**
- * Define the Expo background task handler for swap polling.
- *
- * **Must be called at module/global scope** (before React mounts).
- * Internally calls `TaskManager.defineTask()`.
- *
- * @example
- * ```ts
- * // At the top of your app entry file (_layout.tsx)
- * import { defineExpoSwapBackgroundTask } from "@arkade-os/boltz-swap/expo";
- * import { AsyncStorageTaskQueue } from "@arkade-os/sdk/worker/expo";
- * import AsyncStorage from "@react-native-async-storage/async-storage";
- *
- * const taskQueue = new AsyncStorageTaskQueue(AsyncStorage, "ark:swap-queue");
- * defineExpoSwapBackgroundTask("ark-swap-poll", {
- *     taskQueue,
- *     swapRepository,
- *     identityFactory: async () => {
- *         const key = await SecureStore.getItemAsync("ark-private-key");
- *         return SingleKey.fromHex(key!);
- *     },
- * });
- * ```
- */
-declare function defineExpoSwapBackgroundTask(taskName: string, options: DefineSwapBackgroundTaskOptions): void;
-/**
- * Activate the OS-level background task scheduler.
- *
- * Call this after {@link defineExpoSwapBackgroundTask} (typically inside
- * {@link ExpoArkadeSwaps.setup}).
- *
- * @param taskName - The task name registered with defineExpoSwapBackgroundTask.
- * @param options - Optional configuration.
- * @param options.minimumInterval - Minimum interval in minutes (default 15).
- */
-declare function registerExpoSwapBackgroundTask(taskName: string, options?: {
-    minimumInterval?: number;
-}): Promise<void>;
-/**
- * Unregister the swap background task from the OS scheduler.
- */
-declare function unregisterExpoSwapBackgroundTask(taskName: string): Promise<void>;
-
-/**
- * Task type identifier for {@link swapsPollProcessor}.
- */
-declare const SWAP_POLL_TASK_TYPE = "swap-poll";
-/**
- * Stateless processor that polls Boltz for swap status updates and
- * attempts best-effort claim/refund for actionable swaps.
- *
- * Designed for Expo background tasks (~30s window) and follows the
- * same `TaskProcessor` pattern as `contractPollProcessor` in ts-sdk.
- *
- * Steps:
- * 1. Read all non-final swaps from SwapRepository
- * 2. Poll Boltz HTTP API for each swap's current status
- * 3. Persist status changes immediately
- * 4. For actionable statuses: attempt claimVHTLC / refundVHTLC (best-effort)
- * 5. Return summary metrics
- */
-declare const swapsPollProcessor: TaskProcessor<SwapTaskDependencies>;
-
-export { type DefineSwapBackgroundTaskOptions, ExpoArkadeLightning, type ExpoArkadeLightningConfig, ExpoArkadeSwaps, type ExpoArkadeSwapsConfig, type ExpoSwapBackgroundConfig, type PersistedSwapBackgroundConfig, SWAP_POLL_TASK_TYPE, type SwapTaskDependencies, defineExpoSwapBackgroundTask, registerExpoSwapBackgroundTask, swapsPollProcessor, unregisterExpoSwapBackgroundTask };
+export { ExpoArkadeLightning, ExpoArkadeSwaps, ExpoArkadeSwapsConfig };

package/dist/expo/index.js

@@ -1,39 +1,48 @@
 import {
-  SWAP_POLL_TASK_TYPE,
-  defineExpoSwapBackgroundTask,
-  registerExpoSwapBackgroundTask,
-  swapsPollProcessor,
-  unregisterExpoSwapBackgroundTask
-} from "../chunk-X3JNWDAR.js";
+  SWAP_POLL_TASK_TYPE
+} from "../chunk-NHBWNN6H.js";
 import {
   ArkadeSwaps
-} from "../chunk-LWUXSE5N.js";
-import "../chunk-3RG5ZIWI.js";
+} from "../chunk-B3Q4TFWT.js";
 
 // src/expo/arkade-lightning.ts
 function getRandomId() {
   return Math.random().toString(36).slice(2) + Date.now().toString(36);
 }
+function warnOnRemovedBackgroundFields(bg) {
+  if (!bg || typeof bg !== "object") return;
+  const removed = [];
+  if ("taskName" in bg) removed.push("taskName");
+  if ("minimumBackgroundInterval" in bg) {
+    removed.push("minimumBackgroundInterval");
+  }
+  if (removed.length === 0) return;
+  console.warn(
+    `[boltz-swap] ExpoArkadeSwaps.setup: ignoring removed background field(s): ${removed.join(", ")}. OS-task registration moved to "@arkade-os/boltz-swap/expo/background". See https://github.com/arkade-os/boltz-swap/issues/136`
+  );
+}
 var ExpoArkadeSwaps = class _ExpoArkadeSwaps {
   constructor(inner, config) {
     this.inner = inner;
     this.config = config;
-    this.taskName = config.background.taskName;
     this.swapRepository = inner.swapRepository;
   }
   swapRepository;
   foregroundIntervalId;
-  taskName;
   /**
-   * Create an ExpoArkadeSwaps with background task support.
+   * Create an ExpoArkadeSwaps with foreground/background queue handoff.
    *
    * 1. Creates the inner {@link ArkadeSwaps} with SwapManager enabled.
    * 2. Persists {@link PersistedSwapBackgroundConfig} for background rehydration.
    * 3. Seeds the task queue with a swap-poll task.
-   * 4. Registers the background task with the OS scheduler (if configured).
-   * 5. Starts foreground interval (if configured).
+   * 4. Starts the foreground interval (if configured).
+   *
+   * OS-level scheduling lives in
+   * `@arkade-os/boltz-swap/expo/background` and is invoked separately
+   * by the consumer.
    */
   static async setup(config) {
+    warnOnRemovedBackgroundFields(config.background);
     const inner = new ArkadeSwaps({
       ...config,
       swapManager: config.swapManager ?? true
@@ -54,28 +63,6 @@ var ExpoArkadeSwaps = class _ExpoArkadeSwaps {
     await taskQueue.persistConfig(bgConfig);
     const instance = new _ExpoArkadeSwaps(inner, config);
     await instance.seedSwapPollTask();
-    if (config.background.minimumBackgroundInterval) {
-      try {
-        const { registerExpoSwapBackgroundTask: registerExpoSwapBackgroundTask2 } = await import("../background-UQDFQCGM.js");
-        await registerExpoSwapBackgroundTask2(
-          config.background.taskName,
-          {
-            minimumInterval: config.background.minimumBackgroundInterval
-          }
-        );
-      } catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        const code = typeof err === "object" && err !== null && "code" in err ? err.code : void 0;
-        const codeString = typeof code === "string" ? code : void 0;
-        const isModuleNotFound = codeString === "MODULE_NOT_FOUND" || /cannot find module/i.test(message) || /module not found/i.test(message);
-        if (!isModuleNotFound) {
-          console.warn(
-            `[boltz-swap] Failed to register background task "${config.background.taskName}":`,
-            err
-          );
-        }
-      }
-    }
     if (config.background.foregroundIntervalMs && config.background.foregroundIntervalMs > 0) {
       instance.startForegroundPolling(
         config.background.foregroundIntervalMs
@@ -128,21 +115,6 @@ var ExpoArkadeSwaps = class _ExpoArkadeSwaps {
       this.foregroundIntervalId = void 0;
     }
     await this.inner.dispose();
-    try {
-      const { unregisterExpoSwapBackgroundTask: unregisterExpoSwapBackgroundTask2 } = await import("../background-UQDFQCGM.js");
-      await unregisterExpoSwapBackgroundTask2(this.taskName);
-    } catch (err) {
-      const message = err instanceof Error ? err.message : String(err);
-      const code = typeof err === "object" && err !== null && "code" in err ? err.code : void 0;
-      const codeString = typeof code === "string" ? code : void 0;
-      const isModuleNotFound = codeString === "MODULE_NOT_FOUND" || /cannot find module/i.test(message) || /module not found/i.test(message);
-      if (!isModuleNotFound) {
-        console.warn(
-          `[boltz-swap] Failed to unregister background task "${this.taskName}":`,
-          err
-        );
-      }
-    }
   }
   async [Symbol.asyncDispose]() {
     await this.dispose();
@@ -286,9 +258,5 @@ var ExpoArkadeLightning = ExpoArkadeSwaps;
 export {
   ExpoArkadeLightning,
   ExpoArkadeSwaps,
-  SWAP_POLL_TASK_TYPE,
-  defineExpoSwapBackgroundTask,
-  registerExpoSwapBackgroundTask,
-  swapsPollProcessor,
-  unregisterExpoSwapBackgroundTask
+  SWAP_POLL_TASK_TYPE
 };

package/dist/index.cjs

@@ -430,7 +430,7 @@ var BoltzSwapProvider = class {
   /** @param config Provider configuration with network and optional API URL. */
   constructor(config) {
     this.network = config.network;
-    this.referralId = config.referralId;
+    this.referralId = config.referralId ?? "arkade-ts-sdk";
     const apiUrl = config.apiUrl || BASE_URLS[config.network];
     if (!apiUrl)
       throw new Error(
@@ -5338,6 +5338,13 @@ var ArkadeSwaps = class _ArkadeSwaps {
 // src/serviceWorker/arkade-swaps-message-handler.ts
 var import_sdk9 = require("@arkade-os/sdk");
 var DEFAULT_MESSAGE_TAG = "ARKADE_SWAPS_UPDATER";
+var HANDLER_NOT_INITIALIZED = "ArkadeSwaps handler not initialized";
+var HandlerNotInitializedError = class extends Error {
+  constructor() {
+    super(HANDLER_NOT_INITIALIZED);
+    this.name = "HandlerNotInitializedError";
+  }
+};
 var LONG_RUNNING_ARKADE_SWAPS_REQUEST_TYPES = /* @__PURE__ */ new Set([
   "SEND_LIGHTNING_PAYMENT",
   "CLAIM_VHTLC",
@@ -5439,7 +5446,7 @@ var ArkadeSwapsMessageHandler = class _ArkadeSwapsMessageHandler {
     if (!this.handler || !this.wallet) {
       return this.tagged({
         id,
-        error: new Error("handler not initialized")
+        error: new HandlerNotInitializedError()
       });
     }
     try {
@@ -5883,6 +5890,9 @@ var import_sdk10 = require("@arkade-os/sdk");
 function isMessageBusNotInitializedError(error) {
   return error instanceof Error && error.message.includes(import_sdk10.MESSAGE_BUS_NOT_INITIALIZED);
 }
+function isHandlerNotInitializedError(error) {
+  return error instanceof Error && error.message.includes(HANDLER_NOT_INITIALIZED);
+}
 var DEFAULT_MESSAGE_TIMEOUT_MS = 3e4;
 var NO_MESSAGE_TIMEOUT_MS = 0;
 var DEDUPABLE_REQUEST_TYPES = /* @__PURE__ */ new Set([
@@ -6630,7 +6640,8 @@ var ServiceWorkerArkadeSwaps = class _ServiceWorkerArkadeSwaps {
       try {
         return await this.sendMessageDirect(request, timeoutMs);
       } catch (error) {
-        if (!isMessageBusNotInitializedError(error) || attempt >= maxRetries) {
+        const recoverable = isMessageBusNotInitializedError(error) || isHandlerNotInitializedError(error);
+        if (!recoverable || attempt >= maxRetries) {
           throw error;
         }
         await this.reinitialize();

package/dist/index.js

@@ -51,8 +51,7 @@ import {
   updateReverseSwapStatus,
   updateSubmarineSwapStatus,
   verifySignatures
-} from "./chunk-LWUXSE5N.js";
-import "./chunk-3RG5ZIWI.js";
+} from "./chunk-B3Q4TFWT.js";
 
 // src/serviceWorker/arkade-swaps-message-handler.ts
 import {
@@ -60,6 +59,13 @@ import {
   RestIndexerProvider
 } from "@arkade-os/sdk";
 var DEFAULT_MESSAGE_TAG = "ARKADE_SWAPS_UPDATER";
+var HANDLER_NOT_INITIALIZED = "ArkadeSwaps handler not initialized";
+var HandlerNotInitializedError = class extends Error {
+  constructor() {
+    super(HANDLER_NOT_INITIALIZED);
+    this.name = "HandlerNotInitializedError";
+  }
+};
 var LONG_RUNNING_ARKADE_SWAPS_REQUEST_TYPES = /* @__PURE__ */ new Set([
   "SEND_LIGHTNING_PAYMENT",
   "CLAIM_VHTLC",
@@ -161,7 +167,7 @@ var ArkadeSwapsMessageHandler = class _ArkadeSwapsMessageHandler {
     if (!this.handler || !this.wallet) {
       return this.tagged({
         id,
-        error: new Error("handler not initialized")
+        error: new HandlerNotInitializedError()
       });
     }
     try {
@@ -608,6 +614,9 @@ import {
 function isMessageBusNotInitializedError(error) {
   return error instanceof Error && error.message.includes(MESSAGE_BUS_NOT_INITIALIZED);
 }
+function isHandlerNotInitializedError(error) {
+  return error instanceof Error && error.message.includes(HANDLER_NOT_INITIALIZED);
+}
 var DEFAULT_MESSAGE_TIMEOUT_MS = 3e4;
 var NO_MESSAGE_TIMEOUT_MS = 0;
 var DEDUPABLE_REQUEST_TYPES = /* @__PURE__ */ new Set([
@@ -1355,7 +1364,8 @@ var ServiceWorkerArkadeSwaps = class _ServiceWorkerArkadeSwaps {
       try {
         return await this.sendMessageDirect(request, timeoutMs);
       } catch (error) {
-        if (!isMessageBusNotInitializedError(error) || attempt >= maxRetries) {
+        const recoverable = isMessageBusNotInitializedError(error) || isHandlerNotInitializedError(error);
+        if (!recoverable || attempt >= maxRetries) {
           throw error;
         }
         await this.reinitialize();

package/dist/repositories/realm/index.js

@@ -1,5 +1,3 @@
-import "../../chunk-3RG5ZIWI.js";
-
 // src/repositories/realm/swap-repository.ts
 var RealmSwapRepository = class {
   // eslint-disable-next-line @typescript-eslint/no-explicit-any

package/dist/repositories/sqlite/index.js

@@ -1,5 +1,3 @@
-import "../../chunk-3RG5ZIWI.js";
-
 // src/repositories/sqlite/swap-repository.ts
 var SQLiteSwapRepository = class {
   constructor(executor) {