@hkdigital/lib-sveltekit 0.0.66 → 0.0.68

package/dist/constants/http/headers.d.ts

@@ -1,4 +1,5 @@
 export const ACCEPT: "accept";
 export const CONTENT_TYPE: "content-type";
+export const CONTENT_LENGTH: "content-length";
 export const AUTHORIZATION: "authorization";
 export const WWW_AUTHENTICATE: "www-authenticate";

package/dist/constants/http/headers.js

@@ -1,5 +1,6 @@
 export const ACCEPT = 'accept';
 export const CONTENT_TYPE = 'content-type';
-export const AUTHORIZATION = 'authorization';
+export const CONTENT_LENGTH = 'content-length';
 
+export const AUTHORIZATION = 'authorization';
 export const WWW_AUTHENTICATE = 'www-authenticate';

package/dist/util/http/http-request.d.ts

@@ -1,3 +1,9 @@
+/**
+ * @callback requestHandler
+ * @param {AbortController} controller
+ * @param {( reason?: Error ) => void} abort
+ * @param {( delayMs: number) => void} timeout
+ */
 /**
  * Make GET request
  *
@@ -13,8 +19,7 @@
  *
  *   e.g. options.headers = { "content-type": "application/json" }
  *
- * @param {function} [_.requestHandler]
- *   If defined, this function will receive the abort handler function
+ * @param {requestHandler} [_.requestHandler]
  *
  * @param {number} [_.timeoutMs]
  *   If defined, this request will abort after the specified number of
@@ -37,8 +42,7 @@ export function httpGet({ url, urlSearchParams, headers, requestHandler, timeout
  *
  *   e.g. options.headers = { "content-type": "application/json" }
  *
- * @param {function} [_.requestHandler]
- *   If defined, this function will receive the abort handler function
+ * @param {requestHandler} [_.requestHandler]
  *
  * @param {number} [_.timeoutMs]
  *   If defined, this request will abort after the specified number of
@@ -67,8 +71,7 @@ export function httpPost({ url, body, headers, requestHandler, timeoutMs }: stri
  *
  *   e.g. options.headers = { "content-type": "application/json" }
  *
- * @param {( { controller: AbortController, abort: ( reason?: Error ) => void, timeout: number } )=> void} [_.requestHandler]
- *   If defined, this function will receive the abort handler function
+ * @param {requestHandler} [_.requestHandler]
  *
  * @param {number} [_.timeoutMs]
  *   If defined, this request will abort after the specified number of
@@ -82,3 +85,12 @@ export function httpPost({ url, body, headers, requestHandler, timeoutMs }: stri
  * @returns {Promise<*>} responsePromise
  */
 export function httpRequest({ method, url, urlSearchParams, body, headers, requestHandler, timeoutMs }: string | URL): Promise<any>;
+/**
+ * Get the response size from the content-length response header
+ *
+ * @param {Response} response
+ *
+ * @returns {number} response size or 0 if unknown
+ */
+export function getResponseSize(response: Response): number;
+export type requestHandler = (controller: AbortController, abort: (reason?: Error) => void, timeout: (delayMs: number) => void) => any;

package/dist/util/http/http-request.js

@@ -1,7 +1,7 @@
 import { METHOD_GET, METHOD_POST } from '../../constants/http/methods.js';
 
 import { APPLICATION_JSON } from '../../constants/mime/application.js';
-import { CONTENT_TYPE } from '../../constants/http/headers.js';
+import { CONTENT_TYPE, CONTENT_LENGTH } from '../../constants/http/headers.js';
 
 import { AbortError, TimeoutError } from '../../constants/errors/api.js';
 
@@ -11,6 +11,13 @@ import { toURL } from './url.js';
 import { setRequestHeaders } from './headers.js';
 import { waitForAndCheckResponse } from './response.js';
 
