@daiso-tech/core 0.26.1 → 0.28.0

package/dist/cache/implementations/adapters/redis-cache-adapter/redis-cache-adapter-serde.js

@@ -0,0 +1,39 @@
+/**
+ * @module Serde
+ */
+import { DeserializationError, SerializationError, } from "../../../../serde/contracts/_module-exports.js";
+/**
+ * @internal
+ */
+export class RedisCacheAdapterSerde {
+    serde;
+    constructor(serde) {
+        this.serde = serde;
+    }
+    serialize(value) {
+        try {
+            if (typeof value === "number" &&
+                !Number.isNaN(value) &&
+                isFinite(value)) {
+                return String(value);
+            }
+            return this.serde.serialize(value);
+        }
+        catch (error) {
+            throw new SerializationError(`Serialization error "${String(error)}" occured`, error);
+        }
+    }
+    deserialize(value) {
+        try {
+            const isNumberRegex = /^(-?([0-9]+)(\.[0-5]+)?)$/g;
+            if (isNumberRegex.test(value)) {
+                return Number(value);
+            }
+            return this.serde.deserialize(value);
+        }
+        catch (error) {
+            throw new DeserializationError(`Deserialization error "${String(error)}" occured`, error);
+        }
+    }
+}
+//# sourceMappingURL=redis-cache-adapter-serde.js.map

package/dist/cache/implementations/adapters/redis-cache-adapter/redis-cache-adapter-serde.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-cache-adapter-serde.js","sourceRoot":"","sources":["../../../../../src/cache/implementations/adapters/redis-cache-adapter/redis-cache-adapter-serde.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAEH,oBAAoB,EACpB,kBAAkB,GACrB,MAAM,sCAAsC,CAAC;AAE9C;;GAEG;AACH,MAAM,OAAO,sBAAsB;IACF;IAA7B,YAA6B,KAAqB;QAArB,UAAK,GAAL,KAAK,CAAgB;IAAG,CAAC;IAEtD,SAAS,CAAS,KAAa;QAC3B,IAAI,CAAC;YACD,IACI,OAAO,KAAK,KAAK,QAAQ;gBACzB,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC;gBACpB,QAAQ,CAAC,KAAK,CAAC,EACjB,CAAC;gBACC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;YACzB,CAAC;YACD,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACtB,MAAM,IAAI,kBAAkB,CACxB,wBAAwB,MAAM,CAAC,KAAK,CAAC,WAAW,EAChD,KAAK,CACR,CAAC;QACN,CAAC;IACL,CAAC;IAED,WAAW,CAAS,KAAa;QAC7B,IAAI,CAAC;YACD,MAAM,aAAa,GAAG,4BAA4B,CAAC;YACnD,IAAI,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC5B,OAAO,MAAM,CAAC,KAAK,CAAW,CAAC;YACnC,CAAC;YACD,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACzC,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACtB,MAAM,IAAI,oBAAoB,CAC1B,0BAA0B,MAAM,CAAC,KAAK,CAAC,WAAW,EAClD,KAAK,CACR,CAAC;QACN,CAAC;IACL,CAAC;CACJ"}

package/dist/cache/implementations/adapters/redis-cache-adapter/redis-cache-adapter.d.ts

@@ -1,10 +1,10 @@
 /**
  * @module Cache
  */
-import { type ICacheAdapter } from "../../../../cache/contracts/cache-adapter.contract.js";
-import { type TimeSpan } from "../../../../utilities/_module-exports.js";
-import { type Redis, type Result } from "ioredis";
+import { type ICacheAdapter } from "../../../../cache/contracts/_module-exports.js";
 import type { ISerde } from "../../../../serde/contracts/_module-exports.js";
