@owlmeans/wled 0.1.18-rc.1 → 0.1.18-rc.11

package/README.md

@@ -1,27 +1,27 @@
 # @owlmeans/wled
 
-Whitelabel ("wled") core — shared types, models, and module declarations for entity-specific branding/content.
+Whitelabel ("wled") core — shared types, models, and entrypoint declarations for organization-entity-specific branding/content.
 
 ## Overview
 
-- `WL_PROVIDE` / `WL_PROVIDE_PATH` — module alias and path for the whitelabel provide endpoint
+- `WL_PROVIDE` / `WL_PROVIDE_PATH` — entrypoint alias and path for the whitelabel provide endpoint
 - `WL_TYPE_COMPANY_INFO`, `WL_TYPE_STYLES`, `WL_TYPE_MEDIA`, `WL_TYPE_DNS` — whitelabel content type discriminators
 - Type definitions: `CompanyInfo`, `CustomStyles`, `CustomColors`, `CustomFont`, `CustomMedia`, `CustomBrand`, `ProvideParams`, `ProvidedWL<T>`
-- `modules` — array containing the `GET /wl/provide/:entity` declaration
+- `entrypoints` — array containing the `GET /wl/provide/:entity` declaration
 - AJV models under `model/` (e.g., `ProvideParamsSchema`)
 
 ## Installation
 
 ```bash
-bun add @owlmeans/wled
+bun add @owlmeans/wled@^0.1.18-rc.10
 ```
 
 ## Usage
 
-Use the shared module declarations and types when wiring server- and web-side whitelabel features:
+Use the shared entrypoint declarations and types when wiring server- and web-side whitelabel features:
 
 ```typescript
-import { modules as wlModules } from '@owlmeans/wled'
+import { entrypoints as wlEntrypoints } from '@owlmeans/wled'
 import type { ProvidedWL, CompanyInfo, CustomStyles } from '@owlmeans/wled'
 ```
 
@@ -50,7 +50,7 @@ The actual server handlers live in `@owlmeans/server-wl`; web UI in `@owlmeans/w
 
 `CompanyInfo`, `CustomStyles`, `CustomColors`, `CustomFont`, `CustomMedia`, `CustomBrand`, `ProvideParams`, `ProvidedWL<T>` — re-exported at the root entry.
 
-### `modules`
+### `entrypoints`
 
 Array with one declaration: `GET /wl/provide/:entity` (alias `WL_PROVIDE`), with `params` filter using `ProvideParamsSchema`.
 
@@ -60,7 +60,7 @@ Submodule exporting AJV schemas (e.g., `ProvideParamsSchema`) and helpers for wh
 
 ## Related Packages
 
-- [`@owlmeans/server-wl`](../server-wl) — server-side whitelabel handlers (uses `modules` from here)
+- [`@owlmeans/server-wl`](../server-wl) — server-side whitelabel handlers (uses `entrypoints` from here)
 - [`@owlmeans/web-wl`](../web-wl) — web UI components for whitelabel content
 - [`@owlmeans/client-wl`](../client-wl) — client-side whitelabel placeholder
 
@@ -72,7 +72,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/wled",
-  "version": "0.1.18-rc.0",
-  "generatedAt": "2026-08-16T22:20:50.510Z",
+  "version": "0.1.18-rc.11",
+  "generatedAt": "2026-09-04T22:43:25.446Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

package/agent-meta/skills/wled/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: wled
-description: How to use @owlmeans/wled — whitelist/allowlist ("white-label") entity types, model, and shared module declarations. Auto-invoked when importing wled types or building white-label features.
+description: How to use @owlmeans/wled — the shared white-label contract — company info, custom styles, brand media and DNS shapes, their AJV schemas, the wl type constants and the single WL_PROVIDE entrypoint both sides elevate. Auto-invoked when importing white-label types or schemas, or when adding a white-label provider.
 user-invocable: false
 ---
 <!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
@@ -8,29 +8,77 @@ user-invocable: false
 # @owlmeans/wled
 
 **Layer:** Core
-**Install:** `"@owlmeans/wled": "^0.1.18-rc.0"` in `dependencies`
+**Install:** `"@owlmeans/wled": "^0.1.18-rc.11"` in `dependencies`
+
+The contract only. It owns no service and reaches no store: it declares the white-label record
+shapes, their schemas, and one entrypoint that the server side answers and the browser side calls.
+Everything that produces a white-label record lives downstream.
 
 ## Key Exports
 
 | Export | Description |
 |--------|-------------|
-| `Wled`, `Entity` types | Whitelist entry / entity shapes |
-| `WL_BUCKET` and constants | Shared aliases (e.g. storage bucket name) |
-| Modules | Shared whitelist module declarations |
-| `model` submodule | Validation/model helpers |
+| `entrypoints` | The single `WL_PROVIDE` declaration — a backend `GET /wl/provide/:entity`, filtered by `params(ProvideParamsSchema)` and guarded by nothing. Elevate it, never redeclare it |
+| `WL_PROVIDE` | That entrypoint's alias. Both `@owlmeans/server-wl` and `@owlmeans/web-wl` elevate this exact alias |
+| `WL_PROVIDE_PATH` | `'/wl/provide/:entity'` |
+| `WL_TYPE_COMPANY_INFO`, `WL_TYPE_STYLES`, `WL_TYPE_MEDIA`, `WL_TYPE_DNS` | The `type` a provider stamps on the record it returns — `'company-info'`, `'styles'`, `'media'`, `'dns'` |
+| `ProvidedWL<T>` | What one provider answers: `T & { type: string; exists: boolean \| null }` |
+| `CompanyInfo` | `{ resource?, entityId, fullName, shortName, slug, description }` |
+| `CustomStyles` | `{ resource?, entityId, font, colors }` — a whole theme record, not just the palette |
+| `CustomFont`, `CustomColors` | `{ fontFamily, basicSize? }` (`basicSize` minimum 8), and a required `primaryColor` plus optional secondary/alert/success colours and their backgrounds |
+| `CustomMedia`, `CustomBrand` | `{ brand: { squareLogo?, wideLogo? } }` — both are URLs |
+| `CustomUrls` | `{ adminUrl, userUrl }` |
+| `ProvideParams` | `{ entity: string }` — the one path param |
+| `CompanyInfoSchema`, `CustomStylesSchema`, `CustomFontSchema`, `CustomColorsSchema`, `ColorSchema`, `ProvideParamsSchema` | The AJV schemas for the shapes above. `ajv` is a peer dependency |
+
+## The provide contract
 
-## Usage
+`WL_PROVIDE` answers one object per organization entity, keyed by **provider service alias** — not by
+white-label type:
 
 ```typescript
