@monkvision/common 4.0.0

package/lib/utils/color.utils.d.ts

@@ -0,0 +1,51 @@
+import { InteractiveStatus, RGBA } from '@monkvision/types';
+/**
+ * Returns the RGBA values of the given color. The accepted formats are :
+ * - RGB : rgb(167, 224, 146)
+ * - RGBA : rgb(167, 224, 146, 0.03)
+ * - HEX : #A7E092
+ * - HEX (alpha) : #A7E09208
+ * - HEX (short) : #AE9
+ * - HEX (short + alpha) : #AE98
+ *
+ * This function is case-insensitive and ignores white spaces.
+ */
+export declare function getRGBAFromString(str: string): RGBA;
+/**
+ * Converts RGBA values to their hexadecimal representation.
+ */
+export declare function getHexFromRGBA(rgba: RGBA): string;
+/**
+ * Apply a shade of black or white over the given color.
+ *
+ * @param color A color using the same format accepted by the `getRGBAFromString` function.
+ * @param amount The amount of shade to apply, as a ratio :
+ * - positive values like 0.08 to lighten the color by 8%
+ * - negative values like -0.08 to darken the color by 8%
+ * @see getRGBAFromString
+ */
+export declare function shadeColor(color: string, amount: number): string;
+/**
+ * Returns a new color equal to the given color but with a different alpha value.
+ *
+ * @param color The color to change the alpha value of.
+ * @param amount The alpha value (from 0 to 1).
+ */
+export declare function changeAlpha(color: string, amount: number): string;
+/**
+ * The different ways an interactive element's style is altered when the user interacts with it.
+ */
+export declare enum InteractiveVariation {
+    /**
+     * The element will darken when the user interacts with it (used for light elements).
+     */
+    DARKEN = "darken",
+    /**
+     * The element will lighten when the user interacts with it (used for dark elements).
+     */
+    LIGHTEN = "lighten"
+}
+/**
+ * Create interactive variants (hovered, active...) for the given color.
+ */
+export declare function getInteractiveVariants(color: string, variant?: InteractiveVariation): Record<InteractiveStatus, string>;

package/lib/utils/color.utils.js