+/**
+ * @callback requestHandler
+ * @param {AbortController} controller
+ * @param {( reason?: Error ) => void} abort
+ * @param {( delayMs: number) => void} timeout
+ */
+
 /**
  * Make GET request
  *
@@ -26,8 +33,7 @@ import { waitForAndCheckResponse } from './response.js';
  *
  *   e.g. options.headers = { "content-type": "application/json" }
  *
- * @param {function} [_.requestHandler]
- *   If defined, this function will receive the abort handler function
+ * @param {requestHandler} [_.requestHandler]
  *
  * @param {number} [_.timeoutMs]
  *   If defined, this request will abort after the specified number of
@@ -62,8 +68,7 @@ export async function httpGet({ url, urlSearchParams, headers, requestHandler, t
  *
  *   e.g. options.headers = { "content-type": "application/json" }
  *
- * @param {function} [_.requestHandler]
- *   If defined, this function will receive the abort handler function
+ * @param {requestHandler} [_.requestHandler]
  *
  * @param {number} [_.timeoutMs]
  *   If defined, this request will abort after the specified number of
@@ -106,8 +111,7 @@ export async function httpPost({ url, body = null, headers, requestHandler, time
  *
  *   e.g. options.headers = { "content-type": "application/json" }
  *
- * @param {( { controller: AbortController, abort: ( reason?: Error ) => void, timeout: number } )=> void} [_.requestHandler]
- *   If defined, this function will receive the abort handler function
+ * @param {requestHandler} [_.requestHandler]
  *
  * @param {number} [_.timeoutMs]
  *   If defined, this request will abort after the specified number of
@@ -261,5 +265,23 @@ export async function httpRequest({
 		}
 	}
 
+	// response promise
 	return promise;
 }
+
+/**
+ * Get the response size from the content-length response header
+ *
+ * @param {Response} response
+ *
+ * @returns {number} response size or 0 if unknown
+ */
+export function getResponseSize(response) {
+	const sizeStr = response.headers.get(CONTENT_LENGTH);
+
+	if (!sizeStr) {
+		return 0;
+	}
+
+	return parseInt(sizeStr, 10);
+}

package/dist/util/http/response.js

@@ -3,7 +3,7 @@ import * as expect from '../expect/index.js';
 
 import { WWW_AUTHENTICATE } from '../../constants/http/headers.js';
 
-import { toURL } from './url.js';
+import { href } from './url.js';
 
 import { getErrorFromResponse } from './errors.js';
 
