ts-packages 1.0.0 → 3.0.0

package/packages/cache/dist/types/types.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Cache configuration options
+ */
+export interface CacheConfig {
+    adapter: 'redis' | 'memcache' | 'memory';
+    namespace?: string;
+    ttl?: number;
+    fallback?: boolean;
+}
+/**
+ * Redis-cluster configuration
+ */
+export interface RedisClusterConfig {
+    nodes: Array<{
+        host: string;
+        port: number;
+    }>;
+    options?: {
+        enableReadyCheck?: boolean;
+        maxRedirections?: number;
+        retryDelayOnFailover?: number;
+        retryDelayOnClusterDown?: number;
+    };
+}
+/**
+ * Redis-specific configuration
+ */
+export interface RedisCacheConfig extends CacheConfig {
+    adapter: 'redis';
+    host?: string;
+    port?: number;
+    cluster?: RedisClusterConfig | Array<{
+        host: string;
+        port: number;
+    }>;
+    username?: string;
+    password?: string;
+    db?: number;
+    tls?: boolean;
+}
+/**
+ * Memcache-specific configuration
+ */
+export interface MemcacheCacheConfig extends CacheConfig {
+    adapter: 'memcache';
+    servers: string | string[];
+    username?: string;
+    password?: string;
+}
+/**
+ * Memory cache configuration
+ */
+export interface MemoryCacheConfig extends CacheConfig {
+    adapter: 'memory';
+    maxSize?: number;
+}
+/**
+ * Session data structure
+ */
+export interface SessionData {
+    [key: string]: unknown;
+}
+/**
+ * Session store options
+ */
+export interface SessionOptions {
+    ttl?: number;
+    serialize?: (data: SessionData) => string;
+    deserialize?: (data: string) => SessionData;
+}
+/**
+ * Cache statistics
+ */
+export interface CacheStats {
+    hits: number;
+    misses: number;
+    sets: number;
+    deletes: number;
+}
+/**
+ * Health check response
+ */
+export interface HealthCheckResponse {
+    isAlive: boolean;
+    adapter: string;
+    timestamp: Date;
+    error?: string;
+}
+/**
+ * Batch operation result
+ */
+export interface BatchResult<T> {
+    [key: string]: T | null;
+}
+/**
+ * Cache key with optional metadata
+ */
+export interface CacheEntry<T = unknown> {
+    value: T;
+    expiresAt?: number;
+    createdAt: number;
+}

package/packages/cache/node_modules/.bin/rimraf

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/home/namandev2704/projects/ts-packages/node_modules/.pnpm/rimraf@5.0.10/node_modules/rimraf/dist/esm/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/rimraf@5.0.10/node_modules/rimraf/dist/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/rimraf@5.0.10/node_modules/rimraf/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/rimraf@5.0.10/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/home/namandev2704/projects/ts-packages/node_modules/.pnpm/rimraf@5.0.10/node_modules/rimraf/dist/esm/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/rimraf@5.0.10/node_modules/rimraf/dist/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/rimraf@5.0.10/node_modules/rimraf/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/rimraf@5.0.10/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../rimraf/dist/esm/bin.mjs" "$@"
+else
+  exec node  "$basedir/../rimraf/dist/esm/bin.mjs" "$@"
+fi

package/packages/cache/node_modules/.bin/tsc

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/home/namandev2704/projects/ts-packages/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/bin/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/typescript@5.9.3/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/home/namandev2704/projects/ts-packages/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/bin/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/typescript@5.9.3/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../typescript/bin/tsc" "$@"
+else
+  exec node  "$basedir/../typescript/bin/tsc" "$@"
+fi

package/packages/cache/node_modules/.bin/tsserver

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/home/namandev2704/projects/ts-packages/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/bin/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/typescript@5.9.3/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/home/namandev2704/projects/ts-packages/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/bin/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/typescript@5.9.3/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../typescript/bin/tsserver" "$@"
+else
+  exec node  "$basedir/../typescript/bin/tsserver" "$@"
+fi

package/packages/cache/package.json

