@ingestkorea/util-http-handler


> An internal package

> You probably shouldn't, at least directly.

Description

INGESTKOREA Utility HTTP Handler for Node.js.

Installing

``sh
npm install @ingestkorea/util-http-handler
`

Getting Started

$3

- Use TypeScript v4.x
- Includes the TypeScript definitions for node.
`sh
npm install -D @types/node # save dev mode
`
- Includes the @ingestkorea/util-error-handler.
`sh
npm install @ingestkorea/util-error-handler
`

$3

`ts
import { IngestkoreaError, ingestkoreaErrorCodeChecker } from "@ingestkorea/util-error-handler";
import {
NodeHttpHandler,
HttpRequest,
HttpResponse,
collectBodyString,
destroyStream,
} from "@ingestkorea/util-http-handler";
`

$3

#### Create Node Http Handler

`ts
const httpHandler = new NodeHttpHandler({
connectionTimeout: 3000,
socketTimeout: 3000,
});
`

#### Set Response Body Handler

`ts
const verifyJsonHeader = async (contentType: string, streamBody: any): Promise => {
const isValid = /application\/json/gi.exec(contentType) ? true : false;
if (!isValid) {
destroyStream(streamBody);
throw new IngestkoreaError({
code: 400,
type: "Bad Request",
message: "Invalid Request",
description: "response content-type is not applicaion/json",
});
}
return;
};

const parseBody = async (output: HttpResponse): Promise => {
const { headers, body: streamBody } = output;
await verifyJsonHeader(headers["content-type"], streamBody);

const data = await collectBodyString(streamBody);
if (data.length) return JSON.parse(data);
return {};
};

const parseErrorBody = async (output: HttpResponse): Promise => {
const { statusCode, headers, body: streamBody } = output;
await verifyJsonHeader(headers["content-type"], streamBody);

const data = await collectBodyString(streamBody);
let customError = new IngestkoreaError({ code: 400, type: "Bad Request", message: "Invalid Request" });

if (ingestkoreaErrorCodeChecker(statusCode)) customError.error.code = statusCode;
if (data.length) customError.error.description = JSON.parse(data);
throw customError;
};
`

#### Set Serialize, Deserialize command

`ts
const serialize_command_01 = async () => {
return new HttpRequest({
protocol: "https:",
method: "GET",
hostname: "api.hello-world.com",
path: "/userInfo",
query: {
id: "12345",
},
});
};

const deserialize_command_01 = async (output: HttpResponse): Promise => {
if (output.statusCode >= 300) await parseErrorBody(output);
let content = await parseBody(output);
return content;
};
`

#### Async/await

`ts
(async () => {
try {
let request = await serialize_command_01();
let { response } = await httpHandler.handle(request);
let output = await deserialize_command_01(response);
console.log(output);
} catch (err) {
console.log(err);
}
})();
``

License

This Utility is distributed under the MIT License, see LICENSE for more information.