zodvex 0.7.2 → 0.7.3-beta.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (16) hide show
  1. package/dist/internal/custom.d.ts +6 -6
  2. package/dist/internal/custom.d.ts.map +1 -1
  3. package/dist/internal/functionContracts.d.ts +1 -1
  4. package/dist/internal/functionContracts.d.ts.map +1 -1
  5. package/dist/internal/init.d.ts +24 -3
  6. package/dist/internal/init.d.ts.map +1 -1
  7. package/dist/legacy/index.js +13 -12
  8. package/dist/legacy/index.js.map +1 -1
  9. package/dist/mini/server/index.js +13 -12
  10. package/dist/mini/server/index.js.map +1 -1
  11. package/dist/server/index.js +13 -12
  12. package/dist/server/index.js.map +1 -1
  13. package/package.json +1 -1
  14. package/src/internal/custom.ts +32 -11
  15. package/src/internal/functionContracts.ts +11 -9
  16. package/src/internal/init.ts +36 -8
package/dist/legacy/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/internal/schema/objectShape.ts","../../src/internal/ids.ts","../../src/internal/mapping/handlers/enum.ts","../../src/internal/mapping/handlers/nullable.ts","../../src/internal/mapping/handlers/record.ts","../../src/internal/mapping/handlers/union.ts","../../src/internal/mapping/utils.ts","../../src/internal/mapping/core.ts","../../src/internal/meta.ts","../../src/internal/schema/dateGuards.ts","../../src/internal/serverUtils.ts","../../src/internal/shared/object.ts","../../src/internal/stripUndefined.ts","../../src/internal/functionContracts.ts","../../src/internal/custom.ts","../../src/internal/wrappers.ts","../../src/internal/builders.ts","../../src/internal/codec.ts","../../src/internal/zx.ts","../../src/internal/schemaHelpers.ts","../../src/internal/modelSchemaBundle.ts","../../src/legacy/tables.ts"],"names":["zodToConvexInternal","v","metadata","z","registered","date","nullableOptional","docArray"],"mappings":"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","file":"index.js","sourcesContent":["import { $ZodObject } from '../zod-core'\n\nexport function getObjectShape(obj: any): Record<string, any> {\n if (obj instanceof $ZodObject) {\n return obj._zod.def.shape as Record<string, any>\n }\n if (obj && typeof obj === 'object' && typeof obj.shape === 'object') {\n return obj.shape as Record<string, any>\n }\n return {}\n}\n","/**\n * IDs + registry for Convex + Zod v4\n */\n\nimport type { GenericId } from 'convex/values'\nimport { z } from 'zod'\nimport type { $ZodType } from './zod-core'\n\n// Simple registry for metadata\nconst metadata = new WeakMap<$ZodType, any>()\n\nexport const registryHelpers = {\n getMetadata: (type: $ZodType) => metadata.get(type),\n setMetadata: (type: $ZodType, meta: any) => metadata.set(type, meta)\n}\n\n/**\n * Create a Zod validator for a Convex Id\n *\n * Compatible with AI SDK and other tools that don't support transforms.\n * Uses type-level branding instead of runtime transforms for GenericId<T> compatibility.\n *\n * @deprecated Use `zx.id()` instead for consistent naming with other zodvex helpers.\n * ```typescript\n * import { zx } from 'zodvex'\n * zx.id('users') // instead of zid('users')\n * ```\n *\n * @param tableName - The Convex table name for this ID\n * @returns A Zod string validator typed as GenericId<TableName>\n */\nexport function zid<TableName extends string>(\n tableName: TableName\n): $ZodType<GenericId<TableName>> & { _tableName: TableName } {\n // Create base string validator with refinement (no transform or brand)\n const baseSchema = z.string().check(\n z.refine(val => typeof val === 'string' && val.length > 0, {\n message: `Invalid ID for table \"${tableName}\"`\n }),\n // Add a human-readable marker for client-side introspection utilities\n // used in apps/native (e.g., to detect relationship fields in dynamic forms).\n z.describe(`convexId:${tableName}`)\n )\n\n // Store metadata for registry lookup so mapping can convert to v.id(tableName)\n registryHelpers.setMetadata(baseSchema, {\n isConvexId: true,\n tableName\n })\n\n // Add the tableName property for type-level detection\n const branded = baseSchema as any\n branded._tableName = tableName\n\n // Type assertion provides GenericId<TableName> typing without runtime transform\n // This maintains type safety while being compatible with AI SDK and similar tools\n return branded as $ZodType<GenericId<TableName>> & { _tableName: TableName }\n}\n\nexport type Zid<TableName extends string> = ReturnType<typeof zid<TableName>>\n","import type { GenericValidator, Validator } from 'convex/values'\nimport { v } from 'convex/values'\nimport { $ZodEnum, type $ZodType } from '../../zod-core'\n\n// Helper: Convert Zod enum types to Convex validators\nexport function convertEnumType(actualValidator: $ZodEnum): GenericValidator {\n const entries = actualValidator._zod.def.entries\n const options = Object.keys(entries)\n if (options && Array.isArray(options) && options.length > 0) {\n // Filter out undefined/null and convert to Convex validators\n const validLiterals = options\n .filter((opt: any) => opt !== undefined && opt !== null)\n .map((opt: any) => v.literal(opt))\n\n if (validLiterals.length === 1) {\n const [first] = validLiterals\n return first as Validator<any, 'required', any>\n } else if (validLiterals.length >= 2) {\n const [first, second, ...rest] = validLiterals\n return v.union(\n first as Validator<any, 'required', any>,\n second as Validator<any, 'required', any>,\n ...rest\n )\n } else {\n return v.any()\n }\n } else {\n return v.any()\n }\n}\n","import type { GenericValidator } from 'convex/values'\nimport { v } from 'convex/values'\nimport { $ZodNullable, $ZodOptional, $ZodType } from '../../zod-core'\n\n// Helper: Convert Zod nullable types to Convex validators\nexport function convertNullableType(\n actualValidator: $ZodNullable,\n visited: Set<$ZodType>,\n zodToConvexInternal: (schema: $ZodType, visited: Set<$ZodType>) => any\n): { validator: GenericValidator; isOptional: boolean } {\n const innerSchema = actualValidator._zod.def.innerType\n if (innerSchema && innerSchema instanceof $ZodType) {\n // Check if the inner schema is optional\n if (innerSchema instanceof $ZodOptional) {\n // For nullable(optional(T)), we want optional(union(T, null))\n const innerInnerSchema = innerSchema._zod.def.innerType\n const innerInnerValidator = zodToConvexInternal(innerInnerSchema, visited)\n return {\n validator: v.union(innerInnerValidator, v.null()),\n isOptional: true // Mark as optional so it gets wrapped later\n }\n } else {\n const innerValidator = zodToConvexInternal(innerSchema, visited)\n return {\n validator: v.union(innerValidator, v.null()),\n isOptional: false\n }\n }\n } else {\n return {\n validator: v.any(),\n isOptional: false\n }\n }\n}\n","import type { GenericValidator } from 'convex/values'\nimport { v } from 'convex/values'\nimport { $ZodDefault, $ZodOptional, $ZodRecord, $ZodType } from '../../zod-core'\n\n// Helper: Convert Zod record types to Convex validators\nexport function convertRecordType(\n actualValidator: $ZodRecord,\n visited: Set<$ZodType>,\n zodToConvexInternal: (schema: $ZodType, visited: Set<$ZodType>) => any\n): GenericValidator {\n // $ZodRecord._zod.def has keyType and valueType\n let valueType: $ZodType | undefined = actualValidator._zod.def.valueType\n\n // If valueType is undefined, fall back to keyType (single-argument z.record() form)\n if (!valueType) {\n valueType = actualValidator._zod.def.keyType\n }\n\n if (valueType && valueType instanceof $ZodType) {\n // First check if the Zod value type is optional before conversion\n const isZodOptional =\n valueType instanceof $ZodOptional ||\n valueType instanceof $ZodDefault ||\n (valueType instanceof $ZodDefault && valueType._zod.def.innerType instanceof $ZodOptional)\n\n if (isZodOptional) {\n // For optional record values, we need to handle this specially\n let innerType: any\n let recordDefaultValue: any = undefined\n let recordHasDefault = false\n\n if (valueType instanceof $ZodDefault) {\n // Handle ZodDefault wrapper\n recordHasDefault = true\n recordDefaultValue = valueType._zod.def.defaultValue\n const innerFromDefault = valueType._zod.def.innerType\n if (innerFromDefault instanceof $ZodOptional) {\n innerType = innerFromDefault._zod.def.innerType\n } else {\n innerType = innerFromDefault\n }\n } else if (valueType instanceof $ZodOptional) {\n // Direct ZodOptional\n innerType = valueType._zod.def.innerType\n } else {\n // Shouldn't happen based on isZodOptional check\n innerType = valueType\n }\n\n // Convert the inner type to Convex and wrap in union with null\n const innerConvex = zodToConvexInternal(innerType, visited)\n const unionValidator = v.union(innerConvex, v.null())\n\n // Add default metadata if present\n if (recordHasDefault) {\n ;(unionValidator as any)._zodDefault = recordDefaultValue\n }\n\n return v.record(v.string(), unionValidator)\n } else {\n // Non-optional values can be converted normally\n return v.record(v.string(), zodToConvexInternal(valueType, visited))\n }\n } else {\n return v.record(v.string(), v.any())\n }\n}\n","import type { GenericValidator, Validator } from 'convex/values'\nimport { v } from 'convex/values'\nimport { $ZodDiscriminatedUnion, type $ZodType, $ZodUnion } from '../../zod-core'\n\n// Helper: Convert Zod discriminated union types to Convex validators\nexport function convertDiscriminatedUnionType(\n actualValidator: $ZodType,\n visited: Set<$ZodType>,\n zodToConvexInternal: (schema: $ZodType, visited: Set<$ZodType>) => any\n): GenericValidator {\n const options =\n actualValidator instanceof $ZodDiscriminatedUnion\n ? actualValidator._zod.def.options\n : // cast: fallback for non-standard discriminated union variants\n (actualValidator as any)._zod?.def?.options\n if (options) {\n const opts = Array.isArray(options) ? options : Array.from(options)\n if (opts.length >= 2) {\n // IMPORTANT: Create a new visited set for each union member to prevent false circular\n // reference detection. The same schema can legitimately appear in multiple union branches.\n const convexOptions = opts.map((opt: any) => {\n const branchVisited = new Set(visited)\n return zodToConvexInternal(opt, branchVisited)\n }) as Validator<any, 'required', any>[]\n const [first, second, ...rest] = convexOptions\n return v.union(\n first as Validator<any, 'required', any>,\n second as Validator<any, 'required', any>,\n ...rest\n )\n } else {\n return v.any()\n }\n } else {\n return v.any()\n }\n}\n\n// Helper: Convert Zod union types to Convex validators\nexport function convertUnionType(\n actualValidator: $ZodUnion,\n visited: Set<$ZodType>,\n zodToConvexInternal: (schema: $ZodType, visited: Set<$ZodType>) => any\n): GenericValidator {\n const options = actualValidator._zod.def.options\n if (options && Array.isArray(options) && options.length > 0) {\n if (options.length === 1) {\n return zodToConvexInternal(options[0], visited)\n } else {\n // Convert each option recursively\n // IMPORTANT: Create a new visited set for each union member to prevent false circular\n // reference detection. The same schema can legitimately appear in multiple union branches.\n // However, we do want to preserve the parent visited set to catch actual circular refs\n // that involve the union itself.\n const convexOptions = options.map((opt: any) => {\n // Create a new Set that includes the parent's visited schemas but won't pollute it\n const branchVisited = new Set(visited)\n return zodToConvexInternal(opt, branchVisited)\n }) as Validator<any, 'required', any>[]\n if (convexOptions.length >= 2) {\n const [first, second, ...rest] = convexOptions\n return v.union(\n first as Validator<any, 'required', any>,\n second as Validator<any, 'required', any>,\n ...rest\n )\n } else {\n return v.any()\n }\n }\n } else {\n return v.any()\n }\n}\n","import { v } from 'convex/values'\nimport { registryHelpers, type Zid } from '../ids'\nimport { getObjectShape } from '../schema/objectShape'\nimport { $ZodType } from '../zod-core'\n\n// Helper to check if a schema is a Zid\nexport function isZid<T extends string>(schema: $ZodType): schema is Zid<T> {\n // Check our metadata registry for ConvexId marker\n const metadata = registryHelpers.getMetadata(schema)\n return (\n metadata?.isConvexId === true && metadata?.tableName && typeof metadata.tableName === 'string'\n )\n}\n\n// union helpers\nexport function makeUnion(members: any[]): any {\n const nonNull = members.filter(Boolean)\n if (nonNull.length === 0) return v.any()\n if (nonNull.length === 1) return nonNull[0]\n return v.union(nonNull[0], nonNull[1], ...nonNull.slice(2))\n}\n\nexport { getObjectShape }\n","import type { GenericValidator, PropertyValidators } from 'convex/values'\nimport { v } from 'convex/values'\nimport { registryHelpers } from '../ids'\nimport {\n $ZodArray,\n $ZodCodec,\n $ZodDefault,\n $ZodEnum,\n $ZodLazy,\n $ZodLiteral,\n $ZodNullable,\n $ZodObject,\n $ZodOptional,\n $ZodRecord,\n type $ZodShape,\n $ZodTuple,\n $ZodType,\n $ZodUnion\n} from '../zod-core'\nimport {\n convertDiscriminatedUnionType,\n convertEnumType,\n convertNullableType,\n convertRecordType,\n convertUnionType\n} from './handlers'\nimport type {\n ConvexValidatorFromZod,\n ConvexValidatorFromZodFieldsAuto,\n ZodValidator\n} from './types'\nimport { isZid } from './utils'\n\n// Module-scoped cache: same Zod schema instance → same Convex validator.\n// Avoids redundant allocations when the same schema is converted across\n// multiple function registrations or table definitions.\nconst convexValidatorCache = new WeakMap<$ZodType, GenericValidator>()\n\n// Internal conversion function using ZodType with def.type detection\nfunction zodToConvexInternal<Z extends $ZodType>(\n zodValidator: Z,\n visited: Set<$ZodType> = new Set()\n): ConvexValidatorFromZod<Z, 'required'> {\n // Guard against undefined/null validators (can happen with { field: undefined } in args)\n if (!zodValidator) {\n return v.any() as ConvexValidatorFromZod<Z, 'required'>\n }\n\n // Return cached result if this exact Zod instance was already converted\n const cached = convexValidatorCache.get(zodValidator)\n if (cached) {\n return cached as ConvexValidatorFromZod<Z, 'required'>\n }\n\n // Detect circular references to prevent infinite recursion\n if (visited.has(zodValidator)) {\n return v.any() as ConvexValidatorFromZod<Z, 'required'>\n }\n visited.add(zodValidator)\n\n // Check for default and optional wrappers\n let actualValidator = zodValidator\n let isOptional = false\n let defaultValue: any = undefined\n let hasDefault = false\n\n // Handle ZodDefault (which wraps ZodOptional when using .optional().default())\n if (zodValidator instanceof $ZodDefault) {\n hasDefault = true\n defaultValue = zodValidator._zod.def.defaultValue\n actualValidator = zodValidator._zod.def.innerType as Z\n }\n\n // Check for optional (may be wrapped inside ZodDefault)\n if (actualValidator instanceof $ZodOptional) {\n isOptional = true\n actualValidator = actualValidator._zod.def.innerType as Z\n\n // If the unwrapped type is ZodDefault, handle it here\n if (actualValidator instanceof $ZodDefault) {\n hasDefault = true\n defaultValue = actualValidator._zod.def.defaultValue\n actualValidator = actualValidator._zod.def.innerType as Z\n }\n }\n\n let convexValidator: GenericValidator\n\n // Check for Zid first (special case)\n if (isZid(actualValidator)) {\n const metadata = registryHelpers.getMetadata(actualValidator)\n const tableName = metadata?.tableName || 'unknown'\n convexValidator = v.id(tableName)\n } else {\n // Use def.type for robust, performant type detection instead of instanceof checks.\n // Rationale:\n // 1. Performance: Single switch statement vs. cascading instanceof checks\n // 2. Completeness: def.type covers ALL Zod variants including formats (email, url, uuid, etc.)\n // 3. Future-proof: Zod's internal structure is stable; instanceof checks can miss custom types\n // 4. Precision: def.type distinguishes between semantically different types (date vs number)\n // This private API access is intentional and necessary for comprehensive type coverage.\n // cast: switch handles more defType values than $ZodTypeDef types (e.g. discriminatedUnion)\n const defType = actualValidator._zod.def.type as string\n\n switch (defType) {\n case 'string':\n // This catches ZodString and ALL string format types (email, url, uuid, etc.)\n convexValidator = v.string()\n break\n case 'number':\n convexValidator = v.float64()\n break\n case 'bigint':\n convexValidator = v.int64()\n break\n case 'boolean':\n convexValidator = v.boolean()\n break\n case 'date':\n // LEGACY: Maps z.date() to v.float64() for backwards compatibility in type inference.\n // However, z.date() does NOT work at runtime because:\n // 1. z.date() produces Date objects, not numbers\n // 2. Convex rejects Date objects as non-serializable\n // 3. z.encode() on z.date() returns a Date, not a timestamp\n // Use zx.date() instead, which provides proper Date ↔ timestamp codec.\n // The wrappers and convexCodec will throw if z.date() is used.\n convexValidator = v.float64()\n break\n case 'null':\n convexValidator = v.null()\n break\n case 'nan':\n convexValidator = v.float64()\n break\n case 'array': {\n if (actualValidator instanceof $ZodArray) {\n const element = actualValidator._zod.def.element\n convexValidator = v.array(zodToConvexInternal(element, visited))\n } else {\n convexValidator = v.array(v.any())\n }\n break\n }\n case 'object': {\n if (actualValidator instanceof $ZodObject) {\n const shape = actualValidator._zod.def.shape\n const convexShape: PropertyValidators = {}\n for (const [key, value] of Object.entries(shape)) {\n if (value && value instanceof $ZodType) {\n convexShape[key] = zodToConvexInternal(value, visited)\n }\n }\n convexValidator = v.object(convexShape)\n } else {\n convexValidator = v.object({})\n }\n break\n }\n case 'union': {\n if (actualValidator instanceof $ZodUnion) {\n convexValidator = convertUnionType(actualValidator, visited, zodToConvexInternal)\n } else {\n convexValidator = v.any()\n }\n break\n }\n case 'discriminatedUnion': {\n convexValidator = convertDiscriminatedUnionType(\n actualValidator,\n visited,\n zodToConvexInternal\n )\n break\n }\n case 'literal': {\n if (actualValidator instanceof $ZodLiteral) {\n const literalValues = actualValidator._zod.def.values\n const firstValue = literalValues.values().next().value\n if (firstValue !== undefined && firstValue !== null) {\n convexValidator = v.literal(firstValue)\n } else {\n convexValidator = v.any()\n }\n } else {\n convexValidator = v.any()\n }\n break\n }\n case 'enum': {\n if (actualValidator instanceof $ZodEnum) {\n convexValidator = convertEnumType(actualValidator)\n } else {\n convexValidator = v.any()\n }\n break\n }\n case 'record': {\n if (actualValidator instanceof $ZodRecord) {\n convexValidator = convertRecordType(actualValidator, visited, zodToConvexInternal)\n } else {\n convexValidator = v.record(v.string(), v.any())\n }\n break\n }\n case 'transform':\n case 'pipe': {\n // Check for native Zod v4 codec first (z.codec())\n // Codecs have def.type='pipe' but are specifically for bidirectional transforms\n // Use the input schema (wire format) for Convex validation\n if (actualValidator instanceof $ZodCodec) {\n const inputSchema = actualValidator._zod.def.in\n if (inputSchema && inputSchema instanceof $ZodType) {\n convexValidator = zodToConvexInternal(inputSchema, visited)\n } else {\n convexValidator = v.any()\n }\n } else {\n // Check for brand metadata\n const metadata = registryHelpers.getMetadata(actualValidator)\n if (metadata?.brand && metadata?.originalSchema) {\n // For branded types created by our zBrand function, use the original schema\n convexValidator = zodToConvexInternal(metadata.originalSchema, visited)\n } else {\n // Non-codec transform - extract input schema but warn\n // cast: no instanceof guard available for generic pipe/transform\n const inputSchema = (actualValidator as any)._zod?.def?.in\n if (inputSchema && inputSchema instanceof $ZodType) {\n if (process.env.NODE_ENV !== 'production') {\n console.warn(\n '[zodvex] z.transform() detected. Using input schema for Convex validation.\\n' +\n 'Transforms are unidirectional - they work for parsing but not encoding.\\n' +\n 'For bidirectional transforms, use zx.codec() instead.'\n )\n }\n convexValidator = zodToConvexInternal(inputSchema, visited)\n } else {\n convexValidator = v.any()\n }\n }\n }\n break\n }\n case 'nullable': {\n if (actualValidator instanceof $ZodNullable) {\n const result = convertNullableType(actualValidator, visited, zodToConvexInternal)\n convexValidator = result.validator\n if (result.isOptional) {\n isOptional = true\n }\n } else {\n convexValidator = v.any()\n }\n break\n }\n case 'tuple': {\n // Handle tuple types as objects with numeric keys\n if (actualValidator instanceof $ZodTuple) {\n const items = actualValidator._zod.def.items\n if (items && items.length > 0) {\n const convexShape: PropertyValidators = {}\n items.forEach((item, index) => {\n convexShape[`_${index}`] = zodToConvexInternal(item, visited)\n })\n convexValidator = v.object(convexShape)\n } else {\n convexValidator = v.object({})\n }\n } else {\n convexValidator = v.object({})\n }\n break\n }\n case 'lazy': {\n // Handle lazy schemas by resolving them\n // Circular references are protected by the visited set check at function start\n if (actualValidator instanceof $ZodLazy) {\n try {\n const getter = actualValidator._zod.def.getter\n if (getter) {\n const resolvedSchema = getter()\n if (resolvedSchema && resolvedSchema instanceof $ZodType) {\n convexValidator = zodToConvexInternal(resolvedSchema, visited)\n } else {\n convexValidator = v.any()\n }\n } else {\n convexValidator = v.any()\n }\n } catch {\n // If resolution fails, fall back to 'any'\n convexValidator = v.any()\n }\n } else {\n convexValidator = v.any()\n }\n break\n }\n case 'any':\n // Handle z.any() directly\n convexValidator = v.any()\n break\n case 'unknown':\n // Handle z.unknown() as any\n convexValidator = v.any()\n break\n case 'undefined':\n case 'void':\n case 'never':\n // These types don't have good Convex equivalents\n convexValidator = v.any()\n break\n case 'intersection':\n // Can't properly handle intersections\n convexValidator = v.any()\n break\n case 'optional': {\n // Fallback for optional types that weren't caught by the instanceof check above.\n // cast: no instanceof guard — this handles edge cases where defType='optional'\n // but the schema isn't a $ZodOptional instance (e.g. pipes wrapped with .optional())\n const innerType = (actualValidator as any)._zod?.def?.innerType\n if (innerType && innerType instanceof $ZodType) {\n convexValidator = zodToConvexInternal(innerType, visited)\n isOptional = true\n } else {\n convexValidator = v.any()\n isOptional = true\n }\n break\n }\n default:\n // For any unrecognized def.type, return v.any()\n // No instanceof fallbacks - keep it simple and performant\n if (process.env.NODE_ENV !== 'production') {\n console.warn(\n `[zodvex] Unrecognized Zod type \"${defType}\" encountered. Falling back to v.any().`,\n 'Schema:',\n actualValidator\n )\n }\n convexValidator = v.any()\n break\n }\n }\n\n // For optional or default fields, always use v.optional()\n const finalValidator = isOptional || hasDefault ? v.optional(convexValidator) : convexValidator\n\n // Add metadata if there's a default value\n if (hasDefault && typeof finalValidator === 'object' && finalValidator !== null) {\n ;(finalValidator as any)._zodDefault = defaultValue\n }\n\n // Cache the result so the same Zod instance returns the same Convex validator\n convexValidatorCache.set(zodValidator, finalValidator)\n\n return finalValidator as ConvexValidatorFromZod<Z, 'required'>\n}\n\nexport function zodToConvex<Z extends $ZodType | ZodValidator>(\n zod: Z\n): Z extends $ZodType\n ? ConvexValidatorFromZod<Z, 'required'>\n : Z extends ZodValidator\n ? ConvexValidatorFromZodFieldsAuto<Z>\n : never {\n if (typeof zod === 'object' && zod !== null && !(zod instanceof $ZodType)) {\n return zodToConvexFields(zod as ZodValidator) as any\n }\n\n return zodToConvexInternal(zod as $ZodType) as any\n}\n\nexport function zodToConvexFields<Z extends $ZodShape>(\n zod: Z\n): ConvexValidatorFromZodFieldsAuto<Z> {\n // If it's a ZodObject, extract the shape\n const fields = zod instanceof $ZodObject ? zod._zod.def.shape : zod\n\n // Build the result object directly to preserve types\n const result: any = {}\n for (const [key, value] of Object.entries(fields)) {\n result[key] = zodToConvexInternal(value as $ZodType)\n }\n\n return result as ConvexValidatorFromZodFieldsAuto<Z>\n}\n","import type { $ZodType } from './zod-core'\n\nconst META_KEY = '__zodvexMeta'\n\nexport type ZodvexFunctionMeta = {\n type: 'function'\n zodArgs?: $ZodType\n zodReturns?: $ZodType\n}\n\nexport type ZodvexModelDefinitionSource = 'shape' | 'schema'\n\nexport type ZodvexModelMeta = {\n type: 'model'\n tableName: string\n definitionSource?: ZodvexModelDefinitionSource\n schemas?: {\n doc: $ZodType\n insert: $ZodType\n update: $ZodType\n docArray: $ZodType\n paginatedDoc: $ZodType\n }\n}\n\nexport type ZodvexMeta = ZodvexFunctionMeta | ZodvexModelMeta\n\nexport function attachMeta(target: object, meta: ZodvexMeta): void {\n Object.defineProperty(target, META_KEY, {\n value: meta,\n enumerable: false,\n writable: false,\n configurable: false\n })\n}\n\nexport function readMeta(target: unknown): ZodvexMeta | undefined {\n if (target == null || (typeof target !== 'object' && typeof target !== 'function')) {\n return undefined\n }\n return (target as Record<string, unknown>)[META_KEY] as ZodvexMeta | undefined\n}\n\nconst CODEC_BRAND_KEY = '__zodvexCodecBrand'\n\n/**\n * Attaches a provenance brand to a codec instance. Codegen reads this at\n * discovery time to match a function-embedded codec to its importable twin\n * by *declared* identity instead of inferring it from structure. Stored\n * non-enumerably so it never leaks into user data, and survives\n * `.optional()` / `.nullable()` wrapping (codegen unwraps to the codec).\n * See `docs/decisions/2026-06-08-codec-provenance-brands.md`.\n */\nexport function attachCodecBrand(target: object, brand: string): void {\n Object.defineProperty(target, CODEC_BRAND_KEY, {\n value: brand,\n enumerable: false,\n writable: false,\n configurable: false\n })\n}\n\n/** Reads a codec's provenance brand, or undefined if unbranded. */\nexport function readCodecBrand(target: unknown): string | undefined {\n if (target == null || typeof target !== 'object') return undefined\n const value = (target as Record<string, unknown>)[CODEC_BRAND_KEY]\n return typeof value === 'string' ? value : undefined\n}\n","import { z } from 'zod'\nimport {\n $ZodArray,\n $ZodCodec,\n $ZodDate,\n $ZodDefault,\n $ZodNullable,\n $ZodObject,\n $ZodOptional,\n $ZodRecord,\n $ZodTuple,\n $ZodType,\n $ZodUnion\n} from '../zod-core'\n\n/**\n * @deprecated Use `zx.date()` instead for automatic Date ↔ timestamp conversion.\n */\nexport function mapDateFieldToNumber(field: $ZodType): $ZodType {\n if (field instanceof $ZodDate) {\n return z.number()\n }\n if (field instanceof $ZodOptional && field._zod.def.innerType instanceof $ZodDate) {\n return z.optional(z.number())\n }\n if (field instanceof $ZodNullable && field._zod.def.innerType instanceof $ZodDate) {\n return z.nullable(z.number())\n }\n if (field instanceof $ZodDefault) {\n const inner = field._zod.def.innerType\n if (inner instanceof $ZodDate) {\n return z.optional(z.number())\n }\n }\n return field\n}\n\nfunction containsNativeZodDate(schema: $ZodType): boolean {\n if (schema instanceof $ZodDate) return true\n if (schema instanceof $ZodCodec) return false\n\n if (\n schema instanceof $ZodOptional ||\n schema instanceof $ZodNullable ||\n schema instanceof $ZodDefault\n ) {\n return containsNativeZodDate(schema._zod.def.innerType)\n }\n\n if (schema instanceof $ZodObject) {\n return Object.values(schema._zod.def.shape).some(field => containsNativeZodDate(field))\n }\n if (schema instanceof $ZodArray) {\n return containsNativeZodDate(schema._zod.def.element)\n }\n if (schema instanceof $ZodUnion) {\n return schema._zod.def.options.some(opt => containsNativeZodDate(opt))\n }\n if (schema instanceof $ZodRecord) {\n return containsNativeZodDate(schema._zod.def.valueType)\n }\n if (schema instanceof $ZodTuple) {\n const items = schema._zod.def.items\n return items ? items.some(item => containsNativeZodDate(item)) : false\n }\n\n return false\n}\n\nexport function assertNoNativeZodDate(\n schema: $ZodType,\n context: 'args' | 'returns' | 'schema'\n): void {\n if (containsNativeZodDate(schema)) {\n throw new Error(\n `[zodvex] Native z.date() found in ${context}. ` +\n `Convex stores dates as timestamps (numbers), which z.date() cannot parse.\\n\\n` +\n `Fix: Replace z.date() with zx.date()\\n\\n` +\n `Before: { createdAt: z.date() }\\n` +\n `After: { createdAt: zx.date() }\\n\\n` +\n `zx.date() is a codec that handles timestamp ↔ Date conversion automatically.`\n )\n }\n}\n","/**\n * Server-only utilities — imports ConvexError from convex/values.\n * Do NOT re-export from core/index.ts or any client-safe barrel.\n */\nimport { ConvexError } from 'convex/values'\nimport { z } from 'zod'\nimport { $ZodError, $ZodType, encode, parse } from './zod-core'\n\n// Format ZodError issues into a compact, consistent structure\nexport function formatZodIssues(\n error: z.ZodError, // zod-ok\n context?: 'args' | 'returns' | 'input' | 'output' | 'codec'\n) {\n return {\n error: 'ZodValidationError',\n context,\n issues: error.issues.map(issue => ({\n path: Array.isArray(issue.path) ? issue.path.join('.') : String(issue.path ?? ''),\n code: issue.code,\n message: issue.message\n })),\n // Keep a flattened snapshot for easier debugging without cyclic refs\n flatten: JSON.parse(JSON.stringify(error.flatten?.() ?? {}))\n }\n}\n\n// Handle Zod validation errors consistently across all wrappers\n// Throws a ConvexError with formatted issues if the error is a ZodError, otherwise re-throws\nexport function handleZodValidationError(\n e: unknown,\n context: 'args' | 'returns' | 'input' | 'output' | 'codec'\n): never {\n if (e instanceof $ZodError) {\n throw new ConvexError(formatZodIssues(e as z.ZodError, context)) // zod-ok\n }\n throw e\n}\n\n/**\n * Validates a return value against a Zod schema, supporting both codecs and regular schemas.\n *\n * Tries z.encode() first (for codec support), then falls back to .parse() if the schema\n * contains unidirectional transforms (which don't support encoding).\n *\n * For codecs: returns the encoded wire format (z.input<T>)\n * For transforms: returns the transformed output (z.output<T>)\n * For plain schemas: returns the validated value\n *\n * @param schema - The Zod schema to validate against\n * @param value - The value to validate\n * @returns The validated/encoded value\n * @throws Calls handleZodValidationError on validation failure\n */\nexport function validateReturns(schema: $ZodType, value: unknown): unknown {\n try {\n // Try encode first - works for codecs and plain schemas\n return encode(schema, value)\n } catch (e: any) {\n // If it's a unidirectional transform error, fall back to parse\n if (e?.message?.includes('unidirectional transform')) {\n try {\n return parse(schema, value)\n } catch (parseError) {\n handleZodValidationError(parseError, 'returns')\n }\n }\n // For any other error, handle it normally\n handleZodValidationError(e, 'returns')\n }\n // TypeScript can't infer that handleZodValidationError always throws\n throw new Error('Unreachable')\n}\n","export function pick<T extends Record<string, any>, K extends keyof T>(\n obj: T,\n keys: K[]\n): Pick<T, K> {\n const result = {} as Pick<T, K>\n for (const key of keys) {\n if (key in obj) result[key] = obj[key]\n }\n return result\n}\n","/**\n * Recursively strips `undefined` values from objects and arrays.\n * Used by codec encode/decode to clean wire data.\n *\n * Extracted to its own module so client-safe code (boundaryHelpers)\n * can import it without pulling in zod via utils.ts.\n */\nexport function stripUndefined<T>(value: T): T {\n if (value === null || value === undefined) {\n return value\n }\n\n if (Array.isArray(value)) {\n return value.map(stripUndefined) as T\n }\n\n // Only process plain objects (not class instances, Dates, etc.)\n if (typeof value === 'object' && value.constructor === Object) {\n const result: Record<string, unknown> = {}\n for (const [key, val] of Object.entries(value)) {\n if (val !== undefined) {\n result[key] = stripUndefined(val)\n }\n }\n return result as T\n }\n\n return value\n}\n","import { z } from 'zod'\nimport { getObjectShape, type ZodValidator, zodToConvex, zodToConvexFields } from './mapping'\nimport { attachMeta } from './meta'\nimport { assertNoNativeZodDate } from './schema/dateGuards'\nimport { handleZodValidationError, validateReturns } from './serverUtils'\nimport { pick } from './shared/object'\nimport { stripUndefined } from './stripUndefined'\nimport {\n $ZodCustom,\n $ZodDefault,\n $ZodNullable,\n $ZodObject,\n $ZodOptional,\n $ZodType,\n $ZodUnion,\n safeParse,\n parse as zodParse\n} from './zod-core'\n\nexport type FunctionSchemaInput = $ZodType | Record<string, $ZodType> | undefined\nexport type DirectFunctionInput = $ZodType | Record<string, $ZodType>\n\nexport type CustomInputResult = {\n ctx?: Record<string, unknown>\n args?: Record<string, unknown>\n onSuccess?: (params: { ctx: unknown; args: unknown; result: unknown }) => unknown\n}\n\nexport function normalizeFunctionSchema(input: FunctionSchemaInput): $ZodType | undefined {\n if (!input) return undefined\n return input instanceof $ZodType ? input : z.object(input)\n}\n\nfunction normalizeFunctionMetaArgs(input: FunctionSchemaInput): z.ZodObject<any> | undefined {\n if (!input) return undefined\n if (input instanceof $ZodObject) {\n return input as unknown as z.ZodObject<any> // zod-ok\n }\n if (input instanceof $ZodType) {\n return undefined\n }\n return z.object(input)\n}\n\nexport function attachFunctionMeta(\n target: object,\n args: FunctionSchemaInput,\n returns: FunctionSchemaInput\n): void {\n attachMeta(target, {\n type: 'function',\n zodArgs: normalizeFunctionMetaArgs(args),\n zodReturns: normalizeFunctionSchema(returns)\n })\n}\n\n// Cache to avoid re-checking the same schema\nconst customCheckCache = new WeakMap<$ZodType, boolean>()\n\nfunction containsCustom(schema: $ZodType, maxDepth = 50, currentDepth = 0): boolean {\n const cached = customCheckCache.get(schema)\n if (cached !== undefined) {\n return cached\n }\n\n if (currentDepth > maxDepth) {\n return false\n }\n\n let result = false\n if (schema instanceof $ZodCustom) {\n result = true\n } else if (schema instanceof $ZodUnion) {\n result = schema._zod.def.options.some(opt => containsCustom(opt, maxDepth, currentDepth + 1))\n } else if (schema instanceof $ZodOptional) {\n result = containsCustom(schema._zod.def.innerType, maxDepth, currentDepth + 1)\n } else if (schema instanceof $ZodNullable) {\n result = containsCustom(schema._zod.def.innerType, maxDepth, currentDepth + 1)\n } else if (schema instanceof $ZodDefault) {\n result = containsCustom(schema._zod.def.innerType, maxDepth, currentDepth + 1)\n }\n\n customCheckCache.set(schema, result)\n return result\n}\n\nexport function normalizeDirectFunctionInput(input: DirectFunctionInput): {\n zodSchema: $ZodType\n convexArgs: Record<string, any>\n} {\n if (input instanceof $ZodObject) {\n return {\n zodSchema: input,\n convexArgs: zodToConvexFields(getObjectShape(input))\n }\n }\n\n if (input instanceof $ZodType) {\n return {\n zodSchema: z.object({ value: input as any }),\n convexArgs: { value: zodToConvex(input as any) }\n }\n }\n\n return {\n zodSchema: z.object(input),\n convexArgs: zodToConvexFields(input)\n }\n}\n\nexport function normalizeCustomArgsValidator(args: ZodValidator | $ZodObject): {\n argsValidator: ZodValidator\n argsSchema: $ZodObject\n} {\n if (args instanceof $ZodType) {\n if (args instanceof $ZodObject) {\n return {\n argsSchema: args as unknown as $ZodObject,\n argsValidator: args._zod.def.shape as any\n }\n }\n throw new Error(\n 'Unsupported non-object Zod schema for args; please provide an args schema using z.object({...}), e.g. z.object({ foo: z.string() })'\n )\n }\n\n return {\n argsValidator: args,\n argsSchema: z.object(args)\n }\n}\n\nexport function createConvexReturnsValidator(\n schema?: $ZodType,\n options?: { skipCustomSchemas?: boolean; skipConvexValidation?: boolean }\n): any {\n if (!schema || options?.skipConvexValidation) {\n return undefined\n }\n if (options?.skipCustomSchemas && containsCustom(schema)) {\n return undefined\n }\n return zodToConvex(schema)\n}\n\nexport function assertFunctionSchemas(argsSchema: $ZodType, returnsSchema?: $ZodType): void {\n assertNoNativeZodDate(argsSchema, 'args')\n if (returnsSchema) {\n assertNoNativeZodDate(returnsSchema, 'returns')\n }\n}\n\nexport function parseFunctionArgsOrThrow(zodSchema: $ZodType, argsObject: unknown): any {\n try {\n return zodParse(zodSchema, argsObject) as any\n } catch (e) {\n handleZodValidationError(e, 'args')\n }\n}\n\nexport function parseObjectArgsOrThrow(\n argsSchema: $ZodObject,\n rawArgs: Record<string, unknown>\n): Record<string, unknown> {\n const parsed = safeParse(argsSchema, rawArgs)\n if (!parsed.success) {\n handleZodValidationError(parsed.error, 'args')\n }\n return parsed.data as Record<string, unknown>\n}\n\nexport async function runCustomizationInput(\n customInput: (ctx: unknown, args: unknown, extra?: unknown) => unknown,\n ctx: unknown,\n allArgs: Record<string, unknown>,\n inputArgs: Record<string, unknown>,\n extra: Record<string, unknown>\n): Promise<CustomInputResult | undefined> {\n return (await customInput(\n ctx,\n // Cast justification: customInput expects ObjectType<CustomArgsValidator>, but pick()\n // returns Partial<T>. The cast is safe because inputArgs keys are derived from\n // CustomArgsValidator at the type level.\n pick(allArgs, Object.keys(inputArgs)) as any,\n extra\n )) as CustomInputResult | undefined\n}\n\nexport function applyCustomizationResult(\n ctx: Record<string, unknown>,\n baseArgs: Record<string, unknown>,\n added?: CustomInputResult\n): { finalCtx: Record<string, unknown>; finalArgs: Record<string, unknown> } {\n const finalCtx = { ...ctx, ...(added?.ctx ?? {}) }\n const addedArgs = added?.args ?? {}\n return {\n finalCtx,\n finalArgs: { ...baseArgs, ...addedArgs }\n }\n}\n\nexport async function finalizeFunctionReturn(\n result: unknown,\n options?: {\n ctx?: Record<string, unknown>\n args?: Record<string, unknown>\n added?: CustomInputResult\n returns?: $ZodType\n }\n): Promise<unknown> {\n if (options?.added?.onSuccess) {\n await options.added.onSuccess({\n ctx: options.ctx,\n args: options.args,\n result\n })\n }\n\n if (options?.returns) {\n const validated = validateReturns(options.returns, result)\n return stripUndefined(validated)\n }\n\n return stripUndefined(result)\n}\n","import {\n type ActionBuilder,\n type ArgsArrayToObject,\n type DefaultFunctionArgs,\n type FunctionVisibility,\n type GenericActionCtx,\n type GenericDataModel,\n type GenericMutationCtx,\n type GenericQueryCtx,\n type MutationBuilder,\n type QueryBuilder\n} from 'convex/server'\nimport { type PropertyValidators } from 'convex/values'\nimport { type Customization, NoOp } from 'convex-helpers/server/customFunctions'\nimport { z } from 'zod'\nimport {\n applyCustomizationResult,\n attachFunctionMeta,\n createConvexReturnsValidator,\n finalizeFunctionReturn,\n normalizeCustomArgsValidator,\n normalizeFunctionSchema,\n parseObjectArgsOrThrow,\n runCustomizationInput\n} from './functionContracts'\nimport { type ZodValidator, zodToConvexFields } from './mapping'\nimport { assertNoNativeZodDate } from './schema/dateGuards'\nimport { pick } from './shared/object'\nimport type { ExtractCtx, ExtractVisibility, Overwrite } from './types'\nimport { $ZodObject, $ZodType } from './zod-core'\n\n// Type helpers for args transformation (from zodV3 example)\ntype OneArgArray<ArgsObject extends DefaultFunctionArgs = DefaultFunctionArgs> = [ArgsObject]\n\n// Simple type conversion from a Convex validator to a Zod validator return type\ntype NullToUndefinedOrNull<T> = T extends null ? T | undefined | void : T\ntype Returns<T> = Promise<NullToUndefinedOrNull<T>> | NullToUndefinedOrNull<T>\n\n// The return value before it's been validated: returned by the handler\n// Uses z.output since the handler produces the internal representation (e.g., Date),\n// which is then encoded to wire format (e.g., string) before sending to the client\ntype ReturnValueInput<ReturnsValidator extends $ZodType | ZodValidator | void> = [\n ReturnsValidator\n] extends [$ZodType]\n ? Returns<z.output<ReturnsValidator>>\n : [ReturnsValidator] extends [ZodValidator]\n ? Returns<z.output<$ZodObject<ReturnsValidator>>>\n : any\n\n// The return value after it's been validated: returned to the client\ntype ReturnValueOutput<ReturnsValidator extends $ZodType | ZodValidator | void> = [\n ReturnsValidator\n] extends [$ZodType]\n ? Returns<z.output<ReturnsValidator>>\n : [ReturnsValidator] extends [ZodValidator]\n ? Returns<z.output<$ZodObject<ReturnsValidator>>>\n : any\n\n// The args as seen by the caller: runtime types (z.output), not wire types (z.input).\n// For codecs (e.g., custom field types), z.output = runtime class, z.input = wire object.\n// Callers pass runtime types; encoding to wire format happens inside the wrapper.\ntype ArgsInput<ArgsValidator extends ZodValidator | $ZodObject | void> = [ArgsValidator] extends [\n $ZodObject\n]\n ? [z.output<ArgsValidator>]\n : [ArgsValidator] extends [ZodValidator]\n ? [z.output<$ZodObject<ArgsValidator>>]\n : OneArgArray\n\n// The args after they've been validated: passed to the handler\ntype ArgsOutput<ArgsValidator extends ZodValidator | $ZodObject | void> = [ArgsValidator] extends [\n $ZodObject\n]\n ? [z.output<ArgsValidator>]\n : [ArgsValidator] extends [ZodValidator]\n ? [z.output<$ZodObject<ArgsValidator>>]\n : OneArgArray\n\n// Re-export for backwards compatibility (canonical definition in types.ts)\nexport type { Overwrite } from './types'\n\n// Hack to simplify how TypeScript renders object types\ntype Expand<ObjectType extends Record<any, any>> =\n ObjectType extends Record<any, any>\n ? {\n [Key in keyof ObjectType]: ObjectType[Key]\n }\n : never\n\ntype ArgsForHandlerType<\n OneOrZeroArgs extends [] | [Record<string, any>],\n CustomMadeArgs extends Record<string, any>\n> =\n CustomMadeArgs extends Record<string, never>\n ? OneOrZeroArgs\n : OneOrZeroArgs extends [infer A]\n ? [Expand<A & CustomMadeArgs>]\n : [CustomMadeArgs]\n\n// Helper type for function registration (from zodV3)\ntype Registration<\n FuncType extends 'query' | 'mutation' | 'action',\n Visibility extends FunctionVisibility,\n Args extends DefaultFunctionArgs,\n Output\n> = FuncType extends 'query'\n ? import('convex/server').RegisteredQuery<Visibility, Args, Output>\n : FuncType extends 'mutation'\n ? import('convex/server').RegisteredMutation<Visibility, Args, Output>\n : import('convex/server').RegisteredAction<Visibility, Args, Output>\n\n/**\n * A builder that customizes a Convex function, whether or not it validates\n * arguments. If the customization requires arguments, however, the resulting\n * builder will require argument validation too.\n *\n * This is our own Zod-aware CustomBuilder type that properly handles Zod validators.\n */\nexport type CustomBuilder<\n FuncType extends 'query' | 'mutation' | 'action',\n CustomArgsValidator extends PropertyValidators,\n CustomCtx extends Record<string, any>,\n CustomMadeArgs extends Record<string, any>,\n InputCtx,\n Visibility extends FunctionVisibility,\n ExtraArgs extends Record<string, any>\n> = {\n <\n ArgsValidator extends ZodValidator | $ZodObject | void,\n ReturnsZodValidator extends $ZodType | ZodValidator | void = void,\n ReturnValue extends ReturnValueInput<ReturnsZodValidator> = any\n >(\n func:\n | ({\n /**\n * Specify the arguments to the function as a Zod validator.\n */\n args?: ArgsValidator\n handler: (\n ctx: Overwrite<InputCtx, CustomCtx>,\n ...args: ArgsForHandlerType<ArgsOutput<ArgsValidator>, CustomMadeArgs>\n ) => ReturnValue\n /**\n * Validates the value returned by the function.\n * Note: you can't pass an object directly without wrapping it\n * in `z.object()`.\n */\n returns?: ReturnsZodValidator\n /**\n * If true, the function will not be validated by Convex,\n * in case you're seeing performance issues with validating twice.\n */\n skipConvexValidation?: boolean\n } & {\n [key in keyof ExtraArgs as key extends\n | 'args'\n | 'handler'\n | 'skipConvexValidation'\n | 'returns'\n ? never\n : key]: ExtraArgs[key]\n })\n | {\n (\n ctx: Overwrite<InputCtx, CustomCtx>,\n ...args: ArgsForHandlerType<ArgsOutput<ArgsValidator>, CustomMadeArgs>\n ): ReturnValue\n }\n ): Registration<\n FuncType,\n Visibility,\n ArgsArrayToObject<\n CustomArgsValidator extends Record<string, never>\n ? ArgsInput<ArgsValidator>\n : ArgsInput<ArgsValidator> extends [infer A]\n ? [Expand<A & import('convex/values').ObjectType<CustomArgsValidator>>]\n : [import('convex/values').ObjectType<CustomArgsValidator>]\n >,\n ReturnsZodValidator extends void ? ReturnValue : ReturnValueOutput<ReturnsZodValidator>\n >\n}\n\nexport function customFnBuilder<\n Ctx extends Record<string, any>,\n Builder extends (fn: any) => any,\n CustomArgsValidator extends PropertyValidators,\n CustomCtx extends Record<string, any>,\n CustomMadeArgs extends Record<string, any>,\n ExtraArgs extends Record<string, any> = Record<string, any>\n>(\n builder: Builder,\n customization: Customization<Ctx, CustomArgsValidator, CustomCtx, CustomMadeArgs, ExtraArgs>\n) {\n const customInput = customization.input ?? NoOp.input\n const inputArgs = customization.args ?? NoOp.args\n\n return function customBuilder(fn: any): any {\n const { args, handler = fn, returns: maybeObject, ...extra } = fn\n const skipConvexValidation = fn.skipConvexValidation ?? false\n\n const returns = normalizeFunctionSchema(maybeObject)\n const returnValidator = createConvexReturnsValidator(returns, { skipConvexValidation })\n const convexReturns = returnValidator ? { returns: returnValidator } : undefined\n\n // Check for z.date() usage at construction time (once), not on every invocation\n if (returns) {\n assertNoNativeZodDate(returns as $ZodType, 'returns')\n }\n\n if (args) {\n const { argsValidator, argsSchema } = normalizeCustomArgsValidator(args)\n\n // Only generate Convex args validator when not skipping Convex validation\n const convexArgs = skipConvexValidation\n ? inputArgs\n : { ...zodToConvexFields(argsValidator), ...inputArgs }\n\n // Check for z.date() usage at construction time (once), not on every invocation\n assertNoNativeZodDate(argsSchema, 'args')\n\n const registered = builder({\n args: convexArgs,\n ...convexReturns,\n handler: async (ctx: Ctx, allArgs: any) => {\n const added = await runCustomizationInput(\n customInput as any,\n ctx,\n allArgs,\n inputArgs,\n extra\n )\n const argKeys = Object.keys(argsValidator)\n const rawArgs = pick(allArgs, argKeys)\n const baseArgs = parseObjectArgsOrThrow(argsSchema, rawArgs)\n const { finalCtx, finalArgs } = applyCustomizationResult(ctx as any, baseArgs, added)\n\n const ret = await handler(finalCtx, finalArgs)\n return finalizeFunctionReturn(ret, { ctx: ctx as any, args: baseArgs, added, returns })\n }\n })\n attachFunctionMeta(registered, argsSchema, returns)\n return registered\n }\n const registered = builder({\n args: inputArgs,\n ...convexReturns,\n handler: async (ctx: Ctx, allArgs: any) => {\n const baseArgs = allArgs as Record<string, unknown>\n const added = await runCustomizationInput(\n customInput as any,\n ctx,\n allArgs,\n inputArgs,\n extra\n )\n const { finalCtx, finalArgs } = applyCustomizationResult(ctx as any, baseArgs, added)\n\n const ret = await handler(finalCtx, finalArgs)\n return finalizeFunctionReturn(ret, { ctx: ctx as any, args: baseArgs, added, returns })\n }\n })\n attachFunctionMeta(registered, undefined, returns)\n return registered\n }\n}\n\nfunction createCustomBuilderEntrypoint<\n Builder extends (fn: any) => any,\n CustomArgsValidator extends PropertyValidators,\n CustomCtx extends Record<string, any>,\n CustomMadeArgs extends Record<string, any>,\n ExtraArgs extends Record<string, any> = Record<string, any>\n>(\n builder: Builder,\n customization: Customization<any, CustomArgsValidator, CustomCtx, CustomMadeArgs, ExtraArgs>\n) {\n return customFnBuilder<any, Builder, CustomArgsValidator, CustomCtx, CustomMadeArgs, ExtraArgs>(\n builder as any,\n customization as any\n ) as any\n}\n\n// Overload 1: With constraint - preferred to preserve DataModel types\nexport function zCustomQuery<\n CustomArgsValidator extends PropertyValidators,\n CustomCtx extends Record<string, any>,\n CustomMadeArgs extends Record<string, any>,\n Visibility extends FunctionVisibility,\n DataModel extends GenericDataModel,\n ExtraArgs extends Record<string, any> = Record<string, any>\n>(\n query: QueryBuilder<DataModel, Visibility>,\n customization: Customization<any, CustomArgsValidator, CustomCtx, CustomMadeArgs, ExtraArgs>\n): CustomBuilder<\n 'query',\n CustomArgsValidator,\n CustomCtx,\n CustomMadeArgs,\n GenericQueryCtx<DataModel>,\n Visibility,\n ExtraArgs\n>\n\n// Overload 2: No constraint + decoupled ctx\nexport function zCustomQuery<\n CustomArgsValidator extends PropertyValidators,\n CustomCtx extends Record<string, any>,\n CustomMadeArgs extends Record<string, any>,\n Visibility extends FunctionVisibility,\n ExtraArgs extends Record<string, any> = Record<string, any>\n>(\n query: QueryBuilder<any, Visibility>,\n customization: Customization<any, CustomArgsValidator, CustomCtx, CustomMadeArgs, ExtraArgs>\n): CustomBuilder<\n 'query',\n CustomArgsValidator,\n CustomCtx,\n CustomMadeArgs,\n any,\n Visibility,\n ExtraArgs\n>\n\n// Implementation\nexport function zCustomQuery<\n CustomArgsValidator extends PropertyValidators,\n CustomCtx extends Record<string, any>,\n CustomMadeArgs extends Record<string, any>,\n Visibility extends FunctionVisibility,\n ExtraArgs extends Record<string, any> = Record<string, any>\n>(\n query: QueryBuilder<any, Visibility>,\n customization: Customization<any, CustomArgsValidator, CustomCtx, CustomMadeArgs, ExtraArgs>\n) {\n // Cast justification: This is the TypeScript overload implementation pattern. The function\n // has two overloads (with/without DataModel constraint) that provide precise types to callers.\n // The implementation must satisfy both overloads, which requires a broader signature.\n // The 'as any' casts allow the implementation to delegate to customFnBuilder without\n // TypeScript complaining about the generic parameter differences between overloads.\n // This is type-safe because: (1) callers only see the overload signatures which are strict,\n // (2) the runtime behavior is identical regardless of which overload matched.\n // TODO: Consider using a conditional type or branded types to create a single signature\n // that satisfies both overloads without casts. Alternatively, accept this as idiomatic\n // TypeScript for overloaded functions and keep the casts.\n return createCustomBuilderEntrypoint(query, customization)\n}\n\n// Overload 1: With constraint - preferred to preserve DataModel types\nexport function zCustomMutation<\n CustomArgsValidator extends PropertyValidators,\n CustomCtx extends Record<string, any>,\n CustomMadeArgs extends Record<string, any>,\n Builder extends (fn: any) => any,\n Visibility extends FunctionVisibility = 'public',\n ExtraArgs extends Record<string, any> = Record<string, any>\n>(\n mutation: Builder,\n customization: Customization<any, CustomArgsValidator, CustomCtx, CustomMadeArgs, ExtraArgs>\n): CustomBuilder<\n 'mutation',\n CustomArgsValidator,\n CustomCtx,\n CustomMadeArgs,\n ExtractCtx<Builder>,\n Visibility,\n ExtraArgs\n>\n\n// Implementation\nexport function zCustomMutation<\n CustomArgsValidator extends PropertyValidators,\n CustomCtx extends Record<string, any>,\n CustomMadeArgs extends Record<string, any>,\n Builder extends (fn: any) => any,\n _Visibility extends FunctionVisibility = 'public',\n ExtraArgs extends Record<string, any> = Record<string, any>\n>(\n mutation: Builder,\n customization: Customization<any, CustomArgsValidator, CustomCtx, CustomMadeArgs, ExtraArgs>\n) {\n // Cast justification: Same overload implementation pattern as zCustomQuery.\n // See detailed comment there. Type safety is enforced by the overload signature above.\n return createCustomBuilderEntrypoint(mutation, customization)\n}\n\n// Overload 1: With constraint - preferred to preserve DataModel types\nexport function zCustomAction<\n CustomArgsValidator extends PropertyValidators,\n CustomCtx extends Record<string, any>,\n CustomMadeArgs extends Record<string, any>,\n Builder extends (fn: any) => any,\n Visibility extends FunctionVisibility = 'public',\n ExtraArgs extends Record<string, any> = Record<string, any>\n>(\n action: Builder,\n customization: Customization<any, CustomArgsValidator, CustomCtx, CustomMadeArgs, ExtraArgs>\n): CustomBuilder<\n 'action',\n CustomArgsValidator,\n CustomCtx,\n CustomMadeArgs,\n ExtractCtx<Builder>,\n Visibility,\n ExtraArgs\n>\n\n// Implementation\nexport function zCustomAction<\n CustomArgsValidator extends PropertyValidators,\n CustomCtx extends Record<string, any>,\n CustomMadeArgs extends Record<string, any>,\n Builder extends (fn: any) => any,\n _Visibility extends FunctionVisibility = 'public',\n ExtraArgs extends Record<string, any> = Record<string, any>\n>(\n action: Builder,\n customization: Customization<any, CustomArgsValidator, CustomCtx, CustomMadeArgs, ExtraArgs>\n) {\n // Cast justification: Same overload implementation pattern as zCustomQuery.\n // See detailed comment there. Type safety is enforced by the overload signature above.\n return createCustomBuilderEntrypoint(action, customization)\n}\n","import type {\n FunctionVisibility,\n RegisteredAction,\n RegisteredMutation,\n RegisteredQuery\n} from 'convex/server'\nimport {\n assertFunctionSchemas,\n createConvexReturnsValidator,\n type DirectFunctionInput,\n finalizeFunctionReturn,\n normalizeDirectFunctionInput,\n parseFunctionArgsOrThrow\n} from './functionContracts'\n// Typing helpers to keep handler args/returns precise without deep remapping\nimport type {\n ExtractCtx,\n ExtractVisibility,\n InferHandlerReturns,\n InferReturns,\n ZodToConvexArgs\n} from './types'\nimport { $ZodType } from './zod-core'\n\nfunction registerZodFunction<\n Builder extends (fn: any) => any,\n A extends DirectFunctionInput,\n R extends $ZodType | undefined\n>(\n builder: Builder,\n input: A,\n handler: (\n ctx: ExtractCtx<Builder>,\n args: ZodToConvexArgs<A>\n ) => InferHandlerReturns<R> | Promise<InferHandlerReturns<R>>,\n options?: { returns?: R }\n): any {\n const { zodSchema, convexArgs } = normalizeDirectFunctionInput(input)\n const returnsSchema = options?.returns as $ZodType | undefined\n const returns = createConvexReturnsValidator(returnsSchema, { skipCustomSchemas: true })\n\n assertFunctionSchemas(zodSchema, returnsSchema)\n\n return builder({\n args: convexArgs,\n returns,\n handler: async (ctx: any, argsObject: unknown) => {\n const parsed = parseFunctionArgsOrThrow(zodSchema, argsObject)\n const raw = await handler(ctx, parsed)\n return finalizeFunctionReturn(raw, { returns: returnsSchema })\n }\n }) as any\n}\n\nexport function zQuery<\n Builder extends (fn: any) => any,\n A extends $ZodType | Record<string, $ZodType>,\n R extends $ZodType | undefined = undefined,\n Visibility extends FunctionVisibility = ExtractVisibility<Builder>\n>(\n query: Builder,\n input: A,\n handler: (\n ctx: ExtractCtx<Builder>,\n args: ZodToConvexArgs<A>\n ) => InferHandlerReturns<R> | Promise<InferHandlerReturns<R>>,\n options?: { returns?: R }\n): RegisteredQuery<Visibility, ZodToConvexArgs<A>, Promise<InferReturns<R>>> {\n return registerZodFunction(query, input, handler, options)\n}\n\nexport function zInternalQuery<\n Builder extends (fn: any) => any,\n A extends $ZodType | Record<string, $ZodType>,\n R extends $ZodType | undefined = undefined,\n Visibility extends FunctionVisibility = ExtractVisibility<Builder>\n>(\n internalQuery: Builder,\n input: A,\n handler: (\n ctx: ExtractCtx<Builder>,\n args: ZodToConvexArgs<A>\n ) => InferHandlerReturns<R> | Promise<InferHandlerReturns<R>>,\n options?: { returns?: R }\n): RegisteredQuery<Visibility, ZodToConvexArgs<A>, Promise<InferReturns<R>>> {\n return zQuery(internalQuery, input, handler, options)\n}\n\nexport function zMutation<\n Builder extends (fn: any) => any,\n A extends $ZodType | Record<string, $ZodType>,\n R extends $ZodType | undefined = undefined,\n Visibility extends FunctionVisibility = ExtractVisibility<Builder>\n>(\n mutation: Builder,\n input: A,\n handler: (\n ctx: ExtractCtx<Builder>,\n args: ZodToConvexArgs<A>\n ) => InferHandlerReturns<R> | Promise<InferHandlerReturns<R>>,\n options?: { returns?: R }\n): RegisteredMutation<Visibility, ZodToConvexArgs<A>, Promise<InferReturns<R>>> {\n return registerZodFunction(mutation, input, handler, options)\n}\n\nexport function zInternalMutation<\n Builder extends (fn: any) => any,\n A extends $ZodType | Record<string, $ZodType>,\n R extends $ZodType | undefined = undefined,\n Visibility extends FunctionVisibility = ExtractVisibility<Builder>\n>(\n internalMutation: Builder,\n input: A,\n handler: (\n ctx: ExtractCtx<Builder>,\n args: ZodToConvexArgs<A>\n ) => InferHandlerReturns<R> | Promise<InferHandlerReturns<R>>,\n options?: { returns?: R }\n): RegisteredMutation<Visibility, ZodToConvexArgs<A>, Promise<InferReturns<R>>> {\n return zMutation(internalMutation, input, handler, options)\n}\n\nexport function zAction<\n Builder extends (fn: any) => any,\n A extends $ZodType | Record<string, $ZodType>,\n R extends $ZodType | undefined = undefined,\n Visibility extends FunctionVisibility = ExtractVisibility<Builder>\n>(\n action: Builder,\n input: A,\n handler: (\n ctx: ExtractCtx<Builder>,\n args: ZodToConvexArgs<A>\n ) => InferHandlerReturns<R> | Promise<InferHandlerReturns<R>>,\n options?: { returns?: R }\n): RegisteredAction<Visibility, ZodToConvexArgs<A>, Promise<InferReturns<R>>> {\n return registerZodFunction(action, input, handler, options)\n}\n\nexport function zInternalAction<\n Builder extends (fn: any) => any,\n A extends $ZodType | Record<string, $ZodType>,\n R extends $ZodType | undefined = undefined,\n Visibility extends FunctionVisibility = ExtractVisibility<Builder>\n>(\n internalAction: Builder,\n input: A,\n handler: (\n ctx: ExtractCtx<Builder>,\n args: ZodToConvexArgs<A>\n ) => InferHandlerReturns<R> | Promise<InferHandlerReturns<R>>,\n options?: { returns?: R }\n): RegisteredAction<Visibility, ZodToConvexArgs<A>, Promise<InferReturns<R>>> {\n return zAction(internalAction, input, handler, options) as any\n}\n","import type {\n FunctionVisibility,\n RegisteredAction,\n RegisteredMutation,\n RegisteredQuery\n} from 'convex/server'\nimport type { PropertyValidators } from 'convex/values'\nimport type { Customization } from 'convex-helpers/server/customFunctions'\nimport { type CustomBuilder, customFnBuilder } from './custom'\nimport { attachFunctionMeta } from './functionContracts'\nimport type {\n ExtractCtx,\n ExtractVisibility,\n InferHandlerReturns,\n InferReturns,\n ZodToConvexArgs\n} from './types'\nimport { zAction, zMutation, zQuery } from './wrappers'\nimport { $ZodType } from './zod-core'\n\ntype BuilderConfig<\n Builder extends (fn: any) => any,\n A extends $ZodType | Record<string, $ZodType> | undefined,\n R extends $ZodType | undefined\n> = {\n args?: A\n handler: (\n ctx: ExtractCtx<Builder>,\n args: ZodToConvexArgs<A extends undefined ? Record<string, never> : A>\n ) => InferHandlerReturns<R> | Promise<InferHandlerReturns<R>>\n returns?: R\n}\n\nfunction registerBuilderFunction<\n Builder extends (fn: any) => any,\n A extends $ZodType | Record<string, $ZodType> | undefined,\n R extends $ZodType | undefined,\n Result\n>(\n register: (\n builder: Builder,\n input: A extends undefined ? Record<string, never> : A,\n handler: (\n ctx: ExtractCtx<Builder>,\n args: ZodToConvexArgs<A extends undefined ? Record<string, never> : A>\n ) => InferHandlerReturns<R> | Promise<InferHandlerReturns<R>>,\n options: { returns?: R }\n ) => Result,\n builder: Builder,\n config: BuilderConfig<Builder, A, R>\n): Result {\n const result = register(builder, (config.args ?? ({} as any)) as any, config.handler, {\n returns: config.returns\n })\n attachFunctionMeta(result as object, config.args, config.returns)\n return result\n}\n\nfunction createDirectBuilderFactory(\n register: (builder: any, input: any, handler: any, options: any) => any\n) {\n return function directBuilderFactory<Builder extends (fn: any) => any>(builder: Builder) {\n return <\n A extends $ZodType | Record<string, $ZodType>,\n R extends $ZodType | undefined = undefined\n >(\n config: BuilderConfig<Builder, A, R>\n ): any => registerBuilderFunction(register as any, builder, config) as any\n }\n}\n\nfunction createCustomBuilderFactory() {\n return function customBuilderFactory<\n Builder extends (fn: any) => any,\n CustomArgsValidator extends PropertyValidators,\n CustomCtx extends Record<string, any>,\n CustomMadeArgs extends Record<string, any>,\n Visibility extends FunctionVisibility = ExtractVisibility<Builder>,\n ExtraArgs extends Record<string, any> = Record<string, any>\n >(\n builder: Builder,\n customization: Customization<any, CustomArgsValidator, CustomCtx, CustomMadeArgs, ExtraArgs>\n ): CustomBuilder<\n 'query' | 'mutation' | 'action',\n CustomArgsValidator,\n CustomCtx,\n CustomMadeArgs,\n ExtractCtx<Builder>,\n Visibility,\n ExtraArgs\n > {\n return customFnBuilder<any, Builder, CustomArgsValidator, CustomCtx, CustomMadeArgs, ExtraArgs>(\n builder as any,\n customization as any\n ) as any\n }\n}\n\n/**\n * Creates a reusable query builder from a Convex query builder.\n * Returns a builder function that accepts Convex-style config objects with args, handler, and returns.\n *\n * @deprecated Use `initZodvex()` which returns `{ zq }` with built-in codec DB wrapping.\n *\n * @example\n * ```ts\n * import { query } from './_generated/server'\n * import { zQueryBuilder } from 'zodvex/server'\n *\n * // Create a reusable builder\n * export const zq = zQueryBuilder(query)\n *\n * // Use it with Convex-style object syntax\n * export const getUser = zq({\n * args: { id: z.string() },\n * handler: async (ctx, { id }) => {\n * return ctx.db.get(id)\n * }\n * })\n * ```\n */\nexport function zQueryBuilder<Builder extends (fn: any) => any>(builder: Builder) {\n return createDirectBuilderFactory(zQuery)(builder) as any\n}\n\n/**\n * Creates a reusable mutation builder from a Convex mutation builder.\n * Returns a builder function that accepts Convex-style config objects with args, handler, and returns.\n *\n * @deprecated Use `initZodvex()` which returns `{ zm }` with built-in codec DB wrapping.\n *\n * @example\n * ```ts\n * import { mutation } from './_generated/server'\n * import { zMutationBuilder } from 'zodvex/server'\n *\n * // Create a reusable builder\n * export const zm = zMutationBuilder(mutation)\n *\n * // Use it with Convex-style object syntax\n * export const updateUser = zm({\n * args: { id: z.string(), name: z.string() },\n * handler: async (ctx, { id, name }) => {\n * return ctx.db.patch(id, { name })\n * }\n * })\n * ```\n */\nexport function zMutationBuilder<Builder extends (fn: any) => any>(builder: Builder) {\n return createDirectBuilderFactory(zMutation)(builder) as any\n}\n\n/**\n * Creates a reusable action builder from a Convex action builder.\n * Returns a builder function that accepts Convex-style config objects with args, handler, and returns.\n *\n * @deprecated Use `initZodvex()` which returns `{ za }` with built-in codec DB wrapping.\n *\n * @example\n * ```ts\n * import { action } from './_generated/server'\n * import { zActionBuilder } from 'zodvex/server'\n *\n * // Create a reusable builder\n * export const za = zActionBuilder(action)\n *\n * // Use it with Convex-style object syntax\n * export const sendEmail = za({\n * args: { to: z.string().email(), subject: z.string() },\n * handler: async (ctx, { to, subject }) => {\n * // Send email\n * }\n * })\n * ```\n */\nexport function zActionBuilder<Builder extends (fn: any) => any>(builder: Builder) {\n return createDirectBuilderFactory(zAction)(builder) as any\n}\n\n/**\n * Creates a custom query builder with context injection from a Convex query builder.\n * Allows you to add custom context (like auth, permissions, etc.) to your queries.\n *\n * @deprecated Use `initZodvex()` and `zq.withContext()` instead.\n *\n * @example\n * ```ts\n * import { type QueryCtx, query } from './_generated/server'\n * import { zCustomQueryBuilder, customCtx } from 'zodvex/server'\n *\n * // Create a builder with auth context\n * export const authQuery = zCustomQueryBuilder(\n * query,\n * customCtx(async (ctx: QueryCtx) => {\n * const user = await getUserOrThrow(ctx)\n * return { user }\n * })\n * )\n *\n * // Use it with automatic user injection\n * export const getMyProfile = authQuery({\n * args: {},\n * handler: async (ctx) => {\n * // ctx.user is automatically available\n * return ctx.db.get(ctx.user._id)\n * }\n * })\n * ```\n */\nexport function zCustomQueryBuilder<\n Builder extends (fn: any) => any,\n CustomArgsValidator extends PropertyValidators,\n CustomCtx extends Record<string, any>,\n CustomMadeArgs extends Record<string, any>,\n Visibility extends FunctionVisibility = ExtractVisibility<Builder>,\n ExtraArgs extends Record<string, any> = Record<string, any>\n>(\n query: Builder,\n customization: Customization<any, CustomArgsValidator, CustomCtx, CustomMadeArgs, ExtraArgs>\n): CustomBuilder<\n 'query',\n CustomArgsValidator,\n CustomCtx,\n CustomMadeArgs,\n ExtractCtx<Builder>,\n Visibility,\n ExtraArgs\n> {\n return createCustomBuilderFactory()(query, customization) as any\n}\n\n/**\n * Creates a custom mutation builder with context injection from a Convex mutation builder.\n * Allows you to add custom context (like auth, permissions, etc.) to your mutations.\n *\n * @deprecated Use `initZodvex()` and `zm.withContext()` instead.\n *\n * @example\n * ```ts\n * import { type MutationCtx, mutation } from './_generated/server'\n * import { zCustomMutationBuilder, customCtx } from 'zodvex/server'\n *\n * // Create a builder with auth context\n * export const authMutation = zCustomMutationBuilder(\n * mutation,\n * customCtx(async (ctx: MutationCtx) => {\n * const user = await getUserOrThrow(ctx)\n * return { user }\n * })\n * )\n *\n * // Use it with automatic user injection\n * export const updateProfile = authMutation({\n * args: { name: z.string() },\n * handler: async (ctx, { name }) => {\n * // ctx.user is automatically available\n * await ctx.db.patch(ctx.user._id, { name })\n * }\n * })\n * ```\n */\nexport function zCustomMutationBuilder<\n Builder extends (fn: any) => any,\n CustomArgsValidator extends PropertyValidators,\n CustomCtx extends Record<string, any>,\n CustomMadeArgs extends Record<string, any>,\n Visibility extends FunctionVisibility = ExtractVisibility<Builder>,\n ExtraArgs extends Record<string, any> = Record<string, any>\n>(\n mutation: Builder,\n customization: Customization<any, CustomArgsValidator, CustomCtx, CustomMadeArgs, ExtraArgs>\n): CustomBuilder<\n 'mutation',\n CustomArgsValidator,\n CustomCtx,\n CustomMadeArgs,\n ExtractCtx<Builder>,\n Visibility,\n ExtraArgs\n> {\n return createCustomBuilderFactory()(mutation, customization) as any\n}\n\n/**\n * Creates a custom action builder with context injection from a Convex action builder.\n * Allows you to add custom context (like auth, permissions, etc.) to your actions.\n *\n * @deprecated Use `initZodvex()` and `za.withContext()` instead.\n *\n * @example\n * ```ts\n * import { type ActionCtx, action } from './_generated/server'\n * import { zCustomActionBuilder, customCtx } from 'zodvex/server'\n *\n * // Create a builder with auth context\n * export const authAction = zCustomActionBuilder(\n * action,\n * customCtx(async (ctx: ActionCtx) => {\n * const identity = await ctx.auth.getUserIdentity()\n * if (!identity) throw new Error('Unauthorized')\n * return { userId: identity.subject }\n * })\n * )\n *\n * // Use it with automatic auth injection\n * export const sendEmail = authAction({\n * args: { to: z.string().email() },\n * handler: async (ctx, { to }) => {\n * // ctx.userId is automatically available\n * await sendEmailService(to, ctx.userId)\n * }\n * })\n * ```\n */\nexport function zCustomActionBuilder<\n Builder extends (fn: any) => any,\n CustomArgsValidator extends PropertyValidators,\n CustomCtx extends Record<string, any>,\n CustomMadeArgs extends Record<string, any>,\n Visibility extends FunctionVisibility = ExtractVisibility<Builder>,\n ExtraArgs extends Record<string, any> = Record<string, any>\n>(\n action: Builder,\n customization: Customization<any, CustomArgsValidator, CustomCtx, CustomMadeArgs, ExtraArgs>\n): CustomBuilder<\n 'action',\n CustomArgsValidator,\n CustomCtx,\n CustomMadeArgs,\n ExtractCtx<Builder>,\n Visibility,\n ExtraArgs\n> {\n return createCustomBuilderFactory()(action, customization) as any\n}\n","import { z } from 'zod'\nimport { zodToConvex } from './mapping'\nimport { assertNoNativeZodDate } from './schema/dateGuards'\nimport { stripUndefined } from './stripUndefined'\nimport { type ZodvexCodec } from './types'\nimport {\n $ZodObject,\n $ZodOptional,\n $ZodType,\n encode,\n parse,\n type infer as zinfer,\n type input as zinput,\n type output as zoutput\n} from './zod-core'\n\n// Re-export ZodvexCodec type for convenience\nexport { type ZodvexCodec } from './types'\n\n/** @deprecated Use `initZodvex` or `decodeDoc`/`encodeDoc` instead. Will be removed in a future release. */\nexport type ConvexCodec<T> = {\n validator: any\n encode: (value: T) => any\n decode: (value: any) => T\n pick: <K extends keyof T>(keys: K[]) => ConvexCodec<Pick<T, K>>\n}\n\n/** @deprecated Use `initZodvex` or `decodeDoc`/`encodeDoc` instead. Will be removed in a future release. */\nexport function convexCodec<T>(schema: $ZodType<T>): ConvexCodec<T> {\n // Fail fast if z.date() is used - it won't encode correctly\n // Use zx.date() instead for Date ↔ timestamp conversion\n assertNoNativeZodDate(schema as $ZodType, 'schema')\n\n const validator = zodToConvex(schema)\n\n return {\n validator,\n // Strip undefined to ensure Convex-safe output (Convex rejects explicit undefined)\n encode: (value: T) => stripUndefined(encode(schema, value)),\n decode: (value: any) => parse(schema, value),\n pick: <K extends keyof T>(keys: K[] | Record<K, true>) => {\n if (!(schema instanceof $ZodObject)) {\n throw new Error('pick() can only be called on object schemas')\n }\n // Handle both array and object formats\n // Use manual shape extraction instead of .pick() — not available on zod/mini\n const pickKeys = Array.isArray(keys) ? keys : (Object.keys(keys) as K[])\n const shape = (schema as any)._zod.def.shape\n const pickedShape: Record<string, any> = {}\n for (const k of pickKeys) {\n if (k in shape) pickedShape[k as string] = shape[k as string]\n }\n const pickedSchema = z.object(pickedShape)\n return convexCodec(pickedSchema) as ConvexCodec<Pick<T, K>>\n }\n }\n}\n\n/**\n * Decodes a wire-format document (from Convex DB) to runtime types.\n * Runs Zod codec decode transforms (e.g., timestamp → Date via zx.date()).\n */\nexport function decodeDoc<S extends $ZodType>(schema: S, wireDoc: unknown): zoutput<S> {\n return parse(schema, wireDoc)\n}\n\n/**\n * Encodes a runtime document to wire format (for Convex DB writes).\n * Runs Zod codec encode transforms and strips undefined values.\n */\nexport function encodeDoc<S extends $ZodType>(schema: S, runtimeDoc: zoutput<S>): zinput<S> {\n return stripUndefined(encode(schema, runtimeDoc))\n}\n\n/**\n * Encodes a partial runtime document to wire format (for Convex DB patch operations).\n * Only encodes the fields present in the partial. Uses schema.partial() + z.encode().\n */\nexport function encodePartialDoc<S extends $ZodType>(\n schema: S,\n partial: Partial<zoutput<S>>\n): Partial<zinput<S>> {\n if (!(schema instanceof $ZodObject)) {\n // For non-object schemas (unions, etc.), fall back to full encode\n // Cast needed: Partial<output<S>> is structurally compatible but not assignable to output<S>\n return stripUndefined(encode(schema, partial as zoutput<S>)) as Partial<zinput<S>>\n }\n // Use manual shape wrapping instead of .partial() — not available on zod/mini\n const shape = (schema as any)._zod.def.shape\n const partialShape: Record<string, any> = {}\n for (const [key, value] of Object.entries(shape)) {\n partialShape[key] =\n value instanceof $ZodOptional\n ? value\n : new $ZodOptional({ type: 'optional', innerType: value as any })\n }\n const partialSchema = z.object(partialShape)\n return stripUndefined(encode(partialSchema, partial)) as Partial<zinput<S>>\n}\n\n/**\n * Creates a branded ZodCodec for use with zodvex type inference.\n * Thin wrapper around z.codec() that adds type branding, allowing\n * ConvexValidatorFromZod to extract the wire schema even when the\n * codec is wrapped in a custom type alias.\n *\n * @example\n * ```typescript\n * type MyCodec = ZodvexCodec<z.ZodObject<{ ts: z.ZodNumber }>, z.ZodCustom<Date>> // zod-ok\n *\n * function myCodec(): MyCodec {\n * return zodvexCodec(\n * z.object({ ts: z.number() }),\n * z.custom<Date>(() => true),\n * {\n * decode: (wire) => new Date(wire.ts),\n * encode: (date) => ({ ts: date.getTime() })\n * }\n * )\n * }\n * ```\n */\nexport function zodvexCodec<\n W extends $ZodType,\n R extends $ZodType,\n WO = zoutput<W>,\n RI = zoutput<R>\n>(\n wire: W,\n runtime: R,\n transforms: {\n decode: (wire: WO) => RI\n encode: (runtime: RI) => WO\n }\n): ZodvexCodec<W, R> {\n // Cast transforms to satisfy Zod's internal MaybeAsync typing while keeping our API simple\n return z.codec(wire as any, runtime as any, transforms as any) as unknown as ZodvexCodec<W, R>\n}\n","/**\n * zx - zodvex extended validators\n *\n * A namespace for zodvex-specific validators and codecs that handle\n * Convex wire format transformations. The \"zx\" prefix signals:\n * - \"zodvex\" or \"zod + convex\" extended types\n * - Explicit transformations (not magic)\n * - Discoverable via IDE autocomplete on `zx.`\n *\n * @example\n * ```typescript\n * import { z } from 'zod'\n * import { zx } from 'zodvex'\n *\n * const userShape = {\n * name: z.string(), // Standard Zod\n * createdAt: zx.date(), // zodvex: Date ↔ timestamp\n * teamId: zx.id('teams'), // zodvex: Convex ID\n * }\n * ```\n */\n\nimport type { GenericId } from 'convex/values'\nimport { z } from 'zod'\nimport { zodvexCodec } from './codec'\nimport { registryHelpers } from './ids'\nimport { attachCodecBrand } from './meta'\nimport { createSchemaUpdateSchema } from './modelSchemaBundle'\nimport { addSystemFields } from './schemaHelpers'\nimport type { ZodvexCodec } from './types'\nimport {\n type $ZodCustom,\n $ZodNullable,\n type $ZodNumber,\n $ZodOptional,\n type $ZodType,\n $ZodType as $ZodTypeValue,\n type output as zoutput\n} from './zod-core'\n\n/**\n * Date codec type for explicit type annotations\n */\nexport type FullZodvexCodec<W extends $ZodType, R extends $ZodType> = z.ZodCodec<W, R> &\n ZodvexCodec<W, R>\n\nexport type ZxDate = FullZodvexCodec<$ZodNumber, $ZodCustom<Date, Date>>\n\n/**\n * Creates a Date codec that transforms between Date objects and timestamps.\n *\n * Wire format: number (Unix timestamp in milliseconds)\n * Runtime format: Date object\n *\n * @example\n * ```typescript\n * const schema = z.object({\n * createdAt: zx.date(),\n * updatedAt: zx.date().optional(),\n * })\n * ```\n */\nfunction date(): ZxDate {\n return zodvexCodec(\n z.number(), // Wire: timestamp\n z.custom<Date>(val => val instanceof Date, {\n message: 'Expected Date instance'\n }),\n {\n decode: (timestamp: number) => new Date(timestamp),\n encode: (date: Date) => date.getTime()\n }\n ) as unknown as ZxDate\n}\n\n/**\n * ID type for explicit type annotations\n */\nexport type ZxId<TableName extends string> = z.ZodString &\n z.ZodType<GenericId<TableName>> & {\n _tableName: TableName\n }\n\n/**\n * Creates a Convex ID validator for a specific table.\n *\n * Wire format: string (Convex ID)\n * Runtime format: GenericId<TableName> (branded string type)\n *\n * Note: Unlike zx.date(), IDs don't require runtime transformation since\n * GenericId<T> is a branded string type. The branding is purely type-level.\n *\n * @param tableName - The Convex table name for this ID\n *\n * @example\n * ```typescript\n * const schema = z.object({\n * userId: zx.id('users'),\n * teamId: zx.id('teams').optional(),\n * })\n * ```\n */\nfunction id<TableName extends string>(tableName: TableName): ZxId<TableName> {\n // Create base string validator with refinement\n const baseSchema = z.string().check(\n z.refine(val => typeof val === 'string' && val.length > 0, {\n message: `Invalid ID for table \"${tableName}\"`\n }),\n z.describe(`convexId:${tableName}`)\n )\n\n // Store metadata for registry lookup so mapping can convert to v.id(tableName)\n registryHelpers.setMetadata(baseSchema, {\n isConvexId: true,\n tableName\n })\n\n // Add the tableName property for type-level detection\n const branded = baseSchema as any\n branded._tableName = tableName\n\n return branded as ZxId<TableName>\n}\n\n/**\n * Creates a custom codec for transforming between wire and runtime formats.\n *\n * Use this when you need custom transformations beyond the built-in helpers.\n *\n * @param wire - Zod schema for the wire format (stored in Convex)\n * @param runtime - Zod schema for the runtime format (used in code)\n * @param transforms - Encode/decode functions\n * @param opts.brand - Optional provenance brand. When set, codegen matches a\n * function-embedded instance of this codec to its importable twin (an\n * exported const or model field with the same brand) by *declared* identity\n * rather than inferring it from structure — collision-free and namespaced\n * across factories. Useful for codec factories like `tagged()` / `sensitive()`\n * whose every call returns a fresh instance. See\n * `docs/decisions/2026-06-08-codec-provenance-brands.md`.\n *\n * @example\n * ```typescript\n * // Encrypted data codec\n * const encryptedString = zx.codec(\n * z.object({ encrypted: z.string() }), // Wire format\n * z.custom<string>(() => true), // Runtime format\n * {\n * decode: (wire) => decrypt(wire.encrypted),\n * encode: (value) => ({ encrypted: encrypt(value) })\n * }\n * )\n *\n * // Branded factory codec — codegen matches inline instances by brand\n * function tagged(inner, name) {\n * return zx.codec(wire(inner), runtime(inner), transforms, { brand: `tagged:${name}` })\n * }\n * ```\n */\nfunction codec<W extends $ZodType, R extends $ZodType, WO = zoutput<W>, RI = zoutput<R>>(\n wire: W,\n runtime: R,\n transforms: {\n decode: (wire: WO) => RI\n encode: (runtime: RI) => WO\n },\n opts?: { brand?: string }\n): FullZodvexCodec<W, R> {\n const built = zodvexCodec(wire, runtime, transforms) as unknown as FullZodvexCodec<W, R>\n if (opts?.brand) attachCodecBrand(built as object, opts.brand)\n return built\n}\n\n/**\n * Minimal model shape accepted by zx helpers.\n * Both full and slim models satisfy this at runtime.\n */\ntype ZxModelInput = {\n readonly name: string\n readonly fields: Record<string, $ZodType>\n readonly schema?: unknown\n}\n\n/**\n * Per-model caches so repeated `zx.doc(model)` / `zx.base(model)` / etc. calls\n * across call sites share a single Zod schema instance.\n *\n * Caches are keyed on a stable identity that survives chain methods\n * (`.index()`, `.searchIndex()`, `.vectorIndex()`), which return new model\n * objects but preserve `fields` (object slim) and `schema` (union slim) by\n * reference. Keying on the model object would force every chain step to\n * re-allocate.\n *\n * Full models bypass these caches entirely — they carry a pre-built schema\n * bundle, and `zx.*(fullModel)` returns the bundle's schema directly so\n * identity matches `fullModel.schema.{doc,base,...}`.\n *\n * The cache maps are pinned to `globalThis` under a `Symbol.for` registry so\n * multiple bundled copies of this module share state. tsup splits each entry\n * into its own bundle (CLI, codegen, main, server, …), duplicating this file\n * per entry. Without the shared registry, `zx.doc(Model)` in user code\n * (loaded from `dist/index.js`) and `zx.doc(ref)` in codegen (loaded from\n * `dist/cli/index.js`) would write to distinct WeakMaps, producing different\n * instances for the same model — identity matching would silently fail.\n */\nfunction sharedWeakMap(name: string): WeakMap<object, $ZodType> {\n const key = Symbol.for(`zodvex.zx.cache.${name}`)\n const g = globalThis as unknown as Record<symbol, WeakMap<object, $ZodType>>\n const existing = g[key]\n if (existing) return existing\n const created = new WeakMap<object, $ZodType>()\n g[key] = created\n return created\n}\n\nconst baseCache = sharedWeakMap('base')\nconst docCache = sharedWeakMap('doc')\nconst updateCache = sharedWeakMap('update')\nconst docArrayCache = sharedWeakMap('docArray')\n\n/**\n * Stable cache key for slim models:\n * - union slim → the user-supplied schema (preserved across chains)\n * - object slim → the fields record (preserved across chains)\n */\nfunction slimCacheKey(model: ZxModelInput): object {\n const s = model.schema as any\n return s instanceof $ZodTypeValue ? s : model.fields\n}\n\n/**\n * Returns the base schema for a model — the user fields as a Zod object (or the\n * user-supplied union for discriminated-union models).\n *\n * Full models: returns the bundle's pre-built `.base` (no allocation).\n * Union slim: returns the user's schema (no allocation — it IS the base).\n * Object slim: builds `z.object(fields)` once, cached on `fields`.\n */\nfunction base(model: ZxModelInput): $ZodType {\n const s = model.schema as any\n if (s?.base instanceof $ZodTypeValue) return s.base\n if (s instanceof $ZodTypeValue) return s\n const cached = baseCache.get(model.fields)\n if (cached) return cached\n if (Object.keys(model.fields).length === 0) {\n throw new Error(`[zodvex] Cannot derive base schema for model '${model.name}'`)\n }\n const built = z.object(model.fields) as any\n baseCache.set(model.fields, built)\n return built\n}\n\n/**\n * Constructs a doc schema: base fields + _id + _creationTime.\n * Full models reuse `model.schema.doc`; slim models cache on slimCacheKey(model).\n */\nfunction doc(model: ZxModelInput) {\n const s = model.schema as any\n if (s?.doc instanceof $ZodTypeValue) return s.doc\n const key = slimCacheKey(model)\n const cached = docCache.get(key)\n if (cached) return cached\n const built = addSystemFields(model.name, base(model)) as any\n docCache.set(key, built)\n return built\n}\n\n/**\n * Constructs an update schema: _id required + _creationTime optional + all user fields optional.\n * Full models reuse `model.schema.update`; slim models cache on slimCacheKey(model).\n */\nfunction update(model: ZxModelInput) {\n const s = model.schema as any\n if (s?.update instanceof $ZodTypeValue) return s.update\n const key = slimCacheKey(model)\n const cached = updateCache.get(key)\n if (cached) return cached\n const built = createSchemaUpdateSchema(model.name, base(model)) as any\n updateCache.set(key, built)\n return built\n}\n\n/**\n * Constructs a doc array schema: z.array(doc(model)).\n * Full models reuse `model.schema.docArray`; slim models cache on slimCacheKey(model).\n */\nfunction docArray(model: ZxModelInput) {\n const s = model.schema as any\n if (s?.docArray instanceof $ZodTypeValue) return s.docArray\n const key = slimCacheKey(model)\n const cached = docArrayCache.get(key)\n if (cached) return cached\n const built = z.array(doc(model)) as any\n docArrayCache.set(key, built)\n return built\n}\n\n/** Wrap in .nullable() using core constructor for zod-mini compat. */\nfunction nullable(schema: $ZodType): $ZodType {\n return new $ZodNullable({ type: 'nullable', innerType: schema }) as any\n}\n\n/** Wrap in .optional() using core constructor for zod-mini compat. */\nfunction optional(schema: $ZodType): $ZodType {\n return new $ZodOptional({ type: 'optional', innerType: schema }) as any\n}\n\n/** Wrap in .nullable().optional() using core constructors for zod-mini compat. */\nfunction nullableOptional(schema: $ZodType): $ZodType {\n return optional(nullable(schema))\n}\n\n/**\n * Pagination options schema — matches Convex's PaginationOptions type.\n */\nfunction paginationOpts() {\n return z.object({\n numItems: z.number(),\n cursor: nullable(z.string()),\n endCursor: nullableOptional(z.string()),\n id: optional(z.number()),\n maximumRowsRead: optional(z.number()),\n maximumBytesRead: optional(z.number())\n })\n}\n\n/**\n * Paginated result schema — wraps any item schema in Convex's PaginationResult shape.\n */\nfunction paginationResult<T extends $ZodType>(itemSchema: T) {\n return z.object({\n page: z.array(itemSchema),\n isDone: z.boolean(),\n continueCursor: z.string(),\n splitCursor: nullableOptional(z.string()),\n pageStatus: nullableOptional(z.enum(['SplitRecommended', 'SplitRequired']))\n })\n}\n\n/**\n * zx namespace - zodvex extended validators\n *\n * Provides explicit, discoverable helpers for Convex-specific transformations.\n */\nexport const zx = {\n /**\n * Date ↔ timestamp codec\n * @see {@link date}\n */\n date,\n\n /**\n * Convex ID validator\n * @see {@link id}\n */\n id,\n\n /**\n * Custom codec builder\n * @see {@link codec}\n */\n codec,\n\n /**\n * Pagination options schema matching Convex's PaginationOptions type\n * @see {@link paginationOpts}\n */\n paginationOpts,\n\n /**\n * Paginated result schema wrapping any item schema in Convex's PaginationResult shape\n * @see {@link paginationResult}\n */\n paginationResult,\n\n /**\n * Base schema for a model (user fields only; no system fields).\n * For object models reconstructs from fields; for union models returns the\n * user-supplied union. Cached per-model.\n * @see {@link base}\n */\n base,\n\n /**\n * Doc schema: model fields + _id + _creationTime\n * @see {@link doc}\n */\n doc,\n\n /**\n * Update schema: _id required, all other fields optional\n * @see {@link update}\n */\n update,\n\n /**\n * Doc array schema: z.array(doc(model))\n * @see {@link docArray}\n */\n docArray\n} as const\n","/**\n * Schema helpers — Pure Zod utilities for union handling and system fields.\n *\n * This module contains helpers extracted from tables.ts that have NO server\n * dependencies (no convex/server, no convex-helpers/server). They are safe\n * to import from zodvex (client-side code).\n *\n * Used by:\n * - model.ts (defineZodModel) — client-safe model definitions\n * - tables.ts (zodTable) — server-side table definitions\n */\n\nimport { z } from 'zod'\nimport {\n $ZodArray,\n $ZodDiscriminatedUnion,\n $ZodNumber,\n $ZodObject,\n type $ZodShape,\n $ZodType,\n $ZodUnion,\n clone\n} from './zod-core'\nimport { type ZxId, zx } from './zx'\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Helper type for Convex system fields added to documents\n */\nexport type SystemFields<TableName extends string> = {\n _id: ZxId<TableName>\n _creationTime: $ZodNumber\n}\n\n/**\n * Maps over union options, extending each ZodObject variant with system fields.\n * Non-object variants are preserved as-is.\n */\nexport type MapSystemFields<TableName extends string, Options extends readonly $ZodType[]> = {\n [K in keyof Options]: Options[K] extends z.ZodObject<infer Shape extends $ZodShape> // zod-ok\n ? z.ZodObject<Shape & SystemFields<TableName>> // zod-ok\n : Options[K]\n}\n\n/**\n * Core-compatible version of MapSystemFields.\n * Uses $ZodObject from zod/v4/core instead of z.ZodObject from full zod. // zod-ok\n */\nexport type MapSystemFieldsCore<TableName extends string, Options extends readonly $ZodType[]> = {\n [K in keyof Options]: Options[K] extends $ZodObject<infer Shape extends $ZodShape>\n ? $ZodObject<Shape & SystemFields<TableName>>\n : Options[K]\n}\n\n/**\n * Computes the result of adding system fields to a union/object schema.\n * Uses only $Zod* types from zod/v4/core — safe for shared code and mini consumers.\n *\n * Handles:\n * - $ZodObject → $ZodObject with system fields\n * - $ZodUnion → $ZodUnion with system fields on each variant\n * - $ZodDiscriminatedUnion → $ZodDiscriminatedUnion with system fields on each variant\n * - Other → returned as-is\n */\nexport type AddSystemFieldsToUnion<TableName extends string, Schema extends $ZodType> =\n Schema extends $ZodObject<infer Shape extends $ZodShape>\n ? $ZodObject<Shape & SystemFields<TableName>>\n : Schema extends $ZodUnion<infer Options extends readonly $ZodType[]>\n ? $ZodUnion<MapSystemFieldsCore<TableName, Options>>\n : Schema extends $ZodDiscriminatedUnion<\n infer Options extends readonly $ZodType[],\n infer Disc extends string\n >\n ? $ZodDiscriminatedUnion<MapSystemFieldsCore<TableName, Options>, Disc>\n : Schema\n\n/**\n * Minimum tuple type required by z.union() - at least 2 elements.\n */\ntype UnionTuple<T extends $ZodType = $ZodType> = readonly [T, T, ...T[]]\n\n// ============================================================================\n// Union Helpers - Type-safe utilities for working with Zod unions\n// ============================================================================\n\n/** Full-zod union type alias used by isZodUnion/getUnionOptions — zod-ok by design. */\ntype AnyZodUnion =\n // zod-ok\n | z.ZodUnion<readonly $ZodType[]> // zod-ok\n | z.ZodDiscriminatedUnion<readonly z.ZodObject<$ZodShape>[], string> // zod-ok\n\n/**\n * Type guard to check if a schema is a union type (ZodUnion or ZodDiscriminatedUnion).\n */\nexport function isZodUnion(schema: $ZodType): schema is AnyZodUnion {\n return schema instanceof $ZodUnion || schema instanceof $ZodDiscriminatedUnion\n}\n\n/**\n * Extracts the options array from a ZodUnion or ZodDiscriminatedUnion.\n * Both union types have an `.options` property, but TypeScript doesn't\n * create a common accessor after instanceof checks.\n *\n * @param schema - A ZodUnion or ZodDiscriminatedUnion schema\n * @returns The array of union variant schemas\n */\nexport function getUnionOptions(schema: AnyZodUnion): readonly $ZodType[] {\n // $ZodDiscriminatedUnion extends $ZodUnion, so this covers both\n if (schema instanceof $ZodUnion) {\n return schema._zod.def.options\n }\n // cast: unreachable due to the union type constraint, but satisfies return type\n return (schema as any)._zod.def.options\n}\n\n/**\n * Asserts that an array has at least 2 elements, as required by z.union().\n * Throws an error if the array has fewer than 2 elements.\n *\n * @param options - Array of Zod schemas\n * @throws Error if array has fewer than 2 elements\n */\nexport function assertUnionOptions<T extends $ZodType>(\n options: readonly T[]\n): asserts options is UnionTuple<T> {\n if (options.length < 2) {\n throw new Error(\n `z.union() requires at least 2 options, but received ${options.length}. ` +\n 'This indicates an invalid union schema was passed to zodTable().'\n )\n }\n}\n\n/**\n * Creates a z.union() from an array of options with runtime validation.\n * Ensures the array has at least 2 elements as required by Zod.\n *\n * @param options - Array of Zod schemas (must have at least 2 elements)\n * @returns A ZodUnion schema\n * @throws Error if array has fewer than 2 elements\n */\n// Return type alias — prevents z.ZodUnion on a {-ending line (formatter-safe). // zod-ok\ntype ZodUnionOf<T extends $ZodType> = z.ZodUnion<UnionTuple<T>> // zod-ok\n\nexport function createUnionFromOptions<T extends $ZodType>(options: readonly T[]): ZodUnionOf<T> {\n assertUnionOptions(options)\n return z.union(options)\n}\n\n/**\n * Adds Convex system fields (_id, _creationTime) to a Zod schema.\n *\n * For object schemas: extends with system fields\n * For union schemas: adds system fields to each variant\n *\n * @param tableName - The Convex table name\n * @param schema - The Zod schema (object or union)\n * @returns Schema with system fields added\n */\n// Overload 1: ZodObject - extends with system fields\nexport function addSystemFields<TableName extends string, Shape extends $ZodShape>(\n tableName: TableName,\n schema: z.ZodObject<Shape> // zod-ok\n): z.ZodObject<Shape & SystemFields<TableName>> // zod-ok\n\n// Overload 2: ZodUnion - maps system fields to each variant\nexport function addSystemFields<TableName extends string, Options extends readonly $ZodType[]>(\n tableName: TableName,\n schema: z.ZodUnion<Options> // zod-ok\n): z.ZodUnion<MapSystemFields<TableName, Options>> // zod-ok\n\n// Overload 3: ZodDiscriminatedUnion - maps system fields preserving discriminator\n// Note: Zod v4 signature is ZodDiscriminatedUnion<Options, Discriminator>\nexport function addSystemFields<\n TableName extends string,\n Options extends readonly z.ZodObject<$ZodShape>[], // zod-ok\n Discriminator extends string\n>(\n tableName: TableName,\n schema: z.ZodDiscriminatedUnion<Options, Discriminator> // zod-ok\n): z.ZodDiscriminatedUnion<MapSystemFields<TableName, Options>, Discriminator> // zod-ok\n\n// Overload 4: Fallback for other ZodTypes - returns as-is\nexport function addSystemFields<TableName extends string, S extends $ZodType>(\n tableName: TableName,\n schema: S\n): S\n\n// Implementation\nexport function addSystemFields<TableName extends string>(\n tableName: TableName,\n schema: $ZodType\n): $ZodType {\n // Handle union schemas - add system fields to each variant\n if (isZodUnion(schema)) {\n const originalOptions = getUnionOptions(schema)\n const extendedOptions = originalOptions.map((variant: $ZodType) => {\n if (variant instanceof $ZodObject) {\n const newShape = {\n ...variant._zod.def.shape,\n _id: zx.id(tableName),\n _creationTime: z.number()\n }\n // Clone preserves the original's class + reinitializes with merged def\n return clone(variant, { ...variant._zod.def, shape: newShape })\n }\n // Non-object variants are returned as-is (shouldn't happen in practice)\n return variant\n })\n return createUnionFromOptions(extendedOptions)\n }\n\n // Handle object schemas — clone preserves class, checks, catchall, error\n if (schema instanceof $ZodObject) {\n const newShape = { ...schema._zod.def.shape, _id: zx.id(tableName), _creationTime: z.number() }\n return clone(schema, { ...schema._zod.def, shape: newShape })\n }\n\n // Fallback: return schema as-is\n return schema\n}\n","import { z } from 'zod'\nimport {\n addSystemFields,\n createUnionFromOptions,\n getUnionOptions,\n isZodUnion\n} from './schemaHelpers'\nimport { $ZodNullable, $ZodObject, $ZodOptional, type $ZodShape, $ZodType } from './zod-core'\nimport { zx } from './zx'\n\n// Return type alias so helper signatures don't expose full zod internals everywhere.\ntype AnyOptional = z.ZodOptional<any> // zod-ok\n\nexport type RuntimeModelSchemaBundle = {\n readonly doc: $ZodType\n readonly base: $ZodType\n readonly insert: $ZodType\n readonly update: $ZodType\n readonly docArray: $ZodType\n readonly paginatedDoc: $ZodType\n}\n\n/** Wrap in .optional() only if not already optional. Uses core constructor for zod-mini compat. */\nfunction ensureOptional(schema: $ZodType): AnyOptional {\n if (schema instanceof $ZodOptional) return schema as z.ZodOptional<any> // zod-ok\n return new $ZodOptional({ type: 'optional', innerType: schema }) as z.ZodOptional<any> // zod-ok\n}\n\n/** Wrap in .nullable().optional() using core constructors for zod-mini compat. */\nfunction nullableOptional(schema: $ZodType): $ZodType {\n return new $ZodOptional({\n type: 'optional',\n innerType: new $ZodNullable({ type: 'nullable', innerType: schema })\n }) as any\n}\n\nexport function createPartialShape(shape: Record<string, $ZodType>): Record<string, $ZodType> {\n const partialShape: Record<string, $ZodType> = {}\n for (const [key, value] of Object.entries(shape)) {\n partialShape[key] = ensureOptional(value)\n }\n return partialShape\n}\n\nexport function createUpdateObjectSchema<Name extends string>(\n name: Name,\n shape: Record<string, $ZodType>\n): z.ZodObject<any> {\n return z.object({\n _id: zx.id(name),\n _creationTime: z.optional(z.number()),\n ...createPartialShape(shape)\n })\n}\n\nexport function createPaginatedDocSchema(docSchema: $ZodType): z.ZodObject<any> {\n return z.object({\n page: z.array(docSchema),\n isDone: z.boolean(),\n continueCursor: z.string(),\n splitCursor: nullableOptional(z.string()),\n pageStatus: nullableOptional(z.enum(['SplitRecommended', 'SplitRequired']))\n })\n}\n\nexport function createObjectSchemaBundle<Name extends string>(\n name: Name,\n fields: $ZodShape,\n baseSchema: z.ZodObject<any> = z.object(fields)\n): RuntimeModelSchemaBundle {\n const docSchema = addSystemFields(name, baseSchema)\n\n return {\n doc: docSchema,\n base: baseSchema,\n insert: baseSchema,\n update: createUpdateObjectSchema(name, fields),\n docArray: z.array(docSchema),\n paginatedDoc: createPaginatedDocSchema(docSchema)\n }\n}\n\nexport function createSchemaUpdateSchema<Name extends string>(\n name: Name,\n inputSchema: $ZodType\n): $ZodType {\n if (isZodUnion(inputSchema)) {\n const updateOptions = getUnionOptions(inputSchema).map((variant: $ZodType) => {\n if (variant instanceof $ZodObject) {\n return createUpdateObjectSchema(name, variant._zod.def.shape)\n }\n return variant\n })\n return createUnionFromOptions(updateOptions)\n }\n\n if (inputSchema instanceof $ZodObject) {\n return createUpdateObjectSchema(name, inputSchema._zod.def.shape)\n }\n\n return inputSchema\n}\n\nexport function createSchemaBundle<Name extends string>(\n name: Name,\n inputSchema: $ZodType\n): RuntimeModelSchemaBundle {\n const docSchema = addSystemFields(name, inputSchema)\n\n return {\n doc: docSchema,\n base: inputSchema,\n insert: inputSchema,\n update: createSchemaUpdateSchema(name, inputSchema),\n docArray: z.array(docSchema),\n paginatedDoc: createPaginatedDocSchema(docSchema)\n }\n}\n","import { defineTable } from 'convex/server'\nimport type { GenericId } from 'convex/values'\nimport { Table } from 'convex-helpers/server'\nimport { z } from 'zod'\nimport {\n type ConvexValidatorFromZodFieldsAuto,\n zodToConvex,\n zodToConvexFields\n} from '../internal/mapping'\nimport { createObjectSchemaBundle, createSchemaBundle } from '../internal/modelSchemaBundle'\nimport { addSystemFields, type MapSystemFields, type SystemFields } from '../internal/schemaHelpers'\nimport { $ZodObject, type $ZodShape, $ZodType } from '../internal/zod-core'\nimport { type ZxId, zx } from '../internal/zx'\n\n/**\n * System fields added to Convex documents.\n */\ntype DocSystemFields<TableName extends string> = {\n _id: ZxId<TableName>\n _creationTime: z.ZodNumber\n}\n/**\n * Type for validators that can be used with Convex's defineTable.\n *\n * Convex's defineTable expects Validator<Record<string, any>, \"required\", any>,\n * but zodToConvex returns more specific types that TypeScript can't verify are\n * compatible. This type represents validators that produce object documents.\n *\n * @internal\n */\ntype TableValidator = Parameters<typeof defineTable>[0]\n\n/**\n * Asserts that a Convex validator can be used to define a table.\n *\n * This is needed because zodToConvex returns a specific validator type (like VUnion)\n * that TypeScript can't verify is assignable to defineTable's expected input type,\n * even though all union variants are objects that produce Record<string, any>.\n *\n * The runtime behavior is correct - Convex supports union validators in tables.\n * This is purely a TypeScript limitation with complex mapped types.\n *\n * @internal\n */\nfunction asTableValidator<V extends { kind: string }>(validator: V): TableValidator {\n return validator as unknown as TableValidator\n}\n\n/**\n * Creates a Zod schema for a Convex document with system fields.\n * Spreads the original def to preserve catchall, checks, and error settings.\n *\n * @deprecated Use `defineZodModel` instead. See `docs/migration/v0.6.md`.\n *\n * @param tableName - The Convex table name\n * @param schema - The Zod object schema for user fields\n * @returns A Zod object schema with _id and _creationTime added\n */\nexport function zodDoc<TableName extends string, Shape extends $ZodShape>(\n tableName: TableName,\n schema: z.ZodObject<Shape>\n): z.ZodObject<Shape & DocSystemFields<TableName>> {\n return addSystemFields(tableName, schema) as z.ZodObject<Shape & DocSystemFields<TableName>>\n}\n\n/**\n * @deprecated Use `defineZodModel` instead. See `docs/migration/v0.6.md`.\n */\nexport function zodDocOrNull<\n TableName extends string,\n Shape extends $ZodShape,\n Schema extends z.ZodObject<Shape>\n>(tableName: TableName, schema: Schema) {\n return z.union([zodDoc(tableName, schema), z.null()])\n}\n\n/**\n * Helper to detect if input is an object shape (plain object with Zod validators)\n */\nfunction isObjectShape(input: any): input is Record<string, $ZodType> {\n // Check if it's a plain object (not a Zod instance)\n if (!input || typeof input !== 'object') return false\n\n // If it's a Zod instance, it's not an object shape\n if (input instanceof $ZodType) return false\n\n // Check if all values are Zod types\n for (const key in input) {\n if (!(input[key] instanceof $ZodType)) {\n return false\n }\n }\n\n return true\n}\n\n/**\n * Defines a Convex table using either:\n * - A raw Zod shape (an object mapping field names to Zod types)\n * - A Zod union schema (for polymorphic tables)\n *\n * For object shapes, this function intentionally accepts a raw shape instead of a ZodObject instance.\n * Accepting raw shapes allows TypeScript to infer field types more accurately and efficiently,\n * leading to better type inference and performance throughout the codebase.\n *\n * For union schemas, this enables polymorphic tables with discriminated unions.\n *\n * Returns the Table definition along with Zod schemas for documents and arrays.\n *\n * @deprecated Use `defineZodModel` instead. See `docs/migration/v0.6.md`.\n *\n * @param name - The table name\n * @param schemaOrShape - Either a raw object shape or a Zod union schema\n * @returns A Table with attached helpers (shape, schema, zDoc, docArray, withSystemFields)\n *\n * @example Object shape\n * ```ts\n * const Users = zodTable('users', {\n * name: z.string(),\n * email: z.string().email(),\n * age: z.number().optional()\n * })\n *\n * // Use in schema\n * export default defineSchema({ users: Users.table })\n *\n * // Use for return types\n * export const getUsers = zQuery(query, {},\n * async (ctx) => ctx.db.query('users').collect(),\n * { returns: Users.docArray }\n * )\n * ```\n *\n * @example Union schema (polymorphic table)\n * ```ts\n * const shapeSchema = z.union([\n * z.object({ kind: z.literal('circle'), r: z.number() }),\n * z.object({ kind: z.literal('rectangle'), width: z.number() })\n * ])\n *\n * const Shapes = zodTable('shapes', shapeSchema)\n *\n * // Use in schema\n * export default defineSchema({ shapes: Shapes.table })\n *\n * // Use for return types with system fields\n * export const getShapes = zQuery(query, {},\n * async (ctx) => ctx.db.query('shapes').collect(),\n * { returns: Shapes.docArray }\n * )\n * ```\n */\n// Helper type to compute the result of addSystemFields for use in zodTable return type\ntype AddSystemFieldsResult<TableName extends string, Schema extends $ZodType> =\n Schema extends z.ZodObject<infer Shape extends z.ZodRawShape>\n ? z.ZodObject<Shape & SystemFields<TableName>>\n : Schema extends z.ZodUnion<infer Options extends readonly z.ZodTypeAny[]>\n ? z.ZodUnion<MapSystemFields<TableName, Options>>\n : Schema extends z.ZodDiscriminatedUnion<\n infer Options extends readonly z.ZodObject<z.ZodRawShape>[],\n infer Disc extends string\n >\n ? z.ZodDiscriminatedUnion<MapSystemFields<TableName, Options>, Disc>\n : Schema\n\n/**\n * Update schema shape: _id required, _creationTime optional, user fields partial\n */\ntype UpdateShape<TableName extends string, Shape extends z.ZodRawShape> = {\n _id: ZxId<TableName>\n _creationTime: z.ZodOptional<z.ZodNumber>\n} & {\n [K in keyof Shape]: z.ZodOptional<Shape[K]>\n}\n\n/**\n * Maps over union options for update schema.\n * Each variant gets _id required, _creationTime optional, and user fields partial.\n */\ntype MapUpdateVariants<TableName extends string, Options extends readonly z.ZodTypeAny[]> = {\n [K in keyof Options]: Options[K] extends z.ZodObject<infer Shape extends z.ZodRawShape>\n ? z.ZodObject<UpdateShape<TableName, Shape>>\n : Options[K]\n}\n\n/**\n * Computes the update schema type for a given schema.\n * Includes _id (required), _creationTime (optional), and partial user fields.\n * For unions: each variant gets update shape\n * For objects: the whole object gets update shape\n * For other types: returns as-is\n */\ntype UpdateSchemaType<TableName extends string, Schema extends $ZodType> =\n Schema extends z.ZodUnion<infer Options extends readonly z.ZodTypeAny[]>\n ? z.ZodUnion<MapUpdateVariants<TableName, Options>>\n : Schema extends z.ZodDiscriminatedUnion<\n infer Options extends readonly z.ZodObject<z.ZodRawShape>[],\n infer _Disc extends string\n >\n ? z.ZodUnion<MapUpdateVariants<TableName, Options>>\n : Schema extends z.ZodObject<infer Shape extends z.ZodRawShape>\n ? z.ZodObject<UpdateShape<TableName, Shape>>\n : Schema\n\n// Overload 1: Object shape (most common case - raw object with Zod validators)\nexport function zodTable<TableName extends string, Shape extends Record<string, $ZodType>>(\n name: TableName,\n shape: Shape\n): ReturnType<typeof Table<ConvexValidatorFromZodFieldsAuto<Shape>, TableName>> & {\n shape: Shape\n /** @deprecated Use `schema.doc` instead */\n zDoc: z.ZodObject<\n Shape & {\n _id: ZxId<TableName>\n _creationTime: z.ZodNumber\n }\n >\n /** @deprecated Use `schema.docArray` instead */\n docArray: z.ZodArray<\n z.ZodObject<\n Shape & {\n _id: ZxId<TableName>\n _creationTime: z.ZodNumber\n }\n >\n >\n schema: {\n doc: z.ZodObject<\n Shape & {\n _id: ZxId<TableName>\n _creationTime: z.ZodNumber\n }\n >\n docArray: z.ZodArray<\n z.ZodObject<\n Shape & {\n _id: ZxId<TableName>\n _creationTime: z.ZodNumber\n }\n >\n >\n /** Paginated result schema matching Convex's PaginationResult shape */\n paginatedDoc: z.ZodObject<{\n page: z.ZodArray<z.ZodObject<Shape & { _id: ZxId<TableName>; _creationTime: z.ZodNumber }>>\n isDone: z.ZodBoolean\n continueCursor: z.ZodOptional<z.ZodNullable<z.ZodString>>\n }>\n /** The base schema - user fields without system fields */\n base: z.ZodObject<Shape>\n /** Alias for base - user fields for insert operations */\n insert: z.ZodObject<Shape>\n /** Update schema - _id required, _creationTime optional, user fields partial */\n update: z.ZodObject<UpdateShape<TableName, Shape>>\n }\n}\n\n// Overload 2: ZodObject wrapper (extracts shape for same type inference as raw shape)\nexport function zodTable<TableName extends string, Shape extends $ZodShape>(\n name: TableName,\n schema: z.ZodObject<Shape>\n): ReturnType<typeof Table<ConvexValidatorFromZodFieldsAuto<Shape>, TableName>> & {\n shape: Shape\n /** @deprecated Use `schema.doc` instead */\n zDoc: z.ZodObject<\n Shape & {\n _id: ZxId<TableName>\n _creationTime: z.ZodNumber\n }\n >\n /** @deprecated Use `schema.docArray` instead */\n docArray: z.ZodArray<\n z.ZodObject<\n Shape & {\n _id: ZxId<TableName>\n _creationTime: z.ZodNumber\n }\n >\n >\n schema: {\n doc: z.ZodObject<\n Shape & {\n _id: ZxId<TableName>\n _creationTime: z.ZodNumber\n }\n >\n docArray: z.ZodArray<\n z.ZodObject<\n Shape & {\n _id: ZxId<TableName>\n _creationTime: z.ZodNumber\n }\n >\n >\n /** Paginated result schema matching Convex's PaginationResult shape */\n paginatedDoc: z.ZodObject<{\n page: z.ZodArray<z.ZodObject<Shape & { _id: ZxId<TableName>; _creationTime: z.ZodNumber }>>\n isDone: z.ZodBoolean\n continueCursor: z.ZodOptional<z.ZodNullable<z.ZodString>>\n }>\n /** The base schema - user fields without system fields */\n base: z.ZodObject<Shape>\n /** Alias for base - user fields for insert operations */\n insert: z.ZodObject<Shape>\n /** Update schema - _id required, _creationTime optional, user fields partial */\n update: z.ZodObject<UpdateShape<TableName, Shape>>\n }\n}\n\n// Overload 3: Union/schema types\nexport function zodTable<TableName extends string, Schema extends $ZodType>(\n name: TableName,\n schema: Schema\n): {\n table: ReturnType<typeof defineTable>\n tableName: TableName\n validator: ReturnType<typeof zodToConvex<Schema>>\n schema: {\n doc: AddSystemFieldsResult<TableName, Schema>\n docArray: z.ZodArray<AddSystemFieldsResult<TableName, Schema>>\n /** Paginated result schema matching Convex's PaginationResult shape */\n paginatedDoc: z.ZodObject<{\n page: z.ZodArray<AddSystemFieldsResult<TableName, Schema>>\n isDone: z.ZodBoolean\n continueCursor: z.ZodOptional<z.ZodNullable<z.ZodString>>\n }>\n /** The base schema - user fields without system fields */\n base: Schema\n /** Alias for base - user fields for insert operations */\n insert: Schema\n /** Update schema - _id required, _creationTime optional, user fields partial */\n update: UpdateSchemaType<TableName, Schema>\n }\n /** @deprecated Use `schema.docArray` instead */\n docArray: z.ZodArray<AddSystemFieldsResult<TableName, Schema>>\n withSystemFields: () => AddSystemFieldsResult<TableName, Schema>\n}\n\nexport function zodTable<\n TableName extends string,\n SchemaOrShape extends $ZodType | Record<string, $ZodType>\n>(name: TableName, schemaOrShape: SchemaOrShape): any {\n // Detect if it's an object shape, ZodObject, or other schema\n // For ZodObject: extract its shape to use the type-preserving path\n const isZodObject = schemaOrShape instanceof $ZodObject\n if (isObjectShape(schemaOrShape) || isZodObject) {\n // Extract shape from ZodObject or use raw shape directly\n const shape = isZodObject\n ? (schemaOrShape as z.ZodObject<z.ZodRawShape>).shape\n : (schemaOrShape as Record<string, $ZodType>)\n\n // Convert fields with proper types\n const convexFields = zodToConvexFields(shape) as ConvexValidatorFromZodFieldsAuto<typeof shape>\n\n // Create the Table from convex-helpers with explicit type\n const table = Table<ConvexValidatorFromZodFieldsAuto<typeof shape>, TableName>(\n name,\n convexFields\n )\n\n // Create base schema (user fields only, no system fields)\n // When a ZodObject is passed, preserve it to maintain options like .passthrough(), .strict(), .catchall()\n const baseSchema = isZodObject ? (schemaOrShape as z.ZodObject<z.ZodRawShape>) : z.object(shape)\n const schema = createObjectSchemaBundle(name, shape, baseSchema as z.ZodObject<any>)\n const zDoc = schema.doc\n const docArray = schema.docArray\n\n // Attach everything for comprehensive usage\n // zDoc and docArray are deprecated but kept for backwards compatibility\n // TypeScript @deprecated annotations provide compile-time warnings\n return Object.assign(table, {\n shape,\n schema,\n zDoc,\n docArray\n })\n } else {\n // Union or other schema type logic\n const schema = schemaOrShape as $ZodType\n\n // Convert schema to Convex validator\n const convexValidator = zodToConvex(schema)\n\n // For unions, use defineTable directly (not Table helper which expects object fields)\n // Convex supports union validators in tables, but TypeScript can't verify the types\n const table = defineTable(asTableValidator(convexValidator))\n const schemaNamespace = createSchemaBundle(name, schema)\n\n // Attach helpers for union tables\n // Return structure similar to Table() but without fields-based helpers\n return {\n table,\n tableName: name,\n validator: convexValidator,\n schema: schemaNamespace,\n docArray: schemaNamespace.docArray, // deprecated\n withSystemFields: () => schemaNamespace.doc\n }\n }\n}\n"]}
1
+ {"version":3,"sources":["../../src/internal/schema/objectShape.ts","../../src/internal/ids.ts","../../src/internal/mapping/handlers/enum.ts","../../src/internal/mapping/handlers/nullable.ts","../../src/internal/mapping/handlers/record.ts","../../src/internal/mapping/handlers/union.ts","../../src/internal/mapping/utils.ts","../../src/internal/mapping/core.ts","../../src/internal/meta.ts","../../src/internal/schema/dateGuards.ts","../../src/internal/serverUtils.ts","../../src/internal/shared/object.ts","../../src/internal/stripUndefined.ts","../../src/internal/functionContracts.ts","../../src/internal/custom.ts","../../src/internal/wrappers.ts","../../src/internal/builders.ts","../../src/internal/codec.ts","../../src/internal/zx.ts","../../src/internal/schemaHelpers.ts","../../src/internal/modelSchemaBundle.ts","../../src/legacy/tables.ts"],"names":["zodToConvexInternal","v","metadata","z","registered","date","nullableOptional","docArray"],"mappings":"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","file":"index.js","sourcesContent":["import { $ZodObject } from '../zod-core'\n\nexport function getObjectShape(obj: any): Record<string, any> {\n if (obj instanceof $ZodObject) {\n return obj._zod.def.shape as Record<string, any>\n }\n if (obj && typeof obj === 'object' && typeof obj.shape === 'object') {\n return obj.shape as Record<string, any>\n }\n return {}\n}\n","/**\n * IDs + registry for Convex + Zod v4\n */\n\nimport type { GenericId } from 'convex/values'\nimport { z } from 'zod'\nimport type { $ZodType } from './zod-core'\n\n// Simple registry for metadata\nconst metadata = new WeakMap<$ZodType, any>()\n\nexport const registryHelpers = {\n getMetadata: (type: $ZodType) => metadata.get(type),\n setMetadata: (type: $ZodType, meta: any) => metadata.set(type, meta)\n}\n\n/**\n * Create a Zod validator for a Convex Id\n *\n * Compatible with AI SDK and other tools that don't support transforms.\n * Uses type-level branding instead of runtime transforms for GenericId<T> compatibility.\n *\n * @deprecated Use `zx.id()` instead for consistent naming with other zodvex helpers.\n * ```typescript\n * import { zx } from 'zodvex'\n * zx.id('users') // instead of zid('users')\n * ```\n *\n * @param tableName - The Convex table name for this ID\n * @returns A Zod string validator typed as GenericId<TableName>\n */\nexport function zid<TableName extends string>(\n tableName: TableName\n): $ZodType<GenericId<TableName>> & { _tableName: TableName } {\n // Create base string validator with refinement (no transform or brand)\n const baseSchema = z.string().check(\n z.refine(val => typeof val === 'string' && val.length > 0, {\n message: `Invalid ID for table \"${tableName}\"`\n }),\n // Add a human-readable marker for client-side introspection utilities\n // used in apps/native (e.g., to detect relationship fields in dynamic forms).\n z.describe(`convexId:${tableName}`)\n )\n\n // Store metadata for registry lookup so mapping can convert to v.id(tableName)\n registryHelpers.setMetadata(baseSchema, {\n isConvexId: true,\n tableName\n })\n\n // Add the tableName property for type-level detection\n const branded = baseSchema as any\n branded._tableName = tableName\n\n // Type assertion provides GenericId<TableName> typing without runtime transform\n // This maintains type safety while being compatible with AI SDK and similar tools\n return branded as $ZodType<GenericId<TableName>> & { _tableName: TableName }\n}\n\nexport type Zid<TableName extends string> = ReturnType<typeof zid<TableName>>\n","import type { GenericValidator, Validator } from 'convex/values'\nimport { v } from 'convex/values'\nimport { $ZodEnum, type $ZodType } from '../../zod-core'\n\n// Helper: Convert Zod enum types to Convex validators\nexport function convertEnumType(actualValidator: $ZodEnum): GenericValidator {\n const entries = actualValidator._zod.def.entries\n const options = Object.keys(entries)\n if (options && Array.isArray(options) && options.length > 0) {\n // Filter out undefined/null and convert to Convex validators\n const validLiterals = options\n .filter((opt: any) => opt !== undefined && opt !== null)\n .map((opt: any) => v.literal(opt))\n\n if (validLiterals.length === 1) {\n const [first] = validLiterals\n return first as Validator<any, 'required', any>\n } else if (validLiterals.length >= 2) {\n const [first, second, ...rest] = validLiterals\n return v.union(\n first as Validator<any, 'required', any>,\n second as Validator<any, 'required', any>,\n ...rest\n )\n } else {\n return v.any()\n }\n } else {\n return v.any()\n }\n}\n","import type { GenericValidator } from 'convex/values'\nimport { v } from 'convex/values'\nimport { $ZodNullable, $ZodOptional, $ZodType } from '../../zod-core'\n\n// Helper: Convert Zod nullable types to Convex validators\nexport function convertNullableType(\n actualValidator: $ZodNullable,\n visited: Set<$ZodType>,\n zodToConvexInternal: (schema: $ZodType, visited: Set<$ZodType>) => any\n): { validator: GenericValidator; isOptional: boolean } {\n const innerSchema = actualValidator._zod.def.innerType\n if (innerSchema && innerSchema instanceof $ZodType) {\n // Check if the inner schema is optional\n if (innerSchema instanceof $ZodOptional) {\n // For nullable(optional(T)), we want optional(union(T, null))\n const innerInnerSchema = innerSchema._zod.def.innerType\n const innerInnerValidator = zodToConvexInternal(innerInnerSchema, visited)\n return {\n validator: v.union(innerInnerValidator, v.null()),\n isOptional: true // Mark as optional so it gets wrapped later\n }\n } else {\n const innerValidator = zodToConvexInternal(innerSchema, visited)\n return {\n validator: v.union(innerValidator, v.null()),\n isOptional: false\n }\n }\n } else {\n return {\n validator: v.any(),\n isOptional: false\n }\n }\n}\n","import type { GenericValidator } from 'convex/values'\nimport { v } from 'convex/values'\nimport { $ZodDefault, $ZodOptional, $ZodRecord, $ZodType } from '../../zod-core'\n\n// Helper: Convert Zod record types to Convex validators\nexport function convertRecordType(\n actualValidator: $ZodRecord,\n visited: Set<$ZodType>,\n zodToConvexInternal: (schema: $ZodType, visited: Set<$ZodType>) => any\n): GenericValidator {\n // $ZodRecord._zod.def has keyType and valueType\n let valueType: $ZodType | undefined = actualValidator._zod.def.valueType\n\n // If valueType is undefined, fall back to keyType (single-argument z.record() form)\n if (!valueType) {\n valueType = actualValidator._zod.def.keyType\n }\n\n if (valueType && valueType instanceof $ZodType) {\n // First check if the Zod value type is optional before conversion\n const isZodOptional =\n valueType instanceof $ZodOptional ||\n valueType instanceof $ZodDefault ||\n (valueType instanceof $ZodDefault && valueType._zod.def.innerType instanceof $ZodOptional)\n\n if (isZodOptional) {\n // For optional record values, we need to handle this specially\n let innerType: any\n let recordDefaultValue: any = undefined\n let recordHasDefault = false\n\n if (valueType instanceof $ZodDefault) {\n // Handle ZodDefault wrapper\n recordHasDefault = true\n recordDefaultValue = valueType._zod.def.defaultValue\n const innerFromDefault = valueType._zod.def.innerType\n if (innerFromDefault instanceof $ZodOptional) {\n innerType = innerFromDefault._zod.def.innerType\n } else {\n innerType = innerFromDefault\n }\n } else if (valueType instanceof $ZodOptional) {\n // Direct ZodOptional\n innerType = valueType._zod.def.innerType\n } else {\n // Shouldn't happen based on isZodOptional check\n innerType = valueType\n }\n\n // Convert the inner type to Convex and wrap in union with null\n const innerConvex = zodToConvexInternal(innerType, visited)\n const unionValidator = v.union(innerConvex, v.null())\n\n // Add default metadata if present\n if (recordHasDefault) {\n ;(unionValidator as any)._zodDefault = recordDefaultValue\n }\n\n return v.record(v.string(), unionValidator)\n } else {\n // Non-optional values can be converted normally\n return v.record(v.string(), zodToConvexInternal(valueType, visited))\n }\n } else {\n return v.record(v.string(), v.any())\n }\n}\n","import type { GenericValidator, Validator } from 'convex/values'\nimport { v } from 'convex/values'\nimport { $ZodDiscriminatedUnion, type $ZodType, $ZodUnion } from '../../zod-core'\n\n// Helper: Convert Zod discriminated union types to Convex validators\nexport function convertDiscriminatedUnionType(\n actualValidator: $ZodType,\n visited: Set<$ZodType>,\n zodToConvexInternal: (schema: $ZodType, visited: Set<$ZodType>) => any\n): GenericValidator {\n const options =\n actualValidator instanceof $ZodDiscriminatedUnion\n ? actualValidator._zod.def.options\n : // cast: fallback for non-standard discriminated union variants\n (actualValidator as any)._zod?.def?.options\n if (options) {\n const opts = Array.isArray(options) ? options : Array.from(options)\n if (opts.length >= 2) {\n // IMPORTANT: Create a new visited set for each union member to prevent false circular\n // reference detection. The same schema can legitimately appear in multiple union branches.\n const convexOptions = opts.map((opt: any) => {\n const branchVisited = new Set(visited)\n return zodToConvexInternal(opt, branchVisited)\n }) as Validator<any, 'required', any>[]\n const [first, second, ...rest] = convexOptions\n return v.union(\n first as Validator<any, 'required', any>,\n second as Validator<any, 'required', any>,\n ...rest\n )\n } else {\n return v.any()\n }\n } else {\n return v.any()\n }\n}\n\n// Helper: Convert Zod union types to Convex validators\nexport function convertUnionType(\n actualValidator: $ZodUnion,\n visited: Set<$ZodType>,\n zodToConvexInternal: (schema: $ZodType, visited: Set<$ZodType>) => any\n): GenericValidator {\n const options = actualValidator._zod.def.options\n if (options && Array.isArray(options) && options.length > 0) {\n if (options.length === 1) {\n return zodToConvexInternal(options[0], visited)\n } else {\n // Convert each option recursively\n // IMPORTANT: Create a new visited set for each union member to prevent false circular\n // reference detection. The same schema can legitimately appear in multiple union branches.\n // However, we do want to preserve the parent visited set to catch actual circular refs\n // that involve the union itself.\n const convexOptions = options.map((opt: any) => {\n // Create a new Set that includes the parent's visited schemas but won't pollute it\n const branchVisited = new Set(visited)\n return zodToConvexInternal(opt, branchVisited)\n }) as Validator<any, 'required', any>[]\n if (convexOptions.length >= 2) {\n const [first, second, ...rest] = convexOptions\n return v.union(\n first as Validator<any, 'required', any>,\n second as Validator<any, 'required', any>,\n ...rest\n )\n } else {\n return v.any()\n }\n }\n } else {\n return v.any()\n }\n}\n","import { v } from 'convex/values'\nimport { registryHelpers, type Zid } from '../ids'\nimport { getObjectShape } from '../schema/objectShape'\nimport { $ZodType } from '../zod-core'\n\n// Helper to check if a schema is a Zid\nexport function isZid<T extends string>(schema: $ZodType): schema is Zid<T> {\n // Check our metadata registry for ConvexId marker\n const metadata = registryHelpers.getMetadata(schema)\n return (\n metadata?.isConvexId === true && metadata?.tableName && typeof metadata.tableName === 'string'\n )\n}\n\n// union helpers\nexport function makeUnion(members: any[]): any {\n const nonNull = members.filter(Boolean)\n if (nonNull.length === 0) return v.any()\n if (nonNull.length === 1) return nonNull[0]\n return v.union(nonNull[0], nonNull[1], ...nonNull.slice(2))\n}\n\nexport { getObjectShape }\n","import type { GenericValidator, PropertyValidators } from 'convex/values'\nimport { v } from 'convex/values'\nimport { registryHelpers } from '../ids'\nimport {\n $ZodArray,\n $ZodCodec,\n $ZodDefault,\n $ZodEnum,\n $ZodLazy,\n $ZodLiteral,\n $ZodNullable,\n $ZodObject,\n $ZodOptional,\n $ZodRecord,\n type $ZodShape,\n $ZodTuple,\n $ZodType,\n $ZodUnion\n} from '../zod-core'\nimport {\n convertDiscriminatedUnionType,\n convertEnumType,\n convertNullableType,\n convertRecordType,\n convertUnionType\n} from './handlers'\nimport type {\n ConvexValidatorFromZod,\n ConvexValidatorFromZodFieldsAuto,\n ZodValidator\n} from './types'\nimport { isZid } from './utils'\n\n// Module-scoped cache: same Zod schema instance → same Convex validator.\n// Avoids redundant allocations when the same schema is converted across\n// multiple function registrations or table definitions.\nconst convexValidatorCache = new WeakMap<$ZodType, GenericValidator>()\n\n// Internal conversion function using ZodType with def.type detection\nfunction zodToConvexInternal<Z extends $ZodType>(\n zodValidator: Z,\n visited: Set<$ZodType> = new Set()\n): ConvexValidatorFromZod<Z, 'required'> {\n // Guard against undefined/null validators (can happen with { field: undefined } in args)\n if (!zodValidator) {\n return v.any() as ConvexValidatorFromZod<Z, 'required'>\n }\n\n // Return cached result if this exact Zod instance was already converted\n const cached = convexValidatorCache.get(zodValidator)\n if (cached) {\n return cached as ConvexValidatorFromZod<Z, 'required'>\n }\n\n // Detect circular references to prevent infinite recursion\n if (visited.has(zodValidator)) {\n return v.any() as ConvexValidatorFromZod<Z, 'required'>\n }\n visited.add(zodValidator)\n\n // Check for default and optional wrappers\n let actualValidator = zodValidator\n let isOptional = false\n let defaultValue: any = undefined\n let hasDefault = false\n\n // Handle ZodDefault (which wraps ZodOptional when using .optional().default())\n if (zodValidator instanceof $ZodDefault) {\n hasDefault = true\n defaultValue = zodValidator._zod.def.defaultValue\n actualValidator = zodValidator._zod.def.innerType as Z\n }\n\n // Check for optional (may be wrapped inside ZodDefault)\n if (actualValidator instanceof $ZodOptional) {\n isOptional = true\n actualValidator = actualValidator._zod.def.innerType as Z\n\n // If the unwrapped type is ZodDefault, handle it here\n if (actualValidator instanceof $ZodDefault) {\n hasDefault = true\n defaultValue = actualValidator._zod.def.defaultValue\n actualValidator = actualValidator._zod.def.innerType as Z\n }\n }\n\n let convexValidator: GenericValidator\n\n // Check for Zid first (special case)\n if (isZid(actualValidator)) {\n const metadata = registryHelpers.getMetadata(actualValidator)\n const tableName = metadata?.tableName || 'unknown'\n convexValidator = v.id(tableName)\n } else {\n // Use def.type for robust, performant type detection instead of instanceof checks.\n // Rationale:\n // 1. Performance: Single switch statement vs. cascading instanceof checks\n // 2. Completeness: def.type covers ALL Zod variants including formats (email, url, uuid, etc.)\n // 3. Future-proof: Zod's internal structure is stable; instanceof checks can miss custom types\n // 4. Precision: def.type distinguishes between semantically different types (date vs number)\n // This private API access is intentional and necessary for comprehensive type coverage.\n // cast: switch handles more defType values than $ZodTypeDef types (e.g. discriminatedUnion)\n const defType = actualValidator._zod.def.type as string\n\n switch (defType) {\n case 'string':\n // This catches ZodString and ALL string format types (email, url, uuid, etc.)\n convexValidator = v.string()\n break\n case 'number':\n convexValidator = v.float64()\n break\n case 'bigint':\n convexValidator = v.int64()\n break\n case 'boolean':\n convexValidator = v.boolean()\n break\n case 'date':\n // LEGACY: Maps z.date() to v.float64() for backwards compatibility in type inference.\n // However, z.date() does NOT work at runtime because:\n // 1. z.date() produces Date objects, not numbers\n // 2. Convex rejects Date objects as non-serializable\n // 3. z.encode() on z.date() returns a Date, not a timestamp\n // Use zx.date() instead, which provides proper Date ↔ timestamp codec.\n // The wrappers and convexCodec will throw if z.date() is used.\n convexValidator = v.float64()\n break\n case 'null':\n convexValidator = v.null()\n break\n case 'nan':\n convexValidator = v.float64()\n break\n case 'array': {\n if (actualValidator instanceof $ZodArray) {\n const element = actualValidator._zod.def.element\n convexValidator = v.array(zodToConvexInternal(element, visited))\n } else {\n convexValidator = v.array(v.any())\n }\n break\n }\n case 'object': {\n if (actualValidator instanceof $ZodObject) {\n const shape = actualValidator._zod.def.shape\n const convexShape: PropertyValidators = {}\n for (const [key, value] of Object.entries(shape)) {\n if (value && value instanceof $ZodType) {\n convexShape[key] = zodToConvexInternal(value, visited)\n }\n }\n convexValidator = v.object(convexShape)\n } else {\n convexValidator = v.object({})\n }\n break\n }\n case 'union': {\n if (actualValidator instanceof $ZodUnion) {\n convexValidator = convertUnionType(actualValidator, visited, zodToConvexInternal)\n } else {\n convexValidator = v.any()\n }\n break\n }\n case 'discriminatedUnion': {\n convexValidator = convertDiscriminatedUnionType(\n actualValidator,\n visited,\n zodToConvexInternal\n )\n break\n }\n case 'literal': {\n if (actualValidator instanceof $ZodLiteral) {\n const literalValues = actualValidator._zod.def.values\n const firstValue = literalValues.values().next().value\n if (firstValue !== undefined && firstValue !== null) {\n convexValidator = v.literal(firstValue)\n } else {\n convexValidator = v.any()\n }\n } else {\n convexValidator = v.any()\n }\n break\n }\n case 'enum': {\n if (actualValidator instanceof $ZodEnum) {\n convexValidator = convertEnumType(actualValidator)\n } else {\n convexValidator = v.any()\n }\n break\n }\n case 'record': {\n if (actualValidator instanceof $ZodRecord) {\n convexValidator = convertRecordType(actualValidator, visited, zodToConvexInternal)\n } else {\n convexValidator = v.record(v.string(), v.any())\n }\n break\n }\n case 'transform':\n case 'pipe': {\n // Check for native Zod v4 codec first (z.codec())\n // Codecs have def.type='pipe' but are specifically for bidirectional transforms\n // Use the input schema (wire format) for Convex validation\n if (actualValidator instanceof $ZodCodec) {\n const inputSchema = actualValidator._zod.def.in\n if (inputSchema && inputSchema instanceof $ZodType) {\n convexValidator = zodToConvexInternal(inputSchema, visited)\n } else {\n convexValidator = v.any()\n }\n } else {\n // Check for brand metadata\n const metadata = registryHelpers.getMetadata(actualValidator)\n if (metadata?.brand && metadata?.originalSchema) {\n // For branded types created by our zBrand function, use the original schema\n convexValidator = zodToConvexInternal(metadata.originalSchema, visited)\n } else {\n // Non-codec transform - extract input schema but warn\n // cast: no instanceof guard available for generic pipe/transform\n const inputSchema = (actualValidator as any)._zod?.def?.in\n if (inputSchema && inputSchema instanceof $ZodType) {\n if (process.env.NODE_ENV !== 'production') {\n console.warn(\n '[zodvex] z.transform() detected. Using input schema for Convex validation.\\n' +\n 'Transforms are unidirectional - they work for parsing but not encoding.\\n' +\n 'For bidirectional transforms, use zx.codec() instead.'\n )\n }\n convexValidator = zodToConvexInternal(inputSchema, visited)\n } else {\n convexValidator = v.any()\n }\n }\n }\n break\n }\n case 'nullable': {\n if (actualValidator instanceof $ZodNullable) {\n const result = convertNullableType(actualValidator, visited, zodToConvexInternal)\n convexValidator = result.validator\n if (result.isOptional) {\n isOptional = true\n }\n } else {\n convexValidator = v.any()\n }\n break\n }\n case 'tuple': {\n // Handle tuple types as objects with numeric keys\n if (actualValidator instanceof $ZodTuple) {\n const items = actualValidator._zod.def.items\n if (items && items.length > 0) {\n const convexShape: PropertyValidators = {}\n items.forEach((item, index) => {\n convexShape[`_${index}`] = zodToConvexInternal(item, visited)\n })\n convexValidator = v.object(convexShape)\n } else {\n convexValidator = v.object({})\n }\n } else {\n convexValidator = v.object({})\n }\n break\n }\n case 'lazy': {\n // Handle lazy schemas by resolving them\n // Circular references are protected by the visited set check at function start\n if (actualValidator instanceof $ZodLazy) {\n try {\n const getter = actualValidator._zod.def.getter\n if (getter) {\n const resolvedSchema = getter()\n if (resolvedSchema && resolvedSchema instanceof $ZodType) {\n convexValidator = zodToConvexInternal(resolvedSchema, visited)\n } else {\n convexValidator = v.any()\n }\n } else {\n convexValidator = v.any()\n }\n } catch {\n // If resolution fails, fall back to 'any'\n convexValidator = v.any()\n }\n } else {\n convexValidator = v.any()\n }\n break\n }\n case 'any':\n // Handle z.any() directly\n convexValidator = v.any()\n break\n case 'unknown':\n // Handle z.unknown() as any\n convexValidator = v.any()\n break\n case 'undefined':\n case 'void':\n case 'never':\n // These types don't have good Convex equivalents\n convexValidator = v.any()\n break\n case 'intersection':\n // Can't properly handle intersections\n convexValidator = v.any()\n break\n case 'optional': {\n // Fallback for optional types that weren't caught by the instanceof check above.\n // cast: no instanceof guard — this handles edge cases where defType='optional'\n // but the schema isn't a $ZodOptional instance (e.g. pipes wrapped with .optional())\n const innerType = (actualValidator as any)._zod?.def?.innerType\n if (innerType && innerType instanceof $ZodType) {\n convexValidator = zodToConvexInternal(innerType, visited)\n isOptional = true\n } else {\n convexValidator = v.any()\n isOptional = true\n }\n break\n }\n default:\n // For any unrecognized def.type, return v.any()\n // No instanceof fallbacks - keep it simple and performant\n if (process.env.NODE_ENV !== 'production') {\n console.warn(\n `[zodvex] Unrecognized Zod type \"${defType}\" encountered. Falling back to v.any().`,\n 'Schema:',\n actualValidator\n )\n }\n convexValidator = v.any()\n break\n }\n }\n\n // For optional or default fields, always use v.optional()\n const finalValidator = isOptional || hasDefault ? v.optional(convexValidator) : convexValidator\n\n // Add metadata if there's a default value\n if (hasDefault && typeof finalValidator === 'object' && finalValidator !== null) {\n ;(finalValidator as any)._zodDefault = defaultValue\n }\n\n // Cache the result so the same Zod instance returns the same Convex validator\n convexValidatorCache.set(zodValidator, finalValidator)\n\n return finalValidator as ConvexValidatorFromZod<Z, 'required'>\n}\n\nexport function zodToConvex<Z extends $ZodType | ZodValidator>(\n zod: Z\n): Z extends $ZodType\n ? ConvexValidatorFromZod<Z, 'required'>\n : Z extends ZodValidator\n ? ConvexValidatorFromZodFieldsAuto<Z>\n : never {\n if (typeof zod === 'object' && zod !== null && !(zod instanceof $ZodType)) {\n return zodToConvexFields(zod as ZodValidator) as any\n }\n\n return zodToConvexInternal(zod as $ZodType) as any\n}\n\nexport function zodToConvexFields<Z extends $ZodShape>(\n zod: Z\n): ConvexValidatorFromZodFieldsAuto<Z> {\n // If it's a ZodObject, extract the shape\n const fields = zod instanceof $ZodObject ? zod._zod.def.shape : zod\n\n // Build the result object directly to preserve types\n const result: any = {}\n for (const [key, value] of Object.entries(fields)) {\n result[key] = zodToConvexInternal(value as $ZodType)\n }\n\n return result as ConvexValidatorFromZodFieldsAuto<Z>\n}\n","import type { $ZodType } from './zod-core'\n\nconst META_KEY = '__zodvexMeta'\n\nexport type ZodvexFunctionMeta = {\n type: 'function'\n zodArgs?: $ZodType\n zodReturns?: $ZodType\n}\n\nexport type ZodvexModelDefinitionSource = 'shape' | 'schema'\n\nexport type ZodvexModelMeta = {\n type: 'model'\n tableName: string\n definitionSource?: ZodvexModelDefinitionSource\n schemas?: {\n doc: $ZodType\n insert: $ZodType\n update: $ZodType\n docArray: $ZodType\n paginatedDoc: $ZodType\n }\n}\n\nexport type ZodvexMeta = ZodvexFunctionMeta | ZodvexModelMeta\n\nexport function attachMeta(target: object, meta: ZodvexMeta): void {\n Object.defineProperty(target, META_KEY, {\n value: meta,\n enumerable: false,\n writable: false,\n configurable: false\n })\n}\n\nexport function readMeta(target: unknown): ZodvexMeta | undefined {\n if (target == null || (typeof target !== 'object' && typeof target !== 'function')) {\n return undefined\n }\n return (target as Record<string, unknown>)[META_KEY] as ZodvexMeta | undefined\n}\n\nconst CODEC_BRAND_KEY = '__zodvexCodecBrand'\n\n/**\n * Attaches a provenance brand to a codec instance. Codegen reads this at\n * discovery time to match a function-embedded codec to its importable twin\n * by *declared* identity instead of inferring it from structure. Stored\n * non-enumerably so it never leaks into user data, and survives\n * `.optional()` / `.nullable()` wrapping (codegen unwraps to the codec).\n * See `docs/decisions/2026-06-08-codec-provenance-brands.md`.\n */\nexport function attachCodecBrand(target: object, brand: string): void {\n Object.defineProperty(target, CODEC_BRAND_KEY, {\n value: brand,\n enumerable: false,\n writable: false,\n configurable: false\n })\n}\n\n/** Reads a codec's provenance brand, or undefined if unbranded. */\nexport function readCodecBrand(target: unknown): string | undefined {\n if (target == null || typeof target !== 'object') return undefined\n const value = (target as Record<string, unknown>)[CODEC_BRAND_KEY]\n return typeof value === 'string' ? value : undefined\n}\n","import { z } from 'zod'\nimport {\n $ZodArray,\n $ZodCodec,\n $ZodDate,\n $ZodDefault,\n $ZodNullable,\n $ZodObject,\n $ZodOptional,\n $ZodRecord,\n $ZodTuple,\n $ZodType,\n $ZodUnion\n} from '../zod-core'\n\n/**\n * @deprecated Use `zx.date()` instead for automatic Date ↔ timestamp conversion.\n */\nexport function mapDateFieldToNumber(field: $ZodType): $ZodType {\n if (field instanceof $ZodDate) {\n return z.number()\n }\n if (field instanceof $ZodOptional && field._zod.def.innerType instanceof $ZodDate) {\n return z.optional(z.number())\n }\n if (field instanceof $ZodNullable && field._zod.def.innerType instanceof $ZodDate) {\n return z.nullable(z.number())\n }\n if (field instanceof $ZodDefault) {\n const inner = field._zod.def.innerType\n if (inner instanceof $ZodDate) {\n return z.optional(z.number())\n }\n }\n return field\n}\n\nfunction containsNativeZodDate(schema: $ZodType): boolean {\n if (schema instanceof $ZodDate) return true\n if (schema instanceof $ZodCodec) return false\n\n if (\n schema instanceof $ZodOptional ||\n schema instanceof $ZodNullable ||\n schema instanceof $ZodDefault\n ) {\n return containsNativeZodDate(schema._zod.def.innerType)\n }\n\n if (schema instanceof $ZodObject) {\n return Object.values(schema._zod.def.shape).some(field => containsNativeZodDate(field))\n }\n if (schema instanceof $ZodArray) {\n return containsNativeZodDate(schema._zod.def.element)\n }\n if (schema instanceof $ZodUnion) {\n return schema._zod.def.options.some(opt => containsNativeZodDate(opt))\n }\n if (schema instanceof $ZodRecord) {\n return containsNativeZodDate(schema._zod.def.valueType)\n }\n if (schema instanceof $ZodTuple) {\n const items = schema._zod.def.items\n return items ? items.some(item => containsNativeZodDate(item)) : false\n }\n\n return false\n}\n\nexport function assertNoNativeZodDate(\n schema: $ZodType,\n context: 'args' | 'returns' | 'schema'\n): void {\n if (containsNativeZodDate(schema)) {\n throw new Error(\n `[zodvex] Native z.date() found in ${context}. ` +\n `Convex stores dates as timestamps (numbers), which z.date() cannot parse.\\n\\n` +\n `Fix: Replace z.date() with zx.date()\\n\\n` +\n `Before: { createdAt: z.date() }\\n` +\n `After: { createdAt: zx.date() }\\n\\n` +\n `zx.date() is a codec that handles timestamp ↔ Date conversion automatically.`\n )\n }\n}\n","/**\n * Server-only utilities — imports ConvexError from convex/values.\n * Do NOT re-export from core/index.ts or any client-safe barrel.\n */\nimport { ConvexError } from 'convex/values'\nimport { z } from 'zod'\nimport { $ZodError, $ZodType, encode, parse } from './zod-core'\n\n// Format ZodError issues into a compact, consistent structure\nexport function formatZodIssues(\n error: z.ZodError, // zod-ok\n context?: 'args' | 'returns' | 'input' | 'output' | 'codec'\n) {\n return {\n error: 'ZodValidationError',\n context,\n issues: error.issues.map(issue => ({\n path: Array.isArray(issue.path) ? issue.path.join('.') : String(issue.path ?? ''),\n code: issue.code,\n message: issue.message\n })),\n // Keep a flattened snapshot for easier debugging without cyclic refs\n flatten: JSON.parse(JSON.stringify(error.flatten?.() ?? {}))\n }\n}\n\n// Handle Zod validation errors consistently across all wrappers\n// Throws a ConvexError with formatted issues if the error is a ZodError, otherwise re-throws\nexport function handleZodValidationError(\n e: unknown,\n context: 'args' | 'returns' | 'input' | 'output' | 'codec'\n): never {\n if (e instanceof $ZodError) {\n throw new ConvexError(formatZodIssues(e as z.ZodError, context)) // zod-ok\n }\n throw e\n}\n\n/**\n * Validates a return value against a Zod schema, supporting both codecs and regular schemas.\n *\n * Tries z.encode() first (for codec support), then falls back to .parse() if the schema\n * contains unidirectional transforms (which don't support encoding).\n *\n * For codecs: returns the encoded wire format (z.input<T>)\n * For transforms: returns the transformed output (z.output<T>)\n * For plain schemas: returns the validated value\n *\n * @param schema - The Zod schema to validate against\n * @param value - The value to validate\n * @returns The validated/encoded value\n * @throws Calls handleZodValidationError on validation failure\n */\nexport function validateReturns(schema: $ZodType, value: unknown): unknown {\n try {\n // Try encode first - works for codecs and plain schemas\n return encode(schema, value)\n } catch (e: any) {\n // If it's a unidirectional transform error, fall back to parse\n if (e?.message?.includes('unidirectional transform')) {\n try {\n return parse(schema, value)\n } catch (parseError) {\n handleZodValidationError(parseError, 'returns')\n }\n }\n // For any other error, handle it normally\n handleZodValidationError(e, 'returns')\n }\n // TypeScript can't infer that handleZodValidationError always throws\n throw new Error('Unreachable')\n}\n","export function pick<T extends Record<string, any>, K extends keyof T>(\n obj: T,\n keys: K[]\n): Pick<T, K> {\n const result = {} as Pick<T, K>\n for (const key of keys) {\n if (key in obj) result[key] = obj[key]\n }\n return result\n}\n","/**\n * Recursively strips `undefined` values from objects and arrays.\n * Used by codec encode/decode to clean wire data.\n *\n * Extracted to its own module so client-safe code (boundaryHelpers)\n * can import it without pulling in zod via utils.ts.\n */\nexport function stripUndefined<T>(value: T): T {\n if (value === null || value === undefined) {\n return value\n }\n\n if (Array.isArray(value)) {\n return value.map(stripUndefined) as T\n }\n\n // Only process plain objects (not class instances, Dates, etc.)\n if (typeof value === 'object' && value.constructor === Object) {\n const result: Record<string, unknown> = {}\n for (const [key, val] of Object.entries(value)) {\n if (val !== undefined) {\n result[key] = stripUndefined(val)\n }\n }\n return result as T\n }\n\n return value\n}\n","import { z } from 'zod'\nimport { getObjectShape, type ZodValidator, zodToConvex, zodToConvexFields } from './mapping'\nimport { attachMeta } from './meta'\nimport { assertNoNativeZodDate } from './schema/dateGuards'\nimport { handleZodValidationError, validateReturns } from './serverUtils'\nimport { pick } from './shared/object'\nimport { stripUndefined } from './stripUndefined'\nimport {\n $ZodCustom,\n $ZodDefault,\n $ZodNullable,\n $ZodObject,\n $ZodOptional,\n $ZodType,\n $ZodUnion,\n safeParse,\n parse as zodParse\n} from './zod-core'\n\nexport type FunctionSchemaInput = $ZodType | Record<string, $ZodType> | undefined\nexport type DirectFunctionInput = $ZodType | Record<string, $ZodType>\n\nexport type CustomInputResult = {\n ctx?: Record<string, unknown>\n args?: Record<string, unknown>\n onSuccess?: (params: { ctx: unknown; args: unknown; result: unknown }) => unknown\n}\n\nexport function normalizeFunctionSchema(input: FunctionSchemaInput): $ZodType | undefined {\n if (!input) return undefined\n return input instanceof $ZodType ? input : z.object(input)\n}\n\nfunction normalizeFunctionMetaArgs(input: FunctionSchemaInput): z.ZodObject<any> | undefined {\n if (!input) return undefined\n if (input instanceof $ZodObject) {\n return input as unknown as z.ZodObject<any> // zod-ok\n }\n if (input instanceof $ZodType) {\n return undefined\n }\n return z.object(input)\n}\n\nexport function attachFunctionMeta(\n target: object,\n args: FunctionSchemaInput,\n returns: FunctionSchemaInput\n): void {\n attachMeta(target, {\n type: 'function',\n zodArgs: normalizeFunctionMetaArgs(args),\n zodReturns: normalizeFunctionSchema(returns)\n })\n}\n\n// Cache to avoid re-checking the same schema\nconst customCheckCache = new WeakMap<$ZodType, boolean>()\n\nfunction containsCustom(schema: $ZodType, maxDepth = 50, currentDepth = 0): boolean {\n const cached = customCheckCache.get(schema)\n if (cached !== undefined) {\n return cached\n }\n\n if (currentDepth > maxDepth) {\n return false\n }\n\n let result = false\n if (schema instanceof $ZodCustom) {\n result = true\n } else if (schema instanceof $ZodUnion) {\n result = schema._zod.def.options.some(opt => containsCustom(opt, maxDepth, currentDepth + 1))\n } else if (schema instanceof $ZodOptional) {\n result = containsCustom(schema._zod.def.innerType, maxDepth, currentDepth + 1)\n } else if (schema instanceof $ZodNullable) {\n result = containsCustom(schema._zod.def.innerType, maxDepth, currentDepth + 1)\n } else if (schema instanceof $ZodDefault) {\n result = containsCustom(schema._zod.def.innerType, maxDepth, currentDepth + 1)\n }\n\n customCheckCache.set(schema, result)\n return result\n}\n\nexport function normalizeDirectFunctionInput(input: DirectFunctionInput): {\n zodSchema: $ZodType\n convexArgs: Record<string, any>\n} {\n if (input instanceof $ZodObject) {\n return {\n zodSchema: input,\n convexArgs: zodToConvexFields(getObjectShape(input))\n }\n }\n\n if (input instanceof $ZodType) {\n return {\n zodSchema: z.object({ value: input as any }),\n convexArgs: { value: zodToConvex(input as any) }\n }\n }\n\n return {\n zodSchema: z.object(input),\n convexArgs: zodToConvexFields(input)\n }\n}\n\nexport function normalizeCustomArgsValidator(args: ZodValidator | $ZodObject): {\n argsValidator: ZodValidator\n argsSchema: $ZodObject\n} {\n if (args instanceof $ZodType) {\n if (args instanceof $ZodObject) {\n return {\n argsSchema: args as unknown as $ZodObject,\n argsValidator: args._zod.def.shape as any\n }\n }\n throw new Error(\n 'Unsupported non-object Zod schema for args; please provide an args schema using z.object({...}), e.g. z.object({ foo: z.string() })'\n )\n }\n\n return {\n argsValidator: args,\n argsSchema: z.object(args)\n }\n}\n\nexport function createConvexReturnsValidator(\n schema?: $ZodType,\n options?: { skipCustomSchemas?: boolean; skipConvexValidation?: boolean }\n): any {\n if (!schema || options?.skipConvexValidation) {\n return undefined\n }\n if (options?.skipCustomSchemas && containsCustom(schema)) {\n return undefined\n }\n return zodToConvex(schema)\n}\n\nexport function assertFunctionSchemas(argsSchema: $ZodType, returnsSchema?: $ZodType): void {\n assertNoNativeZodDate(argsSchema, 'args')\n if (returnsSchema) {\n assertNoNativeZodDate(returnsSchema, 'returns')\n }\n}\n\nexport function parseFunctionArgsOrThrow(zodSchema: $ZodType, argsObject: unknown): any {\n try {\n return zodParse(zodSchema, argsObject) as any\n } catch (e) {\n handleZodValidationError(e, 'args')\n }\n}\n\nexport function parseObjectArgsOrThrow(\n argsSchema: $ZodObject,\n rawArgs: Record<string, unknown>\n): Record<string, unknown> {\n const parsed = safeParse(argsSchema, rawArgs)\n if (!parsed.success) {\n handleZodValidationError(parsed.error, 'args')\n }\n return parsed.data as Record<string, unknown>\n}\n\nexport async function runCustomizationInput(\n customInput: (ctx: unknown, args: unknown, extra?: unknown) => unknown,\n ctx: unknown,\n allArgs: Record<string, unknown>,\n inputArgs: Record<string, unknown>,\n extra: Record<string, unknown>,\n argsSchema?: $ZodObject\n): Promise<CustomInputResult | undefined> {\n // Cast justification: customInput expects ObjectType<CustomArgsValidator>, but pick()\n // returns Partial<T>. The cast is safe because inputArgs keys are derived from\n // CustomArgsValidator at the type level.\n const picked = pick(allArgs, Object.keys(inputArgs)) as Record<string, unknown>\n // #72: when the customization declared its args as zod, decode them (codec\n // transforms applied) before the customization's `input` runs — symmetric\n // with how consumer args are decoded via parseObjectArgsOrThrow.\n const customArgs = argsSchema ? parseObjectArgsOrThrow(argsSchema, picked) : picked\n return (await customInput(ctx, customArgs as any, extra)) as CustomInputResult | undefined\n}\n\nexport function applyCustomizationResult(\n ctx: Record<string, unknown>,\n baseArgs: Record<string, unknown>,\n added?: CustomInputResult\n): { finalCtx: Record<string, unknown>; finalArgs: Record<string, unknown> } {\n const finalCtx = { ...ctx, ...(added?.ctx ?? {}) }\n const addedArgs = added?.args ?? {}\n return {\n finalCtx,\n finalArgs: { ...baseArgs, ...addedArgs }\n }\n}\n\nexport async function finalizeFunctionReturn(\n result: unknown,\n options?: {\n ctx?: Record<string, unknown>\n args?: Record<string, unknown>\n added?: CustomInputResult\n returns?: $ZodType\n }\n): Promise<unknown> {\n if (options?.added?.onSuccess) {\n await options.added.onSuccess({\n ctx: options.ctx,\n args: options.args,\n result\n })\n }\n\n if (options?.returns) {\n const validated = validateReturns(options.returns, result)\n return stripUndefined(validated)\n }\n\n return stripUndefined(result)\n}\n","import {\n type ActionBuilder,\n type ArgsArrayToObject,\n type DefaultFunctionArgs,\n type FunctionVisibility,\n type GenericActionCtx,\n type GenericDataModel,\n type GenericMutationCtx,\n type GenericQueryCtx,\n type MutationBuilder,\n type QueryBuilder\n} from 'convex/server'\nimport { type PropertyValidators } from 'convex/values'\nimport { type Customization, NoOp } from 'convex-helpers/server/customFunctions'\nimport { z } from 'zod'\nimport {\n applyCustomizationResult,\n attachFunctionMeta,\n createConvexReturnsValidator,\n finalizeFunctionReturn,\n normalizeCustomArgsValidator,\n normalizeFunctionSchema,\n parseObjectArgsOrThrow,\n runCustomizationInput\n} from './functionContracts'\nimport { type ZodValidator, zodToConvexFields } from './mapping'\nimport { assertNoNativeZodDate } from './schema/dateGuards'\nimport { pick } from './shared/object'\nimport type { ExtractCtx, ExtractVisibility, Overwrite } from './types'\nimport { $ZodObject, $ZodType } from './zod-core'\n\n// Type helpers for args transformation (from zodV3 example)\ntype OneArgArray<ArgsObject extends DefaultFunctionArgs = DefaultFunctionArgs> = [ArgsObject]\n\n// Simple type conversion from a Convex validator to a Zod validator return type\ntype NullToUndefinedOrNull<T> = T extends null ? T | undefined | void : T\ntype Returns<T> = Promise<NullToUndefinedOrNull<T>> | NullToUndefinedOrNull<T>\n\n// The return value before it's been validated: returned by the handler\n// Uses z.output since the handler produces the internal representation (e.g., Date),\n// which is then encoded to wire format (e.g., string) before sending to the client\ntype ReturnValueInput<ReturnsValidator extends $ZodType | ZodValidator | void> = [\n ReturnsValidator\n] extends [$ZodType]\n ? Returns<z.output<ReturnsValidator>>\n : [ReturnsValidator] extends [ZodValidator]\n ? Returns<z.output<$ZodObject<ReturnsValidator>>>\n : any\n\n// The return value after it's been validated: returned to the client\ntype ReturnValueOutput<ReturnsValidator extends $ZodType | ZodValidator | void> = [\n ReturnsValidator\n] extends [$ZodType]\n ? Returns<z.output<ReturnsValidator>>\n : [ReturnsValidator] extends [ZodValidator]\n ? Returns<z.output<$ZodObject<ReturnsValidator>>>\n : any\n\n// The args as seen by the caller: runtime types (z.output), not wire types (z.input).\n// For codecs (e.g., custom field types), z.output = runtime class, z.input = wire object.\n// Callers pass runtime types; encoding to wire format happens inside the wrapper.\ntype ArgsInput<ArgsValidator extends ZodValidator | $ZodObject | void> = [ArgsValidator] extends [\n $ZodObject\n]\n ? [z.output<ArgsValidator>]\n : [ArgsValidator] extends [ZodValidator]\n ? [z.output<$ZodObject<ArgsValidator>>]\n : OneArgArray\n\n// The args after they've been validated: passed to the handler\ntype ArgsOutput<ArgsValidator extends ZodValidator | $ZodObject | void> = [ArgsValidator] extends [\n $ZodObject\n]\n ? [z.output<ArgsValidator>]\n : [ArgsValidator] extends [ZodValidator]\n ? [z.output<$ZodObject<ArgsValidator>>]\n : OneArgArray\n\n// Re-export for backwards compatibility (canonical definition in types.ts)\nexport type { Overwrite } from './types'\n\n// Hack to simplify how TypeScript renders object types\ntype Expand<ObjectType extends Record<any, any>> =\n ObjectType extends Record<any, any>\n ? {\n [Key in keyof ObjectType]: ObjectType[Key]\n }\n : never\n\ntype ArgsForHandlerType<\n OneOrZeroArgs extends [] | [Record<string, any>],\n CustomMadeArgs extends Record<string, any>\n> =\n CustomMadeArgs extends Record<string, never>\n ? OneOrZeroArgs\n : OneOrZeroArgs extends [infer A]\n ? [Expand<A & CustomMadeArgs>]\n : [CustomMadeArgs]\n\n// Helper type for function registration (from zodV3)\ntype Registration<\n FuncType extends 'query' | 'mutation' | 'action',\n Visibility extends FunctionVisibility,\n Args extends DefaultFunctionArgs,\n Output\n> = FuncType extends 'query'\n ? import('convex/server').RegisteredQuery<Visibility, Args, Output>\n : FuncType extends 'mutation'\n ? import('convex/server').RegisteredMutation<Visibility, Args, Output>\n : import('convex/server').RegisteredAction<Visibility, Args, Output>\n\n/**\n * A builder that customizes a Convex function, whether or not it validates\n * arguments. If the customization requires arguments, however, the resulting\n * builder will require argument validation too.\n *\n * This is our own Zod-aware CustomBuilder type that properly handles Zod validators.\n */\nexport type CustomBuilder<\n FuncType extends 'query' | 'mutation' | 'action',\n // The customization's caller-facing args as a resolved object type (the args\n // the caller must supply so the customization's `input` can consume them).\n // Resolved rather than a `PropertyValidators` slot so zodvex customizations\n // (`.withContext({ args: <zod> })`) can express decoded-runtime arg types. #72\n CustomArgs extends Record<string, any>,\n CustomCtx extends Record<string, any>,\n CustomMadeArgs extends Record<string, any>,\n InputCtx,\n Visibility extends FunctionVisibility,\n ExtraArgs extends Record<string, any>\n> = {\n <\n ArgsValidator extends ZodValidator | $ZodObject | void,\n ReturnsZodValidator extends $ZodType | ZodValidator | void = void,\n ReturnValue extends ReturnValueInput<ReturnsZodValidator> = any\n >(\n func:\n | ({\n /**\n * Specify the arguments to the function as a Zod validator.\n */\n args?: ArgsValidator\n handler: (\n ctx: Overwrite<InputCtx, CustomCtx>,\n ...args: ArgsForHandlerType<ArgsOutput<ArgsValidator>, CustomMadeArgs>\n ) => ReturnValue\n /**\n * Validates the value returned by the function.\n * Note: you can't pass an object directly without wrapping it\n * in `z.object()`.\n */\n returns?: ReturnsZodValidator\n /**\n * If true, the function will not be validated by Convex,\n * in case you're seeing performance issues with validating twice.\n */\n skipConvexValidation?: boolean\n } & {\n [key in keyof ExtraArgs as key extends\n | 'args'\n | 'handler'\n | 'skipConvexValidation'\n | 'returns'\n ? never\n : key]: ExtraArgs[key]\n })\n | {\n (\n ctx: Overwrite<InputCtx, CustomCtx>,\n ...args: ArgsForHandlerType<ArgsOutput<ArgsValidator>, CustomMadeArgs>\n ): ReturnValue\n }\n ): Registration<\n FuncType,\n Visibility,\n ArgsArrayToObject<\n CustomArgs extends Record<string, never>\n ? ArgsInput<ArgsValidator>\n : ArgsInput<ArgsValidator> extends [infer A]\n ? [Expand<A & CustomArgs>]\n : [CustomArgs]\n >,\n ReturnsZodValidator extends void ? ReturnValue : ReturnValueOutput<ReturnsZodValidator>\n >\n}\n\nexport function customFnBuilder<\n Ctx extends Record<string, any>,\n Builder extends (fn: any) => any,\n CustomArgsValidator extends PropertyValidators,\n CustomCtx extends Record<string, any>,\n CustomMadeArgs extends Record<string, any>,\n ExtraArgs extends Record<string, any> = Record<string, any>\n>(\n builder: Builder,\n customization: Customization<Ctx, CustomArgsValidator, CustomCtx, CustomMadeArgs, ExtraArgs>\n) {\n const customInput = customization.input ?? NoOp.input\n const rawInputArgs = customization.args ?? NoOp.args\n\n // #72: a customization may declare its args as zod (e.g. a codec-typed arg in\n // `.withContext({ args: { token: myCodec } })`). Those must enter the same\n // pipeline as consumer args — converted to Convex validators for registration\n // and codec-decoded before `input` runs. Pre-built Convex validators (the\n // legacy shape) are passed through unchanged for back-compat.\n const customArgEntries = Object.entries(rawInputArgs)\n const customArgsAreZod =\n customArgEntries.length > 0 && customArgEntries.every(([, v]) => v instanceof $ZodType)\n const inputArgs = customArgsAreZod\n ? zodToConvexFields(rawInputArgs as unknown as ZodValidator)\n : rawInputArgs\n const customArgsSchema = customArgsAreZod\n ? (z.object(rawInputArgs as any) as unknown as $ZodObject)\n : undefined\n\n return function customBuilder(fn: any): any {\n const { args, handler = fn, returns: maybeObject, ...extra } = fn\n const skipConvexValidation = fn.skipConvexValidation ?? false\n\n const returns = normalizeFunctionSchema(maybeObject)\n const returnValidator = createConvexReturnsValidator(returns, { skipConvexValidation })\n const convexReturns = returnValidator ? { returns: returnValidator } : undefined\n\n // Check for z.date() usage at construction time (once), not on every invocation\n if (returns) {\n assertNoNativeZodDate(returns as $ZodType, 'returns')\n }\n\n if (args) {\n const { argsValidator, argsSchema } = normalizeCustomArgsValidator(args)\n\n // Only generate Convex args validator when not skipping Convex validation\n const convexArgs = skipConvexValidation\n ? inputArgs\n : { ...zodToConvexFields(argsValidator), ...inputArgs }\n\n // Check for z.date() usage at construction time (once), not on every invocation\n assertNoNativeZodDate(argsSchema, 'args')\n\n const registered = builder({\n args: convexArgs,\n ...convexReturns,\n handler: async (ctx: Ctx, allArgs: any) => {\n const added = await runCustomizationInput(\n customInput as any,\n ctx,\n allArgs,\n inputArgs,\n extra,\n customArgsSchema\n )\n const argKeys = Object.keys(argsValidator)\n const rawArgs = pick(allArgs, argKeys)\n const baseArgs = parseObjectArgsOrThrow(argsSchema, rawArgs)\n const { finalCtx, finalArgs } = applyCustomizationResult(ctx as any, baseArgs, added)\n\n const ret = await handler(finalCtx, finalArgs)\n return finalizeFunctionReturn(ret, { ctx: ctx as any, args: baseArgs, added, returns })\n }\n })\n attachFunctionMeta(registered, argsSchema, returns)\n return registered\n }\n const registered = builder({\n args: inputArgs,\n ...convexReturns,\n handler: async (ctx: Ctx, allArgs: any) => {\n const baseArgs = allArgs as Record<string, unknown>\n const added = await runCustomizationInput(\n customInput as any,\n ctx,\n allArgs,\n inputArgs,\n extra,\n customArgsSchema\n )\n const { finalCtx, finalArgs } = applyCustomizationResult(ctx as any, baseArgs, added)\n\n const ret = await handler(finalCtx, finalArgs)\n return finalizeFunctionReturn(ret, { ctx: ctx as any, args: baseArgs, added, returns })\n }\n })\n attachFunctionMeta(registered, undefined, returns)\n return registered\n }\n}\n\nfunction createCustomBuilderEntrypoint<\n Builder extends (fn: any) => any,\n CustomArgsValidator extends PropertyValidators,\n CustomCtx extends Record<string, any>,\n CustomMadeArgs extends Record<string, any>,\n ExtraArgs extends Record<string, any> = Record<string, any>\n>(\n builder: Builder,\n customization: Customization<any, CustomArgsValidator, CustomCtx, CustomMadeArgs, ExtraArgs>\n) {\n return customFnBuilder<any, Builder, CustomArgsValidator, CustomCtx, CustomMadeArgs, ExtraArgs>(\n builder as any,\n customization as any\n ) as any\n}\n\n// Overload 1: With constraint - preferred to preserve DataModel types\nexport function zCustomQuery<\n CustomArgsValidator extends PropertyValidators,\n CustomCtx extends Record<string, any>,\n CustomMadeArgs extends Record<string, any>,\n Visibility extends FunctionVisibility,\n DataModel extends GenericDataModel,\n ExtraArgs extends Record<string, any> = Record<string, any>\n>(\n query: QueryBuilder<DataModel, Visibility>,\n customization: Customization<any, CustomArgsValidator, CustomCtx, CustomMadeArgs, ExtraArgs>\n): CustomBuilder<\n 'query',\n import('convex/values').ObjectType<CustomArgsValidator>,\n CustomCtx,\n CustomMadeArgs,\n GenericQueryCtx<DataModel>,\n Visibility,\n ExtraArgs\n>\n\n// Overload 2: No constraint + decoupled ctx\nexport function zCustomQuery<\n CustomArgsValidator extends PropertyValidators,\n CustomCtx extends Record<string, any>,\n CustomMadeArgs extends Record<string, any>,\n Visibility extends FunctionVisibility,\n ExtraArgs extends Record<string, any> = Record<string, any>\n>(\n query: QueryBuilder<any, Visibility>,\n customization: Customization<any, CustomArgsValidator, CustomCtx, CustomMadeArgs, ExtraArgs>\n): CustomBuilder<\n 'query',\n import('convex/values').ObjectType<CustomArgsValidator>,\n CustomCtx,\n CustomMadeArgs,\n any,\n Visibility,\n ExtraArgs\n>\n\n// Implementation\nexport function zCustomQuery<\n CustomArgsValidator extends PropertyValidators,\n CustomCtx extends Record<string, any>,\n CustomMadeArgs extends Record<string, any>,\n Visibility extends FunctionVisibility,\n ExtraArgs extends Record<string, any> = Record<string, any>\n>(\n query: QueryBuilder<any, Visibility>,\n customization: Customization<any, CustomArgsValidator, CustomCtx, CustomMadeArgs, ExtraArgs>\n) {\n // Cast justification: This is the TypeScript overload implementation pattern. The function\n // has two overloads (with/without DataModel constraint) that provide precise types to callers.\n // The implementation must satisfy both overloads, which requires a broader signature.\n // The 'as any' casts allow the implementation to delegate to customFnBuilder without\n // TypeScript complaining about the generic parameter differences between overloads.\n // This is type-safe because: (1) callers only see the overload signatures which are strict,\n // (2) the runtime behavior is identical regardless of which overload matched.\n // TODO: Consider using a conditional type or branded types to create a single signature\n // that satisfies both overloads without casts. Alternatively, accept this as idiomatic\n // TypeScript for overloaded functions and keep the casts.\n return createCustomBuilderEntrypoint(query, customization)\n}\n\n// Overload 1: With constraint - preferred to preserve DataModel types\nexport function zCustomMutation<\n CustomArgsValidator extends PropertyValidators,\n CustomCtx extends Record<string, any>,\n CustomMadeArgs extends Record<string, any>,\n Builder extends (fn: any) => any,\n Visibility extends FunctionVisibility = 'public',\n ExtraArgs extends Record<string, any> = Record<string, any>\n>(\n mutation: Builder,\n customization: Customization<any, CustomArgsValidator, CustomCtx, CustomMadeArgs, ExtraArgs>\n): CustomBuilder<\n 'mutation',\n import('convex/values').ObjectType<CustomArgsValidator>,\n CustomCtx,\n CustomMadeArgs,\n ExtractCtx<Builder>,\n Visibility,\n ExtraArgs\n>\n\n// Implementation\nexport function zCustomMutation<\n CustomArgsValidator extends PropertyValidators,\n CustomCtx extends Record<string, any>,\n CustomMadeArgs extends Record<string, any>,\n Builder extends (fn: any) => any,\n _Visibility extends FunctionVisibility = 'public',\n ExtraArgs extends Record<string, any> = Record<string, any>\n>(\n mutation: Builder,\n customization: Customization<any, CustomArgsValidator, CustomCtx, CustomMadeArgs, ExtraArgs>\n) {\n // Cast justification: Same overload implementation pattern as zCustomQuery.\n // See detailed comment there. Type safety is enforced by the overload signature above.\n return createCustomBuilderEntrypoint(mutation, customization)\n}\n\n// Overload 1: With constraint - preferred to preserve DataModel types\nexport function zCustomAction<\n CustomArgsValidator extends PropertyValidators,\n CustomCtx extends Record<string, any>,\n CustomMadeArgs extends Record<string, any>,\n Builder extends (fn: any) => any,\n Visibility extends FunctionVisibility = 'public',\n ExtraArgs extends Record<string, any> = Record<string, any>\n>(\n action: Builder,\n customization: Customization<any, CustomArgsValidator, CustomCtx, CustomMadeArgs, ExtraArgs>\n): CustomBuilder<\n 'action',\n import('convex/values').ObjectType<CustomArgsValidator>,\n CustomCtx,\n CustomMadeArgs,\n ExtractCtx<Builder>,\n Visibility,\n ExtraArgs\n>\n\n// Implementation\nexport function zCustomAction<\n CustomArgsValidator extends PropertyValidators,\n CustomCtx extends Record<string, any>,\n CustomMadeArgs extends Record<string, any>,\n Builder extends (fn: any) => any,\n _Visibility extends FunctionVisibility = 'public',\n ExtraArgs extends Record<string, any> = Record<string, any>\n>(\n action: Builder,\n customization: Customization<any, CustomArgsValidator, CustomCtx, CustomMadeArgs, ExtraArgs>\n) {\n // Cast justification: Same overload implementation pattern as zCustomQuery.\n // See detailed comment there. Type safety is enforced by the overload signature above.\n return createCustomBuilderEntrypoint(action, customization)\n}\n","import type {\n FunctionVisibility,\n RegisteredAction,\n RegisteredMutation,\n RegisteredQuery\n} from 'convex/server'\nimport {\n assertFunctionSchemas,\n createConvexReturnsValidator,\n type DirectFunctionInput,\n finalizeFunctionReturn,\n normalizeDirectFunctionInput,\n parseFunctionArgsOrThrow\n} from './functionContracts'\n// Typing helpers to keep handler args/returns precise without deep remapping\nimport type {\n ExtractCtx,\n ExtractVisibility,\n InferHandlerReturns,\n InferReturns,\n ZodToConvexArgs\n} from './types'\nimport { $ZodType } from './zod-core'\n\nfunction registerZodFunction<\n Builder extends (fn: any) => any,\n A extends DirectFunctionInput,\n R extends $ZodType | undefined\n>(\n builder: Builder,\n input: A,\n handler: (\n ctx: ExtractCtx<Builder>,\n args: ZodToConvexArgs<A>\n ) => InferHandlerReturns<R> | Promise<InferHandlerReturns<R>>,\n options?: { returns?: R }\n): any {\n const { zodSchema, convexArgs } = normalizeDirectFunctionInput(input)\n const returnsSchema = options?.returns as $ZodType | undefined\n const returns = createConvexReturnsValidator(returnsSchema, { skipCustomSchemas: true })\n\n assertFunctionSchemas(zodSchema, returnsSchema)\n\n return builder({\n args: convexArgs,\n returns,\n handler: async (ctx: any, argsObject: unknown) => {\n const parsed = parseFunctionArgsOrThrow(zodSchema, argsObject)\n const raw = await handler(ctx, parsed)\n return finalizeFunctionReturn(raw, { returns: returnsSchema })\n }\n }) as any\n}\n\nexport function zQuery<\n Builder extends (fn: any) => any,\n A extends $ZodType | Record<string, $ZodType>,\n R extends $ZodType | undefined = undefined,\n Visibility extends FunctionVisibility = ExtractVisibility<Builder>\n>(\n query: Builder,\n input: A,\n handler: (\n ctx: ExtractCtx<Builder>,\n args: ZodToConvexArgs<A>\n ) => InferHandlerReturns<R> | Promise<InferHandlerReturns<R>>,\n options?: { returns?: R }\n): RegisteredQuery<Visibility, ZodToConvexArgs<A>, Promise<InferReturns<R>>> {\n return registerZodFunction(query, input, handler, options)\n}\n\nexport function zInternalQuery<\n Builder extends (fn: any) => any,\n A extends $ZodType | Record<string, $ZodType>,\n R extends $ZodType | undefined = undefined,\n Visibility extends FunctionVisibility = ExtractVisibility<Builder>\n>(\n internalQuery: Builder,\n input: A,\n handler: (\n ctx: ExtractCtx<Builder>,\n args: ZodToConvexArgs<A>\n ) => InferHandlerReturns<R> | Promise<InferHandlerReturns<R>>,\n options?: { returns?: R }\n): RegisteredQuery<Visibility, ZodToConvexArgs<A>, Promise<InferReturns<R>>> {\n return zQuery(internalQuery, input, handler, options)\n}\n\nexport function zMutation<\n Builder extends (fn: any) => any,\n A extends $ZodType | Record<string, $ZodType>,\n R extends $ZodType | undefined = undefined,\n Visibility extends FunctionVisibility = ExtractVisibility<Builder>\n>(\n mutation: Builder,\n input: A,\n handler: (\n ctx: ExtractCtx<Builder>,\n args: ZodToConvexArgs<A>\n ) => InferHandlerReturns<R> | Promise<InferHandlerReturns<R>>,\n options?: { returns?: R }\n): RegisteredMutation<Visibility, ZodToConvexArgs<A>, Promise<InferReturns<R>>> {\n return registerZodFunction(mutation, input, handler, options)\n}\n\nexport function zInternalMutation<\n Builder extends (fn: any) => any,\n A extends $ZodType | Record<string, $ZodType>,\n R extends $ZodType | undefined = undefined,\n Visibility extends FunctionVisibility = ExtractVisibility<Builder>\n>(\n internalMutation: Builder,\n input: A,\n handler: (\n ctx: ExtractCtx<Builder>,\n args: ZodToConvexArgs<A>\n ) => InferHandlerReturns<R> | Promise<InferHandlerReturns<R>>,\n options?: { returns?: R }\n): RegisteredMutation<Visibility, ZodToConvexArgs<A>, Promise<InferReturns<R>>> {\n return zMutation(internalMutation, input, handler, options)\n}\n\nexport function zAction<\n Builder extends (fn: any) => any,\n A extends $ZodType | Record<string, $ZodType>,\n R extends $ZodType | undefined = undefined,\n Visibility extends FunctionVisibility = ExtractVisibility<Builder>\n>(\n action: Builder,\n input: A,\n handler: (\n ctx: ExtractCtx<Builder>,\n args: ZodToConvexArgs<A>\n ) => InferHandlerReturns<R> | Promise<InferHandlerReturns<R>>,\n options?: { returns?: R }\n): RegisteredAction<Visibility, ZodToConvexArgs<A>, Promise<InferReturns<R>>> {\n return registerZodFunction(action, input, handler, options)\n}\n\nexport function zInternalAction<\n Builder extends (fn: any) => any,\n A extends $ZodType | Record<string, $ZodType>,\n R extends $ZodType | undefined = undefined,\n Visibility extends FunctionVisibility = ExtractVisibility<Builder>\n>(\n internalAction: Builder,\n input: A,\n handler: (\n ctx: ExtractCtx<Builder>,\n args: ZodToConvexArgs<A>\n ) => InferHandlerReturns<R> | Promise<InferHandlerReturns<R>>,\n options?: { returns?: R }\n): RegisteredAction<Visibility, ZodToConvexArgs<A>, Promise<InferReturns<R>>> {\n return zAction(internalAction, input, handler, options) as any\n}\n","import type {\n FunctionVisibility,\n RegisteredAction,\n RegisteredMutation,\n RegisteredQuery\n} from 'convex/server'\nimport type { PropertyValidators } from 'convex/values'\nimport type { Customization } from 'convex-helpers/server/customFunctions'\nimport { type CustomBuilder, customFnBuilder } from './custom'\nimport { attachFunctionMeta } from './functionContracts'\nimport type {\n ExtractCtx,\n ExtractVisibility,\n InferHandlerReturns,\n InferReturns,\n ZodToConvexArgs\n} from './types'\nimport { zAction, zMutation, zQuery } from './wrappers'\nimport { $ZodType } from './zod-core'\n\ntype BuilderConfig<\n Builder extends (fn: any) => any,\n A extends $ZodType | Record<string, $ZodType> | undefined,\n R extends $ZodType | undefined\n> = {\n args?: A\n handler: (\n ctx: ExtractCtx<Builder>,\n args: ZodToConvexArgs<A extends undefined ? Record<string, never> : A>\n ) => InferHandlerReturns<R> | Promise<InferHandlerReturns<R>>\n returns?: R\n}\n\nfunction registerBuilderFunction<\n Builder extends (fn: any) => any,\n A extends $ZodType | Record<string, $ZodType> | undefined,\n R extends $ZodType | undefined,\n Result\n>(\n register: (\n builder: Builder,\n input: A extends undefined ? Record<string, never> : A,\n handler: (\n ctx: ExtractCtx<Builder>,\n args: ZodToConvexArgs<A extends undefined ? Record<string, never> : A>\n ) => InferHandlerReturns<R> | Promise<InferHandlerReturns<R>>,\n options: { returns?: R }\n ) => Result,\n builder: Builder,\n config: BuilderConfig<Builder, A, R>\n): Result {\n const result = register(builder, (config.args ?? ({} as any)) as any, config.handler, {\n returns: config.returns\n })\n attachFunctionMeta(result as object, config.args, config.returns)\n return result\n}\n\nfunction createDirectBuilderFactory(\n register: (builder: any, input: any, handler: any, options: any) => any\n) {\n return function directBuilderFactory<Builder extends (fn: any) => any>(builder: Builder) {\n return <\n A extends $ZodType | Record<string, $ZodType>,\n R extends $ZodType | undefined = undefined\n >(\n config: BuilderConfig<Builder, A, R>\n ): any => registerBuilderFunction(register as any, builder, config) as any\n }\n}\n\nfunction createCustomBuilderFactory() {\n return function customBuilderFactory<\n Builder extends (fn: any) => any,\n CustomArgsValidator extends PropertyValidators,\n CustomCtx extends Record<string, any>,\n CustomMadeArgs extends Record<string, any>,\n Visibility extends FunctionVisibility = ExtractVisibility<Builder>,\n ExtraArgs extends Record<string, any> = Record<string, any>\n >(\n builder: Builder,\n customization: Customization<any, CustomArgsValidator, CustomCtx, CustomMadeArgs, ExtraArgs>\n ): CustomBuilder<\n 'query' | 'mutation' | 'action',\n CustomArgsValidator,\n CustomCtx,\n CustomMadeArgs,\n ExtractCtx<Builder>,\n Visibility,\n ExtraArgs\n > {\n return customFnBuilder<any, Builder, CustomArgsValidator, CustomCtx, CustomMadeArgs, ExtraArgs>(\n builder as any,\n customization as any\n ) as any\n }\n}\n\n/**\n * Creates a reusable query builder from a Convex query builder.\n * Returns a builder function that accepts Convex-style config objects with args, handler, and returns.\n *\n * @deprecated Use `initZodvex()` which returns `{ zq }` with built-in codec DB wrapping.\n *\n * @example\n * ```ts\n * import { query } from './_generated/server'\n * import { zQueryBuilder } from 'zodvex/server'\n *\n * // Create a reusable builder\n * export const zq = zQueryBuilder(query)\n *\n * // Use it with Convex-style object syntax\n * export const getUser = zq({\n * args: { id: z.string() },\n * handler: async (ctx, { id }) => {\n * return ctx.db.get(id)\n * }\n * })\n * ```\n */\nexport function zQueryBuilder<Builder extends (fn: any) => any>(builder: Builder) {\n return createDirectBuilderFactory(zQuery)(builder) as any\n}\n\n/**\n * Creates a reusable mutation builder from a Convex mutation builder.\n * Returns a builder function that accepts Convex-style config objects with args, handler, and returns.\n *\n * @deprecated Use `initZodvex()` which returns `{ zm }` with built-in codec DB wrapping.\n *\n * @example\n * ```ts\n * import { mutation } from './_generated/server'\n * import { zMutationBuilder } from 'zodvex/server'\n *\n * // Create a reusable builder\n * export const zm = zMutationBuilder(mutation)\n *\n * // Use it with Convex-style object syntax\n * export const updateUser = zm({\n * args: { id: z.string(), name: z.string() },\n * handler: async (ctx, { id, name }) => {\n * return ctx.db.patch(id, { name })\n * }\n * })\n * ```\n */\nexport function zMutationBuilder<Builder extends (fn: any) => any>(builder: Builder) {\n return createDirectBuilderFactory(zMutation)(builder) as any\n}\n\n/**\n * Creates a reusable action builder from a Convex action builder.\n * Returns a builder function that accepts Convex-style config objects with args, handler, and returns.\n *\n * @deprecated Use `initZodvex()` which returns `{ za }` with built-in codec DB wrapping.\n *\n * @example\n * ```ts\n * import { action } from './_generated/server'\n * import { zActionBuilder } from 'zodvex/server'\n *\n * // Create a reusable builder\n * export const za = zActionBuilder(action)\n *\n * // Use it with Convex-style object syntax\n * export const sendEmail = za({\n * args: { to: z.string().email(), subject: z.string() },\n * handler: async (ctx, { to, subject }) => {\n * // Send email\n * }\n * })\n * ```\n */\nexport function zActionBuilder<Builder extends (fn: any) => any>(builder: Builder) {\n return createDirectBuilderFactory(zAction)(builder) as any\n}\n\n/**\n * Creates a custom query builder with context injection from a Convex query builder.\n * Allows you to add custom context (like auth, permissions, etc.) to your queries.\n *\n * @deprecated Use `initZodvex()` and `zq.withContext()` instead.\n *\n * @example\n * ```ts\n * import { type QueryCtx, query } from './_generated/server'\n * import { zCustomQueryBuilder, customCtx } from 'zodvex/server'\n *\n * // Create a builder with auth context\n * export const authQuery = zCustomQueryBuilder(\n * query,\n * customCtx(async (ctx: QueryCtx) => {\n * const user = await getUserOrThrow(ctx)\n * return { user }\n * })\n * )\n *\n * // Use it with automatic user injection\n * export const getMyProfile = authQuery({\n * args: {},\n * handler: async (ctx) => {\n * // ctx.user is automatically available\n * return ctx.db.get(ctx.user._id)\n * }\n * })\n * ```\n */\nexport function zCustomQueryBuilder<\n Builder extends (fn: any) => any,\n CustomArgsValidator extends PropertyValidators,\n CustomCtx extends Record<string, any>,\n CustomMadeArgs extends Record<string, any>,\n Visibility extends FunctionVisibility = ExtractVisibility<Builder>,\n ExtraArgs extends Record<string, any> = Record<string, any>\n>(\n query: Builder,\n customization: Customization<any, CustomArgsValidator, CustomCtx, CustomMadeArgs, ExtraArgs>\n): CustomBuilder<\n 'query',\n CustomArgsValidator,\n CustomCtx,\n CustomMadeArgs,\n ExtractCtx<Builder>,\n Visibility,\n ExtraArgs\n> {\n return createCustomBuilderFactory()(query, customization) as any\n}\n\n/**\n * Creates a custom mutation builder with context injection from a Convex mutation builder.\n * Allows you to add custom context (like auth, permissions, etc.) to your mutations.\n *\n * @deprecated Use `initZodvex()` and `zm.withContext()` instead.\n *\n * @example\n * ```ts\n * import { type MutationCtx, mutation } from './_generated/server'\n * import { zCustomMutationBuilder, customCtx } from 'zodvex/server'\n *\n * // Create a builder with auth context\n * export const authMutation = zCustomMutationBuilder(\n * mutation,\n * customCtx(async (ctx: MutationCtx) => {\n * const user = await getUserOrThrow(ctx)\n * return { user }\n * })\n * )\n *\n * // Use it with automatic user injection\n * export const updateProfile = authMutation({\n * args: { name: z.string() },\n * handler: async (ctx, { name }) => {\n * // ctx.user is automatically available\n * await ctx.db.patch(ctx.user._id, { name })\n * }\n * })\n * ```\n */\nexport function zCustomMutationBuilder<\n Builder extends (fn: any) => any,\n CustomArgsValidator extends PropertyValidators,\n CustomCtx extends Record<string, any>,\n CustomMadeArgs extends Record<string, any>,\n Visibility extends FunctionVisibility = ExtractVisibility<Builder>,\n ExtraArgs extends Record<string, any> = Record<string, any>\n>(\n mutation: Builder,\n customization: Customization<any, CustomArgsValidator, CustomCtx, CustomMadeArgs, ExtraArgs>\n): CustomBuilder<\n 'mutation',\n CustomArgsValidator,\n CustomCtx,\n CustomMadeArgs,\n ExtractCtx<Builder>,\n Visibility,\n ExtraArgs\n> {\n return createCustomBuilderFactory()(mutation, customization) as any\n}\n\n/**\n * Creates a custom action builder with context injection from a Convex action builder.\n * Allows you to add custom context (like auth, permissions, etc.) to your actions.\n *\n * @deprecated Use `initZodvex()` and `za.withContext()` instead.\n *\n * @example\n * ```ts\n * import { type ActionCtx, action } from './_generated/server'\n * import { zCustomActionBuilder, customCtx } from 'zodvex/server'\n *\n * // Create a builder with auth context\n * export const authAction = zCustomActionBuilder(\n * action,\n * customCtx(async (ctx: ActionCtx) => {\n * const identity = await ctx.auth.getUserIdentity()\n * if (!identity) throw new Error('Unauthorized')\n * return { userId: identity.subject }\n * })\n * )\n *\n * // Use it with automatic auth injection\n * export const sendEmail = authAction({\n * args: { to: z.string().email() },\n * handler: async (ctx, { to }) => {\n * // ctx.userId is automatically available\n * await sendEmailService(to, ctx.userId)\n * }\n * })\n * ```\n */\nexport function zCustomActionBuilder<\n Builder extends (fn: any) => any,\n CustomArgsValidator extends PropertyValidators,\n CustomCtx extends Record<string, any>,\n CustomMadeArgs extends Record<string, any>,\n Visibility extends FunctionVisibility = ExtractVisibility<Builder>,\n ExtraArgs extends Record<string, any> = Record<string, any>\n>(\n action: Builder,\n customization: Customization<any, CustomArgsValidator, CustomCtx, CustomMadeArgs, ExtraArgs>\n): CustomBuilder<\n 'action',\n CustomArgsValidator,\n CustomCtx,\n CustomMadeArgs,\n ExtractCtx<Builder>,\n Visibility,\n ExtraArgs\n> {\n return createCustomBuilderFactory()(action, customization) as any\n}\n","import { z } from 'zod'\nimport { zodToConvex } from './mapping'\nimport { assertNoNativeZodDate } from './schema/dateGuards'\nimport { stripUndefined } from './stripUndefined'\nimport { type ZodvexCodec } from './types'\nimport {\n $ZodObject,\n $ZodOptional,\n $ZodType,\n encode,\n parse,\n type infer as zinfer,\n type input as zinput,\n type output as zoutput\n} from './zod-core'\n\n// Re-export ZodvexCodec type for convenience\nexport { type ZodvexCodec } from './types'\n\n/** @deprecated Use `initZodvex` or `decodeDoc`/`encodeDoc` instead. Will be removed in a future release. */\nexport type ConvexCodec<T> = {\n validator: any\n encode: (value: T) => any\n decode: (value: any) => T\n pick: <K extends keyof T>(keys: K[]) => ConvexCodec<Pick<T, K>>\n}\n\n/** @deprecated Use `initZodvex` or `decodeDoc`/`encodeDoc` instead. Will be removed in a future release. */\nexport function convexCodec<T>(schema: $ZodType<T>): ConvexCodec<T> {\n // Fail fast if z.date() is used - it won't encode correctly\n // Use zx.date() instead for Date ↔ timestamp conversion\n assertNoNativeZodDate(schema as $ZodType, 'schema')\n\n const validator = zodToConvex(schema)\n\n return {\n validator,\n // Strip undefined to ensure Convex-safe output (Convex rejects explicit undefined)\n encode: (value: T) => stripUndefined(encode(schema, value)),\n decode: (value: any) => parse(schema, value),\n pick: <K extends keyof T>(keys: K[] | Record<K, true>) => {\n if (!(schema instanceof $ZodObject)) {\n throw new Error('pick() can only be called on object schemas')\n }\n // Handle both array and object formats\n // Use manual shape extraction instead of .pick() — not available on zod/mini\n const pickKeys = Array.isArray(keys) ? keys : (Object.keys(keys) as K[])\n const shape = (schema as any)._zod.def.shape\n const pickedShape: Record<string, any> = {}\n for (const k of pickKeys) {\n if (k in shape) pickedShape[k as string] = shape[k as string]\n }\n const pickedSchema = z.object(pickedShape)\n return convexCodec(pickedSchema) as ConvexCodec<Pick<T, K>>\n }\n }\n}\n\n/**\n * Decodes a wire-format document (from Convex DB) to runtime types.\n * Runs Zod codec decode transforms (e.g., timestamp → Date via zx.date()).\n */\nexport function decodeDoc<S extends $ZodType>(schema: S, wireDoc: unknown): zoutput<S> {\n return parse(schema, wireDoc)\n}\n\n/**\n * Encodes a runtime document to wire format (for Convex DB writes).\n * Runs Zod codec encode transforms and strips undefined values.\n */\nexport function encodeDoc<S extends $ZodType>(schema: S, runtimeDoc: zoutput<S>): zinput<S> {\n return stripUndefined(encode(schema, runtimeDoc))\n}\n\n/**\n * Encodes a partial runtime document to wire format (for Convex DB patch operations).\n * Only encodes the fields present in the partial. Uses schema.partial() + z.encode().\n */\nexport function encodePartialDoc<S extends $ZodType>(\n schema: S,\n partial: Partial<zoutput<S>>\n): Partial<zinput<S>> {\n if (!(schema instanceof $ZodObject)) {\n // For non-object schemas (unions, etc.), fall back to full encode\n // Cast needed: Partial<output<S>> is structurally compatible but not assignable to output<S>\n return stripUndefined(encode(schema, partial as zoutput<S>)) as Partial<zinput<S>>\n }\n // Use manual shape wrapping instead of .partial() — not available on zod/mini\n const shape = (schema as any)._zod.def.shape\n const partialShape: Record<string, any> = {}\n for (const [key, value] of Object.entries(shape)) {\n partialShape[key] =\n value instanceof $ZodOptional\n ? value\n : new $ZodOptional({ type: 'optional', innerType: value as any })\n }\n const partialSchema = z.object(partialShape)\n return stripUndefined(encode(partialSchema, partial)) as Partial<zinput<S>>\n}\n\n/**\n * Creates a branded ZodCodec for use with zodvex type inference.\n * Thin wrapper around z.codec() that adds type branding, allowing\n * ConvexValidatorFromZod to extract the wire schema even when the\n * codec is wrapped in a custom type alias.\n *\n * @example\n * ```typescript\n * type MyCodec = ZodvexCodec<z.ZodObject<{ ts: z.ZodNumber }>, z.ZodCustom<Date>> // zod-ok\n *\n * function myCodec(): MyCodec {\n * return zodvexCodec(\n * z.object({ ts: z.number() }),\n * z.custom<Date>(() => true),\n * {\n * decode: (wire) => new Date(wire.ts),\n * encode: (date) => ({ ts: date.getTime() })\n * }\n * )\n * }\n * ```\n */\nexport function zodvexCodec<\n W extends $ZodType,\n R extends $ZodType,\n WO = zoutput<W>,\n RI = zoutput<R>\n>(\n wire: W,\n runtime: R,\n transforms: {\n decode: (wire: WO) => RI\n encode: (runtime: RI) => WO\n }\n): ZodvexCodec<W, R> {\n // Cast transforms to satisfy Zod's internal MaybeAsync typing while keeping our API simple\n return z.codec(wire as any, runtime as any, transforms as any) as unknown as ZodvexCodec<W, R>\n}\n","/**\n * zx - zodvex extended validators\n *\n * A namespace for zodvex-specific validators and codecs that handle\n * Convex wire format transformations. The \"zx\" prefix signals:\n * - \"zodvex\" or \"zod + convex\" extended types\n * - Explicit transformations (not magic)\n * - Discoverable via IDE autocomplete on `zx.`\n *\n * @example\n * ```typescript\n * import { z } from 'zod'\n * import { zx } from 'zodvex'\n *\n * const userShape = {\n * name: z.string(), // Standard Zod\n * createdAt: zx.date(), // zodvex: Date ↔ timestamp\n * teamId: zx.id('teams'), // zodvex: Convex ID\n * }\n * ```\n */\n\nimport type { GenericId } from 'convex/values'\nimport { z } from 'zod'\nimport { zodvexCodec } from './codec'\nimport { registryHelpers } from './ids'\nimport { attachCodecBrand } from './meta'\nimport { createSchemaUpdateSchema } from './modelSchemaBundle'\nimport { addSystemFields } from './schemaHelpers'\nimport type { ZodvexCodec } from './types'\nimport {\n type $ZodCustom,\n $ZodNullable,\n type $ZodNumber,\n $ZodOptional,\n type $ZodType,\n $ZodType as $ZodTypeValue,\n type output as zoutput\n} from './zod-core'\n\n/**\n * Date codec type for explicit type annotations\n */\nexport type FullZodvexCodec<W extends $ZodType, R extends $ZodType> = z.ZodCodec<W, R> &\n ZodvexCodec<W, R>\n\nexport type ZxDate = FullZodvexCodec<$ZodNumber, $ZodCustom<Date, Date>>\n\n/**\n * Creates a Date codec that transforms between Date objects and timestamps.\n *\n * Wire format: number (Unix timestamp in milliseconds)\n * Runtime format: Date object\n *\n * @example\n * ```typescript\n * const schema = z.object({\n * createdAt: zx.date(),\n * updatedAt: zx.date().optional(),\n * })\n * ```\n */\nfunction date(): ZxDate {\n return zodvexCodec(\n z.number(), // Wire: timestamp\n z.custom<Date>(val => val instanceof Date, {\n message: 'Expected Date instance'\n }),\n {\n decode: (timestamp: number) => new Date(timestamp),\n encode: (date: Date) => date.getTime()\n }\n ) as unknown as ZxDate\n}\n\n/**\n * ID type for explicit type annotations\n */\nexport type ZxId<TableName extends string> = z.ZodString &\n z.ZodType<GenericId<TableName>> & {\n _tableName: TableName\n }\n\n/**\n * Creates a Convex ID validator for a specific table.\n *\n * Wire format: string (Convex ID)\n * Runtime format: GenericId<TableName> (branded string type)\n *\n * Note: Unlike zx.date(), IDs don't require runtime transformation since\n * GenericId<T> is a branded string type. The branding is purely type-level.\n *\n * @param tableName - The Convex table name for this ID\n *\n * @example\n * ```typescript\n * const schema = z.object({\n * userId: zx.id('users'),\n * teamId: zx.id('teams').optional(),\n * })\n * ```\n */\nfunction id<TableName extends string>(tableName: TableName): ZxId<TableName> {\n // Create base string validator with refinement\n const baseSchema = z.string().check(\n z.refine(val => typeof val === 'string' && val.length > 0, {\n message: `Invalid ID for table \"${tableName}\"`\n }),\n z.describe(`convexId:${tableName}`)\n )\n\n // Store metadata for registry lookup so mapping can convert to v.id(tableName)\n registryHelpers.setMetadata(baseSchema, {\n isConvexId: true,\n tableName\n })\n\n // Add the tableName property for type-level detection\n const branded = baseSchema as any\n branded._tableName = tableName\n\n return branded as ZxId<TableName>\n}\n\n/**\n * Creates a custom codec for transforming between wire and runtime formats.\n *\n * Use this when you need custom transformations beyond the built-in helpers.\n *\n * @param wire - Zod schema for the wire format (stored in Convex)\n * @param runtime - Zod schema for the runtime format (used in code)\n * @param transforms - Encode/decode functions\n * @param opts.brand - Optional provenance brand. When set, codegen matches a\n * function-embedded instance of this codec to its importable twin (an\n * exported const or model field with the same brand) by *declared* identity\n * rather than inferring it from structure — collision-free and namespaced\n * across factories. Useful for codec factories like `tagged()` / `sensitive()`\n * whose every call returns a fresh instance. See\n * `docs/decisions/2026-06-08-codec-provenance-brands.md`.\n *\n * @example\n * ```typescript\n * // Encrypted data codec\n * const encryptedString = zx.codec(\n * z.object({ encrypted: z.string() }), // Wire format\n * z.custom<string>(() => true), // Runtime format\n * {\n * decode: (wire) => decrypt(wire.encrypted),\n * encode: (value) => ({ encrypted: encrypt(value) })\n * }\n * )\n *\n * // Branded factory codec — codegen matches inline instances by brand\n * function tagged(inner, name) {\n * return zx.codec(wire(inner), runtime(inner), transforms, { brand: `tagged:${name}` })\n * }\n * ```\n */\nfunction codec<W extends $ZodType, R extends $ZodType, WO = zoutput<W>, RI = zoutput<R>>(\n wire: W,\n runtime: R,\n transforms: {\n decode: (wire: WO) => RI\n encode: (runtime: RI) => WO\n },\n opts?: { brand?: string }\n): FullZodvexCodec<W, R> {\n const built = zodvexCodec(wire, runtime, transforms) as unknown as FullZodvexCodec<W, R>\n if (opts?.brand) attachCodecBrand(built as object, opts.brand)\n return built\n}\n\n/**\n * Minimal model shape accepted by zx helpers.\n * Both full and slim models satisfy this at runtime.\n */\ntype ZxModelInput = {\n readonly name: string\n readonly fields: Record<string, $ZodType>\n readonly schema?: unknown\n}\n\n/**\n * Per-model caches so repeated `zx.doc(model)` / `zx.base(model)` / etc. calls\n * across call sites share a single Zod schema instance.\n *\n * Caches are keyed on a stable identity that survives chain methods\n * (`.index()`, `.searchIndex()`, `.vectorIndex()`), which return new model\n * objects but preserve `fields` (object slim) and `schema` (union slim) by\n * reference. Keying on the model object would force every chain step to\n * re-allocate.\n *\n * Full models bypass these caches entirely — they carry a pre-built schema\n * bundle, and `zx.*(fullModel)` returns the bundle's schema directly so\n * identity matches `fullModel.schema.{doc,base,...}`.\n *\n * The cache maps are pinned to `globalThis` under a `Symbol.for` registry so\n * multiple bundled copies of this module share state. tsup splits each entry\n * into its own bundle (CLI, codegen, main, server, …), duplicating this file\n * per entry. Without the shared registry, `zx.doc(Model)` in user code\n * (loaded from `dist/index.js`) and `zx.doc(ref)` in codegen (loaded from\n * `dist/cli/index.js`) would write to distinct WeakMaps, producing different\n * instances for the same model — identity matching would silently fail.\n */\nfunction sharedWeakMap(name: string): WeakMap<object, $ZodType> {\n const key = Symbol.for(`zodvex.zx.cache.${name}`)\n const g = globalThis as unknown as Record<symbol, WeakMap<object, $ZodType>>\n const existing = g[key]\n if (existing) return existing\n const created = new WeakMap<object, $ZodType>()\n g[key] = created\n return created\n}\n\nconst baseCache = sharedWeakMap('base')\nconst docCache = sharedWeakMap('doc')\nconst updateCache = sharedWeakMap('update')\nconst docArrayCache = sharedWeakMap('docArray')\n\n/**\n * Stable cache key for slim models:\n * - union slim → the user-supplied schema (preserved across chains)\n * - object slim → the fields record (preserved across chains)\n */\nfunction slimCacheKey(model: ZxModelInput): object {\n const s = model.schema as any\n return s instanceof $ZodTypeValue ? s : model.fields\n}\n\n/**\n * Returns the base schema for a model — the user fields as a Zod object (or the\n * user-supplied union for discriminated-union models).\n *\n * Full models: returns the bundle's pre-built `.base` (no allocation).\n * Union slim: returns the user's schema (no allocation — it IS the base).\n * Object slim: builds `z.object(fields)` once, cached on `fields`.\n */\nfunction base(model: ZxModelInput): $ZodType {\n const s = model.schema as any\n if (s?.base instanceof $ZodTypeValue) return s.base\n if (s instanceof $ZodTypeValue) return s\n const cached = baseCache.get(model.fields)\n if (cached) return cached\n if (Object.keys(model.fields).length === 0) {\n throw new Error(`[zodvex] Cannot derive base schema for model '${model.name}'`)\n }\n const built = z.object(model.fields) as any\n baseCache.set(model.fields, built)\n return built\n}\n\n/**\n * Constructs a doc schema: base fields + _id + _creationTime.\n * Full models reuse `model.schema.doc`; slim models cache on slimCacheKey(model).\n */\nfunction doc(model: ZxModelInput) {\n const s = model.schema as any\n if (s?.doc instanceof $ZodTypeValue) return s.doc\n const key = slimCacheKey(model)\n const cached = docCache.get(key)\n if (cached) return cached\n const built = addSystemFields(model.name, base(model)) as any\n docCache.set(key, built)\n return built\n}\n\n/**\n * Constructs an update schema: _id required + _creationTime optional + all user fields optional.\n * Full models reuse `model.schema.update`; slim models cache on slimCacheKey(model).\n */\nfunction update(model: ZxModelInput) {\n const s = model.schema as any\n if (s?.update instanceof $ZodTypeValue) return s.update\n const key = slimCacheKey(model)\n const cached = updateCache.get(key)\n if (cached) return cached\n const built = createSchemaUpdateSchema(model.name, base(model)) as any\n updateCache.set(key, built)\n return built\n}\n\n/**\n * Constructs a doc array schema: z.array(doc(model)).\n * Full models reuse `model.schema.docArray`; slim models cache on slimCacheKey(model).\n */\nfunction docArray(model: ZxModelInput) {\n const s = model.schema as any\n if (s?.docArray instanceof $ZodTypeValue) return s.docArray\n const key = slimCacheKey(model)\n const cached = docArrayCache.get(key)\n if (cached) return cached\n const built = z.array(doc(model)) as any\n docArrayCache.set(key, built)\n return built\n}\n\n/** Wrap in .nullable() using core constructor for zod-mini compat. */\nfunction nullable(schema: $ZodType): $ZodType {\n return new $ZodNullable({ type: 'nullable', innerType: schema }) as any\n}\n\n/** Wrap in .optional() using core constructor for zod-mini compat. */\nfunction optional(schema: $ZodType): $ZodType {\n return new $ZodOptional({ type: 'optional', innerType: schema }) as any\n}\n\n/** Wrap in .nullable().optional() using core constructors for zod-mini compat. */\nfunction nullableOptional(schema: $ZodType): $ZodType {\n return optional(nullable(schema))\n}\n\n/**\n * Pagination options schema — matches Convex's PaginationOptions type.\n */\nfunction paginationOpts() {\n return z.object({\n numItems: z.number(),\n cursor: nullable(z.string()),\n endCursor: nullableOptional(z.string()),\n id: optional(z.number()),\n maximumRowsRead: optional(z.number()),\n maximumBytesRead: optional(z.number())\n })\n}\n\n/**\n * Paginated result schema — wraps any item schema in Convex's PaginationResult shape.\n */\nfunction paginationResult<T extends $ZodType>(itemSchema: T) {\n return z.object({\n page: z.array(itemSchema),\n isDone: z.boolean(),\n continueCursor: z.string(),\n splitCursor: nullableOptional(z.string()),\n pageStatus: nullableOptional(z.enum(['SplitRecommended', 'SplitRequired']))\n })\n}\n\n/**\n * zx namespace - zodvex extended validators\n *\n * Provides explicit, discoverable helpers for Convex-specific transformations.\n */\nexport const zx = {\n /**\n * Date ↔ timestamp codec\n * @see {@link date}\n */\n date,\n\n /**\n * Convex ID validator\n * @see {@link id}\n */\n id,\n\n /**\n * Custom codec builder\n * @see {@link codec}\n */\n codec,\n\n /**\n * Pagination options schema matching Convex's PaginationOptions type\n * @see {@link paginationOpts}\n */\n paginationOpts,\n\n /**\n * Paginated result schema wrapping any item schema in Convex's PaginationResult shape\n * @see {@link paginationResult}\n */\n paginationResult,\n\n /**\n * Base schema for a model (user fields only; no system fields).\n * For object models reconstructs from fields; for union models returns the\n * user-supplied union. Cached per-model.\n * @see {@link base}\n */\n base,\n\n /**\n * Doc schema: model fields + _id + _creationTime\n * @see {@link doc}\n */\n doc,\n\n /**\n * Update schema: _id required, all other fields optional\n * @see {@link update}\n */\n update,\n\n /**\n * Doc array schema: z.array(doc(model))\n * @see {@link docArray}\n */\n docArray\n} as const\n","/**\n * Schema helpers — Pure Zod utilities for union handling and system fields.\n *\n * This module contains helpers extracted from tables.ts that have NO server\n * dependencies (no convex/server, no convex-helpers/server). They are safe\n * to import from zodvex (client-side code).\n *\n * Used by:\n * - model.ts (defineZodModel) — client-safe model definitions\n * - tables.ts (zodTable) — server-side table definitions\n */\n\nimport { z } from 'zod'\nimport {\n $ZodArray,\n $ZodDiscriminatedUnion,\n $ZodNumber,\n $ZodObject,\n type $ZodShape,\n $ZodType,\n $ZodUnion,\n clone\n} from './zod-core'\nimport { type ZxId, zx } from './zx'\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Helper type for Convex system fields added to documents\n */\nexport type SystemFields<TableName extends string> = {\n _id: ZxId<TableName>\n _creationTime: $ZodNumber\n}\n\n/**\n * Maps over union options, extending each ZodObject variant with system fields.\n * Non-object variants are preserved as-is.\n */\nexport type MapSystemFields<TableName extends string, Options extends readonly $ZodType[]> = {\n [K in keyof Options]: Options[K] extends z.ZodObject<infer Shape extends $ZodShape> // zod-ok\n ? z.ZodObject<Shape & SystemFields<TableName>> // zod-ok\n : Options[K]\n}\n\n/**\n * Core-compatible version of MapSystemFields.\n * Uses $ZodObject from zod/v4/core instead of z.ZodObject from full zod. // zod-ok\n */\nexport type MapSystemFieldsCore<TableName extends string, Options extends readonly $ZodType[]> = {\n [K in keyof Options]: Options[K] extends $ZodObject<infer Shape extends $ZodShape>\n ? $ZodObject<Shape & SystemFields<TableName>>\n : Options[K]\n}\n\n/**\n * Computes the result of adding system fields to a union/object schema.\n * Uses only $Zod* types from zod/v4/core — safe for shared code and mini consumers.\n *\n * Handles:\n * - $ZodObject → $ZodObject with system fields\n * - $ZodUnion → $ZodUnion with system fields on each variant\n * - $ZodDiscriminatedUnion → $ZodDiscriminatedUnion with system fields on each variant\n * - Other → returned as-is\n */\nexport type AddSystemFieldsToUnion<TableName extends string, Schema extends $ZodType> =\n Schema extends $ZodObject<infer Shape extends $ZodShape>\n ? $ZodObject<Shape & SystemFields<TableName>>\n : Schema extends $ZodUnion<infer Options extends readonly $ZodType[]>\n ? $ZodUnion<MapSystemFieldsCore<TableName, Options>>\n : Schema extends $ZodDiscriminatedUnion<\n infer Options extends readonly $ZodType[],\n infer Disc extends string\n >\n ? $ZodDiscriminatedUnion<MapSystemFieldsCore<TableName, Options>, Disc>\n : Schema\n\n/**\n * Minimum tuple type required by z.union() - at least 2 elements.\n */\ntype UnionTuple<T extends $ZodType = $ZodType> = readonly [T, T, ...T[]]\n\n// ============================================================================\n// Union Helpers - Type-safe utilities for working with Zod unions\n// ============================================================================\n\n/** Full-zod union type alias used by isZodUnion/getUnionOptions — zod-ok by design. */\ntype AnyZodUnion =\n // zod-ok\n | z.ZodUnion<readonly $ZodType[]> // zod-ok\n | z.ZodDiscriminatedUnion<readonly z.ZodObject<$ZodShape>[], string> // zod-ok\n\n/**\n * Type guard to check if a schema is a union type (ZodUnion or ZodDiscriminatedUnion).\n */\nexport function isZodUnion(schema: $ZodType): schema is AnyZodUnion {\n return schema instanceof $ZodUnion || schema instanceof $ZodDiscriminatedUnion\n}\n\n/**\n * Extracts the options array from a ZodUnion or ZodDiscriminatedUnion.\n * Both union types have an `.options` property, but TypeScript doesn't\n * create a common accessor after instanceof checks.\n *\n * @param schema - A ZodUnion or ZodDiscriminatedUnion schema\n * @returns The array of union variant schemas\n */\nexport function getUnionOptions(schema: AnyZodUnion): readonly $ZodType[] {\n // $ZodDiscriminatedUnion extends $ZodUnion, so this covers both\n if (schema instanceof $ZodUnion) {\n return schema._zod.def.options\n }\n // cast: unreachable due to the union type constraint, but satisfies return type\n return (schema as any)._zod.def.options\n}\n\n/**\n * Asserts that an array has at least 2 elements, as required by z.union().\n * Throws an error if the array has fewer than 2 elements.\n *\n * @param options - Array of Zod schemas\n * @throws Error if array has fewer than 2 elements\n */\nexport function assertUnionOptions<T extends $ZodType>(\n options: readonly T[]\n): asserts options is UnionTuple<T> {\n if (options.length < 2) {\n throw new Error(\n `z.union() requires at least 2 options, but received ${options.length}. ` +\n 'This indicates an invalid union schema was passed to zodTable().'\n )\n }\n}\n\n/**\n * Creates a z.union() from an array of options with runtime validation.\n * Ensures the array has at least 2 elements as required by Zod.\n *\n * @param options - Array of Zod schemas (must have at least 2 elements)\n * @returns A ZodUnion schema\n * @throws Error if array has fewer than 2 elements\n */\n// Return type alias — prevents z.ZodUnion on a {-ending line (formatter-safe). // zod-ok\ntype ZodUnionOf<T extends $ZodType> = z.ZodUnion<UnionTuple<T>> // zod-ok\n\nexport function createUnionFromOptions<T extends $ZodType>(options: readonly T[]): ZodUnionOf<T> {\n assertUnionOptions(options)\n return z.union(options)\n}\n\n/**\n * Adds Convex system fields (_id, _creationTime) to a Zod schema.\n *\n * For object schemas: extends with system fields\n * For union schemas: adds system fields to each variant\n *\n * @param tableName - The Convex table name\n * @param schema - The Zod schema (object or union)\n * @returns Schema with system fields added\n */\n// Overload 1: ZodObject - extends with system fields\nexport function addSystemFields<TableName extends string, Shape extends $ZodShape>(\n tableName: TableName,\n schema: z.ZodObject<Shape> // zod-ok\n): z.ZodObject<Shape & SystemFields<TableName>> // zod-ok\n\n// Overload 2: ZodUnion - maps system fields to each variant\nexport function addSystemFields<TableName extends string, Options extends readonly $ZodType[]>(\n tableName: TableName,\n schema: z.ZodUnion<Options> // zod-ok\n): z.ZodUnion<MapSystemFields<TableName, Options>> // zod-ok\n\n// Overload 3: ZodDiscriminatedUnion - maps system fields preserving discriminator\n// Note: Zod v4 signature is ZodDiscriminatedUnion<Options, Discriminator>\nexport function addSystemFields<\n TableName extends string,\n Options extends readonly z.ZodObject<$ZodShape>[], // zod-ok\n Discriminator extends string\n>(\n tableName: TableName,\n schema: z.ZodDiscriminatedUnion<Options, Discriminator> // zod-ok\n): z.ZodDiscriminatedUnion<MapSystemFields<TableName, Options>, Discriminator> // zod-ok\n\n// Overload 4: Fallback for other ZodTypes - returns as-is\nexport function addSystemFields<TableName extends string, S extends $ZodType>(\n tableName: TableName,\n schema: S\n): S\n\n// Implementation\nexport function addSystemFields<TableName extends string>(\n tableName: TableName,\n schema: $ZodType\n): $ZodType {\n // Handle union schemas - add system fields to each variant\n if (isZodUnion(schema)) {\n const originalOptions = getUnionOptions(schema)\n const extendedOptions = originalOptions.map((variant: $ZodType) => {\n if (variant instanceof $ZodObject) {\n const newShape = {\n ...variant._zod.def.shape,\n _id: zx.id(tableName),\n _creationTime: z.number()\n }\n // Clone preserves the original's class + reinitializes with merged def\n return clone(variant, { ...variant._zod.def, shape: newShape })\n }\n // Non-object variants are returned as-is (shouldn't happen in practice)\n return variant\n })\n return createUnionFromOptions(extendedOptions)\n }\n\n // Handle object schemas — clone preserves class, checks, catchall, error\n if (schema instanceof $ZodObject) {\n const newShape = { ...schema._zod.def.shape, _id: zx.id(tableName), _creationTime: z.number() }\n return clone(schema, { ...schema._zod.def, shape: newShape })\n }\n\n // Fallback: return schema as-is\n return schema\n}\n","import { z } from 'zod'\nimport {\n addSystemFields,\n createUnionFromOptions,\n getUnionOptions,\n isZodUnion\n} from './schemaHelpers'\nimport { $ZodNullable, $ZodObject, $ZodOptional, type $ZodShape, $ZodType } from './zod-core'\nimport { zx } from './zx'\n\n// Return type alias so helper signatures don't expose full zod internals everywhere.\ntype AnyOptional = z.ZodOptional<any> // zod-ok\n\nexport type RuntimeModelSchemaBundle = {\n readonly doc: $ZodType\n readonly base: $ZodType\n readonly insert: $ZodType\n readonly update: $ZodType\n readonly docArray: $ZodType\n readonly paginatedDoc: $ZodType\n}\n\n/** Wrap in .optional() only if not already optional. Uses core constructor for zod-mini compat. */\nfunction ensureOptional(schema: $ZodType): AnyOptional {\n if (schema instanceof $ZodOptional) return schema as z.ZodOptional<any> // zod-ok\n return new $ZodOptional({ type: 'optional', innerType: schema }) as z.ZodOptional<any> // zod-ok\n}\n\n/** Wrap in .nullable().optional() using core constructors for zod-mini compat. */\nfunction nullableOptional(schema: $ZodType): $ZodType {\n return new $ZodOptional({\n type: 'optional',\n innerType: new $ZodNullable({ type: 'nullable', innerType: schema })\n }) as any\n}\n\nexport function createPartialShape(shape: Record<string, $ZodType>): Record<string, $ZodType> {\n const partialShape: Record<string, $ZodType> = {}\n for (const [key, value] of Object.entries(shape)) {\n partialShape[key] = ensureOptional(value)\n }\n return partialShape\n}\n\nexport function createUpdateObjectSchema<Name extends string>(\n name: Name,\n shape: Record<string, $ZodType>\n): z.ZodObject<any> {\n return z.object({\n _id: zx.id(name),\n _creationTime: z.optional(z.number()),\n ...createPartialShape(shape)\n })\n}\n\nexport function createPaginatedDocSchema(docSchema: $ZodType): z.ZodObject<any> {\n return z.object({\n page: z.array(docSchema),\n isDone: z.boolean(),\n continueCursor: z.string(),\n splitCursor: nullableOptional(z.string()),\n pageStatus: nullableOptional(z.enum(['SplitRecommended', 'SplitRequired']))\n })\n}\n\nexport function createObjectSchemaBundle<Name extends string>(\n name: Name,\n fields: $ZodShape,\n baseSchema: z.ZodObject<any> = z.object(fields)\n): RuntimeModelSchemaBundle {\n const docSchema = addSystemFields(name, baseSchema)\n\n return {\n doc: docSchema,\n base: baseSchema,\n insert: baseSchema,\n update: createUpdateObjectSchema(name, fields),\n docArray: z.array(docSchema),\n paginatedDoc: createPaginatedDocSchema(docSchema)\n }\n}\n\nexport function createSchemaUpdateSchema<Name extends string>(\n name: Name,\n inputSchema: $ZodType\n): $ZodType {\n if (isZodUnion(inputSchema)) {\n const updateOptions = getUnionOptions(inputSchema).map((variant: $ZodType) => {\n if (variant instanceof $ZodObject) {\n return createUpdateObjectSchema(name, variant._zod.def.shape)\n }\n return variant\n })\n return createUnionFromOptions(updateOptions)\n }\n\n if (inputSchema instanceof $ZodObject) {\n return createUpdateObjectSchema(name, inputSchema._zod.def.shape)\n }\n\n return inputSchema\n}\n\nexport function createSchemaBundle<Name extends string>(\n name: Name,\n inputSchema: $ZodType\n): RuntimeModelSchemaBundle {\n const docSchema = addSystemFields(name, inputSchema)\n\n return {\n doc: docSchema,\n base: inputSchema,\n insert: inputSchema,\n update: createSchemaUpdateSchema(name, inputSchema),\n docArray: z.array(docSchema),\n paginatedDoc: createPaginatedDocSchema(docSchema)\n }\n}\n","import { defineTable } from 'convex/server'\nimport type { GenericId } from 'convex/values'\nimport { Table } from 'convex-helpers/server'\nimport { z } from 'zod'\nimport {\n type ConvexValidatorFromZodFieldsAuto,\n zodToConvex,\n zodToConvexFields\n} from '../internal/mapping'\nimport { createObjectSchemaBundle, createSchemaBundle } from '../internal/modelSchemaBundle'\nimport { addSystemFields, type MapSystemFields, type SystemFields } from '../internal/schemaHelpers'\nimport { $ZodObject, type $ZodShape, $ZodType } from '../internal/zod-core'\nimport { type ZxId, zx } from '../internal/zx'\n\n/**\n * System fields added to Convex documents.\n */\ntype DocSystemFields<TableName extends string> = {\n _id: ZxId<TableName>\n _creationTime: z.ZodNumber\n}\n/**\n * Type for validators that can be used with Convex's defineTable.\n *\n * Convex's defineTable expects Validator<Record<string, any>, \"required\", any>,\n * but zodToConvex returns more specific types that TypeScript can't verify are\n * compatible. This type represents validators that produce object documents.\n *\n * @internal\n */\ntype TableValidator = Parameters<typeof defineTable>[0]\n\n/**\n * Asserts that a Convex validator can be used to define a table.\n *\n * This is needed because zodToConvex returns a specific validator type (like VUnion)\n * that TypeScript can't verify is assignable to defineTable's expected input type,\n * even though all union variants are objects that produce Record<string, any>.\n *\n * The runtime behavior is correct - Convex supports union validators in tables.\n * This is purely a TypeScript limitation with complex mapped types.\n *\n * @internal\n */\nfunction asTableValidator<V extends { kind: string }>(validator: V): TableValidator {\n return validator as unknown as TableValidator\n}\n\n/**\n * Creates a Zod schema for a Convex document with system fields.\n * Spreads the original def to preserve catchall, checks, and error settings.\n *\n * @deprecated Use `defineZodModel` instead. See `docs/migration/v0.6.md`.\n *\n * @param tableName - The Convex table name\n * @param schema - The Zod object schema for user fields\n * @returns A Zod object schema with _id and _creationTime added\n */\nexport function zodDoc<TableName extends string, Shape extends $ZodShape>(\n tableName: TableName,\n schema: z.ZodObject<Shape>\n): z.ZodObject<Shape & DocSystemFields<TableName>> {\n return addSystemFields(tableName, schema) as z.ZodObject<Shape & DocSystemFields<TableName>>\n}\n\n/**\n * @deprecated Use `defineZodModel` instead. See `docs/migration/v0.6.md`.\n */\nexport function zodDocOrNull<\n TableName extends string,\n Shape extends $ZodShape,\n Schema extends z.ZodObject<Shape>\n>(tableName: TableName, schema: Schema) {\n return z.union([zodDoc(tableName, schema), z.null()])\n}\n\n/**\n * Helper to detect if input is an object shape (plain object with Zod validators)\n */\nfunction isObjectShape(input: any): input is Record<string, $ZodType> {\n // Check if it's a plain object (not a Zod instance)\n if (!input || typeof input !== 'object') return false\n\n // If it's a Zod instance, it's not an object shape\n if (input instanceof $ZodType) return false\n\n // Check if all values are Zod types\n for (const key in input) {\n if (!(input[key] instanceof $ZodType)) {\n return false\n }\n }\n\n return true\n}\n\n/**\n * Defines a Convex table using either:\n * - A raw Zod shape (an object mapping field names to Zod types)\n * - A Zod union schema (for polymorphic tables)\n *\n * For object shapes, this function intentionally accepts a raw shape instead of a ZodObject instance.\n * Accepting raw shapes allows TypeScript to infer field types more accurately and efficiently,\n * leading to better type inference and performance throughout the codebase.\n *\n * For union schemas, this enables polymorphic tables with discriminated unions.\n *\n * Returns the Table definition along with Zod schemas for documents and arrays.\n *\n * @deprecated Use `defineZodModel` instead. See `docs/migration/v0.6.md`.\n *\n * @param name - The table name\n * @param schemaOrShape - Either a raw object shape or a Zod union schema\n * @returns A Table with attached helpers (shape, schema, zDoc, docArray, withSystemFields)\n *\n * @example Object shape\n * ```ts\n * const Users = zodTable('users', {\n * name: z.string(),\n * email: z.string().email(),\n * age: z.number().optional()\n * })\n *\n * // Use in schema\n * export default defineSchema({ users: Users.table })\n *\n * // Use for return types\n * export const getUsers = zQuery(query, {},\n * async (ctx) => ctx.db.query('users').collect(),\n * { returns: Users.docArray }\n * )\n * ```\n *\n * @example Union schema (polymorphic table)\n * ```ts\n * const shapeSchema = z.union([\n * z.object({ kind: z.literal('circle'), r: z.number() }),\n * z.object({ kind: z.literal('rectangle'), width: z.number() })\n * ])\n *\n * const Shapes = zodTable('shapes', shapeSchema)\n *\n * // Use in schema\n * export default defineSchema({ shapes: Shapes.table })\n *\n * // Use for return types with system fields\n * export const getShapes = zQuery(query, {},\n * async (ctx) => ctx.db.query('shapes').collect(),\n * { returns: Shapes.docArray }\n * )\n * ```\n */\n// Helper type to compute the result of addSystemFields for use in zodTable return type\ntype AddSystemFieldsResult<TableName extends string, Schema extends $ZodType> =\n Schema extends z.ZodObject<infer Shape extends z.ZodRawShape>\n ? z.ZodObject<Shape & SystemFields<TableName>>\n : Schema extends z.ZodUnion<infer Options extends readonly z.ZodTypeAny[]>\n ? z.ZodUnion<MapSystemFields<TableName, Options>>\n : Schema extends z.ZodDiscriminatedUnion<\n infer Options extends readonly z.ZodObject<z.ZodRawShape>[],\n infer Disc extends string\n >\n ? z.ZodDiscriminatedUnion<MapSystemFields<TableName, Options>, Disc>\n : Schema\n\n/**\n * Update schema shape: _id required, _creationTime optional, user fields partial\n */\ntype UpdateShape<TableName extends string, Shape extends z.ZodRawShape> = {\n _id: ZxId<TableName>\n _creationTime: z.ZodOptional<z.ZodNumber>\n} & {\n [K in keyof Shape]: z.ZodOptional<Shape[K]>\n}\n\n/**\n * Maps over union options for update schema.\n * Each variant gets _id required, _creationTime optional, and user fields partial.\n */\ntype MapUpdateVariants<TableName extends string, Options extends readonly z.ZodTypeAny[]> = {\n [K in keyof Options]: Options[K] extends z.ZodObject<infer Shape extends z.ZodRawShape>\n ? z.ZodObject<UpdateShape<TableName, Shape>>\n : Options[K]\n}\n\n/**\n * Computes the update schema type for a given schema.\n * Includes _id (required), _creationTime (optional), and partial user fields.\n * For unions: each variant gets update shape\n * For objects: the whole object gets update shape\n * For other types: returns as-is\n */\ntype UpdateSchemaType<TableName extends string, Schema extends $ZodType> =\n Schema extends z.ZodUnion<infer Options extends readonly z.ZodTypeAny[]>\n ? z.ZodUnion<MapUpdateVariants<TableName, Options>>\n : Schema extends z.ZodDiscriminatedUnion<\n infer Options extends readonly z.ZodObject<z.ZodRawShape>[],\n infer _Disc extends string\n >\n ? z.ZodUnion<MapUpdateVariants<TableName, Options>>\n : Schema extends z.ZodObject<infer Shape extends z.ZodRawShape>\n ? z.ZodObject<UpdateShape<TableName, Shape>>\n : Schema\n\n// Overload 1: Object shape (most common case - raw object with Zod validators)\nexport function zodTable<TableName extends string, Shape extends Record<string, $ZodType>>(\n name: TableName,\n shape: Shape\n): ReturnType<typeof Table<ConvexValidatorFromZodFieldsAuto<Shape>, TableName>> & {\n shape: Shape\n /** @deprecated Use `schema.doc` instead */\n zDoc: z.ZodObject<\n Shape & {\n _id: ZxId<TableName>\n _creationTime: z.ZodNumber\n }\n >\n /** @deprecated Use `schema.docArray` instead */\n docArray: z.ZodArray<\n z.ZodObject<\n Shape & {\n _id: ZxId<TableName>\n _creationTime: z.ZodNumber\n }\n >\n >\n schema: {\n doc: z.ZodObject<\n Shape & {\n _id: ZxId<TableName>\n _creationTime: z.ZodNumber\n }\n >\n docArray: z.ZodArray<\n z.ZodObject<\n Shape & {\n _id: ZxId<TableName>\n _creationTime: z.ZodNumber\n }\n >\n >\n /** Paginated result schema matching Convex's PaginationResult shape */\n paginatedDoc: z.ZodObject<{\n page: z.ZodArray<z.ZodObject<Shape & { _id: ZxId<TableName>; _creationTime: z.ZodNumber }>>\n isDone: z.ZodBoolean\n continueCursor: z.ZodOptional<z.ZodNullable<z.ZodString>>\n }>\n /** The base schema - user fields without system fields */\n base: z.ZodObject<Shape>\n /** Alias for base - user fields for insert operations */\n insert: z.ZodObject<Shape>\n /** Update schema - _id required, _creationTime optional, user fields partial */\n update: z.ZodObject<UpdateShape<TableName, Shape>>\n }\n}\n\n// Overload 2: ZodObject wrapper (extracts shape for same type inference as raw shape)\nexport function zodTable<TableName extends string, Shape extends $ZodShape>(\n name: TableName,\n schema: z.ZodObject<Shape>\n): ReturnType<typeof Table<ConvexValidatorFromZodFieldsAuto<Shape>, TableName>> & {\n shape: Shape\n /** @deprecated Use `schema.doc` instead */\n zDoc: z.ZodObject<\n Shape & {\n _id: ZxId<TableName>\n _creationTime: z.ZodNumber\n }\n >\n /** @deprecated Use `schema.docArray` instead */\n docArray: z.ZodArray<\n z.ZodObject<\n Shape & {\n _id: ZxId<TableName>\n _creationTime: z.ZodNumber\n }\n >\n >\n schema: {\n doc: z.ZodObject<\n Shape & {\n _id: ZxId<TableName>\n _creationTime: z.ZodNumber\n }\n >\n docArray: z.ZodArray<\n z.ZodObject<\n Shape & {\n _id: ZxId<TableName>\n _creationTime: z.ZodNumber\n }\n >\n >\n /** Paginated result schema matching Convex's PaginationResult shape */\n paginatedDoc: z.ZodObject<{\n page: z.ZodArray<z.ZodObject<Shape & { _id: ZxId<TableName>; _creationTime: z.ZodNumber }>>\n isDone: z.ZodBoolean\n continueCursor: z.ZodOptional<z.ZodNullable<z.ZodString>>\n }>\n /** The base schema - user fields without system fields */\n base: z.ZodObject<Shape>\n /** Alias for base - user fields for insert operations */\n insert: z.ZodObject<Shape>\n /** Update schema - _id required, _creationTime optional, user fields partial */\n update: z.ZodObject<UpdateShape<TableName, Shape>>\n }\n}\n\n// Overload 3: Union/schema types\nexport function zodTable<TableName extends string, Schema extends $ZodType>(\n name: TableName,\n schema: Schema\n): {\n table: ReturnType<typeof defineTable>\n tableName: TableName\n validator: ReturnType<typeof zodToConvex<Schema>>\n schema: {\n doc: AddSystemFieldsResult<TableName, Schema>\n docArray: z.ZodArray<AddSystemFieldsResult<TableName, Schema>>\n /** Paginated result schema matching Convex's PaginationResult shape */\n paginatedDoc: z.ZodObject<{\n page: z.ZodArray<AddSystemFieldsResult<TableName, Schema>>\n isDone: z.ZodBoolean\n continueCursor: z.ZodOptional<z.ZodNullable<z.ZodString>>\n }>\n /** The base schema - user fields without system fields */\n base: Schema\n /** Alias for base - user fields for insert operations */\n insert: Schema\n /** Update schema - _id required, _creationTime optional, user fields partial */\n update: UpdateSchemaType<TableName, Schema>\n }\n /** @deprecated Use `schema.docArray` instead */\n docArray: z.ZodArray<AddSystemFieldsResult<TableName, Schema>>\n withSystemFields: () => AddSystemFieldsResult<TableName, Schema>\n}\n\nexport function zodTable<\n TableName extends string,\n SchemaOrShape extends $ZodType | Record<string, $ZodType>\n>(name: TableName, schemaOrShape: SchemaOrShape): any {\n // Detect if it's an object shape, ZodObject, or other schema\n // For ZodObject: extract its shape to use the type-preserving path\n const isZodObject = schemaOrShape instanceof $ZodObject\n if (isObjectShape(schemaOrShape) || isZodObject) {\n // Extract shape from ZodObject or use raw shape directly\n const shape = isZodObject\n ? (schemaOrShape as z.ZodObject<z.ZodRawShape>).shape\n : (schemaOrShape as Record<string, $ZodType>)\n\n // Convert fields with proper types\n const convexFields = zodToConvexFields(shape) as ConvexValidatorFromZodFieldsAuto<typeof shape>\n\n // Create the Table from convex-helpers with explicit type\n const table = Table<ConvexValidatorFromZodFieldsAuto<typeof shape>, TableName>(\n name,\n convexFields\n )\n\n // Create base schema (user fields only, no system fields)\n // When a ZodObject is passed, preserve it to maintain options like .passthrough(), .strict(), .catchall()\n const baseSchema = isZodObject ? (schemaOrShape as z.ZodObject<z.ZodRawShape>) : z.object(shape)\n const schema = createObjectSchemaBundle(name, shape, baseSchema as z.ZodObject<any>)\n const zDoc = schema.doc\n const docArray = schema.docArray\n\n // Attach everything for comprehensive usage\n // zDoc and docArray are deprecated but kept for backwards compatibility\n // TypeScript @deprecated annotations provide compile-time warnings\n return Object.assign(table, {\n shape,\n schema,\n zDoc,\n docArray\n })\n } else {\n // Union or other schema type logic\n const schema = schemaOrShape as $ZodType\n\n // Convert schema to Convex validator\n const convexValidator = zodToConvex(schema)\n\n // For unions, use defineTable directly (not Table helper which expects object fields)\n // Convex supports union validators in tables, but TypeScript can't verify the types\n const table = defineTable(asTableValidator(convexValidator))\n const schemaNamespace = createSchemaBundle(name, schema)\n\n // Attach helpers for union tables\n // Return structure similar to Table() but without fields-based helpers\n return {\n table,\n tableName: name,\n validator: convexValidator,\n schema: schemaNamespace,\n docArray: schemaNamespace.docArray, // deprecated\n withSystemFields: () => schemaNamespace.doc\n }\n }\n}\n"]}