ts-packages 1.0.0 → 3.0.0

package/packages/cache/dist/cjs/adapters/memcache/MemcacheCache.d.ts

@@ -0,0 +1,18 @@
+import { BaseCache } from '../../core/BaseCache';
+import type { HealthCheckResponse, MemcacheCacheConfig } from '../../types';
+export declare class MemcacheCache<T = unknown> extends BaseCache<T> {
+    private memcacheConfig;
+    private client;
+    private isConnected;
+    constructor(memcacheConfig: MemcacheCacheConfig);
+    connect(): Promise<void>;
+    private ensureConnected;
+    private ping;
+    exists(key: string): Promise<boolean>;
+    get(key: string): Promise<T | null>;
+    set(key: string, value: T, ttl?: number): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    clear(): Promise<void>;
+    isAlive(): Promise<HealthCheckResponse>;
+    close(): Promise<void>;
+}

package/packages/cache/dist/cjs/adapters/memcache/MemcacheCache.js

@@ -0,0 +1,173 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemcacheCache = void 0;
+const memcached_1 = __importDefault(require("memcached"));
+const cacheErrorCodes_1 = require("src/errors/cacheErrorCodes");
+const BaseCache_1 = require("../../core/BaseCache");
+const errors_1 = require("../../errors");
+class MemcacheCache extends BaseCache_1.BaseCache {
+    constructor(memcacheConfig) {
+        super(memcacheConfig);
+        this.memcacheConfig = memcacheConfig;
+        this.client = null;
+        this.isConnected = false;
+    }
+    async connect() {
+        try {
+            const servers = Array.isArray(this.memcacheConfig.servers)
+                ? this.memcacheConfig.servers
+                : [this.memcacheConfig.servers];
+            this.client = new memcached_1.default(servers, {
+                retries: 2,
+                retry: 30000,
+                remove: true,
+                maxValue: 1048576,
+                idle: 30000,
+            });
+            this.isConnected = true;
+            await this.ping();
+        }
+        catch (error) {
+            throw new errors_1.CacheError(cacheErrorCodes_1.CACHE_ERROR_CODES.CACHE_CONNECTION_FAILED, {
+                adapter: 'memcache',
+                operation: 'connect',
+                cause: error instanceof Error ? error : undefined,
+            });
+        }
+    }
+    async ensureConnected() {
+        if (!this.client) {
+            await this.connect();
+        }
+    }
+    async ping() {
+        return new Promise((resolve, reject) => {
+            if (!this.client)
+                return reject(new Error('Client not initialized'));
+            this.client.touch('__ping', 1, (err) => (err ? reject(err) : resolve()));
+        });
+    }
+    async exists(key) {
+        try {
+            const value = await this.get(key);
+            return value !== null;
+        }
+        catch (error) {
+            throw new errors_1.CacheError(cacheErrorCodes_1.CACHE_ERROR_CODES.CACHE_ERROR, {
+                adapter: 'memcache',
+                operation: 'exists',
+                details: { key },
+                cause: error instanceof Error ? error : undefined,
+            });
+        }
+    }
+    async get(key) {
+        try {
+            await this.ensureConnected();
+            const fullKey = this.buildKey(key);
+            return new Promise((resolve, reject) => {
+                this.client.get(fullKey, (err, data) => {
+                    if (err)
+                        return reject(err);
+                    if (data == null)
+                        return resolve(null);
+                    try {
+                        resolve(this.deserialize(Buffer.isBuffer(data) ? data.toString() : data));
+                    }
+                    catch (e) {
+                        reject(e);
+                    }
+                });
+            });
+        }
+        catch (error) {
+            throw new errors_1.CacheError(cacheErrorCodes_1.CACHE_ERROR_CODES.CACHE_KEY_NOT_FOUND, {
+                adapter: 'memcache',
+                operation: 'get',
+                details: { key },
+                cause: error instanceof Error ? error : undefined,
+            });
+        }
+    }
+    async set(key, value, ttl) {
+        try {
+            await this.ensureConnected();
+            const fullKey = this.buildKey(key);
+            return new Promise((resolve, reject) => {
+                this.client.set(fullKey, this.serialize(value), ttl ?? this.ttl, (err) => (err ? reject(err) : resolve()));
+            });
+        }
+        catch (error) {
+            throw new errors_1.CacheError(cacheErrorCodes_1.CACHE_ERROR_CODES.CACHE_ERROR, {
+                adapter: 'memcache',
+                operation: 'set',
+                details: { key },
+                cause: error instanceof Error ? error : undefined,
+            });
+        }
+    }
+    async delete(key) {
+        try {
+            await this.ensureConnected();
+            const fullKey = this.buildKey(key);
+            return new Promise((resolve, reject) => {
+                this.client.del(fullKey, (err) => (err ? reject(err) : resolve(true)));
+            });
+        }
+        catch (error) {
+            throw new errors_1.CacheError(cacheErrorCodes_1.CACHE_ERROR_CODES.CACHE_ERROR, {
+                adapter: 'memcache',
+                operation: 'delete',
+                details: { key },
+                cause: error instanceof Error ? error : undefined,
+            });
+        }
+    }
+    async clear() {
+        try {
+            await this.ensureConnected();
+            return new Promise((resolve, reject) => {
+                this.client.flush((err) => (err ? reject(err) : resolve()));
+            });
+        }
+        catch (error) {
+            throw new errors_1.CacheError(cacheErrorCodes_1.CACHE_ERROR_CODES.CACHE_OPERATION_TIMEOUT, {
+                adapter: 'memcache',
+                operation: 'clear',
+                cause: error instanceof Error ? error : undefined,
+            });
+        }
+    }
+    async isAlive() {
+        try {
+            await this.ping();
+            return { isAlive: true, adapter: 'memcache', timestamp: new Date() };
+        }
+        catch (error) {
+            return {
+                isAlive: false,
+                adapter: 'memcache',
+                timestamp: new Date(),
+                error: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    }
+    async close() {
+        try {
+            this.client?.end();
+            this.client = null;
+            this.isConnected = false;
+        }
+        catch (error) {
+            throw new errors_1.CacheError(cacheErrorCodes_1.CACHE_ERROR_CODES.CACHE_ERROR, {
+                adapter: 'memcache',
+                operation: 'close',
+                cause: error instanceof Error ? error : undefined,
+            });
+        }
+    }
+}
+exports.MemcacheCache = MemcacheCache;

package/packages/cache/dist/cjs/adapters/memcache/index.d.ts

@@ -0,0 +1 @@
+export { MemcacheCache } from './MemcacheCache';

package/packages/cache/dist/cjs/adapters/memcache/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemcacheCache = void 0;
+var MemcacheCache_1 = require("./MemcacheCache");
+Object.defineProperty(exports, "MemcacheCache", { enumerable: true, get: function () { return MemcacheCache_1.MemcacheCache; } });

package/packages/cache/dist/cjs/adapters/memory/MemoryCache.d.ts

@@ -0,0 +1,63 @@
+import { BaseCache } from '../../core/BaseCache';
+import type { HealthCheckResponse, MemoryCacheConfig } from '../../types';
+/**
+ * In-memory cache adapter for development and testing
+ */
+export declare class MemoryCache<T = unknown> extends BaseCache<T> {
+    private memoryCacheConfig;
+    private store;
+    private cleanupInterval;
+    constructor(memoryCacheConfig: MemoryCacheConfig);
+    /**
+     * Start periodic cleanup of expired items
+     */
+    private startCleanup;
+    /**
+     * Get a value from memory
+     */
+    get(key: string): Promise<T | null>;
+    /**
+     * Set a value in memory
+     */
+    set(key: string, value: T, ttl?: number): Promise<void>;
+    /**
+     * Delete a key from memory
+     */
+    delete(key: string): Promise<boolean>;
+    /**
+     * Check if key exists
+     */
+    exists(key: string): Promise<boolean>;
+    /**
+     * Clear all keys with current namespace
+     */
+    clear(): Promise<void>;
+    /**
+     * Get multiple values at once
+     */
+    getMultiple(keys: string[]): Promise<Record<string, T | null>>;
+    /**
+     * Set multiple values at once
+     */
+    setMultiple(data: Record<string, T>, ttl?: number): Promise<void>;
+    /**
+     * Delete multiple keys at once
+     */
+    deleteMultiple(keys: string[]): Promise<number>;
+    /**
+     * Increment a numeric value
+     */
+    increment(key: string, amount?: number): Promise<number>;
+    /**
+     * Decrement a numeric value
+     */
+    decrement(key: string, amount?: number): Promise<number>;
+    /**
+     * Check if memory cache is alive
+     */
+    isAlive(): Promise<HealthCheckResponse>;
+    /**
+     * Close memory cache
+     */
+    close(): Promise<void>;
+}

package/packages/cache/dist/cjs/adapters/memory/MemoryCache.js

@@ -0,0 +1,331 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryCache = void 0;
+const cacheErrorCodes_1 = require("src/errors/cacheErrorCodes");
+const BaseCache_1 = require("../../core/BaseCache");
+const errors_1 = require("../../errors");
+/**
+ * In-memory cache adapter for development and testing
+ */
+class MemoryCache extends BaseCache_1.BaseCache {
+    constructor(memoryCacheConfig) {
+        super(memoryCacheConfig);
+        this.memoryCacheConfig = memoryCacheConfig;
+        this.store = new Map();
+        this.cleanupInterval = null;
+        this.startCleanup();
+    }
+    /**
+     * Start periodic cleanup of expired items
+     */
+    startCleanup() {
+        if (this.cleanupInterval)
+            return;
+        this.cleanupInterval = setInterval(() => {
+            const now = Date.now();
+            for (const [key, entry] of this.store.entries()) {
+                if (entry.expiresAt && entry.expiresAt < now) {
+                    this.store.delete(key);
+                }
+            }
+        }, 30000); // Cleanup every 30 seconds
+    }
+    /**
+     * Get a value from memory
+     */
+    async get(key) {
+        try {
+            const fullKey = this.buildKey(key);
+            const entry = this.store.get(fullKey);
+            if (!entry) {
+                this.recordMiss();
+                return null;
+            }
+            // Check if expired
+            if (entry.expiresAt && entry.expiresAt < Date.now()) {
+                this.store.delete(fullKey);
+                this.recordMiss();
+                return null;
+            }
+            this.recordHit();
+            return entry.value;
+        }
+        catch (error) {
+            throw new errors_1.CacheError(cacheErrorCodes_1.CACHE_ERROR_CODES.CACHE_KEY_NOT_FOUND, {
+                adapter: 'memory',
+                operation: 'get',
+                details: { key },
+                cause: error instanceof Error ? error : undefined,
+            });
+        }
+    }
+    /**
+     * Set a value in memory
+     */
+    async set(key, value, ttl) {
+        try {
+            const fullKey = this.buildKey(key);
+            const expiry = ttl ?? this.ttl;
+            const expiresAt = expiry > 0 ? Date.now() + expiry * 1000 : undefined;
+            // Check max size
+            const maxSize = this.memoryCacheConfig.maxSize;
+            if (maxSize && this.store.size >= maxSize && !this.store.has(fullKey)) {
+                // Remove oldest entry
+                const firstKey = this.store.keys().next().value;
+                if (firstKey) {
+                    this.store.delete(firstKey);
+                }
+            }
+            this.store.set(fullKey, { value, expiresAt });
+            this.recordSet();
+        }
+        catch (error) {
+            throw new errors_1.CacheError(cacheErrorCodes_1.CACHE_ERROR_CODES.CACHE_ERROR, {
+                adapter: 'memory',
+                operation: 'set',
+                details: { key },
+                cause: error instanceof Error ? error : undefined,
+            });
+        }
+    }
+    /**
+     * Delete a key from memory
+     */
+    async delete(key) {
+        try {
+            const fullKey = this.buildKey(key);
+            const deleted = this.store.delete(fullKey);
+            if (deleted) {
+                this.recordDelete();
+            }
+            return deleted;
+        }
+        catch (error) {
+            throw new errors_1.CacheError(cacheErrorCodes_1.CACHE_ERROR_CODES.CACHE_ERROR, {
+                adapter: 'memory',
+                operation: 'delete',
+                details: { key },
+                cause: error instanceof Error ? error : undefined,
+            });
+        }
+    }
+    /**
+     * Check if key exists
+     */
+    async exists(key) {
+        try {
+            const fullKey = this.buildKey(key);
+            const entry = this.store.get(fullKey);
+            if (!entry) {
+                return false;
+            }
+            // Check if expired
+            if (entry.expiresAt && entry.expiresAt < Date.now()) {
+                this.store.delete(fullKey);
+                return false;
+            }
+            return true;
+        }
+        catch (error) {
+            throw new errors_1.CacheError(cacheErrorCodes_1.CACHE_ERROR_CODES.CACHE_ERROR, {
+                adapter: 'memory',
+                operation: 'exists',
+                details: { key },
+                cause: error instanceof Error ? error : undefined,
+            });
+        }
+    }
+    /**
+     * Clear all keys with current namespace
+     */
+    async clear() {
+        try {
+            if (this.namespace) {
+                // Clear only keys with current namespace
+                for (const key of this.store.keys()) {
+                    if (key.startsWith(this.namespace)) {
+                        this.store.delete(key);
+                    }
+                }
+            }
+            else {
+                // Clear all
+                this.store.clear();
+            }
+        }
+        catch (error) {
+            throw new errors_1.CacheError(cacheErrorCodes_1.CACHE_ERROR_CODES.CACHE_OPERATION_TIMEOUT, {
+                adapter: 'memory',
+                operation: 'clear',
+                cause: error instanceof Error ? error : undefined,
+            });
+        }
+    }
+    /**
+     * Get multiple values at once
+     */
+    async getMultiple(keys) {
+        try {
+            const result = {};
+            const now = Date.now();
+            for (const key of keys) {
+                const fullKey = this.buildKey(key);
+                const entry = this.store.get(fullKey);
+                if (!entry) {
+                    this.recordMiss();
+                    result[key] = null;
+                    continue;
+                }
+                // Check if expired
+                if (entry.expiresAt && entry.expiresAt < now) {
+                    this.store.delete(fullKey);
+                    this.recordMiss();
+                    result[key] = null;
+                }
+                else {
+                    this.recordHit();
+                    result[key] = entry.value;
+                }
+            }
+            return result;
+        }
+        catch (error) {
+            throw new errors_1.CacheError(cacheErrorCodes_1.CACHE_ERROR_CODES.CACHE_ERROR, {
+                adapter: 'memory',
+                operation: 'getMultiple',
+                details: { keys },
+                cause: error instanceof Error ? error : undefined,
+            });
+        }
+    }
+    /**
+     * Set multiple values at once
+     */
+    async setMultiple(data, ttl) {
+        try {
+            const expiry = ttl ?? this.ttl;
+            const expiresAt = expiry > 0 ? Date.now() + expiry * 1000 : undefined;
+            for (const [key, value] of Object.entries(data)) {
+                const fullKey = this.buildKey(key);
+                this.store.set(fullKey, { value, expiresAt });
+            }
+            this.stats.sets += Object.keys(data).length;
+        }
+        catch (error) {
+            throw new errors_1.CacheError(cacheErrorCodes_1.CACHE_ERROR_CODES.CACHE_ERROR, {
+                adapter: 'memory',
+                operation: 'setMultiple',
+                details: { keys: Object.keys(data) },
+                cause: error instanceof Error ? error : undefined,
+            });
+        }
+    }
+    /**
+     * Delete multiple keys at once
+     */
+    async deleteMultiple(keys) {
+        try {
+            let count = 0;
+            for (const key of keys) {
+                const fullKey = this.buildKey(key);
+                if (this.store.delete(fullKey)) {
+                    count++;
+                }
+            }
+            this.stats.deletes += count;
+            return count;
+        }
+        catch (error) {
+            throw new errors_1.CacheError(cacheErrorCodes_1.CACHE_ERROR_CODES.CACHE_ERROR, {
+                adapter: 'memory',
+                operation: 'deleteMultiple',
+                details: { keys },
+                cause: error instanceof Error ? error : undefined,
+            });
+        }
+    }
+    /**
+     * Increment a numeric value
+     */
+    async increment(key, amount = 1) {
+        try {
+            const fullKey = this.buildKey(key);
+            const entry = this.store.get(fullKey);
+            const current = entry && (!entry.expiresAt || entry.expiresAt >= Date.now())
+                ? typeof entry.value === 'number'
+                    ? entry.value
+                    : 0
+                : 0;
+            const value = current + amount;
+            const expiry = this.ttl;
+            const expiresAt = expiry > 0 ? Date.now() + expiry * 1000 : undefined;
+            this.store.set(fullKey, { value: value, expiresAt });
+            return value;
+        }
+        catch (error) {
+            throw new errors_1.CacheError(cacheErrorCodes_1.CACHE_ERROR_CODES.CACHE_ERROR, {
+                adapter: 'memory',
+                operation: 'increment',
+                details: { key },
+                cause: error instanceof Error ? error : undefined,
+            });
+        }
+    }
+    /**
+     * Decrement a numeric value
+     */
+    async decrement(key, amount = 1) {
+        try {
+            const fullKey = this.buildKey(key);
+            const entry = this.store.get(fullKey);
+            const current = entry && (!entry.expiresAt || entry.expiresAt >= Date.now())
+                ? typeof entry.value === 'number'
+                    ? entry.value
+                    : 0
+                : 0;
+            const value = current - amount;
+            const expiry = this.ttl;
+            const expiresAt = expiry > 0 ? Date.now() + expiry * 1000 : undefined;
+            this.store.set(fullKey, { value: value, expiresAt });
+            return value;
+        }
+        catch (error) {
+            throw new errors_1.CacheError(cacheErrorCodes_1.CACHE_ERROR_CODES.CACHE_ERROR, {
+                adapter: 'memory',
+                operation: 'decrement',
+                details: { key },
+                cause: error instanceof Error ? error : undefined,
+            });
+        }
+    }
+    /**
+     * Check if memory cache is alive
+     */
+    async isAlive() {
+        return {
+            isAlive: true,
+            adapter: 'memory',
+            timestamp: new Date(),
+        };
+    }
+    /**
+     * Close memory cache
+     */
+    async close() {
+        try {
+            if (this.cleanupInterval) {
+                clearInterval(this.cleanupInterval);
+                this.cleanupInterval = null;
+            }
+            this.store.clear();
+        }
+        catch (error) {
+            throw new errors_1.CacheError(cacheErrorCodes_1.CACHE_ERROR_CODES.CACHE_ERROR, {
+                adapter: 'memory',
+                operation: 'close',
+                cause: error instanceof Error ? error : undefined,
+            });
+        }
+    }
+}
+exports.MemoryCache = MemoryCache;

package/packages/cache/dist/cjs/adapters/memory/index.d.ts

@@ -0,0 +1 @@
+export { MemoryCache } from './MemoryCache';

package/packages/cache/dist/cjs/adapters/memory/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryCache = void 0;
+var MemoryCache_1 = require("./MemoryCache");
+Object.defineProperty(exports, "MemoryCache", { enumerable: true, get: function () { return MemoryCache_1.MemoryCache; } });

package/packages/cache/dist/cjs/adapters/redis/RedisCache.d.ts

@@ -0,0 +1,67 @@
+import { BaseCache } from '../../core/BaseCache';
+import type { HealthCheckResponse, RedisCacheConfig } from '../../types';
+/**
+ * Redis cache adapter
+ */
+export declare class RedisCache<T = unknown> extends BaseCache<T> {
+    private redisConfig;
+    private client;
+    private isConnected;
+    constructor(redisConfig: RedisCacheConfig);
+    /**
+     * Connect to Redis
+     */
+    connect(): Promise<void>;
+    /**
+     * Ensure client is connected
+     */
+    private ensureConnected;
+    /**
+     * Get a value from Redis
+     */
+    get(key: string): Promise<T | null>;
+    /**
+     * Set a value in Redis
+     */
+    set(key: string, value: T, ttl?: number): Promise<void>;
+    /**
+     * Delete a key from Redis
+     */
+    delete(key: string): Promise<boolean>;
+    /**
+     * Check if key exists
+     */
+    exists(key: string): Promise<boolean>;
+    /**
+     * Clear all keys with current namespace
+     */
+    clear(): Promise<void>;
+    /**
+     * Get multiple values at once
+     */
+    getMultiple(keys: string[]): Promise<Record<string, T | null>>;
+    /**
+     * Set multiple values at once
+     */
+    setMultiple(data: Record<string, T>, ttl?: number): Promise<void>;
+    /**
+     * Delete multiple keys at once
+     */
+    deleteMultiple(keys: string[]): Promise<number>;
+    /**
+     * Increment a numeric value
+     */
+    increment(key: string, amount?: number): Promise<number>;
+    /**
+     * Decrement a numeric value
+     */
+    decrement(key: string, amount?: number): Promise<number>;
+    /**
+     * Check if Redis is alive
+     */
+    isAlive(): Promise<HealthCheckResponse>;
+    /**
+     * Close Redis connection
+     */
+    close(): Promise<void>;
+}