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

package/README.md

@@ -1,10 +1,10 @@
 # @owlmeans/server-wl
 
-Server-side whitelabeling — provides entity-specific branding and configuration via backend modules.
+Server-side whitelabeling — provides entity-specific branding and configuration via a bound backend protocol.
 
 ## Overview
 
-- Exports `modules` array: pre-built server modules that serve WL (whitelabel) configuration to clients
+- Exports `entrypoints`: local server bindings that serve the shared WL protocol to clients
 - Provides `provide` action — the handler for the WL configuration endpoint
 - Integrates with `@owlmeans/wled` for whitelabel data definitions
 - Apps add WL DNS service from `@owlmeans/server-wl-dns` for domain-based entity resolution
@@ -12,35 +12,36 @@ 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.41
 ```
 
 ## Usage
 
-Register WL modules in a backend service:
+Register WL entrypoints in a backend service:
 
 ```typescript
-import { modules as wlModules } from '@owlmeans/server-wl'
-import { main, modules } from '@owlmeans/server-app'
+import { entrypoints as wlEntrypoints } from '@owlmeans/server-wl'
+import { main, entrypoints } from '@owlmeans/server-app'
 
-await main(context, [...modules, ...wlModules, ...appModules])
+await main(context, [...entrypoints, ...wlEntrypoints, ...serverBindings])
 ```
 
 With DNS-based entity resolution (from viable):
 
 ```typescript
 import { appendWlDnsService } from '@owlmeans/server-wl-dns'
-import { wlDnsModules } from '@owlmeans/server-wl-dns'
+import { wlDnsEntrypoints } from '@owlmeans/server-wl-dns'
 
 appendWlDnsService(context)
-await main(context, [...modules, ...wlDnsModules, ...appModules])
+await main(context, [...entrypoints, ...wlDnsEntrypoints, ...serverBindings])
 ```
 
 ## API
 
-### `modules`
+### `entrypoints`
 
-Array of `ServerModule` instances providing the WL configuration API endpoint.
+Local bound server entrypoints providing the WL configuration API endpoint. The shared immutable
+declaration is `wledEntrypoints.provide` from `@owlmeans/wled`; this package supplies its handler.
 
 ### `WlConfig` / `WlRecord` (types)
 
@@ -49,7 +50,7 @@ Whitelabel configuration types defining branding, theme, and entity-specific set
 ## Related Packages
 
 - [`@owlmeans/client-wl`](../client-wl) — client-side WL service that fetches from this server
-- [`@owlmeans/server-app`](../server-app) — server bootstrap that includes these modules
+- [`@owlmeans/server-app`](../server-app) — server bootstrap that includes these entrypoints
 
 <!-- owlmeans:agent-guidance:start -->
 ## Agent guidance
@@ -59,7 +60,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.40
 ```
 
 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.0",
