@hedystia/db 2.0.0 → 2.0.2

package/dist/_virtual/_rolldown/runtime.cjs

@@ -0,0 +1,13 @@
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+//#endregion
+exports.__exportAll = __exportAll;

package/dist/_virtual/_rolldown/runtime.mjs

@@ -0,0 +1,17 @@
+import { createRequire } from "node:module";
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __esmMin = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __commonJSMin = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+//#endregion
+export { __commonJSMin, __esmMin, __exportAll, __require };

package/dist/cache/manager.cjs

@@ -0,0 +1,137 @@
+const require_constants = require("../constants.cjs");
+const require_stable_stringify = require("../utils/stable-stringify.cjs");
+const require_memory_store = require("./memory-store.cjs");
+//#region src/cache/manager.ts
+/**
+* Cache manager that wraps query execution with caching behavior
+*/
+var CacheManager = class {
+	store;
+	baseTtl;
+	maxTtl;
+	enabled;
+	constructor(config) {
+		if (typeof config === "boolean") {
+			this.enabled = config;
+			this.baseTtl = require_constants.DEFAULT_CACHE_TTL;
+			this.maxTtl = require_constants.DEFAULT_CACHE_MAX_TTL;
+			this.store = new require_memory_store.MemoryStore(require_constants.DEFAULT_CACHE_MAX_ENTRIES);
+		} else if (config) {
+			this.enabled = config.enabled;
+			this.baseTtl = config.ttl ?? 6e4;
+			this.maxTtl = config.maxTtl ?? 3e5;
+			this.store = new require_memory_store.MemoryStore(config.maxEntries ?? 1e4);
+		} else {
+			this.enabled = false;
+			this.baseTtl = require_constants.DEFAULT_CACHE_TTL;
+			this.maxTtl = require_constants.DEFAULT_CACHE_MAX_TTL;
+			this.store = new require_memory_store.MemoryStore();
+		}
+	}
+	/**
+	* Get a cached query result or execute the query and cache the result
+	* @param {string} table - Table name
+	* @param {string} method - Method name (find, findFirst, etc.)
+	* @param {unknown} options - Query options
+	* @param {() => Promise<T>} executor - Function that executes the query
+	* @returns {Promise<T>} The query result
+	*/
+	async getOrSet(table, method, options, executor) {
+		if (!this.enabled) return executor();
+		const key = this.buildKey(table, method, options);
+		const cached = this.store.get(key);
+		if (cached !== void 0) {
+			this.store.extendTtl(key, this.baseTtl, this.maxTtl);
+			return cached;
+		}
+		const result = await executor();
+		this.store.set(key, result, this.baseTtl);
+		return result;
+	}
+	/**
+	* Set an entity in the cache by primary key
+	* @param {string} table - Table name
+	* @param {string | number} id - Primary key value
+	* @param {unknown} data - Entity data
+	*/
+	setEntity(table, id, data) {
+		if (!this.enabled) return;
+		const key = `entity:${table}:${id}`;
+		this.store.set(key, data, this.baseTtl);
+	}
+	/**
+	* Get a cached entity by primary key
+	* @param {string} table - Table name
+	* @param {string | number} id - Primary key value
+	* @returns {unknown | undefined} Cached entity or undefined
+	*/
+	getEntity(table, id) {
+		if (!this.enabled) return;
+		const key = `entity:${table}:${id}`;
+		const result = this.store.get(key);
+		if (result !== void 0) this.store.extendTtl(key, this.baseTtl, this.maxTtl);
+		return result;
+	}
+	/**
+	* Invalidate all cache entries for a table
+	* @param {string} table - Table name
+	*/
+	invalidateTable(table) {
+		if (!this.enabled) return;
+		this.store.invalidateByPrefix(`query:${table}:`);
+		this.store.invalidateByPrefix(`entity:${table}:`);
+	}
+	/**
+	* Invalidate a specific entity cache entry
+	* @param {string} table - Table name
+	* @param {string | number} id - Primary key value
+	*/
+	invalidateEntity(table, id) {
+		if (!this.enabled) return;
+		this.store.delete(`entity:${table}:${id}`);
+		this.store.invalidateByPrefix(`query:${table}:`);
+	}
+	/**
+	* Update an entity in cache if it exists
+	* @param {string} table - Table name
+	* @param {string | number} id - Primary key value
+	* @param {Record<string, unknown>} data - Updated data
+	*/
+	updateEntity(table, id, data) {
+		if (!this.enabled) return;
+		const key = `entity:${table}:${id}`;
+		const existing = this.store.get(key);
+		if (existing && typeof existing === "object") this.store.set(key, {
+			...existing,
+			...data
+		}, this.baseTtl);
+		this.store.invalidateByPrefix(`query:${table}:`);
+	}
+	/**
+	* Clear the entire cache
+	*/
+	clear() {
+		this.store.clear();
+	}
+	/**
+	* Get the number of cached entries
+	* @returns {number} Cache size
+	*/
+	get size() {
+		return this.store.size;
+	}
+	/**
+	* Check if caching is enabled
+	* @returns {boolean} Whether caching is enabled
+	*/
+	get isEnabled() {
+		return this.enabled;
+	}
+	buildKey(table, method, options) {
+		return `query:${table}:${method}:${require_stable_stringify.stableStringify(options)}`;
+	}
+};
+//#endregion
+exports.CacheManager = CacheManager;
+
+//# sourceMappingURL=manager.cjs.map

