@talosjs/fetcher 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Talos
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,476 @@
+# @talosjs/fetcher
+
+Lightweight HTTP client with typed headers, response parsing, and configurable request/response handling for external API integration. This package provides a fluent API for HTTP operations with built-in support for authentication tokens, content types, request cancellation, and file uploads.
+
+![Browser](https://img.shields.io/badge/Browser-Compatible-green?style=flat-square&logo=googlechrome)
+![Bun](https://img.shields.io/badge/Bun-Compatible-orange?style=flat-square&logo=bun)
+![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue?style=flat-square&logo=typescript)
+![MIT License](https://img.shields.io/badge/License-MIT-yellow?style=flat-square)
+
+## Features
+
+✅ **Simple API** - Intuitive methods for GET, POST, PUT, PATCH, DELETE, HEAD, and OPTIONS
+
+✅ **Typed Responses** - Generic response types with `ResponseDataType<T>` for full TypeScript support
+
+✅ **Authentication** - Built-in support for Bearer and Basic authentication tokens
+
+✅ **File Uploads** - Easy file upload with automatic FormData handling
+
+✅ **Request Cancellation** - Abort in-flight requests with AbortController integration
+
+✅ **Header Management** - Typed header manipulation via `@talosjs/http-header`
+
+✅ **Base URL Support** - Configure base URL for cleaner API calls
+
+✅ **Cloneable** - Create independent copies of configured fetcher instances
+
+## Installation
+
+```bash
+bun add @talosjs/fetcher
+```
+
+## Usage
+
+### Basic GET Request
+
+```typescript
+import { Fetcher } from '@talosjs/fetcher';
+
+const fetcher = new Fetcher('https://api.example.com');
+
+const response = await fetcher.get<{ users: User[] }>('/users');
+
+if (response.success) {
+  console.log(response.data.users);
+} else {
+  console.error(response.message);
+}
+```
+
+### POST Request with Data
+
+```typescript
+import { Fetcher } from '@talosjs/fetcher';
+
+const fetcher = new Fetcher('https://api.example.com');
+
+const response = await fetcher.post<{ user: User }>('/users', {
+  name: 'John Doe',
+  email: 'john@example.com'
+});
+
+if (response.success) {
+  console.log('Created user:', response.data.user);
+}
+```
+
+### With Authentication
+
+```typescript
+import { Fetcher } from '@talosjs/fetcher';
+
+const fetcher = new Fetcher('https://api.example.com');
+
+// Set Bearer token
+fetcher.setBearerToken('your-jwt-token');
+
+const response = await fetcher.get<{ profile: Profile }>('/me');
+
+// Clear token when done
+fetcher.clearBearerToken();
+```
+
+### File Upload
+
+```typescript
+import { Fetcher } from '@talosjs/fetcher';
+
+const fetcher = new Fetcher('https://api.example.com');
+
+const file = document.querySelector('input[type="file"]').files[0];
+
+const response = await fetcher.upload<{ url: string }>(
+  '/upload',
+  file,
+  'avatar' // form field name
+);
+
+if (response.success) {
+  console.log('Uploaded to:', response.data.url);
+}
+```
+
+### Request Cancellation
+
+```typescript
+import { Fetcher } from '@talosjs/fetcher';
+
+const fetcher = new Fetcher('https://api.example.com');
+
+// Start a request
+const promise = fetcher.get('/slow-endpoint');
+
+// Cancel it
+fetcher.abort();
+
+// Handle the cancellation
+try {
+  await promise;
+} catch (error) {
+  if (error.name === 'AbortError') {
+    console.log('Request was cancelled');
+  }
+}
+```
+
+## API Reference
+
+### Classes
+
+#### `Fetcher`
+
+HTTP client class for making fetch requests.
+
+**Constructor:**
+```typescript
+new Fetcher(baseURL?: string)
+```
+
+**Parameters:**
+- `baseURL` - Optional base URL to prepend to all request paths
+
+**Properties:**
+
+##### `header: Header`
+
+Access to the underlying Header instance for advanced header manipulation.
+
+**Methods:**
+
+##### `get<T>(path: string): Promise<ResponseDataType<T>>`
+
+Performs a GET request.
+
+**Parameters:**
+- `path` - Request path (appended to base URL if set)
+
+**Returns:** Promise resolving to typed response data
+
+**Example:**
+```typescript
+const response = await fetcher.get<{ items: Item[] }>('/items');
+```
+
+##### `post<T>(path: string, data?: unknown): Promise<ResponseDataType<T>>`
+
+Performs a POST request with optional body data.
+
+**Parameters:**
+- `path` - Request path
+- `data` - Optional request body (automatically JSON-stringified for objects)
+
+**Returns:** Promise resolving to typed response data
+
+**Example:**
+```typescript
+const response = await fetcher.post<{ id: string }>('/items', { name: 'New Item' });
+```
+
+##### `put<T>(path: string, data?: unknown): Promise<ResponseDataType<T>>`
+
+Performs a PUT request with optional body data.
+
+##### `patch<T>(path: string, data?: unknown): Promise<ResponseDataType<T>>`
+
+Performs a PATCH request with optional body data.
+
+##### `delete<T>(path: string): Promise<ResponseDataType<T>>`
+
+Performs a DELETE request.
+
+##### `head<T>(path: string): Promise<ResponseDataType<T>>`
+
+Performs a HEAD request.
+
+##### `options<T>(path: string): Promise<ResponseDataType<T>>`
+
+Performs an OPTIONS request.
+
+##### `request<T>(method: HttpMethodType, path: string, data?: unknown): Promise<ResponseDataType<T>>`
+
+Performs a custom HTTP request.
+
+**Parameters:**
+- `method` - HTTP method (GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS)
+- `path` - Request path
+- `data` - Optional request body
+
+**Example:**
+```typescript
+const response = await fetcher.request<{ result: string }>('POST', '/custom', { foo: 'bar' });
+```
+
+##### `upload<T>(path: string, file: File | Blob, name?: string): Promise<ResponseDataType<T>>`
+
+Uploads a file using multipart/form-data.
+
+**Parameters:**
+- `path` - Upload endpoint path
+- `file` - File or Blob to upload
+- `name` - Form field name (default: 'file')
+
+**Returns:** Promise resolving to typed response data
+
+**Example:**
+```typescript
+const response = await fetcher.upload<{ url: string }>('/upload', file, 'document');
+```
+
+##### `setBearerToken(token: string): this`
+
+Sets the Authorization header with a Bearer token.
+
+**Parameters:**
+- `token` - JWT or other bearer token
+
+**Returns:** The fetcher instance for chaining
+
+##### `setBasicToken(token: string): this`
+
+Sets the Authorization header with Basic authentication.
+
+**Parameters:**
+- `token` - Base64-encoded credentials
+
+**Returns:** The fetcher instance for chaining
+
+##### `clearBearerToken(): this`
+
+Removes the Authorization header.
+
+**Returns:** The fetcher instance for chaining
+
+##### `clearBasicToken(): this`
+
+Removes the Authorization header.
+
+**Returns:** The fetcher instance for chaining
+
+##### `setContentType(contentType: MimeType): this`
+
+Sets the Content-Type header.
+
+**Parameters:**
+- `contentType` - MIME type string
+
+**Returns:** The fetcher instance for chaining
+
+##### `setLang(lang: string): this`
+
+Sets the Accept-Language or custom language header.
+
+**Parameters:**
+- `lang` - Language code (e.g., 'en', 'fr')
+
+**Returns:** The fetcher instance for chaining
+
+##### `abort(): this`
+
+Cancels any in-flight requests and resets the AbortController.
+
+**Returns:** The fetcher instance for chaining
+
+##### `clone(): Fetcher`
+
+Creates a new Fetcher instance with the same base URL.
+
+**Returns:** New Fetcher instance
+
+### Interfaces
+
+#### `IFetcher`
+
+```typescript
+interface IFetcher {
+  readonly header: Header;
+  
+  setBearerToken(token: string): IFetcher;
+  setBasicToken(token: string): IFetcher;
+  clearBearerToken(): IFetcher;
+  clearBasicToken(): IFetcher;
+  setContentType(contentType: MimeType): IFetcher;
+  setLang(lang: string): IFetcher;
+  abort(): IFetcher;
+  clone(): IFetcher;
+  
+  get<T>(path: string): Promise<ResponseDataType<T>>;
+  post<T>(path: string, data?: unknown): Promise<ResponseDataType<T>>;
+  put<T>(path: string, data?: unknown): Promise<ResponseDataType<T>>;
+  patch<T>(path: string, data?: unknown): Promise<ResponseDataType<T>>;
+  delete<T>(path: string): Promise<ResponseDataType<T>>;
+  head<T>(path: string): Promise<ResponseDataType<T>>;
+  options<T>(path: string): Promise<ResponseDataType<T>>;
+  request<T>(method: HttpMethodType, path: string, data?: unknown): Promise<ResponseDataType<T>>;
+  upload<T>(path: string, file: File | Blob, name?: string): Promise<ResponseDataType<T>>;
+}
+```
+
+## Advanced Usage
+
+### Creating API Client Classes
+
+```typescript
+import { Fetcher } from '@talosjs/fetcher';
+
+class UserApi {
+  private fetcher: Fetcher;
+
+  constructor(baseUrl: string, token?: string) {
+    this.fetcher = new Fetcher(baseUrl);
+    if (token) {
+      this.fetcher.setBearerToken(token);
+    }
+  }
+
+  public async getUsers() {
+    return this.fetcher.get<{ users: User[] }>('/users');
+  }
+
+  public async createUser(data: CreateUserDto) {
+    return this.fetcher.post<{ user: User }>('/users', data);
+  }
+
+  public async updateUser(id: string, data: UpdateUserDto) {
+    return this.fetcher.patch<{ user: User }>(`/users/${id}`, data);
+  }
+
+  public async deleteUser(id: string) {
+    return this.fetcher.delete<{ success: boolean }>(`/users/${id}`);
+  }
+}
+```
+
+### Request Interceptors with Header Manipulation
+
+```typescript
+import { Fetcher } from '@talosjs/fetcher';
+
+const fetcher = new Fetcher('https://api.example.com');
+
+// Add custom headers
+fetcher.header.set('X-Request-ID', generateRequestId());
+fetcher.header.set('X-Client-Version', '1.0.0');
+
+const response = await fetcher.get('/endpoint');
+```
+
+### Error Handling
+
+```typescript
+import { Fetcher } from '@talosjs/fetcher';
+
+const fetcher = new Fetcher('https://api.example.com');
+
+const response = await fetcher.get<{ data: string }>('/resource');
+
+if (response.success) {
+  // Handle successful response
+  console.log(response.data);
+} else if (response.isClientError) {
+  // Handle 4xx errors
+  console.error('Client error:', response.message);
+} else if (response.isServerError) {
+  // Handle 5xx errors
+  console.error('Server error:', response.message);
+} else if (response.isNotFound) {
+  // Handle 404
+  console.error('Resource not found');
+} else if (response.isUnauthorized) {
+  // Handle 401
+  console.error('Unauthorized - please login');
+}
+```
+
+### Chaining Configuration
+
+```typescript
+import { Fetcher } from '@talosjs/fetcher';
+
+const fetcher = new Fetcher('https://api.example.com')
+  .setBearerToken('your-token')
+  .setLang('en')
+  .setContentType('application/json');
+
+const response = await fetcher.post('/data', { key: 'value' });
+```
+
+### Cloning for Different Contexts
+
+```typescript
+import { Fetcher } from '@talosjs/fetcher';
+
+const baseFetcher = new Fetcher('https://api.example.com');
+
+// Create authenticated clone
+const authFetcher = baseFetcher.clone();
+authFetcher.setBearerToken('user-token');
+
+// Create admin clone
+const adminFetcher = baseFetcher.clone();
+adminFetcher.setBearerToken('admin-token');
+
+// Use independently
+await authFetcher.get('/user/profile');
+await adminFetcher.get('/admin/dashboard');
+```
+
+### Uploading Multiple Files
+
+```typescript
+import { Fetcher } from '@talosjs/fetcher';
+
+const fetcher = new Fetcher('https://api.example.com');
+
+async function uploadFiles(files: File[]) {
+  const results = [];
+  
+  for (const file of files) {
+    const response = await fetcher.upload<{ url: string }>(
+      '/upload',
+      file,
+      'file'
+    );
+    results.push(response);
+  }
+  
+  return results;
+}
+```
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](./LICENSE) file for details.
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
+
+### Development Setup
+
+1. Clone the repository
+2. Install dependencies: `bun install`
+3. Run tests: `bun run test`
+4. Build the project: `bun run build`
+
+### Guidelines
+
+- Write tests for new features
+- Follow the existing code style
+- Update documentation for API changes
+- Ensure all tests pass before submitting PR
+
+---
+
+Made with ❤️ by the Talos team

package/dist/index.d.ts

@@ -0,0 +1,54 @@
+import { Header as Header2 } from "@talosjs/http-header";
+import { MimeType as MimeType2 } from "@talosjs/http-mimes";
+import { ResponseDataType as ResponseDataType2 } from "@talosjs/http-response";
+import { HttpMethodType as HttpMethodType2 } from "@talosjs/types";
+import { Header } from "@talosjs/http-header";
+import { MimeType } from "@talosjs/http-mimes";
+import { ResponseDataType } from "@talosjs/http-response";
+import { HttpMethodType } from "@talosjs/types";
+interface IFetcher {
+	readonly header: Header;
+	setBearerToken(token: string): IFetcher;
+	setBasicToken(token: string): IFetcher;
+	clearBearerToken(): IFetcher;
+	clearBasicToken(): IFetcher;
+	setContentType(contentType: MimeType): IFetcher;
+	setLang(lang: string): IFetcher;
+	abort(): IFetcher;
+	clone(): IFetcher;
+	get<T extends Record<string, unknown> = Record<string, unknown>>(path: string): Promise<ResponseDataType<T>>;
+	post<T extends Record<string, unknown> = Record<string, unknown>>(path: string, data?: unknown): Promise<ResponseDataType<T>>;
+	put<T extends Record<string, unknown> = Record<string, unknown>>(path: string, data?: unknown): Promise<ResponseDataType<T>>;
+	patch<T extends Record<string, unknown> = Record<string, unknown>>(path: string, data?: unknown): Promise<ResponseDataType<T>>;
+	delete<T extends Record<string, unknown> = Record<string, unknown>>(path: string): Promise<ResponseDataType<T>>;
+	head<T extends Record<string, unknown> = Record<string, unknown>>(path: string): Promise<ResponseDataType<T>>;
+	options<T extends Record<string, unknown> = Record<string, unknown>>(path: string): Promise<ResponseDataType<T>>;
+	request<T extends Record<string, unknown> = Record<string, unknown>>(method: HttpMethodType, path: string, data?: unknown): Promise<ResponseDataType<T>>;
+	upload<T extends Record<string, unknown> = Record<string, unknown>>(path: string, file: File | Blob, name?: string): Promise<ResponseDataType<T>>;
+}
+declare class Fetcher implements IFetcher {
+	private baseURL?;
+	private abortController;
+	readonly header: Header2;
+	constructor(baseURL?: string | undefined);
+	setBearerToken(token: string): this;
+	setBasicToken(token: string): this;
+	clearBearerToken(): this;
+	clearBasicToken(): this;
+	setContentType(contentType: MimeType2): this;
+	setLang(lang: string): this;
+	abort(): this;
+	clone(): Fetcher;
+	get<T extends Record<string, unknown> = Record<string, unknown>>(path: string): Promise<ResponseDataType2<T>>;
+	post<T extends Record<string, unknown> = Record<string, unknown>>(path: string, data?: unknown): Promise<ResponseDataType2<T>>;
+	put<T extends Record<string, unknown> = Record<string, unknown>>(path: string, data?: unknown): Promise<ResponseDataType2<T>>;
+	patch<T extends Record<string, unknown> = Record<string, unknown>>(path: string, data?: unknown): Promise<ResponseDataType2<T>>;
+	delete<T extends Record<string, unknown> = Record<string, unknown>>(path: string): Promise<ResponseDataType2<T>>;
+	head<T extends Record<string, unknown> = Record<string, unknown>>(path: string): Promise<ResponseDataType2<T>>;
+	options<T extends Record<string, unknown> = Record<string, unknown>>(path: string): Promise<ResponseDataType2<T>>;
+	request<T extends Record<string, unknown> = Record<string, unknown>>(method: HttpMethodType2, path: string, data?: unknown): Promise<ResponseDataType2<T>>;
+	upload<T extends Record<string, unknown> = Record<string, unknown>>(path: string, file: File | Blob, name?: string): Promise<ResponseDataType2<T>>;
+	private buildURL;
+	private buildRequestOptions;
+}
+export { IFetcher, Fetcher };

package/dist/index.js

@@ -0,0 +1,129 @@
+// src/Fetcher.ts
+import { Header } from "@talosjs/http-header";
+
+class Fetcher {
+  baseURL;
+  abortController;
+  header = new Header;
+  constructor(baseURL) {
+    this.baseURL = baseURL;
+    this.abortController = new AbortController;
+  }
+  setBearerToken(token) {
+    this.header.setBearerToken(token);
+    return this;
+  }
+  setBasicToken(token) {
+    this.header.setBasicAuth(token);
+    return this;
+  }
+  clearBearerToken() {
+    this.header.remove("Authorization");
+    return this;
+  }
+  clearBasicToken() {
+    this.header.remove("Authorization");
+    return this;
+  }
+  setContentType(contentType) {
+    this.header.contentType(contentType);
+    return this;
+  }
+  setLang(lang) {
+    this.header.setLang(lang);
+    return this;
+  }
+  abort() {
+    this.abortController.abort();
+    this.abortController = new AbortController;
+    return this;
+  }
+  clone() {
+    const cloned = new Fetcher(this.baseURL);
+    return cloned;
+  }
+  async get(path) {
+    return this.request("GET", path);
+  }
+  async post(path, data) {
+    return this.request("POST", path, data);
+  }
+  async put(path, data) {
+    return this.request("PUT", path, data);
+  }
+  async patch(path, data) {
+    return this.request("PATCH", path, data);
+  }
+  async delete(path) {
+    return this.request("DELETE", path);
+  }
+  async head(path) {
+    return this.request("HEAD", path);
+  }
+  async options(path) {
+    return this.request("OPTIONS", path);
+  }
+  async request(method, path, data) {
+    const fullURL = this.buildURL(path);
+    const requestOptions = this.buildRequestOptions(method, data);
+    const response = await fetch(fullURL, requestOptions);
+    try {
+      return await response.json();
+    } catch (error) {
+      throw new Error(error instanceof Error ? error.message : "Failed to parse JSON response");
+    }
+  }
+  async upload(path, file, name = "file") {
+    const formData = new FormData;
+    formData.append(name, file);
+    const originalContentType = this.header.get("Content-Type");
+    this.header.remove("Content-Type");
+    const result = await this.request("POST", path, formData);
+    if (originalContentType) {
+      this.header.set("Content-Type", originalContentType);
+    }
+    return result;
+  }
+  buildURL(url) {
+    if (url.startsWith("http://") || url.startsWith("https://")) {
+      return url;
+    }
+    if (!this.baseURL) {
+      return url;
+    }
+    const path = url.startsWith("/") ? url : `/${url}`;
+    const baseURL = this.baseURL.endsWith("/") ? this.baseURL.slice(0, -1) : this.baseURL;
+    return `${baseURL}${path}`;
+  }
+  buildRequestOptions(method, data) {
+    const headers = this.header.native;
+    let body;
+    if (data !== undefined && method !== "GET" && method !== "HEAD" && method !== "OPTIONS") {
+      if (data instanceof FormData) {
+        body = data;
+        this.header.clearContentType();
+      } else if (typeof data === "string") {
+        body = data;
+      } else if (data instanceof Blob || data instanceof ArrayBuffer) {
+        body = data;
+      } else {
+        body = JSON.stringify(data);
+        if (!this.header.has("Content-Type")) {
+          this.header.setJson();
+        }
+      }
+    }
+    const requestOptions = {
+      method,
+      headers,
+      ...body !== undefined && { body },
+      signal: this.abortController.signal
+    };
+    return requestOptions;
+  }
+}
+export {
+  Fetcher
+};
+
+//# debugId=6BEC85E0C8278A0F64756E2164756E21

package/dist/index.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["src/Fetcher.ts"],
+  "sourcesContent": [
+    "import { Header } from \"@talosjs/http-header\";\nimport type { MimeType } from \"@talosjs/http-mimes\";\nimport type { ResponseDataType } from \"@talosjs/http-response\";\nimport type { HttpMethodType } from \"@talosjs/types\";\nimport type { IFetcher } from \"./types\";\n\nexport class Fetcher implements IFetcher {\n  private abortController: AbortController;\n  public readonly header: Header = new Header();\n\n  constructor(private baseURL?: string) {\n    this.abortController = new AbortController();\n  }\n\n  public setBearerToken(token: string): this {\n    this.header.setBearerToken(token);\n\n    return this;\n  }\n\n  public setBasicToken(token: string): this {\n    this.header.setBasicAuth(token);\n\n    return this;\n  }\n\n  public clearBearerToken(): this {\n    this.header.remove(\"Authorization\");\n\n    return this;\n  }\n\n  public clearBasicToken(): this {\n    this.header.remove(\"Authorization\");\n\n    return this;\n  }\n\n  public setContentType(contentType: MimeType): this {\n    this.header.contentType(contentType);\n\n    return this;\n  }\n\n  public setLang(lang: string): this {\n    this.header.setLang(lang);\n\n    return this;\n  }\n\n  public abort(): this {\n    this.abortController.abort();\n    this.abortController = new AbortController();\n\n    return this;\n  }\n\n  public clone(): Fetcher {\n    const cloned = new Fetcher(this.baseURL);\n    return cloned;\n  }\n\n  public async get<T extends Record<string, unknown> = Record<string, unknown>>(\n    path: string,\n  ): Promise<ResponseDataType<T>> {\n    return this.request<T>(\"GET\", path);\n  }\n\n  public async post<T extends Record<string, unknown> = Record<string, unknown>>(\n    path: string,\n    data?: unknown,\n  ): Promise<ResponseDataType<T>> {\n    return this.request<T>(\"POST\", path, data);\n  }\n\n  public async put<T extends Record<string, unknown> = Record<string, unknown>>(\n    path: string,\n    data?: unknown,\n  ): Promise<ResponseDataType<T>> {\n    return this.request<T>(\"PUT\", path, data);\n  }\n\n  public async patch<T extends Record<string, unknown> = Record<string, unknown>>(\n    path: string,\n    data?: unknown,\n  ): Promise<ResponseDataType<T>> {\n    return this.request<T>(\"PATCH\", path, data);\n  }\n\n  public async delete<T extends Record<string, unknown> = Record<string, unknown>>(\n    path: string,\n  ): Promise<ResponseDataType<T>> {\n    return this.request<T>(\"DELETE\", path);\n  }\n\n  public async head<T extends Record<string, unknown> = Record<string, unknown>>(\n    path: string,\n  ): Promise<ResponseDataType<T>> {\n    return this.request<T>(\"HEAD\", path);\n  }\n\n  public async options<T extends Record<string, unknown> = Record<string, unknown>>(\n    path: string,\n  ): Promise<ResponseDataType<T>> {\n    return this.request<T>(\"OPTIONS\", path);\n  }\n\n  public async request<T extends Record<string, unknown> = Record<string, unknown>>(\n    method: HttpMethodType,\n    path: string,\n    data?: unknown,\n  ): Promise<ResponseDataType<T>> {\n    const fullURL = this.buildURL(path);\n    const requestOptions = this.buildRequestOptions(method, data);\n    const response = await fetch(fullURL, requestOptions);\n\n    try {\n      return await response.json();\n    } catch (error) {\n      throw new Error(error instanceof Error ? error.message : \"Failed to parse JSON response\");\n    }\n  }\n\n  public async upload<T extends Record<string, unknown> = Record<string, unknown>>(\n    path: string,\n    file: File | Blob,\n    name = \"file\",\n  ): Promise<ResponseDataType<T>> {\n    const formData = new FormData();\n    formData.append(name, file);\n\n    // Clear any existing Content-Type to let browser set multipart/form-data boundary\n    const originalContentType = this.header.get(\"Content-Type\");\n    this.header.remove(\"Content-Type\");\n\n    const result = await this.request<T>(\"POST\", path, formData);\n\n    // Restore original Content-Type if it existed\n    if (originalContentType) {\n      this.header.set(\"Content-Type\", originalContentType);\n    }\n\n    return result;\n  }\n\n  private buildURL(url: string): string {\n    if (url.startsWith(\"http://\") || url.startsWith(\"https://\")) {\n      return url;\n    }\n\n    if (!this.baseURL) {\n      return url;\n    }\n\n    const path = url.startsWith(\"/\") ? url : `/${url}`;\n    const baseURL = this.baseURL.endsWith(\"/\") ? this.baseURL.slice(0, -1) : this.baseURL;\n\n    return `${baseURL}${path}`;\n  }\n\n  private buildRequestOptions(method: string, data?: unknown): RequestInit {\n    const headers = this.header.native;\n\n    let body: BodyInit | undefined;\n\n    if (data !== undefined && method !== \"GET\" && method !== \"HEAD\" && method !== \"OPTIONS\") {\n      if (data instanceof FormData) {\n        body = data;\n        this.header.clearContentType();\n      } else if (typeof data === \"string\") {\n        body = data;\n      } else if (data instanceof Blob || data instanceof ArrayBuffer) {\n        body = data;\n      } else {\n        body = JSON.stringify(data);\n        // Set Content-Type to application/json if not already set\n        if (!this.header.has(\"Content-Type\")) {\n          this.header.setJson();\n        }\n      }\n    }\n\n    const requestOptions: RequestInit = {\n      method,\n      headers,\n      ...(body !== undefined && { body }),\n      signal: this.abortController.signal,\n    };\n\n    return requestOptions;\n  }\n}\n"
+  ],
+  "mappings": ";AAAA;AAAA;AAMO,MAAM,QAA4B;AAAA,EAInB;AAAA,EAHZ;AAAA,EACQ,SAAiB,IAAI;AAAA,EAErC,WAAW,CAAS,SAAkB;AAAA,IAAlB;AAAA,IAClB,KAAK,kBAAkB,IAAI;AAAA;AAAA,EAGtB,cAAc,CAAC,OAAqB;AAAA,IACzC,KAAK,OAAO,eAAe,KAAK;AAAA,IAEhC,OAAO;AAAA;AAAA,EAGF,aAAa,CAAC,OAAqB;AAAA,IACxC,KAAK,OAAO,aAAa,KAAK;AAAA,IAE9B,OAAO;AAAA;AAAA,EAGF,gBAAgB,GAAS;AAAA,IAC9B,KAAK,OAAO,OAAO,eAAe;AAAA,IAElC,OAAO;AAAA;AAAA,EAGF,eAAe,GAAS;AAAA,IAC7B,KAAK,OAAO,OAAO,eAAe;AAAA,IAElC,OAAO;AAAA;AAAA,EAGF,cAAc,CAAC,aAA6B;AAAA,IACjD,KAAK,OAAO,YAAY,WAAW;AAAA,IAEnC,OAAO;AAAA;AAAA,EAGF,OAAO,CAAC,MAAoB;AAAA,IACjC,KAAK,OAAO,QAAQ,IAAI;AAAA,IAExB,OAAO;AAAA;AAAA,EAGF,KAAK,GAAS;AAAA,IACnB,KAAK,gBAAgB,MAAM;AAAA,IAC3B,KAAK,kBAAkB,IAAI;AAAA,IAE3B,OAAO;AAAA;AAAA,EAGF,KAAK,GAAY;AAAA,IACtB,MAAM,SAAS,IAAI,QAAQ,KAAK,OAAO;AAAA,IACvC,OAAO;AAAA;AAAA,OAGI,IAAgE,CAC3E,MAC8B;AAAA,IAC9B,OAAO,KAAK,QAAW,OAAO,IAAI;AAAA;AAAA,OAGvB,KAAiE,CAC5E,MACA,MAC8B;AAAA,IAC9B,OAAO,KAAK,QAAW,QAAQ,MAAM,IAAI;AAAA;AAAA,OAG9B,IAAgE,CAC3E,MACA,MAC8B;AAAA,IAC9B,OAAO,KAAK,QAAW,OAAO,MAAM,IAAI;AAAA;AAAA,OAG7B,MAAkE,CAC7E,MACA,MAC8B;AAAA,IAC9B,OAAO,KAAK,QAAW,SAAS,MAAM,IAAI;AAAA;AAAA,OAG/B,OAAmE,CAC9E,MAC8B;AAAA,IAC9B,OAAO,KAAK,QAAW,UAAU,IAAI;AAAA;AAAA,OAG1B,KAAiE,CAC5E,MAC8B;AAAA,IAC9B,OAAO,KAAK,QAAW,QAAQ,IAAI;AAAA;AAAA,OAGxB,QAAoE,CAC/E,MAC8B;AAAA,IAC9B,OAAO,KAAK,QAAW,WAAW,IAAI;AAAA;AAAA,OAG3B,QAAoE,CAC/E,QACA,MACA,MAC8B;AAAA,IAC9B,MAAM,UAAU,KAAK,SAAS,IAAI;AAAA,IAClC,MAAM,iBAAiB,KAAK,oBAAoB,QAAQ,IAAI;AAAA,IAC5D,MAAM,WAAW,MAAM,MAAM,SAAS,cAAc;AAAA,IAEpD,IAAI;AAAA,MACF,OAAO,MAAM,SAAS,KAAK;AAAA,MAC3B,OAAO,OAAO;AAAA,MACd,MAAM,IAAI,MAAM,iBAAiB,QAAQ,MAAM,UAAU,+BAA+B;AAAA;AAAA;AAAA,OAI/E,OAAmE,CAC9E,MACA,MACA,OAAO,QACuB;AAAA,IAC9B,MAAM,WAAW,IAAI;AAAA,IACrB,SAAS,OAAO,MAAM,IAAI;AAAA,IAG1B,MAAM,sBAAsB,KAAK,OAAO,IAAI,cAAc;AAAA,IAC1D,KAAK,OAAO,OAAO,cAAc;AAAA,IAEjC,MAAM,SAAS,MAAM,KAAK,QAAW,QAAQ,MAAM,QAAQ;AAAA,IAG3D,IAAI,qBAAqB;AAAA,MACvB,KAAK,OAAO,IAAI,gBAAgB,mBAAmB;AAAA,IACrD;AAAA,IAEA,OAAO;AAAA;AAAA,EAGD,QAAQ,CAAC,KAAqB;AAAA,IACpC,IAAI,IAAI,WAAW,SAAS,KAAK,IAAI,WAAW,UAAU,GAAG;AAAA,MAC3D,OAAO;AAAA,IACT;AAAA,IAEA,IAAI,CAAC,KAAK,SAAS;AAAA,MACjB,OAAO;AAAA,IACT;AAAA,IAEA,MAAM,OAAO,IAAI,WAAW,GAAG,IAAI,MAAM,IAAI;AAAA,IAC7C,MAAM,UAAU,KAAK,QAAQ,SAAS,GAAG,IAAI,KAAK,QAAQ,MAAM,GAAG,EAAE,IAAI,KAAK;AAAA,IAE9E,OAAO,GAAG,UAAU;AAAA;AAAA,EAGd,mBAAmB,CAAC,QAAgB,MAA6B;AAAA,IACvE,MAAM,UAAU,KAAK,OAAO;AAAA,IAE5B,IAAI;AAAA,IAEJ,IAAI,SAAS,aAAa,WAAW,SAAS,WAAW,UAAU,WAAW,WAAW;AAAA,MACvF,IAAI,gBAAgB,UAAU;AAAA,QAC5B,OAAO;AAAA,QACP,KAAK,OAAO,iBAAiB;AAAA,MAC/B,EAAO,SAAI,OAAO,SAAS,UAAU;AAAA,QACnC,OAAO;AAAA,MACT,EAAO,SAAI,gBAAgB,QAAQ,gBAAgB,aAAa;AAAA,QAC9D,OAAO;AAAA,MACT,EAAO;AAAA,QACL,OAAO,KAAK,UAAU,IAAI;AAAA,QAE1B,IAAI,CAAC,KAAK,OAAO,IAAI,cAAc,GAAG;AAAA,UACpC,KAAK,OAAO,QAAQ;AAAA,QACtB;AAAA;AAAA,IAEJ;AAAA,IAEA,MAAM,iBAA8B;AAAA,MAClC;AAAA,MACA;AAAA,SACI,SAAS,aAAa,EAAE,KAAK;AAAA,MACjC,QAAQ,KAAK,gBAAgB;AAAA,IAC/B;AAAA,IAEA,OAAO;AAAA;AAEX;",
+  "debugId": "6BEC85E0C8278A0F64756E2164756E21",
+  "names": []
+}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@talosjs/fetcher",
+  "description": "Lightweight HTTP client with typed headers, response parsing, and configurable request/response handling for external API integration",
+  "version": "1.0.0",
+  "type": "module",
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md",
+    "package.json"
+  ],
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "license": "MIT",
+  "scripts": {
+    "test": "bun test tests",
+    "build": "bunup",
+    "lint": "tsgo --noEmit && bunx biome lint",
+    "npm:publish": "bun publish --tolerate-republish --force --production --access public"
+  },
+  "dependencies": {
+    "@talosjs/http-header": "^1.2.12"
+  },
+  "devDependencies": {
+    "@talosjs/http-response": "^1.4.1",
+    "@talosjs/http-mimes": "^1.1.11",
+    "@talosjs/types": "^1.3.7"
+  },
+  "keywords": [
+    "api-client",
+    "bun",
+    "fetch",
+    "fetcher",
+    "http-client",
+    "talos",
+    "typescript"
+  ]
+}