@owlmeans/api-config 0.1.18-rc.20 → 0.1.18-rc.22

package/README.md

@@ -1,10 +1,10 @@
 # @owlmeans/api-config
 
-Shared entrypoint for advertising safe config values from server to client via a REST endpoint.
+Shared protocol for advertising safe config values from server to client via a REST endpoint.
 
 ## Overview
 
-- Exposes a `GET /assets/config.json` entrypoint that returns package-allowlisted config fields
+- Exposes the `advertise` protocol for `GET /assets/config.json`, returning package-allowlisted config fields
 - `ApiConfig` — the advertised config type (subset of `CommonConfig`)
 - `API_CONFIG` — entrypoint alias for the config endpoint
 - `apiConfigPlugin` / `every` — import-time allowlist helpers for package-owned client config
@@ -12,16 +12,20 @@ Shared entrypoint for advertising safe config values from server to client via a
 ## Installation
 
 ```bash
-bun add @owlmeans/api-config@^0.1.18-rc.11
+bun add @owlmeans/api-config@^0.1.18-rc.21
 ```
 
 ## Usage
 
-Use with server and client counterparts — this package provides the shared types and entrypoint alias:
+Use with server and client counterparts — this package provides the shared protocol, types, and
+private adapter alias:
 
 ```typescript
-import { API_CONFIG } from '@owlmeans/api-config'
+import { advertise } from '@owlmeans/api-config'
 import type { ApiConfig } from '@owlmeans/api-config'
+
+// Bind this exact declaration in the server and browser packages.
+context.entrypoint(advertise)
 ```
 
 ## API
@@ -33,7 +37,13 @@ server values — including databases, queues and secrets — are never returned
 
 ### `API_CONFIG`
 
-Entrypoint alias `'api-config:advertise'` used to register/call the config endpoint.
+Internal adapter alias `'api-config:advertise'`. Application code imports `advertise` instead of
+looking the protocol up by this string.
+
+### `advertise`
+
+The immutable, sticky protocol for `GET /assets/config.json`. It is the only shared declaration;
+`@owlmeans/api-config-server` and `@owlmeans/api-config-client` each export local bindings for it.
 
 ### `apiConfigPlugin`
 
