@venizia/ignis-helpers 0.2.0-39 → 0.2.0-40

package/dist/cjs/modules/temporal/adapters/native.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NativeTemporalAdapter = void 0;
+const http_1 = require("../../../common/constants/http");
+const error_1 = require("../../error");
+const guards_1 = require("./guards");
+const NANOSECONDS_PER_MILLISECOND = 1_000_000;
+/**
+ * Time zones through the TC39 `Temporal` API: the runtime's global (Bun has it, as do current
+ * browsers), or a polyfill's namespace passed as `temporal`.
+ */
+class NativeTemporalAdapter {
+    constructor(opts) {
+        const temporal = opts?.temporal ?? Reflect.get(globalThis, 'Temporal');
+        if (!(0, guards_1.isTemporalNamespace)(temporal)) {
+            throw (0, error_1.getError)({
+                statusCode: http_1.HTTP.ResultCodes.RS_5.InternalServerError,
+                message: '[NativeTemporalAdapter] Temporal is not available on this runtime | Pass a polyfill as `temporal`, or use DayjsTemporalAdapter / LuxonTemporalAdapter',
+            });
+        }
+        this.temporal = temporal;
+    }
+    getOffsetMilliseconds(opts) {
+        const { value, timeZone } = opts;
+        try {
+            const zoned = this.temporal.Instant.fromEpochMilliseconds(value.getTime()).toZonedDateTimeISO(timeZone);
+            return zoned.offsetNanoseconds / NANOSECONDS_PER_MILLISECOND;
+        }
+        catch (error) {
+            throw (0, error_1.getError)({
+                statusCode: http_1.HTTP.ResultCodes.RS_4.BadRequest,
+                message: `[NativeTemporalAdapter] no offset for ${timeZone} at ${value.getTime()} | ${error instanceof Error ? error.message : String(error)}`,
+            });
+        }
+    }
+}
+exports.NativeTemporalAdapter = NativeTemporalAdapter;
+//# sourceMappingURL=native.js.map

package/dist/cjs/modules/temporal/adapters/native.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.js","sourceRoot":"","sources":["../../../../../src/modules/temporal/adapters/native.ts"],"names":[],"mappings":";;;AAAA,kDAA+C;AAC/C,2CAA2C;AAE3C,qCAA+C;AAE/C,MAAM,2BAA2B,GAAG,SAAS,CAAC;AAE9C;;;GAGG;AACH,MAAa,qBAAqB;IAGhC,YAAY,IAAwC;QAClD,MAAM,QAAQ,GAAY,IAAI,EAAE,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QAEhF,IAAI,CAAC,IAAA,4BAAmB,EAAC,QAAQ,CAAC,EAAE,CAAC;YACnC,MAAM,IAAA,gBAAQ,EAAC;gBACb,UAAU,EAAE,WAAI,CAAC,WAAW,CAAC,IAAI,CAAC,mBAAmB;gBACrD,OAAO,EACL,uJAAuJ;aAC1J,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,qBAAqB,CAAC,IAAuC;QAC3D,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QAEjC,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,qBAAqB,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,kBAAkB,CAC3F,QAAQ,CACT,CAAC;YACF,OAAO,KAAK,CAAC,iBAAiB,GAAG,2BAA2B,CAAC;QAC/D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAA,gBAAQ,EAAC;gBACb,UAAU,EAAE,WAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU;gBAC5C,OAAO,EAAE,yCAAyC,QAAQ,OAAO,KAAK,CAAC,OAAO,EAAE,MAAM,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;aAC/I,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF;AAhCD,sDAgCC"}

package/dist/cjs/modules/temporal/calendar.d.ts

