@owlmeans/api-config-client 0.1.18-rc.3 → 0.1.18-rc.31

package/README.md

@@ -5,13 +5,13 @@ Client-side middleware that fetches server config from `GET /assets/config.json`
 ## Overview
 
 - `apiConfigMiddleware` — context middleware that calls the config endpoint on startup
-- Elevates `@owlmeans/api-config` modules into the client module system
+- Binds the `@owlmeans/api-config` `advertise` protocol into the client entrypoint system
 - Merges the server `ApiConfig` into the client's `CommonConfig` at initialization time
 
 ## Installation
 
 ```bash
-bun add @owlmeans/api-config-client
+bun add @owlmeans/api-config-client@^0.1.18-rc.31
 ```
 
 ## Usage
@@ -24,13 +24,16 @@ import { apiConfigMiddleware } from '@owlmeans/api-config-client'
 context.registerMiddleware(apiConfigMiddleware)
 ```
 
-On initialization, the middleware calls the `API_CONFIG` module and merges the response into the context config.
+On initialization, the middleware calls the bound `advertise` protocol and merges the response into
+the context config. If this package's local `entrypoints` bindings are not registered, initialization
+fails rather than silently falling back to alias-based calls.
 
 ## API
 
 ### `apiConfigMiddleware: Middleware`
 
-A context initialization middleware. Calls `API_CONFIG` module, receives `ApiConfig`, and applies it to the context via `mergeConfig`.
+A context initialization middleware. Calls the `advertise` protocol, receives `ApiConfig`, and
+applies it to the context via `mergeConfig`.
 
 ## Related Packages
 
@@ -45,7 +48,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.33
 ```
 
 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/api-config-client",
-  "version": "0.1.18-rc.0",
-  "generatedAt": "2026-08-16T22:20:50.510Z",
+  "version": "0.1.18-rc.31",
+  "generatedAt": "2026-09-22T17:37:10.920Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

package/agent-meta/skills/api-config-client/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: api-config-client
-description: How to use @owlmeans/api-config-client — client-side middleware and modules for fetching the API config served by api-config-server. Auto-invoked when wiring runtime API config into a client app.
+description: How to use @owlmeans/api-config-client — the browser half of the runtime config flow, a loading-stage middleware that fetches the config a backend advertises and merges it into the client config. Auto-invoked when wiring runtime API config into a client app or debugging a client that boots with an incomplete config.
 user-invocable: false
 ---
 <!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
@@ -8,22 +8,71 @@ user-invocable: false
 # @owlmeans/api-config-client
 
 **Layer:** Client
-**Install:** `"@owlmeans/api-config-client": "^0.1.18-rc.0"` in `dependencies`
+**Install:** `"@owlmeans/api-config-client": "^0.1.18-rc.31"` in `dependencies`
+
+Consumes the declaration shared by `@owlmeans/api-config` and answered by
+`@owlmeans/api-config-server`.
 
 ## Key Exports
 
 | Export | Description |
 |--------|-------------|
-| `apiConfigMiddleware` | Middleware to fetch and apply remote API config at startup |
-| `modules` | Client-side api-config module declarations |
+| `apiConfigMiddleware` | Context middleware, `Loading` stage — fetches the advertised config and merges it into `context.cfg` |
+| `entrypoints` | The `API_CONFIG` protocol bound for client use, so the middleware can call it |
 
 ## Usage
 
+Both halves are needed: the middleware does the work, the entrypoint is what it calls.
+
 ```typescript
-import { modules as apiConfigClientModules } from '@owlmeans/api-config-client'
-context.registerEntrypoints([...apiConfigClientModules, ...appModules])
+import { apiConfigMiddleware, entrypoints as apiConfigBindings } from '@owlmeans/api-config-client'
+
+export const makeContext = <C extends AppConfig, T extends AppContext<C>>(cfg: C): T => {
+  const context = makeClientContext(cfg) as T
+  context.registerMiddleware(apiConfigMiddleware)
+  return context
+}
+
+export const clientBindings = [...apiConfigBindings, ...myClientBindings]
 ```
 
