@juspay/neurolink 9.32.0 → 9.33.0

package/dist/client/types/hitlTypes.js

@@ -1,8 +0,0 @@
-/**
- * HITL (Human-in-the-Loop) Type Definitions
- *
- * Comprehensive TypeScript interfaces for the HITL safety system.
- * These types ensure type safety and provide clear contracts for
- * all HITL-related functionality.
- */
-export {};

package/dist/client/types/index.js

@@ -1,57 +0,0 @@
-/**
- * Centralized type exports for NeuroLink
- */
-// Constants and enums
-export { AIProviderName } from "../constants/enums.js";
-// CLI types
-export * from "./cli.js";
-// Common utility types
-export * from "./common.js";
-// Provider types
-export * from "./providers.js";
-// Task classification types
-export * from "./taskClassificationTypes.js";
-// Tool system types
-export * from "./tools.js";
-export { PROCESSOR_PRIORITIES } from "../processors/base/types.js";
-// Content types for multimodal support (includes multimodal re-exports for backward compatibility)
-export * from "./content.js";
-// Evaluation types - NEW
-export * from "./evaluation.js";
-// Evaluation provider types - NEW
-export * from "./evaluationProviders.js";
-// File detection and processing types
-export * from "./fileTypes.js";
-// HITL (Human-in-the-Loop) types
-export * from "./hitlTypes.js";
-// Middleware Types - Middleware system types
-export * from "./middlewareTypes.js";
-// Model types - NEW
-export * from "./modelTypes.js";
-// SDK Types - Core types for external developers
-// Note: sdkTypes.ts uses selective re-exports internally, so we use wildcard here
-// The conflicts were from generateTypes and analytics which are now handled above
-export * from "./sdkTypes.js";
-// Service types - NEW
-export * from "./serviceTypes.js";
-// TTS (Text-to-Speech) types
-export * from "./ttsTypes.js";
-// Utilities Types - Utility module types (selective export to avoid conflicts)
-export * from "./utilities.js";
-// Workflow types
-export * from "./workflowTypes.js";
-// Context compaction types
-export * from "./contextTypes.js";
-// File reference types
-export * from "./fileReferenceTypes.js";
-// RAG types
-export * from "./ragTypes.js";
-// Conversation memory manager type
-export * from "./conversationMemoryInterface.js";
-// Subscription types (Claude subscription tiers, authentication, usage tracking)
-// NOTE: subscriptionTypes.ts re-exports auth types from ./authTypes.ts for
-// backward compatibility. Import StoredOAuthTokens, TokenRefresher, etc.
-// from authTypes.ts for new code.
-export * from "./subscriptionTypes.js";
-// Proxy types (Claude API format, cloaking, routing, config, stats, server adapters)
-export * from "./proxyTypes.js";

package/dist/client/types/mcpTypes.js

@@ -1,5 +0,0 @@
-/**
- * MCP Types for In-Memory Server Support
- * Enables various integrations to register tools directly
- */
-export {};

package/dist/client/types/middlewareTypes.js

@@ -1 +0,0 @@
-export {};

package/dist/client/types/modelTypes.js

@@ -1,30 +0,0 @@
-/**
- * Model-related type definitions for NeuroLink
- * Consolidates all model configuration, dynamic model, and provider model types
- */
-import { z } from "zod";
-/**
- * Zod schema for model configuration validation
- */
-export const ModelConfigSchema = z.object({
-    id: z.string(),
-    displayName: z.string(),
-    capabilities: z.array(z.string()),
-    deprecated: z.boolean(),
-    pricing: z.object({
-        input: z.number(),
-        output: z.number(),
-    }),
-    contextWindow: z.number(),
-    releaseDate: z.string(),
-});
-/**
- * Zod schema for model registry validation
- */
-export const ModelRegistrySchema = z.object({
-    version: z.string(),
-    lastUpdated: z.string(),
-    models: z.record(z.string(), z.record(z.string(), ModelConfigSchema)),
-    aliases: z.record(z.string(), z.string()).optional(),
-    defaults: z.record(z.string(), z.string()).optional(),
-});

