@castari/sdk 0.1.4 → 0.2.0

package/dist/client.js

@@ -1,242 +1,102 @@
-export * from './types';
-const DEFAULT_LOCAL_URL = 'http://localhost:3000';
-const DEFAULT_PLATFORM_URL = 'https://castari-api-12511-04c55b73-g4p2s9om.onporter.run';
+import { HttpClient } from './http.js';
+import { AgentsAPI } from './agents.js';
+import { UsageAPI } from './usage.js';
+import { AuthAPI } from './auth.js';
+import { getAuth } from './config.js';
+import { AuthenticationError } from './errors.js';
+/**
+ * Main client for interacting with the Castari API
+ *
+ * @example
+ * ```typescript
+ * import { CastariClient } from '@castari/sdk';
+ *
+ * // Uses credentials from ~/.castari or CASTARI_API_KEY env var
+ * const client = new CastariClient();
+ *
+ * // Or provide credentials explicitly
+ * const client = new CastariClient({ apiKey: 'cap_xxxxx' });
+ *
+ * // List agents
+ * const agents = await client.agents.list();
+ *
+ * // Deploy an agent
+ * await client.agents.deploy('my-agent');
+ *
+ * // Invoke an agent
+ * const result = await client.agents.invoke('my-agent', { prompt: 'Hello!' });
+ * ```
+ */
 export class CastariClient {
-    ws;
     options;
-    messageHandlers = [];
-    sandboxId;
-    resolvedClientId;
-    resolvedPlatformApiKey;
+    httpClient;
+    initialized = false;
+    initPromise = null;
+    /** API for managing agents */
+    agents;
+    /** API for accessing usage statistics */
+    usage;
+    /** API for authentication operations */
+    auth;
+    /**
+     * Create a new Castari client
+     * @param options - Client configuration options
+     */
     constructor(options = {}) {
-        this.options = {
-            ...options,
-        };
-    }
-    async start() {
-        const anthropicApiKey = this.options.anthropicApiKey || process.env.ANTHROPIC_API_KEY;
-        if (!anthropicApiKey) {
-            throw new Error('ANTHROPIC_API_KEY is required');
-        }
-        this.resolvedClientId =
-            this.options.clientId || process.env.CASTARI_CLIENT_ID || undefined;
-        this.resolvedPlatformApiKey =
-            this.options.platformApiKey || process.env.CASTARI_API_KEY || undefined;
-        const connection = this.options.connectionUrl
-            ? await this.setupLocalConnection()
-            : await this.setupPlatformConnection();
-        if (this.options.debug) {
-            console.log(`📡 Configuring server at ${connection.configUrl}...`);
-        }
-        const configPayload = {
-            anthropicApiKey,
-            agents: this.options.agents,
-            allowedTools: this.options.allowedTools,
-            systemPrompt: this.options.systemPrompt,
-            model: this.options.model,
-            resume: this.options.resume,
-        };
-        if (this.options.debug) {
-            console.log(`📋 Config payload:`, JSON.stringify(configPayload, null, 2));
-        }
-        const configHeaders = {
-            'Content-Type': 'application/json',
-            ...connection.authHeaders,
-        };
-        let configResponse = null;
-        const maxConfigAttempts = 5;
-        for (let attempt = 1; attempt <= maxConfigAttempts; attempt++) {
-            configResponse = await fetch(connection.configUrl, {
-                method: 'POST',
-                headers: configHeaders,
-                body: JSON.stringify(configPayload),
-            }).catch(err => {
-                if (this.options.debug) {
-                    console.warn(`⚠️ Config request failed on attempt ${attempt}:`, err);
-                }
-                return null;
-            });
-            if (configResponse && configResponse.ok)
-                break;
-            if (this.options.debug) {
-                console.warn(`⚠️ Config attempt ${attempt} failed (status ${configResponse?.status ?? 'n/a'}).`);
-            }
-            if (attempt < maxConfigAttempts) {
-                await new Promise(resolve => setTimeout(resolve, 3000));
-            }
-        }
-        if (!configResponse || !configResponse.ok) {
-            const errorText = configResponse ? await configResponse.text() : 'no response';
-            if (connection.cleanup)
-                await connection.cleanup();
-            throw new Error(`Failed to configure server (status ${configResponse?.status ?? 'n/a'}): ${errorText}`);
-        }
-        const { connectionToken } = (await configResponse.json());
-        if (!connectionToken) {
-            if (connection.cleanup)
-                await connection.cleanup();
-            throw new Error('Server did not return a connectionToken');
-        }
-        const wsUrlParams = new URLSearchParams();
-        wsUrlParams.set('token', connectionToken);
-        // Add any auth params from platform (for sandbox proxy auth)
-        if (connection.authParams) {
-            for (const [key, value] of Object.entries(connection.authParams)) {
-                wsUrlParams.set(key, value);
-            }
-        }
-        const wsUrlJoiner = connection.wsUrl.includes('?') ? '&' : '?';
-        const wsUrl = `${connection.wsUrl}${wsUrlJoiner}${wsUrlParams.toString()}`;
-        if (this.options.debug) {
-            console.log(`🔌 Connecting to WebSocket at ${wsUrl}...`);
-        }
-        return new Promise((resolve, reject) => {
-            this.ws = new WebSocket(wsUrl);
-            this.ws.onopen = () => {
-                if (this.options.debug)
-                    console.log('✅ Connected to Castari Server');
-                resolve();
-            };
-            this.ws.onmessage = event => {
-                try {
-                    const message = JSON.parse(event.data.toString());
-                    this.handleMessage(message);
-                }
-                catch (error) {
-                    console.error('Failed to parse message:', error);
-                }
-            };
-            this.ws.onerror = error => {
-                console.error('WebSocket error:', error);
-                reject(error);
-            };
-            this.ws.onclose = () => {
-                if (this.options.debug)
-                    console.log('👋 Disconnected');
-            };
+        this.options = options;
+        // Create HTTP client with provided or default base URL
+        this.httpClient = new HttpClient({
+            baseUrl: options.baseUrl || 'https://web-13239-04c55b73-wp4aqyqk.onporter.run',
         });
+        // Set auth if provided directly
+        if (options.apiKey) {
+            this.httpClient.setAuth('api_key', options.apiKey);
+            this.initialized = true;
+        }
+        else if (options.token) {
+            this.httpClient.setAuth('token', options.token);
+            this.initialized = true;
+        }
+        // Initialize API classes
+        this.agents = new AgentsAPI(this.httpClient);
+        this.usage = new UsageAPI(this.httpClient);
+        this.auth = new AuthAPI(this.httpClient);
     }
-    async setupLocalConnection() {
-        const baseUrl = (this.options.connectionUrl || DEFAULT_LOCAL_URL).replace(/\/$/, '');
-        return {
-            configUrl: `${baseUrl.replace('ws://', 'http://').replace('wss://', 'https://')}/config`,
-            wsUrl: `${baseUrl.replace('http://', 'ws://').replace('https://', 'wss://')}/ws`,
-        };
+    /**
+     * Initialize the client by loading credentials from config
+     * This is called automatically before the first API request
+     */
+    async initialize() {
+        if (this.initialized)
+            return;
+        // If already initializing, wait for it
+        if (this.initPromise) {
+            await this.initPromise;
+            return;
+        }
+        this.initPromise = this.doInitialize();
+        await this.initPromise;
     }
-    async setupPlatformConnection() {
-        if (!this.resolvedClientId) {
-            throw new Error('CASTARI_CLIENT_ID is required when connecting via the Castari Platform');
-        }
-        const platformUrl = (this.options.platformUrl || process.env.CASTARI_PLATFORM_URL || DEFAULT_PLATFORM_URL).replace(/\/$/, '');
-        if (this.options.debug) {
-            console.log(`🚀 Requesting sandbox from ${platformUrl}...`);
-        }
-        const response = await fetch(`${platformUrl}/sandbox/start`, {
-            method: 'POST',
-            headers: {
-                'Content-Type': 'application/json',
-                ...(this.resolvedPlatformApiKey
-                    ? { Authorization: `Bearer ${this.resolvedPlatformApiKey}` }
-                    : {}),
-            },
-            body: JSON.stringify({
-                snapshot: this.options.snapshot,
-                labels: this.options.labels,
-                volume: this.options.volume,
-                clientId: this.resolvedClientId
-            })
-        });
-        if (!response.ok) {
-            const errorText = await response.text();
-            throw new Error(`Failed to start sandbox: ${errorText}`);
-        }
-        const { id, url, proxyUrl, authHeaders, authParams } = await response.json();
-        this.sandboxId = id;
-        // Default to proxy mode (true) unless explicitly disabled
-        const useProxy = this.options.useProxy ?? (process.env.CASTARI_USE_PROXY !== 'false');
-        if (this.options.debug) {
-            console.log(`✅ Sandbox started: ${id} at ${url}`);
-            if (useProxy && proxyUrl) {
-                console.log(`🔀 Using proxy mode via ${proxyUrl}`);
+    async doInitialize() {
+        // Load auth from config if not provided
+        if (!this.options.apiKey && !this.options.token) {
+            const auth = await getAuth();
+            if (auth) {
+                this.httpClient.setAuth(auth.type, auth.value);
             }
         }
-        // If proxy mode is enabled and we have a proxy URL, use it
-        if (useProxy && proxyUrl) {
-            // Proxy mode: connect through platform API
-            const proxyConfigUrl = `${platformUrl}/proxy/${id}/config`;
-            const proxyWsUrl = proxyUrl;
-            return {
-                configUrl: proxyConfigUrl,
-                wsUrl: proxyWsUrl,
-                // No auth headers/params needed - proxy handles sandbox auth
-                cleanup: async () => {
-                    await this.stop({ delete: true });
-                }
-            };
-        }
-        // Direct mode: connect to sandbox directly
-        const baseUrl = url.replace(/\/$/, '');
-        const configUrl = `${baseUrl.replace('ws://', 'http://').replace('wss://', 'https://')}/config`;
-        const wsUrlBase = `${baseUrl.replace('https://', 'wss://').replace('http://', 'ws://')}/ws`;
-        return {
-            configUrl,
-            wsUrl: wsUrlBase,
-            authHeaders,
-            authParams,
-            cleanup: async () => {
-                await this.stop({ delete: true });
-            }
-        };
-    }
-    handleMessage(message) {
-        if (this.options.debug) {
-            console.log('📨 Received message:', JSON.stringify(message, null, 2));
-        }
-        this.messageHandlers.forEach(handler => handler(message));
+        this.initialized = true;
     }
-    onMessage(handler) {
-        this.messageHandlers.push(handler);
-        return () => {
-            this.messageHandlers = this.messageHandlers.filter(h => h !== handler);
-        };
-    }
-    send(message) {
-        if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
-            throw new Error('WebSocket is not connected');
-        }
-        this.ws.send(JSON.stringify(message));
-    }
-    async stop(options = { delete: true }) {
-        if (this.ws) {
-            this.ws.close();
-        }
-        if (this.sandboxId) {
-            const platformUrl = (this.options.platformUrl || process.env.CASTARI_PLATFORM_URL || DEFAULT_PLATFORM_URL).replace(/\/$/, '');
-            try {
-                const clientId = this.resolvedClientId || this.options.clientId || process.env.CASTARI_CLIENT_ID;
-                const apiKey = this.resolvedPlatformApiKey || this.options.platformApiKey || process.env.CASTARI_API_KEY;
-                const response = await fetch(`${platformUrl}/sandbox/stop`, {
-                    method: 'POST',
-                    headers: {
-                        'Content-Type': 'application/json',
-                        ...(apiKey ? { Authorization: `Bearer ${apiKey}` } : {}),
-                    },
-                    body: JSON.stringify({
-                        sandboxId: this.sandboxId,
-                        delete: options.delete,
-                        clientId
-                    })
-                });
-                if (!response.ok) {
-                    console.error(`Failed to stop sandbox: ${await response.text()}`);
-                }
-                else if (this.options.debug) {
-                    console.log(`🛑 Sandbox ${options.delete ? 'deleted' : 'stopped'}`);
-                }
-            }
-            catch (err) {
-                console.error('Failed to call stop endpoint:', err);
-            }
+    /**
+     * Ensure the client is initialized before making requests
+     * @throws AuthenticationError if no credentials are available
+     */
+    async ensureAuthenticated() {
+        await this.initialize();
+        const auth = await getAuth();
+        if (!auth && !this.options.apiKey && !this.options.token) {
+            throw new AuthenticationError();
         }
     }
 }
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Credentials stored in ~/.castari/credentials.yaml
+ */
+export interface Credentials {
+    token?: string;
+    api_key?: string;
+}
+/**
+ * Config stored in ~/.castari/config.yaml
+ */
+export interface Config {
+    api_url?: string;
+}
+/**
+ * Load credentials from ~/.castari/credentials.yaml
+ */
+export declare function loadCredentials(): Promise<Credentials>;
+/**
+ * Save credentials to ~/.castari/credentials.yaml
+ * File is created with mode 0600 for security
+ */
+export declare function saveCredentials(credentials: Credentials): Promise<void>;
+/**
+ * Clear all stored credentials
+ */
+export declare function clearCredentials(): Promise<void>;
+/**
+ * Load config from ~/.castari/config.yaml
+ */
+export declare function loadConfig(): Promise<Config>;
+/**
+ * Save config to ~/.castari/config.yaml
+ */
+export declare function saveConfig(config: Config): Promise<void>;
+/**
+ * Get the API URL from config, env var, or default
+ */
+export declare function getApiUrl(): Promise<string>;
+/**
+ * Get the auth token or API key from env vars or config
+ * Priority: CASTARI_API_KEY env var > credentials file
+ */
+export declare function getAuth(): Promise<{
+    type: 'api_key' | 'token';
+    value: string;
+} | null>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAeA;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAWD;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,WAAW,CAAC,CAO5D;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAI7E;AAED;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAMtD;AAED;;GAEG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAOlD;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI9D;AAED;;GAEG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAcjD;AAED;;;GAGG;AACH,wBAAsB,OAAO,IAAI,OAAO,CAAC;IAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAiB5F"}

package/dist/config.js

@@ -0,0 +1,108 @@
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { mkdir, readFile, writeFile, rm } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
+/** Directory for Castari config files */
+const CONFIG_DIR = join(homedir(), '.castari');
+/** Path to credentials file */
+const CREDENTIALS_FILE = join(CONFIG_DIR, 'credentials.yaml');
+/** Path to config file */
+const CONFIG_FILE = join(CONFIG_DIR, 'config.yaml');
+/**
+ * Ensure the config directory exists
+ */
+async function ensureConfigDir() {
+    if (!existsSync(CONFIG_DIR)) {
+        await mkdir(CONFIG_DIR, { recursive: true, mode: 0o700 });
+    }
+}
+/**
+ * Load credentials from ~/.castari/credentials.yaml
+ */
+export async function loadCredentials() {
+    try {
+        const content = await readFile(CREDENTIALS_FILE, 'utf-8');
+        return parseYaml(content) || {};
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Save credentials to ~/.castari/credentials.yaml
+ * File is created with mode 0600 for security
+ */
+export async function saveCredentials(credentials) {
+    await ensureConfigDir();
+    const content = stringifyYaml(credentials);
+    await writeFile(CREDENTIALS_FILE, content, { mode: 0o600 });
+}
+/**
+ * Clear all stored credentials
+ */
+export async function clearCredentials() {
+    try {
+        await rm(CREDENTIALS_FILE);
+    }
+    catch {
+        // File doesn't exist, that's fine
+    }
+}
+/**
+ * Load config from ~/.castari/config.yaml
+ */
+export async function loadConfig() {
+    try {
+        const content = await readFile(CONFIG_FILE, 'utf-8');
+        return parseYaml(content) || {};
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Save config to ~/.castari/config.yaml
+ */
+export async function saveConfig(config) {
+    await ensureConfigDir();
+    const content = stringifyYaml(config);
+    await writeFile(CONFIG_FILE, content, { mode: 0o644 });
+}
+/**
+ * Get the API URL from config, env var, or default
+ */
+export async function getApiUrl() {
+    // Check env var first
+    if (process.env.CASTARI_API_URL) {
+        return process.env.CASTARI_API_URL;
+    }
+    // Check config file
+    const config = await loadConfig();
+    if (config.api_url) {
+        return config.api_url;
+    }
+    // Default
+    return 'https://web-13239-04c55b73-wp4aqyqk.onporter.run';
+}
+/**
+ * Get the auth token or API key from env vars or config
+ * Priority: CASTARI_API_KEY env var > credentials file
+ */
+export async function getAuth() {
+    // Check env var first (for CI/CD)
+    const apiKey = process.env.CASTARI_API_KEY;
+    if (apiKey) {
+        return { type: 'api_key', value: apiKey };
+    }
+    // Check credentials file
+    const credentials = await loadCredentials();
+    if (credentials.api_key) {
+        return { type: 'api_key', value: credentials.api_key };
+    }
+    if (credentials.token) {
+        return { type: 'token', value: credentials.token };
+    }
+    return null;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Base error class for all Castari SDK errors
+ */
+export declare class CastariError extends Error {
+    /** Error code from the API */
+    code?: string;
+    /** HTTP status code */
+    statusCode?: number;
+    constructor(message: string, options?: {
+        code?: string;
+        statusCode?: number;
+    });
+}
+/**
+ * Error thrown when authentication fails or is missing
+ */
+export declare class AuthenticationError extends CastariError {
+    constructor(message?: string);
+}
+/**
+ * Error thrown when a resource is not found
+ */
+export declare class NotFoundError extends CastariError {
+    constructor(message?: string);
+}
+/**
+ * Error thrown when request validation fails
+ */
+export declare class ValidationError extends CastariError {
+    constructor(message?: string);
+}
+/**
+ * Error thrown when rate limit is exceeded
+ */
+export declare class RateLimitError extends CastariError {
+    /** Seconds to wait before retrying */
+    retryAfter?: number;
+    constructor(message?: string, retryAfter?: number);
+}
+/**
+ * Error thrown when the API returns a bad request
+ */
+export declare class BadRequestError extends CastariError {
+    constructor(message?: string);
+}
+/**
+ * Error thrown for server-side errors
+ */
+export declare class ServerError extends CastariError {
+    constructor(message?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;gBAER,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;CAM9E;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,YAAY;gBACvC,OAAO,SAA+D;CAInF;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,YAAY;gBACjC,OAAO,SAAwB;CAI5C;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,YAAY;gBACnC,OAAO,SAAsB;CAI1C;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,YAAY;IAC9C,sCAAsC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;gBAER,OAAO,SAAyB,EAAE,UAAU,CAAC,EAAE,MAAM;CAKlE;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,YAAY;gBACnC,OAAO,SAAiB;CAIrC;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,YAAY;gBAC/B,OAAO,SAA0C;CAI9D"}

package/dist/errors.js

@@ -0,0 +1,73 @@
+/**
+ * Base error class for all Castari SDK errors
+ */
+export class CastariError extends Error {
+    /** Error code from the API */
+    code;
+    /** HTTP status code */
+    statusCode;
+    constructor(message, options) {
+        super(message);
+        this.name = 'CastariError';
+        this.code = options?.code;
+        this.statusCode = options?.statusCode;
+    }
+}
+/**
+ * Error thrown when authentication fails or is missing
+ */
+export class AuthenticationError extends CastariError {
+    constructor(message = 'Authentication failed. Run \'cast login\' to authenticate.') {
+        super(message, { statusCode: 401 });
+        this.name = 'AuthenticationError';
+    }
+}
+/**
+ * Error thrown when a resource is not found
+ */
+export class NotFoundError extends CastariError {
+    constructor(message = 'Resource not found.') {
+        super(message, { statusCode: 404 });
+        this.name = 'NotFoundError';
+    }
+}
+/**
+ * Error thrown when request validation fails
+ */
+export class ValidationError extends CastariError {
+    constructor(message = 'Validation error.') {
+        super(message, { statusCode: 422 });
+        this.name = 'ValidationError';
+    }
+}
+/**
+ * Error thrown when rate limit is exceeded
+ */
+export class RateLimitError extends CastariError {
+    /** Seconds to wait before retrying */
+    retryAfter;
+    constructor(message = 'Rate limit exceeded.', retryAfter) {
+        super(message, { statusCode: 429 });
+        this.name = 'RateLimitError';
+        this.retryAfter = retryAfter;
+    }
+}
+/**
+ * Error thrown when the API returns a bad request
+ */
+export class BadRequestError extends CastariError {
+    constructor(message = 'Bad request.') {
+        super(message, { statusCode: 400 });
+        this.name = 'BadRequestError';
+    }
+}
+/**
+ * Error thrown for server-side errors
+ */
+export class ServerError extends CastariError {
+    constructor(message = 'Server error. Please try again later.') {
+        super(message, { statusCode: 500 });
+        this.name = 'ServerError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC,8BAA8B;IAC9B,IAAI,CAAU;IACd,uBAAuB;IACvB,UAAU,CAAU;IAEpB,YAAY,OAAe,EAAE,OAAgD;QAC3E,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,OAAO,EAAE,IAAI,CAAC;QAC1B,IAAI,CAAC,UAAU,GAAG,OAAO,EAAE,UAAU,CAAC;IACxC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,YAAY;IACnD,YAAY,OAAO,GAAG,4DAA4D;QAChF,KAAK,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,YAAY;IAC7C,YAAY,OAAO,GAAG,qBAAqB;QACzC,KAAK,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,YAAY;IAC/C,YAAY,OAAO,GAAG,mBAAmB;QACvC,KAAK,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,YAAY;IAC9C,sCAAsC;IACtC,UAAU,CAAU;IAEpB,YAAY,OAAO,GAAG,sBAAsB,EAAE,UAAmB;QAC/D,KAAK,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,YAAY;IAC/C,YAAY,OAAO,GAAG,cAAc;QAClC,KAAK,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,YAAY;IAC3C,YAAY,OAAO,GAAG,uCAAuC;QAC3D,KAAK,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF"}

package/dist/http.d.ts

@@ -0,0 +1,32 @@
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+export interface HttpClientOptions {
+    baseUrl: string;
+    authType?: 'api_key' | 'token';
+    authValue?: string;
+}
+/**
+ * HTTP client for making API requests
+ */
+export declare class HttpClient {
+    private baseUrl;
+    private authType?;
+    private authValue?;
+    constructor(options: HttpClientOptions);
+    /**
+     * Set authentication credentials
+     */
+    setAuth(type: 'api_key' | 'token', value: string): void;
+    /**
+     * Make an HTTP request to the API
+     */
+    request<T>(method: HttpMethod, path: string, options?: {
+        body?: unknown;
+        query?: Record<string, string | number | undefined>;
+        timeout?: number;
+    }): Promise<T>;
+    /**
+     * Handle HTTP error responses
+     */
+    private handleError;
+}
+//# sourceMappingURL=http.d.ts.map