@omnifyjp/ts 2.1.11 → 3.0.0

package/dist/php/controller-generator.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Generates base + editable controller classes for schemas with `options.api`.
+ */
+import { SchemaReader } from './schema-reader.js';
+import type { GeneratedFile, PhpConfig } from './types.js';
+/** Generate controller classes for all schemas with api config. */
+export declare function generateControllers(reader: SchemaReader, config: PhpConfig): GeneratedFile[];

package/dist/php/controller-generator.js

@@ -0,0 +1,178 @@
+/**
+ * Generates base + editable controller classes for schemas with `options.api`.
+ */
+import { toPascalCase } from './naming-helper.js';
+import { baseFile, userFile } from './types.js';
+const DEFAULT_ACTIONS = ['index', 'store', 'show', 'update', 'destroy'];
+/** Generate controller classes for all schemas with api config. */
+export function generateControllers(reader, config) {
+    const files = [];
+    for (const [name, schema] of Object.entries(reader.getSchemasWithApi())) {
+        files.push(...generateForSchema(name, schema, reader, config));
+    }
+    return files;
+}
+function generateForSchema(name, schema, reader, config) {
+    return [
+        generateBaseController(name, schema, reader, config),
+        generateUserController(name, schema, config),
+    ];
+}
+function generateBaseController(name, schema, reader, config) {
+    const modelName = toPascalCase(name);
+    const api = schema.options?.api ?? {};
+    const actions = [...(api.actions ?? DEFAULT_ACTIONS)];
+    const lookup = api.lookup ?? true;
+    const bulkDelete = api.bulkDelete ?? false;
+    const restore = api.restore ?? (schema.options?.softDelete ?? false);
+    const baseNs = config.controllers.baseNamespace;
+    const modelNs = config.models.namespace;
+    const serviceBaseNs = config.services.baseNamespace;
+    const requestNs = config.requests.namespace;
+    const resourceNs = config.resources.namespace;
+    // Build imports
+    const imports = [
+        `use App\\Http\\Controllers\\Controller;`,
+        `use ${serviceBaseNs}\\${modelName}ServiceBase;`,
+    ];
+    if (actions.includes('store')) {
+        imports.push(`use ${requestNs}\\${modelName}StoreRequest;`);
+    }
+    if (actions.includes('update')) {
+        imports.push(`use ${requestNs}\\${modelName}UpdateRequest;`);
+    }
+    if (actions.includes('show') || actions.includes('update') || actions.includes('destroy') || restore) {
+        imports.push(`use ${resourceNs}\\${modelName}Resource;`);
+    }
+    imports.push(`use ${modelNs}\\${modelName};`);
+    imports.push(`use Illuminate\\Http\\JsonResponse;`);
+    imports.push(`use Illuminate\\Http\\Request;`);
+    if (actions.includes('index') || lookup) {
+        imports.push(`use Illuminate\\Http\\Resources\\Json\\AnonymousResourceCollection;`);
+    }
+    // Build methods
+    const methods = [];
+    if (actions.includes('index')) {
+        methods.push(`
+    public function index(Request $request): AnonymousResourceCollection
+    {
+        $result = $this->service->list($request->all());
+
+        return ${modelName}Resource::collection($result);
+    }`);
+    }
+    if (actions.includes('store')) {
+        methods.push(`
+    public function store(${modelName}StoreRequest $request): JsonResponse
+    {
+        $model = $this->service->create($request->validated());
+
+        return (new ${modelName}Resource($model))
+            ->response()
+            ->setStatusCode(201);
+    }`);
+    }
+    if (actions.includes('show')) {
+        methods.push(`
+    public function show(${modelName} $model): ${modelName}Resource
+    {
+        return new ${modelName}Resource($model);
+    }`);
+    }
+    if (actions.includes('update')) {
+        methods.push(`
+    public function update(${modelName}UpdateRequest $request, ${modelName} $model): ${modelName}Resource
+    {
+        $model = $this->service->update($model, $request->validated());
+
+        return new ${modelName}Resource($model);
+    }`);
+    }
+    if (actions.includes('destroy')) {
+        methods.push(`
+    public function destroy(${modelName} $model): JsonResponse
+    {
+        $this->service->delete($model);
+
+        return response()->json(null, 204);
+    }`);
+    }
+    if (lookup) {
+        methods.push(`
+    public function lookup(Request $request): AnonymousResourceCollection
+    {
+        $result = $this->service->lookup($request->all());
+
+        return ${modelName}Resource::collection($result);
+    }`);
+    }
+    if (bulkDelete) {
+        methods.push(`
+    public function bulkDelete(Request $request): JsonResponse
+    {
+        $this->service->bulkDelete($request->input('ids', []));
+
+        return response()->json(null, 204);
+    }`);
+    }
+    if (restore) {
+        methods.push(`
+    public function restore(string $id): ${modelName}Resource
+    {
+        $model = $this->service->restore($id);
+
+        return new ${modelName}Resource($model);
+    }`);
+    }
+    const content = `<?php
+
+namespace ${baseNs};
+
+/**
+ * DO NOT EDIT - This file is auto-generated by Omnify.
+ * Any changes will be overwritten on next generation.
+ *
+ * @generated by omnify
+ */
+
+${imports.join('\n')}
+
+abstract class ${modelName}ControllerBase extends Controller
+{
+    public function __construct(
+        protected readonly ${modelName}ServiceBase $service,
+    ) {}
+${methods.join('\n')}
+}
+`;
+    return baseFile(`${config.controllers.basePath}/${modelName}ControllerBase.php`, content);
+}
+function generateUserController(name, schema, config) {
+    const modelName = toPascalCase(name);
+    const group = schema.group ? toPascalCase(schema.group) : null;
+    const baseNs = config.controllers.baseNamespace;
+    const userNs = group
+        ? `${config.controllers.namespace}\\Api\\V1\\${group}`
+        : `${config.controllers.namespace}\\Api\\V1`;
+    const userPath = group
+        ? `${config.controllers.path}/Api/V1/${group}`
+        : `${config.controllers.path}/Api/V1`;
+    const content = `<?php
+
+/**
+ * ${modelName} Controller
+ *
+ * SAFE TO EDIT - This file is never overwritten by Omnify.
+ */
+
+namespace ${userNs};
+
+use ${baseNs}\\${modelName}ControllerBase;
+
+class ${modelName}Controller extends ${modelName}ControllerBase
+{
+    //
+}
+`;
+    return userFile(`${userPath}/${modelName}Controller.php`, content);
+}

