yauhenko/rest-bundle

REST and TypeScript generator for Symfony 8

1.0.0 2026-07-16 11:26 UTC

Requires

• php: ^8.5
• doctrine/collections: ^2.2
• doctrine/orm: ^3.3
• symfony/config: ^8.1
• symfony/dependency-injection: ^8.1
• symfony/event-dispatcher: ^8.1
• symfony/framework-bundle: ^8.1
• symfony/http-foundation: ^8.1
• symfony/http-kernel: ^8.1
• symfony/routing: ^8.1
• symfony/security-core: ^8.1
• symfony/serializer: ^8.1
• symfony/translation-contracts: ^3.5
• symfony/validator: ^8.1

MIT

Published on Packagist.org on 2026-07-16 11:29 UTC

README

Step 1: Run

composer req yauhenko/rest-bundle

Step 2: Add to config/routes/annotations.yaml two lines:

rest_bundle:
    resource: '@RestBundle/config/routes.yaml'

It will register /docs routes

Step 3: Create Types class in src/Types.php:

<?php

namespace App;

use Yauhenko\RestBundle\TypesInterface;
use Yauhenko\RestBundle\Service\TypeScript;

class Types implements TypesInterface {

    public static function registerTypes(TypeScript $ts): void {
        // register custom types here (optional)
        $ts->registerTypeOf('TBadge', ['notifications', 'shop']);
        
        // register interfaces
        $ts->registerInterfacesFromDir(__DIR__ . '/Entity');
        $ts->registerInterfacesFromDir(__DIR__ . '/Models');
    }
    
    public static function codePostProcessor(string $code): string {
        // change generated TypeScript code here (optional)	
        return $code;
    }

}

You can change path to Types class using yauhenko.rest.types_class parameter in config/services.yaml

Step 4 (optional): Configure config/services.yaml:

parameters:
    # Enable TypeScript generation (default: true)
    yauhenko.rest.ts_enabled: '%env(bool:API_TS_ENABLED)%'
    
    # Types class (default) 
    yauhenko.rest.types_class: 'App\Types'
    
    # Path to controllers (default) 
    yauhenko.rest.controllers_dir: '%kernel.project_dir%/src/Controller'