forge-sql-orm 2.1.13 → 2.1.15

package/dist/utils/forgeDriver.d.ts

@@ -50,9 +50,10 @@ export declare function isUpdateQueryResponse(obj: unknown): obj is UpdateQueryR
 /**
  * Main Forge SQL driver function for Drizzle ORM integration.
  * Handles DDL operations, execute operations (UPDATE/INSERT/DELETE), and select operations.
+ * Automatically saves query execution metadata to the context for performance monitoring.
  *
  * @param query - The SQL query to execute
- * @param params - Query parameters
+ * @param params - Query parameters (may be undefined or empty array)
  * @param method - Execution method ("all" for SELECT, "execute" for UPDATE/INSERT/DELETE)
  * @returns Promise with query results compatible with Drizzle ORM
  *
@@ -70,5 +71,5 @@ export declare function isUpdateQueryResponse(obj: unknown): obj is UpdateQueryR
  * await forgeDriver("UPDATE users SET name = ? WHERE id = ?", ["John", 1], "execute");
  * ```
  */
-export declare const forgeDriver: (query: string, params: unknown[], method: QueryMethod) => Promise<ForgeDriverResult>;
+export declare const forgeDriver: (query: string, params: unknown[] | undefined, method: QueryMethod) => Promise<ForgeDriverResult>;
 //# sourceMappingURL=forgeDriver.d.ts.map

package/dist/utils/forgeDriver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"forgeDriver.d.ts","sourceRoot":"","sources":["../../src/utils/forgeDriver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAQtD;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;KACtB,EAAE,CAAC;CACL,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1D,QAAQ,EAAE,gBAAgB,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,SAAS,CAAC;AAE5C;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,mBAAmB,CAO9E;AA6FD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,WAAW,GACtB,OAAO,MAAM,EACb,QAAQ,OAAO,EAAE,EACjB,QAAQ,WAAW,KAClB,OAAO,CAAC,iBAAiB,CAmB3B,CAAC"}
+{"version":3,"file":"forgeDriver.d.ts","sourceRoot":"","sources":["../../src/utils/forgeDriver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAQtD;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;KACtB,EAAE,CAAC;CACL,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1D,QAAQ,EAAE,gBAAgB,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,SAAS,CAAC;AAE5C;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,mBAAmB,CAO9E;AA2GD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,WAAW,GACtB,OAAO,MAAM,EACb,QAAQ,OAAO,EAAE,GAAG,SAAS,EAC7B,QAAQ,WAAW,KAClB,OAAO,CAAC,iBAAiB,CAmB3B,CAAC"}

package/dist/utils/forgeDriver.js

@@ -32,14 +32,17 @@ function inlineParams(sql, params) {
     });
 }
 /**
- * Processes DDL query results and saves metadata.
+ * Processes DDL query results and saves metadata to the execution context.
  *
+ * @param query - The SQL query string
+ * @param params - Query parameters
+ * @param method - Execution method ("all" or "execute")
  * @param result - The DDL query result
  * @returns Processed result for Drizzle ORM
  */
