polylingo_chat 0.1.0 → 0.4.0

data/lib/generators/polylingo_chat/install/templates/views/polylingo_chat/conversations/show.html.erb

@@ -0,0 +1,141 @@
+<div class="polylingo-conversation-show">
+  <h1><%%= @conversation.title || "Conversation ##{@conversation.id}" %></h1>
+
+  <div class="conversation-info">
+    <p>
+      <strong>Participants:</strong>
+      <%%= @conversation.participantables.map { |p| p.try(:name) || p.try(:email) }.join(', ') %>
+    </p>
+  </div>
+
+  <div id="messages" class="messages-container">
+    <%% @conversation.messages.order(created_at: :asc).each do |message| %>
+      <div class="message <%%= message.sender == current_user ? 'sent' : 'received' %>" data-message-id="<%%= message.id %>">
+        <div class="message-sender"><%%= message.sender_name %></div>
+        <div class="message-body"><%%= message.translated_body || message.body %></div>
+        <div class="message-time"><%%= time_ago_in_words(message.created_at) %> ago</div>
+      </div>
+    <%% end %>
+  </div>
+
+  <!-- Message input form -->
+  <div class="message-form">
+    <%%= form_with url: polylingo_chat_conversation_messages_path(@conversation), method: :post, local: true, class: "new-message-form" do |f| %>
+      <div class="form-group">
+        <%%= text_area_tag "message[body]", nil, placeholder: "Type your message...", class: "message-input", rows: 3 %>
+        <%%= hidden_field_tag :sender_type, current_user.class.name %>
+        <%%= hidden_field_tag :sender_id, current_user.id %>
+      </div>
+      <%%= f.submit "Send", class: "btn-send" %>
+    <%% end %>
+  </div>
+
+  <p>
+    <%%= link_to "← Back to Conversations", polylingo_chat_conversations_path, class: "btn-back" %>
+  </p>
+</div>
+
+<script>
+  // Set up for real-time chat via ActionCable
+  window.conversationId = <%%= @conversation.id %>;
+  window.currentUserId = <%%= current_user&.id || 'null' %>;
+</script>
+
+<style>
+  .polylingo-conversation-show {
+    max-width: 800px;
+    margin: 0 auto;
+    padding: 20px;
+  }
+
+  .conversation-info {
+    padding: 10px;
+    background: #f0f0f0;
+    border-radius: 5px;
+    margin-bottom: 20px;
+  }
+
+  .messages-container {
+    min-height: 400px;
+    max-height: 600px;
+    overflow-y: auto;
+    padding: 20px;
+    border: 1px solid #ddd;
+    border-radius: 8px;
+    background: #fff;
+    margin-bottom: 20px;
+  }
+
+  .message {
+    margin-bottom: 15px;
+    padding: 10px;
+    border-radius: 8px;
+    max-width: 70%;
+  }
+
+  .message.sent {
+    margin-left: auto;
+    background: #007bff;
+    color: white;
+    text-align: right;
+  }
+
+  .message.received {
+    background: #f1f1f1;
+    color: #333;
+  }
+
+  .message-sender {
+    font-weight: bold;
+    font-size: 0.9em;
+    margin-bottom: 5px;
+  }
+
+  .message-body {
+    margin-bottom: 5px;
+  }
+
+  .message-time {
+    font-size: 0.8em;
+    opacity: 0.7;
+  }
+
+  .message-form {
+    background: #f9f9f9;
+    padding: 15px;
+    border-radius: 8px;
+    margin-bottom: 20px;
+  }
+
+  .message-input {
+    width: 100%;
+    padding: 10px;
+    border: 1px solid #ddd;
+    border-radius: 5px;
+    margin-bottom: 10px;
+    font-family: inherit;
+    resize: vertical;
+  }
+
+  .btn-send {
+    background: #007bff;
+    color: white;
+    padding: 10px 20px;
+    border: none;
+    border-radius: 5px;
+    cursor: pointer;
+  }
+
+  .btn-send:hover {
+    background: #0056b3;
+  }
+
+  .btn-back {
+    color: #007bff;
+    text-decoration: none;
+  }
+
+  .btn-back:hover {
+    text-decoration: underline;
+  }
+</style>

data/lib/polylingo_chat/translator/anthropic_client.rb

@@ -21,7 +21,7 @@ module PolylingoChat
           # caching
           cache_key = "polylingo_chat:#{Digest::SHA1.hexdigest([text, from, to, context].join(':'))}"
           if (cache = PolylingoChat.config.cache_store)
