fix

Author: zbeyens

.changeset/skip-validation.md

@@ -1,5 +1,5 @@
 ---
-"better-auth-convex": minor
+"better-auth-convex": patch
 ---
 
 Add `skipValidation` option to `createApi` for smaller generated types. When enabled, uses generic `v.any()` validators instead of typed validators. Since these are internal functions, validation is optional and this can significantly reduce bundle size.

README.md

@@ -168,7 +168,12 @@ export const {
   findOne,
   updateMany,
   updateOne,
-} = createApi(schema, auth.options);
+} = createApi(schema, {
+  ...auth.options,
+  // Optional: Skip input validation for smaller generated types
+  // Since these are internal functions, validation is optional
+  skipValidation: true,
+});
 
 // Optional: If you need custom mutation builders (e.g., for custom context)
 // Pass internalMutation to both createClient and createApi
@@ -254,6 +259,21 @@ const session = await getSession(ctx);
 const headers = await getHeaders(ctx);
 ```
 
+## API Options
+
+### `skipValidation`
+
+The `createApi` function accepts a `skipValidation` option that uses generic validators instead of typed validators:
+
+```ts
+export const { create, ... } = createApi(schema, {
+  ...auth.options,
+  skipValidation: true, // Smaller generated types
+});
+```
+
+**When to use**: Enable this option to significantly reduce generated type sizes. Since these are internal functions only called by the auth adapter, input validation is optional. The trade-off is less precise TypeScript inference for the internal API arguments.
+
 ## Custom Mutation Builders
 
 Both `createClient` and `createApi` accept an optional `internalMutation` parameter, allowing you to wrap internal mutations with custom context or behavior.