@dereekb/util 0.0.1

package/src/lib/array/array.set.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setContainsAnyValue = exports.containsAnyValue = exports.filterValuesFromSet = exports.excludeValuesFromSet = exports.excludeValuesFromArray = exports.keepValuesFromSet = exports.keepValuesFromArray = exports.symmetricDifferenceKeysSet = exports.symmetricDifferenceKeys = exports.hasDifferentStringsNoCase = exports.hasDifferentValues = exports.flattenArrayToSet = void 0;
+const extra_set_1 = require("extra-set");
+const array_1 = require("./array");
+const string_1 = require("../string");
+// MARK: Functions
+function flattenArrayToSet(array) {
+    return new Set((0, array_1.flattenArray)(array));
+}
+exports.flattenArrayToSet = flattenArrayToSet;
+function hasDifferentValues(a, b) {
+    return a.length !== b.length || (0, extra_set_1.symmetricDifference)(new Set(a), new Set(b)).size > 0;
+}
+exports.hasDifferentValues = hasDifferentValues;
+function hasDifferentStringsNoCase(a, b) {
+    return hasDifferentValues(a.map(string_1.caseInsensitiveString), b.map(string_1.caseInsensitiveString));
+}
+exports.hasDifferentStringsNoCase = hasDifferentStringsNoCase;
+function symmetricDifferenceKeys(a, b) {
+    return symmetricDifferenceKeysSet(new Set(a), new Set(b));
+}
+exports.symmetricDifferenceKeys = symmetricDifferenceKeys;
+function symmetricDifferenceKeysSet(a, b) {
+    return Array.from((0, extra_set_1.symmetricDifference)(a, b));
+}
+exports.symmetricDifferenceKeysSet = symmetricDifferenceKeysSet;
+/**
+ * Returns items that exist in both arrays.
+ */
+function keepValuesFromArray(values, secondArray) {
+    return keepValuesFromSet(values, new Set(secondArray));
+}
+exports.keepValuesFromArray = keepValuesFromArray;
+function keepValuesFromSet(values, set) {
+    return filterValuesFromSet(values, set, false);
+}
+exports.keepValuesFromSet = keepValuesFromSet;
+function excludeValuesFromArray(values, secondArray) {
+    return excludeValuesFromSet(values, new Set(secondArray));
+}
+exports.excludeValuesFromArray = excludeValuesFromArray;
+function excludeValuesFromSet(values, set) {
+    return filterValuesFromSet(values, set, true);
+}
+exports.excludeValuesFromSet = excludeValuesFromSet;
+function filterValuesFromSet(values, set, exclude = false) {
+    const filterFn = (exclude) ? ((x) => !set.has(x)) : ((x) => set.has(x));
+    return values.filter(filterFn);
+}
+exports.filterValuesFromSet = filterValuesFromSet;
+/**
+ * Returns true if the input array contains any value from the second array.
+ */
+function containsAnyValue(values, valuesToFind) {
+    const set = new Set(valuesToFind);
+    return setContainsAnyValue(values, set);
+}
+exports.containsAnyValue = containsAnyValue;
+function setContainsAnyValue(values, valuesToFind) {
+    return (values) ? values.findIndex((x) => valuesToFind.has(x)) !== -1 : false;
+}
+exports.setContainsAnyValue = setContainsAnyValue;
+//# sourceMappingURL=array.set.js.map

package/src/lib/array/array.set.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"array.set.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/array/array.set.ts"],"names":[],"mappings":"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"}

package/src/lib/array/array.string.d.ts

@@ -0,0 +1,8 @@
+import { ReadKeyFunction } from "../key";
+export declare function toCaseInsensitiveStringArray(values: string[]): string[];
+export declare function uniqueCaseInsensitiveStrings(values: string[]): string[];
+export declare function uniqueCaseInsensitiveStringsSet(values: string[]): Set<string>;
+export declare function flattenArrayUniqueCaseInsensitiveStrings(array: string[][]): string[];
+export declare function findUniqueCaseInsensitiveStrings<T, K extends string = string>(models: T[], readKey: ReadKeyFunction<T, K>, additionalKeys?: K[]): T[];
+export declare function containsStringAnyCase(values: string[], valueToFind: string): boolean;
+export declare function containsAnyStringAnyCase(values: string[], valuesToFind: string[]): boolean;

