@premai/api-sdk 1.0.29

package/dist/models/index.d.ts

@@ -0,0 +1,5 @@
+import type { ListModelsParams, ListModelsResponse } from "../types";
+export interface ModelsClient {
+    list: (params?: ListModelsParams) => Promise<ListModelsResponse["data"]>;
+}
+export declare function createModelsClient(apiKey: string, timeoutMs?: number): ModelsClient;

package/dist/rvenc/index.d.ts

@@ -0,0 +1,4 @@
+import OpenAI, { type ClientOptions } from "openai";
+import type { EncryptionKeys } from "../types";
+export declare function createRvencChatClient(apiKey: string, encryptionKeys: EncryptionKeys, requestTimeoutMs: number | undefined, maxBufferSize: number | undefined, attest: boolean | undefined, OpenAIClientParams: ClientOptions): OpenAI;
+export declare function createDecryptedStreamGenerator(reader: ReadableStreamDefaultReader<Uint8Array>, sharedSecret: Uint8Array, nonce: Uint8Array, maxBufferSize: number): AsyncGenerator<OpenAI.Chat.Completions.ChatCompletionChunk, void, unknown>;

package/dist/server.d.ts

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import type { ServerOptions } from './types';
+declare const app: import("express-serve-static-core").Express;
+export declare function startServer(options?: ServerOptions): Promise<void>;
+export default app;

package/dist/tools/index.d.ts

@@ -0,0 +1,23 @@
+import type { AudioDiarizationDecrypted, AudioDiarizationParams, AudioGenerateFromTextParams, CreateFileParams, DataFileContentDecrypted, DEKStore, DecryptedFile, GenerateImageParams, GetDataFileContentParams, GetFileContentOCRParams, GetPDFContentParams, GetSpreadsheetContentParams, GetTextDocumentContentParams, GetTimeDecrypted, GetTimeParams, ImageDescribeAndCaptionFallbackParams, ImageDescribeAndCaptionParams, PDFContentDecrypted, PowerPointContentDecrypted, PowerPointParams, SearchRagParams, SpreadsheetContentDecrypted, TextDocumentContentDecrypted, TranscribeAudioDecrypted, TranscribeParams, TranscribeWithDiarizationDecrypted, VideoDescribeAndCaptionParams, WebScraperParams, WebSearchParams } from '../types';
+export interface ToolsClient {
+    generateImage: (params: GenerateImageParams) => Promise<DecryptedFile>;
+    audioGenerateFromText: (params: AudioGenerateFromTextParams) => Promise<DecryptedFile>;
+    createFileForUser: (params: CreateFileParams) => Promise<DecryptedFile>;
+    imageDescribeAndCaption: (params: ImageDescribeAndCaptionParams) => Promise<string>;
+    imageDescribeAndCaptionFallback: (params: ImageDescribeAndCaptionFallbackParams) => Promise<string>;
+    videoDescribeAndCaption: (params: VideoDescribeAndCaptionParams) => Promise<string>;
+    getPDFContent: (params: GetPDFContentParams) => Promise<PDFContentDecrypted>;
+    getTextDocumentContent: (params: GetTextDocumentContentParams) => Promise<TextDocumentContentDecrypted>;
+    transcribeAudioToText: (params: TranscribeParams) => Promise<TranscribeAudioDecrypted>;
+    transcribeAudioWithDiarization: (params: TranscribeParams) => Promise<TranscribeWithDiarizationDecrypted>;
+    audioDiarization: (params: AudioDiarizationParams) => Promise<AudioDiarizationDecrypted>;
+    getFileContentOCR: (params: GetFileContentOCRParams) => Promise<string>;
+    getSpreadsheetContent: (params: GetSpreadsheetContentParams) => Promise<SpreadsheetContentDecrypted>;
+    getDataFileContent: (params: GetDataFileContentParams) => Promise<DataFileContentDecrypted>;
+    getPowerPointContent: (params: PowerPointParams) => Promise<PowerPointContentDecrypted>;
+    getTime: (params: GetTimeParams) => Promise<GetTimeDecrypted>;
+    webSearchTool: (params: WebSearchParams) => Promise<string>;
+    webPageScraperTool: (params: WebScraperParams) => Promise<string>;
+    searchRag: (params: SearchRagParams) => Promise<string>;
+}
+export declare function createToolsClient(apiKey: string, dekStore: DEKStore, clientKEK?: string, timeoutMs?: number, attest?: boolean): ToolsClient;

package/dist/types.d.ts

