@solidxai/core 0.1.6-beta.2 → 0.1.6-beta.21

package/src/transformers/typeorm/local-date-time-transformer.ts

@@ -20,59 +20,67 @@ function dateToUtcComponentString(d: Date): string {
     const ss = pad(d.getUTCSeconds());
     const ms = pad(d.getUTCMilliseconds(), 3);
 
-    // A “naive” timestamp string representing the DB wall-clock components
+    // A "naive" timestamp string representing the DB wall-clock components
     return `${yyyy}-${mm}-${dd} ${hh}:${mi}:${ss}.${ms}`;
 }
 
-export const LocalDateTimeTransformer: ValueTransformer & { utc: ValueTransformer } = {
-    // DB → Entity
-    from(value: Date | string | null | undefined): Date | null | undefined {
+function getWallClockConfig(): { tz: string; wallTimeMode: boolean } {
+    return {
+        tz: process.env.SOLIDX_WALL_TIME_TIMEZONE || process.env.SOLIDX_TIMEZONE || "UTC",
+        wallTimeMode: (process.env.SOLIDX_TIME_STORED_AS_WALL_TIME || "").toLowerCase() === "true",
+    };
+}
+
+/**
+ * Returns a dayjs instance positioned at the wall-clock time for the given Date.
+ * - Wall-clock mode ON:  dayjs in the configured timezone (components = wall-clock components)
+ * - Wall-clock mode OFF: dayjs in UTC
+ * Counterpart to serializeDate — use this to format/display a date value correctly.
+ */
+export function parseDate(date: Date): dayjs.Dayjs {
+    const { tz, wallTimeMode } = getWallClockConfig();
+    if (!wallTimeMode) return dayjs.utc(date);
+    return dayjs(date).tz(tz);
+}
 
-        const SOLIDX_WALL_TIME_TZ = process.env.SOLIDX_WALL_TIME_TIMEZONE || process.env.SOLIDX_TIMEZONE || "UTC";
-        const SOLIDX_TIME_STORED_AS_WALL_TIME = (process.env.SOLIDX_TIME_STORED_AS_WALL_TIME || "").toLowerCase() === "true";
+/**
+ * Converts a Date to a string for storage in plain text columns (e.g. audit values).
+ * - Wall-clock mode ON:  "YYYY-MM-DD HH:mm:ss.SSS" in the configured timezone (no Z suffix)
+ * - Wall-clock mode OFF: ISO 8601 UTC string with Z suffix
+ * The presence/absence of the Z suffix lets consumers distinguish the two cases.
+ */
+export function serializeDate(date: Date): string {
+    const { wallTimeMode } = getWallClockConfig();
+    if (!wallTimeMode) return date.toISOString();
+    return parseDate(date).format("YYYY-MM-DD HH:mm:ss.SSS");
+}
 
-        // critical... super important to return undefined here 
+export const LocalDateTimeTransformer: ValueTransformer = {
+    // DB -> Entity
+    from(value: Date | string | null | undefined): Date | null | undefined {
+        // critical... super important to return undefined here
         if (value === undefined) return undefined;
         if (value === null) return null;
 
-        if (!SOLIDX_TIME_STORED_AS_WALL_TIME) {
+        const { tz, wallTimeMode } = getWallClockConfig();
+
+        if (!wallTimeMode) {
             return dayjs(value).toDate();
         }
 
         const naive = value instanceof Date ? dateToUtcComponentString(value) : String(value);
-        return dayjs.tz(naive, SOLIDX_WALL_TIME_TZ).utc().toDate();
+        return dayjs.tz(naive, tz).utc().toDate();
     },
 
-    // Entity → DB
+    // Entity -> DB
     to(value: Date | null | undefined): Date | null | undefined {
-
-        const SOLIDX_WALL_TIME_TZ = process.env.SOLIDX_WALL_TIME_TIMEZONE || process.env.SOLIDX_TIMEZONE || "UTC";
-        const SOLIDX_TIME_STORED_AS_WALL_TIME = (process.env.SOLIDX_TIME_STORED_AS_WALL_TIME || "").toLowerCase() === "true";
-
-        // critical... super important to return undefined here 
+        // critical... super important to return undefined here
         if (value === undefined) return undefined;
         if (value === null) return null;
 
-        if (!SOLIDX_TIME_STORED_AS_WALL_TIME) {
-            return dayjs(value).toDate();
-        }
-
-        const wallTimeStr = dayjs(value).tz(SOLIDX_WALL_TIME_TZ).format("YYYY-MM-DD HH:mm:ss.SSS");
+        const wallTimeStr = serializeDate(value);
         return dayjs.utc(wallTimeStr).toDate();
     },
 
-    utc: {
-        from(value: Date | string | null | undefined): Date | null | undefined {
-            if (value === undefined) return undefined;
-            if (value === null) return null;
-            return dayjs(value).toDate();
-        },
-        to(value: Date | null | undefined): Date | null | undefined {
-            if (value === undefined) return undefined;
-            if (value === null) return null;
-            return dayjs(value).toDate();
-        }
-    }
 };
 
-export const UtcDateTimeTransformer = LocalDateTimeTransformer.utc;

package/.claude/settings.local.json

@@ -1,15 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(node -e:*)",
-      "WebFetch(domain:docs.solidxai.com)",
-      "WebFetch(domain:github.com)",
-      "Read(//Users/oswald/projects/Solid_Starters/solidctl/**)",
-      "Read(//Users/oswald/projects/Solid_Starters/**)",
-      "Bash(find /Users/oswald/projects/Solid_Starters/solid-core-module -type d -name migration* -o -name *database*)"
-    ],
-    "additionalDirectories": [
-      "/Users/oswald/projects/Solid_Starters/solidctl"
-    ]
-  }
-}

package/src/services/1.js

@@ -1,6 +0,0 @@
-1. Do i need to create a storeStreams method for aws service too?
-    - Handle later
-2. queues handling -> if queues is enabled by default, i.e triggerExport(exportTransactionEntity.id).
-    - startExport should either return the data or return the transaction id
-3. How to handle scenarios wherein, nested related exist.(do i need to only get the userkey)
-    - show the userKey