@perkos/service-ai 1.0.0

package/README.md

@@ -0,0 +1,143 @@
+# @perkos/service-ai
+
+Multi-provider AI service abstraction with OpenRouter, Replicate, and OpenAI support.
+
+## Installation
+
+```bash
+npm install @perkos/service-ai
+```
+
+## Usage
+
+```typescript
+import { AIService } from "@perkos/service-ai";
+
+const aiService = new AIService({
+  openRouterApiKey: process.env.OPENROUTER_API_KEY!,
+  replicateApiKey: process.env.REPLICATE_API_KEY,
+  openAIApiKey: process.env.OPENAI_API_KEY,
+  defaultModel: "anthropic/claude-3.5-sonnet",
+});
+
+// Analyze an image
+const analysis = await aiService.analyzeImage(imageUrl, {
+  prompt: "Describe this image in detail",
+});
+
+// Generate an image
+const result = await aiService.generateImage("A sunset over mountains", {
+  style: "photorealistic",
+  aspectRatio: "16:9",
+});
+
+// Transcribe audio
+const transcription = await aiService.transcribeAudio(audioUrl, {
+  language: "en",
+});
+
+// Generate speech
+const audio = await aiService.synthesizeSpeech("Hello world", {
+  voice: "alloy",
+});
+```
+
+## Available Methods
+
+### Vision & Image
+
+- `analyzeImage(imageUrl, options?)` - Analyze image content
+- `generateImage(prompt, options?)` - Generate images with DALL-E or Replicate
+
+### Audio
+
+- `transcribeAudio(audioUrl, options?)` - Transcribe audio to text
+- `synthesizeSpeech(text, options?)` - Convert text to speech
+
+### Text Processing
+
+- `summarizeText(text, options?)` - Summarize long text
+- `translateText(text, targetLanguage, options?)` - Translate text
+- `analyzeSentiment(text, options?)` - Analyze sentiment
+- `moderateContent(text, options?)` - Content moderation
+- `simplifyText(text, options?)` - Simplify complex text
+- `extractEntities(text, options?)` - Extract named entities
+
+### Content Generation
+
+- `generateEmail(context, options?)` - Generate professional emails
+- `generateProductDescription(product, options?)` - E-commerce descriptions
+- `optimizeSEO(content, options?)` - SEO optimization suggestions
+
+### Code & Technical
+
+- `generateCode(prompt, options?)` - Generate code snippets
+- `reviewCode(code, options?)` - Code review and suggestions
+- `generateSQLQuery(description, options?)` - Generate SQL queries
+- `generateRegex(description, options?)` - Generate regex patterns
+- `generateAPIDocs(code, options?)` - Generate API documentation
+
+### Other
+
+- `extractTextOCR(imageUrl, options?)` - Extract text from images
+- `generateQuiz(topic, options?)` - Generate educational quizzes
+
+## Configuration
+
+```typescript
+interface AIServiceConfig {
+  openRouterApiKey: string;
+  replicateApiKey?: string;
+  openAIApiKey?: string;
+  defaultModel?: string;
+  imageModel?: string;
+  siteUrl?: string;
+  siteName?: string;
+}
+```
+
+## Provider Fallback
+
+The service automatically falls back between providers:
+
+- **Image Generation**: Tries OpenAI DALL-E first, falls back to Replicate SDXL
+- **Speech Synthesis**: Uses OpenAI TTS with fallback to Replicate
+- **Text Tasks**: Uses OpenRouter with configurable models
+
+## Supported Models
+
+### OpenRouter (Text/Vision)
+
+- `anthropic/claude-3.5-sonnet` (default)
+- `openai/gpt-4o`
+- `google/gemini-pro`
+- Any model supported by OpenRouter
+
+### OpenAI
+
+- `dall-e-3` for image generation
+- `whisper-1` for transcription
+- `tts-1` / `tts-1-hd` for speech
+
+### Replicate
+
+- `black-forest-labs/flux-schnell` for fast image generation
+- `stability-ai/sdxl` for high-quality images
+- Various other models as fallbacks
+
+## Error Handling
+
+```typescript
+try {
+  const result = await aiService.generateImage(prompt);
+} catch (error) {
+  if (error.message.includes("rate limit")) {
+    // Handle rate limiting
+  }
+  // Handle other errors
+}
+```
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,234 @@
+/**
+ * AI Service Types
+ */
+interface AIServiceConfig {
+    openrouterApiKey?: string;
+    openaiApiKey?: string;
+    replicateApiToken?: string;
+    openrouterBaseUrl?: string;
+    openrouterReferer?: string;
+    openrouterTitle?: string;
+    imageModel?: string;
+    ttsModel?: string;
+    whisperModel?: string;
+    moderationModel?: string;
+    chatModel?: string;
+}
+interface ImageGenerateResult {
+    url?: string;
+    base64?: string;
+    revisedPrompt?: string;
+}
+interface TranslationResult {
+    translation: string;
+    confidence: number;
+}
+interface SentimentResult {
+    sentiment: "positive" | "negative" | "neutral";
+    score: number;
+    emotions: string[];
+}
+interface ModerationResult {
+    flagged: boolean;
+    categories: Record<string, boolean>;
+    categoryScores: Record<string, number>;
+    reasoning?: string;
+}
+interface EntityResult {
+    entities: Array<{
+        text: string;
+        type: string;
+        position: number;
+    }>;
+}
+interface EmailResult {
+    subject: string;
+    body: string;
+}
+interface CodeGenerateResult {
+    code: string;
+    explanation: string;
+}
+interface CodeReviewResult {
+    issues: string[];
+    suggestions: string[];
+    securityConcerns: string[];
+}
+interface SQLResult {
+    query: string;
+    explanation: string;
+}
+interface RegexResult {
+    pattern: string;
+    explanation: string;
+    examples: string[];
+}
+interface SEOResult {
+    optimizedContent: string;
+    analysis: string;
+}
+interface APIDocsResult {
+    documentation: string;
+    openapi?: string;
+}
+interface OCRResult {
+    text: string;
+    confidence: number;
+}
+interface QuizQuestion {
+    question: string;
+    options: string[];
+    correctIndex: number;
+    explanation: string;
+}
+interface QuizResult {
+    questions: QuizQuestion[];
+}
+type SummaryLength = "short" | "medium" | "long";
+type ReadingLevel = "elementary" | "middle" | "high";
+type EmailTone = "formal" | "casual" | "friendly";
+type Difficulty = "easy" | "medium" | "hard";
+type Voice = "alloy" | "echo" | "fable" | "onyx" | "nova" | "shimmer";
+type AIProvider = "openrouter" | "openai" | "replicate";
+type TranscriptionResult = {
+    text: string;
+    confidence?: number;
+};
+type EntityExtractionResult = EntityResult;
+type CodeGenerationResult = CodeGenerateResult;
+interface ImageAnalysisOptions {
+    detail?: "low" | "high" | "auto";
+    maxTokens?: number;
+}
+interface ImageGenerateOptions {
+    size?: "1024x1024" | "1792x1024" | "1024x1792";
+    quality?: "standard" | "hd";
+    style?: "vivid" | "natural";
+    n?: number;
+}
+interface TranscribeOptions {
+    language?: string;
+    prompt?: string;
+    responseFormat?: "json" | "text" | "srt" | "vtt";
+}
+interface SpeechOptions {
+    voice?: Voice;
+    speed?: number;
+    responseFormat?: "mp3" | "opus" | "aac" | "flac";
+}
+interface SummarizeOptions {
+    length?: SummaryLength;
+    format?: "paragraph" | "bullets";
+}
+interface TranslateOptions {
+    targetLanguage: string;
+    sourceLanguage?: string;
+    preserveFormatting?: boolean;
+}
+interface SentimentOptions {
+    detailed?: boolean;
+    includeEmotions?: boolean;
+}
+interface ModerationOptions {
+    categories?: string[];
+    threshold?: number;
+}
+interface SimplifyOptions {
+    targetLevel?: ReadingLevel;
+    preserveMeaning?: boolean;
+}
+interface EntityOptions {
+    types?: string[];
+    includePositions?: boolean;
+}
+interface EmailOptions {
+    tone?: EmailTone;
+    length?: SummaryLength;
+    includeSubject?: boolean;
+}
+interface ProductDescriptionOptions {
+    tone?: "professional" | "casual" | "luxury";
+    length?: SummaryLength;
+    includeBenefits?: boolean;
+}
+interface SEOOptions {
+    keywords?: string[];
+    targetLength?: number;
+    includeMetaTags?: boolean;
+}
+interface CodeGenerateOptions {
+    language: string;
+    includeComments?: boolean;
+    includeTests?: boolean;
+}
+interface CodeReviewOptions {
+    focus?: "security" | "performance" | "style" | "all";
+    severity?: "all" | "critical" | "high";
+}
+interface SQLQueryOptions {
+    dialect?: "mysql" | "postgresql" | "sqlite";
+    includeExplanation?: boolean;
+}
+interface RegexOptions {
+    flavor?: "javascript" | "python" | "pcre";
+    includeExamples?: boolean;
+}
+interface APIDocsOptions {
+    format?: "markdown" | "openapi";
+    includeExamples?: boolean;
+}
+interface OCROptions {
+    language?: string;
+    format?: "text" | "structured";
+}
+interface QuizOptions {
+    count?: number;
+    difficulty?: Difficulty;
+    includeExplanations?: boolean;
+}
+
+/**
+ * AI Service Implementation
+ * Multi-provider AI service with OpenRouter, Replicate, and OpenAI support
+ */
+
+declare class AIService {
+    private openai;
+    private openrouter;
+    private replicate;
+    private useOpenRouter;
+    private useReplicate;
+    private imageModel;
+    private ttsModel;
+    private whisperModel;
+    private moderationModel;
+    private chatModel;
+    constructor(config?: AIServiceConfig);
+    private getChatClient;
+    private getChatModel;
+    analyzeImage(imageInput: string, question?: string): Promise<string>;
+    generateImage(prompt: string, size?: "1024x1024"): Promise<ImageGenerateResult>;
+    private generateImageWithReplicate;
+    transcribeAudio(audioInput: File | Blob | string): Promise<string>;
+    private transcribeWithReplicate;
+    synthesizeSpeech(text: string, voice?: Voice): Promise<Buffer>;
+    private synthesizeWithReplicate;
+    summarizeText(text: string, length?: SummaryLength): Promise<string>;
+    translateText(text: string, sourceLang: string, targetLang: string): Promise<TranslationResult>;
+    analyzeSentiment(text: string): Promise<SentimentResult>;
+    moderateContent(content: string): Promise<ModerationResult>;
+    simplifyText(text: string, readingLevel?: ReadingLevel): Promise<string>;
+    extractEntities(text: string): Promise<EntityResult>;
+    generateEmail(purpose: string, tone: EmailTone | undefined, keyPoints: string[]): Promise<EmailResult>;
+    generateProductDescription(productName: string, features: string[], targetAudience?: string): Promise<string>;
+    optimizeSEO(content: string, keywords: string[]): Promise<SEOResult>;
+    generateCode(description: string, language: string, framework?: string): Promise<CodeGenerateResult>;
+    reviewCode(code: string, language: string): Promise<CodeReviewResult>;
+    generateSQLQuery(schema: string, query: string): Promise<SQLResult>;
+    generateRegex(description: string): Promise<RegexResult>;
+    generateAPIDocs(code: string, framework: string): Promise<APIDocsResult>;
+    extractTextOCR(image: string): Promise<OCRResult>;
+    generateQuiz(topic: string, numQuestions?: number, difficulty?: Difficulty): Promise<QuizResult>;
+}
+
+export { type AIProvider, AIService, type AIServiceConfig, type APIDocsOptions, type CodeGenerateOptions, type CodeGenerationResult, type CodeReviewOptions, type CodeReviewResult, type EmailOptions, type EntityExtractionResult, type EntityOptions, type ImageAnalysisOptions, type ImageGenerateOptions, type ImageGenerateResult, type ModerationOptions, type ModerationResult, type OCROptions, type OCRResult, type ProductDescriptionOptions, type QuizOptions, type QuizResult, type RegexOptions, type SEOOptions, type SQLQueryOptions, type SentimentOptions, type SentimentResult, type SimplifyOptions, type SpeechOptions, type SummarizeOptions, type TranscribeOptions, type TranscriptionResult, type TranslateOptions, type TranslationResult };

