@elasticias/utils 0.0.10

package/README.md

@@ -0,0 +1,7 @@
+# utils
+
+This library was generated with [Nx](https://nx.dev).
+
+## Running unit tests
+
+Run `nx test utils` to execute the unit tests.

package/fesm2022/elasticias-utils.mjs

@@ -0,0 +1,145 @@
+/**
+ * Configurable prefix-based wrapper for localStorage and sessionStorage.
+ * Default prefix is 'Elasticias_'. Override via `StorageUtils.configure()`.
+ */
+class StorageUtils {
+    static _prefix = 'Elasticias_';
+    static configure(prefix) {
+        StorageUtils._prefix = prefix;
+    }
+    static get prefix() {
+        return StorageUtils._prefix;
+    }
+    static getPrefixedKey(key) {
+        return `${StorageUtils._prefix}${key}`;
+    }
+    static setLocal(key, value) {
+        try {
+            const localKey = this.getPrefixedKey(key);
+            localStorage.setItem(localKey, JSON.stringify(value));
+        }
+        catch (error) {
+            console.error('Error storing data in localStorage: ', key, error);
+        }
+    }
+    static getLocal(key, usePrefix = true) {
+        const localKey = usePrefix ? this.getPrefixedKey(key) : key;
+        const item = localStorage.getItem(localKey);
+        try {
+            if (item) {
+                return JSON.parse(item);
+            }
+        }
+        catch (error) {
+            console.error('Error parsing JSON from localStorage: ', key, error);
+        }
+        return null;
+    }
+    static removeLocal(key) {
+        localStorage.removeItem(this.getPrefixedKey(key));
+    }
+    static clearLocal() {
+        localStorage.clear();
+    }
+    static setSession(key, value) {
+        const sessionKey = this.getPrefixedKey(key);
+        sessionStorage.setItem(sessionKey, JSON.stringify(value));
+    }
+    static getSession(key) {
+        const sessionKey = this.getPrefixedKey(key);
+        const item = sessionStorage.getItem(sessionKey);
+        return item ? JSON.parse(item) : null;
+    }
+    static removeSession(key) {
+        sessionStorage.removeItem(this.getPrefixedKey(key));
+    }
+    static clearSession() {
+        sessionStorage.clear();
+    }
+    static existsLocal(key) {
+        return localStorage.getItem(this.getPrefixedKey(key)) !== null;
+    }
+    static existsSession(key) {
+        return sessionStorage.getItem(this.getPrefixedKey(key)) !== null;
+    }
+}
+
+class AppUtils {
+    static toCamelCase(str) {
+        if (!str)
+            return '';
+        const words = str
+            .replace(/([a-z])([A-Z])/g, '$1 $2')
+            .split(/[\s_]+/)
+            .filter(Boolean);
+        return words
+            .map((word, index) => {
+            word = word.toLowerCase();
+            return index === 0 ? word : word.charAt(0).toUpperCase() + word.slice(1);
+        })
+            .join('');
+    }
+    static toPascalCase(str) {
+        const words = str.split(/[\s_]+/).filter(Boolean);
+        return words
+            .map((word) => {
+            word = word.toLowerCase();
+            return word.charAt(0).toUpperCase() + word.slice(1);
+        })
+            .join('');
+    }
+    static toSnakeCase(str) {
+        const words = str.split(/[\s_]+/).filter(Boolean);
+        return words.map((word) => word.toLowerCase()).join('_');
+    }
+    static isNullOrEmpty(value) {
+        if (value == null)
+            return true;
+        if (Array.isArray(value) && value.length === 0)
+            return true;
+        if (typeof value === 'object' && Object.keys(value).length === 0)
+            return true;
+        return false;
+    }
+    static truncate(text, maxLength = 50, ellipsis = '...', preserveWords = false) {
+        if (!text)
+            return '';
+        if (text.length <= maxLength)
+            return text;
+        if (maxLength < ellipsis.length + 2) {
+            return text.slice(0, Math.max(0, maxLength - ellipsis.length)) + ellipsis;
+        }
+        const visibleChars = maxLength - ellipsis.length;
+        const startChars = Math.ceil(visibleChars / 2);
+        const endChars = Math.floor(visibleChars / 2);
+        let start = text.slice(0, startChars);
+        let end = text.slice(text.length - endChars);
+        if (preserveWords) {
+            const lastSpaceInStart = start.lastIndexOf(' ');
+            if (lastSpaceInStart > visibleChars * 0.3) {
+                start = start.slice(0, lastSpaceInStart);
+            }
+            const firstSpaceInEnd = end.indexOf(' ');
+            if (firstSpaceInEnd !== -1 && firstSpaceInEnd < endChars * 0.7) {
+                end = end.slice(firstSpaceInEnd + 1);
+            }
+        }
+        return `${start}${ellipsis}${end}`;
+    }
+}
+
+class UuidUtils {
+    static randomUUID() {
+        if (globalThis.crypto && typeof globalThis.crypto.randomUUID === 'function') {
+            return globalThis.crypto.randomUUID();
+        }
+        return `${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;
+    }
+}
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { AppUtils, StorageUtils, UuidUtils };
+//# sourceMappingURL=elasticias-utils.mjs.map

package/fesm2022/elasticias-utils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"elasticias-utils.mjs","sources":["../../../../libs/utils/src/lib/storage.utils.ts","../../../../libs/utils/src/lib/app.utils.ts","../../../../libs/utils/src/lib/uuid.utils.ts","../../../../libs/utils/src/elasticias-utils.ts"],"sourcesContent":["/**\n * Configurable prefix-based wrapper for localStorage and sessionStorage.\n * Default prefix is 'Elasticias_'. Override via `StorageUtils.configure()`.\n */\nexport class StorageUtils {\n  private static _prefix = 'Elasticias_';\n\n  static configure(prefix: string): void {\n    StorageUtils._prefix = prefix;\n  }\n\n  static get prefix(): string {\n    return StorageUtils._prefix;\n  }\n\n  private static getPrefixedKey(key: string): string {\n    return `${StorageUtils._prefix}${key}`;\n  }\n\n  static setLocal(key: string, value: unknown): void {\n    try {\n      const localKey = this.getPrefixedKey(key);\n      localStorage.setItem(localKey, JSON.stringify(value));\n    } catch (error) {\n      console.error('Error storing data in localStorage: ', key, error);\n    }\n  }\n\n  static getLocal<T>(key: string, usePrefix = true): T | null {\n    const localKey = usePrefix ? this.getPrefixedKey(key) : key;\n    const item = localStorage.getItem(localKey);\n    try {\n      if (item) {\n        return JSON.parse(item) as T;\n      }\n    } catch (error) {\n      console.error('Error parsing JSON from localStorage: ', key, error);\n    }\n    return null;\n  }\n\n  static removeLocal(key: string): void {\n    localStorage.removeItem(this.getPrefixedKey(key));\n  }\n\n  static clearLocal(): void {\n    localStorage.clear();\n  }\n\n  static setSession(key: string, value: unknown): void {\n    const sessionKey = this.getPrefixedKey(key);\n    sessionStorage.setItem(sessionKey, JSON.stringify(value));\n  }\n\n  static getSession<T>(key: string): T | null {\n    const sessionKey = this.getPrefixedKey(key);\n    const item = sessionStorage.getItem(sessionKey);\n    return item ? (JSON.parse(item) as T) : null;\n  }\n\n  static removeSession(key: string): void {\n    sessionStorage.removeItem(this.getPrefixedKey(key));\n  }\n\n  static clearSession(): void {\n    sessionStorage.clear();\n  }\n\n  static existsLocal(key: string): boolean {\n    return localStorage.getItem(this.getPrefixedKey(key)) !== null;\n  }\n\n  static existsSession(key: string): boolean {\n    return sessionStorage.getItem(this.getPrefixedKey(key)) !== null;\n  }\n}\n","export class AppUtils {\n  static toCamelCase(str: string): string {\n    if (!str) return '';\n    const words = str\n      .replace(/([a-z])([A-Z])/g, '$1 $2')\n      .split(/[\\s_]+/)\n      .filter(Boolean);\n\n    return words\n      .map((word, index) => {\n        word = word.toLowerCase();\n        return index === 0 ? word : word.charAt(0).toUpperCase() + word.slice(1);\n      })\n      .join('');\n  }\n\n  static toPascalCase(str: string): string {\n    const words = str.split(/[\\s_]+/).filter(Boolean);\n    return words\n      .map((word) => {\n        word = word.toLowerCase();\n        return word.charAt(0).toUpperCase() + word.slice(1);\n      })\n      .join('');\n  }\n\n  static toSnakeCase(str: string): string {\n    const words = str.split(/[\\s_]+/).filter(Boolean);\n    return words.map((word) => word.toLowerCase()).join('_');\n  }\n\n  static isNullOrEmpty(value: unknown): boolean {\n    if (value == null) return true;\n    if (Array.isArray(value) && value.length === 0) return true;\n    if (typeof value === 'object' && Object.keys(value).length === 0) return true;\n    return false;\n  }\n\n  static truncate(\n    text: string | null | undefined,\n    maxLength = 50,\n    ellipsis = '...',\n    preserveWords = false\n  ): string {\n    if (!text) return '';\n    if (text.length <= maxLength) return text;\n\n    if (maxLength < ellipsis.length + 2) {\n      return text.slice(0, Math.max(0, maxLength - ellipsis.length)) + ellipsis;\n    }\n\n    const visibleChars = maxLength - ellipsis.length;\n    const startChars = Math.ceil(visibleChars / 2);\n    const endChars = Math.floor(visibleChars / 2);\n\n    let start = text.slice(0, startChars);\n    let end = text.slice(text.length - endChars);\n\n    if (preserveWords) {\n      const lastSpaceInStart = start.lastIndexOf(' ');\n      if (lastSpaceInStart > visibleChars * 0.3) {\n        start = start.slice(0, lastSpaceInStart);\n      }\n      const firstSpaceInEnd = end.indexOf(' ');\n      if (firstSpaceInEnd !== -1 && firstSpaceInEnd < endChars * 0.7) {\n        end = end.slice(firstSpaceInEnd + 1);\n      }\n    }\n\n    return `${start}${ellipsis}${end}`;\n  }\n}\n","export class UuidUtils {\n  static randomUUID(): string {\n    if (globalThis.crypto && typeof globalThis.crypto.randomUUID === 'function') {\n      return globalThis.crypto.randomUUID();\n    }\n    return `${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;\n  }\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@elasticias/utils",
+  "version": "0.0.10",
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/elasticias/elasticias-framework-ui.git",
+    "directory": "libs/utils"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "module": "fesm2022/elasticias-utils.mjs",
+  "typings": "types/elasticias-utils.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./types/elasticias-utils.d.ts",
+      "default": "./fesm2022/elasticias-utils.mjs"
+    }
+  },
+  "dependencies": {
+    "tslib": "^2.3.0"
+  }
+}

