@lensjs/core 2.2.1 → 2.3.0

package/dist/index.cjs

@@ -38,6 +38,7 @@ __export(index_exports, {
   LensStore: () => Store,
   LensWatcher: () => Watcher,
   QueryWatcher: () => QueryWatcher,
+  QueuedSqliteStore: () => QueuedSqliteStore,
   RequestWatcher: () => RequestWatcher,
   WatcherTypeEnum: () => WatcherTypeEnum,
   createEmittery: () => createEmittery,
@@ -229,6 +230,8 @@ var path2 = __toESM(require("path"), 1);
 
 // src/abstracts/store.ts
 var Store = class {
+  constructor(...args) {
+  }
   getAllExceptions(_paginationParams) {
     return this.defaultMinimalPaginate();
   }
@@ -380,9 +383,98 @@ var BetterSqliteStore = class extends Store {
   }
 };
 
+// src/mixins/queued_store.ts
+var import_denque = __toESM(require("denque"), 1);
+function QueuedStore(Base) {
+  return class Queued extends Base {
+    queue;
+    processingInterval = null;
+    BATCH_SIZE;
+    PROCESS_INTERVAL_MS;
+    WARN_THRESHOLD;
+    PREALLOCATE;
+    constructor(...args) {
+      super(...args);
+      const config = args[0] || {};
+      this.BATCH_SIZE = config.batchSize ?? 100;
+      this.PROCESS_INTERVAL_MS = config.processIntervalMs ?? 100;
+      this.WARN_THRESHOLD = config.warnThreshold ?? 1e5;
+      this.PREALLOCATE = config.preallocate ?? true;
+      this.queue = this.PREALLOCATE ? new import_denque.default([], { capacity: this.WARN_THRESHOLD * 2 }) : new import_denque.default();
+    }
+    async initialize() {
+      if (super["initialize"]) {
+        await super["initialize"].call(this);
+      }
+      this.startProcessingQueue();
+      process.on("SIGINT", () => this.shutdown());
+      process.on("SIGTERM", () => this.shutdown());
+    }
+    async truncate() {
+      this.queue.clear();
+      if (super["truncate"]) {
+        await super["truncate"].call(this);
+      }
+    }
+    async save(entry) {
+      this.queue.push(entry);
+      if (this.queue.length > this.WARN_THRESHOLD) {
+        console.warn(`\u26A0\uFE0F LensJs Queue size very large: ${this.queue.length}`);
+      }
+    }
+    startProcessingQueue() {
+      if (this.processingInterval) clearInterval(this.processingInterval);
+      this.processingInterval = setInterval(
+        () => this.processQueue(),
+        this.PROCESS_INTERVAL_MS
+      );
+    }
+    async processQueue() {
+      if (this.queue.isEmpty()) return;
+      const batchSize = Math.min(
+        this.BATCH_SIZE,
+        Math.max(10, Math.floor(this.queue.length / 10))
+      );
+      const entriesToProcess = this.queue.remove(0, batchSize);
+      if (!entriesToProcess.length) return;
+      for (const entry of entriesToProcess) {
+        super["save"]?.call(this, entry).catch((error) => {
+          console.error("Error saving queued entry:", error);
+        });
+      }
+    }
+    async stopProcessingQueue() {
+      if (this.processingInterval) {
+        clearInterval(this.processingInterval);
+        this.processingInterval = null;
+      }
+      if (!this.queue.isEmpty()) {
+        await this.processQueue();
+      }
+    }
+    async shutdown() {
+      await this.stopProcessingQueue();
+      process.exit(0);
+    }
+  };
+}
+
+// src/utils/compose.ts
+function compose(superclass, ...mixins) {
+  return mixins.reduce((c, mixin) => mixin(c), superclass);
+}
+
+// src/stores/queued_sqlite.ts
+var QueuedSqliteStore = class extends compose(
+  BetterSqliteStore,
+  QueuedStore
+) {
+};
+
 // src/utils/index.ts
 var utils_exports = {};
 __export(utils_exports, {
+  compose: () => compose,
   formatSqlQuery: () => formatSqlQuery,
   generateRandomUuid: () => generateRandomUuid,
   getMeta: () => getMeta,
@@ -523,6 +615,7 @@ var Lens = class {
   static watchers = /* @__PURE__ */ new Map();
   static store;
   static adapter;
+  static config;
   static watch(watcher) {
     this.watchers.set(watcher.name, watcher);
     return this;
@@ -532,22 +625,23 @@ var Lens = class {
     return this;
   }
   static async start(config = {
-    basePath: "lens",
+    path: "lens",
     appName: "Lens",
     enabled: true
   }) {
     if (!config.enabled) {
       return;
     }
-    await this.bindContainerDeps(config);
+    this.config = config;
+    await this.bindContainerDeps();
     let adapter = this.getAdapter();
     adapter.setWatchers(Array.from(this.watchers.values())).setup();
     const { apiRoutes } = this.getRoutes({
-      basePath: config.basePath
+      path: config.path
     });
     adapter.registerRoutes(apiRoutes);
     const uiPath = this.getUiPath();
-    adapter.serveUI(uiPath, config.basePath, getUiConfig());
+    adapter.serveUI(uiPath, config.path, getUiConfig());
   }
   static setStore(store) {
     this.store = store;
@@ -570,7 +664,7 @@ var Lens = class {
     const { __dirname: __dirname2 } = getMeta(import_meta.url);
     return path2.resolve(this.normalizeDirName(__dirname2), "ui");
   }
-  static getRoutes({ basePath }) {
+  static getRoutes({ path: path4 }) {
     const apiRoutes = [
       {
         method: "GET",
@@ -579,71 +673,71 @@ var Lens = class {
       },
       {
         method: "GET",
-        path: `/${basePath}/api/requests`,
+        path: `/${path4}/api/requests`,
         handler: async (data) => await ApiController.getRequests(data)
       },
       {
         method: "GET",
-        path: `/${basePath}/api/requests/:id`,
+        path: `/${path4}/api/requests/:id`,
         handler: async (data) => await ApiController.getRequest(data)
       },
       {
         method: "GET",
-        path: `/${basePath}/api/queries`,
+        path: `/${path4}/api/queries`,
         handler: async (data) => await ApiController.getQueries(data)
       },
       {
         method: "GET",
-        path: `/${basePath}/api/queries/:id`,
+        path: `/${path4}/api/queries/:id`,
         handler: async (data) => await ApiController.getQuery(data)
       },
       {
         method: "GET",
-        path: `/${basePath}/api/cache`,
+        path: `/${path4}/api/cache`,
         handler: async (data) => await ApiController.getCacheEntries(data)
       },
       {
         method: "GET",
-        path: `/${basePath}/api/cache/:id`,
+        path: `/${path4}/api/cache/:id`,
         handler: async (data) => await ApiController.getCacheEntry(data)
       },
       {
         method: "GET",
-        path: `/${basePath}/api/exceptions`,
+        path: `/${path4}/api/exceptions`,
         handler: async (data) => await ApiController.getExceptions(data)
       },
       {
         method: "GET",
-        path: `/${basePath}/api/exceptions/:id`,
+        path: `/${path4}/api/exceptions/:id`,
         handler: async (data) => await ApiController.getException(data)
       },
       {
         method: "DELETE",
-        path: `/${basePath}/api/truncate`,
+        path: `/${path4}/api/truncate`,
         handler: async () => await ApiController.truncate()
       }
     ];
     return { apiRoutes };
   }
-  static async bindContainerDeps(config) {
+  static async bindContainerDeps() {
     const dbStore = await this.getStore();
     Container.singleton("store", () => dbStore);
     Container.singleton("uiConfig", () => {
       return {
-        appName: config.appName,
-        path: `/${config.basePath}`,
+        appName: this.config.appName,
+        path: `/${this.config.path}`,
         api: {
-          requests: `/${config.basePath}/api/requests`,
-          queries: `/${config.basePath}/api/queries`,
-          cache: `/${config.basePath}/api/cache`,
-          exceptions: `/${config.basePath}/api/exceptions`,
-          truncate: `/${config.basePath}/api/truncate`
+          requests: `/${this.config.path}/api/requests`,
+          queries: `/${this.config.path}/api/queries`,
+          cache: `/${this.config.path}/api/cache`,
+          exceptions: `/${this.config.path}/api/exceptions`,
+          truncate: `/${this.config.path}/api/truncate`
         }
       };
     });
   }
   static async getDefaultStore() {
-    const store = new BetterSqliteStore();
+    const store = new QueuedSqliteStore(this.config.storeQueueConfig);
     await store.initialize();
     return store;
   }
@@ -669,10 +763,19 @@ var QueryWatcher = class extends Watcher {
 };
 
 // src/watchers/request_watcher.ts
-var RequestWatcher = class extends Watcher {
+var RequestWatcher = class _RequestWatcher extends Watcher {
   name = "request" /* REQUEST */;
-  async log(data) {
-    await getStore().save({
+  static DEFAULT_HIDDEN_HEADERS = ["Authorization", "Basic"];
+  static DEFAULT_HIDDEN_BODY_PARAMS = [
+    "password",
+    "passwordConfirmation",
+    "secret",
+    "password_confirmation"
+  ];
+  async log(data, hidden = {}) {
+    const headersToHide = (hidden.headers?.length ? hidden.headers : _RequestWatcher.DEFAULT_HIDDEN_HEADERS).map((header) => header.toLowerCase());
+    const bodyParamsToHide = hidden.bodyParams?.length ? hidden.bodyParams : _RequestWatcher.DEFAULT_HIDDEN_BODY_PARAMS;
+    const payload = {
       id: data.request.id,
       type: this.name,
       minimal_data: {
@@ -686,9 +789,40 @@ var RequestWatcher = class extends Watcher {
       data: {
         ...data.request,
         user: data.user,
-        response: data.response
+        response: data.response || {}
       }
-    });
+    };
+    payload.data.headers = this.hideSensitive(
+      this.normalizeHeaders(payload.data.headers),
+      headersToHide
+    );
+    payload.data.response.headers = this.hideSensitive(
+      this.normalizeHeaders(payload.data.response?.headers),
+      headersToHide
+    );
+    payload.data.body = this.hideSensitive(payload.data.body, bodyParamsToHide, false);
+    await getStore().save(payload);
+  }
+  /**
+   * Normalize headers: converts keys to lowercase.
+   */
+  normalizeHeaders(headers) {
+    if (!headers || typeof headers !== "object") return {};
+    return Object.fromEntries(
+      Object.entries(headers).map(([k, v]) => [k.toLowerCase(), v])
+    );
+  }
+  hideSensitive(obj, keysToHide = [], isObjHeaders = true) {
+    if (!obj || typeof obj !== "object") {
+      return isObjHeaders ? {} : obj;
+    }
+    const clone = { ...obj };
+    for (const key of keysToHide) {
+      if (key in clone) {
+        clone[key] = "*******";
+      }
+    }
+    return clone;
   }
 };
 
@@ -919,6 +1053,7 @@ var handleUncaughExceptions = (logger) => {
   LensStore,
   LensWatcher,
   QueryWatcher,
+  QueuedSqliteStore,
   RequestWatcher,
   WatcherTypeEnum,
   createEmittery,

package/dist/index.d.cts

@@ -1,19 +1,22 @@
 export { default as Lens } from './core/lens.cjs';
 export { default as BetterSqliteStore } from './stores/better_sqlite.cjs';
+export { default as QueuedSqliteStore } from './stores/queued_sqlite.cjs';
 export { default as QueryWatcher } from './watchers/query_watcher.cjs';
 export { default as RequestWatcher } from './watchers/request_watcher.cjs';
 export { default as CacheWatcher } from './watchers/cache_watcher.cjs';
 export { default as ExceptionWatcher } from './watchers/exception_watcher.cjs';
-export { ApiResponse, CacheAction, CacheEntry, Entry, ExceptionEntry, HttpMethod, LensConfig, LensEntry, PaginationParams, Paginator, QueryEntry, QueryType, RequestEntry, RouteDefinition, RouteDefinitionHandler, RouteHttpMethod, SqlQueryType, UserEntry, WatcherTypeEnum } from './types/index.cjs';
+export { ApiResponse, CacheAction, CacheEntry, Constructor, Entry, ExceptionEntry, HttpMethod, LensConfig, LensEntry, PaginationParams, Paginator, QueryEntry, QueryType, QueuedStoreConfig, RequestEntry, RouteDefinition, RouteDefinitionHandler, RouteHttpMethod, SqlQueryType, UserEntry, WatcherTypeEnum } from './types/index.cjs';
 export { default as LensAdapter } from './abstracts/adapter.cjs';
 export { default as LensStore } from './abstracts/store.cjs';
 export { default as LensWatcher } from './core/watcher.cjs';
 export { getStore as getLensStore } from './context/context.cjs';
-export { i as lensUtils } from './index-CMvlRWcQ.cjs';
+export { i as lensUtils } from './index-QmOJr0K-.cjs';
 export { e as lensExceptionUtils } from './exception-C69UCHPk.cjs';
 export { createEmittery, lensEmitter } from './utils/event_emitter.cjs';
 export { handleUncaughExceptions, lensContext } from './utils/async_context.cjs';
 import 'libsql';
+import 'denque';
 import 'sql-formatter';
+import './utils/compose.cjs';
 import 'events';
 import 'async_hooks';

package/dist/index.d.ts

@@ -1,19 +1,22 @@
 export { default as Lens } from './core/lens.js';
 export { default as BetterSqliteStore } from './stores/better_sqlite.js';
+export { default as QueuedSqliteStore } from './stores/queued_sqlite.js';
 export { default as QueryWatcher } from './watchers/query_watcher.js';
 export { default as RequestWatcher } from './watchers/request_watcher.js';
 export { default as CacheWatcher } from './watchers/cache_watcher.js';
 export { default as ExceptionWatcher } from './watchers/exception_watcher.js';
-export { ApiResponse, CacheAction, CacheEntry, Entry, ExceptionEntry, HttpMethod, LensConfig, LensEntry, PaginationParams, Paginator, QueryEntry, QueryType, RequestEntry, RouteDefinition, RouteDefinitionHandler, RouteHttpMethod, SqlQueryType, UserEntry, WatcherTypeEnum } from './types/index.js';
+export { ApiResponse, CacheAction, CacheEntry, Constructor, Entry, ExceptionEntry, HttpMethod, LensConfig, LensEntry, PaginationParams, Paginator, QueryEntry, QueryType, QueuedStoreConfig, RequestEntry, RouteDefinition, RouteDefinitionHandler, RouteHttpMethod, SqlQueryType, UserEntry, WatcherTypeEnum } from './types/index.js';
 export { default as LensAdapter } from './abstracts/adapter.js';
 export { default as LensStore } from './abstracts/store.js';
 export { default as LensWatcher } from './core/watcher.js';
 export { getStore as getLensStore } from './context/context.js';
-export { i as lensUtils } from './index-CMvlRWcQ.js';
+export { i as lensUtils } from './index-CZsa0Zcm.js';
 export { e as lensExceptionUtils } from './exception-3AZsPtAg.js';
 export { createEmittery, lensEmitter } from './utils/event_emitter.js';
 export { handleUncaughExceptions, lensContext } from './utils/async_context.js';
 import 'libsql';
+import 'denque';
 import 'sql-formatter';
+import './utils/compose.js';
 import 'events';
 import 'async_hooks';

package/dist/index.js

@@ -183,6 +183,8 @@ import * as path2 from "path";
 
 // src/abstracts/store.ts
 var Store = class {
+  constructor(...args) {
+  }
   getAllExceptions(_paginationParams) {
     return this.defaultMinimalPaginate();
   }
@@ -334,9 +336,98 @@ var BetterSqliteStore = class extends Store {
   }
 };
 
+// src/mixins/queued_store.ts
+import Denque from "denque";
+function QueuedStore(Base) {
+  return class Queued extends Base {
+    queue;
+    processingInterval = null;
+    BATCH_SIZE;
+    PROCESS_INTERVAL_MS;
+    WARN_THRESHOLD;
+    PREALLOCATE;
+    constructor(...args) {
+      super(...args);
+      const config = args[0] || {};
+      this.BATCH_SIZE = config.batchSize ?? 100;
+      this.PROCESS_INTERVAL_MS = config.processIntervalMs ?? 100;
+      this.WARN_THRESHOLD = config.warnThreshold ?? 1e5;
+      this.PREALLOCATE = config.preallocate ?? true;
+      this.queue = this.PREALLOCATE ? new Denque([], { capacity: this.WARN_THRESHOLD * 2 }) : new Denque();
+    }
+    async initialize() {
+      if (super["initialize"]) {
+        await super["initialize"].call(this);
+      }
+      this.startProcessingQueue();
+      process.on("SIGINT", () => this.shutdown());
+      process.on("SIGTERM", () => this.shutdown());
+    }
+    async truncate() {
+      this.queue.clear();
+      if (super["truncate"]) {
+        await super["truncate"].call(this);
+      }
+    }
+    async save(entry) {
+      this.queue.push(entry);
+      if (this.queue.length > this.WARN_THRESHOLD) {
+        console.warn(`\u26A0\uFE0F LensJs Queue size very large: ${this.queue.length}`);
+      }
+    }
+    startProcessingQueue() {
+      if (this.processingInterval) clearInterval(this.processingInterval);
+      this.processingInterval = setInterval(
+        () => this.processQueue(),
+        this.PROCESS_INTERVAL_MS
+      );
+    }
+    async processQueue() {
+      if (this.queue.isEmpty()) return;
+      const batchSize = Math.min(
+        this.BATCH_SIZE,
+        Math.max(10, Math.floor(this.queue.length / 10))
+      );
+      const entriesToProcess = this.queue.remove(0, batchSize);
+      if (!entriesToProcess.length) return;
+      for (const entry of entriesToProcess) {
+        super["save"]?.call(this, entry).catch((error) => {
+          console.error("Error saving queued entry:", error);
+        });
+      }
+    }
+    async stopProcessingQueue() {
+      if (this.processingInterval) {
+        clearInterval(this.processingInterval);
+        this.processingInterval = null;
+      }
+      if (!this.queue.isEmpty()) {
+        await this.processQueue();
+      }
+    }
+    async shutdown() {
+      await this.stopProcessingQueue();
+      process.exit(0);
+    }
+  };
+}
+
+// src/utils/compose.ts
+function compose(superclass, ...mixins) {
+  return mixins.reduce((c, mixin) => mixin(c), superclass);
+}
+
+// src/stores/queued_sqlite.ts
+var QueuedSqliteStore = class extends compose(
+  BetterSqliteStore,
+  QueuedStore
+) {
+};
+
 // src/utils/index.ts
 var utils_exports = {};
 __export(utils_exports, {
+  compose: () => compose,
   formatSqlQuery: () => formatSqlQuery,
   generateRandomUuid: () => generateRandomUuid,
   getMeta: () => getMeta,
@@ -476,6 +567,7 @@ var Lens = class {
   static watchers = /* @__PURE__ */ new Map();
   static store;
   static adapter;
+  static config;
   static watch(watcher) {
     this.watchers.set(watcher.name, watcher);
     return this;
@@ -485,22 +577,23 @@ var Lens = class {
     return this;
   }
   static async start(config = {
-    basePath: "lens",
+    path: "lens",
     appName: "Lens",
     enabled: true
   }) {
     if (!config.enabled) {
       return;
     }
-    await this.bindContainerDeps(config);
+    this.config = config;
+    await this.bindContainerDeps();
     let adapter = this.getAdapter();
     adapter.setWatchers(Array.from(this.watchers.values())).setup();
     const { apiRoutes } = this.getRoutes({
-      basePath: config.basePath
+      path: config.path
     });
     adapter.registerRoutes(apiRoutes);
     const uiPath = this.getUiPath();
-    adapter.serveUI(uiPath, config.basePath, getUiConfig());
+    adapter.serveUI(uiPath, config.path, getUiConfig());
   }
   static setStore(store) {
     this.store = store;
@@ -523,7 +616,7 @@ var Lens = class {
     const { __dirname: __dirname2 } = getMeta(import.meta.url);
     return path2.resolve(this.normalizeDirName(__dirname2), "ui");
   }
-  static getRoutes({ basePath }) {
+  static getRoutes({ path: path4 }) {
     const apiRoutes = [
       {
         method: "GET",
@@ -532,71 +625,71 @@ var Lens = class {
       },
       {
         method: "GET",
-        path: `/${basePath}/api/requests`,
+        path: `/${path4}/api/requests`,
         handler: async (data) => await ApiController.getRequests(data)
       },
       {
         method: "GET",
-        path: `/${basePath}/api/requests/:id`,
+        path: `/${path4}/api/requests/:id`,
         handler: async (data) => await ApiController.getRequest(data)
       },
       {
         method: "GET",
-        path: `/${basePath}/api/queries`,
+        path: `/${path4}/api/queries`,
         handler: async (data) => await ApiController.getQueries(data)
       },
       {
         method: "GET",
-        path: `/${basePath}/api/queries/:id`,
+        path: `/${path4}/api/queries/:id`,
         handler: async (data) => await ApiController.getQuery(data)
       },
       {
         method: "GET",
-        path: `/${basePath}/api/cache`,
+        path: `/${path4}/api/cache`,
         handler: async (data) => await ApiController.getCacheEntries(data)
       },
       {
         method: "GET",
-        path: `/${basePath}/api/cache/:id`,
+        path: `/${path4}/api/cache/:id`,
         handler: async (data) => await ApiController.getCacheEntry(data)
       },
       {
         method: "GET",
-        path: `/${basePath}/api/exceptions`,
+        path: `/${path4}/api/exceptions`,
         handler: async (data) => await ApiController.getExceptions(data)
       },
       {
         method: "GET",
-        path: `/${basePath}/api/exceptions/:id`,
+        path: `/${path4}/api/exceptions/:id`,
         handler: async (data) => await ApiController.getException(data)
       },
       {
         method: "DELETE",
-        path: `/${basePath}/api/truncate`,
+        path: `/${path4}/api/truncate`,
         handler: async () => await ApiController.truncate()
       }
     ];
     return { apiRoutes };
   }
-  static async bindContainerDeps(config) {
+  static async bindContainerDeps() {
     const dbStore = await this.getStore();
     Container.singleton("store", () => dbStore);
     Container.singleton("uiConfig", () => {
       return {
-        appName: config.appName,
-        path: `/${config.basePath}`,
+        appName: this.config.appName,
+        path: `/${this.config.path}`,
         api: {
-          requests: `/${config.basePath}/api/requests`,
-          queries: `/${config.basePath}/api/queries`,
-          cache: `/${config.basePath}/api/cache`,
-          exceptions: `/${config.basePath}/api/exceptions`,
-          truncate: `/${config.basePath}/api/truncate`
+          requests: `/${this.config.path}/api/requests`,
+          queries: `/${this.config.path}/api/queries`,
+          cache: `/${this.config.path}/api/cache`,
+          exceptions: `/${this.config.path}/api/exceptions`,
+          truncate: `/${this.config.path}/api/truncate`
         }
       };
     });
   }
   static async getDefaultStore() {
-    const store = new BetterSqliteStore();
+    const store = new QueuedSqliteStore(this.config.storeQueueConfig);
     await store.initialize();
     return store;
   }
@@ -622,10 +715,19 @@ var QueryWatcher = class extends Watcher {
 };
 
 // src/watchers/request_watcher.ts
-var RequestWatcher = class extends Watcher {
+var RequestWatcher = class _RequestWatcher extends Watcher {
   name = "request" /* REQUEST */;
-  async log(data) {
-    await getStore().save({
+  static DEFAULT_HIDDEN_HEADERS = ["Authorization", "Basic"];
+  static DEFAULT_HIDDEN_BODY_PARAMS = [
+    "password",
+    "passwordConfirmation",
+    "secret",
+    "password_confirmation"
+  ];
+  async log(data, hidden = {}) {
+    const headersToHide = (hidden.headers?.length ? hidden.headers : _RequestWatcher.DEFAULT_HIDDEN_HEADERS).map((header) => header.toLowerCase());
+    const bodyParamsToHide = hidden.bodyParams?.length ? hidden.bodyParams : _RequestWatcher.DEFAULT_HIDDEN_BODY_PARAMS;
+    const payload = {
       id: data.request.id,
       type: this.name,
       minimal_data: {
@@ -639,9 +741,40 @@ var RequestWatcher = class extends Watcher {
       data: {
         ...data.request,
         user: data.user,
-        response: data.response
+        response: data.response || {}
       }
-    });
+    };
+    payload.data.headers = this.hideSensitive(
+      this.normalizeHeaders(payload.data.headers),
+      headersToHide
+    );
+    payload.data.response.headers = this.hideSensitive(
+      this.normalizeHeaders(payload.data.response?.headers),
+      headersToHide
+    );
+    payload.data.body = this.hideSensitive(payload.data.body, bodyParamsToHide, false);
+    await getStore().save(payload);
+  }
+  /**
+   * Normalize headers: converts keys to lowercase.
+   */
+  normalizeHeaders(headers) {
+    if (!headers || typeof headers !== "object") return {};
+    return Object.fromEntries(
+      Object.entries(headers).map(([k, v]) => [k.toLowerCase(), v])
+    );
+  }
+  hideSensitive(obj, keysToHide = [], isObjHeaders = true) {
+    if (!obj || typeof obj !== "object") {
+      return isObjHeaders ? {} : obj;
+    }
+    const clone = { ...obj };
+    for (const key of keysToHide) {
+      if (key in clone) {
+        clone[key] = "*******";
+      }
+    }
+    return clone;
   }
 };
 
@@ -871,6 +1004,7 @@ export {
   Store as LensStore,
   Watcher as LensWatcher,
   QueryWatcher,
+  QueuedSqliteStore,
   RequestWatcher,
   WatcherTypeEnum,
   createEmittery,