@minnowdb/core 0.6.8 → 0.7.0

package/README.md

@@ -17,7 +17,7 @@ npm install @minnowdb/core
 - A ready-made worker client with the same everyday database API.
 - TypeScript schema declarations and metadata-only migrations, including SQL domains,
   composite primary/foreign keys, and informational relationships.
-- Guarded columnar upserts, result-column SQL domains, typed catalog errors, and batch writes.
+- Batch and upsert write APIs, typed catalog errors, and per-column result type metadata.
 - Pull-driven query cursors, live queries, snapshots, compaction, and configurable query memory.
 
 Use [the PostgreSQL compatibility page](https://minnowdb.com/docs/sql/feature-matrix/) for the
@@ -27,7 +27,8 @@ workers, transactions, and API details.
 The optional [Kysely dialect](https://minnowdb.com/docs/adapters/kysely/) connects Kysely's
 PostgreSQL compiler to the engine and derives its `DB` types from the same schema declaration.
 
-Every `@minnowdb` package in one application must use the same major version. See
+Minnow is 0.x: breaking changes land in minor releases, so pin exact versions and upgrade
+`@minnowdb` packages together. See
 [Versioning](https://minnowdb.com/docs/reference/versioning/).
 
 ## License

package/dist/date-value.d.ts

@@ -13,3 +13,8 @@ export declare function dateUtcMinutes(value: Date): number;
 export declare function dateUtcSeconds(value: Date): number;
 export declare function setDateUtcDate(value: Date, day: number): number;
 export declare function setDateUtcMonth(value: Date, month: number): number;
+/** Whole days since 1970-01-01 for an epoch-millisecond value (floored, so negatives work). */
+export declare function epochDays(milliseconds: number): number;
+export declare function civilFromDays(days: number): readonly [number, number, number];
+/** Days since 1970-01-01 for a civil date; month is 0-11 as in Date.UTC. */
+export declare function daysFromCivil(year: number, month: number, day: number): number;

package/dist/date-value.js

@@ -62,3 +62,44 @@ export function setDateUtcDate(value, day) {
 export function setDateUtcMonth(value, month) {
     return intrinsicDateSetUtcMonth.call(value, month);
 }
+const MS_PER_DAY = 86_400_000;
+/** Whole days since 1970-01-01 for an epoch-millisecond value (floored, so negatives work). */
+export function epochDays(milliseconds) {
+    return Math.floor(milliseconds / MS_PER_DAY);
+}
+/**
+ * Proleptic Gregorian civil date for a day count since 1970-01-01, without a Date allocation
+ * (Howard Hinnant's days-to-civil algorithm). Returns [year, month (0-11), day (1-31)] in a
+ * shared scratch array: callers read it before the next call.
+ */
+const civilScratch = [0, 0, 0];
+export function civilFromDays(days) {
+    const z = days + 719_468;
+    const era = Math.floor(z / 146_097);
+    const dayOfEra = z - era * 146_097;
+    const yearOfEra = (dayOfEra -
+        Math.floor(dayOfEra / 1460) +
+        Math.floor(dayOfEra / 36_524) -
+        Math.floor(dayOfEra / 146_096)) /
+        365;
+    const yoe = Math.floor(yearOfEra);
+    const dayOfYear = dayOfEra - (365 * yoe + Math.floor(yoe / 4) - Math.floor(yoe / 100));
+    const mp = Math.floor((5 * dayOfYear + 2) / 153);
+    const day = dayOfYear - Math.floor((153 * mp + 2) / 5) + 1;
+    const month = mp < 10 ? mp + 2 : mp - 10;
+    const year = yoe + era * 400 + (month <= 1 ? 1 : 0);
+    civilScratch[0] = year;
+    civilScratch[1] = month;
+    civilScratch[2] = day;
+    return civilScratch;
+}
+/** Days since 1970-01-01 for a civil date; month is 0-11 as in Date.UTC. */
+export function daysFromCivil(year, month, day) {
+    const y = month <= 1 ? year - 1 : year;
+    const era = Math.floor(y / 400);
+    const yoe = y - era * 400;
+    const mp = month > 1 ? month - 2 : month + 10;
+    const dayOfYear = Math.floor((153 * mp + 2) / 5) + day - 1;
+    const dayOfEra = yoe * 365 + Math.floor(yoe / 4) - Math.floor(yoe / 100) + dayOfYear;
+    return era * 146_097 + dayOfEra - 719_468;
+}