epist 0.1.0

package/README.md

@@ -0,0 +1,33 @@
+# epist
+
+Official JavaScript/TypeScript SDK for the Epist.ai Audio RAG Platform.
+
+## Installation
+
+```bash
+npm install epist
+```
+
+## Usage
+
+```typescript
+import { Epist } from 'epist';
+
+const client = new Epist({
+    apiKey: 'YOUR_API_KEY',
+    // Optional: baseUrl: 'https://api.epist.ai/v1' 
+});
+
+// 1. Upload Audio
+const upload = await client.uploadFile(fileInputElement.files[0]);
+console.log('Task ID:', upload.id);
+
+// 2. Transcribe from URL
+const task = await client.transcribeUrl('https://example.com/audio.mp3');
+
+// 3. Search
+const results = await client.search('deployment issues');
+results.forEach(r => {
+    console.log(`[${r.score}] ${r.text}`);
+});
+```

package/dist/cjs/index.d.ts

@@ -0,0 +1,62 @@
+export interface EpistConfig {
+    apiKey: string;
+    baseUrl?: string;
+}
+export interface SearchResult {
+    id: string;
+    text: string;
+    start: number;
+    end: number;
+    score: number;
+    methods: string[];
+}
+export interface AudioStatus {
+    id: string;
+    status: 'pending' | 'processing' | 'completed' | 'failed';
+    title: string;
+    created_at: string;
+    error?: string;
+}
+export interface TranscriptSegment {
+    id: string;
+    start: number;
+    end: number;
+    text: string;
+    speaker?: string;
+}
+export interface Transcript {
+    id: string;
+    text: string;
+    segments: TranscriptSegment[];
+}
+export declare class EpistError extends Error {
+    statusCode?: number | undefined;
+    originalError?: any | undefined;
+    constructor(message: string, statusCode?: number | undefined, originalError?: any | undefined);
+}
+export declare class Epist {
+    private client;
+    constructor(config: EpistConfig);
+    private handleError;
+    /**
+     * Upload a local file.
+     * @param file - File object (Browser) or fs.ReadStream (Node.js)
+     */
+    uploadFile(file: any, preset?: string): Promise<AudioStatus>;
+    /**
+     * Transcribe audio from a URL
+     */
+    transcribeUrl(url: string, ragEnabled?: boolean, language?: string, preset?: string, chunkingConfig?: any): Promise<AudioStatus>;
+    /**
+     * Get status of an audio task
+     */
+    getStatus(audioId: string): Promise<AudioStatus>;
+    /**
+     * Get full transcript
+     */
+    getTranscript(audioId: string): Promise<Transcript>;
+    /**
+     * Search the knowledge base
+     */
+    search(query: string, limit?: number): Promise<SearchResult[]>;
+}

package/dist/cjs/index.js

@@ -0,0 +1,119 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Epist = exports.EpistError = void 0;
+const axios_1 = __importDefault(require("axios"));
+class EpistError extends Error {
+    constructor(message, statusCode, originalError) {
+        super(message);
+        this.statusCode = statusCode;
+        this.originalError = originalError;
+        this.name = 'EpistError';
+    }
+}
+exports.EpistError = EpistError;
+class Epist {
+    constructor(config) {
+        this.client = axios_1.default.create({
+            baseURL: config.baseUrl || 'https://epist-api-staging-920152096400.us-central1.run.app/api/v1',
+            headers: {
+                'X-API-Key': config.apiKey,
+                // Do not set global Content-Type for all requests as it breaks multipart uploads
+            },
+        });
+    }
+    handleError(error) {
+        var _a, _b, _c;
+        if (axios_1.default.isAxiosError(error)) {
+            const message = ((_b = (_a = error.response) === null || _a === void 0 ? void 0 : _a.data) === null || _b === void 0 ? void 0 : _b.detail) || error.message;
+            throw new EpistError(message, (_c = error.response) === null || _c === void 0 ? void 0 : _c.status, error);
+        }
+        throw new EpistError(error instanceof Error ? error.message : 'Unknown error', undefined, error);
+    }
+    /**
+     * Upload a local file.
+     * @param file - File object (Browser) or fs.ReadStream (Node.js)
+     */
+    async uploadFile(file, preset = 'general') {
+        try {
+            // In Node 18+ and Browsers, FormData is global. 
+            const formData = new FormData();
+            formData.append('file', file);
+            formData.append('preset', preset);
+            const response = await this.client.post('/audio/upload', formData, {
+                headers: {
+                // Axios will set 'Content-Type': 'multipart/form-data; boundary=...' automatically
+                }
+            });
+            return response.data;
+        }
+        catch (error) {
+            this.handleError(error);
+            throw error; // unreachable
+        }
+    }
+    /**
+     * Transcribe audio from a URL
+     */
+    async transcribeUrl(url, ragEnabled = true, language = 'en', preset = 'general', chunkingConfig = null) {
+        try {
+            const response = await this.client.post('/audio/transcribe_url', {
+                audio_url: url,
+                rag_enabled: ragEnabled,
+                language,
+                preset,
+                chunking_config: chunkingConfig
+            });
+            return response.data;
+        }
+        catch (error) {
+            this.handleError(error);
+            throw error;
+        }
+    }
+    /**
+     * Get status of an audio task
+     */
+    async getStatus(audioId) {
+        try {
+            const response = await this.client.get(`/audio/${audioId}`);
+            return response.data;
+        }
+        catch (error) {
+            this.handleError(error);
+            throw error;
+        }
+    }
+    /**
+     * Get full transcript
+     */
+    async getTranscript(audioId) {
+        try {
+            const response = await this.client.get(`/audio/${audioId}/transcript`);
+            return response.data;
+        }
+        catch (error) {
+            this.handleError(error);
+            throw error;
+        }
+    }
+    /**
+     * Search the knowledge base
+     */
+    async search(query, limit = 10) {
+        try {
+            const response = await this.client.post('/search', {
+                query,
+                limit,
+            });
+            return response.data;
+        }
+        catch (error) {
+            this.handleError(error);
+            throw error;
+        }
+    }
+}
+exports.Epist = Epist;