package/dist/cache/manager.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.cjs","names":["DEFAULT_CACHE_TTL","DEFAULT_CACHE_MAX_TTL","MemoryStore","DEFAULT_CACHE_MAX_ENTRIES","stableStringify"],"sources":["../../src/cache/manager.ts"],"sourcesContent":["import { DEFAULT_CACHE_MAX_ENTRIES, DEFAULT_CACHE_MAX_TTL, DEFAULT_CACHE_TTL } from \"../constants\";\nimport type { CacheConfig } from \"../types\";\nimport { stableStringify } from \"../utils\";\nimport { MemoryStore } from \"./memory-store\";\n\n/**\n * Cache manager that wraps query execution with caching behavior\n */\nexport class CacheManager {\n  private store: MemoryStore;\n  private baseTtl: number;\n  private maxTtl: number;\n  private enabled: boolean;\n\n  constructor(config?: boolean | CacheConfig) {\n    if (typeof config === \"boolean\") {\n      this.enabled = config;\n      this.baseTtl = DEFAULT_CACHE_TTL;\n      this.maxTtl = DEFAULT_CACHE_MAX_TTL;\n      this.store = new MemoryStore(DEFAULT_CACHE_MAX_ENTRIES);\n    } else if (config) {\n      this.enabled = config.enabled;\n      this.baseTtl = config.ttl ?? DEFAULT_CACHE_TTL;\n      this.maxTtl = config.maxTtl ?? DEFAULT_CACHE_MAX_TTL;\n      this.store = new MemoryStore(config.maxEntries ?? DEFAULT_CACHE_MAX_ENTRIES);\n    } else {\n      this.enabled = false;\n      this.baseTtl = DEFAULT_CACHE_TTL;\n      this.maxTtl = DEFAULT_CACHE_MAX_TTL;\n      this.store = new MemoryStore();\n    }\n  }\n\n  /**\n   * Get a cached query result or execute the query and cache the result\n   * @param {string} table - Table name\n   * @param {string} method - Method name (find, findFirst, etc.)\n   * @param {unknown} options - Query options\n   * @param {() => Promise<T>} executor - Function that executes the query\n   * @returns {Promise<T>} The query result\n   */\n  async getOrSet<T>(\n    table: string,\n    method: string,\n    options: unknown,\n    executor: () => Promise<T>,\n  ): Promise<T> {\n    if (!this.enabled) {\n      return executor();\n    }\n\n    const key = this.buildKey(table, method, options);\n    const cached = this.store.get(key);\n    if (cached !== undefined) {\n      this.store.extendTtl(key, this.baseTtl, this.maxTtl);\n      return cached as T;\n    }\n\n    const result = await executor();\n    this.store.set(key, result, this.baseTtl);\n    return result;\n  }\n\n  /**\n   * Set an entity in the cache by primary key\n   * @param {string} table - Table name\n   * @param {string | number} id - Primary key value\n   * @param {unknown} data - Entity data\n   */\n  setEntity(table: string, id: string | number, data: unknown): void {\n    if (!this.enabled) {\n      return;\n    }\n    const key = `entity:${table}:${id}`;\n    this.store.set(key, data, this.baseTtl);\n  }\n\n  /**\n   * Get a cached entity by primary key\n   * @param {string} table - Table name\n   * @param {string | number} id - Primary key value\n   * @returns {unknown | undefined} Cached entity or undefined\n   */\n  getEntity(table: string, id: string | number): unknown | undefined {\n    if (!this.enabled) {\n      return undefined;\n    }\n    const key = `entity:${table}:${id}`;\n    const result = this.store.get(key);\n    if (result !== undefined) {\n      this.store.extendTtl(key, this.baseTtl, this.maxTtl);\n    }\n    return result;\n  }\n\n  /**\n   * Invalidate all cache entries for a table\n   * @param {string} table - Table name\n   */\n  invalidateTable(table: string): void {\n    if (!this.enabled) {\n      return;\n    }\n    this.store.invalidateByPrefix(`query:${table}:`);\n    this.store.invalidateByPrefix(`entity:${table}:`);\n  }\n\n  /**\n   * Invalidate a specific entity cache entry\n   * @param {string} table - Table name\n   * @param {string | number} id - Primary key value\n   */\n  invalidateEntity(table: string, id: string | number): void {\n    if (!this.enabled) {\n      return;\n    }\n    this.store.delete(`entity:${table}:${id}`);\n    this.store.invalidateByPrefix(`query:${table}:`);\n  }\n\n  /**\n   * Update an entity in cache if it exists\n   * @param {string} table - Table name\n   * @param {string | number} id - Primary key value\n   * @param {Record<string, unknown>} data - Updated data\n   */\n  updateEntity(table: string, id: string | number, data: Record<string, unknown>): void {\n    if (!this.enabled) {\n      return;\n    }\n    const key = `entity:${table}:${id}`;\n    const existing = this.store.get(key);\n    if (existing && typeof existing === \"object\") {\n      this.store.set(key, { ...existing, ...data }, this.baseTtl);\n    }\n    this.store.invalidateByPrefix(`query:${table}:`);\n  }\n\n  /**\n   * Clear the entire cache\n   */\n  clear(): void {\n    this.store.clear();\n  }\n\n  /**\n   * Get the number of cached entries\n   * @returns {number} Cache size\n   */\n  get size(): number {\n    return this.store.size;\n  }\n\n  /**\n   * Check if caching is enabled\n   * @returns {boolean} Whether caching is enabled\n   */\n  get isEnabled(): boolean {\n    return this.enabled;\n  }\n\n  private buildKey(table: string, method: string, options: unknown): string {\n    return `query:${table}:${method}:${stableStringify(options)}`;\n  }\n}\n"],"mappings":";;;;;;;AAQA,IAAa,eAAb,MAA0B;CACxB;CACA;CACA;CACA;CAEA,YAAY,QAAgC;AAC1C,MAAI,OAAO,WAAW,WAAW;AAC/B,QAAK,UAAU;AACf,QAAK,UAAUA,kBAAAA;AACf,QAAK,SAASC,kBAAAA;AACd,QAAK,QAAQ,IAAIC,qBAAAA,YAAYC,kBAAAA,0BAA0B;aAC9C,QAAQ;AACjB,QAAK,UAAU,OAAO;AACtB,QAAK,UAAU,OAAO,OAAA;AACtB,QAAK,SAAS,OAAO,UAAA;AACrB,QAAK,QAAQ,IAAID,qBAAAA,YAAY,OAAO,cAAA,IAAwC;SACvE;AACL,QAAK,UAAU;AACf,QAAK,UAAUF,kBAAAA;AACf,QAAK,SAASC,kBAAAA;AACd,QAAK,QAAQ,IAAIC,qBAAAA,aAAa;;;;;;;;;;;CAYlC,MAAM,SACJ,OACA,QACA,SACA,UACY;AACZ,MAAI,CAAC,KAAK,QACR,QAAO,UAAU;EAGnB,MAAM,MAAM,KAAK,SAAS,OAAO,QAAQ,QAAQ;EACjD,MAAM,SAAS,KAAK,MAAM,IAAI,IAAI;AAClC,MAAI,WAAW,KAAA,GAAW;AACxB,QAAK,MAAM,UAAU,KAAK,KAAK,SAAS,KAAK,OAAO;AACpD,UAAO;;EAGT,MAAM,SAAS,MAAM,UAAU;AAC/B,OAAK,MAAM,IAAI,KAAK,QAAQ,KAAK,QAAQ;AACzC,SAAO;;;;;;;;CAST,UAAU,OAAe,IAAqB,MAAqB;AACjE,MAAI,CAAC,KAAK,QACR;EAEF,MAAM,MAAM,UAAU,MAAM,GAAG;AAC/B,OAAK,MAAM,IAAI,KAAK,MAAM,KAAK,QAAQ;;;;;;;;CASzC,UAAU,OAAe,IAA0C;AACjE,MAAI,CAAC,KAAK,QACR;EAEF,MAAM,MAAM,UAAU,MAAM,GAAG;EAC/B,MAAM,SAAS,KAAK,MAAM,IAAI,IAAI;AAClC,MAAI,WAAW,KAAA,EACb,MAAK,MAAM,UAAU,KAAK,KAAK,SAAS,KAAK,OAAO;AAEtD,SAAO;;;;;;CAOT,gBAAgB,OAAqB;AACnC,MAAI,CAAC,KAAK,QACR;AAEF,OAAK,MAAM,mBAAmB,SAAS,MAAM,GAAG;AAChD,OAAK,MAAM,mBAAmB,UAAU,MAAM,GAAG;;;;;;;CAQnD,iBAAiB,OAAe,IAA2B;AACzD,MAAI,CAAC,KAAK,QACR;AAEF,OAAK,MAAM,OAAO,UAAU,MAAM,GAAG,KAAK;AAC1C,OAAK,MAAM,mBAAmB,SAAS,MAAM,GAAG;;;;;;;;CASlD,aAAa,OAAe,IAAqB,MAAqC;AACpF,MAAI,CAAC,KAAK,QACR;EAEF,MAAM,MAAM,UAAU,MAAM,GAAG;EAC/B,MAAM,WAAW,KAAK,MAAM,IAAI,IAAI;AACpC,MAAI,YAAY,OAAO,aAAa,SAClC,MAAK,MAAM,IAAI,KAAK;GAAE,GAAG;GAAU,GAAG;GAAM,EAAE,KAAK,QAAQ;AAE7D,OAAK,MAAM,mBAAmB,SAAS,MAAM,GAAG;;;;;CAMlD,QAAc;AACZ,OAAK,MAAM,OAAO;;;;;;CAOpB,IAAI,OAAe;AACjB,SAAO,KAAK,MAAM;;;;;;CAOpB,IAAI,YAAqB;AACvB,SAAO,KAAK;;CAGd,SAAiB,OAAe,QAAgB,SAA0B;AACxE,SAAO,SAAS,MAAM,GAAG,OAAO,GAAGE,yBAAAA,gBAAgB,QAAQ"}