@@ -0,0 +1,364 @@
+export interface EncryptionKeys {
+    sharedSecret: Uint8Array;
+    cipherText: Uint8Array;
+}
+export interface ApiErrorResponse {
+    status: number;
+    data: null;
+    error: string | null;
+    message: string | null;
+    env?: string;
+    log?: string | null;
+    validator?: unknown;
+    support_id?: string | null;
+}
+export interface DEKStore {
+    fileDEKs?: Map<string, Uint8Array>;
+    ragDEK?: Uint8Array;
+    ragVersion?: string;
+}
+export interface FileUploadOptions {
+    file: Uint8Array;
+    fileName: string;
+    mimeType?: string;
+    ragIndex?: boolean;
+}
+export interface UploadedFile {
+    id: string;
+    version: string;
+    kid: string;
+    wrapped_dek: string;
+    original_name: string;
+    file_name: string;
+    file_path: string;
+    file_size: number;
+    is_duplicate: boolean;
+    type: string;
+    mime_type: string;
+    created_at: string;
+    updated_at: string | null;
+}
+export interface EncryptedResponse {
+    encryptedResponse: string;
+    nonce: string;
+}
+export interface EncryptedResponseData {
+    data: EncryptedResponse;
+}
+export interface UploadedFileResponse {
+    status: number;
+    data: UploadedFile;
+    error?: string;
+}
+export interface DecryptedFile {
+    fileId?: string;
+    fileName: string;
+    mimeType: string;
+    content: Uint8Array;
+    fileSize: number;
+}
+export interface FileMetadata {
+    id: string;
+    user_id: string;
+    organization_id: string;
+    hash: string;
+    version: string;
+    kid: string;
+    wrapped_dek: string;
+    original_name: string;
+    file_name: string;
+    file_path: string;
+    mime_type: string;
+    file_size: number;
+    type: string;
+    created_at: string;
+    updated_at: string | null;
+    rag_status: string | null;
+    url: string;
+    is_duplicate?: boolean;
+}
+export interface ListFilesOptions {
+    limit?: number;
+    offset?: number;
+    search?: string;
+    from?: string;
+    to?: string;
+}
+export interface PaginationInfo {
+    total: number;
+    page: number;
+    limit: number;
+    pages: number;
+}
+export interface ListFilesResponse {
+    status: number;
+    data: {
+        files: FileMetadata[];
+        pagination: PaginationInfo;
+    };
+    error?: string;
+}
+export interface GetFileOptions {
+    id: string;
+    url?: boolean;
+}
+export interface DeleteFileOptions {
+    id: string;
+}
+export interface DeleteFileResponse {
+    message: string;
+}
+export interface IndexFileInput {
+    fileId: string;
+    filePath: string;
+    fileDEK?: Uint8Array;
+}
+export interface IndexFilesOptions {
+    files: IndexFileInput[];
+    ragDEK?: Uint8Array;
+}
+export interface IndexFilesResponse {
+    data: {
+        results: Array<{
+            file_id: string;
+            rag_status: 'running' | 'stopped' | 'failure' | 'success' | null;
+            success: boolean;
+            error?: string;
+        }>;
+        enclave_response?: Record<string, unknown>;
+    };
+}
+export interface DeleteIndexOptions {
+    fileIds: string[];
+    ragDEK?: Uint8Array;
+}
+export interface DeleteIndexResponse {
+    data: {
+        results: Array<{
+            file_id: string;
+            success: boolean;
+            error?: string;
+        }>;
+        enclave_response?: Record<string, unknown>;
+    };
+}
+export interface GenerateImageParams {
+    prompt: string;
+}
+export interface AudioGenerateFromTextParams {
+    text: string;
+}
+export interface ImageDescribeAndCaptionParams {
+    fileId: string;
+}
+export interface ImageDescribeAndCaptionFallbackParams {
+    fileId: string;
+}
+export interface VideoDescribeAndCaptionParams {
+    fileId: string;
+}
+export interface GetPDFContentParams {
+    fileId: string;
+}
+export interface GetTextDocumentContentParams {
+    fileId: string;
+}
+export interface GetSpreadsheetContentParams {
+    fileId: string;
+}
+export interface GetDataFileContentParams {
+    fileId: string;
+}
+export interface GetPowerPointContentParams {
+    fileId: string;
+    slideNumbers?: number[];
+}
+export interface GetTimeParams {
+    timezone: string;
+}
+export interface SearchRagParams {
+    query: string;
+}
+export interface GetFileContentOCRParams {
+    fileId: string;
+}
+export interface AudioDiarizationParams {
+    fileId: string;
+}
+export interface CreateFileParams {
+    fileName: string;
+    fileExtension: string;
+    fileContent: string;
+    mimeType: string;
+}
+export interface TranscribeParams {
+    fileId: string;
+    language?: string;
+}
+export interface PowerPointParams {
+    fileId: string;
+    slideNumbers?: number[];
+}
+export interface WebSearchParams {
+    query: string;
+    country?: string;
+    searchLang?: string;
+}
+export interface WebScraperParams {
+    url: string;
+    renderJs?: boolean;
+}
+export interface GetFileResponse {
+    status: number;
+    data: FileMetadata;
+    error?: string;
+}
+export interface FileOutputResponse {
+    fileId: string;
+    fileName: string;
+    fileSize: number;
+    handle: string;
+    mimeType: string;
+    s3Path: string;
+    success: boolean;
+    message?: string;
+}
+export interface EncryptedToolResponse {
+    encryptedResponse: string;
+    nonce: string;
+    _decryptedResponse?: unknown;
+}
+export interface GetTimeDecrypted {
+    now: string;
+    timezone: string;
+}
+export interface PDFContentDecrypted {
+    chunks: Array<{
+        pageContent: string;
+        metadata: Record<string, unknown>;
+    }>;
+}
+export interface TextDocumentContentDecrypted {
+    content: string;
+    chunks?: Array<{
+        pageContent: string;
+        metadata: Record<string, unknown>;
+    }>;
+    format: string;
+    wordCount?: number;
+    error?: string;
+}
+export interface TranscribeAudioDecrypted {
+    text: string;
+    segments?: Array<{
+        id: number;
+        start: number;
+        end: number;
+        text: string;
+    }>;
+    language?: string;
+}
+export interface TranscribeWithDiarizationDecrypted {
+    segments: Array<{
+        speaker: string;
+        start: number;
+        end: number;
+        text: string;
+    }>;
+    speakers: string[];
+    totalDuration?: number;
+    totalWords?: number;
+    detectedLanguage?: string;
+}
+export interface SpreadsheetContentDecrypted {
+    format: 'csv' | 'xlsx';
+    data?: unknown[][];
+    sheets?: Array<{
+        name: string;
+        data: unknown[][];
+        preview?: string;
+    }>;
+    preview?: string;
+    rowCount: number;
+    columnCount: number;
+    error?: string;
+}
+export interface DataFileContentDecrypted {
+    format: 'json' | 'xml';
+    content: string;
+    summary?: {
+        type?: string;
+        length?: number;
+        keys?: string[];
+        keyCount?: number;
+        rootTag?: string;
+        elementCount?: number;
+    };
+    error?: string;
+}
+export interface PowerPointContentDecrypted {
+    slides: Array<{
+        slideNumber: number;
+        text: string;
+        notes?: string;
+        hasImages?: boolean;
+        imageCount?: number;
+        recommendedOcr?: boolean;
+        textLength?: number;
+    }>;
+    totalSlides: number;
+    format: string;
+    formattedContent: string;
+    ocrSummary?: {
+        slidesNeedingOcr?: number;
+        slidesWithImages?: number;
+        slidesWithMinimalText?: number;
+    };
+    error?: string;
+}
+export interface AudioDiarizationDecrypted {
+    speakers: Array<{
+        speaker: string;
+        segments: unknown[];
+    }>;
+}
+export type ExecuteToolResponse = FileOutputResponse | EncryptedToolResponse;
+export interface ExecuteToolResponseWrapper {
+    status: number;
+    data: ExecuteToolResponse;
+    error?: string;
+}
+export type ServerOptions = {
+    host?: string;
+    port?: number;
+    proxyUrl?: string;
+    enclaveUrl?: string;
+    kek?: string;
+    attest?: boolean;
+};
+export interface ListModelsParams {
+    type?: string;
+}
+export interface ModelPriceConfig {
+    prompt_price_per_k: number;
+    audio_price_per_min: number;
+    reasoning_price_per_k: number;
+    completion_price_per_k: number;
+}
+export interface Model {
+    id: number;
+    name: string;
+    description: string;
+    model: string;
+    type: string;
+    enabled: number;
+    input_modalities: string[];
+    price_config: ModelPriceConfig | null;
+    created_at: string;
+    requires_auth: number;
+}
+export interface ListModelsResponse {
+    status: number;
+    data: Model[];
+    error?: string;
+}

