@pattern-stack/codegen 0.2.0

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

@@ -0,0 +1,34 @@
+---
+to: "<%= typeof clpOutputPaths !== 'undefined' ? clpOutputPaths.service : null %>"
+skip_if: "<%= typeof clpOutputPaths === 'undefined' %>"
+force: true
+---
+import { Injectable, Inject, Optional } from '@nestjs/common';
+import { WithAnalytics } from '@shared/base-classes/with-analytics';
+import { EVENT_BUS } from '@shared/constants/tokens';
+import { <%= serviceBaseClass %> } from '<%= serviceBaseImport %>';
+import { <%= classNames.repository %> } from './<%= entityName %>.repository';
+import type { <%= classNames.entity %> } from './<%= entityName %>.entity';
+
+@Injectable()
+export class <%= classNames.service %> extends WithAnalytics(
+  <%= serviceBaseClass %><<%= classNames.repository %>, <%= classNames.entity %>>,
+) {
+  protected override readonly entityName = '<%= entityName %>';
+
+  /** Injected by NestJS when EventsModule is registered. */
+  @Optional() @Inject(EVENT_BUS)
+  protected override eventBus: any = undefined;
+
+  constructor(protected readonly repository: <%= classNames.repository %>) {
+    super(repository);
+  }
+
+  // Lifecycle events (created/updated/deleted + per-field changes) are emitted
+  // automatically by BaseService when the events subsystem is installed.
+  //
+  // Inherited from <%= serviceBaseClass %>:
+<%_ serviceInheritedMethods.forEach(line => { _%>
+  //   <%= line %>
+<%_ }) _%>
+}

package/templates/entity/new/clean-lite-ps/use-cases/declarative-queries.ejs.t

@@ -0,0 +1,34 @@
+---
+to: "<%= (typeof clpOutputPaths !== 'undefined' && hasDeclarativeQueries) ? clpOutputPaths.declarativeQueries : null %>"
+force: true
+---
+<% if (hasDeclarativeQueries) { -%>
+/**
+ * Declarative Query Use Cases for <%= classNames.entity %>
+ * Generated from queries: block in entity YAML — do not edit directly.
+ *
+ * Each query is an injectable use case class that delegates to the repository.
+ * Register all via `declarativeQueryClasses` in the module providers.
+ */
+
+import { Injectable } from '@nestjs/common';
+import { <%= classNames.repository %> } from '../<%= entityName %>.repository';
+import type { <%= classNames.entity %> } from '../<%= entityName %>.entity';
+
+<% processedQueries.forEach((q) => { -%>
+@Injectable()
+export class <%= q.useCaseClassName %> {
+  constructor(private readonly repository: <%= classNames.repository %>) {}
+
+  async execute(<%- q.params.map(p => `${p.camelName}: ${p.tsType}`).join(', ') %>): Promise<<%- q.returnType %>> {
+    return this.repository.<%= q.methodName %>(<%= q.params.map(p => p.camelName).join(', ') %>);
+  }
+}
+
+<% }) -%>
+export const declarativeQueryClasses = [
+<% processedQueries.forEach((q) => { -%>
+  <%= q.useCaseClassName %>,
+<% }) -%>
+];
+<% } -%>

package/templates/entity/new/clean-lite-ps/use-cases/find-by-id.ejs.t

@@ -0,0 +1,16 @@
+---
+to: "<%= typeof clpOutputPaths !== 'undefined' ? clpOutputPaths.findByIdUseCase : null %>"
+force: true
+---
+import { Injectable } from '@nestjs/common';
+import { <%= classNames.service %> } from '../<%= entityName %>.service';
+import type { <%= classNames.entity %> } from '../<%= entityName %>.entity';
+
+@Injectable()
+export class <%= classNames.findByIdUseCase %> {
+  constructor(private readonly service: <%= classNames.service %>) {}
+
+  async execute(id: string): Promise<<%= classNames.entity %> | null> {
+    return this.service.findById(id);
+  }
+}

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

@@ -0,0 +1,16 @@
+---
+to: "<%= typeof clpOutputPaths !== 'undefined' ? clpOutputPaths.listUseCase : null %>"
+force: true
+---
+import { Injectable } from '@nestjs/common';
+import { <%= classNames.service %> } from '../<%= entityName %>.service';
+import type { <%= classNames.entity %> } from '../<%= entityName %>.entity';
+
+@Injectable()
+export class <%= classNames.listUseCase %> {
+  constructor(private readonly service: <%= classNames.service %>) {}
+
+  async execute(): Promise<<%= classNames.entity %>[]> {
+    return this.service.list();
+  }
+}

