@owlmeans/redis 0.1.11 → 0.1.14

package/agent-meta/instructions/redis.instructions.md

@@ -7,7 +7,7 @@ applyTo: "**/context.ts, **/config.ts, **/*.ts, **/*.tsx"
 # @owlmeans/redis
 
 **Layer:** Infra
-**Install:** `"@owlmeans/redis": "^0.1.11"` in `dependencies`
+**Install:** `"@owlmeans/redis": "^0.1.14"` in `dependencies`
 
 ## Key Exports
 

package/agent-meta/manifest.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 1,
   "package": "@owlmeans/redis",
-  "version": "0.1.11",
-  "generatedAt": "2026-06-17T10:37:52.363Z",
+  "version": "0.1.14",
+  "generatedAt": "2026-08-05T16:56:53.392Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

package/agent-meta/skills/redis/SKILL.md

@@ -8,7 +8,7 @@ user-invocable: false
 # @owlmeans/redis
 
 **Layer:** Infra
-**Install:** `"@owlmeans/redis": "^0.1.11"` in `dependencies`
+**Install:** `"@owlmeans/redis": "^0.1.14"` in `dependencies`
 
 ## Key Exports
 

package/build/types.d.ts

@@ -2,5 +2,6 @@ import type { RedisOptions } from 'ioredis';
 export interface RedisMeta extends RedisOptions {
     masterNumber?: number;
     slaveNumber?: number;
+    dbIndex?: string | number;
 }
 //# sourceMappingURL=types.d.ts.map

package/build/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,CAAA;AAE3C,MAAM,WAAW,SAAU,SAAQ,YAAY;IAC7C,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAE3C,MAAM,WAAW,SAAU,SAAQ,YAAY;IAC7C,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IAIpB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CAC1B"}

package/build/utils/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AACxE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAE5C,eAAO,MAAM,yBAAyB,GAAI,QAAQ,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,MAAM,KAAG,YAWtF,CAAA;AAED,eAAO,MAAM,0BAA0B,GAAI,QAAQ,QAAQ,CAAC,SAAS,CAAC,KAAG;IAAE,KAAK,EAAE,WAAW,EAAE,CAAC;IAAC,OAAO,EAAE,cAAc,CAAA;CAiBvH,CAAA"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AACxE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAoB5C,eAAO,MAAM,yBAAyB,GAAI,QAAQ,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,MAAM,KAAG,YAWtF,CAAA;AAED,eAAO,MAAM,0BAA0B,GAAI,QAAQ,QAAQ,CAAC,SAAS,CAAC,KAAG;IAAE,KAAK,EAAE,WAAW,EAAE,CAAC;IAAC,OAAO,EAAE,cAAc,CAAA;CAiBvH,CAAA"}

package/build/utils/config.js