package/src/lib/array/array.string.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.containsAnyStringAnyCase = exports.containsStringAnyCase = exports.findUniqueCaseInsensitiveStrings = exports.flattenArrayUniqueCaseInsensitiveStrings = exports.uniqueCaseInsensitiveStringsSet = exports.uniqueCaseInsensitiveStrings = exports.toCaseInsensitiveStringArray = void 0;
+const array_1 = require("./array");
+const array_set_1 = require("./array.set");
+const array_unique_1 = require("./array.unique");
+const string_1 = require("../string");
+function toCaseInsensitiveStringArray(values) {
+    return values.map(string_1.caseInsensitiveString);
+}
+exports.toCaseInsensitiveStringArray = toCaseInsensitiveStringArray;
+function uniqueCaseInsensitiveStrings(values) {
+    return Array.from(uniqueCaseInsensitiveStringsSet(values));
+}
+exports.uniqueCaseInsensitiveStrings = uniqueCaseInsensitiveStrings;
+function uniqueCaseInsensitiveStringsSet(values) {
+    return new Set(toCaseInsensitiveStringArray(values));
+}
+exports.uniqueCaseInsensitiveStringsSet = uniqueCaseInsensitiveStringsSet;
+function flattenArrayUniqueCaseInsensitiveStrings(array) {
+    return (0, array_unique_1.unique)((0, array_1.flattenArray)(array).map(string_1.caseInsensitiveString));
+}
+exports.flattenArrayUniqueCaseInsensitiveStrings = flattenArrayUniqueCaseInsensitiveStrings;
+function findUniqueCaseInsensitiveStrings(models, readKey, additionalKeys = []) {
+    return (0, array_unique_1.findUnique)(models, (x) => (0, string_1.caseInsensitiveString)(readKey(x)), toCaseInsensitiveStringArray(additionalKeys));
+}
+exports.findUniqueCaseInsensitiveStrings = findUniqueCaseInsensitiveStrings;
+function containsStringAnyCase(values, valueToFind) {
+    return containsAnyStringAnyCase(values, [valueToFind]);
+}
+exports.containsStringAnyCase = containsStringAnyCase;
+function containsAnyStringAnyCase(values, valuesToFind) {
+    return (0, array_set_1.containsAnyValue)(toCaseInsensitiveStringArray(values), toCaseInsensitiveStringArray(valuesToFind));
+}
+exports.containsAnyStringAnyCase = containsAnyStringAnyCase;
+//# sourceMappingURL=array.string.js.map

package/src/lib/array/array.string.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"array.string.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/array/array.string.ts"],"names":[],"mappings":";;;AAAA,mCAAuC;AACvC,2CAA+C;AAC/C,iDAAoD;AAEpD,sCAAkD;AAElD,SAAgB,4BAA4B,CAAC,MAAgB;IAC3D,OAAO,MAAM,CAAC,GAAG,CAAS,8BAAqB,CAAC,CAAC;AACnD,CAAC;AAFD,oEAEC;AAED,SAAgB,4BAA4B,CAAC,MAAgB;IAC3D,OAAO,KAAK,CAAC,IAAI,CAAC,+BAA+B,CAAC,MAAM,CAAC,CAAC,CAAC;AAC7D,CAAC;AAFD,oEAEC;AAED,SAAgB,+BAA+B,CAAC,MAAgB;IAC9D,OAAO,IAAI,GAAG,CAAC,4BAA4B,CAAC,MAAM,CAAC,CAAC,CAAC;AACvD,CAAC;AAFD,0EAEC;AAED,SAAgB,wCAAwC,CAAC,KAAiB;IACxE,OAAO,IAAA,qBAAM,EAAC,IAAA,oBAAY,EAAS,KAAK,CAAC,CAAC,GAAG,CAAS,8BAAqB,CAAC,CAAC,CAAC;AAChF,CAAC;AAFD,4FAEC;AAED,SAAgB,gCAAgC,CAA+B,MAAW,EAAE,OAA8B,EAAE,iBAAsB,EAAE;IAClJ,OAAO,IAAA,yBAAU,EAAC,MAAM,EAAE,CAAC,CAAI,EAAE,EAAE,CAAC,IAAA,8BAAqB,EAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,4BAA4B,CAAC,cAAc,CAAC,CAAC,CAAC;AACvH,CAAC;AAFD,4EAEC;AAED,SAAgB,qBAAqB,CAAC,MAAgB,EAAE,WAAmB;IACzE,OAAO,wBAAwB,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;AACzD,CAAC;AAFD,sDAEC;AAED,SAAgB,wBAAwB,CAAC,MAAgB,EAAE,YAAsB;IAC/E,OAAO,IAAA,4BAAgB,EAAC,4BAA4B,CAAC,MAAM,CAAC,EAAE,4BAA4B,CAAC,YAAY,CAAC,CAAC,CAAC;AAC5G,CAAC;AAFD,4DAEC"}

package/src/lib/array/array.unique.d.ts

