@owlmeans/server-wl 0.1.18-rc.16 → 0.1.18-rc.18

package/README.md

@@ -12,7 +12,7 @@ Server-side whitelabeling — provides entity-specific branding and configuratio
 ## Installation
 
 ```bash
-bun add @owlmeans/server-wl
+bun add @owlmeans/server-wl@^0.1.18-rc.16
 ```
 
 ## Usage
@@ -59,7 +59,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.13
 ```
 
 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/server-wl",
-  "version": "0.1.18-rc.16",
-  "generatedAt": "2026-09-01T17:39:40.766Z",
+  "version": "0.1.18-rc.18",
+  "generatedAt": "2026-09-10T18:54:42.503Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

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

@@ -1,6 +1,6 @@
 ---
 name: server-wl
-description: How to use @owlmeans/server-wl — server-side whitelist/allowlist (white-label) module declarations to add to your appModules. Auto-invoked when importing server-wl modules.
+description: How to use @owlmeans/server-wl — the server half of the white-label contract — the elevated WL_PROVIDE entrypoint, the WlProvider and WlEntityIdentifier service seams, and the cfg.wlProviders wiring that decides what a provide call returns. Auto-invoked when serving white-label data or writing a white-label provider service.
 user-invocable: false
 ---
 <!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
@@ -8,24 +8,84 @@ user-invocable: false
 # @owlmeans/server-wl
 
 **Layer:** Server
-**Install:** `"@owlmeans/server-wl": "^0.1.18-rc.16"` in `dependencies`
+**Install:** `"@owlmeans/server-wl": "^0.1.18-rc.18"` in `dependencies`
+
+Answers the one `WL_PROVIDE` entrypoint `@owlmeans/wled` declares. It stores nothing itself: it fans
+the request out to the provider services the configuration names and returns their answers in one
+object.
 
 ## Key Exports
 
 | Export | Description |
 |--------|-------------|
-| `wlModules` | Server module declarations for whitelist endpoints |
-| `Wl` server types | Server-side white-label types |
+| `entrypoints` | The `WL_PROVIDE` declaration, already elevated with the provide handler. Spread it into the app's entrypoint list |
+| `WlProvider` | Service seam a white-label section implements: `provide(entityId) => Promise<ProvidedWL>` |
+| `WlEntityIdentifier` | Optional seam that maps a public identifier (a custom domain, say) to an entity id: `identifyEntity(identifier) => Promise<string \| null>` |
+| `WlProviderAppend` | The config this package reads: `{ wlProviders: string[], wlIdentifierService?: string }` |
+| `Config`, `Context` | `ServerConfig`/`ServerContext` narrowed to carry `WlProviderAppend` |
+
+## Wiring
 
-## Usage
+```typescript
+import { entrypoints as wlEntrypoints } from '@owlmeans/server-wl'
+
+export const appEntrypoints = [...ownEntrypoints, ...wlEntrypoints]
+```
 
 ```typescript
-import { wlModules } from '@owlmeans/server-wl'
-export const appModules = [...modules, ...wlModules, ...managerModules]
+// config — the aliases of services registered on this context that implement WlProvider
+cfg.wlProviders = ['wl-info', 'wl-styles', 'wl-logo']
+// optional: resolves a public identifier to an entity id before the providers are called
+cfg.wlIdentifierService = 'wl-dns'
 ```
 
-White-label DNS/routing service is typically wired separately as `@owlmeans/server-wl-dns` (downstream package).
+`wlProviders` is required, not optional: the handler maps over it unconditionally, so a context that
+serves this entrypoint with the key unset fails the request rather than returning an empty set.
+
+The declaration `@owlmeans/wled` ships carries **no guard**, and this package elevates it with a
+handler only — so the endpoint answers anonymously and any caller who can name an organization reads
+every section the deployment registered. Keep white-label records public by design, or elevate the
+alias with a guard of your own in the application's entrypoint list.
+
+## The response is keyed by service alias
+
+The handler builds `{ [providerAlias]: await service.provide(entityId) }`, so the key a browser reads
+a section under is the **alias the provider service was registered as** — not the `type` on the
+record and not a white-label constant. Registering the same provider under a different alias renames
+the section for every reader.
+
+The `:entity` path param is whatever the caller addressed the organization by. When
+`wlIdentifierService` is configured, its `identifyEntity` runs first and its answer replaces the
+param; a `null` answer leaves the param in place, so a bare entity slug keeps working with a
+resolver installed.
+
+## Writing a provider
+
+```typescript
+import type { WlProvider } from '@owlmeans/server-wl'
+import { WL_TYPE_COMPANY_INFO } from '@owlmeans/wled'
+import { createService } from '@owlmeans/context'
+
+export const makeInfoService = (alias = 'wl-info'): WlProvider =>
+  createService<WlProvider>(alias, {
+    provide: async entityId => {
+      const record = await load(entityId)
+
+      return record != null
+        ? { ...record, type: WL_TYPE_COMPANY_INFO, exists: true }
+        : { type: WL_TYPE_COMPANY_INFO, exists: false }
+    }
+  })
+```
+
+A provider is called for every request to the entrypoint, in parallel with its siblings, and one
+rejection fails the whole response — so a provider that cannot answer returns `exists: false` rather
+than throwing.
 
 ## Depends On
 
-- `@owlmeans/wled`, `@owlmeans/server-entrypoint`, `@owlmeans/server-route`
+- `@owlmeans/wled`, `@owlmeans/server-api`, `@owlmeans/server-entrypoint`, `@owlmeans/server-context`,
+  `@owlmeans/context`
+
+The browser counterpart is `@owlmeans/web-wl`. Concrete providers — company info, styles, logo
+storage, DNS — are separate downstream packages that implement `WlProvider`.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@owlmeans/server-wl",
   "type": "module",
-  "version": "0.1.18-rc.16",
+  "version": "0.1.18-rc.18",
   "license": "MIT",
   "scripts": {
     "build": "tsc -b",
@@ -21,11 +21,11 @@
     }
   },
   "dependencies": {
-    "@owlmeans/context": "^0.1.18-rc.7",
-    "@owlmeans/server-api": "^0.1.18-rc.16",
-    "@owlmeans/server-context": "^0.1.18-rc.11",
-    "@owlmeans/server-entrypoint": "^0.1.18-rc.10",
-    "@owlmeans/wled": "^0.1.18-rc.10"
+    "@owlmeans/context": "^0.1.18-rc.9",
+    "@owlmeans/server-api": "^0.1.18-rc.18",
+    "@owlmeans/server-context": "^0.1.18-rc.13",
+    "@owlmeans/server-entrypoint": "^0.1.18-rc.12",
+    "@owlmeans/wled": "^0.1.18-rc.12"
   },
   "devDependencies": {
     "@owlmeans/dep-config": "workspace:*",