@adityanair98/api-oracle 0.5.0

package/src/entries/media/deepgram.json

@@ -0,0 +1,84 @@
+{
+  "name": "Deepgram",
+  "slug": "deepgram",
+  "category": "media",
+  "subcategory": "speech-to-text",
+  "website": "https://deepgram.com",
+  "description": "Deepgram is a speech-to-text AI platform providing real-time and batch audio transcription with industry-leading accuracy, low latency, and competitive pricing. It supports 30+ languages, speaker diarization, punctuation, and custom vocabulary — making it the preferred choice over OpenAI Whisper for production audio transcription.",
+  "useCases": [
+    {
+      "task": "Transcribe audio and video files to text",
+      "fit": "perfect"
+    },
+    {
+      "task": "Add real-time speech-to-text to a voice application",
+      "fit": "perfect"
+    },
+    {
+      "task": "Transcribe meeting recordings with speaker identification",
+      "fit": "perfect"
+    },
+    {
+      "task": "Add voice commands to a web or mobile application",
+      "fit": "good"
+    }
+  ],
+  "auth": {
+    "method": "api_key",
+    "setupSteps": [
+      "Sign up at deepgram.com",
+      "Go to the console and create a new API Key",
+      "Set the permissions (Member access is sufficient for most use cases)",
+      "Copy the API key immediately (it is only shown once)",
+      "Set DEEPGRAM_API_KEY environment variable"
+    ],
+    "envVarName": "DEEPGRAM_API_KEY",
+    "codeSnippet": "import { createClient } from '@deepgram/sdk';\nconst deepgram = createClient(process.env.DEEPGRAM_API_KEY!);"
+  },
+  "pricing": {
+    "model": "usage_based",
+    "freeTier": "$200 in free credits on signup (no expiry on Nova models)",
+    "startingPrice": "$0.0043 per minute (Nova-2 model, pre-recorded)",
+    "costPer": "$0.0043/min pre-recorded; $0.0059/min real-time streaming; whisper model at $0.0048/min",
+    "pricingUrl": "https://deepgram.com/pricing"
+  },
+  "rateLimits": {
+    "tier": "default",
+    "limit": "100 concurrent connections; 100 requests/minute for pre-recorded",
+    "notes": "Rate limits are generous for most applications. Real-time connections count against concurrent limit. Contact support for higher limits.",
+    "retryStrategy": "Implement exponential backoff for 429 responses. For long audio files, consider chunking into segments if timeouts occur."
+  },
+  "sdk": {
+    "primaryLanguage": "typescript",
+    "installCommand": "npm install --save-exact @deepgram/sdk",
+    "importStatement": "import { createClient } from '@deepgram/sdk';",
+    "otherLanguages": ["python", "go", "dotnet", "rust"]
+  },
+  "codeExamples": [
+    {
+      "title": "Transcribe an audio file",
+      "language": "typescript",
+      "code": "import { createClient } from '@deepgram/sdk';\nimport { readFileSync } from 'fs';\n\nconst deepgram = createClient(process.env.DEEPGRAM_API_KEY!);\n\n// Transcribe from a URL\nconst { result, error } = await deepgram.listen.prerecorded.transcribeUrl(\n  { url: 'https://example.com/meeting.mp3' },\n  {\n    model: 'nova-2',\n    smart_format: true,      // Add punctuation and capitalization\n    diarize: true,           // Identify different speakers\n    paragraphs: true,        // Group sentences into paragraphs\n    language: 'en',\n  }\n);\n\nif (error) throw new Error(error.message);\n\nconst transcript = result.results.channels[0]?.alternatives[0]?.transcript;\nconsole.log('Transcript:', transcript);\n\n// Speaker-labeled output\nfor (const word of result.results.channels[0]?.alternatives[0]?.words ?? []) {\n  console.log(`[Speaker ${word.speaker}] ${word.word}`);\n}",
+      "notes": "Use 'nova-2' model for best accuracy. smart_format adds punctuation automatically. diarize splits transcript by speaker — useful for meeting notes."
+    }
+  ],
+  "gotchas": [
+    "API keys are shown only once at creation. If you lose it, you must create a new one. Always save it to your password manager immediately after creation.",
+    "Audio files must be accessible via URL or uploaded as binary. Files on localhost are not accessible — use a public URL or the transcribeFile() method with a Buffer for local files.",
+    "The diarize option (speaker identification) adds latency to responses. For real-time transcription, skip diarization unless you specifically need it.",
+    "Deepgram's WebSocket real-time API requires careful connection management — you must keep the connection alive with KeepAlive messages and handle reconnection logic."
+  ],
+  "reliability": {
+    "uptimeGuarantee": "99.9% uptime SLA on paid plans",
+    "statusPageUrl": "https://status.deepgram.com",
+    "notes": "Deepgram processes billions of minutes of audio. Global infrastructure with low latency. Significantly faster than batch-only alternatives."
+  },
+  "qualityScore": 8,
+  "qualityJustification": "Best speech-to-text API for production use with better accuracy than OpenAI Whisper at lower latency and competitive pricing. Excellent TypeScript SDK. $200 free credit is genuinely useful. Slightly less mainstream than Whisper, so fewer community examples.",
+  "alternatives": ["openai"],
+  "complementary": ["openai", "anthropic", "mux", "replicate"],
+  "bestFor": "Production speech-to-text transcription with speaker diarization, real-time streaming, and better accuracy than Whisper at competitive prices",
+  "lastVerified": "2026-02-25",
+  "entryVersion": 1,
+  "addedBy": "claude-code-session-2"
+}

