@fjell/cache 4.6.22 → 4.7.0

package/dist/memory/EnhancedMemoryCacheMap.d.ts

@@ -0,0 +1,75 @@
+import { AllItemTypeArrays, ComKey, Item, ItemQuery, LocKeyArray, PriKey } from "@fjell/core";
+import { CacheMap } from "../CacheMap";
+import { CacheSizeConfig } from "../Options";
+/**
+ * Enhanced in-memory implementation of CacheMap with size limits and eviction policies.
+ * Supports byte-based and item-count limits with configurable eviction strategies.
+ */
+export declare class EnhancedMemoryCacheMap<V extends Item<S, L1, L2, L3, L4, L5>, S extends string, L1 extends string = never, L2 extends string = never, L3 extends string = never, L4 extends string = never, L5 extends string = never> extends CacheMap<V, S, L1, L2, L3, L4, L5> {
+    private map;
+    private normalizedHashFunction;
+    private queryResultCache;
+    private ttlOperationsInProgress;
+    private currentSizeBytes;
+    private currentItemCount;
+    private queryResultsCacheSize;
+    private readonly maxSizeBytes?;
+    private readonly maxItems?;
+    private readonly evictionStrategy;
+    constructor(types: AllItemTypeArrays<S, L1, L2, L3, L4, L5>, sizeConfig?: CacheSizeConfig, initialData?: {
+        [key: string]: V;
+    });
+    get(key: ComKey<S, L1, L2, L3, L4, L5> | PriKey<S>): V | null;
+    getWithTTL(key: ComKey<S, L1, L2, L3, L4, L5> | PriKey<S>, ttl: number): V | null;
+    set(key: ComKey<S, L1, L2, L3, L4, L5> | PriKey<S>, value: V): void;
+    includesKey(key: ComKey<S, L1, L2, L3, L4, L5> | PriKey<S>): boolean;
+    delete(key: ComKey<S, L1, L2, L3, L4, L5> | PriKey<S>): void;
+    keys(): (ComKey<S, L1, L2, L3, L4, L5> | PriKey<S>)[];
+    values(): V[];
+    clear(): void;
+    allIn(locations: LocKeyArray<L1, L2, L3, L4, L5> | []): V[];
+    contains(query: ItemQuery, locations: LocKeyArray<L1, L2, L3, L4, L5> | []): boolean;
+    queryIn(query: ItemQuery, locations?: LocKeyArray<L1, L2, L3, L4, L5> | []): V[];
+    clone(): EnhancedMemoryCacheMap<V, S, L1, L2, L3, L4, L5>;
+    /**
+     * Get current cache statistics
+     */
+    getStats(): {
+        currentSizeBytes: number;
+        currentItemCount: number;
+        maxSizeBytes?: number;
+        maxItems?: number;
+        utilizationPercent: {
+            bytes?: number;
+            items?: number;
+        };
+    };
+    /**
+     * Ensure there's space available for a new item of the given size
+     * Evicts items if necessary based on the configured eviction policy
+     */
+    private ensureSpaceAvailable;
+    /**
+     * Evict a specific item and update metadata tracking
+     */
+    private evictItem;
+    setQueryResult(queryHash: string, itemKeys: (ComKey<S, L1, L2, L3, L4, L5> | PriKey<S>)[], ttl?: number): void;
+    getQueryResult(queryHash: string): (ComKey<S, L1, L2, L3, L4, L5> | PriKey<S>)[] | null;
+    hasQueryResult(queryHash: string): boolean;
+    deleteQueryResult(queryHash: string): void;
+    clearQueryResults(): void;
+    invalidateItemKeys(keys: (ComKey<S, L1, L2, L3, L4, L5> | PriKey<S>)[]): void;
+    invalidateLocation(locations: LocKeyArray<L1, L2, L3, L4, L5> | []): void;
+    /**
+     * Add query result to size tracking
+     */
+    private addQueryResultToSizeTracking;
+    /**
+     * Remove query result from size tracking
+     */
+    private removeQueryResultFromSizeTracking;
+    /**
+     * Get total cache size including query results
+     */
+    getTotalSizeBytes(): number;
+}

package/dist/memory/MemoryCacheMap.d.ts

