forge-sql-orm 2.1.12 → 2.1.13

package/dist/webtriggers/applyMigrationsWebTrigger.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applySchemaMigrations = void 0;
+const sql_1 = require("@forge/sql");
+/**
+ * Web trigger for applying database schema migrations in Atlassian Forge SQL.
+ * This function handles the complete migration process including:
+ * - Database provisioning
+ * - Migration execution
+ * - Migration history tracking
+ *
+ * @param migration - A function that takes a MigrationRunner instance and returns a Promise of MigrationRunner
+ *                     This function should define the sequence of migrations to be applied
+ * @returns {Promise<{
+ *   headers: { "Content-Type": ["application/json"] },
+ *   statusCode: number,
+ *   statusText: string,
+ *   body: string
+ * }>} A response object containing:
+ * - headers: Content-Type header set to application/json
+ * - statusCode: 200 on success
+ * - statusText: "OK" on success
+ * - body: Success message or error details
+ *
+ * @throws {Error} If database provisioning fails
+ * @throws {Error} If migration execution fails
+ */
+const applySchemaMigrations = async (migration) => {
+    try {
+        if (typeof migration !== "function") {
+            throw new Error("migration is not a function");
+        }
+        // eslint-disable-next-line no-console
+        console.debug("Provisioning the database");
+        await sql_1.sql._provision();
+        // eslint-disable-next-line no-console
+        console.debug("Running schema migrations");
+        const migrations = await migration(sql_1.migrationRunner);
+        const successfulMigrations = await migrations.run();
+        // eslint-disable-next-line no-console
+        console.debug("Migrations applied:", successfulMigrations);
+        const migrationList = await sql_1.migrationRunner.list();
+        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");
+        }
+        // eslint-disable-next-line no-console
+        console.debug("Migrations history:\nid, name, migrated_at\n", migrationHistory);
+        return {
+            headers: { "Content-Type": ["application/json"] },
+            statusCode: 200,
+            statusText: "OK",
+            body: "Migrations successfully executed",
+        };
+    }
+    catch (error) {
+        const errorMessage = error?.cause?.context?.debug?.sqlMessage ??
+            error?.cause?.context?.debug?.message ??
+            error?.debug?.context?.sqlMessage ??
+            error?.debug?.context?.message ??
+            error.message ??
+            "Unknown error occurred";
+        // eslint-disable-next-line no-console
+        console.error("Error during migration:", errorMessage);
+        return {
+            headers: { "Content-Type": ["application/json"] },
+            statusCode: 500,
+            statusText: "Internal Server Error",
+            body: error instanceof Error ? errorMessage : "Unknown error during migration",
+        };
+    }
+};
+exports.applySchemaMigrations = applySchemaMigrations;
+//# sourceMappingURL=applyMigrationsWebTrigger.js.map

package/dist/webtriggers/applyMigrationsWebTrigger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"applyMigrationsWebTrigger.js","sourceRoot":"","sources":["../../src/webtriggers/applyMigrationsWebTrigger.ts"],"names":[],"mappings":";;;AAAA,oCAAkD;AAGlD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACI,MAAM,qBAAqB,GAAG,KAAK,EACxC,SAAyE,EACzE,EAAE;IACF,IAAI,CAAC;QACH,IAAI,OAAO,SAAS,KAAK,UAAU,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACjD,CAAC;QACD,sCAAsC;QACtC,OAAO,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC3C,MAAM,SAAG,CAAC,UAAU,EAAE,CAAC;QACvB,sCAAsC;QACtC,OAAO,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC3C,MAAM,UAAU,GAAG,MAAM,SAAS,CAAC,qBAAe,CAAC,CAAC;QACpD,MAAM,oBAAoB,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,CAAC;QACpD,sCAAsC;QACtC,OAAO,CAAC,KAAK,CAAC,qBAAqB,EAAE,oBAAoB,CAAC,CAAC;QAE3D,MAAM,aAAa,GAAG,MAAM,qBAAe,CAAC,IAAI,EAAE,CAAC;QACnD,IAAI,gBAAgB,GAAG,qBAAqB,CAAC;QAE7C,IAAI,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7D,MAAM,gBAAgB,GAAG,aAAa,CAAC,QAAQ,CAC7C,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,UAAU,CAAC,OAAO,EAAE,CAC1D,CAAC;YAEF,gBAAgB,GAAG,gBAAgB;iBAChC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,UAAU,CAAC,WAAW,EAAE,EAAE,CAAC;iBAC/D,IAAI,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC;QACD,sCAAsC;QACtC,OAAO,CAAC,KAAK,CAAC,8CAA8C,EAAE,gBAAgB,CAAC,CAAC;QAEhF,OAAO;YACL,OAAO,EAAE,EAAE,cAAc,EAAE,CAAC,kBAAkB,CAAC,EAAE;YACjD,UAAU,EAAE,GAAG;YACf,UAAU,EAAE,IAAI;YAChB,IAAI,EAAE,kCAAkC;SACzC,CAAC;IACJ,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,MAAM,YAAY,GAChB,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU;YACxC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO;YACrC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU;YACjC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO;YAC9B,KAAK,CAAC,OAAO;YACb,wBAAwB,CAAC;QAC3B,sCAAsC;QACtC,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,YAAY,CAAC,CAAC;QACvD,OAAO;YACL,OAAO,EAAE,EAAE,cAAc,EAAE,CAAC,kBAAkB,CAAC,EAAE;YACjD,UAAU,EAAE,GAAG;YACf,UAAU,EAAE,uBAAuB;YACnC,IAAI,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,gCAAgC;SAC/E,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AAvDW,QAAA,qBAAqB,yBAuDhC"}

