@juspay/neurolink 9.14.0 → 9.15.0

package/dist/lib/types/subscriptionTypes.js

@@ -0,0 +1,8 @@
+/**
+ * Claude Subscription Types for NeuroLink
+ *
+ * Type definitions for Claude subscription tiers, authentication methods,
+ * and usage tracking for Anthropic API access.
+ */
+export {};
+//# sourceMappingURL=subscriptionTypes.js.map

package/dist/lib/utils/providerConfig.d.ts

@@ -3,14 +3,22 @@
  * Consolidated configuration helpers for all AI providers
  * Eliminates duplicate error messages and configuration logic
  * Enhanced with format validation and advanced error classification
+ * Extended with Claude subscription OAuth support
  */
 import type { APIValidationResult } from "../types/utilities.js";
 import type { ProviderConfigOptions } from "../types/providers.js";
+import type { AnthropicAuthMethod, ClaudeSubscriptionTier, AnthropicAuthConfig, AnthropicAuthConfigResult } from "../types/subscriptionTypes.js";
+export type { AnthropicAuthMethod, ClaudeSubscriptionTier, AnthropicAuthConfig, OAuthToken, AnthropicAuthConfigResult, } from "../types/subscriptionTypes.js";
 /**
  * API key format validation patterns (extracted from advanced validation system)
  * Exported for use across the codebase to replace scattered regex patterns
  */
 export declare const API_KEY_FORMATS: Record<string, RegExp>;
+/**
+ * OAuth token format validation patterns
+ * These patterns are more flexible as OAuth tokens can vary by provider
+ */
+export declare const OAUTH_TOKEN_FORMATS: Record<string, RegExp>;
 /**
  * API key length constants to replace scattered magic numbers
  */
@@ -67,6 +75,7 @@ export declare function getProviderModel(envVar: string, defaultModel: string):
 export declare function hasProviderCredentials(envVars: string[]): boolean;
 /**
  * Creates Anthropic provider configuration
+ * Supports both API key and OAuth authentication methods
  */
 export declare function createAnthropicConfig(): ProviderConfigOptions;
 /**
@@ -126,3 +135,161 @@ export declare function getAWSSessionToken(): string | undefined;
  * Checks if HuggingFace credentials are available
  */
 export declare function hasHuggingFaceCredentials(): boolean;
