Skip to content

Commit

Permalink
Merge d1b1f64 into b41d1be
Browse files Browse the repository at this point in the history
  • Loading branch information
@aaronmwhitehead
aaronmwhitehead committed Jul 3, 2019
2 parents b41d1be + d1b1f64 commit ba8f953
Show file tree
Hide file tree
Showing 3 changed files with 281 additions and 4 deletions.
179 changes: 179 additions & 0 deletions carriers/usps.js
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,179 @@
const async = require('async');
const moment = require('moment-timezone');
const parser = require('xml2js');
const request = require('request');

const geography = require('../util/geography');

// Remove these words from cities to turn cities like `DISTRIBUTION CENTER INDIANAPOLIS` into `INDIANAPOLIS`
const CITY_BLACKLIST = /DISTRIBUTION CENTER|NETWORK DISTRIBUTION CENTER/ig;

// These tracking status codes indicate the shipment was delivered: https://about.usps.com/publications/pub97/pub97_appi.htm
const DELIVERED_TRACKING_STATUS_CODES = ['01'];

// These tracking status codes indicate the shipment was shipped (shows movement beyond a shipping label being created): https://about.usps.com/publications/pub97/pub97_appi.htm
const SHIPPED_TRACKING_STATUS_CODES = ['80', '81', '82', 'OF'];

// The events from these tracking status codes are filtered because they do not provide any useful information: https://about.usps.com/publications/pub97/pub97_appi.htm
const TRACKING_STATUS_CODES_BLACKLIST = ['NT'];

function USPS(options) {
this.isTrackingNumberValid = function(trackingNumber) {
// remove whitespace
trackingNumber = trackingNumber.replace(/\s/g, '');

if (/^(94001)\d{17}$/.test(trackingNumber)){
return true;
}
if (/^(92055)\d{17}$/.test(trackingNumber)){
return true;
}
if (/^(94073)\d{17}$/.test(trackingNumber)){
return true;
}
if (/^(93033)\d{17}$/.test(trackingNumber)){
return true;
}
if (/^(92701)\d{17}$/.test(trackingNumber)){
return true;
}
if (/^(92088)\d{17}$/.test(trackingNumber)){
return true;
}
if (/^(92021)\d{17}$/.test(trackingNumber)){
return true;
}

return false;
};

this.track = function(trackingNumber, callback) {
const xml = `<TrackFieldRequest USERID="${options.userId}"><Revision>1</Revision><ClientIp>${options.clientIp || '127.0.0.1'}</ClientIp><SourceId>${options.sourceId || '@mediocre/bloodhound (+https://github.com/mediocre/bloodhound)'}</SourceId><TrackID ID="${trackingNumber}"/></TrackFieldRequest>`;

const req = {
baseUrl: options.baseUrl || 'http://production.shippingapis.com',
method: 'GET',
timeout: 5000,
url: `/ShippingAPI.dll?API=TrackV2&XML=${encodeURIComponent(xml)}`
};

async.retry(function(callback) {
request(req, callback);
}, function (err, res) {
if (err) {
return callback(err);
}

parser.parseString(res.body, function (err, data) {
if (err) {
return callback(err);
} else if (data.Error) {
// Invalid credentials
return callback(new Error(data.Error.Description[0]));
} else if (data.TrackResponse.TrackInfo[0].Error) {
// Invalid tracking number
return callback(new Error(data.TrackResponse.TrackInfo[0].Error[0].Description[0]));
}

const results = {
events: []
};

var scanDetailsList = [];

// TrackSummary[0] exists for every item (with valid tracking number)
const summary = data.TrackResponse.TrackInfo[0].TrackSummary[0];

scanDetailsList.push(summary);
var trackDetailList = data.TrackResponse.TrackInfo[0].TrackDetail;

// If we have tracking details, push them into statuses
// Tracking details only exist if the item has more than one status update
if (trackDetailList) {
trackDetailList.forEach((trackDetail) => {
if(TRACKING_STATUS_CODES_BLACKLIST.includes(trackDetail.EventCode[0])) {
return;
}

scanDetailsList.push(trackDetail);
});
}

// Set address and location of each scan detail
scanDetailsList.forEach(scanDetail => {
scanDetail.address = {
city: scanDetail.EventCity[0].replace(CITY_BLACKLIST, '').trim(),
country: scanDetail.EventCountry[0],
state: scanDetail.EventState[0],
zip: scanDetail.EventZIPCode[0]
};

scanDetail.location = geography.addressToString(scanDetail.address);
});

// Get unqiue array of locations
const locations = Array.from(new Set(scanDetailsList.map(scanDetail => scanDetail.location)));

// Lookup each location
async.mapLimit(locations, 10, function (location, callback) {
geography.parseLocation(location, function (err, address) {
if (err) {
return callback(err);
}

address.location = location;

callback(null, address);
});
}, function (err, addresses) {
if (err) {
return callback(err);
}

scanDetailsList.forEach(scanDetail => {
const address = addresses.find(a => a.location === scanDetail.location);
let timezone = 'America/New_York';

if (address && address.timezone) {
timezone = address.timezone;
}

const event = {
address: scanDetail.address,
date: moment.tz(`${scanDetail.EventDate[0]} ${scanDetail.EventTime[0]}`, 'MMMM D, YYYY h:mm a', timezone).toDate(),
description: scanDetail.Event[0]
};

if (DELIVERED_TRACKING_STATUS_CODES.includes(scanDetail.EventCode[0])) {
results.deliveredAt = event.date;
}

if (SHIPPED_TRACKING_STATUS_CODES.includes(scanDetail.EventCode[0])) {
results.shippedAt = event.date;
}

// Use the city and state from the parsed address (for scenarios where the city includes the state like "New York, NY")
if (address) {
if (address.city) {
event.address.city = address.city;
}

if (address.state) {
event.address.state = address.state;
}
}

results.events.push(event);
});

// Add details to the most recent event
results.events[0].details = data.TrackResponse.TrackInfo[0].StatusSummary[0];

callback(null, results);
});
});
});
}
}

