samva 0.6.0 → 0.8.0

package/dist/{promises-8MaPNAam.js → promises-DAv8ZtOX.js}

@@ -1,4 +1,4 @@
-import { n as clientAttribution, t as CLIENT_ATTRIBUTION_HEADER } from "./client-attribution-DYUSAa76.js";
+import { n as clientAttribution, t as CLIENT_ATTRIBUTION_HEADER } from "./client-attribution-N5A784Zo.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) };
@@ -1340,7 +1340,7 @@ var Campaigns = class {
 	/**
 	* Schedule a campaign run
 	*
-	* Schedules an email campaign run at the absolute ISO-8601 instant in scheduledFor, or immediately when omitted. The optional idempotencyKey is scoped to the organization and replays return the original run.
+	* Schedules an email campaign run at the absolute ISO-8601 instant in scheduledFor, or immediately when omitted. The optional idempotencyKey is scoped to the organization and replays return the original run. An email campaign must carry the brand footer: it is refused with CampaignFooterRequiredError when its footer is off and its template renders no BrandFooter, and with BrandAddressRequiredError when a brand that signs it off has no postal address.
 	*/
 	static scheduleRun(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [
@@ -1673,16 +1673,23 @@ var Email = class {
 	/**
 	* List sending domains
 	*
-	* Returns a paginated list of the organization's sending domains. Each row carries `deliverability` (bounce and complaint rates over the last 24 hours, the window the 5% bounce limit is enforced over) and `series`, the last 14 days of daily email sends attributed to the domain, oldest first.
+	* Returns a paginated list of the organization's sending domains. `sendable=true` lists only domains a send can use now: active, and verified, or verified before and degraded since. Each row carries `deliverability` (bounce and complaint rates over the last 24 hours, the window the 5% bounce limit is enforced over) and `series`, the last 14 days of daily email sends attributed to the domain, oldest first.
 	*/
 	static listDomains(parameters, options) {
-		const params = buildClientParams([parameters], [{ args: [{
-			in: "query",
-			key: "page"
-		}, {
-			in: "query",
-			key: "limit"
-		}] }]);
+		const params = buildClientParams([parameters], [{ args: [
+			{
+				in: "query",
+				key: "page"
+			},
+			{
+				in: "query",
+				key: "limit"
+			},
+			{
+				in: "query",
+				key: "sendable"
+			}
+		] }]);
 		return (options?.client ?? client).get({
 			security: [{
 				name: "x-api-key",
@@ -1696,7 +1703,7 @@ var Email = class {
 	/**
 	* Add a sending domain
 	*
-	* Registers a domain for sending and returns it with the DNS records required to verify ownership and configure DKIM. Responds with 201. Supplying a connection attaches the domain to that DNS account; the domain must sit inside the zone given with it. When Samva cannot register another sending domain right now, this responds with 429 and no domain is created.
+	* Registers a domain for sending and returns it with the DNS records required to verify ownership and configure DKIM. Responds with 201. Supplying a connection attaches the domain to that DNS account; the domain must sit inside the zone given with it. When Samva cannot register another sending domain right now, this responds with 429 and no domain is created. A banned organization is refused with 403.
 	*/
 	static addDomain(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [{
@@ -2056,7 +2063,7 @@ var Email = class {
 	/**
 	* Update a domain's send-settings config
 	*
-	* Overrides the domain's open/click tracking, reply-to, and unsubscribe-group defaults for the settings cascade. An omitted field is left unchanged; null clears it back to the organization default. Returns the saved config.
+	* Overrides the domain's open/click tracking, reply-to, unsubscribe-group defaults, and the brand its mail uses for the settings cascade. An omitted field is left unchanged; null clears it back to the organization default. Returns the saved config.
 	*/
 	static updateDomainConfig(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [
@@ -2083,6 +2090,10 @@ var Email = class {
 			{
 				in: "body",
 				key: "footerEnabled"
+			},
+			{
+				in: "body",
+				key: "brandSlug"
 			}
 		] }]);
 		return (options?.client ?? client).patch({
@@ -2248,9 +2259,9 @@ var Email = class {
 		});
 	}
 	/**
-	* List sender identities
+	* List senders
 	*
-	* Returns a paginated list of sender identities, optionally filtered by verification status, active state, or default flag. Each row carries `deliverability` (bounce and complaint rates over the last 24 hours) and `series`, the last 14 days of daily email sends from the address, oldest first.
+	* Returns a paginated list of senders, optionally filtered by verification status, active state, or default flag. Each row carries `deliverability` (bounce and complaint rates over the last 24 hours) and `series`, the last 14 days of daily email sends from the address, oldest first.
 	*/
 	static listSenders(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [
@@ -2286,9 +2297,9 @@ var Email = class {
 		});
 	}
 	/**
-	* Add a sender identity
+	* Add a sender
 	*
-	* Creates a sender identity. The required Idempotency-Key replays the original sender for an identical request and conflicts when reused with different input.
+	* Creates a sender. The required Idempotency-Key replays the original sender for an identical request and conflicts when reused with different input.
 	*/
 	static addSender(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [
@@ -2331,7 +2342,7 @@ var Email = class {
 	/**
 	* Check sender verification status
 	*
-	* Returns the current verification status of a sender identity.
+	* Returns the current verification status of a sender.
 	*/
 	static checkSenderVerification(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [{
@@ -2349,9 +2360,9 @@ var Email = class {
 		});
 	}
 	/**
-	* Remove a sender identity
+	* Remove a sender
 	*
-	* Accepts sender removal and marks the sender inactive. It reports the `deleting` lifecycle until removal finishes.
+	* Accepts sender removal and marks the sender inactive. A default sender can be removed when no other active sender remains in the organization. It reports the `deleting` lifecycle until removal finishes.
 	*/
 	static removeSender(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [{
@@ -2369,9 +2380,9 @@ var Email = class {
 		});
 	}
 	/**
-	* Get a sender identity
+	* Get a sender
 	*
-	* Returns one sender identity owned by the authenticated organization. Other organizations' ids are reported as not found.
+	* Returns one sender owned by the authenticated organization. Other organizations' ids are reported as not found.
 	*/
 	static getSender(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [{
@@ -4901,7 +4912,7 @@ var Unsubscribe = class {
 	/**
 	* List unsubscribe groups
 	*
-	* Returns a paginated list of the organization's unsubscribe groups.
+	* Returns a paginated list of the organization's unsubscribe groups, the default group first.
 	*/
 	static list(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [{
@@ -4952,7 +4963,7 @@ var Unsubscribe = class {
 	/**
 	* Delete an unsubscribe group
 	*
-	* Permanently deletes an unsubscribe group by its ID.
+	* Permanently deletes an unsubscribe group by its ID. The default group cannot be deleted; make another group the default first. A group a scheduled or running campaign uses cannot be deleted until that run finishes or is cancelled.
 	*/
 	static remove(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [{
@@ -5005,6 +5016,26 @@ var Unsubscribe = class {
 		});
 	}
 	/**
+	* Make an unsubscribe group the default
+	*
+	* Makes this group the organization's default: campaigns that name no group, and whose template and sending domain name none, unsubscribe recipients from it.
+	*/
+	static setDefault(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/unsubscribe-groups/{id}/default",
+			...options,
+			...params
+		});
+	}
+	/**
 	* Remove contacts from an unsubscribe group
 	*
 	* Removes one or more email addresses from an unsubscribe group and returns the number removed.
@@ -5338,6 +5369,10 @@ var Templates = class {
 				in: "query",
 				key: "search"
 			},
+			{
+				in: "query",
+				key: "projectId"
+			},
 			{
 				in: "query",
 				key: "sortBy"
@@ -5380,6 +5415,10 @@ var Templates = class {
 				in: "body",
 				key: "galleryTemplateId"
 			},
+			{
+				in: "body",
+				key: "useBrand"
+			},
 			{
 				in: "body",
 				key: "description"
@@ -5645,7 +5684,7 @@ var Templates = class {
 	/**
 	* Update a template
 	*
-	* Updates template metadata. Source changes use the project workspace API.
+	* Updates template metadata. Setting `entryPath` points the template at another file in its project and keeps its id, slug, and publications; move the file in Git separately. Source changes use the project workspace API.
 	*/
 	static update(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [{
@@ -5671,6 +5710,53 @@ var Templates = class {
 		});
 	}
 	/**
+	* Add a template entry
+	*
+	* Registers a `.tsx` file under `templates/` or `emails/` in an existing template project as its own template and returns it with status 201. The file does not need to exist yet; publishing fails until a commit contains it. Repeating the call with the same entry path, name, and slug returns the existing template.
+	*/
+	static addEntry(parameters, options) {
+		const params = buildClientParams([parameters], [{ args: [
+			{
+				in: "path",
+				key: "projectId"
+			},
+			{
+				in: "body",
+				key: "entryPath"
+			},
+			{
+				in: "body",
+				key: "name"
+			},
+			{
+				in: "body",
+				key: "slug"
+			},
+			{
+				in: "body",
+				key: "description"
+			},
+			{
+				in: "body",
+				key: "category"
+			}
+		] }]);
+		return (options?.client ?? client).post({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/templates/projects/{projectId}/entries",
+			...options,
+			...params,
+			headers: {
+				"Content-Type": "application/json",
+				...options?.headers,
+				...params.headers
+			}
+		});
+	}
+	/**
 	* Patch template project files
 	*
 	* Applies revision-checked file patches to the shared project workspace overlay.
@@ -5758,6 +5844,53 @@ var Templates = class {
 		});
 	}
 	/**
+	* Put a template project asset
+	*
+	* Writes one image or font (png, jpg, jpeg, gif, webp, or woff2) into the shared project workspace as an unsaved file; Save commits it. The JSON body carries the file as canonical base64 in `contentBase64`, at most 1 MiB decoded, and the bytes must match the extension in `path`. `replace` must be `false` to add a new file and `true` to change an existing one.
+	*/
+	static putWorkspaceAsset(parameters, options) {
+		const params = buildClientParams([parameters], [{ args: [
+			{
+				in: "path",
+				key: "id"
+			},
+			{
+				in: "body",
+				key: "expectedRevision"
+			},
+			{
+				in: "body",
+				key: "path"
+			},
+			{
+				in: "body",
+				key: "contentBase64"
+			},
+			{
+				in: "body",
+				key: "replace"
+			},
+			{
+				in: "body",
+				key: "idempotencyKey"
+			}
+		] }]);
+		return (options?.client ?? client).put({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/templates/{id}/workspace/assets",
+			...options,
+			...params,
+			headers: {
+				"Content-Type": "application/json",
+				...options?.headers,
+				...params.headers
+			}
+		});
+	}
+	/**
 	* Reconcile a template project workspace
 	*
 	* Fast-forwards or rebases the workspace onto the latest saved version, retaining file conflicts for explicit resolution.
@@ -6014,7 +6147,7 @@ var Templates = class {
 	/**
 	* Publish an exact template commit
 	*
-	* Builds an exact Git commit and entry path, stores the immutable executable and its assets, records the input contract it validates against, and makes that publication current.
+	* Builds an exact Git commit and entry path, stores the immutable compiled IR and its assets, records the input contract it validates against, and makes that publication current.
 	*/
 	static publish(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [
@@ -6037,6 +6170,10 @@ var Templates = class {
 			{
 				in: "body",
 				key: "expectedWorkspaceRevision"
+			},
+			{
+				in: "body",
+				key: "ifCurrentPublicationId"
 			}
 		] }]);
 		return (options?.client ?? client).post({
@@ -6247,38 +6384,147 @@ var Templates = class {
 		});
 	}
 };
-var Design = class {
+var Brands = class {
 	/**
-	* Get the organization design
+	* List brands
 	*
-	* Returns the organization's configured email design kit (theme, assets, footer), or null when none is set.
+	* Returns the organization's brands, the default brand first.
 	*/
-	static get(options) {
+	static list(options) {
 		return (options?.client ?? client).get({
 			security: [{
 				name: "x-api-key",
 				type: "apiKey"
 			}],
-			url: "/v1/design",
+			url: "/v1/brands",
 			...options
 		});
 	}
 	/**
-	* Update the organization design
+	* Create a brand
 	*
-	* Validates and saves the organization's email design kit; a null body clears the design back to the base design floor.
+	* Creates a brand. The CSS must parse as a brand theme; a rejected theme answers 422 with located findings under `fields.css`. With `isDefault`, the new brand becomes the default. An organization holds at most 12 brands; creating one more answers 409 with a `ConflictError`.
 	*/
-	static update(parameters, options) {
+	static create(parameters, options) {
+		const params = buildClientParams([parameters], [{ args: [
+			{
+				in: "body",
+				key: "slug"
+			},
+			{
+				in: "body",
+				key: "name"
+			},
+			{
+				in: "body",
+				key: "css"
+			},
+			{
+				in: "body",
+				key: "assets"
+			},
+			{
+				in: "body",
+				key: "footer"
+			},
+			{
+				in: "body",
+				key: "isDefault"
+			}
+		] }]);
+		return (options?.client ?? client).post({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/brands",
+			...options,
+			...params,
+			headers: {
+				"Content-Type": "application/json",
+				...options?.headers,
+				...params.headers
+			}
+		});
+	}
+	/**
+	* Delete a brand
+	*
+	* Deletes a brand. The default brand cannot be deleted; domains that used the deleted brand fall back to the default.
+	*/
+	static remove(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [{
-			in: "body",
-			key: "design"
+			in: "path",
+			key: "slug"
 		}] }]);
-		return (options?.client ?? client).put({
+		return (options?.client ?? client).delete({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/brands/{slug}",
+			...options,
+			...params
+		});
+	}
+	/**
+	* Get a brand
+	*
+	* Returns one brand by its slug.
+	*/
+	static get(parameters, options) {
+		const params = buildClientParams([parameters], [{ args: [{
+			in: "path",
+			key: "slug"
+		}] }]);
+		return (options?.client ?? client).get({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/brands/{slug}",
+			...options,
+			...params
+		});
+	}
+	/**
+	* Update a brand
+	*
+	* Updates a brand. Each section given replaces that section whole. Published templates keep the brand they were built against until they are republished.
+	*/
+	static update(parameters, options) {
+		const params = buildClientParams([parameters], [{ args: [
+			{
+				in: "path",
+				key: "slug"
+			},
+			{
+				in: "body",
+				key: "newSlug"
+			},
+			{
+				in: "body",
+				key: "name"
+			},
+			{
+				in: "body",
+				key: "css"
+			},
+			{
+				in: "body",
+				key: "assets"
+			},
+			{
+				in: "body",
+				key: "footer"
+			}
+		] }]);
+		return (options?.client ?? client).patch({
 			security: [{
 				name: "x-api-key",
 				type: "apiKey"
 			}],
-			url: "/v1/design",
+			url: "/v1/brands/{slug}",
 			...options,
 			...params,
 			headers: {
@@ -6288,6 +6534,26 @@ var Design = class {
 			}
 		});
 	}
+	/**
+	* Make a brand the default
+	*
+	* Makes this brand the organization's default: bare `samva:brand` and domains without a brand resolve to it at their next build or send.
+	*/
+	static setDefault(parameters, options) {
+		const params = buildClientParams([parameters], [{ args: [{
+			in: "path",
+			key: "slug"
+		}] }]);
+		return (options?.client ?? client).post({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/brands/{slug}/default",
+			...options,
+			...params
+		});
+	}
 };
 var Webhooks = class {
 	/**
@@ -6624,7 +6890,7 @@ var Organizations = class {
 	/**
 	* Update the current organization
 	*
-	* Updates the current organization's profile, regional defaults, design, reply-to, and unsubscribe-group defaults and returns the saved organization. `metadata` and `design` are merged into the stored values; every other field is replaced.
+	* Updates the current organization's profile, regional defaults, and reply-to default and returns the saved organization. `metadata` is merged into the stored value; every other field is replaced.
 	*/
 	static update(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [
@@ -6652,18 +6918,10 @@ var Organizations = class {
 				in: "body",
 				key: "metadata"
 			},
-			{
-				in: "body",
-				key: "design"
-			},
 			{
 				in: "body",
 				key: "replyToDefault"
 			},
-			{
-				in: "body",
-				key: "defaultUnsubscribeGroupId"
-			},
 			{
 				in: "body",
 				key: "emailFooterEnabledDefault"
@@ -6685,6 +6943,21 @@ var Organizations = class {
 		});
 	}
 	/**
+	* Get the current account profile
+	*
+	* Returns your identity in the organization authorized by your credential. The ID remains stable across reconnects and display-name changes. Removing and re-adding your membership creates a new ID.
+	*/
+	static getProfile(options) {
+		return (options?.client ?? client).get({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/organizations/current/profile",
+			...options
+		});
+	}
+	/**
 	* Get organization usage
 	*
 	* Returns usage statistics for the current organization over the selected reporting period.
@@ -7026,6 +7299,20 @@ var BillingProviderError = class extends SamvaApiError {
 		Object.assign(this, payload);
 	}
 };
+var BrandAddressRequiredError = class extends SamvaApiError {
+	_tag = "BrandAddressRequiredError";
+	constructor(payload, context = {}) {
+		super(messageOf("BrandAddressRequiredError", payload), context);
+		Object.assign(this, payload);
+	}
+};
+var CampaignFooterRequiredError = class extends SamvaApiError {
+	_tag = "CampaignFooterRequiredError";
+	constructor(payload, context = {}) {
+		super(messageOf("CampaignFooterRequiredError", payload), context);
+		Object.assign(this, payload);
+	}
+};
 var ConflictError = class extends SamvaApiError {
 	_tag = "ConflictError";
 	constructor(payload, context = {}) {
@@ -7127,6 +7414,8 @@ var ValidationError = class extends SamvaApiError {
 const constructors = {
 	AnalyticsQueryError,
 	BillingProviderError,
+	BrandAddressRequiredError,
+	CampaignFooterRequiredError,
 	ConflictError,
 	DeliveryUnavailableError,
 	EmailChannelError,
@@ -7169,6 +7458,35 @@ const payloadSchemas = {
 		"x-category": ["transient"],
 		"x-retryable": true
 	},
+	BrandAddressRequiredError: {
+		type: "object",
+		properties: {
+			_tag: {
+				type: "string",
+				enum: ["BrandAddressRequiredError"]
+			},
+			message: { type: "string" },
+			brand: { anyOf: [{ type: "string" }, { type: "null" }] }
+		},
+		required: [
+			"_tag",
+			"message",
+			"brand"
+		],
+		additionalProperties: false
+	},
+	CampaignFooterRequiredError: {
+		type: "object",
+		properties: {
+			_tag: {
+				type: "string",
+				enum: ["CampaignFooterRequiredError"]
+			},
+			message: { type: "string" }
+		},
+		required: ["_tag", "message"],
+		additionalProperties: false
+	},
 	ConflictError: {
 		type: "object",
 		properties: {
@@ -7332,8 +7650,7 @@ const payloadSchemas = {
 				enum: [
 					"undecided",
 					"approved",
-					"rejected",
-					"exempt"
+					"rejected"
 				]
 			},
 			stage: {
@@ -7501,6 +7818,13 @@ function fromApiError(error, context = {}) {
 		const Constructor = constructors[tag];
 		return new Constructor(error, context);
 	}
+	if (context.response?.status === 504) {
+		const retryAfter = Number(context.response.headers.get("retry-after"));
+		return new GatewayTimeoutError({
+			message: "The request did not finish in time. Retry with the same idempotency key.",
+			retryAfterSeconds: Number.isInteger(retryAfter) && retryAfter > 0 ? retryAfter : 1
+		}, context);
+	}
 	return new SamvaTransportError(error, context);
 }
 //#endregion
@@ -7664,13 +7988,13 @@ function createClient(config) {
 		client: clientInstance,
 		messages: createBoundService(Messages, clientInstance),
 		scheduledMessages: createBoundService(ScheduledMessages, clientInstance),
+		brands: createBoundService(Brands, clientInstance),
 		campaigns: createBoundService(Campaigns, clientInstance),
 		email: createBoundService(Email, clientInstance),
 		media: createBoundService(Media, clientInstance),
 		templates: createPromiseTemplatesTransport(clientInstance),
 		contacts: createBoundService(Contacts, clientInstance),
 		conversations: createBoundService(Conversations, clientInstance),
-		design: createBoundService(Design, clientInstance),
 		webhooks: createBoundService(Webhooks, clientInstance),
 		operations: createBoundService(Operations, clientInstance),
 		apiKeys: createBoundService(ApiKeys, clientInstance),
@@ -7687,13 +8011,13 @@ function createClient(config) {
 		raw,
 		messages: createDirectService(promiseMessages),
 		scheduledMessages: createDirectService(raw.scheduledMessages),
+		brands: createDirectService(raw.brands),
 		campaigns: createDirectService(raw.campaigns),
 		email: createDirectService(promiseEmail),
 		media: createDirectService(raw.media),
 		templates: createDirectService(raw.templates),
 		contacts: createDirectService(raw.contacts),
 		conversations: createDirectService(raw.conversations),
-		design: createDirectService(raw.design),
 		webhooks: createDirectService(raw.webhooks),
 		operations: createDirectService(raw.operations),
 		apiKeys: createDirectService(raw.apiKeys),
@@ -7706,6 +8030,6 @@ function createClient(config) {
 	};
 }
 //#endregion
-export { SamvaTransportError as _, DeliveryUnavailableError as a, fromApiError as b, FlagDisabledError as c, InternalError as d, OnboardingReviewRequiredError as f, SamvaApiError as g, ResourceNotFoundError as h, ConflictError as i, ForbiddenError as l, RateLimitedError as m, AnalyticsQueryError as n, EmailChannelError as o, PaymentRequiredError as p, BillingProviderError as r, ExternalServiceError as s, createClient as t, GatewayTimeoutError as u, UnauthorizedError as v, ValidationError as y };
+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 };
 
-//# sourceMappingURL=promises-8MaPNAam.js.map
+//# sourceMappingURL=promises-DAv8ZtOX.js.map