Refactor: Refactor structure and naming of a package and also created some abstractions for future extension possibilities

# Conflicts:
#	src/MailTransportFactory.php
#	src/MailboxForLaravelServiceProvider.php

Author: nikajorjika

composer.json

@@ -63,10 +63,10 @@
     "extra": {
         "laravel": {
             "providers": [
-                "Redberry\\MailboxForLaravel\\MailboxForLaravelServiceProvider"
+              "InboxServiceProvider"
             ],
             "aliases": {
-                "MailboxForLaravel": "Redberry\\MailboxForLaravel\\Facades\\MailboxForLaravel"
+                "MailboxForLaravel": "Inbox"
             }
         }
     },

config/inbox.php

@@ -0,0 +1,12 @@
+<?php
+return [
+    'store' => [
+        'driver' => env('INBOX_STORE_DRIVER', 'file'),
+        'file' => [
+            'path' => env('INBOX_FILE_PATH', storage_path('app/inbox')),
+        ],
+    ],
+    'retention' => [
+        'seconds' => (int) env('INBOX_RETENTION', 60 * 60 * 24),
+    ],
+];

config/mailbox-for-laravel.php

@@ -0,0 +1,27 @@
+<?php
+
+namespace Redberry\MailboxForLaravel;
+
+use Redberry\MailboxForLaravel\Contracts\MessageStore;
+
+class CaptureService
+{
+    public function __construct(protected MessageStore $storage)
+    {
+    }
+
+    /**
+     * Persist the raw message and metadata.
+     */
+    public function storeRaw(string $raw): string
+    {
+        $key = 'email_' . md5($raw) . '_' . microtime(true);
+
+        $this->storage->store($key, [
+            'timestamp' => time(),
+            'raw'       => $raw,
+        ]);
+
+        return $key;
+    }
+}

src/CaptureService.php

@@ -0,0 +1,48 @@
+<?php
+
+namespace Redberry\MailboxForLaravel\Contracts;
+
+interface MessageStore
+{
+    /**
+     * Persist an email payload.
+     *
+     * @param  string  $key  Unique key (you generate it).
+     * @param  array  $value  Associative array payload; MUST include at least: ['raw' => string, 'timestamp' => int]
+     *
+     * @return void
+     */
+    public function store(string $key, array $value): void;
+
+    /**
+     * Retrieve a single payload by key.
+     *
+     * @param  string  $key  Unique key to retrieve the payload.
+     *
+     * @return array|null Returns the payload array or null if not found.
+     */
+    public function retrieve(string $key): ?array;
+
+    /**
+     * Retrieve multiple payload keys optionally filtered by a UNIX timestamp (>= since).
+     *
+     * @param  int|null  $since
+     *
+     * @return iterable<string> Keys
+     */
+    public function keys(?int $since = null): iterable;
+
+    /**
+     * Delete a payload by key.
+     *
+     * @param  string  $key  Unique key to delete the payload.
+     */
+    public function delete(string $key): void;
+
+    /**
+     * Remove payloads older than $seconds (relative to now).
+     *
+     * @param  int  $seconds  Number of seconds to keep; older payloads will be purged.
+     */
+    public function purgeOlderThan(int $seconds): void;
+}

src/Contracts/MessageStore.php

@@ -7,10 +7,10 @@
 /**
  * @see \Redberry\MailboxForLaravel\MailboxForLaravel
  */
-class MailboxForLaravel extends Facade
+class Inbox extends Facade
 {
     protected static function getFacadeAccessor(): string
     {
-        return \Redberry\MailboxForLaravel\MailboxForLaravel::class;
+        return \Redberry\MailboxForLaravel\InboxTranport::class;
     }
 }

src/Facades/MailboxForLaravel.php renamed to src/Facades/Inbox.php

@@ -0,0 +1,40 @@
+<?php
+
+namespace Redberry\MailboxForLaravel;
+
+use Illuminate\Mail\MailManager;
+use Redberry\MailboxForLaravel\Contracts\MessageStore;
+use Redberry\MailboxForLaravel\Transport\InboxTransport;
+use Spatie\LaravelPackageTools\Package;
+use Spatie\LaravelPackageTools\PackageServiceProvider;
+
+class InboxServiceProvider extends PackageServiceProvider
+{
+    public function configurePackage(Package $package): void
+    {
+        $package
+            ->name('mailbox-for-laravel')
+            ->hasConfigFile('inbox');
+        // keep room for: ->hasViews(), ->hasRoute() later for dashboard
+    }
+
+    public function registeringPackage(): void
+    {
+        $this->app->singleton(MessageStore::class, function () {
+            return (new StoreManager())->create();
+        });
+        $this->app->singleton(CaptureService::class, function () {
+            return new CaptureService(app(MessageStore::class));
+        });
+
+        $this->app->singleton(InboxTransport::class, fn() => new InboxTransport(app(CaptureService::class)));
+
+        // Register the mail driver
+        $this->app->afterResolving(MailManager::class, function (MailManager $manager) {
+            $manager->extend('inbox', function ($config) {
+                // Return a Symfony TransportInterface
+                return app(InboxTransport::class);
+            });
+        });
+    }
+}