samva 0.12.0 → 0.14.0

package/dist/{promises-BzrwhHEW.js → promises-BFRKhpSS.js}

@@ -1,5 +1,5 @@
-import { n as clientAttribution, t as CLIENT_ATTRIBUTION_HEADER } from "./client-attribution-BTWYSXxo.js";
-import { t as MailboxEventStream } from "./mailbox-events-CsbF35vH.js";
+import { a as withUploadedAttachments, n as mediaCreateBody, o as CLIENT_ATTRIBUTION_HEADER, r as planInlineUploads, s as clientAttribution, t as MediaUploadError } from "./inline-attachments-BrNnSMF2.js";
+import { t as MailboxEventStream } from "./mailbox-events-VKR4f3qq.js";
 import { n as buildMessagesSendPayload, r as replyToEmailsPayload, t as buildEmailSendPayload } from "./normalize-B79uJIeb.js";
 //#region src/client/core/bodySerializer.gen.ts
 const jsonBodySerializer = { bodySerializer: (body) => JSON.stringify(body, (_key, value) => typeof value === "bigint" ? value.toString() : value) };
@@ -3376,7 +3376,7 @@ var Media = class {
 	/**
 	* Create a media object
 	*
-	* Creates the media object in the pending state and returns it with the upload instruction — URL, method, and headers — for putting its bytes into storage.
+	* Creates the media object in the pending state and returns it with the upload instruction — URL, method, and headers — for putting its bytes into storage. Requires `messages:create`, or `email:send` for `attachment` media.
 	*/
 	static create(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [
@@ -3419,7 +3419,7 @@ var Media = class {
 	/**
 	* Complete a media upload
 	*
-	* Verifies the uploaded object exists in storage, marks the media object ready, and returns it with a download URL.
+	* Verifies the uploaded object exists in storage, marks the media object ready, and returns it with a download URL. Requires the permission that creating the media object did.
 	*/
 	static complete(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [{
@@ -4098,7 +4098,7 @@ var Contacts = class {
 	/**
 	* List contacts
 	*
-	* Returns contact summaries for the organization, newest first, filterable by search term, status, and creation time (`after`, `before`). Pass `nextCursor` back as `cursor` for the next page; it is null on the last page. Read a contact's identities, profile, and metadata with `GET /v1/contacts/{id}`.
+	* Returns contact summaries for the organization, newest first, filterable by search term, status, and creation time (`after`, `before`). `fields` is a comma-separated list of defined custom field keys to return in each summary's `customFields`; omitted keys and unselected fields are not returned. Filter by one defined custom field with `customField` and a JSON-encoded scalar `customFieldValue` (for example, `"creator"`, `42`, or `true`). Both filter parameters are required together, and unknown keys or values of the wrong type are rejected. Pass `nextCursor` back as `cursor` for the next page; it is null on the last page. Read full identities, profile, and metadata with `GET /v1/contacts/{id}`.
 	*/
 	static list(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [
@@ -4118,6 +4118,18 @@ var Contacts = class {
 				in: "query",
 				key: "status"
 			},
+			{
+				in: "query",
+				key: "fields"
+			},
+			{
+				in: "query",
+				key: "customField"
+			},
+			{
+				in: "query",
+				key: "customFieldValue"
+			},
 			{
 				in: "query",
 				key: "after"
@@ -4242,31 +4254,16 @@ var Contacts = class {
 	/**
 	* Find or create a contact
 	*
-	* Returns an existing contact matching the given identifiers, or creates a new one when none exists.
+	* Looks up exactly one identifier through `lookup: { type, value }`. Returns `{ contact, created: false }` unchanged when it exists. Otherwise creates the lookup identity (or external ID), applies `create` attributes, and returns `{ contact, created: true }`. Additional addresses belong in `create.identities`, custom fields in `create.profile.customFields`; custom field keys must be defined and values must match their types. An external ID lookup cannot be contradicted by `create.externalId`. Creation returns HTTP 409 ConflictError if an externalId or address belongs to another contact; the conflicting field is named and no contact is created. Use the update endpoint to change an existing contact.
 	*/
 	static findOrCreate(parameters, options) {
-		const params = buildClientParams([parameters], [{ args: [
-			{
-				in: "body",
-				key: "email"
-			},
-			{
-				in: "body",
-				key: "phone"
-			},
-			{
-				in: "body",
-				key: "externalId"
-			},
-			{
-				in: "body",
-				key: "name"
-			},
-			{
-				in: "body",
-				key: "displayName"
-			}
-		] }]);
+		const params = buildClientParams([parameters], [{ args: [{
+			in: "body",
+			key: "lookup"
+		}, {
+			in: "body",
+			key: "create"
+		}] }]);
 		return (options?.client ?? client).post({
 			security: [{
 				name: "x-api-key",
@@ -4526,7 +4523,7 @@ var Contacts = class {
 	/**
 	* Bulk import contacts
 	*
-	* Creates or updates contacts in bulk from a list, returning per-entry results with created, updated, skipped, and error counts.
+	* Creates contacts in bulk from a list of entries shaped like a create request, returning per-entry results with created, updated, skipped, and error counts. An entry whose identities match an existing contact is skipped, or updates it with `onConflict: "update"`.
 	*/
 	static bulkImport(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [{
@@ -4534,7 +4531,7 @@ var Contacts = class {
 			key: "contacts"
 		}, {
 			in: "body",
-			key: "upsertByEmail"
+			key: "onConflict"
 		}] }]);
 		return (options?.client ?? client).post({
 			security: [{
@@ -4743,6 +4740,59 @@ var Contacts = class {
 		});
 	}
 };
+var Subscriptions = class {
+	/**
+	* Request subscription confirmation
+	*
+	* Sends a confirmation email from your sender. Only the recipient's explicit confirmation adds them to the active static contact group and clears the optional unsubscribe group. The link expires after seven days and can be used once. A custom published email template receives confirmUrl. Sending follows ordinary sender, admission, billing, and brand-footer settings. Requires email send authority in addition to the declared contact grants, including the optional unsubscribe preference change.
+	*/
+	static subscribe(parameters, options) {
+		const params = buildClientParams([parameters], [{ args: [
+			{
+				in: "body",
+				key: "email"
+			},
+			{
+				in: "body",
+				key: "contactGroupId"
+			},
+			{
+				in: "body",
+				key: "from"
+			},
+			{
+				in: "body",
+				key: "unsubscribeGroupId"
+			},
+			{
+				in: "body",
+				key: "templateSlug"
+			},
+			{
+				in: "body",
+				key: "consentIp"
+			},
+			{
+				in: "body",
+				key: "consentSource"
+			}
+		] }]);
+		return (options?.client ?? client).post({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/subscriptions",
+			...options,
+			...params,
+			headers: {
+				"Content-Type": "application/json",
+				...options?.headers,
+				...params.headers
+			}
+		});
+	}
+};
 var ContactGroups = class {
 	/**
 	* List contact groups
@@ -6454,6 +6504,49 @@ var Templates = class {
 		});
 	}
 	/**
+	* Render a template publication
+	*
+	* Renders one immutable publication against the `data` you pass, formatted in the `locale` and `timeZone` you name as a send formats them, and returns the subject, preheader, HTML and plain text a send would produce. `data` is validated against the publication's input schema exactly as a send validates it; invalid input returns a validation error that names each failing field. Nothing is sent or stored. Unpublished workspace edits are never rendered: only a publication id renders.
+	*/
+	static renderPublication(parameters, options) {
+		const params = buildClientParams([parameters], [{ args: [
+			{
+				in: "path",
+				key: "id"
+			},
+			{
+				in: "path",
+				key: "publicationId"
+			},
+			{
+				in: "body",
+				key: "data"
+			},
+			{
+				in: "body",
+				key: "locale"
+			},
+			{
+				in: "body",
+				key: "timeZone"
+			}
+		] }]);
+		return (options?.client ?? client).post({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/templates/{id}/publications/{publicationId}/render",
+			...options,
+			...params,
+			headers: {
+				"Content-Type": "application/json",
+				...options?.headers,
+				...params.headers
+			}
+		});
+	}
+	/**
 	* List a template's input contracts
 	*
 	* Returns the immutable input contracts this template has published under, newest version first. Pass `nextCursor` back as `cursor` for the next page; it is null on the last page. Send against a contract to follow later publications that validate input identically.
@@ -6842,7 +6935,7 @@ var Webhooks = class {
 	/**
 	* Create a webhook
 	*
-	* Creates a signed webhook endpoint for Samva delivery and inbound events, stores subscriptions, and returns the endpoint and signing secret with a 201 response.
+	* Creates a signed webhook endpoint for Samva delivery and inbound events, stores subscriptions, and returns the endpoint and signing secret with a 201 response. `mailboxIds` and `namespaceId` confine mailbox events; when both are set, every mailbox must belong to the namespace.
 	*/
 	static create(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [
@@ -6937,7 +7030,7 @@ var Webhooks = class {
 	/**
 	* Update a webhook
 	*
-	* Updates a webhook's name, URL, subscribed events, channels, custom headers, or status and returns the updated endpoint.
+	* Updates a webhook's name, URL, subscribed events, channels, custom headers, mailbox scope, or status and returns the updated endpoint. A change to `mailboxIds` or `namespaceId` is checked as the endpoint will stand afterward: every mailbox must belong to the namespace when both are set.
 	*/
 	static update(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [
@@ -7237,6 +7330,21 @@ var Organizations = class {
 		});
 	}
 	/**
+	* Get organization trust tier and sending limits
+	*
+	* Returns the current trust tier, plan and probation sending limits, and measured probation graduation progress. Limits are additional to billing allowance, domain readiness, and enforcement. Graduation is evaluated on delivery events.
+	*/
+	static getTrustTier(options) {
+		return (options?.client ?? client).get({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/organizations/trust-tier",
+			...options
+		});
+	}
+	/**
 	* Get organization usage
 	*
 	* Returns usage statistics for the current organization between `after` and `before`, which default to the current calendar month so far. `usage.periodStart` and `usage.periodEnd` echo the window counted.
@@ -8649,7 +8757,7 @@ var Mailboxes = class {
 	/**
 	* Send a new message
 	*
-	* Starts a new conversation from the mailbox's default From address. `status` is `sent`, or `pending_approval` when the caller's grant or a mailbox policy holds sends for a person's approval; a policy that denies sends refuses it with 403.
+	* Records a send action and returns 202 with its current receipt and a Location for action status. An installation, grant, or policy may require approval; otherwise the send is queued. Observe the same action through acceptance and mailbox completion. A policy refusal returns 403 with the recorded receipt.
 	*/
 	static sendMessage(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [
@@ -8786,6 +8894,36 @@ var Mailboxes = class {
 		});
 	}
 	/**
+	* Copy a message attachment
+	*
+	* Copies one of a received message's attachments into the organization's media and returns it as a draft attachment (`mediaId`), so a draft can carry it. A draft that forwards a message saves each original attachment this way.
+	*/
+	static copyMessageAttachment(parameters, options) {
+		const params = buildClientParams([parameters], [{ args: [
+			{
+				in: "path",
+				key: "id"
+			},
+			{
+				in: "path",
+				key: "messageId"
+			},
+			{
+				in: "path",
+				key: "attachmentId"
+			}
+		] }]);
+		return (options?.client ?? client).post({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/mailboxes/{id}/messages/{messageId}/attachments/{attachmentId}/copy",
+			...options,
+			...params
+		});
+	}
+	/**
 	* Reply to a message
 	*
 	* Replies to the message's Reply-To address, or its sender, in the same thread. The server sets the recipients, subject, and threading headers.
@@ -9277,7 +9415,7 @@ var Mailboxes = class {
 	/**
 	* List mailbox actions
 	*
-	* Returns the actions proposed on a mailbox, newest first, filterable by `state` (`approvalRequired` lists the sends waiting for a person) and creation time (`after`, `before`). Pass `nextCursor` back as `cursor` for the next page; it is null on the last page.
+	* Returns the actions proposed on a mailbox, newest first, filterable by `threadId`, `state` (`approvalRequired` lists the sends waiting for a person), and creation time (`after`, `before`). Filters apply together within the mailbox. Pass `nextCursor` back as `cursor` for the next page; it is null on the last page.
 	*/
 	static listActions(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [
@@ -9293,6 +9431,10 @@ var Mailboxes = class {
 				in: "query",
 				key: "cursor"
 			},
+			{
+				in: "query",
+				key: "threadId"
+			},
 			{
 				in: "query",
 				key: "state"
@@ -9317,9 +9459,78 @@ var Mailboxes = class {
 		});
 	}
 	/**
+	* Get a mailbox action
+	*
+	* Returns one action with its current progress. Send actions expose their immutable approved content, deadline, problem, and accepted receipt. A caller with mailbox read access may inspect actions; send-only callers may inspect only their own proposals. Acceptance and mailbox completion do not mean recipient delivery.
+	*/
+	static getAction(parameters, options) {
+		const params = buildClientParams([parameters], [{ args: [{
+			in: "path",
+			key: "id"
+		}, {
+			in: "path",
+			key: "actionId"
+		}] }]);
+		return (options?.client ?? client).get({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/mailboxes/{id}/actions/{actionId}",
+			...options,
+			...params
+		});
+	}
+	/**
+	* Cancel a mailbox send
+	*
+	* Cancels a definitely unsent action and reopens its draft atomically. Only an authorized person who proposed the send or can approve actions may cancel. Accepted sends return 409 with their winning receipt and cannot be withdrawn. An uncertain send requires reconciliation and cannot be cancelled as unsent.
+	*/
+	static cancelAction(parameters, options) {
+		const params = buildClientParams([parameters], [{ args: [{
+			in: "path",
+			key: "id"
+		}, {
+			in: "path",
+			key: "actionId"
+		}] }]);
+		return (options?.client ?? client).post({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/mailboxes/{id}/actions/{actionId}/cancel",
+			...options,
+			...params
+		});
+	}
+	/**
+	* Resume a mailbox send
+	*
+	* Resumes the same action only after its previous execution is confirmed ended and safe continuation is possible. Only an authorized person who proposed the send or can approve actions may retry. Automatic waits need no manual Retry. This does not grant new approval, reset the original deadline, replace the message identity, or resubmit an accepted or uncertain send.
+	*/
+	static retryAction(parameters, options) {
+		const params = buildClientParams([parameters], [{ args: [{
+			in: "path",
+			key: "id"
+		}, {
+			in: "path",
+			key: "actionId"
+		}] }]);
+		return (options?.client ?? client).post({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/mailboxes/{id}/actions/{actionId}/retry",
+			...options,
+			...params
+		});
+	}
+	/**
 	* Approve a mailbox action
 	*
-	* Approves an action waiting for approval, executes it, and returns the executed action. Only a person signed in or through OAuth may approve, and never the one who proposed it.
+	* Records approval of a send and returns 202 while it is pending. A send is queued for automatic retry within 15 minutes of approval; repeating approval does not extend this deadline. Accepted, completed, and notSent replays return 200. No expiry applies before approval. Only a person signed in or through OAuth may approve, and never the proposer. Non-send approvals execute synchronously and return 200 with their own execution states.
 	*/
 	static approveAction(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [{
@@ -9377,7 +9588,7 @@ var Mailboxes = class {
 	/**
 	* List mailbox events
 	*
-	* Returns what happened on a mailbox, newest first, filterable by when it happened (`after`, `before`). Pass `nextCursor` back as `cursor` for the next page; it is null on the last page.
+	* Returns mailbox audit records, newest first, filterable by when they happened (`after`, `before`). Audit event types: `mailbox.created`, `address.attached`, `email.received`, `email.released`, `email.sent`, `thread.created`, `action.proposed`, `action.policy_decided`, `action.approval_requested`, `action.approval_resolved`, `action.accepted`, `action.executed`, `action.failed`. Thread and draft changes have no dedicated audit event types. Pass `nextCursor` back as `cursor` for the next page; it is null on the last page.
 	*/
 	static listEvents(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [
@@ -9479,7 +9690,7 @@ var Namespaces = class {
 	/**
 	* Delete a namespace
 	*
-	* Deletes an empty namespace. A namespace that still holds mailboxes or API keys conflicts: remove or move them first.
+	* Deletes an empty namespace. A namespace that still holds mailboxes, API keys, or webhook endpoints conflicts: remove them first.
 	*/
 	static remove(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [{
@@ -9816,6 +10027,45 @@ var ExtensionInstallations = class {
 		});
 	}
 	/**
+	* Upgrade or roll back an installation
+	*
+	* Changes the pinned version in place. Omit version for the latest publication, or name a version string or id, including an older version to roll back. Preview with dryRun; changing requires acceptPermissions to list exactly the added permission: and event: grants. Only a person can upgrade. Credentials, owner, scope, send mode, and status stay attached to the installation.
+	*/
+	static upgrade(parameters, options) {
+		const params = buildClientParams([parameters], [{ args: [
+			{
+				in: "path",
+				key: "id"
+			},
+			{
+				in: "body",
+				key: "version"
+			},
+			{
+				in: "body",
+				key: "acceptPermissions"
+			},
+			{
+				in: "body",
+				key: "dryRun"
+			}
+		] }]);
+		return (options?.client ?? client).post({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/extension-installations/{id}/upgrade",
+			...options,
+			...params,
+			headers: {
+				"Content-Type": "application/json",
+				...options?.headers,
+				...params.headers
+			}
+		});
+	}
+	/**
 	* Disable an installation
 	*
 	* Stops the installation at once: its events stop, and its credential is refused on every surface until it is enabled again.
@@ -10019,6 +10269,20 @@ var InternalError = class extends SamvaApiError {
 		Object.assign(this, payload);
 	}
 };
+var MailboxSendConflictError = class extends SamvaApiError {
+	_tag = "MailboxSendConflictError";
+	constructor(payload, context = {}) {
+		super(messageOf("MailboxSendConflictError", payload), context);
+		Object.assign(this, payload);
+	}
+};
+var MailboxSendRefusedError = class extends SamvaApiError {
+	_tag = "MailboxSendRefusedError";
+	constructor(payload, context = {}) {
+		super(messageOf("MailboxSendRefusedError", payload), context);
+		Object.assign(this, payload);
+	}
+};
 var OnboardingReviewRequiredError = class extends SamvaApiError {
 	_tag = "OnboardingReviewRequiredError";
 	constructor(payload, context = {}) {
@@ -10047,6 +10311,13 @@ var ResourceNotFoundError = class extends SamvaApiError {
 		Object.assign(this, payload);
 	}
 };
+var SenderNotReadyError = class extends SamvaApiError {
+	_tag = "SenderNotReadyError";
+	constructor(payload, context = {}) {
+		super(messageOf("SenderNotReadyError", payload), context);
+		Object.assign(this, payload);
+	}
+};
 var UnauthorizedError = class extends SamvaApiError {
 	_tag = "UnauthorizedError";
 	constructor(payload, context = {}) {
@@ -10074,10 +10345,13 @@ const constructors = {
 	ForbiddenError,
 	GatewayTimeoutError,
 	InternalError,
+	MailboxSendConflictError,
+	MailboxSendRefusedError,
 	OnboardingReviewRequiredError,
 	PaymentRequiredError,
 	RateLimitedError,
 	ResourceNotFoundError,
+	SenderNotReadyError,
 	UnauthorizedError,
 	ValidationError
 };
@@ -10281,6 +10555,680 @@ const payloadSchemas = {
 		"x-category": ["transient"],
 		"x-retryable": true
 	},
+	MailboxSendConflictError: {
+		type: "object",
+		properties: {
+			_tag: {
+				type: "string",
+				enum: ["MailboxSendConflictError"]
+			},
+			message: { type: "string" },
+			resource: { type: "string" },
+			id: {
+				type: "string",
+				pattern: "^mbxact_[0-9a-hjkmnp-tv-z]{16,24}$",
+				"x-samva-brand": "MailboxActionId"
+			},
+			receipt: {
+				type: "object",
+				properties: {
+					actionId: {
+						type: "string",
+						pattern: "^mbxact_[0-9a-hjkmnp-tv-z]{16,24}$",
+						"x-samva-brand": "MailboxActionId"
+					},
+					draftId: { anyOf: [{
+						type: "string",
+						pattern: "^mdraft_[0-9a-hjkmnp-tv-z]{16,24}$",
+						"x-samva-brand": "MailboxDraftId"
+					}, { type: "null" }] },
+					messageId: { anyOf: [{
+						type: "string",
+						pattern: "^msg_[0-9a-hjkmnp-tv-z]{16,24}$",
+						"x-samva-brand": "MessageId"
+					}, { type: "null" }] },
+					threadId: { anyOf: [{
+						type: "string",
+						pattern: "^thread_[0-9a-hjkmnp-tv-z]{16,24}$",
+						"x-samva-brand": "MailboxThreadId"
+					}, { type: "null" }] },
+					state: {
+						type: "string",
+						enum: [
+							"approvalRequired",
+							"queued",
+							"accepted",
+							"completed",
+							"notSent",
+							"uncertain"
+						]
+					},
+					acceptedAt: { anyOf: [{ type: "string" }, { type: "null" }] },
+					waitReason: { anyOf: [{
+						type: "string",
+						enum: [
+							"rate",
+							"daily-quota",
+							"domain-health",
+							"sending-paused",
+							"upstream-unavailable",
+							"retry",
+							"campaign-paused",
+							"domain-warming",
+							"onboarding-review",
+							"content-review",
+							"screening-unavailable"
+						]
+					}, { type: "null" }] },
+					reviewExpectedAt: { anyOf: [{ type: "string" }, { type: "null" }] },
+					skippedRecipients: {
+						type: "array",
+						items: {
+							type: "object",
+							properties: {
+								address: { type: "string" },
+								reason: {
+									type: "string",
+									enum: [
+										"bounce",
+										"complaint",
+										"unsubscribe",
+										"manual",
+										"group-unsubscribe"
+									]
+								},
+								unsubscribeGroupId: { anyOf: [{
+									type: "string",
+									pattern: "^unsub_[0-9a-hjkmnp-tv-z]{16,24}$",
+									"x-samva-brand": "UnsubscribeId"
+								}, { type: "null" }] }
+							},
+							required: ["address", "reason"],
+							additionalProperties: false
+						}
+					},
+					executeUntil: { anyOf: [{ type: "string" }, { type: "null" }] },
+					retryAt: { anyOf: [{ type: "string" }, { type: "null" }] },
+					problem: { anyOf: [{
+						type: "object",
+						properties: {
+							code: { type: "string" },
+							message: { type: "string" },
+							error: { anyOf: [{ anyOf: [
+								{
+									type: "object",
+									properties: {
+										_tag: {
+											type: "string",
+											enum: ["SenderNotReadyError"]
+										},
+										message: { type: "string" },
+										sender: { type: "string" },
+										retryAfterSeconds: { anyOf: [{ type: "number" }, { type: "null" }] }
+									},
+									required: [
+										"_tag",
+										"message",
+										"sender"
+									],
+									additionalProperties: false
+								},
+								{
+									type: "object",
+									properties: {
+										_tag: {
+											type: "string",
+											enum: ["RateLimitedError"]
+										},
+										message: { type: "string" },
+										retryAfterSeconds: { type: "number" }
+									},
+									required: [
+										"_tag",
+										"message",
+										"retryAfterSeconds"
+									],
+									additionalProperties: false
+								},
+								{
+									type: "object",
+									properties: {
+										_tag: {
+											type: "string",
+											enum: ["OnboardingReviewRequiredError"]
+										},
+										message: { type: "string" },
+										code: {
+											type: "string",
+											enum: [
+												"review_required",
+												"review_in_progress",
+												"information_required",
+												"review_rejected",
+												"identity_review_required",
+												"identity_review_rejected",
+												"identity_changed"
+											]
+										},
+										decision: {
+											type: "string",
+											enum: [
+												"undecided",
+												"approved",
+												"rejected"
+											]
+										},
+										stage: {
+											type: "string",
+											enum: [
+												"collecting",
+												"automated_review",
+												"manual_review",
+												"information_requested",
+												"complete"
+											]
+										},
+										nextAction: {
+											type: "string",
+											enum: [
+												"wait_for_review",
+												"provide_information",
+												"verify_sending_identity",
+												"reapply",
+												"contact_support"
+											]
+										},
+										identityId: { anyOf: [{ type: "string" }, { type: "null" }] }
+									},
+									required: [
+										"_tag",
+										"message",
+										"code",
+										"decision",
+										"stage",
+										"nextAction"
+									],
+									additionalProperties: false
+								},
+								{
+									type: "object",
+									properties: {
+										_tag: {
+											type: "string",
+											enum: ["PaymentRequiredError"]
+										},
+										message: { type: "string" },
+										resource: { type: "string" },
+										currentUsage: { type: "number" },
+										limit: { type: "number" }
+									},
+									required: [
+										"_tag",
+										"message",
+										"resource",
+										"currentUsage",
+										"limit"
+									],
+									additionalProperties: false
+								},
+								{
+									type: "object",
+									properties: {
+										_tag: {
+											type: "string",
+											enum: ["ValidationError"]
+										},
+										message: { type: "string" },
+										fields: { anyOf: [{
+											type: "object",
+											additionalProperties: {
+												type: "array",
+												items: { type: "string" }
+											}
+										}, { type: "null" }] }
+									},
+									required: ["_tag", "message"],
+									additionalProperties: false
+								},
+								{
+									type: "object",
+									properties: {
+										_tag: {
+											type: "string",
+											enum: ["ForbiddenError"]
+										},
+										message: { type: "string" }
+									},
+									required: ["_tag", "message"],
+									additionalProperties: false
+								},
+								{
+									type: "object",
+									properties: {
+										_tag: {
+											type: "string",
+											enum: ["ResourceNotFoundError"]
+										},
+										resource: { type: "string" },
+										id: { type: "string" },
+										message: { type: "string" }
+									},
+									required: [
+										"_tag",
+										"resource",
+										"id",
+										"message"
+									],
+									additionalProperties: false
+								}
+							] }, { type: "null" }] }
+						},
+						required: ["code", "message"],
+						additionalProperties: false
+					}, { type: "null" }] },
+					retryEligible: { type: "boolean" },
+					decision: { anyOf: [{
+						type: "object",
+						properties: {
+							outcome: {
+								type: "string",
+								enum: [
+									"allow",
+									"requireApproval",
+									"deny"
+								]
+							},
+							reason: { anyOf: [{ type: "string" }, { type: "null" }] },
+							policyId: { anyOf: [{
+								type: "string",
+								pattern: "^mbxpol_[0-9a-hjkmnp-tv-z]{16,24}$",
+								"x-samva-brand": "MailboxPolicyId"
+							}, { type: "null" }] },
+							source: { anyOf: [{
+								type: "string",
+								enum: [
+									"grant",
+									"installation",
+									"policy"
+								]
+							}, { type: "null" }] },
+							decidedAt: { type: "string" }
+						},
+						required: [
+							"outcome",
+							"reason",
+							"policyId",
+							"source",
+							"decidedAt"
+						],
+						additionalProperties: false
+					}, { type: "null" }] },
+					createdAt: { type: "string" },
+					updatedAt: { type: "string" }
+				},
+				required: [
+					"actionId",
+					"draftId",
+					"messageId",
+					"threadId",
+					"state",
+					"acceptedAt",
+					"waitReason",
+					"reviewExpectedAt",
+					"skippedRecipients",
+					"executeUntil",
+					"retryAt",
+					"problem",
+					"retryEligible",
+					"decision",
+					"createdAt",
+					"updatedAt"
+				],
+				additionalProperties: false
+			}
+		},
+		required: [
+			"_tag",
+			"message",
+			"resource",
+			"id",
+			"receipt"
+		],
+		additionalProperties: false
+	},
+	MailboxSendRefusedError: {
+		type: "object",
+		properties: {
+			_tag: {
+				type: "string",
+				enum: ["MailboxSendRefusedError"]
+			},
+			message: { type: "string" },
+			receipt: {
+				type: "object",
+				properties: {
+					actionId: {
+						type: "string",
+						pattern: "^mbxact_[0-9a-hjkmnp-tv-z]{16,24}$",
+						"x-samva-brand": "MailboxActionId"
+					},
+					draftId: { anyOf: [{
+						type: "string",
+						pattern: "^mdraft_[0-9a-hjkmnp-tv-z]{16,24}$",
+						"x-samva-brand": "MailboxDraftId"
+					}, { type: "null" }] },
+					messageId: { anyOf: [{
+						type: "string",
+						pattern: "^msg_[0-9a-hjkmnp-tv-z]{16,24}$",
+						"x-samva-brand": "MessageId"
+					}, { type: "null" }] },
+					threadId: { anyOf: [{
+						type: "string",
+						pattern: "^thread_[0-9a-hjkmnp-tv-z]{16,24}$",
+						"x-samva-brand": "MailboxThreadId"
+					}, { type: "null" }] },
+					state: {
+						type: "string",
+						enum: [
+							"approvalRequired",
+							"queued",
+							"accepted",
+							"completed",
+							"notSent",
+							"uncertain"
+						]
+					},
+					acceptedAt: { anyOf: [{ type: "string" }, { type: "null" }] },
+					waitReason: { anyOf: [{
+						type: "string",
+						enum: [
+							"rate",
+							"daily-quota",
+							"domain-health",
+							"sending-paused",
+							"upstream-unavailable",
+							"retry",
+							"campaign-paused",
+							"domain-warming",
+							"onboarding-review",
+							"content-review",
+							"screening-unavailable"
+						]
+					}, { type: "null" }] },
+					reviewExpectedAt: { anyOf: [{ type: "string" }, { type: "null" }] },
+					skippedRecipients: {
+						type: "array",
+						items: {
+							type: "object",
+							properties: {
+								address: { type: "string" },
+								reason: {
+									type: "string",
+									enum: [
+										"bounce",
+										"complaint",
+										"unsubscribe",
+										"manual",
+										"group-unsubscribe"
+									]
+								},
+								unsubscribeGroupId: { anyOf: [{
+									type: "string",
+									pattern: "^unsub_[0-9a-hjkmnp-tv-z]{16,24}$",
+									"x-samva-brand": "UnsubscribeId"
+								}, { type: "null" }] }
+							},
+							required: ["address", "reason"],
+							additionalProperties: false
+						}
+					},
+					executeUntil: { anyOf: [{ type: "string" }, { type: "null" }] },
+					retryAt: { anyOf: [{ type: "string" }, { type: "null" }] },
+					problem: { anyOf: [{
+						type: "object",
+						properties: {
+							code: { type: "string" },
+							message: { type: "string" },
+							error: { anyOf: [{ anyOf: [
+								{
+									type: "object",
+									properties: {
+										_tag: {
+											type: "string",
+											enum: ["SenderNotReadyError"]
+										},
+										message: { type: "string" },
+										sender: { type: "string" },
+										retryAfterSeconds: { anyOf: [{ type: "number" }, { type: "null" }] }
+									},
+									required: [
+										"_tag",
+										"message",
+										"sender"
+									],
+									additionalProperties: false
+								},
+								{
+									type: "object",
+									properties: {
+										_tag: {
+											type: "string",
+											enum: ["RateLimitedError"]
+										},
+										message: { type: "string" },
+										retryAfterSeconds: { type: "number" }
+									},
+									required: [
+										"_tag",
+										"message",
+										"retryAfterSeconds"
+									],
+									additionalProperties: false
+								},
+								{
+									type: "object",
+									properties: {
+										_tag: {
+											type: "string",
+											enum: ["OnboardingReviewRequiredError"]
+										},
+										message: { type: "string" },
+										code: {
+											type: "string",
+											enum: [
+												"review_required",
+												"review_in_progress",
+												"information_required",
+												"review_rejected",
+												"identity_review_required",
+												"identity_review_rejected",
+												"identity_changed"
+											]
+										},
+										decision: {
+											type: "string",
+											enum: [
+												"undecided",
+												"approved",
+												"rejected"
+											]
+										},
+										stage: {
+											type: "string",
+											enum: [
+												"collecting",
+												"automated_review",
+												"manual_review",
+												"information_requested",
+												"complete"
+											]
+										},
+										nextAction: {
+											type: "string",
+											enum: [
+												"wait_for_review",
+												"provide_information",
+												"verify_sending_identity",
+												"reapply",
+												"contact_support"
+											]
+										},
+										identityId: { anyOf: [{ type: "string" }, { type: "null" }] }
+									},
+									required: [
+										"_tag",
+										"message",
+										"code",
+										"decision",
+										"stage",
+										"nextAction"
+									],
+									additionalProperties: false
+								},
+								{
+									type: "object",
+									properties: {
+										_tag: {
+											type: "string",
+											enum: ["PaymentRequiredError"]
+										},
+										message: { type: "string" },
+										resource: { type: "string" },
+										currentUsage: { type: "number" },
+										limit: { type: "number" }
+									},
+									required: [
+										"_tag",
+										"message",
+										"resource",
+										"currentUsage",
+										"limit"
+									],
+									additionalProperties: false
+								},
+								{
+									type: "object",
+									properties: {
+										_tag: {
+											type: "string",
+											enum: ["ValidationError"]
+										},
+										message: { type: "string" },
+										fields: { anyOf: [{
+											type: "object",
+											additionalProperties: {
+												type: "array",
+												items: { type: "string" }
+											}
+										}, { type: "null" }] }
+									},
+									required: ["_tag", "message"],
+									additionalProperties: false
+								},
+								{
+									type: "object",
+									properties: {
+										_tag: {
+											type: "string",
+											enum: ["ForbiddenError"]
+										},
+										message: { type: "string" }
+									},
+									required: ["_tag", "message"],
+									additionalProperties: false
+								},
+								{
+									type: "object",
+									properties: {
+										_tag: {
+											type: "string",
+											enum: ["ResourceNotFoundError"]
+										},
+										resource: { type: "string" },
+										id: { type: "string" },
+										message: { type: "string" }
+									},
+									required: [
+										"_tag",
+										"resource",
+										"id",
+										"message"
+									],
+									additionalProperties: false
+								}
+							] }, { type: "null" }] }
+						},
+						required: ["code", "message"],
+						additionalProperties: false
+					}, { type: "null" }] },
+					retryEligible: { type: "boolean" },
+					decision: { anyOf: [{
+						type: "object",
+						properties: {
+							outcome: {
+								type: "string",
+								enum: [
+									"allow",
+									"requireApproval",
+									"deny"
+								]
+							},
+							reason: { anyOf: [{ type: "string" }, { type: "null" }] },
+							policyId: { anyOf: [{
+								type: "string",
+								pattern: "^mbxpol_[0-9a-hjkmnp-tv-z]{16,24}$",
+								"x-samva-brand": "MailboxPolicyId"
+							}, { type: "null" }] },
+							source: { anyOf: [{
+								type: "string",
+								enum: [
+									"grant",
+									"installation",
+									"policy"
+								]
+							}, { type: "null" }] },
+							decidedAt: { type: "string" }
+						},
+						required: [
+							"outcome",
+							"reason",
+							"policyId",
+							"source",
+							"decidedAt"
+						],
+						additionalProperties: false
+					}, { type: "null" }] },
+					createdAt: { type: "string" },
+					updatedAt: { type: "string" }
+				},
+				required: [
+					"actionId",
+					"draftId",
+					"messageId",
+					"threadId",
+					"state",
+					"acceptedAt",
+					"waitReason",
+					"reviewExpectedAt",
+					"skippedRecipients",
+					"executeUntil",
+					"retryAt",
+					"problem",
+					"retryEligible",
+					"decision",
+					"createdAt",
+					"updatedAt"
+				],
+				additionalProperties: false
+			}
+		},
+		required: [
+			"_tag",
+			"message",
+			"receipt"
+		],
+		additionalProperties: false
+	},
 	OnboardingReviewRequiredError: {
 		type: "object",
 		properties: {
@@ -10406,6 +11354,26 @@ const payloadSchemas = {
 		"x-category": ["notFound"],
 		"x-retryable": false
 	},
+	SenderNotReadyError: {
+		type: "object",
+		properties: {
+			_tag: {
+				type: "string",
+				enum: ["SenderNotReadyError"]
+			},
+			message: { type: "string" },
+			sender: { type: "string" },
+			retryAfterSeconds: { anyOf: [{ type: "number" }, { type: "null" }] }
+		},
+		required: [
+			"_tag",
+			"message",
+			"sender"
+		],
+		additionalProperties: false,
+		"x-category": ["transient"],
+		"x-retryable": true
+	},
 	UnauthorizedError: {
 		type: "object",
 		properties: {
@@ -10509,9 +11477,9 @@ function fromApiError(error, context = {}) {
 * const samva = createClient({ apiKey: "<samva-api-key>" });
 *
 * try {
-*   const contact = await samva.contacts.findOrCreate({
-*     name: "Ada Lovelace",
-*     email: "ada@example.com",
+*   const { contact } = await samva.contacts.findOrCreate({
+*     create: { name: "Ada Lovelace" },
+*     lookup: { type: "email", value: "ada@example.com" },
 *   });
 *   await samva.email.send({
 *     to: contact,
@@ -10537,6 +11505,56 @@ function resolveIdempotencyKey(options) {
 		requestOptions
 	};
 }
+/**
+* Inline attachment content over the API's request cap travels as media instead: the largest
+* attachments are uploaded (create, put to the presigned URL, complete) and replaced by their
+* `mediaId`. The returned payload is the one request every send attempt reuses, so nothing is
+* uploaded twice.
+*/
+async function uploadOversizedAttachments(clientInstance, payload, requestOptions) {
+	const plan = planInlineUploads(payload);
+	if (plan.length === 0) return payload;
+	const uploaded = /* @__PURE__ */ new Map();
+	const directMedia = createDirectService(createBoundService(Media, clientInstance));
+	for (const upload of plan) {
+		const created = await directMedia.create(mediaCreateBody(upload), requestOptions);
+		await putUpload(clientInstance, upload, created, requestOptions.signal ?? void 0);
+		await directMedia.complete({ id: created.id }, requestOptions);
+		uploaded.set(upload.index, {
+			mediaId: created.id,
+			upload
+		});
+	}
+	return withUploadedAttachments(payload, uploaded);
+}
+/**
+* Send with oversized inline attachments uploaded first. Within the cap this is the send call
+* itself, one request and no extra await, so its result is returned unchanged.
+*/
+function sendWithUploads(clientInstance, payload, requestOptions, send) {
+	if (planInlineUploads(payload).length === 0) return send(payload);
+	return uploadOversizedAttachments(clientInstance, payload, requestOptions).then(send);
+}
+async function putUpload(clientInstance, upload, created, signal) {
+	const fail = (status, cause) => new MediaUploadError({
+		filename: upload.filename,
+		mediaId: created.id,
+		status,
+		cause
+	});
+	let response;
+	try {
+		response = await (clientInstance.getConfig().fetch ?? globalThis.fetch)(new Request(created.upload.url, {
+			method: created.upload.method,
+			headers: created.upload.headers,
+			body: upload.bytes,
+			signal: signal ?? null
+		}));
+	} catch (error) {
+		throw fail(void 0, error);
+	}
+	if (!response.ok) throw fail(response.status);
+}
 function createPromiseMessagesTransport(clientInstance) {
 	const boundMessages = createBoundService(Messages, clientInstance);
 	return {
@@ -10551,13 +11569,13 @@ function createPromiseMessagesTransport(clientInstance) {
 		validateEmail: boundMessages.validateEmail,
 		send: (input, options) => {
 			const { idempotencyKey, requestOptions } = resolveIdempotencyKey(options);
-			return Messages.send({
+			return sendWithUploads(clientInstance, buildMessagesSendPayload(input), requestOptions, (payload) => Messages.send({
 				"idempotency-key": idempotencyKey,
-				emailSendMessagePayload: buildMessagesSendPayload(input)
+				emailSendMessagePayload: payload
 			}, {
 				...requestOptions,
 				client: clientInstance
-			});
+			}));
 		}
 	};
 }
@@ -10578,13 +11596,13 @@ function createPromiseEmailTransport(clientInstance) {
 		},
 		send: (input, options) => {
 			const { idempotencyKey, requestOptions } = resolveIdempotencyKey(options);
-			return Messages.send({
+			return sendWithUploads(clientInstance, buildEmailSendPayload(input), requestOptions, (payload) => Messages.send({
 				"idempotency-key": idempotencyKey,
-				emailSendMessagePayload: buildEmailSendPayload(input)
+				emailSendMessagePayload: payload
 			}, {
 				...requestOptions,
 				client: clientInstance
-			});
+			}));
 		}
 	});
 }
@@ -10618,6 +11636,7 @@ async function unwrap(method, arguments_) {
 	try {
 		result = await method(...arguments_);
 	} catch (error) {
+		if (error instanceof MediaUploadError) throw error;
 		throw fromApiError(error);
 	}
 	if (!isObject(result)) throw new SamvaTransportError(result);
@@ -10670,6 +11689,7 @@ function createClient(config) {
 		attachments: createBoundService(Attachments, clientInstance),
 		contactGroups: createBoundService(ContactGroups, clientInstance),
 		customFields: createBoundService(CustomFields, clientInstance),
+		subscriptions: createBoundService(Subscriptions, clientInstance),
 		unsubscribeGroups: createBoundService(Unsubscribe, clientInstance),
 		analytics: createBoundService(Analytics, clientInstance),
 		feedback: createBoundService(Feedback, clientInstance),
@@ -10680,7 +11700,7 @@ function createClient(config) {
 	};
 	const streamConnection = {
 		baseUrl: config.baseUrl ?? "https://api.samva.dev",
-		headers: Object.fromEntries(mergeHeaders({ [CLIENT_ATTRIBUTION_HEADER]: clientAttribution("typescript-promise") }, config.headers, authHeaders).entries()),
+		headers: async () => Object.fromEntries(mergeHeaders({ [CLIENT_ATTRIBUTION_HEADER]: clientAttribution("typescript-promise") }, config.headers, authHeaders).entries()),
 		fetch: config.fetch
 	};
 	const promiseMessages = createPromiseMessagesTransport(clientInstance);
@@ -10703,6 +11723,7 @@ function createClient(config) {
 		attachments: createDirectService(raw.attachments),
 		contactGroups: createDirectService(raw.contactGroups),
 		customFields: createDirectService(raw.customFields),
+		subscriptions: createDirectService(raw.subscriptions),
 		unsubscribeGroups: createDirectService(raw.unsubscribeGroups),
 		analytics: createDirectService(raw.analytics),
 		feedback: createDirectService(raw.feedback),
@@ -10713,6 +11734,6 @@ function createClient(config) {
 	};
 }
 //#endregion
-export { fromApiError as S, ResourceNotFoundError as _, CampaignFooterRequiredError as a, UnauthorizedError as b, EmailChannelError as c, ForbiddenError as d, GatewayTimeoutError as f, RateLimitedError as g, PaymentRequiredError as h, BrandAddressRequiredError as i, ExternalServiceError as l, OnboardingReviewRequiredError as m, AnalyticsQueryError as n, ConflictError as o, InternalError as p, BillingProviderError as r, DeliveryUnavailableError as s, createClient as t, FlagDisabledError as u, SamvaApiError as v, ValidationError as x, SamvaTransportError as y };
+export { UnauthorizedError as C, SenderNotReadyError as S, fromApiError as T, PaymentRequiredError as _, CampaignFooterRequiredError as a, SamvaApiError as b, EmailChannelError as c, ForbiddenError as d, GatewayTimeoutError as f, OnboardingReviewRequiredError as g, MailboxSendRefusedError as h, BrandAddressRequiredError as i, ExternalServiceError as l, MailboxSendConflictError as m, AnalyticsQueryError as n, ConflictError as o, InternalError as p, BillingProviderError as r, DeliveryUnavailableError as s, createClient as t, FlagDisabledError as u, RateLimitedError as v, ValidationError as w, SamvaTransportError as x, ResourceNotFoundError as y };
 
-//# sourceMappingURL=promises-BzrwhHEW.js.map
+//# sourceMappingURL=promises-BFRKhpSS.js.map