@whateverjs/client 0.1.13 → 0.1.14

package/http-client.ts

@@ -0,0 +1,78 @@
+export interface HttpClientRequestOptions extends RequestInit {
+  query?: Record<string, unknown>;
+}
+
+export interface HttpRouteDefinition {
+  method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
+  path: string;
+  description?: string;
+  tags?: string[];
+  requestBody?: unknown;
+  query?: unknown;
+  response?: unknown;
+}
+
+export type HttpRouteMap = Record<string, HttpRouteDefinition>;
+
+export class TypedHttpClient<TRoutes extends HttpRouteMap = HttpRouteMap> {
+  constructor(
+    private readonly baseUrl = "",
+    private readonly fetchImpl: typeof fetch = fetch,
+  ) {}
+
+  private interpolatePath(
+    path: string,
+    params: Record<string, string | number>,
+  ): string {
+    return path.replace(/:([a-zA-Z_]\w*)/g, (_, key: string) => {
+      const value = params[key];
+      if (value === undefined || value === null) {
+        throw new Error(`Missing path parameter ${key}`);
+      }
+      return encodeURIComponent(String(value));
+    });
+  }
+
+  private buildUrl(path: string, query?: Record<string, unknown>): string {
+    const url = new URL(path, this.baseUrl || "http://localhost");
+    if (query) {
+      for (const [key, value] of Object.entries(query)) {
+        if (value === undefined || value === null) continue;
+        url.searchParams.set(key, String(value));
+      }
+    }
+    return url.toString();
+  }
+
+  protected async request<T>(
+    method: string,
+    path: string,
+    options: HttpClientRequestOptions = {},
+  ): Promise<T> {
+    const url = this.buildUrl(path, options.query);
+    const response = await this.fetchImpl(url, { ...options, method });
+    if (!response.ok) {
+      const errorText = await response.text().catch(() => "");
+      throw new Error(
+        `HTTP ${response.status}${errorText ? `: ${errorText}` : ""}`,
+      );
+    }
+    if (response.status === 204) {
+      return undefined as T;
+    }
+    const contentType = response.headers.get("content-type") || "";
+    if (contentType.includes("application/json")) {
+      return (await response.json()) as T;
+    }
+    return (await response.text()) as unknown as T;
+  }
+
+  protected buildPath(
+    path: string,
+    params: Record<string, string | number> = {},
+  ): string {
+    return Object.keys(params).length > 0
+      ? this.interpolatePath(path, params)
+      : path;
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@whateverjs/client",
-  "version": "0.1.13",
+  "version": "0.1.14",
   "main": "./index.ts",
   "module": "./index.ts",
   "types": "./index.ts",
@@ -12,6 +12,7 @@
   },
   "files": [
     "index.ts",
+    "http-client.ts",
     "README.md"
   ],
   "sideEffects": false,
@@ -24,7 +25,7 @@
     "@types/bun": "latest"
   },
   "peerDependencies": {
-    "@whateverjs/core": "^0.1.10",
+    "@whateverjs/core": "^0.1.16",
     "typescript": "^5.9.3"
   }
 }