@@ -19,8 +19,6 @@ import { getErrorFromResponse } from './errors.js';
 export async function expectResponseOk(response, url) {
 	expect.object(response);
 
-	url = toURL(url);
-
 	// https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/200
 	// https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/201
 
@@ -28,7 +26,7 @@ export async function expectResponseOk(response, url) {
 		if (!response.ok) {
 			throw new ResponseError(
 				`Server returned - ${response.status} ${response.statusText} ` +
-					`[response.ok=false] [url=${decodeURI(url.href)}]`
+					`[response.ok=false] [url=${href(url)}]`
 			);
 		}
 
@@ -49,7 +47,7 @@ export async function expectResponseOk(response, url) {
 			errorMessage += ` (${authValue})`;
 		}
 
-		errorMessage += ` [url=${decodeURI(url.href)}]`;
+		errorMessage += ` [url=${href(url)}]`;
 
 		throw new Error(errorMessage);
 	}
@@ -59,7 +57,7 @@ export async function expectResponseOk(response, url) {
 	const error = await getErrorFromResponse(response);
 
 	throw new ResponseError(
-		`Server returned - ${response.status} ${response.statusText} ` + `[url=${decodeURI(url.href)}]`,
+		`Server returned - ${response.status} ${response.statusText} ` + `[url=${href(url)}]`,
 		{ cause: error }
 	);
 }
@@ -80,8 +78,6 @@ export async function expectResponseOk(response, url) {
 export async function waitForAndCheckResponse(responsePromise, url) {
 	expect.promise(responsePromise);
 
-	url = toURL(url);
-
 	let response;
 
 	try {
@@ -93,7 +89,7 @@ export async function waitForAndCheckResponse(responsePromise, url) {
 		}
 	} catch (e) {
 		if (e instanceof TypeError || response?.ok === false) {
-			throw new ResponseError(`A network error occurred for request [${decodeURI(url.href)}]`, {
+			throw new ResponseError(`A network error occurred for request [${href(url)}]`, {
 				cause: e
 			});
 		} else {

package/dist/util/http/url.d.ts

@@ -1,8 +1,25 @@
 /**
- * Ensure to return an URL instance
+ * Returns an URL instance
+ * - Prefixes the URL with the current orign if the url is relative
  *
  * @param {string|URL} url
  *
  * @returns {URL} url instance
  */
 export function toURL(url: string | URL): URL;
+/**
+ * Checks if the url starts with a protocol specification such
+ * as https://
+ *
+ * @param {string} url
+ *
+ * @return {boolean} true if the value looks like an array
+ */
+export function hasProtocol(url: string): boolean;
+/**
+ * Convert an url to an absolute url and apply decodeURI to
+ * convert URI encoded characters to normal characters
+ *
+ * @param {string} url
+ */
+export function href(url: string): string;

package/dist/util/http/url.js

@@ -1,7 +1,8 @@
 import { TypeOrValueError } from '../../constants/errors/index.js';
 
 /**
- * Ensure to return an URL instance
+ * Returns an URL instance
+ * - Prefixes the URL with the current orign if the url is relative
  *
  * @param {string|URL} url
  *
@@ -9,7 +10,12 @@ import { TypeOrValueError } from '../../constants/errors/index.js';
  */
 export function toURL(url) {
 	if (typeof url === 'string') {
-		return new URL(url);
+		if (hasProtocol(url)) {
+			return new URL(url);
+		} else {
+			// Use location.origin aas baseUrl
+			return new URL(url, location.origin);
+		}
 	} else if (!(url instanceof URL)) {
 		throw new TypeOrValueError('Missing or invalid parameter [url]');
 	}
@@ -17,3 +23,30 @@ export function toURL(url) {
 	// already an URL instance
 	return url;
 }
+
+/**
+ * Checks if the url starts with a protocol specification such
+ * as https://
+ *
+ * @param {string} url
+ *
+ * @return {boolean} true if the value looks like an array
+ */
+export function hasProtocol(url) {
+	if (/^([a-zA-Z]{2,})s?:\/\//.test(url)) {
+		return true;
+	}
+
+	return false;
+}
+
+/**
+ * Convert an url to an absolute url and apply decodeURI to
+ * convert URI encoded characters to normal characters
+ *
+ * @param {string} url
+ */
+export function href(url) {
+	const urlObj = toURL(url);
+	return decodeURI(urlObj.href);
+}

package/dist/util/is/index.d.ts

@@ -1,3 +1,4 @@
+/** Exports */
 /**
  * Check if a value looks like an array
  *

package/dist/util/is/index.js

@@ -1,4 +1,4 @@
-/* ---------------------------------------------------------------- Internals */
+/** Internals */
 
 //
 // @see https://developer.mozilla.org/
@@ -7,9 +7,7 @@
 const AsyncFunction = Object.getPrototypeOf(async () => {}).constructor;
 const objectToString = Object.prototype.toString;
 
-/* ------------------------------------------------------------------ Exports */
-
-// ---------------------------------------------------------------------- Method
+/** Exports */
 
 /**
  * Check if a value looks like an array
@@ -30,8 +28,6 @@ export function isArrayLike(item) {
 	return false;
 }
 
-// ---------------------------------------------------------------------- Method
-
 /**
  * Check if a value is an Arguments object
  *
@@ -43,8 +39,6 @@ export function isArguments(value) {
 	return objectToString.call(value) === '[object Arguments]';
 }
 
-// ---------------------------------------------------------------------- Method
-
 /**
  * Check if a value is an array that only contains primitives
  * - A primitive is a not-object value
@@ -68,8 +62,6 @@ export function isArrayOfPrimitives(arr) {
 	return true;
 }
 
-// ---------------------------------------------------------------------- Method
-
 /**
  * Check if the supplied value is async iterable
  * - Aync iterable objects must implement the "@@asyncIterator" method
@@ -86,8 +78,6 @@ export function isAsyncIterator(value) {
 	return true;
 }
 
-// ---------------------------------------------------------------------- Method
-
 /**
  * Check if the supplied value is an async function
  * - Returns true for functions declared as "async function" or
@@ -108,8 +98,6 @@ export function isAsyncFunction(value) {
 	return false;
 }
 
-// ---------------------------------------------------------------------- Method
-
 /**
  * Check if the supplied value is iterable
  * - Iterable objects must implement the "@@iterator" method
@@ -127,8 +115,6 @@ export function isIterable(value) {
 	return true;
 }
 
-// ---------------------------------------------------------------------- Method
-
 /**
  * Check if the supplied value is an object bu not a promise
  * - Promises return false

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@hkdigital/lib-sveltekit",
-	"version": "0.0.66",
+	"version": "0.0.68",
 	"author": "Jens Kleinhout, HKdigital (https://hkdigital.nl)",
 	"license": "ISC",
 	"repository": {