package/dist/client/types/multimodal.js

@@ -1,135 +0,0 @@
-/**
- * Multimodal Content Types for NeuroLink
- *
- * Central registry for all multimodal input/output types.
- * This file consolidates types from content.ts and conversation.ts
- * to provide a single source of truth for multimodal functionality.
- *
- * @module types/multimodal
- *
- * @example Basic Multimodal Input
- * ```typescript
- * import type { MultimodalInput } from './types/multimodal.js';
- *
- * const input: MultimodalInput = {
- *   text: "What's in this image?",
- *   images: [imageBuffer, "https://example.com/image.jpg"],
- *   pdfFiles: [pdfBuffer]
- * };
- * ```
- *
- * @example Audio/Video Input (Future)
- * ```typescript
- * const avInput: MultimodalInput = {
- *   text: "Transcribe this audio and analyze this video",
- *   audioFiles: [audioBuffer],
- *   videoFiles: ["path/to/video.mp4"]
- * };
- * ```
- *
- * @example Advanced Content Array
- * ```typescript
- * const advanced: MultimodalInput = {
- *   text: "irrelevant", // ignored when content[] is provided
- *   content: [
- *     { type: "text", text: "Analyze these items:" },
- *     { type: "image", data: imageBuffer, mediaType: "image/jpeg" },
- *     { type: "pdf", data: pdfBuffer, metadata: { filename: "report.pdf" } }
- *   ]
- * };
- * ```
- */
-// ============================================
-// TYPE GUARDS
-// ============================================
-/**
- * Type guard to check if content is TextContent
- */
-export function isTextContent(content) {
-    return content.type === "text";
-}
-/**
- * Type guard to check if content is ImageContent
- */
-export function isImageContent(content) {
-    return content.type === "image";
-}
-/**
- * Type guard to check if content is CSVContent
- */
-export function isCSVContent(content) {
-    return content.type === "csv";
-}
-/**
- * Type guard to check if content is PDFContent
- */
-export function isPDFContent(content) {
-    return content.type === "pdf";
-}
-/**
- * Type guard to check if content is AudioContent
- */
-export function isAudioContent(content) {
-    return content.type === "audio";
-}
-/**
- * Type guard to check if content is VideoContent
- */
-export function isVideoContent(content) {
-    return content.type === "video";
-}
-/**
- * Type guard to check if input contains multimodal content
- * Now includes audio and video detection
- */
-/**
- * Type guard to validate if an object matches the DirectorSegment shape.
- * Checks for required prompt (string) and image (Buffer, string, or ImageWithAltText).
- */
-function isDirectorSegment(segment) {
-    if (!segment || typeof segment !== "object") {
-        return false;
-    }
-    const maybeSegment = segment;
-    // Check for required prompt field
-    if (typeof maybeSegment.prompt !== "string" || !maybeSegment.prompt) {
-        return false;
-    }
-    // Check for required image field
-    const { image } = maybeSegment;
-    if (!image) {
-        return false;
-    }
-    // Validate image type: Buffer, string (URL/path), or ImageWithAltText
-    if (Buffer.isBuffer(image)) {
-        return true;
-    }
-    if (typeof image === "string") {
-        return true;
-    }
-    // Check for ImageWithAltText structure
-    if (typeof image === "object" && "data" in image) {
-        const imgData = image.data;
-        return Buffer.isBuffer(imgData) || typeof imgData === "string";
-    }
-    return false;
-}
-export function isMultimodalInput(input) {
-    const maybeInput = input;
-    return !!(maybeInput?.images?.length ||
-        maybeInput?.csvFiles?.length ||
-        maybeInput?.pdfFiles?.length ||
-        maybeInput?.files?.length ||
-        maybeInput?.content?.length ||
-        maybeInput?.audioFiles?.length ||
-        maybeInput?.videoFiles?.length ||
-        (maybeInput?.segments?.length &&
-            Array.isArray(maybeInput.segments) &&
-            maybeInput.segments.every(isDirectorSegment)));
-}
-/**
- * Type guard to check if message content is multimodal (array)
- */
-export function isMultimodalMessageContent(content) {
-    return Array.isArray(content);
-}

