@happyvertical/cache 0.74.8

package/dist/shared/types.d.ts

@@ -0,0 +1,281 @@
+/**
+ * Core types and interfaces for the Cache library
+ */
+/**
+ * Standardized cache entry structure (internal use)
+ */
+export interface CacheEntry<T = any> {
+    /**
+     * The cached value
+     */
+    value: T;
+    /**
+     * When this entry was created (Unix timestamp in milliseconds)
+     */
+    createdAt: number;
+    /**
+     * When this entry will expire (Unix timestamp in milliseconds)
+     * undefined means no expiration
+     */
+    expiresAt?: number;
+    /**
+     * Size in bytes (for memory/disk management)
+     */
+    size: number;
+    /**
+     * Number of times this entry has been accessed
+     */
+    hits: number;
+    /**
+     * Additional metadata
+     */
+    metadata?: {
+        compressed?: boolean;
+        serialized?: boolean;
+        namespace?: string;
+    };
+}
+/**
+ * Cache statistics
+ */
+export interface CacheStats {
+    /**
+     * Total number of cached entries
+     */
+    entries: number;
+    /**
+     * Total size in bytes
+     */
+    totalSize: number;
+    /**
+     * Cache hit count
+     */
+    hits: number;
+    /**
+     * Cache miss count
+     */
+    misses: number;
+    /**
+     * Hit rate (hits / (hits + misses))
+     */
+    hitRate: number;
+    /**
+     * Number of evictions (entries removed due to size/TTL)
+     */
+    evictions: number;
+    /**
+     * Backend-specific statistics
+     */
+    backend?: {
+        type: 'memory' | 'file' | 'redis' | 's3';
+        [key: string]: any;
+    };
+}
+/**
+ * Cache provider interface - all providers must implement this
+ */
+export interface CacheProvider {
+    /**
+     * Retrieves a value from the cache by key
+     * @param key - The cache key
+     * @returns Promise resolving to the cached value, or undefined if not found or expired
+     */
+    get<T = any>(key: string): Promise<T | undefined>;
+    /**
+     * Stores a value in the cache with an optional time-to-live
+     * @param key - The cache key
+     * @param value - The value to cache
+     * @param ttl - Optional time-to-live in seconds
+     * @returns Promise resolving when the value is cached
+     */
+    set<T = any>(key: string, value: T, ttl?: number): Promise<void>;
+    /**
+     * Checks if a key exists in the cache and is not expired
+     * @param key - The cache key
+     * @returns Promise resolving to true if the key exists and is valid
+     */
+    has(key: string): Promise<boolean>;
+    /**
+     * Removes a value from the cache
+     * @param key - The cache key
+     * @returns Promise resolving to true if the key was deleted, false if it didn't exist
+     */
+    delete(key: string): Promise<boolean>;
+    /**
+     * Clears all entries from the cache, or all entries in a namespace if specified
+     * @param namespace - Optional namespace to clear
+     * @returns Promise resolving when the cache is cleared
+     */
+    clear(namespace?: string): Promise<void>;
+    /**
+     * Gets all keys in the cache, optionally filtered by a pattern
+     * @param pattern - Optional glob-style pattern to filter keys
+     * @returns Promise resolving to an array of matching keys
+     */
+    keys(pattern?: string): Promise<string[]>;
+    /**
+     * Retrieves multiple values from the cache
+     * @param keys - An array of cache keys
+     * @returns Promise resolving to a map of key-value pairs
+     */
+    getMany<T = any>(keys: string[]): Promise<Map<string, T>>;
+    /**
+     * Stores multiple key-value pairs in the cache
+     * @param entries - An array of {key, value, ttl?} objects
+     * @returns Promise resolving when all values are cached
+     */
+    setMany<T = any>(entries: Array<{
+        key: string;
+        value: T;
+        ttl?: number;
+    }>): Promise<void>;
+    /**
+     * Removes multiple values from the cache
+     * @param keys - An array of cache keys
+     * @returns Promise resolving to the number of keys deleted
+     */
+    deleteMany(keys: string[]): Promise<number>;
+    /**
+     * Gets cache statistics
+     * @returns Promise resolving to cache statistics
+     */
+    getStats(): Promise<CacheStats>;
+    /**
+     * Updates the TTL for an existing cache entry
+     * @param key - The cache key
+     * @param ttl - New time-to-live in seconds
+     * @returns Promise resolving to true if TTL was updated, false if key doesn't exist
+     */
+    touch(key: string, ttl: number): Promise<boolean>;
+    /**
+     * Closes the cache connection/cleanup resources
+     * @returns Promise resolving when cleanup is complete
+     */
+    close(): Promise<void>;
+}
+/**
+ * Cache adapter interface (structurally identical to CacheProvider)
+ */
+export interface CacheAdapter extends CacheProvider {
+}
+/**
+ * Memory cache options
+ */
+export interface MemoryOptions {
+    provider: 'memory';
+    namespace?: string;
+    /** Default time-to-live in seconds for entries without an explicit TTL */
+    defaultTTL?: number;
+    /** Maximum total cache size in bytes (default: 100 MB) */
+    maxSize?: number;
+    /** Maximum number of entries (default: 10 000) */
+    maxEntries?: number;
+    evictionPolicy?: 'lru' | 'lfu' | 'fifo';
+    /** Interval in milliseconds between expired-entry sweeps (default: 60 000) */
+    checkPeriod?: number;
+}
+/**
+ * File cache options
+ */
+export interface FileOptions {
+    provider: 'file';
+    /** Directory where cache files are stored (required) */
+    cacheDir: string;
+    namespace?: string;
+    /** Default time-to-live in seconds for entries without an explicit TTL */
+    defaultTTL?: number;
+    /** Maximum total cache size in bytes (default: 500 MB) */
+    maxSize?: number;
+    /** Enable gzip compression for stored files (default: false) */
+    compression?: boolean;
+    /** File suffix for cache files (default: '.cache') */
+    fileExtension?: string;
+    /** Interval in milliseconds between expired-file cleanup sweeps (default: 300 000) */
+    checkPeriod?: number;
+}
+/**
+ * Redis cache options
+ */
+export interface RedisOptions {
+    provider: 'redis';
+    /** Redis server hostname (default: 'localhost') */
+    host?: string;
+    /** Redis server port (default: 6379) */
+    port?: number;
+    password?: string;
+    /** Redis database index 0-15 (default: 0) */
+    db?: number;
+    namespace?: string;
+    /** Alternative to namespace — used as the key prefix */
+    keyPrefix?: string;
+    /** Default time-to-live in seconds for entries without an explicit TTL */
+    defaultTTL?: number;
+    /** Enable gzip compression for values exceeding compressionThreshold (default: false) */
+    enableCompression?: boolean;
+    /** Minimum value size in bytes before compression applies (default: 1024) */
+    compressionThreshold?: number;
+    /** Socket connect timeout in milliseconds (default: 5000) */
+    connectTimeout?: number;
+    /** Per-command timeout in milliseconds */
+    commandTimeout?: number;
+    retryStrategy?: (times: number) => number | null;
+}
+/**
+ * S3 cache options
+ * Use this for CI environments where cache needs to persist between runs
+ */
+export interface S3Options {
+    provider: 's3';
+    /** S3 bucket name (required) */
+    bucket: string;
+    /** Key prefix for cache files (default: 'cache/') */
+    prefix?: string;
+    /** AWS region (default: from AWS_REGION env var or 'us-east-1') */
+    region?: string;
+    /** Optional namespace for key organization */
+    namespace?: string;
+    /** Default TTL in seconds */
+    defaultTTL?: number;
+    /** Enable gzip compression (default: true) */
+    compression?: boolean;
+    /** Only compress if value exceeds this size in bytes (default: 1024) */
+    compressionThreshold?: number;
+}
+/**
+ * Discriminated union of all cache adapter options
+ */
+export type CacheAdapterOptions = MemoryOptions | FileOptions | RedisOptions | S3Options;
+/**
+ * Base cache error class
+ */
+export declare class CacheError extends Error {
+    code: string;
+    provider: string;
+    constructor(message: string, code: string, provider: string);
+}
+/**
+ * Invalid cache key error
+ */
+export declare class CacheKeyError extends CacheError {
+    key: string;
+    constructor(key: string, provider: string);
+}
+/**
+ * Cache connection error
+ */
+export declare class CacheConnectionError extends CacheError {
+    constructor(message: string, provider: string);
+}
+/**
+ * Cache size limit exceeded error
+ */
+export declare class CacheSizeError extends CacheError {
+    constructor(message: string, provider: string);
+}
+/**
+ * Cache serialization error
+ */
+export declare class CacheSerializationError extends CacheError {
+    constructor(message: string, provider: string);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/shared/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":"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"}

package/dist/shared/utils.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Utility functions for cache operations
+ */
+/**
+ * Validates a cache key
+ * @param key - The cache key to validate
+ * @returns True if the key is valid
+ */
+export declare function isValidKey(key: string): boolean;
+/**
+ * Calculates the size of a value in bytes (approximate)
+ * @param value - The value to measure
+ * @returns Size in bytes
+ */
+export declare function calculateSize(value: any): number;
+/**
+ * Checks if a pattern matches a string (glob-style)
+ * @param pattern - The glob pattern (supports * wildcard)
+ * @param str - The string to test
+ * @returns True if the pattern matches
+ */
+export declare function matchesPattern(pattern: string, str: string): boolean;
+/**
+ * Formats a namespace and key into a full key
+ * @param namespace - Optional namespace
+ * @param key - The cache key
+ * @returns Formatted key with namespace prefix if provided
+ */
+export declare function formatKey(namespace: string | undefined, key: string): string;
+/**
+ * Extracts the original key from a namespaced key
+ * @param namespace - Optional namespace
+ * @param fullKey - The full key with namespace
+ * @returns Original key without namespace
+ */
+export declare function extractKey(namespace: string | undefined, fullKey: string): string;
+/**
+ * Checks if an entry has expired
+ * @param expiresAt - Expiration timestamp (undefined means no expiration)
+ * @returns True if the entry has expired
+ */
+export declare function isExpired(expiresAt: number | undefined): boolean;
+/**
+ * Calculates expiration timestamp from TTL
+ * @param ttl - Time-to-live in seconds (undefined means no expiration)
+ * @returns Expiration timestamp in milliseconds, or undefined
+ */
+export declare function calculateExpiration(ttl: number | undefined): number | undefined;
+/**
+ * Serializes a value to JSON string
+ * @param value - The value to serialize
+ * @returns JSON string
+ * @throws Error if serialization fails
+ */
+export declare function serialize(value: any): string;
+/**
+ * Deserializes a JSON string to a value
+ * @param json - The JSON string
+ * @returns Deserialized value
+ * @throws Error if deserialization fails
+ */
+export declare function deserialize<T = any>(json: string): T;
+//# sourceMappingURL=utils.d.ts.map

package/dist/shared/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/shared/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM,CAQhD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CASpE;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE5E;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,OAAO,EAAE,MAAM,GACd,MAAM,CAMR;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAKhE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,GAAG,SAAS,GACtB,MAAM,GAAG,SAAS,CAKpB;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM,CAQ5C;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,CAQpD"}

package/metadata.json

@@ -0,0 +1,35 @@
+{
+  "name": "@happyvertical/cache",
+  "path": "packages/cache",
+  "position": {
+    "index": 5,
+    "count": 30
+  },
+  "description": "Standardized caching interface supporting Memory, File, and Redis backends",
+  "provides": [
+    "Standardized caching interface supporting Memory, File, and Redis backends"
+  ],
+  "implements": [],
+  "requires": {
+    "workspace": [
+      "@happyvertical/utils"
+    ],
+    "externalHappyVertical": [],
+    "external": [
+      "@aws-sdk/client-s3",
+      "@aws-sdk/credential-providers",
+      "redis"
+    ]
+  },
+  "dependents": [
+    "@happyvertical/geo",
+    "@happyvertical/translator"
+  ],
+  "stability": {
+    "level": "stable",
+    "reason": "Primary package surface is described as implemented and production-oriented."
+  },
+  "keywords": [
+    "cache"
+  ]
+}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@happyvertical/cache",
+  "version": "0.74.8",
+  "description": "Standardized caching interface supporting Memory, File, and Redis backends",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "bin": {
+    "have-cache-context": "./dist/cli/claude-context.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "AGENT.md",
+    "metadata.json"
+  ],
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/happyvertical/sdk.git",
+    "directory": "packages/cache"
+  },
+  "bugs": {
+    "url": "https://github.com/happyvertical/sdk/issues"
+  },
+  "homepage": "https://github.com/happyvertical/sdk/tree/main/packages/cache#readme",
+  "keywords": [
+    "cache",
+    "caching",
+    "redis",
+    "memory-cache",
+    "file-cache",
+    "key-value",
+    "ttl",
+    "lru"
+  ],
+  "author": "willgriffin@gmail.com",
+  "license": "ISC",
+  "dependencies": {
+    "@aws-sdk/client-s3": "3.1034.0",
+    "@aws-sdk/credential-providers": "3.1034.0",
+    "redis": "^5.12.1",
+    "@happyvertical/utils": "0.74.8"
+  },
+  "devDependencies": {
+    "@types/node": "25.0.10",
+    "typescript": "^5.9.3",
+    "vite": "7.3.2",
+    "vite-plugin-dts": "4.5.4",
+    "vitest": "^4.1.5"
+  },
+  "scripts": {
+    "test": "npx vitest run",
+    "test:watch": "npx vitest",
+    "build": "vite build",
+    "build:watch": "vite build --watch",
+    "docs": "typedoc --plugin typedoc-plugin-markdown --out docs --entryPoints ./src/index.ts --tsconfig ./tsconfig.json --excludePrivate --excludeInternal --hideGenerator --fileExtension .md --readme none --categorizeByGroup false --includeVersion false --hidePageHeader --hidePageTitle false --outputFileStrategy modules",
+    "docs:watch": "typedoc --plugin typedoc-plugin-markdown --out docs --entryPoints ./src/index.ts --tsconfig ./tsconfig.json --excludePrivate --excludeInternal --hideGenerator --fileExtension .md --readme none --categorizeByGroup false --includeVersion false --hidePageHeader --hidePageTitle false --outputFileStrategy modules --watch",
+    "clean": "rm -rf dist docs *.tsbuildinfo",
+    "dev": "npm run build:watch & npm run test:watch"
+  }
+}