@blackbyte/sugar 1.0.0-beta.29 → 1.0.0-beta.30

package/dist/shared/datetime/convertTime.js

@@ -1,127 +0,0 @@
-/**
- * @name                                convertTime
- * @namespace                           shared.datetime
- * @type                                Function
- * @platform                            js
- * @platform                            node
- * @status                              stable
- *
- * This function allows you to convert time like seconds, ms, hours, minutes, etc... from one format to another
- *
- * @param           {String|Number}             from                  The value to start from like "10s", "20ms", "2h", etc... Supports 'ms', 'millisecond', 'milliseconds', 's', 'second', 'seconds', 'm', 'minute', 'minutes', 'h', 'hour', 'hours', 'd', 'day', 'days', 'w', 'week', 'weeks', 'month', 'months', 'y', 'year', 'years'
- * @param           {String}                    [to='ms']             The format you want to get back. Can be 'ms' | 'millisecond' | 'milliseconds' | 's' | 'second' | 'seconds' | 'm' | 'minute' | 'minutes' | 'h' | 'hour' | 'hours' | 'd' | 'day' | 'days' | 'w' | 'week' | 'weeks' | 'month' | 'months' | 'y' | 'year' | 'years'
- * @return          {Number}                                          The converted value
- *
- * @todo      tests
- *
- * @snippet         convertTime($1, $2)
- *
- * @example           js
- * import { convertTime } from '@blackbyte/sugar/datetime';
- * convertTime('10s', 'ms'); // => 10000
- *
- * @since       1.0.0
- * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
- */
-export default function convertTime(from, to = 'ms') {
-    // @ts-ignore
-    let fromMs = from;
-    // check if the time is a string to convert it to ms
-    if (typeof from === 'string') {
-        const fromNumber = parseFloat(from);
-        const fromLength = fromNumber.toString().length;
-        const fromString = from.slice(fromLength);
-        if (fromString === 'ms' ||
-            fromString === 'millisecond' ||
-            fromString === 'milliseconds') {
-            fromMs = fromNumber;
-        }
-        else if (fromString === 's' ||
-            fromString === 'second' ||
-            fromString === 'seconds') {
-            fromMs = fromNumber * 1000;
-        }
-        else if (fromString === 'm' ||
-            fromString === 'minute' ||
-            fromString === 'minutes') {
-            fromMs = fromNumber * 60 * 1000;
-        }
-        else if (fromString === 'h' ||
-            fromString === 'hour' ||
-            fromString === 'hours') {
-            fromMs = fromNumber * 60 * 60 * 1000;
-        }
-        else if (fromString === 'd' ||
-            fromString === 'day' ||
-            fromString === 'days') {
-            fromMs = fromNumber * 24 * 60 * 60 * 1000;
-        }
-        else if (fromString === 'w' ||
-            fromString === 'week' ||
-            fromString === 'weeks') {
-            fromMs = fromNumber * 7 * 24 * 60 * 60 * 1000;
-        }
-        else if (fromString === 'month' || fromString === 'months') {
-            fromMs = fromNumber * 31 * 24 * 60 * 60 * 1000;
-        }
-        else if (fromString === 'y' ||
-            fromString === 'year' ||
-            fromString === 'years') {
-            fromMs = fromNumber * 365 * 24 * 60 * 60 * 1000;
-        }
-    }
-    // convert not the fromMs value to the requested format
-    switch (to) {
-        case 'ms':
-        case 'millisecond':
-        case 'milliseconds':
-            return fromMs;
-            break;
-        case 's':
-        case 'second':
-        case 'seconds':
-            return fromMs / 1000;
-            break;
-        case 'm':
-        case 'minute':
-        case 'minutes':
-            return fromMs / 1000 / 60;
-            break;
-        case 'h':
-        case 'hour':
-        case 'hours':
-            return fromMs / 1000 / 60 / 60;
-            break;
-        case 'd':
-        case 'day':
-        case 'days':
-            return fromMs / 1000 / 60 / 60 / 24;
-            break;
-        case 'w':
-        case 'week':
-        case 'weeks':
-            return fromMs / 1000 / 60 / 60 / 24 / 7;
-            break;
-        case 'month':
-        case 'months':
-            return fromMs / 1000 / 60 / 60 / 24 / 31;
-            break;
-        case 'y':
-        case 'year':
-        case 'years':
-            return fromMs / 1000 / 60 / 60 / 24 / 365;
-            break;
-        default:
-            throw new Error(`You try to convert "${from}" to "${to}" but this format does not exist... The valids formats are "ms,s,m,h,d,w,month,y"...`);
-            break;
-    }
-}
-convertTime.MILLISECOND = 'ms';
-convertTime.SECOND = 's';
-convertTime.MINUTE = 'm';
-convertTime.HOUR = 'h';
-convertTime.DAY = 'd';
-convertTime.WEEK = 'w';
-convertTime.MONTH = 'month';
-convertTime.YEAR = 'y';
-//# sourceMappingURL=convertTime.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"convertTime.js","sourceRoot":"","sources":["../../../src/shared/datetime/convertTime.ts"],"names":[],"mappings":"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"}

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