package/dist/client/types/observability.js

@@ -1,6 +0,0 @@
-/**
- * Observability Configuration Types
- * These configs are passed from the parent application (e.g., Lighthouse)
- * to enable telemetry and observability features in Neurolink SDK
- */
-export {};

package/dist/client/types/pptTypes.js

@@ -1,82 +0,0 @@
-/**
- * PPT Generation Types
- *
- * All types for presentation generation - both external API types and internal pipeline types.
- * Used by the content planner, slide generator, and orchestrator.
- *
- * Architecture:
- * - PPTOutputOptions / PPTGenerationResult: External API types (GenerateOptions.output.ppt)
- * - SlideSchema / ContentPlan: Content planning pipeline types
- * - CompleteSlide / PPTGenerationContext: Generation context types
- * - PPTError: Error handling (follows VideoError pattern)
- */
-import { ErrorCategory, ErrorSeverity } from "../constants/enums.js";
-import { NeuroLinkError } from "../utils/errorHandling.js";
-// ============================================================================
-// ERROR TYPES (Following VideoError pattern from vertexVideoHandler.ts)
-// ============================================================================
-/**
- * PPT generation error codes
- * Following the VIDEO_ERROR_CODES pattern
- */
-export const PPT_ERROR_CODES = {
-    /** Content planning AI call failed */
-    PLANNING_FAILED: "PPT_PLANNING_FAILED",
-    /** AI returned invalid/unparseable response */
-    INVALID_AI_RESPONSE: "PPT_INVALID_AI_RESPONSE",
-    /** Image generation for slide failed */
-    IMAGE_GENERATION_FAILED: "PPT_IMAGE_GENERATION_FAILED",
-    /** PPTX file assembly failed */
-    ASSEMBLY_FAILED: "PPT_ASSEMBLY_FAILED",
-    /** File system write failed */
-    FILE_WRITE_FAILED: "PPT_FILE_WRITE_FAILED",
-    /** Invalid input options */
-    INVALID_INPUT: "PPT_INVALID_INPUT",
-    /** Generation timeout */
-    TIMEOUT: "PPT_TIMEOUT",
-};
-/**
- * PPT generation error class
- * Extends NeuroLinkError for consistent error handling (follows VideoError pattern)
- */
-export class PPTError extends NeuroLinkError {
-    constructor(message, code, context, originalError) {
-        super({
-            code,
-            message,
-            category: ErrorCategory.EXECUTION,
-            severity: ErrorSeverity.HIGH,
-            retriable: false,
-            context: {
-                ...context,
-                originalMessage: originalError?.message,
-            },
-            originalError,
-        });
-        this.name = "PPTError";
-    }
-}
-// ============================================================================
-// VALIDATION CONSTANTS
-// ============================================================================
-/** Minimum number of slides allowed */
-export const MIN_SLIDES = 5;
-/** Maximum number of slides allowed */
-export const MAX_SLIDES = 50;
-/** Slide dimensions in inches by aspect ratio */
-export const SLIDE_DIMENSIONS = {
-    "16:9": { width: 10, height: 5.625 },
-    "4:3": { width: 10, height: 7.5 },
-};
-/**
- * Validate a hex color string (6 hex characters, no # prefix).
- */
-export function isValidHexColor(color) {
-    return /^[0-9A-Fa-f]{6}$/.test(color);
-}
-/**
- * Normalize a hex color by stripping leading # if present.
- */
-export function normalizeHexColor(color) {
-    return color.startsWith("#") ? color.slice(1) : color;
-}

package/dist/client/types/providers.js

