wip

Author: lam0819

.gitignore

@@ -30,3 +30,5 @@ phpstan.neon
 testbench.yaml
 # /docs
 /coverage
+
+/packages/**

composer.json

@@ -22,7 +22,7 @@
         }
     ],
     "require": {
-        "php": "^8.1",
+        "php": "^8.3",
         "solution-forest/workflow-engine-core": "*",
         "spatie/laravel-package-tools": "^1.16",
         "illuminate/contracts": "^10.0||^11.0||^12.0",
@@ -49,7 +49,10 @@
     "autoload": {
         "psr-4": {
             "SolutionForest\\WorkflowEngine\\Laravel\\": "src/"
-        }
+        },
+        "files": [
+            "src/helpers.php"
+        ]
     },
     "autoload-dev": {
         "psr-4": {

src/Adapters/LaravelEventDispatcher.php

@@ -0,0 +1,26 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SolutionForest\WorkflowEngine\Laravel\Adapters;
+
+use Illuminate\Contracts\Events\Dispatcher;
+use SolutionForest\WorkflowEngine\Contracts\EventDispatcher;
+
+/**
+ * Laravel adapter for the workflow engine event dispatcher.
+ * 
+ * This adapter bridges Laravel's event system with the framework-agnostic
+ * event dispatcher interface used by the workflow engine core.
+ */
+class LaravelEventDispatcher implements EventDispatcher
+{
+    public function __construct(
+        private readonly Dispatcher $dispatcher
+    ) {}
+
+    public function dispatch(object $event): void
+    {
+        $this->dispatcher->dispatch($event);
+    }
+}

src/Adapters/LaravelLogger.php

@@ -0,0 +1,41 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SolutionForest\WorkflowEngine\Laravel\Adapters;
+
+use Illuminate\Log\LogManager;
+use SolutionForest\WorkflowEngine\Contracts\Logger;
+
+/**
+ * Laravel adapter for the workflow engine logger.
+ * 
+ * This adapter bridges Laravel's logging system with the framework-agnostic
+ * logger interface used by the workflow engine core.
+ */
+class LaravelLogger implements Logger
+{
+    public function __construct(
+        private readonly LogManager $logger
+    ) {}
+
+    public function info(string $message, array $context = []): void
+    {
+        $this->logger->info($message, $context);
+    }
+
+    public function error(string $message, array $context = []): void
+    {
+        $this->logger->error($message, $context);
+    }
+
+    public function debug(string $message, array $context = []): void
+    {
+        $this->logger->debug($message, $context);
+    }
+
+    public function warning(string $message, array $context = []): void
+    {
+        $this->logger->warning($message, $context);
+    }
+}

src/Models/WorkflowInstance.php

@@ -3,7 +3,6 @@
 namespace SolutionForest\WorkflowEngine\Laravel\Models;
 
 use Illuminate\Database\Eloquent\Model;
-use Illuminate\Database\Eloquent\Casts\Attribute;
 use SolutionForest\WorkflowEngine\Core\WorkflowDefinition;
 use SolutionForest\WorkflowEngine\Core\WorkflowInstance as CoreWorkflowInstance;
 use SolutionForest\WorkflowEngine\Core\WorkflowState;

src/Providers/WorkflowEngineServiceProvider.php

@@ -2,11 +2,10 @@
 
 namespace SolutionForest\WorkflowEngine\Laravel\Providers;
 
-use Illuminate\Contracts\Events\Dispatcher as EventDispatcher;
 use Illuminate\Database\DatabaseManager;
-use SolutionForest\WorkflowEngine\Laravel\Commands\LaravelWorkflowEngineCommand;
 use SolutionForest\WorkflowEngine\Contracts\StorageAdapter;
 use SolutionForest\WorkflowEngine\Core\WorkflowEngine;
+use SolutionForest\WorkflowEngine\Laravel\Commands\LaravelWorkflowEngineCommand;
 use SolutionForest\WorkflowEngine\Laravel\Storage\DatabaseStorage;
 use Spatie\LaravelPackageTools\Package;
 use Spatie\LaravelPackageTools\PackageServiceProvider;
@@ -45,11 +44,25 @@ public function register(): void
             };
         });
 
+        // Register event dispatcher adapter
+        $this->app->singleton(\SolutionForest\WorkflowEngine\Contracts\EventDispatcher::class, function ($app) {
+            return new \SolutionForest\WorkflowEngine\Laravel\Adapters\LaravelEventDispatcher(
+                $app->make(\Illuminate\Contracts\Events\Dispatcher::class)
+            );
+        });
+
+        // Register logger adapter
+        $this->app->singleton(\SolutionForest\WorkflowEngine\Contracts\Logger::class, function ($app) {
+            return new \SolutionForest\WorkflowEngine\Laravel\Adapters\LaravelLogger(
+                $app->make(\Illuminate\Log\LogManager::class)
+            );
+        });
+
         // Register workflow engine
         $this->app->singleton(WorkflowEngine::class, function ($app): WorkflowEngine {
             return new WorkflowEngine(
                 $app->make(StorageAdapter::class),
-                $app->make(EventDispatcher::class)
+                $app->make(\SolutionForest\WorkflowEngine\Contracts\EventDispatcher::class)
             );
         });
 

src/helpers.php

@@ -0,0 +1,56 @@
+<?php
+
+declare(strict_types=1);
+
+use SolutionForest\WorkflowEngine\Core\WorkflowEngine;
+use SolutionForest\WorkflowEngine\Core\WorkflowInstance;
+
+if (! function_exists('workflow')) {
+    /**
+     * Get the workflow engine instance from the Laravel container.
+     */
+    function workflow(): WorkflowEngine
+    {
+        return app(WorkflowEngine::class);
+    }
+}
+
+if (! function_exists('start_workflow')) {
+    /**
+     * Start a new workflow.
+     */
+    function start_workflow(string $id, array $definition, array $context = []): string
+    {
+        return workflow()->start($id, $definition, $context);
+    }
+}
+
+if (! function_exists('get_workflow')) {
+    /**
+     * Get a workflow instance by ID.
+     */
+    function get_workflow(string $id): WorkflowInstance
+    {
+        return workflow()->getInstance($id);
+    }
+}
+
+if (! function_exists('cancel_workflow')) {
+    /**
+     * Cancel a workflow.
+     */
+    function cancel_workflow(string $id, string $reason = 'Cancelled'): void
+    {
+        workflow()->cancel($id, $reason);
+    }
+}
+
+if (! function_exists('list_workflows')) {
+    /**
+     * List workflows.
+     */
+    function list_workflows(array $filters = []): array
+    {
+        return workflow()->listWorkflows($filters);
+    }
+}