@venizia/ignis-helpers 0.2.0-8 → 0.2.0

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":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAoB5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EACV,gBAAgB,EAEhB,mBAAmB,EACnB,cAAc,EACf,MAAM,gBAAgB,CAAC;AAoBxB;;;;;;;;;GASG;AACH,qBAAa,cAAe,SAAQ,UAAU;IAC5C,sFAAsF;IACtF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAqB;IAE3D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,gBAAgB,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAUpF,OAAO,CAAC,MAAM,CAAC,cAAc;IAqB7B,OAAO,CAAC,MAAM,CAAC,UAAU;IAgBzB,wFAAwF;IACxF,OAAO,CAAC,MAAM,CAAC,aAAa;IAW5B,OAAO,CAAC,MAAM,CAAC,UAAU;IASzB,OAAO,CAAC,eAAe;IASvB,wGAAwG;IACxG,OAAO,CAAC,QAAQ;IAMhB,OAAO,CAAC,UAAU;IAMlB;;;;OAIG;IACH,OAAO,CAAC,UAAU;IAsBlB,2GAA2G;IAC3G,OAAO,CAAC,UAAU;IAKlB;;;;OAIG;IACH,OAAO,CAAC,UAAU;IAwBlB,WAAW,IAAI,MAAM;IAIrB,GAAG,IAAI,IAAI;IAIX,oGAAoG;IACpG,MAAM,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,cAAc,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAYhE,uFAAuF;IACvF,KAAK,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,cAAc,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,mBAAmB;IAM9E;;;;OAIG;IACH,KAAK,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IA4BzE,OAAO,CAAC,OAAO;IAsCf,0FAA0F;IAC1F,MAAM,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,cAAc,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM;IAOpF;;;;OAIG;IACH,GAAG,CAAC,IAAI,EAAE;QACR,KAAK,EAAE,cAAc,CAAC;QACtB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,aAAa,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,IAAI;IAsBR,QAAQ,CAAC,IAAI,EAAE;QACb,KAAK,EAAE,cAAc,CAAC;QACtB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,aAAa,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,IAAI;IAIR,8FAA8F;IAC9F,OAAO,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,cAAc,CAAC;QAAC,IAAI,EAAE,aAAa,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IActF,0EAA0E;IAC1E,KAAK,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,cAAc,CAAC;QAAC,IAAI,EAAE,aAAa,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAcpF,4DAA4D;IAC5D,SAAS,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,cAAc,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO;IAItE,WAAW,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,cAAc,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAIrE,eAAe,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,cAAc,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAIzE,OAAO,CAAC,aAAa;CAkBtB"}

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