@@ -0,0 +1,6 @@
+import { PrimativeKey, ReadKeyFunction } from "../key";
+import { Maybe } from "../value";
+export declare function concatArraysUnique<T extends PrimativeKey = PrimativeKey>(...arrays: (Maybe<T[]>)[]): T[];
+export declare function flattenArrayUnique<T extends PrimativeKey = PrimativeKey>(array: T[][]): T[];
+export declare function unique<T extends PrimativeKey = PrimativeKey>(values: T[]): T[];
+export declare function findUnique<T, K extends PrimativeKey = PrimativeKey>(models: T[], readKey: ReadKeyFunction<T, K>, additionalKeys?: K[]): T[];

package/src/lib/array/array.unique.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findUnique = exports.unique = exports.flattenArrayUnique = exports.concatArraysUnique = void 0;
+const array_1 = require("./array");
+function concatArraysUnique(...arrays) {
+    return unique((0, array_1.concatArrays)(...arrays));
+}
+exports.concatArraysUnique = concatArraysUnique;
+function flattenArrayUnique(array) {
+    return unique((0, array_1.flattenArray)(array));
+}
+exports.flattenArrayUnique = flattenArrayUnique;
+function unique(values) {
+    return Array.from(new Set(values));
+}
+exports.unique = unique;
+function findUnique(models, readKey, additionalKeys = []) {
+    const keys = new Set(additionalKeys);
+    return models.filter((x) => {
+        const key = readKey(x);
+        if (!keys.has(key)) {
+            keys.add(key);
+            return true;
+        }
+        return false;
+    });
+}
+exports.findUnique = findUnique;
+//# sourceMappingURL=array.unique.js.map

package/src/lib/array/array.unique.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"array.unique.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/array/array.unique.ts"],"names":[],"mappings":";;;AAAA,mCAAqD;AAIrD,SAAgB,kBAAkB,CAAwC,GAAG,MAAsB;IACjG,OAAO,MAAM,CAAC,IAAA,oBAAY,EAAC,GAAG,MAAM,CAAC,CAAC,CAAC;AACzC,CAAC;AAFD,gDAEC;AAED,SAAgB,kBAAkB,CAAwC,KAAY;IACpF,OAAO,MAAM,CAAC,IAAA,oBAAY,EAAC,KAAK,CAAC,CAAC,CAAC;AACrC,CAAC;AAFD,gDAEC;AAED,SAAgB,MAAM,CAAwC,MAAW;IACvE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AACrC,CAAC;AAFD,wBAEC;AAED,SAAgB,UAAU,CAA2C,MAAW,EAAE,OAA8B,EAAE,iBAAsB,EAAE;IACxI,MAAM,IAAI,GAAG,IAAI,GAAG,CAAW,cAAc,CAAC,CAAC;IAE/C,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QACzB,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QAEvB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;YAClB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,OAAO,IAAI,CAAC;SACb;QAED,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC;AAbD,gCAaC"}

package/src/lib/array/array.value.d.ts

@@ -0,0 +1,3 @@
+import { Maybe } from "@dereekb/util";
+export declare function filterMaybeValues<T>(values: Maybe<Maybe<T>[]>): T[];
+export declare function filterMaybeValuesFn<T>(value: Maybe<T>): value is T;

package/src/lib/array/array.value.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.filterMaybeValuesFn = exports.filterMaybeValues = void 0;
+function filterMaybeValues(values) {
+    if (values) {
+        return values.filter(filterMaybeValuesFn);
+    }
+    else {
+        return [];
+    }
+}
+exports.filterMaybeValues = filterMaybeValues;
+function filterMaybeValuesFn(value) {
+    return value != null;
+}
+exports.filterMaybeValuesFn = filterMaybeValuesFn;
+//# sourceMappingURL=array.value.js.map

package/src/lib/array/array.value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"array.value.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/array/array.value.ts"],"names":[],"mappings":";;;AAEA,SAAgB,iBAAiB,CAAI,MAAyB;IAC5D,IAAI,MAAM,EAAE;QACV,OAAO,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;KAC3C;SAAM;QACL,OAAO,EAAE,CAAC;KACX;AACH,CAAC;AAND,8CAMC;AAED,SAAgB,mBAAmB,CAAI,KAAe;IACpD,OAAO,KAAK,IAAI,IAAI,CAAC;AACvB,CAAC;AAFD,kDAEC"}

package/src/lib/array/index.d.ts

@@ -0,0 +1,10 @@
+export * from './array.boolean';
+export * from './array.filter';
+export * from './array.limit';
+export * from './array.map';
+export * from './array.number';
+export * from './array.set';
+export * from './array.string';
+export * from './array';
+export * from './array.unique';
+export * from './array.value';

