livechat 0.2.1 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ab3b69e1c61320ea9df88571fc2fcad40c09c44e0f14f961b59a87d23ffc161e
-  data.tar.gz: b6750a5aef1f99e7a6d2a49ed2fbcd6bb9cb1fb992cefd176e552f7d281f42e8
+  metadata.gz: 03a4a70e650dd115654bf8ab48e4afc02b5f628009732d3efbff4a7a36e278cc
+  data.tar.gz: e74596da328480eacab3097e9c08cc78464369ab2e9db6f9c015904498d53809
 SHA512:
-  metadata.gz: 12421cafc2a629e4d1621dea03a984bd1e88d6ae9418390bd9767533208827da379f3d858cfd1c1eb1a6b47d2bb1aebaecedce8ff810f7f4fdc1197473c276e3
-  data.tar.gz: 53b24b739628a3fdf69082ff652a1770d1acfa18c385152e61a2f9985faa82eac968f0c0be4ff36561957d9d8a3fa2bd53c7c671d2df02d0564ac10a96bc8eda
+  metadata.gz: 83f87fff5df20fc4b6ba70190fd66fc01dd4a32920f5acd36069d94c6f15eb8ab07711a865020b639ce2bd0c7d6555d606415844f2f7b639575d61dfd211fd16
+  data.tar.gz: ed3589f43b665ae857d6f9a918643feae0c239515f6413a41579a66e6caf4e4a1ca4bc356db9dfeeb274e6162c841649893dc87e535f91cb6733c4ca4f80dbc4

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.3.0
+
+- Inbox search: visitor name, email, and full message text, scoped to the
+  current tab.
+- The conversation list keeps itself fresh (new messages, new threads,
+  resolves) — without ever reloading over a search in progress.
+- An Agents column on the list shows which teammates have worked each thread.
+
 ## 0.2.1
 
 - With `show_launcher = false` the panel now sits in the corner instead of

data/README.md

@@ -127,10 +127,12 @@ config.on_visitor_message = ->(message) { SlackNotifier.ping(message) }
 
 ## The inbox
 
-Browse at the mount path: open and resolved tabs, unread badges, one click
-into a thread. Reply (Cmd/Ctrl+Enter sends), resolve, reopen. The thread
-updates itself while you watch — and never reloads over a half-written
-reply. Gated by `config.authorize_agent` (development-only until you set it).
+Browse at the mount path: open and resolved tabs, unread badges, search
+(visitor name, email, and everything anyone wrote), and a column showing
+which teammates have worked each thread. One click into a thread; reply
+(Cmd/Ctrl+Enter sends), resolve, reopen. Both pages keep themselves fresh
+while you watch — and never reload over a half-written reply or search.
+Gated by `config.authorize_agent` (development-only until you set it).
 
 ## Widget API
 

data/app/controllers/livechat/conversations_controller.rb

@@ -6,25 +6,39 @@ module Livechat
   # not an assignment queue.
   class ConversationsController < ApplicationController
     before_action :require_agent
-    before_action :set_conversation, except: :index
+    before_action :set_conversation, except: %i[index index_poll]
     layout 'livechat/application'
 
     PER_PAGE = 50
 
     def index
       @status = Conversation::STATUSES.include?(params[:status]) ? params[:status] : 'open'
+      @query = params[:q].to_s.strip.presence
       @counts = Conversation.group(:status).count
       @offset = params[:offset].to_i.clamp(0, 1_000_000)
 
       scope = Conversation.where(status: @status).recent_first
+      scope = search(scope, @query) if @query
       page = scope.offset(@offset).limit(PER_PAGE + 1).to_a
       @more = page.size > PER_PAGE
       @conversations = page.first(PER_PAGE)
 
-      # Unread badges for the whole page in one query.
-      @unread = Message.from_visitor.unread
-                       .where(conversation_id: @conversations.map(&:id))
+      # Unread badges and participating agents for the whole page, one query each.
+      ids = @conversations.map(&:id)
+      @unread = Message.from_visitor.unread.where(conversation_id: ids)
                        .group(:conversation_id).count