-async function processDDLResult(method, result) {
+async function processDDLResult(query, params, method, result) {
     if (result.metadata) {
-        await (0, metadataContextUtils_1.saveMetaDataToContext)(result.metadata);
+        await (0, metadataContextUtils_1.saveMetaDataToContext)(query, params, result.metadata);
     }
     if (!result?.rows) {
         return { rows: [] };
@@ -60,10 +63,10 @@ async function processDDLResult(method, result) {
     return { rows: [] };
 }
 /**
- * Processes execute method results (UPDATE, INSERT, DELETE).
+ * Processes execute method results (UPDATE, INSERT, DELETE) and saves metadata to the execution context.
  *
- * @param query - The SQL query
- * @param params - Query parameters
+ * @param query - The SQL query string
+ * @param params - Query parameters (may be undefined)
  * @returns Processed result for Drizzle ORM
  */
 async function processExecuteMethod(query, params) {
@@ -72,17 +75,17 @@ async function processExecuteMethod(query, params) {
         sqlStatement.bindParams(...params);
     }
     const result = await (0, sqlUtils_1.withTimeout)(sqlStatement.execute(), timeoutMessage, timeoutMs);
-    await (0, metadataContextUtils_1.saveMetaDataToContext)(result.metadata);
+    await (0, metadataContextUtils_1.saveMetaDataToContext)(query, params ?? [], result.metadata);
     if (!result.rows) {
         return { rows: [[]] };
     }
     return { rows: [result.rows] };
 }
 /**
- * Processes all method results (SELECT queries).
+ * Processes all method results (SELECT queries) and saves metadata to the execution context.
  *
- * @param query - The SQL query
- * @param params - Query parameters
+ * @param query - The SQL query string
+ * @param params - Query parameters (may be undefined)
  * @returns Processed result for Drizzle ORM
  */
 async function processAllMethod(query, params) {
@@ -91,7 +94,7 @@ async function processAllMethod(query, params) {
         await sqlStatement.bindParams(...params);
     }
     const result = await (0, sqlUtils_1.withTimeout)(sqlStatement.execute(), timeoutMessage, timeoutMs);
-    await (0, metadataContextUtils_1.saveMetaDataToContext)(result.metadata);
+    await (0, metadataContextUtils_1.saveMetaDataToContext)(query, params ?? [], result.metadata);
     if (!result.rows) {
         return { rows: [] };
     }
@@ -101,9 +104,10 @@ async function processAllMethod(query, params) {
 /**
  * Main Forge SQL driver function for Drizzle ORM integration.
  * Handles DDL operations, execute operations (UPDATE/INSERT/DELETE), and select operations.
+ * Automatically saves query execution metadata to the context for performance monitoring.
  *
  * @param query - The SQL query to execute
- * @param params - Query parameters
+ * @param params - Query parameters (may be undefined or empty array)
  * @param method - Execution method ("all" for SELECT, "execute" for UPDATE/INSERT/DELETE)
  * @returns Promise with query results compatible with Drizzle ORM
  *
@@ -125,15 +129,15 @@ const forgeDriver = async (query, params, method) => {
     const operationType = await (0, requestTypeContextUtils_1.getOperationType)();
     // Handle DDL operations
     if (operationType === "DDL") {
-        const result = await (0, sqlUtils_1.withTimeout)(sql_1.sql.executeDDL(inlineParams(query, params)), timeoutMessage, timeoutMs);
-        return await processDDLResult(method, result);
+        const result = await (0, sqlUtils_1.withTimeout)(sql_1.sql.executeDDL(inlineParams(query, params ?? [])), timeoutMessage, timeoutMs);
+        return await processDDLResult(query, params ?? [], method, result);
     }
     // Handle execute method (UPDATE, INSERT, DELETE)
     if (method === "execute") {
-        return await processExecuteMethod(query, params ?? []);
+        return await processExecuteMethod(query, params);
     }
     // Handle all method (SELECT)
-    return await processAllMethod(query, params ?? []);
+    return await processAllMethod(query, params);
 };
 exports.forgeDriver = forgeDriver;
 //# sourceMappingURL=forgeDriver.js.map

package/dist/utils/forgeDriver.js.map

@@ -1 +1 @@
-{"version":3,"file":"forgeDriver.js","sourceRoot":"","sources":["../../src/utils/forgeDriver.ts"],"names":[],"mappings":";;;AA2DA,sDAOC;AAlED,oCAAsD;AACtD,iEAA+D;AAC/D,uEAA6D;AAC7D,yCAAyC;AAEzC,MAAM,SAAS,GAAG,KAAK,CAAC;AACxB,MAAM,cAAc,GAAG,yDAAyD,SAAS,OAAO,SAAS,GAAG,IAAI,mHAAmH,CAAC;AA+CpO;;;;;GAKG;AACH,SAAgB,qBAAqB,CAAC,GAAY;IAChD,OAAO,CACL,GAAG,KAAK,IAAI;QACZ,OAAO,GAAG,KAAK,QAAQ;QACvB,OAAQ,GAAW,CAAC,YAAY,KAAK,QAAQ;QAC7C,OAAQ,GAAW,CAAC,QAAQ,KAAK,QAAQ,CAC1C,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,GAAW,EAAE,MAAiB;IAClD,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE;QAC7B,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;QACxB,IAAI,GAAG,KAAK,IAAI;YAAE,OAAO,MAAM,CAAC;QAChC,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;QACnD,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC;IAChD,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,gBAAgB,CAAC,MAAmB,EAAE,MAAW;IAC9D,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,MAAM,IAAA,4CAAqB,EAAC,MAAM,CAAC,QAA4B,CAAC,CAAC;IACnE,CAAC;IAED,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;QAClB,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IACtB,CAAC;IAED,IAAI,qBAAqB,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC;QAC3B,OAAO,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;IACvC,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QACjC,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,GAAI,MAAM,CAAC,IAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAA4B,CAAC,CAAC,CAAC;YAC5F,OAAO,EAAE,IAAI,EAAE,CAAC;QAClB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;AACtB,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,oBAAoB,CAAC,KAAa,EAAE,MAAiB;IAClE,MAAM,YAAY,GAAG,SAAG,CAAC,OAAO,CAAsB,KAAK,CAAC,CAAC;IAE7D,IAAI,MAAM,EAAE,CAAC;QACX,YAAY,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,CAAC;IACrC,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,IAAA,sBAAW,EAAC,YAAY,CAAC,OAAO,EAAE,EAAE,cAAc,EAAE,SAAS,CAAC,CAAC;IACpF,MAAM,IAAA,4CAAqB,EAAC,MAAM,CAAC,QAA4B,CAAC,CAAC;IACjE,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACjB,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;IACxB,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;AACjC,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,gBAAgB,CAAC,KAAa,EAAE,MAAiB;IAC9D,MAAM,YAAY,GAAG,MAAM,SAAG,CAAC,OAAO,CAAU,KAAK,CAAC,CAAC;IAEvD,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,YAAY,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,CAAC;IAC3C,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,IAAA,sBAAW,EAAC,YAAY,CAAC,OAAO,EAAE,EAAE,cAAc,EAAE,SAAS,CAAC,CAAC;IACpF,MAAM,IAAA,4CAAqB,EAAC,MAAM,CAAC,QAA4B,CAAC,CAAC;IAEjE,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACjB,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IACtB,CAAC;IAED,MAAM,IAAI,GAAI,MAAM,CAAC,IAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAA4B,CAAC,CAAC,CAAC;IAE5F,OAAO,EAAE,IAAI,EAAE,CAAC;AAClB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACI,MAAM,WAAW,GAAG,KAAK,EAC9B,KAAa,EACb,MAAiB,EACjB,MAAmB,EACS,EAAE;IAC9B,MAAM,aAAa,GAAG,MAAM,IAAA,0CAAgB,GAAE,CAAC;IAC/C,wBAAwB;IACxB,IAAI,aAAa,KAAK,KAAK,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,MAAM,IAAA,sBAAW,EAC9B,SAAG,CAAC,UAAU,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,EAC3C,cAAc,EACd,SAAS,CACV,CAAC;QACF,OAAO,MAAM,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChD,CAAC;IAED,iDAAiD;IACjD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,MAAM,oBAAoB,CAAC,KAAK,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,6BAA6B;IAC7B,OAAO,MAAM,gBAAgB,CAAC,KAAK,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC;AACrD,CAAC,CAAC;AAvBW,QAAA,WAAW,eAuBtB"}
+{"version":3,"file":"forgeDriver.js","sourceRoot":"","sources":["../../src/utils/forgeDriver.ts"],"names":[],"mappings":"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"}

package/dist/utils/metadataContextUtils.d.ts

@@ -1,14 +1,40 @@
 import { AsyncLocalStorage } from "node:async_hooks";
 import { ForgeSQLMetadata } from "./forgeDriver";
 import { ForgeSqlOperation } from "../core/ForgeSQLQueryBuilder";
+type Statistic = {
+    query: string;
+    params: unknown[];
+    metadata: ForgeSQLMetadata;
+};
+export type QueryPlanMode = "TopSlowest" | "SummaryTable";
+export type MetadataQueryOptions = {
+    mode?: QueryPlanMode;
+    summaryTableWindowTime?: number;
+    topQueries?: number;
+    showSlowestPlans?: boolean;
+    normalizeQuery?: boolean;
+};
 export type MetadataQueryContext = {
     totalDbExecutionTime: number;
     totalResponseSize: number;
     beginTime: Date;
+    options?: MetadataQueryOptions;
+    statistics: Statistic[];
     printQueriesWithPlan: () => Promise<void>;
     forgeSQLORM: ForgeSqlOperation;
 };
 export declare const metadataQueryContext: AsyncLocalStorage<MetadataQueryContext>;
-export declare function saveMetaDataToContext(metadata?: ForgeSQLMetadata): Promise<void>;
+/**
+ * Saves query metadata to the current context and sets up the printQueriesWithPlan function.
+ * @param stringQuery - The SQL query string
+ * @param params - Query parameters
+ * @param metadata - Query execution metadata
+ */
+export declare function saveMetaDataToContext(stringQuery: string, params: unknown[], metadata: ForgeSQLMetadata): Promise<void>;
+/**
+ * Gets the latest metadata from the current context.
+ * @returns The current metadata context or undefined if not in a context
+ */
 export declare function getLastestMetadata(): Promise<MetadataQueryContext | undefined>;
+export {};
 //# sourceMappingURL=metadataContextUtils.d.ts.map

package/dist/utils/metadataContextUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metadataContextUtils.d.ts","sourceRoot":"","sources":["../../src/utils/metadataContextUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAGjE,MAAM,MAAM,oBAAoB,GAAG;IACjC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,IAAI,CAAC;IAChB,oBAAoB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,WAAW,EAAE,iBAAiB,CAAC;CAChC,CAAC;AACF,eAAO,MAAM,oBAAoB,yCAAgD,CAAC;AAElF,wBAAsB,qBAAqB,CAAC,QAAQ,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAetF;AAED,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC,CAEpF"}
+{"version":3,"file":"metadataContextUtils.d.ts","sourceRoot":"","sources":["../../src/utils/metadataContextUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAOjE,KAAK,SAAS,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,EAAE,CAAC;IAAC,QAAQ,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAElF,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,cAAc,CAAC;AAE1D,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,oBAAoB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,WAAW,EAAE,iBAAiB,CAAC;CAChC,CAAC;AAEF,eAAO,MAAM,oBAAoB,yCAAgD,CAAC;AA2MlF;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,OAAO,EAAE,EACjB,QAAQ,EAAE,gBAAgB,GACzB,OAAO,CAAC,IAAI,CAAC,CAoCf;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC,CAEpF"}

package/dist/utils/metadataContextUtils.js

@@ -5,23 +5,226 @@ exports.saveMetaDataToContext = saveMetaDataToContext;
 exports.getLastestMetadata = getLastestMetadata;
 const node_async_hooks_1 = require("node:async_hooks");
 const sqlUtils_1 = require("./sqlUtils");
+const node_sql_parser_1 = require("node-sql-parser");
+const DEFAULT_WINDOW_SIZE = 15 * 1000;
 exports.metadataQueryContext = new node_async_hooks_1.AsyncLocalStorage();
-async function saveMetaDataToContext(metadata) {
+/**
+ * Creates default options for metadata query context.
+ * @returns Default options object
+ */
+function createDefaultOptions() {
+    return {
+        mode: "TopSlowest",
+        topQueries: 1,
+        summaryTableWindowTime: DEFAULT_WINDOW_SIZE,
+        showSlowestPlans: true,
+        normalizeQuery: true,
+    };
+}
+/**
+ * Merges provided options with defaults, using defaults only for undefined fields.
+ * @param options - Optional partial options to merge
+ * @returns Complete options object with all fields set
+ */
+function mergeOptionsWithDefaults(options) {
+    const defaults = createDefaultOptions();
+    return {
+        mode: options?.mode ?? defaults.mode,
+        topQueries: options?.topQueries ?? defaults.topQueries,
+        summaryTableWindowTime: options?.summaryTableWindowTime ?? defaults.summaryTableWindowTime,
+        showSlowestPlans: options?.showSlowestPlans ?? defaults.showSlowestPlans,
+        normalizeQuery: options?.normalizeQuery ?? defaults.normalizeQuery,
+    };
+}
+/**
+ * Normalizes SQL query using regex fallback by replacing parameter values with placeholders.
+ * Replaces string literals, numeric values, and boolean values with '?' for logging.
+ *
+ * Note: This is a fallback function used when node-sql-parser fails.
+ * It uses simple, safe regex patterns to avoid ReDoS (Regular Expression Denial of Service) vulnerabilities.
+ * For proper handling of escaped quotes and complex SQL, use the main normalizeSqlForLogging function
+ * which uses node-sql-parser.
+ *
+ * @param sql - SQL query string to normalize
+ * @returns Normalized SQL string with parameters replaced by '?'
+ */
+function normalizeSqlForLoggingRegex(sql) {
+    let normalized = sql;
+    // Replace string literals (single quotes) - using simple greedy match
+    // This avoids catastrophic backtracking by using a simple [^']* pattern
+    // Note: This does not handle SQL-style escaped quotes (doubled quotes: '')
+    // For proper handling, use the main normalizeSqlForLogging function with node-sql-parser
+    normalized = normalized.replace(/'[^']*'/g, "?");
+    // Replace string literals (double quotes) - using simple greedy match
+    // Same safety considerations as above
+    normalized = normalized.replace(/"[^"]*"/g, "?");
+    // Replace numeric literals - simplified pattern to avoid backtracking
+    // Match: optional minus, digits, optional decimal point and more digits
+    // Using word boundaries (\b) for safety - avoids complex lookahead/lookbehind
+    normalized = normalized.replace(/\b-?\d+\.?\d*\b/g, "?");
+    // Replace boolean literals - safe pattern with word boundaries
+    // Simple alternation with word boundaries - no nested quantifiers
+    normalized = normalized.replace(/\b(true|false)\b/gi, "?");
+    // Replace NULL values (but be careful not to replace in identifiers)
+    // Simple word boundary match - safe from backtracking
+    normalized = normalized.replace(/\bNULL\b/gi, "?");
+    return normalized;
+}
+/**
+ * Normalizes SQL query by replacing parameter values with placeholders.
+ * First attempts to use node-sql-parser for structure normalization, then applies regex for value replacement.
+ * Falls back to regex-based normalization if parsing fails.
+ * @param sql - SQL query string to normalize
+ * @returns Normalized SQL string with parameters replaced by '?'
+ */
+function normalizeSqlForLogging(sql) {
+    try {
+        const parser = new node_sql_parser_1.Parser();
+        const ast = parser.astify(sql.trim());
+        // Convert AST back to SQL (this normalizes structure and formatting)
+        const normalized = parser.sqlify(Array.isArray(ast) ? ast[0] : ast);
+        // Apply regex-based value replacement to the normalized SQL
+        // This handles the case where sqlify might preserve some literal values
+        let result = normalizeSqlForLoggingRegex(normalized.trim());
+        // Remove backticks added by sqlify for cleaner logging (optional - can be removed if backticks are preferred)
+        result = result.replace(/`/g, "");
+        return result;
+        //eslint-disable-next-line @typescript-eslint/no-unused-vars
+    }
+    catch (e) {
+        // If parsing fails, fall back to regex-based normalization
+        return normalizeSqlForLoggingRegex(sql);
+    }
+}
+/**
+ * Formats an execution plan array into a readable string representation.
+ * @param planRows - Array of ExplainAnalyzeRow objects representing the execution plan
+ * @returns Formatted string representation of the execution plan
+ */
+function formatExplainPlan(planRows) {
+    if (!planRows || planRows.length === 0) {
+        return "No execution plan available";
+    }
+    const lines = [];
+    for (const row of planRows) {
+        const parts = [];
+        if (row.id)
+            parts.push(row.id);
+        if (row.task)
+            parts.push(`task:${row.task}`);
+        if (row.operatorInfo)
+            parts.push(row.operatorInfo);
+        const rowInfo = [];
+        if (row.estRows)
+            rowInfo.push(`estRows:${row.estRows}`);
+        if (row.actRows)
+            rowInfo.push(`actRows:${row.actRows}`);
+        if (rowInfo.length > 0)
+            parts.push(`[${rowInfo.join(", ")}]`);
+        if (row.executionInfo)
+            parts.push(`execution info:${row.executionInfo}`);
+        const resourceInfo = [];
+        if (row.memory)
+            resourceInfo.push(`memory:${row.memory}`);
+        if (row.disk)
+            resourceInfo.push(`disk:${row.disk}`);
+        if (resourceInfo.length > 0)
+            parts.push(`(${resourceInfo.join(", ")})`);
+        if (row.accessObject)
+            parts.push(`access object:${row.accessObject}`);
+        lines.push(parts.join(" | "));
+    }
+    return lines.join("\n");
+}
+/**
+ * Prints query plans using summary tables if mode is SummaryTable and within time window.
+ * @param context - The metadata query context
+ * @param options - The merged options with defaults
+ * @returns Promise that resolves when plans are printed
+ */
+async function printPlansUsingSummaryTables(context, options) {
+    const timeDiff = Date.now() - context.beginTime.getTime();
+    if (options.mode !== "SummaryTable") {
+        return false;
+    }
+    if (timeDiff <= options.summaryTableWindowTime) {
+        await new Promise((resolve) => setTimeout(resolve, 200));
+        const summaryTableDiffMs = Date.now() - context.beginTime.getTime();
+        await (0, sqlUtils_1.printQueriesWithPlan)(context.forgeSQLORM, summaryTableDiffMs);
+        return true;
+    }
+    // eslint-disable-next-line no-console
+    console.warn("Summary table window expired — showing query plans instead");
+    return false;
+}
+/**
+ * Prints query plans for the top slowest queries.
+ * @param context - The metadata query context
+ * @param options - The merged options with defaults
+ * @returns Promise that resolves when plans are printed
+ */
+async function printTopQueriesPlans(context, options) {
+    const topQueries = context.statistics
+        .sort((a, b) => b.metadata.dbExecutionTime - a.metadata.dbExecutionTime)
+        .slice(0, options.topQueries);
+    for (const query of topQueries) {
+        const normalizedQuery = options.normalizeQuery
+            ? normalizeSqlForLogging(query.query)
+            : query.query;
+        if (options.showSlowestPlans) {
+            const explainAnalyzeRows = await context.forgeSQLORM
+                .analyze()
+                .explainAnalyzeRaw(query.query, query.params);
+            const formattedPlan = formatExplainPlan(explainAnalyzeRows);
+            // eslint-disable-next-line no-console
+            console.warn(`SQL: ${normalizedQuery} | Time: ${query.metadata.dbExecutionTime} ms\n Plan:\n${formattedPlan}`);
+        }
+        else {
+            // eslint-disable-next-line no-console
+            console.warn(`SQL: ${normalizedQuery} | Time: ${query.metadata.dbExecutionTime} ms`);
+        }
+    }
+}
+/**
+ * Saves query metadata to the current context and sets up the printQueriesWithPlan function.
+ * @param stringQuery - The SQL query string
+ * @param params - Query parameters
+ * @param metadata - Query execution metadata
+ */
+async function saveMetaDataToContext(stringQuery, params, metadata) {
     const context = exports.metadataQueryContext.getStore();
-    if (context) {
-        context.printQueriesWithPlan = async () => {
-            if (process.env.NODE_ENV !== "test") {
-                await new Promise((r) => setTimeout(r, 200));
-            }
-            await (0, sqlUtils_1.printQueriesWithPlan)(context.forgeSQLORM, Date.now() - context.beginTime.getTime());
-        };
-        if (metadata) {
-            context.totalResponseSize += metadata.responseSize;
-            context.totalDbExecutionTime += metadata.dbExecutionTime;
+    if (!context) {
+        return;
+    }
+    // Initialize statistics array if needed
+    if (!context.statistics) {
+        context.statistics = [];
+    }
+    // Merge options with defaults
+    context.options = mergeOptionsWithDefaults(context.options);
+    // Add query statistics
+    context.statistics.push({ query: stringQuery, params, metadata });
+    // Set up printQueriesWithPlan function
+    context.printQueriesWithPlan = async () => {
+        const options = mergeOptionsWithDefaults(context.options);
+        // Try to use summary tables first if enabled
+        const usedSummaryTables = await printPlansUsingSummaryTables(context, options);
+        if (usedSummaryTables) {
+            return;
         }
-        // Log the results to console
+        // Fall back to printing top queries plans
+        await printTopQueriesPlans(context, options);
+    };
+    // Update aggregated metrics
+    if (metadata) {
+        context.totalResponseSize += metadata.responseSize;
+        context.totalDbExecutionTime += metadata.dbExecutionTime;
     }
 }
+/**
+ * Gets the latest metadata from the current context.
+ * @returns The current metadata context or undefined if not in a context
+ */
 async function getLastestMetadata() {
     return exports.metadataQueryContext.getStore();
 }

package/dist/utils/metadataContextUtils.js.map

@@ -1 +1 @@
-{"version":3,"file":"metadataContextUtils.js","sourceRoot":"","sources":["../../src/utils/metadataContextUtils.ts"],"names":[],"mappings":";;;AAcA,sDAeC;AAED,gDAEC;AAjCD,uDAAqD;AAGrD,yCAAkD;AASrC,QAAA,oBAAoB,GAAG,IAAI,oCAAiB,EAAwB,CAAC;AAE3E,KAAK,UAAU,qBAAqB,CAAC,QAA2B;IACrE,MAAM,OAAO,GAAG,4BAAoB,CAAC,QAAQ,EAAE,CAAC;IAChD,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,CAAC,oBAAoB,GAAG,KAAK,IAAI,EAAE;YACxC,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;gBACpC,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;YAC/C,CAAC;YACD,MAAM,IAAA,+BAAoB,EAAC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;QAC5F,CAAC,CAAC;QACF,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,CAAC,iBAAiB,IAAI,QAAQ,CAAC,YAAY,CAAC;YACnD,OAAO,CAAC,oBAAoB,IAAI,QAAQ,CAAC,eAAe,CAAC;QAC3D,CAAC;QACD,6BAA6B;IAC/B,CAAC;AACH,CAAC;AAEM,KAAK,UAAU,kBAAkB;IACtC,OAAO,4BAAoB,CAAC,QAAQ,EAAE,CAAC;AACzC,CAAC"}
+{"version":3,"file":"metadataContextUtils.js","sourceRoot":"","sources":["../../src/utils/metadataContextUtils.ts"],"names":[],"mappings":"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"}

package/dist/webtriggers/index.d.ts

@@ -4,6 +4,7 @@ export * from "./fetchSchemaWebTrigger";
 export * from "./dropTablesMigrationWebTrigger";
 export * from "./clearCacheSchedulerTrigger";
 export * from "./slowQuerySchedulerTrigger";
+export * from "./topSlowestStatementLastHourTrigger";
 export interface TriggerResponse<BODY> {
     body?: BODY;
     headers?: Record<string, string[]>;

package/dist/webtriggers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/webtriggers/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,iCAAiC,CAAC;AAChD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAE5C,MAAM,WAAW,eAAe,CAAC,IAAI;IACnC,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,eAAe,GAAI,IAAI,EAAE,YAAY,MAAM,EAAE,MAAM,IAAI,KAAG,eAAe,CAAC,IAAI,CAc1F,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/webtriggers/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,iCAAiC,CAAC;AAChD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sCAAsC,CAAC;AAErD,MAAM,WAAW,eAAe,CAAC,IAAI;IACnC,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,eAAe,GAAI,IAAI,EAAE,YAAY,MAAM,EAAE,MAAM,IAAI,KAAG,eAAe,CAAC,IAAI,CAc1F,CAAC"}

package/dist/webtriggers/index.js

@@ -21,6 +21,7 @@ __exportStar(require("./fetchSchemaWebTrigger"), exports);
 __exportStar(require("./dropTablesMigrationWebTrigger"), exports);
 __exportStar(require("./clearCacheSchedulerTrigger"), exports);
 __exportStar(require("./slowQuerySchedulerTrigger"), exports);
+__exportStar(require("./topSlowestStatementLastHourTrigger"), exports);
 const getHttpResponse = (statusCode, body) => {
     let statusText = "";
     if (statusCode === 200) {

package/dist/webtriggers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/webtriggers/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,4DAA0C;AAC1C,8DAA4C;AAC5C,0DAAwC;AACxC,kEAAgD;AAChD,+DAA6C;AAC7C,8DAA4C;AASrC,MAAM,eAAe,GAAG,CAAO,UAAkB,EAAE,IAAU,EAAyB,EAAE;IAC7F,IAAI,UAAU,GAAG,EAAE,CAAC;IACpB,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;QACvB,UAAU,GAAG,IAAI,CAAC;IACpB,CAAC;SAAM,CAAC;QACN,UAAU,GAAG,aAAa,CAAC;IAC7B,CAAC;IAED,OAAO;QACL,OAAO,EAAE,EAAE,cAAc,EAAE,CAAC,kBAAkB,CAAC,EAAE;QACjD,UAAU;QACV,UAAU;QACV,IAAI;KACL,CAAC;AACJ,CAAC,CAAC;AAdW,QAAA,eAAe,mBAc1B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/webtriggers/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,4DAA0C;AAC1C,8DAA4C;AAC5C,0DAAwC;AACxC,kEAAgD;AAChD,+DAA6C;AAC7C,8DAA4C;AAC5C,uEAAqD;AAS9C,MAAM,eAAe,GAAG,CAAO,UAAkB,EAAE,IAAU,EAAyB,EAAE;IAC7F,IAAI,UAAU,GAAG,EAAE,CAAC;IACpB,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;QACvB,UAAU,GAAG,IAAI,CAAC;IACpB,CAAC;SAAM,CAAC;QACN,UAAU,GAAG,aAAa,CAAC;IAC7B,CAAC;IAED,OAAO;QACL,OAAO,EAAE,EAAE,cAAc,EAAE,CAAC,kBAAkB,CAAC,EAAE;QACjD,UAAU;QACV,UAAU;QACV,IAAI;KACL,CAAC;AACJ,CAAC,CAAC;AAdW,QAAA,eAAe,mBAc1B"}

package/dist/webtriggers/topSlowestStatementLastHourTrigger.d.ts

@@ -0,0 +1,60 @@
+import { ForgeSqlOperation } from "../core/ForgeSQLQueryBuilder";
+import { TriggerResponse } from "./";
+import { OperationType } from "../utils/requestTypeContextUtils";
+export interface TriggerOptions {
+    warnThresholdMs?: number;
+    memoryThresholdBytes?: number;
+    showPlan?: boolean;
+    operationType?: OperationType;
+    topN?: number;
+    hours?: number;
+    tables?: "SUMMARY_AND_HISTORY" | "CLUSTER_SUMMARY_AND_HISTORY";
+}
+/**
+ * @deprecated This function is deprecated and will be removed in a future version.
+ *
+ * This function was previously a complex implementation that directly queried
+ * CLUSTER_STATEMENTS_SUMMARY tables to analyze query performance. However, this approach
+ * had reliability issues with long-running functions where metadata could be evicted
+ * before the function completes.
+ *
+ * The recommended replacement is to use the new observability system with `executeWithMetadata`:
+ * - **TopSlowest mode** (default): Deterministic logging of SQL digests executed in resolvers
+ * - **SummaryTable mode** (optional): Uses CLUSTER_STATEMENTS_SUMMARY with a short memory window
+ * - Automatic fallback mechanisms for long-running functions
+ * - More reliable post-mortem diagnostics for Timeout and OOM errors
+ *
+ * Note: `slowQuerySchedulerTrigger` is a different function that analyzes TiDB's slow query log
+ * and is not a direct replacement for this function.
+ *
+ * For more details on the improvements and migration path, see:
+ * https://community.developer.atlassian.com/t/practical-sql-observability-for-forge-apps-with-forge-sql-orm/123456
+ *
+ * @param orm - ForgeSQL ORM instance
+ * @param options - Configuration options (currently passed to slowQuerySchedulerTrigger as a temporary wrapper)
+ * @returns Promise<TriggerResponse<string>> - HTTP response with query results or error
+ *
+ * @example
+ * ```typescript
+ * // Old usage (deprecated):
+ * await topSlowestStatementLastHourTrigger(forgeSQL, { hours: 1 });
+ *
+ * // New usage (recommended - use executeWithMetadata in your resolvers):
+ * await forgeSQL.executeWithMetadata(
+ *   async () => {
+ *     // your resolver logic
+ *   },
+ *   async (totalDbTime, totalResponseSize, printPlan) => {
+ *     // custom observability logic
+ *     if (totalDbTime > 1000) await printPlan();
+ *   },
+ *   {
+ *     mode: "TopSlowest",
+ *     topQueries: 1,
+ *     showSlowestPlans: true
+ *   }
+ * );
+ * ```
+ */
+export declare const topSlowestStatementLastHourTrigger: (orm: ForgeSqlOperation, options?: TriggerOptions) => Promise<TriggerResponse<string>>;
+//# sourceMappingURL=topSlowestStatementLastHourTrigger.d.ts.map

package/dist/webtriggers/topSlowestStatementLastHourTrigger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topSlowestStatementLastHourTrigger.d.ts","sourceRoot":"","sources":["../../src/webtriggers/topSlowestStatementLastHourTrigger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAA6B,eAAe,EAAE,MAAM,IAAI,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEjE,MAAM,WAAW,cAAc;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,qBAAqB,GAAG,6BAA6B,CAAC;CAChE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,eAAO,MAAM,kCAAkC,GAC7C,KAAK,iBAAiB,EACtB,UAAU,cAAc,KACvB,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAKjC,CAAC"}

package/dist/webtriggers/topSlowestStatementLastHourTrigger.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.topSlowestStatementLastHourTrigger = void 0;
+const _1 = require("./");
+/**
+ * @deprecated This function is deprecated and will be removed in a future version.
+ *
+ * This function was previously a complex implementation that directly queried
+ * CLUSTER_STATEMENTS_SUMMARY tables to analyze query performance. However, this approach
+ * had reliability issues with long-running functions where metadata could be evicted
+ * before the function completes.
+ *
+ * The recommended replacement is to use the new observability system with `executeWithMetadata`:
+ * - **TopSlowest mode** (default): Deterministic logging of SQL digests executed in resolvers
+ * - **SummaryTable mode** (optional): Uses CLUSTER_STATEMENTS_SUMMARY with a short memory window
+ * - Automatic fallback mechanisms for long-running functions
+ * - More reliable post-mortem diagnostics for Timeout and OOM errors
+ *
+ * Note: `slowQuerySchedulerTrigger` is a different function that analyzes TiDB's slow query log
+ * and is not a direct replacement for this function.
+ *
+ * For more details on the improvements and migration path, see:
+ * https://community.developer.atlassian.com/t/practical-sql-observability-for-forge-apps-with-forge-sql-orm/123456
+ *
+ * @param orm - ForgeSQL ORM instance
+ * @param options - Configuration options (currently passed to slowQuerySchedulerTrigger as a temporary wrapper)
+ * @returns Promise<TriggerResponse<string>> - HTTP response with query results or error
+ *
+ * @example
+ * ```typescript
+ * // Old usage (deprecated):
+ * await topSlowestStatementLastHourTrigger(forgeSQL, { hours: 1 });
+ *
+ * // New usage (recommended - use executeWithMetadata in your resolvers):
+ * await forgeSQL.executeWithMetadata(
+ *   async () => {
+ *     // your resolver logic
+ *   },
+ *   async (totalDbTime, totalResponseSize, printPlan) => {
+ *     // custom observability logic
+ *     if (totalDbTime > 1000) await printPlan();
+ *   },
+ *   {
+ *     mode: "TopSlowest",
+ *     topQueries: 1,
+ *     showSlowestPlans: true
+ *   }
+ * );
+ * ```
+ */
+const topSlowestStatementLastHourTrigger = async (orm, options) => {
+    return (0, _1.slowQuerySchedulerTrigger)(orm, options ? { timeout: 3000, hours: options.hours ?? 1 } : { timeout: 3000, hours: 1 });
+};
+exports.topSlowestStatementLastHourTrigger = topSlowestStatementLastHourTrigger;
+//# sourceMappingURL=topSlowestStatementLastHourTrigger.js.map

package/dist/webtriggers/topSlowestStatementLastHourTrigger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"topSlowestStatementLastHourTrigger.js","sourceRoot":"","sources":["../../src/webtriggers/topSlowestStatementLastHourTrigger.ts"],"names":[],"mappings":";;;AACA,yBAAgE;AAahE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACI,MAAM,kCAAkC,GAAG,KAAK,EACrD,GAAsB,EACtB,OAAwB,EACU,EAAE;IACpC,OAAO,IAAA,4BAAyB,EAC9B,GAAG,EACH,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,CACrF,CAAC;AACJ,CAAC,CAAC;AARW,QAAA,kCAAkC,sCAQ7C"}