@@ -0,0 +1,326 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TemporalHelper = void 0;
+const http_1 = require("../../common/constants/http");
+const base_1 = require("../base");
+const error_1 = require("../error");
+const native_1 = require("./adapters/native");
+const calendar_1 = require("./calendar");
+const constants_1 = require("./common/constants");
+const pattern_1 = require("./pattern");
+/** `2026-09-19`, `2026-09-19T12:00`, `2026-09-19 12:00:00.021+07:00`, `...Z` - an offset only after a time. */
+const ISO_8601 = /^(\d{4})-(\d{2})-(\d{2})(?:[T ](\d{2}):(\d{2})(?::(\d{2})(?:\.(\d{1,9}))?)?(Z|[+-]\d{2}(?::?\d{2}(?::?\d{2})?)?)?)?$/i;
+/** The offset of an ISO 8601 value: `+07`, `+07:00`, `+0700`, `+07:06:40`. */
+const ISO_OFFSET = /^([+-])(\d{2})(?::?(\d{2})(?::?(\d{2}))?)?$/;
+const DAY_MILLISECONDS = 86_400_000;
+/** 0001-01-01T00:00:00.000Z and 9999-12-31T23:59:59.999Z. */
+const MIN_INSTANT = -62_135_596_800_000;
+const MAX_INSTANT = 253_402_300_799_999;
+const MAX_KNOWN_TIME_ZONES = 256;
+const OUT_OF_RANGE = `outside the years ${calendar_1.MIN_TEMPORAL_YEAR}-${calendar_1.MAX_TEMPORAL_YEAR}`;
+/**
+ * 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.
+ */
+class TemporalHelper extends base_1.BaseHelper {
+    /** Validated once per process: `Intl` answers the same for a zone name every time. */
+    static { this.knownTimeZones = new Set(); }
+    constructor(opts) {
+        super({ scope: opts?.scope ?? TemporalHelper.name });
+        this.timeZone = TemporalHelper.ensureTimeZone({
+            timeZone: opts?.timeZone ?? constants_1.DEFAULT_TEMPORAL_TIME_ZONE,
+            statusCode: http_1.HTTP.ResultCodes.RS_5.InternalServerError,
+        });
+        this.adapter = opts?.adapter ?? new native_1.NativeTemporalAdapter();
+    }
+    static ensureTimeZone(opts) {
+        const { timeZone, statusCode } = opts;
+        if (TemporalHelper.knownTimeZones.has(timeZone)) {
+            return timeZone;
+        }
+        try {
+            new Intl.DateTimeFormat('en-US', { timeZone });
+        }
+        catch (error) {
+            throw (0, error_1.getError)({
+                statusCode,
+                message: `[TemporalHelper] unknown time zone '${timeZone}' | ${error instanceof Error ? error.message : String(error)}`,
+            });
+        }
+        if (TemporalHelper.knownTimeZones.size < MAX_KNOWN_TIME_ZONES) {
+            TemporalHelper.knownTimeZones.add(timeZone);
+        }
+        return timeZone;
+    }
+    static ensureUnit(opts) {
+        const { unit, amount } = opts;
+        if (!constants_1.TemporalUnits.isValid(unit)) {
+            throw (0, error_1.getError)({
+                statusCode: http_1.HTTP.ResultCodes.RS_4.BadRequest,
+                message: `[TemporalHelper] unknown unit '${unit}' | Supported: ${[...constants_1.TemporalUnits.SCHEME_SET].join(', ')}`,
+            });
+        }
+        if (amount !== undefined && !Number.isInteger(amount)) {
+            throw (0, error_1.getError)({
+                statusCode: http_1.HTTP.ResultCodes.RS_4.BadRequest,
+                message: `[TemporalHelper] amount must be an integer - received ${amount}`,
+            });
+        }
+    }
+    /** Every result passes here: an overflowing `add` is refused, never an Invalid Date. */
+    static ensureInstant(opts) {
+        const { epoch } = opts;
+        if (!(epoch >= MIN_INSTANT && epoch <= MAX_INSTANT)) {
+            throw (0, error_1.getError)({
+                statusCode: http_1.HTTP.ResultCodes.RS_4.BadRequest,
+                message: `[TemporalHelper] ${Number.isNaN(epoch) ? 'invalid date' : OUT_OF_RANGE} - received ${epoch}`,
+            });
+        }
+        return new Date(epoch);
+    }
+    static ensureYear(opts) {
+        if (!(0, calendar_1.isSupportedYear)(opts.parts.year)) {
+            throw (0, error_1.getError)({
+                statusCode: http_1.HTTP.ResultCodes.RS_4.BadRequest,
+                message: `[TemporalHelper] year ${opts.parts.year} is ${OUT_OF_RANGE}`,
+            });
+        }
+    }
+    resolveTimeZone(opts) {
+        return opts.timeZone === undefined
+            ? this.timeZone
+            : TemporalHelper.ensureTimeZone({
+                timeZone: opts.timeZone,
+                statusCode: http_1.HTTP.ResultCodes.RS_4.BadRequest,
+            });
+    }
+    /** The adapter's one answer, rounded: an offset is whole milliseconds, a library's float may not be. */
+    offsetAt(opts) {
+        return Math.round(this.adapter.getOffsetMilliseconds({ value: new Date(opts.epoch), timeZone: opts.timeZone }));
+    }
+    zonedParts(opts) {
+        const parts = (0, calendar_1.wallClockAt)({ epoch: opts.epoch, offsetMilliseconds: this.offsetAt(opts) });
+        TemporalHelper.ensureYear({ parts });
+        return parts;
+    }
+    /**
+     * 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.
+     */
+    instantsOf(opts) {
+        const { parts, timeZone } = opts;
+        const local = (0, calendar_1.epochAtOffset)({ parts, offsetMilliseconds: 0 });
+        const before = this.offsetAt({ epoch: local - DAY_MILLISECONDS, timeZone });
+        const after = this.offsetAt({ epoch: local + DAY_MILLISECONDS, timeZone });
+        const offsets = before === after ? [before] : [before, after];
+        const instants = [];
+        for (const offset of offsets) {
+            const candidate = local - offset;
+            if (this.offsetAt({ epoch: candidate, timeZone }) === offset) {
+                instants.push(candidate);
+            }
+        }
+        instants.sort((left, right) => left - right);
+        return { instants, forward: local - before };
+    }
+    /** The instant wall-clock `parts` name: a skipped time moves forward, a repeated one takes the earlier. */
+    earliestOf(opts) {
+        const { instants, forward } = this.instantsOf(opts);
+        return instants[0] ?? forward;
+    }
+    /**
+     * `[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.
+     */
+    unitBounds(opts) {
+        const { epoch, unit, timeZone } = opts;
+        const startParts = (0, calendar_1.truncateTo)({ parts: this.zonedParts({ epoch, timeZone }), unit });
+        const nextParts = (0, calendar_1.shiftWallClock)({ parts: startParts, amount: 1, unit });
+        TemporalHelper.ensureYear({ parts: nextParts });
+        const starts = this.instantsOf({ parts: startParts, timeZone });
+        if (calendar_1.EXACT_UNIT_MILLISECONDS[unit] === undefined) {
+            const start = starts.instants[0] ?? starts.forward;
+            return { start, end: this.earliestOf({ parts: nextParts, timeZone }) };
+        }
+        const started = starts.instants.filter(instant => instant <= epoch);
+        const start = started.at(-1) ?? starts.instants[0] ?? starts.forward;
+        const nexts = this.instantsOf({ parts: nextParts, timeZone });
+        const following = nexts.instants.find(instant => instant > start) ?? nexts.forward;
+        const repeated = starts.instants.find(instant => instant > start);
+        return { start, end: repeated === undefined ? following : Math.min(repeated, following) };
+    }
+    getTimeZone() {
+        return this.timeZone;
+    }
+    now() {
+        return new Date();
+    }
+    /** The instant a value names. An ISO string without an offset is read as wall clock in the zone. */
+    toDate(opts) {
+        const { value } = opts;
+        if (typeof value === 'string') {
+            return this.parse({ value, timeZone: opts.timeZone });
+        }
+        return TemporalHelper.ensureInstant({
+            epoch: value instanceof Date ? value.getTime() : value,
+        });
+    }
+    /** The wall clock the value shows in the zone, with its ISO weekday and UTC offset. */
+    parts(opts) {
+        const timeZone = this.resolveTimeZone({ timeZone: opts.timeZone });
+        const date = this.toDate({ value: opts.value, timeZone });
+        return this.zonedParts({ epoch: date.getTime(), timeZone });
+    }
+    /**
+     * 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) {
+        const { value, pattern } = opts;
+        const timeZone = this.resolveTimeZone({ timeZone: opts.timeZone });
+        const read = pattern ? pattern_1.TemporalPattern.parse({ pattern, value }) : this.readIso({ value });
+        if (!read) {
+            throw (0, error_1.getError)({
+                statusCode: http_1.HTTP.ResultCodes.RS_4.BadRequest,
+                message: pattern
+                    ? `[TemporalHelper] '${value}' does not match pattern '${pattern}'`
+                    : `[TemporalHelper] '${value}' is not ISO 8601 | Pass a pattern for any other shape`,
+            });
+        }
+        if (!(0, calendar_1.isRealDateTime)({ parts: read.parts })) {
+            throw (0, error_1.getError)({
+                statusCode: http_1.HTTP.ResultCodes.RS_4.BadRequest,
+                message: `[TemporalHelper] '${value}' is not a real date and time`,
+            });
+        }
+        const epoch = read.offsetMilliseconds === undefined
+            ? this.earliestOf({ parts: read.parts, timeZone })
+            : (0, calendar_1.epochAtOffset)({ parts: read.parts, offsetMilliseconds: read.offsetMilliseconds });
+        return TemporalHelper.ensureInstant({ epoch });
+    }
+    readIso(opts) {
+        const match = ISO_8601.exec(opts.value);
+        if (!match) {
+            return undefined;
+        }
+        const [, year, month, day, hour, minute, second, fraction, offset] = match;
+        const parts = {
+            year: Number(year),
+            month: Number(month),
+            day: Number(day),
+            hour: Number(hour ?? 0),
+            minute: Number(minute ?? 0),
+            second: Number(second ?? 0),
+            millisecond: Number((fraction ?? '0').padEnd(3, '0').slice(0, 3)),
+        };
+        if (!offset) {
+            return { parts };
+        }
+        if (offset.toUpperCase() === 'Z') {
+            return { parts, offsetMilliseconds: 0 };
+        }
+        const [, sign, offsetHours, offsetMinutes, offsetSeconds] = ISO_OFFSET.exec(offset) ?? [];
+        const hours = Number(offsetHours);
+        const minutes = Number(offsetMinutes ?? 0);
+        const seconds = Number(offsetSeconds ?? 0);
+        if (!(hours <= 23 && minutes <= 59 && seconds <= 59)) {
+            return undefined;
+        }
+        const milliseconds = ((hours * 60 + minutes) * 60 + seconds) * 1000;
+        return { parts, offsetMilliseconds: sign === '-' ? -milliseconds : milliseconds };
+    }
+    /** Writes the value in the zone. Without a `pattern`: ISO 8601 with the zone's offset. */
+    format(opts) {
+        return pattern_1.TemporalPattern.format({
+            pattern: opts.pattern ?? constants_1.DEFAULT_TEMPORAL_PATTERN,
+            parts: this.parts({ value: opts.value, timeZone: opts.timeZone }),
+        });
+    }
+    /**
+     * 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) {
+        const { amount, unit } = opts;
+        TemporalHelper.ensureUnit({ unit, amount });
+        const timeZone = this.resolveTimeZone({ timeZone: opts.timeZone });
+        const date = this.toDate({ value: opts.value, timeZone });
+        if (amount === 0) {
+            return date;
+        }
+        const exact = calendar_1.EXACT_UNIT_MILLISECONDS[unit];
+        if (exact !== undefined) {
+            return TemporalHelper.ensureInstant({ epoch: date.getTime() + amount * exact });
+        }
+        const parts = (0, calendar_1.wallClockOf)({ parts: this.zonedParts({ epoch: date.getTime(), timeZone }) });
+        const shifted = (0, calendar_1.shiftWallClock)({ parts, amount, unit });
+        TemporalHelper.ensureYear({ parts: shifted });
+        return TemporalHelper.ensureInstant({ epoch: this.earliestOf({ parts: shifted, timeZone }) });
+    }
+    subtract(opts) {
+        return this.add({ ...opts, amount: -opts.amount });
+    }
+    /** The first instant of the unit containing the value, in the zone. Weeks start on Monday. */
+    startOf(opts) {
+        const { unit } = opts;
+        TemporalHelper.ensureUnit({ unit });
+        const timeZone = this.resolveTimeZone({ timeZone: opts.timeZone });
+        const date = this.toDate({ value: opts.value, timeZone });
+        if (unit === constants_1.TemporalUnits.MILLISECOND) {
+            return date;
+        }
+        const { start } = this.unitBounds({ epoch: date.getTime(), unit, timeZone });
+        return TemporalHelper.ensureInstant({ epoch: start });
+    }
+    /** The last millisecond of the unit containing the value, in the zone. */
+    endOf(opts) {
+        const { unit } = opts;
+        TemporalHelper.ensureUnit({ unit });
+        const timeZone = this.resolveTimeZone({ timeZone: opts.timeZone });
+        const date = this.toDate({ value: opts.value, timeZone });
+        if (unit === constants_1.TemporalUnits.MILLISECOND) {
+            return date;
+        }
+        const { end } = this.unitBounds({ epoch: date.getTime(), unit, timeZone });
+        return TemporalHelper.ensureInstant({ epoch: end - 1 });
+    }
+    /** Monday to Friday, read on the wall clock of the zone. */
+    isWeekday(opts) {
+        return this.parts(opts).dayOfWeek <= 5;
+    }
+    nextWeekday(opts) {
+        return this.stepToWeekday({ ...opts, step: 1 });
+    }
+    previousWeekday(opts) {
+        return this.stepToWeekday({ ...opts, step: -1 });
+    }
+    stepToWeekday(opts) {
+        let candidate = this.add({
+            value: opts.value,
+            amount: opts.step,
+            unit: constants_1.TemporalUnits.DAY,
+            timeZone: opts.timeZone,
+        });
+        while (!this.isWeekday({ value: candidate, timeZone: opts.timeZone })) {
+            candidate = this.add({
+                value: candidate,
+                amount: opts.step,
+                unit: constants_1.TemporalUnits.DAY,
+                timeZone: opts.timeZone,
+            });
+        }
+        return candidate;
+    }
+}
+exports.TemporalHelper = TemporalHelper;
+//# sourceMappingURL=helper.js.map

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

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

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

