@fullstackcraftllc/floe 0.0.6 → 0.0.8

package/dist/client/FloeClient.d.ts

@@ -4,6 +4,8 @@ import { NormalizedOption, NormalizedTicker } from "../types";
  * @enum {string}
  */
 export declare enum Broker {
+    /** Placeholder for no currently connected broker */
+    NONE = "none",
     /** Tradier brokerage API */
     TRADIER = "tradier",
     /** TastyTrade brokerage API (uses DxLink WebSocket) */
@@ -221,6 +223,21 @@ export declare class FloeClient {
      * ```
      */
     unsubscribeFromOptions(symbols: Array<string>): void;
+    /**
+     * Unsubscribes from all currently subscribed tickers and options.
+     *
+     * @throws {Error} Throws if no broker connection has been established
+     *
+     * @remarks
+     * After calling this method, no further updates will be received for any
+     * previously subscribed tickers or options.
+     *
+     * @example
+     * ```typescript
+     * client.unsubscribeFromAll();
+     * ```
+     */
+    unsubscribeFromAll(): void;
     /**
      * Fetches open interest and initial option data via REST API.
      *

package/dist/client/FloeClient.js

@@ -11,6 +11,8 @@ const SchwabClient_1 = require("./brokers/SchwabClient");
  */
 var Broker;
 (function (Broker) {
+    /** Placeholder for no currently connected broker */
+    Broker["NONE"] = "none";
     /** Tradier brokerage API */
     Broker["TRADIER"] = "tradier";
     /** TastyTrade brokerage API (uses DxLink WebSocket) */
@@ -121,6 +123,9 @@ class FloeClient {
         this.currentBroker = broker;
         // Connection logic to the broker's API using the authToken
         switch (broker.toLowerCase()) {
+            case Broker.NONE:
+                // No action needed for NONE broker; no-op
+                break;
             case Broker.TRADIER:
                 this.tradierClient = new TradierClient_1.TradierClient(authToken, { verbose: this.verbose });
                 // Wire up TradierClient events to FloeClient events
@@ -394,6 +399,40 @@ class FloeClient {
                 throw new Error(`Unsupported broker: ${this.currentBroker}`);
         }
     }
+    /**
+     * Unsubscribes from all currently subscribed tickers and options.
+     *
+     * @throws {Error} Throws if no broker connection has been established
+     *
+     * @remarks
+     * After calling this method, no further updates will be received for any
+     * previously subscribed tickers or options.
+     *
+     * @example
+     * ```typescript
+     * client.unsubscribeFromAll();
+     * ```
+     */
+    unsubscribeFromAll() {
+        this.currentSubscribedTickers = [];
+        this.currentSubscribedOptions = [];
+        switch (this.currentBroker) {
+            case Broker.TRADIER:
+                this.tradierClient?.unsubscribeFromAll();
+                break;
+            case Broker.TASTYTRADE:
+                this.tastyTradeClient?.unsubscribeFromAll();
+                break;
+            case Broker.TRADESTATION:
+                this.tradeStationClient?.unsubscribeFromAll();
+                break;
+            case Broker.SCHWAB:
+                this.schwabClient?.unsubscribeFromAll();
+                break;
+            default:
+                throw new Error(`Unsupported broker: ${this.currentBroker}`);
+        }
+    }
     /**
      * Fetches open interest and initial option data via REST API.
      *

package/dist/client/brokers/SchwabClient.d.ts

@@ -251,6 +251,10 @@ export declare class SchwabClient {
      * @param symbols - Array of symbols to unsubscribe from
      */
     unsubscribe(symbols: string[]): void;
+    /**
+     * Unsubscribes from all real-time updates.
+     */
+    unsubscribeFromAll(): void;
     /**
      * Returns whether the client is currently connected.
      */

package/dist/client/brokers/SchwabClient.js

@@ -276,6 +276,31 @@ class SchwabClient {
             this.unsubscribeOptionsBook(options);
         }
     }
+    /**
+     * Unsubscribes from all real-time updates.
+     */
+    unsubscribeFromAll() {
+        const allSymbols = Array.from(this.subscribedSymbols);
+        const allOptionSymbols = allSymbols.filter(s => this.isOptionSymbol(s)).map(s => this.toSchwabOptionSymbol(s));
+        this.subscribedSymbols.clear();
+        // unsub from all equities
+        if (allSymbols.length > 0) {
+            const request = this.makeRequest('LEVELONE_EQUITIES', 'UNSUBS', {
+                keys: allSymbols.join(','),
+            });
+            this.sendMessage({ requests: [request] });
+        }
+        // unsub from all options (quotes and book)
+        if (allOptionSymbols.length > 0) {
+            const requestOptions = this.makeRequest('LEVELONE_OPTIONS', 'UNSUBS', {
+                keys: allOptionSymbols.join(','),
+            });
+            const requestBook = this.makeRequest('OPTIONS_BOOK', 'UNSUBS', {
+                keys: allOptionSymbols.join(','),
+            });
+            this.sendMessage({ requests: [requestOptions, requestBook] });
+        }
+    }
     /**
      * Returns whether the client is currently connected.
      */

package/dist/client/brokers/TastyTradeClient.d.ts

@@ -201,6 +201,10 @@ export declare class TastyTradeClient {
      * @param symbols - Array of symbols to unsubscribe from
      */
     unsubscribe(symbols: string[]): void;
+    /**
+     * Unsubscribes from all real-time updates.
+     */
+    unsubscribeFromAll(): void;
     /**
      * Returns whether the client is currently connected.
      */

package/dist/client/brokers/TastyTradeClient.js

@@ -226,6 +226,17 @@ class TastyTradeClient {
         }
         this.sendFeedSubscription(symbols, 'remove');
     }
+    /**
+     * Unsubscribes from all real-time updates.
+     */
+    unsubscribeFromAll() {
+        const symbols = Array.from(this.subscribedSymbols);
+        this.subscribedSymbols.clear();
+        if (!this.connected || !this.feedChannelOpened) {
+            return;
+        }
+        this.sendFeedSubscription(symbols, 'remove');
+    }
     /**
      * Returns whether the client is currently connected.
      */

package/dist/client/brokers/TradeStationClient.d.ts

@@ -177,6 +177,10 @@ export declare class TradeStationClient {
      * restarting with the remaining symbols.
      */
     unsubscribe(symbols: string[]): void;
+    /**
+     * Unsubscribes from all real-time updates.
+     */
+    unsubscribeFromAll(): void;
     /**
      * Returns whether the client is currently connected.
      */

package/dist/client/brokers/TradeStationClient.js

@@ -217,6 +217,15 @@ class TradeStationClient {
             this.stopStream('options');
         }
     }
+    /**
+     * Unsubscribes from all real-time updates.
+     */
+    unsubscribeFromAll() {
+        this.subscribedTickers.clear();
+        this.subscribedOptions.clear();
+        this.stopStream('quotes');
+        this.stopStream('options');
+    }
     /**
      * Returns whether the client is currently connected.
      */

package/dist/client/brokers/TradierClient.d.ts

@@ -182,11 +182,18 @@ export declare class TradierClient {
      * @param symbols - Array of symbols to unsubscribe from
      *
      * @remarks
-     * Note: Tradier's streaming API doesn't support unsubscription for individual
-     * symbols. This method removes them from local tracking. To fully unsubscribe,
-     * you would need to disconnect and reconnect with the new symbol list.
+     * Since Tradier's streaming API doesn't support selective unsubscription,
+     * this method disconnects and reconnects with the updated symbol list.
      */
-    unsubscribe(symbols: string[]): void;
+    unsubscribe(symbols: string[]): Promise<void>;
+    /**
+     * Unsubscribes from all symbols.
+     *
+     * @remarks
+     * Since Tradier's streaming API doesn't support selective unsubscription,
+     * this method disconnects and reconnects without any symbols.
+     */
+    unsubscribeFromAll(): Promise<void>;
     /**
      * Returns whether the client is currently connected.
      */
@@ -251,6 +258,11 @@ export declare class TradierClient {
      * Attempts to reconnect with exponential backoff.
      */
     private attemptReconnect;
+    /**
+     * Reconnects with the current symbol list.
+     * Used for unsubscribe operations since Tradier doesn't support selective unsubscription.
+     */
+    private reconnectWithSymbols;
     /**
      * Handles incoming WebSocket messages.
      */

package/dist/client/brokers/TradierClient.js

@@ -142,14 +142,29 @@ class TradierClient {
      * @param symbols - Array of symbols to unsubscribe from
      *
      * @remarks
-     * Note: Tradier's streaming API doesn't support unsubscription for individual
-     * symbols. This method removes them from local tracking. To fully unsubscribe,
-     * you would need to disconnect and reconnect with the new symbol list.
+     * Since Tradier's streaming API doesn't support selective unsubscription,
+     * this method disconnects and reconnects with the updated symbol list.
      */
-    unsubscribe(symbols) {
+    async unsubscribe(symbols) {
         symbols.forEach(s => this.subscribedSymbols.delete(s));
-        // Note: Tradier doesn't support selective unsubscribe
-        // Would need to reconnect with new symbol list for full effect
+        // If connected, reconnect with the new symbol list
+        if (this.connected) {
+            await this.reconnectWithSymbols();
+        }
+    }
+    /**
+     * Unsubscribes from all symbols.
+     *
+     * @remarks
+     * Since Tradier's streaming API doesn't support selective unsubscription,
+     * this method disconnects and reconnects without any symbols.
+     */
+    async unsubscribeFromAll() {
+        this.subscribedSymbols.clear();
+        // If connected, reconnect with empty symbol list
+        if (this.connected) {
+            await this.reconnectWithSymbols();
+        }
     }
     /**
      * Returns whether the client is currently connected.
@@ -431,6 +446,21 @@ class TradierClient {
             // Reconnect attempt failed, will try again via onclose
         }
     }
+    /**
+     * Reconnects with the current symbol list.
+     * Used for unsubscribe operations since Tradier doesn't support selective unsubscription.
+     */
+    async reconnectWithSymbols() {
+        if (this.verbose) {
+            console.log(`[Tradier:WS] Reconnecting with ${this.subscribedSymbols.size} symbols`);
+        }
+        // Disconnect cleanly
+        this.disconnect();
+        // Wait briefly to ensure clean disconnect
+        await this.sleep(100);
+        // Reconnect with current symbol list
+        await this.connect();
+    }
     /**
      * Handles incoming WebSocket messages.
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fullstackcraftllc/floe",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "description": "Production-ready options analytics toolkit. Normalize broker data structures and calculate Black-Scholes, Greeks, and exposures with a clean, type-safe API. Built for trading platforms and fintech applications.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",