samva 0.4.0 → 0.5.0

package/dist/{promises-n1opem5V.js → promises-CP_nxUus.js}

@@ -1,4 +1,4 @@
-import { n as clientAttribution, t as CLIENT_ATTRIBUTION_HEADER } from "./client-attribution-BslSOa_8.js";
+import { n as clientAttribution, t as CLIENT_ATTRIBUTION_HEADER } from "./client-attribution-B2yJBXdZ.js";
 import { n as buildMessagesSendPayload, r as replyToEmailsPayload, t as buildEmailSendPayload } from "./normalize-BiIJnycv.js";
 //#region src/client/core/bodySerializer.gen.ts
 const jsonBodySerializer = { bodySerializer: (body) => JSON.stringify(body, (_key, value) => typeof value === "bigint" ? value.toString() : value) };
@@ -671,14 +671,14 @@ const createClient$1 = (config = {}) => {
 };
 //#endregion
 //#region src/client/client.gen.ts
-const client = createClient$1(createConfig());
+const client = createClient$1(createConfig({ baseUrl: "https://api.samva.dev" }));
 //#endregion
 //#region src/client/sdk.gen.ts
 var Messages = class {
 	/**
 	* List messages
 	*
-	* Returns a paginated list of messages across all channels, with optional filters for channel, direction, status, conversation, contact, and date range.
+	* Returns a paginated list of messages, with optional filters for channel, direction, status, conversation, contact, and date range.
 	*/
 	static list(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [
@@ -828,6 +828,61 @@ var Messages = class {
 		});
 	}
 	/**
+	* Validate an email message
+	*
+	* Resolves recipients, sender, and inline or published-template content without creating contacts, messages, billing reservations, quota draws, queue work, or provider calls.
+	*/
+	static validateEmail(parameters, options) {
+		const params = buildClientParams([parameters], [{ args: [
+			{
+				in: "body",
+				key: "conversationId"
+			},
+			{
+				in: "body",
+				key: "metadata"
+			},
+			{
+				in: "body",
+				key: "channel"
+			},
+			{
+				in: "body",
+				key: "to"
+			},
+			{
+				in: "body",
+				key: "cc"
+			},
+			{
+				in: "body",
+				key: "bcc"
+			},
+			{
+				in: "body",
+				key: "from"
+			},
+			{
+				in: "body",
+				key: "email"
+			}
+		] }]);
+		return (options?.client ?? client).post({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/messages/validate/email",
+			...options,
+			...params,
+			headers: {
+				"Content-Type": "application/json",
+				...options?.headers,
+				...params.headers
+			}
+		});
+	}
+	/**
 	* Get message delivery status
 	*
 	* Returns the current delivery status of a message by its ID.
@@ -1058,6 +1113,34 @@ var ScheduledMessages = class {
 			...params
 		});
 	}
+	/**
+	* Resume a review-paused scheduled message
+	*
+	* Explicitly resumes a scheduled message after onboarding review clearance. An overdue message requires either send_now or a new future scheduledFor value.
+	*/
+	static resume(parameters, options) {
+		const params = buildClientParams([parameters], [{ args: [{
+			in: "path",
+			key: "id"
+		}, {
+			key: "body",
+			map: "body"
+		}] }]);
+		return (options?.client ?? client).post({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/messages/scheduled/{id}/resume",
+			...options,
+			...params,
+			headers: {
+				"Content-Type": "application/json",
+				...options?.headers,
+				...params.headers
+			}
+		});
+	}
 };
 var Campaigns = class {
 	/**
@@ -1417,6 +1500,81 @@ var Campaigns = class {
 	}
 };
 var Email = class {
+	/**
+	* Get email onboarding review status
+	*
+	* Returns the customer-safe workspace review decision, workflow stage, next action, and current sending-identity clearances. A missing authority row is returned as a blocked initial state.
+	*/
+	static getOnboardingReview(options) {
+		return (options?.client ?? client).get({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/email/onboarding-review",
+			...options
+		});
+	}
+	/**
+	* Reapply for email onboarding review
+	*
+	* Allows a workspace owner or admin to submit a rejected workspace for review again. The expected generation prevents acting on stale status.
+	*/
+	static reapplyOnboardingReview(parameters, options) {
+		const params = buildClientParams([parameters], [{ args: [{
+			in: "body",
+			key: "expectedGeneration"
+		}] }]);
+		return (options?.client ?? client).post({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/email/onboarding-review/reapply",
+			...options,
+			...params,
+			headers: {
+				"Content-Type": "application/json",
+				...options?.headers,
+				...params.headers
+			}
+		});
+	}
+	/**
+	* Respond to an email onboarding information request
+	*
+	* Allows workspace owners and admins to submit bounded text and up to three pending-scanned evidence uploads for the current review generation.
+	*/
+	static respondToOnboardingInformationRequest(parameters, options) {
+		const params = buildClientParams([parameters], [{ args: [
+			{
+				in: "body",
+				key: "expectedGeneration"
+			},
+			{
+				in: "body",
+				key: "responseText"
+			},
+			{
+				in: "body",
+				key: "evidenceMediaIds"
+			}
+		] }]);
+		return (options?.client ?? client).post({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/email/onboarding-review/respond",
+			...options,
+			...params,
+			headers: {
+				"Content-Type": "application/json",
+				...options?.headers,
+				...params.headers
+			}
+		});
+	}
 	/**
 	* Get email tracking defaults
 	*
@@ -1600,6 +1758,29 @@ var Email = class {
 		});
 	}
 	/**
+	* Stage a DKIM selector rotation
+	*
+	* Creates encrypted signing custody and returns a new public DKIM record. Publish it, then advance domain verification to cut over. Retain the former record until separately approved retirement.
+	*/
+	static rotateDomainDkim(parameters, options) {
+		const params = buildClientParams([parameters], [{ args: [{
+			in: "headers",
+			key: "idempotency-key"
+		}, {
+			in: "path",
+			key: "id"
+		}] }]);
+		return (options?.client ?? client).post({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/email/domains/{id}/dkim-rotation",
+			...options,
+			...params
+		});
+	}
+	/**
 	* Remove a sending domain
 	*
 	* Permanently deletes a sending domain from the organization.
@@ -2176,6 +2357,26 @@ var Email = class {
 		});
 	}
 	/**
+	* Get a sender identity
+	*
+	* Returns one sender identity owned by the authenticated organization. Other organizations' ids are reported as not found.
+	*/
+	static getSender(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/senders/{id}",
+			...options,
+			...params
+		});
+	}
+	/**
 	* Set the organization default sender
 	*
 	* Marks a verified, active sender as the organization default, atomically clearing any previous default. Used for omitted-`from` sends when no default domain sender applies.
@@ -2848,6 +3049,215 @@ var Email = class {
 			...params
 		});
 	}
+	/**
+	* Get domain warming
+	*
+	* Returns the domain's automated warming policy, its system-created 24-hour windows and policy snapshots, the rolling bounce and complaint window the safety rule reads, every pause above the plan, and the decision history. A domain without a plan returns the evidence and a null plan.
+	*/
+	static getDomainWarming(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}/warming",
+			...options,
+			...params
+		});
+	}
+	/**
+	* Start domain warming
+	*
+	* Starts an automated warming policy on a verified sending domain. Samva opens the first 24-hour campaign window immediately, then opens later windows from the saved growth policy after safe windows close. Direct sends are counted in the domain's window but never delayed. Responds with 201.
+	*/
+	static createDomainWarmingPlan(parameters, options) {
+		const params = buildClientParams([parameters], [{ args: [
+			{
+				in: "path",
+				key: "id"
+			},
+			{
+				in: "body",
+				key: "identity"
+			},
+			{
+				in: "body",
+				key: "initialDailyRecipients"
+			},
+			{
+				in: "body",
+				key: "dailyGrowthPercent"
+			},
+			{
+				in: "body",
+				key: "targetDailyRecipients"
+			}
+		] }]);
+		return (options?.client ?? client).post({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/email/domains/{id}/warming",
+			...options,
+			...params,
+			headers: {
+				"Content-Type": "application/json",
+				...options?.headers,
+				...params.headers
+			}
+		});
+	}
+	/**
+	* Update domain warming policy
+	*
+	* Updates the growth percentage and daily target Samva uses for future 24-hour warming windows. Existing windows keep their policy snapshot, including a scheduled window, so prior authorization remains auditable.
+	*/
+	static updateDomainWarmingPolicy(parameters, options) {
+		const params = buildClientParams([parameters], [{ args: [
+			{
+				in: "path",
+				key: "id"
+			},
+			{
+				in: "body",
+				key: "dailyGrowthPercent"
+			},
+			{
+				in: "body",
+				key: "targetDailyRecipients"
+			},
+			{
+				in: "body",
+				key: "note"
+			}
+		] }]);
+		return (options?.client ?? client).patch({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/email/domains/{id}/warming/policy",
+			...options,
+			...params,
+			headers: {
+				"Content-Type": "application/json",
+				...options?.headers,
+				...params.headers
+			}
+		});
+	}
+	/**
+	* Cancel a warming window
+	*
+	* Cancels a scheduled or open system-created warming window. Recipients a campaign run already reserved from it stay reserved; no further runs draw from it.
+	*/
+	static cancelDomainWarmingBatch(parameters, options) {
+		const params = buildClientParams([parameters], [{ args: [{
+			in: "path",
+			key: "id"
+		}, {
+			in: "path",
+			key: "batchId"
+		}] }]);
+		return (options?.client ?? client).delete({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/email/domains/{id}/warming/batches/{batchId}",
+			...options,
+			...params
+		});
+	}
+	/**
+	* Pause domain warming
+	*
+	* Pauses the plan. Campaign runs from the domain stop at their next page and queued campaign email waits until it expires; direct sends are unaffected.
+	*/
+	static pauseDomainWarming(parameters, options) {
+		const params = buildClientParams([parameters], [{ args: [{
+			in: "path",
+			key: "id"
+		}, {
+			in: "body",
+			key: "note"
+		}] }]);
+		return (options?.client ?? client).post({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/email/domains/{id}/warming/pause",
+			...options,
+			...params,
+			headers: {
+				"Content-Type": "application/json",
+				...options?.headers,
+				...params.headers
+			}
+		});
+	}
+	/**
+	* Resume domain warming
+	*
+	* Resumes a paused or held plan and the campaign runs it was holding. A plan the domain rule held resumes only once the domain's rolling window is under both limits again; until then the request is refused with the observed rate.
+	*/
+	static resumeDomainWarming(parameters, options) {
+		const params = buildClientParams([parameters], [{ args: [{
+			in: "path",
+			key: "id"
+		}, {
+			in: "body",
+			key: "note"
+		}] }]);
+		return (options?.client ?? client).post({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/email/domains/{id}/warming/resume",
+			...options,
+			...params,
+			headers: {
+				"Content-Type": "application/json",
+				...options?.headers,
+				...params.headers
+			}
+		});
+	}
+	/**
+	* Complete domain warming
+	*
+	* Ends the policy. Campaign runs from the domain are no longer gated by warming windows; the workspace safeguards still apply.
+	*/
+	static completeDomainWarming(parameters, options) {
+		const params = buildClientParams([parameters], [{ args: [{
+			in: "path",
+			key: "id"
+		}, {
+			in: "body",
+			key: "note"
+		}] }]);
+		return (options?.client ?? client).post({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/email/domains/{id}/warming/complete",
+			...options,
+			...params,
+			headers: {
+				"Content-Type": "application/json",
+				...options?.headers,
+				...params.headers
+			}
+		});
+	}
 };
 var Media = class {
 	/**
@@ -4960,7 +5370,7 @@ var Webhooks = class {
 	/**
 	* List webhooks
 	*
-	* Returns a paginated list of the organization's webhook endpoints, optionally filtered by a name search.
+	* Returns a paginated list of the organization's webhook endpoints with each endpoint's delivery counts, optionally filtered by name search and status.
 	*/
 	static list(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [
@@ -4975,6 +5385,10 @@ var Webhooks = class {
 			{
 				in: "query",
 				key: "search"
+			},
+			{
+				in: "query",
+				key: "status"
 			}
 		] }]);
 		return (options?.client ?? client).get({
@@ -5156,7 +5570,7 @@ var Webhooks = class {
 	/**
 	* List webhook delivery logs
 	*
-	* Returns recent deliveries and their nested attempt diagnostics for a webhook endpoint.
+	* Returns recent deliveries for a webhook endpoint, each naming the event type and time it was made for, with its nested attempt diagnostics.
 	*/
 	static getLogs(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [{
@@ -5179,12 +5593,15 @@ var Webhooks = class {
 	/**
 	* Get webhook delivery statistics
 	*
-	* Returns aggregate pending, delivered, exhausted, and cancelled delivery counts for a webhook endpoint.
+	* Returns aggregate pending, delivered, exhausted, and cancelled delivery counts for a webhook endpoint, plus the same counts per workspace-local calendar day over the selected period of 7, 30, or 90 days. Deliveries are retained for 90 days, so 90d is the whole history.
 	*/
 	static getStats(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [{
 			in: "path",
 			key: "webhookId"
+		}, {
+			in: "query",
+			key: "period"
 		}] }]);
 		return (options?.client ?? client).get({
 			security: [{
@@ -5754,6 +6171,13 @@ var InternalError = class extends SamvaApiError {
 		Object.assign(this, payload);
 	}
 };
+var OnboardingReviewRequiredError = class extends SamvaApiError {
+	_tag = "OnboardingReviewRequiredError";
+	constructor(payload, context = {}) {
+		super(messageOf("OnboardingReviewRequiredError", payload), context);
+		Object.assign(this, payload);
+	}
+};
 var PaymentRequiredError = class extends SamvaApiError {
 	_tag = "PaymentRequiredError";
 	constructor(payload, context = {}) {
@@ -5804,6 +6228,7 @@ const constructors = {
 	FlagDisabledError,
 	ForbiddenError,
 	InternalError,
+	OnboardingReviewRequiredError,
 	PaymentRequiredError,
 	RateLimitedError,
 	ResourceNotFoundError,
@@ -5956,6 +6381,69 @@ const payloadSchemas = {
 		"x-category": ["transient"],
 		"x-retryable": true
 	},
+	OnboardingReviewRequiredError: {
+		type: "object",
+		properties: {
+			_tag: {
+				type: "string",
+				enum: ["OnboardingReviewRequiredError"]
+			},
+			operation: { type: "string" },
+			code: {
+				type: "string",
+				enum: [
+					"review_required",
+					"review_in_progress",
+					"information_required",
+					"review_rejected",
+					"identity_review_required",
+					"identity_review_rejected",
+					"identity_changed"
+				]
+			},
+			decision: {
+				type: "string",
+				enum: [
+					"undecided",
+					"approved",
+					"rejected",
+					"exempt"
+				]
+			},
+			stage: {
+				type: "string",
+				enum: [
+					"collecting",
+					"automated_review",
+					"manual_review",
+					"information_requested",
+					"complete"
+				]
+			},
+			nextAction: {
+				type: "string",
+				enum: [
+					"wait_for_review",
+					"provide_information",
+					"verify_sending_identity",
+					"reapply",
+					"contact_support"
+				]
+			},
+			identityId: { anyOf: [{ type: "string" }, { type: "null" }] }
+		},
+		required: [
+			"_tag",
+			"operation",
+			"code",
+			"decision",
+			"stage",
+			"nextAction"
+		],
+		additionalProperties: false,
+		"x-category": ["validation"],
+		"x-retryable": false
+	},
 	PaymentRequiredError: {
 		type: "object",
 		properties: {
@@ -6110,8 +6598,10 @@ const matchesSchema = (value, schema) => {
 	if (schema.required?.some((key) => !Object.hasOwn(value, key)) === true) return false;
 	const properties = schema.properties ?? {};
 	for (const [key, propertySchema] of Object.entries(properties)) if (Object.hasOwn(value, key) && !matchesSchema(value[key], propertySchema)) return false;
-	if (typeof schema.additionalProperties === "object") {
-		for (const [key, propertyValue] of Object.entries(value)) if (!(key in properties) && !matchesSchema(propertyValue, schema.additionalProperties)) return false;
+	if (schema.additionalProperties === false) {
+		if (Object.keys(value).some((key) => !Object.hasOwn(properties, key))) return false;
+	} else if (typeof schema.additionalProperties === "object") {
+		for (const [key, propertyValue] of Object.entries(value)) if (!Object.hasOwn(properties, key) && !matchesSchema(propertyValue, schema.additionalProperties)) return false;
 	}
 	return true;
 };
@@ -6119,7 +6609,7 @@ const matchesSchema = (value, schema) => {
 function fromApiError(error, context = {}) {
 	if (error instanceof SamvaApiError) return error;
 	if (error instanceof SamvaTransportError) return error;
-	if (isRecord(error) && typeof error._tag === "string" && error._tag in constructors) {
+	if (isRecord(error) && typeof error._tag === "string" && Object.hasOwn(constructors, error._tag)) {
 		const tag = error._tag;
 		if (!matchesSchema(error, payloadSchemas[tag])) return new SamvaTransportError(error, context);
 		const Constructor = constructors[tag];
@@ -6167,6 +6657,7 @@ function createPromiseMessagesTransport(clientInstance) {
 		getEmail: boundMessages.getEmail,
 		getStatus: boundMessages.getStatus,
 		getEvents: boundMessages.getEvents,
+		validateEmail: boundMessages.validateEmail,
 		send: (input, options) => Messages.send({ emailSendMessagePayload: buildMessagesSendPayload(input) }, {
 			...options,
 			client: clientInstance
@@ -6294,6 +6785,6 @@ 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 };
+export { WebhookEnqueueError as _, ExternalServiceError as a, InternalError as c, RateLimitedError as d, ResourceNotFoundError as f, ValidationError as g, UnauthorizedError as h, EmailChannelError as i, OnboardingReviewRequiredError as l, SamvaTransportError as m, BillingProviderError as n, FlagDisabledError as o, SamvaApiError as p, ConflictError as r, ForbiddenError as s, createClient as t, PaymentRequiredError as u, fromApiError as v };
 
-//# sourceMappingURL=promises-n1opem5V.js.map
+//# sourceMappingURL=promises-CP_nxUus.js.map