@pattern-stack/codegen 0.2.0

package/templates/entity/new/backend/modules/core/module.ejs.t

@@ -0,0 +1,67 @@
+---
+to: <%= outputPaths.module %>
+skip_if: <%= !isCleanArchitecture %>
+force: true
+---
+/**
+ * <%= classNamePlural %> Module
+ * Generated by entity codegen - do not edit directly
+ */
+
+import { Module } from '@nestjs/common';
+import { <%= repositoryToken %> } from '<%= imports.moduleToConstants %>';
+import { <%= getByIdQueryClass %> } from '<%= imports.moduleToGetByIdQuery %>';
+<% if (!exposeElectric) { -%>
+import { <%= listQueryClass %> } from '<%= imports.moduleToListQuery %>';
+<% } -%>
+import { <%= createCommandClass %> } from '<%= imports.moduleToCreateCommand %>';
+import { <%= deleteCommandClass %> } from '<%= imports.moduleToDeleteCommand %>';
+import { <%= updateCommandClass %> } from '<%= imports.moduleToUpdateCommand %>';
+import { DatabaseModule } from '<%= imports.moduleToDatabaseModule %>';
+<% if (exposeElectric) { -%>
+import { ElectricModule } from '<%= imports.moduleToElectricModule %>/electric.module';
+<% } -%>
+import { <%= className %>Repository } from '<%= imports.moduleToRepository %>';
+<% if (hasDeclarativeQueries) { -%>
+import { declarativeQueryClasses } from '<%= imports.moduleToDeclarativeQueries %>';
+<% } -%>
+<% if (exposeRest || exposeElectric) { -%>
+import { <%= classNamePlural %>Controller } from '<%= imports.moduleToController %>';
+<% } -%>
+
+@Module({
+	imports: [DatabaseModule<%= exposeElectric ? ', ElectricModule' : '' %>],
+<% if (exposeRest || exposeElectric) { -%>
+	controllers: [<%= classNamePlural %>Controller],
+<% } -%>
+	providers: [
+		{ provide: <%= repositoryToken %>, useClass: <%= className %>Repository },
+		// Queries
+		<%= getByIdQueryClass %>,
+<% if (!exposeElectric) { -%>
+		<%= listQueryClass %>,
+<% } -%>
+		// Use Cases
+		<%= createCommandClass %>,
+		<%= updateCommandClass %>,
+		<%= deleteCommandClass %>,
+<% if (hasDeclarativeQueries) { -%>
+		// Declarative queries
+		...declarativeQueryClasses,
+<% } -%>
+	],
+	exports: [
+		<%= repositoryToken %>,
+		<%= getByIdQueryClass %>,
+<% if (!exposeElectric) { -%>
+		<%= listQueryClass %>,
+<% } -%>
+		<%= createCommandClass %>,
+		<%= updateCommandClass %>,
+		<%= deleteCommandClass %>,
+<% if (hasDeclarativeQueries) { -%>
+		...declarativeQueryClasses,
+<% } -%>
+	],
+})
+export class <%= classNamePlural %>Module {}

package/templates/entity/new/backend/modules/trpc/module.ejs.t