@@ -0,0 +1,52 @@
+import type { TTemporalUnit } from './common/constants';
+import type { ITemporalParts, IZonedTemporalParts } from './common/types';
+/** The years a four-digit `YYYY` spells - the range every method reads and writes. */
+export declare const MIN_TEMPORAL_YEAR = 1;
+export declare const MAX_TEMPORAL_YEAR = 9999;
+export declare const isSupportedYear: (year: number) => boolean;
+export declare const daysInMonth: (opts: {
+    year: number;
+    month: number;
+}) => number;
+/** `parts` moved by whole days on the calendar, wall time untouched. */
+export declare const shiftDays: (opts: {
+    parts: ITemporalParts;
+    days: number;
+}) => ITemporalParts;
+/** `parts` moved by whole months, the day clamped to the target month: Jan 31 + 1 month is Feb 28. */
+export declare const shiftMonths: (opts: {
+    parts: ITemporalParts;
+    months: number;
+}) => ITemporalParts;
+/** Whether the fields name a day and a time the calendar has - Feb 30, 24:00 and year 0 do not. */
+export declare const isRealDateTime: (opts: {
+    parts: ITemporalParts;
+}) => boolean;
+/** Epoch milliseconds of wall-clock fields read at a fixed offset. */
+export declare const epochAtOffset: (opts: {
+    parts: ITemporalParts;
+    offsetMilliseconds: number;
+}) => number;
+/** The wall clock an instant shows at a fixed offset - pure arithmetic, never the host's zone. */
+export declare const wallClockAt: (opts: {
+    epoch: number;
+    offsetMilliseconds: number;
+}) => IZonedTemporalParts;
+/** Units that measure elapsed time rather than the calendar - 24 hours is not always a day. */
+export declare const EXACT_UNIT_MILLISECONDS: Partial<Record<TTemporalUnit, number>>;
+/** The wall-clock fields alone, without the weekday and the offset. */
+export declare const wallClockOf: (opts: {
+    parts: ITemporalParts;
+}) => ITemporalParts;
+/** The wall-clock start of the unit holding `parts`. Weeks start on Monday. */
+export declare const truncateTo: (opts: {
+    parts: IZonedTemporalParts;
+    unit: TTemporalUnit;
+}) => ITemporalParts;
+/** `parts` moved by whole units on the wall clock - no time zone involved. */
+export declare const shiftWallClock: (opts: {
+    parts: ITemporalParts;
+    amount: number;
+    unit: TTemporalUnit;
+}) => ITemporalParts;
+//# sourceMappingURL=calendar.d.ts.map

package/dist/cjs/modules/temporal/calendar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.d.ts","sourceRoot":"","sources":["../../../../src/modules/temporal/calendar.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1E,sFAAsF;AACtF,eAAO,MAAM,iBAAiB,IAAI,CAAC;AACnC,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAWtC,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,KAAG,OACS,CAAC;AAEzD,eAAO,MAAM,WAAW,GAAI,MAAM;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,KAAG,MACW,CAAC;AAEhF,wEAAwE;AACxE,eAAO,MAAM,SAAS,GAAI,MAAM;IAAE,KAAK,EAAE,cAAc,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,KAAG,cAUzE,CAAC;AAEF,sGAAsG;AACtG,eAAO,MAAM,WAAW,GAAI,MAAM;IAAE,KAAK,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,KAAG,cAO7E,CAAC;AAEF,mGAAmG;AACnG,eAAO,MAAM,cAAc,GAAI,MAAM;IAAE,KAAK,EAAE,cAAc,CAAA;CAAE,KAAG,OAkBhE,CAAC;AAEF,sEAAsE;AACtE,eAAO,MAAM,aAAa,GAAI,MAAM;IAClC,KAAK,EAAE,cAAc,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;CAC5B,KAAG,MAKH,CAAC;AAEF,kGAAkG;AAClG,eAAO,MAAM,WAAW,GAAI,MAAM;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB,EAAE,MAAM,CAAC;CAC5B,KAAG,mBAgBH,CAAC;AAEF,+FAA+F;AAC/F,eAAO,MAAM,uBAAuB,EAAE,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAK1E,CAAC;AAEF,uEAAuE;AACvE,eAAO,MAAM,WAAW,GAAI,MAAM;IAAE,KAAK,EAAE,cAAc,CAAA;CAAE,KAAG,cAG7D,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,UAAU,GAAI,MAAM;IAC/B,KAAK,EAAE,mBAAmB,CAAC;IAC3B,IAAI,EAAE,aAAa,CAAC;CACrB,KAAG,cA4BH,CAAC;AAEF,8EAA8E;AAC9E,eAAO,MAAM,cAAc,GAAI,MAAM;IACnC,KAAK,EAAE,cAAc,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,aAAa,CAAC;CACrB,KAAG,cAsBH,CAAC"}

