@jabrod/sdk 1.0.8

package/README.md

@@ -0,0 +1,192 @@
+# @jabrod/sdk
+
+Official TypeScript SDK for [Jabrod Cloud API](https://cloud.jabrod.com) - RAG as a Service.
+
+Build AI-powered applications with knowledge bases in minutes. Upload documents, query them with semantic search, and get AI-generated responses.
+
+## Installation
+
+```bash
+npm install @jabrod/sdk
+# or
+yarn add @jabrod/sdk
+# or
+pnpm add @jabrod/sdk
+```
+
+## Quick Start
+
+```typescript
+import { Jabrod } from '@jabrod/sdk';
+
+// Initialize the client
+const jclient = Jabrod({
+  apiKey: 'jb_your_api_key_here'
+});
+
+// Create a knowledge base
+const kb = await jclient.kb.create({
+  name: 'My Documents',
+  description: 'Product documentation'
+});
+
+// Upload a document (browser)
+const file = document.querySelector('input[type="file"]').files[0];
+await jclient.kb.uploadFile({
+  kbId: kb.id,
+  file: file
+});
+
+// Or upload text content
+await jclient.kb.uploadText({
+  kbId: kb.id,
+  content: 'Your text content here...',
+  name: 'notes.txt'
+});
+
+// Chat with the knowledge base
+const response = await jclient.chat.complete({
+  kbId: kb.id,
+  message: 'What is mentioned in my documents?'
+});
+
+console.log(response.message);
+console.log('Sources:', response.sources);
+```
+
+## API Reference
+
+### Initialization
+
+```typescript
+import { Jabrod } from '@jabrod/sdk';
+
+const jclient = Jabrod({
+  apiKey: 'jb_xxx',           // Required: Your API key
+  baseUrl: 'https://...'      // Optional: Custom API URL
+});
+```
+
+### Knowledge Bases
+
+```typescript
+// List all knowledge bases
+const kbs = await jclient.kb.list();
+
+// Create a knowledge base
+const kb = await jclient.kb.create({
+  name: 'My KB',
+  description: 'Optional description'
+});
+
+// Get a specific knowledge base
+const kb = await jclient.kb.get('kb-id');
+
+// Delete a knowledge base
+await jclient.kb.delete('kb-id');
+
+// List documents in a knowledge base
+const docs = await jclient.kb.listDocuments('kb-id');
+
+// Upload a file
+await jclient.kb.uploadFile({
+  kbId: 'kb-id',
+  file: fileOrBlob,
+  filename: 'document.pdf'
+});
+
+// Upload text content
+await jclient.kb.uploadText({
+  kbId: 'kb-id',
+  content: 'Your text here',
+  name: 'notes.txt'
+});
+```
+
+### Query (Semantic Search)
+
+```typescript
+// Query for relevant chunks without LLM processing
+const results = await jclient.chat.query({
+  kbId: 'kb-id',
+  query: 'What is the return policy?',
+  topK: 5  // Optional: Number of results (default: 5)
+});
+
+console.log(results.chunks);
+// [{ content: '...', score: 0.95, documentId: '...' }, ...]
+```
+
+### Chat (RAG)
+
+```typescript
+// Get AI-generated response based on KB content
+const response = await jclient.chat.complete({
+  kbId: 'kb-id',
+  message: 'Summarize the key points',
+  model: 'mistralai/mistral-small-3.1-24b-instruct:free',  // Optional
+  systemPrompt: 'You are a helpful assistant.',  // Optional
+  topK: 5  // Optional: Number of context chunks
+});
+
+console.log(response.message);
+console.log(response.sources);  // Relevant document chunks
+console.log(response.usage);    // Token usage
+```
+
+### Usage Statistics
+
+```typescript
+// Get usage for current billing period
+const usage = await jclient.usage.get();
+
+console.log(usage.queries);
+console.log(usage.tokensUsed);
+console.log(usage.limits);
+```
+
+## Error Handling
+
+```typescript
+import { Jabrod, JabrodError } from '@jabrod/sdk';
+
+try {
+  const response = await jclient.chat.complete({ ... });
+} catch (error) {
+  if (error instanceof JabrodError) {
+    console.log(error.code);    // 'INVALID_API_KEY', 'NOT_FOUND', etc.
+    console.log(error.message); // Human-readable message
+    console.log(error.status);  // HTTP status code
+  }
+}
+```
+
+## TypeScript Support
+
+Full TypeScript support with exported types:
+
+```typescript
+import type {
+  KnowledgeBase,
+  Document,
+  ChatResult,
+  QueryResult,
+  UsageStats
+} from '@jabrod/sdk';
+```
+
+## Get Your API Key
+
+1. Sign up at [agent.jabrod.com](https://agent.jabrod.com)
+2. Go to Dashboard > API Keys
+3. Click "Create Key"
+4. Copy your key (starts with `jb_`)
+
+## Support
+
+- Documentation: [docs.jabrod.com](https://docs.jabrod.com)
+- Issues: [GitHub Issues](https://github.com/jabrod/sdk/issues)
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,41 @@
+/**
+ * HTTP Client for Jabrod API
+ */
+export interface ClientConfig {
+    apiKey: string;
+    baseUrl: string;
+}
+export declare class HttpClient {
+    private apiKey;
+    private baseUrl;
+    constructor(config: ClientConfig);
+    /**
+     * Make an authenticated request to the API
+     */
+    request<T>(method: string, path: string, options?: {
+        body?: unknown;
+        headers?: Record<string, string>;
+        formData?: FormData;
+    }): Promise<T>;
+    /**
+     * GET request
+     */
+    get<T>(path: string): Promise<T>;
+    /**
+     * POST request with JSON body
+     */
+    post<T>(path: string, body?: unknown): Promise<T>;
+    /**
+     * POST request with FormData
+     */
+    postForm<T>(path: string, formData: FormData): Promise<T>;
+    /**
+     * DELETE request
+     */
+    delete<T>(path: string): Promise<T>;
+    /**
+     * PATCH request
+     */
+    patch<T>(path: string, body?: unknown): Promise<T>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,WAAW,YAAY;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,UAAU;IACnB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,YAAY;IAKhC;;OAEG;IACG,OAAO,CAAC,CAAC,EACX,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;QACL,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,QAAQ,CAAC,EAAE,QAAQ,CAAC;KAClB,GACP,OAAO,CAAC,CAAC,CAAC;IAiCb;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAItC;;OAEG;IACG,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAIvD;;OAEG;IACG,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC;IAI/D;;OAEG;IACG,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAIzC;;OAEG;IACG,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;CAG3D"}

package/dist/client.js

@@ -0,0 +1,67 @@
+/**
+ * HTTP Client for Jabrod API
+ */
+import { JabrodError } from './types.js';
+export class HttpClient {
+    apiKey;
+    baseUrl;
+    constructor(config) {
+        this.apiKey = config.apiKey;
+        this.baseUrl = config.baseUrl.replace(/\/$/, ''); // Remove trailing slash
+    }
+    /**
+     * Make an authenticated request to the API
+     */
+    async request(method, path, options = {}) {
+        const url = `${this.baseUrl}${path}`;
+        const headers = {
+            'Authorization': `Bearer ${this.apiKey}`,
+            ...options.headers,
+        };
+        // Only set Content-Type for JSON body (not FormData)
+        if (options.body && !options.formData) {
+            headers['Content-Type'] = 'application/json';
+        }
+        const response = await fetch(url, {
+            method,
+            headers,
+            body: options.formData || (options.body ? JSON.stringify(options.body) : undefined),
+        });
+        const data = await response.json();
+        if (!response.ok || !data.success) {
+            throw new JabrodError(data.error?.code || 'UNKNOWN_ERROR', data.error?.message || 'An unknown error occurred', response.status, data.error?.details);
+        }
+        return data.data;
+    }
+    /**
+     * GET request
+     */
+    async get(path) {
+        return this.request('GET', path);
+    }
+    /**
+     * POST request with JSON body
+     */
+    async post(path, body) {
+        return this.request('POST', path, { body });
+    }
+    /**
+     * POST request with FormData
+     */
+    async postForm(path, formData) {
+        return this.request('POST', path, { formData });
+    }
+    /**
+     * DELETE request
+     */
+    async delete(path) {
+        return this.request('DELETE', path);
+    }
+    /**
+     * PATCH request
+     */
+    async patch(path, body) {
+        return this.request('PATCH', path, { body });
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAe,WAAW,EAAE,MAAM,YAAY,CAAC;AAOtD,MAAM,OAAO,UAAU;IACX,MAAM,CAAS;IACf,OAAO,CAAS;IAExB,YAAY,MAAoB;QAC5B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,wBAAwB;IAC9E,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CACT,MAAc,EACd,IAAY,EACZ,UAII,EAAE;QAEN,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,CAAC;QAErC,MAAM,OAAO,GAA2B;YACpC,eAAe,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;YACxC,GAAG,OAAO,CAAC,OAAO;SACrB,CAAC;QAEF,qDAAqD;QACrD,IAAI,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YACpC,OAAO,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAC;QACjD,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC9B,MAAM;YACN,OAAO;YACP,IAAI,EAAE,OAAO,CAAC,QAAQ,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;SACtF,CAAC,CAAC;QAEH,MAAM,IAAI,GAAmB,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAEnD,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAChC,MAAM,IAAI,WAAW,CACjB,IAAI,CAAC,KAAK,EAAE,IAAI,IAAI,eAAe,EACnC,IAAI,CAAC,KAAK,EAAE,OAAO,IAAI,2BAA2B,EAClD,QAAQ,CAAC,MAAM,EACf,IAAI,CAAC,KAAK,EAAE,OAAO,CACtB,CAAC;QACN,CAAC;QAED,OAAO,IAAI,CAAC,IAAS,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAI,IAAY;QACrB,OAAO,IAAI,CAAC,OAAO,CAAI,KAAK,EAAE,IAAI,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAI,IAAY,EAAE,IAAc;QACtC,OAAO,IAAI,CAAC,OAAO,CAAI,MAAM,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CAAI,IAAY,EAAE,QAAkB;QAC9C,OAAO,IAAI,CAAC,OAAO,CAAI,MAAM,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;IACvD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAI,IAAY;QACxB,OAAO,IAAI,CAAC,OAAO,CAAI,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CAAI,IAAY,EAAE,IAAc;QACvC,OAAO,IAAI,CAAC,OAAO,CAAI,OAAO,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC;CACJ"}

package/dist/index.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Jabrod SDK - Official SDK for Jabrod Cloud API
+ *
+ * @example
+ * ```typescript
+ * import { Jabrod } from '@jabrod/sdk';
+ *
+ * const jclient = Jabrod({ apiKey: 'jb_xxx' });
+ *
+ * // Create a knowledge base
+ * const kb = await jclient.kb.create({ name: 'My KB' });
+ *
+ * // Upload a document
+ * await jclient.kb.uploadFile({ kbId: kb.id, file: myFile });
+ *
+ * // Chat with the KB
+ * const response = await jclient.chat.complete({
+ *   kbId: kb.id,
+ *   message: 'What is in my documents?'
+ * });
+ * ```
+ */
+import { KBResource } from './resources/kb.js';
+import { ChatResource } from './resources/chat.js';
+import { UsageResource } from './resources/usage.js';
+import type { JabrodConfig } from './types.js';
+export * from './types.js';
+/**
+ * Jabrod SDK Client
+ */
+export interface JabrodClient {
+    /** Knowledge Base operations */
+    kb: KBResource;
+    /** Chat and Query operations */
+    chat: ChatResource;
+    /** Usage statistics */
+    usage: UsageResource;
+}
+/**
+ * Create a new Jabrod SDK client
+ *
+ * @param config - Configuration options
+ * @returns Jabrod client instance
+ *
+ * @example
+ * ```typescript
+ * const jclient = Jabrod({ apiKey: 'jb_xxx' });
+ * ```
+ */
+export declare function Jabrod(config: JabrodConfig): JabrodClient;
+export default Jabrod;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,cAAc,YAAY,CAAC;AAK3B;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,gCAAgC;IAChC,EAAE,EAAE,UAAU,CAAC;IACf,gCAAgC;IAChC,IAAI,EAAE,YAAY,CAAC;IACnB,uBAAuB;IACvB,KAAK,EAAE,aAAa,CAAC;CACxB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAmBzD;AAGD,eAAe,MAAM,CAAC"}

package/dist/index.js

@@ -0,0 +1,61 @@
+/**
+ * Jabrod SDK - Official SDK for Jabrod Cloud API
+ *
+ * @example
+ * ```typescript
+ * import { Jabrod } from '@jabrod/sdk';
+ *
+ * const jclient = Jabrod({ apiKey: 'jb_xxx' });
+ *
+ * // Create a knowledge base
+ * const kb = await jclient.kb.create({ name: 'My KB' });
+ *
+ * // Upload a document
+ * await jclient.kb.uploadFile({ kbId: kb.id, file: myFile });
+ *
+ * // Chat with the KB
+ * const response = await jclient.chat.complete({
+ *   kbId: kb.id,
+ *   message: 'What is in my documents?'
+ * });
+ * ```
+ */
+import { HttpClient } from './client.js';
+import { KBResource } from './resources/kb.js';
+import { ChatResource } from './resources/chat.js';
+import { UsageResource } from './resources/usage.js';
+// Re-export types
+export * from './types.js';
+// Default API base URL
+const DEFAULT_BASE_URL = 'https://cloud.jabrod.com';
+/**
+ * Create a new Jabrod SDK client
+ *
+ * @param config - Configuration options
+ * @returns Jabrod client instance
+ *
+ * @example
+ * ```typescript
+ * const jclient = Jabrod({ apiKey: 'jb_xxx' });
+ * ```
+ */
+export function Jabrod(config) {
+    if (!config.apiKey) {
+        throw new Error('API key is required. Get one at https://agent.jabrod.com/dashboard');
+    }
+    if (!config.apiKey.startsWith('jb_')) {
+        throw new Error('Invalid API key format. Keys should start with "jb_"');
+    }
+    const httpClient = new HttpClient({
+        apiKey: config.apiKey,
+        baseUrl: config.baseUrl || DEFAULT_BASE_URL,
+    });
+    return {
+        kb: new KBResource(httpClient),
+        chat: new ChatResource(httpClient),
+        usage: new UsageResource(httpClient),
+    };
+}
+// Default export
+export default Jabrod;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,kBAAkB;AAClB,cAAc,YAAY,CAAC;AAE3B,uBAAuB;AACvB,MAAM,gBAAgB,GAAG,0BAA0B,CAAC;AAcpD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,MAAM,CAAC,MAAoB;IACvC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;IAC1F,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC5E,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,UAAU,CAAC;QAC9B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,gBAAgB;KAC9C,CAAC,CAAC;IAEH,OAAO;QACH,EAAE,EAAE,IAAI,UAAU,CAAC,UAAU,CAAC;QAC9B,IAAI,EAAE,IAAI,YAAY,CAAC,UAAU,CAAC;QAClC,KAAK,EAAE,IAAI,aAAa,CAAC,UAAU,CAAC;KACvC,CAAC;AACN,CAAC;AAED,iBAAiB;AACjB,eAAe,MAAM,CAAC"}

package/dist/resources/chat.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Chat Resource
+ */
+import { HttpClient } from '../client.js';
+import type { ChatOptions, ChatResult, QueryOptions, QueryResult } from '../types.js';
+export declare class ChatResource {
+    private client;
+    constructor(client: HttpClient);
+    /**
+     * Query a knowledge base for relevant chunks
+     * Returns raw chunks without LLM processing
+     */
+    query(options: QueryOptions): Promise<QueryResult>;
+    /**
+     * Chat with a knowledge base
+     * Uses RAG to generate AI responses based on KB content
+     */
+    complete(options: ChatOptions): Promise<ChatResult>;
+}
+//# sourceMappingURL=chat.d.ts.map

package/dist/resources/chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/resources/chat.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEtF,qBAAa,YAAY;IACrB,OAAO,CAAC,MAAM,CAAa;gBAEf,MAAM,EAAE,UAAU;IAI9B;;;OAGG;IACG,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAQxD;;;OAGG;IACG,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAS5D"}

package/dist/resources/chat.js

@@ -0,0 +1,34 @@
+/**
+ * Chat Resource
+ */
+export class ChatResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Query a knowledge base for relevant chunks
+     * Returns raw chunks without LLM processing
+     */
+    async query(options) {
+        return this.client.post('/v1/query', {
+            kbId: options.kbId,
+            query: options.query,
+            topK: options.topK ?? 5,
+        });
+    }
+    /**
+     * Chat with a knowledge base
+     * Uses RAG to generate AI responses based on KB content
+     */
+    async complete(options) {
+        return this.client.post('/v1/chat', {
+            kbId: options.kbId,
+            message: options.message,
+            model: options.model,
+            systemPrompt: options.systemPrompt,
+            topK: options.topK ?? 5,
+        });
+    }
+}
+//# sourceMappingURL=chat.js.map

package/dist/resources/chat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.js","sourceRoot":"","sources":["../../src/resources/chat.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,OAAO,YAAY;IACb,MAAM,CAAa;IAE3B,YAAY,MAAkB;QAC1B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK,CAAC,OAAqB;QAC7B,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAc,WAAW,EAAE;YAC9C,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC;SAC1B,CAAC,CAAC;IACP,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,QAAQ,CAAC,OAAoB;QAC/B,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAa,UAAU,EAAE;YAC5C,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC;SAC1B,CAAC,CAAC;IACP,CAAC;CACJ"}

package/dist/resources/kb.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Knowledge Base Resource
+ */
+import { HttpClient } from '../client.js';
+import type { KnowledgeBase, CreateKBOptions, Document, UploadFileOptions, UploadTextOptions } from '../types.js';
+export declare class KBResource {
+    private client;
+    constructor(client: HttpClient);
+    /**
+     * List all knowledge bases
+     */
+    list(): Promise<KnowledgeBase[]>;
+    /**
+     * Create a new knowledge base
+     */
+    create(options: CreateKBOptions): Promise<KnowledgeBase>;
+    /**
+     * Get a knowledge base by ID
+     */
+    get(kbId: string): Promise<KnowledgeBase>;
+    /**
+     * Delete a knowledge base
+     */
+    delete(kbId: string): Promise<void>;
+    /**
+     * List documents in a knowledge base
+     */
+    listDocuments(kbId: string): Promise<Document[]>;
+    /**
+     * Upload a file to a knowledge base
+     */
+    uploadFile(options: UploadFileOptions): Promise<Document>;
+    /**
+     * Upload text content to a knowledge base
+     */
+    uploadText(options: UploadTextOptions): Promise<Document>;
+}
+//# sourceMappingURL=kb.d.ts.map

package/dist/resources/kb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kb.d.ts","sourceRoot":"","sources":["../../src/resources/kb.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,KAAK,EACR,aAAa,EACb,eAAe,EACf,QAAQ,EACR,iBAAiB,EACjB,iBAAiB,EACpB,MAAM,aAAa,CAAC;AAErB,qBAAa,UAAU;IACnB,OAAO,CAAC,MAAM,CAAa;gBAEf,MAAM,EAAE,UAAU;IAI9B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAItC;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,CAAC;IAI9D;;OAEG;IACG,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAI/C;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC;;OAEG;IACG,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAItD;;OAEG;IACG,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAY/D;;OAEG;IACG,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,QAAQ,CAAC;CAOlE"}

package/dist/resources/kb.js

@@ -0,0 +1,62 @@
+/**
+ * Knowledge Base Resource
+ */
+export class KBResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * List all knowledge bases
+     */
+    async list() {
+        return this.client.get('/v1/kb');
+    }
+    /**
+     * Create a new knowledge base
+     */
+    async create(options) {
+        return this.client.post('/v1/kb', options);
+    }
+    /**
+     * Get a knowledge base by ID
+     */
+    async get(kbId) {
+        return this.client.get(`/v1/kb/${kbId}`);
+    }
+    /**
+     * Delete a knowledge base
+     */
+    async delete(kbId) {
+        await this.client.delete(`/v1/kb/${kbId}`);
+    }
+    /**
+     * List documents in a knowledge base
+     */
+    async listDocuments(kbId) {
+        return this.client.get(`/v1/kb/${kbId}/documents`);
+    }
+    /**
+     * Upload a file to a knowledge base
+     */
+    async uploadFile(options) {
+        const formData = new FormData();
+        if (options.file instanceof File) {
+            formData.append('file', options.file);
+        }
+        else {
+            formData.append('file', options.file, options.filename || 'upload');
+        }
+        return this.client.postForm(`/v1/kb/${options.kbId}/documents`, formData);
+    }
+    /**
+     * Upload text content to a knowledge base
+     */
+    async uploadText(options) {
+        const blob = new Blob([options.content], { type: 'text/plain' });
+        const formData = new FormData();
+        formData.append('file', blob, options.name || 'text.txt');
+        return this.client.postForm(`/v1/kb/${options.kbId}/documents`, formData);
+    }
+}
+//# sourceMappingURL=kb.js.map

package/dist/resources/kb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kb.js","sourceRoot":"","sources":["../../src/resources/kb.ts"],"names":[],"mappings":"AAAA;;GAEG;AAWH,MAAM,OAAO,UAAU;IACX,MAAM,CAAa;IAE3B,YAAY,MAAkB;QAC1B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACN,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAkB,QAAQ,CAAC,CAAC;IACtD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,OAAwB;QACjC,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAgB,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC9D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,IAAY;QAClB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAgB,UAAU,IAAI,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,IAAY;QACrB,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,IAAY;QAC5B,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAa,UAAU,IAAI,YAAY,CAAC,CAAC;IACnE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,OAA0B;QACvC,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC;QAEhC,IAAI,OAAO,CAAC,IAAI,YAAY,IAAI,EAAE,CAAC;YAC/B,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAC1C,CAAC;aAAM,CAAC;YACJ,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,IAAI,QAAQ,CAAC,CAAC;QACxE,CAAC;QAED,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAW,UAAU,OAAO,CAAC,IAAI,YAAY,EAAE,QAAQ,CAAC,CAAC;IACxF,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,OAA0B;QACvC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;QACjE,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC;QAChC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,UAAU,CAAC,CAAC;QAE1D,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAW,UAAU,OAAO,CAAC,IAAI,YAAY,EAAE,QAAQ,CAAC,CAAC;IACxF,CAAC;CACJ"}

package/dist/resources/usage.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Usage Resource
+ */
+import { HttpClient } from '../client.js';
+import type { UsageStats } from '../types.js';
+export declare class UsageResource {
+    private client;
+    constructor(client: HttpClient);
+    /**
+     * Get usage statistics for the current billing period
+     */
+    get(): Promise<UsageStats>;
+}
+//# sourceMappingURL=usage.d.ts.map

package/dist/resources/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/resources/usage.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,qBAAa,aAAa;IACtB,OAAO,CAAC,MAAM,CAAa;gBAEf,MAAM,EAAE,UAAU;IAI9B;;OAEG;IACG,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC;CAGnC"}

package/dist/resources/usage.js

@@ -0,0 +1,16 @@
+/**
+ * Usage Resource
+ */
+export class UsageResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Get usage statistics for the current billing period
+     */
+    async get() {
+        return this.client.get('/v1/usage');
+    }
+}
+//# sourceMappingURL=usage.js.map

package/dist/resources/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/resources/usage.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,OAAO,aAAa;IACd,MAAM,CAAa;IAE3B,YAAY,MAAkB;QAC1B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG;QACL,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAa,WAAW,CAAC,CAAC;IACpD,CAAC;CACJ"}

package/dist/types.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Type definitions for Jabrod SDK
+ */
+export interface JabrodConfig {
+    apiKey: string;
+    baseUrl?: string;
+}
+export interface KnowledgeBase {
+    id: string;
+    name: string;
+    description: string | null;
+    status: 'active' | 'processing' | 'error' | 'archived';
+    documentCount: number;
+    totalSize: number;
+    vectorCount: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateKBOptions {
+    name: string;
+    description?: string;
+}
+export interface Document {
+    id: string;
+    knowledgeBaseId: string;
+    name: string;
+    type: 'file' | 'link' | 'text';
+    mimeType: string | null;
+    size: number;
+    status: 'pending' | 'processing' | 'completed' | 'failed';
+    chunkCount: number;
+    errorMessage: string | null;
+    createdAt: string;
+    processedAt: string | null;
+}
+export interface UploadFileOptions {
+    kbId: string;
+    file: File | Blob;
+    filename?: string;
+}
+export interface UploadTextOptions {
+    kbId: string;
+    content: string;
+    name?: string;
+}
+export interface QueryOptions {
+    kbId: string;
+    query: string;
+    topK?: number;
+}
+export interface QueryResult {
+    chunks: {
+        content: string;
+        score: number;
+        documentId: string;
+        metadata?: Record<string, unknown>;
+    }[];
+    query: string;
+    latencyMs: number;
+}
+export interface ChatOptions {
+    kbId: string;
+    message: string;
+    model?: string;
+    systemPrompt?: string;
+    topK?: number;
+}
+export interface ChatResult {
+    message: string;
+    sources: {
+        documentId: string;
+        content: string;
+        score: number;
+    }[];
+    model: string;
+    latencyMs: number;
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+}
+export interface UsageStats {
+    period: {
+        start: string;
+        end: string;
+    };
+    queries: number;
+    chats: number;
+    documentsProcessed: number;
+    tokensUsed: number;
+    storageUsedBytes: number;
+    tier: string;
+    limits: {
+        queriesPerMonth: number;
+        chatsPerMonth: number;
+        storageBytes: number;
+    };
+}
+export interface ApiResponse<T> {
+    success: boolean;
+    data?: T;
+    error?: {
+        code: string;
+        message: string;
+        details?: unknown;
+    };
+}
+export declare class JabrodError extends Error {
+    code: string;
+    status: number;
+    details?: unknown;
+    constructor(code: string, message: string, status?: number, details?: unknown);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,17 @@
+/**
+ * Type definitions for Jabrod SDK
+ */
+// Error
+export class JabrodError extends Error {
+    code;
+    status;
+    details;
+    constructor(code, message, status = 400, details) {
+        super(message);
+        this.name = 'JabrodError';
+        this.code = code;
+        this.status = status;
+        this.details = details;
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AA8HH,QAAQ;AACR,MAAM,OAAO,WAAY,SAAQ,KAAK;IAClC,IAAI,CAAS;IACb,MAAM,CAAS;IACf,OAAO,CAAW;IAElB,YAAY,IAAY,EAAE,OAAe,EAAE,SAAiB,GAAG,EAAE,OAAiB;QAC9E,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IAC3B,CAAC;CACJ"}

package/package.json

@@ -0,0 +1,56 @@
+{
+    "name": "@jabrod/sdk",
+    "version": "1.0.8",
+    "description": "Official SDK for Jabrod Cloud API - RAG as a Service",
+    "type": "module",
+    "main": "./dist/index.js",
+    "module": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+        ".": {
+            "import": "./dist/index.js",
+            "types": "./dist/index.d.ts"
+        }
+    },
+    "files": [
+        "dist",
+        "README.md"
+    ],
+    "scripts": {
+        "build": "tsc",
+        "dev": "tsc --watch",
+        "prepublishOnly": "npm run build",
+        "test": "echo \"No tests yet\""
+    },
+    "keywords": [
+        "jabrod",
+        "rag",
+        "ai",
+        "knowledge-base",
+        "embeddings",
+        "llm",
+        "openai",
+        "vector-database"
+    ],
+    "author": "Jabrod",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/jabrod/sdk"
+    },
+    "homepage": "https://docs.jabrod.com",
+    "devDependencies": {
+        "typescript": "^5.3.3"
+    },
+    "peerDependencies": {
+        "typescript": ">=4.7"
+    },
+    "peerDependenciesMeta": {
+        "typescript": {
+            "optional": true
+        }
+    },
+    "engines": {
+        "node": ">=18"
+    }
+}