Autogenerated stubs

Author: danielebarbaro

stubs/action.stub

@@ -0,0 +1,22 @@
+<?php
+
+namespace App\Application\Actions\{{PluralDomainName}};
+
+use App\Application\Actions\BaseAction;
+use App\Domain\{{PluralDomainName}}\{{DomainName}};
+use App\Infrastructure\API\Requests\{{RequestName}};
+use Illuminate\Support\Facades\DB;
+
+class {{ActionName}} extends BaseAction
+{
+    public function execute({{RequestName}} $request): {{DomainName}}
+    {
+        return DB::transaction(function () use ($request) {
+            ${{domainVariable}} = {{DomainName}}::create($request->validated());
+            
+            // Additional business logic here
+            
+            return ${{domainVariable}};
+        });
+    }
+} 

stubs/base-action.stub

@@ -0,0 +1,40 @@
+<?php
+
+namespace App\Application\Actions;
+
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Log;
+
+abstract class BaseAction
+{
+    /**
+     * Execute the action with transaction support.
+     */
+    protected function executeInTransaction(callable $callback)
+    {
+        return DB::transaction($callback);
+    }
+
+    /**
+     * Log action execution.
+     */
+    protected function log(string $message, array $context = []): void
+    {
+        Log::info($message, array_merge([
+            'action' => static::class,
+        ], $context));
+    }
+
+    /**
+     * Log error during action execution.
+     */
+    protected function logError(string $message, \Throwable $exception, array $context = []): void
+    {
+        Log::error($message, array_merge([
+            'action' => static::class,
+            'exception' => $exception->getMessage(),
+            'file' => $exception->getFile(),
+            'line' => $exception->getLine(),
+        ], $context));
+    }
+} 

stubs/base-controller.stub

@@ -0,0 +1,57 @@
+<?php
+
+namespace App\Infrastructure\API\Controllers;
+
+use Illuminate\Foundation\Auth\Access\AuthorizesRequests;
+use Illuminate\Foundation\Validation\ValidatesRequests;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Routing\Controller as BaseController;
+
+class Controller extends BaseController
+{
+    use AuthorizesRequests, ValidatesRequests;
+
+    /**
+     * Return a success JSON response.
+     */
+    protected function successResponse(mixed $data = null, string $message = 'Success', int $status = 200): JsonResponse
+    {
+        return response()->json([
+            'success' => true,
+            'data' => $data,
+            'message' => $message
+        ], $status);
+    }
+
+    /**
+     * Return an error JSON response.
+     */
+    protected function errorResponse(string $message = 'Error', int $status = 400, mixed $errors = null): JsonResponse
+    {
+        return response()->json([
+            'success' => false,
+            'message' => $message,
+            'errors' => $errors
+        ], $status);
+    }
+
+    /**
+     * Return a paginated JSON response.
+     */
+    protected function paginatedResponse($data, string $message = 'Success'): JsonResponse
+    {
+        return response()->json([
+            'success' => true,
+            'data' => $data->items(),
+            'pagination' => [
+                'current_page' => $data->currentPage(),
+                'last_page' => $data->lastPage(),
+                'per_page' => $data->perPage(),
+                'total' => $data->total(),
+                'from' => $data->firstItem(),
+                'to' => $data->lastItem(),
+            ],
+            'message' => $message
+        ]);
+    }
+} 

stubs/base-model.stub

@@ -0,0 +1,49 @@
+<?php
+
+namespace App\Domain\Shared;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\SoftDeletes;
+
+abstract class BaseModel extends Model
+{
+    use HasFactory, SoftDeletes;
+
+    /**
+     * Indicates if the model should be timestamped.
+     */
+    public $timestamps = true;
+
+    /**
+     * The attributes that should be cast.
+     */
+    protected $casts = [
+        'created_at' => 'datetime',
+        'updated_at' => 'datetime',
+        'deleted_at' => 'datetime',
+    ];
+
+    /**
+     * The attributes that aren't mass assignable.
+     */
+    protected $guarded = ['id'];
+
+    /**
+     * Get the route key for the model.
+     */
+    public function getRouteKeyName(): string
+    {
+        return 'id';
+    }
+
+    /**
+     * Boot the model.
+     */
+    protected static function boot(): void
+    {
+        parent::boot();
+
+        // Add global scopes or model events here
+    }
+} 

