@primitivedotdev/sdk 0.6.0 → 0.8.0

package/dist/index.d.ts

@@ -1,3 +1,12 @@
-import { AuthConfidence$1 as AuthConfidence, AuthVerdict$1 as AuthVerdict, DkimResult$1 as DkimResult, DkimSignature, DmarcPolicy$1 as DmarcPolicy, DmarcResult$1 as DmarcResult, EmailAddress, EmailAnalysis, EmailAuth, EmailReceivedEvent, EventType$1 as EventType, ForwardAnalysis, ForwardOriginalSender, ForwardResult, ForwardResultAttachmentAnalyzed, ForwardResultAttachmentSkipped, ForwardResultInline, ForwardVerdict$1 as ForwardVerdict, ForwardVerification, KnownWebhookEvent, ParsedData, ParsedDataComplete, ParsedDataFailed, ParsedError, ParsedStatus$1 as ParsedStatus, RawContent, RawContentDownloadOnly, RawContentInline, SpfResult$1 as SpfResult, UnknownEvent, ValidateEmailAuthResult, WebhookAttachment, WebhookEvent } from "./types-CKFmgitP.js";
-import { DecodeRawEmailOptions, GenerateDownloadTokenOptions, HandleWebhookOptions, LEGACY_CONFIRMED_HEADER$1 as LEGACY_CONFIRMED_HEADER, LEGACY_SIGNATURE_HEADER$1 as LEGACY_SIGNATURE_HEADER, PAYLOAD_ERRORS$1 as PAYLOAD_ERRORS, PRIMITIVE_CONFIRMED_HEADER$1 as PRIMITIVE_CONFIRMED_HEADER, PRIMITIVE_SIGNATURE_HEADER$1 as PRIMITIVE_SIGNATURE_HEADER, PrimitiveWebhookError$1 as PrimitiveWebhookError, RAW_EMAIL_ERRORS$1 as RAW_EMAIL_ERRORS, RawEmailDecodeError$1 as RawEmailDecodeError, RawEmailDecodeErrorCode, STANDARD_WEBHOOK_ID_HEADER$1 as STANDARD_WEBHOOK_ID_HEADER, STANDARD_WEBHOOK_SIGNATURE_HEADER$1 as STANDARD_WEBHOOK_SIGNATURE_HEADER, STANDARD_WEBHOOK_TIMESTAMP_HEADER$1 as STANDARD_WEBHOOK_TIMESTAMP_HEADER, SignResult, StandardWebhooksSignResult, StandardWebhooksVerifyOptions, VERIFICATION_ERRORS$1 as VERIFICATION_ERRORS, VerifyDownloadTokenOptions, VerifyDownloadTokenResult, VerifyOptions, WEBHOOK_VERSION$1 as WEBHOOK_VERSION, WebhookErrorCode, WebhookHeaders, WebhookPayloadError$1 as WebhookPayloadError, WebhookPayloadErrorCode, WebhookValidationError$1 as WebhookValidationError, WebhookValidationErrorCode, WebhookVerificationError$1 as WebhookVerificationError, WebhookVerificationErrorCode, confirmedHeaders$1 as confirmedHeaders, decodeRawEmail$1 as decodeRawEmail, emailReceivedEventJsonSchema$1 as emailReceivedEventJsonSchema, generateDownloadToken$1 as generateDownloadToken, getDownloadTimeRemaining$1 as getDownloadTimeRemaining, handleWebhook$1 as handleWebhook, isDownloadExpired$1 as isDownloadExpired, isEmailReceivedEvent$1 as isEmailReceivedEvent, isRawIncluded$1 as isRawIncluded, parseWebhookEvent$1 as parseWebhookEvent, safeValidateEmailReceivedEvent$1 as safeValidateEmailReceivedEvent, signStandardWebhooksPayload$1 as signStandardWebhooksPayload, signWebhookPayload$1 as signWebhookPayload, validateEmailAuth$1 as validateEmailAuth, validateEmailReceivedEvent$1 as validateEmailReceivedEvent, verifyDownloadToken$1 as verifyDownloadToken, verifyRawEmailDownload$1 as verifyRawEmailDownload, verifyStandardWebhooksSignature$1 as verifyStandardWebhooksSignature, verifyWebhookSignature$1 as verifyWebhookSignature } from "./index-DLmAI4UQ.js";
-export { AuthConfidence, AuthVerdict, DecodeRawEmailOptions, DkimResult, DkimSignature, DmarcPolicy, DmarcResult, EmailAddress, EmailAnalysis, EmailAuth, EmailReceivedEvent, EventType, ForwardAnalysis, ForwardOriginalSender, ForwardResult, ForwardResultAttachmentAnalyzed, ForwardResultAttachmentSkipped, ForwardResultInline, ForwardVerdict, ForwardVerification, GenerateDownloadTokenOptions, HandleWebhookOptions, KnownWebhookEvent, LEGACY_CONFIRMED_HEADER, LEGACY_SIGNATURE_HEADER, PAYLOAD_ERRORS, PRIMITIVE_CONFIRMED_HEADER, PRIMITIVE_SIGNATURE_HEADER, ParsedData, ParsedDataComplete, ParsedDataFailed, ParsedError, ParsedStatus, PrimitiveWebhookError, RAW_EMAIL_ERRORS, RawContent, RawContentDownloadOnly, RawContentInline, RawEmailDecodeError, RawEmailDecodeErrorCode, STANDARD_WEBHOOK_ID_HEADER, STANDARD_WEBHOOK_SIGNATURE_HEADER, STANDARD_WEBHOOK_TIMESTAMP_HEADER, SignResult, SpfResult, StandardWebhooksSignResult, StandardWebhooksVerifyOptions, UnknownEvent, VERIFICATION_ERRORS, ValidateEmailAuthResult, VerifyDownloadTokenOptions, VerifyDownloadTokenResult, VerifyOptions, WEBHOOK_VERSION, WebhookAttachment, WebhookErrorCode, WebhookEvent, WebhookHeaders, WebhookPayloadError, WebhookPayloadErrorCode, WebhookValidationError, WebhookValidationErrorCode, WebhookVerificationError, WebhookVerificationErrorCode, confirmedHeaders, decodeRawEmail, emailReceivedEventJsonSchema, generateDownloadToken, getDownloadTimeRemaining, handleWebhook, isDownloadExpired, isEmailReceivedEvent, isRawIncluded, parseWebhookEvent, safeValidateEmailReceivedEvent, signStandardWebhooksPayload, signWebhookPayload, validateEmailAuth, validateEmailReceivedEvent, verifyDownloadToken, verifyRawEmailDownload, verifyStandardWebhooksSignature, verifyWebhookSignature };
+import { AuthConfidence$1 as AuthConfidence, AuthVerdict$1 as AuthVerdict, DkimResult$1 as DkimResult, DkimSignature, DmarcPolicy$1 as DmarcPolicy, DmarcResult$1 as DmarcResult, EmailAddress, EmailAnalysis, EmailAuth, EmailReceivedEvent, EventType$1 as EventType, ForwardAnalysis, ForwardOriginalSender, ForwardResult, ForwardResultAttachmentAnalyzed, ForwardResultAttachmentSkipped, ForwardResultInline, ForwardVerdict$1 as ForwardVerdict, ForwardVerification, KnownWebhookEvent, ParsedData, ParsedDataComplete, ParsedDataFailed, ParsedError, ParsedStatus$1 as ParsedStatus, RawContent, RawContentDownloadOnly, RawContentInline, SpfResult$1 as SpfResult, UnknownEvent, ValidateEmailAuthResult, WebhookAttachment, WebhookEvent } from "./types-CIOzt1FY.js";
+import { ReceivedEmail, ReceivedEmailAddress, ReceivedEmailThread, buildForwardSubject$1 as buildForwardSubject, buildReplySubject$1 as buildReplySubject, formatAddress$1 as formatAddress, normalizeReceivedEmail$1 as normalizeReceivedEmail, parseHeaderAddress$1 as parseHeaderAddress } from "./received-email-C67Z7Dha.js";
+import { ForwardInput, PrimitiveApiError$1 as PrimitiveApiError, PrimitiveClient$1 as PrimitiveClient, PrimitiveClientOptions, ReplyInput, SendInput, SendResult, SendThreadInput, client$1 as client, createPrimitiveClient$1 as createPrimitiveClient } from "./index-D9lanVFt.js";
+import { DecodeRawEmailOptions, GenerateDownloadTokenOptions, HandleWebhookOptions, LEGACY_CONFIRMED_HEADER$1 as LEGACY_CONFIRMED_HEADER, LEGACY_SIGNATURE_HEADER$1 as LEGACY_SIGNATURE_HEADER, PAYLOAD_ERRORS$1 as PAYLOAD_ERRORS, PRIMITIVE_CONFIRMED_HEADER$1 as PRIMITIVE_CONFIRMED_HEADER, PRIMITIVE_SIGNATURE_HEADER$1 as PRIMITIVE_SIGNATURE_HEADER, PrimitiveWebhookError$1 as PrimitiveWebhookError, RAW_EMAIL_ERRORS$1 as RAW_EMAIL_ERRORS, RawEmailDecodeError$1 as RawEmailDecodeError, RawEmailDecodeErrorCode, ReceiveRequestOptions, STANDARD_WEBHOOK_ID_HEADER$1 as STANDARD_WEBHOOK_ID_HEADER, STANDARD_WEBHOOK_SIGNATURE_HEADER$1 as STANDARD_WEBHOOK_SIGNATURE_HEADER, STANDARD_WEBHOOK_TIMESTAMP_HEADER$1 as STANDARD_WEBHOOK_TIMESTAMP_HEADER, SignResult, StandardWebhooksSignResult, StandardWebhooksVerifyOptions, VERIFICATION_ERRORS$1 as VERIFICATION_ERRORS, VerifyDownloadTokenOptions, VerifyDownloadTokenResult, VerifyOptions, WEBHOOK_VERSION$1 as WEBHOOK_VERSION, WebhookErrorCode, WebhookHeaders, WebhookPayloadError$1 as WebhookPayloadError, WebhookPayloadErrorCode, WebhookValidationError$1 as WebhookValidationError, WebhookValidationErrorCode, WebhookVerificationError$1 as WebhookVerificationError, WebhookVerificationErrorCode, confirmedHeaders$1 as confirmedHeaders, decodeRawEmail$1 as decodeRawEmail, emailReceivedEventJsonSchema$1 as emailReceivedEventJsonSchema, generateDownloadToken$1 as generateDownloadToken, getDownloadTimeRemaining$1 as getDownloadTimeRemaining, handleWebhook$1 as handleWebhook, isDownloadExpired$1 as isDownloadExpired, isEmailReceivedEvent$1 as isEmailReceivedEvent, isRawIncluded$1 as isRawIncluded, parseWebhookEvent$1 as parseWebhookEvent, receive$1 as receive, safeValidateEmailReceivedEvent$1 as safeValidateEmailReceivedEvent, signStandardWebhooksPayload$1 as signStandardWebhooksPayload, signWebhookPayload$1 as signWebhookPayload, validateEmailAuth$1 as validateEmailAuth, validateEmailReceivedEvent$1 as validateEmailReceivedEvent, verifyDownloadToken$1 as verifyDownloadToken, verifyRawEmailDownload$1 as verifyRawEmailDownload, verifyStandardWebhooksSignature$1 as verifyStandardWebhooksSignature, verifyWebhookSignature$1 as verifyWebhookSignature } from "./index-CuuP1JkG.js";
+
+//#region src/index.d.ts
+
+declare const primitive: {
+  client: typeof client;
+  receive: typeof receive;
+}; //#endregion
+export { AuthConfidence, AuthVerdict, DecodeRawEmailOptions, DkimResult, DkimSignature, DmarcPolicy, DmarcResult, EmailAddress, EmailAnalysis, EmailAuth, EmailReceivedEvent, EventType, ForwardAnalysis, ForwardInput, ForwardOriginalSender, ForwardResult, ForwardResultAttachmentAnalyzed, ForwardResultAttachmentSkipped, ForwardResultInline, ForwardVerdict, ForwardVerification, GenerateDownloadTokenOptions, HandleWebhookOptions, KnownWebhookEvent, LEGACY_CONFIRMED_HEADER, LEGACY_SIGNATURE_HEADER, PAYLOAD_ERRORS, PRIMITIVE_CONFIRMED_HEADER, PRIMITIVE_SIGNATURE_HEADER, ParsedData, ParsedDataComplete, ParsedDataFailed, ParsedError, ParsedStatus, PrimitiveApiError, PrimitiveClient, PrimitiveClientOptions, PrimitiveWebhookError, RAW_EMAIL_ERRORS, RawContent, RawContentDownloadOnly, RawContentInline, RawEmailDecodeError, RawEmailDecodeErrorCode, ReceiveRequestOptions, ReceivedEmail, ReceivedEmailAddress, ReceivedEmailThread, ReplyInput, STANDARD_WEBHOOK_ID_HEADER, STANDARD_WEBHOOK_SIGNATURE_HEADER, STANDARD_WEBHOOK_TIMESTAMP_HEADER, SendInput, SendResult, SendThreadInput, SignResult, SpfResult, StandardWebhooksSignResult, StandardWebhooksVerifyOptions, UnknownEvent, VERIFICATION_ERRORS, ValidateEmailAuthResult, VerifyDownloadTokenOptions, VerifyDownloadTokenResult, VerifyOptions, WEBHOOK_VERSION, WebhookAttachment, WebhookErrorCode, WebhookEvent, WebhookHeaders, WebhookPayloadError, WebhookPayloadErrorCode, WebhookValidationError, WebhookValidationErrorCode, WebhookVerificationError, WebhookVerificationErrorCode, buildForwardSubject, buildReplySubject, client, confirmedHeaders, createPrimitiveClient, decodeRawEmail, primitive as default, emailReceivedEventJsonSchema, formatAddress, generateDownloadToken, getDownloadTimeRemaining, handleWebhook, isDownloadExpired, isEmailReceivedEvent, isRawIncluded, normalizeReceivedEmail, parseHeaderAddress, parseWebhookEvent, receive, safeValidateEmailReceivedEvent, signStandardWebhooksPayload, signWebhookPayload, validateEmailAuth, validateEmailReceivedEvent, verifyDownloadToken, verifyRawEmailDownload, verifyStandardWebhooksSignature, verifyWebhookSignature };

