@juspay/neurolink 9.14.0 → 9.15.0

package/dist/types/errors.d.ts

@@ -42,3 +42,65 @@ export declare class RateLimitError extends ProviderError {
 export declare class InvalidModelError extends ProviderError {
     constructor(message: string, provider?: string);
 }
+/**
+ * Base class for OAuth-specific errors
+ */
+export declare class OAuthError extends BaseError {
+    code?: string | undefined;
+    constructor(message: string, code?: string | undefined);
+}
+/**
+ * Thrown when OAuth configuration is invalid or missing
+ */
+export declare class OAuthConfigurationError extends OAuthError {
+    constructor(message: string);
+}
+/**
+ * Thrown when authorization code exchange fails
+ */
+export declare class OAuthTokenExchangeError extends OAuthError {
+    statusCode?: number | undefined;
+    constructor(message: string, statusCode?: number | undefined);
+}
+/**
+ * Thrown when token refresh fails
+ */
+export declare class OAuthTokenRefreshError extends OAuthError {
+    statusCode?: number | undefined;
+    constructor(message: string, statusCode?: number | undefined);
+}
+/**
+ * Thrown when token validation fails
+ */
+export declare class OAuthTokenValidationError extends OAuthError {
+    constructor(message: string);
+}
+/**
+ * Thrown when token revocation fails
+ */
+export declare class OAuthTokenRevocationError extends OAuthError {
+    statusCode?: number | undefined;
+    constructor(message: string, statusCode?: number | undefined);
+}
+/**
+ * Thrown when callback server operations fail
+ */
+export declare class OAuthCallbackServerError extends OAuthError {
+    constructor(message: string);
+}
+/**
+ * Token storage error for authentication-related failures
+ */
+export declare class TokenStoreError extends BaseError {
+    readonly code: "STORAGE_ERROR" | "ENCRYPTION_ERROR" | "VALIDATION_ERROR" | "NOT_FOUND" | "REFRESH_ERROR";
+    constructor(message: string, code?: "STORAGE_ERROR" | "ENCRYPTION_ERROR" | "VALIDATION_ERROR" | "NOT_FOUND" | "REFRESH_ERROR");
+}
+/**
+ * Error thrown when model access is denied based on subscription tier
+ */
+export declare class ModelAccessError extends BaseError {
+    readonly model: string;
+    readonly tier: string;
+    readonly requiredTier: string;
+    constructor(model: string, tier: string, requiredTier: string);
+}

package/dist/types/errors.js

@@ -58,3 +58,110 @@ export class InvalidModelError extends ProviderError {
         super(message, provider);
     }
 }
+// =============================================================================
+// OAUTH ERROR CLASSES
+// =============================================================================
+/**
+ * Base class for OAuth-specific errors
+ */
+export class OAuthError extends BaseError {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = "OAuthError";
+    }
+}
+/**
+ * Thrown when OAuth configuration is invalid or missing
+ */
+export class OAuthConfigurationError extends OAuthError {
+    constructor(message) {
+        super(message, "CONFIGURATION_ERROR");
+        this.name = "OAuthConfigurationError";
+    }
+}
+/**
+ * Thrown when authorization code exchange fails
+ */
+export class OAuthTokenExchangeError extends OAuthError {
+    statusCode;
+    constructor(message, statusCode) {
+        super(message, "TOKEN_EXCHANGE_ERROR");
+        this.statusCode = statusCode;
+        this.name = "OAuthTokenExchangeError";
+    }
+}
+/**
+ * Thrown when token refresh fails
+ */
+export class OAuthTokenRefreshError extends OAuthError {
+    statusCode;
+    constructor(message, statusCode) {
+        super(message, "TOKEN_REFRESH_ERROR");
+        this.statusCode = statusCode;
+        this.name = "OAuthTokenRefreshError";
+    }
+}
+/**
+ * Thrown when token validation fails
+ */
+export class OAuthTokenValidationError extends OAuthError {
+    constructor(message) {
+        super(message, "TOKEN_VALIDATION_ERROR");
+        this.name = "OAuthTokenValidationError";
+    }
+}
+/**
+ * Thrown when token revocation fails
+ */
+export class OAuthTokenRevocationError extends OAuthError {
+    statusCode;
+    constructor(message, statusCode) {
+        super(message, "TOKEN_REVOCATION_ERROR");
+        this.statusCode = statusCode;
+        this.name = "OAuthTokenRevocationError";
+    }
+}
+/**
+ * Thrown when callback server operations fail
+ */
+export class OAuthCallbackServerError extends OAuthError {
+    constructor(message) {
+        super(message, "CALLBACK_SERVER_ERROR");
+        this.name = "OAuthCallbackServerError";
+    }
+}
+// =============================================================================
+// TOKEN STORE ERROR
+// =============================================================================
+/**
+ * Token storage error for authentication-related failures
+ */
+export class TokenStoreError extends BaseError {
+    code;
+    constructor(message, code = "STORAGE_ERROR") {
+        super(message);
+        this.code = code;
+        this.name = "TokenStoreError";
+    }
+}
+// =============================================================================
+// MODEL ACCESS ERROR
+// =============================================================================
+/**
+ * Error thrown when model access is denied based on subscription tier
+ */
+export class ModelAccessError extends BaseError {
+    model;
+    tier;
+    requiredTier;
+    constructor(model, tier, requiredTier) {
+        super(`Model "${model}" is not available for tier "${tier}". ` +
+            `Required tier: "${requiredTier}" or higher.`);
+        this.name = "ModelAccessError";
+        this.model = model;
+        this.tier = tier;
+        this.requiredTier = requiredTier;
+    }
+}

