@xnetjs/data 0.1.0 → 0.1.1

package/dist/{chunk-UDWKWTAX.js → chunk-EI5CY2FZ.js}

@@ -3413,6 +3413,7 @@ var DEFAULT_QUERY_VERIFICATION = {
   logFailures: true
 };
 var QUERY_TELEMETRY_FLUSH_THRESHOLD = 50;
+var COMPILED_QUERY_DIAGNOSTICS_MEMO_LIMIT = 512;
 var SQLITE_BIND_PARAMETER_BATCH_SIZE = 900;
 var SQLITE_HYDRATE_NODE_BATCH_SIZE = Math.floor(SQLITE_BIND_PARAMETER_BATCH_SIZE / 2);
 var SQL_HYDRATE_ARITY_BUCKETS = [1, 10, 50, 150, SQLITE_HYDRATE_NODE_BATCH_SIZE];
@@ -3474,6 +3475,14 @@ var SQLiteNodeStorageAdapter = class {
   pendingQueryTelemetryHits = 0;
   adaptiveIndexBudgetColumnsReady = false;
   storageCapabilitiesPromise;
+  /**
+   * Plan diagnostics memoized per compiled SQL shape (the string EXPLAINed),
+   * shared across executions AND concurrent callers. Cleared when this adapter
+   * creates/drops an adaptive index, since that changes plans. Debug mode must
+   * not distort what it measures: per-execution EXPLAIN + index-inventory
+   * round-trips convoyed the single serial worker at boot.
+   */
+  compiledQueryDiagnosticsMemo = /* @__PURE__ */ new Map();
   spatialTablesState = "unknown";
   fullTextSearchTablesState = "unknown";
   writeQueue = Promise.resolve();
@@ -5741,7 +5750,34 @@ CREATE INDEX IF NOT EXISTS idx_node_spatial_ids_schema
   isQueryDiagnosticsEnabled() {
     return this.queryDiagnostics || this.isQueryDebugEnabled();
   }
-  async collectCompiledQueryDiagnostics(compiled) {
+  /**
+   * Throttled: one collection per unique compiled SQL shape per session.
+   * EXPLAIN plans depend on the statement, not the bound values, so keyset
+   * pages of the same query share one entry. Concurrent callers share the
+   * in-flight promise; failed collections are not memoized.
+   */
+  collectCompiledQueryDiagnostics(compiled) {
+    const memoKey = compiled.sql;
+    const memoized = this.compiledQueryDiagnosticsMemo.get(memoKey);
+    if (memoized) {
+      return memoized;
+    }
+    const pending = this.computeCompiledQueryDiagnostics(compiled).then((diagnostics) => {
+      if (diagnostics.diagnosticsError) {
+        this.compiledQueryDiagnosticsMemo.delete(memoKey);
+      }
+      return diagnostics;
+    });
+    if (this.compiledQueryDiagnosticsMemo.size >= COMPILED_QUERY_DIAGNOSTICS_MEMO_LIMIT) {
+      const oldest = this.compiledQueryDiagnosticsMemo.keys().next().value;
+      if (oldest !== void 0) {
+        this.compiledQueryDiagnosticsMemo.delete(oldest);
+      }
+    }
+    this.compiledQueryDiagnosticsMemo.set(memoKey, pending);
+    return pending;
+  }
+  async computeCompiledQueryDiagnostics(compiled) {
     try {
       const [analysis, indexes, storageCapabilities] = await Promise.all([
         analyzeQuery(this.db, compiled.sql, compiled.params),
@@ -5965,6 +6001,7 @@ CREATE INDEX IF NOT EXISTS idx_node_spatial_ids_schema
     if (createdIndex) {
       await runAnalyze(this.db, "node_property_scalars");
       await this.db.exec("PRAGMA optimize");
+      this.compiledQueryDiagnosticsMemo.clear();
     }
     return touchedIndexNames;
   }
@@ -6113,6 +6150,7 @@ CREATE INDEX IF NOT EXISTS idx_node_spatial_ids_schema
   async dropAdaptiveIndex(indexName, reason) {
     await this.db.exec(`DROP INDEX IF EXISTS ${this.quoteSqlIdentifier(indexName)}`);
     await this.db.run("DELETE FROM query_index_candidates WHERE index_name = ?", [indexName]);
+    this.compiledQueryDiagnosticsMemo.clear();
     this.debugAdaptiveIndex("drop", { indexName, reason });
   }
   debugAdaptiveIndex(action, details) {

package/dist/index.js

@@ -605,7 +605,7 @@ import {
   sum,
   validateQueryAST,
   validateSavedViewDescriptor
-} from "./chunk-UDWKWTAX.js";
+} from "./chunk-EI5CY2FZ.js";
 import {
   applyNodeQueryDescriptor,
   createNodeQueryDescriptor,

package/dist/store/index.d.ts

@@ -120,9 +120,13 @@ interface SQLiteNodeStorageAdapterOptions {
     adaptiveIndexing?: SQLiteAdaptiveIndexingOptions;
     queryVerification?: SQLiteQueryVerificationOptions;
     /**
-     * Collect EXPLAIN QUERY PLAN + index inventory per query. Costs extra
-     * round trips per query, so it is off unless explicitly enabled or the
-     * `xnet:query:debug` localStorage flag is set.
+     * Collect EXPLAIN QUERY PLAN + index inventory for queries. Costs extra
+     * round trips, so it is off unless explicitly enabled or the
+     * `xnet:query:debug` localStorage flag is set. Diagnostics are collected
+     * once per unique compiled SQL shape per session (invalidated when the
+     * adapter itself runs DDL) — per-execution collection convoyed the serial
+     * worker and delayed the very queries being measured by 18-20s at boot
+     * (2026-07-05 capture).
      */
     queryDiagnostics?: boolean;
     /**
@@ -175,6 +179,14 @@ declare class SQLiteNodeStorageAdapter implements NodeStorageAdapter {
     private pendingQueryTelemetryHits;
     private adaptiveIndexBudgetColumnsReady;
     private storageCapabilitiesPromise?;
+    /**
+     * Plan diagnostics memoized per compiled SQL shape (the string EXPLAINed),
+     * shared across executions AND concurrent callers. Cleared when this adapter
+     * creates/drops an adaptive index, since that changes plans. Debug mode must
+     * not distort what it measures: per-execution EXPLAIN + index-inventory
+     * round-trips convoyed the single serial worker at boot.
+     */
+    private compiledQueryDiagnosticsMemo;
     private spatialTablesState;
     private fullTextSearchTablesState;
     private writeQueue;
@@ -449,7 +461,14 @@ declare class SQLiteNodeStorageAdapter implements NodeStorageAdapter {
     flushQueryTelemetry(): Promise<void>;
     private writeQueryTelemetryRow;
     private isQueryDiagnosticsEnabled;
+    /**
+     * Throttled: one collection per unique compiled SQL shape per session.
+     * EXPLAIN plans depend on the statement, not the bound values, so keyset
+     * pages of the same query share one entry. Concurrent callers share the
+     * in-flight promise; failed collections are not memoized.
+     */
     private collectCompiledQueryDiagnostics;
+    private computeCompiledQueryDiagnostics;
     private getStorageCapabilities;
     private debugQueryPlan;
     private isQueryDebugEnabled;

package/dist/store/index.js

@@ -49,7 +49,7 @@ import {
   sum,
   validateQueryAST,
   validateSavedViewDescriptor
-} from "../chunk-UDWKWTAX.js";
+} from "../chunk-EI5CY2FZ.js";
 import {
   applyNodeQueryDescriptor,
   createNodeQueryDescriptor,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xnetjs/data",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -57,12 +57,12 @@
     "nanoid": "^5.1.6",
     "y-protocols": "^1.0.6",
     "yjs": "^13.6.24",
-    "@xnetjs/core": "0.1.0",
-    "@xnetjs/crypto": "0.1.0",
-    "@xnetjs/identity": "0.1.0",
-    "@xnetjs/sqlite": "0.1.0",
-    "@xnetjs/storage": "0.1.0",
-    "@xnetjs/sync": "0.1.0"
+    "@xnetjs/core": "0.1.1",
+    "@xnetjs/crypto": "0.1.1",
+    "@xnetjs/identity": "0.1.1",
+    "@xnetjs/sqlite": "0.1.1",
+    "@xnetjs/storage": "0.1.1",
+    "@xnetjs/sync": "0.1.1"
   },
   "devDependencies": {
     "tsup": "^8.0.0",