@dooor-ai/cortexdb 0.1.0 → 0.1.1

package/README.md

@@ -1,34 +1,33 @@
-# CortexDB TypeScript/JavaScript SDK
+# CortexDB TypeScript 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)
+Official TypeScript/JavaScript client for CortexDB - Multi-modal RAG Platform.
 
 ## 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
+- Full TypeScript support with type definitions
+- Async/await API using native fetch
+- Semantic search with vector embeddings
+- Collection and record management
+- Custom error types for better debugging
+- Works with Node.js 18+, Deno, and modern browsers
 
 ## Installation
 
 ```bash
 npm install @dooor-ai/cortexdb
-# or
+```
+
+Or with yarn:
+
+```bash
 yarn add @dooor-ai/cortexdb
-# or
-pnpm add @dooor-ai/cortexdb
 ```
 
-## Requirements
+Or with pnpm:
 
-- Node.js >= 18.0.0 (uses native `fetch`)
-- CortexDB gateway running (default: `http://localhost:8000`)
+```bash
+pnpm add @dooor-ai/cortexdb
+```
 
 ## Quick Start
 
@@ -36,242 +35,235 @@ pnpm add @dooor-ai/cortexdb
 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
+    baseUrl: 'http://localhost:8000'
   });
 
-  // Check health
-  const isHealthy = await client.healthcheck();
-  console.log('CortexDB:', isHealthy ? 'Connected ✓' : 'Disconnected ✗');
-
   // Create a collection
