@autometa/http 1.4.6 → 1.4.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +8 -0
- package/dist/esm/index.js +21 -7
- package/dist/esm/index.js.map +1 -1
- package/dist/index.d.cts +3 -2
- package/dist/index.d.ts +3 -2
- package/dist/index.js +21 -7
- package/dist/index.js.map +1 -1
- package/package.json +2 -2
- package/src/http-request.ts +29 -5
- package/src/http.spec.ts +21 -1
- package/src/http.ts +1 -1
package/CHANGELOG.md
CHANGED
package/dist/esm/index.js
CHANGED
|
@@ -182,9 +182,10 @@ var HTTPRequest = class _HTTPRequest {
|
|
|
182
182
|
return request;
|
|
183
183
|
}
|
|
184
184
|
};
|
|
185
|
-
var _request, _dynamicHeaders;
|
|
185
|
+
var _request, _dynamicHeaders, _setDynamicHeaders, setDynamicHeaders_fn;
|
|
186
186
|
var _HTTPRequestBuilder = class _HTTPRequestBuilder {
|
|
187
187
|
constructor(request = () => new HTTPRequest()) {
|
|
188
|
+
__privateAdd(this, _setDynamicHeaders);
|
|
188
189
|
__privateAdd(this, _request, void 0);
|
|
189
190
|
__privateAdd(this, _dynamicHeaders, /* @__PURE__ */ new Map());
|
|
190
191
|
if (typeof request === "function") {
|
|
@@ -199,10 +200,12 @@ var _HTTPRequestBuilder = class _HTTPRequestBuilder {
|
|
|
199
200
|
get request() {
|
|
200
201
|
return __privateGet(this, _request);
|
|
201
202
|
}
|
|
202
|
-
async resolveDynamicHeaders() {
|
|
203
|
+
async resolveDynamicHeaders(request = __privateGet(this, _request)) {
|
|
203
204
|
for (const [name, value] of __privateGet(this, _dynamicHeaders)) {
|
|
204
205
|
try {
|
|
205
|
-
|
|
206
|
+
if (!request.headers)
|
|
207
|
+
request.headers = {};
|
|
208
|
+
request.headers[name] = String(await value());
|
|
206
209
|
} catch (e) {
|
|
207
210
|
const cause = e;
|
|
208
211
|
const msg = `Failed to resolve dynamic header "${name}":
|
|
@@ -241,11 +244,12 @@ ${cause}`;
|
|
|
241
244
|
__privateGet(this, _request).data = data;
|
|
242
245
|
return this;
|
|
243
246
|
}
|
|
244
|
-
header(name, value) {
|
|
247
|
+
header(name, value, onArray = (value2) => value2.join(",")) {
|
|
245
248
|
if (typeof value === "function") {
|
|
246
249
|
__privateGet(this, _dynamicHeaders).set(name, value);
|
|
250
|
+
return this;
|
|
247
251
|
}
|
|
248
|
-
const val = Array.isArray(value) ? value
|
|
252
|
+
const val = Array.isArray(value) ? onArray(value) : String(value);
|
|
249
253
|
__privateGet(this, _request).headers[name] = val;
|
|
250
254
|
return this;
|
|
251
255
|
}
|
|
@@ -261,15 +265,25 @@ ${cause}`;
|
|
|
261
265
|
return this;
|
|
262
266
|
}
|
|
263
267
|
derive() {
|
|
268
|
+
var _a;
|
|
264
269
|
const request = HTTPRequest.derive(__privateGet(this, _request));
|
|
265
|
-
return new _HTTPRequestBuilder(request);
|
|
270
|
+
return __privateMethod(_a = new _HTTPRequestBuilder(request), _setDynamicHeaders, setDynamicHeaders_fn).call(_a, __privateGet(this, _dynamicHeaders));
|
|
266
271
|
}
|
|
267
272
|
build() {
|
|
268
273
|
return __privateGet(this, _request);
|
|
269
274
|
}
|
|
275
|
+
async buildAsync() {
|
|
276
|
+
await this.resolveDynamicHeaders();
|
|
277
|
+
return __privateGet(this, _request);
|
|
278
|
+
}
|
|
270
279
|
};
|
|
271
280
|
_request = new WeakMap();
|
|
272
281
|
_dynamicHeaders = new WeakMap();
|
|
282
|
+
_setDynamicHeaders = new WeakSet();
|
|
283
|
+
setDynamicHeaders_fn = function(headers) {
|
|
284
|
+
__privateSet(this, _dynamicHeaders, new Map(headers));
|
|
285
|
+
return this;
|
|
286
|
+
};
|
|
273
287
|
var HTTPRequestBuilder = _HTTPRequestBuilder;
|
|
274
288
|
|
|
275
289
|
// src/schema.map.ts
|
|
@@ -472,7 +486,7 @@ var HTTP = class {
|
|
|
472
486
|
__privateAdd(this, _validateResponse);
|
|
473
487
|
__privateAdd(this, _request2, void 0);
|
|
474
488
|
__privateAdd(this, _metaConfig, void 0);
|
|
475
|
-
__privateSet(this, _request2, builder
|
|
489
|
+
__privateSet(this, _request2, builder);
|
|
476
490
|
__privateSet(this, _metaConfig, metaConfig.derive());
|
|
477
491
|
}
|
|
478
492
|
static create(client = new AxiosClient(), builder = new HTTPRequestBuilder(), metaConfig = new MetaConfigBuilder()) {
|
package/dist/esm/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../../src/http-response.ts","../../src/axios-client.ts","../../src/http-client.ts","../../src/http.ts","../../src/default-client-factory.ts","../../src/http-request.ts","../../src/schema.map.ts","../../src/request-meta.config.ts","../../src/transform-response.ts","../../src/default-schema.ts"],"sourcesContent":["import { HTTPRequest } from \"./http-request\";\nimport { StatusCode } from \"./types\";\n\nexport class HTTPResponse<T = unknown> {\n status: StatusCode;\n statusText: string;\n data: T;\n headers: Record<string, string>;\n request: HTTPRequest<unknown>;\n\n constructor() {\n this.headers = {};\n }\n\n static fromRaw<T>(response: HTTPResponse<T>) {\n const newResponse = new HTTPResponse<T>();\n Object.assign(newResponse, response);\n return response;\n }\n\n /**\n * Decomposes a response, creating an exact copy of the current response,\n * but with a new data value. The data can be provided directly as is, or it\n * can be generated through a callback function which receives the current\n * response data as an argument.\n *\n * ```ts\n * const response = await http.get(\"/products\");\n *\n * // direct value\n * const products = response.data;\n * const firstProduct = response.decompose(products[0]);\n * // callback transformer\n * const secondProduct = response.decompose((products) => products[1]);\n * // callback transformer with destructuring\n * const secondProduct = response.decompose(([product]) => product);\n * ```\n * @param value\n */\n decompose<K>(value: K): HTTPResponse<K>;\n decompose<K>(transformFn: (response: T) => K): HTTPResponse<K>;\n decompose<K>(transformFnOrVal: K | ((response: T) => K)): HTTPResponse<K> {\n const value = getDecompositionValue<T>(this.data, transformFnOrVal);\n return new HTTPResponseBuilder()\n .status(this.status)\n .statusText(this.statusText)\n .headers(this.headers)\n .request(this.request)\n .data(value)\n .build() as HTTPResponse<K>;\n }\n}\n\nfunction getDecompositionValue<T>(data: unknown, transformFn: unknown): T {\n return typeof transformFn === \"function\" ? transformFn(data) : transformFn;\n}\n\nexport class HTTPResponseBuilder {\n #response = new HTTPResponse();\n\n static create() {\n return new HTTPResponseBuilder();\n }\n\n derive() {\n return HTTPResponseBuilder.create()\n .data(this.#response.data)\n .headers(this.#response.headers)\n .request(this.#response.request)\n .status(this.#response.status)\n .statusText(this.#response.statusText);\n }\n\n status(code: StatusCode) {\n this.#response.status = code;\n return this;\n }\n\n statusText(text: string) {\n this.#response.statusText = text;\n return this;\n }\n\n data<T>(data: T) {\n this.#response.data = data;\n return this;\n }\n\n headers(dict: Record<string, string>) {\n this.#response.headers = dict;\n return this;\n }\n\n header(name: string, value: string) {\n this.#response.headers[name] = value;\n return this;\n }\n\n request(request: HTTPRequest<unknown>) {\n this.#response.request = request;\n return this;\n }\n\n build() {\n return this.#response;\n }\n}\n","import { HTTPRequest } from \"./http-request\";\nimport { HTTPResponse, HTTPResponseBuilder } from \"./http-response\";\nimport { HTTPAdditionalOptions, StatusCode } from \"./types\";\nimport axios, { AxiosRequestConfig } from \"axios\";\nimport { HTTPClient } from \"./http-client\";\n\n@HTTPClient.Use()\nexport class AxiosClient extends HTTPClient {\n async request<TRequestType, TResponseType>(\n request: HTTPRequest<TRequestType>,\n options: HTTPAdditionalOptions<AxiosRequestConfig>\n ): Promise<HTTPResponse<TResponseType>> {\n const { baseUrl, route, params, headers, method, data } = request;\n const url = [baseUrl, ...route].join(\"/\");\n const axiosRequest: AxiosRequestConfig = {\n url,\n params,\n headers,\n method: method,\n data,\n validateStatus: function (status) {\n return status >= 0 && status < 600;\n },\n ...options\n };\n const response = await axios(axiosRequest);\n return HTTPResponseBuilder.create()\n .status(response.status as StatusCode)\n .statusText(response.statusText)\n .data(response.data)\n .headers(response.headers as Record<string, string>)\n .request(request)\n .build() as HTTPResponse<TResponseType>;\n }\n}\n","import { HTTPRequest } from \"./http-request\";\nimport { HTTPResponse } from \"./http-response\";\nimport { HTTPAdditionalOptions } from \"./types\";\nimport { Class } from \"@autometa/types\";\nexport let defaultClient: Class<HTTPClient>;\nexport abstract class HTTPClient {\n static Use(): (target: Class<HTTPClient>) => void\n static Use(client?: Class<HTTPClient>) {\n if (client) {\n defaultClient = client\n }\n return function (target: Class<HTTPClient>) {\n defaultClient = target\n };\n }\n abstract request<TRequestType, TResponseType>(\n request: HTTPRequest<TRequestType>,\n options?: HTTPAdditionalOptions<unknown>\n ): Promise<HTTPResponse<TResponseType>>;\n}\n","import { Fixture, INJECTION_SCOPE } from \"@autometa/injection\";\nimport { AxiosClient } from \"./axios-client\";\nimport { HTTPClient } from \"./http-client\";\nimport { defaultClientFactory } from \"./default-client-factory\";\nimport { HTTPRequest, HTTPRequestBuilder } from \"./http-request\";\nimport { HTTPResponse } from \"./http-response\";\nimport { MetaConfig, MetaConfigBuilder } from \"./request-meta.config\";\nimport {\n HTTPAdditionalOptions,\n RequestHook,\n ResponseHook,\n SchemaParser,\n StatusCode\n} from \"./types\";\nimport { transformResponse } from \"./transform-response\";\nimport { AutomationError } from \"@autometa/errors\";\n\n/**\n * The HTTP fixture allows requests to be built and sent to a server. In general,\n * there are 2 modes of operation:\n *\n * * Shared Chain: The shared chain is used to configure the client for all requests, such as\n * routes this instance will always be used. When a shared chain method is called, it returns\n * the same instance of HTTP which can be further chained to configure the client.\n * * Request Chain: The request chain is used to configure a single request, inheriting values\n * set by the shared chain. When called, a new HTTP client instance is created and inherits the values\n * set by it's parent.\n *\n * The 2 modes are intended to simplify configuring an object through an inheritance chain. For example,\n * assume we have an API with 2 controller routes, `/product` and `/seller`. We can set up a Base Client\n * which consumes the HTTP fixture and configures it with the base url of our API.\n *\n * Inheritors can further configure their HTTP instance's routes.\n *\n * ```ts\n * \\@Constructor(HTTP)\n * export class BaseClient {\n * constructor(protected readonly http: HTTP) {\n * this.http.url(\"https://api.example.com\");\n * }\n * }\n *\n * export class ProductClient extends BaseClient {\n * constructor(http: HTTP) {\n * super(http);\n * this.http.sharedRoute(\"product\");\n * }\n * getProduct(id: number) {\n * return this.http.route(id).get();\n * }\n *\n * export class SellerClient extends BaseClient {\n * constructor(http: HTTP) {\n * super(http);\n * this.http.sharedRoute(\"seller\");\n * }\n *\n * getSeller(id: number) {\n * return this.http.route(id).get();\n * }\n * }\n * ```\n *\n * 'Schemas' can also be configured. A Schema is a function or an object with a `parse` method, which\n * takes a response data payload and returns a validated object. Schemas are mapped to\n * HTTP Status Codes, and if configured to be required the request will fail if no schema is found\n * matching that code.\n *\n * Defining a schema function:\n *\n * ```\n * // user.schema.ts\n * export function UserSchema(data: unknown) {\n * if(typeof data !== \"object\") {\n * throw new Error(\"Expected an object\");\n * }\n *\n * if(typeof data.name !== \"string\") {\n * throw new Error(\"Expected a string\");\n * }\n *\n * return data as { name: string };\n * }\n *\n * // user.controller.ts\n * \\@Fixture(INJECTION_SCOPE.TRANSIENT)\n * export class UserController extends BaseController {\n * constructor(private readonly http: HTTP) {\n * super(http);\n * this.http\n * .sharedRoute(\"user\")\n * .sharedSchema(ErrorSchema, { from: 400, to: 499 });\n * }\n *\n * getUser(id: number) {\n * return this.http.route(id).schema(UserSchema, 200).get();\n * // or\n * return this.http\n * .route(id)\n * .schema(UserSchema, { from: 200, to: 299 })\n * .get();\n * // or\n * return this.http\n * .route(id)\n * .schema(UserSchema, 200, 201, 202)\n * .get();\n * }\n * }\n * ```\n *\n * Validation libraries which use a `.parse` or `.validation`, method, such as Zod or MyZod, can also be used as schemas:\n *\n * ```ts\n * // user.schema.ts\n * import { z } from \"myzod\";\n *\n * export const UserSchema = z.object({\n * name: z.string()\n * });\n *\n * // user.controller.ts\n * \\@Fixture(INJECTION_SCOPE.TRANSIENT)\n * export class UserController extends BaseController {\n * constructor(private readonly http: HTTP) {\n * super(http);\n * this.http\n * .sharedRoute(\"user\")\n * .sharedSchema(ErrorSchema, { from: 400, to: 499 })\n * }\n *\n * getUser(id: number) {\n * return this.http.route(id).schema(UserSchema, 200).get();\n * }\n * }\n * ```\n */\n@Fixture(INJECTION_SCOPE.TRANSIENT)\nexport class HTTP {\n #request: HTTPRequestBuilder<HTTPRequest<unknown>>;\n #metaConfig: MetaConfigBuilder;\n constructor(\n private readonly client: HTTPClient = defaultClientFactory(),\n builder: HTTPRequestBuilder<\n HTTPRequest<unknown>\n > = new HTTPRequestBuilder(),\n metaConfig: MetaConfigBuilder = new MetaConfigBuilder()\n ) {\n this.#request = builder.derive();\n this.#metaConfig = metaConfig.derive();\n }\n\n static create(\n client: HTTPClient = new AxiosClient(),\n builder: HTTPRequestBuilder<\n HTTPRequest<unknown>\n > = new HTTPRequestBuilder(),\n metaConfig: MetaConfigBuilder = new MetaConfigBuilder()\n ) {\n return new HTTP(client, builder, metaConfig);\n }\n\n /**\n * Sets the base url of the request for this client, such as\n * `https://api.example.com`, and could include always-used routes like\n * the api version, such as `/v1` or `/api/v1` at the end.\n *\n * ```ts\n *\n * \\@Fixture(INJECTION_SCOPE.TRANSIENT)\n * export abstract class BaseClient {\n * constructor(protected readonly http: HTTP) {\n * this.http.url(\"https://api.example.com\");\n * }\n * }\n * ```\n * @param url\n * @returns\n */\n url(url: string) {\n this.#request.url(url);\n return this;\n }\n\n /**\n * If set to true, all requests derived from this client will require a schema be defined\n * matching any response status code. If set to false, a schema will still be used for validation\n * if defined, or the unadulterated original body will be returned if no schema matches.\n *\n * @param required Whether or not a schema is required for all responses.\n * @returns This instance of HTTP.\n */\n requireSchema(required: boolean) {\n this.#metaConfig.requireSchema(required);\n return this;\n }\n\n /**\n * If set to true, all requests derived from this client will allow plain text\n * responses. If set to false, plain text responses will throw an serialization error.\n *\n * Useful when an endpoint returns a HTML or plain text response. If the plain text\n * is the value of `true` or `false`, or a number, it will be parsed into the\n * appropriate type.\n *\n * This method is a shared chain method, and will return the same instance of HTTP.\n *\n * @param allow Whether or not plain text responses are allowed.\n * @returns This instance of HTTP.\n */\n sharedAllowPlainText(allow: boolean) {\n this.#metaConfig.allowPlainText(allow);\n return this;\n }\n\n /**\n * If set to true, all requests derived from this client will allow plain text\n * responses. If set to false, plain text responses will throw an serialization error.\n *\n * Useful when an endpoint returns a HTML or plain text response. If the plain text\n * is the value of `true` or `false`, or a number, it will be parsed into the\n * appropriate type.\n *\n * This method is a request chain method, and will return a new instance of HTTP.\n *\n * @param allow Whether or not plain text responses are allowed.\n * @returns A new child instance of HTTP derived from this one.\n */\n allowPlainText(allow: boolean) {\n return HTTP.create(\n this.client,\n this.#request.derive(),\n this.#metaConfig.derive().allowPlainText(allow)\n );\n }\n\n /**\n * Attaches a route to the request, such as `/product` or `/user`. Subsequent calls\n * to this method will append the route to the existing route, such as `/product/1`.\n *\n * Numbers will be converted to strings automatically. Routes can be defined one\n * at a time or as a spread argument.\n *\n * ```ts\n * constructor(http: HTTP) {\n * super(http);\n * this.http.sharedRoute(\"user\", id).get();\n * }\n *\n * // or\n *\n * constructor(http: HTTP) {\n * super(http);\n * this.http\n * .sharedRoute(\"user\")\n * .sharedRoute(id)\n * .get();\n * }\n * ```\n *\n * This method is a shared chain method, and will return the same instance of HTTP. All\n * child clients will inherit the routes defined by this method. Useful to configure\n * in the constructor body.\n *\n * @param route A route or spread list of routes to append to the request.\n * @returns This instance of HTTP.\n */\n sharedRoute(...route: (string | number | boolean)[]) {\n this.#request.route(...route.map((r) => r.toString()));\n return this;\n }\n\n /**\n * Attaches a route to the request, such as `/product` or `/user`. Subsequent calls\n * to this method will append the route to the existing route, such as `/product/1`.\n *\n * Numbers will be converted to strings automatically. Routes can be defined one\n * at a time or as a spread argument.\n *\n * ```ts\n * getUser(id: number) {\n * return this.http.route(\"user\", id).get();\n * }\n *\n * // or\n *\n * getUser(id: number) {\n * return this.http\n * .route(\"user\")\n * .route(id)\n * .get();\n * }\n * ```\n *\n * This method is a request chain method, and will return a new instance of HTTP, inheriting\n * any routes previously defined and appending the new route. Useful to configure\n * in class methods as part of finalizing a request.\n *\n * @param route A route or spread list of routes to append to the request.\n * @returns A new child instance of HTTP derived from this one.\n */\n route(...route: (string | number | boolean)[]) {\n const mapped = route.map((r) => String(r));\n return HTTP.create(this.client, this.#request.derive().route(...mapped));\n }\n\n /**\n * Attaches a shared schema mapping for all requests by this client. Schemas are\n * mapped to HTTP Status Codes, and if configured to be required the request will fail\n * if no schema is found matching that code.\n *\n * The status code mapping can be defined as a single code, a range of codes, or a spread list.\n *\n * ```ts\n * \\@Fixture(INJECTION_SCOPE.TRANSIENT)\n * export class UserController extends BaseController {\n * constructor(private readonly http: HTTP) {\n * super(http);\n * this.http\n * .sharedRoute(\"user\")\n * .sharedSchema(UserSchema, 200)\n * .sharedSchema(EmptySchema, 201, 204)\n * .sharedSchema(ErrorSchema, { from: 400, to: 499 });\n * }\n * }\n * ```\n *\n * This method is a shared chain method, and will return the same instance of HTTP. All\n * child clients will inherit the schemas defined by this method. Useful to configure\n * in the constructor body.\n *\n * @param parser The schema parser to use for this mapping.\n * @param codes A single status code, a range of status codes, or a spread list of status codes.\n * @returns This instance of HTTP.\n */\n sharedSchema(parser: SchemaParser, ...codes: StatusCode[]): HTTP;\n sharedSchema(\n parser: SchemaParser,\n ...range: { from: StatusCode; to: StatusCode }[]\n ): HTTP;\n sharedSchema(\n parser: SchemaParser,\n ...args: (StatusCode | { from: StatusCode; to: StatusCode })[]\n ): HTTP {\n this.#metaConfig.schema(parser, ...args);\n return this;\n }\n\n /**\n * Attaches a schema mapping for this request. Schemas are\n * mapped to HTTP Status Codes, and if configured to be required the request will fail\n * if no schema is found matching that code.\n *\n * The status code mapping can be defined as a single code, a range of codes, or a spread list.\n *\n * ```ts\n * \\@Fixture(INJECTION_SCOPE.TRANSIENT)\n * export class UserController extends BaseController {\n * constructor(private readonly http: HTTP) {\n * super(http);\n * this.http\n * .sharedRoute(\"user\")\n * .schema(ErrorSchema, { from: 400, to: 499 });\n * }\n *\n * getUser(id: number) {\n * return this.http.route(id).schema(UserSchema, 200).get();\n * }\n *\n * getUsers(...ids: number[]) {\n * return this.http\n * .route(\"users\")\n * .schema(UserSchema, { from: 200, to: 299 })\n * .schema(UserSchema, 200)\n * .get();\n * }\n * ```\n *\n * This method is a request chain method, and will return a new instance of HTTP, inheriting\n * any schemas previously defined and appending the new schema. Useful to configure\n * in class methods as part of finalizing a request.\n *\n * @param parser The schema parser to use for this mapping.\n * @param codes A single status code, a range of status codes, or a spread list of status codes.\n * @returns A new child instance of HTTP derived from this one.\n */\n schema(parser: SchemaParser, ...codes: StatusCode[]): HTTP;\n schema(\n parser: SchemaParser,\n ...range: { from: StatusCode; to: StatusCode }[]\n ): HTTP;\n schema(\n parser: SchemaParser,\n ...args: (StatusCode | { from: StatusCode; to: StatusCode })[]\n ): HTTP {\n return HTTP.create(\n this.client,\n this.#request.derive(),\n this.#metaConfig.derive().schema(parser, ...args)\n );\n }\n\n /**\n * Attaches a shared query string parameter to all requests by this client. Query string\n * parameters are key-value pairs which are appended to the request url, such as\n * `https://api.example.com?name=John&age=30`.\n *\n * This method is a shared chain method, and will return the same instance of HTTP. All\n * child clients will inherit the query string parameters defined by this method. Useful to configure\n * in the constructor body.\n *\n * @param name The name of the query string parameter.\n * @param value The value of the query string parameter.\n * @returns This instance of HTTP.\n */\n sharedParam(name: string, value: Record<string, unknown>): HTTP;\n sharedParam(name: string, ...value: (string | number | boolean)[]): HTTP;\n sharedParam(\n name: string,\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n value: any\n ): HTTP {\n this.#request.param(name, value);\n return this;\n }\n\n /**\n * `onSend` is a pre-request hook which will be executed in order of definition\n * immediately before the request is sent. This hook can be used to analyze or\n * log the request state.\n *\n * ```ts\n *\n * \\@Fixture(INJECTION_SCOPE.TRANSIENT)\n * export class UserController extends BaseController {\n * constructor(private readonly http: HTTP) {\n * super(http);\n * this.http\n * .sharedRoute(\"user\")\n * .sharedOnSend(\"log request\",\n * (request) => console.log(JSON.stringify(request, null, 2))\n * );\n * }\n * }\n * ```\n *\n * This method is a shared chain method, and will return the same instance of HTTP. All\n * child clients will inherit the onSend hooks defined by this method. Useful to configure\n * in the constructor body.\n *\n * @param description A description of the hook, used for debugging.\n * @param hook The hook to execute.\n * @returns This instance of HTTP.\n */\n sharedOnSend(description: string, hook: RequestHook) {\n this.#metaConfig.onBeforeSend(description, hook);\n return this;\n }\n\n /**\n * `onReceive` is a post-request hook which will be executed in order of definition\n * immediately after the response is received. This hook can be used to analyze or\n * log the response state.\n *\n * ```ts\n *\n * \\@Fixture(INJECTION_SCOPE.TRANSIENT)\n * export class UserController extends BaseController {\n * constructor(private readonly http: HTTP) {\n * super(http);\n * this.http\n * .sharedRoute(\"user\")\n * .sharedOnReceive(\"log response\",\n * (response) => console.log(JSON.stringify(response, null, 2))\n * );\n * }\n * }\n * ```\n *\n * This method is a shared chain method, and will return the same instance of HTTP. All\n * child clients will inherit the onReceive hooks defined by this method. Useful to configure\n * in the constructor body.\n *\n * @param description A description of the hook, used for debugging.\n * @param hook The hook to execute.\n * @returns This instance of HTTP.\n */\n sharedOnReceive(description: string, hook: ResponseHook<unknown>) {\n this.#metaConfig.onReceiveResponse(description, hook);\n return this;\n }\n\n /**\n * Attaches a query string parameter object to the request. Query string\n * parameters are key-value pairs which are appended to the request url, such as\n * `https://api.example.com?name=John&age=30`.\n *\n * This method is a shared chain method, and will return the same instance of HTTP. All\n * child clients will inherit the query string parameters defined by this method. Useful to configure\n * in the constructor body.\n *\n * ```ts\n * constructor(http: HTTP) {\n * super(http);\n * this.http\n * .sharedParams({ 'is-test': \"true\" })\n * ```\n * @param name The name of the query string parameter.\n * @param value The value of the query string parameter.\n * @returns This instance of HTTP.\n */\n sharedParams(dict: Record<string, unknown>) {\n this.#request.params(dict);\n return this;\n }\n\n /**\n * Attaches a query string parameter to the request. Query string\n * parameters are key-value pairs which are appended to the request url, such as\n * `https://api.example.com?name=John&age=30`.\n *\n * This method is a request chain method, and will return a new instance of HTTP, inheriting\n * any query string parameters previously defined and appending the new parameter. Useful to configure\n * in class methods as part of finalizing a request.\n *\n * ```ts\n * getUser(id: number) {\n * return this.http\n * .route(id)\n * .param(\"name\", \"John\")\n * .param(\"age\", 30)\n * ```\n *\n * Note: Numbers and Booleans will be converted to strings automatically.\n *\n * @param name The name of the query string parameter.\n * @param value The value of the query string parameter.\n * @returns A new child instance of HTTP derived from this one.\n */\n param(name: string, value: Record<string, unknown>): HTTP;\n param(name: string, ...value: (string | number | boolean)[]): HTTP;\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n param(name: string, value: any) {\n return HTTP.create(this.client, this.#request.derive().param(name, value));\n }\n\n /**\n * Attaches a query string parameter object to the request. Query string\n * parameters are key-value pairs which are appended to the request url, such as\n * `https://api.example.com?name=John&age=30`.\n *\n * This method is a shared chain method, and will return the same instance of HTTP. All\n * child clients will inherit the query string parameters defined by this method. Useful to configure\n * in the constructor body.\n *\n * ```ts\n * getUser(id: number) {\n * return this.http\n * .route(id)\n * .param({ name: \"John\", age: \"30\" })\n *\n * @param name The name of the query string parameter.\n * @param value The value of the query string parameter.\n * @returns This instance of HTTP.\n */\n params(dict: Record<string, string>) {\n this.#request.params(dict);\n return HTTP.create(this.client, this.#request.derive().params(dict));\n }\n\n /**\n * Attaches a shared data payload to this client. The data payload is the body of the request,\n * and can be any type. If the data payload is an object, it will be serialized to JSON.\n *\n * This method is a shared chain method, and will return the same instance of HTTP. All\n * child clients will inherit the data payload defined by this method. Useful to configure\n * in the constructor body.\n *\n * @param data The data payload to attach to the request.\n * @returns This instance of HTTP.\n */\n sharedData<T>(data: T) {\n this.#request.data(data);\n return this;\n }\n\n /**\n * Attaches a shared header to this client. Headers are string:string key-value pairs which are\n * sent with the request, such as `Content-Type: application/json`.\n *\n * Numbers, Booleans and Null will be converted to string values automatically.\n *\n * A Factory function can also be provided to generate the header value at the time of request.\n *\n * This method is a shared chain method, and will return the same instance of HTTP. All\n * child clients will inherit the header defined by this method. Useful to configure\n * in the constructor body.\n *\n * @param name The name of the header.\n * @param value The value of the header.\n */\n sharedHeader(\n name: string,\n value:\n | string\n | number\n | boolean\n | null\n | (string | number | boolean)[]\n | (() => string | number | boolean | null)\n | (() => Promise<string | number | boolean | null>)\n ) {\n this.#request.header(name, value);\n return this;\n }\n\n header(\n name: string,\n value:\n | string\n | number\n | boolean\n | null\n | (string | number | boolean)[]\n | (() => string | number | boolean | null)\n | (() => Promise<string | number | boolean | null>)\n ) {\n return HTTP.create(this.client, this.#request.derive().header(name, value));\n }\n\n /**\n * Attaches a data payload to this request. The data payload is the body of the request,\n * and can be any type. If the data payload is an object, it will be serialized to JSON.\n *\n * This method is a request chain method, and will return a new instance of HTTP, inheriting\n * any data payload previously defined and appending the new payload. Useful to configure\n * in class methods as part of finalizing a request.\n *\n * @param data The data payload to attach to the request.\n * @returns A new child instance of HTTP derived from this one.\n */\n data<T>(data: T) {\n this.#request.data(data);\n return HTTP.create(this.client, this.#request.derive().data(data));\n }\n\n /**\n * `onSend` is a pre-request hook which will be executed in order of definition\n * immediately before the request is sent. This hook can be used to modify the request,\n * or to log the state of a request before final send-off.\n *\n * ```ts\n *\n * \\@Fixture(INJECTION_SCOPE.TRANSIENT)\n * export class UserController extends BaseController {\n * constructor(private readonly http: HTTP) {\n * super(http);\n * }\n *\n * getUser(id: number) {\n * return this.http\n * .route(id)\n * .onSend(\"log request\",\n * (request) => console.log(JSON.stringify(request, null, 2)\n * )\n * .get();\n * }\n * ```\n *\n * This method is a request chain method, and will return a new instance of HTTP, inheriting\n * any onSend hooks previously defined and appending the new hook. Useful to configure\n * in class methods as part of finalizing a request.\n *\n * @param description A description of the hook, used for debugging.\n * @param hook The hook to execute.\n * @returns A new child instance of HTTP derived from this one.\n */\n onSend(description: string, hook: RequestHook) {\n return HTTP.create(\n this.client,\n this.#request.derive(),\n this.#metaConfig.derive().onBeforeSend(description, hook)\n );\n }\n\n /**\n * `onReceive` is a post-request hook which will be executed in order of definition\n * immediately after the response is received. This hook can be used to modify the response,\n * or to log the state of a response after it is received.\n *\n * ```ts\n *\n * \\@Fixture(INJECTION_SCOPE.TRANSIENT)\n * export class UserController extends BaseController {\n * constructor(private readonly http: HTTP) {\n * super(http);\n * }\n *\n * getUser(id: number) {\n * return this.http\n * .route(id)\n * .onReceive(\"log response\",\n * (response) => console.log(JSON.stringify(response, null, 2)\n * )\n * .get();\n * }\n * ```\n *\n * This method is a request chain method, and will return a new instance of HTTP, inheriting\n * any onReceive hooks previously defined and appending the new hook. Useful to configure\n * in class methods as part of finalizing a request.\n *\n * @param description A description of the hook, used for debugging.\n * @param hook The hook to execute.\n * @returns A new child instance of HTTP derived from this one.\n */\n onReceive(description: string, hook: ResponseHook<unknown>) {\n return HTTP.create(\n this.client,\n this.#request.derive(),\n this.#metaConfig.derive().onReceiveResponse(description, hook)\n );\n }\n\n /**\n * Executes the current request state as a GET request.\n *\n * @param options Additional options to pass to the underlying http client, such\n * as e.g Axios configuration values.\n * @returns A promise which resolves to the response.\n */\n get<TResponseType>(options?: HTTPAdditionalOptions<unknown>) {\n return this.#makeRequest(\n this.#request.derive().method(\"GET\"),\n options\n ) as Promise<HTTPResponse<TResponseType>>;\n }\n\n /**\n * Executes the current request state as a POST request.\n *\n * @param data The data payload to attach to the request.\n * @param options Additional options to pass to the underlying http client, such\n * as e.g Axios configuration values.\n * @returns A promise which resolves to the response.\n */\n post<TResponseType>(options?: HTTPAdditionalOptions<unknown>) {\n return this.#makeRequest(\n this.#request.derive().method(\"POST\"),\n options\n ) as Promise<HTTPResponse<TResponseType>>;\n }\n\n /**\n * Executes the current request state as a DELETE request.\n *\n * @param options Additional options to pass to the underlying http client, such\n * as e.g Axios configuration values.\n * @returns A promise which resolves to the response.\n * as e.g Axios configuration values.\n */\n delete<TResponseType>(options?: HTTPAdditionalOptions<unknown>) {\n return this.#makeRequest(\n this.#request.derive().method(\"DELETE\"),\n options\n ) as Promise<HTTPResponse<TResponseType>>;\n }\n\n /**\n * Executes the current request state as a PUT request.\n *\n * @param options Additional options to pass to the underlying http client, such\n * as e.g Axios configuration values.\n * @returns A promise which resolves to the response.\n */\n put<TResponseType>(options?: HTTPAdditionalOptions<unknown>) {\n return this.#makeRequest(\n this.#request.derive().method(\"PUT\"),\n options\n ) as Promise<HTTPResponse<TResponseType>>;\n }\n /**\n * Executes the current request state as a PATCH request.\n *\n * @param options Additional options to pass to the underlying http client, such\n * as e.g Axios configuration values.\n * @returns A promise which resolves to the response.\n */\n patch<TResponseType>(options?: HTTPAdditionalOptions<unknown>) {\n return this.#makeRequest(\n this.#request.derive().method(\"PATCH\"),\n options\n ) as Promise<HTTPResponse<TResponseType>>;\n }\n\n head<TResponseType>(options?: HTTPAdditionalOptions<unknown>) {\n return this.#makeRequest(\n this.#request.derive().method(\"HEAD\"),\n options\n ) as Promise<HTTPResponse<TResponseType>>;\n }\n\n options<TResponseType>(options?: HTTPAdditionalOptions<unknown>) {\n return this.#makeRequest(\n this.#request.derive().method(\"OPTIONS\"),\n options\n ) as Promise<HTTPResponse<TResponseType>>;\n }\n\n trace<TResponseType>(options?: HTTPAdditionalOptions<unknown>) {\n return this.#makeRequest(\n this.#request.derive().method(\"TRACE\"),\n options\n ) as Promise<HTTPResponse<TResponseType>>;\n }\n\n connect<TResponseType>(options?: HTTPAdditionalOptions<unknown>) {\n return this.#makeRequest(\n this.#request.derive().method(\"CONNECT\"),\n options\n ) as Promise<HTTPResponse<TResponseType>>;\n }\n\n async #makeRequest(\n builder: HTTPRequestBuilder<HTTPRequest<unknown>>,\n options?: HTTPAdditionalOptions<unknown>\n ) {\n const request = (await builder.resolveDynamicHeaders()).build();\n const meta = this.#metaConfig.derive().build();\n await this.runOnSendHooks(meta, request);\n const result = await this.client.request<unknown, string>(request, options);\n result.data = transformResponse(meta.allowPlainText, result.data);\n await this.runOnReceiveHooks(meta, result);\n const validated = this.#validateResponse(result, meta);\n return validated;\n }\n\n private async runOnSendHooks(\n meta: MetaConfig,\n request: HTTPRequest<unknown>\n ) {\n for (const [description, hook] of meta.onSend) {\n try {\n await hook(request);\n } catch (e) {\n const cause = e as Error;\n const msg = `An error occurred while sending a request in hook: '${description}'`;\n throw new AutomationError(msg, { cause });\n }\n }\n }\n private async runOnReceiveHooks(\n meta: MetaConfig,\n response: HTTPResponse<unknown>\n ) {\n for (const [description, hook] of meta.onReceive) {\n try {\n await hook(response);\n } catch (e) {\n const cause = e as Error;\n const msg = `An error occurred while receiving a response in hook: '${description}'`;\n throw new AutomationError(msg, { cause });\n }\n }\n }\n\n #validateResponse<T>(\n response: HTTPResponse<unknown>,\n meta: MetaConfig\n ): HTTPResponse<T> {\n const { status, data } = response;\n const validated = meta.schemas.validate(\n status,\n data,\n meta.requireSchema\n ) as T;\n response.data = validated;\n return response as HTTPResponse<T>;\n }\n}\n","import { Class } from \"@autometa/types\";\nimport { defaultClient, type HTTPClient } from \"./http-client\";\n\nexport function defaultClientFactory() {\n const type = defaultClient as Class<HTTPClient>;\n return new type();\n}\n","import { RequestConfig, RequestConfigBasic } from \"./request.config\";\nimport { HTTPMethod } from \"./types\";\nimport { urlJoinP } from \"url-join-ts\";\nexport class HTTPRequest<T = unknown> implements RequestConfig<T> {\n headers: Record<string, string> = {};\n params: Record<string, string | string[] | Record<string, unknown>> = {};\n baseUrl?: string;\n route: string[] = [];\n method: HTTPMethod;\n data: T;\n\n constructor(config?: RequestConfigBasic) {\n Object.assign(this, config);\n }\n\n /**\n * Returns the full URL of the request, including the base url,\n * routes, and query parameters.\n *\n * ```ts\n * console.log(request.fullUrl())// https://example.com/foo?bar=baz?array=1,2,3\n * ```\n *\n * Note characters may be converted to escape codes. I.e (space => %20) and (comma => %2C)\n *\n * N.B this getter estimates what the url will be. The actual value\n * might be different depending on your underlying HTTPClient and\n * configuration. For example, query parameters might\n * use different array formats.\n */\n get fullUrl() {\n return urlJoinP(this.baseUrl, this.route, this.params);\n }\n\n /**\n * Returns a new independent copy of the request.\n */\n static derive(original: HTTPRequest<unknown>) {\n const request = new HTTPRequest();\n request.headers = { ...original.headers };\n request.params = { ...original.params };\n request.baseUrl = original.baseUrl;\n request.route = [...original.route];\n request.method = original.method;\n request.data = original.data;\n return request;\n }\n}\n\nexport class HTTPRequestBuilder<T extends HTTPRequest<unknown>> {\n #request: T;\n #dynamicHeaders = new Map<\n string,\n | (() => string | number | boolean | null)\n | (() => Promise<string | number | boolean | null>)\n >();\n\n constructor(request: T | (() => T) = () => new HTTPRequest() as T) {\n if (typeof request === \"function\") {\n this.#request = request();\n return;\n }\n this.#request = request;\n }\n\n static create<T extends HTTPRequest<unknown>>() {\n return new HTTPRequestBuilder<T>();\n }\n\n get request() {\n return this.#request;\n }\n\n async resolveDynamicHeaders() {\n for (const [name, value] of this.#dynamicHeaders) {\n try {\n this.#request.headers[name] = String(await value());\n } catch (e) {\n const cause = e as Error;\n const msg = `Failed to resolve dynamic header \"${name}\": \n${cause}`;\n throw new Error(msg);\n }\n }\n return this;\n }\n\n url(url: string) {\n this.#request.baseUrl = url;\n return this;\n }\n\n route(...route: string[]) {\n this.#request.route.push(...route);\n return this;\n }\n\n param(\n name: string,\n value:\n | string\n | number\n | boolean\n | (string | number | boolean)[]\n | Record<string, string | number | boolean>\n ) {\n if (Array.isArray(value)) {\n const asStr = value.map(String);\n this.#request.params[name] = asStr;\n return this;\n }\n if (!Array.isArray(value) && typeof value === \"object\") {\n this.#request.params[name] = value;\n return this;\n }\n this.#request.params[name] = String(value);\n return this;\n }\n\n params(dict: Record<string, unknown>) {\n Object.assign(this.#request.params, dict);\n return this;\n }\n\n data<T>(data: T) {\n this.#request.data = data;\n return this;\n }\n\n header(\n name: string,\n value:\n | string\n | number\n | boolean\n | null\n | (string | number | boolean)[]\n | (() => string | number | boolean | null)\n | (() => Promise<string | number | boolean | null>)\n ) {\n if (typeof value === \"function\") {\n this.#dynamicHeaders.set(name, value);\n }\n const val = Array.isArray(value) ? value.join(\",\") : String(value);\n this.#request.headers[name] = val;\n return this;\n }\n\n headers(dict: Record<string, string>) {\n Object.assign(this.#request.headers, dict);\n return this;\n }\n\n get() {\n return this.#request;\n }\n\n method(method: HTTPMethod) {\n this.#request.method = method;\n return this;\n }\n\n derive(): HTTPRequestBuilder<T> {\n const request = HTTPRequest.derive(this.#request);\n return new HTTPRequestBuilder(request) as HTTPRequestBuilder<T>;\n }\n\n build(): HTTPRequest<T> {\n return this.#request as HTTPRequest<T>;\n }\n}\n","import { SchemaParser, StatusCode } from \"./types\";\nexport class SchemaMap {\n #map: Map<StatusCode, SchemaParser>;\n constructor(map?: Map<StatusCode, SchemaParser> | SchemaMap) {\n if (map instanceof SchemaMap) {\n this.#map = new Map(map.#map);\n return;\n }\n this.#map = new Map(map);\n }\n\n derive() {\n return new SchemaMap(this.#map);\n }\n\n registerStatus(parser: SchemaParser, ...codes: StatusCode[]) {\n codes.forEach((code) => {\n if (this.#map.has(code)) {\n const msg = `Status code ${code} is already registered with a parser`;\n throw new Error(msg);\n }\n this.#map.set(code, parser);\n });\n }\n\n registerRange(parser: SchemaParser, from: StatusCode, to: StatusCode) {\n for (let i = from; i <= to; i++) {\n if (this.#map.has(i)) {\n throw new Error(`Status code ${i} is already registered with a parser`);\n }\n this.#map.set(i, parser);\n }\n }\n\n validate(status: StatusCode, data: unknown, requireSchema: boolean) {\n const parser = this.getParser(status, requireSchema);\n if (\"parse\" in parser) {\n return parser.parse(data);\n }\n if('validate' in parser) {\n return parser.validate(data);\n }\n try {\n return parser(data);\n } catch (e) {\n const msg = `Failed to schema parse response data for status code ${status} with data:\n \n${JSON.stringify(data, null, 2)}}`;\n throw new Error(msg);\n }\n }\n\n getParser(status: StatusCode, requireSchema: boolean) {\n const parser = this.#map.get(status);\n if (!parser && requireSchema) {\n const msg = `No parser registered for status code ${status} but 'requireSchema' is true`;\n throw new Error(msg);\n }\n if (parser) {\n return parser;\n }\n return (data: unknown) => data;\n }\n\n toObject() {\n return Object.fromEntries(this.#map) as Record<StatusCode, SchemaParser>;\n }\n}\n","import { SchemaMap } from \"./schema.map\";\nimport { RequestHook, ResponseHook, SchemaParser, StatusCode } from \"./types\";\n\nexport interface SchemaConfig {\n schemas: SchemaMap;\n requireSchema: boolean;\n allowPlainText: boolean;\n}\n\nexport interface HTTPHooks {\n onSend: [string, RequestHook][];\n onReceive: [string, ResponseHook<unknown>][];\n}\n\n// export type MetaConfig = SchemaConfig & HTTPHooks;\n\nexport class MetaConfig implements SchemaConfig, HTTPHooks {\n schemas: SchemaMap;\n requireSchema: boolean;\n allowPlainText: boolean;\n onSend: [string, RequestHook][] = [];\n onReceive: [string, ResponseHook<unknown>][] = [];\n throwOnServerError: boolean;\n}\n\nexport class MetaConfigBuilder {\n #schemaMap = new SchemaMap();\n #requireSchema = false;\n #allowPlainText = false;\n #onBeforeSend: [string, RequestHook][] = [];\n #onAfterSend: [string, ResponseHook<unknown>][] = [];\n #throwOnServerError = false;\n\n schemaMap(map: SchemaMap) {\n this.#schemaMap = map;\n return this;\n }\n\n schema(parser: SchemaParser, ...codes: StatusCode[]): MetaConfigBuilder;\n schema(\n parser: SchemaParser,\n ...range: { from: StatusCode; to: StatusCode }[]\n ): MetaConfigBuilder;\n schema(\n parser: SchemaParser,\n ...args: (StatusCode | { from: StatusCode; to: StatusCode })[]\n ): MetaConfigBuilder;\n schema(\n parser: SchemaParser,\n ...args: (StatusCode | { from: StatusCode; to: StatusCode })[]\n ) {\n args.forEach((arg) => {\n if (typeof arg === \"number\") {\n this.#schemaMap.registerStatus(parser, arg);\n } else {\n this.#schemaMap.registerRange(parser, arg.from, arg.to);\n }\n });\n\n return this;\n }\n\n requireSchema(value: boolean) {\n this.#requireSchema = value;\n return this;\n }\n\n allowPlainText(value: boolean) {\n this.#allowPlainText = value;\n return this;\n }\n\n onBeforeSend(description: string, hook: RequestHook) {\n this.#onBeforeSend.push([description, hook]);\n return this;\n }\n\n #setOnSend(hooks: [string, RequestHook][]) {\n this.#onBeforeSend = hooks;\n return this;\n }\n\n throwOnServerError(value: boolean) {\n this.#throwOnServerError = value;\n return this;\n }\n\n onReceiveResponse(description: string, hook: ResponseHook<unknown>) {\n this.#onAfterSend.push([description, hook]);\n return this;\n }\n\n #setOnReceive(hooks: [string, ResponseHook<unknown>][]) {\n this.#onAfterSend = hooks;\n return this;\n }\n\n build() {\n const config = new MetaConfig();\n config.schemas = this.#schemaMap.derive();\n config.requireSchema = this.#requireSchema;\n config.allowPlainText = this.#allowPlainText;\n config.onSend = this.#onBeforeSend;\n config.onReceive = this.#onAfterSend;\n return config;\n }\n\n derive() {\n return new MetaConfigBuilder()\n .schemaMap(this.#schemaMap.derive())\n .requireSchema(this.#requireSchema)\n .allowPlainText(this.#allowPlainText)\n .throwOnServerError(this.#throwOnServerError)\n .#setOnSend(this.#onBeforeSend)\n .#setOnReceive(this.#onAfterSend);\n }\n}\n","import { AutomationError } from \"@autometa/errors\";\nimport isJson from \"@stdlib/assert-is-json\";\nimport { highlight } from \"cli-highlight\";\n\nexport function transformResponse(\n allowPlainText: boolean,\n data: null | undefined | string\n) {\n if (data === null) {\n return null;\n }\n if (data === undefined) {\n return undefined;\n }\n if (data === \"\") {\n return data;\n }\n if (isJson(data)) {\n return JSON.parse(data);\n }\n if (typeof data === \"string\" && [\"true\", \"false\"].includes(data)) {\n return JSON.parse(data);\n }\n if (typeof data === \"string\" && /^\\d*\\.?\\d+$/.test(data)) {\n return JSON.parse(data);\n }\n\n if (typeof data === \"object\") {\n return data;\n }\n if (allowPlainText) {\n return data;\n }\n\n const response = highlight(data, { language: \"html\" });\n const message = [\n `Could not parse a response as json, and this request was not configured to allow plain text responses.`,\n `To allow plain text responses, use the 'allowPlainText' method on the HTTP client.`,\n \"\",\n response\n ];\n throw new AutomationError(message.join(\"\\n\"));\n}\n","import isJson from \"@stdlib/assert-is-json\";\n\n/**\n * Schema which does not care about data validation.\n *\n * Useful if `requireSchema` is set to true, but a specific\n * endpoints response does not matter.\n * @param data\n * @returns\n */\nexport function AnySchema(data: unknown) {\n return data;\n}\n\n/**\n * Schema which validates that a response is empty. This can mean\n * the data payload was `null`, `undefined` or the string `'null'`.\n *\n * Useful if `requireSchema` is set to true, but a specific\n * endpoints response should be null or not defined.\n * @param data\n * @returns\n */\nexport function EmptySchema(data: unknown) {\n if (data !== null && data !== undefined && data !== \"null\") {\n throw new Error(`Expected null but got <${typeof data}> for ${data}`);\n }\n return data === \"null\" ? null : data;\n}\n\n/**\n * Schema which validates a response was null.\n *\n * Useful if `requireSchema` is set to true, but a specific\n * endpoints response should be null.\n * @param data\n * @returns\n */\nexport function NullSchema(data: unknown) {\n if (data !== null && data !== \"null\") {\n throw new Error(`Expected null but got <${typeof data}> for ${data}`);\n }\n return null;\n}\n\n/**\n * Schema which validates a response was undefined.\n *\n * Useful if `requireSchema` is set to true, but a specific\n * endpoints response should be undefined.\n *\n * @param data\n * @returns\n */\nexport function UndefinedSchema(data: unknown) {\n if (data !== undefined) {\n throw new Error(`Expected undefined but got <${typeof data}> for ${data}`);\n }\n return undefined;\n}\n\n/**\n * Schema which validates a response was a boolean, or a string of value\n * `'true'` or `'false'`.\n *\n * Useful if `requireSchema` is set to true, but a specific\n * endpoints response should be a boolean.\n *\n * @param data\n * @returns\n */\nexport function BooleanSchema(data: unknown) {\n if (\n !(typeof data === \"boolean\") &&\n [\"true\", \"false\"].includes(String(data)) === false\n ) {\n throw new Error(`Expected boolean but got <${typeof data}> for ${data}`);\n }\n return JSON.parse(data as string);\n}\n\n/**\n * Schema which validates a response was a number, or a string of value\n * of a number.\n *\n * Useful if `requireSchema` is set to true, but a specific\n * endpoints response should be a number.\n *\n * @param data\n * @returns\n */\nexport function NumberSchema(data: unknown) {\n if (\n !(typeof data === \"number\") &&\n /^\\d*\\.?\\d+$/.test(String(data)) === false\n ) {\n throw new Error(`Expected number but got <${typeof data}> for ${data}`);\n }\n return JSON.parse(data as string);\n}\n\n/**\n * Schema which validates a response was a string.\n *\n * Useful if `requireSchema` is set to true, but a specific\n * endpoints response should be a string.\n *\n * @param data\n * @returns\n */\nexport function StringSchema(data: unknown) {\n if (typeof data !== \"string\") {\n throw new Error(`Expected string but got <${typeof data}> for ${data}`);\n }\n return data;\n}\n\n\nexport function JSONSchema<T = unknown>(data: unknown) {\n if(typeof data === 'object') {\n return data as T;\n }\n if (!isJson(data)) {\n throw new Error(`Expected JSON but got <${typeof data}> for ${data}`);\n }\n const result = JSON.parse(data);\n return result;\n}"],"mappings":"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","names":["AutomationError","_request","AutomationError","isJson"]}
|
|
1
|
+
{"version":3,"sources":["../../src/http-response.ts","../../src/axios-client.ts","../../src/http-client.ts","../../src/http.ts","../../src/default-client-factory.ts","../../src/http-request.ts","../../src/schema.map.ts","../../src/request-meta.config.ts","../../src/transform-response.ts","../../src/default-schema.ts"],"sourcesContent":["import { HTTPRequest } from \"./http-request\";\nimport { StatusCode } from \"./types\";\n\nexport class HTTPResponse<T = unknown> {\n status: StatusCode;\n statusText: string;\n data: T;\n headers: Record<string, string>;\n request: HTTPRequest<unknown>;\n\n constructor() {\n this.headers = {};\n }\n\n static fromRaw<T>(response: HTTPResponse<T>) {\n const newResponse = new HTTPResponse<T>();\n Object.assign(newResponse, response);\n return response;\n }\n\n /**\n * Decomposes a response, creating an exact copy of the current response,\n * but with a new data value. The data can be provided directly as is, or it\n * can be generated through a callback function which receives the current\n * response data as an argument.\n *\n * ```ts\n * const response = await http.get(\"/products\");\n *\n * // direct value\n * const products = response.data;\n * const firstProduct = response.decompose(products[0]);\n * // callback transformer\n * const secondProduct = response.decompose((products) => products[1]);\n * // callback transformer with destructuring\n * const secondProduct = response.decompose(([product]) => product);\n * ```\n * @param value\n */\n decompose<K>(value: K): HTTPResponse<K>;\n decompose<K>(transformFn: (response: T) => K): HTTPResponse<K>;\n decompose<K>(transformFnOrVal: K | ((response: T) => K)): HTTPResponse<K> {\n const value = getDecompositionValue<T>(this.data, transformFnOrVal);\n return new HTTPResponseBuilder()\n .status(this.status)\n .statusText(this.statusText)\n .headers(this.headers)\n .request(this.request)\n .data(value)\n .build() as HTTPResponse<K>;\n }\n}\n\nfunction getDecompositionValue<T>(data: unknown, transformFn: unknown): T {\n return typeof transformFn === \"function\" ? transformFn(data) : transformFn;\n}\n\nexport class HTTPResponseBuilder {\n #response = new HTTPResponse();\n\n static create() {\n return new HTTPResponseBuilder();\n }\n\n derive() {\n return HTTPResponseBuilder.create()\n .data(this.#response.data)\n .headers(this.#response.headers)\n .request(this.#response.request)\n .status(this.#response.status)\n .statusText(this.#response.statusText);\n }\n\n status(code: StatusCode) {\n this.#response.status = code;\n return this;\n }\n\n statusText(text: string) {\n this.#response.statusText = text;\n return this;\n }\n\n data<T>(data: T) {\n this.#response.data = data;\n return this;\n }\n\n headers(dict: Record<string, string>) {\n this.#response.headers = dict;\n return this;\n }\n\n header(name: string, value: string) {\n this.#response.headers[name] = value;\n return this;\n }\n\n request(request: HTTPRequest<unknown>) {\n this.#response.request = request;\n return this;\n }\n\n build() {\n return this.#response;\n }\n}\n","import { HTTPRequest } from \"./http-request\";\nimport { HTTPResponse, HTTPResponseBuilder } from \"./http-response\";\nimport { HTTPAdditionalOptions, StatusCode } from \"./types\";\nimport axios, { AxiosRequestConfig } from \"axios\";\nimport { HTTPClient } from \"./http-client\";\n\n@HTTPClient.Use()\nexport class AxiosClient extends HTTPClient {\n async request<TRequestType, TResponseType>(\n request: HTTPRequest<TRequestType>,\n options: HTTPAdditionalOptions<AxiosRequestConfig>\n ): Promise<HTTPResponse<TResponseType>> {\n const { baseUrl, route, params, headers, method, data } = request;\n const url = [baseUrl, ...route].join(\"/\");\n const axiosRequest: AxiosRequestConfig = {\n url,\n params,\n headers,\n method: method,\n data,\n validateStatus: function (status) {\n return status >= 0 && status < 600;\n },\n ...options\n };\n const response = await axios(axiosRequest);\n return HTTPResponseBuilder.create()\n .status(response.status as StatusCode)\n .statusText(response.statusText)\n .data(response.data)\n .headers(response.headers as Record<string, string>)\n .request(request)\n .build() as HTTPResponse<TResponseType>;\n }\n}\n","import { HTTPRequest } from \"./http-request\";\nimport { HTTPResponse } from \"./http-response\";\nimport { HTTPAdditionalOptions } from \"./types\";\nimport { Class } from \"@autometa/types\";\nexport let defaultClient: Class<HTTPClient>;\nexport abstract class HTTPClient {\n static Use(): (target: Class<HTTPClient>) => void\n static Use(client?: Class<HTTPClient>) {\n if (client) {\n defaultClient = client\n }\n return function (target: Class<HTTPClient>) {\n defaultClient = target\n };\n }\n abstract request<TRequestType, TResponseType>(\n request: HTTPRequest<TRequestType>,\n options?: HTTPAdditionalOptions<unknown>\n ): Promise<HTTPResponse<TResponseType>>;\n}\n","import { Fixture, INJECTION_SCOPE } from \"@autometa/injection\";\nimport { AxiosClient } from \"./axios-client\";\nimport { HTTPClient } from \"./http-client\";\nimport { defaultClientFactory } from \"./default-client-factory\";\nimport { HTTPRequest, HTTPRequestBuilder } from \"./http-request\";\nimport { HTTPResponse } from \"./http-response\";\nimport { MetaConfig, MetaConfigBuilder } from \"./request-meta.config\";\nimport {\n HTTPAdditionalOptions,\n RequestHook,\n ResponseHook,\n SchemaParser,\n StatusCode\n} from \"./types\";\nimport { transformResponse } from \"./transform-response\";\nimport { AutomationError } from \"@autometa/errors\";\n\n/**\n * The HTTP fixture allows requests to be built and sent to a server. In general,\n * there are 2 modes of operation:\n *\n * * Shared Chain: The shared chain is used to configure the client for all requests, such as\n * routes this instance will always be used. When a shared chain method is called, it returns\n * the same instance of HTTP which can be further chained to configure the client.\n * * Request Chain: The request chain is used to configure a single request, inheriting values\n * set by the shared chain. When called, a new HTTP client instance is created and inherits the values\n * set by it's parent.\n *\n * The 2 modes are intended to simplify configuring an object through an inheritance chain. For example,\n * assume we have an API with 2 controller routes, `/product` and `/seller`. We can set up a Base Client\n * which consumes the HTTP fixture and configures it with the base url of our API.\n *\n * Inheritors can further configure their HTTP instance's routes.\n *\n * ```ts\n * \\@Constructor(HTTP)\n * export class BaseClient {\n * constructor(protected readonly http: HTTP) {\n * this.http.url(\"https://api.example.com\");\n * }\n * }\n *\n * export class ProductClient extends BaseClient {\n * constructor(http: HTTP) {\n * super(http);\n * this.http.sharedRoute(\"product\");\n * }\n * getProduct(id: number) {\n * return this.http.route(id).get();\n * }\n *\n * export class SellerClient extends BaseClient {\n * constructor(http: HTTP) {\n * super(http);\n * this.http.sharedRoute(\"seller\");\n * }\n *\n * getSeller(id: number) {\n * return this.http.route(id).get();\n * }\n * }\n * ```\n *\n * 'Schemas' can also be configured. A Schema is a function or an object with a `parse` method, which\n * takes a response data payload and returns a validated object. Schemas are mapped to\n * HTTP Status Codes, and if configured to be required the request will fail if no schema is found\n * matching that code.\n *\n * Defining a schema function:\n *\n * ```\n * // user.schema.ts\n * export function UserSchema(data: unknown) {\n * if(typeof data !== \"object\") {\n * throw new Error(\"Expected an object\");\n * }\n *\n * if(typeof data.name !== \"string\") {\n * throw new Error(\"Expected a string\");\n * }\n *\n * return data as { name: string };\n * }\n *\n * // user.controller.ts\n * \\@Fixture(INJECTION_SCOPE.TRANSIENT)\n * export class UserController extends BaseController {\n * constructor(private readonly http: HTTP) {\n * super(http);\n * this.http\n * .sharedRoute(\"user\")\n * .sharedSchema(ErrorSchema, { from: 400, to: 499 });\n * }\n *\n * getUser(id: number) {\n * return this.http.route(id).schema(UserSchema, 200).get();\n * // or\n * return this.http\n * .route(id)\n * .schema(UserSchema, { from: 200, to: 299 })\n * .get();\n * // or\n * return this.http\n * .route(id)\n * .schema(UserSchema, 200, 201, 202)\n * .get();\n * }\n * }\n * ```\n *\n * Validation libraries which use a `.parse` or `.validation`, method, such as Zod or MyZod, can also be used as schemas:\n *\n * ```ts\n * // user.schema.ts\n * import { z } from \"myzod\";\n *\n * export const UserSchema = z.object({\n * name: z.string()\n * });\n *\n * // user.controller.ts\n * \\@Fixture(INJECTION_SCOPE.TRANSIENT)\n * export class UserController extends BaseController {\n * constructor(private readonly http: HTTP) {\n * super(http);\n * this.http\n * .sharedRoute(\"user\")\n * .sharedSchema(ErrorSchema, { from: 400, to: 499 })\n * }\n *\n * getUser(id: number) {\n * return this.http.route(id).schema(UserSchema, 200).get();\n * }\n * }\n * ```\n */\n@Fixture(INJECTION_SCOPE.TRANSIENT)\nexport class HTTP {\n #request: HTTPRequestBuilder<HTTPRequest<unknown>>;\n #metaConfig: MetaConfigBuilder;\n constructor(\n private readonly client: HTTPClient = defaultClientFactory(),\n builder: HTTPRequestBuilder<\n HTTPRequest<unknown>\n > = new HTTPRequestBuilder(),\n metaConfig: MetaConfigBuilder = new MetaConfigBuilder()\n ) {\n this.#request = builder;\n this.#metaConfig = metaConfig.derive();\n }\n\n static create(\n client: HTTPClient = new AxiosClient(),\n builder: HTTPRequestBuilder<\n HTTPRequest<unknown>\n > = new HTTPRequestBuilder(),\n metaConfig: MetaConfigBuilder = new MetaConfigBuilder()\n ) {\n return new HTTP(client, builder, metaConfig);\n }\n\n /**\n * Sets the base url of the request for this client, such as\n * `https://api.example.com`, and could include always-used routes like\n * the api version, such as `/v1` or `/api/v1` at the end.\n *\n * ```ts\n *\n * \\@Fixture(INJECTION_SCOPE.TRANSIENT)\n * export abstract class BaseClient {\n * constructor(protected readonly http: HTTP) {\n * this.http.url(\"https://api.example.com\");\n * }\n * }\n * ```\n * @param url\n * @returns\n */\n url(url: string) {\n this.#request.url(url);\n return this;\n }\n\n /**\n * If set to true, all requests derived from this client will require a schema be defined\n * matching any response status code. If set to false, a schema will still be used for validation\n * if defined, or the unadulterated original body will be returned if no schema matches.\n *\n * @param required Whether or not a schema is required for all responses.\n * @returns This instance of HTTP.\n */\n requireSchema(required: boolean) {\n this.#metaConfig.requireSchema(required);\n return this;\n }\n\n /**\n * If set to true, all requests derived from this client will allow plain text\n * responses. If set to false, plain text responses will throw an serialization error.\n *\n * Useful when an endpoint returns a HTML or plain text response. If the plain text\n * is the value of `true` or `false`, or a number, it will be parsed into the\n * appropriate type.\n *\n * This method is a shared chain method, and will return the same instance of HTTP.\n *\n * @param allow Whether or not plain text responses are allowed.\n * @returns This instance of HTTP.\n */\n sharedAllowPlainText(allow: boolean) {\n this.#metaConfig.allowPlainText(allow);\n return this;\n }\n\n /**\n * If set to true, all requests derived from this client will allow plain text\n * responses. If set to false, plain text responses will throw an serialization error.\n *\n * Useful when an endpoint returns a HTML or plain text response. If the plain text\n * is the value of `true` or `false`, or a number, it will be parsed into the\n * appropriate type.\n *\n * This method is a request chain method, and will return a new instance of HTTP.\n *\n * @param allow Whether or not plain text responses are allowed.\n * @returns A new child instance of HTTP derived from this one.\n */\n allowPlainText(allow: boolean) {\n return HTTP.create(\n this.client,\n this.#request.derive(),\n this.#metaConfig.derive().allowPlainText(allow)\n );\n }\n\n /**\n * Attaches a route to the request, such as `/product` or `/user`. Subsequent calls\n * to this method will append the route to the existing route, such as `/product/1`.\n *\n * Numbers will be converted to strings automatically. Routes can be defined one\n * at a time or as a spread argument.\n *\n * ```ts\n * constructor(http: HTTP) {\n * super(http);\n * this.http.sharedRoute(\"user\", id).get();\n * }\n *\n * // or\n *\n * constructor(http: HTTP) {\n * super(http);\n * this.http\n * .sharedRoute(\"user\")\n * .sharedRoute(id)\n * .get();\n * }\n * ```\n *\n * This method is a shared chain method, and will return the same instance of HTTP. All\n * child clients will inherit the routes defined by this method. Useful to configure\n * in the constructor body.\n *\n * @param route A route or spread list of routes to append to the request.\n * @returns This instance of HTTP.\n */\n sharedRoute(...route: (string | number | boolean)[]) {\n this.#request.route(...route.map((r) => r.toString()));\n return this;\n }\n\n /**\n * Attaches a route to the request, such as `/product` or `/user`. Subsequent calls\n * to this method will append the route to the existing route, such as `/product/1`.\n *\n * Numbers will be converted to strings automatically. Routes can be defined one\n * at a time or as a spread argument.\n *\n * ```ts\n * getUser(id: number) {\n * return this.http.route(\"user\", id).get();\n * }\n *\n * // or\n *\n * getUser(id: number) {\n * return this.http\n * .route(\"user\")\n * .route(id)\n * .get();\n * }\n * ```\n *\n * This method is a request chain method, and will return a new instance of HTTP, inheriting\n * any routes previously defined and appending the new route. Useful to configure\n * in class methods as part of finalizing a request.\n *\n * @param route A route or spread list of routes to append to the request.\n * @returns A new child instance of HTTP derived from this one.\n */\n route(...route: (string | number | boolean)[]) {\n const mapped = route.map((r) => String(r));\n return HTTP.create(this.client, this.#request.derive().route(...mapped));\n }\n\n /**\n * Attaches a shared schema mapping for all requests by this client. Schemas are\n * mapped to HTTP Status Codes, and if configured to be required the request will fail\n * if no schema is found matching that code.\n *\n * The status code mapping can be defined as a single code, a range of codes, or a spread list.\n *\n * ```ts\n * \\@Fixture(INJECTION_SCOPE.TRANSIENT)\n * export class UserController extends BaseController {\n * constructor(private readonly http: HTTP) {\n * super(http);\n * this.http\n * .sharedRoute(\"user\")\n * .sharedSchema(UserSchema, 200)\n * .sharedSchema(EmptySchema, 201, 204)\n * .sharedSchema(ErrorSchema, { from: 400, to: 499 });\n * }\n * }\n * ```\n *\n * This method is a shared chain method, and will return the same instance of HTTP. All\n * child clients will inherit the schemas defined by this method. Useful to configure\n * in the constructor body.\n *\n * @param parser The schema parser to use for this mapping.\n * @param codes A single status code, a range of status codes, or a spread list of status codes.\n * @returns This instance of HTTP.\n */\n sharedSchema(parser: SchemaParser, ...codes: StatusCode[]): HTTP;\n sharedSchema(\n parser: SchemaParser,\n ...range: { from: StatusCode; to: StatusCode }[]\n ): HTTP;\n sharedSchema(\n parser: SchemaParser,\n ...args: (StatusCode | { from: StatusCode; to: StatusCode })[]\n ): HTTP {\n this.#metaConfig.schema(parser, ...args);\n return this;\n }\n\n /**\n * Attaches a schema mapping for this request. Schemas are\n * mapped to HTTP Status Codes, and if configured to be required the request will fail\n * if no schema is found matching that code.\n *\n * The status code mapping can be defined as a single code, a range of codes, or a spread list.\n *\n * ```ts\n * \\@Fixture(INJECTION_SCOPE.TRANSIENT)\n * export class UserController extends BaseController {\n * constructor(private readonly http: HTTP) {\n * super(http);\n * this.http\n * .sharedRoute(\"user\")\n * .schema(ErrorSchema, { from: 400, to: 499 });\n * }\n *\n * getUser(id: number) {\n * return this.http.route(id).schema(UserSchema, 200).get();\n * }\n *\n * getUsers(...ids: number[]) {\n * return this.http\n * .route(\"users\")\n * .schema(UserSchema, { from: 200, to: 299 })\n * .schema(UserSchema, 200)\n * .get();\n * }\n * ```\n *\n * This method is a request chain method, and will return a new instance of HTTP, inheriting\n * any schemas previously defined and appending the new schema. Useful to configure\n * in class methods as part of finalizing a request.\n *\n * @param parser The schema parser to use for this mapping.\n * @param codes A single status code, a range of status codes, or a spread list of status codes.\n * @returns A new child instance of HTTP derived from this one.\n */\n schema(parser: SchemaParser, ...codes: StatusCode[]): HTTP;\n schema(\n parser: SchemaParser,\n ...range: { from: StatusCode; to: StatusCode }[]\n ): HTTP;\n schema(\n parser: SchemaParser,\n ...args: (StatusCode | { from: StatusCode; to: StatusCode })[]\n ): HTTP {\n return HTTP.create(\n this.client,\n this.#request.derive(),\n this.#metaConfig.derive().schema(parser, ...args)\n );\n }\n\n /**\n * Attaches a shared query string parameter to all requests by this client. Query string\n * parameters are key-value pairs which are appended to the request url, such as\n * `https://api.example.com?name=John&age=30`.\n *\n * This method is a shared chain method, and will return the same instance of HTTP. All\n * child clients will inherit the query string parameters defined by this method. Useful to configure\n * in the constructor body.\n *\n * @param name The name of the query string parameter.\n * @param value The value of the query string parameter.\n * @returns This instance of HTTP.\n */\n sharedParam(name: string, value: Record<string, unknown>): HTTP;\n sharedParam(name: string, ...value: (string | number | boolean)[]): HTTP;\n sharedParam(\n name: string,\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n value: any\n ): HTTP {\n this.#request.param(name, value);\n return this;\n }\n\n /**\n * `onSend` is a pre-request hook which will be executed in order of definition\n * immediately before the request is sent. This hook can be used to analyze or\n * log the request state.\n *\n * ```ts\n *\n * \\@Fixture(INJECTION_SCOPE.TRANSIENT)\n * export class UserController extends BaseController {\n * constructor(private readonly http: HTTP) {\n * super(http);\n * this.http\n * .sharedRoute(\"user\")\n * .sharedOnSend(\"log request\",\n * (request) => console.log(JSON.stringify(request, null, 2))\n * );\n * }\n * }\n * ```\n *\n * This method is a shared chain method, and will return the same instance of HTTP. All\n * child clients will inherit the onSend hooks defined by this method. Useful to configure\n * in the constructor body.\n *\n * @param description A description of the hook, used for debugging.\n * @param hook The hook to execute.\n * @returns This instance of HTTP.\n */\n sharedOnSend(description: string, hook: RequestHook) {\n this.#metaConfig.onBeforeSend(description, hook);\n return this;\n }\n\n /**\n * `onReceive` is a post-request hook which will be executed in order of definition\n * immediately after the response is received. This hook can be used to analyze or\n * log the response state.\n *\n * ```ts\n *\n * \\@Fixture(INJECTION_SCOPE.TRANSIENT)\n * export class UserController extends BaseController {\n * constructor(private readonly http: HTTP) {\n * super(http);\n * this.http\n * .sharedRoute(\"user\")\n * .sharedOnReceive(\"log response\",\n * (response) => console.log(JSON.stringify(response, null, 2))\n * );\n * }\n * }\n * ```\n *\n * This method is a shared chain method, and will return the same instance of HTTP. All\n * child clients will inherit the onReceive hooks defined by this method. Useful to configure\n * in the constructor body.\n *\n * @param description A description of the hook, used for debugging.\n * @param hook The hook to execute.\n * @returns This instance of HTTP.\n */\n sharedOnReceive(description: string, hook: ResponseHook<unknown>) {\n this.#metaConfig.onReceiveResponse(description, hook);\n return this;\n }\n\n /**\n * Attaches a query string parameter object to the request. Query string\n * parameters are key-value pairs which are appended to the request url, such as\n * `https://api.example.com?name=John&age=30`.\n *\n * This method is a shared chain method, and will return the same instance of HTTP. All\n * child clients will inherit the query string parameters defined by this method. Useful to configure\n * in the constructor body.\n *\n * ```ts\n * constructor(http: HTTP) {\n * super(http);\n * this.http\n * .sharedParams({ 'is-test': \"true\" })\n * ```\n * @param name The name of the query string parameter.\n * @param value The value of the query string parameter.\n * @returns This instance of HTTP.\n */\n sharedParams(dict: Record<string, unknown>) {\n this.#request.params(dict);\n return this;\n }\n\n /**\n * Attaches a query string parameter to the request. Query string\n * parameters are key-value pairs which are appended to the request url, such as\n * `https://api.example.com?name=John&age=30`.\n *\n * This method is a request chain method, and will return a new instance of HTTP, inheriting\n * any query string parameters previously defined and appending the new parameter. Useful to configure\n * in class methods as part of finalizing a request.\n *\n * ```ts\n * getUser(id: number) {\n * return this.http\n * .route(id)\n * .param(\"name\", \"John\")\n * .param(\"age\", 30)\n * ```\n *\n * Note: Numbers and Booleans will be converted to strings automatically.\n *\n * @param name The name of the query string parameter.\n * @param value The value of the query string parameter.\n * @returns A new child instance of HTTP derived from this one.\n */\n param(name: string, value: Record<string, unknown>): HTTP;\n param(name: string, ...value: (string | number | boolean)[]): HTTP;\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n param(name: string, value: any) {\n return HTTP.create(this.client, this.#request.derive().param(name, value));\n }\n\n /**\n * Attaches a query string parameter object to the request. Query string\n * parameters are key-value pairs which are appended to the request url, such as\n * `https://api.example.com?name=John&age=30`.\n *\n * This method is a shared chain method, and will return the same instance of HTTP. All\n * child clients will inherit the query string parameters defined by this method. Useful to configure\n * in the constructor body.\n *\n * ```ts\n * getUser(id: number) {\n * return this.http\n * .route(id)\n * .param({ name: \"John\", age: \"30\" })\n *\n * @param name The name of the query string parameter.\n * @param value The value of the query string parameter.\n * @returns This instance of HTTP.\n */\n params(dict: Record<string, string>) {\n this.#request.params(dict);\n return HTTP.create(this.client, this.#request.derive().params(dict));\n }\n\n /**\n * Attaches a shared data payload to this client. The data payload is the body of the request,\n * and can be any type. If the data payload is an object, it will be serialized to JSON.\n *\n * This method is a shared chain method, and will return the same instance of HTTP. All\n * child clients will inherit the data payload defined by this method. Useful to configure\n * in the constructor body.\n *\n * @param data The data payload to attach to the request.\n * @returns This instance of HTTP.\n */\n sharedData<T>(data: T) {\n this.#request.data(data);\n return this;\n }\n\n /**\n * Attaches a shared header to this client. Headers are string:string key-value pairs which are\n * sent with the request, such as `Content-Type: application/json`.\n *\n * Numbers, Booleans and Null will be converted to string values automatically.\n *\n * A Factory function can also be provided to generate the header value at the time of request.\n *\n * This method is a shared chain method, and will return the same instance of HTTP. All\n * child clients will inherit the header defined by this method. Useful to configure\n * in the constructor body.\n *\n * @param name The name of the header.\n * @param value The value of the header.\n */\n sharedHeader(\n name: string,\n value:\n | string\n | number\n | boolean\n | null\n | (string | number | boolean)[]\n | (() => string | number | boolean | null)\n | (() => Promise<string | number | boolean | null>)\n ) {\n this.#request.header(name, value);\n return this;\n }\n\n header(\n name: string,\n value:\n | string\n | number\n | boolean\n | null\n | (string | number | boolean)[]\n | (() => string | number | boolean | null)\n | (() => Promise<string | number | boolean | null>)\n ) {\n return HTTP.create(this.client, this.#request.derive().header(name, value));\n }\n\n /**\n * Attaches a data payload to this request. The data payload is the body of the request,\n * and can be any type. If the data payload is an object, it will be serialized to JSON.\n *\n * This method is a request chain method, and will return a new instance of HTTP, inheriting\n * any data payload previously defined and appending the new payload. Useful to configure\n * in class methods as part of finalizing a request.\n *\n * @param data The data payload to attach to the request.\n * @returns A new child instance of HTTP derived from this one.\n */\n data<T>(data: T) {\n this.#request.data(data);\n return HTTP.create(this.client, this.#request.derive().data(data));\n }\n\n /**\n * `onSend` is a pre-request hook which will be executed in order of definition\n * immediately before the request is sent. This hook can be used to modify the request,\n * or to log the state of a request before final send-off.\n *\n * ```ts\n *\n * \\@Fixture(INJECTION_SCOPE.TRANSIENT)\n * export class UserController extends BaseController {\n * constructor(private readonly http: HTTP) {\n * super(http);\n * }\n *\n * getUser(id: number) {\n * return this.http\n * .route(id)\n * .onSend(\"log request\",\n * (request) => console.log(JSON.stringify(request, null, 2)\n * )\n * .get();\n * }\n * ```\n *\n * This method is a request chain method, and will return a new instance of HTTP, inheriting\n * any onSend hooks previously defined and appending the new hook. Useful to configure\n * in class methods as part of finalizing a request.\n *\n * @param description A description of the hook, used for debugging.\n * @param hook The hook to execute.\n * @returns A new child instance of HTTP derived from this one.\n */\n onSend(description: string, hook: RequestHook) {\n return HTTP.create(\n this.client,\n this.#request.derive(),\n this.#metaConfig.derive().onBeforeSend(description, hook)\n );\n }\n\n /**\n * `onReceive` is a post-request hook which will be executed in order of definition\n * immediately after the response is received. This hook can be used to modify the response,\n * or to log the state of a response after it is received.\n *\n * ```ts\n *\n * \\@Fixture(INJECTION_SCOPE.TRANSIENT)\n * export class UserController extends BaseController {\n * constructor(private readonly http: HTTP) {\n * super(http);\n * }\n *\n * getUser(id: number) {\n * return this.http\n * .route(id)\n * .onReceive(\"log response\",\n * (response) => console.log(JSON.stringify(response, null, 2)\n * )\n * .get();\n * }\n * ```\n *\n * This method is a request chain method, and will return a new instance of HTTP, inheriting\n * any onReceive hooks previously defined and appending the new hook. Useful to configure\n * in class methods as part of finalizing a request.\n *\n * @param description A description of the hook, used for debugging.\n * @param hook The hook to execute.\n * @returns A new child instance of HTTP derived from this one.\n */\n onReceive(description: string, hook: ResponseHook<unknown>) {\n return HTTP.create(\n this.client,\n this.#request.derive(),\n this.#metaConfig.derive().onReceiveResponse(description, hook)\n );\n }\n\n /**\n * Executes the current request state as a GET request.\n *\n * @param options Additional options to pass to the underlying http client, such\n * as e.g Axios configuration values.\n * @returns A promise which resolves to the response.\n */\n get<TResponseType>(options?: HTTPAdditionalOptions<unknown>) {\n return this.#makeRequest(\n this.#request.derive().method(\"GET\"),\n options\n ) as Promise<HTTPResponse<TResponseType>>;\n }\n\n /**\n * Executes the current request state as a POST request.\n *\n * @param data The data payload to attach to the request.\n * @param options Additional options to pass to the underlying http client, such\n * as e.g Axios configuration values.\n * @returns A promise which resolves to the response.\n */\n post<TResponseType>(options?: HTTPAdditionalOptions<unknown>) {\n return this.#makeRequest(\n this.#request.derive().method(\"POST\"),\n options\n ) as Promise<HTTPResponse<TResponseType>>;\n }\n\n /**\n * Executes the current request state as a DELETE request.\n *\n * @param options Additional options to pass to the underlying http client, such\n * as e.g Axios configuration values.\n * @returns A promise which resolves to the response.\n * as e.g Axios configuration values.\n */\n delete<TResponseType>(options?: HTTPAdditionalOptions<unknown>) {\n return this.#makeRequest(\n this.#request.derive().method(\"DELETE\"),\n options\n ) as Promise<HTTPResponse<TResponseType>>;\n }\n\n /**\n * Executes the current request state as a PUT request.\n *\n * @param options Additional options to pass to the underlying http client, such\n * as e.g Axios configuration values.\n * @returns A promise which resolves to the response.\n */\n put<TResponseType>(options?: HTTPAdditionalOptions<unknown>) {\n return this.#makeRequest(\n this.#request.derive().method(\"PUT\"),\n options\n ) as Promise<HTTPResponse<TResponseType>>;\n }\n /**\n * Executes the current request state as a PATCH request.\n *\n * @param options Additional options to pass to the underlying http client, such\n * as e.g Axios configuration values.\n * @returns A promise which resolves to the response.\n */\n patch<TResponseType>(options?: HTTPAdditionalOptions<unknown>) {\n return this.#makeRequest(\n this.#request.derive().method(\"PATCH\"),\n options\n ) as Promise<HTTPResponse<TResponseType>>;\n }\n\n head<TResponseType>(options?: HTTPAdditionalOptions<unknown>) {\n return this.#makeRequest(\n this.#request.derive().method(\"HEAD\"),\n options\n ) as Promise<HTTPResponse<TResponseType>>;\n }\n\n options<TResponseType>(options?: HTTPAdditionalOptions<unknown>) {\n return this.#makeRequest(\n this.#request.derive().method(\"OPTIONS\"),\n options\n ) as Promise<HTTPResponse<TResponseType>>;\n }\n\n trace<TResponseType>(options?: HTTPAdditionalOptions<unknown>) {\n return this.#makeRequest(\n this.#request.derive().method(\"TRACE\"),\n options\n ) as Promise<HTTPResponse<TResponseType>>;\n }\n\n connect<TResponseType>(options?: HTTPAdditionalOptions<unknown>) {\n return this.#makeRequest(\n this.#request.derive().method(\"CONNECT\"),\n options\n ) as Promise<HTTPResponse<TResponseType>>;\n }\n\n async #makeRequest(\n builder: HTTPRequestBuilder<HTTPRequest<unknown>>,\n options?: HTTPAdditionalOptions<unknown>\n ) {\n const request = (await builder.resolveDynamicHeaders()).build();\n const meta = this.#metaConfig.derive().build();\n await this.runOnSendHooks(meta, request);\n const result = await this.client.request<unknown, string>(request, options);\n result.data = transformResponse(meta.allowPlainText, result.data);\n await this.runOnReceiveHooks(meta, result);\n const validated = this.#validateResponse(result, meta);\n return validated;\n }\n\n private async runOnSendHooks(\n meta: MetaConfig,\n request: HTTPRequest<unknown>\n ) {\n for (const [description, hook] of meta.onSend) {\n try {\n await hook(request);\n } catch (e) {\n const cause = e as Error;\n const msg = `An error occurred while sending a request in hook: '${description}'`;\n throw new AutomationError(msg, { cause });\n }\n }\n }\n private async runOnReceiveHooks(\n meta: MetaConfig,\n response: HTTPResponse<unknown>\n ) {\n for (const [description, hook] of meta.onReceive) {\n try {\n await hook(response);\n } catch (e) {\n const cause = e as Error;\n const msg = `An error occurred while receiving a response in hook: '${description}'`;\n throw new AutomationError(msg, { cause });\n }\n }\n }\n\n #validateResponse<T>(\n response: HTTPResponse<unknown>,\n meta: MetaConfig\n ): HTTPResponse<T> {\n const { status, data } = response;\n const validated = meta.schemas.validate(\n status,\n data,\n meta.requireSchema\n ) as T;\n response.data = validated;\n return response as HTTPResponse<T>;\n }\n}\n","import { Class } from \"@autometa/types\";\nimport { defaultClient, type HTTPClient } from \"./http-client\";\n\nexport function defaultClientFactory() {\n const type = defaultClient as Class<HTTPClient>;\n return new type();\n}\n","import { RequestConfig, RequestConfigBasic } from \"./request.config\";\nimport { HTTPMethod } from \"./types\";\nimport { urlJoinP } from \"url-join-ts\";\nexport class HTTPRequest<T = unknown> implements RequestConfig<T> {\n headers: Record<string, string> = {};\n params: Record<string, string | string[] | Record<string, unknown>> = {};\n baseUrl?: string;\n route: string[] = [];\n method: HTTPMethod;\n data: T;\n\n constructor(config?: RequestConfigBasic) {\n Object.assign(this, config);\n }\n\n /**\n * Returns the full URL of the request, including the base url,\n * routes, and query parameters.\n *\n * ```ts\n * console.log(request.fullUrl())// https://example.com/foo?bar=baz?array=1,2,3\n * ```\n *\n * Note characters may be converted to escape codes. I.e (space => %20) and (comma => %2C)\n *\n * N.B this getter estimates what the url will be. The actual value\n * might be different depending on your underlying HTTPClient and\n * configuration. For example, query parameters might\n * use different array formats.\n */\n get fullUrl() {\n return urlJoinP(this.baseUrl, this.route, this.params);\n }\n\n /**\n * Returns a new independent copy of the request.\n */\n static derive(original: HTTPRequest<unknown>) {\n const request = new HTTPRequest();\n request.headers = { ...original.headers };\n request.params = { ...original.params };\n request.baseUrl = original.baseUrl;\n request.route = [...original.route];\n request.method = original.method;\n request.data = original.data;\n return request;\n }\n}\n\nexport class HTTPRequestBuilder<T extends HTTPRequest<unknown>> {\n #request: T;\n #dynamicHeaders = new Map<\n string,\n | (() => string | number | boolean | null)\n | (() => Promise<string | number | boolean | null>)\n >();\n\n constructor(request: T | (() => T) = () => new HTTPRequest() as T) {\n if (typeof request === \"function\") {\n this.#request = request();\n return;\n }\n this.#request = request;\n }\n\n static create<T extends HTTPRequest<unknown>>() {\n return new HTTPRequestBuilder<T>();\n }\n\n get request() {\n return this.#request;\n }\n\n async resolveDynamicHeaders(\n request: HTTPRequest<T> = this.#request as HTTPRequest<T>\n ) {\n for (const [name, value] of this.#dynamicHeaders) {\n try {\n if (!request.headers) request.headers = {};\n request.headers[name] = String(await value());\n } catch (e) {\n const cause = e as Error;\n const msg = `Failed to resolve dynamic header \"${name}\": \n${cause}`;\n throw new Error(msg);\n }\n }\n return this;\n }\n\n url(url: string) {\n this.#request.baseUrl = url;\n return this;\n }\n\n route(...route: string[]) {\n this.#request.route.push(...route);\n return this;\n }\n\n param(\n name: string,\n value:\n | string\n | number\n | boolean\n | (string | number | boolean)[]\n | Record<string, string | number | boolean>\n ) {\n if (Array.isArray(value)) {\n const asStr = value.map(String);\n this.#request.params[name] = asStr;\n return this;\n }\n if (!Array.isArray(value) && typeof value === \"object\") {\n this.#request.params[name] = value;\n return this;\n }\n this.#request.params[name] = String(value);\n return this;\n }\n\n params(dict: Record<string, unknown>) {\n Object.assign(this.#request.params, dict);\n return this;\n }\n\n data<T>(data: T) {\n this.#request.data = data;\n return this;\n }\n\n header(\n name: string,\n value:\n | string\n | number\n | boolean\n | null\n | (string | number | boolean)[]\n | (() => string | number | boolean | null)\n | (() => Promise<string | number | boolean | null>),\n onArray: (value: (string | number | boolean)[]) => string = (value) =>\n value.join(\",\")\n ) {\n if (typeof value === \"function\") {\n this.#dynamicHeaders.set(name, value);\n return this;\n }\n const val = Array.isArray(value) ? onArray(value) : String(value);\n this.#request.headers[name] = val;\n return this;\n }\n\n headers(dict: Record<string, string>) {\n Object.assign(this.#request.headers, dict);\n return this;\n }\n\n get() {\n return this.#request;\n }\n\n method(method: HTTPMethod) {\n this.#request.method = method;\n return this;\n }\n\n #setDynamicHeaders(\n headers: Map<\n string,\n | (() => string | number | boolean | null)\n | (() => Promise<string | number | boolean | null>)\n >\n ) {\n this.#dynamicHeaders = new Map(headers);\n return this;\n }\n\n derive(): HTTPRequestBuilder<T> {\n const request = HTTPRequest.derive(this.#request);\n return new HTTPRequestBuilder(request).#setDynamicHeaders(\n this.#dynamicHeaders\n ) as HTTPRequestBuilder<T>;\n }\n\n build(): HTTPRequest<T> {\n return this.#request as HTTPRequest<T>;\n }\n\n async buildAsync(): Promise<HTTPRequest<T>> {\n await this.resolveDynamicHeaders();\n return this.#request as HTTPRequest<T>;\n }\n}\n","import { SchemaParser, StatusCode } from \"./types\";\nexport class SchemaMap {\n #map: Map<StatusCode, SchemaParser>;\n constructor(map?: Map<StatusCode, SchemaParser> | SchemaMap) {\n if (map instanceof SchemaMap) {\n this.#map = new Map(map.#map);\n return;\n }\n this.#map = new Map(map);\n }\n\n derive() {\n return new SchemaMap(this.#map);\n }\n\n registerStatus(parser: SchemaParser, ...codes: StatusCode[]) {\n codes.forEach((code) => {\n if (this.#map.has(code)) {\n const msg = `Status code ${code} is already registered with a parser`;\n throw new Error(msg);\n }\n this.#map.set(code, parser);\n });\n }\n\n registerRange(parser: SchemaParser, from: StatusCode, to: StatusCode) {\n for (let i = from; i <= to; i++) {\n if (this.#map.has(i)) {\n throw new Error(`Status code ${i} is already registered with a parser`);\n }\n this.#map.set(i, parser);\n }\n }\n\n validate(status: StatusCode, data: unknown, requireSchema: boolean) {\n const parser = this.getParser(status, requireSchema);\n if (\"parse\" in parser) {\n return parser.parse(data);\n }\n if('validate' in parser) {\n return parser.validate(data);\n }\n try {\n return parser(data);\n } catch (e) {\n const msg = `Failed to schema parse response data for status code ${status} with data:\n \n${JSON.stringify(data, null, 2)}}`;\n throw new Error(msg);\n }\n }\n\n getParser(status: StatusCode, requireSchema: boolean) {\n const parser = this.#map.get(status);\n if (!parser && requireSchema) {\n const msg = `No parser registered for status code ${status} but 'requireSchema' is true`;\n throw new Error(msg);\n }\n if (parser) {\n return parser;\n }\n return (data: unknown) => data;\n }\n\n toObject() {\n return Object.fromEntries(this.#map) as Record<StatusCode, SchemaParser>;\n }\n}\n","import { SchemaMap } from \"./schema.map\";\nimport { RequestHook, ResponseHook, SchemaParser, StatusCode } from \"./types\";\n\nexport interface SchemaConfig {\n schemas: SchemaMap;\n requireSchema: boolean;\n allowPlainText: boolean;\n}\n\nexport interface HTTPHooks {\n onSend: [string, RequestHook][];\n onReceive: [string, ResponseHook<unknown>][];\n}\n\n// export type MetaConfig = SchemaConfig & HTTPHooks;\n\nexport class MetaConfig implements SchemaConfig, HTTPHooks {\n schemas: SchemaMap;\n requireSchema: boolean;\n allowPlainText: boolean;\n onSend: [string, RequestHook][] = [];\n onReceive: [string, ResponseHook<unknown>][] = [];\n throwOnServerError: boolean;\n}\n\nexport class MetaConfigBuilder {\n #schemaMap = new SchemaMap();\n #requireSchema = false;\n #allowPlainText = false;\n #onBeforeSend: [string, RequestHook][] = [];\n #onAfterSend: [string, ResponseHook<unknown>][] = [];\n #throwOnServerError = false;\n\n schemaMap(map: SchemaMap) {\n this.#schemaMap = map;\n return this;\n }\n\n schema(parser: SchemaParser, ...codes: StatusCode[]): MetaConfigBuilder;\n schema(\n parser: SchemaParser,\n ...range: { from: StatusCode; to: StatusCode }[]\n ): MetaConfigBuilder;\n schema(\n parser: SchemaParser,\n ...args: (StatusCode | { from: StatusCode; to: StatusCode })[]\n ): MetaConfigBuilder;\n schema(\n parser: SchemaParser,\n ...args: (StatusCode | { from: StatusCode; to: StatusCode })[]\n ) {\n args.forEach((arg) => {\n if (typeof arg === \"number\") {\n this.#schemaMap.registerStatus(parser, arg);\n } else {\n this.#schemaMap.registerRange(parser, arg.from, arg.to);\n }\n });\n\n return this;\n }\n\n requireSchema(value: boolean) {\n this.#requireSchema = value;\n return this;\n }\n\n allowPlainText(value: boolean) {\n this.#allowPlainText = value;\n return this;\n }\n\n onBeforeSend(description: string, hook: RequestHook) {\n this.#onBeforeSend.push([description, hook]);\n return this;\n }\n\n #setOnSend(hooks: [string, RequestHook][]) {\n this.#onBeforeSend = hooks;\n return this;\n }\n\n throwOnServerError(value: boolean) {\n this.#throwOnServerError = value;\n return this;\n }\n\n onReceiveResponse(description: string, hook: ResponseHook<unknown>) {\n this.#onAfterSend.push([description, hook]);\n return this;\n }\n\n #setOnReceive(hooks: [string, ResponseHook<unknown>][]) {\n this.#onAfterSend = hooks;\n return this;\n }\n\n build() {\n const config = new MetaConfig();\n config.schemas = this.#schemaMap.derive();\n config.requireSchema = this.#requireSchema;\n config.allowPlainText = this.#allowPlainText;\n config.onSend = this.#onBeforeSend;\n config.onReceive = this.#onAfterSend;\n return config;\n }\n\n derive() {\n return new MetaConfigBuilder()\n .schemaMap(this.#schemaMap.derive())\n .requireSchema(this.#requireSchema)\n .allowPlainText(this.#allowPlainText)\n .throwOnServerError(this.#throwOnServerError)\n .#setOnSend(this.#onBeforeSend)\n .#setOnReceive(this.#onAfterSend);\n }\n}\n","import { AutomationError } from \"@autometa/errors\";\nimport isJson from \"@stdlib/assert-is-json\";\nimport { highlight } from \"cli-highlight\";\n\nexport function transformResponse(\n allowPlainText: boolean,\n data: null | undefined | string\n) {\n if (data === null) {\n return null;\n }\n if (data === undefined) {\n return undefined;\n }\n if (data === \"\") {\n return data;\n }\n if (isJson(data)) {\n return JSON.parse(data);\n }\n if (typeof data === \"string\" && [\"true\", \"false\"].includes(data)) {\n return JSON.parse(data);\n }\n if (typeof data === \"string\" && /^\\d*\\.?\\d+$/.test(data)) {\n return JSON.parse(data);\n }\n\n if (typeof data === \"object\") {\n return data;\n }\n if (allowPlainText) {\n return data;\n }\n\n const response = highlight(data, { language: \"html\" });\n const message = [\n `Could not parse a response as json, and this request was not configured to allow plain text responses.`,\n `To allow plain text responses, use the 'allowPlainText' method on the HTTP client.`,\n \"\",\n response\n ];\n throw new AutomationError(message.join(\"\\n\"));\n}\n","import isJson from \"@stdlib/assert-is-json\";\n\n/**\n * Schema which does not care about data validation.\n *\n * Useful if `requireSchema` is set to true, but a specific\n * endpoints response does not matter.\n * @param data\n * @returns\n */\nexport function AnySchema(data: unknown) {\n return data;\n}\n\n/**\n * Schema which validates that a response is empty. This can mean\n * the data payload was `null`, `undefined` or the string `'null'`.\n *\n * Useful if `requireSchema` is set to true, but a specific\n * endpoints response should be null or not defined.\n * @param data\n * @returns\n */\nexport function EmptySchema(data: unknown) {\n if (data !== null && data !== undefined && data !== \"null\") {\n throw new Error(`Expected null but got <${typeof data}> for ${data}`);\n }\n return data === \"null\" ? null : data;\n}\n\n/**\n * Schema which validates a response was null.\n *\n * Useful if `requireSchema` is set to true, but a specific\n * endpoints response should be null.\n * @param data\n * @returns\n */\nexport function NullSchema(data: unknown) {\n if (data !== null && data !== \"null\") {\n throw new Error(`Expected null but got <${typeof data}> for ${data}`);\n }\n return null;\n}\n\n/**\n * Schema which validates a response was undefined.\n *\n * Useful if `requireSchema` is set to true, but a specific\n * endpoints response should be undefined.\n *\n * @param data\n * @returns\n */\nexport function UndefinedSchema(data: unknown) {\n if (data !== undefined) {\n throw new Error(`Expected undefined but got <${typeof data}> for ${data}`);\n }\n return undefined;\n}\n\n/**\n * Schema which validates a response was a boolean, or a string of value\n * `'true'` or `'false'`.\n *\n * Useful if `requireSchema` is set to true, but a specific\n * endpoints response should be a boolean.\n *\n * @param data\n * @returns\n */\nexport function BooleanSchema(data: unknown) {\n if (\n !(typeof data === \"boolean\") &&\n [\"true\", \"false\"].includes(String(data)) === false\n ) {\n throw new Error(`Expected boolean but got <${typeof data}> for ${data}`);\n }\n return JSON.parse(data as string);\n}\n\n/**\n * Schema which validates a response was a number, or a string of value\n * of a number.\n *\n * Useful if `requireSchema` is set to true, but a specific\n * endpoints response should be a number.\n *\n * @param data\n * @returns\n */\nexport function NumberSchema(data: unknown) {\n if (\n !(typeof data === \"number\") &&\n /^\\d*\\.?\\d+$/.test(String(data)) === false\n ) {\n throw new Error(`Expected number but got <${typeof data}> for ${data}`);\n }\n return JSON.parse(data as string);\n}\n\n/**\n * Schema which validates a response was a string.\n *\n * Useful if `requireSchema` is set to true, but a specific\n * endpoints response should be a string.\n *\n * @param data\n * @returns\n */\nexport function StringSchema(data: unknown) {\n if (typeof data !== \"string\") {\n throw new Error(`Expected string but got <${typeof data}> for ${data}`);\n }\n return data;\n}\n\n\nexport function JSONSchema<T = unknown>(data: unknown) {\n if(typeof data === 'object') {\n return data as T;\n }\n if (!isJson(data)) {\n throw new Error(`Expected JSON but got <${typeof data}> for ${data}`);\n }\n const result = JSON.parse(data);\n return result;\n}"],"mappings":"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","names":["value","AutomationError","_request","AutomationError","isJson"]}
|
package/dist/index.d.cts
CHANGED
|
@@ -126,18 +126,19 @@ declare class HTTPRequestBuilder<T extends HTTPRequest<unknown>> {
|
|
|
126
126
|
constructor(request?: T | (() => T));
|
|
127
127
|
static create<T extends HTTPRequest<unknown>>(): HTTPRequestBuilder<T>;
|
|
128
128
|
get request(): T;
|
|
129
|
-
resolveDynamicHeaders(): Promise<this>;
|
|
129
|
+
resolveDynamicHeaders(request?: HTTPRequest<T>): Promise<this>;
|
|
130
130
|
url(url: string): this;
|
|
131
131
|
route(...route: string[]): this;
|
|
132
132
|
param(name: string, value: string | number | boolean | (string | number | boolean)[] | Record<string, string | number | boolean>): this;
|
|
133
133
|
params(dict: Record<string, unknown>): this;
|
|
134
134
|
data<T>(data: T): this;
|
|
135
|
-
header(name: string, value: string | number | boolean | null | (string | number | boolean)[] | (() => string | number | boolean | null) | (() => Promise<string | number | boolean | null>)): this;
|
|
135
|
+
header(name: string, value: string | number | boolean | null | (string | number | boolean)[] | (() => string | number | boolean | null) | (() => Promise<string | number | boolean | null>), onArray?: (value: (string | number | boolean)[]) => string): this;
|
|
136
136
|
headers(dict: Record<string, string>): this;
|
|
137
137
|
get(): T;
|
|
138
138
|
method(method: HTTPMethod): this;
|
|
139
139
|
derive(): HTTPRequestBuilder<T>;
|
|
140
140
|
build(): HTTPRequest<T>;
|
|
141
|
+
buildAsync(): Promise<HTTPRequest<T>>;
|
|
141
142
|
}
|
|
142
143
|
|
|
143
144
|
declare let defaultClient: Class<HTTPClient>;
|
package/dist/index.d.ts
CHANGED
|
@@ -126,18 +126,19 @@ declare class HTTPRequestBuilder<T extends HTTPRequest<unknown>> {
|
|
|
126
126
|
constructor(request?: T | (() => T));
|
|
127
127
|
static create<T extends HTTPRequest<unknown>>(): HTTPRequestBuilder<T>;
|
|
128
128
|
get request(): T;
|
|
129
|
-
resolveDynamicHeaders(): Promise<this>;
|
|
129
|
+
resolveDynamicHeaders(request?: HTTPRequest<T>): Promise<this>;
|
|
130
130
|
url(url: string): this;
|
|
131
131
|
route(...route: string[]): this;
|
|
132
132
|
param(name: string, value: string | number | boolean | (string | number | boolean)[] | Record<string, string | number | boolean>): this;
|
|
133
133
|
params(dict: Record<string, unknown>): this;
|
|
134
134
|
data<T>(data: T): this;
|
|
135
|
-
header(name: string, value: string | number | boolean | null | (string | number | boolean)[] | (() => string | number | boolean | null) | (() => Promise<string | number | boolean | null>)): this;
|
|
135
|
+
header(name: string, value: string | number | boolean | null | (string | number | boolean)[] | (() => string | number | boolean | null) | (() => Promise<string | number | boolean | null>), onArray?: (value: (string | number | boolean)[]) => string): this;
|
|
136
136
|
headers(dict: Record<string, string>): this;
|
|
137
137
|
get(): T;
|
|
138
138
|
method(method: HTTPMethod): this;
|
|
139
139
|
derive(): HTTPRequestBuilder<T>;
|
|
140
140
|
build(): HTTPRequest<T>;
|
|
141
|
+
buildAsync(): Promise<HTTPRequest<T>>;
|
|
141
142
|
}
|
|
142
143
|
|
|
143
144
|
declare let defaultClient: Class<HTTPClient>;
|
package/dist/index.js
CHANGED
|
@@ -230,9 +230,10 @@ var HTTPRequest = class _HTTPRequest {
|
|
|
230
230
|
return request;
|
|
231
231
|
}
|
|
232
232
|
};
|
|
233
|
-
var _request, _dynamicHeaders;
|
|
233
|
+
var _request, _dynamicHeaders, _setDynamicHeaders, setDynamicHeaders_fn;
|
|
234
234
|
var _HTTPRequestBuilder = class _HTTPRequestBuilder {
|
|
235
235
|
constructor(request = () => new HTTPRequest()) {
|
|
236
|
+
__privateAdd(this, _setDynamicHeaders);
|
|
236
237
|
__privateAdd(this, _request, void 0);
|
|
237
238
|
__privateAdd(this, _dynamicHeaders, /* @__PURE__ */ new Map());
|
|
238
239
|
if (typeof request === "function") {
|
|
@@ -247,10 +248,12 @@ var _HTTPRequestBuilder = class _HTTPRequestBuilder {
|
|
|
247
248
|
get request() {
|
|
248
249
|
return __privateGet(this, _request);
|
|
249
250
|
}
|
|
250
|
-
async resolveDynamicHeaders() {
|
|
251
|
+
async resolveDynamicHeaders(request = __privateGet(this, _request)) {
|
|
251
252
|
for (const [name, value] of __privateGet(this, _dynamicHeaders)) {
|
|
252
253
|
try {
|
|
253
|
-
|
|
254
|
+
if (!request.headers)
|
|
255
|
+
request.headers = {};
|
|
256
|
+
request.headers[name] = String(await value());
|
|
254
257
|
} catch (e) {
|
|
255
258
|
const cause = e;
|
|
256
259
|
const msg = `Failed to resolve dynamic header "${name}":
|
|
@@ -289,11 +292,12 @@ ${cause}`;
|
|
|
289
292
|
__privateGet(this, _request).data = data;
|
|
290
293
|
return this;
|
|
291
294
|
}
|
|
292
|
-
header(name, value) {
|
|
295
|
+
header(name, value, onArray = (value2) => value2.join(",")) {
|
|
293
296
|
if (typeof value === "function") {
|
|
294
297
|
__privateGet(this, _dynamicHeaders).set(name, value);
|
|
298
|
+
return this;
|
|
295
299
|
}
|
|
296
|
-
const val = Array.isArray(value) ? value
|
|
300
|
+
const val = Array.isArray(value) ? onArray(value) : String(value);
|
|
297
301
|
__privateGet(this, _request).headers[name] = val;
|
|
298
302
|
return this;
|
|
299
303
|
}
|
|
@@ -309,15 +313,25 @@ ${cause}`;
|
|
|
309
313
|
return this;
|
|
310
314
|
}
|
|
311
315
|
derive() {
|
|
316
|
+
var _a;
|
|
312
317
|
const request = HTTPRequest.derive(__privateGet(this, _request));
|
|
313
|
-
return new _HTTPRequestBuilder(request);
|
|
318
|
+
return __privateMethod(_a = new _HTTPRequestBuilder(request), _setDynamicHeaders, setDynamicHeaders_fn).call(_a, __privateGet(this, _dynamicHeaders));
|
|
314
319
|
}
|
|
315
320
|
build() {
|
|
316
321
|
return __privateGet(this, _request);
|
|
317
322
|
}
|
|
323
|
+
async buildAsync() {
|
|
324
|
+
await this.resolveDynamicHeaders();
|
|
325
|
+
return __privateGet(this, _request);
|
|
326
|
+
}
|
|
318
327
|
};
|
|
319
328
|
_request = new WeakMap();
|
|
320
329
|
_dynamicHeaders = new WeakMap();
|
|
330
|
+
_setDynamicHeaders = new WeakSet();
|
|
331
|
+
setDynamicHeaders_fn = function(headers) {
|
|
332
|
+
__privateSet(this, _dynamicHeaders, new Map(headers));
|
|
333
|
+
return this;
|
|
334
|
+
};
|
|
321
335
|
var HTTPRequestBuilder = _HTTPRequestBuilder;
|
|
322
336
|
|
|
323
337
|
// src/schema.map.ts
|
|
@@ -520,7 +534,7 @@ var HTTP = class {
|
|
|
520
534
|
__privateAdd(this, _validateResponse);
|
|
521
535
|
__privateAdd(this, _request2, void 0);
|
|
522
536
|
__privateAdd(this, _metaConfig, void 0);
|
|
523
|
-
__privateSet(this, _request2, builder
|
|
537
|
+
__privateSet(this, _request2, builder);
|
|
524
538
|
__privateSet(this, _metaConfig, metaConfig.derive());
|
|
525
539
|
}
|
|
526
540
|
static create(client = new AxiosClient(), builder = new HTTPRequestBuilder(), metaConfig = new MetaConfigBuilder()) {
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/index.ts","../src/http-response.ts","../src/axios-client.ts","../src/http-client.ts","../src/http.ts","../src/default-client-factory.ts","../src/http-request.ts","../src/schema.map.ts","../src/request-meta.config.ts","../src/transform-response.ts","../src/default-schema.ts"],"sourcesContent":["export * from \"./axios-client\";\nexport * from \"./http-client\";\nexport * from \"./http\";\nexport * from \"./http-request\";\nexport * from \"./http-response\";\nexport * from \"./default-schema\";\nexport type {\n HTTPAdditionalOptions,\n HTTPMethod,\n SchemaParser,\n RequestHook,\n ResponseHook\n} from \"./types\";\n","import { HTTPRequest } from \"./http-request\";\nimport { StatusCode } from \"./types\";\n\nexport class HTTPResponse<T = unknown> {\n status: StatusCode;\n statusText: string;\n data: T;\n headers: Record<string, string>;\n request: HTTPRequest<unknown>;\n\n constructor() {\n this.headers = {};\n }\n\n static fromRaw<T>(response: HTTPResponse<T>) {\n const newResponse = new HTTPResponse<T>();\n Object.assign(newResponse, response);\n return response;\n }\n\n /**\n * Decomposes a response, creating an exact copy of the current response,\n * but with a new data value. The data can be provided directly as is, or it\n * can be generated through a callback function which receives the current\n * response data as an argument.\n *\n * ```ts\n * const response = await http.get(\"/products\");\n *\n * // direct value\n * const products = response.data;\n * const firstProduct = response.decompose(products[0]);\n * // callback transformer\n * const secondProduct = response.decompose((products) => products[1]);\n * // callback transformer with destructuring\n * const secondProduct = response.decompose(([product]) => product);\n * ```\n * @param value\n */\n decompose<K>(value: K): HTTPResponse<K>;\n decompose<K>(transformFn: (response: T) => K): HTTPResponse<K>;\n decompose<K>(transformFnOrVal: K | ((response: T) => K)): HTTPResponse<K> {\n const value = getDecompositionValue<T>(this.data, transformFnOrVal);\n return new HTTPResponseBuilder()\n .status(this.status)\n .statusText(this.statusText)\n .headers(this.headers)\n .request(this.request)\n .data(value)\n .build() as HTTPResponse<K>;\n }\n}\n\nfunction getDecompositionValue<T>(data: unknown, transformFn: unknown): T {\n return typeof transformFn === \"function\" ? transformFn(data) : transformFn;\n}\n\nexport class HTTPResponseBuilder {\n #response = new HTTPResponse();\n\n static create() {\n return new HTTPResponseBuilder();\n }\n\n derive() {\n return HTTPResponseBuilder.create()\n .data(this.#response.data)\n .headers(this.#response.headers)\n .request(this.#response.request)\n .status(this.#response.status)\n .statusText(this.#response.statusText);\n }\n\n status(code: StatusCode) {\n this.#response.status = code;\n return this;\n }\n\n statusText(text: string) {\n this.#response.statusText = text;\n return this;\n }\n\n data<T>(data: T) {\n this.#response.data = data;\n return this;\n }\n\n headers(dict: Record<string, string>) {\n this.#response.headers = dict;\n return this;\n }\n\n header(name: string, value: string) {\n this.#response.headers[name] = value;\n return this;\n }\n\n request(request: HTTPRequest<unknown>) {\n this.#response.request = request;\n return this;\n }\n\n build() {\n return this.#response;\n }\n}\n","import { HTTPRequest } from \"./http-request\";\nimport { HTTPResponse, HTTPResponseBuilder } from \"./http-response\";\nimport { HTTPAdditionalOptions, StatusCode } from \"./types\";\nimport axios, { AxiosRequestConfig } from \"axios\";\nimport { HTTPClient } from \"./http-client\";\n\n@HTTPClient.Use()\nexport class AxiosClient extends HTTPClient {\n async request<TRequestType, TResponseType>(\n request: HTTPRequest<TRequestType>,\n options: HTTPAdditionalOptions<AxiosRequestConfig>\n ): Promise<HTTPResponse<TResponseType>> {\n const { baseUrl, route, params, headers, method, data } = request;\n const url = [baseUrl, ...route].join(\"/\");\n const axiosRequest: AxiosRequestConfig = {\n url,\n params,\n headers,\n method: method,\n data,\n validateStatus: function (status) {\n return status >= 0 && status < 600;\n },\n ...options\n };\n const response = await axios(axiosRequest);\n return HTTPResponseBuilder.create()\n .status(response.status as StatusCode)\n .statusText(response.statusText)\n .data(response.data)\n .headers(response.headers as Record<string, string>)\n .request(request)\n .build() as HTTPResponse<TResponseType>;\n }\n}\n","import { HTTPRequest } from \"./http-request\";\nimport { HTTPResponse } from \"./http-response\";\nimport { HTTPAdditionalOptions } from \"./types\";\nimport { Class } from \"@autometa/types\";\nexport let defaultClient: Class<HTTPClient>;\nexport abstract class HTTPClient {\n static Use(): (target: Class<HTTPClient>) => void\n static Use(client?: Class<HTTPClient>) {\n if (client) {\n defaultClient = client\n }\n return function (target: Class<HTTPClient>) {\n defaultClient = target\n };\n }\n abstract request<TRequestType, TResponseType>(\n request: HTTPRequest<TRequestType>,\n options?: HTTPAdditionalOptions<unknown>\n ): Promise<HTTPResponse<TResponseType>>;\n}\n","import { Fixture, INJECTION_SCOPE } from \"@autometa/injection\";\nimport { AxiosClient } from \"./axios-client\";\nimport { HTTPClient } from \"./http-client\";\nimport { defaultClientFactory } from \"./default-client-factory\";\nimport { HTTPRequest, HTTPRequestBuilder } from \"./http-request\";\nimport { HTTPResponse } from \"./http-response\";\nimport { MetaConfig, MetaConfigBuilder } from \"./request-meta.config\";\nimport {\n HTTPAdditionalOptions,\n RequestHook,\n ResponseHook,\n SchemaParser,\n StatusCode\n} from \"./types\";\nimport { transformResponse } from \"./transform-response\";\nimport { AutomationError } from \"@autometa/errors\";\n\n/**\n * The HTTP fixture allows requests to be built and sent to a server. In general,\n * there are 2 modes of operation:\n *\n * * Shared Chain: The shared chain is used to configure the client for all requests, such as\n * routes this instance will always be used. When a shared chain method is called, it returns\n * the same instance of HTTP which can be further chained to configure the client.\n * * Request Chain: The request chain is used to configure a single request, inheriting values\n * set by the shared chain. When called, a new HTTP client instance is created and inherits the values\n * set by it's parent.\n *\n * The 2 modes are intended to simplify configuring an object through an inheritance chain. For example,\n * assume we have an API with 2 controller routes, `/product` and `/seller`. We can set up a Base Client\n * which consumes the HTTP fixture and configures it with the base url of our API.\n *\n * Inheritors can further configure their HTTP instance's routes.\n *\n * ```ts\n * \\@Constructor(HTTP)\n * export class BaseClient {\n * constructor(protected readonly http: HTTP) {\n * this.http.url(\"https://api.example.com\");\n * }\n * }\n *\n * export class ProductClient extends BaseClient {\n * constructor(http: HTTP) {\n * super(http);\n * this.http.sharedRoute(\"product\");\n * }\n * getProduct(id: number) {\n * return this.http.route(id).get();\n * }\n *\n * export class SellerClient extends BaseClient {\n * constructor(http: HTTP) {\n * super(http);\n * this.http.sharedRoute(\"seller\");\n * }\n *\n * getSeller(id: number) {\n * return this.http.route(id).get();\n * }\n * }\n * ```\n *\n * 'Schemas' can also be configured. A Schema is a function or an object with a `parse` method, which\n * takes a response data payload and returns a validated object. Schemas are mapped to\n * HTTP Status Codes, and if configured to be required the request will fail if no schema is found\n * matching that code.\n *\n * Defining a schema function:\n *\n * ```\n * // user.schema.ts\n * export function UserSchema(data: unknown) {\n * if(typeof data !== \"object\") {\n * throw new Error(\"Expected an object\");\n * }\n *\n * if(typeof data.name !== \"string\") {\n * throw new Error(\"Expected a string\");\n * }\n *\n * return data as { name: string };\n * }\n *\n * // user.controller.ts\n * \\@Fixture(INJECTION_SCOPE.TRANSIENT)\n * export class UserController extends BaseController {\n * constructor(private readonly http: HTTP) {\n * super(http);\n * this.http\n * .sharedRoute(\"user\")\n * .sharedSchema(ErrorSchema, { from: 400, to: 499 });\n * }\n *\n * getUser(id: number) {\n * return this.http.route(id).schema(UserSchema, 200).get();\n * // or\n * return this.http\n * .route(id)\n * .schema(UserSchema, { from: 200, to: 299 })\n * .get();\n * // or\n * return this.http\n * .route(id)\n * .schema(UserSchema, 200, 201, 202)\n * .get();\n * }\n * }\n * ```\n *\n * Validation libraries which use a `.parse` or `.validation`, method, such as Zod or MyZod, can also be used as schemas:\n *\n * ```ts\n * // user.schema.ts\n * import { z } from \"myzod\";\n *\n * export const UserSchema = z.object({\n * name: z.string()\n * });\n *\n * // user.controller.ts\n * \\@Fixture(INJECTION_SCOPE.TRANSIENT)\n * export class UserController extends BaseController {\n * constructor(private readonly http: HTTP) {\n * super(http);\n * this.http\n * .sharedRoute(\"user\")\n * .sharedSchema(ErrorSchema, { from: 400, to: 499 })\n * }\n *\n * getUser(id: number) {\n * return this.http.route(id).schema(UserSchema, 200).get();\n * }\n * }\n * ```\n */\n@Fixture(INJECTION_SCOPE.TRANSIENT)\nexport class HTTP {\n #request: HTTPRequestBuilder<HTTPRequest<unknown>>;\n #metaConfig: MetaConfigBuilder;\n constructor(\n private readonly client: HTTPClient = defaultClientFactory(),\n builder: HTTPRequestBuilder<\n HTTPRequest<unknown>\n > = new HTTPRequestBuilder(),\n metaConfig: MetaConfigBuilder = new MetaConfigBuilder()\n ) {\n this.#request = builder.derive();\n this.#metaConfig = metaConfig.derive();\n }\n\n static create(\n client: HTTPClient = new AxiosClient(),\n builder: HTTPRequestBuilder<\n HTTPRequest<unknown>\n > = new HTTPRequestBuilder(),\n metaConfig: MetaConfigBuilder = new MetaConfigBuilder()\n ) {\n return new HTTP(client, builder, metaConfig);\n }\n\n /**\n * Sets the base url of the request for this client, such as\n * `https://api.example.com`, and could include always-used routes like\n * the api version, such as `/v1` or `/api/v1` at the end.\n *\n * ```ts\n *\n * \\@Fixture(INJECTION_SCOPE.TRANSIENT)\n * export abstract class BaseClient {\n * constructor(protected readonly http: HTTP) {\n * this.http.url(\"https://api.example.com\");\n * }\n * }\n * ```\n * @param url\n * @returns\n */\n url(url: string) {\n this.#request.url(url);\n return this;\n }\n\n /**\n * If set to true, all requests derived from this client will require a schema be defined\n * matching any response status code. If set to false, a schema will still be used for validation\n * if defined, or the unadulterated original body will be returned if no schema matches.\n *\n * @param required Whether or not a schema is required for all responses.\n * @returns This instance of HTTP.\n */\n requireSchema(required: boolean) {\n this.#metaConfig.requireSchema(required);\n return this;\n }\n\n /**\n * If set to true, all requests derived from this client will allow plain text\n * responses. If set to false, plain text responses will throw an serialization error.\n *\n * Useful when an endpoint returns a HTML or plain text response. If the plain text\n * is the value of `true` or `false`, or a number, it will be parsed into the\n * appropriate type.\n *\n * This method is a shared chain method, and will return the same instance of HTTP.\n *\n * @param allow Whether or not plain text responses are allowed.\n * @returns This instance of HTTP.\n */\n sharedAllowPlainText(allow: boolean) {\n this.#metaConfig.allowPlainText(allow);\n return this;\n }\n\n /**\n * If set to true, all requests derived from this client will allow plain text\n * responses. If set to false, plain text responses will throw an serialization error.\n *\n * Useful when an endpoint returns a HTML or plain text response. If the plain text\n * is the value of `true` or `false`, or a number, it will be parsed into the\n * appropriate type.\n *\n * This method is a request chain method, and will return a new instance of HTTP.\n *\n * @param allow Whether or not plain text responses are allowed.\n * @returns A new child instance of HTTP derived from this one.\n */\n allowPlainText(allow: boolean) {\n return HTTP.create(\n this.client,\n this.#request.derive(),\n this.#metaConfig.derive().allowPlainText(allow)\n );\n }\n\n /**\n * Attaches a route to the request, such as `/product` or `/user`. Subsequent calls\n * to this method will append the route to the existing route, such as `/product/1`.\n *\n * Numbers will be converted to strings automatically. Routes can be defined one\n * at a time or as a spread argument.\n *\n * ```ts\n * constructor(http: HTTP) {\n * super(http);\n * this.http.sharedRoute(\"user\", id).get();\n * }\n *\n * // or\n *\n * constructor(http: HTTP) {\n * super(http);\n * this.http\n * .sharedRoute(\"user\")\n * .sharedRoute(id)\n * .get();\n * }\n * ```\n *\n * This method is a shared chain method, and will return the same instance of HTTP. All\n * child clients will inherit the routes defined by this method. Useful to configure\n * in the constructor body.\n *\n * @param route A route or spread list of routes to append to the request.\n * @returns This instance of HTTP.\n */\n sharedRoute(...route: (string | number | boolean)[]) {\n this.#request.route(...route.map((r) => r.toString()));\n return this;\n }\n\n /**\n * Attaches a route to the request, such as `/product` or `/user`. Subsequent calls\n * to this method will append the route to the existing route, such as `/product/1`.\n *\n * Numbers will be converted to strings automatically. Routes can be defined one\n * at a time or as a spread argument.\n *\n * ```ts\n * getUser(id: number) {\n * return this.http.route(\"user\", id).get();\n * }\n *\n * // or\n *\n * getUser(id: number) {\n * return this.http\n * .route(\"user\")\n * .route(id)\n * .get();\n * }\n * ```\n *\n * This method is a request chain method, and will return a new instance of HTTP, inheriting\n * any routes previously defined and appending the new route. Useful to configure\n * in class methods as part of finalizing a request.\n *\n * @param route A route or spread list of routes to append to the request.\n * @returns A new child instance of HTTP derived from this one.\n */\n route(...route: (string | number | boolean)[]) {\n const mapped = route.map((r) => String(r));\n return HTTP.create(this.client, this.#request.derive().route(...mapped));\n }\n\n /**\n * Attaches a shared schema mapping for all requests by this client. Schemas are\n * mapped to HTTP Status Codes, and if configured to be required the request will fail\n * if no schema is found matching that code.\n *\n * The status code mapping can be defined as a single code, a range of codes, or a spread list.\n *\n * ```ts\n * \\@Fixture(INJECTION_SCOPE.TRANSIENT)\n * export class UserController extends BaseController {\n * constructor(private readonly http: HTTP) {\n * super(http);\n * this.http\n * .sharedRoute(\"user\")\n * .sharedSchema(UserSchema, 200)\n * .sharedSchema(EmptySchema, 201, 204)\n * .sharedSchema(ErrorSchema, { from: 400, to: 499 });\n * }\n * }\n * ```\n *\n * This method is a shared chain method, and will return the same instance of HTTP. All\n * child clients will inherit the schemas defined by this method. Useful to configure\n * in the constructor body.\n *\n * @param parser The schema parser to use for this mapping.\n * @param codes A single status code, a range of status codes, or a spread list of status codes.\n * @returns This instance of HTTP.\n */\n sharedSchema(parser: SchemaParser, ...codes: StatusCode[]): HTTP;\n sharedSchema(\n parser: SchemaParser,\n ...range: { from: StatusCode; to: StatusCode }[]\n ): HTTP;\n sharedSchema(\n parser: SchemaParser,\n ...args: (StatusCode | { from: StatusCode; to: StatusCode })[]\n ): HTTP {\n this.#metaConfig.schema(parser, ...args);\n return this;\n }\n\n /**\n * Attaches a schema mapping for this request. Schemas are\n * mapped to HTTP Status Codes, and if configured to be required the request will fail\n * if no schema is found matching that code.\n *\n * The status code mapping can be defined as a single code, a range of codes, or a spread list.\n *\n * ```ts\n * \\@Fixture(INJECTION_SCOPE.TRANSIENT)\n * export class UserController extends BaseController {\n * constructor(private readonly http: HTTP) {\n * super(http);\n * this.http\n * .sharedRoute(\"user\")\n * .schema(ErrorSchema, { from: 400, to: 499 });\n * }\n *\n * getUser(id: number) {\n * return this.http.route(id).schema(UserSchema, 200).get();\n * }\n *\n * getUsers(...ids: number[]) {\n * return this.http\n * .route(\"users\")\n * .schema(UserSchema, { from: 200, to: 299 })\n * .schema(UserSchema, 200)\n * .get();\n * }\n * ```\n *\n * This method is a request chain method, and will return a new instance of HTTP, inheriting\n * any schemas previously defined and appending the new schema. Useful to configure\n * in class methods as part of finalizing a request.\n *\n * @param parser The schema parser to use for this mapping.\n * @param codes A single status code, a range of status codes, or a spread list of status codes.\n * @returns A new child instance of HTTP derived from this one.\n */\n schema(parser: SchemaParser, ...codes: StatusCode[]): HTTP;\n schema(\n parser: SchemaParser,\n ...range: { from: StatusCode; to: StatusCode }[]\n ): HTTP;\n schema(\n parser: SchemaParser,\n ...args: (StatusCode | { from: StatusCode; to: StatusCode })[]\n ): HTTP {\n return HTTP.create(\n this.client,\n this.#request.derive(),\n this.#metaConfig.derive().schema(parser, ...args)\n );\n }\n\n /**\n * Attaches a shared query string parameter to all requests by this client. Query string\n * parameters are key-value pairs which are appended to the request url, such as\n * `https://api.example.com?name=John&age=30`.\n *\n * This method is a shared chain method, and will return the same instance of HTTP. All\n * child clients will inherit the query string parameters defined by this method. Useful to configure\n * in the constructor body.\n *\n * @param name The name of the query string parameter.\n * @param value The value of the query string parameter.\n * @returns This instance of HTTP.\n */\n sharedParam(name: string, value: Record<string, unknown>): HTTP;\n sharedParam(name: string, ...value: (string | number | boolean)[]): HTTP;\n sharedParam(\n name: string,\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n value: any\n ): HTTP {\n this.#request.param(name, value);\n return this;\n }\n\n /**\n * `onSend` is a pre-request hook which will be executed in order of definition\n * immediately before the request is sent. This hook can be used to analyze or\n * log the request state.\n *\n * ```ts\n *\n * \\@Fixture(INJECTION_SCOPE.TRANSIENT)\n * export class UserController extends BaseController {\n * constructor(private readonly http: HTTP) {\n * super(http);\n * this.http\n * .sharedRoute(\"user\")\n * .sharedOnSend(\"log request\",\n * (request) => console.log(JSON.stringify(request, null, 2))\n * );\n * }\n * }\n * ```\n *\n * This method is a shared chain method, and will return the same instance of HTTP. All\n * child clients will inherit the onSend hooks defined by this method. Useful to configure\n * in the constructor body.\n *\n * @param description A description of the hook, used for debugging.\n * @param hook The hook to execute.\n * @returns This instance of HTTP.\n */\n sharedOnSend(description: string, hook: RequestHook) {\n this.#metaConfig.onBeforeSend(description, hook);\n return this;\n }\n\n /**\n * `onReceive` is a post-request hook which will be executed in order of definition\n * immediately after the response is received. This hook can be used to analyze or\n * log the response state.\n *\n * ```ts\n *\n * \\@Fixture(INJECTION_SCOPE.TRANSIENT)\n * export class UserController extends BaseController {\n * constructor(private readonly http: HTTP) {\n * super(http);\n * this.http\n * .sharedRoute(\"user\")\n * .sharedOnReceive(\"log response\",\n * (response) => console.log(JSON.stringify(response, null, 2))\n * );\n * }\n * }\n * ```\n *\n * This method is a shared chain method, and will return the same instance of HTTP. All\n * child clients will inherit the onReceive hooks defined by this method. Useful to configure\n * in the constructor body.\n *\n * @param description A description of the hook, used for debugging.\n * @param hook The hook to execute.\n * @returns This instance of HTTP.\n */\n sharedOnReceive(description: string, hook: ResponseHook<unknown>) {\n this.#metaConfig.onReceiveResponse(description, hook);\n return this;\n }\n\n /**\n * Attaches a query string parameter object to the request. Query string\n * parameters are key-value pairs which are appended to the request url, such as\n * `https://api.example.com?name=John&age=30`.\n *\n * This method is a shared chain method, and will return the same instance of HTTP. All\n * child clients will inherit the query string parameters defined by this method. Useful to configure\n * in the constructor body.\n *\n * ```ts\n * constructor(http: HTTP) {\n * super(http);\n * this.http\n * .sharedParams({ 'is-test': \"true\" })\n * ```\n * @param name The name of the query string parameter.\n * @param value The value of the query string parameter.\n * @returns This instance of HTTP.\n */\n sharedParams(dict: Record<string, unknown>) {\n this.#request.params(dict);\n return this;\n }\n\n /**\n * Attaches a query string parameter to the request. Query string\n * parameters are key-value pairs which are appended to the request url, such as\n * `https://api.example.com?name=John&age=30`.\n *\n * This method is a request chain method, and will return a new instance of HTTP, inheriting\n * any query string parameters previously defined and appending the new parameter. Useful to configure\n * in class methods as part of finalizing a request.\n *\n * ```ts\n * getUser(id: number) {\n * return this.http\n * .route(id)\n * .param(\"name\", \"John\")\n * .param(\"age\", 30)\n * ```\n *\n * Note: Numbers and Booleans will be converted to strings automatically.\n *\n * @param name The name of the query string parameter.\n * @param value The value of the query string parameter.\n * @returns A new child instance of HTTP derived from this one.\n */\n param(name: string, value: Record<string, unknown>): HTTP;\n param(name: string, ...value: (string | number | boolean)[]): HTTP;\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n param(name: string, value: any) {\n return HTTP.create(this.client, this.#request.derive().param(name, value));\n }\n\n /**\n * Attaches a query string parameter object to the request. Query string\n * parameters are key-value pairs which are appended to the request url, such as\n * `https://api.example.com?name=John&age=30`.\n *\n * This method is a shared chain method, and will return the same instance of HTTP. All\n * child clients will inherit the query string parameters defined by this method. Useful to configure\n * in the constructor body.\n *\n * ```ts\n * getUser(id: number) {\n * return this.http\n * .route(id)\n * .param({ name: \"John\", age: \"30\" })\n *\n * @param name The name of the query string parameter.\n * @param value The value of the query string parameter.\n * @returns This instance of HTTP.\n */\n params(dict: Record<string, string>) {\n this.#request.params(dict);\n return HTTP.create(this.client, this.#request.derive().params(dict));\n }\n\n /**\n * Attaches a shared data payload to this client. The data payload is the body of the request,\n * and can be any type. If the data payload is an object, it will be serialized to JSON.\n *\n * This method is a shared chain method, and will return the same instance of HTTP. All\n * child clients will inherit the data payload defined by this method. Useful to configure\n * in the constructor body.\n *\n * @param data The data payload to attach to the request.\n * @returns This instance of HTTP.\n */\n sharedData<T>(data: T) {\n this.#request.data(data);\n return this;\n }\n\n /**\n * Attaches a shared header to this client. Headers are string:string key-value pairs which are\n * sent with the request, such as `Content-Type: application/json`.\n *\n * Numbers, Booleans and Null will be converted to string values automatically.\n *\n * A Factory function can also be provided to generate the header value at the time of request.\n *\n * This method is a shared chain method, and will return the same instance of HTTP. All\n * child clients will inherit the header defined by this method. Useful to configure\n * in the constructor body.\n *\n * @param name The name of the header.\n * @param value The value of the header.\n */\n sharedHeader(\n name: string,\n value:\n | string\n | number\n | boolean\n | null\n | (string | number | boolean)[]\n | (() => string | number | boolean | null)\n | (() => Promise<string | number | boolean | null>)\n ) {\n this.#request.header(name, value);\n return this;\n }\n\n header(\n name: string,\n value:\n | string\n | number\n | boolean\n | null\n | (string | number | boolean)[]\n | (() => string | number | boolean | null)\n | (() => Promise<string | number | boolean | null>)\n ) {\n return HTTP.create(this.client, this.#request.derive().header(name, value));\n }\n\n /**\n * Attaches a data payload to this request. The data payload is the body of the request,\n * and can be any type. If the data payload is an object, it will be serialized to JSON.\n *\n * This method is a request chain method, and will return a new instance of HTTP, inheriting\n * any data payload previously defined and appending the new payload. Useful to configure\n * in class methods as part of finalizing a request.\n *\n * @param data The data payload to attach to the request.\n * @returns A new child instance of HTTP derived from this one.\n */\n data<T>(data: T) {\n this.#request.data(data);\n return HTTP.create(this.client, this.#request.derive().data(data));\n }\n\n /**\n * `onSend` is a pre-request hook which will be executed in order of definition\n * immediately before the request is sent. This hook can be used to modify the request,\n * or to log the state of a request before final send-off.\n *\n * ```ts\n *\n * \\@Fixture(INJECTION_SCOPE.TRANSIENT)\n * export class UserController extends BaseController {\n * constructor(private readonly http: HTTP) {\n * super(http);\n * }\n *\n * getUser(id: number) {\n * return this.http\n * .route(id)\n * .onSend(\"log request\",\n * (request) => console.log(JSON.stringify(request, null, 2)\n * )\n * .get();\n * }\n * ```\n *\n * This method is a request chain method, and will return a new instance of HTTP, inheriting\n * any onSend hooks previously defined and appending the new hook. Useful to configure\n * in class methods as part of finalizing a request.\n *\n * @param description A description of the hook, used for debugging.\n * @param hook The hook to execute.\n * @returns A new child instance of HTTP derived from this one.\n */\n onSend(description: string, hook: RequestHook) {\n return HTTP.create(\n this.client,\n this.#request.derive(),\n this.#metaConfig.derive().onBeforeSend(description, hook)\n );\n }\n\n /**\n * `onReceive` is a post-request hook which will be executed in order of definition\n * immediately after the response is received. This hook can be used to modify the response,\n * or to log the state of a response after it is received.\n *\n * ```ts\n *\n * \\@Fixture(INJECTION_SCOPE.TRANSIENT)\n * export class UserController extends BaseController {\n * constructor(private readonly http: HTTP) {\n * super(http);\n * }\n *\n * getUser(id: number) {\n * return this.http\n * .route(id)\n * .onReceive(\"log response\",\n * (response) => console.log(JSON.stringify(response, null, 2)\n * )\n * .get();\n * }\n * ```\n *\n * This method is a request chain method, and will return a new instance of HTTP, inheriting\n * any onReceive hooks previously defined and appending the new hook. Useful to configure\n * in class methods as part of finalizing a request.\n *\n * @param description A description of the hook, used for debugging.\n * @param hook The hook to execute.\n * @returns A new child instance of HTTP derived from this one.\n */\n onReceive(description: string, hook: ResponseHook<unknown>) {\n return HTTP.create(\n this.client,\n this.#request.derive(),\n this.#metaConfig.derive().onReceiveResponse(description, hook)\n );\n }\n\n /**\n * Executes the current request state as a GET request.\n *\n * @param options Additional options to pass to the underlying http client, such\n * as e.g Axios configuration values.\n * @returns A promise which resolves to the response.\n */\n get<TResponseType>(options?: HTTPAdditionalOptions<unknown>) {\n return this.#makeRequest(\n this.#request.derive().method(\"GET\"),\n options\n ) as Promise<HTTPResponse<TResponseType>>;\n }\n\n /**\n * Executes the current request state as a POST request.\n *\n * @param data The data payload to attach to the request.\n * @param options Additional options to pass to the underlying http client, such\n * as e.g Axios configuration values.\n * @returns A promise which resolves to the response.\n */\n post<TResponseType>(options?: HTTPAdditionalOptions<unknown>) {\n return this.#makeRequest(\n this.#request.derive().method(\"POST\"),\n options\n ) as Promise<HTTPResponse<TResponseType>>;\n }\n\n /**\n * Executes the current request state as a DELETE request.\n *\n * @param options Additional options to pass to the underlying http client, such\n * as e.g Axios configuration values.\n * @returns A promise which resolves to the response.\n * as e.g Axios configuration values.\n */\n delete<TResponseType>(options?: HTTPAdditionalOptions<unknown>) {\n return this.#makeRequest(\n this.#request.derive().method(\"DELETE\"),\n options\n ) as Promise<HTTPResponse<TResponseType>>;\n }\n\n /**\n * Executes the current request state as a PUT request.\n *\n * @param options Additional options to pass to the underlying http client, such\n * as e.g Axios configuration values.\n * @returns A promise which resolves to the response.\n */\n put<TResponseType>(options?: HTTPAdditionalOptions<unknown>) {\n return this.#makeRequest(\n this.#request.derive().method(\"PUT\"),\n options\n ) as Promise<HTTPResponse<TResponseType>>;\n }\n /**\n * Executes the current request state as a PATCH request.\n *\n * @param options Additional options to pass to the underlying http client, such\n * as e.g Axios configuration values.\n * @returns A promise which resolves to the response.\n */\n patch<TResponseType>(options?: HTTPAdditionalOptions<unknown>) {\n return this.#makeRequest(\n this.#request.derive().method(\"PATCH\"),\n options\n ) as Promise<HTTPResponse<TResponseType>>;\n }\n\n head<TResponseType>(options?: HTTPAdditionalOptions<unknown>) {\n return this.#makeRequest(\n this.#request.derive().method(\"HEAD\"),\n options\n ) as Promise<HTTPResponse<TResponseType>>;\n }\n\n options<TResponseType>(options?: HTTPAdditionalOptions<unknown>) {\n return this.#makeRequest(\n this.#request.derive().method(\"OPTIONS\"),\n options\n ) as Promise<HTTPResponse<TResponseType>>;\n }\n\n trace<TResponseType>(options?: HTTPAdditionalOptions<unknown>) {\n return this.#makeRequest(\n this.#request.derive().method(\"TRACE\"),\n options\n ) as Promise<HTTPResponse<TResponseType>>;\n }\n\n connect<TResponseType>(options?: HTTPAdditionalOptions<unknown>) {\n return this.#makeRequest(\n this.#request.derive().method(\"CONNECT\"),\n options\n ) as Promise<HTTPResponse<TResponseType>>;\n }\n\n async #makeRequest(\n builder: HTTPRequestBuilder<HTTPRequest<unknown>>,\n options?: HTTPAdditionalOptions<unknown>\n ) {\n const request = (await builder.resolveDynamicHeaders()).build();\n const meta = this.#metaConfig.derive().build();\n await this.runOnSendHooks(meta, request);\n const result = await this.client.request<unknown, string>(request, options);\n result.data = transformResponse(meta.allowPlainText, result.data);\n await this.runOnReceiveHooks(meta, result);\n const validated = this.#validateResponse(result, meta);\n return validated;\n }\n\n private async runOnSendHooks(\n meta: MetaConfig,\n request: HTTPRequest<unknown>\n ) {\n for (const [description, hook] of meta.onSend) {\n try {\n await hook(request);\n } catch (e) {\n const cause = e as Error;\n const msg = `An error occurred while sending a request in hook: '${description}'`;\n throw new AutomationError(msg, { cause });\n }\n }\n }\n private async runOnReceiveHooks(\n meta: MetaConfig,\n response: HTTPResponse<unknown>\n ) {\n for (const [description, hook] of meta.onReceive) {\n try {\n await hook(response);\n } catch (e) {\n const cause = e as Error;\n const msg = `An error occurred while receiving a response in hook: '${description}'`;\n throw new AutomationError(msg, { cause });\n }\n }\n }\n\n #validateResponse<T>(\n response: HTTPResponse<unknown>,\n meta: MetaConfig\n ): HTTPResponse<T> {\n const { status, data } = response;\n const validated = meta.schemas.validate(\n status,\n data,\n meta.requireSchema\n ) as T;\n response.data = validated;\n return response as HTTPResponse<T>;\n }\n}\n","import { Class } from \"@autometa/types\";\nimport { defaultClient, type HTTPClient } from \"./http-client\";\n\nexport function defaultClientFactory() {\n const type = defaultClient as Class<HTTPClient>;\n return new type();\n}\n","import { RequestConfig, RequestConfigBasic } from \"./request.config\";\nimport { HTTPMethod } from \"./types\";\nimport { urlJoinP } from \"url-join-ts\";\nexport class HTTPRequest<T = unknown> implements RequestConfig<T> {\n headers: Record<string, string> = {};\n params: Record<string, string | string[] | Record<string, unknown>> = {};\n baseUrl?: string;\n route: string[] = [];\n method: HTTPMethod;\n data: T;\n\n constructor(config?: RequestConfigBasic) {\n Object.assign(this, config);\n }\n\n /**\n * Returns the full URL of the request, including the base url,\n * routes, and query parameters.\n *\n * ```ts\n * console.log(request.fullUrl())// https://example.com/foo?bar=baz?array=1,2,3\n * ```\n *\n * Note characters may be converted to escape codes. I.e (space => %20) and (comma => %2C)\n *\n * N.B this getter estimates what the url will be. The actual value\n * might be different depending on your underlying HTTPClient and\n * configuration. For example, query parameters might\n * use different array formats.\n */\n get fullUrl() {\n return urlJoinP(this.baseUrl, this.route, this.params);\n }\n\n /**\n * Returns a new independent copy of the request.\n */\n static derive(original: HTTPRequest<unknown>) {\n const request = new HTTPRequest();\n request.headers = { ...original.headers };\n request.params = { ...original.params };\n request.baseUrl = original.baseUrl;\n request.route = [...original.route];\n request.method = original.method;\n request.data = original.data;\n return request;\n }\n}\n\nexport class HTTPRequestBuilder<T extends HTTPRequest<unknown>> {\n #request: T;\n #dynamicHeaders = new Map<\n string,\n | (() => string | number | boolean | null)\n | (() => Promise<string | number | boolean | null>)\n >();\n\n constructor(request: T | (() => T) = () => new HTTPRequest() as T) {\n if (typeof request === \"function\") {\n this.#request = request();\n return;\n }\n this.#request = request;\n }\n\n static create<T extends HTTPRequest<unknown>>() {\n return new HTTPRequestBuilder<T>();\n }\n\n get request() {\n return this.#request;\n }\n\n async resolveDynamicHeaders() {\n for (const [name, value] of this.#dynamicHeaders) {\n try {\n this.#request.headers[name] = String(await value());\n } catch (e) {\n const cause = e as Error;\n const msg = `Failed to resolve dynamic header \"${name}\": \n${cause}`;\n throw new Error(msg);\n }\n }\n return this;\n }\n\n url(url: string) {\n this.#request.baseUrl = url;\n return this;\n }\n\n route(...route: string[]) {\n this.#request.route.push(...route);\n return this;\n }\n\n param(\n name: string,\n value:\n | string\n | number\n | boolean\n | (string | number | boolean)[]\n | Record<string, string | number | boolean>\n ) {\n if (Array.isArray(value)) {\n const asStr = value.map(String);\n this.#request.params[name] = asStr;\n return this;\n }\n if (!Array.isArray(value) && typeof value === \"object\") {\n this.#request.params[name] = value;\n return this;\n }\n this.#request.params[name] = String(value);\n return this;\n }\n\n params(dict: Record<string, unknown>) {\n Object.assign(this.#request.params, dict);\n return this;\n }\n\n data<T>(data: T) {\n this.#request.data = data;\n return this;\n }\n\n header(\n name: string,\n value:\n | string\n | number\n | boolean\n | null\n | (string | number | boolean)[]\n | (() => string | number | boolean | null)\n | (() => Promise<string | number | boolean | null>)\n ) {\n if (typeof value === \"function\") {\n this.#dynamicHeaders.set(name, value);\n }\n const val = Array.isArray(value) ? value.join(\",\") : String(value);\n this.#request.headers[name] = val;\n return this;\n }\n\n headers(dict: Record<string, string>) {\n Object.assign(this.#request.headers, dict);\n return this;\n }\n\n get() {\n return this.#request;\n }\n\n method(method: HTTPMethod) {\n this.#request.method = method;\n return this;\n }\n\n derive(): HTTPRequestBuilder<T> {\n const request = HTTPRequest.derive(this.#request);\n return new HTTPRequestBuilder(request) as HTTPRequestBuilder<T>;\n }\n\n build(): HTTPRequest<T> {\n return this.#request as HTTPRequest<T>;\n }\n}\n","import { SchemaParser, StatusCode } from \"./types\";\nexport class SchemaMap {\n #map: Map<StatusCode, SchemaParser>;\n constructor(map?: Map<StatusCode, SchemaParser> | SchemaMap) {\n if (map instanceof SchemaMap) {\n this.#map = new Map(map.#map);\n return;\n }\n this.#map = new Map(map);\n }\n\n derive() {\n return new SchemaMap(this.#map);\n }\n\n registerStatus(parser: SchemaParser, ...codes: StatusCode[]) {\n codes.forEach((code) => {\n if (this.#map.has(code)) {\n const msg = `Status code ${code} is already registered with a parser`;\n throw new Error(msg);\n }\n this.#map.set(code, parser);\n });\n }\n\n registerRange(parser: SchemaParser, from: StatusCode, to: StatusCode) {\n for (let i = from; i <= to; i++) {\n if (this.#map.has(i)) {\n throw new Error(`Status code ${i} is already registered with a parser`);\n }\n this.#map.set(i, parser);\n }\n }\n\n validate(status: StatusCode, data: unknown, requireSchema: boolean) {\n const parser = this.getParser(status, requireSchema);\n if (\"parse\" in parser) {\n return parser.parse(data);\n }\n if('validate' in parser) {\n return parser.validate(data);\n }\n try {\n return parser(data);\n } catch (e) {\n const msg = `Failed to schema parse response data for status code ${status} with data:\n \n${JSON.stringify(data, null, 2)}}`;\n throw new Error(msg);\n }\n }\n\n getParser(status: StatusCode, requireSchema: boolean) {\n const parser = this.#map.get(status);\n if (!parser && requireSchema) {\n const msg = `No parser registered for status code ${status} but 'requireSchema' is true`;\n throw new Error(msg);\n }\n if (parser) {\n return parser;\n }\n return (data: unknown) => data;\n }\n\n toObject() {\n return Object.fromEntries(this.#map) as Record<StatusCode, SchemaParser>;\n }\n}\n","import { SchemaMap } from \"./schema.map\";\nimport { RequestHook, ResponseHook, SchemaParser, StatusCode } from \"./types\";\n\nexport interface SchemaConfig {\n schemas: SchemaMap;\n requireSchema: boolean;\n allowPlainText: boolean;\n}\n\nexport interface HTTPHooks {\n onSend: [string, RequestHook][];\n onReceive: [string, ResponseHook<unknown>][];\n}\n\n// export type MetaConfig = SchemaConfig & HTTPHooks;\n\nexport class MetaConfig implements SchemaConfig, HTTPHooks {\n schemas: SchemaMap;\n requireSchema: boolean;\n allowPlainText: boolean;\n onSend: [string, RequestHook][] = [];\n onReceive: [string, ResponseHook<unknown>][] = [];\n throwOnServerError: boolean;\n}\n\nexport class MetaConfigBuilder {\n #schemaMap = new SchemaMap();\n #requireSchema = false;\n #allowPlainText = false;\n #onBeforeSend: [string, RequestHook][] = [];\n #onAfterSend: [string, ResponseHook<unknown>][] = [];\n #throwOnServerError = false;\n\n schemaMap(map: SchemaMap) {\n this.#schemaMap = map;\n return this;\n }\n\n schema(parser: SchemaParser, ...codes: StatusCode[]): MetaConfigBuilder;\n schema(\n parser: SchemaParser,\n ...range: { from: StatusCode; to: StatusCode }[]\n ): MetaConfigBuilder;\n schema(\n parser: SchemaParser,\n ...args: (StatusCode | { from: StatusCode; to: StatusCode })[]\n ): MetaConfigBuilder;\n schema(\n parser: SchemaParser,\n ...args: (StatusCode | { from: StatusCode; to: StatusCode })[]\n ) {\n args.forEach((arg) => {\n if (typeof arg === \"number\") {\n this.#schemaMap.registerStatus(parser, arg);\n } else {\n this.#schemaMap.registerRange(parser, arg.from, arg.to);\n }\n });\n\n return this;\n }\n\n requireSchema(value: boolean) {\n this.#requireSchema = value;\n return this;\n }\n\n allowPlainText(value: boolean) {\n this.#allowPlainText = value;\n return this;\n }\n\n onBeforeSend(description: string, hook: RequestHook) {\n this.#onBeforeSend.push([description, hook]);\n return this;\n }\n\n #setOnSend(hooks: [string, RequestHook][]) {\n this.#onBeforeSend = hooks;\n return this;\n }\n\n throwOnServerError(value: boolean) {\n this.#throwOnServerError = value;\n return this;\n }\n\n onReceiveResponse(description: string, hook: ResponseHook<unknown>) {\n this.#onAfterSend.push([description, hook]);\n return this;\n }\n\n #setOnReceive(hooks: [string, ResponseHook<unknown>][]) {\n this.#onAfterSend = hooks;\n return this;\n }\n\n build() {\n const config = new MetaConfig();\n config.schemas = this.#schemaMap.derive();\n config.requireSchema = this.#requireSchema;\n config.allowPlainText = this.#allowPlainText;\n config.onSend = this.#onBeforeSend;\n config.onReceive = this.#onAfterSend;\n return config;\n }\n\n derive() {\n return new MetaConfigBuilder()\n .schemaMap(this.#schemaMap.derive())\n .requireSchema(this.#requireSchema)\n .allowPlainText(this.#allowPlainText)\n .throwOnServerError(this.#throwOnServerError)\n .#setOnSend(this.#onBeforeSend)\n .#setOnReceive(this.#onAfterSend);\n }\n}\n","import { AutomationError } from \"@autometa/errors\";\nimport isJson from \"@stdlib/assert-is-json\";\nimport { highlight } from \"cli-highlight\";\n\nexport function transformResponse(\n allowPlainText: boolean,\n data: null | undefined | string\n) {\n if (data === null) {\n return null;\n }\n if (data === undefined) {\n return undefined;\n }\n if (data === \"\") {\n return data;\n }\n if (isJson(data)) {\n return JSON.parse(data);\n }\n if (typeof data === \"string\" && [\"true\", \"false\"].includes(data)) {\n return JSON.parse(data);\n }\n if (typeof data === \"string\" && /^\\d*\\.?\\d+$/.test(data)) {\n return JSON.parse(data);\n }\n\n if (typeof data === \"object\") {\n return data;\n }\n if (allowPlainText) {\n return data;\n }\n\n const response = highlight(data, { language: \"html\" });\n const message = [\n `Could not parse a response as json, and this request was not configured to allow plain text responses.`,\n `To allow plain text responses, use the 'allowPlainText' method on the HTTP client.`,\n \"\",\n response\n ];\n throw new AutomationError(message.join(\"\\n\"));\n}\n","import isJson from \"@stdlib/assert-is-json\";\n\n/**\n * Schema which does not care about data validation.\n *\n * Useful if `requireSchema` is set to true, but a specific\n * endpoints response does not matter.\n * @param data\n * @returns\n */\nexport function AnySchema(data: unknown) {\n return data;\n}\n\n/**\n * Schema which validates that a response is empty. This can mean\n * the data payload was `null`, `undefined` or the string `'null'`.\n *\n * Useful if `requireSchema` is set to true, but a specific\n * endpoints response should be null or not defined.\n * @param data\n * @returns\n */\nexport function EmptySchema(data: unknown) {\n if (data !== null && data !== undefined && data !== \"null\") {\n throw new Error(`Expected null but got <${typeof data}> for ${data}`);\n }\n return data === \"null\" ? null : data;\n}\n\n/**\n * Schema which validates a response was null.\n *\n * Useful if `requireSchema` is set to true, but a specific\n * endpoints response should be null.\n * @param data\n * @returns\n */\nexport function NullSchema(data: unknown) {\n if (data !== null && data !== \"null\") {\n throw new Error(`Expected null but got <${typeof data}> for ${data}`);\n }\n return null;\n}\n\n/**\n * Schema which validates a response was undefined.\n *\n * Useful if `requireSchema` is set to true, but a specific\n * endpoints response should be undefined.\n *\n * @param data\n * @returns\n */\nexport function UndefinedSchema(data: unknown) {\n if (data !== undefined) {\n throw new Error(`Expected undefined but got <${typeof data}> for ${data}`);\n }\n return undefined;\n}\n\n/**\n * Schema which validates a response was a boolean, or a string of value\n * `'true'` or `'false'`.\n *\n * Useful if `requireSchema` is set to true, but a specific\n * endpoints response should be a boolean.\n *\n * @param data\n * @returns\n */\nexport function BooleanSchema(data: unknown) {\n if (\n !(typeof data === \"boolean\") &&\n [\"true\", \"false\"].includes(String(data)) === false\n ) {\n throw new Error(`Expected boolean but got <${typeof data}> for ${data}`);\n }\n return JSON.parse(data as string);\n}\n\n/**\n * Schema which validates a response was a number, or a string of value\n * of a number.\n *\n * Useful if `requireSchema` is set to true, but a specific\n * endpoints response should be a number.\n *\n * @param data\n * @returns\n */\nexport function NumberSchema(data: unknown) {\n if (\n !(typeof data === \"number\") &&\n /^\\d*\\.?\\d+$/.test(String(data)) === false\n ) {\n throw new Error(`Expected number but got <${typeof data}> for ${data}`);\n }\n return JSON.parse(data as string);\n}\n\n/**\n * Schema which validates a response was a string.\n *\n * Useful if `requireSchema` is set to true, but a specific\n * endpoints response should be a string.\n *\n * @param data\n * @returns\n */\nexport function StringSchema(data: unknown) {\n if (typeof data !== \"string\") {\n throw new Error(`Expected string but got <${typeof data}> for ${data}`);\n }\n return data;\n}\n\n\nexport function JSONSchema<T = unknown>(data: unknown) {\n if(typeof data === 'object') {\n return data as T;\n }\n if (!isJson(data)) {\n throw new Error(`Expected JSON but got <${typeof data}> for ${data}`);\n }\n const result = JSON.parse(data);\n return result;\n}"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACGO,IAAM,eAAN,MAAM,cAA0B;AAAA,EAOrC,cAAc;AACZ,SAAK,UAAU,CAAC;AAAA,EAClB;AAAA,EAEA,OAAO,QAAW,UAA2B;AAC3C,UAAM,cAAc,IAAI,cAAgB;AACxC,WAAO,OAAO,aAAa,QAAQ;AACnC,WAAO;AAAA,EACT;AAAA,EAuBA,UAAa,kBAA6D;AACxE,UAAM,QAAQ,sBAAyB,KAAK,MAAM,gBAAgB;AAClE,WAAO,IAAI,oBAAoB,EAC5B,OAAO,KAAK,MAAM,EAClB,WAAW,KAAK,UAAU,EAC1B,QAAQ,KAAK,OAAO,EACpB,QAAQ,KAAK,OAAO,EACpB,KAAK,KAAK,EACV,MAAM;AAAA,EACX;AACF;AAEA,SAAS,sBAAyB,MAAe,aAAyB;AACxE,SAAO,OAAO,gBAAgB,aAAa,YAAY,IAAI,IAAI;AACjE;AAvDA;AAyDO,IAAM,uBAAN,MAAM,qBAAoB;AAAA,EAA1B;AACL,kCAAY,IAAI,aAAa;AAAA;AAAA,EAE7B,OAAO,SAAS;AACd,WAAO,IAAI,qBAAoB;AAAA,EACjC;AAAA,EAEA,SAAS;AACP,WAAO,qBAAoB,OAAO,EAC/B,KAAK,mBAAK,WAAU,IAAI,EACxB,QAAQ,mBAAK,WAAU,OAAO,EAC9B,QAAQ,mBAAK,WAAU,OAAO,EAC9B,OAAO,mBAAK,WAAU,MAAM,EAC5B,WAAW,mBAAK,WAAU,UAAU;AAAA,EACzC;AAAA,EAEA,OAAO,MAAkB;AACvB,uBAAK,WAAU,SAAS;AACxB,WAAO;AAAA,EACT;AAAA,EAEA,WAAW,MAAc;AACvB,uBAAK,WAAU,aAAa;AAC5B,WAAO;AAAA,EACT;AAAA,EAEA,KAAQ,MAAS;AACf,uBAAK,WAAU,OAAO;AACtB,WAAO;AAAA,EACT;AAAA,EAEA,QAAQ,MAA8B;AACpC,uBAAK,WAAU,UAAU;AACzB,WAAO;AAAA,EACT;AAAA,EAEA,OAAO,MAAc,OAAe;AAClC,uBAAK,WAAU,QAAQ,IAAI,IAAI;AAC/B,WAAO;AAAA,EACT;AAAA,EAEA,QAAQ,SAA+B;AACrC,uBAAK,WAAU,UAAU;AACzB,WAAO;AAAA,EACT;AAAA,EAEA,QAAQ;AACN,WAAO,mBAAK;AAAA,EACd;AACF;AAhDE;AADK,IAAM,sBAAN;;;ACtDP,mBAA0C;;;ACCnC,IAAI;AACJ,IAAe,aAAf,MAA0B;AAAA,EAE/B,OAAO,IAAI,QAA4B;AACrC,QAAI,QAAQ;AACV,sBAAgB;AAAA,IAClB;AACA,WAAO,SAAU,QAA2B;AAC1C,sBAAgB;AAAA,IAClB;AAAA,EACF;AAKF;;;ADZO,IAAM,cAAN,cAA0B,WAAW;AAAA,EAC1C,MAAM,QACJ,SACA,SACsC;AACtC,UAAM,EAAE,SAAS,OAAO,QAAQ,SAAS,QAAQ,KAAK,IAAI;AAC1D,UAAM,MAAM,CAAC,SAAS,GAAG,KAAK,EAAE,KAAK,GAAG;AACxC,UAAM,eAAmC;AAAA,MACvC;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,gBAAgB,SAAU,QAAQ;AAChC,eAAO,UAAU,KAAK,SAAS;AAAA,MACjC;AAAA,MACA,GAAG;AAAA,IACL;AACA,UAAM,WAAW,UAAM,aAAAA,SAAM,YAAY;AACzC,WAAO,oBAAoB,OAAO,EAC/B,OAAO,SAAS,MAAoB,EACpC,WAAW,SAAS,UAAU,EAC9B,KAAK,SAAS,IAAI,EAClB,QAAQ,SAAS,OAAiC,EAClD,QAAQ,OAAO,EACf,MAAM;AAAA,EACX;AACF;AA3Ba,cAAN;AAAA,EADN,WAAW,IAAI;AAAA,GACH;;;AEPb,uBAAyC;;;ACGlC,SAAS,uBAAuB;AACrC,QAAM,OAAO;AACb,SAAO,IAAI,KAAK;AAClB;;;ACJA,yBAAyB;AAClB,IAAM,cAAN,MAAM,aAAqD;AAAA,EAQhE,YAAY,QAA6B;AAPzC,mBAAkC,CAAC;AACnC,kBAAsE,CAAC;AAEvE,iBAAkB,CAAC;AAKjB,WAAO,OAAO,MAAM,MAAM;AAAA,EAC5B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiBA,IAAI,UAAU;AACZ,eAAO,6BAAS,KAAK,SAAS,KAAK,OAAO,KAAK,MAAM;AAAA,EACvD;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,OAAO,UAAgC;AAC5C,UAAM,UAAU,IAAI,aAAY;AAChC,YAAQ,UAAU,EAAE,GAAG,SAAS,QAAQ;AACxC,YAAQ,SAAS,EAAE,GAAG,SAAS,OAAO;AACtC,YAAQ,UAAU,SAAS;AAC3B,YAAQ,QAAQ,CAAC,GAAG,SAAS,KAAK;AAClC,YAAQ,SAAS,SAAS;AAC1B,YAAQ,OAAO,SAAS;AACxB,WAAO;AAAA,EACT;AACF;AA/CA;AAiDO,IAAM,sBAAN,MAAM,oBAAmD;AAAA,EAQ9D,YAAY,UAAyB,MAAM,IAAI,YAAY,GAAQ;AAPnE;AACA,wCAAkB,oBAAI,IAIpB;AAGA,QAAI,OAAO,YAAY,YAAY;AACjC,yBAAK,UAAW,QAAQ;AACxB;AAAA,IACF;AACA,uBAAK,UAAW;AAAA,EAClB;AAAA,EAEA,OAAO,SAAyC;AAC9C,WAAO,IAAI,oBAAsB;AAAA,EACnC;AAAA,EAEA,IAAI,UAAU;AACZ,WAAO,mBAAK;AAAA,EACd;AAAA,EAEA,MAAM,wBAAwB;AAC5B,eAAW,CAAC,MAAM,KAAK,KAAK,mBAAK,kBAAiB;AAChD,UAAI;AACF,2BAAK,UAAS,QAAQ,IAAI,IAAI,OAAO,MAAM,MAAM,CAAC;AAAA,MACpD,SAAS,GAAG;AACV,cAAM,QAAQ;AACd,cAAM,MAAM,qCAAqC,IAAI;AAAA,EAC3D,KAAK;AACC,cAAM,IAAI,MAAM,GAAG;AAAA,MACrB;AAAA,IACF;AACA,WAAO;AAAA,EACT;AAAA,EAEA,IAAI,KAAa;AACf,uBAAK,UAAS,UAAU;AACxB,WAAO;AAAA,EACT;AAAA,EAEA,SAAS,OAAiB;AACxB,uBAAK,UAAS,MAAM,KAAK,GAAG,KAAK;AACjC,WAAO;AAAA,EACT;AAAA,EAEA,MACE,MACA,OAMA;AACA,QAAI,MAAM,QAAQ,KAAK,GAAG;AACxB,YAAM,QAAQ,MAAM,IAAI,MAAM;AAC9B,yBAAK,UAAS,OAAO,IAAI,IAAI;AAC7B,aAAO;AAAA,IACT;AACA,QAAI,CAAC,MAAM,QAAQ,KAAK,KAAK,OAAO,UAAU,UAAU;AACtD,yBAAK,UAAS,OAAO,IAAI,IAAI;AAC7B,aAAO;AAAA,IACT;AACA,uBAAK,UAAS,OAAO,IAAI,IAAI,OAAO,KAAK;AACzC,WAAO;AAAA,EACT;AAAA,EAEA,OAAO,MAA+B;AACpC,WAAO,OAAO,mBAAK,UAAS,QAAQ,IAAI;AACxC,WAAO;AAAA,EACT;AAAA,EAEA,KAAQ,MAAS;AACf,uBAAK,UAAS,OAAO;AACrB,WAAO;AAAA,EACT;AAAA,EAEA,OACE,MACA,OAQA;AACA,QAAI,OAAO,UAAU,YAAY;AAC/B,yBAAK,iBAAgB,IAAI,MAAM,KAAK;AAAA,IACtC;AACA,UAAM,MAAM,MAAM,QAAQ,KAAK,IAAI,MAAM,KAAK,GAAG,IAAI,OAAO,KAAK;AACjE,uBAAK,UAAS,QAAQ,IAAI,IAAI;AAC9B,WAAO;AAAA,EACT;AAAA,EAEA,QAAQ,MAA8B;AACpC,WAAO,OAAO,mBAAK,UAAS,SAAS,IAAI;AACzC,WAAO;AAAA,EACT;AAAA,EAEA,MAAM;AACJ,WAAO,mBAAK;AAAA,EACd;AAAA,EAEA,OAAO,QAAoB;AACzB,uBAAK,UAAS,SAAS;AACvB,WAAO;AAAA,EACT;AAAA,EAEA,SAAgC;AAC9B,UAAM,UAAU,YAAY,OAAO,mBAAK,SAAQ;AAChD,WAAO,IAAI,oBAAmB,OAAO;AAAA,EACvC;AAAA,EAEA,QAAwB;AACtB,WAAO,mBAAK;AAAA,EACd;AACF;AAxHE;AACA;AAFK,IAAM,qBAAN;;;ACjDP;AACO,IAAM,aAAN,MAAM,WAAU;AAAA,EAErB,YAAY,KAAiD;AAD7D;AAEE,QAAI,eAAe,YAAW;AAC5B,yBAAK,MAAO,IAAI,IAAI,kBAAI,KAAI;AAC5B;AAAA,IACF;AACA,uBAAK,MAAO,IAAI,IAAI,GAAG;AAAA,EACzB;AAAA,EAEA,SAAS;AACP,WAAO,IAAI,WAAU,mBAAK,KAAI;AAAA,EAChC;AAAA,EAEA,eAAe,WAAyB,OAAqB;AAC3D,UAAM,QAAQ,CAAC,SAAS;AACtB,UAAI,mBAAK,MAAK,IAAI,IAAI,GAAG;AACvB,cAAM,MAAM,eAAe,IAAI;AAC/B,cAAM,IAAI,MAAM,GAAG;AAAA,MACrB;AACA,yBAAK,MAAK,IAAI,MAAM,MAAM;AAAA,IAC5B,CAAC;AAAA,EACH;AAAA,EAEA,cAAc,QAAsB,MAAkB,IAAgB;AACpE,aAAS,IAAI,MAAM,KAAK,IAAI,KAAK;AAC/B,UAAI,mBAAK,MAAK,IAAI,CAAC,GAAG;AACpB,cAAM,IAAI,MAAM,eAAe,CAAC,sCAAsC;AAAA,MACxE;AACA,yBAAK,MAAK,IAAI,GAAG,MAAM;AAAA,IACzB;AAAA,EACF;AAAA,EAEA,SAAS,QAAoB,MAAe,eAAwB;AAClE,UAAM,SAAS,KAAK,UAAU,QAAQ,aAAa;AACnD,QAAI,WAAW,QAAQ;AACrB,aAAO,OAAO,MAAM,IAAI;AAAA,IAC1B;AACA,QAAG,cAAc,QAAQ;AACvB,aAAO,OAAO,SAAS,IAAI;AAAA,IAC7B;AACA,QAAI;AACF,aAAO,OAAO,IAAI;AAAA,IACpB,SAAS,GAAG;AACV,YAAM,MAAM,wDAAwD,MAAM;AAAA;AAAA,EAE9E,KAAK,UAAU,MAAM,MAAM,CAAC,CAAC;AACzB,YAAM,IAAI,MAAM,GAAG;AAAA,IACrB;AAAA,EACF;AAAA,EAEA,UAAU,QAAoB,eAAwB;AACpD,UAAM,SAAS,mBAAK,MAAK,IAAI,MAAM;AACnC,QAAI,CAAC,UAAU,eAAe;AAC5B,YAAM,MAAM,wCAAwC,MAAM;AAC1D,YAAM,IAAI,MAAM,GAAG;AAAA,IACrB;AACA,QAAI,QAAQ;AACV,aAAO;AAAA,IACT;AACA,WAAO,CAAC,SAAkB;AAAA,EAC5B;AAAA,EAEA,WAAW;AACT,WAAO,OAAO,YAAY,mBAAK,KAAI;AAAA,EACrC;AACF;AAjEE;AADK,IAAM,YAAN;;;ACeA,IAAM,aAAN,MAAoD;AAAA,EAApD;AAIL,kBAAkC,CAAC;AACnC,qBAA+C,CAAC;AAAA;AAElD;AAvBA;AAyBO,IAAM,qBAAN,MAAM,mBAAkB;AAAA,EAAxB;AAoDL;AAeA;AAlEA,mCAAa,IAAI,UAAU;AAC3B,uCAAiB;AACjB,wCAAkB;AAClB,sCAAyC,CAAC;AAC1C,qCAAkD,CAAC;AACnD,4CAAsB;AAAA;AAAA,EAEtB,UAAU,KAAgB;AACxB,uBAAK,YAAa;AAClB,WAAO;AAAA,EACT;AAAA,EAWA,OACE,WACG,MACH;AACA,SAAK,QAAQ,CAAC,QAAQ;AACpB,UAAI,OAAO,QAAQ,UAAU;AAC3B,2BAAK,YAAW,eAAe,QAAQ,GAAG;AAAA,MAC5C,OAAO;AACL,2BAAK,YAAW,cAAc,QAAQ,IAAI,MAAM,IAAI,EAAE;AAAA,MACxD;AAAA,IACF,CAAC;AAED,WAAO;AAAA,EACT;AAAA,EAEA,cAAc,OAAgB;AAC5B,uBAAK,gBAAiB;AACtB,WAAO;AAAA,EACT;AAAA,EAEA,eAAe,OAAgB;AAC7B,uBAAK,iBAAkB;AACvB,WAAO;AAAA,EACT;AAAA,EAEA,aAAa,aAAqB,MAAmB;AACnD,uBAAK,eAAc,KAAK,CAAC,aAAa,IAAI,CAAC;AAC3C,WAAO;AAAA,EACT;AAAA,EAOA,mBAAmB,OAAgB;AACjC,uBAAK,qBAAsB;AAC3B,WAAO;AAAA,EACT;AAAA,EAEA,kBAAkB,aAAqB,MAA6B;AAClE,uBAAK,cAAa,KAAK,CAAC,aAAa,IAAI,CAAC;AAC1C,WAAO;AAAA,EACT;AAAA,EAOA,QAAQ;AACN,UAAM,SAAS,IAAI,WAAW;AAC9B,WAAO,UAAU,mBAAK,YAAW,OAAO;AACxC,WAAO,gBAAgB,mBAAK;AAC5B,WAAO,iBAAiB,mBAAK;AAC7B,WAAO,SAAS,mBAAK;AACrB,WAAO,YAAY,mBAAK;AACxB,WAAO;AAAA,EACT;AAAA,EAEA,SAAS;AA3GX;AA4GI,WAAO,8CAAI,mBAAkB,EAC1B,UAAU,mBAAK,YAAW,OAAO,CAAC,EAClC,cAAc,mBAAK,eAAc,EACjC,eAAe,mBAAK,gBAAe,EACnC,mBAAmB,mBAAK,oBAAmB,GAC3C,0BALI,SAKO,mBAAK,iBAChB,gCANI,SAMU,mBAAK;AAAA,EACxB;AACF;AA1FE;AACA;AACA;AACA;AACA;AACA;AA8CA;AAAA,eAAU,SAAC,OAAgC;AACzC,qBAAK,eAAgB;AACrB,SAAO;AACT;AAYA;AAAA,kBAAa,SAAC,OAA0C;AACtD,qBAAK,cAAe;AACpB,SAAO;AACT;AAtEK,IAAM,oBAAN;;;ACzBP,oBAAgC;AAChC,4BAAmB;AACnB,2BAA0B;AAEnB,SAAS,kBACd,gBACA,MACA;AACA,MAAI,SAAS,MAAM;AACjB,WAAO;AAAA,EACT;AACA,MAAI,SAAS,QAAW;AACtB,WAAO;AAAA,EACT;AACA,MAAI,SAAS,IAAI;AACf,WAAO;AAAA,EACT;AACA,UAAI,sBAAAC,SAAO,IAAI,GAAG;AAChB,WAAO,KAAK,MAAM,IAAI;AAAA,EACxB;AACA,MAAI,OAAO,SAAS,YAAY,CAAC,QAAQ,OAAO,EAAE,SAAS,IAAI,GAAG;AAChE,WAAO,KAAK,MAAM,IAAI;AAAA,EACxB;AACA,MAAI,OAAO,SAAS,YAAY,cAAc,KAAK,IAAI,GAAG;AACxD,WAAO,KAAK,MAAM,IAAI;AAAA,EACxB;AAEA,MAAI,OAAO,SAAS,UAAU;AAC5B,WAAO;AAAA,EACT;AACA,MAAI,gBAAgB;AAClB,WAAO;AAAA,EACT;AAEA,QAAM,eAAW,gCAAU,MAAM,EAAE,UAAU,OAAO,CAAC;AACrD,QAAM,UAAU;AAAA,IACd;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACA,QAAM,IAAI,8BAAgB,QAAQ,KAAK,IAAI,CAAC;AAC9C;;;AL3BA,IAAAC,iBAAgC;AAfhC,IAAAC,WAAA;AAyIO,IAAM,OAAN,MAAW;AAAA,EAGhB,YACmB,SAAqB,qBAAqB,GAC3D,UAEI,IAAI,mBAAmB,GAC3B,aAAgC,IAAI,kBAAkB,GACtD;AALiB;AAyqBnB,uBAAM;AA2CN;AAvtBA,uBAAAA,WAAA;AACA;AAQE,uBAAKA,WAAW,QAAQ,OAAO;AAC/B,uBAAK,aAAc,WAAW,OAAO;AAAA,EACvC;AAAA,EAEA,OAAO,OACL,SAAqB,IAAI,YAAY,GACrC,UAEI,IAAI,mBAAmB,GAC3B,aAAgC,IAAI,kBAAkB,GACtD;AACA,WAAO,IAAI,KAAK,QAAQ,SAAS,UAAU;AAAA,EAC7C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAmBA,IAAI,KAAa;AACf,uBAAKA,WAAS,IAAI,GAAG;AACrB,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,cAAc,UAAmB;AAC/B,uBAAK,aAAY,cAAc,QAAQ;AACvC,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAeA,qBAAqB,OAAgB;AACnC,uBAAK,aAAY,eAAe,KAAK;AACrC,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAeA,eAAe,OAAgB;AAC7B,WAAO,KAAK;AAAA,MACV,KAAK;AAAA,MACL,mBAAKA,WAAS,OAAO;AAAA,MACrB,mBAAK,aAAY,OAAO,EAAE,eAAe,KAAK;AAAA,IAChD;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiCA,eAAe,OAAsC;AACnD,uBAAKA,WAAS,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AACrD,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA+BA,SAAS,OAAsC;AAC7C,UAAM,SAAS,MAAM,IAAI,CAAC,MAAM,OAAO,CAAC,CAAC;AACzC,WAAO,KAAK,OAAO,KAAK,QAAQ,mBAAKA,WAAS,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;AAAA,EACzE;AAAA,EAoCA,aACE,WACG,MACG;AACN,uBAAK,aAAY,OAAO,QAAQ,GAAG,IAAI;AACvC,WAAO;AAAA,EACT;AAAA,EA6CA,OACE,WACG,MACG;AACN,WAAO,KAAK;AAAA,MACV,KAAK;AAAA,MACL,mBAAKA,WAAS,OAAO;AAAA,MACrB,mBAAK,aAAY,OAAO,EAAE,OAAO,QAAQ,GAAG,IAAI;AAAA,IAClD;AAAA,EACF;AAAA,EAiBA,YACE,MAEA,OACM;AACN,uBAAKA,WAAS,MAAM,MAAM,KAAK;AAC/B,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA8BA,aAAa,aAAqB,MAAmB;AACnD,uBAAK,aAAY,aAAa,aAAa,IAAI;AAC/C,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA8BA,gBAAgB,aAAqB,MAA6B;AAChE,uBAAK,aAAY,kBAAkB,aAAa,IAAI;AACpD,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAqBA,aAAa,MAA+B;AAC1C,uBAAKA,WAAS,OAAO,IAAI;AACzB,WAAO;AAAA,EACT;AAAA;AAAA,EA4BA,MAAM,MAAc,OAAY;AAC9B,WAAO,KAAK,OAAO,KAAK,QAAQ,mBAAKA,WAAS,OAAO,EAAE,MAAM,MAAM,KAAK,CAAC;AAAA,EAC3E;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAqBA,OAAO,MAA8B;AACnC,uBAAKA,WAAS,OAAO,IAAI;AACzB,WAAO,KAAK,OAAO,KAAK,QAAQ,mBAAKA,WAAS,OAAO,EAAE,OAAO,IAAI,CAAC;AAAA,EACrE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAaA,WAAc,MAAS;AACrB,uBAAKA,WAAS,KAAK,IAAI;AACvB,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiBA,aACE,MACA,OAQA;AACA,uBAAKA,WAAS,OAAO,MAAM,KAAK;AAChC,WAAO;AAAA,EACT;AAAA,EAEA,OACE,MACA,OAQA;AACA,WAAO,KAAK,OAAO,KAAK,QAAQ,mBAAKA,WAAS,OAAO,EAAE,OAAO,MAAM,KAAK,CAAC;AAAA,EAC5E;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAaA,KAAQ,MAAS;AACf,uBAAKA,WAAS,KAAK,IAAI;AACvB,WAAO,KAAK,OAAO,KAAK,QAAQ,mBAAKA,WAAS,OAAO,EAAE,KAAK,IAAI,CAAC;AAAA,EACnE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiCA,OAAO,aAAqB,MAAmB;AAC7C,WAAO,KAAK;AAAA,MACV,KAAK;AAAA,MACL,mBAAKA,WAAS,OAAO;AAAA,MACrB,mBAAK,aAAY,OAAO,EAAE,aAAa,aAAa,IAAI;AAAA,IAC1D;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiCA,UAAU,aAAqB,MAA6B;AAC1D,WAAO,KAAK;AAAA,MACV,KAAK;AAAA,MACL,mBAAKA,WAAS,OAAO;AAAA,MACrB,mBAAK,aAAY,OAAO,EAAE,kBAAkB,aAAa,IAAI;AAAA,IAC/D;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,IAAmB,SAA0C;AAC3D,WAAO,sBAAK,8BAAL,WACL,mBAAKA,WAAS,OAAO,EAAE,OAAO,KAAK,GACnC;AAAA,EAEJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,KAAoB,SAA0C;AAC5D,WAAO,sBAAK,8BAAL,WACL,mBAAKA,WAAS,OAAO,EAAE,OAAO,MAAM,GACpC;AAAA,EAEJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,OAAsB,SAA0C;AAC9D,WAAO,sBAAK,8BAAL,WACL,mBAAKA,WAAS,OAAO,EAAE,OAAO,QAAQ,GACtC;AAAA,EAEJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,IAAmB,SAA0C;AAC3D,WAAO,sBAAK,8BAAL,WACL,mBAAKA,WAAS,OAAO,EAAE,OAAO,KAAK,GACnC;AAAA,EAEJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAqB,SAA0C;AAC7D,WAAO,sBAAK,8BAAL,WACL,mBAAKA,WAAS,OAAO,EAAE,OAAO,OAAO,GACrC;AAAA,EAEJ;AAAA,EAEA,KAAoB,SAA0C;AAC5D,WAAO,sBAAK,8BAAL,WACL,mBAAKA,WAAS,OAAO,EAAE,OAAO,MAAM,GACpC;AAAA,EAEJ;AAAA,EAEA,QAAuB,SAA0C;AAC/D,WAAO,sBAAK,8BAAL,WACL,mBAAKA,WAAS,OAAO,EAAE,OAAO,SAAS,GACvC;AAAA,EAEJ;AAAA,EAEA,MAAqB,SAA0C;AAC7D,WAAO,sBAAK,8BAAL,WACL,mBAAKA,WAAS,OAAO,EAAE,OAAO,OAAO,GACrC;AAAA,EAEJ;AAAA,EAEA,QAAuB,SAA0C;AAC/D,WAAO,sBAAK,8BAAL,WACL,mBAAKA,WAAS,OAAO,EAAE,OAAO,SAAS,GACvC;AAAA,EAEJ;AAAA,EAgBA,MAAc,eACZ,MACA,SACA;AACA,eAAW,CAAC,aAAa,IAAI,KAAK,KAAK,QAAQ;AAC7C,UAAI;AACF,cAAM,KAAK,OAAO;AAAA,MACpB,SAAS,GAAG;AACV,cAAM,QAAQ;AACd,cAAM,MAAM,uDAAuD,WAAW;AAC9E,cAAM,IAAI,+BAAgB,KAAK,EAAE,MAAM,CAAC;AAAA,MAC1C;AAAA,IACF;AAAA,EACF;AAAA,EACA,MAAc,kBACZ,MACA,UACA;AACA,eAAW,CAAC,aAAa,IAAI,KAAK,KAAK,WAAW;AAChD,UAAI;AACF,cAAM,KAAK,QAAQ;AAAA,MACrB,SAAS,GAAG;AACV,cAAM,QAAQ;AACd,cAAM,MAAM,0DAA0D,WAAW;AACjF,cAAM,IAAI,+BAAgB,KAAK,EAAE,MAAM,CAAC;AAAA,MAC1C;AAAA,IACF;AAAA,EACF;AAeF;AApuBEA,YAAA;AACA;AA2qBM;AAAA,iBAAY,eAChB,SACA,SACA;AACA,QAAM,WAAW,MAAM,QAAQ,sBAAsB,GAAG,MAAM;AAC9D,QAAM,OAAO,mBAAK,aAAY,OAAO,EAAE,MAAM;AAC7C,QAAM,KAAK,eAAe,MAAM,OAAO;AACvC,QAAM,SAAS,MAAM,KAAK,OAAO,QAAyB,SAAS,OAAO;AAC1E,SAAO,OAAO,kBAAkB,KAAK,gBAAgB,OAAO,IAAI;AAChE,QAAM,KAAK,kBAAkB,MAAM,MAAM;AACzC,QAAM,YAAY,sBAAK,wCAAL,WAAuB,QAAQ;AACjD,SAAO;AACT;AA+BA;AAAA,sBAAoB,SAClB,UACA,MACiB;AACjB,QAAM,EAAE,QAAQ,KAAK,IAAI;AACzB,QAAM,YAAY,KAAK,QAAQ;AAAA,IAC7B;AAAA,IACA;AAAA,IACA,KAAK;AAAA,EACP;AACA,WAAS,OAAO;AAChB,SAAO;AACT;AApuBW,OAAN;AAAA,MADN,0BAAQ,iCAAgB,SAAS;AAAA,GACrB;;;AMzIb,IAAAC,yBAAmB;AAUZ,SAAS,UAAU,MAAe;AACvC,SAAO;AACT;AAWO,SAAS,YAAY,MAAe;AACzC,MAAI,SAAS,QAAQ,SAAS,UAAa,SAAS,QAAQ;AAC1D,UAAM,IAAI,MAAM,0BAA0B,OAAO,IAAI,SAAS,IAAI,EAAE;AAAA,EACtE;AACA,SAAO,SAAS,SAAS,OAAO;AAClC;AAUO,SAAS,WAAW,MAAe;AACxC,MAAI,SAAS,QAAQ,SAAS,QAAQ;AACpC,UAAM,IAAI,MAAM,0BAA0B,OAAO,IAAI,SAAS,IAAI,EAAE;AAAA,EACtE;AACA,SAAO;AACT;AAWO,SAAS,gBAAgB,MAAe;AAC7C,MAAI,SAAS,QAAW;AACtB,UAAM,IAAI,MAAM,+BAA+B,OAAO,IAAI,SAAS,IAAI,EAAE;AAAA,EAC3E;AACA,SAAO;AACT;AAYO,SAAS,cAAc,MAAe;AAC3C,MACE,EAAE,OAAO,SAAS,cAClB,CAAC,QAAQ,OAAO,EAAE,SAAS,OAAO,IAAI,CAAC,MAAM,OAC7C;AACA,UAAM,IAAI,MAAM,6BAA6B,OAAO,IAAI,SAAS,IAAI,EAAE;AAAA,EACzE;AACA,SAAO,KAAK,MAAM,IAAc;AAClC;AAYO,SAAS,aAAa,MAAe;AAC1C,MACE,EAAE,OAAO,SAAS,aAClB,cAAc,KAAK,OAAO,IAAI,CAAC,MAAM,OACrC;AACA,UAAM,IAAI,MAAM,4BAA4B,OAAO,IAAI,SAAS,IAAI,EAAE;AAAA,EACxE;AACA,SAAO,KAAK,MAAM,IAAc;AAClC;AAWO,SAAS,aAAa,MAAe;AAC1C,MAAI,OAAO,SAAS,UAAU;AAC5B,UAAM,IAAI,MAAM,4BAA4B,OAAO,IAAI,SAAS,IAAI,EAAE;AAAA,EACxE;AACA,SAAO;AACT;AAGO,SAAS,WAAwB,MAAe;AACrD,MAAG,OAAO,SAAS,UAAU;AAC3B,WAAO;AAAA,EACT;AACA,MAAI,KAAC,uBAAAC,SAAO,IAAI,GAAG;AACjB,UAAM,IAAI,MAAM,0BAA0B,OAAO,IAAI,SAAS,IAAI,EAAE;AAAA,EACtE;AACA,QAAM,SAAS,KAAK,MAAM,IAAI;AAC9B,SAAO;AACT;","names":["axios","isJson","import_errors","_request","import_assert_is_json","isJson"]}
|
|
1
|
+
{"version":3,"sources":["../src/index.ts","../src/http-response.ts","../src/axios-client.ts","../src/http-client.ts","../src/http.ts","../src/default-client-factory.ts","../src/http-request.ts","../src/schema.map.ts","../src/request-meta.config.ts","../src/transform-response.ts","../src/default-schema.ts"],"sourcesContent":["export * from \"./axios-client\";\nexport * from \"./http-client\";\nexport * from \"./http\";\nexport * from \"./http-request\";\nexport * from \"./http-response\";\nexport * from \"./default-schema\";\nexport type {\n HTTPAdditionalOptions,\n HTTPMethod,\n SchemaParser,\n RequestHook,\n ResponseHook\n} from \"./types\";\n","import { HTTPRequest } from \"./http-request\";\nimport { StatusCode } from \"./types\";\n\nexport class HTTPResponse<T = unknown> {\n status: StatusCode;\n statusText: string;\n data: T;\n headers: Record<string, string>;\n request: HTTPRequest<unknown>;\n\n constructor() {\n this.headers = {};\n }\n\n static fromRaw<T>(response: HTTPResponse<T>) {\n const newResponse = new HTTPResponse<T>();\n Object.assign(newResponse, response);\n return response;\n }\n\n /**\n * Decomposes a response, creating an exact copy of the current response,\n * but with a new data value. The data can be provided directly as is, or it\n * can be generated through a callback function which receives the current\n * response data as an argument.\n *\n * ```ts\n * const response = await http.get(\"/products\");\n *\n * // direct value\n * const products = response.data;\n * const firstProduct = response.decompose(products[0]);\n * // callback transformer\n * const secondProduct = response.decompose((products) => products[1]);\n * // callback transformer with destructuring\n * const secondProduct = response.decompose(([product]) => product);\n * ```\n * @param value\n */\n decompose<K>(value: K): HTTPResponse<K>;\n decompose<K>(transformFn: (response: T) => K): HTTPResponse<K>;\n decompose<K>(transformFnOrVal: K | ((response: T) => K)): HTTPResponse<K> {\n const value = getDecompositionValue<T>(this.data, transformFnOrVal);\n return new HTTPResponseBuilder()\n .status(this.status)\n .statusText(this.statusText)\n .headers(this.headers)\n .request(this.request)\n .data(value)\n .build() as HTTPResponse<K>;\n }\n}\n\nfunction getDecompositionValue<T>(data: unknown, transformFn: unknown): T {\n return typeof transformFn === \"function\" ? transformFn(data) : transformFn;\n}\n\nexport class HTTPResponseBuilder {\n #response = new HTTPResponse();\n\n static create() {\n return new HTTPResponseBuilder();\n }\n\n derive() {\n return HTTPResponseBuilder.create()\n .data(this.#response.data)\n .headers(this.#response.headers)\n .request(this.#response.request)\n .status(this.#response.status)\n .statusText(this.#response.statusText);\n }\n\n status(code: StatusCode) {\n this.#response.status = code;\n return this;\n }\n\n statusText(text: string) {\n this.#response.statusText = text;\n return this;\n }\n\n data<T>(data: T) {\n this.#response.data = data;\n return this;\n }\n\n headers(dict: Record<string, string>) {\n this.#response.headers = dict;\n return this;\n }\n\n header(name: string, value: string) {\n this.#response.headers[name] = value;\n return this;\n }\n\n request(request: HTTPRequest<unknown>) {\n this.#response.request = request;\n return this;\n }\n\n build() {\n return this.#response;\n }\n}\n","import { HTTPRequest } from \"./http-request\";\nimport { HTTPResponse, HTTPResponseBuilder } from \"./http-response\";\nimport { HTTPAdditionalOptions, StatusCode } from \"./types\";\nimport axios, { AxiosRequestConfig } from \"axios\";\nimport { HTTPClient } from \"./http-client\";\n\n@HTTPClient.Use()\nexport class AxiosClient extends HTTPClient {\n async request<TRequestType, TResponseType>(\n request: HTTPRequest<TRequestType>,\n options: HTTPAdditionalOptions<AxiosRequestConfig>\n ): Promise<HTTPResponse<TResponseType>> {\n const { baseUrl, route, params, headers, method, data } = request;\n const url = [baseUrl, ...route].join(\"/\");\n const axiosRequest: AxiosRequestConfig = {\n url,\n params,\n headers,\n method: method,\n data,\n validateStatus: function (status) {\n return status >= 0 && status < 600;\n },\n ...options\n };\n const response = await axios(axiosRequest);\n return HTTPResponseBuilder.create()\n .status(response.status as StatusCode)\n .statusText(response.statusText)\n .data(response.data)\n .headers(response.headers as Record<string, string>)\n .request(request)\n .build() as HTTPResponse<TResponseType>;\n }\n}\n","import { HTTPRequest } from \"./http-request\";\nimport { HTTPResponse } from \"./http-response\";\nimport { HTTPAdditionalOptions } from \"./types\";\nimport { Class } from \"@autometa/types\";\nexport let defaultClient: Class<HTTPClient>;\nexport abstract class HTTPClient {\n static Use(): (target: Class<HTTPClient>) => void\n static Use(client?: Class<HTTPClient>) {\n if (client) {\n defaultClient = client\n }\n return function (target: Class<HTTPClient>) {\n defaultClient = target\n };\n }\n abstract request<TRequestType, TResponseType>(\n request: HTTPRequest<TRequestType>,\n options?: HTTPAdditionalOptions<unknown>\n ): Promise<HTTPResponse<TResponseType>>;\n}\n","import { Fixture, INJECTION_SCOPE } from \"@autometa/injection\";\nimport { AxiosClient } from \"./axios-client\";\nimport { HTTPClient } from \"./http-client\";\nimport { defaultClientFactory } from \"./default-client-factory\";\nimport { HTTPRequest, HTTPRequestBuilder } from \"./http-request\";\nimport { HTTPResponse } from \"./http-response\";\nimport { MetaConfig, MetaConfigBuilder } from \"./request-meta.config\";\nimport {\n HTTPAdditionalOptions,\n RequestHook,\n ResponseHook,\n SchemaParser,\n StatusCode\n} from \"./types\";\nimport { transformResponse } from \"./transform-response\";\nimport { AutomationError } from \"@autometa/errors\";\n\n/**\n * The HTTP fixture allows requests to be built and sent to a server. In general,\n * there are 2 modes of operation:\n *\n * * Shared Chain: The shared chain is used to configure the client for all requests, such as\n * routes this instance will always be used. When a shared chain method is called, it returns\n * the same instance of HTTP which can be further chained to configure the client.\n * * Request Chain: The request chain is used to configure a single request, inheriting values\n * set by the shared chain. When called, a new HTTP client instance is created and inherits the values\n * set by it's parent.\n *\n * The 2 modes are intended to simplify configuring an object through an inheritance chain. For example,\n * assume we have an API with 2 controller routes, `/product` and `/seller`. We can set up a Base Client\n * which consumes the HTTP fixture and configures it with the base url of our API.\n *\n * Inheritors can further configure their HTTP instance's routes.\n *\n * ```ts\n * \\@Constructor(HTTP)\n * export class BaseClient {\n * constructor(protected readonly http: HTTP) {\n * this.http.url(\"https://api.example.com\");\n * }\n * }\n *\n * export class ProductClient extends BaseClient {\n * constructor(http: HTTP) {\n * super(http);\n * this.http.sharedRoute(\"product\");\n * }\n * getProduct(id: number) {\n * return this.http.route(id).get();\n * }\n *\n * export class SellerClient extends BaseClient {\n * constructor(http: HTTP) {\n * super(http);\n * this.http.sharedRoute(\"seller\");\n * }\n *\n * getSeller(id: number) {\n * return this.http.route(id).get();\n * }\n * }\n * ```\n *\n * 'Schemas' can also be configured. A Schema is a function or an object with a `parse` method, which\n * takes a response data payload and returns a validated object. Schemas are mapped to\n * HTTP Status Codes, and if configured to be required the request will fail if no schema is found\n * matching that code.\n *\n * Defining a schema function:\n *\n * ```\n * // user.schema.ts\n * export function UserSchema(data: unknown) {\n * if(typeof data !== \"object\") {\n * throw new Error(\"Expected an object\");\n * }\n *\n * if(typeof data.name !== \"string\") {\n * throw new Error(\"Expected a string\");\n * }\n *\n * return data as { name: string };\n * }\n *\n * // user.controller.ts\n * \\@Fixture(INJECTION_SCOPE.TRANSIENT)\n * export class UserController extends BaseController {\n * constructor(private readonly http: HTTP) {\n * super(http);\n * this.http\n * .sharedRoute(\"user\")\n * .sharedSchema(ErrorSchema, { from: 400, to: 499 });\n * }\n *\n * getUser(id: number) {\n * return this.http.route(id).schema(UserSchema, 200).get();\n * // or\n * return this.http\n * .route(id)\n * .schema(UserSchema, { from: 200, to: 299 })\n * .get();\n * // or\n * return this.http\n * .route(id)\n * .schema(UserSchema, 200, 201, 202)\n * .get();\n * }\n * }\n * ```\n *\n * Validation libraries which use a `.parse` or `.validation`, method, such as Zod or MyZod, can also be used as schemas:\n *\n * ```ts\n * // user.schema.ts\n * import { z } from \"myzod\";\n *\n * export const UserSchema = z.object({\n * name: z.string()\n * });\n *\n * // user.controller.ts\n * \\@Fixture(INJECTION_SCOPE.TRANSIENT)\n * export class UserController extends BaseController {\n * constructor(private readonly http: HTTP) {\n * super(http);\n * this.http\n * .sharedRoute(\"user\")\n * .sharedSchema(ErrorSchema, { from: 400, to: 499 })\n * }\n *\n * getUser(id: number) {\n * return this.http.route(id).schema(UserSchema, 200).get();\n * }\n * }\n * ```\n */\n@Fixture(INJECTION_SCOPE.TRANSIENT)\nexport class HTTP {\n #request: HTTPRequestBuilder<HTTPRequest<unknown>>;\n #metaConfig: MetaConfigBuilder;\n constructor(\n private readonly client: HTTPClient = defaultClientFactory(),\n builder: HTTPRequestBuilder<\n HTTPRequest<unknown>\n > = new HTTPRequestBuilder(),\n metaConfig: MetaConfigBuilder = new MetaConfigBuilder()\n ) {\n this.#request = builder;\n this.#metaConfig = metaConfig.derive();\n }\n\n static create(\n client: HTTPClient = new AxiosClient(),\n builder: HTTPRequestBuilder<\n HTTPRequest<unknown>\n > = new HTTPRequestBuilder(),\n metaConfig: MetaConfigBuilder = new MetaConfigBuilder()\n ) {\n return new HTTP(client, builder, metaConfig);\n }\n\n /**\n * Sets the base url of the request for this client, such as\n * `https://api.example.com`, and could include always-used routes like\n * the api version, such as `/v1` or `/api/v1` at the end.\n *\n * ```ts\n *\n * \\@Fixture(INJECTION_SCOPE.TRANSIENT)\n * export abstract class BaseClient {\n * constructor(protected readonly http: HTTP) {\n * this.http.url(\"https://api.example.com\");\n * }\n * }\n * ```\n * @param url\n * @returns\n */\n url(url: string) {\n this.#request.url(url);\n return this;\n }\n\n /**\n * If set to true, all requests derived from this client will require a schema be defined\n * matching any response status code. If set to false, a schema will still be used for validation\n * if defined, or the unadulterated original body will be returned if no schema matches.\n *\n * @param required Whether or not a schema is required for all responses.\n * @returns This instance of HTTP.\n */\n requireSchema(required: boolean) {\n this.#metaConfig.requireSchema(required);\n return this;\n }\n\n /**\n * If set to true, all requests derived from this client will allow plain text\n * responses. If set to false, plain text responses will throw an serialization error.\n *\n * Useful when an endpoint returns a HTML or plain text response. If the plain text\n * is the value of `true` or `false`, or a number, it will be parsed into the\n * appropriate type.\n *\n * This method is a shared chain method, and will return the same instance of HTTP.\n *\n * @param allow Whether or not plain text responses are allowed.\n * @returns This instance of HTTP.\n */\n sharedAllowPlainText(allow: boolean) {\n this.#metaConfig.allowPlainText(allow);\n return this;\n }\n\n /**\n * If set to true, all requests derived from this client will allow plain text\n * responses. If set to false, plain text responses will throw an serialization error.\n *\n * Useful when an endpoint returns a HTML or plain text response. If the plain text\n * is the value of `true` or `false`, or a number, it will be parsed into the\n * appropriate type.\n *\n * This method is a request chain method, and will return a new instance of HTTP.\n *\n * @param allow Whether or not plain text responses are allowed.\n * @returns A new child instance of HTTP derived from this one.\n */\n allowPlainText(allow: boolean) {\n return HTTP.create(\n this.client,\n this.#request.derive(),\n this.#metaConfig.derive().allowPlainText(allow)\n );\n }\n\n /**\n * Attaches a route to the request, such as `/product` or `/user`. Subsequent calls\n * to this method will append the route to the existing route, such as `/product/1`.\n *\n * Numbers will be converted to strings automatically. Routes can be defined one\n * at a time or as a spread argument.\n *\n * ```ts\n * constructor(http: HTTP) {\n * super(http);\n * this.http.sharedRoute(\"user\", id).get();\n * }\n *\n * // or\n *\n * constructor(http: HTTP) {\n * super(http);\n * this.http\n * .sharedRoute(\"user\")\n * .sharedRoute(id)\n * .get();\n * }\n * ```\n *\n * This method is a shared chain method, and will return the same instance of HTTP. All\n * child clients will inherit the routes defined by this method. Useful to configure\n * in the constructor body.\n *\n * @param route A route or spread list of routes to append to the request.\n * @returns This instance of HTTP.\n */\n sharedRoute(...route: (string | number | boolean)[]) {\n this.#request.route(...route.map((r) => r.toString()));\n return this;\n }\n\n /**\n * Attaches a route to the request, such as `/product` or `/user`. Subsequent calls\n * to this method will append the route to the existing route, such as `/product/1`.\n *\n * Numbers will be converted to strings automatically. Routes can be defined one\n * at a time or as a spread argument.\n *\n * ```ts\n * getUser(id: number) {\n * return this.http.route(\"user\", id).get();\n * }\n *\n * // or\n *\n * getUser(id: number) {\n * return this.http\n * .route(\"user\")\n * .route(id)\n * .get();\n * }\n * ```\n *\n * This method is a request chain method, and will return a new instance of HTTP, inheriting\n * any routes previously defined and appending the new route. Useful to configure\n * in class methods as part of finalizing a request.\n *\n * @param route A route or spread list of routes to append to the request.\n * @returns A new child instance of HTTP derived from this one.\n */\n route(...route: (string | number | boolean)[]) {\n const mapped = route.map((r) => String(r));\n return HTTP.create(this.client, this.#request.derive().route(...mapped));\n }\n\n /**\n * Attaches a shared schema mapping for all requests by this client. Schemas are\n * mapped to HTTP Status Codes, and if configured to be required the request will fail\n * if no schema is found matching that code.\n *\n * The status code mapping can be defined as a single code, a range of codes, or a spread list.\n *\n * ```ts\n * \\@Fixture(INJECTION_SCOPE.TRANSIENT)\n * export class UserController extends BaseController {\n * constructor(private readonly http: HTTP) {\n * super(http);\n * this.http\n * .sharedRoute(\"user\")\n * .sharedSchema(UserSchema, 200)\n * .sharedSchema(EmptySchema, 201, 204)\n * .sharedSchema(ErrorSchema, { from: 400, to: 499 });\n * }\n * }\n * ```\n *\n * This method is a shared chain method, and will return the same instance of HTTP. All\n * child clients will inherit the schemas defined by this method. Useful to configure\n * in the constructor body.\n *\n * @param parser The schema parser to use for this mapping.\n * @param codes A single status code, a range of status codes, or a spread list of status codes.\n * @returns This instance of HTTP.\n */\n sharedSchema(parser: SchemaParser, ...codes: StatusCode[]): HTTP;\n sharedSchema(\n parser: SchemaParser,\n ...range: { from: StatusCode; to: StatusCode }[]\n ): HTTP;\n sharedSchema(\n parser: SchemaParser,\n ...args: (StatusCode | { from: StatusCode; to: StatusCode })[]\n ): HTTP {\n this.#metaConfig.schema(parser, ...args);\n return this;\n }\n\n /**\n * Attaches a schema mapping for this request. Schemas are\n * mapped to HTTP Status Codes, and if configured to be required the request will fail\n * if no schema is found matching that code.\n *\n * The status code mapping can be defined as a single code, a range of codes, or a spread list.\n *\n * ```ts\n * \\@Fixture(INJECTION_SCOPE.TRANSIENT)\n * export class UserController extends BaseController {\n * constructor(private readonly http: HTTP) {\n * super(http);\n * this.http\n * .sharedRoute(\"user\")\n * .schema(ErrorSchema, { from: 400, to: 499 });\n * }\n *\n * getUser(id: number) {\n * return this.http.route(id).schema(UserSchema, 200).get();\n * }\n *\n * getUsers(...ids: number[]) {\n * return this.http\n * .route(\"users\")\n * .schema(UserSchema, { from: 200, to: 299 })\n * .schema(UserSchema, 200)\n * .get();\n * }\n * ```\n *\n * This method is a request chain method, and will return a new instance of HTTP, inheriting\n * any schemas previously defined and appending the new schema. Useful to configure\n * in class methods as part of finalizing a request.\n *\n * @param parser The schema parser to use for this mapping.\n * @param codes A single status code, a range of status codes, or a spread list of status codes.\n * @returns A new child instance of HTTP derived from this one.\n */\n schema(parser: SchemaParser, ...codes: StatusCode[]): HTTP;\n schema(\n parser: SchemaParser,\n ...range: { from: StatusCode; to: StatusCode }[]\n ): HTTP;\n schema(\n parser: SchemaParser,\n ...args: (StatusCode | { from: StatusCode; to: StatusCode })[]\n ): HTTP {\n return HTTP.create(\n this.client,\n this.#request.derive(),\n this.#metaConfig.derive().schema(parser, ...args)\n );\n }\n\n /**\n * Attaches a shared query string parameter to all requests by this client. Query string\n * parameters are key-value pairs which are appended to the request url, such as\n * `https://api.example.com?name=John&age=30`.\n *\n * This method is a shared chain method, and will return the same instance of HTTP. All\n * child clients will inherit the query string parameters defined by this method. Useful to configure\n * in the constructor body.\n *\n * @param name The name of the query string parameter.\n * @param value The value of the query string parameter.\n * @returns This instance of HTTP.\n */\n sharedParam(name: string, value: Record<string, unknown>): HTTP;\n sharedParam(name: string, ...value: (string | number | boolean)[]): HTTP;\n sharedParam(\n name: string,\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n value: any\n ): HTTP {\n this.#request.param(name, value);\n return this;\n }\n\n /**\n * `onSend` is a pre-request hook which will be executed in order of definition\n * immediately before the request is sent. This hook can be used to analyze or\n * log the request state.\n *\n * ```ts\n *\n * \\@Fixture(INJECTION_SCOPE.TRANSIENT)\n * export class UserController extends BaseController {\n * constructor(private readonly http: HTTP) {\n * super(http);\n * this.http\n * .sharedRoute(\"user\")\n * .sharedOnSend(\"log request\",\n * (request) => console.log(JSON.stringify(request, null, 2))\n * );\n * }\n * }\n * ```\n *\n * This method is a shared chain method, and will return the same instance of HTTP. All\n * child clients will inherit the onSend hooks defined by this method. Useful to configure\n * in the constructor body.\n *\n * @param description A description of the hook, used for debugging.\n * @param hook The hook to execute.\n * @returns This instance of HTTP.\n */\n sharedOnSend(description: string, hook: RequestHook) {\n this.#metaConfig.onBeforeSend(description, hook);\n return this;\n }\n\n /**\n * `onReceive` is a post-request hook which will be executed in order of definition\n * immediately after the response is received. This hook can be used to analyze or\n * log the response state.\n *\n * ```ts\n *\n * \\@Fixture(INJECTION_SCOPE.TRANSIENT)\n * export class UserController extends BaseController {\n * constructor(private readonly http: HTTP) {\n * super(http);\n * this.http\n * .sharedRoute(\"user\")\n * .sharedOnReceive(\"log response\",\n * (response) => console.log(JSON.stringify(response, null, 2))\n * );\n * }\n * }\n * ```\n *\n * This method is a shared chain method, and will return the same instance of HTTP. All\n * child clients will inherit the onReceive hooks defined by this method. Useful to configure\n * in the constructor body.\n *\n * @param description A description of the hook, used for debugging.\n * @param hook The hook to execute.\n * @returns This instance of HTTP.\n */\n sharedOnReceive(description: string, hook: ResponseHook<unknown>) {\n this.#metaConfig.onReceiveResponse(description, hook);\n return this;\n }\n\n /**\n * Attaches a query string parameter object to the request. Query string\n * parameters are key-value pairs which are appended to the request url, such as\n * `https://api.example.com?name=John&age=30`.\n *\n * This method is a shared chain method, and will return the same instance of HTTP. All\n * child clients will inherit the query string parameters defined by this method. Useful to configure\n * in the constructor body.\n *\n * ```ts\n * constructor(http: HTTP) {\n * super(http);\n * this.http\n * .sharedParams({ 'is-test': \"true\" })\n * ```\n * @param name The name of the query string parameter.\n * @param value The value of the query string parameter.\n * @returns This instance of HTTP.\n */\n sharedParams(dict: Record<string, unknown>) {\n this.#request.params(dict);\n return this;\n }\n\n /**\n * Attaches a query string parameter to the request. Query string\n * parameters are key-value pairs which are appended to the request url, such as\n * `https://api.example.com?name=John&age=30`.\n *\n * This method is a request chain method, and will return a new instance of HTTP, inheriting\n * any query string parameters previously defined and appending the new parameter. Useful to configure\n * in class methods as part of finalizing a request.\n *\n * ```ts\n * getUser(id: number) {\n * return this.http\n * .route(id)\n * .param(\"name\", \"John\")\n * .param(\"age\", 30)\n * ```\n *\n * Note: Numbers and Booleans will be converted to strings automatically.\n *\n * @param name The name of the query string parameter.\n * @param value The value of the query string parameter.\n * @returns A new child instance of HTTP derived from this one.\n */\n param(name: string, value: Record<string, unknown>): HTTP;\n param(name: string, ...value: (string | number | boolean)[]): HTTP;\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n param(name: string, value: any) {\n return HTTP.create(this.client, this.#request.derive().param(name, value));\n }\n\n /**\n * Attaches a query string parameter object to the request. Query string\n * parameters are key-value pairs which are appended to the request url, such as\n * `https://api.example.com?name=John&age=30`.\n *\n * This method is a shared chain method, and will return the same instance of HTTP. All\n * child clients will inherit the query string parameters defined by this method. Useful to configure\n * in the constructor body.\n *\n * ```ts\n * getUser(id: number) {\n * return this.http\n * .route(id)\n * .param({ name: \"John\", age: \"30\" })\n *\n * @param name The name of the query string parameter.\n * @param value The value of the query string parameter.\n * @returns This instance of HTTP.\n */\n params(dict: Record<string, string>) {\n this.#request.params(dict);\n return HTTP.create(this.client, this.#request.derive().params(dict));\n }\n\n /**\n * Attaches a shared data payload to this client. The data payload is the body of the request,\n * and can be any type. If the data payload is an object, it will be serialized to JSON.\n *\n * This method is a shared chain method, and will return the same instance of HTTP. All\n * child clients will inherit the data payload defined by this method. Useful to configure\n * in the constructor body.\n *\n * @param data The data payload to attach to the request.\n * @returns This instance of HTTP.\n */\n sharedData<T>(data: T) {\n this.#request.data(data);\n return this;\n }\n\n /**\n * Attaches a shared header to this client. Headers are string:string key-value pairs which are\n * sent with the request, such as `Content-Type: application/json`.\n *\n * Numbers, Booleans and Null will be converted to string values automatically.\n *\n * A Factory function can also be provided to generate the header value at the time of request.\n *\n * This method is a shared chain method, and will return the same instance of HTTP. All\n * child clients will inherit the header defined by this method. Useful to configure\n * in the constructor body.\n *\n * @param name The name of the header.\n * @param value The value of the header.\n */\n sharedHeader(\n name: string,\n value:\n | string\n | number\n | boolean\n | null\n | (string | number | boolean)[]\n | (() => string | number | boolean | null)\n | (() => Promise<string | number | boolean | null>)\n ) {\n this.#request.header(name, value);\n return this;\n }\n\n header(\n name: string,\n value:\n | string\n | number\n | boolean\n | null\n | (string | number | boolean)[]\n | (() => string | number | boolean | null)\n | (() => Promise<string | number | boolean | null>)\n ) {\n return HTTP.create(this.client, this.#request.derive().header(name, value));\n }\n\n /**\n * Attaches a data payload to this request. The data payload is the body of the request,\n * and can be any type. If the data payload is an object, it will be serialized to JSON.\n *\n * This method is a request chain method, and will return a new instance of HTTP, inheriting\n * any data payload previously defined and appending the new payload. Useful to configure\n * in class methods as part of finalizing a request.\n *\n * @param data The data payload to attach to the request.\n * @returns A new child instance of HTTP derived from this one.\n */\n data<T>(data: T) {\n this.#request.data(data);\n return HTTP.create(this.client, this.#request.derive().data(data));\n }\n\n /**\n * `onSend` is a pre-request hook which will be executed in order of definition\n * immediately before the request is sent. This hook can be used to modify the request,\n * or to log the state of a request before final send-off.\n *\n * ```ts\n *\n * \\@Fixture(INJECTION_SCOPE.TRANSIENT)\n * export class UserController extends BaseController {\n * constructor(private readonly http: HTTP) {\n * super(http);\n * }\n *\n * getUser(id: number) {\n * return this.http\n * .route(id)\n * .onSend(\"log request\",\n * (request) => console.log(JSON.stringify(request, null, 2)\n * )\n * .get();\n * }\n * ```\n *\n * This method is a request chain method, and will return a new instance of HTTP, inheriting\n * any onSend hooks previously defined and appending the new hook. Useful to configure\n * in class methods as part of finalizing a request.\n *\n * @param description A description of the hook, used for debugging.\n * @param hook The hook to execute.\n * @returns A new child instance of HTTP derived from this one.\n */\n onSend(description: string, hook: RequestHook) {\n return HTTP.create(\n this.client,\n this.#request.derive(),\n this.#metaConfig.derive().onBeforeSend(description, hook)\n );\n }\n\n /**\n * `onReceive` is a post-request hook which will be executed in order of definition\n * immediately after the response is received. This hook can be used to modify the response,\n * or to log the state of a response after it is received.\n *\n * ```ts\n *\n * \\@Fixture(INJECTION_SCOPE.TRANSIENT)\n * export class UserController extends BaseController {\n * constructor(private readonly http: HTTP) {\n * super(http);\n * }\n *\n * getUser(id: number) {\n * return this.http\n * .route(id)\n * .onReceive(\"log response\",\n * (response) => console.log(JSON.stringify(response, null, 2)\n * )\n * .get();\n * }\n * ```\n *\n * This method is a request chain method, and will return a new instance of HTTP, inheriting\n * any onReceive hooks previously defined and appending the new hook. Useful to configure\n * in class methods as part of finalizing a request.\n *\n * @param description A description of the hook, used for debugging.\n * @param hook The hook to execute.\n * @returns A new child instance of HTTP derived from this one.\n */\n onReceive(description: string, hook: ResponseHook<unknown>) {\n return HTTP.create(\n this.client,\n this.#request.derive(),\n this.#metaConfig.derive().onReceiveResponse(description, hook)\n );\n }\n\n /**\n * Executes the current request state as a GET request.\n *\n * @param options Additional options to pass to the underlying http client, such\n * as e.g Axios configuration values.\n * @returns A promise which resolves to the response.\n */\n get<TResponseType>(options?: HTTPAdditionalOptions<unknown>) {\n return this.#makeRequest(\n this.#request.derive().method(\"GET\"),\n options\n ) as Promise<HTTPResponse<TResponseType>>;\n }\n\n /**\n * Executes the current request state as a POST request.\n *\n * @param data The data payload to attach to the request.\n * @param options Additional options to pass to the underlying http client, such\n * as e.g Axios configuration values.\n * @returns A promise which resolves to the response.\n */\n post<TResponseType>(options?: HTTPAdditionalOptions<unknown>) {\n return this.#makeRequest(\n this.#request.derive().method(\"POST\"),\n options\n ) as Promise<HTTPResponse<TResponseType>>;\n }\n\n /**\n * Executes the current request state as a DELETE request.\n *\n * @param options Additional options to pass to the underlying http client, such\n * as e.g Axios configuration values.\n * @returns A promise which resolves to the response.\n * as e.g Axios configuration values.\n */\n delete<TResponseType>(options?: HTTPAdditionalOptions<unknown>) {\n return this.#makeRequest(\n this.#request.derive().method(\"DELETE\"),\n options\n ) as Promise<HTTPResponse<TResponseType>>;\n }\n\n /**\n * Executes the current request state as a PUT request.\n *\n * @param options Additional options to pass to the underlying http client, such\n * as e.g Axios configuration values.\n * @returns A promise which resolves to the response.\n */\n put<TResponseType>(options?: HTTPAdditionalOptions<unknown>) {\n return this.#makeRequest(\n this.#request.derive().method(\"PUT\"),\n options\n ) as Promise<HTTPResponse<TResponseType>>;\n }\n /**\n * Executes the current request state as a PATCH request.\n *\n * @param options Additional options to pass to the underlying http client, such\n * as e.g Axios configuration values.\n * @returns A promise which resolves to the response.\n */\n patch<TResponseType>(options?: HTTPAdditionalOptions<unknown>) {\n return this.#makeRequest(\n this.#request.derive().method(\"PATCH\"),\n options\n ) as Promise<HTTPResponse<TResponseType>>;\n }\n\n head<TResponseType>(options?: HTTPAdditionalOptions<unknown>) {\n return this.#makeRequest(\n this.#request.derive().method(\"HEAD\"),\n options\n ) as Promise<HTTPResponse<TResponseType>>;\n }\n\n options<TResponseType>(options?: HTTPAdditionalOptions<unknown>) {\n return this.#makeRequest(\n this.#request.derive().method(\"OPTIONS\"),\n options\n ) as Promise<HTTPResponse<TResponseType>>;\n }\n\n trace<TResponseType>(options?: HTTPAdditionalOptions<unknown>) {\n return this.#makeRequest(\n this.#request.derive().method(\"TRACE\"),\n options\n ) as Promise<HTTPResponse<TResponseType>>;\n }\n\n connect<TResponseType>(options?: HTTPAdditionalOptions<unknown>) {\n return this.#makeRequest(\n this.#request.derive().method(\"CONNECT\"),\n options\n ) as Promise<HTTPResponse<TResponseType>>;\n }\n\n async #makeRequest(\n builder: HTTPRequestBuilder<HTTPRequest<unknown>>,\n options?: HTTPAdditionalOptions<unknown>\n ) {\n const request = (await builder.resolveDynamicHeaders()).build();\n const meta = this.#metaConfig.derive().build();\n await this.runOnSendHooks(meta, request);\n const result = await this.client.request<unknown, string>(request, options);\n result.data = transformResponse(meta.allowPlainText, result.data);\n await this.runOnReceiveHooks(meta, result);\n const validated = this.#validateResponse(result, meta);\n return validated;\n }\n\n private async runOnSendHooks(\n meta: MetaConfig,\n request: HTTPRequest<unknown>\n ) {\n for (const [description, hook] of meta.onSend) {\n try {\n await hook(request);\n } catch (e) {\n const cause = e as Error;\n const msg = `An error occurred while sending a request in hook: '${description}'`;\n throw new AutomationError(msg, { cause });\n }\n }\n }\n private async runOnReceiveHooks(\n meta: MetaConfig,\n response: HTTPResponse<unknown>\n ) {\n for (const [description, hook] of meta.onReceive) {\n try {\n await hook(response);\n } catch (e) {\n const cause = e as Error;\n const msg = `An error occurred while receiving a response in hook: '${description}'`;\n throw new AutomationError(msg, { cause });\n }\n }\n }\n\n #validateResponse<T>(\n response: HTTPResponse<unknown>,\n meta: MetaConfig\n ): HTTPResponse<T> {\n const { status, data } = response;\n const validated = meta.schemas.validate(\n status,\n data,\n meta.requireSchema\n ) as T;\n response.data = validated;\n return response as HTTPResponse<T>;\n }\n}\n","import { Class } from \"@autometa/types\";\nimport { defaultClient, type HTTPClient } from \"./http-client\";\n\nexport function defaultClientFactory() {\n const type = defaultClient as Class<HTTPClient>;\n return new type();\n}\n","import { RequestConfig, RequestConfigBasic } from \"./request.config\";\nimport { HTTPMethod } from \"./types\";\nimport { urlJoinP } from \"url-join-ts\";\nexport class HTTPRequest<T = unknown> implements RequestConfig<T> {\n headers: Record<string, string> = {};\n params: Record<string, string | string[] | Record<string, unknown>> = {};\n baseUrl?: string;\n route: string[] = [];\n method: HTTPMethod;\n data: T;\n\n constructor(config?: RequestConfigBasic) {\n Object.assign(this, config);\n }\n\n /**\n * Returns the full URL of the request, including the base url,\n * routes, and query parameters.\n *\n * ```ts\n * console.log(request.fullUrl())// https://example.com/foo?bar=baz?array=1,2,3\n * ```\n *\n * Note characters may be converted to escape codes. I.e (space => %20) and (comma => %2C)\n *\n * N.B this getter estimates what the url will be. The actual value\n * might be different depending on your underlying HTTPClient and\n * configuration. For example, query parameters might\n * use different array formats.\n */\n get fullUrl() {\n return urlJoinP(this.baseUrl, this.route, this.params);\n }\n\n /**\n * Returns a new independent copy of the request.\n */\n static derive(original: HTTPRequest<unknown>) {\n const request = new HTTPRequest();\n request.headers = { ...original.headers };\n request.params = { ...original.params };\n request.baseUrl = original.baseUrl;\n request.route = [...original.route];\n request.method = original.method;\n request.data = original.data;\n return request;\n }\n}\n\nexport class HTTPRequestBuilder<T extends HTTPRequest<unknown>> {\n #request: T;\n #dynamicHeaders = new Map<\n string,\n | (() => string | number | boolean | null)\n | (() => Promise<string | number | boolean | null>)\n >();\n\n constructor(request: T | (() => T) = () => new HTTPRequest() as T) {\n if (typeof request === \"function\") {\n this.#request = request();\n return;\n }\n this.#request = request;\n }\n\n static create<T extends HTTPRequest<unknown>>() {\n return new HTTPRequestBuilder<T>();\n }\n\n get request() {\n return this.#request;\n }\n\n async resolveDynamicHeaders(\n request: HTTPRequest<T> = this.#request as HTTPRequest<T>\n ) {\n for (const [name, value] of this.#dynamicHeaders) {\n try {\n if (!request.headers) request.headers = {};\n request.headers[name] = String(await value());\n } catch (e) {\n const cause = e as Error;\n const msg = `Failed to resolve dynamic header \"${name}\": \n${cause}`;\n throw new Error(msg);\n }\n }\n return this;\n }\n\n url(url: string) {\n this.#request.baseUrl = url;\n return this;\n }\n\n route(...route: string[]) {\n this.#request.route.push(...route);\n return this;\n }\n\n param(\n name: string,\n value:\n | string\n | number\n | boolean\n | (string | number | boolean)[]\n | Record<string, string | number | boolean>\n ) {\n if (Array.isArray(value)) {\n const asStr = value.map(String);\n this.#request.params[name] = asStr;\n return this;\n }\n if (!Array.isArray(value) && typeof value === \"object\") {\n this.#request.params[name] = value;\n return this;\n }\n this.#request.params[name] = String(value);\n return this;\n }\n\n params(dict: Record<string, unknown>) {\n Object.assign(this.#request.params, dict);\n return this;\n }\n\n data<T>(data: T) {\n this.#request.data = data;\n return this;\n }\n\n header(\n name: string,\n value:\n | string\n | number\n | boolean\n | null\n | (string | number | boolean)[]\n | (() => string | number | boolean | null)\n | (() => Promise<string | number | boolean | null>),\n onArray: (value: (string | number | boolean)[]) => string = (value) =>\n value.join(\",\")\n ) {\n if (typeof value === \"function\") {\n this.#dynamicHeaders.set(name, value);\n return this;\n }\n const val = Array.isArray(value) ? onArray(value) : String(value);\n this.#request.headers[name] = val;\n return this;\n }\n\n headers(dict: Record<string, string>) {\n Object.assign(this.#request.headers, dict);\n return this;\n }\n\n get() {\n return this.#request;\n }\n\n method(method: HTTPMethod) {\n this.#request.method = method;\n return this;\n }\n\n #setDynamicHeaders(\n headers: Map<\n string,\n | (() => string | number | boolean | null)\n | (() => Promise<string | number | boolean | null>)\n >\n ) {\n this.#dynamicHeaders = new Map(headers);\n return this;\n }\n\n derive(): HTTPRequestBuilder<T> {\n const request = HTTPRequest.derive(this.#request);\n return new HTTPRequestBuilder(request).#setDynamicHeaders(\n this.#dynamicHeaders\n ) as HTTPRequestBuilder<T>;\n }\n\n build(): HTTPRequest<T> {\n return this.#request as HTTPRequest<T>;\n }\n\n async buildAsync(): Promise<HTTPRequest<T>> {\n await this.resolveDynamicHeaders();\n return this.#request as HTTPRequest<T>;\n }\n}\n","import { SchemaParser, StatusCode } from \"./types\";\nexport class SchemaMap {\n #map: Map<StatusCode, SchemaParser>;\n constructor(map?: Map<StatusCode, SchemaParser> | SchemaMap) {\n if (map instanceof SchemaMap) {\n this.#map = new Map(map.#map);\n return;\n }\n this.#map = new Map(map);\n }\n\n derive() {\n return new SchemaMap(this.#map);\n }\n\n registerStatus(parser: SchemaParser, ...codes: StatusCode[]) {\n codes.forEach((code) => {\n if (this.#map.has(code)) {\n const msg = `Status code ${code} is already registered with a parser`;\n throw new Error(msg);\n }\n this.#map.set(code, parser);\n });\n }\n\n registerRange(parser: SchemaParser, from: StatusCode, to: StatusCode) {\n for (let i = from; i <= to; i++) {\n if (this.#map.has(i)) {\n throw new Error(`Status code ${i} is already registered with a parser`);\n }\n this.#map.set(i, parser);\n }\n }\n\n validate(status: StatusCode, data: unknown, requireSchema: boolean) {\n const parser = this.getParser(status, requireSchema);\n if (\"parse\" in parser) {\n return parser.parse(data);\n }\n if('validate' in parser) {\n return parser.validate(data);\n }\n try {\n return parser(data);\n } catch (e) {\n const msg = `Failed to schema parse response data for status code ${status} with data:\n \n${JSON.stringify(data, null, 2)}}`;\n throw new Error(msg);\n }\n }\n\n getParser(status: StatusCode, requireSchema: boolean) {\n const parser = this.#map.get(status);\n if (!parser && requireSchema) {\n const msg = `No parser registered for status code ${status} but 'requireSchema' is true`;\n throw new Error(msg);\n }\n if (parser) {\n return parser;\n }\n return (data: unknown) => data;\n }\n\n toObject() {\n return Object.fromEntries(this.#map) as Record<StatusCode, SchemaParser>;\n }\n}\n","import { SchemaMap } from \"./schema.map\";\nimport { RequestHook, ResponseHook, SchemaParser, StatusCode } from \"./types\";\n\nexport interface SchemaConfig {\n schemas: SchemaMap;\n requireSchema: boolean;\n allowPlainText: boolean;\n}\n\nexport interface HTTPHooks {\n onSend: [string, RequestHook][];\n onReceive: [string, ResponseHook<unknown>][];\n}\n\n// export type MetaConfig = SchemaConfig & HTTPHooks;\n\nexport class MetaConfig implements SchemaConfig, HTTPHooks {\n schemas: SchemaMap;\n requireSchema: boolean;\n allowPlainText: boolean;\n onSend: [string, RequestHook][] = [];\n onReceive: [string, ResponseHook<unknown>][] = [];\n throwOnServerError: boolean;\n}\n\nexport class MetaConfigBuilder {\n #schemaMap = new SchemaMap();\n #requireSchema = false;\n #allowPlainText = false;\n #onBeforeSend: [string, RequestHook][] = [];\n #onAfterSend: [string, ResponseHook<unknown>][] = [];\n #throwOnServerError = false;\n\n schemaMap(map: SchemaMap) {\n this.#schemaMap = map;\n return this;\n }\n\n schema(parser: SchemaParser, ...codes: StatusCode[]): MetaConfigBuilder;\n schema(\n parser: SchemaParser,\n ...range: { from: StatusCode; to: StatusCode }[]\n ): MetaConfigBuilder;\n schema(\n parser: SchemaParser,\n ...args: (StatusCode | { from: StatusCode; to: StatusCode })[]\n ): MetaConfigBuilder;\n schema(\n parser: SchemaParser,\n ...args: (StatusCode | { from: StatusCode; to: StatusCode })[]\n ) {\n args.forEach((arg) => {\n if (typeof arg === \"number\") {\n this.#schemaMap.registerStatus(parser, arg);\n } else {\n this.#schemaMap.registerRange(parser, arg.from, arg.to);\n }\n });\n\n return this;\n }\n\n requireSchema(value: boolean) {\n this.#requireSchema = value;\n return this;\n }\n\n allowPlainText(value: boolean) {\n this.#allowPlainText = value;\n return this;\n }\n\n onBeforeSend(description: string, hook: RequestHook) {\n this.#onBeforeSend.push([description, hook]);\n return this;\n }\n\n #setOnSend(hooks: [string, RequestHook][]) {\n this.#onBeforeSend = hooks;\n return this;\n }\n\n throwOnServerError(value: boolean) {\n this.#throwOnServerError = value;\n return this;\n }\n\n onReceiveResponse(description: string, hook: ResponseHook<unknown>) {\n this.#onAfterSend.push([description, hook]);\n return this;\n }\n\n #setOnReceive(hooks: [string, ResponseHook<unknown>][]) {\n this.#onAfterSend = hooks;\n return this;\n }\n\n build() {\n const config = new MetaConfig();\n config.schemas = this.#schemaMap.derive();\n config.requireSchema = this.#requireSchema;\n config.allowPlainText = this.#allowPlainText;\n config.onSend = this.#onBeforeSend;\n config.onReceive = this.#onAfterSend;\n return config;\n }\n\n derive() {\n return new MetaConfigBuilder()\n .schemaMap(this.#schemaMap.derive())\n .requireSchema(this.#requireSchema)\n .allowPlainText(this.#allowPlainText)\n .throwOnServerError(this.#throwOnServerError)\n .#setOnSend(this.#onBeforeSend)\n .#setOnReceive(this.#onAfterSend);\n }\n}\n","import { AutomationError } from \"@autometa/errors\";\nimport isJson from \"@stdlib/assert-is-json\";\nimport { highlight } from \"cli-highlight\";\n\nexport function transformResponse(\n allowPlainText: boolean,\n data: null | undefined | string\n) {\n if (data === null) {\n return null;\n }\n if (data === undefined) {\n return undefined;\n }\n if (data === \"\") {\n return data;\n }\n if (isJson(data)) {\n return JSON.parse(data);\n }\n if (typeof data === \"string\" && [\"true\", \"false\"].includes(data)) {\n return JSON.parse(data);\n }\n if (typeof data === \"string\" && /^\\d*\\.?\\d+$/.test(data)) {\n return JSON.parse(data);\n }\n\n if (typeof data === \"object\") {\n return data;\n }\n if (allowPlainText) {\n return data;\n }\n\n const response = highlight(data, { language: \"html\" });\n const message = [\n `Could not parse a response as json, and this request was not configured to allow plain text responses.`,\n `To allow plain text responses, use the 'allowPlainText' method on the HTTP client.`,\n \"\",\n response\n ];\n throw new AutomationError(message.join(\"\\n\"));\n}\n","import isJson from \"@stdlib/assert-is-json\";\n\n/**\n * Schema which does not care about data validation.\n *\n * Useful if `requireSchema` is set to true, but a specific\n * endpoints response does not matter.\n * @param data\n * @returns\n */\nexport function AnySchema(data: unknown) {\n return data;\n}\n\n/**\n * Schema which validates that a response is empty. This can mean\n * the data payload was `null`, `undefined` or the string `'null'`.\n *\n * Useful if `requireSchema` is set to true, but a specific\n * endpoints response should be null or not defined.\n * @param data\n * @returns\n */\nexport function EmptySchema(data: unknown) {\n if (data !== null && data !== undefined && data !== \"null\") {\n throw new Error(`Expected null but got <${typeof data}> for ${data}`);\n }\n return data === \"null\" ? null : data;\n}\n\n/**\n * Schema which validates a response was null.\n *\n * Useful if `requireSchema` is set to true, but a specific\n * endpoints response should be null.\n * @param data\n * @returns\n */\nexport function NullSchema(data: unknown) {\n if (data !== null && data !== \"null\") {\n throw new Error(`Expected null but got <${typeof data}> for ${data}`);\n }\n return null;\n}\n\n/**\n * Schema which validates a response was undefined.\n *\n * Useful if `requireSchema` is set to true, but a specific\n * endpoints response should be undefined.\n *\n * @param data\n * @returns\n */\nexport function UndefinedSchema(data: unknown) {\n if (data !== undefined) {\n throw new Error(`Expected undefined but got <${typeof data}> for ${data}`);\n }\n return undefined;\n}\n\n/**\n * Schema which validates a response was a boolean, or a string of value\n * `'true'` or `'false'`.\n *\n * Useful if `requireSchema` is set to true, but a specific\n * endpoints response should be a boolean.\n *\n * @param data\n * @returns\n */\nexport function BooleanSchema(data: unknown) {\n if (\n !(typeof data === \"boolean\") &&\n [\"true\", \"false\"].includes(String(data)) === false\n ) {\n throw new Error(`Expected boolean but got <${typeof data}> for ${data}`);\n }\n return JSON.parse(data as string);\n}\n\n/**\n * Schema which validates a response was a number, or a string of value\n * of a number.\n *\n * Useful if `requireSchema` is set to true, but a specific\n * endpoints response should be a number.\n *\n * @param data\n * @returns\n */\nexport function NumberSchema(data: unknown) {\n if (\n !(typeof data === \"number\") &&\n /^\\d*\\.?\\d+$/.test(String(data)) === false\n ) {\n throw new Error(`Expected number but got <${typeof data}> for ${data}`);\n }\n return JSON.parse(data as string);\n}\n\n/**\n * Schema which validates a response was a string.\n *\n * Useful if `requireSchema` is set to true, but a specific\n * endpoints response should be a string.\n *\n * @param data\n * @returns\n */\nexport function StringSchema(data: unknown) {\n if (typeof data !== \"string\") {\n throw new Error(`Expected string but got <${typeof data}> for ${data}`);\n }\n return data;\n}\n\n\nexport function JSONSchema<T = unknown>(data: unknown) {\n if(typeof data === 'object') {\n return data as T;\n }\n if (!isJson(data)) {\n throw new Error(`Expected JSON but got <${typeof data}> for ${data}`);\n }\n const result = JSON.parse(data);\n return result;\n}"],"mappings":"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","names":["axios","value","isJson","import_errors","_request","import_assert_is_json","isJson"]}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@autometa/http",
|
|
3
|
-
"version": "1.4.
|
|
3
|
+
"version": "1.4.7",
|
|
4
4
|
"description": "An Axios Based HTTP Client for Autometa",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
@@ -31,7 +31,7 @@
|
|
|
31
31
|
},
|
|
32
32
|
"dependencies": {
|
|
33
33
|
"@autometa/app": "^0.3.2",
|
|
34
|
-
"@autometa/dto-builder": "^0.13.
|
|
34
|
+
"@autometa/dto-builder": "^0.13.6",
|
|
35
35
|
"@autometa/errors": "^0.2.2",
|
|
36
36
|
"@autometa/injection": "^0.1.1",
|
|
37
37
|
"@autometa/status-codes": "^0.4.1",
|
package/src/http-request.ts
CHANGED
|
@@ -71,10 +71,13 @@ export class HTTPRequestBuilder<T extends HTTPRequest<unknown>> {
|
|
|
71
71
|
return this.#request;
|
|
72
72
|
}
|
|
73
73
|
|
|
74
|
-
async resolveDynamicHeaders(
|
|
74
|
+
async resolveDynamicHeaders(
|
|
75
|
+
request: HTTPRequest<T> = this.#request as HTTPRequest<T>
|
|
76
|
+
) {
|
|
75
77
|
for (const [name, value] of this.#dynamicHeaders) {
|
|
76
78
|
try {
|
|
77
|
-
|
|
79
|
+
if (!request.headers) request.headers = {};
|
|
80
|
+
request.headers[name] = String(await value());
|
|
78
81
|
} catch (e) {
|
|
79
82
|
const cause = e as Error;
|
|
80
83
|
const msg = `Failed to resolve dynamic header "${name}":
|
|
@@ -136,12 +139,15 @@ ${cause}`;
|
|
|
136
139
|
| null
|
|
137
140
|
| (string | number | boolean)[]
|
|
138
141
|
| (() => string | number | boolean | null)
|
|
139
|
-
| (() => Promise<string | number | boolean | null>)
|
|
142
|
+
| (() => Promise<string | number | boolean | null>),
|
|
143
|
+
onArray: (value: (string | number | boolean)[]) => string = (value) =>
|
|
144
|
+
value.join(",")
|
|
140
145
|
) {
|
|
141
146
|
if (typeof value === "function") {
|
|
142
147
|
this.#dynamicHeaders.set(name, value);
|
|
148
|
+
return this;
|
|
143
149
|
}
|
|
144
|
-
const val = Array.isArray(value) ? value
|
|
150
|
+
const val = Array.isArray(value) ? onArray(value) : String(value);
|
|
145
151
|
this.#request.headers[name] = val;
|
|
146
152
|
return this;
|
|
147
153
|
}
|
|
@@ -160,12 +166,30 @@ ${cause}`;
|
|
|
160
166
|
return this;
|
|
161
167
|
}
|
|
162
168
|
|
|
169
|
+
#setDynamicHeaders(
|
|
170
|
+
headers: Map<
|
|
171
|
+
string,
|
|
172
|
+
| (() => string | number | boolean | null)
|
|
173
|
+
| (() => Promise<string | number | boolean | null>)
|
|
174
|
+
>
|
|
175
|
+
) {
|
|
176
|
+
this.#dynamicHeaders = new Map(headers);
|
|
177
|
+
return this;
|
|
178
|
+
}
|
|
179
|
+
|
|
163
180
|
derive(): HTTPRequestBuilder<T> {
|
|
164
181
|
const request = HTTPRequest.derive(this.#request);
|
|
165
|
-
return new HTTPRequestBuilder(request)
|
|
182
|
+
return new HTTPRequestBuilder(request).#setDynamicHeaders(
|
|
183
|
+
this.#dynamicHeaders
|
|
184
|
+
) as HTTPRequestBuilder<T>;
|
|
166
185
|
}
|
|
167
186
|
|
|
168
187
|
build(): HTTPRequest<T> {
|
|
169
188
|
return this.#request as HTTPRequest<T>;
|
|
170
189
|
}
|
|
190
|
+
|
|
191
|
+
async buildAsync(): Promise<HTTPRequest<T>> {
|
|
192
|
+
await this.resolveDynamicHeaders();
|
|
193
|
+
return this.#request as HTTPRequest<T>;
|
|
194
|
+
}
|
|
171
195
|
}
|
package/src/http.spec.ts
CHANGED
|
@@ -20,13 +20,33 @@ describe("HTTP", () => {
|
|
|
20
20
|
request: HTTPRequest<TRequestType>,
|
|
21
21
|
options?: HTTPAdditionalOptions<unknown> | undefined
|
|
22
22
|
): Promise<HTTPResponse<TResponseType>> {
|
|
23
|
+
console.log(request);
|
|
24
|
+
|
|
23
25
|
return this.testFn(request, options) as HTTPResponse<TResponseType>;
|
|
24
26
|
}
|
|
25
27
|
}
|
|
28
|
+
|
|
29
|
+
describe("resolving dynamic headers", () => {
|
|
30
|
+
it("should resolve dynamic headers", async () => {
|
|
31
|
+
const response = HTTPResponseBuilder.create().status(200).build();
|
|
32
|
+
const request = HTTPRequestBuilder.create()
|
|
33
|
+
const fn = vi.fn().mockImplementation((req: HTTPRequest)=>{
|
|
34
|
+
response.request = req;
|
|
35
|
+
return response;
|
|
36
|
+
});
|
|
37
|
+
const client = new MockClient(fn);
|
|
38
|
+
const http = new HTTP(client, request).sharedHeader("foo", () => "bar");
|
|
39
|
+
const result = await http.get();
|
|
40
|
+
expect(result.request.headers["foo"]).toBe("bar");
|
|
41
|
+
});
|
|
42
|
+
});
|
|
26
43
|
describe("allowPlainText", () => {
|
|
27
44
|
it("should throw an error when allowPlainText is false", async () => {
|
|
28
45
|
const response = HTTPResponseBuilder.create().data("Hello World").build();
|
|
29
|
-
const fn = vi.fn().
|
|
46
|
+
const fn = vi.fn().mockImplementation((req: HTTPRequest)=>{
|
|
47
|
+
response.request = req;
|
|
48
|
+
return response;
|
|
49
|
+
})
|
|
30
50
|
const client = new MockClient(fn);
|
|
31
51
|
const http = new HTTP(client).allowPlainText(false);
|
|
32
52
|
await expect(() => http.get()).rejects.toThrowError(
|
package/src/http.ts
CHANGED