package/src/lib/array/index.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+(0, tslib_1.__exportStar)(require("./array.boolean"), exports);
+(0, tslib_1.__exportStar)(require("./array.filter"), exports);
+(0, tslib_1.__exportStar)(require("./array.limit"), exports);
+(0, tslib_1.__exportStar)(require("./array.map"), exports);
+(0, tslib_1.__exportStar)(require("./array.number"), exports);
+(0, tslib_1.__exportStar)(require("./array.set"), exports);
+(0, tslib_1.__exportStar)(require("./array.string"), exports);
+(0, tslib_1.__exportStar)(require("./array"), exports);
+(0, tslib_1.__exportStar)(require("./array.unique"), exports);
+(0, tslib_1.__exportStar)(require("./array.value"), exports);
+//# sourceMappingURL=index.js.map

package/src/lib/array/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/array/index.ts"],"names":[],"mappings":";;;AAAA,+DAAgC;AAChC,8DAA+B;AAC/B,6DAA8B;AAC9B,2DAA4B;AAC5B,8DAA+B;AAC/B,2DAA4B;AAC5B,8DAA+B;AAC/B,uDAAwB;AACxB,8DAA+B;AAC/B,6DAA8B"}

package/src/lib/assertion/assert.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Interface for configuring a Description Assertion
+ */
+export interface DescriptorAssertionOptions {
+    message?: string;
+}
+/**
+ * DescriptorAssertionOptions extension that also maps one value to another.
+ */
+export interface MapDescriptorAssertionOptions<T> extends DescriptorAssertionOptions {
+    /**
+     * Maps the value after it has been validated.
+     */
+    map?: (value: T) => T;
+}

package/src/lib/assertion/assert.error.d.ts

@@ -0,0 +1,32 @@
+import { ReadableError } from '../error';
+import { BaseError } from 'make-error';
+import { DescriptorAssertionOptions } from "./assert";
+export interface AssertionIssue {
+    /**
+     * Object that encoundered the issue.
+     */
+    target: object;
+    /**
+     * Property that
+     */
+    propertyKey: string;
+    options?: DescriptorAssertionOptions;
+}
+export declare const ASSERTION_ERROR_CODE = "DBX_ASSERTION_ERROR";
+export declare class AssertionError extends BaseError implements ReadableError {
+    readonly code = "DBX_ASSERTION_ERROR";
+    private _target;
+    private _property;
+    constructor(error: {
+        target: object;
+        propertyKey: string;
+    }, message: string);
+    get target(): object;
+    get propertyKey(): string;
+}
+export declare class AssertionIssueHandler {
+    handle(error: AssertionIssue): void;
+    buildException(error: AssertionIssue): AssertionError;
+    protected buildExceptionString(error: AssertionIssue): string;
+}
+export declare const ASSERTION_HANDLER: AssertionIssueHandler;

package/src/lib/assertion/assert.error.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ASSERTION_HANDLER = exports.AssertionIssueHandler = exports.AssertionError = exports.ASSERTION_ERROR_CODE = void 0;
+const make_error_1 = require("make-error");
+exports.ASSERTION_ERROR_CODE = 'DBX_ASSERTION_ERROR';
+class AssertionError extends make_error_1.BaseError {
+    constructor(error, message) {
+        super(message);
+        this.code = exports.ASSERTION_ERROR_CODE;
+        this.name = 'AssertionError';
+        this._target = error.target;
+        this._property = error.propertyKey;
+    }
+    get target() {
+        return this._target;
+    }
+    get propertyKey() {
+        return this._property;
+    }
+}
+exports.AssertionError = AssertionError;
+class AssertionIssueHandler {
+    handle(error) {
+        throw this.buildException(error);
+    }
+    buildException(error) {
+        const message = this.buildExceptionString(error);
+        return new AssertionError(error, message);
+    }
+    buildExceptionString(error) {
+        let message;
+        if (error.options && error.options.message) {
+            message = error.options.message;
+        }
+        else {
+            message = 'Assertion failed for property \'' + error.propertyKey + '".';
+        }
+        return message;
+    }
+}
+exports.AssertionIssueHandler = AssertionIssueHandler;
+exports.ASSERTION_HANDLER = new AssertionIssueHandler(); // TODO: Allow changing, if needed.
+//# sourceMappingURL=assert.error.js.map

