@juspay/neurolink 11.13.0 → 11.13.2

package/dist/lib/types/rag.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=rag.js.map

package/dist/lib/types/realtime.d.ts

@@ -1,243 +0,0 @@
-/**
- * Realtime Voice Type Definitions for NeuroLink
- *
- * All realtime/bidirectional voice types: session, config, messages,
- * event handlers, provider types, handler types, error codes, defaults,
- * and type guards.
- *
- * @module types/realtime
- */
-import type { TTSAudioFormat } from "./tts.js";
-type RealtimeProviderCapability = "tts" | "stt" | "realtime" | "streaming";
-/**
- * Realtime session state
- */
-export type RealtimeSessionState = "disconnected" | "connecting" | "connected" | "disconnecting" | "error";
-/**
- * Realtime voice configuration
- */
-export type RealtimeConfig = {
-    /**
-     * Provider to use. Must match the handler key registered with
-     * `RealtimeProcessor.registerHandler()` — currently `"openai-realtime"`
-     * (registered in `providerRegistry.ts`) and `"gemini-live"` (registered in
-     * `providerRegistry.ts`). Aliasing is handled at registry/CLI parse time,
-     * not here.
-     */
-    provider: "openai-realtime" | "gemini-live";
-    /** API key */
-    apiKey?: string;
-    /** Model to use */
-    model?: string;
-    /** Voice for TTS output */
-    voice?: string;
-    /** Input language */
-    inputLanguage?: string;
-    /** Output language */
-    outputLanguage?: string;
-    /** System prompt for the AI */
-    systemPrompt?: string;
-    /** Session timeout in milliseconds */
-    timeout?: number;
-    /** Audio input format */
-    inputFormat?: TTSAudioFormat;
-    /** Audio output format */
-    outputFormat?: TTSAudioFormat;
-    /** Input sample rate */
-    inputSampleRate?: number;
-    /** Output sample rate */
-    outputSampleRate?: number;
-    /** Enable voice activity detection */
-    vadEnabled?: boolean;
-    /** VAD threshold (0-1) */
-    vadThreshold?: number;
-    /** Turn detection mode */
-    turnDetection?: "server_vad" | "manual";
-    /** Instructions/system prompt for the session */
-    instructions?: string;
-    /** Temperature for AI responses */
-    temperature?: number;
-    /** Tools/functions available to the model */
-    tools?: RealtimeTool[];
-};
-/**
- * Realtime tool definition
- */
-export type RealtimeTool = {
-    /** Tool name */
-    name: string;
-    /** Tool description */
-    description: string;
-    /** JSON schema for parameters */
-    parameters: Record<string, unknown>;
-};
-/**
- * Realtime session information
- */
-export type RealtimeSession = {
-    /** Session ID */
-    id: string;
-    /** Current state */
-    state: RealtimeSessionState;
-    /** Provider name — narrowed to the validated config provider union so
-     *  session state stays aligned with what `connect()` accepts. */
-    provider: RealtimeConfig["provider"];
-    /** Model being used */
-    model?: string;
-    /** Session creation time */
-    createdAt: Date;
-    /** Last activity time */
-    lastActivityAt: Date;
-    /** Session configuration */
-    config: RealtimeConfig;
-    /** Check if session is open */
-    isOpen?: () => boolean;
-    /** Close the session */
-    close?: () => Promise<void>;
-};
-/**
- * Realtime audio chunk
- */
-export type RealtimeAudioChunk = {
-    /** Audio data */
-    data: Buffer;
-    /** Chunk sequence number */
-    index: number;
-    /** Whether this is the final chunk */
-    isFinal: boolean;
-    /** Audio format */
-    format: TTSAudioFormat;
-    /** Sample rate */
-    sampleRate?: number;
-    /** Duration of this chunk in milliseconds */
-    durationMs?: number;
-};
-/**
- * Realtime message types
- */
-export type RealtimeMessageType = "audio" | "text" | "transcript" | "function_call" | "function_result" | "error" | "session_update" | "turn_start" | "turn_end";
-/**
- * Realtime message
- */
-export type RealtimeMessage = {
-    /** Message type */
-    type: RealtimeMessageType;
-    /** Message ID */
-    id?: string;
-    /** Audio data (for audio messages) */
-    audio?: RealtimeAudioChunk;
-    /** Text content (for text/transcript messages) */
-    text?: string;
-    /** Whether this is a partial result */
-    isPartial?: boolean;
-    /** Function call data */
-    functionCall?: {
-        name: string;
-        arguments: Record<string, unknown>;
-    };
-    /** Function result data */
-    functionResult?: {
-        name: string;
-        result: unknown;
-    };
-    /** Error information */
-    error?: {
-        code: string;
-        message: string;
-    };
-    /** Timestamp */
-    timestamp: Date;
-};
-/**
- * Realtime event handler callbacks
- */
-export type RealtimeEventHandlers = {
-    /** Called when audio is received */
-    onAudio?: (chunk: RealtimeAudioChunk) => void;
-    /** Called when text/transcript is received */
-    onTranscript?: (text: string, isFinal: boolean) => void;
-    /** Called when the model generates text */
-    onText?: (text: string, isFinal: boolean) => void;
-    /** Called when a function call is requested */
-    onFunctionCall?: (name: string, args: Record<string, unknown>) => Promise<unknown>;
-    /** Called when session state changes */
-    onStateChange?: (state: RealtimeSessionState) => void;
-    /** Called when an error occurs */
-    onError?: (error: Error) => void;
-    /** Called when a turn starts */
-    onTurnStart?: () => void;
-    /** Called when a turn ends */
-    onTurnEnd?: () => void;
-};
-/**
- * Realtime voice provider type (bidirectional audio)
- */
-export type RealtimeVoiceProvider = {
-    /** Provider name identifier */
-    readonly name: string;
-    /** Get supported capabilities */
-    getCapabilities(): RealtimeProviderCapability[];
-    /** Check if provider is properly configured */
-    isConfigured(): boolean;
-    /** Validate provider configuration */
-    validateConfig(): Promise<{
-        valid: boolean;
-        errors: string[];
-    }>;
-    /** Get provider-specific options schema */
-    getOptionsSchema?(): Record<string, unknown>;
-    /**
-     * Create a new realtime session
-     */
-    connect(config: RealtimeConfig): Promise<RealtimeSession>;
-    /**
-     * Check if connected
-     */
-    isConnected(): boolean;
-    /**
-     * Disconnect from realtime session
-     */
-    disconnect(): Promise<void>;
-    /**
-     * Get current session configuration
-     */
-    getSessionConfig(): RealtimeConfig | null;
-};
-export type RealtimeHandler = {
-    readonly name: string;
-    connect(config: RealtimeConfig): Promise<RealtimeSession>;
-    disconnect(): Promise<void>;
-    isConnected(): boolean;
-    getSession(): RealtimeSession | null;
-    sendAudio(audio: Buffer | RealtimeAudioChunk): Promise<void>;
-    sendText?(text: string): Promise<void>;
-    triggerResponse?(): Promise<void>;
-    cancelResponse?(): Promise<void>;
-    on(handlers: RealtimeEventHandlers): void;
-    off(): void;
-    isConfigured(): boolean;
-    getSupportedFormats(): TTSAudioFormat[];
-};
-/**
- * Realtime error codes
- */
-export declare const REALTIME_ERROR_CODES: {
-    readonly CONNECTION_FAILED: "REALTIME_CONNECTION_FAILED";
-    readonly SESSION_TIMEOUT: "REALTIME_SESSION_TIMEOUT";
-    readonly PROTOCOL_ERROR: "REALTIME_PROTOCOL_ERROR";
-    readonly AUDIO_STREAM_ERROR: "REALTIME_AUDIO_STREAM_ERROR";
-    readonly PROVIDER_NOT_CONFIGURED: "REALTIME_PROVIDER_NOT_CONFIGURED";
-    readonly PROVIDER_NOT_SUPPORTED: "REALTIME_PROVIDER_NOT_SUPPORTED";
-    readonly SESSION_ALREADY_ACTIVE: "REALTIME_SESSION_ALREADY_ACTIVE";
-    readonly SESSION_NOT_ACTIVE: "REALTIME_SESSION_NOT_ACTIVE";
-    readonly INVALID_MESSAGE: "REALTIME_INVALID_MESSAGE";
-};
-/**
- * Default realtime configuration
- */
-export declare const DEFAULT_REALTIME_CONFIG: Partial<RealtimeConfig>;
-/**
- * Type guard for valid RealtimeConfig
- */
-export declare function isValidRealtimeConfig(config: unknown): config is RealtimeConfig;
-export {};

