@arcraz/common 1.0.0

package/dist/rabbitmq/namespace-helpers.js

@@ -0,0 +1,44 @@
+/**
+ * CRITICAL: RabbitMQ namespace pattern - NODE_ENV-queue
+ * This MUST be preserved for environment isolation in RabbitMQ
+ */
+/**
+ * Gets the namespaced queue name with environment prefix
+ * Format: environment-queue
+ * @param queue The base queue name
+ * @param namespace Optional namespace override (defaults to NODE_ENV)
+ * @returns The namespaced queue name
+ */
+export function getNamespacedQueue(queue, namespace) {
+    const env = namespace || process.env.NODE_ENV || 'local';
+    return `${env}-${queue}`;
+}
+/**
+ * Gets the namespaced exchange name with environment prefix
+ * Format: environment-exchange
+ * @param exchange The base exchange name
+ * @param namespace Optional namespace override (defaults to NODE_ENV)
+ * @returns The namespaced exchange name
+ */
+export function getNamespacedExchange(exchange, namespace) {
+    const env = namespace || process.env.NODE_ENV || 'local';
+    return `${env}-${exchange}`;
+}
+/**
+ * Strips the namespace prefix from a queue name
+ * @param queue The namespaced queue name
+ * @returns The queue name without namespace prefix
+ */
+export function stripQueueNamespace(queue) {
+    const match = queue.match(/^[^-]+-(.+)$/);
+    return match ? match[1] : queue;
+}
+/**
+ * Extracts the namespace from a namespaced queue name
+ * @param queue The namespaced queue name
+ * @returns The namespace or null if not namespaced
+ */
+export function extractQueueNamespace(queue) {
+    const match = queue.match(/^([^-]+)-/);
+    return match ? match[1] : null;
+}

package/dist/rabbitmq/publisher.d.ts

@@ -0,0 +1,27 @@
+import type { RabbitMQConnection, PublishOptions, DelaySettings } from './types.js';
+/**
+ * Publishes a message to a queue
+ * @param conn RabbitMQ connection
+ * @param queue Queue name (will be namespaced)
+ * @param data Message data (will be JSON stringified)
+ * @param options Publish options
+ */
+export declare function publish(conn: RabbitMQConnection, queue: string, data: unknown, options?: PublishOptions): Promise<boolean>;
+/**
+ * Publishes a message with delay using delayed exchange
+ * @param conn RabbitMQ connection
+ * @param queue Queue name (will be namespaced)
+ * @param data Message data (will be JSON stringified)
+ * @param delay Delay settings
+ * @param options Additional publish options
+ */
+export declare function publishWithDelay(conn: RabbitMQConnection, queue: string, data: unknown, delay: DelaySettings, options?: PublishOptions): Promise<boolean>;
+/**
+ * Publishes to a fanout exchange (broadcasts to all bound queues)
+ * @param conn RabbitMQ connection
+ * @param exchange Exchange name (will be namespaced)
+ * @param data Message data
+ * @param options Publish options
+ */
+export declare function publishToExchange(conn: RabbitMQConnection, exchange: string, data: unknown, routingKey?: string, options?: PublishOptions): boolean;
+//# sourceMappingURL=publisher.d.ts.map

package/dist/rabbitmq/publisher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publisher.d.ts","sourceRoot":"","sources":["../../src/rabbitmq/publisher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAIpF;;;;;;GAMG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,CA0BpI;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,CA8CnK;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,GAAE,MAAW,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAQ3J"}

package/dist/rabbitmq/publisher.js

