@dereekb/util 4.0.1 → 5.0.1

package/src/lib/auth/auth.role.claims.d.ts

@@ -1,5 +1,6 @@
-import { AuthRole, AuthRoleSet } from "./auth.role";
+import { AuthRole, AuthRoleSet } from './auth.role';
 import { ArrayOrValue } from '../array/array';
+import { Maybe } from '../value/maybe';
 /**
  * Key in the claims.
  */
@@ -16,28 +17,35 @@ export declare type SimpleAuthClaimValue = string | number;
  * Value in claims.
  */
 export declare type AuthClaimValue = SimpleAuthClaimValue | object;
+/**
+ * The template claims object. Only string values are allowed, as JSON values may only be keyed by string.
+ */
+export declare type AuthClaimsObject = {
+    [key: string]: AuthClaimValue;
+    [key: number | symbol]: never;
+};
 /**
  * An object that contains "claims" in the context of a JSON Web Token (JWT).
  *
  * It is keyed by the claims key.
  */
-export declare type AuthClaims<T = any> = {
-    [K in keyof T]: AuthClaimValue;
+export declare type AuthClaims<T extends AuthClaimsObject = AuthClaimsObject> = {
+    [K in keyof T]: T[K];
 };
 /**
- * A claims update.
+ * A claims update. All values can be null.
  */
-export declare type AuthClaimsUpdate<T = any> = {
-    [K in keyof Partial<T>]: AuthClaimValue | ClearAuthClaimValue;
-};
+export declare type AuthClaimsUpdate<T extends AuthClaimsObject = AuthClaimsObject> = Partial<{
+    [K in keyof T]: T[K] | ClearAuthClaimValue;
+}>;
 /**
  * Configuration for a claims key.
  */
-export declare type AuthRoleClaimsFactoryConfigEntry = AuthRoleClaimsFactoryConfigEntrySimpleOptions | AuthRoleClaimsFactoryConfigEntryEncodeOptions;
+export declare type AuthRoleClaimsFactoryConfigEntry<V extends AuthClaimValue = AuthClaimValue> = V extends SimpleAuthClaimValue ? AuthRoleClaimsFactoryConfigEntryEncodeOptions<V> | AuthRoleClaimsFactoryConfigEntrySimpleOptions<V> : AuthRoleClaimsFactoryConfigEntryEncodeOptions<V>;
 /**
  *
  */
-export interface AuthRoleClaimsFactoryConfigEntrySimpleOptions {
+export interface AuthRoleClaimsFactoryConfigEntrySimpleOptions<V extends SimpleAuthClaimValue = SimpleAuthClaimValue> {
     /**
      * The roles to add when this claims is encountered.
      */
@@ -45,49 +53,53 @@ export interface AuthRoleClaimsFactoryConfigEntrySimpleOptions {
     /**
      * (Optional) claim value. Overrides the default claim value.
      */
-    value?: SimpleAuthClaimValue;
+    value?: V;
 }
 /**
  * A more configurable configuration for a single claims value.
  */
-export interface AuthRoleClaimsFactoryConfigEntryEncodeOptions {
+export interface AuthRoleClaimsFactoryConfigEntryEncodeOptions<V extends AuthClaimValue = AuthClaimValue> {
     /**
      * (Optional) function of retrieving the value associated with this entry given the input claims.
      *
      * If not defined, will defer to role for finding matches and pull from value.
      */
-    encodeValueFromRoles: (roles: AuthRoleSet) => AuthClaimValue | undefined;
+    encodeValueFromRoles: (roles: AuthRoleSet) => V | undefined;
     /**
      * (Optional) Auth roles associated with this claims. If not defined, the claims key is used.
      */
-    decodeRolesFromValue: (value: AuthClaimValue) => AuthRole[] | undefined;
+    decodeRolesFromValue: (value: Maybe<V>) => AuthRole[] | undefined;
 }
-export declare type AuthRoleClaimsFactoryConfig = {
-    [key: string]: AuthRoleClaimsFactoryConfigEntry;
+export declare type AuthRoleClaimsFactoryConfig<T extends AuthClaimsObject = AuthClaimsObject> = {
+    [K in keyof T]: AuthRoleClaimsFactoryConfigEntry<T[K]>;
 };
 export interface AuthRoleClaimsFactoryDefaults {
     /**
      * Default value to use for claims that have no value present.
+     *
+     * If undefined, defaults to AUTH_ROLE_CLAIMS_DEFAULT_CLAIM_VALUE.
      */
-    claimValue?: any;
+    claimValue?: AuthClaimValue;
     /**
      * Default value for claims that are not defined.
+     *
+     * If undefined, defaults to AUTH_ROLE_CLAIMS_DEFAULT_EMPTY_VALUE.
      */
-    emptyValue?: any;
+    emptyValue?: AuthClaimValue | ClearAuthClaimValue;
 }
-export declare type AuthRoleClaimsToRolesFunction<T extends AuthRoleClaimsFactoryConfig = any> = (roles: AuthRoleSet) => AuthClaims<T>;
-export declare type AuthRoleRolesToClaimsFunction<T extends AuthRoleClaimsFactoryConfig = any> = (claims: AuthClaims<T>) => AuthRoleSet;
+export declare type AuthRoleClaimsToRolesFunction<T extends AuthClaimsObject = AuthClaimsObject> = (roles: AuthRoleSet) => AuthClaimsUpdate<T>;
+export declare type AuthRoleRolesToClaimsFunction<T extends AuthClaimsObject = AuthClaimsObject> = (claims: AuthClaims<T> | AuthClaimsUpdate<T>) => AuthRoleSet;
 /**
  * Service used for converting claims to/from a roles set.
  */
-export interface AuthRoleClaimsService<T extends AuthRoleClaimsFactoryConfig = any> {
+export interface AuthRoleClaimsService<T extends AuthClaimsObject> {
     readonly toClaims: AuthRoleClaimsToRolesFunction<T>;
     readonly toRoles: AuthRoleRolesToClaimsFunction<T>;
-    readonly defaultClaimValue: any;
-    readonly defaultEmptyValue: any;
+    readonly defaultClaimValue: unknown;
+    readonly defaultEmptyValue: unknown;
 }
-export declare const AUTH_ROLE_CLAIMS_DEFAULT_EMPTY_VALUE: null;
 export declare const AUTH_ROLE_CLAIMS_DEFAULT_CLAIM_VALUE = 1;
+export declare const AUTH_ROLE_CLAIMS_DEFAULT_EMPTY_VALUE: null;
 /**
  * Creates a AuthRoleClaimsService using the input configuration.
  *
@@ -95,4 +107,11 @@ export declare const AUTH_ROLE_CLAIMS_DEFAULT_CLAIM_VALUE = 1;
  * @param defaults
  * @returns
  */
-export declare function authRoleClaimsService<T extends AuthRoleClaimsFactoryConfig>(config: T, defaults?: AuthRoleClaimsFactoryDefaults): AuthRoleClaimsService<T>;
+export declare function authRoleClaimsService<T extends AuthClaimsObject>(config: AuthRoleClaimsFactoryConfig<T>, defaults?: AuthRoleClaimsFactoryDefaults): AuthRoleClaimsService<T>;
+/**
+ * Converts an AuthClaimsUpdate to AuthClaims by removing all null keys.
+ *
+ * @param authClaimsUpdate
+ * @returns
+ */
+export declare function authClaims<T extends AuthClaimsObject = AuthClaimsObject>(authClaimsUpdate: AuthClaimsUpdate<T>): AuthClaims<T>;

package/src/lib/auth/auth.role.claims.js

@@ -1,12 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.authRoleClaimsService = exports.AUTH_ROLE_CLAIMS_DEFAULT_CLAIM_VALUE = exports.AUTH_ROLE_CLAIMS_DEFAULT_EMPTY_VALUE = void 0;
+exports.authClaims = exports.authRoleClaimsService = exports.AUTH_ROLE_CLAIMS_DEFAULT_EMPTY_VALUE = exports.AUTH_ROLE_CLAIMS_DEFAULT_CLAIM_VALUE = void 0;
 const object_1 = require("../object/object");
 const object_map_1 = require("../object/object.map");
 const array_1 = require("../array/array");
 const set_1 = require("../set");
-exports.AUTH_ROLE_CLAIMS_DEFAULT_EMPTY_VALUE = null;
 exports.AUTH_ROLE_CLAIMS_DEFAULT_CLAIM_VALUE = 1;
+exports.AUTH_ROLE_CLAIMS_DEFAULT_EMPTY_VALUE = null;
 /**
  * Creates a AuthRoleClaimsService using the input configuration.
  *
@@ -15,8 +15,9 @@ exports.AUTH_ROLE_CLAIMS_DEFAULT_CLAIM_VALUE = 1;
  * @returns
  */
 function authRoleClaimsService(config, defaults = {}) {
-    const defaultClaimValue = (0, object_1.objectHasKey)(defaults, 'claimValue') ? defaults === null || defaults === void 0 ? void 0 : defaults.claimValue : exports.AUTH_ROLE_CLAIMS_DEFAULT_CLAIM_VALUE;
-    const defaultEmptyValue = (0, object_1.objectHasKey)(defaults, 'emptyValue') ? defaults === null || defaults === void 0 ? void 0 : defaults.emptyValue : exports.AUTH_ROLE_CLAIMS_DEFAULT_EMPTY_VALUE;
+    var _a, _b;
+    const defaultClaimValue = (_a = ((0, object_1.objectHasKey)(defaults, 'claimValue') ? defaults === null || defaults === void 0 ? void 0 : defaults.claimValue : exports.AUTH_ROLE_CLAIMS_DEFAULT_CLAIM_VALUE)) !== null && _a !== void 0 ? _a : exports.AUTH_ROLE_CLAIMS_DEFAULT_CLAIM_VALUE;
+    const defaultEmptyValue = (_b = ((0, object_1.objectHasKey)(defaults, 'emptyValue') ? defaults === null || defaults === void 0 ? void 0 : defaults.emptyValue : exports.AUTH_ROLE_CLAIMS_DEFAULT_EMPTY_VALUE)) !== null && _b !== void 0 ? _b : null;
     function isSimpleOptions(entry) {
         return entry.roles != null;
     }
@@ -28,7 +29,7 @@ function authRoleClaimsService(config, defaults = {}) {
             const expectedValue = (_a = inputEntry.value) !== null && _a !== void 0 ? _a : defaultClaimValue;
             const claimRoles = (0, array_1.asArray)(inputEntry.roles);
             // since checking uses equivalence, the objects will never match equivalence via the === properly.
-            // AuthRoleClaimsFactoryConfigEntryEncodeOptions is likely to be used for these cases anyways, but this will help avoid unexpected errors.
+            // AuthRoleClaimsFactoryConfigEntryEncodeOptions is likely to be used for these cases unknownways, but this will help avoid unexpected errors.
             if (typeof expectedValue === 'object') {
                 throw new Error(`failed decoding claims. Expected value to be a string or number. Object isn't supported with simple claims.`);
             }
@@ -58,13 +59,13 @@ function authRoleClaimsService(config, defaults = {}) {
         entry.claimKey = x[0];
         return [x[0], entry];
     });
-    const authRolesMap = new Map(tuples.map(x => [(x[0]).toLowerCase(), x[1]]));
+    const authRolesMap = new Map(tuples.map((x) => [x[0].toLowerCase(), x[1]]));
     const toClaims = (roles) => {
         const claims = {};
         // iterate by each claim value to build the claims.
         tuples.forEach(([claimsKey, entry]) => {
             var _a;
-            let claimsValue = (_a = entry.encodeValueFromRoles(roles)) !== null && _a !== void 0 ? _a : defaultEmptyValue;
+            const claimsValue = (_a = entry.encodeValueFromRoles(roles)) !== null && _a !== void 0 ? _a : defaultEmptyValue;
             claims[claimsKey] = claimsValue;
         });
         return claims;
@@ -90,4 +91,14 @@ function authRoleClaimsService(config, defaults = {}) {
     };
 }
 exports.authRoleClaimsService = authRoleClaimsService;
+/**
+ * Converts an AuthClaimsUpdate to AuthClaims by removing all null keys.
+ *
+ * @param authClaimsUpdate
+ * @returns
+ */
+function authClaims(authClaimsUpdate) {
+    return (0, object_1.filterFromPOJO)(authClaimsUpdate, { filter: { valueFilter: object_1.KeyValueTypleValueFilter.NULL } });
+}
+exports.authClaims = authClaims;
 //# sourceMappingURL=auth.role.claims.js.map

package/src/lib/auth/auth.role.claims.js.map

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

package/src/lib/auth/auth.role.d.ts

@@ -1,4 +1,4 @@
-import { Maybe } from "../value/maybe";
+import { Maybe } from '../value/maybe';
 /**
  * An application role.
  *

package/src/lib/auth/auth.role.js.map

@@ -1 +1 @@
-{"version":3,"file":"auth.role.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/auth/auth.role.ts"],"names":[],"mappings":";;;AAAA,oCAAkD;AAiBlD;;GAEG;AACU,QAAA,eAAe,GAAG,OAAO,CAAC;AAEvC;;GAEG;AACU,QAAA,cAAc,GAAG,MAAM,CAAC;AAErC,SAAgB,oBAAoB,CAAC,YAAyB,EAAE,KAAgC;IAC9F,OAAO,IAAA,0BAAoB,EAAC,YAAY,EAAE,KAAK,aAAL,KAAK,cAAL,KAAK,GAAI,EAAE,CAAC,CAAA;AACxD,CAAC;AAFD,oDAEC"}
+{"version":3,"file":"auth.role.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/auth/auth.role.ts"],"names":[],"mappings":";;;AAAA,oCAAkD;AAiBlD;;GAEG;AACU,QAAA,eAAe,GAAG,OAAO,CAAC;AAEvC;;GAEG;AACU,QAAA,cAAc,GAAG,MAAM,CAAC;AAErC,SAAgB,oBAAoB,CAAC,YAAyB,EAAE,KAAgC;IAC9F,OAAO,IAAA,0BAAoB,EAAC,YAAY,EAAE,KAAK,aAAL,KAAK,cAAL,KAAK,GAAI,EAAE,CAAC,CAAC;AACzD,CAAC;AAFD,oDAEC"}

package/src/lib/boolean.d.ts

@@ -2,4 +2,4 @@ export declare function reduceBooleansWithAnd(array: boolean[], emptyArrayValue?
 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;
+export declare function reduceBooleansFn(reduceFn: (a: boolean, b: boolean) => boolean, emptyArrayValue?: boolean): (array: boolean[]) => boolean;

package/src/lib/boolean.js

@@ -20,7 +20,7 @@ exports.reduceBooleansWithOrFn = reduceBooleansWithOrFn;
 function reduceBooleansFn(reduceFn, emptyArrayValue) {
     const rFn = (array) => Boolean(array.reduce(reduceFn));
     if (emptyArrayValue != null) {
-        return (array) => (array.length) ? rFn(array) : emptyArrayValue;
+        return (array) => (array.length ? rFn(array) : emptyArrayValue);
     }
     else {
         return rFn;

package/src/lib/boolean.js.map

@@ -1 +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"}
+{"version":3,"file":"boolean.js","sourceRoot":"","sources":["../../../../../packages/util/src/lib/boolean.ts"],"names":[],"mappings":";;;AAAA,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,QAA6C,EAAE,eAAyB;IACvG,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,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;KAC5E;SAAM;QACL,OAAO,GAAG,CAAC;KACZ;AACH,CAAC;AARD,4CAQC"}

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

@@ -1,4 +1,4 @@
-import { EmailAddress } from "./email";
+import { EmailAddress } from './email';
 export declare type EmailAddressDomain = string;
 export declare function readDomainsFromEmailAddresses(addresses: EmailAddress[]): EmailAddressDomain[];
 export declare function readDomainFromEmailAddress(address: EmailAddress): EmailAddressDomain;

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

@@ -1 +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"}
+{"version":3,"file":"domain.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/contact/domain.ts"],"names":[],"mappings":";;;AAAA,oCAAwD;AAKxD,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

@@ -3,8 +3,7 @@ export interface NameEmailPair {
     name?: string;
     email: EmailAddress;
 }
-export interface EmailParticipant extends NameEmailPair {
-}
+export declare type EmailParticipant = NameEmailPair;
 /**
  * Email participant string. Starts with the email, followed by the name if available.
  */

package/src/lib/contact/email.js

@@ -23,9 +23,9 @@ function coerceToEmailParticipants({ participants = [], emails = [] }) {
         return participants;
     }
     else {
-        const participantEmails = (_a = participants === null || participants === void 0 ? void 0 : participants.map(x => x.email)) !== null && _a !== void 0 ? _a : [];
+        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 })));
+        return participants.concat(emailsWithoutParticipants.map((email) => ({ email })));
     }
 }
 exports.coerceToEmailParticipants = coerceToEmailParticipants;

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

@@ -1 +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"}
+{"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,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,mCAAI,EAAE,CAAC;QAClE,MAAM,yBAAyB,GAAG,IAAA,8BAAsB,EAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;QACpF,OAAO,YAAY,CAAC,MAAM,CAAC,yBAAyB,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;KACnF;AACH,CAAC;AARD,8DAQC"}

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

@@ -1,4 +1,4 @@
-import { Maybe } from "../value/maybe";
+import { Maybe } from '../value/maybe';
 /**
  * A valid ISO8601 formatted date string.
  */

package/src/lib/date/date.js

@@ -3,7 +3,7 @@ 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);
+    return timezone == null || timezone === exports.UTC_TIMEZONE_STRING;
 }
 exports.isConsideredUtcTimezoneString = isConsideredUtcTimezoneString;
 exports.MINUTES_IN_DAY = 1440;

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

