epist 0.1.0 → 0.1.1

package/README.md

@@ -1,33 +1,45 @@
-# epist
+# Epist JavaScript SDK
 
-Official JavaScript/TypeScript SDK for the Epist.ai Audio RAG Platform.
+The official JavaScript/TypeScript client library for the [Epist.ai](https://epist.ai) Audio RAG Platform.
 
-## Installation
+## 📦 Installation
 
 ```bash
 npm install epist
+# or
+yarn add epist
 ```
 
-## Usage
+## 🚀 Quick Start
 
 ```typescript
 import { Epist } from 'epist';
 
 const client = new Epist({
-    apiKey: 'YOUR_API_KEY',
-    // Optional: baseUrl: 'https://api.epist.ai/v1' 
+  apiKey: process.env.EPIST_API_KEY,
 });
 
-// 1. Upload Audio
-const upload = await client.uploadFile(fileInputElement.files[0]);
-console.log('Task ID:', upload.id);
+// 1. Upload and Transcribe
+const audio = await client.uploadFile(file);
+console.log(`Processing: ${audio.id}`);
 
-// 2. Transcribe from URL
-const task = await client.transcribeUrl('https://example.com/audio.mp3');
+// 2. Semantic Search
+const results = await client.search('What were the key takeaways?');
+results.forEach(res => {
+  console.log(`[${res.timestamp}] ${res.text}`);
+});
 
-// 3. Search
-const results = await client.search('deployment issues');
-results.forEach(r => {
-    console.log(`[${r.score}] ${r.text}`);
+// 3. RAG Chat
+const chat = await client.chat.completions.create({
+  messages: [{ role: 'user', content: 'Summarize the audio' }],
 });
+console.log(chat.choices[0].message.content);
 ```
+
+## 📖 Documentation
+
+For full API documentation and guides, visit [epist.ai/docs](https://epist.ai/docs).
+
+## 🛡️ License
+
+MIT

package/dist/cjs/index.d.ts

@@ -46,7 +46,7 @@ export declare class Epist {
     /**
      * Transcribe audio from a URL
      */
-    transcribeUrl(url: string, ragEnabled?: boolean, language?: string, preset?: string, chunkingConfig?: any): Promise<AudioStatus>;
+    transcribeUrl(url: string, ragEnabled?: boolean, language?: string, preset?: string, chunkingConfig?: any, webhookUrl?: string): Promise<AudioStatus>;
     /**
      * Get status of an audio task
      */
@@ -58,5 +58,5 @@ export declare class Epist {
     /**
      * Search the knowledge base
      */
-    search(query: string, limit?: number): Promise<SearchResult[]>;
+    search(query: string, limit?: number, options?: Record<string, any>): Promise<SearchResult[]>;
 }

package/dist/cjs/index.js

@@ -57,15 +57,19 @@ class Epist {
     /**
      * Transcribe audio from a URL
      */
-    async transcribeUrl(url, ragEnabled = true, language = 'en', preset = 'general', chunkingConfig = null) {
+    async transcribeUrl(url, ragEnabled = true, language = 'en', preset = 'general', chunkingConfig = null, webhookUrl) {
         try {
-            const response = await this.client.post('/audio/transcribe_url', {
+            const payload = {
                 audio_url: url,
                 rag_enabled: ragEnabled,
                 language,
                 preset,
                 chunking_config: chunkingConfig
-            });
+            };
+            if (webhookUrl) {
+                payload.webhook_url = webhookUrl;
+            }
+            const response = await this.client.post('/audio/transcribe_url', payload);
             return response.data;
         }
         catch (error) {
@@ -102,12 +106,14 @@ class Epist {
     /**
      * Search the knowledge base
      */
-    async search(query, limit = 10) {
+    async search(query, limit = 10, options) {
         try {
-            const response = await this.client.post('/search', {
+            const payload = {
                 query,
                 limit,
-            });
+                ...options
+            };
+            const response = await this.client.post('/search', payload);
             return response.data;
         }
         catch (error) {

package/dist/esm/index.js

@@ -50,15 +50,19 @@ export class Epist {
     /**
      * Transcribe audio from a URL
      */
-    async transcribeUrl(url, ragEnabled = true, language = 'en', preset = 'general', chunkingConfig = null) {
+    async transcribeUrl(url, ragEnabled = true, language = 'en', preset = 'general', chunkingConfig = null, webhookUrl) {
         try {
-            const response = await this.client.post('/audio/transcribe_url', {
+            const payload = {
                 audio_url: url,
                 rag_enabled: ragEnabled,
                 language,
                 preset,
                 chunking_config: chunkingConfig
-            });
+            };
+            if (webhookUrl) {
+                payload.webhook_url = webhookUrl;
+            }
+            const response = await this.client.post('/audio/transcribe_url', payload);
             return response.data;
         }
         catch (error) {
@@ -95,12 +99,14 @@ export class Epist {
     /**
      * Search the knowledge base
      */
-    async search(query, limit = 10) {
+    async search(query, limit = 10, options) {
         try {
-            const response = await this.client.post('/search', {
+            const payload = {
                 query,
                 limit,
-            });
+                ...options
+            };
+            const response = await this.client.post('/search', payload);
             return response.data;
         }
         catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "epist",
-    "version": "0.1.0",
+    "version": "0.1.1",
     "description": "Official JavaScript/TypeScript SDK for Epist.ai",
     "main": "dist/cjs/index.js",
     "module": "dist/esm/index.js",

package/src/index.ts

@@ -95,16 +95,21 @@ export class Epist {
         ragEnabled: boolean = true,
         language: string = 'en',
         preset: string = 'general',
-        chunkingConfig: any = null
+        chunkingConfig: any = null,
+        webhookUrl?: string
     ): Promise<AudioStatus> {
         try {
-            const response = await this.client.post('/audio/transcribe_url', {
+            const payload: any = {
                 audio_url: url,
                 rag_enabled: ragEnabled,
                 language,
                 preset,
                 chunking_config: chunkingConfig
-            });
+            };
+            if (webhookUrl) {
+                payload.webhook_url = webhookUrl;
+            }
+            const response = await this.client.post('/audio/transcribe_url', payload);
             return response.data;
         } catch (error) {
             this.handleError(error);
@@ -141,12 +146,14 @@ export class Epist {
     /**
      * Search the knowledge base
      */
-    async search(query: string, limit: number = 10): Promise<SearchResult[]> {
+    async search(query: string, limit: number = 10, options?: Record<string, any>): Promise<SearchResult[]> {
         try {
-            const response = await this.client.post('/search', {
+            const payload = {
                 query,
                 limit,
-            });
+                ...options
+            };
+            const response = await this.client.post('/search', payload);
             return response.data;
         } catch (error) {
             this.handleError(error);