@pattern-stack/codegen 0.2.0

package/templates/entity/new/frontend/entity/mutation-hooks.ejs.t

@@ -0,0 +1,84 @@
+---
+to: "<%= generate.structure === 'entity-first' ? `${locations.frontendGenerated.path}/${generate.fileNaming === 'plural' ? plural : name}/mutation-hooks.ts` : generate.structure === 'concern-first' ? `${locations.frontendGenerated.path}/mutation-hooks/${generate.fileNaming === 'plural' ? plural : name}.ts` : '' %>"
+skip_if: <%= !frontendEnabled || (generate.structure === 'monolithic' || !generate.mutations || !(exposeTrpc || exposeRepository)) %>
+force: true
+---
+/**
+ * <%= className %> Mutation Hooks
+ * Generated by entity codegen - do not edit directly
+ *
+ * React hooks wrapping mutation functions with error state management
+ */
+
+import { useState, useCallback } from 'react';
+<%
+// File name for imports depends on fileNaming config
+const fileName = generate.fileNaming === 'plural' ? plural : name;
+-%>
+<% if (generate.structure === 'entity-first') { -%>
+import { insert<%= className %>, update<%= className %>, delete<%= className %> } from './mutations';
+import type { <%= className %> } from './types';
+<% } else if (generate.structure === 'concern-first') { -%>
+import { insert<%= className %>, update<%= className %>, delete<%= className %> } from '../mutations/<%= fileName %>';
+import type { <%= className %> } from '../types/<%= fileName %>';
+<% } -%>
+
+type MutationHookResult<TFn extends (...args: any[]) => any> = {
+	mutate: TFn;
+	error: Error | null;
+	clearError: () => void;
+};
+
+export function useCreate<%= className %>(): MutationHookResult<typeof insert<%= className %>> {
+	const [error, setError] = useState<Error | null>(null);
+
+	const mutate = useCallback<typeof insert<%= className %>>((data) => {
+		try {
+			insert<%= className %>(data);
+			setError(null);
+		} catch (err) {
+			const error = err instanceof Error ? err : new Error(String(err));
+			setError(error);
+			throw error;
+		}
+	}, []);
+
+	const clearError = useCallback(() => setError(null), []);
+	return { mutate, error, clearError };
+}
+
+export function useUpdate<%= className %>(): MutationHookResult<typeof update<%= className %>> {
+	const [error, setError] = useState<Error | null>(null);
+
+	const mutate = useCallback<typeof update<%= className %>>((id, fn) => {
+		try {
+			update<%= className %>(id, fn);
+			setError(null);
+		} catch (err) {
+			const error = err instanceof Error ? err : new Error(String(err));
+			setError(error);
+			throw error;
+		}
+	}, []);
+
+	const clearError = useCallback(() => setError(null), []);
+	return { mutate, error, clearError };
+}
+
+export function useDelete<%= className %>(): MutationHookResult<typeof delete<%= className %>> {
+	const [error, setError] = useState<Error | null>(null);
+
+	const mutate = useCallback<typeof delete<%= className %>>((id) => {
+		try {
+			delete<%= className %>(id);
+			setError(null);
+		} catch (err) {
+			const error = err instanceof Error ? err : new Error(String(err));
+			setError(error);
+			throw error;
+		}
+	}, []);
+
+	const clearError = useCallback(() => setError(null), []);
+	return { mutate, error, clearError };
+}

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

