Redis Cluster Adapter

Package: @nauth-toolkit/storage-redis Type: Storage Adapter (Production HA)

High-availability Redis Cluster storage for production deployments.

npm

npm install @nauth-toolkit/storage-redis redis

Yarn

yarn add @nauth-toolkit/storage-redis redis

pnpm

pnpm add @nauth-toolkit/storage-redis redis

Bun

bun add @nauth-toolkit/storage-redis redis

Usage

NestJS

import { createCluster } from 'redis';
import { RedisStorageAdapter } from '@nauth-toolkit/storage-redis';

const clusterClient = createCluster({
  rootNodes: [
    { url: 'redis://node1:6379' },
    { url: 'redis://node2:6379' },
    { url: 'redis://node3:6379' },
  ],
});
await clusterClient.connect();

AuthModule.forRoot({
  storageAdapter: new RedisStorageAdapter(clusterClient),
})

Or with factory:

import { createRedisClusterAdapter } from '@nauth-toolkit/nestjs';

AuthModule.forRoot({
  storageAdapter: createRedisClusterAdapter([
    { url: 'redis://node1:6379' },
    { url: 'redis://node2:6379' },
    { url: 'redis://node3:6379' },
  ]),
})

Express

import { createCluster } from 'redis';
import { RedisStorageAdapter } from '@nauth-toolkit/storage-redis';

const clusterClient = createCluster({
  rootNodes: [
    { url: 'redis://node1:6379' },
    { url: 'redis://node2:6379' },
    { url: 'redis://node3:6379' },
  ],
});
await clusterClient.connect();

const nauth = await NAuth.create({
  config: {
    storageAdapter: new RedisStorageAdapter(clusterClient),
  },
  // ...
});

Fastify

import { createCluster } from 'redis';
import { RedisStorageAdapter } from '@nauth-toolkit/storage-redis';
import { FastifyAdapter } from '@nauth-toolkit/core';

const clusterClient = createCluster({
  rootNodes: [
    { url: 'redis://node1:6379' },
    { url: 'redis://node2:6379' },
    { url: 'redis://node3:6379' },
  ],
});
await clusterClient.connect();

const nauth = await NAuth.create({
  config: {
    storageAdapter: new RedisStorageAdapter(clusterClient),
  },
  adapter: new FastifyAdapter(),
  // ...
});

Features

• High availability (automatic failover)
• Horizontal scaling
• Same RedisStorageAdapter class as single instance
• Uses createCluster() instead of createClient()

Related

• Redis - Single instance
• Session Storage