livechat 0.3.6 → 0.4.0

data/config/locales/livechat.el.yml

@@ -17,6 +17,13 @@ el:
     error_send: "Δεν ήταν δυνατή η αποστολή. Δοκιμάστε ξανά."
     error_rate_limited: "Πάρα πολλά μηνύματα. Περιμένετε λίγο και δοκιμάστε ξανά."
     unread_aria: "μη αναγνωσμένα μηνύματα"
+    attach: "Επισύναψη αρχείων"
+    remove_file: "Αφαίρεση αρχείου"
+    attachment_error: "Ορισμένα αρχεία δεν ήταν δυνατό να σταλούν."
+    attachments:
+      too_many: "Πάρα πολλά αρχεία (έως %{count})."
+      too_large: "Το %{name} είναι πολύ μεγάλο."
+      type_rejected: "Ο τύπος του %{name} δεν επιτρέπεται."
     statuses:
       open: "Ανοιχτή"
       resolved: "Επιλυμένη"
@@ -36,6 +43,7 @@ el:
       reopen: "Άνοιγμα ξανά"
       reply_placeholder: "Γράψτε την απάντησή σας…"
       send: "Αποστολή"
+      attach: "Επισύναψη αρχείων"
       newer: "Νεότερα"
       older: "Παλαιότερα"
     mail:

data/config/locales/livechat.en.yml

@@ -17,6 +17,13 @@ en:
     error_send: "Could not send. Please try again."
     error_rate_limited: "Too many messages. Please wait a moment and try again."
     unread_aria: "unread messages"
+    attach: "Attach files"
+    remove_file: "Remove file"
+    attachment_error: "Some files could not be sent."
+    attachments:
+      too_many: "Too many files (max %{count})."
+      too_large: "%{name} is too large."
+      type_rejected: "%{name}'s type isn't allowed."
     statuses:
       open: "Open"
       resolved: "Resolved"
@@ -36,6 +43,7 @@ en:
       reopen: "Reopen"
       reply_placeholder: "Write your reply…"
       send: "Send"
+      attach: "Attach files"
       newer: "Newer"
       older: "Older"
     mail:

data/config/locales/livechat.es.yml

@@ -17,6 +17,13 @@ es:
     error_send: "No se pudo enviar. Inténtalo de nuevo."
     error_rate_limited: "Demasiados mensajes. Espera un momento e inténtalo de nuevo."
     unread_aria: "mensajes sin leer"
+    attach: "Adjuntar archivos"
+    remove_file: "Quitar archivo"
+    attachment_error: "No se pudieron enviar algunos archivos."
+    attachments:
+      too_many: "Demasiados archivos (máx. %{count})."
+      too_large: "%{name} es demasiado grande."
+      type_rejected: "El tipo de %{name} no está permitido."
     statuses:
       open: "Abierta"
       resolved: "Resuelta"
@@ -36,6 +43,7 @@ es:
       reopen: "Reabrir"
       reply_placeholder: "Escribe tu respuesta…"
       send: "Enviar"
+      attach: "Adjuntar archivos"
       newer: "Más recientes"
       older: "Más antiguos"
     mail:

data/config/locales/livechat.fr.yml

@@ -17,6 +17,13 @@ fr:
     error_send: "Échec de l'envoi. Veuillez réessayer."
     error_rate_limited: "Trop de messages. Veuillez patienter un instant et réessayer."
     unread_aria: "messages non lus"
+    attach: "Joindre des fichiers"
+    remove_file: "Retirer le fichier"
+    attachment_error: "Certains fichiers n'ont pas pu être envoyés."
+    attachments:
+      too_many: "Trop de fichiers (max %{count})."
+      too_large: "%{name} est trop volumineux."
+      type_rejected: "Le type de %{name} n'est pas autorisé."
     statuses:
       open: "Ouverte"
       resolved: "Résolue"
@@ -36,6 +43,7 @@ fr:
       reopen: "Rouvrir"
       reply_placeholder: "Écrivez votre réponse…"
       send: "Envoyer"