package/dist/index.d.ts

@@ -0,0 +1,234 @@
+/**
+ * AI Service Types
+ */
+interface AIServiceConfig {
+    openrouterApiKey?: string;
+    openaiApiKey?: string;
+    replicateApiToken?: string;
+    openrouterBaseUrl?: string;
+    openrouterReferer?: string;
+    openrouterTitle?: string;
+    imageModel?: string;
+    ttsModel?: string;
+    whisperModel?: string;
+    moderationModel?: string;
+    chatModel?: string;
+}
+interface ImageGenerateResult {
+    url?: string;
+    base64?: string;
+    revisedPrompt?: string;
+}
+interface TranslationResult {
+    translation: string;
+    confidence: number;
+}
+interface SentimentResult {
+    sentiment: "positive" | "negative" | "neutral";
+    score: number;
+    emotions: string[];
+}
+interface ModerationResult {
+    flagged: boolean;
+    categories: Record<string, boolean>;
+    categoryScores: Record<string, number>;
+    reasoning?: string;
+}
+interface EntityResult {
+    entities: Array<{
+        text: string;
+        type: string;
+        position: number;
+    }>;
+}
+interface EmailResult {
+    subject: string;
+    body: string;
+}
+interface CodeGenerateResult {
+    code: string;
+    explanation: string;
+}
+interface CodeReviewResult {
+    issues: string[];
+    suggestions: string[];
+    securityConcerns: string[];
+}
+interface SQLResult {
+    query: string;
+    explanation: string;
+}
+interface RegexResult {
+    pattern: string;
+    explanation: string;
+    examples: string[];
+}
+interface SEOResult {
+    optimizedContent: string;
+    analysis: string;
+}
+interface APIDocsResult {
+    documentation: string;
+    openapi?: string;
+}
+interface OCRResult {
+    text: string;
+    confidence: number;
+}
+interface QuizQuestion {
+    question: string;
+    options: string[];
+    correctIndex: number;
+    explanation: string;
+}
+interface QuizResult {
+    questions: QuizQuestion[];
+}
+type SummaryLength = "short" | "medium" | "long";
+type ReadingLevel = "elementary" | "middle" | "high";
+type EmailTone = "formal" | "casual" | "friendly";
+type Difficulty = "easy" | "medium" | "hard";
+type Voice = "alloy" | "echo" | "fable" | "onyx" | "nova" | "shimmer";
+type AIProvider = "openrouter" | "openai" | "replicate";
+type TranscriptionResult = {
+    text: string;
+    confidence?: number;
+};
+type EntityExtractionResult = EntityResult;
+type CodeGenerationResult = CodeGenerateResult;
+interface ImageAnalysisOptions {
+    detail?: "low" | "high" | "auto";
+    maxTokens?: number;
+}
+interface ImageGenerateOptions {
+    size?: "1024x1024" | "1792x1024" | "1024x1792";
+    quality?: "standard" | "hd";
+    style?: "vivid" | "natural";
+    n?: number;
+}
+interface TranscribeOptions {
+    language?: string;
+    prompt?: string;
+    responseFormat?: "json" | "text" | "srt" | "vtt";
+}
+interface SpeechOptions {
+    voice?: Voice;
+    speed?: number;
+    responseFormat?: "mp3" | "opus" | "aac" | "flac";
+}
+interface SummarizeOptions {
+    length?: SummaryLength;
+    format?: "paragraph" | "bullets";
+}
+interface TranslateOptions {
+    targetLanguage: string;
+    sourceLanguage?: string;
+    preserveFormatting?: boolean;
+}
+interface SentimentOptions {
+    detailed?: boolean;
+    includeEmotions?: boolean;
+}
+interface ModerationOptions {
+    categories?: string[];
+    threshold?: number;
+}
+interface SimplifyOptions {
+    targetLevel?: ReadingLevel;
+    preserveMeaning?: boolean;
+}
+interface EntityOptions {
+    types?: string[];
+    includePositions?: boolean;
+}
+interface EmailOptions {
+    tone?: EmailTone;
+    length?: SummaryLength;
+    includeSubject?: boolean;
+}
+interface ProductDescriptionOptions {
+    tone?: "professional" | "casual" | "luxury";
+    length?: SummaryLength;
+    includeBenefits?: boolean;
+}
+interface SEOOptions {
+    keywords?: string[];
+    targetLength?: number;
+    includeMetaTags?: boolean;
+}
+interface CodeGenerateOptions {
+    language: string;
+    includeComments?: boolean;
+    includeTests?: boolean;
+}
+interface CodeReviewOptions {
+    focus?: "security" | "performance" | "style" | "all";
+    severity?: "all" | "critical" | "high";
+}
+interface SQLQueryOptions {
+    dialect?: "mysql" | "postgresql" | "sqlite";
+    includeExplanation?: boolean;
+}
+interface RegexOptions {
+    flavor?: "javascript" | "python" | "pcre";
+    includeExamples?: boolean;
+}
+interface APIDocsOptions {
+    format?: "markdown" | "openapi";
+    includeExamples?: boolean;
+}
+interface OCROptions {
+    language?: string;
+    format?: "text" | "structured";
+}
+interface QuizOptions {
+    count?: number;
+    difficulty?: Difficulty;
+    includeExplanations?: boolean;
+}
+
+/**
+ * AI Service Implementation
+ * Multi-provider AI service with OpenRouter, Replicate, and OpenAI support
+ */
+
+declare class AIService {
+    private openai;
+    private openrouter;
+    private replicate;
+    private useOpenRouter;
+    private useReplicate;
+    private imageModel;
+    private ttsModel;
+    private whisperModel;
+    private moderationModel;
+    private chatModel;
+    constructor(config?: AIServiceConfig);
+    private getChatClient;
+    private getChatModel;
+    analyzeImage(imageInput: string, question?: string): Promise<string>;
+    generateImage(prompt: string, size?: "1024x1024"): Promise<ImageGenerateResult>;
+    private generateImageWithReplicate;
+    transcribeAudio(audioInput: File | Blob | string): Promise<string>;
+    private transcribeWithReplicate;
+    synthesizeSpeech(text: string, voice?: Voice): Promise<Buffer>;
+    private synthesizeWithReplicate;
+    summarizeText(text: string, length?: SummaryLength): Promise<string>;
+    translateText(text: string, sourceLang: string, targetLang: string): Promise<TranslationResult>;
+    analyzeSentiment(text: string): Promise<SentimentResult>;
+    moderateContent(content: string): Promise<ModerationResult>;
+    simplifyText(text: string, readingLevel?: ReadingLevel): Promise<string>;
+    extractEntities(text: string): Promise<EntityResult>;
+    generateEmail(purpose: string, tone: EmailTone | undefined, keyPoints: string[]): Promise<EmailResult>;
+    generateProductDescription(productName: string, features: string[], targetAudience?: string): Promise<string>;
+    optimizeSEO(content: string, keywords: string[]): Promise<SEOResult>;
+    generateCode(description: string, language: string, framework?: string): Promise<CodeGenerateResult>;
+    reviewCode(code: string, language: string): Promise<CodeReviewResult>;
+    generateSQLQuery(schema: string, query: string): Promise<SQLResult>;
+    generateRegex(description: string): Promise<RegexResult>;
+    generateAPIDocs(code: string, framework: string): Promise<APIDocsResult>;
+    extractTextOCR(image: string): Promise<OCRResult>;
+    generateQuiz(topic: string, numQuestions?: number, difficulty?: Difficulty): Promise<QuizResult>;
+}
+
+export { type AIProvider, AIService, type AIServiceConfig, type APIDocsOptions, type CodeGenerateOptions, type CodeGenerationResult, type CodeReviewOptions, type CodeReviewResult, type EmailOptions, type EntityExtractionResult, type EntityOptions, type ImageAnalysisOptions, type ImageGenerateOptions, type ImageGenerateResult, type ModerationOptions, type ModerationResult, type OCROptions, type OCRResult, type ProductDescriptionOptions, type QuizOptions, type QuizResult, type RegexOptions, type SEOOptions, type SQLQueryOptions, type SentimentOptions, type SentimentResult, type SimplifyOptions, type SpeechOptions, type SummarizeOptions, type TranscribeOptions, type TranscriptionResult, type TranslateOptions, type TranslationResult };