@bridgebase/redis 0.2.0

package/README.md

@@ -0,0 +1,129 @@
+# @bridgebase/redis
+
+Redis adapter for BridgeBase - Native Redis client with gateway integration.
+
+## Features
+
+- **Minimal Abstraction** - Direct pass-through to native Redis client
+- **Gateway Integration** - Automatic proxy tunnel setup via BridgeBase
+- **Full Redis Support** - Access to all Redis commands and options
+- **Connection Pooling** - Leverage Redis client connection management
+
+## Installation
+
+```bash
+npm install @bridgebase/redis redis
+```
+
+## Quick Start
+
+```typescript
+import { connectRedis } from "@bridgebase/redis";
+
+const session = await connectRedis("your-jwt-token", { db: 0 });
+const redis = session.client; // Access native Redis client
+
+// Use native Redis client
+await redis.set("key", "value");
+const value = await redis.get("key");
+console.log(value);
+
+await session.disconnect();
+```
+
+## Factory Functions
+
+### connectRedis()
+
+Creates a session and automatically connects:
+
+```typescript
+const session = await connectRedis(jwtToken, {
+  db?: number;           // Redis database number (default: 0)
+  apiBaseUrl?: string;   // BridgeBase API endpoint
+});
+
+const redis = session.client; // Native Redis client
+```
+
+### redis()
+
+Alias for `connectRedis()`:
+
+```typescript
+const session = await redis(jwtToken, options);
+```
+
+### createRedisSession()
+
+Creates a session without auto-connecting:
+
+```typescript
+const session = createRedisSession(jwtToken, options);
+const redis = await session.connect(); // Manual connect
+```
+
+## Using Native Redis Client
+
+Once connected, you have full access to the native Redis client:
+
+```typescript
+import { connectRedis } from "@bridgebase/redis";
+
+const session = await connectRedis(token);
+const redis = session.client;
+
+// All native Redis commands available
+await redis.set("key", "value");
+await redis.incr("counter");
+await redis.hincrby("hash", "field", 1);
+
+// Transactions
+const result = await redis
+  .multi()
+  .set("key1", "value1")
+  .set("key2", "value2")
+  .exec();
+
+// Subscriptions
+const subscriber = redis.duplicate();
+await subscriber.subscribe("channel", (message) => {
+  console.log(message);
+});
+```
+
+## Error Handling
+
+```typescript
+import { ConnectionError, GatewayResolutionError } from "@bridgebase/redis";
+
+try {
+  const session = await connectRedis(token);
+  const redis = session.client;
+  await redis.set("key", "value");
+} catch (error) {
+  if (error instanceof GatewayResolutionError) {
+    console.error("Failed to resolve gateway");
+  } else if (error instanceof ConnectionError) {
+    console.error("Failed to connect to Redis");
+  }
+} finally {
+  await session?.disconnect();
+}
+```
+
+## Cleanup
+
+```typescript
+const session = await connectRedis(token);
+try {
+  const redis = session.client;
+  // Use the client
+} finally {
+  await session.disconnect();
+}
+```
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,64 @@
+import { BaseSession, SessionConfig, DatabaseCredentials } from '@bridgebase/core';
+export { AuthError, BridgeBaseError, ConnectionError, CredentialError, DatabaseCredentials, GatewayError, GatewayResolutionError, ProxyError, SessionConfig } from '@bridgebase/core';
+import { RedisClientType } from 'redis';
+export { RedisClientType } from 'redis';
+
+interface RedisSessionConfig extends SessionConfig {
+    db?: number;
+}
+/**
+ * Session adapter for Redis database
+ * Provides full access to node-redis client methods
+ */
+declare class RedisSession extends BaseSession<RedisClientType> {
+    private db;
+    constructor(config: RedisSessionConfig);
+    /**
+     * Access native Redis client
+     * Must call connect() first
+     *
+     * All redis (node-redis) client methods are available:
+     * - Basic commands: get, set, del, exists, etc.
+     * - Hashes: hSet, hGet, hGetAll, hDel, etc.
+     * - Lists: lPush, rPush, lPop, rPop, lRange, etc.
+     * - Sets: sAdd, sRem, sMembers, etc.
+     * - Sorted Sets: zAdd, zRem, zRange, zScore, etc.
+     * - Pub/Sub: publish, subscribe, unsubscribe, etc.
+     * - Transactions: multi, exec, etc.
+     * - And many more...
+     */
+    get client(): RedisClientType;
+    protected connectNative(credentials: DatabaseCredentials | null, proxyPort: number): Promise<RedisClientType>;
+    protected closeNative(nativeClient: RedisClientType): Promise<void>;
+    protected get requiresCredentials(): boolean;
+    protected get dbLabel(): string;
+}
+
+/**
+ * @bridgebase/redis - Redis adapter with BridgeBase gateway integration
+ */
+
+interface RedisConnection {
+    client: RedisClientType;
+    disconnect: () => Promise<void>;
+}
+/**
+ * Convenience factory function for Redis
+ * Creates and connects a session in one call
+ */
+declare function connectRedis(jwtToken: string, options?: Partial<RedisSessionConfig>): Promise<RedisConnection>;
+/**
+ * Alias for connectRedis
+ */
+declare function redis(jwtToken: string, options?: Partial<RedisSessionConfig>): Promise<RedisConnection>;
+/**
+ * Factory function to create a session without auto-connecting
+ */
+declare function createRedisSession(jwtToken: string, options?: Partial<RedisSessionConfig>): RedisSession;
+
+/**
+ * SDK version
+ */
+declare const version = "0.2.0";
+
+export { type RedisConnection, RedisSession, type RedisSessionConfig, connectRedis, createRedisSession, redis, version };

