zodvex 0.7.2-beta.0 → 0.7.2

package/dist/internal/meta.d.ts

@@ -20,4 +20,15 @@ export type ZodvexModelMeta = {
 export type ZodvexMeta = ZodvexFunctionMeta | ZodvexModelMeta;
 export declare function attachMeta(target: object, meta: ZodvexMeta): void;
 export declare function readMeta(target: unknown): ZodvexMeta | undefined;
+/**
+ * Attaches a provenance brand to a codec instance. Codegen reads this at
+ * discovery time to match a function-embedded codec to its importable twin
+ * by *declared* identity instead of inferring it from structure. Stored
+ * non-enumerably so it never leaks into user data, and survives
+ * `.optional()` / `.nullable()` wrapping (codegen unwraps to the codec).
+ * See `docs/decisions/2026-06-08-codec-provenance-brands.md`.
+ */
+export declare function attachCodecBrand(target: object, brand: string): void;
+/** Reads a codec's provenance brand, or undefined if unbranded. */
+export declare function readCodecBrand(target: unknown): string | undefined;
 //# sourceMappingURL=meta.d.ts.map

package/dist/internal/meta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../src/internal/meta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAI1C,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,UAAU,CAAA;IAChB,OAAO,CAAC,EAAE,QAAQ,CAAA;IAClB,UAAU,CAAC,EAAE,QAAQ,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,2BAA2B,GAAG,OAAO,GAAG,QAAQ,CAAA;AAE5D,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,OAAO,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,gBAAgB,CAAC,EAAE,2BAA2B,CAAA;IAC9C,OAAO,CAAC,EAAE;QACR,GAAG,EAAE,QAAQ,CAAA;QACb,MAAM,EAAE,QAAQ,CAAA;QAChB,MAAM,EAAE,QAAQ,CAAA;QAChB,QAAQ,EAAE,QAAQ,CAAA;QAClB,YAAY,EAAE,QAAQ,CAAA;KACvB,CAAA;CACF,CAAA;AAED,MAAM,MAAM,UAAU,GAAG,kBAAkB,GAAG,eAAe,CAAA;AAE7D,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CAOjE;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,CAKhE"}
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../src/internal/meta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAI1C,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,UAAU,CAAA;IAChB,OAAO,CAAC,EAAE,QAAQ,CAAA;IAClB,UAAU,CAAC,EAAE,QAAQ,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,2BAA2B,GAAG,OAAO,GAAG,QAAQ,CAAA;AAE5D,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,OAAO,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,gBAAgB,CAAC,EAAE,2BAA2B,CAAA;IAC9C,OAAO,CAAC,EAAE;QACR,GAAG,EAAE,QAAQ,CAAA;QACb,MAAM,EAAE,QAAQ,CAAA;QAChB,MAAM,EAAE,QAAQ,CAAA;QAChB,QAAQ,EAAE,QAAQ,CAAA;QAClB,YAAY,EAAE,QAAQ,CAAA;KACvB,CAAA;CACF,CAAA;AAED,MAAM,MAAM,UAAU,GAAG,kBAAkB,GAAG,eAAe,CAAA;AAE7D,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CAOjE;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,CAKhE;AAID;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAOpE;AAED,mEAAmE;AACnE,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAIlE"}

package/dist/internal/zx.d.ts

@@ -77,6 +77,13 @@ declare function id<TableName extends string>(tableName: TableName): ZxId<TableN
  * @param wire - Zod schema for the wire format (stored in Convex)
  * @param runtime - Zod schema for the runtime format (used in code)
  * @param transforms - Encode/decode functions
+ * @param opts.brand - Optional provenance brand. When set, codegen matches a
+ *   function-embedded instance of this codec to its importable twin (an
+ *   exported const or model field with the same brand) by *declared* identity
+ *   rather than inferring it from structure — collision-free and namespaced
+ *   across factories. Useful for codec factories like `tagged()` / `sensitive()`
+ *   whose every call returns a fresh instance. See
+ *   `docs/decisions/2026-06-08-codec-provenance-brands.md`.
  *
  * @example
  * ```typescript
@@ -89,11 +96,18 @@ declare function id<TableName extends string>(tableName: TableName): ZxId<TableN
  *     encode: (value) => ({ encrypted: encrypt(value) })
  *   }
  * )
+ *
+ * // Branded factory codec — codegen matches inline instances by brand
+ * function tagged(inner, name) {
+ *   return zx.codec(wire(inner), runtime(inner), transforms, { brand: `tagged:${name}` })
+ * }
  * ```
  */
 declare function codec<W extends $ZodType, R extends $ZodType, WO = zoutput<W>, RI = zoutput<R>>(wire: W, runtime: R, transforms: {
     decode: (wire: WO) => RI;
     encode: (runtime: RI) => WO;
+}, opts?: {
+    brand?: string;
 }): FullZodvexCodec<W, R>;
 /**
  * Minimal model shape accepted by zx helpers.

package/dist/internal/zx.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zx.d.ts","sourceRoot":"","sources":["../../src/internal/zx.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAKvB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAC1C,OAAO,EACL,KAAK,UAAU,EAEf,KAAK,UAAU,EAEf,KAAK,QAAQ,EAEb,KAAK,MAAM,IAAI,OAAO,EACvB,MAAM,YAAY,CAAA;AAEnB;;GAEG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,QAAQ,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,GACpF,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;AAEnB,MAAM,MAAM,MAAM,GAAG,eAAe,CAAC,UAAU,EAAE,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAA;AAExE;;;;;;;;;;;;;GAaG;AACH,iBAAS,IAAI,IAAI,MAAM,CAWtB;AAED;;GAEG;AACH,MAAM,MAAM,IAAI,CAAC,SAAS,SAAS,MAAM,IAAI,CAAC,CAAC,SAAS,GACtD,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,GAAG;IAChC,UAAU,EAAE,SAAS,CAAA;CACtB,CAAA;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AACH,iBAAS,EAAE,CAAC,SAAS,SAAS,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,CAoB3E;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,iBAAS,KAAK,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,QAAQ,EAAE,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,EACrF,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,CAAC,EACV,UAAU,EAAE;IACV,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,CAAA;IACxB,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAA;CAC5B,GACA,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAEvB;AAED;;;GAGG;AACH,KAAK,YAAY,GAAG;IAClB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IACzC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAC1B,CAAA;AAiDD;;;;;;;GAOG;AACH,iBAAS,IAAI,CAAC,KAAK,EAAE,YAAY,GAAG,QAAQ,CAY3C;AAED;;;GAGG;AACH,iBAAS,GAAG,CAAC,KAAK,EAAE,YAAY,OAS/B;AAED;;;GAGG;AACH,iBAAS,MAAM,CAAC,KAAK,EAAE,YAAY,OASlC;AAED;;;GAGG;AACH,iBAAS,QAAQ,CAAC,KAAK,EAAE,YAAY,OASpC;AAiBD;;GAEG;AACH,iBAAS,cAAc;;;;;;;kBAStB;AAED;;GAEG;AACH,iBAAS,gBAAgB,CAAC,CAAC,SAAS,QAAQ,EAAE,UAAU,EAAE,CAAC;;;;;;kBAQ1D;AAED;;;;GAIG;AACH,eAAO,MAAM,EAAE;IACb;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;;;OAKG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;CAEK,CAAA"}
+{"version":3,"file":"zx.d.ts","sourceRoot":"","sources":["../../src/internal/zx.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAMvB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAC1C,OAAO,EACL,KAAK,UAAU,EAEf,KAAK,UAAU,EAEf,KAAK,QAAQ,EAEb,KAAK,MAAM,IAAI,OAAO,EACvB,MAAM,YAAY,CAAA;AAEnB;;GAEG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,QAAQ,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,GACpF,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;AAEnB,MAAM,MAAM,MAAM,GAAG,eAAe,CAAC,UAAU,EAAE,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAA;AAExE;;;;;;;;;;;;;GAaG;AACH,iBAAS,IAAI,IAAI,MAAM,CAWtB;AAED;;GAEG;AACH,MAAM,MAAM,IAAI,CAAC,SAAS,SAAS,MAAM,IAAI,CAAC,CAAC,SAAS,GACtD,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,GAAG;IAChC,UAAU,EAAE,SAAS,CAAA;CACtB,CAAA;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AACH,iBAAS,EAAE,CAAC,SAAS,SAAS,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,CAoB3E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,iBAAS,KAAK,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,QAAQ,EAAE,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,EACrF,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,CAAC,EACV,UAAU,EAAE;IACV,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,CAAA;IACxB,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAA;CAC5B,EACD,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACxB,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAIvB;AAED;;;GAGG;AACH,KAAK,YAAY,GAAG;IAClB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IACzC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAC1B,CAAA;AAiDD;;;;;;;GAOG;AACH,iBAAS,IAAI,CAAC,KAAK,EAAE,YAAY,GAAG,QAAQ,CAY3C;AAED;;;GAGG;AACH,iBAAS,GAAG,CAAC,KAAK,EAAE,YAAY,OAS/B;AAED;;;GAGG;AACH,iBAAS,MAAM,CAAC,KAAK,EAAE,YAAY,OASlC;AAED;;;GAGG;AACH,iBAAS,QAAQ,CAAC,KAAK,EAAE,YAAY,OASpC;AAiBD;;GAEG;AACH,iBAAS,cAAc;;;;;;;kBAStB;AAED;;GAEG;AACH,iBAAS,gBAAgB,CAAC,CAAC,SAAS,QAAQ,EAAE,UAAU,EAAE,CAAC;;;;;;kBAQ1D;AAED;;;;GAIG;AACH,eAAO,MAAM,EAAE;IACb;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;;;OAKG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;CAEK,CAAA"}

package/dist/legacy/index.js

@@ -442,6 +442,15 @@ function attachMeta(target, meta) {
     configurable: false
   });
 }
+var CODEC_BRAND_KEY = "__zodvexCodecBrand";
+function attachCodecBrand(target, brand) {
+  Object.defineProperty(target, CODEC_BRAND_KEY, {
+    value: brand,
+    enumerable: false,
+    writable: false,
+    configurable: false
+  });
+}
 function containsNativeZodDate(schema) {
   if (schema instanceof $ZodDate) return true;
   if (schema instanceof $ZodCodec) return false;
@@ -846,8 +855,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}`);