package/dist/webtriggers/clearCacheSchedulerTrigger.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clearCacheSchedulerTrigger = void 0;
+const cacheUtils_1 = require("../utils/cacheUtils");
+/**
+ * Scheduler trigger for clearing expired cache entries.
+ *
+ * This trigger should be configured as a Forge scheduler to automatically
+ * clean up expired cache entries based on their TTL (Time To Live).
+ *
+ * @param options - Optional ForgeSQL ORM configuration. If not provided,
+ *                  uses default cache settings with cacheEntityName: "cache"
+ * @returns Promise that resolves to HTTP response object
+ *
+ * @example
+ * ```typescript
+ * // In your index.ts
+ * import { clearCacheSchedulerTrigger } from "forge-sql-orm";
+ *
+ * export const clearCache = () => {
+ *   return clearCacheSchedulerTrigger({
+ *     cacheEntityName: "cache",
+ *     logRawSqlQuery: true
+ *   });
+ * };
+ * ```
+ *
+ * @example
+ * ```yaml
+ * # In manifest.yml
+ * scheduledTrigger:
+ *   - key: clear-cache-trigger
+ *     function: clearCache
+ *     interval: fiveMinute
+ *
+ * function:
+ *   - key: clearCache
+ *     handler: index.clearCache
+ * ```
+ */
+const clearCacheSchedulerTrigger = async (options) => {
+    try {
+        const newOptions = options ?? {
+            logRawSqlQuery: false,
+            disableOptimisticLocking: false,
+            cacheTTL: 120,
+            cacheEntityName: "cache",
+            cacheEntityQueryName: "sql",
+            cacheEntityExpirationName: "expiration",
+            cacheEntityDataName: "data",
+        };
+        if (!newOptions.cacheEntityName) {
+            throw new Error("cacheEntityName is not configured");
+        }
+        await (0, cacheUtils_1.clearExpiredCache)(newOptions);
+        return {
+            headers: { "Content-Type": ["application/json"] },
+            statusCode: 200,
+            statusText: "OK",
+            body: JSON.stringify({
+                success: true,
+                message: "Cache cleanup completed successfully",
+                timestamp: new Date().toISOString(),
+            }),
+        };
+    }
+    catch (error) {
+        // eslint-disable-next-line no-console
+        console.error("Error during cache cleanup: ", JSON.stringify(error));
+        return {
+            headers: { "Content-Type": ["application/json"] },
+            statusCode: 500,
+            statusText: "Internal Server Error",
+            body: JSON.stringify({
+                success: false,
+                error: error instanceof Error ? error.message : "Unknown error during cache cleanup",
+                timestamp: new Date().toISOString(),
+            }),
+        };
+    }
+};
+exports.clearCacheSchedulerTrigger = clearCacheSchedulerTrigger;
+//# sourceMappingURL=clearCacheSchedulerTrigger.js.map