package/dist/index.js

@@ -1,3 +1,14 @@
-import { AuthConfidence, AuthVerdict, DkimResult, DmarcPolicy, DmarcResult, EventType, ForwardVerdict, LEGACY_CONFIRMED_HEADER, LEGACY_SIGNATURE_HEADER, PAYLOAD_ERRORS, PRIMITIVE_CONFIRMED_HEADER, PRIMITIVE_SIGNATURE_HEADER, ParsedStatus, PrimitiveWebhookError, RAW_EMAIL_ERRORS, RawEmailDecodeError, STANDARD_WEBHOOK_ID_HEADER, STANDARD_WEBHOOK_SIGNATURE_HEADER, STANDARD_WEBHOOK_TIMESTAMP_HEADER, SpfResult, VERIFICATION_ERRORS, WEBHOOK_VERSION, WebhookPayloadError, WebhookValidationError, WebhookVerificationError, confirmedHeaders, decodeRawEmail, emailReceivedEventJsonSchema, generateDownloadToken, getDownloadTimeRemaining, handleWebhook, isDownloadExpired, isEmailReceivedEvent, isRawIncluded, parseWebhookEvent, safeValidateEmailReceivedEvent, signStandardWebhooksPayload, signWebhookPayload, validateEmailAuth, validateEmailReceivedEvent, verifyDownloadToken, verifyRawEmailDownload, verifyStandardWebhooksSignature, verifyWebhookSignature } from "./webhook-COe5N_Uj.js";
+import "./address-parser-CfPHs3mE.js";
+import { buildForwardSubject, buildReplySubject, formatAddress, normalizeReceivedEmail, parseHeaderAddress } from "./received-email-Q6Cha3wc.js";
+import { PrimitiveApiError, PrimitiveClient, client, createPrimitiveClient } from "./api-BH8PnmHs.js";
+import { AuthConfidence, AuthVerdict, DkimResult, DmarcPolicy, DmarcResult, EventType, ForwardVerdict, LEGACY_CONFIRMED_HEADER, LEGACY_SIGNATURE_HEADER, PAYLOAD_ERRORS, PRIMITIVE_CONFIRMED_HEADER, PRIMITIVE_SIGNATURE_HEADER, ParsedStatus, PrimitiveWebhookError, RAW_EMAIL_ERRORS, RawEmailDecodeError, STANDARD_WEBHOOK_ID_HEADER, STANDARD_WEBHOOK_SIGNATURE_HEADER, STANDARD_WEBHOOK_TIMESTAMP_HEADER, SpfResult, VERIFICATION_ERRORS, WEBHOOK_VERSION, WebhookPayloadError, WebhookValidationError, WebhookVerificationError, confirmedHeaders, decodeRawEmail, emailReceivedEventJsonSchema, generateDownloadToken, getDownloadTimeRemaining, handleWebhook, isDownloadExpired, isEmailReceivedEvent, isRawIncluded, parseWebhookEvent, receive, safeValidateEmailReceivedEvent, signStandardWebhooksPayload, signWebhookPayload, validateEmailAuth, validateEmailReceivedEvent, verifyDownloadToken, verifyRawEmailDownload, verifyStandardWebhooksSignature, verifyWebhookSignature } from "./webhook-2TALcBQz.js";
 