@@ -0,0 +1,94 @@
+import { getNamespacedQueue, getNamespacedExchange } from './namespace-helpers.js';
+import { RABBITMQ_DEFAULTS } from '../constants/defaults.js';
+/**
+ * Publishes a message to a queue
+ * @param conn RabbitMQ connection
+ * @param queue Queue name (will be namespaced)
+ * @param data Message data (will be JSON stringified)
+ * @param options Publish options
+ */
+export async function publish(conn, queue, data, options = {}) {
+    const finalQueue = getNamespacedQueue(queue, conn.namespace);
+    const content = Buffer.from(JSON.stringify(data));
+    // Ensure queue exists
+    await conn.channel.assertQueue(finalQueue, {
+        durable: true
+    });
+    const publishOptions = {
+        persistent: options.persistent ?? true,
+        priority: options.priority,
+        expiration: options.expiration,
+        correlationId: options.correlationId,
+        replyTo: options.replyTo,
+        headers: options.headers
+    };
+    // Remove undefined values
+    Object.keys(publishOptions).forEach((key) => {
+        if (publishOptions[key] === undefined) {
+            delete publishOptions[key];
+        }
+    });
+    return conn.channel.sendToQueue(finalQueue, content, publishOptions);
+}
+/**
+ * Publishes a message with delay using delayed exchange
+ * @param conn RabbitMQ connection
+ * @param queue Queue name (will be namespaced)
+ * @param data Message data (will be JSON stringified)
+ * @param delay Delay settings
+ * @param options Additional publish options
+ */
+export async function publishWithDelay(conn, queue, data, delay, options = {}) {
+    const finalQueue = getNamespacedQueue(queue, conn.namespace);
+    const exchangeName = delay.delayExchange || RABBITMQ_DEFAULTS.DEFAULT_DELAY_EXCHANGE;
+    const finalExchange = getNamespacedExchange(exchangeName, conn.namespace);
+    // Track delay attempts if using max delays
+    let messageData = data;
+    if (typeof data === 'object' && data !== null) {
+        const delaySettings = {
+            ...delay,
+            delayAttempts: (delay.delayAttempts ?? 0) + 1
+        };
+        // Check if we've exceeded max delays
+        if (delay.maxDelays && delaySettings.delayAttempts > delay.maxDelays) {
+            console.log(`Max delay attempts (${delay.maxDelays}) exceeded for queue ${queue}`);
+            return false;
+        }
+        messageData = {
+            ...data,
+            delaySettings
+        };
+    }
+    const content = Buffer.from(JSON.stringify(messageData));
+    // Assert delayed exchange (requires delayed-message-exchange plugin)
+    await conn.channel.assertExchange(finalExchange, 'x-delayed-message', {
+        durable: true,
+        arguments: { 'x-delayed-type': 'direct' }
+    });
+    // Ensure queue exists and bind to exchange
+    await conn.channel.assertQueue(finalQueue, { durable: true });
+    await conn.channel.bindQueue(finalQueue, finalExchange, finalQueue);
+    const headers = {
+        ...options.headers,
+        'x-delay': delay.delayTime
+    };
+    return conn.channel.publish(finalExchange, finalQueue, content, {
+        persistent: options.persistent ?? true,
+        headers
+    });
+}
+/**
+ * Publishes to a fanout exchange (broadcasts to all bound queues)
+ * @param conn RabbitMQ connection
+ * @param exchange Exchange name (will be namespaced)
+ * @param data Message data
+ * @param options Publish options
+ */
+export function publishToExchange(conn, exchange, data, routingKey = '', options = {}) {
+    const finalExchange = getNamespacedExchange(exchange, conn.namespace);
+    const content = Buffer.from(JSON.stringify(data));
+    return conn.channel.publish(finalExchange, routingKey, content, {
+        persistent: options.persistent ?? true,
+        headers: options.headers
+    });
+}

package/dist/rabbitmq/types.d.ts

