samva 0.2.0 → 0.3.0

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

@@ -1,4 +1,4 @@
-import { n as buildMessagesSendPayload, r as replyToEmailsPayload, t as buildEmailSendPayload } from "./normalize-LkWl4HUF.js";
+import { n as buildMessagesSendPayload, r as replyToEmailsPayload, t as buildEmailSendPayload } from "./normalize-BKFjbR9t.js";
 //#region src/client/core/bodySerializer.gen.ts
 const jsonBodySerializer = { bodySerializer: (body) => JSON.stringify(body, (_key, value) => typeof value === "bigint" ? value.toString() : value) };
 //#endregion
@@ -45,18 +45,20 @@ function buildClientParams(args, fields) {
 	for (const [index, arg] of args.entries()) {
 		if (fields[index]) config = fields[index];
 		if (!config) continue;
-		if ("in" in config) if (config.key) {
-			const field = map.get(config.key);
-			const name = field.map || config.key;
-			if (field.in) writeSlot(field.in, name, arg);
-		} else params.body = arg;
-		else for (const [key, value] of Object.entries(arg ?? {})) {
+		if ("in" in config) {
+			if (config.key) {
+				const field = map.get(config.key);
+				const name = field.map || config.key;
+				if (field.in) writeSlot(field.in, name, arg);
+			} else params.body = arg;
+		} else for (const [key, value] of Object.entries(arg ?? {})) {
 			const field = map.get(key);
-			if (field) if (field.in) {
-				const name = field.map || key;
-				writeSlot(field.in, name, value);
-			} else params[field.map] = value;
-			else {
+			if (field) {
+				if (field.in) {
+					const name = field.map || key;
+					writeSlot(field.in, name, value);
+				} else params[field.map] = value;
+			} else {
 				const extra = extraPrefixes.find(([prefix]) => key.startsWith(prefix));
 				if (extra) {
 					const [prefix, slot] = extra;
@@ -725,14 +727,14 @@ var Messages = class {
 	/**
 	* Send a message
 	*
-	* Sends a message on the requested channel and returns the created message with a 201 Created status. `channel` selects the payload variant. Email sends today; the SMS and WhatsApp variants are coming soon and answer 403 until the channel launches for your organization, so integrating against them now costs no rewrite later. Repeating an identical request with the same optional `Idempotency-Key` header returns the original message; reusing the key for different content returns a conflict.
+	* Sends a message on the requested channel and returns the created message with a 201 Created status. `channel` selects the payload variant. Repeating an identical request with the same optional `Idempotency-Key` header returns the original message; reusing the key for different content returns a conflict.
 	*/
 	static send(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [{
 			in: "headers",
 			key: "idempotency-key"
 		}, {
-			key: "body",
+			key: "emailSendMessagePayload",
 			map: "body"
 		}] }]);
 		return (options?.client ?? client).post({
@@ -793,7 +795,7 @@ var Messages = class {
 	/**
 	* Get email message details
 	*
-	* Returns the email projection of a message, optionally including signed S3 URLs for its raw MIME, HTML, and text content.
+	* Returns email delivery details for a message, optionally including signed URLs for its raw MIME, HTML, and text content.
 	*/
 	static getEmail(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [
@@ -971,7 +973,7 @@ var ScheduledMessages = class {
 	/**
 	* Schedule a message
 	*
-	* Schedules a message at the absolute ISO-8601 instant in scheduledFor. The send payload is the same channel union the immediate send accepts, with each channel's content checked at schedule time so a send that could never render fails now rather than hours later: email schedules today, and the SMS and WhatsApp variants are coming soon and answer 403 until the channel launches. Optional timezone is validated IANA display metadata only and never changes the execution instant.
+	* Schedules a message at the absolute ISO-8601 instant in scheduledFor. Optional timezone is validated IANA display metadata only and never changes the execution instant.
 	*/
 	static create(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [
@@ -2835,6 +2837,131 @@ var Email = class {
 		});
 	}
 };
+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.
+	*/
+	static create(parameters, options) {
+		const params = buildClientParams([parameters], [{ args: [
+			{
+				in: "body",
+				key: "filename"
+			},
+			{
+				in: "body",
+				key: "contentType"
+			},
+			{
+				in: "body",
+				key: "sizeBytes"
+			},
+			{
+				in: "body",
+				key: "purpose"
+			},
+			{
+				in: "body",
+				key: "checksumSha256"
+			}
+		] }]);
+		return (options?.client ?? client).post({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/media",
+			...options,
+			...params,
+			headers: {
+				"Content-Type": "application/json",
+				...options?.headers,
+				...params.headers
+			}
+		});
+	}
+	/**
+	* Complete a media upload
+	*
+	* Verifies the uploaded object exists in storage, marks the media object ready, and returns it with a download URL.
+	*/
+	static complete(parameters, options) {
+		const params = buildClientParams([parameters], [{ args: [{
+			in: "path",
+			key: "mediaId"
+		}] }]);
+		return (options?.client ?? client).post({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/media/{mediaId}/complete",
+			...options,
+			...params
+		});
+	}
+	/**
+	* Delete a media object
+	*
+	* Deletes a pending media object and the bytes stored for it. Fails if the media object is already ready.
+	*/
+	static remove(parameters, options) {
+		const params = buildClientParams([parameters], [{ args: [{
+			in: "path",
+			key: "mediaId"
+		}] }]);
+		return (options?.client ?? client).delete({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/media/{mediaId}",
+			...options,
+			...params
+		});
+	}
+	/**
+	* Get a media object
+	*
+	* Returns the media object's metadata, including status, dimensions, and confirmation timestamps.
+	*/
+	static getById(parameters, options) {
+		const params = buildClientParams([parameters], [{ args: [{
+			in: "path",
+			key: "mediaId"
+		}] }]);
+		return (options?.client ?? client).get({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/media/{mediaId}",
+			...options,
+			...params
+		});
+	}
+	/**
+	* Get a media download URL
+	*
+	* Generates a presigned, time-limited download URL for a ready media object.
+	*/
+	static downloadUrl(parameters, options) {
+		const params = buildClientParams([parameters], [{ args: [{
+			in: "path",
+			key: "mediaId"
+		}] }]);
+		return (options?.client ?? client).get({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/media/{mediaId}/url",
+			...options,
+			...params
+		});
+	}
+};
 var Conversations = class {
 	/**
 	* List conversations
@@ -3340,7 +3467,7 @@ var Contacts = class {
 	/**
 	* Find a contact
 	*
-	* Looks up a single contact by email, phone, WhatsApp, or external ID, returning null when no contact matches.
+	* Samva API operation.
 	*/
 	static find(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [
@@ -3352,10 +3479,6 @@ var Contacts = class {
 				in: "body",
 				key: "phone"
 			},
-			{
-				in: "body",
-				key: "whatsapp"
-			},
 			{
 				in: "body",
 				key: "externalId"
@@ -3391,10 +3514,6 @@ var Contacts = class {
 				in: "body",
 				key: "phone"
 			},
-			{
-				in: "body",
-				key: "whatsapp"
-			},
 			{
 				in: "body",
 				key: "externalId"
@@ -3922,6 +4041,11 @@ var Templates = class {
 			}
 		});
 	}
+	/**
+	* List templates for the dashboard
+	*
+	* Returns a paginated dashboard view that groups related channel templates into families and leaves standalone templates ungrouped.
+	*/
 	static listDashboard(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [
 			{
@@ -3971,6 +4095,11 @@ var Templates = class {
 			...params
 		});
 	}
+	/**
+	* List template families
+	*
+	* Returns a paginated list of the organization's template families and members.
+	*/
 	static listFamilies(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [{
 			in: "query",
@@ -3989,6 +4118,11 @@ var Templates = class {
 			...params
 		});
 	}
+	/**
+	* Create a template family
+	*
+	* Creates an empty template family with the supplied name and returns it with status 201.
+	*/
 	static createFamily(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [{
 			in: "body",
@@ -4009,6 +4143,11 @@ var Templates = class {
 			}
 		});
 	}
+	/**
+	* Delete a template family
+	*
+	* Deletes a template family without deleting its member templates.
+	*/
 	static deleteFamily(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [{
 			in: "path",
@@ -4024,6 +4163,11 @@ var Templates = class {
 			...params
 		});
 	}
+	/**
+	* Get a template family
+	*
+	* Returns a template family and its channel-specific member templates.
+	*/
 	static getFamily(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [{
 			in: "path",
@@ -4039,6 +4183,11 @@ var Templates = class {
 			...params
 		});
 	}
+	/**
+	* Rename a template family
+	*
+	* Changes a template family's name and returns the updated family.
+	*/
 	static renameFamily(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [{
 			in: "path",
@@ -4062,6 +4211,11 @@ var Templates = class {
 			}
 		});
 	}
+	/**
+	* Create a family from a template
+	*
+	* Creates a template family containing the specified template and returns the new family with status 201.
+	*/
 	static createFamilyFromTemplate(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [{
 			in: "path",
@@ -4085,6 +4239,11 @@ var Templates = class {
 			}
 		});
 	}
+	/**
+	* Detach a template from a family
+	*
+	* Removes a member template from the family without deleting the template.
+	*/
 	static detachFamilyMember(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [{
 			in: "path",
@@ -4103,6 +4262,11 @@ var Templates = class {
 			...params
 		});
 	}
+	/**
+	* Attach a template to a family
+	*
+	* Adds an existing template as a channel member of the family and returns the updated family.
+	*/
 	static attachFamilyMember(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [{
 			in: "path",
@@ -4121,6 +4285,11 @@ var Templates = class {
 			...params
 		});
 	}
+	/**
+	* Add a channel to a template family
+	*
+	* Creates a template for the requested channel in the family and returns the updated family with status 201.
+	*/
 	static addFamilyChannel(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [{
 			in: "path",
@@ -4237,6 +4406,11 @@ var Templates = class {
 	}
 };
 var TemplateDocuments = class {
+	/**
+	* Bootstrap a template document
+	*
+	* Creates or loads the authoritative editable document for a template and returns its current snapshot.
+	*/
 	static bootstrap(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [{
 			in: "body",
@@ -4257,6 +4431,11 @@ var TemplateDocuments = class {
 			}
 		});
 	}
+	/**
+	* Get a template document
+	*
+	* Returns the current authoritative source, revision, and metadata for a template document.
+	*/
 	static get(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [{
 			in: "path",
@@ -4272,6 +4451,137 @@ var TemplateDocuments = class {
 			...params
 		});
 	}
+	/**
+	* Issue an agent admission
+	*
+	* Authorizes a bounded template-agent operation against the current document and returns the admission context.
+	*/
+	static issueAgentAdmission(parameters, options) {
+		const params = buildClientParams([parameters], [{ args: [
+			{
+				in: "path",
+				key: "templateId"
+			},
+			{
+				in: "body",
+				key: "method"
+			},
+			{
+				in: "body",
+				key: "route"
+			},
+			{
+				in: "body",
+				key: "referenceDigest"
+			},
+			{
+				in: "body",
+				key: "research"
+			},
+			{
+				in: "body",
+				key: "competitorMessage"
+			}
+		] }]);
+		return (options?.client ?? client).post({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/template-documents/{templateId}/agent-admission",
+			...options,
+			...params,
+			headers: {
+				"Content-Type": "application/json",
+				...options?.headers,
+				...params.headers
+			}
+		});
+	}
+	/**
+	* Complete an agent conversation clear
+	*
+	* Records completion of an admitted agent conversation-clear operation for the template document.
+	*/
+	static completeAgentConversationClear(parameters, options) {
+		const params = buildClientParams([parameters], [{ args: [{
+			in: "path",
+			key: "templateId"
+		}, {
+			in: "body",
+			key: "conversationId"
+		}] }]);
+		return (options?.client ?? client).post({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/template-documents/{templateId}/agent-conversation/clear-completion",
+			...options,
+			...params,
+			headers: {
+				"Content-Type": "application/json",
+				...options?.headers,
+				...params.headers
+			}
+		});
+	}
+	/**
+	* Apply an agent proposal
+	*
+	* Applies an admitted agent-authored source proposal when its revision and source digest still match the document.
+	*/
+	static applyAgentProposal(parameters, options) {
+		const params = buildClientParams([parameters], [{ args: [
+			{
+				in: "path",
+				key: "templateId"
+			},
+			{
+				in: "body",
+				key: "expectedRevision"
+			},
+			{
+				in: "body",
+				key: "sourceDigest"
+			},
+			{
+				in: "body",
+				key: "idempotencyKey"
+			},
+			{
+				in: "body",
+				key: "source"
+			},
+			{
+				in: "body",
+				key: "references"
+			},
+			{
+				in: "body",
+				key: "proposalBinding"
+			}
+		] }]);
+		return (options?.client ?? client).post({
+			security: [{
+				name: "x-api-key",
+				type: "apiKey"
+			}],
+			url: "/v1/template-documents/{templateId}/agent-proposals/apply",
+			...options,
+			...params,
+			headers: {
+				"Content-Type": "application/json",
+				...options?.headers,
+				...params.headers
+			}
+		});
+	}
+	/**
+	* Replace template source
+	*
+	* Replaces the editable SML source when the expected revision matches and returns the updated document snapshot.
+	*/
 	static replace(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [
 			{
@@ -4302,6 +4612,11 @@ var TemplateDocuments = class {
 			}
 		});
 	}
+	/**
+	* Save a template document
+	*
+	* Materializes the specified document revision as a durable template source version and returns its receipt.
+	*/
 	static save(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [{
 			in: "path",
@@ -4325,6 +4640,11 @@ var TemplateDocuments = class {
 			}
 		});
 	}
+	/**
+	* Render a template document
+	*
+	* Renders the specified document revision with optional variables and reports any missing variables.
+	*/
 	static render(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [
 			{
@@ -4355,6 +4675,11 @@ var TemplateDocuments = class {
 			}
 		});
 	}
+	/**
+	* Check a template document for spam
+	*
+	* Renders and analyzes the specified document revision for spam risks, returning issues and recommendations.
+	*/
 	static spamCheck(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [
 			{
@@ -4385,6 +4710,11 @@ var TemplateDocuments = class {
 			}
 		});
 	}
+	/**
+	* Send a template test
+	*
+	* Renders the specified document revision and sends a test message to one recipient without publishing it.
+	*/
 	static testSend(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [
 			{
@@ -4419,6 +4749,11 @@ var TemplateDocuments = class {
 			}
 		});
 	}
+	/**
+	* Send a template document
+	*
+	* Sends or schedules the specified document revision for one or more recipients with optional variables.
+	*/
 	static send(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [
 			{
@@ -4457,6 +4792,11 @@ var TemplateDocuments = class {
 			}
 		});
 	}
+	/**
+	* List template document versions
+	*
+	* Returns the saved source-version history for a template document.
+	*/
 	static versions(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [{
 			in: "path",
@@ -4472,6 +4812,11 @@ var TemplateDocuments = class {
 			...params
 		});
 	}
+	/**
+	* Publish a template document
+	*
+	* Publishes the current saved template source version and returns its lifecycle receipt.
+	*/
 	static publish(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [{
 			in: "path",
@@ -4487,6 +4832,11 @@ var TemplateDocuments = class {
 			...params
 		});
 	}
+	/**
+	* Unpublish a template document
+	*
+	* Unpublishes the current template source version and returns its lifecycle receipt.
+	*/
 	static unpublish(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [{
 			in: "path",
@@ -4502,6 +4852,11 @@ var TemplateDocuments = class {
 			...params
 		});
 	}
+	/**
+	* Restore a template document version
+	*
+	* Restores a saved source version into the editable document when the expected revision matches.
+	*/
 	static restore(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [
 			{
@@ -5197,7 +5552,7 @@ var ApiKeys = class {
 	/**
 	* Rotate an API key
 	*
-	* Deactivates the existing key and issues a replacement with the same name and permissions. Returns the new key, including the plaintext secret.
+	* Issues a replacement with the same owner, name, and permissions, then deactivates the existing key. Returns the new key, including the plaintext secret.
 	*/
 	static rotate(parameters, options) {
 		const params = buildClientParams([parameters], [{ args: [{
@@ -5786,7 +6141,7 @@ function createPromiseMessagesTransport(clientInstance) {
 		getEmail: boundMessages.getEmail,
 		getStatus: boundMessages.getStatus,
 		getEvents: boundMessages.getEvents,
-		send: (input, options) => Messages.send({ body: buildMessagesSendPayload(input) }, {
+		send: (input, options) => Messages.send({ emailSendMessagePayload: buildMessagesSendPayload(input) }, {
 			...options,
 			client: clientInstance
 		})
@@ -5805,7 +6160,7 @@ function createPromiseEmailTransport(clientInstance) {
 				client: clientInstance
 			});
 		},
-		send: (input, options) => Messages.send({ body: buildEmailSendPayload(input) }, {
+		send: (input, options) => Messages.send({ emailSendMessagePayload: buildEmailSendPayload(input) }, {
 			...options,
 			client: clientInstance
 		})
@@ -5876,6 +6231,7 @@ function createClient(config) {
 		scheduledMessages: createBoundService(ScheduledMessages, clientInstance),
 		campaigns: createBoundService(Campaigns, clientInstance),
 		email: createBoundService(Email, clientInstance),
+		media: createBoundService(Media, clientInstance),
 		templates: createBoundService(Templates, clientInstance),
 		templateDocuments: createBoundService(TemplateDocuments, clientInstance),
 		contacts: createBoundService(Contacts, clientInstance),
@@ -5894,6 +6250,7 @@ function createClient(config) {
 		scheduledMessages: createDirectService(raw.scheduledMessages),
 		campaigns: createDirectService(raw.campaigns),
 		email: createDirectService(promiseEmail),
+		media: createDirectService(raw.media),
 		templates: createDirectService(raw.templates),
 		templateDocuments: createDirectService(raw.templateDocuments),
 		contacts: createDirectService(raw.contacts),
@@ -5908,4 +6265,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-Dgv8UmCC.js.map
+//# sourceMappingURL=promises-oiy7mOyu.js.map

package/dist/service-map.d.ts

@@ -120,6 +120,13 @@ export declare const SDK_SERVICE_OPERATIONS: {
         readonly getStatus: "messagesGetStatus";
         readonly getEvents: "messagesGetEvents";
     };
+    readonly media: {
+        readonly create: "mediaCreate";
+        readonly getById: "mediaGetById";
+        readonly remove: "mediaRemove";
+        readonly complete: "mediaComplete";
+        readonly downloadUrl: "mediaDownloadUrl";
+    };
     readonly operations: {
         readonly list: "operationsList";
         readonly get: "operationsGet";
@@ -226,6 +233,25 @@ export declare const SDK_OPERATION_CALLS: {
         readonly kind: "path";
         readonly paths: readonly ["id"];
     };
+    readonly mediaCreate: {
+        readonly kind: "payload";
+    };
+    readonly mediaGetById: {
+        readonly kind: "path";
+        readonly paths: readonly ["mediaId"];
+    };
+    readonly mediaRemove: {
+        readonly kind: "path";
+        readonly paths: readonly ["mediaId"];
+    };
+    readonly mediaComplete: {
+        readonly kind: "path";
+        readonly paths: readonly ["mediaId"];
+    };
+    readonly mediaDownloadUrl: {
+        readonly kind: "path";
+        readonly paths: readonly ["mediaId"];
+    };
     readonly scheduledMessagesList: {
         readonly kind: "params";
     };