@wgtechlabs/nuvex 0.1.1

package/dist/cjs/layers/redis.js

@@ -0,0 +1,388 @@
+"use strict";
+/**
+ * Nuvex - Redis Storage Layer (L2)
+ * Next-gen Unified Vault Experience
+ *
+ * Redis distributed cache layer providing fast, persistent caching across
+ * multiple application instances. Acts as the middle tier in the storage hierarchy.
+ *
+ * Features:
+ * - Distributed caching for multi-instance deployments
+ * - Fast access times (1-5ms typical)
+ * - Automatic TTL-based expiration
+ * - Connection health monitoring
+ * - Graceful degradation on failures
+ *
+ * @author Waren Gonzaga, WG Technology Labs
+ * @since 2025
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedisStorage = void 0;
+const redis_1 = require("redis");
+/**
+ * Redis Storage Layer - L2 Distributed Cache
+ *
+ * Implements distributed caching using Redis. This layer provides fast access
+ * to frequently used data while supporting multiple application instances.
+ * Redis data persists across application restarts (depending on Redis configuration).
+ *
+ * **Key Features:**
+ * - Distributed cache shared across instances
+ * - Configurable TTL for automatic expiration
+ * - JSON serialization for complex objects
+ * - Graceful error handling with logging
+ * - Connection health monitoring via PING
+ *
+ * **Performance Characteristics:**
+ * - Get: O(1) network + Redis lookup
+ * - Set: O(1) network + Redis write
+ * - Latency: 1-5ms typical (network dependent)
+ *
+ * **Error Handling:**
+ * - Returns null on connection failures
+ * - Logs errors for monitoring
+ * - Doesn't throw to allow graceful degradation
+ *
+ * @implements {StorageLayerInterface}
+ *
+ * @example
+ * ```typescript
+ * // Create Redis layer
+ * const redis = new RedisStorage('redis://localhost:6379');
+ *
+ * // Connect to Redis
+ * await redis.connect();
+ *
+ * // Store with 5 minute TTL
+ * await redis.set('session:abc', sessionData, 300);
+ *
+ * // Retrieve data
+ * const data = await redis.get('session:abc');
+ *
+ * // Check health
+ * const isHealthy = await redis.ping();
+ * ```
+ *
+ * @class RedisStorage
+ * @since 1.0.0
+ */
+class RedisStorage {
+    /**
+     * Creates a new RedisStorage instance
+     *
+     * Note: The instance is created but not connected. Call connect() to establish
+     * the Redis connection.
+     *
+     * @param url - Redis connection URL (e.g., redis://localhost:6379)
+     * @param logger - Optional logger for debugging
+     *
+     * @example
+     * ```typescript
+     * const redis = new RedisStorage('redis://localhost:6379', console);
+     * await redis.connect();
+     * ```
+     */
+    constructor(url, logger = null) {
+        this.url = url;
+        this.client = null;
+        this.connected = false;
+        this.logger = logger;
+    }
+    /**
+     * Establish connection to Redis
+     *
+     * Creates and connects the Redis client. Should be called before any
+     * storage operations.
+     *
+     * @throws {Error} If connection fails
+     *
+     * @example
+     * ```typescript
+     * try {
+     *   await redis.connect();
+     *   console.log('Redis connected');
+     * } catch (error) {
+     *   console.error('Redis connection failed:', error);
+     * }
+     * ```
+     */
+    async connect() {
+        try {
+            this.client = (0, redis_1.createClient)({ url: this.url });
+            // Set up error handler
+            this.client.on('error', (err) => {
+                this.log('error', 'Redis L2: Connection error', { error: err.message });
+            });
+            await this.client.connect();
+            this.connected = true;
+            this.log('info', 'Redis L2: Connected successfully');
+        }
+        catch (error) {
+            this.connected = false;
+            this.log('error', 'Redis L2: Connection failed', {
+                error: error instanceof Error ? error.message : String(error)
+            });
+            throw error;
+        }
+    }
+    /**
+     * Close Redis connection
+     *
+     * Gracefully closes the Redis connection. Should be called during
+     * application shutdown.
+     *
+     * @example
+     * ```typescript
+     * await redis.disconnect();
+     * ```
+     */
+    async disconnect() {
+        if (this.client) {
+            await this.client.quit();
+            this.connected = false;
+            this.log('info', 'Redis L2: Disconnected');
+        }
+    }
+    /**
+     * Retrieve a value from Redis cache
+     *
+     * Deserializes the JSON-stored value. Returns null if the key doesn't exist
+     * or if there's a connection/parsing error.
+     *
+     * @param key - The key to retrieve
+     * @returns Promise resolving to the value or null if not found
+     *
+     * @example
+     * ```typescript
+     * const userData = await redis.get('user:123');
+     * if (userData !== null) {
+     *   console.log('Found in Redis');
+     * }
+     * ```
+     */
+    async get(key) {
+        if (!this.connected || !this.client) {
+            return null;
+        }
+        try {
+            const value = await this.client.get(key);
+            if (value === null) {
+                return null;
+            }
+            return JSON.parse(value);
+        }
+        catch (error) {
+            this.log('error', `Redis L2: Error getting key: ${key}`, {
+                error: error instanceof Error ? error.message : String(error)
+            });
+            return null;
+        }
+    }
+    /**
+     * Store a value in Redis cache
+     *
+     * Serializes the value as JSON and stores it with optional TTL.
+     * If TTL is not provided, the key will persist indefinitely (until manually deleted).
+     *
+     * @param key - The key to store
+     * @param value - The value to store (will be JSON serialized)
+     * @param ttlSeconds - Optional TTL in seconds
+     *
+     * @example
+     * ```typescript
+     * // Store with 1 hour TTL
+     * await redis.set('session:abc', sessionData, 3600);
+     *
+     * // Store without TTL (persists until deleted)
+     * await redis.set('config:app', configData);
+     * ```
+     */
+    async set(key, value, ttlSeconds) {
+        if (!this.connected || !this.client) {
+            this.log('warn', 'Redis L2: Cannot set - not connected', { key });
+            return;
+        }
+        try {
+            const serialized = JSON.stringify(value);
+            if (ttlSeconds) {
+                await this.client.setEx(key, ttlSeconds, serialized);
+            }
+            else {
+                await this.client.set(key, serialized);
+            }
+        }
+        catch (error) {
+            this.log('error', `Redis L2: Error setting key: ${key}`, {
+                error: error instanceof Error ? error.message : String(error)
+            });
+        }
+    }
+    /**
+     * Delete a value from Redis cache
+     *
+     * @param key - The key to delete
+     *
+     * @example
+     * ```typescript
+     * await redis.delete('session:expired');
+     * ```
+     */
+    async delete(key) {
+        if (!this.connected || !this.client) {
+            return;
+        }
+        try {
+            await this.client.del(key);
+        }
+        catch (error) {
+            this.log('error', `Redis L2: Error deleting key: ${key}`, {
+                error: error instanceof Error ? error.message : String(error)
+            });
+        }
+    }
+    /**
+     * Check if a key exists in Redis cache
+     *
+     * @param key - The key to check
+     * @returns Promise resolving to true if the key exists
+     *
+     * @example
+     * ```typescript
+     * if (await redis.exists('user:123')) {
+     *   console.log('Key exists in Redis');
+     * }
+     * ```
+     */
+    async exists(key) {
+        if (!this.connected || !this.client) {
+            return false;
+        }
+        try {
+            const result = await this.client.exists(key);
+            return result === 1;
+        }
+        catch (error) {
+            this.log('error', `Redis L2: Error checking existence: ${key}`, {
+                error: error instanceof Error ? error.message : String(error)
+            });
+            return false;
+        }
+    }
+    /**
+     * Clear all keys from Redis database
+     *
+     * **WARNING:** This operation flushes the entire Redis database.
+     * Use with caution in production environments.
+     *
+     * @example
+     * ```typescript
+     * await redis.clear(); // Flushes entire Redis DB
+     * ```
+     */
+    async clear() {
+        if (!this.connected || !this.client) {
+            return;
+        }
+        try {
+            await this.client.flushDb();
+            this.log('info', 'Redis L2: Database flushed');
+        }
+        catch (error) {
+            this.log('error', 'Redis L2: Error flushing database', {
+                error: error instanceof Error ? error.message : String(error)
+            });
+        }
+    }
+    /**
+     * Health check for Redis connection
+     *
+     * Uses Redis PING command to verify connectivity and responsiveness.
+     * Returns false if not connected or if PING fails.
+     *
+     * @returns Promise resolving to true if Redis is healthy and responsive
+     *
+     * @example
+     * ```typescript
+     * const isHealthy = await redis.ping();
+     * if (!isHealthy) {
+     *   console.error('Redis connection is down');
+     * }
+     * ```
+     */
+    async ping() {
+        if (!this.connected || !this.client) {
+            return false;
+        }
+        try {
+            const result = await this.client.ping();
+            return result === 'PONG';
+        }
+        catch (error) {
+            this.log('error', 'Redis L2: Ping failed', {
+                error: error instanceof Error ? error.message : String(error)
+            });
+            return false;
+        }
+    }
+    /**
+     * Check if Redis is connected
+     *
+     * @returns True if connected
+     */
+    isConnected() {
+        return this.connected;
+    }
+    /**
+     * Atomically increment a numeric value
+     *
+     * Uses Redis INCRBY command for true atomic increments that are safe
+     * across multiple instances and concurrent requests.
+     *
+     * @param key - The key to increment
+     * @param delta - The amount to increment by
+     * @param ttlSeconds - Optional TTL in seconds
+     * @returns Promise resolving to the new value after increment
+     *
+     * @example
+     * ```typescript
+     * // Atomic increment - safe for concurrent access
+     * const newValue = await redis.increment('counter', 1, 3600);
+     * ```
+     */
+    async increment(key, delta, ttlSeconds) {
+        if (!this.connected || !this.client) {
+            this.log('warn', 'Redis L2: Cannot increment - not connected', { key });
+            throw new Error('Redis not connected');
+        }
+        try {
+            // Use INCRBY for atomic increment
+            const newValue = await this.client.incrBy(key, delta);
+            // Set TTL if specified
+            if (ttlSeconds) {
+                await this.client.expire(key, ttlSeconds);
+            }
+            return newValue;
+        }
+        catch (error) {
+            this.log('error', `Redis L2: Error incrementing key: ${key}`, {
+                error: error instanceof Error ? error.message : String(error)
+            });
+            throw error;
+        }
+    }
+    /**
+     * Log a message if logger is configured
+     *
+     * @private
+     * @param level - Log level
+     * @param message - Log message
+     * @param meta - Optional metadata
+     */
+    log(level, message, meta) {
+        if (this.logger) {
+            this.logger[level](message, meta);
+        }
+    }
+}
+exports.RedisStorage = RedisStorage;
+//# sourceMappingURL=redis.js.map

