@reifydb/core 0.0.1 → 0.1.1

package/dist/value/date.js

@@ -0,0 +1,261 @@
+/**
+ * MIT License
+ * Copyright (c) 2025 ReifyDB
+ * See license.md file for full license text
+ */
+import { UNDEFINED_VALUE } from "../constant";
+/**
+ * A date value representing a calendar date (year, month, day) without time information.
+ * Always interpreted in UTC.
+ * Internally stored as months and days.
+ */
+export class DateValue {
+    constructor(value) {
+        this.type = "Date";
+        if (value !== undefined) {
+            if (value instanceof Date) {
+                // Remove time component - set to UTC midnight
+                const year = value.getUTCFullYear();
+                const month = value.getUTCMonth() + 1; // Convert to 1-based
+                const day = value.getUTCDate();
+                this.months = year * 12 + (month - 1);
+                this.days = day;
+            }
+            else if (typeof value === 'string') {
+                // Parse YYYY-MM-DD format
+                const parsed = DateValue.parseDate(value);
+                if (!parsed) {
+                    throw new Error(`Invalid date string: ${value}`);
+                }
+                this.months = parsed.months;
+                this.days = parsed.days;
+            }
+            else if (typeof value === 'number') {
+                // Interpret as days since epoch
+                const date = DateValue.fromDaysSinceEpochToComponents(value);
+                if (!date) {
+                    throw new Error(`Invalid days since epoch: ${value}`);
+                }
+                this.months = date.months;
+                this.days = date.days;
+            }
+            else {
+                throw new Error(`Date value must be a Date, string, or number, got ${typeof value}`);
+            }
+        }
+        else {
+            this.months = undefined;
+            this.days = undefined;
+        }
+    }
+    /**
+     * Create a DateValue from year, month (1-12), and day (1-31)
+     */
+    static fromYMD(year, month, day) {
+        // Validate the date is valid
+        if (!DateValue.isValidDate(year, month, day)) {
+            throw new Error(`Invalid date: ${year}-${String(month).padStart(2, '0')}-${String(day).padStart(2, '0')}`);
+        }
+        const result = new DateValue(undefined);
+        result.months = year * 12 + (month - 1);
+        result.days = day;
+        return result;
+    }
+    /**
+     * Get today's date (in UTC)
+     */
+    static today() {
+        const now = new Date();
+        return DateValue.fromYMD(now.getUTCFullYear(), now.getUTCMonth() + 1, now.getUTCDate());
+    }
+    /**
+     * Parse a date string in YYYY-MM-DD format
+     */
+    static parse(str) {
+        const trimmed = str.trim();
+        if (trimmed === '' || trimmed === UNDEFINED_VALUE) {
+            return new DateValue(undefined);
+        }
+        const parsed = DateValue.parseDate(trimmed);
+        if (!parsed) {
+            throw new Error(`Cannot parse "${str}" as Date`);
+        }
+        const result = new DateValue(undefined);
+        result.months = parsed.months;
+        result.days = parsed.days;
+        return result;
+    }
+    /**
+     * Convert to days since Unix epoch (1970-01-01) for storage
+     */
+    toDaysSinceEpoch() {
+        if (this.months === undefined || this.days === undefined) {
+            return undefined;
+        }
+        const year = Math.floor(this.months / 12);
+        // Handle negative months correctly
+        let m = this.months % 12;
+        if (m < 0)
+            m += 12;
+        const month = m + 1;
+        // Create date with special handling for years < 100
+        let date;
+        if (year >= 0 && year < 100) {
+            date = new Date(Date.UTC(2000, month - 1, this.days));
+            date.setUTCFullYear(year);
+        }
+        else {
+            date = new Date(Date.UTC(year, month - 1, this.days));
+        }
+        const epoch = new Date(Date.UTC(1970, 0, 1));
+        const diffMs = date.getTime() - epoch.getTime();
+        return Math.floor(diffMs / (1000 * 60 * 60 * 24));
+    }
+    /**
+     * Create from days since Unix epoch
+     */
+    static fromDaysSinceEpochToComponents(days) {
+        const epoch = new Date(Date.UTC(1970, 0, 1));
+        const ms = days * 24 * 60 * 60 * 1000;
+        const date = new Date(epoch.getTime() + ms);
+        // Check for valid date
+        if (!isFinite(date.getTime())) {
+            return null;
+        }
+        const year = date.getUTCFullYear();
+        const month = date.getUTCMonth() + 1;
+        const day = date.getUTCDate();
+        return {
+            months: year * 12 + (month - 1),
+            days: day
+        };
+    }
+    /**
+     * Get the year component
+     */
+    year() {
+        if (this.months === undefined)
+            return undefined;
+        return Math.floor(this.months / 12);
+    }
+    /**
+     * Get the month component (1-12)
+     */
+    month() {
+        if (this.months === undefined)
+            return undefined;
+        // Handle negative months correctly
+        let m = this.months % 12;
+        if (m < 0)
+            m += 12;
+        return m + 1;
+    }
+    /**
+     * Get the day component (1-31)
+     */
+    day() {
+        return this.days;
+    }
+    /**
+     * Format as YYYY-MM-DD string
+     */
+    toString() {
+        if (this.months === undefined || this.days === undefined) {
+            return 'undefined';
+        }
+        const year = Math.floor(this.months / 12);
+        // Handle negative months correctly
+        let m = this.months % 12;
+        if (m < 0)
+            m += 12;
+        const month = String(m + 1).padStart(2, '0');
+        const day = String(this.days).padStart(2, '0');
+        // Handle negative years (BC dates)
+        if (year < 0) {
+            const absYear = Math.abs(year);
+            return `-${String(absYear).padStart(4, '0')}-${month}-${day}`;
+        }
+        else {
+            return `${String(year).padStart(4, '0')}-${month}-${day}`;
+        }
+    }
+    valueOf() {
+        if (this.months === undefined || this.days === undefined) {
+            return undefined;
+        }
+        const year = Math.floor(this.months / 12);
+        // Handle negative months correctly
+        let m = this.months % 12;
+        if (m < 0)
+            m += 12;
+        const month = m + 1;
+        // Handle years < 100 specially
+        let date;
+        if (year >= 0 && year < 100) {
+            date = new Date(Date.UTC(2000, month - 1, this.days));
+            date.setUTCFullYear(year);
+        }
+        else {
+            date = new Date(Date.UTC(year, month - 1, this.days));
+        }
+        return date;
+    }
+    /**
+     * Get the internal representation
+     */
+    get value() {
+        return this.valueOf();
+    }
+    /**
+     * Helper to parse YYYY-MM-DD format
+     */
+    static parseDate(str) {
+        // Match YYYY-MM-DD format, including negative years
+        const match = str.match(/^(-?\d{1,4})-(\d{2})-(\d{2})$/);
+        if (!match) {
+            return null;
+        }
+        const year = parseInt(match[1], 10);
+        const month = parseInt(match[2], 10);
+        const day = parseInt(match[3], 10);
+        // Validate month and day ranges
+        if (month < 1 || month > 12) {
+            return null;
+        }
+        if (day < 1 || day > 31) {
+            return null;
+        }
+        // Validate the date is valid (e.g., no Feb 30)
+        if (!DateValue.isValidDate(year, month, day)) {
+            return null;
+        }
+        return {
+            months: year * 12 + (month - 1),
+            days: day
+        };
+    }
+    /**
+     * Helper to validate a date
+     */
+    static isValidDate(year, month, day) {
+        // Create a date and check if components match
+        let date;
+        if (year >= 0 && year < 100) {
+            date = new Date(Date.UTC(2000, month - 1, day));
+            date.setUTCFullYear(year);
+        }
+        else {
+            date = new Date(Date.UTC(year, month - 1, day));
+        }
+        return date.getUTCFullYear() === year &&
+            date.getUTCMonth() === month - 1 &&
+            date.getUTCDate() === day;
+    }
+    encode() {
+        return {
+            type: this.type,
+            value: this.value === undefined ? UNDEFINED_VALUE : this.toString()
+        };
+    }
+}
+//# sourceMappingURL=date.js.map

