Original content...
\");\n\nconsole.log(result.content); // Rewritten HTML\nconsole.log(result.title); // Rewritten title\nconsole.log(result.description); // Rewritten description\nconsole.log(result.cost); // Cost in USD\n\n// Generate multiple variants\nconst results = await rewriter.rewrite(htmlContent, { variants: 5 });\n```\n\n## Class API (Recommended)\n\n```typescript\nimport { ContentRewriter } from \"@affiliate.fm/ai-content-rewriter\";\n\nconst rewriter = new ContentRewriter({\n provider: \"openai\",\n apiKey: \"sk-...\",\n model: \"gpt-4.1\", // Optional\n temperature: 0.9, // Optional, default: 0.9\n});\n\n// Simple rewrite\nconst [result] = await rewriter.rewrite(html);\n\n// With options\nconst results = await rewriter.rewrite(html, {\n variants: 3,\n promptTemplate: \"DEFAULT\",\n temperature: 0.8, // Override default\n onProgress: (p) => console.log(`${p.currentVariant}/${p.totalVariants}`),\n});\n\n// Single result shorthand\nconst result = await rewriter.rewriteOne(html);\n\n// Get available prompt templates\nconst templates = rewriter.getPromptTemplates();\n```\n\n## Features\n\n### Format Auto-Detection\n\nAutomatically detects content format (HTML, Markdown, or plain text):\n\n```typescript\n// HTML - detected automatically\nconst [result] = await rewriter.rewrite(\"Content
\");\n\n// Markdown - detected automatically\nconst [result] = await rewriter.rewrite(\"# Title\\n\\nContent here\");\n\n// Plain text - detected automatically\nconst [result] = await rewriter.rewrite(\"Just plain text content\");\n\n// Or specify explicitly\nconst [result] = await rewriter.rewrite({ content: \"...\", format: \"html\" });\n```\n\n### Built-in Prompt Templates\n\n```typescript\nimport { PROMPTS } from \"@affiliate.fm/ai-content-rewriter\";\n\n// Available templates:\n// - DEFAULT - Universal rewrite preserving language\n// - CUSTOM - Placeholder for a custom prompt\n\nconst results = await rewriter.rewrite(html, {\n promptTemplate: \"DEFAULT\",\n});\n\n// Or use a custom prompt\nconst results = await rewriter.rewrite(html, {\n prompt: \"Your custom rewriting instructions here...\",\n});\n```\n\n### Progress Tracking\n\n```typescript\nconst results = await rewriter.rewrite(content, {\n variants: 5,\n onProgress: (progress) => {\n console.log(progress.phase); // 'preparing' | 'generating' | 'processing' | 'done'\n console.log(`Variant ${progress.currentVariant}/${progress.totalVariants}`);\n \n // For large content processed in chunks\n if (progress.currentChunk) {\n console.log(`Chunk ${progress.currentChunk}/${progress.totalChunks}`);\n }\n \n console.log(`Cost so far: $${progress.costSoFar?.toFixed(4)}`);\n },\n});\n```\n\n### Large Content Handling\n\nContent over 12,000 characters is automatically split into chunks and processed in parallel:\n\n```typescript\nconst largeArticle = await fetchLargeArticle();\n\nconst results = await rewriter.rewrite(largeArticle, {\n onProgress: (progress) => {\n if (progress.totalChunks) {\n console.log(`Processing chunk ${progress.currentChunk}/${progress.totalChunks}`);\n }\n },\n});\n```\n\n### Cancellation\n\n```typescript\nconst controller = new AbortController();\n\n// Start rewrite\nconst promise = rewriter.rewrite(content, {\n signal: controller.signal,\n});\n\n// Cancel if needed\ncontroller.abort();\n```\n\n### AI Pattern Masking (Anti-Detection)\n\nBy default, the library automatically masks common AI-generated patterns to make content appear more natural:\n\n```typescript\n// Masking is enabled by default\nconst results = await rewriter.rewrite(content);\n\n// Disable masking if needed\nconst results = await rewriter.rewrite(content, {\n maskAIPatterns: false,\n});\n\n// Or use masking utilities directly\nimport { maskAIPatterns, maskAIPatternsInHTML } from \"@affiliate.fm/ai-content-rewriter\";\n\nconst humanizedText = maskAIPatterns(aiGeneratedText);\nconst humanizedHtml = maskAIPatternsInHTML(aiGeneratedHtml);\n```\n\n**What gets masked:**\n- Em-dashes and en-dashes → regular dashes\n- Formal academic phrases → casual alternatives (\"moreover\" → \"also\", \"furthermore\" → \"plus\")\n- Typical AI phrases (\"it is important to note\" → \"note that\")\n- Unicode bullet points → simple markers\n- Overly structured patterns (numbered conclusions, \"Firstly, Secondly...\")\n- Optional: contractions for more natural flow\n\n### Uniqueness Checking\n\n```typescript\nimport { checkUniqueness } from \"@affiliate.fm/ai-content-rewriter\";\n\nconst result = checkUniqueness(originalHtml, rewrittenHtml);\n\nconsole.log(`${result.uniqueness}% unique`); // e.g., \"92% unique\"\nconsole.log(`${result.similarity}% similar`); // e.g., \"8% similar\"\n\nif (result.isLowUniqueness) {\n console.warn('Content uniqueness is below 85%');\n}\n```\n\n### Cost Estimation\n\n```typescript\nimport { estimateCost } from \"@affiliate.fm/ai-content-rewriter\";\n\n// Estimate before running\nconst estimatedCost = estimateCost(\"gpt-4.1\", htmlContent.length, 3); // 3 variants\nconsole.log(`Estimated cost: $${estimatedCost.toFixed(4)}`);\n```\n\n## API Reference\n\n### `ContentRewriter` Class\n\n```typescript\nconst rewriter = new ContentRewriter({\n provider: \"openai\", // Required: \"openai\" (only supported)\n apiKey: \"sk-...\", // Required\n model: \"gpt-4.1\", // Optional, default: \"gpt-4.1\"\n baseUrl: \"...\", // Optional, for proxies\n temperature: 0.9, // Optional, default: 0.9\n customPrompts: { ... }, // Optional, add custom templates\n});\n\n// Main method\nconst results = await rewriter.rewrite(input, options);\n\n// Single result shorthand \nconst result = await rewriter.rewriteOne(input, options);\n\n// Get prompt templates\nconst templates = rewriter.getPromptTemplates();\n\n// Get provider info\nconst provider = rewriter.getProvider();\n```\n\n### Rewrite Options (per-call)\n\n```typescript\ninterface RewriteCallOptions {\n variants?: number; // 1-30, default: 1\n prompt?: string; // Custom prompt\n promptTemplate?: string; // Template key\n temperature?: number; // 0-2, override constructor default\n maskAIPatterns?: boolean; // default: true\n onProgress?: ProgressCallback;\n signal?: AbortSignal;\n}\n```\n\n### Content Input\n\n```typescript\n// String shorthand\nawait rewriter.rewrite(\"Content
\");\n\n// Object with metadata\nawait rewriter.rewrite({\n content: \"Content
\",\n title: \"Optional explicit title\",\n description: \"Optional meta description\",\n format: \"html\", // Optional: \"html\" | \"markdown\" | \"text\"\n});\n```\n\n### Rewrite Result\n\n```typescript\ninterface RewriteResult {\n content: string; // Rewritten content\n title: string; // Rewritten title\n description: string; // Rewritten description\n cost?: number; // Cost in USD\n format: ContentFormat; // Detected/specified format\n}\n```\n\n## Error Handling\n\n```typescript\nimport { \n RewriterError, \n ProviderError, \n RateLimitError, \n ValidationError \n} from \"@affiliate.fm/ai-content-rewriter\";\n\ntry {\n const results = await rewriter.rewrite(content);\n} catch (error) {\n if (error instanceof RateLimitError) {\n console.log(`Rate limited. Retry after ${error.retryAfter}s`);\n } else if (error instanceof ProviderError) {\n console.log(`Provider error: ${error.message}`);\n } else if (error instanceof ValidationError) {\n console.log(`Invalid input: ${error.message}`);\n }\n}\n```\n\n## Browser Usage\n\nThe library works in browsers with the OpenAI SDK's browser mode:\n\n```typescript\nimport { ContentRewriter } from \"@affiliate.fm/ai-content-rewriter/browser\";\n\nconst rewriter = new ContentRewriter({\n provider: \"openai\",\n apiKey: \"sk-...\",\n});\n\nconst results = await rewriter.rewrite(content);\n```\n\n## Pricing\n\nCost is calculated based on OpenAI's token pricing (gpt-4.1 only):\n\n| Model | Input (per 1M tokens) | Output (per 1M tokens) |\n|-------|----------------------|------------------------|\n| gpt-4.1 | $5.00 | $15.00 |\n\n## Related\n\n- [astro-content-ai-translator](https://affiliate.fm/tools/astro-content-ai-translator/) — AI-powered translation for Astro\n- [website-core-template](https://affiliate.fm/tools/website-core-template/) — Multilingual static site template\n\n## License\n\nMIT\n","readmeFilename":"README.md"}