@usehercules/sdk 1.14.1 → 1.14.3

package/resources/email/email.d.ts

@@ -0,0 +1,166 @@
+import { APIResource } from "../../core/resource.js";
+import * as IdentitiesAPI from "./identities.js";
+import { Identities, IdentitiesCursorIDPage, Identity, IdentityCreateParams, IdentityListParams } from "./identities.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { CursorIDPage, type CursorIDPageParams, PagePromise } from "../../core/pagination.js";
+import { RequestOptions } from "../../internal/request-options.js";
+/**
+ * Send transactional emails, send batch emails, and retrieve sent email
+ * history with delivery status tracking.
+ */
+export declare class EmailResource extends APIResource {
+    identities: IdentitiesAPI.Identities;
+    /**
+     * Retrieves a paginated list of sent emails. Returns email metadata including
+     * delivery status.
+     */
+    list(query?: EmailListParams | null | undefined, options?: RequestOptions): PagePromise<EmailsCursorIDPage, Email>;
+    /**
+     * Retrieves a single email by its unique identifier.
+     */
+    get(emailID: string, options?: RequestOptions): APIPromise<Email>;
+    /**
+     * Sends a single email. The sender address must be a verified identity for this
+     * website.
+     */
+    send(body: EmailSendParams, options?: RequestOptions): APIPromise<EmailSendResponse>;
+}
+export type EmailsCursorIDPage = CursorIDPage<Email>;
+/**
+ * A file attachment
+ */
+export interface Attachment {
+    /**
+     * The Base64-encoded content of the attachment. Max 40MB total per email.
+     */
+    content: string;
+    /**
+     * The name of the attached file
+     */
+    filename: string;
+    /**
+     * The MIME type of the attachment
+     */
+    content_type?: string;
+}
+/**
+ * A sent email object
+ */
+export interface Email {
+    /**
+     * Unique identifier for the email
+     */
+    id: string;
+    /**
+     * Timestamp when the email was sent
+     */
+    created_at: string;
+    /**
+     * Sender email address
+     */
+    from: string;
+    /**
+     * Email subject line
+     */
+    subject: string;
+    /**
+     * Recipient email addresses
+     */
+    to: Array<string>;
+    /**
+     * Blind carbon copy recipients
+     */
+    bcc?: Array<string> | null;
+    /**
+     * Carbon copy recipients
+     */
+    cc?: Array<string> | null;
+    /**
+     * The most recent event for this email
+     */
+    last_event?: 'sent' | 'delivered' | 'opened' | 'clicked' | 'bounced' | 'complained' | null;
+    /**
+     * Reply-to addresses
+     */
+    reply_to?: Array<string> | null;
+}
+/**
+ * Response after sending an email
+ */
+export interface EmailSendResponse {
+    /**
+     * The unique identifier of the sent email
+     */
+    id: string;
+}
+export interface EmailListParams extends CursorIDPageParams {
+}
+export interface EmailSendParams {
+    /**
+     * Sender email address. To include a friendly name, use the format 'Your Name
+     * <sender@domain.com>'.
+     */
+    from: string;
+    /**
+     * Email subject line
+     */
+    subject: string;
+    /**
+     * Recipient email address(es). Maximum 50.
+     */
+    to: string | Array<string>;
+    /**
+     * List of file attachments. Total size must not exceed 40MB after Base64 encoding.
+     */
+    attachments?: Array<Attachment>;
+    /**
+     * Blind carbon copy recipient(s)
+     */
+    bcc?: string | Array<string>;
+    /**
+     * Carbon copy recipient(s)
+     */
+    cc?: string | Array<string>;
+    /**
+     * Custom email headers as key-value pairs
+     */
+    headers?: {
+        [key: string]: string;
+    };
+    /**
+     * The HTML version of the message body
+     */
+    html?: string;
+    /**
+     * Reply-to email address(es)
+     */
+    reply_to?: string | Array<string>;
+    /**
+     * Custom metadata tags for the email (max 50)
+     */
+    tags?: Array<EmailSendParams.Tag>;
+    /**
+     * The plain text version of the message body
+     */
+    text?: string;
+}
+export declare namespace EmailSendParams {
+    /**
+     * A custom metadata tag for the email
+     */
+    interface Tag {
+        /**
+         * The name of the tag
+         */
+        name: string;
+        /**
+         * The value of the tag
+         */
+        value: string;
+    }
+}
+export declare namespace EmailResource {
+    export { type Attachment as Attachment, type Email as Email, type EmailSendResponse as EmailSendResponse, type EmailsCursorIDPage as EmailsCursorIDPage, type EmailListParams as EmailListParams, type EmailSendParams as EmailSendParams, };
+    export { Identities as Identities, type Identity as Identity, type IdentitiesCursorIDPage as IdentitiesCursorIDPage, type IdentityCreateParams as IdentityCreateParams, type IdentityListParams as IdentityListParams, };
+}
+//# sourceMappingURL=email.d.ts.map

