samva 0.1.1 → 0.2.0

package/dist/{promises-QxEfMTho.js → promises-Dgv8UmCC.js}

@@ -1550,64 +1550,36 @@ var Email = class {
 		});
 	}
 	/**
-	* Provision a sending domain
+	* Get domain verification
 	*
-	* Accepts durable provisioning for a sending domain. Repeating an identical request with the same Idempotency-Key returns the same organization-scoped operation.
+	* Returns the stored DNS and provider lifecycle snapshot without calling a provider or mutating state.
 	*/
-	static provisionDomain(parameters, options) {
-		const params = buildClientParams([parameters], [{ args: [{
-			in: "headers",
-			key: "idempotency-key"
-		}, {
-			in: "body",
-			key: "domain"
-		}] }]);
-		return (options?.client ?? client).post({
-			security: [{
-				name: "x-api-key",
-				type: "apiKey"
-			}],
-			url: "/v1/email/domain-operations",
-			...options,
-			...params,
-			headers: {
-				"Content-Type": "application/json",
-				...options?.headers,
-				...params.headers
-			}
-		});
-	}
-	/**
-	* Verify a sending domain
-	*
-	* Initiates verification of a sending domain with the email provider and stores the DNS records needed to complete it.
-	*/
-	static verifyDomain(parameters, options) {
+	static getDomainVerification(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [{
 			in: "path",
 			key: "id"
 		}] }]);
-		return (options?.client ?? client).post({
+		return (options?.client ?? client).get({
 			security: [{
 				name: "x-api-key",
 				type: "apiKey"
 			}],
-			url: "/v1/email/domains/{id}/verify",
+			url: "/v1/email/domains/{id}/verification",
 			...options,
 			...params
 		});
 	}
 	/**
-	* Check domain verification status
+	* Advance domain verification
 	*
-	* Re-checks a sending domain's verification live with the email provider and updates the stored status once it is verified.
+	* Observes the required DNS records and, once they match, idempotently starts provider provisioning for the staged domain.
 	*/
-	static checkDomainVerification(parameters, options) {
+	static advanceDomainVerification(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [{
 			in: "path",
 			key: "id"
 		}] }]);
