README

Yolxander Laravel Make Extensions is a Composer package that adds custom php artisan make:* commands for scaffolding additional file types commonly used in modern Laravel applications. It provides generators for Transformers, API Clients, Integration/API Tests, Domain Events, Value Objects, Services, and Actions, making it easier to maintain a clean project structure.

Features

Transformers (make:transformer): Converts your Eloquent models or domain data into consistent JSON response formats.
API Clients (make:api-client): Scaffolds classes to handle third-party HTTP calls.
Integration Tests (make:integration-test): Quickly create tests for multi-system flows (e.g., DB + external API).
API Tests (make:api-test): Generate test boilerplate to verify your application’s API endpoints.
Domain Events (make:domain-event): Event classes for Domain-Driven Design or event sourcing.
Value Objects (make:value-object): Immutable classes that encapsulate domain logic (e.g., Money, Email).
Services (make:service): Encapsulates business logic or external operations.
Actions (make:action): Single-use-case classes to make your application logic more modular.

Requirements

PHP >= 8.0 (or higher)
Laravel 8, 9, 10, 11, or 12 (depending on your version constraints)
illuminate/support and illuminate/console matching the above Laravel versions

Installation

Install via Composer:

composer require yolxander/laravel-make-extensions

Or specify a version constraint if needed:

composer require yolxander/laravel-make-extensions:^1.3

Publish stubs (optional):
```
php artisan vendor:publish --tag=make-extensions-stubs
```
This will copy the stub files into your project so you can customize them locally (e.g., stubs/make-extensions/transformer.stub).

Usage

Once installed, you should see the following new Artisan commands:

Make Transformer
```
php artisan make:transformer UserTransformer
```
Creates a UserTransformer in app/Transformers (or your default namespace).
Make API Client
```
php artisan make:api-client SomeServiceClient
```
Generates an API Client class in app/ApiClients.
Make Integration Test
```
php artisan make:integration-test PaymentIntegrationTest
```
Creates a test in tests/Integration for combined system flows.
Make API Test
```
php artisan make:api-test UserApiTest
```
Generates a test class in tests/Api (or similar) for endpoint testing.
Make Domain Event
```
php artisan make:domain-event OrderShippedEvent
```
Scaffolds a domain event in app/Domain/Events.
Make Value Object
```
php artisan make:value-object Money
```
Creates an immutable class in app/Domain/ValueObjects.
Make Service
```
php artisan make:service PaymentService
```
Spawns a service class in app/Services.
Make Action
```
php artisan make:action CreateOrderAction
```
Adds an action class in app/Actions.

Tip: Each command automatically references a matching stub file. If you’ve published stubs, you can edit them to fit your exact coding style.

Configuration

Service Provider: This package includes a service provider (MakeExtensionsServiceProvider) that’s auto-discovered by Laravel (thanks to the "extra" block in the package’s composer.json). No manual registration is needed unless you’re not relying on auto-discovery.
Stubs Path: By default, each command references its stub file at src/stubs/. If you publish stubs, you can modify your command classes to point to the published location or leave the defaults as-is.

Contributing

Fork the repo & clone it locally.
Create a new branch for your feature or bug fix: git checkout -b feature/awesome-new-command.
Commit your changes: git commit -m "Add a new make:awesome command".
Push to GitHub: git push origin feature/awesome-new-command.
Open a Pull Request on GitHub and describe the proposed changes.

License

This package is open-sourced software licensed under the MIT license. (Or use “proprietary” or another license, depending on your composer.json configuration.)

About Yolxander Laravel Make Extensions

Yolxander designed this package to simplify the scaffolding of additional file types beyond default Laravel commands. With these commands, you can keep your code organized by generating stubs for domain events, value objects, or specialized tests—particularly helpful on teams practicing Domain-Driven Design, advanced testing, or large-scale API development.

For questions, ideas, or support, feel free to open an issue or submit a pull request. Thank you for using Yolxander Laravel Make Extensions!

yolxander / laravel-make-extensions

Maintainers

Details