@@ -0,0 +1,94 @@
+import type { Connection, Channel, ConsumeMessage } from 'amqplib';
+/**
+ * RabbitMQ connection instance
+ */
+export interface RabbitMQConnection {
+    /** The underlying amqplib connection */
+    connection: Connection;
+    /** The main channel for operations */
+    channel: Channel;
+    /** Default namespace for queues */
+    namespace: string;
+    /** Application name for connection identification */
+    appName: string;
+    /** Close the connection */
+    close(): Promise<void>;
+    /** Check if connected */
+    isConnected(): boolean;
+    /** Reconnect to RabbitMQ */
+    reconnect(): Promise<void>;
+}
+/**
+ * RabbitMQ connection configuration
+ */
+export interface RabbitMQConnectionConfig {
+    host: string;
+    port?: number;
+    username: string;
+    password: string;
+    vhost?: string;
+    heartbeat?: number;
+    connectionTimeout?: number;
+    protocol?: 'amqp' | 'amqps';
+    appName?: string;
+    namespace?: string;
+}
+/**
+ * Delay settings for delayed message requeue
+ */
+export interface DelaySettings {
+    /** Delay exchange name */
+    delayExchange?: string;
+    /** Delay time in milliseconds */
+    delayTime: number;
+    /** Current delay attempt count */
+    delayAttempts?: number;
+    /** Maximum number of delay attempts */
+    maxDelays?: number;
+}
+/**
+ * Options for publishing messages
+ */
+export interface PublishOptions {
+    /** Whether message should persist to disk */
+    persistent?: boolean;
+    /** Message priority (0-9) */
+    priority?: number;
+    /** Message expiration in milliseconds */
+    expiration?: string;
+    /** Correlation ID for RPC patterns */
+    correlationId?: string;
+    /** Reply-to queue for RPC patterns */
+    replyTo?: string;
+    /** Custom headers */
+    headers?: Record<string, unknown>;
+    /** Delay settings for delayed messages */
+    delay?: DelaySettings;
+}
+/**
+ * Options for consuming messages
+ */
+export interface ConsumeOptions {
+    /** Consumer tag for identification */
+    consumerTag?: string;
+    /** Whether to acknowledge automatically */
+    noAck?: boolean;
+    /** Prefetch count for this consumer */
+    prefetch?: number;
+}
+/**
+ * Message handler function type
+ */
+export type MessageHandler = (message: ConsumeMessage, content: unknown) => Promise<void> | void;
+/**
+ * Consumer instance interface
+ */
+export interface RabbitMQConsumer {
+    /** Queue being consumed */
+    queue: string;
+    /** Consumer tag */
+    consumerTag: string;
+    /** Stop consuming */
+    cancel(): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/rabbitmq/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,wCAAwC;IACxC,UAAU,EAAE,UAAU,CAAC;IACvB,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,yBAAyB;IACzB,WAAW,IAAI,OAAO,CAAC;IACvB,4BAA4B;IAC5B,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,0BAA0B;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,6CAA6C;IAC7C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,0CAA0C;IAC1C,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAEjG;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB;IACrB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB"}

package/dist/rabbitmq/types.js

@@ -0,0 +1 @@
+export {};

package/dist/redis/client-factory.d.ts

@@ -0,0 +1,14 @@
+import type { RedisInstance, RedisInstanceConfig, RedisClusterInstanceConfig } from './types.js';
+/**
+ * Creates a single Redis instance
+ * @param config Redis configuration
+ * @returns RedisInstance wrapper
+ */
+export declare function createRedisClient(config: RedisInstanceConfig): RedisInstance;
+/**
+ * Creates a Redis cluster instance
+ * @param config Cluster configuration
+ * @returns RedisInstance wrapper
+ */
+export declare function createRedisCluster(config: RedisClusterInstanceConfig): RedisInstance;
+//# sourceMappingURL=client-factory.d.ts.map

package/dist/redis/client-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-factory.d.ts","sourceRoot":"","sources":["../../src/redis/client-factory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAGjG;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,mBAAmB,GAAG,aAAa,CAgD5E;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,0BAA0B,GAAG,aAAa,CA8CpF"}

package/dist/redis/client-factory.js

@@ -0,0 +1,98 @@
+import { Redis, Cluster } from 'ioredis';
+import { REDIS_DEFAULTS } from '../constants/defaults.js';
+/**
+ * Creates a single Redis instance
+ * @param config Redis configuration
+ * @returns RedisInstance wrapper
+ */
+export function createRedisClient(config) {
+    const client = new Redis({
+        host: config.host,
+        port: config.port ?? REDIS_DEFAULTS.PORT,
+        password: config.password,
+        db: config.db ?? REDIS_DEFAULTS.DB,
+        keyPrefix: config.keyPrefix,
+        tls: config.tls ? {} : undefined,
+        connectTimeout: config.connectTimeout ?? REDIS_DEFAULTS.CONNECT_TIMEOUT_MS,
+        commandTimeout: config.commandTimeout ?? REDIS_DEFAULTS.COMMAND_TIMEOUT_MS,
+        retryStrategy: (times) => {
+            if (times > REDIS_DEFAULTS.MAX_RETRIES) {
+                return null; // Stop retrying
+            }
+            return Math.min(times * REDIS_DEFAULTS.RETRY_DELAY_MS, 2000);
+        },
+        lazyConnect: false
+    });
+    const namespace = config.namespace || process.env.NODE_ENV || 'local';
+    let connected = false;
+    client.on('connect', () => {
+        connected = true;
+        console.log('Redis Connection: Single Instance connected');
+    });
+    client.on('error', (err) => {
+        console.error('Redis error:', err);
+        connected = false;
+    });
+    client.on('close', () => {
+        connected = false;
+    });
+    return {
+        client,
+        isCluster: false,
+        namespace,
+        async close() {
+            await client.quit();
+            connected = false;
+        },
+        isConnected() {
+            return connected;
+        }
+    };
+}
+/**
+ * Creates a Redis cluster instance
+ * @param config Cluster configuration
+ * @returns RedisInstance wrapper
+ */
+export function createRedisCluster(config) {
+    const client = new Cluster(config.nodes, {
+        redisOptions: {
+            password: config.password,
+            keyPrefix: config.keyPrefix,
+            tls: config.tls ? {} : undefined,
+            connectTimeout: config.connectTimeout ?? REDIS_DEFAULTS.CONNECT_TIMEOUT_MS,
+            commandTimeout: config.commandTimeout ?? REDIS_DEFAULTS.COMMAND_TIMEOUT_MS
+        },
+        clusterRetryStrategy: (times) => {
+            if (times > REDIS_DEFAULTS.MAX_RETRIES) {
+                return null;
+            }
+            return Math.min(times * REDIS_DEFAULTS.RETRY_DELAY_MS, 2000);
+        }
+    });
+    const namespace = config.namespace || process.env.NODE_ENV || 'local';
+    let connected = false;
+    client.on('connect', () => {
+        connected = true;
+        console.log('Redis Connection: Cluster connected');
+    });
+    client.on('error', (err) => {
+        console.error('Redis cluster error:', err);
+        connected = false;
+    });
+    client.on('close', () => {
+        connected = false;
+    });
+    return {
+        client,
+        isCluster: true,
+        namespace,
+        async close() {
+            await client.quit();
+            connected = false;
+        },
+        isConnected() {
+            return connected;
+        }
+    };
+}

package/dist/redis/index.d.ts

@@ -0,0 +1,6 @@
+export { createRedisClient, createRedisCluster } from './client-factory.js';
+export { getNamespacedKey, processKey, stripNamespace, extractNamespace } from './namespace-helpers.js';
+export { set, get, del, exists, keys, expire, ttl, incr, incrBy, decr, listPush, lpush, rpush, lpop, rpop, lrange, lgetall, llen, lindex, lset, ltrim } from './operations/index.js';
+export { ListPosition } from './types.js';
+export type { RedisClient, RedisData, RedisInstance, RedisInstanceConfig, RedisClusterInstanceConfig, SetOptions, GetOptions } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/redis/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE5E,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAExG,OAAO,EACL,GAAG,EACH,GAAG,EACH,GAAG,EACH,MAAM,EACN,IAAI,EACJ,MAAM,EACN,GAAG,EACH,IAAI,EACJ,MAAM,EACN,IAAI,EACJ,QAAQ,EACR,KAAK,EACL,KAAK,EACL,IAAI,EACJ,IAAI,EACJ,MAAM,EACN,OAAO,EACP,IAAI,EACJ,MAAM,EACN,IAAI,EACJ,KAAK,EACN,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/redis/index.js

@@ -0,0 +1,4 @@
+export { createRedisClient, createRedisCluster } from './client-factory.js';
+export { getNamespacedKey, processKey, stripNamespace, extractNamespace } from './namespace-helpers.js';
+export { set, get, del, exists, keys, expire, ttl, incr, incrBy, decr, listPush, lpush, rpush, lpop, rpop, lrange, lgetall, llen, lindex, lset, ltrim } from './operations/index.js';
+export { ListPosition } from './types.js';

package/dist/redis/namespace-helpers.d.ts

@@ -0,0 +1,33 @@
+/**
+ * CRITICAL: Redis namespace pattern - {NODE_ENV}:key
+ * This MUST be preserved for environment isolation in Redis clusters
+ */
+/**
+ * Gets the namespaced key with environment prefix
+ * Format: {environment}:key
+ * @param key The base key
+ * @param namespace Optional namespace override (defaults to NODE_ENV)
+ * @returns The namespaced key
+ */
+export declare function getNamespacedKey(key: string, namespace?: string): string;
+/**
+ * Processes a key, optionally adding namespace
+ * @param key The base key
+ * @param useNamespace Whether to add namespace prefix
+ * @param namespace Optional namespace override
+ * @returns The processed key
+ */
+export declare function processKey(key: string, useNamespace?: boolean, namespace?: string): string;
+/**
+ * Strips the namespace prefix from a key
+ * @param key The namespaced key
+ * @returns The key without namespace prefix
+ */
+export declare function stripNamespace(key: string): string;
+/**
+ * Extracts the namespace from a namespaced key
+ * @param key The namespaced key
+ * @returns The namespace or null if not namespaced
+ */
+export declare function extractNamespace(key: string): string | null;
+//# sourceMappingURL=namespace-helpers.d.ts.map

package/dist/redis/namespace-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespace-helpers.d.ts","sourceRoot":"","sources":["../../src/redis/namespace-helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAGxE;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,GAAE,OAAc,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAEhG;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGlD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG3D"}

package/dist/redis/namespace-helpers.js

@@ -0,0 +1,43 @@
+/**
+ * CRITICAL: Redis namespace pattern - {NODE_ENV}:key
+ * This MUST be preserved for environment isolation in Redis clusters
+ */
+/**
+ * Gets the namespaced key with environment prefix
+ * Format: {environment}:key
+ * @param key The base key
+ * @param namespace Optional namespace override (defaults to NODE_ENV)
+ * @returns The namespaced key
+ */
+export function getNamespacedKey(key, namespace) {
+    const env = namespace || process.env.NODE_ENV || 'local';
+    return `{${env}}:${key}`;
+}
+/**
+ * Processes a key, optionally adding namespace
+ * @param key The base key
+ * @param useNamespace Whether to add namespace prefix
+ * @param namespace Optional namespace override
+ * @returns The processed key
+ */
+export function processKey(key, useNamespace = true, namespace) {
+    return useNamespace ? getNamespacedKey(key, namespace) : key;
+}
+/**
+ * Strips the namespace prefix from a key
+ * @param key The namespaced key
+ * @returns The key without namespace prefix
+ */
+export function stripNamespace(key) {
+    const match = key.match(/^\{[^}]+\}:(.+)$/);
+    return match ? match[1] : key;
+}
+/**
+ * Extracts the namespace from a namespaced key
+ * @param key The namespaced key
+ * @returns The namespace or null if not namespaced
+ */
+export function extractNamespace(key) {
+    const match = key.match(/^\{([^}]+)\}:/);
+    return match ? match[1] : null;
+}

