samva 0.11.0 → 0.13.0

package/dist/{promises-CqAmI39P.js → promises-D9FJyU0q.js}

@@ -1,5 +1,5 @@
-import { n as clientAttribution, t as CLIENT_ATTRIBUTION_HEADER } from "./client-attribution-Ct2FKITg.js";
-import { t as MailboxEventStream } from "./mailbox-events-CcWm8lO4.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-B56eS0MF.js";
+import { t as MailboxEventStream } from "./mailbox-events-CsbF35vH.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) };
@@ -1936,7 +1936,7 @@ var Email = class {
 	/**
 	* Build a one-click DNS apply URL
 	*
-	* Builds the signed Domain Connect apply URL for the selected sending-only or sending-and-receiving service. Manual DNS remains available for either mode.
+	* Builds the signed Domain Connect apply URL for the selected sending-only or sending-and-receiving service. The sending-and-receiving service writes the apex inbound MX, so it is refused until the domain's receiving is enabled. Manual DNS remains available for either mode.
 	*/
 	static buildDomainConnectApplyUrl(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [{
@@ -2003,7 +2003,7 @@ var Email = class {
 	/**
 	* Enable inbound email for a domain
 	*
-	* Enables inbound receiving for a verified domain and returns the recipient addresses it accepts. Set `catchAll` to route every address on the domain; that requires a webhook endpoint, supplied as `endpointId` or already configured on the domain.
+	* Enables inbound receiving for a verified domain and returns the recipient addresses it accepts. Set `catchAll` to route every address on the domain; that needs a destination: a webhook endpoint, supplied as `endpointId` or already configured on the domain, or at least one active forwarding rule that covers the domain. Mail that matches neither is rejected, never accepted and dropped.
 	*/
 	static enableReceiving(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [
@@ -2044,6 +2044,26 @@ var Email = class {
 		});
 	}
 	/**
+	* Get receiving setup status
+	*
+	* Reports each prerequisite for receiving a domain's mail at Samva, in order: sending verified, a destination (a webhook endpoint or an active forwarding rule), receiving enabled, and the inbound MX record. The MX answer is a live DNS lookup that names the current target when mail is routed elsewhere.
+	*/
+	static getReceivingStatus(parameters, options) {
+		const params = buildClientParams([parameters], [{ args: [{
+			in: "path",
+			key: "id"
+		}] }]);
+		return (options?.client ?? client).get({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/email/domains/{id}/receiving-status",
+			...options,
+			...params
+		});
+	}
+	/**
 	* Set the default sending domain
 	*
 	* Marks a verified domain as the organization's default sending domain, atomically clearing any previous default. Omitted-`from` sends resolve through the default domain's default sender.
@@ -2231,6 +2251,26 @@ var Email = class {
 		});
 	}
 	/**
+	* Recheck a custom tracking domain's certificate
+	*
+	* Checks the hostname's certificate now instead of waiting for the next scheduled check, and returns the refreshed state. Samva checks a hostname at most once every 30 seconds; a recheck inside that window returns the state from the last check. Returns a conflict when custom tracking is disabled or being torn down.
+	*/
+	static recheckCustomTracking(parameters, options) {
+		const params = buildClientParams([parameters], [{ args: [{
+			in: "path",
+			key: "id"
+		}] }]);
+		return (options?.client ?? client).post({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/email/domains/{id}/custom-tracking/recheck",
+			...options,
+			...params
+		});
+	}
+	/**
 	* Check automatic Custom Tracking Domain setup eligibility
 	*
 	* Reports whether the domain's DNS provider supports Domain Connect for its current Custom Tracking Domain. Ineligible is a normal result and the exact manual CNAME records remain available.
@@ -2496,7 +2536,7 @@ var Email = class {
 	/**
 	* Enable catch-all receiving
 	*
-	* Enables catch-all inbound receiving for a domain. `endpointId` is one of the organization's webhook endpoints; every address on the domain delivers `message.received` to it. Responds with 201.
+	* Enables catch-all inbound receiving for a verified domain. `endpointId` is one of the organization's webhook endpoints; every address on the domain delivers `message.received` to it. Omit it to deliver through forwarding rules alone, which needs at least one active forwarding rule covering the domain. Mail that matches neither a rule nor an endpoint is rejected as an unknown recipient. Responds with 201.
 	*/
 	static enableCatchAll(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [{
@@ -2902,7 +2942,7 @@ var Email = class {
 	/**
 	* List forwarding rules
 	*
-	* Returns every inbound email forwarding rule, highest priority first, optionally filtered by domain and active state. An organization holds at most 100, so the list is never paged.
+	* Returns every inbound email forwarding rule in the order inbound mail is matched against them: highest priority first, then an exact address before a wildcard pattern at equal priority, then oldest first. The first rule that matches is the one that forwards. Filtering by domain returns that domain's rules and the rules that apply to every domain (domainId null). An organization holds at most 100, so the list is never paged.
 	*/
 	static listForwardingRules(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [{
@@ -2925,7 +2965,7 @@ var Email = class {
 	/**
 	* Create a forwarding rule
 	*
-	* Creates an inbound email forwarding rule and returns it. Responds with 201. An organization holds at most 100 forwarding rules.
+	* Creates an inbound email forwarding rule and returns it. Responds with 201. Priority is a non-negative integer, default 0; higher priority rules are tried first, and at equal priority an exact address outranks a wildcard pattern. An organization holds at most 100 forwarding rules.
 	*/
 	static createForwardingRule(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [
@@ -3336,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: [
@@ -3379,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: [{
@@ -4486,7 +4526,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: [{
@@ -4494,7 +4534,7 @@ var Contacts = class {
 			key: "contacts"
 		}, {
 			in: "body",
-			key: "upsertByEmail"
+			key: "onConflict"
 		}] }]);
 		return (options?.client ?? client).post({
 			security: [{
@@ -9439,7 +9479,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: [{
@@ -9776,6 +9816,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.
@@ -10007,6 +10086,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 = {}) {
@@ -10038,6 +10124,7 @@ const constructors = {
 	PaymentRequiredError,
 	RateLimitedError,
 	ResourceNotFoundError,
+	SenderNotReadyError,
 	UnauthorizedError,
 	ValidationError
 };
@@ -10366,6 +10453,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: {
@@ -10497,6 +10604,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 {
@@ -10511,13 +10668,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
-			});
+			}));
 		}
 	};
 }
@@ -10538,13 +10695,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
-			});
+			}));
 		}
 	});
 }
@@ -10578,6 +10735,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);
@@ -10673,6 +10831,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 { fromApiError as C, ValidationError as S, ResourceNotFoundError as _, CampaignFooterRequiredError as a, SenderNotReadyError 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, UnauthorizedError as x, SamvaTransportError as y };
 
-//# sourceMappingURL=promises-CqAmI39P.js.map
+//# sourceMappingURL=promises-D9FJyU0q.js.map

package/dist/service-map.d.ts

@@ -126,8 +126,10 @@ export declare const SDK_SERVICE_OPERATIONS: {
         readonly buildDomainConnectApplyUrl: "emailBuildDomainConnectApplyUrl";
         readonly completeDomainConnect: "emailCompleteDomainConnect";
         readonly enableReceiving: "emailEnableReceiving";
+        readonly getReceivingStatus: "emailGetReceivingStatus";
         readonly enableCustomTracking: "emailEnableCustomTracking";
         readonly getCustomTracking: "emailGetCustomTracking";
+        readonly recheckCustomTracking: "emailRecheckCustomTracking";
         readonly getCustomTrackingDomainConnect: "emailGetCustomTrackingDomainConnect";
         readonly buildCustomTrackingDomainConnectApplyUrl: "emailBuildCustomTrackingDomainConnectApplyUrl";
         readonly completeCustomTrackingDomainConnect: "emailCompleteCustomTrackingDomainConnect";
@@ -340,6 +342,7 @@ export declare const SDK_SERVICE_OPERATIONS: {
     readonly extensionInstallations: {
         readonly list: "extensionInstallationsList";
         readonly install: "extensionInstallationsInstall";
+        readonly upgrade: "extensionInstallationsUpgrade";
         readonly get: "extensionInstallationsGet";
         readonly uninstall: "extensionInstallationsUninstall";
         readonly disable: "extensionInstallationsDisable";
@@ -586,6 +589,10 @@ export declare const SDK_OPERATION_CALLS: {
         readonly kind: "pathPayload";
         readonly paths: readonly ["id"];
     };
+    readonly emailGetReceivingStatus: {
+        readonly kind: "path";
+        readonly paths: readonly ["id"];
+    };
     readonly emailEnableCustomTracking: {
         readonly kind: "pathPayload";
         readonly paths: readonly ["id"];
@@ -594,6 +601,10 @@ export declare const SDK_OPERATION_CALLS: {
         readonly kind: "path";
         readonly paths: readonly ["id"];
     };
+    readonly emailRecheckCustomTracking: {
+        readonly kind: "path";
+        readonly paths: readonly ["id"];
+    };
     readonly emailGetCustomTrackingDomainConnect: {
         readonly kind: "path";
         readonly paths: readonly ["id"];
@@ -1426,6 +1437,10 @@ export declare const SDK_OPERATION_CALLS: {
     readonly extensionInstallationsInstall: {
         readonly kind: "payload";
     };
+    readonly extensionInstallationsUpgrade: {
+        readonly kind: "pathPayload";
+        readonly paths: readonly ["id"];
+    };
     readonly extensionInstallationsGet: {
         readonly kind: "path";
         readonly paths: readonly ["id"];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "samva",
-  "version": "0.11.0",
+  "version": "0.13.0",
   "description": "TypeScript SDK for the Samva email API",
   "keywords": [
     "api-client",
@@ -177,7 +177,7 @@
     "typecheck": "tsc --noEmit && tsc --noEmit -p codegen/tsconfig.json && tsc --noEmit -p tests/tsconfig.json"
   },
   "dependencies": {
-    "@samva/webhooks": "0.11.0"
+    "@samva/webhooks": "0.13.0"
   },
   "devDependencies": {
     "@effect/openapi-generator": "4.0.0",

package/dist/client-attribution-Ct2FKITg.js

@@ -1,9 +0,0 @@
-//#endregion
-//#region src/client-attribution.ts
-const SDK_VERSION = "0.11.0";
-const CLIENT_ATTRIBUTION_HEADER = "x-samva-client";
-const clientAttribution = (surface) => `${surface}/${SDK_VERSION}`;
-//#endregion
-export { clientAttribution as n, CLIENT_ATTRIBUTION_HEADER as t };
-
-//# sourceMappingURL=client-attribution-Ct2FKITg.js.map