@enterprisestandard/redis 0.0.13 → 0.0.14-beta.20260331.2

package/README.md

@@ -1,6 +1,6 @@
 # @enterprisestandard/redis
 
-redis (node-redis) adapter and Redis stores for Enterprise Standard. Includes **createRedisAdapter** (v5, default) and **createRedisAdapterV4** (v4). Install this package; redis is included. You do not need to install `@enterprisestandard/redis-core` separately.
+redis (node-redis) adapter and Redis stores for Enterprise Standard. Includes **createRedisAdapter** (v5, default), **createRedisAdapterV4** (v4), and **`esRedis(...)`** for secret-backed reactive Redis connections. Install this package; redis is included. You do not need to install `@enterprisestandard/redis-core` separately.
 
 ## Installation
 
@@ -8,6 +8,48 @@ redis (node-redis) adapter and Redis stores for Enterprise Standard. Includes **
 bun add @enterprisestandard/redis
 ```
 
+## Secret-backed reactive Redis
+
+Use **`esRedis(path, secrets?)`** when the Redis connection details arrive from `es.secrets` and may rotate over time.
+
+```ts
+import { enterpriseStandard, envConfig } from '@enterprisestandard/server';
+import { createValidators } from '@enterprisestandard/zod';
+import { esRedis, RedisSessionStore, RedisUserStore } from '@enterprisestandard/redis';
+
+const redis = esRedis('examples:sso:redis');
+
+export const es = enterpriseStandard(envConfig(), {
+  validators: createValidators(),
+  secrets: {
+    redis: {},
+  },
+  stores: {
+    sessionStore: new RedisSessionStore({ redis }),
+    userStore: new RedisUserStore({ redis }),
+  },
+  async afterChange(es) {
+    redis.configure(es.secrets);
+  },
+});
+```
+
+Notes:
+
+- The first argument is the **secret path**. By default `esRedis(...)` reads from the named secrets source **`redis`**; override that with `esRedis(path, secrets, { sourceName })` when needed.
+- The secret payload should be a node-redis client options object. A top-level **`url`** or **`redisUrl`** field is the simplest shape.
+- `configure(es.secrets)` re-subscribes to the latest secrets source instance. Store operations wait for the first configured connection, so you can construct stores synchronously and use `ready()` only when you want an explicit startup or health-check barrier.
+
+## Shared env-based adapter
+
+Use **`getSharedRedisAdapter()`** when you only want one process-wide adapter from `REDIS_URL` without secret reactivity:
+
+```ts
+import { getSharedRedisAdapter } from '@enterprisestandard/redis';
+
+const redis = await getSharedRedisAdapter();
+```
+
 For **createRedisAdapterV4** only, also install redis v4:
 
 ```bash

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { RedisAdapter as RedisAdapter2 } from "@enterprisestandard/redis-core";
-import { getKeyPrefix, getLogger, isRedisVersionSupported, prefixedKey, RedisGroupStore, RedisMagicLinkStore, RedisSessionStore, RedisStoreOptions, RedisTenantStore, RedisUserStore, RedisWorkloadTokenStore, supportsSortedSetList } from "@enterprisestandard/redis-core";
+import { RedisAdapter as RedisAdapter3 } from "@enterprisestandard/redis-core";
+import { createReactiveRedis, getKeyPrefix, getLogger, isRedisVersionSupported, prefixedKey, ReactiveRedisAdapter as ReactiveRedisAdapter2, ReactiveRedisClient, ReactiveRedisOptions, RedisGroupStore, RedisMagicLinkStore, RedisSessionStore, RedisStoreOptions, RedisTenantStore, RedisUserStore, RedisWorkloadTokenStore, supportsSortedSetList } from "@enterprisestandard/redis-core";
 import { createClient } from "redis";
 import { RedisAdapter } from "@enterprisestandard/redis-core";
 /**
@@ -60,4 +60,19 @@ declare function createRedisAdapter(client: NodeRedisV5Client): RedisAdapter;
 * Install redis@^4 if you use this. Prefer createRedisAdapter (v5) when possible.
 */
 declare function createRedisAdapterV4(client: NodeRedisV4Client): RedisAdapter;
