forge-sql-orm 2.1.1 → 2.1.3

package/dist/ForgeSQLORM.mjs

@@ -17,11 +17,16 @@ const parseDateTime = (value, format) => {
     if (dt.isValid) {
       result = dt.toJSDate();
     } else {
-      const isoDt = DateTime.fromISO(value);
-      if (isoDt.isValid) {
-        result = isoDt.toJSDate();
+      const sqlDt = DateTime.fromSQL(value);
+      if (sqlDt.isValid) {
+        result = sqlDt.toJSDate();
       } else {
-        result = new Date(value);
+        const isoDt = DateTime.fromRFC2822(value);
+        if (isoDt.isValid) {
+          result = isoDt.toJSDate();
+        } else {
+          result = new Date(value);
+        }
       }
     }
   }
@@ -30,7 +35,7 @@ const parseDateTime = (value, format) => {
   }
   return result;
 };
-function formatDateTime(value, format) {
+function formatDateTime(value, format, isTimeStamp) {
   let dt = null;
   if (value instanceof Date) {
     dt = DateTime.fromJSDate(value);
@@ -58,6 +63,20 @@ function formatDateTime(value, format) {
   if (!dt?.isValid) {
     throw new Error("Invalid Date");
   }
+  const minDate = DateTime.fromSeconds(1);
+  const maxDate = DateTime.fromMillis(2147483647 * 1e3);
+  if (isTimeStamp) {
+    if (dt < minDate) {
+      throw new Error(
+        "Atlassian Forge does not support zero or negative timestamps. Allowed range: from '1970-01-01 00:00:01.000000' to '2038-01-19 03:14:07.999999'."
+      );
+    }
+    if (dt > maxDate) {
+      throw new Error(
+        "Atlassian Forge does not support timestamps beyond 2038-01-19 03:14:07.999999. Please use a smaller date within the supported range."
+      );
+    }
+  }
   return dt.toFormat(format);
 }
 function getPrimaryKeys(table) {
@@ -461,7 +480,9 @@ async function clearExpiredCache(options) {
     );
   } finally {
     const duration = DateTime.now().toSeconds() - startTime.toSeconds();
-    console.info(`Cleared ${totalRecords} expired cache records in ${duration} seconds`);
+    if (options?.logRawSqlQuery) {
+      console.debug(`Cleared ${totalRecords} expired cache records in ${duration} seconds`);
+    }
   }
 }
 async function getFromCache(query, options) {
@@ -534,7 +555,7 @@ async function saveTableIfInsideCacheContext(table) {
     context.tables.add(tableName);
   }
 }
-async function saveQueryLocalCacheQuery(query, rows) {
+async function saveQueryLocalCacheQuery(query, rows, options) {
   const context = localCacheApplicationContext.getStore();
   if (context) {
     if (!context.cache) {
@@ -546,9 +567,15 @@ async function saveQueryLocalCacheQuery(query, rows) {
       sql: sql2.toSQL().sql.toLowerCase(),
       data: rows
     };
+    if (options.logRawSqlQuery) {
+      const q = sql2.toSQL();
+      console.debug(
+        `[forge-sql-orm][local-cache][SAVE] Stored result in cache. sql="${q.sql}", params=${JSON.stringify(q.params)}`
+      );
+    }
   }
 }
-async function getQueryLocalCacheQuery(query) {
+async function getQueryLocalCacheQuery(query, options) {
   const context = localCacheApplicationContext.getStore();
   if (context) {
     if (!context.cache) {
@@ -557,6 +584,12 @@ async function getQueryLocalCacheQuery(query) {
     const sql2 = query;
     const key = hashKey(sql2.toSQL());
     if (context.cache[key] && context.cache[key].sql === sql2.toSQL().sql.toLowerCase()) {
+      if (options.logRawSqlQuery) {
+        const q = sql2.toSQL();
+        console.debug(
+          `[forge-sql-orm][local-cache][HIT] Returned cached result. sql="${q.sql}", params=${JSON.stringify(q.params)}`
+        );
+      }
       return context.cache[key].data;
     }
   }
@@ -983,28 +1016,23 @@ class ForgeSQLSelectOperations {
   }
 }
 const forgeDriver = async (query, params, method) => {
-  try {
-    if (method == "execute") {
-      const sqlStatement = sql$1.prepare(query);
-      if (params) {
-        sqlStatement.bindParams(...params);
-      }
-      const updateQueryResponseResults = await sqlStatement.execute();
-      let result = updateQueryResponseResults.rows;
-      return { ...result, rows: [result] };
-    } else {
-      const sqlStatement = await sql$1.prepare(query);
-      if (params) {
-        await sqlStatement.bindParams(...params);
-      }
-      const result = await sqlStatement.execute();
-      let rows;
-      rows = result.rows.map((r) => Object.values(r));
-      return { rows };
+  if (method == "execute") {
+    const sqlStatement = sql$1.prepare(query);
+    if (params) {
+      sqlStatement.bindParams(...params);
     }
-  } catch (error) {
-    console.error("SQL Error:", JSON.stringify(error));
-    throw error;
+    const updateQueryResponseResults = await sqlStatement.execute();
+    let result = updateQueryResponseResults.rows;
+    return { ...result, rows: [result] };
+  } else {
+    const sqlStatement = await sql$1.prepare(query);
+    if (params) {
+      await sqlStatement.bindParams(...params);
+    }
+    const result = await sqlStatement.execute();
+    let rows;
+    rows = result.rows.map((r) => Object.values(r));
+    return { rows };
   }
 };
 function injectSqlHints(query, hints) {
@@ -1041,28 +1069,22 @@ function createForgeDriverProxy(options, logRawSqlQuery) {
   return async (query, params, method) => {
     const modifiedQuery = injectSqlHints(query, options);
     if (options && logRawSqlQuery && modifiedQuery !== query) {
-      console.warn("modified query: " + modifiedQuery);
+      console.debug("injected Hints: " + modifiedQuery);
+    }
+    try {
+      return await forgeDriver(modifiedQuery, params, method);
+    } catch (error) {
+      if (logRawSqlQuery) {
+        console.debug("SQL Error:", JSON.stringify(error));
+      }
+      throw error;
     }
-    return forgeDriver(modifiedQuery, params, method);
   };
 }
-const NON_CACHE_CLEARING_ERROR_CODES = [
-  "VALIDATION_ERROR",
-  "CONSTRAINT_ERROR"
-];
-const CACHE_CLEARING_ERROR_CODES = [
-  "DEADLOCK",
-  "LOCK_WAIT_TIMEOUT",
-  "CONNECTION_ERROR"
-];
-const NON_CACHE_CLEARING_PATTERNS = [
-  /validation/i,
-  /constraint/i
-];
-const CACHE_CLEARING_PATTERNS = [
-  /timeout/i,
-  /connection/i
-];
+const NON_CACHE_CLEARING_ERROR_CODES = ["VALIDATION_ERROR", "CONSTRAINT_ERROR"];
+const CACHE_CLEARING_ERROR_CODES = ["DEADLOCK", "LOCK_WAIT_TIMEOUT", "CONNECTION_ERROR"];
+const NON_CACHE_CLEARING_PATTERNS = [/validation/i, /constraint/i];
+const CACHE_CLEARING_PATTERNS = [/timeout/i, /connection/i];
 function shouldClearCacheOnError(error) {
   if (error?.code && NON_CACHE_CLEARING_ERROR_CODES.includes(error.code)) {
     return false;
@@ -1091,8 +1113,8 @@ async function handleSuccessfulExecution(rows, onfulfilled, table, options, isCa
     if (shouldClearCacheOnError(error)) {
       await evictLocalCacheQuery(table, options);
       if (isCached) {
-        await clearCache(table, options).catch(() => {
-          console.warn("Ignore cache clear errors");
+        await clearCache(table, options).catch((e) => {
+          console.warn("Ignore cache clear errors", e);
         });
       } else {
         await saveTableIfInsideCacheContext(table);
@@ -1154,7 +1176,7 @@ function deleteAndEvictCacheBuilder(db, table, options, isCached) {
 }
 async function handleCachedQuery(target, options, cacheTtl, selections, aliasMap, onfulfilled, onrejected) {
   try {
-    const localCached = await getQueryLocalCacheQuery(target);
+    const localCached = await getQueryLocalCacheQuery(target, options);
     if (localCached) {
       return onfulfilled?.(localCached);
     }
@@ -1164,7 +1186,7 @@ async function handleCachedQuery(target, options, cacheTtl, selections, aliasMap
     }
     const rows = await target.execute();
     const transformed = applyFromDriverTransform(rows, selections, aliasMap);
-    await saveQueryLocalCacheQuery(target, transformed);
+    await saveQueryLocalCacheQuery(target, transformed, options);
     await setCacheResult(target, options, transformed, cacheTtl).catch((cacheError) => {
       console.warn("Cache set error:", cacheError);
     });
@@ -1173,15 +1195,15 @@ async function handleCachedQuery(target, options, cacheTtl, selections, aliasMap
     return onrejected?.(error);
   }
 }
-async function handleNonCachedQuery(target, selections, aliasMap, onfulfilled, onrejected) {
+async function handleNonCachedQuery(target, options, selections, aliasMap, onfulfilled, onrejected) {
   try {
-    const localCached = await getQueryLocalCacheQuery(target);
+    const localCached = await getQueryLocalCacheQuery(target, options);
     if (localCached) {
       return onfulfilled?.(localCached);
     }
     const rows = await target.execute();
     const transformed = applyFromDriverTransform(rows, selections, aliasMap);
-    await saveQueryLocalCacheQuery(target, transformed);
+    await saveQueryLocalCacheQuery(target, transformed, options);
     return onfulfilled?.(transformed);
   } catch (error) {
     return onrejected?.(error);
@@ -1213,7 +1235,14 @@ function createAliasedSelectBuilder(db, fields, selectFn, useCache, options, cac
                 onrejected
               );
             } else {
-              return handleNonCachedQuery(target, selections, aliasMap, onfulfilled, onrejected);
+              return handleNonCachedQuery(
+                target,
+                options,
+                selections,
+                aliasMap,
+                onfulfilled,
+                onrejected
+              );
             }
           };
         }
@@ -1247,14 +1276,16 @@ function createRawQueryExecutor(db, options, useGlobalCache = false) {
     let sql2;
     if (isSQLWrapper(query)) {
       const sqlWrapper = query;
-      sql2 = sqlWrapper.getSQL().toQuery(db.dialect);
+      sql2 = sqlWrapper.getSQL().toQuery(
+        db.dialect
+      );
     } else {
       sql2 = {
         sql: query,
         params: []
       };
     }
-    const localCacheResult = await getQueryLocalCacheQuery(sql2);
+    const localCacheResult = await getQueryLocalCacheQuery(sql2, options);
     if (localCacheResult) {
       return localCacheResult;
     }
@@ -1265,7 +1296,7 @@ function createRawQueryExecutor(db, options, useGlobalCache = false) {
       }
     }
     const results = await db.execute(query);
-    await saveQueryLocalCacheQuery(sql2, results);
+    await saveQueryLocalCacheQuery(sql2, results, options);
     if (useGlobalCache) {
       await setCacheResult(
         { toSQL: () => sql2 },
@@ -1816,34 +1847,40 @@ class ForgeSQLORMImpl {
    */
   async executeWithCacheContextAndReturnValue(cacheContext) {
     return await this.executeWithLocalCacheContextAndReturnValue(
-      async () => await cacheApplicationContext.run(cacheApplicationContext.getStore() ?? { tables: /* @__PURE__ */ new Set() }, async () => {
-        try {
-          return await cacheContext();
-        } finally {
-          await clearTablesCache(
-            Array.from(cacheApplicationContext.getStore()?.tables ?? []),
-            this.options
-          );
+      async () => await cacheApplicationContext.run(
+        cacheApplicationContext.getStore() ?? { tables: /* @__PURE__ */ new Set() },
+        async () => {
+          try {
+            return await cacheContext();
+          } finally {
+            await clearTablesCache(
+              Array.from(cacheApplicationContext.getStore()?.tables ?? []),
+              this.options
+            );
+          }
         }
-      })
+      )
     );
   }
   /**
    * Executes operations within a local cache context and returns a value.
    * This provides in-memory caching for select queries within a single request scope.
-   * 
+   *
    * @param cacheContext - Function containing operations that will benefit from local caching
    * @returns Promise that resolves to the return value of the cacheContext function
    */
   async executeWithLocalCacheContextAndReturnValue(cacheContext) {
-    return await localCacheApplicationContext.run(localCacheApplicationContext.getStore() ?? { cache: {} }, async () => {
-      return await cacheContext();
-    });
+    return await localCacheApplicationContext.run(
+      localCacheApplicationContext.getStore() ?? { cache: {} },
+      async () => {
+        return await cacheContext();
+      }
+    );
   }
   /**
    * Executes operations within a local cache context.
    * This provides in-memory caching for select queries within a single request scope.
-   * 
+   *
    * @param cacheContext - Function containing operations that will benefit from local caching
    * @returns Promise that resolves when all operations are complete
    */
@@ -2140,7 +2177,7 @@ class ForgeSQLORMImpl {
    * ```typescript
    * // Using SQLWrapper
    * const result = await forgeSQL.execute(sql`SELECT * FROM users WHERE id = ${userId}`);
-   * 
+   *
    * // Using string
    * const result = await forgeSQL.execute("SELECT * FROM users WHERE status = 'active'");
    * ```
@@ -2161,7 +2198,7 @@ class ForgeSQLORMImpl {
    * ```typescript
    * // Using SQLWrapper with custom TTL
    * const result = await forgeSQL.executeCacheable(sql`SELECT * FROM users WHERE id = ${userId}`, 300);
-   * 
+   *
    * // Using string with default TTL
    * const result = await forgeSQL.executeCacheable("SELECT * FROM users WHERE status = 'active'");
    * ```
@@ -2199,7 +2236,7 @@ class ForgeSQLORMImpl {
    *     .from(users)
    *     .groupBy(users.id)
    * );
-   * 
+   *
    * const result = await forgeSQL.with(withQuery)
    *   .select({ userId: withQuery.userId, count: withQuery.count })
    *   .from(withQuery);
@@ -2291,7 +2328,7 @@ class ForgeSQLORM {
   /**
    * Executes operations within a local cache context.
    * This provides in-memory caching for select queries within a single request scope.
-   * 
+   *
    * @param cacheContext - Function containing operations that will benefit from local caching
    * @returns Promise that resolves when all operations are complete
    */
@@ -2301,7 +2338,7 @@ class ForgeSQLORM {
   /**
    * Executes operations within a local cache context and returns a value.
    * This provides in-memory caching for select queries within a single request scope.
-   * 
+   *
    * @param cacheContext - Function containing operations that will benefit from local caching
    * @returns Promise that resolves to the return value of the cacheContext function
    */
@@ -2465,7 +2502,7 @@ class ForgeSQLORM {
    * ```typescript
    * // Using SQLWrapper
    * const result = await forgeSQL.execute(sql`SELECT * FROM users WHERE id = ${userId}`);
-   * 
+   *
    * // Using string
    * const result = await forgeSQL.execute("SELECT * FROM users WHERE status = 'active'");
    * ```
@@ -2486,7 +2523,7 @@ class ForgeSQLORM {
    * ```typescript
    * // Using SQLWrapper with custom TTL
    * const result = await forgeSQL.executeCacheable(sql`SELECT * FROM users WHERE id = ${userId}`, 300);
-   * 
+   *
    * // Using string with default TTL
    * const result = await forgeSQL.executeCacheable("SELECT * FROM users WHERE status = 'active'");
    * ```
@@ -2524,7 +2561,7 @@ class ForgeSQLORM {
    *     .from(users)
    *     .groupBy(users.id)
    * );
-   * 
+   *
    * const result = await forgeSQL.with(withQuery)
    *   .select({ userId: withQuery.userId, count: withQuery.count })
    *   .from(withQuery);
@@ -2539,10 +2576,10 @@ const forgeDateTimeString = customType({
     return "datetime";
   },
   toDriver(value) {
-    return formatDateTime(value, "yyyy-LL-dd' 'HH:mm:ss.SSS");
+    return formatDateTime(value, "yyyy-MM-dd' 'HH:mm:ss.SSS", false);
   },
   fromDriver(value) {
-    const format = "yyyy-LL-dd'T'HH:mm:ss.SSS";
+    const format = "yyyy-MM-dd' 'HH:mm:ss.SSS";
     return parseDateTime(value, format);
   }
 });
@@ -2551,10 +2588,10 @@ const forgeTimestampString = customType({
     return "timestamp";
   },
   toDriver(value) {
-    return formatDateTime(value, "yyyy-LL-dd' 'HH:mm:ss.SSS");
+    return formatDateTime(value, "yyyy-MM-dd' 'HH:mm:ss.SSS", true);
   },
   fromDriver(value) {
-    const format = "yyyy-LL-dd'T'HH:mm:ss.SSS";
+    const format = "yyyy-MM-dd' 'HH:mm:ss.SSS";
     return parseDateTime(value, format);
   }
 });
@@ -2563,10 +2600,10 @@ const forgeDateString = customType({
     return "date";
   },
   toDriver(value) {
-    return formatDateTime(value, "yyyy-LL-dd");
+    return formatDateTime(value, "yyyy-MM-dd", false);
   },
   fromDriver(value) {
-    const format = "yyyy-LL-dd";
+    const format = "yyyy-MM-dd";
     return parseDateTime(value, format);
   }
 });
@@ -2575,7 +2612,7 @@ const forgeTimeString = customType({
     return "time";
   },
   toDriver(value) {
-    return formatDateTime(value, "HH:mm:ss.SSS");
+    return formatDateTime(value, "HH:mm:ss.SSS", false);
   },
   fromDriver(value) {
     return parseDateTime(value, "HH:mm:ss.SSS");
@@ -2596,7 +2633,7 @@ async function dropSchemaMigrations() {
     const tables = await getTables();
     const dropStatements = generateDropTableStatements(tables, { sequence: true, table: true });
     for (const statement of dropStatements) {
-      console.warn(statement);
+      console.debug(`execute DDL: ${statement}`);
       await sql$1.executeDDL(statement);
     }
     return getHttpResponse(
@@ -2604,8 +2641,8 @@ async function dropSchemaMigrations() {
       "⚠️ All data in these tables has been permanently deleted. This operation cannot be undone."
     );
   } catch (error) {
-    console.error(error);
-    const errorMessage = error instanceof Error ? error.message : "Unknown error occurred";
+    const errorMessage = error?.debug?.sqlMessage ?? error?.debug?.message ?? error.message ?? "Unknown error occurred";
+    console.error(errorMessage);
     return getHttpResponse(500, errorMessage);
   }
 }
@@ -2621,7 +2658,13 @@ const applySchemaMigrations = async (migration) => {
     const successfulMigrations = await migrations2.run();
     console.info("Migrations applied:", successfulMigrations);
     const migrationList = await migrationRunner.list();
-    const migrationHistory = Array.isArray(migrationList) && migrationList.length > 0 ? migrationList.sort((a, b) => a.migratedAt.getTime() - b.migratedAt.getTime()).map((y) => `${y.id}, ${y.name}, ${y.migratedAt.toUTCString()}`).join("\n") : "No migrations found";
+    let migrationHistory = "No migrations found";
+    if (Array.isArray(migrationList) && migrationList.length > 0) {
+      const sortedMigrations = migrationList.toSorted(
+        (a, b) => a.migratedAt.getTime() - b.migratedAt.getTime()
+      );
+      migrationHistory = sortedMigrations.map((y) => `${y.id}, ${y.name}, ${y.migratedAt.toUTCString()}`).join("\n");
+    }
     console.info("Migrations history:\nid, name, migrated_at\n", migrationHistory);
     return {
       headers: { "Content-Type": ["application/json"] },
@@ -2630,12 +2673,8 @@ const applySchemaMigrations = async (migration) => {
       body: "Migrations successfully executed"
     };
   } catch (error) {
-    try {
-      console.error("Error during migration:", JSON.stringify(error));
-    } catch (e) {
-      console.trace("Error stringify:", e);
-      console.error("Error during migration:", error);
-    }
+    const errorMessage = error?.debug?.sqlMessage ?? error?.debug?.message ?? error.message ?? "Unknown error occurred";
+    console.error("Error during migration:", errorMessage);
     return {
       headers: { "Content-Type": ["application/json"] },
       statusCode: 500,
@@ -2651,8 +2690,8 @@ async function fetchSchemaWebTrigger() {
     const sqlStatements = wrapWithForeignKeyChecks(createTableStatements);
     return getHttpResponse(200, sqlStatements.join(";\n"));
   } catch (error) {
-    console.error(JSON.stringify(error));
-    const errorMessage = error instanceof Error ? error.message : "Unknown error occurred";
+    const errorMessage = error?.debug?.sqlMessage ?? error?.debug?.message ?? error.message ?? "Unknown error occurred";
+    console.error(errorMessage);
     return getHttpResponse(500, errorMessage);
   }
 }
@@ -2679,7 +2718,7 @@ async function dropTableSchemaMigrations() {
     const tables = await getTables();
     const dropStatements = generateDropTableStatements(tables, { sequence: false, table: true });
     for (const statement of dropStatements) {
-      console.warn(statement);
+      console.debug(`execute DDL: ${statement}`);
       await sql$1.executeDDL(statement);
     }
     return getHttpResponse(
@@ -2687,8 +2726,8 @@ async function dropTableSchemaMigrations() {
       "⚠️ All data in these tables has been permanently deleted. This operation cannot be undone."
     );
   } catch (error) {
-    console.error(error);
-    const errorMessage = error instanceof Error ? error.message : "Unknown error occurred";
+    const errorMessage = error?.debug?.sqlMessage ?? error?.debug?.message ?? error.message ?? "Unknown error occurred";
+    console.error(errorMessage);
     return getHttpResponse(500, errorMessage);
   }
 }