@gibs-dev/sdk 0.1.0

package/dist/cjs/client.js

@@ -0,0 +1,328 @@
+"use strict";
+/**
+ * Gibs API client.
+ *
+ * Provides typed methods for all Gibs compliance API endpoints.
+ * Uses native `fetch` -- works in Node.js 18+, browsers, Deno, and Bun.
+ *
+ * @module client
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GibsClient = void 0;
+const errors_js_1 = require("./errors.js");
+const VERSION = '0.1.0';
+const DEFAULT_BASE_URL = 'https://api.gibs.dev';
+const DEFAULT_TIMEOUT_MS = 120_000;
+const DEFAULT_MAX_RETRIES = 3;
+/** Initial delay for exponential backoff, in milliseconds. */
+const INITIAL_RETRY_DELAY_MS = 500;
+/** Maximum delay between retries, in milliseconds. */
+const MAX_RETRY_DELAY_MS = 30_000;
+/** HTTP status codes that are safe to retry. */
+const RETRYABLE_STATUS_CODES = new Set([408, 429, 500, 502, 503, 504]);
+/**
+ * Official client for the Gibs multi-regulation compliance API.
+ *
+ * @example
+ * ```ts
+ * import { GibsClient } from '@gibs/sdk';
+ *
+ * const client = new GibsClient({ apiKey: 'gbs_live_xxx' });
+ *
+ * const result = await client.classify({
+ *   description: 'Facial recognition system for airport security',
+ * });
+ * console.log(result.risk_level);
+ * ```
+ */
+class GibsClient {
+    apiKey;
+    baseUrl;
+    timeout;
+    maxRetries;
+    constructor(options) {
+        if (!options.apiKey) {
+            throw new Error('API key is required. Get one at https://gibs.dev');
+        }
+        this.apiKey = options.apiKey;
+        this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, '');
+        this.timeout = options.timeout ?? DEFAULT_TIMEOUT_MS;
+        this.maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;
+    }
+    // ==========================================================================
+    // Public API Methods
+    // ==========================================================================
+    /**
+     * Classify an AI system under EU AI Act risk levels.
+     *
+     * Returns the risk classification, relevant obligations,
+     * and source citations from the legal corpus.
+     *
+     * @param request - Description of the AI system to classify.
+     * @returns Classification result with risk level and obligations.
+     *
+     * @example
+     * ```ts
+     * const result = await client.classify({
+     *   description: 'CV screening tool that ranks job applicants',
+     *   sector: 'employment',
+     *   data_types: ['biometric'],
+     * });
+     *
+     * console.log(result.risk_level);    // "high"
+     * console.log(result.obligations);   // [{id: "risk_mgmt", ...}, ...]
+     * ```
+     */
+    async classify(request) {
+        return this._request('POST', '/v1/classify', request);
+    }
+    /**
+     * Ask a compliance question and get a grounded answer with citations.
+     *
+     * Every claim in the answer is traceable to a specific article
+     * in the legal corpus. If the corpus doesn't cover the question,
+     * the response indicates abstention with a reason.
+     *
+     * @param request - The compliance question and optional context.
+     * @returns Answer with source citations and confidence level.
+     *
+     * @example
+     * ```ts
+     * const answer = await client.check({
+     *   question: 'What are the transparency requirements for chatbots under the AI Act?',
+     *   regulation: 'ai_act',
+     * });
+     *
+     * console.log(answer.answer);
+     * console.log(answer.sources);
+     * ```
+     */
+    async check(request) {
+        return this._request('POST', '/v1/check', request);
+    }
+    /**
+     * Check API health and component status.
+     *
+     * Does not require authentication.
+     *
+     * @returns Health status with component details.
+     *
+     * @example
+     * ```ts
+     * const health = await client.health();
+     * console.log(health.status);        // "healthy"
+     * console.log(health.components);    // {api: "healthy", qdrant: "healthy", ...}
+     * ```
+     */
+    async health() {
+        return this._request('GET', '/v1/health');
+    }
+    /**
+     * List all active API keys for your organization.
+     *
+     * Returns metadata only -- never includes the full key value.
+     *
+     * @returns Array of key metadata.
+     */
+    async listKeys() {
+        return this._request('GET', '/v1/account/keys');
+    }
+    /**
+     * Create a new API key for your organization.
+     *
+     * The full key value is returned exactly once in the response.
+     * Store it securely -- it cannot be retrieved again.
+     *
+     * Maximum 5 active keys per organization.
+     *
+     * @param request - Optional name for the key.
+     * @returns The created key including the full key value (shown once).
+     */
+    async createKey(request) {
+        return this._request('POST', '/v1/account/keys', request);
+    }
+    /**
+     * Revoke an API key.
+     *
+     * The key must belong to your organization. You cannot revoke
+     * the key that is currently being used for authentication.
+     *
+     * @param keyId - Database ID of the key to revoke.
+     * @returns Confirmation with status "revoked".
+     */
+    async deleteKey(keyId) {
+        return this._request('DELETE', `/v1/account/keys/${keyId}`);
+    }
+    // ==========================================================================
+    // Internal HTTP Layer
+    // ==========================================================================
+    /**
+     * Execute an HTTP request with retries, timeout, and error handling.
+     */
+    async _request(method, path, body) {
+        const url = `${this.baseUrl}${path}`;
+        const headers = {
+            'Authorization': `Bearer ${this.apiKey}`,
+            'Content-Type': 'application/json',
+            'User-Agent': `gibs-sdk-js/${VERSION}`,
+            'Accept': 'application/json',
+        };
+        let lastError = null;
+        for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+            // Wait before retrying (skip delay on first attempt)
+            if (attempt > 0) {
+                const delay = this._retryDelay(attempt, lastError);
+                await this._sleep(delay);
+            }
+            try {
+                const response = await this._fetchWithTimeout(url, {
+                    method,
+                    headers,
+                    body: body !== undefined ? JSON.stringify(body) : undefined,
+                });
+                // Success -- parse and return
+                if (response.ok) {
+                    return (await response.json());
+                }
+                // Parse error response
+                const responseHeaders = this._extractHeaders(response);
+                let errorMessage;
+                try {
+                    const errorBody = await response.json();
+                    errorMessage = errorBody.detail ?? `HTTP ${response.status}`;
+                }
+                catch {
+                    errorMessage = `HTTP ${response.status}: ${response.statusText}`;
+                }
+                // Build the appropriate error
+                const error = this._buildError(response.status, errorMessage, responseHeaders);
+                // Don't retry non-retryable errors
+                if (!RETRYABLE_STATUS_CODES.has(response.status)) {
+                    throw error;
+                }
+                lastError = error;
+            }
+            catch (err) {
+                // If it's already one of our errors (non-retryable), rethrow
+                if (err instanceof errors_js_1.GibsAuthError) {
+                    throw err;
+                }
+                if (err instanceof errors_js_1.GibsAPIError && !RETRYABLE_STATUS_CODES.has(err.status)) {
+                    throw err;
+                }
+                // Timeout
+                if (err instanceof errors_js_1.GibsTimeoutError) {
+                    lastError = err;
+                    continue;
+                }
+                // Network errors
+                if (this._isNetworkError(err)) {
+                    lastError = new errors_js_1.GibsConnectionError(`Connection failed: ${err instanceof Error ? err.message : String(err)}`);
+                    continue;
+                }
+                // Already a GibsError (retryable API error), keep retrying
+                if (err instanceof errors_js_1.GibsAPIError) {
+                    lastError = err;
+                    continue;
+                }
+                // Unknown error -- don't retry
+                throw err;
+            }
+        }
+        // All retries exhausted
+        throw lastError ?? new errors_js_1.GibsConnectionError('Request failed after all retries');
+    }
+    /**
+     * Fetch with an AbortController-based timeout.
+     */
+    async _fetchWithTimeout(url, init) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await fetch(url, {
+                ...init,
+                signal: controller.signal,
+            });
+            return response;
+        }
+        catch (err) {
+            if (err instanceof DOMException && err.name === 'AbortError') {
+                throw new errors_js_1.GibsTimeoutError(this.timeout);
+            }
+            // Node.js uses a different error type for abort
+            if (err instanceof Error && err.name === 'AbortError') {
+                throw new errors_js_1.GibsTimeoutError(this.timeout);
+            }
+            throw err;
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    /**
+     * Build the correct error class for a given HTTP status code.
+     */
+    _buildError(status, message, headers) {
+        switch (status) {
+            case 401:
+                return new errors_js_1.GibsAuthError(message, headers);
+            case 429:
+                return new errors_js_1.GibsRateLimitError(message, headers);
+            default:
+                return new errors_js_1.GibsAPIError(message, status, headers);
+        }
+    }
+    /**
+     * Calculate retry delay with exponential backoff and jitter.
+     *
+     * For rate limit errors, respects the Retry-After header.
+     */
+    _retryDelay(attempt, lastError) {
+        // Respect Retry-After header for rate limit errors
+        if (lastError instanceof errors_js_1.GibsRateLimitError && lastError.retryAfter) {
+            return lastError.retryAfter * 1000;
+        }
+        // Exponential backoff: 500ms, 1000ms, 2000ms, ...
+        const exponentialDelay = INITIAL_RETRY_DELAY_MS * Math.pow(2, attempt - 1);
+        // Add jitter (0-25% of the delay)
+        const jitter = exponentialDelay * 0.25 * Math.random();
+        return Math.min(exponentialDelay + jitter, MAX_RETRY_DELAY_MS);
+    }
+    /**
+     * Extract response headers into a plain object.
+     */
+    _extractHeaders(response) {
+        const headers = {};
+        response.headers.forEach((value, key) => {
+            headers[key.toLowerCase()] = value;
+        });
+        return headers;
+    }
+    /**
+     * Check if an error is a network-level error (no HTTP response received).
+     */
+    _isNetworkError(err) {
+        if (!(err instanceof Error))
+            return false;
+        // Common network error indicators
+        const networkMessages = [
+            'fetch failed',
+            'network',
+            'ECONNREFUSED',
+            'ECONNRESET',
+            'ENOTFOUND',
+            'ETIMEDOUT',
+            'EAI_AGAIN',
+        ];
+        const msg = err.message.toLowerCase();
+        return networkMessages.some((indicator) => msg.includes(indicator.toLowerCase()));
+    }
+    /**
+     * Sleep for a given number of milliseconds.
+     */
+    _sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+exports.GibsClient = GibsClient;
+//# sourceMappingURL=client.js.map

package/dist/cjs/client.js.map

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

package/dist/cjs/errors.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Error classes for the Gibs SDK.
+ *
+ * All errors extend `GibsError` so consumers can catch broadly
+ * or narrowly depending on their needs.
+ *
+ * @module errors
+ */
+/**
+ * Base error for all Gibs SDK errors.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await client.classify({ description: '...' });
+ * } catch (err) {
+ *   if (err instanceof GibsError) {
+ *     console.error('Gibs API error:', err.message);
+ *   }
+ * }
+ * ```
+ */
+export declare class GibsError extends Error {
+    constructor(message: string);
+}
+/**
+ * Thrown when the API returns an HTTP error (4xx or 5xx).
+ *
+ * Contains the status code and parsed error body.
+ */
+export declare class GibsAPIError extends GibsError {
+    /** HTTP status code returned by the API. */
+    readonly status: number;
+    /** Raw response headers. */
+    readonly headers: Record<string, string>;
+    constructor(message: string, status: number, headers?: Record<string, string>);
+}
+/**
+ * Thrown on HTTP 401 responses (missing or invalid API key).
+ */
+export declare class GibsAuthError extends GibsAPIError {
+    constructor(message: string, headers?: Record<string, string>);
+}
+/**
+ * Thrown on HTTP 429 responses (rate limit exceeded).
+ *
+ * Check `retryAfter` for the server-suggested wait time.
+ */
+export declare class GibsRateLimitError extends GibsAPIError {
+    /** Seconds to wait before retrying, parsed from `Retry-After` header. */
+    readonly retryAfter: number | null;
+    constructor(message: string, headers?: Record<string, string>);
+}
+/**
+ * Thrown when a request times out.
+ */
+export declare class GibsTimeoutError extends GibsError {
+    constructor(timeoutMs: number);
+}
+/**
+ * Thrown when a request fails due to network connectivity issues.
+ */
+export declare class GibsConnectionError extends GibsError {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/cjs/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;;;;;;GAaG;AACH,qBAAa,SAAU,SAAQ,KAAK;gBACtB,OAAO,EAAE,MAAM;CAM5B;AAED;;;;GAIG;AACH,qBAAa,YAAa,SAAQ,SAAS;IACzC,4CAA4C;IAC5C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,4BAA4B;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBAE7B,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM;CAMlF;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,YAAY;gBACjC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM;CAIlE;AAED;;;;GAIG;AACH,qBAAa,kBAAmB,SAAQ,YAAY;IAClD,yEAAyE;IACzE,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;gBAEvB,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM;CAOlE;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,SAAS;gBACjC,SAAS,EAAE,MAAM;CAI9B;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,SAAS;gBACpC,OAAO,EAAE,MAAM;CAI5B"}

package/dist/cjs/errors.js

@@ -0,0 +1,99 @@
+"use strict";
+/**
+ * Error classes for the Gibs SDK.
+ *
+ * All errors extend `GibsError` so consumers can catch broadly
+ * or narrowly depending on their needs.
+ *
+ * @module errors
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GibsConnectionError = exports.GibsTimeoutError = exports.GibsRateLimitError = exports.GibsAuthError = exports.GibsAPIError = exports.GibsError = void 0;
+/**
+ * Base error for all Gibs SDK errors.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await client.classify({ description: '...' });
+ * } catch (err) {
+ *   if (err instanceof GibsError) {
+ *     console.error('Gibs API error:', err.message);
+ *   }
+ * }
+ * ```
+ */
+class GibsError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'GibsError';
+        // Maintain proper prototype chain for instanceof checks
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+exports.GibsError = GibsError;
+/**
+ * Thrown when the API returns an HTTP error (4xx or 5xx).
+ *
+ * Contains the status code and parsed error body.
+ */
+class GibsAPIError extends GibsError {
+    /** HTTP status code returned by the API. */
+    status;
+    /** Raw response headers. */
+    headers;
+    constructor(message, status, headers = {}) {
+        super(message);
+        this.name = 'GibsAPIError';
+        this.status = status;
+        this.headers = headers;
+    }
+}
+exports.GibsAPIError = GibsAPIError;
+/**
+ * Thrown on HTTP 401 responses (missing or invalid API key).
+ */
+class GibsAuthError extends GibsAPIError {
+    constructor(message, headers = {}) {
+        super(message, 401, headers);
+        this.name = 'GibsAuthError';
+    }
+}
+exports.GibsAuthError = GibsAuthError;
+/**
+ * Thrown on HTTP 429 responses (rate limit exceeded).
+ *
+ * Check `retryAfter` for the server-suggested wait time.
+ */
+class GibsRateLimitError extends GibsAPIError {
+    /** Seconds to wait before retrying, parsed from `Retry-After` header. */
+    retryAfter;
+    constructor(message, headers = {}) {
+        super(message, 429, headers);
+        this.name = 'GibsRateLimitError';
+        const retryHeader = headers['retry-after'];
+        this.retryAfter = retryHeader ? parseInt(retryHeader, 10) || null : null;
+    }
+}
+exports.GibsRateLimitError = GibsRateLimitError;
+/**
+ * Thrown when a request times out.
+ */
+class GibsTimeoutError extends GibsError {
+    constructor(timeoutMs) {
+        super(`Request timed out after ${timeoutMs}ms`);
+        this.name = 'GibsTimeoutError';
+    }
+}
+exports.GibsTimeoutError = GibsTimeoutError;
+/**
+ * Thrown when a request fails due to network connectivity issues.
+ */
+class GibsConnectionError extends GibsError {
+    constructor(message) {
+        super(message);
+        this.name = 'GibsConnectionError';
+    }
+}
+exports.GibsConnectionError = GibsConnectionError;
+//# sourceMappingURL=errors.js.map

package/dist/cjs/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAEH;;;;;;;;;;;;;GAaG;AACH,MAAa,SAAU,SAAQ,KAAK;IAClC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,wDAAwD;QACxD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAPD,8BAOC;AAED;;;;GAIG;AACH,MAAa,YAAa,SAAQ,SAAS;IACzC,4CAA4C;IACnC,MAAM,CAAS;IAExB,4BAA4B;IACnB,OAAO,CAAyB;IAEzC,YAAY,OAAe,EAAE,MAAc,EAAE,UAAkC,EAAE;QAC/E,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAbD,oCAaC;AAED;;GAEG;AACH,MAAa,aAAc,SAAQ,YAAY;IAC7C,YAAY,OAAe,EAAE,UAAkC,EAAE;QAC/D,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AALD,sCAKC;AAED;;;;GAIG;AACH,MAAa,kBAAmB,SAAQ,YAAY;IAClD,yEAAyE;IAChE,UAAU,CAAgB;IAEnC,YAAY,OAAe,EAAE,UAAkC,EAAE;QAC/D,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QAEjC,MAAM,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;QAC3C,IAAI,CAAC,UAAU,GAAG,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3E,CAAC;CACF;AAXD,gDAWC;AAED;;GAEG;AACH,MAAa,gBAAiB,SAAQ,SAAS;IAC7C,YAAY,SAAiB;QAC3B,KAAK,CAAC,2BAA2B,SAAS,IAAI,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AALD,4CAKC;AAED;;GAEG;AACH,MAAa,mBAAoB,SAAQ,SAAS;IAChD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AALD,kDAKC"}

package/dist/cjs/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Official JavaScript/TypeScript SDK for the Gibs compliance API.
+ *
+ * @example
+ * ```ts
+ * import { GibsClient } from '@gibs/sdk';
+ *
+ * const client = new GibsClient({ apiKey: 'gbs_live_xxx' });
+ *
+ * const result = await client.classify({
+ *   description: 'Facial recognition system for airport security',
+ * });
+ * console.log(result.risk_level);
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { GibsClient } from './client.js';
+export { GibsError, GibsAPIError, GibsAuthError, GibsRateLimitError, GibsTimeoutError, GibsConnectionError, } from './errors.js';
+export type { GibsClientOptions, RiskLevel, ConfidenceLevel, Regulation, SourceCitation, Obligation, KeyInfo, ClassifyRequest, ClassifyResponse, CheckRequest, CheckResponse, HealthResponse, CreateKeyRequest, KeyCreatedResponse, KeyDeletedResponse, ErrorResponseBody, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,OAAO,EACL,SAAS,EACT,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAGrB,YAAY,EAEV,iBAAiB,EAGjB,SAAS,EACT,eAAe,EACf,UAAU,EACV,cAAc,EACd,UAAU,EACV,OAAO,EAGP,eAAe,EACf,gBAAgB,EAGhB,YAAY,EACZ,aAAa,EAGb,cAAc,EAGd,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAGlB,iBAAiB,GAClB,MAAM,YAAY,CAAC"}

package/dist/cjs/index.js

@@ -0,0 +1,32 @@
+"use strict";
+/**
+ * Official JavaScript/TypeScript SDK for the Gibs compliance API.
+ *
+ * @example
+ * ```ts
+ * import { GibsClient } from '@gibs/sdk';
+ *
+ * const client = new GibsClient({ apiKey: 'gbs_live_xxx' });
+ *
+ * const result = await client.classify({
+ *   description: 'Facial recognition system for airport security',
+ * });
+ * console.log(result.risk_level);
+ * ```
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GibsConnectionError = exports.GibsTimeoutError = exports.GibsRateLimitError = exports.GibsAuthError = exports.GibsAPIError = exports.GibsError = exports.GibsClient = void 0;
+// Client
+var client_js_1 = require("./client.js");
+Object.defineProperty(exports, "GibsClient", { enumerable: true, get: function () { return client_js_1.GibsClient; } });
+// Error classes
+var errors_js_1 = require("./errors.js");
+Object.defineProperty(exports, "GibsError", { enumerable: true, get: function () { return errors_js_1.GibsError; } });
+Object.defineProperty(exports, "GibsAPIError", { enumerable: true, get: function () { return errors_js_1.GibsAPIError; } });
+Object.defineProperty(exports, "GibsAuthError", { enumerable: true, get: function () { return errors_js_1.GibsAuthError; } });
+Object.defineProperty(exports, "GibsRateLimitError", { enumerable: true, get: function () { return errors_js_1.GibsRateLimitError; } });
+Object.defineProperty(exports, "GibsTimeoutError", { enumerable: true, get: function () { return errors_js_1.GibsTimeoutError; } });
+Object.defineProperty(exports, "GibsConnectionError", { enumerable: true, get: function () { return errors_js_1.GibsConnectionError; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;;AAEH,SAAS;AACT,yCAAyC;AAAhC,uGAAA,UAAU,OAAA;AAEnB,gBAAgB;AAChB,yCAOqB;AANnB,sGAAA,SAAS,OAAA;AACT,yGAAA,YAAY,OAAA;AACZ,0GAAA,aAAa,OAAA;AACb,+GAAA,kBAAkB,OAAA;AAClB,6GAAA,gBAAgB,OAAA;AAChB,gHAAA,mBAAmB,OAAA"}

package/dist/cjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}