package/src/entries/media/imgix.json

@@ -0,0 +1,84 @@
+{
+  "name": "imgix",
+  "slug": "imgix",
+  "category": "media",
+  "subcategory": "image-processing",
+  "website": "https://imgix.com",
+  "description": "imgix is an image processing and CDN service that transforms, optimizes, and delivers images on-the-fly via URL parameters. Unlike Cloudinary, imgix works with your existing S3, GCS, or any origin server — it is a pure transformation and delivery layer, not a storage service.",
+  "useCases": [
+    {
+      "task": "Resize and transform images from S3 or existing storage on-the-fly",
+      "fit": "perfect"
+    },
+    {
+      "task": "Automatically convert images to WebP or AVIF for web performance",
+      "fit": "perfect"
+    },
+    {
+      "task": "Serve responsive images with srcset and different sizes",
+      "fit": "perfect"
+    },
+    {
+      "task": "Upload and store images with built-in management",
+      "fit": "partial"
+    }
+  ],
+  "auth": {
+    "method": "api_key",
+    "setupSteps": [
+      "Sign up at imgix.com",
+      "Create a new Source pointing to your S3 bucket or storage origin",
+      "Note your subdomain (e.g., your-company.imgix.net)",
+      "For secure URLs, find your API Key in Settings",
+      "Set IMGIX_TOKEN and IMGIX_DOMAIN environment variables"
+    ],
+    "envVarName": "IMGIX_TOKEN",
+    "codeSnippet": "import ImgixClient from '@imgix/js-core';\nconst client = new ImgixClient({\n  domain: process.env.IMGIX_DOMAIN!,\n  secureURLToken: process.env.IMGIX_TOKEN,\n});"
+  },
+  "pricing": {
+    "model": "freemium",
+    "freeTier": "1,000 master images, 25GB bandwidth/month",
+    "startingPrice": "$100/month (Starter plan)",
+    "costPer": "Starter: up to 100GB bandwidth; Growth: $300/month for 500GB; Enterprise custom",
+    "pricingUrl": "https://imgix.com/pricing"
+  },
+  "rateLimits": {
+    "tier": "all tiers",
+    "limit": "No rate limit on image delivery (CDN); Management API has standard limits",
+    "notes": "Image transformations are cached at the CDN edge. No per-transformation charge — only bandwidth counts.",
+    "retryStrategy": "CDN delivery is highly available. Implement fallback to source URL if imgix is unavailable."
+  },
+  "sdk": {
+    "primaryLanguage": "typescript",
+    "installCommand": "npm install --save-exact @imgix/js-core",
+    "importStatement": "import ImgixClient from '@imgix/js-core';",
+    "otherLanguages": ["python", "ruby", "php", "java", "go"]
+  },
+  "codeExamples": [
+    {
+      "title": "Generate a transformed image URL",
+      "language": "typescript",
+      "code": "import ImgixClient from '@imgix/js-core';\n\nconst client = new ImgixClient({\n  domain: 'your-company.imgix.net',\n  secureURLToken: process.env.IMGIX_TOKEN,\n});\n\n// Generate URL for a 800x600 WebP image\nconst url = client.buildURL('path/to/image.jpg', {\n  w: 800,\n  h: 600,\n  fit: 'crop',\n  auto: 'format,compress', // Auto WebP/AVIF + compression\n  q: 80,\n});\n\nconsole.log('Transformed URL:', url);\n// https://your-company.imgix.net/path/to/image.jpg?w=800&h=600&fit=crop&auto=format%2Ccompress&q=80&s=...\n\n// Generate a srcset for responsive images\nconst srcSet = client.buildSrcSet('path/to/image.jpg', {\n  auto: 'format,compress',\n  fit: 'max',\n});\nconsole.log('srcSet:', srcSet);",
+      "notes": "The secureURLToken signs URLs to prevent unauthorized transformations. Always use signed URLs in production. auto=format serves WebP to browsers that support it, AVIF where available."
+    }
+  ],
+  "gotchas": [
+    "imgix is a transformation and delivery layer, not storage. You must already have your images stored somewhere (S3, GCS, a URL) — imgix points to your origin and transforms images on the way out. This means setup requires configuring your storage first.",
+    "imgix pricing starts at $100/month — significantly higher than Cloudinary's free tier. For small projects or prototypes, Cloudinary is much more accessible.",
+    "Unsigned URLs can be tampered with by anyone to request any transformation at your bandwidth cost. Always enable URL signing (secureURLToken) in production.",
+    "The free trial has a 'master image' limit — each unique source image path counts as one master. If you have more than 1,000 unique images, you'll exceed the trial."
+  ],
+  "reliability": {
+    "uptimeGuarantee": "99.9% SLA on all paid plans",
+    "statusPageUrl": "https://status.imgix.com",
+    "notes": "imgix uses a global CDN with 280+ PoPs. Images are cached at edge nodes after first transformation. Very high reliability for production use."
+  },
+  "qualityScore": 7,
+  "qualityJustification": "Excellent image processing quality with powerful URL-based transformations and a reliable CDN. Works with your existing storage (no lock-in). However, pricing starts at $100/month with no meaningful free tier, making it inaccessible for small teams. Cloudinary is better for most use cases due to the free tier.",
+  "alternatives": ["cloudinary"],
+  "complementary": ["cloudinary", "uploadthing", "supabase", "mux"],
+  "bestFor": "Image transformation and CDN delivery for teams already using S3 or GCS who need URL-based transformations without migrating storage",
+  "lastVerified": "2026-02-25",
+  "entryVersion": 1,
+  "addedBy": "claude-code-session-2"
+}

