b2b-client-frq
v0.1.1
Published
FRQ version of DGAC NM B2B Soap Client
Downloads
5
Readme
Network Manager B2B Client
Disclaimer!!!
I preety mouch have no idea what I'm doing, this is my first time using GitHub and JS. This repo is a copy of DGACs repo as seen in the links and images below. Things that have been changed:
- Added queryFlightsByAerodrome to functionality
- Wrote own version of npm package (https://www.npmjs.com/package/b2b-client)
I'll try my best do merge with the original repo at a later time.
Original README
Exposes a general purpose Javascript library to interact with NM B2B web services. The idea is to abstract pain points while offering an API that maps the NM B2B WS API.
NM target version: 25.0.0
Simple usage example
https://github.com/DGAC/nmb2b-client-js-example
Features
- No WSDL/XSD dependency. The library will download and cache those on start up.
- Natural serialization/deserialization of certain types.
For instance, the Flow.retrieveOTMVPlan query expects a day
attribute with the XSD type DateYearMonthDay
. This type is a string, representing a date in the YYYY-MM-DD
format. This library allows you to pass a traditional JS Date object instead.
Flow.retrieveOTMVPlan({
dataset: { type: 'OPERATIONAL' },
day: moment.utc().toDate(),
otmvsWithDuration: { item: [{ trafficVolume: 'LFERMS' }] },
});
- Request object key reordering when needed.
In SOAP, key order matters.
// OK
Flow.retrieveOTMVPlan({
dataset: { type: 'OPERATIONAL' },
day: moment.utc().toDate(),
otmvsWithDuration: { item: [{ trafficVolume: 'LFERMS' }] },
});
// Would normally fail
Flow.retrieveOTMVPlan({
day: moment.utc().toDate(),
dataset: { type: 'OPERATIONAL' },
otmvsWithDuration: { item: [{ trafficVolume: 'LFERMS' }] },
});
The library reorder request object keys to match what's expressed in the XSD/WSDL. Therefore, the second example works fine.
- TypeScript support.
The following example will raise a type error.
// Raises a type error
Flow.retrieveOTMVPlan({
dataset: { type: 'OPERATIONNAL' }, // Notice the typo
day: moment.utc().toDate(),
otmvsWithDuration: { item: [{ trafficVolume: 'LFERMS' }] },
});
- Debug output
Debug output is controlled via the debug
package. All debug output from this library is scoped under @dgac/nmb2b-client
namespace.
Just set a DEBUG=@dgac/nmb2b-client*
environment variable :
Usage
Main service
import makeB2BClient from '@dgac/nmb2b-client';
// See below for more information about the security argument
makeB2BClient({ security }).then(client => {
client.Airspace.queryCompleteAIXMDatasets().then(() => {});
});
Per domain service
import { makeAirspaceService } from '@dgac/nmb2b-client';
// See below for more information about the security argument
makeAirspaceService({ security }).then(Airspace => {
Airspace.queryCompleteAIXMDatasets().then(() => {});
});
B2B Security
Every request to the NM B2B web services must be authenticated using a client certificate. This library needs to be initialized with a security
object, containing the certificate, key and passphrase associated.
With P12 certificate
import fs from 'fs';
const security = {
pfx: fs.readFileSync('/path/to/cert.p12'),
passphrase: 'your-passphrase',
};
makeB2BClient({ security }).then(client => {
client.Airspace.queryCompleteAIXMDatasets().then(() => {});
});
With PEM certificate
import fs from 'fs';
const security = {
pem: fs.readFileSync('/path/to/cert.pem'),
key: fs.readFileSync('/path/to/cert.key'),
passphrase: 'your-passphrase',
};
makeB2BClient({ security }).then(client => {
client.Airspace.queryCompleteAIXMDatasets().then(() => {});
});