@eide/uniformgen 0.1.0

package/dist/generators/hooks/workflows.js

@@ -0,0 +1,312 @@
+/**
+ * Workflow Hooks Generator
+ *
+ * Generates typed React hooks for workflow execution using Apollo Client.
+ */
+/**
+ * Convert string to PascalCase
+ */
+function toPascalCase(str) {
+    return str
+        .split(/[-_]/)
+        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+        .join('');
+}
+/**
+ * Convert string to camelCase
+ */
+function toCamelCase(str) {
+    const pascal = toPascalCase(str);
+    return pascal.charAt(0).toLowerCase() + pascal.slice(1);
+}
+/**
+ * Generate React hooks for a single workflow
+ */
+export function generateWorkflowReactHooks(workflow) {
+    const typeName = toPascalCase(workflow.key);
+    const camelName = toCamelCase(workflow.key);
+    const lines = [];
+    // File header
+    lines.push('/**');
+    lines.push(` * ${workflow.name} - React Hooks`);
+    if (workflow.description) {
+        lines.push(` * ${workflow.description}`);
+    }
+    lines.push(' *');
+    lines.push(' * @generated by UniformGen - DO NOT EDIT MANUALLY');
+    lines.push(' */');
+    lines.push('');
+    // Imports
+    lines.push("import { useMutation, useQuery, type MutationHookOptions, type QueryHookOptions } from '@apollo/client';");
+    lines.push("import {");
+    lines.push("  PublicExecuteWorkflowDocument,");
+    lines.push("  PublicWorkflowExecutionDocument,");
+    lines.push("} from '../documents/workflows.js';");
+    lines.push(`import type { ${typeName}Input, ${typeName}Output } from '../types/workflows/${workflow.key}.js';`);
+    lines.push('');
+    // Execution result type
+    lines.push('/** Execution result type */');
+    lines.push(`export interface ${typeName}ExecutionResult {`);
+    lines.push('  success: boolean;');
+    lines.push('  executionId?: string;');
+    lines.push('  queued?: boolean;');
+    lines.push(`  result?: ${typeName}Output;`);
+    lines.push('  error?: { code: string; message: string };');
+    lines.push('}');
+    lines.push('');
+    // Execution status type
+    lines.push('/** Execution status type */');
+    lines.push(`export interface ${typeName}ExecutionStatus {`);
+    lines.push('  id: string;');
+    lines.push('  workflowKey: string;');
+    lines.push("  status: 'PENDING' | 'RUNNING' | 'COMPLETED' | 'FAILED' | 'CANCELLED';");
+    lines.push(`  result?: ${typeName}Output;`);
+    lines.push('  error?: { code: string; message: string };');
+    lines.push('  createdAt: string;');
+    lines.push('  completedAt?: string;');
+    lines.push('}');
+    lines.push('');
+    // useExecute hook
+    lines.push('/**');
+    lines.push(` * Execute the ${workflow.name} workflow`);
+    lines.push(' *');
+    lines.push(' * @example');
+    lines.push(` * const [execute, { loading, error }] = use${typeName}();`);
+    lines.push(' * ');
+    lines.push(' * const handleExecute = async () => {');
+    lines.push(`   *   const result = await execute({ /* input */ });`);
+    lines.push('   *   if (result.queued) {');
+    lines.push('   *     // Track execution via executionId');
+    lines.push('   *   } else {');
+    lines.push('   *     // Use result.result directly');
+    lines.push('   *   }');
+    lines.push('   * };');
+    lines.push(' */');
+    lines.push(`export function use${typeName}(options?: MutationHookOptions) {`);
+    lines.push('  const [mutate, result] = useMutation(PublicExecuteWorkflowDocument, options);');
+    lines.push('');
+    lines.push(`  const ${camelName} = async (input: ${typeName}Input): Promise<${typeName}ExecutionResult> => {`);
+    lines.push('    const response = await mutate({');
+    lines.push('      variables: {');
+    lines.push('        input: {');
+    lines.push(`          workflowKey: '${workflow.key}',`);
+    lines.push('          input,');
+    lines.push('        },');
+    lines.push('      },');
+    lines.push('    });');
+    lines.push('');
+    lines.push('    const data = response.data?.publicExecuteWorkflow;');
+    lines.push('    return {');
+    lines.push('      success: data?.success ?? false,');
+    lines.push('      executionId: data?.executionId ?? undefined,');
+    lines.push('      queued: data?.queued ?? undefined,');
+    lines.push(`      result: data?.result as ${typeName}Output | undefined,`);
+    lines.push('      error: data?.error ?? undefined,');
+    lines.push('    };');
+    lines.push('  };');
+    lines.push('');
+    lines.push(`  return [${camelName}, result] as const;`);
+    lines.push('}');
+    lines.push('');
+    // useExecution hook
+    lines.push('/**');
+    lines.push(` * Get ${workflow.name} execution status`);
+    lines.push(' *');
+    lines.push(' * Use this to poll for async workflow completion.');
+    lines.push(' *');
+    lines.push(' * @example');
+    lines.push(` * const { execution, loading } = use${typeName}Execution(executionId, {`);
+    lines.push('   *   pollInterval: 1000, // Poll every second');
+    lines.push('   *   skip: !executionId,');
+    lines.push('   * });');
+    lines.push('   * ');
+    lines.push("   * if (execution?.status === 'COMPLETED') {");
+    lines.push('   *   // Use execution.result');
+    lines.push('   * }');
+    lines.push(' */');
+    lines.push(`export function use${typeName}Execution(`);
+    lines.push('  executionId: string | undefined,');
+    lines.push('  options?: Omit<QueryHookOptions, "variables">');
+    lines.push(') {');
+    lines.push('  const result = useQuery(PublicWorkflowExecutionDocument, {');
+    lines.push('    ...options,');
+    lines.push('    variables: { id: executionId! },');
+    lines.push('    skip: !executionId || options?.skip,');
+    lines.push('  });');
+    lines.push('');
+    lines.push(`  const execution: ${typeName}ExecutionStatus | undefined = result.data?.publicWorkflowExecution`);
+    lines.push('    ? {');
+    lines.push('        ...result.data.publicWorkflowExecution,');
+    lines.push(`        result: result.data.publicWorkflowExecution.result as ${typeName}Output | undefined,`);
+    lines.push('      }');
+    lines.push('    : undefined;');
+    lines.push('');
+    lines.push('  return {');
+    lines.push('    ...result,');
+    lines.push('    execution,');
+    lines.push('  };');
+    lines.push('}');
+    return lines.join('\n') + '\n';
+}
+/**
+ * Generate Remix server functions for a single workflow
+ */
+export function generateWorkflowRemixHooks(workflow) {
+    // For Remix, we generate server-side functions that can be used in loaders/actions
+    // The generated code is similar but uses graphql-request instead of Apollo
+    const typeName = toPascalCase(workflow.key);
+    const camelName = toCamelCase(workflow.key);
+    const lines = [];
+    // File header
+    lines.push('/**');
+    lines.push(` * ${workflow.name} - Remix Server Functions`);
+    if (workflow.description) {
+        lines.push(` * ${workflow.description}`);
+    }
+    lines.push(' *');
+    lines.push(' * @generated by UniformGen - DO NOT EDIT MANUALLY');
+    lines.push(' */');
+    lines.push('');
+    // Imports
+    lines.push("import type { GraphQLClient } from 'graphql-request';");
+    lines.push("import {");
+    lines.push("  PublicExecuteWorkflowDocument,");
+    lines.push("  PublicWorkflowExecutionDocument,");
+    lines.push("} from '../documents/workflows.js';");
+    lines.push(`import type { ${typeName}Input, ${typeName}Output } from '../types/workflows/${workflow.key}.js';`);
+    lines.push('');
+    // Execution result type
+    lines.push('/** Execution result type */');
+    lines.push(`export interface ${typeName}ExecutionResult {`);
+    lines.push('  success: boolean;');
+    lines.push('  executionId?: string;');
+    lines.push('  queued?: boolean;');
+    lines.push(`  result?: ${typeName}Output;`);
+    lines.push('  error?: { code: string; message: string };');
+    lines.push('}');
+    lines.push('');
+    // Execution status type
+    lines.push('/** Execution status type */');
+    lines.push(`export interface ${typeName}ExecutionStatus {`);
+    lines.push('  id: string;');
+    lines.push('  workflowKey: string;');
+    lines.push("  status: 'PENDING' | 'RUNNING' | 'COMPLETED' | 'FAILED' | 'CANCELLED';");
+    lines.push(`  result?: ${typeName}Output;`);
+    lines.push('  error?: { code: string; message: string };');
+    lines.push('  createdAt: string;');
+    lines.push('  completedAt?: string;');
+    lines.push('}');
+    lines.push('');
+    // Execute function
+    lines.push('/**');
+    lines.push(` * Execute the ${workflow.name} workflow`);
+    lines.push(' *');
+    lines.push(' * @example');
+    lines.push(' * // In a Remix action');
+    lines.push(' * export async function action({ request }) {');
+    lines.push(' *   const client = new GraphQLClient(API_URL, {');
+    lines.push(" *     headers: { 'x-api-key': API_KEY }");
+    lines.push(' *   });');
+    lines.push(' *');
+    lines.push(' *   const formData = await request.formData();');
+    lines.push(`   *   const result = await ${camelName}({ /* input */ }, client);`);
+    lines.push(' *   return json(result);');
+    lines.push(' * }');
+    lines.push(' */');
+    lines.push(`export async function ${camelName}(`);
+    lines.push(`  input: ${typeName}Input,`);
+    lines.push('  client: GraphQLClient');
+    lines.push(`): Promise<${typeName}ExecutionResult> {`);
+    lines.push('  const response = await client.request(PublicExecuteWorkflowDocument, {');
+    lines.push('    input: {');
+    lines.push(`      workflowKey: '${workflow.key}',`);
+    lines.push('      input,');
+    lines.push('    },');
+    lines.push('  });');
+    lines.push('');
+    lines.push('  const data = (response as any).publicExecuteWorkflow;');
+    lines.push('  return {');
+    lines.push('    success: data?.success ?? false,');
+    lines.push('    executionId: data?.executionId ?? undefined,');
+    lines.push('    queued: data?.queued ?? undefined,');
+    lines.push(`    result: data?.result as ${typeName}Output | undefined,`);
+    lines.push('    error: data?.error ?? undefined,');
+    lines.push('  };');
+    lines.push('}');
+    lines.push('');
+    // Get execution function
+    lines.push('/**');
+    lines.push(` * Get ${workflow.name} execution status`);
+    lines.push(' *');
+    lines.push(' * @example');
+    lines.push(' * // In a Remix loader');
+    lines.push(' * export async function loader({ params }) {');
+    lines.push(' *   const client = new GraphQLClient(API_URL, {');
+    lines.push(" *     headers: { 'x-api-key': API_KEY }");
+    lines.push(' *   });');
+    lines.push(' *');
+    lines.push(`   *   const status = await get${typeName}Execution(params.executionId, client);`);
+    lines.push(' *   return json(status);');
+    lines.push(' * }');
+    lines.push(' */');
+    lines.push(`export async function get${typeName}Execution(`);
+    lines.push('  executionId: string,');
+    lines.push('  client: GraphQLClient');
+    lines.push(`): Promise<${typeName}ExecutionStatus | null> {`);
+    lines.push('  const response = await client.request(PublicWorkflowExecutionDocument, {');
+    lines.push('    id: executionId,');
+    lines.push('  });');
+    lines.push('');
+    lines.push('  const data = (response as any).publicWorkflowExecution;');
+    lines.push('  if (!data) return null;');
+    lines.push('');
+    lines.push('  return {');
+    lines.push('    ...data,');
+    lines.push(`    result: data.result as ${typeName}Output | undefined,`);
+    lines.push('  };');
+    lines.push('}');
+    return lines.join('\n') + '\n';
+}
+/**
+ * Generate index file for workflow React hooks
+ */
+export function generateWorkflowReactHooksIndex(workflows) {
+    const lines = [];
+    lines.push('/**');
+    lines.push(' * Workflow React Hooks');
+    lines.push(' * @generated by UniformGen - DO NOT EDIT MANUALLY');
+    lines.push(' */');
+    lines.push('');
+    for (const workflow of workflows) {
+        const typeName = toPascalCase(workflow.key);
+        lines.push(`export {`);
+        lines.push(`  use${typeName},`);
+        lines.push(`  use${typeName}Execution,`);
+        lines.push(`  type ${typeName}ExecutionResult,`);
+        lines.push(`  type ${typeName}ExecutionStatus,`);
+        lines.push(`} from './${workflow.key}.js';`);
+    }
+    return lines.join('\n') + '\n';
+}
+/**
+ * Generate index file for workflow Remix functions
+ */
+export function generateWorkflowRemixHooksIndex(workflows) {
+    const lines = [];
+    lines.push('/**');
+    lines.push(' * Workflow Remix Server Functions');
+    lines.push(' * @generated by UniformGen - DO NOT EDIT MANUALLY');
+    lines.push(' */');
+    lines.push('');
+    for (const workflow of workflows) {
+        const typeName = toPascalCase(workflow.key);
+        const camelName = toCamelCase(workflow.key);
+        lines.push(`export {`);
+        lines.push(`  ${camelName},`);
+        lines.push(`  get${typeName}Execution,`);
+        lines.push(`  type ${typeName}ExecutionResult,`);
+        lines.push(`  type ${typeName}ExecutionStatus,`);
+        lines.push(`} from './${workflow.key}.js';`);
+    }
+    return lines.join('\n') + '\n';
+}

