@rvoh/dream 2.3.0-alpha.7 → 2.3.0-alpha.9

package/dist/cjs/src/dream-app/index.js

@@ -16,6 +16,7 @@ import expandStiClasses from '../helpers/sti/expandStiClasses.js';
 import inferSerializerFromDreamOrViewModel, { inferSerializersFromDreamClassOrViewModelClass, } from '../serializer/helpers/inferSerializerFromDreamOrViewModel.js';
 import isDreamSerializer from '../serializer/helpers/isDreamSerializer.js';
 import serializerNameFromFullyQualifiedModelName from '../serializer/helpers/serializerNameFromFullyQualifiedModelName.js';
+import BaseClockTime from '../utils/datetime/BaseClockTime.js';
 import CalendarDate from '../utils/datetime/CalendarDate.js';
 import { DateTime, Settings } from '../utils/datetime/DateTime.js';
 import { cacheDreamApp, getCachedDreamAppOrFail } from './cache.js';
@@ -164,13 +165,13 @@ Try setting it to something valid, like:
         return getCachedDreamAppOrFail();
     }
     static log(...args) {
-        this.getOrFail().logger.info(this.argsToString(args));
+        this.getOrFail().logger.info(this.loggerArgsToString(args));
     }
     static logWithLevel(level, ...args) {
-        this.getOrFail().logger[level](this.argsToString(args));
+        this.getOrFail().logger[level](this.loggerArgsToString(args));
     }
-    static argsToString(args) {
-        return args.map(argToString).join(' ');
+    static loggerArgsToString(args) {
+        return args.map(loggerArgToString).join(' ');
     }
     _specialHooks = {
         dbLog: [],
@@ -404,16 +405,17 @@ Try setting it to something valid, like:
         }
     }
 }
