@genesislcap/foundation-utils 14.65.2 → 14.66.0

package/dist/dts/error/errorMap.d.ts

@@ -0,0 +1,97 @@
+/**
+ * @public
+ */
+export type ErrorDetailMap = Record<string, unknown>;
+/**
+ * @public
+ */
+export type ErrorMapLogger = (...args: any[]) => void;
+/**
+ * @public
+ */
+export interface ErrorMap<TErrorDetailMap extends ErrorDetailMap> extends Pick<Map<keyof TErrorDetailMap, Error>, 'get' | 'has' | 'delete' | 'clear' | 'size'> {
+    /**
+     * Error map as messages.
+     * @returns string
+     *
+     * @public
+     */
+    readonly messages: string;
+    /**
+     * Set an error by key.
+     * @param key - The key.
+     * @param error - The error.
+     *
+     * @public
+     */
+    set(key: keyof TErrorDetailMap, error: Error): void;
+    /**
+     * The last set error if any.
+     * @returns Error
+     *
+     * @public
+     */
+    readonly lastError: Error;
+}
+/**
+ * @public
+ */
+export declare class DefaultErrorMap<TErrorDetailMap extends ErrorDetailMap> implements ErrorMap<TErrorDetailMap> {
+    private logger;
+    private map;
+    /** {@inheritDoc ErrorMap.lastError} */
+    lastError: Error;
+    /**
+     * @param logger - A logger error method reference.
+     */
+    constructor(logger: ErrorMapLogger);
+    /** {@inheritDoc ErrorMap.set} */
+    set(key: keyof TErrorDetailMap, error: Error): void;
+    /**
+     * Get an error by key.
+     * @param key - The key.
+     * @returns The error if it exists, otherwise undefined.
+     *
+     * @public
+     */
+    get(key: keyof TErrorDetailMap): Error | undefined;
+    /**
+     * Has an error for key.
+     * @param key - The key.
+     * @returns True if it exists, otherwise false.
+     *
+     * @public
+     */
+    has(key: keyof TErrorDetailMap): boolean;
+    /**
+     * Delete an error.
+     * @param key - The key.
+     * @returns True if successful, otherwise false.
+     *
+     * @public
+     */
+    delete(key: keyof TErrorDetailMap): boolean;
+    /**
+     * Clear errors.
+     * @public
+     */
+    clear(): void;
+    /**
+     * The size of the error map.
+     * @returns number
+     *
+     * @public
+     */
+    get size(): number;
+    /** {@inheritDoc ErrorMap.messages} */
+    get messages(): string;
+}
+/**
+ * A factory to create the error map.
+ * @param logger - A logger error method reference.
+ * @returns A ErrorMap instance.
+ *
+ * @public
+ */
+export declare const createErrorMap: <TErrorDetailMap extends ErrorDetailMap>(logger: ErrorMapLogger) => ErrorMap<TErrorDetailMap>;
+//# sourceMappingURL=errorMap.d.ts.map

package/dist/dts/error/errorMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorMap.d.ts","sourceRoot":"","sources":["../../../src/error/errorMap.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,QAAQ,CAAC,eAAe,SAAS,cAAc,CAC9D,SAAQ,IAAI,CAAC,GAAG,CAAC,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;IAC5F;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;;;;;OAMG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,eAAe,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAEpD;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC;CAC3B;AAED;;GAEG;AACH,qBAAa,eAAe,CAAC,eAAe,SAAS,cAAc,CACjE,YAAW,QAAQ,CAAC,eAAe,CAAC;IAUxB,OAAO,CAAC,MAAM;IARd,OAAO,CAAC,GAAG,CAA2C;IAElE,uCAAuC;IAC3B,SAAS,EAAE,KAAK,CAAC;IAE7B;;OAEG;gBACiB,MAAM,EAAE,cAAc;IAE1C,iCAAiC;IACjC,GAAG,CAAC,GAAG,EAAE,MAAM,eAAe,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;IAMnD;;;;;;OAMG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,eAAe,GAAG,KAAK,GAAG,SAAS;IAIlD;;;;;;OAMG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,eAAe,GAAG,OAAO;IAIxC;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,eAAe,GAAG,OAAO;IAa3C;;;OAGG;IACH,KAAK;IAKL;;;;;OAKG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,sCAAsC;IACtC,IAAI,QAAQ,IAAI,MAAM,CAUrB;CACF;AAED;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,mDACjB,cAAc,8BACoD,CAAC"}

package/dist/dts/error/index.d.ts

@@ -0,0 +1,2 @@
+export * from './errorMap';
+//# sourceMappingURL=index.d.ts.map

package/dist/dts/error/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/error/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC"}

package/dist/dts/index.d.ts

@@ -3,6 +3,7 @@ export * from './decorators';
 export * from './design-system';
 export * from './directives';
 export * from './env';
