@owlmeans/redis 0.1.18-rc.2 → 0.1.18-rc.20

package/README.md

@@ -12,7 +12,7 @@ Redis service for OwlMeans server contexts — connection management with cluste
 ## Installation
 
 ```bash
-bun add @owlmeans/redis
+bun add @owlmeans/redis@^0.1.18-rc.11
 ```
 
 ## Usage
@@ -24,16 +24,20 @@ import { appendRedis, DEFAULT_ALIAS } from '@owlmeans/redis'
 appendRedis<C, T>(context)
 ```
 
-Config (`config.json`):
+Config (`config.json`) — `dbs` is a list, and `schema` becomes the key prefix every resource on
+this connection namespaces itself under:
 
 ```json
 {
-  "dbs": {
-    "redis": {
+  "dbs": [
+    {
+      "service": "redis",
+      "alias": "redis",
       "host": "localhost",
-      "port": 6379
+      "port": 6379,
+      "schema": "app"
     }
-  }
+  ]
 }
 ```
 
@@ -49,7 +53,21 @@ Registers the Redis service in the context.
 
 ### `RedisMeta`
 
-Extends `RedisOptions` (ioredis) — all ioredis connection options are supported in config.
+Extends `RedisOptions` (ioredis) — all ioredis connection options are supported in config. Set
+the database index with `dbIndex` (it accepts a string, so it can come from a file-mounted config
+value) rather than ioredis' own `db`.
+
+## Server Requirements
+
+- Redis **6.2 or newer** — `@owlmeans/redis-resource` deletes with `GETDEL`.
+- `notify-keyspace-events` enabled if any resource uses `watch`; keyspace events are emitted on
+  **db 0**, so deployments sharing an instance isolate on the key prefix, not on `dbIndex`.
+
+## Tests
+
+`tests/` holds the integration specs for the `@owlmeans/redis-resource` contract — this is the
+package that supplies the connection it runs against. Gated on `REDIS_URL` (see `/.env.example`):
+`bun test ./tests`.
 
 ## Related Packages
 
@@ -64,7 +82,7 @@ This package ships embedded agent skills under `agent-meta/`. After installing y
 your project's skill store (`.agents/skills/`):
 
 ```sh
-npx @owlmeans/agent-skills
+npx @owlmeans/agent-skills@^0.1.18-rc.20
 ```
 
 The embedded files are version-matched to this package release. Do not edit them

package/agent-meta/manifest.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 2,
   "package": "@owlmeans/redis",
-  "version": "0.1.18-rc.0",
-  "generatedAt": "2026-08-16T22:20:50.516Z",
+  "version": "0.1.18-rc.20",
+  "generatedAt": "2026-09-12T14:21:25.470Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

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

@@ -1,6 +1,6 @@
 ---
 name: redis
-description: How to use @owlmeans/redis — Redis client service factory (makeRedisService) registered on a server context. Auto-invoked when wiring Redis into a server app.
+description: How to use @owlmeans/redis — the Redis connection service (makeRedisService / appendRedis) registered on a server context, its cfg.dbs configuration, the options() seam for consumers that need a connection of their own, and the cluster caveat. Auto-invoked when wiring Redis into a server app.
 user-invocable: false
 ---
 <!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
@@ -8,26 +8,100 @@ user-invocable: false
 # @owlmeans/redis
 
 **Layer:** Infra
-**Install:** `"@owlmeans/redis": "^0.1.18-rc.0"` in `dependencies`
+**Install:** `"@owlmeans/redis": "^0.1.18-rc.20"` in `dependencies`
+
+The connection half. The `Resource` contract over those connections is `@owlmeans/redis-resource`;
+queues on them are `@owlmeans/redis-queue`.
 
 ## Key Exports
 
 | Export | Description |
 |--------|-------------|
-| `makeRedisService()` | Factory for the Redis connection service |
-| `Redis` types | Service interface, client handle |
-| Constants | `DEFAULT_ALIAS` for the redis service |
+| `appendRedis(context, alias?)` | Register the service — the usual wiring |
+| `makeRedisService(alias?)` | The bare factory, when registering it yourself |
+| `RedisMeta` | What `cfg.dbs[].meta` accepts here: `dbIndex`, `masterNumber`, `slaveNumber`, plus any ioredis option |
+| Constants | `DEFAULT_ALIAS` (`redis`, shared with `@owlmeans/redis-resource`) |
+
+The service interface itself (`RedisDbService`, `RedisClient`, `RedisDb`, `RedisConnection`) is
+declared in `@owlmeans/redis-resource`, so a consumer types against the contract package rather
+than against the driver.
 
 ## Usage
 
 ```typescript
-import { makeRedisService } from '@owlmeans/redis'
-context.registerService(makeRedisService())
+import { appendRedis } from '@owlmeans/redis'
 
-// Connection settings via cfg.services / cfg.dbs
+appendRedis(context)
+```
+
+```typescript
+const redis = context.service<RedisDbService>(DEFAULT_ALIAS)
+await redis.ready()
+const client = await redis.client()          // the pooled connection
+const { single, cluster, prefix } = redis.options()
 ```
 
+Connections are configured through `cfg.dbs` — a LIST of `DbConfig` entries, each naming the
+`service` that owns it and the `alias` it answers to. Every entry for this service is resolved when
+the service initializes, and its client is closed on SIGTERM.
+
+| Field | Meaning |
+|---|---|
+| `host` | A string for a single server; an ARRAY makes it a cluster (see below) |
+| `port` | Defaults to 6379 |
+| `secret` | The password |
+| `user` | Sent as ioredis' `username` **only when set** — a bare `requirepass` server rejects AUTH with a username, so leave it absent unless the server has ACL users |
+| `schema` | The key prefix, falling back to the entry's `alias` and then the service's. Every resource on the connection namespaces itself `<prefix>-<resource name>:<id>` |
+| `meta.dbIndex` | The database index (`SELECT n`). Accepts a string, so it can come from a file-mounted config value; never use ioredis' own `db` |
+
+**A `dbIndex` other than 0 turns `watch` off.** Redis publishes keyspace events per database, as
+`__keyspace@<db>__:<key>`, and `@owlmeans/redis-resource` subscribes to `__keyspace@0__:` — so on
+any other index a resource's `watch` handler silently never fires. Deployments sharing one instance
+isolate on the key prefix (`schema`), and leave `dbIndex` alone wherever anything watches.
+
+## `options()` versus `client()`
+
+`options(alias)` hands out the settings rather than a client, because a consumer that BLOCKS on a
+read holds its connection for the duration and so cannot share the pooled one. Anything doing that
+— BullMQ's workers and event streams, for instance — builds its own client from these settings,
+which keeps the configuration here instead of being re-derived from `cfg.dbs` and drifting. It
+answers `{ single, prefix }` for one host and `{ cluster, prefix }` for several; exactly one of the
+two is present, which is how a consumer that cannot work on a cluster refuses at connection time.
+
+## Server Requirements
+
+- Redis **6.2 or newer** — `@owlmeans/redis-resource` deletes with `GETDEL`, which is the whole
+  reason `delete`/`take` hand back the record they removed without a preceding read.
+- `notify-keyspace-events` enabled if any resource uses `watch` — redis publishes nothing
+  otherwise.
+- **A single server for anything answering criteria.** A resource answers `list`/`count`/`purge`
+  and `load(where)` by walking its own prefix with `SCAN`, which reaches one server — so in a
+  clustered deployment those calls see a fraction of the keyspace. Keep clustered resources on the
+  by-id operations, or put the data in mongo or postgres. Queues refuse a cluster outright.
+
+## A multi-host entry OWNS its cluster
+
+A `dbs[]` entry whose `host` is an array of more than one does not merely connect: it asserts the
+topology. It MEETs the nodes it was given, FORGETs the ones it was not, and where the layout does
+not match `meta.masterNumber` / `meta.slaveNumber` it resets nodes and reassigns slot ranges —
+which flushes them. Point such an entry only at a cluster this service is meant to own; for a
+cluster managed elsewhere, or for a single server, give `host` one string. (A one-element array
+collapses to a single connection and is safe.)
+
+## Tests
+
+This package's `tests/` hold the integration specs for the `@owlmeans/redis-resource` contract —
+it supplies the connection they run against. Gated on `REDIS_URL` (see `/.env.example`); run them
+with `bun test ./tests`.
+
 ## Depends On
 
-- `@owlmeans/server-context`, `@owlmeans/resource`
+- `@owlmeans/redis-resource` — the service and resource contracts, and `DEFAULT_DB_ALIAS`
+- `@owlmeans/resource` — `createDbService`, `DbConfig`
+- `@owlmeans/server-context` — the config and context this service binds to
 - `ioredis` (runtime)
+
+## Related
+
+- `redis-resource` — records, TTL, pub/sub, keyspace watching and streams over these connections
+- `redis-queue` — BullMQ queues over them

package/build/service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAwB,MAAM,0BAA0B,CAAA;AAKpF,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAG3E,KAAK,MAAM,GAAG,YAAY,CAAA;AAC1B,UAAU,OAAO,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAE,SAAQ,aAAa,CAAC,CAAC,CAAC;CAAI;AAEzE,eAAO,MAAM,gBAAgB,WAAW,MAAM,KAAmB,cAwEhE,CAAA;AAED,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,WACpE,CAAC,UAAS,MAAM,KACxB,CAMF,CAAA"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAwB,MAAM,0BAA0B,CAAA;AAIpF,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAG3E,KAAK,MAAM,GAAG,YAAY,CAAA;AAC1B,UAAU,OAAO,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAE,SAAQ,aAAa,CAAC,CAAC,CAAC;CAAI;AAEzE,eAAO,MAAM,gBAAgB,WAAW,MAAM,KAAmB,cAgEhE,CAAA;AAED,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,WACpE,CAAC,UAAS,MAAM,KACxB,CAMF,CAAA"}

package/build/service.js

@@ -1,7 +1,7 @@
 import { DEFAULT_ALIAS } from './consts.js';
 import { createDbService } from '@owlmeans/resource';
-import { assertContext, Layer } from '@owlmeans/context';
-import { createClient } from './utils/index.js';
+import { assertContext } from '@owlmeans/context';
+import { createClient, prepareClusterRedisOptions, prepareSingleRedisOptions } from './utils/index.js';
 export const makeRedisService = (alias = DEFAULT_ALIAS) => {
     const location = `redis:${alias}`;
     const service = createDbService(alias, {
@@ -14,21 +14,21 @@ export const makeRedisService = (alias = DEFAULT_ALIAS) => {
              */
             return { client: client.duplicate(), prefix: name };
         },
+        options: configAlias => {
+            configAlias = service.ensureConfigAlias(configAlias);
+            const config = service.config(configAlias);
+            const prefix = service.name(configAlias);
+            const hosts = Array.isArray(config.host) ? config.host : [config.host];
+            return hosts.length > 1
+                ? { cluster: prepareClusterRedisOptions(config), prefix }
+                : { single: prepareSingleRedisOptions(config, hosts[0]), prefix };
+        },
         initialize: async (configAlias) => {
             configAlias = service.ensureConfigAlias(configAlias);
             const config = service.config(configAlias);
             if (service.clients[configAlias] != null) {
                 return;
             }
-            if (service.layers == null) {
-                service.layers = [Layer.Global];
-            }
-            if (config.serviceSensitive && service.layers.includes(Layer.Service)) {
-                service.layers.push(Layer.Service);
-            }
-            if (config.entitySensitive && service.layers.includes(Layer.Entity)) {
-                service.layers.push(Layer.Entity);
-            }
             let client = await createClient(config);
             // we need to check all hosts for replication consistancy
             if (service.clients[configAlias] != null) {
@@ -38,12 +38,6 @@ export const makeRedisService = (alias = DEFAULT_ALIAS) => {
                 client.quit();
             });
             service.clients[configAlias] = client;
-        },
-        reinitializeContext: (context) => {
-            const _service = makeRedisService(alias);
-            _service.ctx = context;
-            _service.layers = service.layers;
-            return _service;
         }
     }, service => async () => {
         const context = assertContext(service.ctx, location);

package/build/service.js.map

@@ -1 +1 @@
-{"version":3,"file":"service.js","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"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"}

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;AAoB5C,eAAO,MAAM,yBAAyB,WAAY,QAAQ,CAAC,SAAS,CAAC,SAAS,MAAM,KAAG,YAWtF,CAAA;AAED,eAAO,MAAM,0BAA0B,WAAY,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,WAAY,QAAQ,CAAC,SAAS,CAAC,SAAS,MAAM,KAAG,YActF,CAAA;AAED,eAAO,MAAM,0BAA0B,WAAY,QAAQ,CAAC,SAAS,CAAC,KAAG;IAAE,KAAK,EAAE,WAAW,EAAE,CAAC;IAAC,OAAO,EAAE,cAAc,CAAA;CAiBvH,CAAA"}

package/build/utils/config.js

@@ -23,6 +23,9 @@ export const prepareSingleRedisOptions = (config, host) => {
     return {
         host: host,
         port: config.port ?? 6379,
+        // Only sent when configured: a bare `requirepass` server rejects AUTH with a username, so an
+        // undefined `user` has to stay absent rather than become an empty string.
+        ...(config.user != null ? { username: config.user } : {}),
         password: config.secret,
         ...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,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"}
+{"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,6FAA6F;QAC7F,0EAA0E;QAC1E,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzD,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.18-rc.2",
+  "version": "0.1.18-rc.20",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -23,18 +23,18 @@
   },
   "devDependencies": {
     "@owlmeans/dep-config": "workspace:*",
-    "@owlmeans/test-integration": "^0.1.18-rc.2",
-    "@types/bun": "^1.3.14",
+    "@owlmeans/test-integration": "^0.1.18-rc.16",
+    "@types/bun": "^1.4.0",
     "@types/node": "^26.1.0",
     "nodemon": "^3.1.14",
     "typescript": "^7.0.2"
   },
   "dependencies": {
     "@noble/hashes": "^1.5.0",
-    "@owlmeans/context": "^0.1.18-rc.2",
-    "@owlmeans/redis-resource": "^0.1.18-rc.2",
-    "@owlmeans/resource": "^0.1.18-rc.2",
-    "@owlmeans/server-context": "^0.1.18-rc.2",
+    "@owlmeans/context": "^0.1.18-rc.16",
+    "@owlmeans/redis-resource": "^0.1.18-rc.20",
+    "@owlmeans/resource": "^0.1.18-rc.17",
+    "@owlmeans/server-context": "^0.1.18-rc.20",
     "@scure/base": "^2.3.0",
     "ioredis": "^5.4.1"
   },

package/src/service.ts

@@ -1,10 +1,9 @@
 import type { RedisDbService, RedisClient, RedisDb } from '@owlmeans/redis-resource'
 import { DEFAULT_ALIAS } from './consts.js'
 import { createDbService } from '@owlmeans/resource'
-import { assertContext, Layer } from '@owlmeans/context'
-import type { BasicContext } from '@owlmeans/context'
+import { assertContext } from '@owlmeans/context'
 import type { ServerContext, ServerConfig } from '@owlmeans/server-context'
-import { createClient } from './utils/index.js'
+import { createClient, prepareClusterRedisOptions, prepareSingleRedisOptions } from './utils/index.js'
 
 type Config = ServerConfig
 interface Context<C extends Config = Config> extends ServerContext<C> { }
@@ -26,6 +25,18 @@ export const makeRedisService = (alias: string = DEFAULT_ALIAS): RedisDbService
       return { client: client.duplicate(), prefix: name }
     },
 
+    options: configAlias => {
+      configAlias = service.ensureConfigAlias(configAlias)
+      const config = service.config(configAlias)
+      const prefix = service.name(configAlias)
+
+      const hosts = Array.isArray(config.host) ? config.host : [config.host]
+
+      return hosts.length > 1
+        ? { cluster: prepareClusterRedisOptions(config), prefix }
+        : { single: prepareSingleRedisOptions(config, hosts[0]), prefix }
+    },
+
     initialize: async configAlias => {
       configAlias = service.ensureConfigAlias(configAlias)
       const config = service.config(configAlias)
@@ -34,16 +45,6 @@ export const makeRedisService = (alias: string = DEFAULT_ALIAS): RedisDbService
         return
       }
 
-      if (service.layers == null) {
-        service.layers = [Layer.Global]
-      }
-      if (config.serviceSensitive && service.layers.includes(Layer.Service)) {
-        service.layers.push(Layer.Service)
-      }
-      if (config.entitySensitive && service.layers.includes(Layer.Entity)) {
-        service.layers.push(Layer.Entity)
-      }
-
       let client = await createClient(config)
 
       // we need to check all hosts for replication consistancy
@@ -57,16 +58,6 @@ export const makeRedisService = (alias: string = DEFAULT_ALIAS): RedisDbService
       })
 
       service.clients[configAlias] = client
-    },
-
-    reinitializeContext: <T>(context: BasicContext<ServerConfig>) => {
-      const _service = makeRedisService(alias)
-
-      _service.ctx = context
-
-      _service.layers = service.layers
-
-      return _service as T
     }
   }, service => async () => {
     const context = assertContext<Config, Context>(service.ctx as Context, location)

package/src/utils/config.ts

@@ -28,6 +28,9 @@ export const prepareSingleRedisOptions = (config: DbConfig<RedisMeta>, host?: st
   return {
     host: host,
     port: config.port ?? 6379,
+    // Only sent when configured: a bare `requirepass` server rejects AUTH with a username, so an
+    // undefined `user` has to stay absent rather than become an empty string.
+    ...(config.user != null ? { username: config.user } : {}),
     password: config.secret,
     ...normalizeRedisMeta(config.meta)
   }

package/tests/context.ts

@@ -28,11 +28,15 @@ export interface RedisSuite {
  * One key prefix per suite, dropped by that suite's own `afterAll` — Bun runs every spec
  * file of a package in one process, so a process-global cleanup queue would let the first
  * file to finish flush the keys of the files still to come.
+ *
+ * A spec that walks the namespace — `list`, `count`, `purge` — boots under its own resource
+ * alias, because a resource's keys are namespaced by `<schema>-<alias>` and the walk sees every
+ * key of the alias it belongs to, including the ones an earlier test in the same file left.
  */
 export const makeSuite = (label: string): RedisSuite => {
   const base = process.env.REDIS_TEST_KEY_PREFIX ?? 'omt'
   const prefix = randomNamespace(`${base}_${label}`)
-  const contexts: Array<ServerContext<ServerConfig>> = []
+  const resources: Array<RedisResource<TestRecord>> = []
 
   const boot = async (alias = 'test-records'): Promise<{
     context: ServerContext<ServerConfig>
@@ -58,26 +62,42 @@ export const makeSuite = (label: string): RedisSuite => {
 
     context.configure()
     await context.init()
-    contexts.push(context)
+    const booted = context.resource<RedisResource<TestRecord>>(alias)
+    resources.push(booted)
 
-    return { context, resource: context.resource<RedisResource<TestRecord>>(alias) }
+    return { context, resource: booted }
   }
 
+  /**
+   * Every key the suite wrote, matched as `<prefix>*` rather than `<prefix>:*`: a resource
+   * namespaces its keys as `<schema>-<alias>:<id>`, so the schema is followed by a dash, not
+   * by the separator. SCAN for the same reason the resource uses it — KEYS blocks the server.
+   */
   const teardown = async (): Promise<void> => {
     if (gate.skip) {
       return
     }
-    for (const context of contexts) {
-      const resource = context.resource<RedisResource<TestRecord>>('test-records')
+    for (const resource of resources) {
       const client = resource.db?.client
       if (client == null) continue
-      const keys = await client.keys(`${prefix}:*`).catch(() => [] as string[])
-      if (keys.length > 0) {
-        await client.del(...keys).catch(() => undefined)
+      try {
+        const keys: string[] = []
+        let cursor = '0'
+        do {
+          const [next, batch] = await client.scan(cursor, 'MATCH', `${prefix}*`, 'COUNT', 500)
+          cursor = next
+          keys.push(...batch)
+        } while (cursor !== '0')
+        if (keys.length > 0) {
+          await client.del(keys)
+        }
+      } catch {
+        // A connection already gone takes its keys' cleanup with it — the prefix is unique
+        // per run, so anything left behind never collides with another suite.
       }
       await client.quit().catch(() => undefined)
     }
-    contexts.length = 0
+    resources.length = 0
   }
 
   return { prefix, boot, teardown }

package/tests/query.spec.ts

@@ -0,0 +1,111 @@
+import { afterAll, describe, expect, test } from 'bun:test'
+import { gate, makeSuite } from './context.js'
+
+/**
+ * The criteria surface.
+ *
+ * Redis has no index, so anything that is not a bare id is a SCAN of the resource's own namespace
+ * evaluated in memory. These assert what that walk owes the caller: criteria reads, an unpaged
+ * default, the window that was actually asked for, a total that always counts every match, and a
+ * purge that refuses to empty the namespace on an unset filter.
+ */
+describe('@owlmeans/redis — resource queries', () => {
+  if (gate.skip) {
+    test.skip(gate.reason ?? 'redis gate closed', () => { })
+    return
+  }
+
+  const suite = makeSuite('query')
+
+  afterAll(async () => {
+    await suite.teardown()
+  })
+
+  /** `rec-0` … `rec-<count-1>`, alternating `even` / `odd`, in a namespace of their own. */
+  const seed = async (alias: string, count: number) => {
+    const { resource } = await suite.boot(alias)
+    for (let index = 0; index < count; index++) {
+      await resource.create({ id: `rec-${index}`, value: index % 2 === 0 ? 'even' : 'odd' })
+    }
+
+    return resource
+  }
+
+  test('load takes criteria, not only an id', async () => {
+    const resource = await seed('q-load', 0)
+    await resource.create({ id: 'one', value: 'needle' })
+    await resource.create({ id: 'two', value: 'hay' })
+
+    expect(await resource.load({ value: 'needle' })).toMatchObject({ id: 'one' })
+    expect(await resource.load({ value: 'absent' })).toBeNull()
+  })
+
+  test('get throws when nothing matches the criteria', async () => {
+    const resource = await seed('q-get', 0)
+
+    await expect(resource.get({ value: 'absent' })).rejects.toThrow()
+  })
+
+  test('list returns every match when no size is asked for', async () => {
+    const resource = await seed('q-unpaged', 5)
+
+    const result = await resource.list()
+
+    expect(result.items).toHaveLength(5)
+    expect(result.total).toBe(5)
+  })
+
+  test('list returns the page it was asked for, not the list minus that page', async () => {
+    const resource = await seed('q-paged', 5)
+
+    const result = await resource.list({}, { page: 1, size: 2, sort: ['id'] })
+
+    expect(result.items.map(item => item.id)).toEqual(['rec-2', 'rec-3'])
+    expect(result.total).toBe(5)
+  })
+
+  test('a page without a size is a caller error', async () => {
+    const resource = await seed('q-page-only', 1)
+
+    await expect(resource.list({}, { page: 1 })).rejects.toThrow()
+  })
+
+  test('count answers the match count', async () => {
+    const resource = await seed('q-count', 5)
+
+    expect(await resource.count()).toBe(5)
+    expect(await resource.count({ value: 'even' })).toBe(3)
+  })
+
+  test('purge deletes every match and refuses empty criteria', async () => {
+    const resource = await seed('q-purge', 5)
+
+    expect(await resource.purge({ value: 'odd' })).toBe(2)
+    expect(await resource.count()).toBe(3)
+    await expect(resource.purge({})).rejects.toThrow()
+  })
+
+  test('update replaces the record rather than merging into it', async () => {
+    const resource = await seed('q-update', 0)
+    await resource.create({ id: 'replaced', value: 'before' })
+
+    await resource.update({ id: 'replaced' })
+
+    expect(await resource.load('replaced')).toEqual({ id: 'replaced' })
+  })
+
+  test('update throws for an id that was never created', async () => {
+    const resource = await seed('q-missing', 0)
+
+    await expect(resource.update({ id: 'never-created' })).rejects.toThrow()
+  })
+
+  test('save creates a record that carries no id', async () => {
+    const resource = await seed('q-save', 0)
+
+    const saved = await resource.save({ value: 'fresh' })
+
+    expect(typeof saved.id).toBe('string')
+    expect(await resource.load(saved.id)).toMatchObject({ value: 'fresh' })
+  })
+})

package/tests/resource.spec.ts

@@ -2,13 +2,12 @@ import { afterAll, describe, expect, test } from 'bun:test'
 import { gate, makeSuite } from './context.js'
 
 /**
- * `delete` regression coverage.
+ * `delete` / `take` coverage.
  *
- * The by-id form silently did nothing: `delete(id, opts)` only loaded the record when `id`
- * was an object or `opts` was a field name, so the plain `delete(id)` every caller uses fell
- * through to `record == null` and returned before touching redis. It surfaced as
- * `RecordExists` on the second email-OTP request for one address inside the code's TTL —
- * `issueChallenge` upserts by deleting first — and left consumed codes alive in the store.
+ * Both drop the key with GETDEL and hand back what was under it; they differ only in what an
+ * absent id means — `delete` answers `null`, `take` throws. The by-id form carries the whole
+ * contract: a `delete(id)` that returns without touching redis leaves consumed OTP codes alive
+ * in the store and turns the next `create` under that id into `RecordExists`.
  */
 describe('@owlmeans/redis — resource delete', () => {
   if (gate.skip) {
@@ -22,7 +21,7 @@ describe('@owlmeans/redis — resource delete', () => {
     await suite.teardown()
   })
 
-  test('removes the record when called by id alone', async () => {
+  test('removes the record when called by id', async () => {
     const { resource } = await suite.boot()
     await resource.create({ id: 'by-id', value: 'first' })
 
@@ -46,11 +45,24 @@ describe('@owlmeans/redis — resource delete', () => {
     expect((await resource.load('otp'))?.value).toBe('second-code')
   })
 
-  test('removes the record when handed the record itself', async () => {
+  test('take hands back the record it removed', async () => {
     const { resource } = await suite.boot()
-    const record = await resource.create({ id: 'by-record', value: 'x' })
+    await resource.create({ id: 'taken', value: 'once' })
 
-    expect(await resource.delete(record)).toMatchObject({ id: 'by-record' })
-    expect(await resource.load('by-record')).toBeNull()
+    expect(await resource.take('taken')).toMatchObject({ value: 'once' })
+    expect(await resource.load('taken')).toBeNull()
+  })
+
+  test('take throws for an id that is not there', async () => {
+    const { resource } = await suite.boot()
+
+    await expect(resource.take('never-taken')).rejects.toThrow()
+  })
+
+  test('create refuses an id that is already taken', async () => {
+    const { resource } = await suite.boot()
+    await resource.create({ id: 'occupied', value: 'first' })
+
+    await expect(resource.create({ id: 'occupied', value: 'second' })).rejects.toThrow()
   })
 })