@@ -0,0 +1,155 @@
+"use strict";
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getInteractiveVariants = exports.InteractiveVariation = exports.changeAlpha = exports.shadeColor = exports.getHexFromRGBA = exports.getRGBAFromString = void 0;
+var types_1 = require("@monkvision/types");
+var RGBA_REGEXP = /^rgba?\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*(?:,\s*(\d+(?:\.\d+)?)\s*)?\)$/i;
+var HEX_REGEXP = /^#(?:(?:[0-9a-f]{3}){1,2}|(?:[0-9a-f]{4}){1,2})$/i;
+function getRGBAFromRGBAString(str) {
+    var result = str.match(RGBA_REGEXP);
+    if (!result) {
+        return null;
+    }
+    return {
+        r: Number(result[1]),
+        g: Number(result[2]),
+        b: Number(result[3]),
+        a: result[4] ? Number(result[4]) : 1,
+    };
+}
+function getRGBAFromHexString(str) {
+    var _a;
+    if (!HEX_REGEXP.test(str)) {
+        return null;
+    }
+    var colors = [];
+    var increment = str.length > 5 ? 2 : 1;
+    for (var i = 1; i < str.length; i += increment) {
+        colors.push(str.substring(i, i + increment));
+    }
+    colors = colors.map(function (hex) { return parseInt(hex.length > 1 ? hex : "".concat(hex).concat(hex), 16); });
+    return {
+        r: colors[0],
+        g: colors[1],
+        b: colors[2],
+        a: ((_a = colors[3]) !== null && _a !== void 0 ? _a : 255) / 255,
+    };
+}
+function convertColorToHexCode(value) {
+    var rounded = Math.round(value);
+    rounded = rounded > 255 ? 255 : rounded;
+    var hex = rounded.toString(16);
+    return hex.length > 1 ? hex : "0".concat(hex);
+}
+/**
+ * Returns the RGBA values of the given color. The accepted formats are :
+ * - RGB : rgb(167, 224, 146)
+ * - RGBA : rgb(167, 224, 146, 0.03)
+ * - HEX : #A7E092
+ * - HEX (alpha) : #A7E09208
+ * - HEX (short) : #AE9
+ * - HEX (short + alpha) : #AE98
+ *
+ * This function is case-insensitive and ignores white spaces.
+ */
+function getRGBAFromString(str) {
+    var trimmed = str.trim();
+    var result = trimmed.length > 9 ? getRGBAFromRGBAString(trimmed) : getRGBAFromHexString(trimmed);
+    if (!result) {
+        throw new Error("Invalid color format : ".concat(trimmed));
+    }
+    return result;
+}
+exports.getRGBAFromString = getRGBAFromString;
+/**
+ * Converts RGBA values to their hexadecimal representation.
+ */
+function getHexFromRGBA(rgba) {
+    var r = convertColorToHexCode(rgba.r);
+    var g = convertColorToHexCode(rgba.g);
+    var b = convertColorToHexCode(rgba.b);
+    var a = convertColorToHexCode(rgba.a * 255);
+    return "#".concat(r).concat(g).concat(b).concat(a);
+}
+exports.getHexFromRGBA = getHexFromRGBA;
+/**
+ * Apply a shade of black or white over the given color.
+ *
+ * @param color A color using the same format accepted by the `getRGBAFromString` function.
+ * @param amount The amount of shade to apply, as a ratio :
+ * - positive values like 0.08 to lighten the color by 8%
+ * - negative values like -0.08 to darken the color by 8%
+ * @see getRGBAFromString
+ */
+function shadeColor(color, amount) {
+    var _a = getRGBAFromString(color), a = _a.a, rgb = __rest(_a, ["a"]);
+    Object.entries(rgb).forEach(function (_a) {
+        var key = _a[0], value = _a[1];
+        var shaded = value * (1 + amount);
+        rgb[key] = shaded > 255 ? 255 : shaded;
+    });
+    return getHexFromRGBA(__assign({ a: a }, rgb));
+}
+exports.shadeColor = shadeColor;
+/**
+ * Returns a new color equal to the given color but with a different alpha value.
+ *
+ * @param color The color to change the alpha value of.
+ * @param amount The alpha value (from 0 to 1).
+ */
+function changeAlpha(color, amount) {
+    var _a = getRGBAFromString(color), _ = _a.a, rgb = __rest(_a, ["a"]);
+    return getHexFromRGBA(__assign({ a: amount }, rgb));
+}
+exports.changeAlpha = changeAlpha;
+/**
+ * The different ways an interactive element's style is altered when the user interacts with it.
+ */
+var InteractiveVariation;
+(function (InteractiveVariation) {
+    /**
+     * The element will darken when the user interacts with it (used for light elements).
+     */
+    InteractiveVariation["DARKEN"] = "darken";
+    /**
+     * The element will lighten when the user interacts with it (used for dark elements).
+     */
+    InteractiveVariation["LIGHTEN"] = "lighten";
+})(InteractiveVariation = exports.InteractiveVariation || (exports.InteractiveVariation = {}));
+/**
+ * Create interactive variants (hovered, active...) for the given color.
+ */
+function getInteractiveVariants(color, variant) {
+    var _a;
+    if (variant === void 0) { variant = InteractiveVariation.LIGHTEN; }
+    var factor = variant === InteractiveVariation.LIGHTEN ? 1 : -1;
+    return _a = {},
+        _a[types_1.InteractiveStatus.DEFAULT] = color,
+        _a[types_1.InteractiveStatus.HOVERED] = shadeColor(color, factor * 0.08),
+        _a[types_1.InteractiveStatus.ACTIVE] = shadeColor(color, factor * 0.12),
+        _a[types_1.InteractiveStatus.DISABLED] = color,
+        _a;
+}
+exports.getInteractiveVariants = getInteractiveVariants;
+//# sourceMappingURL=color.utils.js.map

package/lib/utils/color.utils.js.map

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

package/lib/utils/env.utils.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Utility function that returns the value of a given environment variable. If the value does not exist, it throws an
+ * error.
+ */
+export declare function getEnvOrThrow(name: string): string;