@@ -1 +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;AA8BY,QAAA,cAAc,GAAG,IAAI,CAAC;AACtB,QAAA,YAAY,GAAG,IAAI,GAAG,EAAE,CAAC;AACzB,QAAA,UAAU,GAAG,oBAAY,GAAG,EAAE,CAAC"}
+{"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,QAAQ,IAAI,IAAI,IAAI,QAAQ,KAAK,2BAAmB,CAAC;AAC9D,CAAC;AAFD,sEAEC;AA8BY,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

@@ -1,4 +1,4 @@
-import { Maybe } from "../value/maybe";
+import { Maybe } from '../value/maybe';
 /**
  * Represents a string for a time. This may be human-input, and
  * can be interpreted in various ways depending on the input.

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

@@ -8,6 +8,10 @@ export declare type StringErrorCode = string;
  */
 export interface CodedError {
     code: StringErrorCode;
+    /**
+     * The original error, if available.
+     */
+    _error?: unknown;
 }
 /**
  * An error with a human-readable message.
@@ -19,17 +23,17 @@ export declare function readableError(code: StringErrorCode, message?: string):
     code: string;
     message: string | undefined;
 };
-export interface ReadableDataError<T = any> extends ReadableError {
+export interface ReadableDataError<T = unknown> extends ReadableError {
     data?: T;
 }
 export interface ErrorWrapper {
     data: ReadableError | CodedError;
 }
-export declare type ErrorInput = ErrorWrapper | CodedError | ReadableError;
+export declare type ErrorInput = ErrorWrapper | CodedError | ReadableError | ReadableDataError;
 /**
  * Converts the input error content to a ReadableError or CodedError.
  *
  * @param inputError
  * @returns
  */
-export declare function convertToReadableError(inputError: ErrorInput | undefined): CodedError | ReadableError | undefined;
+export declare function toReadableError(inputError: Maybe<ErrorInput>): Maybe<CodedError | ReadableError>;

package/src/lib/error/error.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.convertToReadableError = exports.readableError = void 0;
+exports.toReadableError = exports.readableError = void 0;
 const make_error_1 = require("make-error");
 function readableError(code, message) {
     return {
@@ -15,7 +15,7 @@ exports.readableError = readableError;
  * @param inputError
  * @returns
  */
-function convertToReadableError(inputError) {
+function toReadableError(inputError) {
     let error;
     if (inputError) {
         if (inputError.code) {
@@ -26,18 +26,20 @@ function convertToReadableError(inputError) {
         }
         else if (inputError instanceof make_error_1.BaseError) {
             error = {
-                code: inputError.code || inputError.name,
-                message: inputError.message
+                code: inputError.name,
+                message: inputError.message,
+                _error: inputError
             };
         }
         else {
             error = {
                 code: 'ERROR',
-                message: inputError.message || ''
+                message: inputError.message || '',
+                _error: inputError
             };
         }
     }
     return error;
 }
-exports.convertToReadableError = convertToReadableError;
+exports.toReadableError = toReadableError;
 //# sourceMappingURL=error.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"error.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/error/error.ts"],"names":[],"mappings":";;;AAAA,2CAAuC;AAsBvC,SAAgB,aAAa,CAAC,IAAqB,EAAE,OAAgB;IACnE,OAAO;QACL,IAAI;QACJ,OAAO;KACR,CAAC;AACJ,CAAC;AALD,sCAKC;AAYD;;;;;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"}
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/error/error.ts"],"names":[],"mappings":";;;AAAA,2CAAuC;AA2BvC,SAAgB,aAAa,CAAC,IAAqB,EAAE,OAAgB;IACnE,OAAO;QACL,IAAI;QACJ,OAAO;KACR,CAAC;AACJ,CAAC;AALD,sCAKC;AAYD;;;;;GAKG;AACH,SAAgB,eAAe,CAAC,UAA6B;IAC3D,IAAI,KAAwC,CAAC;IAE7C,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,EAAE,UAAU,CAAC,IAAI;gBACrB,OAAO,EAAE,UAAU,CAAC,OAAO;gBAC3B,MAAM,EAAE,UAAU;aACnB,CAAC;SACH;aAAM;YACL,KAAK,GAAG;gBACN,IAAI,EAAE,OAAO;gBACb,OAAO,EAAG,UAA4B,CAAC,OAAO,IAAI,EAAE;gBACpD,MAAM,EAAE,UAAU;aACnB,CAAC;SACH;KACF;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAxBD,0CAwBC"}

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

@@ -7,12 +7,12 @@ export interface ServerErrorResponseData extends ReadableError {
     /**
      * Additional keys/data returned in the error data.
      */
-    [key: string]: any;
+    [key: string]: unknown;
 }
 /**
  * Human-readable server error with additional data and a status code.
  */
-export interface ServerError<T = any> extends ReadableDataError<T> {
+export interface ServerError<T = ServerErrorResponseData> extends ReadableDataError<T> {
     status: number;
 }
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"error.server.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/error/error.server.ts"],"names":[],"mappings":";;;AAoBA;;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"}
+{"version":3,"file":"error.server.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/error/error.server.ts"],"names":[],"mappings":";;;AAoBA;;GAEG;AACH,MAAa,mBAAmB;IAM9B,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;CACF;AAZD,kDAYC;AAED,MAAa,+BAAgC,SAAQ,mBAAmB;IACtE,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;CACF;AAJD,0EAIC"}

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

@@ -1,8 +1,8 @@
 export interface Filter<F> {
     filter?: F;
 }
-export interface OptionalFilter<F> extends Partial<Filter<F>> {
-}
+export declare type OptionalFilter<F> = Partial<Filter<F>>;
+export declare type FilterFunction<T = unknown> = (value: T, index: number) => boolean;
 /**
  * Used to invert a filter function by returning the opposite of what it returns.
  *
@@ -10,4 +10,4 @@ export interface OptionalFilter<F> extends Partial<Filter<F>> {
  * @param invert whether or not to apply the inversion.
  * @returns
  */
-export declare function invertFilter<F extends (((value: any, index: number) => boolean) | ((value: any) => boolean) | (() => boolean)) = () => boolean>(filterFn: F, invert?: boolean): F;
+export declare function invertFilter<T = unknown, F extends FilterFunction<T> = FilterFunction<T>>(filterFn: F, invert?: boolean): F;

package/src/lib/filter/filter.js

@@ -10,10 +10,10 @@ exports.invertFilter = void 0;
  */
 function invertFilter(filterFn, invert = true) {
     if (invert) {
-        return function () {
-            const result = filterFn.apply(undefined, arguments);
+        return ((value, index) => {
+            const result = filterFn.call(null, value, index);
             return !result;
-        };
+        });
     }
     else {
         return filterFn;

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

@@ -1 +1 @@
-{"version":3,"file":"filter.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/filter/filter.ts"],"names":[],"mappings":";;;AAOA;;;;;;GAMG;AACH,SAAgB,YAAY,CAAqH,QAAW,EAAE,MAAM,GAAG,IAAI;IACzK,IAAI,MAAM,EAAE;QACV,OAAO;YACL,MAAM,MAAM,GAAa,QAAgB,CAAC,KAAK,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YACtE,OAAO,CAAC,MAAM,CAAC;QACjB,CAAM,CAAC;KACR;SAAM;QACL,OAAO,QAAQ,CAAC;KACjB;AACH,CAAC;AATD,oCASC"}
+{"version":3,"file":"filter.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/filter/filter.ts"],"names":[],"mappings":";;;AAQA;;;;;;GAMG;AACH,SAAgB,YAAY,CAA+D,QAAW,EAAE,MAAM,GAAG,IAAI;IACnH,IAAI,MAAM,EAAE;QACV,OAAO,CAAC,CAAC,KAAQ,EAAE,KAAa,EAAE,EAAE;YAClC,MAAM,MAAM,GAAY,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;YAC1D,OAAO,CAAC,MAAM,CAAC;QACjB,CAAC,CAAM,CAAC;KACT;SAAM;QACL,OAAO,QAAQ,CAAC;KACjB;AACH,CAAC;AATD,oCASC"}

package/src/lib/function/function.d.ts

@@ -0,0 +1,7 @@
+/**
+ * A function that returns the input value.
+ *
+ * @param input
+ * @returns
+ */
+export declare function passThrough<T>(input: T): T;

package/src/lib/function/function.forward.d.ts

@@ -1,9 +1,9 @@
-import { Getter } from "../getter/getter";
-export declare type ForwardFunction<I extends (...args: any[]) => O, O = any> = I;
+import { Getter } from '../getter/getter';
+export declare type ForwardFunction<I extends (...args: any[]) => O, O = unknown> = I;
 /**
  * Wraps a Getter that returns a function. When the function is invoked, the getter retrieves the function then calls it with the input arguments.
  *
  * @param getter
  * @returns
  */
-export declare function forwardFunction<I extends (...args: any[]) => O, O = any>(getter: Getter<I>): ForwardFunction<I>;
+export declare function forwardFunction<I extends (...args: any[]) => O, O = unknown>(getter: Getter<I>): ForwardFunction<I>;

package/src/lib/function/function.forward.js

@@ -1,4 +1,6 @@
 "use strict";
+/*eslint @typescript-eslint/no-explicit-any:"off"*/
+// any is used with intent here. using unknown can have strange effects in usage of forwardFunction and type capture.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.forwardFunction = void 0;
 /**

package/src/lib/function/function.forward.js.map

@@ -1 +1 @@
-{"version":3,"file":"function.forward.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/function/function.forward.ts"],"names":[],"mappings":";;;AAKA;;;;;GAKG;AACH,SAAgB,eAAe,CAA2C,MAAiB;IACzF,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,IAAW,EAAE,EAAE;QAC7B,MAAM,SAAS,GAAG,MAAM,EAAE,CAAC;QAC3B,OAAO,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC;IAC5B,CAAC,CAA0B,CAAC;IAE5B,OAAO,EAAE,CAAC;AACZ,CAAC;AAPD,0CAOC"}
+{"version":3,"file":"function.forward.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/function/function.forward.ts"],"names":[],"mappings":";AAAA,mDAAmD;AACnD,qHAAqH;;;AAMrH;;;;;GAKG;AACH,SAAgB,eAAe,CAA+C,MAAiB;IAC7F,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,IAAe,EAAE,EAAE;QACjC,MAAM,SAAS,GAAG,MAAM,EAAE,CAAC;QAC3B,OAAO,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC;IAC5B,CAAC,CAA0B,CAAC;IAE5B,OAAO,EAAE,CAAC;AACZ,CAAC;AAPD,0CAOC"}

package/src/lib/function/function.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.passThrough = void 0;
+/**
+ * A function that returns the input value.
+ *
+ * @param input
+ * @returns
+ */
+function passThrough(input) {
+    return input;
+}
+exports.passThrough = passThrough;
+//# sourceMappingURL=function.js.map

package/src/lib/function/function.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"function.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/function/function.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,SAAgB,WAAW,CAAI,KAAQ;IACrC,OAAO,KAAK,CAAC;AACf,CAAC;AAFD,kCAEC"}

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

@@ -1 +1,2 @@
 export * from './function.forward';
+export * from './function';

package/src/lib/function/index.js

@@ -2,4 +2,5 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./function.forward"), exports);
+tslib_1.__exportStar(require("./function"), exports);
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/function/index.ts"],"names":[],"mappings":";;;AAAA,6DAAmC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/function/index.ts"],"names":[],"mappings":";;;AAAA,6DAAmC;AACnC,qDAA2B"}

package/src/lib/getter/getter.cache.d.ts

@@ -1,4 +1,4 @@
-import { FactoryWithInput, Getter } from "./getter";
+import { FactoryWithInput, Getter } from './getter';
 /**
  * Getter that returns a cached value.
  */
@@ -18,7 +18,7 @@ export declare type CachedGetter<T> = Getter<T> & {
      */
     init(): void;
 };
-export declare type CachedFactoryWithInput<T, A = any> = CachedGetter<T> & FactoryWithInput<T, A> & {
+export declare type CachedFactoryWithInput<T, A = unknown> = CachedGetter<T> & FactoryWithInput<T, A> & {
     /**
      * Re-initializes the cache using the factory function.
      *
@@ -35,4 +35,4 @@ export declare type CachedFactoryWithInput<T, A = any> = CachedGetter<T> & Facto
  * @returns
  */
 export declare function cachedGetter<T>(getter: Getter<T>): CachedFactoryWithInput<T>;
-export declare function cachedGetter<T, A = any>(factory: FactoryWithInput<T, A>): CachedFactoryWithInput<T, A>;
+export declare function cachedGetter<T, A = unknown>(factory: FactoryWithInput<T, A>): CachedFactoryWithInput<T, A>;

package/src/lib/getter/getter.cache.js

@@ -14,8 +14,8 @@ function cachedGetter(factory) {
         }
         return loaded.value;
     });
-    result.set = (value) => loaded = { value };
-    result.reset = () => loaded = undefined;
+    result.set = (value) => (loaded = { value });
+    result.reset = () => (loaded = undefined);
     result.init = init;
     return result;
 }

package/src/lib/getter/getter.cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"getter.cache.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/getter/getter.cache.ts"],"names":[],"mappings":";;;AA8CA,SAAgB,YAAY,CAAa,OAA+B;IACtE,IAAI,MAA2B,CAAC;IAEhC,MAAM,IAAI,GAAG,CAAC,KAAS,EAAE,EAAE;QACzB,MAAM,GAAG;YACP,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC;SACtB,CAAC;IACJ,CAAC,CAAC;IAEF,MAAM,MAAM,GAAG,CAAC,CAAC,KAAS,EAAE,EAAE;QAC5B,IAAI,CAAC,MAAM,EAAE;YACX,IAAI,CAAC,KAAK,CAAC,CAAC;SACb;QAED,OAAO,MAAO,CAAC,KAAK,CAAC;IACvB,CAAC,CAAiC,CAAC;IAEnC,MAAM,CAAC,GAAG,GAAG,CAAC,KAAQ,EAAE,EAAE,CAAC,MAAM,GAAG,EAAE,KAAK,EAAE,CAAC;IAC9C,MAAM,CAAC,KAAK,GAAG,GAAG,EAAE,CAAC,MAAM,GAAG,SAAS,CAAC;IACxC,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;IAEnB,OAAO,MAAM,CAAC;AAChB,CAAC;AAtBD,oCAsBC"}
+{"version":3,"file":"getter.cache.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/getter/getter.cache.ts"],"names":[],"mappings":";;;AA6CA,SAAgB,YAAY,CAAiB,OAA+B;IAC1E,IAAI,MAA2B,CAAC;IAEhC,MAAM,IAAI,GAAG,CAAC,KAAS,EAAE,EAAE;QACzB,MAAM,GAAG;YACP,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC;SACtB,CAAC;IACJ,CAAC,CAAC;IAEF,MAAM,MAAM,GAAG,CAAC,CAAC,KAAS,EAAE,EAAE;QAC5B,IAAI,CAAC,MAAM,EAAE;YACX,IAAI,CAAC,KAAK,CAAC,CAAC;SACb;QAED,OAAQ,MAAuB,CAAC,KAAK,CAAC;IACxC,CAAC,CAAiC,CAAC;IAEnC,MAAM,CAAC,GAAG,GAAG,CAAC,KAAQ,EAAE,EAAE,CAAC,CAAC,MAAM,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;IAChD,MAAM,CAAC,KAAK,GAAG,GAAG,EAAE,CAAC,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC1C,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;IAEnB,OAAO,MAAM,CAAC;AAChB,CAAC;AAtBD,oCAsBC"}