@pipelex/sdk 0.61.0 → 0.63.0

package/README.md

@@ -179,9 +179,14 @@ const copy = await client.copyMethod(
 if (copy.outcome === "copied") console.log(copy.method.copied_from); // the original it names
 
 // The template catalog: the public methods every organization reads, in the platform's order, with
-// the categories that have a template and each card's thumbnails behind short-lived links.
+// the categories that have a template and each card's thumbnails behind short-lived links. A
+// category's `labels` name it by language tag and may lack a language, in which case a client
+// shows `label`, the English one.
 const templates = await client.listMethodTemplates({ category: "human-resources", limit: 8 });
-for (const tab of templates.categories) console.log(tab.slug, tab.label);
+for (const tab of templates.categories) console.log(tab.slug, tab.labels.fr ?? tab.label);
+// The catalog's whole list of categories, a category no template shows included.
+const { categories } = await client.listMethodCategories();
+console.log(categories.map((category) => category.slug));
 // Another organization's public method reads in a narrower shape, its latest published version
 // and no draft: `updated_at` is what tells it from one of your own.
 const first = templates.items[0];
@@ -297,8 +302,8 @@ These pages ship inside the published package, so a reader who has only installe
 | [`docs/files.md`](./docs/files.md) | An organization's files: `listFiles` and `iterateFiles`, the row, the whole record and its provenance, the query and its repeated filters, paging through filtered pages, one file and its uses, the records of an address, the rename rule, links that name the file, a zip of files and its caps, a run's files, the copy into a method's draft, and an upload recorded as a method's test file with the refusals that come with it |
 | [`docs/method-examples.md`](./docs/method-examples.md) | A method's saved examples: the create, the paged list and its iterator, the edit that raises the input revision, the latest-run write and its `recorded` or `stale` verdict, the build assistant's save and its `kept` or `created` verdict, how an integer past `Number.MAX_SAFE_INTEGER` in the inputs stays exact, and what is refused before sending |
 | [`docs/method-copy.md`](./docs/method-copy.md) | Copying a method into another organization or duplicating it: what a copy holds and the stored files it copies, the `copied` or `refused` verdict, every refusal, the copy's idempotency key, and `copied_from` |
-| [`docs/public-methods.md`](./docs/public-methods.md) | Public methods and the template catalog: `listMethodTemplates` and its iterator, the ordering, the categories and the thumbnails' links, another organization's public method read in its narrower shape, the copy of a public method, `visibility` and `categories` on a method, and the refusals a public method's publish adds |
-| [`docs/organization-branding.md`](./docs/organization-branding.md) | An organization's logos and colours: `getBranding`, which every member and API key reads, `updateOrganizationBranding`, an admin's write that sets, clears or keeps each key, and how a refused logo or colour names its slot in `errors` so a settings screen shows the sentence under it |
+| [`docs/public-methods.md`](./docs/public-methods.md) | Public methods and the template catalog: `listMethodTemplates` and its iterator, the ordering, the categories with their labels by language and `listMethodCategories`, the thumbnails' links, another organization's public method read in its narrower shape, the copy of a public method, `visibility` and `categories` on a method, and the refusals a public method's publish adds |
+| [`docs/organization-branding.md`](./docs/organization-branding.md) | An organization's logos, colours, app style and typeface, and its white-label entitlement: `getBranding`, which every member and API key reads, `updateOrganizationBranding`, a write by the `admin` or the `member` role that sets, clears or keeps each key, and how a refused logo, colour, style or typeface names its field so a settings screen shows the sentence under it |
 | [`docs/exact-integers.md`](./docs/exact-integers.md) | Which reads keep an integer past `Number.MAX_SAFE_INTEGER` exact, as a `bigint` (a run's inputs and outputs, an example's inputs), how a request body writes it back with its digits, and `parseExactJson` and `stringifyExactJson` for code showing such data as JSON text |
 | [`docs/crate-routes.md`](./docs/crate-routes.md) | `resolve`, `codegen` and `pipeIo` — the method's tree as the protocol's `files` map, with its dependencies, the normalized crate, the stamped types, and a method's I/O artifacts without a validation — and the offline `runCodegenCheck` that guards a committed tree |
 | [`docs/client-identification.md`](./docs/client-identification.md) | The `User-Agent` every API request carries, and `appInfo`, the option that puts your program's name in front of it |

package/dist/cli/script.d.ts

@@ -15,7 +15,7 @@ import type { CommandIO } from "./io.js";
  * update notice and npm 12's run notices off the script's stderr, which carries the command's
  * own lines, while npm's warnings and errors still print.
  */
-export declare const SCRIPT_RUNNER = "npx --yes --no-update-notifier --loglevel=warn @pipelex/sdk@0.61.0";
+export declare const SCRIPT_RUNNER = "npx --yes --no-update-notifier --loglevel=warn @pipelex/sdk@0.63.0";
 export declare const SCRIPT_WRITER = "@pipelex/sdk";
 export declare const SCRIPT_NEEDS = "Node 22.12 or later";
 /** Run `pipelex-sdk script` and return its exit code. */

package/dist/client.d.ts

@@ -1,7 +1,7 @@
 import type { MTHDSProtocol, ModelCategory, ModelDeck, RunOptions, StartOptions, VersionInfo } from "mthds/protocol";
 import type { CodegenRequest, CodegenResponse, CrateRouteOptions, DictPipeOutput, FormatResponse, LintResponse, ModelCheckCategory, ModelReferenceVerdict, PipeIORequest, PipeIOResponse, PipelexRunResultStart, PipelexValidateSource, PipelexValidationResult, ResolveRequest, ResolveResponse, ValidateMethodSelector } from "./models.js";
 import { type GetRunResultOptions, type RunProgress, type RunRead, type RunResults, type RunResultState, type StartAndWaitForResultOptions, type WaitForResultOptions } from "./runs.js";
-import type { BillingPortalResponse, ChangePlanResponse, CheckoutResponse, DraftFileFromFileInput, DraftFileFromFileResult, FileArchive, FileArchiveRequest, FileDetail, FileLinkTarget, FileLinksResult, FilePage, FileRecord, FileRecordList, FileRenameInput, FileSummary, GetFileQuery, GetFilesByUriOptions, InvoiceView, Membership, MembershipsResponse, OrganizationBranding, OrganizationBrandingUpdate, ListFilesQuery, ListMethodExamplesQuery, ListMethodsQuery, ListMethodTemplatesQuery, ListMethodVersionsQuery, ListRunFilesQuery, MethodCopyInput, MethodCopyResult, MethodData, MethodDeletionAccepted, MethodDetail, MethodDraftInput, MethodExample, MethodExampleAssistantSaveInput, MethodExampleAssistantSaveResult, MethodExampleCreateInput, MethodExampleLatestRunInput, MethodExampleLatestRunResult, MethodExamplePage, MethodExampleUpdateInput, MethodPage, MethodPublishInput, MethodPublishResult, MethodRenameInput, MethodSummary, MethodTemplate, MethodTemplatePage, MethodVersion, MethodVersionPage, MethodWriteInput, OnboardingSubmission, PublicMethodDetail, PipelexApiKeyCreated, PipelexApiKeyList, ListRunsQuery, RunHistoryItem, RunDetail, RunFilesPage, RunPage, PlanView, ResolvedStorageUrl, SavedMethodFile, SubscriptionResponse, UpdateRunInput, UploadGrant, UploadGrantInput, UploadInput, UploadedFile, UserProfile } from "./product-models.js";
+import type { BillingPortalResponse, ChangePlanResponse, CheckoutResponse, DraftFileFromFileInput, DraftFileFromFileResult, FileArchive, FileArchiveRequest, FileDetail, FileLinkTarget, FileLinksResult, FilePage, FileRecord, FileRecordList, FileRenameInput, FileSummary, GetFileQuery, GetFilesByUriOptions, InvoiceView, Membership, MembershipsResponse, OrganizationBranding, OrganizationBrandingUpdate, ListFilesQuery, ListMethodExamplesQuery, ListMethodsQuery, ListMethodTemplatesQuery, ListMethodVersionsQuery, ListRunFilesQuery, MethodCategoryList, MethodCopyInput, MethodCopyResult, MethodData, MethodDeletionAccepted, MethodDetail, MethodDraftInput, MethodExample, MethodExampleAssistantSaveInput, MethodExampleAssistantSaveResult, MethodExampleCreateInput, MethodExampleLatestRunInput, MethodExampleLatestRunResult, MethodExamplePage, MethodExampleUpdateInput, MethodPage, MethodPublishInput, MethodPublishResult, MethodRenameInput, MethodSummary, MethodTemplate, MethodTemplatePage, MethodVersion, MethodVersionPage, MethodWriteInput, OnboardingSubmission, PublicMethodDetail, PipelexApiKeyCreated, PipelexApiKeyList, ListRunsQuery, RunHistoryItem, RunDetail, RunFilesPage, RunPage, PlanView, ResolvedStorageUrl, SavedMethodFile, SubscriptionResponse, UpdateRunInput, UploadGrant, UploadGrantInput, UploadInput, UploadedFile, UserProfile } from "./product-models.js";
 import type { MethodTreeForms, MethodTreeLimits } from "./method-trees.js";
 import type { AppInfo } from "./user-agent.js";
 import type { WebhookDeliveryDetail, WebhookDeliveryList, WebhookReplayAccepted, WebhookReplayOptions, WebhookSecret, WebhookSecretRotateOptions } from "./webhooks.js";
@@ -996,8 +996,8 @@ export declare class PipelexApiClient implements HostedProtocolSurface {
      * unknown or malformed name serves `default`, and the page's `ordering` names the one served,
      * `null` when there is none. `category` keeps one category's templates, by slug, in the same
      * order; an unknown slug keeps none. Whatever the filter, the page's `categories` names, with its
-     * label, every category at least one template shows, in the catalog's order, so no tab drawn
-     * from it is ever empty.
+     * labels, every category at least one template shows, in the catalog's order, so no tab drawn
+     * from it is ever empty; `listMethodCategories` reads the whole list.
      *
      * Each `MethodTemplate` carries the method's id and name, its latest published version's number,
      * description and categories, its organization's display name and each thumbnail with its size
@@ -1007,17 +1007,18 @@ export declare class PipelexApiClient implements HostedProtocolSurface {
      * Pass the page's `nextCursor` back as `cursor` with the same `ordering` and `category`, which the
      * cursor does not hold; `null` is the last page. `iterateMethodTemplates` follows it for you.
      *
-     * Throws `ApiResponseError`: `422` `request.invalid` for a `limit` outside 1 to 200 or a cursor of
-     * another listing, `422` `request.malformed` for a cursor that does not decode, `500`
-     * `runtime.misconfigured` when the templates organization the deployment names has no record or
-     * a link cannot be signed, and `503` `runtime.unavailable`, safe to retry. A page whose `items`
-     * or `categories` is not an array, whose `next_cursor` or `ordering` is neither a string nor
-     * `null`, a template lacking a member a card is drawn from (a string `method_id`, `name` and
-     * `organization_name`, a `description` that is a string or `null`, a positive integer
-     * `latest_version`, an array of string `categories`, and `thumbnails` each with a string `path`,
-     * `media_type`, `sha256`, `url` and `expires_at` and a positive integer `width` and `height`), and a
-     * category without a string `slug` and `label` are an answer the SDK cannot read, thrown as an
-     * `ApiResponseError` too, its links redacted.
+     * Throws `ApiResponseError`: `403` `pipelex.org.required` without an active organization, `422`
+     * `request.invalid` for a `limit` outside 1 to 200 or a cursor of another listing, `422`
+     * `request.malformed` for a cursor that does not decode, `500` `runtime.misconfigured` when the
+     * templates organization the deployment names has no record or a link cannot be signed, and
+     * `503` `runtime.unavailable`, safe to retry. A page whose `items` or `categories` is not an
+     * array, whose `next_cursor` or `ordering` is neither a string nor `null`, a template lacking a
+     * member a card is drawn from (a string `method_id`, `name` and `organization_name`, a
+     * `description` that is a string or `null`, a positive integer `latest_version`, an array of
+     * string `categories`, and `thumbnails` each with a string `path`, `media_type`, `sha256`, `url`
+     * and `expires_at` and a positive integer `width` and `height`), and a category without a string
+     * `slug` and `label` or whose `labels` is not an object of strings are an answer the SDK cannot
+     * read, thrown as an `ApiResponseError` too, its links redacted.
      */
     listMethodTemplates(query?: ListMethodTemplatesQuery): Promise<MethodTemplatePage>;
     /**
@@ -1028,6 +1029,23 @@ export declare class PipelexApiClient implements HostedProtocolSurface {
      * read one page with `listMethodTemplates` when you need them.
      */
     iterateMethodTemplates(query?: Omit<ListMethodTemplatesQuery, "cursor">): AsyncGenerator<MethodTemplate, void, undefined>;
+    /**
+     * The catalog's whole list of categories — `GET /v1/method-categories`: every category an admin
+     * of the platform put on it, in the catalog's order, whether or not a template shows it, the same
+     * for every caller. Each `MethodCategory` carries its `slug`, the one a manifest declares, its
+     * English `label`, and its `labels` by language tag, which may lack a language the platform
+     * added after the category was stored; show `labels[locale] ?? label`.
+     *
+     * A template shows under the categories its manifest declares that are on this list, so this is
+     * the list a method's categories are picked from. `listMethodTemplates` names, on every page, only
+     * the categories some template shows, for the tabs a client draws.
+     *
+     * Throws `ApiResponseError`: `403` `pipelex.org.required` without an active organization, and
+     * `503` `runtime.unavailable`, safe to retry. An answer whose `categories` is not an array, or
+     * holds a category without a string `slug` and `label` or whose `labels` is not an object of
+     * strings, is an answer the SDK cannot read, thrown as an `ApiResponseError` too.
+     */
+    listMethodCategories(): Promise<MethodCategoryList>;
     /**
      * Read one method with its files — `GET /v1/methods/{id}`. One of the caller's organization's
      * methods answers a `MethodDetail`: its identity, its draft
@@ -1597,32 +1615,41 @@ export declare class PipelexApiClient implements HostedProtocolSurface {
     }): Promise<Membership>;
     /**
      * The branding of the caller's active organization — `GET /v1/branding`: its name, its light
-     * and dark colour sets and its two logos. Any role reads it, `runner` included, by web session
-     * or API key, so an app scaffolded from the method-app template reads its organization's
-     * branding with its own key. A personal workspace, or a team that set nothing, answers every
-     * colour and logo `null`. A logo's `uri` is a `pipelex-storage://` reference, which
-     * `resolveStorageUrl` turns into a short-lived link to its bytes.
-     *
-     * Throws `ApiResponseError`: `400` when the caller has no active organization, `404` when its
-     * row is missing, and an answer that is not a JSON object, an empty one included.
+     * and dark colour sets, its two logos, its app style and typeface, and whether it holds the
+     * white-label entitlement. Any role reads it, `runner` included, by web session or API key, so
+     * an app scaffolded from the method-app template reads its organization's branding with its own
+     * key. A personal workspace, or a team that set nothing, answers every colour and logo `null`
+     * and no style or typeface. A logo's `uri` is a `pipelex-storage://` reference, which
+     * `resolveStorageUrl` turns into a short-lived link to its bytes. An answer without `style`,
+     * `typeface` or `white_label`, as a platform that predates them sends, reads as `null`, `null`
+     * and `false`.
+     *
+     * Throws `ApiResponseError`: `403` `pipelex.org.required` when the caller has no active
+     * organization, `404` when its row is missing, and an answer that is not a JSON object, an
+     * empty one included.
      */
     getBranding(): Promise<OrganizationBranding>;
     /**
-     * Set or clear an organization's branding — `PATCH /v1/organizations/{org_id}/branding`, an
-     * admin's write to the active organization. Every key of `input` is optional: a value sets it,
-     * `null` clears it, and a key left out keeps its value (`OrganizationBrandingUpdate`), so `{}`
-     * writes nothing. A new logo is the `pipelex-storage://` URI of a file the organization uploaded
-     * on its own, which the platform reads and measures, then copies under `branding/`: the answer's
-     * `uri` is that copy, and sending it back unchanged keeps the logo. The logo a write replaces or
-     * clears is erased. Answers the branding as the write left it.
+     * Set or clear an organization's branding — `PATCH /v1/organizations/{org_id}/branding`, a
+     * write to the active organization by the `admin` or the `member` role, never a `runner`. Every
+     * key of `input` is optional: a value sets it, `null` clears it, and a key left out keeps its
+     * value (`OrganizationBrandingUpdate`), so `{}` writes nothing. A new logo is the
+     * `pipelex-storage://` URI of a file the organization uploaded on its own, which the platform
+     * reads and measures, then copies under `branding/`: the answer's `uri` is that copy, and sending
+     * it back unchanged keeps the logo. The logo a write replaces or clears is erased. A style or a
+     * typeface is an id of the shape `^[a-z0-9-]{1,32}$`, stored whether or not it names one that
+     * exists. Answers the branding as the write left it, read as `getBranding` reads it.
      *
      * Throws `RequestArgumentError` for an organization id that is empty, `.` or `..`, before any
      * request. Throws `ApiResponseError`, refusing every change of the request when it refuses one:
      * `403` `pipelex.org.mismatch` when `orgId` is not the active organization, `403`
-     * `auth.forbidden` for a caller who is not its admin, `404` `pipelex.org.not_found` for a missing
-     * organization, `409` `pipelex.org.not_manageable` for a personal workspace, which has no
-     * branding, and `422` `request.invalid` for a colour that is not `#rrggbb` or a key the body does
-     * not know. A logo's refusal names its slot in its problem's `errors`, each item's
+     * `auth.forbidden` for a runner or a caller with no recognised role, `404`
+     * `pipelex.org.not_found` for a missing organization, `409` `pipelex.org.not_manageable` for a
+     * personal workspace, which has no branding, and `422` `request.invalid` for a colour that is
+     * not `#rrggbb`, a style or a typeface of another shape, or a key the body does not know, which
+     * names the field in `location.field`: the problem's own when it refuses one field alone, each
+     * item's of its `errors` when it refuses several. `white_label` is such a key, since only
+     * Pipelex staff grant it. A logo's refusal names its slot in its problem's `errors`, each item's
      * `location.field` being `square_logo` or `wide_logo` and its `detail` the sentence to show under
      * that slot: `422` `pipelex.storage.uri_invalid` for a URI that is not a storage URI, `403`
      * `pipelex.org.mismatch` for another organization's file, and `422` `request.invalid` with an

package/dist/client.js

@@ -1943,8 +1943,8 @@ export class PipelexApiClient {
      * unknown or malformed name serves `default`, and the page's `ordering` names the one served,
      * `null` when there is none. `category` keeps one category's templates, by slug, in the same
      * order; an unknown slug keeps none. Whatever the filter, the page's `categories` names, with its
-     * label, every category at least one template shows, in the catalog's order, so no tab drawn
-     * from it is ever empty.
+     * labels, every category at least one template shows, in the catalog's order, so no tab drawn
+     * from it is ever empty; `listMethodCategories` reads the whole list.
      *
      * Each `MethodTemplate` carries the method's id and name, its latest published version's number,
      * description and categories, its organization's display name and each thumbnail with its size
@@ -1954,17 +1954,18 @@ export class PipelexApiClient {
      * Pass the page's `nextCursor` back as `cursor` with the same `ordering` and `category`, which the
      * cursor does not hold; `null` is the last page. `iterateMethodTemplates` follows it for you.
      *
-     * Throws `ApiResponseError`: `422` `request.invalid` for a `limit` outside 1 to 200 or a cursor of
-     * another listing, `422` `request.malformed` for a cursor that does not decode, `500`
-     * `runtime.misconfigured` when the templates organization the deployment names has no record or
-     * a link cannot be signed, and `503` `runtime.unavailable`, safe to retry. A page whose `items`
-     * or `categories` is not an array, whose `next_cursor` or `ordering` is neither a string nor
-     * `null`, a template lacking a member a card is drawn from (a string `method_id`, `name` and
-     * `organization_name`, a `description` that is a string or `null`, a positive integer
-     * `latest_version`, an array of string `categories`, and `thumbnails` each with a string `path`,
-     * `media_type`, `sha256`, `url` and `expires_at` and a positive integer `width` and `height`), and a
-     * category without a string `slug` and `label` are an answer the SDK cannot read, thrown as an
-     * `ApiResponseError` too, its links redacted.
+     * Throws `ApiResponseError`: `403` `pipelex.org.required` without an active organization, `422`
+     * `request.invalid` for a `limit` outside 1 to 200 or a cursor of another listing, `422`
+     * `request.malformed` for a cursor that does not decode, `500` `runtime.misconfigured` when the
+     * templates organization the deployment names has no record or a link cannot be signed, and
+     * `503` `runtime.unavailable`, safe to retry. A page whose `items` or `categories` is not an
+     * array, whose `next_cursor` or `ordering` is neither a string nor `null`, a template lacking a
+     * member a card is drawn from (a string `method_id`, `name` and `organization_name`, a
+     * `description` that is a string or `null`, a positive integer `latest_version`, an array of
+     * string `categories`, and `thumbnails` each with a string `path`, `media_type`, `sha256`, `url`
+     * and `expires_at` and a positive integer `width` and `height`), and a category without a string
+     * `slug` and `label` or whose `labels` is not an object of strings are an answer the SDK cannot
+     * read, thrown as an `ApiResponseError` too, its links redacted.
      */
     async listMethodTemplates(query = {}) {
         const search = productQuery({
@@ -2010,6 +2011,35 @@ export class PipelexApiClient {
     async *iterateMethodTemplates(query = {}) {
         yield* followCursor("listMethodTemplates", (cursor) => this.listMethodTemplates({ ...query, cursor }));
     }
+    /**
+     * The catalog's whole list of categories — `GET /v1/method-categories`: every category an admin
+     * of the platform put on it, in the catalog's order, whether or not a template shows it, the same
+     * for every caller. Each `MethodCategory` carries its `slug`, the one a manifest declares, its
+     * English `label`, and its `labels` by language tag, which may lack a language the platform
+     * added after the category was stored; show `labels[locale] ?? label`.
+     *
+     * A template shows under the categories its manifest declares that are on this list, so this is
+     * the list a method's categories are picked from. `listMethodTemplates` names, on every page, only
+     * the categories some template shows, for the tabs a client draws.
+     *
+     * Throws `ApiResponseError`: `403` `pipelex.org.required` without an active organization, and
+     * `503` `runtime.unavailable`, safe to retry. An answer whose `categories` is not an array, or
+     * holds a category without a string `slug` and `label` or whose `labels` is not an object of
+     * strings, is an answer the SDK cannot read, thrown as an `ApiResponseError` too.
+     */
+    async listMethodCategories() {
+        const endpoint = "method-categories";
+        const res = await this.requestProductAnswer("GET", endpoint, undefined);
+        const list = this.readObjectAnswer("GET", endpoint, res);
+        const { categories } = list;
+        const fault = Array.isArray(categories)
+            ? methodCategoriesFault(categories)
+            : "`categories` is not an array";
+        if (fault !== null) {
+            throw this.unreadableAnswer("GET", `/${API_PREFIX}/${endpoint}`, res, `a list of categories whose ${fault}`);
+        }
+        return list;
+    }
     /**
      * Read one method with its files — `GET /v1/methods/{id}`. One of the caller's organization's
      * methods answers a `MethodDetail`: its identity, its draft
@@ -2999,34 +3029,44 @@ export class PipelexApiClient {
     }
     /**
      * The branding of the caller's active organization — `GET /v1/branding`: its name, its light
-     * and dark colour sets and its two logos. Any role reads it, `runner` included, by web session
-     * or API key, so an app scaffolded from the method-app template reads its organization's
-     * branding with its own key. A personal workspace, or a team that set nothing, answers every
-     * colour and logo `null`. A logo's `uri` is a `pipelex-storage://` reference, which
-     * `resolveStorageUrl` turns into a short-lived link to its bytes.
-     *
-     * Throws `ApiResponseError`: `400` when the caller has no active organization, `404` when its
-     * row is missing, and an answer that is not a JSON object, an empty one included.
+     * and dark colour sets, its two logos, its app style and typeface, and whether it holds the
+     * white-label entitlement. Any role reads it, `runner` included, by web session or API key, so
+     * an app scaffolded from the method-app template reads its organization's branding with its own
+     * key. A personal workspace, or a team that set nothing, answers every colour and logo `null`
+     * and no style or typeface. A logo's `uri` is a `pipelex-storage://` reference, which
+     * `resolveStorageUrl` turns into a short-lived link to its bytes. An answer without `style`,
+     * `typeface` or `white_label`, as a platform that predates them sends, reads as `null`, `null`
+     * and `false`.
+     *
+     * Throws `ApiResponseError`: `403` `pipelex.org.required` when the caller has no active
+     * organization, `404` when its row is missing, and an answer that is not a JSON object, an
+     * empty one included.
      */
     async getBranding() {
-        return this.requestProductObject("GET", "branding");
+        const answer = await this.requestProductObject("GET", "branding");
+        return withCheckedBrandingChoices(answer);
     }
     /**
-     * Set or clear an organization's branding — `PATCH /v1/organizations/{org_id}/branding`, an
-     * admin's write to the active organization. Every key of `input` is optional: a value sets it,
-     * `null` clears it, and a key left out keeps its value (`OrganizationBrandingUpdate`), so `{}`
-     * writes nothing. A new logo is the `pipelex-storage://` URI of a file the organization uploaded
-     * on its own, which the platform reads and measures, then copies under `branding/`: the answer's
-     * `uri` is that copy, and sending it back unchanged keeps the logo. The logo a write replaces or
-     * clears is erased. Answers the branding as the write left it.
+     * Set or clear an organization's branding — `PATCH /v1/organizations/{org_id}/branding`, a
+     * write to the active organization by the `admin` or the `member` role, never a `runner`. Every
+     * key of `input` is optional: a value sets it, `null` clears it, and a key left out keeps its
+     * value (`OrganizationBrandingUpdate`), so `{}` writes nothing. A new logo is the
+     * `pipelex-storage://` URI of a file the organization uploaded on its own, which the platform
+     * reads and measures, then copies under `branding/`: the answer's `uri` is that copy, and sending
+     * it back unchanged keeps the logo. The logo a write replaces or clears is erased. A style or a
+     * typeface is an id of the shape `^[a-z0-9-]{1,32}$`, stored whether or not it names one that
+     * exists. Answers the branding as the write left it, read as `getBranding` reads it.
      *
      * Throws `RequestArgumentError` for an organization id that is empty, `.` or `..`, before any
      * request. Throws `ApiResponseError`, refusing every change of the request when it refuses one:
      * `403` `pipelex.org.mismatch` when `orgId` is not the active organization, `403`
-     * `auth.forbidden` for a caller who is not its admin, `404` `pipelex.org.not_found` for a missing
-     * organization, `409` `pipelex.org.not_manageable` for a personal workspace, which has no
-     * branding, and `422` `request.invalid` for a colour that is not `#rrggbb` or a key the body does
-     * not know. A logo's refusal names its slot in its problem's `errors`, each item's
+     * `auth.forbidden` for a runner or a caller with no recognised role, `404`
+     * `pipelex.org.not_found` for a missing organization, `409` `pipelex.org.not_manageable` for a
+     * personal workspace, which has no branding, and `422` `request.invalid` for a colour that is
+     * not `#rrggbb`, a style or a typeface of another shape, or a key the body does not know, which
+     * names the field in `location.field`: the problem's own when it refuses one field alone, each
+     * item's of its `errors` when it refuses several. `white_label` is such a key, since only
+     * Pipelex staff grant it. A logo's refusal names its slot in its problem's `errors`, each item's
      * `location.field` being `square_logo` or `wide_logo` and its `detail` the sentence to show under
      * that slot: `422` `pipelex.storage.uri_invalid` for a URI that is not a storage URI, `403`
      * `pipelex.org.mismatch` for another organization's file, and `422` `request.invalid` with an
@@ -3036,7 +3076,8 @@ export class PipelexApiClient {
      */
     async updateOrganizationBranding(orgId, input) {
         const segment = idPathSegment(orgId, "updateOrganizationBranding", ORG_ID_ARGUMENT);
-        return this.requestProductObject("PATCH", `organizations/${segment}/branding`, input);
+        const answer = await this.requestProductObject("PATCH", `organizations/${segment}/branding`, input);
+        return withCheckedBrandingChoices(answer);
     }
     /**
      * The organization's webhook signing secret — `GET /v1/organizations/{org_id}/webhook-secret`:
@@ -4593,7 +4634,10 @@ function methodTemplatesFault(items) {
     }
     return null;
 }
-/** Why the catalog's categories are not ones the SDK reads, or `null`: each a string `slug` and `label`. */
+/**
+ * Why the catalog's categories are not ones the SDK reads, or `null`: each a string `slug` and
+ * `label`, and `labels`, an object whose every value is a string.
+ */
 function methodCategoriesFault(categories) {
     for (let index = 0; index < categories.length; index += 1) {
         const category = categories[index];
@@ -4602,6 +4646,11 @@ function methodCategoriesFault(categories) {
             typeof category.label !== "string") {
             return `\`categories\` holds an entry without a string \`slug\` and \`label\`, at [${index}]`;
         }
+        const labels = category.labels;
+        if (!isPlainObject(labels) ||
+            !Object.values(labels).every((label) => typeof label === "string")) {
+            return `\`categories\` holds an entry whose \`labels\` is not an object of strings, at [${index}]`;
+        }
     }
     return null;
 }
@@ -4749,6 +4798,21 @@ function withCheckedUse(use) {
         method_version: Number.isInteger(version) || version === "draft" ? version : null,
     };
 }
+/**
+ * A branding with its `style` and `typeface` kept only when each is a string, each read as `null`
+ * otherwise, and its `white_label` read as `true` only when it is `true`: when the answer leaves a
+ * member out, as a platform that predates it does, sends `null`, or sends any other type. So each
+ * is what `OrganizationBranding` declares, never `undefined`, and anything but the entitlement
+ * itself reads as no entitlement, which keeps Pipelex's mark. The rest is returned as it came.
+ */
+function withCheckedBrandingChoices(answer) {
+    return {
+        ...answer,
+        style: typeof answer.style === "string" ? answer.style : null,
+        typeface: typeof answer.typeface === "string" ? answer.typeface : null,
+        white_label: answer.white_label === true,
+    };
+}
 /**
  * A status read with its `degradation` checked by `readRunDegradation`. Only when the read carries
  * the key, so a platform that predates it still leaves it absent; `degraded` is left as sent.