@rest-rpc/next 0.1.0-beta.13 → 0.1.0-beta.14

package/dist/index.d.ts

@@ -1,2 +1,2 @@
 export { type ClearCookieOptions, clearCookie, type RouteErrors, type RouteRequestData, RouteResponseError, type RouteResponseShorthand, type SetCookieOptions, setCookie, } from "@rest-rpc/web";
-export { type CreateRouteHandlerOptions, createRouteHandler, type NextRouteMiddleware, type RouteRequest, type RouteResponse, route, router, } from "./server.ts";
+export { type CreateRouteHandlerOptions, createRouteHandler, type NextRouteMiddleware, type RouteHandlers, type RouteRequest, type RouteResponse, route, router, } from "./server.ts";

package/dist/server.d.ts

@@ -1,5 +1,5 @@
 import type { HttpRouteDeclaration } from "@rest-rpc/core/contract";
-import { type CreateWebHandlerOptions, type WebContract, type WebImplementationTree, type WebRouteBuilder, type WebRouteMiddleware, type WebRouteParseBodyInput, type RouteRequest as WebRouteRequest, type RouteResponse as WebRouteResponse, type WebRouterBuilder } from "@rest-rpc/web";
+import { type CreateWebHandlerOptions, type WebContract, type WebImplementationTree, type WebRouteBuilder, type RouteHandlers as WebRouteHandlers, type WebRouteMiddleware, type WebRouteParseBodyInput, type RouteRequest as WebRouteRequest, type RouteResponse as WebRouteResponse, type WebRouterBuilder } from "@rest-rpc/web";
 import type { NextRequest } from "next/server.js";
 /**
  * Middleware function shape for Next.js route handlers.
@@ -19,6 +19,24 @@ export type RouteRequest<E extends HttpRouteDeclaration, TContext extends Record
  * @see {@link https://rest-rpc.dev/docs/type-helpers#server}
  */
 export type RouteResponse<E extends HttpRouteDeclaration> = WebRouteResponse<E>;
+/**
+ * Handler tree accepted by `router().handlers()` when building a Next.js implementation tree.
+ *
+ * @remarks Use this type with `implements` to check class-based route handler
+ * services against a contract tree.
+ *
+ * @example
+ * ```ts
+ * class TodoHandlers implements RouteHandlers<typeof api.todos> {
+ *   get(request: RouteRequest<typeof api.todos.get>) {
+ *     return { id: request.id };
+ *   }
+ * }
+ * ```
+ *
+ * @see {@link https://rest-rpc.dev/docs/recipes/class-handlers}
+ */
+export type RouteHandlers<TContract extends WebContract, TContext extends Record<string, unknown> = Record<string, unknown>> = WebRouteHandlers<TContract, TContext, NextRequest>;
 /**
  * Options for creating Next.js route handler exports.
  *
@@ -29,13 +47,13 @@ export type CreateRouteHandlerOptions = {
     parseBody?: (input: WebRouteParseBodyInput) => unknown | Promise<unknown>;
 };
 /**
- * Creates a fluent Next.js route builder for a single HTTP route.
+ * Creates a Next.js route implementation builder for a single HTTP route.
  *
  * @see {@link https://rest-rpc.dev/docs/server/next.js#single-route-handler}
  */
 export declare function route<const TRoute extends HttpRouteDeclaration>(contract: TRoute): WebRouteBuilder<TRoute, Record<never, never>, NextRequest>;
 /**
- * Creates a fluent Next.js router builder for a contract tree.
+ * Creates a Next.js router implementation builder for a contract tree.
  *
  * @see {@link https://rest-rpc.dev/docs/server/next.js#catch-all-route-handler}
  */

package/dist/server.js

@@ -1,6 +1,6 @@
 import { createRouteHandler as createWebRouteHandler, route as webRoute, router as webRouter, } from "@rest-rpc/web";
 /**
- * Creates a fluent Next.js route builder for a single HTTP route.
+ * Creates a Next.js route implementation builder for a single HTTP route.
  *
  * @see {@link https://rest-rpc.dev/docs/server/next.js#single-route-handler}
  */
@@ -8,7 +8,7 @@ export function route(contract) {
     return webRoute(contract);
 }
 /**
- * Creates a fluent Next.js router builder for a contract tree.
+ * Creates a Next.js router implementation builder for a contract tree.
  *
  * @see {@link https://rest-rpc.dev/docs/server/next.js#catch-all-route-handler}
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rest-rpc/next",
-  "version": "0.1.0-beta.13",
+  "version": "0.1.0-beta.14",
   "type": "module",
   "license": "MIT",
   "description": "Next.js adapter for serving and consuming rest-rpc contracts in App Router projects.",
@@ -40,8 +40,8 @@
     "directory": "test-d"
   },
   "dependencies": {
-    "@rest-rpc/core": "0.1.0-beta.13",
-    "@rest-rpc/web": "0.1.0-beta.13"
+    "@rest-rpc/web": "0.1.0-beta.14",
+    "@rest-rpc/core": "0.1.0-beta.14"
   },
   "peerDependencies": {
     "next": ">=15"