sently 0.7.2 → 0.9.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +34 -0
- package/CHANGELOG.md +49 -1
- package/README.md +89 -776
- package/dist/adapters/bun.js +1 -1
- package/dist/adapters/cf.js +2 -2
- package/dist/adapters/cf.js.map +2 -2
- package/dist/adapters/deno.js +1 -1
- package/dist/adapters/node.js +1 -1
- package/dist/auth/oauth2.js +2 -2
- package/dist/auth/oauth2.js.map +1 -1
- package/dist/chunk-0gqy32pe.js +4 -0
- package/dist/chunk-0gqy32pe.js.map +10 -0
- package/dist/{chunk-kebhy657.js → chunk-0qxws3kj.js} +2 -2
- package/dist/{chunk-kebhy657.js.map → chunk-0qxws3kj.js.map} +1 -1
- package/dist/chunk-29z7fkzy.js +4 -0
- package/dist/{chunk-74rha3ac.js.map → chunk-29z7fkzy.js.map} +2 -2
- package/dist/chunk-5915vbcj.js +4 -0
- package/dist/chunk-5915vbcj.js.map +10 -0
- package/dist/{chunk-keksa6fx.js → chunk-6npp3x3c.js} +2 -2
- package/dist/{chunk-keksa6fx.js.map → chunk-6npp3x3c.js.map} +1 -1
- package/dist/chunk-7gy2q9sh.js +4 -0
- package/dist/chunk-7gy2q9sh.js.map +10 -0
- package/dist/{chunk-gkkv7yqm.js → chunk-8dty8c4p.js} +3 -3
- package/dist/{chunk-gkkv7yqm.js.map → chunk-8dty8c4p.js.map} +2 -2
- package/dist/{chunk-qp4y0kp2.js → chunk-8njyga62.js} +2 -2
- package/dist/{chunk-qp4y0kp2.js.map → chunk-8njyga62.js.map} +1 -1
- package/dist/{chunk-gh5n759p.js → chunk-93vqxxj2.js} +3 -3
- package/dist/{chunk-gh5n759p.js.map → chunk-93vqxxj2.js.map} +1 -1
- package/dist/chunk-b602dhck.js +4 -0
- package/dist/{chunk-rm78s1ek.js.map → chunk-b602dhck.js.map} +2 -2
- package/dist/chunk-gp4fwrs8.js +4 -0
- package/dist/chunk-gp4fwrs8.js.map +10 -0
- package/dist/chunk-n0qeyzqm.js +13 -0
- package/dist/{chunk-cvrbfke9.js.map → chunk-n0qeyzqm.js.map} +2 -2
- package/dist/chunk-qtkd5bak.js +4 -0
- package/dist/chunk-qtkd5bak.js.map +11 -0
- package/dist/chunk-skqhj0rm.js +4 -0
- package/dist/{chunk-r7ee9tk7.js.map → chunk-skqhj0rm.js.map} +2 -2
- package/dist/{chunk-a1c87hn1.js → chunk-tamww15j.js} +2 -2
- package/dist/{chunk-a1c87hn1.js.map → chunk-tamww15j.js.map} +1 -1
- package/dist/chunk-vjpds2pf.js +3 -0
- package/dist/chunk-vjpds2pf.js.map +10 -0
- package/dist/chunk-yp311efr.js +4 -0
- package/dist/chunk-yp311efr.js.map +10 -0
- package/dist/chunk-ywq6s10g.js +5 -0
- package/dist/{chunk-d5rwm3br.js.map → chunk-ywq6s10g.js.map} +3 -3
- package/dist/core/base64.d.ts +10 -0
- package/dist/core/errors.js +2 -2
- package/dist/core/errors.js.map +1 -1
- package/dist/core/hooks.d.ts +14 -0
- package/dist/core/plugin.d.ts +7 -7
- package/dist/core/provider-label.d.ts +6 -0
- package/dist/core/push-endpoint.d.ts +29 -0
- package/dist/core/push-types.d.ts +98 -0
- package/dist/core/sms-types.d.ts +76 -0
- package/dist/core/smtp.js +2 -2
- package/dist/core/smtp.js.map +1 -1
- package/dist/core/types.d.ts +27 -4
- package/dist/core/whatsapp-types.d.ts +116 -0
- package/dist/detect.js +2 -2
- package/dist/detect.js.map +1 -1
- package/dist/dkim.js +2 -2
- package/dist/dkim.js.map +2 -2
- package/dist/idempotency.d.ts +1 -0
- package/dist/idempotency.js +2 -2
- package/dist/idempotency.js.map +3 -3
- package/dist/index.d.ts +24 -2
- package/dist/index.js +23 -0
- package/dist/mailer.js +2 -2
- package/dist/mailer.js.map +1 -1
- package/dist/observability/console.d.ts +12 -0
- package/dist/observability/console.js +3 -0
- package/dist/observability/console.js.map +10 -0
- package/dist/plugins/react.js +2 -2
- package/dist/plugins/react.js.map +2 -2
- package/dist/plugins/template.js +1 -1
- package/dist/pool/pool.js +2 -2
- package/dist/pool/pool.js.map +1 -1
- package/dist/push.d.ts +26 -0
- package/dist/push.js +3 -0
- package/dist/push.js.map +10 -0
- package/dist/sms.d.ts +26 -0
- package/dist/sms.js +3 -0
- package/dist/sms.js.map +10 -0
- package/dist/smtp-mailer.js +2 -2
- package/dist/smtp-mailer.js.map +2 -2
- package/dist/transports/brevo.d.ts +1 -0
- package/dist/transports/brevo.js +2 -2
- package/dist/transports/brevo.js.map +3 -3
- package/dist/transports/cloudflare-email.d.ts +58 -0
- package/dist/transports/cloudflare-email.js +3 -0
- package/dist/transports/cloudflare-email.js.map +10 -0
- package/dist/transports/fallback.d.ts +100 -0
- package/dist/transports/fallback.js +3 -0
- package/dist/transports/fallback.js.map +9 -0
- package/dist/transports/loops.d.ts +32 -0
- package/dist/transports/loops.js +3 -0
- package/dist/transports/loops.js.map +10 -0
- package/dist/transports/mailersend.d.ts +27 -0
- package/dist/transports/mailersend.js +3 -0
- package/dist/transports/mailersend.js.map +10 -0
- package/dist/transports/mailgun.d.ts +1 -0
- package/dist/transports/mailgun.js +2 -2
- package/dist/transports/mailgun.js.map +3 -3
- package/dist/transports/mailtrap.d.ts +36 -0
- package/dist/transports/mailtrap.js +3 -0
- package/dist/transports/mailtrap.js.map +10 -0
- package/dist/transports/msegat.d.ts +132 -0
- package/dist/transports/msegat.js +3 -0
- package/dist/transports/msegat.js.map +10 -0
- package/dist/transports/plunk.d.ts +29 -0
- package/dist/transports/plunk.js +3 -0
- package/dist/transports/plunk.js.map +10 -0
- package/dist/transports/postmark.d.ts +1 -0
- package/dist/transports/postmark.js +2 -2
- package/dist/transports/postmark.js.map +3 -3
- package/dist/transports/preview.d.ts +1 -0
- package/dist/transports/preview.js +2 -2
- package/dist/transports/preview.js.map +3 -3
- package/dist/transports/resend.d.ts +1 -0
- package/dist/transports/resend.js +2 -2
- package/dist/transports/resend.js.map +3 -3
- package/dist/transports/retry.d.ts +1 -0
- package/dist/transports/retry.js +2 -2
- package/dist/transports/retry.js.map +3 -3
- package/dist/transports/sendgrid.d.ts +1 -0
- package/dist/transports/sendgrid.js +2 -2
- package/dist/transports/sendgrid.js.map +3 -3
- package/dist/transports/ses.d.ts +1 -0
- package/dist/transports/ses.js +3 -3
- package/dist/transports/ses.js.map +3 -3
- package/dist/transports/smtp.d.ts +1 -0
- package/dist/transports/smtp.js +2 -2
- package/dist/transports/smtp.js.map +1 -1
- package/dist/transports/sndr.d.ts +41 -0
- package/dist/transports/sndr.js +3 -0
- package/dist/transports/sndr.js.map +10 -0
- package/dist/transports/sparkpost.d.ts +30 -0
- package/dist/transports/sparkpost.js +3 -0
- package/dist/transports/sparkpost.js.map +10 -0
- package/dist/transports/taqnyat-mail.d.ts +33 -0
- package/dist/transports/taqnyat-mail.js +3 -0
- package/dist/transports/taqnyat-mail.js.map +10 -0
- package/dist/transports/taqnyat-phone.d.ts +4 -0
- package/dist/transports/taqnyat-sms.d.ts +131 -0
- package/dist/transports/taqnyat-sms.js +3 -0
- package/dist/transports/taqnyat-sms.js.map +10 -0
- package/dist/transports/taqnyat-whatsapp.d.ts +51 -0
- package/dist/transports/taqnyat-whatsapp.js +3 -0
- package/dist/transports/taqnyat-whatsapp.js.map +10 -0
- package/dist/transports/twilio-sms.d.ts +66 -0
- package/dist/transports/twilio-sms.js +3 -0
- package/dist/transports/twilio-sms.js.map +10 -0
- package/dist/transports/webpush.d.ts +46 -0
- package/dist/transports/webpush.js +3 -0
- package/dist/transports/webpush.js.map +10 -0
- package/dist/transports/weighted-fallback.d.ts +65 -0
- package/dist/transports/weighted-fallback.js +3 -0
- package/dist/transports/weighted-fallback.js.map +10 -0
- package/dist/transports/whatsapp-cloud.d.ts +56 -0
- package/dist/transports/whatsapp-cloud.js +3 -0
- package/dist/transports/whatsapp-cloud.js.map +10 -0
- package/dist/webhooks/brevo.js +1 -1
- package/dist/webhooks/mailgun.js +1 -1
- package/dist/webhooks/postmark.js +1 -1
- package/dist/webhooks/resend.js +1 -1
- package/dist/webhooks/sendgrid.js +1 -1
- package/dist/webhooks/ses.js +1 -1
- package/dist/webhooks/sndr.d.ts +16 -0
- package/dist/webhooks/sndr.js +3 -0
- package/dist/webhooks/sndr.js.map +10 -0
- package/dist/webhooks/timing-safe-equal.js +1 -1
- package/dist/webhooks.d.ts +9 -2
- package/dist/webhooks.js +4 -0
- package/dist/whatsapp.d.ts +26 -0
- package/dist/whatsapp.js +3 -0
- package/dist/whatsapp.js.map +10 -0
- package/package.json +121 -4
- package/site/README.md +26 -0
- package/site/content/docs/ai/index.mdx +13 -0
- package/site/content/docs/ai/llms-txt.mdx +12 -0
- package/site/content/docs/ai/mcp.mdx +16 -0
- package/site/content/docs/ai/meta.json +9 -0
- package/site/content/docs/channels/email.mdx +100 -0
- package/site/content/docs/channels/hooks.mdx +87 -0
- package/site/content/docs/channels/index.mdx +81 -0
- package/site/content/docs/channels/meta.json +12 -0
- package/site/content/docs/channels/push.mdx +92 -0
- package/site/content/docs/channels/sms.mdx +88 -0
- package/site/content/docs/channels/whatsapp.mdx +95 -0
- package/site/content/docs/decorators/fallback.mdx +34 -0
- package/site/content/docs/decorators/idempotency.mdx +34 -0
- package/site/content/docs/decorators/index.mdx +50 -0
- package/site/content/docs/decorators/meta.json +12 -0
- package/site/content/docs/decorators/preview.mdx +34 -0
- package/site/content/docs/decorators/retry.mdx +34 -0
- package/site/content/docs/decorators/weighted-fallback.mdx +34 -0
- package/site/content/docs/get-started/entrypoints.mdx +114 -0
- package/site/content/docs/get-started/index.mdx +14 -0
- package/site/content/docs/get-started/installation.mdx +78 -0
- package/site/content/docs/get-started/introduction.mdx +77 -0
- package/site/content/docs/get-started/meta.json +12 -0
- package/site/content/docs/get-started/migrate-nodemailer.mdx +23 -0
- package/site/content/docs/get-started/runtimes.mdx +17 -0
- package/site/content/docs/guides/adapters.mdx +26 -0
- package/site/content/docs/guides/attachments.mdx +19 -0
- package/site/content/docs/guides/bundle-size.mdx +78 -0
- package/site/content/docs/guides/dkim.mdx +26 -0
- package/site/content/docs/guides/index.mdx +15 -0
- package/site/content/docs/guides/meta.json +21 -0
- package/site/content/docs/guides/oauth2.mdx +23 -0
- package/site/content/docs/guides/observability.mdx +16 -0
- package/site/content/docs/guides/plugins-template.mdx +22 -0
- package/site/content/docs/guides/pool.mdx +24 -0
- package/site/content/docs/guides/react-email.mdx +20 -0
- package/site/content/docs/guides/security.mdx +17 -0
- package/site/content/docs/guides/send-bulk.mdx +18 -0
- package/site/content/docs/guides/vendor-extras-otp.mdx +18 -0
- package/site/content/docs/guides/webhooks.mdx +120 -0
- package/site/content/docs/guides/webpush-interop.mdx +18 -0
- package/site/content/docs/index.mdx +15 -0
- package/site/content/docs/meta.json +15 -0
- package/site/content/docs/quick-start/email.mdx +40 -0
- package/site/content/docs/quick-start/index.mdx +15 -0
- package/site/content/docs/quick-start/meta.json +5 -0
- package/site/content/docs/quick-start/push.mdx +36 -0
- package/site/content/docs/quick-start/sms.mdx +36 -0
- package/site/content/docs/quick-start/whatsapp.mdx +38 -0
- package/site/content/docs/reference/errors.mdx +22 -0
- package/site/content/docs/reference/exports.mdx +83 -0
- package/site/content/docs/reference/index.mdx +15 -0
- package/site/content/docs/reference/mail-options.mdx +22 -0
- package/site/content/docs/reference/meta.json +15 -0
- package/site/content/docs/reference/push-options.mdx +20 -0
- package/site/content/docs/reference/sms-options.mdx +17 -0
- package/site/content/docs/reference/transport-contracts.mdx +17 -0
- package/site/content/docs/reference/webhook-events.mdx +70 -0
- package/site/content/docs/reference/whatsapp-options.mdx +15 -0
- package/site/content/docs/transports/brevo.mdx +40 -0
- package/site/content/docs/transports/cloudflare-email.mdx +40 -0
- package/site/content/docs/transports/index.mdx +105 -0
- package/site/content/docs/transports/loops.mdx +41 -0
- package/site/content/docs/transports/mailersend.mdx +40 -0
- package/site/content/docs/transports/mailgun.mdx +42 -0
- package/site/content/docs/transports/mailtrap.mdx +42 -0
- package/site/content/docs/transports/meta.json +32 -0
- package/site/content/docs/transports/msegat.mdx +42 -0
- package/site/content/docs/transports/plunk.mdx +40 -0
- package/site/content/docs/transports/postmark.mdx +40 -0
- package/site/content/docs/transports/resend.mdx +43 -0
- package/site/content/docs/transports/sendgrid.mdx +40 -0
- package/site/content/docs/transports/ses.mdx +44 -0
- package/site/content/docs/transports/smtp.mdx +47 -0
- package/site/content/docs/transports/sndr.mdx +144 -0
- package/site/content/docs/transports/sparkpost.mdx +41 -0
- package/site/content/docs/transports/taqnyat-mail.mdx +41 -0
- package/site/content/docs/transports/taqnyat-sms.mdx +41 -0
- package/site/content/docs/transports/taqnyat-whatsapp.mdx +40 -0
- package/site/content/docs/transports/twilio-sms.mdx +128 -0
- package/site/content/docs/transports/webpush.mdx +43 -0
- package/site/content/docs/transports/whatsapp-cloud.mdx +42 -0
- package/dist/chunk-4mvp3b85.js +0 -3
- package/dist/chunk-4mvp3b85.js.map +0 -10
- package/dist/chunk-74rha3ac.js +0 -4
- package/dist/chunk-cvrbfke9.js +0 -13
- package/dist/chunk-d5rwm3br.js +0 -5
- package/dist/chunk-ka6t8g77.js +0 -4
- package/dist/chunk-ka6t8g77.js.map +0 -11
- package/dist/chunk-r7ee9tk7.js +0 -4
- package/dist/chunk-rm78s1ek.js +0 -4
|
@@ -2,9 +2,9 @@
|
|
|
2
2
|
"version": 3,
|
|
3
3
|
"sources": ["../src/transports/sendgrid.ts"],
|
|
4
4
|
"sourcesContent": [
|
|
5
|
-
"/**\n * @module\n * SendGrid v3 HTTP API transport for sending email via api.sendgrid.com.\n *\n * @example\n * ```ts\n * import { SendGridTransport } from \"sently/transports/sendgrid\";\n * import { createMailer } from \"sently/mailer\";\n *\n * const mailer = await createMailer({\n * transport: new SendGridTransport({ apiKey: process.env.SENDGRID_API_KEY! }),\n * });\n *\n * await mailer.send({\n * from: \"sender@example.com\",\n * to: \"recipient@example.com\",\n * subject: \"Hello\",\n * text: \"Plain text body\",\n * });\n * ```\n */\nimport { extractEmails, parseAddresses } from \"../core/address.js\";\nimport { encodeBase64 } from \"../core/base64.js\";\nimport { httpStatusToSentlyCode, SentlyError } from \"../core/errors.js\";\nimport type { MailOptions, SendResult, Transport, VerifyResult } from \"../core/types.js\";\nimport { resolveAttachments } from \"./resolve-attachments.js\";\n\n/** SendGrid API configuration. */\nexport interface SendGridConfig {\n /** SendGrid API key (Bearer token). */\n apiKey: string;\n}\n\n/** Error thrown when the SendGrid API returns a non-success response. */\nexport class SendGridError extends SentlyError {\n /** Creates a SendGrid API error with status code and response payload. */\n constructor(\n message: string,\n public readonly statusCode: number,\n public readonly apiError: unknown,\n ) {\n super(message, httpStatusToSentlyCode(statusCode), {\n statusCode,\n provider: \"sendgrid\",\n cause: apiError,\n });\n this.name = \"SendGridError\";\n }\n}\n\n/**\n * SendGrid v3 HTTP API transport.\n */\nexport class SendGridTransport implements Transport {\n /** SendGrid API key for Bearer authentication. */\n private readonly apiKey: string;\n\n /** Creates a SendGrid transport with the given API key. */\n constructor(config: SendGridConfig) {\n this.apiKey = config.apiKey;\n }\n\n /** Build a SendGrid personalization for one message. */\n private buildPersonalization(options: MailOptions): Record<string, unknown> {\n return {\n to: parseAddresses(options.to).map((addr) => ({ email: addr.address, name: addr.name })),\n ...(options.cc\n ? {\n cc: parseAddresses(options.cc).map((addr) => ({\n email: addr.address,\n name: addr.name,\n })),\n }\n : {}),\n ...(options.bcc\n ? {\n bcc: parseAddresses(options.bcc).map((addr) => ({\n email: addr.address,\n name: addr.name,\n })),\n }\n : {}),\n subject: options.subject,\n ...(options.headers ? { headers: options.headers } : {}),\n };\n }\n\n /** Build SendGrid content parts from text/html options. */\n private buildContent(options: MailOptions): Array<{ type: string; value: string }> {\n return [\n ...(options.text ? [{ type: \"text/plain\", value: options.text }] : []),\n ...(options.html ? [{ type: \"text/html\", value: options.html }] : []),\n ];\n }\n\n /** Map a SendGrid response to a normalized SendResult for one message. */\n private toSendResult(\n options: MailOptions,\n messageId: string,\n responseText = \"Accepted\",\n ): SendResult {\n const from = parseAddresses(options.from)[0];\n return {\n messageId,\n accepted: extractEmails(options.to),\n rejected: [],\n response: responseText,\n envelope: {\n from: from?.address ?? \"\",\n to: [\n ...extractEmails(options.to),\n ...(options.cc ? extractEmails(options.cc) : []),\n ...(options.bcc ? extractEmails(options.bcc) : []),\n ],\n },\n };\n }\n\n /** Sends an email via the SendGrid v3 HTTP API. */\n async send(options: MailOptions): Promise<SendResult> {\n const attachments = await resolveAttachments(options.attachments);\n const from = parseAddresses(options.from)[0];\n\n const body = {\n personalizations: [this.buildPersonalization(options)],\n from: from\n ? { email: from.address, ...(from.name ? { name: from.name } : {}) }\n : { email: \"\" },\n ...(options.replyTo\n ? {\n reply_to: parseAddresses(options.replyTo).map((addr) => ({\n email: addr.address,\n name: addr.name,\n }))[0],\n }\n : {}),\n content: this.buildContent(options),\n ...(attachments.length > 0\n ? {\n attachments: attachments.map((att) => ({\n filename: att.filename,\n type: att.contentType ?? \"application/octet-stream\",\n content:\n att.content instanceof Uint8Array\n ? encodeBase64(att.content).replace(/\\r\\n/g, \"\")\n : att.content,\n ...(att.contentId ? { content_id: att.contentId } : {}),\n disposition: att.inline ? \"inline\" : \"attachment\",\n })),\n }\n : {}),\n };\n\n const response = await fetch(\"https://api.sendgrid.com/v3/mail/send\", {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${this.apiKey}`,\n \"Content-Type\": \"application/json\",\n },\n body: JSON.stringify(body),\n });\n\n if (!response.ok) {\n const apiError = await response.text();\n throw new SendGridError(\"SendGrid API error\", response.status, apiError);\n }\n\n const messageId = response.headers.get(\"x-message-id\") ?? options.messageId ?? \"\";\n\n return this.toSendResult(options, messageId);\n }\n\n /** Send multiple messages in one request using SendGrid personalizations. */\n async sendBatch(messages: MailOptions[]): Promise<SendResult[]> {\n if (messages.length === 0) {\n return [];\n }\n\n const first = messages[0] as MailOptions;\n const from = parseAddresses(first.from)[0];\n\n const body = {\n personalizations: messages.map((message) => this.buildPersonalization(message)),\n from: from\n ? { email: from.address, ...(from.name ? { name: from.name } : {}) }\n : { email: \"\" },\n ...(first.replyTo\n ? {\n reply_to: parseAddresses(first.replyTo).map((addr) => ({\n email: addr.address,\n name: addr.name,\n }))[0],\n }\n : {}),\n content: this.buildContent(first),\n };\n\n const response = await fetch(\"https://api.sendgrid.com/v3/mail/send\", {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${this.apiKey}`,\n \"Content-Type\": \"application/json\",\n },\n body: JSON.stringify(body),\n });\n\n if (!response.ok) {\n const apiError = await response.text();\n throw new SendGridError(\"SendGrid API error\", response.status, apiError);\n }\n\n const messageId = response.headers.get(\"x-message-id\") ?? \"\";\n return messages.map((message) =>\n this.toSendResult(message, messageId || message.messageId || \"\"),\n );\n }\n\n /** Verifies the SendGrid API key by fetching the user profile. */\n async verify(): Promise<VerifyResult> {\n try {\n const response = await fetch(\"https://api.sendgrid.com/v3/user/profile\", {\n headers: {\n Authorization: `Bearer ${this.apiKey}`,\n },\n });\n\n if (!response.ok) {\n const apiError = await response.text().catch(() => \"\");\n return {\n ok: false,\n provider: \"sendgrid\",\n message: apiError || `HTTP ${response.status}`,\n };\n }\n\n const payload = (await response.json()) as { username?: string };\n return {\n ok: true,\n provider: \"sendgrid\",\n ...(payload.username ? { message: payload.username } : {}),\n };\n } catch (err) {\n return {\n ok: false,\n provider: \"sendgrid\",\n message: err instanceof Error ? err.message : String(err),\n };\n }\n }\n}\n"
|
|
5
|
+
"/**\n * @module\n * SendGrid v3 HTTP API transport for sending email via api.sendgrid.com.\n *\n * @example\n * ```ts\n * import { SendGridTransport } from \"sently/transports/sendgrid\";\n * import { createMailer } from \"sently/mailer\";\n *\n * const mailer = await createMailer({\n * transport: new SendGridTransport({ apiKey: process.env.SENDGRID_API_KEY! }),\n * });\n *\n * await mailer.send({\n * from: \"sender@example.com\",\n * to: \"recipient@example.com\",\n * subject: \"Hello\",\n * text: \"Plain text body\",\n * });\n * ```\n */\nimport { extractEmails, parseAddresses } from \"../core/address.js\";\nimport { encodeBase64 } from \"../core/base64.js\";\nimport { httpStatusToSentlyCode, SentlyError } from \"../core/errors.js\";\nimport type { MailOptions, SendResult, Transport, VerifyResult } from \"../core/types.js\";\nimport { resolveAttachments } from \"./resolve-attachments.js\";\n\n/** SendGrid API configuration. */\nexport interface SendGridConfig {\n /** SendGrid API key (Bearer token). */\n apiKey: string;\n}\n\n/** Error thrown when the SendGrid API returns a non-success response. */\nexport class SendGridError extends SentlyError {\n /** Creates a SendGrid API error with status code and response payload. */\n constructor(\n message: string,\n public readonly statusCode: number,\n public readonly apiError: unknown,\n ) {\n super(message, httpStatusToSentlyCode(statusCode), {\n statusCode,\n provider: \"sendgrid\",\n cause: apiError,\n });\n this.name = \"SendGridError\";\n }\n}\n\n/**\n * SendGrid v3 HTTP API transport.\n */\nexport class SendGridTransport implements Transport {\n readonly provider = \"sendgrid\";\n\n /** SendGrid API key for Bearer authentication. */\n private readonly apiKey: string;\n\n /** Creates a SendGrid transport with the given API key. */\n constructor(config: SendGridConfig) {\n this.apiKey = config.apiKey;\n }\n\n /** Build a SendGrid personalization for one message. */\n private buildPersonalization(options: MailOptions): Record<string, unknown> {\n return {\n to: parseAddresses(options.to).map((addr) => ({ email: addr.address, name: addr.name })),\n ...(options.cc\n ? {\n cc: parseAddresses(options.cc).map((addr) => ({\n email: addr.address,\n name: addr.name,\n })),\n }\n : {}),\n ...(options.bcc\n ? {\n bcc: parseAddresses(options.bcc).map((addr) => ({\n email: addr.address,\n name: addr.name,\n })),\n }\n : {}),\n subject: options.subject,\n ...(options.headers ? { headers: options.headers } : {}),\n };\n }\n\n /** Build SendGrid content parts from text/html options. */\n private buildContent(options: MailOptions): Array<{ type: string; value: string }> {\n return [\n ...(options.text ? [{ type: \"text/plain\", value: options.text }] : []),\n ...(options.html ? [{ type: \"text/html\", value: options.html }] : []),\n ];\n }\n\n /** Map a SendGrid response to a normalized SendResult for one message. */\n private toSendResult(\n options: MailOptions,\n messageId: string,\n responseText = \"Accepted\",\n ): SendResult {\n const from = parseAddresses(options.from)[0];\n return {\n messageId,\n accepted: extractEmails(options.to),\n rejected: [],\n response: responseText,\n envelope: {\n from: from?.address ?? \"\",\n to: [\n ...extractEmails(options.to),\n ...(options.cc ? extractEmails(options.cc) : []),\n ...(options.bcc ? extractEmails(options.bcc) : []),\n ],\n },\n };\n }\n\n /** Sends an email via the SendGrid v3 HTTP API. */\n async send(options: MailOptions): Promise<SendResult> {\n const attachments = await resolveAttachments(options.attachments);\n const from = parseAddresses(options.from)[0];\n\n const body = {\n personalizations: [this.buildPersonalization(options)],\n from: from\n ? { email: from.address, ...(from.name ? { name: from.name } : {}) }\n : { email: \"\" },\n ...(options.replyTo\n ? {\n reply_to: parseAddresses(options.replyTo).map((addr) => ({\n email: addr.address,\n name: addr.name,\n }))[0],\n }\n : {}),\n content: this.buildContent(options),\n ...(attachments.length > 0\n ? {\n attachments: attachments.map((att) => ({\n filename: att.filename,\n type: att.contentType ?? \"application/octet-stream\",\n content:\n att.content instanceof Uint8Array\n ? encodeBase64(att.content).replace(/\\r\\n/g, \"\")\n : att.content,\n ...(att.contentId ? { content_id: att.contentId } : {}),\n disposition: att.inline ? \"inline\" : \"attachment\",\n })),\n }\n : {}),\n };\n\n const response = await fetch(\"https://api.sendgrid.com/v3/mail/send\", {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${this.apiKey}`,\n \"Content-Type\": \"application/json\",\n },\n body: JSON.stringify(body),\n });\n\n if (!response.ok) {\n const apiError = await response.text();\n throw new SendGridError(\"SendGrid API error\", response.status, apiError);\n }\n\n const messageId = response.headers.get(\"x-message-id\") ?? options.messageId ?? \"\";\n\n return this.toSendResult(options, messageId);\n }\n\n /** Send multiple messages in one request using SendGrid personalizations. */\n async sendBatch(messages: MailOptions[]): Promise<SendResult[]> {\n if (messages.length === 0) {\n return [];\n }\n\n const first = messages[0] as MailOptions;\n const from = parseAddresses(first.from)[0];\n\n const body = {\n personalizations: messages.map((message) => this.buildPersonalization(message)),\n from: from\n ? { email: from.address, ...(from.name ? { name: from.name } : {}) }\n : { email: \"\" },\n ...(first.replyTo\n ? {\n reply_to: parseAddresses(first.replyTo).map((addr) => ({\n email: addr.address,\n name: addr.name,\n }))[0],\n }\n : {}),\n content: this.buildContent(first),\n };\n\n const response = await fetch(\"https://api.sendgrid.com/v3/mail/send\", {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${this.apiKey}`,\n \"Content-Type\": \"application/json\",\n },\n body: JSON.stringify(body),\n });\n\n if (!response.ok) {\n const apiError = await response.text();\n throw new SendGridError(\"SendGrid API error\", response.status, apiError);\n }\n\n const messageId = response.headers.get(\"x-message-id\") ?? \"\";\n return messages.map((message) =>\n this.toSendResult(message, messageId || message.messageId || \"\"),\n );\n }\n\n /** Verifies the SendGrid API key by fetching the user profile. */\n async verify(): Promise<VerifyResult> {\n try {\n const response = await fetch(\"https://api.sendgrid.com/v3/user/profile\", {\n headers: {\n Authorization: `Bearer ${this.apiKey}`,\n },\n });\n\n if (!response.ok) {\n const apiError = await response.text().catch(() => \"\");\n return {\n ok: false,\n provider: \"sendgrid\",\n message: apiError || `HTTP ${response.status}`,\n };\n }\n\n const payload = (await response.json()) as { username?: string };\n return {\n ok: true,\n provider: \"sendgrid\",\n ...(payload.username ? { message: payload.username } : {}),\n };\n } catch (err) {\n return {\n ok: false,\n provider: \"sendgrid\",\n message: err instanceof Error ? err.message : String(err),\n };\n }\n }\n}\n"
|
|
6
6
|
],
|
|
7
|
-
"mappings": "
|
|
8
|
-
"debugId": "
|
|
7
|
+
"mappings": "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",
|
|
8
|
+
"debugId": "D36AE2D50C91F89564756E2164756E21",
|
|
9
9
|
"names": []
|
|
10
10
|
}
|
package/dist/transports/ses.d.ts
CHANGED
|
@@ -11,6 +11,7 @@ export declare class SESError extends SentlyError {
|
|
|
11
11
|
* AWS SES v2 HTTP API transport.
|
|
12
12
|
*/
|
|
13
13
|
export declare class SESTransport implements Transport {
|
|
14
|
+
readonly provider = "ses";
|
|
14
15
|
/** AWS access key ID for SigV4 signing. */
|
|
15
16
|
private readonly accessKeyId;
|
|
16
17
|
/** AWS secret access key for SigV4 signing. */
|
package/dist/transports/ses.js
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
|
-
import{
|
|
1
|
+
import{u as v}from"../chunk-8dty8c4p.js";import{I as b}from"../chunk-skqhj0rm.js";import{Q as C,R,S as D}from"../chunk-93vqxxj2.js";import{Y as x}from"../chunk-ywq6s10g.js";import{ca as A,da as k}from"../chunk-tamww15j.js";import"../chunk-6npp3x3c.js";var z=new TextEncoder;async function K(F){let G=await crypto.subtle.digest("SHA-256",z.encode(F));return T(new Uint8Array(G))}async function w(F,G){let J=typeof F==="string"?z.encode(F):new Uint8Array(F),X=await crypto.subtle.importKey("raw",J,{name:"HMAC",hash:"SHA-256"},!1,["sign"]),L=await crypto.subtle.sign("HMAC",X,z.encode(G));return new Uint8Array(L)}async function B(F){let{method:G,url:J,body:X,credentials:L}=F,Y=new URL(J),Z=F._date??`${new Date().toISOString().replace(/[-:]/g,"").slice(0,15)}Z`,Q=Z.slice(0,8),$={...Object.fromEntries(Object.entries(F.headers).map(([N,S])=>[N.toLowerCase(),S.trim()])),host:Y.host,"x-amz-date":Z};if(L.sessionToken)$["x-amz-security-token"]=L.sessionToken;let O=Object.keys($).map((N)=>N.toLowerCase()).sort(),V=O.join(";"),P=`${O.map((N)=>`${N}:${$[N]}`).join(`
|
|
2
2
|
`)}
|
|
3
3
|
`,I=y(Y.searchParams),U=await K(X),W=[G.toUpperCase(),u(Y.pathname),I,P,V,U].join(`
|
|
4
4
|
`),_=`${Q}/${L.region}/${L.service}/aws4_request`,M=["AWS4-HMAC-SHA256",Z,_,await K(W)].join(`
|
|
5
|
-
`),H=await h(L.secretAccessKey,Q,L.region,L.service),f=T(await w(H,M)),E=[`AWS4-HMAC-SHA256 Credential=${L.accessKeyId}/${_}`,`SignedHeaders=${V}`,`Signature=${f}`].join(", ");return{headers:{...$,Authorization:E}}}async function h(F,G,J,X){let L=await w(`AWS4${F}`,G),Y=await w(L,J),Z=await w(Y,X);return w(Z,"aws4_request")}function u(F){if(!F||F==="/")return"/";return F.split("/").map((G)=>encodeURIComponent(decodeURIComponent(G))).join("/")}function y(F){let G=[];for(let[J,X]of F.entries())G.push(`${j(J)}=${j(X)}`);return G.sort(),G.join("&")}function j(F){return encodeURIComponent(F).replace(/[!'()*]/g,(G)=>`%${G.charCodeAt(0).toString(16).toUpperCase()}`)}function T(F){return Array.from(F,(G)=>G.toString(16).padStart(2,"0")).join("")}class q extends A{statusCode;requestId;constructor(F,G,J,X){super(F,k(G),{statusCode:G,provider:"ses"});this.statusCode=G;this.requestId=X;this.name="SESError",this.code=J}}class g{accessKeyId;secretAccessKey;region;sessionToken;dkim;constructor(F){this.accessKeyId=F.accessKeyId,this.secretAccessKey=F.secretAccessKey,this.region=F.region??"us-east-1",this.sessionToken=F.sessionToken,this.dkim=F.dkim}async send(F){let G=await b(F.attachments),J={...F,attachments:G},X=C(F.from)[0],L=X?R(X):"",Y=D(F.to),Z=F.cc?D(F.cc):[],Q=F.bcc?D(F.bcc):[],$={ToAddresses:Y,CcAddresses:Z,BccAddresses:Q},O;if(G.length>0){let M=await v(J,this.dkim);O={FromEmailAddress:L,Destination:$,Content:{Raw:{Data:x(M.raw).replace(/\r\n/g,"")}}}}else O={FromEmailAddress:L,Destination:$,Content:{Simple:{Subject:{Data:F.subject,Charset:"UTF-8"},Body:{...F.text?{Text:{Data:F.text,Charset:"UTF-8"}}:{},...F.html?{Html:{Data:F.html,Charset:"UTF-8"}}:{}}}}};let V=JSON.stringify(O),P=`https://email.${this.region}.amazonaws.com/v2/email/outbound-emails`,I=await B({method:"POST",url:P,headers:{"content-type":"application/json"},body:V,credentials:{accessKeyId:this.accessKeyId,secretAccessKey:this.secretAccessKey,region:this.region,service:"ses",...this.sessionToken?{sessionToken:this.sessionToken}:{}}}),U=await fetch(P,{method:"POST",headers:I.headers,body:V}),W=await U.json();if(!U.ok)throw new q(W.message??"SES API error",U.status,W.Code??"",U.headers.get("x-amzn-requestid")??"");let _=W.MessageId??"";return{messageId:_,accepted:[...Y,...Z,...Q],rejected:[],response:`MessageId: ${_}`,envelope:{from:X?.address??"",to:Y}}}async verify(){try{let F=`https://email.${this.region}.amazonaws.com/v2/email/configuration-sets`,G=await B({method:"GET",url:F,headers:{},body:"",credentials:{accessKeyId:this.accessKeyId,secretAccessKey:this.secretAccessKey,region:this.region,service:"ses",...this.sessionToken?{sessionToken:this.sessionToken}:{}}}),J=await fetch(F,{method:"GET",headers:G.headers}),X=await J.json().catch(()=>({}));if(!J.ok)return{ok:!1,provider:"ses",message:X.message??`HTTP ${J.status}`};return{ok:!0,provider:"ses",message:"Credentials are valid"}}catch(F){return{ok:!1,provider:"ses",message:F instanceof Error?F.message:String(F)}}}}export{g as SESTransport,q as SESError};
|
|
5
|
+
`),H=await h(L.secretAccessKey,Q,L.region,L.service),f=T(await w(H,M)),E=[`AWS4-HMAC-SHA256 Credential=${L.accessKeyId}/${_}`,`SignedHeaders=${V}`,`Signature=${f}`].join(", ");return{headers:{...$,Authorization:E}}}async function h(F,G,J,X){let L=await w(`AWS4${F}`,G),Y=await w(L,J),Z=await w(Y,X);return w(Z,"aws4_request")}function u(F){if(!F||F==="/")return"/";return F.split("/").map((G)=>encodeURIComponent(decodeURIComponent(G))).join("/")}function y(F){let G=[];for(let[J,X]of F.entries())G.push(`${j(J)}=${j(X)}`);return G.sort(),G.join("&")}function j(F){return encodeURIComponent(F).replace(/[!'()*]/g,(G)=>`%${G.charCodeAt(0).toString(16).toUpperCase()}`)}function T(F){return Array.from(F,(G)=>G.toString(16).padStart(2,"0")).join("")}class q extends A{statusCode;requestId;constructor(F,G,J,X){super(F,k(G),{statusCode:G,provider:"ses"});this.statusCode=G;this.requestId=X;this.name="SESError",this.code=J}}class g{provider="ses";accessKeyId;secretAccessKey;region;sessionToken;dkim;constructor(F){this.accessKeyId=F.accessKeyId,this.secretAccessKey=F.secretAccessKey,this.region=F.region??"us-east-1",this.sessionToken=F.sessionToken,this.dkim=F.dkim}async send(F){let G=await b(F.attachments),J={...F,attachments:G},X=C(F.from)[0],L=X?R(X):"",Y=D(F.to),Z=F.cc?D(F.cc):[],Q=F.bcc?D(F.bcc):[],$={ToAddresses:Y,CcAddresses:Z,BccAddresses:Q},O;if(G.length>0){let M=await v(J,this.dkim);O={FromEmailAddress:L,Destination:$,Content:{Raw:{Data:x(M.raw).replace(/\r\n/g,"")}}}}else O={FromEmailAddress:L,Destination:$,Content:{Simple:{Subject:{Data:F.subject,Charset:"UTF-8"},Body:{...F.text?{Text:{Data:F.text,Charset:"UTF-8"}}:{},...F.html?{Html:{Data:F.html,Charset:"UTF-8"}}:{}}}}};let V=JSON.stringify(O),P=`https://email.${this.region}.amazonaws.com/v2/email/outbound-emails`,I=await B({method:"POST",url:P,headers:{"content-type":"application/json"},body:V,credentials:{accessKeyId:this.accessKeyId,secretAccessKey:this.secretAccessKey,region:this.region,service:"ses",...this.sessionToken?{sessionToken:this.sessionToken}:{}}}),U=await fetch(P,{method:"POST",headers:I.headers,body:V}),W=await U.json();if(!U.ok)throw new q(W.message??"SES API error",U.status,W.Code??"",U.headers.get("x-amzn-requestid")??"");let _=W.MessageId??"";return{messageId:_,accepted:[...Y,...Z,...Q],rejected:[],response:`MessageId: ${_}`,envelope:{from:X?.address??"",to:Y}}}async verify(){try{let F=`https://email.${this.region}.amazonaws.com/v2/email/configuration-sets`,G=await B({method:"GET",url:F,headers:{},body:"",credentials:{accessKeyId:this.accessKeyId,secretAccessKey:this.secretAccessKey,region:this.region,service:"ses",...this.sessionToken?{sessionToken:this.sessionToken}:{}}}),J=await fetch(F,{method:"GET",headers:G.headers}),X=await J.json().catch(()=>({}));if(!J.ok)return{ok:!1,provider:"ses",message:X.message??`HTTP ${J.status}`};return{ok:!0,provider:"ses",message:"Credentials are valid"}}catch(F){return{ok:!1,provider:"ses",message:F instanceof Error?F.message:String(F)}}}}export{g as SESTransport,q as SESError};
|
|
6
6
|
|
|
7
|
-
//# debugId=
|
|
7
|
+
//# debugId=2D3D31F22A2D609A64756E2164756E21
|
|
@@ -3,9 +3,9 @@
|
|
|
3
3
|
"sources": ["../src/core/sigv4.ts", "../src/transports/ses.ts"],
|
|
4
4
|
"sourcesContent": [
|
|
5
5
|
"/**\n * @module\n * AWS Signature Version 4 signing using Web Crypto (HMAC-SHA256).\n * Works on Node.js, Bun, Deno, and Cloudflare Workers.\n * No external dependencies.\n *\n * @example\n * ```ts\n * import { signRequest } from \"sently/core/sigv4\";\n * const signed = await signRequest({\n * method: \"POST\",\n * url: \"https://email.us-east-1.amazonaws.com/v2/email/outbound-emails\",\n * headers: { \"content-type\": \"application/json\" },\n * body: '{\"...\"}',\n * credentials: { accessKeyId, secretAccessKey, region: \"us-east-1\", service: \"ses\" },\n * });\n * ```\n */\n\n/** AWS credentials and signing scope for SigV4. */\nexport interface SigV4Credentials {\n /** AWS access key ID. */\n accessKeyId: string;\n /** AWS secret access key. */\n secretAccessKey: string;\n /** AWS region (e.g. `us-east-1`). */\n region: string;\n /** AWS service name (e.g. `ses`, `s3`). */\n service: string;\n /** Optional STS session token for temporary credentials. */\n sessionToken?: string;\n}\n\n/** HTTP request to sign with AWS Signature Version 4. */\nexport interface SigV4Request {\n /** HTTP method (e.g. `POST`). */\n method: string;\n /** Full request URL including path and query. */\n url: string;\n /** Request headers to include in the signature. */\n headers: Record<string, string>;\n /** Request body as a string (empty for GET). */\n body: string;\n /** AWS credentials and signing scope. */\n credentials: SigV4Credentials;\n /** Override datetime for testing. Full 'YYYYMMDDTHHMMSSZ' when provided. */\n _date?: string;\n}\n\n/** Signed request headers including Authorization. */\nexport interface SigV4Result {\n /** All headers including Authorization, x-amz-date, and x-amz-security-token */\n headers: Record<string, string>;\n}\n\nconst encoder = new TextEncoder();\n\n/**\n * Compute SHA-256 hash of a string using Web Crypto.\n * Returns lowercase hex string.\n * @internal\n */\nexport async function sha256Hex(data: string): Promise<string> {\n const hash = await crypto.subtle.digest(\"SHA-256\", encoder.encode(data));\n return bytesToHex(new Uint8Array(hash));\n}\n\n/**\n * Compute HMAC-SHA256 using Web Crypto.\n * @internal\n */\nexport async function hmacSHA256(key: Uint8Array | string, data: string): Promise<Uint8Array> {\n const keyBytes = typeof key === \"string\" ? encoder.encode(key) : new Uint8Array(key);\n const cryptoKey = await crypto.subtle.importKey(\n \"raw\",\n keyBytes,\n { name: \"HMAC\", hash: \"SHA-256\" },\n false,\n [\"sign\"],\n );\n const signature = await crypto.subtle.sign(\"HMAC\", cryptoKey, encoder.encode(data));\n return new Uint8Array(signature);\n}\n\n/**\n * Sign an HTTP request with AWS Signature Version 4.\n * Returns the complete set of headers to include in the request.\n */\nexport async function signRequest(request: SigV4Request): Promise<SigV4Result> {\n const { method, url, body, credentials } = request;\n const parsed = new URL(url);\n const amzDate = request._date ?? `${new Date().toISOString().replace(/[-:]/g, \"\").slice(0, 15)}Z`;\n const dateStamp = amzDate.slice(0, 8);\n\n const headers: Record<string, string> = {\n ...Object.fromEntries(\n Object.entries(request.headers).map(([key, value]) => [key.toLowerCase(), value.trim()]),\n ),\n host: parsed.host,\n \"x-amz-date\": amzDate,\n };\n\n if (credentials.sessionToken) {\n headers[\"x-amz-security-token\"] = credentials.sessionToken;\n }\n\n const signedHeaderNames = Object.keys(headers)\n .map((name) => name.toLowerCase())\n .sort();\n const signedHeaders = signedHeaderNames.join(\";\");\n const canonicalHeaders = `${signedHeaderNames.map((name) => `${name}:${headers[name]}`).join(\"\\n\")}\\n`;\n const canonicalQuery = normalizeQuery(parsed.searchParams);\n const payloadHash = await sha256Hex(body);\n const canonicalRequest = [\n method.toUpperCase(),\n canonicalUri(parsed.pathname),\n canonicalQuery,\n canonicalHeaders,\n signedHeaders,\n payloadHash,\n ].join(\"\\n\");\n\n const credentialScope = `${dateStamp}/${credentials.region}/${credentials.service}/aws4_request`;\n const stringToSign = [\n \"AWS4-HMAC-SHA256\",\n amzDate,\n credentialScope,\n await sha256Hex(canonicalRequest),\n ].join(\"\\n\");\n\n const signingKey = await deriveSigningKey(\n credentials.secretAccessKey,\n dateStamp,\n credentials.region,\n credentials.service,\n );\n const signature = bytesToHex(await hmacSHA256(signingKey, stringToSign));\n const authorization = [\n `AWS4-HMAC-SHA256 Credential=${credentials.accessKeyId}/${credentialScope}`,\n `SignedHeaders=${signedHeaders}`,\n `Signature=${signature}`,\n ].join(\", \");\n\n return {\n headers: {\n ...headers,\n Authorization: authorization,\n },\n };\n}\n\nasync function deriveSigningKey(\n secretAccessKey: string,\n dateStamp: string,\n region: string,\n service: string,\n): Promise<Uint8Array> {\n const kDate = await hmacSHA256(`AWS4${secretAccessKey}`, dateStamp);\n const kRegion = await hmacSHA256(kDate, region);\n const kService = await hmacSHA256(kRegion, service);\n return hmacSHA256(kService, \"aws4_request\");\n}\n\nfunction canonicalUri(pathname: string): string {\n if (!pathname || pathname === \"/\") {\n return \"/\";\n }\n return pathname\n .split(\"/\")\n .map((segment) => encodeURIComponent(decodeURIComponent(segment)))\n .join(\"/\");\n}\n\nfunction normalizeQuery(searchParams: URLSearchParams): string {\n const pairs: string[] = [];\n for (const [key, value] of searchParams.entries()) {\n pairs.push(`${encodeRfc3986(key)}=${encodeRfc3986(value)}`);\n }\n pairs.sort();\n return pairs.join(\"&\");\n}\n\nfunction encodeRfc3986(value: string): string {\n return encodeURIComponent(value).replace(\n /[!'()*]/g,\n (char) => `%${char.charCodeAt(0).toString(16).toUpperCase()}`,\n );\n}\n\nfunction bytesToHex(bytes: Uint8Array): string {\n return Array.from(bytes, (byte) => byte.toString(16).padStart(2, \"0\")).join(\"\");\n}\n",
|
|
6
|
-
"/**\n * @module\n * AWS SES v2 HTTP transport for sently.\n * Signs requests with AWS Signature Version 4 using Web Crypto.\n * Works on Node.js, Bun, Deno, and Cloudflare Workers.\n *\n * @example\n * ```ts\n * import { SESTransport } from \"sently/transports/ses\";\n * import { createMailer } from \"sently/mailer\";\n *\n * const mailer = await createMailer({\n * transport: new SESTransport({\n * accessKeyId: process.env.AWS_ACCESS_KEY_ID!,\n * secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY!,\n * region: \"us-east-1\",\n * }),\n * });\n * ```\n */\nimport { extractEmails, parseAddresses, toMIMEHeader } from \"../core/address.js\";\nimport { encodeBase64 } from \"../core/base64.js\";\nimport { httpStatusToSentlyCode, SentlyError } from \"../core/errors.js\";\nimport { buildMIME } from \"../core/mime.js\";\nimport { signRequest } from \"../core/sigv4.js\";\nimport type { MailOptions, SESConfig, SendResult, Transport, VerifyResult } from \"../core/types.js\";\nimport { resolveAttachments } from \"./resolve-attachments.js\";\n\n/** Error thrown when the AWS SES API returns a non-success response. */\nexport class SESError extends SentlyError {\n /** Creates an AWS SES API error with status code, error code, and request ID. */\n constructor(\n message: string,\n public readonly statusCode: number,\n awsCode: string,\n public readonly requestId: string,\n ) {\n super(message, httpStatusToSentlyCode(statusCode), {\n statusCode,\n provider: \"ses\",\n });\n this.name = \"SESError\";\n this.code = awsCode;\n }\n}\n\n/**\n * AWS SES v2 HTTP API transport.\n */\nexport class SESTransport implements Transport {\n /** AWS access key ID for SigV4 signing. */\n private readonly accessKeyId: string;\n /** AWS secret access key for SigV4 signing. */\n private readonly secretAccessKey: string;\n /** AWS region for the SES endpoint. */\n private readonly region: string;\n /** Optional STS session token for temporary credentials. */\n private readonly sessionToken: string | undefined;\n /** Optional DKIM config for raw MIME attachment sends. */\n private readonly dkim: SESConfig[\"dkim\"];\n\n /** Creates an SES transport with AWS credentials. */\n constructor(config: SESConfig) {\n this.accessKeyId = config.accessKeyId;\n this.secretAccessKey = config.secretAccessKey;\n this.region = config.region ?? \"us-east-1\";\n this.sessionToken = config.sessionToken;\n this.dkim = config.dkim;\n }\n\n /** Sends an email via the AWS SES v2 HTTP API. */\n async send(options: MailOptions): Promise<SendResult> {\n const attachments = await resolveAttachments(options.attachments);\n const resolvedOptions = { ...options, attachments };\n const from = parseAddresses(options.from)[0];\n const fromEmail = from ? toMIMEHeader(from) : \"\";\n const toEmails = extractEmails(options.to);\n const ccEmails = options.cc ? extractEmails(options.cc) : [];\n const bccEmails = options.bcc ? extractEmails(options.bcc) : [];\n\n const destination = {\n ToAddresses: toEmails,\n CcAddresses: ccEmails,\n BccAddresses: bccEmails,\n };\n\n let requestBody: Record<string, unknown>;\n\n if (attachments.length > 0) {\n const mime = await buildMIME(resolvedOptions, this.dkim);\n requestBody = {\n FromEmailAddress: fromEmail,\n Destination: destination,\n Content: {\n Raw: {\n Data: encodeBase64(mime.raw).replace(/\\r\\n/g, \"\"),\n },\n },\n };\n } else {\n requestBody = {\n FromEmailAddress: fromEmail,\n Destination: destination,\n Content: {\n Simple: {\n Subject: { Data: options.subject, Charset: \"UTF-8\" },\n Body: {\n ...(options.text ? { Text: { Data: options.text, Charset: \"UTF-8\" } } : {}),\n ...(options.html ? { Html: { Data: options.html, Charset: \"UTF-8\" } } : {}),\n },\n },\n },\n };\n }\n\n const body = JSON.stringify(requestBody);\n const url = `https://email.${this.region}.amazonaws.com/v2/email/outbound-emails`;\n const signed = await signRequest({\n method: \"POST\",\n url,\n headers: {\n \"content-type\": \"application/json\",\n },\n body,\n credentials: {\n accessKeyId: this.accessKeyId,\n secretAccessKey: this.secretAccessKey,\n region: this.region,\n service: \"ses\",\n ...(this.sessionToken ? { sessionToken: this.sessionToken } : {}),\n },\n });\n\n const response = await fetch(url, {\n method: \"POST\",\n headers: signed.headers,\n body,\n });\n\n const payload = (await response.json()) as {\n MessageId?: string;\n message?: string;\n Code?: string;\n };\n\n if (!response.ok) {\n throw new SESError(\n payload.message ?? \"SES API error\",\n response.status,\n payload.Code ?? \"\",\n response.headers.get(\"x-amzn-requestid\") ?? \"\",\n );\n }\n\n const messageId = payload.MessageId ?? \"\";\n return {\n messageId,\n accepted: [...toEmails, ...ccEmails, ...bccEmails],\n rejected: [],\n response: `MessageId: ${messageId}`,\n envelope: {\n from: from?.address ?? \"\",\n to: toEmails,\n },\n };\n }\n\n /** Verifies AWS credentials by listing SES configuration sets. */\n async verify(): Promise<VerifyResult> {\n try {\n const url = `https://email.${this.region}.amazonaws.com/v2/email/configuration-sets`;\n const signed = await signRequest({\n method: \"GET\",\n url,\n headers: {},\n body: \"\",\n credentials: {\n accessKeyId: this.accessKeyId,\n secretAccessKey: this.secretAccessKey,\n region: this.region,\n service: \"ses\",\n ...(this.sessionToken ? { sessionToken: this.sessionToken } : {}),\n },\n });\n\n const response = await fetch(url, {\n method: \"GET\",\n headers: signed.headers,\n });\n\n const payload = (await response.json().catch(() => ({}))) as { message?: string };\n\n if (!response.ok) {\n return {\n ok: false,\n provider: \"ses\",\n message: payload.message ?? `HTTP ${response.status}`,\n };\n }\n\n return { ok: true, provider: \"ses\", message: \"Credentials are valid\" };\n } catch (err) {\n return {\n ok: false,\n provider: \"ses\",\n message: err instanceof Error ? err.message : String(err),\n };\n }\n }\n}\n"
|
|
6
|
+
"/**\n * @module\n * AWS SES v2 HTTP transport for sently.\n * Signs requests with AWS Signature Version 4 using Web Crypto.\n * Works on Node.js, Bun, Deno, and Cloudflare Workers.\n *\n * @example\n * ```ts\n * import { SESTransport } from \"sently/transports/ses\";\n * import { createMailer } from \"sently/mailer\";\n *\n * const mailer = await createMailer({\n * transport: new SESTransport({\n * accessKeyId: process.env.AWS_ACCESS_KEY_ID!,\n * secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY!,\n * region: \"us-east-1\",\n * }),\n * });\n * ```\n */\nimport { extractEmails, parseAddresses, toMIMEHeader } from \"../core/address.js\";\nimport { encodeBase64 } from \"../core/base64.js\";\nimport { httpStatusToSentlyCode, SentlyError } from \"../core/errors.js\";\nimport { buildMIME } from \"../core/mime.js\";\nimport { signRequest } from \"../core/sigv4.js\";\nimport type { MailOptions, SESConfig, SendResult, Transport, VerifyResult } from \"../core/types.js\";\nimport { resolveAttachments } from \"./resolve-attachments.js\";\n\n/** Error thrown when the AWS SES API returns a non-success response. */\nexport class SESError extends SentlyError {\n /** Creates an AWS SES API error with status code, error code, and request ID. */\n constructor(\n message: string,\n public readonly statusCode: number,\n awsCode: string,\n public readonly requestId: string,\n ) {\n super(message, httpStatusToSentlyCode(statusCode), {\n statusCode,\n provider: \"ses\",\n });\n this.name = \"SESError\";\n this.code = awsCode;\n }\n}\n\n/**\n * AWS SES v2 HTTP API transport.\n */\nexport class SESTransport implements Transport {\n readonly provider = \"ses\";\n\n /** AWS access key ID for SigV4 signing. */\n private readonly accessKeyId: string;\n /** AWS secret access key for SigV4 signing. */\n private readonly secretAccessKey: string;\n /** AWS region for the SES endpoint. */\n private readonly region: string;\n /** Optional STS session token for temporary credentials. */\n private readonly sessionToken: string | undefined;\n /** Optional DKIM config for raw MIME attachment sends. */\n private readonly dkim: SESConfig[\"dkim\"];\n\n /** Creates an SES transport with AWS credentials. */\n constructor(config: SESConfig) {\n this.accessKeyId = config.accessKeyId;\n this.secretAccessKey = config.secretAccessKey;\n this.region = config.region ?? \"us-east-1\";\n this.sessionToken = config.sessionToken;\n this.dkim = config.dkim;\n }\n\n /** Sends an email via the AWS SES v2 HTTP API. */\n async send(options: MailOptions): Promise<SendResult> {\n const attachments = await resolveAttachments(options.attachments);\n const resolvedOptions = { ...options, attachments };\n const from = parseAddresses(options.from)[0];\n const fromEmail = from ? toMIMEHeader(from) : \"\";\n const toEmails = extractEmails(options.to);\n const ccEmails = options.cc ? extractEmails(options.cc) : [];\n const bccEmails = options.bcc ? extractEmails(options.bcc) : [];\n\n const destination = {\n ToAddresses: toEmails,\n CcAddresses: ccEmails,\n BccAddresses: bccEmails,\n };\n\n let requestBody: Record<string, unknown>;\n\n if (attachments.length > 0) {\n const mime = await buildMIME(resolvedOptions, this.dkim);\n requestBody = {\n FromEmailAddress: fromEmail,\n Destination: destination,\n Content: {\n Raw: {\n Data: encodeBase64(mime.raw).replace(/\\r\\n/g, \"\"),\n },\n },\n };\n } else {\n requestBody = {\n FromEmailAddress: fromEmail,\n Destination: destination,\n Content: {\n Simple: {\n Subject: { Data: options.subject, Charset: \"UTF-8\" },\n Body: {\n ...(options.text ? { Text: { Data: options.text, Charset: \"UTF-8\" } } : {}),\n ...(options.html ? { Html: { Data: options.html, Charset: \"UTF-8\" } } : {}),\n },\n },\n },\n };\n }\n\n const body = JSON.stringify(requestBody);\n const url = `https://email.${this.region}.amazonaws.com/v2/email/outbound-emails`;\n const signed = await signRequest({\n method: \"POST\",\n url,\n headers: {\n \"content-type\": \"application/json\",\n },\n body,\n credentials: {\n accessKeyId: this.accessKeyId,\n secretAccessKey: this.secretAccessKey,\n region: this.region,\n service: \"ses\",\n ...(this.sessionToken ? { sessionToken: this.sessionToken } : {}),\n },\n });\n\n const response = await fetch(url, {\n method: \"POST\",\n headers: signed.headers,\n body,\n });\n\n const payload = (await response.json()) as {\n MessageId?: string;\n message?: string;\n Code?: string;\n };\n\n if (!response.ok) {\n throw new SESError(\n payload.message ?? \"SES API error\",\n response.status,\n payload.Code ?? \"\",\n response.headers.get(\"x-amzn-requestid\") ?? \"\",\n );\n }\n\n const messageId = payload.MessageId ?? \"\";\n return {\n messageId,\n accepted: [...toEmails, ...ccEmails, ...bccEmails],\n rejected: [],\n response: `MessageId: ${messageId}`,\n envelope: {\n from: from?.address ?? \"\",\n to: toEmails,\n },\n };\n }\n\n /** Verifies AWS credentials by listing SES configuration sets. */\n async verify(): Promise<VerifyResult> {\n try {\n const url = `https://email.${this.region}.amazonaws.com/v2/email/configuration-sets`;\n const signed = await signRequest({\n method: \"GET\",\n url,\n headers: {},\n body: \"\",\n credentials: {\n accessKeyId: this.accessKeyId,\n secretAccessKey: this.secretAccessKey,\n region: this.region,\n service: \"ses\",\n ...(this.sessionToken ? { sessionToken: this.sessionToken } : {}),\n },\n });\n\n const response = await fetch(url, {\n method: \"GET\",\n headers: signed.headers,\n });\n\n const payload = (await response.json().catch(() => ({}))) as { message?: string };\n\n if (!response.ok) {\n return {\n ok: false,\n provider: \"ses\",\n message: payload.message ?? `HTTP ${response.status}`,\n };\n }\n\n return { ok: true, provider: \"ses\", message: \"Credentials are valid\" };\n } catch (err) {\n return {\n ok: false,\n provider: \"ses\",\n message: err instanceof Error ? err.message : String(err),\n };\n }\n }\n}\n"
|
|
7
7
|
],
|
|
8
|
-
"mappings": "
|
|
9
|
-
"debugId": "
|
|
8
|
+
"mappings": "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",
|
|
9
|
+
"debugId": "2D3D31F22A2D609A64756E2164756E21",
|
|
10
10
|
"names": []
|
|
11
11
|
}
|
|
@@ -6,6 +6,7 @@ import type { MailOptions, SendResult, SMTPConfig, SocketAdapter, Transport, Ver
|
|
|
6
6
|
* SMTP transport orchestrating adapter, MIME builder, and protocol logic.
|
|
7
7
|
*/
|
|
8
8
|
export declare class SMTPTransport implements Transport {
|
|
9
|
+
readonly provider = "smtp";
|
|
9
10
|
/** Resolved SMTP configuration with defaults applied. */
|
|
10
11
|
private readonly config;
|
|
11
12
|
/** Active socket adapter for the current session, if any. */
|
package/dist/transports/smtp.js
CHANGED
|
@@ -1,3 +1,3 @@
|
|
|
1
|
-
import{
|
|
1
|
+
import{l as c,m as d,n as e,o as f,p as g,q as h}from"../chunk-vjpds2pf.js";import"../chunk-b602dhck.js";import"../chunk-8dty8c4p.js";import{G as b,w as a}from"../chunk-n0qeyzqm.js";import"../chunk-skqhj0rm.js";import"../chunk-93vqxxj2.js";import"../chunk-ywq6s10g.js";import"../chunk-tamww15j.js";import"../chunk-6npp3x3c.js";export{d as resolveSMTPConfig,h as readSMTPResponse,e as openSMTPSession,b as encodeLine,f as deliverSMTPMessage,g as closeSMTPSession,c as SMTPTransport,a as SMTPError};
|
|
2
2
|
|
|
3
|
-
//# debugId=
|
|
3
|
+
//# debugId=4D50658004631B9764756E2164756E21
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
import { SentlyError } from "../core/errors.js";
|
|
2
|
+
import type { MailOptions, SendResult, Transport, VerifyResult } from "../core/types.js";
|
|
3
|
+
/** Header for a per-message SNDR template ID (`template_id`). */
|
|
4
|
+
export declare const SNDR_TEMPLATE_ID_HEADER = "x-sndr-template-id";
|
|
5
|
+
/** SNDR API configuration. */
|
|
6
|
+
export interface SndrConfig {
|
|
7
|
+
/**
|
|
8
|
+
* SNDR API key (starts with `sndr_live_` or `sndr_test_`).
|
|
9
|
+
* Store in environment variables — never hardcode.
|
|
10
|
+
*/
|
|
11
|
+
apiKey: string;
|
|
12
|
+
/** API base URL. Default: `https://api.sndr.sh`. */
|
|
13
|
+
baseUrl?: string;
|
|
14
|
+
/**
|
|
15
|
+
* Default SNDR template ID when not set per message via
|
|
16
|
+
* {@link SNDR_TEMPLATE_ID_HEADER}.
|
|
17
|
+
*/
|
|
18
|
+
defaultTemplateId?: string;
|
|
19
|
+
}
|
|
20
|
+
/** Error thrown when the SNDR API returns a non-success response. */
|
|
21
|
+
export declare class SndrError extends SentlyError {
|
|
22
|
+
readonly statusCode: number;
|
|
23
|
+
readonly apiError: unknown;
|
|
24
|
+
/** Creates an SNDR API error with status code and response payload. */
|
|
25
|
+
constructor(message: string, statusCode: number, apiError: unknown);
|
|
26
|
+
}
|
|
27
|
+
/**
|
|
28
|
+
* SNDR HTTP API transport.
|
|
29
|
+
*/
|
|
30
|
+
export declare class SndrTransport implements Transport {
|
|
31
|
+
readonly provider = "sndr";
|
|
32
|
+
private readonly apiKey;
|
|
33
|
+
private readonly baseUrl;
|
|
34
|
+
private readonly defaultTemplateId?;
|
|
35
|
+
/** Creates an SNDR transport with the given API key. */
|
|
36
|
+
constructor(config: SndrConfig);
|
|
37
|
+
/** Sends an email via `POST /v1/send`. */
|
|
38
|
+
send(options: MailOptions): Promise<SendResult>;
|
|
39
|
+
/** Verifies the API key by listing domains (`GET /v1/domains`). */
|
|
40
|
+
verify(): Promise<VerifyResult>;
|
|
41
|
+
}
|
|
@@ -0,0 +1,3 @@
|
|
|
1
|
+
import{H as V}from"../chunk-8njyga62.js";import{Q as W,R as Z,S as B}from"../chunk-93vqxxj2.js";import"../chunk-ywq6s10g.js";import{ca as $,da as G}from"../chunk-tamww15j.js";import"../chunk-6npp3x3c.js";var Y="x-sndr-template-id";class v extends ${statusCode;apiError;constructor(q,w,F){super(q,G(w),{statusCode:w,provider:"sndr",cause:F});this.statusCode=w;this.apiError=F;this.name="SndrError"}}class j{provider="sndr";apiKey;baseUrl;defaultTemplateId;constructor(q){if(this.apiKey=q.apiKey,this.baseUrl=(q.baseUrl??"https://api.sndr.sh").replace(/\/+$/,""),q.defaultTemplateId!==void 0)this.defaultTemplateId=q.defaultTemplateId}async send(q){let w=W(q.from)[0],F=B(q.to),O=q.headers?.[Y]??this.defaultTemplateId,J={from:w?Z(w):"",to:F,subject:q.subject,...q.cc?{cc:B(q.cc)}:{},...q.bcc?{bcc:B(q.bcc)}:{},...q.replyTo?{reply_to:(()=>{return W(q.replyTo)[0]?.address})()}:{},...q.html?{html:q.html}:{},...q.text?{text:q.text}:{},...O?{template_id:O}:{},...O&&q.data?{variables:q.data}:{}};if(q.headers){let U=Object.fromEntries(Object.entries(q.headers).filter(([N])=>N!==Y));if(Object.keys(U).length>0)J.headers=U}if(J.reply_to===void 0)delete J.reply_to;let X=V(q),Q=await fetch(`${this.baseUrl}/v1/send`,{method:"POST",headers:{Authorization:`Bearer ${this.apiKey}`,"Content-Type":"application/json",Accept:"application/json",...X?{"Idempotency-Key":X}:{}},body:JSON.stringify(J)}),z=await Q.json().catch(()=>({}));if(!Q.ok)throw new v(z.error?.message??z.message??"SNDR API error",Q.status,z);let L=w?.address??"";return{messageId:z.id??q.messageId??"",accepted:F,rejected:[],response:z.status??z.id??"queued",envelope:{from:L,to:[...F,...q.cc?B(q.cc):[],...q.bcc?B(q.bcc):[]]}}}async verify(){try{let q=await fetch(`${this.baseUrl}/v1/domains`,{headers:{Authorization:`Bearer ${this.apiKey}`,Accept:"application/json"}});if(!q.ok){let w=await q.json().catch(()=>({}));return{ok:!1,provider:"sndr",message:w.error?.message??w.message??`HTTP ${q.status}`}}return{ok:!0,provider:"sndr",message:"API key is valid"}}catch(q){return{ok:!1,provider:"sndr",message:q instanceof Error?q.message:String(q)}}}}export{j as SndrTransport,v as SndrError,Y as SNDR_TEMPLATE_ID_HEADER};
|
|
2
|
+
|
|
3
|
+
//# debugId=6475E854D5CE8CE864756E2164756E21
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
{
|
|
2
|
+
"version": 3,
|
|
3
|
+
"sources": ["../src/transports/sndr.ts"],
|
|
4
|
+
"sourcesContent": [
|
|
5
|
+
"/**\n * @module\n * SNDR HTTP API transport for sending email via api.sndr.sh.\n *\n * Aligned with the official SNDR API / `@rkiza/sndr` SDK:\n * `POST /v1/send` with Bearer auth and optional `Idempotency-Key`.\n *\n * @see https://www.sndr.sh/docs/api-reference\n *\n * @example\n * ```ts\n * import { SndrTransport } from \"sently/transports/sndr\";\n * import { createMailer } from \"sently/mailer\";\n *\n * const mailer = await createMailer({\n * transport: new SndrTransport({ apiKey: process.env.SNDR_API_KEY! }),\n * });\n *\n * await mailer.send({\n * from: \"hello@yourdomain.com\",\n * to: \"customer@example.com\",\n * subject: \"Welcome aboard\",\n * html: \"<p>Thanks for joining us.</p>\",\n * });\n * ```\n */\nimport { extractEmails, parseAddresses, toMIMEHeader } from \"../core/address.js\";\nimport { httpStatusToSentlyCode, SentlyError } from \"../core/errors.js\";\nimport { resolveIdempotencyKey } from \"../core/idempotency-key.js\";\nimport type { MailOptions, SendResult, Transport, VerifyResult } from \"../core/types.js\";\n\n/** Header for a per-message SNDR template ID (`template_id`). */\nexport const SNDR_TEMPLATE_ID_HEADER = \"x-sndr-template-id\";\n\n/** SNDR API configuration. */\nexport interface SndrConfig {\n /**\n * SNDR API key (starts with `sndr_live_` or `sndr_test_`).\n * Store in environment variables — never hardcode.\n */\n apiKey: string;\n /** API base URL. Default: `https://api.sndr.sh`. */\n baseUrl?: string;\n /**\n * Default SNDR template ID when not set per message via\n * {@link SNDR_TEMPLATE_ID_HEADER}.\n */\n defaultTemplateId?: string;\n}\n\n/** Error thrown when the SNDR API returns a non-success response. */\nexport class SndrError extends SentlyError {\n /** Creates an SNDR API error with status code and response payload. */\n constructor(\n message: string,\n public readonly statusCode: number,\n public readonly apiError: unknown,\n ) {\n super(message, httpStatusToSentlyCode(statusCode), {\n statusCode,\n provider: \"sndr\",\n cause: apiError,\n });\n this.name = \"SndrError\";\n }\n}\n\n/**\n * SNDR HTTP API transport.\n */\nexport class SndrTransport implements Transport {\n readonly provider = \"sndr\";\n\n private readonly apiKey: string;\n private readonly baseUrl: string;\n private readonly defaultTemplateId?: string;\n\n /** Creates an SNDR transport with the given API key. */\n constructor(config: SndrConfig) {\n this.apiKey = config.apiKey;\n this.baseUrl = (config.baseUrl ?? \"https://api.sndr.sh\").replace(/\\/+$/, \"\");\n if (config.defaultTemplateId !== undefined) {\n this.defaultTemplateId = config.defaultTemplateId;\n }\n }\n\n /** Sends an email via `POST /v1/send`. */\n async send(options: MailOptions): Promise<SendResult> {\n const from = parseAddresses(options.from)[0];\n const to = extractEmails(options.to);\n const templateId = options.headers?.[SNDR_TEMPLATE_ID_HEADER] ?? this.defaultTemplateId;\n\n const body: Record<string, unknown> = {\n from: from ? toMIMEHeader(from) : \"\",\n to,\n subject: options.subject,\n ...(options.cc ? { cc: extractEmails(options.cc) } : {}),\n ...(options.bcc ? { bcc: extractEmails(options.bcc) } : {}),\n ...(options.replyTo\n ? {\n reply_to: (() => {\n const reply = parseAddresses(options.replyTo as MailOptions[\"to\"])[0];\n return reply?.address;\n })(),\n }\n : {}),\n ...(options.html ? { html: options.html } : {}),\n ...(options.text ? { text: options.text } : {}),\n ...(templateId ? { template_id: templateId } : {}),\n ...(templateId && options.data ? { variables: options.data } : {}),\n };\n\n if (options.headers) {\n const headers = Object.fromEntries(\n Object.entries(options.headers).filter(([key]) => key !== SNDR_TEMPLATE_ID_HEADER),\n );\n if (Object.keys(headers).length > 0) {\n body.headers = headers;\n }\n }\n\n // Drop undefined reply_to when parse failed.\n if (body.reply_to === undefined) {\n delete body.reply_to;\n }\n\n const idempotencyKey = resolveIdempotencyKey(options);\n\n const response = await fetch(`${this.baseUrl}/v1/send`, {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${this.apiKey}`,\n \"Content-Type\": \"application/json\",\n Accept: \"application/json\",\n ...(idempotencyKey ? { \"Idempotency-Key\": idempotencyKey } : {}),\n },\n body: JSON.stringify(body),\n });\n\n const payload = (await response.json().catch(() => ({}))) as {\n id?: string;\n status?: string;\n error?: { code?: string; message?: string; request_id?: string };\n message?: string;\n };\n\n if (!response.ok) {\n throw new SndrError(\n payload.error?.message ?? payload.message ?? \"SNDR API error\",\n response.status,\n payload,\n );\n }\n\n const fromAddress = from?.address ?? \"\";\n return {\n messageId: payload.id ?? options.messageId ?? \"\",\n accepted: to,\n rejected: [],\n response: payload.status ?? payload.id ?? \"queued\",\n envelope: {\n from: fromAddress,\n to: [\n ...to,\n ...(options.cc ? extractEmails(options.cc) : []),\n ...(options.bcc ? extractEmails(options.bcc) : []),\n ],\n },\n };\n }\n\n /** Verifies the API key by listing domains (`GET /v1/domains`). */\n async verify(): Promise<VerifyResult> {\n try {\n const response = await fetch(`${this.baseUrl}/v1/domains`, {\n headers: {\n Authorization: `Bearer ${this.apiKey}`,\n Accept: \"application/json\",\n },\n });\n\n if (!response.ok) {\n const payload = (await response.json().catch(() => ({}))) as {\n error?: { message?: string };\n message?: string;\n };\n return {\n ok: false,\n provider: \"sndr\",\n message: payload.error?.message ?? payload.message ?? `HTTP ${response.status}`,\n };\n }\n\n return { ok: true, provider: \"sndr\", message: \"API key is valid\" };\n } catch (err) {\n return {\n ok: false,\n provider: \"sndr\",\n message: err instanceof Error ? err.message : String(err),\n };\n }\n }\n}\n"
|
|
6
|
+
],
|
|
7
|
+
"mappings": "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",
|
|
8
|
+
"debugId": "6475E854D5CE8CE864756E2164756E21",
|
|
9
|
+
"names": []
|
|
10
|
+
}
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
import { SentlyError } from "../core/errors.js";
|
|
2
|
+
import type { MailOptions, SendResult, Transport, VerifyResult } from "../core/types.js";
|
|
3
|
+
/** SparkPost HTTP API configuration. */
|
|
4
|
+
export interface SparkPostConfig {
|
|
5
|
+
/** SparkPost API key (raw key — no Bearer prefix). */
|
|
6
|
+
apiKey: string;
|
|
7
|
+
/** When true, use the EU API host (`api.eu.sparkpost.com`). */
|
|
8
|
+
euRegion?: boolean;
|
|
9
|
+
}
|
|
10
|
+
/** Error thrown when the SparkPost API returns a non-success response. */
|
|
11
|
+
export declare class SparkPostError extends SentlyError {
|
|
12
|
+
readonly statusCode: number;
|
|
13
|
+
readonly errors: unknown;
|
|
14
|
+
/** Creates a SparkPost API error with status code and error details. */
|
|
15
|
+
constructor(message: string, statusCode: number, errors: unknown);
|
|
16
|
+
}
|
|
17
|
+
/**
|
|
18
|
+
* SparkPost HTTP API transport.
|
|
19
|
+
*/
|
|
20
|
+
export declare class SparkPostTransport implements Transport {
|
|
21
|
+
readonly provider = "sparkpost";
|
|
22
|
+
private readonly apiKey;
|
|
23
|
+
private readonly baseUrl;
|
|
24
|
+
/** Creates a SparkPost transport with the given API key. */
|
|
25
|
+
constructor(config: SparkPostConfig);
|
|
26
|
+
/** Sends an email via the SparkPost transmissions API. */
|
|
27
|
+
send(options: MailOptions): Promise<SendResult>;
|
|
28
|
+
/** Verifies the SparkPost API key by fetching account info. */
|
|
29
|
+
verify(): Promise<VerifyResult>;
|
|
30
|
+
}
|
|
@@ -0,0 +1,3 @@
|
|
|
1
|
+
import{I as X}from"../chunk-skqhj0rm.js";import{Q as G,R as Q,S as F}from"../chunk-93vqxxj2.js";import{Y as O}from"../chunk-ywq6s10g.js";import{ca as U,da as W}from"../chunk-tamww15j.js";import"../chunk-6npp3x3c.js";class Y extends U{statusCode;errors;constructor(q,z,w){super(q,W(z),{statusCode:z,provider:"sparkpost",cause:w});this.statusCode=z;this.errors=w;this.name="SparkPostError"}}function _(q){return[...G(q.to),...q.cc?G(q.cc):[],...q.bcc?G(q.bcc):[]].map((w)=>({address:{email:w.address,...w.name?{name:w.name}:{}}}))}class ${provider="sparkpost";apiKey;baseUrl;constructor(q){this.apiKey=q.apiKey,this.baseUrl=q.euRegion?"https://api.eu.sparkpost.com":"https://api.sparkpost.com"}async send(q){let z=await X(q.attachments),w=G(q.from)[0],Z={content:{from:w?Q(w):"",subject:q.subject,...q.html?{html:q.html}:{},...q.text?{text:q.text}:{},...q.replyTo?{reply_to:F(q.replyTo)[0]}:{},...z.length>0?{attachments:z.map((D)=>({type:D.contentType??"application/octet-stream",name:D.filename,data:D.content instanceof Uint8Array?O(D.content).replace(/\r\n/g,""):D.content}))}:{}},recipients:_(q)},K=await fetch(`${this.baseUrl}/api/v1/transmissions`,{method:"POST",headers:{Authorization:this.apiKey,"Content-Type":"application/json"},body:JSON.stringify(Z)}),J=await K.json();if(!K.ok)throw new Y(J.message??"SparkPost API error",K.status,J.errors??J);let L=J.results?.id??"",N=[...F(q.to),...q.cc?F(q.cc):[],...q.bcc?F(q.bcc):[]];return{messageId:L,accepted:N,rejected:[],response:L||"sent",envelope:{from:w?.address??"",to:N}}}async verify(){try{let q=await fetch(`${this.baseUrl}/api/v1/account`,{headers:{Authorization:this.apiKey}});if(!q.ok){let z=await q.json().catch(()=>({}));return{ok:!1,provider:"sparkpost",message:z.errors?.[0]?.message??z.message??`HTTP ${q.status}`}}return{ok:!0,provider:"sparkpost",message:"API key is valid"}}catch(q){return{ok:!1,provider:"sparkpost",message:q instanceof Error?q.message:String(q)}}}}export{$ as SparkPostTransport,Y as SparkPostError};
|
|
2
|
+
|
|
3
|
+
//# debugId=45DD34E196570CD864756E2164756E21
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
{
|
|
2
|
+
"version": 3,
|
|
3
|
+
"sources": ["../src/transports/sparkpost.ts"],
|
|
4
|
+
"sourcesContent": [
|
|
5
|
+
"/**\n * @module\n * SparkPost HTTP transport for sently.\n *\n * v1 simplification: all `to`, `cc`, and `bcc` addresses are placed in\n * `recipients[]` without SparkPost `header_to` handling for cc/bcc routing.\n *\n * @example\n * ```ts\n * import { SparkPostTransport } from \"sently/transports/sparkpost\";\n * import { createMailer } from \"sently/mailer\";\n *\n * const mailer = await createMailer({\n * transport: new SparkPostTransport({ apiKey: process.env.SPARKPOST_API_KEY! }),\n * });\n * ```\n */\nimport { extractEmails, parseAddresses, toMIMEHeader } from \"../core/address.js\";\nimport { encodeBase64 } from \"../core/base64.js\";\nimport { httpStatusToSentlyCode, SentlyError } from \"../core/errors.js\";\nimport type { MailOptions, SendResult, Transport, VerifyResult } from \"../core/types.js\";\nimport { resolveAttachments } from \"./resolve-attachments.js\";\n\n/** SparkPost HTTP API configuration. */\nexport interface SparkPostConfig {\n /** SparkPost API key (raw key — no Bearer prefix). */\n apiKey: string;\n /** When true, use the EU API host (`api.eu.sparkpost.com`). */\n euRegion?: boolean;\n}\n\n/** Error thrown when the SparkPost API returns a non-success response. */\nexport class SparkPostError extends SentlyError {\n /** Creates a SparkPost API error with status code and error details. */\n constructor(\n message: string,\n public readonly statusCode: number,\n public readonly errors: unknown,\n ) {\n super(message, httpStatusToSentlyCode(statusCode), {\n statusCode,\n provider: \"sparkpost\",\n cause: errors,\n });\n this.name = \"SparkPostError\";\n }\n}\n\nfunction toRecipients(options: MailOptions): Array<{ address: { email: string; name?: string } }> {\n const addresses = [\n ...parseAddresses(options.to),\n ...(options.cc ? parseAddresses(options.cc) : []),\n ...(options.bcc ? parseAddresses(options.bcc) : []),\n ];\n\n return addresses.map((addr) => ({\n address: {\n email: addr.address,\n ...(addr.name ? { name: addr.name } : {}),\n },\n }));\n}\n\n/**\n * SparkPost HTTP API transport.\n */\nexport class SparkPostTransport implements Transport {\n readonly provider = \"sparkpost\";\n\n private readonly apiKey: string;\n private readonly baseUrl: string;\n\n /** Creates a SparkPost transport with the given API key. */\n constructor(config: SparkPostConfig) {\n this.apiKey = config.apiKey;\n this.baseUrl = config.euRegion ? \"https://api.eu.sparkpost.com\" : \"https://api.sparkpost.com\";\n }\n\n /** Sends an email via the SparkPost transmissions API. */\n async send(options: MailOptions): Promise<SendResult> {\n const attachments = await resolveAttachments(options.attachments);\n const from = parseAddresses(options.from)[0];\n\n const content: Record<string, unknown> = {\n from: from ? toMIMEHeader(from) : \"\",\n subject: options.subject,\n ...(options.html ? { html: options.html } : {}),\n ...(options.text ? { text: options.text } : {}),\n ...(options.replyTo ? { reply_to: extractEmails(options.replyTo)[0] } : {}),\n ...(attachments.length > 0\n ? {\n attachments: attachments.map((att) => ({\n type: att.contentType ?? \"application/octet-stream\",\n name: att.filename,\n data:\n att.content instanceof Uint8Array\n ? encodeBase64(att.content).replace(/\\r\\n/g, \"\")\n : att.content,\n })),\n }\n : {}),\n };\n\n const body = {\n content,\n recipients: toRecipients(options),\n };\n\n const response = await fetch(`${this.baseUrl}/api/v1/transmissions`, {\n method: \"POST\",\n headers: {\n Authorization: this.apiKey,\n \"Content-Type\": \"application/json\",\n },\n body: JSON.stringify(body),\n });\n\n const payload = (await response.json()) as {\n results?: { id?: string; total_accepted_recipients?: number };\n errors?: unknown;\n message?: string;\n };\n\n if (!response.ok) {\n throw new SparkPostError(\n payload.message ?? \"SparkPost API error\",\n response.status,\n payload.errors ?? payload,\n );\n }\n\n const messageId = payload.results?.id ?? \"\";\n const toEmails = [\n ...extractEmails(options.to),\n ...(options.cc ? extractEmails(options.cc) : []),\n ...(options.bcc ? extractEmails(options.bcc) : []),\n ];\n\n return {\n messageId,\n accepted: toEmails,\n rejected: [],\n response: messageId || \"sent\",\n envelope: {\n from: from?.address ?? \"\",\n to: toEmails,\n },\n };\n }\n\n /** Verifies the SparkPost API key by fetching account info. */\n async verify(): Promise<VerifyResult> {\n try {\n const response = await fetch(`${this.baseUrl}/api/v1/account`, {\n headers: {\n Authorization: this.apiKey,\n },\n });\n\n if (!response.ok) {\n const payload = (await response.json().catch(() => ({}))) as {\n errors?: Array<{ message?: string }>;\n message?: string;\n };\n const errMsg = payload.errors?.[0]?.message ?? payload.message ?? `HTTP ${response.status}`;\n return {\n ok: false,\n provider: \"sparkpost\",\n message: errMsg,\n };\n }\n\n return { ok: true, provider: \"sparkpost\", message: \"API key is valid\" };\n } catch (err) {\n return {\n ok: false,\n provider: \"sparkpost\",\n message: err instanceof Error ? err.message : String(err),\n };\n }\n }\n}\n"
|
|
6
|
+
],
|
|
7
|
+
"mappings": "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",
|
|
8
|
+
"debugId": "45DD34E196570CD864756E2164756E21",
|
|
9
|
+
"names": []
|
|
10
|
+
}
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
import { SentlyError } from "../core/errors.js";
|
|
2
|
+
import type { MailOptions, SendResult, Transport, VerifyResult } from "../core/types.js";
|
|
3
|
+
/** Taqnyat Email API configuration. */
|
|
4
|
+
export interface TaqnyatMailConfig {
|
|
5
|
+
/** Bearer token from a Taqnyat application enabled for Email (`bearerTokens`). */
|
|
6
|
+
bearerToken: string;
|
|
7
|
+
/**
|
|
8
|
+
* Campaign name required by `mailSend.php`.
|
|
9
|
+
* Must be consistent across channels when using Taqnyat failover features.
|
|
10
|
+
*/
|
|
11
|
+
campaignName: string;
|
|
12
|
+
}
|
|
13
|
+
/** Error thrown when the Taqnyat Email API reports a failure. */
|
|
14
|
+
export declare class TaqnyatMailError extends SentlyError {
|
|
15
|
+
readonly statusCode: number;
|
|
16
|
+
readonly apiError: unknown;
|
|
17
|
+
/** Creates a Taqnyat Email API error with status code and response payload. */
|
|
18
|
+
constructor(message: string, statusCode: number, apiError: unknown);
|
|
19
|
+
}
|
|
20
|
+
/**
|
|
21
|
+
* Taqnyat Email transport via `mailSend.php`.
|
|
22
|
+
*/
|
|
23
|
+
export declare class TaqnyatMailTransport implements Transport {
|
|
24
|
+
readonly provider = "taqnyat-mail";
|
|
25
|
+
private readonly bearerToken;
|
|
26
|
+
private readonly campaignName;
|
|
27
|
+
/** Creates a Taqnyat Email transport. */
|
|
28
|
+
constructor(config: TaqnyatMailConfig);
|
|
29
|
+
/** Sends an email via Taqnyat `mailSend.php`. */
|
|
30
|
+
send(options: MailOptions): Promise<SendResult>;
|
|
31
|
+
/** Lightweight credential check. */
|
|
32
|
+
verify(): Promise<VerifyResult>;
|
|
33
|
+
}
|
|
@@ -0,0 +1,3 @@
|
|
|
1
|
+
import{Q as H,S as I}from"../chunk-93vqxxj2.js";import"../chunk-ywq6s10g.js";import{ca as J,da as K}from"../chunk-tamww15j.js";import"../chunk-6npp3x3c.js";class D extends J{statusCode;apiError;constructor(b,z,B){super(b,K(z>=100&&z<600?z:400),{statusCode:z,provider:"taqnyat-mail",cause:B});this.statusCode=z;this.apiError=B;this.name="TaqnyatMailError"}}class P{provider="taqnyat-mail";bearerToken;campaignName;constructor(b){this.bearerToken=b.bearerToken,this.campaignName=b.campaignName}async send(b){let z=H(b.from)[0],B=b.html??b.text;if(!B)throw new D("Taqnyat mail requires html or text body",400,{message:"Missing body"});if(!z?.address)throw new D("Taqnyat mail requires a from address",400,{message:"Missing from"});let F=I(b.to),N=new URLSearchParams({bearerTokens:this.bearerToken,campaignName:this.campaignName,subject:b.subject,from:z.address,to:F.join(","),msg:B}),G=await fetch("https://api.taqnyat.sa/mailSend.php",{method:"POST",headers:{Authorization:`Bearer ${this.bearerToken}`,"Content-Type":"application/x-www-form-urlencoded"},body:N}),v=await G.json();if(!(v.ResponseStatus==="success"&&v.Data!=null&&v.Error==null)){let O=v.Error?.MessageEn?.trim()||v.Error?.MessageAr?.trim()||"Taqnyat Email API error";throw new D(O,v.Error?.ErrorCode??(G.ok?400:G.status),v)}return{messageId:String(v.Data?.msgId??b.messageId??""),accepted:F,rejected:[],response:v.Data?.MessageEn??"sent successfully",envelope:{from:z.address,to:F},provider:"taqnyat-mail"}}async verify(){return{ok:Boolean(this.bearerToken&&this.campaignName),provider:"taqnyat-mail",message:this.bearerToken&&this.campaignName?"Credentials present":"Missing credentials"}}}export{P as TaqnyatMailTransport,D as TaqnyatMailError};
|
|
2
|
+
|
|
3
|
+
//# debugId=BC80D2F97553209A64756E2164756E21
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
{
|
|
2
|
+
"version": 3,
|
|
3
|
+
"sources": ["../src/transports/taqnyat-mail.ts"],
|
|
4
|
+
"sourcesContent": [
|
|
5
|
+
"/**\n * @module\n * Taqnyat Email API transport (`mailSend.php`).\n *\n * Follows [Taqnyat Email](https://dev.taqnyat.sa/ar/doc/mail/):\n * `POST https://api.taqnyat.sa/mailSend.php` with `bearerTokens`, `campaignName`,\n * `subject`, `from`, `to`, `msg`. Success: HTTP 201 + `ResponseStatus: \"success\"`\n * and `Data.msgId`.\n *\n * Sently-first: wire into {@link createMailer}.\n *\n * @example\n * ```ts\n * import { createMailer } from \"sently/mailer\";\n * import { TaqnyatMailTransport } from \"sently/transports/taqnyat-mail\";\n *\n * const mailer = await createMailer({\n * transport: new TaqnyatMailTransport({\n * bearerToken: process.env.TAQNYAT_MAIL_TOKEN!,\n * campaignName: \"transactional\",\n * }),\n * });\n * ```\n */\nimport { extractEmails, parseAddresses } from \"../core/address.js\";\nimport { httpStatusToSentlyCode, SentlyError } from \"../core/errors.js\";\nimport type { MailOptions, SendResult, Transport, VerifyResult } from \"../core/types.js\";\n\n/** Taqnyat Email API configuration. */\nexport interface TaqnyatMailConfig {\n /** Bearer token from a Taqnyat application enabled for Email (`bearerTokens`). */\n bearerToken: string;\n /**\n * Campaign name required by `mailSend.php`.\n * Must be consistent across channels when using Taqnyat failover features.\n */\n campaignName: string;\n}\n\n/** Error thrown when the Taqnyat Email API reports a failure. */\nexport class TaqnyatMailError extends SentlyError {\n /** Creates a Taqnyat Email API error with status code and response payload. */\n constructor(\n message: string,\n public readonly statusCode: number,\n public readonly apiError: unknown,\n ) {\n super(\n message,\n httpStatusToSentlyCode(statusCode >= 100 && statusCode < 600 ? statusCode : 400),\n {\n statusCode,\n provider: \"taqnyat-mail\",\n cause: apiError,\n },\n );\n this.name = \"TaqnyatMailError\";\n }\n}\n\n/**\n * Taqnyat Email transport via `mailSend.php`.\n */\nexport class TaqnyatMailTransport implements Transport {\n readonly provider = \"taqnyat-mail\";\n\n private readonly bearerToken: string;\n private readonly campaignName: string;\n\n /** Creates a Taqnyat Email transport. */\n constructor(config: TaqnyatMailConfig) {\n this.bearerToken = config.bearerToken;\n this.campaignName = config.campaignName;\n }\n\n /** Sends an email via Taqnyat `mailSend.php`. */\n async send(options: MailOptions): Promise<SendResult> {\n const from = parseAddresses(options.from)[0];\n const msg = options.html ?? options.text;\n if (!msg) {\n throw new TaqnyatMailError(\"Taqnyat mail requires html or text body\", 400, {\n message: \"Missing body\",\n });\n }\n if (!from?.address) {\n throw new TaqnyatMailError(\"Taqnyat mail requires a from address\", 400, {\n message: \"Missing from\",\n });\n }\n\n const toList = extractEmails(options.to);\n // Docs examples: plain email addresses + comma-separated `to`, `bearerTokens` param.\n const params = new URLSearchParams({\n bearerTokens: this.bearerToken,\n campaignName: this.campaignName,\n subject: options.subject,\n from: from.address,\n to: toList.join(\",\"),\n msg,\n });\n\n const response = await fetch(\"https://api.taqnyat.sa/mailSend.php\", {\n method: \"POST\",\n headers: {\n // Auth section: Bearer for REST; examples also pass bearerTokens in the body.\n Authorization: `Bearer ${this.bearerToken}`,\n \"Content-Type\": \"application/x-www-form-urlencoded\",\n },\n body: params,\n });\n\n const payload = (await response.json()) as {\n status?: number;\n ResponseStatus?: string;\n Data?: {\n msgId?: number | string;\n MessageEn?: string;\n MessageAr?: string;\n price?: string;\n } | null;\n Error?: {\n ErrorCode?: number;\n MessageEn?: string;\n MessageAr?: string;\n } | null;\n };\n\n const succeeded =\n payload.ResponseStatus === \"success\" && payload.Data != null && payload.Error == null;\n\n if (!succeeded) {\n const message =\n payload.Error?.MessageEn?.trim() ||\n payload.Error?.MessageAr?.trim() ||\n \"Taqnyat Email API error\";\n throw new TaqnyatMailError(\n message,\n payload.Error?.ErrorCode ?? (response.ok ? 400 : response.status),\n payload,\n );\n }\n\n return {\n messageId: String(payload.Data?.msgId ?? options.messageId ?? \"\"),\n accepted: toList,\n rejected: [],\n response: payload.Data?.MessageEn ?? \"sent successfully\",\n envelope: {\n from: from.address,\n to: toList,\n },\n provider: \"taqnyat-mail\",\n };\n }\n\n /** Lightweight credential check. */\n async verify(): Promise<VerifyResult> {\n return {\n ok: Boolean(this.bearerToken && this.campaignName),\n provider: \"taqnyat-mail\",\n message:\n this.bearerToken && this.campaignName ? \"Credentials present\" : \"Missing credentials\",\n };\n }\n}\n"
|
|
6
|
+
],
|
|
7
|
+
"mappings": "2KAwCO,CAAM,KAAyB,JAAY,CAI9B,WACA,SAHlB,WAAW,CACT,EACgB,EACA,EAChB,CACA,MACE,EACA,EAAuB,GAAc,KAAO,EAAa,IAAM,EAAa,GAAG,EAC/E,CACE,aACA,SAAU,eACV,MAAO,CACT,CACF,EAXgB,kBACA,gBAWhB,KAAK,KAAO,mBAEhB,CAKO,MAAM,CAA0C,CAC5C,SAAW,eAEH,YACA,aAGjB,WAAW,CAAC,EAA2B,CACrC,KAAK,YAAc,EAAO,YAC1B,KAAK,aAAe,EAAO,kBAIvB,KAAI,CAAC,EAA2C,CACpD,IAAM,EAAO,EAAe,EAAQ,IAAI,EAAE,GACpC,EAAM,EAAQ,MAAQ,EAAQ,KACpC,GAAI,CAAC,EACH,MAAM,IAAI,EAAiB,0CAA2C,IAAK,CACzE,QAAS,cACX,CAAC,EAEH,GAAI,CAAC,GAAM,QACT,MAAM,IAAI,EAAiB,uCAAwC,IAAK,CACtE,QAAS,cACX,CAAC,EAGH,IAAM,EAAS,EAAc,EAAQ,EAAE,EAEjC,EAAS,IAAI,gBAAgB,CACjC,aAAc,KAAK,YACnB,aAAc,KAAK,aACnB,QAAS,EAAQ,QACjB,KAAM,EAAK,QACX,GAAI,EAAO,KAAK,GAAG,EACnB,KACF,CAAC,EAEK,EAAW,MAAM,MAAM,sCAAuC,CAClE,OAAQ,OACR,QAAS,CAEP,cAAe,UAAU,KAAK,cAC9B,eAAgB,mCAClB,EACA,KAAM,CACR,CAAC,EAEK,EAAW,MAAM,EAAS,KAAK,EAmBrC,GAAI,EAFF,EAAQ,iBAAmB,WAAa,EAAQ,MAAQ,MAAQ,EAAQ,OAAS,MAEnE,CACd,IAAM,EACJ,EAAQ,OAAO,WAAW,KAAK,GAC/B,EAAQ,OAAO,WAAW,KAAK,GAC/B,0BACF,MAAM,IAAI,EACR,EACA,EAAQ,OAAO,YAAc,EAAS,GAAK,IAAM,EAAS,QAC1D,CACF,EAGF,MAAO,CACL,UAAW,OAAO,EAAQ,MAAM,OAAS,EAAQ,WAAa,EAAE,EAChE,SAAU,EACV,SAAU,CAAC,EACX,SAAU,EAAQ,MAAM,WAAa,oBACrC,SAAU,CACR,KAAM,EAAK,QACX,GAAI,CACN,EACA,SAAU,cACZ,OAII,OAAM,EAA0B,CACpC,MAAO,CACL,GAAI,QAAQ,KAAK,aAAe,KAAK,YAAY,EACjD,SAAU,eACV,QACE,KAAK,aAAe,KAAK,aAAe,sBAAwB,qBACpE,EAEJ",
|
|
8
|
+
"debugId": "BC80D2F97553209A64756E2164756E21",
|
|
9
|
+
"names": []
|
|
10
|
+
}
|
|
@@ -0,0 +1,131 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @module
|
|
3
|
+
* Taqnyat SMS API transport (Saudi Arabia).
|
|
4
|
+
*
|
|
5
|
+
* Request/response shapes follow
|
|
6
|
+
* [Taqnyat SMS](https://dev.taqnyat.sa/en/doc/sms/) and
|
|
7
|
+
* [Verify](https://dev.taqnyat.sa/en/doc/verify/):
|
|
8
|
+
* - SMS: `POST /v1/messages` with Bearer + JSON (`recipients`, `body`, `sender`)
|
|
9
|
+
* - OTP: `POST /verify.php/` with JSON array (`apiKey`, `numbers`, `method`, …)
|
|
10
|
+
*
|
|
11
|
+
* Sently-first: wire SMS into {@link createSmsSender}; OTP helpers stay on this class.
|
|
12
|
+
*
|
|
13
|
+
* @example
|
|
14
|
+
* ```ts
|
|
15
|
+
* import { createSmsSender } from "sently/sms";
|
|
16
|
+
* import { TaqnyatSmsTransport } from "sently/transports/taqnyat-sms";
|
|
17
|
+
*
|
|
18
|
+
* const taqnyat = new TaqnyatSmsTransport({
|
|
19
|
+
* bearerToken: process.env.TAQNYAT_TOKEN!,
|
|
20
|
+
* sender: "MyBrand",
|
|
21
|
+
* });
|
|
22
|
+
* const sms = createSmsSender({ transport: taqnyat });
|
|
23
|
+
*
|
|
24
|
+
* await sms.send({ to: "+9665xxxxxxxx", body: "Hello" });
|
|
25
|
+
* await taqnyat.sendOtp({ to: "+9665xxxxxxxx", requestId: "login-1", lang: "en" });
|
|
26
|
+
* await taqnyat.verifyOtp({
|
|
27
|
+
* to: "+9665xxxxxxxx",
|
|
28
|
+
* requestId: "login-1",
|
|
29
|
+
* code: "6240",
|
|
30
|
+
* lang: "en",
|
|
31
|
+
* });
|
|
32
|
+
* ```
|
|
33
|
+
*/
|
|
34
|
+
import { SentlyError } from "../core/errors.js";
|
|
35
|
+
import type { SmsOptions, SmsSendResult, SmsTransport } from "../core/sms-types.js";
|
|
36
|
+
import type { VerifyResult } from "../core/types.js";
|
|
37
|
+
/** Taqnyat SMS API configuration. */
|
|
38
|
+
export interface TaqnyatSmsConfig {
|
|
39
|
+
/** Bearer token from the Taqnyat dashboard. */
|
|
40
|
+
bearerToken: string;
|
|
41
|
+
/** Pre-approved sender name. */
|
|
42
|
+
sender: string;
|
|
43
|
+
}
|
|
44
|
+
/** Options for {@link TaqnyatSmsTransport.sendOtp}. */
|
|
45
|
+
export interface TaqnyatSendOtpOptions {
|
|
46
|
+
/** Recipient phone number (E.164 or international digits). */
|
|
47
|
+
to: string;
|
|
48
|
+
/** Unique id for this verification flow (required again on {@link verifyOtp}). */
|
|
49
|
+
requestId: string;
|
|
50
|
+
/** Message language (`en` or `ar`). Defaults to `"ar"` per Taqnyat docs. */
|
|
51
|
+
lang?: "en" | "ar";
|
|
52
|
+
/** Optional note appended to the OTP SMS. */
|
|
53
|
+
note?: string;
|
|
54
|
+
/** Sender ID override; defaults to transport `sender`. */
|
|
55
|
+
from?: string;
|
|
56
|
+
}
|
|
57
|
+
/** Result of a successful {@link TaqnyatSmsTransport.sendOtp} call. */
|
|
58
|
+
export interface TaqnyatOtpSendResult {
|
|
59
|
+
/** Echo of {@link TaqnyatSendOtpOptions.requestId}. */
|
|
60
|
+
requestId: string;
|
|
61
|
+
/** Recipient as passed in. */
|
|
62
|
+
to: string;
|
|
63
|
+
/** Provider status code (`5` = code sent). */
|
|
64
|
+
code: number;
|
|
65
|
+
/** Raw response body text. */
|
|
66
|
+
response: string;
|
|
67
|
+
/** Provider identifier. */
|
|
68
|
+
provider: "taqnyat-sms";
|
|
69
|
+
}
|
|
70
|
+
/** Options for {@link TaqnyatSmsTransport.verifyOtp}. */
|
|
71
|
+
export interface TaqnyatVerifyOtpOptions {
|
|
72
|
+
/** Recipient phone number (same as send). */
|
|
73
|
+
to: string;
|
|
74
|
+
/** Same {@link TaqnyatSendOtpOptions.requestId} used when sending. */
|
|
75
|
+
requestId: string;
|
|
76
|
+
/** OTP code the user entered (`activeKey` in Taqnyat docs). */
|
|
77
|
+
code: string;
|
|
78
|
+
/** Message language (`en` or `ar`). Defaults to `"ar"`. */
|
|
79
|
+
lang?: "en" | "ar";
|
|
80
|
+
/** Sender ID override; defaults to transport `sender`. */
|
|
81
|
+
from?: string;
|
|
82
|
+
/** Optional note (documented on check OTP). */
|
|
83
|
+
note?: string;
|
|
84
|
+
}
|
|
85
|
+
/** Result of a successful {@link TaqnyatSmsTransport.verifyOtp} call. */
|
|
86
|
+
export interface TaqnyatOtpVerifyResult {
|
|
87
|
+
/** Always `true` when the call resolves (failures throw). */
|
|
88
|
+
ok: true;
|
|
89
|
+
/** Provider status code (`10` = completed, `13`/`19` = already verified). */
|
|
90
|
+
code: number;
|
|
91
|
+
/** Provider message when present. */
|
|
92
|
+
message: string;
|
|
93
|
+
/** Raw response body text. */
|
|
94
|
+
response: string;
|
|
95
|
+
/** Provider identifier. */
|
|
96
|
+
provider: "taqnyat-sms";
|
|
97
|
+
}
|
|
98
|
+
/** Error thrown when the Taqnyat SMS / Verify API returns a non-success response. */
|
|
99
|
+
export declare class TaqnyatSmsError extends SentlyError {
|
|
100
|
+
readonly statusCode: number;
|
|
101
|
+
readonly apiError: unknown;
|
|
102
|
+
/** Creates a Taqnyat SMS API error with status code and response payload. */
|
|
103
|
+
constructor(message: string, statusCode: number, apiError: unknown);
|
|
104
|
+
}
|
|
105
|
+
/**
|
|
106
|
+
* Taqnyat SMS transport via JSON Bearer API, plus Verify OTP helpers.
|
|
107
|
+
*/
|
|
108
|
+
export declare class TaqnyatSmsTransport implements SmsTransport {
|
|
109
|
+
readonly provider = "taqnyat-sms";
|
|
110
|
+
private readonly bearerToken;
|
|
111
|
+
private readonly sender;
|
|
112
|
+
/** Creates a Taqnyat SMS transport. */
|
|
113
|
+
constructor(config: TaqnyatSmsConfig);
|
|
114
|
+
/**
|
|
115
|
+
* Sends an SMS via `POST https://api.taqnyat.sa/v1/messages`
|
|
116
|
+
* (Bearer + JSON: `recipients`, `body`, `sender`; optional `smsId`).
|
|
117
|
+
*/
|
|
118
|
+
send(options: SmsOptions): Promise<SmsSendResult>;
|
|
119
|
+
/**
|
|
120
|
+
* Vendor extra: generate/send OTP via `POST /verify.php/` (success code `5`).
|
|
121
|
+
* Not part of {@link SmsTransport} — call on {@link TaqnyatSmsTransport} directly.
|
|
122
|
+
*/
|
|
123
|
+
sendOtp(options: TaqnyatSendOtpOptions): Promise<TaqnyatOtpSendResult>;
|
|
124
|
+
/**
|
|
125
|
+
* Vendor extra: check OTP via `POST /verify.php/` with `activeKey`
|
|
126
|
+
* (`10` = completed; `13` / `19` = already verified).
|
|
127
|
+
*/
|
|
128
|
+
verifyOtp(options: TaqnyatVerifyOtpOptions): Promise<TaqnyatOtpVerifyResult>;
|
|
129
|
+
/** Lightweight credential check. */
|
|
130
|
+
verify(): Promise<VerifyResult>;
|
|
131
|
+
}
|
|
@@ -0,0 +1,3 @@
|
|
|
1
|
+
import{h as O}from"../chunk-7gy2q9sh.js";import{ca as W,da as X}from"../chunk-tamww15j.js";import"../chunk-6npp3x3c.js";class K extends W{statusCode;apiError;constructor(A,B,G){super(A,X(B>=100&&B<600?B:400),{statusCode:B,provider:"taqnyat-sms",cause:G});this.statusCode=B;this.apiError=G;this.name="TaqnyatSmsError"}}function R(A){let B=A.code??A.statusCode??A.status;if(typeof B==="number")return B;if(typeof B==="string"&&/^-?\d+$/.test(B))return Number(B);return}function Q(A){if(typeof A.message==="string")return A.message;if(typeof A.MessageEn==="string")return A.MessageEn;return}function U(A){if(Array.isArray(A)){let B=A[0];return B&&typeof B==="object"?B:{}}if(A&&typeof A==="object")return A;return{}}class Z{provider="taqnyat-sms";bearerToken;sender;constructor(A){this.bearerToken=A.bearerToken,this.sender=A.sender}async send(A){let G={recipients:[O(A.to)],body:A.body,sender:A.from??this.sender};if(A.messageId!==void 0)G.smsId=A.messageId;let I=await fetch("https://api.taqnyat.sa/v1/messages",{method:"POST",headers:{Authorization:`Bearer ${this.bearerToken}`,"Content-Type":"application/json"},body:JSON.stringify(G)}),D=await I.json();if(I.status!==201)throw new K(D.message??"Taqnyat SMS API error",D.statusCode??I.status,D);return{messageId:String(D.messageId??A.messageId??""),to:A.to,status:"accepted",response:`cost: ${D.cost??"?"} ${D.currency??"SAR"}`,provider:"taqnyat-sms"}}async sendOtp(A){let B=A.lang??"ar",G=O(A.to),I=[{apiKey:this.bearerToken,numbers:[G],method:"sms",sender:A.from??this.sender,lang:B,requestId:A.requestId,returnJson:1,...A.note!==void 0?{note:A.note}:{}}],D=await fetch("https://api.taqnyat.sa/verify.php/",{method:"POST",headers:{Authorization:`Bearer ${this.bearerToken}`,"Content-Type":"application/json"},body:JSON.stringify(I)}),J=await D.text(),N;try{N=JSON.parse(J)}catch{throw new K("Taqnyat Verify returned non-JSON response",D.status,J)}let H=U(N),F=R(H);if(!D.ok||F!==5)throw new K(Q(H)??`Taqnyat OTP send failed (code ${F??"unknown"})`,F??D.status,H);return{requestId:A.requestId,to:A.to,code:F,response:J,provider:"taqnyat-sms"}}async verifyOtp(A){let B=A.lang??"ar",G=O(A.to),I=[{apiKey:this.bearerToken,numbers:[G],method:"sms",sender:A.from??this.sender,lang:B,requestId:A.requestId,activeKey:A.code,returnJson:1,...A.note!==void 0?{note:A.note}:{}}],D=await fetch("https://api.taqnyat.sa/verify.php/",{method:"POST",headers:{Authorization:`Bearer ${this.bearerToken}`,"Content-Type":"application/json"},body:JSON.stringify(I)}),J=await D.text(),N;try{N=JSON.parse(J)}catch{throw new K("Taqnyat Verify returned non-JSON response",D.status,J)}let H=U(N),F=R(H),Y=new Set([10,13,19]);if(!D.ok||F===void 0||!Y.has(F))throw new K(Q(H)??`Taqnyat OTP verify failed (code ${F??"unknown"})`,F??D.status,H);return{ok:!0,code:F,message:Q(H)??"Activation process completed successfully",response:J,provider:"taqnyat-sms"}}async verify(){return{ok:Boolean(this.bearerToken&&this.sender),provider:"taqnyat-sms",message:this.bearerToken&&this.sender?"Credentials present":"Missing credentials"}}}export{Z as TaqnyatSmsTransport,K as TaqnyatSmsError};
|
|
2
|
+
|
|
3
|
+
//# debugId=18DB31EDCA321AE964756E2164756E21
|