package/dist/cjs/modules/temporal/calendar.js

@@ -0,0 +1,151 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shiftWallClock = exports.truncateTo = exports.wallClockOf = exports.EXACT_UNIT_MILLISECONDS = exports.wallClockAt = exports.epochAtOffset = exports.isRealDateTime = exports.shiftMonths = exports.shiftDays = exports.daysInMonth = exports.isSupportedYear = exports.MAX_TEMPORAL_YEAR = exports.MIN_TEMPORAL_YEAR = void 0;
+const constants_1 = require("./common/constants");
+/** The years a four-digit `YYYY` spells - the range every method reads and writes. */
+exports.MIN_TEMPORAL_YEAR = 1;
+exports.MAX_TEMPORAL_YEAR = 9999;
+const MILLISECONDS_PER_MINUTE = 60_000;
+/** A UTC scratch date for calendar math - `Date.UTC` maps years 0-99 onto 1900-1999, `setUTCFullYear` does not. */
+const calendarDate = (opts) => {
+    const date = new Date(0);
+    date.setUTCFullYear(opts.year, opts.month - 1, opts.day);
+    return date;
+};
+const isSupportedYear = (year) => year >= exports.MIN_TEMPORAL_YEAR && year <= exports.MAX_TEMPORAL_YEAR;
+exports.isSupportedYear = isSupportedYear;
+const daysInMonth = (opts) => calendarDate({ year: opts.year, month: opts.month + 1, day: 0 }).getUTCDate();
+exports.daysInMonth = daysInMonth;
+/** `parts` moved by whole days on the calendar, wall time untouched. */
+const shiftDays = (opts) => {
+    const { parts, days } = opts;
+    const date = calendarDate({ year: parts.year, month: parts.month, day: parts.day + days });
+    return {
+        ...parts,
+        year: date.getUTCFullYear(),
+        month: date.getUTCMonth() + 1,
+        day: date.getUTCDate(),
+    };
+};
+exports.shiftDays = shiftDays;
+/** `parts` moved by whole months, the day clamped to the target month: Jan 31 + 1 month is Feb 28. */
+const shiftMonths = (opts) => {
+    const { parts, months } = opts;
+    const total = parts.year * 12 + (parts.month - 1) + months;
+    const year = Math.floor(total / 12);
+    const month = total - year * 12 + 1;
+    return { ...parts, year, month, day: Math.min(parts.day, (0, exports.daysInMonth)({ year, month })) };
+};
+exports.shiftMonths = shiftMonths;
+/** Whether the fields name a day and a time the calendar has - Feb 30, 24:00 and year 0 do not. */
+const isRealDateTime = (opts) => {
+    const { year, month, day, hour, minute, second, millisecond } = opts.parts;
+    return ((0, exports.isSupportedYear)(year) &&
+        month >= 1 &&
+        month <= 12 &&
+        day >= 1 &&
+        day <= (0, exports.daysInMonth)({ year, month }) &&
+        hour >= 0 &&
+        hour <= 23 &&
+        minute >= 0 &&
+        minute <= 59 &&
+        second >= 0 &&
+        second <= 59 &&
+        millisecond >= 0 &&
+        millisecond <= 999);
+};
+exports.isRealDateTime = isRealDateTime;
+/** Epoch milliseconds of wall-clock fields read at a fixed offset. */
+const epochAtOffset = (opts) => {
+    const { parts, offsetMilliseconds } = opts;
+    const date = calendarDate({ year: parts.year, month: parts.month, day: parts.day });
+    date.setUTCHours(parts.hour, parts.minute, parts.second, parts.millisecond);
+    return date.getTime() - offsetMilliseconds;
+};
+exports.epochAtOffset = epochAtOffset;
+/** The wall clock an instant shows at a fixed offset - pure arithmetic, never the host's zone. */
+const wallClockAt = (opts) => {
+    const { epoch, offsetMilliseconds } = opts;
+    const date = new Date(epoch + offsetMilliseconds);
+    return {
+        year: date.getUTCFullYear(),
+        month: date.getUTCMonth() + 1,
+        day: date.getUTCDate(),
+        hour: date.getUTCHours(),
+        minute: date.getUTCMinutes(),
+        second: date.getUTCSeconds(),
+        millisecond: date.getUTCMilliseconds(),
+        // `getUTCDay` counts Sunday as 0; ISO counts Monday as 1 and Sunday as 7.
+        dayOfWeek: ((date.getUTCDay() + 6) % 7) + 1,
+        offsetMinutes: offsetMilliseconds / MILLISECONDS_PER_MINUTE,
+    };
+};
+exports.wallClockAt = wallClockAt;
+/** Units that measure elapsed time rather than the calendar - 24 hours is not always a day. */
+exports.EXACT_UNIT_MILLISECONDS = {
+    [constants_1.TemporalUnits.MILLISECOND]: 1,
+    [constants_1.TemporalUnits.SECOND]: 1_000,
+    [constants_1.TemporalUnits.MINUTE]: 60_000,
+    [constants_1.TemporalUnits.HOUR]: 3_600_000,
+};
+/** The wall-clock fields alone, without the weekday and the offset. */
+const wallClockOf = (opts) => {
+    const { year, month, day, hour, minute, second, millisecond } = opts.parts;
+    return { year, month, day, hour, minute, second, millisecond };
+};
+exports.wallClockOf = wallClockOf;
+/** The wall-clock start of the unit holding `parts`. Weeks start on Monday. */
+const truncateTo = (opts) => {
+    const { parts, unit } = opts;
+    const wall = (0, exports.wallClockOf)({ parts });
+    switch (unit) {
+        case constants_1.TemporalUnits.SECOND: {
+            return { ...wall, millisecond: 0 };
+        }
+        case constants_1.TemporalUnits.MINUTE: {
+            return { ...wall, second: 0, millisecond: 0 };
+        }
+        case constants_1.TemporalUnits.HOUR: {
+            return { ...wall, minute: 0, second: 0, millisecond: 0 };
+        }
+        case constants_1.TemporalUnits.DAY: {
+            return { ...wall, hour: 0, minute: 0, second: 0, millisecond: 0 };
+        }
+        case constants_1.TemporalUnits.WEEK: {
+            const midnight = { ...wall, hour: 0, minute: 0, second: 0, millisecond: 0 };
+            return (0, exports.shiftDays)({ parts: midnight, days: 1 - parts.dayOfWeek });
+        }
+        case constants_1.TemporalUnits.MONTH: {
+            return { ...wall, day: 1, hour: 0, minute: 0, second: 0, millisecond: 0 };
+        }
+        default: {
+            return { ...wall, month: 1, day: 1, hour: 0, minute: 0, second: 0, millisecond: 0 };
+        }
+    }
+};
+exports.truncateTo = truncateTo;
+/** `parts` moved by whole units on the wall clock - no time zone involved. */
+const shiftWallClock = (opts) => {
+    const { parts, amount, unit } = opts;
+    const exact = exports.EXACT_UNIT_MILLISECONDS[unit];
+    if (exact !== undefined) {
+        const epoch = (0, exports.epochAtOffset)({ parts, offsetMilliseconds: 0 }) + amount * exact;
+        return (0, exports.wallClockOf)({ parts: (0, exports.wallClockAt)({ epoch, offsetMilliseconds: 0 }) });
+    }
+    switch (unit) {
+        case constants_1.TemporalUnits.DAY: {
+            return (0, exports.shiftDays)({ parts, days: amount });
+        }
+        case constants_1.TemporalUnits.WEEK: {
+            return (0, exports.shiftDays)({ parts, days: amount * 7 });
+        }
+        case constants_1.TemporalUnits.MONTH: {
+            return (0, exports.shiftMonths)({ parts, months: amount });
+        }
+        default: {
+            return (0, exports.shiftMonths)({ parts, months: amount * 12 });
+        }
+    }
+};
+exports.shiftWallClock = shiftWallClock;
+//# sourceMappingURL=calendar.js.map