+      @agents = Message.from_agent.where(conversation_id: ids)
+                       .distinct.pluck(:conversation_id, :agent_label)
+                       .group_by(&:first).transform_values { |pairs| pairs.map(&:last) }
+    end
+
+    # Polled by dashboard.js on the list page: a token that changes whenever
+    # anything an agent can see there changes — new message, new thread,
+    # resolve/reopen.
+    def index_poll
+      render json: { token: [Message.maximum(:id).to_i,
+                             Conversation.count,
+                             Conversation.where(status: 'open').count].join('-') }
     end
 
     def show
@@ -53,5 +67,17 @@ module Livechat
     def set_conversation
       @conversation = Conversation.find(params[:id])
     end
+
+    # Case-insensitive match on who the visitor is or anything anyone wrote.
+    # LOWER(...) LIKE is deliberately plain SQL — portable across SQLite,
+    # PostgreSQL and MySQL alike (feedback_engine's proven approach).
+    def search(scope, query)
+      q = "%#{ActiveRecord::Base.sanitize_sql_like(query.downcase)}%"
+      scope.where(
+        'LOWER(visitor_label) LIKE :q OR LOWER(visitor_email) LIKE :q OR id IN ' \
+        "(SELECT conversation_id FROM #{Message.table_name} WHERE LOWER(body) LIKE :q)",
+        q: q
+      )
+    end
   end
 end

data/app/views/layouts/livechat/application.html.erb

@@ -35,6 +35,9 @@
     .tabs a:hover { text-decoration: none; color: var(--text); }
     .count { display: inline-block; min-width: 20px; padding: 0 6px; margin-left: 4px; border-radius: 999px;
              background: var(--border); font-size: 12px; text-align: center; }
+    .filters { margin-bottom: 16px; display: flex; gap: 8px; }
+    .filters input[type=search] { flex: 1; max-width: 320px; padding: 6px 10px; border: 1px solid var(--border);
+                                  border-radius: 8px; background: var(--surface); color: var(--text); font: inherit; }
     .card { background: var(--surface); border: 1px solid var(--border); border-radius: 12px; overflow: hidden; }
     .card.pad { padding: 16px; }
     table { width: 100%; border-collapse: collapse; }

data/app/views/livechat/conversations/index.html.erb

@@ -2,13 +2,27 @@
 
 <div class="tabs">
   <% Livechat::Conversation::STATUSES.each do |status| %>
-    <%= link_to conversations_path(status: status), class: ('active' if @status == status) do %>
+    <%= link_to conversations_path(status: status, q: @query), class: ('active' if @status == status) do %>
       <%= t("livechat.statuses.#{status}", default: status.humanize) %>
       <span class="count"><%= @counts.fetch(status, 0) %></span>
     <% end %>
   <% end %>
 </div>
 
