Webigail Http

There's many libraries for invoking http requests such as axios, node-fetch, and
the built in fetch api. These work, but don't make it easy to do dependency
injection.

The webigail-http package uses an interface + class based approach to http
requests which makes dependency injection much easier.

Build Status


Usage

Webigail is built in TypeScript and it exports both ESM and CJS modules.

``sh


NPM

npm install @zthun/webigail-http

Yarn

yarn add @zthun/webigail-http
`

`ts
import { ZUrlBuilder } from "@zthun/webigail-url";
import { IZHttpService, ZHttpRequestBuilder } from "@zthun/webigail-http";
import { Product } from "../models/product";

export class ProductService {
public constructor(private _http: IZHttpService) {}

public static endpoint(): string {
const url = new ZUrlBuilder().api(location).path("users").build();
return url;
}

public list(): Promise {
const request = new ZHttpRequestBuilder()
.url(ProductService.endpoint())
.get()
.build();
const { data } = this._http.request(request);
return data;
}

public create(product: Product): Promise {
const request = new ZHttpRequestBuilder()
.url(ProductService.endpoint())
.post(product)
.build();
const { data } = this._http.request(request);
return data;
}
}

// Somewhere at the root of your application.
import { ZHttpService } from "@zthun/webigail-http";

const product = new ProductService(new ZHttpService());
`

Testing

One challenge with dealing with http services and functions in tests is mocking
API calls. You can override functions like get, post, but if you want to respond
to different URL invocations, then it can become a bit of a pain to do so.
Instead of having to create a mock and shuffle the http service implementations,
this package also includes a mock implementation of the http service.

`ts
import { createGuid } from "@zthun/helpful-fn";
import { ZHttpServiceMock } from "@zthun/webigail-http";

describe("ProductService", () => {
let http: ZHttpServiceMock;

const createTestTarget = () => new ProductService(http);

beforeEach(() => {
http = new ZHttpServiceMock();

http.set(
ProductService.endpoint(),
ZHttpMethod.Get,
new ZHttpResultBuilder()
.data([createMockExistingUser(), createMockExistingUser()])
.build(),
);

http.set(ProductService.endpoint(), ZHttpMethod.Post, (r) =>
new ZHttpResultBuilder()
.data(Object.assign({}, r.body!, { id: createGuid() }))
.build(),
);
});

it("should retrieve the list of users", async () => {
// Arrange.
const target = createTestTarget();
// Act.
const actual = await target.list();
// Assert.
expect(actual.length).toEqual(2);
});
});
``