samva 0.12.0 → 0.14.0

package/dist/effect/webhooks.d.ts

@@ -3,13 +3,13 @@ export declare const list: ((input?: {
     readonly limit?: string | null | undefined;
     readonly cursor?: string | null | undefined;
     readonly search?: string | null | undefined;
-    readonly status?: string | null | undefined;
+    readonly status?: "active" | "disabled" | null | undefined;
 } | undefined) => import("effect/Effect").Effect<{
     readonly items: readonly {
         readonly id: string & import("effect/Brand").Brand<"WebhookEndpointId">;
         readonly name: string;
         readonly url: string;
-        readonly eventTypes: readonly ("contact.created" | "contact.deleted" | "contact.resubscribed" | "contact.unsubscribed" | "contact.updated" | "conversation.archived" | "conversation.created" | "conversation.updated" | "domain.updated" | "domain.warming.updated" | "mailbox.action.pending_approval" | "mailbox.message.discarded" | "mailbox.message.quarantined" | "mailbox.message.received" | "mailbox.message.released" | "mailbox.message.sent" | "message.bounced" | "message.clicked" | "message.complained" | "message.delivered" | "message.failed" | "message.opened" | "message.read" | "message.received" | "message.sent" | "webhook.created" | "webhook.deleted" | "webhook.test" | "webhook.updated")[];
+        readonly eventTypes: readonly ("contact.created" | "contact.deleted" | "contact.resubscribed" | "contact.subscribed" | "contact.unsubscribed" | "contact.updated" | "conversation.archived" | "conversation.created" | "conversation.updated" | "domain.updated" | "domain.warming.updated" | "mailbox.action.pending_approval" | "mailbox.message.discarded" | "mailbox.message.quarantined" | "mailbox.message.received" | "mailbox.message.released" | "mailbox.message.sent" | "message.bounced" | "message.clicked" | "message.complained" | "message.delivered" | "message.failed" | "message.opened" | "message.read" | "message.received" | "message.sent" | "webhook.created" | "webhook.deleted" | "webhook.test" | "webhook.updated")[];
         readonly channels: readonly "email"[] | null;
         readonly mailboxIds: readonly (string & import("effect/Brand").Brand<"MailboxId">)[] | null;
         readonly namespaceId: (string & import("effect/Brand").Brand<"NamespaceId">) | null;
@@ -33,13 +33,13 @@ export declare const list: ((input?: {
         readonly limit?: string | null | undefined;
         readonly cursor?: string | null | undefined;
         readonly search?: string | null | undefined;
-        readonly status?: string | null | undefined;
+        readonly status?: "active" | "disabled" | null | undefined;
     } | undefined) => import("effect/Stream").Stream<{
         readonly items: readonly {
             readonly id: string & import("effect/Brand").Brand<"WebhookEndpointId">;
             readonly name: string;
             readonly url: string;
-            readonly eventTypes: readonly ("contact.created" | "contact.deleted" | "contact.resubscribed" | "contact.unsubscribed" | "contact.updated" | "conversation.archived" | "conversation.created" | "conversation.updated" | "domain.updated" | "domain.warming.updated" | "mailbox.action.pending_approval" | "mailbox.message.discarded" | "mailbox.message.quarantined" | "mailbox.message.received" | "mailbox.message.released" | "mailbox.message.sent" | "message.bounced" | "message.clicked" | "message.complained" | "message.delivered" | "message.failed" | "message.opened" | "message.read" | "message.received" | "message.sent" | "webhook.created" | "webhook.deleted" | "webhook.test" | "webhook.updated")[];
+            readonly eventTypes: readonly ("contact.created" | "contact.deleted" | "contact.resubscribed" | "contact.subscribed" | "contact.unsubscribed" | "contact.updated" | "conversation.archived" | "conversation.created" | "conversation.updated" | "domain.updated" | "domain.warming.updated" | "mailbox.action.pending_approval" | "mailbox.message.discarded" | "mailbox.message.quarantined" | "mailbox.message.received" | "mailbox.message.released" | "mailbox.message.sent" | "message.bounced" | "message.clicked" | "message.complained" | "message.delivered" | "message.failed" | "message.opened" | "message.read" | "message.received" | "message.sent" | "webhook.created" | "webhook.deleted" | "webhook.test" | "webhook.updated")[];
             readonly channels: readonly "email"[] | null;
             readonly mailboxIds: readonly (string & import("effect/Brand").Brand<"MailboxId">)[] | null;
             readonly namespaceId: (string & import("effect/Brand").Brand<"NamespaceId">) | null;
@@ -63,12 +63,12 @@ export declare const list: ((input?: {
         readonly limit?: string | null | undefined;
         readonly cursor?: string | null | undefined;
         readonly search?: string | null | undefined;
-        readonly status?: string | null | undefined;
+        readonly status?: "active" | "disabled" | null | undefined;
     } | undefined) => import("effect/Stream").Stream<{
         readonly id: string & import("effect/Brand").Brand<"WebhookEndpointId">;
         readonly name: string;
         readonly url: string;
-        readonly eventTypes: readonly ("contact.created" | "contact.deleted" | "contact.resubscribed" | "contact.unsubscribed" | "contact.updated" | "conversation.archived" | "conversation.created" | "conversation.updated" | "domain.updated" | "domain.warming.updated" | "mailbox.action.pending_approval" | "mailbox.message.discarded" | "mailbox.message.quarantined" | "mailbox.message.received" | "mailbox.message.released" | "mailbox.message.sent" | "message.bounced" | "message.clicked" | "message.complained" | "message.delivered" | "message.failed" | "message.opened" | "message.read" | "message.received" | "message.sent" | "webhook.created" | "webhook.deleted" | "webhook.test" | "webhook.updated")[];
+        readonly eventTypes: readonly ("contact.created" | "contact.deleted" | "contact.resubscribed" | "contact.subscribed" | "contact.unsubscribed" | "contact.updated" | "conversation.archived" | "conversation.created" | "conversation.updated" | "domain.updated" | "domain.warming.updated" | "mailbox.action.pending_approval" | "mailbox.message.discarded" | "mailbox.message.quarantined" | "mailbox.message.received" | "mailbox.message.released" | "mailbox.message.sent" | "message.bounced" | "message.clicked" | "message.complained" | "message.delivered" | "message.failed" | "message.opened" | "message.read" | "message.received" | "message.sent" | "webhook.created" | "webhook.deleted" | "webhook.test" | "webhook.updated")[];
         readonly channels: readonly "email"[] | null;
         readonly mailboxIds: readonly (string & import("effect/Brand").Brand<"MailboxId">)[] | null;
         readonly namespaceId: (string & import("effect/Brand").Brand<"NamespaceId">) | null;
@@ -90,20 +90,20 @@ export declare const list: ((input?: {
 export declare const create: (input: {
     readonly name: string;
     readonly url: string;
-    readonly eventTypes: readonly string[];
-    readonly channels?: readonly string[] | null | undefined;
+    readonly eventTypes: readonly ("contact.created" | "contact.deleted" | "contact.resubscribed" | "contact.subscribed" | "contact.unsubscribed" | "contact.updated" | "conversation.archived" | "conversation.created" | "conversation.updated" | "domain.updated" | "domain.warming.updated" | "mailbox.action.pending_approval" | "mailbox.message.discarded" | "mailbox.message.quarantined" | "mailbox.message.received" | "mailbox.message.released" | "mailbox.message.sent" | "message.bounced" | "message.clicked" | "message.complained" | "message.delivered" | "message.failed" | "message.opened" | "message.read" | "message.received" | "message.sent" | "webhook.created" | "webhook.deleted" | "webhook.test" | "webhook.updated")[];
+    readonly channels?: readonly "email"[] | null | undefined;
     readonly mailboxIds?: readonly string[] | null | undefined;
     readonly namespaceId?: string | null | undefined;
     readonly headers?: {
         readonly [x: string]: string | undefined;
     } | null | undefined;
-    readonly status?: string | null | undefined;
+    readonly status?: "active" | "disabled" | null | undefined;
 }) => import("effect/Effect").Effect<{
     readonly endpoint: {
         readonly id: string & import("effect/Brand").Brand<"WebhookEndpointId">;
         readonly name: string;
         readonly url: string;
-        readonly eventTypes: readonly ("contact.created" | "contact.deleted" | "contact.resubscribed" | "contact.unsubscribed" | "contact.updated" | "conversation.archived" | "conversation.created" | "conversation.updated" | "domain.updated" | "domain.warming.updated" | "mailbox.action.pending_approval" | "mailbox.message.discarded" | "mailbox.message.quarantined" | "mailbox.message.received" | "mailbox.message.released" | "mailbox.message.sent" | "message.bounced" | "message.clicked" | "message.complained" | "message.delivered" | "message.failed" | "message.opened" | "message.read" | "message.received" | "message.sent" | "webhook.created" | "webhook.deleted" | "webhook.test" | "webhook.updated")[];
+        readonly eventTypes: readonly ("contact.created" | "contact.deleted" | "contact.resubscribed" | "contact.subscribed" | "contact.unsubscribed" | "contact.updated" | "conversation.archived" | "conversation.created" | "conversation.updated" | "domain.updated" | "domain.warming.updated" | "mailbox.action.pending_approval" | "mailbox.message.discarded" | "mailbox.message.quarantined" | "mailbox.message.received" | "mailbox.message.released" | "mailbox.message.sent" | "message.bounced" | "message.clicked" | "message.complained" | "message.delivered" | "message.failed" | "message.opened" | "message.read" | "message.received" | "message.sent" | "webhook.created" | "webhook.deleted" | "webhook.test" | "webhook.updated")[];
         readonly channels: readonly "email"[] | null;
         readonly mailboxIds: readonly (string & import("effect/Brand").Brand<"MailboxId">)[] | null;
         readonly namespaceId: (string & import("effect/Brand").Brand<"NamespaceId">) | null;
@@ -122,7 +122,7 @@ export declare const get: (input: {
     readonly id: string & import("effect/Brand").Brand<"WebhookEndpointId">;
     readonly name: string;
     readonly url: string;
-    readonly eventTypes: readonly ("contact.created" | "contact.deleted" | "contact.resubscribed" | "contact.unsubscribed" | "contact.updated" | "conversation.archived" | "conversation.created" | "conversation.updated" | "domain.updated" | "domain.warming.updated" | "mailbox.action.pending_approval" | "mailbox.message.discarded" | "mailbox.message.quarantined" | "mailbox.message.received" | "mailbox.message.released" | "mailbox.message.sent" | "message.bounced" | "message.clicked" | "message.complained" | "message.delivered" | "message.failed" | "message.opened" | "message.read" | "message.received" | "message.sent" | "webhook.created" | "webhook.deleted" | "webhook.test" | "webhook.updated")[];
+    readonly eventTypes: readonly ("contact.created" | "contact.deleted" | "contact.resubscribed" | "contact.subscribed" | "contact.unsubscribed" | "contact.updated" | "conversation.archived" | "conversation.created" | "conversation.updated" | "domain.updated" | "domain.warming.updated" | "mailbox.action.pending_approval" | "mailbox.message.discarded" | "mailbox.message.quarantined" | "mailbox.message.received" | "mailbox.message.released" | "mailbox.message.sent" | "message.bounced" | "message.clicked" | "message.complained" | "message.delivered" | "message.failed" | "message.opened" | "message.read" | "message.received" | "message.sent" | "webhook.created" | "webhook.deleted" | "webhook.test" | "webhook.updated")[];
     readonly channels: readonly "email"[] | null;
     readonly mailboxIds: readonly (string & import("effect/Brand").Brand<"MailboxId">)[] | null;
     readonly namespaceId: (string & import("effect/Brand").Brand<"NamespaceId">) | null;
@@ -142,19 +142,19 @@ export declare const update: (input: {
     readonly id: string;
     readonly name?: string | null | undefined;
     readonly url?: string | null | undefined;
-    readonly eventTypes?: readonly string[] | null | undefined;
-    readonly channels?: readonly string[] | null | undefined;
+    readonly eventTypes?: readonly ("contact.created" | "contact.deleted" | "contact.resubscribed" | "contact.subscribed" | "contact.unsubscribed" | "contact.updated" | "conversation.archived" | "conversation.created" | "conversation.updated" | "domain.updated" | "domain.warming.updated" | "mailbox.action.pending_approval" | "mailbox.message.discarded" | "mailbox.message.quarantined" | "mailbox.message.received" | "mailbox.message.released" | "mailbox.message.sent" | "message.bounced" | "message.clicked" | "message.complained" | "message.delivered" | "message.failed" | "message.opened" | "message.read" | "message.received" | "message.sent" | "webhook.created" | "webhook.deleted" | "webhook.test" | "webhook.updated")[] | null | undefined;
+    readonly channels?: readonly "email"[] | null | undefined;
     readonly mailboxIds?: readonly string[] | null | undefined;
     readonly namespaceId?: string | null | undefined;
     readonly headers?: {
         readonly [x: string]: string | undefined;
     } | null | undefined;
-    readonly status?: string | null | undefined;
+    readonly status?: "active" | "disabled" | null | undefined;
 }) => import("effect/Effect").Effect<{
     readonly id: string & import("effect/Brand").Brand<"WebhookEndpointId">;
     readonly name: string;
     readonly url: string;
-    readonly eventTypes: readonly ("contact.created" | "contact.deleted" | "contact.resubscribed" | "contact.unsubscribed" | "contact.updated" | "conversation.archived" | "conversation.created" | "conversation.updated" | "domain.updated" | "domain.warming.updated" | "mailbox.action.pending_approval" | "mailbox.message.discarded" | "mailbox.message.quarantined" | "mailbox.message.received" | "mailbox.message.released" | "mailbox.message.sent" | "message.bounced" | "message.clicked" | "message.complained" | "message.delivered" | "message.failed" | "message.opened" | "message.read" | "message.received" | "message.sent" | "webhook.created" | "webhook.deleted" | "webhook.test" | "webhook.updated")[];
+    readonly eventTypes: readonly ("contact.created" | "contact.deleted" | "contact.resubscribed" | "contact.subscribed" | "contact.unsubscribed" | "contact.updated" | "conversation.archived" | "conversation.created" | "conversation.updated" | "domain.updated" | "domain.warming.updated" | "mailbox.action.pending_approval" | "mailbox.message.discarded" | "mailbox.message.quarantined" | "mailbox.message.received" | "mailbox.message.released" | "mailbox.message.sent" | "message.bounced" | "message.clicked" | "message.complained" | "message.delivered" | "message.failed" | "message.opened" | "message.read" | "message.received" | "message.sent" | "webhook.created" | "webhook.deleted" | "webhook.test" | "webhook.updated")[];
     readonly channels: readonly "email"[] | null;
     readonly mailboxIds: readonly (string & import("effect/Brand").Brand<"MailboxId">)[] | null;
     readonly namespaceId: (string & import("effect/Brand").Brand<"NamespaceId">) | null;

package/dist/effect/webhooks.js

@@ -1,6 +1,6 @@
 import { t as __exportAll } from "../rolldown-runtime-D7D4PA-g.js";
-import { n as make } from "../operation-BEghYyLu.js";
-import { E as TestWebhookPayload, f as CreateWebhookPayload, j as UpdateWebhookPayload } from "../client-Cj1bqIEe.js";
+import { n as make } from "../operation-g8nAzmIM.js";
+import { P as UpdateWebhookPayload, f as CreateWebhookPayload, k as TestWebhookPayload } from "../client-CZjhOKPM.js";
 //#region src/effect/webhooks.ts
 var webhooks_exports = /* @__PURE__ */ __exportAll({
 	CreatePayload: () => CreateWebhookPayload,

package/dist/index.js

@@ -1,3 +1,4 @@
-import { S as fromApiError, _ as ResourceNotFoundError, a as CampaignFooterRequiredError, b as UnauthorizedError, c as EmailChannelError, d as ForbiddenError, f as GatewayTimeoutError, g as RateLimitedError, h as PaymentRequiredError, i as BrandAddressRequiredError, l as ExternalServiceError, m as OnboardingReviewRequiredError, n as AnalyticsQueryError, o as ConflictError, p as InternalError, r as BillingProviderError, s as DeliveryUnavailableError, t as createClient, u as FlagDisabledError, v as SamvaApiError, x as ValidationError, y as SamvaTransportError } from "./promises-BzrwhHEW.js";
-import { n as MailboxEventStreamError, t as MailboxEventStream } from "./mailbox-events-CsbF35vH.js";
-export { AnalyticsQueryError, BillingProviderError, BrandAddressRequiredError, CampaignFooterRequiredError, ConflictError, DeliveryUnavailableError, EmailChannelError, ExternalServiceError, FlagDisabledError, ForbiddenError, GatewayTimeoutError, InternalError, MailboxEventStream, MailboxEventStreamError, OnboardingReviewRequiredError, PaymentRequiredError, RateLimitedError, ResourceNotFoundError, SamvaApiError, SamvaTransportError, UnauthorizedError, ValidationError, createClient, fromApiError };
+import { t as MediaUploadError } from "./inline-attachments-BrNnSMF2.js";
+import { C as UnauthorizedError, S as SenderNotReadyError, T as fromApiError, _ as PaymentRequiredError, a as CampaignFooterRequiredError, b as SamvaApiError, c as EmailChannelError, d as ForbiddenError, f as GatewayTimeoutError, g as OnboardingReviewRequiredError, h as MailboxSendRefusedError, i as BrandAddressRequiredError, l as ExternalServiceError, m as MailboxSendConflictError, n as AnalyticsQueryError, o as ConflictError, p as InternalError, r as BillingProviderError, s as DeliveryUnavailableError, t as createClient, u as FlagDisabledError, v as RateLimitedError, w as ValidationError, x as SamvaTransportError, y as ResourceNotFoundError } from "./promises-BFRKhpSS.js";
+import { n as MailboxEventStreamError, t as MailboxEventStream } from "./mailbox-events-VKR4f3qq.js";
+export { AnalyticsQueryError, BillingProviderError, BrandAddressRequiredError, CampaignFooterRequiredError, ConflictError, DeliveryUnavailableError, EmailChannelError, ExternalServiceError, FlagDisabledError, ForbiddenError, GatewayTimeoutError, InternalError, MailboxEventStream, MailboxEventStreamError, MailboxSendConflictError, MailboxSendRefusedError, MediaUploadError, OnboardingReviewRequiredError, PaymentRequiredError, RateLimitedError, ResourceNotFoundError, SamvaApiError, SamvaTransportError, SenderNotReadyError, UnauthorizedError, ValidationError, createClient, fromApiError };

package/dist/inline-attachments-BrNnSMF2.js

@@ -0,0 +1,121 @@
+//#endregion
+//#region src/client-attribution.ts
+const SDK_VERSION = "0.14.0";
+const CLIENT_ATTRIBUTION_HEADER = "x-samva-client";
+const clientAttribution = (surface) => `${surface}/${SDK_VERSION}`;
+/** A failed upload of an attachment's bytes to its presigned media URL. */
+var MediaUploadError = class extends Error {
+	_tag = "MediaUploadError";
+	/** The attachment filename the upload was for. */
+	filename;
+	mediaId;
+	/** The storage response status, absent when the request never completed. */
+	status;
+	cause;
+	constructor(input) {
+		super(input.status === void 0 ? `Uploading attachment "${input.filename}" (${input.mediaId}) failed before storage answered` : `Uploading attachment "${input.filename}" (${input.mediaId}) failed with storage status ${input.status}`, { cause: input.cause });
+		this.name = "MediaUploadError";
+		this.filename = input.filename;
+		this.mediaId = input.mediaId;
+		this.status = input.status;
+		this.cause = input.cause;
+	}
+};
+const isRecord = (value) => typeof value === "object" && value !== null;
+const attachmentsOf = (payload) => {
+	const email = payload.email;
+	if (!isRecord(email)) return [];
+	const attachments = email.attachments;
+	return Array.isArray(attachments) ? attachments : [];
+};
+/** Decoded byte length of a Base64 string, without decoding it. */
+const decodedBase64Bytes = (content) => {
+	const length = content.length;
+	if (length === 0) return 0;
+	let padding = 0;
+	if (content.endsWith("==")) padding = 2;
+	else if (content.endsWith("=")) padding = 1;
+	return Math.floor(length * 3 / 4) - padding;
+};
+/** The bytes `content` encodes, or `undefined` when it is not Base64. */
+const base64ToBytes = (content) => {
+	let binary;
+	try {
+		binary = atob(content);
+	} catch {
+		return;
+	}
+	const bytes = new Uint8Array(binary.length);
+	for (let index = 0; index < binary.length; index += 1) bytes[index] = binary.charCodeAt(index);
+	return bytes;
+};
+/**
+* The inline attachments to upload so the rest fit under {@link INLINE_ATTACHMENT_MAX_BYTES}:
+* largest first, stopping as soon as the remaining inline total is within the cap. Empty when the
+* request is already within the cap, carries no inline content, or carries content that is not
+* Base64: nothing is uploaded for a request the API will refuse, and its 422 names the attachment.
+*/
+const planInlineUploads = (payload) => {
+	const inline = [];
+	for (const [index, entry] of attachmentsOf(payload).entries()) {
+		if (!isRecord(entry)) continue;
+		const attachment = entry;
+		if (typeof attachment.content !== "string") continue;
+		if (attachment.mediaId !== void 0) return [];
+		inline.push({
+			index,
+			filename: typeof attachment.filename === "string" ? attachment.filename : "attachment",
+			contentType: typeof attachment.contentType === "string" ? attachment.contentType : "application/octet-stream",
+			content: attachment.content,
+			sizeBytes: typeof attachment.size === "number" ? attachment.size : decodedBase64Bytes(attachment.content)
+		});
+	}
+	let remaining = inline.reduce((total, upload) => total + upload.sizeBytes, 0);
+	if (remaining <= 4194304) return [];
+	const chosen = [];
+	const largestFirst = [...inline].sort((left, right) => right.sizeBytes - left.sizeBytes || left.index - right.index);
+	for (const { content, ...upload } of largestFirst) {
+		if (remaining <= 4194304) break;
+		const bytes = base64ToBytes(content);
+		if (bytes === void 0) return [];
+		chosen.push({
+			...upload,
+			bytes
+		});
+		remaining -= upload.sizeBytes;
+	}
+	return chosen;
+};
+/** The `POST /v1/media` body for an inline attachment. */
+const mediaCreateBody = (upload) => ({
+	filename: upload.filename,
+	contentType: upload.contentType,
+	sizeBytes: upload.sizeBytes,
+	purpose: "attachment"
+});
+/** The `Content-Type` of the presigned request, for clients that set it from the body. */
+const uploadContentType = (headers) => Object.entries(headers).find(([name]) => name.toLowerCase() === "content-type")?.[1];
+/** Replace each uploaded attachment with its `mediaId` form; everything else is untouched. */
+const withUploadedAttachments = (payload, uploaded) => {
+	const email = payload.email;
+	const attachments = email.attachments.map((entry, index) => {
+		const replacement = uploaded.get(index);
+		if (replacement === void 0) return entry;
+		const { content: _content, ...rest } = entry;
+		return {
+			...rest,
+			mediaId: replacement.mediaId
+		};
+	});
+	return {
+		...payload,
+		email: {
+			...email,
+			attachments
+		}
+	};
+};
+//#endregion
+export { withUploadedAttachments as a, uploadContentType as i, mediaCreateBody as n, CLIENT_ATTRIBUTION_HEADER as o, planInlineUploads as r, clientAttribution as s, MediaUploadError as t };
+
+//# sourceMappingURL=inline-attachments-BrNnSMF2.js.map

package/dist/inline-attachments.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Shared, pure planning for email sends whose inline attachments exceed the API's inline cap.
+ *
+ * The API accepts a bounded number of decoded bytes as Base64 `content` per request (larger files
+ * travel as owned media and are referenced by `mediaId`). Both clients call these helpers to decide
+ * which inline attachments to upload through media before the single send request, so the choice
+ * cannot drift between them. No Effect, no I/O.
+ */
+/** Decoded bytes of inline attachment `content` one send request may carry. */
+export declare const INLINE_ATTACHMENT_MAX_BYTES: number;
+/** A failed upload of an attachment's bytes to its presigned media URL. */
+export declare class MediaUploadError extends Error {
+    readonly _tag: "MediaUploadError";
+    /** The attachment filename the upload was for. */
+    readonly filename: string;
+    readonly mediaId: string;
+    /** The storage response status, absent when the request never completed. */
+    readonly status: number | undefined;
+    readonly cause: unknown;
+    constructor(input: {
+        readonly filename: string;
+        readonly mediaId: string;
+        readonly status?: number | undefined;
+        readonly cause?: unknown;
+    });
+}
+/** One inline attachment chosen for upload. */
+export interface InlineUpload {
+    /** Position in `email.attachments`. */
+    readonly index: number;
+    readonly filename: string;
+    readonly contentType: string;
+    /** The decoded `content`, the bytes put to storage. */
+    readonly bytes: Uint8Array;
+    /** The attachment's declared `size`, the bytes the API charges against the inline cap. */
+    readonly sizeBytes: number;
+}
+/** The presigned request `POST /v1/media` returns for putting the bytes into storage. */
+export interface UploadInstruction {
+    readonly url: string;
+    readonly headers: Readonly<Record<string, string>>;
+}
+/** Decoded byte length of a Base64 string, without decoding it. */
+export declare const decodedBase64Bytes: (content: string) => number;
+/**
+ * The inline attachments to upload so the rest fit under {@link INLINE_ATTACHMENT_MAX_BYTES}:
+ * largest first, stopping as soon as the remaining inline total is within the cap. Empty when the
+ * request is already within the cap, carries no inline content, or carries content that is not
+ * Base64: nothing is uploaded for a request the API will refuse, and its 422 names the attachment.
+ */
+export declare const planInlineUploads: (payload: Record<string, unknown>) => ReadonlyArray<InlineUpload>;
+/** The `POST /v1/media` body for an inline attachment. */
+export declare const mediaCreateBody: (upload: InlineUpload) => {
+    filename: string;
+    contentType: string;
+    sizeBytes: number;
+    purpose: "attachment";
+};
+/** The `Content-Type` of the presigned request, for clients that set it from the body. */
+export declare const uploadContentType: (headers: Readonly<Record<string, string>>) => string | undefined;
+/** Replace each uploaded attachment with its `mediaId` form; everything else is untouched. */
+export declare const withUploadedAttachments: (payload: Record<string, unknown>, uploaded: ReadonlyMap<number, {
+    readonly mediaId: string;
+    readonly upload: InlineUpload;
+}>) => Record<string, unknown>;

package/dist/{mailbox-events-CsbF35vH.js → mailbox-events-VKR4f3qq.js}

@@ -441,7 +441,9 @@ var MailboxEventStream = class {
 		});
 	}
 	/** One connection, from upgrade to close. `onLive` runs once replay has caught up. */
-	#connect(onLive) {
+	async #connect(onLive) {
+		const headers = typeof this.#connection.headers === "function" ? await this.#connection.headers() : this.#connection.headers;
+		if (this.#ended) return { kind: "stopped" };
 		return new Promise((resolve) => {
 			const WebSocketImplementation = this.#options.WebSocket ?? globalWebSocket();
 			if (WebSocketImplementation === void 0) {
@@ -481,7 +483,7 @@ var MailboxEventStream = class {
 			const onStop = () => settle({ kind: "stopped" });
 			let socket;
 			try {
-				socket = new WebSocketImplementation(url.toString(), { headers: this.#connection.headers });
+				socket = new WebSocketImplementation(url.toString(), { headers });
 			} catch (cause) {
 				this.#fail(new MailboxEventStreamError({
 					_tag: "StreamClientError",
@@ -568,7 +570,7 @@ var MailboxEventStream = class {
 		const diagnosis = (async () => {
 			try {
 				const response = await (this.#connection.fetch ?? fetch)(url, {
-					headers: this.#connection.headers,
+					headers: typeof this.#connection.headers === "function" ? await this.#connection.headers() : this.#connection.headers,
 					signal: deadline.signal
 				});
 				if (response.status === 426) {
@@ -626,4 +628,4 @@ const readRefusalBody = async (response) => {
 //#endregion
 export { MailboxEventStreamError as n, MailboxEventStream as t };
 
-//# sourceMappingURL=mailbox-events-CsbF35vH.js.map
+//# sourceMappingURL=mailbox-events-VKR4f3qq.js.map

package/dist/mailbox-events.d.ts

@@ -136,7 +136,7 @@ export interface MailboxEventStreamOptions {
 export interface MailboxEventStreamConnection {
     readonly baseUrl: string;
     /** The credential and attribution headers every request of the client carries. */
-    readonly headers: Readonly<Record<string, string>>;
+    readonly headers: Readonly<Record<string, string>> | (() => Promise<Readonly<Record<string, string>>>);
     readonly fetch?: typeof fetch | undefined;
 }
 /** The frame that asks the events host whether the connection is alive; pinned to the host's by a test. */

package/dist/{mailboxes-BtcktcNB.js → mailboxes-DT02zP7q.js}

@@ -1,7 +1,7 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { n as MailboxEventStreamError, t as MailboxEventStream } from "./mailbox-events-CsbF35vH.js";
-import { n as make } from "./operation-BEghYyLu.js";
-import { t as Service } from "./client-Cj1bqIEe.js";
+import { n as MailboxEventStreamError, t as MailboxEventStream } from "./mailbox-events-VKR4f3qq.js";
+import { n as make } from "./operation-g8nAzmIM.js";
+import { t as Service } from "./client-CZjhOKPM.js";
 import { Cause, Effect, Exit, Stream } from "effect";
 //#region src/effect/internal/mailbox-events.ts
 const toStreamError = (cause) => cause instanceof MailboxEventStreamError ? cause : new MailboxEventStreamError({
@@ -35,6 +35,8 @@ var mailboxes_exports = /* @__PURE__ */ __exportAll({
 	MailboxEventStreamError: () => MailboxEventStreamError,
 	addThreadLabels: () => addThreadLabels,
 	approveAction: () => approveAction,
+	cancelAction: () => cancelAction,
+	copyMessageAttachment: () => copyMessageAttachment,
 	create: () => create,
 	createDraft: () => createDraft,
 	createGrant: () => createGrant,
@@ -50,6 +52,7 @@ var mailboxes_exports = /* @__PURE__ */ __exportAll({
 	events: () => events,
 	forward: () => forward,
 	get: () => get,
+	getAction: () => getAction,
 	getAgentActivity: () => getAgentActivity,
 	getDraft: () => getDraft,
 	getMessage: () => getMessage,
@@ -77,6 +80,7 @@ var mailboxes_exports = /* @__PURE__ */ __exportAll({
 	reply: () => reply,
 	replyAll: () => replyAll,
 	resume: () => resume,
+	retryAction: () => retryAction,
 	revokeGrant: () => revokeGrant,
 	sendDraft: () => sendDraft,
 	sendMessage: () => sendMessage,
@@ -125,6 +129,7 @@ const sendMessage = make("mailboxesSendMessage");
 const getMessage = make("mailboxesGetMessage");
 const getMessageRaw = make("mailboxesGetMessageRaw");
 const getMessageAttachment = make("mailboxesGetMessageAttachment");
+const copyMessageAttachment = make("mailboxesCopyMessageAttachment");
 const reply = make("mailboxesReply");
 const replyAll = make("mailboxesReplyAll");
 const forward = make("mailboxesForward");
@@ -138,10 +143,13 @@ const updateDraft = make("mailboxesUpdateDraft");
 const deleteDraft = make("mailboxesDeleteDraft");
 const sendDraft = make("mailboxesSendDraft");
 const listActions = make("mailboxesListActions");
+const getAction = make("mailboxesGetAction");
+const cancelAction = make("mailboxesCancelAction");
+const retryAction = make("mailboxesRetryAction");
 const approveAction = make("mailboxesApproveAction");
 const denyAction = make("mailboxesDenyAction");
 const listEvents = make("mailboxesListEvents");
 //#endregion
-export { updatePolicy as $, listGrants as A, remove as B, getThread as C, listDrafts as D, listActions as E, listThreadNotes as F, revokeGrant as G, reply as H, listThreads as I, update as J, sendDraft as K, mailboxes_exports as L, listPolicies as M, listQuarantine as N, listEvents as O, listThreadMessages as P, updateNote as Q, pause as R, getPolicy as S, list as T, replyAll as U, removeThreadLabels as V, resume as W, updateGrant as X, updateDraft as Y, updateLabel as Z, getAgentActivity as _, createGrant as a, getMessageAttachment as b, createPolicy as c, deleteNote as d, updateThread as et, deletePolicy as f, get as g, forward as h, createDraft as i, listLabels as j, listFolders as k, deleteDraft as l, discardMessage as m, approveAction as n, createLabel as o, denyAction as p, sendMessage as q, create as r, createNote as s, addThreadLabels as t, events as tt, deleteLabel as u, getDraft as v, getThreadContent as w, getMessageRaw as x, getMessage as y, releaseMessage as z };
+export { updateDraft as $, listDrafts as A, mailboxes_exports as B, getMessageAttachment as C, getThreadContent as D, getThread as E, listPolicies as F, reply as G, releaseMessage as H, listQuarantine as I, retryAction as J, replyAll as K, listThreadMessages as L, listFolders as M, listGrants as N, list as O, listLabels as P, update as Q, listThreadNotes as R, getMessage as S, getPolicy as T, remove as U, pause as V, removeThreadLabels as W, sendDraft as X, revokeGrant as Y, sendMessage as Z, forward as _, create as a, events as at, getAgentActivity as b, createLabel as c, deleteDraft as d, updateGrant as et, deleteLabel as f, discardMessage as g, denyAction as h, copyMessageAttachment as i, updateThread as it, listEvents as j, listActions as k, createNote as l, deletePolicy as m, approveAction as n, updateNote as nt, createDraft as o, deleteNote as p, resume as q, cancelAction as r, updatePolicy as rt, createGrant as s, addThreadLabels as t, updateLabel as tt, createPolicy as u, get as v, getMessageRaw as w, getDraft as x, getAction as y, listThreads as z };
 
-//# sourceMappingURL=mailboxes-BtcktcNB.js.map
+//# sourceMappingURL=mailboxes-DT02zP7q.js.map

package/dist/{operation-BEghYyLu.js → operation-g8nAzmIM.js}

@@ -1,5 +1,6 @@
+import { a as withUploadedAttachments, n as mediaCreateBody, r as planInlineUploads } from "./inline-attachments-BrNnSMF2.js";
 import { n as buildMessagesSendPayload, r as replyToEmailsPayload, t as buildEmailSendPayload } from "./normalize-B79uJIeb.js";
-import { t as Service, w as SamvaApi } from "./client-Cj1bqIEe.js";
+import { E as SamvaApi, t as Service } from "./client-CZjhOKPM.js";
 import { generateIdempotencyKey, withRetry } from "./effect/retry.js";
 import { Effect, Option, Predicate, Stream } from "effect";
 //#region src/service-map.ts
@@ -523,6 +524,10 @@ const SDK_OPERATION_CALLS = {
 		kind: "path",
 		paths: ["id", "publicationId"]
 	},
+	templatesRenderPublication: {
+		kind: "pathPayload",
+		paths: ["id", "publicationId"]
+	},
 	templatesListInputContracts: {
 		kind: "pathParams",
 		paths: ["id"]
@@ -568,6 +573,7 @@ const SDK_OPERATION_CALLS = {
 	organizationsCreate: { kind: "payload" },
 	organizationsGet: { kind: "none" },
 	organizationsGetProfile: { kind: "none" },
+	organizationsGetTrustTier: { kind: "none" },
 	organizationsUpdate: { kind: "payload" },
 	organizationsGetUsage: { kind: "params" },
 	organizationsDelete: { kind: "idempotentPayload" },
@@ -652,6 +658,7 @@ const SDK_OPERATION_CALLS = {
 		kind: "path",
 		paths: ["id"]
 	},
+	subscriptionsSubscribe: { kind: "payload" },
 	unsubscribeList: { kind: "none" },
 	unsubscribeCreate: { kind: "payload" },
 	unsubscribeUpdate: {
@@ -839,6 +846,14 @@ const SDK_OPERATION_CALLS = {
 			"attachmentId"
 		]
 	},
+	mailboxesCopyMessageAttachment: {
+		kind: "path",
+		paths: [
+			"id",
+			"messageId",
+			"attachmentId"
+		]
+	},
 	mailboxesReply: {
 		kind: "optionalIdempotentPathPayload",
 		paths: ["id", "messageId"]
@@ -891,6 +906,18 @@ const SDK_OPERATION_CALLS = {
 		kind: "pathParams",
 		paths: ["id"]
 	},
+	mailboxesGetAction: {
+		kind: "path",
+		paths: ["id", "actionId"]
+	},
+	mailboxesCancelAction: {
+		kind: "path",
+		paths: ["id", "actionId"]
+	},
+	mailboxesRetryAction: {
+		kind: "path",
+		paths: ["id", "actionId"]
+	},
 	mailboxesApproveAction: {
 		kind: "path",
 		paths: ["id", "actionId"]
@@ -933,6 +960,10 @@ const SDK_OPERATION_CALLS = {
 	},
 	extensionInstallationsList: { kind: "params" },
 	extensionInstallationsInstall: { kind: "payload" },
+	extensionInstallationsUpgrade: {
+		kind: "pathPayload",
+		paths: ["id"]
+	},
 	extensionInstallationsGet: {
 		kind: "path",
 		paths: ["id"]
@@ -1114,11 +1145,40 @@ const make = (operationName) => {
 	}
 	return operation;
 };
+/**
+* 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.
+*/
+const uploadOversizedAttachments = (client, payload) => Effect.gen(function* () {
+	const plan = planInlineUploads(payload);
+	if (plan.length === 0) return payload;
+	const uploaded = /* @__PURE__ */ new Map();
+	for (const upload of plan) {
+		const created = yield* rawOperation(client, "mediaCreate")({ payload: mediaCreateBody(upload) });
+		yield* client.putUpload({
+			filename: upload.filename,
+			mediaId: created.id,
+			url: created.upload.url,
+			method: created.upload.method,
+			headers: created.upload.headers,
+			bytes: upload.bytes
+		});
+		yield* rawOperation(client, "mediaComplete")({ params: { id: created.id } });
+		uploaded.set(upload.index, {
+			mediaId: created.id,
+			upload
+		});
+	}
+	return withUploadedAttachments(payload, uploaded);
+});
 const sendPayload = (payload, options) => Effect.gen(function* () {
 	const client = yield* Service;
 	const idempotencyKey = options?.idempotencyKey ?? (yield* generateIdempotencyKey);
+	const prepared = yield* uploadOversizedAttachments(client, payload);
 	return yield* withRetry(rawOperation(client, "messagesSend")({
-		payload: stripUndefined(payload),
+		payload: stripUndefined(prepared),
 		headers: { "idempotency-key": idempotencyKey }
 	}));
 });
@@ -1143,4 +1203,4 @@ const addEmailSender = Effect.fn("Email.addSender")(function* (input, options) {
 //#endregion
 export { sendMessage as i, make as n, sendEmail as r, addEmailSender as t };
 
-//# sourceMappingURL=operation-BEghYyLu.js.map
+//# sourceMappingURL=operation-g8nAzmIM.js.map

package/dist/promises/errors.gen.d.ts

@@ -1,4 +1,4 @@
-export type SamvaApiErrorTag = "AnalyticsQueryError" | "BillingProviderError" | "BrandAddressRequiredError" | "CampaignFooterRequiredError" | "ConflictError" | "DeliveryUnavailableError" | "EmailChannelError" | "ExternalServiceError" | "FlagDisabledError" | "ForbiddenError" | "GatewayTimeoutError" | "InternalError" | "OnboardingReviewRequiredError" | "PaymentRequiredError" | "RateLimitedError" | "ResourceNotFoundError" | "UnauthorizedError" | "ValidationError";
+export type SamvaApiErrorTag = "AnalyticsQueryError" | "BillingProviderError" | "BrandAddressRequiredError" | "CampaignFooterRequiredError" | "ConflictError" | "DeliveryUnavailableError" | "EmailChannelError" | "ExternalServiceError" | "FlagDisabledError" | "ForbiddenError" | "GatewayTimeoutError" | "InternalError" | "MailboxSendConflictError" | "MailboxSendRefusedError" | "OnboardingReviewRequiredError" | "PaymentRequiredError" | "RateLimitedError" | "ResourceNotFoundError" | "SenderNotReadyError" | "UnauthorizedError" | "ValidationError";
 export interface SamvaApiErrorContext {
     readonly request?: Request | undefined;
     readonly response?: Response | undefined;
@@ -132,6 +132,30 @@ export declare class InternalError extends SamvaApiError<"InternalError"> {
     readonly _tag: "InternalError";
     constructor(payload: Omit<InternalErrorPayload, "_tag">, context?: SamvaApiErrorContext);
 }
+type MailboxSendConflictErrorPayload = {
+    readonly _tag: "MailboxSendConflictError";
+    readonly id: string;
+    readonly message: string;
+    readonly receipt: Record<string, unknown>;
+    readonly resource: string;
+};
+export declare class MailboxSendConflictError extends SamvaApiError<"MailboxSendConflictError"> {
+    readonly _tag: "MailboxSendConflictError";
+    readonly "id": string;
+    readonly "receipt": Record<string, unknown>;
+    readonly "resource": string;
+    constructor(payload: Omit<MailboxSendConflictErrorPayload, "_tag">, context?: SamvaApiErrorContext);
+}
+type MailboxSendRefusedErrorPayload = {
+    readonly _tag: "MailboxSendRefusedError";
+    readonly message: string;
+    readonly receipt: Record<string, unknown>;
+};
+export declare class MailboxSendRefusedError extends SamvaApiError<"MailboxSendRefusedError"> {
+    readonly _tag: "MailboxSendRefusedError";
+    readonly "receipt": Record<string, unknown>;
+    constructor(payload: Omit<MailboxSendRefusedErrorPayload, "_tag">, context?: SamvaApiErrorContext);
+}
 type OnboardingReviewRequiredErrorPayload = {
     readonly _tag: "OnboardingReviewRequiredError";
     readonly code: "review_required" | "review_in_progress" | "information_required" | "review_rejected" | "identity_review_required" | "identity_review_rejected" | "identity_changed";
@@ -186,6 +210,18 @@ export declare class ResourceNotFoundError extends SamvaApiError<"ResourceNotFou
     readonly "resource": string;
     constructor(payload: Omit<ResourceNotFoundErrorPayload, "_tag">, context?: SamvaApiErrorContext);
 }
+type SenderNotReadyErrorPayload = {
+    readonly _tag: "SenderNotReadyError";
+    readonly message: string;
+    readonly retryAfterSeconds?: number | null;
+    readonly sender: string;
+};
+export declare class SenderNotReadyError extends SamvaApiError<"SenderNotReadyError"> {
+    readonly _tag: "SenderNotReadyError";
+    readonly "retryAfterSeconds"?: number | null;
+    readonly "sender": string;
+    constructor(payload: Omit<SenderNotReadyErrorPayload, "_tag">, context?: SamvaApiErrorContext);
+}
 type UnauthorizedErrorPayload = {
     readonly _tag: "UnauthorizedError";
     readonly message: string;
@@ -204,7 +240,7 @@ export declare class ValidationError extends SamvaApiError<"ValidationError"> {
     readonly "fields"?: Record<string, Array<string>> | null;
     constructor(payload: Omit<ValidationErrorPayload, "_tag">, context?: SamvaApiErrorContext);
 }
-export type AnySamvaApiError = AnalyticsQueryError | BillingProviderError | BrandAddressRequiredError | CampaignFooterRequiredError | ConflictError | DeliveryUnavailableError | EmailChannelError | ExternalServiceError | FlagDisabledError | ForbiddenError | GatewayTimeoutError | InternalError | OnboardingReviewRequiredError | PaymentRequiredError | RateLimitedError | ResourceNotFoundError | UnauthorizedError | ValidationError;
+export type AnySamvaApiError = AnalyticsQueryError | BillingProviderError | BrandAddressRequiredError | CampaignFooterRequiredError | ConflictError | DeliveryUnavailableError | EmailChannelError | ExternalServiceError | FlagDisabledError | ForbiddenError | GatewayTimeoutError | InternalError | MailboxSendConflictError | MailboxSendRefusedError | OnboardingReviewRequiredError | PaymentRequiredError | RateLimitedError | ResourceNotFoundError | SenderNotReadyError | UnauthorizedError | ValidationError;
 /** Convert a decoded error payload into its generated JavaScript error class. */
 export declare function fromApiError(error: unknown, context?: SamvaApiErrorContext): AnySamvaApiError | SamvaTransportError;
 export {};