@signalhousellc/sdk 1.0.46 → 1.0.48

package/src/domains/Subgroups.js

@@ -1,106 +1,110 @@
-/**
- * @typedef {Object} CreateSubgroupData
- * @property {string} groupId - The ID of the parent group for the subgroup (must be at least 8 characters long and start with 'G')
- * @property {string} subgroupName - The name of the subgroup (required)
- * @property {string} [contactFirstName] - The first name of the contact person for the subgroup
- * @property {string} [contactLastName] - The last name of the contact person for the subgroup
- * @property {string} [contactMiddleName] - The middle name of the contact person for the subgroup
- * @property {string} [subgroupCompanyName] - The company name associated with the subgroup
- * @property {string} [addressLine1] - The first line of the address for the subgroup
- * @property {string} [addressLine2] - The second line of the address for the subgroup
- * @property {string} [city] - The city for the subgroup's address
- * @property {string} [state] - The state for the subgroup's address
- * @property {string} [country] - The country for the subgroup's address
- * @property {string} [postalCode] - The postal code for the subgroup's address
- * @property {string} [phone] - The phone number for the subgroup
- */
-
-/**
- * @typedef {Object} UpdateSubgroupData
- * @property {string} [subgroupName] - The name of the subgroup
- * @property {string} [contactFirstName] - The first name of the contact person for the subgroup
- * @property {string} [contactLastName] - The last name of the contact person for the subgroup
- * @property {string} [contactMiddleName] - The middle name of the contact person for the subgroup
- * @property {string} [subgroupCompanyName] - The company name associated with the subgroup
- * @property {string} [addressLine1] - The first line of the address for the subgroup
- * @property {string} [addressLine2] - The second line of the address for the subgroup
- * @property {string} [city] - The city for the subgroup's address
- * @property {string} [state] - The state for the subgroup's address
- * @property {string} [country] - The country for the subgroup's address
- * @property {string} [postalCode] - The postal code for the subgroup's address
- * @property {string} [phone] - The phone number for the subgroup
- * @property {string} [status] - The status of the subgroup (e.g., "active", "inactive")
- */
-
-export class Subgroups {
-	constructor(client, enableAdmin) {
-		this.client = client;
-		this.enableAdmin = enableAdmin;
-	}
-
-	/**
-	 * Get a list of subgroups with optional filters
-	 * @async
-	 * @roles api, admin, developer, billing, user
-	 * @param {Object} params - The parameters for getting subgroups
-	 * @param {string} [params.id] - Filter by subgroup ID
-	 * @param {string} [params.groupId] - Filter by parent group ID
-	 * @param {number} [params.page] - The page number for pagination
-	 * @param {number} [params.limit] - The number of items per page for pagination
-	 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request
-	 * @returns {Promise<Object>} - The list of subgroups returned from the server
-	 */
-	async getSubgroups({ id, groupId, page, limit, options = {} }) {
-		const filters = { id, groupId, page, limit };
-		const queryString = this.client._getQueryString(filters);
-		return this.client(`/subgroup${queryString}`, { method: "GET", ...options });
-	}
-
-	/**
-	 * Create a new subgroup with the specified subgroup data
-	 * @async
-	 * @roles api, admin, developer, billing, user
-	 * @param {Object} params - The parameters for creating a subgroup (see CreateSubgroupData typedef for details)
-	 * @param {CreateSubgroupData} params.subgroupData - The data for the subgroup to be created, including required fields such as groupId and subgroupName
-	 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request
-	 * @throws {Error} Throws an error if the subgroupData parameter is missing or if required fields in subgroupData are missing
-	 * @returns {Promise<Object>} - The created subgroup object returned from the server
-	 */
-	async createSubgroup({ subgroupData, options = {} }) {
-		this.client._require({ subgroupData: subgroupData });
-		return this.client(`/subgroup`, { method: "POST", body: subgroupData, ...options });
-	}
-
-	/**
-	 * Update an existing subgroup with the specified subgroup data
-	 * @async
-	 * @roles api, admin, developer, billing, user
-	 * @param {Object} params - The parameters for updating a subgroup (see UpdateSubgroupData typedef for details)
-	 * @param {string} params.id - The ID of the subgroup to update
-	 * @param {UpdateSubgroupData} params.updateData - The data for the subgroup to be updated, including fields such as subgroupName, contact information, and status
-	 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request
-	 * @throws {Error} Throws an error if the id or updateData parameter is missing
-	 * @returns {Promise<Object>} - The updated subgroup object returned from the server
-	 */
-	async updateSubgroup({ id, updateData, options = {} }) {
-		this.client._require({ id, updateData });
-		const safeId = encodeURIComponent(id);
-		return this.client(`/subgroup/${safeId}`, { method: "PUT", body: updateData, ...options });
-	}
-
-	/**
-	 * Delete a subgroup by its ID (mark as inactive)
-	 * @async
-	 * @roles api, admin, developer, billing, user
-	 * @param {Object} params - The parameters for deleting a subgroup
-	 * @param {string} params.id - The ID of the subgroup to delete
-	 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request
-	 * @throws {Error} Throws an error if the id parameter is missing
-	 * @returns {Promise<Object>} - The deleted subgroup object returned from the server
-	 */
-	async deleteSubgroup({ id, options = {} }) {
-		this.client._require({ id });
-		const safeId = encodeURIComponent(id);
-		return this.client(`/subgroup/${safeId}`, { method: "DELETE", ...options });
-	}
-}
+/**
+ * @typedef {Object} CreateSubgroupData
+ * @property {string} groupId - The ID of the parent group for the subgroup (must be at least 8 characters long and start with 'G')
+ * @property {string} subgroupName - The name of the subgroup (required)
+ * @property {string} [contactFirstName] - The first name of the contact person for the subgroup
+ * @property {string} [contactLastName] - The last name of the contact person for the subgroup
+ * @property {string} [contactMiddleName] - The middle name of the contact person for the subgroup
+ * @property {string} [subgroupCompanyName] - The company name associated with the subgroup
+ * @property {string} [addressLine1] - The first line of the address for the subgroup
+ * @property {string} [addressLine2] - The second line of the address for the subgroup
+ * @property {string} [city] - The city for the subgroup's address
+ * @property {string} [state] - The state for the subgroup's address
+ * @property {string} [country] - The country for the subgroup's address
+ * @property {string} [postalCode] - The postal code for the subgroup's address
+ * @property {string} [phone] - The phone number for the subgroup
+ * @property {string} [carrierIdFamily] - Optional agency-managed carrier ID selection ("Default", "ATT", "TMobile", "Verizon", "USCellular", "GoogleVoice", "ClearSky", "Interop"). Setting this field requires signalhouse_api, signalhouse_admin, signalhouse_user, api, admin, developer, or billing role.
+ * @property {string|null} [carrierIdRegion] - Optional ClearSky region ("PRClaro", "GuamDocomo", "GuamGTA", "GuamITE") or null; only valid when carrierIdFamily is "ClearSky". Setting this field requires signalhouse_api, signalhouse_admin, signalhouse_user, api, admin, developer, or billing role.
+ */
+
+/**
+ * @typedef {Object} UpdateSubgroupData
+ * @property {string} [subgroupName] - The name of the subgroup
+ * @property {string} [contactFirstName] - The first name of the contact person for the subgroup
+ * @property {string} [contactLastName] - The last name of the contact person for the subgroup
+ * @property {string} [contactMiddleName] - The middle name of the contact person for the subgroup
+ * @property {string} [subgroupCompanyName] - The company name associated with the subgroup
+ * @property {string} [addressLine1] - The first line of the address for the subgroup
+ * @property {string} [addressLine2] - The second line of the address for the subgroup
+ * @property {string} [city] - The city for the subgroup's address
+ * @property {string} [state] - The state for the subgroup's address
+ * @property {string} [country] - The country for the subgroup's address
+ * @property {string} [postalCode] - The postal code for the subgroup's address
+ * @property {string} [phone] - The phone number for the subgroup
+ * @property {string} [status] - The status of the subgroup (e.g., "active", "inactive")
+ * @property {string} [carrierIdFamily] - Optional agency-managed carrier ID selection ("Default", "ATT", "TMobile", "Verizon", "USCellular", "GoogleVoice", "ClearSky", "Interop"). Setting this field requires signalhouse_api, signalhouse_admin, signalhouse_user, api, admin, developer, or billing role.
+ * @property {string|null} [carrierIdRegion] - Optional ClearSky region ("PRClaro", "GuamDocomo", "GuamGTA", "GuamITE") or null; only valid when carrierIdFamily is "ClearSky". Setting this field requires signalhouse_api, signalhouse_admin, signalhouse_user, api, admin, developer, or billing role.
+ */
+
+export class Subgroups {
+	constructor(client, enableAdmin) {
+		this.client = client;
+		this.enableAdmin = enableAdmin;
+	}
+
+	/**
+	 * Get a list of subgroups with optional filters
+	 * @async
+	 * @roles api, admin, developer, billing, user
+	 * @param {Object} params - The parameters for getting subgroups
+	 * @param {string} [params.id] - Filter by subgroup ID
+	 * @param {string} [params.groupId] - Filter by parent group ID
+	 * @param {number} [params.page] - The page number for pagination
+	 * @param {number} [params.limit] - The number of items per page for pagination
+	 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request
+	 * @returns {Promise<Object>} - The list of subgroups returned from the server
+	 */
+	async getSubgroups({ id, groupId, page, limit, options = {} }) {
+		const filters = { id, groupId, page, limit };
+		const queryString = this.client._getQueryString(filters);
+		return this.client(`/subgroup${queryString}`, { method: "GET", ...options });
+	}
+
+	/**
+	 * Create a new subgroup with the specified subgroup data
+	 * @async
+	 * @roles api, admin, developer, billing, user
+	 * @param {Object} params - The parameters for creating a subgroup (see CreateSubgroupData typedef for details)
+	 * @param {CreateSubgroupData} params.subgroupData - The data for the subgroup to be created, including required fields such as groupId and subgroupName
+	 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request
+	 * @throws {Error} Throws an error if the subgroupData parameter is missing or if required fields in subgroupData are missing
+	 * @returns {Promise<Object>} - The created subgroup object returned from the server
+	 */
+	async createSubgroup({ subgroupData, options = {} }) {
+		this.client._require({ subgroupData: subgroupData });
+		return this.client(`/subgroup`, { method: "POST", body: subgroupData, ...options });
+	}
+
+	/**
+	 * Update an existing subgroup with the specified subgroup data
+	 * @async
+	 * @roles api, admin, developer, billing, user
+	 * @param {Object} params - The parameters for updating a subgroup (see UpdateSubgroupData typedef for details)
+	 * @param {string} params.id - The ID of the subgroup to update
+	 * @param {UpdateSubgroupData} params.updateData - The data for the subgroup to be updated, including fields such as subgroupName, contact information, and status
+	 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request
+	 * @throws {Error} Throws an error if the id or updateData parameter is missing
+	 * @returns {Promise<Object>} - The updated subgroup object returned from the server
+	 */
+	async updateSubgroup({ id, updateData, options = {} }) {
+		this.client._require({ id, updateData });
+		const safeId = encodeURIComponent(id);
+		return this.client(`/subgroup/${safeId}`, { method: "PUT", body: updateData, ...options });
+	}
+
+	/**
+	 * Delete a subgroup by its ID (mark as inactive)
+	 * @async
+	 * @roles api, admin, developer, billing, user
+	 * @param {Object} params - The parameters for deleting a subgroup
+	 * @param {string} params.id - The ID of the subgroup to delete
+	 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request
+	 * @throws {Error} Throws an error if the id parameter is missing
+	 * @returns {Promise<Object>} - The deleted subgroup object returned from the server
+	 */
+	async deleteSubgroup({ id, options = {} }) {
+		this.client._require({ id });
+		const safeId = encodeURIComponent(id);
+		return this.client(`/subgroup/${safeId}`, { method: "DELETE", ...options });
+	}
+}