@@ -0,0 +1,33 @@
+import { AllItemTypeArrays, ComKey, Item, ItemQuery, LocKeyArray, PriKey } from "@fjell/core";
+import { CacheMap } from "../CacheMap";
+/**
+ * In-memory implementation of CacheMap using a plain object as the underlying storage.
+ * This implementation stores all data in memory and will be lost when the application restarts.
+ */
+export declare class MemoryCacheMap<V extends Item<S, L1, L2, L3, L4, L5>, S extends string, L1 extends string = never, L2 extends string = never, L3 extends string = never, L4 extends string = never, L5 extends string = never> extends CacheMap<V, S, L1, L2, L3, L4, L5> {
+    private map;
+    private normalizedHashFunction;
+    private queryResultCache;
+    constructor(types: AllItemTypeArrays<S, L1, L2, L3, L4, L5>, initialData?: {
+        [key: string]: V;
+    });
+    get(key: ComKey<S, L1, L2, L3, L4, L5> | PriKey<S>): V | null;
+    getWithTTL(key: ComKey<S, L1, L2, L3, L4, L5> | PriKey<S>, ttl: number): V | null;
+    set(key: ComKey<S, L1, L2, L3, L4, L5> | PriKey<S>, value: V): void;
+    includesKey(key: ComKey<S, L1, L2, L3, L4, L5> | PriKey<S>): boolean;
+    delete(key: ComKey<S, L1, L2, L3, L4, L5> | PriKey<S>): void;
+    keys(): (ComKey<S, L1, L2, L3, L4, L5> | PriKey<S>)[];
+    values(): V[];
+    clear(): void;
+    allIn(locations: LocKeyArray<L1, L2, L3, L4, L5> | []): V[];
+    contains(query: ItemQuery, locations: LocKeyArray<L1, L2, L3, L4, L5> | []): boolean;
+    queryIn(query: ItemQuery, locations?: LocKeyArray<L1, L2, L3, L4, L5> | []): V[];
+    clone(): MemoryCacheMap<V, S, L1, L2, L3, L4, L5>;
+    setQueryResult(queryHash: string, itemKeys: (ComKey<S, L1, L2, L3, L4, L5> | PriKey<S>)[], ttl?: number): void;
+    getQueryResult(queryHash: string): (ComKey<S, L1, L2, L3, L4, L5> | PriKey<S>)[] | null;
+    hasQueryResult(queryHash: string): boolean;
+    deleteQueryResult(queryHash: string): void;
+    invalidateItemKeys(keys: (ComKey<S, L1, L2, L3, L4, L5> | PriKey<S>)[]): void;
+    invalidateLocation(locations: LocKeyArray<L1, L2, L3, L4, L5> | []): void;
+    clearQueryResults(): void;
+}

package/dist/normalization.d.ts

@@ -0,0 +1,20 @@
+import { ItemQuery, LocKeyArray } from "@fjell/core";
+export declare const normalizeKeyValue: (value: string | number) => string;
+export declare const createNormalizedHashFunction: <T>() => (key: T) => string;
+export declare const isLocKeyArrayEqual: (a: any[], b: any[]) => boolean;
+export declare const normalizeLocKeyItem: (item: any) => any;
+/**
+ * Interface for storing query results with expiration
+ */
+export interface QueryCacheEntry {
+    itemKeys: (any)[];
+    expiresAt?: number;
+}
+/**
+ * Generate a safe hash for all/one query parameters
+ */
+export declare const createQueryHash: <S extends string, L1 extends string = never, L2 extends string = never, L3 extends string = never, L4 extends string = never, L5 extends string = never>(pkType: S, query: ItemQuery, locations: LocKeyArray<L1, L2, L3, L4, L5> | []) => string;
+/**
+ * Generate a safe hash for find/findOne query parameters
+ */
+export declare const createFinderHash: <L1 extends string = never, L2 extends string = never, L3 extends string = never, L4 extends string = never, L5 extends string = never>(finder: string, params: Record<string, string | number | boolean | Date | Array<string | number | boolean | Date>>, locations: LocKeyArray<L1, L2, L3, L4, L5> | []) => string;

package/dist/ops/action.d.ts

@@ -1,4 +1,3 @@
 import { ComKey, Item, PriKey } from "@fjell/core";
