smartystreets-javascript-sdk-utils

SMARTY DISCLAIMER: Subject to the terms of the associated license agreement, this software is freely available for your use. This software is FREE, AS IN PUPPIES, and is a gift. Enjoy your new responsibility. This means that while we may consider enhancement requests, we may or may not choose to entertain requests at our sole and absolute discretion.

Smarty JavaScript SDK Utils

The Smarty JavaScript SDK Utils provide an additional level of analysis for US Street lookups validated through the Smarty JavaScript SDK. This package consists of the following utilities for Smarty API response analysis.

isValid()

Determines if the lookup is considered mail deliverable by the USPS. Returns <Boolean>.

Parameters

• lookup: (<Object>) a validated US Street Lookup

isInvalid()

Determines if the lookup is not considered mail deliverable by the USPS. Returns <Boolean>.

Parameters

• lookup: (<Object>) a validated US Street Lookup

isAmbiguous()

Determines if the lookup returned multiple possible match candidates. Returns <Boolean>.

Parameters

• lookup: (<Object>) a validated US Street Lookup

isMissingSecondary()

Determines if the lookup requires a secondary address. Returns <Boolean>.

Parameters

• lookup: (<Object>) a validated US Street Lookup

Example

This example is modified from the US Street API code example.

const SmartySDK = require("smartystreets-javascript-sdk");
const SmartyCore = SmartySDK.core;
const Lookup = SmartySDK.usStreet.Lookup;
const utils = require("smartystreets-javascript-sdk-utils");

let authId = process.env.SMARTY_AUTH_ID;
let authToken = process.env.SMARTY_AUTH_TOKEN;

let clientBuilder = new SmartyCore.ClientBuilder(new SmartyCore.StaticCredentials(authId, authToken));
let client = clientBuilder.buildUsStreetApiClient();

let lookup1 = new Lookup();
lookup1.street = "1600 Pennsylvania Ave NW";
lookup1.city = "Washington";
lookup1.state = "DC";
    
client.send(lookup1)
    .then(handleSuccess)
    .catch(handleError);

function handleSuccess(response) {
    response.lookups.map(lookup => console.log(lookup.result));
    
    // Is lookup1 valid?
    console.log(utils.isValid(response.lookups[0]));
    
    // Is lookup1 invalid?
    console.log(utils.isInvalid(response.lookups[0]));
    
    // Is lookup1 ambiguous?
    console.log(utils.isAmbiguous(response.lookups[0]));
    
    // Is lookup1 missing a secondary address?
    console.log(utils.isMissingSecondary(response.lookups[0]));
}

function handleError(response) {
    console.log(response);
}