@philiprehberger/cache-kit 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 philiprehberger
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -0,0 +1,217 @@
+'use strict';
+
+var __defProp = Object.defineProperty;
+var __defProps = Object.defineProperties;
+var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
+var __objRest = (source, exclude) => {
+  var target = {};
+  for (var prop in source)
+    if (__hasOwnProp.call(source, prop) && exclude.indexOf(prop) < 0)
+      target[prop] = source[prop];
+  if (source != null && __getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(source)) {
+      if (exclude.indexOf(prop) < 0 && __propIsEnum.call(source, prop))
+        target[prop] = source[prop];
+    }
+  return target;
+};
+
+// src/duration.ts
+var UNITS = {
+  ms: 1,
+  s: 1e3,
+  m: 60 * 1e3,
+  h: 60 * 60 * 1e3,
+  d: 24 * 60 * 60 * 1e3
+};
+var DURATION_RE = /^(\d+)(ms|s|m|h|d)$/;
+function parseDuration(value) {
+  if (typeof value === "number") return value;
+  const match = value.match(DURATION_RE);
+  if (!match) {
+    throw new Error(`Invalid duration: "${value}". Use format like "5m", "1h", "30s", "100ms", "1d"`);
+  }
+  return parseInt(match[1], 10) * UNITS[match[2]];
+}
+
+// src/cache.ts
+function createCache(options = {}) {
+  const { maxItems = Infinity } = options;
+  const defaultTTL = options.defaultTTL ? parseDuration(options.defaultTTL) : null;
+  const store = /* @__PURE__ */ new Map();
+  const tagIndex = /* @__PURE__ */ new Map();
+  let hits = 0;
+  let misses = 0;
+  function evictLRU() {
+    if (store.size <= maxItems) return;
+    const firstKey = store.keys().next().value;
+    if (firstKey !== void 0) {
+      deleteEntry(firstKey);
+    }
+  }
+  function deleteEntry(key) {
+    const entry = store.get(key);
+    if (entry) {
+      for (const tag of entry.tags) {
+        const keys = tagIndex.get(tag);
+        if (keys) {
+          keys.delete(key);
+          if (keys.size === 0) tagIndex.delete(tag);
+        }
+      }
+      store.delete(key);
+    }
+  }
+  function isExpired(entry) {
+    if (entry.expiresAt === null) return false;
+    return Date.now() > entry.expiresAt;
+  }
+  function isStale(entry) {
+    if (entry.staleAt === null) return false;
+    return Date.now() > entry.staleAt;
+  }
+  function set(key, value, opts) {
+    var _a;
+    deleteEntry(key);
+    const ttl = (opts == null ? void 0 : opts.ttl) ? parseDuration(opts.ttl) : defaultTTL;
+    const swr = (opts == null ? void 0 : opts.staleWhileRevalidate) ? parseDuration(opts.staleWhileRevalidate) : null;
+    const now = Date.now();
+    const tags = (_a = opts == null ? void 0 : opts.tags) != null ? _a : [];
+    const entry = {
+      value,
+      expiresAt: ttl ? now + ttl : null,
+      staleAt: ttl && swr ? now + ttl - swr : null,
+      tags
+    };
+    store.set(key, entry);
+    for (const tag of tags) {
+      let keys = tagIndex.get(tag);
+      if (!keys) {
+        keys = /* @__PURE__ */ new Set();
+        tagIndex.set(tag, keys);
+      }
+      keys.add(key);
+    }
+    evictLRU();
+  }
+  function get(key) {
+    const entry = store.get(key);
+    if (!entry) {
+      misses++;
+      return void 0;
+    }
+    if (isExpired(entry)) {
+      deleteEntry(key);
+      misses++;
+      return void 0;
+    }
+    hits++;
+    store.delete(key);
+    store.set(key, entry);
+    return entry.value;
+  }
+  function has(key) {
+    const entry = store.get(key);
+    if (!entry) return false;
+    if (isExpired(entry)) {
+      deleteEntry(key);
+      return false;
+    }
+    return true;
+  }
+  function del(key) {
+    if (!store.has(key)) return false;
+    deleteEntry(key);
+    return true;
+  }
+  function clear() {
+    store.clear();
+    tagIndex.clear();
+    hits = 0;
+    misses = 0;
+  }
+  function invalidateTag(tag) {
+    const keys = tagIndex.get(tag);
+    if (!keys) return 0;
+    const count = keys.size;
+    for (const key of [...keys]) {
+      deleteEntry(key);
+    }
+    return count;
+  }
+  function wrap(keyPrefix, fn, opts) {
+    const revalidating = /* @__PURE__ */ new Set();
+    return async (...args) => {
+      const cacheKey = `${keyPrefix}:${JSON.stringify(args)}`;
+      const entry = store.get(cacheKey);
+      if (entry && !isExpired(entry)) {
+        hits++;
+        store.delete(cacheKey);
+        store.set(cacheKey, entry);
+        if (isStale(entry) && !revalidating.has(cacheKey)) {
+          revalidating.add(cacheKey);
+          fn(...args).then((value2) => set(cacheKey, value2, opts)).catch(() => {
+          }).finally(() => revalidating.delete(cacheKey));
+        }
+        return entry.value;
+      }
+      misses++;
+      const value = await fn(...args);
+      set(cacheKey, value, opts);
+      return value;
+    };
+  }
+  function stats() {
+    const total = hits + misses;
+    return {
+      hits,
+      misses,
+      hitRate: total === 0 ? 0 : hits / total,
+      size: store.size
+    };
+  }
+  function dump() {
+    const entries = [];
+    for (const [key, entry] of store) {
+      entries.push([key, __spreadProps(__spreadValues({}, entry), { key })]);
+    }
+    return { entries };
+  }
+  function load(data) {
+    clear();
+    for (const [key, entry] of data.entries) {
+      const _a = entry, { key: _key } = _a, rest = __objRest(_a, ["key"]);
+      store.set(key, rest);
+      for (const tag of rest.tags) {
+        let keys = tagIndex.get(tag);
+        if (!keys) {
+          keys = /* @__PURE__ */ new Set();
+          tagIndex.set(tag, keys);
+        }
+        keys.add(key);
+      }
+    }
+  }
+  return { set, get, has, delete: del, clear, invalidateTag, wrap, stats, dump, load };
+}
+
+exports.createCache = createCache;
+exports.parseDuration = parseDuration;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/duration.ts","../src/cache.ts"],"names":["value"],"mappings":"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","file":"index.cjs","sourcesContent":["const UNITS: Record<string, number> = {\n  ms: 1,\n  s: 1000,\n  m: 60 * 1000,\n  h: 60 * 60 * 1000,\n  d: 24 * 60 * 60 * 1000,\n};\n\nconst DURATION_RE = /^(\\d+)(ms|s|m|h|d)$/;\n\nexport function parseDuration(value: string | number): number {\n  if (typeof value === 'number') return value;\n\n  const match = value.match(DURATION_RE);\n  if (!match) {\n    throw new Error(`Invalid duration: \"${value}\". Use format like \"5m\", \"1h\", \"30s\", \"100ms\", \"1d\"`);\n  }\n\n  return parseInt(match[1], 10) * UNITS[match[2]];\n}\n","import type { CacheOptions, SetOptions, WrapOptions, CacheStats, CacheEntry, SerializedCache } from './types.js';\nimport { parseDuration } from './duration.js';\n\nexport function createCache<V = unknown>(options: CacheOptions = {}) {\n  const { maxItems = Infinity } = options;\n  const defaultTTL = options.defaultTTL ? parseDuration(options.defaultTTL) : null;\n\n  const store = new Map<string, CacheEntry<V>>();\n  const tagIndex = new Map<string, Set<string>>();\n  let hits = 0;\n  let misses = 0;\n\n  function evictLRU(): void {\n    if (store.size <= maxItems) return;\n    const firstKey = store.keys().next().value;\n    if (firstKey !== undefined) {\n      deleteEntry(firstKey);\n    }\n  }\n\n  function deleteEntry(key: string): void {\n    const entry = store.get(key);\n    if (entry) {\n      for (const tag of entry.tags) {\n        const keys = tagIndex.get(tag);\n        if (keys) {\n          keys.delete(key);\n          if (keys.size === 0) tagIndex.delete(tag);\n        }\n      }\n      store.delete(key);\n    }\n  }\n\n  function isExpired(entry: CacheEntry<V>): boolean {\n    if (entry.expiresAt === null) return false;\n    return Date.now() > entry.expiresAt;\n  }\n\n  function isStale(entry: CacheEntry<V>): boolean {\n    if (entry.staleAt === null) return false;\n    return Date.now() > entry.staleAt;\n  }\n\n  function set(key: string, value: V, opts?: SetOptions): void {\n    deleteEntry(key);\n\n    const ttl = opts?.ttl ? parseDuration(opts.ttl) : defaultTTL;\n    const swr = opts?.staleWhileRevalidate ? parseDuration(opts.staleWhileRevalidate) : null;\n    const now = Date.now();\n    const tags = opts?.tags ?? [];\n\n    const entry: CacheEntry<V> = {\n      value,\n      expiresAt: ttl ? now + ttl : null,\n      staleAt: ttl && swr ? now + ttl - swr : null,\n      tags,\n    };\n\n    store.set(key, entry);\n\n    for (const tag of tags) {\n      let keys = tagIndex.get(tag);\n      if (!keys) {\n        keys = new Set();\n        tagIndex.set(tag, keys);\n      }\n      keys.add(key);\n    }\n\n    evictLRU();\n  }\n\n  function get(key: string): V | undefined {\n    const entry = store.get(key);\n    if (!entry) {\n      misses++;\n      return undefined;\n    }\n\n    if (isExpired(entry)) {\n      deleteEntry(key);\n      misses++;\n      return undefined;\n    }\n\n    hits++;\n    // Move to end for LRU\n    store.delete(key);\n    store.set(key, entry);\n\n    return entry.value;\n  }\n\n  function has(key: string): boolean {\n    const entry = store.get(key);\n    if (!entry) return false;\n    if (isExpired(entry)) {\n      deleteEntry(key);\n      return false;\n    }\n    return true;\n  }\n\n  function del(key: string): boolean {\n    if (!store.has(key)) return false;\n    deleteEntry(key);\n    return true;\n  }\n\n  function clear(): void {\n    store.clear();\n    tagIndex.clear();\n    hits = 0;\n    misses = 0;\n  }\n\n  function invalidateTag(tag: string): number {\n    const keys = tagIndex.get(tag);\n    if (!keys) return 0;\n    const count = keys.size;\n    for (const key of [...keys]) {\n      deleteEntry(key);\n    }\n    return count;\n  }\n\n  function wrap<TArgs extends unknown[], TReturn extends V>(\n    keyPrefix: string,\n    fn: (...args: TArgs) => Promise<TReturn>,\n    opts?: WrapOptions,\n  ): (...args: TArgs) => Promise<TReturn> {\n    const revalidating = new Set<string>();\n\n    return async (...args: TArgs): Promise<TReturn> => {\n      const cacheKey = `${keyPrefix}:${JSON.stringify(args)}`;\n      const entry = store.get(cacheKey);\n\n      if (entry && !isExpired(entry)) {\n        hits++;\n        // Move to end for LRU\n        store.delete(cacheKey);\n        store.set(cacheKey, entry);\n\n        // Stale-while-revalidate\n        if (isStale(entry) && !revalidating.has(cacheKey)) {\n          revalidating.add(cacheKey);\n          fn(...args)\n            .then((value) => set(cacheKey, value, opts))\n            .catch(() => {})\n            .finally(() => revalidating.delete(cacheKey));\n        }\n\n        return entry.value as TReturn;\n      }\n\n      misses++;\n      const value = await fn(...args);\n      set(cacheKey, value, opts);\n      return value;\n    };\n  }\n\n  function stats(): CacheStats {\n    const total = hits + misses;\n    return {\n      hits,\n      misses,\n      hitRate: total === 0 ? 0 : hits / total,\n      size: store.size,\n    };\n  }\n\n  function dump(): SerializedCache {\n    const entries: SerializedCache['entries'] = [];\n    for (const [key, entry] of store) {\n      entries.push([key, { ...entry, key }]);\n    }\n    return { entries };\n  }\n\n  function load(data: SerializedCache): void {\n    clear();\n    for (const [key, entry] of data.entries) {\n      const { key: _key, ...rest } = entry;\n      store.set(key, rest as CacheEntry<V>);\n      for (const tag of rest.tags) {\n        let keys = tagIndex.get(tag);\n        if (!keys) {\n          keys = new Set();\n          tagIndex.set(tag, keys);\n        }\n        keys.add(key);\n      }\n    }\n  }\n\n  return { set, get, has, delete: del, clear, invalidateTag, wrap, stats, dump, load };\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,48 @@
+interface CacheOptions {
+    maxItems?: number;
+    defaultTTL?: string | number;
+}
+interface SetOptions {
+    ttl?: string | number;
+    tags?: string[];
+    staleWhileRevalidate?: string | number;
+}
+interface WrapOptions {
+    ttl?: string | number;
+    staleWhileRevalidate?: string | number;
+    tags?: string[];
+}
+interface CacheStats {
+    hits: number;
+    misses: number;
+    hitRate: number;
+    size: number;
+}
+interface CacheEntry<T> {
+    value: T;
+    expiresAt: number | null;
+    staleAt: number | null;
+    tags: string[];
+}
+interface SerializedCache {
+    entries: Array<[string, CacheEntry<unknown> & {
+        key: string;
+    }]>;
+}
+
+declare function createCache<V = unknown>(options?: CacheOptions): {
+    set: (key: string, value: V, opts?: SetOptions) => void;
+    get: (key: string) => V | undefined;
+    has: (key: string) => boolean;
+    delete: (key: string) => boolean;
+    clear: () => void;
+    invalidateTag: (tag: string) => number;
+    wrap: <TArgs extends unknown[], TReturn extends V>(keyPrefix: string, fn: (...args: TArgs) => Promise<TReturn>, opts?: WrapOptions) => (...args: TArgs) => Promise<TReturn>;
+    stats: () => CacheStats;
+    dump: () => SerializedCache;
+    load: (data: SerializedCache) => void;
+};
+
+declare function parseDuration(value: string | number): number;
+
+export { type CacheEntry, type CacheOptions, type CacheStats, type SerializedCache, type SetOptions, type WrapOptions, createCache, parseDuration };

package/dist/index.d.ts

@@ -0,0 +1,48 @@
+interface CacheOptions {
+    maxItems?: number;
+    defaultTTL?: string | number;
+}
+interface SetOptions {
+    ttl?: string | number;
+    tags?: string[];
+    staleWhileRevalidate?: string | number;
+}
+interface WrapOptions {
+    ttl?: string | number;
+    staleWhileRevalidate?: string | number;
+    tags?: string[];
+}
+interface CacheStats {
+    hits: number;
+    misses: number;
+    hitRate: number;
+    size: number;
+}
+interface CacheEntry<T> {
+    value: T;
+    expiresAt: number | null;
+    staleAt: number | null;
+    tags: string[];
+}
+interface SerializedCache {
+    entries: Array<[string, CacheEntry<unknown> & {
+        key: string;
+    }]>;
+}
+
+declare function createCache<V = unknown>(options?: CacheOptions): {
+    set: (key: string, value: V, opts?: SetOptions) => void;
+    get: (key: string) => V | undefined;
+    has: (key: string) => boolean;
+    delete: (key: string) => boolean;
+    clear: () => void;
+    invalidateTag: (tag: string) => number;
+    wrap: <TArgs extends unknown[], TReturn extends V>(keyPrefix: string, fn: (...args: TArgs) => Promise<TReturn>, opts?: WrapOptions) => (...args: TArgs) => Promise<TReturn>;
+    stats: () => CacheStats;
+    dump: () => SerializedCache;
+    load: (data: SerializedCache) => void;
+};
+
+declare function parseDuration(value: string | number): number;
+
+export { type CacheEntry, type CacheOptions, type CacheStats, type SerializedCache, type SetOptions, type WrapOptions, createCache, parseDuration };

package/dist/index.js

@@ -0,0 +1,214 @@
+var __defProp = Object.defineProperty;
+var __defProps = Object.defineProperties;
+var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
+var __objRest = (source, exclude) => {
+  var target = {};
+  for (var prop in source)
+    if (__hasOwnProp.call(source, prop) && exclude.indexOf(prop) < 0)
+      target[prop] = source[prop];
+  if (source != null && __getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(source)) {
+      if (exclude.indexOf(prop) < 0 && __propIsEnum.call(source, prop))
+        target[prop] = source[prop];
+    }
+  return target;
+};
+
+// src/duration.ts
+var UNITS = {
+  ms: 1,
+  s: 1e3,
+  m: 60 * 1e3,
+  h: 60 * 60 * 1e3,
+  d: 24 * 60 * 60 * 1e3
+};
+var DURATION_RE = /^(\d+)(ms|s|m|h|d)$/;
+function parseDuration(value) {
+  if (typeof value === "number") return value;
+  const match = value.match(DURATION_RE);
+  if (!match) {
+    throw new Error(`Invalid duration: "${value}". Use format like "5m", "1h", "30s", "100ms", "1d"`);
+  }
+  return parseInt(match[1], 10) * UNITS[match[2]];
+}
+
+// src/cache.ts
+function createCache(options = {}) {
+  const { maxItems = Infinity } = options;
+  const defaultTTL = options.defaultTTL ? parseDuration(options.defaultTTL) : null;
+  const store = /* @__PURE__ */ new Map();
+  const tagIndex = /* @__PURE__ */ new Map();
+  let hits = 0;
+  let misses = 0;
+  function evictLRU() {
+    if (store.size <= maxItems) return;
+    const firstKey = store.keys().next().value;
+    if (firstKey !== void 0) {
+      deleteEntry(firstKey);
+    }
+  }
+  function deleteEntry(key) {
+    const entry = store.get(key);
+    if (entry) {
+      for (const tag of entry.tags) {
+        const keys = tagIndex.get(tag);
+        if (keys) {
+          keys.delete(key);
+          if (keys.size === 0) tagIndex.delete(tag);
+        }
+      }
+      store.delete(key);
+    }
+  }
+  function isExpired(entry) {
+    if (entry.expiresAt === null) return false;
+    return Date.now() > entry.expiresAt;
+  }
+  function isStale(entry) {
+    if (entry.staleAt === null) return false;
+    return Date.now() > entry.staleAt;
+  }
+  function set(key, value, opts) {
+    var _a;
+    deleteEntry(key);
+    const ttl = (opts == null ? void 0 : opts.ttl) ? parseDuration(opts.ttl) : defaultTTL;
+    const swr = (opts == null ? void 0 : opts.staleWhileRevalidate) ? parseDuration(opts.staleWhileRevalidate) : null;
+    const now = Date.now();
+    const tags = (_a = opts == null ? void 0 : opts.tags) != null ? _a : [];
+    const entry = {
+      value,
+      expiresAt: ttl ? now + ttl : null,
+      staleAt: ttl && swr ? now + ttl - swr : null,
+      tags
+    };
+    store.set(key, entry);
+    for (const tag of tags) {
+      let keys = tagIndex.get(tag);
+      if (!keys) {
+        keys = /* @__PURE__ */ new Set();
+        tagIndex.set(tag, keys);
+      }
+      keys.add(key);
+    }
+    evictLRU();
+  }
+  function get(key) {
+    const entry = store.get(key);
+    if (!entry) {
+      misses++;
+      return void 0;
+    }
+    if (isExpired(entry)) {
+      deleteEntry(key);
+      misses++;
+      return void 0;
+    }
+    hits++;
+    store.delete(key);
+    store.set(key, entry);
+    return entry.value;
+  }
+  function has(key) {
+    const entry = store.get(key);
+    if (!entry) return false;
+    if (isExpired(entry)) {
+      deleteEntry(key);
+      return false;
+    }
+    return true;
+  }
+  function del(key) {
+    if (!store.has(key)) return false;
+    deleteEntry(key);
+    return true;
+  }
+  function clear() {
+    store.clear();
+    tagIndex.clear();
+    hits = 0;
+    misses = 0;
+  }
+  function invalidateTag(tag) {
+    const keys = tagIndex.get(tag);
+    if (!keys) return 0;
+    const count = keys.size;
+    for (const key of [...keys]) {
+      deleteEntry(key);
+    }
+    return count;
+  }
+  function wrap(keyPrefix, fn, opts) {
+    const revalidating = /* @__PURE__ */ new Set();
+    return async (...args) => {
+      const cacheKey = `${keyPrefix}:${JSON.stringify(args)}`;
+      const entry = store.get(cacheKey);
+      if (entry && !isExpired(entry)) {
+        hits++;
+        store.delete(cacheKey);
+        store.set(cacheKey, entry);
+        if (isStale(entry) && !revalidating.has(cacheKey)) {
+          revalidating.add(cacheKey);
+          fn(...args).then((value2) => set(cacheKey, value2, opts)).catch(() => {
+          }).finally(() => revalidating.delete(cacheKey));
+        }
+        return entry.value;
+      }
+      misses++;
+      const value = await fn(...args);
+      set(cacheKey, value, opts);
+      return value;
+    };
+  }
+  function stats() {
+    const total = hits + misses;
+    return {
+      hits,
+      misses,
+      hitRate: total === 0 ? 0 : hits / total,
+      size: store.size
+    };
+  }
+  function dump() {
+    const entries = [];
+    for (const [key, entry] of store) {
+      entries.push([key, __spreadProps(__spreadValues({}, entry), { key })]);
+    }
+    return { entries };
+  }
+  function load(data) {
+    clear();
+    for (const [key, entry] of data.entries) {
+      const _a = entry, { key: _key } = _a, rest = __objRest(_a, ["key"]);
+      store.set(key, rest);
+      for (const tag of rest.tags) {
+        let keys = tagIndex.get(tag);
+        if (!keys) {
+          keys = /* @__PURE__ */ new Set();
+          tagIndex.set(tag, keys);
+        }
+        keys.add(key);
+      }
+    }
+  }
+  return { set, get, has, delete: del, clear, invalidateTag, wrap, stats, dump, load };
+}
+
+export { createCache, parseDuration };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/duration.ts","../src/cache.ts"],"names":["value"],"mappings":"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","file":"index.js","sourcesContent":["const UNITS: Record<string, number> = {\n  ms: 1,\n  s: 1000,\n  m: 60 * 1000,\n  h: 60 * 60 * 1000,\n  d: 24 * 60 * 60 * 1000,\n};\n\nconst DURATION_RE = /^(\\d+)(ms|s|m|h|d)$/;\n\nexport function parseDuration(value: string | number): number {\n  if (typeof value === 'number') return value;\n\n  const match = value.match(DURATION_RE);\n  if (!match) {\n    throw new Error(`Invalid duration: \"${value}\". Use format like \"5m\", \"1h\", \"30s\", \"100ms\", \"1d\"`);\n  }\n\n  return parseInt(match[1], 10) * UNITS[match[2]];\n}\n","import type { CacheOptions, SetOptions, WrapOptions, CacheStats, CacheEntry, SerializedCache } from './types.js';\nimport { parseDuration } from './duration.js';\n\nexport function createCache<V = unknown>(options: CacheOptions = {}) {\n  const { maxItems = Infinity } = options;\n  const defaultTTL = options.defaultTTL ? parseDuration(options.defaultTTL) : null;\n\n  const store = new Map<string, CacheEntry<V>>();\n  const tagIndex = new Map<string, Set<string>>();\n  let hits = 0;\n  let misses = 0;\n\n  function evictLRU(): void {\n    if (store.size <= maxItems) return;\n    const firstKey = store.keys().next().value;\n    if (firstKey !== undefined) {\n      deleteEntry(firstKey);\n    }\n  }\n\n  function deleteEntry(key: string): void {\n    const entry = store.get(key);\n    if (entry) {\n      for (const tag of entry.tags) {\n        const keys = tagIndex.get(tag);\n        if (keys) {\n          keys.delete(key);\n          if (keys.size === 0) tagIndex.delete(tag);\n        }\n      }\n      store.delete(key);\n    }\n  }\n\n  function isExpired(entry: CacheEntry<V>): boolean {\n    if (entry.expiresAt === null) return false;\n    return Date.now() > entry.expiresAt;\n  }\n\n  function isStale(entry: CacheEntry<V>): boolean {\n    if (entry.staleAt === null) return false;\n    return Date.now() > entry.staleAt;\n  }\n\n  function set(key: string, value: V, opts?: SetOptions): void {\n    deleteEntry(key);\n\n    const ttl = opts?.ttl ? parseDuration(opts.ttl) : defaultTTL;\n    const swr = opts?.staleWhileRevalidate ? parseDuration(opts.staleWhileRevalidate) : null;\n    const now = Date.now();\n    const tags = opts?.tags ?? [];\n\n    const entry: CacheEntry<V> = {\n      value,\n      expiresAt: ttl ? now + ttl : null,\n      staleAt: ttl && swr ? now + ttl - swr : null,\n      tags,\n    };\n\n    store.set(key, entry);\n\n    for (const tag of tags) {\n      let keys = tagIndex.get(tag);\n      if (!keys) {\n        keys = new Set();\n        tagIndex.set(tag, keys);\n      }\n      keys.add(key);\n    }\n\n    evictLRU();\n  }\n\n  function get(key: string): V | undefined {\n    const entry = store.get(key);\n    if (!entry) {\n      misses++;\n      return undefined;\n    }\n\n    if (isExpired(entry)) {\n      deleteEntry(key);\n      misses++;\n      return undefined;\n    }\n\n    hits++;\n    // Move to end for LRU\n    store.delete(key);\n    store.set(key, entry);\n\n    return entry.value;\n  }\n\n  function has(key: string): boolean {\n    const entry = store.get(key);\n    if (!entry) return false;\n    if (isExpired(entry)) {\n      deleteEntry(key);\n      return false;\n    }\n    return true;\n  }\n\n  function del(key: string): boolean {\n    if (!store.has(key)) return false;\n    deleteEntry(key);\n    return true;\n  }\n\n  function clear(): void {\n    store.clear();\n    tagIndex.clear();\n    hits = 0;\n    misses = 0;\n  }\n\n  function invalidateTag(tag: string): number {\n    const keys = tagIndex.get(tag);\n    if (!keys) return 0;\n    const count = keys.size;\n    for (const key of [...keys]) {\n      deleteEntry(key);\n    }\n    return count;\n  }\n\n  function wrap<TArgs extends unknown[], TReturn extends V>(\n    keyPrefix: string,\n    fn: (...args: TArgs) => Promise<TReturn>,\n    opts?: WrapOptions,\n  ): (...args: TArgs) => Promise<TReturn> {\n    const revalidating = new Set<string>();\n\n    return async (...args: TArgs): Promise<TReturn> => {\n      const cacheKey = `${keyPrefix}:${JSON.stringify(args)}`;\n      const entry = store.get(cacheKey);\n\n      if (entry && !isExpired(entry)) {\n        hits++;\n        // Move to end for LRU\n        store.delete(cacheKey);\n        store.set(cacheKey, entry);\n\n        // Stale-while-revalidate\n        if (isStale(entry) && !revalidating.has(cacheKey)) {\n          revalidating.add(cacheKey);\n          fn(...args)\n            .then((value) => set(cacheKey, value, opts))\n            .catch(() => {})\n            .finally(() => revalidating.delete(cacheKey));\n        }\n\n        return entry.value as TReturn;\n      }\n\n      misses++;\n      const value = await fn(...args);\n      set(cacheKey, value, opts);\n      return value;\n    };\n  }\n\n  function stats(): CacheStats {\n    const total = hits + misses;\n    return {\n      hits,\n      misses,\n      hitRate: total === 0 ? 0 : hits / total,\n      size: store.size,\n    };\n  }\n\n  function dump(): SerializedCache {\n    const entries: SerializedCache['entries'] = [];\n    for (const [key, entry] of store) {\n      entries.push([key, { ...entry, key }]);\n    }\n    return { entries };\n  }\n\n  function load(data: SerializedCache): void {\n    clear();\n    for (const [key, entry] of data.entries) {\n      const { key: _key, ...rest } = entry;\n      store.set(key, rest as CacheEntry<V>);\n      for (const tag of rest.tags) {\n        let keys = tagIndex.get(tag);\n        if (!keys) {\n          keys = new Set();\n          tagIndex.set(tag, keys);\n        }\n        keys.add(key);\n      }\n    }\n  }\n\n  return { set, get, has, delete: del, clear, invalidateTag, wrap, stats, dump, load };\n}\n"]}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@philiprehberger/cache-kit",
+  "version": "0.1.0",
+  "description": "In-memory LRU cache with TTL, stale-while-revalidate, and tag invalidation",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": { "types": "./dist/index.d.ts", "default": "./dist/index.js" },
+      "require": { "types": "./dist/index.d.cts", "default": "./dist/index.cjs" }
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  },
+  "keywords": ["cache", "lru", "ttl", "stale-while-revalidate", "in-memory", "memoize"],
+  "license": "MIT",
+  "repository": { "type": "git", "url": "git+https://github.com/philiprehberger/cache-kit.git" },
+  "homepage": "https://github.com/philiprehberger/cache-kit#readme",
+  "bugs": { "url": "https://github.com/philiprehberger/cache-kit/issues" },
+  "author": "Philip Rehberger",
+  "engines": { "node": ">=18.0.0" },
+  "sideEffects": false
+}