-import { ClientApi } from "@fjell/client-api";
-import { CacheMap } from "../CacheMap";
-export declare const action: <V extends Item<S, L1, L2, L3, L4, L5>, S extends string, L1 extends string = never, L2 extends string = never, L3 extends string = never, L4 extends string = never, L5 extends string = never>(api: ClientApi<V, S, L1, L2, L3, L4, L5>, cacheMap: CacheMap<V, S, L1, L2, L3, L4, L5>, pkType: S, key: ComKey<S, L1, L2, L3, L4, L5> | PriKey<S>, action: string, body?: any) => Promise<[CacheMap<V, S, L1, L2, L3, L4, L5>, V]>;
+import { CacheContext } from "../CacheContext";
+export declare const action: <V extends Item<S, L1, L2, L3, L4, L5>, S extends string, L1 extends string = never, L2 extends string = never, L3 extends string = never, L4 extends string = never, L5 extends string = never>(key: ComKey<S, L1, L2, L3, L4, L5> | PriKey<S>, action: string, body: any | undefined, context: CacheContext<V, S, L1, L2, L3, L4, L5>) => Promise<[CacheContext<V, S, L1, L2, L3, L4, L5>, V]>;

package/dist/ops/all.d.ts

@@ -1,4 +1,3 @@
 import { Item, ItemQuery, LocKeyArray } from "@fjell/core";
-import { ClientApi } from "@fjell/client-api";
-import { CacheMap } from "../CacheMap";
-export declare const all: <V extends Item<S, L1, L2, L3, L4, L5>, S extends string, L1 extends string = never, L2 extends string = never, L3 extends string = never, L4 extends string = never, L5 extends string = never>(api: ClientApi<V, S, L1, L2, L3, L4, L5>, cacheMap: CacheMap<V, S, L1, L2, L3, L4, L5>, pkType: S, query?: ItemQuery, locations?: LocKeyArray<L1, L2, L3, L4, L5> | []) => Promise<[CacheMap<V, S, L1, L2, L3, L4, L5>, V[]]>;
+import { CacheContext } from "../CacheContext";
+export declare const all: <V extends Item<S, L1, L2, L3, L4, L5>, S extends string, L1 extends string = never, L2 extends string = never, L3 extends string = never, L4 extends string = never, L5 extends string = never>(query: ItemQuery | undefined, locations: (LocKeyArray<L1, L2, L3, L4, L5> | []) | undefined, context: CacheContext<V, S, L1, L2, L3, L4, L5>) => Promise<[CacheContext<V, S, L1, L2, L3, L4, L5>, V[]]>;

package/dist/ops/allAction.d.ts

@@ -1,4 +1,3 @@
 import { Item, LocKeyArray } from "@fjell/core";
-import { ClientApi } from "@fjell/client-api";
-import { CacheMap } from "../CacheMap";
-export declare const allAction: <V extends Item<S, L1, L2, L3, L4, L5>, S extends string, L1 extends string = never, L2 extends string = never, L3 extends string = never, L4 extends string = never, L5 extends string = never>(api: ClientApi<V, S, L1, L2, L3, L4, L5>, cacheMap: CacheMap<V, S, L1, L2, L3, L4, L5>, pkType: S, action: string, body?: any, locations?: LocKeyArray<L1, L2, L3, L4, L5> | []) => Promise<[CacheMap<V, S, L1, L2, L3, L4, L5>, V[]]>;
+import { CacheContext } from "../CacheContext";
+export declare const allAction: <V extends Item<S, L1, L2, L3, L4, L5>, S extends string, L1 extends string = never, L2 extends string = never, L3 extends string = never, L4 extends string = never, L5 extends string = never>(action: string, body: any | undefined, locations: (LocKeyArray<L1, L2, L3, L4, L5> | []) | undefined, context: CacheContext<V, S, L1, L2, L3, L4, L5>) => Promise<[CacheContext<V, S, L1, L2, L3, L4, L5>, V[]]>;

package/dist/ops/allFacet.d.ts

@@ -1,4 +1,3 @@
 import { Item, LocKeyArray } from "@fjell/core";