package/src/domains/Subscriptions.js

@@ -1,140 +1,140 @@
-export class Subscriptions {
-	constructor(client, enableAdmin) {
-		this.client = client;
-		this.enableAdmin = enableAdmin;
-
-		if (enableAdmin) {
-			this.admin = {
-				/**
-				 * Get subscription templates with optional filtering by template ID
-				 * @async
-				 * @roles signalhouse
-				 * @param {Object} params - The parameters for getting subscription templates
-				 * @param {string} [params.templateId] - The ID of a specific template to retrieve (optional)
-				 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request
-				 * @returns {Promise<Object>} - The subscription templates returned from the server
-				 */
-				getTemplates: async ({ templateId, options = {} }) => {
-					const filters = { templateId };
-					const queryString = this.client._getQueryString(filters);
-					return this.client(`/subscription/template${queryString}`, { method: "GET", ...options });
-				},
-
-				/**
-				 * Create a new subscription template with the provided template data
-				 * @async
-				 * @roles signalhouse
-				 * @param {Object} params - The parameters for creating a subscription template
-				 * @param {Object} params.templateData - The data for the new subscription template, including required fields such as templateName and monthlyFee
-				 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request
-				 * @throws {Error} Throws an error if the templateData parameter is missing or if required fields within templateData are missing
-				 * @returns {Promise<Object>} - The created subscription template object returned from the server
-				 */
-				createTemplate: async ({ templateData, options = {} }) => {
-					this.client._require({ templateData: templateData });
-					return this.client(`/subscription/template`, { method: "POST", body: templateData, ...options });
-				},
-
-				/**
-				 * Update an existing subscription template with the provided template data
-				 * @async
-				 * @roles signalhouse
-				 * @param {Object} params - The parameters for updating a subscription template
-				 * @param {string} params.templateId - The ID of the subscription template to update
-				 * @param {Object} params.templateData - The data for the subscription template, including fields such as templateName and monthlyFee
-				 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request
-				 * @throws {Error} Throws an error if the templateId or templateData parameter is missing
-				 * @returns {Promise<Object>} - The updated subscription template object returned from the server
-				 */
-				updateTemplate: async ({ templateId, templateData, options = {} }) => {
-					this.client._require({ templateId, templateData });
-					const safeTemplateId = encodeURIComponent(templateId);
-					return this.client(`/subscription/template/${safeTemplateId}`, { method: "PUT", body: templateData, ...options });
-				},
-
-				/**
-				 * Delete an existing subscription template
-				 * @async
-				 * @roles signalhouse
-				 * @param {Object} params - The parameters for deleting a subscription template
-				 * @param {string} params.templateId - The ID of the subscription template to delete
-				 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request
-				 * @throws {Error} Throws an error if the templateId parameter is missing
-				 * @returns {Promise<Object>} - The deleted subscription template object returned from the server
-				 */
-				deleteTemplate: async ({ templateId, options = {} }) => {
-					this.client._require({ templateId });
-					const safeTemplateId = encodeURIComponent(templateId);
-					return this.client(`/subscription/template/${safeTemplateId}`, { method: "DELETE", ...options });
-				},
-
-				/**
-				 * Create a custom subscription for a group with the provided subscription data
-				 * @async
-				 * @roles signalhouse
-				 * @param {Object} params - The parameters for creating a custom subscription
-				 * @param {string} params.groupId - The ID of the group to create the custom subscription for
-				 * @param {Object} params.subscriptionData - The data for the custom subscription, including required fields such as subscriptionName and monthlyFee
-				 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request
-				 * @throws {Error} Throws an error if the groupId or subscriptionData parameter is missing or if required fields within subscriptionData are missing
-				 * @returns {Promise<Object>} - The created custom subscription object returned from the server
-				 */
-				createCustomSubscription: async ({ groupId, subscriptionData, options = {} }) => {
-					this.client._require({ groupId, subscriptionData });
-					const safeGroupId = encodeURIComponent(groupId);
-					return this.client(`/subscription/user/custom/${safeGroupId}`, { method: "POST", body: subscriptionData, ...options });
-				},
-			};
-		}
-	}
-
-	/**
-	 * Get a list of subscription history for a group, with optional filters
-	 * @async
-	 * @roles api, admin, developer, billing, user
-	 * @param {Object} params - The parameters for getting subscription history
-	 * @param {string} params.groupId - The ID of the group to get subscription history for
-	 * @param {boolean} [params.onlyActive] - Whether to only include active subscriptions
-	 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request
-	 * @returns {Promise<Object>} - The subscription history returned from the server
-	 */
-	async getSubscriptions({ groupId, onlyActive, options = {} }) {
-		const filters = { groupId, onlyActive };
-		const queryString = this.client._getQueryString(filters);
-		return this.client(`/subscription/user${queryString}`, { method: "GET", ...options });
-	}
-
-	/**
-	 * Subscribe a group to a template
-	 * @async
-	 * @roles api, admin, developer, billing, user
-	 * @param {Object} params - The parameters for subscribing a group to a template
-	 * @param {string} params.groupId - The ID of the group to subscribe
-	 * @param {string} params.templateId - The ID of the template to subscribe the group to
-	 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request
-	 * @throws {Error} Throws an error if the groupId or templateId parameter is missing
-	 * @returns {Promise<Object>} - The subscription object returned from the server
-	 */
-	async subscribe({ groupId, templateId, options = {} }) {
-		this.client._require({ groupId, templateId });
-		const safeGroupId = encodeURIComponent(groupId);
-		const safeTemplateId = encodeURIComponent(templateId);
-		return this.client(`/subscription/user/subscribe/${safeGroupId}/${safeTemplateId}`, { method: "POST", body: {}, ...options });
-	}
-
-	/**
-	 * Unsubscribe a group from a template
-	 * @async
-	 * @roles api, admin, developer, billing, user
-	 * @param {Object} params - The parameters for unsubscribing a group from a template
-	 * @param {string} params.groupId - The ID of the group to unsubscribe
-	 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request
-	 * @throws {Error} Throws an error if the groupId parameter is missing
-	 * @returns {Promise<Object>} - The subscription object returned from the server
-	 */
-	async unsubscribe({ groupId, options = {} }) {
-		this.client._require({ groupId });
-		const safeGroupId = encodeURIComponent(groupId);
-		return this.client(`/subscription/user/cancel/${safeGroupId}`, { method: "POST", ...options });
-	}
-}
+export class Subscriptions {
+	constructor(client, enableAdmin) {
+		this.client = client;
+		this.enableAdmin = enableAdmin;
+
+		if (enableAdmin) {
+			this.admin = {
+				/**
+				 * Get subscription templates with optional filtering by template ID
+				 * @async
+				 * @roles signalhouse
+				 * @param {Object} params - The parameters for getting subscription templates
+				 * @param {string} [params.templateId] - The ID of a specific template to retrieve (optional)
+				 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request
+				 * @returns {Promise<Object>} - The subscription templates returned from the server
+				 */
+				getTemplates: async ({ templateId, options = {} }) => {
+					const filters = { templateId };
+					const queryString = this.client._getQueryString(filters);
+					return this.client(`/subscription/template${queryString}`, { method: "GET", ...options });
+				},
+
+				/**
+				 * Create a new subscription template with the provided template data
+				 * @async
+				 * @roles signalhouse
+				 * @param {Object} params - The parameters for creating a subscription template
+				 * @param {Object} params.templateData - The data for the new subscription template, including required fields such as templateName and monthlyFee
+				 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request
+				 * @throws {Error} Throws an error if the templateData parameter is missing or if required fields within templateData are missing
+				 * @returns {Promise<Object>} - The created subscription template object returned from the server
+				 */
+				createTemplate: async ({ templateData, options = {} }) => {
+					this.client._require({ templateData: templateData });
+					return this.client(`/subscription/template`, { method: "POST", body: templateData, ...options });
+				},
+
+				/**
+				 * Update an existing subscription template with the provided template data
+				 * @async
+				 * @roles signalhouse
+				 * @param {Object} params - The parameters for updating a subscription template
+				 * @param {string} params.templateId - The ID of the subscription template to update
+				 * @param {Object} params.templateData - The data for the subscription template, including fields such as templateName and monthlyFee
+				 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request
+				 * @throws {Error} Throws an error if the templateId or templateData parameter is missing
+				 * @returns {Promise<Object>} - The updated subscription template object returned from the server
+				 */
+				updateTemplate: async ({ templateId, templateData, options = {} }) => {
+					this.client._require({ templateId, templateData });
+					const safeTemplateId = encodeURIComponent(templateId);
+					return this.client(`/subscription/template/${safeTemplateId}`, { method: "PUT", body: templateData, ...options });
+				},
+
+				/**
+				 * Delete an existing subscription template
+				 * @async
+				 * @roles signalhouse
+				 * @param {Object} params - The parameters for deleting a subscription template
+				 * @param {string} params.templateId - The ID of the subscription template to delete
+				 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request
+				 * @throws {Error} Throws an error if the templateId parameter is missing
+				 * @returns {Promise<Object>} - The deleted subscription template object returned from the server
+				 */
+				deleteTemplate: async ({ templateId, options = {} }) => {
+					this.client._require({ templateId });
+					const safeTemplateId = encodeURIComponent(templateId);
+					return this.client(`/subscription/template/${safeTemplateId}`, { method: "DELETE", ...options });
+				},
+
+				/**
+				 * Create a custom subscription for a group with the provided subscription data
+				 * @async
+				 * @roles signalhouse
+				 * @param {Object} params - The parameters for creating a custom subscription
+				 * @param {string} params.groupId - The ID of the group to create the custom subscription for
+				 * @param {Object} params.subscriptionData - The data for the custom subscription, including required fields such as subscriptionName and monthlyFee
+				 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request
+				 * @throws {Error} Throws an error if the groupId or subscriptionData parameter is missing or if required fields within subscriptionData are missing
+				 * @returns {Promise<Object>} - The created custom subscription object returned from the server
+				 */
+				createCustomSubscription: async ({ groupId, subscriptionData, options = {} }) => {
+					this.client._require({ groupId, subscriptionData });
+					const safeGroupId = encodeURIComponent(groupId);
+					return this.client(`/subscription/user/custom/${safeGroupId}`, { method: "POST", body: subscriptionData, ...options });
+				},
+			};
+		}
+	}
+
+	/**
+	 * Get a list of subscription history for a group, with optional filters
+	 * @async
+	 * @roles api, admin, developer, billing, user
+	 * @param {Object} params - The parameters for getting subscription history
+	 * @param {string} params.groupId - The ID of the group to get subscription history for
+	 * @param {boolean} [params.onlyActive] - Whether to only include active subscriptions
+	 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request
+	 * @returns {Promise<Object>} - The subscription history returned from the server
+	 */
+	async getSubscriptions({ groupId, onlyActive, options = {} }) {
+		const filters = { groupId, onlyActive };
+		const queryString = this.client._getQueryString(filters);
+		return this.client(`/subscription/user${queryString}`, { method: "GET", ...options });
+	}
+
+	/**
+	 * Subscribe a group to a template
+	 * @async
+	 * @roles api, admin, developer, billing, user
+	 * @param {Object} params - The parameters for subscribing a group to a template
+	 * @param {string} params.groupId - The ID of the group to subscribe
+	 * @param {string} params.templateId - The ID of the template to subscribe the group to
+	 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request
+	 * @throws {Error} Throws an error if the groupId or templateId parameter is missing
+	 * @returns {Promise<Object>} - The subscription object returned from the server
+	 */
+	async subscribe({ groupId, templateId, options = {} }) {
+		this.client._require({ groupId, templateId });
+		const safeGroupId = encodeURIComponent(groupId);
+		const safeTemplateId = encodeURIComponent(templateId);
+		return this.client(`/subscription/user/subscribe/${safeGroupId}/${safeTemplateId}`, { method: "POST", body: {}, ...options });
+	}
+
+	/**
+	 * Unsubscribe a group from a template
+	 * @async
+	 * @roles api, admin, developer, billing, user
+	 * @param {Object} params - The parameters for unsubscribing a group from a template
+	 * @param {string} params.groupId - The ID of the group to unsubscribe
+	 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request
+	 * @throws {Error} Throws an error if the groupId parameter is missing
+	 * @returns {Promise<Object>} - The subscription object returned from the server
+	 */
+	async unsubscribe({ groupId, options = {} }) {
+		this.client._require({ groupId });
+		const safeGroupId = encodeURIComponent(groupId);
+		return this.client(`/subscription/user/cancel/${safeGroupId}`, { method: "POST", ...options });
+	}
+}