package/src/entries/media/mux.json

@@ -0,0 +1,94 @@
+{
+  "name": "Mux",
+  "slug": "mux",
+  "category": "media",
+  "subcategory": "video-streaming",
+  "website": "https://www.mux.com",
+  "description": "Mux is a developer-first video API platform for uploading, storing, encoding, and streaming video. It handles adaptive bitrate streaming (HLS), video-on-demand, live streaming, and real-time video — making it the standard choice for course platforms, social video, and any application that needs reliable video delivery at scale.",
+  "useCases": [
+    {
+      "task": "Stream video-on-demand content to users globally",
+      "fit": "perfect"
+    },
+    {
+      "task": "Build a course platform with video lessons",
+      "fit": "perfect"
+    },
+    {
+      "task": "Upload and process user-generated video content",
+      "fit": "perfect"
+    },
+    {
+      "task": "Add live streaming to an application",
+      "fit": "perfect"
+    },
+    {
+      "task": "Generate video thumbnails and previews",
+      "fit": "good"
+    }
+  ],
+  "auth": {
+    "method": "basic_auth",
+    "setupSteps": [
+      "Sign up at mux.com",
+      "Go to Settings > Access Tokens",
+      "Create a new access token with Full Access or Environment-specific permissions",
+      "Copy the Token ID and Token Secret",
+      "Set MUX_TOKEN_ID and MUX_TOKEN_SECRET environment variables"
+    ],
+    "envVarName": "MUX_TOKEN_SECRET",
+    "codeSnippet": "import Mux from '@mux/mux-node';\nconst mux = new Mux({\n  tokenId: process.env.MUX_TOKEN_ID!,\n  tokenSecret: process.env.MUX_TOKEN_SECRET!,\n});"
+  },
+  "pricing": {
+    "model": "usage_based",
+    "freeTier": "No permanent free tier; $20 free credit on signup",
+    "startingPrice": "$0.015 per minute of video stored; $0.005 per minute delivered",
+    "costPer": "Storage: $0.015/min/month; Delivery: $0.005/min; Encoding: $0.015/min input",
+    "pricingUrl": "https://www.mux.com/pricing"
+  },
+  "rateLimits": {
+    "tier": "all tiers",
+    "limit": "No documented hard rate limits for uploads/delivery",
+    "notes": "Mux uses a CDN for delivery — no rate limits on video streaming. API rate limits for management operations are generous. Contact support for high-volume upload scenarios.",
+    "retryStrategy": "Implement retry with exponential backoff for API calls. For upload failures, resume uploads using Mux's direct upload URL (valid for 24 hours)."
+  },
+  "sdk": {
+    "primaryLanguage": "typescript",
+    "installCommand": "npm install --save-exact @mux/mux-node @mux/mux-player-react",
+    "importStatement": "import Mux from '@mux/mux-node';\nimport MuxPlayer from '@mux/mux-player-react';",
+    "otherLanguages": ["python", "ruby", "go", "php"]
+  },
+  "codeExamples": [
+    {
+      "title": "Create an asset from a URL and get playback ID",
+      "language": "typescript",
+      "code": "import Mux from '@mux/mux-node';\n\nconst mux = new Mux({\n  tokenId: process.env.MUX_TOKEN_ID!,\n  tokenSecret: process.env.MUX_TOKEN_SECRET!,\n});\n\n// Create an asset by providing a video URL\nconst asset = await mux.video.assets.create({\n  input: [{ url: 'https://example.com/video.mp4' }],\n  playback_policy: ['public'],\n  video_quality: 'basic',\n});\n\nconsole.log('Asset ID:', asset.id);\nconsole.log('Status:', asset.status); // 'preparing' initially\n\n// Playback ID for streaming (available once status is 'ready')\nconst playbackId = asset.playback_ids?.[0]?.id;\nconsole.log('Playback URL:', `https://stream.mux.com/${playbackId}.m3u8`);",
+      "notes": "Assets take time to process (encoding). Listen for the 'video.asset.ready' webhook to know when it's ready for playback. Use the playback_ids[0].id for the player URL."
+    },
+    {
+      "title": "Embed Mux Player in React",
+      "language": "typescript",
+      "code": "import MuxPlayer from '@mux/mux-player-react';\n\nexport function VideoPlayer({ playbackId }: { playbackId: string }) {\n  return (\n    <MuxPlayer\n      playbackId={playbackId}\n      metadata={{\n        video_id: playbackId,\n        video_title: 'My Video',\n        viewer_user_id: 'user-123',\n      }}\n      accentColor=\"#7c3aed\"\n      autoPlay={false}\n      style={{ width: '100%', aspectRatio: '16/9' }}\n    />\n  );\n}",
+      "notes": "MuxPlayer is a customizable React video player that handles HLS streaming, quality selection, and analytics automatically. The metadata fields feed into Mux Data (real-time analytics)."
+    }
+  ],
+  "gotchas": [
+    "Video assets go through a 'preparing' state after upload. You cannot stream a video until it reaches 'ready' status. Always implement webhook handling for 'video.asset.ready' events rather than polling.",
+    "Mux pricing is based on minutes of video — both stored and delivered. A 10-hour course with 1,000 students watching = 600,000 minutes/month. Calculate expected costs carefully before launch.",
+    "Direct uploads (client-side) require a two-step process: first create a direct upload URL from your server, then upload the file directly from the browser to that URL. Never proxy large video uploads through your server.",
+    "Signed playback URLs are required for private content. If you set playback_policy to 'signed', viewers need a JWT token to play the video. Set up signed URL generation on your server before going to production with private content."
+  ],
+  "reliability": {
+    "uptimeGuarantee": "99.9% uptime SLA",
+    "statusPageUrl": "https://status.mux.com",
+    "notes": "Mux uses a global CDN for video delivery. Video encoding is handled asynchronously with webhook notifications. Used by Substack, Linear, and Beehiiv."
+  },
+  "qualityScore": 9,
+  "qualityJustification": "Best-in-class video API with excellent TypeScript SDK, pre-built React player component, and real-time analytics. The developer experience is exceptional — upload a URL, get a streaming URL in minutes. No permanent free tier is the main barrier for prototyping.",
+  "alternatives": ["cloudinary"],
+  "complementary": ["cloudinary", "uploadthing", "stripe", "imgix"],
+  "bestFor": "Video streaming for course platforms, social video apps, and any application requiring reliable adaptive bitrate video delivery",
+  "lastVerified": "2026-02-25",
+  "entryVersion": 1,
+  "addedBy": "claude-code-session-2"
+}