-		return (options?.client ?? client).get({
+		return (options?.client ?? client).post({
 			security: [{
 				name: "x-api-key",
 				type: "apiKey"
@@ -1694,6 +1666,9 @@ var Email = class {
 		const params = buildClientParams([parameters], [{ args: [{
 			in: "path",
 			key: "id"
+		}, {
+			in: "query",
+			key: "mode"
 		}] }]);
 		return (options?.client ?? client).get({
 			security: [{
@@ -1708,7 +1683,7 @@ var Email = class {
 	/**
 	* Build a one-click DNS apply URL
 	*
-	* Builds the signed Domain Connect apply URL that sends the customer to their DNS provider to apply Samva's sending records in one click. Pass inbound to also request the receiving MX records.
+	* Builds the signed Domain Connect apply URL for the selected sending-only or sending-and-receiving service. Manual DNS remains available for either mode.
 	*/
 	static buildDomainConnectApplyUrl(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [{
@@ -1716,7 +1691,7 @@ var Email = class {
 			key: "id"
 		}, {
 			in: "body",
-			key: "inbound"
+			key: "mode"
 		}] }]);
 		return (options?.client ?? client).post({
 			security: [{
@@ -1812,26 +1787,6 @@ var Email = class {
 		});
 	}
 	/**
-	* Get sending domain status
-	*
-	* Returns the stored verification status of a sending domain without contacting the email provider.
-	*/
-	static getDomainStatus(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}/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.
@@ -1947,11 +1902,11 @@ var Email = class {
 		});
 	}
 	/**
-	* Disable a branded tracking domain
+	* Disable a custom tracking domain
 	*
-	* Tears down a domain's branded tracking and its managed resources. Sends immediately revert to the shared tracking host. Existing branded links in already-delivered mail stop working.
+	* Tears down a domain's custom tracking and its managed resources. Sends immediately revert to the shared tracking host. Existing custom links in already-delivered mail stop working.
 	*/
-	static disableBrandedTracking(parameters, options) {
+	static disableCustomTracking(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [{
 			in: "path",
 			key: "id"
@@ -1961,17 +1916,17 @@ var Email = class {
 				name: "x-api-key",
 				type: "apiKey"
 			}],
-			url: "/v1/email/domains/{id}/branded-tracking",
+			url: "/v1/email/domains/{id}/custom-tracking",
 			...options,
 			...params
 		});
 	}
 	/**
-	* Get branded tracking status
+	* Get custom tracking status
 	*
-	* Returns the branded tracking state for a sending domain: lifecycle status, the required DNS records, certificate and CAA readiness, and any scheduled teardown. `enabled` is false when no branded tracking domain is provisioned.
+	* Returns the custom tracking state for a sending domain: lifecycle status, the required DNS records, certificate and CAA readiness, and any scheduled teardown. `enabled` is false when no custom tracking domain is provisioned.
 	*/
-	static getBrandedTracking(parameters, options) {
+	static getCustomTracking(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [{
 			in: "path",
 			key: "id"
@@ -1981,17 +1936,17 @@ var Email = class {
 				name: "x-api-key",
 				type: "apiKey"
 			}],
-			url: "/v1/email/domains/{id}/branded-tracking",
+			url: "/v1/email/domains/{id}/custom-tracking",
 			...options,
 			...params
 		});
 	}
 	/**
-	* Enable a branded tracking domain
+	* Enable a custom tracking domain
 	*
-	* Provisions a branded tracking domain (default label `track`) for a verified sending domain so open/click links redirect through the customer's own subdomain. Requires the branded_tracking entitlement. Returns the resulting state including the two DNS records the customer must create.
+	* Provisions a custom tracking domain (default label `track`) for a verified sending domain so open/click links redirect through the customer's own subdomain. Requires the custom_tracking_domain entitlement. Returns the resulting state including the two DNS records the customer must create.
 	*/
-	static enableBrandedTracking(parameters, options) {
+	static enableCustomTracking(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [{
 			in: "path",
 			key: "id"
@@ -2004,7 +1959,82 @@ var Email = class {
 				name: "x-api-key",
 				type: "apiKey"
 			}],
-			url: "/v1/email/domains/{id}/branded-tracking",
+			url: "/v1/email/domains/{id}/custom-tracking",
+			...options,
+			...params,
+			headers: {
+				"Content-Type": "application/json",
+				...options?.headers,
+				...params.headers
+			}
+		});
+	}
+	/**
+	* 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.
+	*/
+	static getCustomTrackingDomainConnect(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}/custom-tracking/domain-connect",
+			...options,
+			...params
+		});
+	}
+	/**
+	* Build an automatic Custom Tracking Domain apply URL
+	*
+	* Builds the signed Domain Connect URL for the current customer-selected tracking host. The server derives the host and Cloudflare DCV UUID; exact manual CNAME records remain available.
+	*/
+	static buildCustomTrackingDomainConnectApplyUrl(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/domain-connect/apply-url",
+			...options,
+			...params
+		});
+	}
+	/**
+	* Complete an automatic Custom Tracking Domain return
+	*
+	* Validates the purpose- and revision-bound registrar state, then re-kicks the existing readiness reconciliation. The callback never declares the host ready or changes email tracking selection.
+	*/
+	static completeCustomTrackingDomainConnect(parameters, options) {
+		const params = buildClientParams([parameters], [{ args: [
+			{
+				in: "path",
+				key: "id"
+			},
+			{
+				in: "body",
+				key: "state"
+			},
+			{
+				in: "body",
+				key: "error"
+			}
+		] }]);
+		return (options?.client ?? client).post({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/email/domains/{id}/custom-tracking/domain-connect/complete",
 			...options,
 			...params,
 			headers: {
@@ -3255,10 +3285,6 @@ var Contacts = class {
 				in: "body",
 				key: "tags"
 			},
-			{
-				in: "body",
-				key: "engagement"
-			},
 			{
 				in: "body",
 				key: "accessLevel"
@@ -3480,10 +3506,6 @@ var Contacts = class {
 				in: "body",
 				key: "tags"
 			},
-			{
-				in: "body",
-				key: "engagement"
-			},
 			{
 				in: "body",
 				key: "accessLevel"
@@ -4140,7 +4162,7 @@ var Templates = class {
 	/**
 	* Get a template
 	*
-	* Returns a single template by ID, including its SML source and compiled channel content.
+	* Returns template metadata and compiled channel content. Read live SML through the template-document API.
 	*/
 	static getById(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [{
@@ -4160,7 +4182,7 @@ var Templates = class {
 	/**
 	* Update a template
 	*
-	* Updates a template's metadata or SML source; a new source's root tag must match the template's existing channel. Returns the updated template.
+	* Updates template metadata. Source changes use the template-document revision API.
 	*/
 	static update(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [{
@@ -4213,25 +4235,19 @@ var Templates = class {
 			}
 		});
 	}
-	/**
-	* Render a template
-	*
-	* Renders a template with the provided variables and returns a channel-specific preview, along with any missing variables and errors. No message is sent.
-	*/
-	static render(parameters, options) {
+};
+var TemplateDocuments = class {
+	static bootstrap(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [{
-			in: "path",
-			key: "id"
-		}, {
 			in: "body",
-			key: "data"
+			key: "templateId"
 		}] }]);
 		return (options?.client ?? client).post({
 			security: [{
 				name: "x-api-key",
 				type: "apiKey"
 			}],
-			url: "/v1/templates/{id}/render",
+			url: "/v1/template-documents/bootstrap",
 			...options,
 			...params,
 			headers: {
@@ -4241,125 +4257,272 @@ var Templates = class {
 			}
 		});
 	}
-	/**
-	* Duplicate a template
-	*
-	* Creates a copy of the template as a new draft template with a fresh slug. Returns the new template with status 201.
-	*/
-	static duplicate(parameters, options) {
+	static get(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [{
 			in: "path",
-			key: "id"
+			key: "templateId"
 		}] }]);
-		return (options?.client ?? client).post({
+		return (options?.client ?? client).get({
 			security: [{
 				name: "x-api-key",
 				type: "apiKey"
 			}],
-			url: "/v1/templates/{id}/duplicate",
+			url: "/v1/template-documents/{templateId}",
 			...options,
 			...params
 		});
 	}
-	/**
-	* Publish a template
-	*
-	* Compiles the template's current source and creates a new published version snapshot, recording the publisher. Returns the updated template.
-	*/
-	static publish(parameters, options) {
-		const params = buildClientParams([parameters], [{ args: [{
-			in: "path",
-			key: "id"
-		}] }]);
+	static replace(parameters, options) {
+		const params = buildClientParams([parameters], [{ args: [
+			{
+				in: "path",
+				key: "templateId"
+			},
+			{
+				in: "body",
+				key: "expectedRevision"
+			},
+			{
+				in: "body",
+				key: "source"
+			}
+		] }]);
 		return (options?.client ?? client).post({
 			security: [{
 				name: "x-api-key",
 				type: "apiKey"
 			}],
-			url: "/v1/templates/{id}/publish",
+			url: "/v1/template-documents/{templateId}/source",
 			...options,
-			...params
+			...params,
+			headers: {
+				"Content-Type": "application/json",
+				...options?.headers,
+				...params.headers
+			}
 		});
 	}
-	/**
-	* Unpublish a template
-	*
-	* Reverts a published template by creating a new draft version from its current source. Returns the updated template.
-	*/
-	static unpublish(parameters, options) {
+	static save(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [{
 			in: "path",
-			key: "id"
+			key: "templateId"
+		}, {
+			in: "body",
+			key: "revision"
 		}] }]);
 		return (options?.client ?? client).post({
 			security: [{
 				name: "x-api-key",
 				type: "apiKey"
 			}],
-			url: "/v1/templates/{id}/unpublish",
+			url: "/v1/template-documents/{templateId}/save",
 			...options,
-			...params
+			...params,
+			headers: {
+				"Content-Type": "application/json",
+				...options?.headers,
+				...params.headers
+			}
 		});
 	}
-	/**
-	* List template versions
-	*
-	* Returns the template's version history, listing each source version with its status and publish metadata.
-	*/
-	static versionHistory(parameters, options) {
+	static render(parameters, options) {
+		const params = buildClientParams([parameters], [{ args: [
+			{
+				in: "path",
+				key: "templateId"
+			},
+			{
+				in: "body",
+				key: "revision"
+			},
+			{
+				in: "body",
+				key: "variables"
+			}
+		] }]);
+		return (options?.client ?? client).post({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/template-documents/{templateId}/render",
+			...options,
+			...params,
+			headers: {
+				"Content-Type": "application/json",
+				...options?.headers,
+				...params.headers
+			}
+		});
+	}
+	static spamCheck(parameters, options) {
+		const params = buildClientParams([parameters], [{ args: [
+			{
+				in: "path",
+				key: "templateId"
+			},
+			{
+				in: "body",
+				key: "revision"
+			},
+			{
+				in: "body",
+				key: "variables"
+			}
+		] }]);
+		return (options?.client ?? client).post({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/template-documents/{templateId}/spam-check",
+			...options,
+			...params,
+			headers: {
+				"Content-Type": "application/json",
+				...options?.headers,
+				...params.headers
+			}
+		});
+	}
+	static testSend(parameters, options) {
+		const params = buildClientParams([parameters], [{ args: [
+			{
+				in: "path",
+				key: "templateId"
+			},
+			{
+				in: "body",
+				key: "revision"
+			},
+			{
+				in: "body",
+				key: "to"
+			},
+			{
+				in: "body",
+				key: "variables"
+			}
+		] }]);
+		return (options?.client ?? client).post({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/template-documents/{templateId}/send-test",
+			...options,
+			...params,
+			headers: {
+				"Content-Type": "application/json",
+				...options?.headers,
+				...params.headers
+			}
+		});
+	}
+	static send(parameters, options) {
+		const params = buildClientParams([parameters], [{ args: [
+			{
+				in: "path",
+				key: "templateId"
+			},
+			{
+				in: "body",
+				key: "revision"
+			},
+			{
+				in: "body",
+				key: "to"
+			},
+			{
+				in: "body",
+				key: "variables"
+			},
+			{
+				in: "body",
+				key: "schedule"
+			}
+		] }]);
+		return (options?.client ?? client).post({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/template-documents/{templateId}/send",
+			...options,
+			...params,
+			headers: {
+				"Content-Type": "application/json",
+				...options?.headers,
+				...params.headers
+			}
+		});
+	}
+	static versions(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [{
 			in: "path",
-			key: "id"
+			key: "templateId"
 		}] }]);
 		return (options?.client ?? client).get({
 			security: [{
 				name: "x-api-key",
 				type: "apiKey"
 			}],
-			url: "/v1/templates/{id}/versions",
+			url: "/v1/template-documents/{templateId}/versions",
 			...options,
 			...params
 		});
 	}
-	/**
-	* Restore a template version
-	*
-	* Recompiles an older version's source and restores it as a new draft version. Fails if the source no longer compiles or its channel differs.
-	*/
-	static restoreVersion(parameters, options) {
+	static publish(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [{
 			in: "path",
-			key: "id"
-		}, {
-			in: "path",
-			key: "versionId"
+			key: "templateId"
 		}] }]);
 		return (options?.client ?? client).post({
 			security: [{
 				name: "x-api-key",
 				type: "apiKey"
 			}],
-			url: "/v1/templates/{id}/versions/{versionId}/restore",
+			url: "/v1/template-documents/{templateId}/publish",
 			...options,
 			...params
 		});
 	}
-	/**
-	* Spam-check a template or email content
-	*
-	* Scores email content for spam risk, from either a stored email template or raw subject, HTML, and text. Returns a score, severity, issues, and recommendations.
-	*/
-	static spamCheck(parameters, options) {
+	static unpublish(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [{
-			key: "body",
-			map: "body"
+			in: "path",
+			key: "templateId"
 		}] }]);
 		return (options?.client ?? client).post({
 			security: [{
 				name: "x-api-key",
 				type: "apiKey"
 			}],
-			url: "/v1/templates/spam-check",
+			url: "/v1/template-documents/{templateId}/unpublish",
+			...options,
+			...params
+		});
+	}
+	static restore(parameters, options) {
+		const params = buildClientParams([parameters], [{ args: [
+			{
+				in: "path",
+				key: "templateId"
+			},
+			{
+				in: "path",
+				key: "versionId"
+			},
+			{
+				in: "body",
+				key: "expectedRevision"
+			}
+		] }]);
+		return (options?.client ?? client).post({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/template-documents/{templateId}/versions/{versionId}/restore",
 			...options,
 			...params,
 			headers: {
@@ -5127,6 +5290,7 @@ var ApiKeys = class {
 };
 //#endregion
 //#region src/promises/errors.gen.ts
+const redactRequest = (request) => request === void 0 ? void 0 : new Request(request.url, { method: request.method });
 /** Base class for failures declared by the public Samva OpenAPI contract. */
 var SamvaApiError = class extends Error {
 	request;
@@ -5135,7 +5299,7 @@ var SamvaApiError = class extends Error {
 	constructor(message, context = {}) {
 		super(message);
 		this.name = new.target.name;
-		this.request = context.request;
+		this.request = redactRequest(context.request);
 		this.response = context.response;
 		this.status = context.response?.status;
 	}
@@ -5151,7 +5315,7 @@ var SamvaTransportError = class extends Error {
 		super(cause instanceof Error ? cause.message : "Samva request failed", { cause });
 		this.name = "SamvaTransportError";
 		this.cause = cause;
-		this.request = context.request;
+		this.request = redactRequest(context.request);
 		this.response = context.response;
 		this.status = context.response?.status;
 	}
@@ -5713,6 +5877,7 @@ function createClient(config) {
 		campaigns: createBoundService(Campaigns, clientInstance),
 		email: createBoundService(Email, clientInstance),
 		templates: createBoundService(Templates, clientInstance),
+		templateDocuments: createBoundService(TemplateDocuments, clientInstance),
 		contacts: createBoundService(Contacts, clientInstance),
 		conversations: createBoundService(Conversations, clientInstance),
 		design: createBoundService(Design, clientInstance),
@@ -5730,6 +5895,7 @@ function createClient(config) {
 		campaigns: createDirectService(raw.campaigns),
 		email: createDirectService(promiseEmail),
 		templates: createDirectService(raw.templates),
+		templateDocuments: createDirectService(raw.templateDocuments),
 		contacts: createDirectService(raw.contacts),
 		conversations: createDirectService(raw.conversations),
 		design: createDirectService(raw.design),
@@ -5742,4 +5908,4 @@ function createClient(config) {
 //#endregion
 export { fromApiError as _, ExternalServiceError as a, InternalError as c, ResourceNotFoundError as d, SamvaApiError as f, WebhookEnqueueError as g, ValidationError as h, EmailChannelError as i, PaymentRequiredError as l, UnauthorizedError as m, BillingProviderError as n, FlagDisabledError as o, SamvaTransportError as p, ConflictError as r, ForbiddenError as s, createClient as t, RateLimitedError as u };
 
-//# sourceMappingURL=promises-QxEfMTho.js.map
+//# sourceMappingURL=promises-Dgv8UmCC.js.map