@owlmeans/client-context 0.1.18-rc.2 → 0.1.18-rc.20

package/README.md

@@ -12,7 +12,7 @@ Client-side context factory extending `BasicContext` with API client and service
 ## Installation
 
 ```bash
-bun add @owlmeans/client-context
+bun add @owlmeans/client-context@^0.1.18-rc.12
 ```
 
 ## Usage
@@ -57,7 +57,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.19
 ```
 
 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-context",
-  "version": "0.1.18-rc.0",
-  "generatedAt": "2026-08-16T22:20:50.514Z",
+  "version": "0.1.18-rc.20",
+  "generatedAt": "2026-09-12T13:51:53.541Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

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

@@ -1,6 +1,6 @@
 ---
 name: client-context
-description: How to use @owlmeans/client-context — client-side context factory used as the base for web and native contexts. Auto-invoked when importing client context primitives.
+description: How to use @owlmeans/client-context — makeClientContext(), the ClientConfig shape, config() and serviceRoute(alias, makeDefault?) — the platform-agnostic client context every web and native context is built from. Auto-invoked when building a client context, declaring a client config, or resolving a service route on the client.
 user-invocable: false
 ---
 <!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
@@ -8,30 +8,60 @@ user-invocable: false
 # @owlmeans/client-context
 
 **Layer:** Client
-**Install:** `"@owlmeans/client-context": "^0.1.18-rc.0"` in `dependencies`
+**Install:** `"@owlmeans/client-context": "^0.1.18-rc.20"` in `dependencies`
 
 ## Key Exports
 
 | Export | Description |
 |--------|-------------|
-| `makeClientContext` | Client-side context factory (cross-platform) |
-| `Context` (client) types | Client Context interface |
-| `Config` (client) types | Client config shape |
-| Constants | Default aliases |
-
-## Subpath Exports
-
-- `./utils`
+| `makeClientContext(cfg)` | The base client context factory — a basic context plus `serviceRoute` and a registered API client |
+| `ClientContext<C>` | The context interface — `BasicContext` + `ConfigResourceAppend` + `serviceRoute(alias, makeDefault?)` |
+| `ClientConfig` | `BasicClientConfig` + `services` (the service-route table) + optional `i18n` |
+| `config(service, cfg?)` | Build a `ClientConfig` for `service` with `AppType.Frontend` already set |
+| `PLUGINS` (`plugins`) | Alias of the second config resource, the one plugin records live in |
 
 ## Usage
 
-Most apps don't call this directly — `@owlmeans/web-panel` and native equivalents wrap it.
+Most apps never call this directly — `@owlmeans/client` wraps it (adding state, modal, debug and
+the router accessor), and `@owlmeans/web-client`, `@owlmeans/web-panel` and their native
+counterparts wrap that. A wrapper calls the layer below once, applies its own idempotent
+`append*(context)` mixins, and returns the same context: one context per process, built by one
+factory.
 
 ```typescript