-export { AuthConfidence, AuthVerdict, DkimResult, DmarcPolicy, DmarcResult, EventType, ForwardVerdict, LEGACY_CONFIRMED_HEADER, LEGACY_SIGNATURE_HEADER, PAYLOAD_ERRORS, PRIMITIVE_CONFIRMED_HEADER, PRIMITIVE_SIGNATURE_HEADER, ParsedStatus, PrimitiveWebhookError, RAW_EMAIL_ERRORS, RawEmailDecodeError, STANDARD_WEBHOOK_ID_HEADER, STANDARD_WEBHOOK_SIGNATURE_HEADER, STANDARD_WEBHOOK_TIMESTAMP_HEADER, SpfResult, VERIFICATION_ERRORS, WEBHOOK_VERSION, WebhookPayloadError, WebhookValidationError, WebhookVerificationError, confirmedHeaders, decodeRawEmail, emailReceivedEventJsonSchema, generateDownloadToken, getDownloadTimeRemaining, handleWebhook, isDownloadExpired, isEmailReceivedEvent, isRawIncluded, parseWebhookEvent, safeValidateEmailReceivedEvent, signStandardWebhooksPayload, signWebhookPayload, validateEmailAuth, validateEmailReceivedEvent, verifyDownloadToken, verifyRawEmailDownload, verifyStandardWebhooksSignature, verifyWebhookSignature };
+//#region src/index.ts
+const primitive = {
+	client,
+	receive
+};
+var src_default = primitive;
+
+//#endregion
+export { AuthConfidence, AuthVerdict, DkimResult, DmarcPolicy, DmarcResult, EventType, ForwardVerdict, LEGACY_CONFIRMED_HEADER, LEGACY_SIGNATURE_HEADER, PAYLOAD_ERRORS, PRIMITIVE_CONFIRMED_HEADER, PRIMITIVE_SIGNATURE_HEADER, ParsedStatus, PrimitiveApiError, PrimitiveClient, PrimitiveWebhookError, RAW_EMAIL_ERRORS, RawEmailDecodeError, STANDARD_WEBHOOK_ID_HEADER, STANDARD_WEBHOOK_SIGNATURE_HEADER, STANDARD_WEBHOOK_TIMESTAMP_HEADER, SpfResult, VERIFICATION_ERRORS, WEBHOOK_VERSION, WebhookPayloadError, WebhookValidationError, WebhookVerificationError, buildForwardSubject, buildReplySubject, client, confirmedHeaders, createPrimitiveClient, decodeRawEmail, src_default as default, emailReceivedEventJsonSchema, formatAddress, generateDownloadToken, getDownloadTimeRemaining, handleWebhook, isDownloadExpired, isEmailReceivedEvent, isRawIncluded, normalizeReceivedEmail, parseHeaderAddress, parseWebhookEvent, receive, safeValidateEmailReceivedEvent, signStandardWebhooksPayload, signWebhookPayload, validateEmailAuth, validateEmailReceivedEvent, verifyDownloadToken, verifyRawEmailDownload, verifyStandardWebhooksSignature, verifyWebhookSignature };