package/src/entries/messaging/ably.json

@@ -0,0 +1,94 @@
+{
+  "name": "Ably",
+  "slug": "ably",
+  "category": "messaging",
+  "subcategory": "realtime-messaging",
+  "website": "https://ably.com",
+  "description": "Ably is a real-time messaging platform built for mission-critical applications. Unlike simpler WebSocket services, Ably provides guaranteed message delivery, message history, fan-out at scale, and a pub/sub infrastructure with ordering guarantees — making it suitable for financial data, collaborative tools, and live commerce.",
+  "useCases": [
+    {
+      "task": "Build real-time collaborative features with guaranteed message delivery",
+      "fit": "perfect"
+    },
+    {
+      "task": "Stream live data feeds (stock prices, sports scores, IoT)",
+      "fit": "perfect"
+    },
+    {
+      "task": "Add real-time notifications with message history",
+      "fit": "perfect"
+    },
+    {
+      "task": "Build presence systems showing who is online",
+      "fit": "perfect"
+    },
+    {
+      "task": "Simple real-time notifications for a small app",
+      "fit": "good"
+    }
+  ],
+  "auth": {
+    "method": "api_key",
+    "setupSteps": [
+      "Sign up at ably.com",
+      "Create an app in the Ably dashboard",
+      "Go to the API Keys section of your app",
+      "Copy the default API key (or create a new scoped key)",
+      "Set ABLY_API_KEY environment variable"
+    ],
+    "envVarName": "ABLY_API_KEY",
+    "codeSnippet": "import Ably from 'ably';\nconst client = new Ably.Realtime({ key: process.env.ABLY_API_KEY! });"
+  },
+  "pricing": {
+    "model": "freemium",
+    "freeTier": "200 concurrent connections, 6M messages/month",
+    "startingPrice": "$29/month for 500 connections, 30M messages/month",
+    "costPer": "Overage: $2.50 per million additional messages",
+    "pricingUrl": "https://ably.com/pricing"
+  },
+  "rateLimits": {
+    "tier": "free tier",
+    "limit": "200 concurrent connections, 6M messages/month",
+    "notes": "Ably enforces rate limits per channel and per connection. Message size limit is 64KB. History retention varies by plan.",
+    "retryStrategy": "Ably SDK handles reconnection and message continuity automatically. It resumes subscriptions after reconnection and can replay missed messages from history."
+  },
+  "sdk": {
+    "primaryLanguage": "typescript",
+    "installCommand": "npm install --save-exact ably",
+    "importStatement": "import Ably from 'ably';",
+    "otherLanguages": ["python", "java", "ruby", "php", "go", "swift", "android", "dotnet"]
+  },
+  "codeExamples": [
+    {
+      "title": "Publish and subscribe to a channel",
+      "language": "typescript",
+      "code": "import Ably from 'ably';\n\nconst client = new Ably.Realtime({ key: process.env.ABLY_API_KEY! });\n\n// Subscribe to a channel\nconst channel = client.channels.get('live-scores');\n\nawait channel.subscribe('score-update', (message) => {\n  const data = message.data as { team: string; score: number };\n  console.log(`${data.team}: ${data.score}`);\n});\n\n// Publish an event\nawait channel.publish('score-update', {\n  team: 'Team A',\n  score: 3,\n});\n\nconsole.log('Subscribed and published');",
+      "notes": "Ably channels are created on first use. The same API key can be used for both publishing and subscribing. For production, use token authentication instead of API keys in client code."
+    },
+    {
+      "title": "Retrieve message history",
+      "language": "typescript",
+      "code": "import Ably from 'ably';\n\nconst client = new Ably.Realtime({ key: process.env.ABLY_API_KEY! });\nconst channel = client.channels.get('live-scores');\n\n// Get last 50 messages from history\nconst historyPage = await channel.history({ limit: 50 });\n\nfor (const message of historyPage.items) {\n  console.log(`[${message.timestamp}] ${message.name}:`, message.data);\n}\n\n// Check if there are more pages\nif (historyPage.hasNext()) {\n  const nextPage = await historyPage.next();\n  console.log('More messages:', nextPage?.items.length);\n}",
+      "notes": "Message history retention depends on your plan. Free tier retains 2 minutes; paid plans can retain up to 72 hours. History is key for catching up after reconnection."
+    }
+  ],
+  "gotchas": [
+    "Never embed API keys in client-side code for production apps. API keys have full publish/subscribe permissions. Use Ably Token Authentication: your server generates short-lived tokens that the client uses instead.",
+    "Message ordering is guaranteed per channel, but only within a single connection. If you have multiple publishers, messages may interleave. Use sequence numbers or vector clocks if strict ordering across publishers matters.",
+    "Ably's free tier (6M messages/month) sounds generous but a busy real-time app can exhaust this quickly. 1 user checking a live feed every 5 seconds = ~500k messages/month.",
+    "Connection state changes (connected, disconnected, suspended) must be handled explicitly. The SDK emits state change events — listen to them and update your UI accordingly."
+  ],
+  "reliability": {
+    "uptimeGuarantee": "99.999% uptime SLA",
+    "statusPageUrl": "https://status.ably.com",
+    "notes": "Ably provides global message ordering guarantees and exactly-once delivery semantics. Built for financial and mission-critical workloads. 15+ global data centers."
+  },
+  "qualityScore": 8,
+  "qualityJustification": "The most feature-complete real-time messaging platform with genuine delivery guarantees and message history. More complex than Pusher but offers stronger reliability primitives. Excellent TypeScript SDK. Free tier is the most generous in the category. Slightly higher complexity ceiling than Pusher.",
+  "alternatives": ["pusher", "stream-chat"],
+  "complementary": ["supabase", "clerk", "stream-chat"],
+  "bestFor": "Mission-critical real-time messaging with guaranteed delivery, message history, and presence — where dropped messages are unacceptable",
+  "lastVerified": "2026-02-25",
+  "entryVersion": 1,
+  "addedBy": "claude-code-session-2"
+}

