@signalhousellc/sdk 1.0.22 → 1.0.23

package/package.json

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

package/src/domains/Numbers.js

@@ -163,25 +163,27 @@ export class Numbers {
 	 * @returns {Promise<Object>} A promise that resolves to the result of the transfer operation
 	 */
 	async transferPhoneNumbers({ phoneNumbers, newSubgroupId, options = {} }) {
+		this.client._require({ phoneNumbers, newSubgroupId });
 		return this.client(`/number/transfer`, { method: "POST", body: { phoneNumbers, newSubgroupId }, ...options });
 	}
 
 	/**
-	 * Search NPA/NXX lookup data with optional filters
+	 * Search NPA/NXX lookup data with optional filters.
+	 * At least one search parameter is required.
+	 * Location filters (country, state, city) cannot be combined with NPA/NXX filters.
 	 * @async
 	 * @roles api, admin, developer, billing, user
 	 * @param {Object} params - The parameters for searching NPA/NXX data
-	 * @param {string} params.country - Filter by country code (required)
+	 * @param {string} [params.country] - Filter by country code
 	 * @param {string} [params.state] - Filter by state code (2 characters)
-	 * @param {string} [params.city] - Filter by city name (prefix match, case-insensitive)
-	 * @param {string} [params.field] - Return distinct values: "npa" for unique area codes, "nxx" for unique NXXs (requires npa)
-	 * @param {string} [params.npa] - Area code filter (required when field is "nxx")
+	 * @param {string} [params.city] - Filter by city name (prefix match, case-insensitive; requires country and state)
+	 * @param {string} [params.npa] - Area code filter (1-3 digits; cannot combine with location filters)
+	 * @param {string} [params.nxx] - Central office code filter (1-3 digits; cannot combine with location filters)
 	 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request
-	 * @returns {Promise<Object>} A promise that resolves to matching NPA/NXX records
+	 * @returns {Promise<Object>} A promise that resolves to matching NPA/NXX records or unique NPA/NXX arrays
 	 */
-	async searchNpaNxx({ country, state, city, field, npa, options = {} }) {
-		this.client._require({ country });
-		const queryString = this.client._getQueryString({ state, country, city, field, npa });
+	async searchNpaNxx({ country, state, city, npa, nxx, options = {} }) {
+		const queryString = this.client._getQueryString({ country, state, city, npa, nxx });
 		return this.client(`/number/lookup${queryString}`, { method: "GET", ...options });
 	}