@1sat/wallet-toolbox 0.0.2 → 0.0.3

package/dist/OneSatWallet.d.ts

@@ -3,7 +3,8 @@ import { Wallet, type WalletStorageManager } from "@bsv/wallet-toolbox/mobile";
 import type { Chain } from "@bsv/wallet-toolbox/mobile/out/src/sdk/types";
 import { Outpoint } from "./indexers/Outpoint";
 import type { Indexer, ParseContext, Txo } from "./indexers/types";
-import { OneSatServices, type SyncOutput } from "./services/OneSatServices";
+import { OneSatServices } from "./services/OneSatServices";
+import type { SyncQueueStorage } from "./sync/types";
 /**
  * Result of ingestTransaction including parse context for debugging
  */
@@ -15,53 +16,21 @@ export interface IngestResult {
  * Events emitted by OneSatWallet during sync operations
  */
 export interface OneSatWalletEvents {
+    /** Sync started */
     "sync:start": {
-        address: string;
-        fromScore: number;
-    };
-    "sync:output": {
-        address: string;
-        output: SyncOutput;
-    };
-    "sync:skipped": {
-        address: string;
-        outpoint: string;
-        reason: string;
-    };
-    "sync:parsed": {
-        address: string;
-        txid: string;
-        parseContext: ParseContext;
-        internalizedCount: number;
-    };
-    "sync:error": {
-        address: string;
-        error: Error;
-    };
-    "sync:complete": {
-        address: string;
-    };
-    "syncAll:start": {
         addresses: string[];
-        fromScore: number;
-    };
-    "syncAll:output": {
-        output: SyncOutput;
-    };
-    "syncAll:skipped": {
-        outpoint: string;
-        reason: string;
-    };
-    "syncAll:parsed": {
-        txid: string;
-        parseContext: ParseContext;
-        internalizedCount: number;
     };
-    "syncAll:error": {
-        error: Error;
+    /** Sync progress update */
+    "sync:progress": {
+        pending: number;
+        done: number;
+        failed: number;
     };
-    "syncAll:complete": {
-        addresses: string[];
+    /** Sync complete (queue empty and stream done) */
+    "sync:complete": Record<string, never>;
+    /** Sync error */
+    "sync:error": {
+        message: string;
     };
 }
 type EventCallback<T> = (event: T) => void;
@@ -95,6 +64,15 @@ export interface OneSatWalletArgs {
      * Automatically start syncing all owner addresses on construction.
      */
     autoSync?: boolean;
+    /**
+     * Sync queue storage for background processing.
+     * If provided, enables queue-based sync via sync() method.
+     */
+    syncQueue?: SyncQueueStorage;
+    /**
+     * Batch size for queue processing (default: 20).
+     */
+    syncBatchSize?: number;
 }
 /**
  * OneSatWallet extends the BRC-100 Wallet with 1Sat-specific indexing and services.
@@ -109,8 +87,16 @@ export declare class OneSatWallet extends Wallet {
     readonly services: OneSatServices;
     private owners;
     private listeners;
-    private activeSyncs;
-    private activeMultiSync;
+    private syncQueue;
+    private syncBatchSize;
+    private syncRunning;
+    private syncStopRequested;
+    private activeQueueSync;
+    private sseStreamActive;
+    private sseUnsubscribe;
+    private processorActive;
+    private processorStopRequested;
+    private streamDone;
     constructor(args: OneSatWalletArgs);
     /**
      * Returns true if this wallet was created with only a public key.
@@ -215,46 +201,87 @@ export declare class OneSatWallet extends Wallet {
      */
     broadcast(tx: Transaction, description: string, labels?: string[]): Promise<IngestResult>;
     /**
-     * Sync a single address from the 1Sat indexer using Server-Sent Events.
-     * Runs in the background - use stopSync() or close() to stop.
+     * Start queue-based sync for all owner addresses.
+     * Requires syncQueue to be provided in constructor args.
      *
-     * @param address - The address to sync
+     * This method:
+     * 1. Opens SSE stream and enqueues outputs
+     * 2. Processes queue in batches using Promise.all()
+     * 3. Continues until queue is empty and stream is done
+     */
+    sync(): Promise<void>;
+    /**
+     * Handle a single output from the SSE stream.
+     * Enqueues to the sync queue and updates lastQueuedScore with reorg protection.
      */
-    syncAddress(address: string, fromScore?: number): void;
+    private handleSyncOutput;
     /**
-     * Process a spend transaction during sync.
-     * Only marks our output as spent - doesn't ingest the spend tx.
-     * If the spend tx has outputs we own, they'll come through sync separately.
+     * Process queue in batches until empty or stopped.
      */
-    private processSpendTx;
+    private processQueueLoop;
     /**
-     * Stop syncing a specific address.
+     * Group queue items by txid.
+     * @deprecated - claim() now returns items already grouped
      */
-    stopSync(address: string): void;
+    private groupItemsByTxid;
     /**
-     * Close the wallet and cleanup all active sync connections.
+     * Process a single txid - ingest transaction and complete queue items.
+     * Items are already marked as "processing" by claim().
+     */
+    private processTxid;
+    /**
+     * Ingest a transaction with knowledge of which outputs are already spent.
+     */
+    private ingestWithSpendInfo;
+    /**
+     * Mark outputs as spent for spend-only queue items.
+     */
+    private markOutputsSpent;
+    /**
+     * Stop the sync.
+     */
+    stopSync(): void;
+    /**
+     * Close the wallet and cleanup all sync connections.
      */
     close(): void;
     /**
-     * Start syncing all owner addresses using a single multi-owner SSE connection.
-     * This is more efficient than syncing each address individually.
-     *
-     * @param fromScore - Starting score (for pagination/resumption)
+     * Check if sync is currently running.
+     */
+    isSyncing(): boolean;
+    /**
+     * Get the sync queue instance (if provided).
+     */
+    getQueue(): SyncQueueStorage | null;
+    /**
+     * Start only the SSE stream, enqueueing outputs without processing.
+     * Useful for testing to observe queue buildup.
+     */
+    startStream(): Promise<void>;
+    /**
+     * Stop the SSE stream.
+     */
+    stopStream(): void;
+    /**
+     * Check if SSE stream is active.
+     */
+    isStreamActive(): boolean;
+    /**
+     * Check if SSE stream has completed.
      */
-    syncAll(fromScore?: number): void;
+    isStreamDone(): boolean;
     /**
-     * Process a spend transaction during multi-owner sync.
-     * Only marks our output as spent - doesn't ingest the spend tx.
+     * Start only the queue processor, without starting a new SSE stream.
+     * Useful for testing to process queued items independently.
      */
-    private processSpendTxMulti;
+    startProcessor(): Promise<void>;
     /**
-     * Stop the multi-owner sync.
+     * Stop the queue processor.
      */
-    stopSyncAll(): void;
+    stopProcessor(): void;
     /**
-     * Start syncing each owner address individually.
-     * For most cases, use syncAll() instead which uses a single connection.
+     * Check if queue processor is active.
      */
-    syncEach(): void;
+    isProcessorActive(): boolean;
 }
 export {};

package/dist/index.d.ts

@@ -1,6 +1,9 @@
 export { OneSatWallet, type OneSatWalletArgs, type OneSatWalletEvents, type IngestResult, } from "./OneSatWallet";
 export { OneSatServices, type SyncOutput } from "./services/OneSatServices";
-export type { OrdfsMetadata, Capability } from "./services/types";
+export type { OrdfsMetadata, OrdfsContentOptions, OrdfsContentResponse, OrdfsResponseHeaders, Capability, } from "./services/types";
 export * from "./services/client";
 export { ReadOnlySigner } from "./signers/ReadOnlySigner";
 export * from "./indexers";
+export * from "./sync";
+export { WalletStorageManager, StorageProvider, } from "@bsv/wallet-toolbox/mobile";
+export { StorageIdb } from "@bsv/wallet-toolbox/mobile/out/src/storage/StorageIdb";