package/dist/cjs/modules/temporal/calendar.js.map

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

package/dist/cjs/modules/temporal/common/constants.d.ts

@@ -0,0 +1,20 @@
+import type { TConstValue } from '../../../common/types';
+/** Units `add`, `subtract`, `startOf` and `endOf` accept. Weeks are ISO weeks - they start on Monday. */
+export declare class TemporalUnits {
+    static readonly MILLISECOND = "millisecond";
+    static readonly SECOND = "second";
+    static readonly MINUTE = "minute";
+    static readonly HOUR = "hour";
+    static readonly DAY = "day";
+    static readonly WEEK = "week";
+    static readonly MONTH = "month";
+    static readonly YEAR = "year";
+    static readonly SCHEME_SET: Set<string>;
+    static isValid(input: string): input is TTemporalUnit;
+}
+export type TTemporalUnit = TConstValue<typeof TemporalUnits>;
+/** A helper built without a `timeZone` computes in UTC - never in the host's zone, which differs per machine. */
+export declare const DEFAULT_TEMPORAL_TIME_ZONE = "UTC";
+/** `format` with no pattern writes ISO 8601 with the zone's offset: `2026-09-19T12:00:00.000+07:00`. */
+export declare const DEFAULT_TEMPORAL_PATTERN = "YYYY-MM-DDTHH:mm:ss.SSSZ";
+//# sourceMappingURL=constants.d.ts.map

