ts-time-utils 0.0.1 → 1.0.0

package/dist/esm/performance.d.ts

@@ -91,16 +91,9 @@ export declare function measureTime<T>(fn: () => T): [T, number];
  */
 export declare function measureAsync<T>(fn: () => Promise<T>): Promise<[T, number]>;
 /**
- * Benchmark result interface
+ * Performance measurement and async utilities
  */
-export interface BenchmarkResult {
-    totalTime: number;
-    averageTime: number;
-    minTime: number;
-    maxTime: number;
-    iterations: number;
-    opsPerSecond: number;
-}
+import type { BenchmarkResult } from './types.js';
 /**
  * Benchmark a function by running it multiple times
  * @param fn - function to benchmark

package/dist/esm/performance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"performance.d.ts","sourceRoot":"","sources":["../../src/performance.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,CAAC,EACvB,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,EAAE,EAAE,MAAM,EACV,cAAc,SAAwB,GACrC,OAAO,CAAC,CAAC,CAAC,CAOZ;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACxD,EAAE,EAAE,CAAC,EACL,KAAK,EAAE,MAAM,GACZ,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAOlC;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACxD,EAAE,EAAE,CAAC,EACL,KAAK,EAAE,MAAM,GACZ,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAUlC;AAED;;;;;;GAMG;AACH,wBAAsB,KAAK,CAAC,CAAC,EAC3B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,WAAW,GAAE,MAAU,EACvB,SAAS,GAAE,MAAa,EACxB,QAAQ,GAAE,MAAc,GACvB,OAAO,CAAC,CAAC,CAAC,CAwBZ;AAED;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,UAAU,CAAuB;IAEzC;;OAEG;IACH,KAAK,IAAI,IAAI;IAUb;;OAEG;IACH,IAAI,IAAI,MAAM;IAed;;OAEG;IACH,KAAK,IAAI,IAAI;IAUb;;OAEG;IACH,MAAM,IAAI,IAAI;IAQd;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,UAAU,IAAI,MAAM;IAepB;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,QAAQ,IAAI,OAAO;CAGpB;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,SAAS,CAE3C;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAKvD;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAKhF;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,UAAU,GAAE,MAAa,GAAG,eAAe,CAsBpF"}
+{"version":3,"file":"performance.d.ts","sourceRoot":"","sources":["../../src/performance.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,CAAC,EACvB,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,EAAE,EAAE,MAAM,EACV,cAAc,SAAwB,GACrC,OAAO,CAAC,CAAC,CAAC,CAOZ;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACxD,EAAE,EAAE,CAAC,EACL,KAAK,EAAE,MAAM,GACZ,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAOlC;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACxD,EAAE,EAAE,CAAC,EACL,KAAK,EAAE,MAAM,GACZ,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAUlC;AAED;;;;;;GAMG;AACH,wBAAsB,KAAK,CAAC,CAAC,EAC3B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,WAAW,GAAE,MAAU,EACvB,SAAS,GAAE,MAAa,EACxB,QAAQ,GAAE,MAAc,GACvB,OAAO,CAAC,CAAC,CAAC,CAwBZ;AAED;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,UAAU,CAAuB;IAEzC;;OAEG;IACH,KAAK,IAAI,IAAI;IAUb;;OAEG;IACH,IAAI,IAAI,MAAM;IAed;;OAEG;IACH,KAAK,IAAI,IAAI;IAUb;;OAEG;IACH,MAAM,IAAI,IAAI;IAQd;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,UAAU,IAAI,MAAM;IAepB;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,QAAQ,IAAI,OAAO;CAGpB;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,SAAS,CAE3C;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAKvD;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAKhF;AAED;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,UAAU,GAAE,MAAa,GAAG,eAAe,CAqBpF"}

package/dist/esm/performance.js

@@ -207,16 +207,15 @@ export function benchmark(fn, iterations = 1000) {
         times.push(elapsed);
     }
     const totalTime = times.reduce((sum, time) => sum + time, 0);
-    const averageTime = totalTime / iterations;
-    const minTime = Math.min(...times);
-    const maxTime = Math.max(...times);
-    const opsPerSecond = 1000 / averageTime;
+    const average = totalTime / iterations;
+    const min = Math.min(...times);
+    const max = Math.max(...times);
     return {
         totalTime,
-        averageTime,
-        minTime,
-        maxTime,
+        average,
+        min,
+        max,
         iterations,
-        opsPerSecond
+        total: totalTime
     };
 }

package/dist/esm/rangePresets.d.ts

@@ -1,8 +1,7 @@
-/** Predefined date range helpers (returns [start,end]) */
-export interface DateRange {
-    start: Date;
-    end: Date;
-}
+/**
+ * Predefined date range helpers for common time periods
+ */
+import type { DateRange } from './types.js';
 export declare function today(now?: Date): DateRange;
 export declare function yesterday(now?: Date): DateRange;
 export declare function tomorrow(now?: Date): DateRange;