package/templates/entity/new/frontend/_inject-entities-entry.ejs.t

@@ -0,0 +1,7 @@
+---
+inject: true
+to: "<%= frontendEnabled ? `${locations.frontendEntities.path}/index.ts` : '' %>"
+after: "// \\[CODEGEN:ENTITY_ENTRIES\\]"
+skip_if: "<%= plural %>,"
+---
+  <%= plural %>,

package/templates/entity/new/frontend/_inject-entities-import.ejs.t

@@ -0,0 +1,7 @@
+---
+inject: true
+to: "<%= frontendEnabled ? `${locations.frontendEntities.path}/index.ts` : '' %>"
+after: "// \\[CODEGEN:ENTITY_IMPORTS\\]"
+skip_if: "from './<%= name %>'"
+---
+import { <%= plural %> } from './<%= name %>';

package/templates/entity/new/frontend/collections/_ensure-anchor-collections.ejs.t

@@ -0,0 +1,10 @@
+---
+to: "<%= frontendEnabled ? (generate.collections ? `${locations.frontendCollections.path}/collections.ts` : '') : '' %>"
+inject: true
+append: true
+skip_if: "// Codegen collections"
+---
+<% if (generate.collections) { -%>
+
+// Codegen collections
+<% } -%>

package/templates/entity/new/frontend/collections/_inject-index.ejs.t

@@ -0,0 +1,9 @@
+---
+to: "<%= frontendEnabled ? (generate.collectionsIndex ? `${locations.frontendCollections.path}/index.ts` : '') : '' %>"
+inject: true
+after: "// Generated entity collections"
+skip_if: "from './collections'"
+---
+<% if (generate.collectionsIndex) { -%>
+export * from './collections';
+<% } -%>

package/templates/entity/new/frontend/collections/_inject-schema-import.ejs.t

@@ -0,0 +1,9 @@
+---
+to: "<%= frontendEnabled ? (generate.collections && !frontend.collections?.schemaPrefix ? `${locations.frontendCollections.path}/collections.ts` : '') : '' %>"
+inject: true
+after: "// Codegen schema imports"
+skip_if: <%= camelName %>Schema
+---
+<% if (generate.collections && !frontend.collections?.schemaPrefix) { -%>
+	<%= camelName %>Schema,
+<% } -%>

package/templates/entity/new/frontend/collections/collection.ejs.t

@@ -0,0 +1,61 @@
+---
+to: "<%= frontendEnabled ? (generate.collections ? `${locations.frontendCollections.path}/collections.ts` : '') : '' %>"
+inject: true
+after: "// Codegen collections"
+skip_if: <%= camelName %>Collection
+---
+<% if (generate.collections) { -%>
+<%
+// Determine the URL expression based on config
+const hasApiBaseUrl = !!frontend.sync.apiBaseUrlImport;
+// For the URL path, use API_BASE_URL if configured
+const shapeUrlExpr = hasApiBaseUrl
+  ? '`${API_BASE_URL}/' + plural + '`'
+  : '`' + frontend.sync.shapeUrl + '/' + plural + '`';
+-%>
+export const <%= camelName %>Collection = createCollection(
+	electricCollectionOptions({
+		id: '<%= plural %>',
+		shapeOptions: {
+<% if (frontend.sync.useTableParam) { -%>
+			url: new URL(
+				'<%= frontend.sync.shapeUrl %>',
+				window.location.origin,
+			).toString(),
+			params: {
+				table: '<%= plural %>',
+			},
+<% } else { -%>
+<% if (frontend.sync.wrapInUrlConstructor !== false) { -%>
+			url: new URL(
+				<%- shapeUrlExpr %>,
+				window.location.origin,
+			).toString(),
+<% } else { -%>
+			url: <%- shapeUrlExpr %>,
+<% } -%>
+<% } -%>
+<% if (frontend.auth.function) { -%>
+			headers: {
+				Authorization: <%= frontend.auth.function %>(),
+			},
+<% } -%>
+			parser: {
+<% Object.entries(frontend.parsers).forEach(([type, fn]) => { -%>
+				<%- type %>: <%- fn %>,
+<% }); -%>
+			},
+<% if (frontend.sync.columnMapper) { -%>
+<% if (frontend.sync.columnMapperNeedsCall !== false) { -%>
+			columnMapper: <%= frontend.sync.columnMapper %>(),
+<% } else { -%>
+			columnMapper: <%= frontend.sync.columnMapper %>,
+<% } -%>
+<% } -%>
+		},
+<% const schemaPrefix = frontend.collections?.schemaPrefix ?? 'schema.'; -%>
+		schema: <%= schemaPrefix %><%= camelName %>Schema,
+		getKey: (item) => item.id,
+	}),
+);
+<% } -%>