@@ -0,0 +1,52 @@
+{
+    "name": "@naman_deep_singh/cache",
+    "version": "1.4.0",
+    "description": "Extensible caching layer supporting Redis, Memcache, and in-memory caches with automatic fallback, namespacing, session management, and Express middleware.",
+    "type": "module",
+    "main": "./dist/cjs/index.js",
+    "module": "./dist/esm/index.js",
+    "exports": {
+        ".": {
+            "import": "./dist/esm/index.js",
+            "require": "./dist/cjs/index.js",
+            "types": "./dist/types/index.d.ts"
+        }
+    },
+    "sideEffects": false,
+    "files": [
+        "dist",
+        "README.md"
+    ],
+    "scripts": {
+        "build": "pnpm run build:types && tsc -p tsconfig.cjs.json && tsc -p tsconfig.esm.json",
+        "build:types": "tsc -p tsconfig.base.json --emitDeclarationOnly --outDir dist/types",
+        "clean": "rimraf dist",
+        "prepublishOnly": "npm run clean && npm run build"
+    },
+    "keywords": [
+        "cache",
+        "redis",
+        "memcache",
+        "session",
+        "caching",
+        "typescript",
+        "microservices"
+    ],
+    "author": "Naman Deep Singh",
+    "license": "ISC",
+    "packageManager": "pnpm@10.20.0",
+    "devDependencies": {
+        "@types/express": "^5.0.5",
+        "@types/memcached": "^2.2.7",
+        "@types/node": "^25.0.1",
+        "express": "^5.1.0",
+        "rimraf": "^5.0.5",
+        "typescript": "^5.9.3"
+    },
+    "dependencies": {
+        "@naman_deep_singh/errors-utils": "^1.4.2",
+        "@naman_deep_singh/response-utils": "^2.1.4",
+        "memcached": "^2.2.2",
+        "redis": "^4.6.10"
+    }
+}

package/packages/cache/src/adapters/memcache/MemcacheCache.ts

@@ -0,0 +1,179 @@
+import Memcached from 'memcached'
+import { CACHE_ERROR_CODES } from 'src/errors/cacheErrorCodes'
+import { BaseCache } from '../../core/BaseCache'
+import { CacheError } from '../../errors'
+import type { HealthCheckResponse, MemcacheCacheConfig } from '../../types'
+
+export class MemcacheCache<T = unknown> extends BaseCache<T> {
+	private client: Memcached | null = null
+	private isConnected = false
+
+	constructor(private memcacheConfig: MemcacheCacheConfig) {
+		super(memcacheConfig)
+	}
+
+	async connect(): Promise<void> {
+		try {
+			const servers = Array.isArray(this.memcacheConfig.servers)
+				? this.memcacheConfig.servers
+				: [this.memcacheConfig.servers]
+
+			this.client = new Memcached(servers, {
+				retries: 2,
+				retry: 30000,
+				remove: true,
+				maxValue: 1048576,
+				idle: 30000,
+			})
+
+			this.isConnected = true
+			await this.ping()
+		} catch (error) {
+			throw new CacheError(CACHE_ERROR_CODES.CACHE_CONNECTION_FAILED, {
+				adapter: 'memcache',
+				operation: 'connect',
+				cause: error instanceof Error ? error : undefined,
+			})
+		}
+	}
+
+	private async ensureConnected(): Promise<void> {
+		if (!this.client) {
+			await this.connect()
+		}
+	}
+
+	private async ping(): Promise<void> {
+		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: string): Promise<boolean> {
+		try {
+			const value = await this.get(key)
+			return value !== null
+		} catch (error) {
+			throw new CacheError(CACHE_ERROR_CODES.CACHE_ERROR, {
+				adapter: 'memcache',
+				operation: 'exists',
+				details: { key },
+				cause: error instanceof Error ? error : undefined,
+			})
+		}
+	}
+
+	async get(key: string): Promise<T | null> {
+		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 CacheError(CACHE_ERROR_CODES.CACHE_KEY_NOT_FOUND, {
+				adapter: 'memcache',
+				operation: 'get',
+				details: { key },
+				cause: error instanceof Error ? error : undefined,
+			})
+		}
+	}
+
+	async set(key: string, value: T, ttl?: number): Promise<void> {
+		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 CacheError(CACHE_ERROR_CODES.CACHE_ERROR, {
+				adapter: 'memcache',
+				operation: 'set',
+				details: { key },
+				cause: error instanceof Error ? error : undefined,
+			})
+		}
+	}
+
+	async delete(key: string): Promise<boolean> {
+		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 CacheError(CACHE_ERROR_CODES.CACHE_ERROR, {
+				adapter: 'memcache',
+				operation: 'delete',
+				details: { key },
+				cause: error instanceof Error ? error : undefined,
+			})
+		}
+	}
+
+	async clear(): Promise<void> {
+		try {
+			await this.ensureConnected()
+			return new Promise((resolve, reject) => {
+				this.client!.flush((err) => (err ? reject(err) : resolve()))
+			})
+		} catch (error) {
+			throw new CacheError(CACHE_ERROR_CODES.CACHE_OPERATION_TIMEOUT, {
+				adapter: 'memcache',
+				operation: 'clear',
+				cause: error instanceof Error ? error : undefined,
+			})
+		}
+	}
+
+	async isAlive(): Promise<HealthCheckResponse> {
+		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(): Promise<void> {
+		try {
+			this.client?.end()
+			this.client = null
+			this.isConnected = false
+		} catch (error) {
+			throw new CacheError(CACHE_ERROR_CODES.CACHE_ERROR, {
+				adapter: 'memcache',
+				operation: 'close',
+				cause: error instanceof Error ? error : undefined,
+			})
+		}
+	}
+}

package/packages/cache/src/adapters/memcache/index.ts

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