support_desk 0.3.2 → 0.5.0

data/lib/support_desk.rb

@@ -330,9 +330,11 @@ module SupportDesk
 
     # --- The chats seam -------------------------------------------------------------
 
-    # Subscribe the gem's own `:message_created` listener, which is what
+    # Subscribe the gem's own chats listeners: `:message_created`, which is what
     # keeps `awaiting`, the SLA clocks and reopen-on-reply true without
-    # anybody remembering to call anything.
+    # anybody remembering to call anything, and `:unread_changed`, which
+    # keeps the launcher's badge live.
+
     #
     # Safe to call as often as you like: chats replaces a subscriber
     # registered under the same `key:` rather than stacking another one.
@@ -346,6 +348,11 @@ module SupportDesk
         # the Ticket class is a new object after each reload.
         SupportDesk::Ticket.for_conversation(message.conversation)&.register!(message)
       end
+      # The launcher's badge (chats >= 0.7.0): wherever an unread count in a
+      # case's conversation may have moved, the case's own notices included.
+      Chats.on(:unread_changed, key: :support_desk_launcher) do |messager:, conversation:|
+        SupportDesk::Launcher.unread_changed(messager, conversation)
+      end
       self
     end
 
@@ -402,8 +409,10 @@ module SupportDesk
     #
     # Both surfaces are ordinary PUSHED screens (`context: "default"`), never
     # modals: the wizard is three real URLs and a modal would break the back
-    # gesture between them. The thread itself is deliberately absent — it is
-    # a chats conversation, and it stays under the host's chats rule.
+    # gesture between them. The thread itself is absent under the default
+    # `thread_page = :chats` — it is a chats conversation, and it stays under
+    # the host's chats rule. Under `:support` it is this engine's ticket page,
+    # and a third rule pushes it like the list.
     #
     # +mount+ defaults to wherever the engine is mounted and +title+ to the
     # desk's name.
@@ -429,8 +438,16 @@ module SupportDesk
           properties: { context: "default", title: title, pull_to_refresh_enabled: false },
           comment: "The wizard: every step is a real URL, so it pushes and the back gesture works. " \
                    "Pull to refresh is off — it would throw away what the requester has typed."
-        }
-      ]
+        },
+        (if config.support_thread_page?
+           {
+             patterns: [ "^#{prefix}/tickets/[^/?]+(?:\\?.*)?$" ],
+             properties: { context: "default", title: title, pull_to_refresh_enabled: false },
+             comment: "A case, read on the support page (thread_page = :support). Pull to refresh is off " \
+                      "for the same reason as the wizard: the composer at its foot holds what is typed."
+           }
+         end)
+      ].compact
     end
 
     # A duration in the reader's own language ("1 día", "4 hours") — the
@@ -449,6 +466,24 @@ module SupportDesk
       words.start_with?("Translation missing") ? duration.inspect : words
     end
 
+    # The answer promise, in the unit the desk made it in: `reply_within =
+    # 72.hours` reads "72 hours", `3.days` reads "3 days", `24.hours` reads
+    # "24 hours". A wait is approximate and `humanize_duration` rounds it
+    # ("about 8 hours", "3 days"); a promise is a number somebody chose, and
+    # rounding it says something they did not.
+    #
+    # The words are `support_desk.durations.<unit>`, pluralized by count. A
+    # duration of more than one unit (1.day + 2.hours), a fractional one, or
+    # a unit with no words in this locale is said the way a wait is.
+    def humanize_promise(duration)
+      parts = duration.respond_to?(:parts) ? duration.parts : {}
+      unit, count = parts.first if parts.size == 1
+      key = :"support_desk.durations.#{unit}"
+      return humanize_duration(duration) unless count.is_a?(Integer) && I18n.exists?(key)
+
+      I18n.t(key, count: count)
+    end
+
     # A stable, URL-safe key for an actor (agent, requester, desk), used in
     # cache keys and event payloads. GlobalID params already encode class +
     # id, so two classes can never collide.

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: support_desk
 version: !ruby/object:Gem::Version