@@ -1,111 +0,0 @@
-/**
- * Provider-specific type definitions for NeuroLink
- */
-import { AIProviderName, AnthropicModels, BedrockModels, GoogleAIModels, OpenAIModels, VertexModels, } from "../constants/enums.js";
-/**
- * Type guard to check if a configuration is an AnthropicProviderConfig
- *
- * @param config - The configuration object to check
- * @returns True if the configuration is an AnthropicProviderConfig
- *
- * @example
- * ```typescript
- * const config = getProviderConfig();
- * if (isAnthropicConfig(config)) {
- *   // TypeScript knows config is AnthropicProviderConfig here
- *   console.log(config.subscriptionTier);
- *   console.log(config.oauthConfig?.clientId);
- * }
- * ```
- */
-export function isAnthropicConfig(config) {
-    if (config === null || config === undefined) {
-        return false;
-    }
-    if (typeof config !== "object") {
-        return false;
-    }
-    const configObj = config;
-    // Check for Anthropic-specific properties
-    // A config is considered Anthropic if it has:
-    // 1. An authMethod that is a valid AnthropicAuthMethod, OR
-    // 2. A subscriptionTier that is a valid ClaudeSubscriptionTier, OR
-    // 3. An oauthConfig object
-    const validAuthMethods = ["api_key", "oauth"];
-    const validSubscriptionTiers = [
-        "free",
-        "pro",
-        "max",
-        "max_5",
-        "max_20",
-        "api",
-    ];
-    // Check for authMethod
-    if (configObj.authMethod !== undefined &&
-        typeof configObj.authMethod === "string" &&
-        validAuthMethods.includes(configObj.authMethod)) {
-        return true;
-    }
-    // Check for subscriptionTier
-    if (configObj.subscriptionTier !== undefined &&
-        typeof configObj.subscriptionTier === "string" &&
-        validSubscriptionTiers.includes(configObj.subscriptionTier)) {
-        return true;
-    }
-    // Check for oauthConfig
-    if (configObj.oauthConfig !== undefined &&
-        typeof configObj.oauthConfig === "object" &&
-        configObj.oauthConfig !== null) {
-        return true;
-    }
-    // Check for authConfig (AnthropicAuthConfig)
-    if (configObj.authConfig !== undefined &&
-        typeof configObj.authConfig === "object" &&
-        configObj.authConfig !== null) {
-        const authConfig = configObj.authConfig;
-        if (authConfig.method !== undefined &&
-            typeof authConfig.method === "string" &&
-            validAuthMethods.includes(authConfig.method)) {
-            return true;
-        }
-    }
-    return false;
-}
-/**
- * Default model aliases for easy reference
- */
-export const DEFAULT_MODEL_ALIASES = {
-    // Latest recommended models per provider
-    LATEST_OPENAI: OpenAIModels.GPT_4O,
-    FASTEST_OPENAI: OpenAIModels.GPT_4O_MINI,
-    LATEST_ANTHROPIC: AnthropicModels.CLAUDE_3_5_SONNET,
-    FASTEST_ANTHROPIC: AnthropicModels.CLAUDE_3_5_HAIKU,
-    LATEST_GOOGLE: GoogleAIModels.GEMINI_2_5_PRO,
-    FASTEST_GOOGLE: GoogleAIModels.GEMINI_2_5_FLASH,
-    // Best models by use case
-    BEST_CODING: AnthropicModels.CLAUDE_3_5_SONNET,
-    BEST_ANALYSIS: GoogleAIModels.GEMINI_2_5_PRO,
-    BEST_CREATIVE: AnthropicModels.CLAUDE_3_5_SONNET,
-    BEST_VALUE: GoogleAIModels.GEMINI_2_5_FLASH,
-};
-/**
- * @deprecated Use DEFAULT_MODEL_ALIASES instead. Will be removed in future version.
- */
-export const ModelAliases = DEFAULT_MODEL_ALIASES;
-/**
- * Default provider configurations
- */
-export const DEFAULT_PROVIDER_CONFIGS = [
-    {
-        provider: AIProviderName.BEDROCK,
-        models: [BedrockModels.CLAUDE_3_7_SONNET, BedrockModels.CLAUDE_3_5_SONNET],
-    },
-    {
-        provider: AIProviderName.VERTEX,
-        models: [VertexModels.CLAUDE_4_0_SONNET, VertexModels.GEMINI_2_5_FLASH],
-    },
-    {
-        provider: AIProviderName.OPENAI,
-        models: [OpenAIModels.GPT_4O, OpenAIModels.GPT_4O_MINI],
-    },
-];