package/lib/utils/env.utils.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getEnvOrThrow = void 0;
+/**
+ * Utility function that returns the value of a given environment variable. If the value does not exist, it throws an
+ * error.
+ */
+function getEnvOrThrow(name) {
+    var value = process.env[name];
+    if (!value) {
+        throw new Error("Required environment variable ".concat(name, " is not defined."));
+    }
+    return value;
+}
+exports.getEnvOrThrow = getEnvOrThrow;
+//# sourceMappingURL=env.utils.js.map

package/lib/utils/env.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.utils.js","sourceRoot":"","sources":["../../src/utils/env.utils.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,SAAgB,aAAa,CAAC,IAAY;IACxC,IAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,CAAC,KAAK,EAAE;QACV,MAAM,IAAI,KAAK,CAAC,wCAAiC,IAAI,qBAAkB,CAAC,CAAC;KAC1E;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAND,sCAMC"}

package/lib/utils/index.d.ts

@@ -0,0 +1,9 @@
+export * from './string.utils';
+export * from './array.utils';
+export * from './color.utils';
+export * from './mimetype.utils';
+export * from './promise.utils';
+export * from './zlib.utils';
+export * from './browser.utils';
+export * from './env.utils';
+export * from './state.utils';

package/lib/utils/index.js

@@ -0,0 +1,26 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./string.utils"), exports);
+__exportStar(require("./array.utils"), exports);
+__exportStar(require("./color.utils"), exports);
+__exportStar(require("./mimetype.utils"), exports);
+__exportStar(require("./promise.utils"), exports);
+__exportStar(require("./zlib.utils"), exports);
+__exportStar(require("./browser.utils"), exports);
+__exportStar(require("./env.utils"), exports);
+__exportStar(require("./state.utils"), exports);
+//# sourceMappingURL=index.js.map

package/lib/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B;AAC/B,gDAA8B;AAC9B,gDAA8B;AAC9B,mDAAiC;AACjC,kDAAgC;AAChC,+CAA6B;AAC7B,kDAAgC;AAChC,8CAA4B;AAC5B,gDAA8B"}

package/lib/utils/mimetype.utils.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Datamap that associates mimetypes to known file extensions corresponding to this mimetype.
+ */
+export declare const MIMETYPE_FILE_EXTENSIONS: Record<string, string[]>;
+/**
+ * Returns a list of file extensions known to be corresponding to the given mimetype. If no file extension is known for
+ * this mimetype, this function will throw an error.
+ */
+export declare function getFileExtensions(mimetype: string): string[];
+/**
+ * Returns the mimetype associated with the given file extension. If the file extension is unknown, this function will
+ * throw an error.
+ */
+export declare function getMimetype(fileExtension: string): string;

package/lib/utils/mimetype.utils.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMimetype = exports.getFileExtensions = exports.MIMETYPE_FILE_EXTENSIONS = void 0;
+/**
+ * Datamap that associates mimetypes to known file extensions corresponding to this mimetype.
+ */
+exports.MIMETYPE_FILE_EXTENSIONS = {
+    'text/plain': ['txt'],
+    'text/html': ['html', 'htm', 'shtml'],
+    'text/css': ['css'],
+    'text/xml': ['xml'],
+    'image/gif': ['gif'],
+    'image/jpeg': ['jpeg', 'jpg'],
+    'image/png': ['png'],
+    'image/tiff': ['tif', 'tiff'],
+    'image/vnd.wap.wbmp': ['wbmp'],
+    'image/x-icon': ['ico'],
+    'image/x-jng': ['jng'],
+    'image/x-ms-bmp': ['bmp'],
+    'image/svg+xml': ['svg'],
+    'image/webp': ['webp'],
+    'application/octet-stream': ['bin', 'exe', 'dll', 'eot', 'iso', 'img', 'msi', 'msp', 'msm'],
+    'application/x-javascript': ['js'],
+    'application/pdf': ['pdf'],
+    'application/xhtml+xml': ['xhtml'],
+    'application/zip': ['zip'],
+    'audio/midi': ['mid', 'midi', 'kar'],
+    'audio/mpeg': ['mp3'],
+    'audio/ogg': ['ogg'],
+    'audio/x-realaudio': ['ra'],
+    'video/3gpp': ['3gpp', '3gp'],
+    'video/mpeg': ['mpeg', 'mpg'],
+    'video/quicktime': ['mov'],
+    'video/x-flv': ['flv'],
+    'video/x-mng': ['mng'],
+    'video/x-ms-asf': ['asx', 'asf'],
+    'video/x-ms-wmv': ['wmv'],
+    'video/x-msvideo': ['avi'],
+    'video/mp4': ['m4v', 'mp4'],
+};
+/**
+ * Returns a list of file extensions known to be corresponding to the given mimetype. If no file extension is known for
+ * this mimetype, this function will throw an error.
+ */
+function getFileExtensions(mimetype) {
+    var extensions = exports.MIMETYPE_FILE_EXTENSIONS[mimetype];
+    if (!extensions) {
+        throw new Error("Unknown mimetype : ".concat(mimetype));
+    }
+    return extensions;
+}
+exports.getFileExtensions = getFileExtensions;
+/**
+ * Returns the mimetype associated with the given file extension. If the file extension is unknown, this function will
+ * throw an error.
+ */
+function getMimetype(fileExtension) {
+    var _a;
+    var mimetype = (_a = Object.entries(exports.MIMETYPE_FILE_EXTENSIONS).find(function (_a) {
+        var extensions = _a[1];
+        return extensions.includes(fileExtension);
+    })) === null || _a === void 0 ? void 0 : _a[0];
+    if (!mimetype) {
+        throw new Error("Unknown file extension : ".concat(fileExtension));
+    }
+    return mimetype;
+}
+exports.getMimetype = getMimetype;
+//# sourceMappingURL=mimetype.utils.js.map

