@wikicasa-dev/utilities 1.0.14 → 1.0.15

package/dist/ObjectUtils.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function i(e,n){if(e)for(const t in e)n[t]=e[t]}function c(e){return!e||!Object.keys(e).length}function s(e){if(!e)return null;for(const n in e){const t=e[n];if(t&&(Array.isArray(t)||Object.keys(t).length>0))return JSON.parse(JSON.stringify(e))}return{...e}}const u=e=>Object.entries(e).reduce((n,[t,r])=>(n[r]=t,n),{});exports.deepCopy=s;exports.invertFlatObject=u;exports.isEmptyObject=c;exports.shallowCopyObjectTo=i;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function i(t,n){if(t)for(const e in t)n[e]=t[e]}const c=t=>!t||!Object.keys(t).length;function l(t){if(!t)return null;for(const n in t){const e=t[n];if(e&&(Array.isArray(e)||Object.keys(e).length>0))return JSON.parse(JSON.stringify(t))}return{...t}}const s=t=>Object.entries(t).reduce((n,[e,r])=>(n[r]=e,n),{}),u=t=>t??null;exports.deepCopy=l;exports.getOrNull=u;exports.invertFlatObject=s;exports.isEmptyObject=c;exports.shallowCopyObjectTo=i;

package/dist/ObjectUtils.js

@@ -3,9 +3,7 @@ function i(t, n) {
     for (const e in t)
       n[e] = t[e];
 }