package/resources/email/email.d.ts.map

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

package/resources/email/email.js

@@ -0,0 +1,43 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmailResource = void 0;
+const tslib_1 = require("../../internal/tslib.js");
+const resource_1 = require("../../core/resource.js");
+const IdentitiesAPI = tslib_1.__importStar(require("./identities.js"));
+const identities_1 = require("./identities.js");
+const pagination_1 = require("../../core/pagination.js");
+const path_1 = require("../../internal/utils/path.js");
+/**
+ * Send transactional emails, send batch emails, and retrieve sent email
+ * history with delivery status tracking.
+ */
+class EmailResource extends resource_1.APIResource {
+    constructor() {
+        super(...arguments);
+        this.identities = new IdentitiesAPI.Identities(this._client);
+    }
+    /**
+     * Retrieves a paginated list of sent emails. Returns email metadata including
+     * delivery status.
+     */
+    list(query = {}, options) {
+        return this._client.getAPIList('/v1/email', (pagination_1.CursorIDPage), { query, ...options });
+    }
+    /**
+     * Retrieves a single email by its unique identifier.
+     */
+    get(emailID, options) {
+        return this._client.get((0, path_1.path) `/v1/email/${emailID}`, options);
+    }
+    /**
+     * Sends a single email. The sender address must be a verified identity for this
+     * website.
+     */
+    send(body, options) {
+        return this._client.post('/v1/email', { body, ...options });
+    }
+}
+exports.EmailResource = EmailResource;
+EmailResource.Identities = identities_1.Identities;
+//# sourceMappingURL=email.js.map

package/resources/email/email.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.js","sourceRoot":"","sources":["../../src/resources/email/email.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,qDAAkD;AAClD,uEAA8C;AAC9C,gDAMsB;AAEtB,yDAA2F;AAE3F,uDAAiD;AAEjD;;;GAGG;AACH,MAAa,aAAc,SAAQ,sBAAW;IAA9C;;QACE,eAAU,GAA6B,IAAI,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IA2BpF,CAAC;IAzBC;;;OAGG;IACH,IAAI,CACF,QAA4C,EAAE,EAC9C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,WAAW,EAAE,CAAA,yBAAmB,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC1F,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,OAAe,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,aAAa,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;IAC/D,CAAC;IAED;;;OAGG;IACH,IAAI,CAAC,IAAqB,EAAE,OAAwB;QAClD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC9D,CAAC;CACF;AA5BD,sCA4BC;AAiKD,aAAa,CAAC,UAAU,GAAG,uBAAU,CAAC"}

package/resources/email/email.mjs

@@ -0,0 +1,38 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../core/resource.mjs";
+import * as IdentitiesAPI from "./identities.mjs";
+import { Identities, } from "./identities.mjs";
+import { CursorIDPage } from "../../core/pagination.mjs";
+import { path } from "../../internal/utils/path.mjs";
+/**
+ * Send transactional emails, send batch emails, and retrieve sent email
+ * history with delivery status tracking.
+ */
+export class EmailResource extends APIResource {
+    constructor() {
+        super(...arguments);
+        this.identities = new IdentitiesAPI.Identities(this._client);
+    }
+    /**
+     * Retrieves a paginated list of sent emails. Returns email metadata including
+     * delivery status.
+     */
+    list(query = {}, options) {
+        return this._client.getAPIList('/v1/email', (CursorIDPage), { query, ...options });
+    }
+    /**
+     * Retrieves a single email by its unique identifier.
+     */
+    get(emailID, options) {
+        return this._client.get(path `/v1/email/${emailID}`, options);
+    }
+    /**
+     * Sends a single email. The sender address must be a verified identity for this
+     * website.
+     */
+    send(body, options) {
+        return this._client.post('/v1/email', { body, ...options });
+    }
+}
+EmailResource.Identities = Identities;
+//# sourceMappingURL=email.mjs.map

