@adityanair98/api-oracle 0.5.0

package/src/entries/ai/resemble-ai.json

@@ -0,0 +1,88 @@
+{
+  "name": "Resemble AI",
+  "slug": "resemble-ai",
+  "category": "ai",
+  "subcategory": "voice-synthesis",
+  "website": "https://www.resemble.ai",
+  "description": "Resemble AI is a voice cloning and AI speech generation platform that creates hyper-realistic synthetic voices from audio samples. It supports real-time streaming TTS, custom voice cloning from as little as 3 seconds of audio, and a localization API for dubbing content into multiple languages. Used for IVR systems, audiobooks, game characters, and personalized voice experiences.",
+  "useCases": [
+    {
+      "task": "Clone a specific person's voice for text-to-speech",
+      "fit": "perfect"
+    },
+    {
+      "task": "Generate realistic AI voiceover for videos or podcasts",
+      "fit": "perfect"
+    },
+    {
+      "task": "Build voice-enabled IVR or customer service bots with custom voices",
+      "fit": "perfect"
+    },
+    {
+      "task": "Stream TTS audio in real-time for low-latency voice applications",
+      "fit": "perfect"
+    },
+    {
+      "task": "Localize/dub video content into multiple languages",
+      "fit": "good"
+    }
+  ],
+  "auth": {
+    "method": "api_key",
+    "setupSteps": [
+      "Sign up at app.resemble.ai",
+      "Go to Account > API Key to generate your API token",
+      "Create a voice (or clone one by uploading audio samples)",
+      "Note your project UUID from the project settings",
+      "Set RESEMBLE_API_KEY environment variable"
+    ],
+    "envVarName": "RESEMBLE_API_KEY",
+    "codeSnippet": "import Resemble from '@resemble/node';\nResemble.setApiKey(process.env.RESEMBLE_API_KEY!);"
+  },
+  "pricing": {
+    "model": "usage_based",
+    "freeTier": "No persistent free tier; trial credits provided on signup",
+    "startingPrice": "$0.006 per second of generated audio (pay-as-you-go)",
+    "costPer": "$0.006/second for standard TTS; real-time streaming has different pricing; voice cloning: included with API access",
+    "pricingUrl": "https://www.resemble.ai/pricing"
+  },
+  "rateLimits": {
+    "tier": "default",
+    "limit": "Varies by plan; async clip generation has no strict rate limit; streaming is concurrent-connection limited",
+    "notes": "Async clip generation (non-streaming) is queued and can handle high throughput. Real-time streaming connections are limited per account tier. Contact sales for high-volume pricing.",
+    "retryStrategy": "Implement exponential backoff for 429 and 503 responses. For async clip generation, poll the clip status endpoint rather than holding the connection open."
+  },
+  "sdk": {
+    "primaryLanguage": "typescript",
+    "installCommand": "npm install --save-exact @resemble/node",
+    "importStatement": "import Resemble from '@resemble/node';",
+    "otherLanguages": ["python"]
+  },
+  "codeExamples": [
+    {
+      "title": "Generate a speech clip from text (async)",
+      "language": "typescript",
+      "code": "import Resemble from '@resemble/node';\n\nResemble.setApiKey(process.env.RESEMBLE_API_KEY!);\n\nconst projectUuid = process.env.RESEMBLE_PROJECT_UUID!;\nconst voiceUuid = process.env.RESEMBLE_VOICE_UUID!;\n\n// Create an async clip (non-streaming)\nconst response = await Resemble.v2.clips.createAsync(projectUuid, {\n  voice_uuid: voiceUuid,\n  body: 'Hello, this is a test of Resemble AI voice synthesis.',\n  is_public: false,\n  is_archived: false,\n  sample_rate: 44100,\n  output_format: 'mp3',\n  precision: 'PCM_16',\n});\n\nif (response.success) {\n  const clipUuid = response.item.uuid;\n  console.log('Clip created:', clipUuid);\n  \n  // Poll until complete (or use webhook callback_uri)\n  let clip = response.item;\n  while (!clip.audio_src) {\n    await new Promise(r => setTimeout(r, 1000));\n    const status = await Resemble.v2.clips.get(projectUuid, clipUuid);\n    if (status.success) clip = status.item;\n  }\n  \n  console.log('Audio URL:', clip.audio_src);\n} else {\n  console.error('Failed to create clip:', response.message);\n}",
+      "notes": "Use callback_uri instead of polling for production — pass a webhook URL and Resemble will POST to it when the clip is ready. For real-time use cases, use the streaming API instead of async clips."
+    }
+  ],
+  "gotchas": [
+    "Voice cloning quality depends heavily on the quality and diversity of the training audio. Clean audio with minimal background noise and varied intonation (not monotone reading) produces significantly better results than low-quality samples.",
+    "Resemble's async clip generation can take 10-60 seconds for longer texts. For user-facing real-time applications, use the streaming WebSocket API instead, which delivers audio chunks as they're generated with much lower latency.",
+    "The `body` field for clip generation accepts plain text but also supports SSML for controlling pronunciation, pauses, and emphasis. However, not all SSML tags are supported — test carefully before relying on SSML in production.",
+    "Generated audio URLs are temporary and expire. Download and store the audio to your own storage (e.g., S3, Cloudinary) immediately after generation if you need persistent access."
+  ],
+  "reliability": {
+    "uptimeGuarantee": "99.5% uptime on standard plans",
+    "statusPageUrl": "https://status.resemble.ai",
+    "notes": "Resemble AI is production-grade and used by enterprise customers. Async generation is highly reliable; real-time streaming is more sensitive to network conditions."
+  },
+  "qualityScore": 7,
+  "qualityJustification": "Best-in-class for voice cloning realism, especially from short audio samples. The API is well-designed and the Node SDK is usable. The main limitations are the pay-as-you-go pricing (no free tier) and the need to manage clip polling or webhooks for async generation. A solid choice for voice-heavy applications; compare with ElevenLabs for non-cloning TTS use cases.",
+  "alternatives": ["replicate", "eleven-labs"],
+  "complementary": ["mux", "cloudinary", "openai", "deepgram"],
+  "bestFor": "Custom voice cloning and high-realism AI speech generation for IVR, audiobooks, and branded voice experiences",
+  "lastVerified": "2026-02-25",
+  "entryVersion": 1,
+  "addedBy": "claude-code-session-2"
+}

