deploy

.env.example

@@ -45,5 +45,12 @@ PUSHER_APP_KEY=
 PUSHER_APP_SECRET=
 PUSHER_APP_CLUSTER=mt1
 
+VITE_APP_URL=
+
+VITE_PUSHER_APP_CLUSTER=mt1
+VITE_PUSHER_APP_KEY=
+
 MIX_PUSHER_APP_KEY="${PUSHER_APP_KEY}"
 MIX_PUSHER_APP_CLUSTER="${PUSHER_APP_CLUSTER}"
+
+OCTANE_SERVER=frankenphp

.eslintrc.json

@@ -0,0 +1,35 @@
+{
+  "parser": "@babel/eslint-parser",
+  "root": true,
+  "extends": ["react-app", "prettier"],
+  "env": {
+    "node": true,
+    "browser": true
+  },
+  "parserOptions": {
+    "ecmaVersion": 2020,
+    "requireConfigFile": false,
+    "ecmaFeatures": {
+      "legacyDecorators": true,
+      "jsx": true
+    }
+  },
+  "settings": {
+    "react": {
+      "version": "17"
+    }
+  },
+  "globals": { "Echo": true, "Pusher": true, "route": true },
+  "rules": {
+    "no-eval": 0,
+    "react-hooks/exhaustive-deps": 0,
+    "array-callback-return": 0,
+    "no-extend-native": 0,
+    "no-shadow": 0,
+    "camelcase": 0,
+    "import/no-cycle": "error",
+    "react/jsx-uses-react": 0,
+    "react/react-in-jsx-scope": 0,
+    "jest/no-commented-out-tests": 0
+  }
+}

.gitattributes

@@ -1,4 +1,4 @@
-* text=auto
+* text=auto eol=lf
 *.css linguist-vendored
 *.scss linguist-vendored
 *.js linguist-vendored

.gitignore

@@ -1,3 +1,4 @@
+/.phpunit.cache
 /node_modules
 /public/hot
 /public/storage
@@ -14,3 +15,6 @@ npm-debug.log
 yarn-error.log
 rr
 .rr.yaml
+.yarn/cache
+public/resources/js/assets
+frankenphp

.gitmodules

@@ -1,3 +1,3 @@
 [submodule "laravel-chat-system"]
 	path = packages/laravel-chat-system
-	url = https://github.com/myckhel/laravel-chat-system.git
+	url = https://github.com/binkode/laravel-chat-system.git

.yarnrc.yml

@@ -0,0 +1,7 @@
+compressionLevel: mixed
+
+enableGlobalCache: false
+
+nodeLinker: node-modules
+
+yarnPath: .yarn/releases/yarn-4.6.0.cjs

AGENTS.md

@@ -0,0 +1,57 @@
+# AGENTS.md
+
+## Purpose
+This is a Laravel testing application for the `binkode/laravel-chat-system` package. Use these rules to keep changes focused on exercising the package without turning this app into a production template.
+
+## Project Facts (Source of Truth)
+- App type: Laravel application used as a test harness
+- Primary dependency under test: `binkode/laravel-chat-system`
+- Frontend stack: Inertia + React + Vite
+- PHP version target: as defined by the app `composer.json`
+- Test framework: PHPUnit (via `composer test` or `php artisan test`)
+
+## Non-Negotiable Rules
+- Keep changes minimal and test-focused; do not refactor unrelated app code.
+- Do not change package public APIs in `packages/` from this app unless explicitly asked.
+- Avoid breaking changes to routes, auth, or Inertia setup used by tests/demos.
+- No new dependencies unless required by the task and approved.
+- Update docs when app usage or setup changes.
+
+## Safe Change Boundaries
+- Prefer changes in:
+  - `resources/` (views, JS, CSS)
+  - `routes/` (web and API routes)
+  - `tests/`
+  - `config/` (only when required to exercise package features)
+- Avoid touching `vendor/` and lockfiles unless explicitly requested.
+
+## Testing Rules
+- Favor Laravel HTTP fakes for external calls.
+- Add or update tests when behavior changes.
+- Preferred test command: `php artisan test`.
+- If tests cannot run, report why and what would be needed.
+
+## Coding Conventions
+- Match existing Laravel and project style (PSR-12 for PHP, standard React/Vite conventions).
+- Keep controllers thin; push logic into app services only when necessary for test clarity.
+- For frontend, keep components small and focused on demoing package features.
+
+## Definition of Done
+- App still boots and renders the chat system UI.
+- Tests pass or a clear blocker is documented.
+- Docs updated if setup or usage changed.
+
+## High-Signal Prompt Template
+```md
+Task: <one clear outcome>
+Context: <feature/bug + why it matters>
+Scope: <files allowed to change>
+Constraints: <no new deps, keep app as test harness, etc.>
+Acceptance Criteria:
+- <observable behavior 1>
+- <observable behavior 2>
+Tests:
+- <exact command, usually `php artisan test`>
+Deliverable:
+- <changed files + rationale + any risks>
+```