package/dist/cjs/modules/temporal/common/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../src/modules/temporal/common/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,yGAAyG;AACzG,qBAAa,aAAa;IACxB,MAAM,CAAC,QAAQ,CAAC,WAAW,iBAAiB;IAC5C,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY;IAClC,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY;IAClC,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAU;IAC9B,MAAM,CAAC,QAAQ,CAAC,GAAG,SAAS;IAC5B,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAU;IAC9B,MAAM,CAAC,QAAQ,CAAC,KAAK,WAAW;IAChC,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAU;IAE9B,MAAM,CAAC,QAAQ,CAAC,UAAU,cASvB;IAEH,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,aAAa;CAGtD;AAED,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,aAAa,CAAC,CAAC;AAE9D,iHAAiH;AACjH,eAAO,MAAM,0BAA0B,QAAQ,CAAC;AAEhD,wGAAwG;AACxG,eAAO,MAAM,wBAAwB,6BAA6B,CAAC"}

package/dist/cjs/modules/temporal/common/constants.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_TEMPORAL_PATTERN = exports.DEFAULT_TEMPORAL_TIME_ZONE = exports.TemporalUnits = void 0;
+/** Units `add`, `subtract`, `startOf` and `endOf` accept. Weeks are ISO weeks - they start on Monday. */
+class TemporalUnits {
+    static { this.MILLISECOND = 'millisecond'; }
+    static { this.SECOND = 'second'; }
+    static { this.MINUTE = 'minute'; }
+    static { this.HOUR = 'hour'; }
+    static { this.DAY = 'day'; }
+    static { this.WEEK = 'week'; }
+    static { this.MONTH = 'month'; }
+    static { this.YEAR = 'year'; }
+    static { this.SCHEME_SET = new Set([
+        this.MILLISECOND,
+        this.SECOND,
+        this.MINUTE,
+        this.HOUR,
+        this.DAY,
+        this.WEEK,
+        this.MONTH,
+        this.YEAR,
+    ]); }
+    static isValid(input) {
+        return this.SCHEME_SET.has(input);
+    }
+}
+exports.TemporalUnits = TemporalUnits;
+/** A helper built without a `timeZone` computes in UTC - never in the host's zone, which differs per machine. */
+exports.DEFAULT_TEMPORAL_TIME_ZONE = 'UTC';
+/** `format` with no pattern writes ISO 8601 with the zone's offset: `2026-09-19T12:00:00.000+07:00`. */
+exports.DEFAULT_TEMPORAL_PATTERN = 'YYYY-MM-DDTHH:mm:ss.SSSZ';
+//# sourceMappingURL=constants.js.map