module.exports = USPS;
12 changes: 8 additions & 4 deletions index.js
View file
Original file line number Diff line number Diff line change
@@ -1,16 +1,18 @@
const FedEx = require('./carriers/fedEx');
const PitneyBowes = require('./carriers/pitneyBowes');
const FedEx = require('./carriers/fedEx');
const USPS = require('./carriers/usps');

function Bloodhound(options) {
const fedEx = new FedEx(options && options.fedEx);
const pitneyBowes = new PitneyBowes(options && options.pitneyBowes);
const usps = new USPS(options && options.usps);

this.guessCarrier = function(trackingNumber) {
if (fedEx.isTrackingNumberValid(trackingNumber)) {
return 'FedEx';
}

return undefined;
}else if (usps.isTrackingNumberValid(trackingNumber)) {
return 'USPS';
}else return undefined;
};

this.track = function(trackingNumber, carrier, callback) {
Expand Down Expand Up @@ -40,6 +42,8 @@ function Bloodhound(options) {
fedEx.track(trackingNumber, callback);
} else if (carrier === 'newgistics') {
pitneyBowes.track(trackingNumber, callback);
} else if (carrier === 'usps') {
usps.track(trackingNumber, callback);
} else {
return callback(new Error(`Carrier ${carrier} is not supported.`));
}
Expand Down
94 changes: 94 additions & 0 deletions test/carriers/usps.js
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,94 @@
const assert = require('assert');
const Bloodhound = require('../../index');
const USPS = require('../../carriers/usps.js')

describe('usps.isTrackingNumberValid', function() {
const usps = new USPS();

const validTrackingNumbers = [
'9400111899223818218407',
'9400 1118 9922 3818 2184 07',
'9400 1118 9956 1482 6100 74',
'9400 1118 9922 3837 8204 90',
'9400 1118 9922 3837 8611 41',
'9400 1000 0000 0000 0000 00',
'9205 5000 0000 0000 0000 00',
'9407 3000 0000 0000 0000 00',
'9303 3000 0000 0000 0000 00',
'9208 8000 0000 0000 0000 00',
'9270 1000 0000 0000 0000 00',
'9202 1000 0000 0000 0000 00',
'94001 11111111111111110',
'92055 11111111111111111',
'94073 11111111111111111',
'93033 11111111111111111',
'92701 11111111111111111',
'92088 11111111111111111',
'92021 11111111111111111'
];

it('should detect valid USPS tracking numbers', function() {
validTrackingNumbers.forEach(trackingNumber => {
if (!usps.isTrackingNumberValid(trackingNumber)) {
assert.fail(`${trackingNumber} is not recognized as a valid USPS tracking number`);
}
});
});
});

describe.only('USPS', function () {
this.timeout(10000);

const bloodhound = new Bloodhound({
usps: {
userId: process.env.USPS_USERID
}
});

describe('Invalid USPS Access', function() {
const bloodhound = new Bloodhound({
usps: {
baseUrl: 'https://google.com',
userId: process.env.USPS_USERID
}
});

it('should return an error for invalid URL', function (done) {
bloodhound.track('9400111899223837861141', 'usps', function (err) {
assert(err);
done();
});
})
});

describe('Invalid USPS Credentials', function () {
it('should return an error for invalid USERID', function (done) {
const bloodhound = new Bloodhound({
usps: {
userId: 'invalid'
}
});

bloodhound.track('9400111899223837861141', 'usps', function (err) {
assert(err);
done();
});
});
});

describe('USPS Tracking', function () {
it('should return an error for an invalid tracking number', function (done) {
bloodhound.track('An Invalid Tracking Number', 'usps', function (err) {
assert(err);
done();
});
});

it('should return tracking information with no errors', function (done) {
bloodhound.track('9400111899223837861141', 'usps', function (err) {
assert.ifError(err);
done();
});
});
});
});

0 comments on commit ba8f953

Please sign in to comment.