{"_id":"@artamail/nextjs","_rev":"2-4b37a4053e0f7bd4626fc5438c4f9425","name":"@artamail/nextjs","dist-tags":{"latest":"0.1.1"},"versions":{"0.1.0":{"name":"@artamail/nextjs","version":"0.1.0","keywords":["email","nextjs","artamail","transactional"],"author":{"name":"Artatol"},"license":"MIT","_id":"@artamail/nextjs@0.1.0","maintainers":[{"name":"charouzek-artatol","email":"martin.charouzek@artatol.com"}],"homepage":"https://artamail.artatol.com/docs","bugs":{"url":"https://github.com/artatol/artamail/issues"},"dist":{"shasum":"1c38e34038096efeb10420b6fd02a102501f5a56","tarball":"https://registry.npmjs.org/@artamail/nextjs/-/nextjs-0.1.0.tgz","fileCount":16,"integrity":"sha512-rKogyWQPwWjMo+gLIqBC9GFY2SpGhLnPQas0rnCvqA+1XABskKpoCh1FQa9OQk/CzLGMctjnHkFgt+mW9rif/g==","signatures":[{"sig":"MEQCICibMzHrZbZPRdUgM4H8vBCYc3SR1esru9xRoLGaUKsfAiAQg//NpGjsCS6BMXniEfUaKEIwZEsoS599sVaRxzgitw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":43724},"main":"./dist/index.js","type":"module","_from":"file:artamail-nextjs-0.1.0.tgz","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"},"./server":{"types":"./dist/server.d.ts","import":"./dist/server.js","require":"./dist/server.cjs"}},"scripts":{"dev":"tsup --watch","build":"tsup","clean":"rm -rf dist","typecheck":"tsc --noEmit"},"_npmUser":{"name":"charouzek-artatol","email":"martin.charouzek@artatol.com"},"_resolved":"/private/var/folders/9x/wfkj1l0j56z0lywbzrkgrvs80000gn/T/f1cf10d7af3192ec1278916c6d692f62/artamail-nextjs-0.1.0.tgz","_integrity":"sha512-rKogyWQPwWjMo+gLIqBC9GFY2SpGhLnPQas0rnCvqA+1XABskKpoCh1FQa9OQk/CzLGMctjnHkFgt+mW9rif/g==","repository":{"url":"git+https://github.com/artatol/artamail.git","type":"git"},"_npmVersion":"10.8.2","description":"ArtaMail SDK integration for Next.js applications","directories":{},"_nodeVersion":"20.19.5","dependencies":{"@artamail/sdk":"0.1.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"next":"^14.0.0","tsup":"^8.0.0","typescript":"^5.0.0","@types/node":"^20.0.0"},"peerDependencies":{"next":">=13.0.0"},"_npmOperationalInternal":{"tmp":"tmp/nextjs_0.1.0_1764632902624_0.07257420427384087","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@artamail/nextjs","version":"0.1.1","description":"ArtaMail SDK integration for Next.js applications","type":"module","main":"./dist/index.js","module":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"},"./server":{"types":"./dist/server.d.ts","import":"./dist/server.js","require":"./dist/server.cjs"}},"keywords":["email","nextjs","artamail","transactional"],"author":{"name":"Artatol"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/artatol/artamail.git"},"homepage":"https://artamail.artatol.net/docs","bugs":{"url":"https://github.com/artatol/artamail/issues"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"peerDependencies":{"next":">=13.0.0"},"dependencies":{"@artamail/sdk":"0.1.1"},"devDependencies":{"@types/node":"^20.0.0","next":"^14.0.0","tsup":"^8.0.0","typescript":"^5.0.0"},"engines":{"node":">=18.0.0"},"scripts":{"build":"tsup","dev":"tsup --watch","typecheck":"tsc --noEmit","clean":"rm -rf dist"},"_id":"@artamail/nextjs@0.1.1","_integrity":"sha512-fENLijGoRXcjGtcOuigMXBy+jjYdz9rB0HukN7TjYRl2iWHchuaCUdmHjuivISjyE6uIZb+9LdY1cECegrR/1Q==","_resolved":"/private/var/folders/9x/wfkj1l0j56z0lywbzrkgrvs80000gn/T/ef7cda8d495876cc446d584910be5ad1/artamail-nextjs-0.1.1.tgz","_from":"file:artamail-nextjs-0.1.1.tgz","_nodeVersion":"20.19.5","_npmVersion":"10.8.2","dist":{"integrity":"sha512-fENLijGoRXcjGtcOuigMXBy+jjYdz9rB0HukN7TjYRl2iWHchuaCUdmHjuivISjyE6uIZb+9LdY1cECegrR/1Q==","shasum":"9e346ede8f5b7096c6c04b7d026cfa16f63519c2","tarball":"https://registry.npmjs.org/@artamail/nextjs/-/nextjs-0.1.1.tgz","fileCount":16,"unpackedSize":43724,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIGFn5rd7P+wYggOSHD/01BDCQoMPDG8/MGhLAuv9odQkAiEA8NwPYF03X+wbGF14DL0wztzJtOzl/oFVwpVhJs12zx8="}]},"_npmUser":{"name":"charouzek-artatol","email":"martin.charouzek@artatol.com"},"directories":{},"maintainers":[{"name":"charouzek-artatol","email":"martin.charouzek@artatol.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/nextjs_0.1.1_1765128282865_0.874605054050392"},"_hasShrinkwrap":false}},"time":{"created":"2025-12-01T23:48:22.499Z","modified":"2025-12-07T17:24:43.241Z","0.1.0":"2025-12-01T23:48:22.837Z","0.1.1":"2025-12-07T17:24:43.026Z"},"bugs":{"url":"https://github.com/artatol/artamail/issues"},"author":{"name":"Artatol"},"license":"MIT","homepage":"https://artamail.artatol.net/docs","keywords":["email","nextjs","artamail","transactional"],"repository":{"type":"git","url":"git+https://github.com/artatol/artamail.git"},"description":"ArtaMail SDK integration for Next.js applications","maintainers":[{"name":"charouzek-artatol","email":"martin.charouzek@artatol.com"}],"readme":"# @artamail/nextjs\n\nArtaMail SDK integration for Next.js applications. Provides server-side helpers for sending transactional emails.\n\n## Installation\n\n```bash\npnpm add @artamail/nextjs\n# or\nnpm install @artamail/nextjs\n```\n\n## Setup\n\nAdd your API key to `.env.local`:\n\n```env\nARTAMAIL_API_KEY=am_live_sk_xxx\n```\n\n## Usage\n\n### In Server Components\n\n```tsx\nimport { getArtaMail } from '@artamail/nextjs/server';\n\nexport default async function EmailsPage() {\n  const artamail = getArtaMail();\n  const templates = await artamail.listTemplates();\n\n  return (\n    <ul>\n      {templates.map(t => (\n        <li key={t.id}>{t.name}</li>\n      ))}\n    </ul>\n  );\n}\n```\n\n### In Server Actions\n\n```tsx\n'use server'\n\nimport { sendEmail } from '@artamail/nextjs/server';\n\nexport async function sendWelcomeEmail(formData: FormData) {\n  const email = formData.get('email') as string;\n  const name = formData.get('name') as string;\n\n  const result = await sendEmail({\n    to: email,\n    template: 'welcome',\n    data: { name }\n  });\n\n  return { success: true, emailId: result.id };\n}\n```\n\n### In API Routes\n\n```ts\n// app/api/send-email/route.ts\nimport { getArtaMail } from '@artamail/nextjs/server';\nimport { NextResponse } from 'next/server';\n\nexport async function POST(request: Request) {\n  const { to, template, data } = await request.json();\n\n  const artamail = getArtaMail();\n  const result = await artamail.send({ to, template, data });\n\n  return NextResponse.json(result);\n}\n```\n\n## API Reference\n\n### `getArtaMail(config?)`\n\nGet or create a singleton ArtaMail client instance.\n\n```ts\nimport { getArtaMail } from '@artamail/nextjs/server';\n\nconst artamail = getArtaMail();\n// or with custom config\nconst artamail = getArtaMail({\n  apiKey: 'am_live_sk_xxx', // Optional, defaults to ARTAMAIL_API_KEY\n  timeout: 60000,\n});\n```\n\n### `createArtaMail(config?)`\n\nCreate a new (non-singleton) client instance.\n\n```ts\nimport { createArtaMail } from '@artamail/nextjs/server';\n\nconst liveClient = createArtaMail({ apiKey: 'am_live_sk_xxx' });\nconst testClient = createArtaMail({ apiKey: 'am_test_sk_xxx' });\n```\n\n### `sendEmail(options)`\n\nSend an email directly (convenience function).\n\n```ts\nimport { sendEmail } from '@artamail/nextjs/server';\n\nawait sendEmail({\n  to: 'user@example.com',\n  template: 'welcome',\n  data: { name: 'John' }\n});\n```\n\n### `sendBatchEmails(options)`\n\nSend multiple emails in a batch.\n\n```ts\nimport { sendBatchEmails } from '@artamail/nextjs/server';\n\nconst result = await sendBatchEmails({\n  emails: [\n    { to: 'user1@example.com', template: 'notification', data: { ... } },\n    { to: 'user2@example.com', template: 'notification', data: { ... } },\n  ]\n});\n```\n\n## Error Handling\n\n```ts\nimport {\n  sendEmail,\n  ValidationError,\n  AuthenticationError,\n  RateLimitError\n} from '@artamail/nextjs/server';\n\ntry {\n  await sendEmail({ ... });\n} catch (error) {\n  if (error instanceof ValidationError) {\n    // Invalid input\n  } else if (error instanceof AuthenticationError) {\n    // Invalid API key\n  } else if (error instanceof RateLimitError) {\n    // Rate limited\n  }\n}\n```\n\n## TypeScript\n\nFull TypeScript support with exported types:\n\n```ts\nimport type {\n  SendEmailOptions,\n  SendEmailResult,\n  Template\n} from '@artamail/nextjs/server';\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md"}