package/lib/utils/mimetype.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mimetype.utils.js","sourceRoot":"","sources":["../../src/utils/mimetype.utils.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACU,QAAA,wBAAwB,GAA6B;IAChE,YAAY,EAAE,CAAC,KAAK,CAAC;IACrB,WAAW,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC;IACrC,UAAU,EAAE,CAAC,KAAK,CAAC;IACnB,UAAU,EAAE,CAAC,KAAK,CAAC;IAEnB,WAAW,EAAE,CAAC,KAAK,CAAC;IACpB,YAAY,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC;IAC7B,WAAW,EAAE,CAAC,KAAK,CAAC;IACpB,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC;IAC7B,oBAAoB,EAAE,CAAC,MAAM,CAAC;IAC9B,cAAc,EAAE,CAAC,KAAK,CAAC;IACvB,aAAa,EAAE,CAAC,KAAK,CAAC;IACtB,gBAAgB,EAAE,CAAC,KAAK,CAAC;IACzB,eAAe,EAAE,CAAC,KAAK,CAAC;IACxB,YAAY,EAAE,CAAC,MAAM,CAAC;IAEtB,0BAA0B,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IAC3F,0BAA0B,EAAE,CAAC,IAAI,CAAC;IAClC,iBAAiB,EAAE,CAAC,KAAK,CAAC;IAC1B,uBAAuB,EAAE,CAAC,OAAO,CAAC;IAClC,iBAAiB,EAAE,CAAC,KAAK,CAAC;IAE1B,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC;IACpC,YAAY,EAAE,CAAC,KAAK,CAAC;IACrB,WAAW,EAAE,CAAC,KAAK,CAAC;IACpB,mBAAmB,EAAE,CAAC,IAAI,CAAC;IAE3B,YAAY,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC;IAC7B,YAAY,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC;IAC7B,iBAAiB,EAAE,CAAC,KAAK,CAAC;IAC1B,aAAa,EAAE,CAAC,KAAK,CAAC;IACtB,aAAa,EAAE,CAAC,KAAK,CAAC;IACtB,gBAAgB,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC;IAChC,gBAAgB,EAAE,CAAC,KAAK,CAAC;IACzB,iBAAiB,EAAE,CAAC,KAAK,CAAC;IAC1B,WAAW,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC;CAC5B,CAAC;AAEF;;;GAGG;AACH,SAAgB,iBAAiB,CAAC,QAAgB;IAChD,IAAM,UAAU,GAAG,gCAAwB,CAAC,QAAQ,CAAC,CAAC;IACtD,IAAI,CAAC,UAAU,EAAE;QACf,MAAM,IAAI,KAAK,CAAC,6BAAsB,QAAQ,CAAE,CAAC,CAAC;KACnD;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAND,8CAMC;AAED;;;GAGG;AACH,SAAgB,WAAW,CAAC,aAAqB;;IAC/C,IAAM,QAAQ,GAAG,MAAA,MAAM,CAAC,OAAO,CAAC,gCAAwB,CAAC,CAAC,IAAI,CAAC,UAAC,EAAc;YAAX,UAAU,QAAA;QAC3E,OAAA,UAAU,CAAC,QAAQ,CAAC,aAAa,CAAC;IAAlC,CAAkC,CACnC,0CAAG,CAAC,CAAC,CAAC;IACP,IAAI,CAAC,QAAQ,EAAE;QACb,MAAM,IAAI,KAAK,CAAC,mCAA4B,aAAa,CAAE,CAAC,CAAC;KAC9D;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AARD,kCAQC"}