Procfile

@@ -1 +1,2 @@
-web: vendor/bin/heroku-php-apache2 public/
+web: php artisan octane:start --server=swoole --host=0.0.0.0 --port=$PORT
+worker: php artisan queue:work redis --queue=chat,chat-event --sleep=3 --tries=3 --daemon

app/Exceptions/Handler.php

@@ -7,35 +7,26 @@
 
 class Handler extends ExceptionHandler
 {
-    /**
-     * A list of the exception types that are not reported.
-     *
-     * @var array
-     */
-    protected $dontReport = [
-        //
-    ];
+  /**
+   * A list of the inputs that are never flashed for validation exceptions.
+   *
+   * @var array
+   */
+  protected $dontFlash = [
+    'current_password',
+    'password',
+    'password_confirmation',
+  ];
 
-    /**
-     * A list of the inputs that are never flashed for validation exceptions.
-     *
-     * @var array
-     */
-    protected $dontFlash = [
-        'current_password',
-        'password',
-        'password_confirmation',
-    ];
-
-    /**
-     * Register the exception handling callbacks for the application.
-     *
-     * @return void
-     */
-    public function register()
-    {
-        $this->reportable(function (Throwable $e) {
-            //
-        });
-    }
+  /**
+   * Register the exception handling callbacks for the application.
+   *
+   * @return void
+   */
+  public function register()
+  {
+    $this->reportable(function (Throwable $e) {
+      //
+    });
+  }
 }

app/Http/Kernel.php

