@kodexa-ai/document-wasm-ts 8.0.0-develop-20957644908 → 8.0.0-develop-20981803950

package/dist/sqljs-bridge.bundle.js

@@ -32,6 +32,155 @@ var KodexaBridge = (() => {
   var databases = /* @__PURE__ */ new Map();
   var nextHandle = 1;
   var sqlInstance = null;
+  var SqlPerformanceTracer = class {
+    constructor() {
+      this.enabled = false;
+      this.stats = /* @__PURE__ */ new Map();
+      this.recentTraces = [];
+      this.maxRecentTraces = 100;
+      this.sessionStart = 0;
+      this.logQueries = false;
+      this.slowQueryThreshold = 10;
+    }
+    // ms
+    enable(options) {
+      this.enabled = true;
+      this.sessionStart = performance.now();
+      this.logQueries = options?.logQueries ?? false;
+      this.slowQueryThreshold = options?.slowQueryThreshold ?? 10;
+      this.reset();
+      console.log("[sql.js PERF] Performance tracing ENABLED", {
+        logQueries: this.logQueries,
+        slowQueryThreshold: this.slowQueryThreshold + "ms"
+      });
+    }
+    disable() {
+      this.enabled = false;
+      console.log("[sql.js PERF] Performance tracing DISABLED");
+    }
+    isEnabled() {
+      return this.enabled;
+    }
+    reset() {
+      this.stats.clear();
+      this.recentTraces = [];
+      this.sessionStart = performance.now();
+    }
+    extractQueryType(sql) {
+      const trimmed = sql.trim().toUpperCase();
+      if (trimmed.startsWith("SELECT")) {
+        const match = sql.match(/FROM\s+["']?(\w+)["']?/i);
+        return match ? `SELECT:${match[1]}` : "SELECT";
+      }
+      if (trimmed.startsWith("INSERT")) {
+        const match = sql.match(/INTO\s+["']?(\w+)["']?/i);
+        return match ? `INSERT:${match[1]}` : "INSERT";
+      }
+      if (trimmed.startsWith("UPDATE")) {
+        const match = sql.match(/UPDATE\s+["']?(\w+)["']?/i);
+        return match ? `UPDATE:${match[1]}` : "UPDATE";
+      }
+      if (trimmed.startsWith("DELETE")) {
+        const match = sql.match(/FROM\s+["']?(\w+)["']?/i);
+        return match ? `DELETE:${match[1]}` : "DELETE";
+      }
+      if (trimmed.startsWith("BEGIN")) return "BEGIN";
+      if (trimmed.startsWith("COMMIT")) return "COMMIT";
+      if (trimmed.startsWith("ROLLBACK")) return "ROLLBACK";
+      if (trimmed.startsWith("PRAGMA")) return "PRAGMA";
+      if (trimmed.startsWith("CREATE")) return "CREATE";
+      return "OTHER";
+    }
+    recordQuery(sql, paramsJson, startTime, endTime, rowCount, error) {
+      if (!this.enabled) return;
+      const duration = endTime - startTime;
+      const queryType = this.extractQueryType(sql);
+      let stat = this.stats.get(queryType);
+      if (!stat) {
+        stat = { count: 0, totalMs: 0, minMs: Infinity, maxMs: 0, errors: 0 };
+        this.stats.set(queryType, stat);
+      }
+      stat.count++;
+      stat.totalMs += duration;
+      stat.minMs = Math.min(stat.minMs, duration);
+      stat.maxMs = Math.max(stat.maxMs, duration);
+      if (error) stat.errors++;
+      const trace = { sql, paramsJson, startTime, endTime, duration, rowCount, error };
+      this.recentTraces.push(trace);
+      if (this.recentTraces.length > this.maxRecentTraces) {
+        this.recentTraces.shift();
+      }
+      if (duration >= this.slowQueryThreshold) {
+        console.warn(`[sql.js PERF] SLOW QUERY (${duration.toFixed(2)}ms): ${queryType}`, {
+          sql: sql.substring(0, 200),
+          rowCount,
+          duration: duration.toFixed(2) + "ms"
+        });
+      } else if (this.logQueries) {
+        console.log(`[sql.js PERF] ${queryType} (${duration.toFixed(2)}ms, ${rowCount} rows)`);
+      }
+    }
+    getStats() {
+      const result = {};
+      for (const [queryType, stat] of this.stats) {
+        result[queryType] = {
+          ...stat,
+          avgMs: stat.count > 0 ? stat.totalMs / stat.count : 0
+        };
+      }
+      return result;
+    }
+    getSummary() {
+      const stats = this.getStats();
+      let totalQueries = 0;
+      let totalTimeMs = 0;
+      let slowQueries = 0;
+      let errors = 0;
+      const entries = [];
+      for (const [type, stat] of Object.entries(stats)) {
+        totalQueries += stat.count;
+        totalTimeMs += stat.totalMs;
+        slowQueries += this.recentTraces.filter(
+          (t) => this.extractQueryType(t.sql) === type && t.duration >= this.slowQueryThreshold
+        ).length;
+        errors += stat.errors;
+        entries.push({ type, count: stat.count, totalMs: stat.totalMs, avgMs: stat.avgMs });
+      }
+      return {
+        sessionDuration: performance.now() - this.sessionStart,
+        totalQueries,
+        totalTimeMs,
+        avgQueryMs: totalQueries > 0 ? totalTimeMs / totalQueries : 0,
+        slowQueries,
+        errors,
+        topByCount: [...entries].sort((a, b) => b.count - a.count).slice(0, 10),
+        topByTime: [...entries].sort((a, b) => b.totalMs - a.totalMs).slice(0, 10)
+      };
+    }
+    getRecentTraces(count = 20) {
+      return this.recentTraces.slice(-count);
+    }
+    printReport() {
+      const summary = this.getSummary();
+      console.log("\n========== SQL.JS PERFORMANCE REPORT ==========");
+      console.log(`Session Duration: ${(summary.sessionDuration / 1e3).toFixed(2)}s`);
+      console.log(`Total Queries: ${summary.totalQueries}`);
+      console.log(`Total SQL Time: ${summary.totalTimeMs.toFixed(2)}ms`);
+      console.log(`Avg Query Time: ${summary.avgQueryMs.toFixed(3)}ms`);
+      console.log(`Slow Queries (>${this.slowQueryThreshold}ms): ${summary.slowQueries}`);
+      console.log(`Errors: ${summary.errors}`);
+      console.log("\n--- Top by Count ---");
+      for (const entry of summary.topByCount) {
+        console.log(`  ${entry.type}: ${entry.count} calls, ${entry.totalMs.toFixed(2)}ms total, ${entry.avgMs.toFixed(3)}ms avg`);
+      }
+      console.log("\n--- Top by Total Time ---");
+      for (const entry of summary.topByTime) {
+        console.log(`  ${entry.type}: ${entry.totalMs.toFixed(2)}ms total, ${entry.count} calls, ${entry.avgMs.toFixed(3)}ms avg`);
+      }
+      console.log("================================================\n");
+    }
+  };
+  var perfTracer = new SqlPerformanceTracer();
   function uint8ArrayToBase64(bytes) {
     if (bytes.length < 32768) {
       let binary2 = "";
@@ -88,12 +237,17 @@ var KodexaBridge = (() => {
       console.error(`[sql.js] Invalid database handle: ${handle}`);
       return 0;
     }
+    const startTime = performance.now();
+    let error;
     try {
       db.run(sql);
       return 1;
-    } catch (error) {
-      console.error("[sql.js] Exec failed:", error);
+    } catch (err) {
+      error = String(err);
+      console.error("[sql.js] Exec failed:", err);
       return 0;
+    } finally {
+      perfTracer.recordQuery(sql, "[]", startTime, performance.now(), 0, error);
     }
   }
   function queryOp(handle, sql, paramsJson) {
@@ -102,6 +256,9 @@ var KodexaBridge = (() => {
       console.error(`[sql.js] Invalid database handle: ${handle}`);
       return "[]";
     }
+    const startTime = performance.now();
+    let error;
+    let rowCount = 0;
     try {
       let params = [];
       if (paramsJson && paramsJson !== "[]" && paramsJson !== "null") {
@@ -116,10 +273,14 @@ var KodexaBridge = (() => {
         results.push(processRowForJson(stmt.getAsObject()));
       }
       stmt.free();
+      rowCount = results.length;
       return JSON.stringify(results);
-    } catch (error) {
-      console.error("[sql.js] Query failed:", sql, error);
+    } catch (err) {
+      error = String(err);
+      console.error("[sql.js] Query failed:", sql, err);
       return "[]";
+    } finally {
+      perfTracer.recordQuery(sql, paramsJson, startTime, performance.now(), rowCount, error);
     }
   }
   function insertOp(handle, sql, paramsJson) {
@@ -128,6 +289,8 @@ var KodexaBridge = (() => {
       console.error(`[sql.js] Invalid database handle: ${handle}`);
       return 0;
     }
+    const startTime = performance.now();
+    let error;
     try {
       let params = [];
       if (paramsJson && paramsJson !== "[]" && paramsJson !== "null") {
@@ -143,9 +306,12 @@ var KodexaBridge = (() => {
         return result[0].values[0][0];
       }
       return 0;
-    } catch (error) {
-      console.error("[sql.js] Insert failed:", sql, error);
+    } catch (err) {
+      error = String(err);
+      console.error("[sql.js] Insert failed:", sql, err);
       return 0;
+    } finally {
+      perfTracer.recordQuery(sql, paramsJson, startTime, performance.now(), 1, error);
     }
   }
   function execParamsOp(handle, sql, paramsJson) {
@@ -154,6 +320,9 @@ var KodexaBridge = (() => {
       console.error(`[sql.js] Invalid database handle: ${handle}`);
       return -1;
     }
+    const startTime = performance.now();
+    let error;
+    let rowsAffected = 0;
     try {
       let params = [];
       if (paramsJson && paramsJson !== "[]" && paramsJson !== "null") {
@@ -166,12 +335,16 @@ var KodexaBridge = (() => {
       }
       const result = db.exec("SELECT changes() as count");
       if (result.length > 0 && result[0].values.length > 0) {
-        return result[0].values[0][0];
+        rowsAffected = result[0].values[0][0];
+        return rowsAffected;
       }
       return 0;
-    } catch (error) {
-      console.error("[sql.js] ExecParams failed:", sql, error);
+    } catch (err) {
+      error = String(err);
+      console.error("[sql.js] ExecParams failed:", sql, err);
       return -1;
+    } finally {
+      perfTracer.recordQuery(sql, paramsJson, startTime, performance.now(), rowsAffected, error);
     }
   }
   function exportOp(handle) {
@@ -266,7 +439,31 @@ var KodexaBridge = (() => {
     g.sqljsGetError = getErrorOp;
     g.sqljsLoadDirect = loadDirectOp;
     g.sqljsDatabases = databases;
+    g.sqljsPerf = {
+      /**
+       * Enable SQL performance tracing
+       * @param options.logQueries - Log all queries (default: false, only slow queries are logged)
+       * @param options.slowQueryThreshold - Threshold in ms for slow query warnings (default: 10)
+       * @example sqljsPerf.enable({ logQueries: true, slowQueryThreshold: 5 })
+       */
+      enable: (options) => perfTracer.enable(options),
+      /** Disable SQL performance tracing */
+      disable: () => perfTracer.disable(),
+      /** Check if tracing is enabled */
+      isEnabled: () => perfTracer.isEnabled(),
+      /** Reset all statistics and traces */
+      reset: () => perfTracer.reset(),
+      /** Get detailed statistics by query type */
+      getStats: () => perfTracer.getStats(),
+      /** Get summary with top queries by count and time */
+      getSummary: () => perfTracer.getSummary(),
+      /** Get recent query traces (default: last 20) */
+      getRecentTraces: (count) => perfTracer.getRecentTraces(count),
+      /** Print formatted performance report to console */
+      printReport: () => perfTracer.printReport()
+    };
     console.log("[sql.js] Bridge functions exposed to globalThis");
+    console.log("[sql.js] Performance tracing available via sqljsPerf.enable()");
   }
   function getDatabase(handle) {
     return databases.get(handle);

package/dist/wasm/sqljs-core.d.ts

@@ -7,6 +7,22 @@
  * The SQL instance is passed in from the wrapper modules, allowing them to
  * load sql.js in different ways (npm import vs CDN global).
  */
+interface SqlStats {
+    count: number;
+    totalMs: number;
+    minMs: number;
+    maxMs: number;
+    errors: number;
+}
+interface QueryTrace {
+    sql: string;
+    paramsJson: string;
+    startTime: number;
+    endTime: number;
+    duration: number;
+    rowCount: number;
+    error?: string;
+}
 /**
  * Create a new in-memory database
  * @returns Database handle (positive integer) or 0 on error
@@ -89,4 +105,47 @@ export declare function exposeBridgeFunctions(): void;
  * Get a database by handle (for debugging from console)
  */
 export declare function getDatabase(handle: number): any;
+/**
+ * Enable SQL performance tracing
+ * @param options.logQueries - Log all queries (default: false, only slow queries are logged)
+ * @param options.slowQueryThreshold - Threshold in ms for slow query warnings (default: 10)
+ */
+export declare function enableSqlPerformanceTracing(options?: {
+    logQueries?: boolean;
+    slowQueryThreshold?: number;
+}): void;
+/** Disable SQL performance tracing */
+export declare function disableSqlPerformanceTracing(): void;
+/** Get SQL performance statistics */
+export declare function getSqlPerformanceStats(): Record<string, SqlStats & {
+    avgMs: number;
+}>;
+/** Get SQL performance summary */
+export declare function getSqlPerformanceSummary(): {
+    sessionDuration: number;
+    totalQueries: number;
+    totalTimeMs: number;
+    avgQueryMs: number;
+    slowQueries: number;
+    errors: number;
+    topByCount: Array<{
+        type: string;
+        count: number;
+        totalMs: number;
+        avgMs: number;
+    }>;
+    topByTime: Array<{
+        type: string;
+        count: number;
+        totalMs: number;
+        avgMs: number;
+    }>;
+};
+/** Print SQL performance report to console */
+export declare function printSqlPerformanceReport(): void;
+/** Get recent SQL query traces */
+export declare function getRecentSqlTraces(count?: number): QueryTrace[];
+/** Reset SQL performance statistics */
+export declare function resetSqlPerformanceStats(): void;
+export {};
 //# sourceMappingURL=sqljs-core.d.ts.map

package/dist/wasm/sqljs-core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sqljs-core.d.ts","sourceRoot":"","sources":["../../src/wasm/sqljs-core.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAiEH;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAgBzC;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAc1D;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAgC/E;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CA+BhF;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CA+BpF;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAe/C;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAuBnD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAetD;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAW5C;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAIlD;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,IAAI,CAWhC;AAMD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAE7C;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAkB5C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,CAE/C"}
+{"version":3,"file":"sqljs-core.d.ts","sourceRoot":"","sources":["../../src/wasm/sqljs-core.ts"],"names":[],"mappings":"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"}