{"_id":"lumbox","_rev":"2-d26b5ae12fc065384f8c6610b8acc51e","name":"lumbox","dist-tags":{"latest":"0.3.1"},"versions":{"0.3.0":{"name":"lumbox","version":"0.3.0","keywords":["email","ai","agents","otp","mcp","lumbox","verification"],"author":{"name":"Lumbox","email":"hello@lumbox.co"},"license":"MIT","_id":"lumbox@0.3.0","maintainers":[{"name":"kumardeepanshu","email":"kumardeepanshu157200@gmail.com"}],"homepage":"https://lumbox.co","bugs":{"url":"https://github.com/kumard3/Lumbox/issues"},"bin":{"lumbox":"dist/cli.js"},"dist":{"shasum":"6a1b245ce2f19dc1fcc5d5c08b210836a6ee3591","tarball":"https://registry.npmjs.org/lumbox/-/lumbox-0.3.0.tgz","fileCount":14,"integrity":"sha512-TO9eryY6dZo0fuQPDV9CfKWni0RwA/puLnYRYZNPPJVO2VdwcaZZaubiAZbgmi6drgx9dlZ0jfGJpWTTgrtRxA==","signatures":[{"sig":"MEYCIQCO9oaueQ4gF8PWzraAN7LzoncHk0mRHp3QXux10M4kNQIhAIk0haxNwvrDF7Q5WUw7pkMCtV8qQgGvFQpZQtMOzpWF","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":587736},"main":"dist/index.js","types":"dist/index.d.ts","module":"dist/index.mjs","engines":{"node":">=18.0.0"},"exports":{".":{"import":{"types":"./dist/index.d.mts","default":"./dist/index.mjs"},"require":{"types":"./dist/index.d.ts","default":"./dist/index.js"}}},"scripts":{"dev":"tsup --watch","build":"tsup","typecheck":"tsc --noEmit","prepublishOnly":"tsup"},"_npmUser":{"name":"kumardeepanshu","email":"kumardeepanshu157200@gmail.com"},"repository":{"url":"git+https://github.com/kumard3/Lumbox.git","type":"git"},"_npmVersion":"11.12.1","description":"Lumbox SDK — Email for AI agents. Create inboxes, receive OTPs, send replies.","directories":{},"sideEffects":false,"_nodeVersion":"24.15.0","dependencies":{},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.1","typescript":"^5.7.0","@types/node":"^25.3.0"},"_npmOperationalInternal":{"tmp":"tmp/lumbox_0.3.0_1781288100400_0.9722956362741773","host":"s3://npm-registry-packages-npm-production"}},"0.3.1":{"name":"lumbox","version":"0.3.1","description":"Lumbox SDK and CLI for AI agents: create email inboxes, receive OTPs, and send replies from TypeScript, Node, or the `lumbox` command line.","main":"dist/index.js","module":"dist/index.mjs","types":"dist/index.d.ts","exports":{".":{"import":{"types":"./dist/index.d.mts","default":"./dist/index.mjs"},"require":{"types":"./dist/index.d.ts","default":"./dist/index.js"}}},"bin":{"lumbox":"dist/cli.js"},"sideEffects":false,"engines":{"node":">=18.0.0"},"scripts":{"build":"tsup","dev":"tsup --watch","typecheck":"tsc --noEmit","prepublishOnly":"tsup"},"keywords":["email","ai","agents","otp","mcp","lumbox","verification","cli","command-line","lumbox-cli","email-cli"],"license":"MIT","author":{"name":"Lumbox","email":"hello@lumbox.co"},"bugs":{"url":"https://github.com/kumard3/Lumbox/issues"},"repository":{"type":"git","url":"git+https://github.com/kumard3/Lumbox.git"},"homepage":"https://lumbox.co","dependencies":{},"devDependencies":{"@types/node":"^25.3.0","tsup":"^8.5.1","typescript":"^5.7.0"},"gitHead":"5ab9b0de2fa12e1fa9d01f7c0c6cb3792a2fd5e1","_id":"lumbox@0.3.1","_nodeVersion":"24.15.0","_npmVersion":"11.12.1","dist":{"integrity":"sha512-DLbfKLFaU6esC/csm55twdcuPSh8PdC6T2A9nFnfmWdDJIHgMRkxvbu+SzhDpungTgm9hY306fnW/iv17I6zQw==","shasum":"00301e5b071bffbeaaf4fad5cb7958d5a3045a4c","tarball":"https://registry.npmjs.org/lumbox/-/lumbox-0.3.1.tgz","fileCount":14,"unpackedSize":587963,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCICdVyR9aPASuUEXnO/4e9WBM5j6lMhmBvzbuR0+aCKyAAiBI+cdqNNJHrOWS7i3cKfYDUUvh9weo+AldlzBFv+hrXQ=="}]},"_npmUser":{"name":"kumardeepanshu","email":"kumardeepanshu157200@gmail.com"},"directories":{},"maintainers":[{"name":"kumardeepanshu","email":"kumardeepanshu157200@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/lumbox_0.3.1_1781884648833_0.9373513305883816"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-12T18:15:00.247Z","modified":"2026-06-19T15:57:29.137Z","0.3.0":"2026-06-12T18:15:00.530Z","0.3.1":"2026-06-19T15:57:29.033Z"},"bugs":{"url":"https://github.com/kumard3/Lumbox/issues"},"author":{"name":"Lumbox","email":"hello@lumbox.co"},"license":"MIT","homepage":"https://lumbox.co","keywords":["email","ai","agents","otp","mcp","lumbox","verification","cli","command-line","lumbox-cli","email-cli"],"repository":{"type":"git","url":"git+https://github.com/kumard3/Lumbox.git"},"description":"Lumbox SDK and CLI for AI agents: create email inboxes, receive OTPs, and send replies from TypeScript, Node, or the `lumbox` command line.","maintainers":[{"name":"kumardeepanshu","email":"kumardeepanshu157200@gmail.com"}],"readme":"# lumbox\n\nEmail for AI agents. Create inboxes, receive OTPs, extract verification codes — all via API.\n\n## Install\n\n```bash\nnpm install lumbox\n```\n\n## Quick Start\n\n```typescript\nimport { Lumbox } from \"lumbox\";\n\nconst client = new Lumbox({ apiKey: \"ak_...\" });\n\n// Create an inbox\nconst inbox = await client.createInbox({ name: \"github-bot\" });\n// → github-bot@lumbox.co\n\n// Sign up on any service with inbox.address...\n\n// Wait for the OTP (blocks until it arrives)\nconst otp = await inbox.waitForOtp({ timeout: 60_000 });\nconsole.log(otp.code); // \"847291\"\n```\n\n## Auth header\n\nThe SDK sends `Authorization: Bearer ak_...` by default. The legacy\n`X-API-Key` header still works server-side. Raw HTTP example:\n\n```bash\ncurl https://api.lumbox.co/v1/inboxes \\\n  -H \"Authorization: Bearer ak_your_key_here\"\n```\n\n## Inbox-scoped API keys\n\nMint a key that can only ever touch one inbox:\n\n```typescript\nconst created = await client.inboxes.apiKeys.create(inbox.id, { name: \"ci-bot\" });\nconsole.log(created.api_key); // shown once\n\nawait client.inboxes.apiKeys.list(inbox.id);\nawait client.inboxes.apiKeys.delete(inbox.id, created.id);\n```\n\n## Features\n\n- **OTP extraction** — verification codes parsed automatically\n- **Long-poll** — `waitForEmail()` and `waitForOtp()` block until arrival\n- **Send/reply/forward** — full outbound email support\n- **Custom domains** — DKIM, SPF, DMARC verification\n- **Zero dependencies** — uses native `fetch`\n\n## API\n\n### `new Lumbox({ apiKey, baseUrl? })`\n\nCreate a client. `baseUrl` defaults to `https://api.lumbox.co`.\n\n### `client.createInbox({ name?, domain? })`\n\nReturns an `Inbox` object with `.address`, `.id`, and convenience methods.\n\n### `inbox.waitForOtp({ timeout?, from? })`\n\nBlocks until an email with an OTP arrives. Returns `{ code, email_id, from, subject }`.\n\n### `inbox.waitForEmail({ timeout?, from?, subject? })`\n\nBlocks until any email arrives.\n\n### `inbox.listEmails()`\n\nList all emails in the inbox.\n\n### `client.addDomain(domain)`\n\nAdd a custom domain. Returns DNS records to configure.\n\nFull API docs: [docs.lumbox.co](https://docs.lumbox.co)\n\n## License\n\nMIT\n","readmeFilename":"README.md"}