@oscarpalmer/atoms 0.144.0 → 0.145.0

package/dist/atoms.full.js

@@ -901,6 +901,64 @@ const DEFAULT_CACHE_SIZE = 1024;
 function throttle(callback, time) {
 	return getLimiter(callback, true, time);
 }
+function assert(condition, message, error) {
+	if (!condition()) throw new (error ?? Error)(message);
+}
+assert.condition = (condition, message, error) => {
+	return (value) => {
+		assert(() => condition(value), message, error);
+	};
+};
+assert.instanceOf = (constructor, message, error) => {
+	return (value) => {
+		assert(() => value instanceof constructor, message, error);
+	};
+};
+assert.is = (condition, message, error) => {
+	return (value) => {
+		assert(() => condition(value), message, error);
+	};
+};
+function asyncFlow(...fns) {
+	assertFlowFunctions(fns);
+	return (...args) => asyncWork(args, fns, true);
+}
+function flow(...fns) {
+	assertFlowFunctions(fns);
+	return (...args) => work(args, fns, true);
+}
+flow.async = asyncFlow;
+async function asyncPipe(value, ...pipes) {
+	assertPipeFunctions(pipes);
+	return asyncWork(value, pipes, false);
+}
+function pipe(value, ...pipes) {
+	assertPipeFunctions(pipes);
+	return work(value, pipes, false);
+}
+pipe.async = asyncPipe;
+async function asyncWork(initial, functions, flow) {
+	const { length } = functions;
+	let transformed = initial;
+	for (let index = 0; index < length; index += 1) {
+		const fn = functions[index];
+		transformed = flow && index === 0 && Array.isArray(initial) ? await fn(...initial) : await fn(transformed);
+	}
+	return transformed;
+}
+function work(initial, functions, flow) {
+	const { length } = functions;
+	let transformed = initial;
+	for (let index = 0; index < length; index += 1) {
+		const fn = functions[index];
+		transformed = flow && index === 0 && Array.isArray(initial) ? fn(...initial) : fn(transformed);
+	}
+	return transformed;
+}
+const MESSAGE_FLOW = "Flow expected to receive an array of functions";
+const MESSAGE_PIPE = "Pipe expected to receive an array of functions";
+const assertFlowFunctions = assert.condition((value) => Array.isArray(value) && value.every((item) => typeof item === "function"), MESSAGE_FLOW, TypeError);
+const assertPipeFunctions = assert.condition((value) => Array.isArray(value) && value.every((item) => typeof item === "function"), MESSAGE_PIPE, TypeError);
 function _getRandomFloat(inclusive, minimum, maximum) {
 	let maxFloat = isNumber(maximum) && maximum <= Number.MAX_SAFE_INTEGER ? maximum : Number.MAX_SAFE_INTEGER;
 	let minFloat = isNumber(minimum) && minimum >= Number.MIN_SAFE_INTEGER ? minimum : Number.MIN_SAFE_INTEGER;
@@ -2630,6 +2688,15 @@ function isEmpty(value) {
 	return true;
 }
 /**
+* Is the value an instance of the constructor?
+* @param constructor Class constructor
+* @param value Value to check
+* @returns `true` if the value is an instance of the constructor, otherwise `false`
+*/
+function isInstanceOf(constructor, value) {
+	return isConstructor(constructor) && value instanceof constructor;
+}
+/**
 * Is the value not `undefined` or `null`?
 * @param value Value to check
 * @returns `true` if the value is not `undefined` or `null`, otherwise `false`
@@ -2893,6 +2960,31 @@ var PromiseTimeoutError = class extends Error {
 		this.name = ERROR_NAME$1;
 	}
 };
+async function attemptPromise(value, options) {
+	const isFunction = typeof value === "function";
+	if (!isFunction && !(value instanceof Promise)) return Promise.reject(new TypeError(MESSAGE_EXPECTATION_ATTEMPT));
+	const { signal, time } = getPromiseOptions(options);
+	if (signal?.aborted ?? false) return Promise.reject(signal.reason);
+	function abort() {
+		rejector(signal.reason);
+	}
+	async function handler(resolve, reject) {
+		try {
+			let result = isFunction ? value() : await value;
+			if (result instanceof Promise) result = await result;
+			settlePromise(abort, resolve, result, signal);
+		} catch (error) {
+			settlePromise(abort, reject, error, signal);
+		}
+	}
+	let rejector;
+	signal?.addEventListener(EVENT_NAME$1, abort, ABORT_OPTIONS);
+	const promise = new Promise((resolve, reject) => {
+		rejector = reject;
+		handler(resolve, reject);
+	});
+	return time > 0 ? getTimed(promise, time, signal) : promise;
+}
 /**
 * Create a cancelable promise
 * @param executor Executor function for the promise
@@ -3053,31 +3145,6 @@ async function timed(promise, options) {
 	if (signal?.aborted ?? false) return Promise.reject(signal.reason);
 	return time > 0 ? getTimed(promise, time, signal) : promise;
 }
-async function attemptPromise(value, options) {
-	const isFunction = typeof value === "function";
-	if (!isFunction && !(value instanceof Promise)) return Promise.reject(new TypeError(MESSAGE_EXPECTATION_ATTEMPT));
-	const { signal, time } = getPromiseOptions(options);
-	if (signal?.aborted ?? false) return Promise.reject(signal.reason);
-	function abort() {
-		rejector(signal.reason);
-	}
-	async function handler(resolve, reject) {
-		try {
-			let result = isFunction ? value() : await value;
-			if (result instanceof Promise) result = await result;
-			settlePromise(abort, resolve, result, signal);
-		} catch (error) {
-			settlePromise(abort, reject, error, signal);
-		}
-	}
-	let rejector;
-	signal?.addEventListener(EVENT_NAME$1, abort, ABORT_OPTIONS);
-	const promise = new Promise((resolve, reject) => {
-		rejector = reject;
-		handler(resolve, reject);
-	});
-	return time > 0 ? getTimed(promise, time, signal) : promise;
-}
 const ABORT_OPTIONS = { once: true };
 const DEFAULT_STRATEGY = "complete";
 const ERROR_NAME$1 = "PromiseTimeoutError";
@@ -3420,6 +3487,24 @@ function _isResult(value, okValue) {
 	if (!isPlainObject(value)) return false;
 	return value.ok === okValue && (okValue ? "value" : "error") in value;
 }
+async function asyncAttempt(value, err) {
+	try {
+		let result = typeof value === "function" ? value() : await value;
+		if (result instanceof Promise) result = await result;
+		return ok(result);
+	} catch (thrown) {
+		return getError(err ?? thrown, err == null ? void 0 : thrown);
+	}
+}
+function attempt(callback, err) {
+	try {
+		return ok(callback());
+	} catch (thrown) {
+		return getError(err ?? thrown, err == null ? void 0 : thrown);
+	}
+}
+attempt.async = asyncAttempt;
+attempt.promise = attemptPromise;
 function error(value, original) {
 	return getError(value, original);
 }
@@ -3461,22 +3546,6 @@ function ok(value) {
 		value
 	};
 }
-function attempt(callback, err) {
-	try {
-		return ok(callback());
-	} catch (thrown) {
-		return getError(err ?? thrown, err == null ? void 0 : thrown);
-	}
-}
-attempt.async = asyncAttempt;
-attempt.promise = attemptPromise;
-async function asyncAttempt(value, err) {
-	try {
-		return ok(await (typeof value === "function" ? value() : value));
-	} catch (thrown) {
-		return getError(err ?? thrown, err == null ? void 0 : thrown);
-	}
-}
 function unwrap(value, defaultValue) {
 	return isOk(value) ? value.value : defaultValue;
 }
@@ -3532,4 +3601,4 @@ var SizedSet = class extends Set {
 		}
 	}
 };
-export { CancelablePromise, frame_rate_default as FRAME_RATE_MS, PromiseTimeoutError, QueueError, SizedMap, SizedSet, attempt, attemptPromise, average, beacon, between, camelCase, cancelable, capitalize, ceil, chunk, clamp, clone, compact, compare, count, debounce, delay, diff, endsWith, equal, error, exists, filter, find, flatten, floor, fromQuery, getArray, getColor, getForegroundColor, getHexColor, getHexaColor, getHslColor, getHslaColor, getNormalizedHex, getNumber, getRandomBoolean, getRandomCharacters, getRandomColor, getRandomFloat, getRandomHex, getRandomInteger, getRandomItem, getRandomItems, getRgbColor, getRgbaColor, getString, getUuid, getValue, groupBy, hexToHsl, hexToHsla, hexToRgb, hexToRgba, hslToHex, hslToRgb, hslToRgba, ignoreKey, includes, indexOf, insert, isArrayOrPlainObject, isColor, isConstructor, isEmpty, isError, isFulfilled, isHexColor, isHslColor, isHslLike, isHslaColor, isKey, isNonNullable, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject, isOk, isPlainObject, isPrimitive, isRejected, isResult, isRgbColor, isRgbLike, isRgbaColor, isTypedArray, join, kebabCase, logger, lowerCase, max, median, memoize, merge, min, noop, ok, omit, parse, partition, pascalCase, pick, promises, push, queue, range, rgbToHex, rgbToHsl, rgbToHsla, round, select, setValue, shuffle, smush, snakeCase, sort, splice, startsWith, sum, template, throttle, timed, titleCase, toMap, toQuery, toRecord, toSet, toggle, trim, truncate, tryDecode, tryEncode, unique, unsmush, unwrap, update, upperCase, words };
+export { CancelablePromise, frame_rate_default as FRAME_RATE_MS, PromiseTimeoutError, QueueError, SizedMap, SizedSet, attempt, attemptPromise, average, beacon, between, camelCase, cancelable, capitalize, ceil, chunk, clamp, clone, compact, compare, count, debounce, delay, diff, endsWith, equal, error, exists, filter, find, flatten, floor, flow, fromQuery, getArray, getColor, getForegroundColor, getHexColor, getHexaColor, getHslColor, getHslaColor, getNormalizedHex, getNumber, getRandomBoolean, getRandomCharacters, getRandomColor, getRandomFloat, getRandomHex, getRandomInteger, getRandomItem, getRandomItems, getRgbColor, getRgbaColor, getString, getUuid, getValue, groupBy, hexToHsl, hexToHsla, hexToRgb, hexToRgba, hslToHex, hslToRgb, hslToRgba, ignoreKey, includes, indexOf, insert, isArrayOrPlainObject, isColor, isConstructor, isEmpty, isError, isFulfilled, isHexColor, isHslColor, isHslLike, isHslaColor, isInstanceOf, isKey, isNonNullable, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject, isOk, isPlainObject, isPrimitive, isRejected, isResult, isRgbColor, isRgbLike, isRgbaColor, isTypedArray, join, kebabCase, logger, lowerCase, max, median, memoize, merge, min, noop, ok, omit, parse, partition, pascalCase, pick, pipe, promises, push, queue, range, rgbToHex, rgbToHsl, rgbToHsla, round, select, setValue, shuffle, smush, snakeCase, sort, splice, startsWith, sum, template, throttle, timed, titleCase, toMap, toQuery, toRecord, toSet, toggle, trim, truncate, tryDecode, tryEncode, unique, unsmush, unwrap, update, upperCase, words };

package/dist/function/assert.js

@@ -0,0 +1,19 @@
+function assert(condition, message, error) {
+	if (!condition()) throw new (error ?? Error)(message);
+}
+assert.condition = (condition, message, error) => {
+	return (value) => {
+		assert(() => condition(value), message, error);
+	};
+};
+assert.instanceOf = (constructor, message, error) => {
+	return (value) => {
+		assert(() => value instanceof constructor, message, error);
+	};
+};
+assert.is = (condition, message, error) => {
+	return (value) => {
+		assert(() => condition(value), message, error);
+	};
+};
+export { assert };

package/dist/function/work.js

@@ -0,0 +1,42 @@
+import { assert } from "./assert.js";
+function asyncFlow(...fns) {
+	assertFlowFunctions(fns);
+	return (...args) => asyncWork(args, fns, true);
+}
+function flow(...fns) {
+	assertFlowFunctions(fns);
+	return (...args) => work(args, fns, true);
+}
+flow.async = asyncFlow;
+async function asyncPipe(value, ...pipes) {
+	assertPipeFunctions(pipes);
+	return asyncWork(value, pipes, false);
+}
+function pipe(value, ...pipes) {
+	assertPipeFunctions(pipes);
+	return work(value, pipes, false);
+}
+pipe.async = asyncPipe;
+async function asyncWork(initial, functions, flow) {
+	const { length } = functions;
+	let transformed = initial;
+	for (let index = 0; index < length; index += 1) {
+		const fn = functions[index];
+		transformed = flow && index === 0 && Array.isArray(initial) ? await fn(...initial) : await fn(transformed);
+	}
+	return transformed;
+}
+function work(initial, functions, flow) {
+	const { length } = functions;
+	let transformed = initial;
+	for (let index = 0; index < length; index += 1) {
+		const fn = functions[index];
+		transformed = flow && index === 0 && Array.isArray(initial) ? fn(...initial) : fn(transformed);
+	}
+	return transformed;
+}
+var MESSAGE_FLOW = "Flow expected to receive an array of functions";
+var MESSAGE_PIPE = "Pipe expected to receive an array of functions";
+var assertFlowFunctions = assert.condition((value) => Array.isArray(value) && value.every((item) => typeof item === "function"), MESSAGE_FLOW, TypeError);
+var assertPipeFunctions = assert.condition((value) => Array.isArray(value) && value.every((item) => typeof item === "function"), MESSAGE_PIPE, TypeError);
+export { flow, pipe };

package/dist/index.js

@@ -38,6 +38,7 @@ import { debounce } from "./function/debounce.js";
 import { SizedMap } from "./sized/map.js";
 import { memoize } from "./function/memoize.js";
 import { throttle } from "./function/throttle.js";
+import { flow, pipe } from "./function/work.js";
 import { getRandomFloat, getRandomInteger } from "./internal/random.js";
 import { shuffle } from "./internal/array/shuffle.js";
 import { equal } from "./internal/value/equal.js";
@@ -54,7 +55,7 @@ import { omit } from "./value/omit.js";
 import { pick } from "./value/pick.js";
 import { smush } from "./value/smush.js";
 import { unsmush } from "./value/unsmush.js";
-import { isEmpty, isNonNullable, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumerical, isObject, isPrimitive } from "./is.js";
+import { isEmpty, isInstanceOf, isNonNullable, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumerical, isObject, isPrimitive } from "./is.js";
 import { logger } from "./logger.js";
 import { average, ceil, count, floor, median, min, round, sum } from "./math.js";
 import { CancelablePromise, PromiseTimeoutError, attemptPromise, cancelable, delay, isFulfilled, isRejected, promises, timed } from "./promise.js";
@@ -63,4 +64,4 @@ import { QueueError, queue } from "./queue.js";
 import { getRandomBoolean, getRandomCharacters, getRandomColor, getRandomHex, getRandomItem, getRandomItems } from "./random.js";
 import { attempt, error, isError, isOk, isResult, ok, unwrap } from "./result.js";
 import { SizedSet } from "./sized/set.js";
-export { CancelablePromise, frame_rate_default as FRAME_RATE_MS, PromiseTimeoutError, QueueError, SizedMap, SizedSet, attempt, attemptPromise, average, beacon, between, camelCase, cancelable, capitalize, ceil, chunk, clamp, clone, compact, compare, count, debounce, delay, diff, endsWith, equal, error, exists, filter, find, flatten, floor, fromQuery, getArray, getColor, getForegroundColor, getHexColor, getHexaColor, getHslColor, getHslaColor, getNormalizedHex, getNumber, getRandomBoolean, getRandomCharacters, getRandomColor, getRandomFloat, getRandomHex, getRandomInteger, getRandomItem, getRandomItems, getRgbColor, getRgbaColor, getString, getUuid, getValue, groupBy, hexToHsl, hexToHsla, hexToRgb, hexToRgba, hslToHex, hslToRgb, hslToRgba, ignoreKey, includes, indexOf, insert, isArrayOrPlainObject, isColor, isConstructor, isEmpty, isError, isFulfilled, isHexColor, isHslColor, isHslLike, isHslaColor, isKey, isNonNullable, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject, isOk, isPlainObject, isPrimitive, isRejected, isResult, isRgbColor, isRgbLike, isRgbaColor, isTypedArray, join, kebabCase, logger, lowerCase, max, median, memoize, merge, min, noop, ok, omit, parse, partition, pascalCase, pick, promises, push, queue, range, rgbToHex, rgbToHsl, rgbToHsla, round, select, setValue, shuffle, smush, snakeCase, sort, splice, startsWith, sum, template, throttle, timed, titleCase, toMap, toQuery, toRecord, toSet, toggle, trim, truncate, tryDecode, tryEncode, unique, unsmush, unwrap, update, upperCase, words };
+export { CancelablePromise, frame_rate_default as FRAME_RATE_MS, PromiseTimeoutError, QueueError, SizedMap, SizedSet, attempt, attemptPromise, average, beacon, between, camelCase, cancelable, capitalize, ceil, chunk, clamp, clone, compact, compare, count, debounce, delay, diff, endsWith, equal, error, exists, filter, find, flatten, floor, flow, fromQuery, getArray, getColor, getForegroundColor, getHexColor, getHexaColor, getHslColor, getHslaColor, getNormalizedHex, getNumber, getRandomBoolean, getRandomCharacters, getRandomColor, getRandomFloat, getRandomHex, getRandomInteger, getRandomItem, getRandomItems, getRgbColor, getRgbaColor, getString, getUuid, getValue, groupBy, hexToHsl, hexToHsla, hexToRgb, hexToRgba, hslToHex, hslToRgb, hslToRgba, ignoreKey, includes, indexOf, insert, isArrayOrPlainObject, isColor, isConstructor, isEmpty, isError, isFulfilled, isHexColor, isHslColor, isHslLike, isHslaColor, isInstanceOf, isKey, isNonNullable, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject, isOk, isPlainObject, isPrimitive, isRejected, isResult, isRgbColor, isRgbLike, isRgbaColor, isTypedArray, join, kebabCase, logger, lowerCase, max, median, memoize, merge, min, noop, ok, omit, parse, partition, pascalCase, pick, pipe, promises, push, queue, range, rgbToHex, rgbToHsl, rgbToHsla, round, select, setValue, shuffle, smush, snakeCase, sort, splice, startsWith, sum, template, throttle, timed, titleCase, toMap, toQuery, toRecord, toSet, toggle, trim, truncate, tryDecode, tryEncode, unique, unsmush, unwrap, update, upperCase, words };

package/dist/is.js

@@ -15,6 +15,15 @@ function isEmpty(value) {
 	return true;
 }
 /**
+* Is the value an instance of the constructor?
+* @param constructor Class constructor
+* @param value Value to check
+* @returns `true` if the value is an instance of the constructor, otherwise `false`
+*/
+function isInstanceOf(constructor, value) {
+	return isConstructor(constructor) && value instanceof constructor;
+}
+/**
 * Is the value not `undefined` or `null`?
 * @param value Value to check
 * @returns `true` if the value is not `undefined` or `null`, otherwise `false`
@@ -72,4 +81,4 @@ function isPrimitive(value) {
 }
 var EXPRESSION_PRIMITIVE = /^(bigint|boolean|number|string|symbol)$/;
 var EXPRESSION_WHITESPACE = /^\s*$/;
-export { isArrayOrPlainObject, isConstructor, isEmpty, isKey, isNonNullable, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject, isPlainObject, isPrimitive, isTypedArray };
+export { isArrayOrPlainObject, isConstructor, isEmpty, isInstanceOf, isKey, isNonNullable, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject, isPlainObject, isPrimitive, isTypedArray };

package/dist/promise.js

@@ -22,6 +22,31 @@ var PromiseTimeoutError = class extends Error {
 		this.name = ERROR_NAME;
 	}
 };
+async function attemptPromise(value, options) {
+	const isFunction = typeof value === "function";
+	if (!isFunction && !(value instanceof Promise)) return Promise.reject(new TypeError(MESSAGE_EXPECTATION_ATTEMPT));
+	const { signal, time } = getPromiseOptions(options);
+	if (signal?.aborted ?? false) return Promise.reject(signal.reason);
+	function abort() {
+		rejector(signal.reason);
+	}
+	async function handler(resolve, reject) {
+		try {
+			let result = isFunction ? value() : await value;
+			if (result instanceof Promise) result = await result;
+			settlePromise(abort, resolve, result, signal);
+		} catch (error) {
+			settlePromise(abort, reject, error, signal);
+		}
+	}
+	let rejector;
+	signal?.addEventListener(EVENT_NAME, abort, ABORT_OPTIONS);
+	const promise = new Promise((resolve, reject) => {
+		rejector = reject;
+		handler(resolve, reject);
+	});
+	return time > 0 ? getTimed(promise, time, signal) : promise;
+}
 /**
 * Create a cancelable promise
 * @param executor Executor function for the promise
@@ -182,31 +207,6 @@ async function timed(promise, options) {
 	if (signal?.aborted ?? false) return Promise.reject(signal.reason);
 	return time > 0 ? getTimed(promise, time, signal) : promise;
 }
-async function attemptPromise(value, options) {
-	const isFunction = typeof value === "function";
-	if (!isFunction && !(value instanceof Promise)) return Promise.reject(new TypeError(MESSAGE_EXPECTATION_ATTEMPT));
-	const { signal, time } = getPromiseOptions(options);
-	if (signal?.aborted ?? false) return Promise.reject(signal.reason);
-	function abort() {
-		rejector(signal.reason);
-	}
-	async function handler(resolve, reject) {
-		try {
-			let result = isFunction ? value() : await value;
-			if (result instanceof Promise) result = await result;
-			settlePromise(abort, resolve, result, signal);
-		} catch (error) {
-			settlePromise(abort, reject, error, signal);
-		}
-	}
-	let rejector;
-	signal?.addEventListener(EVENT_NAME, abort, ABORT_OPTIONS);
-	const promise = new Promise((resolve, reject) => {
-		rejector = reject;
-		handler(resolve, reject);
-	});
-	return time > 0 ? getTimed(promise, time, signal) : promise;
-}
 var ABORT_OPTIONS = { once: true };
 var DEFAULT_STRATEGY = "complete";
 var ERROR_NAME = "PromiseTimeoutError";

package/dist/result.js

@@ -4,6 +4,24 @@ function _isResult(value, okValue) {
 	if (!isPlainObject(value)) return false;
 	return value.ok === okValue && (okValue ? "value" : "error") in value;
 }
+async function asyncAttempt(value, err) {
+	try {
+		let result = typeof value === "function" ? value() : await value;
+		if (result instanceof Promise) result = await result;
+		return ok(result);
+	} catch (thrown) {
+		return getError(err ?? thrown, err == null ? void 0 : thrown);
+	}
+}
+function attempt(callback, err) {
+	try {
+		return ok(callback());
+	} catch (thrown) {
+		return getError(err ?? thrown, err == null ? void 0 : thrown);
+	}
+}
+attempt.async = asyncAttempt;
+attempt.promise = attemptPromise;
 function error(value, original) {
 	return getError(value, original);
 }
@@ -45,22 +63,6 @@ function ok(value) {
 		value
 	};
 }
-function attempt(callback, err) {
-	try {
-		return ok(callback());
-	} catch (thrown) {
-		return getError(err ?? thrown, err == null ? void 0 : thrown);
-	}
-}
-attempt.async = asyncAttempt;
-attempt.promise = attemptPromise;
-async function asyncAttempt(value, err) {
-	try {
-		return ok(await (typeof value === "function" ? value() : value));
-	} catch (thrown) {
-		return getError(err ?? thrown, err == null ? void 0 : thrown);
-	}
-}
 function unwrap(value, defaultValue) {
 	return isOk(value) ? value.value : defaultValue;
 }

package/package.json

@@ -138,6 +138,10 @@
 			"types": "./types/function/throttle.d.ts",
 			"default": "./dist/function/throttle.js"
 		},
+		"./function/work": {
+			"types": "./types/function/work.d.ts",
+			"default": "./dist/function/work.js"
+		},
 		"./is": {
 			"types": "./types/is.d.ts",
 			"default": "./dist/is.js"
@@ -256,5 +260,5 @@
 	},
 	"type": "module",
 	"types": "./types/index.d.ts",
-	"version": "0.144.0"
+	"version": "0.145.0"
 }

package/src/function/assert.ts

@@ -0,0 +1,43 @@
+import type {Constructor} from '../models';
+
+export type Asserter<Value> = (value: unknown) => asserts value is Value;
+
+export function assert<Condition extends () => boolean>(
+	condition: Condition,
+	message: string,
+	error?: ErrorConstructor,
+): asserts condition {
+	if (!condition()) {
+		throw new (error ?? Error)(message);
+	}
+}
+
+assert.condition = <Value>(
+	condition: (value: unknown) => boolean,
+	message: string,
+	error?: ErrorConstructor,
+): Asserter<Value> => {
+	return value => {
+		assert(() => condition(value), message, error);
+	};
+};
+
+assert.instanceOf = <Value>(
+	constructor: Constructor<Value>,
+	message: string,
+	error?: ErrorConstructor,
+): Asserter<Value> => {
+	return value => {
+		assert(() => value instanceof constructor, message, error);
+	};
+};
+
+assert.is = <Value>(
+	condition: (value: unknown) => value is Value,
+	message: string,
+	error?: ErrorConstructor,
+): Asserter<Value> => {
+	return value => {
+		assert(() => condition(value), message, error);
+	};
+};