package/dist/openapi/openapi.generated.js

@@ -43,6 +43,10 @@ export const openapiDocument = {
             "name": "Emails",
             "description": "List, inspect, and manage received emails"
         },
+        {
+            "name": "Sending",
+            "description": "Send outbound emails through the Primitive API"
+        },
         {
             "name": "Endpoints",
             "description": "Manage webhook endpoints that receive email events"
@@ -1427,6 +1431,85 @@ export const openapiDocument = {
                     }
                 }
             }
+        },
+        "/send-mail": {
+            "post": {
+                "operationId": "sendEmail",
+                "summary": "Send outbound email",
+                "description": "Sends an outbound email through Primitive's outbound relay. By default\nthe request returns once the relay accepts the message for delivery.\nSet `wait: true` to wait for the first downstream SMTP delivery outcome.\n",
+                "tags": [
+                    "Sending"
+                ],
+                "parameters": [
+                    {
+                        "name": "Idempotency-Key",
+                        "in": "header",
+                        "required": false,
+                        "schema": {
+                            "type": "string",
+                            "minLength": 1,
+                            "maxLength": 255,
+                            "pattern": "^[\\x21-\\x7E]+$"
+                        },
+                        "description": "Optional customer-supplied idempotency key. If omitted, Primitive\nderives one from the canonical request payload and echoes the\neffective value in the `Idempotency-Key` response header.\n"
+                    }
+                ],
+                "requestBody": {
+                    "required": true,
+                    "content": {
+                        "application/json": {
+                            "schema": {
+                                "$ref": "#/components/schemas/SendMailInput"
+                            }
+                        }
+                    }
+                },
+                "responses": {
+                    "200": {
+                        "description": "Outbound relay result",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "allOf": [
+                                        {
+                                            "$ref": "#/components/schemas/SuccessEnvelope"
+                                        },
+                                        {
+                                            "type": "object",
+                                            "properties": {
+                                                "data": {
+                                                    "$ref": "#/components/schemas/SendMailResult"
+                                                }
+                                            }
+                                        }
+                                    ]
+                                }
+                            }
+                        }
+                    },
+                    "400": {
+                        "$ref": "#/components/responses/ValidationError"
+                    },
+                    "401": {
+                        "$ref": "#/components/responses/Unauthorized"
+                    },
+                    "403": {
+                        "$ref": "#/components/responses/Forbidden"
+                    },
+                    "429": {
+                        "$ref": "#/components/responses/RateLimited"
+                    },
+                    "500": {
+                        "$ref": "#/components/responses/InternalError"
+                    },
+                    "502": {
+                        "$ref": "#/components/responses/BadGateway"
+                    },
+                    "503": {
+                        "$ref": "#/components/responses/ServiceUnavailable"
+                    }
+                }
+            }
         }
     },
     "components": {
@@ -1492,6 +1575,23 @@ export const openapiDocument = {
                     }
                 }
             },