package/dist/client/types/proxyTypes.js

@@ -1,16 +0,0 @@
-/**
- * Proxy type definitions for NeuroLink
- *
- * Consolidates all proxy-related types from:
- * - src/lib/proxy/claudeFormat.ts (Claude API types, SSE types, internal result)
- * - src/lib/proxy/cloaking/types.ts (cloaking pipeline types)
- * - src/lib/proxy/cloaking/plugins/ (plugin option types)
- * - src/lib/proxy/modelRouter.ts (routing types)
- * - src/lib/proxy/proxyConfig.ts (config file types)
- * - src/lib/proxy/requestLogger.ts (log entry type)
- * - src/lib/proxy/usageStats.ts (stats types)
- * - src/lib/proxy/tokenRefresh.ts (refresh types)
- * - src/lib/proxy/accountQuota.ts (quota type)
- * - src/lib/server/routes/claudeProxyRoutes.ts (runtime state, deps)
- */
-export {};

package/dist/client/types/ragTypes.js

@@ -1,7 +0,0 @@
-/**
- * RAG Type Definitions
- *
- * Canonical type file for all RAG (Retrieval-Augmented Generation) interfaces.
- * All exported interfaces from src/lib/rag/ are collected here as type aliases.
- */
-export {};

package/dist/client/types/sdkTypes.js

@@ -1,8 +0,0 @@
-/**
- * NeuroLink SDK Core Types
- *
- * This file exposes ALL essential types that external developers need
- * when integrating with the NeuroLink SDK. Maximum type exposure for
- * comprehensive TypeScript support across the NeuroLink ecosystem.
- */
-export {};

package/dist/client/types/serviceTypes.js

@@ -1,5 +0,0 @@
-/**
- * Service-related type definitions for NeuroLink
- * Service registry, dependency injection, and service management types
- */
-export {};

package/dist/client/types/streamTypes.js

@@ -1 +0,0 @@
-export {};

package/dist/client/types/subscriptionTypes.js

@@ -1,9 +0,0 @@
-/**
- * Claude Subscription Types for NeuroLink
- *
- * Type definitions for Claude subscription tiers, authentication methods,
- * and usage tracking for Anthropic API access.
- */
-export {};
-// TokenStorageData and StoredProviderTokens are now in authTypes.ts and
-// re-exported at the top of this file for backward compatibility.

package/dist/client/types/taskClassificationTypes.js

@@ -1,5 +0,0 @@
-/**
- * Task Classification Types
- * Type definitions for the task classification system
- */
-export {};

package/dist/client/types/tools.js

@@ -1,24 +0,0 @@
-/**
- * Type definitions for NeuroLink tool system, including parameter schemas,
- * argument patterns, execution metadata, context, and result types.
- */
-/**
- * Type guard for tool result
- */
-export function isToolResult(value) {
-    return (typeof value === "object" &&
-        value !== null &&
-        "success" in value &&
-        typeof value.success === "boolean");
-}
-/**
- * Type guard for tool definition
- */
-export function isToolDefinition(value) {
-    return (typeof value === "object" &&
-        value !== null &&
-        "description" in value &&
-        "execute" in value &&
-        typeof value.description === "string" &&
-        typeof value.execute === "function");
-}

package/dist/client/types/ttsTypes.js