package/lib/utils/promise.utils.d.ts

@@ -0,0 +1,4 @@
+/**
+ * This function creates and returns a new Promise that will resolve to void after the given amount of milliseconds.
+ */
+export declare function timeoutPromise(delayMs: number): Promise<void>;

package/lib/utils/promise.utils.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.timeoutPromise = void 0;
+/**
+ * This function creates and returns a new Promise that will resolve to void after the given amount of milliseconds.
+ */
+function timeoutPromise(delayMs) {
+    return new Promise(function (resolve) {
+        setTimeout(function () { return resolve(); }, delayMs);
+    });
+}
+exports.timeoutPromise = timeoutPromise;
+//# sourceMappingURL=promise.utils.js.map

package/lib/utils/promise.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promise.utils.js","sourceRoot":"","sources":["../../src/utils/promise.utils.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,SAAgB,cAAc,CAAC,OAAe;IAC5C,OAAO,IAAI,OAAO,CAAC,UAAC,OAAO;QACzB,UAAU,CAAC,cAAM,OAAA,OAAO,EAAE,EAAT,CAAS,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;AACL,CAAC;AAJD,wCAIC"}

package/lib/utils/state.utils.d.ts

@@ -0,0 +1,9 @@
+import { Image } from '@monkvision/types';
+/**
+ * Utility function that extracts the images of the given inspection.
+ *
+ * @param inspectionId The ID of the inspection to get the images of.
+ * @param images Array containing every image existing in the current local state.
+ * @param filterRetakes Boolean indicating if retaken pictures should be filtered out or not (default: false).
+ */
+export declare function getInspectionImages(inspectionId: string, images: Image[], filterRetakes?: boolean): Image[];

package/lib/utils/state.utils.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getInspectionImages = void 0;
+/**
+ * Utility function that extracts the images of the given inspection.
+ *
+ * @param inspectionId The ID of the inspection to get the images of.
+ * @param images Array containing every image existing in the current local state.
+ * @param filterRetakes Boolean indicating if retaken pictures should be filtered out or not (default: false).
+ */
+function getInspectionImages(inspectionId, images, filterRetakes) {
+    if (filterRetakes === void 0) { filterRetakes = false; }
+    var inspectionImages = images.filter(function (image) { return image.inspectionId === inspectionId; });
+    if (!filterRetakes) {
+        return inspectionImages;
+    }
+    var filteredRetakes = [];
+    inspectionImages.forEach(function (image) {
+        if (image.sightId) {
+            var index = filteredRetakes.findIndex(function (i) { return i.sightId === image.sightId; });
+            if (index >= 0) {
+                if (image.createdAt &&
+                    filteredRetakes[index].createdAt &&
+                    image.createdAt > filteredRetakes[index].createdAt) {
+                    filteredRetakes[index] = image;
+                }
+                return;
+            }
+        }
+        filteredRetakes.push(image);
+    });
+    return filteredRetakes;
+}
+exports.getInspectionImages = getInspectionImages;
+//# sourceMappingURL=state.utils.js.map

