@tmlmobilidade/utils 20250929.1324.18 → 20251001.1147.43

package/dist/src/objects/index.d.ts

@@ -1,3 +1,4 @@
 export * from './compare-objects.js';
 export * from './convert-object.js';
 export * from './flatten-object.js';
+export * from './merge-objects.js';

package/dist/src/objects/index.js

@@ -1,3 +1,4 @@
 export * from './compare-objects.js';
 export * from './convert-object.js';
 export * from './flatten-object.js';
+export * from './merge-objects.js';

package/dist/src/objects/merge-objects.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Merges two objects or arrays.
+ * @param target - The target object or array.
+ * @param source - The source object or array.
+ * @returns The merged object or array.
+ *
+ * @example
+ * const target = { a: 1, b: 2 };
+ * const source = { b: 3, c: 4 };
+ * const merged = mergeObjects(target, source);
+ * // merged will be:
+ * // { a: 1, b: 3, c: 4 }
+ *
+ * @example
+ * const target = [1, 2, 3];
+ * const source = [4, 5, 6];
+ * const merged = mergeObjects(target, source);
+ * // merged will be:
+ * // [1, 2, 3, 4, 5, 6]
+ */
+export declare function mergeObjects<T>(target: T, source: T): T;

package/dist/src/objects/merge-objects.js

@@ -0,0 +1,81 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+/**
+ * Merges two objects or arrays.
+ * @param target - The target object or array.
+ * @param source - The source object or array.
+ * @returns The merged object or array.
+ *
+ * @example
+ * const target = { a: 1, b: 2 };
+ * const source = { b: 3, c: 4 };
+ * const merged = mergeObjects(target, source);
+ * // merged will be:
+ * // { a: 1, b: 3, c: 4 }
+ *
+ * @example
+ * const target = [1, 2, 3];
+ * const source = [4, 5, 6];
+ * const merged = mergeObjects(target, source);
+ * // merged will be:
+ * // [1, 2, 3, 4, 5, 6]
+ */
+export function mergeObjects(target, source) {
+    if (Array.isArray(target) && Array.isArray(source)) {
+        // If arrays of primitives → unique values
+        if (target.every(x => !isObject(x)) && source.every(x => !isObject(x))) {
+            return Array.from(new Set([...source, ...target]));
+        }
+        // If arrays of objects → deduplicate by deep equality
+        const merged = [];
+        const all = [...target, ...source];
+        for (const obj of all) {
+            if (!merged.some(existing => deepEqual(existing, obj))) {
+                merged.push(mergeObjectsObject(existingDefaults(obj), obj));
+            }
+        }
+        return merged;
+    }
+    if (isObject(target) && isObject(source)) {
+        return mergeObjectsObject(target, source);
+    }
+    // default: override
+    return source;
+}
+function mergeObjectsObject(target, source) {
+    const result = { ...target };
+    for (const key of Object.keys(source)) {
+        if (key in target) {
+            result[key] = mergeObjects(target[key], source[key]);
+        }
+        else {
+            result[key] = source[key];
+        }
+    }
+    return result;
+}
+function isObject(item) {
+    return item !== null && typeof item === 'object' && !Array.isArray(item);
+}
+function deepEqual(a, b) {
+    if (a === b)
+        return true;
+    if (typeof a !== typeof b)
+        return false;
+    if (Array.isArray(a) && Array.isArray(b)) {
+        if (a.length !== b.length)
+            return false;
+        return a.every((val, i) => deepEqual(val, b[i]));
+    }
+    if (isObject(a) && isObject(b)) {
+        const keysA = Object.keys(a);
+        const keysB = Object.keys(b);
+        if (keysA.length !== keysB.length)
+            return false;
+        return keysA.every(k => deepEqual(a[k], b[k]));
+    }
+    return false;
+}
+// Helper: ensures merging empty object structure if needed
+function existingDefaults(obj) {
+    return isObject(obj) ? {} : obj;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@tmlmobilidade/utils",
-	"version": "20250929.1324.18",
+	"version": "20251001.1147.43",
 	"author": "João de Vasconcelos & Jusi Monteiro",
 	"license": "AGPL-3.0-or-later",
 	"homepage": "https://github.com/tmlmobilidade/services#readme",