datastar 1.0.0.pre.2 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f7e29e806ab458bbc154d64f12998a7cc9d66b69a93dd5940a140a1488f976cf
-  data.tar.gz: 4ada005096ab64dd593c3527acce4534ddd034682e7fcf7aa99c3aeb658e6b39
+  metadata.gz: cc94dbbe291bd86a1aaae4302cd8fdaa0262f06bcbf0bb81ce201099a92de0b7
+  data.tar.gz: 804810f5e0633c690d329f79e3eb220734cb558767f951be18b383bfdd97fcd9
 SHA512:
-  metadata.gz: 9c8cd42612fec2a37934adb7d282555f967d7f1812b76cad562ace2c916a543976afc3a4ebb367aa80965816b359dc5d1f9e0151633ff1565e40c6ad0a8c2d0f
-  data.tar.gz: 411d02ce73b1fe37a6b46f1b3306f26507083bcddcb73c1213344976516f666eb3c7f859322a20fcab8a09042fd1286e714f82add2369c81472ff66e13542c15
+  metadata.gz: 22716ea763849a6f6aae0a762809b29662e8dfb279dd2bcd0165b2af3a53cb8cbed31f57c8c4af8db55e1f9e54764243741265b01c6d9772eb28b2197790977b
+  data.tar.gz: 88efa4fb0a989d5d05548a8264650b89a08f1af6cb6bdcbb848da36e6aa09cc8c37729233ed867fbfdb2a9cfeb3fd8944f27a7b8c618259a569b451d8f0b3a92

data/LICENSE.md

@@ -1,19 +1,7 @@
-Copyright (c) Ismael Celis
+Copyright © Star Federation
 
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -160,7 +160,7 @@ sse.execute_script(%(alert('Hello World!')), auto_remove: false)
 ```
 
 #### `signals`
-See https://data-star.dev/guide/getting_started#data-signals
+See https://data-star.dev/guide/reactive_signals
 
 Returns signals sent by the browser.
 
@@ -348,13 +348,14 @@ bundle install
 From this library's root, run the bundled-in test Rack app:
 
 ```bash
-bundle puma examples/test.ru
+bundle puma -p 8000 examples/test.ru
 ```
 
-Now run the test bash scripts in the `sdk/test` directory in this repo.
+From the main [Datastar](https://github.com/starfederation/datastar) repo (you'll need Go installed)
 
 ```bash
