turbo_chat 0.1.4 → 0.1.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 87e5b68d4722dd1f28ae30a9926da8445184f2c3116b66f55c8f948e15e923f8
-  data.tar.gz: 4654ef43284576a86f56c64c24d93bf3f6a15da709a81720af9fe38f331f5d6c
+  metadata.gz: c4776a0d821cdcfb6907270b5bdb1c6ffe742026e8e2aa2b3f2bea1bcd7b8859
+  data.tar.gz: 8f0fccb6be759bb46534fd69296e610ee7bc80e9b659805d7bbb75db68841ec3
 SHA512:
-  metadata.gz: 1cfa9becf70f4e79fb3d5907dacefd722e87849b8f0cb3cbc75a6b7baa82680bdee3dc82b9d600bf4ddaee56ceaddbb278611a70b462bf8ff1604947f536e951
-  data.tar.gz: b5e6106acb66c2e01447ef4a2b104d28da4206a712bf42a3076f5b981e3165d388e787b2307d70793d89ff550cfefdf73dceaea9e100b7ee50489d3284c8eda0
+  metadata.gz: 1ea9fd52941fdd7754f89c89ecf73cc47851abe5285fa8d2a05bb14da94746876d44cc414e8d835501f72b745586fbb2030b1ef5b0ceaaff34730534b774cc71
+  data.tar.gz: 9e056689af5f5c4a709f320c722f9cb6f324d52e4d3aba5ca22f50e6a999d3e0c435b087583140cc572b43be1a8eb185f4f383986beafbba24080334055e64de

data/CHANGELOG.md

@@ -2,6 +2,15 @@
 
 All notable changes to `turbo_chat` will be documented in this file.
 
+## [0.1.5] - 2026-02-22
+
+### Added
+- Custom signal text support via `signal_type: :custom` and `signal_text`.
+- `TurboChat::Signals.custom!` helper for explicit custom status updates.
+
+### Changed
+- Signal rendering now shows custom signal text in the live signals rail.
+
 ## [0.1.4] - 2026-02-22
 
 ### Added

data/README.md

@@ -35,7 +35,19 @@ Mount the engine:
 mount TurboChat::Engine => "/", as: "turbo_chat"
 ```
 
-This gives you chat routes like `/` (chat index), `/chats`, and `/chats/:id`.
+This mounts TurboChat at your app root.
+
+Because the engine defines `root` as `chats#index`, both of these resolve to chat index:
+
+- `/`
+- `/chats`
+
+Route helpers:
+
+- `turbo_chat.root_path` -> `/`
+- `turbo_chat.chats_path` -> `/chats`
+- `turbo_chat.chat_path(chat)` -> `/chats/:id`
+- `turbo_chat_path` -> the mount point (`/`)
 
 ## Host App Requirements
 
@@ -49,7 +61,8 @@ end
 
 ### 2. Resolve the current participant
 
-Define `current_chat_participant` in your host `ApplicationController`.
+You can define `current_chat_participant` in your host `ApplicationController`.
+If you already expose `current_user` and it returns a model using `acts_as_chat_participant`, TurboChat works without adding this method.
 
 Recommended hook:
 
@@ -61,10 +74,12 @@ class ApplicationController < ActionController::Base
 end
 ```
 
-Fallback behavior (only if you do not define `current_chat_participant`):
+Resolution order:
 
-1. `config.current_participant_resolver`
-2. `current_user`
+1. Host `ApplicationController#current_chat_participant` (if defined)
+2. `config.current_participant_resolver` (if configured)
+3. `current_user` (if available)
+4. Raise `NotImplementedError`
 
 Optional resolver for non-`current_user` auth:
 
@@ -164,6 +179,8 @@ Raises:
 
 ```ruby
 TurboChat::Signals.start!(chat: chat, participant: current_user, signal_type: :typing)
+TurboChat::Signals.start!(chat: chat, participant: current_user, signal_type: :custom, signal_text: "Hello")
+TurboChat::Signals.custom!(chat: chat, participant: current_user, signal_text: "Reviewing your request")
 TurboChat::Signals.clear!(chat: chat, participant: current_user)
 ```
 

