@arkade-os/sdk 0.4.27 → 0.4.28

package/README.md

@@ -369,7 +369,7 @@ The wallet's `assetManager` lets you create and manage assets on Arkade. The `se
 ```typescript
 // Issue a new asset (non-reissuable by default)
 const { assetId: controlAssetId } = await wallet.assetManager.issue({
-  amount: 1,
+  amount: 1n,
   metadata: {
     ticker: 'ctrl-MTK'
   }
@@ -377,7 +377,7 @@ const { assetId: controlAssetId } = await wallet.assetManager.issue({
 
 // Issue a new asset referencing the control asset
 const { assetId } = await wallet.assetManager.issue({
-  amount: 500,
+  amount: 500n,
   controlAssetId,
   metadata: {
     ticker: 'MTK'
@@ -387,19 +387,19 @@ const { assetId } = await wallet.assetManager.issue({
 // Reissue more supply of the asset (requires ownership of the control asset)
 const reissuanceTxId = await wallet.assetManager.reissue({
   assetId,
-  amount: 500,
+  amount: 500n,
 })
 
 // Burn some of the asset
 const burnTxId = await wallet.assetManager.burn({
   assetId,
-  amount: 200,
+  amount: 200n,
 })
 
 // Send asset to another Arkade address
 const sendTxId = await wallet.send({
   address: 'ark1q...',
-  assets: [{ assetId, amount: 100 }],
+  assets: [{ assetId, amount: 100n }],
 })
 
 // Check remaining balance
@@ -653,12 +653,12 @@ const history = await wallet.getTransactionHistory()
         arkTxid: string;
     };
     type: "SENT" | "RECEIVED";
-    amount: number;
+    amount: number;       // BTC amount in satoshis
     settled: boolean;
     createdAt: number;
     assets?: Array<{
         assetId: string,
-        amount: number
+        amount: bigint    // asset amount in base units
     }>
 }
 */
@@ -896,20 +896,11 @@ The `StorageAdapter` API is deprecated. Use repositories instead. If you omit `s
 > next call to `getMigrationStatus` can detect the partial migration. Old data
 > is never deleted — re-running migration after a rollback is safe.
 >
-> Anything related to contract repository migration must be handled by the package which created them. The SDK doesn't manage contracts in V1. Data remains untouched and persisted in the same old location.
->
-> If you persisted custom data in the ContractRepository via its `setContractData` method,
-> or a custom collection via `saveToContractCollection`, you'll need to migrate it manually:
->
-> ```typescript
-> // Custom data stored in the ContractRepository
-> const oldStorage = new IndexedDBStorageAdapter('legacy-wallet', 1)
-> const oldRepo = new ContractRepositoryImpl(storageAdapter)
-> const customContract = await oldRepo.getContractData('my-contract', 'status')
-> await contractRepository.setContractData('my-contract', 'status', customData)
-> const customCollection = await oldRepo.getContractCollection('swaps')
-> await contractRepository.saveToContractCollection('swaps', customCollection)
-> ```
+> Anything related to contract repository migration must be handled by the
+> package that created the contracts. The SDK doesn't manage external contracts
+> in V1; data persisted by other packages remains untouched in its original
+> location. For example, see `@arkade-os/boltz-swap`'s `migrateToSwapRepository`
+> for migrating legacy `reverseSwaps` / `submarineSwaps` collections.
 
 #### Repository Versioning
 
@@ -1213,103 +1204,43 @@ The watcher features:
 
 ### Repository Pattern
 
