@wikicasa-dev/utilities 1.2.4 → 1.2.6

package/dist/index.js

@@ -1,57 +1,58 @@
 import { isArrNullOrEmpty as r } from "./utils/ArrayUtils.js";
 import { rgba as a } from "./utils/ColorUtils.js";
-import { decodeCookie as i, encodeCookie as l, getCookie as n, removeCookie as p } from "./utils/CookieUtils.js";
+import { decodeCookie as i, encodeCookie as l, getCookie as p, removeCookie as n } from "./utils/CookieUtils.js";
 import { formatCurrency as E, formatCurrencyShort as f } from "./utils/CurrencyUtils.js";
 import { formatDate as d, formatDateToddMMYYYY as u, getStartAndEndOfDayUTC as x, subtractDaysFromDate as g } from "./utils/DateUtils.js";
-import { getCurrentDeviceSize as O, isMobile as C, isSafari as S, isWindows as y, isiOSDevice as P } from "./utils/DeviceDetectionUtils.js";
+import { getCurrentDeviceSize as O, isMobile as C, isSafari as y, isWindows as P, isiOSDevice as S } from "./utils/DeviceDetectionUtils.js";
 import { emptyElem as L, getSingleElement as R, hideElem as T, showElem as D } from "./utils/DOMUtils.js";
-import { hash256 as G, hashEmail as N } from "./utils/EmailUtils.js";
-import { debounce as h, isPromise as M } from "./utils/FunctionUtils.js";
+import { hash256 as h, hashEmail as G } from "./utils/EmailUtils.js";
+import { debounce as X, isPromise as M } from "./utils/FunctionUtils.js";
 import { awaitableSetTimeout as I, createCustomEvent as w } from "./utils/GenericUtils.js";
 import { formatFloat as k, formatInteger as F, formatLocaleNumber as U, formatLocaleNumberAuto as Y, formatNumber as H, formatterNumberObj as W, parseLocaleNumber as z, parseLocaleNumberAuto as Q } from "./utils/NumberUtils.js";
