@arkade-os/sdk 0.4.59 → 0.4.61

package/README.md

@@ -914,6 +914,7 @@ import {
   WalletMessageHandler,
   IndexedDBWalletRepository,
   IndexedDBContractRepository,
+  IndexedDBIntentRepository,
 } from '@arkade-os/sdk'
 
 const walletRepo = new IndexedDBWalletRepository()
@@ -922,6 +923,10 @@ const contractRepo = new IndexedDBContractRepository()
 const bus = new MessageBus(walletRepo, contractRepo, {
   messageHandlers: [new WalletMessageHandler()],
   tickIntervalMs: 10_000, // default 10s
+  // Optional, same opt-in as `storage.intentRepository` on a main-thread
+  // wallet. Omit it and the worker persists no settlement intent, reconciles
+  // none on restart, and counts intent-locked VTXOs as available.
+  intentRepository: new IndexedDBIntentRepository(),
 })
 
 bus.start()
@@ -1141,7 +1146,7 @@ const wallet = await Wallet.create({
 
 ### Using with Node.js
 
-Node.js does not provide a global `EventSource` implementation. The SDK relies on `EventSource` for Server-Sent Events during settlement (onboarding/offboarding) and contract watching. You must polyfill it before using the SDK:
+Node.js does not provide a global `EventSource` implementation (24.x has one behind `--experimental-eventsource`). The SDK relies on `EventSource` for Server-Sent Events during settlement (onboarding/offboarding) and contract watching, so tell it which one to use:
 
 ```bash
 npm install eventsource
@@ -1149,12 +1154,15 @@ npm install eventsource
 
 ```typescript
 import { EventSource } from "eventsource";
-(globalThis as any).EventSource = EventSource;
+import { configureEventSource, Wallet } from "@arkade-os/sdk";
 
-// Use dynamic import so the polyfill is set before the SDK evaluates
-const { Wallet } = await import("@arkade-os/sdk");
+configureEventSource((url) => new EventSource(url));
 ```
 
+Order does not matter: the factory is resolved when a stream opens, not when the SDK is imported, so no dynamic-import dance is needed. A single provider can override it — `new RestIndexerProvider(url, { eventSource })` — for a process that needs different transports per connection.
+
+Assigning `globalThis.EventSource` still works and is still the last resort in the resolution order (per-provider option → `configureEventSource` → global).
+
 If you also need IndexedDB persistence (e.g. for `WalletRepository`), set up the shim before any SDK import:
 
 ```typescript
@@ -1168,8 +1176,10 @@ setGlobalVars(null, { checkOrigin: false });
 ```
 
 > **Note:** `eventsource` and `indexeddbshim` are optional peer dependencies.
-> Without the `EventSource` polyfill, settlement operations will fail with
-> `ReferenceError: EventSource is not defined`.
+> With no `EventSource` available, settlement fails with a typed
+> `EventSourceUnavailableError` naming the remedy, and contract watching warns
+> once and falls back to its failsafe polling — it does not retry a missing
+> global, and it does not go quiet either.
 
 See [`examples/node/multiple-wallets.ts`](examples/node/multiple-wallets.ts) for a complete working example.
 
@@ -1351,6 +1361,24 @@ Contract freshness behavior:
 - **Failsafe polling** every 20 seconds by default to catch missed events, configurable via `watcherConfig.failsafePollIntervalMs`
 - **Manual refresh** through `manager.refreshVtxos()`; pass `{ includeInactive: true }` to sweep every repository contract
 
+Which contracts get that coverage is `contract.watch`, and it is independent of
+`contract.state` (which only governs receive-address selection — a retired
+receive address stays watched, because it can still be paid):
+
+```typescript
+// Watch a one-shot destination only until it is funded; the manager
+// demotes it to `retained` itself once a VTXO lands.
+await manager.createContract({ ...params, watch: 'awaiting-funds' })
+
+// A finished contract — a settled swap lockup, say. The row stays for
+// history, annotation and restore; it just leaves the subscription and
+// the poll. Unlike `deleteContract`, nothing is lost.
+await manager.setContractWatchState(script, 'retained')
+```
+
+A row with no `watch` value is `watched`, so contracts written by earlier SDK
+versions keep the coverage they have today.
+
 ### Repository Pattern
 
 Most users don't need to touch repositories directly — `Wallet` reads through them and `ContractManager` owns VTXO/contract synchronization into them. They are documented here for advanced integrations (custom storage backends, offline-first apps, repository inspection).

package/dist/adapters/expo.cjs

@@ -1,19 +1,19 @@
 'use strict';
 
-var chunk7FA36NOA_cjs = require('../chunk-7FA36NOA.cjs');
-require('../chunk-V2KENVN6.cjs');
-require('../chunk-DSTYXT2D.cjs');
+var chunkXFYFREPH_cjs = require('../chunk-XFYFREPH.cjs');
+require('../chunk-2JHN5RCY.cjs');
+require('../chunk-FNCQJLR2.cjs');
 require('../chunk-5BLDMQED.cjs');
 
 
 
 Object.defineProperty(exports, "ExpoArkProvider", {
   enumerable: true,
-  get: function () { return chunk7FA36NOA_cjs.ExpoArkProvider; }
+  get: function () { return chunkXFYFREPH_cjs.ExpoArkProvider; }
 });
 Object.defineProperty(exports, "ExpoIndexerProvider", {
   enumerable: true,
-  get: function () { return chunk7FA36NOA_cjs.ExpoIndexerProvider; }
+  get: function () { return chunkXFYFREPH_cjs.ExpoIndexerProvider; }
 });
 //# sourceMappingURL=expo.cjs.map
 //# sourceMappingURL=expo.cjs.map

package/dist/adapters/expo.d.cts

@@ -1,9 +1,9 @@
-import { k as RestArkProvider, i as SettlementEvent, T as TxNotification, l as RestIndexerProvider, m as SubscriptionResponse } from '../ark-C9DsPSm8.cjs';
-export { n as ArkProvider, o as IndexerProvider } from '../ark-C9DsPSm8.cjs';
-import '@scure/btc-signer/transaction.js';
+import { k as RestArkProvider, i as SettlementEvent, T as TxNotification, l as RestIndexerProvider, m as SubscriptionResponse } from '../index-BcRCHnzN.cjs';
+export { n as ArkProvider, o as IndexerProvider } from '../index-BcRCHnzN.cjs';
 import '@scure/btc-signer/utils.js';
-import '@scure/btc-signer/psbt.js';
+import '@scure/btc-signer/transaction.js';
 import '@scure/btc-signer';
+import '@scure/btc-signer/psbt.js';
 
 /**
  * Expo-compatible Arkade provider implementation using expo/fetch for SSE support.

package/dist/adapters/expo.d.ts

@@ -1,9 +1,9 @@
-import { k as RestArkProvider, i as SettlementEvent, T as TxNotification, l as RestIndexerProvider, m as SubscriptionResponse } from '../ark-C9DsPSm8.js';
-export { n as ArkProvider, o as IndexerProvider } from '../ark-C9DsPSm8.js';
-import '@scure/btc-signer/transaction.js';
+import { k as RestArkProvider, i as SettlementEvent, T as TxNotification, l as RestIndexerProvider, m as SubscriptionResponse } from '../index-BcRCHnzN.js';
+export { n as ArkProvider, o as IndexerProvider } from '../index-BcRCHnzN.js';
 import '@scure/btc-signer/utils.js';
-import '@scure/btc-signer/psbt.js';
+import '@scure/btc-signer/transaction.js';
 import '@scure/btc-signer';
+import '@scure/btc-signer/psbt.js';
 
 /**
  * Expo-compatible Arkade provider implementation using expo/fetch for SSE support.

package/dist/adapters/expo.js

@@ -1,6 +1,6 @@
-export { ExpoArkProvider, ExpoIndexerProvider } from '../chunk-VSHY5TBY.js';
-import '../chunk-YEHGCHIL.js';
-import '../chunk-FIMOVH25.js';
+export { ExpoArkProvider, ExpoIndexerProvider } from '../chunk-GDI2A65Z.js';
+import '../chunk-YVQNHELA.js';
+import '../chunk-PVY6DMN5.js';
 import '../chunk-NSBPE2FW.js';
 //# sourceMappingURL=expo.js.map
 //# sourceMappingURL=expo.js.map

package/dist/adapters/indexedDB.cjs

@@ -1,9 +1,9 @@
 'use strict';
 
-var chunkDYNB6POO_cjs = require('../chunk-DYNB6POO.cjs');
-require('../chunk-V2KENVN6.cjs');
-require('../chunk-2XO43UHI.cjs');
-require('../chunk-DSTYXT2D.cjs');
+var chunk3NUDA3MB_cjs = require('../chunk-3NUDA3MB.cjs');
+require('../chunk-2JHN5RCY.cjs');
+require('../chunk-SF5NKAUA.cjs');
+require('../chunk-FNCQJLR2.cjs');
 require('../chunk-5BLDMQED.cjs');
 
 // src/storage/indexedDB.ts
@@ -11,7 +11,7 @@ var IndexedDBStorageAdapter = class {
   dbName;
   version;
   db = null;
-  constructor(dbName, version = chunkDYNB6POO_cjs.DB_VERSION) {
+  constructor(dbName, version = chunk3NUDA3MB_cjs.DB_VERSION) {
     this.dbName = dbName;
     this.version = version;
   }

package/dist/adapters/indexedDB.js

@@ -1,7 +1,7 @@
-import { DB_VERSION } from '../chunk-OVSNY3HC.js';
-import '../chunk-YEHGCHIL.js';
-import '../chunk-PN5RD7ZI.js';
-import '../chunk-FIMOVH25.js';
+import { DB_VERSION } from '../chunk-AUEXB42T.js';
+import '../chunk-YVQNHELA.js';
+import '../chunk-6O5OLYTZ.js';
+import '../chunk-PVY6DMN5.js';
 import '../chunk-NSBPE2FW.js';
 
 // src/storage/indexedDB.ts

package/dist/{asyncStorageTaskQueue-CYHXFfvn.d.cts → asyncStorageTaskQueue-BWDxp3Dr.d.cts}

@@ -1,4 +1,4 @@
-import { c as TaskQueue, b as TaskItem, d as TaskResult } from './taskRunner-CBvKIttE.cjs';
+import { a as TaskQueue, c as TaskItem, d as TaskResult } from './taskRunner-BTq3rMpI.cjs';
 
 /**
  * Minimal async key-value storage interface.
@@ -46,4 +46,4 @@ declare class AsyncStorageTaskQueue implements TaskQueue {
     private writeList;
 }
 
-export { type AsyncStorageLike as A, AsyncStorageTaskQueue as a };
+export { AsyncStorageTaskQueue as A, type AsyncStorageLike as a };

package/dist/{asyncStorageTaskQueue-BwuWQ1Qc.d.ts → asyncStorageTaskQueue-Cq9FpKv6.d.ts}

@@ -1,4 +1,4 @@
-import { c as TaskQueue, b as TaskItem, d as TaskResult } from './taskRunner-Cy4Gh8n7.js';
+import { a as TaskQueue, c as TaskItem, d as TaskResult } from './taskRunner-DxMJYJ7Y.js';
 
 /**
  * Minimal async key-value storage interface.
@@ -46,4 +46,4 @@ declare class AsyncStorageTaskQueue implements TaskQueue {
     private writeList;
 }
 
-export { type AsyncStorageLike as A, AsyncStorageTaskQueue as a };
+export { AsyncStorageTaskQueue as A, type AsyncStorageLike as a };

package/dist/{chunk-V2KENVN6.cjs → chunk-2JHN5RCY.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkDSTYXT2D_cjs = require('./chunk-DSTYXT2D.cjs');
+var chunkFNCQJLR2_cjs = require('./chunk-FNCQJLR2.cjs');
 var chunk5BLDMQED_cjs = require('./chunk-5BLDMQED.cjs');
 var base = require('@scure/base');
 var secp256k1_js = require('@noble/curves/secp256k1.js');
@@ -1282,10 +1282,10 @@ async function indexerFetch(input, init) {
     const lastAttempt = attempt >= maxAttempts;
     let res;
     try {
-      res = await chunkDSTYXT2D_cjs.rateGate.runHttp(input, () => chunkDSTYXT2D_cjs.baseFetch(input, init));
+      res = await chunkFNCQJLR2_cjs.rateGate.runHttp(input, () => chunkFNCQJLR2_cjs.baseFetch(input, init));
     } catch (err) {
-      const mapped = chunkDSTYXT2D_cjs.toProviderUnavailable(err, "indexer");
-      if (lastAttempt || !(mapped instanceof chunkDSTYXT2D_cjs.ProviderUnavailableError)) throw mapped;
+      const mapped = chunkFNCQJLR2_cjs.toProviderUnavailable(err, "indexer");
+      if (lastAttempt || !(mapped instanceof chunkFNCQJLR2_cjs.ProviderUnavailableError)) throw mapped;
       await sleep(retryDelayMs(attempt));
       continue;
     }
@@ -1297,7 +1297,7 @@ async function indexerFetch(input, init) {
       body = void 0;
     }
     try {
-      chunkDSTYXT2D_cjs.throwIfHttpUnavailable(res, "indexer", body);
+      chunkFNCQJLR2_cjs.throwIfHttpUnavailable(res, "indexer", body);
     } catch (err) {
       if (lastAttempt) throw err;
       await sleep(retryDelayMs(attempt));
@@ -1325,10 +1325,13 @@ var ChainTxType = /* @__PURE__ */ ((ChainTxType2) => {
   return ChainTxType2;
 })(ChainTxType || {});
 var RestIndexerProvider = class {
-  constructor(serverUrl = chunkDSTYXT2D_cjs.DEFAULT_ARKADE_SERVER_URL) {
+  constructor(serverUrl = chunkFNCQJLR2_cjs.DEFAULT_ARKADE_SERVER_URL, options = {}) {
     this.serverUrl = serverUrl;
+    this.eventSource = options.eventSource;
   }
   serverUrl;
+  /** Overrides {@link configureEventSource} for this provider's subscription. */
+  eventSource;
   async getVtxoTree(batchOutpoint, opts) {
     let url = `${this.serverUrl}/v1/indexer/batch/${batchOutpoint.txid}/${batchOutpoint.vout}/tree`;
     const params = new URLSearchParams();
@@ -1449,6 +1452,7 @@ var RestIndexerProvider = class {
   }
   getSubscription(subscriptionId, abortSignal) {
     const url = `${this.serverUrl}/v1/indexer/script/subscription/${subscriptionId}`;
+    const override = this.eventSource;
     let iterator = null;
     const closeIterator = () => iterator?.close();
     const gen = (async function* () {
@@ -1457,7 +1461,9 @@ var RestIndexerProvider = class {
       try {
         while (!abortSignal?.aborted) {
           try {
-            const currentIterator = chunkDSTYXT2D_cjs.eventSourceIterator(new EventSource(url));
+            const currentIterator = chunkFNCQJLR2_cjs.eventSourceIterator(
+              chunkFNCQJLR2_cjs.resolveEventSource(override)(url)
+            );
             iterator = currentIterator;
             for await (const event of currentIterator) {
               if (abortSignal?.aborted) break;
@@ -1467,9 +1473,9 @@ var RestIndexerProvider = class {
                   yield {
                     txid: data.event.txid,
                     scripts: data.event.scripts || [],
-                    newVtxos: (data.event.newVtxos || []).map(chunkDSTYXT2D_cjs.convertVtxo),
-                    spentVtxos: (data.event.spentVtxos || []).map(chunkDSTYXT2D_cjs.convertVtxo),
-                    sweptVtxos: (data.event.sweptVtxos || []).map(chunkDSTYXT2D_cjs.convertVtxo),
+                    newVtxos: (data.event.newVtxos || []).map(chunkFNCQJLR2_cjs.convertVtxo),
+                    spentVtxos: (data.event.spentVtxos || []).map(chunkFNCQJLR2_cjs.convertVtxo),
+                    sweptVtxos: (data.event.sweptVtxos || []).map(chunkFNCQJLR2_cjs.convertVtxo),
                     tx: data.event.tx,
                     checkpointTxs: data.event.checkpointTxs
                   };
@@ -1483,13 +1489,14 @@ var RestIndexerProvider = class {
             if (abortSignal?.aborted || error instanceof Error && error.name === "AbortError") {
               break;
             }
-            if (chunkDSTYXT2D_cjs.isFetchTimeoutError(error)) {
+            if (chunkFNCQJLR2_cjs.isFetchTimeoutError(error)) {
               console.debug("Timeout error ignored");
               continue;
             }
-            if (chunkDSTYXT2D_cjs.isEventSourceError(error)) {
+            if (chunkFNCQJLR2_cjs.isEventSourceError(error)) {
               throw error;
             }
+            if (chunkFNCQJLR2_cjs.isEventSourceUnavailableError(error)) throw error;
             console.error("Subscription error:", error);
             throw error;
           } finally {
@@ -1615,7 +1622,7 @@ var RestIndexerProvider = class {
       throw new Error("Invalid vtxos data received");
     }
     return {
-      vtxos: data.vtxos.map(chunkDSTYXT2D_cjs.convertVtxo),
+      vtxos: data.vtxos.map(chunkFNCQJLR2_cjs.convertVtxo),
       page: data.page
     };
   }
@@ -1797,5 +1804,5 @@ exports.Metadata = Metadata;
 exports.Packet = Packet;
 exports.RestIndexerProvider = RestIndexerProvider;
 exports.asset_exports = asset_exports;
-//# sourceMappingURL=chunk-V2KENVN6.cjs.map
-//# sourceMappingURL=chunk-V2KENVN6.cjs.map
+//# sourceMappingURL=chunk-2JHN5RCY.cjs.map
+//# sourceMappingURL=chunk-2JHN5RCY.cjs.map