@alarido/ts-utils 1.0.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Alarido <alarido.su@gmail.com>
+
+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 @@
+"# ts-utils" 

package/dist/functions/compares.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Struct to describe a divergent value between two structures.
+ */
+export interface DivergentValueInfo {
+    name: string;
+    value: any;
+    oldValue: any;
+}
+/**
+ * Complex/compound comparison tools.
+ */
+declare class CompareUtils {
+    constructor();
+    /**
+     * List values diverging between the (sa) and (sb) structures.
+     * If an empty list is returned, it means (sa) and (sb) are probably equal.
+     * To enable strict comparison, pass true to strictCompare parameter.
+     *
+     * @param sa: any
+     * @param sb: any
+     * @param strictCompare: boolean = false
+     * @returns DivergentValueInfo[]
+     */
+    getDivergentValues(sa: any, sb: any, strictCompare?: boolean): DivergentValueInfo[];
+    /**
+     * Compares dates.
+     *
+     * @param d1: Date
+     * @param d2: Date
+     * @returns boolean
+     */
+    areSameDate(d1: Date, d2: Date): boolean;
+    /**
+     * Checks if both structures have any divergent values in between.
+     *
+     * @param v1: any
+     * @param v2: any
+     * @returns boolean
+     */
+    areDivergent(v1: any, v2: any): boolean;
+}
+export declare const compares: CompareUtils;
+export {};
+//# sourceMappingURL=compares.d.ts.map

package/dist/functions/compares.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compares.d.ts","sourceRoot":"","sources":["../../src/functions/compares.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,GAAG,CAAC;IACX,QAAQ,EAAE,GAAG,CAAC;CACjB;AAED;;GAEG;AACH,cAAM,YAAY;;IAGd;;;;;;;;;OASG;IACH,kBAAkB,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,aAAa,GAAE,OAAe,GAAG,kBAAkB,EAAE;IAqC1F;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,GAAG,OAAO;IAQxC;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,GAAG,OAAO;CAK1C;AAED,eAAO,MAAM,QAAQ,cAAqB,CAAC"}

package/dist/functions/compares.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compares = void 0;
+const dates_1 = require("./dates");
+;
+/**
+ * Complex/compound comparison tools.
+ */
+class CompareUtils {
+    constructor() { }
+    /**
+     * List values diverging between the (sa) and (sb) structures.
+     * If an empty list is returned, it means (sa) and (sb) are probably equal.
+     * To enable strict comparison, pass true to strictCompare parameter.
+     *
+     * @param sa: any
+     * @param sb: any
+     * @param strictCompare: boolean = false
+     * @returns DivergentValueInfo[]
+     */
+    getDivergentValues(sa, sb, strictCompare = false) {
+        const keys_a = Object.keys(sa);
+        const keys_b = Object.keys(sb);
+        const is_object = (obj) => obj != null && typeof obj === 'object';
+        let result = [];
+        if (keys_a.length !== keys_b.length) {
+            return [{
+                    name: "*",
+                    value: (sa),
+                    oldValue: (sb)
+                }];
+        }
+        for (const key of keys_a) {
+            const val_a = sa[key];
+            const val_b = sb[key];
+            let inequal = false;
+            //
+            if (val_a instanceof Date && val_b instanceof Date) {
+                inequal = !this.areSameDate(val_a, val_b);
+            }
+            else if (val_a instanceof Date) {
+                const date_b = dates_1.dates.parse(val_b);
+                inequal = !this.areSameDate(val_a, date_b);
+            }
+            else if (val_b instanceof Date) {
+                const date_a = dates_1.dates.parse(val_a);
+                inequal = !this.areSameDate(date_a, val_b);
+            }
+            else if (is_object(val_a) && is_object(val_b)) {
+                inequal = this.areDivergent(val_a, val_b);
+            }
+            else {
+                inequal = !(strictCompare ? (val_a === val_b) : (val_a == val_b));
+            }
+        }
+        return result;
+    }
+    /**
+     * Compares dates.
+     *
+     * @param d1: Date
+     * @param d2: Date
+     * @returns boolean
+     */
+    areSameDate(d1, d2) {
+        if ((!(d1 instanceof Date)) || (!(d2 instanceof Date))) {
+            return false;
+        }
+        return (d1.valueOf() == d2.valueOf());
+    }
+    /**
+     * Checks if both structures have any divergent values in between.
+     *
+     * @param v1: any
+     * @param v2: any
+     * @returns boolean
+     */
+    areDivergent(v1, v2) {
+        const divergent = this.getDivergentValues(v1, v2);
+        return (divergent.length > 0);
+    }
+}
+exports.compares = new CompareUtils();
+//# sourceMappingURL=compares.js.map