-./test-all.sh http://localhost:9292
+cd sdk/tests
+go run ./cmd/datastar-sdk-tests -server http://localhost:8000 
 ```
 
 ## Development

data/examples/hello-world/Gemfile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+gem 'puma'
+gem 'rack'
+# gem 'datastar'
+gem 'datastar', path: '../../../'

data/examples/hello-world/Gemfile.lock

@@ -0,0 +1,29 @@
+PATH
+  remote: ../../..
+  specs:
+    datastar (1.0.0)
+      json
+      logger
+      rack (>= 3.1.14)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    json (2.16.0)
+    logger (1.7.0)
+    nio4r (2.7.4)
+    puma (6.6.0)
+      nio4r (~> 2.0)
+    rack (3.1.16)
+
+PLATFORMS
+  arm64-darwin-24
+  ruby
+
+DEPENDENCIES
+  datastar!
+  puma
+  rack
+
+BUNDLED WITH
+   2.6.3

data/examples/hello-world/hello-world.html

@@ -0,0 +1,35 @@
+<!-- This is auto-generated by Datastar. DO NOT EDIT. -->
+
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <title>Datastar SDK Demo</title>
+    <script src="https://unpkg.com/@tailwindcss/browser@4"></script>
+    <script type="module" src="https://cdn.jsdelivr.net/gh/starfederation/datastar@1.0.0-RC.6/bundles/datastar.js"></script>
+</head>
+<body class="bg-white dark:bg-gray-900 text-lg max-w-xl mx-auto my-16">
+    <div data-signals:delay="400" class="bg-white dark:bg-gray-800 text-gray-500 dark:text-gray-400 rounded-lg px-6 py-8 ring shadow-xl ring-gray-900/5 space-y-2">
+        <div class="flex justify-between items-center">
+            <h1 class="text-gray-900 dark:text-white text-3xl font-semibold">
+                Datastar SDK Demo
+            </h1>
+            <img src="https://data-star.dev/static/images/rocket-64x64.png" alt="Rocket" width="64" height="64"/>
+        </div>
+        <p class="mt-2">
+            SSE events will be streamed from the backend to the frontend.
+        </p>
+        <div class="space-x-2">
+            <label for="delay">
+                Delay in milliseconds
+            </label>
+            <input data-bind:delay id="delay" type="number" step="100" min="0" class="w-36 rounded-md border border-gray-300 px-3 py-2 placeholder-gray-400 shadow-sm focus:border-sky-500 focus:outline focus:outline-sky-500 dark:disabled:border-gray-700 dark:disabled:bg-gray-800/20" />
+        </div>
+        <button data-on:click="@get(&#39;/hello-world&#39;)" class="rounded-md bg-sky-500 px-5 py-2.5 leading-5 font-semibold text-white hover:bg-sky-700 hover:text-gray-100 cursor-pointer">
+            Start
+        </button>
+    </div>
+    <div class="my-16 text-8xl font-bold text-transparent" style="background: linear-gradient(to right in oklch, red, orange, yellow, green, blue, blue, violet); background-clip: text">
+        <div id="message">Hello, world!</div>
+    </div>
+</body>
+</html>

data/examples/hello-world/hello-world.ru

@@ -0,0 +1,37 @@
+require 'bundler/setup'
+
+require 'datastar'
+
+# This is a test Rack endpoint
+# with a hello world example using Datastar.
+# To run:
+#
+#   # install dependencies
+#   bundle install
+#   # run this endpoint with Puma server
+#   bundle exec puma ./hello-world.ru
+#
+#   Then open http://localhost:9292
+#
+HTML = File.read(File.expand_path('hello-world.html', __dir__))
+
+run do |env|
+  datastar = Datastar.from_rack_env(env)
+
+  if datastar.sse?
+    delay = (datastar.signals['delay'] || 0).to_i
+    delay /= 1000.0 if delay.positive?
+    message = 'Hello, world!'
+
+    datastar.stream do |sse|
+      message.size.times do |i|
+        sse.patch_elements(%(<div id="message">#{message[0..i]}</div>))
+        sleep delay
+      end
+    end
+  else
+    [200, { 'content-type' => 'text/html' }, [HTML]]
+  end
+end
+
+trap('INT') { exit }

data/examples/progress/progress.ru

@@ -0,0 +1,307 @@
+require 'bundler'
+Bundler.setup(:test)
+
+require 'datastar'
+
+# This is a demo Rack app to showcase patching components and signals
+# from the server to the client.
+# To run:
+#
+#   # install dependencies
+#   bundle install
+#   # run this endpoint with Puma server
+#   bundle exec puma ./progress.ru
+#
+#   Then open http://localhost:9292
+#
+# A Web Component for circular progress
+# Progress is controlled by a `progress` signal
+PROGRESS = <<~JAVASCRIPT
+  class CircularProgress extends HTMLElement {
+      constructor() {
+          super();
+          this.attachShadow({ mode: 'open' });
+          this._progress = 0;
+          this.radius = 90;
+          this.circumference = 2 * Math.PI * this.radius;
+      }
+
+      static get observedAttributes() {
+          return ['progress'];
+      }
+
+      get progress() {
+          return this._progress;
+      }
+
+      attributeChangedCallback(name, oldValue, newValue) {
+          if (name === 'progress' && oldValue !== newValue) {
+              this._progress = Math.max(0, Math.min(100, parseFloat(newValue) || 0));
+              this.updateProgress();
+          }
+     }
+
+      connectedCallback() {
+          this.render();
+      }
+
+      render() {
+          this.shadowRoot.innerHTML = `
+              <slot></slot>
+              <svg
+                  width="200"
+                  height="200"
+                  viewBox="-25 -25 250 250"
+                  style="transform: rotate(-90deg)"
+              >
+                  <!-- Background circle -->
+                  <circle
+                      r="${this.radius}"
+                      cx="100"
+                      cy="100"
+                      fill="transparent"
+                      stroke="#e0e0e0"
+                      stroke-width="16px"
+                      stroke-dasharray="${this.circumference}px"
+                      stroke-dashoffset="${this.circumference}px"
+                  ></circle>
+                  
+                  <!-- Progress circle -->
+                  <circle
+                      id="progress-circle"
+                      r="${this.radius}"
+                      cx="100"
+                      cy="100"
+                      fill="transparent"
+                      stroke="#6bdba7"
+                      stroke-width="16px"
+                      stroke-linecap="round"
+                      stroke-dasharray="${this.circumference}px"
+                      style="transition: stroke-dashoffset 0.1s ease-in-out"
+                  ></circle>
+                  
+                  <!-- Progress text -->
+                  <text
+                      id="progress-text"
+                      x="44px"
+                      y="115px"
+                      fill="#6bdba7"
+                      font-size="52px"
+                      font-weight="bold"
+                      style="transform:rotate(90deg) translate(0px, -196px)"
+                  ></text>
+              </svg>
+          `;
+      }
+
+      updateProgress() {
+          if (!this.shadowRoot) return;
+
+          const progressCircle = this.shadowRoot.getElementById('progress-circle');
+          const progressText = this.shadowRoot.getElementById('progress-text');
+          
+          if (progressCircle && progressText) {
+              // Calculate stroke-dashoffset based on progress
+              const offset = this.circumference - (this._progress / 100) * this.circumference;
+              progressCircle.style.strokeDashoffset = `${offset}px`;
+              
+              // Update text
+              progressText.textContent = `${Math.round(this._progress)}%`;
+          }
+      }
+  }
+
+  // Register the custom element
+  customElements.define('circular-progress', CircularProgress);
+JAVASCRIPT
+
+# The initial index HTML page
+INDEX = <<~HTML
+  <!DOCTYPE html>
+  <html>
+    <head>
+      <meta charset="UTF-8">
+      <title>Datastar progress-circle</title>
+      <style>
+        body {
+            font-family: Arial, sans-serif;
+            padding: 20px;
+            background-color: #f5f5f5;
+        }
+        .demo-container {
+            max-width: 800px;
+            margin: 0 auto;
+            background: white;
+            padding: 30px;
+            border-radius: 10px;
+            box-shadow: 0 2px 10px rgba(0,0,0,0.1);
+        }
+        button {
+            background: linear-gradient(135deg, #6bdba7 0%, #5bc399 100%);
+            color: white;
+            border: none;
+            padding: 12px 24px;
+            font-size: 16px;
+            font-weight: 600;
+            border-radius: 8px;
+            cursor: pointer;
+            transition: all 0.2s ease;
+            box-shadow: 0 2px 4px rgba(107, 219, 167, 0.3);
+            margin-bottom: 20px;
+        }
+        button:hover:not([aria-disabled="true"]) {
+            background: linear-gradient(135deg, #5bc399 0%, #4db389 100%);
+            transform: translateY(-1px);
+            box-shadow: 0 4px 8px rgba(107, 219, 167, 0.4);
+        }
+        button:active:not([aria-disabled="true"]) {
+            transform: translateY(0);
+            box-shadow: 0 2px 4px rgba(107, 219, 167, 0.3);
+        }
+        button[aria-disabled="true"] {
+            background: #e0e0e0;
+            color: #999;
+            cursor: not-allowed;
+            box-shadow: none;
+        }
+        .col {
+            flex: 1;
+            padding: 0 15px;
+            min-height: 340px;
+        }
+        .col:first-child {
+            padding-left: 0;
+            display: flex;
+            flex-direction: column;
+            align-items: center;
+            justify-content: center;
+        }
+        .col:last-child {
+            padding-right: 0;
+        }
+        @media (min-width: 768px) {
+            .demo-container {
+                display: flex;
+                gap: 30px;
+            }
+        }
+        #activity {
+            overflow-y: auto;
+            border: 1px solid #e0e0e0;
+            border-radius: 8px;
+            padding: 16px;
+            background: #fafafa;
+        }
+        .a-item {
+            background: white;
+            border: 1px solid #e8e8e8;
+            border-radius: 6px;
+            padding: 12px 16px;
+            margin-bottom: 8px;
+            font-size: 14px;
+            color: #333;
+            box-shadow: 0 1px 2px rgba(0,0,0,0.05);
+            transition: all 0.2s ease;
+        }
+        .a-item:last-child {
+            margin-bottom: 0;
+        }
+        .a-item:hover {
+            background: #f8f9fa;
+            border-color: #d0d0d0;
+        }
+        .a-item .time {
+            display: block;
+            font-size: 11px;
+            color: #888;
+            margin-bottom: 4px;
+            font-family: monospace;
+        }
+        .a-item.done {
+            background: #f0f9f4;
+            border-color: #6bdba7;
+            color: #2d5a3d;
+        }
+        .a-item.done .time {
+            color: #5a8a6a;
+        }
+        #title {
+          text-align: center;
+        }
+      </style>
+      <script type="module">#{PROGRESS}</script>
+      <script type="module" src="https://cdn.jsdelivr.net/gh/starfederation/datastar@1.0.0-RC.6/bundles/datastar.js"></script>
+    </head>
+    <body>
+      <div class="demo-container">
+        <div class="col">
+          <p>
+            <button 
+                data-indicator:_fetching 
+                data-on:click="!$_fetching && @get('/', {openWhenHidden: true})"
+                data-attr:aria-disabled="`${$_fetching}`"
+              >Start</button>
+          </p>
+          <div id="work">
+          </div>
+        </div>
+
+        <div class="col" id="activity">
+        </div>
+      </div>
+    </body>
+  <html>
+HTML
+
+trap('INT') { exit }
+
+# The server-side app
+# It handles the initial page load and serves the initial HTML.
+# It also handles Datastar SSE requests and streams updates to the client.
+run do |env|
+  datastar = Datastar
+             .from_rack_env(env)
+             .on_connect do |socket|
+    p ['connect', socket]
+  end.on_server_disconnect do |socket|
+    p ['server disconnect', socket]
+  end.on_client_disconnect do |socket|
+    p ['client disconnect', socket]
+  end.on_error do |error|
+    p ['exception', error]
+    puts error.backtrace.join("\n")
+  end
+
+  if datastar.sse? # <= we're in a Datastar SSE request
+
+    # A thread to simulate the work and control the progress component
+    datastar.stream do |sse|
+      # Reset activity
+      sse.patch_elements(%(<div id="activity" class="col"></div>))
+
+      # step 1: add the initial progress component to the DOM
+      sse.patch_elements(%(<circular-progress id="work" data-bind:progress data-attr:progress="$progress"><h1 id="title">Processing...</h1></circular-progress>))
+
+      # step 2: simulate work and update the progress signal
+      0.upto(100) do |i|
+        sleep rand(0.03..0.09) # Simulate work
+        sse.patch_signals(progress: i)
+      end
+
+      # step 3: update the DOM to indicate completion
+      # sse.patch_elements(%(<p id="work">Done!</p>))
+      sse.patch_elements(%(<div class="a-item done"><span class="time">#{Time.now.iso8601}</span>Done!</div>), selector: '#activity', mode: 'append')
+      sse.patch_elements(%(<h1 id="title">Done!</h1>))
+    end
+
+    # A second thread to push activity updates to the UI
+    datastar.stream do |sse|
+      ['Work started', 'Connecting to API', 'downloading data', 'processing data'].each do |activity|
+        sse.patch_elements(%(<div class="a-item"><span class="time">#{Time.now.iso8601}</span>#{activity}</div>), selector: '#activity', mode: 'append')
+        sleep rand(0.5..1.7) # Simulate time taken for each activity
+      end
+    end
+  else # <= We're in a regular HTTP request
+    [200, { 'content-type' => 'text/html' }, [INDEX]]
+  end
+end

data/examples/test.ru

@@ -32,7 +32,7 @@ run do |env|
   end
 
   datastar.stream do |sse|
-    sse.signals['events'].each do |event|
+    (sse.signals['events'] || []).each do |event|
       type = event.delete('type')
       case type
       when 'patchSignals'

data/examples/threads/Gemfile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+gem 'puma'
+gem 'rack'
+# gem 'datastar'
+gem 'datastar', path: '../../../'

data/examples/threads/Gemfile.lock

@@ -0,0 +1,29 @@
+PATH
+  remote: ../../..
+  specs:
+    datastar (1.0.0)
+      json
+      logger
+      rack (>= 3.1.14)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    json (2.16.0)
+    logger (1.7.0)
+    nio4r (2.7.4)
+    puma (6.6.0)
+      nio4r (~> 2.0)
+    rack (3.1.16)
+
+PLATFORMS
+  arm64-darwin-24
+  ruby
+
+DEPENDENCIES
+  datastar!
+  puma
+  rack
+
+BUNDLED WITH
+   2.6.3

data/examples/threads/threads.ru

@@ -0,0 +1,84 @@
+require 'bundler/setup'
+
+require 'datastar'
+
+# This is a test Rack endpoint
+# to demo streaming Datastar updates from multiple threads.
+# To run:
+#
+#   # install dependencies
+#   bundle install
+#   # run this endpoint with Puma server
+#   bundle exec puma threads.ru
+#
+#   visit http://localhost:9292
+#
+INDEX = <<~HTML
+  <!DOCTYPE html>
+  <html>
+    <head>
+      <meta charset="UTF-8">
+      <title>Datastar counter</title>
+      <style>
+        body { padding: 10em; }
+        .counter {#{' '}
+          font-size: 2em;#{' '}
+          span { font-weight: bold; }
+        }
+      </style>
+      <script type="module" src="https://cdn.jsdelivr.net/gh/starfederation/datastar@1.0.0-RC.6/bundles/datastar.js"></script>
+    </head>
+    <body>
+      <button#{' '}
+        data-on:click="@get('/')"#{' '}
+        data-indicator:heartbeat#{' '}
+        >Start</button>
+      <p class="counter">Slow thread: <span id="slow">waiting</span></p>
+      <p class="counter">Fast thread: <span id="fast">waiting</span></p>
+      <p id="connection">Disconnected...</p>
+    </body>
+  <html>
+HTML
+
+trap('INT') { exit }
+
+run do |env|
+  # Initialize Datastar with callbacks
+  datastar = Datastar
+             .from_rack_env(env)
+             .on_connect do |sse|
+    sse.patch_elements(%(<p id="connection">Connected...</p>))
+    p ['connect', sse]
+  end.on_server_disconnect do |sse|
+    sse.patch_elements(%(<p id="connection">Done...</p>))
+    p ['server disconnect', sse]
+  end.on_client_disconnect do |socket|
+    p ['client disconnect', socket]
+  end.on_error do |error|
+    p ['exception', error]
+    puts error.backtrace.join("\n")
+  end
+
+  if datastar.sse?
+    # This will run in its own thread / fiber
+    datastar.stream do |sse|
+      11.times do |i|
+        sleep 1
+        # Raising an error to demonstrate error handling
+        # raise ArgumentError, 'This is an error' if i > 5
+
+        sse.patch_elements(%(<span id="slow">#{i}</span>))
+      end
+    end
+
+    # Another thread / fiber
+    datastar.stream do |sse|
+      1000.times do |i|
+        sleep 0.01
+        sse.patch_elements(%(<span id="fast">#{i}</span>))
+      end
+    end
+  else
+    [200, { 'content-type' => 'text/html' }, [INDEX]]
+  end
+end

data/lib/datastar/async_executor.rb

@@ -22,7 +22,9 @@ module Datastar
 
     def new_queue = Async::Queue.new
 
-    def prepare(response); end
+    def prepare(response)
+      response.delete_header 'Connection'
+    end
 
     def spawn(&block)
       Async(&block)

data/lib/datastar/dispatcher.rb

@@ -285,7 +285,7 @@ module Datastar
       proc do |socket|
         generator = ServerSentEventGenerator.new(socket, signals:, view_context: @view_context)
         @on_connect.each { |callable| callable.call(generator) }
-        handling_errors(generator, socket) do
+        handling_sync_errors(generator, socket) do
           streamer.call(generator)
         end
       ensure
@@ -313,9 +313,10 @@ module Datastar
         @on_connect.each { |callable| callable.call(conn_generator) }
 
         threads = @streamers.map do |streamer|
+          duped_signals = signs.dup.freeze
           @executor.spawn do
             # TODO: Review thread-safe view context
-            generator = ServerSentEventGenerator.new(@queue, signals: signs, view_context: @view_context)
+            generator = ServerSentEventGenerator.new(@queue, signals: duped_signals, view_context: @view_context)
             streamer.call(generator)
             @queue << :done
           rescue StandardError => e
@@ -323,7 +324,12 @@ module Datastar
           end
         end
 
-        handling_errors(conn_generator, socket) do
+        # Now launch the control thread that actually writes to the socket
+        # We don't want to block the main thread, so that servers like Puma
+        # which have a limited thread pool can keep serving other requests
+        # Other streamers will push any StandardError exceptions to the queue
+        # So we handle them here
+        @executor.spawn do
           done_count = 0
           threads_size = @heartbeat_on ? threads.size - 1 : threads.size
 
@@ -332,24 +338,46 @@ module Datastar
               done_count += 1
               @queue << nil if done_count == threads_size
             elsif data.is_a?(Exception)
-              raise data
+              handle_streaming_error(data, socket)
+              @queue << nil
             else
-              socket << data
+              # Here we attempt writing to the actual socket
+              # which may raise an IOError if the client disconnected
+              begin
+                socket << data
+              rescue Exception => e
+                handle_streaming_error(e, socket)
+                @queue << nil
+              end
             end
           end
+
+        ensure
+          @on_server_disconnect.each { |callable| callable.call(conn_generator) }
+          @executor.stop(threads) if threads
+          socket.close
         end
-      ensure
-        @executor.stop(threads) if threads
-        socket.close
       end
     end
 
-    # Run a streaming block while handling errors
+    # Handle errors caught during streaming
+    # @param error [Exception] the error that occurred
+    # @param socket [IO] the socket to pass to error handlers
+    def handle_streaming_error(error, socket)
+      case error
+      when IOError, Errno::EPIPE, Errno::ECONNRESET
+        @on_client_disconnect.each { |callable| callable.call(socket) }
+      when Exception
+        @on_error.each { |callable| callable.call(error) }
+      end
+    end
+
+    # Run a block while handling errors
     # @param generator [ServerSentEventGenerator]
     # @param socket [IO]
     # @yield
     # @api private
-    def handling_errors(generator, socket, &)
+    def handling_sync_errors(generator, socket, &)
       yield
 
       @on_server_disconnect.each { |callable| callable.call(generator) }

data/lib/datastar/server_sent_event_generator.rb

@@ -24,6 +24,9 @@ module Datastar
 
     attr_reader :signals
 
+    # @param stream [IO, Queue] The IO stream or Queue to write to
+    # @option signals [Hash] A hash of signals (params)
+    # @option view_context [Object] The view context for rendering elements, if applicable.
     def initialize(stream, signals:, view_context: nil)
       @stream = stream
       @signals = signals

data/lib/datastar/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Datastar
-  VERSION = '1.0.0.pre.2'
+  VERSION = '1.0.1'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: datastar
 version: !ruby/object:Gem::Version
-  version: 1.0.0.pre.2
+  version: 1.0.1
 platform: ruby
 authors:
 - Ismael Celis
@@ -75,7 +75,15 @@ files:
 - LICENSE.md
 - README.md
 - Rakefile
+- examples/hello-world/Gemfile
+- examples/hello-world/Gemfile.lock
+- examples/hello-world/hello-world.html
+- examples/hello-world/hello-world.ru
+- examples/progress/progress.ru
 - examples/test.ru
+- examples/threads/Gemfile
+- examples/threads/Gemfile.lock
+- examples/threads/threads.ru
 - lib/datastar.rb
 - lib/datastar/async_executor.rb
 - lib/datastar/configuration.rb
@@ -87,11 +95,11 @@ files:
 - lib/datastar/server_sent_event_generator.rb
 - lib/datastar/version.rb
 - sig/datastar.rbs
-homepage: https://github.com/starfederation/datastar#readme
+homepage: https://github.com/starfederation/datastar-ruby#readme
 licenses: []
 metadata:
-  homepage_uri: https://github.com/starfederation/datastar#readme
-  source_code_uri: https://github.com/starfederation/datastar
+  homepage_uri: https://github.com/starfederation/datastar-ruby#readme
+  source_code_uri: https://github.com/starfederation/datastar-ruby
 rdoc_options: []
 require_paths:
 - lib
@@ -106,7 +114,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 3.7.2
 specification_version: 4
 summary: Ruby SDK for Datastar. Rack-compatible.
 test_files: []