@@ -0,0 +1,67 @@
+---
+to: "<%= exposeTrpc ? `${basePaths.backendSrc}/presentation/trpc/${plural}.router.ts` : '' %>"
+skip_if: <%= !isCleanArchitecture %>
+force: true
+---
+<% if (exposeTrpc) { -%>
+/**
+ * <%= classNamePlural %> tRPC Router
+ * Generated by entity codegen - do not edit directly
+ *
+ * Add this router to TrpcModule providers:
+ *   providers: [..., <%= classNamePlural %>Router],
+ */
+
+import { Injectable } from '@nestjs/common';
+import { Router, Query, Mutation, Input } from '@mguay/nestjs-trpc';
+import { z } from 'zod';
+import {
+	create<%= className %>Schema,
+	update<%= className %>Schema,
+} from '<%= imports.controllerToSchemas %>';
+import { <%= getByIdQueryClass %> } from '<%= imports.controllerToGetByIdQuery %>';
+import { <%= listQueryClass %> } from '<%= imports.controllerToListQuery %>';
+import { <%= createCommandClass %> } from '<%= imports.controllerToCreateCommand %>';
+import { <%= updateCommandClass %> } from '<%= imports.controllerToUpdateCommand %>';
+import { <%= deleteCommandClass %> } from '<%= imports.controllerToDeleteCommand %>';
+
+@Injectable()
+@Router({ alias: '<%= plural %>' })
+export class <%= classNamePlural %>Router {
+	constructor(
+		private readonly get<%= className %>ById: <%= getByIdQueryClass %>,
+		private readonly list<%= classNamePlural %>: <%= listQueryClass %>,
+		private readonly create<%= className %>: <%= createCommandClass %>,
+		private readonly update<%= className %>: <%= updateCommandClass %>,
+		private readonly delete<%= className %>: <%= deleteCommandClass %>,
+	) {}
+
+	@Query()
+	async list() {
+		return this.list<%= classNamePlural %>.execute();
+	}
+
+	@Query({ input: z.object({ id: z.string().uuid() }) })
+	async getById(@Input('id') id: string) {
+		return this.get<%= className %>ById.execute(id);
+	}
+
+	@Mutation({ input: create<%= className %>Schema })
+	async create(@Input() input: z.infer<typeof create<%= className %>Schema>) {
+		return this.create<%= className %>.execute(input);
+	}
+
+	@Mutation({ input: z.object({ id: z.string().uuid(), data: update<%= className %>Schema }) })
+	async update(
+		@Input('id') id: string,
+		@Input('data') data: z.infer<typeof update<%= className %>Schema>,
+	) {
+		return this.update<%= className %>.execute(id, data);
+	}
+
+	@Mutation({ input: z.object({ id: z.string().uuid() }) })
+	async delete(@Input('id') id: string) {
+		return this.delete<%= className %>.execute(id);
+	}
+}
+<% } -%>

package/templates/entity/new/backend/presentation/controller.ejs.t