package/dist/generators/resolve/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Resolve Query Generators
+ *
+ * Generates typed hooks/functions for frontend entity resolution.
+ *
+ * Phase 13 structure:
+ * - Platform resolution: useResolve{Model} - Returns content WITHOUT CMS features
+ * - CMS resolution: useResolveRoute - Returns full template/zone/layout data (see cms/route.ts)
+ *
+ * @generated by UniformGen
+ */
+export { generatePlatformResolveReact, generatePlatformResolveRemix, generatePlatformResolveIndexReact, generatePlatformResolveIndexRemix, } from './platform.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/generators/resolve/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/generators/resolve/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EACL,4BAA4B,EAC5B,4BAA4B,EAC5B,iCAAiC,EACjC,iCAAiC,GAClC,MAAM,eAAe,CAAC"}

package/dist/generators/resolve/index.js

@@ -0,0 +1,13 @@
+/**
+ * Resolve Query Generators
+ *
+ * Generates typed hooks/functions for frontend entity resolution.
+ *
+ * Phase 13 structure:
+ * - Platform resolution: useResolve{Model} - Returns content WITHOUT CMS features
+ * - CMS resolution: useResolveRoute - Returns full template/zone/layout data (see cms/route.ts)
+ *
+ * @generated by UniformGen
+ */
+// Export platform generators
+export { generatePlatformResolveReact, generatePlatformResolveRemix, generatePlatformResolveIndexReact, generatePlatformResolveIndexRemix, } from './platform.js';