package/dist/cache/manager.d.cts

@@ -0,0 +1,72 @@
+import { CacheConfig } from "../types.cjs";
+
+//#region src/cache/manager.d.ts
+/**
+ * Cache manager that wraps query execution with caching behavior
+ */
+declare class CacheManager {
+  private store;
+  private baseTtl;
+  private maxTtl;
+  private enabled;
+  constructor(config?: boolean | CacheConfig);
+  /**
+   * Get a cached query result or execute the query and cache the result
+   * @param {string} table - Table name
+   * @param {string} method - Method name (find, findFirst, etc.)
+   * @param {unknown} options - Query options
+   * @param {() => Promise<T>} executor - Function that executes the query
+   * @returns {Promise<T>} The query result
+   */
+  getOrSet<T>(table: string, method: string, options: unknown, executor: () => Promise<T>): Promise<T>;
+  /**
+   * Set an entity in the cache by primary key
+   * @param {string} table - Table name
+   * @param {string | number} id - Primary key value
+   * @param {unknown} data - Entity data
+   */
+  setEntity(table: string, id: string | number, data: unknown): void;
+  /**
+   * Get a cached entity by primary key
+   * @param {string} table - Table name
+   * @param {string | number} id - Primary key value
+   * @returns {unknown | undefined} Cached entity or undefined
+   */
+  getEntity(table: string, id: string | number): unknown | undefined;
+  /**
+   * Invalidate all cache entries for a table
+   * @param {string} table - Table name
+   */
+  invalidateTable(table: string): void;
+  /**
+   * Invalidate a specific entity cache entry
+   * @param {string} table - Table name
+   * @param {string | number} id - Primary key value
+   */
+  invalidateEntity(table: string, id: string | number): void;
+  /**
+   * Update an entity in cache if it exists
+   * @param {string} table - Table name
+   * @param {string | number} id - Primary key value
+   * @param {Record<string, unknown>} data - Updated data
+   */
+  updateEntity(table: string, id: string | number, data: Record<string, unknown>): void;
+  /**
+   * Clear the entire cache
+   */
+  clear(): void;
+  /**
+   * Get the number of cached entries
+   * @returns {number} Cache size
+   */
+  get size(): number;
+  /**
+   * Check if caching is enabled
+   * @returns {boolean} Whether caching is enabled
+   */
+  get isEnabled(): boolean;
+  private buildKey;
+}
+//#endregion
+export { CacheManager };
+//# sourceMappingURL=manager.d.cts.map

