better-call 0.0.5-beta.9 → 0.1.0

package/README.md

@@ -1,10 +1,10 @@
 # better-call
 
-Better call is a tiny web framework for creating endpoints that can be invoked as a normal function or mounted to a router and can be served by any web standard compatible server (like Bun, node, nextjs, sveltekit...). 
+Better call is a tiny web framework for creating endpoints that can be invoked as a normal function or mounted to a router to be served by any web standard compatible server (like Bun, node, nextjs, sveltekit...) and also includes a typed RPC client for typesafe client-side invocation of these endpoints.
 
 Built for typescript and it comes with a very high performance router based on [rou3](https://github.com/unjs/rou3).
 
-> ⚠️ This project early in development and not ready for production use. But feel free to try it out and give feedback.
+> ⚠️ This project in development and not ready for production use. But feel free to try it out and give feedback.
 
 ## Install
 
@@ -12,9 +12,15 @@ Built for typescript and it comes with a very high performance router based on [
 pnpm i better-call
 ```
 
+make sure to install zod if you haven't
+
+```bash
+pnpm i zod
+```
+
 ## Usage
 
-The building blocks for better-call are endpoints. You can create an endpoint by calling `createEndpoint` and passing it a path, [options](#endpointoptions) and a function that will be invoked when the endpoint is called.
+The building blocks for better-call are endpoints. You can create an endpoint by calling `createEndpoint` and passing it a path, [options](#endpointoptions) and a handler that will be invoked when the endpoint is called.
 
 ```ts
 import { createEndpoint, createRouter } from "better-call"
@@ -46,15 +52,178 @@ OR you can mount the endpoint to a router and serve it with any web standard com
 > The example below uses [Bun](https://bun.sh/)
 
 ```ts
-const router = createRouter([
+const router = createRouter({
     createItem
-])
+})
 
 Bun.serve({
     fetch: router.handler
 })
 ```
 
+Then you can use the rpc client to call the endpoints on client.
+
+```ts
+//client.ts
+import { createClient } from "better-call/client";
+
+const client = createClient<typeof router>();
+const items = await client("/item", {
+    body: {
+        id: "123"
+    }
+});
+```
+
+### 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.
+
+```ts
+const createItem = createEndpoint("/item", {
+    method: "POST",
+    body: z.object({
+        id: z.string()
+    })
+}, async (ctx) => {
+    if(ctx.body.id === "123") {
+        throw new APIError("Bad Request", {
+            message: "Id is not allowed"
+        })
+    }
+    return {
+        item: {
+            id: ctx.body.id
+        }
+    }
+})
+```
+
+### Endpoint
+
+Endpoints are building blocks of better-call. 
+
+#### Path
+
+The path is the URL path that the endpoint will respond to. It can be a direct path or a path with parameters and wildcards.
+
+```ts
+//direct path
+const endpoint = createEndpoint("/item", {
+    method: "GET",
+}, async (ctx) => {})
+
+//path with parameters
+const endpoint = createEndpoint("/item/:id", {
+    method: "GET",
+}, async (ctx) => {
+    return {
+        item: {
+            id: ctx.params.id
+        }
+    }
+})
+
+//path with wildcards
+const endpoint = createEndpoint("/item/**:name", {
+    method: "GET",  
+}, async (ctx) => {
+    //the name will be the remaining path
+    ctx.params.name
+})
+```
+#### Body Schema
+
+The `body` option accepts a zod schema and will validate the request body. If the request body doesn't match the schema, the endpoint will throw an error. If it's mounted to a router, it'll return a 400 error.
+
+```ts
+const createItem = createEndpoint("/item", {
+    method: "POST",
+    body: z.object({
+        id: z.string()
+    })
+}, async (ctx) => {
+    return {
+        item: {
+            id: ctx.body.id
+        }
+    }
+})
+```
+
+#### Query Schema
+
+The `query` option accepts a zod schema and will validate the request query. If the request query doesn't match the schema, the endpoint will throw an error. If it's mounted to a router, it'll return a 400 error.
+
+```ts
+const createItem = createEndpoint("/item", {
+    method: "GET",
+    query: z.object({
+        id: z.string()
+    })
+}, async (ctx) => {
+    return {
+        item: {
+            id: ctx.query.id
+        }
+    }
+})
+```
+
+#### Require Headers
+
+The `requireHeaders` option is used to require the request to have headers. If the request doesn't have headers, the endpoint will throw an error. And even when you call the endpoint as a function, it will require headers to be passed in the context.
+
+```ts
+const createItem = createEndpoint("/item", {
+    method: "GET",
+    requireHeaders: true
+}, async (ctx) => {
+    return {
+        item: {
+            id: ctx.headers.get("id")
+        }
+    }
+})
+createItem({
+    headers: new Headers()
+})
+```
+
+#### Require Request
+
+The `requireRequest` option is used to require the request to have a request object. If the request doesn't have a request object, the endpoint will throw an error. And even when you call the endpoint as a function, it will require a request to be passed in the context.
+
+```ts
+const createItem = createEndpoint("/item", {
+    method: "GET",
+    requireRequest: true
+}, async (ctx) => {
+    return {
+        item: {
+            id: ctx.request.id
+        }
+    }
+})
+
+createItem({
+    request: new Request()
+})
+```
+
+
+### Handler
+
+this is the function that will be invoked when the endpoint is called. It accepts a context object that contains the request, headers, body, query, params and other information. 
+
+It can return a response object, a string, a boolean, a number, an object with a status, body, headers and other properties or undefined.
+
+If you return a response object, it will be returned as is even when it's mounted to a router.
+
+It can also throw an error and if it throws APIError, it will be converted to a response object with the correct status code and headers.
+
+- **Context**: the context object contains the request, headers, body, query, params and a helper function to set headers, cookies and get cookies. If there is a middleware, the context will be extended with the middleware context.
+
 ### Middleware
 
 Endpoints can use middleware by passing the `use` option to the endpoint. To create a middleware, you can call `createMiddleware` and pass it a function or an options object and a handler function.
@@ -106,16 +275,22 @@ You can create a router by calling `createRouter` and passing it an array of end
 import { createRouter } from "better-call"
 import { createItem } from "./item"
 
-const router = createRouter([
+const router = createRouter({
     createItem
-])
+})
+
+Bun.serve({
+    fetch: router.handler
+})
 ```
 
 Behind the scenes, the router uses [rou3](https://github.com/unjs/rou3) to match the endpoints and invoke the correct endpoint. You can look at the [rou3 documentation](https://github.com/unjs/rou3) for more information.
 
 #### Router Options
 
-**routerMiddleware**: A router middleware is similar to an endpoint middleware but it's applied to any path that matches the route. You have to pass endpoints to the router middleware as an array.
+**routerMiddleware:**
+
+A router middleware is similar to an endpoint middleware but it's applied to any path that matches the route. It's like any traditional middleware. You have to pass endpoints to the router middleware as an array.
 
 ```ts
 const routeMiddleware = createEndpoint("/api/**", {
@@ -125,10 +300,13 @@ const routeMiddleware = createEndpoint("/api/**", {
         name: "hello"
     }
 })
-const router = createRouter([
+const router = createRouter({
     createItem
-], {
-    routerMiddleware: [routeMiddleware]
+}, {
+    routerMiddleware: [{
+        path: "/api/**",
+        middleware:routeMiddleware
+    }]
 })
 ```
 
@@ -138,30 +316,29 @@ const router = createRouter([
 
 **throwError**: If true, the router will throw an error if an error occurs in the middleware or the endpoint.
 
+### RPC Client
 
-### 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.
+better-call comes with a rpc client that can be used to call endpoints from the client. The client wraps over better-fetch so you can pass any options that are supported by better-fetch.
 
 ```ts
-const createItem = createEndpoint("/item", {
-    method: "POST",
-    body: z.object({
-        id: z.string()
-    })
-}, async (ctx) => {
-    if(ctx.body.id === "123") {
-        throw new APIError("Bad Request", {
-            message: "Id is not allowed"
-        })
-    }
-    return {
-        item: {
-            id: ctx.body.id
-        }
+import { createClient } from "better-call/client";
+import { router } from "@serve/router";
+
+const client = createClient<typeof router>({
+    /**
+     * if you add custom path like `http://
+     * localhost:3000/api` make sure to add the 
+     * custom path on the router config as well.
+    */
+    baseURL: "http://localhost:3000"
+});
+const items = await client("/item", {
+    body: {
+        id: "123"
     }
-})
+});
 ```
+> You can also pass object that contains endpoints as a generic type to create client.
 
 ### Headers and Cookies
 
@@ -202,66 +379,7 @@ const createItem = createEndpoint("/item", {
 })
 ```
 
-### Endpoint Parameters
-
-### `path`
-
-The path defines how the framework matches requests to endpoints. It can include parameters and wildcards that are extracted from the request and passed to the endpoint function.
-
-1. **Path Parameters**: 
-   - Use `:` to define a parameter in the path. For example, `/item/:id` will extract the `id` from the request URL and pass it to the endpoint function as part of the `params` object.
-     - Example: For a request to `/item/123`, the endpoint function will receive `{ id: '123' }`.
-
-2. **Wildcards**:
-   - Use `*` or `**` to match any part of the path. When using a wildcard, the remaining path will be captured in the `params` object under the `_` property.
-     - Example: For a path `/item/*`, a request to `/item/abc/def` will pass `{ _: 'abc/def' }` to the endpoint function.
-
-3. **Named Wildcards**:
-   - To capture the remaining path with a specific name, use `*:` followed by the desired name. The remaining path will be assigned to this named property.
-     - Example: For a path `/item/*:name`, a request to `/item/abc/def` will pass `{ name: 'abc/def' }` to the endpoint function.
-
-
-### `EndpointOptions`
-
-```ts
-type EndpointOptions = {
-    method?: METHOD | METHOD[]
-    body?: ZodSchema
-    query?: ZodSchema
-    params?: ZodSchema
-    requireHeaders?: boolean
-    requireRequest?: boolean
-    use?: Endpoint[]
-}
-```
-
-- **method**: the endpoint options accept method which can be a method or an array of methods. If you pass an array of methods, the endpoint will match if the request method is one of the methods in the array. And method will be required when calling the endpoint even as a function.
-
-- **body**: the body option accepts a zod schema and will validate the request body. If the request body doesn't match the schema, the endpoint will throw an error. If it's mounted to a router, it'll return a 400 error.
-
-- **query**: the query option accepts a zod schema and will validate the request query. If the request query doesn't match the schema, the endpoint will throw an error. If it's mounted to a router, it'll return a 400 error.
-
-- **params**: the params option accepts a zod schema and will validate the request params. The params are defined in the path and will be extracted from the request.
-
-- **requireHeaders**: if true, the endpoint will throw an error if the request doesn't have headers. And even when you call the endpoint as a function, it will require headers to be passed in the context.
-
-- **requireRequest**: if true, the endpoint will throw an error if the request doesn't have a request object. And even when you call the endpoint as a function, it will require a request to be passed in the context.
-
-- **use**: the use option accepts an array of endpoints and will be called before the endpoint is called.
-
-### `EndpointFunction`
-
-this is the function that will be invoked when the endpoint is called. It accepts a context object that contains the request, headers, body, query, params and other information. 
-
-It can return a response object, a string, a boolean, a number, an object with a status, body, headers and other properties or undefined.
-
-If you return a response object, it will be returned as is even when it's mounted to a router.
-
-
-- **Context**: the context object contains the request, headers, body, query, params and a helper function to set headers, cookies and get cookies. If there is a middleware, the context will be extended with the middleware context.
-
-
-
+> other than normal cookies the ctx object also exposes signed cookies.
 
 ## License
 MIT

package/dist/client.cjs

@@ -0,0 +1,2 @@
+"use strict";var o=Object.defineProperty;var d=Object.getOwnPropertyDescriptor;var p=Object.getOwnPropertyNames;var y=Object.prototype.hasOwnProperty;var a=(t,e)=>{for(var n in e)o(t,n,{get:e[n],enumerable:!0})},u=(t,e,n,s)=>{if(e&&typeof e=="object"||typeof e=="function")for(let r of p(e))!y.call(t,r)&&r!==n&&o(t,r,{get:()=>e[r],enumerable:!(s=d(e,r))||s.enumerable});return t};var x=t=>u(o({},"__esModule",{value:!0}),t);var R={};a(R,{createClient:()=>T});module.exports=x(R);var i=require("@better-fetch/fetch"),T=t=>{let e=(0,i.createFetch)(t);return async(n,...s)=>await e(n,{...s[0]})};0&&(module.exports={createClient});
+//# sourceMappingURL=client.cjs.map

package/dist/client.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts"],"sourcesContent":["import type { Endpoint, Prettify } from \"./types\";\n\nimport { type BetterFetchOption, type BetterFetchResponse, createFetch } from \"@better-fetch/fetch\";\nimport type { Router } from \"./router\";\nimport type { HasRequiredKeys, UnionToIntersection } from \"./helper\";\n\ntype HasRequired<\n\tT extends {\n\t\tbody?: any;\n\t\tquery?: any;\n\t\tparams?: any;\n\t},\n> = HasRequiredKeys<T> extends true\n\t? HasRequiredKeys<T[\"body\"]> extends false\n\t\t? HasRequiredKeys<T[\"query\"]> extends false\n\t\t\t? HasRequiredKeys<T[\"params\"]> extends false\n\t\t\t\t? false\n\t\t\t\t: true\n\t\t\t: true\n\t\t: true\n\t: true;\n\ntype InferContext<T> = T extends (ctx: infer Ctx) => any\n\t? Ctx extends object\n\t\t? Ctx\n\t\t: never\n\t: never;\n\nexport interface ClientOptions extends BetterFetchOption {\n\tbaseURL: string;\n}\n\ntype WithRequired<T, K> = T & {\n\t[P in K extends string ? K : never]-?: T[P extends keyof T ? P : never];\n};\n\nexport type RequiredOptionKeys<\n\tC extends {\n\t\tbody?: any;\n\t\tquery?: any;\n\t\tparams?: any;\n\t},\n> = (undefined extends C[\"body\"]\n\t? {}\n\t: {\n\t\t\tbody: true;\n\t\t}) &\n\t(undefined extends C[\"query\"]\n\t\t? {}\n\t\t: {\n\t\t\t\tquery: true;\n\t\t\t}) &\n\t(undefined extends C[\"params\"]\n\t\t? {}\n\t\t: {\n\t\t\t\tparams: true;\n\t\t\t});\n\nexport const createClient = <R extends Router | Router[\"endpoints\"]>(options: ClientOptions) => {\n\tconst fetch = createFetch(options);\n\ttype API = R extends Router ? R[\"endpoints\"] : R;\n\ttype Options = API extends {\n\t\t[key: string]: infer T;\n\t}\n\t\t? T extends Endpoint\n\t\t\t? {\n\t\t\t\t\t[key in T[\"options\"][\"method\"] extends \"GET\"\n\t\t\t\t\t\t? T[\"path\"]\n\t\t\t\t\t\t: `@${T[\"options\"][\"method\"] extends string ? Lowercase<T[\"options\"][\"method\"]> : never}${T[\"path\"]}`]: T;\n\t\t\t\t}\n\t\t\t: {}\n\t\t: {};\n\n\ttype O = Prettify<UnionToIntersection<Options>>;\n\treturn async <OPT extends O, K extends keyof OPT, C extends InferContext<OPT[K]>>(\n\t\tpath: K,\n\t\t...options: HasRequired<C> extends true\n\t\t\t? [\n\t\t\t\t\tWithRequired<\n\t\t\t\t\t\tBetterFetchOption<C[\"body\"], C[\"query\"], C[\"params\"]>,\n\t\t\t\t\t\tkeyof RequiredOptionKeys<C>\n\t\t\t\t\t>,\n\t\t\t\t]\n\t\t\t: [BetterFetchOption<C[\"body\"], C[\"query\"], C[\"params\"]>?]\n\t): Promise<\n\t\tBetterFetchResponse<Awaited<ReturnType<OPT[K] extends Endpoint ? OPT[K] : never>>>\n\t> => {\n\t\treturn (await fetch(path as string, {\n\t\t\t...options[0],\n\t\t})) as any;\n\t};\n};\n"],"mappings":"yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,kBAAAE,IAAA,eAAAC,EAAAH,GAEA,IAAAI,EAA8E,+BAwDjEF,EAAwDG,GAA2B,CAC/F,IAAMC,KAAQ,eAAYD,CAAO,EAejC,MAAO,OACNE,KACGF,IAWK,MAAMC,EAAMC,EAAgB,CACnC,GAAGF,EAAQ,CAAC,CACb,CAAC,CAEH","names":["client_exports","__export","createClient","__toCommonJS","import_fetch","options","fetch","path"]}

package/dist/client.d.cts

@@ -0,0 +1,40 @@
+import { R as Router, U as UnionToIntersection, f as Endpoint, b as HasRequiredKeys } from './router-fNn8BCPr.cjs';
+import { BetterFetchOption, BetterFetchResponse } from '@better-fetch/fetch';
+import 'zod';
+
+type HasRequired<T extends {
+    body?: any;
+    query?: any;
+    params?: any;
+}> = HasRequiredKeys<T> extends true ? HasRequiredKeys<T["body"]> extends false ? HasRequiredKeys<T["query"]> extends false ? HasRequiredKeys<T["params"]> extends false ? false : true : true : true : true;
+type InferContext<T> = T extends (ctx: infer Ctx) => any ? Ctx extends object ? Ctx : never : never;
+interface ClientOptions extends BetterFetchOption {
+    baseURL: string;
+}
+type WithRequired<T, K> = T & {
+    [P in K extends string ? K : never]-?: T[P extends keyof T ? P : never];
+};
+type RequiredOptionKeys<C extends {
+    body?: any;
+    query?: any;
+    params?: any;
+}> = (undefined extends C["body"] ? {} : {
+    body: true;
+}) & (undefined extends C["query"] ? {} : {
+    query: true;
+}) & (undefined extends C["params"] ? {} : {
+    params: true;
+});
+declare const createClient: <R extends Router | Router["endpoints"]>(options: ClientOptions) => <OPT extends UnionToIntersection<(R extends {
+    handler: (request: Request) => Promise<Response>;
+    endpoints: Record<string, Endpoint>;
+} ? R["endpoints"] : R) extends {
+    [key: string]: infer T_1;
+} ? T_1 extends Endpoint ? { [key_1 in T_1["options"]["method"] extends "GET" ? T_1["path"] : `@${T_1["options"]["method"] extends string ? Lowercase<T_1["options"]["method"]> : never}${T_1["path"]}`]: T_1; } : {} : {}> extends infer T ? { [key in keyof T]: UnionToIntersection<(R extends {
+    handler: (request: Request) => Promise<Response>;
+    endpoints: Record<string, Endpoint>;
+} ? R["endpoints"] : R) extends {
+    [key: string]: infer T_1;
+} ? T_1 extends Endpoint ? { [key_1 in T_1["options"]["method"] extends "GET" ? T_1["path"] : `@${T_1["options"]["method"] extends string ? Lowercase<T_1["options"]["method"]> : never}${T_1["path"]}`]: T_1; } : {} : {}>[key]; } : never, K extends keyof OPT, C extends InferContext<OPT[K]>>(path: K, ...options: HasRequired<C> extends true ? [WithRequired<BetterFetchOption<C["body"], C["query"], C["params"]>, keyof RequiredOptionKeys<C>>] : [BetterFetchOption<C["body"], C["query"], C["params"]>?]) => Promise<BetterFetchResponse<Awaited<ReturnType<OPT[K] extends Endpoint ? OPT[K] : never>>>>;
+
+export { type ClientOptions, type RequiredOptionKeys, createClient };

package/dist/client.d.ts

@@ -0,0 +1,40 @@
+import { R as Router, U as UnionToIntersection, f as Endpoint, b as HasRequiredKeys } from './router-fNn8BCPr.js';
+import { BetterFetchOption, BetterFetchResponse } from '@better-fetch/fetch';
+import 'zod';
+
+type HasRequired<T extends {
+    body?: any;
+    query?: any;
+    params?: any;
+}> = HasRequiredKeys<T> extends true ? HasRequiredKeys<T["body"]> extends false ? HasRequiredKeys<T["query"]> extends false ? HasRequiredKeys<T["params"]> extends false ? false : true : true : true : true;
+type InferContext<T> = T extends (ctx: infer Ctx) => any ? Ctx extends object ? Ctx : never : never;
+interface ClientOptions extends BetterFetchOption {
+    baseURL: string;
+}
+type WithRequired<T, K> = T & {
+    [P in K extends string ? K : never]-?: T[P extends keyof T ? P : never];
+};
+type RequiredOptionKeys<C extends {
+    body?: any;
+    query?: any;
+    params?: any;
+}> = (undefined extends C["body"] ? {} : {
+    body: true;
+}) & (undefined extends C["query"] ? {} : {
+    query: true;
+}) & (undefined extends C["params"] ? {} : {
+    params: true;
+});
+declare const createClient: <R extends Router | Router["endpoints"]>(options: ClientOptions) => <OPT extends UnionToIntersection<(R extends {
+    handler: (request: Request) => Promise<Response>;
+    endpoints: Record<string, Endpoint>;
+} ? R["endpoints"] : R) extends {
+    [key: string]: infer T_1;
+} ? T_1 extends Endpoint ? { [key_1 in T_1["options"]["method"] extends "GET" ? T_1["path"] : `@${T_1["options"]["method"] extends string ? Lowercase<T_1["options"]["method"]> : never}${T_1["path"]}`]: T_1; } : {} : {}> extends infer T ? { [key in keyof T]: UnionToIntersection<(R extends {
+    handler: (request: Request) => Promise<Response>;
+    endpoints: Record<string, Endpoint>;
+} ? R["endpoints"] : R) extends {
+    [key: string]: infer T_1;
+} ? T_1 extends Endpoint ? { [key_1 in T_1["options"]["method"] extends "GET" ? T_1["path"] : `@${T_1["options"]["method"] extends string ? Lowercase<T_1["options"]["method"]> : never}${T_1["path"]}`]: T_1; } : {} : {}>[key]; } : never, K extends keyof OPT, C extends InferContext<OPT[K]>>(path: K, ...options: HasRequired<C> extends true ? [WithRequired<BetterFetchOption<C["body"], C["query"], C["params"]>, keyof RequiredOptionKeys<C>>] : [BetterFetchOption<C["body"], C["query"], C["params"]>?]) => Promise<BetterFetchResponse<Awaited<ReturnType<OPT[K] extends Endpoint ? OPT[K] : never>>>>;
+
+export { type ClientOptions, type RequiredOptionKeys, createClient };

package/dist/client.js

@@ -0,0 +1,2 @@
+import{createFetch as s}from"@better-fetch/fetch";var i=e=>{let t=s(e);return async(n,...r)=>await t(n,{...r[0]})};export{i as createClient};
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts"],"sourcesContent":["import type { Endpoint, Prettify } from \"./types\";\n\nimport { type BetterFetchOption, type BetterFetchResponse, createFetch } from \"@better-fetch/fetch\";\nimport type { Router } from \"./router\";\nimport type { HasRequiredKeys, UnionToIntersection } from \"./helper\";\n\ntype HasRequired<\n\tT extends {\n\t\tbody?: any;\n\t\tquery?: any;\n\t\tparams?: any;\n\t},\n> = HasRequiredKeys<T> extends true\n\t? HasRequiredKeys<T[\"body\"]> extends false\n\t\t? HasRequiredKeys<T[\"query\"]> extends false\n\t\t\t? HasRequiredKeys<T[\"params\"]> extends false\n\t\t\t\t? false\n\t\t\t\t: true\n\t\t\t: true\n\t\t: true\n\t: true;\n\ntype InferContext<T> = T extends (ctx: infer Ctx) => any\n\t? Ctx extends object\n\t\t? Ctx\n\t\t: never\n\t: never;\n\nexport interface ClientOptions extends BetterFetchOption {\n\tbaseURL: string;\n}\n\ntype WithRequired<T, K> = T & {\n\t[P in K extends string ? K : never]-?: T[P extends keyof T ? P : never];\n};\n\nexport type RequiredOptionKeys<\n\tC extends {\n\t\tbody?: any;\n\t\tquery?: any;\n\t\tparams?: any;\n\t},\n> = (undefined extends C[\"body\"]\n\t? {}\n\t: {\n\t\t\tbody: true;\n\t\t}) &\n\t(undefined extends C[\"query\"]\n\t\t? {}\n\t\t: {\n\t\t\t\tquery: true;\n\t\t\t}) &\n\t(undefined extends C[\"params\"]\n\t\t? {}\n\t\t: {\n\t\t\t\tparams: true;\n\t\t\t});\n\nexport const createClient = <R extends Router | Router[\"endpoints\"]>(options: ClientOptions) => {\n\tconst fetch = createFetch(options);\n\ttype API = R extends Router ? R[\"endpoints\"] : R;\n\ttype Options = API extends {\n\t\t[key: string]: infer T;\n\t}\n\t\t? T extends Endpoint\n\t\t\t? {\n\t\t\t\t\t[key in T[\"options\"][\"method\"] extends \"GET\"\n\t\t\t\t\t\t? T[\"path\"]\n\t\t\t\t\t\t: `@${T[\"options\"][\"method\"] extends string ? Lowercase<T[\"options\"][\"method\"]> : never}${T[\"path\"]}`]: T;\n\t\t\t\t}\n\t\t\t: {}\n\t\t: {};\n\n\ttype O = Prettify<UnionToIntersection<Options>>;\n\treturn async <OPT extends O, K extends keyof OPT, C extends InferContext<OPT[K]>>(\n\t\tpath: K,\n\t\t...options: HasRequired<C> extends true\n\t\t\t? [\n\t\t\t\t\tWithRequired<\n\t\t\t\t\t\tBetterFetchOption<C[\"body\"], C[\"query\"], C[\"params\"]>,\n\t\t\t\t\t\tkeyof RequiredOptionKeys<C>\n\t\t\t\t\t>,\n\t\t\t\t]\n\t\t\t: [BetterFetchOption<C[\"body\"], C[\"query\"], C[\"params\"]>?]\n\t): Promise<\n\t\tBetterFetchResponse<Awaited<ReturnType<OPT[K] extends Endpoint ? OPT[K] : never>>>\n\t> => {\n\t\treturn (await fetch(path as string, {\n\t\t\t...options[0],\n\t\t})) as any;\n\t};\n};\n"],"mappings":"AAEA,OAA2D,eAAAA,MAAmB,sBAwDvE,IAAMC,EAAwDC,GAA2B,CAC/F,IAAMC,EAAQH,EAAYE,CAAO,EAejC,MAAO,OACNE,KACGF,IAWK,MAAMC,EAAMC,EAAgB,CACnC,GAAGF,EAAQ,CAAC,CACb,CAAC,CAEH","names":["createFetch","createClient","options","fetch","path"]}

package/dist/index.cjs

@@ -1,2 +1,2 @@
-"use strict";var m=Object.defineProperty;var A=Object.getOwnPropertyDescriptor;var b=Object.getOwnPropertyNames;var S=Object.prototype.hasOwnProperty;var N=(t,e,n)=>e in t?m(t,e,{enumerable:!0,configurable:!0,writable:!0,value:n}):t[e]=n;var D=(t,e)=>{for(var n in e)m(t,n,{get:e[n],enumerable:!0})},H=(t,e,n,s)=>{if(e&&typeof e=="object"||typeof e=="function")for(let d of b(e))!S.call(t,d)&&d!==n&&m(t,d,{get:()=>e[d],enumerable:!(s=A(e,d))||s.enumerable});return t};var U=t=>H(m({},"__esModule",{value:!0}),t);var x=(t,e,n)=>N(t,typeof e!="symbol"?e+"":e,n);var Q={};D(Q,{APIError:()=>f,createEndpoint:()=>O,createEndpointCreator:()=>L,createMiddleware:()=>M,createMiddlewareCreator:()=>q,createRouter:()=>B,getBody:()=>h,shouldSerialize:()=>c,statusCode:()=>l});module.exports=U(Q);var w=require("zod");var k=require("zod");function M(t,e){if(typeof t=="function")return O("*",{method:"*"},t);if(!e)throw new Error("Middleware handler is required");return O("*",{...t,method:"*"},e)}var q=()=>{function t(e,n){if(typeof e=="function")return O("*",{method:"*"},e);if(!n)throw new Error("Middleware handler is required");return O("*",{...e,method:"*"},n)}return t};var f=class extends Error{constructor(n,s){super(`API Error: ${n} ${s?.message??""}`,{cause:s});x(this,"status");x(this,"body");this.status=n,this.body=s??{},this.stack="",this.name="BetterCallAPIError"}};function L(){return(t,e,n)=>O(t,e,n)}function O(t,e,n){let s=new Headers,d=async(...o)=>{let r={setHeader(a,i){s.set(a,i)},setCookie(a,i){s.append("Set-Cookie",`${a}=${i}`)},getCookie(a){return o[0]?.headers?.get("cookie")?.split(";").find(u=>u.startsWith(`${a}=`))?.split("=")[1]},...o[0]||{},context:{}};if(e.use?.length)for(let a of e.use){let i=await a(r),u=i.options?.body?i.options.body.parse(r.body):void 0;i&&(r={...r,body:u?{...u,...r.body}:r.body,context:{...r.context||{},...i}})}try{let a=e.body?e.body.parse(r.body):r.body;r={...r,body:a?{...a,...r.body}:r.body},r.query=e.query?e.query.parse(r.query):r.query,r.params=e.params?e.params.parse(r.params):r.params}catch(a){throw a instanceof w.ZodError?new f("BAD_REQUEST",{message:a.message,details:a.errors}):a}if(e.requireHeaders&&!r.headers)throw new f("BAD_REQUEST",{message:"Headers are required"});if(e.requireRequest&&!r.request)throw new f("BAD_REQUEST",{message:"Request is required"});return await n(r)};return d.path=t,d.options=e,d.method=e.method,d.headers=s,d}var E=require("rou3");async function h(t){let e=t.headers.get("content-type")||"";if(t.body){if(e.includes("application/json"))return await t.json();if(e.includes("application/x-www-form-urlencoded")){let n=await t.formData(),s={};return n.forEach((d,o)=>{s[o]=d.toString()}),s}if(e.includes("multipart/form-data")){let n=await t.formData(),s={};return n.forEach((d,o)=>{s[o]=d}),s}return e.includes("text/plain")?await t.text():e.includes("application/octet-stream")?await t.arrayBuffer():e.includes("application/pdf")||e.includes("image/")||e.includes("video/")?await t.blob():e.includes("application/stream")||t.body instanceof ReadableStream?t.body:await t.text()}}function c(t){return typeof t=="object"&&t!==null&&!(t instanceof Blob)&&!(t instanceof FormData)}var l={OK:200,CREATED:201,ACCEPTED:202,NO_CONTENT:204,MULTIPLE_CHOICES:300,MOVED_PERMANENTLY:301,FOUND:302,SEE_OTHER:303,NOT_MODIFIED:304,TEMPORARY_REDIRECT:307,BAD_REQUEST:400,UNAUTHORIZED:401,PAYMENT_REQUIRED:402,FORBIDDEN:403,NOT_FOUND:404,METHOD_NOT_ALLOWED:405,NOT_ACCEPTABLE:406,PROXY_AUTHENTICATION_REQUIRED:407,REQUEST_TIMEOUT:408,CONFLICT:409,GONE:410,LENGTH_REQUIRED:411,PRECONDITION_FAILED:412,PAYLOAD_TOO_LARGE:413,URI_TOO_LONG:414,UNSUPPORTED_MEDIA_TYPE:415,RANGE_NOT_SATISFIABLE:416,EXPECTATION_FAILED:417,"I'M_A_TEAPOT":418,MISDIRECTED_REQUEST:421,UNPROCESSABLE_ENTITY:422,LOCKED:423,FAILED_DEPENDENCY:424,TOO_EARLY:425,UPGRADE_REQUIRED:426,PRECONDITION_REQUIRED:428,TOO_MANY_REQUESTS:429,REQUEST_HEADER_FIELDS_TOO_LARGE:431,UNAVAILABLE_FOR_LEGAL_REASONS:451,INTERNAL_SERVER_ERROR:500,NOT_IMPLEMENTED:501,BAD_GATEWAY:502,SERVICE_UNAVAILABLE:503,GATEWAY_TIMEOUT:504,HTTP_VERSION_NOT_SUPPORTED:505,VARIANT_ALSO_NEGOTIATES:506,INSUFFICIENT_STORAGE:507,LOOP_DETECTED:508,NOT_EXTENDED:510,NETWORK_AUTHENTICATION_REQUIRED:511};var B=(t,e)=>{let n=(0,E.createRouter)();for(let o of t)if(Array.isArray(o.options?.method))for(let r of o.options.method)(0,E.addRoute)(n,r,o.path,o);else(0,E.addRoute)(n,o.options.method,o.path,o);let s=(0,E.createRouter)();for(let o of e?.routerMiddleware||[])(0,E.addRoute)(s,"*",o.path,o.middleware);return{handler:async o=>{let r=new URL(o.url),R=r.pathname;e?.basePath&&(R=R.split(e.basePath)[1]);let a=o.method,i=(0,E.findRoute)(n,a,R),u=i?.data,P=await h(o),T=o.headers,I=Object.fromEntries(r.searchParams),_=(0,E.findRoute)(s,"*",R)?.data;if(!u)return new Response(null,{status:404,statusText:"Not Found"});try{let p={};if(_){let C=await _({path:R,method:a,headers:T,params:i?.params,request:o,body:P,query:I});C&&(p={...C,...p})}let y=await u({path:R,method:a,headers:T,params:i?.params,request:o,body:P,query:I,...p});if(y instanceof Response)return y;let g=c(y)?JSON.stringify(y):y;return new Response(g,{headers:u.headers})}catch(p){if(e?.onError){let y=await e.onError(p);if(y instanceof Response)return y}if(p instanceof f)return new Response(p.body?JSON.stringify(p.body):null,{status:l[p.status],statusText:p.status,headers:{"Content-Type":"application/json"}});if(e?.throwError)throw p;return new Response(null,{status:500,statusText:"Internal Server Error"})}}}};var ne=require("zod");0&&(module.exports={APIError,createEndpoint,createEndpointCreator,createMiddleware,createMiddlewareCreator,createRouter,getBody,shouldSerialize,statusCode});
+"use strict";var h=Object.defineProperty;var $=Object.getOwnPropertyDescriptor;var Q=Object.getOwnPropertyNames;var W=Object.prototype.hasOwnProperty;var v=(r,e,t)=>e in r?h(r,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):r[e]=t;var K=(r,e)=>{for(var t in e)h(r,t,{get:e[t],enumerable:!0})},F=(r,e,t,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let s of Q(e))!W.call(r,s)&&s!==t&&h(r,s,{get:()=>e[s],enumerable:!(n=$(e,s))||n.enumerable});return r};var G=r=>F(h({},"__esModule",{value:!0}),r);var R=(r,e,t)=>v(r,typeof e!="symbol"?e+"":e,t);var te={};K(te,{APIError:()=>y,createEndpoint:()=>m,createEndpointCreator:()=>J,createMiddleware:()=>z,createMiddlewareCreator:()=>Z,createRouter:()=>ee,getBody:()=>T,shouldSerialize:()=>S,statusCode:()=>_});module.exports=G(te);var B=require("zod");var ne=require("zod");function z(r,e){if(typeof r=="function")return m("*",{method:"*"},r);if(!e)throw new Error("Middleware handler is required");return m("*",{...r,method:"*"},e)}var Z=()=>{function r(e,t){if(typeof e=="function")return m("*",{method:"*"},e);if(!t)throw new Error("Middleware handler is required");return m("*",{...e,method:"*"},t)}return r};var y=class extends Error{constructor(t,n){super(`API Error: ${t} ${n?.message??""}`,{cause:n});R(this,"status");R(this,"body");this.status=t,this.body=n??{},this.stack="",this.name="BetterCallAPIError"}};var C={name:"HMAC",hash:"SHA-256"},A=async r=>{let e=typeof r=="string"?new TextEncoder().encode(r):r;return await crypto.subtle.importKey("raw",e,C,!1,["sign","verify"])},Y=async(r,e)=>{let t=await A(e),n=await crypto.subtle.sign(C.name,t,new TextEncoder().encode(r));return btoa(String.fromCharCode(...new Uint8Array(n)))},V=async(r,e,t)=>{try{let n=atob(r),s=new Uint8Array(n.length);for(let i=0,o=n.length;i<o;i++)s[i]=n.charCodeAt(i);return await crypto.subtle.verify(C,t,s,new TextEncoder().encode(e))}catch{return!1}},j=/^[\w!#$%&'*.^`|~+-]+$/,X=/^[ !#-:<-[\]-~]*$/,P=(r,e)=>r.trim().split(";").reduce((n,s)=>{s=s.trim();let i=s.indexOf("=");if(i===-1)return n;let o=s.substring(0,i).trim();if(e&&e!==o||!j.test(o))return n;let p=s.substring(i+1).trim();return p.startsWith('"')&&p.endsWith('"')&&(p=p.slice(1,-1)),X.test(p)&&(n[o]=decodeURIComponent(p)),n},{}),H=async(r,e,t)=>{let n={},s=await A(e);for(let[i,o]of Object.entries(P(r,t))){let p=o.lastIndexOf(".");if(p<1)continue;let a=o.substring(0,p),d=o.substring(p+1);if(d.length!==44||!d.endsWith("="))continue;let u=await V(d,a,s);n[i]=u?a:!1}return n},N=(r,e,t={})=>{let n=`${r}=${e}`;if(r.startsWith("__Secure-")&&!t.secure)throw new Error("__Secure- Cookie must have Secure attributes");if(r.startsWith("__Host-")){if(!t.secure)throw new Error("__Host- Cookie must have Secure attributes");if(t.path!=="/")throw new Error('__Host- Cookie must have Path attributes with "/"');if(t.domain)throw new Error("__Host- Cookie must not have Domain attributes")}if(t&&typeof t.maxAge=="number"&&t.maxAge>=0){if(t.maxAge>3456e4)throw new Error("Cookies Max-Age SHOULD NOT be greater than 400 days (34560000 seconds) in duration.");n+=`; Max-Age=${Math.floor(t.maxAge)}`}if(t.domain&&t.prefix!=="host"&&(n+=`; Domain=${t.domain}`),t.path&&(n+=`; Path=${t.path}`),t.expires){if(t.expires.getTime()-Date.now()>3456e7)throw new Error("Cookies Expires SHOULD NOT be greater than 400 days (34560000 seconds) in the future.");n+=`; Expires=${t.expires.toUTCString()}`}if(t.httpOnly&&(n+="; HttpOnly"),t.secure&&(n+="; Secure"),t.sameSite&&(n+=`; SameSite=${t.sameSite.charAt(0).toUpperCase()+t.sameSite.slice(1)}`),t.partitioned){if(!t.secure)throw new Error("Partitioned Cookie must have Secure attributes");n+="; Partitioned"}return n},O=(r,e,t)=>(e=encodeURIComponent(e),N(r,e,t)),l=async(r,e,t,n={})=>{let s=await Y(e,t);return e=`${e}.${s}`,e=encodeURIComponent(e),N(r,e,n)};var D=(r,e,t)=>{if(!r)return;let n=e;if(t==="secure")n="__Secure-"+e;else if(t==="host")n="__Host-"+e;else return;return P(r,n)[n]},U=(r,e,t,n)=>{let s;n?.prefix==="secure"?s=O("__Secure-"+e,t,{path:"/",...n,secure:!0}):n?.prefix==="host"?s=O("__Host-"+e,t,{...n,path:"/",secure:!0,domain:void 0}):s=O(e,t,{path:"/",...n}),r.append("Set-Cookie",s)},M=async(r,e,t,n,s)=>{let i;s?.prefix==="secure"?i=await l("__Secure-"+e,t,n,{path:"/",...s,secure:!0}):s?.prefix==="host"?i=await l("__Host-"+e,t,n,{...s,path:"/",secure:!0,domain:void 0}):i=await l(e,t,n,{path:"/",...s}),r.append("Set-Cookie",i)},q=async(r,e,t,n)=>{let s=r.get("Cookie");if(!s)return;let i=t;return n==="secure"?i="__Secure-"+t:n==="host"&&(i="__Host-"+t),(await H(s,e,i))[i]};function J(){return(r,e,t)=>m(r,e,t)}function m(r,e,t){let n=new Headers,s=async(...i)=>{let o={setHeader(a,d){n.set(a,d)},setCookie(a,d,u){U(n,a,d,u)},getCookie(a,d){let u=i[0]?.headers;return D(u?.get("Cookie")||"",a,d)},getSignedCookie(a,d,u){let c=i[0]?.headers;if(!c)throw new TypeError("Headers are required");return q(c,d,a,u)},async setSignedCookie(a,d,u,c){await M(n,a,d,u,c)},...i[0]||{},context:{}};if(e.use?.length)for(let a of e.use){let d=await a(o),u=d.options?.body?d.options.body.parse(o.body):void 0;d&&(o={...o,body:u?{...u,...o.body}:o.body,context:{...o.context||{},...d}})}try{let a=e.body?e.body.parse(o.body):o.body;o={...o,body:a?{...a,...o.body}:o.body},o.query=e.query?e.query.parse(o.query):o.query}catch(a){throw a instanceof B.ZodError?new y("BAD_REQUEST",{message:a.message,details:a.errors}):a}if(e.requireHeaders&&!o.headers)throw new y("BAD_REQUEST",{message:"Headers are required"});if(e.requireRequest&&!o.request)throw new y("BAD_REQUEST",{message:"Request is required"});return await t(o)};return s.path=r,s.options=e,s.method=e.method,s.headers=n,s}var E=require("rou3");async function T(r){let e=r.headers.get("content-type")||"";if(r.body){if(e.includes("application/json"))return await r.json();if(e.includes("application/x-www-form-urlencoded")){let t=await r.formData(),n={};return t.forEach((s,i)=>{n[i]=s.toString()}),n}if(e.includes("multipart/form-data")){let t=await r.formData(),n={};return t.forEach((s,i)=>{n[i]=s}),n}return e.includes("text/plain")?await r.text():e.includes("application/octet-stream")?await r.arrayBuffer():e.includes("application/pdf")||e.includes("image/")||e.includes("video/")?await r.blob():e.includes("application/stream")||r.body instanceof ReadableStream?r.body:await r.text()}}function S(r){return typeof r=="object"&&r!==null&&!(r instanceof Blob)&&!(r instanceof FormData)}var _={OK:200,CREATED:201,ACCEPTED:202,NO_CONTENT:204,MULTIPLE_CHOICES:300,MOVED_PERMANENTLY:301,FOUND:302,SEE_OTHER:303,NOT_MODIFIED:304,TEMPORARY_REDIRECT:307,BAD_REQUEST:400,UNAUTHORIZED:401,PAYMENT_REQUIRED:402,FORBIDDEN:403,NOT_FOUND:404,METHOD_NOT_ALLOWED:405,NOT_ACCEPTABLE:406,PROXY_AUTHENTICATION_REQUIRED:407,REQUEST_TIMEOUT:408,CONFLICT:409,GONE:410,LENGTH_REQUIRED:411,PRECONDITION_FAILED:412,PAYLOAD_TOO_LARGE:413,URI_TOO_LONG:414,UNSUPPORTED_MEDIA_TYPE:415,RANGE_NOT_SATISFIABLE:416,EXPECTATION_FAILED:417,"I'M_A_TEAPOT":418,MISDIRECTED_REQUEST:421,UNPROCESSABLE_ENTITY:422,LOCKED:423,FAILED_DEPENDENCY:424,TOO_EARLY:425,UPGRADE_REQUIRED:426,PRECONDITION_REQUIRED:428,TOO_MANY_REQUESTS:429,REQUEST_HEADER_FIELDS_TOO_LARGE:431,UNAVAILABLE_FOR_LEGAL_REASONS:451,INTERNAL_SERVER_ERROR:500,NOT_IMPLEMENTED:501,BAD_GATEWAY:502,SERVICE_UNAVAILABLE:503,GATEWAY_TIMEOUT:504,HTTP_VERSION_NOT_SUPPORTED:505,VARIANT_ALSO_NEGOTIATES:506,INSUFFICIENT_STORAGE:507,LOOP_DETECTED:508,NOT_EXTENDED:510,NETWORK_AUTHENTICATION_REQUIRED:511};var ee=(r,e)=>{let t=Object.values(r),n=(0,E.createRouter)();for(let o of t)if(Array.isArray(o.options?.method))for(let p of o.options.method)(0,E.addRoute)(n,p,o.path,o);else(0,E.addRoute)(n,o.options.method,o.path,o);let s=(0,E.createRouter)();for(let o of e?.routerMiddleware||[])(0,E.addRoute)(s,"*",o.path,o.middleware);return{handler:async o=>{let p=new URL(o.url),a=p.pathname;e?.basePath&&(a=a.split(e.basePath)[1]);let d=o.method,u=(0,E.findRoute)(n,d,a),c=u?.data,g=await T(o),w=o.headers,I=Object.fromEntries(p.searchParams),k=(0,E.findRoute)(s,"*",a)?.data;if(!c)return new Response(null,{status:404,statusText:"Not Found"});try{let f={};if(k){let b=await k({path:a,method:d,headers:w,params:u?.params,request:o,body:g,query:I,...e?.extraContext});b&&(f={...b,...f})}let x=await c({path:a,method:d,headers:w,params:u?.params,request:o,body:g,query:I,...f,...e?.extraContext});if(x instanceof Response)return x;let L=S(x)?JSON.stringify(x):x;return new Response(L,{headers:c.headers})}catch(f){if(e?.onError){let x=await e.onError(f);if(x instanceof Response)return x}if(f instanceof y)return new Response(f.body?JSON.stringify(f.body):null,{status:_[f.status],statusText:f.status,headers:c.headers});if(e?.throwError)throw f;return new Response(null,{status:500,statusText:"Internal Server Error"})}},endpoints:r}};var Ce=require("zod");0&&(module.exports={APIError,createEndpoint,createEndpointCreator,createMiddleware,createMiddlewareCreator,createRouter,getBody,shouldSerialize,statusCode});
 //# sourceMappingURL=index.cjs.map