package/templates/entity/new/frontend/collections/collections-base.ejs.t

@@ -0,0 +1,24 @@
+---
+to: <%= locations.frontendCollections.path %>/collections.ts
+skip_if: <%= !frontendEnabled %>
+force: false
+---
+/**
+ * Electric SQL Collections
+ * Generated by entity codegen - do not edit directly
+ */
+
+import { electricCollectionOptions } from '@tanstack/electric-db-collection';
+import { createCollection } from '@tanstack/react-db';
+<% if (frontend.sync.columnMapper) { -%>
+import { <%= frontend.sync.columnMapper %> } from '@electric-sql/client';
+<% } -%>
+<% if (frontend.auth.function) { -%>
+import { <%= frontend.auth.function %> } from '<%= locations.frontendCollectionsAuth.import %>';
+<% } -%>
+<% if (frontend.sync.apiBaseUrlImport) { -%>
+import { API_BASE_URL } from '<%= frontend.sync.apiBaseUrlImport %>';
+<% } -%>
+import * as schema from '<%= locations.dbSchemaClient.import %>';
+
+// Codegen collections

package/templates/entity/new/frontend/entity/collection.ejs.t

@@ -0,0 +1,172 @@
+---
+to: "<%= generate.structure === 'entity-first' ? `${locations.frontendGenerated.path}/${generate.fileNaming === 'plural' ? plural : name}/collection.ts` : generate.structure === 'concern-first' ? `${locations.frontendGenerated.path}/collections/${generate.fileNaming === 'plural' ? plural : name}.ts` : '' %>"
+skip_if: <%= !frontendEnabled || (generate.structure === 'monolithic') %>
+force: true
+---
+/**
+ * <%= className %> Collection
+ * Generated by entity codegen - do not edit directly
+ *
+ * Real-time synced collection using Electric SQL
+ */
+
+<% if (frontend.sync.columnMapper) { -%>
+import { <%= frontend.sync.columnMapper %> } from '@electric-sql/client';
+<% } -%>
+import { <%= camelName %>Schema } from '<%= locations.dbEntities.import %><% if (!locations.dbEntities.barrelExport) { %>/<%= name %><% } %>';
+<% if (exposeTrpc) { -%>
+import { trpc } from '<%= locations.trpcClient.import %>';
+<% } -%>
+import { electricCollectionOptions } from '@tanstack/electric-db-collection';
+import { createCollection } from '@tanstack/react-db';
+<% if (frontend.auth.function) { -%>
+import { <%= frontend.auth.function %> } from '<%= locations.frontendCollectionsAuth.import %>';
+<% } -%>
+<% if (frontend.sync.apiBaseUrlImport) { -%>
+import { API_BASE_URL } from '<%= frontend.sync.apiBaseUrlImport %>';
+<% } -%>
+<%
+// Collection variable name depends on collectionNaming config
+const collectionVar = generate.collectionNaming === 'plural' ? collectionVarNamePlural : collectionVarName;
+// File name for imports depends on fileNaming config
+const fileName = generate.fileNaming === 'plural' ? plural : name;
+-%>
+<% if (hasSoftDelete) { -%>
+
+// TODO: Backend Electric shape endpoint should filter soft-deleted records
+// by including WHERE deleted_at IS NULL in the shape configuration.
+// Without this filter, soft-deleted records will reappear after Electric sync.
+<% } -%>
+
+export const <%= collectionVar %> = createCollection(
+	electricCollectionOptions({
+		id: '<%= plural %>',
+		shapeOptions: {
+<% if (frontend.sync.useTableParam) { -%>
+<% if (frontend.sync.wrapInUrlConstructor !== false) { -%>
+			url: new URL(
+				'<%= frontend.sync.shapeUrl %>',
+				typeof window !== 'undefined'
+					? window.location.origin
+					: 'http://localhost:5173',
+			).toString(),
+<% } else { -%>
+			url: '<%= frontend.sync.shapeUrl %>',
+<% } -%>
+			params: {
+				table: '<%= plural %>',
+			},
+<% } else { -%>
+<% if (frontend.sync.wrapInUrlConstructor !== false) { -%>
+			url: new URL(
+				`<%= frontend.sync.shapeUrl %>/<%= plural %>`,
+				typeof window !== 'undefined'
+					? window.location.origin
+					: 'http://localhost:5173',
+			).toString(),
+<% } else { -%>
+			url: `<%= frontend.sync.shapeUrl %>/<%= plural %>`,
+<% } -%>
+<% } -%>
+<% if (frontend.auth.function) { -%>
+			headers: {
+				Authorization: <%= frontend.auth.function %>(),
+			},
+<% } -%>
+			parser: {
+<% Object.entries(frontend.parsers).forEach(([type, fn]) => { -%>
+				<%- type %>: <%- fn %>,
+<% }); -%>
+			},
+<% if (frontend.sync.columnMapper) { -%>
+<% if (frontend.sync.columnMapperNeedsCall !== false) { -%>
+			columnMapper: <%= frontend.sync.columnMapper %>(),
+<% } else { -%>
+			columnMapper: <%= frontend.sync.columnMapper %>,
+<% } -%>
+<% } -%>
+		},
+		schema: <%= camelName %>Schema,
+		getKey: (item) => item.id,
+<% if (generate.mutations && (exposeTrpc || exposeRepository)) { -%>
+<% if (exposeTrpc) { -%>
+		onInsert: async ({ transaction }) => {
+			const { modified } = transaction.mutations[0];
+			const result = await trpc.<%= plural %>.create.mutate(modified);
+			return { txid: result.txid };
+		},
+		onUpdate: async ({ transaction }) => {
+			const { modified } = transaction.mutations[0];
+			const result = await trpc.<%= plural %>.update.mutate({ id: modified.id, data: modified });
+			return { txid: result.txid };
+		},
+		onDelete: async ({ transaction }) => {
+			const { original } = transaction.mutations[0];
+			const result = await trpc.<%= plural %>.delete.mutate({ id: original.id });
+			return { txid: result.txid };
+		},
+<% } -%>
+<% } -%>
+	}),
+);
+<%
+// Collect unique belongs_to targets for imports (FK resolution)
+// Only import if fkResolution is enabled (default: true)
+const importedEntities = new Set();
+if (generate.fkResolution !== false) {
+  existingBelongsTo.forEach((rel) => {
+    if (rel.target !== name) {
+      importedEntities.add(rel.target);
+    }
+  });
+}
+-%>
+<% if (importedEntities.size > 0) { -%>
+
+// Import related collections for FK resolution
+<% importedEntities.forEach((target) => {
+  const targetCamel = target.replace(/_([a-z])/g, (_, c) => c.toUpperCase());
+  // Simple pluralization matching prompt.js pluralize function
+  const targetPlural = target.endsWith('y') ? target.slice(0, -1) + 'ies' :
+    (target.endsWith('s') || target.endsWith('x') || target.endsWith('ch') || target.endsWith('sh')) ? target + 'es' : target + 's';
+  const targetFileName = generate.fileNaming === 'plural' ? targetPlural : target;
+  const targetCamelPlural = targetCamel.endsWith('y') ? targetCamel.slice(0, -1) + 'ies' : targetCamel + 's';
+-%>
+import { <%= generate.collectionNaming === 'plural' ? targetCamelPlural : targetCamel %>Collection } from '<% if (generate.structure === 'entity-first') { %>./<%= targetFileName %>/collection<% } else { %>./<%= targetFileName %><% } %>';
+<% }); -%>
+<% } -%>
+<% if (generate.structure === 'entity-first') { -%>
+
+// Import types from sibling module
+import type { <%= className %>, <%= className %>Resolved } from './types';
+<% } else { -%>
+
+// Import types
+import type { <%= className %>, <%= className %>Resolved } from '<% if (generate.structure === 'concern-first') { %>../types/<%= fileName %><% } %>';
+<% } -%>
+
+// ============================================================================
+// Resolution (FK lookup - internal use)
+// ============================================================================
+<% if (existingBelongsTo.length > 0 && generate.fkResolution !== false) { -%>
+
+export function resolveRelations(entity: <%= className %>): <%= className %>Resolved {
+	return {
+		...entity,
+<% existingBelongsTo.forEach((rel) => {
+  const targetCamel = rel.target.replace(/_([a-z])/g, (_, c) => c.toUpperCase());
+  const targetCamelPlural = targetCamel.endsWith('y') ? targetCamel.slice(0, -1) + 'ies' : targetCamel + 's';
+  const targetCollectionVar = generate.collectionNaming === 'plural' ? targetCamelPlural : targetCamel;
+-%>
+		<%= rel.name %>: entity.<%= rel.foreignKeyCamel %>
+			? <%= targetCollectionVar %>Collection.state.get(entity.<%= rel.foreignKeyCamel %>)
+			: undefined,
+<% }); -%>
+	};
+}
+<% } else { -%>
+
+export function resolveRelations(entity: <%= className %>): <%= className %>Resolved {
+	return entity;
+}
+<% } -%>