@@ -0,0 +1,201 @@
+---
+to: "<%= (exposeRest || exposeElectric) ? `${basePaths.backendSrc}/${paths.controllers}/${plural}.controller.ts` : '' %>"
+skip_if: <%= !isCleanArchitecture %>
+force: true
+---
+<% if (exposeRest) { -%>
+/**
+ * <%= classNamePlural %> Controller
+ * Generated by entity codegen - do not edit directly
+ */
+
+import {
+	Body,
+	Controller,
+	Delete,
+	Get,
+	Param,
+	ParseUUIDPipe,
+	Post,
+	Put,
+<% if (hasRelationships) { -%>
+	Query,
+<% } -%>
+	UsePipes,
+} from '@nestjs/common';
+import { <%= getByIdQueryClass %> } from '<%= imports.controllerToGetByIdQuery %>';
+import { <%= listQueryClass %> } from '<%= imports.controllerToListQuery %>';
+import {
+	type Create<%= className %>Dto,
+	create<%= className %>Schema,
+	type Update<%= className %>Dto,
+	update<%= className %>Schema,
+} from '<%= imports.controllerToSchemas %>';
+import { <%= createCommandClass %> } from '<%= imports.controllerToCreateCommand %>';
+import { <%= deleteCommandClass %> } from '<%= imports.controllerToDeleteCommand %>';
+import { <%= updateCommandClass %> } from '<%= imports.controllerToUpdateCommand %>';
+import { ZodValidationPipe } from '../../core/pipes/zod-validation.pipe';
+import { <%= className %> } from '<%= imports.controllerToDomain %>';
+<% if (hasRelationships) { -%>
+import type { <%= className %>With } from '<%= imports.controllerToDomain %>';
+<% } -%>
+
+@Controller('<%= plural %>')
+export class <%= classNamePlural %>Controller {
+	constructor(
+		private readonly get<%= className %>ByIdQuery: <%= getByIdQueryClass %>,
+		private readonly list<%= classNamePlural %>Query: <%= listQueryClass %>,
+		private readonly create<%= className %>Command: <%= createCommandClass %>,
+		private readonly update<%= className %>Command: <%= updateCommandClass %>,
+		private readonly delete<%= className %>Command: <%= deleteCommandClass %>,
+	) {}
+
+	@Get()
+	async findAll(<%- hasRelationships ? `@Query('include') include?: string` : '' %>): Promise<<%= className %>[]> {
+<% if (hasRelationships) { -%>
+		return this.list<%= classNamePlural %>Query.execute(this.parseInclude(include));
+<% } else { -%>
+		return this.list<%= classNamePlural %>Query.execute();
+<% } -%>
+	}
+
+	@Get(':id')
+	async findById(
+		@Param('id', ParseUUIDPipe) id: string,
+<% if (hasRelationships) { -%>
+		@Query('include') include?: string,
+<% } -%>
+	): Promise<<%= className %>> {
+<% if (hasRelationships) { -%>
+		return this.get<%= className %>ByIdQuery.execute(id, this.parseInclude(include));
+<% } else { -%>
+		return this.get<%= className %>ByIdQuery.execute(id);
+<% } -%>
+	}
+
+	@Post()
+	@UsePipes(new ZodValidationPipe(create<%= className %>Schema))
+	async create(@Body() dto: Create<%= className %>Dto): Promise<<%= className %>> {
+		return this.create<%= className %>Command.execute(dto);
+	}
+
+	@Put(':id')
+	async update(
+		@Param('id', ParseUUIDPipe) id: string,
+		@Body(new ZodValidationPipe(update<%= className %>Schema)) dto: Update<%= className %>Dto,
+	): Promise<<%= className %>> {
+		return this.update<%= className %>Command.execute(id, dto);
+	}
+
+	@Delete(':id')
+	async delete(@Param('id', ParseUUIDPipe) id: string): Promise<<%= className %>> {
+		return this.delete<%= className %>Command.execute(id);
+	}
+<% if (hasRelationships) { -%>
+
+	/**
+	 * Parse comma-separated include query param into typed options.
+	 * Example: ?include=account,owner → { account: true, owner: true }
+	 */
+	private parseInclude(include?: string): <%= className %>With | undefined {
+		if (!include) return undefined;
+		const parts = include.split(',').map((s) => s.trim());
+		return {
+<% relationships.forEach((rel) => { -%>
+			<%= rel.name %>: parts.includes('<%= rel.name %>'),
+<% }) -%>
+		};
+	}
+<% } -%>
+}
+<% } -%>
+<% if (exposeElectric) { -%>
+/**
+ * <%= classNamePlural %> Controller (Electric SQL)
+ * Generated by entity codegen - do not edit directly
+ */
+
+import {
+	Controller,
+	Get,
+	Body,
+	Delete,
+	Param,
+	ParseUUIDPipe,
+	Post,
+	Put,
+	Req,
+	Res,
+	UseGuards,
+	UsePipes,
+} from '@nestjs/common';
+import type { Request, Response } from 'express';
+import { AuthGuard } from '<%= imports.controllerToAuthGuard %>/auth.guard';
+import { CurrentUser } from '<%= imports.controllerToCurrentUser %>/current-user.decorator';
+import { User } from '<%= imports.controllerToDomain %>/user';
+import { ElectricService } from '<%= imports.controllerToElectricService %>/electric.service';
+import { <%= plural %>Columns } from '<%= locations.dbSchemaClient.import %>';
+import {
+	type Create<%= className %>Dto,
+	create<%= className %>Schema,
+	type Update<%= className %>Dto,
+	update<%= className %>Schema,
+} from '<%= imports.controllerToSchemas %>';
+import { <%= createCommandClass %> } from '<%= imports.controllerToCreateCommand %>';
+import { <%= deleteCommandClass %> } from '<%= imports.controllerToDeleteCommand %>';
+import { <%= updateCommandClass %> } from '<%= imports.controllerToUpdateCommand %>';
+import { <%= getByIdQueryClass %> } from '<%= imports.controllerToGetByIdQuery %>';
+import { ZodValidationPipe } from '../../core/pipes/zod-validation.pipe';
+import { <%= className %> } from '<%= imports.controllerToDomain %>';
+
+@Controller('<%= plural %>')
+@UseGuards(AuthGuard)
+export class <%= classNamePlural %>Controller {
+	constructor(
+		private readonly electricService: ElectricService,
+		private readonly get<%= className %>ByIdQuery: <%= getByIdQueryClass %>,
+		private readonly create<%= className %>Command: <%= createCommandClass %>,
+		private readonly update<%= className %>Command: <%= updateCommandClass %>,
+		private readonly delete<%= className %>Command: <%= deleteCommandClass %>,
+	) {}
+
+	@Get()
+	async findAll(
+		@CurrentUser() user: User,
+		@Req() req: Request,
+		@Res() res: Response,
+	): Promise<void> {
+		return this.electricService.proxyRequest({
+			req,
+			res,
+			table: '<%= table %>',
+			columns: <%= plural %>Columns,
+			where: `"<%= electricWhereColumn %>" = '${<%= electricWhereValue %>}'`,
+		});
+	}
+
+	@Get(':id')
+	async findById(@Param('id', ParseUUIDPipe) id: string): Promise<<%= className %>> {
+		return this.get<%= className %>ByIdQuery.execute(id);
+	}
+
+	@Post()
+	@UsePipes(new ZodValidationPipe(create<%= className %>Schema))
+	async create(@Body() dto: Create<%= className %>Dto): Promise<<%= className %>> {
+		return this.create<%= className %>Command.execute(dto);
+	}
+
+	@Put(':id')
+	async update(
+		@Param('id', ParseUUIDPipe) id: string,
+		@Body(new ZodValidationPipe(update<%= className %>Schema)) dto: Update<%= className %>Dto,
+	): Promise<<%= className %>> {
+		return this.update<%= className %>Command.execute(id, dto);
+	}
+
+	@Delete(':id')
+	async delete(@Param('id', ParseUUIDPipe) id: string): Promise<<%= className %>> {
+		return this.delete<%= className %>Command.execute(id);
+	}
+}
+<% } -%>