data/app/assets/stylesheets/turbo_chat/application.css

@@ -627,6 +627,13 @@ body {
   gap: 3px;
 }
 
+.chat-signal-text {
+  max-width: 320px;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
 .chat-dots i {
   width: 6px;
   height: 6px;

data/app/controllers/turbo_chat/chat_messages_controller.rb

@@ -41,10 +41,15 @@ module TurboChat
     end
 
     def chat_message_params
-      permitted = params.require(:chat_message).permit(:body, :kind, :signal_type)
+      permitted = params.require(:chat_message).permit(:body, :kind, :signal_type, :signal_text)
       normalized_kind = normalize_submittable_message_kind(permitted[:kind])
       permitted[:kind] = normalized_kind
-      permitted[:signal_type] = nil unless normalized_kind == "signal"
+      signal_text = permitted.delete(:signal_text)
+      if normalized_kind == "signal"
+        permitted[:body] = signal_text unless signal_text.nil?
+      else
+        permitted[:signal_type] = nil
+      end
       permitted
     end
 

data/app/models/turbo_chat/chat_message/signals.rb

@@ -4,13 +4,19 @@ module TurboChat
       extend ActiveSupport::Concern
 
       class_methods do
-        def start_signal!(chat:, participant:, signal_type: :typing)
-          create!(chat: chat, participant: participant, kind: :signal, signal_type: signal_type)
+        def start_signal!(chat:, participant:, signal_type: :typing, signal_text: nil)
+          create!(
+            chat: chat,
+            participant: participant,
+            kind: :signal,
+            signal_type: signal_type,
+            body: signal_text
+          )
         end
 
-        def replace_signal!(chat:, participant:, signal_type: :typing)
+        def replace_signal!(chat:, participant:, signal_type: :typing, signal_text: nil)
           clear_signals!(chat: chat, participant: participant)
-          start_signal!(chat: chat, participant: participant, signal_type: signal_type)
+          start_signal!(chat: chat, participant: participant, signal_type: signal_type, signal_text: signal_text)
         end
 
         def clear_signals!(chat:, participant:)
@@ -19,8 +25,13 @@ module TurboChat
           true
         end
 
-        def with_signal(chat:, participant:, signal_type: :typing)
-          replace_signal!(chat: chat, participant: participant, signal_type: signal_type)
+        def with_signal(chat:, participant:, signal_type: :typing, signal_text: nil)
+          replace_signal!(
+            chat: chat,
+            participant: participant,
+            signal_type: signal_type,
+            signal_text: signal_text
+          )
           yield
         ensure
           clear_signals!(chat: chat, participant: participant)
@@ -42,7 +53,9 @@ module TurboChat
 
       def normalize_signal_fields
         self.signal_type = nil if message? || system?
-        self.body = "" if signal?
+        return unless signal?
+
+        self.body = signal_type_custom? ? body.to_s.strip : ""
       end
 
       def replace_participant_signals_on_submit

data/app/models/turbo_chat/chat_message.rb

@@ -19,7 +19,7 @@ module TurboChat
     belongs_to :participant, polymorphic: true
 
     enum :kind, { message: 0, signal: 1, system: 2 }, default: :message
-    enum :signal_type, { typing: 0, thinking: 1, planning: 2 }, prefix: true
+    enum :signal_type, { typing: 0, thinking: 1, planning: 2, custom: 3 }, prefix: true
 
     scope :ordered, -> { order(created_at: :asc, id: :asc) }
     scope :messages_only, -> { where(kind: kinds[:message]) }
@@ -28,6 +28,7 @@ module TurboChat
     validates :participant_type, :participant_id, presence: true
     validates :body, presence: true, if: -> { message? || system? }
     validates :signal_type, presence: true, if: :signal?
+    validates :signal_text, presence: true, if: :custom_signal?
     validate :body_within_max_length, if: :message?
     validate :mentions_allowed_for_participant, if: :message?
     validate :apply_blocked_words_moderation, if: :message?
@@ -39,6 +40,16 @@ module TurboChat
     after_update_commit :broadcast_update
     after_destroy_commit :broadcast_destroy
 
+    def signal_text
+      return nil unless signal?
+
+      body.presence
+    end
+
+    def signal_text=(value)
+      self.body = value
+    end
+
     class << self
       def create_membership_system_message!(chat:, actor:, event:, subject: nil)
         return nil unless system_messages_enabled?
@@ -117,5 +128,11 @@ module TurboChat
         participant.to_s
       end
     end
+
+    private
+
+    def custom_signal?
+      signal? && signal_type_custom?
+    end
   end
 end

data/app/views/turbo_chat/chat_messages/_signal.html.erb

@@ -1,3 +1,7 @@
 <article id="<%= dom_id(chat_message) %>" class="chat-signal-entry">
-  <span><%= chat_message.participant_display_name %> is <%= chat_message.signal_type %>...</span>
+  <% if chat_message.signal_type_custom? && chat_message.signal_text.present? %>
+    <span><%= chat_message.participant_display_name %>: <%= chat_message.signal_text %></span>
+  <% else %>
+    <span><%= chat_message.participant_display_name %> is <%= chat_message.signal_type %>...</span>
+  <% end %>
 </article>

data/app/views/turbo_chat/chat_messages/_signals.html.erb

@@ -17,8 +17,12 @@
        data-chat-signal-participant-type="<%= signal_message.participant_type %>"
        data-chat-signal-participant-id="<%= signal_message.participant_id %>">
     <strong><%= signal_message.participant_display_name %></strong>
-    <span class="chat-dots">
-      <i></i><i></i><i></i>
-    </span>
+    <% if signal_message.signal_type_custom? && signal_message.signal_text.present? %>
+      <span class="chat-signal-text"><%= signal_message.signal_text %></span>
+    <% else %>
+      <span class="chat-dots">
+        <i></i><i></i><i></i>
+      </span>
+    <% end %>
   </div>
 <% end %>

data/lib/turbo_chat/signals.rb

@@ -2,23 +2,38 @@ module TurboChat
   module Signals
     module_function
 
-    def start!(chat:, participant:, signal_type: :typing)
-      TurboChat::ChatMessage.replace_signal!(chat: chat, participant: participant, signal_type: signal_type)
+    def start!(chat:, participant:, signal_type: :typing, signal_text: nil)
+      TurboChat::ChatMessage.replace_signal!(
+        chat: chat,
+        participant: participant,
+        signal_type: signal_type,
+        signal_text: signal_text
+      )
     end
 
-    def replace!(chat:, participant:, signal_type: :typing)
-      TurboChat::ChatMessage.replace_signal!(chat: chat, participant: participant, signal_type: signal_type)
+    def replace!(chat:, participant:, signal_type: :typing, signal_text: nil)
+      TurboChat::ChatMessage.replace_signal!(
+        chat: chat,
+        participant: participant,
+        signal_type: signal_type,
+        signal_text: signal_text
+      )
     end
 
     def clear!(chat:, participant:)
       TurboChat::ChatMessage.clear_signals!(chat: chat, participant: participant)
     end
 
-    def with(chat:, participant:, signal_type: :typing, &block)
+    def custom!(chat:, participant:, signal_text:)
+      start!(chat: chat, participant: participant, signal_type: :custom, signal_text: signal_text)
+    end
+
+    def with(chat:, participant:, signal_type: :typing, signal_text: nil, &block)
       TurboChat::ChatMessage.with_signal(
         chat: chat,
         participant: participant,
         signal_type: signal_type,
+        signal_text: signal_text,
         &block
       )
     end

data/lib/turbo_chat/version.rb

@@ -1,3 +1,3 @@
 module TurboChat
-  VERSION = "0.1.4"
+  VERSION = "0.1.5"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: turbo_chat
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.1.5
 platform: ruby
 authors:
 - Alexander Haumer