package/dist/utils/attestation.d.ts

@@ -0,0 +1,15 @@
+import { GatewayError } from "@premai/prem-rs";
+type AttestationError = Error & {
+    cause: string[];
+    kind?: GatewayError;
+};
+export declare function isAttestationError(err: unknown): err is AttestationError;
+export declare function isGatewayError(err: unknown): err is AttestationError & {
+    kind: GatewayError;
+};
+export declare function getGatewayErrorMessage(err: unknown): string | null;
+export declare function attest(apiKey: string, options?: {
+    model?: string;
+    enabled: boolean;
+}): Promise<string | null>;
+export {};

package/dist/utils/crypto.d.ts

@@ -0,0 +1,20 @@
+import type { EncryptionKeys } from '../types';
+export declare function createMLKEMEncapsulation(publicKeyHex: string): EncryptionKeys;
+export declare function encryptPayload(sharedSecret: Uint8Array, data: Uint8Array | string | object): {
+    encrypted: Uint8Array;
+    nonce: Uint8Array;
+};
+export declare function decryptPayload<T>(encryptedData: string, sharedSecret: Uint8Array, nonce: Uint8Array): T;
+export declare function getEnclavePublicKey(timeoutMs?: number): Promise<string>;
+export declare function generateEncryptionKeys(timeoutMs?: number): Promise<EncryptionKeys>;
+export declare function keyIdFromKEK(kek: Uint8Array, context?: string, length?: number): Uint8Array;
+export declare function encryptWithDEK(dek: Uint8Array, plaintext: Uint8Array): Uint8Array;
+export declare function encryptMetadataWithDEK(dek: Uint8Array, metadata: string): string;
+export declare function wrapDEK(kek: Uint8Array, dek: Uint8Array): Uint8Array;
+export declare function unwrapDEK(kek: Uint8Array, wrappedDEK: Uint8Array): Uint8Array;
+export declare function decryptWithDEK(dek: Uint8Array, encryptedContent: Uint8Array): Uint8Array;
+export declare function generateKidAndWrappedDEK(publicKeyHex: string, dek: Uint8Array, sharedSecret: Uint8Array): {
+    kid: string;
+    wrappedDEK: string;
+    wrappedDEKNonce: string;
+};

