@owlmeans/client-context 0.1.18-rc.1 → 0.1.18-rc.11

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.11",
+  "generatedAt": "2026-09-01T16:28:56.995Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

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

@@ -8,24 +8,22 @@ 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.11"` 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`
+| `ClientContext<C>` | Client Context interface — adds `serviceRoute(alias)` |
+| `ClientConfig`, `config()` | Client config shape and its factory |
+| `PLUGINS` | Alias of the plugins config resource |
 
 ## Usage
 
-Most apps don't call this directly — `@owlmeans/web-panel` and native equivalents wrap it.
+Most apps don't call this directly — `@owlmeans/web-panel` and native equivalents wrap it. A wrapper
+calls it once, applies its own idempotent `append*(context)` mixins, and returns that same context:
+one context per process, built by one factory.
 
 ```typescript
 import { makeClientContext } from '@owlmeans/client-context'

package/build/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,eAAO,MAAM,MAAM,GAAI,CAAC,SAAS,YAAY,WAAW,MAAM,QAAQ,OAAO,CAAC,CAAC,CAAC,KAAG,CAIlF,CAAA"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,eAAO,MAAM,MAAM,GAAI,CAAC,SAAS,YAAY,EAAE,SAAS,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KAAG,CAIlF,CAAA"}

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,EAAE,KAAK,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.1",
+  "version": "0.1.18-rc.11",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -28,12 +28,12 @@
     }
   },
   "dependencies": {
-    "@owlmeans/api": "^0.1.18-rc.1",
-    "@owlmeans/client-config": "^0.1.18-rc.1",
-    "@owlmeans/config": "^0.1.18-rc.1",
-    "@owlmeans/context": "^0.1.18-rc.1",
-    "@owlmeans/i18n": "^0.1.18-rc.1",
-    "@owlmeans/route": "^0.1.18-rc.1"
+    "@owlmeans/api": "^0.1.18-rc.11",
+    "@owlmeans/client-config": "^0.1.18-rc.10",
+    "@owlmeans/config": "^0.1.18-rc.10",
+    "@owlmeans/context": "^0.1.18-rc.7",
+    "@owlmeans/i18n": "^0.1.18-rc.7",
+    "@owlmeans/route": "^0.1.18-rc.7"
   },
   "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
 }