+      attach: "Joindre des fichiers"
       newer: "Plus récents"
       older: "Plus anciens"
     mail:

data/config/locales/livechat.hi.yml

@@ -17,6 +17,13 @@ hi:
     error_send: "भेजा नहीं जा सका। कृपया फिर से कोशिश करें।"
     error_rate_limited: "बहुत सारे संदेश। कृपया थोड़ी देर रुककर फिर से कोशिश करें।"
     unread_aria: "अपठित संदेश"
+    attach: "फ़ाइलें संलग्न करें"
+    remove_file: "फ़ाइल हटाएं"
+    attachment_error: "कुछ फ़ाइलें भेजी नहीं जा सकीं।"
+    attachments:
+      too_many: "बहुत सारी फ़ाइलें (अधिकतम %{count})।"
+      too_large: "%{name} बहुत बड़ी है।"
+      type_rejected: "%{name} का प्रकार अनुमत नहीं है।"
     statuses:
       open: "खुली"
       resolved: "सुलझी हुई"
@@ -36,6 +43,7 @@ hi:
       reopen: "फिर से खोलें"
       reply_placeholder: "अपना जवाब लिखें…"
       send: "भेजें"
+      attach: "फ़ाइलें संलग्न करें"
       newer: "नए"
       older: "पुराने"
     mail:

data/config/locales/livechat.hr.yml

@@ -17,6 +17,13 @@ hr:
     error_send: "Slanje nije uspjelo. Pokušajte ponovno."
     error_rate_limited: "Previše poruka. Pričekajte trenutak i pokušajte ponovno."
     unread_aria: "nepročitane poruke"
+    attach: "Priloži datoteke"
+    remove_file: "Ukloni datoteku"
+    attachment_error: "Neke datoteke nije bilo moguće poslati."
+    attachments:
+      too_many: "Previše datoteka (najviše %{count})."
+      too_large: "%{name} je prevelika."
+      type_rejected: "Vrsta datoteke %{name} nije dopuštena."
     statuses:
       open: "Otvoren"
       resolved: "Riješen"
@@ -36,6 +43,7 @@ hr:
       reopen: "Ponovno otvori"
       reply_placeholder: "Napišite svoj odgovor…"
       send: "Pošalji"
+      attach: "Priloži datoteke"
       newer: "Novije"
       older: "Starije"
     mail:

data/config/locales/livechat.id.yml

@@ -17,6 +17,13 @@ id:
     error_send: "Tidak dapat mengirim. Silakan coba lagi."
     error_rate_limited: "Terlalu banyak pesan. Mohon tunggu sebentar dan coba lagi."
     unread_aria: "pesan belum dibaca"
+    attach: "Lampirkan file"
+    remove_file: "Hapus file"
+    attachment_error: "Beberapa file tidak dapat dikirim."
+    attachments:
+      too_many: "Terlalu banyak file (maks. %{count})."
+      too_large: "%{name} terlalu besar."
+      type_rejected: "Tipe %{name} tidak diizinkan."
     statuses:
       open: "Terbuka"
       resolved: "Selesai"
@@ -36,6 +43,7 @@ id:
       reopen: "Buka kembali"
       reply_placeholder: "Tulis balasan Anda…"
       send: "Kirim"
+      attach: "Lampirkan file"
       newer: "Lebih baru"
       older: "Lebih lama"
     mail:

data/config/locales/livechat.it.yml

@@ -17,6 +17,13 @@ it:
     error_send: "Invio non riuscito. Riprova."
     error_rate_limited: "Troppi messaggi. Attendi un momento e riprova."
     unread_aria: "messaggi non letti"
+    attach: "Allega file"
+    remove_file: "Rimuovi file"
+    attachment_error: "Non è stato possibile inviare alcuni file."
+    attachments:
+      too_many: "Troppi file (max %{count})."
+      too_large: "%{name} è troppo grande."
+      type_rejected: "Il tipo di %{name} non è consentito."
     statuses:
       open: "Aperta"
       resolved: "Risolta"
