{"_id":"@artatol/artamail-nuxt","_rev":"3-ea4a23ecb779d839693425a54f503fde","name":"@artatol/artamail-nuxt","dist-tags":{"latest":"0.3.1"},"versions":{"0.1.0":{"name":"@artatol/artamail-nuxt","version":"0.1.0","keywords":["email","nuxt","nuxt-module","nuxt3","artamail","artatol","transactional"],"author":{"url":"https://www.artatol.com","name":"Artatol"},"license":"MIT","_id":"@artatol/artamail-nuxt@0.1.0","maintainers":[{"name":"vdejl","email":"vlastimil.dejl@artatol.com"},{"name":"machar","email":"martin@charouzkovi.cz"}],"homepage":"https://artamail.artatol.net/docs","bugs":{"url":"https://gitlab.com/artatol/acp/artamail/-/issues"},"dist":{"shasum":"76b48b3727d0bd3a22be7134804959cbed2ac0c0","tarball":"https://registry.npmjs.org/@artatol/artamail-nuxt/-/artamail-nuxt-0.1.0.tgz","fileCount":8,"integrity":"sha512-calBvrrg8luBL4i9PIIqJ8hMGd2UCdkk1P8pNZPv59VJgC5YybIhtX0/xe0QwNv6q/szzFhbyVyjeVVRZNwlLg==","signatures":[{"sig":"MEQCICE9/f/q0nmqDr25thgvt0ujQ877ixm57vo2ePsXpPdoAiAE2mKqwdAYDT0GYla+JTOFu9B207uE9LgS/+2oVicaMg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":10445},"main":"./dist/module.mjs","type":"module","_from":"file:artatol-artamail-nuxt-0.1.0.tgz","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/module.d.mts","import":"./dist/module.mjs"}},"scripts":{"dev":"nuxt-module-build build --watch","build":"nuxt-module-build build","clean":"rm -rf dist","typecheck":"echo 'Nuxt module types are checked during build'"},"_npmUser":{"name":"vdejl","email":"vlastimil.dejl@artatol.com"},"_resolved":"/private/var/folders/8j/tsn7kjzn7g37432x6nbm5xtm0000gn/T/b31e64faaa021f44d48e00098cb2abe7/artatol-artamail-nuxt-0.1.0.tgz","_integrity":"sha512-calBvrrg8luBL4i9PIIqJ8hMGd2UCdkk1P8pNZPv59VJgC5YybIhtX0/xe0QwNv6q/szzFhbyVyjeVVRZNwlLg==","repository":{"url":"git+https://gitlab.com/artatol/acp/artamail.git","type":"git","directory":"packages/nuxt"},"_npmVersion":"11.8.0","description":"ArtaMail SDK module for Nuxt 3 applications","directories":{},"_nodeVersion":"24.13.1","dependencies":{"@nuxt/kit":"^3.0.0","@artatol/artamail-sdk":"0.1.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"nuxt":"^3.0.0","typescript":"^5.0.0","@types/node":"^20.0.0","@nuxt/module-builder":"^1.0.0"},"peerDependencies":{"nuxt":">=3.0.0"},"_npmOperationalInternal":{"tmp":"tmp/artamail-nuxt_0.1.0_1781621723529_0.42121027366739994","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@artatol/artamail-nuxt","version":"0.2.0","keywords":["email","nuxt","nuxt-module","nuxt3","artamail","artatol","transactional"],"author":{"url":"https://www.artatol.com","name":"Artatol"},"license":"MIT","_id":"@artatol/artamail-nuxt@0.2.0","maintainers":[{"name":"vdejl","email":"vlastimil.dejl@artatol.com"},{"name":"machar","email":"martin@charouzkovi.cz"}],"homepage":"https://artamail.artatol.net/docs","bugs":{"url":"https://gitlab.com/artatol/acp/artamail/-/issues"},"dist":{"shasum":"f0975284e97b2277346bd9ddb2a16675e11c5449","tarball":"https://registry.npmjs.org/@artatol/artamail-nuxt/-/artamail-nuxt-0.2.0.tgz","fileCount":8,"integrity":"sha512-aO/DOS+P8kH02Puea0sY3wjLioc3eW2PSOnQu3Nobwb0Jf+fGEfZRAyLecfRoQ7HhOsTZ3oHuYhkk/eNVcrsFg==","signatures":[{"sig":"MEUCIQC/zQBTUim72jayPOWxpHRFqGQricP22eS6QCzBaNflEAIgcj7vVb0fX4f/98aLup2tR3R9qlHxo6FlDKT/kzL4qQM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":10446},"main":"./dist/module.mjs","type":"module","_from":"file:artatol-artamail-nuxt-0.2.0.tgz","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/module.d.mts","import":"./dist/module.mjs"}},"scripts":{"dev":"nuxt-module-build build --watch","build":"nuxt-module-build build","clean":"rm -rf dist","typecheck":"echo 'Nuxt module types are checked during build'"},"_npmUser":{"name":"vdejl","email":"vlastimil.dejl@artatol.com"},"_resolved":"/private/var/folders/8j/tsn7kjzn7g37432x6nbm5xtm0000gn/T/185de65579df929608d95cb5c2cf1c73/artatol-artamail-nuxt-0.2.0.tgz","_integrity":"sha512-aO/DOS+P8kH02Puea0sY3wjLioc3eW2PSOnQu3Nobwb0Jf+fGEfZRAyLecfRoQ7HhOsTZ3oHuYhkk/eNVcrsFg==","repository":{"url":"git+https://gitlab.com/artatol/acp/artamail.git","type":"git","directory":"packages/nuxt"},"_npmVersion":"11.8.0","description":"ArtaMail SDK module for Nuxt 3 applications","directories":{},"_nodeVersion":"24.13.1","dependencies":{"@nuxt/kit":"^3.0.0","@artatol/artamail-sdk":"^0.2.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"nuxt":"^3.0.0","typescript":"^5.0.0","@types/node":"^20.0.0","@nuxt/module-builder":"^1.0.0"},"peerDependencies":{"nuxt":">=3.0.0"},"_npmOperationalInternal":{"tmp":"tmp/artamail-nuxt_0.2.0_1781644159635_0.8614485486228207","host":"s3://npm-registry-packages-npm-production"}},"0.3.1":{"name":"@artatol/artamail-nuxt","version":"0.3.1","description":"ArtaMail SDK module for Nuxt 3 applications","type":"module","main":"./dist/module.mjs","exports":{".":{"types":"./dist/module.d.mts","import":"./dist/module.mjs"}},"keywords":["email","nuxt","nuxt-module","nuxt3","artamail","artatol","transactional"],"author":{"name":"Artatol","url":"https://www.artatol.com"},"license":"MIT","repository":{"type":"git","url":"git+https://gitlab.com/artatol/acp/artamail.git","directory":"packages/nuxt"},"homepage":"https://artamail.artatol.net/docs","bugs":{"url":"https://gitlab.com/artatol/acp/artamail/-/issues"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"peerDependencies":{"nuxt":">=3.0.0"},"dependencies":{"@artatol/artamail-sdk":"^0.3.1","@nuxt/kit":"^3.0.0"},"devDependencies":{"@nuxt/module-builder":"^1.0.0","@types/node":"^20.0.0","nuxt":"^3.0.0","typescript":"^5.0.0"},"engines":{"node":">=18.0.0"},"scripts":{"build":"nuxt-module-build build","dev":"nuxt-module-build build --watch","typecheck":"echo 'Nuxt module types are checked during build'","clean":"rm -rf dist"},"_id":"@artatol/artamail-nuxt@0.3.1","_integrity":"sha512-FHuXAJnHtUghERCc3ECgX9BnmEhdsLUX0Ny2fNSzdFPdwVe2IZICBKiN8CbCwhe+AfpPh0JSpqIpl2qtdIQEtQ==","_resolved":"/private/var/folders/8j/tsn7kjzn7g37432x6nbm5xtm0000gn/T/25ff92a7e364f98ebcf2ac1d3394a216/artatol-artamail-nuxt-0.3.1.tgz","_from":"file:artatol-artamail-nuxt-0.3.1.tgz","_nodeVersion":"24.13.1","_npmVersion":"11.8.0","dist":{"integrity":"sha512-FHuXAJnHtUghERCc3ECgX9BnmEhdsLUX0Ny2fNSzdFPdwVe2IZICBKiN8CbCwhe+AfpPh0JSpqIpl2qtdIQEtQ==","shasum":"3eba30e21fbca51117d37a02e63c232060027f14","tarball":"https://registry.npmjs.org/@artatol/artamail-nuxt/-/artamail-nuxt-0.3.1.tgz","fileCount":8,"unpackedSize":10446,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCDm5g4Nv2B4z9yfoLntWJjakl2B6LJ+pmeFQNOHduvQwIhAOj6Kq0gnPH3swgM3huG7OstmAzXwO0dQQJEjurwyN16"}]},"_npmUser":{"name":"vdejl","email":"vlastimil.dejl@artatol.com"},"directories":{},"maintainers":[{"name":"vdejl","email":"vlastimil.dejl@artatol.com"},{"name":"machar","email":"martin@charouzkovi.cz"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/artamail-nuxt_0.3.1_1781651657069_0.5217991166969418"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-16T14:55:23.403Z","modified":"2026-06-16T23:14:17.358Z","0.1.0":"2026-06-16T14:55:23.693Z","0.2.0":"2026-06-16T21:09:19.759Z","0.3.1":"2026-06-16T23:14:17.206Z"},"bugs":{"url":"https://gitlab.com/artatol/acp/artamail/-/issues"},"author":{"name":"Artatol","url":"https://www.artatol.com"},"license":"MIT","homepage":"https://artamail.artatol.net/docs","keywords":["email","nuxt","nuxt-module","nuxt3","artamail","artatol","transactional"],"repository":{"type":"git","url":"git+https://gitlab.com/artatol/acp/artamail.git","directory":"packages/nuxt"},"description":"ArtaMail SDK module for Nuxt 3 applications","maintainers":[{"name":"vdejl","email":"vlastimil.dejl@artatol.com"},{"name":"machar","email":"martin@charouzkovi.cz"}],"readme":"# @artatol/artamail-nuxt\n\nArtaMail SDK module for Nuxt 3 applications. Send transactional and marketing emails with ease.\n\n## Installation\n\n```bash\npnpm add @artatol/artamail-nuxt\n# or\nnpm install @artatol/artamail-nuxt\n```\n\n## Setup\n\nAdd the module to your `nuxt.config.ts`:\n\n```ts\nexport default defineNuxtConfig({\n  modules: ['@artatol/artamail-nuxt'],\n\n  artamail: {\n    apiKey: process.env.ARTAMAIL_API_KEY\n  }\n});\n```\n\nOr use environment variables:\n\n```env\nNUXT_ARTAMAIL_API_KEY=am_live_sk_xxx\n```\n\n## Usage\n\n### In Server API Routes\n\n```ts\n// server/api/send-email.post.ts\nexport default defineEventHandler(async (event) => {\n  const body = await readBody(event);\n\n  const result = await sendEmail({\n    to: body.email,\n    template: 'welcome',\n    data: { name: body.name }\n  });\n\n  return result;\n});\n```\n\n### Using the Client Directly\n\n```ts\n// server/api/templates.get.ts\nexport default defineEventHandler(async () => {\n  const artamail = useArtaMail();\n  return artamail.listTemplates();\n});\n```\n\n### Sending Batch Emails\n\n```ts\n// server/api/notify.post.ts\nexport default defineEventHandler(async (event) => {\n  const { users, message } = await readBody(event);\n\n  const result = await sendBatchEmails({\n    emails: users.map(user => ({\n      to: user.email,\n      template: 'notification',\n      data: { name: user.name, message }\n    }))\n  });\n\n  return result;\n});\n```\n\n## Configuration\n\n### Module Options\n\n```ts\nexport default defineNuxtConfig({\n  modules: ['@artatol/artamail-nuxt'],\n\n  artamail: {\n    // API key (required)\n    apiKey: 'am_live_sk_xxx',\n\n    // Base URL (optional)\n    baseUrl: 'https://mail.artamail.com',\n\n    // Request timeout in ms (default: 30000)\n    timeout: 30000,\n\n    // Retry attempts (default: 3)\n    retries: 3\n  }\n});\n```\n\n### Environment Variables\n\nAll options can be set via environment variables:\n\n```env\nNUXT_ARTAMAIL_API_KEY=am_live_sk_xxx\nNUXT_ARTAMAIL_BASE_URL=https://mail.artamail.com\nNUXT_ARTAMAIL_TIMEOUT=30000\nNUXT_ARTAMAIL_RETRIES=3\n```\n\n## Server Composables\n\n### `useArtaMail()`\n\nGet the ArtaMail client instance:\n\n```ts\nconst artamail = useArtaMail();\n\n// Send email\nawait artamail.send({ to: '...', template: '...', data: {} });\n\n// Get templates\nconst templates = await artamail.listTemplates();\n\n// Manage contacts\nawait artamail.upsertContact({ email: '...', name: '...' });\n```\n\n### `sendEmail(options)`\n\nSend a single email:\n\n```ts\nconst result = await sendEmail({\n  to: 'user@example.com',\n  template: 'welcome',\n  data: { name: 'John' },\n  priority: 'high'\n});\n```\n\n### `sendBatchEmails(options)`\n\nSend multiple emails:\n\n```ts\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  ValidationError,\n  AuthenticationError,\n  RateLimitError\n} from '@artatol/artamail-sdk';\n\nexport default defineEventHandler(async (event) => {\n  try {\n    return await sendEmail({ ... });\n  } catch (error) {\n    if (error instanceof ValidationError) {\n      throw createError({ statusCode: 400, message: error.message });\n    }\n    if (error instanceof AuthenticationError) {\n      throw createError({ statusCode: 401, message: 'Invalid API key' });\n    }\n    if (error instanceof RateLimitError) {\n      throw createError({ statusCode: 429, message: 'Rate limited' });\n    }\n    throw error;\n  }\n});\n```\n\n## TypeScript\n\nFull TypeScript support:\n\n```ts\nimport type {\n  SendEmailOptions,\n  SendEmailResult,\n  Template,\n  Contact\n} from '@artatol/artamail-sdk';\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md"}