package/src/entries/ai/stability-ai.json

@@ -0,0 +1,89 @@
+{
+  "name": "Stability AI",
+  "slug": "stability-ai",
+  "category": "ai",
+  "subcategory": "image-generation",
+  "website": "https://platform.stability.ai",
+  "description": "Stability AI provides the Stable Diffusion image generation API — the leading open source image AI model. The Stability AI Platform API (api.stability.ai) provides hosted inference for Stable Diffusion, SDXL, SD3 Medium, and Stable Image services. Generate images from text prompts, edit images, remove backgrounds, and upscale images via REST API.",
+  "useCases": [
+    {
+      "task": "Generate images from text prompts using Stable Diffusion",
+      "fit": "perfect"
+    },
+    {
+      "task": "Edit existing images with inpainting or outpainting",
+      "fit": "good"
+    },
+    {
+      "task": "Remove backgrounds from product photos automatically",
+      "fit": "good"
+    },
+    {
+      "task": "Upscale low-resolution images to higher quality",
+      "fit": "good"
+    }
+  ],
+  "auth": {
+    "method": "api_key",
+    "setupSteps": [
+      "Create an account at platform.stability.ai",
+      "Navigate to API Keys in your account dashboard",
+      "Click 'Create new API key'",
+      "Copy the key and set the STABILITY_API_KEY environment variable"
+    ],
+    "envVarName": "STABILITY_API_KEY",
+    "codeSnippet": "// Stability AI uses Authorization: Bearer header — no official SDK\nconst response = await fetch('https://api.stability.ai/v2beta/stable-image/generate/core', {\n  method: 'POST',\n  headers: {\n    Authorization: `Bearer ${process.env.STABILITY_API_KEY}`,\n    Accept: 'application/json',\n  },\n});"
+  },
+  "pricing": {
+    "model": "usage_based",
+    "freeTier": "25 free credits on signup; credits do not refresh — purchase additional credits when exhausted",
+    "startingPrice": "Pay per use: SDXL ~$0.002/image, SD3 Medium ~$0.035/image, Stable Image Core ~$0.003/image",
+    "costPer": "SDXL 1.0: 0.2 credits/image ($0.002); SD3 Medium: 3.5 credits/image ($0.035); Stable Image Core: 0.3 credits/image ($0.003); 1000 credits = $10",
+    "pricingUrl": "https://platform.stability.ai/docs/credits-and-billing"
+  },
+  "rateLimits": {
+    "tier": "standard",
+    "limit": "150 requests per 10 seconds per API key; concurrent request limit also applies",
+    "notes": "Rate limits reset every 10 seconds. Image generation latency varies: SDXL takes 1-5 seconds; SD3 takes 5-20 seconds. Use async patterns for frontend apps.",
+    "retryStrategy": "Retry on 429 with exponential backoff. For longer-running generations (SD3), poll for results rather than expecting synchronous response."
+  },
+  "sdk": {
+    "primaryLanguage": "typescript",
+    "installCommand": "npm install --save-exact node-fetch",
+    "importStatement": "// No official JS SDK — use fetch with Authorization: Bearer header",
+    "otherLanguages": ["python"]
+  },
+  "codeExamples": [
+    {
+      "title": "Generate an image with Stable Diffusion XL",
+      "language": "typescript",
+      "code": "import fs from 'fs';\nimport path from 'path';\n\ninterface StabilityResponse {\n  image: string;\n  finish_reason: string;\n  seed: number;\n}\n\nasync function generateImage(prompt: string, outputPath: string): Promise<void> {\n  const formData = new FormData();\n  formData.append('prompt', prompt);\n  formData.append('output_format', 'png');\n  formData.append('width', '1024');\n  formData.append('height', '1024');\n\n  const response = await fetch(\n    'https://api.stability.ai/v2beta/stable-image/generate/core',\n    {\n      method: 'POST',\n      headers: {\n        Authorization: `Bearer ${process.env.STABILITY_API_KEY}`,\n        Accept: 'application/json',\n      },\n      body: formData,\n    }\n  );\n\n  if (!response.ok) {\n    const error = await response.json();\n    throw new Error(`Stability AI error ${response.status}: ${JSON.stringify(error)}`);\n  }\n\n  const data = (await response.json()) as StabilityResponse;\n\n  // Response contains base64-encoded image\n  const imageBuffer = Buffer.from(data.image, 'base64');\n  fs.writeFileSync(outputPath, imageBuffer);\n\n  console.log(`Image saved to ${outputPath} (seed: ${data.seed})`);\n}\n\nawait generateImage(\n  'A photorealistic red fox sitting in a snowy forest, golden hour lighting',\n  path.join(process.cwd(), 'output.png')\n);",
+      "notes": "Use Accept: 'application/json' to receive base64-encoded image in the response body. Use Accept: 'image/*' to receive raw binary data instead. The v2beta endpoint uses FormData, not JSON body."
+    },
+    {
+      "title": "Remove background from an image",
+      "language": "typescript",
+      "code": "import fs from 'fs';\n\nasync function removeBackground(\n  inputImagePath: string,\n  outputImagePath: string\n): Promise<void> {\n  const imageBuffer = fs.readFileSync(inputImagePath);\n  const imageBlob = new Blob([imageBuffer], { type: 'image/png' });\n\n  const formData = new FormData();\n  formData.append('image', imageBlob, 'input.png');\n  formData.append('output_format', 'png');\n\n  const response = await fetch(\n    'https://api.stability.ai/v2beta/stable-image/edit/remove-background',\n    {\n      method: 'POST',\n      headers: {\n        Authorization: `Bearer ${process.env.STABILITY_API_KEY}`,\n        Accept: 'application/json',\n      },\n      body: formData,\n    }\n  );\n\n  if (!response.ok) {\n    const error = await response.json();\n    throw new Error(`Background removal failed ${response.status}: ${JSON.stringify(error)}`);\n  }\n\n  const data = (await response.json()) as { image: string; finish_reason: string };\n  const outputBuffer = Buffer.from(data.image, 'base64');\n  fs.writeFileSync(outputImagePath, outputBuffer);\n\n  console.log(`Background removed. Saved to ${outputImagePath}`);\n}\n\nawait removeBackground('product.png', 'product-nobg.png');",
+      "notes": "Background removal costs 2 credits per image ($0.02). Works best on images with clear subject-background separation. Returns a PNG with transparent background — preserve the PNG format to keep transparency."
+    }
+  ],
+  "gotchas": [
+    "Stability AI credits are NOT free trial credits that refresh monthly — they are one-time credits you purchase. The 25 signup credits are enough for ~100 SDXL images or ~7 SD3 images. After that, you must buy more credits. Budget accordingly for any app with real user-generated images.",
+    "Stability AI returns images as binary data (application/octet-stream) or base64-encoded JSON depending on the endpoint and the Accept header you send. The response format also differs between REST API versions (v1 vs v2beta). Always verify the Accept header matches your parsing logic.",
+    "The Stability AI API does NOT guarantee content safety — prompts can generate inappropriate content unless you add your own content filtering. Implement prompt screening (using a moderation API) and output validation before showing generated images to users.",
+    "Stability AI API availability has been inconsistent historically. The company has had financial difficulties and has pivoted its API products multiple times. For production apps requiring high availability, consider using Replicate (which also hosts Stable Diffusion models) as a more operationally stable provider."
+  ],
+  "reliability": {
+    "uptimeGuarantee": null,
+    "statusPageUrl": "https://stability.statuspage.io",
+    "notes": "No published SLA. Historical availability has been inconsistent — the platform has experienced multi-hour outages during peak demand and during company restructuring periods. Monitor the status page and implement a fallback provider for production use."
+  },
+  "qualityScore": 7,
+  "qualityJustification": "Direct access to Stable Diffusion models including SDXL and SD3 with competitive per-image pricing. Good for image generation use cases. Loses points for inconsistent platform reliability, lack of an official Node.js SDK, region-specific response format quirks, and the company's unstable business history. Replicate offers a more reliable hosted alternative for Stable Diffusion.",
+  "alternatives": ["replicate", "openai"],
+  "complementary": ["cloudinary", "uploadthing", "openai"],
+  "bestFor": "Generating images from text prompts with Stable Diffusion models — SDXL for fast, cheap generation; SD3 for higher quality photorealistic images",
+  "lastVerified": "2026-02-25",
+  "entryVersion": 1,
+  "addedBy": "claude-code-session-4"
+}