@@ -36,6 +43,7 @@ it:
       reopen: "Riapri"
       reply_placeholder: "Scrivi la tua risposta…"
       send: "Invia"
+      attach: "Allega file"
       newer: "Più recenti"
       older: "Più vecchi"
     mail:

data/config/locales/livechat.ja.yml

@@ -17,6 +17,13 @@ ja:
     error_send: "送信できませんでした。もう一度お試しください。"
     error_rate_limited: "メッセージが多すぎます。少し待ってからもう一度お試しください。"
     unread_aria: "件の未読メッセージ"
+    attach: "ファイルを添付"
+    remove_file: "ファイルを削除"
+    attachment_error: "一部のファイルを送信できませんでした。"
+    attachments:
+      too_many: "ファイルが多すぎます(最大%{count}件)。"
+      too_large: "%{name}が大きすぎます。"
+      type_rejected: "%{name}の種類は許可されていません。"
     statuses:
       open: "対応中"
       resolved: "解決済み"
@@ -36,6 +43,7 @@ ja:
       reopen: "再開"
       reply_placeholder: "返信を入力…"
       send: "送信"
+      attach: "ファイルを添付"
       newer: "新しい"
       older: "古い"
     mail:

data/config/locales/livechat.ko.yml

@@ -17,6 +17,13 @@ ko:
     error_send: "전송하지 못했습니다. 다시 시도해 주세요."
     error_rate_limited: "메시지가 너무 많습니다. 잠시 후 다시 시도해 주세요."
     unread_aria: "읽지 않은 메시지"
+    attach: "파일 첨부"
+    remove_file: "파일 제거"
+    attachment_error: "일부 파일을 보내지 못했습니다."
+    attachments:
+      too_many: "파일이 너무 많습니다 (최대 %{count}개)."
+      too_large: "%{name}이(가) 너무 큽니다."
+      type_rejected: "%{name}의 형식은 허용되지 않습니다."
     statuses:
       open: "진행 중"
       resolved: "해결됨"
@@ -36,6 +43,7 @@ ko:
       reopen: "다시 열기"
       reply_placeholder: "답장을 입력하세요…"
       send: "보내기"
+      attach: "파일 첨부"
       newer: "최신"
       older: "이전"
     mail:

data/config/locales/livechat.lb.yml

@@ -17,6 +17,13 @@ lb:
     error_send: "Konnt net geschéckt ginn. Probéiert w.e.g. nach eng Kéier."
     error_rate_limited: "Ze vill Noriichten. Waart w.e.g. e Moment a probéiert nach eng Kéier."
     unread_aria: "ongelies Noriichten"
+    attach: "Dateien uschléissen"
+    remove_file: "Datei ewechhuelen"
+    attachment_error: "E puer Dateie konnten net geschéckt ginn."
+    attachments:
+      too_many: "Ze vill Dateien (max %{count})."
+      too_large: "%{name} ass ze grouss."
+      type_rejected: "Den Typ vun %{name} ass net erlaabt."
     statuses:
       open: "Op"
       resolved: "Geléist"
@@ -36,6 +43,7 @@ lb:
       reopen: "Nees opmaachen"
       reply_placeholder: "Schreift Är Äntwert…"
       send: "Schécken"
+      attach: "Dateien uschléissen"
       newer: "Méi nei"
       older: "Méi al"
     mail:

data/config/locales/livechat.nl.yml

@@ -17,6 +17,13 @@ nl:
     error_send: "Versturen is niet gelukt. Probeer het opnieuw."
     error_rate_limited: "Te veel berichten. Wacht even en probeer het opnieuw."
     unread_aria: "ongelezen berichten"