package/dist/lib/types/realtime.js

@@ -1,70 +0,0 @@
-/**
- * Realtime Voice Type Definitions for NeuroLink
- *
- * All realtime/bidirectional voice types: session, config, messages,
- * event handlers, provider types, handler types, error codes, defaults,
- * and type guards.
- *
- * @module types/realtime
- */
-// ============================================================================
-// REALTIME ERROR CODES
-// ============================================================================
-/**
- * Realtime error codes
- */
-export const REALTIME_ERROR_CODES = {
-    CONNECTION_FAILED: "REALTIME_CONNECTION_FAILED",
-    SESSION_TIMEOUT: "REALTIME_SESSION_TIMEOUT",
-    PROTOCOL_ERROR: "REALTIME_PROTOCOL_ERROR",
-    AUDIO_STREAM_ERROR: "REALTIME_AUDIO_STREAM_ERROR",
-    PROVIDER_NOT_CONFIGURED: "REALTIME_PROVIDER_NOT_CONFIGURED",
-    PROVIDER_NOT_SUPPORTED: "REALTIME_PROVIDER_NOT_SUPPORTED",
-    SESSION_ALREADY_ACTIVE: "REALTIME_SESSION_ALREADY_ACTIVE",
-    SESSION_NOT_ACTIVE: "REALTIME_SESSION_NOT_ACTIVE",
-    INVALID_MESSAGE: "REALTIME_INVALID_MESSAGE",
-};
-// ============================================================================
-// REALTIME DEFAULTS
-// ============================================================================
-/**
- * Default realtime configuration
- */
-export const DEFAULT_REALTIME_CONFIG = {
-    timeout: 30000,
-    inputSampleRate: 24000,
-    outputSampleRate: 24000,
-    vadEnabled: true,
-    vadThreshold: 0.5,
-    turnDetection: "server_vad",
-};
-// ============================================================================
-// REALTIME TYPE GUARDS
-// ============================================================================
-/**
- * Type guard for valid RealtimeConfig
- */
-export function isValidRealtimeConfig(config) {
-    if (!config || typeof config !== "object") {
-        return false;
-    }
-    const conf = config;
-    if (!conf.provider ||
-        !["openai-realtime", "gemini-live"].includes(conf.provider)) {
-        return false;
-    }
-    if (conf.timeout !== undefined) {
-        if (typeof conf.timeout !== "number" || conf.timeout <= 0) {
-            return false;
-        }
-    }
-    if (conf.vadThreshold !== undefined) {
-        if (typeof conf.vadThreshold !== "number" ||
-            conf.vadThreshold < 0 ||
-            conf.vadThreshold > 1) {
-            return false;
-        }
-    }
-    return true;
-}
-//# sourceMappingURL=realtime.js.map

