zodvex 0.7.2-beta.0 → 0.7.2

package/dist/codegen/index.js

@@ -1,5 +1,4 @@
 import path from 'path';
-import { pathToFileURL } from 'url';
 import { globSync } from 'tinyglobby';
 import { z } from 'zod';
 import { $ZodCodec, $ZodNumber, $ZodCustom, $ZodOptional, $ZodNullable, $ZodString, $ZodBoolean, $ZodNull, $ZodUndefined, $ZodAny, $ZodObject, $ZodArray, $ZodEnum, $ZodLiteral, $ZodUnion, $ZodTuple, $ZodRecord, $ZodType, clone, $ZodDiscriminatedUnion } from 'zod/v4/core';
@@ -21,6 +20,20 @@ function readMeta(target) {
   }
   return target[META_KEY];
 }
+var CODEC_BRAND_KEY = "__zodvexCodecBrand";
+function attachCodecBrand(target, brand) {
+  Object.defineProperty(target, CODEC_BRAND_KEY, {
+    value: brand,
+    enumerable: false,
+    writable: false,
+    configurable: false
+  });
+}
+function readCodecBrand(target) {
+  if (target == null || typeof target !== "object") return void 0;
+  const value = target[CODEC_BRAND_KEY];
+  return typeof value === "string" ? value : void 0;
+}
 var metadata = /* @__PURE__ */ new WeakMap();
 var registryHelpers = {
   getMetadata: (type) => metadata.get(type),
@@ -61,8 +74,10 @@ function id(tableName) {
   branded._tableName = tableName;
   return branded;
 }
-function codec(wire, runtime, transforms) {
-  return zodvexCodec(wire, runtime, transforms);
+function codec(wire, runtime, transforms, opts) {
+  const built = zodvexCodec(wire, runtime, transforms);
+  if (opts?.brand) attachCodecBrand(built, opts.brand);
+  return built;
 }
 function sharedWeakMap(name) {
   const key = /* @__PURE__ */ Symbol.for(`zodvex.zx.cache.${name}`);
@@ -408,7 +423,6 @@ function readFnReturns(fn) {
 }
 
 // src/public/codegen/discover.ts
-var discoveryRunCounter = 0;
 function walkSchemaRecursive(schema, accessPath, visited, seenCodecs, results) {
   if (visited.has(schema)) return;
   visited.add(schema);
@@ -546,7 +560,7 @@ function walkFunctionCodecs(functions) {
   }
   return found;
 }
-async function discoverModules(convexDir, options) {
+async function discoverModules(convexDir) {
   const models = [];
   const functions = [];
   const codecs = [];
@@ -570,18 +584,12 @@ async function discoverModules(convexDir, options) {
       "crons.js"
     ]
   }).sort();
-  let cacheKey = null;
-  if (options?.freshImports) {
-    discoveryRunCounter += 1;
-    cacheKey = `${process.pid}-${discoveryRunCounter}`;
-  }
   try {
     for (const file of files) {
       const absPath = path.resolve(convexDir, file);
-      const importUrl = cacheKey ? `${pathToFileURL(absPath).href}?t=${cacheKey}` : absPath;
       let moduleExports;
       try {
-        moduleExports = await import(importUrl);
+        moduleExports = await import(absPath);
       } catch (err) {
         console.warn(`[zodvex] Warning: Failed to import ${file}:`, err.message);
         continue;
@@ -736,7 +744,10 @@ var HEADER = `// AUTO-GENERATED by zodvex \u2014 do not edit
 `;
 function fingerprintCodec(schema) {
   if (!(schema instanceof $ZodCodec)) return "";
-  return `${fingerprintLeaf(schema._zod.def.in)}|${fingerprintLeaf(schema._zod.def.out)}`;
+  const def = schema._zod.def;
+  const transform = typeof def.transform === "function" ? def.transform.toString() : "";
+  const reverse = typeof def.reverseTransform === "function" ? def.reverseTransform.toString() : "";
+  return `${fingerprintLeaf(def.in)}|${fingerprintLeaf(def.out)}|${transform}|${reverse}`;
 }
 function fingerprintLeaf(schema) {
   return `${zodToSource(schema)}#${fingerprintChecks(schema)}`;
@@ -955,6 +966,7 @@ function generateApiFile(functions, models, codecs, modelCodecs, functionCodecs,
   }
   if (functionCodecs) {
     const fingerprintMap = /* @__PURE__ */ new Map();
+    const brandMap = /* @__PURE__ */ new Map();
     const codecSchemaToSourceFile = /* @__PURE__ */ new Map();
     for (const c of codecs ?? []) {
       codecSchemaToSourceFile.set(c.schema, c.sourceFile);
@@ -963,24 +975,34 @@ function generateApiFile(functions, models, codecs, modelCodecs, functionCodecs,
       codecSchemaToSourceFile.set(mc.codec, mc.modelSourceFile);
     }
     for (const [codecSchema, ref] of codecMap) {
-      const fp = fingerprintCodec(codecSchema);
-      if (!fp) continue;
       const sourceFile = codecSchemaToSourceFile.get(codecSchema);
-      const existing = fingerprintMap.get(fp);
-      if (existing) {
-        existing.push({ ref, sourceFile });
-      } else {
-        fingerprintMap.set(fp, [{ ref, sourceFile }]);
+      const brand = readCodecBrand(codecSchema);
+      const candidate = { ref, sourceFile, brand };
+      const fp = fingerprintCodec(codecSchema);
+      if (fp) {
+        const existing = fingerprintMap.get(fp);
+        if (existing) existing.push(candidate);
+        else fingerprintMap.set(fp, [candidate]);
+      }
+      if (brand) {
+        const existing = brandMap.get(brand);
+        if (existing) existing.push(candidate);
+        else brandMap.set(brand, [candidate]);
       }
     }
+    const undiscoverable = [];
     for (const fc of functionCodecs) {
       if (codecMap.has(fc.codec)) continue;
-      const fp = fingerprintCodec(fc.codec);
-      const candidates = fp ? fingerprintMap.get(fp) : void 0;
+      const brand = readCodecBrand(fc.codec);
+      let candidates = brand ? brandMap.get(brand) : void 0;
       if (!candidates || candidates.length === 0) {
-        console.warn(
-          `[zodvex] Warning: Codec in ${fc.functionExportName}() (${fc.accessPath}) has no matching model or exported codec. Export it standalone for full client-side codec support.`
+        const fp = fingerprintCodec(fc.codec);
+        candidates = (fp ? fingerprintMap.get(fp) : void 0)?.filter(
+          (c) => c.brand === void 0 || c.brand === brand
         );
+      }
+      if (!candidates || candidates.length === 0) {
+        undiscoverable.push({ fn: fc.functionExportName, path: fc.accessPath });
         continue;
       }
       let chosen;
@@ -991,14 +1013,27 @@ function generateApiFile(functions, models, codecs, modelCodecs, functionCodecs,
         if (sameFile.length === 1) {
           chosen = sameFile[0].ref;
         } else {
-          console.warn(
-            `[zodvex] Warning: Codec in ${fc.functionExportName}() (${fc.accessPath}) matches ${candidates.length} candidates with the same fingerprint (${candidates.map((c) => c.ref.exportName).join(", ")}). Cannot pick a canonical reference \u2014 emitting inline. Export the codec standalone to disambiguate.`
+          const sorted = [...candidates].sort(
+            (a, b) => `${a.sourceFile ?? ""}|${a.ref.exportName}`.localeCompare(
+              `${b.sourceFile ?? ""}|${b.ref.exportName}`
+            )
           );
+          chosen = sorted[0].ref;
+          if (!brand) {
+            console.warn(
+              `[zodvex] Note: Codec in ${fc.functionExportName}() (${fc.accessPath}) matches ${candidates.length} fingerprint-equivalent codecs (${candidates.map((c) => c.ref.exportName).join(", ")}). Referencing '${chosen.exportName}'. Export the codec standalone or give it a brand if you want the reference to be explicit.`
+            );
+          }
         }
       }
-      if (chosen) {
-        codecMap.set(fc.codec, chosen);
-      }
+      codecMap.set(fc.codec, chosen);
+    }
+    if (undiscoverable.length > 0) {
+      const list = undiscoverable.map((u) => `  - ${u.fn}() at ${u.path}`).join("\n");
+      throw new Error(
+        `[zodvex] ${undiscoverable.length} codec(s) in function args/returns have no importable reference (not exported standalone, not embedded in a model). The generated client cannot encode or decode them, which silently breaks the codec boundary. Export each codec standalone (or add it to a model) so codegen can import it:
+${list}`
+      );
     }
   }
   const zodToSourceCtx = {