-            cached = cache.get(cache_key) rescue nil
+            cached = cache.get(cache_key) rescue StandardError; nil
             return JSON.parse(cached)['translated'] if cached
           end
 
@@ -31,7 +31,7 @@ module PolylingoChat
           if (cache = PolylingoChat.config.cache_store)
             begin
               cache.set(cache_key, { translated: translated }.to_json)
-            rescue => e
+            rescue StandardError => e
               # ignore cache failures
             end
           end

data/lib/polylingo_chat/translator/gemini_client.rb

@@ -21,7 +21,7 @@ module PolylingoChat
           # caching
           cache_key = "polylingo_chat:#{Digest::SHA1.hexdigest([text, from, to, context].join(':'))}"
           if (cache = PolylingoChat.config.cache_store)
-            cached = cache.get(cache_key) rescue nil
+            cached = cache.get(cache_key) rescue StandardError; nil
             return JSON.parse(cached)['translated'] if cached
           end
 
@@ -31,7 +31,7 @@ module PolylingoChat
           if (cache = PolylingoChat.config.cache_store)
             begin
               cache.set(cache_key, { translated: translated }.to_json)
-            rescue => e
+            rescue StandardError => e
               # ignore cache failures
             end
           end

data/lib/polylingo_chat/translator/openai_client.rb

@@ -23,7 +23,7 @@ module PolylingoChat
           # caching
           cache_key = "polylingo_chat:#{Digest::SHA1.hexdigest([text, from, to, context].join(':'))}"
           if (cache = PolylingoChat.config.cache_store)
-            cached = cache.get(cache_key) rescue nil
+            cached = cache.get(cache_key) rescue StandardError; nil
             return JSON.parse(cached)['translated'] if cached
           end
 
@@ -33,7 +33,7 @@ module PolylingoChat
           if (cache = PolylingoChat.config.cache_store)
             begin
               cache.set(cache_key, { translated: translated }.to_json)
-            rescue => e
+            rescue StandardError => e
               # ignore cache failures
             end
           end

data/lib/polylingo_chat/version.rb

@@ -1,3 +1,3 @@
 module PolylingoChat
-  VERSION = '0.1.0'
+  VERSION = '0.4.0'
 end

data/lib/polylingo_chat.rb

@@ -3,7 +3,6 @@ require 'polylingo_chat/engine'
 require 'polylingo_chat/config'
 require 'polylingo_chat/railtie'
 require 'polylingo_chat/translator'
-require 'polylingo_chat/translate_job'
 require 'polylingo_chat/realtime'
 
 module PolylingoChat

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: polylingo_chat
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Shoaib Malik
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-11-17 00:00:00.000000000 Z
+date: 2025-11-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -17,6 +17,9 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '6.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -24,6 +27,9 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '6.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
 - !ruby/object:Gem::Dependency
   name: faraday
   requirement: !ruby/object:Gem::Requirement
@@ -52,20 +58,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.2'
-- !ruby/object:Gem::Dependency
-  name: json
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
 description:
 email:
 - shoaib2109@gmail.com
@@ -74,38 +66,33 @@ extensions: []
 extra_rdoc_files: []
 files:
 - README.md
+- lib/generators/polylingo_chat/install/README
 - lib/generators/polylingo_chat/install/install_generator.rb
 - lib/generators/polylingo_chat/install/templates/README
 - lib/generators/polylingo_chat/install/templates/channels/application_cable/channel.rb
 - lib/generators/polylingo_chat/install/templates/channels/application_cable/connection.rb
 - lib/generators/polylingo_chat/install/templates/channels/polylingo_chat_channel.rb
+- lib/generators/polylingo_chat/install/templates/controllers/polylingo_chat/conversations_controller.rb
+- lib/generators/polylingo_chat/install/templates/controllers/polylingo_chat/messages_controller.rb
 - lib/generators/polylingo_chat/install/templates/create_conversations.rb
+- lib/generators/polylingo_chat/install/templates/create_message_translations.rb
 - lib/generators/polylingo_chat/install/templates/create_messages.rb
 - lib/generators/polylingo_chat/install/templates/create_participants.rb
 - lib/generators/polylingo_chat/install/templates/initializer.rb
 - lib/generators/polylingo_chat/install/templates/javascript/channels/consumer.js
 - lib/generators/polylingo_chat/install/templates/javascript/channels/index.js
 - lib/generators/polylingo_chat/install/templates/javascript/chat.js