package/dist/redis/operations/index.d.ts

@@ -0,0 +1,3 @@
+export { set, get, del, exists, keys, expire, ttl, incr, incrBy, decr } from './standard.js';
+export { listPush, lpush, rpush, lpop, rpop, lrange, lgetall, llen, lindex, lset, ltrim } from './list.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/redis/operations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/redis/operations/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAE7F,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC"}

package/dist/redis/operations/index.js

@@ -0,0 +1,2 @@
+export { set, get, del, exists, keys, expire, ttl, incr, incrBy, decr } from './standard.js';
+export { listPush, lpush, rpush, lpop, rpop, lrange, lgetall, llen, lindex, lset, ltrim } from './list.js';

package/dist/redis/operations/list.d.ts

@@ -0,0 +1,102 @@
+import type { RedisInstance, RedisData } from '../types.js';
+import { ListPosition } from '../types.js';
+/**
+ * Adds an element to a list
+ * @param redis Redis instance
+ * @param key The list key
+ * @param position Where to add (front or back)
+ * @param data The data to add
+ * @param useNamespace Whether to apply namespace
+ * @returns Length of list after operation
+ */
+export declare function listPush(redis: RedisInstance, key: string, position: ListPosition, data: RedisData, useNamespace?: boolean): Promise<number>;
+/**
+ * Adds an element to the front of a list
+ * @param redis Redis instance
+ * @param key The list key
+ * @param data The data to add
+ * @param useNamespace Whether to apply namespace
+ * @returns Length of list after operation
+ */
+export declare function lpush(redis: RedisInstance, key: string, data: RedisData, useNamespace?: boolean): Promise<number>;
+/**
+ * Adds an element to the back of a list
+ * @param redis Redis instance
+ * @param key The list key
+ * @param data The data to add
+ * @param useNamespace Whether to apply namespace
+ * @returns Length of list after operation
+ */
+export declare function rpush(redis: RedisInstance, key: string, data: RedisData, useNamespace?: boolean): Promise<number>;
+/**
+ * Removes and returns the first element of a list
+ * @param redis Redis instance
+ * @param key The list key
+ * @param useNamespace Whether to apply namespace
+ * @returns The element or null if list is empty
+ */
+export declare function lpop(redis: RedisInstance, key: string, useNamespace?: boolean): Promise<string | null>;
+/**
+ * Removes and returns the last element of a list
+ * @param redis Redis instance
+ * @param key The list key
+ * @param useNamespace Whether to apply namespace
+ * @returns The element or null if list is empty
+ */
+export declare function rpop(redis: RedisInstance, key: string, useNamespace?: boolean): Promise<string | null>;
+/**
+ * Gets a range of elements from a list
+ * @param redis Redis instance
+ * @param key The list key
+ * @param start Start index (0-based)
+ * @param stop Stop index (inclusive, -1 for end)
+ * @param useNamespace Whether to apply namespace
+ * @returns Array of elements
+ */
+export declare function lrange(redis: RedisInstance, key: string, start: number, stop: number, useNamespace?: boolean): Promise<string[]>;
+/**
+ * Gets all elements from a list
+ * @param redis Redis instance
+ * @param key The list key
+ * @param useNamespace Whether to apply namespace
+ * @returns Array of all elements
+ */
+export declare function lgetall(redis: RedisInstance, key: string, useNamespace?: boolean): Promise<string[]>;
+/**
+ * Gets the length of a list
+ * @param redis Redis instance
+ * @param key The list key
+ * @param useNamespace Whether to apply namespace
+ * @returns Length of list
+ */
+export declare function llen(redis: RedisInstance, key: string, useNamespace?: boolean): Promise<number>;
+/**
+ * Gets an element at a specific index
+ * @param redis Redis instance
+ * @param key The list key
+ * @param index The index
+ * @param useNamespace Whether to apply namespace
+ * @returns The element or null
+ */
+export declare function lindex(redis: RedisInstance, key: string, index: number, useNamespace?: boolean): Promise<string | null>;
+/**
+ * Sets an element at a specific index
+ * @param redis Redis instance
+ * @param key The list key
+ * @param index The index
+ * @param value The new value
+ * @param useNamespace Whether to apply namespace
+ * @returns 'OK' on success
+ */
+export declare function lset(redis: RedisInstance, key: string, index: number, value: RedisData, useNamespace?: boolean): Promise<string>;
+/**
+ * Trims a list to the specified range
+ * @param redis Redis instance
+ * @param key The list key
+ * @param start Start index
+ * @param stop Stop index
+ * @param useNamespace Whether to apply namespace
+ * @returns 'OK' on success
+ */
+export declare function ltrim(redis: RedisInstance, key: string, start: number, stop: number, useNamespace?: boolean): Promise<string>;
+//# sourceMappingURL=list.d.ts.map