package/dist/webtriggers/clearCacheSchedulerTrigger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clearCacheSchedulerTrigger.js","sourceRoot":"","sources":["../../src/webtriggers/clearCacheSchedulerTrigger.ts"],"names":[],"mappings":";;;AAAA,oDAAwD;AAGxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACI,MAAM,0BAA0B,GAAG,KAAK,EAAE,OAA4B,EAAE,EAAE;IAC/E,IAAI,CAAC;QACH,MAAM,UAAU,GAAuB,OAAO,IAAI;YAChD,cAAc,EAAE,KAAK;YACrB,wBAAwB,EAAE,KAAK;YAC/B,QAAQ,EAAE,GAAG;YACb,eAAe,EAAE,OAAO;YACxB,oBAAoB,EAAE,KAAK;YAC3B,yBAAyB,EAAE,YAAY;YACvC,mBAAmB,EAAE,MAAM;SAC5B,CAAC;QACF,IAAI,CAAC,UAAU,CAAC,eAAe,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACvD,CAAC;QACD,MAAM,IAAA,8BAAiB,EAAC,UAAU,CAAC,CAAC;QAEpC,OAAO;YACL,OAAO,EAAE,EAAE,cAAc,EAAE,CAAC,kBAAkB,CAAC,EAAE;YACjD,UAAU,EAAE,GAAG;YACf,UAAU,EAAE,IAAI;YAChB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,sCAAsC;gBAC/C,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,CAAC;SACH,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,sCAAsC;QACtC,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QACrE,OAAO;YACL,OAAO,EAAE,EAAE,cAAc,EAAE,CAAC,kBAAkB,CAAC,EAAE;YACjD,UAAU,EAAE,GAAG;YACf,UAAU,EAAE,uBAAuB;YACnC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,oCAAoC;gBACpF,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,CAAC;SACH,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AAxCW,QAAA,0BAA0B,8BAwCrC"}

package/dist/webtriggers/dropMigrationWebTrigger.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dropSchemaMigrations = dropSchemaMigrations;
+const sql_1 = require("@forge/sql");
+const sqlUtils_1 = require("../utils/sqlUtils");
+const index_1 = require("./index");
+const SystemTables_1 = require("../core/SystemTables");
+/**
+ * ⚠️ DEVELOPMENT ONLY WEB TRIGGER ⚠️
+ *
+ * This web trigger is designed for development environments only and will permanently delete all data in the specified tables and sequences.
+ * It generates and executes SQL statements to drop tables, their associated constraints, and sequences.
+ *
+ * @warning This trigger should NEVER be used in production environments because:
+ * - It permanently deletes all data in the specified tables and sequences
+ * - The operation cannot be undone
+ * - It may affect application functionality
+ * - It could lead to data loss and system instability
+ *
+ * @returns {Promise<TriggerResponse<string>>} A response containing:
+ * - On success: 200 status with warning message about permanent deletion of tables and sequences
+ * - On failure: 500 status with error message
+ *
+ * @example
+ * ```typescript
+ * // Example usage in development only
+ * await dropSchemaMigrations();
+ * // ⚠️ Warning: This will permanently delete all data in users and orders tables and their sequences
+ * ```
+ */
+async function dropSchemaMigrations() {
+    try {
+        const tables = await (0, SystemTables_1.getTables)();
+        // Generate drop statements
+        const dropStatements = (0, sqlUtils_1.generateDropTableStatements)(tables, { sequence: true, table: true });
+        // Execute each statement
+        for (const statement of dropStatements) {
+            // eslint-disable-next-line no-console
+            console.debug(`execute DDL: ${statement}`);
+            await sql_1.sql.executeDDL(statement);
+        }
+        return (0, index_1.getHttpResponse)(200, "⚠️ All data in these tables has been permanently deleted. This operation cannot be undone.");
+    }
+    catch (error) {
+        const errorMessage = error?.debug?.sqlMessage ??
+            error?.debug?.message ??
+            error.message ??
+            "Unknown error occurred";
+        // eslint-disable-next-line no-console
+        console.error(errorMessage);
+        return (0, index_1.getHttpResponse)(500, errorMessage);
+    }
+}
+//# sourceMappingURL=dropMigrationWebTrigger.js.map