-Access low-level data management through repositories:
+Most users don't need to touch repositories directly — `Wallet` and `ContractManager` already read and write through them. They are documented here for advanced integrations (custom storage backends, offline-first apps, repository inspection).
 
 ```typescript
-// Virtual output management (automatically cached for performance)
+// Wallet repository — VTXOs, UTXOs, transaction history, settings
 const addr = await wallet.getAddress()
 const vtxos = await wallet.walletRepository.getVtxos(addr)
-await wallet.walletRepository.saveVtxos(addr, vtxos)
-
-// Contract data for SDK integrations
-await wallet.contractRepository.setContractData('my-contract', 'status', 'active')
-const status = await wallet.contractRepository.getContractData('my-contract', 'status')
-
-// Collection management for related data
-await wallet.contractRepository.saveToContractCollection(
-  'swaps',
-  { id: 'swap-1', amount: 50000, type: 'reverse' },
-  'id' // key field
-)
-const swaps = await wallet.contractRepository.getContractCollection('swaps')
+const utxos = await wallet.walletRepository.getUtxos(addr)
+const history = await wallet.walletRepository.getTransactionHistory(addr)
+
+// Contract repository — script-keyed contracts (default address, VHTLCs, etc.)
+const contracts = await wallet.contractRepository.getContracts({ type: 'vhtlc' })
+await wallet.contractRepository.saveContract(myContract)
+await wallet.contractRepository.deleteContract(myContract.script)
 ```
 
 _For complete API documentation, visit our [TypeDoc documentation](https://arkade-os.github.io/ts-sdk/)._
 
 ## Development
 
-### Requirements
-
-- [pnpm](https://pnpm.io/) - Package manager
-- [nigiri](https://github.com/vulpemventures/nigiri) - For running integration tests with a local Bitcoin regtest network
-
-### Setup
-
-1. Install dependencies:
-
-   ```bash
-   pnpm install
-   pnpm format
-   pnpm lint
-   ```
+This package is developed inside the [arkade-os/ts-sdk](../..) monorepo. See the [root README](../../README.md) for repo-wide setup (`pnpm install`, submodule init, lint) and the integration test workflow against the shared regtest stack.
 
-1. Install nigiri for integration tests:
-
-   ```bash
-   curl https://getnigiri.vulpem.com | bash
-   ```
-
-### Running Tests
+Common package-local commands (run from the repo root):
 
 ```bash
-# Run all tests
-pnpm test
-
-# Run unit tests only
-pnpm test:unit
-
-# Run integration tests with ark provided by nigiri
-nigiri start --ark
-pnpm test:setup # Run setup script for integration tests
-pnpm test:integration
-nigiri stop --delete
-
-# Run integration tests with ark provided by docker (requires nigiri)
-nigiri start
-pnpm test:up-docker
-pnpm test:setup-docker # Run setup script for integration tests
-pnpm test:integration-docker
-pnpm test:down-docker
-nigiri stop --delete
-
-# Watch mode for development
-pnpm test:watch
-
-# Run tests with coverage
-pnpm test:coverage
+pnpm -C packages/ts-sdk run typecheck    # Type-check the SDK
+pnpm -C packages/ts-sdk test:unit        # Unit tests, excluding e2e
+pnpm -C packages/ts-sdk test:watch       # Vitest watch mode
+pnpm -C packages/ts-sdk test:coverage    # Coverage report
+pnpm -C packages/ts-sdk docs:build       # Build TypeDoc API docs
+pnpm -C packages/ts-sdk docs:open        # Open API docs in the browser
 ```
 
-### Building the documentation
-
-```bash
-# Build the TypeScript documentation
-pnpm docs:build
-# Open the docs in the browser
-pnpm docs:open
-```
+For integration tests, use the root commands (`pnpm run test:integration:ts-sdk` and the `regtest:*:ts-sdk` family) — see the root README.
 
 ### Releasing
 
-```bash
-# Release new version (will prompt for version patch, minor, major)
-pnpm release
-
-# You can test release process without making changes
-pnpm release:dry-run
-
-# Cleanup: checkout version commit and remove release branch
-pnpm release:cleanup
-```
+Package-local releases are disabled. Releases run from the monorepo root and are package-scoped: `pnpm run release -- sdk patch` bumps `@arkade-os/sdk`, creates a `@arkade-os/sdk/<version>` tag, and also bumps `@arkade-os/boltz-swap` (which depends on SDK via `workspace:*`). See the [root README](../../README.md#releasing) for full flags and `pnpm run release -- --help`.
 
 ## License
 

package/dist/adapters/asyncStorage.cjs

@@ -0,0 +1,48 @@
+'use strict';
+
+var chunk5BLDMQED_cjs = require('../chunk-5BLDMQED.cjs');
+
+// src/storage/asyncStorage.ts
+var AsyncStorageAdapter = class {
+  AsyncStorage;
+  constructor() {
+    try {
+      this.AsyncStorage = chunk5BLDMQED_cjs.__require("@react-native-async-storage/async-storage").default;
+    } catch (error) {
+      throw new Error(
+        "AsyncStorage is not available. Make sure @react-native-async-storage/async-storage is installed in React Native environment."
+      );
+    }
+  }
+  async getItem(key) {
+    return await this.AsyncStorage.getItem(key);
+  }
+  async setItem(key, value) {
+    try {
+      await this.AsyncStorage.setItem(key, value);
+    } catch (error) {
+      console.error(`Failed to set item for key ${key}:`, error);
+      throw error;
+    }
+  }
+  async removeItem(key) {
+    try {
+      await this.AsyncStorage.removeItem(key);
+    } catch (error) {
+      console.error(`Failed to remove item for key ${key}:`, error);
+      throw error;
+    }
+  }
+  async clear() {
+    try {
+      await this.AsyncStorage.clear();
+    } catch (error) {
+      console.error("Failed to clear AsyncStorage:", error);
+      throw error;
+    }
+  }
+};
+
+exports.AsyncStorageAdapter = AsyncStorageAdapter;
+//# sourceMappingURL=asyncStorage.cjs.map
+//# sourceMappingURL=asyncStorage.cjs.map

package/dist/adapters/asyncStorage.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/storage/asyncStorage.ts"],"names":["__require"],"mappings":";;;;;AAMO,IAAM,sBAAN,MAAoD;AAAA,EAC/C,YAAA;AAAA,EAER,WAAA,GAAc;AACV,IAAA,IAAI;AAEA,MAAA,IAAA,CAAK,YAAA,GAAeA,2BAAA,CAAQ,2CAA2C,CAAA,CAAE,OAAA;AAAA,IAC7E,SAAS,KAAA,EAAO;AACZ,MAAA,MAAM,IAAI,KAAA;AAAA,QACN;AAAA,OACJ;AAAA,IACJ;AAAA,EACJ;AAAA,EAEA,MAAM,QAAQ,GAAA,EAAqC;AAC/C,IAAA,OAAO,MAAM,IAAA,CAAK,YAAA,CAAa,OAAA,CAAQ,GAAG,CAAA;AAAA,EAC9C;AAAA,EAEA,MAAM,OAAA,CAAQ,GAAA,EAAa,KAAA,EAA8B;AACrD,IAAA,IAAI;AACA,MAAA,MAAM,IAAA,CAAK,YAAA,CAAa,OAAA,CAAQ,GAAA,EAAK,KAAK,CAAA;AAAA,IAC9C,SAAS,KAAA,EAAO;AACZ,MAAA,OAAA,CAAQ,KAAA,CAAM,CAAA,2BAAA,EAA8B,GAAG,CAAA,CAAA,CAAA,EAAK,KAAK,CAAA;AACzD,MAAA,MAAM,KAAA;AAAA,IACV;AAAA,EACJ;AAAA,EAEA,MAAM,WAAW,GAAA,EAA4B;AACzC,IAAA,IAAI;AACA,MAAA,MAAM,IAAA,CAAK,YAAA,CAAa,UAAA,CAAW,GAAG,CAAA;AAAA,IAC1C,SAAS,KAAA,EAAO;AACZ,MAAA,OAAA,CAAQ,KAAA,CAAM,CAAA,8BAAA,EAAiC,GAAG,CAAA,CAAA,CAAA,EAAK,KAAK,CAAA;AAC5D,MAAA,MAAM,KAAA;AAAA,IACV;AAAA,EACJ;AAAA,EAEA,MAAM,KAAA,GAAuB;AACzB,IAAA,IAAI;AACA,MAAA,MAAM,IAAA,CAAK,aAAa,KAAA,EAAM;AAAA,IAClC,SAAS,KAAA,EAAO;AACZ,MAAA,OAAA,CAAQ,KAAA,CAAM,iCAAiC,KAAK,CAAA;AACpD,MAAA,MAAM,KAAA;AAAA,IACV;AAAA,EACJ;AACJ","file":"asyncStorage.cjs","sourcesContent":["import type { StorageAdapter } from \"./index\";\n\n/**\n * @deprecated Use repositories instead\n * Note: This requires @react-native-async-storage/async-storage to be installed\n */\nexport class AsyncStorageAdapter implements StorageAdapter {\n    private AsyncStorage: any;\n\n    constructor() {\n        try {\n            // Dynamic import to avoid errors in non-React Native environments\n            this.AsyncStorage = require(\"@react-native-async-storage/async-storage\").default;\n        } catch (error) {\n            throw new Error(\n                \"AsyncStorage is not available. Make sure @react-native-async-storage/async-storage is installed in React Native environment.\",\n            );\n        }\n    }\n\n    async getItem(key: string): Promise<string | null> {\n        return await this.AsyncStorage.getItem(key);\n    }\n\n    async setItem(key: string, value: string): Promise<void> {\n        try {\n            await this.AsyncStorage.setItem(key, value);\n        } catch (error) {\n            console.error(`Failed to set item for key ${key}:`, error);\n            throw error;\n        }\n    }\n\n    async removeItem(key: string): Promise<void> {\n        try {\n            await this.AsyncStorage.removeItem(key);\n        } catch (error) {\n            console.error(`Failed to remove item for key ${key}:`, error);\n            throw error;\n        }\n    }\n\n    async clear(): Promise<void> {\n        try {\n            await this.AsyncStorage.clear();\n        } catch (error) {\n            console.error(\"Failed to clear AsyncStorage:\", error);\n            throw error;\n        }\n    }\n}\n"]}

package/dist/adapters/asyncStorage.d.cts

@@ -0,0 +1,16 @@
+import { S as StorageAdapter } from '../index-C0IanN1m.cjs';
+
+/**
+ * @deprecated Use repositories instead
+ * Note: This requires @react-native-async-storage/async-storage to be installed
+ */
+declare class AsyncStorageAdapter implements StorageAdapter {
+    private AsyncStorage;
+    constructor();
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    removeItem(key: string): Promise<void>;
+    clear(): Promise<void>;
+}
+
+export { AsyncStorageAdapter, StorageAdapter };

package/dist/{types/storage → adapters}/asyncStorage.d.ts

@@ -1,9 +1,10 @@
-import type { StorageAdapter } from "./index.js";
+import { S as StorageAdapter } from '../index-C0IanN1m.js';
+
 /**
  * @deprecated Use repositories instead
  * Note: This requires @react-native-async-storage/async-storage to be installed
  */
-export declare class AsyncStorageAdapter implements StorageAdapter {
+declare class AsyncStorageAdapter implements StorageAdapter {
     private AsyncStorage;
     constructor();
     getItem(key: string): Promise<string | null>;
@@ -11,3 +12,5 @@ export declare class AsyncStorageAdapter implements StorageAdapter {
     removeItem(key: string): Promise<void>;
     clear(): Promise<void>;
 }
+
+export { AsyncStorageAdapter, StorageAdapter };

package/dist/adapters/asyncStorage.js

@@ -0,0 +1,46 @@
+import { __require } from '../chunk-NSBPE2FW.js';
+
+// src/storage/asyncStorage.ts
+var AsyncStorageAdapter = class {
+  AsyncStorage;
+  constructor() {
+    try {
+      this.AsyncStorage = __require("@react-native-async-storage/async-storage").default;
+    } catch (error) {
+      throw new Error(
+        "AsyncStorage is not available. Make sure @react-native-async-storage/async-storage is installed in React Native environment."
+      );
+    }
+  }
+  async getItem(key) {
+    return await this.AsyncStorage.getItem(key);
+  }
+  async setItem(key, value) {
+    try {
+      await this.AsyncStorage.setItem(key, value);
+    } catch (error) {
+      console.error(`Failed to set item for key ${key}:`, error);
+      throw error;
+    }
+  }
+  async removeItem(key) {
+    try {
+      await this.AsyncStorage.removeItem(key);
+    } catch (error) {
+      console.error(`Failed to remove item for key ${key}:`, error);
+      throw error;
+    }
+  }
+  async clear() {
+    try {
+      await this.AsyncStorage.clear();
+    } catch (error) {
+      console.error("Failed to clear AsyncStorage:", error);
+      throw error;
+    }
+  }
+};
+
+export { AsyncStorageAdapter };
+//# sourceMappingURL=asyncStorage.js.map
+//# sourceMappingURL=asyncStorage.js.map

package/dist/adapters/asyncStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/storage/asyncStorage.ts"],"names":[],"mappings":";;;AAMO,IAAM,sBAAN,MAAoD;AAAA,EAC/C,YAAA;AAAA,EAER,WAAA,GAAc;AACV,IAAA,IAAI;AAEA,MAAA,IAAA,CAAK,YAAA,GAAe,SAAA,CAAQ,2CAA2C,CAAA,CAAE,OAAA;AAAA,IAC7E,SAAS,KAAA,EAAO;AACZ,MAAA,MAAM,IAAI,KAAA;AAAA,QACN;AAAA,OACJ;AAAA,IACJ;AAAA,EACJ;AAAA,EAEA,MAAM,QAAQ,GAAA,EAAqC;AAC/C,IAAA,OAAO,MAAM,IAAA,CAAK,YAAA,CAAa,OAAA,CAAQ,GAAG,CAAA;AAAA,EAC9C;AAAA,EAEA,MAAM,OAAA,CAAQ,GAAA,EAAa,KAAA,EAA8B;AACrD,IAAA,IAAI;AACA,MAAA,MAAM,IAAA,CAAK,YAAA,CAAa,OAAA,CAAQ,GAAA,EAAK,KAAK,CAAA;AAAA,IAC9C,SAAS,KAAA,EAAO;AACZ,MAAA,OAAA,CAAQ,KAAA,CAAM,CAAA,2BAAA,EAA8B,GAAG,CAAA,CAAA,CAAA,EAAK,KAAK,CAAA;AACzD,MAAA,MAAM,KAAA;AAAA,IACV;AAAA,EACJ;AAAA,EAEA,MAAM,WAAW,GAAA,EAA4B;AACzC,IAAA,IAAI;AACA,MAAA,MAAM,IAAA,CAAK,YAAA,CAAa,UAAA,CAAW,GAAG,CAAA;AAAA,IAC1C,SAAS,KAAA,EAAO;AACZ,MAAA,OAAA,CAAQ,KAAA,CAAM,CAAA,8BAAA,EAAiC,GAAG,CAAA,CAAA,CAAA,EAAK,KAAK,CAAA;AAC5D,MAAA,MAAM,KAAA;AAAA,IACV;AAAA,EACJ;AAAA,EAEA,MAAM,KAAA,GAAuB;AACzB,IAAA,IAAI;AACA,MAAA,MAAM,IAAA,CAAK,aAAa,KAAA,EAAM;AAAA,IAClC,SAAS,KAAA,EAAO;AACZ,MAAA,OAAA,CAAQ,KAAA,CAAM,iCAAiC,KAAK,CAAA;AACpD,MAAA,MAAM,KAAA;AAAA,IACV;AAAA,EACJ;AACJ","file":"asyncStorage.js","sourcesContent":["import type { StorageAdapter } from \"./index\";\n\n/**\n * @deprecated Use repositories instead\n * Note: This requires @react-native-async-storage/async-storage to be installed\n */\nexport class AsyncStorageAdapter implements StorageAdapter {\n    private AsyncStorage: any;\n\n    constructor() {\n        try {\n            // Dynamic import to avoid errors in non-React Native environments\n            this.AsyncStorage = require(\"@react-native-async-storage/async-storage\").default;\n        } catch (error) {\n            throw new Error(\n                \"AsyncStorage is not available. Make sure @react-native-async-storage/async-storage is installed in React Native environment.\",\n            );\n        }\n    }\n\n    async getItem(key: string): Promise<string | null> {\n        return await this.AsyncStorage.getItem(key);\n    }\n\n    async setItem(key: string, value: string): Promise<void> {\n        try {\n            await this.AsyncStorage.setItem(key, value);\n        } catch (error) {\n            console.error(`Failed to set item for key ${key}:`, error);\n            throw error;\n        }\n    }\n\n    async removeItem(key: string): Promise<void> {\n        try {\n            await this.AsyncStorage.removeItem(key);\n        } catch (error) {\n            console.error(`Failed to remove item for key ${key}:`, error);\n            throw error;\n        }\n    }\n\n    async clear(): Promise<void> {\n        try {\n            await this.AsyncStorage.clear();\n        } catch (error) {\n            console.error(\"Failed to clear AsyncStorage:\", error);\n            throw error;\n        }\n    }\n}\n"]}

package/dist/adapters/expo.cjs

@@ -0,0 +1,19 @@
+'use strict';
+
+var chunkFG5ACJJW_cjs = require('../chunk-FG5ACJJW.cjs');
+require('../chunk-ADV27S4N.cjs');
+require('../chunk-5PG7DV7A.cjs');
+require('../chunk-5BLDMQED.cjs');
+
+
+
+Object.defineProperty(exports, "ExpoArkProvider", {
+  enumerable: true,
+  get: function () { return chunkFG5ACJJW_cjs.ExpoArkProvider; }
+});
+Object.defineProperty(exports, "ExpoIndexerProvider", {
+  enumerable: true,
+  get: function () { return chunkFG5ACJJW_cjs.ExpoIndexerProvider; }
+});
+//# sourceMappingURL=expo.cjs.map
+//# sourceMappingURL=expo.cjs.map

package/dist/adapters/expo.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"expo.cjs"}

package/dist/adapters/expo.d.cts

@@ -0,0 +1,48 @@
+import { j as RestArkProvider, h as SettlementEvent, T as TxNotification, k as RestIndexerProvider, l as SubscriptionResponse } from '../ark-TZ1gXAXU.cjs';
+export { m as ArkProvider, n as IndexerProvider } from '../ark-TZ1gXAXU.cjs';
+import '@scure/btc-signer/transaction.js';
+import '@scure/btc-signer/utils.js';
+import '@scure/btc-signer/psbt.js';
+import '@scure/btc-signer';
+
+/**
+ * Expo-compatible Arkade provider implementation using expo/fetch for SSE support.
+ * This provider works specifically in React Native/Expo environments where
+ * standard EventSource is not available but expo/fetch provides SSE capabilities.
+ *
+ * @example
+ * ```typescript
+ * import { ExpoArkProvider } from '@arkade-os/sdk/providers/expo';
+ *
+ * const provider = new ExpoArkProvider('https://arkade.computer');
+ * const info = await provider.getInfo();
+ * ```
+ */
+declare class ExpoArkProvider extends RestArkProvider {
+    constructor(serverUrl: string);
+    getEventStream(signal: AbortSignal, topics: string[]): AsyncIterableIterator<SettlementEvent>;
+    getTransactionsStream(signal: AbortSignal): AsyncIterableIterator<{
+        commitmentTx?: TxNotification;
+        arkTx?: TxNotification;
+    }>;
+}
+
+/**
+ * Expo-compatible Indexer provider implementation using expo/fetch for streaming support.
+ * This provider works specifically in React Native/Expo environments where
+ * standard fetch streaming may not work properly but expo/fetch provides streaming capabilities.
+ *
+ * @example
+ * ```typescript
+ * import { ExpoIndexerProvider } from '@arkade-os/sdk/adapters/expo';
+ *
+ * const provider = new ExpoIndexerProvider('https://indexer.example.com');
+ * const vtxos = await provider.getVtxos({ scripts: ['script1'] });
+ * ```
+ */
+declare class ExpoIndexerProvider extends RestIndexerProvider {
+    constructor(serverUrl: string);
+    getSubscription(subscriptionId: string, abortSignal: AbortSignal): AsyncIterableIterator<SubscriptionResponse>;
+}
+
+export { ExpoArkProvider, ExpoIndexerProvider };

package/dist/adapters/expo.d.ts

@@ -0,0 +1,48 @@
+import { j as RestArkProvider, h as SettlementEvent, T as TxNotification, k as RestIndexerProvider, l as SubscriptionResponse } from '../ark-TZ1gXAXU.js';
+export { m as ArkProvider, n as IndexerProvider } from '../ark-TZ1gXAXU.js';
+import '@scure/btc-signer/transaction.js';
+import '@scure/btc-signer/utils.js';
+import '@scure/btc-signer/psbt.js';
+import '@scure/btc-signer';
+
+/**
+ * Expo-compatible Arkade provider implementation using expo/fetch for SSE support.
+ * This provider works specifically in React Native/Expo environments where
+ * standard EventSource is not available but expo/fetch provides SSE capabilities.
+ *
+ * @example
+ * ```typescript
+ * import { ExpoArkProvider } from '@arkade-os/sdk/providers/expo';
+ *
+ * const provider = new ExpoArkProvider('https://arkade.computer');
+ * const info = await provider.getInfo();
+ * ```
+ */
+declare class ExpoArkProvider extends RestArkProvider {
+    constructor(serverUrl: string);
+    getEventStream(signal: AbortSignal, topics: string[]): AsyncIterableIterator<SettlementEvent>;
+    getTransactionsStream(signal: AbortSignal): AsyncIterableIterator<{
+        commitmentTx?: TxNotification;
+        arkTx?: TxNotification;
+    }>;
+}
+
+/**
+ * Expo-compatible Indexer provider implementation using expo/fetch for streaming support.
+ * This provider works specifically in React Native/Expo environments where
+ * standard fetch streaming may not work properly but expo/fetch provides streaming capabilities.
+ *
+ * @example
+ * ```typescript
+ * import { ExpoIndexerProvider } from '@arkade-os/sdk/adapters/expo';
+ *
+ * const provider = new ExpoIndexerProvider('https://indexer.example.com');
+ * const vtxos = await provider.getVtxos({ scripts: ['script1'] });
+ * ```
+ */
+declare class ExpoIndexerProvider extends RestIndexerProvider {
+    constructor(serverUrl: string);
+    getSubscription(subscriptionId: string, abortSignal: AbortSignal): AsyncIterableIterator<SubscriptionResponse>;
+}
+
+export { ExpoArkProvider, ExpoIndexerProvider };

package/dist/adapters/expo.js

@@ -0,0 +1,6 @@
+export { ExpoArkProvider, ExpoIndexerProvider } from '../chunk-CFZMTDWI.js';
+import '../chunk-ZBUDLTBO.js';
+import '../chunk-HW3JJ323.js';
+import '../chunk-NSBPE2FW.js';
+//# sourceMappingURL=expo.js.map
+//# sourceMappingURL=expo.js.map

package/dist/adapters/expo.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"expo.js"}