package/dist/php/index.js

@@ -25,6 +25,10 @@ import { generatePolicies } from './policy-generator.js';
 import { generateFileModels } from './file-model-generator.js';
 import { generateFileTrait } from './file-trait-generator.js';
 import { generateFileCleanup } from './file-cleanup-generator.js';
+import { generateSchemaConfig } from './schema-config-generator.js';
+import { generateControllers } from './controller-generator.js';
+import { generateServices } from './service-generator.js';
+import { generateRoutes } from './route-generator.js';
 export { derivePhpConfig } from './types.js';
 /** Generate all PHP files from schemas.json data. */
 export function generatePhp(data, overrides) {
@@ -42,6 +46,13 @@ export function generatePhp(data, overrides) {
         files.push(...generateFileFactory(reader, config));
         files.push(...generateFileCleanup(reader, config));
     }
+    // CRUD API files (only for schemas with options.api)
+    if (reader.hasApiSchemas()) {
+        files.push(...generateSchemaConfig(reader, config));
+        files.push(...generateControllers(reader, config));
+        files.push(...generateServices(reader, config));
+        files.push(...generateRoutes(reader, config));
+    }
     // Per-schema files
     files.push(...generateLocales(reader, config));
     files.push(...generateModels(reader, config));

package/dist/php/route-generator.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Generates route files for schemas with `options.api`.
+ *
+ * Each schema gets its own route file at routes/api/omnify/{snake_name}.php.
+ * Always overwritten.
+ */
+import { SchemaReader } from './schema-reader.js';
+import type { GeneratedFile, PhpConfig } from './types.js';
+/** Generate route files for all schemas with api config. */
+export declare function generateRoutes(reader: SchemaReader, config: PhpConfig): GeneratedFile[];

package/dist/php/route-generator.js

@@ -0,0 +1,86 @@
+/**
+ * Generates route files for schemas with `options.api`.
+ *
+ * Each schema gets its own route file at routes/api/omnify/{snake_name}.php.
+ * Always overwritten.
+ */
+import { toPascalCase, toCamelCase, toSnakeCase, pluralize } from './naming-helper.js';
+import { baseFile } from './types.js';
+const DEFAULT_ACTIONS = ['index', 'store', 'show', 'update', 'destroy'];
+/** Generate route files for all schemas with api config. */
+export function generateRoutes(reader, config) {
+    const files = [];
+    for (const [name, schema] of Object.entries(reader.getSchemasWithApi())) {
+        files.push(generateRouteFile(name, schema, config));
+    }
+    return files;
+}
+function generateRouteFile(name, schema, config) {
+    const modelName = toPascalCase(name);
+    const api = schema.options?.api ?? {};
+    const actions = [...(api.actions ?? DEFAULT_ACTIONS)];
+    const lookup = api.lookup ?? true;
+    const bulkDelete = api.bulkDelete ?? false;
+    const restore = api.restore ?? (schema.options?.softDelete ?? false);
+    const middleware = api.middleware ?? [];
+    // Route prefix: use api.prefix or default to snake_case plural
+    const prefix = api.prefix ?? pluralize(toSnakeCase(name));
+    // Route param name: camelCase singular
+    const routeParam = toCamelCase(name);
+    // Controller namespace
+    const group = schema.group ? toPascalCase(schema.group) : null;
+    const controllerNs = group
+        ? `${config.controllers.namespace}\\Api\\V1\\${group}`
+        : `${config.controllers.namespace}\\Api\\V1`;
+    // Build use statements
+    const useStatements = [
+        `use ${controllerNs}\\${modelName}Controller;`,
+        `use Illuminate\\Support\\Facades\\Route;`,
+    ];
+    // Build route lines
+    const routeLines = [];
+    // Lookup must come before resource-like routes (before {param})
+    if (lookup) {
+        routeLines.push(`    Route::get('lookup', [${modelName}Controller::class, 'lookup'])->name('lookup');`);
+    }
+    // Bulk delete (POST to avoid conflicts with single delete)
+    if (bulkDelete) {
+        routeLines.push(`    Route::post('bulk-delete', [${modelName}Controller::class, 'bulkDelete'])->name('bulkDelete');`);
+    }
+    // Standard CRUD routes
+    if (actions.includes('index')) {
+        routeLines.push(`    Route::get('/', [${modelName}Controller::class, 'index'])->name('index');`);
+    }
+    if (actions.includes('store')) {
+        routeLines.push(`    Route::post('/', [${modelName}Controller::class, 'store'])->name('store');`);
+    }
+    if (actions.includes('show')) {
+        routeLines.push(`    Route::get('{${routeParam}}', [${modelName}Controller::class, 'show'])->name('show');`);
+    }
+    if (actions.includes('update')) {
+        routeLines.push(`    Route::put('{${routeParam}}', [${modelName}Controller::class, 'update'])->name('update');`);
+    }
+    if (actions.includes('destroy')) {
+        routeLines.push(`    Route::delete('{${routeParam}}', [${modelName}Controller::class, 'destroy'])->name('destroy');`);
+    }
+    // Restore (soft delete)
+    if (restore) {
+        routeLines.push(`    Route::post('{${routeParam}}/restore', [${modelName}Controller::class, 'restore'])->name('restore');`);
+    }
+    // Build middleware block
+    const middlewareChain = middleware.length > 0
+        ? `->middleware([${middleware.map(m => `'${m}'`).join(', ')}])`
+        : '';
+    const content = `<?php
+
+// Auto-generated by Omnify. DO NOT EDIT.
+
+${useStatements.join('\n')}
+
+Route::prefix('${prefix}')->name('api.v1.${prefix}.')${middlewareChain}->group(function () {
+${routeLines.join('\n')}
+});
+`;
+    const snakeName = toSnakeCase(name);
+    return baseFile(`${config.routes.path}/${snakeName}.php`, content);
+}

package/dist/php/schema-config-generator.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Generates config/omnify-schemas.php — schema metadata for the Query Engine.
+ *
+ * Only includes schemas with `options.api` set.
+ * Only includes properties that have searchable/filterable/sortable flags.
+ */
+import { SchemaReader } from './schema-reader.js';
+import type { GeneratedFile, PhpConfig } from './types.js';
+/** Generate the omnify-schemas config file. */
+export declare function generateSchemaConfig(reader: SchemaReader, config: PhpConfig): GeneratedFile[];

package/dist/php/schema-config-generator.js

@@ -0,0 +1,74 @@
+/**
+ * Generates config/omnify-schemas.php — schema metadata for the Query Engine.
+ *
+ * Only includes schemas with `options.api` set.
+ * Only includes properties that have searchable/filterable/sortable flags.
+ */
+import { toPascalCase, toSnakeCase } from './naming-helper.js';
+import { baseFile } from './types.js';
+/** Generate the omnify-schemas config file. */
+export function generateSchemaConfig(reader, config) {
+    const apiSchemas = reader.getSchemasWithApi();
+    if (Object.keys(apiSchemas).length === 0)
+        return [];
+    const entries = [];
+    for (const [name, schema] of Object.entries(apiSchemas)) {
+        entries.push(generateSchemaEntry(name, schema, reader, config));
+    }
+    const content = `<?php
+
+// Auto-generated by Omnify. DO NOT EDIT.
+
+return [
+${entries.join('\n')}];
+`;
+    return [baseFile('config/omnify-schemas.php', content)];
+}
+function generateSchemaEntry(name, schema, reader, config) {
+    const modelName = toPascalCase(name);
+    const tableName = reader.getTableName(name);
+    const softDelete = schema.options?.softDelete ?? false;
+    const perPage = schema.options?.api?.perPage ?? 15;
+    const properties = schema.properties ?? {};
+    const propertyOrder = reader.getPropertyOrder(name);
+    const propLines = [];
+    for (const propName of propertyOrder) {
+        const prop = properties[propName];
+        if (!prop)
+            continue;
+        const searchable = prop.searchable ?? false;
+        const filterable = prop.filterable ?? false;
+        const sortable = prop.sortable ?? false;
+        // Only include properties with at least one query flag
+        if (!searchable && !filterable && !sortable)
+            continue;
+        const colName = toSnakeCase(propName);
+        const attrs = [];
+        attrs.push(`'type' => '${prop.type}'`);
+        if (searchable)
+            attrs.push(`'searchable' => true`);
+        if (filterable)
+            attrs.push(`'filterable' => true`);
+        if (sortable)
+            attrs.push(`'sortable' => true`);
+        // Include enum values for Enum types
+        if ((prop.type === 'Enum' || prop.type === 'EnumRef') && prop.enum) {
+            const enumArr = typeof prop.enum === 'string' ? [prop.enum] : [...prop.enum];
+            if (enumArr.length > 0) {
+                const enumValues = enumArr.map(v => `'${v}'`).join(', ');
+                attrs.push(`'enum' => [${enumValues}]`);
+            }
+        }
+        propLines.push(`            '${colName}' => [${attrs.join(', ')}],`);
+    }
+    const propsBlock = propLines.length > 0
+        ? `\n        'properties' => [\n${propLines.join('\n')}\n        ],`
+        : `\n        'properties' => [],`;
+    return `    '${modelName}' => [
+        'table' => '${tableName}',
+        'model' => \\${config.models.namespace}\\${modelName}::class,
+        'softDelete' => ${softDelete ? 'true' : 'false'},
+        'perPage' => ${perPage},${propsBlock}
+    ],
+`;
+}

package/dist/php/schema-reader.d.ts

@@ -47,6 +47,10 @@ export declare class SchemaReader {
     getExpandedProperties(schemaName: string): Record<string, ExpandedProperty>;
     getPropertyOrder(schemaName: string): string[];
     getTableName(schemaName: string): string;
+    /** Get schemas that have api options configured. */
+    getSchemasWithApi(): Record<string, SchemaDefinition>;
+    /** Check if any schema has api options. */
+    hasApiSchemas(): boolean;
     /** Check if any schema has File-type properties. */
     hasFileProperties(): boolean;
     /** Get the file config from schemas.json. */

package/dist/php/schema-reader.js

@@ -158,6 +158,20 @@ export class SchemaReader {
         const schema = this.getSchema(schemaName);
         return schema?.tableName ?? '';
     }
+    /** Get schemas that have api options configured. */
+    getSchemasWithApi() {
+        const result = {};
+        for (const [name, schema] of Object.entries(this.getProjectVisibleObjectSchemas())) {
+            if (schema.options?.api) {
+                result[name] = schema;
+            }
+        }
+        return result;
+    }
+    /** Check if any schema has api options. */
+    hasApiSchemas() {
+        return Object.keys(this.getSchemasWithApi()).length > 0;
+    }
     /** Check if any schema has File-type properties. */
     hasFileProperties() {
         for (const schema of Object.values(this.getObjectSchemas())) {

package/dist/php/service-generator.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Generates base + editable service classes for schemas with `options.api`.
+ */
+import { SchemaReader } from './schema-reader.js';
+import type { GeneratedFile, PhpConfig } from './types.js';
+/** Generate service classes for all schemas with api config. */
+export declare function generateServices(reader: SchemaReader, config: PhpConfig): GeneratedFile[];

package/dist/php/service-generator.js

@@ -0,0 +1,319 @@
+/**
+ * Generates base + editable service classes for schemas with `options.api`.
+ */
+import { toPascalCase, toSnakeCase } from './naming-helper.js';
+import { baseFile, userFile } from './types.js';
+/** Generate service classes for all schemas with api config. */
+export function generateServices(reader, config) {
+    const files = [];
+    for (const [name, schema] of Object.entries(reader.getSchemasWithApi())) {
+        files.push(...generateForSchema(name, schema, reader, config));
+    }
+    return files;
+}
+function generateForSchema(name, schema, reader, config) {
+    return [
+        generateBaseService(name, schema, reader, config),
+        generateUserService(name, schema, config),
+    ];
+}
+// ============================================================================
+// Base service generation
+// ============================================================================
+function generateBaseService(name, schema, reader, config) {
+    const modelName = toPascalCase(name);
+    const api = schema.options?.api ?? {};
+    const bulkDelete = api.bulkDelete ?? false;
+    const restore = api.restore ?? (schema.options?.softDelete ?? false);
+    const perPage = api.perPage ?? 15;
+    const lookup = api.lookup ?? true;
+    const baseNs = config.services.baseNamespace;
+    const modelNs = config.models.namespace;
+    const properties = schema.properties ?? {};
+    const propertyOrder = reader.getPropertyOrder(name);
+    // Collect searchable, filterable, sortable fields
+    const searchableFields = [];
+    const filterableFields = [];
+    const sortableFields = [];
+    for (const propName of propertyOrder) {
+        const prop = properties[propName];
+        if (!prop)
+            continue;
+        const colName = toSnakeCase(propName);
+        if (prop.searchable) {
+            searchableFields.push({ propName, colName });
+        }
+        if (prop.filterable) {
+            filterableFields.push({ propName, colName, type: prop.type, prop });
+        }
+        if (prop.sortable) {
+            sortableFields.push(colName);
+        }
+    }
+    // Build search block
+    const searchBlock = buildSearchBlock(searchableFields);
+    // Build filter block
+    const filterBlock = buildFilterBlock(filterableFields);
+    // Build sort block
+    const sortBlock = buildSortBlock(sortableFields);
+    // Build additional imports
+    const imports = [
+        `use ${modelNs}\\${modelName};`,
+        `use Illuminate\\Contracts\\Pagination\\LengthAwarePaginator;`,
+    ];
+    if (restore) {
+        imports.push(`use Illuminate\\Database\\Eloquent\\Collection;`);
+    }
+    // Build methods
+    const methods = [];
+    // list method
+    methods.push(`
+    /**
+     * List ${modelName} records with search, filter, and sort.
+     *
+     * @param array<string, mixed> $filters
+     */
+    public function list(array $filters): LengthAwarePaginator
+    {
+        $query = ${modelName}::query();
+
+        // Organization scope
+        if (isset($filters['organization_id'])) {
+            $query->where('organization_id', $filters['organization_id']);
+        }
+${searchBlock}${filterBlock}${sortBlock}
+        return $query->paginate($filters['per_page'] ?? ${perPage});
+    }`);
+    // lookup method
+    if (lookup) {
+        methods.push(`
+    /**
+     * Lookup ${modelName} records for select/combobox (lightweight).
+     *
+     * @param array<string, mixed> $filters
+     */
+    public function lookup(array $filters): LengthAwarePaginator
+    {
+        $query = ${modelName}::query();
+
+        if (isset($filters['organization_id'])) {
+            $query->where('organization_id', $filters['organization_id']);
+        }
+
+        if ($search = $filters['search'] ?? null) {
+            $query->where(function ($q) use ($search) {${searchableFields.length > 0 ? `\n${searchableFields.map((f, i) => `                $q->${i === 0 ? 'where' : 'orWhere'}('${f.colName}', 'like', "%{$search}%");`).join('\n')}` : `\n                // No searchable fields defined`}
+            });
+        }
+
+        return $query->paginate($filters['per_page'] ?? 50);
+    }`);
+    }
+    // create method
+    methods.push(`
+    /**
+     * Create a new ${modelName}.
+     *
+     * @param array<string, mixed> $data
+     */
+    public function create(array $data): ${modelName}
+    {
+        return ${modelName}::create($data);
+    }`);
+    // update method
+    methods.push(`
+    /**
+     * Update an existing ${modelName}.
+     *
+     * @param array<string, mixed> $data
+     */
+    public function update(${modelName} $model, array $data): ${modelName}
+    {
+        $model->update($data);
+
+        return $model->fresh();
+    }`);
+    // delete method
+    methods.push(`
+    /**
+     * Delete a ${modelName}.
+     */
+    public function delete(${modelName} $model): void
+    {
+        $model->delete();
+    }`);
+    // bulkDelete method
+    if (bulkDelete) {
+        methods.push(`
+    /**
+     * Delete multiple ${modelName} records by IDs.
+     *
+     * @param array<int|string> $ids
+     */
+    public function bulkDelete(array $ids): void
+    {
+        ${modelName}::whereIn('id', $ids)->delete();
+    }`);
+    }
+    // restore method
+    if (restore) {
+        methods.push(`
+    /**
+     * Restore a soft-deleted ${modelName}.
+     */
+    public function restore(string $id): ${modelName}
+    {
+        $model = ${modelName}::withTrashed()->findOrFail($id);
+        $model->restore();
+
+        return $model->fresh();
+    }`);
+    }
+    const content = `<?php
+
+namespace ${baseNs};
+
+/**
+ * DO NOT EDIT - This file is auto-generated by Omnify.
+ * Any changes will be overwritten on next generation.
+ *
+ * @generated by omnify
+ */
+
+${imports.join('\n')}
+
+class ${modelName}ServiceBase
+{
+${methods.join('\n')}
+}
+`;
+    return baseFile(`${config.services.basePath}/${modelName}ServiceBase.php`, content);
+}
+// ============================================================================
+// Search / Filter / Sort block builders
+// ============================================================================
+function buildSearchBlock(fields) {
+    if (fields.length === 0)
+        return '';
+    const clauses = fields.map((f, i) => {
+        const method = i === 0 ? 'where' : 'orWhere';
+        return `                $q->${method}('${f.colName}', 'like', "%{$search}%");`;
+    });
+    return `
+        // Search
+        if ($search = $filters['search'] ?? null) {
+            $query->where(function ($q) use ($search) {
+${clauses.join('\n')}
+            });
+        }
+`;
+}
+function buildFilterBlock(fields) {
+    if (fields.length === 0)
+        return '';
+    const lines = [];
+    lines.push('');
+    lines.push('        // Filters');
+    for (const f of fields) {
+        const { colName, type } = f;
+        switch (type) {
+            case 'Decimal':
+            case 'Int':
+            case 'Float':
+            case 'Integer':
+                // Range filters: field_min, field_max
+                lines.push(`        if (isset($filters['${colName}_min'])) {`);
+                lines.push(`            $query->where('${colName}', '>=', $filters['${colName}_min']);`);
+                lines.push(`        }`);
+                lines.push(`        if (isset($filters['${colName}_max'])) {`);
+                lines.push(`            $query->where('${colName}', '<=', $filters['${colName}_max']);`);
+                lines.push(`        }`);
+                break;
+            case 'Date':
+            case 'Timestamp':
+            case 'DateTime':
+                // Date range filters: field_from, field_to
+                lines.push(`        if (isset($filters['${colName}_from'])) {`);
+                lines.push(`            $query->where('${colName}', '>=', $filters['${colName}_from']);`);
+                lines.push(`        }`);
+                lines.push(`        if (isset($filters['${colName}_to'])) {`);
+                lines.push(`            $query->where('${colName}', '<=', $filters['${colName}_to']);`);
+                lines.push(`        }`);
+                break;
+            case 'Boolean':
+                lines.push(`        if (isset($filters['${colName}'])) {`);
+                lines.push(`            $query->where('${colName}', filter_var($filters['${colName}'], FILTER_VALIDATE_BOOLEAN));`);
+                lines.push(`        }`);
+                break;
+            case 'Enum':
+            case 'EnumRef':
+            case 'String':
+            default:
+                // Exact match
+                lines.push(`        if (isset($filters['${colName}'])) {`);
+                lines.push(`            $query->where('${colName}', $filters['${colName}']);`);
+                lines.push(`        }`);
+                break;
+        }
+    }
+    return lines.join('\n') + '\n';
+}
+function buildSortBlock(sortableFields) {
+    if (sortableFields.length === 0) {
+        return `
+        // Sort
+        $query->orderBy('created_at', 'desc');
+`;
+    }
+    const allowedList = sortableFields.map(f => `'${f}'`).join(', ');
+    return `
+        // Sort
+        $sortParam = $filters['sort'] ?? '-created_at';
+        $allowedSorts = [${allowedList}];
+
+        foreach (explode(',', $sortParam) as $sortField) {
+            $sortField = trim($sortField);
+            $direction = 'asc';
+
+            if (str_starts_with($sortField, '-')) {
+                $direction = 'desc';
+                $sortField = substr($sortField, 1);
+            }
+
+            if (in_array($sortField, $allowedSorts, true) || $sortField === 'created_at' || $sortField === 'updated_at') {
+                $query->orderBy($sortField, $direction);
+            }
+        }
+`;
+}
+// ============================================================================
+// User service
+// ============================================================================
+function generateUserService(name, schema, config) {
+    const modelName = toPascalCase(name);
+    const group = schema.group ? toPascalCase(schema.group) : null;
+    const baseNs = config.services.baseNamespace;
+    const userNs = group
+        ? `${config.services.namespace}\\${group}`
+        : config.services.namespace;
+    const userPath = group
+        ? `${config.services.path}/${group}`
+        : config.services.path;
+    const content = `<?php
+
+/**
+ * ${modelName} Service
+ *
+ * SAFE TO EDIT - This file is never overwritten by Omnify.
+ */
+
+namespace ${userNs};
+
+use ${baseNs}\\${modelName}ServiceBase;
+
+class ${modelName}Service extends ${modelName}ServiceBase
+{
+    //
+}
+`;
+    return userFile(`${userPath}/${modelName}Service.php`, content);
+}

package/dist/php/types.d.ts

@@ -29,6 +29,9 @@ export interface LaravelCodegenOverrides {
     factory?: LaravelPathOverride;
     provider?: LaravelPathOverride;
     policy?: LaravelPathOverride;
+    controller?: LaravelPathOverride;
+    service?: LaravelPathOverride;
+    route?: LaravelPathOverride;
     nestedset?: NestedSetOverride;
 }
 /** PHP codegen configuration (resolved with defaults). */
@@ -65,6 +68,21 @@ export interface PhpConfig {
         path: string;
         basePath: string;
     };
+    controllers: {
+        namespace: string;
+        baseNamespace: string;
+        path: string;
+        basePath: string;
+    };
+    services: {
+        namespace: string;
+        baseNamespace: string;
+        path: string;
+        basePath: string;
+    };
+    routes: {
+        path: string;
+    };
     nestedset: {
         namespace: string;
     };

package/dist/php/types.js

@@ -23,6 +23,9 @@ const DEFAULT_RESOURCE_PATH = 'app/Http/Resources';
 const DEFAULT_FACTORY_PATH = 'database/factories';
 const DEFAULT_PROVIDER_PATH = 'app/Providers';
 const DEFAULT_POLICY_PATH = 'app/Policies/Omnify';
+const DEFAULT_CONTROLLER_PATH = 'app/Http/Controllers';
+const DEFAULT_SERVICE_PATH = 'app/Services';
+const DEFAULT_ROUTE_PATH = 'routes/api/omnify';
 /**
  * Derive full PHP config from optional overrides.
  * All paths and namespaces fall back to sensible defaults.
@@ -40,6 +43,11 @@ export function derivePhpConfig(overrides) {
     const providerNs = overrides?.provider?.namespace ?? pathToNamespace(providerPath);
     const policyPath = overrides?.policy?.path ?? DEFAULT_POLICY_PATH;
     const policyNs = overrides?.policy?.namespace ?? pathToNamespace(policyPath);
+    const controllerPath = overrides?.controller?.path ?? DEFAULT_CONTROLLER_PATH;
+    const controllerNs = overrides?.controller?.namespace ?? pathToNamespace(controllerPath);
+    const servicePath = overrides?.service?.path ?? DEFAULT_SERVICE_PATH;
+    const serviceNs = overrides?.service?.namespace ?? pathToNamespace(servicePath);
+    const routePath = overrides?.route?.path ?? DEFAULT_ROUTE_PATH;
     const nestedsetNs = overrides?.nestedset?.namespace ?? 'Aimeos\\Nestedset';
     return {
         models: {
@@ -74,6 +82,21 @@ export function derivePhpConfig(overrides) {
             path: policyPath,
             basePath: `${policyPath}/Base`,
         },
+        controllers: {
+            namespace: controllerNs,
+            baseNamespace: `${controllerNs}\\OmnifyBase`,
+            path: controllerPath,
+            basePath: `${controllerPath}/OmnifyBase`,
+        },
+        services: {
+            namespace: serviceNs,
+            baseNamespace: `${serviceNs}\\OmnifyBase`,
+            path: servicePath,
+            basePath: `${servicePath}/OmnifyBase`,
+        },
+        routes: {
+            path: routePath,
+        },
         nestedset: {
             namespace: nestedsetNs,
         },

package/dist/types.d.ts

@@ -91,6 +91,16 @@ export interface ExpandedColumn {
     readonly nullable?: boolean;
     readonly enum?: readonly string[];
 }
+/** API generation options for a schema. */
+export interface ApiOptions {
+    readonly prefix?: string;
+    readonly actions?: readonly string[];
+    readonly lookup?: boolean;
+    readonly bulkDelete?: boolean;
+    readonly restore?: boolean;
+    readonly middleware?: readonly string[];
+    readonly perPage?: number;
+}
 /** Schema options. */
 export interface SchemaOptions {
     readonly id?: boolean | string;
@@ -101,6 +111,7 @@ export interface SchemaOptions {
     readonly tableName?: string;
     readonly indexes?: readonly unknown[];
     readonly unique?: readonly unknown[];
+    readonly api?: ApiOptions;
 }
 /** Schema definition from schemas.json. */
 export interface SchemaDefinition {
@@ -212,6 +223,9 @@ export interface PropertyDefinition {
     readonly joinTable?: string;
     readonly mappedBy?: string;
     readonly useCurrent?: boolean;
+    readonly searchable?: boolean;
+    readonly filterable?: boolean;
+    readonly sortable?: boolean;
     readonly fields?: Record<string, FieldOverride>;
 }
 /** Field override for compound type properties. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@omnifyjp/ts",
-  "version": "2.1.11",
+  "version": "3.0.0",
   "description": "TypeScript model type generator from Omnify schemas.json",
   "type": "module",
   "main": "dist/index.js",