package/src/entries/messaging/pusher.json

@@ -0,0 +1,94 @@
+{
+  "name": "Pusher Channels",
+  "slug": "pusher",
+  "category": "messaging",
+  "subcategory": "realtime-websockets",
+  "website": "https://pusher.com/channels",
+  "description": "Pusher Channels is a hosted WebSocket service that enables real-time bidirectional communication between servers and clients. It abstracts away WebSocket infrastructure complexity, making it trivial to add live updates, notifications, collaborative features, and real-time dashboards to any web or mobile application.",
+  "useCases": [
+    {
+      "task": "Add real-time notifications to a web application",
+      "fit": "perfect"
+    },
+    {
+      "task": "Build a live chat feature in a web app",
+      "fit": "perfect"
+    },
+    {
+      "task": "Push live dashboard updates without polling",
+      "fit": "perfect"
+    },
+    {
+      "task": "Add collaborative editing or presence indicators",
+      "fit": "good"
+    },
+    {
+      "task": "Full-featured chat application with history",
+      "fit": "partial"
+    }
+  ],
+  "auth": {
+    "method": "api_key",
+    "setupSteps": [
+      "Sign up at pusher.com",
+      "Create a new Channels app in the dashboard",
+      "Select your cluster (region closest to your users)",
+      "Copy App ID, Key, Secret, and Cluster from the app's API Keys tab",
+      "Set PUSHER_APP_ID, PUSHER_KEY, PUSHER_SECRET, PUSHER_CLUSTER environment variables"
+    ],
+    "envVarName": "PUSHER_SECRET",
+    "codeSnippet": "import Pusher from 'pusher';\nconst pusher = new Pusher({\n  appId: process.env.PUSHER_APP_ID!,\n  key: process.env.PUSHER_KEY!,\n  secret: process.env.PUSHER_SECRET!,\n  cluster: process.env.PUSHER_CLUSTER!,\n  useTLS: true,\n});"
+  },
+  "pricing": {
+    "model": "freemium",
+    "freeTier": "200 max connections, 200k messages/day, unlimited channels",
+    "startingPrice": "$49/month for 500 connections, 3M messages/day",
+    "costPer": "Varies by plan; no per-message charge within plan limits",
+    "pricingUrl": "https://pusher.com/channels/pricing"
+  },
+  "rateLimits": {
+    "tier": "free tier",
+    "limit": "200 concurrent connections, 200,000 messages/day, 100 channels per connection",
+    "notes": "Message size limit is 10KB. Exceeding limits causes messages to be dropped. Monitor usage in the dashboard.",
+    "retryStrategy": "Pusher client SDK handles reconnection automatically with exponential backoff. Server-side publishing failures should be retried with backoff."
+  },
+  "sdk": {
+    "primaryLanguage": "typescript",
+    "installCommand": "npm install --save-exact pusher pusher-js",
+    "importStatement": "import Pusher from 'pusher'; // Server\nimport PusherClient from 'pusher-js'; // Client (browser)",
+    "otherLanguages": ["python", "ruby", "php", "java", "go", "swift", "android"]
+  },
+  "codeExamples": [
+    {
+      "title": "Trigger an event from the server",
+      "language": "typescript",
+      "code": "// Server-side: trigger an event\nimport Pusher from 'pusher';\n\nconst pusher = new Pusher({\n  appId: process.env.PUSHER_APP_ID!,\n  key: process.env.PUSHER_KEY!,\n  secret: process.env.PUSHER_SECRET!,\n  cluster: process.env.PUSHER_CLUSTER!,\n  useTLS: true,\n});\n\n// Trigger 'new-order' event on 'orders' channel\nawait pusher.trigger('orders', 'new-order', {\n  orderId: 'order_123',\n  customerName: 'Jane Smith',\n  amount: 49.99,\n});\n\nconsole.log('Event triggered');",
+      "notes": "Channel names can be anything. Event names are arbitrary strings. Both server and client must use the same channel name and event name."
+    },
+    {
+      "title": "Subscribe and receive events in the browser",
+      "language": "typescript",
+      "code": "// Client-side (browser/React)\nimport PusherClient from 'pusher-js';\n\nconst pusher = new PusherClient(process.env.NEXT_PUBLIC_PUSHER_KEY!, {\n  cluster: process.env.NEXT_PUBLIC_PUSHER_CLUSTER!,\n});\n\nconst channel = pusher.subscribe('orders');\n\nchannel.bind('new-order', (data: { orderId: string; customerName: string; amount: number }) => {\n  console.log('New order received:', data);\n  // Update UI in real-time\n});\n\n// Clean up on component unmount\nreturn () => {\n  channel.unbind_all();\n  pusher.unsubscribe('orders');\n};",
+      "notes": "Use NEXT_PUBLIC_ prefix for Pusher Key and Cluster in Next.js (they're safe to expose client-side). Never expose your Pusher Secret in the browser."
+    }
+  ],
+  "gotchas": [
+    "The Pusher Key (public) is safe to expose in the browser, but the Pusher Secret must stay server-side only. A common mistake is exposing the Secret in Next.js client components via NEXT_PUBLIC_ env vars.",
+    "Message size is limited to 10KB. If you need to send large payloads (e.g., full documents), send an event with a reference ID and have the client fetch the full data from your API.",
+    "Pusher does not persist messages. If a client is disconnected when a message is triggered, they miss it. For guaranteed delivery, implement a separate persistence layer (database) and allow clients to catch up on reconnection.",
+    "The free tier's 200 concurrent connection limit is per-app, not per-user. A single user with multiple browser tabs counts as multiple connections."
+  ],
+  "reliability": {
+    "uptimeGuarantee": "99.999% uptime SLA on paid plans",
+    "statusPageUrl": "https://status.pusher.com",
+    "notes": "Pusher has multiple global clusters (us-east, eu-west, ap-southeast, etc.). Choose the cluster nearest to your users for lowest latency."
+  },
+  "qualityScore": 8,
+  "qualityJustification": "Best-in-class ease of use for real-time WebSocket messaging. Setup takes minutes, documentation is excellent, and the free tier is generous for prototyping. Primary limitation is lack of message persistence. For full-featured chat, Stream or Ably may be better choices.",
+  "alternatives": ["ably"],
+  "complementary": ["supabase", "clerk", "resend"],
+  "bestFor": "Adding real-time events and live updates to web apps without managing WebSocket infrastructure",
+  "lastVerified": "2026-02-25",
+  "entryVersion": 1,
+  "addedBy": "claude-code-session-2"
+}

