@owlmeans/redis-resource 0.1.18-rc.11 → 0.1.18-rc.13

package/README.md

@@ -13,7 +13,7 @@ Redis-backed resource with pub/sub, keyspace watching and streams for real-time
 ## Installation
 
 ```bash
-bun add @owlmeans/redis-resource
+bun add @owlmeans/redis-resource@^0.1.18-rc.11
 ```
 
 ## Usage
@@ -143,7 +143,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.13
 ```
 
 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-resource",
-  "version": "0.1.18-rc.11",
-  "generatedAt": "2026-09-01T17:39:40.763Z",
+  "version": "0.1.18-rc.13",
+  "generatedAt": "2026-09-10T18:54:42.497Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

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

@@ -8,19 +8,23 @@ user-invocable: false
 # @owlmeans/redis-resource
 
 **Layer:** Infra
-**Install:** `"@owlmeans/redis-resource": "^0.1.18-rc.11"` in `dependencies`
+**Install:** `"@owlmeans/redis-resource": "^0.1.18-rc.13"` in `dependencies`
 
 ## Key Exports
 
 | Export | Description |
 |--------|-------------|
 | `makeRedisResource<R>(alias, dbAlias?, serviceAlias?)` | Factory for a Redis-backed `Resource<R>`. Both alias defaults are `DEFAULT_DB_ALIAS` (`'redis'`) |
-| `RedisResource<R>` | `Resource<R>` plus the `PubSubResource`, `WatchableResource` and `StreamResource` capabilities, `db` and `key(id?)` |
-| `RedisDb`, `RedisClient`, `RedisDbService` | Types |
-| `DEFAULT_DB_ALIAS`, `DEFAULT_PAGE_SIZE`, `SCAN_BATCH`, `READ_BATCH`, `STREAM_MAX_LENGTH` | Constants |
+| `RedisResource<R>` | `Resource<R>` plus the `PubSubResource`, `WatchableResource` and `StreamResource` capabilities, `db`, `name` and `key(id?)` |
+| `RedisDb`, `RedisClient`, `RedisDbService`, `RedisConnection` | The db and connection contracts — `@owlmeans/redis` implements them |
+| `DEFAULT_DB_ALIAS`, `DEFAULT_PAGE_SIZE`, `SCAN_BATCH`, `READ_BATCH` | Constants for the record half |
+| `STREAM_MAX_LENGTH`, `DEFAULT_STREAM_BLOCK`, `RECLAIM_IDLE`, `RECLAIM_COUNT`, `CONSUMER_ID_LENGTH` | Constants for the stream half |
 
-Keys are namespaced by the db config's `schema` plus the resource alias:
-`resource.key(id)` → `<schema>-<alias>:<id>`.
+Keys are namespaced by the db config's key prefix plus the resource's name:
+`resource.key(id)` → `<prefix>-<name>:<id>`, and `key()` with no argument yields the namespace's
+glob. The name is `resource.name` when set and the registration alias otherwise, so two resources
+can share one namespace deliberately — and a `name` given by accident quietly merges two id spaces.
+Every non-word character in either half is collapsed to `_`.
 
 ## Usage
 
@@ -82,9 +86,11 @@ a renewal must pass a TTL again — otherwise the record becomes persistent.
   `UnknownRecordError` when the key is gone. Both use `GETDEL`, so two callers can never be handed
   the same record. Choose by whether absence is an error.
 - `create` generates an id when the record carries none, and refuses an id that is already there
-  (`RecordExists`) using `SET NX` — no read-then-write race.
-- `update` **replaces** the whole record and throws `UnknownRecordError` for an unknown id. It does
-  not merge over what was stored; pass every field that must survive.
+  (`RecordExists`) using `SET NX` — no read-then-write race. The id is written into the stored
+  record, so what comes back always carries one.
+- `update` **replaces** the whole record and throws `UnknownRecordError` for an unknown id (and
+  `MisshapedRecord` when the record carries no id at all). It does not merge over what was stored;
+  pass every field that must survive.
 - `save` creates when the record carries no id and replaces otherwise — that is the upsert.
 - `purge(where)` refuses an empty criteria object. Use it instead of a page loop that deletes each
   item.
@@ -93,20 +99,20 @@ a renewal must pass a TTL again — otherwise the record becomes persistent.
   namespace. `watch(id, handler, { once?, ttl? })` is the keyspace-notification form for ONE
   record — the handler receives the current value on every write, and `null` once the key is gone.
   They are separate methods; a channel is never passed as a bare string.
-- Keyspace notifications are bound to **db 0**, so deployments sharing one instance isolate on the
-  key prefix, not on the db index — and the server needs `notify-keyspace-events` enabled.
+- `watch` subscribes to `__keyspace@0__:`, while redis publishes keyspace events per database as
+  `__keyspace@<db>__:`. So a resource on a connection whose `meta.dbIndex` is anything but 0 gets
+  no notifications at all and its `watch` handler silently never fires — deployments sharing one
+  instance isolate on the key prefix, not on the db index. The server also needs
+  `notify-keyspace-events` enabled; it emits nothing otherwise.
 - `stream(key, value)` appends to a namespaced redis stream, trimmed approximately to
   `STREAM_MAX_LENGTH` so trimming stays cheap. `consume(key, { group?, consumer?, block? })` is the
   async generator that reads it — with no `group` it tails from now with `XREAD`, with one it joins
   the consumer group and reclaims stale entries under the **passed** consumer name. Claiming them
   for a fixed name leaves them owned by a consumer that never reads.
 - Requires redis 6.2 or newer (`GETDEL`).
-- Assert an expiry by reading `PTTL` back from redis, never by trusting that a command was issued —
-  the unit bug this contract had still "set an expiry", just one ~50 millennia away.
-
-## Depends On
-
-- `@owlmeans/redis`, `@owlmeans/resource`, `@owlmeans/server-context`, `@owlmeans/basic-ids`
+- Assert an expiry by reading `PTTL` back from redis, never by trusting that a command was issued.
+  An expiry set in the wrong unit is still an expiry — just one tens of millennia out — so only the
+  value redis reports back proves anything.
 
 ## Tests
 
@@ -115,3 +121,18 @@ this contract; putting them here would need a devDependency on this package's ow
 Gated on `REDIS_URL` (see `/.env.example`); each suite namespaces its keys and flushes them, and a
 spec that walks the namespace boots under its own resource alias so it never sees another test's
 records.
+
+## Depends On
+
+- `@owlmeans/resource` · `@owlmeans/context` · `@owlmeans/server-context` · `@owlmeans/basic-ids`
+- peer `ioredis` (the client types every method is written against), `ajv`
+
+`@owlmeans/redis` is NOT a dependency — it depends on this package, and that is the direction the
+connection contracts flow in.
+
+## Related
+
+- `redis` — the connection service implementing `RedisDbService`, and the `cfg.dbs` entry a
+  resource takes its prefix and db index from
+- `redis-queue` — BullMQ queues on the same connections
+- `resource` — the criteria language, paging and the error classes raised here

package/build/resource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../src/resource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACuC,cAAc,EAEhE,MAAM,oBAAoB,CAAA;AAK3B,OAAO,KAAK,EAA+B,aAAa,EAAE,MAAM,YAAY,CAAA;AAY5E;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,GAC5B,CAAC,SAAS,cAAc,EAAE,CAAC,SAAS,aAAa,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,EAEvE,OAAO,MAAM,EAAE,gBAA0B,EAAE,qBAA+B,KACzE,CAmZF,CAAA"}
+{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../src/resource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACuC,cAAc,EAEhE,MAAM,oBAAoB,CAAA;AAK3B,OAAO,KAAK,EAA+B,aAAa,EAAE,MAAM,YAAY,CAAA;AAY5E;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,GAC5B,CAAC,SAAS,cAAc,EAAE,CAAC,SAAS,aAAa,CAAC,CAAC,CAAC,4BAE7C,MAAM,8CACZ,CAmZF,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/redis-resource",
-  "version": "0.1.18-rc.11",
+  "version": "0.1.18-rc.13",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -25,10 +25,10 @@
     "ioredis": "*"
   },
   "dependencies": {
-    "@owlmeans/basic-ids": "^0.1.18-rc.8",
-    "@owlmeans/context": "^0.1.18-rc.7",
-    "@owlmeans/resource": "^0.1.18-rc.8",
-    "@owlmeans/server-context": "^0.1.18-rc.11"
+    "@owlmeans/basic-ids": "^0.1.18-rc.10",
+    "@owlmeans/context": "^0.1.18-rc.9",
+    "@owlmeans/resource": "^0.1.18-rc.10",
+    "@owlmeans/server-context": "^0.1.18-rc.13"
   },
   "devDependencies": {
     "@owlmeans/dep-config": "workspace:*",