package/dist/index.d.ts

@@ -0,0 +1,64 @@
+import { BaseSession, SessionConfig, DatabaseCredentials } from '@bridgebase/core';
+export { AuthError, BridgeBaseError, ConnectionError, CredentialError, DatabaseCredentials, GatewayError, GatewayResolutionError, ProxyError, SessionConfig } from '@bridgebase/core';
+import { RedisClientType } from 'redis';
+export { RedisClientType } from 'redis';
+
+interface RedisSessionConfig extends SessionConfig {
+    db?: number;
+}
+/**
+ * Session adapter for Redis database
+ * Provides full access to node-redis client methods
+ */
+declare class RedisSession extends BaseSession<RedisClientType> {
+    private db;
+    constructor(config: RedisSessionConfig);
+    /**
+     * Access native Redis client
+     * Must call connect() first
+     *
+     * All redis (node-redis) client methods are available:
+     * - Basic commands: get, set, del, exists, etc.
+     * - Hashes: hSet, hGet, hGetAll, hDel, etc.
+     * - Lists: lPush, rPush, lPop, rPop, lRange, etc.
+     * - Sets: sAdd, sRem, sMembers, etc.
+     * - Sorted Sets: zAdd, zRem, zRange, zScore, etc.
+     * - Pub/Sub: publish, subscribe, unsubscribe, etc.
+     * - Transactions: multi, exec, etc.
+     * - And many more...
+     */
+    get client(): RedisClientType;
+    protected connectNative(credentials: DatabaseCredentials | null, proxyPort: number): Promise<RedisClientType>;
+    protected closeNative(nativeClient: RedisClientType): Promise<void>;
+    protected get requiresCredentials(): boolean;
+    protected get dbLabel(): string;
+}
+
+/**
+ * @bridgebase/redis - Redis adapter with BridgeBase gateway integration
+ */
+
+interface RedisConnection {
+    client: RedisClientType;
+    disconnect: () => Promise<void>;
+}
+/**
+ * Convenience factory function for Redis
+ * Creates and connects a session in one call
+ */
+declare function connectRedis(jwtToken: string, options?: Partial<RedisSessionConfig>): Promise<RedisConnection>;
+/**
+ * Alias for connectRedis
+ */
+declare function redis(jwtToken: string, options?: Partial<RedisSessionConfig>): Promise<RedisConnection>;
+/**
+ * Factory function to create a session without auto-connecting
+ */
+declare function createRedisSession(jwtToken: string, options?: Partial<RedisSessionConfig>): RedisSession;
+
+/**
+ * SDK version
+ */
+declare const version = "0.2.0";
+
+export { type RedisConnection, RedisSession, type RedisSessionConfig, connectRedis, createRedisSession, redis, version };