-  version: 0.3.2
+  version: 0.5.0
 platform: ruby
 authors:
 - rameerez
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-09-24 00:00:00.000000000 Z
+date: 2026-10-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord
@@ -53,22 +54,22 @@ dependencies:
   name: chats
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.3.2
+        version: 0.7.1
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '1.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.3.2
+        version: 0.7.1
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '1.0'
 - !ruby/object:Gem::Dependency
   name: globalid
   requirement: !ruby/object:Gem::Requirement
@@ -143,8 +144,10 @@ files:
 - app/controllers/support_desk/console/tickets_controller.rb
 - app/controllers/support_desk/tickets_controller.rb
 - app/helpers/support_desk/engine_helper.rb
+- app/helpers/support_desk/thread_helper.rb
 - app/views/chats/slots/_inbox_top.html.erb
 - app/views/chats/slots/_locked_composer.html.erb
+- app/views/layouts/support_desk/panel.html.erb
 - app/views/support_desk/console/tickets/_actions.html.erb
 - app/views/support_desk/console/tickets/_assignment.html.erb
 - app/views/support_desk/console/tickets/_composer.html.erb
@@ -160,9 +163,18 @@ files:
 - app/views/support_desk/console/tickets/index.html.erb
 - app/views/support_desk/console/tickets/new.html.erb
 - app/views/support_desk/console/tickets/show.html.erb
+- app/views/support_desk/launcher/_badge.html.erb
+- app/views/support_desk/launcher/_icon.html.erb
+- app/views/support_desk/launcher/_launcher.html.erb
+- app/views/support_desk/launcher/_signed_out.html.erb
+- app/views/support_desk/panel/case.html.erb
+- app/views/support_desk/panel/home.html.erb
+- app/views/support_desk/panel/new.html.erb
+- app/views/support_desk/panel/rate_limited.html.erb
 - app/views/support_desk/tickets/_context_card.html.erb
 - app/views/support_desk/tickets/_door.html.erb
 - app/views/support_desk/tickets/_human_door.html.erb
+- app/views/support_desk/tickets/_limit_wall.html.erb
 - app/views/support_desk/tickets/_pick_thing.html.erb
 - app/views/support_desk/tickets/_pick_topic.html.erb
 - app/views/support_desk/tickets/_ticket_row.html.erb
@@ -171,6 +183,7 @@ files:
 - app/views/support_desk/tickets/index.html.erb
 - app/views/support_desk/tickets/new.html.erb
 - app/views/support_desk/tickets/rate_limited.html.erb
+- app/views/support_desk/tickets/show.html.erb
 - config/console_routes.rb
 - config/locales/support_desk.console.en.yml
 - config/locales/support_desk.console.es.yml
@@ -204,11 +217,13 @@ files:
 - lib/support_desk/console_engine.rb
 - lib/support_desk/console_routes.rb
 - lib/support_desk/context_card.rb
+- lib/support_desk/conversation_access.rb
 - lib/support_desk/current.rb
 - lib/support_desk/doctor.rb
 - lib/support_desk/engine.rb
 - lib/support_desk/errors.rb
 - lib/support_desk/events.rb
+- lib/support_desk/launcher.rb
 - lib/support_desk/macros.rb
 - lib/support_desk/message_signatures.rb
 - lib/support_desk/models/application_record.rb
@@ -244,6 +259,7 @@ metadata:
   bug_tracker_uri: https://github.com/rameerez/support_desk/issues
   documentation_uri: https://github.com/rameerez/support_desk#readme
   rubygems_mfa_required: 'true'
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -258,7 +274,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 3.4.10
+signing_key:
 specification_version: 4
 summary: 'Customer support for your Rails app: tickets that are conversations, worked
   by your team and by AI agents with real guardrails'