safeprompt 1.0.0

package/README.md

@@ -0,0 +1,101 @@
+# SafePrompt JavaScript/TypeScript SDK
+
+Official JavaScript/TypeScript SDK for SafePrompt API.
+
+## Installation
+
+```bash
+npm install safeprompt
+```
+
+## Quick Start
+
+```javascript
+import SafePrompt from 'safeprompt';
+
+const client = new SafePrompt({ apiKey: 'your-api-key' });
+
+const result = await client.check('User input goes here');
+
+if (result.safe) {
+  // Safe to proceed with LLM
+} else {
+  // Handle malicious input
+  console.log('Threats detected:', result.threats);
+}
+```
+
+## API Reference
+
+### `new SafePrompt(config)`
+
+Create a new SafePrompt client.
+
+**Parameters:**
+- `config.apiKey` (string, required): Your SafePrompt API key
+- `config.baseURL` (string, optional): Custom API base URL
+
+### `client.check(prompt)`
+
+Validate a single prompt.
+
+**Parameters:**
+- `prompt` (string, required): The user input to validate
+
+**Returns:**
+```typescript
+{
+  safe: boolean;
+  threats: string[];
+  confidence: number;
+  processingTimeMs: number;
+  passesUsed: number;
+}
+```
+
+### `client.checkBatch(prompts)`
+
+Validate multiple prompts in one request.
+
+**Parameters:**
+- `prompts` (string[], required): Array of prompts to validate
+
+**Returns:**
+```typescript
+Array<ValidationResult>
+```
+
+### `client.getUsage()`
+
+Get API usage statistics.
+
+**Returns:**
+```typescript
+{
+  requestsThisMonth: number;
+  requestsRemaining: number;
+  plan: string;
+}
+```
+
+## Error Handling
+
+```javascript
+try {
+  const result = await client.check(userInput);
+} catch (error) {
+  if (error instanceof SafePromptError) {
+    console.error('API Error:', error.message, error.statusCode);
+  } else {
+    console.error('Unexpected error:', error);
+  }
+}
+```
+
+## TypeScript Support
+
+Full TypeScript support included with type definitions.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,47 @@
+/**
+ * SafePrompt JavaScript/TypeScript SDK
+ * API-first prompt injection protection
+ */
+export interface SafePromptConfig {
+    apiKey: string;
+    baseURL?: string;
+}
+export interface ValidationResult {
+    safe: boolean;
+    threats: string[];
+    confidence: number;
+    processingTimeMs: number;
+    passesUsed: number;
+}
+export interface ValidationError {
+    error: string;
+    message: string;
+    statusCode: number;
+}
+export declare class SafePromptError extends Error {
+    statusCode: number;
+    constructor(message: string, statusCode: number);
+}
+export default class SafePrompt {
+    private apiKey;
+    private baseURL;
+    constructor(config: SafePromptConfig);
+    /**
+     * Check if a prompt is safe
+     * @param prompt - The user input to validate
+     * @returns Validation result indicating if the prompt is safe
+     */
+    check(prompt: string): Promise<ValidationResult>;
+    /**
+     * Batch validate multiple prompts
+     * @param prompts - Array of prompts to validate
+     * @returns Array of validation results
+     */
+    checkBatch(prompts: string[]): Promise<ValidationResult[]>;
+    /**
+     * Get API usage statistics
+     * @returns Usage statistics for your API key
+     */
+    getUsage(): Promise<any>;
+}
+export { SafePrompt };

package/dist/index.js