package/dist/value/date.js.map

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

package/dist/value/datetime.d.ts

@@ -0,0 +1,99 @@
+/**
+ * MIT License
+ * Copyright (c) 2025 ReifyDB
+ * See license.md file for full license text
+ */
+import { Type, Value, TypeValuePair } from ".";
+import { DateValue } from "./date";
+import { TimeValue } from "./time";
+/**
+ * A date and time value with nanosecond precision.
+ * Always in UTC timezone.
+ * Internally stored as months, days, and nanoseconds.
+ */
+export declare class DateTimeValue implements Value {
+    readonly type: Type;
+    private readonly months?;
+    private readonly days?;
+    private readonly nanos?;
+    constructor(value?: Date | string | number | bigint);
+    /**
+     * Create a DateTimeValue from year, month, day, hour, minute, second, nanosecond
+     */
+    static fromYMDHMSN(year: number, month: number, day: number, hour: number, minute: number, second: number, nano?: number): DateTimeValue;
+    /**
+     * Create a DateTimeValue from year, month, day, hour, minute, second (no fractional)
+     */
+    static fromYMDHMS(year: number, month: number, day: number, hour: number, minute: number, second: number): DateTimeValue;
+    /**
+     * Create from Unix timestamp in seconds
+     */
+    static fromTimestamp(seconds: number): DateTimeValue;
+    /**
+     * Create from Unix timestamp in milliseconds
+     */
+    static fromTimestampMillis(millis: number): DateTimeValue;
+    /**
+     * Create from nanoseconds since Unix epoch
+     */
+    static fromNanosSinceEpoch(nanos: bigint): DateTimeValue;
+    /**
+     * Create from separate seconds and nanoseconds
+     */
+    static fromParts(seconds: number, nanos: number): DateTimeValue;
+    /**
+     * Get current datetime
+     */
+    static now(): DateTimeValue;
+    /**
+     * Get default datetime (Unix epoch)
+     */
+    static default(): DateTimeValue;
+    /**
+     * Parse a datetime string in ISO 8601 format
+     */
+    static parse(str: string): DateTimeValue;
+    /**
+     * Get Unix timestamp in seconds
+     */
+    timestamp(): number | undefined;
+    /**
+     * Get Unix timestamp in nanoseconds
+     */
+    timestampNanos(): bigint | undefined;
+    /**
+     * Convert to nanoseconds since Unix epoch for storage
+     */
+    toNanosSinceEpoch(): bigint | undefined;
+    /**
+     * Get separate seconds and nanoseconds for storage
+     */
+    toParts(): [number, number] | undefined;
+    /**
+     * Get the date component
+     */
+    date(): DateValue | undefined;
+    /**
+     * Get the time component
+     */
+    time(): TimeValue | undefined;
+    /**
+     * Format as ISO 8601 string with nanosecond precision and Z suffix
+     */
+    toString(): string;
+    valueOf(): Date | undefined;
+    /**
+     * Get the internal representation as a Date
+     */
+    get value(): Date | undefined;
+    /**
+     * Helper to parse ISO 8601 datetime format
+     */
+    private static parseDateTime;
+    /**
+     * Helper to validate a date
+     */
+    private static isValidDate;
+    encode(): TypeValuePair;
+}
+//# sourceMappingURL=datetime.d.ts.map