package/dist/cjs/layers/redis.js.map

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

package/dist/cjs/types/index.js

@@ -0,0 +1,52 @@
+"use strict";
+/**
+ * Nuvex - Type Definitions
+ * Next-gen Unified Vault Experience
+ *
+ * Comprehensive type definitions for the multi-layer storage SDK.
+ * Provides type safety and IntelliSense support for all storage operations,
+ * configurations, and data structures.
+ *
+ * @author Waren Gonzaga, WG Technology Labs
+ * @since 2025
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LogLevel = exports.StorageLayer = void 0;
+// ===== Enum Types =====
+/**
+ * Storage layer enumeration
+ *
+ * Defines the available storage layers in the multi-tier architecture.
+ * Each layer has different performance characteristics and use cases.
+ *
+ * @enum {string}
+ */
+var StorageLayer;
+(function (StorageLayer) {
+    /** In-memory cache layer - fastest access, volatile storage */
+    StorageLayer["MEMORY"] = "memory";
+    /** Redis cache layer - fast distributed cache, configurable persistence */
+    StorageLayer["REDIS"] = "redis";
+    /** PostgreSQL layer - persistent storage, ACID compliance */
+    StorageLayer["POSTGRES"] = "postgres";
+})(StorageLayer || (exports.StorageLayer = StorageLayer = {}));
+/**
+ * Logging level enumeration
+ *
+ * Defines the available logging levels for the system logger.
+ *
+ * @enum {string}
+ */
+var LogLevel;
+(function (LogLevel) {
+    /** Detailed debug information */
+    LogLevel["DEBUG"] = "debug";
+    /** General information messages */
+    LogLevel["INFO"] = "info";
+    /** Warning messages for non-critical issues */
+    LogLevel["WARN"] = "warn";
+    /** Error messages for failures and exceptions */
+    LogLevel["ERROR"] = "error";
+})(LogLevel || (exports.LogLevel = LogLevel = {}));
+// ===== Export all types =====
+//# sourceMappingURL=index.js.map

package/dist/cjs/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAyYH,yBAAyB;AAEzB;;;;;;;GAOG;AACH,IAAY,YAOX;AAPD,WAAY,YAAY;IACtB,+DAA+D;IAC/D,iCAAiB,CAAA;IACjB,2EAA2E;IAC3E,+BAAe,CAAA;IACf,6DAA6D;IAC7D,qCAAqB,CAAA;AACvB,CAAC,EAPW,YAAY,4BAAZ,YAAY,QAOvB;AAED;;;;;;GAMG;AACH,IAAY,QASX;AATD,WAAY,QAAQ;IAClB,iCAAiC;IACjC,2BAAe,CAAA;IACf,mCAAmC;IACnC,yBAAa,CAAA;IACb,+CAA+C;IAC/C,yBAAa,CAAA;IACb,iDAAiD;IACjD,2BAAe,CAAA;AACjB,CAAC,EATW,QAAQ,wBAAR,QAAQ,QASnB;AAED,+BAA+B"}