@@ -18,9 +17,9 @@ export declare function thisYear(now?: Date): DateRange;
 export declare function lastYear(now?: Date): DateRange;
 export declare function nextYear(now?: Date): DateRange;
 export declare function rollingWindowDays(days: number, now?: Date): DateRange;
-export declare function quarterRange(date?: Date): DateRange;
-export declare function lastQuarter(date?: Date): DateRange;
-export declare function nextQuarter(date?: Date): DateRange;
+export declare function quarterRange(now?: Date): DateRange;
+export declare function lastQuarter(now?: Date): DateRange;
+export declare function nextQuarter(now?: Date): DateRange;
 /** Map of preset functions for dynamic access */
 export declare const RANGE_PRESETS: {
     today: typeof today;

package/dist/esm/rangePresets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rangePresets.d.ts","sourceRoot":"","sources":["../../src/rangePresets.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAE1D,MAAM,WAAW,SAAS;IAAG,KAAK,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,IAAI,CAAC;CAAE;AAQtD,wBAAgB,KAAK,CAAC,GAAG,OAAa,GAAG,SAAS,CAA4B;AAC9E,wBAAgB,SAAS,CAAC,GAAG,OAAa,GAAG,SAAS,CAKrD;AAED,wBAAgB,QAAQ,CAAC,GAAG,OAAa,GAAG,SAAS,CAKpD;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,OAAa,GAAG,SAAS,CAIhE;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,OAAa,GAAG,SAAS,CAIhE;AAED,wBAAgB,QAAQ,CAAC,GAAG,OAAa,GAAG,SAAS,CAOpD;AAED,wBAAgB,QAAQ,CAAC,GAAG,OAAa,GAAG,SAAS,CAKpD;AAED,wBAAgB,QAAQ,CAAC,GAAG,OAAa,GAAG,SAAS,CAKpD;AAED,wBAAgB,SAAS,CAAC,GAAG,OAAa,GAAG,SAAS,CAIrD;AAED,wBAAgB,SAAS,CAAC,GAAG,OAAa,GAAG,SAAS,CAKrD;AAED,wBAAgB,SAAS,CAAC,GAAG,OAAa,GAAG,SAAS,CAKrD;AAED,wBAAgB,QAAQ,CAAC,GAAG,OAAa,GAAG,SAAS,CAIpD;AAED,wBAAgB,QAAQ,CAAC,GAAG,OAAa,GAAG,SAAS,CAKpD;AAED,wBAAgB,QAAQ,CAAC,GAAG,OAAa,GAAG,SAAS,CAKpD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAa,GAAG,SAAS,CAI3E;AAED,wBAAgB,YAAY,CAAC,IAAI,OAAa,GAAG,SAAS,CAKzD;AAED,wBAAgB,WAAW,CAAC,IAAI,OAAa,GAAG,SAAS,CAKxD;AAED,wBAAgB,WAAW,CAAC,IAAI,OAAa,GAAG,SAAS,CAKxD;AAED,iDAAiD;AACjD,eAAO,MAAM,aAAa;;;;sBAEN,IAAI;uBACH,IAAI;sBACL,IAAI;;;;;;;;;;;;;CAKvB,CAAC"}
+{"version":3,"file":"rangePresets.d.ts","sourceRoot":"","sources":["../../src/rangePresets.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAQ5C,wBAAgB,KAAK,CAAC,GAAG,OAAa,GAAG,SAAS,CAA4B;AAC9E,wBAAgB,SAAS,CAAC,GAAG,OAAa,GAAG,SAAS,CAKrD;AAED,wBAAgB,QAAQ,CAAC,GAAG,OAAa,GAAG,SAAS,CAKpD;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,OAAa,GAAG,SAAS,CAIhE;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,OAAa,GAAG,SAAS,CAIhE;AAED,wBAAgB,QAAQ,CAAC,GAAG,OAAa,GAAG,SAAS,CAOpD;AAED,wBAAgB,QAAQ,CAAC,GAAG,OAAa,GAAG,SAAS,CAKpD;AAED,wBAAgB,QAAQ,CAAC,GAAG,OAAa,GAAG,SAAS,CAKpD;AAED,wBAAgB,SAAS,CAAC,GAAG,OAAa,GAAG,SAAS,CAIrD;AAED,wBAAgB,SAAS,CAAC,GAAG,OAAa,GAAG,SAAS,CAKrD;AAED,wBAAgB,SAAS,CAAC,GAAG,OAAa,GAAG,SAAS,CAKrD;AAED,wBAAgB,QAAQ,CAAC,GAAG,OAAa,GAAG,SAAS,CAIpD;AAED,wBAAgB,QAAQ,CAAC,GAAG,OAAa,GAAG,SAAS,CAKpD;AAED,wBAAgB,QAAQ,CAAC,GAAG,OAAa,GAAG,SAAS,CAKpD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAa,GAAG,SAAS,CAI3E;AAED,wBAAgB,YAAY,CAAC,GAAG,OAAa,GAAG,SAAS,CAKxD;AAED,wBAAgB,WAAW,CAAC,GAAG,OAAa,GAAG,SAAS,CAKvD;AAED,wBAAgB,WAAW,CAAC,GAAG,OAAa,GAAG,SAAS,CAKvD;AAED,iDAAiD;AACjD,eAAO,MAAM,aAAa;;;;sBAEN,IAAI;uBACH,IAAI;sBACL,IAAI;;;;;;;;;;;;;CAKvB,CAAC"}

package/dist/esm/rangePresets.js

@@ -1,4 +1,6 @@
-/** Predefined date range helpers (returns [start,end]) */
+/**
+ * Predefined date range helpers for common time periods
+ */
 function todayRange(now = new Date()) {
     const start = new Date(now);
     start.setHours(0, 0, 0, 0);
@@ -93,20 +95,20 @@ export function rollingWindowDays(days, now = new Date()) {
     start.setDate(start.getDate() - days);
     return { start, end };
 }
-export function quarterRange(date = new Date()) {
-    const q = Math.floor(date.getMonth() / 3); // 0-3
-    const start = new Date(date.getFullYear(), q * 3, 1);
-    const end = new Date(date.getFullYear(), q * 3 + 3, 1);
+export function quarterRange(now = new Date()) {
+    const q = Math.floor(now.getMonth() / 3); // 0-3
+    const start = new Date(now.getFullYear(), q * 3, 1);
+    const end = new Date(now.getFullYear(), q * 3 + 3, 1);
     return { start, end };
 }
-export function lastQuarter(date = new Date()) {
-    const q = quarterRange(date);
+export function lastQuarter(now = new Date()) {
+    const q = quarterRange(now);
     q.start.setMonth(q.start.getMonth() - 3);
     q.end.setMonth(q.end.getMonth() - 3);
     return q;
 }
-export function nextQuarter(date = new Date()) {
-    const q = quarterRange(date);
+export function nextQuarter(now = new Date()) {
+    const q = quarterRange(now);
     q.start.setMonth(q.start.getMonth() + 3);
     q.end.setMonth(q.end.getMonth() + 3);
     return q;

package/dist/esm/serialize.d.ts

@@ -0,0 +1,73 @@
+import type { DateInput, SerializationOptions, DateObject, EpochTimestamp } from './types.js';
+/**
+ * Safe JSON date serialization and deserialization utilities
+ */
+/**
+ * Safely serialize a date to JSON with various format options
+ */
+export declare function serializeDate(date: DateInput, options?: SerializationOptions): string | number | DateObject;
+/**
+ * Safely deserialize a date from various formats
+ */
+export declare function deserializeDate(serializedDate: string | number | DateObject, options?: SerializationOptions): Date | null;
+/**
+ * Create a safe JSON reviver function for automatic date parsing
+ */
+export declare function createDateReviver(dateKeys?: string[], options?: SerializationOptions): (key: string, value: any) => any;
+/**
+ * Create a safe JSON replacer function for automatic date serialization
+ */
+export declare function createDateReplacer(dateKeys?: string[], options?: SerializationOptions): (key: string, value: any) => any;
+/**
+ * Parse ISO string with better error handling
+ */
+export declare function parseISOString(isoString: string, useUTC?: boolean): Date | null;
+/**
+ * Convert date to epoch timestamp with specified precision
+ */
+export declare function toEpochTimestamp(date: DateInput, precision?: 'milliseconds' | 'seconds' | 'microseconds'): number;
+/**
+ * Create date from epoch timestamp with specified precision
+ */
+export declare function fromEpochTimestamp(timestamp: number, precision?: 'milliseconds' | 'seconds' | 'microseconds'): Date;
+/**
+ * Create epoch timestamp with metadata
+ */
+export declare function createEpochTimestamp(date: DateInput, precision?: 'milliseconds' | 'seconds' | 'microseconds', timezone?: string): EpochTimestamp;
+/**
+ * Convert date to safe object representation
+ */
+export declare function toDateObject(date: DateInput, includeTimezone?: boolean): DateObject;
+/**
+ * Create date from object representation
+ */
+export declare function fromDateObject(dateObj: DateObject): Date;
+/**
+ * Check if a string is a valid ISO date string for serialization
+ */
+export declare function isValidISODateString(dateString: string): boolean;
+/**
+ * Check if a number is a valid epoch timestamp
+ */
+export declare function isValidEpochTimestamp(timestamp: number, precision?: 'milliseconds' | 'seconds' | 'microseconds'): boolean;
+/**
+ * Clone a date safely (avoids reference issues)
+ */
+export declare function cloneDate(date: DateInput): Date | null;
+/**
+ * Compare two dates for equality (ignoring milliseconds if specified)
+ */
+export declare function datesEqual(date1: DateInput, date2: DateInput, precision?: 'milliseconds' | 'seconds' | 'minutes'): boolean;
+/**
+ * Get current timestamp in various formats
+ */
+export declare function now(format?: 'date' | 'iso' | 'epoch-ms' | 'epoch-s'): Date | string | number;
+/**
+ * Safely handle JSON parsing with date conversion
+ */
+export declare function parseJSONWithDates(jsonString: string, dateKeys?: string[], options?: SerializationOptions): any;
+/**
+ * Safely handle JSON stringification with date conversion
+ */
+export declare function stringifyWithDates(obj: any, dateKeys?: string[], options?: SerializationOptions, space?: string | number): string;
+//# sourceMappingURL=serialize.d.ts.map

package/dist/esm/serialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../src/serialize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,oBAAoB,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE9F;;GAEG;AAEH;;GAEG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,SAAS,EACf,OAAO,GAAE,oBAAyB,GACjC,MAAM,GAAG,MAAM,GAAG,UAAU,CAmC9B;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,EAC5C,OAAO,GAAE,oBAAyB,GACjC,IAAI,GAAG,IAAI,CA2Bb;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,GAAE,MAAM,EAAoD,EACpE,OAAO,GAAE,oBAAyB,GACjC,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,GAAG,CAQlC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,GAAE,MAAM,EAAoD,EACpE,OAAO,GAAE,oBAAyB,GACjC,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,GAAG,CAgBlC;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,GAAE,OAAe,GAAG,IAAI,GAAG,IAAI,CA4BtF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,GAAE,cAAc,GAAG,SAAS,GAAG,cAA+B,GAAG,MAAM,CAiBjI;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,SAAS,GAAE,cAAc,GAAG,SAAS,GAAG,cAA+B,GACtE,IAAI,CAiBN;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,SAAS,EACf,SAAS,GAAE,cAAc,GAAG,SAAS,GAAG,cAA+B,EACvE,QAAQ,CAAC,EAAE,MAAM,GAChB,cAAc,CAMhB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE,eAAe,GAAE,OAAe,GAAG,UAAU,CA0B1F;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAsCxD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAOhE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,GAAE,cAAc,GAAG,SAAS,GAAG,cAA+B,GAAG,OAAO,CA0BzI;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,GAAG,IAAI,CAGtD;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,SAAS,EAChB,SAAS,GAAE,cAAc,GAAG,SAAS,GAAG,SAA0B,GACjE,OAAO,CAuBT;AAED;;GAEG;AACH,wBAAgB,GAAG,CAAC,MAAM,GAAE,MAAM,GAAG,KAAK,GAAG,UAAU,GAAG,SAAkB,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,CAcpG;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,EACnB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,GAAG,CAML;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,GAAG,EACR,QAAQ,CAAC,EAAE,MAAM,EAAE,EACnB,OAAO,CAAC,EAAE,oBAAoB,EAC9B,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GACtB,MAAM,CAMR"}

package/dist/esm/serialize.js

@@ -0,0 +1,365 @@
+/**
+ * Safe JSON date serialization and deserialization utilities
+ */
+/**
+ * Safely serialize a date to JSON with various format options
+ */
+export function serializeDate(date, options = {}) {
+    const { format = 'iso', includeTimezone = false, useUTC = false, precision = 'milliseconds', customFormat } = options;
+    const dateObj = normalizeDate(date);
+    if (!dateObj) {
+        throw new Error('Invalid date provided for serialization');
+    }
+    const workingDate = useUTC ? new Date(dateObj.getTime()) : dateObj;
+    switch (format) {
+        case 'iso':
+            return workingDate.toISOString();
+        case 'epoch':
+            return toEpochTimestamp(workingDate, precision);
+        case 'object':
+            return toDateObject(workingDate, includeTimezone);
+        case 'custom':
+            if (!customFormat) {
+                throw new Error('Custom format string required when format is "custom"');
+            }
+            return formatCustom(workingDate, customFormat);
+        default:
+            return workingDate.toISOString();
+    }
+}
+/**
+ * Safely deserialize a date from various formats
+ */
+export function deserializeDate(serializedDate, options = {}) {
+    const { useUTC = false } = options;
+    try {
+        if (typeof serializedDate === 'string') {
+            return parseISOString(serializedDate, useUTC);
+        }
+        if (typeof serializedDate === 'number') {
+            if (isNaN(serializedDate)) {
+                return null;
+            }
+            return fromEpochTimestamp(serializedDate, options.precision || 'milliseconds');
+        }
+        if (typeof serializedDate === 'object' && serializedDate !== null) {
+            try {
+                return fromDateObject(serializedDate);
+            }
+            catch {
+                return null;
+            }
+        }
+        return null;
+    }
+    catch (error) {
+        return null;
+    }
+}
+/**
+ * Create a safe JSON reviver function for automatic date parsing
+ */
+export function createDateReviver(dateKeys = ['createdAt', 'updatedAt', 'date', 'timestamp'], options = {}) {
+    return (key, value) => {
+        if (dateKeys.includes(key) && (typeof value === 'string' || typeof value === 'number')) {
+            const parsed = deserializeDate(value, options);
+            return parsed || value; // Return original value if parsing fails
+        }
+        return value;
+    };
+}
+/**
+ * Create a safe JSON replacer function for automatic date serialization
+ */
+export function createDateReplacer(dateKeys = ['createdAt', 'updatedAt', 'date', 'timestamp'], options = {}) {
+    return (key, value) => {
+        if (dateKeys.includes(key)) {
+            if (value instanceof Date) {
+                return serializeDate(value, options);
+            }
+            // Handle case where Date was already converted to ISO string by JSON.stringify
+            if (typeof value === 'string' && isValidISODateString(value)) {
+                const date = parseISOString(value);
+                if (date) {
+                    return serializeDate(date, options);
+                }
+            }
+        }
+        return value;
+    };
+}
+/**
+ * Parse ISO string with better error handling
+ */
+export function parseISOString(isoString, useUTC = false) {
+    if (!isoString || typeof isoString !== 'string') {
+        return null;
+    }
+    // Handle various ISO formats
+    const cleanedString = isoString.trim();
+    // Check for valid ISO format
+    const isoRegex = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{3})?Z?$/;
+    if (!isoRegex.test(cleanedString)) {
+        // Try to parse anyway, but be more forgiving
+        const relaxedRegex = /^\d{4}-\d{2}-\d{2}(?:T\d{2}:\d{2}:\d{2}(?:\.\d{3})?(?:Z|[+-]\d{2}:\d{2})?)?$/;
+        if (!relaxedRegex.test(cleanedString)) {
+            return null;
+        }
+    }
+    try {
+        const date = new Date(cleanedString);
+        if (isNaN(date.getTime())) {
+            return null;
+        }
+        return useUTC ? new Date(date.getTime() + (date.getTimezoneOffset() * 60000)) : date;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Convert date to epoch timestamp with specified precision
+ */
+export function toEpochTimestamp(date, precision = 'milliseconds') {
+    const dateObj = normalizeDate(date);
+    if (!dateObj) {
+        throw new Error('Invalid date provided for epoch conversion');
+    }
+    const ms = dateObj.getTime();
+    switch (precision) {
+        case 'seconds':
+            return Math.floor(ms / 1000);
+        case 'microseconds':
+            return ms * 1000; // JavaScript doesn't have true microsecond precision
+        case 'milliseconds':
+        default:
+            return ms;
+    }
+}
+/**
+ * Create date from epoch timestamp with specified precision
+ */
+export function fromEpochTimestamp(timestamp, precision = 'milliseconds') {
+    let ms;
+    switch (precision) {
+        case 'seconds':
+            ms = timestamp * 1000;
+            break;
+        case 'microseconds':
+            ms = timestamp / 1000;
+            break;
+        case 'milliseconds':
+        default:
+            ms = timestamp;
+            break;
+    }
+    return new Date(ms);
+}
+/**
+ * Create epoch timestamp with metadata
+ */
+export function createEpochTimestamp(date, precision = 'milliseconds', timezone) {
+    return {
+        timestamp: toEpochTimestamp(date, precision),
+        precision,
+        timezone
+    };
+}
+/**
+ * Convert date to safe object representation
+ */
+export function toDateObject(date, includeTimezone = false) {
+    const dateObj = normalizeDate(date);
+    if (!dateObj) {
+        throw new Error('Invalid date provided for object conversion');
+    }
+    const obj = {
+        year: dateObj.getUTCFullYear(),
+        month: dateObj.getUTCMonth() + 1, // Convert to 1-12
+        day: dateObj.getUTCDate(),
+        hour: dateObj.getUTCHours(),
+        minute: dateObj.getUTCMinutes(),
+        second: dateObj.getUTCSeconds(),
+        millisecond: dateObj.getUTCMilliseconds()
+    };
+    if (includeTimezone) {
+        // Get timezone offset in minutes and convert to string format
+        const offset = dateObj.getTimezoneOffset();
+        const hours = Math.floor(Math.abs(offset) / 60);
+        const minutes = Math.abs(offset) % 60;
+        const sign = offset <= 0 ? '+' : '-';
+        obj.timezone = `${sign}${hours.toString().padStart(2, '0')}:${minutes.toString().padStart(2, '0')}`;
+    }
+    return obj;
+}
+/**
+ * Create date from object representation
+ */
+export function fromDateObject(dateObj) {
+    // Validate required fields
+    if (!dateObj || typeof dateObj !== 'object') {
+        throw new Error('Invalid date object provided');
+    }
+    const { year, month, day, hour = 0, minute = 0, second = 0, millisecond = 0 } = dateObj;
+    if (!year || !month || !day) {
+        throw new Error('Date object must include year, month, and day');
+    }
+    // Validate ranges
+    if (month < 1 || month > 12) {
+        throw new Error('Month must be between 1 and 12');
+    }
+    if (day < 1 || day > 31) {
+        throw new Error('Day must be between 1 and 31');
+    }
+    if (hour < 0 || hour > 23) {
+        throw new Error('Hour must be between 0 and 23');
+    }
+    if (minute < 0 || minute > 59) {
+        throw new Error('Minute must be between 0 and 59');
+    }
+    if (second < 0 || second > 59) {
+        throw new Error('Second must be between 0 and 59');
+    }
+    if (millisecond < 0 || millisecond > 999) {
+        throw new Error('Millisecond must be between 0 and 999');
+    }
+    return new Date(Date.UTC(year, month - 1, day, hour, minute, second, millisecond));
+}
+/**
+ * Check if a string is a valid ISO date string for serialization
+ */
+export function isValidISODateString(dateString) {
+    if (!dateString || typeof dateString !== 'string') {
+        return false;
+    }
+    const parsed = parseISOString(dateString);
+    return parsed !== null;
+}
+/**
+ * Check if a number is a valid epoch timestamp
+ */
+export function isValidEpochTimestamp(timestamp, precision = 'milliseconds') {
+    if (typeof timestamp !== 'number' || isNaN(timestamp)) {
+        return false;
+    }
+    // Check reasonable bounds for timestamps
+    const now = Date.now();
+    let min, max;
+    switch (precision) {
+        case 'seconds':
+            min = 0; // Jan 1, 1970
+            max = Math.floor(now / 1000) + (50 * 365 * 24 * 60 * 60); // 50 years from now
+            break;
+        case 'microseconds':
+            min = 0;
+            max = now * 1000 + (50 * 365 * 24 * 60 * 60 * 1000 * 1000); // 50 years from now
+            break;
+        case 'milliseconds':
+        default:
+            min = 0; // Jan 1, 1970
+            max = now + (50 * 365 * 24 * 60 * 60 * 1000); // 50 years from now
+            break;
+    }
+    return timestamp >= min && timestamp <= max;
+}
+/**
+ * Clone a date safely (avoids reference issues)
+ */
+export function cloneDate(date) {
+    const dateObj = normalizeDate(date);
+    return dateObj ? new Date(dateObj.getTime()) : null;
+}
+/**
+ * Compare two dates for equality (ignoring milliseconds if specified)
+ */
+export function datesEqual(date1, date2, precision = 'milliseconds') {
+    const d1 = normalizeDate(date1);
+    const d2 = normalizeDate(date2);
+    if (!d1 || !d2) {
+        return false;
+    }
+    let time1 = d1.getTime();
+    let time2 = d2.getTime();
+    switch (precision) {
+        case 'seconds':
+            time1 = Math.floor(time1 / 1000);
+            time2 = Math.floor(time2 / 1000);
+            break;
+        case 'minutes':
+            time1 = Math.floor(time1 / 60000);
+            time2 = Math.floor(time2 / 60000);
+            break;
+    }
+    return time1 === time2;
+}
+/**
+ * Get current timestamp in various formats
+ */
+export function now(format = 'date') {
+    const current = new Date();
+    switch (format) {
+        case 'iso':
+            return current.toISOString();
+        case 'epoch-ms':
+            return current.getTime();
+        case 'epoch-s':
+            return Math.floor(current.getTime() / 1000);
+        case 'date':
+        default:
+            return current;
+    }
+}
+/**
+ * Safely handle JSON parsing with date conversion
+ */
+export function parseJSONWithDates(jsonString, dateKeys, options) {
+    try {
+        return JSON.parse(jsonString, createDateReviver(dateKeys, options));
+    }
+    catch (error) {
+        throw new Error(`Failed to parse JSON: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+}
+/**
+ * Safely handle JSON stringification with date conversion
+ */
+export function stringifyWithDates(obj, dateKeys, options, space) {
+    try {
+        return JSON.stringify(obj, createDateReplacer(dateKeys, options), space);
+    }
+    catch (error) {
+        throw new Error(`Failed to stringify JSON: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+}
+// Helper functions
+function normalizeDate(date) {
+    if (date instanceof Date) {
+        return isNaN(date.getTime()) ? null : date;
+    }
+    if (typeof date === 'string') {
+        const parsed = new Date(date);
+        return isNaN(parsed.getTime()) ? null : parsed;
+    }
+    if (typeof date === 'number') {
+        const parsed = new Date(date);
+        return isNaN(parsed.getTime()) ? null : parsed;
+    }
+    return null;
+}
+function formatCustom(date, format) {
+    // Simple custom formatter - can be extended
+    const formatMap = {
+        'YYYY': date.getUTCFullYear().toString(),
+        'MM': (date.getUTCMonth() + 1).toString().padStart(2, '0'),
+        'DD': date.getUTCDate().toString().padStart(2, '0'),
+        'HH': date.getUTCHours().toString().padStart(2, '0'),
+        'mm': date.getUTCMinutes().toString().padStart(2, '0'),
+        'ss': date.getUTCSeconds().toString().padStart(2, '0'),
+        'SSS': date.getUTCMilliseconds().toString().padStart(3, '0')
+    };
+    let result = format;
+    for (const [token, value] of Object.entries(formatMap)) {
+        result = result.replace(new RegExp(token, 'g'), value);
+    }
+    return result;
+}

package/dist/esm/timezone.d.ts

@@ -1,11 +1,7 @@
 /**
- * Timezone utilities (rely on Intl API, fallbacks where possible)
+ * Timezone utilities using Intl API with fallbacks
  */
-export interface ZonedTime {
-    date: Date;
-    zone: string;
-    offsetMinutes: number;
-}
+import type { ZonedTime } from './types.js';
 /** Get offset (minutes) for a zone at a given date */
 export declare function getTimezoneOffset(zone: string, date?: Date): number | null;
 /** Format date/time in a zone */

package/dist/esm/timezone.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"timezone.d.ts","sourceRoot":"","sources":["../../src/timezone.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,sDAAsD;AACtD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,IAAiB,GAAG,MAAM,GAAG,IAAI,CAgBtF;AAED,iCAAiC;AACjC,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,IAAI,CAAC,qBAA0B,GAAG,MAAM,CAG3G;AAED,yCAAyC;AACzC,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAIvE;AAED,qFAAqF;AACrF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;CAAE,GAAG,IAAI,CAoB9J;AAED,yDAAyD;AACzD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOrD;AAED,uEAAuE;AACvE,eAAO,MAAM,gBAAgB,UAK5B,CAAC;AAEF,0CAA0C;AAC1C,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,iDAAiD;AACjD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,IAAiB,GAAG,MAAM,GAAG,IAAI,CAKvG;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAI7E"}
+{"version":3,"file":"timezone.d.ts","sourceRoot":"","sources":["../../src/timezone.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,sDAAsD;AACtD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,IAAiB,GAAG,MAAM,GAAG,IAAI,CAgBtF;AAED,iCAAiC;AACjC,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,IAAI,CAAC,qBAA0B,GAAG,MAAM,CAG3G;AAED,yCAAyC;AACzC,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAIvE;AAED,qFAAqF;AACrF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;CAAE,GAAG,IAAI,CAoB9J;AAED,yDAAyD;AACzD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOrD;AAED,uEAAuE;AACvE,eAAO,MAAM,gBAAgB,UAK5B,CAAC;AAEF,0CAA0C;AAC1C,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,iDAAiD;AACjD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,IAAiB,GAAG,MAAM,GAAG,IAAI,CAKvG;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAI7E"}

package/dist/esm/timezone.js

@@ -1,5 +1,5 @@
 /**
- * Timezone utilities (rely on Intl API, fallbacks where possible)
+ * Timezone utilities using Intl API with fallbacks
  */
 /** Get offset (minutes) for a zone at a given date */
 export function getTimezoneOffset(zone, date = new Date()) {