package/dist/utils/dek-store.d.ts

@@ -0,0 +1,7 @@
+import type { DEKStore } from '../types';
+export declare function initializeDEKStore(clientKEK?: string): DEKStore;
+export declare function serializeDEKStore(store: DEKStore): string;
+export declare function deserializeDEKStore(serialized: string): DEKStore;
+export declare function getClientKEK(): Uint8Array;
+export declare function getClientKID(clientKEK?: string): string;
+export declare function generateNewClientKEK(): string;

package/dist/utils/error.d.ts

@@ -0,0 +1 @@
+export declare function throwIfErrorResponse(response: Response): Promise<never>;

package/dist/utils/files.d.ts

@@ -0,0 +1,2 @@
+import type { Uploadable } from "openai/uploads";
+export declare const getFileName: (file: Uploadable) => string | undefined;

package/package.json

@@ -0,0 +1,62 @@
+{
+    "repository": {
+        "url": "https://github.com/premai-io/api-sdk-ts"
+    },
+    "homepage": "https://github.com/premai-io/api-sdk-ts",
+    "name": "@premai/api-sdk",
+    "version": "1.0.29",
+    "main": "./dist/index.cjs",
+    "bin": {
+        "pcci-proxy": "./dist/cli.cjs"
+    },
+    "keywords": [],
+    "author": "",
+    "license": "ISC",
+    "description": "",
+    "exports": {
+        ".": {
+            "node": "./dist/index.cjs",
+            "require": "./dist/index.cjs",
+            "import": "./dist/index.mjs",
+            "types": "./dist/index.d.ts"
+        },
+        "./browser": {
+            "require": "./dist/core.browser.cjs",
+            "import": "./dist/core.browser.mjs",
+            "types": "./dist/index.d.ts"
+        }
+    },
+    "files": [
+        "./dist",
+        "README.md"
+    ],
+    "scripts": {
+        "dev": "bun run script.ts",
+        "build": "bun run types && bun scripts/build.ts",
+        "types": "tsc --emitDeclarationOnly",
+        "server": "bun run src/server.ts"
+    },
+    "dependencies": {
+        "@deepgram/sdk": "^5.0.0",
+        "@noble/ciphers": "^2.1.1",
+        "@noble/curves": "^1.8.1",
+        "@noble/hashes": "^1.7.1",
+        "@noble/post-quantum": "^0.5.2",
+        "@premai/prem-rs": "0.3.0",
+        "date-fns": "^4.1.0",
+        "dotenv": "^17.2.3",
+        "express": "^4.18.2",
+        "multer": "^2.0.2",
+        "openai": "^6.9.1",
+        "typescript": "^5.9.3",
+        "zod": "^4.2.1"
+    },
+    "devDependencies": {
+        "@biomejs/biome": "2.3.10",
+        "@types/express": "^4.17.21",
+        "@types/multer": "^2.0.0",
+        "@types/bun": "^1.3.6",
+        "@types/node": "^22.15.21",
+        "ts-node": "^10.9.2"
+    }
+}