package/templates/entity/new/clean-lite-ps/controller.ejs.t

@@ -0,0 +1,37 @@
+---
+to: "<%= typeof clpOutputPaths !== 'undefined' ? clpOutputPaths.controller : null %>"
+skip_if: "<%= typeof clpOutputPaths === 'undefined' %>"
+force: true
+---
+import { Controller, Get, Param } from '@nestjs/common';
+import { <%= classNames.findByIdUseCase %> } from './use-cases/find-<%= entityName %>-by-id.use-case';
+import { <%= classNames.listUseCase %> } from './use-cases/list-<%= entityNamePlural %>.use-case';
+import type { <%= classNames.entity %> } from './<%= entityName %>.entity';
+// Write use cases must be hand-written. Import them here when ready.
+
+@Controller('<%= entityNamePlural %>')
+export class <%= classNames.controller %> {
+  constructor(
+    // All routes go through use cases (ADR-003 — no controller → service shortcuts)
+    private readonly findByIdUseCase: <%= classNames.findByIdUseCase %>,
+    private readonly listUseCase: <%= classNames.listUseCase %>,
+    // TODO: inject hand-written write use cases here
+  ) {}
+
+  @Get()
+  async getAll(): Promise<<%= classNames.entity %>[]> {
+    return this.listUseCase.execute();
+  }
+
+  @Get(':id')
+  async getById(@Param('id') id: string): Promise<<%= classNames.entity %> | null> {
+    return this.findByIdUseCase.execute(id);
+  }
+
+  // TODO: Add write routes. Each must call a hand-written use case, not the service.
+  // Example:
+  // @Post()
+  // async create(@Body() dto: Create<%= classNames.entity %>Dto): Promise<<%= classNames.entity %>> {
+  //   return this.createUseCase.execute(dto);
+  // }
+}

package/templates/entity/new/clean-lite-ps/dto/create.ejs.t

@@ -0,0 +1,17 @@
+---
+to: "<%= typeof clpOutputPaths !== 'undefined' ? clpOutputPaths.createDto : null %>"
+skip_if: "<%= typeof clpOutputPaths === 'undefined' %>"
+force: true
+---
+import { z } from 'zod';
+
+export const <%= classNames.createSchema %> = z.object({
+<%_ clpBelongsToFkFields.forEach(fk => { _%>
+  <%= fk.camelName %>: <%- fk.zodChainCreate %>,
+<%_ }) _%>
+<%_ clpCreateDtoFields.forEach(field => { _%>
+  <%= field.camelName %>: <%- field.zodChainCreate %>,
+<%_ }) _%>
+});
+
+export type <%= classNames.createDto %> = z.infer<typeof <%= classNames.createSchema %>>;

