@dereekb/util 0.0.1

package/src/lib/contact/email.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.coerceToEmailParticipants = exports.convertEmailParticipantStringToParticipant = exports.convertParticipantToEmailParticipantString = void 0;
+const array_1 = require("../array");
+function convertParticipantToEmailParticipantString(participant) {
+    var _a, _b;
+    return `${(_b = (_a = participant.name) === null || _a === void 0 ? void 0 : _a.trim()) !== null && _b !== void 0 ? _b : ''}<${participant.email}>`;
+}
+exports.convertParticipantToEmailParticipantString = convertParticipantToEmailParticipantString;
+function convertEmailParticipantStringToParticipant(participantString) {
+    const split = participantString.split('<');
+    const name = split[0] || undefined;
+    const email = split[1].substring(0, split[1].length - 1);
+    return {
+        name,
+        email
+    };
+}
+exports.convertEmailParticipantStringToParticipant = convertEmailParticipantStringToParticipant;
+function coerceToEmailParticipants({ participants = [], emails = [] }) {
+    var _a;
+    if (!(emails === null || emails === void 0 ? void 0 : emails.length)) {
+        return participants;
+    }
+    else {
+        const participantEmails = (_a = participants === null || participants === void 0 ? void 0 : participants.map(x => x.email)) !== null && _a !== void 0 ? _a : [];
+        const emailsWithoutParticipants = (0, array_1.excludeValuesFromArray)(emails, participantEmails);
+        return participants.concat(emailsWithoutParticipants.map(email => ({ email })));
+    }
+}
+exports.coerceToEmailParticipants = coerceToEmailParticipants;
+//# sourceMappingURL=email.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"email.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/contact/email.ts"],"names":[],"mappings":";;;AAAA,oCAAkD;AAgBlD,SAAgB,0CAA0C,CAAC,WAA6B;;IACtF,OAAO,GAAG,MAAA,MAAA,WAAW,CAAC,IAAI,0CAAE,IAAI,EAAE,mCAAI,EAAE,IAAI,WAAW,CAAC,KAAK,GAAG,CAAC;AACnE,CAAC;AAFD,gGAEC;AAED,SAAgB,0CAA0C,CAAC,iBAAyC;IAClG,MAAM,KAAK,GAAG,iBAAiB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;IACnC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACzD,OAAO;QACL,IAAI;QACJ,KAAK;KACN,CAAC;AACJ,CAAC;AARD,gGAQC;AAED,SAAgB,yBAAyB,CAAC,EAAE,YAAY,GAAG,EAAE,EAAE,MAAM,GAAG,EAAE,EAAkE;;IAC1I,IAAI,CAAC,CAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,MAAM,CAAA,EAAE;QACnB,OAAO,YAAY,CAAC;KACrB;SAAM;QACL,MAAM,iBAAiB,GAAG,MAAA,YAAY,aAAZ,YAAY,uBAAZ,YAAY,CAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,mCAAI,EAAE,CAAC;QAChE,MAAM,yBAAyB,GAAG,IAAA,8BAAsB,EAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;QACpF,OAAO,YAAY,CAAC,MAAM,CAAC,yBAAyB,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;KACjF;AACH,CAAC;AARD,8DAQC"}

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

@@ -0,0 +1,3 @@
+export * from './domain';
+export * from './email';
+export * from './phone';

