zodvex 0.5.0 → 0.6.0-beta.0

package/README.md

@@ -9,6 +9,7 @@ Type-safe Convex functions with Zod schemas. Preserve Convex's optional/nullable
 ## Table of Contents
 
 - [Installation](#installation)
+- [Import Paths](#import-paths)
 - [Quick Start](#quick-start)
 - [Defining Schemas](#defining-schemas)
 - [Table Definitions](#table-definitions)
@@ -41,6 +42,45 @@ npm install zodvex zod@^4.1.0 convex convex-helpers
 - `convex` (>= 1.27.0)
 - `convex-helpers` (>= 0.1.104)
 
+## Import Paths
+
+zodvex provides multiple entry points for optimal bundle sizes:
+
+### `zodvex/core` - Client-Safe (Recommended for client code)
+
+Use this in React components, hooks, and any client-side code:
+
+```typescript
+import { zx, zodToConvex } from 'zodvex/core'
+
+// Define schemas that can be used anywhere
+const userSchema = z.object({
+  id: zx.id('users'),
+  createdAt: zx.date(),
+})
+```
+
+### `zodvex/server` - Server-Only
+
+Use this in Convex functions and schema definitions:
+
+```typescript
+import { zodTable, zCustomQuery } from 'zodvex/server'
+
+// In convex/schema.ts
+const Users = zodTable('users', userShape)
+```
+
+### `zodvex` - Full Library (Backwards Compatible)
+
+For convenience or when you don't care about bundle size:
+
+```typescript
+import { zx, zodTable } from 'zodvex'
+```
+
+> **Note:** This pulls in server code. Use `zodvex/core` for client bundles.
+
 ## Quick Start
 
 ### 1. Set up your builders
@@ -488,80 +528,31 @@ export const updateProfile = authMutation({
 })
 ```
 
-#### Hooks and Transforms
+#### onSuccess Hook
 
-For advanced use cases like logging, analytics, or data transformations, use `customCtxWithHooks`:
+The `onSuccess` callback follows convex-helpers' `Customization` convention — return it from your customization's `input` function:
 
 ```ts
-import { zCustomMutationBuilder, customCtxWithHooks } from 'zodvex'
+import { zCustomMutationBuilder } from 'zodvex'
 import { type MutationCtx, mutation } from './_generated/server'
 
-export const secureMutation = zCustomMutationBuilder(
-  mutation,
-  customCtxWithHooks(async (ctx: MutationCtx) => {
+export const secureMutation = zCustomMutationBuilder(mutation, {
+  args: {},
+  input: async (ctx: MutationCtx) => {
     const securityCtx = await getSecurityContext(ctx)
-
     return {
-      // Custom context (same as customCtx)
       ctx: { securityCtx },
-
-      // Hooks: observe execution (side effects, no return value)
-      hooks: {
-        onSuccess: ({ ctx, args, result }) => {
-          // Called after successful execution
-          console.log('Mutation succeeded:', { args, result })
-          analytics.track('mutation_success', { userId: ctx.securityCtx.userId })
-        }
-      },
-
-      // Transforms: modify data in the flow
-      transforms: {
-        // Transform args after validation, before handler
-        input: (args, schema) => {
-          // e.g., Convert wire format to runtime objects
-          return transformIncomingArgs(args, securityCtx)
-        },
-        // Transform result after handler, before response
-        output: (result, schema) => {
-          // e.g., Mask sensitive fields based on permissions
-          return transformOutgoingResult(result, securityCtx)
-        }
+      args: {},
+      onSuccess: ({ ctx, args, result }) => {
+        console.log('Mutation succeeded:', { args, result })
       }
     }
-  })
-)
-```
-
-**Execution order:**
-
-1. Args received from client
-2. Zod validation on args
-3. `transforms.input` runs (if provided)
-4. Handler executes
-5. Zod validation on returns (if provided)
-6. `hooks.onSuccess` runs (if provided)
-7. `transforms.output` runs (if provided)
-8. Response sent to client
-
-**Use cases:**
-
-| Feature | Use Case |
-|---------|----------|
-| `hooks.onSuccess` | Logging, analytics, audit trails, cache invalidation |
-| `transforms.input` | Wire format → runtime objects, field decryption, data hydration |
-| `transforms.output` | Sensitive field masking, data redaction, format conversion |
-
-**Note:** Both `transforms.input` and `transforms.output` can be async:
-
-```ts
-transforms: {
-  input: async (args, schema) => {
-    const decrypted = await decrypt(args.sensitiveField)
-    return { ...args, sensitiveField: decrypted }
   }
-}
+})
 ```
 
+`onSuccess` runs after the handler and Zod return validation, seeing runtime types (e.g., `Date`, not timestamps).
+
 ### Custom Codecs
 
 For complex type transformations beyond the built-in `zx.date()` and `zx.id()`, use `zx.codec()` to create custom codecs that automatically work with validator generation and runtime encoding/decoding.

package/dist/actionCtx.d.ts

@@ -0,0 +1,14 @@
+import type { GenericActionCtx, GenericDataModel } from 'convex/server';
+import type { AnyRegistry } from './types';
+/**
+ * Wraps an action context's runQuery/runMutation with automatic
+ * codec transforms via the zodvex registry.
+ *
+ * - Args are encoded (runtime -> wire) before calling the inner function
+ * - Results are decoded (wire -> runtime) before returning to the handler
+ * - Functions not in the registry pass through unchanged
+ *
+ * @internal Used by initZodvex when registry option is provided.
+ */
+export declare function createZodvexActionCtx<DM extends GenericDataModel>(registry: AnyRegistry, ctx: GenericActionCtx<DM>): GenericActionCtx<DM>;
+//# sourceMappingURL=actionCtx.d.ts.map

package/dist/actionCtx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actionCtx.d.ts","sourceRoot":"","sources":["../src/actionCtx.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAGvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAG1C;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,SAAS,gBAAgB,EAC/D,QAAQ,EAAE,WAAW,EACrB,GAAG,EAAE,gBAAgB,CAAC,EAAE,CAAC,GACxB,gBAAgB,CAAC,EAAE,CAAC,CAyBtB"}

package/dist/builders.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../src/builders.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../src/builders.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,wBAAsB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBhE;AAED;;GAEG;AACH,wBAAsB,GAAG,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoC3D"}

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -0,0 +1,446 @@
+#!/usr/bin/env bun
+import fs from 'fs';
+import path2 from 'path';
+import { Glob } from 'bun';
+import { z } from 'zod';
+
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// src/cli/init.ts
+var init_exports = {};
+__export(init_exports, {
+  ensureConcurrently: () => ensureConcurrently,
+  generateStubs: () => generateStubs,
+  gitignoreEntry: () => gitignoreEntry,
+  init: () => init,
+  rewriteDeployScript: () => rewriteDeployScript,
+  rewriteDevScript: () => rewriteDevScript
+});
+function rewriteDevScript(script) {
+  if (script.includes("zodvex dev")) return null;
+  const match = script.match(/\b((?:bunx|npx)\s+convex\s+dev)\b/);
+  if (!match) return null;
+  return `concurrently "zodvex dev" "${script}"`;
+}
+function rewriteDeployScript(script) {
+  if (script.includes("zodvex generate")) return null;
+  const match = script.match(/\b((?:bunx|npx)\s+convex\s+deploy)\b/);
+  if (!match) return null;
+  const idx = script.indexOf(match[1]);
+  const before = script.slice(0, idx);
+  const after = script.slice(idx);
+  return `${before}zodvex generate && ${after}`;
+}
+function ensureConcurrently(pkg) {
+  if (pkg.dependencies?.concurrently) return "exists";
+  if (pkg.devDependencies?.concurrently) return "exists";
+  return "add";
+}
+function gitignoreEntry(content) {
+  if (content.includes("convex/_zodvex/")) return null;
+  const lines = content ? content.split("\n") : [];
+  lines.push("# zodvex generated files", "convex/_zodvex/");
+  return lines.join("\n");
+}
+function generateStubs(convexDir2) {
+  const zodvexDir = path2.join(convexDir2, "_zodvex");
+  fs.mkdirSync(zodvexDir, { recursive: true });
+  const apiStub = `// Auto-generated stub. Run \`zodvex generate\` to populate.
+export const zodvexRegistry = {} as const
+`;
+  fs.writeFileSync(path2.join(zodvexDir, "api.ts"), apiStub);
+  const clientStub = `// Auto-generated stub. Run \`zodvex generate\` to populate.
+import { zodvexRegistry } from './api'
+
+export const useZodQuery = undefined as any
+export const useZodMutation = undefined as any
+export const createClient = undefined as any
+`;
+  fs.writeFileSync(path2.join(zodvexDir, "client.ts"), clientStub);
+}
+async function init() {
+  const convexDir2 = path2.resolve("convex");
+  if (!fs.existsSync(convexDir2)) {
+    console.error("[zodvex] No convex/ directory found. Run this from your project root.");
+    return;
+  }
+  generateStubs(convexDir2);
+  console.log("[zodvex] Generated stub files in convex/_zodvex/");
+  console.log("[zodvex] Run `zodvex generate` to populate with your models and functions.");
+}
+var init_init = __esm({
+  "src/cli/init.ts"() {
+  }
+});
+
+// src/meta.ts
+var META_KEY = "__zodvexMeta";
+function readMeta(target) {
+  if (target == null || typeof target !== "object" && typeof target !== "function") {
+    return void 0;
+  }
+  return target[META_KEY];
+}
+
+// src/codegen/discover.ts
+async function discoverModules(convexDir2) {
+  const models = [];
+  const functions = [];
+  const codecs = [];
+  const glob = new Glob("**/*.{ts,js}");
+  const files = [];
+  for await (const file of glob.scan({ cwd: convexDir2 })) {
+    if (file.startsWith("_generated/") || file.startsWith("_zodvex/") || file.startsWith("node_modules/") || file.endsWith(".d.ts")) {
+      continue;
+    }
+    files.push(file);
+  }
+  for (const file of files) {
+    const absPath = path2.resolve(convexDir2, file);
+    let moduleExports;
+    try {
+      moduleExports = await import(absPath);
+    } catch (err) {
+      console.warn(`[zodvex] Warning: Failed to import ${file}:`, err.message);
+      continue;
+    }
+    const moduleName = file.replace(/\.(ts|js)$/, "").replace(/\\/g, "/");
+    for (const [exportName, value] of Object.entries(moduleExports)) {
+      const meta = readMeta(value);
+      if (meta) {
+        if (meta.type === "model") {
+          models.push({
+            exportName,
+            tableName: meta.tableName,
+            sourceFile: file,
+            schemas: meta.schemas
+          });
+        } else if (meta.type === "function") {
+          functions.push({
+            functionPath: `${moduleName}:${exportName}`,
+            exportName,
+            sourceFile: file,
+            zodArgs: meta.zodArgs,
+            zodReturns: meta.zodReturns
+          });
+        }
+      }
+      if (value instanceof z.ZodCodec) {
+        const def = value._zod?.def;
+        const isZxDate = def?.in instanceof z.ZodNumber && def?.out instanceof z.ZodCustom;
+        if (!isZxDate) {
+          if (!codecs.some((c) => c.schema === value)) {
+            codecs.push({
+              exportName,
+              sourceFile: file,
+              schema: value
+            });
+          }
+        }
+      }
+    }
+  }
+  return { models, functions, codecs };
+}
+function zodToSource(schema, ctx) {
+  const def = schema._zod?.def;
+  if (schema instanceof z.ZodOptional) {
+    return `${zodToSource(def.innerType, ctx)}.optional()`;
+  }
+  if (schema instanceof z.ZodNullable) {
+    return `${zodToSource(def.innerType, ctx)}.nullable()`;
+  }
+  if (schema instanceof z.ZodString && schema.description?.startsWith("convexId:")) {
+    const tableName = schema.description.slice("convexId:".length);
+    return `zx.id("${tableName}")`;
+  }
+  if (schema instanceof z.ZodCodec && def.in instanceof z.ZodNumber && def.out instanceof z.ZodCustom) {
+    return "zx.date()";
+  }
+  if (schema instanceof z.ZodCodec) {
+    if (ctx?.codecMap) {
+      const ref = ctx.codecMap.get(schema);
+      if (ref) {
+        if (!ctx.neededCodecImports.has(ref.sourceFile)) {
+          ctx.neededCodecImports.set(ref.sourceFile, /* @__PURE__ */ new Set());
+        }
+        ctx.neededCodecImports.get(ref.sourceFile).add(ref.exportName);
+        return ref.exportName;
+      }
+    }
+    const wireSource = zodToSource(def.in, ctx);
+    return `${wireSource} /* codec: transforms lost */`;
+  }
+  if (schema instanceof z.ZodString) return "z.string()";
+  if (schema instanceof z.ZodNumber) return "z.number()";
+  if (schema instanceof z.ZodBoolean) return "z.boolean()";
+  if (schema instanceof z.ZodNull) return "z.null()";
+  if (schema instanceof z.ZodUndefined) return "z.undefined()";
+  if (schema instanceof z.ZodAny) return "z.any()";
+  if (schema instanceof z.ZodObject) {
+    const shape = def.shape;
+    const fields = Object.entries(shape).map(([key, value]) => `${key}: ${zodToSource(value, ctx)}`).join(", ");
+    return `z.object({ ${fields} })`;
+  }
+  if (schema instanceof z.ZodArray) {
+    return `z.array(${zodToSource(def.element, ctx)})`;
+  }
+  if (schema instanceof z.ZodEnum) {
+    const values = schema.options.map((v) => `"${v}"`).join(", ");
+    return `z.enum([${values}])`;
+  }
+  if (schema instanceof z.ZodLiteral) {
+    const values = def.values;
+    const value = values.values().next().value;
+    if (typeof value === "string") return `z.literal("${value}")`;
+    return `z.literal(${value})`;
+  }
+  if (schema instanceof z.ZodUnion) {
+    const members = def.options.map((s) => zodToSource(s, ctx)).join(", ");
+    return `z.union([${members}])`;
+  }
+  if (schema instanceof z.ZodTuple) {
+    const items = def.items.map((s) => zodToSource(s, ctx)).join(", ");
+    return `z.tuple([${items}])`;
+  }
+  if (schema instanceof z.ZodRecord) {
+    return `z.record(${zodToSource(def.keyType, ctx)}, ${zodToSource(def.valueType, ctx)})`;
+  }
+  const typeName = def?.type ?? "unknown";
+  return `z.any() /* unsupported: ${typeName} */`;
+}
+
+// src/codegen/generate.ts
+var HEADER = `// AUTO-GENERATED by zodvex \u2014 do not edit
+// Run \`zodvex generate\` to regenerate
+`;
+function generateSchemaFile(models) {
+  const exports$1 = models.map((m) => {
+    const importPath = `../${m.sourceFile.replace(/\.ts$/, "")}`;
+    return `export { ${m.exportName} } from '${importPath}'`;
+  }).join("\n");
+  return `${HEADER}
+${exports$1}
+`;
+}
+function tryUnwrapToIdentity(schema, identityMap) {
+  let current = schema;
+  const suffixes = [];
+  const maxDepth = 5;
+  for (let i = 0; i < maxDepth; i++) {
+    const def = current._zod?.def;
+    if (current instanceof z.ZodOptional) {
+      suffixes.push(".optional()");
+      current = def.innerType;
+    } else if (current instanceof z.ZodNullable) {
+      suffixes.push(".nullable()");
+      current = def.innerType;
+    } else {
+      break;
+    }
+    const ref = identityMap.get(current);
+    if (ref) {
+      return { ref, suffix: suffixes.reverse().join("") };
+    }
+  }
+  return null;
+}
+function generateApiFile(functions, models, codecs) {
+  const identityMap = /* @__PURE__ */ new Map();
+  const neededModelImports = /* @__PURE__ */ new Set();
+  for (const model of models) {
+    const importPath = `../${model.sourceFile.replace(/\.ts$/, "")}`;
+    for (const key of ["doc", "insert", "update", "docArray", "paginatedDoc"]) {
+      identityMap.set(model.schemas[key], {
+        importPath,
+        exportName: model.exportName,
+        schemaKey: key
+      });
+    }
+  }
+  const codecMap = /* @__PURE__ */ new Map();
+  if (codecs) {
+    for (const codec of codecs) {
+      const importPath = `../${codec.sourceFile.replace(/\.ts$/, "")}`;
+      codecMap.set(codec.schema, {
+        exportName: codec.exportName,
+        sourceFile: importPath
+      });
+    }
+  }
+  const zodToSourceCtx = {
+    codecMap,
+    neededCodecImports: /* @__PURE__ */ new Map()
+  };
+  let needsZod = false;
+  let needsZx = false;
+  function resolveSchema(schema) {
+    if (!schema) return "undefined";
+    const ref = identityMap.get(schema);
+    if (ref) {
+      neededModelImports.add(ref.exportName);
+      return `${ref.exportName}.schema.${ref.schemaKey}`;
+    }
+    const unwrapped = tryUnwrapToIdentity(schema, identityMap);
+    if (unwrapped) {
+      neededModelImports.add(unwrapped.ref.exportName);
+      return `${unwrapped.ref.exportName}.schema.${unwrapped.ref.schemaKey}${unwrapped.suffix}`;
+    }
+    const source = zodToSource(schema, zodToSourceCtx);
+    if (source.includes("z.")) needsZod = true;
+    if (source.includes("zx.")) needsZx = true;
+    return source;
+  }
+  const entries = functions.map((fn) => {
+    const args = resolveSchema(fn.zodArgs);
+    const returns = resolveSchema(fn.zodReturns);
+    return `  '${fn.functionPath}': {
+    args: ${args},
+    returns: ${returns},
+  }`;
+  }).join(",\n");
+  const imports = [];
+  if (needsZod) imports.push("import { z } from 'zod'");
+  if (needsZx) imports.push("import { zx } from 'zodvex/core'");
+  for (const exportName of neededModelImports) {
+    const model = models.find((m) => m.exportName === exportName);
+    if (model) {
+      const importPath = `../${model.sourceFile.replace(/\.ts$/, "")}`;
+      imports.push(`import { ${exportName} } from '${importPath}'`);
+    }
+  }
+  for (const [importPath, exportNames] of zodToSourceCtx.neededCodecImports) {
+    const names = Array.from(exportNames).sort().join(", ");
+    imports.push(`import { ${names} } from '${importPath}'`);
+  }
+  const importSection = imports.length > 0 ? `${imports.join("\n")}
+
+` : "";
+  return `${HEADER}
+${importSection}export const zodvexRegistry = {
+${entries},
+} as const
+`;
+}
+function generateClientFile() {
+  return `${HEADER}
+import { createZodvexHooks } from 'zodvex/react'
+import { createZodvexClient, type ZodvexClientOptions } from 'zodvex/client'
+import { zodvexRegistry } from './api'
+
+export const { useZodQuery, useZodMutation } = createZodvexHooks(zodvexRegistry)
+
+export const createClient = (options: ZodvexClientOptions) =>
+  createZodvexClient(zodvexRegistry, options)
+`;
+}
+
+// src/cli/commands.ts
+async function generate(convexDir2) {
+  const resolved = resolveConvexDir(convexDir2);
+  const zodvexDir = path2.join(resolved, "_zodvex");
+  const result = await discoverModules(resolved);
+  const schemaContent = generateSchemaFile(result.models);
+  const apiContent = generateApiFile(result.functions, result.models, result.codecs);
+  const clientContent = generateClientFile();
+  fs.mkdirSync(zodvexDir, { recursive: true });
+  fs.writeFileSync(path2.join(zodvexDir, "schema.ts"), schemaContent);
+  fs.writeFileSync(path2.join(zodvexDir, "api.ts"), apiContent);
+  fs.writeFileSync(path2.join(zodvexDir, "client.ts"), clientContent);
+  console.log(
+    `[zodvex] Generated ${result.models.length} model(s), ${result.functions.length} function(s), ${result.codecs.length} codec(s)`
+  );
+}
+async function dev(convexDir2) {
+  const resolved = resolveConvexDir(convexDir2);
+  console.log("[zodvex] Starting watch mode...");
+  await generate(resolved);
+  let debounceTimer = null;
+  const watcher = fs.watch(resolved, { recursive: true }, (_event, filename) => {
+    if (!filename) return;
+    if (filename.startsWith("_zodvex") || filename.startsWith("_generated") || !filename.endsWith(".ts") && !filename.endsWith(".js")) {
+      return;
+    }
+    if (debounceTimer) clearTimeout(debounceTimer);
+    debounceTimer = setTimeout(async () => {
+      console.log("[zodvex] Regenerating...");
+      try {
+        await generate(resolved);
+      } catch (err) {
+        console.error("[zodvex] Generation failed:", err.message);
+      }
+    }, 300);
+  });
+  process.on("SIGINT", () => {
+    if (debounceTimer) clearTimeout(debounceTimer);
+    watcher.close();
+    process.exit(0);
+  });
+}
+function resolveConvexDir(dir) {
+  if (dir) {
+    const resolved = path2.resolve(dir);
+    if (!fs.existsSync(resolved)) {
+      throw new Error(`Convex directory not found: ${resolved}`);
+    }
+    return resolved;
+  }
+  const defaultDir = path2.resolve("convex");
+  if (!fs.existsSync(defaultDir)) {
+    throw new Error("No convex/ directory found. Specify the path: zodvex generate <path>");
+  }
+  return defaultDir;
+}
+
+// src/cli/index.ts
+var command = process.argv[2];
+var convexDir = process.argv[3];
+async function main() {
+  switch (command) {
+    case "generate":
+      await generate(convexDir);
+      break;
+    case "dev":
+      await dev(convexDir);
+      break;
+    case "init":
+      const { init: init2 } = await Promise.resolve().then(() => (init_init(), init_exports));
+      await init2();
+      break;
+    case "help":
+    case "--help":
+    case "-h":
+    case void 0:
+      printHelp();
+      break;
+    default:
+      console.error(`Unknown command: ${command}`);
+      printHelp();
+      process.exit(1);
+  }
+}
+function printHelp() {
+  console.log(`
+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 help                   Show this help message
+`);
+}
+main().catch((err) => {
+  console.error(err.message);
+  process.exit(1);
+});
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map