package/src/lib/assertion/assert.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert.error.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/assertion/assert.error.ts"],"names":[],"mappings":";;;AACA,2CAAuC;AAe1B,QAAA,oBAAoB,GAAG,qBAAqB,CAAC;AAE1D,MAAa,cAAe,SAAQ,sBAAS;IAO3C,YAAY,KAA8C,EAAE,OAAe;QACzE,KAAK,CAAC,OAAO,CAAC,CAAC;QANR,SAAI,GAAG,4BAAoB,CAAC;QAOnC,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,WAAW,CAAC;IACrC,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;CAEF;AAtBD,wCAsBC;AAED,MAAa,qBAAqB;IAEzB,MAAM,CAAC,KAAqB;QACjC,MAAM,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAEM,cAAc,CAAC,KAAqB;QACzC,MAAM,OAAO,GAAW,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;QACzD,OAAO,IAAI,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IAES,oBAAoB,CAAC,KAAqB;QAClD,IAAI,OAAe,CAAC;QAEpB,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE;YAC1C,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;SACjC;aAAM;YACL,OAAO,GAAG,kCAAkC,GAAG,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC;SACzE;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;CAEF;AAvBD,sDAuBC;AAEY,QAAA,iBAAiB,GAA0B,IAAI,qBAAqB,EAAE,CAAC,CAAC,mCAAmC"}

package/src/lib/assertion/assert.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=assert.js.map

package/src/lib/assertion/assert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/assertion/assert.ts"],"names":[],"mappings":""}

package/src/lib/assertion/assertion.d.ts

@@ -0,0 +1,18 @@
+import { MapDescriptorAssertionOptions } from "./assert";
+/**
+ * Assertion function type.
+ *
+ * Returns true if the assertion passes.
+ */
+export declare type AccessorValueAssertion<T> = (value: T) => boolean;
+export interface SetValueInterceptorFunctionInput<T> {
+    target: object;
+    propertyKey: string;
+    descriptor: TypedPropertyDescriptor<T>;
+    setValue: (value: T) => void;
+}
+export declare type SetValueInterceptorFunctionFactory<T> = (input: SetValueInterceptorFunctionInput<T>) => ((value: T) => void);
+export declare class PropertyDescriptorUtility {
+    static makePropertyDescriptorAssertion<T>(assertValueFn: AccessorValueAssertion<T>, options?: MapDescriptorAssertionOptions<T>, defaultOptions?: MapDescriptorAssertionOptions<T>): (target: object, propertyKey: string, descriptor: TypedPropertyDescriptor<T>) => void;
+    static makeSetPropertyDescriptorInterceptor<T>(makeSetValueInterceptorFn: SetValueInterceptorFunctionFactory<T>): (target: object, propertyKey: string, descriptor: TypedPropertyDescriptor<T>) => void;
+}

package/src/lib/assertion/assertion.generic.d.ts

@@ -0,0 +1,3 @@
+import { MapDescriptorAssertionOptions } from "./assert";
+import { AccessorValueAssertion } from "./assertion";
+export declare function Assert<T>(assertion: AccessorValueAssertion<T>, options?: MapDescriptorAssertionOptions<T>): (target: object, propertyKey: string, descriptor: TypedPropertyDescriptor<T>) => void;

package/src/lib/assertion/assertion.generic.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Assert = void 0;
+const assertion_1 = require("./assertion");
+// MARK: Generic
+function Assert(assertion, options) {
+    return assertion_1.PropertyDescriptorUtility.makePropertyDescriptorAssertion(assertion, options);
+}
+exports.Assert = Assert;
+//# sourceMappingURL=assertion.generic.js.map

package/src/lib/assertion/assertion.generic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertion.generic.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/assertion/assertion.generic.ts"],"names":[],"mappings":";;;AACA,2CAAgF;AAEhF,gBAAgB;AAChB,SAAgB,MAAM,CAAI,SAAoC,EAAE,OAA0C;IACxG,OAAO,qCAAyB,CAAC,+BAA+B,CAAI,SAAS,EAAE,OAAO,CAAC,CAAC;AAC1F,CAAC;AAFD,wBAEC"}

package/src/lib/assertion/assertion.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PropertyDescriptorUtility = void 0;
+const assert_error_1 = require("./assert.error");
+class PropertyDescriptorUtility {
+    static makePropertyDescriptorAssertion(assertValueFn, options, defaultOptions) {
+        // Build options
+        options = Object.assign(Object.assign({}, defaultOptions), options);
+        return this.makeSetPropertyDescriptorInterceptor(({ target, propertyKey, setValue }) => {
+            const map = (options === null || options === void 0 ? void 0 : options.map) || ((x) => x);
+            return function (value) {
+                if (assertValueFn(value)) {
+                    const mappedValue = map(value);
+                    setValue.call(this, mappedValue); // TODO: "this" may not be necessary here, if setValue is expected to always be an arrow function.
+                }
+                else {
+                    const error = { target, propertyKey, options };
+                    assert_error_1.ASSERTION_HANDLER.handle(error);
+                }
+            };
+        });
+    }
+    static makeSetPropertyDescriptorInterceptor(makeSetValueInterceptorFn) {
+        const interceptor = (target, propertyKey, descriptor) => {
+            if (descriptor.set) {
+                const setValue = descriptor.set;
+                // Override set function with assertion.
+                descriptor.set = makeSetValueInterceptorFn({
+                    target,
+                    propertyKey,
+                    descriptor,
+                    setValue
+                });
+            }
+        };
+        return interceptor;
+    }
+}
+exports.PropertyDescriptorUtility = PropertyDescriptorUtility;
+//# sourceMappingURL=assertion.js.map