-import { areObjectsEqual as B, deepCopy as K, getOrDefault as V, getOrNull as J, invertFlatObject as Z, invertKeyToValue as $, isEmptyObject as ee, shallowCopyObjectTo as oe } from "./utils/ObjectUtils.js";
-import { observeOnce as te } from "./utils/ObserverUtils.js";
-import { addPermissionStateListener as me, onNotificationsPermissionChange as ie } from "./utils/PermissionUtils.js";
-import { buildParams as ne, buildURL as pe } from "./utils/RESB_UrlBuilder.js";
-import { capitalizeFirstLetter as Ee, cleanASCII as fe, decodeTextWithEntities as ce, replaceAll as de, replaceAllTokens as ue, stringToHyphened as xe, strip as ge } from "./utils/StringUtils.js";
-import { appendQueryString as Oe } from "./utils/URLBuilderUtils.js";
-import { COMPETITOR_REGEX as Se, DATE_REGEX as ye, EMAIL_REGEX as Pe, EMAIL_REGEX_INTO_TEXT as Ae, EXCLUDED_REGEX as Le, GLOBAL_PHONE_REGEX as Re, PASSWORD_REGEX as Te, PHONE_REGEX as De, ROOMS_REGEX as _e, SQM_REGEX as Ge } from "./utils/RegexUtils.js";
-import { browserSupportGeolocation as Xe, getUserPosition as he } from "./utils/GeolocationUtils.js";
-import { formatAddress as ve, formattedAddress as Ie } from "./utils/AdressUtils.js";
-import { googlePlaceConverter as je } from "./utils/GAutocompleteUtils.js";
-import { downloadFile as Fe } from "./utils/DownloadUtils.js";
-import { calcPolygonCenter as Ye, encodePolygon as He, getMinMaxLatLng as We, getPolygonString as ze, parsePoints as Qe, removeDuplicatePoints as qe } from "./utils/MapUtils.js";
+import { applyMergePatch as B, areObjectsEqual as K, deepCopy as V, getOrDefault as J, getOrNull as Z, invertFlatObject as $, invertKeyToValue as ee, isEmptyObject as oe, shallowCopyObjectTo as re } from "./utils/ObjectUtils.js";
+import { observeOnce as ae } from "./utils/ObserverUtils.js";
+import { addPermissionStateListener as ie, onNotificationsPermissionChange as le } from "./utils/PermissionUtils.js";
+import { buildParams as ne, buildURL as se } from "./utils/RESB_UrlBuilder.js";
+import { capitalizeFirstLetter as fe, cleanASCII as ce, decodeTextWithEntities as de, replaceAll as ue, replaceAllTokens as xe, stringToHyphened as ge, strip as be } from "./utils/StringUtils.js";
+import { appendQueryString as Ce } from "./utils/URLBuilderUtils.js";
+import { COMPETITOR_REGEX as Pe, DATE_REGEX as Se, EMAIL_REGEX as Ae, EMAIL_REGEX_INTO_TEXT as Le, EXCLUDED_REGEX as Re, GLOBAL_PHONE_REGEX as Te, PASSWORD_REGEX as De, PHONE_REGEX as _e, ROOMS_REGEX as he, SQM_REGEX as Ge } from "./utils/RegexUtils.js";
+import { browserSupportGeolocation as Xe, getUserPosition as Me } from "./utils/GeolocationUtils.js";
+import { formatAddress as Ie, formattedAddress as we } from "./utils/AdressUtils.js";
+import { googlePlaceConverter as ke } from "./utils/GAutocompleteUtils.js";
+import { downloadFile as Ue } from "./utils/DownloadUtils.js";
+import { calcPolygonCenter as He, encodePolygon as We, getMinMaxLatLng as ze, getPolygonString as Qe, parsePoints as qe, removeDuplicatePoints as Be } from "./utils/MapUtils.js";
 export {
-  Se as COMPETITOR_REGEX,
-  ye as DATE_REGEX,
-  Pe as EMAIL_REGEX,
-  Ae as EMAIL_REGEX_INTO_TEXT,
-  Le as EXCLUDED_REGEX,
-  Re as GLOBAL_PHONE_REGEX,
-  Te as PASSWORD_REGEX,
-  De as PHONE_REGEX,
-  _e as ROOMS_REGEX,
+  Pe as COMPETITOR_REGEX,
+  Se as DATE_REGEX,
+  Ae as EMAIL_REGEX,
+  Le as EMAIL_REGEX_INTO_TEXT,
+  Re as EXCLUDED_REGEX,
+  Te as GLOBAL_PHONE_REGEX,
+  De as PASSWORD_REGEX,
+  _e as PHONE_REGEX,
+  he as ROOMS_REGEX,
   Ge as SQM_REGEX,
-  me as addPermissionStateListener,
-  Oe as appendQueryString,
-  B as areObjectsEqual,
+  ie as addPermissionStateListener,
+  Ce as appendQueryString,
+  B as applyMergePatch,
+  K as areObjectsEqual,
   I as awaitableSetTimeout,
   Xe as browserSupportGeolocation,
   ne as buildParams,
-  pe as buildURL,
-  Ye as calcPolygonCenter,
-  Ee as capitalizeFirstLetter,
-  fe as cleanASCII,
+  se as buildURL,
+  He as calcPolygonCenter,
+  fe as capitalizeFirstLetter,
+  ce as cleanASCII,
   w as createCustomEvent,
-  h as debounce,
+  X as debounce,
   i as decodeCookie,
-  ce as decodeTextWithEntities,
-  K as deepCopy,
-  Fe as downloadFile,
+  de as decodeTextWithEntities,
+  V as deepCopy,
+  Ue as downloadFile,
   L as emptyElem,
   l as encodeCookie,
-  He as encodePolygon,
-  ve as formatAddress,
+  We as encodePolygon,
+  Ie as formatAddress,
   E as formatCurrency,
   f as formatCurrencyShort,
   d as formatDate,
@@ -61,43 +62,43 @@ export {
   U as formatLocaleNumber,
   Y as formatLocaleNumberAuto,
   H as formatNumber,
-  Ie as formattedAddress,
+  we as formattedAddress,
   W as formatterNumberObj,
-  n as getCookie,
+  p as getCookie,
   O as getCurrentDeviceSize,
-  We as getMinMaxLatLng,
-  V as getOrDefault,
-  J as getOrNull,
-  ze as getPolygonString,
+  ze as getMinMaxLatLng,
+  J as getOrDefault,
+  Z as getOrNull,
+  Qe as getPolygonString,
   R as getSingleElement,
   x as getStartAndEndOfDayUTC,
-  he as getUserPosition,
-  je as googlePlaceConverter,
-  G as hash256,
-  N as hashEmail,
+  Me as getUserPosition,
+  ke as googlePlaceConverter,
+  h as hash256,
+  G as hashEmail,
   T as hideElem,
-  Z as invertFlatObject,
-  $ as invertKeyToValue,
+  $ as invertFlatObject,
+  ee as invertKeyToValue,
   r as isArrNullOrEmpty,
-  ee as isEmptyObject,
+  oe as isEmptyObject,
   C as isMobile,
   M as isPromise,
-  S as isSafari,
-  y as isWindows,
-  P as isiOSDevice,
-  te as observeOnce,
-  ie as onNotificationsPermissionChange,
+  y as isSafari,
+  P as isWindows,
+  S as isiOSDevice,
+  ae as observeOnce,
+  le as onNotificationsPermissionChange,
   z as parseLocaleNumber,
   Q as parseLocaleNumberAuto,
-  Qe as parsePoints,
-  p as removeCookie,
-  qe as removeDuplicatePoints,
-  de as replaceAll,
-  ue as replaceAllTokens,
+  qe as parsePoints,
+  n as removeCookie,
+  Be as removeDuplicatePoints,
+  ue as replaceAll,
+  xe as replaceAllTokens,
   a as rgba,
-  oe as shallowCopyObjectTo,
+  re as shallowCopyObjectTo,
   D as showElem,
-  xe as stringToHyphened,
-  ge as strip,
+  ge as stringToHyphened,
+  be as strip,
   g as subtractDaysFromDate
 };

package/dist/utils/ObjectUtils.d.ts

@@ -1,5 +1,22 @@
 import { Nullable, Optional } from '@wikicasa-dev/types';
 import { FlatInvert, InvertKeyToValue } from '../types/ObjectUtilsTypes';
+export type JsonValue = string | number | boolean | null | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export type JsonObject = {
+    [key: string]: JsonValue;
+};
+/**
+ * Recursive JSON Merge Patch type (RFC 7396).
+ *
+ * Key idea:
+ * - `null` = delete field
+ * - object = recurse
+ * - other values = replace
+ */
+export type JsonMergePatch<T> = T extends JsonValue[] ? JsonValue[] : T extends object ? {
+    [K in keyof T]?: JsonMergePatch<T[K]> | null;
+} : T;
 export declare function shallowCopyObjectTo(from: Record<string, any> | undefined, to: Record<string, any>): void;
 /**
  * Checks if the given object is empty.
@@ -58,3 +75,43 @@ export declare const getOrDefault: <T>(value: T, defaultValue: NonNullable<T>) =
  * @returns  Returns true if the objects are deeply equal, false otherwise.
  */
 export declare const areObjectsEqual: (obj1?: object, obj2?: object) => boolean;
+/**
+ * Applies a JSON Merge Patch (RFC 7396) to a source JSON object.
+ *
+ * This function performs a deep, recursive merge between `source` and `patch`
+ * following the JSON Merge Patch specification:
+ *
+ * - Objects are merged recursively.
+ * - Arrays are replaced (not merged).
+ * - Primitive values are replaced.
+ * - `null` values in the patch explicitly remove the property.
+ *
+ * ### Example
+ * ```ts
+ * const source = {
+ *   a: 1,
+ *   b: { c: 2, d: 3 },
+ * };
+ *
+ * const patch = {
+ *   a: null,
+ *   b: { d: 4 },
+ * };
+ *
+ * const result = applyMergePatch(source, patch);
+ * // {
+ * //   b: { c: 2, d: 4 }
+ * // }
+ * ```
+ *
+ * ### Notes
+ * - Only JSON-compatible values are supported.
+ * - The function does not mutate the input objects.
+ * - Non-object values (including arrays) are replaced entirely.
+ *
+ * @template T - Source object type
+ * @param source - The original JSON object to apply the patch to.
+ * @param patch - The JSON Merge Patch object describing changes.
+ * @returns A new object resulting from applying the patch.
+ */
+export declare function applyMergePatch<T extends JsonObject>(source: T, patch: JsonMergePatch<T>): T;

package/dist/utils/ObjectUtils.js

@@ -1,10 +1,10 @@
-function l(e, t) {
+function f(e, t) {
   if (e)
     for (const r in e)
       t[r] = e[r];
 }
-const u = (e) => !e || !Object.keys(e).length;
-function f(e) {
+const y = (e) => !e || !Object.keys(e).length;
+function a(e) {
   if (!e) return null;
   for (const t in e) {
     const r = e[t];
@@ -13,35 +13,50 @@ function f(e) {
   }
   return { ...e };
 }
-const y = (e) => Object.entries(e).reduce(
-  (t, [r, s]) => (t[s] = r, t),
+const O = (e) => Object.entries(e).reduce(
+  (t, [r, n]) => (t[n] = r, t),
   {}
-), a = (e) => Object.keys(e).reduce(
+), g = (e) => Object.keys(e).reduce(
   (t, r) => (t[r] = r, t),
   {}
-), O = (e) => e ?? null, g = (e, t) => e ?? t, i = (e = {}, t = {}) => {
+), p = (e) => e ?? null, d = (e, t) => e ?? t, c = (e = {}, t = {}) => {
   if (e === null || t === null || e === void 0 || t === void 0 || typeof e != "object" && typeof t != "object")
     return e === t;
   if (e instanceof Date && t instanceof Date)
     return e.getTime() === t.getTime();
   if (Array.isArray(e) && Array.isArray(t))
-    return e.length !== t.length ? !1 : e.every((n, c) => i(n, t[c]));
+    return e.length !== t.length ? !1 : e.every((s, i) => c(s, t[i]));
   if (typeof e != typeof t) return !1;
-  const r = Object.keys(e), s = Object.keys(t);
-  return r.length !== s.length ? !1 : r.every(
-    (n) => Object.prototype.hasOwnProperty.call(t, n) && i(
-      e[n],
-      t[n]
+  const r = Object.keys(e), n = Object.keys(t);
+  return r.length !== n.length ? !1 : r.every(
+    (s) => Object.prototype.hasOwnProperty.call(t, s) && c(
+      e[s],
+      t[s]
     )
   );
+}, l = (e) => e !== null && typeof e == "object" && !Array.isArray(e), u = (e, t) => {
+  if (t === null)
+    return;
+  if (!l(e) || !l(t))
+    return t;
+  const r = { ...e };
+  for (const n of Object.keys(t)) {
+    const s = t[n], i = u(e[n], s);
+    i === void 0 ? delete r[n] : r[n] = i;
+  }
+  return r;
 };
+function k(e, t) {
+  return u(e, t);
+}
 export {
-  i as areObjectsEqual,
-  f as deepCopy,
-  g as getOrDefault,
-  O as getOrNull,
-  y as invertFlatObject,
-  a as invertKeyToValue,
-  u as isEmptyObject,
-  l as shallowCopyObjectTo
+  k as applyMergePatch,
+  c as areObjectsEqual,
+  a as deepCopy,
+  d as getOrDefault,
+  p as getOrNull,
+  O as invertFlatObject,
+  g as invertKeyToValue,
+  y as isEmptyObject,
+  f as shallowCopyObjectTo
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wikicasa-dev/utilities",
-  "version": "1.2.4",
+  "version": "1.2.6",
   "description": "Wikicasa frontend utilities",
   "type": "module",
   "main": "dist/index.js",
@@ -35,7 +35,7 @@
     "@types/js-cookie": "^3.0.6",
     "@types/leaflet": "^1.9.21",
     "@types/node": "^25.9.1",
-    "@wikicasa-dev/types": "2.5.8-alpha.1",
+    "@wikicasa-dev/types": "^2.5.8",
     "glob": "^13.0.6",
     "jest-environment-jsdom": "^30.4.1",
     "ts-jest": "^29.4.11",
@@ -44,7 +44,7 @@
     "vite": "^7.2.6"
   },
   "peerDependencies": {
-    "@wikicasa-dev/types": "2.5.8-alpha.1",
+    "@wikicasa-dev/types": "2.5.8",
     "date-fns": "^4.0.0",
     "google-polyline": "^1.0.0",
     "js-cookie": "^3.0.0"