package/lib/utils/state.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.utils.js","sourceRoot":"","sources":["../../src/utils/state.utils.ts"],"names":[],"mappings":";;;AAEA;;;;;;GAMG;AACH,SAAgB,mBAAmB,CACjC,YAAoB,EACpB,MAAe,EACf,aAAqB;IAArB,8BAAA,EAAA,qBAAqB;IAErB,IAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,CAAC,UAAC,KAAK,IAAK,OAAA,KAAK,CAAC,YAAY,KAAK,YAAY,EAAnC,CAAmC,CAAC,CAAC;IACvF,IAAI,CAAC,aAAa,EAAE;QAClB,OAAO,gBAAgB,CAAC;KACzB;IACD,IAAM,eAAe,GAAY,EAAE,CAAC;IACpC,gBAAgB,CAAC,OAAO,CAAC,UAAC,KAAK;QAC7B,IAAI,KAAK,CAAC,OAAO,EAAE;YACjB,IAAM,KAAK,GAAG,eAAe,CAAC,SAAS,CAAC,UAAC,CAAC,IAAK,OAAA,CAAC,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO,EAA3B,CAA2B,CAAC,CAAC;YAC5E,IAAI,KAAK,IAAI,CAAC,EAAE;gBACd,IACE,KAAK,CAAC,SAAS;oBACf,eAAe,CAAC,KAAK,CAAC,CAAC,SAAS;oBAChC,KAAK,CAAC,SAAS,GAAI,eAAe,CAAC,KAAK,CAAC,CAAC,SAAoB,EAC9D;oBACA,eAAe,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC;iBAChC;gBACD,OAAO;aACR;SACF;QACD,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IACH,OAAO,eAAe,CAAC;AACzB,CAAC;AA3BD,kDA2BC"}

package/lib/utils/string.utils.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Suffixes a string with the given suffixes, only if their value is `true` in the suffixes object param.
+ *
+ * Note : The order of the suffixes is not guaranteed.
+ */
+export declare function suffix(str: string, suffixes?: Record<string, boolean | undefined | null>, separator?: string): string;
+/**
+ * Split the given string into its composing words.
+ */
+export declare function words(str: string): string[];
+/**
+ * Capitalizes (transforms the first character to upper case) the given string.
+ */
+export declare function capitalize(str: string): string;
+/**
+ * Uncapitalizes (transforms the first character to lower case) the given string.
+ */
+export declare function uncapitalize(str: string): string;
+/**
+ * Converts a string to camel case.
+ */
+export declare function toCamelCase(str: string): string;

package/lib/utils/string.utils.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toCamelCase = exports.uncapitalize = exports.capitalize = exports.words = exports.suffix = void 0;
+var WORD_PATTERN = /[A-Z][a-z]+|[A-Z]+(?=[A-Z][a-z])|[A-Z]+|[a-z]+|\d+/g;
+/**
+ * Suffixes a string with the given suffixes, only if their value is `true` in the suffixes object param.
+ *
+ * Note : The order of the suffixes is not guaranteed.
+ */
+function suffix(str, suffixes, separator) {
+    if (separator === void 0) { separator = ' '; }
+    return suffixes
+        ? Object.keys(suffixes).reduce(function (prev, curr) { return "".concat(prev).concat(suffixes[curr] ? separator + curr : ''); }, str)
+        : str;
+}
+exports.suffix = suffix;
+/**
+ * Split the given string into its composing words.
+ */
+function words(str) {
+    var _a;
+    return (_a = str.match(WORD_PATTERN)) !== null && _a !== void 0 ? _a : [];
+}
+exports.words = words;
+/**
+ * Capitalizes (transforms the first character to upper case) the given string.
+ */
+function capitalize(str) {
+    return str.charAt(0).toUpperCase() + str.slice(1);
+}
+exports.capitalize = capitalize;
+/**
+ * Uncapitalizes (transforms the first character to lower case) the given string.
+ */
+function uncapitalize(str) {
+    return str.charAt(0).toLowerCase() + str.slice(1);
+}
+exports.uncapitalize = uncapitalize;
+/**
+ * Converts a string to camel case.
+ */
+function toCamelCase(str) {
+    return words(str)
+        .map(function (word, index) { return (index === 0 ? word.toLowerCase() : capitalize(word.toLowerCase())); })
+        .join('');
+}
+exports.toCamelCase = toCamelCase;
+//# sourceMappingURL=string.utils.js.map

