@devbro/neko-cache 0.1.0

package/README.md

@@ -0,0 +1,31 @@
+# @devbro/neko-scheduler
+
+customizable cron/scheduling solution with support for context.
+
+```ts
+import { Scheduler } from '@devbro/neko-scheduler';
+
+const scheduler = new Scheduler();
+
+//if you want to add a wrapper around all your schedules.
+scheduler.setContextWrapper(async (tickFunction: Function) => {
+  // ???
+  await tickFunction();
+  // ???
+});
+
+scheduler.setErrorHandler((err: any) => {
+  console.log('scheduler error', err);
+});
+
+scheduler
+  .call(() => {
+    console.log('Hello World');
+  })
+  .setName('test1')
+  .setCronTime('*/5 * * * *')
+  .setTimezone('UTC');
+
+scheduler.start();
+scheduler.stop();
+```

package/dist/CacheProviderInterface.d.mts

@@ -0,0 +1,10 @@
+import { JSONValue, JSONObject } from '@devbro/neko-helper';
+
+interface CacheProviderInterface {
+    get(key: string): Promise<JSONValue | JSONObject | undefined>;
+    put(key: string, value: JSONObject | JSONValue, ttl?: number): Promise<void>;
+    delete(key: string): Promise<void>;
+    has(key: string): Promise<boolean>;
+}
+
+export type { CacheProviderInterface };

package/dist/CacheProviderInterface.mjs

@@ -0,0 +1 @@
+//# sourceMappingURL=CacheProviderInterface.mjs.map

package/dist/CacheProviderInterface.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/cache.d.mts

@@ -0,0 +1,17 @@
+import { CacheProviderInterface } from './CacheProviderInterface.mjs';
+import '@devbro/neko-helper';
+
+type cacheOptions = {
+    ttl?: number;
+};
+declare class Cache {
+    private provider;
+    constructor(provider: CacheProviderInterface);
+    get<T>(key: string): Promise<T | undefined>;
+    put(key: string, value: any, ttl?: number): Promise<void>;
+    delete(key: string): Promise<void>;
+    has(key: string): Promise<boolean>;
+    remember<T>(key: string, callback: () => Promise<T>, options?: cacheOptions): Promise<T>;
+}
+
+export { Cache, type cacheOptions };

package/dist/cache.mjs

@@ -0,0 +1,37 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class Cache {
+  static {
+    __name(this, "Cache");
+  }
+  provider;
+  constructor(provider) {
+    this.provider = provider;
+  }
+  async get(key) {
+    return this.provider.get(key);
+  }
+  async put(key, value, ttl) {
+    return this.provider.put(key, value, ttl);
+  }
+  async delete(key) {
+    return this.provider.delete(key);
+  }
+  async has(key) {
+    return this.provider.has(key);
+  }
+  async remember(key, callback, options = {}) {
+    options.ttl = options.ttl ?? 3600;
+    const cached = await this.get(key);
+    if (cached) {
+      return cached;
+    }
+    const result = await callback();
+    await this.put(key, result, options.ttl);
+    return result;
+  }
+}
+export {
+  Cache
+};
+//# sourceMappingURL=cache.mjs.map