package/dist/adapters/fileSystem.cjs

@@ -0,0 +1,116 @@
+'use strict';
+
+require('../chunk-5BLDMQED.cjs');
+var fs = require('fs/promises');
+var path = require('path');
+
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var fs__namespace = /*#__PURE__*/_interopNamespace(fs);
+var path__namespace = /*#__PURE__*/_interopNamespace(path);
+
+var FileSystemStorageAdapter = class {
+  basePath;
+  constructor(dirPath) {
+    this.basePath = path__namespace.resolve(dirPath).replace(/[/\\]+$/, "");
+  }
+  validateAndGetFilePath(key) {
+    if (key === "." || key === "..") {
+      throw new Error("Invalid key: '.' and '..' are not allowed");
+    }
+    if (key.includes("\0")) {
+      throw new Error("Invalid key: null bytes are not allowed");
+    }
+    if (key.includes("..")) {
+      throw new Error("Invalid key: directory traversal is not allowed");
+    }
+    const reservedNames = /^(CON|PRN|AUX|NUL|COM[1-9]|LPT[1-9])$/i;
+    const keyWithoutExt = key.split(".")[0];
+    if (reservedNames.test(keyWithoutExt)) {
+      throw new Error(`Invalid key: '${key}' uses a reserved Windows name`);
+    }
+    if (key.endsWith(" ") || key.endsWith(".")) {
+      throw new Error("Invalid key: trailing spaces or dots are not allowed");
+    }
+    const normalizedKey = key.replace(/[/\\]/g, "_").replace(/[^a-zA-Z0-9._-]/g, "_");
+    const resolved = path__namespace.resolve(this.basePath, normalizedKey);
+    const relative2 = path__namespace.relative(this.basePath, resolved);
+    if (relative2.startsWith("..") || relative2.includes(path__namespace.sep + "..")) {
+      throw new Error("Invalid key: directory traversal is not allowed");
+    }
+    return resolved;
+  }
+  async ensureDirectory() {
+    try {
+      await fs__namespace.access(this.basePath);
+    } catch {
+      await fs__namespace.mkdir(this.basePath, { recursive: true });
+    }
+  }
+  async getItem(key) {
+    try {
+      const filePath = this.validateAndGetFilePath(key);
+      const data = await fs__namespace.readFile(filePath, "utf-8");
+      return data;
+    } catch (error) {
+      if (error.code === "ENOENT") {
+        return null;
+      }
+      console.error(`Failed to read file for key ${key}:`, error);
+      return null;
+    }
+  }
+  async setItem(key, value) {
+    try {
+      await this.ensureDirectory();
+      const filePath = this.validateAndGetFilePath(key);
+      await fs__namespace.writeFile(filePath, value, "utf-8");
+    } catch (error) {
+      console.error(`Failed to write file for key ${key}:`, error);
+      throw error;
+    }
+  }
+  async removeItem(key) {
+    try {
+      const filePath = this.validateAndGetFilePath(key);
+      await fs__namespace.unlink(filePath);
+    } catch (error) {
+      if (error.code !== "ENOENT") {
+        console.error(`Failed to remove file for key ${key}:`, error);
+      }
+    }
+  }
+  async clear() {
+    try {
+      const entries = await fs__namespace.readdir(this.basePath);
+      await Promise.all(
+        entries.map(async (entry) => {
+          const entryPath = path__namespace.join(this.basePath, entry);
+          await fs__namespace.rm(entryPath, { recursive: true, force: true });
+        })
+      );
+    } catch (error) {
+      console.error("Failed to clear storage directory:", error);
+    }
+  }
+};
+
+exports.FileSystemStorageAdapter = FileSystemStorageAdapter;
+//# sourceMappingURL=fileSystem.cjs.map
+//# sourceMappingURL=fileSystem.cjs.map