@@ -0,0 +1,38 @@
+---
+to: "<%= generate.structure === 'entity-first' ? `${locations.frontendGenerated.path}/${name}/mutations.ts` : generate.structure === 'concern-first' ? `${locations.frontendGenerated.path}/mutations/${name}.ts` : '' %>"
+skip_if: <%= !frontendEnabled || (generate.structure === 'monolithic' || !generate.mutations || !(exposeTrpc || exposeRepository)) %>
+force: true
+---
+/**
+ * <%= className %> Mutations
+ * Generated by entity codegen - do not edit directly
+ *
+ * Optimistic update functions for <%= className %> entity
+ */
+
+<% if (generate.structure === 'entity-first') { -%>
+import { <%= camelName %>Collection } from './collection';
+import type { <%= className %> } from './types';
+<% } else if (generate.structure === 'concern-first') { -%>
+import { <%= camelName %>Collection } from '../collections/<%= name %>';
+import type { <%= className %> } from '../types/<%= name %>';
+<% } -%>
+
+export function insert<%= className %>(data: Omit<<%= className %>, 'id'<% if (hasTimestamps) { %> | 'createdAt' | 'updatedAt'<% } %>>) {
+	return <%= camelName %>Collection.insert({
+		id: crypto.randomUUID(),
+<% if (hasTimestamps) { -%>
+		createdAt: new Date(),
+		updatedAt: new Date(),
+<% } -%>
+		...data,
+	} as <%= className %>);
+}
+
+export function update<%= className %>(id: string, fn: (draft: <%= className %>) => void) {
+	return <%= camelName %>Collection.update(id, fn);
+}
+
+export function delete<%= className %>(id: string) {
+	return <%= camelName %>Collection.delete(id);
+}

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

@@ -0,0 +1,59 @@
+---
+to: "<%= generate.structure === 'entity-first' ? `${locations.frontendGenerated.path}/${generate.fileNaming === 'plural' ? plural : name}/types.ts` : generate.structure === 'concern-first' ? `${locations.frontendGenerated.path}/types/${generate.fileNaming === 'plural' ? plural : name}.ts` : '' %>"
+skip_if: <%= !frontendEnabled || (generate.structure === 'monolithic') %>
+force: true
+---
+/**
+ * <%= className %> Types
+ * Generated by entity codegen - do not edit directly
+ *
+ * Type definitions for <%= className %> entity with resolved relations
+ */
+
+<%
+// Type import: depends on typeNaming config
+// 'entity' = source exports OpportunityEntity, 'plain' = source exports Opportunity
+const importedTypeName = generate.typeNaming === 'plain' ? className : className + 'Entity';
+// 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);
+    }
+  });
+}
+-%>
+import type { <%= importedTypeName %> } from '<%= locations.dbEntities.import %><% if (!locations.dbEntities.barrelExport) { %>/<%= name %><% } %>';
+<% if (importedEntities.size > 0) { -%>
+
+// Import related entity types for FK resolution
+<% importedEntities.forEach((target) => {
+  const targetClass = target.charAt(0).toUpperCase() + target.slice(1).replace(/_([a-z])/g, (_, c) => c.toUpperCase());
+-%>
+import type { <%= generate.typeNaming === 'plain' ? targetClass : targetClass + 'Entity' %> } from '<%= locations.dbEntities.import %><% if (!locations.dbEntities.barrelExport) { %>/<%= target %><% } %>';
+<% }); -%>
+<% } -%>
+
+/** Base entity from database */
+<% if (generate.typeNaming === 'plain') { -%>
+export type { <%= className %> };
+<% } else { -%>
+export type <%= className %> = <%= importedTypeName %>;
+<% } -%>
+<% if (existingBelongsTo.length > 0 && generate.fkResolution !== false) { -%>
+
+/** Entity with resolved FK relations (only includes relations with existing targets) */
+export interface <%= className %>Resolved extends <%= className %> {
+<% existingBelongsTo.forEach((rel) => { -%>
+<% // Use local type for self-referential, imported type for others -%>
+<%   const relTypeName = rel.target === name ? className : (generate.typeNaming === 'plain' ? rel.targetClass : rel.targetClass + 'Entity'); -%>
+	<%= rel.name %>?: <%= relTypeName %>;
+<% }); -%>
+}
+<% } else { -%>
+
+/** Entity type (no FK relations to resolve) */
+export type <%= className %>Resolved = <%= className %>;
+<% } -%>

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