+    attach: "Bestanden bijvoegen"
+    remove_file: "Bestand verwijderen"
+    attachment_error: "Sommige bestanden konden niet worden verzonden."
+    attachments:
+      too_many: "Te veel bestanden (max. %{count})."
+      too_large: "%{name} is te groot."
+      type_rejected: "Het type van %{name} is niet toegestaan."
     statuses:
       open: "Open"
       resolved: "Opgelost"
@@ -36,6 +43,7 @@ nl:
       reopen: "Heropenen"
       reply_placeholder: "Schrijf je antwoord…"
       send: "Versturen"
+      attach: "Bestanden bijvoegen"
       newer: "Nieuwer"
       older: "Ouder"
     mail:

data/config/locales/livechat.pl.yml

@@ -17,6 +17,13 @@ pl:
     error_send: "Nie udało się wysłać. Spróbuj ponownie."
     error_rate_limited: "Zbyt wiele wiadomości. Poczekaj chwilę i spróbuj ponownie."
     unread_aria: "nieprzeczytane wiadomości"
+    attach: "Załącz pliki"
+    remove_file: "Usuń plik"
+    attachment_error: "Nie udało się wysłać niektórych plików."
+    attachments:
+      too_many: "Zbyt wiele plików (maks. %{count})."
+      too_large: "%{name} jest za duży."
+      type_rejected: "Typ pliku %{name} jest niedozwolony."
     statuses:
       open: "Otwarta"
       resolved: "Rozwiązana"
@@ -36,6 +43,7 @@ pl:
       reopen: "Wznów"
       reply_placeholder: "Napisz odpowiedź…"
       send: "Wyślij"
+      attach: "Załącz pliki"
       newer: "Nowsze"
       older: "Starsze"
     mail:

data/config/locales/livechat.pt.yml

@@ -17,6 +17,13 @@ pt:
     error_send: "Não foi possível enviar. Tente novamente."
     error_rate_limited: "Muitas mensagens. Aguarde um momento e tente novamente."
     unread_aria: "mensagens não lidas"
+    attach: "Anexar arquivos"
+    remove_file: "Remover arquivo"
+    attachment_error: "Não foi possível enviar alguns arquivos."
+    attachments:
+      too_many: "Muitos arquivos (máx. %{count})."
+      too_large: "%{name} é muito grande."
+      type_rejected: "O tipo de %{name} não é permitido."
     statuses:
       open: "Aberta"
       resolved: "Resolvida"
@@ -36,6 +43,7 @@ pt:
       reopen: "Reabrir"
       reply_placeholder: "Escreva sua resposta…"
       send: "Enviar"
+      attach: "Anexar arquivos"
       newer: "Mais recentes"
       older: "Mais antigas"
     mail:

data/config/locales/livechat.ro.yml

@@ -17,6 +17,13 @@ ro:
     error_send: "Nu s-a putut trimite. Vă rugăm să încercați din nou."
     error_rate_limited: "Prea multe mesaje. Așteptați puțin și încercați din nou."
     unread_aria: "mesaje necitite"
+    attach: "Atașează fișiere"
+    remove_file: "Elimină fișierul"
+    attachment_error: "Unele fișiere nu au putut fi trimise."
+    attachments:
+      too_many: "Prea multe fișiere (max. %{count})."
+      too_large: "%{name} este prea mare."
+      type_rejected: "Tipul fișierului %{name} nu este permis."
     statuses:
       open: "Deschisă"
       resolved: "Rezolvată"
@@ -36,6 +43,7 @@ ro:
       reopen: "Redeschide"
       reply_placeholder: "Scrieți răspunsul…"
       send: "Trimite"
+      attach: "Atașează fișiere"
       newer: "Mai noi"
       older: "Mai vechi"
     mail:

data/config/locales/livechat.ru.yml

@@ -17,6 +17,13 @@ ru:
     error_send: "Не удалось отправить. Пожалуйста, попробуйте ещё раз."
     error_rate_limited: "Слишком много сообщений. Подождите немного и попробуйте ещё раз."
     unread_aria: "непрочитанные сообщения"
