schwab_rb 1.0.2 → 1.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ded8507159f0890f4e0b0d2ad2d17bb009667423fd088eeb30f914acefa72bcf
-  data.tar.gz: d2ad202eb8e83e7ce4aeee47f97f91e4a258200cee0b119b98fcdcc89912de7c
+  metadata.gz: 80e57e5f4da3062980fd00cfbce3661185d36a6ccd34a87d51c3d6cd8c3400f8
+  data.tar.gz: 1f2ec23196743009009fda3942719b680e474a25dbf54cb5d412f25203140abf
 SHA512:
-  metadata.gz: d396924935ff3058b2a09a3266ab4ab7702c6897260b1584186967d282a928f292cf8a726f5c9f7bd93d9657e9c1fea7f3ac06c51f3e9885e77c0a7e54a428d0
-  data.tar.gz: ebe03d4d4ac61df89d8d06fde06f9e098074a1bcf550adef79976291cbc271d6a82be8c36d2b7cbddd77b1f7e91181b982fc3dde3c45b18f7c695b10a73c46ef
+  metadata.gz: cd23d7763c0ee77ec39a45bb653d4c65f4a19ae1962b12c9c3c51cd1b7035114158fb77f36e090a3909d2d08dd88f32b6626d92fa5f038b3a563ff369dbfce49
+  data.tar.gz: 17bab9ddddca12ed8e69b580936c4f166088cd8e919d530ad690375d0bf674fc4eab539cfd5b7c241f56358c2182cca59e9d3f4b4b3e6db15dcfa8efbe67ae52

data/CHANGELOG.md

@@ -1,5 +1,30 @@
 ## [Unreleased]
 
