@hkdigital/lib-core 0.3.11 → 0.3.13

package/dist/util/expect/primitives.js

@@ -1,55 +1,55 @@
-import * as v from 'valibot';
-
-/**
- * Throws a validation error if value is not a string
- *
- * @param {any} value
- */
-export function string(value) {
-	v.parse(v.string(), value);
-}
-
-/**
- * Throws a validation error if value is not a boolean
- *
- * @param {any} value
- */
-export function boolean(value) {
-	v.parse(v.boolean(), value);
-}
-
-/**
- * Throws a validation error if value is not a number
- *
- * @param {any} value
- */
-export function number(value) {
-	v.parse(v.number(), value);
-}
-
-/**
- * Throws a validation error if value is not a Symbol
- *
- * @param {any} value
- */
-export function symbol(value) {
-	v.parse(v.symbol(), value);
-}
-
-/**
- * Throws a validation error if value is not defined
- *
- * @param {any} value
- */
-export function defined(value) {
-	v.parse(
-		v.custom((value) => {
-			if (value === undefined) {
-				return false;
-			}
-
-			return true;
-		}, 'Invalid type: Expected any value, but received undefined'),
-		value
-	);
-}
+import * as v from 'valibot';
+
+/**
+ * Throws a validation error if value is not a string
+ *
+ * @param {any} value
+ */
+export function string(value) {
+	v.parse(v.string(), value);
+}
+
+/**
+ * Throws a validation error if value is not a boolean
+ *
+ * @param {any} value
+ */
+export function boolean(value) {
+	v.parse(v.boolean(), value);
+}
+
+/**
+ * Throws a validation error if value is not a number
+ *
+ * @param {any} value
+ */
+export function number(value) {
+	v.parse(v.number(), value);
+}
+
+/**
+ * Throws a validation error if value is not a Symbol
+ *
+ * @param {any} value
+ */
+export function symbol(value) {
+	v.parse(v.symbol(), value);
+}
+
+/**
+ * Throws a validation error if value is not defined
+ *
+ * @param {any} value
+ */
+export function defined(value) {
+	v.parse(
+		v.custom((value) => {
+			if (value === undefined) {
+				return false;
+			}
+
+			return true;
+		}, 'Invalid type: Expected any value, but received undefined'),
+		value
+	);
+}

package/dist/util/expect/url.js

@@ -1,60 +1,60 @@
-// > Imports
-
-import * as v from 'valibot';
-
-import {
-	HumanUrl,
-	UrlOrEmptyString,
-	UrlPath,
-	RelativeUrl,
-	AbsOrRelUrl
-} from '../../valibot/parsers.js';
-
-// > Exports
-
-/**
- * Throws a parse error if value is not a URL
- *
- * @param {any} value
- */
-export function url(value) {
-	v.parse(HumanUrl, value);
-}
-
-/**
- * Throws a parse error if value is not a URL or
- * an empty string
- *
- * @param {any} value
- */
-export function urlOrEmptyString(value) {
-	v.parse(UrlOrEmptyString, value);
-}
-
-/**
- * Throws a parse error if value is not a URL path
- *
- * @param {any} value
- */
-export function urlPath(value) {
-	v.parse(UrlPath, value);
-}
-
-/**
- * Throws a parse error if value is not a relative URL
- *
- * @param {any} value
- */
-export function relativeUrl(value) {
-	v.parse(RelativeUrl, value);
-}
-
-/**
- * Throws a parse error if value is not an absolute
- * or relative URL
- *
- * @param {any} value
- */
-export function absOrRelUrl(value) {
-	v.parse(AbsOrRelUrl, value);
-}
+// > Imports
+
+import * as v from 'valibot';
+
+import {
+	HumanUrl,
+	UrlOrEmptyString,
+	UrlPath,
+	RelativeUrl,
+	AbsOrRelUrl
+} from '../../valibot/parsers.js';
+
+// > Exports
+
+/**
+ * Throws a parse error if value is not a URL
+ *
+ * @param {any} value
+ */
+export function url(value) {
+	v.parse(HumanUrl, value);
+}
+
+/**
+ * Throws a parse error if value is not a URL or
+ * an empty string
+ *
+ * @param {any} value
+ */
+export function urlOrEmptyString(value) {
+	v.parse(UrlOrEmptyString, value);
+}
+
+/**
+ * Throws a parse error if value is not a URL path
+ *
+ * @param {any} value
+ */
+export function urlPath(value) {
+	v.parse(UrlPath, value);
+}
+
+/**
+ * Throws a parse error if value is not a relative URL
+ *
+ * @param {any} value
+ */
+export function relativeUrl(value) {
+	v.parse(RelativeUrl, value);
+}
+
+/**
+ * Throws a parse error if value is not an absolute
+ * or relative URL
+ *
+ * @param {any} value
+ */
+export function absOrRelUrl(value) {
+	v.parse(AbsOrRelUrl, value);
+}

