@dooor-ai/cortexdb 0.1.0

package/LICENSE

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

package/README.md

@@ -0,0 +1,302 @@
+# CortexDB TypeScript/JavaScript SDK
+
+Official TypeScript/JavaScript client for **CortexDB** - A powerful multi-modal RAG (Retrieval Augmented Generation) platform with advanced document processing capabilities.
+
+[![npm version](https://badge.fury.io/js/%40dooor-ai%2Fcortexdb.svg)](https://badge.fury.io/js/%40dooor-ai%2Fcortexdb)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Features
+
+- 🚀 **Simple & Intuitive API** - Easy to use, TypeScript-first design
+- 🔍 **Semantic Search** - Vector-based semantic search with embeddings
+- 📄 **Document Processing** - Advanced PDF, DOCX, XLSX processing with Docling
+- 🎯 **Type Safe** - Full TypeScript support with type definitions
+- ⚡ **Async/Await** - Modern async/await API
+- 🛡️ **Error Handling** - Comprehensive error types for better debugging
+- 🔌 **Flexible** - Works with Node.js, Deno, and modern browsers
+
+## Installation
+
+```bash
+npm install @dooor-ai/cortexdb
+# or
+yarn add @dooor-ai/cortexdb
+# or
+pnpm add @dooor-ai/cortexdb
+```
+
+## Requirements
+
+- Node.js >= 18.0.0 (uses native `fetch`)
+- CortexDB gateway running (default: `http://localhost:8000`)
+
+## Quick Start
+
+```typescript
+import { CortexClient, FieldType } from '@dooor-ai/cortexdb';
+
+async function main() {
+  // Initialize client
+  const client = new CortexClient({
+    baseUrl: 'http://localhost:8000',
+    // apiKey: 'YOUR_API_KEY', // Optional: if authentication is enabled
+  });
+
+  // Check health
+  const isHealthy = await client.healthcheck();
+  console.log('CortexDB:', isHealthy ? 'Connected ✓' : 'Disconnected ✗');
+
+  // Create a collection
+  await client.collections.create('my_docs', [
+    { name: 'title', type: FieldType.STRING },
+    { name: 'content', type: FieldType.STRING },
+  ]);
+
+  // Create a record
+  const record = await client.records.create('my_docs', {
+    title: 'Hello World',
+    content: 'This is my first document',
+  });
+
+  console.log('Created:', record.id);
+
+  // Get the record
+  const fetched = await client.records.get('my_docs', record.id);
+  console.log('Fetched:', fetched.data);
+
+  // List all records
+  const results = await client.records.list('my_docs');
+  console.log('Total:', results.total);
+
+  // Clean up
+  await client.collections.delete('my_docs');
+  await client.close();
+}
+
+main();
+```
+
+## Semantic Search Example
+
+Enable semantic search by creating a collection with `vectorize: true` and an embedding provider:
+
+```typescript
+import { CortexClient, FieldType } from '@dooor-ai/cortexdb';
+
+async function semanticSearch() {
+  const client = new CortexClient({ baseUrl: 'http://localhost:8000' });
+
+  // Create collection with vectorization
+  await client.collections.create(
+    'knowledge_base',
+    [
+      { name: 'title', type: FieldType.STRING },
+      { name: 'content', type: FieldType.STRING, vectorize: true },
+    ],
+    'your-embedding-provider-id' // Required for vectorization
+  );
+
+  // Add documents
+  await client.records.create('knowledge_base', {
+    title: 'Machine Learning',
+    content: 'ML is a branch of AI that focuses on learning from data.',
+  });
+
+  await client.records.create('knowledge_base', {
+    title: 'Deep Learning',
+    content: 'Deep learning uses neural networks with multiple layers.',
+  });
+
+  // Perform semantic search
+  const results = await client.records.search(
+    'knowledge_base',
+    'What is artificial intelligence?',
+    undefined, // filters
+    5 // limit
+  );
+
+  results.results.forEach((result) => {
+    console.log(`${result.record.data.title} (score: ${result.score})`);
+  });
+
+  await client.close();
+}
+```
+
+## API Reference
+
+### CortexClient
+
+```typescript
+const client = new CortexClient({
+  baseUrl?: string;        // Default: 'http://localhost:8000'
+  apiKey?: string;         // Optional API key
+  timeout?: number;        // Request timeout in ms (default: 30000)
+});
+```
+
+#### Methods
+
+- `health()` - Get health status
+- `healthcheck()` - Returns boolean health status
+- `close()` - Close the client
+
+### Collections API
+
+```typescript
+// List all collections
+const collections = await client.collections.list();
+
+// Get a collection
+const collection = await client.collections.get('my_collection');
+
+// Create a collection
+await client.collections.create(
+  'my_collection',
+  [
+    { name: 'title', type: FieldType.STRING, required: true },
+    { name: 'content', type: FieldType.STRING, vectorize: true },
+  ],
+  'embedding-provider-id' // Optional: required if vectorize is true
+);
+
+// Update a collection
+await client.collections.update('my_collection', fields, embeddingProvider);
+
+// Delete a collection
+await client.collections.delete('my_collection');
+```
+
+### Records API
+
+```typescript
+// Create a record
+const record = await client.records.create('collection_name', {
+  title: 'My Document',
+  content: 'Document content...',
+});
+
+// Get a record
+const record = await client.records.get('collection_name', 'record-id');
+
+// List records with filters
+const results = await client.records.list('collection_name', {
+  filters: { year: 2024 },
+  limit: 10,
+  offset: 0,
+});
+
+// Update a record
+await client.records.update('collection_name', 'record-id', {
+  title: 'Updated Title',
+});
+
+// Delete a record
+await client.records.delete('collection_name', 'record-id');
+
+// Semantic search
+const results = await client.records.search(
+  'collection_name',
+  'search query',
+  { category: 'tech' }, // optional filters
+  10 // limit
+);
+```
+
+## Field Types
+
+```typescript
+import { FieldType, StoreLocation } from '@cortexdb/sdk';
+
+const field = {
+  name: 'my_field',
+  type: FieldType.STRING, // STRING, NUMBER, BOOLEAN, FILE, ARRAY
+  vectorize: true,        // Enable semantic search
+  required: false,        // Make field required
+  store_in: [             // Storage locations
+    StoreLocation.POSTGRES,
+    StoreLocation.QDRANT_PAYLOAD,
+  ],
+};
+```
+
+## Error Handling
+
+The SDK provides specific error types for better error handling:
+
+```typescript
+import {
+  CortexDBError,
+  CortexDBConnectionError,
+  CortexDBTimeoutError,
+  CortexDBNotFoundError,
+  CortexDBValidationError,
+  CortexDBAuthenticationError,
+  CortexDBPermissionError,
+  CortexDBServerError,
+} from '@cortexdb/sdk';
+
+try {
+  await client.records.get('collection', 'invalid-id');
+} catch (error) {
+  if (error instanceof CortexDBNotFoundError) {
+    console.log('Record not found');
+  } else if (error instanceof CortexDBConnectionError) {
+    console.log('Connection failed');
+  } else if (error instanceof CortexDBTimeoutError) {
+    console.log('Request timed out');
+  } else {
+    console.log('Unknown error:', error);
+  }
+}
+```
+
+## Examples
+
+Check out the [examples](./examples) directory for more:
+
+- [quickstart.ts](./examples/quickstart.ts) - Complete quickstart guide
+- [search.ts](./examples/search.ts) - Semantic search with filters
+- [basic.ts](./examples/basic.ts) - Basic operations
+
+Run examples:
+
+```bash
+cd examples
+npx ts-node -O '{"module":"commonjs"}' quickstart.ts
+```
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Watch mode
+npm run build:watch
+
+# Clean
+npm run clean
+```
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License
+
+MIT License - see [LICENSE](./LICENSE) file for details.
+
+## Support
+
+- 📖 [Documentation](https://github.com/cortexdb/cortexdb)
+- 🐛 [Issue Tracker](https://github.com/cortexdb/cortexdb/issues)
+- 💬 [Discussions](https://github.com/cortexdb/cortexdb/discussions)
+
+## Related
+
+- [CortexDB Python SDK](../python) - Python client for CortexDB
+- [CortexDB Gateway](../../gateway) - CortexDB backend service

package/dist/client/index.d.ts

@@ -0,0 +1,29 @@
+/** Main CortexDB client */
+import { CollectionsAPI } from "../collections/api";
+import { RecordsAPI } from "../records/api";
+export interface CortexClientOptions {
+    baseUrl?: string;
+    apiKey?: string;
+    timeout?: number;
+}
+export declare class CortexClient {
+    private http;
+    collections: CollectionsAPI;
+    records: RecordsAPI;
+    constructor(options?: CortexClientOptions);
+    /**
+     * Check if the connection to CortexDB is working
+     */
+    health(): Promise<{
+        status: string;
+    }>;
+    /**
+     * Shorthand for health check that returns boolean
+     */
+    healthcheck(): Promise<boolean>;
+    /**
+     * Close the client (cleanup if needed)
+     */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAG3B,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,IAAI,CAAa;IAClB,WAAW,EAAE,cAAc,CAAC;IAC5B,OAAO,EAAE,UAAU,CAAC;gBAEf,OAAO,GAAE,mBAAwB;IAY7C;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAI3C;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IASrC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/client/index.js

@@ -0,0 +1,41 @@
+"use strict";
+/** Main CortexDB client */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CortexClient = void 0;
+const client_1 = require("../http/client");
+const api_1 = require("../collections/api");
+const api_2 = require("../records/api");
+class CortexClient {
+    constructor(options = {}) {
+        const { baseUrl = "http://localhost:8000", apiKey, timeout = 30000, } = options;
+        this.http = new client_1.HTTPClient(baseUrl, apiKey, timeout);
+        this.collections = new api_1.CollectionsAPI(this.http);
+        this.records = new api_2.RecordsAPI(this.http);
+    }
+    /**
+     * Check if the connection to CortexDB is working
+     */
+    async health() {
+        return this.http.get("/health");
+    }
+    /**
+     * Shorthand for health check that returns boolean
+     */
+    async healthcheck() {
+        try {
+            const response = await this.health();
+            return response.status === "ok";
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Close the client (cleanup if needed)
+     */
+    async close() {
+        // Future: cleanup connections, cancel pending requests, etc.
+    }
+}
+exports.CortexClient = CortexClient;
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":";AAAA,2BAA2B;;;AAE3B,2CAA4C;AAC5C,4CAAoD;AACpD,wCAA4C;AAQ5C,MAAa,YAAY;IAKvB,YAAY,UAA+B,EAAE;QAC3C,MAAM,EACJ,OAAO,GAAG,uBAAuB,EACjC,MAAM,EACN,OAAO,GAAG,KAAK,GAChB,GAAG,OAAO,CAAC;QAEZ,IAAI,CAAC,IAAI,GAAG,IAAI,mBAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QACrD,IAAI,CAAC,WAAW,GAAG,IAAI,oBAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,CAAC,OAAO,GAAG,IAAI,gBAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM;QACV,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW;QACf,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;YACrC,OAAO,QAAQ,CAAC,MAAM,KAAK,IAAI,CAAC;QAClC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,6DAA6D;IAC/D,CAAC;CACF;AA1CD,oCA0CC"}

package/dist/collections/api.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Collections API for CortexDB
+ *
+ * Provides methods to create, read, update, and delete collections.
+ * Collections define the schema and structure for records.
+ */
+import { Collection, FieldDefinition } from "../types";
+import { HTTPClient } from "../http/client";
+/**
+ * API for managing CortexDB collections
+ */
+export declare class CollectionsAPI {
+    private http;
+    /**
+     * Create a new CollectionsAPI instance
+     *
+     * @param http - HTTP client for making requests
+     */
+    constructor(http: HTTPClient);
+    /**
+     * List all collections in the database
+     *
+     * @returns Array of all collections
+     * @example
+     * ```typescript
+     * const collections = await client.collections.list();
+     * console.log(`Found ${collections.length} collections`);
+     * ```
+     */
+    list(): Promise<Collection[]>;
+    /**
+     * Get a specific collection by name
+     *
+     * @param name - Name of the collection to retrieve
+     * @returns Collection details including schema
+     * @throws {CortexDBNotFoundError} If collection doesn't exist
+     * @example
+     * ```typescript
+     * const collection = await client.collections.get('my_collection');
+     * console.log(collection.fields);
+     * ```
+     */
+    get(name: string): Promise<Collection>;
+    /**
+     * Create a new collection with the specified schema
+     *
+     * @param name - Name for the new collection
+     * @param fields - Array of field definitions
+     * @param embedding_provider - Optional embedding provider ID (required if any field has vectorize=true)
+     * @returns Created collection details
+     * @throws {CortexDBValidationError} If schema is invalid or embedding provider is missing when required
+     * @example
+     * ```typescript
+     * const collection = await client.collections.create('documents', [
+     *   { name: 'title', type: FieldType.STRING },
+     *   { name: 'content', type: FieldType.STRING, vectorize: true }
+     * ], 'embedding-provider-id');
+     * ```
+     */
+    create(name: string, fields: FieldDefinition[], embedding_provider?: string): Promise<Collection>;
+    /**
+     * Update an existing collection's schema
+     *
+     * @param name - Name of the collection to update
+     * @param fields - New field definitions
+     * @returns Updated collection details
+     * @throws {CortexDBNotFoundError} If collection doesn't exist
+     * @example
+     * ```typescript
+     * const updated = await client.collections.update('documents', [
+     *   { name: 'title', type: FieldType.STRING },
+     *   { name: 'description', type: FieldType.STRING }
+     * ]);
+     * ```
+     */
+    update(name: string, fields: FieldDefinition[]): Promise<Collection>;
+    /**
+     * Delete a collection and all its records
+     *
+     * @param name - Name of the collection to delete
+     * @throws {CortexDBNotFoundError} If collection doesn't exist
+     * @example
+     * ```typescript
+     * await client.collections.delete('old_collection');
+     * ```
+     */
+    delete(name: string): Promise<void>;
+}
+//# sourceMappingURL=api.d.ts.map

package/dist/collections/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/collections/api.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,eAAe,EAAoB,MAAM,UAAU,CAAC;AACzE,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C;;GAEG;AACH,qBAAa,cAAc;IAMb,OAAO,CAAC,IAAI;IALxB;;;;OAIG;gBACiB,IAAI,EAAE,UAAU;IAEpC;;;;;;;;;OASG;IACG,IAAI,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAInC;;;;;;;;;;;OAWG;IACG,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAI5C;;;;;;;;;;;;;;;OAeG;IACG,MAAM,CACV,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,eAAe,EAAE,EACzB,kBAAkB,CAAC,EAAE,MAAM,GAC1B,OAAO,CAAC,UAAU,CAAC;IAQtB;;;;;;;;;;;;;;OAcG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC;IAI1E;;;;;;;;;OASG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAG1C"}

package/dist/collections/api.js

@@ -0,0 +1,106 @@
+"use strict";
+/**
+ * Collections API for CortexDB
+ *
+ * Provides methods to create, read, update, and delete collections.
+ * Collections define the schema and structure for records.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CollectionsAPI = void 0;
+/**
+ * API for managing CortexDB collections
+ */
+class CollectionsAPI {
+    /**
+     * Create a new CollectionsAPI instance
+     *
+     * @param http - HTTP client for making requests
+     */
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * List all collections in the database
+     *
+     * @returns Array of all collections
+     * @example
+     * ```typescript
+     * const collections = await client.collections.list();
+     * console.log(`Found ${collections.length} collections`);
+     * ```
+     */
+    async list() {
+        return this.http.get("/collections");
+    }
+    /**
+     * Get a specific collection by name
+     *
+     * @param name - Name of the collection to retrieve
+     * @returns Collection details including schema
+     * @throws {CortexDBNotFoundError} If collection doesn't exist
+     * @example
+     * ```typescript
+     * const collection = await client.collections.get('my_collection');
+     * console.log(collection.fields);
+     * ```
+     */
+    async get(name) {
+        return this.http.get(`/collections/${name}`);
+    }
+    /**
+     * Create a new collection with the specified schema
+     *
+     * @param name - Name for the new collection
+     * @param fields - Array of field definitions
+     * @param embedding_provider - Optional embedding provider ID (required if any field has vectorize=true)
+     * @returns Created collection details
+     * @throws {CortexDBValidationError} If schema is invalid or embedding provider is missing when required
+     * @example
+     * ```typescript
+     * const collection = await client.collections.create('documents', [
+     *   { name: 'title', type: FieldType.STRING },
+     *   { name: 'content', type: FieldType.STRING, vectorize: true }
+     * ], 'embedding-provider-id');
+     * ```
+     */
+    async create(name, fields, embedding_provider) {
+        const payload = { name, fields };
+        if (embedding_provider) {
+            payload.config = { embedding_provider_id: embedding_provider };
+        }
+        return this.http.post("/collections", payload);
+    }
+    /**
+     * Update an existing collection's schema
+     *
+     * @param name - Name of the collection to update
+     * @param fields - New field definitions
+     * @returns Updated collection details
+     * @throws {CortexDBNotFoundError} If collection doesn't exist
+     * @example
+     * ```typescript
+     * const updated = await client.collections.update('documents', [
+     *   { name: 'title', type: FieldType.STRING },
+     *   { name: 'description', type: FieldType.STRING }
+     * ]);
+     * ```
+     */
+    async update(name, fields) {
+        return this.http.put(`/collections/${name}`, { fields });
+    }
+    /**
+     * Delete a collection and all its records
+     *
+     * @param name - Name of the collection to delete
+     * @throws {CortexDBNotFoundError} If collection doesn't exist
+     * @example
+     * ```typescript
+     * await client.collections.delete('old_collection');
+     * ```
+     */
+    async delete(name) {
+        await this.http.delete(`/collections/${name}`);
+    }
+}
+exports.CollectionsAPI = CollectionsAPI;
+//# sourceMappingURL=api.js.map

package/dist/collections/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/collections/api.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAKH;;GAEG;AACH,MAAa,cAAc;IACzB;;;;OAIG;IACH,YAAoB,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAExC;;;;;;;;;OASG;IACH,KAAK,CAAC,IAAI;QACR,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAe,cAAc,CAAC,CAAC;IACrD,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,GAAG,CAAC,IAAY;QACpB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAa,gBAAgB,IAAI,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,MAAM,CACV,IAAY,EACZ,MAAyB,EACzB,kBAA2B;QAE3B,MAAM,OAAO,GAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QACtC,IAAI,kBAAkB,EAAE,CAAC;YACvB,OAAO,CAAC,MAAM,GAAG,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,CAAC;QACjE,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAa,cAAc,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,MAAM,CAAC,IAAY,EAAE,MAAyB;QAClD,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAa,gBAAgB,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACvE,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,MAAM,CAAC,IAAY;QACvB,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC;IACjD,CAAC;CACF;AAlGD,wCAkGC"}

package/dist/exceptions/index.d.ts

@@ -0,0 +1,50 @@
+/** Custom exceptions for CortexDB SDK */
+/**
+ * Base exception for all CortexDB errors
+ */
+export declare class CortexDBError extends Error {
+    constructor(message: string);
+}
+/**
+ * Exception raised for connection errors
+ */
+export declare class CortexDBConnectionError extends CortexDBError {
+    constructor(message?: string);
+}
+/**
+ * Exception raised for timeout errors
+ */
+export declare class CortexDBTimeoutError extends CortexDBError {
+    constructor(message?: string);
+}
+/**
+ * Exception raised for 404 Not Found errors
+ */
+export declare class CortexDBNotFoundError extends CortexDBError {
+    constructor(message?: string);
+}
+/**
+ * Exception raised for validation errors (400)
+ */
+export declare class CortexDBValidationError extends CortexDBError {
+    constructor(message?: string);
+}
+/**
+ * Exception raised for authentication errors (401)
+ */
+export declare class CortexDBAuthenticationError extends CortexDBError {
+    constructor(message?: string);
+}
+/**
+ * Exception raised for permission errors (403)
+ */
+export declare class CortexDBPermissionError extends CortexDBError {
+    constructor(message?: string);
+}
+/**
+ * Exception raised for server errors (5xx)
+ */
+export declare class CortexDBServerError extends CortexDBError {
+    constructor(message?: string);
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/exceptions/index.ts"],"names":[],"mappings":"AAAA,yCAAyC;AAEzC;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;gBAC1B,OAAO,EAAE,MAAM;CAK5B;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,aAAa;gBAC5C,OAAO,GAAE,MAAwC;CAK9D;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,aAAa;gBACzC,OAAO,GAAE,MAA4B;CAKlD;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,aAAa;gBAC1C,OAAO,GAAE,MAA6B;CAKnD;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,aAAa;gBAC5C,OAAO,GAAE,MAA2B;CAKjD;AAED;;GAEG;AACH,qBAAa,2BAA4B,SAAQ,aAAa;gBAChD,OAAO,GAAE,MAAgC;CAKtD;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,aAAa;gBAC5C,OAAO,GAAE,MAA4B;CAKlD;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,aAAa;gBACxC,OAAO,GAAE,MAAuB;CAK7C"}