@@ -1,39 +0,0 @@
-/**
- * @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

@@ -1,25 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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/formatDuration.d.ts

@@ -1,25 +0,0 @@
-/**
- * @name                formatDuration
- * @namespace           shared.datetime
- * @type                Function
- * @platform            js
- * @platform            node
- * @status              stable
- *
- * This function let you pass a duration in ms and get back a formatted estimation like "2.4m", "30s", etc...
- *
- * @param         {Number}        duration          The duration in ms to format
- * @return        {String}                          The formatted estimation duration
- *
- * @todo      tests
- *
- * @snippet         formatDuration($1)
- *
- * @example       js
- * import { formatDuration } from '@blackbyte/sugar/datetime';
- * formatDuration(2000); // => 2s
- *
- * @since       1.0.0
- * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
- */
-export default function formatDuration(duration: number): string;

package/dist/shared/datetime/formatDuration.js

@@ -1,45 +0,0 @@
-/**
- * @name                formatDuration
- * @namespace           shared.datetime
- * @type                Function
- * @platform            js
- * @platform            node
- * @status              stable
- *
- * This function let you pass a duration in ms and get back a formatted estimation like "2.4m", "30s", etc...
- *
- * @param         {Number}        duration          The duration in ms to format
- * @return        {String}                          The formatted estimation duration
- *
- * @todo      tests
- *
- * @snippet         formatDuration($1)
- *
- * @example       js
- * import { formatDuration } from '@blackbyte/sugar/datetime';
- * formatDuration(2000); // => 2s
- *
- * @since       1.0.0
- * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
- */
-export default function formatDuration(duration) {
-    if (duration === Infinity) {
-        return '...';
-    }
-    if (duration < 1000) {
-        return `${duration}ms`;
-    }
-    if (duration < 1000 * 60) {
-        const s = duration / 1000;
-        return `${s.toFixed(2)}s`;
-    }
-    if (duration < 1000 * 60 * 60) {
-        const m = Math.floor(duration / 1000 / 60);
-        const s = Math.round((duration - m * 1000 * 60) / 1000);
-        return `${m}m${s > 0 ? `${s}s` : ''}`;
-    }
-    const h = Math.floor(duration / 1000 / 60 / 60);
-    const m = Math.floor((duration - h * 1000 * 60 * 60) / 1000 / 60);
-    return `${h}h${m > 0 ? `${m}m` : ''}`;
-}
-//# sourceMappingURL=formatDuration.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"formatDuration.js","sourceRoot":"","sources":["../../../src/shared/datetime/formatDuration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,OAAO,UAAU,cAAc,CAAC,QAAgB;IACrD,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,QAAQ,GAAG,IAAI,EAAE,CAAC;QACpB,OAAO,GAAG,QAAQ,IAAI,CAAC;IACzB,CAAC;IACD,IAAI,QAAQ,GAAG,IAAI,GAAG,EAAE,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,QAAQ,GAAG,IAAI,CAAC;QAC1B,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IAC5B,CAAC;IACD,IAAI,QAAQ,GAAG,IAAI,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC;QAC9B,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC;QAC3C,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,GAAG,CAAC,GAAG,IAAI,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QACxD,OAAO,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACxC,CAAC;IAED,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,IAAI,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;IAChD,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,GAAG,CAAC,GAAG,IAAI,GAAG,EAAE,GAAG,EAAE,CAAC,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC;IAClE,OAAO,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AACxC,CAAC"}

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

