feat: make method optional for multi-method endpoints (#90)

* feat: optional method

* update README

* chore: trigger ci rebuild

Author: Paola3stefania

README.md

@@ -158,6 +158,41 @@ const createItem = createEndpoint("/item", {
 })
 ```
 
+#### Method
+
+You can specify a single HTTP method or an array of methods for an endpoint.
+
+```ts
+// Single method
+const getItem = createEndpoint("/item", {
+    method: "GET",
+}, async (ctx) => {
+    return { item: "data" }
+})
+
+// Multiple methods
+const itemEndpoint = createEndpoint("/item", {
+    method: ["GET", "POST"],
+}, async (ctx) => {
+    if (ctx.method === "POST") {
+        // handle POST - create/update
+        return { created: true }
+    }
+    // handle GET - read only
+    return { item: "data" }
+})
+```
+
+When calling an endpoint with multiple methods directly (not through HTTP), the `method` parameter is **optional** and defaults to the **first method** in the array:
+
+```ts
+// Defaults to "GET" (first in array)
+const result = await itemEndpoint({ headers })
+
+// Explicitly specify POST
+const result = await itemEndpoint({ headers, method: "POST" })
+```
+
 #### Media types
 
 By default, all media types are accepted, but only a handful of them have a built-in support:

src/context.ts

@@ -92,7 +92,7 @@ export type InferMethod<Options extends EndpointOptions> = Options["method"] ext
 export type InferInputMethod<
 	Options extends EndpointOptions,
 	Method = Options["method"] extends Array<any>
-		? Options["method"][number]
+		? Options["method"][number] | undefined
 		: Options["method"] extends "*"
 			? HTTPMethod
 			: Options["method"] | undefined,
@@ -208,7 +208,13 @@ export const createInternalContext = async (
 		headers: context?.headers,
 		request: context?.request,
 		params: "params" in context ? context.params : undefined,
-		method: context.method,
+		method:
+			context.method ??
+			(Array.isArray(options.method)
+				? options.method[0]
+				: options.method === "*"
+					? "GET"
+					: options.method),
 		setHeader: (key: string, value: string) => {
 			headers.set(key, value);
 		},

src/endpoint.test.ts

@@ -354,8 +354,11 @@ describe("types", async () => {
 				expectTypeOf(ctx.method).toEqualTypeOf<"POST" | "GET">();
 			},
 		);
-		//@ts-expect-error - method should be required
+		// method should be optional for array methods (defaults to first method)
 		endpoint({});
+		// but you can still explicitly specify a method
+		endpoint({ method: "POST" });
+		endpoint({ method: "GET" });
 		const wildCardMethodEndpoint = createEndpoint(
 			"/test",
 			{
@@ -367,7 +370,7 @@ describe("types", async () => {
 				>();
 			},
 		);
-		//@ts-expect-error -
+		//@ts-expect-error - wildcard method should still require explicit method
 		wildCardMethodEndpoint({});
 	});
 	it("response", async () => {