package/src/entries/messaging/twilio.json

@@ -0,0 +1,94 @@
+{
+  "name": "Twilio",
+  "slug": "twilio",
+  "category": "messaging",
+  "subcategory": "sms-voice-whatsapp",
+  "website": "https://www.twilio.com",
+  "description": "Twilio is the leading cloud communications platform, providing APIs for SMS, voice calls, WhatsApp, email (via SendGrid), and video. It is the industry standard for programmatic communications and powers messaging features for millions of applications worldwide.",
+  "useCases": [
+    {
+      "task": "Send SMS notifications and alerts to users",
+      "fit": "perfect"
+    },
+    {
+      "task": "Implement two-factor authentication via SMS",
+      "fit": "perfect"
+    },
+    {
+      "task": "Send WhatsApp messages programmatically",
+      "fit": "perfect"
+    },
+    {
+      "task": "Build voice call systems and IVR menus",
+      "fit": "perfect"
+    },
+    {
+      "task": "Send transactional emails",
+      "fit": "partial"
+    }
+  ],
+  "auth": {
+    "method": "basic_auth",
+    "setupSteps": [
+      "Sign up at twilio.com",
+      "Verify your phone number",
+      "Go to the Console Dashboard to find your Account SID and Auth Token",
+      "Purchase a phone number from the Twilio Console (required for sending SMS)",
+      "Set TWILIO_ACCOUNT_SID, TWILIO_AUTH_TOKEN, and TWILIO_PHONE_NUMBER environment variables"
+    ],
+    "envVarName": "TWILIO_AUTH_TOKEN",
+    "codeSnippet": "import twilio from 'twilio';\nconst client = twilio(process.env.TWILIO_ACCOUNT_SID!, process.env.TWILIO_AUTH_TOKEN!);"
+  },
+  "pricing": {
+    "model": "usage_based",
+    "freeTier": "Free trial with $15 credit (unverified numbers only)",
+    "startingPrice": "$0.0079 per SMS (US); phone number $1.15/month",
+    "costPer": "$0.0079/SMS outbound (US); $0.0085 inbound; voice $0.014/min",
+    "pricingUrl": "https://www.twilio.com/en-us/sms/pricing/us"
+  },
+  "rateLimits": {
+    "tier": "default",
+    "limit": "1 SMS/second per long code number; 100 SMS/second with short codes",
+    "notes": "Long code numbers (regular phone numbers) are rate-limited. For high-volume campaigns, use short codes or Twilio Messaging Services with multiple numbers.",
+    "retryStrategy": "Use Twilio Messaging Services for automatic throughput scaling; implement exponential backoff for 429 responses"
+  },
+  "sdk": {
+    "primaryLanguage": "typescript",
+    "installCommand": "npm install --save-exact twilio",
+    "importStatement": "import twilio from 'twilio';",
+    "otherLanguages": ["python", "java", "ruby", "php", "csharp", "go"]
+  },
+  "codeExamples": [
+    {
+      "title": "Send an SMS",
+      "language": "typescript",
+      "code": "import twilio from 'twilio';\n\nconst client = twilio(\n  process.env.TWILIO_ACCOUNT_SID!,\n  process.env.TWILIO_AUTH_TOKEN!\n);\n\nconst message = await client.messages.create({\n  body: 'Your verification code is: 847291',\n  from: process.env.TWILIO_PHONE_NUMBER!, // Your Twilio number\n  to: '+14155551234', // Recipient number (E.164 format)\n});\n\nconsole.log('Message SID:', message.sid);\nconsole.log('Status:', message.status);",
+      "notes": "Phone numbers must be in E.164 format (+[country code][number]). During trial, you can only send to verified phone numbers."
+    },
+    {
+      "title": "Send a WhatsApp message",
+      "language": "typescript",
+      "code": "import twilio from 'twilio';\n\nconst client = twilio(\n  process.env.TWILIO_ACCOUNT_SID!,\n  process.env.TWILIO_AUTH_TOKEN!\n);\n\nconst message = await client.messages.create({\n  body: 'Hello from WhatsApp! Your order #1234 has shipped.',\n  from: 'whatsapp:+14155238886', // Twilio WhatsApp sandbox number\n  to: 'whatsapp:+14155551234',\n});\n\nconsole.log('WhatsApp message SID:', message.sid);",
+      "notes": "Use the Twilio Sandbox for WhatsApp during development. For production, submit a WhatsApp Business Application through Twilio. Recipients must opt-in first for business-initiated messages."
+    }
+  ],
+  "gotchas": [
+    "Trial accounts can only send SMS/calls to verified phone numbers. You must verify each recipient's number in the console before testing — this trips up every developer during initial setup.",
+    "US long-code numbers require A2P 10DLC registration for application-to-person messaging. Without registration, messages may be filtered or blocked by carriers. This process takes 1-2 weeks.",
+    "WhatsApp business-initiated messages require pre-approved message templates. You cannot send free-form messages to users who haven't messaged you in the last 24 hours.",
+    "Twilio costs add up quickly at scale. SMS prices vary significantly by country. Always calculate your expected monthly cost before committing."
+  ],
+  "reliability": {
+    "uptimeGuarantee": "99.95% uptime SLA",
+    "statusPageUrl": "https://status.twilio.com",
+    "notes": "Twilio has global carrier relationships for high deliverability. They provide delivery receipts and status webhooks for every message."
+  },
+  "qualityScore": 9,
+  "qualityJustification": "The gold standard for programmatic communications. Excellent TypeScript SDK, comprehensive documentation, and unmatched feature breadth (SMS, voice, WhatsApp, video). The regulatory requirements (10DLC, WhatsApp templates) are industry-wide, not Twilio-specific. Slight deduction for pricing complexity.",
+  "alternatives": ["vonage"],
+  "complementary": ["resend", "stripe", "clerk"],
+  "bestFor": "Programmatic SMS, voice, and WhatsApp messaging with global carrier reach and the most mature communications API",
+  "lastVerified": "2026-02-25",
+  "entryVersion": 1,
+  "addedBy": "claude-code-session-2"
+}