package/dist/redis/operations/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/redis/operations/list.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C;;;;;;;;GAQG;AACH,wBAAsB,QAAQ,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE,YAAY,GAAE,OAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAOxJ;AAED;;;;;;;GAOG;AACH,wBAAsB,KAAK,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,YAAY,GAAE,OAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAG7H;AAED;;;;;;;GAOG;AACH,wBAAsB,KAAK,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,YAAY,GAAE,OAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAG7H;AAED;;;;;;GAMG;AACH,wBAAsB,IAAI,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,GAAE,OAAc,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAGlH;AAED;;;;;;GAMG;AACH,wBAAsB,IAAI,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,GAAE,OAAc,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAGlH;AAED;;;;;;;;GAQG;AACH,wBAAsB,MAAM,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,GAAE,OAAc,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAG5I;AAED;;;;;;GAMG;AACH,wBAAsB,OAAO,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,GAAE,OAAc,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAEhH;AAED;;;;;;GAMG;AACH,wBAAsB,IAAI,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,GAAE,OAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAG3G;AAED;;;;;;;GAOG;AACH,wBAAsB,MAAM,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,GAAE,OAAc,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAGnI;AAED;;;;;;;;GAQG;AACH,wBAAsB,IAAI,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,YAAY,GAAE,OAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAG5I;AAED;;;;;;;;GAQG;AACH,wBAAsB,KAAK,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,GAAE,OAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAGzI"}