+## [1.0.4] - 2026-09-21
+
+### Added
+- Dynamic symbol unsubscription (`stream.unsub`) using Schwab `UNSUBS` command to remove symbols as market windows close without disconnecting.
+- `stream.add` method (alias for `on`) for explicitly adding subscriptions to active streams.
+
+### Fixed
+- Treat `nil` socket read in `Base#run_receive_loop` as disconnect error instead of clean exit to prevent silent reconnect spin loops.
+- Outbound WebSocket write synchronization using a Mutex to prevent framing issues when subscriptions change dynamically.
+
+## [1.0.3] - 2026-09-19
+
+### Fixed
+- Prevent `load_token` from deleting database row on expired access token (#33).
+
+## [1.0.2] - 2026-09-18
+
+### Fixed
+- Fix WebSocket framing to resolve stream login bad command formatting (#32).
+
+## [1.0.1] - 2026-09-17
+
+### Fixed
+- Fix stream login authorization header formatting and STDOUT logger routing (#30).
+
 ## [1.0.0] - 2026-09-05
 
 ### Breaking Changes

data/README.md

@@ -164,6 +164,47 @@ price_history = client.get_price_history(
 )
 ```
 
+### Real-Time WebSocket Streaming
+
+Stream Level 1 quotes, Level 2 order books, chart candles, and account activity over a single WebSocket connection:
+
+```ruby
+client = SchwabRb::Auth.init_client_easy(
+  ENV['SCHWAB_API_KEY'],
+  ENV['SCHWAB_APP_SECRET'],
+  ENV['APP_CALLBACK_URL']
+)
+
+stream = SchwabRb::Stream::Client.new(client)
+
+# Subscribe to Level 1 Equities
+stream.on(:level_one_equities, symbols: %w[SPY QQQ], fields: :all) do |event|
+  puts "Equity quote: #{event}"
+end
+
+# Subscribe to Level 1 Futures
+stream.on(:level_one_futures, symbols: ["/ES"], fields: :all) do |event|
+  puts "Futures quote: #{event}"
+end
+
+# Subscribe to Level 2 Order Book
+stream.on(:nyse_book, symbols: ["SPY"], fields: :all) do |event|
+  puts "Order book: #{event}"
+end
+
+# Start async in a background thread
+stream.start_async
+
+# Dynamically add symbols while streaming
+stream.add(:level_one_equities, symbols: ["IWM"])
+
+# Dynamically remove symbols when window closes without dropping stream
+stream.unsub(:level_one_equities, symbols: ["SPY", "QQQ"])
+
+# Stop streaming when finished
+stream.stop
+```
+
 ## Data Objects
 
 The gem includes structured data objects for better handling of API responses. Most API methods support a `return_data_objects` parameter (defaults to `true`) which returns parsed Ruby objects instead of raw JSON responses:

data/lib/schwab_rb/storage/database.rb

@@ -30,18 +30,12 @@ module SchwabRb
         end
         return nil unless row
 
-        expires_at = row["expires_at"]
-        if expires_at && Time.now.to_i > expires_at
-          synchronize { db.execute("DELETE FROM tokens WHERE api_key = ?", [api_key]) }
-          return nil
-        end
-
         {
           "timestamp" => row["timestamp"],
           "token" => {
             "access_token" => row["access_token"],
             "refresh_token" => row["refresh_token"],
-            "expires_at" => expires_at,
+            "expires_at" => row["expires_at"],
             "expires_in" => row["expires_in"],
             "token_type" => row["token_type"],
             "scope" => row["scope"],

data/lib/schwab_rb/stream/base.rb

@@ -27,13 +27,14 @@ module SchwabRb
         @connect_time = nil
         @backoff_time = INITIAL_BACKOFF
         @should_run = false
+        @write_mutex = Mutex.new
       end
 
       def on(service_symbol, symbols: nil, fields: nil, &block)
         service_name = Services.lookup(service_symbol)
         resolved_fields = fields ? Fields.resolve(service_name, fields) : nil
 
-        handler = { symbols: Array(symbols), fields: resolved_fields, callback: block }
+        handler = { symbols: Array(symbols).map(&:to_s), fields: resolved_fields, callback: block }
         @handlers[service_name] ||= []
         @handlers[service_name] << handler
 
@@ -46,6 +47,36 @@ module SchwabRb
 
         self
       end
+      alias add on
+
+      def unsub(service_symbol, symbols: nil)
+        service_name = Services.lookup(service_symbol)
+        symbols_to_remove = Array(symbols).map(&:to_s)
+        return self if symbols_to_remove.empty?
+
+        if @subscriptions[service_name]
+          @subscriptions[service_name][:symbols] -= symbols_to_remove
+          @subscriptions.delete(service_name) if @subscriptions[service_name][:symbols].empty?
+        end
+
+        if @handlers[service_name]
+          @handlers[service_name].each do |h|
+            h[:symbols] -= symbols_to_remove
+          end
+          @handlers[service_name].reject! { |h| h[:symbols].empty? }
+          @handlers.delete(service_name) if @handlers[service_name].empty?
+        end
+
+        if @connected
+          request = @message_builder.build_request(
+            service_name, Commands::UNSUBS,
+            keys: symbols_to_remove
+          )
+          send_message(@message_builder.wrap_requests(request))
+        end
+
+        self
+      end
 
       def start
         @should_run = true
@@ -64,7 +95,7 @@ module SchwabRb
 
       def stop
         @should_run = false
-        disconnect
+        @connected = false
       end
 
       def connected?
@@ -161,7 +192,7 @@ module SchwabRb
       def run_receive_loop
         while @connected && @should_run
           message = @connection.read
-          break if message.nil?
+          raise "Connection closed by remote host" if message.nil?
 
           parsed = JSON.parse(message.to_str)
           dispatch_message(parsed)
@@ -221,9 +252,13 @@ module SchwabRb
       end
 
       def send_message(json_string)
-        SchwabRb::Logger.logger.debug("Stream sending: #{json_string}")
-        @connection.write(json_string)
-        @connection.flush
+        @write_mutex.synchronize do
+          return unless @connection
+
+          SchwabRb::Logger.logger.debug("Stream sending: #{json_string}")
+          @connection.write(json_string)
+          @connection.flush
+        end
       end
 
       def merge_subscription(existing, handler)

data/lib/schwab_rb/stream/client.rb

@@ -15,6 +15,12 @@ module SchwabRb
         @stream.on(service_symbol, symbols: symbols, fields: fields, &block)
         self
       end
+      alias add on
+
+      def unsub(service_symbol, symbols: nil)
+        @stream.unsub(service_symbol, symbols: symbols)
+        self
+      end
 
       def start
         @thread = Thread.new do
@@ -32,6 +38,7 @@ module SchwabRb
 
       def stop
         @stream.stop
+        @thread&.raise(Interrupt)
         @thread&.join(5)
         @thread = nil
       end

data/lib/schwab_rb/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SchwabRb
-  VERSION = "1.0.2"
+  VERSION = "1.0.4"
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: schwab_rb
 version: !ruby/object:Gem::Version
-  version: 1.0.2
+  version: 1.0.4
 platform: ruby
 authors:
 - Joseph Platta
 bindir: exe
 cert_chain: []
-date: 2026-09-06 00:00:00.000000000 Z
+date: 2026-09-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: async