@c9up/chronos 0.1.6 → 0.1.7

package/dist/atlas.d.ts

@@ -80,21 +80,14 @@ import { DateTime } from "./DateTime.js";
  *     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.
+ * **Auto-timestamps stack cleanly.** As of the atlas date-engine switch, atlas
+ * hydrates every `@column.date()` / `@column.dateTime()` to a Chronos `DateTime`
+ * by default and `@column.dateTime({ autoCreate, autoUpdate })` stamps
+ * `DateTime.now()` (not a JS `Date`). So tagging the same property with this
+ * adapter is redundant (the default already produces DateTime) and no longer
+ * throws — `prepare` receives a `DateTime`. Reach for this explicit adapter only
+ * when you want DateTime semantics on a column atlas would NOT treat as a date
+ * column (e.g. a plain `@Column()` storing a timestamp).
  *
  * The shape `{ prepare, consume }` is **passable directly** to `@Column(...)`:
  * `@Column(dateTimeAtlasAdapter)` is identical to

package/dist/atlas.d.ts.map

@@ -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;AAsBzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsFG;AACH,eAAO,MAAM,oBAAoB;iBACnB,OAAO,GAAG,QAAQ,GAAG,IAAI;mBAWvB,OAAO,GAAG,MAAM,GAAG,IAAI;EAUrC,CAAC"}
+{"version":3,"file":"atlas.d.ts","sourceRoot":"","sources":["../src/atlas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAsBzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+EG;AACH,eAAO,MAAM,oBAAoB;iBACnB,OAAO,GAAG,QAAQ,GAAG,IAAI;mBAWvB,OAAO,GAAG,MAAM,GAAG,IAAI;EAUrC,CAAC"}

package/dist/atlas.js

@@ -101,21 +101,14 @@ function isDateTimeLike(value) {
  *     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.
+ * **Auto-timestamps stack cleanly.** As of the atlas date-engine switch, atlas
+ * hydrates every `@column.date()` / `@column.dateTime()` to a Chronos `DateTime`
+ * by default and `@column.dateTime({ autoCreate, autoUpdate })` stamps
+ * `DateTime.now()` (not a JS `Date`). So tagging the same property with this
+ * adapter is redundant (the default already produces DateTime) and no longer
+ * throws — `prepare` receives a `DateTime`. Reach for this explicit adapter only
+ * when you want DateTime semantics on a column atlas would NOT treat as a date
+ * column (e.g. a plain `@Column()` storing a timestamp).
  *
  * The shape `{ prepare, consume }` is **passable directly** to `@Column(...)`:
  * `@Column(dateTimeAtlasAdapter)` is identical to

package/dist/atlas.js.map

@@ -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,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"}
+{"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+EG;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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c9up/chronos",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "Chronos — advanced date/time and recurrence engine (TypeScript + Rust N-API)",
   "license": "MIT",
   "type": "module",

package/src/atlas.ts

@@ -102,21 +102,14 @@ function isDateTimeLike(value: unknown): value is DateTime {
  *     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.
+ * **Auto-timestamps stack cleanly.** As of the atlas date-engine switch, atlas
+ * hydrates every `@column.date()` / `@column.dateTime()` to a Chronos `DateTime`
+ * by default and `@column.dateTime({ autoCreate, autoUpdate })` stamps
+ * `DateTime.now()` (not a JS `Date`). So tagging the same property with this
+ * adapter is redundant (the default already produces DateTime) and no longer
+ * throws — `prepare` receives a `DateTime`. Reach for this explicit adapter only
+ * when you want DateTime semantics on a column atlas would NOT treat as a date
+ * column (e.g. a plain `@Column()` storing a timestamp).
  *
  * The shape `{ prepare, consume }` is **passable directly** to `@Column(...)`:
  * `@Column(dateTimeAtlasAdapter)` is identical to