@@ -1,38 +0,0 @@
-/**
- * @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

@@ -1,34 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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/sleep.d.ts

@@ -1,27 +0,0 @@
-/**
- * @name            sleep
- * @namespace       shared.datetime
- * @type            Function
- * @platform        js
- * @platform        node
- * @async
- * @status          stable
- *
- * This function is a simple "setTimeout" wrapper inside a promise.
- *
- * @param         {Number}        timeout       The timeout to sleep in ms
- * @return        {Promise}                     A simple promise resolved once the timeout is finished
- *
- * @todo      tests
- *
- * @snippet         sleep($1)
- * await sleep($1)
- *
- * @example       js
- * import { sleep } from '@blackbyte/sugar/datetime';
- * await sleep(2000);
- *
- * @since       1.0.0
- * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
- */
-export default function sleep(timeout?: number): Promise<void>;

package/dist/shared/datetime/sleep.js

@@ -1,34 +0,0 @@
-/**
- * @name            sleep
- * @namespace       shared.datetime
- * @type            Function
- * @platform        js
- * @platform        node
- * @async
- * @status          stable
- *
- * This function is a simple "setTimeout" wrapper inside a promise.
- *
- * @param         {Number}        timeout       The timeout to sleep in ms
- * @return        {Promise}                     A simple promise resolved once the timeout is finished
- *
- * @todo      tests
- *
- * @snippet         sleep($1)
- * await sleep($1)
- *
- * @example       js
- * import { sleep } from '@blackbyte/sugar/datetime';
- * await sleep(2000);
- *
- * @since       1.0.0
- * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
- */
-export default function sleep(timeout = 0) {
-    return new Promise((resolve) => {
-        setTimeout(() => {
-            resolve();
-        }, timeout);
-    });
-}
-//# sourceMappingURL=sleep.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"sleep.js","sourceRoot":"","sources":["../../../src/shared/datetime/sleep.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,OAAO,UAAU,KAAK,CAAC,UAAkB,CAAC;IAC/C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,UAAU,CAAC,GAAG,EAAE;YACd,OAAO,EAAE,CAAC;QACZ,CAAC,EAAE,OAAO,CAAC,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC"}

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

@@ -1,27 +0,0 @@
-/**
- * @name                timeAgo
- * @namespace           shared.datetime
- * @type                Function
- * @platform            js
- * @platform            node
- * @status              stable
- *
- * Simple "time" ago for your Unix timestamps and JavaScript Date objects.
- *
- * @param           {Number}             timestamp                 The timestamp to transform
- * @param           {'short'|'medium'|'long'}       [format='medium']       The format you want back
- * @return          {String}                                          The converted value
- *
- * @todo      tests
- *
- * @snippet         timeAgo($1)
- *
- * @example           js
- * import { timeAgo } from '@blackbyte/sugar/datetime';
- * timeAgo(1611344957); // => 7 secs ago
- *
- * @see         https://www.npmjs.com/package/js-ago
- * @since       1.0.0
- * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
- */
-export default function timeAgo(timestamp: number | Date, format?: 'short' | 'medium' | 'long'): string;

package/dist/shared/datetime/timeAgo.js