package/dist/lib/types/replicate.d.ts

@@ -1,67 +0,0 @@
-/**
- * Replicate Type Definitions
- *
- * Shared types for the Replicate prediction lifecycle (LLM, video,
- * avatar, music handlers all consume these via the types barrel).
- *
- * @module types/replicate
- */
-/**
- * Replicate auth payload — bearer token + optional base URL.
- */
-export type ReplicateAuth = {
-    apiToken: string;
-    baseUrl?: string;
-};
-/**
- * Replicate prediction status (terminal: succeeded / failed / canceled).
- */
-export type ReplicatePredictionStatus = "starting" | "processing" | "succeeded" | "failed" | "canceled";
-/**
- * Replicate prediction object as returned by /v1/predictions POST and
- * /v1/predictions/:id GET. Output shape varies by model — caller narrows.
- */
-export type ReplicatePrediction = {
-    id: string;
-    model?: string;
-    version?: string;
-    status: ReplicatePredictionStatus;
-    /** URL string, array of URL strings, base64, or model-specific JSON. */
-    output?: unknown;
-    error?: string | null;
-    metrics?: {
-        predict_time?: number;
-    };
-    urls?: {
-        get: string;
-        cancel: string;
-    };
-    logs?: string;
-    created_at?: string;
-    started_at?: string;
-    completed_at?: string;
-};
-/**
- * Input shape for Replicate's createPrediction helper.
- */
-export type ReplicateCreatePredictionInput = {
-    /** Model in "owner/name" or "owner/name:version" form. */
-    model: string;
-    /** Provider/model-specific input shape. */
-    input: Record<string, unknown>;
-    /** Optional webhook URL for completion notifications. */
-    webhook?: string;
-    /** Optional webhook events filter. */
-    webhookEventsFilter?: ("start" | "output" | "logs" | "completed")[];
-};
-/**
- * Options for the Replicate poll loop.
- */
-export type ReplicatePollOptions = {
-    /** Total time to wait before throwing a timeout error (default 5 min). */
-    timeoutMs?: number;
-    /** Poll interval in milliseconds (default 2 s). */
-    pollIntervalMs?: number;
-    /** Caller-supplied AbortSignal to cancel polling early. */
-    abortSignal?: AbortSignal;
-};