package/src/entries/analytics/posthog.json

@@ -0,0 +1,88 @@
+{
+  "name": "PostHog",
+  "slug": "posthog",
+  "category": "analytics",
+  "subcategory": "product-analytics",
+  "website": "https://posthog.com",
+  "description": "PostHog is an open-source product analytics platform combining event tracking, funnels, session recording, feature flags, and A/B testing in a single tool. It can be self-hosted for full data ownership or used as a managed cloud service, making it the preferred choice for privacy-conscious teams and developers who want full control over their analytics stack.",
+  "useCases": [
+    {
+      "task": "Track user events and build product analytics funnels",
+      "fit": "perfect"
+    },
+    {
+      "task": "Record user sessions to understand how users interact with your UI",
+      "fit": "perfect"
+    },
+    {
+      "task": "Roll out features gradually with feature flags",
+      "fit": "perfect"
+    },
+    {
+      "task": "Run A/B tests to measure feature impact",
+      "fit": "perfect"
+    },
+    {
+      "task": "Self-host analytics for GDPR compliance or data residency requirements",
+      "fit": "perfect"
+    }
+  ],
+  "auth": {
+    "method": "api_key",
+    "setupSteps": [
+      "Sign up at posthog.com (or self-host via Docker/Kubernetes)",
+      "Create a new project in the PostHog dashboard",
+      "Copy your Project API Key from Project Settings > Project API Key",
+      "Install the PostHog SDK for your platform",
+      "Set POSTHOG_API_KEY and POSTHOG_HOST environment variables"
+    ],
+    "envVarName": "POSTHOG_API_KEY",
+    "codeSnippet": "import { PostHog } from 'posthog-node';\nconst client = new PostHog(process.env.POSTHOG_API_KEY!, {\n  host: process.env.POSTHOG_HOST ?? 'https://us.i.posthog.com',\n});"
+  },
+  "pricing": {
+    "model": "freemium",
+    "freeTier": "1,000,000 events/month free, unlimited projects, session recordings included",
+    "startingPrice": "Pay-as-you-go after 1M events: $0.00005/event (very gradual scale)",
+    "costPer": "$0.00005 per event above 1M/month; session recordings: $0.005/recording above 5,000 free",
+    "pricingUrl": "https://posthog.com/pricing"
+  },
+  "rateLimits": {
+    "tier": "all tiers",
+    "limit": "No documented API rate limit for event ingestion; batch events to be safe",
+    "notes": "PostHog is designed for high-volume event ingestion. Use the SDK's built-in batching (default batch size: 20 events, flush interval: 10s) rather than sending individual events.",
+    "retryStrategy": "PostHog Node SDK handles retries automatically. For self-hosted setups, events queue locally and retry on network failures."
+  },
+  "sdk": {
+    "primaryLanguage": "typescript",
+    "installCommand": "npm install --save-exact posthog-node",
+    "importStatement": "import { PostHog } from 'posthog-node';",
+    "otherLanguages": ["python", "ruby", "go", "php", "java", "ios", "android", "react-native", "flutter"]
+  },
+  "codeExamples": [
+    {
+      "title": "Track events and identify users (server-side)",
+      "language": "typescript",
+      "code": "import { PostHog } from 'posthog-node';\n\nconst posthog = new PostHog(process.env.POSTHOG_API_KEY!, {\n  host: process.env.POSTHOG_HOST ?? 'https://us.i.posthog.com',\n  flushAt: 20,    // batch size before auto-flush\n  flushInterval: 10000, // ms between auto-flushes\n});\n\n// Identify a user with properties\nposthog.identify({\n  distinctId: 'user-123',\n  properties: {\n    email: 'jane@example.com',\n    plan: 'pro',\n    signedUpAt: '2026-01-15',\n  },\n});\n\n// Track an event\nposthog.capture({\n  distinctId: 'user-123',\n  event: 'checkout_completed',\n  properties: {\n    orderId: 'order_456',\n    totalAmount: 99.99,\n    currency: 'USD',\n    itemCount: 3,\n  },\n});\n\n// Check a feature flag\nconst flagEnabled = await posthog.isFeatureEnabled('new-checkout-flow', 'user-123');\nif (flagEnabled) {\n  // show new experience\n}\n\n// IMPORTANT: flush before process exits (e.g., in serverless)\nawait posthog.shutdown();",
+      "notes": "Always call posthog.shutdown() before the process exits (e.g., in serverless/edge functions) to flush the event queue. In long-running servers, the SDK auto-flushes on interval. Use distinctId consistently — it ties all events to one user."
+    }
+  ],
+  "gotchas": [
+    "PostHog Node SDK batches events and flushes asynchronously — in serverless functions (Vercel, AWS Lambda), the process may exit before events are sent. Always call `await posthog.shutdown()` at the end of serverless handlers, or use `await posthog.flushAsync()`.",
+    "The free 1M events/month sounds huge, but session recordings count separately and can add up quickly if you have many users. Session recordings are $0.005 each above 5,000/month — audit your recording settings and consider sampling.",
+    "Feature flags are evaluated server-side by calling the PostHog API on each request unless you use local evaluation. Enable local evaluation (requires downloading the flag config) to avoid latency on every request.",
+    "Self-hosting PostHog requires significant infrastructure (ClickHouse, Kafka, Redis, PostgreSQL). The all-in-one Docker Compose setup works for small scale but needs ~4GB RAM minimum. The cloud version is much easier to start with."
+  ],
+  "reliability": {
+    "uptimeGuarantee": "99.9% uptime on cloud; self-hosted depends on your infrastructure",
+    "statusPageUrl": "https://status.posthog.com",
+    "notes": "PostHog cloud (US and EU regions) has strong reliability. The SDK is designed to fail silently — analytics errors should never break your application."
+  },
+  "qualityScore": 8,
+  "qualityJustification": "Best product analytics platform with the most generous free tier (1M events/month). The combination of event tracking, session recording, feature flags, and A/B testing in one SDK is a genuine differentiator. Open-source and self-hostable for data control. The only drawbacks are self-hosting complexity and the serverless flush gotcha.",
+  "alternatives": ["sentry"],
+  "complementary": ["sentry", "clerk", "supabase", "stripe"],
+  "bestFor": "Product analytics, feature flags, and session recording with a generous free tier and optional self-hosting for data ownership",
+  "lastVerified": "2026-02-25",
+  "entryVersion": 1,
+  "addedBy": "claude-code-session-2"
+}