package/dist/index.js

@@ -0,0 +1,143 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  AuthError: () => import_core2.AuthError,
+  BridgeBaseError: () => import_core2.BridgeBaseError,
+  ConnectionError: () => import_core2.ConnectionError,
+  CredentialError: () => import_core2.CredentialError,
+  GatewayError: () => import_core2.GatewayError,
+  GatewayResolutionError: () => import_core2.GatewayResolutionError,
+  ProxyError: () => import_core2.ProxyError,
+  RedisSession: () => RedisSession,
+  connectRedis: () => connectRedis,
+  createRedisSession: () => createRedisSession,
+  redis: () => redis,
+  version: () => version
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/sessions/RedisSession.ts
+var import_core = require("@bridgebase/core");
+var RedisSession = class extends import_core.BaseSession {
+  constructor(config) {
+    super(config);
+    this.db = config.db ?? 0;
+    this.dbType = "redis";
+  }
+  /**
+   * Access native Redis client
+   * Must call connect() first
+   * 
+   * All redis (node-redis) client methods are available:
+   * - Basic commands: get, set, del, exists, etc.
+   * - Hashes: hSet, hGet, hGetAll, hDel, etc.
+   * - Lists: lPush, rPush, lPop, rPop, lRange, etc.
+   * - Sets: sAdd, sRem, sMembers, etc.
+   * - Sorted Sets: zAdd, zRem, zRange, zScore, etc.
+   * - Pub/Sub: publish, subscribe, unsubscribe, etc.
+   * - Transactions: multi, exec, etc.
+   * - And many more...
+   */
+  get client() {
+    if (!this.nativeClient) {
+      throw new import_core.ConnectionError(
+        "Session not connected. Call connect() first.",
+        "SESSION_NOT_CONNECTED"
+      );
+    }
+    return this.nativeClient;
+  }
+  async connectNative(credentials, proxyPort) {
+    try {
+      const redis2 = require("redis");
+      const client = redis2.createClient({
+        socket: {
+          host: "127.0.0.1",
+          port: proxyPort
+        },
+        database: this.db
+      });
+      await client.connect();
+      return client;
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      throw new import_core.ConnectionError(
+        `Failed to connect to Redis: ${message}`,
+        "REDIS_CONNECT_FAILED",
+        { originalError: error }
+      );
+    }
+  }
+  async closeNative(nativeClient) {
+    if (nativeClient && typeof nativeClient.quit === "function") {
+      await nativeClient.quit();
+    } else if (nativeClient && typeof nativeClient.disconnect === "function") {
+      await nativeClient.disconnect();
+    }
+  }
+  get requiresCredentials() {
+    return false;
+  }
+  get dbLabel() {
+    return "Redis";
+  }
+};
+
+// src/index.ts
+var import_core2 = require("@bridgebase/core");
+async function connectRedis(jwtToken, options) {
+  const session = new RedisSession({
+    jwtToken,
+    ...options
+  });
+  await session.connect();
+  return {
+    client: session.client,
+    disconnect: () => session.disconnect()
+  };
+}
+async function redis(jwtToken, options) {
+  return connectRedis(jwtToken, options);
+}
+function createRedisSession(jwtToken, options) {
+  return new RedisSession({
+    jwtToken,
+    ...options
+  });
+}
+var version = "0.2.0";
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AuthError,
+  BridgeBaseError,
+  ConnectionError,
+  CredentialError,
+  GatewayError,
+  GatewayResolutionError,
+  ProxyError,
+  RedisSession,
+  connectRedis,
+  createRedisSession,
+  redis,
+  version
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/sessions/RedisSession.ts"],"sourcesContent":["/**\n * @bridgebase/redis - Redis adapter with BridgeBase gateway integration\n */\n\nimport { RedisSession, RedisSessionConfig } from \"./sessions/RedisSession\";\nimport type { RedisClientType } from \"redis\";\n\nexport interface RedisConnection {\n  client: RedisClientType;\n  disconnect: () => Promise<void>;\n}\n\n/**\n * Convenience factory function for Redis\n * Creates and connects a session in one call\n */\nexport async function connectRedis(\n  jwtToken: string,\n  options?: Partial<RedisSessionConfig>\n): Promise<RedisConnection> {\n  const session = new RedisSession({\n    jwtToken,\n    ...options,\n  });\n  await session.connect();\n  return {\n    client: session.client,\n    disconnect: () => session.disconnect(),\n  };\n}\n\n/**\n * Alias for connectRedis\n */\nexport async function redis(\n  jwtToken: string,\n  options?: Partial<RedisSessionConfig>\n): Promise<RedisConnection> {\n  return connectRedis(jwtToken, options);\n}\n\n/**\n * Factory function to create a session without auto-connecting\n */\nexport function createRedisSession(\n  jwtToken: string,\n  options?: Partial<RedisSessionConfig>\n): RedisSession {\n  return new RedisSession({\n    jwtToken,\n    ...options,\n  });\n}\n\n// Session exports\nexport { RedisSession };\nexport type { RedisSessionConfig } from \"./sessions/RedisSession\";\n\n// Re-export commonly used Redis types for convenience\nexport type { RedisClientType } from \"redis\";\n\n// Re-export core types and exceptions\nexport {\n  BridgeBaseError,\n  AuthError,\n  GatewayError,\n  GatewayResolutionError,\n  ConnectionError,\n  CredentialError,\n  ProxyError,\n} from \"@bridgebase/core\";\n\nexport type { SessionConfig, DatabaseCredentials } from \"@bridgebase/core\";\n\n/**\n * SDK version\n */\nexport const version = \"0.2.0\";\n","import { BaseSession, DatabaseCredentials, SessionConfig, ConnectionError } from \"@bridgebase/core\";\nimport type { RedisClientType } from \"redis\";\n\nexport interface RedisSessionConfig extends SessionConfig {\n  db?: number;\n}\n\n/**\n * Session adapter for Redis database\n * Provides full access to node-redis client methods\n */\nexport class RedisSession extends BaseSession<RedisClientType> {\n  private db: number;\n\n  constructor(config: RedisSessionConfig) {\n    super(config);\n    this.db = config.db ?? 0;\n    this.dbType = \"redis\";\n  }\n\n  /**\n   * Access native Redis client\n   * Must call connect() first\n   * \n   * All redis (node-redis) client methods are available:\n   * - Basic commands: get, set, del, exists, etc.\n   * - Hashes: hSet, hGet, hGetAll, hDel, etc.\n   * - Lists: lPush, rPush, lPop, rPop, lRange, etc.\n   * - Sets: sAdd, sRem, sMembers, etc.\n   * - Sorted Sets: zAdd, zRem, zRange, zScore, etc.\n   * - Pub/Sub: publish, subscribe, unsubscribe, etc.\n   * - Transactions: multi, exec, etc.\n   * - And many more...\n   */\n  get client(): RedisClientType {\n    if (!this.nativeClient) {\n      throw new ConnectionError(\n        \"Session not connected. Call connect() first.\",\n        \"SESSION_NOT_CONNECTED\"\n      );\n    }\n    return this.nativeClient;\n  }\n\n  protected async connectNative(\n    credentials: DatabaseCredentials | null,\n    proxyPort: number,\n  ): Promise<RedisClientType> {\n    try {\n      // Lazy import redis\n      // eslint-disable-next-line @typescript-eslint/no-var-requires\n      const redis = require(\"redis\");\n\n      const client = redis.createClient({\n        socket: {\n          host: \"127.0.0.1\",\n          port: proxyPort,\n        },\n        database: this.db,\n      });\n\n      await client.connect();\n      return client;\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      throw new ConnectionError(\n        `Failed to connect to Redis: ${message}`,\n        \"REDIS_CONNECT_FAILED\",\n        { originalError: error },\n      );\n    }\n  }\n\n  protected async closeNative(nativeClient: RedisClientType): Promise<void> {\n    if (nativeClient && typeof nativeClient.quit === \"function\") {\n      await nativeClient.quit();\n    } else if (nativeClient && typeof nativeClient.disconnect === \"function\") {\n      await nativeClient.disconnect();\n    }\n  }\n\n  protected get requiresCredentials(): boolean {\n    return false;\n  }\n\n  protected get dbLabel(): string {\n    return \"Redis\";\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,kBAAiF;AAW1E,IAAM,eAAN,cAA2B,wBAA6B;AAAA,EAG7D,YAAY,QAA4B;AACtC,UAAM,MAAM;AACZ,SAAK,KAAK,OAAO,MAAM;AACvB,SAAK,SAAS;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAgBA,IAAI,SAA0B;AAC5B,QAAI,CAAC,KAAK,cAAc;AACtB,YAAM,IAAI;AAAA,QACR;AAAA,QACA;AAAA,MACF;AAAA,IACF;AACA,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,MAAgB,cACd,aACA,WAC0B;AAC1B,QAAI;AAGF,YAAMA,SAAQ,QAAQ,OAAO;AAE7B,YAAM,SAASA,OAAM,aAAa;AAAA,QAChC,QAAQ;AAAA,UACN,MAAM;AAAA,UACN,MAAM;AAAA,QACR;AAAA,QACA,UAAU,KAAK;AAAA,MACjB,CAAC;AAED,YAAM,OAAO,QAAQ;AACrB,aAAO;AAAA,IACT,SAAS,OAAO;AACd,YAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AACrE,YAAM,IAAI;AAAA,QACR,+BAA+B,OAAO;AAAA,QACtC;AAAA,QACA,EAAE,eAAe,MAAM;AAAA,MACzB;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAgB,YAAY,cAA8C;AACxE,QAAI,gBAAgB,OAAO,aAAa,SAAS,YAAY;AAC3D,YAAM,aAAa,KAAK;AAAA,IAC1B,WAAW,gBAAgB,OAAO,aAAa,eAAe,YAAY;AACxE,YAAM,aAAa,WAAW;AAAA,IAChC;AAAA,EACF;AAAA,EAEA,IAAc,sBAA+B;AAC3C,WAAO;AAAA,EACT;AAAA,EAEA,IAAc,UAAkB;AAC9B,WAAO;AAAA,EACT;AACF;;;AD1BA,IAAAC,eAQO;AAtDP,eAAsB,aACpB,UACA,SAC0B;AAC1B,QAAM,UAAU,IAAI,aAAa;AAAA,IAC/B;AAAA,IACA,GAAG;AAAA,EACL,CAAC;AACD,QAAM,QAAQ,QAAQ;AACtB,SAAO;AAAA,IACL,QAAQ,QAAQ;AAAA,IAChB,YAAY,MAAM,QAAQ,WAAW;AAAA,EACvC;AACF;AAKA,eAAsB,MACpB,UACA,SAC0B;AAC1B,SAAO,aAAa,UAAU,OAAO;AACvC;AAKO,SAAS,mBACd,UACA,SACc;AACd,SAAO,IAAI,aAAa;AAAA,IACtB;AAAA,IACA,GAAG;AAAA,EACL,CAAC;AACH;AAyBO,IAAM,UAAU;","names":["redis","import_core"]}