package/resources/email/email.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.mjs","sourceRoot":"","sources":["../../src/resources/email/email.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OACf,KAAK,aAAa;OAClB,EACL,UAAU,GAKX;OAEM,EAAE,YAAY,EAAwC;OAEtD,EAAE,IAAI,EAAE;AAEf;;;GAGG;AACH,MAAM,OAAO,aAAc,SAAQ,WAAW;IAA9C;;QACE,eAAU,GAA6B,IAAI,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IA2BpF,CAAC;IAzBC;;;OAGG;IACH,IAAI,CACF,QAA4C,EAAE,EAC9C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,WAAW,EAAE,CAAA,YAAmB,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC1F,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,OAAe,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,aAAa,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;IAC/D,CAAC;IAED;;;OAGG;IACH,IAAI,CAAC,IAAqB,EAAE,OAAwB;QAClD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC9D,CAAC;CACF;AAiKD,aAAa,CAAC,UAAU,GAAG,UAAU,CAAC"}

package/resources/email/identities.d.mts

@@ -0,0 +1,107 @@
+import { APIResource } from "../../core/resource.mjs";
+import { APIPromise } from "../../core/api-promise.mjs";
+import { CursorIDPage, type CursorIDPageParams, PagePromise } from "../../core/pagination.mjs";
+import { RequestOptions } from "../../internal/request-options.mjs";
+export declare class Identities extends APIResource {
+    /**
+     * Creates a new sender identity for email verification. For email identities, a
+     * verification email is sent. For domain identities, DNS records are returned that
+     * must be configured to verify ownership.
+     */
+    create(body: IdentityCreateParams, options?: RequestOptions): APIPromise<Identity>;
+    /**
+     * Retrieves a paginated list of sender identities (email addresses and domains)
+     * configured for this website.
+     */
+    list(query?: IdentityListParams | null | undefined, options?: RequestOptions): PagePromise<IdentitiesCursorIDPage, Identity>;
+    /**
+     * Permanently deletes a sender identity. Emails can no longer be sent from this
+     * address or domain after deletion.
+     */
+    delete(identityID: string, options?: RequestOptions): APIPromise<void>;
+    /**
+     * Retrieves a sender identity by ID. Returns the identity with its current
+     * verification status and any required DNS records.
+     */
+    get(identityID: string, options?: RequestOptions): APIPromise<Identity>;
+    /**
+     * Triggers a manual recheck of the identity's verification status against AWS SES.
+     * Returns the identity with its updated status.
+     */
+    verify(identityID: string, options?: RequestOptions): APIPromise<Identity>;
+}
+export type IdentitiesCursorIDPage = CursorIDPage<Identity>;
+/**
+ * A verified sender identity (email address or domain) for sending emails
+ */
+export interface Identity {
+    /**
+     * Unique identifier for the identity
+     */
+    id: string;
+    /**
+     * Timestamp when the identity was created
+     */
+    created_at: string;
+    /**
+     * The verification status of the identity
+     */
+    status: 'pending' | 'verified' | 'failed';
+    /**
+     * The type of identity: 'email' for a single email address, 'domain' for an entire
+     * domain
+     */
+    type: 'email' | 'domain';
+    /**
+     * The email address or domain name
+     */
+    value: string;
+    /**
+     * DNS records required for verification (only present for domain identities)
+     */
+    verification_records?: Array<Identity.VerificationRecord> | null;
+}
+export declare namespace Identity {
+    /**
+     * A DNS record required for domain verification
+     */
+    interface VerificationRecord {
+        /**
+         * The DNS record name/host
+         */
+        name: string;
+        /**
+         * Verification status of this individual record
+         */
+        status: 'pending' | 'verified' | 'failed';
+        /**
+         * The DNS record type
+         */
+        type: 'TXT' | 'CNAME' | 'MX';
+        /**
+         * The DNS record value
+         */
+        value: string;
+        /**
+         * The DNS record priority (for MX records)
+         */
+        priority?: number;
+    }
+}
+export interface IdentityCreateParams {
+    /**
+     * The type of identity to create. Use 'email' for a single address or 'domain' for
+     * an entire domain.
+     */
+    type: 'email' | 'domain';
+    /**
+     * The email address or domain name to verify
+     */
+    value: string;
+}
+export interface IdentityListParams extends CursorIDPageParams {
+}
+export declare namespace Identities {
+    export { type Identity as Identity, type IdentitiesCursorIDPage as IdentitiesCursorIDPage, type IdentityCreateParams as IdentityCreateParams, type IdentityListParams as IdentityListParams, };
+}
+//# sourceMappingURL=identities.d.mts.map