package/dist/cache/manager.d.mts

@@ -0,0 +1,72 @@
+import { CacheConfig } from "../types.mjs";
+
+//#region src/cache/manager.d.ts
+/**
+ * Cache manager that wraps query execution with caching behavior
+ */
+declare class CacheManager {
+  private store;
+  private baseTtl;
+  private maxTtl;
+  private enabled;
+  constructor(config?: boolean | CacheConfig);
+  /**
+   * Get a cached query result or execute the query and cache the result
+   * @param {string} table - Table name
+   * @param {string} method - Method name (find, findFirst, etc.)
+   * @param {unknown} options - Query options
+   * @param {() => Promise<T>} executor - Function that executes the query
+   * @returns {Promise<T>} The query result
+   */
+  getOrSet<T>(table: string, method: string, options: unknown, executor: () => Promise<T>): Promise<T>;
+  /**
+   * Set an entity in the cache by primary key
+   * @param {string} table - Table name
+   * @param {string | number} id - Primary key value
+   * @param {unknown} data - Entity data
+   */
+  setEntity(table: string, id: string | number, data: unknown): void;
+  /**
+   * Get a cached entity by primary key
+   * @param {string} table - Table name
+   * @param {string | number} id - Primary key value
+   * @returns {unknown | undefined} Cached entity or undefined
+   */
+  getEntity(table: string, id: string | number): unknown | undefined;
+  /**
+   * Invalidate all cache entries for a table
+   * @param {string} table - Table name
+   */
+  invalidateTable(table: string): void;
+  /**
+   * Invalidate a specific entity cache entry
+   * @param {string} table - Table name
+   * @param {string | number} id - Primary key value
+   */
+  invalidateEntity(table: string, id: string | number): void;
+  /**
+   * Update an entity in cache if it exists
+   * @param {string} table - Table name
+   * @param {string | number} id - Primary key value
+   * @param {Record<string, unknown>} data - Updated data
+   */
+  updateEntity(table: string, id: string | number, data: Record<string, unknown>): void;
+  /**
+   * Clear the entire cache
+   */
+  clear(): void;
+  /**
+   * Get the number of cached entries
+   * @returns {number} Cache size
+   */
+  get size(): number;
+  /**
+   * Check if caching is enabled
+   * @returns {boolean} Whether caching is enabled
+   */
+  get isEnabled(): boolean;
+  private buildKey;
+}
+//#endregion
+export { CacheManager };
+//# sourceMappingURL=manager.d.mts.map

package/dist/cache/manager.mjs

@@ -0,0 +1,140 @@
+import { DEFAULT_CACHE_MAX_ENTRIES, DEFAULT_CACHE_MAX_TTL, DEFAULT_CACHE_TTL, init_constants } from "../constants.mjs";
+import { stableStringify } from "../utils/stable-stringify.mjs";
+import { init_utils } from "../utils/index.mjs";
+import { MemoryStore } from "./memory-store.mjs";
+//#region src/cache/manager.ts
+init_constants();
+init_utils();
+/**
+* Cache manager that wraps query execution with caching behavior
+*/
+var CacheManager = class {
+	store;
+	baseTtl;
+	maxTtl;
+	enabled;
+	constructor(config) {
+		if (typeof config === "boolean") {
+			this.enabled = config;
+			this.baseTtl = DEFAULT_CACHE_TTL;
+			this.maxTtl = DEFAULT_CACHE_MAX_TTL;
+			this.store = new MemoryStore(DEFAULT_CACHE_MAX_ENTRIES);
+		} else if (config) {
+			this.enabled = config.enabled;
+			this.baseTtl = config.ttl ?? 6e4;
+			this.maxTtl = config.maxTtl ?? 3e5;
+			this.store = new MemoryStore(config.maxEntries ?? 1e4);
+		} else {
+			this.enabled = false;
+			this.baseTtl = DEFAULT_CACHE_TTL;
+			this.maxTtl = DEFAULT_CACHE_MAX_TTL;
+			this.store = new MemoryStore();
+		}
+	}
+	/**
+	* Get a cached query result or execute the query and cache the result
+	* @param {string} table - Table name
+	* @param {string} method - Method name (find, findFirst, etc.)
+	* @param {unknown} options - Query options
+	* @param {() => Promise<T>} executor - Function that executes the query
+	* @returns {Promise<T>} The query result
+	*/
+	async getOrSet(table, method, options, executor) {
+		if (!this.enabled) return executor();
+		const key = this.buildKey(table, method, options);
+		const cached = this.store.get(key);
+		if (cached !== void 0) {
+			this.store.extendTtl(key, this.baseTtl, this.maxTtl);
+			return cached;
+		}
+		const result = await executor();
+		this.store.set(key, result, this.baseTtl);
+		return result;
+	}
+	/**
+	* Set an entity in the cache by primary key
+	* @param {string} table - Table name
+	* @param {string | number} id - Primary key value
+	* @param {unknown} data - Entity data
+	*/
+	setEntity(table, id, data) {
+		if (!this.enabled) return;
+		const key = `entity:${table}:${id}`;
+		this.store.set(key, data, this.baseTtl);
+	}
+	/**
+	* Get a cached entity by primary key
+	* @param {string} table - Table name
+	* @param {string | number} id - Primary key value
+	* @returns {unknown | undefined} Cached entity or undefined
+	*/
+	getEntity(table, id) {
+		if (!this.enabled) return;
+		const key = `entity:${table}:${id}`;
+		const result = this.store.get(key);
+		if (result !== void 0) this.store.extendTtl(key, this.baseTtl, this.maxTtl);
+		return result;
+	}
+	/**
+	* Invalidate all cache entries for a table
+	* @param {string} table - Table name
+	*/
+	invalidateTable(table) {
+		if (!this.enabled) return;
+		this.store.invalidateByPrefix(`query:${table}:`);
+		this.store.invalidateByPrefix(`entity:${table}:`);
+	}
+	/**
+	* Invalidate a specific entity cache entry
+	* @param {string} table - Table name
+	* @param {string | number} id - Primary key value
+	*/
+	invalidateEntity(table, id) {
+		if (!this.enabled) return;
+		this.store.delete(`entity:${table}:${id}`);
+		this.store.invalidateByPrefix(`query:${table}:`);
+	}
+	/**
+	* Update an entity in cache if it exists
+	* @param {string} table - Table name
+	* @param {string | number} id - Primary key value
+	* @param {Record<string, unknown>} data - Updated data
+	*/
+	updateEntity(table, id, data) {
+		if (!this.enabled) return;
+		const key = `entity:${table}:${id}`;
+		const existing = this.store.get(key);
+		if (existing && typeof existing === "object") this.store.set(key, {
+			...existing,
+			...data
+		}, this.baseTtl);
+		this.store.invalidateByPrefix(`query:${table}:`);
+	}
+	/**
+	* Clear the entire cache
+	*/
+	clear() {
+		this.store.clear();
+	}
+	/**
+	* Get the number of cached entries
+	* @returns {number} Cache size
+	*/
+	get size() {
+		return this.store.size;
+	}
+	/**
+	* Check if caching is enabled
+	* @returns {boolean} Whether caching is enabled
+	*/
+	get isEnabled() {
+		return this.enabled;
+	}
+	buildKey(table, method, options) {
+		return `query:${table}:${method}:${stableStringify(options)}`;
+	}
+};
+//#endregion
+export { CacheManager };
+
+//# sourceMappingURL=manager.mjs.map

