@owlmeans/web-wl 0.1.18-rc.4 → 0.1.18-rc.41

package/README.md

@@ -1,29 +1,29 @@
 # @owlmeans/web-wl
 
-Web whitelabel — service factory, module declarations, and React components for managing whitelabel content in browser apps.
+Web whitelabel — service factory, local protocol bindings, and React components for managing whitelabel content in browser apps.
 
 ## Overview
 
 - `makeWlService(alias?)` — web-side whitelabel service factory
-- `wlModules` (exported as `modules`) — web-side whitelabel module declarations
+- `entrypoints` — web-side bindings for the shared whitelabel protocol
 - Components for displaying whitelabel content
 - `DEFAULT_ALIAS` — `'wl-web-serivce'`
 
 ## Installation
 
 ```bash
-bun add @owlmeans/web-wl
+bun add @owlmeans/web-wl@^0.1.18-rc.41
 ```
 
 ## Usage
 
-Register the service and module declarations:
+Register the service and local bindings:
 
 ```typescript
-import { makeWlService, modules as wlModules } from '@owlmeans/web-wl'
+import { makeWlService, entrypoints as wlEntrypoints } from '@owlmeans/web-wl'
 
 context.registerService(makeWlService())
-const modules = [...baseModules, ...wlModules, ...appModules]
+const clientBindings = [...baseEntrypoints, ...wlEntrypoints, ...appBindings]
 ```
 
 Downstream variants (e.g., `@owlmeans/web-wl-manager`) extend this with manager-store helpers like `setupWlManagerStore<C, T>(context)`.
@@ -34,9 +34,9 @@ Downstream variants (e.g., `@owlmeans/web-wl-manager`) extend this with manager-
 
 Creates the web whitelabel service. `alias` defaults to `DEFAULT_ALIAS` (`'wl-web-serivce'`).
 
-### `modules`
+### `entrypoints`
 
-Array of web-side module declarations for whitelabel content (re-exported as `wlModules` in downstream variants).
+Local browser bindings for `wledEntrypoints.provide`; they do not redeclare the shared protocol.
 
 ### Components
 
@@ -61,7 +61,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.41
 ```
 
 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/web-wl",
-  "version": "0.1.18-rc.0",
-  "generatedAt": "2026-08-16T22:20:50.513Z",
+  "version": "0.1.18-rc.41",
+  "generatedAt": "2026-09-28T02:06:37.891Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

package/agent-meta/skills/web-wl/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: web-wl
-description: How to use @owlmeans/web-wl — web white-label / whitelist UI components, modules, and service. Auto-invoked when importing web-wl primitives or building white-label features in a web app.
+description: How to use @owlmeans/web-wl — the browser half of the white-label contract — the bound WL_PROVIDE entrypoint, the caching WlWebService that loads an organization's white-label set, and the WlLogo component. Auto-invoked when reading white-label data in a web app or rendering a customer's branding.
 user-invocable: false
 ---
 <!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
@@ -8,29 +8,72 @@ user-invocable: false
 # @owlmeans/web-wl
 
 **Layer:** Web (React)
-**Install:** `"@owlmeans/web-wl": "^0.1.18-rc.0"` in `dependencies`
+**Install:** `"@owlmeans/web-wl": "^0.1.18-rc.41"` in `dependencies`
+
+Reads what `@owlmeans/server-wl` serves. One service call per organization entity, cached inside the
+service, plus a component for the one piece of branding almost every app needs.
 
 ## Key Exports
 
 | Export | Description |
 |--------|-------------|
-| `wlModules` | Web-side wled module declarations |
-| `makeWlService()` | Web-side wled service factory |
-| `components` | React components for managing whitelist entries |
-| Constants | Web-specific aliases |
+| `entrypoints` | The `WL_PROVIDE` protocol bound for the browser. Spread it into the app's entrypoint list or `call()` misses |
+| `makeWlService(alias?)` | The service factory. Defaults to `DEFAULT_ALIAS` |
+| `DEFAULT_ALIAS` | `'wl-web-serivce'` — spelled exactly that way. Always register and look the service up through this constant rather than a literal |
+| `WlWebService` | `load<T>(entityId, resource?) => Promise<ProvidedWLSet<T>>` and `extract<T>(key, set) => ProvidedWL<T>`. The `resource` argument is accepted and ignored — the whole set always comes back |
+| `ProvidedWLSet<T>` | The whole answer: `{ [providerAlias]: ProvidedWL<T> }` |
+| `WlLogo` | `<WlLogo entityId={…} defImg={…} />` — both props optional. Renders the `wl-logo` section's `brand.wideLogo`, else `defImg`, else nothing; with no `entityId` it never loads and only `defImg` can show. It reads the section by the literal name `wl-logo`, so the backend must register its media provider under exactly that alias |
+| `Config`, `Context` | This package's `AppConfig`/`AppContext` from `@owlmeans/web-client`, narrowed for its own service |
+
+The component prop interfaces are **not** exported — the entry point re-exports the component only.
+Type a wrapper with `ComponentProps<typeof WlLogo>` rather than importing a props name.
 
-## Usage
+## Wiring
 
 ```typescript
