@primitivedotdev/sdk 0.17.0 → 0.19.0

package/README.md

@@ -1,31 +1,77 @@
 # `@primitivedotdev/sdk`
 
-Official Primitive Node.js SDK.
+The official Node.js SDK and command-line tool for [Primitive](https://primitive.dev), an email API for sending and receiving programmatic mail.
 
-The default root import is intentionally small and centered on email
-automation:
+The package ships two things in one install:
 
-- `primitive.receive(...)`
-- `primitive.client(...)`
-- `client.send(...)`
-- `client.reply(...)`
-- `client.forward(...)`
+- A **`primitive` CLI** for interactive use, scripts, and agent workflows. Sends mail, reads inbound, inspects send history, manages domains and webhook endpoints, all in one binary.
+- A **typed Node library** for programmatic integration in app code. Receives and verifies inbound webhooks, sends mail, parses raw MIME, and exposes the full HTTP API as generated functions.
 
-Advanced webhook helpers, generated API operations, OpenAPI exports, contract
-tooling, raw MIME parsing, and the CLI still exist as named exports or subpath
-imports.
+Pick whichever fits the call site. The two share the same auth (`PRIMITIVE_API_KEY`), the same data shapes, and the same OpenAPI spec.
 
-## Requirements
+## Install
 
-- Node.js `>=22`
+```bash
+npm install @primitivedotdev/sdk
+```
+
+For one-off CLI use, `npx @primitivedotdev/sdk@latest <command>` works without installing.
 
-## Installation
+Requires Node.js 22 or newer.
+
+## Set your API key
+
+Get a key from your [dashboard](https://primitive.dev) and export it. Both the CLI and the library default to reading `PRIMITIVE_API_KEY` from the environment.
 
 ```bash
-npm install @primitivedotdev/sdk
+export PRIMITIVE_API_KEY=prim_...
 ```
 
-## Basic usage
+## Command line
+
+Everything below assumes `PRIMITIVE_API_KEY` is set. Each command also accepts `--api-key <value>` if you want to pass it explicitly.
+
+```bash
+# Confirm the key is live and see which account it authenticates.
+primitive whoami
+
+# Send an email. --wait blocks until the receiving MTA returns a delivery
+# outcome (a synchronous SMTP 250 from Gmail, etc.); without it, the call
+# returns once Primitive has accepted the message for delivery.
+primitive send --to alice@example.com --body "Hi Alice!" --wait
+
+# See the most recent inbound emails as a compact text table.
+# IDs are full UUIDs when piped, truncated for interactive terminals.
+primitive emails:latest --limit 5
+
+# Read one inbound's full record (body, headers, threading metadata).
+primitive emails:get-email --id <uuid>
+
+# Reply to an inbound. Threading and the "Re:" subject are derived
+# server-side from the parent message; you supply only the body.
+primitive sending:reply-to-email --id <inbound-id> --body-text "..."
+
+# See where you are allowed to send. Returns a typed list of
+# permission rules (managed-zone wildcards, your own verified domains,
+# specific addresses with grants). The send-mail call enforces these
+# at request time.
+primitive sending:get-send-permissions
+
+# Look up an operation's request/response schema, including per-field
+# descriptions sourced from the OpenAPI spec.
+primitive describe emails:get-email
+primitive describe sending:send-email
+```
+
+Run `primitive --help` for the full topic list and `primitive <topic> --help` for the commands within each. Every command accepts `--help`, and the descriptions are detailed enough that the CLI is self-documenting for most workflows.
+
+## Library
+
+The default root import is intentionally small and centered on the two most common app-code use cases: receiving inbound webhook deliveries and sending mail.
+
+```ts
+import primitive from "@primitivedotdev/sdk";
+```
 
 ### Receive and reply in a Next.js route
 
@@ -50,6 +96,8 @@ export async function POST(req: Request) {
 }
 ```
 
+`primitive.receive(...)` reads the request body, verifies the HMAC-SHA256 signature against your account secret (rejecting expired or tampered deliveries), and returns a normalized email object. `client.reply(email, ...)` derives threading and the `Re:` subject from the parent message server-side.
+
 ### Send a new email
 
 ```ts
@@ -64,9 +112,6 @@ const result = await client.send({
   to: "alice@example.com",
   subject: "Hello",
   bodyText: "Hi there",
-  // Use a unique key per logical send. Reusing a key returns the original
-  // response from the first send, which is how retries are deduplicated.
-  idempotencyKey: "customer-key-abc123",
   wait: true,
   waitTimeoutMs: 5000,
 });
@@ -74,27 +119,57 @@ const result = await client.send({
 console.log(result.id, result.status, result.queueId, result.deliveryStatus);
 ```
 
-`send`, `reply`, and `forward` keep the HTTP request open until Primitive's
-downstream SMTP transaction completes. In production, configure your runtime or
-transport with a request timeout long enough for SMTP delivery, typically 30-60
-seconds.
+`send`, `reply`, and `forward` keep the HTTP request open until Primitive's downstream SMTP transaction completes. In production, configure your runtime or transport with a request timeout long enough for SMTP delivery, typically 30 to 60 seconds.
+
+### Per-call request options
+
+Every client method accepts an optional second argument with cancellation, timeout, header, and idempotency controls:
+
+```ts
+interface RequestOptions {
+  // Cancel the in-flight request when this signal fires. Surfaces as AbortError.
+  signal?: AbortSignal;
+  // Per-call timeout in milliseconds. Composed with `signal` so either fires.
+  timeout?: number;
+  // Per-call headers merged on top of client-level headers. Last write wins.
+  headers?: Record<string, string>;
+  // Idempotency key for safe retries. Sent as the Idempotency-Key request header.
+  idempotencyKey?: string;
+}
+```
+
+Cap a single send at 15 seconds:
+
+```ts
+await client.send(
+  { from, to, subject, bodyText },
+  { signal: AbortSignal.timeout(15000) },
+);
+```
+
+Idempotency key for safe retries (reusing a key returns the original response, so a retried network call deduplicates against the first send):
+
+```ts
+await client.send(
+  { from, to, subject, bodyText },
+  { idempotencyKey: "customer-key-abc123" },
+);
+```
+
+Client-level config (default fetch, base URL, default headers passed to `primitive.client({...})`) still applies to every call. Per-call `RequestOptions` overrides or merges on top: headers merge (per-call wins on conflict), `signal` and `timeout` compose so the first to fire wins.
 
 ### About `wait` mode
 
-When `wait: true`, the call returns the first downstream SMTP outcome (or
-`waitTimeoutMs`, default 30000). Possible terminal `deliveryStatus` values:
+When `wait: true`, the call returns the first downstream SMTP outcome (or `waitTimeoutMs`, default 30000). Possible terminal `deliveryStatus` values:
 
 - `delivered` accepted by the receiving MTA
 - `bounced` rejected by the receiving MTA (the response is still 200 OK)
 - `deferred` temporary failure, the receiving MTA may retry
-- `wait_timeout` no outcome was observed in time. Treat as "outcome unknown."
-  The send may still complete after the response returns.
+- `wait_timeout` no outcome was observed in time. Treat as "outcome unknown." The send may still complete after the response returns.
 
 ### Reply from a different address
 
-`reply()` defaults the From address to the inbound recipient (the address that
-received the email). When your verified outbound domain differs from your
-inbound domain, pass `from` explicitly:
+`reply()` defaults the From address to the inbound recipient (the address that received the email). When your verified outbound domain differs from your inbound domain, pass `from` explicitly:
 
 ```ts
 await client.reply(email, {
@@ -105,8 +180,7 @@ await client.reply(email, {
 
 ### HTML replies and waiting on the delivery outcome
 
-`reply()` accepts `html` as a sibling of `text`, plus the same `wait` flag the
-top-level `send()` takes:
+`reply()` accepts `html` as a sibling of `text`, plus the same `wait` flag the top-level `send()` takes:
 
 ```ts
 await client.reply(email, {
@@ -116,14 +190,9 @@ await client.reply(email, {
 });
 ```
 
-`subject` is intentionally not accepted on `reply()`. Gmail's Conversation View
-needs both a References match and a normalized-subject match to thread, so a
-custom subject silently breaks the thread for half the recipient population.
-Use `client.send(...)` if you need full subject control.
+`subject` is intentionally not accepted on `reply()`. Gmail's Conversation View needs both a References match and a normalized-subject match to thread, so a custom subject silently breaks the thread for half the recipient population. Use `client.send(...)` if you need full subject control.
 
-If the inbound row is not in a state we can reply to (no `Message-Id` recorded,
-or content was discarded), the API returns `inbound_not_repliable` (HTTP 422)
-and the SDK throws.
+If the inbound row is not in a state we can reply to (no `Message-Id` recorded, or content was discarded), the API returns `inbound_not_repliable` (HTTP 422) and the SDK throws.
 
 ### Forward an inbound email
 
@@ -136,37 +205,35 @@ await client.forward(email, {
 
 ## The normalized email object
 
-`primitive.receive(...)` returns a normalized inbound email object that keeps the
-common case clean:
+`primitive.receive(...)` returns a normalized inbound email object that keeps the common case clean:
 
 ```ts
-email.sender.address
-email.sender.name
+email.sender.address;
+email.sender.name;
 
-email.receivedBy
-email.receivedByAll
+email.receivedBy;
+email.receivedByAll;
 
-email.replyTarget.address
-email.replySubject
-email.forwardSubject
+email.replyTarget.address;
+email.replySubject;
+email.forwardSubject;
 
-email.subject
-email.text
+email.subject;
+email.text;
 
-email.thread.messageId
-email.thread.references
+email.thread.messageId;
+email.thread.references;
 
-email.raw
+email.raw;
 ```
 
 Use `email.raw` when you need the original validated webhook event shape.
 
-## Advanced usage
+## Lower-level surfaces
 
-### Explicit receive form
+### Explicit `receive` form
 
-If your framework does not expose a standard `Request`, use the lower-level
-form:
+If your framework does not expose a standard `Request`, use the lower-level form:
 
 ```ts
 const email = primitive.receive({
@@ -176,9 +243,9 @@ const email = primitive.receive({
 });
 ```
 
-### Generated API module
+### Generated API client
 
-Use the API subpath when you want the full generated HTTP API surface:
+The full HTTP API is exposed as a generated client. Use it when the high-level helpers don't cover what you need:
 
 ```ts
 import { PrimitiveApiClient, getAccount } from "@primitivedotdev/sdk/api";
@@ -187,13 +254,46 @@ const api = new PrimitiveApiClient({ apiKey: process.env.PRIMITIVE_API_KEY });
 const result = await getAccount({ client: api.client });
 ```
 
-### Other advanced surfaces
+### Webhook signature verification
+
+`primitive.receive(...)` handles verification automatically. If you need to verify a delivery yourself (a different language reverse-proxying through Node, a one-off audit, etc.), the wire format is:
+
+- Header: `Primitive-Signature: t=<unix-seconds>,v1=<hex>`. A legacy `MyMX-Signature` header carries the same value for back-compat.
+- Signed string: `${timestamp}.${rawBody}` where `rawBody` is the exact request bytes before any JSON decoding.
+- Signature: HMAC-SHA256, hex-encoded.
+- Secret: returned by `GET /account/webhook-secret`. Use as a UTF-8 string; do not base64-decode despite the base64-shaped output.
+- Tolerance: reject deliveries with a timestamp more than 5 minutes off your wall-clock.
+
+The Node helper:
+
+```ts
+import { verifyWebhookSignature } from "@primitivedotdev/sdk/webhook";
+
+verifyWebhookSignature({
+  rawBody: rawBodyString,
+  signatureHeader: req.headers["primitive-signature"] as string,
+  secret: process.env.PRIMITIVE_WEBHOOK_SECRET!,
+});
+```
+
+`rawBody` must be the exact bytes of the HTTP body (string or Buffer) before any JSON parsing. `signatureHeader` is the value of the `Primitive-Signature` header verbatim. Throws `WebhookVerificationError` on mismatch, expired timestamp, or malformed input. Pass `toleranceSeconds` to override the default 300-second replay window.
+
+For most app-code callers, `primitive.receive(...)` from the root import handles both the body extraction and verification in one call (see "Receive and reply in a Next.js route" above). Reach for `verifyWebhookSignature` directly when your framework doesn't expose a standard `Request` and you've already pulled the raw body and header value yourself.
+
+For the full reference (response codes, replay protection details), see the API-level "Webhook signing" section in the [OpenAPI spec](https://primitive.dev/api/v1/openapi).
+
+### Other subpath imports
+
+- `@primitivedotdev/sdk/openapi` exports the OpenAPI document and the operation manifest as JSON. Useful for tools that want the spec inline.
+- `@primitivedotdev/sdk/contract` builds and signs webhook payloads. Useful for tests or replaying inbound events through your own handler.
+- `@primitivedotdev/sdk/parser` parses raw `.eml` files and bundles attachments. Useful when you receive inbound mail through a different path (forwarded `.eml` files, archived storage) and want the same normalization the webhook receiver applies.
+
+## Going further
 
-- `@primitivedotdev/sdk/webhook`
-- `@primitivedotdev/sdk/openapi`
-- `@primitivedotdev/sdk/contract`
-- `@primitivedotdev/sdk/parser`
-- `primitive` CLI
+- [primitive.dev/docs](https://primitive.dev/docs) for product docs (quickstart, webhook payload reference, FAQ).
+- [primitive.dev/api/v1/openapi](https://primitive.dev/api/v1/openapi) for the machine-readable OpenAPI spec.
+- `primitive list-operations` for the same spec as a JSON manifest, fetched from the bundled SDK.
+- `primitive describe <command>` for the inlined request/response schema of a single operation, including per-field descriptions.
 
 ## Development
 

package/dist/api/generated/index.js

@@ -1,2 +1,2 @@
 // This file is auto-generated by @hey-api/openapi-ts
-export { addDomain, createEndpoint, createFilter, deleteDomain, deleteEmail, deleteEndpoint, deleteFilter, discardEmailContent, downloadAttachments, downloadRawEmail, getAccount, getEmail, getSendPermissions, getSentEmail, getStorageStats, getWebhookSecret, listDeliveries, listDomains, listEmails, listEndpoints, listFilters, listSentEmails, replayDelivery, replayEmailWebhooks, replyToEmail, rotateWebhookSecret, sendEmail, testEndpoint, updateAccount, updateDomain, updateEndpoint, updateFilter, verifyDomain } from './sdk.gen.js';
+export { addDomain, cliLogout, createEndpoint, createFilter, deleteDomain, deleteEmail, deleteEndpoint, deleteFilter, discardEmailContent, downloadAttachments, downloadRawEmail, getAccount, getEmail, getSendPermissions, getSentEmail, getStorageStats, getWebhookSecret, listDeliveries, listDomains, listEmails, listEndpoints, listFilters, listSentEmails, pollCliLogin, replayDelivery, replayEmailWebhooks, replyToEmail, rotateWebhookSecret, sendEmail, startCliLogin, testEndpoint, updateAccount, updateDomain, updateEndpoint, updateFilter, verifyDomain } from './sdk.gen.js';

package/dist/api/generated/sdk.gen.js

@@ -1,5 +1,53 @@
 // This file is auto-generated by @hey-api/openapi-ts
 import { client } from './client.gen.js';
+/**
+ * Start CLI browser login
+ *
+ * Starts a browser-assisted CLI login session. The response includes a
+ * device code for polling and a user code that the user approves in the
+ * browser. This endpoint does not require an API key.
+ *
+ */
+export const startCliLogin = (options) => (options?.client ?? client).post({
+    url: '/cli/login/start',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options?.headers
+    }
+});
+/**
+ * Poll CLI browser login
+ *
+ * Polls a CLI login session until the browser approval either succeeds,
+ * is denied, expires, or is polled too quickly. The API key is generated
+ * only after approval and is returned exactly once.
+ *
+ */
+export const pollCliLogin = (options) => (options.client ?? client).post({
+    url: '/cli/login/poll',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * Revoke the current CLI API key
+ *
+ * Revokes the API key used to authenticate the request. CLI clients use
+ * this endpoint during `primitive logout` before removing local credentials.
+ *
+ */
+export const cliLogout = (options) => (options?.client ?? client).post({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/cli/logout',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options?.headers
+    }
+});
 /**
  * Get account info
  */
@@ -290,7 +338,7 @@ export const replayEmailWebhooks = (options) => (options.client ?? client).post(
  * dashboard at Settings > Webhooks). When the toggle is off, this
  * endpoint returns `403` with code `discard_not_enabled` and a
  * message pointing the human at the dashboard. There is intentionally
- * no API to flip this toggle — opting in to a destructive,
+ * no API to flip this toggle. Opting in to a destructive,
  * non-reversible operation must be a deliberate human click in the
  * UI.
  *

package/dist/api/index.d.ts

@@ -1,2 +1,2 @@
-import { $ as AddDomainData, $i as RequestOptions, $n as ListDomainsErrors, $r as SendPermissionAddress, $t as DownloadAttachmentsResponses, A as getSendPermissions, Ai as UpdateEndpointError, An as GetSentEmailData, Ar as ReplayEmailWebhooksError, At as DeleteEndpointError, B as replayDelivery, Bi as UpdateFilterResponses, Bn as GetWebhookSecretData, Br as ResourceId, Bt as DeliverySummary, C as deleteEndpoint, Ci as UpdateDomainData, Cn as GetEmailResponse, Cr as PaginationMeta, Ct as DeleteDomainResponses, D as downloadRawEmail, Di as UpdateDomainResponse, Dn as GetSendPermissionsErrors, Dr as ReplayDeliveryResponse, Dt as DeleteEmailResponse, E as downloadAttachments, Ei as UpdateDomainInput, En as GetSendPermissionsError, Er as ReplayDeliveryErrors, Et as DeleteEmailErrors, F as listDomains, Fi as UpdateFilterData, Fn as GetStorageStatsData, Fr as ReplyToEmailData, Ft as DeleteFilterError, G as testEndpoint, Gi as VerifyDomainResponse, Gn as Limit, Gr as RotateWebhookSecretResponses, Gt as DiscardEmailContentResponse, H as replyToEmail, Hi as VerifyDomainData, Hn as GetWebhookSecretErrors, Hr as RotateWebhookSecretError, Ht as DiscardEmailContentData, I as listEmails, Ii as UpdateFilterError, In as GetStorageStatsError, Ir as ReplyToEmailError, It as DeleteFilterErrors, J as updateEndpoint, Ji as Client, Jn as ListDeliveriesErrors, Jr as SendEmailErrors, Jt as DomainVerifyResult, K as updateAccount, Ki as VerifyDomainResponses, Kn as ListDeliveriesData, Kr as SendEmailData, Kt as DiscardEmailContentResponses, L as listEndpoints, Li as UpdateFilterErrors, Ln as GetStorageStatsErrors, Lr as ReplyToEmailErrors, Lt as DeleteFilterResponse, M as getStorageStats, Mi as UpdateEndpointInput, Mn as GetSentEmailErrors, Mr as ReplayEmailWebhooksResponse, Mt as DeleteEndpointResponse, N as getWebhookSecret, Ni as UpdateEndpointResponse, Nn as GetSentEmailResponse, Nr as ReplayEmailWebhooksResponses, Nt as DeleteEndpointResponses, O as getAccount, Oi as UpdateDomainResponses, On as GetSendPermissionsResponse, Or as ReplayDeliveryResponses, Ot as DeleteEmailResponses, P as listDeliveries, Pi as UpdateEndpointResponses, Pn as GetSentEmailResponses, Pr as ReplayResult, Pt as DeleteFilterData, Q as AccountUpdated, Qi as Options$1, Qn as ListDomainsError, Qr as SendMailResult, Qt as DownloadAttachmentsResponse, R as listFilters, Ri as UpdateFilterInput, Rn as GetStorageStatsResponse, Rr as ReplyToEmailResponse, Rt as DeleteFilterResponses, S as deleteEmail, Si as UpdateAccountResponses, Sn as GetEmailErrors, Sr as ListSentEmailsResponses, St as DeleteDomainResponse, T as discardEmailContent, Ti as UpdateDomainErrors, Tn as GetSendPermissionsData, Tr as ReplayDeliveryError, Tt as DeleteEmailError, U as rotateWebhookSecret, Ui as VerifyDomainError, Un as GetWebhookSecretResponse, Ur as RotateWebhookSecretErrors, Ut as DiscardEmailContentError, V as replayEmailWebhooks, Vi as VerifiedDomain, Vn as GetWebhookSecretError, Vr as RotateWebhookSecretData, Vt as DiscardContentResult, W as sendEmail, Wi as VerifyDomainErrors, Wn as GetWebhookSecretResponses, Wr as RotateWebhookSecretResponse, Wt as DiscardEmailContentErrors, X as verifyDomain, Xi as Config, Xn as ListDeliveriesResponses, Xr as SendEmailResponses, Xt as DownloadAttachmentsError, Y as updateFilter, Yi as ClientOptions$1, Yn as ListDeliveriesResponse, Yr as SendEmailResponse, Yt as DownloadAttachmentsData, Z as Account, Zi as CreateClientConfig, Zn as ListDomainsData, Zr as SendMailInput, Zt as DownloadAttachmentsErrors, _ as Options, _i as UpdateAccountData, _n as GetAccountErrors, _r as ListFiltersResponses, _t as CreateFilterResponses, a as PrimitiveApiError, ai as SentEmailDetail, an as EmailDetail, ar as ListEmailsResponse, at as ClientOptions, b as createFilter, bi as UpdateAccountInput, bn as GetEmailData, br as ListSentEmailsErrors, bt as DeleteDomainError, c as PrimitiveClientOptions, ci as StorageStats, cn as EmailSummary, cr as ListEndpointsError, ct as CreateEndpointErrors, d as SendResult, di as TestEndpointError, dn as ErrorResponse, dr as ListEndpointsResponses, dt as CreateEndpointResponses, ea as RequestResult, ei as SendPermissionAnyRecipient, en as DownloadRawEmailData, er as ListDomainsResponse, et as AddDomainError, f as SendThreadInput, fi as TestEndpointErrors, fn as Filter, fr as ListEnvelope, ft as CreateFilterData, g as operations, gi as UnverifiedDomain, gn as GetAccountError, gr as ListFiltersResponse, gt as CreateFilterResponse, h as createPrimitiveClient, hi as TestResult, hn as GetAccountData, hr as ListFiltersErrors, ht as CreateFilterInput, i as PrimitiveApiClientOptions, ii as SendPermissionsMeta, in as DownloadRawEmailResponses, ir as ListEmailsErrors, it as AddDomainResponses, j as getSentEmail, ji as UpdateEndpointErrors, jn as GetSentEmailError, jr as ReplayEmailWebhooksErrors, jt as DeleteEndpointErrors, k as getEmail, ki as UpdateEndpointData, kn as GetSendPermissionsResponses, kr as ReplayEmailWebhooksData, kt as DeleteEndpointData, l as ReplyInput, li as SuccessEnvelope, ln as EmailWebhookStatus, lr as ListEndpointsErrors, lt as CreateEndpointInput, m as createPrimitiveApiClient, mi as TestEndpointResponses, mn as GateFix, mr as ListFiltersError, mt as CreateFilterErrors, n as ForwardInput, na as Auth, ni as SendPermissionRule, nn as DownloadRawEmailErrors, nr as ListEmailsData, nt as AddDomainInput, o as PrimitiveApiErrorDetails, oi as SentEmailStatus, on as EmailDetailReply, or as ListEmailsResponses, ot as CreateEndpointData, p as client, pi as TestEndpointResponse, pn as GateDenial, pr as ListFiltersData, pt as CreateFilterError, q as updateDomain, qi as WebhookSecret, qn as ListDeliveriesError, qr as SendEmailError, qt as Domain, r as PrimitiveApiClient, ri as SendPermissionYourDomain, rn as DownloadRawEmailResponse, rr as ListEmailsError, rt as AddDomainResponse, s as PrimitiveClient, si as SentEmailSummary, sn as EmailStatus, sr as ListEndpointsData, st as CreateEndpointError, t as DEFAULT_BASE_URL, ta as ResponseStyle, ti as SendPermissionManagedZone, tn as DownloadRawEmailError, tr as ListDomainsResponses, tt as AddDomainErrors, u as SendInput, ui as TestEndpointData, un as Endpoint, ur as ListEndpointsResponse, ut as CreateEndpointResponse, v as addDomain, vi as UpdateAccountError, vn as GetAccountResponse, vr as ListSentEmailsData, vt as Cursor, w as deleteFilter, wi as UpdateDomainError, wn as GetEmailResponses, wr as ReplayDeliveryData, wt as DeleteEmailData, x as deleteDomain, xi as UpdateAccountResponse, xn as GetEmailError, xr as ListSentEmailsResponse, xt as DeleteDomainErrors, y as createEndpoint, yi as UpdateAccountErrors, yn as GetAccountResponses, yr as ListSentEmailsError, yt as DeleteDomainData, z as listSentEmails, zi as UpdateFilterResponse, zn as GetStorageStatsResponses, zr as ReplyToEmailResponses, zt as DeliveryStatus } from "../index-CHWqMBs6.js";
-export { Account, AccountUpdated, AddDomainData, AddDomainError, AddDomainErrors, AddDomainInput, AddDomainResponse, AddDomainResponses, Auth, ClientOptions, CreateClientConfig, CreateEndpointData, CreateEndpointError, CreateEndpointErrors, CreateEndpointInput, CreateEndpointResponse, CreateEndpointResponses, CreateFilterData, CreateFilterError, CreateFilterErrors, CreateFilterInput, CreateFilterResponse, CreateFilterResponses, Cursor, DEFAULT_BASE_URL, DeleteDomainData, DeleteDomainError, DeleteDomainErrors, DeleteDomainResponse, DeleteDomainResponses, DeleteEmailData, DeleteEmailError, DeleteEmailErrors, DeleteEmailResponse, DeleteEmailResponses, DeleteEndpointData, DeleteEndpointError, DeleteEndpointErrors, DeleteEndpointResponse, DeleteEndpointResponses, DeleteFilterData, DeleteFilterError, DeleteFilterErrors, DeleteFilterResponse, DeleteFilterResponses, DeliveryStatus, DeliverySummary, DiscardContentResult, DiscardEmailContentData, DiscardEmailContentError, DiscardEmailContentErrors, DiscardEmailContentResponse, DiscardEmailContentResponses, Domain, DomainVerifyResult, DownloadAttachmentsData, DownloadAttachmentsError, DownloadAttachmentsErrors, DownloadAttachmentsResponse, DownloadAttachmentsResponses, DownloadRawEmailData, DownloadRawEmailError, DownloadRawEmailErrors, DownloadRawEmailResponse, DownloadRawEmailResponses, EmailDetail, EmailDetailReply, EmailStatus, EmailSummary, EmailWebhookStatus, Endpoint, ErrorResponse, Filter, ForwardInput, GateDenial, GateFix, GetAccountData, GetAccountError, GetAccountErrors, GetAccountResponse, GetAccountResponses, GetEmailData, GetEmailError, GetEmailErrors, GetEmailResponse, GetEmailResponses, GetSendPermissionsData, GetSendPermissionsError, GetSendPermissionsErrors, GetSendPermissionsResponse, GetSendPermissionsResponses, GetSentEmailData, GetSentEmailError, GetSentEmailErrors, GetSentEmailResponse, GetSentEmailResponses, GetStorageStatsData, GetStorageStatsError, GetStorageStatsErrors, GetStorageStatsResponse, GetStorageStatsResponses, GetWebhookSecretData, GetWebhookSecretError, GetWebhookSecretErrors, GetWebhookSecretResponse, GetWebhookSecretResponses, Limit, ListDeliveriesData, ListDeliveriesError, ListDeliveriesErrors, ListDeliveriesResponse, ListDeliveriesResponses, ListDomainsData, ListDomainsError, ListDomainsErrors, ListDomainsResponse, ListDomainsResponses, ListEmailsData, ListEmailsError, ListEmailsErrors, ListEmailsResponse, ListEmailsResponses, ListEndpointsData, ListEndpointsError, ListEndpointsErrors, ListEndpointsResponse, ListEndpointsResponses, ListEnvelope, ListFiltersData, ListFiltersError, ListFiltersErrors, ListFiltersResponse, ListFiltersResponses, ListSentEmailsData, ListSentEmailsError, ListSentEmailsErrors, ListSentEmailsResponse, ListSentEmailsResponses, Options, PaginationMeta, PrimitiveApiClient, PrimitiveApiClientOptions, PrimitiveApiError, PrimitiveApiErrorDetails, PrimitiveClient, PrimitiveClientOptions, Client as PrimitiveGeneratedApiClient, ClientOptions$1 as PrimitiveGeneratedApiClientOptions, Config as PrimitiveGeneratedApiConfig, Options$1 as PrimitiveGeneratedApiOptions, RequestOptions as PrimitiveGeneratedApiRequestOptions, RequestResult as PrimitiveGeneratedApiRequestResult, ReplayDeliveryData, ReplayDeliveryError, ReplayDeliveryErrors, ReplayDeliveryResponse, ReplayDeliveryResponses, ReplayEmailWebhooksData, ReplayEmailWebhooksError, ReplayEmailWebhooksErrors, ReplayEmailWebhooksResponse, ReplayEmailWebhooksResponses, ReplayResult, ReplyInput, ReplyToEmailData, ReplyToEmailError, ReplyToEmailErrors, ReplyToEmailResponse, ReplyToEmailResponses, ResourceId, ResponseStyle, RotateWebhookSecretData, RotateWebhookSecretError, RotateWebhookSecretErrors, RotateWebhookSecretResponse, RotateWebhookSecretResponses, SendEmailData, SendEmailError, SendEmailErrors, SendEmailResponse, SendEmailResponses, SendInput, SendMailInput, SendMailResult, SendPermissionAddress, SendPermissionAnyRecipient, SendPermissionManagedZone, SendPermissionRule, SendPermissionYourDomain, SendPermissionsMeta, SendResult, SendThreadInput, SentEmailDetail, SentEmailStatus, SentEmailSummary, StorageStats, SuccessEnvelope, TestEndpointData, TestEndpointError, TestEndpointErrors, TestEndpointResponse, TestEndpointResponses, TestResult, UnverifiedDomain, UpdateAccountData, UpdateAccountError, UpdateAccountErrors, UpdateAccountInput, UpdateAccountResponse, UpdateAccountResponses, UpdateDomainData, UpdateDomainError, UpdateDomainErrors, UpdateDomainInput, UpdateDomainResponse, UpdateDomainResponses, UpdateEndpointData, UpdateEndpointError, UpdateEndpointErrors, UpdateEndpointInput, UpdateEndpointResponse, UpdateEndpointResponses, UpdateFilterData, UpdateFilterError, UpdateFilterErrors, UpdateFilterInput, UpdateFilterResponse, UpdateFilterResponses, VerifiedDomain, VerifyDomainData, VerifyDomainError, VerifyDomainErrors, VerifyDomainResponse, VerifyDomainResponses, WebhookSecret, addDomain, client, createEndpoint, createFilter, createPrimitiveApiClient, createPrimitiveClient, deleteDomain, deleteEmail, deleteEndpoint, deleteFilter, discardEmailContent, downloadAttachments, downloadRawEmail, getAccount, getEmail, getSendPermissions, getSentEmail, getStorageStats, getWebhookSecret, listDeliveries, listDomains, listEmails, listEndpoints, listFilters, listSentEmails, operations, replayDelivery, replayEmailWebhooks, replyToEmail, rotateWebhookSecret, sendEmail, testEndpoint, updateAccount, updateDomain, updateEndpoint, updateFilter, verifyDomain };
+import { $ as updateFilter, $i as UpdateDomainResponses, $n as GetWebhookSecretData, $r as ReplayResult, $t as DeliverySummary, A as getAccount, Ai as StartCliLoginInput, An as GetAccountErrors, Ar as ListFiltersResponses, At as CreateFilterResponses, B as listFilters, Bi as TestResult, Bn as GetSendPermissionsErrors, Br as PollCliLoginInput, Bt as DeleteEmailResponse, C as deleteDomain, Ca as Options$1, Ci as SendPermissionsMeta, Cn as Endpoint, Cr as ListEndpointsResponse, Ct as CreateEndpointResponse, D as discardEmailContent, Da as Auth, Di as StartCliLoginData, Dn as GateFix, Dr as ListFiltersError, Dt as CreateFilterErrors, E as deleteFilter, Ea as ResponseStyle, Ei as SentEmailSummary, En as GateDenial, Er as ListFiltersData, Et as CreateFilterError, F as getWebhookSecret, Fi as TestEndpointData, Fn as GetEmailErrors, Fr as ListSentEmailsResponses, Ft as DeleteDomainResponse, G as replyToEmail, Gi as UpdateAccountInput, Gn as GetSentEmailErrors, Gr as ReplayDeliveryErrors, Gt as DeleteEndpointResponse, H as pollCliLogin, Hi as UpdateAccountData, Hn as GetSendPermissionsResponses, Hr as PollCliLoginResponses, Ht as DeleteEndpointData, I as listDeliveries, Ii as TestEndpointError, In as GetEmailResponse, Ir as PaginationMeta, It as DeleteDomainResponses, J as startCliLogin, Ji as UpdateDomainData, Jn as GetStorageStatsData, Jr as ReplayEmailWebhooksData, Jt as DeleteFilterError, K as rotateWebhookSecret, Ki as UpdateAccountResponse, Kn as GetSentEmailResponse, Kr as ReplayDeliveryResponse, Kt as DeleteEndpointResponses, L as listDomains, Li as TestEndpointErrors, Ln as GetEmailResponses, Lr as PollCliLoginData, Lt as DeleteEmailData, M as getSendPermissions, Mi as StartCliLoginResponses, Mn as GetAccountResponses, Mr as ListSentEmailsError, Mt as DeleteDomainData, N as getSentEmail, Ni as StorageStats, Nn as GetEmailData, Nr as ListSentEmailsErrors, Nt as DeleteDomainError, O as downloadAttachments, Oi as StartCliLoginError, On as GetAccountData, Or as ListFiltersErrors, Ot as CreateFilterInput, P as getStorageStats, Pi as SuccessEnvelope, Pn as GetEmailError, Pr as ListSentEmailsResponse, Pt as DeleteDomainErrors, Q as updateEndpoint, Qi as UpdateDomainResponse, Qn as GetStorageStatsResponses, Qr as ReplayEmailWebhooksResponses, Qt as DeliveryStatus, R as listEmails, Ri as TestEndpointResponse, Rn as GetSendPermissionsData, Rr as PollCliLoginError, Rt as DeleteEmailError, S as createFilter, Sa as CreateClientConfig, Si as SendPermissionYourDomain, Sn as EmailWebhookStatus, Sr as ListEndpointsErrors, St as CreateEndpointInput, T as deleteEndpoint, Ta as RequestResult, Ti as SentEmailStatus, Tn as Filter, Tr as ListEnvelope, Tt as CreateFilterData, U as replayDelivery, Ui as UpdateAccountError, Un as GetSentEmailData, Ur as ReplayDeliveryData, Ut as DeleteEndpointError, V as listSentEmails, Vi as UnverifiedDomain, Vn as GetSendPermissionsResponse, Vr as PollCliLoginResponse, Vt as DeleteEmailResponses, W as replayEmailWebhooks, Wi as UpdateAccountErrors, Wn as GetSentEmailError, Wr as ReplayDeliveryError, Wt as DeleteEndpointErrors, X as updateAccount, Xi as UpdateDomainErrors, Xn as GetStorageStatsErrors, Xr as ReplayEmailWebhooksErrors, Xt as DeleteFilterResponse, Y as testEndpoint, Yi as UpdateDomainError, Yn as GetStorageStatsError, Yr as ReplayEmailWebhooksError, Yt as DeleteFilterErrors, Z as updateDomain, Zi as UpdateDomainInput, Zn as GetStorageStatsResponse, Zr as ReplayEmailWebhooksResponse, Zt as DeleteFilterResponses, _ as operations, _a as VerifyDomainResponses, _i as SendMailResult, _n as DownloadRawEmailResponses, _r as ListEmailsErrors, _t as CliLogoutResult, a as PrimitiveApiError, aa as UpdateEndpointResponses, ai as ResourceId, an as DiscardEmailContentResponses, ar as ListDeliveriesData, at as AddDomainErrors, b as cliLogout, ba as ClientOptions$1, bi as SendPermissionManagedZone, bn as EmailStatus, br as ListEndpointsData, bt as CreateEndpointError, c as PrimitiveClientOptions, ca as UpdateFilterErrors, ci as RotateWebhookSecretErrors, cn as DownloadAttachmentsData, cr as ListDeliveriesResponse, ct as AddDomainResponses, d as SendInput, da as UpdateFilterResponses, di as SendEmailData, dn as DownloadAttachmentsResponse, dr as ListDomainsError, dt as CliLogoutData, ea as UpdateEndpointData, ei as ReplyToEmailData, en as DiscardContentResult, er as GetWebhookSecretError, et as verifyDomain, f as SendResult, fa as VerifiedDomain, fi as SendEmailError, fn as DownloadAttachmentsResponses, fr as ListDomainsErrors, ft as CliLogoutError, g as createPrimitiveClient, ga as VerifyDomainResponse, gi as SendMailInput, gn as DownloadRawEmailResponse, gr as ListEmailsError, gt as CliLogoutResponses, h as createPrimitiveApiClient, ha as VerifyDomainErrors, hi as SendEmailResponses, hn as DownloadRawEmailErrors, hr as ListEmailsData, ht as CliLogoutResponse, i as PrimitiveApiClientOptions, ia as UpdateEndpointResponse, ii as ReplyToEmailResponses, in as DiscardEmailContentResponse, ir as Limit, it as AddDomainError, j as getEmail, ji as StartCliLoginResponse, jn as GetAccountResponse, jr as ListSentEmailsData, jt as Cursor, k as downloadRawEmail, ki as StartCliLoginErrors, kn as GetAccountError, kr as ListFiltersResponse, kt as CreateFilterResponse, l as ReplyInput, la as UpdateFilterInput, li as RotateWebhookSecretResponse, ln as DownloadAttachmentsError, lr as ListDeliveriesResponses, lt as CliLoginPollResult, m as client, ma as VerifyDomainError, mi as SendEmailResponse, mn as DownloadRawEmailError, mr as ListDomainsResponses, mt as CliLogoutInput, n as ForwardInput, na as UpdateEndpointErrors, ni as ReplyToEmailErrors, nn as DiscardEmailContentError, nr as GetWebhookSecretResponse, nt as AccountUpdated, o as PrimitiveApiErrorDetails, oa as UpdateFilterData, oi as RotateWebhookSecretData, on as Domain, or as ListDeliveriesError, ot as AddDomainInput, p as SendThreadInput, pa as VerifyDomainData, pi as SendEmailErrors, pn as DownloadRawEmailData, pr as ListDomainsResponse, pt as CliLogoutErrors, q as sendEmail, qi as UpdateAccountResponses, qn as GetSentEmailResponses, qr as ReplayDeliveryResponses, qt as DeleteFilterData, r as PrimitiveApiClient, ra as UpdateEndpointInput, ri as ReplyToEmailResponse, rn as DiscardEmailContentErrors, rr as GetWebhookSecretResponses, rt as AddDomainData, s as PrimitiveClient, sa as UpdateFilterError, si as RotateWebhookSecretError, sn as DomainVerifyResult, sr as ListDeliveriesErrors, st as AddDomainResponse, t as DEFAULT_BASE_URL, ta as UpdateEndpointError, ti as ReplyToEmailError, tn as DiscardEmailContentData, tr as GetWebhookSecretErrors, tt as Account, u as RequestOptions$1, ua as UpdateFilterResponse, ui as RotateWebhookSecretResponses, un as DownloadAttachmentsErrors, ur as ListDomainsData, ut as CliLoginStartResult, v as Options, va as WebhookSecret, vi as SendPermissionAddress, vn as EmailDetail, vr as ListEmailsResponse, vt as ClientOptions, w as deleteEmail, wa as RequestOptions, wi as SentEmailDetail, wn as ErrorResponse, wr as ListEndpointsResponses, wt as CreateEndpointResponses, x as createEndpoint, xa as Config, xi as SendPermissionRule, xn as EmailSummary, xr as ListEndpointsError, xt as CreateEndpointErrors, y as addDomain, ya as Client, yi as SendPermissionAnyRecipient, yn as EmailDetailReply, yr as ListEmailsResponses, yt as CreateEndpointData, z as listEndpoints, zi as TestEndpointResponses, zn as GetSendPermissionsError, zr as PollCliLoginErrors, zt as DeleteEmailErrors } from "../index-oRkCqj6u.js";
+export { Account, AccountUpdated, AddDomainData, AddDomainError, AddDomainErrors, AddDomainInput, AddDomainResponse, AddDomainResponses, Auth, CliLoginPollResult, CliLoginStartResult, CliLogoutData, CliLogoutError, CliLogoutErrors, CliLogoutInput, CliLogoutResponse, CliLogoutResponses, CliLogoutResult, ClientOptions, CreateClientConfig, CreateEndpointData, CreateEndpointError, CreateEndpointErrors, CreateEndpointInput, CreateEndpointResponse, CreateEndpointResponses, CreateFilterData, CreateFilterError, CreateFilterErrors, CreateFilterInput, CreateFilterResponse, CreateFilterResponses, Cursor, DEFAULT_BASE_URL, DeleteDomainData, DeleteDomainError, DeleteDomainErrors, DeleteDomainResponse, DeleteDomainResponses, DeleteEmailData, DeleteEmailError, DeleteEmailErrors, DeleteEmailResponse, DeleteEmailResponses, DeleteEndpointData, DeleteEndpointError, DeleteEndpointErrors, DeleteEndpointResponse, DeleteEndpointResponses, DeleteFilterData, DeleteFilterError, DeleteFilterErrors, DeleteFilterResponse, DeleteFilterResponses, DeliveryStatus, DeliverySummary, DiscardContentResult, DiscardEmailContentData, DiscardEmailContentError, DiscardEmailContentErrors, DiscardEmailContentResponse, DiscardEmailContentResponses, Domain, DomainVerifyResult, DownloadAttachmentsData, DownloadAttachmentsError, DownloadAttachmentsErrors, DownloadAttachmentsResponse, DownloadAttachmentsResponses, DownloadRawEmailData, DownloadRawEmailError, DownloadRawEmailErrors, DownloadRawEmailResponse, DownloadRawEmailResponses, EmailDetail, EmailDetailReply, EmailStatus, EmailSummary, EmailWebhookStatus, Endpoint, ErrorResponse, Filter, ForwardInput, GateDenial, GateFix, GetAccountData, GetAccountError, GetAccountErrors, GetAccountResponse, GetAccountResponses, GetEmailData, GetEmailError, GetEmailErrors, GetEmailResponse, GetEmailResponses, GetSendPermissionsData, GetSendPermissionsError, GetSendPermissionsErrors, GetSendPermissionsResponse, GetSendPermissionsResponses, GetSentEmailData, GetSentEmailError, GetSentEmailErrors, GetSentEmailResponse, GetSentEmailResponses, GetStorageStatsData, GetStorageStatsError, GetStorageStatsErrors, GetStorageStatsResponse, GetStorageStatsResponses, GetWebhookSecretData, GetWebhookSecretError, GetWebhookSecretErrors, GetWebhookSecretResponse, GetWebhookSecretResponses, Limit, ListDeliveriesData, ListDeliveriesError, ListDeliveriesErrors, ListDeliveriesResponse, ListDeliveriesResponses, ListDomainsData, ListDomainsError, ListDomainsErrors, ListDomainsResponse, ListDomainsResponses, ListEmailsData, ListEmailsError, ListEmailsErrors, ListEmailsResponse, ListEmailsResponses, ListEndpointsData, ListEndpointsError, ListEndpointsErrors, ListEndpointsResponse, ListEndpointsResponses, ListEnvelope, ListFiltersData, ListFiltersError, ListFiltersErrors, ListFiltersResponse, ListFiltersResponses, ListSentEmailsData, ListSentEmailsError, ListSentEmailsErrors, ListSentEmailsResponse, ListSentEmailsResponses, Options, PaginationMeta, PollCliLoginData, PollCliLoginError, PollCliLoginErrors, PollCliLoginInput, PollCliLoginResponse, PollCliLoginResponses, PrimitiveApiClient, PrimitiveApiClientOptions, PrimitiveApiError, PrimitiveApiErrorDetails, PrimitiveClient, PrimitiveClientOptions, Client as PrimitiveGeneratedApiClient, ClientOptions$1 as PrimitiveGeneratedApiClientOptions, Config as PrimitiveGeneratedApiConfig, Options$1 as PrimitiveGeneratedApiOptions, RequestOptions as PrimitiveGeneratedApiRequestOptions, RequestResult as PrimitiveGeneratedApiRequestResult, ReplayDeliveryData, ReplayDeliveryError, ReplayDeliveryErrors, ReplayDeliveryResponse, ReplayDeliveryResponses, ReplayEmailWebhooksData, ReplayEmailWebhooksError, ReplayEmailWebhooksErrors, ReplayEmailWebhooksResponse, ReplayEmailWebhooksResponses, ReplayResult, ReplyInput, ReplyToEmailData, ReplyToEmailError, ReplyToEmailErrors, ReplyToEmailResponse, ReplyToEmailResponses, RequestOptions$1 as RequestOptions, ResourceId, ResponseStyle, RotateWebhookSecretData, RotateWebhookSecretError, RotateWebhookSecretErrors, RotateWebhookSecretResponse, RotateWebhookSecretResponses, SendEmailData, SendEmailError, SendEmailErrors, SendEmailResponse, SendEmailResponses, SendInput, SendMailInput, SendMailResult, SendPermissionAddress, SendPermissionAnyRecipient, SendPermissionManagedZone, SendPermissionRule, SendPermissionYourDomain, SendPermissionsMeta, SendResult, SendThreadInput, SentEmailDetail, SentEmailStatus, SentEmailSummary, StartCliLoginData, StartCliLoginError, StartCliLoginErrors, StartCliLoginInput, StartCliLoginResponse, StartCliLoginResponses, StorageStats, SuccessEnvelope, TestEndpointData, TestEndpointError, TestEndpointErrors, TestEndpointResponse, TestEndpointResponses, TestResult, UnverifiedDomain, UpdateAccountData, UpdateAccountError, UpdateAccountErrors, UpdateAccountInput, UpdateAccountResponse, UpdateAccountResponses, UpdateDomainData, UpdateDomainError, UpdateDomainErrors, UpdateDomainInput, UpdateDomainResponse, UpdateDomainResponses, UpdateEndpointData, UpdateEndpointError, UpdateEndpointErrors, UpdateEndpointInput, UpdateEndpointResponse, UpdateEndpointResponses, UpdateFilterData, UpdateFilterError, UpdateFilterErrors, UpdateFilterInput, UpdateFilterResponse, UpdateFilterResponses, VerifiedDomain, VerifyDomainData, VerifyDomainError, VerifyDomainErrors, VerifyDomainResponse, VerifyDomainResponses, WebhookSecret, addDomain, cliLogout, client, createEndpoint, createFilter, createPrimitiveApiClient, createPrimitiveClient, deleteDomain, deleteEmail, deleteEndpoint, deleteFilter, discardEmailContent, downloadAttachments, downloadRawEmail, getAccount, getEmail, getSendPermissions, getSentEmail, getStorageStats, getWebhookSecret, listDeliveries, listDomains, listEmails, listEndpoints, listFilters, listSentEmails, operations, pollCliLogin, replayDelivery, replayEmailWebhooks, replyToEmail, rotateWebhookSecret, sendEmail, startCliLogin, testEndpoint, updateAccount, updateDomain, updateEndpoint, updateFilter, verifyDomain };

package/dist/api/index.js

@@ -140,6 +140,11 @@ export class PrimitiveApiError extends Error {
         this.details = options.details;
     }
 }
+function isAbortLikeError(error) {
+    if (!(error instanceof Error))
+        return false;
+    return error.name === "AbortError" || error.name === "TimeoutError";
+}
 function parseRetryAfterHeader(response) {
     if (!response)
         return undefined;
@@ -166,8 +171,33 @@ export class PrimitiveApiClient {
         return this.client.setConfig(config);
     }
 }
+function resolveRequestOptions(options) {
+    const signals = [];
+    if (options?.signal)
+        signals.push(options.signal);
+    if (options?.timeout !== undefined) {
+        signals.push(AbortSignal.timeout(options.timeout));
+    }
+    const signal = signals.length === 0
+        ? undefined
+        : signals.length === 1
+            ? signals[0]
+            : AbortSignal.any(signals);
+    const headers = {
+        ...(options?.headers ?? {}),
+        ...(options?.idempotencyKey
+            ? { "Idempotency-Key": options.idempotencyKey }
+            : {}),
+    };
+    const resolved = {};
+    if (signal)
+        resolved.signal = signal;
+    if (Object.keys(headers).length > 0)
+        resolved.headers = headers;
+    return resolved;
+}
 export class PrimitiveClient extends PrimitiveApiClient {
-    async send(input) {
+    async send(input, options) {
         validateSendInput(input);
         const body = {
             from: input.from,
@@ -188,9 +218,7 @@ export class PrimitiveClient extends PrimitiveApiClient {
         };
         const result = await generatedOperations.sendEmail({
             body,
-            ...(input.idempotencyKey
-                ? { headers: { "Idempotency-Key": input.idempotencyKey } }
-                : {}),
+            ...resolveRequestOptions(options),
             client: this.client,
             responseStyle: "fields",
         });
@@ -210,7 +238,7 @@ export class PrimitiveClient extends PrimitiveApiClient {
      * subject match to thread, so a custom subject silently breaks the
      * thread for half the recipient population.
      */
-    async reply(email, input) {
+    async reply(email, input, options) {
         const resolved = typeof input === "string" ? { text: input } : input;
         // Reject the subject override at runtime so a JS caller (no TS
         // types) gets the same loud error as a TS caller. Without this,
@@ -234,19 +262,20 @@ export class PrimitiveClient extends PrimitiveApiClient {
         const result = await generatedOperations.replyToEmail({
             body,
             path: { id: email.id },
+            ...resolveRequestOptions(options),
             client: this.client,
             responseStyle: "fields",
         });
         return unwrapSendResult(result);
     }
-    async forward(email, input) {
+    async forward(email, input, options) {
         validateForwardInput(input);
         return this.send({
             from: input.from ?? email.receivedBy,
             to: input.to,
             subject: input.subject ?? email.forwardSubject,
             bodyText: buildForwardText(email, input.bodyText),
-        });
+        }, options);
     }
 }
 function buildForwardText(email, intro) {
@@ -276,6 +305,9 @@ function buildForwardText(email, intro) {
 function unwrapSendResult(result) {
     const response = result.response;
     if (result.error) {
+        if (isAbortLikeError(result.error)) {
+            throw result.error;
+        }
         const parsed = parseApiErrorPayload(result.error);
         throw new PrimitiveApiError(parsed.message, {
             payload: result.error,