-function argToString(arg) {
+function loggerArgToString(arg) {
     if (typeof arg === 'string')
         return arg;
     if (typeof arg === 'number')
         return arg;
     if (typeof arg === 'boolean')
         return arg;
-    if (arg instanceof DateTime || arg instanceof CalendarDate)
+    if (arg instanceof DateTime || arg instanceof CalendarDate || arg instanceof BaseClockTime) {
         return arg.toISO();
-    return util.inspect(arg, { depth: 3 });
+    }
+    return JSON.stringify(util.inspect(arg, { depth: 6 }));
 }
 export const DreamAppAllowedPackageManagersEnumValues = ['pnpm', 'yarn', 'npm'];
 // GeneratorImportStyles are used by CLI generators to determine how

package/dist/cjs/src/helpers/db/normalizeDataForDb.js

@@ -38,10 +38,10 @@ function normalizedString(_val) {
     return alreadyAnArray ? normalizedValueArray : normalizedValueArray[0];
 }
 function dateTimeOrDateToSql(dateClass, _val) {
-    if (_val === null || _val === undefined)
-        return _val;
     const alreadyAnArray = Array.isArray(_val);
     const normalizedValueArray = (alreadyAnArray ? _val : [_val]).map(val => {
+        if (val === null || val === undefined)
+            return val;
         if (val instanceof DateTime || val instanceof CalendarDate)
             return val.toSQL();
         try {
@@ -59,10 +59,10 @@ function dateTimeOrDateToSql(dateClass, _val) {
     return alreadyAnArray ? normalizedValueArray : normalizedValueArray[0];
 }
 function clockTimeOrClockTimeTzToSql(clockTimeClass, _val) {
-    if (_val === null || _val === undefined)
-        return _val;
     const alreadyAnArray = Array.isArray(_val);
     const normalizedValueArray = (alreadyAnArray ? _val : [_val]).map(val => {
+        if (val === null || val === undefined)
+            return val;
         if (val instanceof BaseClockTime)
             return val.toSQL();
         try {

package/dist/cjs/src/utils/datetime/DateTime.js

@@ -13,8 +13,9 @@ export const BASE_DATE_OBJECT = {
  * DateTime wraps Luxon DateTime with microsecond precision (0-999).
  * The decimal part in ISO/SQL is 6 digits: first 3 = milliseconds, next 3 = microseconds.
  *
- * Full datetime output (toISO, toSQL) is normalized to UTC.
+ * Full datetime output with toSQL() is normalized to UTC.
  * Time-only output (toISOTime, toSQLTime) omits timezone offset by default.
+ * toISO() preserves the timezone of the DateTime instance.
  */
 export class DateTime {
     luxonDatetime;
@@ -568,7 +569,7 @@ export class DateTime {
     /**
      * Returns an ISO 8601 string with 6 fractional second digits (milliseconds + microseconds).
      *
-     * Always converts to UTC before formatting (e.g., '2024-03-15T15:30:45.123456Z').
+     * Preserves the timezone of the DateTime instance.
      *
      * @param opts - Optional format options
      * @param opts.suppressMilliseconds - If true, omits fractional seconds when they are zero
@@ -578,12 +579,11 @@ export class DateTime {
      * @returns ISO string (e.g. "2024-03-15T10:30:45.123456-05:00" or "2024-03-15T10:30:45.123456Z")
      * @example
      * ```ts
-     * DateTime.fromISO('2024-03-15T10:30:45.123456').toISO() // Converts to UTC
+     * DateTime.fromISO('2024-03-15T10:30:45.123456-05:00').toISO() // '2024-03-15T10:30:45.123456-05:00'
      * ```
      */
     toISO(opts) {
-        const dt = this.toUTC();
-        return replaceISOMicroseconds(dt, dt.luxonDatetime.toISO(opts), opts);
+        return replaceISOMicroseconds(this, this.luxonDatetime.toISO(opts), opts);
     }
     /**
      * Returns an ISO date string (date only, no time).
@@ -681,12 +681,12 @@ export class DateTime {
     /**
      * Returns an ISO 8601 string representation (for valueOf() operations).
      *
-     * Converts to UTC before formatting.
+     * Preserves the timezone of the DateTime instance.
      *
      * @returns ISO datetime string with microsecond precision
      * @example
      * ```ts
-     * DateTime.local(2017, 3, 12).valueOf() // Converts to UTC
+     * DateTime.local(2017, 3, 12).valueOf() // Preserves local timezone
      * DateTime.fromISO('2026-02-07T09:03:44.123456Z').valueOf()              // '2026-02-07T09:03:44.123456Z'
      * ```
      */
@@ -701,7 +701,7 @@ export class DateTime {
      * Returns an ISO 8601 formatted string for JSON serialization.
      * This ensures DateTime objects are properly serialized to ISO format.
      *
-     * Converts to UTC before formatting.
+     * Preserves the timezone of the DateTime instance.
      *
      * @returns ISO datetime string with microsecond precision
      * @example
@@ -717,7 +717,7 @@ export class DateTime {
      * Returns an ISO 8601 formatted string representation.
      * Alias for toISO().
      *
-     * Converts to UTC before formatting.
+     * Preserves the timezone of the DateTime instance.
      *
      * @returns ISO datetime string with microsecond precision
      * @example
@@ -1015,8 +1015,7 @@ export class DateTime {
      */
     startOf(unit, opts) {
         const luxonDatetime = this.luxonDatetime.startOf(unit, opts);
-        const microseconds = unit === 'millisecond' ? this.microsecond : 0;
-        return new DateTime(luxonDatetime, microseconds);
+        return new DateTime(luxonDatetime, 0);
     }
     /**
      * Returns a new DateTime at the end of the given unit.
@@ -1032,8 +1031,7 @@ export class DateTime {
      */
     endOf(unit, opts) {
         const luxonDatetime = this.luxonDatetime.endOf(unit, opts);
-        const microseconds = unit === 'millisecond' ? this.microsecond : 999;
-        return new DateTime(luxonDatetime, microseconds);
+        return new DateTime(luxonDatetime, 999);
     }
     /**
      * Returns a new DateTime with the given locale/zone options. Microsecond is preserved.

package/dist/esm/src/dream-app/index.js

@@ -16,6 +16,7 @@ import expandStiClasses from '../helpers/sti/expandStiClasses.js';
 import inferSerializerFromDreamOrViewModel, { inferSerializersFromDreamClassOrViewModelClass, } from '../serializer/helpers/inferSerializerFromDreamOrViewModel.js';
 import isDreamSerializer from '../serializer/helpers/isDreamSerializer.js';
 import serializerNameFromFullyQualifiedModelName from '../serializer/helpers/serializerNameFromFullyQualifiedModelName.js';
+import BaseClockTime from '../utils/datetime/BaseClockTime.js';
 import CalendarDate from '../utils/datetime/CalendarDate.js';
 import { DateTime, Settings } from '../utils/datetime/DateTime.js';
 import { cacheDreamApp, getCachedDreamAppOrFail } from './cache.js';
@@ -164,13 +165,13 @@ Try setting it to something valid, like:
         return getCachedDreamAppOrFail();
     }
     static log(...args) {
-        this.getOrFail().logger.info(this.argsToString(args));
+        this.getOrFail().logger.info(this.loggerArgsToString(args));
     }
     static logWithLevel(level, ...args) {
-        this.getOrFail().logger[level](this.argsToString(args));
+        this.getOrFail().logger[level](this.loggerArgsToString(args));
     }
-    static argsToString(args) {
-        return args.map(argToString).join(' ');
+    static loggerArgsToString(args) {
+        return args.map(loggerArgToString).join(' ');
     }
     _specialHooks = {
         dbLog: [],
@@ -404,16 +405,17 @@ Try setting it to something valid, like:
         }
     }
 }
-function argToString(arg) {
+function loggerArgToString(arg) {
     if (typeof arg === 'string')
         return arg;
     if (typeof arg === 'number')
         return arg;
     if (typeof arg === 'boolean')
         return arg;
-    if (arg instanceof DateTime || arg instanceof CalendarDate)
+    if (arg instanceof DateTime || arg instanceof CalendarDate || arg instanceof BaseClockTime) {
         return arg.toISO();
-    return util.inspect(arg, { depth: 3 });
+    }
+    return JSON.stringify(util.inspect(arg, { depth: 6 }));
 }
 export const DreamAppAllowedPackageManagersEnumValues = ['pnpm', 'yarn', 'npm'];
 // GeneratorImportStyles are used by CLI generators to determine how

package/dist/esm/src/helpers/db/normalizeDataForDb.js

@@ -38,10 +38,10 @@ function normalizedString(_val) {
     return alreadyAnArray ? normalizedValueArray : normalizedValueArray[0];
 }
 function dateTimeOrDateToSql(dateClass, _val) {
-    if (_val === null || _val === undefined)
-        return _val;
     const alreadyAnArray = Array.isArray(_val);
     const normalizedValueArray = (alreadyAnArray ? _val : [_val]).map(val => {
+        if (val === null || val === undefined)
+            return val;
         if (val instanceof DateTime || val instanceof CalendarDate)
             return val.toSQL();
         try {
@@ -59,10 +59,10 @@ function dateTimeOrDateToSql(dateClass, _val) {
     return alreadyAnArray ? normalizedValueArray : normalizedValueArray[0];
 }
 function clockTimeOrClockTimeTzToSql(clockTimeClass, _val) {
-    if (_val === null || _val === undefined)
-        return _val;
     const alreadyAnArray = Array.isArray(_val);
     const normalizedValueArray = (alreadyAnArray ? _val : [_val]).map(val => {
+        if (val === null || val === undefined)
+            return val;
         if (val instanceof BaseClockTime)
             return val.toSQL();
         try {

package/dist/esm/src/utils/datetime/DateTime.js

@@ -13,8 +13,9 @@ export const BASE_DATE_OBJECT = {
  * DateTime wraps Luxon DateTime with microsecond precision (0-999).
  * The decimal part in ISO/SQL is 6 digits: first 3 = milliseconds, next 3 = microseconds.
  *
- * Full datetime output (toISO, toSQL) is normalized to UTC.
+ * Full datetime output with toSQL() is normalized to UTC.
  * Time-only output (toISOTime, toSQLTime) omits timezone offset by default.
+ * toISO() preserves the timezone of the DateTime instance.
  */
 export class DateTime {
     luxonDatetime;
@@ -568,7 +569,7 @@ export class DateTime {
     /**
      * Returns an ISO 8601 string with 6 fractional second digits (milliseconds + microseconds).
      *
-     * Always converts to UTC before formatting (e.g., '2024-03-15T15:30:45.123456Z').
+     * Preserves the timezone of the DateTime instance.
      *
      * @param opts - Optional format options
      * @param opts.suppressMilliseconds - If true, omits fractional seconds when they are zero
@@ -578,12 +579,11 @@ export class DateTime {
      * @returns ISO string (e.g. "2024-03-15T10:30:45.123456-05:00" or "2024-03-15T10:30:45.123456Z")
      * @example
      * ```ts
-     * DateTime.fromISO('2024-03-15T10:30:45.123456').toISO() // Converts to UTC
+     * DateTime.fromISO('2024-03-15T10:30:45.123456-05:00').toISO() // '2024-03-15T10:30:45.123456-05:00'
      * ```
      */
     toISO(opts) {
-        const dt = this.toUTC();
-        return replaceISOMicroseconds(dt, dt.luxonDatetime.toISO(opts), opts);
+        return replaceISOMicroseconds(this, this.luxonDatetime.toISO(opts), opts);
     }
     /**
      * Returns an ISO date string (date only, no time).
@@ -681,12 +681,12 @@ export class DateTime {
     /**
      * Returns an ISO 8601 string representation (for valueOf() operations).
      *
-     * Converts to UTC before formatting.
+     * Preserves the timezone of the DateTime instance.
      *
      * @returns ISO datetime string with microsecond precision
      * @example
      * ```ts
-     * DateTime.local(2017, 3, 12).valueOf() // Converts to UTC
+     * DateTime.local(2017, 3, 12).valueOf() // Preserves local timezone
      * DateTime.fromISO('2026-02-07T09:03:44.123456Z').valueOf()              // '2026-02-07T09:03:44.123456Z'
      * ```
      */
@@ -701,7 +701,7 @@ export class DateTime {
      * Returns an ISO 8601 formatted string for JSON serialization.
      * This ensures DateTime objects are properly serialized to ISO format.
      *
-     * Converts to UTC before formatting.
+     * Preserves the timezone of the DateTime instance.
      *
      * @returns ISO datetime string with microsecond precision
      * @example
@@ -717,7 +717,7 @@ export class DateTime {
      * Returns an ISO 8601 formatted string representation.
      * Alias for toISO().
      *
-     * Converts to UTC before formatting.
+     * Preserves the timezone of the DateTime instance.
      *
      * @returns ISO datetime string with microsecond precision
      * @example
@@ -1015,8 +1015,7 @@ export class DateTime {
      */
     startOf(unit, opts) {
         const luxonDatetime = this.luxonDatetime.startOf(unit, opts);
-        const microseconds = unit === 'millisecond' ? this.microsecond : 0;
-        return new DateTime(luxonDatetime, microseconds);
+        return new DateTime(luxonDatetime, 0);
     }
     /**
      * Returns a new DateTime at the end of the given unit.
@@ -1032,8 +1031,7 @@ export class DateTime {
      */
     endOf(unit, opts) {
         const luxonDatetime = this.luxonDatetime.endOf(unit, opts);
-        const microseconds = unit === 'millisecond' ? this.microsecond : 999;
-        return new DateTime(luxonDatetime, microseconds);
+        return new DateTime(luxonDatetime, 999);
     }
     /**
      * Returns a new DateTime with the given locale/zone options. Microsecond is preserved.

package/dist/types/src/dream-app/index.d.ts

@@ -100,7 +100,7 @@ export default class DreamApp {
     static getOrFail(): DreamApp;
     static log(...args: any[]): void;
     static logWithLevel(level: DreamLogLevel, ...args: any[]): void;
-    private static argsToString;
+    private static loggerArgsToString;
     private _specialHooks;
     get specialHooks(): DreamAppSpecialHooks;
     private _dbCredentials;

package/dist/types/src/utils/datetime/DateTime.d.ts

@@ -10,8 +10,9 @@ export declare const BASE_DATE_OBJECT: {
  * DateTime wraps Luxon DateTime with microsecond precision (0-999).
  * The decimal part in ISO/SQL is 6 digits: first 3 = milliseconds, next 3 = microseconds.
  *
- * Full datetime output (toISO, toSQL) is normalized to UTC.
+ * Full datetime output with toSQL() is normalized to UTC.
  * Time-only output (toISOTime, toSQLTime) omits timezone offset by default.
+ * toISO() preserves the timezone of the DateTime instance.
  */
 export declare class DateTime {
     protected readonly luxonDatetime: LuxonDateTime;
@@ -456,7 +457,7 @@ export declare class DateTime {
     /**
      * Returns an ISO 8601 string with 6 fractional second digits (milliseconds + microseconds).
      *
-     * Always converts to UTC before formatting (e.g., '2024-03-15T15:30:45.123456Z').
+     * Preserves the timezone of the DateTime instance.
      *
      * @param opts - Optional format options
      * @param opts.suppressMilliseconds - If true, omits fractional seconds when they are zero
@@ -466,7 +467,7 @@ export declare class DateTime {
      * @returns ISO string (e.g. "2024-03-15T10:30:45.123456-05:00" or "2024-03-15T10:30:45.123456Z")
      * @example
      * ```ts
-     * DateTime.fromISO('2024-03-15T10:30:45.123456').toISO() // Converts to UTC
+     * DateTime.fromISO('2024-03-15T10:30:45.123456-05:00').toISO() // '2024-03-15T10:30:45.123456-05:00'
      * ```
      */
     toISO(opts?: ToISOTimeOptions): string;
@@ -547,12 +548,12 @@ export declare class DateTime {
     /**
      * Returns an ISO 8601 string representation (for valueOf() operations).
      *
-     * Converts to UTC before formatting.
+     * Preserves the timezone of the DateTime instance.
      *
      * @returns ISO datetime string with microsecond precision
      * @example
      * ```ts
-     * DateTime.local(2017, 3, 12).valueOf() // Converts to UTC
+     * DateTime.local(2017, 3, 12).valueOf() // Preserves local timezone
      * DateTime.fromISO('2026-02-07T09:03:44.123456Z').valueOf()              // '2026-02-07T09:03:44.123456Z'
      * ```
      */
@@ -562,7 +563,7 @@ export declare class DateTime {
      * Returns an ISO 8601 formatted string for JSON serialization.
      * This ensures DateTime objects are properly serialized to ISO format.
      *
-     * Converts to UTC before formatting.
+     * Preserves the timezone of the DateTime instance.
      *
      * @returns ISO datetime string with microsecond precision
      * @example
@@ -576,7 +577,7 @@ export declare class DateTime {
      * Returns an ISO 8601 formatted string representation.
      * Alias for toISO().
      *
-     * Converts to UTC before formatting.
+     * Preserves the timezone of the DateTime instance.
      *
      * @returns ISO datetime string with microsecond precision
      * @example