package/dist/cache/manager.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.mjs","names":[],"sources":["../../src/cache/manager.ts"],"sourcesContent":["import { DEFAULT_CACHE_MAX_ENTRIES, DEFAULT_CACHE_MAX_TTL, DEFAULT_CACHE_TTL } from \"../constants\";\nimport type { CacheConfig } from \"../types\";\nimport { stableStringify } from \"../utils\";\nimport { MemoryStore } from \"./memory-store\";\n\n/**\n * Cache manager that wraps query execution with caching behavior\n */\nexport class CacheManager {\n  private store: MemoryStore;\n  private baseTtl: number;\n  private maxTtl: number;\n  private enabled: boolean;\n\n  constructor(config?: boolean | CacheConfig) {\n    if (typeof config === \"boolean\") {\n      this.enabled = config;\n      this.baseTtl = DEFAULT_CACHE_TTL;\n      this.maxTtl = DEFAULT_CACHE_MAX_TTL;\n      this.store = new MemoryStore(DEFAULT_CACHE_MAX_ENTRIES);\n    } else if (config) {\n      this.enabled = config.enabled;\n      this.baseTtl = config.ttl ?? DEFAULT_CACHE_TTL;\n      this.maxTtl = config.maxTtl ?? DEFAULT_CACHE_MAX_TTL;\n      this.store = new MemoryStore(config.maxEntries ?? DEFAULT_CACHE_MAX_ENTRIES);\n    } else {\n      this.enabled = false;\n      this.baseTtl = DEFAULT_CACHE_TTL;\n      this.maxTtl = DEFAULT_CACHE_MAX_TTL;\n      this.store = new MemoryStore();\n    }\n  }\n\n  /**\n   * Get a cached query result or execute the query and cache the result\n   * @param {string} table - Table name\n   * @param {string} method - Method name (find, findFirst, etc.)\n   * @param {unknown} options - Query options\n   * @param {() => Promise<T>} executor - Function that executes the query\n   * @returns {Promise<T>} The query result\n   */\n  async getOrSet<T>(\n    table: string,\n    method: string,\n    options: unknown,\n    executor: () => Promise<T>,\n  ): Promise<T> {\n    if (!this.enabled) {\n      return executor();\n    }\n\n    const key = this.buildKey(table, method, options);\n    const cached = this.store.get(key);\n    if (cached !== undefined) {\n      this.store.extendTtl(key, this.baseTtl, this.maxTtl);\n      return cached as T;\n    }\n\n    const result = await executor();\n    this.store.set(key, result, this.baseTtl);\n    return result;\n  }\n\n  /**\n   * Set an entity in the cache by primary key\n   * @param {string} table - Table name\n   * @param {string | number} id - Primary key value\n   * @param {unknown} data - Entity data\n   */\n  setEntity(table: string, id: string | number, data: unknown): void {\n    if (!this.enabled) {\n      return;\n    }\n    const key = `entity:${table}:${id}`;\n    this.store.set(key, data, this.baseTtl);\n  }\n\n  /**\n   * Get a cached entity by primary key\n   * @param {string} table - Table name\n   * @param {string | number} id - Primary key value\n   * @returns {unknown | undefined} Cached entity or undefined\n   */\n  getEntity(table: string, id: string | number): unknown | undefined {\n    if (!this.enabled) {\n      return undefined;\n    }\n    const key = `entity:${table}:${id}`;\n    const result = this.store.get(key);\n    if (result !== undefined) {\n      this.store.extendTtl(key, this.baseTtl, this.maxTtl);\n    }\n    return result;\n  }\n\n  /**\n   * Invalidate all cache entries for a table\n   * @param {string} table - Table name\n   */\n  invalidateTable(table: string): void {\n    if (!this.enabled) {\n      return;\n    }\n    this.store.invalidateByPrefix(`query:${table}:`);\n    this.store.invalidateByPrefix(`entity:${table}:`);\n  }\n\n  /**\n   * Invalidate a specific entity cache entry\n   * @param {string} table - Table name\n   * @param {string | number} id - Primary key value\n   */\n  invalidateEntity(table: string, id: string | number): void {\n    if (!this.enabled) {\n      return;\n    }\n    this.store.delete(`entity:${table}:${id}`);\n    this.store.invalidateByPrefix(`query:${table}:`);\n  }\n\n  /**\n   * Update an entity in cache if it exists\n   * @param {string} table - Table name\n   * @param {string | number} id - Primary key value\n   * @param {Record<string, unknown>} data - Updated data\n   */\n  updateEntity(table: string, id: string | number, data: Record<string, unknown>): void {\n    if (!this.enabled) {\n      return;\n    }\n    const key = `entity:${table}:${id}`;\n    const existing = this.store.get(key);\n    if (existing && typeof existing === \"object\") {\n      this.store.set(key, { ...existing, ...data }, this.baseTtl);\n    }\n    this.store.invalidateByPrefix(`query:${table}:`);\n  }\n\n  /**\n   * Clear the entire cache\n   */\n  clear(): void {\n    this.store.clear();\n  }\n\n  /**\n   * Get the number of cached entries\n   * @returns {number} Cache size\n   */\n  get size(): number {\n    return this.store.size;\n  }\n\n  /**\n   * Check if caching is enabled\n   * @returns {boolean} Whether caching is enabled\n   */\n  get isEnabled(): boolean {\n    return this.enabled;\n  }\n\n  private buildKey(table: string, method: string, options: unknown): string {\n    return `query:${table}:${method}:${stableStringify(options)}`;\n  }\n}\n"],"mappings":";;;;;gBAAmG;YAExD;;;;AAM3C,IAAa,eAAb,MAA0B;CACxB;CACA;CACA;CACA;CAEA,YAAY,QAAgC;AAC1C,MAAI,OAAO,WAAW,WAAW;AAC/B,QAAK,UAAU;AACf,QAAK,UAAU;AACf,QAAK,SAAS;AACd,QAAK,QAAQ,IAAI,YAAY,0BAA0B;aAC9C,QAAQ;AACjB,QAAK,UAAU,OAAO;AACtB,QAAK,UAAU,OAAO,OAAA;AACtB,QAAK,SAAS,OAAO,UAAA;AACrB,QAAK,QAAQ,IAAI,YAAY,OAAO,cAAA,IAAwC;SACvE;AACL,QAAK,UAAU;AACf,QAAK,UAAU;AACf,QAAK,SAAS;AACd,QAAK,QAAQ,IAAI,aAAa;;;;;;;;;;;CAYlC,MAAM,SACJ,OACA,QACA,SACA,UACY;AACZ,MAAI,CAAC,KAAK,QACR,QAAO,UAAU;EAGnB,MAAM,MAAM,KAAK,SAAS,OAAO,QAAQ,QAAQ;EACjD,MAAM,SAAS,KAAK,MAAM,IAAI,IAAI;AAClC,MAAI,WAAW,KAAA,GAAW;AACxB,QAAK,MAAM,UAAU,KAAK,KAAK,SAAS,KAAK,OAAO;AACpD,UAAO;;EAGT,MAAM,SAAS,MAAM,UAAU;AAC/B,OAAK,MAAM,IAAI,KAAK,QAAQ,KAAK,QAAQ;AACzC,SAAO;;;;;;;;CAST,UAAU,OAAe,IAAqB,MAAqB;AACjE,MAAI,CAAC,KAAK,QACR;EAEF,MAAM,MAAM,UAAU,MAAM,GAAG;AAC/B,OAAK,MAAM,IAAI,KAAK,MAAM,KAAK,QAAQ;;;;;;;;CASzC,UAAU,OAAe,IAA0C;AACjE,MAAI,CAAC,KAAK,QACR;EAEF,MAAM,MAAM,UAAU,MAAM,GAAG;EAC/B,MAAM,SAAS,KAAK,MAAM,IAAI,IAAI;AAClC,MAAI,WAAW,KAAA,EACb,MAAK,MAAM,UAAU,KAAK,KAAK,SAAS,KAAK,OAAO;AAEtD,SAAO;;;;;;CAOT,gBAAgB,OAAqB;AACnC,MAAI,CAAC,KAAK,QACR;AAEF,OAAK,MAAM,mBAAmB,SAAS,MAAM,GAAG;AAChD,OAAK,MAAM,mBAAmB,UAAU,MAAM,GAAG;;;;;;;CAQnD,iBAAiB,OAAe,IAA2B;AACzD,MAAI,CAAC,KAAK,QACR;AAEF,OAAK,MAAM,OAAO,UAAU,MAAM,GAAG,KAAK;AAC1C,OAAK,MAAM,mBAAmB,SAAS,MAAM,GAAG;;;;;;;;CASlD,aAAa,OAAe,IAAqB,MAAqC;AACpF,MAAI,CAAC,KAAK,QACR;EAEF,MAAM,MAAM,UAAU,MAAM,GAAG;EAC/B,MAAM,WAAW,KAAK,MAAM,IAAI,IAAI;AACpC,MAAI,YAAY,OAAO,aAAa,SAClC,MAAK,MAAM,IAAI,KAAK;GAAE,GAAG;GAAU,GAAG;GAAM,EAAE,KAAK,QAAQ;AAE7D,OAAK,MAAM,mBAAmB,SAAS,MAAM,GAAG;;;;;CAMlD,QAAc;AACZ,OAAK,MAAM,OAAO;;;;;;CAOpB,IAAI,OAAe;AACjB,SAAO,KAAK,MAAM;;;;;;CAOpB,IAAI,YAAqB;AACvB,SAAO,KAAK;;CAGd,SAAiB,OAAe,QAAgB,SAA0B;AACxE,SAAO,SAAS,MAAM,GAAG,OAAO,GAAG,gBAAgB,QAAQ"}