package/dist/webtriggers/dropMigrationWebTrigger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dropMigrationWebTrigger.js","sourceRoot":"","sources":["../../src/webtriggers/dropMigrationWebTrigger.ts"],"names":[],"mappings":";;AA4BA,oDA2BC;AAvDD,oCAAiC;AACjC,gDAAsF;AACtF,mCAA2D;AAC3D,uDAAiD;AAEjD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACI,KAAK,UAAU,oBAAoB;IACxC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAA,wBAAS,GAAE,CAAC;QACjC,2BAA2B;QAC3B,MAAM,cAAc,GAAG,IAAA,sCAAkB,EAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAEnF,yBAAyB;QACzB,KAAK,MAAM,SAAS,IAAI,cAAc,EAAE,CAAC;YACvC,sCAAsC;YACtC,OAAO,CAAC,KAAK,CAAC,gBAAgB,SAAS,EAAE,CAAC,CAAC;YAC3C,MAAM,SAAG,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAClC,CAAC;QAED,OAAO,IAAA,uBAAe,EACpB,GAAG,EACH,4FAA4F,CAC7F,CAAC;IACJ,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,MAAM,YAAY,GAChB,KAAK,EAAE,KAAK,EAAE,UAAU;YACxB,KAAK,EAAE,KAAK,EAAE,OAAO;YACrB,KAAK,CAAC,OAAO;YACb,wBAAwB,CAAC;QAC3B,sCAAsC;QACtC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAC5B,OAAO,IAAA,uBAAe,EAAS,GAAG,EAAE,YAAY,CAAC,CAAC;IACpD,CAAC;AACH,CAAC"}

package/dist/webtriggers/dropTablesMigrationWebTrigger.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dropTableSchemaMigrations = dropTableSchemaMigrations;
+const sql_1 = require("@forge/sql");
+const sqlUtils_1 = require("../utils/sqlUtils");
+const index_1 = require("./index");
+const SystemTables_1 = require("../core/SystemTables");
+/**
+ * ⚠️ DEVELOPMENT ONLY WEB TRIGGER ⚠️
+ *
+ * This web trigger is designed for development environments only and will permanently delete all data in the specified tables.
+ * It generates and executes SQL statements to drop tables and their associated constraints.
+ *
+ * @warning This trigger should NEVER be used in production environments because:
+ * - It permanently deletes all data in the specified tables
+ * - The operation cannot be undone
+ * - It may affect application functionality
+ * - It could lead to data loss and system instability
+ *
+ * @returns {Promise<TriggerResponse<string>>} A response containing:
+ * - On success: 200 status with warning message about permanent deletion
+ * - On failure: 500 status with error message
+ *
+ * @example
+ * ```typescript
+ * // Example usage in development only
+ * await dropTableSchemaMigrations();
+ * // ⚠️ Warning: This will permanently delete all data in users and orders tables
+ * ```
+ */
+async function dropTableSchemaMigrations() {
+    try {
+        const tables = await (0, SystemTables_1.getTables)();
+        // Generate drop statements
+        const dropStatements = (0, sqlUtils_1.generateDropTableStatements)(tables, { sequence: false, table: true });
+        // Execute each statement
+        for (const statement of dropStatements) {
+            // eslint-disable-next-line no-console
+            console.debug(`execute DDL: ${statement}`);
+            await sql_1.sql.executeDDL(statement);
+        }
+        return (0, index_1.getHttpResponse)(200, "⚠️ All data in these tables has been permanently deleted. This operation cannot be undone.");
+    }
+    catch (error) {
+        const errorMessage = error?.debug?.sqlMessage ??
+            error?.debug?.message ??
+            error.message ??
+            "Unknown error occurred";
+        // eslint-disable-next-line no-console
+        console.error(errorMessage);
+        return (0, index_1.getHttpResponse)(500, errorMessage);
+    }
+}
+//# sourceMappingURL=dropTablesMigrationWebTrigger.js.map

package/dist/webtriggers/dropTablesMigrationWebTrigger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dropTablesMigrationWebTrigger.js","sourceRoot":"","sources":["../../src/webtriggers/dropTablesMigrationWebTrigger.ts"],"names":[],"mappings":";;AA4BA,8DA2BC;AAvDD,oCAAiC;AACjC,gDAAsF;AACtF,mCAA2D;AAC3D,uDAAiD;AAEjD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACI,KAAK,UAAU,yBAAyB;IAC7C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAA,wBAAS,GAAE,CAAC;QACjC,2BAA2B;QAC3B,MAAM,cAAc,GAAG,IAAA,sCAAkB,EAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAEpF,yBAAyB;QACzB,KAAK,MAAM,SAAS,IAAI,cAAc,EAAE,CAAC;YACvC,sCAAsC;YACtC,OAAO,CAAC,KAAK,CAAC,gBAAgB,SAAS,EAAE,CAAC,CAAC;YAC3C,MAAM,SAAG,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAClC,CAAC;QAED,OAAO,IAAA,uBAAe,EACpB,GAAG,EACH,4FAA4F,CAC7F,CAAC;IACJ,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,MAAM,YAAY,GAChB,KAAK,EAAE,KAAK,EAAE,UAAU;YACxB,KAAK,EAAE,KAAK,EAAE,OAAO;YACrB,KAAK,CAAC,OAAO;YACb,wBAAwB,CAAC;QAC3B,sCAAsC;QACtC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAC5B,OAAO,IAAA,uBAAe,EAAS,GAAG,EAAE,YAAY,CAAC,CAAC;IACpD,CAAC;AACH,CAAC"}

