@compresr/sdk 1.0.0

package/dist/esm/config/constants.d.ts

@@ -0,0 +1,61 @@
+/**
+ * SDK configuration constants
+ */
+/** API key prefix for validation */
+export declare const API_KEY_PREFIX = "cmp_";
+/** Default base URL for Compresr API */
+export declare const DEFAULT_BASE_URL = "https://api.compresr.ai";
+/** Default request timeout in milliseconds */
+export declare const DEFAULT_TIMEOUT = 60000;
+/** Stream request timeout in milliseconds */
+export declare const STREAM_TIMEOUT = 300000;
+/**
+ * Available compression and search models
+ */
+export declare const MODELS: {
+    readonly ESPRESSO: "espresso_v1";
+    readonly LATTE: "latte_v1";
+    readonly MACCHIATO: "macchiato_v1";
+    readonly AGENTIC_HISTORY_LINGUA: "agentic_history_lingua";
+    readonly AGENTIC_TOOL_OUTPUT_GEMFILTER: "agentic_tool_output_gemfilter";
+    readonly AGENTIC_TOOL_OUTPUT_LINGUA: "agentic_tool_output_lingua";
+    readonly AGENTIC_TOOL_DISCOVERY_SAT: "agentic_tool_discovery_sat";
+};
+export type CompressionModel = typeof MODELS.ESPRESSO | typeof MODELS.LATTE;
+export type SearchModel = typeof MODELS.MACCHIATO;
+export type Model = (typeof MODELS)[keyof typeof MODELS];
+/** Models allowed for CompressionClient */
+export declare const ALLOWED_COMPRESSION_MODELS: ReadonlySet<string>;
+/** Models allowed for SearchClient */
+export declare const ALLOWED_SEARCH_MODELS: ReadonlySet<string>;
+/** Models that require a query parameter */
+export declare const QUERY_REQUIRED_MODELS: ReadonlySet<string>;
+/** Models that support coarse parameter */
+export declare const COARSE_SUPPORTED_MODELS: ReadonlySet<string>;
+/** Models that use the agnostic endpoint */
+export declare const AGNOSTIC_ENDPOINT_MODELS: ReadonlySet<string>;
+/** Models that use the query-specific endpoint */
+export declare const QS_ENDPOINT_MODELS: ReadonlySet<string>;
+/**
+ * HTTP header names
+ */
+export declare const HEADERS: {
+    readonly API_KEY: "X-API-Key";
+    readonly CONTENT_TYPE: "Content-Type";
+    readonly ACCEPT: "Accept";
+    readonly USER_AGENT: "User-Agent";
+};
+/**
+ * HTTP status codes for error handling
+ */
+export declare const STATUS_CODES: {
+    readonly OK: 200;
+    readonly BAD_REQUEST: 400;
+    readonly UNAUTHORIZED: 401;
+    readonly FORBIDDEN: 403;
+    readonly NOT_FOUND: 404;
+    readonly VALIDATION_ERROR: 422;
+    readonly RATE_LIMITED: 429;
+    readonly SERVER_ERROR: 500;
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/esm/config/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/config/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oCAAoC;AACpC,eAAO,MAAM,cAAc,SAAS,CAAC;AAErC,wCAAwC;AACxC,eAAO,MAAM,gBAAgB,4BAA4B,CAAC;AAE1D,8CAA8C;AAC9C,eAAO,MAAM,eAAe,QAAS,CAAC;AAEtC,6CAA6C;AAC7C,eAAO,MAAM,cAAc,SAAU,CAAC;AAEtC;;GAEG;AACH,eAAO,MAAM,MAAM;;;;;;;;CAaT,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,OAAO,MAAM,CAAC,QAAQ,GAAG,OAAO,MAAM,CAAC,KAAK,CAAC;AAC5E,MAAM,MAAM,WAAW,GAAG,OAAO,MAAM,CAAC,SAAS,CAAC;AAClD,MAAM,MAAM,KAAK,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,OAAO,MAAM,CAAC,CAAC;AAEzD,2CAA2C;AAC3C,eAAO,MAAM,0BAA0B,EAAE,WAAW,CAAC,MAAM,CAGzD,CAAC;AAEH,sCAAsC;AACtC,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAAC,MAAM,CAEpD,CAAC;AAEH,4CAA4C;AAC5C,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAAC,MAAM,CAEpD,CAAC;AAEH,2CAA2C;AAC3C,eAAO,MAAM,uBAAuB,EAAE,WAAW,CAAC,MAAM,CAEtD,CAAC;AAEH,4CAA4C;AAC5C,eAAO,MAAM,wBAAwB,EAAE,WAAW,CAAC,MAAM,CAEvD,CAAC;AAEH,kDAAkD;AAClD,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,MAAM,CAEjD,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,OAAO;;;;;CAKV,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;CASf,CAAC"}

package/dist/esm/config/constants.js

@@ -0,0 +1,74 @@
+/**
+ * SDK configuration constants
+ */
+/** API key prefix for validation */
+export const API_KEY_PREFIX = 'cmp_';
+/** Default base URL for Compresr API */
+export const DEFAULT_BASE_URL = 'https://api.compresr.ai';
+/** Default request timeout in milliseconds */
+export const DEFAULT_TIMEOUT = 60_000;
+/** Stream request timeout in milliseconds */
+export const STREAM_TIMEOUT = 300_000;
+/**
+ * Available compression and search models
+ */
+export const MODELS = {
+    // Compression models
+    ESPRESSO: 'espresso_v1',
+    LATTE: 'latte_v1',
+    // Search models
+    MACCHIATO: 'macchiato_v1',
+    // Agentic models
+    AGENTIC_HISTORY_LINGUA: 'agentic_history_lingua',
+    AGENTIC_TOOL_OUTPUT_GEMFILTER: 'agentic_tool_output_gemfilter',
+    AGENTIC_TOOL_OUTPUT_LINGUA: 'agentic_tool_output_lingua',
+    AGENTIC_TOOL_DISCOVERY_SAT: 'agentic_tool_discovery_sat',
+};
+/** Models allowed for CompressionClient */
+export const ALLOWED_COMPRESSION_MODELS = new Set([
+    MODELS.ESPRESSO,
+    MODELS.LATTE,
+]);
+/** Models allowed for SearchClient */
+export const ALLOWED_SEARCH_MODELS = new Set([
+    MODELS.MACCHIATO,
+]);
+/** Models that require a query parameter */
+export const QUERY_REQUIRED_MODELS = new Set([
+    MODELS.LATTE,
+]);
+/** Models that support coarse parameter */
+export const COARSE_SUPPORTED_MODELS = new Set([
+    MODELS.LATTE,
+]);
+/** Models that use the agnostic endpoint */
+export const AGNOSTIC_ENDPOINT_MODELS = new Set([
+    MODELS.ESPRESSO,
+]);
+/** Models that use the query-specific endpoint */
+export const QS_ENDPOINT_MODELS = new Set([
+    MODELS.LATTE,
+]);
+/**
+ * HTTP header names
+ */
+export const HEADERS = {
+    API_KEY: 'X-API-Key',
+    CONTENT_TYPE: 'Content-Type',
+    ACCEPT: 'Accept',
+    USER_AGENT: 'User-Agent',
+};
+/**
+ * HTTP status codes for error handling
+ */
+export const STATUS_CODES = {
+    OK: 200,
+    BAD_REQUEST: 400,
+    UNAUTHORIZED: 401,
+    FORBIDDEN: 403,
+    NOT_FOUND: 404,
+    VALIDATION_ERROR: 422,
+    RATE_LIMITED: 429,
+    SERVER_ERROR: 500,
+};
+//# sourceMappingURL=constants.js.map

package/dist/esm/config/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/config/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oCAAoC;AACpC,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC;AAErC,wCAAwC;AACxC,MAAM,CAAC,MAAM,gBAAgB,GAAG,yBAAyB,CAAC;AAE1D,8CAA8C;AAC9C,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC;AAEtC,6CAA6C;AAC7C,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AAEtC;;GAEG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,qBAAqB;IACrB,QAAQ,EAAE,aAAa;IACvB,KAAK,EAAE,UAAU;IAEjB,gBAAgB;IAChB,SAAS,EAAE,cAAc;IAEzB,iBAAiB;IACjB,sBAAsB,EAAE,wBAAwB;IAChD,6BAA6B,EAAE,+BAA+B;IAC9D,0BAA0B,EAAE,4BAA4B;IACxD,0BAA0B,EAAE,4BAA4B;CAChD,CAAC;AAMX,2CAA2C;AAC3C,MAAM,CAAC,MAAM,0BAA0B,GAAwB,IAAI,GAAG,CAAC;IACrE,MAAM,CAAC,QAAQ;IACf,MAAM,CAAC,KAAK;CACb,CAAC,CAAC;AAEH,sCAAsC;AACtC,MAAM,CAAC,MAAM,qBAAqB,GAAwB,IAAI,GAAG,CAAC;IAChE,MAAM,CAAC,SAAS;CACjB,CAAC,CAAC;AAEH,4CAA4C;AAC5C,MAAM,CAAC,MAAM,qBAAqB,GAAwB,IAAI,GAAG,CAAC;IAChE,MAAM,CAAC,KAAK;CACb,CAAC,CAAC;AAEH,2CAA2C;AAC3C,MAAM,CAAC,MAAM,uBAAuB,GAAwB,IAAI,GAAG,CAAC;IAClE,MAAM,CAAC,KAAK;CACb,CAAC,CAAC;AAEH,4CAA4C;AAC5C,MAAM,CAAC,MAAM,wBAAwB,GAAwB,IAAI,GAAG,CAAC;IACnE,MAAM,CAAC,QAAQ;CAChB,CAAC,CAAC;AAEH,kDAAkD;AAClD,MAAM,CAAC,MAAM,kBAAkB,GAAwB,IAAI,GAAG,CAAC;IAC7D,MAAM,CAAC,KAAK;CACb,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,OAAO,EAAE,WAAW;IACpB,YAAY,EAAE,cAAc;IAC5B,MAAM,EAAE,QAAQ;IAChB,UAAU,EAAE,YAAY;CAChB,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,EAAE,EAAE,GAAG;IACP,WAAW,EAAE,GAAG;IAChB,YAAY,EAAE,GAAG;IACjB,SAAS,EAAE,GAAG;IACd,SAAS,EAAE,GAAG;IACd,gBAAgB,EAAE,GAAG;IACrB,YAAY,EAAE,GAAG;IACjB,YAAY,EAAE,GAAG;CACT,CAAC"}

package/dist/esm/config/endpoints.d.ts

@@ -0,0 +1,18 @@
+/**
+ * API endpoint constants
+ */
+export declare const ENDPOINTS: {
+    readonly COMPRESS_AGNOSTIC: "/api/compress/question-agnostic/";
+    readonly COMPRESS_AGNOSTIC_STREAM: "/api/compress/question-agnostic/stream";
+    readonly COMPRESS_QS: "/api/compress/question-specific/";
+    readonly COMPRESS_QS_STREAM: "/api/compress/question-specific/stream";
+    readonly COMPRESS_QS_BATCH: "/api/compress/question-specific/batch";
+    readonly SEARCH: "/api/compress/search/";
+    readonly SEARCH_STREAM: "/api/compress/search/stream";
+    readonly SEARCH_INDEX_CREATE: "/api/compress/search/indexes/{indexName}";
+    readonly SEARCH_INDEX_TASK: "/api/compress/search/indexes/tasks/{taskId}";
+    readonly SEARCH_INDEX_DELETE: "/api/compress/search/indexes/{indexName}";
+    readonly SEARCH_HEALTH: "/api/compress/search/health";
+};
+export type Endpoint = (typeof ENDPOINTS)[keyof typeof ENDPOINTS];
+//# sourceMappingURL=endpoints.d.ts.map

package/dist/esm/config/endpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoints.d.ts","sourceRoot":"","sources":["../../../src/config/endpoints.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;CAqBZ,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC"}

package/dist/esm/config/endpoints.js

@@ -0,0 +1,22 @@
+/**
+ * API endpoint constants
+ */
+export const ENDPOINTS = {
+    // Agnostic compression (no query required)
+    COMPRESS_AGNOSTIC: '/api/compress/question-agnostic/',
+    COMPRESS_AGNOSTIC_STREAM: '/api/compress/question-agnostic/stream',
+    // Query-specific compression (query required)
+    COMPRESS_QS: '/api/compress/question-specific/',
+    COMPRESS_QS_STREAM: '/api/compress/question-specific/stream',
+    COMPRESS_QS_BATCH: '/api/compress/question-specific/batch',
+    // Agentic search
+    SEARCH: '/api/compress/search/',
+    SEARCH_STREAM: '/api/compress/search/stream',
+    // Index management
+    SEARCH_INDEX_CREATE: '/api/compress/search/indexes/{indexName}',
+    SEARCH_INDEX_TASK: '/api/compress/search/indexes/tasks/{taskId}',
+    SEARCH_INDEX_DELETE: '/api/compress/search/indexes/{indexName}',
+    // Health
+    SEARCH_HEALTH: '/api/compress/search/health',
+};
+//# sourceMappingURL=endpoints.js.map

package/dist/esm/config/endpoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoints.js","sourceRoot":"","sources":["../../../src/config/endpoints.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,2CAA2C;IAC3C,iBAAiB,EAAE,kCAAkC;IACrD,wBAAwB,EAAE,wCAAwC;IAElE,8CAA8C;IAC9C,WAAW,EAAE,kCAAkC;IAC/C,kBAAkB,EAAE,wCAAwC;IAC5D,iBAAiB,EAAE,uCAAuC;IAE1D,iBAAiB;IACjB,MAAM,EAAE,uBAAuB;IAC/B,aAAa,EAAE,6BAA6B;IAE5C,mBAAmB;IACnB,mBAAmB,EAAE,0CAA0C;IAC/D,iBAAiB,EAAE,6CAA6C;IAChE,mBAAmB,EAAE,0CAA0C;IAE/D,SAAS;IACT,aAAa,EAAE,6BAA6B;CACpC,CAAC"}

package/dist/esm/config/index.d.ts

@@ -0,0 +1,3 @@
+export { ENDPOINTS, type Endpoint } from './endpoints.js';
+export { API_KEY_PREFIX, DEFAULT_BASE_URL, DEFAULT_TIMEOUT, STREAM_TIMEOUT, MODELS, type CompressionModel, type SearchModel, type Model, ALLOWED_COMPRESSION_MODELS, ALLOWED_SEARCH_MODELS, QUERY_REQUIRED_MODELS, COARSE_SUPPORTED_MODELS, AGNOSTIC_ENDPOINT_MODELS, QS_ENDPOINT_MODELS, HEADERS, STATUS_CODES, } from './constants.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,MAAM,EACN,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,KAAK,EACV,0BAA0B,EAC1B,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,kBAAkB,EAClB,OAAO,EACP,YAAY,GACb,MAAM,gBAAgB,CAAC"}

package/dist/esm/config/index.js

@@ -0,0 +1,3 @@
+export { ENDPOINTS } from './endpoints.js';
+export { API_KEY_PREFIX, DEFAULT_BASE_URL, DEFAULT_TIMEOUT, STREAM_TIMEOUT, MODELS, ALLOWED_COMPRESSION_MODELS, ALLOWED_SEARCH_MODELS, QUERY_REQUIRED_MODELS, COARSE_SUPPORTED_MODELS, AGNOSTIC_ENDPOINT_MODELS, QS_ENDPOINT_MODELS, HEADERS, STATUS_CODES, } from './constants.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAiB,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,MAAM,EAIN,0BAA0B,EAC1B,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,kBAAkB,EAClB,OAAO,EACP,YAAY,GACb,MAAM,gBAAgB,CAAC"}

package/dist/esm/errors/exceptions.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Compresr SDK Exceptions
+ *
+ * Exception classes for API error handling, mirroring the Python SDK.
+ */
+/**
+ * Response data structure for errors
+ */
+export interface ErrorResponseData {
+    success: boolean;
+    error: string;
+    detail?: string;
+    code?: string;
+    field?: string;
+    retry_after?: number;
+}
+/**
+ * Base error class for all Compresr SDK errors
+ */
+export declare class CompresrError extends Error {
+    readonly code: string;
+    readonly responseData: ErrorResponseData;
+    constructor(message: string, code?: string, responseData?: Partial<ErrorResponseData>);
+}
+/**
+ * Invalid or missing API key
+ */
+export declare class AuthenticationError extends CompresrError {
+    constructor(message?: string, responseData?: Partial<ErrorResponseData>);
+}
+/**
+ * Request validation failed (invalid parameters, missing required fields)
+ */
+export declare class ValidationError extends CompresrError {
+    readonly field?: string;
+    constructor(message: string, field?: string, responseData?: Partial<ErrorResponseData>);
+}
+/**
+ * Rate limit exceeded - too many requests
+ */
+export declare class RateLimitError extends CompresrError {
+    readonly retryAfter?: number;
+    constructor(message: string, retryAfter?: number, responseData?: Partial<ErrorResponseData>);
+}
+/**
+ * API key lacks required permissions/scope
+ */
+export declare class ScopeError extends CompresrError {
+    readonly requiredScope?: string;
+    constructor(message: string, requiredScope?: string, responseData?: Partial<ErrorResponseData>);
+}
+/**
+ * Internal server error
+ */
+export declare class ServerError extends CompresrError {
+    constructor(message?: string, responseData?: Partial<ErrorResponseData>);
+}
+/**
+ * Connection error - failed to connect to API
+ */
+export declare class ConnectionError extends CompresrError {
+    readonly service?: string;
+    constructor(message: string, service?: string, responseData?: Partial<ErrorResponseData>);
+}
+/**
+ * Resource not found (e.g., index doesn't exist)
+ */
+export declare class NotFoundError extends CompresrError {
+    readonly resource?: string;
+    constructor(message: string, resource?: string, responseData?: Partial<ErrorResponseData>);
+}
+//# sourceMappingURL=exceptions.d.ts.map

package/dist/esm/errors/exceptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exceptions.d.ts","sourceRoot":"","sources":["../../../src/errors/exceptions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAC;gBAGvC,OAAO,EAAE,MAAM,EACf,IAAI,SAAmB,EACvB,YAAY,GAAE,OAAO,CAAC,iBAAiB,CAAM;CAQhD;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,aAAa;gBAElD,OAAO,SAA0B,EACjC,YAAY,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC;CAK5C;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,aAAa;IAChD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;gBAGtB,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC;CAM5C;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,aAAa;IAC/C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;gBAG3B,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,EACnB,YAAY,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC;CAS5C;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,aAAa;IAC3C,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;gBAG9B,OAAO,EAAE,MAAM,EACf,aAAa,CAAC,EAAE,MAAM,EACtB,YAAY,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC;CAM5C;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,aAAa;gBAE1C,OAAO,SAA0B,EACjC,YAAY,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC;CAK5C;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,aAAa;IAChD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;gBAGxB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC;CAM5C;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,aAAa;IAC9C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;gBAGzB,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC;CAM5C"}

package/dist/esm/errors/exceptions.js

@@ -0,0 +1,96 @@
+/**
+ * Compresr SDK Exceptions
+ *
+ * Exception classes for API error handling, mirroring the Python SDK.
+ */
+/**
+ * Base error class for all Compresr SDK errors
+ */
+export class CompresrError extends Error {
+    code;
+    responseData;
+    constructor(message, code = 'compresr_error', responseData = {}) {
+        super(message);
+        this.name = 'CompresrError';
+        this.code = code;
+        this.responseData = { success: false, error: message, ...responseData };
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+/**
+ * Invalid or missing API key
+ */
+export class AuthenticationError extends CompresrError {
+    constructor(message = 'Authentication failed', responseData) {
+        super(message, 'authentication_error', responseData);
+        this.name = 'AuthenticationError';
+    }
+}
+/**
+ * Request validation failed (invalid parameters, missing required fields)
+ */
+export class ValidationError extends CompresrError {
+    field;
+    constructor(message, field, responseData) {
+        super(message, 'validation_error', { ...responseData, field });
+        this.name = 'ValidationError';
+        this.field = field;
+    }
+}
+/**
+ * Rate limit exceeded - too many requests
+ */
+export class RateLimitError extends CompresrError {
+    retryAfter;
+    constructor(message, retryAfter, responseData) {
+        super(message, 'rate_limit_exceeded', {
+            ...responseData,
+            retry_after: retryAfter,
+        });
+        this.name = 'RateLimitError';
+        this.retryAfter = retryAfter;
+    }
+}
+/**
+ * API key lacks required permissions/scope
+ */
+export class ScopeError extends CompresrError {
+    requiredScope;
+    constructor(message, requiredScope, responseData) {
+        super(message, 'scope_error', responseData);
+        this.name = 'ScopeError';
+        this.requiredScope = requiredScope;
+    }
+}
+/**
+ * Internal server error
+ */
+export class ServerError extends CompresrError {
+    constructor(message = 'Internal server error', responseData) {
+        super(message, 'server_error', responseData);
+        this.name = 'ServerError';
+    }
+}
+/**
+ * Connection error - failed to connect to API
+ */
+export class ConnectionError extends CompresrError {
+    service;
+    constructor(message, service, responseData) {
+        super(message, 'connection_error', responseData);
+        this.name = 'ConnectionError';
+        this.service = service;
+    }
+}
+/**
+ * Resource not found (e.g., index doesn't exist)
+ */
+export class NotFoundError extends CompresrError {
+    resource;
+    constructor(message, resource, responseData) {
+        super(message, 'not_found', responseData);
+        this.name = 'NotFoundError';
+        this.resource = resource;
+    }
+}
+//# sourceMappingURL=exceptions.js.map

package/dist/esm/errors/exceptions.js.map

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

package/dist/esm/errors/index.d.ts

@@ -0,0 +1,2 @@
+export { type ErrorResponseData, CompresrError, AuthenticationError, ValidationError, RateLimitError, ScopeError, ServerError, ConnectionError, NotFoundError, } from './exceptions.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,iBAAiB,EACtB,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,UAAU,EACV,WAAW,EACX,eAAe,EACf,aAAa,GACd,MAAM,iBAAiB,CAAC"}

package/dist/esm/errors/index.js

@@ -0,0 +1,2 @@
+export { CompresrError, AuthenticationError, ValidationError, RateLimitError, ScopeError, ServerError, ConnectionError, NotFoundError, } from './exceptions.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,UAAU,EACV,WAAW,EACX,eAAe,EACf,aAAa,GACd,MAAM,iBAAiB,CAAC"}

package/dist/esm/http/client.d.ts

@@ -0,0 +1,53 @@
+/**
+ * HTTP client configuration options
+ */
+export interface HttpClientOptions {
+    /** API key (required) - must start with "cmp_" */
+    apiKey: string;
+    /** Base URL for API (optional, defaults to production) */
+    baseUrl?: string;
+    /** Request timeout in milliseconds (optional) */
+    timeout?: number;
+}
+/**
+ * Internal HTTP client for all Compresr API requests
+ */
+export declare class HttpClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly timeout;
+    constructor(options: HttpClientOptions);
+    /**
+     * Get default headers for requests
+     */
+    private get headers();
+    /**
+     * Build full URL from endpoint
+     */
+    private url;
+    /**
+     * Make a POST request
+     */
+    post<T>(endpoint: string, data: Record<string, unknown>): Promise<T>;
+    /**
+     * Make a GET request
+     */
+    get<T>(endpoint: string): Promise<T>;
+    /**
+     * Make a DELETE request
+     */
+    delete<T>(endpoint: string): Promise<T>;
+    /**
+     * Stream response from SSE endpoint
+     */
+    stream(endpoint: string, data: Record<string, unknown>): AsyncGenerator<string, void, undefined>;
+    /**
+     * Upload multipart form data (for index creation)
+     */
+    postMultipart<T>(endpoint: string, files: Record<string, {
+        data: Blob;
+        filename: string;
+        contentType: string;
+    }>): Promise<T>;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/http/client.ts"],"names":[],"mappings":"AAqBA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,EAAE,iBAAiB;IAgBtC;;OAEG;IACH,OAAO,KAAK,OAAO,GAOlB;IAED;;OAEG;IACH,OAAO,CAAC,GAAG;IAIX;;OAEG;IACG,IAAI,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAmC1E;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAkC1C;;OAEG;IACG,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAkC7C;;OAEG;IACI,MAAM,CACX,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC;IAyE1C;;OAEG;IACG,aAAa,CAAC,CAAC,EACnB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,IAAI,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,GAC3E,OAAO,CAAC,CAAC,CAAC;CA0Cd"}