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

package/README.md

@@ -8,7 +8,7 @@ server handlers, fetch clients, openAPI documents, and more from it.
 ## Features
 
 - Shared TypeScript contracts for HTTP APIs.
-- Typed server handlers for Express, Hono, Fastify, Next.js, and Fetch runtimes.
+- Typed server handlers for Express, Hono, Fastify, NestJS, Next.js, and Fetch runtimes.
 - Typed fetch client.
 - Typed TanStack Query helpers.
 - Typed WebSockets, streaming, non-JSON requests/responses.
@@ -76,6 +76,7 @@ Full documentation is available at [rest-rpc.dev](https://rest-rpc.dev)
 - [`@rest-rpc/express`](https://npmx.dev/package/@rest-rpc/express): Express server adapter.
 - [`@rest-rpc/fastify`](https://npmx.dev/package/@rest-rpc/fastify): Fastify server adapter.
 - [`@rest-rpc/hono`](https://npmx.dev/package/@rest-rpc/hono): Hono server adapter.
+- [`@rest-rpc/nest`](https://npmx.dev/package/@rest-rpc/nest): NestJS server adapter.
 - [`@rest-rpc/next`](https://npmx.dev/package/@rest-rpc/next): Next.js adapter.
-- [`@rest-rpc/web`](https://npmx.dev/package/@rest-rpc/web): Fetch runtime adapter
+- [`@rest-rpc/fetch`](https://npmx.dev/package/@rest-rpc/fetch): Fetch runtime adapter
 - [`@rest-rpc/tanstack-query`](https://npmx.dev/package/@rest-rpc/tanstack-query): TanStack Query adapter.

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 ClearCookieOptions, clearCookie, type RouteErrors, type RouteRequestData, RouteResponseError, type RouteResponseShorthand, type SetCookieOptions, setCookie, type SseEvent, sseEvent, } from "@rest-rpc/fetch";
+export { type CreateRouteHandlerOptions, createRouteHandler, type NextRouteMiddleware, type RouteHandlers, type RouteRequest, type RouteResponse, route, router, } from "./server.ts";

package/dist/index.js

@@ -1,2 +1,2 @@
-export { clearCookie, RouteResponseError, setCookie, } from "@rest-rpc/web";
+export { clearCookie, RouteResponseError, setCookie, sseEvent, } from "@rest-rpc/fetch";
 export { createRouteHandler, route, router, } from "./server.js";

package/dist/server.d.ts

@@ -1,52 +1,70 @@
 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 CreateFetchHandlerOptions, type FetchContract, type FetchImplementationTree, type FetchRouteBuilder, type RouteHandlers as FetchRouteHandlers, type FetchRouteMiddleware, type FetchRouteParseBodyInput, type RouteRequest as FetchRouteRequest, type RouteResponse as FetchRouteResponse, type FetchRouterBuilder } from "@rest-rpc/fetch";
 import type { NextRequest } from "next/server.js";
 /**
  * Middleware function shape for Next.js route handlers.
  *
  * @see {@link https://rest-rpc.dev/docs/server/next.js#framework-context}
  */
-export type NextRouteMiddleware<TContext extends Record<string, unknown>> = WebRouteMiddleware<Record<never, never>, TContext, NextRequest>;
+export type NextRouteMiddleware<TContext extends Record<string, unknown>> = FetchRouteMiddleware<Record<never, never>, TContext, NextRequest>;
 /**
  * Infers the Next.js route handler request type for a route declaration.
  *
  * @see {@link https://rest-rpc.dev/docs/type-helpers#server}
  */
-export type RouteRequest<E extends HttpRouteDeclaration, TContext extends Record<string, unknown> = Record<string, unknown>> = WebRouteRequest<E, TContext, NextRequest>;
+export type RouteRequest<E extends HttpRouteDeclaration, TContext extends Record<string, unknown> = Record<string, unknown>> = FetchRouteRequest<E, TContext, NextRequest>;
 /**
  * Infers the explicit response union for a Next.js HTTP route.
  *
  * @see {@link https://rest-rpc.dev/docs/type-helpers#server}
  */
-export type RouteResponse<E extends HttpRouteDeclaration> = WebRouteResponse<E>;
+export type RouteResponse<E extends HttpRouteDeclaration> = FetchRouteResponse<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/organizing-route-handlers#service-classes-as-handlers}
+ */
+export type RouteHandlers<TContract extends FetchContract, TContext extends Record<string, unknown> = Record<string, unknown>> = FetchRouteHandlers<TContract, TContext, NextRequest>;
 /**
  * Options for creating Next.js route handler exports.
  *
  * @see {@link https://rest-rpc.dev/docs/server/next.js#options}
  */
 export type CreateRouteHandlerOptions = {
-    errorHandlers?: CreateWebHandlerOptions["errorHandlers"];
-    parseBody?: (input: WebRouteParseBodyInput) => unknown | Promise<unknown>;
+    errorHandlers?: CreateFetchHandlerOptions["errorHandlers"];
+    parseBody?: (input: FetchRouteParseBodyInput) => 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>;
+export declare function route<const TRoute extends HttpRouteDeclaration>(contract: TRoute): FetchRouteBuilder<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}
  */
-export declare function router<const TContract extends WebContract>(contract: TContract): WebRouterBuilder<TContract, Record<never, never>, NextRequest>;
+export declare function router<const TContract extends FetchContract>(contract: TContract): FetchRouterBuilder<TContract, Record<never, never>, NextRequest>;
 /**
  * Creates Next.js route handler exports from route implementations.
  *
- * @remarks This wrapper passes only the `NextRequest`; use `@rest-rpc/web` directly for custom runtime context.
+ * @remarks This wrapper passes only the `NextRequest`; use `@rest-rpc/fetch` directly for custom runtime context.
  * @see {@link https://rest-rpc.dev/docs/server/next.js#custom-runtime-context}
  */
-export declare function createRouteHandler(implementations: WebImplementationTree, options?: CreateRouteHandlerOptions): {
+export declare function createRouteHandler(implementations: FetchImplementationTree, options?: CreateRouteHandlerOptions): {
     DELETE: (request: Request) => Promise<Response>;
     GET: (request: Request) => Promise<Response>;
     PATCH: (request: Request) => Promise<Response>;

package/dist/server.js

@@ -1,28 +1,28 @@
-import { createRouteHandler as createWebRouteHandler, route as webRoute, router as webRouter, } from "@rest-rpc/web";
+import { createRouteHandler as createFetchRouteHandler, route as fetchRoute, router as fetchRouter, } from "@rest-rpc/fetch";
 /**
- * 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 function route(contract) {
-    return webRoute(contract);
+    return fetchRoute(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}
  */
 export function router(contract) {
-    return webRouter(contract);
+    return fetchRouter(contract);
 }
 /**
  * Creates Next.js route handler exports from route implementations.
  *
- * @remarks This wrapper passes only the `NextRequest`; use `@rest-rpc/web` directly for custom runtime context.
+ * @remarks This wrapper passes only the `NextRequest`; use `@rest-rpc/fetch` directly for custom runtime context.
  * @see {@link https://rest-rpc.dev/docs/server/next.js#custom-runtime-context}
  */
 export function createRouteHandler(implementations, options) {
-    const handle = createWebRouteHandler(implementations, {
+    const handle = createFetchRouteHandler(implementations, {
         errorHandlers: options?.errorHandlers,
         parseBody: options?.parseBody,
     });

package/package.json

@@ -1,30 +1,33 @@
 {
   "name": "@rest-rpc/next",
-  "version": "0.1.0-beta.13",
-  "type": "module",
-  "license": "MIT",
+  "version": "0.1.0-beta.15",
   "description": "Next.js adapter for serving and consuming rest-rpc contracts in App Router projects.",
   "keywords": [
-    "rest-rpc",
-    "typescript",
-    "rpc",
-    "rest",
     "api-contract",
+    "app-router",
     "contract-first",
-    "type-safe-api",
+    "fetch",
     "next",
     "nextjs",
-    "app-router",
-    "route-handler",
-    "fetch",
     "react",
-    "server-components"
+    "rest",
+    "rest-rpc",
+    "route-handler",
+    "rpc",
+    "server-components",
+    "type-safe-api",
+    "typescript"
   ],
+  "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/rest-rpc/rest-rpc.git",
     "directory": "packages/next"
   },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
@@ -33,21 +36,18 @@
       "import": "./dist/index.js"
     }
   },
-  "files": [
-    "dist"
-  ],
-  "tsd": {
-    "directory": "test-d"
-  },
   "dependencies": {
-    "@rest-rpc/core": "0.1.0-beta.13",
-    "@rest-rpc/web": "0.1.0-beta.13"
+    "@rest-rpc/fetch": "0.1.0-beta.15",
+    "@rest-rpc/core": "0.1.0-beta.15"
+  },
+  "devDependencies": {
+    "next": "16.3.1"
   },
   "peerDependencies": {
     "next": ">=15"
   },
-  "devDependencies": {
-    "next": "16.3.1"
+  "tsd": {
+    "directory": "test-d"
   },
   "scripts": {
     "build": "tsc -p tsconfig.build.json",