-  "generatedAt": "2026-08-16T22:20:50.512Z",
+  "version": "0.1.18-rc.41",
+  "generatedAt": "2026-09-25T21:19:37.987Z",
   "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 bound 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.0"` in `dependencies`
+**Install:** `"@owlmeans/server-wl": "^0.1.18-rc.41"` 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` protocol already bound to 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 serverBindings = [...ownBindings, ...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 binds 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 bind the
+alias with a guard of your own in the application's entrypoint bindings.
+
+## 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/build/actions/provide.d.ts

@@ -1,3 +1,5 @@
-import type { RefedEntrypointHandler } from '@owlmeans/server-entrypoint';
-export declare const provide: RefedEntrypointHandler;
+import type { ProvideParams } from '@owlmeans/wled';
+export declare const provide: import("@owlmeans/server-entrypoint").BoundEntrypointHandler<import("@owlmeans/entrypoint").EntrypointProtocol<{
+    params: ProvideParams;
+}, undefined>>;
 //# sourceMappingURL=provide.d.ts.map

package/build/actions/provide.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provide.d.ts","sourceRoot":"","sources":["../../src/actions/provide.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAA;AAMzE,eAAO,MAAM,OAAO,EAAE,sBAqBrB,CAAA"}
+{"version":3,"file":"provide.d.ts","sourceRoot":"","sources":["../../src/actions/provide.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAGnD,eAAO,MAAM,OAAO;;cAqBnB,CAAA"}

package/build/actions/provide.js

@@ -1,7 +1,6 @@
-import { handleParams } from '@owlmeans/server-api';
-import { assertContext } from '@owlmeans/context';
-export const provide = handleParams(async (params, ctx) => {
-    const context = assertContext(ctx, 'provide');
+import { handlers } from '@owlmeans/server-api';
+import { wledEntrypoints } from '@owlmeans/wled';
+export const provide = handlers().params(wledEntrypoints.provide, async (params, context) => {
     const dns = context.cfg.wlIdentifierService == null ? undefined
         : context.service(context.cfg.wlIdentifierService);
     const entityId = dns != null

package/build/actions/provide.js.map

@@ -1 +1 @@
-{"version":3,"file":"provide.js","sourceRoot":"","sources":["../../src/actions/provide.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAEnD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAGjD,MAAM,CAAC,MAAM,OAAO,GAA2B,YAAY,CACzD,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE;IACpB,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,EAAE,SAAS,CAAY,CAAA;IAExD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS;QAC7D,CAAC,CAAC,OAAO,CAAC,OAAO,CAAqB,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAA;IAExE,MAAM,QAAQ,GAAG,GAAG,IAAI,IAAI;QAC1B,CAAC,CAAC,MAAM,GAAG,CAAC,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM;QAC1D,CAAC,CAAC,MAAM,CAAC,MAAM,CAAA;IAEjB,MAAM,EAAE,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,OAAO,CAAC,GAAG,CAC7C,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,EAAC,QAAQ,EAAC,EAAE;QAC3C,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAa,QAAQ,CAAC,CAAA;QAEjD,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAA;IAChD,CAAC,CAAC,CACH,CAAC,CAAA;IAEF,OAAO,EAAE,CAAA;AACX,CAAC,CACF,CAAA"}
+{"version":3,"file":"provide.js","sourceRoot":"","sources":["../../src/actions/provide.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAG/C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAEhD,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,EAAW,CAAC,MAAM,CAC/C,eAAe,CAAC,OAAO,EACvB,KAAK,EAAE,MAAqB,EAAE,OAAO,EAAE,EAAE;IAEvC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS;QAC7D,CAAC,CAAC,OAAO,CAAC,OAAO,CAAqB,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAA;IAExE,MAAM,QAAQ,GAAG,GAAG,IAAI,IAAI;QAC1B,CAAC,CAAC,MAAM,GAAG,CAAC,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM;QAC1D,CAAC,CAAC,MAAM,CAAC,MAAM,CAAA;IAEjB,MAAM,EAAE,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,OAAO,CAAC,GAAG,CAC7C,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,EAAC,QAAQ,EAAC,EAAE;QAC3C,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAa,QAAQ,CAAC,CAAA;QAEjD,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAA;IAChD,CAAC,CAAC,CACH,CAAC,CAAA;IAEF,OAAO,EAAE,CAAA;AACX,CAAC,CACF,CAAA"}

package/build/entrypoints.d.ts

@@ -0,0 +1,4 @@
+export declare const entrypoints: import("@owlmeans/server-entrypoint").ServerProtocolEntrypoint<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":"AAKA,eAAO,MAAM,WAAW;;gBAAmD,CAAA"}

package/build/entrypoints.js

@@ -0,0 +1,5 @@
+import { bind } from '@owlmeans/server-entrypoint';
+import { wledEntrypoints } from '@owlmeans/wled';
+import * as actions from './actions/index.js';
+export const entrypoints = [bind(wledEntrypoints.provide, actions.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;AAChD,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAA;AAE7C,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAA"}

package/build/index.d.ts

@@ -1,3 +1,3 @@
 export type * from './types.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,mBAAmB,YAAY,CAAA;AAC/B,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,mBAAmB,YAAY,CAAA;AAC/B,cAAc,kBAAkB,CAAA"}

package/build/index.js

@@ -1,2 +1,2 @@
-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":"AAEA,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,kBAAkB,CAAA"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@owlmeans/server-wl",
   "type": "module",
-  "version": "0.1.18-rc.4",
+  "version": "0.1.18-rc.41",
   "license": "MIT",
   "scripts": {
     "build": "tsc -b",
@@ -21,11 +21,11 @@
     }
   },
   "dependencies": {
-    "@owlmeans/context": "^0.1.18-rc.4",
-    "@owlmeans/server-api": "^0.1.18-rc.4",
-    "@owlmeans/server-context": "^0.1.18-rc.4",
-    "@owlmeans/server-entrypoint": "^0.1.18-rc.4",
-    "@owlmeans/wled": "^0.1.18-rc.4"
+    "@owlmeans/context": "^0.1.18-rc.32",
+    "@owlmeans/server-api": "^0.1.18-rc.43",
+    "@owlmeans/server-context": "^0.1.18-rc.37",
+    "@owlmeans/server-entrypoint": "^0.1.18-rc.36",
+    "@owlmeans/wled": "^0.1.18-rc.34"
   },
   "devDependencies": {
     "@owlmeans/dep-config": "workspace:*",

package/src/actions/provide.ts

@@ -1,12 +1,11 @@
-import type { RefedEntrypointHandler } from '@owlmeans/server-entrypoint'
-import { handleParams } from '@owlmeans/server-api'
+import { handlers } from '@owlmeans/server-api'
 import type { Context, WlEntityIdentifier, WlProvider } from '../types.js'
-import { assertContext } from '@owlmeans/context'
 import type { ProvideParams } from '@owlmeans/wled'
+import { wledEntrypoints } from '@owlmeans/wled'
 
-export const provide: RefedEntrypointHandler = handleParams<ProvideParams>(
-  async (params, ctx) => {
-    const context = assertContext(ctx, 'provide') as Context
+export const provide = handlers<Context>().params(
+  wledEntrypoints.provide,
+  async (params: ProvideParams, context) => {
 
     const dns = context.cfg.wlIdentifierService == null ? undefined
       : context.service<WlEntityIdentifier>(context.cfg.wlIdentifierService)

package/src/entrypoints.ts

@@ -0,0 +1,6 @@
+
+import { bind } from '@owlmeans/server-entrypoint'
+import { wledEntrypoints } from '@owlmeans/wled'
+import * as actions from './actions/index.js'
+
+export const entrypoints = [bind(wledEntrypoints.provide, actions.provide)]

package/src/index.ts

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

package/build/modules.d.ts

@@ -1,3 +0,0 @@
-import type { ServerEntrypoint } from '@owlmeans/server-entrypoint';
-export declare const modules: ServerEntrypoint<unknown>[];
-//# 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":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AAMnE,eAAO,MAAM,OAAO,EAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAA"}

package/build/modules.js

@@ -1,6 +0,0 @@
-import { elevate } from '@owlmeans/server-entrypoint';
-import { WL_PROVIDE, modules as wlModules } from '@owlmeans/wled';
-import * as actions from './actions/index.js';
-elevate(wlModules, WL_PROVIDE, actions.provide);
-export const modules = wlModules;
-//# 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,EAAE,MAAM,6BAA6B,CAAA;AAErD,OAAO,EAAE,UAAU,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,gBAAgB,CAAA;AACjE,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAA;AAE7C,OAAO,CAAC,SAAS,EAAE,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;AAE/C,MAAM,CAAC,MAAM,OAAO,GAAG,SAAwC,CAAA"}

package/src/modules.ts

@@ -1,9 +0,0 @@
-
-import { elevate } from '@owlmeans/server-entrypoint'
-import type { ServerEntrypoint } from '@owlmeans/server-entrypoint'
-import { WL_PROVIDE, modules as wlModules } from '@owlmeans/wled'
-import * as actions from './actions/index.js'
-
-elevate(wlModules, WL_PROVIDE, actions.provide)
-
-export const modules = wlModules as ServerEntrypoint<unknown>[]