package/src/lib/assertion/assertion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertion.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/assertion/assertion.ts"],"names":[],"mappings":";;;AACA,iDAAmE;AAqBnE,MAAa,yBAAyB;IAEpC,MAAM,CAAC,+BAA+B,CAAI,aAAwC,EAAE,OAA0C,EAAE,cAAiD;QAE/K,gBAAgB;QAChB,OAAO,mCACF,cAAc,GACd,OAAO,CACX,CAAC;QAEF,OAAO,IAAI,CAAC,oCAAoC,CAAI,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,EAAE,EAAE;YACxF,MAAM,GAAG,GAAG,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,GAAG,KAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;YAEvC,OAAO,UAAqB,KAAQ;gBAClC,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE;oBACxB,MAAM,WAAW,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;oBAC/B,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,kGAAkG;iBACrI;qBAAM;oBACL,MAAM,KAAK,GAAmB,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;oBAC/D,gCAAiB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;iBACjC;YACH,CAAC,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,oCAAoC,CAAI,yBAAgE;QAC7G,MAAM,WAAW,GAAG,CAAC,MAAc,EAAE,WAAmB,EAAE,UAAsC,EAAE,EAAE;YAClG,IAAI,UAAU,CAAC,GAAG,EAAE;gBAClB,MAAM,QAAQ,GAA2B,UAAU,CAAC,GAAG,CAAC;gBAExD,wCAAwC;gBACxC,UAAU,CAAC,GAAG,GAAG,yBAAyB,CAAC;oBACzC,MAAM;oBACN,WAAW;oBACX,UAAU;oBACV,QAAQ;iBACT,CAAC,CAAC;aACJ;QACH,CAAC,CAAC;QACF,OAAO,WAAW,CAAC;IACrB,CAAC;CAEF;AA1CD,8DA0CC"}

package/src/lib/assertion/assertion.number.d.ts

@@ -0,0 +1,3 @@
+import { DescriptorAssertionOptions } from "./assert";
+export declare function AssertMin(min: number, options?: DescriptorAssertionOptions): (target: object, propertyKey: string, descriptor: TypedPropertyDescriptor<number>) => void;
+export declare function AssertMax(max: number, options?: DescriptorAssertionOptions): (target: object, propertyKey: string, descriptor: TypedPropertyDescriptor<number>) => void;

package/src/lib/assertion/assertion.number.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AssertMax = exports.AssertMin = void 0;
+const assertion_1 = require("./assertion");
+// MARK: Numbers
+function AssertMin(min, options) {
+    const DEFAULT_OPTIONS = { message: 'Value was less than the minimum "' + min + '".' };
+    return assertion_1.PropertyDescriptorUtility.makePropertyDescriptorAssertion((value) => {
+        return value >= min;
+    }, options, DEFAULT_OPTIONS);
+}
+exports.AssertMin = AssertMin;
+function AssertMax(max, options) {
+    const DEFAULT_OPTIONS = { message: 'Value was greater than the maximum "' + max + '".' };
+    return assertion_1.PropertyDescriptorUtility.makePropertyDescriptorAssertion((value) => {
+        return value <= max;
+    }, options, DEFAULT_OPTIONS);
+}
+exports.AssertMax = AssertMax;
+//# sourceMappingURL=assertion.number.js.map

package/src/lib/assertion/assertion.number.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertion.number.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/assertion/assertion.number.ts"],"names":[],"mappings":";;;AACA,2CAAwD;AAExD,gBAAgB;AAChB,SAAgB,SAAS,CAAC,GAAW,EAAE,OAAoC;IACzE,MAAM,eAAe,GAAG,EAAE,OAAO,EAAE,mCAAmC,GAAG,GAAG,GAAG,IAAI,EAAE,CAAC;IACtF,OAAO,qCAAyB,CAAC,+BAA+B,CAAS,CAAC,KAAa,EAAE,EAAE;QACzF,OAAO,KAAK,IAAI,GAAG,CAAC;IACtB,CAAC,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC;AAC/B,CAAC;AALD,8BAKC;AAED,SAAgB,SAAS,CAAC,GAAW,EAAE,OAAoC;IACzE,MAAM,eAAe,GAAG,EAAE,OAAO,EAAE,sCAAsC,GAAG,GAAG,GAAG,IAAI,EAAE,CAAC;IACzF,OAAO,qCAAyB,CAAC,+BAA+B,CAAS,CAAC,KAAa,EAAE,EAAE;QACzF,OAAO,KAAK,IAAI,GAAG,CAAC;IACtB,CAAC,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC;AAC/B,CAAC;AALD,8BAKC"}