@@ -0,0 +1,7 @@
+---
+to: "<%= frontendEnabled ? `${locations.frontendGenerated.path}/index.ts` : '' %>"
+inject: true
+skip_if: "from './<%= name %>'"
+after: "// Entity exports"
+---
+export * from './<%= name %>';

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

@@ -0,0 +1,7 @@
+---
+to: "<%= frontendEnabled ? `${locations.frontendGenerated.path}/index.ts` : '' %>"
+inject: true
+skip_if: "import { <%= camelName %> }"
+after: "// Entity registry"
+---
+import { <%= camelName %> } from './<%= name %>';

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

@@ -0,0 +1,7 @@
+---
+to: "<%= frontendEnabled ? `${locations.frontendGenerated.path}/index.ts` : '' %>"
+inject: true
+skip_if: "<%= camelName %>,"
+after: "// registry-entries"
+---
+	<%= camelName %>,

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

@@ -0,0 +1,9 @@
+---
+to: "<%= frontendEnabled ? (generate.hooks ? `${locations.frontendStore.path}/index.ts` : '') : '' %>"
+inject: true
+after: "// Collection imports"
+skip_if: "from '<%= locations.frontendCollections.import %>/collections'"
+---
+<% if (generate.hooks) { -%>
+import { <%= collectionVarName %> } from '<%= locations.frontendCollections.import %>/collections';
+<% } -%>

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

@@ -0,0 +1,9 @@
+---
+to: "<%= frontendEnabled ? (generate.hooks ? `${locations.frontendStore.path}/index.ts` : '') : '' %>"
+inject: true
+after: "collections: \\{"
+skip_if: "<%= plural %>: <%= collectionVarName %>[^\\.]"
+---
+<% if (generate.hooks) { -%>
+    <%= plural %>: <%= collectionVarName %>,
+<% } -%>

package/templates/entity/new/frontend/store/_inject-entity.ejs.t

@@ -0,0 +1,9 @@
+---
+to: "<%= frontendEnabled ? (generate.hooks ? `${locations.frontendStore.path}/index.ts` : '') : '' %>"
+inject: true
+after: "entities: \\{"
+skip_if: "<%= plural %>: <%= camelName %>Hooks"
+---
+<% if (generate.hooks) { -%>
+    <%= plural %>: <%= camelName %>Hooks,
+<% } -%>

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

@@ -0,0 +1,9 @@
+---
+to: "<%= frontendEnabled ? (generate.hooks ? `${locations.frontendStore.path}/index.ts` : '') : '' %>"
+inject: true
+after: "// Entity hooks"
+skip_if: "from './entities/<%= name %>'"
+---
+<% if (generate.hooks) { -%>
+import { <%= camelName %>Hooks } from './entities/<%= name %>';
+<% } -%>

package/templates/entity/new/frontend/store/_inject-lookups.ejs.t

@@ -0,0 +1,9 @@
+---
+to: "<%= frontendEnabled ? (generate.hooks ? `${locations.frontendStore.path}/index.ts` : '') : '' %>"
+inject: true
+after: "// Lookup entries"
+skip_if: "<%= plural %>: <%= collectionVarName %>\\.state"
+---
+<% if (generate.hooks) { -%>
+      <%= plural %>: <%= collectionVarName %>.state,
+<% } -%>

package/templates/entity/new/frontend/store/_inject-resolve.ejs.t

@@ -0,0 +1,10 @@
+---
+to: "<%= frontendEnabled ? (generate.hooks ? `${locations.frontendStore.path}/index.ts` : '') : '' %>"
+inject: true
+after: "resolve: \\{"
+skip_if: "<%= singularCamelName %>:"
+---
+<% if (generate.hooks) { -%>
+    <%= singularCamelName %>: (id: string | null | undefined) =>
+      id ? <%= collectionVarName %>.get(id) : undefined,
+<% } -%>