-import { ClientApi } from "@fjell/client-api";
-import { CacheMap } from "../CacheMap";
-export declare const allFacet: <V extends Item<S, L1, L2, L3, L4, L5>, S extends string, L1 extends string = never, L2 extends string = never, L3 extends string = never, L4 extends string = never, L5 extends string = never>(api: ClientApi<V, S, L1, L2, L3, L4, L5>, cacheMap: CacheMap<V, S, L1, L2, L3, L4, L5>, facet: string, params?: Record<string, string | number | boolean | Date | Array<string | number | boolean | Date>>, locations?: LocKeyArray<L1, L2, L3, L4, L5> | []) => Promise<[CacheMap<V, S, L1, L2, L3, L4, L5>, any]>;
+import { CacheContext } from "../CacheContext";
+export declare const allFacet: <V extends Item<S, L1, L2, L3, L4, L5>, S extends string, L1 extends string = never, L2 extends string = never, L3 extends string = never, L4 extends string = never, L5 extends string = never>(facet: string, params: Record<string, string | number | boolean | Date | Array<string | number | boolean | Date>> | undefined, locations: (LocKeyArray<L1, L2, L3, L4, L5> | []) | undefined, context: CacheContext<V, S, L1, L2, L3, L4, L5>) => Promise<any>;

package/dist/ops/create.d.ts

@@ -1,4 +1,3 @@
 import { Item, LocKeyArray } from "@fjell/core";
-import { ClientApi } from "@fjell/client-api";
-import { CacheMap } from "../CacheMap";
-export declare const create: <V extends Item<S, L1, L2, L3, L4, L5>, S extends string, L1 extends string = never, L2 extends string = never, L3 extends string = never, L4 extends string = never, L5 extends string = never>(api: ClientApi<V, S, L1, L2, L3, L4, L5>, cacheMap: CacheMap<V, S, L1, L2, L3, L4, L5>, pkType: S, v: Partial<Item<S, L1, L2, L3, L4, L5>>, locations?: LocKeyArray<L1, L2, L3, L4, L5> | []) => Promise<[CacheMap<V, S, L1, L2, L3, L4, L5>, V]>;
+import { CacheContext } from "../CacheContext";
+export declare const create: <V extends Item<S, L1, L2, L3, L4, L5>, S extends string, L1 extends string = never, L2 extends string = never, L3 extends string = never, L4 extends string = never, L5 extends string = never>(v: Partial<Item<S, L1, L2, L3, L4, L5>>, locations: (LocKeyArray<L1, L2, L3, L4, L5> | []) | undefined, context: CacheContext<V, S, L1, L2, L3, L4, L5>) => Promise<[CacheContext<V, S, L1, L2, L3, L4, L5>, V]>;

package/dist/ops/facet.d.ts

@@ -1,4 +1,3 @@
 import { ComKey, Item, PriKey } from "@fjell/core";
-import { ClientApi } from "@fjell/client-api";
-import { CacheMap } from "../CacheMap";
-export declare const facet: <V extends Item<S, L1, L2, L3, L4, L5>, S extends string, L1 extends string = never, L2 extends string = never, L3 extends string = never, L4 extends string = never, L5 extends string = never>(api: ClientApi<V, S, L1, L2, L3, L4, L5>, cacheMap: CacheMap<V, S, L1, L2, L3, L4, L5>, key: ComKey<S, L1, L2, L3, L4, L5> | PriKey<S>, facet: string, params?: Record<string, string | number | boolean | Date | Array<string | number | boolean | Date>>) => Promise<[CacheMap<V, S, L1, L2, L3, L4, L5>, any]>;
+import { CacheContext } from "../CacheContext";
+export declare const facet: <V extends Item<S, L1, L2, L3, L4, L5>, S extends string, L1 extends string = never, L2 extends string = never, L3 extends string = never, L4 extends string = never, L5 extends string = never>(key: ComKey<S, L1, L2, L3, L4, L5> | PriKey<S>, facet: string, params: Record<string, string | number | boolean | Date | Array<string | number | boolean | Date>> | undefined, context: CacheContext<V, S, L1, L2, L3, L4, L5>) => Promise<any>;

package/dist/ops/find.d.ts

@@ -1,4 +1,3 @@
 import { Item, LocKeyArray } from "@fjell/core";