package/dist/functions/compares.js.map

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

package/dist/functions/dates.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Date utils
+ */
+declare class DateUtils {
+    constructor();
+    /**
+     * Parse the date according the format.
+     *
+     * @param value: string
+     * @param format: string
+     * @returns Date
+     */
+    parse(value: string, format?: string): Date;
+}
+export declare const dates: DateUtils;
+export declare const now: Date;
+export {};
+//# sourceMappingURL=dates.d.ts.map

package/dist/functions/dates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dates.d.ts","sourceRoot":"","sources":["../../src/functions/dates.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,cAAM,SAAS;;IAGX;;;;;;OAMG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,MAAqB,GAAG,IAAI;CAuB5D;AAGD,eAAO,MAAM,KAAK,WAAkB,CAAC;AACrC,eAAO,MAAM,GAAG,MAAQ,CAAC"}

package/dist/functions/dates.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.now = exports.dates = void 0;
+/**
+ * The current date.
+ *
+ * @returns Date
+ */
+const NOW = () => new Date();
+/**
+ * Date utils
+ */
+class DateUtils {
+    constructor() { }
+    /**
+     * Parse the date according the format.
+     *
+     * @param value: string
+     * @param format: string
+     * @returns Date
+     */
+    parse(value, format = "yyyy-mm-dd") {
+        const normalized = value.replace(/[^a-zA-Z0-9]/g, "-");
+        const normalizedFormat = format.toLowerCase().replace(/[^a-zA-Z0-9]/g, "-");
+        const formatItems = normalizedFormat.split("-");
+        const dateItems = normalized.split("-");
+        const yearIndex = formatItems.indexOf("yyyy");
+        const monthIndex = formatItems.indexOf("mm");
+        const dayIndex = formatItems.indexOf("dd");
+        const hourIndex = formatItems.indexOf("hh");
+        const minutesIndex = formatItems.indexOf("ii");
+        const secondsIndex = formatItems.indexOf("ss");
+        const year = (yearIndex >= 0) ? dateItems[yearIndex] : 0;
+        const month = (monthIndex >= 0) ? dateItems[monthIndex] : 1;
+        const day = (dayIndex >= 0) ? dateItems[dayIndex] : 0;
+        const hour = (hourIndex >= 0) ? dateItems[hourIndex] : 0;
+        const minute = (minutesIndex >= 0) ? dateItems[minutesIndex] : 0;
+        const second = (secondsIndex >= 0) ? dateItems[secondsIndex] : 0;
+        return new Date(year, month - 1, day, hour, minute, second);
+    }
+}
+exports.dates = new DateUtils();
+exports.now = NOW();
+//# sourceMappingURL=dates.js.map