-export { supportsSortedSetList, prefixedKey, isRedisVersionSupported, getLogger, getKeyPrefix, createRedisAdapterV4, createRedisAdapter, createClient, RedisWorkloadTokenStore, RedisUserStore, RedisTenantStore, RedisStoreOptions, RedisSessionStore, RedisMagicLinkStore, RedisGroupStore, RedisAdapter2 as RedisAdapter, NodeRedisV5Client, NodeRedisV4Client };
+import { Logger, Secrets, SecretsOperationOptions } from "@enterprisestandard/core";
+import { ReactiveRedisAdapter } from "@enterprisestandard/redis-core";
+import { RedisClientOptions } from "redis";
+type ESRedisSecret = RedisClientOptions & {
+	redisUrl?: string;
+	clientOptions?: RedisClientOptions;
+};
+type ESRedisOptions = {
+	sourceName?: string;
+	logger?: Logger;
+	secretOptions?: SecretsOperationOptions;
+};
+declare function esRedis(path: string, secrets?: Secrets, options?: ESRedisOptions): ReactiveRedisAdapter;
+import { RedisAdapter as RedisAdapter2 } from "@enterprisestandard/redis-core";
+declare function getSharedRedisAdapter(): Promise<RedisAdapter2>;
+export { supportsSortedSetList, prefixedKey, isRedisVersionSupported, getSharedRedisAdapter, getLogger, getKeyPrefix, esRedis, createRedisAdapterV4, createRedisAdapter, createReactiveRedis, createClient, RedisWorkloadTokenStore, RedisUserStore, RedisTenantStore, RedisStoreOptions, RedisSessionStore, RedisMagicLinkStore, RedisGroupStore, RedisAdapter3 as RedisAdapter, ReactiveRedisOptions, ReactiveRedisClient, ReactiveRedisAdapter2 as ReactiveRedisAdapter, NodeRedisV5Client, NodeRedisV4Client, ESRedisSecret, ESRedisOptions };

package/dist/index.js