package/dist/cache.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cache.ts"],"sourcesContent":["import { CacheProviderInterface } from './CacheProviderInterface.mjs';\n\nexport type cacheOptions = {\n  ttl?: number;\n};\n\nexport class Cache {\n  constructor(private provider: CacheProviderInterface) {}\n\n  async get<T>(key: string): Promise<T | undefined> {\n    return this.provider.get(key) as Promise<T | undefined>;\n  }\n\n  async put(key: string, value: any, ttl?: number): Promise<void> {\n    return this.provider.put(key, value, ttl);\n  }\n\n  async delete(key: string): Promise<void> {\n    return this.provider.delete(key);\n  }\n\n  async has(key: string): Promise<boolean> {\n    return this.provider.has(key);\n  }\n\n  async remember<T>(\n    key: string,\n    callback: () => Promise<T>,\n    options: cacheOptions = {}\n  ): Promise<T> {\n    options.ttl = options.ttl ?? 3600; // default TTL 1 hour\n\n    const cached = await this.get<T>(key);\n    if (cached) {\n      return cached;\n    }\n\n    const result = await callback();\n    await this.put(key, result, options.ttl);\n    return result;\n  }\n}\n"],"mappings":";;AAMO,MAAMA,MAAAA;EAAb,OAAaA;;;;EACX,YAAoBC,UAAkC;SAAlCA,WAAAA;EAAmC;EAEvD,MAAMC,IAAOC,KAAqC;AAChD,WAAO,KAAKF,SAASC,IAAIC,GAAAA;EAC3B;EAEA,MAAMC,IAAID,KAAaE,OAAYC,KAA6B;AAC9D,WAAO,KAAKL,SAASG,IAAID,KAAKE,OAAOC,GAAAA;EACvC;EAEA,MAAMC,OAAOJ,KAA4B;AACvC,WAAO,KAAKF,SAASM,OAAOJ,GAAAA;EAC9B;EAEA,MAAMK,IAAIL,KAA+B;AACvC,WAAO,KAAKF,SAASO,IAAIL,GAAAA;EAC3B;EAEA,MAAMM,SACJN,KACAO,UACAC,UAAwB,CAAC,GACb;AACZA,YAAQL,MAAMK,QAAQL,OAAO;AAE7B,UAAMM,SAAS,MAAM,KAAKV,IAAOC,GAAAA;AACjC,QAAIS,QAAQ;AACV,aAAOA;IACT;AAEA,UAAMC,SAAS,MAAMH,SAAAA;AACrB,UAAM,KAAKN,IAAID,KAAKU,QAAQF,QAAQL,GAAG;AACvC,WAAOO;EACT;AACF;","names":["Cache","provider","get","key","put","value","ttl","delete","has","remember","callback","options","cached","result"]}

package/dist/index.d.mts

@@ -0,0 +1,10 @@
+export { Cache, cacheOptions } from './cache.mjs';
+export { CacheProviderInterface } from './CacheProviderInterface.mjs';
+export { RedisCacheProvider } from './providers/RedisCacheProvider.mjs';
+export { FileCacheConfig, FileCacheProvider } from './providers/FileCacheProvider.mjs';
+export { MemoryCacheConfig, MemoryCacheProvider } from './providers/MemoryCacheProvider.mjs';
+export { MemcacheCacheProvider, MemcachedConfig } from './providers/MemcacheCacheProvider.mjs';
+export { DisabledCacheProvider } from './providers/DisabledCacheProvider.mjs';
+import '@devbro/neko-helper';
+import 'redis';
+import 'memcached';

package/dist/index.js

@@ -0,0 +1,424 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  Cache: () => Cache,
+  DisabledCacheProvider: () => DisabledCacheProvider,
+  FileCacheProvider: () => FileCacheProvider,
+  MemcacheCacheProvider: () => MemcacheCacheProvider,
+  MemoryCacheProvider: () => MemoryCacheProvider,
+  RedisCacheProvider: () => RedisCacheProvider
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/cache.ts
+var Cache = class {
+  static {
+    __name(this, "Cache");
+  }
+  provider;
+  constructor(provider) {
+    this.provider = provider;
+  }
+  async get(key) {
+    return this.provider.get(key);
+  }
+  async put(key, value, ttl) {
+    return this.provider.put(key, value, ttl);
+  }
+  async delete(key) {
+    return this.provider.delete(key);
+  }
+  async has(key) {
+    return this.provider.has(key);
+  }
+  async remember(key, callback, options = {}) {
+    options.ttl = options.ttl ?? 3600;
+    const cached = await this.get(key);
+    if (cached) {
+      return cached;
+    }
+    const result = await callback();
+    await this.put(key, result, options.ttl);
+    return result;
+  }
+};
+
+// src/providers/RedisCacheProvider.mts
+var import_redis = require("redis");
+var RedisCacheProvider = class {
+  // default TTL in seconds
+  constructor(config) {
+    this.config = config;
+    this.client = this.createRedisClient();
+    this.client.connect();
+  }
+  static {
+    __name(this, "RedisCacheProvider");
+  }
+  client;
+  defaultTTL = 3600;
+  createRedisClient() {
+    let rc = (0, import_redis.createClient)(this.config);
+    return rc;
+  }
+  async ensureConnection() {
+    if (!this.client.isOpen) {
+      await this.client.connect();
+    }
+  }
+  async get(key) {
+    await this.ensureConnection();
+    let rc = this.client.get(key);
+    return rc.then((value) => {
+      if (value === null || value === void 0) {
+        return void 0;
+      }
+      return JSON.parse(value);
+    });
+  }
+  async put(key, value, ttl) {
+    await this.ensureConnection();
+    const serializedValue = JSON.stringify(value);
+    ttl = ttl ?? this.defaultTTL;
+    if (ttl && ttl > 0) {
+      await this.client.setEx(key, ttl, serializedValue);
+    } else {
+      await this.client.set(key, serializedValue);
+    }
+  }
+  async delete(key) {
+    await this.ensureConnection();
+    await this.client.del(key);
+  }
+  async has(key) {
+    await this.ensureConnection();
+    const result = await this.client.exists(key);
+    return result === 1;
+  }
+};
+
+// src/providers/FileCacheProvider.mts
+var fs = __toESM(require("fs/promises"), 1);
+var path = __toESM(require("path"), 1);
+var FileCacheProvider = class {
+  static {
+    __name(this, "FileCacheProvider");
+  }
+  config = {
+    cacheDirectory: path.join(process.cwd(), "cache"),
+    defaultTTL: 3600 * 1e3,
+    cleanupInterval: 300 * 1e3
+  };
+  cleanupTimer;
+  constructor(config = {}) {
+    this.config = { ...this.config, ...config };
+    this.ensureCacheDirectory();
+    this.startCleanupTimer();
+  }
+  async ensureCacheDirectory() {
+    try {
+      await fs.access(this.config.cacheDirectory);
+    } catch {
+      await fs.mkdir(this.config.cacheDirectory, { recursive: true });
+    }
+  }
+  startCleanupTimer() {
+    if (this.config.cleanupInterval > 0) {
+      this.cleanupTimer = setInterval(() => {
+        this.cleanupExpiredEntries().catch(console.error);
+      }, this.config.cleanupInterval);
+    }
+  }
+  stopCleanupTimer() {
+    if (this.cleanupTimer) {
+      clearInterval(this.cleanupTimer);
+      this.cleanupTimer = void 0;
+    }
+  }
+  getFilePath(key) {
+    const safeKey = key.replace(/[^a-z0-9]/gi, "_");
+    return path.join(this.config.cacheDirectory, `${safeKey}.json`);
+  }
+  async cleanupExpiredEntries() {
+    try {
+      const files = await fs.readdir(this.config.cacheDirectory);
+      const now = Date.now();
+      for (const file of files) {
+        if (file.endsWith(".json")) {
+          const filePath = path.join(this.config.cacheDirectory, file);
+          try {
+            const content = await fs.readFile(filePath, "utf-8");
+            const item = JSON.parse(content);
+            if (item.expiresAt && item.expiresAt < now) {
+              await fs.unlink(filePath);
+            }
+          } catch {
+            await fs.unlink(filePath).catch(() => {
+            });
+          }
+        }
+      }
+    } catch (error) {
+    }
+  }
+  async get(key) {
+    const filePath = this.getFilePath(key);
+    try {
+      const content = await fs.readFile(filePath, "utf-8");
+      const item = JSON.parse(content);
+      if (item.expiresAt && item.expiresAt < Date.now()) {
+        await fs.unlink(filePath).catch(() => {
+        });
+        return void 0;
+      }
+      return item.value;
+    } catch (error) {
+      return void 0;
+    }
+  }
+  async put(key, value, ttl) {
+    const filePath = this.getFilePath(key);
+    const now = Date.now();
+    const effectiveTTL = ttl ?? this.config.defaultTTL;
+    const item = {
+      value,
+      createdAt: now,
+      expiresAt: effectiveTTL > 0 ? now + effectiveTTL * 1e3 : void 0
+    };
+    await fs.writeFile(filePath, JSON.stringify(item), "utf-8");
+  }
+  async delete(key) {
+    const filePath = this.getFilePath(key);
+    try {
+      await fs.unlink(filePath);
+    } catch {
+    }
+  }
+  async has(key) {
+    const value = await this.get(key);
+    return value !== void 0;
+  }
+};
+
+// src/providers/MemoryCacheProvider.mts
+var MemoryCacheProvider = class {
+  static {
+    __name(this, "MemoryCacheProvider");
+  }
+  cache = /* @__PURE__ */ new Map();
+  config = {
+    maxSize: 1e3,
+    defaultTTL: 3600,
+    cleanupInterval: 600
+    // 10 minutes
+  };
+  cleanupTimer;
+  constructor(config = {}) {
+    this.config = { ...this.config, ...config };
+    this.startCleanupTimer();
+  }
+  startCleanupTimer() {
+    if (this.config.cleanupInterval > 0) {
+      this.cleanupTimer = setInterval(() => {
+        this.cleanupExpiredEntries();
+      }, this.config.cleanupInterval * 1e3);
+    }
+  }
+  stopCleanupTimer() {
+    if (this.cleanupTimer) {
+      clearInterval(this.cleanupTimer);
+      this.cleanupTimer = void 0;
+    }
+  }
+  cleanupExpiredEntries() {
+    const now = Date.now();
+    for (const [key, item] of this.cache.entries()) {
+      if (item.expiresAt && item.expiresAt < now) {
+        this.cache.delete(key);
+      }
+    }
+  }
+  evictLRU() {
+    if (this.cache.size <= this.config.maxSize) {
+      return;
+    }
+    let oldestKey = null;
+    let oldestTime = Date.now();
+    for (const [key, item] of this.cache.entries()) {
+      if (item.lastAccessed < oldestTime) {
+        oldestTime = item.lastAccessed;
+        oldestKey = key;
+      }
+    }
+    if (oldestKey) {
+      this.cache.delete(oldestKey);
+    }
+  }
+  async get(key) {
+    const item = this.cache.get(key);
+    if (!item) {
+      return void 0;
+    }
+    if (item.expiresAt && item.expiresAt < Date.now()) {
+      this.cache.delete(key);
+      return void 0;
+    }
+    item.lastAccessed = Date.now();
+    return item.value;
+  }
+  async put(key, value, ttl) {
+    const now = Date.now();
+    const effectiveTTL = ttl ?? this.config.defaultTTL;
+    const item = {
+      value,
+      createdAt: now,
+      lastAccessed: now,
+      expiresAt: effectiveTTL > 0 ? now + effectiveTTL * 1e3 : void 0
+    };
+    this.cache.set(key, item);
+    this.evictLRU();
+  }
+  async delete(key) {
+    this.cache.delete(key);
+  }
+  async has(key) {
+    const item = this.cache.get(key);
+    if (!item) {
+      return false;
+    }
+    if (item.expiresAt && item.expiresAt < Date.now()) {
+      this.cache.delete(key);
+      return false;
+    }
+    return true;
+  }
+};
+
+// src/providers/MemcacheCacheProvider.mts
+var import_memcached = __toESM(require("memcached"), 1);
+var MemcacheCacheProvider = class {
+  // default TTL in seconds
+  constructor(config = {}) {
+    this.config = config;
+    this.client = new import_memcached.default(config.location || "localhost:11211", config.options || {});
+  }
+  static {
+    __name(this, "MemcacheCacheProvider");
+  }
+  client;
+  defaultTTL = 3600;
+  async get(key) {
+    return new Promise((resolve, reject) => {
+      this.client.get(key, (err, data) => {
+        if (err) {
+          reject(err);
+          return;
+        }
+        if (data === void 0 || data === null) {
+          resolve(void 0);
+          return;
+        }
+        try {
+          resolve(typeof data === "string" ? JSON.parse(data) : data);
+        } catch (parseErr) {
+          resolve(data);
+        }
+      });
+    });
+  }
+  async put(key, value, ttl) {
+    return new Promise((resolve, reject) => {
+      const serializedValue = JSON.stringify(value);
+      const finalTTL = ttl ?? this.defaultTTL;
+      this.client.set(key, serializedValue, finalTTL, (err) => {
+        if (err) {
+          reject(err);
+          return;
+        }
+        resolve();
+      });
+    });
+  }
+  async delete(key) {
+    return new Promise((resolve, reject) => {
+      this.client.del(key, (err) => {
+        if (err) {
+          reject(err);
+          return;
+        }
+        resolve();
+      });
+    });
+  }
+  async has(key) {
+    return new Promise((resolve, reject) => {
+      this.client.get(key, (err, data) => {
+        if (err) {
+          reject(err);
+          return;
+        }
+        resolve(data !== void 0 && data !== null);
+      });
+    });
+  }
+};
+
+// src/providers/DisabledCacheProvider.mts
+var DisabledCacheProvider = class {
+  constructor(config = {}) {
+    this.config = config;
+  }
+  static {
+    __name(this, "DisabledCacheProvider");
+  }
+  async get(key) {
+    return void 0;
+  }
+  async put(key, value, ttl) {
+  }
+  async delete(key) {
+  }
+  async has(key) {
+    return false;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Cache,
+  DisabledCacheProvider,
+  FileCacheProvider,
+  MemcacheCacheProvider,
+  MemoryCacheProvider,
+  RedisCacheProvider
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/cache.ts","../src/providers/RedisCacheProvider.mts","../src/providers/FileCacheProvider.mts","../src/providers/MemoryCacheProvider.mts","../src/providers/MemcacheCacheProvider.mts","../src/providers/DisabledCacheProvider.mts"],"sourcesContent":["export * from './cache';\nexport * from './CacheProviderInterface.mjs';\nexport * from './providers/index.mjs';\n","import { CacheProviderInterface } from './CacheProviderInterface.mjs';\n\nexport type cacheOptions = {\n  ttl?: number;\n};\n\nexport class Cache {\n  constructor(private provider: CacheProviderInterface) {}\n\n  async get<T>(key: string): Promise<T | undefined> {\n    return this.provider.get(key) as Promise<T | undefined>;\n  }\n\n  async put(key: string, value: any, ttl?: number): Promise<void> {\n    return this.provider.put(key, value, ttl);\n  }\n\n  async delete(key: string): Promise<void> {\n    return this.provider.delete(key);\n  }\n\n  async has(key: string): Promise<boolean> {\n    return this.provider.has(key);\n  }\n\n  async remember<T>(\n    key: string,\n    callback: () => Promise<T>,\n    options: cacheOptions = {}\n  ): Promise<T> {\n    options.ttl = options.ttl ?? 3600; // default TTL 1 hour\n\n    const cached = await this.get<T>(key);\n    if (cached) {\n      return cached;\n    }\n\n    const result = await callback();\n    await this.put(key, result, options.ttl);\n    return result;\n  }\n}\n","import { createClient, RedisClientOptions, RedisClientType } from 'redis';\nimport { CacheProviderInterface } from '../CacheProviderInterface.mjs';\nimport { JSONValue, JSONObject } from '@devbro/neko-helper';\n\nexport class RedisCacheProvider implements CacheProviderInterface {\n  private client: RedisClientType;\n  private defaultTTL: number = 3600; // default TTL in seconds\n\n  constructor(private config: RedisClientOptions) {\n    this.client = this.createRedisClient();\n    this.client.connect();\n  }\n\n  private createRedisClient(): any {\n    let rc = createClient(this.config);\n    return rc;\n  }\n\n  private async ensureConnection(): Promise<void> {\n    if (!this.client.isOpen) {\n      await this.client.connect();\n    }\n  }\n\n  async get(key: string): Promise<JSONValue | JSONObject | undefined> {\n    await this.ensureConnection();\n    let rc = this.client.get(key);\n    return rc.then((value) => {\n      if (value === null || value === undefined) {\n        return undefined;\n      }\n      return JSON.parse(value);\n    });\n  }\n\n  async put(key: string, value: JSONValue | JSONObject, ttl?: number): Promise<void> {\n    await this.ensureConnection();\n    const serializedValue = JSON.stringify(value);\n    ttl = ttl ?? this.defaultTTL;\n    if (ttl && ttl > 0) {\n      await this.client.setEx(key, ttl, serializedValue);\n    } else {\n      await this.client.set(key, serializedValue);\n    }\n  }\n\n  async delete(key: string): Promise<void> {\n    await this.ensureConnection();\n    await this.client.del(key);\n  }\n\n  async has(key: string): Promise<boolean> {\n    await this.ensureConnection();\n    const result = await this.client.exists(key);\n    return result === 1;\n  }\n}\n","import * as fs from 'fs/promises';\nimport * as path from 'path';\nimport { CacheProviderInterface } from '../CacheProviderInterface.mjs';\nimport { JSONObject, JSONValue } from '@devbro/neko-helper';\n\nexport interface FileCacheConfig {\n  cacheDirectory?: string;\n  defaultTTL?: number;\n  cleanupInterval?: number;\n}\n\ninterface CacheItem {\n  value: any;\n  expiresAt?: number;\n  createdAt: number;\n}\n\nexport class FileCacheProvider implements CacheProviderInterface {\n  private config: FileCacheConfig = {\n    cacheDirectory: path.join(process.cwd(), 'cache'),\n    defaultTTL: 3600 * 1000,\n    cleanupInterval: 300 * 1000,\n  };\n\n  private cleanupTimer?: NodeJS.Timeout;\n\n  constructor(config: FileCacheConfig = {}) {\n    this.config = { ...this.config, ...config };\n\n    this.ensureCacheDirectory();\n    this.startCleanupTimer();\n  }\n\n  private async ensureCacheDirectory(): Promise<void> {\n    try {\n      await fs.access(this.config.cacheDirectory!);\n    } catch {\n      await fs.mkdir(this.config.cacheDirectory!, { recursive: true });\n    }\n  }\n\n  private startCleanupTimer(): void {\n    if (this.config.cleanupInterval! > 0) {\n      this.cleanupTimer = setInterval(() => {\n        this.cleanupExpiredEntries().catch(console.error);\n      }, this.config.cleanupInterval!);\n    }\n  }\n\n  private stopCleanupTimer(): void {\n    if (this.cleanupTimer) {\n      clearInterval(this.cleanupTimer);\n      this.cleanupTimer = undefined;\n    }\n  }\n\n  private getFilePath(key: string): string {\n    // Create a safe filename from the key\n    const safeKey = key.replace(/[^a-z0-9]/gi, '_');\n    return path.join(this.config.cacheDirectory!, `${safeKey}.json`);\n  }\n\n  private async cleanupExpiredEntries(): Promise<void> {\n    try {\n      const files = await fs.readdir(this.config.cacheDirectory!);\n      const now = Date.now();\n\n      for (const file of files) {\n        if (file.endsWith('.json')) {\n          const filePath = path.join(this.config.cacheDirectory!, file);\n          try {\n            const content = await fs.readFile(filePath, 'utf-8');\n            const item: CacheItem = JSON.parse(content);\n\n            if (item.expiresAt && item.expiresAt < now) {\n              await fs.unlink(filePath);\n            }\n          } catch {\n            // If file is corrupted, delete it\n            await fs.unlink(filePath).catch(() => {});\n          }\n        }\n      }\n    } catch (error) {\n      // Ignore cleanup errors\n    }\n  }\n\n  async get(key: string): Promise<JSONObject | JSONValue | undefined> {\n    const filePath = this.getFilePath(key);\n\n    try {\n      const content = await fs.readFile(filePath, 'utf-8');\n      const item: CacheItem = JSON.parse(content);\n\n      // Check if item has expired\n      if (item.expiresAt && item.expiresAt < Date.now()) {\n        await fs.unlink(filePath).catch(() => {});\n        return undefined;\n      }\n\n      return item.value;\n    } catch (error) {\n      return undefined;\n    }\n  }\n\n  async put(key: string, value: JSONObject | JSONValue, ttl?: number): Promise<void> {\n    const filePath = this.getFilePath(key);\n    const now = Date.now();\n    const effectiveTTL = ttl ?? this.config.defaultTTL!;\n\n    const item: CacheItem = {\n      value,\n      createdAt: now,\n      expiresAt: effectiveTTL > 0 ? now + effectiveTTL * 1000 : undefined,\n    };\n\n    await fs.writeFile(filePath, JSON.stringify(item), 'utf-8');\n  }\n\n  async delete(key: string): Promise<void> {\n    const filePath = this.getFilePath(key);\n\n    try {\n      await fs.unlink(filePath);\n    } catch {\n      // File doesn't exist, that's fine\n    }\n  }\n\n  async has(key: string): Promise<boolean> {\n    const value = await this.get(key);\n    return value !== undefined;\n  }\n}\n","import { JSONObject, JSONValue } from '@devbro/neko-helper';\nimport { CacheProviderInterface } from '../CacheProviderInterface.mjs';\n\nexport interface MemoryCacheConfig {\n  maxSize?: number;\n  defaultTTL?: number;\n  cleanupInterval?: number;\n}\n\ninterface CacheItem {\n  value: any;\n  expiresAt?: number;\n  createdAt: number;\n  lastAccessed: number;\n}\n\nexport class MemoryCacheProvider implements CacheProviderInterface {\n  private cache = new Map<string, CacheItem>();\n  private config: MemoryCacheConfig = {\n    maxSize: 1000,\n    defaultTTL: 3600,\n    cleanupInterval: 600, // 10 minutes\n  };\n\n  private cleanupTimer?: NodeJS.Timeout;\n\n  constructor(config: MemoryCacheConfig = {}) {\n    this.config = { ...this.config, ...config };\n\n    this.startCleanupTimer();\n  }\n\n  private startCleanupTimer(): void {\n    if (this.config.cleanupInterval! > 0) {\n      this.cleanupTimer = setInterval(() => {\n        this.cleanupExpiredEntries();\n      }, this.config.cleanupInterval! * 1000);\n    }\n  }\n\n  private stopCleanupTimer(): void {\n    if (this.cleanupTimer) {\n      clearInterval(this.cleanupTimer);\n      this.cleanupTimer = undefined;\n    }\n  }\n\n  private cleanupExpiredEntries(): void {\n    const now = Date.now();\n\n    for (const [key, item] of this.cache.entries()) {\n      if (item.expiresAt && item.expiresAt < now) {\n        this.cache.delete(key);\n      }\n    }\n  }\n\n  private evictLRU(): void {\n    if (this.cache.size <= this.config.maxSize!) {\n      return;\n    }\n\n    // Find the least recently accessed item\n    let oldestKey: string | null = null;\n    let oldestTime = Date.now();\n\n    for (const [key, item] of this.cache.entries()) {\n      if (item.lastAccessed < oldestTime) {\n        oldestTime = item.lastAccessed;\n        oldestKey = key;\n      }\n    }\n\n    if (oldestKey) {\n      this.cache.delete(oldestKey);\n    }\n  }\n\n  async get(key: string): Promise<JSONObject | JSONValue | undefined> {\n    const item = this.cache.get(key);\n\n    if (!item) {\n      return undefined;\n    }\n\n    // Check if item has expired\n    if (item.expiresAt && item.expiresAt < Date.now()) {\n      this.cache.delete(key);\n      return undefined;\n    }\n\n    // Update last accessed time for LRU\n    item.lastAccessed = Date.now();\n\n    return item.value;\n  }\n\n  async put(key: string, value: JSONObject | JSONValue, ttl?: number): Promise<void> {\n    const now = Date.now();\n    const effectiveTTL = ttl ?? this.config.defaultTTL!;\n\n    const item: CacheItem = {\n      value,\n      createdAt: now,\n      lastAccessed: now,\n      expiresAt: effectiveTTL > 0 ? now + effectiveTTL * 1000 : undefined,\n    };\n\n    this.cache.set(key, item);\n\n    // Evict items if we exceed maxSize\n    this.evictLRU();\n  }\n\n  async delete(key: string): Promise<void> {\n    this.cache.delete(key);\n  }\n\n  async has(key: string): Promise<boolean> {\n    const item = this.cache.get(key);\n\n    if (!item) {\n      return false;\n    }\n\n    // Check if item has expired\n    if (item.expiresAt && item.expiresAt < Date.now()) {\n      this.cache.delete(key);\n      return false;\n    }\n\n    return true;\n  }\n}\n","import { CacheProviderInterface } from \"@/CacheProviderInterface.mjs\";\nimport { JSONValue, JSONObject } from \"@devbro/neko-helper\";\nimport Memcached from \"memcached\";\n\nexport interface MemcachedConfig {\n  location?: Memcached.Location;\n  options?: Memcached.options;\n}\n\nexport class MemcacheCacheProvider implements CacheProviderInterface {\n  private client: Memcached;\n  private defaultTTL: number = 3600; // default TTL in seconds\n\n  constructor(private config: MemcachedConfig = {}) {\n    this.client = new Memcached(config.location || 'localhost:11211', config.options || {});\n  }\n\n  async get(key: string): Promise<JSONValue | JSONObject | undefined> {\n    return new Promise((resolve, reject) => {\n      this.client.get(key, (err: Error | undefined, data: any) => {\n        if (err) {\n          reject(err);\n          return;\n        }\n        \n        if (data === undefined || data === null) {\n          resolve(undefined);\n          return;\n        }\n\n        try {\n          // Memcached automatically handles JSON serialization/deserialization\n          // but we need to ensure we return the correct type\n          resolve(typeof data === 'string' ? JSON.parse(data) : data);\n        } catch (parseErr) {\n          // If parsing fails, return the raw value\n          resolve(data);\n        }\n      });\n    });\n  }\n\n  async put(key: string, value: JSONObject | JSONValue, ttl?: number): Promise<void> {\n    return new Promise((resolve, reject) => {\n      const serializedValue = JSON.stringify(value);\n      const finalTTL = ttl ?? this.defaultTTL;\n\n      this.client.set(key, serializedValue, finalTTL, (err: Error | undefined) => {\n        if (err) {\n          reject(err);\n          return;\n        }\n        resolve();\n      });\n    });\n  }\n\n  async delete(key: string): Promise<void> {\n    return new Promise((resolve, reject) => {\n      this.client.del(key, (err: Error | undefined) => {\n        if (err) {\n          reject(err);\n          return;\n        }\n        resolve();\n      });\n    });\n  }\n\n  async has(key: string): Promise<boolean> {\n    return new Promise((resolve, reject) => {\n      this.client.get(key, (err: Error | undefined, data: any) => {\n        if (err) {\n          reject(err);\n          return;\n        }\n        resolve(data !== undefined && data !== null);\n      });\n    });\n  }\n\n\n\n}","import { createClient, RedisClientOptions, RedisClientType } from 'redis';\nimport { CacheProviderInterface } from '../CacheProviderInterface.mjs';\nimport { JSONValue, JSONObject } from '@devbro/neko-helper';\n\nexport class DisabledCacheProvider implements CacheProviderInterface {\n  constructor(private config = {}) {}\n\n  async get(key: string): Promise<JSONValue | JSONObject | undefined> {\n    return undefined;\n  }\n\n  async put(key: string, value: JSONValue | JSONObject, ttl?: number): Promise<void> {}\n\n  async delete(key: string): Promise<void> {}\n\n  async has(key: string): Promise<boolean> {\n    return false;\n  }\n}\n"],"mappings":"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","names":["Cache","provider","get","key","put","value","ttl","delete","has","remember","callback","options","cached","result","Memcached"]}

package/dist/index.mjs

@@ -0,0 +1,4 @@
+export * from "./cache";
+export * from "./CacheProviderInterface.mjs";
+export * from "./providers/index.mjs";
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export * from './cache';\nexport * from './CacheProviderInterface.mjs';\nexport * from './providers/index.mjs';\n"],"mappings":"AAAA,cAAc;AACd,cAAc;AACd,cAAc;","names":[]}

package/dist/providers/DisabledCacheProvider.d.mts

@@ -0,0 +1,13 @@
+import { CacheProviderInterface } from '../CacheProviderInterface.mjs';
+import { JSONValue, JSONObject } from '@devbro/neko-helper';
+
+declare class DisabledCacheProvider implements CacheProviderInterface {
+    private config;
+    constructor(config?: {});
+    get(key: string): Promise<JSONValue | JSONObject | undefined>;
+    put(key: string, value: JSONValue | JSONObject, ttl?: number): Promise<void>;
+    delete(key: string): Promise<void>;
+    has(key: string): Promise<boolean>;
+}
+
+export { DisabledCacheProvider };

package/dist/providers/DisabledCacheProvider.mjs

@@ -0,0 +1,24 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class DisabledCacheProvider {
+  constructor(config = {}) {
+    this.config = config;
+  }
+  static {
+    __name(this, "DisabledCacheProvider");
+  }
+  async get(key) {
+    return void 0;
+  }
+  async put(key, value, ttl) {
+  }
+  async delete(key) {
+  }
+  async has(key) {
+    return false;
+  }
+}
+export {
+  DisabledCacheProvider
+};
+//# sourceMappingURL=DisabledCacheProvider.mjs.map

package/dist/providers/DisabledCacheProvider.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/providers/DisabledCacheProvider.mts"],"sourcesContent":["import { createClient, RedisClientOptions, RedisClientType } from 'redis';\nimport { CacheProviderInterface } from '../CacheProviderInterface.mjs';\nimport { JSONValue, JSONObject } from '@devbro/neko-helper';\n\nexport class DisabledCacheProvider implements CacheProviderInterface {\n  constructor(private config = {}) {}\n\n  async get(key: string): Promise<JSONValue | JSONObject | undefined> {\n    return undefined;\n  }\n\n  async put(key: string, value: JSONValue | JSONObject, ttl?: number): Promise<void> {}\n\n  async delete(key: string): Promise<void> {}\n\n  async has(key: string): Promise<boolean> {\n    return false;\n  }\n}\n"],"mappings":";;AAIO,MAAM,sBAAwD;AAAA,EACnE,YAAoB,SAAS,CAAC,GAAG;AAAb;AAAA,EAAc;AAAA,EALpC,OAIqE;AAAA;AAAA;AAAA,EAGnE,MAAM,IAAI,KAA0D;AAClE,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,IAAI,KAAa,OAA+B,KAA6B;AAAA,EAAC;AAAA,EAEpF,MAAM,OAAO,KAA4B;AAAA,EAAC;AAAA,EAE1C,MAAM,IAAI,KAA+B;AACvC,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/providers/FileCacheProvider.d.mts

@@ -0,0 +1,24 @@
+import { CacheProviderInterface } from '../CacheProviderInterface.mjs';
+import { JSONObject, JSONValue } from '@devbro/neko-helper';
+
+interface FileCacheConfig {
+    cacheDirectory?: string;
+    defaultTTL?: number;
+    cleanupInterval?: number;
+}
+declare class FileCacheProvider implements CacheProviderInterface {
+    private config;
+    private cleanupTimer?;
+    constructor(config?: FileCacheConfig);
+    private ensureCacheDirectory;
+    private startCleanupTimer;
+    private stopCleanupTimer;
+    private getFilePath;
+    private cleanupExpiredEntries;
+    get(key: string): Promise<JSONObject | JSONValue | undefined>;
+    put(key: string, value: JSONObject | JSONValue, ttl?: number): Promise<void>;
+    delete(key: string): Promise<void>;
+    has(key: string): Promise<boolean>;
+}
+
+export { type FileCacheConfig, FileCacheProvider };

package/dist/providers/FileCacheProvider.mjs

@@ -0,0 +1,107 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+import * as fs from "fs/promises";
+import * as path from "path";
+class FileCacheProvider {
+  static {
+    __name(this, "FileCacheProvider");
+  }
+  config = {
+    cacheDirectory: path.join(process.cwd(), "cache"),
+    defaultTTL: 3600 * 1e3,
+    cleanupInterval: 300 * 1e3
+  };
+  cleanupTimer;
+  constructor(config = {}) {
+    this.config = { ...this.config, ...config };
+    this.ensureCacheDirectory();
+    this.startCleanupTimer();
+  }
+  async ensureCacheDirectory() {
+    try {
+      await fs.access(this.config.cacheDirectory);
+    } catch {
+      await fs.mkdir(this.config.cacheDirectory, { recursive: true });
+    }
+  }
+  startCleanupTimer() {
+    if (this.config.cleanupInterval > 0) {
+      this.cleanupTimer = setInterval(() => {
+        this.cleanupExpiredEntries().catch(console.error);
+      }, this.config.cleanupInterval);
+    }
+  }
+  stopCleanupTimer() {
+    if (this.cleanupTimer) {
+      clearInterval(this.cleanupTimer);
+      this.cleanupTimer = void 0;
+    }
+  }
+  getFilePath(key) {
+    const safeKey = key.replace(/[^a-z0-9]/gi, "_");
+    return path.join(this.config.cacheDirectory, `${safeKey}.json`);
+  }
+  async cleanupExpiredEntries() {
+    try {
+      const files = await fs.readdir(this.config.cacheDirectory);
+      const now = Date.now();
+      for (const file of files) {
+        if (file.endsWith(".json")) {
+          const filePath = path.join(this.config.cacheDirectory, file);
+          try {
+            const content = await fs.readFile(filePath, "utf-8");
+            const item = JSON.parse(content);
+            if (item.expiresAt && item.expiresAt < now) {
+              await fs.unlink(filePath);
+            }
+          } catch {
+            await fs.unlink(filePath).catch(() => {
+            });
+          }
+        }
+      }
+    } catch (error) {
+    }
+  }
+  async get(key) {
+    const filePath = this.getFilePath(key);
+    try {
+      const content = await fs.readFile(filePath, "utf-8");
+      const item = JSON.parse(content);
+      if (item.expiresAt && item.expiresAt < Date.now()) {
+        await fs.unlink(filePath).catch(() => {
+        });
+        return void 0;
+      }
+      return item.value;
+    } catch (error) {
+      return void 0;
+    }
+  }
+  async put(key, value, ttl) {
+    const filePath = this.getFilePath(key);
+    const now = Date.now();
+    const effectiveTTL = ttl ?? this.config.defaultTTL;
+    const item = {
+      value,
+      createdAt: now,
+      expiresAt: effectiveTTL > 0 ? now + effectiveTTL * 1e3 : void 0
+    };
+    await fs.writeFile(filePath, JSON.stringify(item), "utf-8");
+  }
+  async delete(key) {
+    const filePath = this.getFilePath(key);
+    try {
+      await fs.unlink(filePath);
+    } catch {
+    }
+  }
+  async has(key) {
+    const value = await this.get(key);
+    return value !== void 0;
+  }
+}
+export {
+  FileCacheProvider
+};
+//# sourceMappingURL=FileCacheProvider.mjs.map

package/dist/providers/FileCacheProvider.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/providers/FileCacheProvider.mts"],"sourcesContent":["import * as fs from 'fs/promises';\nimport * as path from 'path';\nimport { CacheProviderInterface } from '../CacheProviderInterface.mjs';\nimport { JSONObject, JSONValue } from '@devbro/neko-helper';\n\nexport interface FileCacheConfig {\n  cacheDirectory?: string;\n  defaultTTL?: number;\n  cleanupInterval?: number;\n}\n\ninterface CacheItem {\n  value: any;\n  expiresAt?: number;\n  createdAt: number;\n}\n\nexport class FileCacheProvider implements CacheProviderInterface {\n  private config: FileCacheConfig = {\n    cacheDirectory: path.join(process.cwd(), 'cache'),\n    defaultTTL: 3600 * 1000,\n    cleanupInterval: 300 * 1000,\n  };\n\n  private cleanupTimer?: NodeJS.Timeout;\n\n  constructor(config: FileCacheConfig = {}) {\n    this.config = { ...this.config, ...config };\n\n    this.ensureCacheDirectory();\n    this.startCleanupTimer();\n  }\n\n  private async ensureCacheDirectory(): Promise<void> {\n    try {\n      await fs.access(this.config.cacheDirectory!);\n    } catch {\n      await fs.mkdir(this.config.cacheDirectory!, { recursive: true });\n    }\n  }\n\n  private startCleanupTimer(): void {\n    if (this.config.cleanupInterval! > 0) {\n      this.cleanupTimer = setInterval(() => {\n        this.cleanupExpiredEntries().catch(console.error);\n      }, this.config.cleanupInterval!);\n    }\n  }\n\n  private stopCleanupTimer(): void {\n    if (this.cleanupTimer) {\n      clearInterval(this.cleanupTimer);\n      this.cleanupTimer = undefined;\n    }\n  }\n\n  private getFilePath(key: string): string {\n    // Create a safe filename from the key\n    const safeKey = key.replace(/[^a-z0-9]/gi, '_');\n    return path.join(this.config.cacheDirectory!, `${safeKey}.json`);\n  }\n\n  private async cleanupExpiredEntries(): Promise<void> {\n    try {\n      const files = await fs.readdir(this.config.cacheDirectory!);\n      const now = Date.now();\n\n      for (const file of files) {\n        if (file.endsWith('.json')) {\n          const filePath = path.join(this.config.cacheDirectory!, file);\n          try {\n            const content = await fs.readFile(filePath, 'utf-8');\n            const item: CacheItem = JSON.parse(content);\n\n            if (item.expiresAt && item.expiresAt < now) {\n              await fs.unlink(filePath);\n            }\n          } catch {\n            // If file is corrupted, delete it\n            await fs.unlink(filePath).catch(() => {});\n          }\n        }\n      }\n    } catch (error) {\n      // Ignore cleanup errors\n    }\n  }\n\n  async get(key: string): Promise<JSONObject | JSONValue | undefined> {\n    const filePath = this.getFilePath(key);\n\n    try {\n      const content = await fs.readFile(filePath, 'utf-8');\n      const item: CacheItem = JSON.parse(content);\n\n      // Check if item has expired\n      if (item.expiresAt && item.expiresAt < Date.now()) {\n        await fs.unlink(filePath).catch(() => {});\n        return undefined;\n      }\n\n      return item.value;\n    } catch (error) {\n      return undefined;\n    }\n  }\n\n  async put(key: string, value: JSONObject | JSONValue, ttl?: number): Promise<void> {\n    const filePath = this.getFilePath(key);\n    const now = Date.now();\n    const effectiveTTL = ttl ?? this.config.defaultTTL!;\n\n    const item: CacheItem = {\n      value,\n      createdAt: now,\n      expiresAt: effectiveTTL > 0 ? now + effectiveTTL * 1000 : undefined,\n    };\n\n    await fs.writeFile(filePath, JSON.stringify(item), 'utf-8');\n  }\n\n  async delete(key: string): Promise<void> {\n    const filePath = this.getFilePath(key);\n\n    try {\n      await fs.unlink(filePath);\n    } catch {\n      // File doesn't exist, that's fine\n    }\n  }\n\n  async has(key: string): Promise<boolean> {\n    const value = await this.get(key);\n    return value !== undefined;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/providers/MemcacheCacheProvider.d.mts

@@ -0,0 +1,20 @@
+import { CacheProviderInterface } from '../CacheProviderInterface.mjs';
+import { JSONValue, JSONObject } from '@devbro/neko-helper';
+import Memcached from 'memcached';
+
+interface MemcachedConfig {
+    location?: Memcached.Location;
+    options?: Memcached.options;
+}
+declare class MemcacheCacheProvider implements CacheProviderInterface {
+    private config;
+    private client;
+    private defaultTTL;
+    constructor(config?: MemcachedConfig);
+    get(key: string): Promise<JSONValue | JSONObject | undefined>;
+    put(key: string, value: JSONObject | JSONValue, ttl?: number): Promise<void>;
+    delete(key: string): Promise<void>;
+    has(key: string): Promise<boolean>;
+}
+
+export { MemcacheCacheProvider, type MemcachedConfig };

package/dist/providers/MemcacheCacheProvider.mjs

@@ -0,0 +1,73 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+import Memcached from "memcached";
+class MemcacheCacheProvider {
+  // default TTL in seconds
+  constructor(config = {}) {
+    this.config = config;
+    this.client = new Memcached(config.location || "localhost:11211", config.options || {});
+  }
+  static {
+    __name(this, "MemcacheCacheProvider");
+  }
+  client;
+  defaultTTL = 3600;
+  async get(key) {
+    return new Promise((resolve, reject) => {
+      this.client.get(key, (err, data) => {
+        if (err) {
+          reject(err);
+          return;
+        }
+        if (data === void 0 || data === null) {
+          resolve(void 0);
+          return;
+        }
+        try {
+          resolve(typeof data === "string" ? JSON.parse(data) : data);
+        } catch (parseErr) {
+          resolve(data);
+        }
+      });
+    });
+  }
+  async put(key, value, ttl) {
+    return new Promise((resolve, reject) => {
+      const serializedValue = JSON.stringify(value);
+      const finalTTL = ttl ?? this.defaultTTL;
+      this.client.set(key, serializedValue, finalTTL, (err) => {
+        if (err) {
+          reject(err);
+          return;
+        }
+        resolve();
+      });
+    });
+  }
+  async delete(key) {
+    return new Promise((resolve, reject) => {
+      this.client.del(key, (err) => {
+        if (err) {
+          reject(err);
+          return;
+        }
+        resolve();
+      });
+    });
+  }
+  async has(key) {
+    return new Promise((resolve, reject) => {
+      this.client.get(key, (err, data) => {
+        if (err) {
+          reject(err);
+          return;
+        }
+        resolve(data !== void 0 && data !== null);
+      });
+    });
+  }
+}
+export {
+  MemcacheCacheProvider
+};
+//# sourceMappingURL=MemcacheCacheProvider.mjs.map

package/dist/providers/MemcacheCacheProvider.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/providers/MemcacheCacheProvider.mts"],"sourcesContent":["import { CacheProviderInterface } from \"@/CacheProviderInterface.mjs\";\nimport { JSONValue, JSONObject } from \"@devbro/neko-helper\";\nimport Memcached from \"memcached\";\n\nexport interface MemcachedConfig {\n  location?: Memcached.Location;\n  options?: Memcached.options;\n}\n\nexport class MemcacheCacheProvider implements CacheProviderInterface {\n  private client: Memcached;\n  private defaultTTL: number = 3600; // default TTL in seconds\n\n  constructor(private config: MemcachedConfig = {}) {\n    this.client = new Memcached(config.location || 'localhost:11211', config.options || {});\n  }\n\n  async get(key: string): Promise<JSONValue | JSONObject | undefined> {\n    return new Promise((resolve, reject) => {\n      this.client.get(key, (err: Error | undefined, data: any) => {\n        if (err) {\n          reject(err);\n          return;\n        }\n        \n        if (data === undefined || data === null) {\n          resolve(undefined);\n          return;\n        }\n\n        try {\n          // Memcached automatically handles JSON serialization/deserialization\n          // but we need to ensure we return the correct type\n          resolve(typeof data === 'string' ? JSON.parse(data) : data);\n        } catch (parseErr) {\n          // If parsing fails, return the raw value\n          resolve(data);\n        }\n      });\n    });\n  }\n\n  async put(key: string, value: JSONObject | JSONValue, ttl?: number): Promise<void> {\n    return new Promise((resolve, reject) => {\n      const serializedValue = JSON.stringify(value);\n      const finalTTL = ttl ?? this.defaultTTL;\n\n      this.client.set(key, serializedValue, finalTTL, (err: Error | undefined) => {\n        if (err) {\n          reject(err);\n          return;\n        }\n        resolve();\n      });\n    });\n  }\n\n  async delete(key: string): Promise<void> {\n    return new Promise((resolve, reject) => {\n      this.client.del(key, (err: Error | undefined) => {\n        if (err) {\n          reject(err);\n          return;\n        }\n        resolve();\n      });\n    });\n  }\n\n  async has(key: string): Promise<boolean> {\n    return new Promise((resolve, reject) => {\n      this.client.get(key, (err: Error | undefined, data: any) => {\n        if (err) {\n          reject(err);\n          return;\n        }\n        resolve(data !== undefined && data !== null);\n      });\n    });\n  }\n\n\n\n}"],"mappings":";;AAEA,OAAO,eAAe;AAOf,MAAM,sBAAwD;AAAA;AAAA,EAInE,YAAoB,SAA0B,CAAC,GAAG;AAA9B;AAClB,SAAK,SAAS,IAAI,UAAU,OAAO,YAAY,mBAAmB,OAAO,WAAW,CAAC,CAAC;AAAA,EACxF;AAAA,EAfF,OASqE;AAAA;AAAA;AAAA,EAC3D;AAAA,EACA,aAAqB;AAAA,EAM7B,MAAM,IAAI,KAA0D;AAClE,WAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,WAAK,OAAO,IAAI,KAAK,CAAC,KAAwB,SAAc;AAC1D,YAAI,KAAK;AACP,iBAAO,GAAG;AACV;AAAA,QACF;AAEA,YAAI,SAAS,UAAa,SAAS,MAAM;AACvC,kBAAQ,MAAS;AACjB;AAAA,QACF;AAEA,YAAI;AAGF,kBAAQ,OAAO,SAAS,WAAW,KAAK,MAAM,IAAI,IAAI,IAAI;AAAA,QAC5D,SAAS,UAAU;AAEjB,kBAAQ,IAAI;AAAA,QACd;AAAA,MACF,CAAC;AAAA,IACH,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,IAAI,KAAa,OAA+B,KAA6B;AACjF,WAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,YAAM,kBAAkB,KAAK,UAAU,KAAK;AAC5C,YAAM,WAAW,OAAO,KAAK;AAE7B,WAAK,OAAO,IAAI,KAAK,iBAAiB,UAAU,CAAC,QAA2B;AAC1E,YAAI,KAAK;AACP,iBAAO,GAAG;AACV;AAAA,QACF;AACA,gBAAQ;AAAA,MACV,CAAC;AAAA,IACH,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,OAAO,KAA4B;AACvC,WAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,WAAK,OAAO,IAAI,KAAK,CAAC,QAA2B;AAC/C,YAAI,KAAK;AACP,iBAAO,GAAG;AACV;AAAA,QACF;AACA,gBAAQ;AAAA,MACV,CAAC;AAAA,IACH,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,IAAI,KAA+B;AACvC,WAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,WAAK,OAAO,IAAI,KAAK,CAAC,KAAwB,SAAc;AAC1D,YAAI,KAAK;AACP,iBAAO,GAAG;AACV;AAAA,QACF;AACA,gBAAQ,SAAS,UAAa,SAAS,IAAI;AAAA,MAC7C,CAAC;AAAA,IACH,CAAC;AAAA,EACH;AAIF;","names":[]}

package/dist/providers/MemoryCacheProvider.d.mts

@@ -0,0 +1,24 @@
+import { JSONObject, JSONValue } from '@devbro/neko-helper';
+import { CacheProviderInterface } from '../CacheProviderInterface.mjs';
+
+interface MemoryCacheConfig {
+    maxSize?: number;
+    defaultTTL?: number;
+    cleanupInterval?: number;
+}
+declare class MemoryCacheProvider implements CacheProviderInterface {
+    private cache;
+    private config;
+    private cleanupTimer?;
+    constructor(config?: MemoryCacheConfig);
+    private startCleanupTimer;
+    private stopCleanupTimer;
+    private cleanupExpiredEntries;
+    private evictLRU;
+    get(key: string): Promise<JSONObject | JSONValue | undefined>;
+    put(key: string, value: JSONObject | JSONValue, ttl?: number): Promise<void>;
+    delete(key: string): Promise<void>;
+    has(key: string): Promise<boolean>;
+}
+
+export { type MemoryCacheConfig, MemoryCacheProvider };

package/dist/providers/MemoryCacheProvider.mjs

@@ -0,0 +1,98 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class MemoryCacheProvider {
+  static {
+    __name(this, "MemoryCacheProvider");
+  }
+  cache = /* @__PURE__ */ new Map();
+  config = {
+    maxSize: 1e3,
+    defaultTTL: 3600,
+    cleanupInterval: 600
+    // 10 minutes
+  };
+  cleanupTimer;
+  constructor(config = {}) {
+    this.config = { ...this.config, ...config };
+    this.startCleanupTimer();
+  }
+  startCleanupTimer() {
+    if (this.config.cleanupInterval > 0) {
+      this.cleanupTimer = setInterval(() => {
+        this.cleanupExpiredEntries();
+      }, this.config.cleanupInterval * 1e3);
+    }
+  }
+  stopCleanupTimer() {
+    if (this.cleanupTimer) {
+      clearInterval(this.cleanupTimer);
+      this.cleanupTimer = void 0;
+    }
+  }
+  cleanupExpiredEntries() {
+    const now = Date.now();
+    for (const [key, item] of this.cache.entries()) {
+      if (item.expiresAt && item.expiresAt < now) {
+        this.cache.delete(key);
+      }
+    }
+  }
+  evictLRU() {
+    if (this.cache.size <= this.config.maxSize) {
+      return;
+    }
+    let oldestKey = null;
+    let oldestTime = Date.now();
+    for (const [key, item] of this.cache.entries()) {
+      if (item.lastAccessed < oldestTime) {
+        oldestTime = item.lastAccessed;
+        oldestKey = key;
+      }
+    }
+    if (oldestKey) {
+      this.cache.delete(oldestKey);
+    }
+  }
+  async get(key) {
+    const item = this.cache.get(key);
+    if (!item) {
+      return void 0;
+    }
+    if (item.expiresAt && item.expiresAt < Date.now()) {
+      this.cache.delete(key);
+      return void 0;
+    }
+    item.lastAccessed = Date.now();
+    return item.value;
+  }
+  async put(key, value, ttl) {
+    const now = Date.now();
+    const effectiveTTL = ttl ?? this.config.defaultTTL;
+    const item = {
+      value,
+      createdAt: now,
+      lastAccessed: now,
+      expiresAt: effectiveTTL > 0 ? now + effectiveTTL * 1e3 : void 0
+    };
+    this.cache.set(key, item);
+    this.evictLRU();
+  }
+  async delete(key) {
+    this.cache.delete(key);
+  }
+  async has(key) {
+    const item = this.cache.get(key);
+    if (!item) {
+      return false;
+    }
+    if (item.expiresAt && item.expiresAt < Date.now()) {
+      this.cache.delete(key);
+      return false;
+    }
+    return true;
+  }
+}
+export {
+  MemoryCacheProvider
+};
+//# sourceMappingURL=MemoryCacheProvider.mjs.map

package/dist/providers/MemoryCacheProvider.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/providers/MemoryCacheProvider.mts"],"sourcesContent":["import { JSONObject, JSONValue } from '@devbro/neko-helper';\nimport { CacheProviderInterface } from '../CacheProviderInterface.mjs';\n\nexport interface MemoryCacheConfig {\n  maxSize?: number;\n  defaultTTL?: number;\n  cleanupInterval?: number;\n}\n\ninterface CacheItem {\n  value: any;\n  expiresAt?: number;\n  createdAt: number;\n  lastAccessed: number;\n}\n\nexport class MemoryCacheProvider implements CacheProviderInterface {\n  private cache = new Map<string, CacheItem>();\n  private config: MemoryCacheConfig = {\n    maxSize: 1000,\n    defaultTTL: 3600,\n    cleanupInterval: 600, // 10 minutes\n  };\n\n  private cleanupTimer?: NodeJS.Timeout;\n\n  constructor(config: MemoryCacheConfig = {}) {\n    this.config = { ...this.config, ...config };\n\n    this.startCleanupTimer();\n  }\n\n  private startCleanupTimer(): void {\n    if (this.config.cleanupInterval! > 0) {\n      this.cleanupTimer = setInterval(() => {\n        this.cleanupExpiredEntries();\n      }, this.config.cleanupInterval! * 1000);\n    }\n  }\n\n  private stopCleanupTimer(): void {\n    if (this.cleanupTimer) {\n      clearInterval(this.cleanupTimer);\n      this.cleanupTimer = undefined;\n    }\n  }\n\n  private cleanupExpiredEntries(): void {\n    const now = Date.now();\n\n    for (const [key, item] of this.cache.entries()) {\n      if (item.expiresAt && item.expiresAt < now) {\n        this.cache.delete(key);\n      }\n    }\n  }\n\n  private evictLRU(): void {\n    if (this.cache.size <= this.config.maxSize!) {\n      return;\n    }\n\n    // Find the least recently accessed item\n    let oldestKey: string | null = null;\n    let oldestTime = Date.now();\n\n    for (const [key, item] of this.cache.entries()) {\n      if (item.lastAccessed < oldestTime) {\n        oldestTime = item.lastAccessed;\n        oldestKey = key;\n      }\n    }\n\n    if (oldestKey) {\n      this.cache.delete(oldestKey);\n    }\n  }\n\n  async get(key: string): Promise<JSONObject | JSONValue | undefined> {\n    const item = this.cache.get(key);\n\n    if (!item) {\n      return undefined;\n    }\n\n    // Check if item has expired\n    if (item.expiresAt && item.expiresAt < Date.now()) {\n      this.cache.delete(key);\n      return undefined;\n    }\n\n    // Update last accessed time for LRU\n    item.lastAccessed = Date.now();\n\n    return item.value;\n  }\n\n  async put(key: string, value: JSONObject | JSONValue, ttl?: number): Promise<void> {\n    const now = Date.now();\n    const effectiveTTL = ttl ?? this.config.defaultTTL!;\n\n    const item: CacheItem = {\n      value,\n      createdAt: now,\n      lastAccessed: now,\n      expiresAt: effectiveTTL > 0 ? now + effectiveTTL * 1000 : undefined,\n    };\n\n    this.cache.set(key, item);\n\n    // Evict items if we exceed maxSize\n    this.evictLRU();\n  }\n\n  async delete(key: string): Promise<void> {\n    this.cache.delete(key);\n  }\n\n  async has(key: string): Promise<boolean> {\n    const item = this.cache.get(key);\n\n    if (!item) {\n      return false;\n    }\n\n    // Check if item has expired\n    if (item.expiresAt && item.expiresAt < Date.now()) {\n      this.cache.delete(key);\n      return false;\n    }\n\n    return true;\n  }\n}\n"],"mappings":";;AAgBO,MAAM,oBAAsD;AAAA,EAhBnE,OAgBmE;AAAA;AAAA;AAAA,EACzD,QAAQ,oBAAI,IAAuB;AAAA,EACnC,SAA4B;AAAA,IAClC,SAAS;AAAA,IACT,YAAY;AAAA,IACZ,iBAAiB;AAAA;AAAA,EACnB;AAAA,EAEQ;AAAA,EAER,YAAY,SAA4B,CAAC,GAAG;AAC1C,SAAK,SAAS,EAAE,GAAG,KAAK,QAAQ,GAAG,OAAO;AAE1C,SAAK,kBAAkB;AAAA,EACzB;AAAA,EAEQ,oBAA0B;AAChC,QAAI,KAAK,OAAO,kBAAmB,GAAG;AACpC,WAAK,eAAe,YAAY,MAAM;AACpC,aAAK,sBAAsB;AAAA,MAC7B,GAAG,KAAK,OAAO,kBAAmB,GAAI;AAAA,IACxC;AAAA,EACF;AAAA,EAEQ,mBAAyB;AAC/B,QAAI,KAAK,cAAc;AACrB,oBAAc,KAAK,YAAY;AAC/B,WAAK,eAAe;AAAA,IACtB;AAAA,EACF;AAAA,EAEQ,wBAA8B;AACpC,UAAM,MAAM,KAAK,IAAI;AAErB,eAAW,CAAC,KAAK,IAAI,KAAK,KAAK,MAAM,QAAQ,GAAG;AAC9C,UAAI,KAAK,aAAa,KAAK,YAAY,KAAK;AAC1C,aAAK,MAAM,OAAO,GAAG;AAAA,MACvB;AAAA,IACF;AAAA,EACF;AAAA,EAEQ,WAAiB;AACvB,QAAI,KAAK,MAAM,QAAQ,KAAK,OAAO,SAAU;AAC3C;AAAA,IACF;AAGA,QAAI,YAA2B;AAC/B,QAAI,aAAa,KAAK,IAAI;AAE1B,eAAW,CAAC,KAAK,IAAI,KAAK,KAAK,MAAM,QAAQ,GAAG;AAC9C,UAAI,KAAK,eAAe,YAAY;AAClC,qBAAa,KAAK;AAClB,oBAAY;AAAA,MACd;AAAA,IACF;AAEA,QAAI,WAAW;AACb,WAAK,MAAM,OAAO,SAAS;AAAA,IAC7B;AAAA,EACF;AAAA,EAEA,MAAM,IAAI,KAA0D;AAClE,UAAM,OAAO,KAAK,MAAM,IAAI,GAAG;AAE/B,QAAI,CAAC,MAAM;AACT,aAAO;AAAA,IACT;AAGA,QAAI,KAAK,aAAa,KAAK,YAAY,KAAK,IAAI,GAAG;AACjD,WAAK,MAAM,OAAO,GAAG;AACrB,aAAO;AAAA,IACT;AAGA,SAAK,eAAe,KAAK,IAAI;AAE7B,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,MAAM,IAAI,KAAa,OAA+B,KAA6B;AACjF,UAAM,MAAM,KAAK,IAAI;AACrB,UAAM,eAAe,OAAO,KAAK,OAAO;AAExC,UAAM,OAAkB;AAAA,MACtB;AAAA,MACA,WAAW;AAAA,MACX,cAAc;AAAA,MACd,WAAW,eAAe,IAAI,MAAM,eAAe,MAAO;AAAA,IAC5D;AAEA,SAAK,MAAM,IAAI,KAAK,IAAI;AAGxB,SAAK,SAAS;AAAA,EAChB;AAAA,EAEA,MAAM,OAAO,KAA4B;AACvC,SAAK,MAAM,OAAO,GAAG;AAAA,EACvB;AAAA,EAEA,MAAM,IAAI,KAA+B;AACvC,UAAM,OAAO,KAAK,MAAM,IAAI,GAAG;AAE/B,QAAI,CAAC,MAAM;AACT,aAAO;AAAA,IACT;AAGA,QAAI,KAAK,aAAa,KAAK,YAAY,KAAK,IAAI,GAAG;AACjD,WAAK,MAAM,OAAO,GAAG;AACrB,aAAO;AAAA,IACT;AAEA,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/providers/RedisCacheProvider.d.mts

@@ -0,0 +1,18 @@
+import { RedisClientOptions } from 'redis';
+import { CacheProviderInterface } from '../CacheProviderInterface.mjs';
+import { JSONValue, JSONObject } from '@devbro/neko-helper';
+
+declare class RedisCacheProvider implements CacheProviderInterface {
+    private config;
+    private client;
+    private defaultTTL;
+    constructor(config: RedisClientOptions);
+    private createRedisClient;
+    private ensureConnection;
+    get(key: string): Promise<JSONValue | JSONObject | undefined>;
+    put(key: string, value: JSONValue | JSONObject, ttl?: number): Promise<void>;
+    delete(key: string): Promise<void>;
+    has(key: string): Promise<boolean>;
+}
+
+export { RedisCacheProvider };

package/dist/providers/RedisCacheProvider.mjs

@@ -0,0 +1,58 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+import { createClient } from "redis";
+class RedisCacheProvider {
+  // default TTL in seconds
+  constructor(config) {
+    this.config = config;
+    this.client = this.createRedisClient();
+    this.client.connect();
+  }
+  static {
+    __name(this, "RedisCacheProvider");
+  }
+  client;
+  defaultTTL = 3600;
+  createRedisClient() {
+    let rc = createClient(this.config);
+    return rc;
+  }
+  async ensureConnection() {
+    if (!this.client.isOpen) {
+      await this.client.connect();
+    }
+  }
+  async get(key) {
+    await this.ensureConnection();
+    let rc = this.client.get(key);
+    return rc.then((value) => {
+      if (value === null || value === void 0) {
+        return void 0;
+      }
+      return JSON.parse(value);
+    });
+  }
+  async put(key, value, ttl) {
+    await this.ensureConnection();
+    const serializedValue = JSON.stringify(value);
+    ttl = ttl ?? this.defaultTTL;
+    if (ttl && ttl > 0) {
+      await this.client.setEx(key, ttl, serializedValue);
+    } else {
+      await this.client.set(key, serializedValue);
+    }
+  }
+  async delete(key) {
+    await this.ensureConnection();
+    await this.client.del(key);
+  }
+  async has(key) {
+    await this.ensureConnection();
+    const result = await this.client.exists(key);
+    return result === 1;
+  }
+}
+export {
+  RedisCacheProvider
+};
+//# sourceMappingURL=RedisCacheProvider.mjs.map

package/dist/providers/RedisCacheProvider.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/providers/RedisCacheProvider.mts"],"sourcesContent":["import { createClient, RedisClientOptions, RedisClientType } from 'redis';\nimport { CacheProviderInterface } from '../CacheProviderInterface.mjs';\nimport { JSONValue, JSONObject } from '@devbro/neko-helper';\n\nexport class RedisCacheProvider implements CacheProviderInterface {\n  private client: RedisClientType;\n  private defaultTTL: number = 3600; // default TTL in seconds\n\n  constructor(private config: RedisClientOptions) {\n    this.client = this.createRedisClient();\n    this.client.connect();\n  }\n\n  private createRedisClient(): any {\n    let rc = createClient(this.config);\n    return rc;\n  }\n\n  private async ensureConnection(): Promise<void> {\n    if (!this.client.isOpen) {\n      await this.client.connect();\n    }\n  }\n\n  async get(key: string): Promise<JSONValue | JSONObject | undefined> {\n    await this.ensureConnection();\n    let rc = this.client.get(key);\n    return rc.then((value) => {\n      if (value === null || value === undefined) {\n        return undefined;\n      }\n      return JSON.parse(value);\n    });\n  }\n\n  async put(key: string, value: JSONValue | JSONObject, ttl?: number): Promise<void> {\n    await this.ensureConnection();\n    const serializedValue = JSON.stringify(value);\n    ttl = ttl ?? this.defaultTTL;\n    if (ttl && ttl > 0) {\n      await this.client.setEx(key, ttl, serializedValue);\n    } else {\n      await this.client.set(key, serializedValue);\n    }\n  }\n\n  async delete(key: string): Promise<void> {\n    await this.ensureConnection();\n    await this.client.del(key);\n  }\n\n  async has(key: string): Promise<boolean> {\n    await this.ensureConnection();\n    const result = await this.client.exists(key);\n    return result === 1;\n  }\n}\n"],"mappings":";;AAAA,SAAS,oBAAyD;AAI3D,MAAM,mBAAqD;AAAA;AAAA,EAIhE,YAAoB,QAA4B;AAA5B;AAClB,SAAK,SAAS,KAAK,kBAAkB;AACrC,SAAK,OAAO,QAAQ;AAAA,EACtB;AAAA,EAXF,OAIkE;AAAA;AAAA;AAAA,EACxD;AAAA,EACA,aAAqB;AAAA,EAOrB,oBAAyB;AAC/B,QAAI,KAAK,aAAa,KAAK,MAAM;AACjC,WAAO;AAAA,EACT;AAAA,EAEA,MAAc,mBAAkC;AAC9C,QAAI,CAAC,KAAK,OAAO,QAAQ;AACvB,YAAM,KAAK,OAAO,QAAQ;AAAA,IAC5B;AAAA,EACF;AAAA,EAEA,MAAM,IAAI,KAA0D;AAClE,UAAM,KAAK,iBAAiB;AAC5B,QAAI,KAAK,KAAK,OAAO,IAAI,GAAG;AAC5B,WAAO,GAAG,KAAK,CAAC,UAAU;AACxB,UAAI,UAAU,QAAQ,UAAU,QAAW;AACzC,eAAO;AAAA,MACT;AACA,aAAO,KAAK,MAAM,KAAK;AAAA,IACzB,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,IAAI,KAAa,OAA+B,KAA6B;AACjF,UAAM,KAAK,iBAAiB;AAC5B,UAAM,kBAAkB,KAAK,UAAU,KAAK;AAC5C,UAAM,OAAO,KAAK;AAClB,QAAI,OAAO,MAAM,GAAG;AAClB,YAAM,KAAK,OAAO,MAAM,KAAK,KAAK,eAAe;AAAA,IACnD,OAAO;AACL,YAAM,KAAK,OAAO,IAAI,KAAK,eAAe;AAAA,IAC5C;AAAA,EACF;AAAA,EAEA,MAAM,OAAO,KAA4B;AACvC,UAAM,KAAK,iBAAiB;AAC5B,UAAM,KAAK,OAAO,IAAI,GAAG;AAAA,EAC3B;AAAA,EAEA,MAAM,IAAI,KAA+B;AACvC,UAAM,KAAK,iBAAiB;AAC5B,UAAM,SAAS,MAAM,KAAK,OAAO,OAAO,GAAG;AAC3C,WAAO,WAAW;AAAA,EACpB;AACF;","names":[]}

package/dist/providers/index.d.mts

@@ -0,0 +1,9 @@
+export { RedisCacheProvider } from './RedisCacheProvider.mjs';
+export { FileCacheConfig, FileCacheProvider } from './FileCacheProvider.mjs';
+export { MemoryCacheConfig, MemoryCacheProvider } from './MemoryCacheProvider.mjs';
+export { MemcacheCacheProvider, MemcachedConfig } from './MemcacheCacheProvider.mjs';
+export { DisabledCacheProvider } from './DisabledCacheProvider.mjs';
+import 'redis';
+import '../CacheProviderInterface.mjs';
+import '@devbro/neko-helper';
+import 'memcached';

package/dist/providers/index.mjs

@@ -0,0 +1,6 @@
+export * from "./RedisCacheProvider.mjs";
+export * from "./FileCacheProvider.mjs";
+export * from "./MemoryCacheProvider.mjs";
+export * from "./MemcacheCacheProvider.mjs";
+export * from "./DisabledCacheProvider.mjs";
+//# sourceMappingURL=index.mjs.map

package/dist/providers/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/providers/index.mts"],"sourcesContent":["export * from './RedisCacheProvider.mjs';\nexport * from './FileCacheProvider.mjs';\nexport * from './MemoryCacheProvider.mjs';\nexport * from './MemcacheCacheProvider.mjs';\nexport * from './DisabledCacheProvider.mjs';\n"],"mappings":"AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;","names":[]}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@devbro/neko-cache",
+  "version": "0.1.0",
+  "description": "driver agnostic caching implementation",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest watch",
+    "test:coverage": "vitest run --coverage",
+    "format": "eslint . --fix --ext ts,tsx --report-unused-disable-directives --max-warnings 0 ",
+    "prepare": "husky",
+    "prettier": "prettier --write .",
+    "clean": "rm -rf dist"
+  },
+  "author": "Farzad Meow Khalafi",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/memcached": "^2.2.10",
+    "@types/node": "^22.14.1",
+    "@typescript-eslint/eslint-plugin": "^7.1.1",
+    "@typescript-eslint/parser": "^7.1.1",
+    "eslint": "8.57.0",
+    "husky": "^9.1.7",
+    "prettier": "^3.5.3",
+    "tsup": "^8.0.2",
+    "typescript": "^5.3.3",
+    "vitest": "^3.2.4"
+  },
+  "dependencies": {
+    "@devbro/neko-helper": "0.1.*",
+    "memcached": "^2.2.2",
+    "redis": "^4.6.0"
+  },
+  "directories": {
+    "doc": "docs",
+    "test": "tests"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/devbro1/pashmak.git"
+  },
+  "keywords": [
+    "pashmak"
+  ],
+  "bugs": {
+    "url": "https://github.com/devbro1/pashmak/issues"
+  },
+  "homepage": "https://devbro1.github.io/pashmak/",
+  "tags": {
+    "needsCompile": true,
+    "canPublishToNpm": true
+  }
+}