@aura-stack/router 0.5.0 → 0.6.0-rc.1

package/dist/assert.cjs

@@ -65,6 +65,24 @@ var statusText = Object.keys(statusCode).reduce(
   {}
 );
 var AuraStackRouterError = class extends Error {
+  /**
+   * The HTTP status code associated with the error.
+   * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status
+   * @example
+   * NOT_FOUND: 404
+   * METHOD_NOT_ALLOWED: 405
+   * INTERNAL_SERVER_ERROR: 500
+   */
+  status;
+  /**
+   * The HTTP status text associated with the status code of the error.
+   * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status
+   * @example
+   * NOT_FOUND: NOT_FOUND
+   * METHOD_NOT_ALLOWED: METHOD_NOT_ALLOWED
+   * INTERNAL_SERVER_ERROR: INTERNAL_SERVER_ERROR
+   */
+  statusText;
   constructor(type, message, name) {
     super(message);
     this.name = name ?? "RouterError";
@@ -79,6 +97,9 @@ var RouterError = class extends AuraStackRouterError {
   }
 };
 var InvalidZodSchemaError = class {
+  status;
+  statusText;
+  errors;
   constructor(type, errors) {
     this.status = statusCode[type];
     this.statusText = statusText[type];

package/dist/assert.d.ts

@@ -3,6 +3,7 @@ import { HTTPMethod, RoutePattern, RouteHandler } from './types.js';
 import 'zod';
 import './headers.js';
 import 'cookie';
+import 'http';
 
 declare const supportedProtocols: Set<string>;
 /**

package/dist/assert.js

@@ -7,8 +7,8 @@ import {
   isValidHandler,
   isValidRoute,
   supportedProtocols
-} from "./chunk-FU35BPU7.js";
-import "./chunk-B6PMGVSL.js";
+} from "./chunk-3X2BFSRT.js";
+import "./chunk-FJYSN2I6.js";
 export {
   isInvalidZodSchemaError,
   isObject,

package/dist/{chunk-FU35BPU7.js → chunk-3X2BFSRT.js}

@@ -1,7 +1,7 @@
 import {
   InvalidZodSchemaError,
   RouterError
-} from "./chunk-B6PMGVSL.js";
+} from "./chunk-FJYSN2I6.js";
 
 // src/assert.ts
 var supportedMethods = /* @__PURE__ */ new Set(["GET", "POST", "DELETE", "PUT", "PATCH", "OPTIONS", "HEAD", "TRACE", "CONNECT"]);

package/dist/{chunk-4UYDR5IO.js → chunk-5F6FUKTB.js}

@@ -2,10 +2,10 @@ import {
   isSupportedMethod,
   isValidHandler,
   isValidRoute
-} from "./chunk-FU35BPU7.js";
+} from "./chunk-3X2BFSRT.js";
 import {
   RouterError
-} from "./chunk-B6PMGVSL.js";
+} from "./chunk-FJYSN2I6.js";
 
 // src/endpoint.ts
 var createEndpoint = (method, route, handler, config = {}) => {

package/dist/{chunk-BWIKAYZV.js → chunk-6CIHAUKJ.js}

@@ -1,6 +1,6 @@
 import {
   RouterError
-} from "./chunk-B6PMGVSL.js";
+} from "./chunk-FJYSN2I6.js";
 
 // src/middlewares.ts
 var executeGlobalMiddlewares = async (context, middlewares) => {

package/dist/{chunk-Z6JJAIWN.js → chunk-6JNMFP4L.js}

@@ -1,6 +1,7 @@
 // src/headers.ts
 import { serialize, parse, parseSetCookie } from "cookie";
 var HeadersBuilder = class {
+  headers;
   constructor(initialHeaders) {
     this.headers = new Headers(initialHeaders);
   }

package/dist/{chunk-B6PMGVSL.js → chunk-FJYSN2I6.js}

@@ -32,6 +32,24 @@ var statusText = Object.keys(statusCode).reduce(
   {}
 );
 var AuraStackRouterError = class extends Error {
+  /**
+   * The HTTP status code associated with the error.
+   * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status
+   * @example
+   * NOT_FOUND: 404
+   * METHOD_NOT_ALLOWED: 405
+   * INTERNAL_SERVER_ERROR: 500
+   */
+  status;
+  /**
+   * The HTTP status text associated with the status code of the error.
+   * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status
+   * @example
+   * NOT_FOUND: NOT_FOUND
+   * METHOD_NOT_ALLOWED: METHOD_NOT_ALLOWED
+   * INTERNAL_SERVER_ERROR: INTERNAL_SERVER_ERROR
+   */
+  statusText;
   constructor(type, message, name) {
     super(message);
     this.name = name ?? "RouterError";
@@ -46,6 +64,9 @@ var RouterError = class extends AuraStackRouterError {
   }
 };
 var InvalidZodSchemaError = class {
+  status;
+  statusText;
+  errors;
   constructor(type, errors) {
     this.status = statusCode[type];
     this.statusText = statusText[type];

package/dist/chunk-MP4L2ICK.js

@@ -0,0 +1,38 @@
+// src/client.ts
+function createClient(options) {
+  const { baseURL, headers: defaultHeaders } = options;
+  return new Proxy(
+    {},
+    {
+      get(_, prop) {
+        const method = prop.toString().toUpperCase();
+        return async (path, ctx) => {
+          const searchParams = new URLSearchParams(ctx?.searchParams);
+          let interpolatedPath = path;
+          for (const [key, value] of Object.entries(ctx?.params ?? {})) {
+            interpolatedPath = interpolatedPath.replace(`:${key}`, String(value));
+          }
+          const url = new URL(interpolatedPath, baseURL);
+          if (searchParams.size > 0) {
+            url.search = searchParams.toString();
+          }
+          const { params: _p, searchParams: _s, ...requestInit } = ctx ?? {};
+          const response = await fetch(url.toString(), {
+            ...requestInit,
+            method,
+            headers: {
+              ...defaultHeaders,
+              ...ctx?.headers
+            },
+            body: ctx?.body ? ctx.body instanceof FormData ? ctx.body : JSON.stringify(ctx.body) : void 0
+          });
+          return response;
+        };
+      }
+    }
+  );
+}
+
+export {
+  createClient
+};

package/dist/{chunk-XB5P5CQZ.js → chunk-SY4MM2AG.js}

@@ -1,10 +1,10 @@
 import {
   isSupportedBodyMethod
-} from "./chunk-FU35BPU7.js";
+} from "./chunk-3X2BFSRT.js";
 import {
   InvalidZodSchemaError,
   RouterError
-} from "./chunk-B6PMGVSL.js";
+} from "./chunk-FJYSN2I6.js";
 
 // src/context.ts
 var formatZodError = (error) => {

package/dist/{chunk-TEDN6QMU.js → chunk-WJXMLTGP.js}

@@ -1,24 +1,24 @@
+import {
+  executeGlobalMiddlewares,
+  executeMiddlewares
+} from "./chunk-6CIHAUKJ.js";
 import {
   getBody,
   getRouteParams,
   getSearchParams
-} from "./chunk-XB5P5CQZ.js";
+} from "./chunk-SY4MM2AG.js";
 import {
   isInvalidZodSchemaError,
   isRouterError,
   isSupportedMethod
-} from "./chunk-FU35BPU7.js";
-import {
-  HeadersBuilder
-} from "./chunk-Z6JJAIWN.js";
-import {
-  executeGlobalMiddlewares,
-  executeMiddlewares
-} from "./chunk-BWIKAYZV.js";
+} from "./chunk-3X2BFSRT.js";
 import {
   RouterError,
   statusText
-} from "./chunk-B6PMGVSL.js";
+} from "./chunk-FJYSN2I6.js";
+import {
+  HeadersBuilder
+} from "./chunk-6JNMFP4L.js";
 
 // src/router.ts
 var createNode = () => ({

package/dist/client.cjs

@@ -0,0 +1,62 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/client.ts
+var client_exports = {};
+__export(client_exports, {
+  createClient: () => createClient
+});
+module.exports = __toCommonJS(client_exports);
+function createClient(options) {
+  const { baseURL, headers: defaultHeaders } = options;
+  return new Proxy(
+    {},
+    {
+      get(_, prop) {
+        const method = prop.toString().toUpperCase();
+        return async (path, ctx) => {
+          const searchParams = new URLSearchParams(ctx?.searchParams);
+          let interpolatedPath = path;
+          for (const [key, value] of Object.entries(ctx?.params ?? {})) {
+            interpolatedPath = interpolatedPath.replace(`:${key}`, String(value));
+          }
+          const url = new URL(interpolatedPath, baseURL);
+          if (searchParams.size > 0) {
+            url.search = searchParams.toString();
+          }
+          const { params: _p, searchParams: _s, ...requestInit } = ctx ?? {};
+          const response = await fetch(url.toString(), {
+            ...requestInit,
+            method,
+            headers: {
+              ...defaultHeaders,
+              ...ctx?.headers
+            },
+            body: ctx?.body ? ctx.body instanceof FormData ? ctx.body : JSON.stringify(ctx.body) : void 0
+          });
+          return response;
+        };
+      }
+    }
+  );
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createClient
+});

package/dist/client.d.ts

@@ -0,0 +1,26 @@
+import { Router, ClientOptions, Client, InferEndpoints } from './types.js';
+import 'zod';
+import './error.js';
+import './headers.js';
+import 'cookie';
+import 'http';
+
+/**
+ * Creates a client API for making requests to the specified router. It provides type-safe methods
+ * based on the router's endpoints.
+ *
+ * @param options - Configuration options for the client, including baseURL and default headers.
+ * @returns A client object with methods corresponding to HTTP methods (GET, POST, etc.).
+ * @example
+ * import { createClient } from "aura-stack/router/client";
+ * import { appRouter } from "./server";
+ *
+ * const client = createClient<typeof appRouter>({
+ *   baseURL: "http://localhost:3000/api",
+ * })
+ *
+ * client.get("/users")
+ */
+declare function createClient<InferRouter extends Router<any>>(options: ClientOptions): Client<InferEndpoints<InferRouter>>;
+
+export { createClient };

package/dist/client.js

@@ -0,0 +1,6 @@
+import {
+  createClient
+} from "./chunk-MP4L2ICK.js";
+export {
+  createClient
+};

package/dist/context.cjs

@@ -61,6 +61,24 @@ var statusText = Object.keys(statusCode).reduce(
   {}
 );
 var AuraStackRouterError = class extends Error {
+  /**
+   * The HTTP status code associated with the error.
+   * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status
+   * @example
+   * NOT_FOUND: 404
+   * METHOD_NOT_ALLOWED: 405
+   * INTERNAL_SERVER_ERROR: 500
+   */
+  status;
+  /**
+   * The HTTP status text associated with the status code of the error.
+   * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status
+   * @example
+   * NOT_FOUND: NOT_FOUND
+   * METHOD_NOT_ALLOWED: METHOD_NOT_ALLOWED
+   * INTERNAL_SERVER_ERROR: INTERNAL_SERVER_ERROR
+   */
+  statusText;
   constructor(type, message, name) {
     super(message);
     this.name = name ?? "RouterError";
@@ -75,6 +93,9 @@ var RouterError = class extends AuraStackRouterError {
   }
 };
 var InvalidZodSchemaError = class {
+  status;
+  statusText;
+  errors;
   constructor(type, errors) {
     this.status = statusCode[type];
     this.statusText = statusText[type];

package/dist/context.d.ts

@@ -3,6 +3,7 @@ import { EndpointConfig, ContextSearchParams } from './types.js';
 import './error.js';
 import './headers.js';
 import 'cookie';
+import 'http';
 
 /**
  * @experimental

package/dist/context.js

@@ -3,9 +3,9 @@ import {
   getBody,
   getRouteParams,
   getSearchParams
-} from "./chunk-XB5P5CQZ.js";
-import "./chunk-FU35BPU7.js";
-import "./chunk-B6PMGVSL.js";
+} from "./chunk-SY4MM2AG.js";
+import "./chunk-3X2BFSRT.js";
+import "./chunk-FJYSN2I6.js";
 export {
   formatZodError,
   getBody,

package/dist/endpoint.cjs

@@ -59,6 +59,24 @@ var statusText = Object.keys(statusCode).reduce(
   {}
 );
 var AuraStackRouterError = class extends Error {
+  /**
+   * The HTTP status code associated with the error.
+   * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status
+   * @example
+   * NOT_FOUND: 404
+   * METHOD_NOT_ALLOWED: 405
+   * INTERNAL_SERVER_ERROR: 500
+   */
+  status;
+  /**
+   * The HTTP status text associated with the status code of the error.
+   * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status
+   * @example
+   * NOT_FOUND: NOT_FOUND
+   * METHOD_NOT_ALLOWED: METHOD_NOT_ALLOWED
+   * INTERNAL_SERVER_ERROR: INTERNAL_SERVER_ERROR
+   */
+  statusText;
   constructor(type, message, name) {
     super(message);
     this.name = name ?? "RouterError";

package/dist/endpoint.d.ts

@@ -3,6 +3,7 @@ import 'zod';
 import './error.js';
 import './headers.js';
 import 'cookie';
+import 'http';
 
 /**
  * Defines an API endpoint for the router by specifying the HTTP method, route pattern,
@@ -22,7 +23,9 @@ import 'cookie';
  */
 declare const createEndpoint: <const Method extends Uppercase<HTTPMethod>, const Route extends RoutePattern, const Schemas extends EndpointSchemas>(method: Method, route: Route, handler: RouteHandler<Route, {
     schemas: Schemas;
-}>, config?: EndpointConfig<Route, Schemas>) => RouteEndpoint<Method, Route, {}>;
+}>, config?: EndpointConfig<Route, Schemas>) => RouteEndpoint<Method, Route, {
+    schemas?: Schemas;
+}>;
 /**
  * Create an endpoint configuration to be passed to the `createEndpoint` function.
  * This function is primarily for type inference and does not perform any runtime checks.

package/dist/endpoint.js

@@ -1,9 +1,9 @@
 import {
   createEndpoint,
   createEndpointConfig
-} from "./chunk-4UYDR5IO.js";
-import "./chunk-FU35BPU7.js";
-import "./chunk-B6PMGVSL.js";
+} from "./chunk-5F6FUKTB.js";
+import "./chunk-3X2BFSRT.js";
+import "./chunk-FJYSN2I6.js";
 export {
   createEndpoint,
   createEndpointConfig

package/dist/error.cjs

@@ -60,6 +60,24 @@ var statusText = Object.keys(statusCode).reduce(
   {}
 );
 var AuraStackRouterError = class extends Error {
+  /**
+   * The HTTP status code associated with the error.
+   * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status
+   * @example
+   * NOT_FOUND: 404
+   * METHOD_NOT_ALLOWED: 405
+   * INTERNAL_SERVER_ERROR: 500
+   */
+  status;
+  /**
+   * The HTTP status text associated with the status code of the error.
+   * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status
+   * @example
+   * NOT_FOUND: NOT_FOUND
+   * METHOD_NOT_ALLOWED: METHOD_NOT_ALLOWED
+   * INTERNAL_SERVER_ERROR: INTERNAL_SERVER_ERROR
+   */
+  statusText;
   constructor(type, message, name) {
     super(message);
     this.name = name ?? "RouterError";
@@ -74,6 +92,9 @@ var RouterError = class extends AuraStackRouterError {
   }
 };
 var InvalidZodSchemaError = class {
+  status;
+  statusText;
+  errors;
   constructor(type, errors) {
     this.status = statusCode[type];
     this.statusText = statusText[type];

package/dist/error.js

@@ -4,7 +4,7 @@ import {
   RouterError,
   statusCode,
   statusText
-} from "./chunk-B6PMGVSL.js";
+} from "./chunk-FJYSN2I6.js";
 export {
   AuraStackRouterError,
   InvalidZodSchemaError,

package/dist/headers.cjs

@@ -25,6 +25,7 @@ __export(headers_exports, {
 module.exports = __toCommonJS(headers_exports);
 var import_cookie = require("cookie");
 var HeadersBuilder = class {
+  headers;
   constructor(initialHeaders) {
     this.headers = new Headers(initialHeaders);
   }

package/dist/headers.js

@@ -1,6 +1,6 @@
 import {
   HeadersBuilder
-} from "./chunk-Z6JJAIWN.js";
+} from "./chunk-6JNMFP4L.js";
 export {
   HeadersBuilder
 };

package/dist/index.cjs

@@ -22,6 +22,7 @@ var index_exports = {};
 __export(index_exports, {
   HeadersBuilder: () => HeadersBuilder,
   RouterError: () => RouterError,
+  createClient: () => createClient,
   createEndpoint: () => createEndpoint,
   createEndpointConfig: () => createEndpointConfig,
   createRouter: () => createRouter,
@@ -66,6 +67,24 @@ var statusText = Object.keys(statusCode).reduce(
   {}
 );
 var AuraStackRouterError = class extends Error {
+  /**
+   * The HTTP status code associated with the error.
+   * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status
+   * @example
+   * NOT_FOUND: 404
+   * METHOD_NOT_ALLOWED: 405
+   * INTERNAL_SERVER_ERROR: 500
+   */
+  status;
+  /**
+   * The HTTP status text associated with the status code of the error.
+   * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status
+   * @example
+   * NOT_FOUND: NOT_FOUND
+   * METHOD_NOT_ALLOWED: METHOD_NOT_ALLOWED
+   * INTERNAL_SERVER_ERROR: INTERNAL_SERVER_ERROR
+   */
+  statusText;
   constructor(type, message, name) {
     super(message);
     this.name = name ?? "RouterError";
@@ -80,6 +99,9 @@ var RouterError = class extends AuraStackRouterError {
   }
 };
 var InvalidZodSchemaError = class {
+  status;
+  statusText;
+  errors;
   constructor(type, errors) {
     this.status = statusCode[type];
     this.statusText = statusText[type];
@@ -131,6 +153,7 @@ function createEndpointConfig(...args) {
 // src/headers.ts
 var import_cookie = require("cookie");
 var HeadersBuilder = class {
+  headers;
   constructor(initialHeaders) {
     this.headers = new Headers(initialHeaders);
   }
@@ -406,10 +429,46 @@ var createRouter = (endpoints, config = {}) => {
   }
   return server;
 };
+
+// src/client.ts
+function createClient(options) {
+  const { baseURL, headers: defaultHeaders } = options;
+  return new Proxy(
+    {},
+    {
+      get(_, prop) {
+        const method = prop.toString().toUpperCase();
+        return async (path, ctx) => {
+          const searchParams = new URLSearchParams(ctx?.searchParams);
+          let interpolatedPath = path;
+          for (const [key, value] of Object.entries(ctx?.params ?? {})) {
+            interpolatedPath = interpolatedPath.replace(`:${key}`, String(value));
+          }
+          const url = new URL(interpolatedPath, baseURL);
+          if (searchParams.size > 0) {
+            url.search = searchParams.toString();
+          }
+          const { params: _p, searchParams: _s, ...requestInit } = ctx ?? {};
+          const response = await fetch(url.toString(), {
+            ...requestInit,
+            method,
+            headers: {
+              ...defaultHeaders,
+              ...ctx?.headers
+            },
+            body: ctx?.body ? ctx.body instanceof FormData ? ctx.body : JSON.stringify(ctx.body) : void 0
+          });
+          return response;
+        };
+      }
+    }
+  );
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   HeadersBuilder,
   RouterError,
+  createClient,
   createEndpoint,
   createEndpointConfig,
   createRouter,

package/dist/index.d.ts

@@ -1,8 +1,10 @@
 export { createEndpoint, createEndpointConfig } from './endpoint.js';
 export { createRouter } from './router.js';
+export { createClient } from './client.js';
 export { isInvalidZodSchemaError, isRouterError } from './assert.js';
 export { RouterError, statusCode, statusText } from './error.js';
 export { HeadersBuilder } from './headers.js';
-export { ContentType, ContextBody, ContextParams, ContextSearchParams, EndpointConfig, EndpointSchemas, GetHttpHandlers, GetRouteParams, GlobalContext, GlobalCtx, GlobalMiddleware, GlobalMiddlewareContext, HTTPMethod, InferMethod, MiddlewareFunction, Prettify, RequestContext, RouteEndpoint, RouteHandler, RoutePattern, RouterConfig } from './types.js';
+export { Client, ClientOptions, ContentType, ContextBody, ContextParams, ContextSearchParams, EndpointConfig, EndpointSchemas, ExtractEndpoint, ExtractRoutesByMethod, Find, GetHttpHandlers, GetRouteParams, GlobalContext, GlobalCtx, GlobalMiddleware, GlobalMiddlewareContext, HTTPMethod, InferEndpoints, InferMethod, InferZod, MiddlewareFunction, Prettify, RemoveUndefined, RequestContext, RouteEndpoint, RouteHandler, RoutePattern, Router, RouterConfig, RoutesByMethod, ToInferZod } from './types.js';
 import 'cookie';
 import 'zod';
+import 'http';

package/dist/index.js

@@ -1,27 +1,31 @@
 import {
   createRouter
-} from "./chunk-TEDN6QMU.js";
-import "./chunk-XB5P5CQZ.js";
+} from "./chunk-WJXMLTGP.js";
+import "./chunk-6CIHAUKJ.js";
+import {
+  createClient
+} from "./chunk-MP4L2ICK.js";
+import "./chunk-SY4MM2AG.js";
 import {
   createEndpoint,
   createEndpointConfig
-} from "./chunk-4UYDR5IO.js";
+} from "./chunk-5F6FUKTB.js";
 import {
   isInvalidZodSchemaError,
   isRouterError
-} from "./chunk-FU35BPU7.js";
-import {
-  HeadersBuilder
-} from "./chunk-Z6JJAIWN.js";
-import "./chunk-BWIKAYZV.js";
+} from "./chunk-3X2BFSRT.js";
 import {
   RouterError,
   statusCode,
   statusText
-} from "./chunk-B6PMGVSL.js";
+} from "./chunk-FJYSN2I6.js";
+import {
+  HeadersBuilder
+} from "./chunk-6JNMFP4L.js";
 export {
   HeadersBuilder,
   RouterError,
+  createClient,
   createEndpoint,
   createEndpointConfig,
   createRouter,

package/dist/middlewares.cjs

@@ -59,6 +59,24 @@ var statusText = Object.keys(statusCode).reduce(
   {}
 );
 var AuraStackRouterError = class extends Error {
+  /**
+   * The HTTP status code associated with the error.
+   * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status
+   * @example
+   * NOT_FOUND: 404
+   * METHOD_NOT_ALLOWED: 405
+   * INTERNAL_SERVER_ERROR: 500
+   */
+  status;
+  /**
+   * The HTTP status text associated with the status code of the error.
+   * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status
+   * @example
+   * NOT_FOUND: NOT_FOUND
+   * METHOD_NOT_ALLOWED: METHOD_NOT_ALLOWED
+   * INTERNAL_SERVER_ERROR: INTERNAL_SERVER_ERROR
+   */
+  statusText;
   constructor(type, message, name) {
     super(message);
     this.name = name ?? "RouterError";

package/dist/middlewares.d.ts

@@ -3,6 +3,7 @@ import 'zod';
 import './error.js';
 import './headers.js';
 import 'cookie';
+import 'http';
 
 /**
  * Executes the middlewares in sequence, passing the request to each middleware.

package/dist/middlewares.js

@@ -1,8 +1,8 @@
 import {
   executeGlobalMiddlewares,
   executeMiddlewares
-} from "./chunk-BWIKAYZV.js";
-import "./chunk-B6PMGVSL.js";
+} from "./chunk-6CIHAUKJ.js";
+import "./chunk-FJYSN2I6.js";
 export {
   executeGlobalMiddlewares,
   executeMiddlewares

package/dist/router.cjs

@@ -61,6 +61,24 @@ var statusText = Object.keys(statusCode).reduce(
   {}
 );
 var AuraStackRouterError = class extends Error {
+  /**
+   * The HTTP status code associated with the error.
+   * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status
+   * @example
+   * NOT_FOUND: 404
+   * METHOD_NOT_ALLOWED: 405
+   * INTERNAL_SERVER_ERROR: 500
+   */
+  status;
+  /**
+   * The HTTP status text associated with the status code of the error.
+   * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status
+   * @example
+   * NOT_FOUND: NOT_FOUND
+   * METHOD_NOT_ALLOWED: METHOD_NOT_ALLOWED
+   * INTERNAL_SERVER_ERROR: INTERNAL_SERVER_ERROR
+   */
+  statusText;
   constructor(type, message, name) {
     super(message);
     this.name = name ?? "RouterError";
@@ -75,6 +93,9 @@ var RouterError = class extends AuraStackRouterError {
   }
 };
 var InvalidZodSchemaError = class {
+  status;
+  statusText;
+  errors;
   constructor(type, errors) {
     this.status = statusCode[type];
     this.statusText = statusText[type];
@@ -85,6 +106,7 @@ var InvalidZodSchemaError = class {
 // src/headers.ts
 var import_cookie = require("cookie");
 var HeadersBuilder = class {
+  headers;
   constructor(initialHeaders) {
     this.headers = new Headers(initialHeaders);
   }

package/dist/router.d.ts

@@ -1,8 +1,9 @@
-import { RouteEndpoint, RouterConfig, GetHttpHandlers, HTTPMethod, RoutePattern, EndpointSchemas, MiddlewareFunction } from './types.js';
+import { RouteEndpoint, RouterConfig, Router, HTTPMethod, RoutePattern, EndpointSchemas, MiddlewareFunction } from './types.js';
 import 'zod';
 import './error.js';
 import './headers.js';
 import 'cookie';
+import 'http';
 
 interface TrieNode {
     statics: Map<string, TrieNode>;
@@ -34,6 +35,6 @@ declare const search: (method: HTTPMethod, root: TrieNode, pathname: string) =>
  * @param config - Optional configuration object for the router
  * @returns An object with methods corresponding to HTTP methods, each handling requests for that method
  */
-declare const createRouter: <const Endpoints extends RouteEndpoint[]>(endpoints: Endpoints, config?: RouterConfig) => GetHttpHandlers<Endpoints>;
+declare const createRouter: <const Endpoints extends RouteEndpoint[]>(endpoints: Endpoints, config?: RouterConfig) => Router<Endpoints>;
 
 export { createNode, createRouter, insert, search };

package/dist/router.js

@@ -3,12 +3,12 @@ import {
   createRouter,
   insert,
   search
-} from "./chunk-TEDN6QMU.js";
-import "./chunk-XB5P5CQZ.js";
-import "./chunk-FU35BPU7.js";
-import "./chunk-Z6JJAIWN.js";
-import "./chunk-BWIKAYZV.js";
-import "./chunk-B6PMGVSL.js";
+} from "./chunk-WJXMLTGP.js";
+import "./chunk-6CIHAUKJ.js";
+import "./chunk-SY4MM2AG.js";
+import "./chunk-3X2BFSRT.js";
+import "./chunk-FJYSN2I6.js";
+import "./chunk-6JNMFP4L.js";
 export {
   createNode,
   createRouter,

package/dist/types.d.ts

@@ -1,6 +1,7 @@
 import { ZodObject, z } from 'zod';
 import { RouterError } from './error.js';
 import { HeadersBuilder } from './headers.js';
+import { IncomingHttpHeaders } from 'http';
 import 'cookie';
 
 /**
@@ -210,5 +211,50 @@ interface RouterConfig extends GlobalCtx {
      */
     onError?: (error: Error | RouterError, request: Request) => Response | Promise<Response>;
 }
+/**
+ * @experimental
+ */
+type ExtractEndpoint<T> = T extends RouteEndpoint<infer M, infer P, infer C> ? {
+    method: M;
+    path: P;
+    config: C;
+} : never;
+/**
+ * @experimental
+ */
+type RoutesByMethod<Defs extends readonly RouteEndpoint[], Met extends HTTPMethod> = ExtractEndpoint<Defs[number]> extends infer E ? (E extends {
+    method: Met;
+    path: infer P;
+} ? P : never) : never;
+type ExtractRoutesByMethod<Defs extends RouteEndpoint[], Met extends HTTPMethod> = Defs extends unknown[] ? Defs extends [infer First, ...infer Rest] ? First extends RouteEndpoint<infer M, infer R> ? M extends Met ? R | ExtractRoutesByMethod<Rest extends RouteEndpoint[] ? Rest : [], Met> : ExtractRoutesByMethod<Rest extends RouteEndpoint[] ? Rest : [], Met> : ExtractRoutesByMethod<Rest extends RouteEndpoint[] ? Rest : [], Met> : never : false;
+type InferZod<T> = T extends z.ZodTypeAny ? z.infer<T> : T;
+type ToInferZod<T> = {
+    [K in keyof T]: InferZod<T[K]>;
+};
+type RemoveUndefined<T> = {
+    [K in keyof T as undefined extends T[K] ? never : K]: T[K];
+};
+type Find<Defs extends RouteEndpoint[], Met extends HTTPMethod, Path extends string> = Defs extends unknown[] ? Defs extends [infer First, ...infer Rest] ? First extends RouteEndpoint<infer M, infer R, infer C> ? M extends Met ? R extends Path ? RemoveUndefined<ToInferZod<NonNullable<C["schemas"]>>> : Find<Rest extends RouteEndpoint[] ? Rest : [], Met, Path> : Find<Rest extends RouteEndpoint[] ? Rest : [], Met, Path> : Find<Rest extends RouteEndpoint[] ? Rest : [], Met, Path> : never : never;
+type Client<Defs extends RouteEndpoint[]> = {
+    [M in InferMethod<Defs> as Lowercase<M>]: <T extends ExtractRoutesByMethod<Defs, M>, Config extends Find<Defs, M, T>>(...args: Config extends EndpointSchemas ? [path: T, ctx?: RequestInit] : [path: T, ctx: Prettify<Omit<RequestInit, "body"> & Config>]) => Promise<Response>;
+};
+declare const endpointsSymbol: unique symbol;
+type Router<Endpoints extends RouteEndpoint[]> = GetHttpHandlers<Endpoints> & {
+    readonly [endpointsSymbol]?: Endpoints;
+};
+type InferEndpoints<T> = T extends Router<infer E> ? E : never;
+interface ClientOptions {
+    /**
+     * Base URL for the router client to make requests to the server.
+     * This is useful when the server is hosted on a different origin.
+     *
+     * baseURL: "https://api.example.com"
+     */
+    baseURL: string;
+    /**
+     * Default headers to include in every request made by the client.
+     */
+    headers?: IncomingHttpHeaders;
+}
 
-export type { ContentType, ContextBody, ContextParams, ContextSearchParams, EndpointConfig, EndpointSchemas, GetHttpHandlers, GetRouteParams, GlobalContext, GlobalCtx, GlobalMiddleware, GlobalMiddlewareContext, HTTPMethod, InferMethod, MiddlewareFunction, Prettify, RequestContext, RouteEndpoint, RouteHandler, RoutePattern, RouterConfig };
+export type { Client, ClientOptions, ContentType, ContextBody, ContextParams, ContextSearchParams, EndpointConfig, EndpointSchemas, ExtractEndpoint, ExtractRoutesByMethod, Find, GetHttpHandlers, GetRouteParams, GlobalContext, GlobalCtx, GlobalMiddleware, GlobalMiddlewareContext, HTTPMethod, InferEndpoints, InferMethod, InferZod, MiddlewareFunction, Prettify, RemoveUndefined, RequestContext, RouteEndpoint, RouteHandler, RoutePattern, Router, RouterConfig, RoutesByMethod, ToInferZod };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aura-stack/router",
-  "version": "0.5.0",
+  "version": "0.6.0-rc.1",
   "type": "module",
   "description": "A lightweight TypeScript library for building, managing, and validating API routes and endpoints in Node.js applications.",
   "repository": {
@@ -60,13 +60,19 @@
       "import": "./dist/cookie.js",
       "require": "./dist/cookie.cjs"
     },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.js",
+      "require": "./dist/client.cjs"
+    },
     "./types": "./dist/types.d.ts"
   },
   "devDependencies": {
+    "@types/node": "24.6.2",
     "prettier": "^3.6.2",
-    "tsup": "^8.5.0",
+    "tsup": "^8.5.1",
     "typescript": "^5.9.3",
-    "vitest": "^3.2.4",
+    "vitest": "^4.0.18",
     "zod": "^4.1.11"
   },
   "dependencies": {