+import type { TimeSpan } from "../../../../utilities/_module-exports.js";
+import { type Redis, type Result } from "ioredis";
 declare module "ioredis" {
     interface RedisCommander<Context> {
         daiso_cache_increment(key: string, number: string): Result<number, Context>;
@@ -12,32 +12,29 @@ declare module "ioredis" {
 }
 /**
  *
- * IMPORT_PATH: ```"@daiso-tech/core/cache/implementations/adapters"```
+ * IMPORT_PATH: ```"@daiso-tech/core/cache/adapters"```
  * @group Adapters
  */
 export type RedisCacheAdapterSettings = {
     database: Redis;
     serde: ISerde<string>;
-    rootGroup: string;
 };
 /**
  * To utilize the <i>RedisCacheAdapter</i>, you must install the <i>"ioredis"</i> package and supply a <i>{@link ISerde | ISerde<string> }</i>, with adapter like <i>{@link SuperJsonSerdeAdapter}</i>.
  *
- * IMPORT_PATH: ```"@daiso-tech/core/cache/implementations/adapters"```
+ * IMPORT_PATH: ```"@daiso-tech/core/cache/adapters"```
  * @group Adapters
  */
-export declare class RedisCacheAdapter<TType = unknown> implements ICacheAdapter<TType> {
+export declare class RedisCacheAdapter<TType> implements ICacheAdapter<TType> {
     private static isRedisTypeError;
-    private readonly baseSerde;
-    private readonly redisSerde;
-    private readonly group;
+    private readonly serde;
     private readonly database;
     /**
      * @example
      * ```ts
-     * import { RedisCacheAdapter } from "@daiso-tech/core/cache/implementations/adapters";
-     * import { Serde } from "@daiso-tech/core/serde/implementations/derivables";
-     * import { SuperJsonSerdeAdapter } from "@daiso-tech/core/serde/implementations/adapters"
+     * import { RedisCacheAdapter } from "@daiso-tech/core/cache/adapters";
+     * import { Serde } from "@daiso-tech/core/serde";
+     * import { SuperJsonSerdeAdapter } from "@daiso-tech/core/serde/adapters"
      * import Redis from "ioredis";
      *
      * const database = new Redis("YOUR_REDIS_CONNECTION_STRING");
@@ -45,21 +42,18 @@ export declare class RedisCacheAdapter<TType = unknown> implements ICacheAdapter
      * const cacheAdapter = new RedisCacheAdapter({
      *   database,
      *   serde,
-     *   rootGroup: "@global"
      * });
      * ```
      */
     constructor(settings: RedisCacheAdapterSettings);
-    private getPrefix;
-    private withPrefix;
+    private initIncrementCommand;
     get(key: string): Promise<TType | null>;
+    getAndRemove(key: string): Promise<TType | null>;
     add(key: string, value: TType, ttl: TimeSpan | null): Promise<boolean>;
-    update(key: string, value: TType): Promise<boolean>;
     put(key: string, value: TType, ttl: TimeSpan | null): Promise<boolean>;
-    remove(key: string): Promise<boolean>;
-    private initIncrementCommand;
+    update(key: string, value: TType): Promise<boolean>;
     increment(key: string, value: number): Promise<boolean>;
-    clear(): Promise<void>;
-    getGroup(): string;
-    withGroup(group: string): ICacheAdapter<TType>;
+    removeMany(keys: string[]): Promise<boolean>;
+    removeAll(): Promise<void>;
+    removeByKeyPrefix(prefix: string): Promise<void>;
 }

package/dist/cache/implementations/adapters/redis-cache-adapter/redis-cache-adapter.js

@@ -1,78 +1,14 @@
 /**
  * @module Cache
  */
-import { TypeCacheError } from "../../../../cache/contracts/cache.errors.js";
-import {} from "../../../../cache/contracts/cache-adapter.contract.js";
-import { resolveOneOrMoreStr, } from "../../../../utilities/_module-exports.js";
+import { TypeCacheError, } from "../../../../cache/contracts/_module-exports.js";
 import { ReplyError } from "ioredis";
-import { RedisSerde, } from "../../../../serde/implementations/adapters/_module-exports.js";
-/**
- * @internal
- */
-class ClearIterable {
-    client;
-    pattern;
-    constructor(client, pattern) {
-        this.client = client;
-        this.pattern = pattern;
-    }
-    async *[Symbol.asyncIterator]() {
-        let coursor = 0;
-        do {
-            const [_coursor, elements] = await this.client.scan(coursor, "MATCH", this.pattern);
-            if (elements.length === 0) {
-                return;
-            }
-            await this.client.del(elements);
-            coursor++;
-            yield undefined;
-        } while (coursor !== 0);
-    }
-}
-/**
- * @internal
- */
-function escapeRedisChars(value) {
-    const replacements = {
-        ",": "\\,",
-        ".": "\\.",
-        "<": "\\<",
-        ">": "\\>",
-        "{": "\\{",
-        "}": "\\}",
-        "[": "\\[",
-        "]": "\\]",
-        '"': '\\"',
-        "'": "\\'",
-        ":": "\\:",
-        ";": "\\;",
-        "!": "\\!",
-        "@": "\\@",
-        "#": "\\#",
-        $: "\\$",
-        "%": "\\%",
-        "^": "\\^",
-        "&": "\\&",
-        "*": "\\*",
-        "(": "\\(",
-        ")": "\\)",
-        "-": "\\-",
-        "+": "\\+",
-        "=": "\\=",
-        "~": "\\~",
-    };
-    return value.replace(/,|\.|<|>|\{|\}|\[|\]|"|'|:|;|!|@|#|\$|%|\^|&|\*|\(|\)|-|\+|=|~/g, (chunk) => {
-        const item = replacements[chunk];
-        if (item === undefined) {
-            throw new Error("Encounterd none existing field");
-        }
-        return item;
-    });
-}
+import { ClearIterable } from "../../../../cache/implementations/adapters/redis-cache-adapter/utilities.js";
+import { RedisCacheAdapterSerde } from "../../../../cache/implementations/adapters/redis-cache-adapter/redis-cache-adapter-serde.js";
 /**
  * To utilize the <i>RedisCacheAdapter</i>, you must install the <i>"ioredis"</i> package and supply a <i>{@link ISerde | ISerde<string> }</i>, with adapter like <i>{@link SuperJsonSerdeAdapter}</i>.
  *
- * IMPORT_PATH: ```"@daiso-tech/core/cache/implementations/adapters"```
+ * IMPORT_PATH: ```"@daiso-tech/core/cache/adapters"```
  * @group Adapters
  */
 export class RedisCacheAdapter {
@@ -84,16 +20,14 @@ export class RedisCacheAdapter {
             // eslint-disable-next-line @typescript-eslint/no-unsafe-call, @typescript-eslint/no-unsafe-member-access
             value.message.includes("ERR value is not a valid float"));
     }
-    baseSerde;
-    redisSerde;
-    group;
+    serde;
     database;
     /**
      * @example
      * ```ts
-     * import { RedisCacheAdapter } from "@daiso-tech/core/cache/implementations/adapters";
-     * import { Serde } from "@daiso-tech/core/serde/implementations/derivables";
-     * import { SuperJsonSerdeAdapter } from "@daiso-tech/core/serde/implementations/adapters"
+     * import { RedisCacheAdapter } from "@daiso-tech/core/cache/adapters";
+     * import { Serde } from "@daiso-tech/core/serde";
+     * import { SuperJsonSerdeAdapter } from "@daiso-tech/core/serde/adapters"
      * import Redis from "ioredis";
      *
      * const database = new Redis("YOUR_REDIS_CONNECTION_STRING");
@@ -101,81 +35,69 @@ export class RedisCacheAdapter {
      * const cacheAdapter = new RedisCacheAdapter({
      *   database,
      *   serde,
-     *   rootGroup: "@global"
      * });
      * ```
      */
     constructor(settings) {
-        const { database, serde, rootGroup } = settings;
+        const { database, serde } = settings;
         this.database = database;
-        this.group = rootGroup;
-        this.baseSerde = serde;
-        this.redisSerde = new RedisSerde(serde);
+        this.serde = new RedisCacheAdapterSerde(serde);
         this.initIncrementCommand();
     }
-    getPrefix() {
-        return resolveOneOrMoreStr([this.group, "__KEY__"]);
-    }
-    withPrefix(key) {
-        return resolveOneOrMoreStr([this.getPrefix(), key]);
+    initIncrementCommand() {
+        if (typeof this.database.daiso_cache_increment === "function") {
+            return;
+        }
+        this.database.defineCommand("daiso_cache_increment", {
+            numberOfKeys: 1,
+            lua: `
+                local hasKey = redis.call("exists", KEYS[1])
+        
+                if hasKey == 1 then
+                    redis.call("incrbyfloat", KEYS[1], tonumber(ARGV[1]))
+                end
+                
+                return hasKey
+                `,
+        });
     }
     async get(key) {
-        key = this.withPrefix(key);
         const value = await this.database.get(key);
         if (value === null) {
             return null;
         }
-        return await this.redisSerde.deserialize(value);
+        return await this.serde.deserialize(value);
+    }
+    async getAndRemove(key) {
+        const value = await this.database.getdel(key);
+        if (value === null) {
+            return null;
+        }
+        return this.serde.deserialize(value);
     }
     async add(key, value, ttl) {
-        key = this.withPrefix(key);
         if (ttl === null) {
-            const result = await this.database.set(key, this.redisSerde.serialize(value), "NX");
+            const result = await this.database.set(key, this.serde.serialize(value), "NX");
             return result === "OK";
         }
-        const result = await this.database.set(key, this.redisSerde.serialize(value), "PX", ttl.toMilliseconds(), "NX");
-        return result === "OK";
-    }
-    async update(key, value) {
-        key = this.withPrefix(key);
-        const result = await this.database.set(key, this.redisSerde.serialize(value), "XX");
+        const result = await this.database.set(key, this.serde.serialize(value), "PX", ttl.toMilliseconds(), "NX");
         return result === "OK";
     }
     async put(key, value, ttl) {
-        key = this.withPrefix(key);
         if (ttl === null) {
-            const result = await this.database.set(key, this.redisSerde.serialize(value), "GET");
+            const result = await this.database.set(key, this.serde.serialize(value), "GET");
             return result !== null;
         }
-        const result = await this.database.set(key, this.redisSerde.serialize(value), "PX", ttl.toMilliseconds(), "GET");
+        const result = await this.database.set(key, this.serde.serialize(value), "PX", ttl.toMilliseconds(), "GET");
         return result !== null;
     }
-    async remove(key) {
-        key = this.withPrefix(key);
-        const result = await this.database.del(key);
-        return result === 1;
-    }
-    initIncrementCommand() {
-        if (typeof this.database.daiso_cache_increment === "function") {
-            return;
-        }
-        this.database.defineCommand("daiso_cache_increment", {
-            numberOfKeys: 1,
-            lua: `
-                local hasKey = redis.call("exists", KEYS[1])
-        
-                if hasKey == 1 then
-                    redis.call("incrbyfloat", KEYS[1], tonumber(ARGV[1]))
-                end
-                
-                return hasKey
-                `,
-        });
+    async update(key, value) {
+        const result = await this.database.set(key, this.serde.serialize(value), "XX");
+        return result === "OK";
     }
     async increment(key, value) {
         try {
-            key = this.withPrefix(key);
-            const redisResult = await this.database.daiso_cache_increment(key, this.redisSerde.serialize(value));
+            const redisResult = await this.database.daiso_cache_increment(key, this.serde.serialize(value));
             const keyExists = redisResult === 1;
             return keyExists;
         }
@@ -186,20 +108,17 @@ export class RedisCacheAdapter {
             throw new TypeCacheError(`Unable to increment or decrement none number type key "${key}"`);
         }
     }
-    async clear() {
-        for await (const _ of new ClearIterable(this.database, resolveOneOrMoreStr([escapeRedisChars(this.getPrefix()), "*"]))) {
-            /* Empty */
-        }
+    async removeMany(keys) {
+        const deleteResult = await this.database.del(...keys);
+        return deleteResult > 0;
     }
-    getGroup() {
-        return this.group;
+    async removeAll() {
+        await this.database.flushdb();
     }
-    withGroup(group) {
-        return new RedisCacheAdapter({
-            database: this.database,
-            serde: this.baseSerde,
-            rootGroup: resolveOneOrMoreStr([this.group, group]),
-        });
+    async removeByKeyPrefix(prefix) {
+        for await (const _ of new ClearIterable(this.database, prefix)) {
+            /* Empty */
+        }
     }
 }
 //# sourceMappingURL=redis-cache-adapter.js.map

package/dist/cache/implementations/adapters/redis-cache-adapter/redis-cache-adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"redis-cache-adapter.js","sourceRoot":"","sources":["../../../../../src/cache/implementations/adapters/redis-cache-adapter/redis-cache-adapter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"redis-cache-adapter.js","sourceRoot":"","sources":["../../../../../src/cache/implementations/adapters/redis-cache-adapter/redis-cache-adapter.ts"],"names":[],"mappings":"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"}

package/dist/cache/implementations/adapters/redis-cache-adapter/utilities.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @module Cache
+ */
+import { type Redis } from "ioredis";
+/**
+ * @internal
+ */
+export declare class ClearIterable implements AsyncIterable<void> {
+    private readonly client;
+    private readonly pattern;
+    constructor(client: Redis, pattern: string);
+    [Symbol.asyncIterator](): AsyncIterator<void>;
+}

package/dist/cache/implementations/adapters/redis-cache-adapter/utilities.js

@@ -0,0 +1,69 @@
+/**
+ * @module Cache
+ */
+import {} from "ioredis";
+/**
+ * @internal
+ */
+function escapeRedisChars(value) {
+    const replacements = {
+        ",": "\\,",
+        ".": "\\.",
+        "<": "\\<",
+        ">": "\\>",
+        "{": "\\{",
+        "}": "\\}",
+        "[": "\\[",
+        "]": "\\]",
+        '"': '\\"',
+        "'": "\\'",
+        ":": "\\:",
+        ";": "\\;",
+        "!": "\\!",
+        "@": "\\@",
+        "#": "\\#",
+        $: "\\$",
+        "%": "\\%",
+        "^": "\\^",
+        "&": "\\&",
+        "*": "\\*",
+        "(": "\\(",
+        ")": "\\)",
+        "-": "\\-",
+        "+": "\\+",
+        "=": "\\=",
+        "~": "\\~",
+    };
+    return value.replace(/,|\.|<|>|\{|\}|\[|\]|"|'|:|;|!|@|#|\$|%|\^|&|\*|\(|\)|-|\+|=|~/g, (chunk) => {
+        const item = replacements[chunk];
+        if (item === undefined) {
+            throw new Error("Encounterd none existing field");
+        }
+        return item;
+    });
+}
+/**
+ * @internal
+ */
+export class ClearIterable {
+    client;
+    pattern;
+    constructor(client, pattern) {
+        this.client = client;
+        this.pattern = pattern;
+        this.pattern = `${escapeRedisChars(pattern)}*`;
+    }
+    async *[Symbol.asyncIterator]() {
+        let coursor = 0;
+        do {
+            const [_coursor, elements] = await this.client.scan(coursor, "MATCH", this.pattern);
+            if (elements.length === 0) {
+                return;
+            }
+            await this.client.del(elements);
+            coursor++;
+            yield undefined;
+        } while (coursor !== 0);
+    }
+}
+//# sourceMappingURL=utilities.js.map

package/dist/cache/implementations/adapters/redis-cache-adapter/utilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utilities.js","sourceRoot":"","sources":["../../../../../src/cache/implementations/adapters/redis-cache-adapter/utilities.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAc,MAAM,SAAS,CAAC;AAErC;;GAEG;AACH,SAAS,gBAAgB,CAAC,KAAa;IACnC,MAAM,YAAY,GAA2B;QACzC,GAAG,EAAE,KAAK;QACV,GAAG,EAAE,KAAK;QACV,GAAG,EAAE,KAAK;QACV,GAAG,EAAE,KAAK;QACV,GAAG,EAAE,KAAK;QACV,GAAG,EAAE,KAAK;QACV,GAAG,EAAE,KAAK;QACV,GAAG,EAAE,KAAK;QACV,GAAG,EAAE,KAAK;QACV,GAAG,EAAE,KAAK;QACV,GAAG,EAAE,KAAK;QACV,GAAG,EAAE,KAAK;QACV,GAAG,EAAE,KAAK;QACV,GAAG,EAAE,KAAK;QACV,GAAG,EAAE,KAAK;QACV,CAAC,EAAE,KAAK;QACR,GAAG,EAAE,KAAK;QACV,GAAG,EAAE,KAAK;QACV,GAAG,EAAE,KAAK;QACV,GAAG,EAAE,KAAK;QACV,GAAG,EAAE,KAAK;QACV,GAAG,EAAE,KAAK;QACV,GAAG,EAAE,KAAK;QACV,GAAG,EAAE,KAAK;QACV,GAAG,EAAE,KAAK;QACV,GAAG,EAAE,KAAK;KACb,CAAC;IACF,OAAO,KAAK,CAAC,OAAO,CAChB,iEAAiE,EACjE,CAAC,KAAK,EAAE,EAAE;QACN,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACtD,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC,CACJ,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,aAAa;IAED;IACA;IAFrB,YACqB,MAAa,EACb,OAAe;QADf,WAAM,GAAN,MAAM,CAAO;QACb,YAAO,GAAP,OAAO,CAAQ;QAEhC,IAAI,CAAC,OAAO,GAAG,GAAG,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC;QACzB,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,GAAG,CAAC;YACA,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAC/C,OAAO,EACP,OAAO,EACP,IAAI,CAAC,OAAO,CACf,CAAC;YACF,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACxB,OAAO;YACX,CAAC;YACD,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAChC,OAAO,EAAE,CAAC;YACV,MAAM,SAAS,CAAC;QACpB,CAAC,QAAQ,OAAO,KAAK,CAAC,EAAE;IAC5B,CAAC;CACJ"}

package/dist/cache/implementations/adapters/sqlite-cache-adapter/sqlite-cache-adapter.d.ts

@@ -1,71 +1,59 @@
 /**
  * @module Cache
  */
-import { type ICacheAdapter } from "../../../../cache/contracts/cache-adapter.contract.js";
-import type { TimeSpan, IInitizable, IDeinitizable } from "../../../../utilities/_module-exports.js";
-import type { SqliteDatabase } from "kysely";
+import { type ICacheData, type ICacheInsert, type ICacheUpdate, type IDatabaseCacheAdapter } from "../../../../cache/contracts/_module-exports.js";
+import { type TimeSpan, type IInitizable, type IDeinitizable, type IPrunable, type ISqliteDatabase } from "../../../../utilities/_module-exports.js";
 import type { ISerde } from "../../../../serde/contracts/_module-exports.js";
 /**
  *
- * IMPORT_PATH: ```"@daiso-tech/core/cache/implementations/adapters"```
+ * IMPORT_PATH: ```"@daiso-tech/core/cache/adapters"```
  * @group Adapters
  */
 export type SqliteCacheAdapterSettings = {
-    database: SqliteDatabase;
+    database: ISqliteDatabase;
     tableName?: string;
     serde: ISerde<string>;
-    enableTransactions?: boolean;
     expiredKeysRemovalInterval?: TimeSpan;
     shouldRemoveExpiredKeys?: boolean;
-    rootGroup: string;
 };
 /**
  * To utilize the <i>SqliteCacheAdapter</i>, you must install the <i>"better-sqlite3"</i> package and supply a <i>{@link ISerde | ISerde<string> }</i>, with adapter like <i>{@link SuperJsonSerdeAdapter}</i>.
  *
- * IMPORT_PATH: ```"@daiso-tech/core/cache/implementations/adapters"```
+ * IMPORT_PATH: ```"@daiso-tech/core/cache/adapters"```
  * @group Adapters
  */
-export declare class SqliteCacheAdapter<TType = unknown> implements ICacheAdapter<TType>, IInitizable, IDeinitizable {
-    private readonly cacheAdapter;
+export declare class SqliteCacheAdapter<TType = unknown> implements IDatabaseCacheAdapter<TType>, IInitizable, IDeinitizable, IPrunable {
+    private readonly adapter;
     /**
      * @example
      * ```ts
-     * import { SqliteCacheAdapter } from "@daiso-tech/core/cache/implementations/adapters";
-     * import { Serde } from "@daiso-tech/core/serde/implementations/derivables";
-     * import { SuperJsonSerdeAdapter } from "@daiso-tech/core/serde/implementations/adapters"
+     * import { SqliteCacheAdapter } from "@daiso-tech/core/cache/adapters";
+     * import { Serde } from "@daiso-tech/core/serde";
+     * import { SuperJsonSerdeAdapter } from "@daiso-tech/core/serde/adapters"
      * import Sqlite from "better-sqlite3";
      *
-     * (async () => {
-     *   const database = new Sqlite("local.db");
-     *   const serde = new Serde(new SuperJsonSerdeAdapter());
-     *   const cacheAdapter = new SqliteCacheAdapter({
-     *     database,
-     *     serde,
-     *     rootGroup: "@global"
-     *   });
-     *   await cacheAdapter.init();
-     * })();
+     * const database = new Sqlite("local.db");
+     * const serde = new Serde(new SuperJsonSerdeAdapter());
+     * const cacheAdapter = new SqliteCacheAdapter({
+     *   database,
+     *   serde,
+     * });
+     * // You need initialize the adapter once before using it.
+     * await cacheAdapter.init();
      * ```
      */
     constructor(settings: SqliteCacheAdapterSettings);
-    getGroup(): string;
-    withGroup(group: string): ICacheAdapter<TType>;
-    removeExpiredKeys(): Promise<void>;
-    /**
-     * Removes the table where the cache values are stored and removes the table indexes.
-     * Note all cache data will be removed.
-     */
+    removeAllExpired(): Promise<void>;
     deInit(): Promise<void>;
-    /**
-     * Creates the table where the cache values are stored and it's related indexes.
-     * Note the <i>init</i> method needs to be called before using the adapter.
-     */
     init(): Promise<void>;
-    get(key: string): Promise<TType | null>;
-    add(key: string, value: TType, ttl: TimeSpan | null): Promise<boolean>;
-    update(key: string, value: TType): Promise<boolean>;
-    put(key: string, value: TType, ttl: TimeSpan | null): Promise<boolean>;
-    remove(key: string): Promise<boolean>;
-    increment(key: string, value: number): Promise<boolean>;
-    clear(): Promise<void>;
+    insert(data: ICacheInsert<TType>): Promise<void>;
+    upsert(data: ICacheInsert<TType>): Promise<ICacheData<TType> | null>;
+    find(key: string): Promise<ICacheData<TType> | null>;
+    updateExpired(data: ICacheInsert<TType>): Promise<number>;
+    updateUnexpired(data: ICacheUpdate<TType>): Promise<number>;
+    incrementUnexpired(data: ICacheUpdate<number>): Promise<number>;
+    removeUnexpiredMany(keys: string[]): Promise<number>;
+    removeExpiredMany(keys: string[]): Promise<number>;
+    removeAll(): Promise<void>;
+    removeByKeyPrefix(prefix: string): Promise<void>;
 }