package/resources/email/identities.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identities.d.mts","sourceRoot":"","sources":["../../src/resources/email/identities.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,WAAW,EAAE;OAEtD,EAAE,cAAc,EAAE;AAGzB,qBAAa,UAAW,SAAQ,WAAW;IACzC;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,QAAQ,CAAC;IAIlF;;;OAGG;IACH,IAAI,CACF,KAAK,GAAE,kBAAkB,GAAG,IAAI,GAAG,SAAc,EACjD,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,sBAAsB,EAAE,QAAQ,CAAC;IAIhD;;;OAGG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;IAOtE;;;OAGG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,QAAQ,CAAC;IAIvE;;;OAGG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,QAAQ,CAAC;CAG3E;AAED,MAAM,MAAM,sBAAsB,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;IAE1C;;;OAGG;IACH,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAC;IAEzB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,oBAAoB,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC,kBAAkB,CAAC,GAAG,IAAI,CAAC;CAClE;AAED,yBAAiB,QAAQ,CAAC;IACxB;;OAEG;IACH,UAAiB,kBAAkB;QACjC;;WAEG;QACH,IAAI,EAAE,MAAM,CAAC;QAEb;;WAEG;QACH,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;QAE1C;;WAEG;QACH,IAAI,EAAE,KAAK,GAAG,OAAO,GAAG,IAAI,CAAC;QAE7B;;WAEG;QACH,KAAK,EAAE,MAAM,CAAC;QAEd;;WAEG;QACH,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB;CACF;AAED,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAC;IAEzB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAmB,SAAQ,kBAAkB;CAAG;AAEjE,MAAM,CAAC,OAAO,WAAW,UAAU,CAAC;IAClC,OAAO,EACL,KAAK,QAAQ,IAAI,QAAQ,EACzB,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,kBAAkB,IAAI,kBAAkB,GAC9C,CAAC;CACH"}

package/resources/email/identities.d.ts