+    attach: "Прикрепить файлы"
+    remove_file: "Удалить файл"
+    attachment_error: "Некоторые файлы не удалось отправить."
+    attachments:
+      too_many: "Слишком много файлов (макс. %{count})."
+      too_large: "%{name} слишком большой."
+      type_rejected: "Тип файла %{name} не разрешён."
     statuses:
       open: "Открыт"
       resolved: "Завершён"
@@ -36,6 +43,7 @@ ru:
       reopen: "Возобновить"
       reply_placeholder: "Напишите ответ…"
       send: "Отправить"
+      attach: "Прикрепить файлы"
       newer: "Новее"
       older: "Старше"
     mail:

data/config/locales/livechat.th.yml

@@ -17,6 +17,13 @@ th:
     error_send: "ส่งไม่สำเร็จ โปรดลองอีกครั้ง"
     error_rate_limited: "ข้อความมากเกินไป โปรดรอสักครู่แล้วลองอีกครั้ง"
     unread_aria: "ข้อความที่ยังไม่ได้อ่าน"
+    attach: "แนบไฟล์"
+    remove_file: "นำไฟล์ออก"
+    attachment_error: "ไม่สามารถส่งไฟล์บางไฟล์ได้"
+    attachments:
+      too_many: "ไฟล์มากเกินไป (สูงสุด %{count})"
+      too_large: "%{name} มีขนาดใหญ่เกินไป"
+      type_rejected: "ไม่อนุญาตประเภทของ %{name}"
     statuses:
       open: "เปิดอยู่"
       resolved: "แก้ไขแล้ว"
@@ -36,6 +43,7 @@ th:
       reopen: "เปิดอีกครั้ง"
       reply_placeholder: "เขียนคำตอบของคุณ…"
       send: "ส่ง"
+      attach: "แนบไฟล์"
       newer: "ใหม่กว่า"
       older: "เก่ากว่า"
     mail:

data/config/locales/livechat.tr.yml

@@ -17,6 +17,13 @@ tr:
     error_send: "Gönderilemedi. Lütfen tekrar deneyin."
     error_rate_limited: "Çok fazla mesaj. Lütfen biraz bekleyip tekrar deneyin."
     unread_aria: "okunmamış mesaj"
+    attach: "Dosya ekle"
+    remove_file: "Dosyayı kaldır"
+    attachment_error: "Bazı dosyalar gönderilemedi."
+    attachments:
+      too_many: "Çok fazla dosya (en fazla %{count})."
+      too_large: "%{name} çok büyük."
+      type_rejected: "%{name} dosyasının türüne izin verilmiyor."
     statuses:
       open: "Açık"
       resolved: "Çözüldü"
@@ -36,6 +43,7 @@ tr:
       reopen: "Yeniden aç"
       reply_placeholder: "Yanıtınızı yazın…"
       send: "Gönder"
+      attach: "Dosya ekle"
       newer: "Daha yeni"
       older: "Daha eski"
     mail:

data/config/locales/livechat.uk.yml

@@ -17,6 +17,13 @@ uk:
     error_send: "Не вдалося надіслати. Будь ласка, спробуйте ще раз."
     error_rate_limited: "Забагато повідомлень. Зачекайте трохи та спробуйте ще раз."
     unread_aria: "непрочитані повідомлення"
+    attach: "Прикріпити файли"
+    remove_file: "Видалити файл"
+    attachment_error: "Деякі файли не вдалося надіслати."
+    attachments:
+      too_many: "Забагато файлів (максимум %{count})."
+      too_large: "%{name} завеликий."
+      type_rejected: "Тип файлу %{name} не дозволено."
     statuses:
       open: "Відкрита"
       resolved: "Завершена"
@@ -36,6 +43,7 @@ uk:
       reopen: "Відновити"
       reply_placeholder: "Напишіть відповідь…"
       send: "Надіслати"
+      attach: "Прикріпити файли"
       newer: "Новіші"
       older: "Старіші"
     mail:

data/config/locales/livechat.ur.yml