+A panel app on `@owlmeans/web-panel` or `@owlmeans/mui-panel` already registers both — do it again
+only in a context built from a lower layer.
+
+## What the middleware does
+
+It runs once during `init()`, as a `Context`/`Loading` middleware — after every service and
+resource has initialized and just before the context is marked ready. So the merged values are
+there for anything that reads `cfg` at request or render time, but **not** for a value a service
+captured while initializing: that one still holds what the bundle shipped.
+
+- **Both halves, or the boot dies.** The middleware resolves `API_CONFIG` against the context
+  before it tests anything else, so a context that registers `apiConfigMiddleware` without also
+  registering local `entrypoints` bindings fails `init()` with `SyntaxError: Entrypoint api-config:advertise not
+  found`. That failure is outside the swallowing below — it is a hard boot error, not a missing
+  value discovered later.
+- **It is a no-op unless `cfg.primaryHost` is set.** A build without it keeps whatever the bundle
+  was compiled with, silently. That is the first thing to check when a client boots with a config
+  the backend does not agree with.
+- `cfg.primaryHost` (and `cfg.primaryPort`, when given) are written onto the entrypoint's route
+  before the call, so the config is fetched from the primary backend rather than from wherever the
+  entrypoint would otherwise resolve.
+- The answer is merged into `context.cfg` in place by `mergeConfig` from `@owlmeans/config`:
+  objects are merged key by key, two arrays are **appended**, and the server's value replaces the
+  built-in one only where that built-in is a scalar, `null` or absent. Where the built-in is an
+  object or an array and the server sends a scalar, the merge recurses into that pair, matches
+  neither branch and returns the built-in untouched — **the server's value is silently dropped**.
+  An array the bundle already carries therefore grows on every merge, and can be neither replaced
+  nor emptied from the server.
+- A failed **fetch** is logged and swallowed — only the call and the merge are inside the
+  try/catch. The app continues on its built-in config, so a misconfigured or unreachable primary
+  host shows up as missing values later, never as a boot error.
+
 ## Depends On
 
-- `@owlmeans/api-config`, `@owlmeans/client-entrypoint`, `@owlmeans/client-context`
+Declared: `@owlmeans/api-config`, `@owlmeans/client-entrypoint`, `@owlmeans/client-context`,
+`@owlmeans/context`.
+
+Imported but **not** declared in this package's manifest: `@owlmeans/config` (`mergeConfig`, which
+does the merging described above). A workspace resolves it anyway; a standalone install has to name
+it in its own dependencies.

package/build/entrypoints.d.ts

@@ -0,0 +1,3 @@
+/** The browser-local binding of the shared runtime-config protocol. */
+export declare const entrypoints: import("@owlmeans/client-entrypoint").ClientProtocolEntrypoint<import("@owlmeans/entrypoint").EntrypointProtocol<import("@owlmeans/entrypoint").OpenRequest, import("@owlmeans/entrypoint").OpenValue>>[];
+//# sourceMappingURL=entrypoints.d.ts.map

package/build/entrypoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entrypoints.d.ts","sourceRoot":"","sources":["../src/entrypoints.ts"],"names":[],"mappings":"AAIA,uEAAuE;AACvE,eAAO,MAAM,WAAW,2MAAoB,CAAA"}

package/build/entrypoints.js

@@ -0,0 +1,5 @@
+import { advertise } from '@owlmeans/api-config';
+import { bind } from '@owlmeans/client-entrypoint';
+/** The browser-local binding of the shared runtime-config protocol. */
+export const entrypoints = [bind(advertise)];
+//# sourceMappingURL=entrypoints.js.map

package/build/entrypoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entrypoints.js","sourceRoot":"","sources":["../src/entrypoints.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAA;AAElD,uEAAuE;AACvE,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAA"}

package/build/index.d.ts

@@ -1,3 +1,3 @@
 export * from './middleware.js';
-export * from './modules.js';
+export * from './entrypoints.js';
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA"}

package/build/index.js

@@ -1,3 +1,3 @@
 export * from './middleware.js';
-export * from './modules.js';
+export * from './entrypoints.js';
 //# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA"}

package/build/middleware.js

@@ -13,7 +13,7 @@ export const apiConfigMiddleware = {
                 module.route.route.port = context.cfg.primaryPort;
             }
             try {
-                const [config] = await module.call();
+                const config = await module.call();
                 const target = context.cfg;
                 mergeConfig(target, config);
             }

package/build/middleware.js.map

