@tmlmobilidade/utils 20251031.1051.3 → 20251202.1817.5

package/dist/src/dates/dates.d.ts

@@ -1,175 +0,0 @@
-import { type DatesFormat } from './format.js';
-import { type TimezoneIdentified } from './types.js';
-import { type OperationalDate, type UnixTimestamp } from '@tmlmobilidade/types';
-import { type DateObjectUnits, type DateTimeUnit, type DurationObjectUnits } from 'luxon';
-interface DatesConstructor {
-    iso: null | string;
-    js_date: Date;
-    operational_date: OperationalDate;
-    std_window: {
-        end: UnixTimestamp;
-        start: UnixTimestamp;
-    };
-    unix_timestamp: UnixTimestamp;
-}
-export declare class Dates {
-    static readonly STANDARD_WINDOW_HOURS = 10;
-    static get FORMATS(): {
-        DATE_FULL: DatesFormat;
-        DATE_FULL_WITH_YEAR: DatesFormat;
-        DATE_HUGE: DatesFormat;
-        DATE_MEDIUM: DatesFormat;
-        DATE_SHORT: DatesFormat;
-        DATETIME_FULL: DatesFormat;
-        DATETIME_FULL_WITH_SECONDS: DatesFormat;
-        DATETIME_MEDIUM: DatesFormat;
-        DATETIME_MEDIUM_WITH_SECONDS: DatesFormat;
-        DATETIME_SHORT: DatesFormat;
-        DATETIME_SHORT_WITH_SECONDS: DatesFormat;
-        OPERATIONAL_DATE_FORMAT: string;
-        TIME_SIMPLE: DatesFormat;
-        TIME_WITH_SECONDS: DatesFormat;
-    };
-    static get TIMEZONE_LIST(): readonly ["Africa/Abidjan", "Africa/Accra", "Africa/Algiers", "Africa/Bissau", "Africa/Cairo", "Africa/Casablanca", "Africa/Ceuta", "Africa/El_Aaiun", "Africa/Johannesburg", "Africa/Juba", "Africa/Khartoum", "Africa/Lagos", "Africa/Maputo", "Africa/Monrovia", "Africa/Nairobi", "Africa/Ndjamena", "Africa/Sao_Tome", "Africa/Tripoli", "Africa/Tunis", "Africa/Windhoek", "America/Adak", "America/Anchorage", "America/Araguaina", "America/Argentina/Buenos_Aires", "America/Argentina/Catamarca", "America/Argentina/Cordoba", "America/Argentina/Jujuy", "America/Argentina/La_Rioja", "America/Argentina/Mendoza", "America/Argentina/Rio_Gallegos", "America/Argentina/Salta", "America/Argentina/San_Juan", "America/Argentina/San_Luis", "America/Argentina/Tucuman", "America/Argentina/Ushuaia", "America/Asuncion", "America/Atikokan", "America/Bahia_Banderas", "America/Bahia", "America/Barbados", "America/Belem", "America/Belize", "America/Blanc-Sablon", "America/Boa_Vista", "America/Bogota", "America/Boise", "America/Cambridge_Bay", "America/Campo_Grande", "America/Cancun", "America/Caracas", "America/Cayenne", "America/Chicago", "America/Chihuahua", "America/Costa_Rica", "America/Creston", "America/Cuiaba", "America/Curacao", "America/Danmarkshavn", "America/Dawson_Creek", "America/Dawson", "America/Denver", "America/Detroit", "America/Edmonton", "America/Eirunepe", "America/El_Salvador", "America/Fort_Nelson", "America/Fortaleza", "America/Glace_Bay", "America/Goose_Bay", "America/Grand_Turk", "America/Guatemala", "America/Guayaquil", "America/Guyana", "America/Halifax", "America/Havana", "America/Hermosillo", "America/Indiana", "America/Inuvik", "America/Iqaluit", "America/Jamaica", "America/Juneau", "America/Kentucky", "America/La_Paz", "America/Lima", "America/Los_Angeles", "America/Maceio", "America/Managua", "America/Manaus", "America/Martinique", "America/Matamoros", "America/Mazatlan", "America/Menominee", "America/Merida", "America/Metlakatla", "America/Mexico_City", "America/Miquelon", "America/Moncton", "America/Monterrey", "America/Montevideo", "America/Nassau", "America/New_York", "America/Nipigon", "America/Nome", "America/Noronha", "America/North_Dakota", "America/Nuuk", "America/Ojinaga", "America/Panama", "America/Pangnirtung", "America/Paramaribo", "America/Phoenix", "America/Port_of_Spain", "America/Port-au-Prince", "America/Porto_Velho", "America/Puerto_Rico", "America/Punta_Arenas", "America/Rainy_River", "America/Rankin_Inlet", "America/Recife", "America/Regina", "America/Resolute", "America/Rio_Branco", "America/Santarem", "America/Santiago", "America/Santo_Domingo", "America/Sao_Paulo", "America/Scoresbysund", "America/Sitka", "America/St_Johns", "America/Swift_Current", "America/Tegucigalpa", "America/Thule", "America/Thunder_Bay", "America/Tijuana", "America/Toronto", "America/Vancouver", "America/Whitehorse", "America/Winnipeg", "America/Yakutat", "America/Yellowknife", "Antarctica/Casey", "Antarctica/Davis", "Antarctica/DumontDUrville", "Antarctica/Macquarie", "Antarctica/Mawson", "Antarctica/Palmer", "Antarctica/Rothera", "Antarctica/Syowa", "Antarctica/Troll", "Antarctica/Vostok", "Asia/Almaty", "Asia/Amman", "Asia/Anadyr", "Asia/Aqtau", "Asia/Aqtobe", "Asia/Ashgabat", "Asia/Atyrau", "Asia/Baghdad", "Asia/Baku", "Asia/Bangkok", "Asia/Barnaul", "Asia/Beirut", "Asia/Bishkek", "Asia/Brunei", "Asia/Chita", "Asia/Choibalsan", "Asia/Colombo", "Asia/Damascus", "Asia/Dhaka", "Asia/Dili", "Asia/Dubai", "Asia/Dushanbe", "Asia/Famagusta", "Asia/Gaza", "Asia/Hebron", "Asia/Ho_Chi_Minh", "Asia/Hong_Kong", "Asia/Hovd", "Asia/Irkutsk", "Asia/Jakarta", "Asia/Jayapura", "Asia/Jerusalem", "Asia/Kabul", "Asia/Kamchatka", "Asia/Karachi", "Asia/Kathmandu", "Asia/Khandyga", "Asia/Kolkata", "Asia/Krasnoyarsk", "Asia/Kuala_Lumpur", "Asia/Kuching", "Asia/Macau", "Asia/Magadan", "Asia/Makassar", "Asia/Manila", "Asia/Nicosia", "Asia/Novokuznetsk", "Asia/Novosibirsk", "Asia/Omsk", "Asia/Pontianak", "Asia/Pyongyang", "Asia/Qatar", "Asia/Qostanay", "Asia/Qyzylorda", "Asia/Riyadh", "Asia/Sakhalin", "Asia/Samarkand", "Asia/Seoul", "Asia/Shanghai", "Asia/Singapore", "Asia/Srednekolymsk", "Asia/Taipei", "Asia/Tashkent", "Asia/Tbilisi", "Asia/Tehran", "Asia/Thimphu", "Asia/Tokyo", "Asia/Tomsk", "Asia/Ulaanbaatar", "Asia/Urumqi", "Asia/Ust-Nera", "Asia/Vladivostok", "Asia/Yakutsk", "Asia/Yangon", "Asia/Yekaterinburg", "Asia/Yerevan", "Atlantic/Azores", "Atlantic/Bermuda", "Atlantic/Canary", "Atlantic/Cape_Verde", "Atlantic/Faroe", "Atlantic/Madeira", "Atlantic/Reykjavik", "Atlantic/South_Georgia", "Atlantic/Stanley", "Australia/Adelaide", "Australia/Brisbane", "Australia/Broken_Hill", "Australia/Darwin", "Australia/Eucla", "Australia/Hobart", "Australia/Lindeman", "Australia/Lord_Howe", "Australia/Melbourne", "Australia/Perth", "Australia/Sydney", "Europe/Amsterdam", "Europe/Andorra", "Europe/Astrakhan", "Europe/Athens", "Europe/Belgrade", "Europe/Berlin", "Europe/Brussels", "Europe/Bucharest", "Europe/Budapest", "Europe/Chisinau", "Europe/Copenhagen", "Europe/Dublin", "Europe/Gibraltar", "Europe/Helsinki", "Europe/Istanbul", "Europe/Kaliningrad", "Europe/Kiev", "Europe/Kirov", "Europe/Lisbon", "Europe/London", "Europe/Luxembourg", "Europe/Madrid", "Europe/Malta", "Europe/Minsk", "Europe/Monaco", "Europe/Moscow", "Europe/Paris", "Europe/Prague", "Europe/Riga", "Europe/Rome", "Europe/Samara", "Europe/Saratov", "Europe/Simferopol", "Europe/Sofia", "Europe/Stockholm", "Europe/Tallinn", "Europe/Tirane", "Europe/Ulyanovsk", "Europe/Uzhgorod", "Europe/Vienna", "Europe/Vilnius", "Europe/Volgograd", "Europe/Warsaw", "Europe/Zaporozhye", "Europe/Zurich", "Indian/Chagos", "Indian/Christmas", "Indian/Cocos", "Indian/Kerguelen", "Indian/Mahe", "Indian/Maldives", "Indian/Mauritius", "Indian/Reunion", "Pacific/Apia", "Pacific/Auckland", "Pacific/Bougainville", "Pacific/Chatham", "Pacific/Chuuk", "Pacific/Easter", "Pacific/Efate", "Pacific/Enderbury", "Pacific/Fakaofo", "Pacific/Fiji", "Pacific/Funafuti", "Pacific/Galapagos", "Pacific/Gambier", "Pacific/Guadalcanal", "Pacific/Guam", "Pacific/Honolulu", "Pacific/Kiritimati", "Pacific/Kosrae", "Pacific/Kwajalein", "Pacific/Majuro", "Pacific/Marquesas", "Pacific/Nauru", "Pacific/Niue", "Pacific/Norfolk", "Pacific/Noumea", "Pacific/Pago_Pago", "Pacific/Palau", "Pacific/Pitcairn", "Pacific/Pohnpei", "Pacific/Port_Moresby", "Pacific/Rarotonga", "Pacific/Tarawa", "Pacific/Tongatapu", "Pacific/Wake", "Pacific/Wallis"];
-    static get TIMEZONE_LIST_VALUES(): import("zod").Values<["Africa/Abidjan", "Africa/Accra", "Africa/Algiers", "Africa/Bissau", "Africa/Cairo", "Africa/Casablanca", "Africa/Ceuta", "Africa/El_Aaiun", "Africa/Johannesburg", "Africa/Juba", "Africa/Khartoum", "Africa/Lagos", "Africa/Maputo", "Africa/Monrovia", "Africa/Nairobi", "Africa/Ndjamena", "Africa/Sao_Tome", "Africa/Tripoli", "Africa/Tunis", "Africa/Windhoek", "America/Adak", "America/Anchorage", "America/Araguaina", "America/Argentina/Buenos_Aires", "America/Argentina/Catamarca", "America/Argentina/Cordoba", "America/Argentina/Jujuy", "America/Argentina/La_Rioja", "America/Argentina/Mendoza", "America/Argentina/Rio_Gallegos", "America/Argentina/Salta", "America/Argentina/San_Juan", "America/Argentina/San_Luis", "America/Argentina/Tucuman", "America/Argentina/Ushuaia", "America/Asuncion", "America/Atikokan", "America/Bahia_Banderas", "America/Bahia", "America/Barbados", "America/Belem", "America/Belize", "America/Blanc-Sablon", "America/Boa_Vista", "America/Bogota", "America/Boise", "America/Cambridge_Bay", "America/Campo_Grande", "America/Cancun", "America/Caracas", "America/Cayenne", "America/Chicago", "America/Chihuahua", "America/Costa_Rica", "America/Creston", "America/Cuiaba", "America/Curacao", "America/Danmarkshavn", "America/Dawson_Creek", "America/Dawson", "America/Denver", "America/Detroit", "America/Edmonton", "America/Eirunepe", "America/El_Salvador", "America/Fort_Nelson", "America/Fortaleza", "America/Glace_Bay", "America/Goose_Bay", "America/Grand_Turk", "America/Guatemala", "America/Guayaquil", "America/Guyana", "America/Halifax", "America/Havana", "America/Hermosillo", "America/Indiana", "America/Inuvik", "America/Iqaluit", "America/Jamaica", "America/Juneau", "America/Kentucky", "America/La_Paz", "America/Lima", "America/Los_Angeles", "America/Maceio", "America/Managua", "America/Manaus", "America/Martinique", "America/Matamoros", "America/Mazatlan", "America/Menominee", "America/Merida", "America/Metlakatla", "America/Mexico_City", "America/Miquelon", "America/Moncton", "America/Monterrey", "America/Montevideo", "America/Nassau", "America/New_York", "America/Nipigon", "America/Nome", "America/Noronha", "America/North_Dakota", "America/Nuuk", "America/Ojinaga", "America/Panama", "America/Pangnirtung", "America/Paramaribo", "America/Phoenix", "America/Port_of_Spain", "America/Port-au-Prince", "America/Porto_Velho", "America/Puerto_Rico", "America/Punta_Arenas", "America/Rainy_River", "America/Rankin_Inlet", "America/Recife", "America/Regina", "America/Resolute", "America/Rio_Branco", "America/Santarem", "America/Santiago", "America/Santo_Domingo", "America/Sao_Paulo", "America/Scoresbysund", "America/Sitka", "America/St_Johns", "America/Swift_Current", "America/Tegucigalpa", "America/Thule", "America/Thunder_Bay", "America/Tijuana", "America/Toronto", "America/Vancouver", "America/Whitehorse", "America/Winnipeg", "America/Yakutat", "America/Yellowknife", "Antarctica/Casey", "Antarctica/Davis", "Antarctica/DumontDUrville", "Antarctica/Macquarie", "Antarctica/Mawson", "Antarctica/Palmer", "Antarctica/Rothera", "Antarctica/Syowa", "Antarctica/Troll", "Antarctica/Vostok", "Asia/Almaty", "Asia/Amman", "Asia/Anadyr", "Asia/Aqtau", "Asia/Aqtobe", "Asia/Ashgabat", "Asia/Atyrau", "Asia/Baghdad", "Asia/Baku", "Asia/Bangkok", "Asia/Barnaul", "Asia/Beirut", "Asia/Bishkek", "Asia/Brunei", "Asia/Chita", "Asia/Choibalsan", "Asia/Colombo", "Asia/Damascus", "Asia/Dhaka", "Asia/Dili", "Asia/Dubai", "Asia/Dushanbe", "Asia/Famagusta", "Asia/Gaza", "Asia/Hebron", "Asia/Ho_Chi_Minh", "Asia/Hong_Kong", "Asia/Hovd", "Asia/Irkutsk", "Asia/Jakarta", "Asia/Jayapura", "Asia/Jerusalem", "Asia/Kabul", "Asia/Kamchatka", "Asia/Karachi", "Asia/Kathmandu", "Asia/Khandyga", "Asia/Kolkata", "Asia/Krasnoyarsk", "Asia/Kuala_Lumpur", "Asia/Kuching", "Asia/Macau", "Asia/Magadan", "Asia/Makassar", "Asia/Manila", "Asia/Nicosia", "Asia/Novokuznetsk", "Asia/Novosibirsk", "Asia/Omsk", "Asia/Pontianak", "Asia/Pyongyang", "Asia/Qatar", "Asia/Qostanay", "Asia/Qyzylorda", "Asia/Riyadh", "Asia/Sakhalin", "Asia/Samarkand", "Asia/Seoul", "Asia/Shanghai", "Asia/Singapore", "Asia/Srednekolymsk", "Asia/Taipei", "Asia/Tashkent", "Asia/Tbilisi", "Asia/Tehran", "Asia/Thimphu", "Asia/Tokyo", "Asia/Tomsk", "Asia/Ulaanbaatar", "Asia/Urumqi", "Asia/Ust-Nera", "Asia/Vladivostok", "Asia/Yakutsk", "Asia/Yangon", "Asia/Yekaterinburg", "Asia/Yerevan", "Atlantic/Azores", "Atlantic/Bermuda", "Atlantic/Canary", "Atlantic/Cape_Verde", "Atlantic/Faroe", "Atlantic/Madeira", "Atlantic/Reykjavik", "Atlantic/South_Georgia", "Atlantic/Stanley", "Australia/Adelaide", "Australia/Brisbane", "Australia/Broken_Hill", "Australia/Darwin", "Australia/Eucla", "Australia/Hobart", "Australia/Lindeman", "Australia/Lord_Howe", "Australia/Melbourne", "Australia/Perth", "Australia/Sydney", "Europe/Amsterdam", "Europe/Andorra", "Europe/Astrakhan", "Europe/Athens", "Europe/Belgrade", "Europe/Berlin", "Europe/Brussels", "Europe/Bucharest", "Europe/Budapest", "Europe/Chisinau", "Europe/Copenhagen", "Europe/Dublin", "Europe/Gibraltar", "Europe/Helsinki", "Europe/Istanbul", "Europe/Kaliningrad", "Europe/Kiev", "Europe/Kirov", "Europe/Lisbon", "Europe/London", "Europe/Luxembourg", "Europe/Madrid", "Europe/Malta", "Europe/Minsk", "Europe/Monaco", "Europe/Moscow", "Europe/Paris", "Europe/Prague", "Europe/Riga", "Europe/Rome", "Europe/Samara", "Europe/Saratov", "Europe/Simferopol", "Europe/Sofia", "Europe/Stockholm", "Europe/Tallinn", "Europe/Tirane", "Europe/Ulyanovsk", "Europe/Uzhgorod", "Europe/Vienna", "Europe/Vilnius", "Europe/Volgograd", "Europe/Warsaw", "Europe/Zaporozhye", "Europe/Zurich", "Indian/Chagos", "Indian/Christmas", "Indian/Cocos", "Indian/Kerguelen", "Indian/Mahe", "Indian/Maldives", "Indian/Mauritius", "Indian/Reunion", "Pacific/Apia", "Pacific/Auckland", "Pacific/Bougainville", "Pacific/Chatham", "Pacific/Chuuk", "Pacific/Easter", "Pacific/Efate", "Pacific/Enderbury", "Pacific/Fakaofo", "Pacific/Fiji", "Pacific/Funafuti", "Pacific/Galapagos", "Pacific/Gambier", "Pacific/Guadalcanal", "Pacific/Guam", "Pacific/Honolulu", "Pacific/Kiritimati", "Pacific/Kosrae", "Pacific/Kwajalein", "Pacific/Majuro", "Pacific/Marquesas", "Pacific/Nauru", "Pacific/Niue", "Pacific/Norfolk", "Pacific/Noumea", "Pacific/Pago_Pago", "Pacific/Palau", "Pacific/Pitcairn", "Pacific/Pohnpei", "Pacific/Port_Moresby", "Pacific/Rarotonga", "Pacific/Tarawa", "Pacific/Tongatapu", "Pacific/Wake", "Pacific/Wallis"]>;
-    iso: null | string;
-    js_date: Date;
-    operational_date: OperationalDate;
-    std_window: {
-        end: UnixTimestamp;
-        start: UnixTimestamp;
-    };
-    unix_timestamp: UnixTimestamp;
-    constructor({ iso, js_date, operational_date, std_window, unix_timestamp }: DatesConstructor);
-    /**
-     * Creates a Dates object from a date/time string in a specific format.
-     * @param text The date/time string to parse.
-     * @param format The format string to use for parsing the date/time.
-     *   See Luxon documentation for format tokens: https://moment.github.io/luxon/#/formatting?id=table-of-tokens
-     * @param timezone The timezone to set for the Dates object.
-     * @returns A new Dates object parsed from the string.
-     */
-    static fromFormat(text: string, format: string, timezone: 'local' | 'utc' | TimezoneIdentified): Dates;
-    /**
-     * Creates a Dates object from an ISO 8601 date/time string.
-     * This method assumes the string has a timezone offset.
-     * @param isoText The ISO 8601 date/time string to parse.
-     * @returns A new Dates object created from the ISO string.
-     */
-    static fromISO(isoText: string): Dates;
-    /**
-     * Creates a Dates object from a JavaScript Date object.
-     * @param date The JavaScript Date object to convert. It is assumed that the date is in UTC.
-     * @returns A new Dates object created from the JavaScript Date.
-     */
-    static fromJSDate(date: Date): Dates;
-    /**
-     * Creates a Dates object from an operational date string in 'yyyyMMdd' format.
-     * @param date The operational date string in 'yyyyMMdd' format or an OperationalDate object.
-     * @param timezone The timezone to set for the Dates object.
-     * @returns A new Dates object created from the operational date.
-     */
-    static fromOperationalDate(date: OperationalDate | string, timezone: 'local' | 'utc' | TimezoneIdentified): Dates;
-    /**
-     * Creates a Dates object from Unix epoch seconds
-     * @param seconds The number of seconds since Unix epoch
-     * @returns A new Dates object created from the seconds timestamp
-     */
-    static fromSeconds(seconds: number): Dates;
-    /**
-     * Creates a Dates object from Unix epoch in milliseconds.
-     * @param millis The number of milliseconds since Unix epoch. Unix timestamp is always in UTC.
-     * @returns A new Dates object created from the milliseconds timestamp.
-     */
-    static fromUnixTimestamp(millis: number | UnixTimestamp): Dates;
-    /**
-     * Creates a Dates object with the current date and time.
-     * @param timezone The timezone to set for the Dates object.
-     * @returns A new Dates object with the current date and time in the specified timezone.
-     */
-    static now(timezone: 'local' | 'utc' | TimezoneIdentified): Dates;
-    /**
-     * Returns a new Dates object with the end of the specified unit.
-     * @param unit The unit to set the end of, e.g., 'day', 'month', 'year', etc.
-     * @returns A new Dates object with the end of the specified unit.
-     */
-    endOf(unit: DateTimeUnit): Dates;
-    /**
-     * Returns a new Dates object with the current date and time minus a duration.
-     * @param duration The duration to subtract
-     * @returns A new Dates object with the current date and time minus a duration
-     */
-    minus(duration: DurationObjectUnits): Dates;
-    /**
-     * Returns a new Dates object with the current date and time plus a duration
-     * @param duration The duration to add
-     * @returns A new Dates object with the current date and time plus a duration
-     */
-    plus(duration: DurationObjectUnits): Dates;
-    /**
-     * Sets the date and time for the Dates object.
-     * @param dateOrTime The date or time to set, can be an object with DateObjectUnits or a string in ISO format.
-     * @returns The Dates object
-     */
-    set(dateOrTime: DateObjectUnits): Dates;
-    /**
-     * Sets the timezone for the Dates object.
-     * @param timezone The timezone to set in the format of an IANA timezone.
-     * @param method The method to use for updating the timezone information.
-     *   - `offset_only` Updates only offset setting to the new timezone. The ISO string will show adjusted time components (hour, minutes, etc.) to their equivalent in the new timezone. The UTC value in milliseconds stays the same. The timestamp is the source of truth.
-     *   - `rebase_utc` Keeps the individual time components (hour, minutes, etc.) and updates the internal UTC value in milliseconds to reflect the change. The ISO string will show the same time components as before, but the UTC value in milliseconds will be adjusted to match the new timezone. The ISO string is the source of truth.
-     * @returns The Dates object
-     */
-    setZone(timezone: TimezoneIdentified, method: 'offset_only' | 'rebase_utc'): Dates;
-    /**
-     * Returns a new Dates object with the start of the specified unit.
-     * @param unit The unit to set the start of, e.g., 'day', 'month', 'year', etc.
-     * @returns A new Dates object with the start of the specified unit.
-     */
-    startOf(unit: DateTimeUnit): Dates;
-    /**
-     * Returns the time remaining until a given unix_timestamp (in ms) from now,
-     * as an object with minutes, hours, and days (all as floats, not rounded).
-     * @param unixTimestamp The target timestamp in milliseconds
-     * @returns { minutes: number, hours: number, days: number }
-     */
-    timeUntil(unixTimestamp: UnixTimestamp): {
-        days: number;
-        hours: number;
-        minutes: number;
-    };
-    /**
-     * Returns a human-readable, localized string for the time remaining until a given unix_timestamp (in ms) from now.
-     * @param unixTimestamp The target timestamp in milliseconds
-     * @param locale Optional locale string (e.g., 'en', 'pt')
-     * @returns A localized string like "2 days, 3 hours, 15 minutes"
-     */
-    timeUntilLocaleString(unixTimestamp: UnixTimestamp, locale?: 'en' | 'pt'): string;
-    /**
-     * Returns the date as a string in the specified format.
-     * @param format The format string (see Luxon tokens documentation)
-     * @returns The date as a string in the specified format
-     */
-    toFormat(format: string): string;
-    /**
-     * Returns the date as a string in the specified format.
-     * @param format The format string (see Luxon tokens documentation)
-     * @returns The date as a string in the specified format
-     */
-    toLocaleString(format: DatesFormat, locale?: string): string;
-    /**
-     * Returns the operational date based on the provided timestamp and format.
-     * @param timestamp - The timestamp to be parsed.
-     * @returns The operational date in the yyyyLLdd format.
-     */
-    private getOperationalDate;
-    /**
-     * This function returns the start and end of the standard window interval for a given timestamp.
-     * The standard window interval is the period in which is possible to receive data for a given ride.
-     * Currently, the standard window starts 10 hours before and ends 10 hours after the scheduled ride start.
-     * @param isoDate The ISO date string to calculate the standard window interval.
-     * @returns An object containing the start and end of the standard window interval.
-     */
-    private getStandardWindowInterval;
-}
-export {};