+- lib/generators/polylingo_chat/install/templates/jobs/translate_job.rb
 - lib/generators/polylingo_chat/install/templates/models/conversation.rb
 - lib/generators/polylingo_chat/install/templates/models/message.rb
 - lib/generators/polylingo_chat/install/templates/models/participant.rb
-- lib/generators/polylingo_chat/install_generator.rb
-- lib/generators/polylingo_chat/templates/INSTALL_README.md
-- lib/generators/polylingo_chat/templates/chat_channel_example.js
-- lib/generators/polylingo_chat/templates/create_polyglot_conversations.rb
-- lib/generators/polylingo_chat/templates/create_polyglot_messages.rb
-- lib/generators/polylingo_chat/templates/create_polyglot_participants.rb
-- lib/generators/polylingo_chat/templates/models/conversation.rb
-- lib/generators/polylingo_chat/templates/models/message.rb
-- lib/generators/polylingo_chat/templates/models/participant.rb
-- lib/generators/polylingo_chat/templates/polyglot.rb
-- lib/generators/polylingo_chat/templates/polylingo_chat_channel.rb
+- lib/generators/polylingo_chat/install/templates/views/polylingo_chat/conversations/index.html.erb
+- lib/generators/polylingo_chat/install/templates/views/polylingo_chat/conversations/show.html.erb
 - lib/polylingo_chat.rb
 - lib/polylingo_chat/config.rb
 - lib/polylingo_chat/engine.rb
 - lib/polylingo_chat/railtie.rb
 - lib/polylingo_chat/realtime.rb
-- lib/polylingo_chat/translate_job.rb
 - lib/polylingo_chat/translator.rb
 - lib/polylingo_chat/translator/anthropic_client.rb
 - lib/polylingo_chat/translator/base.rb
@@ -134,5 +121,6 @@ requirements: []
 rubygems_version: 3.4.10
 signing_key:
 specification_version: 4
-summary: Realtime chat with automatic AI translation for Ruby/Rails apps
+summary: Realtime chat with automatic AI translation for Ruby/Rails apps - supports
+  API-only mode and polymorphic associations
 test_files: []

data/lib/generators/polylingo_chat/install_generator.rb

@@ -1,38 +0,0 @@
-require 'rails/generators'
-module PolylingoChat
-  module Generators
-    class InstallGenerator < Rails::Generators::Base
-      source_root File.expand_path('templates', __dir__)
-
-      def copy_initializer
-        template 'polylingo_chat.rb', 'config/initializers/polylingo_chat.rb'
-      end
-
-      def copy_channel
-        template 'polylingo_chat_chat_channel.rb', 'app/channels/polylingo_chat_chat_channel.rb'
-      end
-
-      def copy_js_example
-        template 'chat_channel_example.js', 'app/javascript/channels/polylingo_chat_chat_channel.js'
-      end
-
-      def copy_models
-        template 'models/conversation.rb', 'app/models/conversation.rb'
-        template 'models/participant.rb',  'app/models/participant.rb'
-        template 'models/message.rb',      'app/models/message.rb'
-      end
-
-      def copy_migrations
-        migration_template 'create_polylingo_chat_conversations.rb', 'db/migrate/create_polylingo_chat_conversations.rb'
-        migration_template 'create_polylingo_chat_participants.rb',  'db/migrate/create_polylingo_chat_participants.rb'
-        migration_template 'create_polylingo_chat_messages.rb',      'db/migrate/create_polylingo_chat_messages.rb'
-      rescue => e
-        say_status('warning', 'Skipping migrations: ensure you add your own Message/Conversation models or run generator again with --migrate', :yellow)
-      end
-
-      def show_readme
-        readme 'INSTALL_README.md' if behavior == :invoke
-      end
-    end
-  end
-end

data/lib/generators/polylingo_chat/templates/INSTALL_README.md