+export * from './error';
 export * from './formatters';
 export * from './logger';
 export * from './mappers';

package/dist/dts/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,OAAO,CAAC;AACtB,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC"}

package/dist/dts/serializers/json/index.d.ts

@@ -1,2 +1,4 @@
 export * from './json';
+export * from './jsonReplacer';
+export * from './jsonReviver';
 //# sourceMappingURL=index.d.ts.map

package/dist/dts/serializers/json/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/serializers/json/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/serializers/json/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC"}

package/dist/dts/serializers/json/jsonReplacer.d.ts

@@ -0,0 +1,9 @@
+/**
+ * JSON replacer function.
+ * @param key - The object key.
+ * @param value - The key value.
+ * @returns The resulting value.
+ * @public
+ */
+export declare function JSONReplacer(key: string, value: any): any;
+//# sourceMappingURL=jsonReplacer.d.ts.map

package/dist/dts/serializers/json/jsonReplacer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonReplacer.d.ts","sourceRoot":"","sources":["../../../../src/serializers/json/jsonReplacer.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,GAAG,CAoBzD"}

package/dist/dts/serializers/json/jsonReviver.d.ts

@@ -0,0 +1,9 @@
+/**
+ * JSON reviver function.
+ * @param key - The object key.
+ * @param value - The key value.
+ * @returns The resulting value.
+ * @public
+ */
+export declare function JSONReviver(key: string, value: any): any;
+//# sourceMappingURL=jsonReviver.d.ts.map

package/dist/dts/serializers/json/jsonReviver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonReviver.d.ts","sourceRoot":"","sources":["../../../../src/serializers/json/jsonReviver.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,GAAG,CAyBxD"}

package/dist/dts/serializers/json/types.d.ts

@@ -0,0 +1,26 @@
+import { Constructable } from '@microsoft/fast-element';
+/**
+ * @internal
+ */
+export declare const ISO8601: RegExp;
+/**
+ * @internal
+ */
+export declare const NaNSymbol = "$NaN";
+/**
+ * @internal
+ */
+type Deserializable = Constructable | {
+    prototype: any;
+    fromJSON(options: any): any;
+};
+/**
+ * @internal
+ */
+export declare const getType: (typeId: string) => Deserializable;
+/**
+ * @internal
+ */
+export declare const getTypeId: (object: any) => string | undefined;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/dts/serializers/json/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/serializers/json/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,OAAO,QACwI,CAAC;AAE7J;;GAEG;AACH,eAAO,MAAM,SAAS,SAAS,CAAC;AAEhC;;GAEG;AACH,KAAK,cAAc,GACf,aAAa,GACb;IACE,SAAS,EAAE,GAAG,CAAC;IACf,QAAQ,CAAC,OAAO,EAAE,GAAG,GAAG,GAAG,CAAC;CAC7B,CAAC;AAON;;GAEG;AACH,eAAO,MAAM,OAAO,WAAY,MAAM,mBAAiC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,SAAS,WAAY,GAAG,KAAG,MAAM,GAAG,SAwBhD,CAAC"}

package/dist/dts/tsdoc-metadata.json

@@ -0,0 +1,11 @@
+// This file is read by tools that parse documentation comments conforming to the TSDoc standard.
+// It should be published with your NPM package.  It should not be tracked by Git.
+{
+  "tsdocVersion": "0.12",
+  "toolPackages": [
+    {
+      "packageName": "@microsoft/api-extractor",
+      "packageVersion": "7.34.9"
+    }
+  ]
+}

package/dist/esm/error/errorMap.js