-import { wlModules, makeWlService } from '@owlmeans/web-wl'
+import { entrypoints as wlEntrypoints, makeWlService } from '@owlmeans/web-wl'
 
 context.registerService(makeWlService())
-const modules = [...baseModules, ...wlModules, ...managerModules]
+const entrypoints = [...baseEntrypoints, ...wlEntrypoints, ...managerEntrypoints]
+```
+
+## Reading a white-label set
+
+```typescript
+import { DEFAULT_ALIAS } from '@owlmeans/web-wl'
+import type { WlWebService } from '@owlmeans/web-wl'
+import type { CustomStyles } from '@owlmeans/wled'
+
+const wl = context.service<WlWebService>(DEFAULT_ALIAS)
+const set = await wl.load(entityId)
+const styles = wl.extract<CustomStyles>('wl-styles', set)
+if (styles.exists === true) {
+  applyTheme(styles.colors, styles.font)
+}
 ```
 
-A common downstream variant (`@owlmeans/web-wl-manager`) provides a manager-store helper like `setupWlManagerStore<C, T>(context)`.
+The key is the **provider service alias the backend registered**, the same string that appears in
+that server's `cfg.wlProviders`. It is not a `WL_TYPE_*` constant — those name the `type` field
+inside a section, which is how a reader confirms the shape it got.
+
+The value `load` sends as the `entity` param is the argument it was given, unchanged; what the server
+accepts there is the server's rule, not this package's.
+
+`load` memoises per `entityId` in a cache created inside `makeWlService`, so the memo lives exactly as
+long as that service instance and two services made under different aliases keep independent caches.
+The entry is written only after the call resolves and there is no in-flight promise memo, so
+concurrent callers — two `WlLogo`s mounting in the same tick — each issue their own request; the
+cache only dedups calls made after one has returned. Nothing invalidates it either, so a screen that
+has just written new branding must reload the page (or read the write's own response) rather than
+expecting `load` to see the change.
 
 ## Depends On
 
-- `@owlmeans/wled`, `@owlmeans/client-wl`, `@owlmeans/web-client`, `@owlmeans/web-panel`
+- `@owlmeans/wled`, `@owlmeans/client`, `@owlmeans/client-entrypoint`, `@owlmeans/context`
+- `@owlmeans/web-client` — supplies the `AppConfig`/`AppContext` this package's `Config`/`Context`
+  extend. It is imported by the published types but missing from the manifest, so a consumer has to
+  install it explicitly or the declarations do not resolve
 - `react` (peer)
+
+The server counterpart is `@owlmeans/server-wl`. Editing screens for white-label records live in
+downstream manager packages, not here.

package/build/entrypoints.d.ts

@@ -0,0 +1,4 @@
+export declare const entrypoints: import("@owlmeans/client-entrypoint").ClientProtocolEntrypoint<import("@owlmeans/entrypoint").EntrypointProtocol<{
+    params: import("@owlmeans/wled").ProvideParams;
+}, undefined>>[];
+//# 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,eAAO,MAAM,WAAW;;gBAAkC,CAAA"}

package/build/entrypoints.js

@@ -0,0 +1,4 @@
+import { bind } from '@owlmeans/client-entrypoint';
+import { wledEntrypoints } from '@owlmeans/wled';
+export const entrypoints = [bind(wledEntrypoints.provide)];
+//# 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,IAAI,EAAE,MAAM,6BAA6B,CAAA;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAEhD,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAA"}

package/build/index.d.ts

@@ -1,6 +1,6 @@
 export type * from './types.js';
 export * from './consts.js';
-export * from './modules.js';
+export * from './entrypoints.js';
 export * from './service.js';
 export * from './components/index.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,mBAAmB,YAAY,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,uBAAuB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,mBAAmB,YAAY,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA;AAChC,cAAc,cAAc,CAAA;AAC5B,cAAc,uBAAuB,CAAA"}

package/build/index.js

@@ -1,5 +1,5 @@
 export * from './consts.js';
-export * from './modules.js';
+export * from './entrypoints.js';
 export * from './service.js';
 export * from './components/index.js';
 //# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,uBAAuB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA;AAChC,cAAc,cAAc,CAAA;AAC5B,cAAc,uBAAuB,CAAA"}

package/build/service.js

@@ -10,7 +10,7 @@ export const makeWlService = (alias = DEFAULT_ALIAS) => {
             }
             const context = service.assertCtx();
             const module = context.entrypoint(WL_PROVIDE);
-            const [wlSet] = await module.call({ params: { entity: entityId } });
+            const wlSet = await module.call({ params: { entity: entityId } });
             return cache[entityId] = wlSet;
         },
         extract: (key, set) => set[key]

package/build/service.js.map

@@ -1 +1 @@
-{"version":3,"file":"service.js","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAE3C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAG3C,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAK,GAAW,aAAa,EAAgB,EAAE;IAC3E,MAAM,KAAK,GAA0C,EAAE,CAAA;IAEvD,MAAM,OAAO,GAAiB,aAAa,CAAe,KAAK,EAAE;QAC/D,IAAI,EAAE,KAAK,EAAC,QAAQ,EAAC,EAAE;YACrB,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC;gBAC5B,OAAO,KAAK,CAAC,QAAQ,CAAC,CAAA;YACxB,CAAC;YAED,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,EAAmB,CAAA;YAEpD,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAAkC,UAAU,CAAC,CAAA;YAC9E,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAA;YAEnE,OAAO,KAAK,CAAC,QAAQ,CAAC,GAAG,KAA2B,CAAA;QACtD,CAAC;QAED,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC;KAChC,CAAC,CAAA;IAEF,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA"}
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAE3C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAG3C,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAK,GAAW,aAAa,EAAgB,EAAE;IAC3E,MAAM,KAAK,GAA0C,EAAE,CAAA;IAEvD,MAAM,OAAO,GAAiB,aAAa,CAAe,KAAK,EAAE;QAC/D,IAAI,EAAE,KAAK,EAAC,QAAQ,EAAC,EAAE;YACrB,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC;gBAC5B,OAAO,KAAK,CAAC,QAAQ,CAAC,CAAA;YACxB,CAAC;YAED,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,EAAmB,CAAA;YAEpD,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAAkC,UAAU,CAAC,CAAA;YAC9E,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAA;YAEjE,OAAO,KAAK,CAAC,QAAQ,CAAC,GAAG,KAA2B,CAAA;QACtD,CAAC;QAED,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC;KAChC,CAAC,CAAA;IAEF,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/web-wl",
-  "version": "0.1.18-rc.4",
+  "version": "0.1.18-rc.41",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -21,10 +21,10 @@
     }
   },
   "dependencies": {
-    "@owlmeans/client": "^0.1.18-rc.4",
-    "@owlmeans/client-entrypoint": "^0.1.18-rc.4",
-    "@owlmeans/context": "^0.1.18-rc.4",
-    "@owlmeans/wled": "^0.1.18-rc.4"
+    "@owlmeans/client": "^0.1.18-rc.44",
+    "@owlmeans/client-entrypoint": "^0.1.18-rc.40",
+    "@owlmeans/context": "^0.1.18-rc.32",
+    "@owlmeans/wled": "^0.1.18-rc.34"
   },
   "peerDependencies": {
     "react": "*"

package/src/entrypoints.ts

@@ -0,0 +1,5 @@
+
+import { bind } from '@owlmeans/client-entrypoint'
+import { wledEntrypoints } from '@owlmeans/wled'
+
+export const entrypoints = [bind(wledEntrypoints.provide)]

package/src/index.ts

@@ -1,7 +1,7 @@
 
 export type * from './types.js'
 export * from './consts.js'
-export * from './modules.js'
+export * from './entrypoints.js'
 export * from './service.js'
 export * from './components/index.js'
 

package/src/service.ts

@@ -17,7 +17,7 @@ export const makeWlService = (alias: string = DEFAULT_ALIAS): WlWebService => {
       const context = service.assertCtx<Config, Context>()
 
       const module = context.entrypoint<ClientEntrypoint<ProvidedWLSet>>(WL_PROVIDE)
-      const [wlSet] = await module.call({ params: { entity: entityId } })
+      const wlSet = await module.call({ params: { entity: entityId } })
 
       return cache[entityId] = wlSet as ProvidedWLSet<any>
     },

package/src/modules.ts

@@ -1,8 +0,0 @@
-
-import { elevate } from '@owlmeans/client-entrypoint'
-import type { ClientEntrypoint } from '@owlmeans/client-entrypoint'
-import { WL_PROVIDE, modules as wlModules } from '@owlmeans/wled'
-
-elevate(wlModules, WL_PROVIDE)
-
-export const modules = wlModules as ClientEntrypoint<unknown>[]