chats 0.3.1 → 0.4.0

data/lib/chats/models/participant.rb

@@ -43,6 +43,8 @@ module Chats
     # concurrent joins race-safe. Same rationale as Conversation#direct_key.
     validate :group_must_have_room, on: :create
 
+    after_update_commit :notify_departure, if: -> { saved_change_to_left_at? && left? }
+
     def owner? = role == "owner"
     def left? = left_at.present?
     def active? = left_at.nil?
@@ -104,11 +106,17 @@ module Chats
     def unmute! = update!(muted_at: nil)
 
     def leave!
+      return self if left?
+
       update!(left_at: Time.current)
-      Chats.notify(:participant_left, participant: self)
       self
     end
 
+    def notify_departure
+      Chats.notify(:participant_left, participant: self)
+    end
+    private :notify_departure
+
     # Hand this seat to a different messager, keeping the read horizon, the
     # role and the history: the guest who signs up, the agent who takes over
     # a shared mailbox. The MESSAGES keep their original sender — what was

data/lib/chats/send_rate_limited.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Chats
+  # Share one sender budget across chat and product-specific HTTP composers.
+  # The host owns the cache store. Using its atomic increment also works on
+  # Rails 7 and avoids depending on Rails' private controller limiter API.
+  module SendRateLimited
+    extend ActiveSupport::Concern
+
+    included do
+      before_action :enforce_chat_send_rate_limit, only: :create
+    end
+
+    private
+
+    def chat_rate_limit_messager
+      send(Chats.config.current_messager_method)
+    end
+
+    def enforce_chat_send_rate_limit
+      limit = Chats.config.send_rate_limit
+      return unless limit
+
+      sender = chat_rate_limit_messager&.to_gid&.to_s || request.remote_ip
+      count = self.class.cache_store.increment("rate-limit:chats/messages:#{sender}", 1,
+                                               expires_in: limit.fetch(:within))
+      head :too_many_requests if count && count > limit.fetch(:to)
+    end
+  end
+end

data/lib/chats/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Chats
-  VERSION = "0.3.1"
+  VERSION = "0.4.0"
 end

data/lib/chats.rb

@@ -7,6 +7,7 @@ require_relative "chats/version"
 require_relative "chats/errors"
 require_relative "chats/configuration"
 require_relative "chats/subscribers"
+require_relative "chats/send_rate_limited"
 require_relative "chats/macros"
 
 require_relative "chats/engine" if defined?(::Rails::Engine)

data/lib/generators/chats/templates/add_action_to_chats_messages.rb.erb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+# chats 0.4.0 — message ACTIONS.
+#
+# A message may carry one featured button: a label and the url it opens
+# ("Your invoice is ready" → Pay now). Stored as {"label":…,"url":…} in its
+# own JSON column — `metadata` stays yours. Nullable, no default: most
+# messages have no action, and MySQL refuses defaults on JSON columns.
+# See Chats::Action.
+#
+# Safe to run on an install that already has the column (a 0.4.0 fresh
+# install does): every step is guarded, so this migration is a no-op there.
+class AddActionToChatsMessages < ActiveRecord::Migration<%= migration_version %>
+  def up
+    return if column_exists?(:chats_messages, :action)
+
+    add_column :chats_messages, :action, json_column_type
+  end
+
+  # Rolling back KEEPS the column, on purpose: this migration never removes
+  # a column it may not have added. On a fresh 0.4.0 install the create
+  # migration owns `action` and `up` above did nothing, so dropping it here
+  # would destroy every message's button with it — and nothing a migration
+  # can see records which of the two added it. A leftover nullable column
+  # is harmless to older versions of chats; drop it by hand if you mean to.
+  def down; end
+
+  private
+
+  # jsonb on every PostgreSQL adapter, like the install migration — matched
+  # by prefix because PostGIS answers "PostGIS", not "PostgreSQL".
+  def json_column_type
+    return :jsonb if connection.adapter_name.match?(/\Apostg/i)
+
+    :json
+  end
+end

data/lib/generators/chats/templates/create_chats_tables.rb.erb

@@ -101,6 +101,10 @@ class CreateChatsTables < ActiveRecord::Migration<%= migration_version %>
       t.datetime :edited_at
       t.datetime :deleted_at
       t.send(json_column_type, :metadata, default: json_column_default)
+      # The one featured button a message may carry ({"label":…,"url":…}),
+      # set by the host from Ruby — see Chats::Action. Nullable with no
+      # default: most messages have none, and MySQL refuses JSON defaults.
+      t.send(json_column_type, :action)
 
       t.timestamps
     end

data/lib/generators/chats/templates/initializer.rb

@@ -223,6 +223,7 @@ Chats.configure do |config|
   #   app/views/chats/slots/_inbox_top.html.erb                 above the first inbox row
   #   app/views/chats/slots/_inbox_empty.html.erb               inside the empty state
   #   app/views/chats/slots/_conversation_header_actions.html.erb  thread menu
+  #   app/views/chats/slots/_composer_actions.html.erb          your own buttons above the composer
   #   app/views/chats/slots/_locked_composer.html.erb           the locked composer's body
   #   app/views/chats/slots/_message_meta.html.erb              after each bubble's timestamp
   #

data/lib/generators/chats/upgrade_generator.rb

@@ -9,14 +9,17 @@ module Chats
     # needs into an EXISTING install. Nothing else: the initializer, the
     # views and the routes you already own stay untouched.
     #
