\n\n**Pre-built solutions to track usage and automate billing for your SaaS.** Track LLM tokens, API calls, storage uploads, streaming bandwidth, and compute time with just a few lines of code.\n\n## Available Blueprints\n\n- **[LLM Tracking](#llm-blueprint)** - Automatic token usage tracking for OpenAI, Anthropic, Groq, AI SDK, and more\n- **[API Gateway](#api-gateway-blueprint)** - Track API calls and implement usage-based API billing\n- **[Object Storage](#object-storage-blueprint)** - Monitor file uploads to S3, GCS, Azure Blob, and other storage services\n- **[Stream](#stream-blueprint)** - Track streaming data consumption for video, audio, and live streams\n- **[Time Range](#time-range-blueprint)** - Bill based on compute time for serverless functions, containers, and VMs\n\n---\n\n## LLM Blueprint\n\nTrack LLM token usage automatically for usage-based billing. Works with OpenAI, Anthropic, Groq, AI SDK, Google Gemini, and OpenRouter.\n\nš **[Full Documentation](https://docs.dodopayments.com/developer-resources/ingestion-blueprints/llm)**\n\n### Example\n```javascript\nimport { createLLMTracker } from '@dodopayments/ingestion-blueprints';\nimport { generateText } from 'ai';\nimport { google } from '@ai-sdk/google';\n\nconst llmTracker = createLLMTracker({\n apiKey: process.env.DODO_PAYMENTS_API_KEY,\n environment: 'test_mode',\n eventName: 'your_meter_event_name'\n});\n\nconst client = llmTracker.wrap({\n client: { generateText },\n customerId: 'customer_123'\n});\n\nconst response = await client.generateText({\n model: google('gemini-2.0-flash'),\n prompt: 'Hello!',\n maxOutputTokens: 500\n});\n\nconsole.log(response.text);\nconsole.log(response.usage);\n// ā Usage automatically tracked to Dodo Payments!\n```\n\n---\n\n## API Gateway Blueprint\n\nTrack API calls at the gateway level for usage-based API billing. Perfect for API-as-a-service platforms and multi-tenant SaaS.\n\nš **[Full Documentation](https://docs.dodopayments.com/developer-resources/ingestion-blueprints/api-gateway)**\n\n### Example\n```javascript\nimport { Ingestion, trackAPICall } from '@dodopayments/ingestion-blueprints';\n\nconst ingestion = new Ingestion({\n apiKey: process.env.DODO_PAYMENTS_API_KEY,\n environment: 'test_mode',\n eventName: 'api_call'\n});\n\n// Track an API call\nawait trackAPICall(ingestion, {\n customerId: 'customer_123',\n metadata: {\n endpoint: '/api/v1/users',\n method: 'GET',\n status_code: 200,\n response_time_ms: 45\n }\n});\n```\n\n---\n\n## Object Storage Blueprint\n\nTrack file uploads and storage usage for S3, Google Cloud Storage, Azure Blob, and other object storage services.\n\nš **[Full Documentation](https://docs.dodopayments.com/developer-resources/ingestion-blueprints/object-storage)**\n\n### Example\n```javascript\nimport { Ingestion, trackObjectStorage } from '@dodopayments/ingestion-blueprints';\n\nconst ingestion = new Ingestion({\n apiKey: process.env.DODO_PAYMENTS_API_KEY,\n environment: 'test_mode',\n eventName: 'object_storage_upload'\n});\n\n// Track S3 upload\nawait trackObjectStorage(ingestion, {\n customerId: 'customer_123',\n bytes: 1048576, // 1MB\n metadata: {\n bucket: 'my-bucket',\n key: 'uploads/document.pdf'\n }\n});\n```\n\n---\n\n## Stream Blueprint\n\nTrack streaming data consumption for video, audio, live streams, and real-time data transfer billing.\n\nš **[Full Documentation](https://docs.dodopayments.com/developer-resources/ingestion-blueprints/stream)**\n\n### Example\n```javascript\nimport { Ingestion, trackStreamBytes } from '@dodopayments/ingestion-blueprints';\n\nconst ingestion = new Ingestion({\n apiKey: process.env.DODO_PAYMENTS_API_KEY,\n environment: 'test_mode',\n eventName: 'stream_consumption'\n});\n\n// Track video streaming\nawait trackStreamBytes(ingestion, {\n customerId: 'customer_123',\n bytes: 10485760, // 10MB\n metadata: {\n stream_type: 'video'\n }\n});\n```\n\n---\n\n## Time Range Blueprint\n\nTrack resource consumption based on elapsed time for serverless functions, containers, VMs, and any time-based billing.\n\nš **[Full Documentation](https://docs.dodopayments.com/developer-resources/ingestion-blueprints/time-range)**\n\n### Example\n```javascript\nimport { Ingestion, trackTimeRange } from '@dodopayments/ingestion-blueprints';\n\nconst ingestion = new Ingestion({\n apiKey: process.env.DODO_PAYMENTS_API_KEY,\n environment: 'test_mode',\n eventName: 'function_execution'\n});\n\n// Track function execution time\nconst startTime = Date.now();\nawait yourBusinessLogic();\nconst durationMs = Date.now() - startTime;\n\nawait trackTimeRange(ingestion, {\n customerId: 'customer_123',\n durationMs: durationMs,\n metadata: {\n function_name: 'image-processor',\n memory_mb: 512\n }\n});\n```\n\n---\n\n## Try the Examples\n\nAll blueprints come with runnable examples you can try immediately.\n\n### Setup\n\n1. **Clone and install**:\n ```bash\n git clone https://github.com/dodopayments/ingestion-blueprints.git\n cd ingestion-blueprints\n npm install\n npm run build\n ```\n\n2. **Set up environment variables** in `examples/.env`:\n ```bash\n DODO_PAYMENTS_API_KEY=your_dodo_key_here\n OPENAI_API_KEY=your_openai_key_here\n ANTHROPIC_API_KEY=your_anthropic_key_here\n GROQ_API_KEY=your_groq_key_here\n GOOGLE_GENERATIVE_AI_API_KEY=your_google_key_here\n OPENROUTER_API_KEY=your_openrouter_api_key_here\n ```\n\n3. **Run examples**:\n ```bash\n cd examples\n npm install\n\n # LLM examples\n npx tsx ai-sdk-example.ts\n npx tsx openai-example.ts\n npx tsx anthropic-example.ts\n npx tsx groq-example.ts\n npx tsx google-genai-example.ts\n npx tsx openrouter-example.ts\n\n # Other blueprint examples\n npx tsx api-gateway-example.ts\n npx tsx object-storage-example.ts\n npx tsx stream-example.ts\n npx tsx time-range-example.ts\n ```\n\n---\n\n## Why Use Ingestion Blueprints?\n\n- **š Quick Integration** - Get started in minutes with pre-built solutions\n- **š Accurate Tracking** - Automatic usage capture with no manual logging\n- **š° Usage-Based Billing** - Convert usage directly into billing events\n- **š§ Flexible** - Track tokens, bytes, API calls, time, or custom metrics\n- **šÆ Production-Ready** - Battle-tested, TypeScript support, minimal overhead\n- **š Universal** - Works with a variety of popular providers\n\n**Perfect for:** SaaS platforms, AI applications, API services, streaming platforms, cloud compute billing.\n\n---\n\n## License\n\nThis project is licensed under the GNU General Public License v3.0 - see the [LICENSE](LICENSE) file for details.\n\n## Contributing\n\nContributions are welcome! Please read our [Contributing Guide](CONTRIBUTING.md) for details on our code of conduct and the process for submitting pull requests.\n\n## Security\n\nPlease report security vulnerabilities to security@dodopayments.com. See our [Security Policy](SECURITY.md) for more information.\n\n## Support\n\n- š§ Email: support@dodopayments.com\n- š¬ Discord: [Join our Discord](https://discord.gg/bYqAp4ayYh)\n- š Documentation: [Dodo Payments Docs](https://docs.dodopayments.com)","readmeFilename":"README.md"}
![\"Ingestion](\"./.github/cover.png\")
\n![\"npm](\"https://img.shields.io/npm/v/@dodopayments/ingestion-blueprints?color=cb3837&label=npm&logo=npm\")
\n ![\"Join](\"https://img.shields.io/discord/1305511580854779984?label=Join%20Discord&logo=discord\")
\n ![\"License:](\"https://img.shields.io/badge/license-GPLv3-blue.svg\"){kind=icon}
\n