@c9up/chronos 0.1.15 → 0.1.17
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +136 -16
- package/dist/DateTime.d.ts +209 -8
- package/dist/DateTime.d.ts.map +1 -1
- package/dist/DateTime.js +815 -116
- package/dist/DateTime.js.map +1 -1
- package/dist/Duration.d.ts +37 -20
- package/dist/Duration.d.ts.map +1 -1
- package/dist/Duration.js +287 -120
- package/dist/Duration.js.map +1 -1
- package/dist/Interval.d.ts +50 -7
- package/dist/Interval.d.ts.map +1 -1
- package/dist/Interval.js +142 -29
- package/dist/Interval.js.map +1 -1
- package/dist/atlas.d.ts +11 -15
- package/dist/atlas.d.ts.map +1 -1
- package/dist/atlas.js +22 -17
- package/dist/atlas.js.map +1 -1
- package/dist/format.d.ts +47 -0
- package/dist/format.d.ts.map +1 -0
- package/dist/format.js +387 -0
- package/dist/format.js.map +1 -0
- package/dist/holidays.d.ts +43 -0
- package/dist/holidays.d.ts.map +1 -0
- package/dist/holidays.js +102 -0
- package/dist/holidays.js.map +1 -0
- package/dist/index.d.ts +8 -6
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +4 -3
- package/dist/index.js.map +1 -1
- package/dist/native/generated.d.ts +11 -2
- package/dist/native/generated.d.ts.map +1 -1
- package/dist/native.d.ts.map +1 -1
- package/dist/native.js +5 -2
- package/dist/native.js.map +1 -1
- package/dist/parse.d.ts +59 -0
- package/dist/parse.d.ts.map +1 -0
- package/dist/parse.js +404 -0
- package/dist/parse.js.map +1 -0
- package/dist/rrule.d.ts +34 -2
- package/dist/rrule.d.ts.map +1 -1
- package/dist/rrule.js +156 -32
- package/dist/rrule.js.map +1 -1
- package/index.darwin-arm64.node +0 -0
- package/index.darwin-x64.node +0 -0
- package/index.linux-arm64-gnu.node +0 -0
- package/index.linux-x64-gnu.node +0 -0
- package/index.win32-x64-msvc.node +0 -0
- package/package.json +2 -3
- package/src/DateTime.ts +1089 -124
- package/src/Duration.ts +318 -139
- package/src/Interval.ts +160 -53
- package/src/atlas.ts +23 -17
- package/src/format.ts +449 -0
- package/src/holidays.ts +161 -0
- package/src/index.ts +35 -7
- package/src/native/generated.ts +27 -2
- package/src/native.ts +7 -3
- package/src/parse.ts +559 -0
- package/src/rrule.ts +229 -38
- package/wasm/chronos_engine_wasm.d.ts +13 -4
- package/wasm/chronos_engine_wasm.js +87 -16
- package/wasm/chronos_engine_wasm_bg.wasm +0 -0
- package/wasm/chronos_engine_wasm_bg.wasm.d.ts +5 -2
- package/dist/utils.d.ts +0 -15
- package/dist/utils.d.ts.map +0 -1
- package/dist/utils.js +0 -17
- package/dist/utils.js.map +0 -1
- package/scripts/build-napi-types.mjs +0 -69
- package/scripts/clean-wasm-pack-meta.mjs +0 -32
- package/scripts/copy-napi.mjs +0 -56
- package/scripts/generate-napi-types.mjs +0 -156
- package/scripts/verify-napi.mjs +0 -46
- package/scripts/verify-wasm.mjs +0 -55
- package/src/utils.ts +0 -17
package/dist/Interval.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"Interval.d.ts","sourceRoot":"","sources":["../src/Interval.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,KAAK,SAAS,EAAE,QAAQ,EAAE,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,
|
|
1
|
+
{"version":3,"file":"Interval.d.ts","sourceRoot":"","sources":["../src/Interval.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,KAAK,SAAS,EAAE,QAAQ,EAAE,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,EACN,QAAQ,EACR,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,MAAM,eAAe,CAAC;AAiDvB,qBAAa,QAAQ;;IAIpB;;;;;OAKG;IACH,OAAO;IAUP,oEAAoE;IACpE,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,GAAG,QAAQ;IAIhE;;;;OAIG;IACH,MAAM,CAAC,KAAK,CACX,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,QAAQ,GAAG,cAAc,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAA;KAAE,GACtE,QAAQ;IAKX,8EAA8E;IAC9E,MAAM,CAAC,MAAM,CACZ,GAAG,EAAE,SAAS,EACd,QAAQ,EAAE,QAAQ,GAAG,cAAc,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAA;KAAE,GACtE,QAAQ;IAKX;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,QAAQ;IAoBvE,IAAI,KAAK,IAAI,QAAQ,CAEpB;IACD,IAAI,GAAG,IAAI,QAAQ,CAElB;IAED,iEAAiE;IACjE,MAAM,CAAC,IAAI,GAAE,YAAY,GAAG,QAAyB,GAAG,MAAM;IAK9D;;;;OAIG;IACH,KAAK,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM;IAS7B,6CAA6C;IAC7C,UAAU,IAAI,QAAQ;IAMtB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO;IAKhC,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO;IAIhC,yDAAyD;IACzD,OAAO,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO;IAI/B,4CAA4C;IAC5C,OAAO,IAAI,OAAO;IAMlB,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO;IAOlC,gDAAgD;IAChD,OAAO,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO;IAOjC,2EAA2E;IAC3E,UAAU,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO;IAIpC,sDAAsD;IACtD,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO;IAIlC,2DAA2D;IAC3D,YAAY,CAAC,KAAK,EAAE,QAAQ,GAAG,QAAQ,GAAG,IAAI;IAO9C;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE,QAAQ,GAAG,QAAQ;IAOhC;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,SAAS,QAAQ,EAAE,GAAG,QAAQ,EAAE;IAoBxD;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,QAAQ,EAAE,GAAG,QAAQ,EAAE;IAwBtD,oFAAoF;IACpF,UAAU,CAAC,GAAG,SAAS,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE;IAQhD;;;;OAIG;IACH,OAAO,CACN,QAAQ,EAAE,QAAQ,GAAG,cAAc,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAA;KAAE,GACtE,QAAQ,EAAE;IAmBb,6EAA6E;IAC7E,OAAO,CAAC,GAAG,GAAG,EAAE,SAAS,EAAE,GAAG,QAAQ,EAAE;IAuBxC,QAAQ,IAAI,MAAM;IAIlB,MAAM,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE;CAGxC"}
|
package/dist/Interval.js
CHANGED
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
* @implements Story 36.9
|
|
9
9
|
*/
|
|
10
10
|
import { DateTime } from "./DateTime.js";
|
|
11
|
-
import { Duration } from "./Duration.js";
|
|
11
|
+
import { Duration, } from "./Duration.js";
|
|
12
12
|
/**
|
|
13
13
|
* Milliseconds in one unit, refusing a unit it does not know.
|
|
14
14
|
*
|
|
@@ -41,6 +41,15 @@ function msPerUnit(unit, caller) {
|
|
|
41
41
|
}
|
|
42
42
|
return ms;
|
|
43
43
|
}
|
|
44
|
+
/** The `{ amount, unit }` shorthand as a Duration; anything else as given. */
|
|
45
|
+
function toDuration(duration) {
|
|
46
|
+
if (duration instanceof Duration)
|
|
47
|
+
return duration;
|
|
48
|
+
if ("amount" in duration && "unit" in duration) {
|
|
49
|
+
return Duration.fromObject({ [`${duration.unit}s`]: duration.amount });
|
|
50
|
+
}
|
|
51
|
+
return Duration.fromObject(duration);
|
|
52
|
+
}
|
|
44
53
|
export class Interval {
|
|
45
54
|
#start;
|
|
46
55
|
#end;
|
|
@@ -62,16 +71,48 @@ export class Interval {
|
|
|
62
71
|
static fromDateTimes(start, end) {
|
|
63
72
|
return new Interval(DateTime.from(start), DateTime.from(end));
|
|
64
73
|
}
|
|
65
|
-
/**
|
|
74
|
+
/**
|
|
75
|
+
* Build from a start and a duration forward, as Luxon does: the end is
|
|
76
|
+
* `start.plus(duration)`, calendar arithmetic in the start's zone — so
|
|
77
|
+
* January 31st plus one month ends on February 28th, not March 2nd.
|
|
78
|
+
*/
|
|
66
79
|
static after(start, duration) {
|
|
67
80
|
const s = DateTime.from(start);
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
81
|
+
return new Interval(s, s.plus(toDuration(duration)));
|
|
82
|
+
}
|
|
83
|
+
/** The interval of `duration` ending at `end` (Luxon's `Interval.before`). */
|
|
84
|
+
static before(end, duration) {
|
|
85
|
+
const e = DateTime.from(end);
|
|
86
|
+
return new Interval(e.minus(toDuration(duration)), e);
|
|
87
|
+
}
|
|
88
|
+
/**
|
|
89
|
+
* Parse an ISO 8601 interval: `start/end`, `start/duration` or
|
|
90
|
+
* `duration/end` (Luxon's `Interval.fromISO`). Offset-less times are read in
|
|
91
|
+
* `options.zone` (UTC by default).
|
|
92
|
+
*
|
|
93
|
+
* @throws RangeError when neither half reads as a date.
|
|
94
|
+
*/
|
|
95
|
+
static fromISO(text, options = {}) {
|
|
96
|
+
const [s, e] = text.split("/", 2);
|
|
97
|
+
const read = (part) => {
|
|
98
|
+
if (!part)
|
|
99
|
+
return undefined;
|
|
100
|
+
try {
|
|
101
|
+
return DateTime.fromISO(part, options);
|
|
102
|
+
}
|
|
103
|
+
catch {
|
|
104
|
+
return undefined;
|
|
105
|
+
}
|
|
106
|
+
};
|
|
107
|
+
const start = read(s);
|
|
108
|
+
const end = read(e);
|
|
109
|
+
if (start && end)
|
|
110
|
+
return new Interval(start, end);
|
|
111
|
+
if (start && e)
|
|
112
|
+
return Interval.after(start, Duration.fromISO(e));
|
|
113
|
+
if (end && s)
|
|
114
|
+
return Interval.before(end, Duration.fromISO(s));
|
|
115
|
+
throw new RangeError(`Invalid ISO 8601 interval: ${text}`);
|
|
75
116
|
}
|
|
76
117
|
// ─── Accessors ──────────────────────────────────────────
|
|
77
118
|
get start() {
|
|
@@ -85,6 +126,17 @@ export class Interval {
|
|
|
85
126
|
const ms = this.#end.toMillis() - this.#start.toMillis();
|
|
86
127
|
return ms / msPerUnit(unit, "Interval.length");
|
|
87
128
|
}
|
|
129
|
+
/**
|
|
130
|
+
* How many `unit`s the interval touches, counting partial ones — a day
|
|
131
|
+
* starting at noon and ending the next noon touches two days (Luxon's
|
|
132
|
+
* `count`).
|
|
133
|
+
*/
|
|
134
|
+
count(unit) {
|
|
135
|
+
const start = this.#start.startOf(unit);
|
|
136
|
+
const end = this.#end.startOf(unit);
|
|
137
|
+
return (Math.floor(end.diff(start, unit).as(unit)) +
|
|
138
|
+
(end.toMillis() !== this.#end.toMillis() ? 1 : 0));
|
|
139
|
+
}
|
|
88
140
|
/** Duration object between start and end. */
|
|
89
141
|
toDuration() {
|
|
90
142
|
return Duration.fromMillis(this.#end.toMillis() - this.#start.toMillis());
|
|
@@ -128,35 +180,96 @@ export class Interval {
|
|
|
128
180
|
}
|
|
129
181
|
/** The overlapping sub-interval, or `null` if disjoint. */
|
|
130
182
|
intersection(other) {
|
|
131
|
-
const s =
|
|
132
|
-
const e =
|
|
133
|
-
if (s
|
|
183
|
+
const s = this.#start.isBefore(other.#start) ? other.#start : this.#start;
|
|
184
|
+
const e = this.#end.isAfter(other.#end) ? other.#end : this.#end;
|
|
185
|
+
if (!s.isBefore(e))
|
|
134
186
|
return null;
|
|
135
|
-
return Interval
|
|
187
|
+
return new Interval(s, e);
|
|
136
188
|
}
|
|
137
|
-
/**
|
|
189
|
+
/**
|
|
190
|
+
* The interval from the earlier start to the later end, gap included, as
|
|
191
|
+
* Luxon's `union`. Use {@link Interval.merge} to keep disjoint pieces apart.
|
|
192
|
+
*/
|
|
138
193
|
union(other) {
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
194
|
+
return new Interval(other.#start.isBefore(this.#start) ? other.#start : this.#start, other.#end.isAfter(this.#end) ? other.#end : this.#end);
|
|
195
|
+
}
|
|
196
|
+
/**
|
|
197
|
+
* The minimal set of intervals covering the same time: overlapping and
|
|
198
|
+
* abutting intervals are joined, disjoint ones kept, in ascending order.
|
|
199
|
+
*/
|
|
200
|
+
static merge(intervals) {
|
|
201
|
+
const sorted = [...intervals].sort((a, b) => a.#start.toMillis() - b.#start.toMillis());
|
|
202
|
+
const out = [];
|
|
203
|
+
let current;
|
|
204
|
+
for (const item of sorted) {
|
|
205
|
+
if (current === undefined) {
|
|
206
|
+
current = item;
|
|
207
|
+
}
|
|
208
|
+
else if (current.overlaps(item) || current.abutsStart(item)) {
|
|
209
|
+
current = current.union(item);
|
|
210
|
+
}
|
|
211
|
+
else {
|
|
212
|
+
out.push(current);
|
|
213
|
+
current = item;
|
|
214
|
+
}
|
|
215
|
+
}
|
|
216
|
+
if (current !== undefined)
|
|
217
|
+
out.push(current);
|
|
218
|
+
return out;
|
|
219
|
+
}
|
|
220
|
+
/**
|
|
221
|
+
* The time covered by exactly one of the intervals (Luxon's `Interval.xor`).
|
|
222
|
+
*/
|
|
223
|
+
static xor(intervals) {
|
|
224
|
+
const edges = intervals
|
|
225
|
+
.flatMap((i) => [
|
|
226
|
+
{ time: i.#start, start: true },
|
|
227
|
+
{ time: i.#end, start: false },
|
|
228
|
+
])
|
|
229
|
+
.sort((a, b) => a.time.toMillis() - b.time.toMillis());
|
|
230
|
+
let open;
|
|
231
|
+
let depth = 0;
|
|
232
|
+
const results = [];
|
|
233
|
+
for (const edge of edges) {
|
|
234
|
+
depth += edge.start ? 1 : -1;
|
|
235
|
+
if (depth === 1) {
|
|
236
|
+
open = edge.time;
|
|
237
|
+
}
|
|
238
|
+
else {
|
|
239
|
+
if (open && open.toMillis() !== edge.time.toMillis()) {
|
|
240
|
+
results.push(new Interval(open, edge.time));
|
|
241
|
+
}
|
|
242
|
+
open = undefined;
|
|
243
|
+
}
|
|
143
244
|
}
|
|
144
|
-
return Interval.
|
|
245
|
+
return Interval.merge(results);
|
|
246
|
+
}
|
|
247
|
+
/** The parts of this interval none of `intervals` covers (Luxon's `difference`). */
|
|
248
|
+
difference(...intervals) {
|
|
249
|
+
return Interval.xor([this, ...intervals])
|
|
250
|
+
.map((i) => this.intersection(i))
|
|
251
|
+
.filter((i) => i !== null && !i.isEmpty());
|
|
145
252
|
}
|
|
146
253
|
// ─── Split ──────────────────────────────────────────────
|
|
147
|
-
/**
|
|
254
|
+
/**
|
|
255
|
+
* Split into consecutive pieces of `duration`, the last one shorter if it
|
|
256
|
+
* does not divide evenly. Each boundary is `start.plus(duration × n)`, as in
|
|
257
|
+
* Luxon, so months split on month boundaries and days on the zone's days.
|
|
258
|
+
*/
|
|
148
259
|
splitBy(duration) {
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
260
|
+
if ("unit" in duration && !(duration instanceof Duration)) {
|
|
261
|
+
msPerUnit(duration.unit, "Interval.splitBy");
|
|
262
|
+
}
|
|
263
|
+
const step = toDuration(duration);
|
|
264
|
+
if (step.as("milliseconds") <= 0) {
|
|
153
265
|
throw new Error("splitBy duration must be positive");
|
|
266
|
+
}
|
|
154
267
|
const result = [];
|
|
155
|
-
let cursor = this.#start
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
const next =
|
|
159
|
-
result.push(Interval
|
|
268
|
+
let cursor = this.#start;
|
|
269
|
+
for (let n = 1; cursor.isBefore(this.#end); n++) {
|
|
270
|
+
const added = this.#start.plus(step.mapUnits((value) => value * n));
|
|
271
|
+
const next = added.isAfter(this.#end) ? this.#end : added;
|
|
272
|
+
result.push(new Interval(cursor, next));
|
|
160
273
|
cursor = next;
|
|
161
274
|
}
|
|
162
275
|
return result;
|
package/dist/Interval.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"Interval.js","sourceRoot":"","sources":["../src/Interval.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAkB,QAAQ,EAAiB,MAAM,eAAe,CAAC;AACxE,OAAO,
|
|
1
|
+
{"version":3,"file":"Interval.js","sourceRoot":"","sources":["../src/Interval.ts"],"names":[],"mappings":"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"}
|
package/dist/atlas.d.ts
CHANGED
|
@@ -46,20 +46,20 @@ import { DateTime } from "./DateTime.js";
|
|
|
46
46
|
* string would otherwise silently land in the bind parameter and bypass the
|
|
47
47
|
* chronos engine's normalization.
|
|
48
48
|
*
|
|
49
|
-
* **Round-trip canonicalization:**
|
|
50
|
-
*
|
|
51
|
-
* `prepare(consume('2026-04-30T12:00:00.000Z'))`
|
|
52
|
-
* `'2026-04-30T12:00:
|
|
53
|
-
*
|
|
49
|
+
* **Round-trip canonicalization:** `prepare` writes the UTC ISO form with
|
|
50
|
+
* milliseconds always present, as Luxon's `toISO()` does, whatever the value's
|
|
51
|
+
* zone: `prepare(consume('2026-04-30T12:00:00.000Z'))` is
|
|
52
|
+
* `'2026-04-30T12:00:00.000Z'`, and a value in Europe/Paris is stored as the
|
|
53
|
+
* same UTC instant. Precision below the millisecond is not kept.
|
|
54
54
|
*
|
|
55
55
|
* **Driver expectations:** `timestamp` columns may come back from the driver
|
|
56
56
|
* as either an ISO 8601 `string`, a JS `Date`, or (rarely) an integer epoch.
|
|
57
57
|
* `node-postgres` returns `Date` for `timestamp` / `timestamptz` by default;
|
|
58
58
|
* SQLite returns whatever the bound type was; configuring drivers to emit
|
|
59
|
-
* ISO strings or `Date` is the supported path.
|
|
60
|
-
*
|
|
61
|
-
*
|
|
62
|
-
*
|
|
59
|
+
* ISO strings or `Date` is the supported path. A string that is not ISO 8601
|
|
60
|
+
* (`YYYY-MM-DD[ HH:mm:ss[.SSS]][offset]`, `T` or space) is refused with a
|
|
61
|
+
* `RangeError` — align your DB column / driver settings with that wire format.
|
|
62
|
+
* Values outside years 0000-9999 are refused the same way.
|
|
63
63
|
*
|
|
64
64
|
* **Timezone handling — UTC-only:** chronos's internal storage is always UTC.
|
|
65
65
|
* Consequences for this adapter:
|
|
@@ -73,12 +73,8 @@ import { DateTime } from "./DateTime.js";
|
|
|
73
73
|
* fidelity matters — you will lose the offset on read and silently
|
|
74
74
|
* rebase on write.
|
|
75
75
|
* - Naive ISO (`'2026-04-30T12:00:00'` or SQLite-style
|
|
76
|
-
* `'2026-04-30 12:00:00'`, no `Z`, no offset) →
|
|
77
|
-
*
|
|
78
|
-
* differently across machines (CI host on UTC vs. dev laptop in
|
|
79
|
-
* Europe/Zurich). Do **not** store naive timestamps in columns reaching
|
|
80
|
-
* this adapter; configure your DB / driver to emit Z-suffixed strings or
|
|
81
|
-
* `Date` instances, or pre-process via `DateTime.fromSQL`.
|
|
76
|
+
* `'2026-04-30 12:00:00'`, no `Z`, no offset) → read as UTC, on every
|
|
77
|
+
* host. Store UTC in such columns, or emit offset-bearing strings.
|
|
82
78
|
*
|
|
83
79
|
* **Auto-timestamps stack cleanly.** As of the atlas date-engine switch, atlas
|
|
84
80
|
* hydrates every `@column.date()` / `@column.dateTime()` to a Chronos `DateTime`
|
package/dist/atlas.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"atlas.d.ts","sourceRoot":"","sources":["../src/atlas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;
|
|
1
|
+
{"version":3,"file":"atlas.d.ts","sourceRoot":"","sources":["../src/atlas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAwBzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2EG;AACH,eAAO,MAAM,oBAAoB;iBACnB,OAAO,GAAG,QAAQ,GAAG,IAAI;mBAWvB,OAAO,GAAG,MAAM,GAAG,IAAI;EAkBrC,CAAC"}
|
package/dist/atlas.js
CHANGED
|
@@ -44,8 +44,8 @@ function isDateTimeLike(value) {
|
|
|
44
44
|
return true;
|
|
45
45
|
if (value === null || typeof value !== "object")
|
|
46
46
|
return false;
|
|
47
|
-
|
|
48
|
-
|
|
47
|
+
return (typeof Reflect.get(value, "toISO") === "function" &&
|
|
48
|
+
typeof Reflect.get(value, "equals") === "function");
|
|
49
49
|
}
|
|
50
50
|
/**
|
|
51
51
|
* Atlas adapter for `timestamp` / `timestamptz` / `datetime` columns.
|
|
@@ -67,20 +67,20 @@ function isDateTimeLike(value) {
|
|
|
67
67
|
* string would otherwise silently land in the bind parameter and bypass the
|
|
68
68
|
* chronos engine's normalization.
|
|
69
69
|
*
|
|
70
|
-
* **Round-trip canonicalization:**
|
|
71
|
-
*
|
|
72
|
-
* `prepare(consume('2026-04-30T12:00:00.000Z'))`
|
|
73
|
-
* `'2026-04-30T12:00:
|
|
74
|
-
*
|
|
70
|
+
* **Round-trip canonicalization:** `prepare` writes the UTC ISO form with
|
|
71
|
+
* milliseconds always present, as Luxon's `toISO()` does, whatever the value's
|
|
72
|
+
* zone: `prepare(consume('2026-04-30T12:00:00.000Z'))` is
|
|
73
|
+
* `'2026-04-30T12:00:00.000Z'`, and a value in Europe/Paris is stored as the
|
|
74
|
+
* same UTC instant. Precision below the millisecond is not kept.
|
|
75
75
|
*
|
|
76
76
|
* **Driver expectations:** `timestamp` columns may come back from the driver
|
|
77
77
|
* as either an ISO 8601 `string`, a JS `Date`, or (rarely) an integer epoch.
|
|
78
78
|
* `node-postgres` returns `Date` for `timestamp` / `timestamptz` by default;
|
|
79
79
|
* SQLite returns whatever the bound type was; configuring drivers to emit
|
|
80
|
-
* ISO strings or `Date` is the supported path.
|
|
81
|
-
*
|
|
82
|
-
*
|
|
83
|
-
*
|
|
80
|
+
* ISO strings or `Date` is the supported path. A string that is not ISO 8601
|
|
81
|
+
* (`YYYY-MM-DD[ HH:mm:ss[.SSS]][offset]`, `T` or space) is refused with a
|
|
82
|
+
* `RangeError` — align your DB column / driver settings with that wire format.
|
|
83
|
+
* Values outside years 0000-9999 are refused the same way.
|
|
84
84
|
*
|
|
85
85
|
* **Timezone handling — UTC-only:** chronos's internal storage is always UTC.
|
|
86
86
|
* Consequences for this adapter:
|
|
@@ -94,12 +94,8 @@ function isDateTimeLike(value) {
|
|
|
94
94
|
* fidelity matters — you will lose the offset on read and silently
|
|
95
95
|
* rebase on write.
|
|
96
96
|
* - Naive ISO (`'2026-04-30T12:00:00'` or SQLite-style
|
|
97
|
-
* `'2026-04-30 12:00:00'`, no `Z`, no offset) →
|
|
98
|
-
*
|
|
99
|
-
* differently across machines (CI host on UTC vs. dev laptop in
|
|
100
|
-
* Europe/Zurich). Do **not** store naive timestamps in columns reaching
|
|
101
|
-
* this adapter; configure your DB / driver to emit Z-suffixed strings or
|
|
102
|
-
* `Date` instances, or pre-process via `DateTime.fromSQL`.
|
|
97
|
+
* `'2026-04-30 12:00:00'`, no `Z`, no offset) → read as UTC, on every
|
|
98
|
+
* host. Store UTC in such columns, or emit offset-bearing strings.
|
|
103
99
|
*
|
|
104
100
|
* **Auto-timestamps stack cleanly.** As of the atlas date-engine switch, atlas
|
|
105
101
|
* hydrates every `@column.date()` / `@column.dateTime()` to a Chronos `DateTime`
|
|
@@ -150,6 +146,15 @@ export const dateTimeAtlasAdapter = Object.freeze({
|
|
|
150
146
|
throw new TypeError(`dateTimeAtlasAdapter.prepare: expected a DateTime instance, got ${typeof value === "object" ? Object.prototype.toString.call(value) : typeof value}. ` +
|
|
151
147
|
"Wrap the value with `new DateTime(...)` before assigning to a column tagged with this adapter.");
|
|
152
148
|
}
|
|
149
|
+
// The UTC form whatever the value's zone: `toISO()` writes a zoned value
|
|
150
|
+
// with its local offset (as Luxon does), and stored text has to sort and
|
|
151
|
+
// compare as one canonical instant.
|
|
152
|
+
const toUTC = Reflect.get(value, "toUTC");
|
|
153
|
+
if (typeof toUTC === "function") {
|
|
154
|
+
const utc = Reflect.apply(toUTC, value, []);
|
|
155
|
+
if (isDateTimeLike(utc))
|
|
156
|
+
return utc.toISO();
|
|
157
|
+
}
|
|
153
158
|
return value.toISO();
|
|
154
159
|
},
|
|
155
160
|
});
|
package/dist/atlas.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
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,
|
|
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,OAAO,CACN,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,UAAU;QACjD,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,UAAU,CAClD,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2EG;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,yEAAyE;QACzE,yEAAyE;QACzE,oCAAoC;QACpC,MAAM,KAAK,GAAY,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACnD,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;YACjC,MAAM,GAAG,GAAY,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;YACrD,IAAI,cAAc,CAAC,GAAG,CAAC;gBAAE,OAAO,GAAG,CAAC,KAAK,EAAE,CAAC;QAC7C,CAAC;QACD,OAAO,KAAK,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;CACD,CAAC,CAAC"}
|
package/dist/format.d.ts
ADDED
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* `toFormat` — Luxon's format tokens (`yyyy-MM-dd HH:mm`, `dd LLL yyyy`,
|
|
3
|
+
* `EEEE`, `ZZ`, …), with Luxon's quoting (`'literal'`, `''` for a quote) and
|
|
4
|
+
* its macro tokens (`D`, `DD`, `t`, `f`, …) rendered through Intl.
|
|
5
|
+
*
|
|
6
|
+
* Numbers are written with Latin digits and names in English unless a locale
|
|
7
|
+
* is given; Luxon reads the host's default locale instead, which made the
|
|
8
|
+
* same call print differently per machine.
|
|
9
|
+
*/
|
|
10
|
+
export interface FormatParts {
|
|
11
|
+
year: number;
|
|
12
|
+
month: number;
|
|
13
|
+
day: number;
|
|
14
|
+
hour: number;
|
|
15
|
+
minute: number;
|
|
16
|
+
second: number;
|
|
17
|
+
millisecond: number;
|
|
18
|
+
/** ISO weekday, 1 = Monday. */
|
|
19
|
+
weekday: number;
|
|
20
|
+
weekNumber: number;
|
|
21
|
+
weekYear: number;
|
|
22
|
+
ordinal: number;
|
|
23
|
+
quarter: number;
|
|
24
|
+
}
|
|
25
|
+
export interface FormatContext {
|
|
26
|
+
parts: FormatParts;
|
|
27
|
+
/** Epoch milliseconds. */
|
|
28
|
+
ts: number;
|
|
29
|
+
/** UTC offset in minutes. */
|
|
30
|
+
offset: number;
|
|
31
|
+
zone: string;
|
|
32
|
+
locale: string;
|
|
33
|
+
/** Write a zero offset as `Z` (the UTC zone), as Luxon's ISO and SQL output do. */
|
|
34
|
+
allowZ?: boolean;
|
|
35
|
+
}
|
|
36
|
+
export declare const MONTHS_LONG: string[];
|
|
37
|
+
export declare const WEEKDAYS_LONG: string[];
|
|
38
|
+
export declare const MACROS: Readonly<Record<string, Intl.DateTimeFormatOptions>>;
|
|
39
|
+
export interface Token {
|
|
40
|
+
literal: boolean;
|
|
41
|
+
val: string;
|
|
42
|
+
}
|
|
43
|
+
/** Luxon's `Formatter.parseFormat`: runs of one letter are a token, `'…'` is literal. */
|
|
44
|
+
export declare function parseFormat(fmt: string): Token[];
|
|
45
|
+
export declare function isEnglish(locale: string): boolean;
|
|
46
|
+
export declare function formatLuxon(fmt: string, ctx: FormatContext): string;
|
|
47
|
+
//# sourceMappingURL=format.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,WAAW;IAC3B,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;IACpB,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC7B,KAAK,EAAE,WAAW,CAAC;IACnB,0BAA0B;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,mFAAmF;IACnF,MAAM,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,eAAO,MAAM,WAAW,UAavB,CAAC;AACF,eAAO,MAAM,aAAa,UAQzB,CAAC;AAIF,eAAO,MAAM,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,qBAAqB,CAAC,CA0GvE,CAAC;AAEF,MAAM,WAAW,KAAK;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACZ;AAED,yFAAyF;AACzF,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,EAAE,CAmChD;AA2BD,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEjD;AAwMD,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,GAAG,MAAM,CAMnE"}
|