dvgateway-sdk 1.0.0

package/dist/transport/ws-pool.d.ts

@@ -0,0 +1,34 @@
+/**
+ * WebSocket Connection Pool
+ *
+ * Manages WebSocket connections with:
+ * - Automatic reconnection (exponential backoff with jitter)
+ * - Active subscription restoration after reconnect
+ * - Proper cleanup on close
+ */
+import { EventEmitter } from 'events';
+import type { ReconnectOptions, Logger } from '../types/index.js';
+import type { AuthManager } from '../auth/manager.js';
+export interface WsSubscription {
+    readonly id: string;
+    readonly path: string;
+    readonly params: Record<string, string>;
+    readonly onMessage: (data: Buffer) => void;
+    readonly onClose?: () => void;
+}
+export declare class WsPool extends EventEmitter {
+    private readonly auth;
+    private readonly reconnect;
+    private readonly logger;
+    private readonly connections;
+    constructor(auth: AuthManager, reconnect: ReconnectOptions, logger: Logger);
+    /** Open a managed WebSocket connection for a subscription */
+    subscribe(sub: WsSubscription): Promise<void>;
+    /** Close a specific subscription */
+    unsubscribe(id: string): void;
+    /** Close all connections */
+    closeAll(): void;
+    private connect;
+    private scheduleReconnect;
+}
+//# sourceMappingURL=ws-pool.d.ts.map

package/dist/transport/ws-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-pool.d.ts","sourceRoot":"","sources":["../../src/transport/ws-pool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CAC/B;AAUD,qBAAa,MAAO,SAAQ,YAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAc;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;IACvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAwC;gBAExD,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM;IAc1E,6DAA6D;IACvD,SAAS,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAYnD,oCAAoC;IACpC,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAa7B,4BAA4B;IAC5B,QAAQ,IAAI,IAAI;YAMF,OAAO;IA+CrB,OAAO,CAAC,iBAAiB;CA+B1B"}

package/dist/transport/ws-pool.js