package/templates/entity/new/clean-lite-ps/dto/output.ejs.t

@@ -0,0 +1,25 @@
+---
+to: "<%= typeof clpOutputPaths !== 'undefined' ? clpOutputPaths.outputDto : null %>"
+skip_if: "<%= typeof clpOutputPaths === 'undefined' %>"
+force: true
+---
+import { z } from 'zod';
+
+export const <%= classNames.outputSchema %> = z.object({
+  id: z.string().uuid(),
+<%_ clpBelongsToFkFields.forEach(fk => { _%>
+  <%= fk.camelName %>: <%- fk.zodChainOutput %>,
+<%_ }) _%>
+<%_ clpOutputDtoFields.forEach(field => { _%>
+  <%= field.camelName %>: <%- field.zodChainOutput %>,
+<%_ }) _%>
+<%_ if (hasTimestamps) { _%>
+  createdAt: z.coerce.date(),
+  updatedAt: z.coerce.date(),
+<%_ } _%>
+<%_ if (hasSoftDelete) { _%>
+  deletedAt: z.coerce.date().nullable(),
+<%_ } _%>
+});
+
+export type <%= classNames.outputDto %> = z.infer<typeof <%= classNames.outputSchema %>>;

package/templates/entity/new/clean-lite-ps/dto/update.ejs.t

@@ -0,0 +1,11 @@
+---
+to: "<%= typeof clpOutputPaths !== 'undefined' ? clpOutputPaths.updateDto : null %>"
+skip_if: "<%= typeof clpOutputPaths === 'undefined' %>"
+force: true
+---
+import { z } from 'zod';
+import { <%= classNames.createSchema %> } from './create-<%= entityName %>.dto';
+
+export const <%= classNames.updateSchema %> = <%= classNames.createSchema %>.partial();
+
+export type <%= classNames.updateDto %> = z.infer<typeof <%= classNames.updateSchema %>>;

package/templates/entity/new/clean-lite-ps/entity.ejs.t

@@ -0,0 +1,52 @@
+---
+to: "<%= typeof clpOutputPaths !== 'undefined' ? clpOutputPaths.entity : null %>"
+skip_if: "<%= typeof clpOutputPaths === 'undefined' %>"
+force: true
+---
+import {
+<%_ clpDrizzleImports.filter(i => i !== 'relations').forEach(i => { _%>
+  <%= i %>,
+<%_ }) _%>
+} from 'drizzle-orm/pg-core';
+<%_ if (clpHasRelationsBlock) { _%>
+import { relations, type InferSelectModel } from 'drizzle-orm';
+<%_ } else { _%>
+import { type InferSelectModel } from 'drizzle-orm';
+<%_ } _%>
+<%_ clpBelongsTo.forEach(rel => { _%>
+import { <%= rel.relatedTable %> } from '<%= rel.importPath %>';
+<%_ }) _%>
+
+export const <%= entityNamePlural %> = pgTable(
+  '<%= entityNamePlural %>',
+  {
+    id: uuid('id').primaryKey().defaultRandom(),
+<%_ clpBelongsTo.forEach(rel => { _%>
+    <%= rel.camelField %>: uuid('<%= rel.field %>')<%= rel.nullable ? '' : '.notNull()' %>,
+<%_ }) _%>
+<%_ clpProcessedFields.forEach(field => { _%>
+    <%= field.camelName %>: <%- field.drizzleChain %>,
+<%_ }) _%>
+<%_ if (hasTimestamps) { _%>
+    createdAt: timestamp('created_at').notNull().defaultNow(),
+    updatedAt: timestamp('updated_at').notNull().defaultNow(),
+<%_ } _%>
+<%_ if (hasSoftDelete) { _%>
+    deletedAt: timestamp('deleted_at'),
+<%_ } _%>
+  },
+);
+<%_ if (clpHasRelationsBlock) { _%>
+
+export const <%= entityNamePlural %>Relations = relations(<%= entityNamePlural %>, ({ one }) => ({
+<%_ clpBelongsTo.forEach(rel => { _%>
+  <%= rel.relatedEntity %>: one(<%= rel.relatedTable %>, {
+    fields: [<%= entityNamePlural %>.<%= rel.camelField %>],
+    references: [<%= rel.relatedTable %>.id],
+  }),
+<%_ }) _%>
+}));
+<%_ } _%>
+
+export type <%= classNames.entity %> = InferSelectModel<typeof <%= entityNamePlural %>>;
+export type <%= classNames.entity %>Insert = typeof <%= entityNamePlural %>.$inferInsert;