package/dist/value/datetime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"datetime.d.ts","sourceRoot":"","sources":["../../src/value/datetime.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAC,IAAI,EAAE,KAAK,EAAE,aAAa,EAAC,MAAM,GAAG,CAAC;AAE7C,OAAO,EAAC,SAAS,EAAC,MAAM,QAAQ,CAAC;AACjC,OAAO,EAAC,SAAS,EAAC,MAAM,QAAQ,CAAC;AAEjC;;;;GAIG;AACH,qBAAa,aAAc,YAAW,KAAK;IACvC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAuB;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAS;gBAEpB,KAAK,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM;IA2EnD;;OAEG;IACH,MAAM,CAAC,WAAW,CACd,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,MAAU,GACjB,aAAa;IA8BhB;;OAEG;IACH,MAAM,CAAC,UAAU,CACb,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACf,aAAa;IAIhB;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa;IAIpD;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa;IAIzD;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa;IAIxD;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa;IAe/D;;OAEG;IACH,MAAM,CAAC,GAAG,IAAI,aAAa;IAI3B;;OAEG;IACH,MAAM,CAAC,OAAO,IAAI,aAAa;IAI/B;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa;IAmBxC;;OAEG;IACH,SAAS,IAAI,MAAM,GAAG,SAAS;IAM/B;;OAEG;IACH,cAAc,IAAI,MAAM,GAAG,SAAS;IAcpC;;OAEG;IACH,iBAAiB,IAAI,MAAM,GAAG,SAAS;IAIvC;;OAEG;IACH,OAAO,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS;IAWvC;;OAEG;IACH,IAAI,IAAI,SAAS,GAAG,SAAS;IAU7B;;OAEG;IACH,IAAI,IAAI,SAAS,GAAG,SAAS;IAK7B;;OAEG;IACH,QAAQ,IAAI,MAAM;IAsClB,OAAO,IAAI,IAAI,GAAG,SAAS;IAiC3B;;OAEG;IACH,IAAI,KAAK,IAAI,IAAI,GAAG,SAAS,CAE5B;IAED;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAqD5B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,WAAW;IAe1B,MAAM,IAAI,aAAa;CAM1B"}