README

Atomic-fast, scalable messaging engine for Laravel.

Built for high-performance applications with native Laravel Reverb support, a modular architecture, and a clean Fluent API.

⚠️ Status: Atomic Chat is currently in Alpha. Expect changes.

✨ Features

🧩 Actors System
Attach any Eloquent model (User, Bot, Company) to conversations.
🔗 Fluent Builder API
Elegant, chainable syntax for creating chats and messages.
🧱 Modular Architecture
Enable only what you need:
- Streams
- Private Chats
- Groups
⚡ Performance First
Optimized indexes and efficient "read receipts" via watermarks.

Install via Composer:

composer require belfil/atomic-chat

Publish config (optional but recommended):

php artisan vendor:publish --tag="atomic-chat-config"

Run migrations:

php artisan migrate

Streams are the simplest chat type — ideal for logs, feeds, or public messaging.

use Belfil\AtomicChat\Stream\Models\Stream;

// Create a stream
$chat = Stream::new()->save();

Using the Chat instance:

$chat->message()
    ->content('Hello Atomic World! ⚛️')
    ->save();

Or via Message Builder:

use Belfil\AtomicChat\Stream\Models\StreamMessage;

StreamMessage::new()
    ->content('Fluent API is awesome')
    ->chat($chat)
    ->save();

Standard Eloquent relationships:

$messages = $chat->messages()
    ->latest()
    ->get();

Atomic Chat is fully modular. Configure modules in:

config/atomic-chat.php

'modules' => [
    'stream' => [
        'enabled' => true,
        'provider' => \Belfil\AtomicChat\Stream\ServiceProvider::class,
    ],
],

PRs, ideas, and feedback are welcome — especially during Alpha.