package/types/elasticias-utils.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Configurable prefix-based wrapper for localStorage and sessionStorage.
+ * Default prefix is 'Elasticias_'. Override via `StorageUtils.configure()`.
+ */
+declare class StorageUtils {
+    private static _prefix;
+    static configure(prefix: string): void;
+    static get prefix(): string;
+    private static getPrefixedKey;
+    static setLocal(key: string, value: unknown): void;
+    static getLocal<T>(key: string, usePrefix?: boolean): T | null;
+    static removeLocal(key: string): void;
+    static clearLocal(): void;
+    static setSession(key: string, value: unknown): void;
+    static getSession<T>(key: string): T | null;
+    static removeSession(key: string): void;
+    static clearSession(): void;
+    static existsLocal(key: string): boolean;
+    static existsSession(key: string): boolean;
+}
+
+declare class AppUtils {
+    static toCamelCase(str: string): string;
+    static toPascalCase(str: string): string;
+    static toSnakeCase(str: string): string;
+    static isNullOrEmpty(value: unknown): boolean;
+    static truncate(text: string | null | undefined, maxLength?: number, ellipsis?: string, preserveWords?: boolean): string;
+}
+
+declare class UuidUtils {
+    static randomUUID(): string;
+}
+
+export { AppUtils, StorageUtils, UuidUtils };