package/dist/cjs/modules/temporal/common/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../src/modules/temporal/common/constants.ts"],"names":[],"mappings":";;;AAEA,yGAAyG;AACzG,MAAa,aAAa;aACR,gBAAW,GAAG,aAAa,CAAC;aAC5B,WAAM,GAAG,QAAQ,CAAC;aAClB,WAAM,GAAG,QAAQ,CAAC;aAClB,SAAI,GAAG,MAAM,CAAC;aACd,QAAG,GAAG,KAAK,CAAC;aACZ,SAAI,GAAG,MAAM,CAAC;aACd,UAAK,GAAG,OAAO,CAAC;aAChB,SAAI,GAAG,MAAM,CAAC;aAEd,eAAU,GAAG,IAAI,GAAG,CAAC;QACnC,IAAI,CAAC,WAAW;QAChB,IAAI,CAAC,MAAM;QACX,IAAI,CAAC,MAAM;QACX,IAAI,CAAC,IAAI;QACT,IAAI,CAAC,GAAG;QACR,IAAI,CAAC,IAAI;QACT,IAAI,CAAC,KAAK;QACV,IAAI,CAAC,IAAI;KACV,CAAC,CAAC;IAEH,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;;AAvBH,sCAwBC;AAID,iHAAiH;AACpG,QAAA,0BAA0B,GAAG,KAAK,CAAC;AAEhD,wGAAwG;AAC3F,QAAA,wBAAwB,GAAG,0BAA0B,CAAC"}

package/dist/cjs/modules/temporal/common/index.d.ts

@@ -0,0 +1,3 @@
+export * from './constants';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/modules/temporal/common/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/modules/temporal/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC"}

package/dist/cjs/modules/temporal/common/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./constants"), exports);
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/modules/temporal/common/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/modules/temporal/common/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,0CAAwB"}

package/dist/cjs/modules/temporal/common/types.d.ts