package/dist/index.mjs

@@ -0,0 +1,120 @@
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/sessions/RedisSession.ts
+import { BaseSession, ConnectionError } from "@bridgebase/core";
+var RedisSession = class extends BaseSession {
+  constructor(config) {
+    super(config);
+    this.db = config.db ?? 0;
+    this.dbType = "redis";
+  }
+  /**
+   * Access native Redis client
+   * Must call connect() first
+   * 
+   * All redis (node-redis) client methods are available:
+   * - Basic commands: get, set, del, exists, etc.
+   * - Hashes: hSet, hGet, hGetAll, hDel, etc.
+   * - Lists: lPush, rPush, lPop, rPop, lRange, etc.
+   * - Sets: sAdd, sRem, sMembers, etc.
+   * - Sorted Sets: zAdd, zRem, zRange, zScore, etc.
+   * - Pub/Sub: publish, subscribe, unsubscribe, etc.
+   * - Transactions: multi, exec, etc.
+   * - And many more...
+   */
+  get client() {
+    if (!this.nativeClient) {
+      throw new ConnectionError(
+        "Session not connected. Call connect() first.",
+        "SESSION_NOT_CONNECTED"
+      );
+    }
+    return this.nativeClient;
+  }
+  async connectNative(credentials, proxyPort) {
+    try {
+      const redis2 = __require("redis");
+      const client = redis2.createClient({
+        socket: {
+          host: "127.0.0.1",
+          port: proxyPort
+        },
+        database: this.db
+      });
+      await client.connect();
+      return client;
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      throw new ConnectionError(
+        `Failed to connect to Redis: ${message}`,
+        "REDIS_CONNECT_FAILED",
+        { originalError: error }
+      );
+    }
+  }
+  async closeNative(nativeClient) {
+    if (nativeClient && typeof nativeClient.quit === "function") {
+      await nativeClient.quit();
+    } else if (nativeClient && typeof nativeClient.disconnect === "function") {
+      await nativeClient.disconnect();
+    }
+  }
+  get requiresCredentials() {
+    return false;
+  }
+  get dbLabel() {
+    return "Redis";
+  }
+};
+
+// src/index.ts
+import {
+  BridgeBaseError,
+  AuthError,
+  GatewayError,
+  GatewayResolutionError,
+  ConnectionError as ConnectionError2,
+  CredentialError,
+  ProxyError
+} from "@bridgebase/core";
+async function connectRedis(jwtToken, options) {
+  const session = new RedisSession({
+    jwtToken,
+    ...options
+  });
+  await session.connect();
+  return {
+    client: session.client,
+    disconnect: () => session.disconnect()
+  };
+}
+async function redis(jwtToken, options) {
+  return connectRedis(jwtToken, options);
+}
+function createRedisSession(jwtToken, options) {
+  return new RedisSession({
+    jwtToken,
+    ...options
+  });
+}
+var version = "0.2.0";
+export {
+  AuthError,
+  BridgeBaseError,
+  ConnectionError2 as ConnectionError,
+  CredentialError,
+  GatewayError,
+  GatewayResolutionError,
+  ProxyError,
+  RedisSession,
+  connectRedis,
+  createRedisSession,
+  redis,
+  version
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/sessions/RedisSession.ts","../src/index.ts"],"sourcesContent":["import { BaseSession, DatabaseCredentials, SessionConfig, ConnectionError } from \"@bridgebase/core\";\nimport type { RedisClientType } from \"redis\";\n\nexport interface RedisSessionConfig extends SessionConfig {\n  db?: number;\n}\n\n/**\n * Session adapter for Redis database\n * Provides full access to node-redis client methods\n */\nexport class RedisSession extends BaseSession<RedisClientType> {\n  private db: number;\n\n  constructor(config: RedisSessionConfig) {\n    super(config);\n    this.db = config.db ?? 0;\n    this.dbType = \"redis\";\n  }\n\n  /**\n   * Access native Redis client\n   * Must call connect() first\n   * \n   * All redis (node-redis) client methods are available:\n   * - Basic commands: get, set, del, exists, etc.\n   * - Hashes: hSet, hGet, hGetAll, hDel, etc.\n   * - Lists: lPush, rPush, lPop, rPop, lRange, etc.\n   * - Sets: sAdd, sRem, sMembers, etc.\n   * - Sorted Sets: zAdd, zRem, zRange, zScore, etc.\n   * - Pub/Sub: publish, subscribe, unsubscribe, etc.\n   * - Transactions: multi, exec, etc.\n   * - And many more...\n   */\n  get client(): RedisClientType {\n    if (!this.nativeClient) {\n      throw new ConnectionError(\n        \"Session not connected. Call connect() first.\",\n        \"SESSION_NOT_CONNECTED\"\n      );\n    }\n    return this.nativeClient;\n  }\n\n  protected async connectNative(\n    credentials: DatabaseCredentials | null,\n    proxyPort: number,\n  ): Promise<RedisClientType> {\n    try {\n      // Lazy import redis\n      // eslint-disable-next-line @typescript-eslint/no-var-requires\n      const redis = require(\"redis\");\n\n      const client = redis.createClient({\n        socket: {\n          host: \"127.0.0.1\",\n          port: proxyPort,\n        },\n        database: this.db,\n      });\n\n      await client.connect();\n      return client;\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      throw new ConnectionError(\n        `Failed to connect to Redis: ${message}`,\n        \"REDIS_CONNECT_FAILED\",\n        { originalError: error },\n      );\n    }\n  }\n\n  protected async closeNative(nativeClient: RedisClientType): Promise<void> {\n    if (nativeClient && typeof nativeClient.quit === \"function\") {\n      await nativeClient.quit();\n    } else if (nativeClient && typeof nativeClient.disconnect === \"function\") {\n      await nativeClient.disconnect();\n    }\n  }\n\n  protected get requiresCredentials(): boolean {\n    return false;\n  }\n\n  protected get dbLabel(): string {\n    return \"Redis\";\n  }\n}\n","/**\n * @bridgebase/redis - Redis adapter with BridgeBase gateway integration\n */\n\nimport { RedisSession, RedisSessionConfig } from \"./sessions/RedisSession\";\nimport type { RedisClientType } from \"redis\";\n\nexport interface RedisConnection {\n  client: RedisClientType;\n  disconnect: () => Promise<void>;\n}\n\n/**\n * Convenience factory function for Redis\n * Creates and connects a session in one call\n */\nexport async function connectRedis(\n  jwtToken: string,\n  options?: Partial<RedisSessionConfig>\n): Promise<RedisConnection> {\n  const session = new RedisSession({\n    jwtToken,\n    ...options,\n  });\n  await session.connect();\n  return {\n    client: session.client,\n    disconnect: () => session.disconnect(),\n  };\n}\n\n/**\n * Alias for connectRedis\n */\nexport async function redis(\n  jwtToken: string,\n  options?: Partial<RedisSessionConfig>\n): Promise<RedisConnection> {\n  return connectRedis(jwtToken, options);\n}\n\n/**\n * Factory function to create a session without auto-connecting\n */\nexport function createRedisSession(\n  jwtToken: string,\n  options?: Partial<RedisSessionConfig>\n): RedisSession {\n  return new RedisSession({\n    jwtToken,\n    ...options,\n  });\n}\n\n// Session exports\nexport { RedisSession };\nexport type { RedisSessionConfig } from \"./sessions/RedisSession\";\n\n// Re-export commonly used Redis types for convenience\nexport type { RedisClientType } from \"redis\";\n\n// Re-export core types and exceptions\nexport {\n  BridgeBaseError,\n  AuthError,\n  GatewayError,\n  GatewayResolutionError,\n  ConnectionError,\n  CredentialError,\n  ProxyError,\n} from \"@bridgebase/core\";\n\nexport type { SessionConfig, DatabaseCredentials } from \"@bridgebase/core\";\n\n/**\n * SDK version\n */\nexport const version = \"0.2.0\";\n"],"mappings":";;;;;;;;AAAA,SAAS,aAAiD,uBAAuB;AAW1E,IAAM,eAAN,cAA2B,YAA6B;AAAA,EAG7D,YAAY,QAA4B;AACtC,UAAM,MAAM;AACZ,SAAK,KAAK,OAAO,MAAM;AACvB,SAAK,SAAS;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAgBA,IAAI,SAA0B;AAC5B,QAAI,CAAC,KAAK,cAAc;AACtB,YAAM,IAAI;AAAA,QACR;AAAA,QACA;AAAA,MACF;AAAA,IACF;AACA,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,MAAgB,cACd,aACA,WAC0B;AAC1B,QAAI;AAGF,YAAMA,SAAQ,UAAQ,OAAO;AAE7B,YAAM,SAASA,OAAM,aAAa;AAAA,QAChC,QAAQ;AAAA,UACN,MAAM;AAAA,UACN,MAAM;AAAA,QACR;AAAA,QACA,UAAU,KAAK;AAAA,MACjB,CAAC;AAED,YAAM,OAAO,QAAQ;AACrB,aAAO;AAAA,IACT,SAAS,OAAO;AACd,YAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AACrE,YAAM,IAAI;AAAA,QACR,+BAA+B,OAAO;AAAA,QACtC;AAAA,QACA,EAAE,eAAe,MAAM;AAAA,MACzB;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAgB,YAAY,cAA8C;AACxE,QAAI,gBAAgB,OAAO,aAAa,SAAS,YAAY;AAC3D,YAAM,aAAa,KAAK;AAAA,IAC1B,WAAW,gBAAgB,OAAO,aAAa,eAAe,YAAY;AACxE,YAAM,aAAa,WAAW;AAAA,IAChC;AAAA,EACF;AAAA,EAEA,IAAc,sBAA+B;AAC3C,WAAO;AAAA,EACT;AAAA,EAEA,IAAc,UAAkB;AAC9B,WAAO;AAAA,EACT;AACF;;;AC1BA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,mBAAAC;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAtDP,eAAsB,aACpB,UACA,SAC0B;AAC1B,QAAM,UAAU,IAAI,aAAa;AAAA,IAC/B;AAAA,IACA,GAAG;AAAA,EACL,CAAC;AACD,QAAM,QAAQ,QAAQ;AACtB,SAAO;AAAA,IACL,QAAQ,QAAQ;AAAA,IAChB,YAAY,MAAM,QAAQ,WAAW;AAAA,EACvC;AACF;AAKA,eAAsB,MACpB,UACA,SAC0B;AAC1B,SAAO,aAAa,UAAU,OAAO;AACvC;AAKO,SAAS,mBACd,UACA,SACc;AACd,SAAO,IAAI,aAAa;AAAA,IACtB;AAAA,IACA,GAAG;AAAA,EACL,CAAC;AACH;AAyBO,IAAM,UAAU;","names":["redis","ConnectionError"]}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@bridgebase/redis",
+  "version": "0.2.0",
+  "description": "BridgeBase Redis Adapter - Native Redis client wrapper with BridgeBase gateway integration",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "build:watch": "tsup --watch",
+    "type-check": "tsc --noEmit",
+    "test": "jest --passWithNoTests",
+    "test:watch": "jest --watch --passWithNoTests",
+    "lint": "eslint src --ext .ts"
+  },
+  "keywords": [
+    "redis",
+    "bridgebase",
+    "database-adapter"
+  ],
+  "author": "BridgeBase Team",
+  "license": "MIT",
+  "homepage": "https://github.com/bridgebase-cloud/bridgebase-ts/tree/main/packages/redis#readme",
+  "bugs": {
+    "url": "https://github.com/bridgebase-cloud/bridgebase-ts/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bridgebase-cloud/bridgebase-ts",
+    "directory": "packages/redis"
+  },
+  "dependencies": {
+    "@bridgebase/core": "^0.2.0"
+  },
+  "peerDependencies": {
+    "redis": "^5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "redis": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@bridgebase/core": "^0.2.0",
+    "@types/node": "^20.0.0",
+    "@types/jest": "^29.0.0",
+    "jest": "^29.0.0",
+    "ts-jest": "^29.0.0",
+    "typescript": "^5.0.0",
+    "tsup": "^8.0.0",
+    "redis": "^5.0.0"
+  }
+}