package/dist/lib/types/replicate.js

@@ -1,10 +0,0 @@
-/**
- * Replicate Type Definitions
- *
- * Shared types for the Replicate prediction lifecycle (LLM, video,
- * avatar, music handlers all consume these via the types barrel).
- *
- * @module types/replicate
- */
-export {};
-//# sourceMappingURL=replicate.js.map

package/dist/lib/types/requestRouter.d.ts

@@ -1,75 +0,0 @@
-/**
- * Pluggable pre-call request router types.
- *
- * A RequestRouter is a host-supplied async function that inspects lightweight
- * request characteristics (token estimate, tools, vision, thinking) and
- * returns an optional provider/model/region override.  The router runs only
- * when the host opts in (by passing `requestRouter` or `modelPool` to
- * the NeuroLink constructor) and only when the user did NOT explicitly set
- * BOTH `options.provider` AND `options.model` on the call (a partial pin —
- * e.g. only `options.provider` — still allows the router to run).
- *
- * Everything fails open: if the router throws or returns an empty decision the
- * call proceeds with whatever provider/model was configured by the caller.
- */
-/**
- * Lightweight characteristics of the incoming request available to the router
- * without executing the full call.
- */
-export type RouterInputContext = {
-    /** The text prompt (or first text segment of a multi-modal input). */
-    prompt: string;
-    /** Rough token estimate for the input, if known by the caller. */
-    estimatedInputTokens?: number;
-    /** True when the call includes at least one tool definition. */
-    hasTools?: boolean;
-    /** True when the call includes at least one image/vision attachment. */
-    requiresVision?: boolean;
-    /** Thinking level passed to the call ("minimal" | "low" | "medium" | "high"). */
-    thinkingLevel?: string;
-};
-/**
- * The router's decision.  Any field that is undefined means "keep whatever the
- * caller already configured" — returning `{}` is a valid no-op.
- */
-export type RequestRouterDecision = {
-    provider?: string;
-    model?: string;
-    region?: string;
-    /** Optional human-readable reason, emitted at debug log level. */
-    reason?: string;
-};
-/**
- * A pluggable pre-call router function.
- *
- * Receives a lightweight context snapshot and returns provider/model/region
- * overrides.  May be async (e.g. to consult a remote config service).
- */
-export type RequestRouter = (context: RouterInputContext) => RequestRouterDecision | Promise<RequestRouterDecision>;
-/**
- * Tier-to-(provider,model) mapping used by `createDefaultRequestRouter`.
- * Each tier is optional; an unmatched tier produces an empty decision.
- */
-export type ModelTierEntry = {
-    provider: string;
-    model: string;
-    region?: string;
-};
-/**
- * Configuration for the built-in heuristic request router produced by
- * `createDefaultRequestRouter`.  All fields are optional; sensible defaults
- * apply when omitted.
- */
-export type DefaultRequestRouterConfig = {
-    /**
-     * Token threshold above which the "large" tier is selected.
-     * Default: 32_000.
-     */
-    largeInputTokenThreshold?: number;
-    /** Provider/model to use for vision requests. */
-    visionTier?: ModelTierEntry;
-    /** Provider/model to use for large inputs or tool-heavy requests. */
-    largeTier?: ModelTierEntry;
-    /** Provider/model to use for fast/small requests. */
-    smallTier?: ModelTierEntry;
-};