package/dist/adapters/fileSystem.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/storage/fileSystem.ts"],"names":["path","relative","fs"],"mappings":"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","file":"fileSystem.cjs","sourcesContent":["import * as fs from \"fs/promises\";\nimport * as path from \"path\";\nimport type { StorageAdapter } from \"./index\";\n\n/**\n * @deprecated Use repository implementations via `StorageConfig` instead.\n */\nexport class FileSystemStorageAdapter implements StorageAdapter {\n    private readonly basePath: string;\n\n    constructor(dirPath: string) {\n        // Normalize and resolve the storage base path once\n        this.basePath = path.resolve(dirPath).replace(/[/\\\\]+$/, \"\");\n    }\n\n    private validateAndGetFilePath(key: string): string {\n        // Reject dangerous keys\n        if (key === \".\" || key === \"..\") {\n            throw new Error(\"Invalid key: '.' and '..' are not allowed\");\n        }\n\n        // Check for null bytes\n        if (key.includes(\"\\0\")) {\n            throw new Error(\"Invalid key: null bytes are not allowed\");\n        }\n\n        // Check for path traversal attempts before normalization\n        if (key.includes(\"..\")) {\n            throw new Error(\"Invalid key: directory traversal is not allowed\");\n        }\n\n        // Check for reserved Windows names (case-insensitive)\n        const reservedNames = /^(CON|PRN|AUX|NUL|COM[1-9]|LPT[1-9])$/i;\n        const keyWithoutExt = key.split(\".\")[0];\n        if (reservedNames.test(keyWithoutExt)) {\n            throw new Error(`Invalid key: '${key}' uses a reserved Windows name`);\n        }\n\n        // Check for trailing spaces or dots\n        if (key.endsWith(\" \") || key.endsWith(\".\")) {\n            throw new Error(\"Invalid key: trailing spaces or dots are not allowed\");\n        }\n\n        // Normalize path separators and sanitize key\n        const normalizedKey = key.replace(/[/\\\\]/g, \"_\").replace(/[^a-zA-Z0-9._-]/g, \"_\");\n\n        // Resolve the full path and check for directory traversal\n        const resolved = path.resolve(this.basePath, normalizedKey);\n        const relative = path.relative(this.basePath, resolved);\n\n        // Reject if trying to escape the base directory\n        if (relative.startsWith(\"..\") || relative.includes(path.sep + \"..\")) {\n            throw new Error(\"Invalid key: directory traversal is not allowed\");\n        }\n\n        return resolved;\n    }\n\n    private async ensureDirectory(): Promise<void> {\n        try {\n            await fs.access(this.basePath);\n        } catch {\n            await fs.mkdir(this.basePath, { recursive: true });\n        }\n    }\n\n    async getItem(key: string): Promise<string | null> {\n        try {\n            const filePath = this.validateAndGetFilePath(key);\n            const data = await fs.readFile(filePath, \"utf-8\");\n            return data;\n        } catch (error: any) {\n            if (error.code === \"ENOENT\") {\n                return null;\n            }\n            console.error(`Failed to read file for key ${key}:`, error);\n            return null;\n        }\n    }\n\n    async setItem(key: string, value: string): Promise<void> {\n        try {\n            await this.ensureDirectory();\n            const filePath = this.validateAndGetFilePath(key);\n            await fs.writeFile(filePath, value, \"utf-8\");\n        } catch (error) {\n            console.error(`Failed to write file for key ${key}:`, error);\n            throw error;\n        }\n    }\n\n    async removeItem(key: string): Promise<void> {\n        try {\n            const filePath = this.validateAndGetFilePath(key);\n            await fs.unlink(filePath);\n        } catch (error: any) {\n            if (error.code !== \"ENOENT\") {\n                console.error(`Failed to remove file for key ${key}:`, error);\n            }\n        }\n    }\n\n    async clear(): Promise<void> {\n        try {\n            const entries = await fs.readdir(this.basePath);\n            await Promise.all(\n                entries.map(async (entry) => {\n                    const entryPath = path.join(this.basePath, entry);\n                    // Use fs.rm with recursive option to handle both files and directories\n                    await fs.rm(entryPath, { recursive: true, force: true });\n                }),\n            );\n        } catch (error) {\n            console.error(\"Failed to clear storage directory:\", error);\n        }\n    }\n}\n"]}