@@ -0,0 +1,127 @@
+"use strict";
+/**
+ * SafePrompt JavaScript/TypeScript SDK
+ * API-first prompt injection protection
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SafePrompt = exports.SafePromptError = void 0;
+class SafePromptError extends Error {
+    constructor(message, statusCode) {
+        super(message);
+        this.name = 'SafePromptError';
+        this.statusCode = statusCode;
+    }
+}
+exports.SafePromptError = SafePromptError;
+class SafePrompt {
+    constructor(config) {
+        if (!config.apiKey) {
+            throw new Error('SafePrompt API key is required');
+        }
+        this.apiKey = config.apiKey;
+        this.baseURL = config.baseURL || 'https://api.safeprompt.dev';
+    }
+    /**
+     * Check if a prompt is safe
+     * @param prompt - The user input to validate
+     * @returns Validation result indicating if the prompt is safe
+     */
+    async check(prompt) {
+        if (!prompt || typeof prompt !== 'string') {
+            throw new Error('Prompt must be a non-empty string');
+        }
+        try {
+            const response = await fetch(`${this.baseURL}/v1/validate`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Authorization': `Bearer ${this.apiKey}`,
+                    'User-Agent': 'safeprompt-js/1.0.0'
+                },
+                body: JSON.stringify({ prompt })
+            });
+            if (!response.ok) {
+                const errorData = await response.json().catch(() => ({}));
+                throw new SafePromptError(errorData.message || `API request failed with status ${response.status}`, response.status);
+            }
+            const data = await response.json();
+            return data;
+        }
+        catch (error) {
+            if (error instanceof SafePromptError) {
+                throw error;
+            }
+            if (error instanceof Error) {
+                throw new SafePromptError(error.message, 500);
+            }
+            throw new SafePromptError('Unknown error occurred', 500);
+        }
+    }
+    /**
+     * Batch validate multiple prompts
+     * @param prompts - Array of prompts to validate
+     * @returns Array of validation results
+     */
+    async checkBatch(prompts) {
+        if (!Array.isArray(prompts) || prompts.length === 0) {
+            throw new Error('Prompts must be a non-empty array');
+        }
+        try {
+            const response = await fetch(`${this.baseURL}/v1/validate/batch`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Authorization': `Bearer ${this.apiKey}`,
+                    'User-Agent': 'safeprompt-js/1.0.0'
+                },
+                body: JSON.stringify({ prompts })
+            });
+            if (!response.ok) {
+                const errorData = await response.json().catch(() => ({}));
+                throw new SafePromptError(errorData.message || `API request failed with status ${response.status}`, response.status);
+            }
+            const data = await response.json();
+            return data.results;
+        }
+        catch (error) {
+            if (error instanceof SafePromptError) {
+                throw error;
+            }
+            if (error instanceof Error) {
+                throw new SafePromptError(error.message, 500);
+            }
+            throw new SafePromptError('Unknown error occurred', 500);
+        }
+    }
+    /**
+     * Get API usage statistics
+     * @returns Usage statistics for your API key
+     */
+    async getUsage() {
+        try {
+            const response = await fetch(`${this.baseURL}/v1/usage`, {
+                method: 'GET',
+                headers: {
+                    'Authorization': `Bearer ${this.apiKey}`,
+                    'User-Agent': 'safeprompt-js/1.0.0'
+                }
+            });
+            if (!response.ok) {
+                const errorData = await response.json().catch(() => ({}));
+                throw new SafePromptError(errorData.message || `API request failed with status ${response.status}`, response.status);
+            }
+            return await response.json();
+        }
+        catch (error) {
+            if (error instanceof SafePromptError) {
+                throw error;
+            }
+            if (error instanceof Error) {
+                throw new SafePromptError(error.message, 500);
+            }
+            throw new SafePromptError('Unknown error occurred', 500);
+        }
+    }
+}
+exports.default = SafePrompt;
+exports.SafePrompt = SafePrompt;

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "safeprompt",
+  "version": "1.0.0",
+  "description": "API-first prompt injection protection for AI applications",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "prompt-injection",
+    "ai-security",
+    "llm",
+    "openai",
+    "security",
+    "ai",
+    "chatbot",
+    "prompt",
+    "validation"
+  ],
+  "author": "SafePrompt <support@safeprompt.dev>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ianreboot/safeprompt"
+  },
+  "homepage": "https://safeprompt.dev",
+  "bugs": {
+    "url": "https://github.com/ianreboot/safeprompt/issues"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0"
+  },
+  "files": [
+    "dist"
+  ]
+}