package/dist/generators/resolve/platform.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Platform Resolution Generator
+ *
+ * Generates typed hooks/functions for platform-level entity resolution:
+ * - useResolve{Model} - Resolve by natural key with variant selection
+ * - Returns resolved content WITHOUT CMS features (no templates/zones/layouts)
+ *
+ * Use CMS generators (cms/route.ts) for template/zone resolution.
+ *
+ * @generated by UniformGen
+ */
+import type { EntityModel } from '../../fetcher/fetch-schemas.js';
+/**
+ * Generate React platform resolve hook for a model
+ */
+export declare function generatePlatformResolveReact(model: EntityModel, _allModels: EntityModel[]): string;
+/**
+ * Generate Remix/Hydrogen platform resolve function for a model
+ */
+export declare function generatePlatformResolveRemix(model: EntityModel, _allModels: EntityModel[]): string;
+/**
+ * Generate index file for platform resolve hooks (React)
+ */
+export declare function generatePlatformResolveIndexReact(models: EntityModel[]): string;
+/**
+ * Generate index file for platform resolve functions (Remix)
+ */
+export declare function generatePlatformResolveIndexRemix(models: EntityModel[]): string;
+//# sourceMappingURL=platform.d.ts.map

package/dist/generators/resolve/platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../../src/generators/resolve/platform.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAuB,MAAM,gCAAgC,CAAC;AA6FvF;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,WAAW,EAClB,UAAU,EAAE,WAAW,EAAE,GACxB,MAAM,CAyMR;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,WAAW,EAClB,UAAU,EAAE,WAAW,EAAE,GACxB,MAAM,CAwIR;AAED;;GAEG;AACH,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAoC/E;AAED;;GAEG;AACH,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAyC/E"}