@@ -1,124 +0,0 @@
-## PolylingoChat Installation Complete!
-
-### Next Steps:
-
-**PolylingoChat can work in TWO modes:**
-1. **Chat-Only Mode:** Real-time chat without translation (no API key needed)
-2. **With Translation:** AI-powered translation (API key required)
-
----
-
-### 1. Run migrations
-```bash
-bin/rails db:migrate
-```
-
-### 2. Configure ActiveJob
-
-```ruby
-# config/application.rb or config/environments/production.rb
-config.active_job.queue_adapter = :sidekiq  # or :solid_queue, :delayed_job, :async
-```
-
-### 3. Install your background job processor
-
-**Sidekiq:**
-```ruby
-# Gemfile
-gem 'sidekiq'
-```
-Then: `bundle install && bundle exec sidekiq`
-
-**Solid Queue:**
-```ruby
-# Gemfile
-gem 'solid_queue'
-```
-Then: `bundle install && bin/rails solid_queue:install && bin/rails db:migrate && bin/rails solid_queue:start`
-
-**Delayed Job:**
-```ruby
-# Gemfile
-gem 'delayed_job_active_record'
-```
-Then: `bundle install && bin/rails generate delayed_job:active_record && bin/rails db:migrate && bin/rails jobs:work`
-
----
-
-### 4. Configure PolylingoChat
-
-Edit `config/initializers/polylingo_chat.rb`:
-
-**Option A: Chat-Only (No Translation)**
-```ruby
-PolylingoChat.configure do |config|
-  # Leave api_key as nil for chat-only mode
-  config.api_key = nil
-  config.queue_adapter = :sidekiq
-  config.async = true
-end
-```
-
-**Option B: With AI Translation**
-```ruby
-PolylingoChat.configure do |config|
-  # Enable translation
-  config.provider = :openai  # or :anthropic, :gemini
-  config.api_key = ENV['POLYGLOT_API_KEY']
-  config.model = 'gpt-4o-mini'
-
-  config.queue_adapter = :sidekiq
-  config.default_language = 'en'
-  config.cache_store = Rails.cache
-end
-```
-
----
-
-### 5. (Optional) Add preferred_language to User
-
-**Only needed if using translation:**
-```bash
-bin/rails generate migration AddPreferredLanguageToUsers preferred_language:string
-bin/rails db:migrate
-```
-
----
-
-### 6. Get API Key (Optional)
-
-**Only if you want translation:**
-- OpenAI: https://platform.openai.com/api-keys
-- Anthropic: https://console.anthropic.com/
-- Gemini: https://ai.google.dev/
-
-```bash
-# .env
-POLYGLOT_API_KEY=your-key-here
-```
-
----
-
-### Testing
-
-```ruby
-conversation = Conversation.create!(title: "Test")
-Participant.create!(conversation: conversation, user: user1)
-Participant.create!(conversation: conversation, user: user2)
-
-Message.create!(
-  conversation: conversation,
-  sender: user1,
-  body: "Hello!"
-)
-```
-
-- **Without API key:** Message sent as-is
-- **With API key:** Message translated to each user's language
-
----
-
-### Need Help?
-
-- 📖 Documentation: https://github.com/shoaibmalik786/polylingo_chat
-- 🐛 Issues: https://github.com/shoaibmalik786/polylingo_chat/issues

data/lib/generators/polylingo_chat/templates/chat_channel_example.js

@@ -1,18 +0,0 @@
-import consumer from "@rails/actioncable"
-
-const cable = consumer.createConsumer();
-
-export default function subscribe(conversationId, handleReceive) {
-  const subscription = cable.subscriptions.create({ channel: 'PolylinguoChatChannel', conversation_id: conversationId }, {
-    connected() {},
-    disconnected() {},
-    received(data) {
-      handleReceive(data)
-    },
-    sendMessage(text, conversationId) {
-      this.perform('receive', { message: text, conversation_id: conversationId });
-    }
-  });
-
-  return subscription;
-}

data/lib/generators/polylingo_chat/templates/create_polyglot_conversations.rb

@@ -1,9 +0,0 @@
-class CreatePolylingoChatConversations < ActiveRecord::Migration[6.0]
-  def change
-    create_table :conversations do |t|
-      t.string :title
-      t.boolean :private, default: true
-      t.timestamps
-    end
-  end
-end

data/lib/generators/polylingo_chat/templates/create_polyglot_messages.rb

@@ -1,13 +0,0 @@
-class CreatePolylingoChatMessages < ActiveRecord::Migration[6.0]
-  def change
-    create_table :messages do |t|
-      t.references :sender, null: false, foreign_key: { to_table: :users }
-      t.references :conversation, null: false, foreign_key: true
-      t.text :body
-      t.string :language
-      t.text :translated_body
-      t.boolean :translated, default: false
-      t.timestamps
-    end
-  end
-end

data/lib/generators/polylingo_chat/templates/create_polyglot_participants.rb

@@ -1,12 +0,0 @@
-class CreatePolylingoChatParticipants < ActiveRecord::Migration[6.0]
-  def change
-    create_table :participants do |t|
-      t.references :user, null: false, foreign_key: true
-      t.references :conversation, null: false, foreign_key: true
-      t.string :role
-      t.timestamps
-    end
-
-    add_index :participants, [:user_id, :conversation_id], unique: true
-  end
-end