package/src/lib/assertion/index.d.ts

@@ -0,0 +1,5 @@
+export * from './assert.error';
+export * from './assert';
+export * from './assertion.generic';
+export * from './assertion.number';
+export * from './assertion';

package/src/lib/assertion/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+(0, tslib_1.__exportStar)(require("./assert.error"), exports);
+(0, tslib_1.__exportStar)(require("./assert"), exports);
+(0, tslib_1.__exportStar)(require("./assertion.generic"), exports);
+(0, tslib_1.__exportStar)(require("./assertion.number"), exports);
+(0, tslib_1.__exportStar)(require("./assertion"), exports);
+//# sourceMappingURL=index.js.map

package/src/lib/assertion/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/assertion/index.ts"],"names":[],"mappings":";;;AAAA,8DAA+B;AAC/B,wDAAyB;AACzB,mEAAoC;AACpC,kEAAmC;AACnC,2DAA4B"}

package/src/lib/boolean.d.ts

@@ -0,0 +1,5 @@
+export declare function reduceBooleansWithAnd(array: boolean[], emptyArrayValue?: boolean): boolean;
+export declare function reduceBooleansWithOr(array: boolean[], emptyArrayValue?: boolean): boolean;
+export declare function reduceBooleansWithAndFn(emptyArrayValue?: boolean): (array: boolean[]) => boolean;
+export declare function reduceBooleansWithOrFn(emptyArrayValue?: boolean): (array: boolean[]) => boolean;
+export declare function reduceBooleansFn(reduceFn: ((a: boolean, b: boolean) => boolean), emptyArrayValue?: boolean): (array: boolean[]) => boolean;

package/src/lib/boolean.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reduceBooleansFn = exports.reduceBooleansWithOrFn = exports.reduceBooleansWithAndFn = exports.reduceBooleansWithOr = exports.reduceBooleansWithAnd = void 0;
+function reduceBooleansWithAnd(array, emptyArrayValue) {
+    return reduceBooleansWithAndFn(emptyArrayValue)(array);
+}
+exports.reduceBooleansWithAnd = reduceBooleansWithAnd;
+function reduceBooleansWithOr(array, emptyArrayValue) {
+    return reduceBooleansWithOrFn(emptyArrayValue)(array);
+}
+exports.reduceBooleansWithOr = reduceBooleansWithOr;
+function reduceBooleansWithAndFn(emptyArrayValue) {
+    return reduceBooleansFn((a, b) => a && b, emptyArrayValue);
+}
+exports.reduceBooleansWithAndFn = reduceBooleansWithAndFn;
+function reduceBooleansWithOrFn(emptyArrayValue) {
+    return reduceBooleansFn((a, b) => a || b, emptyArrayValue);
+}
+exports.reduceBooleansWithOrFn = reduceBooleansWithOrFn;
+function reduceBooleansFn(reduceFn, emptyArrayValue) {
+    const rFn = (array) => Boolean(array.reduce(reduceFn));
+    if (emptyArrayValue != null) {
+        return (array) => (array.length) ? rFn(array) : emptyArrayValue;
+    }
+    else {
+        return rFn;
+    }
+}
+exports.reduceBooleansFn = reduceBooleansFn;
+//# sourceMappingURL=boolean.js.map

package/src/lib/boolean.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boolean.js","sourceRoot":"","sources":["../../../../../packages/util/src/lib/boolean.ts"],"names":[],"mappings":";;;AACA,SAAgB,qBAAqB,CAAC,KAAgB,EAAE,eAAyB;IAC/E,OAAO,uBAAuB,CAAC,eAAe,CAAC,CAAC,KAAK,CAAC,CAAC;AACzD,CAAC;AAFD,sDAEC;AAED,SAAgB,oBAAoB,CAAC,KAAgB,EAAE,eAAyB;IAC9E,OAAO,sBAAsB,CAAC,eAAe,CAAC,CAAC,KAAK,CAAC,CAAC;AACxD,CAAC;AAFD,oDAEC;AAED,SAAgB,uBAAuB,CAAC,eAAyB;IAC/D,OAAO,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,eAAe,CAAC,CAAC;AAC7D,CAAC;AAFD,0DAEC;AAED,SAAgB,sBAAsB,CAAC,eAAyB;IAC9D,OAAO,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,eAAe,CAAC,CAAC;AAC7D,CAAC;AAFD,wDAEC;AAED,SAAgB,gBAAgB,CAAC,QAA+C,EAAE,eAAyB;IACzG,MAAM,GAAG,GAAG,CAAC,KAAgB,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;IAElE,IAAI,eAAe,IAAI,IAAI,EAAE;QAC3B,OAAO,CAAC,KAAgB,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC;KAC5E;SAAM;QACL,OAAO,GAAG,CAAC;KACZ;AACH,CAAC;AARD,4CAQC"}