package/dist/esm/index.js

@@ -0,0 +1,111 @@
+import axios from 'axios';
+export class EpistError extends Error {
+    constructor(message, statusCode, originalError) {
+        super(message);
+        this.statusCode = statusCode;
+        this.originalError = originalError;
+        this.name = 'EpistError';
+    }
+}
+export class Epist {
+    constructor(config) {
+        this.client = axios.create({
+            baseURL: config.baseUrl || 'https://epist-api-staging-920152096400.us-central1.run.app/api/v1',
+            headers: {
+                'X-API-Key': config.apiKey,
+                // Do not set global Content-Type for all requests as it breaks multipart uploads
+            },
+        });
+    }
+    handleError(error) {
+        var _a, _b, _c;
+        if (axios.isAxiosError(error)) {
+            const message = ((_b = (_a = error.response) === null || _a === void 0 ? void 0 : _a.data) === null || _b === void 0 ? void 0 : _b.detail) || error.message;
+            throw new EpistError(message, (_c = error.response) === null || _c === void 0 ? void 0 : _c.status, error);
+        }
+        throw new EpistError(error instanceof Error ? error.message : 'Unknown error', undefined, error);
+    }
+    /**
+     * Upload a local file.
+     * @param file - File object (Browser) or fs.ReadStream (Node.js)
+     */
+    async uploadFile(file, preset = 'general') {
+        try {
+            // In Node 18+ and Browsers, FormData is global. 
+            const formData = new FormData();
+            formData.append('file', file);
+            formData.append('preset', preset);
+            const response = await this.client.post('/audio/upload', formData, {
+                headers: {
+                // Axios will set 'Content-Type': 'multipart/form-data; boundary=...' automatically
+                }
+            });
+            return response.data;
+        }
+        catch (error) {
+            this.handleError(error);
+            throw error; // unreachable
+        }
+    }
+    /**
+     * Transcribe audio from a URL
+     */
+    async transcribeUrl(url, ragEnabled = true, language = 'en', preset = 'general', chunkingConfig = null) {
+        try {
+            const response = await this.client.post('/audio/transcribe_url', {
+                audio_url: url,
+                rag_enabled: ragEnabled,
+                language,
+                preset,
+                chunking_config: chunkingConfig
+            });
+            return response.data;
+        }
+        catch (error) {
+            this.handleError(error);
+            throw error;
+        }
+    }
+    /**
+     * Get status of an audio task
+     */
+    async getStatus(audioId) {
+        try {
+            const response = await this.client.get(`/audio/${audioId}`);
+            return response.data;
+        }
+        catch (error) {
+            this.handleError(error);
+            throw error;
+        }
+    }
+    /**
+     * Get full transcript
+     */
+    async getTranscript(audioId) {
+        try {
+            const response = await this.client.get(`/audio/${audioId}/transcript`);
+            return response.data;
+        }
+        catch (error) {
+            this.handleError(error);
+            throw error;
+        }
+    }
+    /**
+     * Search the knowledge base
+     */
+    async search(query, limit = 10) {
+        try {
+            const response = await this.client.post('/search', {
+                query,
+                limit,
+            });
+            return response.data;
+        }
+        catch (error) {
+            this.handleError(error);
+            throw error;
+        }
+    }
+}

package/package.json

@@ -0,0 +1,33 @@
+{
+    "name": "epist",
+    "version": "0.1.0",
+    "description": "Official JavaScript/TypeScript SDK for Epist.ai",
+    "main": "dist/cjs/index.js",
+    "module": "dist/esm/index.js",
+    "types": "dist/cjs/index.d.ts",
+    "exports": {
+        ".": {
+            "import": "./dist/esm/index.js",
+            "require": "./dist/cjs/index.js",
+            "types": "./dist/cjs/index.d.ts"
+        }
+    },
+    "scripts": {
+        "build": "tsc && tsc -p tsconfig.esm.json",
+        "prepublishOnly": "npm run build"
+    },
+    "keywords": [
+        "epist",
+        "audio",
+        "rag",
+        "sdk"
+    ],
+    "author": "Epist Team",
+    "license": "MIT",
+    "devDependencies": {
+        "typescript": "^5.0.0"
+    },
+    "dependencies": {
+        "axios": "^1.6.0"
+    }
+}

