next-zero-rpc 0.1.4 → 0.1.6

package/README.md

@@ -2,6 +2,8 @@
 
 Type-safe fetch for Next.js — zero runtime, zero config, zero dependencies.
 
+[![Open in CodeSandbox](https://codesandbox.io/static/img/play-codesandbox.svg)](https://codesandbox.io/p/sandbox/github/caocchinh/next-zero-rpc/tree/main/examples/minimal)
+
 ```bash
 npx next-zero-rpc init
 ```
@@ -507,6 +509,24 @@ Since you own all the source files, you can customize anything:
 - **Change the output path** — Update `REGISTRY_FILE` in `update-api-registry.mjs`
 - **Override the generator** — The `withApiRegistry` plugin and `updateApiRegistry()` function are fully yours to modify
 
+## Examples
+
+### Try it online
+
+[![Open in CodeSandbox](https://codesandbox.io/static/img/play-codesandbox.svg)](https://codesandbox.io/p/sandbox/github/caocchinh/next-zero-rpc/tree/main/examples/minimal)
+
+Opens [`examples/minimal`](https://github.com/caocchinh/next-zero-rpc/tree/main/examples/minimal) — a self-contained Next.js app with a working `apiFetch` client and two example API routes.
+
+### Run locally
+
+```bash
+# Clone just the example folder (no git history)
+npx degit caocchinh/next-zero-rpc/examples/minimal my-app
+cd my-app
+npm install
+npm run dev
+```
+
 ## CLI Usage
 
 ```bash
@@ -518,9 +538,11 @@ npx next-zero-rpc --help       # Show help
 
 ## Requirements
 
-- Next.js (App Router)
-- TypeScript
-- Node.js ≥ 18
+| Requirement | Minimum Version | Reason |
+| ----------- | --------------- | ------ |
+| Next.js | **14.0** | App Router (stable since 14.0) |
+| TypeScript | **4.9** | `satisfies` keyword used in `responses.ts` |
+| Node.js | **18** | Native `fetch` API required by `apiFetch` |
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "next-zero-rpc",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Type-safe fetch for Next.js — zero runtime, zero config, zero dependencies.",
   "keywords": [
     "nextjs",

package/templates/apiClient.ts

@@ -7,33 +7,29 @@ type HttpMethod = "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTION
 // ─── Type Inference ─────────────────────────────────────────────────────────
 
 /**
- * Infer the success response type from an API route handler function.
- * Filters out ApiErrorPayload to only return the success payload.
+ * Extracts the inner payload type U from a route handler returning NextResponse<U>.
  */
-type InferSuccessApiResponse<T, E = never> = T extends (...args: never[]) => infer R
+type UnwrapNextResponse<T> = T extends (...args: never[]) => infer R
   ? Extract<Awaited<R>, NextResponse<unknown>> extends NextResponse<infer U>
-    ? Exclude<U, E>
-    : never
-  : never;
-
-type InferErrorApiResponse<T, E = never> = T extends (...args: never[]) => infer R
-  ? Extract<Awaited<R>, NextResponse<unknown>> extends NextResponse<infer U>
-    ? Extract<U, E>
+    ? U
     : never
   : never;
 
 type ResolveRoute<Path extends string> =
   FindMatchingRoute<Path> extends keyof KnownRoutes ? FindMatchingRoute<Path> : never;
 
+type RouteHandler<Path extends string, M extends HttpMethod> =
+  KnownRoutes[ResolveRoute<Path>][M & keyof KnownRoutes[ResolveRoute<Path>]];
+
 type RouteMethods<Path extends string> = Extract<keyof KnownRoutes[ResolveRoute<Path>], HttpMethod>;
 
-type RouteSuccessResult<Path extends string, M extends HttpMethod> = InferSuccessApiResponse<
-  KnownRoutes[ResolveRoute<Path>][M & keyof KnownRoutes[ResolveRoute<Path>]],
+type RouteSuccessResult<Path extends string, M extends HttpMethod> = Exclude<
+  UnwrapNextResponse<RouteHandler<Path, M>>,
   ApiErrorPayload<ErrorCode>
 >;
 
-type RouteErrorResult<Path extends string, M extends HttpMethod> = InferErrorApiResponse<
-  KnownRoutes[ResolveRoute<Path>][M & keyof KnownRoutes[ResolveRoute<Path>]],
+type RouteErrorResult<Path extends string, M extends HttpMethod> = Extract<
+  UnwrapNextResponse<RouteHandler<Path, M>>,
   ApiErrorPayload<ErrorCode>
 >;