@vertz/codegen 0.2.11 → 0.2.13

package/dist/index.d.ts

@@ -138,10 +138,16 @@ interface SchemaNamingParts {
 	entity?: string;
 	part?: string;
 }
+interface CodegenRelation {
+	name: string;
+	type: "one" | "many";
+	entity: string;
+}
 interface CodegenEntityModule {
 	entityName: string;
 	operations: CodegenEntityOperation[];
 	actions: CodegenEntityAction[];
+	relations?: CodegenRelation[];
 }
 interface CodegenEntityOperation {
 	kind: "list" | "get" | "create" | "update" | "delete";
@@ -273,6 +279,14 @@ declare class EntityTypesGenerator implements Generator {
 	private emitResponseType;
 	private generateIndex;
 }
+interface RelationManifestEntry {
+	entityType: string;
+	schema: Record<string, {
+		type: "one" | "many";
+		entity: string;
+	}>;
+}
+declare function generateRelationManifest(entities: CodegenEntityModule[]): RelationManifestEntry[];
 /**
 * Returns a SHA-256 hex hash of the given content string.
 * Used for comparing generated file content against what is already on disk.
@@ -302,4 +316,4 @@ declare function toPascalCase(input: string): string;
 declare function toCamelCase(input: string): string;
 declare function toKebabCase(input: string): string;
 declare function toSnakeCase(input: string): string;
-export { writeIncremental, validateCodegenConfig, toSnakeCase, toPascalCase, toKebabCase, toCamelCase, resolveCodegenConfig, renderImports, mergeImportsToPackageJson, mergeImports, jsonSchemaToTS, hashContent, generate, formatWithBiome, defineCodegenConfig, createCodegenPipeline, adaptIR, StreamingConfig, SchemaNamingParts, SchemaAnnotations, ResolvedCodegenConfig, OperationSchemaRefs, OperationAuth, OAuthFlows, JsonSchema, IncrementalResult, IncrementalOptions, Import, HttpMethod, GeneratorName, GeneratorConfig, Generator, GeneratedFile, GenerateResult, FileFragment, EntityTypesGenerator, EntitySdkGenerator, EntitySchemaGenerator, ConversionResult, ConversionContext, CodegenTypescriptConfig, CodegenSchema, CodegenResolvedField, CodegenPublishableConfig, CodegenPipeline, CodegenOperation, CodegenModule, CodegenIR, CodegenEntityOperation, CodegenEntityModule, CodegenEntityAction, CodegenConfig, CodegenAuthScheme, CodegenAuth, ClientGenerator };
+export { writeIncremental, validateCodegenConfig, toSnakeCase, toPascalCase, toKebabCase, toCamelCase, resolveCodegenConfig, renderImports, mergeImportsToPackageJson, mergeImports, jsonSchemaToTS, hashContent, generateRelationManifest, generate, formatWithBiome, defineCodegenConfig, createCodegenPipeline, adaptIR, StreamingConfig, SchemaNamingParts, SchemaAnnotations, ResolvedCodegenConfig, RelationManifestEntry, OperationSchemaRefs, OperationAuth, OAuthFlows, JsonSchema, IncrementalResult, IncrementalOptions, Import, HttpMethod, GeneratorName, GeneratorConfig, Generator, GeneratedFile, GenerateResult, FileFragment, EntityTypesGenerator, EntitySdkGenerator, EntitySchemaGenerator, ConversionResult, ConversionContext, CodegenTypescriptConfig, CodegenSchema, CodegenResolvedField, CodegenRelation, CodegenPublishableConfig, CodegenPipeline, CodegenOperation, CodegenModule, CodegenIR, CodegenEntityOperation, CodegenEntityModule, CodegenEntityAction, CodegenConfig, CodegenAuthScheme, CodegenAuth, ClientGenerator };

package/dist/index.js

@@ -139,6 +139,17 @@ function toSnakeCase(input) {
   return splitWords(input).map((w) => w.toLowerCase()).join("_");
 }
 
+// src/generators/relation-manifest-generator.ts
+function generateRelationManifest(entities) {
+  return entities.map((entity) => {
+    const schema = {};
+    for (const rel of entity.relations ?? []) {
+      schema[rel.name] = { type: rel.type, entity: rel.entity };
+    }
+    return { entityType: entity.entityName, schema };
+  });
+}
+
 // src/generators/client-generator.ts
 var FILE_HEADER = `// Generated by @vertz/codegen — do not edit
 
@@ -155,29 +166,70 @@ class ClientGenerator {
   }
   generateClient(ir) {
     const entities = ir.entities ?? [];
+    const hasMutations = entities.some((e) => e.operations.some((op) => op.kind === "update" || op.kind === "delete"));
+    const manifest = generateRelationManifest(entities);
+    const hasRelations = manifest.some((entry) => Object.keys(entry.schema).length > 0);
     const lines = [FILE_HEADER];
     if (entities.length > 0) {
-      lines.push("import { FetchClient } from '@vertz/fetch';");
+      if (hasMutations) {
+        lines.push("import { FetchClient, type OptimisticHandler } from '@vertz/fetch';");
+        if (hasRelations) {
+          lines.push("import { createOptimisticHandler, getEntityStore, registerRelationSchema } from '@vertz/ui';");
+        } else {
+          lines.push("import { createOptimisticHandler, getEntityStore } from '@vertz/ui';");
+        }
+      } else {
+        lines.push("import { FetchClient } from '@vertz/fetch';");
+        if (hasRelations) {
+          lines.push("import { registerRelationSchema } from '@vertz/ui';");
+        }
+      }
       for (const entity of entities) {
         const pascal = toPascalCase(entity.entityName);
         lines.push(`import { create${pascal}Sdk } from './entities/${entity.entityName}';`);
       }
       lines.push("");
+      if (hasRelations) {
+        for (const entry of manifest) {
+          const schemaEntries = Object.entries(entry.schema);
+          if (schemaEntries.length === 0) {
+            lines.push(`registerRelationSchema('${entry.entityType}', {});`);
+          } else {
+            lines.push(`registerRelationSchema('${entry.entityType}', {`);
+            for (const [field, def] of schemaEntries) {
+              lines.push(`  ${field}: { type: '${def.type}', entity: '${def.entity}' },`);
+            }
+            lines.push("});");
+          }
+        }
+        lines.push("");
+      }
     }
     lines.push("export interface ClientOptions {");
     lines.push("  baseURL?: string;");
     lines.push("  headers?: Record<string, string>;");
     lines.push("  timeoutMs?: number;");
+    if (hasMutations) {
+      lines.push("  optimistic?: OptimisticHandler | false;");
+    }
     lines.push("}");
     lines.push("");
     lines.push("export function createClient(options: ClientOptions = {}) {");
     if (entities.length > 0) {
       lines.push(`  const client = new FetchClient({ baseURL: options.baseURL ?? '/api', headers: options.headers, timeoutMs: options.timeoutMs });`);
+      if (hasMutations) {
+        lines.push("  const optimistic = options.optimistic !== false ? (options.optimistic ?? createOptimisticHandler(getEntityStore())) : undefined;");
+      }
       lines.push("  return {");
       for (const entity of entities) {
         const pascal = toPascalCase(entity.entityName);
         const camel = toCamelCase(entity.entityName);
-        lines.push(`    ${camel}: create${pascal}Sdk(client),`);
+        const entityHasMutations = entity.operations.some((op) => op.kind === "update" || op.kind === "delete");
+        if (entityHasMutations) {
+          lines.push(`    ${camel}: create${pascal}Sdk(client, optimistic),`);
+        } else {
+          lines.push(`    ${camel}: create${pascal}Sdk(client),`);
+        }
       }
       lines.push("  };");
     } else {
@@ -379,6 +431,7 @@ class EntitySdkGenerator {
     }
     const hasTypes = entity.operations.some((op) => op.outputSchema || op.inputSchema);
     const hasListOp = entity.operations.some((op) => op.kind === "list");
+    const hasMutationOp = entity.operations.some((op) => op.kind === "update" || op.kind === "delete");
     if (hasTypes) {
       const typeImports = new Set;
       for (const op of entity.operations) {
@@ -394,11 +447,22 @@ class EntitySdkGenerator {
           typeImports.add(action.outputSchema);
       }
       lines.push(`import type { ${[...typeImports].join(", ")} } from '../types/${entity.entityName}';`);
-      const fetchImports = hasListOp ? "type FetchClient, type ListResponse, createDescriptor" : "type FetchClient, createDescriptor";
-      lines.push(`import { ${fetchImports} } from '@vertz/fetch';`);
+      const fetchImportParts = ["type FetchClient"];
+      if (hasListOp)
+        fetchImportParts.push("type ListResponse");
+      if (hasMutationOp)
+        fetchImportParts.push("type OptimisticHandler");
+      fetchImportParts.push("createDescriptor");
+      if (hasMutationOp)
+        fetchImportParts.push("createMutationDescriptor");
+      lines.push(`import { ${fetchImportParts.join(", ")} } from '@vertz/fetch';`);
       lines.push("");
     }
-    lines.push(`export function create${pascal}Sdk(client: FetchClient) {`);
+    if (hasMutationOp) {
+      lines.push(`export function create${pascal}Sdk(client: FetchClient, optimistic?: OptimisticHandler) {`);
+    } else {
+      lines.push(`export function create${pascal}Sdk(client: FetchClient) {`);
+    }
     lines.push("  return {");
     for (const op of entity.operations) {
       const inputType = op.inputSchema ?? "unknown";
@@ -407,13 +471,13 @@ class EntitySdkGenerator {
       switch (op.kind) {
         case "list":
           lines.push(`    list: Object.assign(`);
-          lines.push(`      (query?: Record<string, unknown>) => createDescriptor('GET', '${op.path}', () => client.get<${listOutput}>('${op.path}', { query }), query),`);
+          lines.push(`      (query?: Record<string, unknown>) => createDescriptor('GET', '${op.path}', () => client.get<${listOutput}>('${op.path}', { query }), query, { entityType: '${entity.entityName}', kind: 'list' as const }),`);
           lines.push(`      { url: '${op.path}', method: 'GET' as const },`);
           lines.push(`    ),`);
           break;
         case "get":
           lines.push(`    get: Object.assign(`);
-          lines.push(`      (id: string) => createDescriptor('GET', \`${op.path.replace(":id", "${id}")}\`, () => client.get<${outputType}>(\`${op.path.replace(":id", "${id}")}\`)),`);
+          lines.push(`      (id: string) => createDescriptor('GET', \`${op.path.replace(":id", "${id}")}\`, () => client.get<${outputType}>(\`${op.path.replace(":id", "${id}")}\`), undefined, { entityType: '${entity.entityName}', kind: 'get' as const, id }),`);
           lines.push(`      { url: '${op.path}', method: 'GET' as const },`);
           lines.push(`    ),`);
           break;
@@ -437,13 +501,13 @@ class EntitySdkGenerator {
           break;
         case "update":
           lines.push(`    update: Object.assign(`);
-          lines.push(`      (id: string, body: ${inputType}) => createDescriptor('PATCH', \`${op.path.replace(":id", "${id}")}\`, () => client.patch<${outputType}>(\`${op.path.replace(":id", "${id}")}\`, body)),`);
+          lines.push(`      (id: string, body: ${inputType}) => createMutationDescriptor('PATCH', \`${op.path.replace(":id", "${id}")}\`, () => client.patch<${outputType}>(\`${op.path.replace(":id", "${id}")}\`, body), { entityType: '${entity.entityName}', kind: 'update' as const, id, body }, optimistic),`);
           lines.push(`      { url: '${op.path}', method: 'PATCH' as const },`);
           lines.push(`    ),`);
           break;
         case "delete":
           lines.push(`    delete: Object.assign(`);
-          lines.push(`      (id: string) => createDescriptor('DELETE', \`${op.path.replace(":id", "${id}")}\`, () => client.delete<${outputType}>(\`${op.path.replace(":id", "${id}")}\`)),`);
+          lines.push(`      (id: string) => createMutationDescriptor('DELETE', \`${op.path.replace(":id", "${id}")}\`, () => client.delete<${outputType}>(\`${op.path.replace(":id", "${id}")}\`), { entityType: '${entity.entityName}', kind: 'delete' as const, id }, optimistic),`);
           lines.push(`      { url: '${op.path}', method: 'DELETE' as const },`);
           lines.push(`    ),`);
           break;
@@ -769,7 +833,13 @@ function adaptIR(appIR) {
         resolvedOutputFields
       };
     });
-    return { entityName: entity.name, operations, actions };
+    const resolvedRelations = entity.relations.filter((r) => !!r.type && !!r.entity).map((r) => ({ name: r.name, type: r.type, entity: r.entity }));
+    return {
+      entityName: entity.name,
+      operations,
+      actions,
+      relations: resolvedRelations.length > 0 ? resolvedRelations : undefined
+    };
   });
   return {
     basePath: appIR.app.basePath,
@@ -1056,6 +1126,7 @@ export {
   mergeImports,
   jsonSchemaToTS,
   hashContent,
+  generateRelationManifest,
   generate,
   formatWithBiome,
   defineCodegenConfig,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vertz/codegen",
-  "version": "0.2.11",
+  "version": "0.2.13",
   "type": "module",
   "license": "MIT",
   "description": "Vertz code generation — internal, no stability guarantee",
@@ -27,7 +27,7 @@
     "typecheck": "tsc --noEmit -p tsconfig.typecheck.json"
   },
   "dependencies": {
-    "@vertz/compiler": "^0.2.11"
+    "@vertz/compiler": "^0.2.12"
   },
   "devDependencies": {
     "@types/node": "^25.3.1",