package/dist/cache/memory-store.cjs

@@ -0,0 +1,122 @@
+//#region src/cache/memory-store.ts
+/**
+* In-memory cache store with TTL and hit-count tracking
+*/
+var MemoryStore = class {
+	store = /* @__PURE__ */ new Map();
+	maxEntries;
+	constructor(maxEntries = 1e4) {
+		this.maxEntries = maxEntries;
+	}
+	/**
+	* Get a value from cache
+	* @param {string} key - Cache key
+	* @returns {unknown | undefined} Cached value or undefined
+	*/
+	get(key) {
+		const entry = this.store.get(key);
+		if (!entry) return;
+		if (Date.now() > entry.expiresAt) {
+			this.store.delete(key);
+			return;
+		}
+		entry.hitCount++;
+		entry.lastAccess = Date.now();
+		return entry.value;
+	}
+	/**
+	* Set a value in cache with TTL
+	* @param {string} key - Cache key
+	* @param {unknown} value - Value to cache
+	* @param {number} ttl - Time to live in milliseconds
+	*/
+	set(key, value, ttl) {
+		if (this.store.size >= this.maxEntries) this.evict();
+		this.store.set(key, {
+			value,
+			expiresAt: Date.now() + ttl,
+			hitCount: 1,
+			lastAccess: Date.now()
+		});
+	}
+	/**
+	* Check if a key exists in cache and is not expired
+	* @param {string} key - Cache key
+	* @returns {boolean} Whether the key exists
+	*/
+	has(key) {
+		const entry = this.store.get(key);
+		if (!entry) return false;
+		if (Date.now() > entry.expiresAt) {
+			this.store.delete(key);
+			return false;
+		}
+		return true;
+	}
+	/**
+	* Delete a key from cache
+	* @param {string} key - Cache key
+	*/
+	delete(key) {
+		this.store.delete(key);
+	}
+	/**
+	* Invalidate all cache entries matching a prefix
+	* @param {string} prefix - Key prefix
+	*/
+	invalidateByPrefix(prefix) {
+		for (const key of this.store.keys()) if (key.startsWith(prefix)) this.store.delete(key);
+	}
+	/**
+	* Clear all cached entries
+	*/
+	clear() {
+		this.store.clear();
+	}
+	/**
+	* Get the number of cached entries
+	* @returns {number} Number of entries
+	*/
+	get size() {
+		return this.store.size;
+	}
+	/**
+	* Get hit count for a cache key
+	* @param {string} key - Cache key
+	* @returns {number} Number of hits
+	*/
+	getHitCount(key) {
+		return this.store.get(key)?.hitCount ?? 0;
+	}
+	/**
+	* Extend the TTL of a cache entry based on hit count
+	* @param {string} key - Cache key
+	* @param {number} baseTtl - Base TTL in milliseconds
+	* @param {number} maxTtl - Maximum TTL in milliseconds
+	*/
+	extendTtl(key, baseTtl, maxTtl) {
+		const entry = this.store.get(key);
+		if (!entry) return;
+		const adaptiveTtl = Math.min(maxTtl, baseTtl * (1 + Math.log2(entry.hitCount + 1)));
+		entry.expiresAt = Date.now() + adaptiveTtl;
+	}
+	evict() {
+		let oldestKey = null;
+		let oldestAccess = Number.POSITIVE_INFINITY;
+		for (const [key, entry] of this.store) {
+			if (Date.now() > entry.expiresAt) {
+				this.store.delete(key);
+				return;
+			}
+			if (entry.lastAccess < oldestAccess) {
+				oldestAccess = entry.lastAccess;
+				oldestKey = key;
+			}
+		}
+		if (oldestKey) this.store.delete(oldestKey);
+	}
+};
+//#endregion
+exports.MemoryStore = MemoryStore;
+
+//# sourceMappingURL=memory-store.cjs.map

