@signalhousellc/sdk 1.0.46 → 1.0.47

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signalhousellc/sdk",
-  "version": "1.0.46",
+  "version": "1.0.47",
   "description": "Signal House SDK for use with the Signal House platform",
   "type": "module",
   "main": "src/SignalHouseSDK.js",

package/src/domains/Billing.js

@@ -73,6 +73,26 @@ export class Billing {
 		return this.client(`/billing/wallet/transactionHistory${queryString}`, { method: "GET", ...options });
 	}
 
+	/**
+	 * Get payment history (wallet recharge transactions) with server-side pagination
+	 * @async
+	 * @roles api, admin, developer, billing, user
+	 * @param {Object} params - The parameters for filtering payment history
+	 * @param {string} params.groupId - The ID of the group to filter by
+	 * @param {string} params.startDate - Start date in YYYY-MM-DD format (inclusive)
+	 * @param {string} params.endDate - End date in YYYY-MM-DD format (inclusive)
+	 * @param {number} [params.page=1] - Page number (positive integer)
+	 * @param {number} [params.limit=10] - Results per page (positive integer, max 10000)
+	 * @param {string} [params.timezone] - IANA timezone (default: "UTC")
+	 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request
+	 * @returns {Promise<{data: Array<Object>, pagination: {page: number, limit: number, totalRecords: number, totalPages: number, totalAmount: number}}>}
+	 */
+	async getPaymentHistory({ groupId, startDate, endDate, page, limit, timezone, options = {} }) {
+		const filters = { groupId, startDate, endDate, page, limit, timezone };
+		const queryString = this.client._getQueryString(filters);
+		return this.client(`/billing/wallet/paymentHistory${queryString}`, { method: "GET", ...options });
+	}
+
 	/**
 	 * Get the wallet information for a specific group
 	 * @async

package/src/domains/Messages.js

@@ -134,7 +134,7 @@ export class Messages {
 	 * @param {number} [params.limit=50] - max 50 per page
 	 * @param {"tenDLC"|"p2p"|"both"} [params.channel="both"] - Scope the ORDER BY + row inclusion. "tenDLC" excludes rows with no SMS/MMS activity; "p2p" excludes rows with no P2P activity; "both" returns rows with any activity.
 	 * @param {import('../SignalHouseSDK').RequestOptions} [params.options]
-	 * @returns {Promise<Object>} - { rows, totalCount, page, limit }
+	 * @returns {Promise<Object>} - { rows, totalCount, page, limit }. Each row carries sms/mms/p2p metric columns plus `smsOptOuts` and `mmsOptOuts` from the DNC analytics MV (P2P has no opt-outs).
 	 */
 	async getAnalyticsBySubgroup({ groupId, subgroupId, brandId, campaignId, phoneNumber, carrier, startDate, endDate, page, limit, channel, options = {} }) {
 		const filters = { groupId, subgroupId, brandId, campaignId, phoneNumber, carrier, startDate, endDate, page, limit, channel };