package/dist/types/index.d.ts

@@ -6,7 +6,7 @@ export * from "./cli.js";
 export * from "./common.js";
 export type { AnalyticsConfig, BackupInfo, BackupMetadata, CacheConfig, ConfigUpdateOptions, ConfigValidationResult, FallbackConfig, NeuroLinkConfig, PerformanceConfig, RetryConfig, ToolConfig, } from "./configTypes.js";
 export type { ExternalMCPConfigValidation, ExternalMCPManagerConfig, ExternalMCPOperationResult, ExternalMCPServerEvents, ExternalMCPServerHealth, ExternalMCPServerInstance, ExternalMCPServerStatus, ExternalMCPToolContext, ExternalMCPToolInfo, ExternalMCPToolResult, } from "./externalMcp.js";
-export type { AuthorizationUrlResult, CircuitBreakerConfig, CircuitBreakerEvents, CircuitBreakerState, CircuitBreakerStats, DiscoveredMcp, ExternalToolExecutionOptions, FlexibleValidationResult, HTTPRetryConfig, MCPClientResult, MCPConnectedServer, MCPDiscoveredServer, MCPExecutableTool, MCPOAuthConfig, MCPServerCategory, MCPServerConfig, MCPServerConnectionStatus, MCPServerMetadata, MCPServerRegistryEntry, MCPServerStatus, MCPToolInfo, MCPToolMetadata, MCPTransportType, McpMetadata, McpRegistry, NeuroLinkExecutionContext, NeuroLinkMCPServer, NeuroLinkMCPTool, OAuthClientInformation, OAuthTokens, RateLimitConfig, TokenBucketRateLimitConfig, TokenExchangeRequest, TokenStorage, ToolDiscoveryResult, ToolRegistryEvents, ToolValidationResult, } from "./mcpTypes.js";
+export type { AuthorizationUrlResult, CircuitBreakerConfig, CircuitBreakerEvents, CircuitBreakerState, CircuitBreakerStats, DiscoveredMcp, ExternalToolExecutionOptions, FlexibleValidationResult, HTTPRetryConfig, MCPClientResult, MCPConnectedServer, MCPDiscoveredServer, MCPExecutableTool, MCPOAuthConfig, MCPServerCategory, MCPServerConfig, MCPServerConnectionStatus, MCPServerMetadata, MCPServerRegistryEntry, MCPServerStatus, MCPToolInfo, MCPToolMetadata, MCPTransportType, McpMetadata, McpRegistry, NeuroLinkExecutionContext, NeuroLinkMCPServer, NeuroLinkMCPTool, OAuthClientInformation, OAuthTokens as McpOAuthTokens, RateLimitConfig, TokenBucketRateLimitConfig, TokenExchangeRequest, TokenStorage, ToolDiscoveryResult, ToolRegistryEvents, ToolValidationResult, } from "./mcpTypes.js";
 export type { ModelCapability, ModelFilter, ModelPricing, ModelResolutionContext, ModelStats, ModelUseCase, } from "./providers.js";
 export * from "./providers.js";
 export * from "./taskClassificationTypes.js";
@@ -38,3 +38,4 @@ export * from "./contextTypes.js";
 export * from "./fileReferenceTypes.js";
 export * from "./ragTypes.js";
 export * from "./conversationMemoryInterface.js";
+export * from "./subscriptionTypes.js";

package/dist/types/index.js

@@ -48,3 +48,5 @@ export * from "./fileReferenceTypes.js";
 export * from "./ragTypes.js";
 // Conversation memory manager type
 export * from "./conversationMemoryInterface.js";