@@ -0,0 +1,101 @@
+import { __decorate } from "tslib";
+import { observable } from '@microsoft/fast-element';
+/**
+ * @public
+ */
+export class DefaultErrorMap {
+    /**
+     * @param logger - A logger error method reference.
+     */
+    constructor(logger) {
+        this.logger = logger;
+        this.map = new Map();
+    }
+    /** {@inheritDoc ErrorMap.set} */
+    set(key, error) {
+        this.logger(key, error);
+        this.lastError = error;
+        this.map = new Map(this.map.set(key, error));
+    }
+    /**
+     * Get an error by key.
+     * @param key - The key.
+     * @returns The error if it exists, otherwise undefined.
+     *
+     * @public
+     */
+    get(key) {
+        return this.map.get(key);
+    }
+    /**
+     * Has an error for key.
+     * @param key - The key.
+     * @returns True if it exists, otherwise false.
+     *
+     * @public
+     */
+    has(key) {
+        return this.map.has(key);
+    }
+    /**
+     * Delete an error.
+     * @param key - The key.
+     * @returns True if successful, otherwise false.
+     *
+     * @public
+     */
+    delete(key) {
+        const isDeletingLast = this.map.get(key) === this.lastError;
+        const result = this.map.delete(key);
+        if (result) {
+            this.map = new Map(this.map);
+            if (isDeletingLast) {
+                this.lastError = undefined;
+            }
+        }
+        return result;
+    }
+    /**
+     * Clear errors.
+     * @public
+     */
+    clear() {
+        this.lastError = undefined;
+        this.map = new Map();
+    }
+    /**
+     * The size of the error map.
+     * @returns number
+     *
+     * @public
+     */
+    get size() {
+        return this.map.size;
+    }
+    /** {@inheritDoc ErrorMap.messages} */
+    get messages() {
+        const count = this.size;
+        if (!count) {
+            return '';
+        }
+        const errorMessages = [];
+        for (const { message } of this.map.values()) {
+            errorMessages.push(message);
+        }
+        return `${count} Error${count > 1 ? 's' : ''} Occurred:\n${errorMessages.join('\n')}`;
+    }
+}
+__decorate([
+    observable
+], DefaultErrorMap.prototype, "map", void 0);
+__decorate([
+    observable
+], DefaultErrorMap.prototype, "lastError", void 0);
+/**
+ * A factory to create the error map.
+ * @param logger - A logger error method reference.
+ * @returns A ErrorMap instance.
+ *
+ * @public
+ */
+export const createErrorMap = (logger) => new DefaultErrorMap(logger);

package/dist/esm/error/index.js

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

package/dist/esm/index.js

@@ -3,6 +3,7 @@ export * from './decorators';
 export * from './design-system';
 export * from './directives';
 export * from './env';
+export * from './error';
 export * from './formatters';
 export * from './logger';
 export * from './mappers';

package/dist/esm/serializers/json/index.js

@@ -1 +1,3 @@
 export * from './json';
+export * from './jsonReplacer';
+export * from './jsonReviver';

package/dist/esm/serializers/json/jsonReplacer.js

@@ -0,0 +1,26 @@
+import { getTypeId, NaNSymbol } from './types';
+/**
+ * JSON replacer function.
+ * @param key - The object key.
+ * @param value - The key value.
+ * @returns The resulting value.
+ * @public
+ */
+export function JSONReplacer(key, value) {
+    if (key) {
+        const first = key[0];
+        if (first === '_' || first === '$') {
+            return void 0;
+        }
+    }
+    if (value !== void 0 && value !== null) {
+        const type = getTypeId(value);
+        if (type) {
+            value.type = type;
+        }
+        else if (Number.isNaN(value)) {
+            return NaNSymbol;
+        }
+    }
+    return value;
+}

package/dist/esm/serializers/json/jsonReviver.js

@@ -0,0 +1,32 @@
+import { getType, ISO8601, NaNSymbol } from './types';
+/**
+ * JSON reviver function.
+ * @param key - The object key.
+ * @param value - The key value.
+ * @returns The resulting value.
+ * @public
+ */
+export function JSONReviver(key, value) {
+    if (typeof value === 'string') {
+        const isDate = ISO8601.exec(value);
+        if (isDate) {
+            return new Date(value);
+        }
+        else if (value === NaNSymbol) {
+            return Number.NaN;
+        }
+    }
+    else {
+        const typeId = value && value.type;
+        if (typeId) {
+            const ctor = getType(typeId);
+            if (ctor) {
+                if ('fromJSON' in ctor) {
+                    return ctor.fromJSON(value);
+                }
+                return new ctor(value);
+            }
+        }
+    }
+    return value;
+}

package/dist/esm/serializers/json/types.js

@@ -0,0 +1,40 @@
+/**
+ * @internal
+ */
+export const ISO8601 = /^\d{4}-(0[1-9]|1[0-2])-([12]\d|0[1-9]|3[01])([T\s](([01]\d|2[0-3])\:[0-5]\d|24\:00)(\:[0-5]\d([\.,]\d+)?)?([zZ]|([\+-])([01]\d|2[0-3])\:?([0-5]\d)?)?)?$/;
+/**
+ * @internal
+ */
+export const NaNSymbol = '$NaN';
+/**
+ * @internal
+ */
+const keyToConstructor = new Map();
+/**
+ * @internal
+ */
+export const getType = (typeId) => keyToConstructor.get(typeId);
+/**
+ * @internal
+ */
+export const getTypeId = (object) => {
+    if (object) {
+        if (object.type) {
+            return object.type;
+        }
+        const proto = Object.getPrototypeOf(object);
+        if (!proto) {
+            return void 0;
+        }
+        const ctor = proto.constructor;
+        if (!ctor) {
+            return void 0;
+        }
+        for (const [key, value] of keyToConstructor) {
+            if (ctor === value) {
+                return key;
+            }
+        }
+        return void 0;
+    }
+};