-import { makeClientContext } from '@owlmeans/client-context'
+import { makeClientContext, config } from '@owlmeans/client-context'
+
+const cfg = config<Config>(MY_APP, { services: { ... } })
 const context = makeClientContext<Config, Context>(cfg)
 ```
 
+`makeClientContext` appends the API client (`appendApiClient`) itself, so an entrypoint can make a
+call as soon as the context is configured — nothing else has to register a carrier. Which carrier a
+given call uses is `cfg.webService`, from `@owlmeans/client-config`.
+
+## Service routes
+
+```typescript
+const route = context.serviceRoute(MANAGER, true)   // and mark it the default one
+```
+
+`serviceRoute` reads `cfg.services[alias]` and, with a boolean second argument, sets that route's
+`default` flag — which is how an app says "unqualified addresses belong to this service". It
+returns the live route object, so the flag is set on the config the rest of the context reads.
+
+An unknown alias throws a `SyntaxError` that **names every registered service**. Expect to see it
+during import, with a blank page and a stack pointing into the framework; the usual cause is a
+route alias passed where a service alias belongs, since both are plain strings and nothing earlier
+objects.
+
 ## Depends On
 
-- `@owlmeans/context`, `@owlmeans/client-config`, `@owlmeans/client-entrypoint`, `@owlmeans/client-route`
+- `@owlmeans/context` — `makeBasicContext`, `AppType`, `makeBasicConfig`
+- `@owlmeans/client-config` — `BasicClientConfig`
+- `@owlmeans/api` — the API client appended into every client context
+- `@owlmeans/route` (`CommonServiceRoute`), `@owlmeans/i18n`, `@owlmeans/config`
+
+## Related
+
+- [[client]] — the React layer, whose own `makeClientContext` builds on this one
+- [[client-config]] — `webService` and the rest of the base client config

package/build/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAG7D,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,YAAY,EAAE,CAAC,SAAS,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,KAAG,CAqB9F,CAAA"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAG7D,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,YAAY,EAAE,CAAC,SAAS,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,KAAG,CAmC9F,CAAA"}

package/build/context.js

@@ -5,7 +5,20 @@ export const makeClientContext = (cfg) => {
     context.serviceRoute = (alias, makeDefault) => {
         const service = context.cfg.services[alias];
         if (service == null) {
-            throw new SyntaxError(`Service not found ${alias}`);
+            /**
+             * The alternatives belong in the message, not in a debugger session.
+             *
+             * This throws at module scope, during import, so the app is blank and the stack points at
+             * a framework file — there is nowhere for a reader to look up what WAS registered. And
+             * the mistake it reports is almost always one specific confusion: a route alias passed
+             * where a service alias belongs. Both are strings, so nothing before this point objects.
+             *
+             * `?? {}` because `services` is optional on the config — an error must never be replaced
+             * by a worse one thrown while describing it.
+             */
+            const registered = Object.keys(context.cfg.services ?? {});
+            throw new SyntaxError(`Service not found ${alias}. Registered services: `
+                + (registered.length > 0 ? registered.join(', ') : '(none)'));
         }
         if (typeof makeDefault === 'boolean') {
             service.default = makeDefault;
@@ -13,7 +26,6 @@ export const makeClientContext = (cfg) => {
         return service;
     };
     appendApiClient(context);
-    context.makeContext = makeClientContext;
     return context;
 };
 //# sourceMappingURL=context.js.map

package/build/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAEpD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAE/C,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAqD,GAAM,EAAK,EAAE;IACjG,MAAM,OAAO,GAAG,gBAAgB,CAAC,GAAG,CAAM,CAAA;IAE1C,OAAO,CAAC,YAAY,GAAG,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE;QAC5C,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;QAC3C,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;YACpB,MAAM,IAAI,WAAW,CAAC,qBAAqB,KAAK,EAAE,CAAC,CAAA;QACrD,CAAC;QAED,IAAI,OAAO,WAAW,KAAK,SAAS,EAAE,CAAC;YACrC,OAAO,CAAC,OAAO,GAAG,WAAW,CAAA;QAC/B,CAAC;QAED,OAAO,OAAO,CAAA;IAChB,CAAC,CAAA;IAED,eAAe,CAAO,OAAO,CAAC,CAAA;IAE9B,OAAO,CAAC,WAAW,GAAG,iBAA+C,CAAA;IAErE,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA"}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAEpD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAE/C,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAqD,GAAM,EAAK,EAAE;IACjG,MAAM,OAAO,GAAG,gBAAgB,CAAC,GAAG,CAAM,CAAA;IAE1C,OAAO,CAAC,YAAY,GAAG,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE;QAC5C,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;QAC3C,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;YACpB;;;;;;;;;;eAUG;YACH,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAA;YAE1D,MAAM,IAAI,WAAW,CACnB,qBAAqB,KAAK,yBAAyB;kBACjD,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAC7D,CAAA;QACH,CAAC;QAED,IAAI,OAAO,WAAW,KAAK,SAAS,EAAE,CAAC;YACrC,OAAO,CAAC,OAAO,GAAG,WAAW,CAAA;QAC/B,CAAC;QAED,OAAO,OAAO,CAAA;IAChB,CAAC,CAAA;IAED,eAAe,CAAO,OAAO,CAAC,CAAA;IAE9B,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/client-context",
-  "version": "0.1.18-rc.2",
+  "version": "0.1.18-rc.20",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -28,12 +28,12 @@
     }
   },
   "dependencies": {
-    "@owlmeans/api": "^0.1.18-rc.2",
-    "@owlmeans/client-config": "^0.1.18-rc.2",
-    "@owlmeans/config": "^0.1.18-rc.2",
-    "@owlmeans/context": "^0.1.18-rc.2",
-    "@owlmeans/i18n": "^0.1.18-rc.2",
-    "@owlmeans/route": "^0.1.18-rc.2"
+    "@owlmeans/api": "^0.1.18-rc.20",
+    "@owlmeans/client-config": "^0.1.18-rc.19",
+    "@owlmeans/config": "^0.1.18-rc.19",
+    "@owlmeans/context": "^0.1.18-rc.15",
+    "@owlmeans/i18n": "^0.1.18-rc.15",
+    "@owlmeans/route": "^0.1.18-rc.16"
   },
   "devDependencies": {
     "@owlmeans/dep-config": "workspace:*",

package/src/context.ts

@@ -8,7 +8,23 @@ export const makeClientContext = <C extends ClientConfig, T extends ClientContex
   context.serviceRoute = (alias, makeDefault) => {
     const service = context.cfg.services[alias]
     if (service == null) {
-      throw new SyntaxError(`Service not found ${alias}`)
+      /**
+       * The alternatives belong in the message, not in a debugger session.
+       *
+       * This throws at module scope, during import, so the app is blank and the stack points at
+       * a framework file — there is nowhere for a reader to look up what WAS registered. And
+       * the mistake it reports is almost always one specific confusion: a route alias passed
+       * where a service alias belongs. Both are strings, so nothing before this point objects.
+       *
+       * `?? {}` because `services` is optional on the config — an error must never be replaced
+       * by a worse one thrown while describing it.
+       */
+      const registered = Object.keys(context.cfg.services ?? {})
+
+      throw new SyntaxError(
+        `Service not found ${alias}. Registered services: `
+        + (registered.length > 0 ? registered.join(', ') : '(none)')
+      )
     }
 
     if (typeof makeDefault === 'boolean') {
@@ -20,7 +36,5 @@ export const makeClientContext = <C extends ClientConfig, T extends ClientContex
 
   appendApiClient<C, T>(context)
 
-  context.makeContext = makeClientContext as typeof context.makeContext
-
   return context
 }