fluent-convex 0.11.1 → 0.12.3

package/README.md

@@ -0,0 +1,403 @@
+![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
+
+## 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/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,14 +28,12 @@ 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

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/types.d.ts

@@ -28,7 +28,7 @@ export type ActionCtx<DataModel extends GenericDataModel = GenericDataModel> = G
 export type FunctionType = "query" | "mutation" | "action";
 export type Visibility = "public" | "internal";
 export type CallableBuilder<TCurrentContext extends Context, TArgsValidator extends ConvexArgsValidator | undefined, THandlerReturn> = {
-    (context: TCurrentContext): (args: InferredArgs<TArgsValidator>) => Promise<THandlerReturn>;
+    (context: TCurrentContext, args: InferredArgs<TArgsValidator>): Promise<THandlerReturn>;
 };
 export interface ConvexBuilderDef<TFunctionType extends FunctionType | undefined = undefined, TArgsValidator extends ConvexArgsValidator | undefined = undefined, TReturnsValidator extends ConvexReturnsValidator | undefined = undefined> {
     functionType?: TFunctionType;

package/dist/types.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fluent-convex",
-  "version": "0.11.1",
+  "version": "0.12.3",
   "description": "A fluent API builder for Convex functions with middleware support, inspired by oRPC",
   "type": "module",
   "main": "./dist/index.js",
@@ -28,7 +28,7 @@
     "typecheck": "tsc --noEmit",
     "test": "vitest run --typecheck",
     "dev:test": "vitest --typecheck",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "node -e \"require('fs').copyFileSync('../../README.md','README.md')\" && npm run build"
   },
   "keywords": [
     "convex",
@@ -44,6 +44,7 @@
   "publishConfig": {
     "access": "public"
   },
+  "homepage": "https://friendly-zebra-716.convex.site/",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/mikecann/fluent-convex.git"

package/src/ConvexBuilderWithHandler.ts

@@ -65,8 +65,11 @@ export class ConvexBuilderWithHandler<
     this.def = def;
 
     // Create a callable function that delegates to _call
-    const callable = ((context: TCurrentContext) => {
-      return this._call(context);
+    const callable = ((
+      context: TCurrentContext,
+      args: InferredArgs<TArgsValidator>
+    ) => {
+      return this._call(context, args);
     }) as any;
 
     // Copy properties from prototype to the callable function
@@ -98,23 +101,22 @@ export class ConvexBuilderWithHandler<
   }
 
   // Internal method to handle the call
-  private _call(
-    context: TCurrentContext
-  ): (args: InferredArgs<TArgsValidator>) => Promise<THandlerReturn> {
+  private async _call(
+    context: TCurrentContext,
+    args: InferredArgs<TArgsValidator>
+  ): Promise<THandlerReturn> {
     const { handler, middlewares } = this.def;
 
     if (!handler) {
       throw new Error("Handler not set.");
     }
 
-    return async (args: InferredArgs<TArgsValidator>) => {
-      return this._executeWithMiddleware(
-        middlewares,
-        context as Context,
-        handler,
-        args
-      );
-    };
+    return this._executeWithMiddleware(
+      middlewares,
+      context as Context,
+      handler,
+      args
+    );
   }
 
   /**

package/src/builder-core.test-d.ts

@@ -222,7 +222,7 @@ describe("Builder Core", () => {
 
       // Should be callable
       assertType<
-        (context: any) => (args: { count: number }) => Promise<string>
+        (context: any, args: { count: number }) => Promise<string>
       >(nonRegisteredQuery);
     });
 
@@ -308,10 +308,9 @@ describe("Builder Core", () => {
       // Should still be callable after middleware
       assertType<
         (
-          context: any
-        ) => (args: {
-          count: number;
-        }) => Promise<{ count: number; userId: string }>
+          context: any,
+          args: { count: number }
+        ) => Promise<{ count: number; userId: string }>
       >(callableQuery);
     });
 
@@ -348,8 +347,9 @@ describe("Builder Core", () => {
       // Should still be callable after multiple middleware
       assertType<
         (
-          context: any
-        ) => (args: { count: number }) => Promise<{ count: number }>
+          context: any,
+          args: { count: number }
+        ) => Promise<{ count: number }>
       >(callableQuery);
     });
 
@@ -362,7 +362,7 @@ describe("Builder Core", () => {
         });
 
       // Should be callable
-      assertType<(context: any) => (args: { value: number }) => Promise<any>>(
+      assertType<(context: any, args: { value: number }) => Promise<any>>(
         callableMutation
       );
     });
@@ -377,7 +377,7 @@ describe("Builder Core", () => {
 
       // Should be callable
       assertType<
-        (context: any) => (args: { url: string }) => Promise<{ url: string }>
+        (context: any, args: { url: string }) => Promise<{ url: string }>
       >(callableAction);
     });
 
@@ -398,11 +398,12 @@ describe("Builder Core", () => {
       // Should be callable
       assertType<
         (
-          context: any
-        ) => (args: {
-          name?: string;
-          count?: number;
-        }) => Promise<{ name?: string; count?: number }>
+          context: any,
+          args: {
+            name?: string;
+            count?: number;
+          }
+        ) => Promise<{ name?: string; count?: number }>
       >(callableQuery);
     });
 
@@ -422,8 +423,9 @@ describe("Builder Core", () => {
       // Should be callable
       assertType<
         (
-          context: any
-        ) => (args: { count: number }) => Promise<{ numbers: number[] }>
+          context: any,
+          args: { count: number }
+        ) => Promise<{ numbers: number[] }>
       >(callableQuery);
     });
 
@@ -435,8 +437,9 @@ describe("Builder Core", () => {
       // Should be callable
       assertType<
         (
-          context: any
-        ) => (args: Record<never, never>) => Promise<{ success: boolean }>
+          context: any,
+          args: Record<never, never>
+        ) => Promise<{ success: boolean }>
       >(callableQuery);
     });
 
@@ -451,8 +454,9 @@ describe("Builder Core", () => {
       // Before .public(), should be callable
       assertType<
         (
-          context: any
-        ) => (args: { count: number }) => Promise<{ count: number }>
+          context: any,
+          args: { count: number }
+        ) => Promise<{ count: number }>
       >(callableQuery);
 
       const registeredQuery = callableQuery.public();
@@ -471,7 +475,7 @@ describe("Builder Core", () => {
         });
 
       // Before .internal(), should be callable
-      assertType<(context: any) => (args: { value: number }) => Promise<any>>(
+      assertType<(context: any, args: { value: number }) => Promise<any>>(
         callableMutation
       );
 

package/src/context-helper.test.ts

@@ -58,7 +58,7 @@ describe("$context() consistency", () => {
         return context.user.name;
       });
 
-    const result = await fn({} as any)({});
+    const result = await fn({} as any, {});
     expect(result).toBe("Alice");
   });
 });

package/src/error-paths.test.ts

@@ -107,7 +107,7 @@ describe("middleware error propagation", () => {
       .use(failing)
       .handler(async () => "should not reach");
 
-    await expect(fn({} as any)({})).rejects.toThrow(
+    await expect(fn({} as any, {})).rejects.toThrow(
       "middleware failed before next"
     );
   });
@@ -123,7 +123,7 @@ describe("middleware error propagation", () => {
       .use(failsAfter)
       .handler(async () => "handler ran");
 
-    await expect(fn({} as any)({})).rejects.toThrow(
+    await expect(fn({} as any, {})).rejects.toThrow(
       "middleware failed after next"
     );
   });
@@ -159,7 +159,7 @@ describe("middleware error propagation", () => {
         throw new Error("boom");
       });
 
-    await expect(fn({} as any)({})).rejects.toThrow("boom");
+    await expect(fn({} as any, {})).rejects.toThrow("boom");
 
     // Both middleware should have caught the error in reverse order
     expect(order).toEqual([
@@ -188,7 +188,7 @@ describe("middleware skipping next()", () => {
         return "handler result";
       });
 
-    await fn({} as any)({});
+    await fn({} as any, {});
 
     // Handler should NOT have executed
     expect(handlerRan.value).toBe(false);
@@ -204,7 +204,7 @@ describe("handler called with correct context and args", () => {
         return { name: args.name, count: args.count };
       });
 
-    const result = await fn({} as any)({ name: "test", count: 42 });
+    const result = await fn({} as any, { name: "test", count: 42 });
     expect(result).toEqual({ name: "test", count: 42 });
   });
 
@@ -224,7 +224,7 @@ describe("handler called with correct context and args", () => {
         return { a: ctx.a, b: ctx.b };
       });
 
-    const result = await fn({} as any)({});
+    const result = await fn({} as any, {});
     expect(result).toEqual({ a: 1, b: 2 });
   });
 });
@@ -235,7 +235,7 @@ describe("empty middleware chain", () => {
       .query()
       .handler(async () => "no middleware");
 
-    const result = await fn({} as any)({});
+    const result = await fn({} as any, {});
     expect(result).toBe("no middleware");
   });
 });

package/src/extensibility.test.ts

@@ -173,7 +173,7 @@ describe("Extensibility", () => {
     console.log("Keys:", Object.keys(handlerBuilder));
 
     // The result should be callable
-    const result = await handlerBuilder({} as any)({ message: "hello" });
+    const result = await handlerBuilder({} as any, { message: "hello" });
     expect(result).toBe("LOG: hello");
   });
 
@@ -187,7 +187,7 @@ describe("Extensibility", () => {
       return args.defaultField;
     });
 
-    const result = await chained({} as any)({ defaultField: "test" });
+    const result = await chained({} as any, { defaultField: "test" });
     expect(result).toBe("test");
   });
 
@@ -209,7 +209,7 @@ describe("Extensibility", () => {
         return `${args.defaultField}-${ctx.extra}`;
       });
 
-    const result = await chained({} as any)({ defaultField: "value" });
+    const result = await chained({} as any, { defaultField: "value" });
     expect(result).toBe("value-data");
   });
 

package/src/middleware-onion.test.ts

@@ -40,7 +40,7 @@ describe("Onion middleware composition", () => {
         return { done: true };
       });
 
-    await fn({} as any)({});
+    await fn({} as any, {});
 
     // Onion order: outer wraps inner wraps handler
     expect(order).toEqual([
@@ -71,7 +71,7 @@ describe("Onion middleware composition", () => {
         throw new Error("handler exploded");
       });
 
-    await expect(fn({} as any)({})).rejects.toThrow("handler exploded");
+    await expect(fn({} as any, {})).rejects.toThrow("handler exploded");
 
     // The middleware should have intercepted the error
     expect(caughtError).toBe("handler exploded");
@@ -95,7 +95,7 @@ describe("Onion middleware composition", () => {
         return { done: true };
       });
 
-    await fn({} as any)({});
+    await fn({} as any, {});
 
     // next() should block until the handler completes,
     // so measured duration should include the 50ms sleep
@@ -122,7 +122,7 @@ describe("Onion middleware composition", () => {
         };
       });
 
-    const result = await fn({} as any)({});
+    const result = await fn({} as any, {});
     expect(result).toEqual({ user: "alice", timestamp: 12345 });
   });
 });

package/src/types.ts

@@ -70,8 +70,9 @@ export type CallableBuilder<
   THandlerReturn,
 > = {
   (
-    context: TCurrentContext
-  ): (args: InferredArgs<TArgsValidator>) => Promise<THandlerReturn>;
+    context: TCurrentContext,
+    args: InferredArgs<TArgsValidator>
+  ): Promise<THandlerReturn>;
 };
 export interface ConvexBuilderDef<
   TFunctionType extends FunctionType | undefined = undefined,

package/src/zod/withZod.test-d.ts

@@ -201,8 +201,9 @@ describe("WithZod Callable Builder", () => {
     // Should be callable
     assertType<
       (
-        context: any
-      ) => (args: { count: number }) => Promise<{ count: number }>
+        context: any,
+        args: { count: number }
+      ) => Promise<{ count: number }>
     >(callableQuery);
   });
 });

package/src/zod/withZod.test.ts

@@ -83,7 +83,7 @@ describe("WithZod plugin", () => {
         return { result: input.count * 2 };
       });
 
-    const result = await fn({} as any)({ count: 5 });
+    const result = await fn({} as any, { count: 5 });
     expect(result).toEqual({ result: 10 });
   });
 
@@ -96,7 +96,7 @@ describe("WithZod plugin", () => {
         return { numbers: [1, 2, 3] };
       });
 
-    const result = await fn({} as any)({});
+    const result = await fn({} as any, {});
     expect(result).toEqual({ numbers: [1, 2, 3] });
   });
 
@@ -110,11 +110,11 @@ describe("WithZod plugin", () => {
       });
 
     // Valid input should pass
-    const result = await fn({} as any)({ count: 5 });
+    const result = await fn({} as any, { count: 5 });
     expect(result).toBe(5);
 
     // Invalid input should throw
-    await expect(fn({} as any)({ count: -1 })).rejects.toThrow();
+    await expect(fn({} as any, { count: -1 })).rejects.toThrow();
   });
 
   it("should validate Zod returns refinements at runtime", async () => {
@@ -126,7 +126,7 @@ describe("WithZod plugin", () => {
         return -1; // This should fail validation
       });
 
-    await expect(fn({} as any)({})).rejects.toThrow();
+    await expect(fn({} as any, {})).rejects.toThrow();
   });
 
   it("should work with plain Convex validators when using WithZod", async () => {
@@ -138,7 +138,7 @@ describe("WithZod plugin", () => {
         return input.count;
       });
 
-    const result = await fn({} as any)({ count: 42 });
+    const result = await fn({} as any, { count: 42 });
     expect(result).toBe(42);
   });
 
@@ -157,7 +157,7 @@ describe("WithZod plugin", () => {
         return `${input.name}-${ctx.extra}`;
       });
 
-    const result = await fn({} as any)({ name: "test" });
+    const result = await fn({} as any, { name: "test" });
     expect(result).toBe("test-data");
   });
 
@@ -175,6 +175,6 @@ describe("WithZod plugin", () => {
         return input.name;
       });
 
-    await expect(fn({} as any)({ name: "" })).rejects.toThrow();
+    await expect(fn({} as any, { name: "" })).rejects.toThrow();
   });
 });