package/dist/lib/types/requestRouter.js

@@ -1,16 +0,0 @@
-/**
- * Pluggable pre-call request router types.
- *
- * A RequestRouter is a host-supplied async function that inspects lightweight
- * request characteristics (token estimate, tools, vision, thinking) and
- * returns an optional provider/model/region override.  The router runs only
- * when the host opts in (by passing `requestRouter` or `modelPool` to
- * the NeuroLink constructor) and only when the user did NOT explicitly set
- * BOTH `options.provider` AND `options.model` on the call (a partial pin —
- * e.g. only `options.provider` — still allows the router to run).
- *
- * Everything fails open: if the router throws or returns an empty decision the
- * call proceeds with whatever provider/model was configured by the caller.
- */
-export {};
-//# sourceMappingURL=requestRouter.js.map

package/dist/lib/types/safeFetch.d.ts

@@ -1,24 +0,0 @@
-/**
- * Types for the safe-fetch utility (SSRF-hardened binary downloads).
- *
- * Runtime helper lives in `src/lib/utils/safeFetch.ts`.
- */
-/**
- * One validated address the pinned connect layer is allowed to dial.
- * Produced by `ssrfGuard.ts:validateAndResolveUrl`, consumed by
- * `safeFetch.ts:buildPinnedAgent`.
- */
-export type PinnedAddress = {
-    ip: string;
-    family: 4 | 6;
-};
-export type SafeDownloadOptions = {
-    /** Hard cap on response size in bytes. Pass MAX_VIDEO_BYTES/MAX_AUDIO_BYTES/MAX_IMAGE_BYTES from sizeGuard. */
-    maxBytes: number;
-    /** Human-readable identifier used in error messages (e.g. "HeyGen video"). */
-    label: string;
-    /** Optional abort signal for caller-driven cancellation. */
-    signal?: AbortSignal;
-    /** Optional per-call request timeout (ms). Default: 60_000. */
-    timeoutMs?: number;
-};

package/dist/lib/types/safeFetch.js

@@ -1,7 +0,0 @@
-/**
- * Types for the safe-fetch utility (SSRF-hardened binary downloads).
- *
- * Runtime helper lives in `src/lib/utils/safeFetch.ts`.
- */
-export {};
-//# sourceMappingURL=safeFetch.js.map