@@ -0,0 +1,123 @@
+/**
+ * WebSocket Connection Pool
+ *
+ * Manages WebSocket connections with:
+ * - Automatic reconnection (exponential backoff with jitter)
+ * - Active subscription restoration after reconnect
+ * - Proper cleanup on close
+ */
+import { EventEmitter } from 'events';
+import WebSocket from 'ws';
+export class WsPool extends EventEmitter {
+    auth;
+    reconnect;
+    logger;
+    connections = new Map();
+    constructor(auth, reconnect, logger) {
+        super();
+        this.auth = auth;
+        this.logger = logger;
+        this.reconnect = {
+            maxAttempts: reconnect.maxAttempts ?? 10,
+            initialDelayMs: reconnect.initialDelayMs ?? 2000,
+            maxDelayMs: reconnect.maxDelayMs ?? 30_000,
+            backoffMultiplier: reconnect.backoffMultiplier ?? 2.0,
+            onReconnect: reconnect.onReconnect ?? (() => undefined),
+            onMaxAttemptsReached: reconnect.onMaxAttemptsReached ?? (() => undefined),
+        };
+    }
+    /** Open a managed WebSocket connection for a subscription */
+    async subscribe(sub) {
+        const conn = {
+            ws: null,
+            subscription: sub,
+            reconnectAttempts: 0,
+            closed: false,
+            reconnectTimer: null,
+        };
+        this.connections.set(sub.id, conn);
+        await this.connect(conn);
+    }
+    /** Close a specific subscription */
+    unsubscribe(id) {
+        const conn = this.connections.get(id);
+        if (!conn)
+            return;
+        conn.closed = true;
+        if (conn.reconnectTimer)
+            clearTimeout(conn.reconnectTimer);
+        if (conn.ws) {
+            conn.ws.removeAllListeners();
+            conn.ws.close(1000, 'unsubscribed');
+        }
+        this.connections.delete(id);
+        this.logger.debug({ id }, 'WebSocket subscription closed');
+    }
+    /** Close all connections */
+    closeAll() {
+        for (const id of this.connections.keys()) {
+            this.unsubscribe(id);
+        }
+    }
+    async connect(conn) {
+        if (conn.closed)
+            return;
+        let url;
+        try {
+            url = await this.auth.buildWsUrl(conn.subscription.path, conn.subscription.params);
+        }
+        catch (err) {
+            this.logger.error({ err, id: conn.subscription.id }, 'Failed to build WebSocket URL');
+            this.scheduleReconnect(conn);
+            return;
+        }
+        this.logger.debug({ id: conn.subscription.id, path: conn.subscription.path }, 'Opening WebSocket');
+        const ws = new WebSocket(url, {
+            handshakeTimeout: 10_000,
+        });
+        conn.ws = ws;
+        ws.on('open', () => {
+            conn.reconnectAttempts = 0;
+            this.logger.debug({ id: conn.subscription.id }, 'WebSocket connected');
+            this.emit('connected', conn.subscription.id);
+        });
+        ws.on('message', (data) => {
+            const buf = Buffer.isBuffer(data) ? data : Buffer.from(data);
+            conn.subscription.onMessage(buf);
+        });
+        ws.on('close', (code, reason) => {
+            if (conn.closed)
+                return;
+            this.logger.warn({ id: conn.subscription.id, code, reason: reason.toString() }, 'WebSocket closed unexpectedly');
+            conn.subscription.onClose?.();
+            this.scheduleReconnect(conn);
+        });
+        ws.on('error', (err) => {
+            this.logger.error({ id: conn.subscription.id, err }, 'WebSocket error');
+            // 'error' always precedes 'close', so reconnect is handled in 'close' handler
+        });
+    }
+    scheduleReconnect(conn) {
+        if (conn.closed)
+            return;
+        if (conn.reconnectAttempts >= this.reconnect.maxAttempts) {
+            this.logger.error({ id: conn.subscription.id, attempts: conn.reconnectAttempts }, 'Max reconnect attempts reached');
+            this.reconnect.onMaxAttemptsReached();
+            this.emit('maxAttemptsReached', conn.subscription.id);
+            return;
+        }
+        const jitter = Math.random() * 0.3; // ±30% jitter
+        const base = this.reconnect.initialDelayMs *
+            Math.pow(this.reconnect.backoffMultiplier, conn.reconnectAttempts);
+        const delay = Math.min(base * (1 + jitter), this.reconnect.maxDelayMs);
+        conn.reconnectAttempts++;
+        this.logger.info({ id: conn.subscription.id, attempt: conn.reconnectAttempts, delayMs: Math.round(delay) }, 'Scheduling WebSocket reconnect');
+        conn.reconnectTimer = setTimeout(() => {
+            conn.reconnectTimer = null;
+            this.reconnect.onReconnect(conn.reconnectAttempts);
+            this.emit('reconnecting', conn.subscription.id, conn.reconnectAttempts);
+            void this.connect(conn);
+        }, delay);
+    }
+}
+//# sourceMappingURL=ws-pool.js.map