@@ -1 +1 @@
-{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../src/middleware.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAGlF,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAI9C,MAAM,CAAC,MAAM,mBAAmB,GAAe;IAC7C,IAAI,EAAE,cAAc,CAAC,OAAO;IAC5B,KAAK,EAAE,eAAe,CAAC,OAAO;IAC9B,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QACnB,MAAM,OAAO,GAAG,aAAa,CAC3B,GAAU,EAAE,uBAAuB,CACpC,CAAA;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAA8B,UAAU,CAAC,CAAA;QAC1E,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,IAAI,EAAE,CAAC;YACpC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAA;YACjD,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,IAAI,EAAE,CAAC;gBACpC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAA;YACnD,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAA;gBACpC,MAAM,MAAM,GAAiB,OAAO,CAAC,GAA8B,CAAA;gBACnE,WAAW,CAAC,MAAM,EAAE,MAAsB,CAAC,CAAA;YAC7C,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;YAClB,CAAC;QACH,CAAC;IACH,CAAC;CACF,CAAA"}
+{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../src/middleware.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAGlF,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAI9C,MAAM,CAAC,MAAM,mBAAmB,GAAe;IAC7C,IAAI,EAAE,cAAc,CAAC,OAAO;IAC5B,KAAK,EAAE,eAAe,CAAC,OAAO;IAC9B,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QACnB,MAAM,OAAO,GAAG,aAAa,CAC3B,GAAU,EAAE,uBAAuB,CACpC,CAAA;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAA8B,UAAU,CAAC,CAAA;QAC1E,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,IAAI,EAAE,CAAC;YACpC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAA;YACjD,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,IAAI,EAAE,CAAC;gBACpC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAA;YACnD,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAA;gBAClC,MAAM,MAAM,GAAiB,OAAO,CAAC,GAA8B,CAAA;gBACnE,WAAW,CAAC,MAAM,EAAE,MAAsB,CAAC,CAAA;YAC7C,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;YAClB,CAAC;QACH,CAAC;IACH,CAAC;CACF,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/api-config-client",
-  "version": "0.1.18-rc.3",
+  "version": "0.1.18-rc.31",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -21,10 +21,10 @@
     }
   },
   "dependencies": {
-    "@owlmeans/api-config": "^0.1.18-rc.3",
-    "@owlmeans/client-context": "^0.1.18-rc.3",
-    "@owlmeans/client-entrypoint": "^0.1.18-rc.3",
-    "@owlmeans/context": "^0.1.18-rc.3"
+    "@owlmeans/api-config": "^0.1.18-rc.32",
+    "@owlmeans/client-context": "^0.1.18-rc.34",
+    "@owlmeans/client-entrypoint": "^0.1.18-rc.33",
+    "@owlmeans/context": "^0.1.18-rc.29"
   },
   "devDependencies": {
     "@owlmeans/dep-config": "workspace:*",

package/src/entrypoints.ts

@@ -0,0 +1,6 @@
+
+import { advertise } from '@owlmeans/api-config'
+import { bind } from '@owlmeans/client-entrypoint'
+
+/** The browser-local binding of the shared runtime-config protocol. */
+export const entrypoints = [bind(advertise)]

package/src/index.ts

@@ -1,3 +1,3 @@
 
 export * from './middleware.js'
-export * from './modules.js'
+export * from './entrypoints.js'

package/src/middleware.ts

@@ -21,7 +21,7 @@ export const apiConfigMiddleware: Middleware = {
         module.route.route.port = context.cfg.primaryPort
       }
       try {
-        const [config] = await module.call()
+        const config = await module.call()
         const target: CommonConfig = context.cfg as unknown as CommonConfig
         mergeConfig(target, config as CommonConfig)
       } catch (e) { 

package/build/modules.d.ts

@@ -1,2 +0,0 @@
-export declare const modules: import("@owlmeans/entrypoint").CommonEntrypoint[];
-//# sourceMappingURL=modules.d.ts.map

package/build/modules.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"modules.d.ts","sourceRoot":"","sources":["../src/modules.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,OAAO,mDAAS,CAAA"}

package/build/modules.js

@@ -1,5 +0,0 @@
-import { modules as config, API_CONFIG } from '@owlmeans/api-config';
-import { elevate } from '@owlmeans/client-entrypoint';
-elevate(config, API_CONFIG);
-export const modules = config;
-//# sourceMappingURL=modules.js.map

package/build/modules.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"modules.js","sourceRoot":"","sources":["../src/modules.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACpE,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAA;AAErD,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;AAE3B,MAAM,CAAC,MAAM,OAAO,GAAG,MAAM,CAAA"}

package/src/modules.ts

@@ -1,7 +0,0 @@
-
-import { modules as config, API_CONFIG } from '@owlmeans/api-config'
-import { elevate } from '@owlmeans/client-entrypoint'
-
-elevate(config, API_CONFIG)
-
-export const modules = config