@@ -7,63 +7,63 @@
 
 class Kernel extends HttpKernel
 {
-    /**
-     * The application's global HTTP middleware stack.
-     *
-     * These middleware are run during every request to your application.
-     *
-     * @var array
-     */
-    protected $middleware = [
-        // \App\Http\Middleware\TrustHosts::class,
-        \App\Http\Middleware\TrustProxies::class,
-        \Fruitcake\Cors\HandleCors::class,
-        \App\Http\Middleware\PreventRequestsDuringMaintenance::class,
-        \Illuminate\Foundation\Http\Middleware\ValidatePostSize::class,
-        \App\Http\Middleware\TrimStrings::class,
-        \Illuminate\Foundation\Http\Middleware\ConvertEmptyStringsToNull::class,
-    ];
+  /**
+   * The application's global HTTP middleware stack.
+   *
+   * These middleware are run during every request to your application.
+   *
+   * @var array
+   */
+  protected $middleware = [
+    // \App\Http\Middleware\TrustHosts::class,
+    \App\Http\Middleware\TrustProxies::class,
+    \App\Http\Middleware\PreventRequestsDuringMaintenance::class,
+    \Illuminate\Foundation\Http\Middleware\ValidatePostSize::class,
+    \App\Http\Middleware\TrimStrings::class,
+    \Illuminate\Foundation\Http\Middleware\ConvertEmptyStringsToNull::class,
+  ];
 
-    /**
-     * The application's route middleware groups.
-     *
-     * @var array
-     */
-    protected $middlewareGroups = [
-        'web' => [
-            \App\Http\Middleware\EncryptCookies::class,
-            \Illuminate\Cookie\Middleware\AddQueuedCookiesToResponse::class,
-            \Illuminate\Session\Middleware\StartSession::class,
-            // \Illuminate\Session\Middleware\AuthenticateSession::class,
-            \Illuminate\View\Middleware\ShareErrorsFromSession::class,
-            \App\Http\Middleware\VerifyCsrfToken::class,
-            \Illuminate\Routing\Middleware\SubstituteBindings::class,
-            \App\Http\Middleware\HandleInertiaRequests::class,
-        ],
+  /**
+   * The application's route middleware groups.
+   *
+   * @var array
+   */
+  protected $middlewareGroups = [
+    'web' => [
+      \App\Http\Middleware\EncryptCookies::class,
+      \Illuminate\Cookie\Middleware\AddQueuedCookiesToResponse::class,
+      \Illuminate\Session\Middleware\StartSession::class,
+      // \Illuminate\Session\Middleware\AuthenticateSession::class,
+      \Illuminate\View\Middleware\ShareErrorsFromSession::class,
+      \App\Http\Middleware\VerifyCsrfToken::class,
+      \Illuminate\Routing\Middleware\SubstituteBindings::class,
+      \App\Http\Middleware\HandleInertiaRequests::class,
+    ],
 
-        'api' => [
-          EnsureFrontendRequestsAreStateful::class,
-            'throttle:api',
-            \Illuminate\Routing\Middleware\SubstituteBindings::class,
-        ],
-    ];
+    'api' => [
+      EnsureFrontendRequestsAreStateful::class,
+      \Illuminate\Routing\Middleware\ThrottleRequests::class . ':api',
+      \Illuminate\Routing\Middleware\SubstituteBindings::class,
+    ],
+  ];
 
-    /**
-     * The application's route middleware.
-     *
-     * These middleware may be assigned to groups or used individually.
-     *
-     * @var array
-     */
-    protected $routeMiddleware = [
-        'auth' => \App\Http\Middleware\Authenticate::class,
-        'auth.basic' => \Illuminate\Auth\Middleware\AuthenticateWithBasicAuth::class,
-        'cache.headers' => \Illuminate\Http\Middleware\SetCacheHeaders::class,
-        'can' => \Illuminate\Auth\Middleware\Authorize::class,
-        'guest' => \App\Http\Middleware\RedirectIfAuthenticated::class,
-        'password.confirm' => \Illuminate\Auth\Middleware\RequirePassword::class,
-        'signed' => \Illuminate\Routing\Middleware\ValidateSignature::class,
-        'throttle' => \Illuminate\Routing\Middleware\ThrottleRequests::class,
-        'verified' => \Illuminate\Auth\Middleware\EnsureEmailIsVerified::class,
-    ];
+  /**
+   * The application's route middleware.
+   *
+   * These middleware may be assigned to groups or used individually.
+   *
+   * @var array
+   */
+  protected $middlewareAliases = [
+    'auth' => \App\Http\Middleware\Authenticate::class,
+    'auth.basic' => \Illuminate\Auth\Middleware\AuthenticateWithBasicAuth::class,
+    'cache.headers' => \Illuminate\Http\Middleware\SetCacheHeaders::class,
+    'can' => \Illuminate\Auth\Middleware\Authorize::class,
+    'guest' => \App\Http\Middleware\RedirectIfAuthenticated::class,
+    'password.confirm' => \Illuminate\Auth\Middleware\RequirePassword::class,
+    'precognitive' => \Illuminate\Foundation\Http\Middleware\HandlePrecognitiveRequests::class,
+    'signed' => \Illuminate\Routing\Middleware\ValidateSignature::class,
+    'throttle' => \Illuminate\Routing\Middleware\ThrottleRequests::class,
+    'verified' => \Illuminate\Auth\Middleware\EnsureEmailIsVerified::class,
+  ];
 }