@arkade-os/sdk 0.4.58 → 0.4.60

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 chunkI4YEGI2R_cjs = require('../chunk-I4YEGI2R.cjs');
-require('../chunk-F4C67JYB.cjs');
-require('../chunk-D6RGHPZ5.cjs');
+var chunkH7JCHFM6_cjs = require('../chunk-H7JCHFM6.cjs');
+require('../chunk-PRFL62ID.cjs');
+require('../chunk-4A4GRSTB.cjs');
 require('../chunk-5BLDMQED.cjs');
 
 
 
 Object.defineProperty(exports, "ExpoArkProvider", {
   enumerable: true,
-  get: function () { return chunkI4YEGI2R_cjs.ExpoArkProvider; }
+  get: function () { return chunkH7JCHFM6_cjs.ExpoArkProvider; }
 });
 Object.defineProperty(exports, "ExpoIndexerProvider", {
   enumerable: true,
-  get: function () { return chunkI4YEGI2R_cjs.ExpoIndexerProvider; }
+  get: function () { return chunkH7JCHFM6_cjs.ExpoIndexerProvider; }
 });
 //# sourceMappingURL=expo.cjs.map
 //# sourceMappingURL=expo.cjs.map

package/dist/adapters/expo.d.cts

@@ -1,5 +1,5 @@
-import { k as RestArkProvider, i as SettlementEvent, T as TxNotification, l as RestIndexerProvider, m as SubscriptionResponse } from '../ark-ClaVUg4e.cjs';
-export { n as ArkProvider, o as IndexerProvider } from '../ark-ClaVUg4e.cjs';
+import { k as RestArkProvider, i as SettlementEvent, T as TxNotification, l as RestIndexerProvider, m as SubscriptionResponse } from '../ark-D2_yNhfz.cjs';
+export { n as ArkProvider, o as IndexerProvider } from '../ark-D2_yNhfz.cjs';
 import '@scure/btc-signer/transaction.js';
 import '@scure/btc-signer/utils.js';
 import '@scure/btc-signer/psbt.js';

package/dist/adapters/expo.d.ts

@@ -1,5 +1,5 @@
-import { k as RestArkProvider, i as SettlementEvent, T as TxNotification, l as RestIndexerProvider, m as SubscriptionResponse } from '../ark-ClaVUg4e.js';
-export { n as ArkProvider, o as IndexerProvider } from '../ark-ClaVUg4e.js';
+import { k as RestArkProvider, i as SettlementEvent, T as TxNotification, l as RestIndexerProvider, m as SubscriptionResponse } from '../ark-D2_yNhfz.js';
+export { n as ArkProvider, o as IndexerProvider } from '../ark-D2_yNhfz.js';
 import '@scure/btc-signer/transaction.js';
 import '@scure/btc-signer/utils.js';
 import '@scure/btc-signer/psbt.js';

package/dist/adapters/expo.js

@@ -1,6 +1,6 @@
-export { ExpoArkProvider, ExpoIndexerProvider } from '../chunk-AGWZXGG2.js';
-import '../chunk-TV2RLVOB.js';
-import '../chunk-VROHHJL4.js';
+export { ExpoArkProvider, ExpoIndexerProvider } from '../chunk-3Q7BBUWO.js';
+import '../chunk-FSKANUV4.js';
+import '../chunk-JBULXTCC.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 chunk6PY4WYXI_cjs = require('../chunk-6PY4WYXI.cjs');
-require('../chunk-F4C67JYB.cjs');
-require('../chunk-COLJARV4.cjs');
-require('../chunk-D6RGHPZ5.cjs');
+var chunkKNS5MTTI_cjs = require('../chunk-KNS5MTTI.cjs');
+require('../chunk-PRFL62ID.cjs');
+require('../chunk-MZNLCMUP.cjs');
+require('../chunk-4A4GRSTB.cjs');
 require('../chunk-5BLDMQED.cjs');
 
 // src/storage/indexedDB.ts
@@ -11,7 +11,7 @@ var IndexedDBStorageAdapter = class {
   dbName;
   version;
   db = null;
-  constructor(dbName, version = chunk6PY4WYXI_cjs.DB_VERSION) {
+  constructor(dbName, version = chunkKNS5MTTI_cjs.DB_VERSION) {
     this.dbName = dbName;
     this.version = version;
   }

package/dist/adapters/indexedDB.js

@@ -1,7 +1,7 @@
-import { DB_VERSION } from '../chunk-S3BFUTC5.js';
-import '../chunk-TV2RLVOB.js';
-import '../chunk-IPPASJE5.js';
-import '../chunk-VROHHJL4.js';
+import { DB_VERSION } from '../chunk-Y54MUBT7.js';
+import '../chunk-FSKANUV4.js';
+import '../chunk-2DINXHGQ.js';
+import '../chunk-JBULXTCC.js';
 import '../chunk-NSBPE2FW.js';
 
 // src/storage/indexedDB.ts