better-call 1.0.25-beta.3 → 1.0.26-beta.1

package/README.md

@@ -78,7 +78,27 @@ const items = await client("/item", {
 
 ### Returning non 200 responses
 
-To return a non 200 response, you will need to throw Better Call's `APIError` error. If the endpoint is called as a function, the error will be thrown but if it's mounted to a router, the error will be converted to a response object with the correct status code and headers.
+There are several supported ways to a non 200 response:
+
+You can use the `ctx.setStatus(status)` helper to change the default status code of a successful response:
+
+```ts
+const createItem = createEndpoint("/item", {
+    method: "POST",
+    body: z.object({
+        id: z.string()
+    })
+}, async (ctx) => {
+    ctx.setStatus(201);
+    return {
+        item: {
+            id: ctx.body.id
+        }
+    }
+})
+```
+
+Sometimes, you want to respond with an error, in those cases you will need to throw Better Call's `APIError` error. If the endpoint is called as a function, the error will be thrown but if it's mounted to a router, the error will be converted to a response object with the correct status code and headers.
 
 ```ts
 const createItem = createEndpoint("/item", {
@@ -122,6 +142,23 @@ const createItem = createEndpoint("/item", {
 })
 ```
 
+Finally, you can return a new `Response` object. In this case, the `ctx.setStatus()` call will be ignored, as the `Response` will have completely control over the final status code:
+
+```ts
+const createItem = createEndpoint("/item", {
+    method: "POST",
+    body: z.object({
+        id: z.string()
+    })
+}, async (ctx) => {
+    return Response.json({
+        item: {
+            id: ctx.body.id
+        }
+    }, { status: 201 });
+})
+```
+
 ### Endpoint
 
 Endpoints are building blocks of better-call. 

package/dist/client.d.cts

@@ -1,4 +1,4 @@
-import { Endpoint, HasRequiredKeys, Router, UnionToIntersection } from "./router-DOTL_ENw.cjs";
+import { Endpoint, HasRequiredKeys, Router, UnionToIntersection } from "./router-CeSGPJlX.cjs";
 import { BetterFetchOption, BetterFetchResponse } from "@better-fetch/fetch";
 
 //#region src/client.d.ts

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import { Endpoint, HasRequiredKeys, Router, UnionToIntersection } from "./router-CC_up1_c.js";
+import { Endpoint, HasRequiredKeys, Router, UnionToIntersection } from "./router-BH6Wndse.js";
 import { BetterFetchOption, BetterFetchResponse } from "@better-fetch/fetch";
 
 //#region src/client.d.ts

package/dist/index.cjs

@@ -417,6 +417,7 @@ const serializeSignedCookie = async (key, value, secret, opt) => {
 //#region src/context.ts
 const createInternalContext = async (context, { options, path }) => {
 	const headers = new Headers();
+	let responseStatus = void 0;
 	const { data, error } = await runValidation(options, context);
 	if (error) throw new APIError(400, {
 		message: error.message,
@@ -477,6 +478,9 @@ const createInternalContext = async (context, { options, path }) => {
 		error: (status, body, headers$1) => {
 			return new APIError(status, body, headers$1);
 		},
+		setStatus: (status) => {
+			responseStatus = status;
+		},
 		json: (json, routerResponse) => {
 			if (!context.asResponse) return json;
 			return {
@@ -485,7 +489,10 @@ const createInternalContext = async (context, { options, path }) => {
 				_flag: "json"
 			};
 		},
-		responseHeaders: headers
+		responseHeaders: headers,
+		get responseStatus() {
+			return responseStatus;
+		}
 	};
 	for (const middleware of options.use || []) {
 		const response = await middleware({
@@ -523,9 +530,20 @@ const createEndpoint = (path, options, handler) => {
 			throw e;
 		});
 		const headers = internalContext.responseHeaders;
-		return context.asResponse ? toResponse(response, { headers }) : context.returnHeaders ? {
+		const status = internalContext.responseStatus;
+		return context.asResponse ? toResponse(response, {
+			headers,
+			status
+		}) : context.returnHeaders ? context.returnStatus ? {
+			headers,
+			response,
+			status
+		} : {
 			headers,
 			response
+		} : context.returnStatus ? {
+			response,
+			status
 		} : response;
 	};
 	internalHandler.options = options;