fluent-convex 0.10.0 → 0.12.2

package/README.md

@@ -0,0 +1,420 @@
+![logo](apps/docs/public/logo-128.png)
+
+# Fluent Convex
+
+A fluent API builder for Convex functions with middleware support, inspired by [oRPC](https://orpc.unnoq.com/).
+
+**[Live Docs & Interactive Showcase](https://friendly-zebra-716.convex.site)** -- see every feature in action with live demos and real source code.
+
+## Features
+
+- **Middleware support** - Compose reusable middleware for authentication, logging, and more ([docs](https://friendly-zebra-716.convex.site/middleware))
+- **Callable builders** - Define logic once, call it directly from other handlers, and register it multiple ways ([docs](https://friendly-zebra-716.convex.site/reusable-chains))
+- **Type-safe** - Full TypeScript support with type inference
+- **Fluent API** - Chain methods for a clean, readable syntax ([docs](https://friendly-zebra-716.convex.site/basics))
+- **Plugin system** - Extend with plugins like `fluent-convex/zod` for Zod schema support ([docs](https://friendly-zebra-716.convex.site/zod-plugin))
+- **Extensible** - Build your own plugins with the `_clone()` factory pattern ([docs](https://friendly-zebra-716.convex.site/custom-plugins))
+- **Works with Convex** - Built on top of Convex's function system
+
+## Installation
+
+```bash
+npm install fluent-convex
+```
+
+## Quick Start
+
+> For a complete walkthrough with live demos, see the **[Getting Started guide](https://friendly-zebra-716.convex.site/)**.
+
+**Important:** All functions must end with `.public()` or `.internal()` to be registered with Convex.
+
+```ts
+import { createBuilder } from "fluent-convex";
+import { v } from "convex/values";
+import type { DataModel } from "./_generated/dataModel";
+
+const convex = createBuilder<DataModel>();
+
+// Simple query
+export const listNumbers = convex
+  .query()
+  .input({ count: v.number() })
+  .handler(async (context, input) => {
+    const numbers = await context.db
+      .query("numbers")
+      .order("desc")
+      .take(input.count);
+
+    return { numbers: numbers.map((n) => n.value) };
+  })
+  .public(); // Must end with .public() or .internal()
+
+// With middleware
+const authMiddleware = convex.query().createMiddleware(async (context, next) => {
+  const identity = await context.auth.getUserIdentity();
+  if (!identity) {
+    throw new Error("Unauthorized");
+  }
+
+  return next({
+    ...context,
+    user: {
+      id: identity.subject,
+      name: identity.name ?? "Unknown",
+    },
+  });
+});
+
+export const listNumbersAuth = convex
+  .query()
+  .use(authMiddleware)
+  .input({ count: v.number() })
+  .handler(async (context, input) => {
+    const numbers = await context.db
+      .query("numbers")
+      .order("desc")
+      .take(input.count);
+
+    return {
+      viewer: context.user.name, // user is available from middleware!
+      numbers: numbers.map((n) => n.value),
+    };
+  })
+  .public();
+```
+
+## Validation
+
+> See the **[Validation docs](https://friendly-zebra-716.convex.site/validation)** for a side-by-side comparison of all three approaches with live demos.
+
+fluent-convex supports three flavors of input validation through the same `.input()` API:
+
+1. **Property validators** -- `{ count: v.number() }` (simplest)
+2. **Object validators** -- `v.object({ count: v.number() })` (with `.returns()` support)
+3. **Zod schemas** -- `z.object({ count: z.number().min(1) })` (via the Zod plugin)
+
+## Middleware
+
+> See the **[Middleware docs](https://friendly-zebra-716.convex.site/middleware)** for detailed examples of both patterns.
+
+There are two main middleware patterns:
+
+- **Context-enrichment** -- adds new properties to the context (e.g. `ctx.user`)
+- **Onion (wrap)** -- runs code before *and* after the handler (e.g. timing, error handling)
+
+## Reusable Chains & Callables
+
+> See the **[Reusable Chains docs](https://friendly-zebra-716.convex.site/reusable-chains)** for full examples with live demos.
+
+Because the builder is immutable, you can stop the chain at any point and reuse that partial builder later. A builder with a `.handler()` but no `.public()` / `.internal()` is called a **callable** -- a fully-typed function you can:
+
+1. **Call directly** from inside other handlers (no additional Convex function invocation)
+2. **Register** as a standalone Convex endpoint
+3. **Extend** with more middleware and register multiple ways
+
+```ts
+// 1. Define a callable - NOT yet registered with Convex
+const getNumbers = convex
+  .query()
+  .input({ count: v.number() })
+  .handler(async (ctx, args) => {
+    const rows = await ctx.db.query("numbers").order("desc").take(args.count);
+    return rows.map((r) => r.value);
+  });
+
+// 2. Register it as a public query
+export const listNumbers = getNumbers.public();
+
+// 3. Call it directly from inside another handler - no additional function invocation!
+export const getNumbersWithTimestamp = convex
+  .query()
+  .input({ count: v.number() })
+  .handler(async (ctx, args) => {
+    const numbers = await getNumbers(ctx, args); // <-- direct call
+    return { numbers, fetchedAt: Date.now() };
+  })
+  .public();
+
+// 4. Register the same callable with different middleware
+export const listNumbersProtected = getNumbers.use(authMiddleware).public();
+export const listNumbersLogged = getNumbers.use(withLogging("logged")).public();
+```
+
+The callable syntax is `callable(ctx, args)` -- the first argument passes the context (so the middleware chain runs with the right ctx), the second passes the validated arguments.
+
+## Plugins
+
+### Zod Plugin (`fluent-convex/zod`)
+
+> See the **[Zod Plugin docs](https://friendly-zebra-716.convex.site/zod-plugin)** for live demos including refinement validation.
+
+The Zod plugin adds Zod schema support for `.input()` and `.returns()`, with **full runtime validation** including refinements (`.min()`, `.max()`, `.email()`, etc.).
+
+```bash
+npm install zod convex-helpers
+```
+
+> **Note:** `zod` and `convex-helpers` are optional peer dependencies of `fluent-convex`. They're only needed if you use the Zod plugin.
+
+Usage:
+
+```ts
+import { createBuilder } from "fluent-convex";
+import { WithZod } from "fluent-convex/zod";
+import { z } from "zod";
+import type { DataModel } from "./_generated/dataModel";
+
+const convex = createBuilder<DataModel>();
+
+export const listNumbers = convex
+  .query()
+  .extend(WithZod) // Enable Zod support
+  .input(
+    z.object({
+      count: z.number().int().min(1).max(100), // Refinements enforced at runtime!
+    })
+  )
+  .returns(z.object({ numbers: z.array(z.number()) }))
+  .handler(async (context, input) => {
+    const numbers = await context.db.query("numbers").take(input.count);
+    return { numbers: numbers.map((n) => n.value) };
+  })
+  .public();
+```
+
+Key features:
+- **Full runtime validation** - Zod refinements (`.min()`, `.max()`, `.email()`, `.regex()`, etc.) are enforced server-side. Args are validated before the handler runs; return values after.
+- **Structural conversion** - Zod schemas are automatically converted to Convex validators for Convex's built-in validation.
+- **Composable** - `.extend(WithZod)` preserves the `WithZod` type through `.use()`, `.input()`, and `.returns()` chains.
+- **Plain validators still work** - You can mix Zod and Convex validators in the same builder chain.
+
+## Extensibility
+
+> See the **[Custom Plugins docs](https://friendly-zebra-716.convex.site/custom-plugins)** for a complete worked example with live demo.
+
+You can extend the builder with your own plugins by subclassing `ConvexBuilderWithFunctionKind` and overriding the `_clone()` factory method.
+
+### Writing a Plugin
+
+The `_clone()` method is called internally by `.use()`, `.input()`, and `.returns()` to create new builder instances. By overriding it, your plugin's type is preserved through the entire builder chain.
+
+```ts
+import {
+  ConvexBuilderWithFunctionKind,
+  type GenericDataModel,
+  type FunctionType,
+  type Context,
+  type EmptyObject,
+  type ConvexArgsValidator,
+  type ConvexReturnsValidator,
+  type ConvexBuilderDef,
+} from "fluent-convex";
+
+class MyPlugin<
+  TDataModel extends GenericDataModel = GenericDataModel,
+  TFunctionType extends FunctionType = FunctionType,
+  TCurrentContext extends Context = EmptyObject,
+  TArgsValidator extends ConvexArgsValidator | undefined = undefined,
+  TReturnsValidator extends ConvexReturnsValidator | undefined = undefined,
+> extends ConvexBuilderWithFunctionKind<
+  TDataModel,
+  TFunctionType,
+  TCurrentContext,
+  TArgsValidator,
+  TReturnsValidator
+> {
+  // Accept both builder instances (from .extend()) and raw defs (from _clone())
+  constructor(builderOrDef: any) {
+    const def =
+      builderOrDef instanceof ConvexBuilderWithFunctionKind
+        ? (builderOrDef as any).def
+        : builderOrDef;
+    super(def);
+  }
+
+  // Override _clone() to preserve MyPlugin through the chain
+  protected _clone(def: ConvexBuilderDef<any, any, any>): any {
+    return new MyPlugin(def);
+  }
+
+  // Add custom methods
+  myCustomMethod(param: string) {
+    console.log("Custom method called with:", param);
+    return this;
+  }
+}
+```
+
+Usage:
+
+```ts
+export const myQuery = convex
+  .query()
+  .extend(MyPlugin)
+  .myCustomMethod("hello")     // Custom method from plugin
+  .use(authMiddleware)          // .use() preserves MyPlugin type
+  .input({ count: v.number() })
+  .handler(async (ctx, input) => { ... })
+  .public();
+```
+
+### Composing Multiple Plugins
+
+Plugins can be composed with `.extend()`:
+
+```ts
+export const myQuery = convex
+  .query()
+  .extend(MyPlugin)
+  .extend(WithZod) // WithZod overrides .input()/.returns() from MyPlugin
+  .myCustomMethod("hello")
+  .input(z.object({ count: z.number() }))
+  .handler(async (ctx, input) => { ... })
+  .public();
+```
+
+## Flexible Method Ordering
+
+The builder API is flexible about method ordering, allowing you to structure your code in the way that makes the most sense for your use case.
+
+### Middleware After Handler
+
+You can add middleware **after** defining the handler, which is useful when you want to wrap existing handlers with additional functionality:
+
+```ts
+export const getNumbers = convex
+  .query()
+  .input({ count: v.number() })
+  .handler(async (context, input) => {
+    return await context.db.query("numbers").take(input.count);
+  })
+  .use(authMiddleware) // Middleware added after handler
+  .public();
+```
+
+### Callable Builders
+
+Before registering a function with `.public()` or `.internal()`, the builder is **callable** -- you can invoke it directly from other handlers (see [Reusable Chains](#reusable-chains--callables) above) or use it in tests:
+
+```ts
+// A callable (not yet registered)
+const getDouble = convex
+  .query()
+  .input({ count: v.number() })
+  .handler(async (context, input) => {
+    return { doubled: input.count * 2 };
+  });
+
+// Call it from another handler
+export const tripled = convex
+  .query()
+  .input({ count: v.number() })
+  .handler(async (ctx, input) => {
+    const { doubled } = await getDouble(ctx, input);
+    return { tripled: doubled + input.count };
+  })
+  .public();
+
+// Or call it directly in tests
+const mockContext = {} as any;
+const result = await getDouble(mockContext, { count: 5 });
+console.log(result); // { doubled: 10 }
+
+// Register it when you also need it as a standalone endpoint
+export const doubleNumber = getDouble.public();
+```
+
+### Method Ordering Rules
+
+- **`.returns()`** must be called **before** `.handler()`
+- **`.use()`** can be called **before or after** `.handler()`
+- **`.public()`** or **`.internal()`** must be called **after** `.handler()` and is **required** to register the function
+- Functions are **callable** before registration, **non-callable** after registration
+- **All exported functions must end with `.public()` or `.internal()`** - functions without registration will not be available in your Convex API
+
+## API
+
+### Methods
+
+- `.query()` - Define a Convex query
+- `.mutation()` - Define a Convex mutation
+- `.action()` - Define a Convex action
+- `.public()` - Register the function as public (required to register)
+- `.internal()` - Register the function as internal/private (required to register)
+- `.input(validator)` - Set input validation (Convex validators)
+- `.returns(validator)` - Set return validation (Convex validators)
+- `.use(middleware)` - Apply middleware
+- `.createMiddleware(fn)` - Create a middleware function
+- `.handler(fn)` - Define the function handler
+- `.extend(plugin)` - Extend the builder with a plugin class
+
+## Caveats
+
+### Circular types when calling `api.*` in the same file
+
+When a function calls other functions via `api.*` in the same file, and those functions don't have explicit `.returns()` validators, TypeScript may report circular initializer errors (TS7022). This is a standard Convex/TypeScript limitation, not specific to fluent-convex. Workarounds:
+1. Add `.returns()` to the **called** functions -- this gives them explicit return types, breaking the cycle
+2. Move the calling function to a separate file
+3. Use `internal.*` from a different module
+
+## Documentation
+
+The **[live docs site](https://friendly-zebra-716.convex.site)** is an interactive showcase that demonstrates every feature with working live demos. The code snippets shown on the docs site are the actual source code powering the app -- imported via Vite `?raw` imports, so what you see is what runs.
+
+Sections:
+- [Getting Started](https://friendly-zebra-716.convex.site/) -- builder setup and overview
+- [Basics](https://friendly-zebra-716.convex.site/basics) -- queries, mutations, and the fluent chain
+- [Validation](https://friendly-zebra-716.convex.site/validation) -- property validators, object validators, and Zod schemas
+- [Middleware](https://friendly-zebra-716.convex.site/middleware) -- context-enrichment and onion middleware
+- [Reusable Chains](https://friendly-zebra-716.convex.site/reusable-chains) -- callable syntax and composability
+- [Zod Plugin](https://friendly-zebra-716.convex.site/zod-plugin) -- runtime refinement validation
+- [Custom Plugins](https://friendly-zebra-716.convex.site/custom-plugins) -- building your own plugins with `.extend()`
+
+
+
+The docs source lives in [`/apps/docs`](./apps/docs) and is auto-deployed on every push to `main`.
+
+## Development
+
+This is a monorepo using npm workspaces:
+
+- `/packages/fluent-convex` - The core library (includes the Zod plugin at `fluent-convex/zod`)
+- `/apps/example` - Example Convex app
+- `/apps/docs` - Interactive docs & showcase site ([live](https://friendly-zebra-716.convex.site))
+
+### Setup
+
+```bash
+npm install
+```
+
+This will install dependencies for all workspaces.
+
+### Building
+
+```bash
+npm run build
+```
+
+### Running tests
+
+```bash
+npm test
+```
+
+### Running the example
+
+```bash
+cd apps/example
+npm run dev
+```
+
+### Running the docs locally
+
+```bash
+npm run docs:dev
+```
+
+## Credits
+
+Borrowed heavily from [oRPC](https://orpc.unnoq.com/learn-and-contribute/overview) and helped out by AI.

package/dist/ConvexBuilderWithFunctionKind.d.ts

@@ -1,14 +1,20 @@
 import type { GenericDataModel } from "convex/server";
+import type { GenericValidator, PropertyValidators } from "convex/values";
 import { ConvexBuilderWithHandler } from "./ConvexBuilderWithHandler";
 import { InferredArgs, InferredHandlerReturn } from "./types";
 import { ConvexBuilderDef } from "./types";
 import { CallableBuilder } from "./types";
 import type { ConvexMiddleware } from "./middleware";
 import type { FunctionType, Context, EmptyObject, ConvexArgsValidator, ConvexReturnsValidator } from "./types";
-import { type ValidatorInput, type ToConvexArgsValidator, type ReturnsValidatorInput, type ToConvexReturnsValidator } from "./zod_support";
 export declare class ConvexBuilderWithFunctionKind<TDataModel extends GenericDataModel = GenericDataModel, TFunctionType extends FunctionType = FunctionType, TCurrentContext extends Context = EmptyObject, TArgsValidator extends ConvexArgsValidator | undefined = undefined, TReturnsValidator extends ConvexReturnsValidator | undefined = undefined> {
     protected def: ConvexBuilderDef<TFunctionType, TArgsValidator, TReturnsValidator>;
     constructor(def: ConvexBuilderDef<TFunctionType, TArgsValidator, TReturnsValidator>);
+    /**
+     * Factory method for creating new builder instances. Subclasses (plugins)
+     * override this to return their own type, ensuring that methods like
+     * `.use()`, `.input()`, `.returns()` preserve the plugin type through the chain.
+     */
+    protected _clone(def: ConvexBuilderDef<any, any, any>): any;
     extend<TResult>(fn: (builder: this) => TResult): TResult;
     extend<TResult>(cls: new (builder: this) => TResult): TResult;
     $context<U extends Context>(): {
@@ -21,8 +27,8 @@ export declare class ConvexBuilderWithFunctionKind<TDataModel extends GenericDat
     createMiddleware<UOutContext extends Context>(middleware: ConvexMiddleware<TCurrentContext, UOutContext>): ConvexMiddleware<TCurrentContext, UOutContext>;
     createMiddleware<UInContext extends Context, UOutContext extends Context>(middleware: ConvexMiddleware<UInContext, UOutContext>): ConvexMiddleware<UInContext, UOutContext>;
     use<UOutContext extends Context>(middleware: ConvexMiddleware<TCurrentContext, UOutContext>): ConvexBuilderWithFunctionKind<TDataModel, TFunctionType, TCurrentContext & UOutContext, TArgsValidator, TReturnsValidator>;
-    input<UInput extends ValidatorInput>(validator: UInput): ConvexBuilderWithFunctionKind<TDataModel, TFunctionType, TCurrentContext, ToConvexArgsValidator<UInput>, TReturnsValidator>;
-    returns<UReturns extends ReturnsValidatorInput>(validator: UReturns): ConvexBuilderWithFunctionKind<TDataModel, TFunctionType, TCurrentContext, TArgsValidator, ToConvexReturnsValidator<UReturns>>;
+    input<UInput extends PropertyValidators | GenericValidator>(validator: UInput): ConvexBuilderWithFunctionKind<TDataModel, TFunctionType, TCurrentContext, UInput extends ConvexArgsValidator ? UInput : ConvexArgsValidator, TReturnsValidator>;
+    returns<UReturns extends GenericValidator>(validator: UReturns): ConvexBuilderWithFunctionKind<TDataModel, TFunctionType, TCurrentContext, TArgsValidator, UReturns extends ConvexReturnsValidator ? UReturns : ConvexReturnsValidator>;
     handler<TReturn extends InferredHandlerReturn<TReturnsValidator, any> = InferredHandlerReturn<TReturnsValidator, any>>(handlerFn: (context: TCurrentContext, input: InferredArgs<TArgsValidator>) => Promise<TReturn>): ConvexBuilderWithHandler<TDataModel, TFunctionType, TCurrentContext, TArgsValidator, TReturnsValidator, InferredHandlerReturn<TReturnsValidator, TReturn>> & CallableBuilder<TCurrentContext, TArgsValidator, InferredHandlerReturn<TReturnsValidator, TReturn>>;
 }
 //# sourceMappingURL=ConvexBuilderWithFunctionKind.d.ts.map

package/dist/ConvexBuilderWithFunctionKind.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConvexBuilderWithFunctionKind.d.ts","sourceRoot":"","sources":["../src/ConvexBuilderWithFunctionKind.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ConvexBuilderWithFunctionKind.d.ts","sourceRoot":"","sources":["../src/ConvexBuilderWithFunctionKind.ts"],"names":[],"mappings":"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"}

package/dist/ConvexBuilderWithFunctionKind.js

@@ -1,11 +1,18 @@
 import { ConvexBuilderWithHandler } from "./ConvexBuilderWithHandler";
 import { extend as extendBuilder } from "./extend";
-import { isZodSchema, toConvexValidator, } from "./zod_support";
 export class ConvexBuilderWithFunctionKind {
     def;
     constructor(def) {
         this.def = def;
     }
+    /**
+     * Factory method for creating new builder instances. Subclasses (plugins)
+     * override this to return their own type, ensuring that methods like
+     * `.use()`, `.input()`, `.returns()` preserve the plugin type through the chain.
+     */
+    _clone(def) {
+        return new ConvexBuilderWithFunctionKind(def);
+    }
     extend(fnOrCls) {
         return extendBuilder(this, fnOrCls);
     }
@@ -20,27 +27,21 @@ export class ConvexBuilderWithFunctionKind {
         return middleware;
     }
     use(middleware) {
-        return new ConvexBuilderWithFunctionKind({
+        return this._clone({
             ...this.def,
             middlewares: [...this.def.middlewares, middleware],
         });
     }
     input(validator) {
-        const convexValidator = isZodSchema(validator)
-            ? toConvexValidator(validator)
-            : validator;
-        return new ConvexBuilderWithFunctionKind({
+        return this._clone({
             ...this.def,
-            argsValidator: convexValidator,
+            argsValidator: validator,
         });
     }
     returns(validator) {
-        const convexValidator = isZodSchema(validator)
-            ? toConvexValidator(validator)
-            : validator;
-        return new ConvexBuilderWithFunctionKind({
+        return this._clone({
             ...this.def,
-            returnsValidator: convexValidator,
+            returnsValidator: validator,
         });
     }
     handler(handlerFn) {

package/dist/ConvexBuilderWithFunctionKind.js.map

@@ -1 +1 @@
-{"version":3,"file":"ConvexBuilderWithFunctionKind.js","sourceRoot":"","sources":["../src/ConvexBuilderWithFunctionKind.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAYtE,OAAO,EAAE,MAAM,IAAI,aAAa,EAAE,MAAM,UAAU,CAAC;AACnD,OAAO,EAGL,WAAW,EACX,iBAAiB,GAGlB,MAAM,eAAe,CAAC;AAEvB,MAAM,OAAO,6BAA6B;IAO9B,GAAG,CAIX;IAEF,YACE,GAAuE;QAEvE,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAID,MAAM,CACJ,OAAwE;QAExE,OAAO,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,QAAQ;QAKN,OAAO;YACL,gBAAgB,CACd,UAA4C;gBAE5C,OAAO,UAAU,CAAC;YACpB,CAAC;SACF,CAAC;IACJ,CAAC;IAYD,gBAAgB,CACd,UAAqD;QAErD,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,GAAG,CACD,UAA0D;QAQ1D,OAAO,IAAI,6BAA6B,CAMtC;YACA,GAAG,IAAI,CAAC,GAAG;YACX,WAAW,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,UAAiC,CAAC;SAC1E,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CACH,SAAiB;QAQjB,MAAM,eAAe,GAAG,WAAW,CAAC,SAAS,CAAC;YAC5C,CAAC,CAAE,iBAAiB,CAAC,SAAS,CAAmC;YACjE,CAAC,CAAE,SAA2C,CAAC;QAEjD,OAAO,IAAI,6BAA6B,CAMtC;YACA,GAAG,IAAI,CAAC,GAAG;YACX,aAAa,EAAE,eAAe;SAC/B,CAAC,CAAC;IACL,CAAC;IAED,OAAO,CACL,SAAmB;QAQnB,MAAM,eAAe,GAAG,WAAW,CAAC,SAAS,CAAC;YAC5C,CAAC,CAAE,iBAAiB,CAAC,SAAS,CAAwC;YACtE,CAAC,CAAE,SAAgD,CAAC;QAEtD,OAAO,IAAI,6BAA6B,CAMtC;YACA,GAAG,IAAI,CAAC,GAAG;YACX,gBAAgB,EAAE,eAAe;SAClC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,CAML,SAGqB;QAcrB,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CACb,0EAA0E,CAC3E,CAAC;QACJ,CAAC;QAED,4EAA4E;QAC5E,mFAAmF;QACnF,oFAAoF;QACpF,MAAM,UAAU,GAAG,KAAK,EACtB,cAAuB,EACvB,QAAsC,EACtC,EAAE;YACF,OAAO,SAAS,CAAC,cAAiC,EAAE,QAAQ,CAAC,CAAC;QAChE,CAAC,CAAC;QAIF,OAAO,IAAI,wBAAwB,CAOjC;YACA,GAAG,IAAI,CAAC,GAAG;YACX,OAAO,EAAE,UAAiB;SAC3B,CAQiE,CAAC;IACrE,CAAC;CACF"}
+{"version":3,"file":"ConvexBuilderWithFunctionKind.js","sourceRoot":"","sources":["../src/ConvexBuilderWithFunctionKind.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAYtE,OAAO,EAAE,MAAM,IAAI,aAAa,EAAE,MAAM,UAAU,CAAC;AAEnD,MAAM,OAAO,6BAA6B;IAO9B,GAAG,CAIX;IAEF,YACE,GAAuE;QAEvE,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAED;;;;OAIG;IACO,MAAM,CAAC,GAAoC;QACnD,OAAO,IAAI,6BAA6B,CAAC,GAAG,CAAC,CAAC;IAChD,CAAC;IAID,MAAM,CACJ,OAAwE;QAExE,OAAO,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,QAAQ;QAKN,OAAO;YACL,gBAAgB,CACd,UAA4C;gBAE5C,OAAO,UAAU,CAAC;YACpB,CAAC;SACF,CAAC;IACJ,CAAC;IAYD,gBAAgB,CACd,UAAqD;QAErD,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,GAAG,CACD,UAA0D;QAQ1D,OAAO,IAAI,CAAC,MAAM,CAAC;YACjB,GAAG,IAAI,CAAC,GAAG;YACX,WAAW,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,UAAiC,CAAC;SAC1E,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CACH,SAAiB;QAQjB,OAAO,IAAI,CAAC,MAAM,CAAC;YACjB,GAAG,IAAI,CAAC,GAAG;YACX,aAAa,EAAE,SAAS;SACzB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,CACL,SAAmB;QAQnB,OAAO,IAAI,CAAC,MAAM,CAAC;YACjB,GAAG,IAAI,CAAC,GAAG;YACX,gBAAgB,EAAE,SAAS;SAC5B,CAAC,CAAC;IACL,CAAC;IAED,OAAO,CAML,SAGqB;QAcrB,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CACb,0EAA0E,CAC3E,CAAC;QACJ,CAAC;QAED,4EAA4E;QAC5E,mFAAmF;QACnF,oFAAoF;QACpF,MAAM,UAAU,GAAG,KAAK,EACtB,cAAuB,EACvB,QAAsC,EACtC,EAAE;YACF,OAAO,SAAS,CAAC,cAAiC,EAAE,QAAQ,CAAC,CAAC;QAChE,CAAC,CAAC;QAIF,OAAO,IAAI,wBAAwB,CAOjC;YACA,GAAG,IAAI,CAAC,GAAG;YACX,OAAO,EAAE,UAAiB;SAC3B,CAQiE,CAAC;IACrE,CAAC;CACF"}

package/dist/ConvexBuilderWithHandler.d.ts

@@ -23,6 +23,10 @@ export declare class ConvexBuilderWithHandler<TDataModel extends GenericDataMode
      * of the chain (remaining middleware + handler). This allows middleware to
      * run code before and after downstream execution, catch errors, measure
      * timing, etc.
+     *
+     * When transform hooks are present (set by plugins):
+     * - `argsTransform` runs before the middleware chain (validates/transforms args).
+     * - `returnsTransform` runs after the handler (validates/transforms the return value).
      */
     private _executeWithMiddleware;
     use<UOutContext extends Context>(middleware: ConvexMiddleware<TCurrentContext, UOutContext>): ConvexBuilderWithHandler<TDataModel, TFunctionType, TCurrentContext & UOutContext, TArgsValidator, TReturnsValidator, THandlerReturn> & CallableBuilder<TCurrentContext & UOutContext, TArgsValidator, THandlerReturn>;

package/dist/ConvexBuilderWithHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConvexBuilderWithHandler.d.ts","sourceRoot":"","sources":["../src/ConvexBuilderWithHandler.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ConvexBuilderWithHandler.d.ts","sourceRoot":"","sources":["../src/ConvexBuilderWithHandler.ts"],"names":[],"mappings":"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"}

package/dist/ConvexBuilderWithHandler.js

@@ -5,8 +5,8 @@ export class ConvexBuilderWithHandler {
     constructor(def) {
         this.def = def;
         // Create a callable function that delegates to _call
-        const callable = ((context) => {
-            return this._call(context);
+        const callable = ((context, args) => {
+            return this._call(context, args);
         });
         // Copy properties from prototype to the callable function
         // This is a bit of a hack to make the function behave like an instance of the class
@@ -28,22 +28,29 @@ export class ConvexBuilderWithHandler {
         return extendBuilder(this, fnOrCls);
     }
     // Internal method to handle the call
-    _call(context) {
+    async _call(context, args) {
         const { handler, middlewares } = this.def;
         if (!handler) {
             throw new Error("Handler not set.");
         }
-        return async (args) => {
-            return this._executeWithMiddleware(middlewares, context, handler, args);
-        };
+        return this._executeWithMiddleware(middlewares, context, handler, args);
     }
     /**
      * Execute middleware as an onion: each middleware's `next()` runs the rest
      * of the chain (remaining middleware + handler). This allows middleware to
      * run code before and after downstream execution, catch errors, measure
      * timing, etc.
+     *
+     * When transform hooks are present (set by plugins):
+     * - `argsTransform` runs before the middleware chain (validates/transforms args).
+     * - `returnsTransform` runs after the handler (validates/transforms the return value).
      */
     async _executeWithMiddleware(middlewares, initialContext, handler, args) {
+        // Run args transform hook if present (e.g. Zod validation from plugin)
+        const { argsTransform, returnsTransform } = this.def;
+        if (argsTransform) {
+            args = argsTransform(args);
+        }
         let handlerResult;
         // Build a recursive chain where calling `next(ctx)` runs the next
         // middleware, and the innermost `next` runs the handler.
@@ -60,6 +67,10 @@ export class ConvexBuilderWithHandler {
             };
         };
         await createNext(0)(initialContext);
+        // Run returns transform hook if present (e.g. Zod validation from plugin)
+        if (returnsTransform) {
+            handlerResult = returnsTransform(handlerResult);
+        }
         return handlerResult;
     }
     use(middleware) {

package/dist/ConvexBuilderWithHandler.js.map

@@ -1 +1 @@
-{"version":3,"file":"ConvexBuilderWithHandler.js","sourceRoot":"","sources":["../src/ConvexBuilderWithHandler.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ConvexBuilderWithHandler.js","sourceRoot":"","sources":["../src/ConvexBuilderWithHandler.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -5,5 +5,4 @@ export { ConvexBuilderWithHandler } from "./ConvexBuilderWithHandler";
 export type { ConvexMiddleware, AnyConvexMiddleware, } from "./middleware";
 export type { Context, ConvexArgsValidator, ConvexReturnsValidator, InferArgs, QueryCtx, MutationCtx, ActionCtx, FunctionType, Visibility, EmptyObject, ConvexBuilderDef, } from "./types";
 export type { GenericDataModel } from "convex/server";
-export { isZodSchema, toConvexValidator, type ValidatorInput, type ReturnsValidatorInput, } from "./zod_support";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,YAAY,EACV,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,OAAO,EACP,mBAAmB,EACnB,sBAAsB,EACtB,SAAS,EACT,QAAQ,EACR,WAAW,EACX,SAAS,EACT,YAAY,EACZ,UAAU,EACV,WAAW,EACX,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAEjB,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,KAAK,cAAc,EACnB,KAAK,qBAAqB,GAC3B,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,YAAY,EACV,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,OAAO,EACP,mBAAmB,EACnB,sBAAsB,EACtB,SAAS,EACT,QAAQ,EACR,WAAW,EACX,SAAS,EACT,YAAY,EACZ,UAAU,EACV,WAAW,EACX,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAEjB,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -2,5 +2,4 @@ export { createBuilder } from "./builder";
 export { ConvexBuilder } from "./ConvexBuilder";
 export { ConvexBuilderWithFunctionKind } from "./ConvexBuilderWithFunctionKind";
 export { ConvexBuilderWithHandler } from "./ConvexBuilderWithHandler";
-export { isZodSchema, toConvexValidator, } from "./zod_support";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAuBtE,OAAO,EACL,WAAW,EACX,iBAAiB,GAGlB,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC"}