@lichens-innovation/ts-common 1.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Lichens Innovation
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,58 @@
+# ts-common
+
+Reusable generic typescript utilities, types, constants, helpers
+
+[![standard-readme compliant](https://img.shields.io/badge/readme%20style-standard-brightgreen.svg?style=flat-square)](https://github.com/RichardLitt/standard-readme)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.9-blue.svg?style=flat-square&logo=typescript)](https://www.typescriptlang.org/)
+[![Node.js](https://img.shields.io/badge/Node.js-LTS-green.svg?style=flat-square&logo=node.js)](https://nodejs.org/)
+[![License](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE)
+[![Vitest](https://img.shields.io/badge/Vitest-4.0-6E9F18.svg?style=flat-square&logo=vitest)](https://vitest.dev/)
+[![Yarn](https://img.shields.io/badge/Yarn-1.22+-2C8EBB.svg?style=flat-square&logo=yarn)](https://yarnpkg.com/)
+
+Table of content
+- [ts-common](#ts-common)
+  - [Prerequisites](#prerequisites)
+  - [Scripts](#scripts)
+  - [Contributions](#contributions)
+  - [Unit tests](#unit-tests)
+  - [Library semantic versioning](#library-semantic-versioning)
+  - [Project coding guidelines](#project-coding-guidelines)
+
+## Prerequisites
+
+- Node.js (LTS or higher)
+- Yarn
+
+## Scripts
+
+| Command                      | Description                                                                 |
+|------------------------------|-----------------------------------------------------------------------------|
+| `yarn build`                 | Cleans the dist folder and compiles TypeScript                              |
+| `yarn clean:node`            | Removes node_modules directories and yarn.lock file                         |
+| `yarn clean:dist`            | Removes the dist directory                                                  |
+| `yarn typecheck`             | Checks TypeScript types without emitting files                              |
+| `yarn test`                  | Runs tests using Vitest                                                     |
+| `yarn test:coverage`         | Runs tests with coverage report using Vitest                                |
+| `yarn test:watch`            | Runs tests in watch mode using Vitest                                       |
+
+## Contributions
+
+Contributions to the project are made by simply improving the current codebase and then creating a Pull Request. If the version field in `package.json` is incremented, the build will be automatically triggered when the PR is merged into the `main` branch, and the new version will be published to our enterprise Git repository.
+
+## Unit tests
+
+Test coverage must be maintained at 80% or higher. It is therefore important to always attempt to cover new code that is added with appropriate tests.
+
+## Library semantic versioning
+
+When there is a breaking change, [Semantic Versioning](https://semver.org/#summary) must be used to indicate that a major behavior has changed. Semantic Versioning follows the `MAJOR.MINOR.PATCH` format:
+
+* `MAJOR` version when you make incompatible API changes
+* `MINOR` version when you add functionality in a backward compatible manner
+* `PATCH` version when you make backward compatible bug fixes
+
+## Project coding guidelines
+
+Adhering to established coding guidelines is essential for developing efficient, maintainable, and scalable software. These guidelines promote consistency across codebases, making it easier for teams to collaborate and for new developers to understand existing code. By following standardized patterns, such as those outlined in the [Coding guidelines](https://github.com/amwebexpert/chrome-extensions-collection/blob/master/packages/coding-guide-helper/public/markdowns/table-of-content.md), developers can reduce errors and enhance code readability.
+
+* [Coding guidelines](https://github.com/amwebexpert/chrome-extensions-collection/blob/master/packages/coding-guide-helper/public/markdowns/table-of-content.md)

package/dist/index.d.ts

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

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from "./utils";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/utils/date.utils.d.ts

@@ -0,0 +1,9 @@
+export type DateInput = Date | string | number | null;
+export declare const dateAs_HHMMSS: (value?: DateInput) => string;
+export declare const dateAs_YYYYMMDD: (value?: DateInput) => string;
+export declare const dateAs_YYYYMMDD_HHMMSS: (value?: DateInput) => string;
+export declare const nowAsTime: () => string;
+export declare const nowAsDate: () => string;
+export declare const nowAsDateTime: () => string;
+export declare const nowAsDateTimeForFilename: () => string;
+//# sourceMappingURL=date.utils.d.ts.map

package/dist/utils/date.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.utils.d.ts","sourceRoot":"","sources":["../../src/utils/date.utils.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;AAEtD,eAAO,MAAM,aAAa,GAAI,QAAQ,SAAS,WAG9C,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,QAAQ,SAAS,WAGhD,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,QAAQ,SAAS,WAGvD,CAAC;AAEF,eAAO,MAAM,SAAS,cAAkC,CAAC;AACzD,eAAO,MAAM,SAAS,cAAoC,CAAC;AAC3D,eAAO,MAAM,aAAa,cAA2C,CAAC;AAEtE,eAAO,MAAM,wBAAwB,cAEpC,CAAC"}

package/dist/utils/date.utils.js

@@ -0,0 +1,24 @@
+import { format } from "date-fns";
+import { isNullish } from "./types.utils";
+export const dateAs_HHMMSS = (value) => {
+    if (isNullish(value))
+        return "";
+    return format(value, "HH:mm:ss");
+};
+export const dateAs_YYYYMMDD = (value) => {
+    if (isNullish(value))
+        return "";
+    return format(value, "yyyy-MM-dd");
+};
+export const dateAs_YYYYMMDD_HHMMSS = (value) => {
+    if (isNullish(value))
+        return "";
+    return format(value, "yyyy-MM-dd HH:mm:ss");
+};
+export const nowAsTime = () => dateAs_HHMMSS(new Date());
+export const nowAsDate = () => dateAs_YYYYMMDD(new Date());
+export const nowAsDateTime = () => dateAs_YYYYMMDD_HHMMSS(new Date());
+export const nowAsDateTimeForFilename = () => {
+    return format(new Date(), "yyyy-MM-dd_HH-mm-ss");
+};
+//# sourceMappingURL=date.utils.js.map

package/dist/utils/date.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.utils.js","sourceRoot":"","sources":["../../src/utils/date.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAI1C,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAiB,EAAE,EAAE;IACjD,IAAI,SAAS,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAChC,OAAO,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;AACnC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAiB,EAAE,EAAE;IACnD,IAAI,SAAS,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAChC,OAAO,MAAM,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;AACrC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,KAAiB,EAAE,EAAE;IAC1D,IAAI,SAAS,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAChC,OAAO,MAAM,CAAC,KAAK,EAAE,qBAAqB,CAAC,CAAC;AAC9C,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC,aAAa,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;AACzD,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC,eAAe,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;AAC3D,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,EAAE,CAAC,sBAAsB,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;AAEtE,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,EAAE;IAC3C,OAAO,MAAM,CAAC,IAAI,IAAI,EAAE,EAAE,qBAAqB,CAAC,CAAC;AACnD,CAAC,CAAC"}

package/dist/utils/errors.utils.d.ts

@@ -0,0 +1,2 @@
+export declare const getErrorMessage: (error: unknown) => string;
+//# sourceMappingURL=errors.utils.d.ts.map

package/dist/utils/errors.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.utils.d.ts","sourceRoot":"","sources":["../../src/utils/errors.utils.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,GAAI,OAAO,OAAO,KAAG,MAchD,CAAC"}

package/dist/utils/errors.utils.js

@@ -0,0 +1,13 @@
+export const getErrorMessage = (error) => {
+    if (!error) {
+        return "";
+    }
+    if (typeof error === "string") {
+        return error;
+    }
+    if (typeof error === "object" && "message" in error) {
+        return error.message;
+    }
+    return JSON.stringify(error);
+};
+//# sourceMappingURL=errors.utils.js.map

package/dist/utils/errors.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.utils.js","sourceRoot":"","sources":["../../src/utils/errors.utils.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAc,EAAU,EAAE;IACxD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,SAAS,IAAI,KAAK,EAAE,CAAC;QACpD,OAAQ,KAA6B,CAAC,OAAO,CAAC;IAChD,CAAC;IAED,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC,CAAC"}

package/dist/utils/http.utils.d.ts

@@ -0,0 +1,4 @@
+export declare const isHttpSuccessStatus: (status?: number | null) => boolean;
+export declare const isHttpClientErrorStatus: (status?: number | null) => boolean;
+export declare const isHttpServerErrorStatus: (status?: number | null) => boolean;
+//# sourceMappingURL=http.utils.d.ts.map

package/dist/utils/http.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.utils.d.ts","sourceRoot":"","sources":["../../src/utils/http.utils.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,mBAAmB,GAAI,SAAS,MAAM,GAAG,IAAI,KAAG,OAM5D,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAI,SAAS,MAAM,GAAG,IAAI,KAAG,OAMhE,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAI,SAAS,MAAM,GAAG,IAAI,KAAG,OAMhE,CAAC"}

package/dist/utils/http.utils.js

@@ -0,0 +1,20 @@
+import { isNullish } from './types.utils';
+export const isHttpSuccessStatus = (status) => {
+    if (isNullish(status)) {
+        return false;
+    }
+    return status >= 200 && status < 300;
+};
+export const isHttpClientErrorStatus = (status) => {
+    if (isNullish(status)) {
+        return false;
+    }
+    return status >= 400 && status < 500;
+};
+export const isHttpServerErrorStatus = (status) => {
+    if (isNullish(status)) {
+        return false;
+    }
+    return status >= 500;
+};
+//# sourceMappingURL=http.utils.js.map

package/dist/utils/http.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.utils.js","sourceRoot":"","sources":["../../src/utils/http.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,MAAsB,EAAW,EAAE;IACrE,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QACtB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG,CAAC;AACvC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,MAAsB,EAAW,EAAE;IACzE,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QACtB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG,CAAC;AACvC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,MAAsB,EAAW,EAAE;IACzE,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QACtB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,MAAM,IAAI,GAAG,CAAC;AACvB,CAAC,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,11 @@
+export * from './date.utils';
+export * from './errors.utils';
+export * from './http.utils';
+export * from './number.utils';
+export * from './regex';
+export * from './string.utils';
+export * from './thread.utils';
+export * from './time.utils';
+export * from './types.utils';
+export * from './units.utils';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,11 @@
+export * from './date.utils';
+export * from './errors.utils';
+export * from './http.utils';
+export * from './number.utils';
+export * from './regex';
+export * from './string.utils';
+export * from './thread.utils';
+export * from './time.utils';
+export * from './types.utils';
+export * from './units.utils';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC"}

package/dist/utils/number.utils.d.ts

@@ -0,0 +1,2 @@
+export declare const toFixed: (value?: number | null, decimals?: number) => number;
+//# sourceMappingURL=number.utils.d.ts.map

package/dist/utils/number.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"number.utils.d.ts","sourceRoot":"","sources":["../../src/utils/number.utils.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,OAAO,GAAI,QAAQ,MAAM,GAAG,IAAI,EAAE,iBAAY,KAAG,MAO7D,CAAC"}

package/dist/utils/number.utils.js

@@ -0,0 +1,13 @@
+import { isNullish } from "./types.utils";
+// Example: toFixed(3.14159, 3) // 3.142
+export const toFixed = (value, decimals = 0) => {
+    if (isNullish(value))
+        return 0;
+    if (decimals < 0)
+        throw new Error("[toFixed] decimals must be >= 0");
+    if (decimals === 0)
+        return Math.round(value);
+    const multiplier = Math.pow(10, decimals);
+    return Math.round(value * multiplier) / multiplier;
+};
+//# sourceMappingURL=number.utils.js.map

package/dist/utils/number.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"number.utils.js","sourceRoot":"","sources":["../../src/utils/number.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,wCAAwC;AACxC,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,KAAqB,EAAE,QAAQ,GAAG,CAAC,EAAU,EAAE;IACrE,IAAI,SAAS,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAC/B,IAAI,QAAQ,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACrE,IAAI,QAAQ,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAE7C,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IAC1C,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,UAAU,CAAC,GAAG,UAAU,CAAC;AACrD,CAAC,CAAC"}

package/dist/utils/regex.d.ts

@@ -0,0 +1,2 @@
+export declare const REGEX_ALPHANUMERIC: RegExp;
+//# sourceMappingURL=regex.d.ts.map

package/dist/utils/regex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"regex.d.ts","sourceRoot":"","sources":["../../src/utils/regex.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,QAAgC,CAAC"}

package/dist/utils/regex.js

@@ -0,0 +1,2 @@
+export const REGEX_ALPHANUMERIC = /^[a-zA-Z0-9-_ $%#(){}:/.]+$/;
+//# sourceMappingURL=regex.js.map

package/dist/utils/regex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"regex.js","sourceRoot":"","sources":["../../src/utils/regex.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG,6BAA6B,CAAC"}

package/dist/utils/string.utils.d.ts

@@ -0,0 +1,17 @@
+export declare const isBlank: (str?: string | null) => str is null | undefined | "";
+export declare const isNotBlank: (str?: string | null) => str is string;
+export declare const isAlphanumeric: (value: string) => boolean;
+/**
+ * Removes diacritical marks (e.g., accents, umlauts) from a string.
+ * This method normalizes the input string to its canonical decomposition
+ * form (NFD) and removes any combining diacritical marks.
+ *
+ * @param {string} value - The input string to normalize.
+ * @returns {string} - The normalized string with diacritical marks removed.
+ *
+ * @example
+ * const result = removeDiacriticalMarks("Ça va très bien, n'est-ce pas?");
+ * console.log(result); // "Ca va tres bien, n'est-ce pas?"
+ */
+export declare const removeDiacriticalMarks: (value: string) => string;
+//# sourceMappingURL=string.utils.d.ts.map

package/dist/utils/string.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.utils.d.ts","sourceRoot":"","sources":["../../src/utils/string.utils.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,OAAO,GAAI,MAAM,MAAM,GAAG,IAAI,KAAG,GAAG,IAAI,IAAI,GAAG,SAAS,GAAG,EAEvE,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,GAAG,IAAI,KAAG,GAAG,IAAI,MAEvD,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,KAAG,OAE9C,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,sBAAsB,GAAI,OAAO,MAAM,KAAG,MAMtD,CAAC"}

package/dist/utils/string.utils.js

@@ -0,0 +1,30 @@
+import { REGEX_ALPHANUMERIC } from './regex';
+import { isNullish } from './types.utils';
+export const isBlank = (str) => {
+    return isNullish(str) || str?.trim() === '';
+};
+export const isNotBlank = (str) => {
+    return !isBlank(str);
+};
+export const isAlphanumeric = (value) => {
+    return REGEX_ALPHANUMERIC.test(value);
+};
+/**
+ * Removes diacritical marks (e.g., accents, umlauts) from a string.
+ * This method normalizes the input string to its canonical decomposition
+ * form (NFD) and removes any combining diacritical marks.
+ *
+ * @param {string} value - The input string to normalize.
+ * @returns {string} - The normalized string with diacritical marks removed.
+ *
+ * @example
+ * const result = removeDiacriticalMarks("Ça va très bien, n'est-ce pas?");
+ * console.log(result); // "Ca va tres bien, n'est-ce pas?"
+ */
+export const removeDiacriticalMarks = (value) => {
+    if (!value) {
+        return '';
+    }
+    return value.normalize('NFD').replace(/[\u0300-\u036f]/g, '');
+};
+//# sourceMappingURL=string.utils.js.map

package/dist/utils/string.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.utils.js","sourceRoot":"","sources":["../../src/utils/string.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,GAAmB,EAAgC,EAAE;IAC3E,OAAO,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAC9C,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,GAAmB,EAAiB,EAAE;IAC/D,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAa,EAAW,EAAE;IACvD,OAAO,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACxC,CAAC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,KAAa,EAAU,EAAE;IAC9D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC;AAChE,CAAC,CAAC"}

package/dist/utils/thread.utils.d.ts

@@ -0,0 +1,2 @@
+export declare const sleep: (milliseconds: number) => Promise<unknown>;
+//# sourceMappingURL=thread.utils.d.ts.map

package/dist/utils/thread.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread.utils.d.ts","sourceRoot":"","sources":["../../src/utils/thread.utils.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,KAAK,GAAI,cAAc,MAAM,qBACmB,CAAC"}

package/dist/utils/thread.utils.js

@@ -0,0 +1,2 @@
+export const sleep = (milliseconds) => new Promise((resolve) => setTimeout(resolve, milliseconds));
+//# sourceMappingURL=thread.utils.js.map

package/dist/utils/thread.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread.utils.js","sourceRoot":"","sources":["../../src/utils/thread.utils.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,YAAoB,EAAE,EAAE,CAC5C,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC"}

package/dist/utils/time.utils.d.ts

@@ -0,0 +1,7 @@
+export declare const PeriodsInMS: {
+    readonly oneSecond: 1000;
+    readonly oneMinute: number;
+    readonly oneHour: number;
+    readonly oneDay: number;
+};
+//# sourceMappingURL=time.utils.d.ts.map

package/dist/utils/time.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.utils.d.ts","sourceRoot":"","sources":["../../src/utils/time.utils.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,WAAW;;;;;CAKd,CAAC"}

package/dist/utils/time.utils.js

@@ -0,0 +1,11 @@
+const ONE_SECOND_IN_MS = 1000;
+const ONE_MINUTE_IN_MS = 60 * ONE_SECOND_IN_MS;
+const ONE_HOUR_IN_MS = 60 * ONE_MINUTE_IN_MS;
+const ONE_DAY_IN_MS = 24 * ONE_HOUR_IN_MS;
+export const PeriodsInMS = {
+    oneSecond: ONE_SECOND_IN_MS,
+    oneMinute: ONE_MINUTE_IN_MS,
+    oneHour: ONE_HOUR_IN_MS,
+    oneDay: ONE_DAY_IN_MS,
+};
+//# sourceMappingURL=time.utils.js.map

package/dist/utils/time.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.utils.js","sourceRoot":"","sources":["../../src/utils/time.utils.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAC9B,MAAM,gBAAgB,GAAG,EAAE,GAAG,gBAAgB,CAAC;AAC/C,MAAM,cAAc,GAAG,EAAE,GAAG,gBAAgB,CAAC;AAC7C,MAAM,aAAa,GAAG,EAAE,GAAG,cAAc,CAAC;AAE1C,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,SAAS,EAAE,gBAAgB;IAC3B,SAAS,EAAE,gBAAgB;IAC3B,OAAO,EAAE,cAAc;IACvB,MAAM,EAAE,aAAa;CACb,CAAC"}

package/dist/utils/types.utils.d.ts

@@ -0,0 +1,5 @@
+export declare const NO_OP: () => void;
+export declare const isNullish: (value: unknown) => value is null | undefined;
+export declare const isNumber: (value?: unknown | null) => value is number;
+export declare const isString: (value?: unknown | null) => value is string;
+//# sourceMappingURL=types.utils.d.ts.map

package/dist/utils/types.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.utils.d.ts","sourceRoot":"","sources":["../../src/utils/types.utils.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,KAAK,EAAE,MAAM,IAAe,CAAC;AAE1C,eAAO,MAAM,SAAS,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,IAAI,GAAG,SAAkD,CAAC;AAE9G,eAAO,MAAM,QAAQ,GAAI,QAAQ,OAAO,GAAG,IAAI,KAAG,KAAK,IAAI,MAc1D,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,QAAQ,OAAO,GAAG,IAAI,KAAG,KAAK,IAAI,MAU1D,CAAC"}

package/dist/utils/types.utils.js

@@ -0,0 +1,24 @@
+export const NO_OP = () => { };
+export const isNullish = (value) => value === null || value === undefined;
+export const isNumber = (value) => {
+    if (isNullish(value)) {
+        return false;
+    }
+    if (typeof value !== 'number') {
+        return false;
+    }
+    if (isNaN(value)) {
+        return false;
+    }
+    return true;
+};
+export const isString = (value) => {
+    if (isNullish(value)) {
+        return false;
+    }
+    if (typeof value !== 'string') {
+        return false;
+    }
+    return true;
+};
+//# sourceMappingURL=types.utils.js.map

package/dist/utils/types.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.utils.js","sourceRoot":"","sources":["../../src/utils/types.utils.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,KAAK,GAAe,GAAG,EAAE,GAAE,CAAC,CAAC;AAE1C,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAc,EAA6B,EAAE,CAAC,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC;AAE9G,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAsB,EAAmB,EAAE;IAClE,IAAI,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QACjB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAsB,EAAmB,EAAE;IAClE,IAAI,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC,CAAC"}

package/dist/utils/units.utils.d.ts

@@ -0,0 +1,16 @@
+/** m³/s to gallons per minute */
+export declare const M3PS_TO_GPM = 15850.3;
+/** Pascals to feet of head (1 Pa = 1 N/m²) */
+export declare const PA_TO_FT = 0.000334553;
+/** Watts to Horsepower */
+export declare const W_TO_HP = 0.00134102;
+/** meters to inches */
+export declare const M_TO_INCHES = 39.3701;
+/** Hz to RPM (for synchronous speed) */
+export declare const HZ_TO_RPM = 60;
+export declare const fromM3psToGPM: (value?: number | null) => number;
+export declare const fromPaToFt: (value?: number | null) => number;
+export declare const fromWToHp: (value?: number | null) => number;
+export declare const fromMToInches: (value?: number | null) => number;
+export declare const fromHzToRpm: (value?: number | null) => number;
+//# sourceMappingURL=units.utils.d.ts.map

package/dist/utils/units.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"units.utils.d.ts","sourceRoot":"","sources":["../../src/utils/units.utils.ts"],"names":[],"mappings":"AAEA,iCAAiC;AACjC,eAAO,MAAM,WAAW,UAAU,CAAC;AAEnC,8CAA8C;AAC9C,eAAO,MAAM,QAAQ,cAAc,CAAC;AAEpC,0BAA0B;AAC1B,eAAO,MAAM,OAAO,aAAa,CAAC;AAElC,uBAAuB;AACvB,eAAO,MAAM,WAAW,UAAU,CAAC;AAEnC,wCAAwC;AACxC,eAAO,MAAM,SAAS,KAAK,CAAC;AAE5B,eAAO,MAAM,aAAa,GAAI,QAAQ,MAAM,GAAG,IAAI,KAAG,MAIrD,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,QAAQ,MAAM,GAAG,IAAI,KAAG,MAIlD,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,QAAQ,MAAM,GAAG,IAAI,KAAG,MAIjD,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,QAAQ,MAAM,GAAG,IAAI,KAAG,MAIrD,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,QAAQ,MAAM,GAAG,IAAI,KAAG,MAInD,CAAC"}

package/dist/utils/units.utils.js

@@ -0,0 +1,37 @@
+import { isNullish } from "./types.utils";
+/** m³/s to gallons per minute */
+export const M3PS_TO_GPM = 15850.3;
+/** Pascals to feet of head (1 Pa = 1 N/m²) */
+export const PA_TO_FT = 0.000334553;
+/** Watts to Horsepower */
+export const W_TO_HP = 0.00134102;
+/** meters to inches */
+export const M_TO_INCHES = 39.3701;
+/** Hz to RPM (for synchronous speed) */
+export const HZ_TO_RPM = 60;
+export const fromM3psToGPM = (value) => {
+    if (isNullish(value))
+        return 0;
+    return value * M3PS_TO_GPM;
+};
+export const fromPaToFt = (value) => {
+    if (isNullish(value))
+        return 0;
+    return value * PA_TO_FT;
+};
+export const fromWToHp = (value) => {
+    if (isNullish(value))
+        return 0;
+    return value * W_TO_HP;
+};
+export const fromMToInches = (value) => {
+    if (isNullish(value))
+        return 0;
+    return value * M_TO_INCHES;
+};
+export const fromHzToRpm = (value) => {
+    if (isNullish(value))
+        return 0;
+    return value * HZ_TO_RPM;
+};
+//# sourceMappingURL=units.utils.js.map

package/dist/utils/units.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"units.utils.js","sourceRoot":"","sources":["../../src/utils/units.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,iCAAiC;AACjC,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC;AAEnC,8CAA8C;AAC9C,MAAM,CAAC,MAAM,QAAQ,GAAG,WAAW,CAAC;AAEpC,0BAA0B;AAC1B,MAAM,CAAC,MAAM,OAAO,GAAG,UAAU,CAAC;AAElC,uBAAuB;AACvB,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC;AAEnC,wCAAwC;AACxC,MAAM,CAAC,MAAM,SAAS,GAAG,EAAE,CAAC;AAE5B,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAqB,EAAU,EAAE;IAC7D,IAAI,SAAS,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAE/B,OAAO,KAAK,GAAG,WAAW,CAAC;AAC7B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAqB,EAAU,EAAE;IAC1D,IAAI,SAAS,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAE/B,OAAO,KAAK,GAAG,QAAQ,CAAC;AAC1B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAqB,EAAU,EAAE;IACzD,IAAI,SAAS,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAE/B,OAAO,KAAK,GAAG,OAAO,CAAC;AACzB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAqB,EAAU,EAAE;IAC7D,IAAI,SAAS,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAE/B,OAAO,KAAK,GAAG,WAAW,CAAC;AAC7B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAqB,EAAU,EAAE;IAC3D,IAAI,SAAS,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAE/B,OAAO,KAAK,GAAG,SAAS,CAAC;AAC3B,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@lichens-innovation/ts-common",
+  "version": "1.2.1",
+  "description": "Reusable generic typescript utilities, types, constants, helpers",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "repository": "git@github.com:Lichens-Innovation/ts-common.git",
+  "author": "Lichens Innovation",
+  "license": "MIT",
+  "type": "module",
+  "scripts": {
+    "clean:node": "npx rimraf node_modules yarn.lock",
+    "clean:dist": "npx rimraf dist",
+    "typecheck": "npx tsc --noEmit",
+    "build": "npm run clean:dist && tsc",
+    "test": "vitest run --coverage",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  },
+  "dependencies": {
+    "date-fns": "^3.0.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.1",
+    "@faker-js/faker": "^10.1.0",
+    "@types/node": "^24.10.0",
+    "@vitest/coverage-v8": "4.0.8",
+    "commitlint": "^20.1.0",
+    "cross-env": "^10.1.0",
+    "eslint": "^9.39.1",
+    "husky": "^9.1.7",
+    "prettier": "^3.6.2",
+    "rimraf": "^6.1.0",
+    "typescript": "~5.9.3",
+    "typescript-eslint": "^8.46.3",
+    "vite": "^7.2.2",
+    "vite-tsconfig-paths": "^5.1.4",
+    "vitest": "^4.0.8"
+  }
+}