@@ -1,38 +0,0 @@
-// @ts-nocheck
-import __jsAgo from 'js-ago';
-/**
- * @name                timeAgo
- * @namespace           shared.datetime
- * @type                Function
- * @platform            js
- * @platform            node
- * @status              stable
- *
- * Simple "time" ago for your Unix timestamps and JavaScript Date objects.
- *
- * @param           {Number}             timestamp                 The timestamp to transform
- * @param           {'short'|'medium'|'long'}       [format='medium']       The format you want back
- * @return          {String}                                          The converted value
- *
- * @todo      tests
- *
- * @snippet         timeAgo($1)
- *
- * @example           js
- * import { timeAgo } from '@blackbyte/sugar/datetime';
- * timeAgo(1611344957); // => 7 secs ago
- *
- * @see         https://www.npmjs.com/package/js-ago
- * @since       1.0.0
- * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
- */
-export default function timeAgo(timestamp, format = 'medium') {
-    let finalTimestamp = timestamp;
-    if (timestamp instanceof Date) {
-        finalTimestamp = timestamp.getTime();
-    }
-    return __jsAgo(finalTimestamp, {
-        format,
-    });
-}
-//# sourceMappingURL=timeAgo.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"timeAgo.js","sourceRoot":"","sources":["../../../src/shared/datetime/timeAgo.ts"],"names":[],"mappings":"AAAA,cAAc;AACd,OAAO,OAAO,MAAM,QAAQ,CAAC;AAE7B;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,OAAO,UAAU,OAAO,CAC7B,SAAwB,EACxB,SAAsC,QAAQ;IAE9C,IAAI,cAAc,GAAW,SAAS,CAAC;IACvC,IAAI,SAAS,YAAY,IAAI,EAAE,CAAC;QAC9B,cAAc,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC;IACvC,CAAC;IAED,OAAO,OAAO,CAAC,cAAc,EAAE;QAC7B,MAAM;KACP,CAAC,CAAC;AACL,CAAC"}

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

@@ -1,34 +0,0 @@
-/**
- * @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

@@ -1,19 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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/dist/shared/datetime/utcTime.d.ts

@@ -1,29 +0,0 @@
-/**
- * @name            utcTime
- * @namespace       shared.datetime
- * @type            Function
- * @platform        js
- * @platform        node
- * @status          stable
- *
- * This method allows you to display easily the time in UTC format like "10:20:32"
- *
- * @param       {Boolean}          [hours=true]             Display the hours or not
- * @param       {Boolean}          [minutes=true]             Display the minutes or not
- * @param       {Boolean}          [seconds=true]             Display the seconds or not
- * @param       {Date}           [date=new Date()]         The date to use to display the time
- * @return      {String}                                    The time string
- *
- * @todo        tests
- *
- * @snippet         utcTime()
- *
- * @example         js
- * import { utcTime } from '@blackbyte/sugar/date';
- * utcTime(); // => 10:20:32
- * utcTime(true, true, false); // => 10:20
- *
- * @since       1.0.0
- * @author 	                Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
- */
-export default function utcTime(hours?: boolean, minutes?: boolean, seconds?: boolean, date?: Date): string;

package/dist/shared/datetime/utcTime.js

@@ -1,39 +0,0 @@
-/**
- * @name            utcTime
- * @namespace       shared.datetime
- * @type            Function
- * @platform        js
- * @platform        node
- * @status          stable
- *
- * This method allows you to display easily the time in UTC format like "10:20:32"
- *
- * @param       {Boolean}          [hours=true]             Display the hours or not
- * @param       {Boolean}          [minutes=true]             Display the minutes or not
- * @param       {Boolean}          [seconds=true]             Display the seconds or not
- * @param       {Date}           [date=new Date()]         The date to use to display the time
- * @return      {String}                                    The time string
- *
- * @todo        tests
- *
- * @snippet         utcTime()
- *
- * @example         js
- * import { utcTime } from '@blackbyte/sugar/date';
- * utcTime(); // => 10:20:32
- * utcTime(true, true, false); // => 10:20
- *
- * @since       1.0.0
- * @author 	                Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
- */
-export default function utcTime(hours = true, minutes = true, seconds = true, date = new Date()) {
-    const timeAr = [];
-    if (hours)
-        timeAr.push(date.getHours());
-    if (minutes)
-        timeAr.push(date.getMinutes());
-    if (seconds)
-        timeAr.push(date.getSeconds());
-    return timeAr.join(':');
-}
-//# sourceMappingURL=utcTime.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"utcTime.js","sourceRoot":"","sources":["../../../src/shared/datetime/utcTime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,OAAO,UAAU,OAAO,CAC7B,KAAK,GAAG,IAAI,EACZ,OAAO,GAAG,IAAI,EACd,OAAO,GAAG,IAAI,EACd,IAAI,GAAG,IAAI,IAAI,EAAE;IAEjB,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,KAAK;QAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IACxC,IAAI,OAAO;QAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;IAC5C,IAAI,OAAO;QAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;IAC5C,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC1B,CAAC"}