@@ -0,0 +1,4 @@
+export * from './adapters';
+export * from './common';
+export * from './helper';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/temporal/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC"}

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

@@ -0,0 +1,20 @@
+"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("./adapters"), exports);
+__exportStar(require("./common"), exports);
+__exportStar(require("./helper"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/modules/temporal/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,2CAAyB;AACzB,2CAAyB"}

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

@@ -0,0 +1,24 @@
+import type { ITemporalParts, IZonedTemporalParts } from './common/types';
+/** The pattern dialect: compiled once per pattern, then formatted and parsed from the cache. */
+export declare class TemporalPattern {
+    /** A service formats the same few patterns millions of times; capped so caller-fed patterns cannot grow it. */
+    private static readonly compiled;
+    /**
+     * Splits a pattern into tokens and literals. A run of one letter is one token, and an unknown run
+     * is refused: `yyyy` is not `YYYY`, and `MMM` is never read as `MM` then `M`.
+     */
+    private static compile;
+    static format(opts: {
+        pattern: string;
+        parts: IZonedTemporalParts;
+    }): string;
+    /** The fields a value spells under a pattern, or undefined when it does not match. Unset fields default to the start: month 1, day 1, 00:00. */
+    static parse(opts: {
+        pattern: string;
+        value: string;
+    }): {
+        parts: ITemporalParts;
+        offsetMilliseconds?: number;
+    } | undefined;
+}
+//# sourceMappingURL=pattern.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pattern.d.ts","sourceRoot":"","sources":["../../../../src/modules/temporal/pattern.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAc1E,gGAAgG;AAChG,qBAAa,eAAe;IAC1B,+GAA+G;IAC/G,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAA6C;IAE7E;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,OAAO;IAiEtB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,mBAAmB,CAAA;KAAE,GAAG,MAAM;IAU5E,gJAAgJ;IAChJ,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;KACf,GAAG;QAAE,KAAK,EAAE,cAAc,CAAC;QAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS;CAwDvE"}