zodvex 0.7.1-beta.0 → 0.7.1-beta.1

package/dist/cli/commands.d.ts

@@ -1,9 +1,13 @@
 /**
  * One-shot codegen. Discovers modules, generates files.
  */
-export declare function generate(convexDir?: string): Promise<void>;
+export declare function generate(convexDir?: string, options?: {
+    mini?: boolean;
+}): Promise<void>;
 /**
  * Watch mode. Runs generate() once, then watches for changes.
  */
-export declare function dev(convexDir?: string): Promise<void>;
+export declare function dev(convexDir?: string, options?: {
+    mini?: boolean;
+}): Promise<void>;
 //# sourceMappingURL=commands.d.ts.map

package/dist/cli/commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":"AAUA;;GAEG;AACH,wBAAsB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqChE;AAED;;GAEG;AACH,wBAAsB,GAAG,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoC3D"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":"AAUA;;GAEG;AACH,wBAAsB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAsC9F;AAED;;GAEG;AACH,wBAAsB,GAAG,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAoCzF"}

package/dist/cli/index.js

@@ -555,14 +555,18 @@ async function discoverModules(convexDir2) {
 // src/codegen/zodToSource.ts
 function zodToSource(schema, ctx) {
   if (schema instanceof $ZodOptional) {
-    return `${zodToSource(schema._zod.def.innerType, ctx)}.optional()`;
+    const inner = zodToSource(schema._zod.def.innerType, ctx);
+    return ctx?.mini ? `z.optional(${inner})` : `${inner}.optional()`;
   }
   if (schema instanceof $ZodNullable) {
-    return `${zodToSource(schema._zod.def.innerType, ctx)}.nullable()`;
+    const inner = zodToSource(schema._zod.def.innerType, ctx);
+    return ctx?.mini ? `z.nullable(${inner})` : `${inner}.nullable()`;
   }
-  if (schema instanceof $ZodString && schema.description?.startsWith("convexId:")) {
-    const tableName = schema.description.slice("convexId:".length);
-    return `zx.id("${tableName}")`;
+  if (schema instanceof $ZodString) {
+    const tableName = schema._tableName ?? (schema.description?.startsWith("convexId:") ? schema.description.slice("convexId:".length) : void 0);
+    if (tableName) {
+      return `zx.id("${tableName}")`;
+    }
   }
   if (schema instanceof $ZodCodec && schema._zod.def.in instanceof $ZodNumber && schema._zod.def.out instanceof $ZodCustom) {
     return "zx.date()";
@@ -640,28 +644,38 @@ ${exports$1}
 `;
   return { js: content, dts: content };
 }
-function tryUnwrapToIdentity(schema, identityMap) {
+function tryUnwrapToIdentity(schema, identityMap, mini) {
   let current = schema;
-  const suffixes = [];
+  const wrappers = [];
   const maxDepth = 5;
   for (let i = 0; i < maxDepth; i++) {
     if (current instanceof $ZodOptional) {
-      suffixes.push(".optional()");
+      wrappers.push("optional");
       current = current._zod.def.innerType;
     } else if (current instanceof $ZodNullable) {
-      suffixes.push(".nullable()");
+      wrappers.push("nullable");
       current = current._zod.def.innerType;
     } else {
       break;
     }
     const ref = identityMap.get(current);
     if (ref) {
-      return { ref, suffix: suffixes.reverse().join("") };
+      const reversed = [...wrappers].reverse();
+      return {
+        ref,
+        wrapSource: (inner) => {
+          let result = inner;
+          for (const w of reversed) {
+            result = mini ? `z.${w}(${result})` : `${result}.${w}()`;
+          }
+          return result;
+        }
+      };
     }
   }
   return null;
 }
-function tryMatchPartial(schema, identityMap) {
+function tryMatchPartial(schema, identityMap, mini) {
   if (!(schema instanceof $ZodObject)) return null;
   const candidateShape = schema._zod.def.shape;
   const candidateKeys = Object.keys(candidateShape).sort();
@@ -685,7 +699,10 @@ function tryMatchPartial(schema, identityMap) {
       }
     }
     if (allMatch) {
-      return { ref, suffix: ".partial()" };
+      return {
+        ref,
+        wrapSource: (inner) => mini ? `z.partial(${inner})` : `${inner}.partial()`
+      };
     }
   }
   return null;
@@ -698,7 +715,7 @@ function deriveCodecVarName(modelExportName, accessPath) {
   const fieldPart = fields.map((f, i) => i === 0 ? f : f[0].toUpperCase() + f.slice(1)).join("");
   return `_${prefix}${fieldPart[0].toUpperCase() + fieldPart.slice(1)}`;
 }
-function generateApiFile(functions, models, codecs, modelCodecs, functionCodecs) {
+function generateApiFile(functions, models, codecs, modelCodecs, functionCodecs, options) {
   const identityMap = /* @__PURE__ */ new Map();
   const neededModelImports = /* @__PURE__ */ new Set();
   for (const model of models) {
@@ -757,7 +774,8 @@ function generateApiFile(functions, models, codecs, modelCodecs, functionCodecs)
   const zodToSourceCtx = {
     codecMap,
     neededCodecImports: /* @__PURE__ */ new Map(),
-    undiscoverableCodecs: []
+    undiscoverableCodecs: [],
+    mini: options?.mini
   };
   let needsZod = false;
   let needsZx = false;
@@ -769,15 +787,17 @@ function generateApiFile(functions, models, codecs, modelCodecs, functionCodecs)
       neededModelImports.add(ref.exportName);
       return `${ref.exportName}.schema.${ref.schemaKey}`;
     }
-    const unwrapped = tryUnwrapToIdentity(s, identityMap);
+    const unwrapped = tryUnwrapToIdentity(s, identityMap, options?.mini);
     if (unwrapped) {
       neededModelImports.add(unwrapped.ref.exportName);
-      return `${unwrapped.ref.exportName}.schema.${unwrapped.ref.schemaKey}${unwrapped.suffix}`;
+      const inner = `${unwrapped.ref.exportName}.schema.${unwrapped.ref.schemaKey}`;
+      return unwrapped.wrapSource(inner);
     }
-    const partialMatch = tryMatchPartial(s, identityMap);
+    const partialMatch = tryMatchPartial(s, identityMap, options?.mini);
     if (partialMatch) {
       neededModelImports.add(partialMatch.ref.exportName);
-      return `${partialMatch.ref.exportName}.schema.${partialMatch.ref.schemaKey}${partialMatch.suffix}`;
+      const inner = `${partialMatch.ref.exportName}.schema.${partialMatch.ref.schemaKey}`;
+      return partialMatch.wrapSource(inner);
     }
     const source = zodToSource(s, zodToSourceCtx);
     if (source.includes("z.")) needsZod = true;
@@ -802,12 +822,14 @@ function generateApiFile(functions, models, codecs, modelCodecs, functionCodecs)
     }
   }
   const imports = [];
-  if (needsZod) imports.push("import { z } from 'zod'");
+  const zodImport = options?.mini ? "zod/mini" : "zod";
+  if (needsZod) imports.push(`import { z } from '${zodImport}'`);
+  const zodvexImport = options?.mini ? "zodvex/mini" : "zodvex/core";
   const coreImports = [];
   if (needsZx) coreImports.push("zx");
   if (usedModelCodecVars.length > 0) coreImports.push("extractCodec");
   if (coreImports.length > 0) {
-    imports.push(`import { ${coreImports.join(", ")} } from 'zodvex/core'`);
+    imports.push(`import { ${coreImports.join(", ")} } from '${zodvexImport}'`);
   }
   for (const exportName of neededModelImports) {
     const model = models.find((m) => m.exportName === exportName);
@@ -833,7 +855,11 @@ ${importSection}${codecVarSection}export const zodvexRegistry = {
 ${entries},
 }
 `;
-  const dts = `${HEADER}
+  const dts = options?.mini ? `${HEADER}
+import type { $ZodType } from 'zod/v4/core'
+
+export declare const zodvexRegistry: Record<string, { args: $ZodType; returns: $ZodType | undefined }>
+` : `${HEADER}
 import type { ZodTypeAny } from 'zod'
 
 export declare const zodvexRegistry: Record<string, { args: ZodTypeAny; returns: ZodTypeAny | undefined }>
@@ -860,12 +886,13 @@ export type ActionCtx = ZodvexActionCtx<DataModel>
 `;
   return { js, dts };
 }
-function generateClientFile() {
+function generateClientFile(options) {
+  const zodvexCoreImport = options?.mini ? "zodvex/mini" : "zodvex/core";
   const jsImports = [
     "import { createZodvexHooks } from 'zodvex/react'",
     "import { createZodvexReactClient } from 'zodvex/react'",
     "import { createZodvexClient } from 'zodvex/client'",
-    "import { createBoundaryHelpers } from 'zodvex/core'",
+    `import { createBoundaryHelpers } from '${zodvexCoreImport}'`,
     "import { zodvexRegistry } from './api.js'"
   ];
   const jsExports = [
@@ -888,7 +915,7 @@ ${jsExports.join("\n")}
     "import type { ZodvexHooks } from 'zodvex/react'",
     "import type { ZodvexClientOptions, ZodvexClient } from 'zodvex/client'",
     "import type { ZodvexReactClientOptions, ZodvexReactClient } from 'zodvex/react'",
-    "import type { BoundaryHelpers } from 'zodvex/core'"
+    `import type { BoundaryHelpers } from '${zodvexCoreImport}'`
   ];
   const dtsDeclarations = [
     "export declare const useZodQuery: ZodvexHooks['useZodQuery']",
@@ -910,7 +937,7 @@ ${dtsDeclarations.join("\n")}
 }
 
 // src/cli/commands.ts
-async function generate(convexDir2) {
+async function generate(convexDir2, options) {
   const resolved = resolveConvexDir(convexDir2);
   const zodvexDir = path3.join(resolved, "_zodvex");
   writeStubApi(zodvexDir);
@@ -921,9 +948,10 @@ async function generate(convexDir2) {
     result.models,
     result.codecs,
     result.modelCodecs,
-    result.functionCodecs
+    result.functionCodecs,
+    { mini: options?.mini }
   );
-  const clientContent = generateClientFile();
+  const clientContent = generateClientFile({ mini: options?.mini });
   const serverContent = generateServerFile();
   fs2.mkdirSync(zodvexDir, { recursive: true });
   writeIfChanged(path3.join(zodvexDir, "schema.js"), schemaContent.js);
@@ -939,10 +967,10 @@ async function generate(convexDir2) {
     `[zodvex] Generated ${result.models.length} model(s), ${result.functions.length} function(s), ${totalCodecs} codec(s)`
   );
 }
-async function dev(convexDir2) {
+async function dev(convexDir2, options) {
   const resolved = resolveConvexDir(convexDir2);
   console.log("[zodvex] Starting watch mode...");
-  await generate(resolved);
+  await generate(resolved, options);
   let debounceTimer = null;
   const watcher = fs2.watch(resolved, { recursive: true }, (_event, filename) => {
     if (!filename) return;
@@ -953,7 +981,7 @@ async function dev(convexDir2) {
     debounceTimer = setTimeout(async () => {
       console.log("[zodvex] Regenerating...");
       try {
-        await generate(resolved);
+        await generate(resolved, options);
       } catch (err) {
         console.error("[zodvex] Generation failed:", err.message);
       }
@@ -1001,14 +1029,15 @@ function resolveConvexDir(dir) {
 
 // src/cli/index.ts
 var command = process.argv[2];
-var convexDir = process.argv[3];
+var miniFlag = process.argv.includes("--mini");
+var convexDir = process.argv.slice(3).find((a) => !a.startsWith("--"));
 async function main() {
   switch (command) {
     case "generate":
-      await generate(convexDir);
+      await generate(convexDir, { mini: miniFlag });
       break;
     case "dev":
-      await dev(convexDir);
+      await dev(convexDir, { mini: miniFlag });
       break;
     case "init": {
       const { init: init2 } = await Promise.resolve().then(() => (init_init(), init_exports));
@@ -1062,12 +1091,15 @@ function printHelp() {
 zodvex - Convex codegen for Zod schemas
 
 Usage:
-  zodvex generate [convex-dir]  Generate schema and validator files
-  zodvex dev [convex-dir]       Watch mode \u2014 regenerate on changes
-  zodvex init                   Set up zodvex in an existing Convex project
-  zodvex migrate [dir]           Migrate pre-0.6 APIs (renames + import fixes)
-  zodvex migrate [dir] --dry-run Preview changes without writing
-  zodvex help                   Show this help message
+  zodvex generate [convex-dir] [--mini]  Generate schema and validator files
+  zodvex dev [convex-dir] [--mini]       Watch mode \u2014 regenerate on changes
+  zodvex init                            Set up zodvex in an existing Convex project
+  zodvex migrate [dir]                   Migrate pre-0.6 APIs (renames + import fixes)
+  zodvex migrate [dir] --dry-run         Preview changes without writing
+  zodvex help                            Show this help message
+
+Flags:
+  --mini  Emit zod/mini-compatible output (functional forms, zodvex/mini imports)
 `);
 }
 main().catch((err) => {