package/src/entries/analytics/sentry.json

@@ -0,0 +1,84 @@
+{
+  "name": "Sentry",
+  "slug": "sentry",
+  "category": "analytics",
+  "subcategory": "error-monitoring",
+  "website": "https://sentry.io",
+  "description": "Sentry is the industry-standard error tracking and application performance monitoring platform. It automatically captures unhandled exceptions, tracks performance regressions, and provides full stack traces with source maps — giving developers the context needed to reproduce and fix bugs fast. Available as cloud SaaS or self-hosted.",
+  "useCases": [
+    {
+      "task": "Capture and track unhandled errors and exceptions in production",
+      "fit": "perfect"
+    },
+    {
+      "task": "Monitor application performance and identify slow API calls or transactions",
+      "fit": "perfect"
+    },
+    {
+      "task": "Set up alerts when error rates spike or new issues appear",
+      "fit": "perfect"
+    },
+    {
+      "task": "Debug production issues with full stack traces and breadcrumbs",
+      "fit": "perfect"
+    }
+  ],
+  "auth": {
+    "method": "api_key",
+    "setupSteps": [
+      "Sign up at sentry.io and create a new project",
+      "Select your platform (Node.js, React, Next.js, etc.)",
+      "Copy the DSN (Data Source Name) from the project settings",
+      "Install the Sentry SDK and initialize with the DSN",
+      "Set SENTRY_DSN environment variable"
+    ],
+    "envVarName": "SENTRY_DSN",
+    "codeSnippet": "import * as Sentry from '@sentry/node';\nSentry.init({ dsn: process.env.SENTRY_DSN! });"
+  },
+  "pricing": {
+    "model": "freemium",
+    "freeTier": "5,000 errors/month, 10,000 performance transactions/month, 1 user",
+    "startingPrice": "$26/month (Team plan) for 50,000 errors and additional team members",
+    "costPer": "Errors: $0.00029/error above quota; Performance: $0.0001/transaction",
+    "pricingUrl": "https://sentry.io/pricing"
+  },
+  "rateLimits": {
+    "tier": "free tier",
+    "limit": "5,000 events/month; ingest rate limited based on plan",
+    "notes": "Sentry silently drops events once quota is exhausted unless you configure rate limiting or purchase more quota. Set up quota alerts in the dashboard.",
+    "retryStrategy": "Sentry SDK handles retries internally. If quota is exhausted, events are dropped server-side. Monitor quota usage via the Sentry dashboard stats API."
+  },
+  "sdk": {
+    "primaryLanguage": "typescript",
+    "installCommand": "npm install --save-exact @sentry/node @sentry/profiling-node",
+    "importStatement": "import * as Sentry from '@sentry/node';",
+    "otherLanguages": ["python", "ruby", "java", "go", "php", "react", "vue", "angular", "nextjs"]
+  },
+  "codeExamples": [
+    {
+      "title": "Initialize Sentry in a Node.js/Express app",
+      "language": "typescript",
+      "code": "import * as Sentry from '@sentry/node';\nimport { nodeProfilingIntegration } from '@sentry/profiling-node';\nimport express from 'express';\n\n// IMPORTANT: Initialize Sentry BEFORE any other imports/setup\nSentry.init({\n  dsn: process.env.SENTRY_DSN!,\n  environment: process.env.NODE_ENV ?? 'development',\n  integrations: [nodeProfilingIntegration()],\n  tracesSampleRate: 1.0,  // Capture 100% of transactions (reduce in prod)\n  profilesSampleRate: 1.0,\n});\n\nconst app = express();\n\n// Add routes here...\n\n// IMPORTANT: Sentry error handler must be AFTER routes and BEFORE other error handlers\nSentry.setupExpressErrorHandler(app);\n\n// Example: manually capture an error with context\ntry {\n  const result = await riskyOperation();\n} catch (error) {\n  Sentry.captureException(error, {\n    extra: { userId: 'user-123', operation: 'riskyOperation' },\n    tags: { feature: 'checkout' },\n  });\n  throw error;\n}",
+      "notes": "Sentry MUST be initialized before any other code. In Next.js, use sentry.server.config.ts and the Sentry Next.js wizard (`npx @sentry/wizard@latest -i nextjs`). The tracesSampleRate controls APM cost — set to 0.1-0.2 in production."
+    }
+  ],
+  "gotchas": [
+    "Sentry must be initialized before any other imports — especially in Next.js where the initialization order matters. Using the Sentry wizard (`npx @sentry/wizard@latest -i nextjs`) handles this automatically and is strongly recommended over manual setup.",
+    "The free plan quota (5,000 errors/month) is exhausted quickly in active development if you're also capturing dev/staging errors. Always filter by environment and set up separate DSNs for dev vs. production.",
+    "Source maps are required for readable stack traces in minified/compiled code. Without them, you'll see `bundle.js:1:45820` instead of actual file/line numbers. Configure source map upload in your build pipeline.",
+    "Sentry's performance monitoring (tracing) adds overhead to every request. Set tracesSampleRate to 0.1 or lower in production, not 1.0, unless you're on a paid plan with sufficient transaction quota."
+  ],
+  "reliability": {
+    "uptimeGuarantee": "99.9% uptime SLA on Business and above",
+    "statusPageUrl": "https://status.sentry.io",
+    "notes": "Sentry is battle-tested at scale, used by companies like GitHub, Cloudflare, and Disney. The SDK is designed to be non-blocking and fail silently to avoid impacting your application."
+  },
+  "qualityScore": 9,
+  "qualityJustification": "The undisputed standard for error tracking. Exceptional SDK quality across every major language and framework. Source map support, breadcrumbs, performance monitoring, and release tracking are all best-in-class. The free tier is limiting for teams but sufficient for solo projects. Near-zero setup friction with the wizard.",
+  "alternatives": ["posthog"],
+  "complementary": ["posthog", "supabase", "stripe"],
+  "bestFor": "Production error tracking and performance monitoring — the default choice for any application that needs to catch and debug runtime errors",
+  "lastVerified": "2026-02-25",
+  "entryVersion": 1,
+  "addedBy": "claude-code-session-2"
+}

