@lockllm/sdk 1.0.1 → 1.2.0

package/README.md

@@ -10,7 +10,7 @@
 
 **All-in-One AI Security for LLM Applications**
 
-*Keep control of your AI. Detect prompt injection, jailbreaks, and adversarial attacks in real-time across 15+ providers with zero code changes.*
+*Keep control of your AI. Detect prompt injection, jailbreaks, PII leakage, and adversarial attacks in real-time across 17+ providers with zero code changes.*
 
 [Quick Start](#quick-start) · [Documentation](https://www.lockllm.com/docs) · [Examples](#examples) · [Benchmarks](https://www.lockllm.com) · [API Reference](#api-reference)
 
@@ -26,9 +26,9 @@ LockLLM is a state-of-the-art AI security ecosystem that detects prompt injectio
 
 - **Real-Time Security Scanning** - Analyze every LLM request before execution with minimal latency (<250ms)
 - **Advanced ML Detection** - Models trained on real-world attack patterns for prompt injection and jailbreaks
-- **15+ Provider Support** - Universal coverage across OpenAI, Anthropic, Azure, Bedrock, Gemini, and more
+- **17+ Provider Support** - Universal coverage across OpenAI, Anthropic, Azure, Bedrock, Gemini, and more
 - **Drop-in Integration** - Replace existing SDKs with zero code changes - just change one line
-- **Completely Free** - BYOK (Bring Your Own Key) model with unlimited usage and no rate limits
+- **Free Unlimited Scanning** - BYOK (Bring Your Own Key) model with free unlimited scanning
 - **Privacy by Default** - Your data is never stored, only scanned in-memory and discarded
 
 ## Why LockLLM
@@ -73,27 +73,54 @@ LockLLM provides production-ready AI security that integrates seamlessly into yo
 | **Evasion & Obfuscation Detection** | Catch sophisticated obfuscation including Unicode abuse, zero-width characters, and encoding-based attacks |
 | **Multi-Layer Context Analysis** | Analyze prompts across multiple context windows to detect attacks spanning conversation turns |
 | **Token-Level Threat Scoring** | Granular threat assessment identifying which specific parts of input contain malicious patterns |
-| **15+ Provider Support** | OpenAI, Anthropic, Gemini, Azure, Bedrock, Groq, DeepSeek, and more |
+| **17+ Provider Support** | OpenAI, Anthropic, Gemini, Azure, Bedrock, Groq, DeepSeek, and more |
 | **Drop-in Integration** | Replace `new OpenAI()` with `createOpenAI()` - no other changes needed |
 | **TypeScript Native** | Full type safety with comprehensive type definitions and IDE support |
 | **Streaming Compatible** | Works seamlessly with streaming responses from any provider |
 | **Configurable Sensitivity** | Adjust detection thresholds (low/medium/high) per use case |
-| **Custom Endpoints** | Support for self-hosted models, Azure resources, and private clouds |
+| **Custom Endpoints** | Configure custom URLs for any provider (self-hosted, Azure, private clouds) |
+| **Custom Content Policies** | Define your own content rules in the dashboard and enforce them automatically across all providers |
+| **AI Abuse Detection** | Detect bot-generated content, repetition attacks, and resource exhaustion from your end-users |
+| **Intelligent Routing** | Automatically select the optimal model for each request based on task type and complexity to save costs |
+| **PII Detection & Redaction** | Detect and automatically redact emails, phone numbers, SSNs, credit cards, and other personal information before they reach AI providers |
+| **Response Caching** | Cache identical LLM responses to reduce costs and latency on repeated queries |
 | **Enterprise Privacy** | Provider keys encrypted at rest, prompts never stored |
 | **Production Ready** | Battle-tested with automatic retries, timeouts, and error handling |
 
 ## Installation
 
+Choose your preferred package manager:
 ```bash
-# Install the SDK
+# npm
 npm install @lockllm/sdk
 
-# For wrapper functions, install relevant peer dependencies
-npm install openai              # For OpenAI, Groq, DeepSeek, Mistral, etc.
-npm install @anthropic-ai/sdk   # For Anthropic Claude
-npm install cohere-ai           # For Cohere (optional)
+# pnpm (faster, saves disk space)
+pnpm add @lockllm/sdk
+
+# yarn
+yarn add @lockllm/sdk
+```
+
+### Peer Dependencies
+
+For wrapper functions, install the relevant provider SDKs:
+
+```bash
+# npm
+npm install openai @anthropic-ai/sdk cohere-ai
+
+# pnpm
+pnpm add openai @anthropic-ai/sdk cohere-ai
+
+# yarn
+yarn add openai @anthropic-ai/sdk cohere-ai
 ```
 
+**Provider breakdown:**
+- `openai` - For OpenAI, Groq, DeepSeek, Mistral, etc.
+- `@anthropic-ai/sdk` - For Anthropic Claude
+- `cohere-ai` - For Cohere (optional)
+
 **Note:** Peer dependencies are optional and only required if you use the wrapper functions for those providers.
 
 ## Quick Start
@@ -222,7 +249,7 @@ Compare detection accuracy and performance metrics at [lockllm.com/benchmarks](h
 | **Real-Time Protection** | ✅ <250ms latency | ✅ Built-in | ✅ Yes | ❌ Too slow |
 | **Setup Time** | 5 minutes | Included | Days to weeks | N/A |
 | **Maintenance** | None | None | Constant updates | Constant |
-| **Multi-Provider Support** | ✅ 15+ providers | Single provider | Custom per provider | N/A |
+| **Multi-Provider Support** | ✅ 17+ providers | Single provider | Custom per provider | N/A |
 | **False Positives** | Low (~2-5%) | N/A | High (15-30%) | N/A |
 | **Cost** | Free (BYOK) | Free | Dev time + infrastructure | $$$ |
 | **Attack Coverage** | Comprehensive | Content policy only | Pattern-based only | Manual |
@@ -378,6 +405,10 @@ const highResult = await lockllm.scan({
 import {
   LockLLMError,
   PromptInjectionError,
+  PolicyViolationError,
+  AbuseDetectedError,
+  PIIDetectedError,
+  InsufficientCreditsError,
   AuthenticationError,
   RateLimitError,
   UpstreamError
@@ -395,13 +426,24 @@ try {
     console.log("Injection confidence:", error.scanResult.injection);
     console.log("Request ID:", error.requestId);
 
-    // Log to security monitoring system
-    await logSecurityIncident({
-      type: 'prompt_injection',
-      confidence: error.scanResult.injection,
-      requestId: error.requestId,
-      timestamp: new Date()
-    });
+  } else if (error instanceof PolicyViolationError) {
+    // Custom policy violation detected
+    console.log("Policy violation:", error.violated_policies);
+
+  } else if (error instanceof AbuseDetectedError) {
+    // AI abuse detected (bot content, repetition, etc.)
+    console.log("Abuse detected:", error.abuse_details.abuse_types);
+    console.log("Confidence:", error.abuse_details.confidence);
+
+  } else if (error instanceof PIIDetectedError) {
+    // Personal information detected (when piiAction is 'block')
+    console.log("PII found:", error.pii_details.entity_types);
+    console.log("Entity count:", error.pii_details.entity_count);
+
+  } else if (error instanceof InsufficientCreditsError) {
+    // Not enough credits
+    console.log("Balance:", error.current_balance);
+    console.log("Cost:", error.estimated_cost);
 
   } else if (error instanceof AuthenticationError) {
     console.log("Invalid LockLLM API key");
@@ -422,7 +464,7 @@ try {
 
 ## Supported Providers
 
-LockLLM supports 17 AI providers with three flexible integration methods:
+LockLLM supports 17+ AI providers with three flexible integration methods:
 
 ### Provider List
 
@@ -449,13 +491,16 @@ LockLLM supports 17 AI providers with three flexible integration methods:
 ### Custom Endpoints
 
 All providers support custom endpoint URLs for:
-- Self-hosted LLM deployments
-- Alternative API gateways
+- Self-hosted LLM deployments (OpenAI-compatible APIs)
+- Alternative API gateways and reverse proxies
 - Custom Azure OpenAI resources
-- Private cloud deployments
+- Private cloud or air-gapped deployments
 - Development and staging environments
 
-Configure custom endpoints in the [LockLLM dashboard](https://www.lockllm.com/dashboard) when adding provider API keys.
+**How it works:**
+Configure custom endpoints in the [LockLLM dashboard](https://www.lockllm.com/dashboard) when adding any provider API key. The SDK wrappers automatically use your custom endpoint instead of the default.
+
+**Example:** Use the OpenAI wrapper with your self-hosted Llama model by configuring a custom endpoint URL.
 
 ## How It Works
 
@@ -476,7 +521,7 @@ LockLLM uses a secure BYOK (Bring Your Own Key) model - you maintain control of
 
 - Use this single key in your SDK configuration
 - Authenticates requests to the LockLLM security gateway
-- Works across all 15+ providers with one key
+- Works across all 17+ providers with one key
 - **This is the only key that goes in your code**
 
 ### Request Flow
@@ -510,7 +555,7 @@ LockLLM Security Gateway
 3. **Error Response** - Detailed error returned with threat classification and confidence scores
 4. **Logging** - Incident automatically logged in [dashboard](https://www.lockllm.com/dashboard) for review and monitoring
 
-### Security & Privacy
+### Privacy & Security
 
 LockLLM is built with privacy and security as core principles. Your data stays yours.
 
@@ -562,7 +607,7 @@ interface LockLLMConfig {
 Scan a prompt for security threats before sending to an LLM.
 
 ```typescript
-await lockllm.scan(request: ScanRequest): Promise<ScanResponse>
+await lockllm.scan(request: ScanRequest, options?: ScanOptions): Promise<ScanResponse>
 ```
 
 **Request Parameters:**
@@ -571,6 +616,15 @@ await lockllm.scan(request: ScanRequest): Promise<ScanResponse>
 interface ScanRequest {
   input: string;                           // Required: Text to scan
   sensitivity?: 'low' | 'medium' | 'high'; // Optional: Detection level (default: 'medium')
+  mode?: 'normal' | 'policy_only' | 'combined'; // Optional: Scan mode (default: 'combined')
+  chunk?: boolean;                         // Optional: Force chunking for long texts
+}
+
+interface ScanOptions {
+  scanAction?: 'block' | 'allow_with_warning';   // Core injection behavior
+  policyAction?: 'block' | 'allow_with_warning'; // Custom policy behavior
+  abuseAction?: 'block' | 'allow_with_warning';  // Abuse detection (opt-in)
+  piiAction?: 'strip' | 'block' | 'allow_with_warning'; // PII detection (opt-in)
 }
 ```
 
@@ -580,8 +634,9 @@ interface ScanRequest {
 interface ScanResponse {
   safe: boolean;             // Whether input is safe (true) or malicious (false)
   label: 0 | 1;             // Classification: 0=safe, 1=malicious
-  confidence: number;        // Confidence score (0-1)
-  injection: number;         // Injection risk score (0-1, higher=more risky)
+  confidence?: number;       // Core injection confidence score (0-1)
+  injection?: number;        // Injection risk score (0-1, higher=more risky)
+  policy_confidence?: number; // Policy check confidence (in combined/policy_only mode)
   sensitivity: Sensitivity;  // Sensitivity level used for scan
   request_id: string;        // Unique request identifier
 
@@ -590,11 +645,29 @@ interface ScanResponse {
     input_chars: number;     // Number of characters processed
   };
 
-  debug?: {                 // Only available with Pro plan
+  debug?: {
     duration_ms: number;    // Total processing time
     inference_ms: number;   // ML inference time
     mode: 'single' | 'chunked';
   };
+
+  // Present when using policy_only or combined mode with allow_with_warning
+  policy_warnings?: PolicyViolation[];
+  // Present when core injection detected with allow_with_warning
+  scan_warning?: ScanWarning;
+  // Present when abuse detection is enabled and abuse found
+  abuse_warnings?: AbuseWarning;
+  // Present when intelligent routing is enabled
+  routing?: { task_type: string; complexity: number; selected_model?: string; };
+  // Present when PII detection is enabled
+  pii_result?: PIIResult;
+}
+
+interface PIIResult {
+  detected: boolean;          // Whether PII was detected
+  entity_types: string[];     // Types of PII entities found (e.g., 'email', 'phone_number')
+  entity_count: number;       // Number of PII entities found
+  redacted_input?: string;    // Redacted text (only present when piiAction is 'strip')
 }
 ```
 
@@ -615,6 +688,17 @@ createGroq(config: GenericClientConfig): OpenAI
 interface GenericClientConfig {
   apiKey: string;           // Required: Your LockLLM API key
   baseURL?: string;         // Optional: Override proxy URL
+  proxyOptions?: {          // Optional: Security and routing configuration
+    scanMode?: 'normal' | 'policy_only' | 'combined';
+    scanAction?: 'block' | 'allow_with_warning';
+    policyAction?: 'block' | 'allow_with_warning';
+    abuseAction?: 'block' | 'allow_with_warning' | null;
+    piiAction?: 'strip' | 'block' | 'allow_with_warning' | null;
+    routeAction?: 'disabled' | 'auto' | 'custom';
+    sensitivity?: 'low' | 'medium' | 'high';
+    cacheResponse?: boolean;
+    cacheTTL?: number;
+  };
   [key: string]: any;       // Optional: Provider-specific options
 }
 ```
@@ -631,6 +715,16 @@ const url = getProxyURL('openai');
 // Returns: 'https://api.lockllm.com/v1/proxy/openai'
 ```
 
+**Get universal proxy URL (non-BYOK, 200+ models):**
+
+```typescript
+function getUniversalProxyURL(): string
+
+// Example
+const url = getUniversalProxyURL();
+// Returns: 'https://api.lockllm.com/v1/proxy/chat/completions'
+```
+
 **Get all proxy URLs:**
 
 ```typescript
@@ -642,6 +736,36 @@ console.log(urls.openai);     // 'https://api.lockllm.com/v1/proxy/openai'
 console.log(urls.anthropic);  // 'https://api.lockllm.com/v1/proxy/anthropic'
 ```
 
+**Build LockLLM proxy headers:**
+
+```typescript
+import { buildLockLLMHeaders } from '@lockllm/sdk';
+
+const headers = buildLockLLMHeaders({
+  scanMode: 'combined',
+  scanAction: 'block',
+  policyAction: 'allow_with_warning',
+  abuseAction: 'block',
+  piiAction: 'strip',
+  routeAction: 'auto'
+});
+// Returns: { 'x-lockllm-scan-mode': 'combined', 'x-lockllm-pii-action': 'strip', ... }
+```
+
+**Parse proxy response metadata:**
+
+```typescript
+import { parseProxyMetadata } from '@lockllm/sdk';
+
+// Parse response headers from any proxy request
+const metadata = parseProxyMetadata(response.headers);
+console.log(metadata.safe);          // true/false
+console.log(metadata.scan_mode);     // 'combined'
+console.log(metadata.cache_status);  // 'HIT' or 'MISS'
+console.log(metadata.routing);       // { task_type, complexity, selected_model, ... }
+console.log(metadata.pii_detected);  // { detected, entity_types, entity_count, action }
+```
+
 ## Error Types
 
 LockLLM provides typed errors for comprehensive error handling:
@@ -653,6 +777,10 @@ LockLLMError (base)
 ├── AuthenticationError (401)
 ├── RateLimitError (429)
 ├── PromptInjectionError (400)
+├── PolicyViolationError (403)
+├── AbuseDetectedError (400)
+├── PIIDetectedError (403)
+├── InsufficientCreditsError (402)
 ├── UpstreamError (502)
 ├── ConfigurationError (400)
 └── NetworkError (0)
@@ -676,6 +804,39 @@ class RateLimitError extends LockLLMError {
   retryAfter?: number;     // Milliseconds until retry allowed
 }
 
+class PolicyViolationError extends LockLLMError {
+  violated_policies: Array<{
+    policy_name: string;
+    violated_categories: Array<{ name: string }>;
+    violation_details?: string;
+  }>;
+}
+
+class AbuseDetectedError extends LockLLMError {
+  abuse_details: {
+    confidence: number;
+    abuse_types: string[];
+    indicators: {
+      bot_score: number;
+      repetition_score: number;
+      resource_score: number;
+      pattern_score: number;
+    };
+  };
+}
+
+class PIIDetectedError extends LockLLMError {
+  pii_details: {
+    entity_types: string[];  // PII types found (e.g., 'email', 'phone_number')
+    entity_count: number;    // Number of PII entities detected
+  };
+}
+
+class InsufficientCreditsError extends LockLLMError {
+  current_balance: number;  // Current credit balance
+  estimated_cost: number;   // Estimated cost of the request
+}
+
 class UpstreamError extends LockLLMError {
   provider?: string;       // Provider name
   upstreamStatus?: number; // Provider's status code
@@ -707,13 +868,22 @@ LockLLM adds minimal latency while providing comprehensive security protection.
 
 ## Rate Limits
 
-LockLLM provides generous rate limits for all users, with the Free tier supporting most production use cases.
+LockLLM uses a 10-tier progressive system based on monthly usage. Higher tiers unlock faster rate limits and free monthly credits.
+
+| Tier | Max RPM | Monthly Spending Requirement |
+|------|---------|----------------------------|
+| **Tier 1** (Free) | 30 RPM | $0 |
+| **Tier 2** | 50 RPM | $10/month |
+| **Tier 3** | 100 RPM | $50/month |
+| **Tier 4** | 200 RPM | $100/month |
+| **Tier 5** | 500 RPM | $250/month |
+| **Tier 6** | 1,000 RPM | $500/month |
+| **Tier 7** | 2,000 RPM | $1,000/month |
+| **Tier 8** | 5,000 RPM | $3,000/month |
+| **Tier 9** | 10,000 RPM | $5,000/month |
+| **Tier 10** | 20,000 RPM | $10,000/month |
 
-| Tier | Requests per Minute | Best For |
-|------|---------------------|----------|
-| **Free** | 1,000 RPM | Most applications, startups, side projects |
-| **Pro** | 10,000 RPM | High-traffic applications, enterprise pilots |
-| **Enterprise** | Custom | Large-scale deployments, custom SLAs |
+See [pricing](https://www.lockllm.com/pricing) for full tier details and free monthly credits.
 
 **Smart Rate Limit Handling:**
 
@@ -751,6 +921,68 @@ const lockllm = new LockLLM({
 });
 ```
 
+### Advanced Scan Options
+
+Control scan behavior with mode, sensitivity, and action headers:
+
+```typescript
+// Scan API with advanced options
+const result = await lockllm.scan(
+  {
+    input: userPrompt,
+    sensitivity: 'high',        // 'low' | 'medium' | 'high'
+    mode: 'combined',           // 'normal' | 'policy_only' | 'combined'
+    chunk: true                 // Force chunking for long texts
+  },
+  {
+    scanAction: 'block',        // Block core injection attacks
+    policyAction: 'allow_with_warning',  // Allow but warn on policy violations
+    abuseAction: 'block',       // Enable abuse detection (opt-in)
+    piiAction: 'strip'          // Redact PII from input (opt-in)
+  }
+);
+
+// Proxy mode with advanced options
+const openai = createOpenAI({
+  apiKey: process.env.LOCKLLM_API_KEY,
+  proxyOptions: {
+    scanMode: 'combined',           // Check both core + policies
+    scanAction: 'block',            // Block injection attacks
+    policyAction: 'block',          // Block policy violations
+    abuseAction: 'allow_with_warning',  // Detect abuse, don't block
+    piiAction: 'strip',             // Automatically redact PII
+    routeAction: 'auto'             // Enable intelligent routing
+  }
+});
+```
+
+**Scan Modes:**
+- `normal` - Core security threats only (injection, jailbreaks, etc.)
+- `policy_only` - Custom policies only (skip core security)
+- `combined` (default) - Both core security AND custom policies
+
+**Sensitivity Levels:**
+- `low` - Fewer false positives, may miss sophisticated attacks
+- `medium` (default) - Balanced approach, recommended
+- `high` - Maximum protection, may have more false positives
+
+**Action Headers:**
+- `scanAction` - Controls core injection detection: `'block'` | `'allow_with_warning'`
+- `policyAction` - Controls custom policy violations: `'block'` | `'allow_with_warning'`
+- `abuseAction` - Controls abuse detection (opt-in): `'block'` | `'allow_with_warning'` | `null`
+- `piiAction` - Controls PII detection (opt-in): `'strip'` | `'block'` | `'allow_with_warning'` | `null`
+- `routeAction` - Controls intelligent routing: `'disabled'` | `'auto'` | `'custom'`
+
+**Default Behavior (no headers):**
+- Scan Mode: `combined` (check both core + policies)
+- Scan Action: `allow_with_warning` (detect but don't block)
+- Policy Action: `allow_with_warning` (detect but don't block)
+- Abuse Action: `null` (disabled, opt-in only)
+- PII Action: `null` (disabled, opt-in only)
+- Route Action: `disabled` (no routing)
+
+See [examples/advanced-options.ts](examples/advanced-options.ts) for complete examples.
+
 ## Best Practices
 
 ### Security
@@ -841,17 +1073,17 @@ For non-JavaScript environments, use the REST API directly:
 
 **Scan Endpoint:**
 ```bash
-curl -X POST https://api.lockllm.com/scan \
-  -H "x-api-key: YOUR_LOCKLLM_API_KEY" \
+curl -X POST https://api.lockllm.com/v1/scan \
+  -H "Authorization: Bearer YOUR_LOCKLLM_API_KEY" \
   -H "Content-Type: application/json" \
-  -d '{"prompt": "Your text to scan", "sensitivity": "medium"}'
+  -d '{"input": "Your text to scan", "sensitivity": "medium"}'
 ```
 
 **Proxy Endpoints:**
 ```bash
 # OpenAI-compatible proxy
 curl -X POST https://api.lockllm.com/v1/proxy/openai/chat/completions \
-  -H "x-api-key: YOUR_LOCKLLM_API_KEY" \
+  -H "Authorization: Bearer YOUR_LOCKLLM_API_KEY" \
   -H "Content-Type: application/json" \
   -d '{"model": "gpt-4", "messages": [{"role": "user", "content": "Hello"}]}'
 ```
@@ -876,7 +1108,7 @@ import {
 
 // Type inference works automatically
 const config: LockLLMConfig = {
-  apiKey: 'llm_...',
+  apiKey: '...',
   timeout: 30000
 };
 

package/dist/client.d.ts

@@ -30,7 +30,7 @@ export declare class LockLLM {
      * });
      * ```
      */
-    get scan(): (request: import(".").ScanRequest, options?: import("./types/common").RequestOptions) => Promise<import(".").ScanResponse>;
+    get scan(): (request: import(".").ScanRequest, options?: import(".").ScanOptions) => Promise<import(".").ScanResponse>;
     /**
      * Get the current configuration
      */

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAMpD,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IACjD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IAExC;;;;;;;;;;;OAWG;gBACS,MAAM,EAAE,aAAa;IA4BjC;;;;;;;;;;OAUG;IACH,IAAI,IAAI,+HAEP;IAED;;OAEG;IACH,SAAS,IAAI,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;CAG/C"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAMpD,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IACjD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IAExC;;;;;;;;;;;OAWG;gBACS,MAAM,EAAE,aAAa;IA4BjC;;;;;;;;;;OAUG;IACH,IAAI,IAAI,+GAEP;IAED;;OAEG;IACH,SAAS,IAAI,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;CAG/C"}

package/dist/errors.d.ts

@@ -1,7 +1,7 @@
 /**
  * Custom error classes for LockLLM SDK
  */
-import type { ScanResult, LockLLMErrorData, PromptInjectionErrorData } from './types/errors';
+import type { ScanResult, LockLLMErrorData, PromptInjectionErrorData, PolicyViolationErrorData, AbuseDetectedErrorData, InsufficientCreditsErrorData, PIIDetectedErrorData } from './types/errors';
 /**
  * Base error class for all LockLLM errors
  */
@@ -46,6 +46,61 @@ export declare class UpstreamError extends LockLLMError {
 export declare class ConfigurationError extends LockLLMError {
     constructor(message: string);
 }
+/**
+ * Error thrown when custom policy violations are detected
+ */
+export declare class PolicyViolationError extends LockLLMError {
+    readonly violated_policies: Array<{
+        policy_name: string;
+        violated_categories: Array<{
+            name: string;
+        }>;
+        violation_details?: string;
+    }>;
+    constructor(data: PolicyViolationErrorData);
+}
+/**
+ * Error thrown when AI abuse is detected
+ */
+export declare class AbuseDetectedError extends LockLLMError {
+    readonly abuse_details: {
+        confidence: number;
+        abuse_types: string[];
+        indicators: {
+            bot_score: number;
+            repetition_score: number;
+            resource_score: number;
+            pattern_score: number;
+        };
+        recommendation?: string;
+        details?: {
+            recommendation?: string;
+            bot_indicators?: string[];
+            repetition_indicators?: string[];
+            resource_indicators?: string[];
+            pattern_indicators?: string[];
+        };
+    };
+    constructor(data: AbuseDetectedErrorData);
+}
+/**
+ * Error thrown when PII (personal information) is detected and action is block
+ */
+export declare class PIIDetectedError extends LockLLMError {
+    readonly pii_details: {
+        entity_types: string[];
+        entity_count: number;
+    };
+    constructor(data: PIIDetectedErrorData);
+}
+/**
+ * Error thrown when user has insufficient credits
+ */
+export declare class InsufficientCreditsError extends LockLLMError {
+    readonly current_balance: number;
+    readonly estimated_cost: number;
+    constructor(data: InsufficientCreditsErrorData);
+}
 /**
  * Error thrown when network request fails
  */

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAE7F;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChC,SAAgB,SAAS,CAAC,EAAE,MAAM,CAAC;gBAEvB,IAAI,EAAE,gBAAgB;CAanC;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,YAAY;gBACvC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAUhD;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,YAAY;IAC9C,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;gBAExB,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAWrE;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,YAAY;IACpD,SAAgB,UAAU,EAAE,UAAU,CAAC;gBAE3B,IAAI,EAAE,wBAAwB;CAW3C;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,YAAY;IAC7C,SAAgB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClC,SAAgB,cAAc,CAAC,EAAE,MAAM,CAAC;gBAGtC,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,EACjB,cAAc,CAAC,EAAE,MAAM,EACvB,SAAS,CAAC,EAAE,MAAM;CAarB;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,YAAY;gBACtC,OAAO,EAAE,MAAM;CAS5B;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,YAAY;IAC5C,SAAgB,KAAK,CAAC,EAAE,KAAK,CAAC;gBAElB,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,MAAM;CAW/D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,GAAG,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,YAAY,CAsD1E"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}