package/dist/src/dates/dates.js

@@ -1,385 +0,0 @@
-/* * */
-import { Formats, OPERATIONAL_DATE_FORMAT } from './format.js';
-import { timezoneList, timezoneListSchema } from './types.js';
-import { DateTime } from 'luxon';
-/* * */
-export class Dates {
-    //
-    //
-    // Static properties
-    static STANDARD_WINDOW_HOURS = 10;
-    static get FORMATS() { return Formats; }
-    static get TIMEZONE_LIST() { return timezoneList; }
-    static get TIMEZONE_LIST_VALUES() { return timezoneListSchema.Values; }
-    //
-    // Instance properties
-    iso;
-    js_date;
-    operational_date;
-    std_window;
-    unix_timestamp;
-    //
-    // Constructor
-    constructor({ iso, js_date, operational_date, std_window, unix_timestamp }) {
-        this.iso = iso ?? null;
-        this.js_date = js_date;
-        this.operational_date = operational_date;
-        this.std_window = std_window;
-        this.unix_timestamp = unix_timestamp;
-    }
-    //
-    // Static methods
-    /**
-     * Creates a Dates object from a date/time string in a specific format.
-     * @param text The date/time string to parse.
-     * @param format The format string to use for parsing the date/time.
-     *   See Luxon documentation for format tokens: https://moment.github.io/luxon/#/formatting?id=table-of-tokens
-     * @param timezone The timezone to set for the Dates object.
-     * @returns A new Dates object parsed from the string.
-     */
-    static fromFormat(text, format, timezone) {
-        const dateTime = DateTime
-            .fromFormat(text, format, { setZone: true })
-            .setZone(timezone, { keepLocalTime: true });
-        return new Dates({
-            iso: dateTime.toISO(),
-            js_date: dateTime.toJSDate(),
-            operational_date: this.prototype.getOperationalDate(dateTime.toISO()),
-            std_window: this.prototype.getStandardWindowInterval(dateTime.toISO()),
-            unix_timestamp: dateTime.toMillis(),
-        });
-    }
-    /**
-     * Creates a Dates object from an ISO 8601 date/time string.
-     * This method assumes the string has a timezone offset.
-     * @param isoText The ISO 8601 date/time string to parse.
-     * @returns A new Dates object created from the ISO string.
-     */
-    static fromISO(isoText) {
-        const dateTime = DateTime.fromISO(isoText, { setZone: true });
-        return new Dates({
-            iso: dateTime.toISO(),
-            js_date: dateTime.toJSDate(),
-            operational_date: this.prototype.getOperationalDate(dateTime.toISO()),
-            std_window: this.prototype.getStandardWindowInterval(dateTime.toISO()),
-            unix_timestamp: dateTime.toMillis(),
-        });
-    }
-    /**
-     * Creates a Dates object from a JavaScript Date object.
-     * @param date The JavaScript Date object to convert. It is assumed that the date is in UTC.
-     * @returns A new Dates object created from the JavaScript Date.
-     */
-    static fromJSDate(date) {
-        const dateTime = DateTime
-            .fromJSDate(date)
-            .setZone('utc', { keepLocalTime: false });
-        return new Dates({
-            iso: dateTime.toISO(),
-            js_date: dateTime.toJSDate(),
-            operational_date: this.prototype.getOperationalDate(dateTime.toISO()),
-            std_window: this.prototype.getStandardWindowInterval(dateTime.toISO()),
-            unix_timestamp: dateTime.toMillis(),
-        });
-    }
-    /**
-     * Creates a Dates object from an operational date string in 'yyyyMMdd' format.
-     * @param date The operational date string in 'yyyyMMdd' format or an OperationalDate object.
-     * @param timezone The timezone to set for the Dates object.
-     * @returns A new Dates object created from the operational date.
-     */
-    static fromOperationalDate(date, timezone) {
-        const dateTime = DateTime
-            .fromFormat(date, OPERATIONAL_DATE_FORMAT)
-            .setZone(timezone, { keepLocalTime: true })
-            .set({ hour: 4, millisecond: 0, minute: 0, second: 0 }); // Start of the operational date
-        return new Dates({
-            iso: dateTime.toISO(),
-            js_date: dateTime.toJSDate(),
-            operational_date: this.prototype.getOperationalDate(dateTime.toISO()),
-            std_window: this.prototype.getStandardWindowInterval(dateTime.toISO()),
-            unix_timestamp: dateTime.toMillis(),
-        });
-    }
-    /**
-     * Creates a Dates object from Unix epoch seconds
-     * @param seconds The number of seconds since Unix epoch
-     * @returns A new Dates object created from the seconds timestamp
-     */
-    static fromSeconds(seconds) {
-        const dateTime = DateTime
-            .fromSeconds(seconds)
-            .setZone('utc', { keepLocalTime: false });
-        return new Dates({
-            iso: dateTime.toISO(),
-            js_date: dateTime.toJSDate(),
-            operational_date: this.prototype.getOperationalDate(dateTime.toISO()),
-            std_window: this.prototype.getStandardWindowInterval(dateTime.toISO()),
-            unix_timestamp: dateTime.toMillis(),
-        });
-    }
-    /**
-     * Creates a Dates object from Unix epoch in milliseconds.
-     * @param millis The number of milliseconds since Unix epoch. Unix timestamp is always in UTC.
-     * @returns A new Dates object created from the milliseconds timestamp.
-     */
-    static fromUnixTimestamp(millis) {
-        const dateTime = DateTime
-            .fromMillis(millis)
-            .setZone('utc', { keepLocalTime: false });
-        return new Dates({
-            iso: dateTime.toISO(),
-            js_date: dateTime.toJSDate(),
-            operational_date: this.prototype.getOperationalDate(dateTime.toISO()),
-            std_window: this.prototype.getStandardWindowInterval(dateTime.toISO()),
-            unix_timestamp: dateTime.toMillis(),
-        });
-    }
-    /**
-     * Creates a Dates object with the current date and time.
-     * @param timezone The timezone to set for the Dates object.
-     * @returns A new Dates object with the current date and time in the specified timezone.
-     */
-    static now(timezone) {
-        const dateTime = DateTime
-            .now()
-            .setZone(timezone, { keepLocalTime: false });
-        return new Dates({
-            iso: dateTime.toISO(),
-            js_date: dateTime.toJSDate(),
-            operational_date: this.prototype.getOperationalDate(dateTime.toISO()),
-            std_window: this.prototype.getStandardWindowInterval(dateTime.toISO()),
-            unix_timestamp: dateTime.toMillis(),
-        });
-    }
-    /**
-     * Returns a new Dates object with the end of the specified unit.
-     * @param unit The unit to set the end of, e.g., 'day', 'month', 'year', etc.
-     * @returns A new Dates object with the end of the specified unit.
-     */
-    endOf(unit) {
-        if (!this.iso)
-            throw new Error('ISO date is not set.');
-        const dateTime = DateTime
-            .fromISO(this.iso, { setZone: true })
-            .endOf(unit);
-        return new Dates({
-            iso: dateTime.toISO(),
-            js_date: dateTime.toJSDate(),
-            operational_date: this.getOperationalDate(dateTime.toISO()),
-            std_window: this.getStandardWindowInterval(dateTime.toISO()),
-            unix_timestamp: dateTime.toMillis(),
-        });
-    }
-    /**
-     * Returns a new Dates object with the current date and time minus a duration.
-     * @param duration The duration to subtract
-     * @returns A new Dates object with the current date and time minus a duration
-     */
-    minus(duration) {
-        if (!this.iso)
-            throw new Error('ISO date is not set.');
-        const dateTime = DateTime
-            .fromISO(this.iso, { setZone: true })
-            .minus(duration);
-        return new Dates({
-            iso: dateTime.toISO(),
-            js_date: dateTime.toJSDate(),
-            operational_date: this.getOperationalDate(dateTime.toISO()),
-            std_window: this.getStandardWindowInterval(dateTime.toISO()),
-            unix_timestamp: dateTime.toMillis(),
-        });
-    }
-    /**
-     * Returns a new Dates object with the current date and time plus a duration
-     * @param duration The duration to add
-     * @returns A new Dates object with the current date and time plus a duration
-     */
-    plus(duration) {
-        if (!this.iso)
-            throw new Error('ISO date is not set.');
-        const dateTime = DateTime
-            .fromISO(this.iso, { setZone: true })
-            .plus(duration);
-        return new Dates({
-            iso: dateTime.toISO(),
-            js_date: dateTime.toJSDate(),
-            operational_date: this.getOperationalDate(dateTime.toISO()),
-            std_window: this.getStandardWindowInterval(dateTime.toISO()),
-            unix_timestamp: dateTime.toMillis(),
-        });
-    }
-    /**
-     * Sets the date and time for the Dates object.
-     * @param dateOrTime The date or time to set, can be an object with DateObjectUnits or a string in ISO format.
-     * @returns The Dates object
-     */
-    set(dateOrTime) {
-        if (!this.iso)
-            throw new Error('ISO date is not set.');
-        const dateTime = DateTime
-            .fromISO(this.iso, { setZone: true })
-            .set(dateOrTime);
-        return new Dates({
-            iso: dateTime.toISO(),
-            js_date: dateTime.toJSDate(),
-            operational_date: this.getOperationalDate(dateTime.toISO()),
-            std_window: this.getStandardWindowInterval(dateTime.toISO()),
-            unix_timestamp: dateTime.toMillis(),
-        });
-    }
-    /**
-     * Sets the timezone for the Dates object.
-     * @param timezone The timezone to set in the format of an IANA timezone.
-     * @param method The method to use for updating the timezone information.
-     *   - `offset_only` Updates only offset setting to the new timezone. The ISO string will show adjusted time components (hour, minutes, etc.) to their equivalent in the new timezone. The UTC value in milliseconds stays the same. The timestamp is the source of truth.
-     *   - `rebase_utc` Keeps the individual time components (hour, minutes, etc.) and updates the internal UTC value in milliseconds to reflect the change. The ISO string will show the same time components as before, but the UTC value in milliseconds will be adjusted to match the new timezone. The ISO string is the source of truth.
-     * @returns The Dates object
-     */
-    setZone(timezone, method) {
-        if (!this.iso)
-            throw new Error('ISO date is not set.');
-        const dateTime = DateTime
-            .fromISO(this.iso, { setZone: true })
-            .setZone(timezone, { keepLocalTime: method === 'rebase_utc' });
-        return new Dates({
-            iso: dateTime.toISO(),
-            js_date: dateTime.toJSDate(),
-            operational_date: this.getOperationalDate(dateTime.toISO()),
-            std_window: this.getStandardWindowInterval(dateTime.toISO()),
-            unix_timestamp: dateTime.toMillis(),
-        });
-    }
-    /**
-     * Returns a new Dates object with the start of the specified unit.
-     * @param unit The unit to set the start of, e.g., 'day', 'month', 'year', etc.
-     * @returns A new Dates object with the start of the specified unit.
-     */
-    startOf(unit) {
-        if (!this.iso)
-            throw new Error('ISO date is not set.');
-        const dateTime = DateTime
-            .fromISO(this.iso, { setZone: true })
-            .startOf(unit);
-        return new Dates({
-            iso: dateTime.toISO(),
-            js_date: dateTime.toJSDate(),
-            operational_date: this.getOperationalDate(dateTime.toISO()),
-            std_window: this.getStandardWindowInterval(dateTime.toISO()),
-            unix_timestamp: dateTime.toMillis(),
-        });
-    }
-    /**
-     * Returns the time remaining until a given unix_timestamp (in ms) from now,
-     * as an object with minutes, hours, and days (all as floats, not rounded).
-     * @param unixTimestamp The target timestamp in milliseconds
-     * @returns { minutes: number, hours: number, days: number }
-     */
-    timeUntil(unixTimestamp) {
-        const now = Date.now();
-        const diffMs = unixTimestamp - now;
-        const minutes = diffMs / (1000 * 60);
-        const hours = diffMs / (1000 * 60 * 60);
-        const days = diffMs / (1000 * 60 * 60 * 24);
-        return { days, hours, minutes };
-    }
-    /**
-     * Returns a human-readable, localized string for the time remaining until a given unix_timestamp (in ms) from now.
-     * @param unixTimestamp The target timestamp in milliseconds
-     * @param locale Optional locale string (e.g., 'en', 'pt')
-     * @returns A localized string like "2 days, 3 hours, 15 minutes"
-     */
-    timeUntilLocaleString(unixTimestamp, locale = 'pt') {
-        const now = Date.now();
-        const diffMs = unixTimestamp - now;
-        const parts = [];
-        if (diffMs < 60 * 1000) {
-            return locale === 'en' ? 'Arriving' : 'A Chegar';
-        }
-        const totalMinutes = Math.round(diffMs / (1000 * 60));
-        const days = Math.floor(totalMinutes / (60 * 24));
-        const hours = Math.floor((totalMinutes % (60 * 24)) / 60);
-        const minutes = totalMinutes % 60;
-        if (days > 0) {
-            parts.push(`${days} ${days === 1 ? locale === 'en' ? 'day' : 'dia' : locale === 'en' ? 'days' : 'dias'}`);
-        }
-        if (hours > 0) {
-            parts.push(`${hours} ${hours === 1 ? locale === 'en' ? 'hour' : 'hora' : locale === 'en' ? 'hours' : 'horas'}`);
-        }
-        if (minutes > 0 || parts.length === 0) {
-            parts.push(`${minutes} ${minutes === 1 ? locale === 'en' ? 'minute' : 'minuto' : locale === 'en' ? 'minutes' : 'minutos'}`);
-        }
-        return parts.join(', ');
-    }
-    /**
-     * Returns the date as a string in the specified format.
-     * @param format The format string (see Luxon tokens documentation)
-     * @returns The date as a string in the specified format
-     */
-    toFormat(format) {
-        if (!this.iso)
-            throw new Error('ISO date is not set.');
-        const dateTime = DateTime.fromISO(this.iso, { setZone: true });
-        return dateTime.toFormat(format);
-    }
-    /**
-     * Returns the date as a string in the specified format.
-     * @param format The format string (see Luxon tokens documentation)
-     * @returns The date as a string in the specified format
-     */
-    toLocaleString(format, locale) {
-        if (!this.iso)
-            throw new Error('ISO date is not set.');
-        const dateTime = DateTime.fromISO(this.iso, { setZone: true });
-        if (locale)
-            dateTime.setLocale(locale);
-        return dateTime.toLocaleString(format, { locale: locale });
-    }
-    //
-    // Private methods
-    /**
-     * Returns the operational date based on the provided timestamp and format.
-     * @param timestamp - The timestamp to be parsed.
-     * @returns The operational date in the yyyyLLdd format.
-     */
-    getOperationalDate(isoDate) {
-        if (!isoDate)
-            throw new Error('ISO date is not set.');
-        //
-        // Get the date object
-        const dateObject = DateTime.fromISO(isoDate, { setZone: true });
-        //
-        // Check if the time is between 00:00 and 03:59.
-        // The operational date is between 04:00 and 03:59 of the following day.
-        let operational_date;
-        if (dateObject.hour < 4) {
-            // If true, return the previous day in the yyyyLLdd format
-            const previousDay = dateObject.minus({ days: 1 });
-            operational_date = previousDay.toFormat(OPERATIONAL_DATE_FORMAT);
-        }
-        else {
-            // Else, return the current day in the yyyyLLdd format
-            operational_date = dateObject.toFormat(OPERATIONAL_DATE_FORMAT);
-        }
-        //
-        // Validate the operational date and return it
-        return operational_date;
-        //
-    }
-    /**
-     * This function returns the start and end of the standard window interval for a given timestamp.
-     * The standard window interval is the period in which is possible to receive data for a given ride.
-     * Currently, the standard window starts 10 hours before and ends 10 hours after the scheduled ride start.
-     * @param isoDate The ISO date string to calculate the standard window interval.
-     * @returns An object containing the start and end of the standard window interval.
-     */
-    getStandardWindowInterval(isoDate) {
-        if (!isoDate)
-            throw new Error('ISO date is not set.');
-        const dateTime = DateTime.fromISO(isoDate, { setZone: true });
-        return {
-            end: dateTime.plus({ hours: Dates.STANDARD_WINDOW_HOURS }).toMillis(),
-            start: dateTime.minus({ hours: Dates.STANDARD_WINDOW_HOURS }).toMillis(),
-        };
-    }
-}

