cushin-monorepo 3.0.1

package/dist/cli.js

@@ -0,0 +1,1552 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import { cosmiconfig } from 'cosmiconfig';
+import path6 from 'path';
+import { createJiti } from 'jiti';
+import fs5 from 'fs/promises';
+import { fileURLToPath } from 'url';
+
+var explorer = cosmiconfig("api-codegen", {
+  searchPlaces: [
+    "api-codegen.config.js",
+    "api-codegen.config.mjs",
+    "api-codegen.config.ts",
+    "api-codegen.config.json",
+    ".api-codegenrc",
+    ".api-codegenrc.json",
+    ".api-codegenrc.js"
+  ]
+});
+async function loadConfig(configPath) {
+  try {
+    const result = configPath ? await explorer.load(configPath) : await explorer.search();
+    if (!result || !result.config) {
+      return null;
+    }
+    const userConfig = result.config;
+    const rootDir = path6.dirname(result.filepath);
+    const endpointsPath = path6.resolve(rootDir, userConfig.endpoints);
+    const outputDir = path6.resolve(rootDir, userConfig.output);
+    const generateHooks = userConfig.generateHooks ?? true;
+    const generateServerActions = userConfig.generateServerActions ?? userConfig.provider === "nextjs";
+    const generateServerQueries = userConfig.generateServerQueries ?? userConfig.provider === "nextjs";
+    const generateClient = userConfig.generateClient ?? true;
+    const generatePrefetch = userConfig.generatePrefetch ?? true;
+    return {
+      ...userConfig,
+      rootDir,
+      endpointsPath,
+      outputDir,
+      generateHooks,
+      generateServerActions,
+      generateServerQueries,
+      generateClient,
+      generatePrefetch
+    };
+  } catch (error) {
+    throw new Error(
+      `Failed to load config: ${error instanceof Error ? error.message : String(error)}`
+    );
+  }
+}
+function validateConfig(config) {
+  if (!config.endpoints) {
+    throw new Error('Config error: "endpoints" path is required');
+  }
+  if (!config.provider) {
+    throw new Error(
+      'Config error: "provider" must be specified (vite or nextjs)'
+    );
+  }
+  if (!["vite", "nextjs"].includes(config.provider)) {
+    throw new Error(
+      'Config error: "provider" must be either "vite" or "nextjs"'
+    );
+  }
+  if (!config.output) {
+    throw new Error('Config error: "output" directory is required');
+  }
+}
+
+// src/generators/base.ts
+var BaseGenerator = class {
+  constructor(context) {
+    this.context = context;
+  }
+  isQueryEndpoint(endpoint) {
+    return endpoint.method === "GET";
+  }
+  isMutationEndpoint(endpoint) {
+    return !this.isQueryEndpoint(endpoint);
+  }
+  capitalize(str) {
+    return str.charAt(0).toUpperCase() + str.slice(1);
+  }
+  getQueryTags(endpoint) {
+    return endpoint.tags || [];
+  }
+  getInvalidationTags(endpoint) {
+    const tags = endpoint.tags || [];
+    return tags.filter((tag) => tag !== "query" && tag !== "mutation");
+  }
+  hasParams(endpoint) {
+    return !!endpoint.params;
+  }
+  hasQuery(endpoint) {
+    return !!endpoint.query;
+  }
+  hasBody(endpoint) {
+    return !!endpoint.body;
+  }
+  getEndpointSignature(name, endpoint) {
+    const hasParams = this.hasParams(endpoint);
+    const hasQuery = this.hasQuery(endpoint);
+    const hasBody = this.hasBody(endpoint);
+    return {
+      hasParams,
+      hasQuery,
+      hasBody,
+      paramType: hasParams ? `ExtractParams<APIEndpoints['${name}']>` : "never",
+      queryType: hasQuery ? `ExtractQuery<APIEndpoints['${name}']>` : "never",
+      bodyType: hasBody ? `ExtractBody<APIEndpoints['${name}']>` : "never",
+      responseType: `ExtractResponse<APIEndpoints['${name}']>`
+    };
+  }
+  generateMutationCall(name, hasParams, hasBody) {
+    if (hasParams && hasBody) {
+      return `return apiClient.${name}(input.params, input.body);`;
+    } else if (hasParams) {
+      return `return apiClient.${name}(input);`;
+    } else if (hasBody) {
+      return `return apiClient.${name}(input);`;
+    } else {
+      return `return apiClient.${name}();`;
+    }
+  }
+  inferNonNull(expr) {
+    return `z.infer<NonNullable<${expr}>>`;
+  }
+  toCamelCase(str) {
+    return str.toLowerCase().replace(/[-_\s]+(.)?/g, (_, c) => c ? c.toUpperCase() : "").replace(/^./, (c) => c.toLowerCase());
+  }
+  getResourceFromEndpoint(_name, endpoint) {
+    const tag = endpoint.tags?.find((t) => t !== "query" && t !== "mutation");
+    if (tag) return this.toCamelCase(tag);
+    const match = endpoint.path.match(/^\/([^/]+)/);
+    return match ? this.toCamelCase(match[1]) : "general";
+  }
+  groupEndpointsByResource() {
+    const groups = {};
+    Object.entries(this.context.apiConfig.endpoints).forEach(
+      ([name, endpoint]) => {
+        const res = this.getResourceFromEndpoint(name, endpoint);
+        if (!groups[res]) groups[res] = [];
+        groups[res].push({ name, endpoint });
+      }
+    );
+    return groups;
+  }
+  resourceHasQueryEndpoints(resource) {
+    return this.groupEndpointsByResource()[resource]?.some(
+      ({ endpoint }) => endpoint.method === "GET"
+    ) ?? false;
+  }
+  getEndpointKeyName(name) {
+    return name.startsWith("get") ? name[3].toLowerCase() + name.slice(4) : name;
+  }
+  generateQueryKeyCall(resource, name, endpoint) {
+    const key = this.getEndpointKeyName(name);
+    const args = [];
+    if (endpoint.params) args.push("params");
+    if (endpoint.query) args.push("filters");
+    return args.length ? `queryKeys.${resource}.${key}(${args.join(", ")})` : `queryKeys.${resource}.${key}()`;
+  }
+  hasQueryOptions() {
+    return Object.values(this.context.apiConfig.endpoints).some(
+      (e) => e.method === "GET"
+    );
+  }
+};
+
+// src/generators/hooks.ts
+var HooksGenerator = class extends BaseGenerator {
+  async generate() {
+    const content = this.generateContent();
+    const outputPath = path6.join(this.context.config.outputDir, "hooks.ts");
+    await fs5.mkdir(path6.dirname(outputPath), { recursive: true });
+    await fs5.writeFile(outputPath, content, "utf-8");
+  }
+  generateContent() {
+    const useClientDirective = this.context.config.options?.useClientDirective ?? true;
+    const outputPath = path6.join(this.context.config.outputDir, "types.ts");
+    const endpointsPath = path6.join(this.context.config.endpointsPath);
+    const relativePath = path6.relative(path6.dirname(outputPath), endpointsPath).replace(/\\/g, "/");
+    const content = `${useClientDirective ? "'use client';\n" : ""}
+import { useQuery, useMutation, useQueryClient } from "@tanstack/react-query";
+import { apiClient } from "./client";
+import { queryKeys } from "./query-keys";
+import { apiQueryOptions } from "./query-options";
+import { z } from "zod";
+import { apiConfig } from "${relativePath}";
+
+${this.generateQueryHooks()}
+${this.generateMutationHooks()}
+`;
+    return content;
+  }
+  generateQueryHooks() {
+    const hooks = [];
+    Object.entries(this.context.apiConfig.endpoints).forEach(
+      ([name, endpoint]) => {
+        if (endpoint.method === "GET")
+          hooks.push(this.generateQueryHook(name, endpoint));
+      }
+    );
+    return hooks.join("\n\n");
+  }
+  generateQueryHook(name, endpoint) {
+    const hookName = `use${this.capitalize(name)}`;
+    const resource = this.getResourceFromEndpoint(name, endpoint);
+    const optionName = this.getEndpointKeyName(name);
+    const inferParams = this.inferNonNull(
+      `typeof apiConfig.endpoints.${name}.params`
+    );
+    const inferQuery = this.inferNonNull(
+      `typeof apiConfig.endpoints.${name}.query`
+    );
+    const inferResponse = this.inferNonNull(
+      `typeof apiConfig.endpoints.${name}.response`
+    );
+    const params = [];
+    const optionParams = [];
+    const queryTags = this.getQueryTags(endpoint);
+    if (endpoint.params) {
+      params.push(`params: ${inferParams}`);
+      optionParams.push("params");
+    }
+    if (endpoint.query) {
+      params.push(`filters?: ${inferQuery}`);
+      optionParams.push("filters");
+    }
+    params.push(`options?: {
+    enabled?: boolean;
+    select?: <TData = ${inferResponse}>(data: ${inferResponse}) => TData;
+  }`);
+    return `/**
+ * ${endpoint.description || `Query hook for ${name}`}
+ * @tags ${queryTags.join(", ") || "none"}
+ */
+export function ${hookName}(${params.join(",\n  ")}) {
+  return useQuery({
+    ...apiQueryOptions.${resource}.${optionName}(${optionParams.join(", ")}),
+    ...options,
+  });
+}`;
+  }
+  generateMutationHooks() {
+    const hooks = [];
+    Object.entries(this.context.apiConfig.endpoints).forEach(
+      ([name, endpoint]) => {
+        if (endpoint.method !== "GET")
+          hooks.push(this.generateMutationHook(name, endpoint));
+      }
+    );
+    return hooks.join("\n\n");
+  }
+  generateMutationHook(name, endpoint) {
+    const hookName = `use${this.capitalize(name)}`;
+    const resource = this.getResourceFromEndpoint(name, endpoint);
+    const inferParams = this.inferNonNull(
+      `typeof apiConfig.endpoints.${name}.params`
+    );
+    const inferBody = this.inferNonNull(
+      `typeof apiConfig.endpoints.${name}.body`
+    );
+    const inferResponse = this.inferNonNull(
+      `typeof apiConfig.endpoints.${name}.response`
+    );
+    const resourceHasQueries = this.resourceHasQueryEndpoints(resource);
+    let inputType;
+    let fnBody;
+    if (endpoint.params && endpoint.body) {
+      inputType = `{ params: ${inferParams}; body: ${inferBody}; }`;
+      fnBody = `({ params, body }: ${inputType}) => apiClient.${name}(params, body)`;
+    } else if (endpoint.params) {
+      inputType = `${inferParams}`;
+      fnBody = `(params: ${inputType}) => apiClient.${name}(params)`;
+    } else if (endpoint.body) {
+      inputType = `${inferBody}`;
+      fnBody = `(body: ${inputType}) => apiClient.${name}(body)`;
+    } else {
+      inputType = "void";
+      fnBody = `() => apiClient.${name}()`;
+    }
+    const invalidate = resourceHasQueries ? `queryClient.invalidateQueries({ queryKey: queryKeys.${resource}.all });` : "";
+    return `/**
+ * ${endpoint.description || `Mutation hook for ${name}`}
+ * @tags ${endpoint.tags?.join(", ") || "none"}
+ */
+    export function ${hookName}(options?: {
+      onSuccess?: (data: ${inferResponse}, variables: ${inputType}, context: unknown) => void;
+      onError?: (error: Error, variables: ${inputType}, context: unknown) => void;
+      onSettled?: (data: ${inferResponse} | undefined, error: Error | null, variables: ${inputType}, context: unknown) => void;
+      onMutate?: (variables: ${inputType}) => Promise<unknown> | unknown;
+    }) {
+      ${invalidate ? "const queryClient = useQueryClient();" : ""}
+      return useMutation({
+	mutationFn: ${fnBody},
+	onSuccess: (data, variables, context) => {
+	  ${invalidate}
+	  options?.onSuccess?.(data, variables, context);
+	},
+	onError: options?.onError,
+	onSettled: options?.onSettled,
+	onMutate: options?.onMutate,
+      });
+    }`;
+  }
+};
+var ServerActionsGenerator = class extends BaseGenerator {
+  async generate() {
+    const content = this.generateContent();
+    const outputPath = path6.join(this.context.config.outputDir, "actions.ts");
+    await fs5.mkdir(path6.dirname(outputPath), { recursive: true });
+    await fs5.writeFile(outputPath, content, "utf-8");
+  }
+  generateContent() {
+    const imports = `'use server';
+
+import { revalidateTag, revalidatePath } from 'next/cache';
+import { serverClient } from './server-client';
+import type { 
+  APIEndpoints, 
+  ExtractBody, 
+  ExtractParams, 
+  ExtractResponse 
+} from './types';
+
+export type ActionResult<T> = 
+  | { success: true; data: T }
+  | { success: false; error: string };
+`;
+    const actions = [];
+    Object.entries(this.context.apiConfig.endpoints).forEach(([name, endpoint]) => {
+      if (this.isMutationEndpoint(endpoint)) {
+        actions.push(this.generateServerAction(name, endpoint));
+      }
+    });
+    return imports + "\n" + actions.join("\n\n");
+  }
+  generateServerAction(name, endpoint) {
+    const actionSuffix = this.context.config.options?.actionSuffix || "Action";
+    const actionName = `${name}${actionSuffix}`;
+    const signature = this.getEndpointSignature(name, endpoint);
+    const invalidationTags = this.getInvalidationTags(endpoint);
+    let inputType = "";
+    let inputParam = "";
+    if (signature.hasParams && signature.hasBody) {
+      inputType = `input: { params: ${signature.paramType}; body: ${signature.bodyType} }`;
+      inputParam = "input";
+    } else if (signature.hasParams) {
+      inputType = `params: ${signature.paramType}`;
+      inputParam = "params";
+    } else if (signature.hasBody) {
+      inputType = `body: ${signature.bodyType}`;
+      inputParam = "body";
+    }
+    const revalidateStatements = invalidationTags.length > 0 ? invalidationTags.map((tag) => `    revalidateTag('${tag}');`).join("\n") : "    // No automatic revalidations";
+    return `/**
+ * ${endpoint.description || `Server action for ${name}`}
+ * @tags ${endpoint.tags?.join(", ") || "none"}
+ */
+export async function ${actionName}(
+  ${inputType}
+): Promise<ActionResult<${signature.responseType}>> {
+  try {
+    const result = await serverClient.${name}(${inputParam ? inputParam : ""});
+    
+    // Revalidate related data
+${revalidateStatements}
+    
+    return { success: true, data: result };
+  } catch (error) {
+    console.error('[Server Action Error]:', error);
+    return { 
+      success: false, 
+      error: error instanceof Error ? error.message : 'Unknown error' 
+    };
+  }
+}`;
+  }
+};
+var ServerQueriesGenerator = class extends BaseGenerator {
+  async generate() {
+    const content = this.generateContent();
+    const outputPath = path6.join(this.context.config.outputDir, "queries.ts");
+    await fs5.mkdir(path6.dirname(outputPath), { recursive: true });
+    await fs5.writeFile(outputPath, content, "utf-8");
+  }
+  generateContent() {
+    const imports = `import { cache } from 'react';
+import { unstable_cache } from 'next/cache';
+import { serverClient } from './server-client';
+import type { 
+  APIEndpoints, 
+  ExtractParams, 
+  ExtractQuery, 
+  ExtractResponse 
+} from './types';
+`;
+    const queries = [];
+    Object.entries(this.context.apiConfig.endpoints).forEach(
+      ([name, endpoint]) => {
+        if (this.isQueryEndpoint(endpoint)) {
+          queries.push(this.generateServerQuery(name, endpoint));
+        }
+      }
+    );
+    return imports + "\n" + queries.join("\n\n");
+  }
+  generateServerQuery(name, endpoint) {
+    const queryName = `${name}Query`;
+    const signature = this.getEndpointSignature(name, endpoint);
+    const queryTags = this.getQueryTags(endpoint);
+    const paramDef = signature.hasParams ? `params: ${signature.paramType}` : "";
+    const queryDef = signature.hasQuery ? `query?: ${signature.queryType}` : "";
+    const paramsList = [paramDef, queryDef].filter(Boolean).join(",\n  ");
+    const clientCallArgs = [];
+    if (signature.hasParams) clientCallArgs.push("params");
+    if (signature.hasQuery) clientCallArgs.push("query");
+    const cacheKeyParts = [`'${name}'`];
+    if (signature.hasParams) cacheKeyParts.push("JSON.stringify(params)");
+    if (signature.hasQuery) cacheKeyParts.push("JSON.stringify(query)");
+    return `/**
+ * ${endpoint.description || `Server query for ${name}`}
+ * @tags ${queryTags.join(", ") || "none"}
+ */
+export const ${queryName} = cache(async (
+  ${paramsList}
+): Promise<${signature.responseType}> => {
+  return unstable_cache(
+    async () => serverClient.${name}(${clientCallArgs.join(", ")}),
+    [${cacheKeyParts.join(", ")}],
+    {
+      tags: [${queryTags.map((tag) => `'${tag}'`).join(", ")}],
+      revalidate: 3600, // 1 hour default, can be overridden
+    }
+  )();
+});`;
+  }
+};
+var TypesGenerator = class extends BaseGenerator {
+  async generate() {
+    const content = this.generateContent();
+    const outputPath = path6.join(this.context.config.outputDir, "types.ts");
+    await fs5.mkdir(path6.dirname(outputPath), { recursive: true });
+    await fs5.writeFile(outputPath, content, "utf-8");
+  }
+  generateContent() {
+    const outputPath = path6.join(this.context.config.outputDir, "types.ts");
+    const endpointsPath = path6.join(this.context.config.endpointsPath);
+    const relativePath = path6.relative(path6.dirname(outputPath), endpointsPath).replace(/\\/g, "/");
+    return `// Auto-generated type definitions
+// Do not edit this file manually
+
+import type { z } from 'zod';
+import { apiConfig } from '${relativePath}';
+
+
+// Re-export endpoint configuration types
+export type { APIConfig, APIEndpoint, HTTPMethod } from './schema';
+
+/**
+ * Type helper to extract params schema from an endpoint
+ */
+export type ExtractParams<T> = T extends { params: infer P extends z.ZodType }
+  ? z.infer<P>
+  : never;
+
+/**
+ * Type helper to extract query schema from an endpoint
+ */
+export type ExtractQuery<T> = T extends { query: infer Q extends z.ZodType }
+  ? z.infer<Q>
+  : never;
+
+/**
+ * Type helper to extract body schema from an endpoint
+ */
+export type ExtractBody<T> = T extends { body: infer B extends z.ZodType }
+  ? z.infer<B>
+  : never;
+
+/**
+ * Type helper to extract response schema from an endpoint
+ */
+export type ExtractResponse<T> = T extends { response: infer R extends z.ZodType }
+  ? z.infer<R>
+  : never;
+
+/**
+ * Import your API config to get typed endpoints
+ * 
+ */
+export type APIEndpoints = typeof apiConfig.endpoints;
+
+${this.generateEndpointTypes()}
+`;
+  }
+  generateEndpointTypes() {
+    const types = [];
+    Object.entries(this.context.apiConfig.endpoints).forEach(
+      ([name, endpoint]) => {
+        const cap = this.capitalize(name);
+        if (endpoint.response)
+          types.push(
+            `export type ${cap}Response = ${this.inferNonNull(`typeof apiConfig.endpoints.${name}.response`)};`
+          );
+        if (endpoint.body)
+          types.push(
+            `export type ${cap}Input = ${this.inferNonNull(`typeof apiConfig.endpoints.${name}.body`)};`
+          );
+        if (endpoint.query)
+          types.push(
+            `export type ${cap}Query = ${this.inferNonNull(`typeof apiConfig.endpoints.${name}.query`)};`
+          );
+        if (endpoint.params)
+          types.push(
+            `export type ${cap}Params = ${this.inferNonNull(`typeof apiConfig.endpoints.${name}.params`)};`
+          );
+      }
+    );
+    return types.join("\n");
+  }
+};
+var ClientGenerator = class extends BaseGenerator {
+  async generate() {
+    await this.generateClientFile();
+    if (this.context.config.provider === "nextjs") {
+      await this.generateServerClientFile();
+    }
+  }
+  async generateClientFile() {
+    const content = this.generateClientContent();
+    const outputPath = path6.join(this.context.config.outputDir, "client.ts");
+    await fs5.mkdir(path6.dirname(outputPath), { recursive: true });
+    await fs5.writeFile(outputPath, content, "utf-8");
+  }
+  async generateServerClientFile() {
+    const content = this.generateServerClientContent();
+    const outputPath = path6.join(
+      this.context.config.outputDir,
+      "server-client.ts"
+    );
+    await fs5.mkdir(path6.dirname(outputPath), { recursive: true });
+    await fs5.writeFile(outputPath, content, "utf-8");
+  }
+  generateClientContent() {
+    const useClientDirective = this.context.config.options?.useClientDirective ?? true;
+    const outputPath = path6.join(this.context.config.outputDir, "types.ts");
+    const endpointsPath = path6.join(this.context.config.endpointsPath);
+    const relativePath = path6.relative(path6.dirname(outputPath), endpointsPath).replace(/\\/g, "/");
+    return `${useClientDirective ? "'use client';\n" : ""}
+import { createAPIClient } from './core';
+import type { AuthCallbacks } from './core';
+import { apiConfig } from '${relativePath}';
+import { z } from 'zod';
+
+// Type the methods based on endpoints
+type APIClientMethods = {
+  [K in keyof typeof apiConfig.endpoints]: (typeof apiConfig.endpoints)[K] extends {
+    method: infer M;
+    params?: infer P;
+    query?: infer Q;
+    body?: infer B;
+    response: infer R;
+  }
+    ? M extends "GET"
+      ? P extends z.ZodJSONSchema
+        ? Q extends z.ZodJSONSchema
+          ? (params: z.infer<P>, query?: z.infer<Q>) => Promise<z.infer<R>>
+          : (params: z.infer<P>) => Promise<z.infer<R>>
+        : Q extends z.ZodJSONSchema
+          ? (query?: z.infer<Q>) => Promise<z.infer<R>>
+          : () => Promise<z.infer<R>>
+      : P extends z.ZodJSONSchema
+        ? B extends z.ZodJSONSchema
+          ? (params: z.infer<P>, body: z.infer<B>) => Promise<z.infer<R>>
+          : (params: z.infer<P>) => Promise<z.infer<R>>
+        : B extends z.ZodJSONSchema
+          ? (body: z.infer<B>) => Promise<z.infer<R>>
+          : () => Promise<z.infer<R>>
+    : never;
+};
+
+
+// Export singleton instance (will be initialized later)
+export let baseClient: APIClientMethods & {
+  refreshAuth: () => Promise<void>;
+  updateAuthCallbacks: (callbacks: AuthCallbacks) => void;
+};
+
+export const apiClient = {
+${this.generateApiClientMethods()}
+};
+
+/**
+ * Initialize API client with auth callbacks
+ * Call this function in your auth provider setup
+ * 
+ * @example
+ * const authCallbacks = {
+ *   getTokens: () => getStoredTokens(),
+ *   onAuthError: () => router.push('/login'),
+ *   onRefreshToken: async () => {
+ *     await refreshAccessToken();
+ *   },
+ * };
+ * 
+ * initializeAPIClient(authCallbacks);
+ */
+export const initializeAPIClient = (authCallbacks: AuthCallbacks) => {
+  baseClient = createAPIClient(apiConfig, authCallbacks) as any;
+  return baseClient;
+};
+
+// Export for custom usage
+export { createAPIClient };
+export type { AuthCallbacks };
+`;
+  }
+  generateServerClientContent() {
+    return `import { createAPIClient } from './core';
+import { apiConfig } from '../config/endpoints';
+import type { APIEndpoints } from './types';
+
+// Type-safe API client methods for server-side
+type APIClientMethods = {
+  [K in keyof APIEndpoints]: APIEndpoints[K] extends {
+    method: infer M;
+    params?: infer P;
+    query?: infer Q;
+    body?: infer B;
+    response: infer R;
+  }
+    ? M extends 'GET'
+      ? P extends { _type: any }
+        ? Q extends { _type: any }
+          ? (params: P['_type'], query?: Q['_type']) => Promise<R['_type']>
+          : (params: P['_type']) => Promise<R['_type']>
+        : Q extends { _type: any }
+          ? (query?: Q['_type']) => Promise<R['_type']>
+          : () => Promise<R['_type']>
+      : P extends { _type: any }
+        ? B extends { _type: any }
+          ? (params: P['_type'], body: B['_type']) => Promise<R['_type']>
+          : (params: P['_type']) => Promise<R['_type']>
+        : B extends { _type: any }
+          ? (body: B['_type']) => Promise<R['_type']>
+          : () => Promise<R['_type']>
+    : never;
+};
+
+/**
+ * Server-side API client (no auth, direct API calls)
+ * Use this in Server Components, Server Actions, and Route Handlers
+ */
+export const serverClient = createAPIClient(apiConfig) as APIClientMethods;
+`;
+  }
+  generateApiClientMethods() {
+    const methods = [];
+    Object.entries(this.context.apiConfig.endpoints).forEach(
+      ([name, endpoint]) => {
+        const inferParams = this.inferNonNull(
+          `typeof apiConfig.endpoints.${name}.params`
+        );
+        const inferQuery = this.inferNonNull(
+          `typeof apiConfig.endpoints.${name}.query`
+        );
+        const inferBody = this.inferNonNull(
+          `typeof apiConfig.endpoints.${name}.body`
+        );
+        const inferResponse = this.inferNonNull(
+          `typeof apiConfig.endpoints.${name}.response`
+        );
+        if (endpoint.method === "GET") {
+          if (endpoint.params && endpoint.query) {
+            methods.push(`  ${name}: (params: ${inferParams}, query?: ${inferQuery}): Promise<${inferResponse}> => 
+    (baseClient as any).${name}(params, query),`);
+          } else if (endpoint.params) {
+            methods.push(`  ${name}: (params: ${inferParams}): Promise<${inferResponse}> => 
+    (baseClient as any).${name}(params),`);
+          } else if (endpoint.query) {
+            methods.push(`  ${name}: (query?: ${inferQuery}): Promise<${inferResponse}> => 
+    (baseClient as any).${name}(query),`);
+          } else {
+            methods.push(`  ${name}: (): Promise<${inferResponse}> => 
+    (baseClient as any).${name}(),`);
+          }
+        } else {
+          if (endpoint.params && endpoint.body) {
+            methods.push(`  ${name}: (params: ${inferParams}, body: ${inferBody}): Promise<${inferResponse}> => 
+    (baseClient as any).${name}(params, body),`);
+          } else if (endpoint.params) {
+            methods.push(`  ${name}: (params: ${inferParams}): Promise<${inferResponse}> => 
+    (baseClient as any).${name}(params),`);
+          } else if (endpoint.body) {
+            methods.push(`  ${name}: (body: ${inferBody}): Promise<${inferResponse}> => 
+    (baseClient as any).${name}(body),`);
+          } else {
+            methods.push(`  ${name}: (): Promise<${inferResponse}> => 
+    (baseClient as any).${name}(),`);
+          }
+        }
+      }
+    );
+    return methods.join("\n");
+  }
+};
+var QueryKeysGenerator = class extends BaseGenerator {
+  async generate() {
+    const content = this.generateContent();
+    const outputPath = path6.join(
+      this.context.config.outputDir,
+      "query-keys.ts"
+    );
+    await fs5.mkdir(path6.dirname(outputPath), { recursive: true });
+    await fs5.writeFile(outputPath, content, "utf-8");
+  }
+  generateContent() {
+    const outputPath = path6.join(this.context.config.outputDir, "types.ts");
+    const endpointsPath = path6.join(this.context.config.endpointsPath);
+    const relativePath = path6.relative(path6.dirname(outputPath), endpointsPath).replace(/\\/g, "/");
+    const content = `// Auto-generated query keys
+import { z } from 'zod';
+import { apiConfig } from '${relativePath}';
+
+export const queryKeys = {
+${this.generateQueryKeysContent()}
+} as const;
+`;
+    return content;
+  }
+  generateQueryKeysContent() {
+    const resourceGroups = this.groupEndpointsByResource();
+    const keys = [];
+    Object.entries(resourceGroups).forEach(([resource, endpoints]) => {
+      const queryEndpoints = endpoints.filter(
+        ({ endpoint }) => endpoint.method === "GET"
+      );
+      if (queryEndpoints.length === 0) return;
+      const resourceKeys = [`    all: ['${resource}'] as const,`];
+      const added = /* @__PURE__ */ new Set();
+      queryEndpoints.forEach(({ name, endpoint }) => {
+        const keyName = this.getEndpointKeyName(name);
+        if (added.has(keyName)) return;
+        const inferParams = this.inferNonNull(
+          `typeof apiConfig.endpoints.${name}.params`
+        );
+        const inferQuery = this.inferNonNull(
+          `typeof apiConfig.endpoints.${name}.query`
+        );
+        if (endpoint.params || endpoint.query) {
+          const params = [];
+          if (endpoint.params) params.push(`params?: ${inferParams}`);
+          if (endpoint.query) params.push(`query?: ${inferQuery}`);
+          resourceKeys.push(`    ${keyName}: (${params.join(", ")}) =>
+      ['${resource}', '${keyName}', ${endpoint.params ? "params" : "undefined"}, ${endpoint.query ? "query" : "undefined"}] as const,`);
+        } else {
+          resourceKeys.push(
+            `    ${keyName}: () => ['${resource}', '${keyName}'] as const,`
+          );
+        }
+        added.add(keyName);
+      });
+      keys.push(`  ${resource}: {
+${resourceKeys.join("\n")}
+  },`);
+    });
+    return keys.join("\n");
+  }
+};
+var QueryOptionsGenerator = class extends BaseGenerator {
+  async generate() {
+    const content = this.generateContent();
+    const outputPath = path6.join(
+      this.context.config.outputDir,
+      "query-options.ts"
+    );
+    await fs5.mkdir(path6.dirname(outputPath), { recursive: true });
+    await fs5.writeFile(outputPath, content, "utf-8");
+  }
+  generateContent() {
+    const outputPath = path6.join(this.context.config.outputDir, "types.ts");
+    const endpointsPath = path6.join(this.context.config.endpointsPath);
+    const relativePath = path6.relative(path6.dirname(outputPath), endpointsPath).replace(/\\/g, "/");
+    const content = `// Auto-generated query options
+import { queryOptions } from '@tanstack/react-query';
+import { apiClient } from './client';
+import { queryKeys } from './query-keys';
+import { z } from 'zod';
+import { apiConfig } from '${relativePath}';
+
+${this.generateQueryOptionsContent()}
+
+export const apiQueryOptions = {
+${this.generateQueryOptionsExports()}
+} as const;
+`;
+    return content;
+  }
+  generateQueryOptionsContent() {
+    const groups = this.groupEndpointsByResource();
+    const options = [];
+    Object.entries(groups).forEach(([resource, endpoints]) => {
+      const queries = endpoints.filter(
+        ({ endpoint }) => endpoint.method === "GET"
+      );
+      if (queries.length === 0) return;
+      const resourceOptions = [];
+      queries.forEach(({ name, endpoint }) => {
+        const optionName = this.getEndpointKeyName(name);
+        const inferParams = this.inferNonNull(
+          `typeof apiConfig.endpoints.${name}.params`
+        );
+        const inferQuery = this.inferNonNull(
+          `typeof apiConfig.endpoints.${name}.query`
+        );
+        const inferResponse = this.inferNonNull(
+          `typeof apiConfig.endpoints.${name}.response`
+        );
+        const params = [];
+        let apiCall = "";
+        if (endpoint.params && endpoint.query) {
+          params.push(`params: ${inferParams}`, `filters?: ${inferQuery}`);
+          apiCall = `apiClient.${name}(params, filters)`;
+        } else if (endpoint.params) {
+          params.push(`params: ${inferParams}`);
+          apiCall = `apiClient.${name}(params)`;
+        } else if (endpoint.query) {
+          params.push(`filters?: ${inferQuery}`);
+          apiCall = `apiClient.${name}(filters)`;
+        } else {
+          apiCall = `apiClient.${name}()`;
+        }
+        const keyCall = this.generateQueryKeyCall(resource, name, endpoint);
+        resourceOptions.push(`  ${optionName}: (${params.join(", ")}) =>
+    queryOptions({
+      queryKey: ${keyCall},
+      queryFn: (): Promise<${inferResponse}> => ${apiCall},
+      staleTime: 1000 * 60 * 5,
+    }),`);
+      });
+      options.push(
+        `const ${resource}QueryOptions = {
+${resourceOptions.join("\n")}
+};
+`
+      );
+    });
+    return options.join("\n");
+  }
+  generateQueryOptionsExports() {
+    const groups = this.groupEndpointsByResource();
+    const exports$1 = [];
+    Object.keys(groups).forEach((resource) => {
+      const hasQueries = groups[resource].some(
+        ({ endpoint }) => endpoint.method === "GET"
+      );
+      if (hasQueries) exports$1.push(`  ${resource}: ${resource}QueryOptions,`);
+    });
+    return exports$1.join("\n");
+  }
+};
+var PrefetchGenerator = class extends BaseGenerator {
+  async generate() {
+    const content = this.generateContent();
+    const outputPath = path6.join(this.context.config.outputDir, "prefetchs.ts");
+    await fs5.mkdir(path6.dirname(outputPath), { recursive: true });
+    await fs5.writeFile(outputPath, content, "utf-8");
+  }
+  generateContent() {
+    const content = `// Auto-generated prefetch utilities
+import { type QueryClient } from '@tanstack/react-query';
+${this.hasQueryOptions() ? "import { apiQueryOptions } from './query-options';" : ""}
+import { z } from 'zod';
+import { apiConfig } from '../config/endpoints';
+
+${this.generatePrefetchFunctions()}
+`;
+    return content;
+  }
+  generatePrefetchFunctions() {
+    const funcs = [];
+    Object.entries(this.context.apiConfig.endpoints).forEach(
+      ([name, endpoint]) => {
+        if (endpoint.method === "GET")
+          funcs.push(this.generatePrefetchFunction(name, endpoint));
+      }
+    );
+    return funcs.join("\n\n");
+  }
+  generatePrefetchFunction(name, endpoint) {
+    const prefetchName = `prefetch${this.capitalize(name)}`;
+    const resource = this.getResourceFromEndpoint(name, endpoint);
+    const optionName = this.getEndpointKeyName(name);
+    const inferParams = this.inferNonNull(
+      `typeof apiConfig.endpoints.${name}.params`
+    );
+    const inferQuery = this.inferNonNull(
+      `typeof apiConfig.endpoints.${name}.query`
+    );
+    const params = ["queryClient: QueryClient"];
+    const optionParams = [];
+    if (endpoint.params) {
+      params.push(`params: ${inferParams}`);
+      optionParams.push("params");
+    }
+    if (endpoint.query) {
+      params.push(`filters?: ${inferQuery}`);
+      optionParams.push("filters");
+    }
+    return `export const ${prefetchName} = async (${params.join(",\n  ")}) => {
+  return await queryClient.ensureQueryData(apiQueryOptions.${resource}.${optionName}(${optionParams.join(", ")}));
+};`;
+  }
+};
+var SchemaGenerator = class extends BaseGenerator {
+  async generate() {
+    const content = this.generateContent();
+    const outputPath = path6.join(this.context.config.outputDir, "schema.ts");
+    await fs5.mkdir(path6.dirname(outputPath), { recursive: true });
+    await fs5.writeFile(outputPath, content, "utf-8");
+  }
+  generateContent() {
+    const content = `// Auto-generated schema definitions
+
+import type { z } from 'zod';
+
+export type HTTPMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+
+export interface APIEndpoint {
+  path: string;
+  method: HTTPMethod;
+  baseUrl?: string;
+  params?: z.ZodType<any>;
+  query?: z.ZodType<any>;
+  body?: z.ZodType<any>;
+  response: z.ZodType<any>;
+  tags?: string[];
+  description?: string;
+}
+
+export interface APIConfig {
+  baseUrl?: string;
+  endpoints: Record<string, APIEndpoint>;
+}
+
+export type EndpointConfig<
+  TPath extends string = string,
+  TMethod extends HTTPMethod = HTTPMethod,
+  TParams = undefined,
+  TQuery = undefined,
+  TBody = undefined,
+  TResponse = any,
+> = {
+  path: TPath;
+  method: TMethod;
+  baseUrl?: string;
+  params?: z.ZodType<TParams>;
+  query?: z.ZodType<TQuery>;
+  body?: z.ZodType<TBody>;
+  response: z.ZodType<TResponse>;
+  tags?: string[];
+  description?: string;
+};
+
+/**
+ * Helper function to define API configuration with type safety
+ */
+export function defineConfig<T extends APIConfig>(config: T): T {
+  return config;
+}
+
+/**
+ * Helper function to define a single endpoint with type inference
+ */
+export function defineEndpoint<
+  TPath extends string,
+  TMethod extends HTTPMethod,
+  TParams = undefined,
+  TQuery = undefined,
+  TBody = undefined,
+  TResponse = any,
+>(
+  config: EndpointConfig<TPath, TMethod, TParams, TQuery, TBody, TResponse>,
+): EndpointConfig<TPath, TMethod, TParams, TQuery, TBody, TResponse> {
+  return config;
+}
+
+/**
+ * Helper to define multiple endpoints
+ */
+export function defineEndpoints<
+  T extends Record<string, APIEndpoint>,
+>(endpoints: T): T {
+  return endpoints;
+}
+  }
+  `;
+    return content;
+  }
+};
+var CoreGenerator = class extends BaseGenerator {
+  async generate() {
+    const content = this.generateContent();
+    const outputPath = path6.join(this.context.config.outputDir, "core.ts");
+    await fs5.mkdir(path6.dirname(outputPath), { recursive: true });
+    await fs5.writeFile(outputPath, content, "utf-8");
+  }
+  generateContent() {
+    const content = `// Auto-generated schema definitions
+
+import ky, { HTTPError } from "ky";
+import type { APIConfig, APIEndpoint } from "../config/schema.js";
+
+export interface AuthTokens {
+  accessToken: string;
+  refreshToken?: string;
+}
+
+export interface AuthCallbacks {
+  getTokens: () => Promise<AuthTokens | null>;
+  onAuthError?: () => void;
+  onRefreshToken?: () => Promise<void>;
+}
+
+export class APIError extends Error {
+  constructor(
+    message: string,
+    public status: number,
+    public response?: any,
+  ) {
+    super(message);
+    this.name = "APIError";
+  }
+}
+
+export class AuthError extends APIError {
+  constructor(message: string = "Authentication failed") {
+    super(message, 401);
+    this.name = "AuthError";
+  }
+}
+
+export class APIClient {
+  private client: typeof ky;
+  private isRefreshing = false;
+  private refreshPromise: Promise<void> | null = null;
+  private hooks: any;
+
+  constructor(
+    private config: APIConfig,
+    private authCallbacks?: AuthCallbacks,
+  ) {
+    this.hooks = {
+      beforeRequest: [
+        async (request: Request) => {
+          const tokens = await this.authCallbacks?.getTokens();
+          if (tokens?.accessToken) {
+            request.headers.set(
+              "Authorization",
+              \`Bearer \${tokens.accessToken}\`,
+            );
+          }
+        },
+      ],
+      beforeRetry: [
+        async ({ request, error, retryCount }: any) => {
+          if (error instanceof HTTPError && error.response.status === 401) {
+            if (retryCount === 1 && this.authCallbacks) {
+              try {
+                await this.refreshTokens();
+                const tokens = await this.authCallbacks.getTokens();
+                if (tokens?.accessToken) {
+                  request.headers.set(
+                    "Authorization",
+                    \`Bearer \${tokens.accessToken}\`,
+                  );
+                }
+              } catch (refreshError) {
+                this.authCallbacks.onAuthError?.();
+                throw new AuthError();
+              }
+            } else {
+              this.authCallbacks?.onAuthError?.();
+              throw new AuthError();
+            }
+          }
+        },
+      ],
+      beforeError: [
+        async (error: any) => {
+          const { response } = error;
+          if (response?.body) {
+            try {
+              const body = await response.json();
+              error.message =
+                (body as Error).message || \`HTTP \${response.status}\`;
+            } catch {
+              // Keep original message
+            }
+          }
+          return error;
+        },
+      ],
+    };
+
+    this.client = ky.create({
+      prefixUrl: this.config.baseUrl,
+      headers: {
+        "Content-Type": "application/json",
+      },
+      retry: {
+        limit: 2,
+        methods: ["get", "post", "put", "delete", "patch"],
+        statusCodes: [401],
+      },
+      hooks: this.hooks,
+    });
+  }
+
+  private async refreshTokens(): Promise<void> {
+    if (!this.authCallbacks) {
+      throw new AuthError("No auth callbacks provided");
+    }
+
+    if (this.isRefreshing && this.refreshPromise) {
+      return this.refreshPromise;
+    }
+
+    this.isRefreshing = true;
+
+    this.refreshPromise = (async () => {
+      try {
+        if (this.authCallbacks?.onRefreshToken) {
+          await this.authCallbacks.onRefreshToken();
+        } else {
+          throw new AuthError("No refresh token handler provided");
+        }
+      } catch (error) {
+        throw error;
+      } finally {
+        this.isRefreshing = false;
+        this.refreshPromise = null;
+      }
+    })();
+
+    return this.refreshPromise;
+  }
+
+  private buildPath(path: string, params?: Record<string, any>): string {
+    if (!params) return path;
+
+    let finalPath = path;
+    Object.entries(params).forEach(([key, value]) => {
+      finalPath = finalPath.replace(
+        \`:\${key}\`,
+        encodeURIComponent(String(value)),
+      );
+    });
+
+    return finalPath;
+  }
+
+  private getEndpointBaseUrl(endpoint: APIEndpoint): string {
+    return endpoint.baseUrl || this.config.baseUrl!;
+  }
+
+  private getClientForEndpoint(endpoint: APIEndpoint): typeof ky {
+    const endpointBaseUrl = this.getEndpointBaseUrl(endpoint);
+
+    if (endpointBaseUrl === this.config.baseUrl) {
+      return this.client;
+    }
+
+    return ky.create({
+      prefixUrl: endpointBaseUrl,
+      headers: {
+        "Content-Type": "application/json",
+      },
+      retry: {
+        limit: 2,
+        methods: ["get", "post", "put", "delete", "patch"],
+        statusCodes: [401],
+      },
+      hooks: this.hooks,
+    });
+  }
+
+  async request<T>(
+    endpoint: APIEndpoint,
+    params?: Record<string, any>,
+    query?: Record<string, any>,
+    body?: any,
+  ): Promise<T> {
+    try {
+      const path = this.buildPath(endpoint.path, params);
+      const client = this.getClientForEndpoint(endpoint);
+
+      const options: Record<string, any> = {
+        method: endpoint.method,
+      };
+
+      if (query && Object.keys(query).length > 0) {
+        const searchParams = new URLSearchParams();
+        Object.entries(query).forEach(([key, value]) => {
+          if (value !== undefined && value !== null) {
+            searchParams.append(key, String(value));
+          }
+        });
+        if (searchParams.toString()) {
+          options.searchParams = searchParams;
+        }
+      }
+
+      if (body && endpoint.method !== "GET") {
+        if (endpoint.body) {
+          const validatedBody = endpoint.body.parse(body);
+          options.json = validatedBody;
+        } else {
+          options.json = body;
+        }
+      }
+
+      const response = await client(path, options);
+      const data = await response.json();
+
+      if (endpoint.response) {
+        return endpoint.response.parse(data);
+      }
+
+      return data as T;
+    } catch (error) {
+      if (error instanceof HTTPError) {
+        const errorData = await error.response.json().catch(() => ({}));
+        throw new APIError(
+          errorData.message || error.message,
+          error.response.status,
+          errorData,
+        );
+      }
+
+      if (error instanceof AuthError) {
+        throw error;
+      }
+
+      throw new APIError(
+        error instanceof Error ? error.message : "Network error",
+        0,
+      );
+    }
+  }
+
+  updateAuthCallbacks(authCallbacks: AuthCallbacks) {
+    this.authCallbacks = authCallbacks;
+  }
+
+  async refreshAuth(): Promise<void> {
+    if (!this.authCallbacks) {
+      throw new AuthError("No auth callbacks provided");
+    }
+    await this.refreshTokens();
+  }
+
+  generateMethods() {
+    const methods: any = {};
+
+    Object.entries(this.config.endpoints).forEach(([name, endpoint]) => {
+      if (endpoint.method === "GET") {
+        if (endpoint.params && endpoint.query) {
+          methods[name] = (params: any, query?: any): Promise<any> => {
+            return this.request(endpoint, params, query);
+          };
+        } else if (endpoint.params) {
+          methods[name] = (params: any): Promise<any> => {
+            return this.request(endpoint, params);
+          };
+        } else if (endpoint.query) {
+          methods[name] = (query?: any): Promise<any> => {
+            return this.request(endpoint, undefined, query);
+          };
+        } else {
+          methods[name] = (): Promise<any> => {
+            return this.request(endpoint);
+          };
+        }
+      } else {
+        if (endpoint.params && endpoint.body) {
+          methods[name] = (params: any, body: any): Promise<any> => {
+            return this.request(endpoint, params, undefined, body);
+          };
+        } else if (endpoint.params) {
+          methods[name] = (params: any): Promise<any> => {
+            return this.request(endpoint, params);
+          };
+        } else if (endpoint.body) {
+          methods[name] = (body: any): Promise<any> => {
+            return this.request(endpoint, undefined, undefined, body);
+          };
+        } else {
+          methods[name] = (): Promise<any> => {
+            return this.request(endpoint);
+          };
+        }
+      }
+    });
+
+    return methods;
+  }
+}
+
+export function createAPIClient(
+  config: APIConfig,
+  authCallbacks?: AuthCallbacks,
+) {
+  const instance = new APIClient(config, authCallbacks);
+  const methods = instance.generateMethods();
+
+  return {
+    ...methods,
+    refreshAuth: () => instance.refreshAuth(),
+    updateAuthCallbacks: (newCallbacks: AuthCallbacks) =>
+      instance.updateAuthCallbacks(newCallbacks),
+  };
+}
+`;
+    return content;
+  }
+};
+
+// src/generators/index.ts
+var CodeGenerator = class {
+  constructor(context) {
+    this.context = context;
+  }
+  async generate() {
+    const generators = this.getGenerators();
+    for (const generator of generators) {
+      await generator.generate();
+    }
+  }
+  getGenerators() {
+    const generators = [];
+    generators.push(new TypesGenerator(this.context));
+    generators.push(new SchemaGenerator(this.context));
+    generators.push(new CoreGenerator(this.context));
+    if (this.context.config.generateClient) {
+      generators.push(new ClientGenerator(this.context));
+    }
+    if (this.context.config.generateHooks) {
+      generators.push(new QueryKeysGenerator(this.context));
+      generators.push(new QueryOptionsGenerator(this.context));
+      generators.push(new HooksGenerator(this.context));
+    }
+    if (this.context.config.generatePrefetch) {
+      generators.push(new PrefetchGenerator(this.context));
+    }
+    if (this.context.config.generateServerActions && this.context.config.provider === "nextjs") {
+      generators.push(new ServerActionsGenerator(this.context));
+    }
+    if (this.context.config.generateServerQueries && this.context.config.provider === "nextjs") {
+      generators.push(new ServerQueriesGenerator(this.context));
+    }
+    return generators;
+  }
+};
+var CodegenCore = class {
+  constructor(config) {
+    this.config = config;
+  }
+  async execute() {
+    const apiConfig = await this.loadAPIConfig();
+    this.config.apiConfig = apiConfig;
+    const generator = new CodeGenerator({
+      config: this.config,
+      apiConfig
+    });
+    await generator.generate();
+  }
+  async loadAPIConfig() {
+    try {
+      const jiti = createJiti(fileURLToPath(import.meta.url), {
+        interopDefault: true
+      });
+      const module = await jiti.import(this.config.endpointsPath);
+      const apiConfig = module.apiConfig || module.default?.apiConfig || module.default || module;
+      if (!apiConfig || !apiConfig.endpoints) {
+        throw new Error(
+          'Invalid API config: must export an object with "endpoints" property'
+        );
+      }
+      return apiConfig;
+    } catch (error) {
+      throw new Error(
+        `Failed to load endpoints from "${this.config.endpointsPath}": ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+  }
+};
+var program = new Command();
+program.name("api-codegen").description("Generate type-safe API client code from endpoint definitions").version("1.0.0");
+program.command("generate").alias("gen").description("Generate API client code from configuration").option("-c, --config <path>", "Path to configuration file").option("-w, --watch", "Watch for changes and regenerate").action(async (options) => {
+  const spinner = ora("Loading configuration...").start();
+  try {
+    const config = await loadConfig(options.config);
+    if (!config) {
+      spinner.fail(
+        chalk.red(
+          "No configuration file found. Please create an api-codegen.config.js file."
+        )
+      );
+      process.exit(1);
+    }
+    spinner.text = "Validating configuration...";
+    validateConfig(config);
+    spinner.text = "Loading API endpoints...";
+    const codegen = new CodegenCore(config);
+    spinner.text = "Generating code...";
+    await codegen.execute();
+    spinner.succeed(
+      chalk.green(
+        `\u2728 Code generated successfully in ${chalk.cyan(config.outputDir)}`
+      )
+    );
+    console.log(chalk.dim("\nGenerated files:"));
+    const files = await fs5.readdir(config.outputDir);
+    files.forEach((file) => {
+      console.log(chalk.dim(`  \u2022 ${file}`));
+    });
+    if (options.watch) {
+      console.log(chalk.yellow("\n\u{1F440} Watching for changes..."));
+      spinner.info(chalk.dim("Watch mode not yet implemented"));
+    }
+  } catch (error) {
+    spinner.fail(chalk.red("Failed to generate code"));
+    console.error(
+      chalk.red("\n" + (error instanceof Error ? error.message : String(error)))
+    );
+    if (error instanceof Error && error.stack) {
+      console.error(chalk.dim(error.stack));
+    }
+    process.exit(1);
+  }
+});
+program.command("init").description("Initialize a new api-codegen configuration").option("-p, --provider <provider>", "Provider type (vite or nextjs)", "vite").action(async (options) => {
+  const spinner = ora("Creating configuration file...").start();
+  try {
+    const configContent = generateConfigTemplate(options.provider);
+    const configPath = path6.join(process.cwd(), "api-codegen.config.js");
+    try {
+      await fs5.access(configPath);
+      spinner.warn(
+        chalk.yellow(
+          "Configuration file already exists at api-codegen.config.js"
+        )
+      );
+      return;
+    } catch {
+    }
+    await fs5.writeFile(configPath, configContent, "utf-8");
+    spinner.succeed(
+      chalk.green("\u2728 Configuration file created: api-codegen.config.js")
+    );
+    console.log(chalk.dim("\nNext steps:"));
+    console.log(chalk.dim("  1. Update the endpoints path in the config"));
+    console.log(chalk.dim("  2. Run: npx @cushin/api-codegen generate"));
+  } catch (error) {
+    spinner.fail(chalk.red("Failed to create configuration file"));
+    console.error(
+      chalk.red("\n" + (error instanceof Error ? error.message : String(error)))
+    );
+    process.exit(1);
+  }
+});
+program.command("validate").description("Validate your API endpoints configuration").option("-c, --config <path>", "Path to configuration file").action(async (options) => {
+  const spinner = ora("Loading configuration...").start();
+  try {
+    const config = await loadConfig(options.config);
+    if (!config) {
+      spinner.fail(chalk.red("No configuration file found"));
+      process.exit(1);
+    }
+    spinner.text = "Validating configuration...";
+    validateConfig(config);
+    spinner.text = "Loading API endpoints...";
+    new CodegenCore(config);
+    const apiConfigModule = await import(pathToFileURL(config.endpointsPath).href);
+    const apiConfig = apiConfigModule.apiConfig || apiConfigModule.default?.apiConfig || apiConfigModule.default;
+    if (!apiConfig || !apiConfig.endpoints) {
+      throw new Error("Invalid endpoints configuration");
+    }
+    const endpointCount = Object.keys(apiConfig.endpoints).length;
+    spinner.succeed(
+      chalk.green(
+        `\u2728 Configuration is valid! Found ${endpointCount} endpoint${endpointCount === 1 ? "" : "s"}`
+      )
+    );
+    console.log(chalk.dim("\nEndpoints:"));
+    Object.entries(apiConfig.endpoints).forEach(([name, endpoint]) => {
+      console.log(
+        chalk.dim(
+          `  \u2022 ${chalk.cyan(name)}: ${endpoint.method} ${endpoint.path}`
+        )
+      );
+    });
+  } catch (error) {
+    spinner.fail(chalk.red("Validation failed"));
+    console.error(
+      chalk.red("\n" + (error instanceof Error ? error.message : String(error)))
+    );
+    process.exit(1);
+  }
+});
+function generateConfigTemplate(provider) {
+  return `/** @type {import('@cushin/api-codegen').UserConfig} */
+export default {
+  // Provider: 'vite' or 'nextjs'
+  provider: '${provider}',
+
+  // Path to your API endpoints configuration
+  endpoints: './lib/api/config/endpoints.ts',
+
+  // Output directory for generated files
+  output: './lib/api/generated',
+
+  // Base URL for API requests (optional, can be set at runtime)
+  baseUrl: process.env.VITE_API_URL || process.env.NEXT_PUBLIC_API_URL,
+
+  // Generation options
+  generateHooks: true,
+  generateClient: true,
+  ${provider === "nextjs" ? `generateServerActions: true,
+  generateServerQueries: true,` : ""}
+
+  // Advanced options
+  options: {
+    useClientDirective: true,
+    hookPrefix: 'use',
+    actionSuffix: 'Action',
+  },
+};
+`;
+}
+function pathToFileURL(filePath) {
+  return new URL(`file://${path6.resolve(filePath)}`);
+}
+program.parse();
+//# sourceMappingURL=cli.js.map
+//# sourceMappingURL=cli.js.map