npm install addresser

var addresser = require('addresser');

// Isn't confused by duplicate place names
console.log(addresser.parseAddress("400 South Orange Ave, South Orange , NJ 07079"););

{ id: '400-South-Orange-Ave,-South-Orange,-NJ-07079',
  formattedAddress: '400 South Orange Ave, South Orange, NJ 07079',
  zipCode: '07079',
  stateAbbreviation: 'NJ',
  stateName: 'New Jersey',
  placeName: 'South Orange',
  addressLine1: '400 South Orange Ave',
  streetNumber: '400',
  streetSuffix: 'Ave',
  streetName: 'South Orange' }

// Handles extra whitespace
console.log(addresser.parseAddress("123 Double  Space    St, Conway, SC 29526"));

{ id: '123-Double-Space-St,-Conway,-SC-29526',
  formattedAddress: '123 Double Space St, Conway, SC 29526',
  streetNumber: '123',
  streetSuffix: 'St',
  streetName: 'Double Space',
  addressLine1: '123 Double Space St',
  placeName: 'Conway',
  stateAbbreviation: 'SC',
  stateName: 'South Carolina',
  zipCode: '29526' }

// normalizes to Title Case  
console.log(addresser.parseAddress("123 Main St, Conway, south carolina 29526-1234"));

{ id: '123-Main-St,-Conway,-SC-29526',
  formattedAddress: '123 Main St, Conway, SC 29526',
  streetNumber: '123',
  streetSuffix: 'St',
  streetName: 'Main',
  addressLine1: '123 Main St',
  placeName: 'Conway',
  stateAbbreviation: 'SC',
  stateName: 'South Carolina',
  zipCode: '29526',
  zipCodePlusFour: '29526-1234'}

// Handles secondary address lines even without delimiters.
// Normalizes street types to standard abbreviations.
console.log(addresser.parseAddress("1301 Columbia College Drive Unit 101 Columbia, SC 29203"));

{ id: '1301-Columbia-College-Dr,-Unit-101,-Columbia,-SC-29203',
  formattedAddress: '1301 Columbia College Dr, Unit 101, Columbia, SC 29203',
  zipCode: '29203',
  stateAbbreviation: 'SC',
  stateName: 'South Carolina',
  placeName: 'Columbia',
  addressLine1: '1301 Columbia College Dr',
  addressLine2: 'Unit 101',
  streetNumber: '1301',
  streetSuffix: 'Dr',
  streetName: 'Columbia College' }       

// Handles trailing street directionals  
console.log(addresser.parseAddress("300 BOYLSTON AVE E SEATTLE WA 98102"));
{ id: '300-Boylston-Ave-E,-Seattle,-WA-98102',
  formattedAddress: '300 Boylston Ave E, Seattle, WA 98102',
  zipCode: '98102',
  stateAbbreviation: 'WA',
  stateName: 'Washington',
  placeName: 'Seattle',
  addressLine1: '300 Boylston Ave E',
  streetDirection: 'E',
  streetNumber: '300',
  streetSuffix: 'Ave',
  streetName: 'Boylston' }

// Handles post office boxes 
console.log(addresser.parseAddress("PO BOX 333 SEATTLE WA 98102"));
{ id: 'PO-BOX-333,-Seattle,-WA-98102',
  formattedAddress: 'PO BOX 333, Seattle, WA 98102',
  zipCode: '98102',
  stateAbbreviation: 'WA',
  stateName: 'Washington',
  placeName: 'Seattle',
  addressLine1: 'PO BOX 333' }

// Return a random valid city 
console.log(addresser.randomCity());
{ city: 'Irwin',
  state: 'ID' }

// Return an object containing all cities
console.log(addresser.cities());
{ 
  ...
  WI:
    [ 
      'Black River Falls',
      'Heafford Junction',
      'Washington Island',
      ...
    ],
  WY:
    [ 
      'Yellowstone National Park',
      'Saint Stephens',
      'Little America',
      ...
    ]
} 

{ 
  ...
  WI:
    [ 
      'Black River Falls',
      'Heafford Junction',
      'Washington Island',
      ...
    ],
  WY:
    [ 
      'Yellowstone National Park',
      'Saint Stephens',
      'Little America',
      ...
    ]
}