@eide/uniformgen 0.1.0

package/dist/generators/hooks/remix.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Remix/Hydrogen Hooks Generator
+ *
+ * Generates typed loader/action helpers for Remix and Shopify Hydrogen
+ * that work with the generic entity API.
+ */
+import type { EntityModel } from '../../fetcher/fetch-schemas.js';
+/**
+ * Generate Remix/Hydrogen helpers for an entity model
+ */
+export declare function generateRemixHooks(model: EntityModel, _allModels: EntityModel[]): string;
+/**
+ * Generate index file for Remix hooks
+ */
+export declare function generateRemixHooksIndex(models: EntityModel[]): string;
+//# sourceMappingURL=remix.d.ts.map

package/dist/generators/hooks/remix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remix.d.ts","sourceRoot":"","sources":["../../../src/generators/hooks/remix.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAuB,MAAM,gCAAgC,CAAC;AAoGvF;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,WAAW,EAClB,UAAU,EAAE,WAAW,EAAE,GACxB,MAAM,CAuOR;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAwCrE"}

package/dist/generators/hooks/remix.js

@@ -0,0 +1,349 @@
+/**
+ * Remix/Hydrogen Hooks Generator
+ *
+ * Generates typed loader/action helpers for Remix and Shopify Hydrogen
+ * that work with the generic entity API.
+ */
+import { toPascalCase, toCamelCase, sanitizeFieldName } from '../../utils/field-mapping.js';
+/**
+ * Map metadata field type to TypeScript type
+ */
+function getMetadataValueType(fieldType) {
+    switch (fieldType) {
+        case 'string':
+            return 'string';
+        case 'number':
+            return 'number';
+        case 'boolean':
+            return 'boolean';
+        case 'date':
+            return 'string'; // ISO date string from JSON
+        case 'array':
+            return 'unknown[]';
+        case 'object':
+            return 'Record<string, unknown>';
+        default:
+            return 'unknown';
+    }
+}
+/**
+ * Build a nested TypeScript interface from dot-notation paths
+ */
+function buildNestedMetadataType(fields, depth = 0) {
+    // Group fields by their first path segment
+    const groups = new Map();
+    const directFields = [];
+    for (const field of fields) {
+        const parts = field.key.split('.');
+        if (parts.length === 1) {
+            directFields.push(field);
+        }
+        else {
+            const firstPart = parts[0];
+            const remaining = {
+                ...field,
+                key: parts.slice(1).join('.'),
+            };
+            if (!groups.has(firstPart)) {
+                groups.set(firstPart, []);
+            }
+            groups.get(firstPart).push(remaining);
+        }
+    }
+    const indent = '  '.repeat(depth + 1);
+    const lines = [];
+    // Add direct fields
+    for (const field of directFields) {
+        const valueType = getMetadataValueType(field.type);
+        const fieldName = sanitizeFieldName(field.key);
+        const optional = field.required ? '' : '?';
+        lines.push(`${indent}${fieldName}${optional}: ${valueType};`);
+    }
+    // Add nested groups
+    for (const [groupName, groupFields] of groups) {
+        const nestedType = buildNestedMetadataType(groupFields, depth + 1);
+        if (nestedType !== '{}') {
+            const fieldName = sanitizeFieldName(groupName);
+            lines.push(`${indent}${fieldName}?: ${nestedType}`);
+        }
+    }
+    if (lines.length === 0) {
+        return '{}';
+    }
+    const closeIndent = '  '.repeat(depth);
+    return `{\n${lines.join('\n')}\n${closeIndent}}`;
+}
+/**
+ * Generate metadata type interface for a model
+ */
+function generateMetadataType(model) {
+    const metadataFields = model.metadataSchema?.fields;
+    if (!metadataFields || metadataFields.length === 0) {
+        return null;
+    }
+    return buildNestedMetadataType(metadataFields, 0);
+}
+/**
+ * Check if model is inline-only (no records mode)
+ */
+function isInlineOnlyModel(model) {
+    return model.modes.inline && !model.modes.records;
+}
+/**
+ * Generate Remix/Hydrogen helpers for an entity model
+ */
+export function generateRemixHooks(model, _allModels) {
+    // Skip inline-only models - they don't have standalone records
+    if (isInlineOnlyModel(model)) {
+        return '';
+    }
+    const typeName = toPascalCase(model.key);
+    const dataTypeName = `${typeName}Data`;
+    const camelName = toCamelCase(model.key);
+    const filtersTypeName = `${typeName}Filters`;
+    const lines = [];
+    // File header
+    lines.push(`/**`);
+    lines.push(` * ${model.name} - Remix/Hydrogen Helpers`);
+    lines.push(` *`);
+    lines.push(` * @generated by UniformGen - DO NOT EDIT MANUALLY`);
+    lines.push(` */`);
+    lines.push('');
+    // Imports
+    lines.push(`import type { ${dataTypeName} } from '../types/models/${model.key}.js';`);
+    lines.push(`import type { FilterInput, SortInput } from '../types/field-types.js';`);
+    lines.push(`import { type ${filtersTypeName}, build${typeName}Filters } from '../filters/${model.key}.js';`);
+    lines.push('');
+    // Re-export filter types for convenience
+    lines.push(`// Re-export filter types for convenience`);
+    lines.push(`export type { ${filtersTypeName} } from '../filters/${model.key}.js';`);
+    lines.push(`export { build${typeName}Filters } from '../filters/${model.key}.js';`);
+    lines.push('');
+    // Generate metadata type if model has metadataSchema
+    const metadataType = generateMetadataType(model);
+    const metadataTypeName = `${typeName}Metadata`;
+    if (metadataType) {
+        lines.push(`/** Typed metadata for ${model.name} */`);
+        lines.push(`export interface ${metadataTypeName} ${metadataType}`);
+        lines.push('');
+    }
+    // Typed record interface
+    lines.push(`/** Typed ${model.name} record */`);
+    lines.push(`export interface ${typeName}Record {`);
+    lines.push(`  id: string;`);
+    lines.push(`  modelKey: '${model.key}';`);
+    lines.push(`  naturalKey?: string;`);
+    lines.push(`  data: ${dataTypeName};`);
+    if (metadataType) {
+        lines.push(`  metadata?: ${metadataTypeName};`);
+    }
+    else {
+        lines.push(`  metadata?: Record<string, unknown>;`);
+    }
+    lines.push(`  versionNumber: number;`);
+    lines.push(`  publishedVersionNumber?: number;`);
+    lines.push(`  status: 'DRAFT' | 'PUBLISHED' | 'ARCHIVED';`);
+    lines.push(`  createdAt: string;`);
+    lines.push(`  updatedAt: string;`);
+    lines.push(`}`);
+    lines.push('');
+    // List result interface
+    lines.push(`/** Typed list result */`);
+    lines.push(`export interface ${typeName}ListResult {`);
+    lines.push(`  items: ${typeName}Record[];`);
+    lines.push(`  total: number;`);
+    lines.push(`  hasMore: boolean;`);
+    lines.push(`}`);
+    lines.push('');
+    // GraphQL client type
+    lines.push(`/** GraphQL client interface (works with any fetch-based client) */`);
+    lines.push(`export interface GraphQLClient {`);
+    lines.push(`  request<T>(query: string, variables?: Record<string, unknown>): Promise<T>;`);
+    lines.push(`}`);
+    lines.push('');
+    // Parse helper
+    lines.push(`/** Parse raw entity to typed record */`);
+    lines.push(`function parse${typeName}(entity: any): ${typeName}Record {`);
+    lines.push(`  return {`);
+    lines.push(`    ...entity,`);
+    lines.push(`    modelKey: '${model.key}',`);
+    lines.push(`    data: entity.data as ${dataTypeName},`);
+    if (metadataType) {
+        lines.push(`    metadata: entity.metadata as ${metadataTypeName},`);
+    }
+    else {
+        lines.push(`    metadata: entity.metadata as Record<string, unknown>,`);
+    }
+    lines.push(`  };`);
+    lines.push(`}`);
+    lines.push('');
+    // GraphQL queries as string constants
+    lines.push(`// GraphQL Queries`);
+    lines.push(`const GET_${typeName.toUpperCase()}_QUERY = \``);
+    lines.push(`  query Get${typeName}($id: ID!, $preview: Boolean) {`);
+    lines.push(`    entity(modelKey: "${model.key}", id: $id, preview: $preview) {`);
+    lines.push(`      id`);
+    lines.push(`      modelKey`);
+    lines.push(`      naturalKey`);
+    lines.push(`      data`);
+    lines.push(`      metadata`);
+    lines.push(`      versionNumber`);
+    lines.push(`      publishedVersionNumber`);
+    lines.push(`      status`);
+    lines.push(`      createdAt`);
+    lines.push(`      updatedAt`);
+    lines.push(`    }`);
+    lines.push(`  }`);
+    lines.push(`\`;`);
+    lines.push('');
+    lines.push(`const LIST_${typeName.toUpperCase()}S_QUERY = \``);
+    lines.push(`  query List${typeName}s($limit: Int, $offset: Int, $filters: [FilterInput!], $sort: SortInput, $preview: Boolean) {`);
+    lines.push(`    entities(modelKey: "${model.key}", limit: $limit, offset: $offset, filters: $filters, sort: $sort, preview: $preview) {`);
+    lines.push(`      items {`);
+    lines.push(`        id`);
+    lines.push(`        modelKey`);
+    lines.push(`        naturalKey`);
+    lines.push(`        data`);
+    lines.push(`        metadata`);
+    lines.push(`        versionNumber`);
+    lines.push(`        publishedVersionNumber`);
+    lines.push(`        status`);
+    lines.push(`        createdAt`);
+    lines.push(`        updatedAt`);
+    lines.push(`      }`);
+    lines.push(`      total`);
+    lines.push(`      hasMore`);
+    lines.push(`    }`);
+    lines.push(`  }`);
+    lines.push(`\`;`);
+    lines.push('');
+    // Fetch single entity
+    lines.push(`/**`);
+    lines.push(` * Fetch a single ${model.name} by ID`);
+    lines.push(` * Use in Remix loaders or server functions`);
+    lines.push(` */`);
+    lines.push(`export async function fetch${typeName}(`);
+    lines.push(`  client: GraphQLClient,`);
+    lines.push(`  id: string,`);
+    lines.push(`  options?: { preview?: boolean }`);
+    lines.push(`): Promise<${typeName}Record | null> {`);
+    lines.push(`  const result = await client.request<{ entity: any }>(GET_${typeName.toUpperCase()}_QUERY, {`);
+    lines.push(`    id,`);
+    lines.push(`    preview: options?.preview,`);
+    lines.push(`  });`);
+    lines.push(`  return result.entity ? parse${typeName}(result.entity) : null;`);
+    lines.push(`}`);
+    lines.push('');
+    // Fetch list with typed filters
+    lines.push(`/**`);
+    lines.push(` * Fetch a list of ${model.name} records`);
+    lines.push(` * Use in Remix loaders or server functions`);
+    lines.push(` * `);
+    lines.push(` * @example`);
+    lines.push(` * // Using typed filters (recommended)`);
+    lines.push(` * const result = await fetch${typeName}s(client, {`);
+    lines.push(`   *   filters: { title: { contains: 'example' } },`);
+    lines.push(`   * });`);
+    lines.push(` * `);
+    lines.push(` * @example`);
+    lines.push(` * // Using raw FilterInput array`);
+    lines.push(` * const result = await fetch${typeName}s(client, {`);
+    lines.push(`   *   rawFilters: [{ field: 'data.title', operator: 'contains', value: 'example' }],`);
+    lines.push(`   * });`);
+    lines.push(` */`);
+    lines.push(`export async function fetch${typeName}s(`);
+    lines.push(`  client: GraphQLClient,`);
+    lines.push(`  options?: {`);
+    lines.push(`    limit?: number;`);
+    lines.push(`    offset?: number;`);
+    lines.push(`    /** Typed filters with autocomplete support */`);
+    lines.push(`    filters?: ${filtersTypeName};`);
+    lines.push(`    /** Raw filter array (use filters for type safety) */`);
+    lines.push(`    rawFilters?: FilterInput[];`);
+    lines.push(`    sort?: SortInput;`);
+    lines.push(`    preview?: boolean;`);
+    lines.push(`  }`);
+    lines.push(`): Promise<${typeName}ListResult> {`);
+    lines.push(`  const { filters, rawFilters, ...rest } = options ?? {};`);
+    lines.push(`  `);
+    lines.push(`  // Convert typed filters to FilterInput array`);
+    lines.push(`  const apiFilters = filters ? build${typeName}Filters(filters) : rawFilters;`);
+    lines.push(`  `);
+    lines.push(`  const result = await client.request<{ entities: any }>(LIST_${typeName.toUpperCase()}S_QUERY, {`);
+    lines.push(`    ...rest,`);
+    lines.push(`    filters: apiFilters,`);
+    lines.push(`  });`);
+    lines.push(`  return {`);
+    lines.push(`    items: result.entities.items.map(parse${typeName}),`);
+    lines.push(`    total: result.entities.total,`);
+    lines.push(`    hasMore: result.entities.hasMore,`);
+    lines.push(`  };`);
+    lines.push(`}`);
+    lines.push('');
+    // Fetch by natural key helper
+    lines.push(`/**`);
+    lines.push(` * Fetch a ${model.name} by natural key (slug/handle)`);
+    lines.push(` * Use in Remix loaders for dynamic routes`);
+    lines.push(` */`);
+    lines.push(`export async function fetch${typeName}ByNaturalKey(`);
+    lines.push(`  client: GraphQLClient,`);
+    lines.push(`  naturalKey: string,`);
+    lines.push(`  options?: { preview?: boolean }`);
+    lines.push(`): Promise<${typeName}Record | null> {`);
+    lines.push(`  const result = await fetch${typeName}s(client, {`);
+    lines.push(`    rawFilters: [{ field: 'naturalKey', operator: 'eq', value: naturalKey }],`);
+    lines.push(`    limit: 1,`);
+    lines.push(`    preview: options?.preview,`);
+    lines.push(`  });`);
+    lines.push(`  return result.items[0] ?? null;`);
+    lines.push(`}`);
+    lines.push('');
+    // Loader helper with type inference
+    lines.push(`/**`);
+    lines.push(` * Create a typed loader data object`);
+    lines.push(` * Helps with type inference in Remix components`);
+    lines.push(` */`);
+    lines.push(`export function create${typeName}LoaderData<T extends { ${camelName}?: ${typeName}Record | null; ${camelName}s?: ${typeName}ListResult }>(data: T): T {`);
+    lines.push(`  return data;`);
+    lines.push(`}`);
+    return lines.join('\n') + '\n';
+}
+/**
+ * Generate index file for Remix hooks
+ */
+export function generateRemixHooksIndex(models) {
+    const recordModels = models.filter((m) => m.modes.records);
+    let indexCode = `/**
+ * Typed Remix/Hydrogen Helpers
+ *
+ * Server-side fetch helpers for Remix loaders and actions.
+ *
+ * @generated by UniformGen - DO NOT EDIT MANUALLY
+ */\n\n`;
+    // Re-export base types
+    indexCode += `// Re-export base filter and sort types\n`;
+    indexCode += `export type { FilterInput, SortInput } from '../types/field-types.js';\n\n`;
+    for (const model of recordModels) {
+        const typeName = toPascalCase(model.key);
+        const hasMetadata = model.metadataSchema?.fields && model.metadataSchema.fields.length > 0;
+        indexCode += `export {\n`;
+        indexCode += `  fetch${typeName},\n`;
+        indexCode += `  fetch${typeName}s,\n`;
+        indexCode += `  fetch${typeName}ByNaturalKey,\n`;
+        indexCode += `  create${typeName}LoaderData,\n`;
+        indexCode += `  type ${typeName}Record,\n`;
+        if (hasMetadata) {
+            indexCode += `  type ${typeName}Metadata,\n`;
+        }
+        indexCode += `  type ${typeName}ListResult,\n`;
+        indexCode += `  type ${typeName}Filters,\n`;
+        indexCode += `  build${typeName}Filters,\n`;
+        indexCode += `} from './${model.key}.js';\n`;
+    }
+    // Export GraphQL client type from first model
+    const firstModel = recordModels[0];
+    if (firstModel) {
+        indexCode += `\nexport type { GraphQLClient } from './${firstModel.key}.js';\n`;
+    }
+    return indexCode;
+}

