@voltade/envoy-sdk 1.0.0

package/README.md

@@ -0,0 +1,194 @@
+# Envoy SDK
+
+A comprehensive TypeScript SDK for the Envoy API with built-in error handling and resource-based architecture.
+
+## Installation
+
+```bash
+npm install @voltade/envoy-sdk
+```
+
+## Quick Start
+
+```typescript
+import { EnvoyClient } from '@voltade/envoy-sdk';
+
+// Initialize the client
+const client = new EnvoyClient({
+  apiKey: 'your-api-key',
+  accountId: 'your-account-id',
+  baseUrl: 'https://envoy-crm.voltade.com', // optional, defaults to this
+});
+
+// Create and send a message to a conversation
+const message = await client.conversations.createMessage(123, {
+  content: 'Hello, how can I help you?',
+  message_type: 'outgoing',
+  private: false
+});
+
+// Escalate a conversation to a human agent
+const result = await client.conversations.escalateToHuman(123);
+console.log(`Escalated: ${result.success}`);
+```
+
+## Features
+
+- **Type-safe**: Full TypeScript support with comprehensive type definitions
+- **Resource-based**: Organized API methods by resource (conversations, messages, etc.)
+- **Error handling**: Structured error types for different API failures
+- **Easy to use**: Simple, intuitive API design
+
+## API Reference
+
+### EnvoyClient
+
+#### Configuration
+
+```typescript
+const client = new EnvoyClient({
+  apiKey: string;        // Required: Your Envoy API key
+  accountId: string;     // Required: Your Envoy account ID
+  baseUrl?: string;      // Optional: Base URL (defaults to https://envoy-crm.voltade.com)
+  timeout?: number;      // Optional: Request timeout in ms (defaults to 30000)
+});
+```
+
+### Conversations
+
+#### Create Message
+
+```typescript
+const message = await client.conversations.createMessage(conversationId, {
+  content: 'Your message',
+  message_type: 'outgoing',
+  private: false,
+  content_type: 'text',
+  content_attributes: {}
+});
+```
+
+#### Escalate to Human
+
+```typescript
+const result = await client.conversations.escalateToHuman(conversationId);
+
+if (result.success) {
+  console.log(`Escalated to ${result.escalation_type}`);
+  if (result.agent) {
+    console.log(`Agent: ${result.agent.name}`);
+  }
+}
+```
+
+## Error Handling
+
+The SDK provides structured error types:
+
+```typescript
+import {
+  EnvoyError,
+  AuthenticationError,
+  BadRequestError,
+  NotFoundError,
+  RateLimitError,
+  ServerError,
+  NetworkError
+} from '@voltade/envoy-sdk';
+
+try {
+  await client.conversations.createMessage(123, { content: 'Hello' });
+} catch (error) {
+  if (error instanceof AuthenticationError) {
+    console.error('Invalid API key');
+  } else if (error instanceof NotFoundError) {
+    console.error('Conversation not found');
+  } else if (error instanceof RateLimitError) {
+    console.error('Rate limit exceeded');
+  }
+}
+```
+
+## Types
+
+All TypeScript types are exported and available for use:
+
+```typescript
+import type {
+  Message,
+  Conversation,
+  CreateMessageParams,
+  EscalationResponse,
+  MessageType,
+  ContentType,
+  ConversationStatus
+} from '@voltade/envoy-sdk';
+```
+
+## Zod Schemas
+
+The SDK exposes Zod schemas for runtime validation. All types are derived from these schemas using `z.infer`:
+
+```typescript
+import {
+  MessageSchema,
+  CreateMessageParamsSchema,
+  EscalationResponseSchema,
+  ConversationSchema
+} from '@voltade/envoy-sdk';
+
+// Validate data at runtime
+const messageData = {
+  id: 123,
+  content: 'Hello',
+  message_type: 'outgoing',
+  // ... other fields
+};
+
+const validatedMessage = MessageSchema.parse(messageData);
+
+// Validate user input
+const userInput = {
+  content: 'Hello, world!',
+  message_type: 'outgoing',
+  private: false
+};
+
+const validatedParams = CreateMessageParamsSchema.parse(userInput);
+await client.conversations.createMessage(123, validatedParams);
+```
+
+### Available Schemas
+
+All schemas are exported from the SDK:
+- `MessageTypeSchema`
+- `ContentTypeSchema`
+- `CreateMessageParamsSchema`
+- `MessageSchema`
+- `EscalationTypeSchema`
+- `PrioritySchema`
+- `TeamSchema`
+- `AgentSchema`
+- `EscalationResponseSchema`
+- `ConversationStatusSchema`
+- `ConversationSchema`
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build the SDK
+npm run build
+
+# Lint
+npm run lint
+
+# Clean build artifacts
+npm run clean
+```
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,57 @@
+import { HttpClient } from './http-client.js';
+import { Conversations, Inboxes } from './resources/index.js';
+/**
+ * Configuration options for EnvoyClient
+ */
+export interface EnvoyClientConfig {
+    apiKey: string;
+    accountId: string;
+    baseUrl?: string;
+    timeout?: number;
+}
+/**
+ * Envoy API Client
+ * A comprehensive SDK for interacting with the Envoy API
+ *
+ * @example
+ * ```typescript
+ * // Initialize the client
+ * const client = new EnvoyClient({
+ *   apiKey: 'your-api-key',
+ *   accountId: 'your-account-id'
+ * });
+ *
+ * // Create and send a message to a conversation
+ * const message = await client.conversations.createMessage(123, {
+ *   content: 'Hello, how can I help you?',
+ *   message_type: 'outgoing',
+ *   private: false
+ * });
+ *
+ * // Escalate a conversation to a human
+ * const result = await client.conversations.escalateToHuman(123);
+ *
+ * // Search knowledge base
+ * const articles = await client.inboxes.searchPortals(1, {
+ *   queries: ['shipping', 'policy']
+ * });
+ * ```
+ */
+export declare class EnvoyClient {
+    private readonly httpClient;
+    /**
+     * Conversations resource for managing conversations and messages
+     */
+    readonly conversations: Conversations;
+    /**
+     * Inboxes resource for managing inboxes and searching knowledge base
+     */
+    readonly inboxes: Inboxes;
+    constructor(config: EnvoyClientConfig);
+    /**
+     * Get the HTTP client instance (for advanced use cases)
+     * @returns The underlying HTTP client
+     */
+    getHttpClient(): HttpClient;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAyB,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IAExC;;OAEG;IACH,SAAgB,aAAa,EAAE,aAAa,CAAC;IAE7C;;OAEG;IACH,SAAgB,OAAO,EAAE,OAAO,CAAC;gBAErB,MAAM,EAAE,iBAAiB;IAYrC;;;OAGG;IACH,aAAa,IAAI,UAAU;CAG5B"}

package/dist/client.js

@@ -0,0 +1,49 @@
+import { HttpClient } from './http-client.js';
+import { Conversations, Inboxes } from './resources/index.js';
+/**
+ * Envoy API Client
+ * A comprehensive SDK for interacting with the Envoy API
+ *
+ * @example
+ * ```typescript
+ * // Initialize the client
+ * const client = new EnvoyClient({
+ *   apiKey: 'your-api-key',
+ *   accountId: 'your-account-id'
+ * });
+ *
+ * // Create and send a message to a conversation
+ * const message = await client.conversations.createMessage(123, {
+ *   content: 'Hello, how can I help you?',
+ *   message_type: 'outgoing',
+ *   private: false
+ * });
+ *
+ * // Escalate a conversation to a human
+ * const result = await client.conversations.escalateToHuman(123);
+ *
+ * // Search knowledge base
+ * const articles = await client.inboxes.searchPortals(1, {
+ *   queries: ['shipping', 'policy']
+ * });
+ * ```
+ */
+export class EnvoyClient {
+    constructor(config) {
+        const httpConfig = {
+            ...config,
+        };
+        this.httpClient = new HttpClient(httpConfig);
+        // Initialize resources
+        this.conversations = new Conversations(this.httpClient);
+        this.inboxes = new Inboxes(this.httpClient);
+    }
+    /**
+     * Get the HTTP client instance (for advanced use cases)
+     * @returns The underlying HTTP client
+     */
+    getHttpClient() {
+        return this.httpClient;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAyB,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAY9D;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,OAAO,WAAW;IAatB,YAAY,MAAyB;QACnC,MAAM,UAAU,GAAqB;YACnC,GAAG,MAAM;SACV,CAAC;QAEF,IAAI,CAAC,UAAU,GAAG,IAAI,UAAU,CAAC,UAAU,CAAC,CAAC;QAE7C,uBAAuB;QACvB,IAAI,CAAC,aAAa,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACxD,IAAI,CAAC,OAAO,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC9C,CAAC;IAED;;;OAGG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;CACF"}

package/dist/errors.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Base error class for all Envoy API errors
+ */
+export declare class EnvoyError extends Error {
+    constructor(message: string);
+}
+/**
+ * Error thrown when the API returns a 400 Bad Request
+ */
+export declare class BadRequestError extends EnvoyError {
+    readonly statusCode: number;
+    readonly response?: unknown | undefined;
+    constructor(message: string, statusCode?: number, response?: unknown | undefined);
+}
+/**
+ * Error thrown when authentication fails (401)
+ */
+export declare class AuthenticationError extends EnvoyError {
+    readonly statusCode: number;
+    constructor(message?: string, statusCode?: number);
+}
+/**
+ * Error thrown when a resource is not found (404)
+ */
+export declare class NotFoundError extends EnvoyError {
+    readonly statusCode: number;
+    constructor(message: string, statusCode?: number);
+}
+/**
+ * Error thrown when rate limit is exceeded (429)
+ */
+export declare class RateLimitError extends EnvoyError {
+    readonly statusCode: number;
+    readonly retryAfter?: number | undefined;
+    constructor(message?: string, statusCode?: number, retryAfter?: number | undefined);
+}
+/**
+ * Error thrown when the server returns a 5xx error
+ */
+export declare class ServerError extends EnvoyError {
+    readonly statusCode: number;
+    readonly response?: unknown | undefined;
+    constructor(message: string, statusCode: number, response?: unknown | undefined);
+}
+/**
+ * Error thrown when a network error occurs
+ */
+export declare class NetworkError extends EnvoyError {
+    readonly originalError?: Error | undefined;
+    constructor(message?: string, originalError?: Error | undefined);
+}
+/**
+ * Error thrown when request validation fails
+ */
+export declare class ValidationError extends EnvoyError {
+    readonly errors?: Record<string, string[]> | undefined;
+    constructor(message: string, errors?: Record<string, string[]> | undefined);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,UAAW,SAAQ,KAAK;gBACvB,OAAO,EAAE,MAAM;CAK5B;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,UAAU;aAG3B,UAAU,EAAE,MAAM;aAClB,QAAQ,CAAC,EAAE,OAAO;gBAFlC,OAAO,EAAE,MAAM,EACC,UAAU,GAAE,MAAY,EACxB,QAAQ,CAAC,EAAE,OAAO,YAAA;CAMrC;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,UAAU;aAG/B,UAAU,EAAE,MAAM;gBADlC,OAAO,GAAE,MAAoE,EAC7D,UAAU,GAAE,MAAY;CAM3C;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,UAAU;aAGzB,UAAU,EAAE,MAAM;gBADlC,OAAO,EAAE,MAAM,EACC,UAAU,GAAE,MAAY;CAM3C;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,UAAU;aAG1B,UAAU,EAAE,MAAM;aAClB,UAAU,CAAC,EAAE,MAAM;gBAFnC,OAAO,GAAE,MAAuD,EAChD,UAAU,GAAE,MAAY,EACxB,UAAU,CAAC,EAAE,MAAM,YAAA;CAMtC;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,UAAU;aAGvB,UAAU,EAAE,MAAM;aAClB,QAAQ,CAAC,EAAE,OAAO;gBAFlC,OAAO,EAAE,MAAM,EACC,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,OAAO,YAAA;CAMrC;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,UAAU;aAGxB,aAAa,CAAC,EAAE,KAAK;gBADrC,OAAO,GAAE,MAAgE,EACzD,aAAa,CAAC,EAAE,KAAK,YAAA;CAMxC;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,UAAU;aAG3B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;gBADjD,OAAO,EAAE,MAAM,EACC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,YAAA;CAMpD"}

package/dist/errors.js

@@ -0,0 +1,91 @@
+/**
+ * Base error class for all Envoy API errors
+ */
+export class EnvoyError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'EnvoyError';
+        Object.setPrototypeOf(this, EnvoyError.prototype);
+    }
+}
+/**
+ * Error thrown when the API returns a 400 Bad Request
+ */
+export class BadRequestError extends EnvoyError {
+    constructor(message, statusCode = 400, response) {
+        super(message);
+        this.statusCode = statusCode;
+        this.response = response;
+        this.name = 'BadRequestError';
+        Object.setPrototypeOf(this, BadRequestError.prototype);
+    }
+}
+/**
+ * Error thrown when authentication fails (401)
+ */
+export class AuthenticationError extends EnvoyError {
+    constructor(message = 'Authentication failed. Please check your API credentials.', statusCode = 401) {
+        super(message);
+        this.statusCode = statusCode;
+        this.name = 'AuthenticationError';
+        Object.setPrototypeOf(this, AuthenticationError.prototype);
+    }
+}
+/**
+ * Error thrown when a resource is not found (404)
+ */
+export class NotFoundError extends EnvoyError {
+    constructor(message, statusCode = 404) {
+        super(message);
+        this.statusCode = statusCode;
+        this.name = 'NotFoundError';
+        Object.setPrototypeOf(this, NotFoundError.prototype);
+    }
+}
+/**
+ * Error thrown when rate limit is exceeded (429)
+ */
+export class RateLimitError extends EnvoyError {
+    constructor(message = 'Rate limit exceeded. Please try again later.', statusCode = 429, retryAfter) {
+        super(message);
+        this.statusCode = statusCode;
+        this.retryAfter = retryAfter;
+        this.name = 'RateLimitError';
+        Object.setPrototypeOf(this, RateLimitError.prototype);
+    }
+}
+/**
+ * Error thrown when the server returns a 5xx error
+ */
+export class ServerError extends EnvoyError {
+    constructor(message, statusCode, response) {
+        super(message);
+        this.statusCode = statusCode;
+        this.response = response;
+        this.name = 'ServerError';
+        Object.setPrototypeOf(this, ServerError.prototype);
+    }
+}
+/**
+ * Error thrown when a network error occurs
+ */
+export class NetworkError extends EnvoyError {
+    constructor(message = 'Network error occurred. Please check your connection.', originalError) {
+        super(message);
+        this.originalError = originalError;
+        this.name = 'NetworkError';
+        Object.setPrototypeOf(this, NetworkError.prototype);
+    }
+}
+/**
+ * Error thrown when request validation fails
+ */
+export class ValidationError extends EnvoyError {
+    constructor(message, errors) {
+        super(message);
+        this.errors = errors;
+        this.name = 'ValidationError';
+        Object.setPrototypeOf(this, ValidationError.prototype);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../errors.ts"],"names":[],"mappings":"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"}

package/dist/http-client.d.ts

@@ -0,0 +1,64 @@
+/**
+ * HTTP client configuration options
+ */
+export interface HttpClientConfig {
+    apiKey: string;
+    accountId: string;
+    baseUrl?: string;
+    timeout?: number;
+}
+/**
+ * Request options for HTTP methods
+ */
+export interface RequestOptions {
+    params?: Record<string, string | number | boolean | undefined>;
+    headers?: Record<string, string>;
+    timeout?: number;
+}
+/**
+ * Base HTTP client for making requests to the Envoy API
+ */
+export declare class HttpClient {
+    private readonly apiKey;
+    private readonly accountId;
+    private readonly baseUrl;
+    private readonly timeout;
+    constructor(config: HttpClientConfig);
+    /**
+     * Get the default headers for all requests
+     */
+    private getDefaultHeaders;
+    /**
+     * Build the full URL with path and query parameters
+     */
+    private buildUrl;
+    /**
+     * Handle HTTP response and throw appropriate errors
+     */
+    private handleResponse;
+    /**
+     * Make an HTTP request
+     */
+    private request;
+    /**
+     * Make a GET request
+     */
+    get<T>(path: string, options?: RequestOptions): Promise<T>;
+    /**
+     * Make a POST request
+     */
+    post<T>(path: string, body?: unknown, options?: RequestOptions): Promise<T>;
+    /**
+     * Make a PUT request
+     */
+    put<T>(path: string, body?: unknown, options?: RequestOptions): Promise<T>;
+    /**
+     * Make a PATCH request
+     */
+    patch<T>(path: string, body?: unknown, options?: RequestOptions): Promise<T>;
+    /**
+     * Make a DELETE request
+     */
+    delete<T>(path: string, options?: RequestOptions): Promise<T>;
+}
+//# sourceMappingURL=http-client.d.ts.map

package/dist/http-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../http-client.ts"],"names":[],"mappings":"AAUA;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,MAAM,EAAE,gBAAgB;IAOpC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAOzB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAqBhB;;OAEG;YACW,cAAc;IAqD5B;;OAEG;YACW,OAAO;IA4CrB;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAIhE;;OAEG;IACG,IAAI,CAAC,CAAC,EACV,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,CAAC,CAAC;IAIb;;OAEG;IACG,GAAG,CAAC,CAAC,EACT,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,CAAC,CAAC;IAIb;;OAEG;IACG,KAAK,CAAC,CAAC,EACX,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,CAAC,CAAC;IAIb;;OAEG;IACG,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;CAGpE"}

package/dist/http-client.js

@@ -0,0 +1,159 @@
+import { AuthenticationError, BadRequestError, EnvoyError, NetworkError, NotFoundError, RateLimitError, ServerError, } from './errors.js';
+/**
+ * Base HTTP client for making requests to the Envoy API
+ */
+export class HttpClient {
+    constructor(config) {
+        this.apiKey = config.apiKey;
+        this.accountId = config.accountId;
+        this.baseUrl = config.baseUrl || 'https://envoy-crm.voltade.com';
+        this.timeout = config.timeout ?? 30000; // 30 seconds default
+    }
+    /**
+     * Get the default headers for all requests
+     */
+    getDefaultHeaders() {
+        return {
+            'Content-Type': 'application/json',
+            api_access_token: this.apiKey,
+        };
+    }
+    /**
+     * Build the full URL with path and query parameters
+     */
+    buildUrl(path, params) {
+        // Ensure path starts with a slash
+        const normalizedPath = path.startsWith('/') ? path : `/${path}`;
+        const url = `${this.baseUrl}/api/v1/accounts/${this.accountId}${normalizedPath}`;
+        if (!params) {
+            return url;
+        }
+        // Filter out undefined values and build query string
+        const searchParams = new URLSearchParams();
+        for (const [key, value] of Object.entries(params)) {
+            if (value !== undefined && value !== null) {
+                searchParams.append(key, String(value));
+            }
+        }
+        const queryString = searchParams.toString();
+        return queryString ? `${url}?${queryString}` : url;
+    }
+    /**
+     * Handle HTTP response and throw appropriate errors
+     */
+    async handleResponse(response) {
+        // Success response
+        if (response.ok) {
+            const contentType = response.headers.get('content-type');
+            if (contentType?.includes('application/json')) {
+                return (await response.json());
+            }
+            // Return empty object for non-JSON responses
+            return {};
+        }
+        // Error handling
+        let errorMessage;
+        let errorData;
+        try {
+            const contentType = response.headers.get('content-type');
+            if (contentType?.includes('application/json')) {
+                errorData = await response.json();
+                errorMessage =
+                    errorData.message ||
+                        `Request failed with status ${response.status}`;
+            }
+            else {
+                errorMessage = await response.text();
+            }
+        }
+        catch {
+            errorMessage = `Request failed with status ${response.status}`;
+        }
+        // Throw specific error types based on status code
+        switch (response.status) {
+            case 400:
+                throw new BadRequestError(errorMessage, response.status, errorData);
+            case 401:
+                throw new AuthenticationError(errorMessage, response.status);
+            case 404:
+                throw new NotFoundError(errorMessage, response.status);
+            case 429: {
+                const retryAfter = response.headers.get('Retry-After');
+                throw new RateLimitError(errorMessage, response.status, retryAfter ? parseInt(retryAfter, 10) : undefined);
+            }
+            default:
+                if (response.status >= 500) {
+                    throw new ServerError(errorMessage, response.status, errorData);
+                }
+                throw new EnvoyError(errorMessage);
+        }
+    }
+    /**
+     * Make an HTTP request
+     */
+    async request(method, path, options = {}) {
+        const url = this.buildUrl(path, options.params);
+        const headers = {
+            ...this.getDefaultHeaders(),
+            ...options.headers,
+        };
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await fetch(url, {
+                method,
+                headers,
+                body: options.body ? JSON.stringify(options.body) : undefined,
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            return await this.handleResponse(response);
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            // Re-throw Envoy errors as-is
+            if (error instanceof EnvoyError) {
+                throw error;
+            }
+            // Handle network/timeout errors
+            if (error instanceof Error) {
+                if (error.name === 'AbortError') {
+                    throw new NetworkError('Request timeout', error);
+                }
+                throw new NetworkError(`Network error: ${error.message}`, error);
+            }
+            throw new NetworkError('Unknown network error');
+        }
+    }
+    /**
+     * Make a GET request
+     */
+    async get(path, options) {
+        return this.request('GET', path, options);
+    }
+    /**
+     * Make a POST request
+     */
+    async post(path, body, options) {
+        return this.request('POST', path, { ...options, body });
+    }
+    /**
+     * Make a PUT request
+     */
+    async put(path, body, options) {
+        return this.request('PUT', path, { ...options, body });
+    }
+    /**
+     * Make a PATCH request
+     */
+    async patch(path, body, options) {
+        return this.request('PATCH', path, { ...options, body });
+    }
+    /**
+     * Make a DELETE request
+     */
+    async delete(path, options) {
+        return this.request('DELETE', path, options);
+    }
+}
+//# sourceMappingURL=http-client.js.map