package/dist/cache/memory-store.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-store.cjs","names":[],"sources":["../../src/cache/memory-store.ts"],"sourcesContent":["interface CacheEntry {\n  value: unknown;\n  expiresAt: number;\n  hitCount: number;\n  lastAccess: number;\n}\n\n/**\n * In-memory cache store with TTL and hit-count tracking\n */\nexport class MemoryStore {\n  private store = new Map<string, CacheEntry>();\n  private maxEntries: number;\n\n  constructor(maxEntries = 10_000) {\n    this.maxEntries = maxEntries;\n  }\n\n  /**\n   * Get a value from cache\n   * @param {string} key - Cache key\n   * @returns {unknown | undefined} Cached value or undefined\n   */\n  get(key: string): unknown | undefined {\n    const entry = this.store.get(key);\n    if (!entry) {\n      return undefined;\n    }\n    if (Date.now() > entry.expiresAt) {\n      this.store.delete(key);\n      return undefined;\n    }\n    entry.hitCount++;\n    entry.lastAccess = Date.now();\n    return entry.value;\n  }\n\n  /**\n   * Set a value in cache with TTL\n   * @param {string} key - Cache key\n   * @param {unknown} value - Value to cache\n   * @param {number} ttl - Time to live in milliseconds\n   */\n  set(key: string, value: unknown, ttl: number): void {\n    if (this.store.size >= this.maxEntries) {\n      this.evict();\n    }\n    this.store.set(key, {\n      value,\n      expiresAt: Date.now() + ttl,\n      hitCount: 1,\n      lastAccess: Date.now(),\n    });\n  }\n\n  /**\n   * Check if a key exists in cache and is not expired\n   * @param {string} key - Cache key\n   * @returns {boolean} Whether the key exists\n   */\n  has(key: string): boolean {\n    const entry = this.store.get(key);\n    if (!entry) {\n      return false;\n    }\n    if (Date.now() > entry.expiresAt) {\n      this.store.delete(key);\n      return false;\n    }\n    return true;\n  }\n\n  /**\n   * Delete a key from cache\n   * @param {string} key - Cache key\n   */\n  delete(key: string): void {\n    this.store.delete(key);\n  }\n\n  /**\n   * Invalidate all cache entries matching a prefix\n   * @param {string} prefix - Key prefix\n   */\n  invalidateByPrefix(prefix: string): void {\n    for (const key of this.store.keys()) {\n      if (key.startsWith(prefix)) {\n        this.store.delete(key);\n      }\n    }\n  }\n\n  /**\n   * Clear all cached entries\n   */\n  clear(): void {\n    this.store.clear();\n  }\n\n  /**\n   * Get the number of cached entries\n   * @returns {number} Number of entries\n   */\n  get size(): number {\n    return this.store.size;\n  }\n\n  /**\n   * Get hit count for a cache key\n   * @param {string} key - Cache key\n   * @returns {number} Number of hits\n   */\n  getHitCount(key: string): number {\n    return this.store.get(key)?.hitCount ?? 0;\n  }\n\n  /**\n   * Extend the TTL of a cache entry based on hit count\n   * @param {string} key - Cache key\n   * @param {number} baseTtl - Base TTL in milliseconds\n   * @param {number} maxTtl - Maximum TTL in milliseconds\n   */\n  extendTtl(key: string, baseTtl: number, maxTtl: number): void {\n    const entry = this.store.get(key);\n    if (!entry) {\n      return;\n    }\n    const adaptiveTtl = Math.min(maxTtl, baseTtl * (1 + Math.log2(entry.hitCount + 1)));\n    entry.expiresAt = Date.now() + adaptiveTtl;\n  }\n\n  private evict(): void {\n    let oldestKey: string | null = null;\n    let oldestAccess = Number.POSITIVE_INFINITY;\n    for (const [key, entry] of this.store) {\n      if (Date.now() > entry.expiresAt) {\n        this.store.delete(key);\n        return;\n      }\n      if (entry.lastAccess < oldestAccess) {\n        oldestAccess = entry.lastAccess;\n        oldestKey = key;\n      }\n    }\n    if (oldestKey) {\n      this.store.delete(oldestKey);\n    }\n  }\n}\n"],"mappings":";;;;AAUA,IAAa,cAAb,MAAyB;CACvB,wBAAgB,IAAI,KAAyB;CAC7C;CAEA,YAAY,aAAa,KAAQ;AAC/B,OAAK,aAAa;;;;;;;CAQpB,IAAI,KAAkC;EACpC,MAAM,QAAQ,KAAK,MAAM,IAAI,IAAI;AACjC,MAAI,CAAC,MACH;AAEF,MAAI,KAAK,KAAK,GAAG,MAAM,WAAW;AAChC,QAAK,MAAM,OAAO,IAAI;AACtB;;AAEF,QAAM;AACN,QAAM,aAAa,KAAK,KAAK;AAC7B,SAAO,MAAM;;;;;;;;CASf,IAAI,KAAa,OAAgB,KAAmB;AAClD,MAAI,KAAK,MAAM,QAAQ,KAAK,WAC1B,MAAK,OAAO;AAEd,OAAK,MAAM,IAAI,KAAK;GAClB;GACA,WAAW,KAAK,KAAK,GAAG;GACxB,UAAU;GACV,YAAY,KAAK,KAAK;GACvB,CAAC;;;;;;;CAQJ,IAAI,KAAsB;EACxB,MAAM,QAAQ,KAAK,MAAM,IAAI,IAAI;AACjC,MAAI,CAAC,MACH,QAAO;AAET,MAAI,KAAK,KAAK,GAAG,MAAM,WAAW;AAChC,QAAK,MAAM,OAAO,IAAI;AACtB,UAAO;;AAET,SAAO;;;;;;CAOT,OAAO,KAAmB;AACxB,OAAK,MAAM,OAAO,IAAI;;;;;;CAOxB,mBAAmB,QAAsB;AACvC,OAAK,MAAM,OAAO,KAAK,MAAM,MAAM,CACjC,KAAI,IAAI,WAAW,OAAO,CACxB,MAAK,MAAM,OAAO,IAAI;;;;;CAQ5B,QAAc;AACZ,OAAK,MAAM,OAAO;;;;;;CAOpB,IAAI,OAAe;AACjB,SAAO,KAAK,MAAM;;;;;;;CAQpB,YAAY,KAAqB;AAC/B,SAAO,KAAK,MAAM,IAAI,IAAI,EAAE,YAAY;;;;;;;;CAS1C,UAAU,KAAa,SAAiB,QAAsB;EAC5D,MAAM,QAAQ,KAAK,MAAM,IAAI,IAAI;AACjC,MAAI,CAAC,MACH;EAEF,MAAM,cAAc,KAAK,IAAI,QAAQ,WAAW,IAAI,KAAK,KAAK,MAAM,WAAW,EAAE,EAAE;AACnF,QAAM,YAAY,KAAK,KAAK,GAAG;;CAGjC,QAAsB;EACpB,IAAI,YAA2B;EAC/B,IAAI,eAAe,OAAO;AAC1B,OAAK,MAAM,CAAC,KAAK,UAAU,KAAK,OAAO;AACrC,OAAI,KAAK,KAAK,GAAG,MAAM,WAAW;AAChC,SAAK,MAAM,OAAO,IAAI;AACtB;;AAEF,OAAI,MAAM,aAAa,cAAc;AACnC,mBAAe,MAAM;AACrB,gBAAY;;;AAGhB,MAAI,UACF,MAAK,MAAM,OAAO,UAAU"}