@@ -1,3 +1,20 @@
+// Translate the configurable `dbIndex` (which may arrive as a string from a file-mounted
+// config value) into ioredis' numeric `db` option, and drop `dbIndex` from the spread so
+// it isn't forwarded as an unknown option.
+const normalizeRedisMeta = (meta) => {
+    if (meta == null) {
+        return {};
+    }
+    const { dbIndex, ...rest } = meta;
+    if (dbIndex == null || `${dbIndex}` === '') {
+        return rest;
+    }
+    const db = Number(dbIndex);
+    if (Number.isNaN(db)) {
+        throw new SyntaxError(`Invalid redis dbIndex: "${dbIndex}"`);
+    }
+    return { ...rest, db };
+};
 export const prepareSingleRedisOptions = (config, host) => {
     host = (host != null ? host : config.host);
     if (typeof host !== 'string') {
@@ -7,7 +24,7 @@ export const prepareSingleRedisOptions = (config, host) => {
         host: host,
         port: config.port ?? 6379,
         password: config.secret,
-        ...config.meta
+        ...normalizeRedisMeta(config.meta)
     };
 };
 export const prepareClusterRedisOptions = (config) => {
@@ -23,7 +40,7 @@ export const prepareClusterRedisOptions = (config) => {
             redisOptions: {
                 // tls: { rejectUnauthorized: false }, // @TODO check if it's working
                 password: config.secret,
-                ...config.meta
+                ...normalizeRedisMeta(config.meta)
             }
         }
     };

package/build/utils/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,MAA2B,EAAE,IAAa,EAAgB,EAAE;IACpG,IAAI,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAW,CAAA;IACpD,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,MAAM,IAAI,WAAW,CAAC,8EAA8E,CAAC,CAAA;IACvG,CAAC;IACD,OAAO;QACL,IAAI,EAAE,IAAI;QACV,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,IAAI;QACzB,QAAQ,EAAE,MAAM,CAAC,MAAM;QACvB,GAAG,MAAM,CAAC,IAAI;KACf,CAAA;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,MAA2B,EAAqD,EAAE;IAC3H,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,WAAW,CAAC,kFAAkF,CAAC,CAAA;IAC3G,CAAC;IACD,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE;YACtE,SAAS,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE;gBAC/B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;YACzB,CAAC;YACD,mBAAmB,EAAE,KAAK;YAC1B,YAAY,EAAE;gBACZ,qEAAqE;gBACrE,QAAQ,EAAE,MAAM,CAAC,MAAM;gBACvB,GAAG,MAAM,CAAC,IAAI;aACf;SACF;KACF,CAAA;AACH,CAAC,CAAA"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAIA,yFAAyF;AACzF,yFAAyF;AACzF,2CAA2C;AAC3C,MAAM,kBAAkB,GAAG,CAAC,IAAgB,EAAgB,EAAE;IAC5D,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;QACjB,OAAO,EAAE,CAAA;IACX,CAAC;IACD,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAA;IACjC,IAAI,OAAO,IAAI,IAAI,IAAI,GAAG,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC;QAC3C,OAAO,IAAI,CAAA;IACb,CAAC;IACD,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,CAAA;IAC1B,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,WAAW,CAAC,2BAA2B,OAAO,GAAG,CAAC,CAAA;IAC9D,CAAC;IACD,OAAO,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,CAAA;AACxB,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,MAA2B,EAAE,IAAa,EAAgB,EAAE;IACpG,IAAI,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAW,CAAA;IACpD,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,MAAM,IAAI,WAAW,CAAC,8EAA8E,CAAC,CAAA;IACvG,CAAC;IACD,OAAO;QACL,IAAI,EAAE,IAAI;QACV,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,IAAI;QACzB,QAAQ,EAAE,MAAM,CAAC,MAAM;QACvB,GAAG,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC;KACnC,CAAA;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,MAA2B,EAAqD,EAAE;IAC3H,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,WAAW,CAAC,kFAAkF,CAAC,CAAA;IAC3G,CAAC;IACD,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE;YACtE,SAAS,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE;gBAC/B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;YACzB,CAAC;YACD,mBAAmB,EAAE,KAAK;YAC1B,YAAY,EAAE;gBACZ,qEAAqE;gBACrE,QAAQ,EAAE,MAAM,CAAC,MAAM;gBACvB,GAAG,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC;aACnC;SACF;KACF,CAAA;AACH,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/redis",
-  "version": "0.1.11",
+  "version": "0.1.14",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -22,16 +22,16 @@
   },
   "devDependencies": {
     "@owlmeans/dep-config": "workspace:*",
-    "@types/node": "^24.10.1",
-    "nodemon": "^3.1.11",
-    "typescript": "^6.0.2"
+    "@types/node": "^26.1.0",
+    "nodemon": "^3.1.14",
+    "typescript": "^6.0.3"
   },
   "dependencies": {
     "@noble/hashes": "^1.5.0",
-    "@owlmeans/context": "^0.1.11",
-    "@owlmeans/redis-resource": "^0.1.11",
-    "@owlmeans/resource": "^0.1.11",
-    "@owlmeans/server-context": "^0.1.11",
+    "@owlmeans/context": "^0.1.14",
+    "@owlmeans/redis-resource": "^0.1.14",
+    "@owlmeans/resource": "^0.1.14",
+    "@owlmeans/server-context": "^0.1.14",
     "@scure/base": "^1.1.9",
     "ioredis": "^5.4.1"
   },

package/src/types.ts

@@ -3,4 +3,8 @@ import type { RedisOptions } from 'ioredis'
 export interface RedisMeta extends RedisOptions {
   masterNumber?: number
   slaveNumber?: number
+  // Numeric Redis database index (SELECT n). Accepts a string so it can be supplied from a
+  // file-mounted config value (e.g. /etc/app-config/cache-db-index); it is coerced to a
+  // number before being passed to ioredis. Prefer this over ioredis' `db` for configurability.
+  dbIndex?: string | number
 }

package/src/utils/config.ts

@@ -2,6 +2,24 @@ import type { DbConfig } from '@owlmeans/resource'
 import type { RedisOptions, ClusterNode, ClusterOptions } from 'ioredis'
 import type { RedisMeta } from '../types.js'
 
+// Translate the configurable `dbIndex` (which may arrive as a string from a file-mounted
+// config value) into ioredis' numeric `db` option, and drop `dbIndex` from the spread so
+// it isn't forwarded as an unknown option.
+const normalizeRedisMeta = (meta?: RedisMeta): RedisOptions => {
+  if (meta == null) {
+    return {}
+  }
+  const { dbIndex, ...rest } = meta
+  if (dbIndex == null || `${dbIndex}` === '') {
+    return rest
+  }
+  const db = Number(dbIndex)
+  if (Number.isNaN(db)) {
+    throw new SyntaxError(`Invalid redis dbIndex: "${dbIndex}"`)
+  }
+  return { ...rest, db }
+}
+
 export const prepareSingleRedisOptions = (config: DbConfig<RedisMeta>, host?: string): RedisOptions => {
   host = (host != null ? host : config.host) as string
   if (typeof host !== 'string') {
@@ -11,7 +29,7 @@ export const prepareSingleRedisOptions = (config: DbConfig<RedisMeta>, host?: st
     host: host,
     port: config.port ?? 6379,
     password: config.secret,
-    ...config.meta
+    ...normalizeRedisMeta(config.meta)
   }
 }
 
@@ -28,7 +46,7 @@ export const prepareClusterRedisOptions = (config: DbConfig<RedisMeta>): { nodes
       redisOptions: {
         // tls: { rejectUnauthorized: false }, // @TODO check if it's working
         password: config.secret,
-        ...config.meta
+        ...normalizeRedisMeta(config.meta)
       }
     }
   }