-import { ClientApi } from "@fjell/client-api";
-import { CacheMap } from "../CacheMap";
-export declare const find: <V extends Item<S, L1, L2, L3, L4, L5>, S extends string, L1 extends string = never, L2 extends string = never, L3 extends string = never, L4 extends string = never, L5 extends string = never>(api: ClientApi<V, S, L1, L2, L3, L4, L5>, cacheMap: CacheMap<V, S, L1, L2, L3, L4, L5>, pkType: S, finder: string, params?: Record<string, string | number | boolean | Date | Array<string | number | boolean | Date>>, locations?: LocKeyArray<L1, L2, L3, L4, L5> | []) => Promise<[CacheMap<V, S, L1, L2, L3, L4, L5>, V[]]>;
+import { CacheContext } from "../CacheContext";
+export declare const find: <V extends Item<S, L1, L2, L3, L4, L5>, S extends string, L1 extends string = never, L2 extends string = never, L3 extends string = never, L4 extends string = never, L5 extends string = never>(finder: string, params: Record<string, string | number | boolean | Date | Array<string | number | boolean | Date>> | undefined, locations: (LocKeyArray<L1, L2, L3, L4, L5> | []) | undefined, context: CacheContext<V, S, L1, L2, L3, L4, L5>) => Promise<[CacheContext<V, S, L1, L2, L3, L4, L5>, V[]]>;

package/dist/ops/findOne.d.ts

@@ -1,4 +1,3 @@
 import { Item, LocKeyArray } from "@fjell/core";
-import { ClientApi } from "@fjell/client-api";
-import { CacheMap } from "../CacheMap";
-export declare const findOne: <V extends Item<S, L1, L2, L3, L4, L5>, S extends string, L1 extends string = never, L2 extends string = never, L3 extends string = never, L4 extends string = never, L5 extends string = never>(api: ClientApi<V, S, L1, L2, L3, L4, L5>, cacheMap: CacheMap<V, S, L1, L2, L3, L4, L5>, pkType: S, finder: string, finderParams?: Record<string, string | number | boolean | Date | Array<string | number | boolean | Date>>, locations?: LocKeyArray<L1, L2, L3, L4, L5> | []) => Promise<[CacheMap<V, S, L1, L2, L3, L4, L5>, V]>;
+import { CacheContext } from "../CacheContext";
+export declare const findOne: <V extends Item<S, L1, L2, L3, L4, L5>, S extends string, L1 extends string = never, L2 extends string = never, L3 extends string = never, L4 extends string = never, L5 extends string = never>(finder: string, finderParams: Record<string, string | number | boolean | Date | Array<string | number | boolean | Date>> | undefined, locations: (LocKeyArray<L1, L2, L3, L4, L5> | []) | undefined, context: CacheContext<V, S, L1, L2, L3, L4, L5>) => Promise<[CacheContext<V, S, L1, L2, L3, L4, L5>, V]>;

package/dist/ops/get.d.ts

@@ -1,4 +1,3 @@
 import { ComKey, Item, PriKey } from "@fjell/core";
-import { ClientApi } from "@fjell/client-api";
-import { CacheMap } from "../CacheMap";
-export declare const get: <V extends Item<S, L1, L2, L3, L4, L5>, S extends string, L1 extends string = never, L2 extends string = never, L3 extends string = never, L4 extends string = never, L5 extends string = never>(api: ClientApi<V, S, L1, L2, L3, L4, L5>, cacheMap: CacheMap<V, S, L1, L2, L3, L4, L5>, pkType: S, key: ComKey<S, L1, L2, L3, L4, L5> | PriKey<S>) => Promise<[CacheMap<V, S, L1, L2, L3, L4, L5>, V | null]>;
+import { CacheContext } from "../CacheContext";
+export declare const get: <V extends Item<S, L1, L2, L3, L4, L5>, S extends string, L1 extends string = never, L2 extends string = never, L3 extends string = never, L4 extends string = never, L5 extends string = never>(key: ComKey<S, L1, L2, L3, L4, L5> | PriKey<S>, context: CacheContext<V, S, L1, L2, L3, L4, L5>) => Promise<[CacheContext<V, S, L1, L2, L3, L4, L5>, V | null]>;

package/dist/ops/one.d.ts

@@ -1,4 +1,3 @@
 import { Item, ItemQuery, LocKeyArray } from "@fjell/core";