@@ -1,57 +0,0 @@
-/**
- * Text-to-Speech (TTS) Type Definitions for NeuroLink
- *
- * This module defines types for TTS audio generation and output.
- *
- * @module types/ttsTypes
- */
-/** Valid audio formats as an array for runtime validation */
-export const VALID_AUDIO_FORMATS = [
-    "mp3",
-    "wav",
-    "ogg",
-    "opus",
-];
-/** Valid TTS quality levels as an array for runtime validation */
-export const VALID_TTS_QUALITIES = ["standard", "hd"];
-/**
- * Type guard to check if an object is a TTSResult
- */
-export function isTTSResult(value) {
-    if (!value || typeof value !== "object") {
-        return false;
-    }
-    const obj = value;
-    return (Buffer.isBuffer(obj.buffer) &&
-        typeof obj.format === "string" &&
-        VALID_AUDIO_FORMATS.includes(obj.format) &&
-        typeof obj.size === "number" &&
-        obj.size >= 0);
-}
-/**
- * Type guard to check if TTSOptions are valid
- */
-export function isValidTTSOptions(options) {
-    if (!options || typeof options !== "object") {
-        return false;
-    }
-    const opts = options;
-    if (opts.speed !== undefined) {
-        if (typeof opts.speed !== "number" ||
-            opts.speed < 0.25 ||
-            opts.speed > 4.0) {
-            return false;
-        }
-    }
-    if (opts.format !== undefined) {
-        if (!VALID_AUDIO_FORMATS.includes(opts.format)) {
-            return false;
-        }
-    }
-    if (opts.quality !== undefined) {
-        if (!VALID_TTS_QUALITIES.includes(opts.quality)) {
-            return false;
-        }
-    }
-    return true;
-}

package/dist/client/types/typeAliases.js

@@ -1,48 +0,0 @@
-/**
- * Comprehensive Type Alias Library
- * Centralizes commonly used complex types to improve readability and maintainability
- */
-// ============================================================================
-// TYPE GUARDS AND UTILITIES
-// ============================================================================
-/**
- * Type guard for checking if value is a StandardRecord
- *
- * @param value - Value to check
- * @returns True if value is a non-null object (but not an array)
- *
- * @example
- * ```typescript
- * if (isStandardRecord(data)) {
- *   // TypeScript now knows data is Record<string, unknown>
- *   console.log(data.someProperty);
- * }
- * ```
- */
-export function isStandardRecord(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-/**
- * Type guard for checking if value is a JsonRecord
- */
-export function isJsonRecord(value) {
-    return (isStandardRecord(value) &&
-        Object.values(value).every((val) => val === null ||
-            typeof val === "string" ||
-            typeof val === "number" ||
-            typeof val === "boolean" ||
-            Array.isArray(val) ||
-            isJsonRecord(val)));
-}
-/**
- * Type guard for checking if value is a StringArray
- */
-export function isStringArray(value) {
-    return (Array.isArray(value) && value.every((item) => typeof item === "string"));
-}
-/**
- * Type guard for checking if value is an AsyncFunction
- */
-export function isAsyncFunction(value) {
-    return typeof value === "function";
-}

package/dist/client/types/utilities.js

@@ -1,4 +0,0 @@
-/**
- * Utility module types - extracted from utils module files
- */
-export {};

package/dist/client/types/workflowTypes.js

@@ -1,30 +0,0 @@
-/**
- * types/workflowTypes.ts
- * Core type definitions for the Workflow Engine
- *
- * Testing Phase: Focuses on original output + evaluation metrics for AB testing
- */
-/**
- * Workflow execution error class
- */
-export class WorkflowError extends Error {
-    details;
-    constructor(message, details) {
-        super(message);
-        this.name = "WorkflowError";
-        this.details = details;
-        // Maintain proper stack trace for V8 engines
-        if ("captureStackTrace" in Error &&
-            typeof Error.captureStackTrace === "function") {
-            Error.captureStackTrace(this, WorkflowError);
-        }
-    }
-}
-// ============================================================================
-// TYPE ALIASES FOR BACKWARD COMPATIBILITY (internal to workflow module only)
-// ============================================================================
-// Note: ModelConfig and EvaluationData aliases are NOT exported from this file
-// to avoid conflicts with modelTypes.ModelConfig and evaluation.EvaluationData.
-// Use WorkflowModelConfig and WorkflowEvaluationData when importing from this file.
-// The workflow/types.ts re-exports these aliases for backward compatibility
-// within the workflow module only.