@blackbyte/sugar 1.0.0-beta.3 → 1.0.0-beta.4

package/dist/shared/currency/currencyStringToObject.d.ts

@@ -7,12 +7,11 @@
  * @status            stable
  *
  * This function take a currency string like "120 USD" and convert it to an object
- * like:
- * {
- *    "amount": 120,
- *    "code": "USD",
- *    "symbol": "$"
- * }
+ * containing these properties:
+ *
+ * - `amount`: 120,
+ * - `code`: USD,
+ * - `symbol`: $
  *
  * @param       {String}            currency            The currency string to convert
  * @return      {TCurrencyToObject}                     The currency object
@@ -23,9 +22,9 @@
  * import { currencyStringToObject } from '@blackbyte/sugar/currency';
  * currencyStringToObject('120 $');
  * {
- *   "amount": 120,
- *   "code": "USD",
- *   "symbol": "$"
+ *   amount: 120,
+ *   code: 'USD',
+ *   symbol: '$'
  * }
  *
  * @see       https://www.npmjs.com/package/currency-symbol-map

package/dist/shared/currency/currencyStringToObject.js.map

@@ -1 +1 @@
-{"version":3,"file":"currencyStringToObject.js","sourceRoot":"","sources":["../../../src/shared/currency/currencyStringToObject.ts"],"names":[],"mappings":"AAAA,OAAO,iBAAiB,MAAM,qBAAqB,CAAC;AA2CpD,MAAM,CAAC,OAAO,UAAU,sBAAsB,CAC5C,QAAgB;;IAEhB,iBAAiB;IACjB,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAEpC,yBAAyB;IACzB,MAAM,YAAY,GAAW,QAAQ,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAEzE,aAAa;IACb,MAAM,SAAS,GAAG,iBAAiB,CAAC,iBAAwB,CAAC;IAE7D,kCAAkC;IAClC,IAAI,IAAI,GAAG,EAAE,EACX,MAAM,GAAG,EAAE,CAAC;IACd,IAAI,SAAS,CAAC,YAAY,CAAC,EAAE,CAAC;QAC5B,IAAI,GAAG,YAAY,CAAC;QACpB,MAAM,GAAG,SAAS,CAAC,YAAY,CAAC,CAAC;IACnC,CAAC;SAAM,CAAC;QACN,IAAI;YACF,MAAA,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,YAAY,CAAC,mCACrE,EAAE,CAAC;QACL,MAAM,GAAG,YAAY,CAAC;IACxB,CAAC;IAED,OAAO;QACL,MAAM,EAAE,MAAM;QACd,IAAI;QACJ,MAAM;KACP,CAAC;AACJ,CAAC"}
+{"version":3,"file":"currencyStringToObject.js","sourceRoot":"","sources":["../../../src/shared/currency/currencyStringToObject.ts"],"names":[],"mappings":"AAAA,OAAO,iBAAiB,MAAM,qBAAqB,CAAC;AA0CpD,MAAM,CAAC,OAAO,UAAU,sBAAsB,CAC5C,QAAgB;;IAEhB,iBAAiB;IACjB,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAEpC,yBAAyB;IACzB,MAAM,YAAY,GAAW,QAAQ,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAEzE,aAAa;IACb,MAAM,SAAS,GAAG,iBAAiB,CAAC,iBAAwB,CAAC;IAE7D,kCAAkC;IAClC,IAAI,IAAI,GAAG,EAAE,EACX,MAAM,GAAG,EAAE,CAAC;IACd,IAAI,SAAS,CAAC,YAAY,CAAC,EAAE,CAAC;QAC5B,IAAI,GAAG,YAAY,CAAC;QACpB,MAAM,GAAG,SAAS,CAAC,YAAY,CAAC,CAAC;IACnC,CAAC;SAAM,CAAC;QACN,IAAI;YACF,MAAA,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,YAAY,CAAC,mCACrE,EAAE,CAAC;QACL,MAAM,GAAG,YAAY,CAAC;IACxB,CAAC;IAED,OAAO;QACL,MAAM,EAAE,MAAM;QACd,IAAI;QACJ,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist/shared/datetime/_exports.d.ts

@@ -1,7 +1,10 @@
+import diffBetweenDates from './diffBetweenDates.js';
 import formatDuration from './formatDuration.js';
+import parseDate from './parseDate.js';
 import sleep from './sleep.js';
 import timeAgo from './timeAgo.js';
+import toYyyyMmDd from './toYyyyMmDd.js';
 import utcTime from './utcTime.js';
 import wait from './wait.js';
 export * from './convertTime.js';
-export { formatDuration as __formatDuration, sleep as __sleep, timeAgo as __timeAgo, utcTime as __utcTime, wait as __wait, formatDuration, sleep, timeAgo, utcTime, wait, };
+export { diffBetweenDates as __diffBetweenDates, formatDuration as __formatDuration, parseDate as __parseDate, sleep as __sleep, timeAgo as __timeAgo, toYyyyMmDd as __toYyyyMmDd, utcTime as __utcTime, wait as __wait, diffBetweenDates, formatDuration, parseDate, sleep, timeAgo, toYyyyMmDd, utcTime, wait, };

package/dist/shared/datetime/_exports.js

@@ -1,8 +1,11 @@
+import diffBetweenDates from './diffBetweenDates.js';
 import formatDuration from './formatDuration.js';
+import parseDate from './parseDate.js';
 import sleep from './sleep.js';
 import timeAgo from './timeAgo.js';
+import toYyyyMmDd from './toYyyyMmDd.js';
 import utcTime from './utcTime.js';
 import wait from './wait.js';
 export * from './convertTime.js';
-export { formatDuration as __formatDuration, sleep as __sleep, timeAgo as __timeAgo, utcTime as __utcTime, wait as __wait, formatDuration, sleep, timeAgo, utcTime, wait, };
+export { diffBetweenDates as __diffBetweenDates, formatDuration as __formatDuration, parseDate as __parseDate, sleep as __sleep, timeAgo as __timeAgo, toYyyyMmDd as __toYyyyMmDd, utcTime as __utcTime, wait as __wait, diffBetweenDates, formatDuration, parseDate, sleep, timeAgo, toYyyyMmDd, utcTime, wait, };
 //# sourceMappingURL=_exports.js.map

package/dist/shared/datetime/_exports.js.map

@@ -1 +1 @@
-{"version":3,"file":"_exports.js","sourceRoot":"","sources":["../../../src/shared/datetime/_exports.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,MAAM,YAAY,CAAC;AAC/B,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,cAAc,kBAAkB,CAAC;AACjC,OAAO,EACL,cAAc,IAAI,gBAAgB,EAClC,KAAK,IAAI,OAAO,EAChB,OAAO,IAAI,SAAS,EACpB,OAAO,IAAI,SAAS,EACpB,IAAI,IAAI,MAAM,EACd,cAAc,EACd,KAAK,EACL,OAAO,EACP,OAAO,EACP,IAAI,GACL,CAAC"}
+{"version":3,"file":"_exports.js","sourceRoot":"","sources":["../../../src/shared/datetime/_exports.ts"],"names":[],"mappings":"AAAA,OAAO,gBAAgB,MAAM,uBAAuB,CAAC;AACrD,OAAO,cAAc,MAAM,qBAAqB,CAAC;AACjD,OAAO,SAAS,MAAM,gBAAgB,CAAC;AACvC,OAAO,KAAK,MAAM,YAAY,CAAC;AAC/B,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,UAAU,MAAM,iBAAiB,CAAC;AACzC,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,cAAc,kBAAkB,CAAC;AACjC,OAAO,EACL,gBAAgB,IAAI,kBAAkB,EACtC,cAAc,IAAI,gBAAgB,EAClC,SAAS,IAAI,WAAW,EACxB,KAAK,IAAI,OAAO,EAChB,OAAO,IAAI,SAAS,EACpB,UAAU,IAAI,YAAY,EAC1B,OAAO,IAAI,SAAS,EACpB,IAAI,IAAI,MAAM,EACd,gBAAgB,EAChB,cAAc,EACd,SAAS,EACT,KAAK,EACL,OAAO,EACP,UAAU,EACV,OAAO,EACP,IAAI,GACL,CAAC"}

package/dist/shared/datetime/diffBetweenDates.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @name                                diffBetweenDates
+ * @namespace                           shared.datetime
+ * @type                                Function
+ * @platform                            js
+ * @platform                            node
+ * @status                              stable
+ *
+ * This function allows you to get the difference between two date strings.
+ * It will returns you an object with the difference represented with these properties (years, months, days, hours, minutes, seconds).
+ * Under the hood, it make uses of the wonderful [Luxon](https://moment.github.io/luxon) library.
+ *
+ * @param           {String}                            date                    The date string to parse
+ * @param           {TDiffBetweenDatesSettings}         [settings={}]           Some settings to configure your parsing
+ * @return          {Date}                                                      The `Date` instance representing your date string
+ *
+ * @setting         {String}        [format='']                                 If you know the format of your date string, you can pass it here. This will make the parsing faster and more reliable. See [Luxon documentation](https://moment.github.io/luxon/#/parsing?id=table-of-tokens) for the list of supported tokens.
+ *
+ * @snippet         diffBetweenDates($1, $2, $3)
+ *
+ * @example           js
+ * import { diffBetweenDates } from '@blackbyte/sugar/datetime';
+ * diffBetweenDates('1945-10-12', '2025-10-15');
+ *
+ * @see             https://moment.github.io/luxon
+ * @since           1.0.0
+ * @author          Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export type TDiffBetweenDatesSettings = {
+    format: string;
+};
+export default function diffBetweenDates(date1: string | Date, date2: string | Date, settings?: Partial<TDiffBetweenDatesSettings>): {
+    years?: number;
+    months?: number;
+    days?: number;
+    hours?: number;
+    minutes?: number;
+    seconds?: number;
+} | null;

package/dist/shared/datetime/diffBetweenDates.js

@@ -0,0 +1,25 @@
+import { DateTime } from 'luxon';
+import parseDate from './parseDate.js';
+export default function diffBetweenDates(date1, date2, settings) {
+    const finalSettings = Object.assign({ format: '' }, (settings !== null && settings !== void 0 ? settings : {}));
+    // prse the passed date
+    const jsDate1 = parseDate(date1, finalSettings);
+    const jsDate2 = parseDate(date2, finalSettings);
+    if (!jsDate1 || !jsDate2) {
+        return null;
+    }
+    const luxonDate1 = DateTime.fromJSDate(jsDate1);
+    const luxonDate2 = DateTime.fromJSDate(jsDate2);
+    const diff = luxonDate2
+        .diff(luxonDate1, [
+        'years',
+        'months',
+        'days',
+        'hours',
+        'minutes',
+        'seconds',
+    ])
+        .toObject();
+    return diff;
+}
+//# sourceMappingURL=diffBetweenDates.js.map

package/dist/shared/datetime/diffBetweenDates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diffBetweenDates.js","sourceRoot":"","sources":["../../../src/shared/datetime/diffBetweenDates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,SAAS,MAAM,gBAAgB,CAAC;AAmCvC,MAAM,CAAC,OAAO,UAAU,gBAAgB,CACtC,KAAoB,EACpB,KAAoB,EACpB,QAA6C;IAS7C,MAAM,aAAa,mBACjB,MAAM,EAAE,EAAE,IACP,CAAC,QAAQ,aAAR,QAAQ,cAAR,QAAQ,GAAI,EAAE,CAAC,CACpB,CAAC;IAEF,uBAAuB;IACvB,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;IAEhD,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAEhD,MAAM,IAAI,GAAG,UAAU;SACpB,IAAI,CAAC,UAAU,EAAE;QAChB,OAAO;QACP,QAAQ;QACR,MAAM;QACN,OAAO;QACP,SAAS;QACT,SAAS;KACV,CAAC;SACD,QAAQ,EAAE,CAAC;IAEd,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/shared/datetime/parseDate.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @name                                parseDate
+ * @namespace                           shared.datetime
+ * @type                                Function
+ * @platform                            js
+ * @platform                            node
+ * @status                              stable
+ *
+ * This function allows you to parse a date string. It will returns the `Date` instance for this date.
+ * Under the hood, it make uses of the wonderful [Luxon](https://moment.github.io/luxon) library.
+ * Make sure to use the library if you need more control over your dates.
+ * Luxon support these date formats:
+ *
+ * - ISO 8601
+ * - RFC2822
+ * - HTTP (header)
+ *
+ * @param           {String}                    date                    The date string to parse
+ * @param           {TParseDateSettings}        [settings={}]           Some settings to configure your parsing
+ * @return          {Date}                                              The `Date` instance representing your date string
+ *
+ * @setting         {String}        [format='']                         If you know the format of your date string, you can pass it here. This will make the parsing faster and more reliable. See [Luxon documentation](https://moment.github.io/luxon/#/parsing?id=table-of-tokens) for the list of supported tokens.
+ *
+ * @snippet         parseDate($1, $2)
+ *
+ * @example           js
+ * import { parseDate } from '@blackbyte/sugar/datetime';
+ * parseDate('2025-10-12');
+ * parseDate('2024-10-15T10:30:00Z');
+ *
+ * @see             https://moment.github.io/luxon
+ * @since           1.0.0
+ * @author          Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export type TParseDateSettings = {
+    format: string;
+};
+export default function parseDate(date: string | Date, settings?: Partial<TParseDateSettings>): Date | null;

package/dist/shared/datetime/parseDate.js

@@ -0,0 +1,34 @@
+import { DateTime } from 'luxon';
+export default function parseDate(date, settings) {
+    const finalSettings = Object.assign({ format: '' }, (settings !== null && settings !== void 0 ? settings : {}));
+    let luxonDate;
+    // if it is already a date, we just return it
+    if (date instanceof Date) {
+        return date;
+    }
+    // if a format is passed, we check this.
+    // if it's invalid, we return null
+    if (finalSettings.format) {
+        luxonDate = DateTime.fromFormat(date, finalSettings.format);
+    }
+    if (luxonDate === null || luxonDate === void 0 ? void 0 : luxonDate.invalid) {
+        return null;
+    }
+    // otherwise we try to parse the date string
+    // using all the format supported by luxon
+    luxonDate = DateTime.fromISO(date);
+    if (!(luxonDate === null || luxonDate === void 0 ? void 0 : luxonDate.invalid)) {
+        return luxonDate.toJSDate();
+    }
+    luxonDate = DateTime.fromRFC2822(date);
+    if (!(luxonDate === null || luxonDate === void 0 ? void 0 : luxonDate.invalid)) {
+        return luxonDate.toJSDate();
+    }
+    luxonDate = DateTime.fromHTTP(date);
+    if (!(luxonDate === null || luxonDate === void 0 ? void 0 : luxonDate.invalid)) {
+        return luxonDate.toJSDate();
+    }
+    // nothing worked...
+    return null;
+}
+//# sourceMappingURL=parseDate.js.map

package/dist/shared/datetime/parseDate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseDate.js","sourceRoot":"","sources":["../../../src/shared/datetime/parseDate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAyCjC,MAAM,CAAC,OAAO,UAAU,SAAS,CAC/B,IAAmB,EACnB,QAAsC;IAEtC,MAAM,aAAa,mBACjB,MAAM,EAAE,EAAE,IACP,CAAC,QAAQ,aAAR,QAAQ,cAAR,QAAQ,GAAI,EAAE,CAAC,CACpB,CAAC;IACF,IAAI,SAAS,CAAC;IAEd,6CAA6C;IAC7C,IAAI,IAAI,YAAY,IAAI,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,wCAAwC;IACxC,kCAAkC;IAClC,IAAI,aAAa,CAAC,MAAM,EAAE,CAAC;QACzB,SAAS,GAAG,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9D,CAAC;IACD,IAAI,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,OAAO,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,4CAA4C;IAC5C,0CAA0C;IAC1C,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,CAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,OAAO,CAAA,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC,QAAQ,EAAE,CAAC;IAC9B,CAAC;IAED,SAAS,GAAG,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,CAAC,CAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,OAAO,CAAA,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC,QAAQ,EAAE,CAAC;IAC9B,CAAC;IAED,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,CAAC,CAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,OAAO,CAAA,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC,QAAQ,EAAE,CAAC;IAC9B,CAAC;IAED,oBAAoB;IACpB,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/shared/datetime/toYyyyMmDd.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @name                                toYyyyMmDd
+ * @namespace                           shared.datetime
+ * @type                                Function
+ * @platform                            js
+ * @platform                            node
+ * @status                              stable
+ *
+ * This function allows you to pass any date string or Date instance and get back this
+ * one formatted as `YYYY-MM-DD`.
+ * This format is useful when you need to store dates in a database, set a date input value, etc...
+ * Under the hood, it make uses of the wonderful [Luxon](https://moment.github.io/luxon) library.
+ *
+ * @param           {String}                            date                    The date (string) to convert to `YYYY-MM-DD`
+ * @param           {TtoYyyyMmDdSettings}               [settings={}]           Some settings to configure your parsing
+ * @return          {String}                                                    The date formatted as `YYYY-MM-DD`
+ *
+ * @setting         {String}        [format='']                                 If you know the format of your date string, you can pass it here. This will make the parsing faster and more reliable. See [Luxon documentation](https://moment.github.io/luxon/#/parsing?id=table-of-tokens) for the list of supported tokens.
+ *
+ * @snippet         toYyyyMmDd($1, $2, $3)
+ *
+ * @example           js
+ * import { toYyyyMmDd } from '@blackbyte/sugar/datetime';
+ * toYyyyMmDd('2025-10-15T14:30:00+02:00'); // '2025-10-15'
+ *
+ * @see             https://moment.github.io/luxon
+ * @since           1.0.0
+ * @author          Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export type TtoYyyyMmDdSettings = {
+    format: string;
+    separator: string;
+};
+export default function toYyyyMmDd(date: string | Date, settings?: Partial<TtoYyyyMmDdSettings>): string | null;

package/dist/shared/datetime/toYyyyMmDd.js

@@ -0,0 +1,19 @@
+import parseDate from './parseDate.js';
+export default function toYyyyMmDd(date, settings) {
+    const finalSettings = Object.assign({ format: '', separator: '-' }, (settings !== null && settings !== void 0 ? settings : {}));
+    if (typeof date === 'string' && date.match(/^\d{4}-\d{2}-\d{2}$/)) {
+        // already in the correct format
+        return date;
+    }
+    // prse the passed date
+    const jsDate = parseDate(date, finalSettings);
+    if (!jsDate) {
+        return null;
+    }
+    const dateStr = jsDate
+        .toISOString()
+        .split('T')[0]
+        .replace('-', finalSettings.separator);
+    return dateStr;
+}
+//# sourceMappingURL=toYyyyMmDd.js.map

package/dist/shared/datetime/toYyyyMmDd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toYyyyMmDd.js","sourceRoot":"","sources":["../../../src/shared/datetime/toYyyyMmDd.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,gBAAgB,CAAC;AAqCvC,MAAM,CAAC,OAAO,UAAU,UAAU,CAChC,IAAmB,EACnB,QAAuC;IAEvC,MAAM,aAAa,mBACjB,MAAM,EAAE,EAAE,EACV,SAAS,EAAE,GAAG,IACX,CAAC,QAAQ,aAAR,QAAQ,cAAR,QAAQ,GAAI,EAAE,CAAC,CACpB,CAAC;IAEF,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,EAAE,CAAC;QAClE,gCAAgC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,uBAAuB;IACvB,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IAC9C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,OAAO,GAAG,MAAM;SACnB,WAAW,EAAE;SACb,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;SACb,OAAO,CAAC,GAAG,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACzC,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@blackbyte/sugar",
   "description": "The toolkit that you missed... like a sugar in your coffee!",
-  "version": "1.0.0-beta.3",
+  "version": "1.0.0-beta.4",
   "keywords": [
     "javascript",
     "typescript",
@@ -203,6 +203,7 @@
   },
   "dependencies": {
     "@faker-js/faker": "^8.4.1",
+    "@types/luxon": "^3.7.1",
     "aggregation": "^1.2.7",
     "atob": "^2.1.2",
     "blueimp-md5": "^2.19.0",
@@ -238,6 +239,7 @@
     "json-cyclic": "^1.0.2",
     "lodash.clone": "^4.5.0",
     "lodash.clonedeep": "^4.5.0",
+    "luxon": "^3.7.2",
     "mark.js": "^8.11.1",
     "memoizee": "^0.4.15",
     "micromatch": "^4.0.5",