-import { ClientApi } from "@fjell/client-api";
-import { CacheMap } from "../CacheMap";
-export declare const one: <V extends Item<S, L1, L2, L3, L4, L5>, S extends string, L1 extends string = never, L2 extends string = never, L3 extends string = never, L4 extends string = never, L5 extends string = never>(api: ClientApi<V, S, L1, L2, L3, L4, L5>, cacheMap: CacheMap<V, S, L1, L2, L3, L4, L5>, pkType: S, query?: ItemQuery, locations?: LocKeyArray<L1, L2, L3, L4, L5> | []) => Promise<[CacheMap<V, S, L1, L2, L3, L4, L5>, V | null]>;
+import { CacheContext } from "../CacheContext";
+export declare const one: <V extends Item<S, L1, L2, L3, L4, L5>, S extends string, L1 extends string = never, L2 extends string = never, L3 extends string = never, L4 extends string = never, L5 extends string = never>(query: ItemQuery | undefined, locations: (LocKeyArray<L1, L2, L3, L4, L5> | []) | undefined, context: CacheContext<V, S, L1, L2, L3, L4, L5>) => Promise<[CacheContext<V, S, L1, L2, L3, L4, L5>, V | null]>;

package/dist/ops/remove.d.ts

@@ -1,4 +1,3 @@
 import { ComKey, Item, PriKey } from "@fjell/core";
-import { ClientApi } from "@fjell/client-api";
-import { CacheMap } from "../CacheMap";
-export declare const remove: <V extends Item<S, L1, L2, L3, L4, L5>, S extends string, L1 extends string = never, L2 extends string = never, L3 extends string = never, L4 extends string = never, L5 extends string = never>(api: ClientApi<V, S, L1, L2, L3, L4, L5>, cacheMap: CacheMap<V, S, L1, L2, L3, L4, L5>, key: ComKey<S, L1, L2, L3, L4, L5> | PriKey<S>) => Promise<CacheMap<V, S, L1, L2, L3, L4, L5>>;
+import { CacheContext } from "../CacheContext";
+export declare const remove: <V extends Item<S, L1, L2, L3, L4, L5>, S extends string, L1 extends string = never, L2 extends string = never, L3 extends string = never, L4 extends string = never, L5 extends string = never>(key: ComKey<S, L1, L2, L3, L4, L5> | PriKey<S>, context: CacheContext<V, S, L1, L2, L3, L4, L5>) => Promise<CacheContext<V, S, L1, L2, L3, L4, L5>>;

package/dist/ops/reset.d.ts

@@ -1,4 +1,5 @@
 import { Item } from "@fjell/core";
 import { CacheMap } from "../CacheMap";
+import { Options } from "../Options";
 import { Coordinate } from "@fjell/registry";
-export declare const reset: <V extends Item<S, L1, L2, L3, L4, L5>, S extends string, L1 extends string = never, L2 extends string = never, L3 extends string = never, L4 extends string = never, L5 extends string = never>(coordinate: Coordinate<S, L1, L2, L3, L4, L5>) => Promise<[CacheMap<V, S, L1, L2, L3, L4, L5>]>;
+export declare const reset: <V extends Item<S, L1, L2, L3, L4, L5>, S extends string, L1 extends string = never, L2 extends string = never, L3 extends string = never, L4 extends string = never, L5 extends string = never>(coordinate: Coordinate<S, L1, L2, L3, L4, L5>, options: Options<V, S, L1, L2, L3, L4, L5>) => Promise<[CacheMap<V, S, L1, L2, L3, L4, L5>]>;

package/dist/ops/retrieve.d.ts

@@ -1,4 +1,3 @@
 import { ComKey, Item, PriKey } from "@fjell/core";
-import { CacheMap } from "../CacheMap";
-import { ClientApi } from "@fjell/client-api";
-export declare const retrieve: <V extends Item<S, L1, L2, L3, L4, L5>, S extends string, L1 extends string = never, L2 extends string = never, L3 extends string = never, L4 extends string = never, L5 extends string = never>(api: ClientApi<V, S, L1, L2, L3, L4, L5>, cacheMap: CacheMap<V, S, L1, L2, L3, L4, L5>, pkType: S, key: ComKey<S, L1, L2, L3, L4, L5> | PriKey<S>) => Promise<[CacheMap<V, S, L1, L2, L3, L4, L5> | null, V | null]>;
+import { CacheContext } from "../CacheContext";
+export declare const retrieve: <V extends Item<S, L1, L2, L3, L4, L5>, S extends string, L1 extends string = never, L2 extends string = never, L3 extends string = never, L4 extends string = never, L5 extends string = never>(key: ComKey<S, L1, L2, L3, L4, L5> | PriKey<S>, context: CacheContext<V, S, L1, L2, L3, L4, L5>) => Promise<[CacheContext<V, S, L1, L2, L3, L4, L5> | null, V | null]>;