package/dist/util/function/index.js

@@ -1,218 +1,218 @@
-/**
- * function.js
- *
- * @description
- * This file contains code for working with functions
- *
- * @example
- *
- *   import { once } from "./function.js";
- *
- *   const sayHelloOnce = once( () => { console.log("Hello"); } );
- *
- *   sayHelloOnce();
- *   sayHelloOnce();
- *
- * @example
- *
- *   import { defer } from './process.js';
- *
- *   defer( () => {
- *     console.log("The execution of the function has been defered");
- *   } );
- */
-
-/* ------------------------------------------------------------------ Imports */
-
-import * as expect from '../expect/index.js';
-
-/* ---------------------------------------------------------------- Internals */
-
-const NEXT_TICK_MESSAGE = 'hk-next-tick';
-
-/**
- * Detect and return the most suitable setImmediate implementation available
- * on the current platform
- */
-function set_immediate_implementation() {
-	if (typeof global !== 'undefined') {
-		if (undefined !== global.setImmediate) {
-			return global.setImmediate;
-		}
-	} else if (typeof window !== 'undefined') {
-		if (window.postMessage && window.addEventListener) {
-			const queue = [];
-
-			window.addEventListener(
-				'message',
-				(event) => {
-					const source = event.source;
-
-					if ((source === window || source === null) && event.data === NEXT_TICK_MESSAGE) {
-						event.stopPropagation();
-						if (queue.length > 0) {
-							const fn = queue.shift();
-							fn();
-						}
-					}
-				},
-				true
-			);
-
-			return function nextTickUsingPostMessage(fn) {
-				expect.function(fn);
-
-				queue.push(fn);
-				window.postMessage(NEXT_TICK_MESSAGE, '*');
-			};
-		}
-	}
-
-	throw new Error('No suitable [setImmediate] implementation available');
-}
-
-/* ------------------------------------------------------------------ Exports */
-
-/**
- * 'No operation' function
- * - A function that does nothing
- */
-export const noop = () => {};
-
-// -----------------------------------------------------------------------------
-
-/**
- * Wraps a function so that the callback function will be called only once
- *
- * @param {function} callback
- *
- * @returns {function} callback wrapped in `once` function
- */
-export function once(callback) {
-	expect.function(callback);
-
-	let ignore = false;
-
-	return function () {
-		if (!ignore) {
-			ignore = true;
-			callback(...arguments);
-		}
-	};
-}
-
-// -----------------------------------------------------------------------------
-
-/**
- * Returns a debounced function
- * - The original function is not called more than once during the
- *   specified interval
- *
- * @param {function} fn
- * @param {number} [intervalMs=200]
- *
- * @returns {function} debounced function
- */
-export function debounce(fn, intervalMs = 200) {
-	let idleTimer;
-	let lastArguments;
-
-	// console.log("debounce");
-
-	return function debounced() {
-		// console.log("debounced");
-
-		if (idleTimer) {
-			// console.log("idleTimer running");
-
-			// The function has been called recently
-			lastArguments = arguments;
-			return;
-		}
-
-		idleTimer = setTimeout(() => {
-			// console.log("idleTimer finished", lastArguments);
-
-			idleTimer = null;
-
-			if (lastArguments) {
-				//
-				// At least one call has been "debounced"
-				// -> make call with last arguments, so function always receives
-				//    the arguments of the last call to the function
-				//
-				fn(...lastArguments);
-				lastArguments = undefined;
-			}
-		}, intervalMs);
-
-		fn(...arguments);
-	};
-}
-
-// -----------------------------------------------------------------------------
-
-/**
- * Defer the execution of a function
- *  - Uses the best 'setImmediate' implementation supported by the current
- *    runtime environment
- *
- * @param {function} fn - Function to execute
- *
- * --
- *
- * @note setImmediate is preferred over nextTick
- *
- * @see https://nodejs.org/en/docs/guides/event-loop-timers-and-nexttick/
- */
-export const defer = set_immediate_implementation();
-
-// -----------------------------------------------------------------------------
-
-/**
- * Adds a wrapper around a function that only calls the supplied function
- * if the (first) supplied argument to the returned function is not `null`
- *
- * @param {object} [object]
- *   Optional function context to be used as `this`
- *
- * @param {function} functionOrMethodName
- *
- * @returns {function} not null wrapper function
- */
-// export function ifNotNull( /* object, functionOrMethodName */ )
-// {
-//   let fn;
-
-//   switch( arguments.length )
-//   {
-//     case 1:
-//       fn = arguments[0];
-//       expectFunction( fn, "Missing or invalid parameter [fn]" );
-//       break;
-
-//     case 2:
-//       {
-//         const object = arguments[0];
-//         const methodName = arguments[1];
-
-//         expectObject( object, "Invalid parameter [object]" );
-//         expectNotEmptyString( methodName, "Invalid parameter [methodName]" );
-
-//         fn = object[ methodName ].bind( object );
-
-//         expectFunction( fn, `Invalid method [<object>.${methodName}]` );
-//       }
-//       break;
-
-//     default:
-//       throw new Error("Invalid number of arguments");
-//   }
-
-//   return async ( value ) => {
-//     if( null !== value )
-//     {
-//       await fn( value );
-//     }
-//   };
-// }
+/**
+ * function.js
+ *
+ * @description
+ * This file contains code for working with functions
+ *
+ * @example
+ *
+ *   import { once } from "./function.js";
+ *
+ *   const sayHelloOnce = once( () => { console.log("Hello"); } );
+ *
+ *   sayHelloOnce();
+ *   sayHelloOnce();
+ *
+ * @example
+ *
+ *   import { defer } from './process.js';
+ *
+ *   defer( () => {
+ *     console.log("The execution of the function has been defered");
+ *   } );
+ */
+
+/* ------------------------------------------------------------------ Imports */
+
+import * as expect from '../expect/index.js';
+
+/* ---------------------------------------------------------------- Internals */
+
+const NEXT_TICK_MESSAGE = 'hk-next-tick';
+
+/**
+ * Detect and return the most suitable setImmediate implementation available
+ * on the current platform
+ */
+function set_immediate_implementation() {
+	if (typeof global !== 'undefined') {
+		if (undefined !== global.setImmediate) {
+			return global.setImmediate;
+		}
+	} else if (typeof window !== 'undefined') {
+		if (window.postMessage && window.addEventListener) {
+			const queue = [];
+
+			window.addEventListener(
+				'message',
+				(event) => {
+					const source = event.source;
+
+					if ((source === window || source === null) && event.data === NEXT_TICK_MESSAGE) {
+						event.stopPropagation();
+						if (queue.length > 0) {
+							const fn = queue.shift();
+							fn();
+						}
+					}
+				},
+				true
+			);
+
+			return function nextTickUsingPostMessage(fn) {
+				expect.function(fn);
+
+				queue.push(fn);
+				window.postMessage(NEXT_TICK_MESSAGE, '*');
+			};
+		}
+	}
+
+	throw new Error('No suitable [setImmediate] implementation available');
+}
+
+/* ------------------------------------------------------------------ Exports */
+
+/**
+ * 'No operation' function
+ * - A function that does nothing
+ */
+export const noop = () => {};
+
+// -----------------------------------------------------------------------------
+
+/**
+ * Wraps a function so that the callback function will be called only once
+ *
+ * @param {function} callback
+ *
+ * @returns {function} callback wrapped in `once` function
+ */
+export function once(callback) {
+	expect.function(callback);
+
+	let ignore = false;
+
+	return function () {
+		if (!ignore) {
+			ignore = true;
+			callback(...arguments);
+		}
+	};
+}
+
+// -----------------------------------------------------------------------------
+
+/**
+ * Returns a debounced function
+ * - The original function is not called more than once during the
+ *   specified interval
+ *
+ * @param {function} fn
+ * @param {number} [intervalMs=200]
+ *
+ * @returns {function} debounced function
+ */
+export function debounce(fn, intervalMs = 200) {
+	let idleTimer;
+	let lastArguments;
+
+	// console.log("debounce");
+
+	return function debounced() {
+		// console.log("debounced");
+
+		if (idleTimer) {
+			// console.log("idleTimer running");
+
+			// The function has been called recently
+			lastArguments = arguments;
+			return;
+		}
+
+		idleTimer = setTimeout(() => {
+			// console.log("idleTimer finished", lastArguments);
+
+			idleTimer = null;
+
+			if (lastArguments) {
+				//
+				// At least one call has been "debounced"
+				// -> make call with last arguments, so function always receives
+				//    the arguments of the last call to the function
+				//
+				fn(...lastArguments);
+				lastArguments = undefined;
+			}
+		}, intervalMs);
+
+		fn(...arguments);
+	};
+}
+
+// -----------------------------------------------------------------------------
+
+/**
+ * Defer the execution of a function
+ *  - Uses the best 'setImmediate' implementation supported by the current
+ *    runtime environment
+ *
+ * @param {function} fn - Function to execute
+ *
+ * --
+ *
+ * @note setImmediate is preferred over nextTick
+ *
+ * @see https://nodejs.org/en/docs/guides/event-loop-timers-and-nexttick/
+ */
+export const defer = set_immediate_implementation();
+
+// -----------------------------------------------------------------------------
+
+/**
+ * Adds a wrapper around a function that only calls the supplied function
+ * if the (first) supplied argument to the returned function is not `null`
+ *
+ * @param {object} [object]
+ *   Optional function context to be used as `this`
+ *
+ * @param {function} functionOrMethodName
+ *
+ * @returns {function} not null wrapper function
+ */
+// export function ifNotNull( /* object, functionOrMethodName */ )
+// {
+//   let fn;
+
+//   switch( arguments.length )
+//   {
+//     case 1:
+//       fn = arguments[0];
+//       expectFunction( fn, "Missing or invalid parameter [fn]" );
+//       break;
+
+//     case 2:
+//       {
+//         const object = arguments[0];
+//         const methodName = arguments[1];
+
+//         expectObject( object, "Invalid parameter [object]" );
+//         expectNotEmptyString( methodName, "Invalid parameter [methodName]" );
+
+//         fn = object[ methodName ].bind( object );
+
+//         expectFunction( fn, `Invalid method [<object>.${methodName}]` );
+//       }
+//       break;
+
+//     default:
+//       throw new Error("Invalid number of arguments");
+//   }
+
+//   return async ( value ) => {
+//     if( null !== value )
+//     {
+//       await fn( value );
+//     }
+//   };
+// }