routesync 1.0.14 → 1.0.16

package/README.md

@@ -249,6 +249,20 @@ const api = defineApi({
 }, config)
 ```
 
+> **Note on Laravel Auto-generation:** When using `routesync sync` or `routesync scan` with the `--zod` flag, RouteSync uses PHP Reflection to automatically generate Zod schemas based on your backend validation rules. 
+> 
+> **Important:** To ensure your schemas are detected automatically, you **must use Laravel `FormRequest` classes**. Inline `$request->validate([...])` calls inside Controller methods cannot be reliably extracted.
+> 
+> ```php
+> // ✅ DO THIS: RouteSync will generate Zod schemas automatically
+> public function store(StoreProductRequest $request)
+> 
+> // ❌ AVOID THIS: Validation rules will be ignored
+> public function store(Request $request) {
+>     $request->validate([...]);
+> }
+> ```
+
 ---
 
 ### Auto-generate TanStack hooks from defineApi

package/dist/cli.js

@@ -8406,6 +8406,31 @@ foreach ($routes as $route) {
                         }
                     }
                 }
+                
+                // Fallback: Try to parse $request->validate([...]) from source code
+                if (empty($schema)) {
+                    $fileName = $reflector->getFileName();
+                    $startLine = $reflector->getStartLine();
+                    $endLine = $reflector->getEndLine();
+                    
+                    if ($fileName && $startLine !== false && $endLine !== false) {
+                        $lines = file($fileName);
+                        // startLine is 1-indexed
+                        $methodSource = implode("", array_slice($lines, $startLine - 1, $endLine - $startLine + 1));
+                        
+                        // Look for $request->validate([ ... ])
+                        if (preg_match('/\\\\$request->validate\\\\s*\\\\(\\\\s*\\\\[(.*?)\\\\]\\\\s*\\\\)/s', $methodSource, $matches)) {
+                            $rulesString = $matches[1];
+                            // Match 'field' => 'rules'
+                            preg_match_all('~[\\'"]([a-zA-Z0-9_.*]+)[\\'"]\\\\s*=>\\\\s*[\\'"](.*?)[\\'"]~', $rulesString, $ruleMatches);
+                            if (!empty($ruleMatches[1])) {
+                                foreach ($ruleMatches[1] as $index => $field) {
+                                    $schema[$field] = $ruleMatches[2][$index];
+                                }
+                            }
+                        }
+                    }
+                }
             } catch (\\Exception $e) {}
         }
     }
@@ -8689,11 +8714,11 @@ var SDKGenerator = class _SDKGenerator {
         if (r.startsWith("min:")) min = r.split(":")[1];
         if (r.startsWith("max:")) max = r.split(":")[1];
       }
-      let zType = "z.any()";
+      let zType = "z.unknown()";
       if (isString) zType = "z.string()";
       else if (isNumeric) zType = "z.number()";
       else if (isBoolean) zType = "z.boolean()";
-      else if (isArray) zType = "z.array(z.any())";
+      else if (isArray) zType = "z.array(z.unknown())";
       else if (isEmail) zType = "z.string()";
       if (isEmail && zType === "z.string()") zType += ".email()";
       if (min && !isNaN(Number(min))) zType += `.min(${min})`;
@@ -8742,40 +8767,59 @@ var TypeGenerator = class {
     lines.push(`  status?: number`);
     lines.push(`}`);
     lines.push(``);
-    const resources = new Set(
-      manifest.routes.map((r) => r.path.replace(/^\//, "").split("/")[0])
-    );
-    for (const resource of resources) {
-      const typeName = toTypeName(resource ?? "");
-      lines.push(`export interface ${typeName} {`);
-      lines.push(`  id: number`);
-      lines.push(`  // TODO: Add ${resource} fields`);
-      lines.push(`  created_at?: string`);
-      lines.push(`  updated_at?: string`);
-      lines.push(`}`);
-      lines.push(``);
+    if (manifest.models && manifest.models.length > 0) {
+      for (const model of manifest.models) {
+        lines.push(`export interface ${model.name} {`);
+        for (const col of model.columns) {
+          if (model.hidden && model.hidden.includes(col.name)) continue;
+          const tsType = this.mapSqlTypeToTs(col.type);
+          const isOptional = col.nullable ? "?" : "";
+          lines.push(`  ${col.name}${isOptional}: ${tsType}`);
+        }
+        if (model.appends && model.appends.length > 0) {
+          for (const append of model.appends) {
+            lines.push(`  ${append}?: unknown`);
+          }
+        }
+        lines.push(`}`);
+        lines.push(``);
+      }
+    } else {
+      const resources = new Set(
+        manifest.routes.map((r) => r.path.replace(/^\//, "").split("/")[0])
+      );
+      for (const resource of resources) {
+        const typeName = toTypeName(resource ?? "");
+        lines.push(`export interface ${typeName} {`);
+        lines.push(`  id: number`);
+        lines.push(`  // TODO: Add ${resource} fields`);
+        lines.push(`  created_at?: string`);
+        lines.push(`  updated_at?: string`);
+        lines.push(`}`);
+        lines.push(``);
+      }
     }
     if (hasSchemas) {
       for (const route of manifest.routes) {
-        if (route.schema && Object.keys(route.schema).length > 0) {
+        if (route.schema && route.schema.rules && Object.keys(route.schema.rules).length > 0) {
           const actionName = toMethodName(route);
           const schemaName = actionName + "Schema";
           lines.push(`export const ${schemaName} = z.object({`);
-          for (const [field, rules] of Object.entries(route.schema)) {
+          for (const [field, rules] of Object.entries(route.schema.rules)) {
             const ruleStr = Array.isArray(rules) ? rules.join("|") : String(rules);
             let zodRule = "z.string()";
-            if (ruleStr.includes("numeric") || ruleStr.includes("integer")) {
+            if (ruleStr.includes("numeric") || ruleStr.includes("integer") || ruleStr.includes("int")) {
               zodRule = "z.number()";
-            } else if (ruleStr.includes("boolean")) {
+            } else if (ruleStr.includes("boolean") || ruleStr.includes("bool")) {
               zodRule = "z.boolean()";
             } else if (ruleStr.includes("array")) {
               zodRule = "z.array(z.unknown())";
             }
             if (ruleStr.includes("email")) zodRule += ".email()";
             if (ruleStr.includes("url")) zodRule += ".url()";
-            const matchMin = ruleStr.match(/min:(\\d+)/);
+            const matchMin = ruleStr.match(/min:(\d+)/);
             if (matchMin) zodRule += ".min(" + matchMin[1] + ")";
-            const matchMax = ruleStr.match(/max:(\\d+)/);
+            const matchMax = ruleStr.match(/max:(\d+)/);
             if (matchMax) zodRule += ".max(" + matchMax[1] + ")";
             if (!ruleStr.includes("required")) {
               zodRule += ".optional()";
@@ -8793,6 +8837,13 @@ var TypeGenerator = class {
     }
     await import_fs_extra4.default.writeFile(import_path3.default.join(outputDir, "types.ts"), lines.join("\n"));
   }
+  static mapSqlTypeToTs(sqlType) {
+    const type = sqlType.toLowerCase();
+    if (type.includes("int") || type.includes("decimal") || type.includes("float") || type.includes("double")) return "number";
+    if (type.includes("bool") || type.includes("tinyint(1)")) return "boolean";
+    if (type.includes("json")) return "unknown";
+    return "string";
+  }
 };
 
 // packages/cli/src/generators/HookGenerator.ts
@@ -8805,26 +8856,38 @@ var HookGenerator = class _HookGenerator {
     lines.push(``);
     lines.push(`import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query'`);
     lines.push(`import { api } from './api'`);
+    lines.push(`import * as Types from './types'`);
     lines.push(``);
     const grouped = buildGeneratedRoutes(manifest.routes);
+    const modelNames = (manifest.models || []).map((m) => m.name);
     for (const [group, routes] of Object.entries(grouped)) {
       for (const route of routes) {
         const method = route.method.toUpperCase();
         const hookName = _HookGenerator.toHookName(group, route.actionName);
         const queryKey = `['${group}', '${route.actionName}']`;
+        const possibleModel = _HookGenerator.findMatchingModel(group, modelNames);
+        let responseType = "unknown";
+        if (possibleModel) {
+          if (route.actionName === "get" || route.actionName === "index" || !route.runtimePath.includes(":") && method === "GET") {
+            responseType = `Types.${possibleModel}[]`;
+          } else {
+            responseType = `Types.${possibleModel}`;
+          }
+        }
+        const returnType = possibleModel ? `Types.ApiResponse<${responseType}>` : `unknown`;
         if (method === "GET") {
-          lines.push(`export function ${hookName}(params?: Record<string, unknown>) {`);
-          lines.push(`  return useQuery({`);
+          lines.push(`export function ${hookName}<TData = ${returnType}>(params?: Record<string, unknown>) {`);
+          lines.push(`  return useQuery<TData>({`);
           lines.push(`    queryKey: ${queryKey},`);
-          lines.push(`    queryFn: () => api.${group}.${route.actionName}({ query: params })`);
+          lines.push(`    queryFn: () => api.${group}.${route.actionName}({ query: params }) as Promise<TData>`);
           lines.push(`  })`);
           lines.push(`}`);
           lines.push(``);
         } else {
-          lines.push(`export function ${hookName}() {`);
+          lines.push(`export function ${hookName}<TData = ${returnType}>() {`);
           lines.push(`  const queryClient = useQueryClient()`);
-          lines.push(`  return useMutation({`);
-          lines.push(`    mutationFn: (data: Record<string, unknown>) => api.${group}.${route.actionName}({ body: data }),`);
+          lines.push(`  return useMutation<TData, Error, Record<string, unknown>>({`);
+          lines.push(`    mutationFn: (data: Record<string, unknown>) => api.${group}.${route.actionName}({ body: data }) as Promise<TData>,`);
           lines.push(`    onSuccess: () => {`);
           lines.push(`      queryClient.invalidateQueries({ queryKey: ['${group}'] })`);
           lines.push(`    }`);
@@ -8839,6 +8902,16 @@ var HookGenerator = class _HookGenerator {
   static toHookName(group, actionName) {
     return `use${toTypeName(group)}${toTypeName(actionName)}`;
   }
+  static findMatchingModel(group, modelNames) {
+    const exact = modelNames.find((m) => m.toLowerCase() === group.toLowerCase());
+    if (exact) return exact;
+    const singularGroup = group.toLowerCase().replace(/ies$/, "y").replace(/s$/, "");
+    const singularMatch = modelNames.find((m) => m.toLowerCase() === singularGroup);
+    if (singularMatch) return singularMatch;
+    const prefixMatch = modelNames.find((m) => m.toLowerCase().startsWith(group.toLowerCase()) || m.toLowerCase().startsWith(singularGroup));
+    if (prefixMatch) return prefixMatch;
+    return void 0;
+  }
 };
 
 // packages/cli/src/generators/NextActionGenerator.ts
@@ -9057,7 +9130,7 @@ var ModelGenerator = class {
 };
 
 // packages/cli/src/commands/generate.ts
-var generateCommand = new Command("generate").description("Generate typed SDK, types, and hooks from route manifest").option("-m, --manifest <path>", "Path to route manifest", "routesync.manifest.json").option("-o, --output <path>", "Output directory", "src/api").option("--no-hooks", "Skip generating React hooks").option("--next-actions", "Generate Next.js Server Actions").option("--msw", "Generate MSW Mock Handlers").option("--echo", "Generate Laravel Echo Hooks").action(async (options) => {
+var generateCommand = new Command("generate").description("Generate typed SDK, types, and hooks from route manifest").option("-m, --manifest <path>", "Path to route manifest", "routesync.manifest.json").option("-o, --output <path>", "Output directory", "src/api").option("--no-hooks", "Skip generating React hooks").option("--next-actions", "Generate Next.js Server Actions").option("--msw", "Generate MSW Mock Handlers").option("--echo", "Generate Laravel Echo Hooks").option("--zod", "Generate Zod schemas for validation").action(async (options) => {
   const spinner = ora("Generating SDK...").start();
   try {
     if (!import_fs_extra11.default.existsSync(options.manifest)) {
@@ -9070,7 +9143,7 @@ var generateCommand = new Command("generate").description("Generate typed SDK, t
     spinner.text = "Generating types...";
     await TypeGenerator.generate(manifest, options.output);
     spinner.text = "Generating SDK...";
-    await SDKGenerator.generate(manifest, options.output);
+    await SDKGenerator.generate(manifest, options.output, options);
     if (options.hooks !== false) {
       spinner.text = "Generating hooks...";
       await HookGenerator.generate(manifest, options.output);

package/dist/react.d.mts

@@ -45,7 +45,7 @@ type CallOptions = {
     headers?: Record<string, string>;
 };
 interface EndpointCallable {
-    (options?: CallOptions): Promise<any>;
+    <TResponse = unknown>(options?: CallOptions): Promise<TResponse>;
     /** Original RouteDefinition — used by useApiQuery / useApiMutation */
     $def: RouteDefinition;
     /** Stable TanStack query key: [group, action] */

package/dist/react.d.ts

@@ -45,7 +45,7 @@ type CallOptions = {
     headers?: Record<string, string>;
 };
 interface EndpointCallable {
-    (options?: CallOptions): Promise<any>;
+    <TResponse = unknown>(options?: CallOptions): Promise<TResponse>;
     /** Original RouteDefinition — used by useApiQuery / useApiMutation */
     $def: RouteDefinition;
     /** Stable TanStack query key: [group, action] */

package/dist/sdk.d.mts

@@ -106,7 +106,7 @@ type CallOptions = {
     headers?: Record<string, string>;
 };
 interface EndpointCallable {
-    (options?: CallOptions): Promise<any>;
+    <TResponse = unknown>(options?: CallOptions): Promise<TResponse>;
     /** Original RouteDefinition — used by useApiQuery / useApiMutation */
     $def: RouteDefinition;
     /** Stable TanStack query key: [group, action] */

package/dist/sdk.d.ts

@@ -106,7 +106,7 @@ type CallOptions = {
     headers?: Record<string, string>;
 };
 interface EndpointCallable {
-    (options?: CallOptions): Promise<any>;
+    <TResponse = unknown>(options?: CallOptions): Promise<TResponse>;
     /** Original RouteDefinition — used by useApiQuery / useApiMutation */
     $def: RouteDefinition;
     /** Stable TanStack query key: [group, action] */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "routesync",
-  "version": "1.0.14",
+  "version": "1.0.16",
   "description": "Laravel routes to typed frontend SDKs.",
   "main": "./dist/sdk.js",
   "module": "./dist/sdk.mjs",