package/src/entries/auth/auth0.json

@@ -0,0 +1,90 @@
+{
+  "name": "Auth0",
+  "slug": "auth0",
+  "category": "auth",
+  "subcategory": "identity-platform",
+  "website": "https://auth0.com",
+  "description": "Auth0 (by Okta) is an enterprise-grade identity platform supporting a wide range of authentication flows including social login, SSO, MFA, and custom databases. It is the industry standard for enterprise applications requiring compliance (SOC 2, HIPAA, GDPR), fine-grained authorization, and support for complex multi-tenant identity scenarios.",
+  "useCases": [
+    {
+      "task": "Add enterprise SSO and SAML authentication",
+      "fit": "perfect"
+    },
+    {
+      "task": "Implement machine-to-machine authentication for APIs",
+      "fit": "perfect"
+    },
+    {
+      "task": "Build HIPAA or SOC 2 compliant authentication",
+      "fit": "perfect"
+    },
+    {
+      "task": "Add social login to a web application",
+      "fit": "good"
+    },
+    {
+      "task": "Simple sign-up/sign-in for a consumer app",
+      "fit": "good"
+    }
+  ],
+  "auth": {
+    "method": "oauth2",
+    "setupSteps": [
+      "Sign up at auth0.com",
+      "Create a new Application in the Auth0 Dashboard (choose Regular Web App, SPA, or Machine to Machine)",
+      "Configure Allowed Callback URLs and Allowed Logout URLs",
+      "Copy your Domain and Client ID (and Client Secret for server-side)",
+      "Set AUTH0_DOMAIN, AUTH0_CLIENT_ID, and AUTH0_CLIENT_SECRET environment variables",
+      "Install the Auth0 SDK for your framework"
+    ],
+    "envVarName": "AUTH0_CLIENT_SECRET",
+    "codeSnippet": "import { initAuth0 } from '@auth0/nextjs-auth0';\nexport const auth0 = initAuth0({\n  domain: process.env.AUTH0_DOMAIN!,\n  clientId: process.env.AUTH0_CLIENT_ID!,\n  clientSecret: process.env.AUTH0_CLIENT_SECRET!,\n  secret: process.env.AUTH0_SECRET!, // Random string for session encryption\n  baseURL: process.env.APP_BASE_URL!,\n});"
+  },
+  "pricing": {
+    "model": "freemium",
+    "freeTier": "7,500 MAU, unlimited logins, social connections",
+    "startingPrice": "$35/month for up to 1,000 MAU on Professional plan",
+    "costPer": "Professional: ~$0.07/MAU; Enterprise pricing is custom",
+    "pricingUrl": "https://auth0.com/pricing"
+  },
+  "rateLimits": {
+    "tier": "free tier",
+    "limit": "300 requests/minute for Management API; authentication endpoints have separate limits",
+    "notes": "Management API rate limits are separate from authentication limits. Authentication endpoints (login, token) have generous limits. Check dashboard for current limits.",
+    "retryStrategy": "Respect Retry-After header on 429 responses; implement exponential backoff for Management API calls"
+  },
+  "sdk": {
+    "primaryLanguage": "typescript",
+    "installCommand": "npm install --save-exact @auth0/nextjs-auth0",
+    "importStatement": "import { initAuth0 } from '@auth0/nextjs-auth0';",
+    "otherLanguages": ["react", "vue", "angular", "python", "java", "ruby", "go", "dotnet"]
+  },
+  "codeExamples": [
+    {
+      "title": "Set up Auth0 in Next.js App Router",
+      "language": "typescript",
+      "code": "// lib/auth0.ts\nimport { initAuth0 } from '@auth0/nextjs-auth0';\n\nexport const auth0 = initAuth0({\n  domain: process.env.AUTH0_DOMAIN!,\n  clientId: process.env.AUTH0_CLIENT_ID!,\n  clientSecret: process.env.AUTH0_CLIENT_SECRET!,\n  secret: process.env.AUTH0_SECRET!,\n  baseURL: process.env.APP_BASE_URL!,\n});\n\n// app/api/auth/[auth0]/route.ts\nimport { auth0 } from '@/lib/auth0';\nexport const GET = auth0.handleAuth();\n\n// Get user in a Server Component\nimport { auth0 } from '@/lib/auth0';\nexport default async function Dashboard() {\n  const session = await auth0.getSession();\n  if (!session) redirect('/api/auth/login');\n  return <h1>Hello, {session.user.name}</h1>;\n}",
+      "notes": "The handleAuth() handler creates /api/auth/login, /api/auth/logout, /api/auth/callback, and /api/auth/me endpoints automatically."
+    }
+  ],
+  "gotchas": [
+    "Auth0's free tier is 7,500 MAU but the jump to paid is steep ($35/month minimum). If you have between 7,500 and 10,000 MAU, Clerk's free tier (10,000 MAU) is more cost-effective.",
+    "The Management API (for user CRUD, role management) has strict rate limits (300 req/min). Caching user data in your own database and only calling the Management API when data changes is strongly recommended for any real application.",
+    "Auth0 has multiple SDKs for different frameworks (@auth0/nextjs-auth0, @auth0/auth0-react, auth0-spa-js). Make sure you install the right one for your stack — they are NOT interchangeable.",
+    "Auth0 Tenant configuration is complex. Actions (custom code), Rules (legacy), Hooks, Connections, and Applications all interact. Plan your tenant architecture before building.",
+    "SSO and enterprise connections (SAML, OIDC, Active Directory) are only available on paid plans. If your primary use case is enterprise SSO, factor this into your pricing evaluation."
+  ],
+  "reliability": {
+    "uptimeGuarantee": "99.99% uptime SLA on Enterprise plans",
+    "statusPageUrl": "https://status.auth0.com",
+    "notes": "Auth0 is enterprise-grade with global infrastructure. The Okta acquisition has brought additional enterprise resources. Compliance certifications: SOC 2, ISO 27001, HIPAA, GDPR."
+  },
+  "qualityScore": 7,
+  "qualityJustification": "Gold standard for enterprise auth with unmatched compliance and SSO capabilities. However, it has a steeper learning curve, more complex setup, higher pricing, and a less modern developer experience compared to Clerk. The ideal choice when enterprise SSO or compliance requirements demand it.",
+  "alternatives": ["clerk"],
+  "complementary": ["stripe", "resend"],
+  "bestFor": "Enterprise applications requiring SSO, SAML, fine-grained authorization, compliance certifications, or complex multi-tenant identity scenarios",
+  "lastVerified": "2026-02-25",
+  "entryVersion": 1,
+  "addedBy": "claude-code-session-1"
+}

