beeai-framework 0.1.2

package/dist/cache/fileCache.d.cts

@@ -0,0 +1,48 @@
+import { BaseCache } from './base.cjs';
+import '../internals/serializable.cjs';
+import '../internals/types.cjs';
+import '../internals/helpers/guards.cjs';
+
+/**
+ * Copyright 2025 IBM Corp.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+interface Input {
+    fullPath: string;
+}
+declare class FileCache<T> extends BaseCache<T> {
+    protected readonly input: Input;
+    constructor(input: Input);
+    get source(): string;
+    static fromProvider<A>(provider: BaseCache<A>, input: Input): Promise<FileCache<A>>;
+    protected getProvider(): Promise<BaseCache<T>>;
+    reload(): Promise<void>;
+    protected save(): Promise<void>;
+    size(): Promise<number>;
+    set(key: string, value: T): Promise<void>;
+    get(key: string): Promise<T | undefined>;
+    has(key: string): Promise<boolean>;
+    delete(key: string): Promise<boolean>;
+    clear(): Promise<void>;
+    createSnapshot(): Promise<{
+        input: {
+            fullPath: string;
+        };
+        provider: BaseCache<T>;
+    }>;
+    loadSnapshot(snapshot: Awaited<ReturnType<typeof this.createSnapshot>>): void;
+}
+
+export { FileCache };

package/dist/cache/fileCache.d.ts

@@ -0,0 +1,48 @@
+import { BaseCache } from './base.js';
+import '../internals/serializable.js';
+import '../internals/types.js';
+import '../internals/helpers/guards.js';
+
+/**
+ * Copyright 2025 IBM Corp.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+interface Input {
+    fullPath: string;
+}
+declare class FileCache<T> extends BaseCache<T> {
+    protected readonly input: Input;
+    constructor(input: Input);
+    get source(): string;
+    static fromProvider<A>(provider: BaseCache<A>, input: Input): Promise<FileCache<A>>;
+    protected getProvider(): Promise<BaseCache<T>>;
+    reload(): Promise<void>;
+    protected save(): Promise<void>;
+    size(): Promise<number>;
+    set(key: string, value: T): Promise<void>;
+    get(key: string): Promise<T | undefined>;
+    has(key: string): Promise<boolean>;
+    delete(key: string): Promise<boolean>;
+    clear(): Promise<void>;
+    createSnapshot(): Promise<{
+        input: {
+            fullPath: string;
+        };
+        provider: BaseCache<T>;
+    }>;
+    loadSnapshot(snapshot: Awaited<ReturnType<typeof this.createSnapshot>>): void;
+}
+
+export { FileCache };

package/dist/cache/fileCache.js

@@ -0,0 +1,115 @@
+import { BaseCache } from './base.js';
+import fs from 'node:fs';
+import { SlidingCache } from './slidingCache.js';
+import { Cache } from './decoratorCache.js';
+import { Serializer } from '../serializer/serializer.js';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+function _ts_decorate(decorators, target, key, desc) {
+  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+__name(_ts_decorate, "_ts_decorate");
+function _ts_metadata(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+__name(_ts_metadata, "_ts_metadata");
+class FileCache extends BaseCache {
+  static {
+    __name(this, "FileCache");
+  }
+  input;
+  constructor(input) {
+    super(), this.input = input;
+  }
+  static {
+    this.register();
+  }
+  get source() {
+    return this.input.fullPath;
+  }
+  static async fromProvider(provider, input) {
+    await fs.promises.writeFile(input.fullPath, await provider.serialize());
+    return new FileCache(input);
+  }
+  async getProvider() {
+    const exists = await fs.promises.stat(this.input.fullPath).then((r) => r.isFile()).catch(() => false);
+    if (exists) {
+      const serialized = await fs.promises.readFile(this.input.fullPath, "utf8");
+      const { target, snapshot } = await Serializer.deserialize(serialized);
+      const Target = Serializer.getFactory(target).ref;
+      const instance = await Target.fromSnapshot(snapshot);
+      if (!(instance instanceof BaseCache)) {
+        throw new TypeError("Provided file does not serialize any instance of BaseCache class.");
+      }
+      return instance;
+    } else {
+      return new SlidingCache({
+        size: Infinity,
+        ttl: Infinity
+      });
+    }
+  }
+  async reload() {
+    Cache.getInstance(this, "getProvider").clear();
+    void await this.getProvider();
+  }
+  async save() {
+    const provider = await this.getProvider();
+    return await fs.promises.writeFile(this.input.fullPath, await provider.serialize());
+  }
+  async size() {
+    const provider = await this.getProvider();
+    return provider.size();
+  }
+  async set(key, value) {
+    const provider = await this.getProvider();
+    await provider.set(key, value);
+    void provider.get(key).finally(() => {
+      void this.save();
+    });
+  }
+  async get(key) {
+    const provider = await this.getProvider();
+    return await provider.get(key);
+  }
+  async has(key) {
+    const provider = await this.getProvider();
+    return await provider.has(key);
+  }
+  async delete(key) {
+    const provider = await this.getProvider();
+    const result = await provider.delete(key);
+    await this.save();
+    return result;
+  }
+  async clear() {
+    const provider = await this.getProvider();
+    await provider.clear();
+    await this.save();
+  }
+  async createSnapshot() {
+    return {
+      input: {
+        fullPath: this.input.fullPath
+      },
+      provider: await this.getProvider()
+    };
+  }
+  loadSnapshot(snapshot) {
+    Object.assign(this, snapshot);
+  }
+}
+_ts_decorate([
+  Cache(),
+  _ts_metadata("design:type", Function),
+  _ts_metadata("design:paramtypes", []),
+  _ts_metadata("design:returntype", Promise)
+], FileCache.prototype, "getProvider", null);
+
+export { FileCache };
+//# sourceMappingURL=fileCache.js.map
+//# sourceMappingURL=fileCache.js.map

package/dist/cache/fileCache.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/cache/fileCache.ts"],"names":["FileCache","BaseCache","constructor","input","register","source","fullPath","fromProvider","provider","fs","promises","writeFile","serialize","getProvider","exists","stat","then","r","isFile","catch","serialized","readFile","target","snapshot","Serializer","deserialize","Target","getFactory","ref","instance","fromSnapshot","TypeError","SlidingCache","size","Infinity","ttl","reload","Cache","getInstance","clear","save","set","key","value","get","finally","has","delete","result","createSnapshot","loadSnapshot","Object","assign"],"mappings":"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","file":"fileCache.js","sourcesContent":["/**\n * Copyright 2025 IBM Corp.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { BaseCache } from \"@/cache/base.js\";\nimport fs from \"node:fs\";\nimport { SlidingCache } from \"@/cache/slidingCache.js\";\nimport { Cache } from \"@/cache/decoratorCache.js\";\nimport { Serializer } from \"@/serializer/serializer.js\";\nimport { SerializableClass } from \"@/internals/serializable.js\";\n\ninterface Input {\n  fullPath: string;\n}\n\nexport class FileCache<T> extends BaseCache<T> {\n  constructor(protected readonly input: Input) {\n    super();\n  }\n\n  static {\n    this.register();\n  }\n\n  get source() {\n    return this.input.fullPath;\n  }\n\n  static async fromProvider<A>(provider: BaseCache<A>, input: Input) {\n    await fs.promises.writeFile(input.fullPath, await provider.serialize());\n    return new FileCache<A>(input);\n  }\n\n  @Cache()\n  protected async getProvider(): Promise<BaseCache<T>> {\n    const exists = await fs.promises\n      .stat(this.input.fullPath)\n      .then((r) => r.isFile())\n      .catch(() => false);\n\n    if (exists) {\n      const serialized = await fs.promises.readFile(this.input.fullPath, \"utf8\");\n      const { target, snapshot } = await Serializer.deserialize<any>(serialized);\n      const Target = Serializer.getFactory(target).ref as SerializableClass<BaseCache<T>>;\n      const instance = await Target.fromSnapshot(snapshot);\n      if (!(instance instanceof BaseCache)) {\n        throw new TypeError(\"Provided file does not serialize any instance of BaseCache class.\");\n      }\n      return instance;\n    } else {\n      return new SlidingCache({\n        size: Infinity,\n        ttl: Infinity,\n      });\n    }\n  }\n\n  async reload() {\n    // @ts-expect-error protected property\n    Cache.getInstance(this, \"getProvider\").clear();\n    void (await this.getProvider());\n  }\n\n  protected async save() {\n    const provider = await this.getProvider();\n    return await fs.promises.writeFile(this.input.fullPath, await provider.serialize());\n  }\n\n  async size() {\n    const provider = await this.getProvider();\n    return provider.size();\n  }\n\n  async set(key: string, value: T) {\n    const provider = await this.getProvider();\n    await provider.set(key, value);\n    void provider.get(key).finally(() => {\n      void this.save();\n    });\n  }\n\n  async get(key: string) {\n    const provider = await this.getProvider();\n    return await provider.get(key);\n  }\n\n  async has(key: string) {\n    const provider = await this.getProvider();\n    return await provider.has(key);\n  }\n\n  async delete(key: string) {\n    const provider = await this.getProvider();\n    const result = await provider.delete(key);\n    await this.save();\n    return result;\n  }\n\n  async clear() {\n    const provider = await this.getProvider();\n    await provider.clear();\n    await this.save();\n  }\n\n  async createSnapshot() {\n    return {\n      input: { fullPath: this.input.fullPath },\n      provider: await this.getProvider(),\n    };\n  }\n\n  loadSnapshot(snapshot: Awaited<ReturnType<typeof this.createSnapshot>>): void {\n    Object.assign(this, snapshot);\n  }\n}\n"]}

package/dist/cache/nullCache.cjs

@@ -0,0 +1,40 @@
+'use strict';
+
+var base_cjs = require('./base.cjs');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class NullCache extends base_cjs.BaseCache {
+  static {
+    __name(this, "NullCache");
+  }
+  enabled = false;
+  async set(_key, _value) {
+  }
+  async get(_key) {
+    return void 0;
+  }
+  async has(_key) {
+    return false;
+  }
+  async delete(_key) {
+    return true;
+  }
+  async clear() {
+  }
+  async size() {
+    return 0;
+  }
+  createSnapshot() {
+    return {
+      enabled: this.enabled
+    };
+  }
+  loadSnapshot(snapshot) {
+    Object.assign(this, snapshot);
+  }
+}
+
+exports.NullCache = NullCache;
+//# sourceMappingURL=nullCache.cjs.map
+//# sourceMappingURL=nullCache.cjs.map

package/dist/cache/nullCache.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/cache/nullCache.ts"],"names":["NullCache","BaseCache","enabled","set","_key","_value","get","undefined","has","delete","clear","size","createSnapshot","loadSnapshot","snapshot","Object","assign"],"mappings":";;;;;;AAkBO,MAAMA,kBAAqBC,kBAAAA,CAAAA;EAlBlC;;;EAmBEC,OAAU,GAAA,KAAA;EAEV,MAAMC,GAAAA,CAAIC,MAAcC,MAAW,EAAA;AAAC;AAEpC,EAAA,MAAMC,IAAIF,IAAc,EAAA;AACtB,IAAOG,OAAAA,KAAAA,CAAAA;AACT;AAEA,EAAA,MAAMC,IAAIJ,IAAc,EAAA;AACtB,IAAO,OAAA,KAAA;AACT;AAEA,EAAA,MAAMK,OAAOL,IAAc,EAAA;AACzB,IAAO,OAAA,IAAA;AACT;AAEA,EAAA,MAAMM,KAAQ,GAAA;AAAC;AAEf,EAAA,MAAMC,IAAO,GAAA;AACX,IAAO,OAAA,CAAA;AACT;EAEAC,cAAiB,GAAA;AACf,IAAO,OAAA;AACLV,MAAAA,OAAAA,EAAS,IAAKA,CAAAA;AAChB,KAAA;AACF;AAEAW,EAAAA,YAAAA,CAAaC,QAAkD,EAAA;AAC7DC,IAAOC,MAAAA,CAAAA,MAAAA,CAAO,MAAMF,QAAAA,CAAAA;AACtB;AACF","file":"nullCache.cjs","sourcesContent":["/**\n * Copyright 2025 IBM Corp.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { BaseCache } from \"@/cache/base.js\";\n\nexport class NullCache<T> extends BaseCache<T> {\n  enabled = false;\n\n  async set(_key: string, _value: T) {}\n\n  async get(_key: string) {\n    return undefined;\n  }\n\n  async has(_key: string) {\n    return false;\n  }\n\n  async delete(_key: string) {\n    return true;\n  }\n\n  async clear() {}\n\n  async size() {\n    return 0;\n  }\n\n  createSnapshot() {\n    return {\n      enabled: this.enabled,\n    };\n  }\n\n  loadSnapshot(snapshot: ReturnType<typeof this.createSnapshot>) {\n    Object.assign(this, snapshot);\n  }\n}\n"]}

package/dist/cache/nullCache.d.cts

@@ -0,0 +1,36 @@
+import { BaseCache } from './base.cjs';
+import '../internals/serializable.cjs';
+import '../internals/types.cjs';
+import '../internals/helpers/guards.cjs';
+
+/**
+ * Copyright 2025 IBM Corp.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+declare class NullCache<T> extends BaseCache<T> {
+    enabled: boolean;
+    set(_key: string, _value: T): Promise<void>;
+    get(_key: string): Promise<undefined>;
+    has(_key: string): Promise<boolean>;
+    delete(_key: string): Promise<boolean>;
+    clear(): Promise<void>;
+    size(): Promise<number>;
+    createSnapshot(): {
+        enabled: boolean;
+    };
+    loadSnapshot(snapshot: ReturnType<typeof this.createSnapshot>): void;
+}
+
+export { NullCache };

package/dist/cache/nullCache.d.ts

@@ -0,0 +1,36 @@
+import { BaseCache } from './base.js';
+import '../internals/serializable.js';
+import '../internals/types.js';
+import '../internals/helpers/guards.js';
+
+/**
+ * Copyright 2025 IBM Corp.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+declare class NullCache<T> extends BaseCache<T> {
+    enabled: boolean;
+    set(_key: string, _value: T): Promise<void>;
+    get(_key: string): Promise<undefined>;
+    has(_key: string): Promise<boolean>;
+    delete(_key: string): Promise<boolean>;
+    clear(): Promise<void>;
+    size(): Promise<number>;
+    createSnapshot(): {
+        enabled: boolean;
+    };
+    loadSnapshot(snapshot: ReturnType<typeof this.createSnapshot>): void;
+}
+
+export { NullCache };

package/dist/cache/nullCache.js

@@ -0,0 +1,38 @@
+import { BaseCache } from './base.js';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class NullCache extends BaseCache {
+  static {
+    __name(this, "NullCache");
+  }
+  enabled = false;
+  async set(_key, _value) {
+  }
+  async get(_key) {
+    return void 0;
+  }
+  async has(_key) {
+    return false;
+  }
+  async delete(_key) {
+    return true;
+  }
+  async clear() {
+  }
+  async size() {
+    return 0;
+  }
+  createSnapshot() {
+    return {
+      enabled: this.enabled
+    };
+  }
+  loadSnapshot(snapshot) {
+    Object.assign(this, snapshot);
+  }
+}
+
+export { NullCache };
+//# sourceMappingURL=nullCache.js.map
+//# sourceMappingURL=nullCache.js.map

package/dist/cache/nullCache.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/cache/nullCache.ts"],"names":["NullCache","BaseCache","enabled","set","_key","_value","get","undefined","has","delete","clear","size","createSnapshot","loadSnapshot","snapshot","Object","assign"],"mappings":";;;;AAkBO,MAAMA,kBAAqBC,SAAAA,CAAAA;EAlBlC;;;EAmBEC,OAAU,GAAA,KAAA;EAEV,MAAMC,GAAAA,CAAIC,MAAcC,MAAW,EAAA;AAAC;AAEpC,EAAA,MAAMC,IAAIF,IAAc,EAAA;AACtB,IAAOG,OAAAA,KAAAA,CAAAA;AACT;AAEA,EAAA,MAAMC,IAAIJ,IAAc,EAAA;AACtB,IAAO,OAAA,KAAA;AACT;AAEA,EAAA,MAAMK,OAAOL,IAAc,EAAA;AACzB,IAAO,OAAA,IAAA;AACT;AAEA,EAAA,MAAMM,KAAQ,GAAA;AAAC;AAEf,EAAA,MAAMC,IAAO,GAAA;AACX,IAAO,OAAA,CAAA;AACT;EAEAC,cAAiB,GAAA;AACf,IAAO,OAAA;AACLV,MAAAA,OAAAA,EAAS,IAAKA,CAAAA;AAChB,KAAA;AACF;AAEAW,EAAAA,YAAAA,CAAaC,QAAkD,EAAA;AAC7DC,IAAOC,MAAAA,CAAAA,MAAAA,CAAO,MAAMF,QAAAA,CAAAA;AACtB;AACF","file":"nullCache.js","sourcesContent":["/**\n * Copyright 2025 IBM Corp.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { BaseCache } from \"@/cache/base.js\";\n\nexport class NullCache<T> extends BaseCache<T> {\n  enabled = false;\n\n  async set(_key: string, _value: T) {}\n\n  async get(_key: string) {\n    return undefined;\n  }\n\n  async has(_key: string) {\n    return false;\n  }\n\n  async delete(_key: string) {\n    return true;\n  }\n\n  async clear() {}\n\n  async size() {\n    return 0;\n  }\n\n  createSnapshot() {\n    return {\n      enabled: this.enabled,\n    };\n  }\n\n  loadSnapshot(snapshot: ReturnType<typeof this.createSnapshot>) {\n    Object.assign(this, snapshot);\n  }\n}\n"]}

package/dist/cache/slidingCache.cjs

@@ -0,0 +1,81 @@
+'use strict';
+
+var promiseBasedTask = require('promise-based-task');
+var base_cjs = require('./base.cjs');
+var serializable_cjs = require('../internals/serializable.cjs');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+let SlidingCacheEntry = class SlidingCacheEntry2 extends serializable_cjs.Serializable {
+  static {
+    __name(this, "SlidingCacheEntry");
+  }
+  value;
+  constructor(value) {
+    super(), this.value = value;
+  }
+  static {
+    this.register();
+  }
+  destructor() {
+    if (this.value instanceof promiseBasedTask.Task) {
+      this.value.destructor();
+    }
+  }
+  unwrap() {
+    return this.value;
+  }
+  createSnapshot() {
+    return {
+      value: this.value
+    };
+  }
+  loadSnapshot(snapshot) {
+    Object.assign(this, snapshot);
+  }
+};
+class SlidingCache extends base_cjs.BaseCache {
+  static {
+    __name(this, "SlidingCache");
+  }
+  provider;
+  constructor(input) {
+    super();
+    this.provider = new promiseBasedTask.SlidingTaskMap(input.size, input.ttl);
+  }
+  static {
+    this.register();
+  }
+  async get(key) {
+    const value = this.provider.get(key);
+    return value?.unwrap?.();
+  }
+  async has(key) {
+    return this.provider.has(key);
+  }
+  async clear() {
+    this.provider.clear();
+  }
+  async delete(key) {
+    return this.provider.delete(key);
+  }
+  async set(key, value) {
+    this.provider.set(key, new SlidingCacheEntry(value));
+  }
+  async size() {
+    return this.provider.size;
+  }
+  createSnapshot() {
+    return {
+      enabled: this.enabled,
+      provider: this.provider
+    };
+  }
+  loadSnapshot(snapshot) {
+    Object.assign(this, snapshot);
+  }
+}
+
+exports.SlidingCache = SlidingCache;
+//# sourceMappingURL=slidingCache.cjs.map
+//# sourceMappingURL=slidingCache.cjs.map

package/dist/cache/slidingCache.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/cache/slidingCache.ts"],"names":["SlidingCacheEntry","Serializable","constructor","value","register","destructor","Task","unwrap","createSnapshot","loadSnapshot","snapshot","Object","assign","SlidingCache","BaseCache","provider","input","SlidingTaskMap","size","ttl","get","key","has","clear","delete","set","enabled"],"mappings":";;;;;;;;AAyBA,IAAMA,iBAAAA,GAAN,MAAMA,kBAAAA,SAA6BC,6BAAAA,CAAAA;EAzBnC;;;;AA0BEC,EAAAA,WAAAA,CAA+BC,KAAU,EAAA;AACvC,IAAK,KAAA,EAAA,EAAA,KADwBA,KAAAA,GAAAA,KAAAA;AAE/B;EAEA;AACE,IAAA,IAAA,CAAKC,QAAQ,EAAA;AACf;EAEAC,UAAa,GAAA;AACX,IAAI,IAAA,IAAA,CAAKF,iBAAiBG,qBAAM,EAAA;AAC9B,MAAA,IAAA,CAAKH,MAAME,UAAU,EAAA;AACvB;AACF;EAEAE,MAAY,GAAA;AACV,IAAA,OAAO,IAAKJ,CAAAA,KAAAA;AACd;EAEAK,cAAiB,GAAA;AACf,IAAO,OAAA;AAAEL,MAAAA,KAAAA,EAAO,IAAKA,CAAAA;AAAM,KAAA;AAC7B;AAEAM,EAAAA,YAAAA,CAAaC,QAAkD,EAAA;AAC7DC,IAAOC,MAAAA,CAAAA,MAAAA,CAAO,MAAMF,QAAAA,CAAAA;AACtB;AACF,CAAA;AAEO,MAAMG,qBAAwBC,kBAAAA,CAAAA;EArDrC;;;AAsDqBC,EAAAA,QAAAA;AAEnBb,EAAAA,WAAAA,CAAYc,KAA0B,EAAA;AACpC,IAAK,KAAA,EAAA;AACL,IAAA,IAAA,CAAKD,WAAW,IAAIE,+BAAAA,CAA6CD,KAAME,CAAAA,IAAAA,EAAMF,MAAMG,GAAG,CAAA;AACxF;EAEA;AACE,IAAA,IAAA,CAAKf,QAAQ,EAAA;AACf;AAEA,EAAA,MAAMgB,IAAIC,GAAa,EAAA;AACrB,IAAA,MAAMlB,KAAQ,GAAA,IAAA,CAAKY,QAASK,CAAAA,GAAAA,CAAIC,GAAAA,CAAAA;AAChC,IAAA,OAAOlB,OAAOI,MAAAA,IAAAA;AAChB;AAEA,EAAA,MAAMe,IAAID,GAAa,EAAA;AACrB,IAAO,OAAA,IAAA,CAAKN,QAASO,CAAAA,GAAAA,CAAID,GAAAA,CAAAA;AAC3B;AAEA,EAAA,MAAME,KAAQ,GAAA;AACZ,IAAA,IAAA,CAAKR,SAASQ,KAAK,EAAA;AACrB;AAEA,EAAA,MAAMC,OAAOH,GAAa,EAAA;AACxB,IAAO,OAAA,IAAA,CAAKN,QAASS,CAAAA,MAAAA,CAAOH,GAAAA,CAAAA;AAC9B;EAEA,MAAMI,GAAAA,CAAIJ,KAAalB,KAAU,EAAA;AAC/B,IAAA,IAAA,CAAKY,SAASU,GAAIJ,CAAAA,GAAAA,EAAK,IAAIrB,iBAAAA,CAAkBG,KAAAA,CAAAA,CAAAA;AAC/C;AAEA,EAAA,MAAMe,IAAO,GAAA;AACX,IAAA,OAAO,KAAKH,QAASG,CAAAA,IAAAA;AACvB;EAEAV,cAAiB,GAAA;AACf,IAAO,OAAA;AACLkB,MAAAA,OAAAA,EAAS,IAAKA,CAAAA,OAAAA;AACdX,MAAAA,QAAAA,EAAU,IAAKA,CAAAA;AACjB,KAAA;AACF;AAEAN,EAAAA,YAAAA,CAAaC,QAAkD,EAAA;AAC7DC,IAAOC,MAAAA,CAAAA,MAAAA,CAAO,MAAMF,QAAAA,CAAAA;AACtB;AACF","file":"slidingCache.cjs","sourcesContent":["/**\n * Copyright 2025 IBM Corp.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { SlidingTaskMap, Task } from \"promise-based-task\";\nimport { BaseCache } from \"@/cache/base.js\";\nimport { Serializable } from \"@/internals/serializable.js\";\n\nexport interface SlidingCacheInput {\n  size: number;\n  ttl?: number;\n}\n\nclass SlidingCacheEntry<T> extends Serializable {\n  constructor(protected readonly value: T) {\n    super();\n  }\n\n  static {\n    this.register();\n  }\n\n  destructor() {\n    if (this.value instanceof Task) {\n      this.value.destructor();\n    }\n  }\n\n  unwrap(): T {\n    return this.value;\n  }\n\n  createSnapshot() {\n    return { value: this.value };\n  }\n\n  loadSnapshot(snapshot: ReturnType<typeof this.createSnapshot>) {\n    Object.assign(this, snapshot);\n  }\n}\n\nexport class SlidingCache<T> extends BaseCache<T> {\n  protected readonly provider;\n\n  constructor(input: SlidingCacheInput) {\n    super();\n    this.provider = new SlidingTaskMap<string, SlidingCacheEntry<T>>(input.size, input.ttl);\n  }\n\n  static {\n    this.register();\n  }\n\n  async get(key: string) {\n    const value = this.provider.get(key);\n    return value?.unwrap?.();\n  }\n\n  async has(key: string) {\n    return this.provider.has(key);\n  }\n\n  async clear() {\n    this.provider.clear();\n  }\n\n  async delete(key: string) {\n    return this.provider.delete(key);\n  }\n\n  async set(key: string, value: T) {\n    this.provider.set(key, new SlidingCacheEntry(value));\n  }\n\n  async size() {\n    return this.provider.size;\n  }\n\n  createSnapshot() {\n    return {\n      enabled: this.enabled,\n      provider: this.provider,\n    };\n  }\n\n  loadSnapshot(snapshot: ReturnType<typeof this.createSnapshot>) {\n    Object.assign(this, snapshot);\n  }\n}\n"]}

package/dist/cache/slidingCache.d.cts

@@ -0,0 +1,53 @@
+import { SlidingTaskMap } from 'promise-based-task';
+import { BaseCache } from './base.cjs';
+import { Serializable } from '../internals/serializable.cjs';
+import '../internals/types.cjs';
+import '../internals/helpers/guards.cjs';
+
+/**
+ * Copyright 2025 IBM Corp.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+interface SlidingCacheInput {
+    size: number;
+    ttl?: number;
+}
+declare class SlidingCacheEntry<T> extends Serializable {
+    protected readonly value: T;
+    constructor(value: T);
+    destructor(): void;
+    unwrap(): T;
+    createSnapshot(): {
+        value: T;
+    };
+    loadSnapshot(snapshot: ReturnType<typeof this.createSnapshot>): void;
+}
+declare class SlidingCache<T> extends BaseCache<T> {
+    protected readonly provider: SlidingTaskMap<string, SlidingCacheEntry<T>>;
+    constructor(input: SlidingCacheInput);
+    get(key: string): Promise<T | undefined>;
+    has(key: string): Promise<boolean>;
+    clear(): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    set(key: string, value: T): Promise<void>;
+    size(): Promise<number>;
+    createSnapshot(): {
+        enabled: boolean;
+        provider: SlidingTaskMap<string, SlidingCacheEntry<T>>;
+    };
+    loadSnapshot(snapshot: ReturnType<typeof this.createSnapshot>): void;
+}
+
+export { SlidingCache, type SlidingCacheInput };

package/dist/cache/slidingCache.d.ts

@@ -0,0 +1,53 @@
+import { SlidingTaskMap } from 'promise-based-task';
+import { BaseCache } from './base.js';
+import { Serializable } from '../internals/serializable.js';
+import '../internals/types.js';
+import '../internals/helpers/guards.js';
+
+/**
+ * Copyright 2025 IBM Corp.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+interface SlidingCacheInput {
+    size: number;
+    ttl?: number;
+}
+declare class SlidingCacheEntry<T> extends Serializable {
+    protected readonly value: T;
+    constructor(value: T);
+    destructor(): void;
+    unwrap(): T;
+    createSnapshot(): {
+        value: T;
+    };
+    loadSnapshot(snapshot: ReturnType<typeof this.createSnapshot>): void;
+}
+declare class SlidingCache<T> extends BaseCache<T> {
+    protected readonly provider: SlidingTaskMap<string, SlidingCacheEntry<T>>;
+    constructor(input: SlidingCacheInput);
+    get(key: string): Promise<T | undefined>;
+    has(key: string): Promise<boolean>;
+    clear(): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    set(key: string, value: T): Promise<void>;
+    size(): Promise<number>;
+    createSnapshot(): {
+        enabled: boolean;
+        provider: SlidingTaskMap<string, SlidingCacheEntry<T>>;
+    };
+    loadSnapshot(snapshot: ReturnType<typeof this.createSnapshot>): void;
+}
+
+export { SlidingCache, type SlidingCacheInput };

package/dist/cache/slidingCache.js

@@ -0,0 +1,79 @@
+import { Task, SlidingTaskMap } from 'promise-based-task';
+import { BaseCache } from './base.js';
+import { Serializable } from '../internals/serializable.js';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+let SlidingCacheEntry = class SlidingCacheEntry2 extends Serializable {
+  static {
+    __name(this, "SlidingCacheEntry");
+  }
+  value;
+  constructor(value) {
+    super(), this.value = value;
+  }
+  static {
+    this.register();
+  }
+  destructor() {
+    if (this.value instanceof Task) {
+      this.value.destructor();
+    }
+  }
+  unwrap() {
+    return this.value;
+  }
+  createSnapshot() {
+    return {
+      value: this.value
+    };
+  }
+  loadSnapshot(snapshot) {
+    Object.assign(this, snapshot);
+  }
+};
+class SlidingCache extends BaseCache {
+  static {
+    __name(this, "SlidingCache");
+  }
+  provider;
+  constructor(input) {
+    super();
+    this.provider = new SlidingTaskMap(input.size, input.ttl);
+  }
+  static {
+    this.register();
+  }
+  async get(key) {
+    const value = this.provider.get(key);
+    return value?.unwrap?.();
+  }
+  async has(key) {
+    return this.provider.has(key);
+  }
+  async clear() {
+    this.provider.clear();
+  }
+  async delete(key) {
+    return this.provider.delete(key);
+  }
+  async set(key, value) {
+    this.provider.set(key, new SlidingCacheEntry(value));
+  }
+  async size() {
+    return this.provider.size;
+  }
+  createSnapshot() {
+    return {
+      enabled: this.enabled,
+      provider: this.provider
+    };
+  }
+  loadSnapshot(snapshot) {
+    Object.assign(this, snapshot);
+  }
+}
+
+export { SlidingCache };
+//# sourceMappingURL=slidingCache.js.map
+//# sourceMappingURL=slidingCache.js.map