@@ -17,6 +17,13 @@ ur:
     error_send: "بھیجا نہیں جا سکا۔ براہ کرم دوبارہ کوشش کریں۔"
     error_rate_limited: "بہت زیادہ پیغامات۔ براہ کرم تھوڑا انتظار کریں اور دوبارہ کوشش کریں۔"
     unread_aria: "غیر پڑھے گئے پیغامات"
+    attach: "فائلیں منسلک کریں"
+    remove_file: "فائل ہٹائیں"
+    attachment_error: "کچھ فائلیں نہیں بھیجی جا سکیں۔"
+    attachments:
+      too_many: "بہت زیادہ فائلیں (زیادہ سے زیادہ %{count})۔"
+      too_large: "%{name} بہت بڑی ہے۔"
+      type_rejected: "%{name} کی قسم کی اجازت نہیں ہے۔"
     statuses:
       open: "کھلی"
       resolved: "حل شدہ"
@@ -36,6 +43,7 @@ ur:
       reopen: "دوبارہ کھولیں"
       reply_placeholder: "اپنا جواب لکھیں…"
       send: "بھیجیں"
+      attach: "فائلیں منسلک کریں"
       newer: "نئے"
       older: "پرانے"
     mail:

data/config/locales/livechat.vi.yml

@@ -17,6 +17,13 @@ vi:
     error_send: "Không thể gửi. Vui lòng thử lại."
     error_rate_limited: "Quá nhiều tin nhắn. Vui lòng đợi một lát rồi thử lại."
     unread_aria: "tin nhắn chưa đọc"
+    attach: "Đính kèm tệp"
+    remove_file: "Xóa tệp"
+    attachment_error: "Không thể gửi một số tệp."
+    attachments:
+      too_many: "Quá nhiều tệp (tối đa %{count})."
+      too_large: "%{name} quá lớn."
+      type_rejected: "Loại tệp %{name} không được phép."
     statuses:
       open: "Đang mở"
       resolved: "Đã giải quyết"
@@ -36,6 +43,7 @@ vi:
       reopen: "Mở lại"
       reply_placeholder: "Viết câu trả lời của bạn…"
       send: "Gửi"
+      attach: "Đính kèm tệp"
       newer: "Mới hơn"
       older: "Cũ hơn"
     mail:

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

@@ -17,6 +17,13 @@
     error_send: "发送失败，请重试。"
     error_rate_limited: "消息过多，请稍等片刻再重试。"
     unread_aria: "条未读消息"
+    attach: "附加文件"
+    remove_file: "移除文件"
+    attachment_error: "部分文件无法发送。"
+    attachments:
+      too_many: "文件过多（最多 %{count} 个）。"
+      too_large: "%{name} 太大。"
+      type_rejected: "不允许 %{name} 的类型。"
     statuses:
       open: "进行中"
       resolved: "已解决"
@@ -36,6 +43,7 @@
       reopen: "重新打开"
       reply_placeholder: "输入您的回复…"
       send: "发送"
+      attach: "附加文件"
       newer: "较新"
       older: "较旧"
     mail:

data/config/routes.rb

@@ -13,6 +13,12 @@ Livechat::Engine.routes.draw do
     post 'read', to: 'visitor#read'
   end
 
+  # Message attachments, gated by the engine (never a public blob URL). One
+  # route for both sides — the controller decides whether you're the visitor
+  # who owns the thread or an agent. Above the conversations catch-all, and
+  # id-constrained so it never shadows a numeric conversation path.
+  get 'attachments/:id', to: 'attachments#show', as: :attachment, constraints: { id: /\d+/ }
+
   # 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

data/lib/generators/livechat/install/templates/initializer.rb

@@ -62,6 +62,21 @@ Livechat.configure do |config|
   # Per-IP throttle for the widget endpoints (Rails 7.2+; ignored on 7.1).
   # config.rate_limit = { to: 30, within: 1.minute }
 