+// Subscription types (Claude subscription tiers, authentication, usage tracking)
+export * from "./subscriptionTypes.js";

package/dist/types/providers.d.ts

@@ -8,6 +8,8 @@ import type { ValidationSchema } from "./typeAliases.js";
 import type { EnhancedGenerateResult, GenerateResult, TextGenerationOptions } from "./generateTypes.js";
 import type { StreamOptions, StreamResult } from "./streamTypes.js";
 import type { ExternalMCPToolInfo } from "./externalMcp.js";
+import type { ClaudeSubscriptionTier, AnthropicAuthMethod, AnthropicAuthConfig, SubscriptionInfo } from "./subscriptionTypes.js";
+export type { ClaudeSubscriptionTier, AnthropicAuthMethod, AnthropicAuthConfig, SubscriptionInfo, } from "./subscriptionTypes.js";
 /**
  * Generic AI SDK model interface
  */
@@ -33,6 +35,15 @@ export type ProviderStatus = {
     error?: string;
     responseTime?: number;
     model?: string;
+    /**
+     * Subscription information for providers that support subscription tiers
+     * (e.g., Anthropic Claude with Pro/Max/Team/Enterprise subscriptions)
+     */
+    subscription?: SubscriptionInfo;
+    /**
+     * The authentication method currently in use for this provider
+     */
+    authMethod?: AnthropicAuthMethod;
 };
 /**
  * Provider error information
@@ -185,6 +196,16 @@ export type ProviderCapabilities = {
     supportsAudio: boolean;
     maxTokens?: number;
     supportedModels: string[];
+    /**
+     * Whether the provider supports subscription-based features and tier management
+     * When true, the provider can adapt behavior based on subscription tier
+     */
+    subscriptionAware?: boolean;
+    /**
+     * List of authentication methods supported by this provider
+     * e.g., ["api_key", "oauth", "session_token", "environment"]
+     */
+    supportedAuthMethods?: string[];
 };
 /**
  * Provider configuration specifying provider and its available models (from core types)
@@ -202,8 +223,94 @@ export type IndividualProviderConfig = {
     timeout?: number;
     retries?: number;
     model?: string;
+    /**
+     * The subscription tier for the provider (e.g., Claude Pro, Max, Team, Enterprise)
+     * Used to determine rate limits, available features, and pricing
+     */
+    subscriptionTier?: ClaudeSubscriptionTier;
+    /**
+     * The authentication method to use for the provider
+     * Supports API key, OAuth, session token, or environment variable
+     */
+    authMethod?: AnthropicAuthMethod;
+    /**
+     * Detailed authentication configuration including credentials and options
+     */
+    authConfig?: AnthropicAuthConfig;
+    /**
+     * Whether to enable beta features for the provider
+     * Beta features may be unstable or subject to change
+     */
+    enableBetaFeatures?: boolean;
     [key: string]: unknown;
 };
+/**
+ * Anthropic-specific provider configuration
+ *
+ * @description Extends the base provider configuration with Anthropic-specific
+ * options for OAuth, subscription management, and beta features.
+ */
+export type AnthropicProviderConfig = IndividualProviderConfig & {
+    /**
+     * The subscription tier for Claude access
+     */
+    subscriptionTier?: ClaudeSubscriptionTier;
+    /**
+     * The authentication method to use
+     */
+    authMethod?: AnthropicAuthMethod;
+    /**
+     * Whether to enable beta features
+     */
+    enableBetaFeatures?: boolean;
+    /**
+     * OAuth token for OAuth authentication.
+     * Required when authMethod is "oauth".
+     */
+    oauthToken?: import("./subscriptionTypes.js").OAuthToken;
+    /**
+     * OAuth configuration for OAuth-based authentication
+     */
+    oauthConfig?: {
+        /**
+         * OAuth client ID for the application
+         */
+        clientId?: string;
+        /**
+         * OAuth redirect URI for the callback
+         */
+        redirectUri?: string;
+        /**
+         * OAuth scopes to request
+         */
+        scopes?: string[];
+        /**
+         * OAuth authorization endpoint URL
+         */
+        authorizationEndpoint?: string;
+        /**
+         * OAuth token endpoint URL
+         */
+        tokenEndpoint?: string;
+    };
+};
+/**
+ * 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 declare function isAnthropicConfig(config: unknown): config is AnthropicProviderConfig;
 /**
  * Configuration options for provider validation
  */

package/dist/types/providers.js

@@ -2,6 +2,75 @@
  * 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
  */