@takaro/db 0.1.2 → 0.1.4

package/dist/migrations/sql/20250701-command-query-performance-indices.d.ts

@@ -0,0 +1,4 @@
+import { Knex } from 'knex';
+export declare function up(knex: Knex): Promise<void>;
+export declare function down(knex: Knex): Promise<void>;
+//# sourceMappingURL=20250701-command-query-performance-indices.d.ts.map

package/dist/migrations/sql/20250701-command-query-performance-indices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"20250701-command-query-performance-indices.d.ts","sourceRoot":"","sources":["../../../src/migrations/sql/20250701-command-query-performance-indices.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,wBAAsB,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAiClD;AAED,wBAAsB,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAepD"}

package/dist/migrations/sql/20250701-command-query-performance-indices.js

@@ -0,0 +1,42 @@
+export async function up(knex) {
+    // Optimize the getTriggeredCommands query performance
+    // The query joins multiple tables and performs complex JSONB operations
+    // 1. Case-insensitive index on commands.trigger for efficient trigger matching
+    // This allows the LOWER(commands.trigger) = ? condition to use an index
+    await knex.raw('CREATE INDEX idx_commands_trigger_lower ON commands (LOWER(trigger))');
+    // 2. Index on moduleInstallations.gameserverId for efficient filtering
+    // The query filters by gameserverId through the join chain
+    await knex.schema.alterTable('moduleInstallations', (table) => {
+        table.index(['gameserverId'], 'idx_moduleinstallations_gameserverid');
+    });
+    // 3. Index on moduleInstallations.versionId for join optimization
+    // This helps the join between moduleInstallations and moduleVersions
+    await knex.schema.alterTable('moduleInstallations', (table) => {
+        table.index(['versionId'], 'idx_moduleinstallations_versionid');
+    });
+    // 4. GIN index on moduleInstallations.systemConfig for JSONB queries
+    // This optimizes the complex EXISTS subquery that searches command aliases
+    await knex.raw(`
+    CREATE INDEX idx_moduleinstallations_systemconfig_commands_gin 
+    ON "moduleInstallations" 
+    USING gin (("systemConfig" -> 'commands'))
+  `);
+    // 5. Composite index on commands for better join performance
+    // This helps when joining from moduleVersions to commands
+    await knex.schema.alterTable('commands', (table) => {
+        table.index(['versionId', 'domain'], 'idx_commands_versionid_domain');
+    });
+}
+export async function down(knex) {
+    // Drop all indices created in the up function
+    await knex.raw('DROP INDEX IF EXISTS idx_commands_trigger_lower');
+    await knex.schema.alterTable('moduleInstallations', (table) => {
+        table.dropIndex([], 'idx_moduleinstallations_gameserverid');
+        table.dropIndex([], 'idx_moduleinstallations_versionid');
+    });
+    await knex.raw('DROP INDEX IF EXISTS idx_moduleinstallations_systemconfig_commands_gin');
+    await knex.schema.alterTable('commands', (table) => {
+        table.dropIndex([], 'idx_commands_versionid_domain');
+    });
+}
+//# sourceMappingURL=20250701-command-query-performance-indices.js.map

package/dist/migrations/sql/20250701-command-query-performance-indices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"20250701-command-query-performance-indices.js","sourceRoot":"","sources":["../../../src/migrations/sql/20250701-command-query-performance-indices.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,EAAE,CAAC,IAAU;IACjC,sDAAsD;IACtD,wEAAwE;IAExE,+EAA+E;IAC/E,wEAAwE;IACxE,MAAM,IAAI,CAAC,GAAG,CAAC,sEAAsE,CAAC,CAAC;IAEvF,uEAAuE;IACvE,2DAA2D;IAC3D,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,qBAAqB,EAAE,CAAC,KAAK,EAAE,EAAE;QAC5D,KAAK,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,EAAE,sCAAsC,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;IAEH,kEAAkE;IAClE,qEAAqE;IACrE,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,qBAAqB,EAAE,CAAC,KAAK,EAAE,EAAE;QAC5D,KAAK,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,EAAE,mCAAmC,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IAEH,qEAAqE;IACrE,2EAA2E;IAC3E,MAAM,IAAI,CAAC,GAAG,CAAC;;;;GAId,CAAC,CAAC;IAEH,6DAA6D;IAC7D,0DAA0D;IAC1D,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE;QACjD,KAAK,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,QAAQ,CAAC,EAAE,+BAA+B,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAU;IACnC,8CAA8C;IAE9C,MAAM,IAAI,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;IAElE,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,qBAAqB,EAAE,CAAC,KAAK,EAAE,EAAE;QAC5D,KAAK,CAAC,SAAS,CAAC,EAAE,EAAE,sCAAsC,CAAC,CAAC;QAC5D,KAAK,CAAC,SAAS,CAAC,EAAE,EAAE,mCAAmC,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,MAAM,IAAI,CAAC,GAAG,CAAC,wEAAwE,CAAC,CAAC;IAEzF,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE;QACjD,KAAK,CAAC,SAAS,CAAC,EAAE,EAAE,+BAA+B,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takaro/db",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "An opinionated data layer",
   "main": "dist/main.js",
   "types": "dist/main.d.ts",

package/src/migrations/sql/20250701-command-query-performance-indices.ts

@@ -0,0 +1,53 @@
+import { Knex } from 'knex';
+
+export async function up(knex: Knex): Promise<void> {
+  // Optimize the getTriggeredCommands query performance
+  // The query joins multiple tables and performs complex JSONB operations
+
+  // 1. Case-insensitive index on commands.trigger for efficient trigger matching
+  // This allows the LOWER(commands.trigger) = ? condition to use an index
+  await knex.raw('CREATE INDEX idx_commands_trigger_lower ON commands (LOWER(trigger))');
+
+  // 2. Index on moduleInstallations.gameserverId for efficient filtering
+  // The query filters by gameserverId through the join chain
+  await knex.schema.alterTable('moduleInstallations', (table) => {
+    table.index(['gameserverId'], 'idx_moduleinstallations_gameserverid');
+  });
+
+  // 3. Index on moduleInstallations.versionId for join optimization
+  // This helps the join between moduleInstallations and moduleVersions
+  await knex.schema.alterTable('moduleInstallations', (table) => {
+    table.index(['versionId'], 'idx_moduleinstallations_versionid');
+  });
+
+  // 4. GIN index on moduleInstallations.systemConfig for JSONB queries
+  // This optimizes the complex EXISTS subquery that searches command aliases
+  await knex.raw(`
+    CREATE INDEX idx_moduleinstallations_systemconfig_commands_gin 
+    ON "moduleInstallations" 
+    USING gin (("systemConfig" -> 'commands'))
+  `);
+
+  // 5. Composite index on commands for better join performance
+  // This helps when joining from moduleVersions to commands
+  await knex.schema.alterTable('commands', (table) => {
+    table.index(['versionId', 'domain'], 'idx_commands_versionid_domain');
+  });
+}
+
+export async function down(knex: Knex): Promise<void> {
+  // Drop all indices created in the up function
+
+  await knex.raw('DROP INDEX IF EXISTS idx_commands_trigger_lower');
+
+  await knex.schema.alterTable('moduleInstallations', (table) => {
+    table.dropIndex([], 'idx_moduleinstallations_gameserverid');
+    table.dropIndex([], 'idx_moduleinstallations_versionid');
+  });
+
+  await knex.raw('DROP INDEX IF EXISTS idx_moduleinstallations_systemconfig_commands_gin');
+
+  await knex.schema.alterTable('commands', (table) => {
+    table.dropIndex([], 'idx_commands_versionid_domain');
+  });
+}