@c9up/chronos 0.1.3 → 0.1.4

package/dist/Interval.js

@@ -0,0 +1,168 @@
+/**
+ * Interval — immutable half-open `[start, end)` time range.
+ *
+ * Provides set-style operations (`contains`, `overlaps`, `union`,
+ * `intersection`, `splitBy`, `splitAt`) that the standalone range helpers
+ * in `DateTime.ts` could not express cleanly as methods.
+ *
+ * @implements Story 36.9
+ */
+import { DateTime } from "./DateTime.js";
+import { Duration } from "./Duration.js";
+export class Interval {
+    #start;
+    #end;
+    constructor(start, end) {
+        if (start.isAfter(end)) {
+            throw new Error("Interval start must be <= end");
+        }
+        this.#start = start;
+        this.#end = end;
+    }
+    // ─── Factories ──────────────────────────────────────────
+    /** Build from two `DateInput` values. Half-open: `[start, end)`. */
+    static fromDateTimes(start, end) {
+        return new Interval(DateTime.from(start), DateTime.from(end));
+    }
+    /** Build from a start + duration forward. */
+    static after(start, duration) {
+        const s = DateTime.from(start);
+        // For Duration objects, convert to total milliseconds and add as ms —
+        // NOT as seconds (which was the original bug: Duration.fromMillis(1500)
+        // was being treated as 1500 seconds instead of 1.5 seconds).
+        const e = "amount" in duration
+            ? s.plus(duration.amount, duration.unit)
+            : DateTime.fromMillis(s.toMillis() + Math.round(duration.as("milliseconds")));
+        return new Interval(s, e);
+    }
+    // ─── Accessors ──────────────────────────────────────────
+    get start() {
+        return this.#start;
+    }
+    get end() {
+        return this.#end;
+    }
+    /** Length in the given unit (approximate for calendar units). */
+    length(unit = "milliseconds") {
+        const ms = this.#end.toMillis() - this.#start.toMillis();
+        const MS_PER = {
+            years: 365.25 * 86400000,
+            months: 30 * 86400000,
+            weeks: 7 * 86400000,
+            days: 86400000,
+            hours: 3600000,
+            minutes: 60000,
+            seconds: 1000,
+            milliseconds: 1,
+        };
+        return ms / (MS_PER[unit] ?? 1);
+    }
+    /** Duration object between start and end. */
+    toDuration() {
+        return Duration.fromMillis(this.#end.toMillis() - this.#start.toMillis());
+    }
+    // ─── Containment ────────────────────────────────────────
+    /** Does this interval contain the given instant? Half-open: `[start, end)`. */
+    contains(dt) {
+        const t = DateTime.from(dt).toMillis();
+        return t >= this.#start.toMillis() && t < this.#end.toMillis();
+    }
+    /** Is the given instant strictly before this interval? */
+    isBefore(dt) {
+        return DateTime.from(dt).toMillis() >= this.#end.toMillis();
+    }
+    /** Is the given instant strictly after this interval? */
+    isAfter(dt) {
+        return DateTime.from(dt).toMillis() < this.#start.toMillis();
+    }
+    /** Is this interval empty (zero length)? */
+    isEmpty() {
+        return this.#start.toMillis() === this.#end.toMillis();
+    }
+    // ─── Set operations ─────────────────────────────────────
+    /** Do the two intervals share any time? */
+    overlaps(other) {
+        return (this.#start.toMillis() < other.#end.toMillis() &&
+            other.#start.toMillis() < this.#end.toMillis());
+    }
+    /** Does this interval fully enclose `other`? */
+    engulfs(other) {
+        return (this.#start.toMillis() <= other.#start.toMillis() &&
+            this.#end.toMillis() >= other.#end.toMillis());
+    }
+    /** Does `other`'s start touch this interval's end (no overlap, no gap)? */
+    abutsStart(other) {
+        return this.#end.toMillis() === other.#start.toMillis();
+    }
+    /** Does `other`'s end touch this interval's start? */
+    abutsEnd(other) {
+        return other.#end.toMillis() === this.#start.toMillis();
+    }
+    /** The overlapping sub-interval, or `null` if disjoint. */
+    intersection(other) {
+        const s = Math.max(this.#start.toMillis(), other.#start.toMillis());
+        const e = Math.min(this.#end.toMillis(), other.#end.toMillis());
+        if (s >= e)
+            return null;
+        return Interval.fromDateTimes(DateTime.fromMillis(s), DateTime.fromMillis(e));
+    }
+    /** The smallest interval that covers both, or `null` if they don't overlap or abut. */
+    union(other) {
+        if (!this.overlaps(other) &&
+            !this.abutsStart(other) &&
+            !this.abutsEnd(other)) {
+            return null;
+        }
+        return Interval.fromDateTimes(DateTime.fromMillis(Math.min(this.#start.toMillis(), other.#start.toMillis())), DateTime.fromMillis(Math.max(this.#end.toMillis(), other.#end.toMillis())));
+    }
+    // ─── Split ──────────────────────────────────────────────
+    /** Split this interval into N sub-intervals of roughly equal `duration` length. */
+    splitBy(duration) {
+        const unitMs = {
+            year: 365.25 * 86400000,
+            month: 30 * 86400000,
+            week: 7 * 86400000,
+            day: 86400000,
+            hour: 3600000,
+            minute: 60000,
+            second: 1000,
+        };
+        const stepMs = "amount" in duration
+            ? duration.amount * (unitMs[duration.unit] ?? 1)
+            : duration.as("milliseconds");
+        if (stepMs <= 0)
+            throw new Error("splitBy duration must be positive");
+        const result = [];
+        let cursor = this.#start.toMillis();
+        const endMs = this.#end.toMillis();
+        while (cursor < endMs) {
+            const next = Math.min(cursor + stepMs, endMs);
+            result.push(Interval.fromDateTimes(DateTime.fromMillis(cursor), DateTime.fromMillis(next)));
+            cursor = next;
+        }
+        return result;
+    }
+    /** Split at specific instants. Instants outside the interval are ignored. */
+    splitAt(...dts) {
+        const points = dts
+            .map((d) => DateTime.from(d).toMillis())
+            .filter((ms) => ms > this.#start.toMillis() && ms < this.#end.toMillis())
+            .sort((a, b) => a - b);
+        const result = [];
+        let prev = this.#start.toMillis();
+        for (const p of points) {
+            result.push(Interval.fromDateTimes(DateTime.fromMillis(prev), DateTime.fromMillis(p)));
+            prev = p;
+        }
+        result.push(Interval.fromDateTimes(DateTime.fromMillis(prev), this.#end));
+        return result;
+    }
+    // ─── Serialization ──────────────────────────────────────
+    toString() {
+        return `[${this.#start.toISO()}, ${this.#end.toISO()})`;
+    }
+    toJSON() {
+        return { start: this.#start.toISO(), end: this.#end.toISO() };
+    }
+}
+//# sourceMappingURL=Interval.js.map

package/dist/Interval.js.map

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

package/dist/atlas.d.ts

@@ -0,0 +1,120 @@
+/**
+ * `@c9up/chronos/atlas` — Atlas column-type adapter for {@link DateTime}.
+ *
+ * Wires `Chronos.DateTime` into Atlas's `@Column({ prepare, consume })` opt-in
+ * column pipeline. Lives on a sub-export so the default `@c9up/chronos` import
+ * surface stays adapter-free.
+ *
+ * Mirrors Adonis Lucid's `@column.prepare` / `@column.consume` pattern —
+ * callbacks are baked into the entity definition; no global registry, no
+ * boot-time wiring. Same shape as `@c9up/atom/atlas` (story 35.10).
+ *
+ * Usage (imports referenced here as prose to keep this JSDoc free of literal
+ * `from "@c9up/<sibling>"` strings — that pattern would create false positives
+ * for the no-cross-package-import grep gate):
+ *
+ *     // Pull `Column`, `Entity`, `BaseEntity`, `PrimaryKey` from @c9up/atlas
+ *     // Pull `DateTime` from @c9up/chronos
+ *     // Pull `dateTimeAtlasAdapter` from @c9up/chronos/atlas
+ *
+ *     @Entity('events')
+ *     class Event extends BaseEntity {
+ *       @PrimaryKey() id!: number
+ *       @Column(dateTimeAtlasAdapter) createdAt!: DateTime | null
+ *     }
+ *
+ * @implements Story 36.14
+ */
+import { DateTime } from "./DateTime.js";
+/**
+ * Atlas adapter for `timestamp` / `timestamptz` / `datetime` columns.
+ * `consume` lifts string / `Date` / `number` / `bigint` DB values into a
+ * {@link DateTime}; `prepare` lowers a `DateTime` back to its ISO 8601 string
+ * for the SQL bind parameter.
+ *
+ * - `consume(null)` / `consume(undefined)` returns `null` so nullable columns
+ *   keep their semantics through the adapter pipeline.
+ * - `consume(existingDateTime)` is idempotent — re-consuming an already-
+ *   hydrated value returns the same instance untouched.
+ * - `consume(number)` and `consume(bigint)` are interpreted as **epoch
+ *   milliseconds** (matches `Date(ms)` and `DateTime.fromMillis`). If a driver
+ *   returns timestamps as integer seconds (e.g., a Postgres `int8` column
+ *   storing unix epochs), wrap them yourself: `new DateTime(seconds * 1000)`.
+ * - `prepare(null)` / `prepare(undefined)` returns `null` symmetrically.
+ * - `prepare` rejects anything that is not a `DateTime` instance — protects
+ *   against the common "I forgot to wrap" footgun where a JS `Date` or ISO
+ *   string would otherwise silently land in the bind parameter and bypass the
+ *   chronos engine's normalization.
+ *
+ * **Round-trip canonicalization:** chronos's internal ISO normalization
+ * collapses trailing `.000Z` to a bare `Z`. So
+ * `prepare(consume('2026-04-30T12:00:00.000Z'))` returns
+ * `'2026-04-30T12:00:00Z'` — same instant, compact form. Subsecond precision
+ * with non-zero digits (e.g., `.123Z`) is preserved verbatim.
+ *
+ * **Driver expectations:** `timestamp` columns may come back from the driver
+ * as either an ISO 8601 `string`, a JS `Date`, or (rarely) an integer epoch.
+ * `node-postgres` returns `Date` for `timestamp` / `timestamptz` by default;
+ * SQLite returns whatever the bound type was; configuring drivers to emit
+ * ISO strings or `Date` is the supported path. Strings that are NOT parseable
+ * ISO 8601 will surface a `RangeError: Invalid time value` from the
+ * underlying `Date` constructor — align your DB column / driver settings with
+ * ISO 8601 wire format.
+ *
+ * **Timezone handling — UTC-only:** chronos's internal storage is always UTC.
+ * Consequences for this adapter:
+ *   - Z-suffixed ISO (`'2026-04-30T12:00:00Z'`) → exactly UTC, no
+ *     transformation.
+ *   - Offset-bearing ISO (`'2026-04-30T12:00:00+02:00'`) → silently
+ *     UTC-rebased to `'2026-04-30T10:00:00Z'`. The original offset is NOT
+ *     preserved on round-trip. Pair with `timestamptz` columns (the only
+ *     SQL type whose contract is "store UTC instant"). Do **not** use this
+ *     adapter for `timestamp without time zone` columns where wall-clock
+ *     fidelity matters — you will lose the offset on read and silently
+ *     rebase on write.
+ *   - Naive ISO (`'2026-04-30T12:00:00'` or SQLite-style
+ *     `'2026-04-30 12:00:00'`, no `Z`, no offset) → parsed by `new Date(...)`
+ *     in the JS runtime's **local** zone. This means the same DB row hydrates
+ *     differently across machines (CI host on UTC vs. dev laptop in
+ *     Europe/Zurich). Do **not** store naive timestamps in columns reaching
+ *     this adapter; configure your DB / driver to emit Z-suffixed strings or
+ *     `Date` instances, or pre-process via `DateTime.fromSQL`.
+ *
+ * **Stacking caveat with `@column.dateTime({ autoCreate, autoUpdate })`:**
+ * the auto-timestamp decorator (story 32.8) writes `new Date()` (a JS `Date`)
+ * to the entity property when `autoCreate` / `autoUpdate` is set. If you
+ * ALSO tag the same property with `@Column(dateTimeAtlasAdapter)`, `prepare`
+ * will receive a `Date` and throw the "expected a DateTime instance"
+ * `TypeError` at INSERT / UPDATE time. **Only the `autoCreate` / `autoUpdate`
+ * flags conflict** — plain `@column.dateTime()` (no flags) does not write
+ * anything and is safe to stack. Mitigations when you need auto-timestamps:
+ *   - **Adapter only**: drop `@column.dateTime({ autoCreate, autoUpdate })`
+ *     and assign manually (e.g., in a model hook:
+ *     `entity.createdAt = DateTime.now()`).
+ *   - **`@column.dateTime({ ... })` only**: drop the adapter and manually
+ *     wrap reads with `new DateTime(row.createdAt)` at the call site.
+ * The adapter does NOT silently coerce `Date` → `DateTime` because that
+ * would mask the inconsistency between the two mechanisms.
+ *
+ * The shape `{ prepare, consume }` is **passable directly** to `@Column(...)`:
+ * `@Column(dateTimeAtlasAdapter)` is identical to
+ * `@Column({ prepare: dateTimeAtlasAdapter.prepare, consume: dateTimeAtlasAdapter.consume })`.
+ *
+ * The exported object is `Object.freeze`d, which blocks the most common
+ * direct-assignment tampering of the adapter's own slots. `Object.freeze`
+ * is shallow: prototype-level mutation of `DateTime` itself, or wholesale
+ * replacement via `structuredClone(adapter)` followed by re-binding, are
+ * out of scope for the freeze defense.
+ *
+ * **Cross-realm safety:** `consume` and `prepare` test the input via a
+ * structural duck-typed check (`toISO` + `equals` methods present), not a
+ * plain `instanceof DateTime`. This protects against pnpm-hoisting quirks
+ * where a consumer's `DateTime` import resolves to a duplicate copy of the
+ * class — the adapter still recognizes it as a `DateTime` and round-trips
+ * cleanly.
+ */
+export declare const dateTimeAtlasAdapter: Readonly<{
+    consume(raw: unknown): DateTime | null;
+    prepare(value: unknown): string | null;
+}>;
+//# sourceMappingURL=atlas.d.ts.map

package/dist/atlas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atlas.d.ts","sourceRoot":"","sources":["../src/atlas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAsBzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsFG;AACH,eAAO,MAAM,oBAAoB;iBACnB,OAAO,GAAG,QAAQ,GAAG,IAAI;mBAWvB,OAAO,GAAG,MAAM,GAAG,IAAI;EAUrC,CAAC"}

package/dist/atlas.js

@@ -0,0 +1,163 @@
+/**
+ * `@c9up/chronos/atlas` — Atlas column-type adapter for {@link DateTime}.
+ *
+ * Wires `Chronos.DateTime` into Atlas's `@Column({ prepare, consume })` opt-in
+ * column pipeline. Lives on a sub-export so the default `@c9up/chronos` import
+ * surface stays adapter-free.
+ *
+ * Mirrors Adonis Lucid's `@column.prepare` / `@column.consume` pattern —
+ * callbacks are baked into the entity definition; no global registry, no
+ * boot-time wiring. Same shape as `@c9up/atom/atlas` (story 35.10).
+ *
+ * Usage (imports referenced here as prose to keep this JSDoc free of literal
+ * `from "@c9up/<sibling>"` strings — that pattern would create false positives
+ * for the no-cross-package-import grep gate):
+ *
+ *     // Pull `Column`, `Entity`, `BaseEntity`, `PrimaryKey` from @c9up/atlas
+ *     // Pull `DateTime` from @c9up/chronos
+ *     // Pull `dateTimeAtlasAdapter` from @c9up/chronos/atlas
+ *
+ *     @Entity('events')
+ *     class Event extends BaseEntity {
+ *       @PrimaryKey() id!: number
+ *       @Column(dateTimeAtlasAdapter) createdAt!: DateTime | null
+ *     }
+ *
+ * @implements Story 36.14
+ */
+import { DateTime } from "./DateTime.js";
+/**
+ * Cross-realm-safe `DateTime` check. Returns `true` if `value` is either:
+ *   - a `DateTime` from the current module-realm (`instanceof` matches), OR
+ *   - a structurally-compatible `DateTime` from another realm — i.e. an
+ *     object exposing both `toISO(): string` and `equals(other): boolean`,
+ *     the two methods this adapter relies on.
+ *
+ * The fallback is needed when pnpm hoisting + transitive duplication produce
+ * two distinct `DateTime` constructors at runtime (workspace symlinks +
+ * a separately-installed copy under a parent `node_modules`). Without it,
+ * `instanceof` returns `false` for instances built from the consumer's
+ * own import, and `prepare` would reject perfectly valid `DateTime` values.
+ */
+function isDateTimeLike(value) {
+    if (value instanceof DateTime)
+        return true;
+    if (value === null || typeof value !== "object")
+        return false;
+    const obj = value;
+    return typeof obj.toISO === "function" && typeof obj.equals === "function";
+}
+/**
+ * Atlas adapter for `timestamp` / `timestamptz` / `datetime` columns.
+ * `consume` lifts string / `Date` / `number` / `bigint` DB values into a
+ * {@link DateTime}; `prepare` lowers a `DateTime` back to its ISO 8601 string
+ * for the SQL bind parameter.
+ *
+ * - `consume(null)` / `consume(undefined)` returns `null` so nullable columns
+ *   keep their semantics through the adapter pipeline.
+ * - `consume(existingDateTime)` is idempotent — re-consuming an already-
+ *   hydrated value returns the same instance untouched.
+ * - `consume(number)` and `consume(bigint)` are interpreted as **epoch
+ *   milliseconds** (matches `Date(ms)` and `DateTime.fromMillis`). If a driver
+ *   returns timestamps as integer seconds (e.g., a Postgres `int8` column
+ *   storing unix epochs), wrap them yourself: `new DateTime(seconds * 1000)`.
+ * - `prepare(null)` / `prepare(undefined)` returns `null` symmetrically.
+ * - `prepare` rejects anything that is not a `DateTime` instance — protects
+ *   against the common "I forgot to wrap" footgun where a JS `Date` or ISO
+ *   string would otherwise silently land in the bind parameter and bypass the
+ *   chronos engine's normalization.
+ *
+ * **Round-trip canonicalization:** chronos's internal ISO normalization
+ * collapses trailing `.000Z` to a bare `Z`. So
+ * `prepare(consume('2026-04-30T12:00:00.000Z'))` returns
+ * `'2026-04-30T12:00:00Z'` — same instant, compact form. Subsecond precision
+ * with non-zero digits (e.g., `.123Z`) is preserved verbatim.
+ *
+ * **Driver expectations:** `timestamp` columns may come back from the driver
+ * as either an ISO 8601 `string`, a JS `Date`, or (rarely) an integer epoch.
+ * `node-postgres` returns `Date` for `timestamp` / `timestamptz` by default;
+ * SQLite returns whatever the bound type was; configuring drivers to emit
+ * ISO strings or `Date` is the supported path. Strings that are NOT parseable
+ * ISO 8601 will surface a `RangeError: Invalid time value` from the
+ * underlying `Date` constructor — align your DB column / driver settings with
+ * ISO 8601 wire format.
+ *
+ * **Timezone handling — UTC-only:** chronos's internal storage is always UTC.
+ * Consequences for this adapter:
+ *   - Z-suffixed ISO (`'2026-04-30T12:00:00Z'`) → exactly UTC, no
+ *     transformation.
+ *   - Offset-bearing ISO (`'2026-04-30T12:00:00+02:00'`) → silently
+ *     UTC-rebased to `'2026-04-30T10:00:00Z'`. The original offset is NOT
+ *     preserved on round-trip. Pair with `timestamptz` columns (the only
+ *     SQL type whose contract is "store UTC instant"). Do **not** use this
+ *     adapter for `timestamp without time zone` columns where wall-clock
+ *     fidelity matters — you will lose the offset on read and silently
+ *     rebase on write.
+ *   - Naive ISO (`'2026-04-30T12:00:00'` or SQLite-style
+ *     `'2026-04-30 12:00:00'`, no `Z`, no offset) → parsed by `new Date(...)`
+ *     in the JS runtime's **local** zone. This means the same DB row hydrates
+ *     differently across machines (CI host on UTC vs. dev laptop in
+ *     Europe/Zurich). Do **not** store naive timestamps in columns reaching
+ *     this adapter; configure your DB / driver to emit Z-suffixed strings or
+ *     `Date` instances, or pre-process via `DateTime.fromSQL`.
+ *
+ * **Stacking caveat with `@column.dateTime({ autoCreate, autoUpdate })`:**
+ * the auto-timestamp decorator (story 32.8) writes `new Date()` (a JS `Date`)
+ * to the entity property when `autoCreate` / `autoUpdate` is set. If you
+ * ALSO tag the same property with `@Column(dateTimeAtlasAdapter)`, `prepare`
+ * will receive a `Date` and throw the "expected a DateTime instance"
+ * `TypeError` at INSERT / UPDATE time. **Only the `autoCreate` / `autoUpdate`
+ * flags conflict** — plain `@column.dateTime()` (no flags) does not write
+ * anything and is safe to stack. Mitigations when you need auto-timestamps:
+ *   - **Adapter only**: drop `@column.dateTime({ autoCreate, autoUpdate })`
+ *     and assign manually (e.g., in a model hook:
+ *     `entity.createdAt = DateTime.now()`).
+ *   - **`@column.dateTime({ ... })` only**: drop the adapter and manually
+ *     wrap reads with `new DateTime(row.createdAt)` at the call site.
+ * The adapter does NOT silently coerce `Date` → `DateTime` because that
+ * would mask the inconsistency between the two mechanisms.
+ *
+ * The shape `{ prepare, consume }` is **passable directly** to `@Column(...)`:
+ * `@Column(dateTimeAtlasAdapter)` is identical to
+ * `@Column({ prepare: dateTimeAtlasAdapter.prepare, consume: dateTimeAtlasAdapter.consume })`.
+ *
+ * The exported object is `Object.freeze`d, which blocks the most common
+ * direct-assignment tampering of the adapter's own slots. `Object.freeze`
+ * is shallow: prototype-level mutation of `DateTime` itself, or wholesale
+ * replacement via `structuredClone(adapter)` followed by re-binding, are
+ * out of scope for the freeze defense.
+ *
+ * **Cross-realm safety:** `consume` and `prepare` test the input via a
+ * structural duck-typed check (`toISO` + `equals` methods present), not a
+ * plain `instanceof DateTime`. This protects against pnpm-hoisting quirks
+ * where a consumer's `DateTime` import resolves to a duplicate copy of the
+ * class — the adapter still recognizes it as a `DateTime` and round-trips
+ * cleanly.
+ */
+export const dateTimeAtlasAdapter = Object.freeze({
+    consume(raw) {
+        if (raw === null || raw === undefined)
+            return null;
+        if (isDateTimeLike(raw))
+            return raw;
+        if (raw instanceof Date)
+            return DateTime.fromJSDate(raw);
+        if (typeof raw === "string")
+            return new DateTime(raw);
+        if (typeof raw === "number")
+            return DateTime.fromMillis(raw);
+        if (typeof raw === "bigint")
+            return DateTime.fromMillis(Number(raw));
+        throw new TypeError(`dateTimeAtlasAdapter.consume: expected string | Date | DateTime | number | bigint | null, got ${typeof raw}`);
+    },
+    prepare(value) {
+        if (value === null || value === undefined)
+            return null;
+        if (!isDateTimeLike(value)) {
+            throw new TypeError(`dateTimeAtlasAdapter.prepare: expected a DateTime instance, got ${typeof value === "object" ? Object.prototype.toString.call(value) : typeof value}. ` +
+                "Wrap the value with `new DateTime(...)` before assigning to a column tagged with this adapter.");
+        }
+        return value.toISO();
+    },
+});
+//# sourceMappingURL=atlas.js.map

package/dist/atlas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atlas.js","sourceRoot":"","sources":["../src/atlas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;;;;;;;;;;;GAYG;AACH,SAAS,cAAc,CAAC,KAAc;IACrC,IAAI,KAAK,YAAY,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3C,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,GAAG,GAAG,KAA8C,CAAC;IAC3D,OAAO,OAAO,GAAG,CAAC,KAAK,KAAK,UAAU,IAAI,OAAO,GAAG,CAAC,MAAM,KAAK,UAAU,CAAC;AAC5E,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsFG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,CAAC;IACjD,OAAO,CAAC,GAAY;QACnB,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QACnD,IAAI,cAAc,CAAC,GAAG,CAAC;YAAE,OAAO,GAAG,CAAC;QACpC,IAAI,GAAG,YAAY,IAAI;YAAE,OAAO,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACzD,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,OAAO,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC;QACtD,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,OAAO,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAC7D,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,OAAO,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACrE,MAAM,IAAI,SAAS,CAClB,iGAAiG,OAAO,GAAG,EAAE,CAC7G,CAAC;IACH,CAAC;IACD,OAAO,CAAC,KAAc;QACrB,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QACvD,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,SAAS,CAClB,mEAAmE,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,KAAK,IAAI;gBACtJ,gGAAgG,CACjG,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;CACD,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @c9up/chronos — advanced date/time and recurrence.
+ * The Rust N-API binary is required — there is no JS/TS fallback.
+ */
+export type { BoundUnit, CalendarParts, DateInput, DateRange, DateUnit, RangeCompareOptions, RangeRelation, } from "./DateTime.js";
+export { analyzeRange, containsRange, DateTime, inRange, overlapsRange, } from "./DateTime.js";
+export type { DurationObject, DurationUnit } from "./Duration.js";
+export { Duration } from "./Duration.js";
+export { Interval } from "./Interval.js";
+export type { RRuleBuild } from "./rrule.js";
+export { expandRRule, toRRuleString } from "./rrule.js";
+import { type DateRange, DateTime, type DateUnit, inRange, type RangeCompareOptions } from "./DateTime.js";
+import { type RRuleBuild } from "./rrule.js";
+export declare function at(input?: string | Date): DateTime;
+export declare const Chronos: {
+    at: typeof at;
+    now: () => DateTime;
+    parse: (input: string | Date) => DateTime;
+    add: (input: string | Date, amount: number, unit: DateUnit) => DateTime;
+    subtract: (input: string | Date, amount: number, unit: DateUnit) => DateTime;
+    diff: (a: string | Date, b: string | Date, unit: DateUnit) => number;
+    inRange: typeof inRange;
+    rangeContains: (outer: DateRange, inner: DateRange, options?: RangeCompareOptions) => boolean;
+    rangesOverlap: (a: DateRange, b: DateRange, options?: RangeCompareOptions) => boolean;
+    rangeRelation: (a: DateRange, b: DateRange, options?: RangeCompareOptions) => import("./DateTime.js").RangeRelation;
+    rrule: (startIso: string, rrule: string | RRuleBuild, limit?: number) => string[];
+    buildRRule: (rule: RRuleBuild) => string;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,EACX,SAAS,EACT,aAAa,EACb,SAAS,EACT,SAAS,EACT,QAAQ,EACR,mBAAmB,EACnB,aAAa,GACb,MAAM,eAAe,CAAC;AACvB,OAAO,EACN,YAAY,EACZ,aAAa,EACb,QAAQ,EACR,OAAO,EACP,aAAa,GACb,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAIxD,OAAO,EAGN,KAAK,SAAS,EACd,QAAQ,EACR,KAAK,QAAQ,EACb,OAAO,EAEP,KAAK,mBAAmB,EACxB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAe,KAAK,UAAU,EAAiB,MAAM,YAAY,CAAC;AAEzE,wBAAgB,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,QAAQ,CAElD;AAED,eAAO,MAAM,OAAO;;eAEV,QAAQ;mBACF,MAAM,GAAG,IAAI,KAAG,QAAQ;iBAC1B,MAAM,GAAG,IAAI,UAAU,MAAM,QAAQ,QAAQ,KAAG,QAAQ;sBAEnD,MAAM,GAAG,IAAI,UAAU,MAAM,QAAQ,QAAQ,KAAG,QAAQ;cAEhE,MAAM,GAAG,IAAI,KAAK,MAAM,GAAG,IAAI,QAAQ,QAAQ,KAAG,MAAM;;2BAI1D,SAAS,SACT,SAAS,YACN,mBAAmB,KAC3B,OAAO;uBAEN,SAAS,KACT,SAAS,YACF,mBAAmB,KAC3B,OAAO;uBACS,SAAS,KAAK,SAAS,YAAY,mBAAmB;sBAG9D,MAAM,SACT,MAAM,GAAG,UAAU,qBAExB,MAAM,EAAE;uBACQ,UAAU,KAAG,MAAM;CACtC,CAAC"}

package/dist/index.js

@@ -0,0 +1,29 @@
+/**
+ * @c9up/chronos — advanced date/time and recurrence.
+ * The Rust N-API binary is required — there is no JS/TS fallback.
+ */
+export { analyzeRange, containsRange, DateTime, inRange, overlapsRange, } from "./DateTime.js";
+export { Duration } from "./Duration.js";
+export { Interval } from "./Interval.js";
+export { expandRRule, toRRuleString } from "./rrule.js";
+// `isNativeAvailable` removed — NAPI is now mandatory (no fallback).
+import { analyzeRange, containsRange, DateTime, inRange, overlapsRange, } from "./DateTime.js";
+import { expandRRule, toRRuleString } from "./rrule.js";
+export function at(input) {
+    return new DateTime(input);
+}
+export const Chronos = {
+    at,
+    now: () => new DateTime(),
+    parse: (input) => new DateTime(input),
+    add: (input, amount, unit) => new DateTime(input).plus(amount, unit),
+    subtract: (input, amount, unit) => new DateTime(input).minus(amount, unit),
+    diff: (a, b, unit) => new DateTime(a).diff(b, unit),
+    inRange,
+    rangeContains: (outer, inner, options) => containsRange(outer, inner, options),
+    rangesOverlap: (a, b, options) => overlapsRange(a, b, options),
+    rangeRelation: (a, b, options) => analyzeRange(a, b, options),
+    rrule: (startIso, rrule, limit = 100) => expandRRule(startIso, rrule, limit),
+    buildRRule: (rule) => toRRuleString(rule),
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,OAAO,EACN,YAAY,EACZ,aAAa,EACb,QAAQ,EACR,OAAO,EACP,aAAa,GACb,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAExD,qEAAqE;AAErE,OAAO,EACN,YAAY,EACZ,aAAa,EAEb,QAAQ,EAER,OAAO,EACP,aAAa,GAEb,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,WAAW,EAAmB,aAAa,EAAE,MAAM,YAAY,CAAC;AAEzE,MAAM,UAAU,EAAE,CAAC,KAAqB;IACvC,OAAO,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,CAAC,MAAM,OAAO,GAAG;IACtB,EAAE;IACF,GAAG,EAAE,GAAa,EAAE,CAAC,IAAI,QAAQ,EAAE;IACnC,KAAK,EAAE,CAAC,KAAoB,EAAY,EAAE,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC;IAC9D,GAAG,EAAE,CAAC,KAAoB,EAAE,MAAc,EAAE,IAAc,EAAY,EAAE,CACvE,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC;IACvC,QAAQ,EAAE,CAAC,KAAoB,EAAE,MAAc,EAAE,IAAc,EAAY,EAAE,CAC5E,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC;IACxC,IAAI,EAAE,CAAC,CAAgB,EAAE,CAAgB,EAAE,IAAc,EAAU,EAAE,CACpE,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC;IAC9B,OAAO;IACP,aAAa,EAAE,CACd,KAAgB,EAChB,KAAgB,EAChB,OAA6B,EACnB,EAAE,CAAC,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC;IAClD,aAAa,EAAE,CACd,CAAY,EACZ,CAAY,EACZ,OAA6B,EACnB,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC;IAC1C,aAAa,EAAE,CAAC,CAAY,EAAE,CAAY,EAAE,OAA6B,EAAE,EAAE,CAC5E,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC;IAC5B,KAAK,EAAE,CACN,QAAgB,EAChB,KAA0B,EAC1B,KAAK,GAAG,GAAG,EACA,EAAE,CAAC,WAAW,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC;IAClD,UAAU,EAAE,CAAC,IAAgB,EAAU,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC;CAC7D,CAAC"}

package/dist/native.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Universal engine loader — auto-detects Node (NAPI) vs Browser (WASM).
+ *
+ * **No fallback.** If neither NAPI nor WASM loads, `nativeChronos()` throws
+ * immediately. Chronos operations (timezone, DST, RFC 5545) are too complex
+ * for a pure-TS fallback.
+ */
+export interface NativeChronos {
+    add(iso: string, amount: number, unit: string): string;
+    diff(aIso: string, bIso: string, unit: string): number;
+    startOf(iso: string, unit: string): string;
+    endOf(iso: string, unit: string): string;
+    format(iso: string, pattern: string): string;
+    validateTimezone(zone: string): string;
+    toZone(utcIso: string, zone: string): {
+        iso: string;
+        offsetMinutes: number;
+        zoneName: string;
+    };
+    addInZone(utcIso: string, amount: number, unit: string, zone: string): string;
+    diffInZone(aUtc: string, bUtc: string, unit: string, zone: string): number;
+    zoneOffset(utcIso: string, zone: string): number;
+    fromLocal(naiveIso: string, zone: string): string;
+    parseRfc2822(input: string): string;
+    parseSql(input: string): string;
+    parseHttp(input: string): string;
+    rruleExpand(startIso: string, rrule: string, limit: number): string[];
+    calendarParts(iso: string): {
+        year: number;
+        month: number;
+        day: number;
+        hour: number;
+        minute: number;
+        second: number;
+        millisecond: number;
+        weekday: number;
+        weekNumber: number;
+        weekYear: number;
+        ordinal: number;
+        quarter: number;
+        daysInMonth: number;
+        daysInYear: number;
+        isLeapYear: boolean;
+    };
+}
+export declare function nativeChronos(): NativeChronos;
+//# sourceMappingURL=native.d.ts.map

package/dist/native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../src/native.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,aAAa;IAC7B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACvD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACvD,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3C,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACzC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7C,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACvC,MAAM,CACL,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GACV;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5D,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9E,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3E,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACjD,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAClD,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACtE,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG;QAC3B,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,OAAO,CAAC;KACpB,CAAC;CACF;AAoED,wBAAgB,aAAa,IAAI,aAAa,CAW7C"}