package/src/index.ts

@@ -0,0 +1,157 @@
+import axios, { AxiosInstance, AxiosError } from 'axios';
+
+export interface EpistConfig {
+    apiKey: string;
+    baseUrl?: string;
+}
+
+export interface SearchResult {
+    id: string;
+    text: string;
+    start: number;
+    end: number;
+    score: number;
+    methods: string[];
+}
+
+export interface AudioStatus {
+    id: string;
+    status: 'pending' | 'processing' | 'completed' | 'failed';
+    title: string;
+    created_at: string;
+    error?: string;
+}
+
+export interface TranscriptSegment {
+    id: string;
+    start: number;
+    end: number;
+    text: string;
+    speaker?: string;
+}
+
+export interface Transcript {
+    id: string;
+    text: string;
+    segments: TranscriptSegment[];
+}
+
+export class EpistError extends Error {
+    constructor(message: string, public statusCode?: number, public originalError?: any) {
+        super(message);
+        this.name = 'EpistError';
+    }
+}
+
+export class Epist {
+    private client: AxiosInstance;
+
+    constructor(config: EpistConfig) {
+        this.client = axios.create({
+            baseURL: config.baseUrl || 'https://epist-api-staging-920152096400.us-central1.run.app/api/v1',
+            headers: {
+                'X-API-Key': config.apiKey,
+                // Do not set global Content-Type for all requests as it breaks multipart uploads
+            },
+        });
+    }
+
+    private handleError(error: unknown) {
+        if (axios.isAxiosError(error)) {
+            const message = error.response?.data?.detail || error.message;
+            throw new EpistError(message, error.response?.status, error);
+        }
+        throw new EpistError(error instanceof Error ? error.message : 'Unknown error', undefined, error);
+    }
+
+    /**
+     * Upload a local file.
+     * @param file - File object (Browser) or fs.ReadStream (Node.js)
+     */
+    async uploadFile(file: any, preset: string = 'general'): Promise<AudioStatus> {
+        try {
+            // In Node 18+ and Browsers, FormData is global. 
+            const formData = new FormData();
+            formData.append('file', file);
+            formData.append('preset', preset);
+
+            const response = await this.client.post('/audio/upload', formData, {
+                headers: {
+                    // Axios will set 'Content-Type': 'multipart/form-data; boundary=...' automatically
+                }
+            });
+            return response.data;
+        } catch (error) {
+            this.handleError(error);
+            throw error; // unreachable
+        }
+    }
+
+    /**
+     * Transcribe audio from a URL
+     */
+    async transcribeUrl(
+        url: string,
+        ragEnabled: boolean = true,
+        language: string = 'en',
+        preset: string = 'general',
+        chunkingConfig: any = null
+    ): Promise<AudioStatus> {
+        try {
+            const response = await this.client.post('/audio/transcribe_url', {
+                audio_url: url,
+                rag_enabled: ragEnabled,
+                language,
+                preset,
+                chunking_config: chunkingConfig
+            });
+            return response.data;
+        } catch (error) {
+            this.handleError(error);
+            throw error;
+        }
+    }
+
+    /**
+     * Get status of an audio task
+     */
+    async getStatus(audioId: string): Promise<AudioStatus> {
+        try {
+            const response = await this.client.get(`/audio/${audioId}`);
+            return response.data;
+        } catch (error) {
+            this.handleError(error);
+            throw error;
+        }
+    }
+
+    /**
+     * Get full transcript
+     */
+    async getTranscript(audioId: string): Promise<Transcript> {
+        try {
+            const response = await this.client.get(`/audio/${audioId}/transcript`);
+            return response.data;
+        } catch (error) {
+            this.handleError(error);
+            throw error;
+        }
+    }
+
+    /**
+     * Search the knowledge base
+     */
+    async search(query: string, limit: number = 10): Promise<SearchResult[]> {
+        try {
+            const response = await this.client.post('/search', {
+                query,
+                limit,
+            });
+            return response.data;
+        } catch (error) {
+            this.handleError(error);
+            throw error;
+        }
+    }
+}
+

package/tsconfig.esm.json

@@ -0,0 +1,12 @@
+{
+    "extends": "./tsconfig.json",
+    "compilerOptions": {
+        "module": "esnext",
+        "moduleResolution": "bundler",
+        "outDir": "./dist/esm",
+        "declaration": false
+    },
+    "include": [
+        "src/**/*"
+    ]
+}

package/tsconfig.json

@@ -0,0 +1,20 @@
+{
+    "compilerOptions": {
+        "target": "es2018",
+        "module": "commonjs",
+        "lib": [
+            "es2018",
+            "dom"
+        ],
+        "declaration": true,
+        "outDir": "./dist/cjs",
+        "strict": true,
+        "moduleResolution": "node",
+        "esModuleInterop": true,
+        "skipLibCheck": true,
+        "forceConsistentCasingInFileNames": true
+    },
+    "include": [
+        "src/**/*"
+    ]
+}