package/dist/webtriggers/fetchSchemaWebTrigger.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchSchemaWebTrigger = fetchSchemaWebTrigger;
+const sql_1 = require("@forge/sql");
+const index_1 = require("./index");
+const SystemTables_1 = require("../core/SystemTables");
+const table_1 = require("drizzle-orm/table");
+/**
+ * ⚠️ DEVELOPMENT ONLY WEB TRIGGER ⚠️
+ *
+ * This web trigger retrieves the current database schema from Atlassian Forge SQL.
+ * It generates SQL statements that can be used to recreate the database structure.
+ *
+ * @warning This trigger should ONLY be used in development environments. It:
+ * - Exposes your database structure
+ * - Disables foreign key checks temporarily
+ * - Generates SQL that could potentially be used maliciously
+ * - May expose sensitive table names and structures
+ *
+ * @returns {Promise<TriggerResponse<string>>} A response containing SQL statements to recreate the database schema
+ * - On success: Returns 200 status with SQL statements
+ * - On failure: Returns 500 status with error message
+ *
+ * @example
+ * ```typescript
+ * // The response will contain SQL statements like:
+ * // SET foreign_key_checks = 0;
+ * // CREATE TABLE IF NOT EXISTS users (...);
+ * // CREATE TABLE IF NOT EXISTS orders (...);
+ * // SET foreign_key_checks = 1;
+ * ```
+ */
+async function fetchSchemaWebTrigger() {
+    try {
+        const tables = await (0, SystemTables_1.getTables)();
+        const createTableStatements = await generateCreateTableStatements(tables);
+        const sqlStatements = wrapWithForeignKeyChecks(createTableStatements);
+        return (0, index_1.getHttpResponse)(200, sqlStatements.join(";\n"));
+    }
+    catch (error) {
+        const errorMessage = error?.debug?.sqlMessage ??
+            error?.debug?.message ??
+            error.message ??
+            "Unknown error occurred";
+        // eslint-disable-next-line no-console
+        console.error(errorMessage);
+        return (0, index_1.getHttpResponse)(500, errorMessage);
+    }
+}
+/**
+ * Generates CREATE TABLE statements for each table
+ */
+async function generateCreateTableStatements(tables) {
+    const statements = [];
+    for (const table of tables) {
+        const createTableResult = await sql_1.sql.executeDDL(`SHOW CREATE TABLE "${table}"`);
+        const createTableStatements = createTableResult.rows
+            .filter((row) => !isSystemTable(row.Table))
+            .map((row) => formatCreateTableStatement(row["Create Table"]));
+        statements.push(...createTableStatements);
+    }
+    return statements;
+}
+/**
+ * Checks if the table is a system table
+ */
+function isSystemTable(tableName) {
+    return SystemTables_1.forgeSystemTables.some((st) => (0, table_1.getTableName)(st) === tableName);
+}
+/**
+ * Formats the CREATE TABLE statement
+ */
+function formatCreateTableStatement(statement) {
+    return statement.replace(/"/g, "").replace("CREATE TABLE", "CREATE TABLE IF NOT EXISTS");
+}
+/**
+ * Wraps the SQL statements with foreign key check controls
+ */
+function wrapWithForeignKeyChecks(statements) {
+    return ["SET foreign_key_checks = 0", ...statements, "SET foreign_key_checks = 1"];
+}
+//# sourceMappingURL=fetchSchemaWebTrigger.js.map

package/dist/webtriggers/fetchSchemaWebTrigger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchSchemaWebTrigger.js","sourceRoot":"","sources":["../../src/webtriggers/fetchSchemaWebTrigger.ts"],"names":[],"mappings":";;AAmCA,sDAiBC;AApDD,oCAAiC;AACjC,mCAA2D;AAC3D,uDAAoE;AACpE,6CAAiD;AAOjD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACI,KAAK,UAAU,qBAAqB;IACzC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAA,wBAAS,GAAE,CAAC;QACjC,MAAM,qBAAqB,GAAG,MAAM,6BAA6B,CAAC,MAAM,CAAC,CAAC;QAC1E,MAAM,aAAa,GAAG,wBAAwB,CAAC,qBAAqB,CAAC,CAAC;QAEtE,OAAO,IAAA,uBAAe,EAAS,GAAG,EAAE,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACjE,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,MAAM,YAAY,GAChB,KAAK,EAAE,KAAK,EAAE,UAAU;YACxB,KAAK,EAAE,KAAK,EAAE,OAAO;YACrB,KAAK,CAAC,OAAO;YACb,wBAAwB,CAAC;QAC3B,sCAAsC;QACtC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAC5B,OAAO,IAAA,uBAAe,EAAS,GAAG,EAAE,YAAY,CAAC,CAAC;IACpD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,6BAA6B,CAAC,MAAgB;IAC3D,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,iBAAiB,GAAG,MAAM,SAAG,CAAC,UAAU,CAAiB,sBAAsB,KAAK,GAAG,CAAC,CAAC;QAE/F,MAAM,qBAAqB,GAAG,iBAAiB,CAAC,IAAI;aACjD,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;aAC1C,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,0BAA0B,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;QAEjE,UAAU,CAAC,IAAI,CAAC,GAAG,qBAAqB,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,SAAiB;IACtC,OAAO,gCAAiB,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAA,oBAAY,EAAC,EAAE,CAAC,KAAK,SAAS,CAAC,CAAC;AACxE,CAAC;AAED;;GAEG;AACH,SAAS,0BAA0B,CAAC,SAAiB;IACnD,OAAO,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,EAAE,4BAA4B,CAAC,CAAC;AAC3F,CAAC;AAED;;GAEG;AACH,SAAS,wBAAwB,CAAC,UAAoB;IACpD,OAAO,CAAC,4BAA4B,EAAE,GAAG,UAAU,EAAE,4BAA4B,CAAC,CAAC;AACrF,CAAC"}

package/dist/webtriggers/index.js

@@ -0,0 +1,40 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getHttpResponse = void 0;
+__exportStar(require("./dropMigrationWebTrigger"), exports);
+__exportStar(require("./applyMigrationsWebTrigger"), exports);
+__exportStar(require("./fetchSchemaWebTrigger"), exports);
+__exportStar(require("./dropTablesMigrationWebTrigger"), exports);
+__exportStar(require("./clearCacheSchedulerTrigger"), exports);
+__exportStar(require("./slowQuerySchedulerTrigger"), exports);
+const getHttpResponse = (statusCode, body) => {
+    let statusText = "";
+    if (statusCode === 200) {
+        statusText = "Ok";
+    }
+    else {
+        statusText = "Bad Request";
+    }
+    return {
+        headers: { "Content-Type": ["application/json"] },
+        statusCode,
+        statusText,
+        body,
+    };
+};
+exports.getHttpResponse = getHttpResponse;
+//# sourceMappingURL=index.js.map

package/dist/webtriggers/index.js.map

@@ -0,0 +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"}

package/dist/webtriggers/slowQuerySchedulerTrigger.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.slowQuerySchedulerTrigger = slowQuerySchedulerTrigger;
+const index_1 = require("./index");
+const sqlUtils_1 = require("../utils/sqlUtils");
+/**
+ * Scheduler trigger for analyzing slow queries from the last specified number of hours.
+ *
+ * This trigger analyzes slow queries from TiDB's slow query log system table and provides
+ * detailed performance information including SQL query text, memory usage, execution time,
+ * and execution plans. It's designed to be used as a scheduled trigger in Atlassian Forge
+ * to monitor query performance over time.
+ *
+ * The function queries the slow query system table to find queries executed within the
+ * specified time window and logs detailed performance information to the console. Results
+ * are limited to the top 50 slow queries to prevent excessive output.
+ *
+ * @param forgeSQLORM - The ForgeSQL operation instance for database access
+ * @param options - Configuration options for the slow query analysis
+ * @param options.hours - Number of hours to look back for slow queries (default: 1)
+ * @param options.timeout - Timeout in milliseconds for the query execution (default: 2000ms)
+ *
+ * @returns Promise<TriggerResponse<string>> - HTTP response with JSON stringified query results or error message
+ *
+ * @example
+ * ```typescript
+ * import ForgeSQL, { slowQuerySchedulerTrigger } from "forge-sql-orm";
+ *
+ * const forgeSQL = new ForgeSQL();
+ *
+ * // Basic usage with default options (1 hour, 2000ms timeout)
+ * export const slowQueryTrigger = () =>
+ *   slowQuerySchedulerTrigger(forgeSQL, { hours: 1, timeout: 2000 });
+ *
+ * // Analyze slow queries from the last 6 hours with extended timeout
+ * export const sixHourSlowQueryTrigger = () =>
+ *   slowQuerySchedulerTrigger(forgeSQL, { hours: 6, timeout: 5000 });
+ *
+ * // Analyze slow queries from the last 24 hours
+ * export const dailySlowQueryTrigger = () =>
+ *   slowQuerySchedulerTrigger(forgeSQL, { hours: 24, timeout: 3000 });
+ * ```
+ *
+ * @example
+ * ```yaml
+ * # manifest.yml configuration
+ * scheduledTrigger:
+ *   - key: slow-query-trigger
+ *     function: slowQueryTrigger
+ *     interval: hour
+ *
+ * function:
+ *   - key: slowQueryTrigger
+ *     handler: index.slowQueryTrigger
+ * ```
+ *
+ * @remarks
+ * - Results are automatically logged to the Forge Developer Console via `console.warn()`
+ * - The function returns up to 50 slow queries to prevent excessive logging
+ * - Transient timeouts are usually fine; repeated timeouts indicate the diagnostic query itself is slow
+ * - This trigger is best used with hourly intervals to catch slow queries in a timely manner
+ * - Error responses return HTTP 500 with error details
+ *
+ * @see {@link slowQueryPerHours} - The underlying function that performs the actual query analysis
+ */
+async function slowQuerySchedulerTrigger(forgeSQLORM, options) {
+    try {
+        return (0, index_1.getHttpResponse)(200, JSON.stringify(await (0, sqlUtils_1.slowQueryPerHours)(forgeSQLORM, options?.hours ?? 1, options?.timeout ?? 3000)));
+    }
+    catch (error) {
+        const errorMessage = error?.debug?.sqlMessage ??
+            error?.debug?.message ??
+            error.message ??
+            "Unknown error occurred";
+        // eslint-disable-next-line no-console
+        console.error(errorMessage);
+        return (0, index_1.getHttpResponse)(500, errorMessage);
+    }
+}
+//# sourceMappingURL=slowQuerySchedulerTrigger.js.map

package/dist/webtriggers/slowQuerySchedulerTrigger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slowQuerySchedulerTrigger.js","sourceRoot":"","sources":["../../src/webtriggers/slowQuerySchedulerTrigger.ts"],"names":[],"mappings":";;AAgEA,8DAwBC;AAxFD,mCAA2D;AAC3D,gDAAsD;AAGtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AACI,KAAK,UAAU,yBAAyB,CAC7C,WAA8B,EAC9B,OAGC;IAED,IAAI,CAAC;QACH,OAAO,IAAA,uBAAe,EACpB,GAAG,EACH,IAAI,CAAC,SAAS,CACZ,MAAM,IAAA,4BAAiB,EAAC,WAAW,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,IAAI,IAAI,CAAC,CACpF,CACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,MAAM,YAAY,GAChB,KAAK,EAAE,KAAK,EAAE,UAAU;YACxB,KAAK,EAAE,KAAK,EAAE,OAAO;YACrB,KAAK,CAAC,OAAO;YACb,wBAAwB,CAAC;QAC3B,sCAAsC;QACtC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAC5B,OAAO,IAAA,uBAAe,EAAS,GAAG,EAAE,YAAY,CAAC,CAAC;IACpD,CAAC;AACH,CAAC"}

package/package.json

@@ -1,16 +1,8 @@
 {
   "name": "forge-sql-orm",
-  "version": "2.1.12",
+  "version": "2.1.13",
   "description": "Drizzle ORM integration for Atlassian @forge/sql. Provides a custom driver, schema migration, two levels of caching (local and global via @forge/kvs), optimistic locking, and query analysis.",
-  "main": "dist/ForgeSQLORM.js",
-  "module": "dist/ForgeSQLORM.mjs",
-  "types": "dist/index.d.ts",
-  "exports": {
-    "types": "./dist/index.d.ts",
-    "require": "./dist/ForgeSQLORM.js",
-    "import": "./dist/ForgeSQLORM.mjs",
-    "default": "./dist/ForgeSQLORM.mjs"
-  },
+  "main": "dist/index.js",
   "homepage": "https://github.com/vzakharchenko/forge-sql-orm#readme",
   "bugs": {
     "url": "https://github.com/vzakharchenko/forge-sql-orm/issues"
@@ -32,24 +24,25 @@
     "database"
   ],
   "devDependencies": {
-    "@eslint/js": "^9.39.0",
+    "@eslint/js": "^9.39.1",
     "@types/luxon": "^3.7.1",
-    "@types/node": "^24.9.2",
-    "@typescript-eslint/eslint-plugin": "^8.46.2",
-    "@typescript-eslint/parser": "^8.46.2",
-    "@vitest/coverage-v8": "^4.0.6",
-    "@vitest/ui": "^4.0.6",
-    "eslint": "^9.39.0",
+    "@types/node": "^24.10.1",
+    "@typescript-eslint/eslint-plugin": "^8.47.0",
+    "@typescript-eslint/parser": "^8.47.0",
+    "@vitest/coverage-v8": "^4.0.12",
+    "@vitest/ui": "^4.0.12",
+    "eslint": "^9.39.1",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-import": "^2.32.0",
     "eslint-plugin-vitest": "^0.5.4",
-    "knip": "^5.66.4",
+    "husky": "^9.1.7",
+    "knip": "^5.70.1",
+    "patch-package": "^8.0.1",
     "prettier": "^3.6.2",
     "ts-node": "^10.9.2",
     "typescript": "^5.9.3",
     "uuid": "^13.0.0",
-    "vite": "^7.1.12",
-    "vitest": "^4.0.6"
+    "vitest": "^4.0.12"
   },
   "license": "MIT",
   "author": "Vasyl Zakharchenko",
@@ -62,11 +55,12 @@
     "format": "prettier --write src examples __tests__",
     "format:check": "prettier --write src examples __tests__ --check",
     "clean": "rm -rf dist",
-    "build": "npm run clean && vite build && npm run build:types",
-    "build:types": "tsc --emitDeclarationOnly",
+    "build": "npm run clean && npm run build:types",
+    "build:types": "tsc",
     "prepublish:npm": "npm run build",
     "publish:npm": "npm publish --access public",
     "generate:models": "ts-node scripts/generate-models.ts",
+    "prepare": "husky",
     "knip": "knip"
   },
   "files": [
@@ -76,7 +70,7 @@
     "README.md"
   ],
   "peerDependencies": {
-    "@forge/sql": "^3.0.9",
+    "@forge/sql": "^3.0.10",
     "drizzle-orm": "^0.44.7"
   },
   "optionalDependencies": {
@@ -84,5 +78,16 @@
   },
   "dependencies": {
     "luxon": "^3.7.2"
+  },
+  "lint-staged": {
+    "*.{ts,tsx,css,scss,md}": [
+      "prettier --write",
+      "eslint --fix"
+    ]
+  },
+  "husky": {
+    "hooks": {
+      "pre-commit": "cd .husky && ./pre-commit"
+    }
   }
 }

package/src/core/ForgeSQLAnalyseOperations.ts

@@ -294,9 +294,10 @@ export class ForgeSQLAnalyseOperation implements SchemaAnalyzeForgeSql {
         .map((s) => s.trim())
         .filter(Boolean);
       const row: Record<string, string> = {};
-      headers.forEach((key, i) => {
+      for (const key of headers) {
+        const i = headers.indexOf(key);
         row[key] = values[i] ?? "";
-      });
+      }
       return row as unknown as ExplainAnalyzeRow;
     });
   }

package/src/lib/drizzle/extensions/additionalActions.ts

@@ -593,6 +593,17 @@ function createAliasedSelectBuilder<TSelection extends SelectedFields>(
             }
           };
         }
+        if (prop === "catch") {
+          return (onrejected: any) => (receiver as any).then(undefined, onrejected);
+        }
+
+        if (prop === "finally") {
+          return (onfinally: any) =>
+            (receiver as any).then(
+              (value: any) => Promise.resolve(value).finally(onfinally),
+              (reason: any) => Promise.reject(reason).finally(onfinally),
+            );
+        }
 
         const value = Reflect.get(target, prop, receiver);