@@ -1 +1 @@
-import{getKeyPrefix as A,getLogger as G,isRedisVersionSupported as M,prefixedKey as O,RedisGroupStore as U,RedisMagicLinkStore as W,RedisSessionStore as j,RedisTenantStore as q,RedisUserStore as z,RedisWorkloadTokenStore as B,supportsSortedSetList as D}from"@enterprisestandard/redis-core";import{createClient as F}from"redis";function L(R){if(typeof R==="string"){let d=/redis_version:([^\r\n]+)/.exec(R);return d?d[1].trim():null}if(R!=null&&typeof R==="object"&&"redis_version"in R){let d=R.redis_version;return typeof d==="string"?d.trim():null}return null}function C(R){return{async get(d){return R.get(d)},async set(d,S){await R.set(d,S)},async setex(d,S,p){await R.setEx(d,S,p)},async del(d){await R.del(d)},async sadd(d,...S){if(S.length>0)await R.sAdd(d,S)},async srem(d,...S){if(S.length>0)await R.sRem(d,S)},async smembers(d){let S=await R.sMembers(d);return Array.from(S)},async mget(d){if(d.length===0)return[];return(await R.mGet(d)).map((p)=>p??null)},async zadd(d,S,p){await R.zAdd(d,{score:S,value:p})},async zrem(d,...S){if(S.length>0)await R.zRem(d,S)},async zrange(d,S,p,g){let x=g?await R.zRange(d,S,p,{REV:!0}):await R.zRange(d,S,p);return Array.isArray(x)?x:[]},async zcard(d){return R.zCard(d)},async getRedisVersion(){let d=await R.info("server");return L(d)}}}function K(R){return{async get(d){return R.get(d)},async set(d,S){await R.set(d,S)},async setex(d,S,p){await R.setEx(d,S,p)},async del(d){await R.del(d)},async sadd(d,...S){if(S.length>0)await R.sAdd(d,S)},async srem(d,...S){if(S.length>0)await R.sRem(d,S)},async smembers(d){let S=await R.sMembers(d);return Array.from(S)},async mget(d){if(d.length===0)return[];return(await R.mGet(d)).map((p)=>p??null)},async zadd(d,S,p){await R.zAdd(d,{score:S,value:p})},async zrem(d,...S){if(S.length>0)await R.zRem(d,S)},async zrange(d,S,p,g){let x=g?await R.zRange(d,S,p,{REV:!0}):await R.zRange(d,S,p);return Array.isArray(x)?x:[]},async zcard(d){return R.zCard(d)},async getRedisVersion(){let d=await R.info("server");return L(d)}}}export{D as supportsSortedSetList,O as prefixedKey,M as isRedisVersionSupported,G as getLogger,A as getKeyPrefix,K as createRedisAdapterV4,C as createRedisAdapter,F as createClient,B as RedisWorkloadTokenStore,z as RedisUserStore,q as RedisTenantStore,j as RedisSessionStore,W as RedisMagicLinkStore,U as RedisGroupStore};
+import{createReactiveRedis as K,getKeyPrefix as T,getLogger as j,isRedisVersionSupported as z,prefixedKey as D,RedisGroupStore as G,RedisMagicLinkStore as M,RedisSessionStore as W,RedisTenantStore as _,RedisUserStore as B,RedisWorkloadTokenStore as F,supportsSortedSetList as H}from"@enterprisestandard/redis-core";import{createClient as J}from"redis";function s(o){if(typeof o==="string"){let r=/redis_version:([^\r\n]+)/.exec(o);return r?r[1].trim():null}if(o!=null&&typeof o==="object"&&"redis_version"in o){let r=o.redis_version;return typeof r==="string"?r.trim():null}return null}function p(o){return{async get(r){return o.get(r)},async set(r,t){await o.set(r,t)},async setex(r,t,d){await o.setEx(r,t,d)},async del(r){await o.del(r)},async sadd(r,...t){if(t.length>0)await o.sAdd(r,t)},async srem(r,...t){if(t.length>0)await o.sRem(r,t)},async smembers(r){let t=await o.sMembers(r);return Array.from(t)},async mget(r){if(r.length===0)return[];return(await o.mGet(r)).map((d)=>d??null)},async zadd(r,t,d){await o.zAdd(r,{score:t,value:d})},async zrem(r,...t){if(t.length>0)await o.zRem(r,t)},async zrange(r,t,d,i){let e=i?await o.zRange(r,t,d,{REV:!0}):await o.zRange(r,t,d);return Array.isArray(e)?e:[]},async zcard(r){return o.zCard(r)},async getRedisVersion(){let r=await o.info("server");return s(r)}}}function R(o){return{async get(r){return o.get(r)},async set(r,t){await o.set(r,t)},async setex(r,t,d){await o.setEx(r,t,d)},async del(r){await o.del(r)},async sadd(r,...t){if(t.length>0)await o.sAdd(r,t)},async srem(r,...t){if(t.length>0)await o.sRem(r,t)},async smembers(r){let t=await o.sMembers(r);return Array.from(t)},async mget(r){if(r.length===0)return[];return(await o.mGet(r)).map((d)=>d??null)},async zadd(r,t,d){await o.zAdd(r,{score:t,value:d})},async zrem(r,...t){if(t.length>0)await o.zRem(r,t)},async zrange(r,t,d,i){let e=i?await o.zRange(r,t,d,{REV:!0}):await o.zRange(r,t,d);return Array.isArray(e)?e:[]},async zcard(r){return o.zCard(r)},async getRedisVersion(){let r=await o.info("server");return s(r)}}}import{createReactiveRedis as a}from"@enterprisestandard/redis-core";import{createClient as S}from"redis";function g(o){return typeof o==="object"&&o!==null&&!Array.isArray(o)}function O(o){let r=g(o.clientOptions)?{...o.clientOptions}:{...o};delete r.redisUrl,delete r.clientOptions;let t=typeof o.redisUrl==="string"?o.redisUrl.trim():"";if(t)r.url=t;return r}async function u(o){if(typeof o.quit==="function"){await o.quit();return}if(typeof o.disconnect==="function"){await o.disconnect();return}o.destroy?.()}function C(o,r,t={}){return a({path:o,secrets:r,sourceName:t.sourceName,logger:t.logger,secretOptions:t.secretOptions,async createClient(d){let i=S(O(d.data));return i.on?.("error",(e)=>{t.logger?.warn?.("Reactive node-redis client error",{path:o,sourceName:t.sourceName??"redis",error:e.message})}),await i.connect(),{adapter:p(i),dispose:async()=>{await u(i)}}}})}import{createClient as f}from"redis";var n;async function A(){return n??=(async()=>{let o=process.env.REDIS_URL?.trim()||"redis://localhost:6379",r=f({url:o});return await r.connect(),p(r)})(),n}export{H as supportsSortedSetList,D as prefixedKey,z as isRedisVersionSupported,A as getSharedRedisAdapter,j as getLogger,T as getKeyPrefix,C as esRedis,R as createRedisAdapterV4,p as createRedisAdapter,K as createReactiveRedis,J as createClient,F as RedisWorkloadTokenStore,B as RedisUserStore,_ as RedisTenantStore,W as RedisSessionStore,M as RedisMagicLinkStore,G as RedisGroupStore};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@enterprisestandard/redis",
-  "version": "0.0.13",
+  "version": "0.0.14-beta.20260331.2",
   "description": "redis (node-redis) adapter and Redis stores for Enterprise Standard. Includes createRedisAdapter (v5) and createRedisAdapterV4 (v4). Install this; redis is included.",
   "private": false,
   "author": "enterprisestandard",
@@ -21,7 +21,7 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@enterprisestandard/redis-core": "^0.0.13",
+    "@enterprisestandard/redis-core": "0.0.14-beta.20260331.2",
     "redis": "^5.10.0"
   },
   "peerDependencies": {