data/lib/generators/polylingo_chat/templates/models/conversation.rb

@@ -1,7 +0,0 @@
-class Conversation < ApplicationRecord
-  has_many :participants, dependent: :destroy
-  has_many :users, through: :participants
-  has_many :messages, dependent: :destroy
-
-  validates :title, length: { maximum: 255 }, allow_blank: true
-end

data/lib/generators/polylingo_chat/templates/models/message.rb

@@ -1,14 +0,0 @@
-class Message < ApplicationRecord
-  belongs_to :conversation
-  belongs_to :sender, class_name: 'User', foreign_key: 'sender_id'
-
-  validates :body, presence: true
-
-  after_create_commit :enqueue_translation_job
-
-  private
-
-  def enqueue_translation_job
-    PolylingoChat::TranslateJob.perform_later(id) if PolylingoChat.config.async
-  end
-end

data/lib/generators/polylingo_chat/templates/models/participant.rb

@@ -1,6 +0,0 @@
-class Participant < ApplicationRecord
-  belongs_to :user
-  belongs_to :conversation
-
-  validates :user_id, uniqueness: { scope: :conversation_id }
-end

data/lib/generators/polylingo_chat/templates/polyglot.rb

@@ -1,53 +0,0 @@
-# PolylingoChat Configuration
-# For more information, see: https://github.com/shoaibmalik786/polylingo_chat
-
-PolylingoChat.configure do |config|
-  # ========================================
-  # AI Provider Configuration (OPTIONAL)
-  # ========================================
-
-  # Translation is OPTIONAL! If you don't set an API key, PolylingoChat works as a
-  # real-time chat engine without translation (messages sent as-is).
-
-  # To enable translation, choose your AI provider: :openai, :anthropic, or :gemini
-  config.provider = :openai
-
-  # Set your API key (leave nil to use chat-only mode without translation)
-  config.api_key = ENV['POLYGLOT_API_KEY']  # or set to nil for chat-only mode
-
-  # Choose your model based on provider:
-  # OpenAI: 'gpt-4o-mini', 'gpt-4o', 'gpt-3.5-turbo'
-  # Anthropic: 'claude-3-5-sonnet-20241022', 'claude-3-5-haiku-20241022', 'claude-3-opus-20240229'
-  # Gemini: 'gemini-1.5-flash', 'gemini-1.5-pro'
-  config.model = 'gpt-4o-mini'
-
-  # ========================================
-  # Background Job Configuration
-  # ========================================
-
-  # Specify which ActiveJob adapter you're using (OPTIONAL, for documentation purposes)
-  # You still need to configure ActiveJob in your Rails app as normal
-  # Options: :sidekiq, :solid_queue, :delayed_job, :async, :inline, etc.
-  #
-  # Example ActiveJob configuration (in config/application.rb or config/environments/*.rb):
-  #   config.active_job.queue_adapter = :sidekiq
-  #
-  # Then tell PolylingoChat which adapter you're using:
-  config.queue_adapter = :sidekiq  # Change this to match your ActiveJob setup
-
-  # Enable/disable async processing
-  config.async = true
-
-  # ========================================
-  # Translation Configuration
-  # ========================================
-
-  # Default language for translations (ISO 639-1 code)
-  config.default_language = 'en'
-
-  # Enable caching for translations (recommended for production)
-  config.cache_store = Rails.cache
-
-  # Request timeout in seconds
-  config.timeout = 15
-end

data/lib/generators/polylingo_chat/templates/polylingo_chat_channel.rb

@@ -1,19 +0,0 @@
-class PolylinguoChatChannel < ApplicationCable::Channel
-  def subscribed
-    # stream for the current user
-    stream_from "polylingo_chat_recipient_#{current_user.id}"
-  end
-
-  def receive(data)
-    # data: { message: 'Hola', conversation_id: 1 }
-    message_text = data['message']
-    conversation = Conversation.find(data['conversation_id'])
-
-    msg = Message.create!(conversation: conversation, sender: current_user, body: message_text, language: current_user.preferred_language)
-    # enqueue translation job
-    PolylingoChat::TranslateJob.perform_async(msg.id)
-
-    # broadcast original to sender's stream if you want
-    ActionCable.server.broadcast("polylingo_chat_recipient_#{current_user.id}", { message: message_text, original: message_text, sender_id: current_user.id, message_id: msg.id, original:true })
-  end
-end