package/dist/functions/dates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dates.js","sourceRoot":"","sources":["../../src/functions/dates.ts"],"names":[],"mappings":";;;AACA;;;;GAIG;AACH,MAAM,GAAG,GAAG,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC;AAE7B;;GAEG;AACH,MAAM,SAAS;IACX,gBAAe,CAAC;IAEhB;;;;;;OAMG;IACH,KAAK,CAAC,KAAa,EAAE,SAAiB,YAAY;QAC9C,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;QACvD,MAAM,gBAAgB,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;QAC5E,MAAM,WAAW,GAAG,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAChD,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAExC,MAAM,SAAS,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC9C,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,SAAS,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,YAAY,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC/C,MAAM,YAAY,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAE/C,MAAM,IAAI,GAAQ,CAAC,SAAS,IAAE,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5D,MAAM,KAAK,GAAQ,CAAC,UAAU,IAAE,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/D,MAAM,GAAG,GAAQ,CAAC,QAAQ,IAAE,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAEzD,MAAM,IAAI,GAAQ,CAAC,SAAS,IAAE,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5D,MAAM,MAAM,GAAQ,CAAC,YAAY,IAAE,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACpE,MAAM,MAAM,GAAQ,CAAC,YAAY,IAAE,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAEpE,OAAO,IAAI,IAAI,CAAC,IAAI,EAAC,KAAK,GAAC,CAAC,EAAC,GAAG,EAAC,IAAI,EAAC,MAAM,EAAC,MAAM,CAAC,CAAC;IACzD,CAAC;CACJ;AAGY,QAAA,KAAK,GAAG,IAAI,SAAS,EAAE,CAAC;AACxB,QAAA,GAAG,GAAG,GAAG,EAAE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+import * as Compares from "./functions/compares";
+/**
+ * exports
+ */
+export declare const dates: {
+    parse(value: string, format?: string): Date;
+};
+export declare const compares: {
+    getDivergentValues(sa: any, sb: any, strictCompare?: boolean): Compares.DivergentValueInfo[];
+    areSameDate(d1: Date, d2: Date): boolean;
+    areDivergent(v1: any, v2: any): boolean;
+};
+//# 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":"AACA,OAAO,KAAK,QAAQ,MAAM,sBAAsB,CAAC;AAEjD;;GAEG;AAEH,eAAO,MAAM,KAAK;;CAAc,CAAC;AACjC,eAAO,MAAM,QAAQ;;;;CAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,44 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compares = exports.dates = void 0;
+const Dates = __importStar(require("./functions/dates"));
+const Compares = __importStar(require("./functions/compares"));
+/**
+ * exports
+ */
+exports.dates = Dates.dates;
+exports.compares = Compares.compares;
+//# 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,yDAA2C;AAC3C,+DAAiD;AAEjD;;GAEG;AAEU,QAAA,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;AACpB,QAAA,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC"}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@alarido/ts-utils",
+  "version": "1.0.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "\"# ts-utils\"",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "build": "tsc",
+    "prepublish": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/collei/ts-utils.git"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/collei/ts-utils/issues"
+  },
+  "homepage": "https://github.com/collei/ts-utils#readme",
+  "devDependencies": {
+    "@types/node": "^25.0.3",
+    "typescript": "^5.9.3"
+  }
+}

package/tsconfig.json

@@ -0,0 +1,44 @@
+{
+  // Visit https://aka.ms/tsconfig to read more about this file
+  "compilerOptions": {
+    // File Layout
+    "rootDir": "./src",
+    "outDir": "./dist",
+
+    // Environment Settings
+    // See also https://aka.ms/tsconfig/module
+    "module": "nodenext",
+    "target": "esnext",
+    //"types": [],
+    // For nodejs:
+    "lib": ["esnext"],
+    "types": ["node"],
+    // and npm install -D @types/node
+
+    // Other Outputs
+    "sourceMap": true,
+    "declaration": true,
+    "declarationMap": true,
+
+    // Stricter Typechecking Options
+    "noUncheckedIndexedAccess": true,
+    "exactOptionalPropertyTypes": true,
+
+    // Style Options
+    // "noImplicitReturns": true,
+    // "noImplicitOverride": true,
+    // "noUnusedLocals": true,
+    // "noUnusedParameters": true,
+    // "noFallthroughCasesInSwitch": true,
+    // "noPropertyAccessFromIndexSignature": true,
+
+    // Recommended Options
+    "strict": true,
+    "jsx": "react-jsx",
+    "verbatimModuleSyntax": false,
+    "isolatedModules": true,
+    "noUncheckedSideEffectImports": true,
+    "moduleDetection": "force",
+    "skipLibCheck": true,
+  }
+}