package/src/entries/auth/clerk.json

@@ -0,0 +1,95 @@
+{
+  "name": "Clerk",
+  "slug": "clerk",
+  "category": "auth",
+  "subcategory": "authentication-platform",
+  "website": "https://clerk.com",
+  "description": "Clerk is a complete authentication and user management platform with drop-in UI components for sign-up, sign-in, and user profiles. It handles OAuth providers, passkeys, magic links, multi-factor authentication, and organizations out-of-the-box — making it the fastest way to add auth to a Next.js or React application.",
+  "useCases": [
+    {
+      "task": "Add complete authentication (sign-up, sign-in, OAuth) to a Next.js app",
+      "fit": "perfect"
+    },
+    {
+      "task": "Implement multi-tenant organizations and team management",
+      "fit": "perfect"
+    },
+    {
+      "task": "Add social login (Google, GitHub, etc.) to a web app",
+      "fit": "perfect"
+    },
+    {
+      "task": "Protect API routes and server components with authentication",
+      "fit": "perfect"
+    },
+    {
+      "task": "Build custom authentication flows from scratch",
+      "fit": "partial"
+    }
+  ],
+  "auth": {
+    "method": "api_key",
+    "setupSteps": [
+      "Sign up at clerk.com",
+      "Create a new application in the Clerk Dashboard",
+      "Configure authentication providers (email, Google, GitHub, etc.)",
+      "Copy your Publishable Key and Secret Key",
+      "Set NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY and CLERK_SECRET_KEY environment variables",
+      "Wrap your app with <ClerkProvider> and add middleware"
+    ],
+    "envVarName": "CLERK_SECRET_KEY",
+    "codeSnippet": "import { ClerkProvider } from '@clerk/nextjs';\n// In middleware.ts:\nimport { clerkMiddleware } from '@clerk/nextjs/server';\nexport default clerkMiddleware();"
+  },
+  "pricing": {
+    "model": "freemium",
+    "freeTier": "10,000 monthly active users (MAU), all core features",
+    "startingPrice": "$25/month for 10,001-100,000 MAU",
+    "costPer": "$0.02 per MAU above free tier (Pro plan)",
+    "pricingUrl": "https://clerk.com/pricing"
+  },
+  "rateLimits": {
+    "tier": "free tier",
+    "limit": "No API rate limits documented; frontend auth calls managed by Clerk's infrastructure",
+    "notes": "Rate limits are handled by Clerk's infrastructure. Unusual activity triggers automatic protection.",
+    "retryStrategy": "Clerk SDK handles retries internally. Implement standard retry for backend API calls to Clerk's REST API."
+  },
+  "sdk": {
+    "primaryLanguage": "typescript",
+    "installCommand": "npm install --save-exact @clerk/nextjs",
+    "importStatement": "import { ClerkProvider, SignIn, SignUp, useUser } from '@clerk/nextjs';",
+    "otherLanguages": ["react", "remix", "astro", "express", "fastify", "hono"]
+  },
+  "codeExamples": [
+    {
+      "title": "Protect a Next.js route and get current user",
+      "language": "typescript",
+      "code": "// middleware.ts (protects all routes by default)\nimport { clerkMiddleware, createRouteMatcher } from '@clerk/nextjs/server';\n\nconst isPublicRoute = createRouteMatcher(['/sign-in(.*)', '/sign-up(.*)', '/']);\n\nexport default clerkMiddleware(async (auth, request) => {\n  if (!isPublicRoute(request)) {\n    await auth.protect(); // Redirects to sign-in if not authenticated\n  }\n});\n\nexport const config = {\n  matcher: ['/((?!_next|[^?]*\\.(?:html?|css|js(?!on)|jpe?g|webp|png|gif|svg|ttf|woff2?|ico|csv|docx?|xlsx?|zip|webmanifest)).*)', '/(api|trpc)(.*)'],\n};",
+      "notes": "clerkMiddleware is the recommended approach for Next.js App Router. Add the matcher to skip static files."
+    },
+    {
+      "title": "Get user in a Server Component",
+      "language": "typescript",
+      "code": "// app/dashboard/page.tsx\nimport { auth, currentUser } from '@clerk/nextjs/server';\nimport { redirect } from 'next/navigation';\n\nexport default async function DashboardPage() {\n  const { userId } = await auth();\n  \n  if (!userId) {\n    redirect('/sign-in');\n  }\n  \n  const user = await currentUser();\n  \n  return (\n    <div>\n      <h1>Welcome, {user?.firstName}!</h1>\n      <p>Your ID: {userId}</p>\n    </div>\n  );\n}",
+      "notes": "Use auth() for just the userId (fast, no extra API call). Use currentUser() for full profile data. Both are server-only."
+    }
+  ],
+  "gotchas": [
+    "Clerk's pricing is based on Monthly Active Users (MAU), not API calls. An MAU is any user who authenticates at least once per month. With a large but mostly dormant user base, this is very cost-effective. With a highly active user base, plan carefully.",
+    "The middleware matcher must be configured correctly — missing routes in the matcher means they won't be protected. The default matcher skips static files and _next — copy it exactly from the docs.",
+    "Clerk creates its own User object with a Clerk user ID (clerkId). You typically need to sync this to your own database on first sign-in using Clerk webhooks. Plan this user sync from day one.",
+    "Clerk components (SignIn, SignUp, UserButton) use an iframe in some modes, which can cause CSP (Content Security Policy) issues. Configure your CSP to allow Clerk's domains."
+  ],
+  "reliability": {
+    "uptimeGuarantee": "99.99% uptime SLA on Enterprise plans",
+    "statusPageUrl": "https://status.clerk.com",
+    "notes": "Clerk's infrastructure is highly available with global edge deployment. Authentication flows are critical path — Clerk treats this accordingly."
+  },
+  "qualityScore": 9,
+  "qualityJustification": "Best developer experience for adding auth to Next.js applications. Exceptional TypeScript support, beautiful pre-built components, generous free tier, and comprehensive feature set. Minor deductions for potential complexity with custom auth flows and the user sync webhook requirement.",
+  "alternatives": ["auth0"],
+  "complementary": ["resend", "stripe", "uploadthing"],
+  "bestFor": "Drop-in authentication with pre-built UI for Next.js and React applications, especially with social auth and multi-tenancy needs",
+  "lastVerified": "2026-02-25",
+  "entryVersion": 1,
+  "addedBy": "claude-code-session-1"
+}