@open-mercato/cache 0.3.2 → 0.4.2-canary-b8ab8f2d43

package/src/__tests__/memory.strategy.test.ts

@@ -55,24 +55,33 @@ describe('Memory Cache Strategy', () => {
   })
 
   describe('TTL and expiration', () => {
+    beforeEach(() => {
+      jest.useFakeTimers()
+      jest.setSystemTime(new Date('2025-01-01T00:00:00.000Z'))
+    })
+
+    afterEach(() => {
+      jest.useRealTimers()
+    })
+
     it('should expire after TTL', async () => {
       await cache.set('key1', 'value1', { ttl: 100 }) // 100ms
       expect(await cache.get('key1')).toBe('value1')
 
-      await new Promise((resolve) => setTimeout(resolve, 150))
+      await jest.advanceTimersByTimeAsync(150)
       expect(await cache.get('key1')).toBeNull()
       expect(await cache.has('key1')).toBe(false)
     })
 
     it('should not expire without TTL', async () => {
       await cache.set('key1', 'value1')
-      await new Promise((resolve) => setTimeout(resolve, 100))
+      await jest.advanceTimersByTimeAsync(100)
       expect(await cache.get('key1')).toBe('value1')
     })
 
     it('should return expired value if returnExpired is true', async () => {
       await cache.set('key1', 'value1', { ttl: 50 })
-      await new Promise((resolve) => setTimeout(resolve, 100))
+      await jest.advanceTimersByTimeAsync(100)
       const value = await cache.get('key1', { returnExpired: true })
       expect(value).toBe('value1')
     })
@@ -82,7 +91,7 @@ describe('Memory Cache Strategy', () => {
       await cacheWithTtl.set('key1', 'value1') // Should use default TTL
       expect(await cacheWithTtl.get('key1')).toBe('value1')
 
-      await new Promise((resolve) => setTimeout(resolve, 150))
+      await jest.advanceTimersByTimeAsync(150)
       expect(await cacheWithTtl.get('key1')).toBeNull()
     })
 
@@ -90,10 +99,10 @@ describe('Memory Cache Strategy', () => {
       const cacheWithTtl = createMemoryStrategy({ defaultTtl: 100 })
       await cacheWithTtl.set('key1', 'value1', { ttl: 200 })
 
-      await new Promise((resolve) => setTimeout(resolve, 150))
+      await jest.advanceTimersByTimeAsync(150)
       expect(await cacheWithTtl.get('key1')).toBe('value1') // Still valid
 
-      await new Promise((resolve) => setTimeout(resolve, 100))
+      await jest.advanceTimersByTimeAsync(100)
       expect(await cacheWithTtl.get('key1')).toBeNull() // Now expired
     })
   })
@@ -242,4 +251,3 @@ describe('Memory Cache Strategy', () => {
     })
   })
 })
-

package/tsconfig.build.json

@@ -1,5 +1,13 @@
 {
   "$schema": "https://json.schemastore.org/tsconfig",
-  "extends": "./tsconfig.json",
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "noEmit": false,
+    "declaration": true,
+    "declarationMap": true,
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src/**/*"],
   "exclude": ["src/**/__tests__/**/*", "src/**/*.test.ts"]
 }

package/tsconfig.json

@@ -1,12 +1,9 @@
 {
   "$schema": "https://json.schemastore.org/tsconfig",
-  "extends": "../../tsconfig.json",
+  "extends": "../../tsconfig.base.json",
   "compilerOptions": {
-    "noEmit": false,
-    "declaration": true,
-    "declarationMap": true,
-    "outDir": "./dist",
-    "rootDir": "./src"
+    "noEmit": true
   },
-  "include": ["src/**/*"]
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "**/__tests__/**"]
 }

package/watch.mjs

@@ -0,0 +1,6 @@
+import { watch } from '../../scripts/watch.mjs'
+import { dirname } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+watch(__dirname)

package/dist/errors.d.ts

@@ -1,7 +0,0 @@
-export declare class CacheDependencyUnavailableError extends Error {
-    readonly strategy: string;
-    readonly dependency: string;
-    readonly originalError?: unknown;
-    constructor(strategy: string, dependency: string, originalError?: unknown);
-}
-//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,+BAAgC,SAAQ,KAAK;IACxD,SAAgB,QAAQ,EAAE,MAAM,CAAA;IAChC,SAAgB,UAAU,EAAE,MAAM,CAAA;IAClC,SAAgB,aAAa,CAAC,EAAE,OAAO,CAAA;gBAE3B,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,OAAO;CAO1E"}

package/dist/index.d.ts

@@ -1,8 +0,0 @@
-export * from './types';
-export * from './service';
-export { createMemoryStrategy } from './strategies/memory';
-export { createRedisStrategy } from './strategies/redis';
-export { createSqliteStrategy } from './strategies/sqlite';
-export { createJsonFileStrategy } from './strategies/jsonfile';
-export { runWithCacheTenant, getCurrentCacheTenant } from './tenantContext';
-//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA;AACzB,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAC9D,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/service.d.ts

