smartystreets-javascript-sdk 3.3.0 → 4.0.0

package/.github/workflows/node-tests.yml

@@ -13,7 +13,7 @@ jobs:
 
     strategy:
       matrix:
-        node-version: [10.x, 12.x, 14.x, 16.x, 18.x]
+        node-version: [14.x, 16.x, 18.x, 20.x]
 
     steps:
     - uses: actions/checkout@v2

package/Makefile

@@ -1,6 +1,6 @@
 #!/usr/bin/make -f
 
-VERSION           := $(shell tagit -m --dry-run)
+VERSION           := $(shell tagit -M --dry-run)
 VERSION_FILE1     := package.json
 VERSION_FILE2     := package-lock.json
 
@@ -11,7 +11,7 @@ node_modules:
 	npm install
 
 publish: test version upload unversion
-	tagit -m
+	tagit -M
 	git push origin --tags
 
 upload:

package/examples/international_address_autocomplete.js

@@ -2,38 +2,44 @@ const SmartySDK = require("smartystreets-javascript-sdk");
 const SmartyCore = SmartySDK.core;
 const Lookup = SmartySDK.internationalAddressAutocomplete.Lookup;
 
-// US Autocomplete Pro only supports using Embedded Keys
-let key = process.env.SMARTY_EMBEDDED_KEY;
+// International Autocomplete only supports using Embedded Keys
+const key = process.env.SMARTY_EMBEDDED_KEY;
 const credentials = new SmartyCore.SharedCredentials(key);
 
 // The appropriate license values to be used for your subscriptions
 // can be found on the Subscription page of the account dashboard.
 // https://www.smarty.com/docs/cloud/licensing
-let clientBuilder = new SmartyCore.ClientBuilder(credentials).withLicenses(["international-autocomplete-cloud"])
+const clientBuilder = new SmartyCore.ClientBuilder(credentials).withLicenses(["international-autocomplete-v2-cloud"])
 // .withBaseUrl("");
-let client = clientBuilder.buildInternationalAddressAutocompleteClient();
+const client = clientBuilder.buildInternationalAddressAutocompleteClient();
 
 // Documentation for input fields can be found at:
-//www.smarty.com/docs/cloud/international-address-autocomplete-api#pro-http-request-input-fields
+// www.smarty.com/docs/cloud/international-address-autocomplete-api#pro-http-request-input-fields
+const country = "CAN";
 
-let lookup = new Lookup("Ave", "CAN");
-await handleRequest(lookup, "Simple Request");
-
-// *** Using Filter and Prefer ***
-lookup = new Lookup("Ave", "CAN");
-
-lookup.maxResults = 10;
-// lookup.include_only_administrative_area = "";
-lookup.include_only_locality = "Sherwood Park";
-// lookup.include_only_postal_code = "";
-
-await handleRequest(lookup, "Using Filter and Prefer");
+const summaryLookup = new Lookup({search: "123 Anson", country});
+await handleRequest(summaryLookup, "Response of summary results");
 