+/**
+ * Gets the configured Anthropic authentication method
+ * Defaults to "api_key" for backward compatibility
+ * @returns The configured authentication method
+ */
+export declare function getAnthropicAuthMethod(): AnthropicAuthMethod;
+/**
+ * Gets the configured Claude subscription tier
+ * Defaults to "api" for backward compatibility (API key users)
+ * @returns The configured subscription tier
+ */
+export declare function getAnthropicSubscriptionTier(): ClaudeSubscriptionTier;
+/**
+ * Validates OAuth access token format
+ * @param token The token to validate
+ * @returns True if the token format is valid
+ */
+export declare function validateOAuthAccessToken(token: string): boolean;
+/**
+ * Validates OAuth refresh token format
+ * @param token The token to validate
+ * @returns True if the token format is valid
+ */
+export declare function validateOAuthRefreshToken(token: string): boolean;
+/**
+ * Detects the best available authentication method for Anthropic
+ * Checks environment variables and returns the most appropriate auth configuration
+ * @returns Complete authentication configuration
+ */
+export declare function detectAnthropicAuth(): AnthropicAuthConfigResult;
+/**
+ * Checks if Anthropic credentials are available (either API key or OAuth)
+ * @returns True if any valid authentication is configured
+ */
+export declare function hasAnthropicCredentials(): boolean;
+/**
+ * Gets the authentication token or key for Anthropic API calls
+ * Returns the appropriate credential based on configured auth method
+ * @returns The API key or OAuth access token, or undefined if not configured
+ */
+export declare function getAnthropicCredential(): string | undefined;
+/**
+ * Checks if OAuth refresh is needed based on token state
+ * This is a placeholder for actual token expiration checking
+ * @returns True if refresh is needed
+ */
+export declare function needsOAuthRefresh(): boolean;
+/**
+ * Gets subscription tier limits for informational purposes
+ * These are approximate limits and may change
+ * @param tier The subscription tier
+ * @returns Object with tier limit information
+ */
+export declare function getSubscriptionTierLimits(tier: ClaudeSubscriptionTier): {
+    messagesPerDay: number | "unlimited";
+    contextWindow: number;
+    priorityAccess: boolean;
+    description: string;
+};
+/**
+ * Environment variables for Anthropic/Claude subscription configuration
+ * These control authentication method, subscription tier, and feature flags
+ */
+export declare const ANTHROPIC_ENV_VARS: {
+    /** Authentication method: "api_key" or "oauth" */
+    readonly AUTH_METHOD: "ANTHROPIC_AUTH_METHOD";
+    /** Subscription tier: "free", "pro", "max", "max_5", "max_20", or "api" */
+    readonly SUBSCRIPTION_TIER: "ANTHROPIC_SUBSCRIPTION_TIER";
+    /** Enable beta features: "true" or "false" */
+    readonly ENABLE_BETA_FEATURES: "ANTHROPIC_ENABLE_BETA_FEATURES";
+    /** API key for api_key authentication */
+    readonly API_KEY: "ANTHROPIC_API_KEY";
+    /** OAuth access token for oauth authentication (canonical, with BC fallbacks) */
+    readonly OAUTH_ACCESS_TOKEN: "ANTHROPIC_OAUTH_TOKEN";
+    /** OAuth refresh token for oauth authentication */
+    readonly OAUTH_REFRESH_TOKEN: "ANTHROPIC_OAUTH_REFRESH_TOKEN";
+    /** OAuth token expiry timestamp (Unix epoch in seconds) */
+    readonly OAUTH_TOKEN_EXPIRY: "ANTHROPIC_OAUTH_TOKEN_EXPIRY";
+};
+/**
+ * Valid subscription tier values for validation
+ */
+export declare const VALID_SUBSCRIPTION_TIERS: readonly ClaudeSubscriptionTier[];
+/**
+ * Valid authentication method values for validation
+ */
+export declare const VALID_AUTH_METHODS: readonly AnthropicAuthMethod[];
+/**
+ * Validates a subscription tier value
+ * @param tier The tier value to validate
+ * @returns True if the tier is valid, false otherwise
+ */
+export declare function isValidSubscriptionTier(tier: string | undefined): tier is ClaudeSubscriptionTier;
+/**
+ * Validates an authentication method value
+ * @param method The method value to validate
+ * @returns True if the method is valid, false otherwise
+ */
+export declare function isValidAuthMethod(method: string | undefined): method is AnthropicAuthMethod;
+/**
+ * Validates subscription tier and returns a detailed result
+ * @param tier The tier value to validate
+ * @returns Validation result with error details if invalid
+ */
+export declare function validateSubscriptionTier(tier: string | undefined): {
+    isValid: boolean;
+    tier?: ClaudeSubscriptionTier;
+    error?: string;
+};
+/**
+ * Gets the complete Anthropic authentication configuration
+ * Detects auth method from environment or config and loads appropriate credentials
+ *
+ * @returns Complete AnthropicAuthConfig with method, credentials, and tier
+ */
+export declare function getAnthropicAuthConfig(): AnthropicAuthConfig;
+/**
+ * Detects the subscription tier from environment variables or config
+ * Checks environment variable first, then config, defaults to "api" if using API key
+ *
+ * @returns The detected subscription tier
+ */
+export declare function detectSubscriptionTier(): ClaudeSubscriptionTier;
+/**
+ * Determines whether beta features should be enabled
+ * Checks environment/config and defaults based on authentication method
+ *
+ * @returns True if beta features should be enabled
+ */
+export declare function shouldEnableBetaFeatures(): boolean;
+/**
+ * Gets complete subscription configuration including auth, tier, and features
+ * Combines all configuration sources into a unified config object
+ *
+ * @returns Complete subscription configuration
+ */
+export declare function getAnthropicSubscriptionConfig(): {
+    auth: AnthropicAuthConfig;
+    tier: ClaudeSubscriptionTier;
+    betaFeaturesEnabled: boolean;
+    limits: ReturnType<typeof getSubscriptionTierLimits>;
+    isConfigured: boolean;
+    error?: string;
+};
+/**
+ * Checks if the current subscription tier has access to a specific feature
+ * @param feature The feature to check
+ * @param currentTier The current subscription tier (optional, auto-detects if not provided)
+ * @returns True if the tier has access to the feature
+ */
+export declare function hasSubscriptionFeature(feature: "extended_thinking" | "priority_access" | "vision" | "file_analysis" | "mcp_tools" | "computer_use" | "web_search", currentTier?: ClaudeSubscriptionTier): boolean;
+/**
+ * Gets a human-readable description of the current authentication configuration
+ * Useful for debugging and user feedback
+ *
+ * @returns Human-readable configuration description
+ */
+export declare function describeAnthropicConfig(): string;