+<%= form_with url: conversations_path, method: :get, class: 'filters' do %>
+  <input type="hidden" name="status" value="<%= @status %>">
+  <input type="search" name="q" value="<%= @query %>"
+         placeholder="<%= t('livechat.dashboard.search', default: 'Search') %>"
+         aria-label="<%= t('livechat.dashboard.search', default: 'Search') %>">
+  <button type="submit"><%= t('livechat.dashboard.search', default: 'Search') %></button>
+<% end %>
+
+<%# The list keeps itself fresh (dashboard.js reloads when the token moves) —
+    unless the agent is mid-search, whose typing must never be eaten. %>
+<div id="lvc-index" data-poll-url="<%= poll_conversations_path %>"
+     data-token="<%= [Livechat::Message.maximum(:id).to_i, Livechat::Conversation.count,
+                      @counts.fetch('open', 0)].join('-') %>"></div>
+
 <div class="card">
   <% if @conversations.empty? %>
     <p class="empty"><%= t('livechat.dashboard.empty',
@@ -20,6 +34,7 @@
           <th>#</th>
           <th><%= t('livechat.dashboard.visitor', default: 'Visitor') %></th>
           <th><%= t('livechat.dashboard.last_message', default: 'Last message') %></th>
+          <th><%= t('livechat.dashboard.agents', default: 'Agents') %></th>
           <th><%= t('livechat.dashboard.updated', default: 'Updated') %></th>
         </tr>
       </thead>
@@ -38,6 +53,7 @@
               <% end %>
             </td>
             <td class="muted"><%= conversation.last_message_preview %></td>
+            <td class="muted"><%= @agents.fetch(conversation.id, []).join(', ') %></td>
             <td class="muted">
               <% if conversation.last_activity_at %>
                 <%= time_ago_in_words(conversation.last_activity_at) %>
@@ -53,10 +69,12 @@
 <div class="pager">
   <% if @offset.positive? %>
     <%= link_to t('livechat.dashboard.newer', default: 'Newer'),
-                conversations_path(status: @status, offset: [@offset - Livechat::ConversationsController::PER_PAGE, 0].max) %>
+                conversations_path(status: @status, q: @query,
+                                   offset: [@offset - Livechat::ConversationsController::PER_PAGE, 0].max) %>
   <% end %>
   <% if @more %>
     <%= link_to t('livechat.dashboard.older', default: 'Older'),
-                conversations_path(status: @status, offset: @offset + Livechat::ConversationsController::PER_PAGE) %>
+                conversations_path(status: @status, q: @query,
+                                   offset: @offset + Livechat::ConversationsController::PER_PAGE) %>
   <% end %>
 </div>

data/config/locales/livechat.ar.yml

@@ -29,6 +29,8 @@ ar:
       visitor: "الزائر"
       last_message: "آخر رسالة"
       updated: "آخر تحديث"
+      agents: "الوكلاء"
+      search: "بحث"
       back: "جميع المحادثات"
       resolve: "حل"
       reopen: "إعادة فتح"

data/config/locales/livechat.bg.yml

@@ -29,6 +29,8 @@ bg:
       visitor: "Посетител"
       last_message: "Последно съобщение"
       updated: "Обновено"
+      agents: "Агенти"
+      search: "Търсене"
       back: "Всички разговори"
       resolve: "Разреши"
       reopen: "Отвори отново"

data/config/locales/livechat.bn.yml

@@ -29,6 +29,8 @@ bn:
       visitor: "দর্শনার্থী"
       last_message: "শেষ বার্তা"
       updated: "আপডেট হয়েছে"
+      agents: "এজেন্ট"
+      search: "অনুসন্ধান"
       back: "সব কথোপকথন"
       resolve: "সমাধান করুন"
       reopen: "আবার খুলুন"

data/config/locales/livechat.de.yml

@@ -29,6 +29,8 @@ de:
       visitor: "Besucher"
       last_message: "Letzte Nachricht"
       updated: "Aktualisiert"
+      agents: "Agenten"
+      search: "Suchen"
       back: "Alle Unterhaltungen"
       resolve: "Lösen"
       reopen: "Wieder öffnen"

data/config/locales/livechat.el.yml

@@ -29,6 +29,8 @@ el:
       visitor: "Επισκέπτης"
       last_message: "Τελευταίο μήνυμα"
       updated: "Ενημερώθηκε"
+      agents: "Εκπρόσωποι"
+      search: "Αναζήτηση"
       back: "Όλες οι συνομιλίες"
       resolve: "Επίλυση"
       reopen: "Άνοιγμα ξανά"

data/config/locales/livechat.en.yml

@@ -29,6 +29,8 @@ en:
       visitor: "Visitor"
       last_message: "Last message"
       updated: "Updated"
+      agents: "Agents"
+      search: "Search"
       back: "All conversations"
       resolve: "Resolve"
       reopen: "Reopen"

data/config/locales/livechat.es.yml

@@ -29,6 +29,8 @@ es:
       visitor: "Visitante"
       last_message: "Último mensaje"
       updated: "Actualizado"
+      agents: "Agentes"
+      search: "Buscar"
       back: "Todas las conversaciones"
       resolve: "Resolver"
       reopen: "Reabrir"

data/config/locales/livechat.fr.yml

@@ -29,6 +29,8 @@ fr:
       visitor: "Visiteur"
       last_message: "Dernier message"
       updated: "Mise à jour"
+      agents: "Agents"
+      search: "Rechercher"
       back: "Toutes les conversations"
       resolve: "Résoudre"
       reopen: "Rouvrir"

data/config/locales/livechat.hi.yml

@@ -29,6 +29,8 @@ hi:
       visitor: "विज़िटर"
       last_message: "आख़िरी संदेश"
       updated: "अपडेट किया गया"
+      agents: "एजेंट"
+      search: "खोजें"
       back: "सभी बातचीत"
       resolve: "सुलझाएं"
       reopen: "फिर से खोलें"

data/config/locales/livechat.hr.yml

@@ -29,6 +29,8 @@ hr:
       visitor: "Posjetitelj"
       last_message: "Zadnja poruka"
       updated: "Ažurirano"
+      agents: "Agenti"
+      search: "Pretraži"
       back: "Svi razgovori"
       resolve: "Riješi"
       reopen: "Ponovno otvori"

data/config/locales/livechat.id.yml

@@ -29,6 +29,8 @@ id:
       visitor: "Pengunjung"
       last_message: "Pesan terakhir"
       updated: "Diperbarui"
+      agents: "Agen"
+      search: "Cari"
       back: "Semua percakapan"
       resolve: "Selesaikan"
       reopen: "Buka kembali"

data/config/locales/livechat.it.yml

@@ -29,6 +29,8 @@ it:
       visitor: "Visitatore"
       last_message: "Ultimo messaggio"
       updated: "Aggiornata"
+      agents: "Agenti"
+      search: "Cerca"
       back: "Tutte le conversazioni"
       resolve: "Risolvi"
       reopen: "Riapri"

data/config/locales/livechat.ja.yml

@@ -29,6 +29,8 @@ ja:
       visitor: "訪問者"
       last_message: "最後のメッセージ"
       updated: "更新"
+      agents: "担当者"
+      search: "検索"
       back: "すべての会話"
       resolve: "解決"
       reopen: "再開"

data/config/locales/livechat.ko.yml

@@ -29,6 +29,8 @@ ko:
       visitor: "방문자"
       last_message: "마지막 메시지"
       updated: "업데이트"
+      agents: "상담원"
+      search: "검색"
       back: "모든 대화"
       resolve: "해결"
       reopen: "다시 열기"

data/config/locales/livechat.lb.yml

@@ -29,6 +29,8 @@ lb:
       visitor: "Besucher"
       last_message: "Lescht Noriicht"
       updated: "Aktualiséiert"
+      agents: "Agenten"
+      search: "Sichen"
       back: "All Gespréicher"
       resolve: "Léisen"
       reopen: "Nees opmaachen"

data/config/locales/livechat.nl.yml

@@ -29,6 +29,8 @@ nl:
       visitor: "Bezoeker"
       last_message: "Laatste bericht"
       updated: "Bijgewerkt"
+      agents: "Agenten"
+      search: "Zoeken"
       back: "Alle gesprekken"
       resolve: "Oplossen"
       reopen: "Heropenen"

data/config/locales/livechat.pl.yml

@@ -29,6 +29,8 @@ pl:
       visitor: "Odwiedzający"
       last_message: "Ostatnia wiadomość"
       updated: "Zaktualizowano"
+      agents: "Agenci"
+      search: "Szukaj"
       back: "Wszystkie rozmowy"
       resolve: "Rozwiąż"
       reopen: "Wznów"

data/config/locales/livechat.pt.yml

@@ -29,6 +29,8 @@ pt:
       visitor: "Visitante"
       last_message: "Última mensagem"
       updated: "Atualizada"
+      agents: "Agentes"
+      search: "Pesquisar"
       back: "Todas as conversas"
       resolve: "Resolver"
       reopen: "Reabrir"

data/config/locales/livechat.ro.yml

@@ -29,6 +29,8 @@ ro:
       visitor: "Vizitator"
       last_message: "Ultimul mesaj"
       updated: "Actualizat"
+      agents: "Agenți"
+      search: "Căutare"
       back: "Toate conversațiile"
       resolve: "Rezolvă"
       reopen: "Redeschide"

data/config/locales/livechat.ru.yml

@@ -29,6 +29,8 @@ ru:
       visitor: "Посетитель"
       last_message: "Последнее сообщение"
       updated: "Обновлено"
+      agents: "Агенты"
+      search: "Поиск"
       back: "Все диалоги"
       resolve: "Завершить"
       reopen: "Возобновить"

data/config/locales/livechat.th.yml

@@ -29,6 +29,8 @@ th:
       visitor: "ผู้เยี่ยมชม"
       last_message: "ข้อความล่าสุด"
       updated: "อัปเดตเมื่อ"
+      agents: "เจ้าหน้าที่"
+      search: "ค้นหา"
       back: "การสนทนาทั้งหมด"
       resolve: "แก้ไขเสร็จสิ้น"
       reopen: "เปิดอีกครั้ง"

data/config/locales/livechat.tr.yml

@@ -29,6 +29,8 @@ tr:
       visitor: "Ziyaretçi"
       last_message: "Son mesaj"
       updated: "Güncellendi"
+      agents: "Temsilciler"
+      search: "Ara"
       back: "Tüm görüşmeler"
       resolve: "Çöz"
       reopen: "Yeniden aç"

data/config/locales/livechat.uk.yml

@@ -29,6 +29,8 @@ uk:
       visitor: "Відвідувач"
       last_message: "Останнє повідомлення"
       updated: "Оновлено"
+      agents: "Агенти"
+      search: "Пошук"
       back: "Усі розмови"
       resolve: "Завершити"
       reopen: "Відновити"

data/config/locales/livechat.ur.yml

@@ -29,6 +29,8 @@ ur:
       visitor: "وزیٹر"
       last_message: "آخری پیغام"
       updated: "اپ ڈیٹ"
+      agents: "ایجنٹس"
+      search: "تلاش"
       back: "تمام گفتگوئیں"
       resolve: "حل کریں"
       reopen: "دوبارہ کھولیں"

data/config/locales/livechat.vi.yml

@@ -29,6 +29,8 @@ vi:
       visitor: "Khách truy cập"
       last_message: "Tin nhắn cuối"
       updated: "Đã cập nhật"
+      agents: "Nhân viên"
+      search: "Tìm kiếm"
       back: "Tất cả cuộc trò chuyện"
       resolve: "Giải quyết"
       reopen: "Mở lại"

data/config/locales/livechat.zh-CN.yml

@@ -29,6 +29,8 @@
       visitor: "访客"
       last_message: "最后一条消息"
       updated: "更新时间"
+      agents: "客服"
+      search: "搜索"
       back: "所有对话"
       resolve: "解决"
       reopen: "重新打开"

data/config/routes.rb

@@ -15,6 +15,9 @@ Livechat::Engine.routes.draw do
 
   # The inbox. Flat, human URLs: the mount path IS the conversation list.
   resources :conversations, path: '', only: %i[index show], constraints: { id: /\d+/ } do
+    collection do
+      get :poll, action: :index_poll
+    end
     member do
       get :poll
       post :resolve

data/lib/livechat/dashboard.js

@@ -21,6 +21,35 @@
   }
 
   ready(function () {
+    watchIndex();
+    watchThread();
+  });
+
+  // The conversation list keeps itself fresh: when the server's token moves
+  // (new message, new thread, resolve/reopen), just reload — unless the
+  // agent is mid-search, whose typing must never be eaten.
+  function watchIndex() {
+    var index = document.getElementById("lvc-index");
+    if (!index) return;
+
+    var token = index.getAttribute("data-token");
+    var url = index.getAttribute("data-poll-url");
+    var searchBox = document.querySelector(".filters input[type=search]");
+
+    setInterval(function () {
+      if (document.hidden) return;
+      if (searchBox && searchBox.value !== searchBox.defaultValue) return;
+      if (searchBox && document.activeElement === searchBox) return;
+      fetch(url, { headers: { Accept: "application/json" }, credentials: "same-origin" })
+        .then(function (response) { return response.ok ? response.json() : null; })
+        .then(function (data) {
+          if (data && data.token !== token) window.location.reload();
+        })
+        .catch(function () { /* transient network error — next tick retries */ });
+    }, POLL_MS);
+  }
+
+  function watchThread() {
     var thread = document.getElementById("thread");
     if (!thread) return;
 
@@ -54,5 +83,5 @@
         })
         .catch(function () { /* transient network error — next tick retries */ });
     }, POLL_MS);
-  });
+  }
 })();

data/lib/livechat/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Livechat
-  VERSION = '0.2.1'
+  VERSION = '0.3.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: livechat
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.3.0
 platform: ruby
 authors:
 - Yaroslav Shmarov