package/src/lib/contact/domain.d.ts

@@ -0,0 +1,16 @@
+import { EmailAddress } from "./email";
+export declare type EmailAddressDomain = string;
+export declare function readDomainsFromEmailAddresses(addresses: EmailAddress[]): EmailAddressDomain[];
+export declare function readDomainFromEmailAddress(address: EmailAddress): EmailAddressDomain;
+/**
+ * Reads a domain from the input that can be formatted as
+ *
+ * - A url: www.test.com,
+ * - A url with the protocol (://): https://www.test.com
+ * - An email address: test@test.com
+ * - A domain: test.com
+ *
+ * @param urlLikeInput
+ * @returns The domain
+ */
+export declare function readDomainFromUrlOrEmailAddress(urlLikeInput: string | EmailAddress | EmailAddressDomain): EmailAddressDomain;

package/src/lib/contact/domain.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readDomainFromUrlOrEmailAddress = exports.readDomainFromEmailAddress = exports.readDomainsFromEmailAddresses = void 0;
+const array_1 = require("../array");
+function readDomainsFromEmailAddresses(addresses) {
+    return (0, array_1.uniqueCaseInsensitiveStrings)(addresses.map(readDomainFromEmailAddress));
+}
+exports.readDomainsFromEmailAddresses = readDomainsFromEmailAddresses;
+function readDomainFromEmailAddress(address) {
+    const split = address.split('@');
+    const domain = split[1];
+    return domain.toLowerCase();
+}
+exports.readDomainFromEmailAddress = readDomainFromEmailAddress;
+/**
+ * Reads a domain from the input that can be formatted as
+ *
+ * - A url: www.test.com,
+ * - A url with the protocol (://): https://www.test.com
+ * - An email address: test@test.com
+ * - A domain: test.com
+ *
+ * @param urlLikeInput
+ * @returns The domain
+ */
+function readDomainFromUrlOrEmailAddress(urlLikeInput) {
+    const emailSplit = urlLikeInput.split('@');
+    const url = emailSplit[emailSplit.length - 1];
+    let domain;
+    if (emailSplit.length > 1) {
+        domain = url;
+    }
+    else {
+        const httpSplit = urlLikeInput.split('://');
+        domain = httpSplit[httpSplit.length - 1];
+        // strip out www. if it is provided, as it is a 'special' domain type,
+        // and emails probably don't come from there.
+        if (domain.startsWith('www')) {
+            domain = domain.split('www.', 2)[1];
+        }
+    }
+    return domain;
+}
+exports.readDomainFromUrlOrEmailAddress = readDomainFromUrlOrEmailAddress;
+//# sourceMappingURL=domain.js.map

package/src/lib/contact/domain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/contact/domain.ts"],"names":[],"mappings":";;;AAAA,oCAAgF;AAKhF,SAAgB,6BAA6B,CAAC,SAAyB;IACrE,OAAO,IAAA,oCAA4B,EAAC,SAAS,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC,CAAC;AACjF,CAAC;AAFD,sEAEC;AAED,SAAgB,0BAA0B,CAAC,OAAqB;IAC9D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjC,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACxB,OAAO,MAAM,CAAC,WAAW,EAAE,CAAC;AAC9B,CAAC;AAJD,gEAIC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,+BAA+B,CAAC,YAAwD;IACtG,MAAM,UAAU,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3C,MAAM,GAAG,GAAG,UAAU,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAE9C,IAAI,MAAM,CAAC;IAEX,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE;QACzB,MAAM,GAAG,GAAG,CAAC;KACd;SAAM;QACL,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAEzC,sEAAsE;QACtE,6CAA6C;QAC7C,IAAI,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE;YAC5B,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SACrC;KACF;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AApBD,0EAoBC"}

package/src/lib/contact/email.d.ts

@@ -0,0 +1,17 @@
+export declare type EmailAddress = string;
+export interface NameEmailPair {
+    name?: string;
+    email: EmailAddress;
+}
+export interface EmailParticipant extends NameEmailPair {
+}
+/**
+ * Email participant string. Starts with the email, followed by the name if available.
+ */
+export declare type EmailParticipantString = string;
+export declare function convertParticipantToEmailParticipantString(participant: EmailParticipant): EmailParticipantString;
+export declare function convertEmailParticipantStringToParticipant(participantString: EmailParticipantString): EmailParticipant;
+export declare function coerceToEmailParticipants({ participants, emails }: {
+    participants?: EmailParticipant[];
+    emails?: EmailAddress[];
+}): EmailParticipant[];