package/dist/transport/ws-pool.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,378 @@
+/**
+ * DVGateway SDK — Public Type Definitions
+ *
+ * Core types for interacting with the DVGateway real-time voice media gateway.
+ * All adapters and pipeline components are built on these interfaces.
+ */
+export interface ApiKeyAuth {
+    readonly type: 'apiKey';
+    readonly apiKey: string;
+}
+export interface JwtAuth {
+    readonly type: 'jwt';
+    readonly token: string;
+}
+export type Auth = ApiKeyAuth | JwtAuth;
+export interface ReconnectOptions {
+    /** Maximum number of reconnection attempts (default: 10) */
+    maxAttempts?: number;
+    /** Initial delay in ms (default: 2000) */
+    initialDelayMs?: number;
+    /** Maximum delay cap in ms (default: 30000) */
+    maxDelayMs?: number;
+    /** Backoff multiplier (default: 2.0) */
+    backoffMultiplier?: number;
+    /** Called on each successful reconnect */
+    onReconnect?: (attempt: number) => void;
+    /** Called when all attempts are exhausted */
+    onMaxAttemptsReached?: () => void;
+}
+export interface MtlsOptions {
+    cert: Buffer;
+    key: Buffer;
+    ca?: Buffer;
+}
+export interface SecurityOptions {
+    /** Automatically mask PII (phone numbers, names) in logs (default: true) */
+    maskPii?: boolean;
+    /** mTLS client certificate for enterprise environments */
+    mtls?: MtlsOptions;
+    /** Force TLS upgrade: ws:// → wss://, http:// → https:// (default: true) */
+    forceTls?: boolean;
+}
+export interface DVGatewayOptions {
+    /** Gateway server base URL (e.g. "https://gateway.example.com") */
+    readonly baseUrl: string;
+    /** Authentication credentials */
+    readonly auth: Auth;
+    /**
+     * Tenant identifier for multi-tenant deployments.
+     * When set, all API calls and event subscriptions are scoped to this tenant.
+     * Sent as X-Tenant-ID header on every request.
+     */
+    tenantId?: string;
+    /** WebSocket/HTTP request timeout in ms (default: 30000) */
+    timeout?: number;
+    /** Reconnection strategy */
+    reconnect?: ReconnectOptions;
+    /** Security options */
+    security?: SecurityOptions;
+    /** Custom logger (defaults to structured JSON logger) */
+    logger?: Logger;
+}
+/** Audio direction for a call stream */
+export type StreamDir = 'both' | 'in' | 'out';
+/** A 1:1 call session */
+export interface CallSession {
+    readonly linkedId: string;
+    readonly confId?: string | undefined;
+    readonly dir: StreamDir;
+    readonly caller?: string | undefined;
+    readonly callee?: string | undefined;
+    readonly startedAt: Date;
+    readonly streamUrl: string;
+    readonly tenantId?: string | undefined;
+    metadata?: Record<string, string> | undefined;
+}
+/** A conference (ConfBridge) session */
+export interface ConferenceSession {
+    readonly confId: string;
+    readonly tenantId?: string;
+    readonly participants: ReadonlyArray<ConferenceParticipant>;
+    readonly startedAt: Date;
+    metadata?: Record<string, string>;
+}
+export interface ConferenceParticipant {
+    readonly linkedId: string;
+    readonly caller?: string;
+    readonly joinedAt: Date;
+}
+export interface CallNewEvent {
+    readonly type: 'call:new';
+    readonly session: CallSession;
+    readonly tenantId?: string | undefined;
+    readonly timestamp: Date;
+}
+export interface CallEndedEvent {
+    readonly type: 'call:ended';
+    readonly linkedId: string;
+    readonly durationSec: number;
+    readonly timestamp: Date;
+}
+export interface ConfJoinEvent {
+    readonly type: 'conf:join';
+    readonly linkedId: string;
+    readonly confId: string;
+    readonly caller?: string | undefined;
+    readonly timestamp: Date;
+}
+export interface ConfLeaveEvent {
+    readonly type: 'conf:leave';
+    readonly linkedId: string;
+    readonly confId: string;
+    readonly timestamp: Date;
+}
+export interface ConfEndedEvent {
+    readonly type: 'conf:ended';
+    readonly confId: string;
+    readonly timestamp: Date;
+}
+export type CallEvent = CallNewEvent | CallEndedEvent | ConfJoinEvent | ConfLeaveEvent | ConfEndedEvent;
+export type CallEventType = CallEvent['type'];
+/** Raw audio frame as received from the gateway (slin16 PCM) */
+export interface RawAudioChunk {
+    readonly linkedId: string;
+    readonly dir: 'in' | 'out' | 'mixed';
+    /** Raw 16-bit little-endian PCM bytes (640 bytes = 20ms at 16kHz) */
+    readonly raw: Buffer;
+    readonly timestampMs: number;
+}
+/** Normalized audio frame for AI adapters */
+export interface AudioChunk {
+    readonly linkedId: string;
+    readonly dir: 'in' | 'out' | 'mixed';
+    /** Normalized PCM samples in [-1.0, 1.0] */
+    readonly samples: Float32Array;
+    readonly sampleRate: 16000;
+    readonly durationMs: number;
+    readonly timestampMs: number;
+}
+/** Sentiment analysis result from STT provider */
+export interface SentimentResult {
+    /** Segment-level sentiment: positive, neutral, or negative */
+    readonly sentiment: 'positive' | 'neutral' | 'negative';
+    /** Sentiment confidence score (0.0–1.0) */
+    readonly sentimentScore: number;
+}
+export interface TranscriptResult {
+    readonly linkedId: string;
+    readonly text: string;
+    readonly isFinal: boolean;
+    readonly speaker?: 'agent' | 'customer' | string;
+    readonly confidence?: number;
+    readonly language?: string;
+    readonly words?: TranscriptWord[];
+    readonly timestampMs: number;
+    /**
+     * Sentiment analysis result for this transcript segment.
+     * Only present when sentiment analysis is enabled on the STT adapter
+     * (e.g. Deepgram with `sentiment: true`).
+     */
+    readonly sentiment?: SentimentResult;
+}
+export interface TranscriptWord {
+    readonly word: string;
+    readonly startMs: number;
+    readonly endMs: number;
+    readonly confidence?: number;
+}
+/**
+ * Human-like voice optimization options.
+ *
+ * Controls how natural and human-like the synthesized speech sounds.
+ * Each TTS provider maps these options to its own API parameters:
+ *
+ * - **ElevenLabs**: stability ↓, style ↑, multilingual model selection
+ * - **OpenAI gpt-4o-mini-tts**: voiceInstructions with natural speech directives
+ *
+ * Default preset is optimized for Korean (ko-KR) natural conversational speech.
+ */
+export interface HumanVoiceOptions {
+    /**
+     * Enable natural pauses between sentences and clauses (default: true).
+     * Adds realistic breathing pauses at punctuation and clause boundaries.
+     */
+    naturalPauses?: boolean;
+    /**
+     * Include subtle breathing sounds between phrases (default: true).
+     * Makes speech sound less robotic by adding natural breath intake sounds.
+     */
+    breathingSounds?: boolean;
+    /**
+     * Allow filler words in speech (default: true).
+     * Korean: 음, 어, 그, 저 / English: um, uh, well, you know
+     * Works best with gpt-4o-mini-tts (via voiceInstructions).
+     */
+    fillerWords?: boolean;
+    /**
+     * Natural exclamations and interjections (default: true).
+     * Korean: 아, 네, 맞아요 / English: oh, right, I see
+     */
+    exclamations?: boolean;
+    /**
+     * Emotional expressiveness range (0.0–1.0, default: 0.6).
+     * 0.0 = flat/monotone, 1.0 = highly expressive.
+     * ElevenLabs: maps to `style` parameter.
+     * OpenAI: included in voiceInstructions directive.
+     */
+    emotionalRange?: number;
+    /**
+     * Speech variation / naturalness (0.0–1.0, default: 0.7).
+     * Controls how much the voice varies in tone, pace, and rhythm.
+     * Higher values sound more natural but less consistent.
+     * ElevenLabs: maps inversely to `stability` (variation = 1 - stability).
+     */
+    speechVariation?: number;
+}
+/** Default HumanVoiceOptions optimized for Korean conversational speech */
+export declare const HUMAN_VOICE_DEFAULTS_KO: Required<HumanVoiceOptions>;
+/** HumanVoiceOptions optimized for English conversational speech */
+export declare const HUMAN_VOICE_DEFAULTS_EN: Required<HumanVoiceOptions>;
+/** Voice metadata returned from voice fetch/clone APIs */
+export interface VoiceInfo {
+    readonly id: string;
+    readonly label: string;
+}
+export interface TtsOptions {
+    /** Voice ID or name (provider-specific) */
+    voiceId?: string;
+    /** Speaking rate multiplier (0.5–2.0) */
+    speed?: number;
+    /** Pitch adjustment */
+    pitch?: number;
+    /** Language code (e.g. "ko-KR", "en-US") */
+    language?: string;
+    /**
+     * Human-like voice optimization options.
+     * When set, the TTS adapter applies provider-specific settings
+     * to produce more natural, human-sounding speech.
+     * Default: Korean-optimized preset (HUMAN_VOICE_DEFAULTS_KO)
+     */
+    humanVoice?: HumanVoiceOptions;
+}
+/**
+ * STT (Speech-to-Text) options passed to SttAdapter.startStream().
+ * Provider-agnostic options that all STT adapters should support.
+ */
+export interface SttOptions {
+    /** Language code (e.g. "ko", "en-US", "multi") */
+    language?: string;
+    /** Enable speaker diarization — identifies who is speaking */
+    diarize?: boolean;
+    /**
+     * VAD (Voice Activity Detection) sensitivity.
+     * Controls how aggressively silence is detected for utterance boundaries.
+     */
+    vadSensitivity?: 'low' | 'medium' | 'high';
+    /**
+     * Endpointing — silence duration (ms) to trigger utterance end.
+     * Lower values = faster turn detection, higher values = more tolerance for pauses.
+     */
+    endpointingMs?: number;
+    /**
+     * Utterance end — time (ms) of silence to mark utterance as final.
+     * Korean-tuned default: 800ms (avoids premature cuts on sentence-final particles).
+     */
+    utteranceEndMs?: number;
+    /** Emit partial (interim) transcripts in addition to final results */
+    interimResults?: boolean;
+    /**
+     * Smart formatting — auto-format numbers, dates, punctuation.
+     * Optimized for the selected language.
+     */
+    smartFormat?: boolean;
+    /**
+     * Domain-specific keywords to boost recognition accuracy.
+     * E.g. ["DVGateway", "Anthropic", "AI"]
+     */
+    keywords?: string[];
+    /** Add punctuation to transcripts */
+    punctuate?: boolean;
+    /** Redact profane words */
+    profanityFilter?: boolean;
+    /**
+     * Enable sentiment analysis on each transcript segment.
+     * Returns positive/neutral/negative classification with confidence score.
+     * Supported providers: Deepgram (Nova-3).
+     */
+    sentiment?: boolean;
+}
+export interface Message {
+    readonly role: 'system' | 'user' | 'assistant';
+    readonly content: string;
+}
+export interface LlmOptions {
+    /** Override default model */
+    model?: string;
+    /** Override system prompt */
+    systemPrompt?: string;
+    /** Max tokens to generate */
+    maxTokens?: number;
+    /** Temperature (0.0–1.0) */
+    temperature?: number;
+}
+/** Speech-to-Text adapter interface */
+export interface SttAdapter {
+    /**
+     * Begin streaming audio for transcription.
+     * @param linkedId - The call session identifier
+     * @param audioStream - Async iterable of normalized audio chunks
+     */
+    startStream(linkedId: string, audioStream: AsyncIterable<AudioChunk>): Promise<void>;
+    /**
+     * Register a handler for transcription results.
+     * Called for both partial (isFinal=false) and final (isFinal=true) results.
+     */
+    onTranscript(handler: (result: TranscriptResult) => void): void;
+    /** Stop the stream and release resources */
+    stop(): Promise<void>;
+}
+/** Text-to-Speech adapter interface */
+export interface TtsAdapter {
+    /**
+     * Synthesize text to speech.
+     * Returns an async iterable of 16kHz 16-bit PCM audio chunks.
+     */
+    synthesize(text: string, options?: TtsOptions): AsyncIterable<Buffer>;
+}
+/** Large Language Model adapter interface */
+export interface LlmAdapter {
+    /**
+     * Generate a streaming chat completion.
+     * Returns an async iterable of text tokens.
+     */
+    chat(messages: Message[], options?: LlmOptions): AsyncIterable<string>;
+}
+export interface PipelineOptions {
+    /** Only process audio in this direction (default: "both") */
+    dir?: StreamDir;
+    /** Minimum silence duration (ms) before treating as end-of-utterance (default: 500) */
+    endOfUtteranceSilenceMs?: number;
+    /** Whether to submit transcripts to minutes (default: true for conferences) */
+    submitToMinutes?: boolean;
+}
+export interface PipelineEventHandlers {
+    onNewCall?: (session: CallSession) => void | Promise<void>;
+    onCallEnded?: (linkedId: string, durationSec: number) => void | Promise<void>;
+    onTranscript?: (result: TranscriptResult, session: CallSession) => void | Promise<void>;
+    onError?: (err: Error, linkedId?: string) => void | Promise<void>;
+}
+export interface MinutesDownloadOptions {
+    format: 'json' | 'txt';
+}
+export interface MinutesEntry {
+    readonly linkedId: string;
+    readonly speaker?: string;
+    readonly text: string;
+    readonly isFinal: boolean;
+    readonly timestampMs: number;
+    readonly sentiment?: string;
+    readonly sentimentScore?: number;
+}
+export interface Logger {
+    debug(ctx: Record<string, unknown>, msg: string): void;
+    info(ctx: Record<string, unknown>, msg: string): void;
+    warn(ctx: Record<string, unknown>, msg: string): void;
+    error(ctx: Record<string, unknown>, msg: string): void;
+}
+/** Function to unsubscribe from an event listener */
+export type Unsubscribe = () => void;
+/** Typed result type for error handling without exceptions */
+export type Result<T, E extends Error = Error> = {
+    readonly ok: true;
+    readonly value: T;
+} | {
+    readonly ok: false;
+    readonly error: E;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

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

package/dist/types/index.js

@@ -0,0 +1,25 @@
+/**
+ * DVGateway SDK — Public Type Definitions
+ *
+ * Core types for interacting with the DVGateway real-time voice media gateway.
+ * All adapters and pipeline components are built on these interfaces.
+ */
+/** Default HumanVoiceOptions optimized for Korean conversational speech */
+export const HUMAN_VOICE_DEFAULTS_KO = {
+    naturalPauses: true,
+    breathingSounds: true,
+    fillerWords: true,
+    exclamations: true,
+    emotionalRange: 0.6,
+    speechVariation: 0.7,
+};
+/** HumanVoiceOptions optimized for English conversational speech */
+export const HUMAN_VOICE_DEFAULTS_EN = {
+    naturalPauses: true,
+    breathingSounds: true,
+    fillerWords: false,
+    exclamations: true,
+    emotionalRange: 0.5,
+    speechVariation: 0.6,
+};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAmQH,2EAA2E;AAC3E,MAAM,CAAC,MAAM,uBAAuB,GAAgC;IAClE,aAAa,EAAE,IAAI;IACnB,eAAe,EAAE,IAAI;IACrB,WAAW,EAAE,IAAI;IACjB,YAAY,EAAE,IAAI;IAClB,cAAc,EAAE,GAAG;IACnB,eAAe,EAAE,GAAG;CACZ,CAAC;AAEX,oEAAoE;AACpE,MAAM,CAAC,MAAM,uBAAuB,GAAgC;IAClE,aAAa,EAAE,IAAI;IACnB,eAAe,EAAE,IAAI;IACrB,WAAW,EAAE,KAAK;IAClB,YAAY,EAAE,IAAI;IAClB,cAAc,EAAE,GAAG;IACnB,eAAe,EAAE,GAAG;CACZ,CAAC"}

package/package.json

@@ -0,0 +1,81 @@
+{
+  "name": "dvgateway-sdk",
+  "version": "1.0.0",
+  "description": "DVGateway SDK — Real-time voice AI integration for the DVGateway media gateway",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "jest",
+    "lint": "eslint src --ext .ts",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "dvgateway",
+    "voice-ai",
+    "sip",
+    "asterisk",
+    "realtime",
+    "speech-to-text",
+    "text-to-speech",
+    "llm",
+    "webrtc",
+    "sdk"
+  ],
+  "author": {
+    "name": "OLSSOO Inc.",
+    "email": "dev@olssoo.com",
+    "url": "https://github.com/OLSSOO-Inc"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/OLSSOO-Inc/AI-Ready-Real-Time-Voice-Media-Gateway.git",
+    "directory": "packages/dvgateway-sdk"
+  },
+  "homepage": "https://github.com/OLSSOO-Inc/dvgateway-releases",
+  "bugs": {
+    "url": "https://github.com/OLSSOO-Inc/AI-Ready-Real-Time-Voice-Media-Gateway/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "uuid": "^9.0.0",
+    "ws": "^8.17.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/node": "^20.0.0",
+    "@types/uuid": "^9.0.0",
+    "@types/ws": "^8.5.10",
+    "jest": "^30.3.0",
+    "ts-jest": "^29.4.6",
+    "typescript": "^5.4.0"
+  },
+  "peerDependencies": {
+    "@opentelemetry/api": ">=1.7.0"
+  },
+  "peerDependenciesMeta": {
+    "@opentelemetry/api": {
+      "optional": true
+    }
+  }
+}