package/templates/entity/new/frontend/store/hooks.ejs.t

@@ -0,0 +1,72 @@
+---
+to: <%= locations.frontendStoreEntities.path %>/<%= name %>.ts
+skip_if: <%= !frontendEnabled || (!generate.hooks) %>
+force: true
+---
+/**
+ * <%= className %> Entity Hooks
+ * Generated by entity codegen - do not edit directly
+ *
+ * Provides query and mutation hooks for <%= className %> entity.
+ */
+
+import { useLiveQuery } from '@tanstack/react-db';
+import { eq } from '@tanstack/react-db';
+import { <%= camelName %>Collection } from '<%= locations.frontendCollections.import %>/collections';
+<%
+const entityTypeName = generate.typeNaming === 'plain' ? className : className + 'Entity';
+-%>
+import type { <%= entityTypeName %> } from '<%= locations.dbEntities.import %>/<%= name %>';
+
+/**
+ * Hook to get all <%= plural %>
+ */
+export function use<%= className %>List() {
+	return useLiveQuery((q) => q.from({ <%= camelName %>Collection }), []);
+}
+
+/**
+ * Hook to get a single <%= camelName %> by ID
+ */
+export function use<%= className %>ById(id: string | undefined) {
+	return useLiveQuery(
+		(q) => {
+			if (!id) return undefined;
+			return q
+				.from({ <%= camelName %>Collection })
+				.where(({ <%= camelName %>Collection }) => eq(<%= camelName %>Collection.id, id));
+		},
+		[id],
+	);
+}
+
+/**
+ * Mutation functions for <%= className %>
+ */
+export const <%= camelName %>Mutations = {
+	insert: (data: Omit<<%= entityTypeName %>, 'id' | 'createdAt' | 'updatedAt'> & { id?: string }) => {
+		return <%= camelName %>Collection.insert({
+			id: data.id ?? crypto.randomUUID(),
+			...data,
+			createdAt: new Date(),
+			updatedAt: new Date(),
+		} as <%= entityTypeName %>);
+	},
+
+	update: (id: string, updater: (draft: <%= entityTypeName %>) => void) => {
+		return <%= camelName %>Collection.update(id, updater);
+	},
+
+	delete: (id: string) => {
+		return <%= camelName %>Collection.delete(id);
+	},
+};
+
+/**
+ * <%= className %> hooks bundle for store
+ */
+export const <%= camelName %>Hooks = {
+	useList: use<%= className %>List,
+	useById: use<%= className %>ById,
+	...<%=camelName %>Mutations,
+};

package/templates/entity/new/frontend/unified-entity.ejs.t

@@ -0,0 +1,28 @@
+---
+to: <%= locations.frontendEntities.path %>/<%= name %>.ts
+skip_if: <%= !frontendEnabled %>
+force: true
+---
+/**
+ * <%= className %> - Unified Entity API
+ *
+ * AUTO-GENERATED by entity codegen - do not edit directly.
+ * Combines hooks, metadata, and collection into single interface.
+ */
+
+import { createUnifiedEntity } from './create-unified-entity';
+import { <%= camelName %>Hooks } from '../store/entities/<%= name %>';
+import { <%= camelName %>Metadata } from '<%= locations.frontendEntityMetadata.import %>';
+import { <%= camelName %>Collection } from '<%= locations.frontendCollections.import %>/collections';
+import { store } from '../store';
+<%
+const entityTypeName = generate.typeNaming === 'plain' ? className : className + 'Entity';
+-%>
+import type { <%= entityTypeName %> } from '<%= locations.dbEntities.import %>/<%= name %>';
+
+export const <%= plural %> = createUnifiedEntity<<%= entityTypeName %>>({
+  hooks: <%= camelName %>Hooks,
+  metadata: <%= camelName %>Metadata,
+  collection: <%= camelName %>Collection,
+  resolve: store.resolve.<%= camelName %>,
+});