@@ -0,0 +1,107 @@
+import { APIResource } from "../../core/resource.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { CursorIDPage, type CursorIDPageParams, PagePromise } from "../../core/pagination.js";
+import { RequestOptions } from "../../internal/request-options.js";
+export declare class Identities extends APIResource {
+    /**
+     * Creates a new sender identity for email verification. For email identities, a
+     * verification email is sent. For domain identities, DNS records are returned that
+     * must be configured to verify ownership.
+     */
+    create(body: IdentityCreateParams, options?: RequestOptions): APIPromise<Identity>;
+    /**
+     * Retrieves a paginated list of sender identities (email addresses and domains)
+     * configured for this website.
+     */
+    list(query?: IdentityListParams | null | undefined, options?: RequestOptions): PagePromise<IdentitiesCursorIDPage, Identity>;
+    /**
+     * Permanently deletes a sender identity. Emails can no longer be sent from this
+     * address or domain after deletion.
+     */
+    delete(identityID: string, options?: RequestOptions): APIPromise<void>;
+    /**
+     * Retrieves a sender identity by ID. Returns the identity with its current
+     * verification status and any required DNS records.
+     */
+    get(identityID: string, options?: RequestOptions): APIPromise<Identity>;
+    /**
+     * Triggers a manual recheck of the identity's verification status against AWS SES.
+     * Returns the identity with its updated status.
+     */
+    verify(identityID: string, options?: RequestOptions): APIPromise<Identity>;
+}
+export type IdentitiesCursorIDPage = CursorIDPage<Identity>;
+/**
+ * A verified sender identity (email address or domain) for sending emails
+ */
+export interface Identity {
+    /**
+     * Unique identifier for the identity
+     */
+    id: string;
+    /**
+     * Timestamp when the identity was created
+     */
+    created_at: string;
+    /**
+     * The verification status of the identity
+     */
+    status: 'pending' | 'verified' | 'failed';
+    /**
+     * The type of identity: 'email' for a single email address, 'domain' for an entire
+     * domain
+     */
+    type: 'email' | 'domain';
+    /**
+     * The email address or domain name
+     */
+    value: string;
+    /**
+     * DNS records required for verification (only present for domain identities)
+     */
+    verification_records?: Array<Identity.VerificationRecord> | null;
+}
+export declare namespace Identity {
+    /**
+     * A DNS record required for domain verification
+     */
+    interface VerificationRecord {
+        /**
+         * The DNS record name/host
+         */
+        name: string;
+        /**
+         * Verification status of this individual record
+         */
+        status: 'pending' | 'verified' | 'failed';
+        /**
+         * The DNS record type
+         */
+        type: 'TXT' | 'CNAME' | 'MX';
+        /**
+         * The DNS record value
+         */
+        value: string;
+        /**
+         * The DNS record priority (for MX records)
+         */
+        priority?: number;
+    }
+}
+export interface IdentityCreateParams {
+    /**
+     * The type of identity to create. Use 'email' for a single address or 'domain' for
+     * an entire domain.
+     */
+    type: 'email' | 'domain';
+    /**
+     * The email address or domain name to verify
+     */
+    value: string;
+}
+export interface IdentityListParams extends CursorIDPageParams {
+}
+export declare namespace Identities {
+    export { type Identity as Identity, type IdentitiesCursorIDPage as IdentitiesCursorIDPage, type IdentityCreateParams as IdentityCreateParams, type IdentityListParams as IdentityListParams, };
+}
+//# sourceMappingURL=identities.d.ts.map

package/resources/email/identities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identities.d.ts","sourceRoot":"","sources":["../../src/resources/email/identities.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,WAAW,EAAE;OAEtD,EAAE,cAAc,EAAE;AAGzB,qBAAa,UAAW,SAAQ,WAAW;IACzC;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,QAAQ,CAAC;IAIlF;;;OAGG;IACH,IAAI,CACF,KAAK,GAAE,kBAAkB,GAAG,IAAI,GAAG,SAAc,EACjD,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,sBAAsB,EAAE,QAAQ,CAAC;IAIhD;;;OAGG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;IAOtE;;;OAGG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,QAAQ,CAAC;IAIvE;;;OAGG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,QAAQ,CAAC;CAG3E;AAED,MAAM,MAAM,sBAAsB,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;IAE1C;;;OAGG;IACH,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAC;IAEzB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,oBAAoB,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC,kBAAkB,CAAC,GAAG,IAAI,CAAC;CAClE;AAED,yBAAiB,QAAQ,CAAC;IACxB;;OAEG;IACH,UAAiB,kBAAkB;QACjC;;WAEG;QACH,IAAI,EAAE,MAAM,CAAC;QAEb;;WAEG;QACH,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;QAE1C;;WAEG;QACH,IAAI,EAAE,KAAK,GAAG,OAAO,GAAG,IAAI,CAAC;QAE7B;;WAEG;QACH,KAAK,EAAE,MAAM,CAAC;QAEd;;WAEG;QACH,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB;CACF;AAED,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAC;IAEzB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAmB,SAAQ,kBAAkB;CAAG;AAEjE,MAAM,CAAC,OAAO,WAAW,UAAU,CAAC;IAClC,OAAO,EACL,KAAK,QAAQ,IAAI,QAAQ,EACzB,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,kBAAkB,IAAI,kBAAkB,GAC9C,CAAC;CACH"}

package/resources/email/identities.js