+  # File attachments. On by default, but only take effect where the app has
+  # Active Storage (run `rails active_storage:install` once). Files are served
+  # through the engine — gated the same as the chat — never a public blob URL.
+  # config.attach_files = true
+  # config.max_attachments = 5
+  # config.max_attachment_size = 10.megabytes
+  # config.allowed_attachment_types = nil # e.g. %w[image/png image/jpeg application/pdf]
+
+  # Realtime push over Action Cable. Off by default — the widget and inbox
+  # poll, which needs nothing from your app. Turn this on to push new messages
+  # the instant they arrive; polling stays the fallback. Requires Action Cable
+  # mounted (the default `mount ActionCable... => "/cable"` in your routes).
+  # config.action_cable = true
+  # config.action_cable_url = "/cable"
+
   # Keep in sync with the `mount` in config/routes.rb.
   # config.mount_path = "/livechat"
 end

data/lib/livechat/channels.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+# Loaded from the engine only when Action Cable is present (see engine.rb), so
+# a host without a cable never pays for it and never trips Zeitwerk eager-load
+# on a missing ActionCable constant.
+module Livechat
+  # One channel for both sides of the chat. It carries no payload of its own —
+  # a broadcast is a nudge ("something changed on this stream"); the client
+  # then refetches through the same gated endpoint it already polls, so the
+  # rendering, dedup and read-tracking logic stays in one place.
+  #
+  # Authorization IS the signature: the server only ever signs a stream name
+  # it already let this subscriber see — the widget gets its conversation
+  # stream from the gated /conversation endpoint, an agent gets conversation
+  # and inbox streams from the (authorized) inbox pages. A subscriber that
+  # can't present a validly signed livechat: stream is rejected.
+  class StreamChannel < ActionCable::Channel::Base
+    def subscribed
+      stream = Livechat.verify_stream(params[:signed_stream])
+      if stream&.start_with?('livechat:')
+        stream_from stream
+      else
+        reject
+      end
+    end
+  end
+end

data/lib/livechat/configuration.rb

@@ -65,6 +65,28 @@ module Livechat
     # Rails' rate limiter (Rails 7.2+; ignored on 7.1). nil disables it.
     attr_accessor :rate_limit
 
+    # Let visitors and agents attach files to messages. Requires Active
+    # Storage in the host app (rails active_storage:install); silently
+    # ignored when it isn't present, so the widget keeps working. Set false
+    # to turn attachments off even where Active Storage exists.
+    attr_accessor :attach_files
+
+    # Cap on attachments per message, on the size of each file (bytes), and
+    # an optional content-type allowlist (nil accepts any type). Enforced on
+    # the server; a rejected upload comes back as a validation error.
+    attr_accessor :max_attachments, :max_attachment_size, :allowed_attachment_types
+
+    # Push new messages over Action Cable instead of waiting for the next
+    # poll. Opt-in and off by default: polling stays the transport, so a
+    # host that never mounts a cable keeps working; when on (and Action Cable
+    # is present) a new message nudges the widget and the inbox to refresh at
+    # once. Requires `/cable` mounted in the host's routes.
+    attr_accessor :action_cable
+
+    # Where the host mounts Action Cable. Only consulted when action_cable is
+    # on. Keep in sync with the `mount ActionCable... => "/cable"` in routes.
+    attr_accessor :action_cable_url
+
     # Where the engine is mounted. The widget calls paths under it, so keep
     # this in sync with the `mount` line in your routes.
     attr_accessor :mount_path
@@ -88,6 +110,12 @@ module Livechat
       @on_agent_message = ->(_message) {}
       @rate_limit = { to: 30, within: 60 }
       @mount_path = '/livechat'
+      @attach_files = true
+      @max_attachments = 5
+      @max_attachment_size = 10 * 1024 * 1024
+      @allowed_attachment_types = nil
+      @action_cable = false
+      @action_cable_url = '/cable'
     end
 
     def widget_endpoint = "#{mount_path.chomp('/')}/widget"