request-swish

!request swish banner
This is an axios based swish client used to make SWISH communications with a server that implements the same protocol. For the core SWISH Protocol project, please refer to https://github.com/adonisv79/swish-protocol

Project stats

* Package:  
* License: 
* CICD:  
* develop:  
* master:  

To install, run the following in your client project
``
npm i request-swish --save
`
Note that this project uses requet and request-promise so you may need to install thier respective @types (if you use typescript).
`
npm i @types/request @types/request-promise --save
`

Lets create a new instance of the client
`
import RequestSwishClient, { HTTPRequestConfig } from 'request-swish';

const SERVER_URL = 'http://localhost:3000';
const httpStartHandshake: HTTPRequestConfig = {
method: 'POST',
url: ${SERVER_URL}/auth/handshake,
}
const httpKillHandshake: HTTPRequestConfig = {
method: 'DELETE',
url: ${SERVER_URL}/auth/handshake,
}
const swishClient = new RequestSwishClient(httpStartHandshake, httpKillHandshake);
`
The RequestSwishClient requires 2 parameters of type HTTPRequestConfig which is just an object containing the method and uri where the target swish server may have their handshake 'init' and 'kill' reside. Note that these endpoints may also not exist depending on the implementation of the service.

the client has 3 main functions
`
swishClient.establishHandshake();
swishClient.releaseHandshake();
swishClient.sendSwish();
`
* The first 2 are used to establish and kill the connection/session
* The last one is used to make an exchange/transaction with the service

Let's implement these and start sending calls. we will add the following codes
`
async function testHandShake(): Promise {
try {
console.log('Starting handshake...')
const r = await swishClient.establishHandshake()
console.log(Handshake completed! your session_id is ${swishClient.SessionId})
console.log(r.swishResponse)
return true
} catch (err) {
console.log(err.message)
}
return false
}

async function testRequest(path: string, data: Record) {
try {
console.log(Sending request ${JSON.stringify(data)})
const r = await swishClient.sendSwish({
method: 'POST',
responseType: 'json',
url: ${SERVER_URL}/${path},
data,
})
console.log(r.swishResponse)
} catch (err) {
console.log(err.message)
}
}

async function testDestroySession() {
console.log('Destroying handshake session...')
const r = await swishClient.releaseHandshake()
console.log(r.swishResponse)
}

async function test() {
try {
await testHandShake()
// now lets start communicating to the secured endpoints
await testRequest('test/success', { action: 'hello', message: 'Adonis Villamor', passcode: 'whoami' })
// send a different one this time
await testRequest('test/success', { action: 'move', message: 'Japan', passcode: 'whereami' })
// destroy the session
await testDestroySession()
// try an illegal access now session is destoryed
await testRequest('test/success', { action: 'move', message: 'Japan', passcode: 'whereami' })
} catch (err) {
console.error(err.message)
}
}

test();

``

Execute the code while running the sample server from the tools in https://github.com/adonisv79/swish-protocol