package/dist/ops/set.d.ts

@@ -1,3 +1,3 @@
 import { ComKey, Item, PriKey } from "@fjell/core";
-import { CacheMap } from "../CacheMap";
-export declare const set: <V extends Item<S, L1, L2, L3, L4, L5>, S extends string, L1 extends string = never, L2 extends string = never, L3 extends string = never, L4 extends string = never, L5 extends string = never>(cacheMap: CacheMap<V, S, L1, L2, L3, L4, L5>, pkType: S, key: ComKey<S, L1, L2, L3, L4, L5> | PriKey<S>, v: Item<S, L1, L2, L3, L4, L5>) => Promise<[CacheMap<V, S, L1, L2, L3, L4, L5>, V]>;
+import { CacheContext } from "../CacheContext";
+export declare const set: <V extends Item<S, L1, L2, L3, L4, L5>, S extends string, L1 extends string = never, L2 extends string = never, L3 extends string = never, L4 extends string = never, L5 extends string = never>(key: ComKey<S, L1, L2, L3, L4, L5> | PriKey<S>, v: Item<S, L1, L2, L3, L4, L5>, context: CacheContext<V, S, L1, L2, L3, L4, L5>) => Promise<[CacheContext<V, S, L1, L2, L3, L4, L5>, V]>;

package/dist/ops/update.d.ts

@@ -1,4 +1,3 @@
 import { ComKey, Item, PriKey } from "@fjell/core";
-import { ClientApi } from "@fjell/client-api";
-import { CacheMap } from "../CacheMap";
-export declare const update: <V extends Item<S, L1, L2, L3, L4, L5>, S extends string, L1 extends string = never, L2 extends string = never, L3 extends string = never, L4 extends string = never, L5 extends string = never>(api: ClientApi<V, S, L1, L2, L3, L4, L5>, cacheMap: CacheMap<V, S, L1, L2, L3, L4, L5>, pkType: S, key: ComKey<S, L1, L2, L3, L4, L5> | PriKey<S>, v: Partial<Item<S, L1, L2, L3, L4, L5>>) => Promise<[CacheMap<V, S, L1, L2, L3, L4, L5>, V]>;
+import { CacheContext } from "../CacheContext";
+export declare const update: <V extends Item<S, L1, L2, L3, L4, L5>, S extends string, L1 extends string = never, L2 extends string = never, L3 extends string = never, L4 extends string = never, L5 extends string = never>(key: ComKey<S, L1, L2, L3, L4, L5> | PriKey<S>, v: Partial<Item<S, L1, L2, L3, L4, L5>>, context: CacheContext<V, S, L1, L2, L3, L4, L5>) => Promise<[CacheContext<V, S, L1, L2, L3, L4, L5>, V]>;

package/dist/utils/CacheSize.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Utility functions for parsing and managing cache sizes
+ */
+/**
+ * Parse a size string and return the size in bytes
+ *
+ * @param sizeStr - Size string (e.g., '300', '3kb', '5MB', '2GiB')
+ * @returns Size in bytes
+ * @throws Error if the size string is invalid
+ */
+export declare function parseSizeString(sizeStr: string): number;
+/**
+ * Format bytes as a human-readable string
+ *
+ * @param bytes - Size in bytes
+ * @param binary - Use binary units (1024) instead of decimal (1000)
+ * @returns Formatted size string
+ */
+export declare function formatBytes(bytes: number, binary?: boolean): string;
+/**
+ * Estimate the serialized size of a value in bytes
+ * This is an approximation for cache size calculations
+ *
+ * @param value - The value to estimate size for
+ * @returns Estimated size in bytes
+ */
+export declare function estimateValueSize(value: any): number;
+/**
+ * Check if a size configuration is valid
+ *
+ * @param config - Size configuration to validate
+ * @throws Error if configuration is invalid
+ */
+export declare function validateSizeConfig(config: {
+    maxSizeBytes?: string;
+    maxItems?: number;
+}): void;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fjell/cache",
   "description": "Cache for Fjell",
-  "version": "4.6.22",
+  "version": "4.7.0",
   "keywords": [
     "cache",
     "fjell"