-    # Currently writes the 0.2.0 migration (message authorship). It is
-    # written guarded, so running it against an install that already has the
-    # columns (a fresh 0.2.0 install) is a no-op rather than an error.
+    # Writes every migration since 0.1.x — 0.2.0's message authorship and
+    # 0.4.0's message action — in that order. Each is written guarded, so
+    # running this against an install that already has some of the columns
+    # (a fresh 0.2.0 install has the author ones) is a no-op for those
+    # rather than an error, and re-running it skips files already copied.
+    # The action migration is not written at all where the column exists.
     class UpgradeGenerator < Rails::Generators::Base
       include ActiveRecord::Generators::Migration
 
       source_root File.expand_path("templates", __dir__)
-      desc "Add the migrations a chats version bump needs (0.2.0: message authorship)"
+      desc "Add the migrations a chats version bump needs (0.2.0: message authorship; 0.4.0: message actions)"
 
       def self.next_migration_number(dir)
         ActiveRecord::Generators::Base.next_migration_number(dir)
@@ -27,19 +30,47 @@ module Chats
                            File.join(db_migrate_path, "add_author_to_chats_messages.rb")
       end
 
+      # Not written when the schema already HAS the column — a fresh 0.4.0
+      # install, whose create migration owns it. A second migration for a
+      # column it didn't add is one nobody can safely roll back. Without a
+      # database to ask, it is written anyway; its `up` is guarded, and its
+      # `down` never drops the column.
+      def create_action_migration
+        if action_column_present?
+          say_status :skip, "chats_messages.action already exists — no migration needed", :yellow
+          return
+        end
+
+        migration_template "add_action_to_chats_messages.rb.erb",
+                           File.join(db_migrate_path, "add_action_to_chats_messages.rb")
+      end
+
       def display_post_upgrade_message
         say "\n💬 chats upgrade migrations copied.", :green
         say "\n  1. Run 'rails db:migrate'."
-        say "  2. New in 0.2.0 — all opt-in, nothing changes until you ask:"
+        say "  2. New in 0.4.0 — a message can carry one button (the `action` column):"
+        say "       alice.message!(bob, \"Let's play!\", action: { label: \"Join my room\", url: room_path(room) })"
+        say "       app/views/chats/slots/_composer_actions.html.erb   # your own buttons by the composer"
+        say "  3. New in 0.2.0 — all opt-in, nothing changes until you ask:"
         say "       acts_as_messager notifications: false, blockable: false, inbox: :grouped"
         say "       Chats.on(:message_created) { |message| … }   # replaces config.notifier"
         say "       config.messager_url / config.message_signature / config.inbox_scope"
         say "       chat_locked? / chat_locked_notice on your chat subjects"
-        say "  3. See the CHANGELOG for the full list.\n", :green
+        say "  4. See the CHANGELOG for the full list.\n", :green
       end
 
       private
 
+      def action_column_present?
+        ActiveRecord::Base.connection_pool.with_connection do |connection|
+          connection.column_exists?(:chats_messages, :action)
+        end
+      rescue ActiveRecord::ActiveRecordError
+        # No database configured, not created yet, or no chats tables: there
+        # is nothing to ask, so write the (guarded) migration.
+        false
+      end
+
       def migration_version
         "[#{ActiveRecord::VERSION::STRING.to_f}]"
       end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: chats
 version: !ruby/object:Gem::Version
-  version: 0.3.1
+  version: 0.4.0
 platform: ruby
 authors:
 - rameerez
 bindir: exe
 cert_chain: []
-date: 2026-09-16 00:00:00.000000000 Z
+date: 2026-10-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord
@@ -145,6 +145,7 @@ files:
 - app/views/chats/conversations/index.html.erb
 - app/views/chats/conversations/refresh.turbo_stream.erb
 - app/views/chats/conversations/show.html.erb
+- app/views/chats/messages/_action.html.erb
 - app/views/chats/messages/_composer.html.erb
 - app/views/chats/messages/_message.html.erb
 - app/views/chats/messages/create.turbo_stream.erb
@@ -152,6 +153,7 @@ files:
 - app/views/chats/messages/locked.turbo_stream.erb
 - app/views/chats/shared/_unread_badge.html.erb
 - app/views/chats/shared/_verified_badge.html.erb
+- chats-0.3.1.gem
 - config/importmap.rb
 - config/locales/en.yml
 - config/locales/es.yml
@@ -159,10 +161,15 @@ files:
 - context7.json
 - docs/PRD.md
 - docs/campfire_review.md
+- docs/screenshots/composer-actions.png
+- docs/screenshots/inbox.png
+- docs/screenshots/system-note-action.png
+- docs/screenshots/thread-actions-phone.png
 - gemfiles/rails_7.1.gemfile
 - gemfiles/rails_7.2.gemfile
 - gemfiles/rails_8.1.gemfile
 - lib/chats.rb
+- lib/chats/action.rb
 - lib/chats/broadcasts.rb
 - lib/chats/configuration.rb
 - lib/chats/engine.rb
@@ -177,9 +184,11 @@ files:
 - lib/chats/models/message.rb
 - lib/chats/models/participant.rb
 - lib/chats/models/reaction.rb
+- lib/chats/send_rate_limited.rb
 - lib/chats/subscribers.rb
 - lib/chats/version.rb
 - lib/generators/chats/install_generator.rb
+- lib/generators/chats/templates/add_action_to_chats_messages.rb.erb
 - lib/generators/chats/templates/add_author_to_chats_messages.rb.erb
 - lib/generators/chats/templates/create_chats_tables.rb.erb
 - lib/generators/chats/templates/initializer.rb