-function c(t) {
-  return !t || !Object.keys(t).length;
-}
+const c = (t) => !t || !Object.keys(t).length;
 function s(t) {
   if (!t)
     return null;
@@ -19,9 +17,10 @@ function s(t) {
 const u = (t) => Object.entries(t).reduce(
   (n, [e, r]) => (n[r] = e, n),
   {}
-);
+), l = (t) => t ?? null;
 export {
   s as deepCopy,
+  l as getOrNull,
   u as invertFlatObject,
   c as isEmptyObject,
   i as shallowCopyObjectTo

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const b=require("./ArrayUtils.cjs"),O=require("./ColorUtils.cjs"),i=require("./CookieUtils.cjs"),p=require("./CurrencyUtils.cjs"),C=require("./DateUtils.cjs"),o=require("./DeviceDetectionUtils.cjs"),s=require("./DOMUtils.cjs"),n=require("./EmailUtils.cjs"),E=require("./FunctionUtils.cjs"),c=require("./GenericUtils.cjs"),r=require("./NumberUtils.cjs"),l=require("./ObjectUtils.cjs"),R=require("./ObserverUtils.cjs"),m=require("./PermissionUtils.cjs"),a=require("./RESB_UrlBuilder.cjs"),t=require("./StringUtils.cjs"),g=require("./URLBuilderUtils.cjs"),e=require("./RegexUtils.cjs"),u=require("./GeolocationUtils.cjs"),d=require("./AdressUtils.cjs"),S=require("./GAutocompleteUtils.cjs"),U=require("./DownloadUtils.cjs");exports.isArrNullOrEmpty=b.isArrNullOrEmpty;exports.rgba=O.rgba;exports.decodeCookie=i.decodeCookie;exports.encodeCookie=i.encodeCookie;exports.getCookie=i.getCookie;exports.removeCookie=i.removeCookie;exports.formatCurrency=p.formatCurrency;exports.formatDate=C.formatDate;exports.getCurrentDeviceSize=o.getCurrentDeviceSize;exports.isMobile=o.isMobile;exports.isSafari=o.isSafari;exports.isiOSDevice=o.isiOSDevice;exports.emptyElem=s.emptyElem;exports.getSingleElement=s.getSingleElement;exports.hideElem=s.hideElem;exports.showElem=s.showElem;exports.hash256=n.hash256;exports.hashEmail=n.hashEmail;exports.debounce=E.debounce;exports.isPromise=E.isPromise;exports.awaitableSetTimeout=c.awaitableSetTimeout;exports.createCustomEvent=c.createCustomEvent;exports.formatFloat=r.formatFloat;exports.formatInteger=r.formatInteger;exports.formatLocaleNumber=r.formatLocaleNumber;exports.formatNumber=r.formatNumber;exports.formatterNumberObj=r.formatterNumberObj;exports.parseLocaleNumber=r.parseLocaleNumber;exports.deepCopy=l.deepCopy;exports.invertFlatObject=l.invertFlatObject;exports.isEmptyObject=l.isEmptyObject;exports.shallowCopyObjectTo=l.shallowCopyObjectTo;exports.observeOnce=R.observeOnce;exports.addPermissionStateListener=m.addPermissionStateListener;exports.onNotificationsPermissionChange=m.onNotificationsPermissionChange;exports.buildParams=a.buildParams;exports.buildParamsForAgency=a.buildParamsForAgency;exports.buildURL=a.buildURL;exports.capitalizeFirstLetter=t.capitalizeFirstLetter;exports.cleanASCII=t.cleanASCII;exports.decodeTextWithEntities=t.decodeTextWithEntities;exports.replaceAll=t.replaceAll;exports.replaceAllTokens=t.replaceAllTokens;exports.stringToHyphened=t.stringToHyphened;exports.appendQueryString=g.appendQueryString;exports.COMPETITOR_REGEX=e.COMPETITOR_REGEX;exports.DATE_REGEX=e.DATE_REGEX;exports.EMAIL_REGEX=e.EMAIL_REGEX;exports.EMAIL_REGEX_INTO_TEXT=e.EMAIL_REGEX_INTO_TEXT;exports.EXCLUDED_REGEX=e.EXCLUDED_REGEX;exports.GLOBAL_PHONE_REGEX=e.GLOBAL_PHONE_REGEX;exports.PASSWORD_REGEX=e.PASSWORD_REGEX;exports.PHONE_REGEX=e.PHONE_REGEX;exports.ROOMS_REGEX=e.ROOMS_REGEX;exports.SQM_REGEX=e.SQM_REGEX;exports.browserSupportGeolocation=u.browserSupportGeolocation;exports.getUserPosition=u.getUserPosition;exports.formatAddress=d.formatAddress;exports.formattedAddress=d.formattedAddress;exports.googlePlaceConverter=S.googlePlaceConverter;exports.downloadFile=U.downloadFile;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const b=require("./ArrayUtils.cjs"),O=require("./ColorUtils.cjs"),o=require("./CookieUtils.cjs"),g=require("./CurrencyUtils.cjs"),p=require("./DateUtils.cjs"),s=require("./DeviceDetectionUtils.cjs"),l=require("./DOMUtils.cjs"),n=require("./EmailUtils.cjs"),E=require("./FunctionUtils.cjs"),c=require("./GenericUtils.cjs"),r=require("./NumberUtils.cjs"),i=require("./ObjectUtils.cjs"),C=require("./ObserverUtils.cjs"),m=require("./PermissionUtils.cjs"),a=require("./RESB_UrlBuilder.cjs"),t=require("./StringUtils.cjs"),R=require("./URLBuilderUtils.cjs"),e=require("./RegexUtils.cjs"),u=require("./GeolocationUtils.cjs"),d=require("./AdressUtils.cjs"),S=require("./GAutocompleteUtils.cjs"),U=require("./DownloadUtils.cjs");exports.isArrNullOrEmpty=b.isArrNullOrEmpty;exports.rgba=O.rgba;exports.decodeCookie=o.decodeCookie;exports.encodeCookie=o.encodeCookie;exports.getCookie=o.getCookie;exports.removeCookie=o.removeCookie;exports.formatCurrency=g.formatCurrency;exports.formatDate=p.formatDate;exports.getCurrentDeviceSize=s.getCurrentDeviceSize;exports.isMobile=s.isMobile;exports.isSafari=s.isSafari;exports.isiOSDevice=s.isiOSDevice;exports.emptyElem=l.emptyElem;exports.getSingleElement=l.getSingleElement;exports.hideElem=l.hideElem;exports.showElem=l.showElem;exports.hash256=n.hash256;exports.hashEmail=n.hashEmail;exports.debounce=E.debounce;exports.isPromise=E.isPromise;exports.awaitableSetTimeout=c.awaitableSetTimeout;exports.createCustomEvent=c.createCustomEvent;exports.formatFloat=r.formatFloat;exports.formatInteger=r.formatInteger;exports.formatLocaleNumber=r.formatLocaleNumber;exports.formatNumber=r.formatNumber;exports.formatterNumberObj=r.formatterNumberObj;exports.parseLocaleNumber=r.parseLocaleNumber;exports.deepCopy=i.deepCopy;exports.getOrNull=i.getOrNull;exports.invertFlatObject=i.invertFlatObject;exports.isEmptyObject=i.isEmptyObject;exports.shallowCopyObjectTo=i.shallowCopyObjectTo;exports.observeOnce=C.observeOnce;exports.addPermissionStateListener=m.addPermissionStateListener;exports.onNotificationsPermissionChange=m.onNotificationsPermissionChange;exports.buildParams=a.buildParams;exports.buildParamsForAgency=a.buildParamsForAgency;exports.buildURL=a.buildURL;exports.capitalizeFirstLetter=t.capitalizeFirstLetter;exports.cleanASCII=t.cleanASCII;exports.decodeTextWithEntities=t.decodeTextWithEntities;exports.replaceAll=t.replaceAll;exports.replaceAllTokens=t.replaceAllTokens;exports.stringToHyphened=t.stringToHyphened;exports.appendQueryString=R.appendQueryString;exports.COMPETITOR_REGEX=e.COMPETITOR_REGEX;exports.DATE_REGEX=e.DATE_REGEX;exports.EMAIL_REGEX=e.EMAIL_REGEX;exports.EMAIL_REGEX_INTO_TEXT=e.EMAIL_REGEX_INTO_TEXT;exports.EXCLUDED_REGEX=e.EXCLUDED_REGEX;exports.GLOBAL_PHONE_REGEX=e.GLOBAL_PHONE_REGEX;exports.PASSWORD_REGEX=e.PASSWORD_REGEX;exports.PHONE_REGEX=e.PHONE_REGEX;exports.ROOMS_REGEX=e.ROOMS_REGEX;exports.SQM_REGEX=e.SQM_REGEX;exports.browserSupportGeolocation=u.browserSupportGeolocation;exports.getUserPosition=u.getUserPosition;exports.formatAddress=d.formatAddress;exports.formattedAddress=d.formattedAddress;exports.googlePlaceConverter=S.googlePlaceConverter;exports.downloadFile=U.downloadFile;

package/dist/index.js

@@ -1,85 +1,86 @@
 import { isArrNullOrEmpty as r } from "./ArrayUtils.js";
 import { rgba as m } from "./ColorUtils.js";
-import { decodeCookie as a, encodeCookie as E, getCookie as p, removeCookie as f } from "./CookieUtils.js";
-import { formatCurrency as l } from "./CurrencyUtils.js";
+import { decodeCookie as a, encodeCookie as E, getCookie as p, removeCookie as l } from "./CookieUtils.js";
+import { formatCurrency as s } from "./CurrencyUtils.js";
 import { formatDate as x } from "./DateUtils.js";
 import { getCurrentDeviceSize as d, isMobile as b, isSafari as O, isiOSDevice as u } from "./DeviceDetectionUtils.js";
-import { emptyElem as R, getSingleElement as g, hideElem as S, showElem as _ } from "./DOMUtils.js";
+import { emptyElem as C, getSingleElement as R, hideElem as S, showElem as _ } from "./DOMUtils.js";
 import { hash256 as G, hashEmail as X } from "./EmailUtils.js";
 import { debounce as T, isPromise as h } from "./FunctionUtils.js";
-import { awaitableSetTimeout as y, createCustomEvent as N } from "./GenericUtils.js";
+import { awaitableSetTimeout as N, createCustomEvent as y } from "./GenericUtils.js";
 import { formatFloat as D, formatInteger as I, formatLocaleNumber as M, formatNumber as k, formatterNumberObj as w, parseLocaleNumber as F } from "./NumberUtils.js";
-import { deepCopy as H, invertFlatObject as U, isEmptyObject as z, shallowCopyObjectTo as Q } from "./ObjectUtils.js";
-import { observeOnce as B } from "./ObserverUtils.js";
-import { addPermissionStateListener as J, onNotificationsPermissionChange as K } from "./PermissionUtils.js";
-import { buildParams as Y, buildParamsForAgency as Z, buildURL as $ } from "./RESB_UrlBuilder.js";
-import { capitalizeFirstLetter as oe, cleanASCII as re, decodeTextWithEntities as te, replaceAll as me, replaceAllTokens as ie, stringToHyphened as ae } from "./StringUtils.js";
-import { appendQueryString as pe } from "./URLBuilderUtils.js";
-import { COMPETITOR_REGEX as se, DATE_REGEX as le, EMAIL_REGEX as ne, EMAIL_REGEX_INTO_TEXT as xe, EXCLUDED_REGEX as ce, GLOBAL_PHONE_REGEX as de, PASSWORD_REGEX as be, PHONE_REGEX as Oe, ROOMS_REGEX as ue, SQM_REGEX as Ce } from "./RegexUtils.js";
-import { browserSupportGeolocation as ge, getUserPosition as Se } from "./GeolocationUtils.js";
-import { formatAddress as Ae, formattedAddress as Ge } from "./AdressUtils.js";
-import { googlePlaceConverter as Pe } from "./GAutocompleteUtils.js";
-import { downloadFile as he } from "./DownloadUtils.js";
+import { deepCopy as H, getOrNull as U, invertFlatObject as z, isEmptyObject as Q, shallowCopyObjectTo as W } from "./ObjectUtils.js";
+import { observeOnce as q } from "./ObserverUtils.js";
+import { addPermissionStateListener as K, onNotificationsPermissionChange as V } from "./PermissionUtils.js";
+import { buildParams as Z, buildParamsForAgency as $, buildURL as ee } from "./RESB_UrlBuilder.js";
+import { capitalizeFirstLetter as re, cleanASCII as te, decodeTextWithEntities as me, replaceAll as ie, replaceAllTokens as ae, stringToHyphened as Ee } from "./StringUtils.js";
+import { appendQueryString as le } from "./URLBuilderUtils.js";
+import { COMPETITOR_REGEX as se, DATE_REGEX as ne, EMAIL_REGEX as xe, EMAIL_REGEX_INTO_TEXT as ce, EXCLUDED_REGEX as de, GLOBAL_PHONE_REGEX as be, PASSWORD_REGEX as Oe, PHONE_REGEX as ue, ROOMS_REGEX as ge, SQM_REGEX as Ce } from "./RegexUtils.js";
+import { browserSupportGeolocation as Se, getUserPosition as _e } from "./GeolocationUtils.js";
+import { formatAddress as Ge, formattedAddress as Xe } from "./AdressUtils.js";
+import { googlePlaceConverter as Te } from "./GAutocompleteUtils.js";
+import { downloadFile as Le } from "./DownloadUtils.js";
 export {
   se as COMPETITOR_REGEX,
-  le as DATE_REGEX,
-  ne as EMAIL_REGEX,
-  xe as EMAIL_REGEX_INTO_TEXT,
-  ce as EXCLUDED_REGEX,
-  de as GLOBAL_PHONE_REGEX,
-  be as PASSWORD_REGEX,
-  Oe as PHONE_REGEX,
-  ue as ROOMS_REGEX,
+  ne as DATE_REGEX,
+  xe as EMAIL_REGEX,
+  ce as EMAIL_REGEX_INTO_TEXT,
+  de as EXCLUDED_REGEX,
+  be as GLOBAL_PHONE_REGEX,
+  Oe as PASSWORD_REGEX,
+  ue as PHONE_REGEX,
+  ge as ROOMS_REGEX,
   Ce as SQM_REGEX,
-  J as addPermissionStateListener,
-  pe as appendQueryString,
-  y as awaitableSetTimeout,
-  ge as browserSupportGeolocation,
-  Y as buildParams,
-  Z as buildParamsForAgency,
-  $ as buildURL,
-  oe as capitalizeFirstLetter,
-  re as cleanASCII,
-  N as createCustomEvent,
+  K as addPermissionStateListener,
+  le as appendQueryString,
+  N as awaitableSetTimeout,
+  Se as browserSupportGeolocation,
+  Z as buildParams,
+  $ as buildParamsForAgency,
+  ee as buildURL,
+  re as capitalizeFirstLetter,
+  te as cleanASCII,
+  y as createCustomEvent,
   T as debounce,
   a as decodeCookie,
-  te as decodeTextWithEntities,
+  me as decodeTextWithEntities,
   H as deepCopy,
-  he as downloadFile,
-  R as emptyElem,
+  Le as downloadFile,
+  C as emptyElem,
   E as encodeCookie,
-  Ae as formatAddress,
-  l as formatCurrency,
+  Ge as formatAddress,
+  s as formatCurrency,
   x as formatDate,
   D as formatFloat,
   I as formatInteger,
   M as formatLocaleNumber,
   k as formatNumber,
-  Ge as formattedAddress,
+  Xe as formattedAddress,
   w as formatterNumberObj,
   p as getCookie,
   d as getCurrentDeviceSize,
-  g as getSingleElement,
-  Se as getUserPosition,
-  Pe as googlePlaceConverter,
+  U as getOrNull,
+  R as getSingleElement,
+  _e as getUserPosition,
+  Te as googlePlaceConverter,
   G as hash256,
   X as hashEmail,
   S as hideElem,
-  U as invertFlatObject,
+  z as invertFlatObject,
   r as isArrNullOrEmpty,
-  z as isEmptyObject,
+  Q as isEmptyObject,
   b as isMobile,
   h as isPromise,
   O as isSafari,
   u as isiOSDevice,
-  B as observeOnce,
-  K as onNotificationsPermissionChange,
+  q as observeOnce,
+  V as onNotificationsPermissionChange,
   F as parseLocaleNumber,
-  f as removeCookie,
-  me as replaceAll,
-  ie as replaceAllTokens,
+  l as removeCookie,
+  ie as replaceAll,
+  ae as replaceAllTokens,
   m as rgba,
-  Q as shallowCopyObjectTo,
+  W as shallowCopyObjectTo,
   _ as showElem,
-  ae as stringToHyphened
+  Ee as stringToHyphened
 };

package/dist/utils/ObjectUtils.d.ts

@@ -1,11 +1,34 @@
+import { Nullable, Optional } from '@wikicasa-dev/types';
 import { FlatInvert } from '../types/ObjectUtilsTypes';
 
 export declare function shallowCopyObjectTo(from: Record<string, any> | undefined, to: Record<string, any>): void;
-export declare function isEmptyObject(obj: any): boolean;
+/**
+ * Checks if the given object is empty.
+ *
+ * @param {Optional<Nullable<T>>} obj - The object to check.
+ * @return {boolean} Returns true if the object is empty, false otherwise.
+ */
+export declare const isEmptyObject: <T>(obj: Optional<Nullable<T>>) => boolean;
 /**
  * Makes the deep copy of the input object.
  * For performance purposes, if the values of the properties of the object to copy are all primitive types then we will use the spread operator (faster).
  * Otherwise, to ensure the deep copy of nested objects and arrays, we will use JSON.parse and JSON.stringify (slower).
  * */
 export declare function deepCopy<T>(objToCopy: T): T | null;
+/**
+ * Inverts a flat object by swapping its keys and values.
+ *
+ * @template T - The type of the input object.
+ * @template TKey - The type of the keys in the input object.
+ * @template TValue - The type of the values in the input object.
+ * @param {T} obj - The object to be inverted.
+ * @return {FlatInvert<T>} - The inverted object.
+ */
 export declare const invertFlatObject: <T extends Record<TKey, TValue>, TKey extends PropertyKey = PropertyKey, TValue extends string | number = string | number>(obj: T) => FlatInvert<T>;
+/**
+ * Returns the value if it is not null or undefined, otherwise returns null.
+ * @typeParam T - The type of the value.
+ * @param v - The value to check.
+ * @returns The value if it is not null or undefined, otherwise returns null.
+ */
+export declare const getOrNull: <T>(v: T) => NonNullable<T> | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wikicasa-dev/utilities",
-  "version": "1.0.14",
+  "version": "1.0.15",
   "description": "Wikicasa frontend utilities",
   "type": "module",
   "main": "dist/index.js",