+const detailedLookup = new Lookup({addressId: summaryLookup.result[0].addressId, country});
+await handleRequest(detailedLookup, "Response using an address ID to get detailed results");
 
 function logSuggestions(response, message) {
-	console.log(message);
-	console.log(response.result);
-	console.log("*********************");
+	console.log("*** " + message + " ***");
+
+	response.result.forEach(suggestion => {
+		if (suggestion.addressText) {
+			console.log("Entries: ", suggestion.entries);
+			console.log("Address Text: ", suggestion.addressText);
+			console.log("Address ID: ", suggestion.addressId);
+		} else {
+			console.log("Street: ", suggestion.street);
+			console.log("Locality: ", suggestion.locality);
+			console.log("Administrative Area: ", suggestion.administrativeArea);
+			console.log("Postal Code: ", suggestion.postalCode);
+			console.log("Country: ", suggestion.countryIso3);
+		}
+	});
+	console.log("\n");
 }
 
 async function handleRequest(lookup, lookupType) {

package/package.json

@@ -1,6 +1,6 @@
 {
  "name": "smartystreets-javascript-sdk",
- "version": "3.3.0",
+ "version": "4.0.0",
  "description": "Quick and easy Smarty address validation.",
  "keywords": [
   "smarty",

package/src/BaseUrlSender.js

@@ -6,7 +6,7 @@ class BaseUrlSender {
 
 	send(request) {
 		return new Promise((resolve, reject) => {
-			request.baseUrl = this.urlOverride;
+			request.baseUrl = `${this.urlOverride}${request.baseUrlParams ? `/${request.baseUrlParams}` : ""}`;
 
 			this.sender.send(request)
 				.then(resolve)

package/src/ClientBuilder.js

@@ -28,7 +28,7 @@ const US_EXTRACT_API_URL = "https://us-extract.api.smarty.com/";
 const US_STREET_API_URL = "https://us-street.api.smarty.com/street-address";
 const US_ZIP_CODE_API_URL = "https://us-zipcode.api.smarty.com/lookup";
 const US_REVERSE_GEO_API_URL = "https://us-reverse-geo.api.smarty.com/lookup";
-const INTERNATIONAL_ADDRESS_AUTOCOMPLETE_API_URL = "https://international-autocomplete.api.smarty.com/lookup";
+const INTERNATIONAL_ADDRESS_AUTOCOMPLETE_API_URL = "https://international-autocomplete.api.smarty.com/v2/lookup";
 
 /**
  * The ClientBuilder class helps you build a client object for one of the supported Smarty APIs.<br>

package/src/Request.js

@@ -1,6 +1,7 @@
 class Request {
 	constructor(payload) {
 		this.baseUrl = "";
+		this.baseUrlParams = "";
 		this.payload = payload;
 		this.headers = {
 			"Content-Type": "application/json; charset=utf-8",

package/src/international_address_autocomplete/Client.js

@@ -14,12 +14,15 @@ class Client {
 		request.parameters = {
 			search: lookup.search,
 			country: lookup.country,
-			max_results: lookup.max_results,
-			include_only_administrative_area: lookup.include_only_administrative_area,
-			include_only_locality: lookup.include_only_locality,
-			include_only_postal_code: lookup.include_only_postal_code,
+			max_results: lookup.maxResults,
+			include_only_locality: lookup.includeOnlyLocality,
+			include_only_postal_code: lookup.includeOnlyPostalCode,
 		};
 
+		if (lookup.addressId) {
+			request.baseUrlParams = lookup.addressId;
+		}
+
 		return new Promise((resolve, reject) => {
 			this.sender.send(request)
 				.then(response => {

package/src/international_address_autocomplete/Lookup.js

@@ -1,13 +1,13 @@
 class Lookup {
-	constructor(search = "", country = "United States", max_results = undefined, include_only_administrative_area = "", include_only_locality = "", include_only_postal_code = "") {
+	constructor({search, addressId, country, maxResults = 5, includeOnlyLocality, includeOnlyPostalCode} = {}) {
 		this.result = [];
 
 		this.search = search;
+		this.addressId = addressId;
 		this.country = country;
-		this.max_results = max_results;
-		this.include_only_administrative_area = include_only_administrative_area;
-		this.include_only_locality = include_only_locality;
-		this.include_only_postal_code = include_only_postal_code;
+		this.maxResults = maxResults;
+		this.includeOnlyLocality = includeOnlyLocality;
+		this.includeOnlyPostalCode = includeOnlyPostalCode;
 	}
 }
 

package/src/international_address_autocomplete/Suggestion.js

@@ -5,6 +5,9 @@ class Suggestion {
 		this.administrativeArea = responseData.administrative_area;
 		this.postalCode = responseData.postal_code;
 		this.countryIso3 = responseData.country_iso3;
+		this.entries = responseData.entries;
+		this.addressText = responseData.address_text;
+		this.addressId = responseData.address_id;
 	}
 }
 

package/tests/international_address_autocomplete/test_Client.js

@@ -12,14 +12,13 @@ describe("An International Address Autocomplete Client", function () {
 		let mockSender = new MockSender();
 		let client = new Client(mockSender);
 		let search = "(";
-		let lookup = new Lookup(search);
+		let lookup = new Lookup({search});
 		let expectedParameters = {
-			search: search,
-			max_results: undefined,
-			include_only_administrative_area: "",
-			include_only_locality: "",
-			include_only_postal_code: "",
-			country: "United States",
+			country: undefined,
+			include_only_locality: undefined,
+			include_only_postal_code: undefined,
+			max_results: 5,
+			search: "(",
 		};
 
 		client.send(lookup);
@@ -30,15 +29,14 @@ describe("An International Address Autocomplete Client", function () {
 		let mockSender = new MockSender();
 		let client = new Client(mockSender);
 		let search = "(";
-		let lookup = new Lookup(search);
+		let lookup = new Lookup({search});
 		lookup.search = search;
 		lookup.country = "Russia";
 		let expectedParameters = {
 			country: "Russia",
-			max_results: undefined,
-			include_only_administrative_area: "",
-			include_only_locality: "",
-			include_only_postal_code: "",
+			max_results: 5,
+			include_only_locality: undefined,
+			include_only_postal_code: undefined,
 			search: search,
 		};
 
@@ -50,15 +48,14 @@ describe("An International Address Autocomplete Client", function () {
 		let mockSender = new MockSender();
 		let client = new Client(mockSender);
 		let search = "(";
-		let lookup = new Lookup(search);
+		let lookup = new Lookup({search});
 		lookup.search = search;
-		lookup.max_results = 10;
+		lookup.maxResults = 10;
 		let expectedParameters = {
-			country: "United States",
+			country: undefined,
 			max_results: 10,
-			include_only_administrative_area: "",
-			include_only_locality: "",
-			include_only_postal_code: "",
+			include_only_locality: undefined,
+			include_only_postal_code: undefined,
 			search: search,
 		};
 
@@ -87,7 +84,7 @@ describe("An International Address Autocomplete Client", function () {
 
 		let mockSender = new MockSenderWithResponse(responseData);
 		let client = new Client(mockSender);
-		let lookup = new Lookup("f");
+		let lookup = new Lookup({search: "f"});
 		let expectedSuggestion = new Suggestion(responseData.candidates[0]);
 
 		return client.send(lookup).then(() => {

package/tests/international_address_autocomplete/test_Lookup.js

@@ -5,45 +5,50 @@ const Lookup = require("../../src/international_address_autocomplete/Lookup");
 describe("An International Address Autocomplete lookup", function () {
 	it("Can be newed up with a prefix", function () {
 		const expectedPrefix = "z";
-		let lookup = new Lookup(expectedPrefix);
+		let lookup = new Lookup({search: expectedPrefix});
 		expect(lookup.search).to.equal(expectedPrefix);
 	});
 
-	it("Default country parameter should be United States", function () {
-		let lookup = new Lookup("z");
-		expect(lookup.country).to.equal("United States");
+	it("Set address ID", function () {
+		const addressId = "111";
+		let lookup = new Lookup({addressId});
+		expect(lookup.addressId).to.equal(addressId);
 	});
 
-	it("Manually set lookup to be another country", function () {
+	it("Set country", function () {
 		const country = "Russia";
-		const expectedPrefix = "z";
-		let lookup = new Lookup(expectedPrefix, country);
+		let lookup = new Lookup({country});
 		expect(lookup.country).to.equal(country);
 	});
 
-	it("Set include only administrative area param", function () {
-		const administrativeArea = "administrative area";
-		const expectedPrefix = "z";
-		let lookup = new Lookup(expectedPrefix, "Utah", "test", administrativeArea);
-		expect(lookup.include_only_administrative_area).to.equal(administrativeArea);
+	it("Set max results", function () {
+		const maxResults = 10000;
+		let lookup = new Lookup({maxResults});
+		expect(lookup.maxResults).to.equal(maxResults);
 	});
 
-	it("Set include only locality param", function () {
-		const locality = "locality";
-		const expectedPrefix = "z";
-		let lookup = new Lookup(expectedPrefix, "Utah", "test", "test", locality);
-		expect(lookup.include_only_locality).to.equal(locality);
+	it("Set include only include locality param", function () {
+		const onlyIncludeLocality = "locality";
+		let lookup = new Lookup({includeOnlyLocality: onlyIncludeLocality});
+		expect(lookup.includeOnlyLocality).to.equal(onlyIncludeLocality);
 	});
 
-	it("Set include only postal code param", function () {
-		const postalCode = "locality";
-		const expectedPrefix = "z";
-		let lookup = new Lookup(expectedPrefix, "Utah", "test", "test", "test", postalCode);
-		expect(lookup.include_only_postal_code).to.equal(postalCode);
+	it("Set include only include postal code param", function () {
+		const onlyIncludePostalCode = "post code";
+		let lookup = new Lookup({includeOnlyPostalCode: onlyIncludePostalCode});
+		expect(lookup.includeOnlyPostalCode).to.equal(onlyIncludePostalCode);
 	});
 
 	it("Checking defaults of params on instantiation ", function () {
-		const defaultLookup = new Lookup("", "United States", undefined, "", "", "");
+		const defaultLookup = {
+			result: [],
+			search: undefined,
+			addressId: undefined,
+			country: undefined,
+			maxResults: 5,
+			includeOnlyLocality: undefined,
+			includeOnlyPostalCode: undefined,
+		};
 		let lookup = new Lookup();
 		expect(lookup).to.deep.equal(defaultLookup);
 	});