@owlmeans/web-wl 0.1.18-rc.13 → 0.1.18-rc.15

package/README.md

@@ -12,7 +12,7 @@ Web whitelabel — service factory, entrypoint declarations, and React component
 ## Installation
 
 ```bash
-bun add @owlmeans/web-wl
+bun add @owlmeans/web-wl@^0.1.18-rc.14
 ```
 
 ## Usage
@@ -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.12
 ```
 
 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.13",
-  "generatedAt": "2026-09-01T16:49:00.429Z",
+  "version": "0.1.18-rc.15",
+  "generatedAt": "2026-09-04T22:43:25.450Z",
   "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 elevated 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.13"` in `dependencies`
+**Install:** `"@owlmeans/web-wl": "^0.1.18-rc.15"` 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` declaration elevated 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/service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAkC,YAAY,EAAE,MAAM,YAAY,CAAA;AAK9E,eAAO,MAAM,aAAa,GAAI,QAAO,MAAsB,KAAG,YAqB7D,CAAA"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAkC,YAAY,EAAE,MAAM,YAAY,CAAA;AAK9E,eAAO,MAAM,aAAa,WAAW,MAAM,KAAmB,YAqB7D,CAAA"}

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,QAAgB,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"}
+{"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.13",
+  "version": "0.1.18-rc.15",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -21,10 +21,10 @@
     }
   },
   "dependencies": {
-    "@owlmeans/client": "^0.1.18-rc.14",
-    "@owlmeans/client-entrypoint": "^0.1.18-rc.11",
-    "@owlmeans/context": "^0.1.18-rc.7",
-    "@owlmeans/wled": "^0.1.18-rc.9"
+    "@owlmeans/client": "^0.1.18-rc.16",
+    "@owlmeans/client-entrypoint": "^0.1.18-rc.13",
+    "@owlmeans/context": "^0.1.18-rc.8",
+    "@owlmeans/wled": "^0.1.18-rc.11"
   },
   "peerDependencies": {
     "react": "*"