+            "Forbidden": {
+                "description": "Authenticated caller lacks permission for the operation",
+                "content": {
+                    "application/json": {
+                        "schema": {
+                            "$ref": "#/components/schemas/ErrorResponse"
+                        },
+                        "example": {
+                            "success": false,
+                            "error": {
+                                "code": "forbidden",
+                                "message": "Insufficient permissions"
+                            }
+                        }
+                    }
+                }
+            },
             "NotFound": {
                 "description": "Resource not found",
                 "content": {
@@ -1551,6 +1651,57 @@ export const openapiDocument = {
                     }
                 }
             },
+            "BadGateway": {
+                "description": "Primitive could not complete the downstream SMTP request",
+                "content": {
+                    "application/json": {
+                        "schema": {
+                            "$ref": "#/components/schemas/ErrorResponse"
+                        },
+                        "example": {
+                            "success": false,
+                            "error": {
+                                "code": "bad_gateway",
+                                "message": "Outbound SMTP service request failed"
+                            }
+                        }
+                    }
+                }
+            },
+            "ServiceUnavailable": {
+                "description": "Primitive is temporarily unable to process the request",
+                "content": {
+                    "application/json": {
+                        "schema": {
+                            "$ref": "#/components/schemas/ErrorResponse"
+                        },
+                        "example": {
+                            "success": false,
+                            "error": {
+                                "code": "outbound_capacity_exhausted",
+                                "message": "Outbound capacity is temporarily exhausted"
+                            }
+                        }
+                    }
+                }
+            },
+            "InternalError": {
+                "description": "Primitive encountered an internal error",
+                "content": {
+                    "application/json": {
+                        "schema": {
+                            "$ref": "#/components/schemas/ErrorResponse"
+                        },
+                        "example": {
+                            "success": false,
+                            "error": {
+                                "code": "internal_error",
+                                "message": "Internal server error"
+                            }
+                        }
+                    }
+                }
+            },
             "Deleted": {
                 "description": "Resource deleted",
                 "content": {
@@ -1659,7 +1810,17 @@ export const openapiDocument = {
                                     "rate_limit_exceeded",
                                     "internal_error",
                                     "conflict",
-                                    "mx_conflict"
+                                    "mx_conflict",
+                                    "bad_gateway",
+                                    "outbound_disabled",
+                                    "cannot_send_from_domain",
+                                    "recipient_not_allowed",
+                                    "outbound_key_missing",
+                                    "outbound_unreachable",
+                                    "outbound_key_invalid",
+                                    "outbound_capacity_exhausted",
+                                    "outbound_response_malformed",
+                                    "outbound_relay_failed"
                                 ]
                             },
                             "message": {
@@ -1687,8 +1848,38 @@ export const openapiDocument = {
                                                 "description": "Subdomain to try instead (e.g. \"mail\" for `mail.example.com`)."
                                             }
                                         }
+                                    },
+                                    "required_entitlements": {
+                                        "type": "array",
+                                        "items": {
+                                            "type": "string"
+                                        },
+                                        "description": "Entitlements that would allow a denied send when no recipient-scope gate was granted."
+                                    },
+                                    "sent_email_id": {
+                                        "type": "string",
+                                        "description": "ID of the persisted sent-email attempt associated with the error."
+                                    },
+                                    "content_hash": {
+                                        "type": "string",
+                                        "description": "Content hash of the original request on idempotency cache-hit errors."
+                                    },
+                                    "client_idempotency_key": {
+                                        "type": "string",
+                                        "description": "Effective idempotency key associated with the original request."
                                     }
                                 }