package/dist/generators/hooks/workflows.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Workflow Hooks Generator
+ *
+ * Generates typed React hooks for workflow execution using Apollo Client.
+ */
+import type { WorkflowDefinition } from '../../fetcher/fetch-workflows.js';
+/**
+ * Generate React hooks for a single workflow
+ */
+export declare function generateWorkflowReactHooks(workflow: WorkflowDefinition): string;
+/**
+ * Generate Remix server functions for a single workflow
+ */
+export declare function generateWorkflowRemixHooks(workflow: WorkflowDefinition): string;
+/**
+ * Generate index file for workflow React hooks
+ */
+export declare function generateWorkflowReactHooksIndex(workflows: WorkflowDefinition[]): string;
+/**
+ * Generate index file for workflow Remix functions
+ */
+export declare function generateWorkflowRemixHooksIndex(workflows: WorkflowDefinition[]): string;
+//# sourceMappingURL=workflows.d.ts.map

package/dist/generators/hooks/workflows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflows.d.ts","sourceRoot":"","sources":["../../../src/generators/hooks/workflows.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAoB3E;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,CAoI/E;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,CA0H/E;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,SAAS,EAAE,kBAAkB,EAAE,GAAG,MAAM,CAoBvF;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,SAAS,EAAE,kBAAkB,EAAE,GAAG,MAAM,CAqBvF"}