@owlmeans/client-resource 0.1.18-rc.12 → 0.1.18-rc.14

package/README.md

@@ -12,7 +12,7 @@ Client-side resource persistence layer — browser key-value storage backed reso
 ## Installation
 
 ```bash
-bun add @owlmeans/client-resource
+bun add @owlmeans/client-resource@^0.1.18-rc.12
 ```
 
 ## Usage
@@ -80,7 +80,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/client-resource",
-  "version": "0.1.18-rc.12",
-  "generatedAt": "2026-09-01T17:39:40.765Z",
+  "version": "0.1.18-rc.14",
+  "generatedAt": "2026-09-10T18:54:42.501Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

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

@@ -8,7 +8,7 @@ user-invocable: false
 # @owlmeans/client-resource
 
 **Layer:** Client
-**Install:** `"@owlmeans/client-resource": "^0.1.18-rc.12"` in `dependencies`
+**Install:** `"@owlmeans/client-resource": "^0.1.18-rc.14"` in `dependencies`
 
 ## Key Exports
 
@@ -27,12 +27,22 @@ import { appendClientResource } from '@owlmeans/client-resource'
 appendClientResource<Config, Context, Project>(context, 'projects')
 
 const projects = context.resource<ClientResource<Project>>('projects')
-await projects.list({ status: ['open', 'blocked'] }, { sort: ['createdAt'] })
+const { items, total } = await projects.list({ status: ['open', 'blocked'] }, { sort: ['createdAt'] })
 ```
 
-The backing store comes from `cfg.dbs` — the entry whose `alias` matches the resource's, with
-`schema` naming the store (`@owlmeans/web-db` supplies the browser one). Without an entry the
-resource falls back to the default `client-db` service under its own alias.
+The backing store comes from `cfg.dbs` — the `DbConfig` entry whose `alias` equals the resource's.
+`service` is the field that selects the backend: it names the `ClientDbService` to ask, and it is
+required by the type, as is `host`, which nothing on this path reads. `schema` names the store
+inside that service and defaults to the resource alias. So an entry is
+`{ alias: 'projects', service: MY_DB, host: [], schema? }`.
+
+With no matching entry the resource asks `DEFAULT_DB_ALIAS` (`client-db`) for a store named after
+itself — which is why a single-backend app (`@owlmeans/web-db` registered under that alias) writes
+no `dbs` entries at all, and a second backend is chosen by adding one that names another service.
+
+That binding happens in `init()`, which the context runs while it initializes. Every operation
+before it throws `ResourceError('nodb-client-resource:<alias>')` — read that as "this resource was
+used before its context was ready", not as a storage failure.
 
 ## A key-value store dressed as a resource
 
@@ -43,17 +53,23 @@ is. So:
 - `load(where)`, `get(where)`, `list`, `count` and `purge` read the whole set and evaluate through
   the shared in-memory engine from `@owlmeans/resource`, which is what makes a criteria object mean
   here exactly what it means against a relational store. `{ sort }` orders the result the same way.
-- **Unpaged**: `list(where)` with no `size` returns every match; `size: 0` says the same thing
-  explicitly, and `page` without `size` throws `UnsupportedArgumentError('page-without-size')`.
-- `create` mints an id when the record carries none and throws `RecordExists` for one already
-  stored; `update` **replaces** the whole record and throws `UnknownRecordError` for an unknown id;
-  `save` creates or replaces. `take(id)` **deletes** the record it returns.
+- `list` answers with the shared `ListResult` — `{ items, total }`, and `page` / `size` echoed back
+  as well when a size was asked for. **Unpaged by default**: no `size` (or `size: 0`) returns every
+  match, and `page` without `size` throws `UnsupportedArgumentError('page-without-size')`. The
+  contract is the one every store shares — [[resource]].
+- `create` mints a base58 id when the record carries none and throws `RecordExists` for one already
+  stored; `update` **replaces** the whole record, throwing `MisshapedRecord('id')` for a record that
+  carries no id and `UnknownRecordError` for an id the store does not hold; `save` creates when
+  there is no id or no stored record and replaces otherwise. `take(id)` **deletes** the record it
+  returns.
 - `purge(where)` refuses an empty criteria object. `erase()` empties the store, index included.
 
 ## Depends On
 
-- `@owlmeans/resource`, `@owlmeans/client-context`, `@scure/base`, `@noble/hashes`
+- `@owlmeans/resource` (the shared criteria engine), `@owlmeans/client-context`, `@owlmeans/context`
+- `@scure/base`, `@noble/hashes` — the base58 id minted for a record that arrives without one
 
 ## Related
 
+- [[resource]] — the criteria engine, `ListResult` and the shared resource contract
 - [[web-db]] — the browser IndexedDB backend behind `ClientDbService`

package/build/resource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../src/resource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAM3E,OAAO,KAAK,EAAuC,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAM7F,KAAK,MAAM,GAAG,YAAY,CAAA;AAC1B,UAAU,OAAO,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAE,SAAQ,aAAa,CAAC,CAAC,CAAC;CAAI;AAEzE;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAC/B,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,cAAc,GAAG,cAAc,EACjF,SAAS,CAAC,EAAE,OAAO,MAAM,KAAG,CAuJ7B,CAAA"}
+{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../src/resource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAM3E,OAAO,KAAK,EAAuC,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAM7F,KAAK,MAAM,GAAG,YAAY,CAAA;AAC1B,UAAU,OAAO,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAE,SAAQ,aAAa,CAAC,CAAC,CAAC;CAAI;AAEzE;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAC/B,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,cAAc,GAAG,cAAc,WACxE,CAAC,SAAS,MAAM,KAAG,CAuJ7B,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/client-resource",
-  "version": "0.1.18-rc.12",
+  "version": "0.1.18-rc.14",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -22,9 +22,9 @@
   },
   "dependencies": {
     "@noble/hashes": "^1.5.0",
-    "@owlmeans/client-context": "^0.1.18-rc.12",
-    "@owlmeans/context": "^0.1.18-rc.7",
-    "@owlmeans/resource": "^0.1.18-rc.8",
+    "@owlmeans/client-context": "^0.1.18-rc.14",
+    "@owlmeans/context": "^0.1.18-rc.9",
+    "@owlmeans/resource": "^0.1.18-rc.10",
     "@scure/base": "^2.3.0"
   },
   "devDependencies": {