@apso/cli 0.18.0 → 0.19.0

package/dist/commands/generate.js

@@ -10,10 +10,11 @@ const perf_hooks_1 = require("perf_hooks");
 const file_system_1 = require("../lib/utils/file-system");
 class Generate extends base_command_1.default {
     async run() {
+        var _a, _b;
         const { flags } = await this.parse(Generate);
         const skipFormat = flags["skip-format"];
         const totalBuildStart = perf_hooks_1.performance.now();
-        const { rootFolder, entities, relationshipMap, apiType, auth, emitEvents, language: configLanguage } = (0, lib_1.parseApsorc)();
+        const { rootFolder, entities, relationshipMap, apiType, auth, emitEvents, http, language: configLanguage } = (0, lib_1.parseApsorc)();
         // Resolve language: flag > .apsorc > prompt
         let language;
         if (flags.language) {
@@ -64,6 +65,7 @@ class Generate extends base_command_1.default {
             relationshipMap,
             auth,
             emitEvents,
+            http,
         };
         const generator = (0, lib_1.createGenerator)(generatorConfig);
         const validationResult = generator.validateConfig(generatorConfig);
@@ -94,8 +96,21 @@ class Generate extends base_command_1.default {
             console.log(`[apso] Building... ${entity.name}`);
             const entityBuildStart = perf_hooks_1.performance.now();
             const entityRelationships = relationshipMap[entity.name] || [];
-            // eslint-disable-next-line no-await-in-loop
-            const allFiles = await Promise.all([
+            // Effective HTTP-controller flag (TypeScript REST only for now): entity
+            // overrides the top-level default, which defaults to true. When false, the
+            // controller is neither generated nor wired into the module (a hand-written
+            // controller owns the route). GraphQL uses resolvers, so the flag doesn't
+            // apply there. Python (FastAPI) and Go (Gin) wire routers differently and
+            // don't yet honor this flag — keep it a no-op for them (controllers always
+            // generated) so we never emit broken wiring (a skipped router still
+            // referenced by the index module). Tracked separately for Python/Go.
+            const includeController = language === "typescript" && lowerCaseApiType === "rest"
+                ? ((_b = (_a = entity.http) !== null && _a !== void 0 ? _a : http) !== null && _b !== void 0 ? _b : true)
+                : true;
+            if (!includeController) {
+                console.log(`[apso]   ${entity.name}: http=false — skipping generated controller`);
+            }
+            const generationTasks = [
                 generator.generateEntity({
                     entity,
                     relationships: entityRelationships,
@@ -115,20 +130,25 @@ class Generate extends base_command_1.default {
                     apiType: lowerCaseApiType,
                     relationshipMap,
                 }),
-                generator.generateController({
+                generator.generateModule({
                     entity,
                     relationships: entityRelationships,
                     allEntities: entities,
                     apiType: lowerCaseApiType,
-                    relationshipMap,
+                    includeController,
                 }),
-                generator.generateModule({
+            ];
+            if (includeController) {
+                generationTasks.push(generator.generateController({
                     entity,
                     relationships: entityRelationships,
                     allEntities: entities,
                     apiType: lowerCaseApiType,
-                }),
-            ]);
+                    relationshipMap,
+                }));
+            }
+            // eslint-disable-next-line no-await-in-loop
+            const allFiles = await Promise.all(generationTasks);
             // eslint-disable-next-line no-await-in-loop
             for (const files of allFiles) {
                 for (const file of files) {

package/dist/commands/mcp/serve.js

@@ -924,6 +924,7 @@ const INLINE_SCHEMA_REFERENCE = `# Schema Quick Reference
   "primaryKeyType": "serial",
   "scopeBy": "organizationId",
   "emitEvents": true,
+  "http": false,
   "fields": [
     { "name": "fieldName", "type": "text", "length": 100 }
   ],
@@ -946,6 +947,20 @@ manifest at \`autogen/events/event-emitting.entities.ts\` exporting
 \`@apso/domain-events\` library and is wired by the \`domain-events\` skill; the
 CLI no longer generates the engine code.
 
+## HTTP controllers (http)
+Controllers are generated by default. Set \`http: false\` on an entity (or a
+top-level \`http: false\` default) to NOT generate/mount its HTTP controller while
+still generating the entity, service, DTOs, and module (\`TypeOrmModule.forFeature\`
++ the service). Use this when a hand-written controller owns the route for that
+entity (e.g. a custom/Stripe-shaped surface). Effective value is
+\`entity.http ?? <top-level http> ?? true\`.
+
+Per framework: NestJS and Gin (Go) actually suppress the controller — those
+frameworks can't cleanly override a generated route. For FastAPI it's a no-op:
+override by registering your router ahead of the generated \`autogen_router\`
+(FastAPI matches in registration order). Currently implemented for NestJS; Go
+is tracked separately.
+
 ## Relationship Types
 - OneToMany: parent has many children
 - ManyToOne: child belongs to parent

package/dist/lib/apsorc-parser.d.ts

@@ -20,6 +20,11 @@ export type ApsorcType = {
      * its own `emitEvents: false`.
      */
     emitEvents?: boolean;
+    /**
+     * Top-level default for HTTP controller generation. When false, no entity
+     * gets a generated controller unless it opts back in with `http: true`.
+     */
+    http?: boolean;
 };
 type ParsedApsorcData = {
     entities: Entity[];
@@ -34,6 +39,8 @@ type ParsedApsorc = {
     language?: TargetLanguage;
     /** Top-level default for the DomainEvent ("emitEvents") feature. */
     emitEvents?: boolean;
+    /** Top-level default for HTTP controller generation. */
+    http?: boolean;
 };
 export declare const parseApsorcV1: (apsorc: ApsorcType) => ParsedApsorcData;
 export declare const parseApsorcV2: (apsorc: ApsorcType) => ParsedApsorcData;

package/dist/lib/apsorc-parser.js

@@ -37,6 +37,7 @@ const parseRc = () => {
     const auth = apsoConfig.auth;
     const language = apsoConfig.language;
     const emitEvents = apsoConfig.emitEvents;
+    const http = apsoConfig.http;
     return {
         rootFolder,
         apiType,
@@ -46,6 +47,7 @@ const parseRc = () => {
         auth,
         language,
         emitEvents,
+        http,
     };
 };
 const parseApsorc = () => {
@@ -66,6 +68,7 @@ const parseApsorc = () => {
                     auth: apsoConfig.auth,
                     language: apsoConfig.language,
                     emitEvents: apsoConfig.emitEvents,
+                    http: apsoConfig.http,
                     ...(0, exports.parseApsorcV1)(apsoConfig),
                 };
                 if (debug) {
@@ -83,6 +86,7 @@ const parseApsorc = () => {
                     auth: apsoConfig.auth,
                     language: apsoConfig.language,
                     emitEvents: apsoConfig.emitEvents,
+                    http: apsoConfig.http,
                     ...(() => {
                         const relStart = perf_hooks_1.performance.now();
                         const parsed = (0, exports.parseApsorcV2)(apsoConfig);

package/dist/lib/generators/typescript.js

@@ -249,7 +249,7 @@ class TypeScriptGenerator extends base_1.BaseGenerator {
         ];
     }
     async generateModule(options) {
-        const { entity, apiType } = options;
+        const { entity, apiType, includeController = true } = options;
         const { name: entityName } = entity;
         const moduleName = `${entityName}Module`;
         const svcName = `${entityName}Service`;
@@ -261,6 +261,7 @@ class TypeScriptGenerator extends base_1.BaseGenerator {
             ctrlName,
             resolverName,
             entityName,
+            includeController,
         };
         const templatePath = apiType === "graphql"
             ? "./graphql/gql-module-graphql"

package/dist/lib/templates/rest/module-rest.eta

@@ -4,13 +4,12 @@ import { Module } from "@nestjs/common";
 import {<%= it.entityName %>} from './<%= it.entityName%>.entity'
 import { TypeOrmModule } from "@nestjs/typeorm";
 import {<%= it.svcName %>} from "./<%= it.entityName %>.service";
-import {<%= it.ctrlName %>} from "./<%= it.entityName %>.controller";
-
+<% if (it.includeController) { %>import {<%= it.ctrlName %>} from "./<%= it.entityName %>.controller";
+<% } %>
 @Module({
   imports: [TypeOrmModule.forFeature([<%= it.entityName %>])],
   providers: [<%= it.svcName %>],
   exports: [<%= it.svcName %>],
-  controllers: [<%= it.ctrlName %>],
-})
+<% if (it.includeController) { %>  controllers: [<%= it.ctrlName %>],
+<% } %>})
 export class <%= it.moduleName %> {}
-  

package/dist/lib/types/entity.d.ts

@@ -55,5 +55,26 @@ export interface Entity {
      * an individual entity can opt out with `emitEvents: false`.
      */
     emitEvents?: boolean;
+    /**
+     * Whether to generate the HTTP controller for this entity. Defaults to true.
+     * When false, the generator still emits the entity, service, DTOs, and a module
+     * (with `TypeOrmModule.forFeature` + the service), but omits the controller —
+     * leaving the HTTP surface to a hand-written controller without a route
+     * collision with the generated CRUD.
+     *
+     * Per-framework behavior (the flag is generic, but only matters where a
+     * generated route can't be cleanly overridden):
+     * - **NestJS** and **Gin (Go)**: actually suppresses the controller/route —
+     *   these frameworks can't override a generated route (Nest controllers aren't
+     *   DI-swappable; Gin panics on duplicate paths). Implemented for NestJS;
+     *   Go is tracked separately.
+     * - **FastAPI**: effectively a **no-op** — FastAPI matches routes in
+     *   registration order, so an app overrides by registering its router ahead of
+     *   the generated `autogen_router` (no suppression needed).
+     *
+     * Resolution: the effective value is `entity.http ?? <global http> ?? true`, so
+     * controllers are on by default and opted out per entity (or globally).
+     */
+    http?: boolean;
     associations?: Association[];
 }

package/dist/lib/types/generator.d.ts

@@ -109,6 +109,11 @@ export interface GeneratorConfig {
      * Effective per-entity value is `entity.emitEvents ?? emitEvents ?? false`.
      */
     emitEvents?: boolean;
+    /**
+     * Top-level default for HTTP controller generation.
+     * Effective per-entity value is `entity.http ?? http ?? true`.
+     */
+    http?: boolean;
     /**
      * Language-specific configuration options
      */
@@ -134,6 +139,11 @@ export interface EntityGenerationOptions {
      * API type being generated
      */
     apiType: string;
+    /**
+     * Whether the entity's HTTP controller is generated/wired. Defaults to true.
+     * When false, the module omits the controller (see Entity.http).
+     */
+    includeController?: boolean;
 }
 /**
  * Options for generating controllers/routers

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@apso/cli",
-  "version": "0.18.0",
+  "version": "0.19.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@apso/cli",
-      "version": "0.18.0",
+      "version": "0.19.0",
       "license": "Apache-2.0",
       "dependencies": {
         "@electric-sql/pglite": "^0.2.17",

package/oclif.manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.18.0",
+  "version": "0.19.0",
   "commands": {
     "config": {
       "id": "config",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@apso/cli",
-  "version": "0.18.0",
+  "version": "0.19.0",
   "mcpName": "io.github.apsoai/apso",
   "description": "Apso CLI",
   "author": "Apso by Mavric - @mavric",