package/dist/adapters/fileSystem.d.cts

@@ -0,0 +1,17 @@
+import { S as StorageAdapter } from '../index-C0IanN1m.cjs';
+
+/**
+ * @deprecated Use repository implementations via `StorageConfig` instead.
+ */
+declare class FileSystemStorageAdapter implements StorageAdapter {
+    private readonly basePath;
+    constructor(dirPath: string);
+    private validateAndGetFilePath;
+    private ensureDirectory;
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    removeItem(key: string): Promise<void>;
+    clear(): Promise<void>;
+}
+
+export { FileSystemStorageAdapter, StorageAdapter };

package/dist/{types/storage → adapters}/fileSystem.d.ts

@@ -1,8 +1,9 @@
-import type { StorageAdapter } from "./index.js";
+import { S as StorageAdapter } from '../index-C0IanN1m.js';
+
 /**
  * @deprecated Use repository implementations via `StorageConfig` instead.
  */
-export declare class FileSystemStorageAdapter implements StorageAdapter {
+declare class FileSystemStorageAdapter implements StorageAdapter {
     private readonly basePath;
     constructor(dirPath: string);
     private validateAndGetFilePath;
@@ -12,3 +13,5 @@ export declare class FileSystemStorageAdapter implements StorageAdapter {
     removeItem(key: string): Promise<void>;
     clear(): Promise<void>;
 }
+
+export { FileSystemStorageAdapter, StorageAdapter };