@@ -1,40 +0,0 @@
-import type { CacheStrategy, CacheServiceOptions, CacheGetOptions, CacheSetOptions, CacheValue } from './types';
-/**
- * Cache service that provides a unified interface to different cache strategies
- *
- * Configuration via environment variables:
- * - CACHE_STRATEGY: 'memory' | 'redis' | 'sqlite' | 'jsonfile' (default: 'memory')
- * - CACHE_TTL: Default TTL in milliseconds (optional)
- * - CACHE_REDIS_URL: Redis connection URL (for redis strategy)
- * - CACHE_SQLITE_PATH: SQLite database file path (for sqlite strategy)
- * - CACHE_JSON_FILE_PATH: JSON file path (for jsonfile strategy)
- *
- * @example
- * const cache = createCacheService({ strategy: 'memory', defaultTtl: 60000 })
- * await cache.set('user:123', { name: 'John' }, { tags: ['users', 'user:123'] })
- * const user = await cache.get('user:123')
- * await cache.deleteByTags(['users']) // Invalidate all user-related cache
- */
-export declare function createCacheService(options?: CacheServiceOptions): CacheStrategy;
-/**
- * CacheService class wrapper for DI integration
- * Provides the same interface as the functional API but as a class
- */
-export declare class CacheService implements CacheStrategy {
-    private strategy;
-    constructor(options?: CacheServiceOptions);
-    get(key: string, options?: CacheGetOptions): Promise<CacheValue | null>;
-    set(key: string, value: CacheValue, options?: CacheSetOptions): Promise<void>;
-    has(key: string): Promise<boolean>;
-    delete(key: string): Promise<boolean>;
-    deleteByTags(tags: string[]): Promise<number>;
-    clear(): Promise<number>;
-    keys(pattern?: string): Promise<string[]>;
-    stats(): Promise<{
-        size: number;
-        expired: number;
-    }>;
-    cleanup(): Promise<number>;
-    close(): Promise<void>;
-}
-//# sourceMappingURL=service.d.ts.map

package/dist/service.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AA6M/G;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,aAAa,CAc/E;AAED;;;GAGG;AACH,qBAAa,YAAa,YAAW,aAAa;IAChD,OAAO,CAAC,QAAQ,CAAe;gBAEnB,OAAO,CAAC,EAAE,mBAAmB;IAInC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAIvE,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7E,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIlC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrC,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAI7C,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAIxB,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAIzC,KAAK,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAInD,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAO1B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAK7B"}

package/dist/strategies/jsonfile.d.ts

@@ -1,10 +0,0 @@
-import type { CacheStrategy } from '../types';
-/**
- * JSON file cache strategy with tag support
- * Persistent across process restarts, stored in JSON files
- * Simple and requires no external dependencies, but not suitable for high-performance scenarios
- */
-export declare function createJsonFileStrategy(filePath?: string, options?: {
-    defaultTtl?: number;
-}): CacheStrategy;
-//# sourceMappingURL=jsonfile.d.ts.map

package/dist/strategies/jsonfile.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"jsonfile.d.ts","sourceRoot":"","sources":["../../src/strategies/jsonfile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAA4D,MAAM,UAAU,CAAA;AAIvG;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,aAAa,CA+O1G"}

package/dist/strategies/memory.d.ts

@@ -1,9 +0,0 @@
-import type { CacheStrategy } from '../types';
-/**
- * In-memory cache strategy with tag support
- * Fast but data is lost when process restarts
- */
-export declare function createMemoryStrategy(options?: {
-    defaultTtl?: number;
-}): CacheStrategy;
-//# sourceMappingURL=memory.d.ts.map

package/dist/strategies/memory.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/strategies/memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAA4D,MAAM,UAAU,CAAA;AAEvG;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,aAAa,CAkLrF"}

package/dist/strategies/redis.d.ts

@@ -1,5 +0,0 @@
-import type { CacheStrategy } from '../types';
-export declare function createRedisStrategy(redisUrl?: string, options?: {
-    defaultTtl?: number;
-}): CacheStrategy;
-//# sourceMappingURL=redis.d.ts.map

package/dist/strategies/redis.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"redis.d.ts","sourceRoot":"","sources":["../../src/strategies/redis.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAA4D,MAAM,UAAU,CAAA;AAwJvG,wBAAgB,mBAAmB,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,aAAa,CAkSvG"}

package/dist/strategies/sqlite.d.ts

@@ -1,13 +0,0 @@
-import type { CacheStrategy } from '../types';
-/**
- * SQLite cache strategy with tag support
- * Persistent across process restarts, stored in a SQLite database file
- *
- * Uses two tables:
- * - cache_entries: stores cache data
- * - cache_tags: stores tag associations (many-to-many)
- */
-export declare function createSqliteStrategy(dbPath?: string, options?: {
-    defaultTtl?: number;
-}): CacheStrategy;
-//# sourceMappingURL=sqlite.d.ts.map

package/dist/strategies/sqlite.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../src/strategies/sqlite.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAgD,MAAM,UAAU,CAAA;AAuB3F;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,aAAa,CA6PtG"}