stubs/base-request.stub

@@ -0,0 +1,37 @@
+<?php
+
+namespace App\Infrastructure\API\Requests;
+
+use Illuminate\Foundation\Http\FormRequest;
+use Illuminate\Contracts\Validation\Validator;
+use Illuminate\Http\Exceptions\HttpResponseException;
+
+abstract class BaseRequest extends FormRequest
+{
+    /**
+     * Handle a failed validation attempt.
+     */
+    protected function failedValidation(Validator $validator): void
+    {
+        throw new HttpResponseException(
+            response()->json([
+                'success' => false,
+                'message' => 'Validation errors occurred',
+                'errors' => $validator->errors()
+            ], 422)
+        );
+    }
+
+    /**
+     * Get the validation rules that apply to the request.
+     */
+    abstract public function rules(): array;
+
+    /**
+     * Prepare the data for validation.
+     */
+    protected function prepareForValidation(): void
+    {
+        // Override this method to modify data before validation
+    }
+} 

stubs/base-service.stub

@@ -0,0 +1,53 @@
+<?php
+
+namespace App\Application\Services;
+
+use Illuminate\Support\Facades\Cache;
+use Illuminate\Support\Facades\Log;
+
+abstract class BaseService
+{
+    /**
+     * Default cache TTL in seconds (1 hour).
+     */
+    protected int $cacheTtl = 3600;
+
+    /**
+     * Cache a result with the given key.
+     */
+    protected function cache(string $key, callable $callback, ?int $ttl = null)
+    {
+        return Cache::remember($key, $ttl ?? $this->cacheTtl, $callback);
+    }
+
+    /**
+     * Forget cached result by key.
+     */
+    protected function forgetCache(string $key): bool
+    {
+        return Cache::forget($key);
+    }
+
+    /**
+     * Log service operation.
+     */
+    protected function log(string $message, array $context = []): void
+    {
+        Log::info($message, array_merge([
+            'service' => static::class,
+        ], $context));
+    }
+
+    /**
+     * Log error during service operation.
+     */
+    protected function logError(string $message, \Throwable $exception, array $context = []): void
+    {
+        Log::error($message, array_merge([
+            'service' => static::class,
+            'exception' => $exception->getMessage(),
+            'file' => $exception->getFile(),
+            'line' => $exception->getLine(),
+        ], $context));
+    }
+} 

stubs/business-logic-exception.stub

@@ -0,0 +1,25 @@
+<?php
+
+namespace App\Infrastructure\Exceptions;
+
+use Exception;
+
+class BusinessLogicException extends Exception
+{
+    public function __construct(string $message = "Business logic violation", int $code = 409, ?\Throwable $previous = null)
+    {
+        parent::__construct($message, $code, $previous);
+    }
+
+    /**
+     * Render the exception into an HTTP response.
+     */
+    public function render($request)
+    {
+        return response()->json([
+            'success' => false,
+            'message' => $this->getMessage(),
+            'error_type' => 'business_logic_exception'
+        ], $this->getCode());
+    }
+} 

stubs/config.stub

@@ -0,0 +1,44 @@
+<?php
+
+return [
+    /*
+    |--------------------------------------------------------------------------
+    | Clean Architecture Configuration
+    |--------------------------------------------------------------------------
+    |
+    | This file contains configuration options for the Laravel Clean
+    | Architecture package.
+    |
+    */
+
+    'default_namespace' => 'App',
+
+    'directories' => [
+        'domain' => 'app/Domain',
+        'application' => 'app/Application',
+        'infrastructure' => 'app/Infrastructure',
+    ],
+
+    'stubs' => [
+        'path' => base_path('stubs/clean-architecture'),
+    ],
+
+    'auto_discovery' => [
+        'enabled' => true,
+        'paths' => [
+            'app/Application/Actions',
+            'app/Application/Services',
+            'app/Domain',
+        ],
+    ],
+
+    'validation' => [
+        'strict_mode' => false,
+        'custom_messages' => true,
+    ],
+
+    'logging' => [
+        'enabled' => true,
+        'channel' => 'daily',
+    ],
+];