@fluojs/redis 1.0.0-beta.2 → 1.0.0-beta.4

package/README.ko.md

@@ -2,7 +2,7 @@
 
 <p><a href="./README.md"><kbd>English</kbd></a> <strong><kbd>한국어</kbd></strong></p>
 
-fluo를 위한 공유 Redis 연결 계층입니다. 애플리케이션 수명 주기에 따라 관리되는 단일 `ioredis` 클라이언트를 제공합니다.
+fluo를 위한 공유 Redis 연결 계층입니다. 기본 app-scoped `ioredis` client와 선택적인 named client를 제공하며, 모두 애플리케이션 lifecycle로 관리됩니다.
 
 ## 목차
 
@@ -51,6 +51,8 @@ export class AppModule {}
 
 `RedisService`를 주입받아 고수준 작업을 수행하거나, `REDIS_CLIENT`를 통해 원시 `ioredis` 인스턴스를 직접 사용할 수 있습니다.
 
+`RedisService.get()`은 JSON parse를 시도하고 실패하면 raw string을 반환합니다. 누락된 key는 `null`을 반환합니다. `RedisService.set()`은 값을 `JSON.stringify()`로 직렬화하고 양수 TTL에만 `EX`를 사용합니다.
+
 ```typescript
 import { Inject } from '@fluojs/core';
 import { RedisService } from '@fluojs/redis';
@@ -73,7 +75,7 @@ export class CacheRepository {
 
 ### 수명 주기 소유권
 
-`@fluojs/redis`는 `RedisModule.forRootNamed(...)`로 등록한 연결을 포함해, 자신이 생성한 모든 Redis 클라이언트의 수명 주기를 직접 관리합니다.
+`@fluojs/redis`는 `RedisModule.forRoot({ name, ... })`로 등록한 이름 있는 연결을 포함해, 자신이 생성한 모든 Redis 클라이언트의 수명 주기를 직접 관리합니다.
 
 - 호출자가 옵션을 강제로 캐스팅하더라도 Fluo는 항상 `lazyConnect: true`를 강제하므로, 소켓은 import 시점이 아니라 애플리케이션 bootstrap 중에 열립니다.
 - bootstrap 단계에서는 클라이언트가 ioredis `wait` 상태일 때만 lifecycle service가 `connect()`를 호출합니다.
@@ -82,11 +84,12 @@ export class CacheRepository {
 
 ### 이름 있는 클라이언트
 
-하나의 애플리케이션에서 여러 Redis 연결이 필요하면 `RedisModule.forRootNamed(name, options)`를 사용하세요. `RedisModule.forRoot(options)`는 기본 `REDIS_CLIENT`와 `RedisService` 별칭을 제공하고, 이름 있는 등록은 `getRedisClientToken(name)`과 `getRedisServiceToken(name)`으로 해석합니다.
+하나의 애플리케이션에서 여러 Redis 연결이 필요하면 `RedisModule.forRoot({ name, ...options })`를 사용하세요. `name` 없는 `RedisModule.forRoot(options)`는 기본 `REDIS_CLIENT`와 `RedisService` 별칭을 제공하고, 이름 있는 등록은 `getRedisClientToken(name)`과 `getRedisServiceToken(name)`으로 해석합니다.
 
 - `name`을 생략하면 기본 별칭인 `REDIS_CLIENT` / `RedisService`를 사용합니다.
 - `name`을 지정하면 `getRedisClientToken(name)` / `getRedisServiceToken(name)`으로 이름 있는 바인딩을 가져옵니다.
 - 이름 있는 클라이언트도 기본 클라이언트와 동일한 bootstrap/shutdown 계약을 따르며, `REDIS_CLIENT` / `RedisService` 별칭은 기본 등록에서만 export됩니다.
+- 이름은 trim되며, blank 또는 whitespace-only name은 token/component helper에서 거부됩니다.
 
 ```typescript
 import { Module, Inject } from '@fluojs/core';