package/src/lib/contact/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+(0, tslib_1.__exportStar)(require("./domain"), exports);
+(0, tslib_1.__exportStar)(require("./email"), exports);
+(0, tslib_1.__exportStar)(require("./phone"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/contact/index.ts"],"names":[],"mappings":";;;AAAA,wDAAyB;AACzB,uDAAwB;AACxB,uDAAwB"}

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

@@ -0,0 +1,8 @@
+/**
+ * Phone number string input. No format specified.
+ */
+export declare type PhoneNumber = string;
+/**
+ * E.164 Standardized Phone Number
+ */
+export declare type E164PhoneNumber = string;

package/src/lib/contact/phone.js

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

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

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

package/src/lib/context/context.d.ts

@@ -0,0 +1 @@
+export {};

package/src/lib/context/context.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// export type UseContext<T>
+// export interface Context extends Initialized, Destroyable {}
+// export type ContextFactory<T> = () => Context<T>;
+//# sourceMappingURL=context.js.map

package/src/lib/context/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/context/context.ts"],"names":[],"mappings":";;AAEA,4BAA4B;AAE5B,+DAA+D;AAE/D,oDAAoD"}

package/src/lib/context/index.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=index.js.map

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

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

package/src/lib/date/date.d.ts

@@ -0,0 +1,52 @@
+import { Maybe } from "../value";
+/**
+ * A valid ISO8601 formatted date string.
+ */
+export declare type ISO8601DateString = string;
+/**
+ * A full ISO8601 date string that is in UTC.
+ *
+ * I.E. 2020-04-30T00:00:00.000Z
+ */
+export declare type ISO8601DateStringUTCFull = string;
+/**
+ * A valid timezone string.
+ */
+export declare type TimezoneString = string;
+export declare const UTC_TIMEZONE_STRING = "UTC";
+/**
+ * Whether or not the input timezone string is considered UTC.
+ *
+ * @param timezone
+ * @returns
+ */
+export declare function isConsideredUtcTimezoneString(timezone: Maybe<TimezoneString>): boolean;
+export declare function isConsideredUtcTimezoneString(timezone: TimezoneString): boolean;
+export declare function isConsideredUtcTimezoneString(timezone: 'UTC'): true;
+export declare function isConsideredUtcTimezoneString(timezone: null): true;
+export declare function isConsideredUtcTimezoneString(timezone: undefined): true;
+/**
+ * A Date or an ISO8601DateString.
+ */
+export declare type DateOrDateString = Date | ISO8601DateString;
+/**
+ * A full date string Formatted as ISO8601.
+ *
+ * I.E. 1921-06-23
+ */
+export declare type ISO8601DayString = string;
+/**
+ * Time in seconds (instead of ms) since the epoch.
+ */
+export declare type UnixDateTimeNumber = number;
+/**
+ * A date or a unix timestamp
+ */
+export declare type DateOrUnixDateTimeNumber = Date | UnixDateTimeNumber;
+export declare type Seconds = number;
+export declare type Minutes = number;
+export declare type Hours = number;
+export declare type Days = number;
+export declare const MINUTES_IN_DAY = 1440;
+export declare const MS_IN_MINUTE: number;
+export declare const MS_IN_HOUR: number;

package/src/lib/date/date.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MS_IN_HOUR = exports.MS_IN_MINUTE = exports.MINUTES_IN_DAY = exports.isConsideredUtcTimezoneString = exports.UTC_TIMEZONE_STRING = void 0;
+exports.UTC_TIMEZONE_STRING = 'UTC';
+function isConsideredUtcTimezoneString(timezone) {
+    return (timezone == null || timezone === exports.UTC_TIMEZONE_STRING);
+}
+exports.isConsideredUtcTimezoneString = isConsideredUtcTimezoneString;
+exports.MINUTES_IN_DAY = 1440;
+exports.MS_IN_MINUTE = 1000 * 60;
+exports.MS_IN_HOUR = exports.MS_IN_MINUTE * 60;
+//# sourceMappingURL=date.js.map

package/src/lib/date/date.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/date/date.ts"],"names":[],"mappings":";;;AAmBa,QAAA,mBAAmB,GAAG,KAAK,CAAC;AAazC,SAAgB,6BAA6B,CAAC,QAA+B;IAC3E,OAAO,CAAC,QAAQ,IAAI,IAAI,IAAI,QAAQ,KAAK,2BAAmB,CAAC,CAAC;AAChE,CAAC;AAFD,sEAEC;AA6BY,QAAA,cAAc,GAAG,IAAI,CAAC;AACtB,QAAA,YAAY,GAAG,IAAI,GAAG,EAAE,CAAC;AACzB,QAAA,UAAU,GAAG,oBAAY,GAAG,EAAE,CAAC"}

package/src/lib/date/date.time.d.ts

@@ -0,0 +1,29 @@
+import { Maybe } from "../value";
+/**
+ * Represents a string for a time. This may be human-input, and
+ * can be interpreted in various ways depending on the input.
+ *
+ * Examples:
+ * - 1:20AM
+ * - 1:20
+ * - 120AM
+ * - 120
+ */
+export declare type ReadableTimeString = string;
+export declare enum TimeAM {
+    AM = "AM",
+    PM = "PM"
+}
+export declare type DateNow = 'now';
+export declare const DATE_NOW_VALUE = "now";
+/**
+ * A date that is characterized by either a known string value, or a Date.
+ */
+export declare type LogicalDate = Date | DateNow;
+/**
+ * Returns a Date value from the input LogicalDate.
+ *
+ * @param logicalDate
+ */
+export declare function dateFromLogicalDate(logicalDate: Maybe<LogicalDate>): Maybe<Date>;
+export declare function dateFromLogicalDate(logicalDate: LogicalDate): Date;

package/src/lib/date/date.time.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dateFromLogicalDate = exports.DATE_NOW_VALUE = exports.TimeAM = void 0;
+var TimeAM;
+(function (TimeAM) {
+    TimeAM["AM"] = "AM";
+    TimeAM["PM"] = "PM";
+})(TimeAM = exports.TimeAM || (exports.TimeAM = {}));
+exports.DATE_NOW_VALUE = 'now';
+function dateFromLogicalDate(logicalDate) {
+    let result;
+    if (typeof logicalDate === 'string') {
+        switch (logicalDate.toLocaleLowerCase()) {
+            case exports.DATE_NOW_VALUE:
+                result = new Date();
+                break;
+            default:
+                throw new Error(`Unknown logical date string "${logicalDate}"`);
+        }
+    }
+    else {
+        result = logicalDate;
+    }
+    return result;
+}
+exports.dateFromLogicalDate = dateFromLogicalDate;
+//# sourceMappingURL=date.time.js.map

package/src/lib/date/date.time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.time.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/date/date.time.ts"],"names":[],"mappings":";;;AAcA,IAAY,MAGX;AAHD,WAAY,MAAM;IAChB,mBAAS,CAAA;IACT,mBAAS,CAAA;AACX,CAAC,EAHW,MAAM,GAAN,cAAM,KAAN,cAAM,QAGjB;AAGY,QAAA,cAAc,GAAG,KAAK,CAAC;AAcpC,SAAgB,mBAAmB,CAAC,WAA+B;IACjE,IAAI,MAAM,CAAC;IAEX,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE;QACnC,QAAQ,WAAW,CAAC,iBAAiB,EAAE,EAAE;YACvC,KAAK,sBAAc;gBACjB,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACpB,MAAM;YACR;gBACE,MAAM,IAAI,KAAK,CAAC,gCAAgC,WAAW,GAAG,CAAC,CAAC;SACnE;KACF;SAAM;QACL,MAAM,GAAG,WAAW,CAAC;KACtB;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAhBD,kDAgBC"}

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

@@ -0,0 +1,2 @@
+export * from './date';
+export * from './date.time';

package/src/lib/date/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+(0, tslib_1.__exportStar)(require("./date"), exports);
+(0, tslib_1.__exportStar)(require("./date.time"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/date/index.ts"],"names":[],"mappings":";;;AAAA,sDAAuB;AACvB,2DAA4B"}

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

@@ -0,0 +1,30 @@
+/**
+ * A unique identifier for a specific error.
+ */
+export declare type StringErrorCode = string;
+/**
+ * An error that is identified by a unique code.
+ */
+export interface CodedError {
+    code: StringErrorCode;
+}
+/**
+ * An error with a human-readable message.
+ */
+export interface ReadableError extends Partial<CodedError> {
+    message: string;
+}
+export interface ReadableDataError<T = any> extends ReadableError {
+    data?: T;
+}
+export interface ErrorWrapper {
+    data: ReadableError | CodedError;
+}
+export declare type ErrorInput = ErrorWrapper | CodedError | ReadableError;
+/**
+ * Converts the input error content to a ReadableError or CodedError.
+ *
+ * @param inputError
+ * @returns
+ */
+export declare function convertToReadableError(inputError: ErrorInput | undefined): CodedError | ReadableError | undefined;

package/src/lib/error/error.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertToReadableError = void 0;
+const make_error_1 = require("make-error");
+/**
+ * Converts the input error content to a ReadableError or CodedError.
+ *
+ * @param inputError
+ * @returns
+ */
+function convertToReadableError(inputError) {
+    let error;
+    if (inputError) {
+        if (inputError.code) {
+            error = inputError;
+        }
+        else if (inputError.data) {
+            error = inputError.data;
+        }
+        else if (inputError instanceof make_error_1.BaseError) {
+            error = {
+                code: inputError.code || inputError.name,
+                message: inputError.message
+            };
+        }
+        else {
+            error = {
+                code: 'ERROR',
+                message: inputError.message || ''
+            };
+        }
+    }
+    return error;
+}
+exports.convertToReadableError = convertToReadableError;
+//# sourceMappingURL=error.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/error/error.ts"],"names":[],"mappings":";;;AAAA,2CAAuC;AAgCvC;;;;;GAKG;AACH,SAAgB,sBAAsB,CAAC,UAAkC;IACvE,IAAI,KAA6C,CAAC;IAElD,IAAI,UAAU,EAAE;QACd,IAAK,UAAyB,CAAC,IAAI,EAAE;YACnC,KAAK,GAAG,UAA2B,CAAC;SACrC;aAAM,IAAK,UAA2B,CAAC,IAAI,EAAE;YAC5C,KAAK,GAAI,UAA2B,CAAC,IAAqB,CAAC;SAC5D;aAAM,IAAI,UAAU,YAAY,sBAAS,EAAE;YAC1C,KAAK,GAAG;gBACN,IAAI,EAAG,UAAkB,CAAC,IAAI,IAAI,UAAU,CAAC,IAAI;gBACjD,OAAO,EAAE,UAAU,CAAC,OAAO;aAC5B,CAAC;SACH;aAAM;YACL,KAAK,GAAG;gBACN,IAAI,EAAE,OAAO;gBACb,OAAO,EAAG,UAAkB,CAAC,OAAO,IAAI,EAAE;aAC3C,CAAC;SACH;KACF;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAtBD,wDAsBC"}

package/src/lib/error/error.server.d.ts

@@ -0,0 +1,37 @@
+import { StringErrorCode, ReadableDataError } from './error';
+/**
+ * The expected error object returned from the server.
+ */
+export interface ServerErrorResponseData {
+    /**
+     * Unique identifier of the error returned, if available.
+     */
+    code?: StringErrorCode;
+    /**
+     * User-readable message of the error returned.
+     */
+    message?: string;
+    /**
+     * Additional keys/data returned in the error data.
+     */
+    [key: string]: any;
+}
+/**
+ * Human-readable server error with additional data and a status code.
+ */
+export interface ServerError<T = any> extends ReadableDataError<T> {
+    status: number;
+}
+/**
+ * Base server-error class.
+ */
+export declare class ServerErrorResponse<T extends ServerErrorResponseData = ServerErrorResponseData> implements ServerError<T> {
+    readonly code?: string;
+    readonly status: number;
+    readonly message: string;
+    readonly data?: T;
+    constructor({ code, status, data, message }: ServerError<T>);
+}
+export declare class UnauthorizedServerErrorResponse extends ServerErrorResponse {
+    constructor({ code, data, message }: Partial<ServerError>);
+}

package/src/lib/error/error.server.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UnauthorizedServerErrorResponse = exports.ServerErrorResponse = void 0;
+/**
+ * Base server-error class.
+ */
+class ServerErrorResponse {
+    constructor({ code, status, data, message }) {
+        this.code = code;
+        this.message = message;
+        this.status = status;
+        this.data = data;
+    }
+}
+exports.ServerErrorResponse = ServerErrorResponse;
+class UnauthorizedServerErrorResponse extends ServerErrorResponse {
+    constructor({ code, data, message }) {
+        super({ status: 401, message: message !== null && message !== void 0 ? message : 'Unauthorized', data, code });
+    }
+}
+exports.UnauthorizedServerErrorResponse = UnauthorizedServerErrorResponse;
+//# sourceMappingURL=error.server.js.map

package/src/lib/error/error.server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.server.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/error/error.server.ts"],"names":[],"mappings":";;;AA2BA;;GAEG;AACH,MAAa,mBAAmB;IAO9B,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAkB;QACzD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CAEF;AAdD,kDAcC;AAED,MAAa,+BAAgC,SAAQ,mBAAmB;IAEtE,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAwB;QACvD,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,cAAc,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACzE,CAAC;CAEF;AAND,0EAMC"}

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

@@ -0,0 +1,2 @@
+export * from './error.server';
+export * from './error';

package/src/lib/error/index.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/error/index.ts"],"names":[],"mappings":";;;AAAA,8DAA+B;AAC/B,uDAAwB"}

package/src/lib/filter/filter.d.ts

@@ -0,0 +1,5 @@
+export interface Filter<F> {
+    filter?: F;
+}
+export interface OptionalFilter<F> extends Partial<Filter<F>> {
+}

package/src/lib/filter/filter.js

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

package/src/lib/filter/filter.js.map

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

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

@@ -0,0 +1 @@
+export * from './filter';

package/src/lib/filter/index.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/filter/index.ts"],"names":[],"mappings":";;;AAAA,wDAAyB"}

package/src/lib/getter.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Function that returns a value.
+ */
+export declare type Getter<T> = () => T;
+/**
+ * Either a Getter, or an instance of the item.
+ */
+export declare type ObjectOrGetter<T> = T | Getter<T>;
+export declare type StringOrGetter = ObjectOrGetter<string>;
+/**
+ * If the input is a function, it is executed. Otherwise, the value is returned.
+ *
+ * @param input
+ * @returns
+ */
+export declare function getValueFromObjectOrGetter<T>(input: ObjectOrGetter<T>): T;

package/src/lib/getter.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getValueFromObjectOrGetter = void 0;
+/**
+ * If the input is a function, it is executed. Otherwise, the value is returned.
+ *
+ * @param input
+ * @returns
+ */
+function getValueFromObjectOrGetter(input) {
+    if (typeof input === 'function') {
+        return input();
+    }
+    else {
+        return input;
+    }
+}
+exports.getValueFromObjectOrGetter = getValueFromObjectOrGetter;
+//# sourceMappingURL=getter.js.map

package/src/lib/getter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getter.js","sourceRoot":"","sources":["../../../../../packages/util/src/lib/getter.ts"],"names":[],"mappings":";;;AAaA;;;;;GAKG;AACH,SAAgB,0BAA0B,CAAI,KAAwB;IACpE,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE;QAC/B,OAAQ,KAAiB,EAAE,CAAC;KAC7B;SAAM;QACL,OAAO,KAAK,CAAC;KACd;AACH,CAAC;AAND,gEAMC"}

package/src/lib/grouping.d.ts

@@ -0,0 +1,98 @@
+import { PrimativeKey, ReadKeyFunction } from "./key";
+import { Maybe } from "./value";
+export interface SeparateResult<T> {
+    included: T[];
+    excluded: T[];
+}
+export interface GroupingResult<T> {
+    [key: string]: T[];
+}
+export declare type KeyedGroupingResult<T, O, K extends keyof O = keyof O> = {
+    [k in K]: T[];
+};
+export interface PairsGroupingResult<T> {
+    pairs: T[][];
+    unpaired: T[];
+}
+export interface ArrayContentsDifferentParams<T, K extends PrimativeKey = PrimativeKey> {
+    groupKeyFn: ReadKeyFunction<T, K>;
+    isEqual: (a: T, b: T) => boolean;
+}
+/**
+ * Configuration for RestoreOrderParams.
+ */
+export interface RestoreOrderParams<T, K extends number | string = number | string> {
+    readKey: ReadKeyFunction<T, K>;
+    /**
+     * Optional function used to decide which value should be retained.
+     */
+    chooseRetainedValue?: (values: T[]) => T;
+    /**
+     * Whether or not new items should be excluded. If false, the new items are appended to the end of the result in the order they are accessed.
+     *
+     * By default this is false.
+     */
+    excludeNewItems?: boolean;
+}
+/**
+ * Batches items from the input array into several batches of a maximum size.
+ *
+ * @param array
+ * @param batchSize
+ * @returns
+ */
+export declare function batch<T>(array: T[], batchSize: number): T[][];
+/**
+ * Convenience function for calling restoreOrder with two arrays of values, instead of an array of keys and array of values.
+ *
+ * @param orderValues
+ * @param values
+ * @param params
+ * @returns
+ */
+export declare function restoreOrderWithValues<T, K extends PrimativeKey = PrimativeKey>(orderValues: T[], values: T[], params: RestoreOrderParams<T, K>): T[];
+/**
+ * Restores the order to the input values based on their keys.
+ *
+ * Duplicate values are passed to the chooseRetainedValue function past. When no function is provided, duplicates are ignored.
+ */
+export declare function restoreOrder<T, K extends PrimativeKey = PrimativeKey>(orderKeys: K[], values: T[], { readKey, chooseRetainedValue, excludeNewItems }: RestoreOrderParams<T, K>): T[];
+/**
+ * Returns true if the input differs from eachother.
+ *
+ * Input items are uniquely keyed in some fashion. The same items are paired up.
+ */
+export declare function arrayContentsDiffer<T, K extends PrimativeKey = PrimativeKey>(a: T[] | undefined, b: T[] | undefined, { groupKeyFn, isEqual }: ArrayContentsDifferentParams<T, K>): boolean;
+export declare function pairGroupValues<T, K extends PrimativeKey = PrimativeKey>(values: T[], groupKeyFn: ReadKeyFunction<T, K>): PairsGroupingResult<T>;
+/**
+ * Creates a tuples array of key and value pairs.
+ *
+ * @param values
+ * @param keyFn
+ * @returns
+ */
+export declare function makeKeyPairs<T, K extends string | number = string | number>(values: T[], keyFn: ReadKeyFunction<T, K>): [Maybe<K>, T][];
+/**
+ * Separates the input values into an included and excluded group.
+ *
+ * @param values
+ * @param checkInclusion
+ * @returns
+ */
+export declare function separateValues<T>(values: T[], checkInclusion: (x: T) => boolean): SeparateResult<T>;
+/**
+ * Convenience function for makeValuesGroupMap that returns a POJO instead of a Map.
+ *
+ * @param values
+ * @param groupKeyFn
+ */
+export declare function groupValues<T, R, K extends PrimativeKey & keyof R>(values: T[], groupKeyFn: ReadKeyFunction<T, K>): KeyedGroupingResult<T, R, K>;
+export declare function groupValues<T, K extends PrimativeKey = PrimativeKey>(values: T[], groupKeyFn: ReadKeyFunction<T, K>): GroupingResult<T>;
+/**
+ * Reads keys from the values in the arrays, and groups them together into a Map.
+ *
+ * @param values
+ * @param groupKeyFn
+ * @returns
+ */
+export declare function makeValuesGroupMap<T, K extends PrimativeKey = PrimativeKey>(values: T[], groupKeyFn: ReadKeyFunction<T, K>): Map<Maybe<K>, T[]>;