sently 0.9.1 → 0.10.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 +1 -1
- package/CHANGELOG.md +60 -0
- package/README.md +18 -16
- package/dist/adapters/bun.js +1 -1
- package/dist/adapters/cf.js +2 -2
- package/dist/adapters/cf.js.map +1 -1
- 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/channel-result.d.ts +6 -0
- package/dist/channel-result.js +1 -0
- package/dist/{chunk-skqhj0rm.js → chunk-1ke3nmyg.js} +3 -3
- package/dist/{chunk-skqhj0rm.js.map → chunk-1ke3nmyg.js.map} +1 -1
- package/dist/{chunk-7gy2q9sh.js → chunk-5es0v1j7.js} +2 -2
- package/dist/{chunk-7gy2q9sh.js.map → chunk-5es0v1j7.js.map} +1 -1
- package/dist/{chunk-0qxws3kj.js → chunk-7wtfjx0d.js} +2 -2
- package/dist/{chunk-0qxws3kj.js.map → chunk-7wtfjx0d.js.map} +1 -1
- package/dist/chunk-8kpgbrba.js +4 -0
- package/dist/{chunk-93vqxxj2.js.map → chunk-8kpgbrba.js.map} +2 -2
- package/dist/{chunk-vjpds2pf.js → chunk-a057jzsy.js} +2 -2
- package/dist/{chunk-vjpds2pf.js.map → chunk-a057jzsy.js.map} +1 -1
- package/dist/{chunk-8njyga62.js → chunk-bhr7w3gg.js} +2 -2
- package/dist/{chunk-8njyga62.js.map → chunk-bhr7w3gg.js.map} +1 -1
- package/dist/chunk-cs1tvehn.js +4 -0
- package/dist/chunk-cs1tvehn.js.map +10 -0
- package/dist/{chunk-29z7fkzy.js → chunk-d5aw5vag.js} +3 -3
- package/dist/{chunk-29z7fkzy.js.map → chunk-d5aw5vag.js.map} +1 -1
- package/dist/chunk-f5x8vesr.js +4 -0
- package/dist/{chunk-b602dhck.js.map → chunk-f5x8vesr.js.map} +2 -2
- package/dist/chunk-fv0bemgf.js +4 -0
- package/dist/{chunk-yp311efr.js.map → chunk-fv0bemgf.js.map} +3 -3
- package/dist/{chunk-ywq6s10g.js → chunk-hnzmn4s4.js} +2 -2
- package/dist/{chunk-ywq6s10g.js.map → chunk-hnzmn4s4.js.map} +1 -1
- package/dist/chunk-htdg075t.js +4 -0
- package/dist/{chunk-qtkd5bak.js.map → chunk-htdg075t.js.map} +4 -3
- package/dist/{chunk-0gqy32pe.js → chunk-q2mahnb7.js} +3 -3
- package/dist/chunk-q2mahnb7.js.map +10 -0
- package/dist/chunk-sbgt4165.js +4 -0
- package/dist/chunk-sbgt4165.js.map +10 -0
- package/dist/{chunk-6npp3x3c.js → chunk-th4cwrpb.js} +2 -2
- package/dist/{chunk-6npp3x3c.js.map → chunk-th4cwrpb.js.map} +1 -1
- package/dist/{chunk-tamww15j.js → chunk-ttbwyxmh.js} +2 -2
- package/dist/{chunk-tamww15j.js.map → chunk-ttbwyxmh.js.map} +1 -1
- package/dist/chunk-w4c9kj70.js +13 -0
- package/dist/{chunk-n0qeyzqm.js.map → chunk-w4c9kj70.js.map} +2 -2
- package/dist/chunk-w9sabmb0.js +4 -0
- package/dist/chunk-w9sabmb0.js.map +10 -0
- package/dist/{chunk-8dty8c4p.js → chunk-yg3kj723.js} +3 -3
- package/dist/{chunk-8dty8c4p.js.map → chunk-yg3kj723.js.map} +2 -2
- package/dist/chunk-z1589fjk.js +4 -0
- package/dist/chunk-z1589fjk.js.map +10 -0
- package/dist/core/channel-result.d.ts +36 -0
- package/dist/core/channel-result.js +3 -0
- package/dist/core/channel-result.js.map +10 -0
- package/dist/core/decorated-transport.d.ts +30 -0
- package/dist/core/decorator-hooks.d.ts +17 -0
- package/dist/core/errors.js +2 -2
- package/dist/core/errors.js.map +1 -1
- package/dist/core/provider-label.d.ts +7 -3
- package/dist/core/push-endpoint.d.ts +5 -0
- package/dist/core/push-types.d.ts +48 -14
- package/dist/core/sms-types.d.ts +12 -0
- package/dist/core/smtp.js +2 -2
- package/dist/core/smtp.js.map +1 -1
- package/dist/core/whatsapp-types.d.ts +12 -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.js +2 -2
- package/dist/idempotency.js.map +1 -1
- package/dist/index.d.ts +4 -0
- package/dist/index.js +5 -0
- package/dist/mailer.js +2 -2
- package/dist/mailer.js.map +1 -1
- package/dist/observability/console.js +1 -1
- package/dist/plugins/react.js +2 -2
- package/dist/plugins/react.js.map +1 -1
- 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 +1 -0
- package/dist/push.js +2 -2
- package/dist/push.js.map +3 -3
- package/dist/sms.d.ts +1 -0
- package/dist/sms.js +2 -2
- package/dist/sms.js.map +3 -3
- package/dist/smtp-mailer.js +2 -2
- package/dist/smtp-mailer.js.map +1 -1
- package/dist/transports/brevo.js +2 -2
- package/dist/transports/brevo.js.map +2 -2
- package/dist/transports/cloudflare-email.js +2 -2
- package/dist/transports/cloudflare-email.js.map +2 -2
- package/dist/transports/fallback.d.ts +32 -6
- package/dist/transports/fallback.js +2 -2
- package/dist/transports/fallback.js.map +1 -1
- package/dist/transports/fcm.d.ts +55 -0
- package/dist/transports/fcm.js +4 -0
- package/dist/transports/fcm.js.map +10 -0
- package/dist/transports/loops.js +2 -2
- package/dist/transports/loops.js.map +1 -1
- package/dist/transports/mailersend.js +2 -2
- package/dist/transports/mailersend.js.map +2 -2
- package/dist/transports/mailgun.js +2 -2
- package/dist/transports/mailgun.js.map +2 -2
- package/dist/transports/mailtrap.js +2 -2
- package/dist/transports/mailtrap.js.map +2 -2
- package/dist/transports/msegat.js +2 -2
- package/dist/transports/msegat.js.map +1 -1
- package/dist/transports/plunk.js +2 -2
- package/dist/transports/plunk.js.map +1 -1
- package/dist/transports/postmark.js +2 -2
- package/dist/transports/postmark.js.map +2 -2
- package/dist/transports/preview.js +2 -2
- package/dist/transports/preview.js.map +1 -1
- package/dist/transports/resend.js +2 -2
- package/dist/transports/resend.js.map +2 -2
- package/dist/transports/retry.d.ts +28 -9
- package/dist/transports/retry.js +2 -2
- package/dist/transports/retry.js.map +3 -3
- package/dist/transports/sendgrid.js +2 -2
- package/dist/transports/sendgrid.js.map +2 -2
- package/dist/transports/ses.js +2 -2
- package/dist/transports/ses.js.map +2 -2
- package/dist/transports/smtp.js +2 -2
- package/dist/transports/smtp.js.map +1 -1
- package/dist/transports/sndr.js +2 -2
- package/dist/transports/sndr.js.map +1 -1
- package/dist/transports/sparkpost.js +2 -2
- package/dist/transports/sparkpost.js.map +2 -2
- package/dist/transports/taqnyat-mail.js +2 -2
- package/dist/transports/taqnyat-mail.js.map +1 -1
- package/dist/transports/taqnyat-sms.js +2 -2
- package/dist/transports/taqnyat-sms.js.map +1 -1
- package/dist/transports/taqnyat-whatsapp.js +2 -2
- package/dist/transports/taqnyat-whatsapp.js.map +1 -1
- package/dist/transports/twilio-sms.js +2 -2
- package/dist/transports/twilio-sms.js.map +2 -2
- package/dist/transports/unifonic.d.ts +81 -0
- package/dist/transports/unifonic.js +3 -0
- package/dist/transports/unifonic.js.map +10 -0
- package/dist/transports/webpush.js +2 -2
- package/dist/transports/webpush.js.map +3 -3
- package/dist/transports/weighted-fallback.d.ts +11 -9
- package/dist/transports/weighted-fallback.js +2 -2
- package/dist/transports/weighted-fallback.js.map +3 -3
- package/dist/transports/whatsapp-cloud.js +2 -2
- package/dist/transports/whatsapp-cloud.js.map +1 -1
- package/dist/webhooks/brevo.js +2 -2
- package/dist/webhooks/brevo.js.map +1 -1
- package/dist/webhooks/mailgun.js +2 -2
- package/dist/webhooks/mailgun.js.map +1 -1
- package/dist/webhooks/postmark.js +2 -2
- package/dist/webhooks/postmark.js.map +1 -1
- package/dist/webhooks/resend.js +2 -2
- package/dist/webhooks/resend.js.map +1 -1
- package/dist/webhooks/sendgrid.js +2 -2
- package/dist/webhooks/sendgrid.js.map +1 -1
- package/dist/webhooks/ses.js +2 -2
- package/dist/webhooks/ses.js.map +1 -1
- package/dist/webhooks/sndr.js +2 -2
- package/dist/webhooks/sndr.js.map +1 -1
- package/dist/webhooks/timing-safe-equal.js +1 -1
- package/dist/webhooks/twilio-sms.d.ts +20 -0
- package/dist/webhooks/twilio-sms.js +3 -0
- package/dist/webhooks/twilio-sms.js.map +10 -0
- package/dist/webhooks/types.d.ts +37 -3
- package/dist/webhooks/types.js +3 -0
- package/dist/webhooks/types.js.map +9 -0
- package/dist/webhooks/unifonic.d.ts +13 -0
- package/dist/webhooks/unifonic.js +3 -0
- package/dist/webhooks/unifonic.js.map +10 -0
- package/dist/webhooks/whatsapp-cloud.d.ts +14 -0
- package/dist/webhooks/whatsapp-cloud.js +3 -0
- package/dist/webhooks/whatsapp-cloud.js.map +10 -0
- package/dist/webhooks.d.ts +10 -5
- package/dist/webhooks.js +11 -0
- package/dist/whatsapp.d.ts +1 -0
- package/dist/whatsapp.js +2 -2
- package/dist/whatsapp.js.map +3 -3
- package/package.json +26 -2
- package/site/content/docs/channels/hooks.mdx +6 -5
- package/site/content/docs/channels/index.mdx +2 -2
- package/site/content/docs/channels/push.mdx +27 -21
- package/site/content/docs/channels/sms.mdx +4 -1
- package/site/content/docs/decorators/fallback.mdx +41 -14
- package/site/content/docs/decorators/index.mdx +29 -12
- package/site/content/docs/decorators/retry.mdx +32 -9
- package/site/content/docs/decorators/weighted-fallback.mdx +27 -6
- package/site/content/docs/get-started/entrypoints.mdx +6 -5
- package/site/content/docs/get-started/installation.mdx +3 -2
- package/site/content/docs/get-started/introduction.mdx +1 -1
- package/site/content/docs/guides/webhooks.mdx +35 -20
- package/site/content/docs/index.mdx +1 -1
- package/site/content/docs/quick-start/push.mdx +22 -5
- package/site/content/docs/reference/channel-result.mdx +82 -0
- package/site/content/docs/reference/exports.mdx +5 -3
- package/site/content/docs/reference/meta.json +1 -0
- package/site/content/docs/reference/push-options.mdx +44 -3
- package/site/content/docs/reference/sms-options.mdx +18 -2
- package/site/content/docs/reference/webhook-events.mdx +38 -14
- package/site/content/docs/reference/whatsapp-options.mdx +19 -1
- package/site/content/docs/transports/fcm.mdx +80 -0
- package/site/content/docs/transports/index.mdx +3 -1
- package/site/content/docs/transports/meta.json +3 -1
- package/site/content/docs/transports/unifonic.mdx +85 -0
- package/dist/chunk-0gqy32pe.js.map +0 -10
- package/dist/chunk-5915vbcj.js +0 -4
- package/dist/chunk-5915vbcj.js.map +0 -10
- package/dist/chunk-93vqxxj2.js +0 -4
- package/dist/chunk-b602dhck.js +0 -4
- package/dist/chunk-gp4fwrs8.js +0 -4
- package/dist/chunk-gp4fwrs8.js.map +0 -10
- package/dist/chunk-n0qeyzqm.js +0 -13
- package/dist/chunk-q8k3m6qe.js +0 -4
- package/dist/chunk-q8k3m6qe.js.map +0 -10
- package/dist/chunk-qtkd5bak.js +0 -4
- package/dist/chunk-yp311efr.js +0 -4
|
@@ -5,6 +5,6 @@
|
|
|
5
5
|
"/**\n * @module\n * Msegat SMS gateway transport (Saudi Arabia).\n *\n * Shapes follow the official Postman collection\n * ([MSEGAT Communication Platform API](https://documenter.getpostman.com/view/39158411/2sBY4LT3EY)):\n * - `POST /gw/sendsms.php` — JSON send (`code` `\"1\"` / `\"M0000\"`)\n * - `GET /gw/Credits.php` — balance / credential check\n * - `POST /gw/sendOTPCode.php` / `verifyOTPCode.php` — vendor OTP helpers\n *\n * Sently-first: wire into {@link createSmsSender}; OTP stays on this class.\n *\n * @example\n * ```ts\n * import { createSmsSender } from \"sently/sms\";\n * import { MsegatTransport } from \"sently/transports/msegat\";\n *\n * const msegat = new MsegatTransport({\n * userName: process.env.MSEGAT_USERNAME!,\n * apiKey: process.env.MSEGAT_API_KEY!,\n * sender: \"MyBrand\",\n * });\n * const sms = createSmsSender({ transport: msegat });\n *\n * await sms.send({ to: \"+9665xxxxxxxx\", body: \"Hello\" });\n * const otp = await msegat.sendOtp({ to: \"+9665xxxxxxxx\", lang: \"En\" });\n * await msegat.verifyOtp({ id: otp.id, code: \"1234\", lang: \"En\" });\n * ```\n */\nimport { httpStatusToSentlyCode, SentlyError, type SentlyErrorCode } from \"../core/errors.js\";\nimport type { SmsOptions, SmsSendResult, SmsTransport } from \"../core/sms-types.js\";\nimport type { VerifyResult } from \"../core/types.js\";\n\n/** Msegat SMS API configuration. */\nexport interface MsegatConfig {\n /** Msegat account username. */\n userName: string;\n /** Msegat API key. */\n apiKey: string;\n /** Pre-approved sender name (use `auth-mseg` for free OTP tests). */\n sender: string;\n}\n\n/** Options for {@link MsegatTransport.sendOtp}. */\nexport interface MsegatSendOtpOptions {\n /** Recipient phone number (E.164 or international digits). */\n to: string;\n /** Sender ID override; defaults to transport `sender`. */\n from?: string;\n /**\n * Message language for header + body (`Ar` or `En`).\n * Postman: \"lang : Ar or En in header\". Defaults to `\"En\"`.\n */\n lang?: \"Ar\" | \"En\";\n}\n\n/** Result of a successful {@link MsegatTransport.sendOtp} call. */\nexport interface MsegatOtpSendResult {\n /** OTP session id required by {@link MsegatTransport.verifyOtp}. */\n id: string;\n /** Recipient phone number as passed in. */\n to: string;\n /** Delivery status (`\"accepted\"` on success). */\n status: string;\n /** Raw response body text. */\n response: string;\n /** Provider identifier. */\n provider: \"msegat\";\n}\n\n/** Options for {@link MsegatTransport.verifyOtp}. */\nexport interface MsegatVerifyOtpOptions {\n /** OTP session id from {@link MsegatOtpSendResult.id}. */\n id: string | number;\n /** Code the user entered. */\n code: string;\n /** Sender ID override; defaults to transport `sender`. */\n from?: string;\n /** Message language (`Ar` or `En`). Defaults to `\"En\"`. */\n lang?: \"Ar\" | \"En\";\n}\n\n/** Result of a successful {@link MsegatTransport.verifyOtp} call. */\nexport interface MsegatOtpVerifyResult {\n /** Always `true` when the call resolves (failures throw). */\n ok: true;\n /** Provider message when present. */\n message: string;\n /** Raw response body text. */\n response: string;\n /** Provider identifier. */\n provider: \"msegat\";\n}\n\n/** Error thrown when the Msegat SMS API reports a failure. */\nexport class MsegatError extends SentlyError {\n /** Creates a Msegat SMS API error with status code and response payload. */\n constructor(\n message: string,\n public readonly statusCode: number,\n public readonly apiError: unknown,\n sentlyCode?: SentlyErrorCode,\n /** Msegat response `code` when present (e.g. `\"1020\"`, `\"M0002\"`). */\n providerCode?: string,\n ) {\n super(\n message,\n sentlyCode ?? (statusCode >= 400 ? httpStatusToSentlyCode(statusCode) : \"PROVIDER_ERROR\"),\n {\n statusCode,\n provider: \"msegat\",\n cause: apiError,\n },\n );\n this.name = \"MsegatError\";\n if (providerCode !== undefined) {\n this.code = providerCode;\n }\n }\n}\n\n/**\n * International format without `+` or leading `00`\n * (Postman: \"international format without zeros\").\n */\nfunction normalizeMsegatPhone(phone: string): string {\n let normalized = phone.trim();\n if (normalized.startsWith(\"+\")) {\n normalized = normalized.slice(1);\n }\n if (normalized.startsWith(\"00\")) {\n normalized = normalized.slice(2);\n }\n return normalized;\n}\n\nfunction responseCode(payload: Record<string, unknown>): string | undefined {\n const raw = payload.code ?? payload.Code;\n if (typeof raw === \"string\" || typeof raw === \"number\") {\n return String(raw);\n }\n return undefined;\n}\n\n/** Documented success codes: `1` / `M0000` (and OTP `success: true`). */\nfunction isSuccessCode(code: string | undefined): boolean {\n return code === \"1\" || code === \"M0000\";\n}\n\nfunction isSuccessPayload(payload: Record<string, unknown>): boolean {\n const code = responseCode(payload);\n if (isSuccessCode(code)) return true;\n // sendOTPCode success example includes `\"success\": true` alongside `code: \"1\"`.\n return payload.success === true && (code === undefined || isSuccessCode(code));\n}\n\nfunction responseMessage(payload: Record<string, unknown>): string | undefined {\n if (typeof payload.message === \"string\") return payload.message;\n if (typeof payload.Message === \"string\") return payload.Message;\n return undefined;\n}\n\n/** Map documented Msegat codes onto stable sently codes. */\nfunction msegatCodeToSently(code: string | undefined): SentlyErrorCode {\n switch (code) {\n case \"1060\":\n // Balance is not enough — provider-side account state.\n return \"PROVIDER_ERROR\";\n case \"400\":\n case \"404\":\n // OTP expired / not found.\n return \"BAD_REQUEST\";\n default:\n return \"BAD_REQUEST\";\n }\n}\n\nasync function postJson(\n url: string,\n body: Record<string, unknown>,\n headers?: Record<string, string>,\n): Promise<{ response: Response; text: string; payload: Record<string, unknown> }> {\n const response = await fetch(url, {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n ...headers,\n },\n body: JSON.stringify(body),\n });\n\n const text = await response.text();\n let payload: Record<string, unknown>;\n try {\n payload = JSON.parse(text) as Record<string, unknown>;\n } catch {\n throw new MsegatError(\"Msegat returned non-JSON response\", response.status, text);\n }\n\n return { response, text, payload };\n}\n\nfunction assertSuccess(\n response: Response,\n payload: Record<string, unknown>,\n fallbackMessage: string,\n): string {\n const code = responseCode(payload);\n if (!response.ok || !isSuccessPayload(payload)) {\n const message = responseMessage(payload) ?? `${fallbackMessage} (code ${code ?? \"unknown\"})`;\n const sentlyCode =\n response.status >= 400 ? httpStatusToSentlyCode(response.status) : msegatCodeToSently(code);\n throw new MsegatError(message, response.status, payload, sentlyCode, code);\n }\n return code ?? \"1\";\n}\n\n/**\n * Msegat SMS transport via JSON `sendsms.php` + Credits-based `verify()`,\n * with provider-specific OTP helpers.\n */\nexport class MsegatTransport implements SmsTransport {\n readonly provider = \"msegat\";\n\n private readonly userName: string;\n private readonly apiKey: string;\n private readonly sender: string;\n\n /** Creates an Msegat SMS transport. */\n constructor(config: MsegatConfig) {\n this.userName = config.userName;\n this.apiKey = config.apiKey;\n this.sender = config.sender;\n }\n\n /**\n * Sends an SMS via `POST /gw/sendsms.php`\n * (JSON: `userName`, `apiKey`, `numbers`, `userSender`, `msg`).\n */\n async send(options: SmsOptions): Promise<SmsSendResult> {\n const numbers = normalizeMsegatPhone(options.to);\n const { response, text, payload } = await postJson(\"https://www.msegat.com/gw/sendsms.php\", {\n userName: this.userName,\n apiKey: this.apiKey,\n numbers,\n userSender: options.from ?? this.sender,\n msg: options.body,\n // Optional per Postman; UTF8 is the documented default.\n msgEncoding: \"UTF8\",\n // Optional: request bulk id when the account returns one.\n reqBulkId: \"true\",\n });\n\n assertSuccess(response, payload, \"Msegat SMS API error\");\n\n const idCandidate = payload.bulk_id ?? payload.messageId ?? payload.id ?? payload.Id;\n const messageId =\n typeof idCandidate === \"string\" || typeof idCandidate === \"number\"\n ? String(idCandidate)\n : (options.messageId ?? crypto.randomUUID());\n\n return {\n messageId,\n to: options.to,\n status: \"accepted\",\n response: text,\n provider: \"msegat\",\n };\n }\n\n /**\n * Vendor extra: send a provider-generated OTP via `sendOTPCode.php`.\n * Not part of {@link SmsTransport} — call on {@link MsegatTransport} directly.\n * Keep the returned {@link MsegatOtpSendResult.id} for {@link verifyOtp}.\n */\n async sendOtp(options: MsegatSendOtpOptions): Promise<MsegatOtpSendResult> {\n const lang = options.lang ?? \"En\";\n const number = normalizeMsegatPhone(options.to);\n const { response, text, payload } = await postJson(\n \"https://www.msegat.com/gw/sendOTPCode.php\",\n {\n userName: this.userName,\n apiKey: this.apiKey,\n number,\n userSender: options.from ?? this.sender,\n lang,\n },\n // Postman: \"lang : Ar or En in header\"\n { lang },\n );\n\n assertSuccess(response, payload, \"Msegat OTP send error\");\n\n const idRaw = payload.id ?? payload.Id;\n if (typeof idRaw !== \"string\" && typeof idRaw !== \"number\") {\n throw new MsegatError(\n \"Msegat OTP send succeeded but returned no id\",\n response.status,\n payload,\n );\n }\n\n return {\n id: String(idRaw),\n to: options.to,\n status: \"accepted\",\n response: text,\n provider: \"msegat\",\n };\n }\n\n /**\n * Vendor extra: verify a code previously sent with {@link sendOtp} via\n * `verifyOTPCode.php`. Not part of {@link SmsTransport} — call on\n * {@link MsegatTransport} directly. Throws {@link MsegatError} when the code\n * is invalid, expired (`400`), or not found (`404`).\n */\n async verifyOtp(options: MsegatVerifyOtpOptions): Promise<MsegatOtpVerifyResult> {\n const lang = options.lang ?? \"En\";\n const { response, text, payload } = await postJson(\n \"https://www.msegat.com/gw/verifyOTPCode.php\",\n {\n userName: this.userName,\n apiKey: this.apiKey,\n code: options.code,\n id: options.id,\n userSender: options.from ?? this.sender,\n lang,\n },\n { lang },\n );\n\n assertSuccess(response, payload, \"Msegat OTP verify error\");\n\n return {\n ok: true,\n message: responseMessage(payload) ?? \"Success\",\n response: text,\n provider: \"msegat\",\n };\n }\n\n /**\n * Credential check via `GET /gw/Credits.php` (no SMS sent).\n * Postman success body is a bare balance number (e.g. `\"272.6\"`).\n */\n async verify(): Promise<VerifyResult> {\n if (!this.userName || !this.apiKey || !this.sender) {\n return { ok: false, provider: \"msegat\", message: \"Missing credentials\" };\n }\n\n const url = new URL(\"https://www.msegat.com/gw/Credits.php\");\n url.searchParams.set(\"userName\", this.userName);\n url.searchParams.set(\"apiKey\", this.apiKey);\n\n try {\n const response = await fetch(url, {\n method: \"GET\",\n headers: {\n // Matches Postman Credits request headers.\n \"Content-Type\": \"application/json\",\n },\n });\n const text = (await response.text()).trim();\n\n if (!response.ok) {\n return {\n ok: false,\n provider: \"msegat\",\n message: `Credits inquiry failed (HTTP ${response.status}): ${text || \"empty body\"}`,\n };\n }\n\n const balance = Number(text);\n if (Number.isFinite(balance)) {\n return {\n ok: true,\n provider: \"msegat\",\n message: `Balance: ${text}`,\n };\n }\n\n // Some failures still return HTTP 200 with a code/message JSON body.\n try {\n const payload = JSON.parse(text) as Record<string, unknown>;\n if (isSuccessPayload(payload)) {\n return { ok: true, provider: \"msegat\", message: responseMessage(payload) ?? \"OK\" };\n }\n const code = responseCode(payload);\n return {\n ok: false,\n provider: \"msegat\",\n message: responseMessage(payload) ?? `Credits inquiry failed (code ${code ?? \"unknown\"})`,\n };\n } catch {\n return {\n ok: false,\n provider: \"msegat\",\n message: `Credits inquiry returned unexpected body: ${text}`,\n };\n }\n } catch (error) {\n return {\n ok: false,\n provider: \"msegat\",\n message: error instanceof Error ? error.message : \"Credits inquiry failed\",\n };\n }\n }\n}\n"
|
|
6
6
|
],
|
|
7
7
|
"mappings": "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",
|
|
8
|
-
"debugId": "
|
|
8
|
+
"debugId": "E58D04225405310864756E2164756E21",
|
|
9
9
|
"names": []
|
|
10
10
|
}
|
package/dist/transports/plunk.js
CHANGED
|
@@ -1,3 +1,3 @@
|
|
|
1
|
-
import{
|
|
1
|
+
import{S as K,U as L}from"../chunk-8kpgbrba.js";import"../chunk-hnzmn4s4.js";import{ja as M,ka as N}from"../chunk-ttbwyxmh.js";import"../chunk-th4cwrpb.js";class O extends M{statusCode;apiError;constructor(q,B,z){super(q,N(B),{statusCode:B,provider:"plunk",cause:z});this.statusCode=B;this.apiError=z;this.name="PlunkError"}}class V{provider="plunk";apiKey;constructor(q){this.apiKey=q.apiKey}async send(q){let B=K(q.from)[0],z=L(q.to),Q=q.html??q.text??"",H=[],J=[];for(let U of z){let F=await fetch("https://api.useplunk.com/v1/send",{method:"POST",headers:{Authorization:`Bearer ${this.apiKey}`,"Content-Type":"application/json"},body:JSON.stringify({to:U,subject:q.subject,body:Q,subscribed:!1})}),D=await F.json();if(!F.ok||D.success!==!0)throw new O(D.message??"Plunk API error",F.status,D);let G=D.emails?.[0]?.id??"";if(G)H.push(G);J.push(G||"sent")}return{messageId:H.join(","),accepted:z,rejected:[],response:J.join("; "),envelope:{from:B?.address??"",to:z}}}async verify(){return{ok:!0,provider:"plunk",message:"no verify endpoint; key not validated"}}}export{V as PlunkTransport,O as PlunkError};
|
|
2
2
|
|
|
3
|
-
//# debugId=
|
|
3
|
+
//# debugId=C48A47B07B5EFDD564756E2164756E21
|
|
@@ -5,6 +5,6 @@
|
|
|
5
5
|
"/**\n * @module\n * Plunk HTTP transport for sently.\n *\n * Plunk's send API targets a single recipient per request. When `options.to`\n * contains multiple addresses, one HTTP request is sent per recipient and\n * results are aggregated into a single {@link SendResult}.\n *\n * @example\n * ```ts\n * import { PlunkTransport } from \"sently/transports/plunk\";\n * import { createMailer } from \"sently/mailer\";\n *\n * const mailer = await createMailer({\n * transport: new PlunkTransport({ apiKey: process.env.PLUNK_API_KEY! }),\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/** Plunk HTTP API configuration. */\nexport interface PlunkConfig {\n /** Plunk API key for Bearer authentication. */\n apiKey: string;\n}\n\n/** Error thrown when the Plunk API returns a non-success response. */\nexport class PlunkError extends SentlyError {\n /** Creates a Plunk API error with status code. */\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: \"plunk\",\n cause: apiError,\n });\n this.name = \"PlunkError\";\n }\n}\n\n/**\n * Plunk HTTP API transport.\n */\nexport class PlunkTransport implements Transport {\n readonly provider = \"plunk\";\n\n private readonly apiKey: string;\n\n /** Creates a Plunk transport with the given API key. */\n constructor(config: PlunkConfig) {\n this.apiKey = config.apiKey;\n }\n\n /** Sends an email via the Plunk HTTP API (one request per recipient). */\n async send(options: MailOptions): Promise<SendResult> {\n const from = parseAddresses(options.from)[0];\n const recipients = extractEmails(options.to);\n const bodyContent = options.html ?? options.text ?? \"\";\n const messageIds: string[] = [];\n const responses: string[] = [];\n\n for (const recipient of recipients) {\n const response = await fetch(\"https://api.useplunk.com/v1/send\", {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${this.apiKey}`,\n \"Content-Type\": \"application/json\",\n },\n body: JSON.stringify({\n to: recipient,\n subject: options.subject,\n body: bodyContent,\n subscribed: false,\n }),\n });\n\n const payload = (await response.json()) as {\n success?: boolean;\n emails?: Array<{ id?: string; email?: string }>;\n message?: string;\n };\n\n if (!response.ok || payload.success !== true) {\n throw new PlunkError(payload.message ?? \"Plunk API error\", response.status, payload);\n }\n\n const emailId = payload.emails?.[0]?.id ?? \"\";\n if (emailId) {\n messageIds.push(emailId);\n }\n responses.push(emailId || \"sent\");\n }\n\n return {\n messageId: messageIds.join(\",\"),\n accepted: recipients,\n rejected: [],\n response: responses.join(\"; \"),\n envelope: {\n from: from?.address ?? \"\",\n to: recipients,\n },\n };\n }\n\n /**\n * Returns success without a network call — Plunk has no documented verify endpoint.\n */\n async verify(): Promise<VerifyResult> {\n return {\n ok: true,\n provider: \"plunk\",\n message: \"no verify endpoint; key not validated\",\n };\n }\n}\n"
|
|
6
6
|
],
|
|
7
7
|
"mappings": "2KA6BO,CAAM,KAAmB,JAAY,CAIxB,WACA,SAHlB,WAAW,CACT,EACgB,EACA,EAChB,CACA,MAAM,EAAS,EAAuB,CAAU,EAAG,CACjD,aACA,SAAU,QACV,MAAO,CACT,CAAC,EAPe,kBACA,gBAOhB,KAAK,KAAO,aAEhB,CAKO,MAAM,CAAoC,CACtC,SAAW,QAEH,OAGjB,WAAW,CAAC,EAAqB,CAC/B,KAAK,OAAS,EAAO,YAIjB,KAAI,CAAC,EAA2C,CACpD,IAAM,EAAO,EAAe,EAAQ,IAAI,EAAE,GACpC,EAAa,EAAc,EAAQ,EAAE,EACrC,EAAc,EAAQ,MAAQ,EAAQ,MAAQ,GAC9C,EAAuB,CAAC,EACxB,EAAsB,CAAC,EAE7B,QAAW,KAAa,EAAY,CAClC,IAAM,EAAW,MAAM,MAAM,mCAAoC,CAC/D,OAAQ,OACR,QAAS,CACP,cAAe,UAAU,KAAK,SAC9B,eAAgB,kBAClB,EACA,KAAM,KAAK,UAAU,CACnB,GAAI,EACJ,QAAS,EAAQ,QACjB,KAAM,EACN,WAAY,EACd,CAAC,CACH,CAAC,EAEK,EAAW,MAAM,EAAS,KAAK,EAMrC,GAAI,CAAC,EAAS,IAAM,EAAQ,UAAY,GACtC,MAAM,IAAI,EAAW,EAAQ,SAAW,kBAAmB,EAAS,OAAQ,CAAO,EAGrF,IAAM,EAAU,EAAQ,SAAS,IAAI,IAAM,GAC3C,GAAI,EACF,EAAW,KAAK,CAAO,EAEzB,EAAU,KAAK,GAAW,MAAM,EAGlC,MAAO,CACL,UAAW,EAAW,KAAK,GAAG,EAC9B,SAAU,EACV,SAAU,CAAC,EACX,SAAU,EAAU,KAAK,IAAI,EAC7B,SAAU,CACR,KAAM,GAAM,SAAW,GACvB,GAAI,CACN,CACF,OAMI,OAAM,EAA0B,CACpC,MAAO,CACL,GAAI,GACJ,SAAU,QACV,QAAS,uCACX,EAEJ",
|
|
8
|
-
"debugId": "
|
|
8
|
+
"debugId": "C48A47B07B5EFDD564756E2164756E21",
|
|
9
9
|
"names": []
|
|
10
10
|
}
|
|
@@ -1,3 +1,3 @@
|
|
|
1
|
-
import{
|
|
1
|
+
import{K as U}from"../chunk-1ke3nmyg.js";import{S as D,T as F,U as J}from"../chunk-8kpgbrba.js";import{da as O}from"../chunk-hnzmn4s4.js";import{ja as Q,ka as R}from"../chunk-ttbwyxmh.js";import"../chunk-th4cwrpb.js";class W extends Q{statusCode;apiError;constructor(q,w,G){super(q,R(w),{statusCode:w,provider:"postmark",cause:G});this.statusCode=w;this.apiError=G;this.name="PostmarkError"}}class Z{provider="postmark";serverToken;constructor(q){this.serverToken=q.serverToken}async send(q){let w=await U(q.attachments),G=D(q.from)[0],X={From:G?F(G):"",To:D(q.to).map(F).join(", "),Subject:q.subject,...q.cc?{Cc:D(q.cc).map(F).join(", ")}:{},...q.bcc?{Bcc:D(q.bcc).map(F).join(", ")}:{},...q.replyTo?{ReplyTo:D(q.replyTo).map(F).join(", ")}:{},...q.text?{TextBody:q.text}:{},...q.html?{HtmlBody:q.html}:{},...q.headers?{Headers:Object.entries(q.headers).map(([z,Y])=>({Name:z,Value:Y}))}:{},...w.length>0?{Attachments:w.map((z)=>({Name:z.filename,Content:z.content instanceof Uint8Array?O(z.content).replace(/\r\n/g,""):z.content,ContentType:z.contentType??"application/octet-stream",...z.contentId?{ContentID:z.contentId}:{}}))}:{}},L=await fetch("https://api.postmarkapp.com/email",{method:"POST",headers:{"X-Postmark-Server-Token":this.serverToken,"Content-Type":"application/json",Accept:"application/json"},body:JSON.stringify(X)}),K=await L.json();if(!L.ok)throw new W(K.Message??"Postmark API error",L.status,K);return{messageId:K.MessageID??q.messageId??"",accepted:J(q.to),rejected:[],response:K.Message??"OK",envelope:{from:G?.address??"",to:[...J(q.to),...q.cc?J(q.cc):[],...q.bcc?J(q.bcc):[]]}}}async verify(){try{let q=await fetch("https://api.postmarkapp.com/server",{headers:{"X-Postmark-Server-Token":this.serverToken,Accept:"application/json"}}),w=await q.json();if(!q.ok)return{ok:!1,provider:"postmark",message:w.Message??`HTTP ${q.status}`};return{ok:!0,provider:"postmark",...w.Name?{message:w.Name}:{}}}catch(q){return{ok:!1,provider:"postmark",message:q instanceof Error?q.message:String(q)}}}}export{Z as PostmarkTransport,W as PostmarkError};
|
|
2
2
|
|
|
3
|
-
//# debugId=
|
|
3
|
+
//# debugId=0E7CD88031ADF1CC64756E2164756E21
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
"sourcesContent": [
|
|
5
5
|
"/**\n * @module\n * Postmark HTTP API transport for sending email via api.postmarkapp.com.\n *\n * @example\n * ```ts\n * import { PostmarkTransport } from \"sently/transports/postmark\";\n * import { createMailer } from \"sently/mailer\";\n *\n * const mailer = await createMailer({\n * transport: new PostmarkTransport({ serverToken: process.env.POSTMARK_TOKEN! }),\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, 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/** Postmark API configuration. */\nexport interface PostmarkConfig {\n /** Postmark server API token. */\n serverToken: string;\n}\n\n/** Error thrown when the Postmark API returns a non-success response. */\nexport class PostmarkError extends SentlyError {\n /** Creates a Postmark 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: \"postmark\",\n cause: apiError,\n });\n this.name = \"PostmarkError\";\n }\n}\n\n/**\n * Postmark HTTP API transport.\n */\nexport class PostmarkTransport implements Transport {\n readonly provider = \"postmark\";\n\n /** Postmark server API token for the X-Postmark-Server-Token header. */\n private readonly serverToken: string;\n\n /** Creates a Postmark transport with the given server token. */\n constructor(config: PostmarkConfig) {\n this.serverToken = config.serverToken;\n }\n\n /** Sends an email via the Postmark 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 From: from ? toMIMEHeader(from) : \"\",\n To: parseAddresses(options.to).map(toMIMEHeader).join(\", \"),\n Subject: options.subject,\n ...(options.cc ? { Cc: parseAddresses(options.cc).map(toMIMEHeader).join(\", \") } : {}),\n ...(options.bcc ? { Bcc: parseAddresses(options.bcc).map(toMIMEHeader).join(\", \") } : {}),\n ...(options.replyTo\n ? { ReplyTo: parseAddresses(options.replyTo).map(toMIMEHeader).join(\", \") }\n : {}),\n ...(options.text ? { TextBody: options.text } : {}),\n ...(options.html ? { HtmlBody: options.html } : {}),\n ...(options.headers\n ? { Headers: Object.entries(options.headers).map(([Name, Value]) => ({ Name, Value })) }\n : {}),\n ...(attachments.length > 0\n ? {\n Attachments: attachments.map((att) => ({\n Name: att.filename,\n Content:\n att.content instanceof Uint8Array\n ? encodeBase64(att.content).replace(/\\r\\n/g, \"\")\n : att.content,\n ContentType: att.contentType ?? \"application/octet-stream\",\n ...(att.contentId ? { ContentID: att.contentId } : {}),\n })),\n }\n : {}),\n };\n\n const response = await fetch(\"https://api.postmarkapp.com/email\", {\n method: \"POST\",\n headers: {\n \"X-Postmark-Server-Token\": this.serverToken,\n \"Content-Type\": \"application/json\",\n Accept: \"application/json\",\n },\n body: JSON.stringify(body),\n });\n\n const payload = (await response.json()) as {\n MessageID?: string;\n Message?: string;\n ErrorCode?: number;\n };\n\n if (!response.ok) {\n throw new PostmarkError(payload.Message ?? \"Postmark API error\", response.status, payload);\n }\n\n return {\n messageId: payload.MessageID ?? options.messageId ?? \"\",\n accepted: extractEmails(options.to),\n rejected: [],\n response: payload.Message ?? \"OK\",\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 /** Verifies the Postmark server token by fetching server info. */\n async verify(): Promise<VerifyResult> {\n try {\n const response = await fetch(\"https://api.postmarkapp.com/server\", {\n headers: {\n \"X-Postmark-Server-Token\": this.serverToken,\n Accept: \"application/json\",\n },\n });\n\n const payload = (await response.json()) as { Name?: string; Message?: string };\n\n if (!response.ok) {\n return {\n ok: false,\n provider: \"postmark\",\n message: payload.Message ?? `HTTP ${response.status}`,\n };\n }\n\n return {\n ok: true,\n provider: \"postmark\",\n ...(payload.Name ? { message: payload.Name } : {}),\n };\n } catch (err) {\n return {\n ok: false,\n provider: \"postmark\",\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": "0E7CD88031ADF1CC64756E2164756E21",
|
|
9
9
|
"names": []
|
|
10
10
|
}
|
|
@@ -1,3 +1,3 @@
|
|
|
1
|
-
import{
|
|
1
|
+
import{w as L}from"../chunk-yg3kj723.js";import{K as N}from"../chunk-1ke3nmyg.js";import{U as K}from"../chunk-8kpgbrba.js";import"../chunk-hnzmn4s4.js";import{ma as J}from"../chunk-th4cwrpb.js";function T(k){return k.replace(/[^a-zA-Z0-9]+/g,"-").replace(/^-|-$/g,"").slice(0,40)||"no-subject"}function U(k){if(k==="darwin")return"open";if(k==="win32")return"start";return"xdg-open"}class V{provider="preview";outDir;open;format;constructor(k){this.outDir=k?.outDir??"./.emails",this.open=k?.open??!1,this.format=k?.format??"eml"}async send(k){let H=await N(k.attachments),P={...k,attachments:H},D=await L(P),F=await import("node:fs/promises");await F.mkdir(this.outDir,{recursive:!0});let Q=`${Date.now()}-${T(k.subject)}.${this.format}`,B=`${this.outDir}/${Q}`;if(this.format==="html"){let G=k.html??(k.text?`<pre>${k.text.replace(/&/g,"&").replace(/</g,"<").replace(/>/g,">")}</pre>`:"");await F.writeFile(B,G,"utf8")}else await F.writeFile(B,D.raw);if(console.log(`[sently preview] Written: ${B}`),this.open){let{spawn:G}=await import("node:child_process"),R=U(process.platform);G(R,[B],{detached:!0,stdio:"ignore"}).unref()}return{messageId:D.messageId,accepted:K(k.to),rejected:[],response:`preview: ${B}`,envelope:D.envelope}}async verify(){return{ok:!0,provider:"preview"}}}export{V as PreviewTransport};
|
|
2
2
|
|
|
3
|
-
//# debugId=
|
|
3
|
+
//# debugId=330FEA0BF1F96C2B64756E2164756E21
|
|
@@ -5,6 +5,6 @@
|
|
|
5
5
|
"/**\n * @module\n * PreviewTransport — development transport that writes emails to disk\n * instead of sending them. Optionally opens in the default browser.\n * Use in place of a real transport during local development.\n *\n * @example\n * ```ts\n * import { PreviewTransport } from 'sently/transports/preview'\n * const transport = new PreviewTransport({ outDir: './.emails', open: true })\n * ```\n */\nimport { extractEmails } from \"../core/address.js\";\nimport { buildMIME } from \"../core/mime.js\";\nimport type {\n MailOptions,\n PreviewConfig,\n SendResult,\n Transport,\n VerifyResult,\n} from \"../core/types.js\";\nimport { resolveAttachments } from \"./resolve-attachments.js\";\n\nfunction sanitizeSubject(subject: string): string {\n const sanitized = subject.replace(/[^a-zA-Z0-9]+/g, \"-\").replace(/^-|-$/g, \"\");\n return sanitized.slice(0, 40) || \"no-subject\";\n}\n\nfunction getOpenCommand(platform: string): string {\n if (platform === \"darwin\") {\n return \"open\";\n }\n if (platform === \"win32\") {\n return \"start\";\n }\n return \"xdg-open\";\n}\n\n/**\n * Development transport that writes emails to disk instead of sending them.\n */\nexport class PreviewTransport implements Transport {\n readonly provider = \"preview\";\n\n /** Directory where preview `.eml` or `.html` files are written. */\n private readonly outDir: string;\n /** Whether to open the written file in the default browser. */\n private readonly open: boolean;\n /** Output format: full MIME (`.eml`) or HTML body only. */\n private readonly format: \"eml\" | \"html\";\n\n /** Creates a preview transport with optional output directory and format. */\n constructor(config?: PreviewConfig) {\n this.outDir = config?.outDir ?? \"./.emails\";\n this.open = config?.open ?? false;\n this.format = config?.format ?? \"eml\";\n }\n\n /** Writes the message to disk and returns a synthetic SendResult. */\n async send(options: MailOptions): Promise<SendResult> {\n const attachments = await resolveAttachments(options.attachments);\n const resolvedOptions = { ...options, attachments };\n const mime = await buildMIME(resolvedOptions);\n\n const fs = await import(\"node:fs/promises\");\n await fs.mkdir(this.outDir, { recursive: true });\n\n const filename = `${Date.now()}-${sanitizeSubject(options.subject)}.${this.format}`;\n const filepath = `${this.outDir}/${filename}`;\n\n if (this.format === \"html\") {\n const html =\n options.html ??\n (options.text\n ? `<pre>${options.text.replace(/&/g, \"&\").replace(/</g, \"<\").replace(/>/g, \">\")}</pre>`\n : \"\");\n await fs.writeFile(filepath, html, \"utf8\");\n } else {\n await fs.writeFile(filepath, mime.raw);\n }\n\n console.log(`[sently preview] Written: ${filepath}`);\n\n if (this.open) {\n const { spawn } = await import(\"node:child_process\");\n const command = getOpenCommand(process.platform);\n spawn(command, [filepath], { detached: true, stdio: \"ignore\" }).unref();\n }\n\n return {\n messageId: mime.messageId,\n accepted: extractEmails(options.to),\n rejected: [],\n response: `preview: ${filepath}`,\n envelope: mime.envelope,\n };\n }\n\n /** Always succeeds — preview transport requires no external connectivity. */\n async verify(): Promise<VerifyResult> {\n return { ok: true, provider: \"preview\" };\n }\n}\n"
|
|
6
6
|
],
|
|
7
7
|
"mappings": "sNAuBA,IAAS,JAAe,JAAC,HAAyB,CAEhD,OADkB,EAAQ,QAAQ,iBAAkB,GAAG,EAAE,QAAQ,SAAU,EAAE,EAC5D,MAAM,EAAG,EAAE,GAAK,aAGnC,SAAS,CAAc,CAAC,EAA0B,CAChD,GAAI,IAAa,SACf,MAAO,OAET,GAAI,IAAa,QACf,MAAO,QAET,MAAO,WAMF,MAAM,CAAsC,CACxC,SAAW,UAGH,OAEA,KAEA,OAGjB,WAAW,CAAC,EAAwB,CAClC,KAAK,OAAS,GAAQ,QAAU,YAChC,KAAK,KAAO,GAAQ,MAAQ,GAC5B,KAAK,OAAS,GAAQ,QAAU,WAI5B,KAAI,CAAC,EAA2C,CACpD,IAAM,EAAc,MAAM,EAAmB,EAAQ,WAAW,EAC1D,EAAkB,IAAK,EAAS,aAAY,EAC5C,EAAO,MAAM,EAAU,CAAe,EAEtC,EAAK,KAAa,4BACxB,MAAM,EAAG,MAAM,KAAK,OAAQ,CAAE,UAAW,EAAK,CAAC,EAE/C,IAAM,EAAW,GAAG,KAAK,IAAI,KAAK,EAAgB,EAAQ,OAAO,KAAK,KAAK,SACrE,EAAW,GAAG,KAAK,UAAU,IAEnC,GAAI,KAAK,SAAW,OAAQ,CAC1B,IAAM,EACJ,EAAQ,OACP,EAAQ,KACL,QAAQ,EAAQ,KAAK,QAAQ,KAAM,OAAO,EAAE,QAAQ,KAAM,MAAM,EAAE,QAAQ,KAAM,MAAM,UACtF,IACN,MAAM,EAAG,UAAU,EAAU,EAAM,MAAM,EAEzC,WAAM,EAAG,UAAU,EAAU,EAAK,GAAG,EAKvC,GAFA,QAAQ,IAAI,6BAA6B,GAAU,EAE/C,KAAK,KAAM,CACb,IAAQ,SAAU,KAAa,8BACzB,EAAU,EAAe,QAAQ,QAAQ,EAC/C,EAAM,EAAS,CAAC,CAAQ,EAAG,CAAE,SAAU,GAAM,MAAO,QAAS,CAAC,EAAE,MAAM,EAGxE,MAAO,CACL,UAAW,EAAK,UAChB,SAAU,EAAc,EAAQ,EAAE,EAClC,SAAU,CAAC,EACX,SAAU,YAAY,IACtB,SAAU,EAAK,QACjB,OAII,OAAM,EAA0B,CACpC,MAAO,CAAE,GAAI,GAAM,SAAU,SAAU,EAE3C",
|
|
8
|
-
"debugId": "
|
|
8
|
+
"debugId": "330FEA0BF1F96C2B64756E2164756E21",
|
|
9
9
|
"names": []
|
|
10
10
|
}
|
|
@@ -1,3 +1,3 @@
|
|
|
1
|
-
import{
|
|
1
|
+
import{J as b}from"../chunk-bhr7w3gg.js";import{K as X}from"../chunk-1ke3nmyg.js";import{Q as N}from"../chunk-7wtfjx0d.js";import{S as $,T as v,U as G}from"../chunk-8kpgbrba.js";import{da as V}from"../chunk-hnzmn4s4.js";import{ja as I,ka as K}from"../chunk-ttbwyxmh.js";import"../chunk-th4cwrpb.js";var Z=100;class Y extends I{statusCode;apiError;constructor(q,w,z){super(q,K(w),{statusCode:w,provider:"resend",cause:z});this.statusCode=w;this.apiError=z;this.name="ResendError"}}class H{provider="resend";apiKey;baseUrl;rateLimiter;batchMax=Z;constructor(q){this.apiKey=q.apiKey,this.baseUrl=q.baseUrl??"https://api.resend.com";let w=q.rateDelta??2;if(w>0)this.rateLimiter=new N(w,q.rateLimit??1000);else this.rateLimiter=null}async buildEmailBody(q){let w=await X(q.attachments),z=$(q.from)[0];return{from:z?v(z):"",to:G(q.to),subject:q.subject,...q.cc?{cc:G(q.cc)}:{},...q.bcc?{bcc:G(q.bcc)}:{},...q.replyTo?{reply_to:G(q.replyTo)}:{},...q.text?{text:q.text}:{},...q.html?{html:q.html}:{},...q.headers?{headers:q.headers}:{},...w.length>0?{attachments:w.map((F)=>({filename:F.filename,content:F.content instanceof Uint8Array?V(F.content).replace(/\r\n/g,""):F.content,...F.contentType?{content_type:F.contentType}:{}}))}:{}}}toSendResult(q,w){let z=$(q.from)[0];return{messageId:w.id??q.messageId??"",accepted:G(q.to),rejected:[],response:w.message??"Email sent",envelope:{from:z?.address??"",to:[...G(q.to),...q.cc?G(q.cc):[],...q.bcc?G(q.bcc):[]]},...w.batchError!==void 0?{batchError:w.batchError}:{}}}async send(q){let w=await this.buildEmailBody(q),z=b(q),F=await fetch(`${this.baseUrl}/emails`,{method:"POST",headers:{Authorization:`Bearer ${this.apiKey}`,"Content-Type":"application/json",...z?{"Idempotency-Key":z}:{}},body:JSON.stringify(w)}),O=await F.json();if(!F.ok)throw new Y(O.message??"Resend API error",F.status,O);return this.toSendResult(q,O)}async sendBatch(q){if(q.length===0)return[];let w=[];for(let z=0;z<q.length;z+=Z){if(z>0&&this.rateLimiter)await this.rateLimiter.acquire();let F=q.slice(z,z+Z),O=await Promise.all(F.map((J)=>this.buildEmailBody(J))),U=await fetch(`${this.baseUrl}/emails/batch`,{method:"POST",headers:{Authorization:`Bearer ${this.apiKey}`,"Content-Type":"application/json"},body:JSON.stringify(O)}),Q=await U.json();if(!U.ok)throw new Y(Q.message??"Resend batch API error",U.status,Q);let B=Q.data??[];for(let J=0;J<F.length;J++){let L=F[J],W=B[J];if(W?.id!==void 0){w.push(this.toSendResult(L,{id:W.id,...Q.message!==void 0?{message:Q.message}:{}}));continue}let P=W?.error??"Batch item failed";w.push(this.toSendResult(L,{message:P,batchError:new Y(P,U.status,W??{})}))}}return w}async verify(){try{let q=await fetch(`${this.baseUrl}/domains`,{headers:{Authorization:`Bearer ${this.apiKey}`}});if(!q.ok)return{ok:!1,provider:"resend",message:(await q.json().catch(()=>({}))).message??`HTTP ${q.status}`};return{ok:!0,provider:"resend",message:"API key is valid"}}catch(q){return{ok:!1,provider:"resend",message:q instanceof Error?q.message:String(q)}}}}export{H as ResendTransport,Y as ResendError,Z as RESEND_BATCH_MAX};
|
|
2
2
|
|
|
3
|
-
//# debugId=
|
|
3
|
+
//# debugId=6006A88A68626BB864756E2164756E21
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
"sourcesContent": [
|
|
5
5
|
"/**\n * @module\n * Resend HTTP API transport for sending email via api.resend.com.\n *\n * @example\n * ```ts\n * import { ResendTransport } from \"sently/transports/resend\";\n * import { createMailer } from \"sently/mailer\";\n *\n * const mailer = await createMailer({\n * transport: new ResendTransport({ apiKey: process.env.RESEND_API_KEY! }),\n * });\n *\n * await mailer.send({\n * from: \"onboarding@yourdomain.com\",\n * to: \"recipient@example.com\",\n * subject: \"Hello\",\n * html: \"<p>Sent via Resend</p>\",\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 { resolveIdempotencyKey } from \"../core/idempotency-key.js\";\nimport { RateLimiter } from \"../core/rate-limiter.js\";\nimport type { MailOptions, SendResult, Transport, VerifyResult } from \"../core/types.js\";\nimport { resolveAttachments } from \"./resolve-attachments.js\";\n\n/** Resend API configuration. */\nexport interface ResendConfig {\n /** Resend API key (starts with `re_`). */\n apiKey: string;\n /** API base URL. Default: `https://api.resend.com`. */\n baseUrl?: string;\n /** Max batch HTTP requests per rate window. Default: `2` (Resend API limit). Set `0` to disable. */\n rateDelta?: number;\n /** Rate limit window in milliseconds. Default: `1000`. */\n rateLimit?: number;\n}\n\n/** Maximum messages per Resend batch request (overridable per account). */\nexport const RESEND_BATCH_MAX = 100;\n\n/** Error thrown when the Resend API returns a non-success response. */\nexport class ResendError extends SentlyError {\n /** Creates a Resend 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: \"resend\",\n cause: apiError,\n });\n this.name = \"ResendError\";\n }\n}\n\n/**\n * Resend HTTP API transport.\n */\nexport class ResendTransport implements Transport {\n readonly provider = \"resend\";\n\n /** Resend API key for Bearer authentication. */\n private readonly apiKey: string;\n /** Resend API base URL. */\n private readonly baseUrl: string;\n /** Optional rate limiter for multi-chunk batch sends. */\n private readonly rateLimiter: RateLimiter | null;\n\n /** Maximum messages per batch HTTP request. */\n readonly batchMax = RESEND_BATCH_MAX;\n\n /** Creates a Resend transport with the given API key. */\n constructor(config: ResendConfig) {\n this.apiKey = config.apiKey;\n this.baseUrl = config.baseUrl ?? \"https://api.resend.com\";\n\n const rateDelta = config.rateDelta ?? 2;\n if (rateDelta > 0) {\n this.rateLimiter = new RateLimiter(rateDelta, config.rateLimit ?? 1000);\n } else {\n this.rateLimiter = null;\n }\n }\n\n /** Build the JSON body for a single Resend email. */\n private async buildEmailBody(options: MailOptions): Promise<Record<string, unknown>> {\n const attachments = await resolveAttachments(options.attachments);\n const from = parseAddresses(options.from)[0];\n return {\n from: from ? toMIMEHeader(from) : \"\",\n to: extractEmails(options.to),\n subject: options.subject,\n ...(options.cc ? { cc: extractEmails(options.cc) } : {}),\n ...(options.bcc ? { bcc: extractEmails(options.bcc) } : {}),\n ...(options.replyTo ? { reply_to: extractEmails(options.replyTo) } : {}),\n ...(options.text ? { text: options.text } : {}),\n ...(options.html ? { html: options.html } : {}),\n ...(options.headers ? { headers: options.headers } : {}),\n ...(attachments.length > 0\n ? {\n attachments: attachments.map((att) => ({\n filename: att.filename,\n content:\n att.content instanceof Uint8Array\n ? encodeBase64(att.content).replace(/\\r\\n/g, \"\")\n : att.content,\n ...(att.contentType ? { content_type: att.contentType } : {}),\n })),\n }\n : {}),\n };\n }\n\n /** Map a Resend API response id to a normalized SendResult. */\n private toSendResult(\n options: MailOptions,\n payload: { id?: string; message?: string; batchError?: unknown },\n ): SendResult {\n const from = parseAddresses(options.from)[0];\n return {\n messageId: payload.id ?? options.messageId ?? \"\",\n accepted: extractEmails(options.to),\n rejected: [],\n response: payload.message ?? \"Email sent\",\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 ...(payload.batchError !== undefined ? { batchError: payload.batchError } : {}),\n };\n }\n\n /** Sends an email via the Resend HTTP API. */\n async send(options: MailOptions): Promise<SendResult> {\n const body = await this.buildEmailBody(options);\n const idempotencyKey = resolveIdempotencyKey(options);\n\n const response = await fetch(`${this.baseUrl}/emails`, {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${this.apiKey}`,\n \"Content-Type\": \"application/json\",\n ...(idempotencyKey ? { \"Idempotency-Key\": idempotencyKey } : {}),\n },\n body: JSON.stringify(body),\n });\n\n const payload = (await response.json()) as { id?: string; message?: string };\n\n if (!response.ok) {\n throw new ResendError(payload.message ?? \"Resend API error\", response.status, payload);\n }\n\n return this.toSendResult(options, payload);\n }\n\n /** Send up to {@link RESEND_BATCH_MAX} attachment-free messages per batch request. */\n async sendBatch(messages: MailOptions[]): Promise<SendResult[]> {\n if (messages.length === 0) {\n return [];\n }\n\n const results: SendResult[] = [];\n for (let offset = 0; offset < messages.length; offset += RESEND_BATCH_MAX) {\n if (offset > 0 && this.rateLimiter) {\n await this.rateLimiter.acquire();\n }\n\n const chunk = messages.slice(offset, offset + RESEND_BATCH_MAX);\n const bodies = await Promise.all(chunk.map((message) => this.buildEmailBody(message)));\n\n const response = await fetch(`${this.baseUrl}/emails/batch`, {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${this.apiKey}`,\n \"Content-Type\": \"application/json\",\n },\n body: JSON.stringify(bodies),\n });\n\n const payload = (await response.json()) as {\n data?: Array<{ id?: string; error?: string }>;\n message?: string;\n };\n\n if (!response.ok) {\n throw new ResendError(\n payload.message ?? \"Resend batch API error\",\n response.status,\n payload,\n );\n }\n\n const ids = payload.data ?? [];\n for (let i = 0; i < chunk.length; i++) {\n const message = chunk[i] as MailOptions;\n const item = ids[i];\n if (item?.id !== undefined) {\n results.push(\n this.toSendResult(message, {\n id: item.id,\n ...(payload.message !== undefined ? { message: payload.message } : {}),\n }),\n );\n continue;\n }\n\n const errorMessage = item?.error ?? \"Batch item failed\";\n results.push(\n this.toSendResult(message, {\n message: errorMessage,\n batchError: new ResendError(errorMessage, response.status, item ?? {}),\n }),\n );\n }\n }\n\n return results;\n }\n\n /** Verifies the Resend API key by listing domains. */\n async verify(): Promise<VerifyResult> {\n try {\n const response = await fetch(`${this.baseUrl}/domains`, {\n headers: {\n Authorization: `Bearer ${this.apiKey}`,\n },\n });\n\n if (!response.ok) {\n const payload = (await response.json().catch(() => ({}))) as { message?: string };\n return {\n ok: false,\n provider: \"resend\",\n message: payload.message ?? `HTTP ${response.status}`,\n };\n }\n\n return { ok: true, provider: \"resend\", message: \"API key is valid\" };\n } catch (err) {\n return {\n ok: false,\n provider: \"resend\",\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": "6006A88A68626BB864756E2164756E21",
|
|
9
9
|
"names": []
|
|
10
10
|
}
|
|
@@ -1,8 +1,27 @@
|
|
|
1
|
-
|
|
1
|
+
/**
|
|
2
|
+
* @module
|
|
3
|
+
* RetryTransport — decorator that wraps any sently channel transport
|
|
4
|
+
* and retries failed sends with configurable backoff.
|
|
5
|
+
* Works with email, SMS, WhatsApp, and push transports.
|
|
6
|
+
*
|
|
7
|
+
* @example
|
|
8
|
+
* ```ts
|
|
9
|
+
* import { RetryTransport } from 'sently/transports/retry'
|
|
10
|
+
* import { ResendTransport } from 'sently/transports/resend'
|
|
11
|
+
*
|
|
12
|
+
* const transport = new RetryTransport(
|
|
13
|
+
* new ResendTransport({ apiKey }),
|
|
14
|
+
* { maxAttempts: 3, backoff: 'exponential', retryOn: [429, 503] }
|
|
15
|
+
* )
|
|
16
|
+
* ```
|
|
17
|
+
*/
|
|
18
|
+
import type { DecoratedTransport } from "../core/decorated-transport.js";
|
|
19
|
+
import type { MailOptions, RetryConfig, SendResult, VerifyResult } from "../core/types.js";
|
|
2
20
|
/**
|
|
3
21
|
* Decorator transport that retries failed sends with configurable backoff.
|
|
22
|
+
* Defaults preserve email {@link Transport} compatibility.
|
|
4
23
|
*/
|
|
5
|
-
export declare class RetryTransport implements
|
|
24
|
+
export declare class RetryTransport<TOptions = MailOptions, TResult = SendResult> implements DecoratedTransport<TOptions, TResult> {
|
|
6
25
|
/** Transport that performs the actual send on each attempt. */
|
|
7
26
|
private readonly inner;
|
|
8
27
|
/** Injectable sleep function for testing backoff timing. */
|
|
@@ -18,27 +37,27 @@ export declare class RetryTransport implements Transport {
|
|
|
18
37
|
private readonly retryOn;
|
|
19
38
|
/** Optional callback invoked before each retry attempt. */
|
|
20
39
|
private readonly onRetry;
|
|
21
|
-
/** Additional onRetry callback wired by
|
|
40
|
+
/** Additional onRetry callback wired by sender lifecycle hooks per send. */
|
|
22
41
|
private mailerOnRetry;
|
|
23
42
|
/** Wraps an inner transport with retry logic and optional backoff configuration. */
|
|
24
43
|
constructor(
|
|
25
44
|
/** Transport that performs the actual send on each attempt. */
|
|
26
|
-
inner:
|
|
45
|
+
inner: DecoratedTransport<TOptions, TResult>, config?: RetryConfig,
|
|
27
46
|
/** Injectable sleep function for testing backoff timing. */
|
|
28
47
|
_sleep?: (ms: number) => Promise<void>);
|
|
29
48
|
/**
|
|
30
|
-
* Register a per-send onRetry callback from
|
|
31
|
-
* Do not share one {@link RetryTransport} across multiple
|
|
49
|
+
* Register a per-send onRetry callback from sender lifecycle hooks.
|
|
50
|
+
* Do not share one {@link RetryTransport} across multiple senders — the last
|
|
32
51
|
* `setMailerOnRetry` wins; overwriting an active callback logs a dev warning.
|
|
33
|
-
* @internal
|
|
52
|
+
* @internal Cleared after each send.
|
|
34
53
|
*/
|
|
35
54
|
setMailerOnRetry(callback: RetryConfig["onRetry"] | undefined): void;
|
|
36
55
|
/** Sends with retries according to configured backoff and retry rules. */
|
|
37
|
-
send(options:
|
|
56
|
+
send(options: TOptions): Promise<TResult>;
|
|
38
57
|
/** Delegates to the inner transport verify or returns a default success result. */
|
|
39
58
|
verify(): Promise<VerifyResult>;
|
|
40
59
|
/** Delegates close to the inner transport if available. */
|
|
41
60
|
close(): Promise<void>;
|
|
42
61
|
/** Delegates batch sends to the inner transport when available. */
|
|
43
|
-
sendBatch(messages:
|
|
62
|
+
sendBatch(messages: TOptions[]): Promise<TResult[]>;
|
|
44
63
|
}
|
package/dist/transports/retry.js
CHANGED
|
@@ -1,3 +1,3 @@
|
|
|
1
|
-
import{
|
|
1
|
+
import{ja as G}from"../chunk-ttbwyxmh.js";import"../chunk-th4cwrpb.js";var H=[429,500,502,503,504];function I(q,x,z){if(x==="exponential")return z*2**(q-1);if(x==="linear")return z*q;return z}function J(q,x){if(q instanceof G&&q.sentlyCode==="SMTP_AUTH_FAILED")return!1;if(typeof q==="object"&&q!==null&&"statusCode"in q&&typeof q.statusCode==="number")return x.includes(q.statusCode);return!0}class K{inner;_sleep;provider="retry";maxAttempts;backoff;baseDelay;retryOn;onRetry;mailerOnRetry;constructor(q,x,z=(B)=>new Promise((C)=>setTimeout(C,B))){this.inner=q;this._sleep=z;this.maxAttempts=x?.maxAttempts??3,this.backoff=x?.backoff??"exponential",this.baseDelay=x?.baseDelay??1000,this.retryOn=x?.retryOn??H,this.onRetry=x?.onRetry,this.mailerOnRetry=void 0}setMailerOnRetry(q){if(q!==void 0&&this.mailerOnRetry!==void 0&&this.mailerOnRetry!==q){if(!(typeof process<"u"&&process.env?.NODE_ENV==="production"))console.warn("[sently] RetryTransport.setMailerOnRetry: overwriting an active mailer onRetry callback. Do not share one RetryTransport instance across multiple senders.")}this.mailerOnRetry=q}async send(q){let x;for(let z=1;z<=this.maxAttempts;z++)try{return await this.inner.send(q)}catch(B){if(x=B,z===this.maxAttempts)throw B;if(!J(B,this.retryOn))throw B;let C=I(z,this.backoff,this.baseDelay);this.onRetry?.(z,B),this.mailerOnRetry?.(z,B),await this._sleep(C)}throw x}async verify(){if(this.inner.verify)return this.inner.verify();return{ok:!0,provider:"retry"}}async close(){await this.inner.close?.()}async sendBatch(q){if(this.inner.sendBatch)return this.inner.sendBatch(q);return Promise.all(q.map((x)=>this.send(x)))}}export{K as RetryTransport};
|
|
2
2
|
|
|
3
|
-
//# debugId=
|
|
3
|
+
//# debugId=F115F560369E227A64756E2164756E21
|
|
@@ -2,9 +2,9 @@
|
|
|
2
2
|
"version": 3,
|
|
3
3
|
"sources": ["../src/transports/retry.ts"],
|
|
4
4
|
"sourcesContent": [
|
|
5
|
-
"/**\n * @module\n * RetryTransport — decorator that wraps any sently transport\n * and retries failed sends with configurable backoff.\n * Works with
|
|
5
|
+
"/**\n * @module\n * RetryTransport — decorator that wraps any sently channel transport\n * and retries failed sends with configurable backoff.\n * Works with email, SMS, WhatsApp, and push transports.\n *\n * @example\n * ```ts\n * import { RetryTransport } from 'sently/transports/retry'\n * import { ResendTransport } from 'sently/transports/resend'\n *\n * const transport = new RetryTransport(\n * new ResendTransport({ apiKey }),\n * { maxAttempts: 3, backoff: 'exponential', retryOn: [429, 503] }\n * )\n * ```\n */\nimport type { DecoratedTransport } from \"../core/decorated-transport.js\";\nimport { SentlyError } from \"../core/errors.js\";\nimport type { MailOptions, RetryConfig, SendResult, VerifyResult } from \"../core/types.js\";\n\nconst DEFAULT_RETRY_ON = [429, 500, 502, 503, 504];\n\nfunction computeDelay(attempt: number, backoff: string, base: number): number {\n if (backoff === \"exponential\") {\n return base * 2 ** (attempt - 1);\n }\n if (backoff === \"linear\") {\n return base * attempt;\n }\n return base;\n}\n\nfunction shouldRetry(err: unknown, retryOn: number[]): boolean {\n if (err instanceof SentlyError && err.sentlyCode === \"SMTP_AUTH_FAILED\") {\n return false;\n }\n\n if (\n typeof err === \"object\" &&\n err !== null &&\n \"statusCode\" in err &&\n typeof (err as { statusCode: unknown }).statusCode === \"number\"\n ) {\n return retryOn.includes((err as { statusCode: number }).statusCode);\n }\n\n return true;\n}\n\n/**\n * Decorator transport that retries failed sends with configurable backoff.\n * Defaults preserve email {@link Transport} compatibility.\n */\nexport class RetryTransport<TOptions = MailOptions, TResult = SendResult>\n implements DecoratedTransport<TOptions, TResult>\n{\n readonly provider = \"retry\";\n\n /** Maximum send attempts including the initial try. */\n private readonly maxAttempts: number;\n /** Backoff strategy between retries. */\n private readonly backoff: \"exponential\" | \"linear\" | \"fixed\";\n /** Base delay in milliseconds before the first retry. */\n private readonly baseDelay: number;\n /** HTTP status codes that trigger a retry. */\n private readonly retryOn: number[];\n /** Optional callback invoked before each retry attempt. */\n private readonly onRetry: RetryConfig[\"onRetry\"];\n /** Additional onRetry callback wired by sender lifecycle hooks per send. */\n private mailerOnRetry: RetryConfig[\"onRetry\"];\n\n /** Wraps an inner transport with retry logic and optional backoff configuration. */\n constructor(\n /** Transport that performs the actual send on each attempt. */\n private readonly inner: DecoratedTransport<TOptions, TResult>,\n config?: RetryConfig,\n /** Injectable sleep function for testing backoff timing. */\n private readonly _sleep: (ms: number) => Promise<void> = (ms) =>\n new Promise((resolve) => setTimeout(resolve, ms)),\n ) {\n this.maxAttempts = config?.maxAttempts ?? 3;\n this.backoff = config?.backoff ?? \"exponential\";\n this.baseDelay = config?.baseDelay ?? 1000;\n this.retryOn = config?.retryOn ?? DEFAULT_RETRY_ON;\n this.onRetry = config?.onRetry;\n this.mailerOnRetry = undefined;\n }\n\n /**\n * Register a per-send onRetry callback from sender lifecycle hooks.\n * Do not share one {@link RetryTransport} across multiple senders — the last\n * `setMailerOnRetry` wins; overwriting an active callback logs a dev warning.\n * @internal Cleared after each send.\n */\n setMailerOnRetry(callback: RetryConfig[\"onRetry\"] | undefined): void {\n if (\n callback !== undefined &&\n this.mailerOnRetry !== undefined &&\n this.mailerOnRetry !== callback\n ) {\n const isProduction = typeof process !== \"undefined\" && process.env?.NODE_ENV === \"production\";\n if (!isProduction) {\n console.warn(\n \"[sently] RetryTransport.setMailerOnRetry: overwriting an active mailer onRetry callback. Do not share one RetryTransport instance across multiple senders.\",\n );\n }\n }\n this.mailerOnRetry = callback;\n }\n\n /** Sends with retries according to configured backoff and retry rules. */\n async send(options: TOptions): Promise<TResult> {\n let lastError: unknown;\n\n for (let attempt = 1; attempt <= this.maxAttempts; attempt++) {\n try {\n return await this.inner.send(options);\n } catch (err) {\n lastError = err;\n if (attempt === this.maxAttempts) {\n throw err;\n }\n if (!shouldRetry(err, this.retryOn)) {\n throw err;\n }\n const delay = computeDelay(attempt, this.backoff, this.baseDelay);\n this.onRetry?.(attempt, err);\n this.mailerOnRetry?.(attempt, err);\n await this._sleep(delay);\n }\n }\n\n throw lastError;\n }\n\n /** Delegates to the inner transport verify or returns a default success result. */\n async verify(): Promise<VerifyResult> {\n if (this.inner.verify) {\n return this.inner.verify();\n }\n return { ok: true, provider: \"retry\" };\n }\n\n /** Delegates close to the inner transport if available. */\n async close(): Promise<void> {\n await this.inner.close?.();\n }\n\n /** Delegates batch sends to the inner transport when available. */\n async sendBatch(messages: TOptions[]): Promise<TResult[]> {\n if (this.inner.sendBatch) {\n return this.inner.sendBatch(messages);\n }\n return Promise.all(messages.map((message) => this.send(message)));\n }\n}\n"
|
|
6
6
|
],
|
|
7
|
-
"mappings": "
|
|
8
|
-
"debugId": "
|
|
7
|
+
"mappings": "4EAqBA,DAAM,EAAmB,CAAC,IAAK,IAAK,IAAK,IAAK,GAAG,EAEjD,SAAS,CAAY,CAAC,EAAiB,EAAiB,EAAsB,CAC5E,GAAI,IAAY,cACd,OAAO,EAAO,IAAM,EAAU,GAEhC,GAAI,IAAY,SACd,OAAO,EAAO,EAEhB,OAAO,EAGT,SAAS,CAAW,CAAC,EAAc,EAA4B,CAC7D,GAAI,aAAe,GAAe,EAAI,aAAe,mBACnD,MAAO,GAGT,GACE,OAAO,IAAQ,UACf,IAAQ,MACR,eAAgB,GAChB,OAAQ,EAAgC,aAAe,SAEvD,OAAO,EAAQ,SAAU,EAA+B,UAAU,EAGpE,MAAO,GAOF,MAAM,CAEb,CAmBqB,MAGA,OArBV,SAAW,QAGH,YAEA,QAEA,UAEA,QAEA,QAET,cAGR,WAAW,CAEQ,EACjB,EAEiB,EAAwC,CAAC,IACxD,IAAI,QAAQ,CAAC,IAAY,WAAW,EAAS,CAAE,CAAC,EAClD,CALiB,aAGA,cAGjB,KAAK,YAAc,GAAQ,aAAe,EAC1C,KAAK,QAAU,GAAQ,SAAW,cAClC,KAAK,UAAY,GAAQ,WAAa,KACtC,KAAK,QAAU,GAAQ,SAAW,EAClC,KAAK,QAAU,GAAQ,QACvB,KAAK,cAAgB,OASvB,gBAAgB,CAAC,EAAoD,CACnE,GACE,IAAa,QACb,KAAK,gBAAkB,QACvB,KAAK,gBAAkB,GAGvB,GAAI,EADiB,OAAO,QAAY,KAAe,QAAQ,KAAK,WAAa,cAE/E,QAAQ,KACN,4JACF,EAGJ,KAAK,cAAgB,OAIjB,KAAI,CAAC,EAAqC,CAC9C,IAAI,EAEJ,QAAS,EAAU,EAAG,GAAW,KAAK,YAAa,IACjD,GAAI,CACF,OAAO,MAAM,KAAK,MAAM,KAAK,CAAO,EACpC,MAAO,EAAK,CAEZ,GADA,EAAY,EACR,IAAY,KAAK,YACnB,MAAM,EAER,GAAI,CAAC,EAAY,EAAK,KAAK,OAAO,EAChC,MAAM,EAER,IAAM,EAAQ,EAAa,EAAS,KAAK,QAAS,KAAK,SAAS,EAChE,KAAK,UAAU,EAAS,CAAG,EAC3B,KAAK,gBAAgB,EAAS,CAAG,EACjC,MAAM,KAAK,OAAO,CAAK,EAI3B,MAAM,OAIF,OAAM,EAA0B,CACpC,GAAI,KAAK,MAAM,OACb,OAAO,KAAK,MAAM,OAAO,EAE3B,MAAO,CAAE,GAAI,GAAM,SAAU,OAAQ,OAIjC,MAAK,EAAkB,CAC3B,MAAM,KAAK,MAAM,QAAQ,OAIrB,UAAS,CAAC,EAA0C,CACxD,GAAI,KAAK,MAAM,UACb,OAAO,KAAK,MAAM,UAAU,CAAQ,EAEtC,OAAO,QAAQ,IAAI,EAAS,IAAI,CAAC,IAAY,KAAK,KAAK,CAAO,CAAC,CAAC,EAEpE",
|
|
8
|
+
"debugId": "F115F560369E227A64756E2164756E21",
|
|
9
9
|
"names": []
|
|
10
10
|
}
|
|
@@ -1,3 +1,3 @@
|
|
|
1
|
-
import{
|
|
1
|
+
import{K as R}from"../chunk-1ke3nmyg.js";import{S as H,U as K}from"../chunk-8kpgbrba.js";import{da as N}from"../chunk-hnzmn4s4.js";import{ja as O,ka as Q}from"../chunk-ttbwyxmh.js";import"../chunk-th4cwrpb.js";class M extends O{statusCode;apiError;constructor(q,w,D){super(q,Q(w),{statusCode:w,provider:"sendgrid",cause:D});this.statusCode=w;this.apiError=D;this.name="SendGridError"}}class U{provider="sendgrid";apiKey;constructor(q){this.apiKey=q.apiKey}buildPersonalization(q){return{to:H(q.to).map((w)=>({email:w.address,name:w.name})),...q.cc?{cc:H(q.cc).map((w)=>({email:w.address,name:w.name}))}:{},...q.bcc?{bcc:H(q.bcc).map((w)=>({email:w.address,name:w.name}))}:{},subject:q.subject,...q.headers?{headers:q.headers}:{}}}buildContent(q){return[...q.text?[{type:"text/plain",value:q.text}]:[],...q.html?[{type:"text/html",value:q.html}]:[]]}toSendResult(q,w,D="Accepted"){let J=H(q.from)[0];return{messageId:w,accepted:K(q.to),rejected:[],response:D,envelope:{from:J?.address??"",to:[...K(q.to),...q.cc?K(q.cc):[],...q.bcc?K(q.bcc):[]]}}}async send(q){let w=await R(q.attachments),D=H(q.from)[0],J={personalizations:[this.buildPersonalization(q)],from:D?{email:D.address,...D.name?{name:D.name}:{}}:{email:""},...q.replyTo?{reply_to:H(q.replyTo).map((z)=>({email:z.address,name:z.name}))[0]}:{},content:this.buildContent(q),...w.length>0?{attachments:w.map((z)=>({filename:z.filename,type:z.contentType??"application/octet-stream",content:z.content instanceof Uint8Array?N(z.content).replace(/\r\n/g,""):z.content,...z.contentId?{content_id:z.contentId}:{},disposition:z.inline?"inline":"attachment"}))}:{}},F=await fetch("https://api.sendgrid.com/v3/mail/send",{method:"POST",headers:{Authorization:`Bearer ${this.apiKey}`,"Content-Type":"application/json"},body:JSON.stringify(J)});if(!F.ok){let z=await F.text();throw new M("SendGrid API error",F.status,z)}let L=F.headers.get("x-message-id")??q.messageId??"";return this.toSendResult(q,L)}async sendBatch(q){if(q.length===0)return[];let w=q[0],D=H(w.from)[0],J={personalizations:q.map((z)=>this.buildPersonalization(z)),from:D?{email:D.address,...D.name?{name:D.name}:{}}:{email:""},...w.replyTo?{reply_to:H(w.replyTo).map((z)=>({email:z.address,name:z.name}))[0]}:{},content:this.buildContent(w)},F=await fetch("https://api.sendgrid.com/v3/mail/send",{method:"POST",headers:{Authorization:`Bearer ${this.apiKey}`,"Content-Type":"application/json"},body:JSON.stringify(J)});if(!F.ok){let z=await F.text();throw new M("SendGrid API error",F.status,z)}let L=F.headers.get("x-message-id")??"";return q.map((z)=>this.toSendResult(z,L||z.messageId||""))}async verify(){try{let q=await fetch("https://api.sendgrid.com/v3/user/profile",{headers:{Authorization:`Bearer ${this.apiKey}`}});if(!q.ok)return{ok:!1,provider:"sendgrid",message:await q.text().catch(()=>"")||`HTTP ${q.status}`};let w=await q.json();return{ok:!0,provider:"sendgrid",...w.username?{message:w.username}:{}}}catch(q){return{ok:!1,provider:"sendgrid",message:q instanceof Error?q.message:String(q)}}}}export{U as SendGridTransport,M as SendGridError};
|
|
2
2
|
|
|
3
|
-
//# debugId=
|
|
3
|
+
//# debugId=603F05A2076CBCA364756E2164756E21
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
"sourcesContent": [
|
|
5
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": "603F05A2076CBCA364756E2164756E21",
|
|
9
9
|
"names": []
|
|
10
10
|
}
|
package/dist/transports/ses.js
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
|
-
import{
|
|
1
|
+
import{w as v}from"../chunk-yg3kj723.js";import{K as b}from"../chunk-1ke3nmyg.js";import{S as C,T as R,U as D}from"../chunk-8kpgbrba.js";import{da as x}from"../chunk-hnzmn4s4.js";import{ja as A,ka as k}from"../chunk-ttbwyxmh.js";import"../chunk-th4cwrpb.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
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=64EB4A6F1F66261A64756E2164756E21
|
|
@@ -5,7 +5,7 @@
|
|
|
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
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": "64EB4A6F1F66261A64756E2164756E21",
|
|
10
10
|
"names": []
|
|
11
11
|
}
|
package/dist/transports/smtp.js
CHANGED
|
@@ -1,3 +1,3 @@
|
|
|
1
|
-
import{
|
|
1
|
+
import{n as c,o as d,p as e,q as f,r as g,s as h}from"../chunk-a057jzsy.js";import"../chunk-f5x8vesr.js";import"../chunk-yg3kj723.js";import{I as b,y as a}from"../chunk-w4c9kj70.js";import"../chunk-1ke3nmyg.js";import"../chunk-8kpgbrba.js";import"../chunk-hnzmn4s4.js";import"../chunk-ttbwyxmh.js";import"../chunk-th4cwrpb.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=8DFA86AED4A5A20E64756E2164756E21
|
package/dist/transports/sndr.js
CHANGED
|
@@ -1,3 +1,3 @@
|
|
|
1
|
-
import{
|
|
1
|
+
import{J as V}from"../chunk-bhr7w3gg.js";import{S as W,T as Z,U as B}from"../chunk-8kpgbrba.js";import"../chunk-hnzmn4s4.js";import{ja as $,ka as G}from"../chunk-ttbwyxmh.js";import"../chunk-th4cwrpb.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
2
|
|
|
3
|
-
//# debugId=
|
|
3
|
+
//# debugId=0CA0AE7BD8D22B3F64756E2164756E21
|
|
@@ -5,6 +5,6 @@
|
|
|
5
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
6
|
],
|
|
7
7
|
"mappings": "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",
|
|
8
|
-
"debugId": "
|
|
8
|
+
"debugId": "0CA0AE7BD8D22B3F64756E2164756E21",
|
|
9
9
|
"names": []
|
|
10
10
|
}
|