package/templates/entity/new/clean-lite-ps/index.ejs.t

@@ -0,0 +1,20 @@
+---
+to: "<%= typeof clpOutputPaths !== 'undefined' ? `modules/${entityNamePlural}/index.ts` : null %>"
+skip_if: "<%= typeof clpOutputPaths === 'undefined' %>"
+force: true
+---
+/**
+ * <%= classNames.entity %> module barrel export
+ * Generated by entity codegen - do not edit directly
+ */
+
+// Value exports (module, service, controller)
+export { <%= classNames.module %> } from './<%= entityNamePlural %>.module';
+export { <%= classNames.service %> } from './<%= entityName %>.service';
+export { <%= classNames.controller %> } from './<%= entityName %>.controller';
+
+// Type-only exports (entity, DTOs)
+export type { <%= classNames.entity %> } from './<%= entityName %>.entity';
+export type { <%= classNames.createDto %> } from './dto/create-<%= entityName %>.dto';
+export type { <%= classNames.updateDto %> } from './dto/update-<%= entityName %>.dto';
+export type { <%= classNames.outputDto %> } from './dto/<%= entityName %>-output.dto';

package/templates/entity/new/clean-lite-ps/module.ejs.t

@@ -0,0 +1,43 @@
+---
+to: "<%= typeof clpOutputPaths !== 'undefined' ? clpOutputPaths.module : null %>"
+skip_if: "<%= typeof clpOutputPaths === 'undefined' %>"
+force: true
+---
+import { Module } from '@nestjs/common';
+import { DatabaseModule } from '@shared/database/database.module';
+<%_ clpBelongsTo.forEach(rel => { _%>
+// import { <%= rel.relatedEntityPascal %>sModule } from '../<%= rel.relatedPlural %>/<%= rel.relatedPlural %>.module';
+<%_ }) _%>
+
+import { <%= classNames.repository %> } from './<%= entityName %>.repository';
+import { <%= classNames.service %> } from './<%= entityName %>.service';
+import { <%= classNames.controller %> } from './<%= entityName %>.controller';
+import { <%= classNames.findByIdUseCase %> } from './use-cases/find-<%= entityName %>-by-id.use-case';
+import { <%= classNames.listUseCase %> } from './use-cases/list-<%= entityNamePlural %>.use-case';
+<% if (hasDeclarativeQueries) { -%>
+import { declarativeQueryClasses } from './use-cases/declarative-queries';
+<% } -%>
+
+@Module({
+  imports: [
+    DatabaseModule,
+    // TODO: Add subsystem modules as needed (EventsSubsystemModule, IntegrationsSubsystemModule, etc.)
+    // Cross-domain modules from relationships:
+<%_ clpBelongsTo.forEach(rel => { _%>
+    // <%= rel.relatedEntityPascal %>sModule,
+<%_ }) _%>
+  ],
+  controllers: [<%= classNames.controller %>],
+  providers: [
+    <%= classNames.repository %>,
+    <%= classNames.service %>,
+    <%= classNames.findByIdUseCase %>,
+    <%= classNames.listUseCase %>,
+<% if (hasDeclarativeQueries) { -%>
+    ...declarativeQueryClasses,
+<% } -%>
+    // TODO: Register hand-written use cases here
+  ],
+  exports: [<%= classNames.service %>],  // Only service is exported (ADR-002)
+})
+export class <%= classNames.module %> {}