@@ -0,0 +1,69 @@
+/** What a date-taking method accepts: a `Date`, epoch milliseconds, or an ISO 8601 string. */
+export type TTemporalInput = Date | number | string;
+/** Wall-clock fields. `month` is 1-12, `day` 1-31 - never zero-based. */
+export interface ITemporalParts {
+    year: number;
+    month: number;
+    day: number;
+    hour: number;
+    minute: number;
+    second: number;
+    millisecond: number;
+}
+/** The wall clock an instant shows in one time zone. `dayOfWeek` is ISO: 1 Monday - 7 Sunday. */
+export interface IZonedTemporalParts extends ITemporalParts {
+    dayOfWeek: number;
+    /** Minutes east of UTC: `420` for `+07:00`. Historic local mean time carries seconds, as a fraction. */
+    offsetMinutes: number;
+}
+/**
+ * The one question a date library answers: which UTC offset a time zone observes at an instant.
+ * Everything else - the wall clock, a time a daylight-saving jump skips or repeats, adding a month,
+ * the start of a week, a pattern - `TemporalHelper` works out once from these answers, so every
+ * adapter shares one behaviour.
+ */
+export interface ITemporalAdapter {
+    /** Milliseconds east of UTC that `timeZone` observes at `value`: `25_200_000` for `+07:00`. */
+    getOffsetMilliseconds(opts: {
+        value: Date;
+        timeZone: string;
+    }): number;
+}
+/** The part of a `Temporal.ZonedDateTime` this adapter reads. */
+export interface ITemporalZonedDateTime {
+    readonly offsetNanoseconds: number;
+}
+/**
+ * The part of the `Temporal` namespace this adapter drives - structural, so neither this package
+ * nor its consumers need Temporal's type definitions, and a polyfill's namespace fits as well.
+ */
+export interface ITemporalNamespace {
+    Instant: {
+        fromEpochMilliseconds(epochMilliseconds: number): {
+            toZonedDateTimeISO(timeZone: string): ITemporalZonedDateTime;
+        };
+    };
+}
+/** The part of a `Dayjs` object this adapter reads. */
+export interface IDayjsInstance {
+    utcOffset(): number;
+    tz(timeZone: string): IDayjsInstance;
+}
+/** The part of the `dayjs` factory this adapter drives - with the `utc` and `timezone` plugins extended. */
+export interface IDayjsFactory {
+    (value?: Date | number): IDayjsInstance;
+    tz: (value: string, timeZone: string) => IDayjsInstance;
+}
+/** The part of a Luxon `DateTime` this adapter reads. */
+export interface ILuxonDateTime {
+    readonly isValid: boolean;
+    readonly invalidReason: string | null;
+    readonly offset: number;
+}
+/** The part of Luxon's `DateTime` class this adapter drives. */
+export interface ILuxonDateTimeFactory {
+    fromMillis(milliseconds: number, options: {
+        zone: string;
+    }): ILuxonDateTime;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/cjs/modules/temporal/common/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/modules/temporal/common/types.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;AAEpD,yEAAyE;AACzE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,iGAAiG;AACjG,MAAM,WAAW,mBAAoB,SAAQ,cAAc;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,wGAAwG;IACxG,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+FAA+F;IAC/F,qBAAqB,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,IAAI,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC;CACxE;AAID,iEAAiE;AACjE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE;QACP,qBAAqB,CAAC,iBAAiB,EAAE,MAAM,GAAG;YAChD,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,sBAAsB,CAAC;SAC9D,CAAC;KACH,CAAC;CACH;AAED,uDAAuD;AACvD,MAAM,WAAW,cAAc;IAC7B,SAAS,IAAI,MAAM,CAAC;IACpB,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAAC;CACtC;AAED,4GAA4G;AAC5G,MAAM,WAAW,aAAa;IAC5B,CAAC,KAAK,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,cAAc,CAAC;IACxC,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,cAAc,CAAC;CACzD;AAED,yDAAyD;AACzD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,gEAAgE;AAChE,MAAM,WAAW,qBAAqB;IACpC,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,cAAc,CAAC;CAC7E"}

package/dist/cjs/modules/temporal/common/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/cjs/modules/temporal/common/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/modules/temporal/common/types.ts"],"names":[],"mappings":""}

package/dist/cjs/modules/temporal/helper.d.ts

@@ -0,0 +1,120 @@
+import { BaseHelper } from '../base';
+import type { TTemporalUnit } from './common/constants';
+import type { ITemporalAdapter, IZonedTemporalParts, TTemporalInput } from './common/types';
+/**
+ * Dates in one time zone, through whichever library you choose: pass an adapter - the runtime's
+ * `Temporal` (the default), your own dayjs, your own Luxon. The adapter only reports a zone's UTC
+ * offset at an instant; the wall clock, daylight-saving gaps and repeats, and the calendar math all
+ * live here, so every adapter shares one behaviour.
+ *
+ * Values go in as a `Date`, epoch milliseconds or an ISO 8601 string, and come out as a `Date`, so
+ * swapping the adapter never touches a call site. The zone is yours to set: without one this helper
+ * computes in UTC, never in the host's zone. Years run from 1 to 9999.
+ */
+export declare class TemporalHelper extends BaseHelper {
+    /** Validated once per process: `Intl` answers the same for a zone name every time. */
+    private static readonly knownTimeZones;
+    private readonly adapter;
+    private readonly timeZone;
+    constructor(opts?: {
+        adapter?: ITemporalAdapter;
+        timeZone?: string;
+        scope?: string;
+    });
+    private static ensureTimeZone;
+    private static ensureUnit;
+    /** Every result passes here: an overflowing `add` is refused, never an Invalid Date. */
+    private static ensureInstant;
+    private static ensureYear;
+    private resolveTimeZone;
+    /** The adapter's one answer, rounded: an offset is whole milliseconds, a library's float may not be. */
+    private offsetAt;
+    private zonedParts;
+    /**
+     * Every instant whose wall clock reads `parts` in the zone, earliest first: one as a rule, two
+     * when the clock goes back, none when it jumps forward. `forward` is where a skipped time lands -
+     * read with the offset from before the jump, so it moves past the gap.
+     */
+    private instantsOf;
+    /** The instant wall-clock `parts` name: a skipped time moves forward, a repeated one takes the earlier. */
+    private earliestOf;
+    /**
+     * `[start, end)` of the unit holding `epoch`. A day or longer starts at its first instant. An hour
+     * or less repeats when the clock goes back, so it starts at the latest start not after `epoch`,
+     * and ends where the wall clock next shows either the following unit or this one's start again.
+     */
+    private unitBounds;
+    getTimeZone(): string;
+    now(): Date;
+    /** The instant a value names. An ISO string without an offset is read as wall clock in the zone. */
+    toDate(opts: {
+        value: TTemporalInput;
+        timeZone?: string;
+    }): Date;
+    /** The wall clock the value shows in the zone, with its ISO weekday and UTC offset. */
+    parts(opts: {
+        value: TTemporalInput;
+        timeZone?: string;
+    }): IZonedTemporalParts;
+    /**
+     * Reads a string. With a `pattern` (`YYYY YY MM M DD D HH H mm m ss s SSS Z ZZ`, text in
+     * `[brackets]`), the value must match it exactly; without one it must be ISO 8601. An offset in
+     * the value wins; otherwise the fields are wall clock in the zone.
+     */
+    parse(opts: {
+        value: string;
+        pattern?: string;
+        timeZone?: string;
+    }): Date;
+    private readIso;
+    /** Writes the value in the zone. Without a `pattern`: ISO 8601 with the zone's offset. */
+    format(opts: {
+        value: TTemporalInput;
+        pattern?: string;
+        timeZone?: string;
+    }): string;
+    /**
+     * Moves the value by whole units. Hours and smaller are elapsed time; days and larger move the
+     * calendar in the zone, so a day across a daylight-saving jump keeps the wall time, and a month
+     * past a shorter month clamps to its last day.
+     */
+    add(opts: {
+        value: TTemporalInput;
+        amount: number;
+        unit: TTemporalUnit;
+        timeZone?: string;
+    }): Date;
+    subtract(opts: {
+        value: TTemporalInput;
+        amount: number;
+        unit: TTemporalUnit;
+        timeZone?: string;
+    }): Date;
+    /** The first instant of the unit containing the value, in the zone. Weeks start on Monday. */
+    startOf(opts: {
+        value: TTemporalInput;
+        unit: TTemporalUnit;
+        timeZone?: string;
+    }): Date;
+    /** The last millisecond of the unit containing the value, in the zone. */
+    endOf(opts: {
+        value: TTemporalInput;
+        unit: TTemporalUnit;
+        timeZone?: string;
+    }): Date;
+    /** Monday to Friday, read on the wall clock of the zone. */
+    isWeekday(opts: {
+        value: TTemporalInput;
+        timeZone?: string;
+    }): boolean;
+    nextWeekday(opts: {
+        value: TTemporalInput;
+        timeZone?: string;
+    }): Date;
+    previousWeekday(opts: {
+        value: TTemporalInput;
+        timeZone?: string;
+    }): Date;
+    private stepToWeekday;
+}
+//# sourceMappingURL=helper.d.ts.map

package/dist/cjs/modules/temporal/helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../../../../src/modules/temporal/helper.ts"],"names":[],"mappings":"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"}