@signalhousellc/sdk 1.0.61 → 1.0.63

package/src/domains/Groups.js

@@ -53,6 +53,24 @@ export class Groups {
 					return this.client(`/group/${safeGroupId}`, { method: "DELETE", ...options });
 				},
 
+				/**
+				 * Set a group's KYC complianceStatus (SHGHL-2740). Only flips the field — it does not
+				 * trigger any lockout side effects (halted sends, revoked API keys, etc.) for "rejected".
+				 * @async
+				 * @roles signalhouse
+				 * @param {Object} params - The parameters for updating a group's compliance status
+				 * @param {string} params.groupId - The ID of the group to update
+				 * @param {string} params.complianceStatus - One of "unverified", "pending", "verified", "rejected"
+				 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request
+				 * @throws {Error} Throws an error if the groupId or complianceStatus parameter is missing
+				 * @returns {Promise<Object>} - The updated group object returned from the server
+				 */
+				updateComplianceStatus: async ({ groupId, complianceStatus, options = {} }) => {
+					this.client._require({ groupId, complianceStatus });
+					const safeGroupId = encodeURIComponent(groupId);
+					return this.client(`/group/${safeGroupId}/compliance-status`, { method: "PUT", body: { complianceStatus }, ...options });
+				},
+
 				/**
 				 * Link an external tenant (GHL/Shopify) to a V2 group (server-to-server). Exchanges a
 				 * single-use link token for a canonical group, adopting an empty portal group, repointing

package/src/domains/Messages.js

@@ -247,6 +247,16 @@ export class Messages {
 
 	/**
 	 * Send an SMS message to one or more recipient phone numbers
+	 *
+	 * The response reports the send outcome with three fields so callers do not have to inspect
+	 * insertedMessages: requestedRecipientCount, enqueuedCount, and failedCount. enqueuedCount is the
+	 * number of recipients accepted for delivery and is 0 when the send was fully blocked (by the
+	 * moderation filter or a campaign opt-out); the request still resolves successfully in that case, so
+	 * treat enqueuedCount, not the HTTP status, as the signal that a message was accepted. Blocked
+	 * recipients are returned in insertedMessages with status "FAILED"; recipients on the global Do Not
+	 * Contact list are reported in dncBlockedNumbers with no message record. Each FAILED message carries
+	 * errorCode, a stable machine-readable cause (campaign opt-out is "OUT"; null on success or on
+	 * failures with no assigned code) that is also included on the FAILED status-callback payload.
 	 * @async
 	 * @roles api, admin, developer, billing, user
 	 * @param {Object} params - The parameters for sending an SMS message
@@ -276,16 +286,22 @@ export class Messages {
 	 * @param {string[]} params.recipientPhoneNumbers - The phone number(s) to send the message to
 	 * @param {string} params.messageBody - The body of the P2P message
 	 * @param {string} [params.statusCallbackUrl] - The URL to receive status callbacks
+	 * @param {string} [params.groupId] - Explicit group to send from. Defaults to the group in your auth context.
+	 * @param {string} [params.subgroupId] - Explicit subgroup to attribute the send (and its inbound reply) to.
+	 *   P2P has no dedicated sender number, so pass this to record the send against a specific subgroup; it also
+	 *   resolves the group. Defaults to the group's oldest subgroup.
 	 * @param {boolean} [params.useSignalHouseShortlinks] - When false, SignalHouse applies no link-shortening
 	 *   or text-spin and your pre-spun links/content are sent verbatim (bring-your-own spinner). Defaults to
 	 *   true server-side (the SignalHouse shortlink system, which mints unique per-recipient links).
 	 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request
 	 * @returns {Promise<Object>} - A promise that resolves to the response data from the server
 	 */
-	async sendP2P({ recipientPhoneNumbers, messageBody, statusCallbackUrl, useSignalHouseShortlinks, options = {} }) {
+	async sendP2P({ recipientPhoneNumbers, messageBody, statusCallbackUrl, groupId, subgroupId, useSignalHouseShortlinks, options = {} }) {
 		this.client._require({ recipientPhoneNumbers, messageBody });
 		const body = { recipientPhoneNumber: recipientPhoneNumbers, messageBody };
 		if (statusCallbackUrl) body.statusCallbackUrl = statusCallbackUrl;
+		if (groupId) body.groupId = groupId;
+		if (subgroupId) body.subgroupId = subgroupId;
 		if (typeof useSignalHouseShortlinks === "boolean") body.useSignalHouseShortlinks = useSignalHouseShortlinks;
 		return this.client(`/message/p2p`, {
 			method: "POST",
@@ -312,6 +328,16 @@ export class Messages {
 
 	/**
 	 * Send an MMS message to one or more recipient phone numbers, with optional media attachments and status callback
+	 *
+	 * The response reports the send outcome with three fields so callers do not have to inspect
+	 * insertedMessages: requestedRecipientCount, enqueuedCount, and failedCount. enqueuedCount is the
+	 * number of recipients accepted for delivery and is 0 when the send was fully blocked (by the
+	 * moderation filter or a campaign opt-out); the request still resolves successfully in that case, so
+	 * treat enqueuedCount, not the HTTP status, as the signal that a message was accepted. Blocked
+	 * recipients are returned in insertedMessages with status "FAILED"; recipients on the global Do Not
+	 * Contact list are reported in dncBlockedNumbers with no message record. Each FAILED message carries
+	 * errorCode, a stable machine-readable cause (campaign opt-out is "OUT"; null on success or on
+	 * failures with no assigned code) that is also included on the FAILED status-callback payload.
 	 * @async
 	 * @roles api, admin, developer, billing, user
 	 * @param {Object} params - The parameters for sending an MMS message
@@ -371,6 +397,16 @@ export class Messages {
 
 	/**
 	 * Send a group MMS message to one or more recipient phone numbers, with optional media attachments and status callback
+	 *
+	 * The response reports the send outcome with three fields so callers do not have to inspect
+	 * insertedMessages: requestedRecipientCount, enqueuedCount, and failedCount. enqueuedCount is the
+	 * number of recipients accepted for delivery and is 0 when the send was fully blocked (by the
+	 * moderation filter or a campaign opt-out); the request still resolves successfully in that case, so
+	 * treat enqueuedCount, not the HTTP status, as the signal that a message was accepted. Blocked
+	 * recipients are returned in insertedMessages with status "FAILED"; recipients on the global Do Not
+	 * Contact list are reported in dncBlockedNumbers with no message record. Each FAILED message carries
+	 * errorCode, a stable machine-readable cause (campaign opt-out is "OUT"; null on success or on
+	 * failures with no assigned code) that is also included on the FAILED status-callback payload.
 	 * @async
 	 * @roles api, admin, developer, billing, user
 	 * @param {Object} params - The parameters for sending an MMS message