@signalhousellc/sdk 1.0.21 → 1.0.23

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signalhousellc/sdk",
-  "version": "1.0.21",
+  "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,23 +163,40 @@ 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.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, options = {} }) {
-		this.client._require({ country });
-		const queryString = this.client._getQueryString({ state, country, city });
+	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 });
 	}
+
+	/**
+	 * Batch lookup city/state for NPA/NXX pairs
+	 * @async
+	 * @roles api, admin, developer, billing, user
+	 * @param {Object} params - The parameters for the lookup
+	 * @param {Array<{npa: string, nxx: string}>} params.entries - NPA/NXX pairs to look up (max 50)
+	 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request
+	 * @returns {Promise<Object>} A promise that resolves to an array of {npa, nxx, city, state} objects
+	 */
+	async lookupLocations({ entries, options = {} }) {
+		return this.client("/number/lookup/location", { method: "POST", body: { entries }, ...options });
+	}
 }