package/lib/utils/string.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.utils.js","sourceRoot":"","sources":["../../src/utils/string.utils.ts"],"names":[],"mappings":";;;AAAA,IAAM,YAAY,GAAG,qDAAqD,CAAC;AAE3E;;;;GAIG;AACH,SAAgB,MAAM,CACpB,GAAW,EACX,QAAqD,EACrD,SAAe;IAAf,0BAAA,EAAA,eAAe;IAEf,OAAO,QAAQ;QACb,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,CAC1B,UAAC,IAAI,EAAE,IAAI,IAAK,OAAA,UAAG,IAAI,SAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,CAAE,EAAlD,CAAkD,EAClE,GAAG,CACJ;QACH,CAAC,CAAC,GAAG,CAAC;AACV,CAAC;AAXD,wBAWC;AAED;;GAEG;AACH,SAAgB,KAAK,CAAC,GAAW;;IAC/B,OAAO,MAAA,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,mCAAI,EAAE,CAAC;AACvC,CAAC;AAFD,sBAEC;AAED;;GAEG;AACH,SAAgB,UAAU,CAAC,GAAW;IACpC,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACpD,CAAC;AAFD,gCAEC;AAED;;GAEG;AACH,SAAgB,YAAY,CAAC,GAAW;IACtC,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACpD,CAAC;AAFD,oCAEC;AAED;;GAEG;AACH,SAAgB,WAAW,CAAC,GAAW;IACrC,OAAO,KAAK,CAAC,GAAG,CAAC;SACd,GAAG,CAAC,UAAC,IAAI,EAAE,KAAK,IAAK,OAAA,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,EAAnE,CAAmE,CAAC;SACzF,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC;AAJD,kCAIC"}

package/lib/utils/zlib.utils.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Compresses and encodes a string in base64 using the ZLib algorithm.
+ */
+export declare function zlibCompress(str: string): string;
+/**
+ * Decompresses a string that has been encoded in base64 and compressed using the Zlib algorithm.
+ */
+export declare function zlibDecompress(str: string): string;

package/lib/utils/zlib.utils.js

@@ -0,0 +1,30 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.zlibDecompress = exports.zlibCompress = void 0;
+var pako_1 = __importDefault(require("pako"));
+/**
+ * Compresses and encodes a string in base64 using the ZLib algorithm.
+ */
+function zlibCompress(str) {
+    var binaryConverter = new TextEncoder();
+    var binary = binaryConverter.encode(str);
+    var compressed = pako_1.default.deflate(binary);
+    return btoa(String.fromCharCode.apply(null, Array.from(compressed)));
+}
+exports.zlibCompress = zlibCompress;
+/**
+ * Decompresses a string that has been encoded in base64 and compressed using the Zlib algorithm.
+ */
+function zlibDecompress(str) {
+    var compressed = new Uint8Array(atob(str)
+        .split('')
+        .map(function (c) { return c.charCodeAt(0); }));
+    var binary = pako_1.default.inflate(compressed);
+    var binaryConverter = new TextDecoder('utf-8');
+    return binaryConverter.decode(binary);
+}
+exports.zlibDecompress = zlibDecompress;
+//# sourceMappingURL=zlib.utils.js.map

package/lib/utils/zlib.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zlib.utils.js","sourceRoot":"","sources":["../../src/utils/zlib.utils.ts"],"names":[],"mappings":";;;;;;AAAA,8CAAwB;AAExB;;GAEG;AACH,SAAgB,YAAY,CAAC,GAAW;IACtC,IAAM,eAAe,GAAG,IAAI,WAAW,EAAE,CAAC;IAC1C,IAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3C,IAAM,UAAU,GAAG,cAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACxC,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;AACvE,CAAC;AALD,oCAKC;AAED;;GAEG;AACH,SAAgB,cAAc,CAAC,GAAW;IACxC,IAAM,UAAU,GAAG,IAAI,UAAU,CAC/B,IAAI,CAAC,GAAG,CAAC;SACN,KAAK,CAAC,EAAE,CAAC;SACT,GAAG,CAAC,UAAC,CAAC,IAAK,OAAA,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAf,CAAe,CAAC,CAC/B,CAAC;IACF,IAAM,MAAM,GAAG,cAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACxC,IAAM,eAAe,GAAG,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC;IACjD,OAAO,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AACxC,CAAC;AATD,wCASC"}