-import { WL_BUCKET } from '@owlmeans/wled'
+import { WL_TYPE_MEDIA } from '@owlmeans/wled'
+import type { CustomMedia, ProvidedWL } from '@owlmeans/wled'
 
-cfg.storageBuckets = {
-  [WL_BUCKET]: { url: '/etc/app-config/s3-bucket-url', apiKey: '/etc/master-secret/s3-storage', basePrefix: WL_BUCKET_PREFIX }
+// what a provider registered under the alias 'wl-logo' contributes
+const media: ProvidedWL<CustomMedia> = {
+  type: WL_TYPE_MEDIA,
+  exists: true,
+  brand: { wideLogo: 'https://…/wide.png' }
 }
+// → the response carries it as { 'wl-logo': media, 'wl-info': …, 'wl-styles': … }
 ```
 
-Server side wires the module declarations through `@owlmeans/server-wl`; web side through `@owlmeans/web-wl` / `@owlmeans/client-wl`.
+So a reader picks a section by the alias it registered the provider under, and `type` tells it which
+shape it is holding. `exists` is a tri-state: `true` a stored record, `false` a deliberate empty
+default, `null` unknown.
+
+## Rules
+
+- **The declaration carries no guard.** Whatever elevates `WL_PROVIDE` serves it anonymously unless
+  it adds one, so every section a deployment registers is readable by anyone who can name an
+  organization. Put nothing in a white-label record that is not meant to be public, or add a guard
+  where the entrypoint is elevated.
+- `entityId`, `slug` and the `entity` param are declared with `EntityValueSchema` from
+  `@owlmeans/auth`, a plain `{ type: 'string', minLength: 3, maxLength: 256 }` — it bounds length and
+  nothing else, so a record id and a slug both pass (`CompanyInfo.slug` relaxes `minLength` to 0 on
+  top of it). `EntityValueSchema` is `@deprecated` in favour of `EntitySlugValueSchema`, the identical
+  schema it aliases; write new fields against the slug schema. What the `entity` param is expected to
+  hold is the serving side's rule, not this package's — see the `server-wl` skill.
+- `ColorSchema` accepts `#` followed by 3–8 hex digits (length 4–9), so a named CSS colour or an
+  `rgb()` string fails it. That check runs only where `CustomColorsSchema` or `CustomStylesSchema` is
+  actually applied — this package's own entrypoint filter validates the path params alone, so a
+  package that stores styles must put the schema in its own filter or run it itself.
+- `CustomStylesSchema` requires only `font` and `colors`, while the `CustomStyles` type also requires
+  `entityId`. Construct the record from the type — an object that satisfies the schema can still be
+  missing the id every provider keys on.
+- Colours and fonts are all optional except `primaryColor` and `fontFamily` — a consumer must render
+  with whatever subset it gets rather than assuming a full palette.
 
 ## Depends On
 
-- `@owlmeans/entrypoint`, `@owlmeans/route`, `@owlmeans/auth-common`
+- `@owlmeans/entrypoint`, `@owlmeans/route`, `@owlmeans/auth`
+- `ajv` (peer)
+
+Server side elevates the declaration through `@owlmeans/server-wl`; browser side through
+`@owlmeans/web-wl`.

package/build/entrypoints.d.ts

@@ -0,0 +1,2 @@
+export declare const entrypoints: import("@owlmeans/entrypoint").CommonEntrypoint[];
+//# 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,mDAKvB,CAAA"}

package/build/{modules.js → entrypoints.js}

@@ -2,7 +2,7 @@ import { filter, entrypoint, params } from '@owlmeans/entrypoint';
 import { route, backend } from '@owlmeans/route';
 import { WL_PROVIDE, WL_PROVIDE_PATH } from './consts.js';
 import { ProvideParamsSchema } from './model/provider.js';
-export const modules = [
+export const entrypoints = [
     entrypoint(route(WL_PROVIDE, WL_PROVIDE_PATH, backend()), filter(params(ProvideParamsSchema)))
 ];
-//# sourceMappingURL=modules.js.map
+//# sourceMappingURL=entrypoints.js.map

package/build/entrypoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entrypoints.js","sourceRoot":"","sources":["../src/entrypoints.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AACjE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAEzD,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,UAAU,CACR,KAAK,CAAC,UAAU,EAAE,eAAe,EAAE,OAAO,EAAE,CAAC,EAC7C,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,CACpC;CACF,CAAA"}

package/build/index.d.ts

@@ -1,5 +1,5 @@
 export type * from './types.js';
 export * from './model/index.js';
 export * from './consts.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,kBAAkB,CAAA;AAChC,cAAc,aAAa,CAAA;AAC3B,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;AAChC,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA"}

package/build/index.js

@@ -1,4 +1,4 @@
 export * from './model/index.js';
 export * from './consts.js';
-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,kBAAkB,CAAA;AAChC,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,kBAAkB,CAAA;AAChC,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/wled",
-  "version": "0.1.18-rc.1",
+  "version": "0.1.18-rc.11",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -24,9 +24,9 @@
     "ajv": "*"
   },
   "dependencies": {
-    "@owlmeans/auth": "^0.1.18-rc.1",
-    "@owlmeans/entrypoint": "^0.1.18-rc.1",
-    "@owlmeans/route": "^0.1.18-rc.1"
+    "@owlmeans/auth": "^0.1.18-rc.9",
+    "@owlmeans/entrypoint": "^0.1.18-rc.11",
+    "@owlmeans/route": "^0.1.18-rc.9"
   },
   "devDependencies": {
     "@owlmeans/dep-config": "workspace:*",

package/src/{modules.ts → entrypoints.ts}

@@ -3,7 +3,7 @@ import { route, backend } from '@owlmeans/route'
 import { WL_PROVIDE, WL_PROVIDE_PATH } from './consts.js'
 import { ProvideParamsSchema } from './model/provider.js'
 
-export const modules = [
+export const entrypoints = [
   entrypoint(
     route(WL_PROVIDE, WL_PROVIDE_PATH, backend()),
     filter(params(ProvideParamsSchema))

package/src/index.ts

@@ -2,4 +2,4 @@
 export type * from './types.js'
 export * from './model/index.js'
 export * from './consts.js'
-export * from './modules.js'
+export * from './entrypoints.js'

package/build/modules.d.ts

@@ -1,2 +0,0 @@
-export declare const modules: import("@owlmeans/entrypoint").CommonEntrypoint[];
-//# 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":"AAKA,eAAO,MAAM,OAAO,mDAKnB,CAAA"}

package/build/modules.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"modules.js","sourceRoot":"","sources":["../src/modules.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AACjE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAEzD,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,UAAU,CACR,KAAK,CAAC,UAAU,EAAE,eAAe,EAAE,OAAO,EAAE,CAAC,EAC7C,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,CACpC;CACF,CAAA"}