@@ -104,7 +107,7 @@ const ANALYTICS_REDIS_CLIENT = getRedisClientToken('analytics');
 @Module({
   imports: [
     RedisModule.forRoot({ host: 'localhost', port: 6379 }),
-    RedisModule.forRootNamed('analytics', { host: 'localhost', port: 6380 }),
+    RedisModule.forRoot({ name: 'analytics', host: 'localhost', port: 6380 }),
   ],
 })
 export class AppModule {}
@@ -123,6 +126,8 @@ export class AnalyticsStore {
 
 파이프라인, Lua 스크립트, Pub/Sub 등 복잡한 Redis 명령이 필요한 경우 원시 클라이언트를 직접 주입받아 사용합니다.
 
+이미 `RedisService`를 주입받았다면 `redis.getRawClient()`로 같은 underlying `ioredis` instance에 접근할 수 있습니다.
+
 ```typescript
 import { Inject } from '@fluojs/core';
 import { REDIS_CLIENT } from '@fluojs/redis';
@@ -141,11 +146,11 @@ export class AdvancedService {
 ## 공개 API 개요
 
 ### 핵심 구성 요소
-- `RedisModule`: 전역 Redis 클라이언트 등록 및 수명 주기 훅을 관리합니다.
-- `RedisModule.forRoot(options)`: `lazyConnect` 수명 주기 제어를 Fluo 내부에서 유지하면서 기본 Redis 클라이언트와 `RedisService` 파사드를 등록하는 지원되는 root entrypoint입니다.
-- `RedisModule.forRootNamed(name, options)`: 동일한 수명 주기 계약을 유지한 채 기본 별칭을 건드리지 않고 추가 Redis 클라이언트를 등록합니다.
+- `RedisModule`: Redis 클라이언트 등록 및 수명 주기 훅을 관리합니다.
+- `RedisModule.forRoot(options)`: `name`을 생략하면 기본 Redis 클라이언트와 `RedisService` 파사드를 등록하고, `name`을 제공하면 추가 이름 있는 Redis 클라이언트를 등록합니다. 기본 등록은 기본적으로 global이고, 이름 있는 등록은 scoped입니다.
 - `RedisService`: JSON 코덱 지원 및 `get`/`set`/`del` 메서드를 제공하는 파사드입니다.
 - `REDIS_CLIENT`: 내부 `ioredis` 인스턴스에 접근하기 위한 DI 토큰입니다.
+- `DEFAULT_REDIS_CLIENT_NAME`: 안정적인 기본 Redis client name입니다.
 - `getRedisClientToken(name)`: 이름 있는 raw client 토큰 헬퍼입니다. `name`을 생략하면 기본 `REDIS_CLIENT` 토큰을 돌려줍니다.
 - `getRedisServiceToken(name)`: 이름 있는 `RedisService` 토큰 헬퍼입니다. `name`을 생략하면 기본 `RedisService` 토큰을 돌려줍니다.
 - `getRedisComponentId(name)`: Redis 소비 패키지들이 사용하는 상태/의존성 식별자 헬퍼입니다 (`redis.default`, `redis.cache` 등).
@@ -153,6 +158,7 @@ export class AdvancedService {
 
 ### 타입
 - `RedisModuleOptions`: `ioredis` 생성자에 전달되는 설정 옵션입니다.
+- `PersistencePlatformStatusSnapshot`, `RedisStatusAdapterInput`: status snapshot input/output type입니다.
 
 ## 관련 패키지
 

package/README.md

@@ -2,7 +2,7 @@
 
 <p><strong><kbd>English</kbd></strong> <a href="./README.ko.md"><kbd>한국어</kbd></a></p>
 
-Shared Redis connection layer for fluo. It provides a singleton `ioredis` client managed by the application lifecycle.
+Shared Redis connection layer for fluo. It provides a default app-scoped `ioredis` client plus optional named clients, all managed by the application lifecycle.
 
 ## Table of Contents
 
@@ -51,6 +51,8 @@ export class AppModule {}
 
 Inject `RedisService` for high-level operations or `REDIS_CLIENT` for the raw `ioredis` instance.
 
+`RedisService.get()` attempts JSON parsing and falls back to the raw string; missing keys return `null`. `RedisService.set()` serializes values with `JSON.stringify()` and uses `EX` only for positive TTL values.
+
 ```typescript
 import { Inject } from '@fluojs/core';
 import { RedisService } from '@fluojs/redis';
@@ -73,7 +75,7 @@ export class CacheRepository {
 
 ### Lifecycle Ownership
 
-`@fluojs/redis` owns the lifecycle of every client it creates, including clients registered through `RedisModule.forRootNamed(...)`.
+`@fluojs/redis` owns the lifecycle of every client it creates, including named clients registered through `RedisModule.forRoot({ name, ... })`.
 
 - Fluo always forces `lazyConnect: true`, even if callers cast options manually, so sockets open during application bootstrap instead of import time.
 - During bootstrap, the lifecycle service only calls `connect()` while the client is still in ioredis `wait` state.
@@ -82,11 +84,12 @@ export class CacheRepository {
 
 ### Named Clients
 
-Use `RedisModule.forRootNamed(name, options)` when one application needs more than one Redis connection. `RedisModule.forRoot(options)` provides the default `REDIS_CLIENT` and `RedisService` aliases, and named registrations are resolved with `getRedisClientToken(name)` and `getRedisServiceToken(name)`.
+Use `RedisModule.forRoot({ name, ...options })` when one application needs more than one Redis connection. `RedisModule.forRoot(options)` without `name` provides the default `REDIS_CLIENT` and `RedisService` aliases, and named registrations are resolved with `getRedisClientToken(name)` and `getRedisServiceToken(name)`.
 
 - Omit `name` when you want the default aliases: `REDIS_CLIENT` / `RedisService`.
 - Pass `name` when you want the named helpers: `getRedisClientToken(name)` / `getRedisServiceToken(name)`.
 - Named clients follow the same bootstrap/shutdown contract as the default client; only the default registration exports the `REDIS_CLIENT` / `RedisService` aliases.
+- Names are trimmed, and blank or whitespace-only names are rejected by token/component helpers.
 
 ```typescript
 import { Module, Inject } from '@fluojs/core';
@@ -104,7 +107,7 @@ const ANALYTICS_REDIS_CLIENT = getRedisClientToken('analytics');
 @Module({
   imports: [
     RedisModule.forRoot({ host: 'localhost', port: 6379 }),
-    RedisModule.forRootNamed('analytics', { host: 'localhost', port: 6380 }),
+    RedisModule.forRoot({ name: 'analytics', host: 'localhost', port: 6380 }),
   ],
 })
 export class AppModule {}
@@ -123,6 +126,8 @@ export class AnalyticsStore {
 
 If you need advanced Redis commands (pipelines, lua scripts, pub/sub), inject the raw client directly.
 
+If you already injected `RedisService`, call `redis.getRawClient()` to access the same underlying `ioredis` instance.
+
 ```typescript
 import { Inject } from '@fluojs/core';
 import { REDIS_CLIENT } from '@fluojs/redis';
@@ -141,11 +146,11 @@ export class AdvancedService {
 ## Public API Overview
 
 ### Core
-- `RedisModule`: Registers the global Redis client and lifecycle hooks.
-- `RedisModule.forRoot(options)`: Registers the default Redis client plus `RedisService` facade, with `lazyConnect` lifecycle ownership kept inside Fluo.
-- `RedisModule.forRootNamed(name, options)`: Registers an additional named Redis client without replacing the default aliases, using the same lifecycle contract.
+- `RedisModule`: Registers Redis clients and lifecycle hooks.
+- `RedisModule.forRoot(options)`: Registers the default Redis client plus `RedisService` facade when `name` is omitted, or an additional named Redis client when `name` is provided. The default registration is global by default; named registrations are scoped.
 - `RedisService`: Facade with JSON codec support and `get`/`set`/`del` methods.
 - `REDIS_CLIENT`: DI token for the underlying `ioredis` instance.
+- `DEFAULT_REDIS_CLIENT_NAME`: Stable default Redis client name.
 - `getRedisClientToken(name)`: DI token helper for a named raw client. Omitting `name` returns the default `REDIS_CLIENT` token.
 - `getRedisServiceToken(name)`: DI token helper for a named `RedisService` facade. Omitting `name` returns the default `RedisService` token.
 - `getRedisComponentId(name)`: Status/dependency id helper used by Redis-consuming packages (`redis.default`, `redis.cache`, etc.).
@@ -153,6 +158,7 @@ export class AdvancedService {
 
 ### Types
 - `RedisModuleOptions`: Configuration options passed directly to the `ioredis` constructor.
+- `PersistencePlatformStatusSnapshot`, `RedisStatusAdapterInput`: Status snapshot input/output types.
 
 ## Related Packages
 

package/dist/module.d.ts

@@ -3,12 +3,11 @@ import type { RedisModuleOptions } from './types.js';
 /** Runtime module entrypoint for the shared Redis client integration. */
 export declare class RedisModule {
     /**
-     * Registers a global Redis client and exports the facade used across Fluo packages.
+     * Registers the default Redis client or an additional named Redis client.
      *
-     * @param options Redis client options used to construct the shared connection.
-     * @returns A module definition that exports {@link REDIS_CLIENT} and {@link RedisService}.
+     * @param options Redis client options. Pass `name` to derive named client and service tokens.
+     * @returns A module definition that exports the matching Redis client and facade tokens.
      *
-     * @see RedisModule.forRootNamed
      * @see getRedisClientToken
      * @see getRedisServiceToken
      *
@@ -18,54 +17,14 @@ export declare class RedisModule {
      * import { RedisModule } from '@fluojs/redis';
      *
      * @Module({
-     *   imports: [RedisModule.forRoot({ host: 'localhost', port: 6379 })],
-     * })
-     * export class AppModule {}
-     * ```
-     */
-    static forRoot(options: RedisModuleOptions): ModuleType;
-    /**
-     * Registers one additional named Redis client without changing the default aliases.
-     *
-     * @param name Stable Redis client name used to derive named raw-client and facade tokens.
-     * @param options Redis client options used to construct the named connection.
-     * @returns A module definition that exports the named raw-client token and named `RedisService` token.
-     *
-     * @see getRedisClientToken
-     * @see getRedisServiceToken
-     *
-     * @example
-     * ```ts
-     * import { Module, Inject } from '@fluojs/core';
-     * import type Redis from 'ioredis';
-     * import {
-     *   getRedisClientToken,
-     *   getRedisServiceToken,
-     *   RedisModule,
-     *   RedisService,
-     * } from '@fluojs/redis';
-     *
-     * const ANALYTICS_REDIS = getRedisServiceToken('analytics');
-     * const ANALYTICS_REDIS_CLIENT = getRedisClientToken('analytics');
-     *
-     * @Module({
      *   imports: [
      *     RedisModule.forRoot({ host: 'localhost', port: 6379 }),
-     *     RedisModule.forRootNamed('analytics', { host: 'localhost', port: 6380 }),
+     *     RedisModule.forRoot({ name: 'analytics', host: 'localhost', port: 6380 }),
      *   ],
      * })
      * export class AppModule {}
-     *
-     * @Inject(RedisService, ANALYTICS_REDIS, ANALYTICS_REDIS_CLIENT)
-     * export class AnalyticsStore {
-     *   constructor(
-     *     private readonly defaultRedis: RedisService,
-     *     private readonly analyticsRedis: RedisService,
-     *     private readonly analyticsClient: Redis,
-     *   ) {}
-     * }
      * ```
      */
-    static forRootNamed(name: string, options: RedisModuleOptions): ModuleType;
+    static forRoot(options: RedisModuleOptions): ModuleType;
 }
 //# sourceMappingURL=module.d.ts.map

package/dist/module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAMhE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AA6ErD,yEAAyE;AACzE,qBAAa,WAAW;IACtB;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,kBAAkB,GAAG,UAAU;IAUvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAyCG;IACH,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,UAAU;CAW3E"}
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAMhE,OAAO,KAAK,EAAsB,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAoGzE,yEAAyE;AACzE,qBAAa,WAAW;IACtB;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,kBAAkB,GAAG,UAAU;CAYxD"}

package/dist/module.js

@@ -21,6 +21,25 @@ function getRedisLifecycleToken(name) {
  * @param name Optional Redis client name for additional named registrations.
  * @returns Providers for the raw client token, the JSON-aware facade, and lifecycle hooks.
  */
+function normalizeRedisModuleOptions(options) {
+  const {
+    global,
+    name,
+    ...clientOptions
+  } = options;
+  const normalizedName = name?.trim();
+  if (normalizedName !== undefined && normalizedName.length === 0) {
+    throw new Error('Redis client name must be a non-empty string when provided.');
+  }
+  if (normalizedName !== undefined && global === true) {
+    throw new Error('Named Redis registrations are scoped and cannot be registered globally.');
+  }
+  return {
+    clientOptions,
+    global: normalizedName === undefined ? global ?? true : false,
+    name: normalizedName
+  };
+}
 function createRedisProviders(options, name) {
   const clientToken = getRedisClientToken(name);
   if (clientToken === REDIS_CLIENT) {
@@ -66,12 +85,11 @@ function createRedisProviders(options, name) {
 /** Runtime module entrypoint for the shared Redis client integration. */
 export class RedisModule {
   /**
-   * Registers a global Redis client and exports the facade used across Fluo packages.
+   * Registers the default Redis client or an additional named Redis client.
    *
-   * @param options Redis client options used to construct the shared connection.
-   * @returns A module definition that exports {@link REDIS_CLIENT} and {@link RedisService}.
+   * @param options Redis client options. Pass `name` to derive named client and service tokens.
+   * @returns A module definition that exports the matching Redis client and facade tokens.
    *
-   * @see RedisModule.forRootNamed
    * @see getRedisClientToken
    * @see getRedisServiceToken
    *
@@ -81,70 +99,23 @@ export class RedisModule {
    * import { RedisModule } from '@fluojs/redis';
    *
    * @Module({
-   *   imports: [RedisModule.forRoot({ host: 'localhost', port: 6379 })],
-   * })
-   * export class AppModule {}
-   * ```
-   */
-  static forRoot(options) {
-    class RedisModuleDefinition {}
-    return defineModule(RedisModuleDefinition, {
-      global: true,
-      exports: [REDIS_CLIENT, RedisService],
-      providers: createRedisProviders(options)
-    });
-  }
-
-  /**
-   * Registers one additional named Redis client without changing the default aliases.
-   *
-   * @param name Stable Redis client name used to derive named raw-client and facade tokens.
-   * @param options Redis client options used to construct the named connection.
-   * @returns A module definition that exports the named raw-client token and named `RedisService` token.
-   *
-   * @see getRedisClientToken
-   * @see getRedisServiceToken
-   *
-   * @example
-   * ```ts
-   * import { Module, Inject } from '@fluojs/core';
-   * import type Redis from 'ioredis';
-   * import {
-   *   getRedisClientToken,
-   *   getRedisServiceToken,
-   *   RedisModule,
-   *   RedisService,
-   * } from '@fluojs/redis';
-   *
-   * const ANALYTICS_REDIS = getRedisServiceToken('analytics');
-   * const ANALYTICS_REDIS_CLIENT = getRedisClientToken('analytics');
-   *
-   * @Module({
    *   imports: [
    *     RedisModule.forRoot({ host: 'localhost', port: 6379 }),
-   *     RedisModule.forRootNamed('analytics', { host: 'localhost', port: 6380 }),
+   *     RedisModule.forRoot({ name: 'analytics', host: 'localhost', port: 6380 }),
    *   ],
    * })
    * export class AppModule {}
-   *
-   * @Inject(RedisService, ANALYTICS_REDIS, ANALYTICS_REDIS_CLIENT)
-   * export class AnalyticsStore {
-   *   constructor(
-   *     private readonly defaultRedis: RedisService,
-   *     private readonly analyticsRedis: RedisService,
-   *     private readonly analyticsClient: Redis,
-   *   ) {}
-   * }
    * ```
    */
-  static forRootNamed(name, options) {
-    const clientToken = getRedisClientToken(name);
-    const serviceToken = getRedisServiceToken(name);
-    class NamedRedisModuleDefinition {}
-    return defineModule(NamedRedisModuleDefinition, {
-      global: true,
-      exports: [clientToken, serviceToken],
-      providers: createRedisProviders(options, name)
+  static forRoot(options) {
+    const normalized = normalizeRedisModuleOptions(options);
+    const clientToken = getRedisClientToken(normalized.name);
+    const serviceToken = getRedisServiceToken(normalized.name);
+    class RedisModuleDefinition {}
+    return defineModule(RedisModuleDefinition, {
+      global: normalized.global,
+      exports: normalized.name === undefined ? [REDIS_CLIENT, RedisService] : [clientToken, serviceToken],
+      providers: createRedisProviders(normalized.clientOptions, normalized.name)
     });
   }
 }

package/dist/redis-service.d.ts

@@ -59,7 +59,7 @@ export declare class RedisService {
 /**
  * Resolves the facade token for the default or a named `RedisService` binding.
  *
- * @param name Optional Redis client name registered through `RedisModule.forRootNamed(...)`.
+ * @param name Optional Redis client name registered through `RedisModule.forRoot({ name, ... })`.
  * @returns `RedisService` for the default client path, otherwise a stable named service token.
  *
  * @example
@@ -72,7 +72,7 @@ export declare class RedisService {
  * }
  * ```
  *
- * @see RedisModule.forRootNamed
+ * @see RedisModule.forRoot
  * @see getRedisClientToken
  */
 export declare function getRedisServiceToken(name?: string): Token<RedisService>;

package/dist/redis-service.js

@@ -113,7 +113,7 @@ class RedisService {
 /**
  * Resolves the facade token for the default or a named `RedisService` binding.
  *
- * @param name Optional Redis client name registered through `RedisModule.forRootNamed(...)`.
+ * @param name Optional Redis client name registered through `RedisModule.forRoot({ name, ... })`.
  * @returns `RedisService` for the default client path, otherwise a stable named service token.
  *
  * @example
@@ -126,7 +126,7 @@ class RedisService {
  * }
  * ```
  *
- * @see RedisModule.forRootNamed
+ * @see RedisModule.forRoot
  * @see getRedisClientToken
  */
 export { _RedisService as RedisService };

package/dist/tokens.d.ts

@@ -9,7 +9,7 @@ export declare const DEFAULT_REDIS_CLIENT_NAME = "default";
 /**
  * Resolves the DI token for the default or a named Redis client.
  *
- * @param name Optional Redis client name registered through `RedisModule.forRootNamed(...)`.
+ * @param name Optional Redis client name registered through `RedisModule.forRoot({ name, ... })`.
  * @returns The default `REDIS_CLIENT` token when `name` is omitted, otherwise a stable named token.
  *
  * @example
@@ -22,14 +22,14 @@ export declare const DEFAULT_REDIS_CLIENT_NAME = "default";
  * }
  * ```
  *
- * @see RedisModule.forRootNamed
+ * @see RedisModule.forRoot
  * @see getRedisServiceToken
  */
 export declare function getRedisClientToken(name?: string): symbol;
 /**
  * Builds the stable component/dependency id used by platform status snapshots.
  *
- * @param name Optional Redis client name registered through `RedisModule.forRootNamed(...)`.
+ * @param name Optional Redis client name registered through `RedisModule.forRoot({ name, ... })`.
  * @returns A stable component id such as `redis.default` or `redis.jobs`.
  *
  * @see getRedisClientToken

package/dist/tokens.js

@@ -31,7 +31,7 @@ function getOrCreateNamedRedisClientToken(name) {
 /**
  * Resolves the DI token for the default or a named Redis client.
  *
- * @param name Optional Redis client name registered through `RedisModule.forRootNamed(...)`.
+ * @param name Optional Redis client name registered through `RedisModule.forRoot({ name, ... })`.
  * @returns The default `REDIS_CLIENT` token when `name` is omitted, otherwise a stable named token.
  *
  * @example
@@ -44,7 +44,7 @@ function getOrCreateNamedRedisClientToken(name) {
  * }
  * ```
  *
- * @see RedisModule.forRootNamed
+ * @see RedisModule.forRoot
  * @see getRedisServiceToken
  */
 export function getRedisClientToken(name) {
@@ -58,7 +58,7 @@ export function getRedisClientToken(name) {
 /**
  * Builds the stable component/dependency id used by platform status snapshots.
  *
- * @param name Optional Redis client name registered through `RedisModule.forRootNamed(...)`.
+ * @param name Optional Redis client name registered through `RedisModule.forRoot({ name, ... })`.
  * @returns A stable component id such as `redis.default` or `redis.jobs`.
  *
  * @see getRedisClientToken

package/dist/types.d.ts

@@ -1,9 +1,26 @@
 import type { RedisOptions } from 'ioredis';
+type RedisConnectionOptions = Omit<RedisOptions, 'lazyConnect'>;
+/** Options accepted by the default unnamed Redis registration. */
+export type DefaultRedisModuleOptions = RedisConnectionOptions & {
+    /** Whether the default Redis aliases should be visible globally. Defaults to `true`. */
+    global?: boolean;
+    name?: undefined;
+};
+/** Options accepted by an additional named Redis registration. */
+export type NamedRedisModuleOptions = RedisConnectionOptions & {
+    /** Registration name used to derive named raw-client and facade tokens. */
+    name: string;
+    /** Named Redis registrations remain scoped to their importing module. */
+    global?: false;
+};
 /**
  * Options accepted by {@link RedisModule.forRoot}.
  *
  * Fluo always enables `lazyConnect` internally so the client connects during
  * application bootstrap instead of import time.
  */
-export type RedisModuleOptions = Omit<RedisOptions, 'lazyConnect'>;
+export type RedisModuleOptions = DefaultRedisModuleOptions | NamedRedisModuleOptions;
+/** Redis constructor options after Fluo module-only fields are removed. */
+export type RedisClientOptions = RedisConnectionOptions;
+export {};
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,KAAK,sBAAsB,GAAG,IAAI,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;AAEhE,kEAAkE;AAClE,MAAM,MAAM,yBAAyB,GAAG,sBAAsB,GAAG;IAC/D,wFAAwF;IACxF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB,CAAC;AAEF,kEAAkE;AAClE,MAAM,MAAM,uBAAuB,GAAG,sBAAsB,GAAG;IAC7D,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,MAAM,CAAC,EAAE,KAAK,CAAC;CAChB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,yBAAyB,GAAG,uBAAuB,CAAC;AAErF,2EAA2E;AAC3E,MAAM,MAAM,kBAAkB,GAAG,sBAAsB,CAAC"}

package/package.json

@@ -9,7 +9,7 @@
     "connection",
     "lifecycle"
   ],
-  "version": "1.0.0-beta.2",
+  "version": "1.0.0-beta.4",
   "private": false,
   "license": "MIT",
   "repository": {
@@ -36,12 +36,15 @@
     "dist"
   ],
   "dependencies": {
-    "ioredis": "^5.10.0",
-    "@fluojs/di": "^1.0.0-beta.2",
-    "@fluojs/runtime": "^1.0.0-beta.2",
-    "@fluojs/core": "^1.0.0-beta.1"
+    "@fluojs/core": "^1.0.0-beta.5",
+    "@fluojs/di": "^1.0.0-beta.7",
+    "@fluojs/runtime": "^1.0.0-beta.12"
+  },
+  "peerDependencies": {
+    "ioredis": "^5.10.0"
   },
   "devDependencies": {
+    "ioredis": "^5.10.0",
     "vitest": "^3.2.4"
   },
   "scripts": {