ark-email 0.5.1

package/resources/emails.js

@@ -0,0 +1,173 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Emails = void 0;
+const resource_1 = require("../core/resource.js");
+const pagination_1 = require("../core/pagination.js");
+const headers_1 = require("../internal/headers.js");
+const path_1 = require("../internal/utils/path.js");
+class Emails extends resource_1.APIResource {
+    /**
+     * Retrieve detailed information about a specific email including delivery status,
+     * timestamps, and optionally the email content.
+     *
+     * Use the `expand` parameter to include additional data like the HTML/text body,
+     * headers, or delivery attempts.
+     *
+     * @example
+     * ```ts
+     * const email = await client.emails.retrieve('emailId');
+     * ```
+     */
+    retrieve(emailID, query = {}, options) {
+        return this._client.get((0, path_1.path) `/emails/${emailID}`, { query, ...options });
+    }
+    /**
+     * Retrieve a paginated list of sent emails. Results are ordered by send time,
+     * newest first.
+     *
+     * Use filters to narrow down results by status, recipient, sender, or tag.
+     *
+     * **Related endpoints:**
+     *
+     * - `GET /emails/{id}` - Get full details of a specific email
+     * - `POST /emails` - Send a new email
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const emailListResponse of client.emails.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(query = {}, options) {
+        return this._client.getAPIList('/emails', (pagination_1.PageNumberPagination), { query, ...options });
+    }
+    /**
+     * Get the history of delivery attempts for an email, including SMTP response codes
+     * and timestamps.
+     *
+     * @example
+     * ```ts
+     * const response = await client.emails.retrieveDeliveries(
+     *   'emailId',
+     * );
+     * ```
+     */
+    retrieveDeliveries(emailID, options) {
+        return this._client.get((0, path_1.path) `/emails/${emailID}/deliveries`, options);
+    }
+    /**
+     * Retry delivery of a failed or soft-bounced email. Creates a new delivery
+     * attempt.
+     *
+     * Only works for emails that have failed or are in a retryable state.
+     *
+     * @example
+     * ```ts
+     * const response = await client.emails.retry('emailId');
+     * ```
+     */
+    retry(emailID, options) {
+        return this._client.post((0, path_1.path) `/emails/${emailID}/retry`, options);
+    }
+    /**
+     * Send a single email message. The email is accepted for immediate delivery and
+     * typically delivered within seconds.
+     *
+     * **Example use case:** Send a password reset email to a user.
+     *
+     * **Required fields:** `from`, `to`, `subject`, and either `html` or `text`
+     *
+     * **Idempotency:** Supports `Idempotency-Key` header for safe retries.
+     *
+     * **Related endpoints:**
+     *
+     * - `GET /emails/{id}` - Track delivery status
+     * - `GET /emails/{id}/deliveries` - View delivery attempts
+     * - `POST /emails/{id}/retry` - Retry failed delivery
+     *
+     * @example
+     * ```ts
+     * const response = await client.emails.send({
+     *   from: 'Acme <hello@acme.com>',
+     *   subject: 'Hello World',
+     *   to: ['user@example.com'],
+     *   html: '<h1>Welcome!</h1><p>Thanks for signing up.</p>',
+     * });
+     * ```
+     */
+    send(params, options) {
+        const { 'Idempotency-Key': idempotencyKey, ...body } = params;
+        return this._client.post('/emails', {
+            body,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { ...(idempotencyKey != null ? { 'Idempotency-Key': idempotencyKey } : undefined) },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Send up to 100 emails in a single request. Useful for sending personalized
+     * emails to multiple recipients efficiently.
+     *
+     * Each email in the batch can have different content and recipients. Failed emails
+     * don't affect other emails in the batch.
+     *
+     * **Idempotency:** Supports `Idempotency-Key` header for safe retries.
+     *
+     * @example
+     * ```ts
+     * const response = await client.emails.sendBatch({
+     *   emails: [
+     *     {
+     *       to: ['alice@example.com'],
+     *       subject: 'Hello Alice',
+     *       html: '<p>Hi Alice, your order is ready!</p>',
+     *       tag: 'order-ready',
+     *     },
+     *     {
+     *       to: ['bob@example.com'],
+     *       subject: 'Hello Bob',
+     *       html: '<p>Hi Bob, your order is ready!</p>',
+     *       tag: 'order-ready',
+     *     },
+     *   ],
+     *   from: 'notifications@myapp.com',
+     * });
+     * ```
+     */
+    sendBatch(params, options) {
+        const { 'Idempotency-Key': idempotencyKey, ...body } = params;
+        return this._client.post('/emails/batch', {
+            body,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { ...(idempotencyKey != null ? { 'Idempotency-Key': idempotencyKey } : undefined) },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Send a pre-formatted RFC 2822 MIME message. Use this for advanced use cases or
+     * when migrating from systems that generate raw email content.
+     *
+     * The `data` field should contain the base64-encoded raw email.
+     *
+     * @example
+     * ```ts
+     * const response = await client.emails.sendRaw({
+     *   data: 'data',
+     *   mailFrom: 'dev@stainless.com',
+     *   rcptTo: ['dev@stainless.com'],
+     * });
+     * ```
+     */
+    sendRaw(body, options) {
+        return this._client.post('/emails/raw', { body, ...options });
+    }
+}
+exports.Emails = Emails;
+//# sourceMappingURL=emails.js.map

package/resources/emails.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emails.js","sourceRoot":"","sources":["../src/resources/emails.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAG/C,sDAAwG;AACxG,oDAAmD;AAEnD,oDAA8C;AAE9C,MAAa,MAAO,SAAQ,sBAAW;IACrC;;;;;;;;;;;OAWG;IACH,QAAQ,CACN,OAAe,EACf,QAAgD,EAAE,EAClD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,WAAW,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,IAAI,CACF,QAA4C,EAAE,EAC9C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,EAAE,CAAA,iCAAuC,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC5G,CAAC;IAED;;;;;;;;;;OAUG;IACH,kBAAkB,CAAC,OAAe,EAAE,OAAwB;QAC1D,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,WAAW,OAAO,aAAa,EAAE,OAAO,CAAC,CAAC;IACxE,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,OAAe,EAAE,OAAwB;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,WAAW,OAAO,QAAQ,EAAE,OAAO,CAAC,CAAC;IACpE,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,IAAI,CAAC,MAAuB,EAAE,OAAwB;QACpD,MAAM,EAAE,iBAAiB,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAC9D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE;YAClC,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC;gBACpB,EAAE,GAAG,CAAC,cAAc,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;gBACnF,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,SAAS,CAAC,MAA4B,EAAE,OAAwB;QAC9D,MAAM,EAAE,iBAAiB,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAC9D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE;YACxC,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC;gBACpB,EAAE,GAAG,CAAC,cAAc,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;gBACnF,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,IAAwB,EAAE,OAAwB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAChE,CAAC;CACF;AA/KD,wBA+KC"}

package/resources/emails.mjs

@@ -0,0 +1,169 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../core/resource.mjs";
+import { PageNumberPagination } from "../core/pagination.mjs";
+import { buildHeaders } from "../internal/headers.mjs";
+import { path } from "../internal/utils/path.mjs";
+export class Emails extends APIResource {
+    /**
+     * Retrieve detailed information about a specific email including delivery status,
+     * timestamps, and optionally the email content.
+     *
+     * Use the `expand` parameter to include additional data like the HTML/text body,
+     * headers, or delivery attempts.
+     *
+     * @example
+     * ```ts
+     * const email = await client.emails.retrieve('emailId');
+     * ```
+     */
+    retrieve(emailID, query = {}, options) {
+        return this._client.get(path `/emails/${emailID}`, { query, ...options });
+    }
+    /**
+     * Retrieve a paginated list of sent emails. Results are ordered by send time,
+     * newest first.
+     *
+     * Use filters to narrow down results by status, recipient, sender, or tag.
+     *
+     * **Related endpoints:**
+     *
+     * - `GET /emails/{id}` - Get full details of a specific email
+     * - `POST /emails` - Send a new email
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const emailListResponse of client.emails.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(query = {}, options) {
+        return this._client.getAPIList('/emails', (PageNumberPagination), { query, ...options });
+    }
+    /**
+     * Get the history of delivery attempts for an email, including SMTP response codes
+     * and timestamps.
+     *
+     * @example
+     * ```ts
+     * const response = await client.emails.retrieveDeliveries(
+     *   'emailId',
+     * );
+     * ```
+     */
+    retrieveDeliveries(emailID, options) {
+        return this._client.get(path `/emails/${emailID}/deliveries`, options);
+    }
+    /**
+     * Retry delivery of a failed or soft-bounced email. Creates a new delivery
+     * attempt.
+     *
+     * Only works for emails that have failed or are in a retryable state.
+     *
+     * @example
+     * ```ts
+     * const response = await client.emails.retry('emailId');
+     * ```
+     */
+    retry(emailID, options) {
+        return this._client.post(path `/emails/${emailID}/retry`, options);
+    }
+    /**
+     * Send a single email message. The email is accepted for immediate delivery and
+     * typically delivered within seconds.
+     *
+     * **Example use case:** Send a password reset email to a user.
+     *
+     * **Required fields:** `from`, `to`, `subject`, and either `html` or `text`
+     *
+     * **Idempotency:** Supports `Idempotency-Key` header for safe retries.
+     *
+     * **Related endpoints:**
+     *
+     * - `GET /emails/{id}` - Track delivery status
+     * - `GET /emails/{id}/deliveries` - View delivery attempts
+     * - `POST /emails/{id}/retry` - Retry failed delivery
+     *
+     * @example
+     * ```ts
+     * const response = await client.emails.send({
+     *   from: 'Acme <hello@acme.com>',
+     *   subject: 'Hello World',
+     *   to: ['user@example.com'],
+     *   html: '<h1>Welcome!</h1><p>Thanks for signing up.</p>',
+     * });
+     * ```
+     */
+    send(params, options) {
+        const { 'Idempotency-Key': idempotencyKey, ...body } = params;
+        return this._client.post('/emails', {
+            body,
+            ...options,
+            headers: buildHeaders([
+                { ...(idempotencyKey != null ? { 'Idempotency-Key': idempotencyKey } : undefined) },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Send up to 100 emails in a single request. Useful for sending personalized
+     * emails to multiple recipients efficiently.
+     *
+     * Each email in the batch can have different content and recipients. Failed emails
+     * don't affect other emails in the batch.
+     *
+     * **Idempotency:** Supports `Idempotency-Key` header for safe retries.
+     *
+     * @example
+     * ```ts
+     * const response = await client.emails.sendBatch({
+     *   emails: [
+     *     {
+     *       to: ['alice@example.com'],
+     *       subject: 'Hello Alice',
+     *       html: '<p>Hi Alice, your order is ready!</p>',
+     *       tag: 'order-ready',
+     *     },
+     *     {
+     *       to: ['bob@example.com'],
+     *       subject: 'Hello Bob',
+     *       html: '<p>Hi Bob, your order is ready!</p>',
+     *       tag: 'order-ready',
+     *     },
+     *   ],
+     *   from: 'notifications@myapp.com',
+     * });
+     * ```
+     */
+    sendBatch(params, options) {
+        const { 'Idempotency-Key': idempotencyKey, ...body } = params;
+        return this._client.post('/emails/batch', {
+            body,
+            ...options,
+            headers: buildHeaders([
+                { ...(idempotencyKey != null ? { 'Idempotency-Key': idempotencyKey } : undefined) },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Send a pre-formatted RFC 2822 MIME message. Use this for advanced use cases or
+     * when migrating from systems that generate raw email content.
+     *
+     * The `data` field should contain the base64-encoded raw email.
+     *
+     * @example
+     * ```ts
+     * const response = await client.emails.sendRaw({
+     *   data: 'data',
+     *   mailFrom: 'dev@stainless.com',
+     *   rcptTo: ['dev@stainless.com'],
+     * });
+     * ```
+     */
+    sendRaw(body, options) {
+        return this._client.post('/emails/raw', { body, ...options });
+    }
+}
+//# sourceMappingURL=emails.mjs.map

package/resources/emails.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"emails.mjs","sourceRoot":"","sources":["../src/resources/emails.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAGf,EAAE,oBAAoB,EAAgD;OACtE,EAAE,YAAY,EAAE;OAEhB,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,MAAO,SAAQ,WAAW;IACrC;;;;;;;;;;;OAWG;IACH,QAAQ,CACN,OAAe,EACf,QAAgD,EAAE,EAClD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,WAAW,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,IAAI,CACF,QAA4C,EAAE,EAC9C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,EAAE,CAAA,oBAAuC,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC5G,CAAC;IAED;;;;;;;;;;OAUG;IACH,kBAAkB,CAAC,OAAe,EAAE,OAAwB;QAC1D,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,WAAW,OAAO,aAAa,EAAE,OAAO,CAAC,CAAC;IACxE,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,OAAe,EAAE,OAAwB;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,WAAW,OAAO,QAAQ,EAAE,OAAO,CAAC,CAAC;IACpE,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,IAAI,CAAC,MAAuB,EAAE,OAAwB;QACpD,MAAM,EAAE,iBAAiB,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAC9D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE;YAClC,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC;gBACpB,EAAE,GAAG,CAAC,cAAc,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;gBACnF,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,SAAS,CAAC,MAA4B,EAAE,OAAwB;QAC9D,MAAM,EAAE,iBAAiB,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAC9D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE;YACxC,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC;gBACpB,EAAE,GAAG,CAAC,cAAc,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;gBACnF,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,IAAwB,EAAE,OAAwB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAChE,CAAC;CACF"}

package/resources/index.d.mts

@@ -0,0 +1,7 @@
+export * from "./shared.mjs";
+export { Domains, type DNSRecord, type DomainCreateResponse, type DomainRetrieveResponse, type DomainListResponse, type DomainDeleteResponse, type DomainVerifyResponse, type DomainCreateParams, } from "./domains.mjs";
+export { Emails, type EmailRetrieveResponse, type EmailListResponse, type EmailRetrieveDeliveriesResponse, type EmailRetryResponse, type EmailSendResponse, type EmailSendBatchResponse, type EmailSendRawResponse, type EmailRetrieveParams, type EmailListParams, type EmailSendParams, type EmailSendBatchParams, type EmailSendRawParams, type EmailListResponsesPageNumberPagination, } from "./emails.mjs";
+export { Suppressions, type SuppressionCreateResponse, type SuppressionRetrieveResponse, type SuppressionListResponse, type SuppressionDeleteResponse, type SuppressionBulkCreateResponse, type SuppressionCreateParams, type SuppressionListParams, type SuppressionBulkCreateParams, type SuppressionListResponsesPageNumberPagination, } from "./suppressions.mjs";
+export { Tracking, type TrackDomain, type TrackingCreateResponse, type TrackingRetrieveResponse, type TrackingUpdateResponse, type TrackingListResponse, type TrackingDeleteResponse, type TrackingVerifyResponse, type TrackingCreateParams, type TrackingUpdateParams, } from "./tracking.mjs";
+export { Webhooks, type WebhookCreateResponse, type WebhookRetrieveResponse, type WebhookUpdateResponse, type WebhookListResponse, type WebhookDeleteResponse, type WebhookTestResponse, type WebhookCreateParams, type WebhookUpdateParams, type WebhookTestParams, } from "./webhooks.mjs";
+//# sourceMappingURL=index.d.mts.map

package/resources/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":";OAGO,EACL,OAAO,EACP,KAAK,SAAS,EACd,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,GACxB;OACM,EACL,MAAM,EACN,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,+BAA+B,EACpC,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,sCAAsC,GAC5C;OACM,EACL,YAAY,EACZ,KAAK,yBAAyB,EAC9B,KAAK,2BAA2B,EAChC,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,EAC9B,KAAK,6BAA6B,EAClC,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,2BAA2B,EAChC,KAAK,4CAA4C,GAClD;OACM,EACL,QAAQ,EACR,KAAK,WAAW,EAChB,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,GAC1B;OACM,EACL,QAAQ,EACR,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,GACvB"}

package/resources/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./shared.js";
+export { Domains, type DNSRecord, type DomainCreateResponse, type DomainRetrieveResponse, type DomainListResponse, type DomainDeleteResponse, type DomainVerifyResponse, type DomainCreateParams, } from "./domains.js";
+export { Emails, type EmailRetrieveResponse, type EmailListResponse, type EmailRetrieveDeliveriesResponse, type EmailRetryResponse, type EmailSendResponse, type EmailSendBatchResponse, type EmailSendRawResponse, type EmailRetrieveParams, type EmailListParams, type EmailSendParams, type EmailSendBatchParams, type EmailSendRawParams, type EmailListResponsesPageNumberPagination, } from "./emails.js";
+export { Suppressions, type SuppressionCreateResponse, type SuppressionRetrieveResponse, type SuppressionListResponse, type SuppressionDeleteResponse, type SuppressionBulkCreateResponse, type SuppressionCreateParams, type SuppressionListParams, type SuppressionBulkCreateParams, type SuppressionListResponsesPageNumberPagination, } from "./suppressions.js";
+export { Tracking, type TrackDomain, type TrackingCreateResponse, type TrackingRetrieveResponse, type TrackingUpdateResponse, type TrackingListResponse, type TrackingDeleteResponse, type TrackingVerifyResponse, type TrackingCreateParams, type TrackingUpdateParams, } from "./tracking.js";
+export { Webhooks, type WebhookCreateResponse, type WebhookRetrieveResponse, type WebhookUpdateResponse, type WebhookListResponse, type WebhookDeleteResponse, type WebhookTestResponse, type WebhookCreateParams, type WebhookUpdateParams, type WebhookTestParams, } from "./webhooks.js";
+//# sourceMappingURL=index.d.ts.map

package/resources/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":";OAGO,EACL,OAAO,EACP,KAAK,SAAS,EACd,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,GACxB;OACM,EACL,MAAM,EACN,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,+BAA+B,EACpC,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,sCAAsC,GAC5C;OACM,EACL,YAAY,EACZ,KAAK,yBAAyB,EAC9B,KAAK,2BAA2B,EAChC,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,EAC9B,KAAK,6BAA6B,EAClC,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,2BAA2B,EAChC,KAAK,4CAA4C,GAClD;OACM,EACL,QAAQ,EACR,KAAK,WAAW,EAChB,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,GAC1B;OACM,EACL,QAAQ,EACR,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,GACvB"}

package/resources/index.js

@@ -0,0 +1,17 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Webhooks = exports.Tracking = exports.Suppressions = exports.Emails = exports.Domains = void 0;
+const tslib_1 = require("../internal/tslib.js");
+tslib_1.__exportStar(require("./shared.js"), exports);
+var domains_1 = require("./domains.js");
+Object.defineProperty(exports, "Domains", { enumerable: true, get: function () { return domains_1.Domains; } });
+var emails_1 = require("./emails.js");
+Object.defineProperty(exports, "Emails", { enumerable: true, get: function () { return emails_1.Emails; } });
+var suppressions_1 = require("./suppressions.js");
+Object.defineProperty(exports, "Suppressions", { enumerable: true, get: function () { return suppressions_1.Suppressions; } });
+var tracking_1 = require("./tracking.js");
+Object.defineProperty(exports, "Tracking", { enumerable: true, get: function () { return tracking_1.Tracking; } });
+var webhooks_1 = require("./webhooks.js");
+Object.defineProperty(exports, "Webhooks", { enumerable: true, get: function () { return webhooks_1.Webhooks; } });
+//# sourceMappingURL=index.js.map

package/resources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,sDAAyB;AACzB,wCASmB;AARjB,kGAAA,OAAO,OAAA;AAST,sCAekB;AAdhB,gGAAA,MAAM,OAAA;AAeR,kDAWwB;AAVtB,4GAAA,YAAY,OAAA;AAWd,0CAWoB;AAVlB,oGAAA,QAAQ,OAAA;AAWV,0CAWoB;AAVlB,oGAAA,QAAQ,OAAA"}

package/resources/index.mjs

@@ -0,0 +1,8 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+export * from "./shared.mjs";
+export { Domains, } from "./domains.mjs";
+export { Emails, } from "./emails.mjs";
+export { Suppressions, } from "./suppressions.mjs";
+export { Tracking, } from "./tracking.mjs";
+export { Webhooks, } from "./webhooks.mjs";
+//# sourceMappingURL=index.mjs.map

package/resources/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;;OAG/E,EACL,OAAO,GAQR;OACM,EACL,MAAM,GAcP;OACM,EACL,YAAY,GAUb;OACM,EACL,QAAQ,GAUT;OACM,EACL,QAAQ,GAUT"}

package/resources/shared.d.mts

@@ -0,0 +1,7 @@
+export interface APIMeta {
+    /**
+     * Unique request identifier for debugging and support
+     */
+    requestId: string;
+}
+//# sourceMappingURL=shared.d.mts.map

package/resources/shared.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.mts","sourceRoot":"","sources":["../src/resources/shared.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,OAAO;IACtB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/resources/shared.d.ts

@@ -0,0 +1,7 @@
+export interface APIMeta {
+    /**
+     * Unique request identifier for debugging and support
+     */
+    requestId: string;
+}
+//# sourceMappingURL=shared.d.ts.map

package/resources/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../src/resources/shared.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,OAAO;IACtB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/resources/shared.js

@@ -0,0 +1,4 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=shared.js.map

package/resources/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../src/resources/shared.ts"],"names":[],"mappings":";AAAA,sFAAsF"}

package/resources/shared.mjs

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+export {};
+//# sourceMappingURL=shared.mjs.map

package/resources/shared.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.mjs","sourceRoot":"","sources":["../src/resources/shared.ts"],"names":[],"mappings":"AAAA,sFAAsF"}

package/resources/suppressions.d.mts

@@ -0,0 +1,181 @@
+import { APIResource } from "../core/resource.mjs";
+import * as Shared from "./shared.mjs";
+import { APIPromise } from "../core/api-promise.mjs";
+import { PageNumberPagination, type PageNumberPaginationParams, PagePromise } from "../core/pagination.mjs";
+import { RequestOptions } from "../internal/request-options.mjs";
+export declare class Suppressions extends APIResource {
+    /**
+     * Add an email address to the suppression list. The address will not receive any
+     * emails until removed.
+     *
+     * @example
+     * ```ts
+     * const suppression = await client.suppressions.create({
+     *   address: 'user@example.com',
+     *   reason: 'user requested removal',
+     * });
+     * ```
+     */
+    create(body: SuppressionCreateParams, options?: RequestOptions): APIPromise<SuppressionCreateResponse>;
+    /**
+     * Check if a specific email address is on the suppression list
+     *
+     * @example
+     * ```ts
+     * const suppression = await client.suppressions.retrieve(
+     *   'dev@stainless.com',
+     * );
+     * ```
+     */
+    retrieve(email: string, options?: RequestOptions): APIPromise<SuppressionRetrieveResponse>;
+    /**
+     * Get all email addresses on the suppression list. These addresses will not
+     * receive any emails.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const suppressionListResponse of client.suppressions.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(query?: SuppressionListParams | null | undefined, options?: RequestOptions): PagePromise<SuppressionListResponsesPageNumberPagination, SuppressionListResponse>;
+    /**
+     * Remove an email address from the suppression list. The address will be able to
+     * receive emails again.
+     *
+     * @example
+     * ```ts
+     * const suppression = await client.suppressions.delete(
+     *   'dev@stainless.com',
+     * );
+     * ```
+     */
+    delete(email: string, options?: RequestOptions): APIPromise<SuppressionDeleteResponse>;
+    /**
+     * Add up to 1000 email addresses to the suppression list at once
+     *
+     * @example
+     * ```ts
+     * const response = await client.suppressions.bulkCreate({
+     *   suppressions: [{ address: 'dev@stainless.com' }],
+     * });
+     * ```
+     */
+    bulkCreate(body: SuppressionBulkCreateParams, options?: RequestOptions): APIPromise<SuppressionBulkCreateResponse>;
+}
+export type SuppressionListResponsesPageNumberPagination = PageNumberPagination<SuppressionListResponse>;
+export interface SuppressionCreateResponse {
+    data: SuppressionCreateResponse.Data;
+    meta: Shared.APIMeta;
+    success: true;
+}
+export declare namespace SuppressionCreateResponse {
+    interface Data {
+        /**
+         * Suppression ID
+         */
+        id: string;
+        address: string;
+        createdAt: string;
+        /**
+         * Reason for suppression
+         */
+        reason?: string;
+    }
+}
+export interface SuppressionRetrieveResponse {
+    data: SuppressionRetrieveResponse.Data;
+    meta: Shared.APIMeta;
+    success: true;
+}
+export declare namespace SuppressionRetrieveResponse {
+    interface Data {
+        /**
+         * The email address that was checked
+         */
+        address: string;
+        /**
+         * Whether the address is currently suppressed
+         */
+        suppressed: boolean;
+        /**
+         * When the suppression was created (if suppressed)
+         */
+        createdAt?: string | null;
+        /**
+         * Reason for suppression (if suppressed)
+         */
+        reason?: string | null;
+    }
+}
+export interface SuppressionListResponse {
+    /**
+     * Suppression ID
+     */
+    id: string;
+    address: string;
+    createdAt: string;
+    reason?: string;
+}
+export interface SuppressionDeleteResponse {
+    data: SuppressionDeleteResponse.Data;
+    meta: Shared.APIMeta;
+    success: true;
+}
+export declare namespace SuppressionDeleteResponse {
+    interface Data {
+        message: string;
+    }
+}
+export interface SuppressionBulkCreateResponse {
+    data: SuppressionBulkCreateResponse.Data;
+    meta: Shared.APIMeta;
+    success: true;
+}
+export declare namespace SuppressionBulkCreateResponse {
+    interface Data {
+        /**
+         * Newly suppressed addresses
+         */
+        added: number;
+        /**
+         * Invalid addresses skipped
+         */
+        failed: number;
+        /**
+         * Total addresses in request
+         */
+        totalRequested: number;
+        /**
+         * Already suppressed addresses (updated reason)
+         */
+        updated: number;
+    }
+}
+export interface SuppressionCreateParams {
+    /**
+     * Email address to suppress
+     */
+    address: string;
+    /**
+     * Reason for suppression
+     */
+    reason?: string;
+}
+export interface SuppressionListParams extends PageNumberPaginationParams {
+}
+export interface SuppressionBulkCreateParams {
+    suppressions: Array<SuppressionBulkCreateParams.Suppression>;
+}
+export declare namespace SuppressionBulkCreateParams {
+    interface Suppression {
+        address: string;
+        reason?: string;
+    }
+}
+export declare namespace Suppressions {
+    export { type SuppressionCreateResponse as SuppressionCreateResponse, type SuppressionRetrieveResponse as SuppressionRetrieveResponse, type SuppressionListResponse as SuppressionListResponse, type SuppressionDeleteResponse as SuppressionDeleteResponse, type SuppressionBulkCreateResponse as SuppressionBulkCreateResponse, type SuppressionListResponsesPageNumberPagination as SuppressionListResponsesPageNumberPagination, type SuppressionCreateParams as SuppressionCreateParams, type SuppressionListParams as SuppressionListParams, type SuppressionBulkCreateParams as SuppressionBulkCreateParams, };
+}
+//# sourceMappingURL=suppressions.d.mts.map

package/resources/suppressions.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suppressions.d.mts","sourceRoot":"","sources":["../src/resources/suppressions.ts"],"names":[],"mappings":"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"}