@wikicasa-dev/utilities 1.0.14 → 1.0.17

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 O=require("./ArrayUtils.cjs"),g=require("./ColorUtils.cjs"),i=require("./CookieUtils.cjs"),p=require("./CurrencyUtils.cjs"),l=require("./DateUtils.cjs"),s=require("./DeviceDetectionUtils.cjs"),a=require("./DOMUtils.cjs"),c=require("./EmailUtils.cjs"),E=require("./FunctionUtils.cjs"),m=require("./GenericUtils.cjs"),t=require("./NumberUtils.cjs"),o=require("./ObjectUtils.cjs"),C=require("./ObserverUtils.cjs"),u=require("./PermissionUtils.cjs"),n=require("./RESB_UrlBuilder.cjs"),r=require("./StringUtils.cjs"),R=require("./URLBuilderUtils.cjs"),e=require("./RegexUtils.cjs"),d=require("./GeolocationUtils.cjs"),b=require("./AdressUtils.cjs"),S=require("./GAutocompleteUtils.cjs"),U=require("./DownloadUtils.cjs");exports.isArrNullOrEmpty=O.isArrNullOrEmpty;exports.rgba=g.rgba;exports.decodeCookie=i.decodeCookie;exports.encodeCookie=i.encodeCookie;exports.getCookie=i.getCookie;exports.removeCookie=i.removeCookie;exports.formatCurrency=p.formatCurrency;exports.formatDate=l.formatDate;exports.formatDateToddMMYYYY=l.formatDateToddMMYYYY;exports.subtractDaysFromDate=l.subtractDaysFromDate;exports.getCurrentDeviceSize=s.getCurrentDeviceSize;exports.isMobile=s.isMobile;exports.isSafari=s.isSafari;exports.isiOSDevice=s.isiOSDevice;exports.emptyElem=a.emptyElem;exports.getSingleElement=a.getSingleElement;exports.hideElem=a.hideElem;exports.showElem=a.showElem;exports.hash256=c.hash256;exports.hashEmail=c.hashEmail;exports.debounce=E.debounce;exports.isPromise=E.isPromise;exports.awaitableSetTimeout=m.awaitableSetTimeout;exports.createCustomEvent=m.createCustomEvent;exports.formatFloat=t.formatFloat;exports.formatInteger=t.formatInteger;exports.formatLocaleNumber=t.formatLocaleNumber;exports.formatNumber=t.formatNumber;exports.formatterNumberObj=t.formatterNumberObj;exports.parseLocaleNumber=t.parseLocaleNumber;exports.deepCopy=o.deepCopy;exports.getOrNull=o.getOrNull;exports.invertFlatObject=o.invertFlatObject;exports.isEmptyObject=o.isEmptyObject;exports.shallowCopyObjectTo=o.shallowCopyObjectTo;exports.observeOnce=C.observeOnce;exports.addPermissionStateListener=u.addPermissionStateListener;exports.onNotificationsPermissionChange=u.onNotificationsPermissionChange;exports.buildParams=n.buildParams;exports.buildParamsForAgency=n.buildParamsForAgency;exports.buildURL=n.buildURL;exports.capitalizeFirstLetter=r.capitalizeFirstLetter;exports.cleanASCII=r.cleanASCII;exports.decodeTextWithEntities=r.decodeTextWithEntities;exports.replaceAll=r.replaceAll;exports.replaceAllTokens=r.replaceAllTokens;exports.stringToHyphened=r.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=d.browserSupportGeolocation;exports.getUserPosition=d.getUserPosition;exports.formatAddress=b.formatAddress;exports.formattedAddress=b.formattedAddress;exports.googlePlaceConverter=S.googlePlaceConverter;exports.downloadFile=U.downloadFile;

package/dist/index.js

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

package/dist/utils/DateUtils.d.ts

@@ -1 +1,16 @@
 export declare function formatDate(date: Date, display?: boolean): string;
+/**
+ * Formats a date string from a certain format to 'dd/MM/yyyy' format.
+ * @param {string} date - The input date string.
+ * @returns {string} The formatted date string in 'dd/MM/yyyy' format.
+ */
+export declare const formatDateToddMMYYYY: (date: Date | string) => string;
+/**
+ * Subtracts a specified number of days from a given date.
+ * If no initial date is provided, the current date is used as the default.
+ * If the number of days is less than zero, it defaults to 0.
+ * @param {Date} initialDate - The initial date to subtract days from (default: current date).
+ * @param {number} days - The number of days to subtract.
+ * @returns {Date} A new Date object representing the result of subtracting the specified days from the initial date.
+ */
+export declare const subtractDaysFromDate: (initialDate: Date | undefined, days: number) => Date;

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.17",
   "description": "Wikicasa frontend utilities",
   "type": "module",
   "main": "dist/index.js",
@@ -45,6 +45,7 @@
   },
   "dependencies": {
     "axios": "^1.4.0",
+    "date-fns": "^3.6.0",
     "google-polyline": "^1.0.3",
     "jest": "^29.7.0",
     "js-cookie": "^3.0.5",