-  await client.collections.create('my_docs', [
+  await client.collections.create('documents', [
     { name: 'title', type: FieldType.STRING },
-    { name: 'content', type: FieldType.STRING },
+    { name: 'content', type: FieldType.STRING, vectorize: true }
   ]);
 
   // Create a record
-  const record = await client.records.create('my_docs', {
+  const record = await client.records.create('documents', {
     title: 'Hello World',
-    content: 'This is my first document',
+    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);
+  // Semantic search
+  const results = await client.records.search(
+    'documents',
+    'hello world',
+    undefined,
+    10
+  );
 
-  // List all records
-  const results = await client.records.list('my_docs');
-  console.log('Total:', results.total);
+  results.results.forEach(result => {
+    console.log(`Score: ${result.score.toFixed(4)} - ${result.record.data.title}`);
+  });
 
-  // Clean up
-  await client.collections.delete('my_docs');
   await client.close();
 }
 
 main();
 ```
 
-## Semantic Search Example
+## Usage
 
-Enable semantic search by creating a collection with `vectorize: true` and an embedding provider:
+### Initialize Client
 
 ```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
-  );
+import { CortexClient } from '@dooor-ai/cortexdb';
 
-  // 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
+// Local development
+const client = new CortexClient({
+  baseUrl: 'http://localhost:8000'
+});
 
-### CortexClient
+// With API key
+const client = new CortexClient({
+  baseUrl: 'https://api.cortexdb.com',
+  apiKey: 'your-api-key'
+});
 
-```typescript
+// Custom timeout
 const client = new CortexClient({
-  baseUrl?: string;        // Default: 'http://localhost:8000'
-  apiKey?: string;         // Optional API key
-  timeout?: number;        // Request timeout in ms (default: 30000)
+  baseUrl: 'http://localhost:8000',
+  timeout: 60000  // 60 seconds
 });
 ```
 
-#### Methods
-
-- `health()` - Get health status
-- `healthcheck()` - Returns boolean health status
-- `close()` - Close the client
-
-### Collections API
+### Collections
 
 ```typescript
-// List all collections
-const collections = await client.collections.list();
+import { FieldType, StoreLocation } from '@dooor-ai/cortexdb';
+
+// Create collection
+const collection = await client.collections.create('articles', [
+  {
+    name: 'title',
+    type: FieldType.STRING
+  },
+  {
+    name: 'content',
+    type: FieldType.STRING,
+    vectorize: true  // Enable semantic search
+  },
+  {
+    name: 'year',
+    type: FieldType.NUMBER,
+    store_in: [StoreLocation.POSTGRES, StoreLocation.QDRANT_PAYLOAD]
+  }
+]);
 
-// 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
-);
+// List collections
+const collections = await client.collections.list();
 
-// Update a collection
-await client.collections.update('my_collection', fields, embeddingProvider);
+// Get collection
+const schema = await client.collections.get('articles');
 
-// Delete a collection
-await client.collections.delete('my_collection');
+// Delete collection
+await client.collections.delete('articles');
 ```
 
-### Records API
+### Records
 
 ```typescript
-// Create a record
-const record = await client.records.create('collection_name', {
-  title: 'My Document',
-  content: 'Document content...',
+// Create record
+const record = await client.records.create('articles', {
+  title: 'Machine Learning Basics',
+  content: 'Introduction to ML concepts...',
+  year: 2024
 });
 
-// Get a record
-const record = await client.records.get('collection_name', 'record-id');
+// Get record by ID
+const fetched = await client.records.get('articles', record.id);
 
-// List records with filters
-const results = await client.records.list('collection_name', {
-  filters: { year: 2024 },
-  limit: 10,
-  offset: 0,
+// Update record
+const updated = await client.records.update('articles', record.id, {
+  year: 2025
 });
 
-// Update a record
-await client.records.update('collection_name', 'record-id', {
-  title: 'Updated Title',
+// Delete record
+await client.records.delete('articles', record.id);
+
+// List records
+const results = await client.records.list('articles', {
+  limit: 10,
+  offset: 0
 });
+```
 
-// Delete a record
-await client.records.delete('collection_name', 'record-id');
+### Semantic Search
 
-// Semantic search
+```typescript
+// Basic search
 const results = await client.records.search(
-  'collection_name',
-  'search query',
-  { category: 'tech' }, // optional filters
-  10 // limit
+  'articles',
+  'machine learning fundamentals',
+  undefined,
+  10
 );
+
+// Search with filters
+const filteredResults = await client.records.search(
+  'articles',
+  'neural networks',
+  {
+    year: 2024,
+    category: 'AI'
+  },
+  5
+);
+
+// Process results
+filteredResults.results.forEach(result => {
+  console.log(`Score: ${result.score.toFixed(4)}`);
+  console.log(`Title: ${result.record.data.title}`);
+  console.log(`Year: ${result.record.data.year}`);
+});
 ```
 
-## Field Types
+### Filter Operators
 
 ```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,
-  ],
-};
+// Exact match
+const results = await client.records.list('articles', {
+  filters: {
+    category: 'technology',
+    published: true
+  }
+});
+
+// Combine filters
+const filtered = await client.records.list('articles', {
+  filters: {
+    year: 2024,
+    category: 'AI'
+  },
+  limit: 20
+});
 ```
 
 ## 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';
+  CortexDBConnectionError
+} from '@dooor-ai/cortexdb';
 
 try {
-  await client.records.get('collection', 'invalid-id');
+  const record = await client.records.get('articles', 'invalid-id');
 } catch (error) {
   if (error instanceof CortexDBNotFoundError) {
     console.log('Record not found');
+  } else if (error instanceof CortexDBValidationError) {
+    console.log('Validation error:', error.message);
   } 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);
+    console.log('Connection failed:', error.message);
+  } else if (error instanceof CortexDBError) {
+    console.log('General error:', error.message);
   }
 }
 ```
 
 ## Examples
 
-Check out the [examples](./examples) directory for more:
+Check the [`examples/`](./examples) directory for more usage examples:
 
-- [quickstart.ts](./examples/quickstart.ts) - Complete quickstart guide
-- [search.ts](./examples/search.ts) - Semantic search with filters
-- [basic.ts](./examples/basic.ts) - Basic operations
+- [`quickstart.ts`](./examples/quickstart.ts) - Walkthrough of SDK features
+- [`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
+npx ts-node -O '{"module":"commonjs"}' examples/quickstart.ts
 ```
 
 ## Development
 
+### Setup
+
 ```bash
+# Clone repository
+git clone https://github.com/yourusername/cortexdb
+cd cortexdb/clients/typescript
+
 # Install dependencies
 npm install
 
+# Build
+npm run build
+```
+
+### Scripts
+
+```bash
 # Build
 npm run build
 
@@ -280,23 +272,19 @@ npm run build:watch
 
 # Clean
 npm run clean
-```
-
-## Contributing
-
-Contributions are welcome! Please feel free to submit a Pull Request.
 
-## License
+# Lint
+npm run lint
 
-MIT License - see [LICENSE](./LICENSE) file for details.
+# Format
+npm run format
+```
 
-## Support
+## Requirements
 
-- 📖 [Documentation](https://github.com/cortexdb/cortexdb)
-- 🐛 [Issue Tracker](https://github.com/cortexdb/cortexdb/issues)
-- 💬 [Discussions](https://github.com/cortexdb/cortexdb/discussions)
+- Node.js >= 18.0.0
+- CortexDB gateway running (local or remote)
 
-## Related
+## License
 
-- [CortexDB Python SDK](../python) - Python client for CortexDB
-- [CortexDB Gateway](../../gateway) - CortexDB backend service
+MIT License - see [LICENSE](./LICENSE) for details.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dooor-ai/cortexdb",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Official TypeScript/JavaScript SDK for CortexDB - Multi-modal RAG Platform with advanced document processing",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",