@@ -51,10 +61,6 @@ apiConfigPlugin({
 The `deny` selector removes nested values after the allowlist selection. Prefer a precise nested
 allowlist to `true`; `true` is appropriate only for data that is public at every depth.
 
-### `entrypoints`
-
-Array of route definitions for the config advertisement endpoint.
-
 ## Related Packages
 
 - [`@owlmeans/api-config-server`](../api-config-server) — server-side entrypoint that serves the config
@@ -68,7 +74,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@^0.1.18-rc.20
+npx @owlmeans/agent-skills@^0.1.18-rc.22
 ```
 
 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",
-  "version": "0.1.18-rc.20",
-  "generatedAt": "2026-09-12T14:18:54.797Z",
+  "version": "0.1.18-rc.22",
+  "generatedAt": "2026-09-15T12:38:15.233Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

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

@@ -8,7 +8,7 @@ user-invocable: false
 # @owlmeans/api-config
 
 **Layer:** Core
-**Install:** `"@owlmeans/api-config": "^0.1.18-rc.20"` in `dependencies`
+**Install:** `"@owlmeans/api-config": "^0.1.18-rc.22"` in `dependencies`
 
 The contract package of a three-package flow: this one declares the endpoint and what may cross it,
 `@owlmeans/api-config-server` answers it, `@owlmeans/api-config-client` fetches it and merges the
@@ -18,8 +18,8 @@ answer into the client config. Nothing here runs — it is the shared declaratio
 
 | Export | Description |
 |--------|-------------|
-| `entrypoints` | The single declaration — alias `API_CONFIG`, route `/assets/config.json`, `sticky: true` so a router attaches it unconditionally |
-| `apiConfigEntrypoints.config` | The shared `api-config:advertise` protocol both sides bind |
+| `advertise` | The single immutable declaration — route `/assets/config.json`, `sticky: true` so a router attaches it unconditionally |
+| `API_CONFIG` | Internal adapter alias for `advertise`; do not use it for ordinary application lookup |
 | `apiConfigPlugin(plugin)` | Registers one package's public config selection as its module loads |
 | `every(selection, where?)` | Applies a selection to every list item or object-map value, optionally filtering items |
 | `ApiConfigPlugin` | `{ allow, deny? }` — nested allowlist with an optional nested redaction selector |
@@ -29,11 +29,13 @@ answer into the client config. Nothing here runs — it is the shared declaratio
 ## Usage
 
 The declaration is bound on both sides, so neither imports the other's package — they only share
-this one. Add it to the entrypoint list the way any other entrypoint set is added:
+this one. A server or browser package binds `advertise`; it does not import a flattened shared list:
 
 ```typescript
-import { entrypoints as apiConfigEntrypoints } from '@owlmeans/api-config'
-export const appEntrypoints = [...apiConfigEntrypoints, ...myEntrypoints]
+import { advertise } from '@owlmeans/api-config'
+import { bind } from '@owlmeans/server-entrypoint'
+
+export const serverBindings = [bind(advertise, handler)]
 ```
 
 Most apps never do this directly: a backend built on `@owlmeans/server-app` already carries the

package/build/entrypoints.d.ts

@@ -1,4 +1,3 @@
 /** The public runtime-config endpoint protocol. */
 export declare const advertise: import("@owlmeans/entrypoint").EntrypointProtocol<import("@owlmeans/entrypoint").OpenRequest, import("@owlmeans/entrypoint").OpenValue>;
-export declare const protocols: import("@owlmeans/entrypoint").EntrypointProtocol<import("@owlmeans/entrypoint").OpenRequest, import("@owlmeans/entrypoint").OpenValue>[];
 //# sourceMappingURL=entrypoints.d.ts.map

package/build/entrypoints.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entrypoints.d.ts","sourceRoot":"","sources":["../src/entrypoints.ts"],"names":[],"mappings":"AAIA,mDAAmD;AACnD,eAAO,MAAM,SAAS,yIAA2E,CAAA;AAEjG,eAAO,MAAM,SAAS,2IAAc,CAAA"}
+{"version":3,"file":"entrypoints.d.ts","sourceRoot":"","sources":["../src/entrypoints.ts"],"names":[],"mappings":"AAIA,mDAAmD;AACnD,eAAO,MAAM,SAAS,yIAA2E,CAAA"}

package/build/entrypoints.js

@@ -3,5 +3,4 @@ import { route } from '@owlmeans/route';
 import { API_CONFIG } from './consts.js';
 /** The public runtime-config endpoint protocol. */
 export const advertise = openProtocol(route(API_CONFIG, '/assets/config.json'), { sticky: true });
-export const protocols = [advertise];
 //# sourceMappingURL=entrypoints.js.map

package/build/entrypoints.js.map

@@ -1 +1 @@
-{"version":3,"file":"entrypoints.js","sourceRoot":"","sources":["../src/entrypoints.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAExC,mDAAmD;AACnD,MAAM,CAAC,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,UAAU,EAAE,qBAAqB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;AAEjG,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,SAAS,CAAC,CAAA"}
+{"version":3,"file":"entrypoints.js","sourceRoot":"","sources":["../src/entrypoints.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAExC,mDAAmD;AACnD,MAAM,CAAC,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,UAAU,EAAE,qBAAqB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/api-config",
-  "version": "0.1.18-rc.20",
+  "version": "0.1.18-rc.22",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -22,10 +22,10 @@
     }
   },
   "dependencies": {
-    "@owlmeans/config": "^0.1.18-rc.20",
-    "@owlmeans/context": "^0.1.18-rc.16",
-    "@owlmeans/entrypoint": "^0.1.18-rc.19",
-    "@owlmeans/route": "^0.1.18-rc.17"
+    "@owlmeans/config": "^0.1.18-rc.22",
+    "@owlmeans/context": "^0.1.18-rc.18",
+    "@owlmeans/entrypoint": "^0.1.18-rc.21",
+    "@owlmeans/route": "^0.1.18-rc.19"
   },
   "devDependencies": {
     "@owlmeans/dep-config": "workspace:*",

package/src/entrypoints.ts

@@ -4,5 +4,3 @@ import { API_CONFIG } from './consts.js'
 
 /** The public runtime-config endpoint protocol. */
 export const advertise = openProtocol(route(API_CONFIG, '/assets/config.json'), { sticky: true })
-
-export const protocols = [advertise]

package/tests/plugins.spec.ts

@@ -58,12 +58,6 @@ describe('@owlmeans/api-config plugins', () => {
         api: { service: 'api', type: AppType.Backend, host: 'api.example.test', port: 443, base: 'api' },
       },
       plugins: [{ id: 'web', type: AppType.Frontend, value: 'safe' }],
-      oidc: {
-        clientCookie: { interaction: { name: 'oidc', ttl: 60 } },
-        providers: [{ clientId: 'public', service: 'iam' }],
-      },
-      flowConfig: { defaultFlow: 'signin', services: { auth: 'web' } },
-      i18n: { defaultLng: 'en', supportedLngs: ['en', 'pl'] },
       [CONFIG_RECORD]: [{ id: 'plan:starter', recordType: 'plan', price: 10 }],
     })
   })