package/dist/src/dates/format.d.ts

@@ -1,27 +0,0 @@
-export interface DatesFormat {
-    day?: '2-digit' | 'numeric';
-    hour?: '2-digit' | 'numeric';
-    minute?: '2-digit' | 'numeric';
-    month?: '2-digit' | 'long' | 'numeric' | 'short';
-    second?: '2-digit' | 'numeric';
-    timeZoneName?: 'long' | 'short';
-    weekday?: 'long' | 'narrow' | 'short';
-    year?: '2-digit' | 'numeric';
-}
-export declare const OPERATIONAL_DATE_FORMAT = "yyyyMMdd";
-export declare const Formats: {
-    DATE_FULL: DatesFormat;
-    DATE_FULL_WITH_YEAR: DatesFormat;
-    DATE_HUGE: DatesFormat;
-    DATE_MEDIUM: DatesFormat;
-    DATE_SHORT: DatesFormat;
-    DATETIME_FULL: DatesFormat;
-    DATETIME_FULL_WITH_SECONDS: DatesFormat;
-    DATETIME_MEDIUM: DatesFormat;
-    DATETIME_MEDIUM_WITH_SECONDS: DatesFormat;
-    DATETIME_SHORT: DatesFormat;
-    DATETIME_SHORT_WITH_SECONDS: DatesFormat;
-    OPERATIONAL_DATE_FORMAT: string;
-    TIME_SIMPLE: DatesFormat;
-    TIME_WITH_SECONDS: DatesFormat;
-};