+                            },
+                            "gates": {
+                                "type": "array",
+                                "items": {
+                                    "$ref": "#/components/schemas/GateDenial"
+                                },
+                                "description": "Structured per-gate denial detail for recipient-scope send-mail failures."
+                            },
+                            "request_id": {
+                                "type": "string",
+                                "description": "Server-issued request identifier for support and tracing."
                             }
                         },
                         "required": [
@@ -1702,6 +1893,71 @@ export const openapiDocument = {
                     "error"
                 ]
             },
+            "GateDenial": {
+                "type": "object",
+                "properties": {
+                    "name": {
+                        "type": "string",
+                        "enum": [
+                            "send_to_confirmed_domains",
+                            "send_to_known_addresses"
+                        ],
+                        "description": "Public recipient-scope gate name that denied the send."
+                    },
+                    "reason": {
+                        "type": "string",
+                        "enum": [
+                            "domain_not_confirmed",
+                            "recipient_unauthenticated",
+                            "recipient_not_known"
+                        ],
+                        "description": "Stable machine-readable denial reason."
+                    },
+                    "message": {
+                        "type": "string",
+                        "description": "Human-readable explanation of the gate denial."
+                    },
+                    "subject": {
+                        "type": "string",
+                        "description": "Domain or address the gate evaluated."
+                    },
+                    "fix": {
+                        "$ref": "#/components/schemas/GateFix"
+                    },
+                    "docs_url": {
+                        "type": "string",
+                        "description": "Public docs URL with more context."
+                    }
+                },
+                "required": [
+                    "name",
+                    "reason",
+                    "message",
+                    "subject"
+                ]
+            },
+            "GateFix": {
+                "type": "object",
+                "properties": {
+                    "action": {
+                        "type": "string",
+                        "enum": [
+                            "confirm_domain",
+                            "sender_must_fix_authentication",
+                            "wait_for_inbound"
+                        ],
+                        "description": "Suggested next action for the caller."
+                    },
+                    "subject": {
+                        "type": "string",
+                        "description": "Entity the action applies to."
+                    }
+                },
+                "required": [
+                    "action",
+                    "subject"
+                ]
+            },
             "Account": {
                 "type": "object",
                 "properties": {
@@ -2337,6 +2593,162 @@ export const openapiDocument = {
                     "to_email"
                 ]
             },
+            "SendMailInput": {
+                "type": "object",
+                "additionalProperties": false,
+                "properties": {
+                    "from": {
+                        "type": "string",
+                        "minLength": 3,
+                        "maxLength": 998,
+                        "description": "RFC 5322 From header. The sender domain must be a verified outbound domain for your organization."
+                    },
+                    "to": {
+                        "type": "string",
+                        "minLength": 3,
+                        "maxLength": 320,
+                        "description": "Recipient address. Recipient eligibility depends on your account's outbound entitlements."
+                    },
+                    "subject": {
+                        "type": "string",
+                        "minLength": 1,
+                        "maxLength": 998,
+                        "description": "Subject line for the outbound message"
+                    },
+                    "body_text": {
+                        "type": "string",
+                        "description": "Plain-text message body. At least one of body_text or body_html is required. The combined UTF-8 byte length of body_text and body_html must be at most 262144 bytes."
+                    },
+                    "body_html": {
+                        "type": "string",
+                        "description": "HTML message body. At least one of body_text or body_html is required. The combined UTF-8 byte length of body_text and body_html must be at most 262144 bytes."
+                    },
+                    "in_reply_to": {
+                        "type": "string",
+                        "minLength": 1,
+                        "maxLength": 998,
+                        "pattern": "^[^\\x00-\\x1F\\x7F]+$",
+                        "description": "Message-ID of the direct parent email when sending a threaded reply."
+                    },
+                    "references": {
+                        "type": "array",
+                        "maxItems": 100,
+                        "description": "Full ordered message-id chain for the thread.",
+                        "items": {
+                            "type": "string",
+                            "minLength": 1,
+                            "maxLength": 998,
+                            "pattern": "^[^\\x00-\\x1F\\x7F]+$"
+                        }
+                    },
+                    "wait": {
+                        "type": "boolean",
+                        "description": "When true, wait for the first downstream SMTP delivery outcome before returning."
+                    },
+                    "wait_timeout_ms": {
+                        "type": "integer",
+                        "minimum": 1000,
+                        "maximum": 30000,
+                        "description": "Maximum time to wait for a delivery outcome when wait is true. Defaults to 30000."
+                    }
+                },
+                "required": [
+                    "from",
+                    "to",
+                    "subject"
+                ]
+            },
+            "SentEmailStatus": {
+                "type": "string",
+                "enum": [
+                    "queued",
+                    "submitted_to_agent",
+                    "agent_failed",
+                    "unknown",
+                    "delivered",
+                    "bounced",
+                    "deferred",
+                    "wait_timeout"
+                ]
+            },
+            "DeliveryStatus": {
+                "type": "string",
+                "enum": [
+                    "delivered",
+                    "bounced",
+                    "deferred",
+                    "wait_timeout"
+                ]
+            },
+            "SendMailResult": {
+                "type": "object",
+                "properties": {
+                    "id": {
+                        "type": "string",
+                        "description": "Persisted sent-email attempt ID."
+                    },
+                    "status": {
+                        "$ref": "#/components/schemas/SentEmailStatus"
+                    },
+                    "queue_id": {
+                        "type": [
+                            "string",
+                            "null"
+                        ],
+                        "description": "Message identifier assigned by Primitive's outbound relay, when available."
+                    },
+                    "accepted": {
+                        "type": "array",
+                        "items": {
+                            "type": "string"
+                        },
+                        "description": "Recipient addresses accepted by the relay."
+                    },
+                    "rejected": {
+                        "type": "array",
+                        "items": {
+                            "type": "string"
+                        },
+                        "description": "Recipient addresses rejected by the relay."
+                    },
+                    "client_idempotency_key": {
+                        "type": "string",
+                        "description": "Effective idempotency key used for this send."
+                    },
+                    "request_id": {
+                        "type": "string",
+                        "description": "Server-issued request identifier for support and tracing."
+                    },
+                    "content_hash": {
+                        "type": "string",
+                        "description": "Stable hash of the canonical send payload."
+                    },
+                    "delivery_status": {
+                        "$ref": "#/components/schemas/DeliveryStatus"
+                    },
+                    "smtp_response_code": {
+                        "type": [
+                            "integer",
+                            "null"
+                        ],
+                        "description": "SMTP response code from the first downstream delivery outcome when wait is true."
+                    },
+                    "smtp_response_text": {
+                        "type": "string",
+                        "description": "SMTP response text from the first downstream delivery outcome when wait is true."
+                    }
+                },
+                "required": [
+                    "id",
+                    "status",
+                    "queue_id",
+                    "accepted",
+                    "rejected",
+                    "client_idempotency_key",
+                    "request_id",
+                    "content_hash"
+                ]
+            },
             "Endpoint": {
                 "type": "object",
                 "properties": {

package/dist/openapi/operations.generated.js

@@ -580,6 +580,22 @@ export const operationManifest = [
         "tag": "Filters",
         "tagCommand": "filters"
     },
+    {
+        "binaryResponse": false,
+        "bodyRequired": true,
+        "command": "send-email",
+        "description": "Sends an outbound email through Primitive's outbound relay. By default\nthe request returns once the relay accepts the message for delivery.\nSet `wait: true` to wait for the first downstream SMTP delivery outcome.\n",
+        "hasJsonBody": true,
+        "method": "POST",
+        "operationId": "sendEmail",
+        "path": "/send-mail",
+        "pathParams": [],
+        "queryParams": [],
+        "sdkName": "sendEmail",
+        "summary": "Send outbound email",
+        "tag": "Sending",
+        "tagCommand": "sending"
+    },
     {
         "binaryResponse": false,
         "bodyRequired": false,