@@ -0,0 +1,51 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Identities = 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 Identities extends resource_1.APIResource {
+    /**
+     * Creates a new sender identity for email verification. For email identities, a
+     * verification email is sent. For domain identities, DNS records are returned that
+     * must be configured to verify ownership.
+     */
+    create(body, options) {
+        return this._client.post('/v1/email/identities', { body, ...options });
+    }
+    /**
+     * Retrieves a paginated list of sender identities (email addresses and domains)
+     * configured for this website.
+     */
+    list(query = {}, options) {
+        return this._client.getAPIList('/v1/email/identities', (pagination_1.CursorIDPage), { query, ...options });
+    }
+    /**
+     * Permanently deletes a sender identity. Emails can no longer be sent from this
+     * address or domain after deletion.
+     */
+    delete(identityID, options) {
+        return this._client.delete((0, path_1.path) `/v1/email/identities/${identityID}`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+    /**
+     * Retrieves a sender identity by ID. Returns the identity with its current
+     * verification status and any required DNS records.
+     */
+    get(identityID, options) {
+        return this._client.get((0, path_1.path) `/v1/email/identities/${identityID}`, options);
+    }
+    /**
+     * Triggers a manual recheck of the identity's verification status against AWS SES.
+     * Returns the identity with its updated status.
+     */
+    verify(identityID, options) {
+        return this._client.post((0, path_1.path) `/v1/email/identities/${identityID}/verify`, options);
+    }
+}
+exports.Identities = Identities;
+//# sourceMappingURL=identities.js.map

package/resources/email/identities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identities.js","sourceRoot":"","sources":["../../src/resources/email/identities.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAElD,yDAA2F;AAC3F,uDAAsD;AAEtD,uDAAiD;AAEjD,MAAa,UAAW,SAAQ,sBAAW;IACzC;;;;OAIG;IACH,MAAM,CAAC,IAA0B,EAAE,OAAwB;QACzD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;IAED;;;OAGG;IACH,IAAI,CACF,QAA+C,EAAE,EACjD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,sBAAsB,EAAE,CAAA,yBAAsB,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACxG,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,UAAkB,EAAE,OAAwB;QACjD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,wBAAwB,UAAU,EAAE,EAAE;YACnE,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,GAAG,CAAC,UAAkB,EAAE,OAAwB;QAC9C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,wBAAwB,UAAU,EAAE,EAAE,OAAO,CAAC,CAAC;IAC7E,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,UAAkB,EAAE,OAAwB;QACjD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,wBAAwB,UAAU,SAAS,EAAE,OAAO,CAAC,CAAC;IACrF,CAAC;CACF;AA/CD,gCA+CC"}

package/resources/email/identities.mjs

@@ -0,0 +1,47 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../core/resource.mjs";
+import { CursorIDPage } from "../../core/pagination.mjs";
+import { buildHeaders } from "../../internal/headers.mjs";
+import { path } from "../../internal/utils/path.mjs";
+export class Identities extends APIResource {
+    /**
+     * Creates a new sender identity for email verification. For email identities, a
+     * verification email is sent. For domain identities, DNS records are returned that
+     * must be configured to verify ownership.
+     */
+    create(body, options) {
+        return this._client.post('/v1/email/identities', { body, ...options });
+    }
+    /**
+     * Retrieves a paginated list of sender identities (email addresses and domains)
+     * configured for this website.
+     */
+    list(query = {}, options) {
+        return this._client.getAPIList('/v1/email/identities', (CursorIDPage), { query, ...options });
+    }
+    /**
+     * Permanently deletes a sender identity. Emails can no longer be sent from this
+     * address or domain after deletion.
+     */
+    delete(identityID, options) {
+        return this._client.delete(path `/v1/email/identities/${identityID}`, {
+            ...options,
+            headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+    /**
+     * Retrieves a sender identity by ID. Returns the identity with its current
+     * verification status and any required DNS records.
+     */
+    get(identityID, options) {
+        return this._client.get(path `/v1/email/identities/${identityID}`, options);
+    }
+    /**
+     * Triggers a manual recheck of the identity's verification status against AWS SES.
+     * Returns the identity with its updated status.
+     */
+    verify(identityID, options) {
+        return this._client.post(path `/v1/email/identities/${identityID}/verify`, options);
+    }
+}
+//# sourceMappingURL=identities.mjs.map

package/resources/email/identities.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"identities.mjs","sourceRoot":"","sources":["../../src/resources/email/identities.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAEf,EAAE,YAAY,EAAwC;OACtD,EAAE,YAAY,EAAE;OAEhB,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,UAAW,SAAQ,WAAW;IACzC;;;;OAIG;IACH,MAAM,CAAC,IAA0B,EAAE,OAAwB;QACzD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;IAED;;;OAGG;IACH,IAAI,CACF,QAA+C,EAAE,EACjD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,sBAAsB,EAAE,CAAA,YAAsB,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACxG,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,UAAkB,EAAE,OAAwB;QACjD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,wBAAwB,UAAU,EAAE,EAAE;YACnE,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,GAAG,CAAC,UAAkB,EAAE,OAAwB;QAC9C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,wBAAwB,UAAU,EAAE,EAAE,OAAO,CAAC,CAAC;IAC7E,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,UAAkB,EAAE,OAAwB;QACjD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,wBAAwB,UAAU,SAAS,EAAE,OAAO,CAAC,CAAC;IACrF,CAAC;CACF"}

package/resources/email/index.d.mts

@@ -0,0 +1,3 @@
+export { EmailResource, type Attachment, type Email, type EmailSendResponse, type EmailListParams, type EmailSendParams, type EmailsCursorIDPage, } from "./email.mjs";
+export { Identities, type Identity, type IdentityCreateParams, type IdentityListParams, type IdentitiesCursorIDPage, } from "./identities.mjs";
+//# sourceMappingURL=index.d.mts.map

package/resources/email/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/resources/email/index.ts"],"names":[],"mappings":"OAEO,EACL,aAAa,EACb,KAAK,UAAU,EACf,KAAK,KAAK,EACV,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,kBAAkB,GACxB;OACM,EACL,UAAU,EACV,KAAK,QAAQ,EACb,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,GAC5B"}

package/resources/email/index.d.ts

@@ -0,0 +1,3 @@
+export { EmailResource, type Attachment, type Email, type EmailSendResponse, type EmailListParams, type EmailSendParams, type EmailsCursorIDPage, } from "./email.js";
+export { Identities, type Identity, type IdentityCreateParams, type IdentityListParams, type IdentitiesCursorIDPage, } from "./identities.js";
+//# sourceMappingURL=index.d.ts.map

package/resources/email/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/email/index.ts"],"names":[],"mappings":"OAEO,EACL,aAAa,EACb,KAAK,UAAU,EACf,KAAK,KAAK,EACV,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,kBAAkB,GACxB;OACM,EACL,UAAU,EACV,KAAK,QAAQ,EACb,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,GAC5B"}

package/resources/email/index.js

@@ -0,0 +1,9 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Identities = exports.EmailResource = void 0;
+var email_1 = require("./email.js");
+Object.defineProperty(exports, "EmailResource", { enumerable: true, get: function () { return email_1.EmailResource; } });
+var identities_1 = require("./identities.js");
+Object.defineProperty(exports, "Identities", { enumerable: true, get: function () { return identities_1.Identities; } });
+//# sourceMappingURL=index.js.map

package/resources/email/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/email/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,oCAQiB;AAPf,sGAAA,aAAa,OAAA;AAQf,8CAMsB;AALpB,wGAAA,UAAU,OAAA"}

package/resources/email/index.mjs

@@ -0,0 +1,4 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+export { EmailResource, } from "./email.mjs";
+export { Identities, } from "./identities.mjs";
+//# sourceMappingURL=index.mjs.map

package/resources/email/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/resources/email/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EACL,aAAa,GAOd;OACM,EACL,UAAU,GAKX"}

package/resources/email.d.mts

@@ -0,0 +1,2 @@
+export * from "./email/index.mjs";
+//# sourceMappingURL=email.d.mts.map

package/resources/email.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.d.mts","sourceRoot":"","sources":["../src/resources/email.ts"],"names":[],"mappings":""}

package/resources/email.d.ts

@@ -0,0 +1,2 @@
+export * from "./email/index.js";
+//# sourceMappingURL=email.d.ts.map

package/resources/email.d.ts.map

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