zodvex 0.5.0 → 0.5.1

package/README.md

@@ -9,6 +9,7 @@ Type-safe Convex functions with Zod schemas. Preserve Convex's optional/nullable
 ## Table of Contents
 
 - [Installation](#installation)
+- [Import Paths](#import-paths)
 - [Quick Start](#quick-start)
 - [Defining Schemas](#defining-schemas)
 - [Table Definitions](#table-definitions)
@@ -41,6 +42,45 @@ npm install zodvex zod@^4.1.0 convex convex-helpers
 - `convex` (>= 1.27.0)
 - `convex-helpers` (>= 0.1.104)
 
+## Import Paths
+
+zodvex provides multiple entry points for optimal bundle sizes:
+
+### `zodvex/core` - Client-Safe (Recommended for client code)
+
+Use this in React components, hooks, and any client-side code:
+
+```typescript
+import { zx, zodToConvex } from 'zodvex/core'
+
+// Define schemas that can be used anywhere
+const userSchema = z.object({
+  id: zx.id('users'),
+  createdAt: zx.date(),
+})
+```
+
+### `zodvex/server` - Server-Only
+
+Use this in Convex functions and schema definitions:
+
+```typescript
+import { zodTable, zCustomQuery } from 'zodvex/server'
+
+// In convex/schema.ts
+const Users = zodTable('users', userShape)
+```
+
+### `zodvex` - Full Library (Backwards Compatible)
+
+For convenience or when you don't care about bundle size:
+
+```typescript
+import { zx, zodTable } from 'zodvex'
+```
+
+> **Note:** This pulls in server code. Use `zodvex/core` for client bundles.
+
 ## Quick Start
 
 ### 1. Set up your builders

package/dist/core/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * zodvex/core - Client-safe validators and utilities
+ *
+ * This module contains no server imports and is safe to use in:
+ * - React components
+ * - Client-side hooks
+ * - Shared validation logic
+ * - Any code that runs in the browser
+ */
+export * from '../codec';
+export * from '../ids';
+export * from '../mapping';
+export * from '../registry';
+export * from '../results';
+export * from '../transform';
+export * from '../types';
+export * from '../utils';
+export * from '../zx';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,cAAc,UAAU,CAAA;AAExB,cAAc,QAAQ,CAAA;AAEtB,cAAc,YAAY,CAAA;AAE1B,cAAc,aAAa,CAAA;AAE3B,cAAc,YAAY,CAAA;AAE1B,cAAc,cAAc,CAAA;AAG5B,cAAc,UAAU,CAAA;AAGxB,cAAc,UAAU,CAAA;AAExB,cAAc,OAAO,CAAA"}