package/dist/tenantContext.d.ts

@@ -1,4 +0,0 @@
-export declare function runWithCacheTenant<T>(tenantId: string | null, fn: () => T): T;
-export declare function runWithCacheTenant<T>(tenantId: string | null, fn: () => Promise<T>): Promise<T>;
-export declare function getCurrentCacheTenant(): string | null;
-//# sourceMappingURL=tenantContext.d.ts.map

package/dist/tenantContext.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tenantContext.d.ts","sourceRoot":"","sources":["../src/tenantContext.ts"],"names":[],"mappings":"AAIA,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAA;AAC9E,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;AAKhG,wBAAgB,qBAAqB,IAAI,MAAM,GAAG,IAAI,CAErD"}

package/dist/types.d.ts

@@ -1,86 +0,0 @@
-export type CacheValue = unknown;
-export type CacheEntry = {
-    key: string;
-    value: CacheValue;
-    tags: string[];
-    expiresAt: number | null;
-    createdAt: number;
-};
-export type CacheOptions = {
-    ttl?: number;
-    tags?: string[];
-};
-export type CacheGetOptions = {
-    returnExpired?: boolean;
-};
-export type CacheSetOptions = CacheOptions;
-export type CacheStrategy = {
-    /**
-     * Get a value from cache
-     * @param key - Cache key
-     * @param options - Get options
-     * @returns The cached value or null if not found or expired
-     */
-    get(key: string, options?: CacheGetOptions): Promise<CacheValue | null>;
-    /**
-     * Set a value in cache
-     * @param key - Cache key
-     * @param value - Value to cache
-     * @param options - Cache options (ttl, tags)
-     */
-    set(key: string, value: CacheValue, options?: CacheSetOptions): Promise<void>;
-    /**
-     * Check if a key exists in cache (and is not expired)
-     * @param key - Cache key
-     * @returns true if key exists and is not expired
-     */
-    has(key: string): Promise<boolean>;
-    /**
-     * Delete a specific key from cache
-     * @param key - Cache key
-     * @returns true if key was deleted, false if not found
-     */
-    delete(key: string): Promise<boolean>;
-    /**
-     * Delete all keys with specified tags
-     * @param tags - Tags to match (any key with ANY of these tags will be deleted)
-     * @returns Number of keys deleted
-     */
-    deleteByTags(tags: string[]): Promise<number>;
-    /**
-     * Clear all cache entries
-     * @returns Number of keys deleted
-     */
-    clear(): Promise<number>;
-    /**
-     * Get all keys matching a pattern
-     * @param pattern - Pattern to match (supports wildcards: * and ?)
-     * @returns Array of matching keys
-     */
-    keys(pattern?: string): Promise<string[]>;
-    /**
-     * Get cache statistics
-     * @returns Statistics object
-     */
-    stats(): Promise<{
-        size: number;
-        expired: number;
-    }>;
-    /**
-     * Clean up expired entries (optional, some strategies may auto-cleanup)
-     * @returns Number of entries removed
-     */
-    cleanup?(): Promise<number>;
-    /**
-     * Close/disconnect the cache strategy
-     */
-    close?(): Promise<void>;
-};
-export type CacheServiceOptions = {
-    strategy?: 'memory' | 'redis' | 'sqlite' | 'jsonfile';
-    redisUrl?: string;
-    sqlitePath?: string;
-    jsonFilePath?: string;
-    defaultTtl?: number;
-};
-//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,OAAO,CAAA;AAEhC,MAAM,MAAM,UAAU,GAAG;IACvB,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,UAAU,CAAA;IACjB,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB,CAAA;AAED,MAAM,MAAM,eAAe,GAAG,YAAY,CAAA;AAE1C,MAAM,MAAM,aAAa,GAAG;IAC1B;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAA;IAEvE;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE7E;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAElC;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAErC;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAE7C;;;OAGG;IACH,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;IAExB;;;;OAIG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAEzC;;;OAGG;IACH,KAAK,IAAI,OAAO,CAAC;QACf,IAAI,EAAE,MAAM,CAAA;QACZ,OAAO,EAAE,MAAM,CAAA;KAChB,CAAC,CAAA;IAEF;;;OAGG;IACH,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;IAE3B;;OAEG;IACH,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACxB,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAA;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA"}

package/jest.config.js

@@ -1,19 +0,0 @@
-module.exports = {
-  preset: 'ts-jest',
-  testEnvironment: 'node',
-  roots: ['<rootDir>/src'],
-  testMatch: ['**/__tests__/**/*.test.ts'],
-  transform: {
-    '^.+\\.ts$': ['ts-jest', {
-      tsconfig: {
-        esModuleInterop: true,
-        allowSyntheticDefaultImports: true,
-      },
-    }],
-  },
-  moduleNameMapper: {
-    '^@open-mercato/cache$': '<rootDir>/src/index.ts',
-    '^@open-mercato/cache/(.*)$': '<rootDir>/src/$1',
-  },
-}
-