@cavuno/board 4.53.0 → 4.55.0

package/CHANGELOG.md

@@ -3,6 +3,59 @@
 This changelog records changes that affect Board API compatibility, exported
 types, runtime behavior, or supported integration patterns.
 
+## 4.55.0 — 2026-10-27
+
+- Names now come in the board's language as well as English, so a starter
+  on a translated board can show and link them without its own lookups.
+  The English `name`/`term` and `slug` are unchanged, so filters keep working.
+  - Job `skills` and `categories` (on every job card and on job detail) and
+    company `markets` carry `displayName` and `canonicalSlug`.
+  - `relatedSearches` entries on the jobs and companies lists carry
+    `displayName` and `canonicalSlug`.
+  - Link with `canonicalSlug`; it equals `slug` when a term has no
+    translation.
+- `remoteTimezones` entries on job detail carry `label`, the area or time
+  zone named in the board's language.
+- `officeLocations[].displayName` names the city and region in the board's
+  language as well as the country (for example
+  "Krefeld, Nordrhein-Westfalen, Deutschland").
+- Job cards carry `remotePermits`, the same `{ type, value }` remote scopes
+  as job detail. Continent, region and subregion entries (on cards and job
+  detail) carry an optional `code`, a UN M.49 area code that
+  `Intl.DisplayNames` with `type: 'region'` accepts (`150` for Europe), so a
+  client can name the area in any language. Build the card's remote label
+  from these and fall back to `remoteLocationLabel`.
+- `listingJsonLd` links each job by its `links.public` URL when present, so
+  boards with translated URLs publish the URL a job lives at rather than a
+  redirect.
+
+## 4.54.0 — 2026-10-27
+
+- Jobs can be ordered nearest-first. `jobs.list`, `jobs.search`,
+  `companies.listJobs` and `embed.jobs` accept `sort: 'distance'` alongside a
+  `location` (and optional `radius`); jobs without a map point come last.
+  `sort: 'distance'` without a location that resolves to coordinates returns
+  400 `sort_distance_requires_location`. `JOB_SORTS` includes `'distance'`.
+- Job cards carry `distanceKm`: kilometres from the search location, or
+  `null` when the request has no location or the job has no map point.
+  It is present on every sort, not only `distance`.
+- `talent.list` and talent-list member queries accept `sort: 'distance'`
+  with a `place`.
+- Candidates can share their stored resume with employers.
+  `board.me.resume.update({ shareWithEmployers })` turns it on or off at any
+  time without re-uploading, and `me.resume.upload` takes the same option
+  (applied only with `keepResumeOnFile: true`). `me.resume.retrieve` returns
+  the current `shareWithEmployers`.
+- `talent.retrieve` returns `resumeUrl`, an expiring signed download URL, to
+  a signed-in approved employer on the board when the candidate shares their
+  resume and has one on file; `null` otherwise. Turning sharing off stops new
+  URLs; one already issued works until it expires. Directory cards never
+  include it.
+- The jobs `location` filter can name a country or region that the board's
+  remote jobs are open to, and location search suggests those places.
+- Category and location page responses include the board's own `metaTitle`
+  and `metaDescription` when it has set them, for page 1 with no filters.
+
 ## 4.53.0 — 2026-10-21
 
 - Sponsored jobs (`isSponsored: true`) are being restricted to callers that

package/dist/{_spec-B4TxcV4W.d.mts → _spec-QzRtIJNE.d.mts}

@@ -678,10 +678,14 @@ interface components {
             companyCount: number;
         };
         CompanyMarketRef: {
-            /** @description Display name of the market. */
+            /** @description English source name of the market. */
             name: string;
             /** @description Source slug for the market. Use it as the `:market` segment of the market-scoped company browse. */
             slug: string;
+            /** @description The slug of the market's page in the board language. Equals `slug` when the market has no translation. Link market chips with this slug; the market-scoped company browse resolves it too. */
+            canonicalSlug: string;
+            /** @description The market name in the board language, for the chip label. Equals `name` when the market has no translation. */
+            displayName: string;
         };
         CompanyMember: {
             id: string;
@@ -1354,6 +1358,8 @@ interface components {
                 /** @enum {string} */
                 type: "worldwide" | "world_region" | "continent" | "region" | "subregion" | "subdivision" | "country" | "custom";
                 value: string;
+                /** @description Ignored on input. Job reads add it to some entries; send it back or leave it out. */
+                code?: string;
             }[];
             /** @description Where remote candidates must be timezone-compatible. Each entry mirrors the `remotePermits` shape (`world_region`, `continent`, `region`, `subregion`, `country`) plus `timezone` (specific IANA name with optional `plusMinus` ±N hours expansion) and `all` (every timezone: equivalent of `worldwide` for permits). The canonical `{type, value}` set is published at `GET /v1/taxonomies/remote-timezones`. **When omitted on POST**, the server auto-derives this from `remotePermits` (or `[{all,all}]` if neither was provided). **PATCH never auto-re-derives**: once set, only an explicit replacement updates the stored value, even when `remotePermits` changes. Pass `[]` to clear an existing constraint. */
             remoteTimezones?: {
@@ -1427,6 +1433,8 @@ interface components {
             remotePermits: {
                 type: string;
                 value: string;
+                /** @description UN M.49 area code of a `continent`, `region` or `subregion` entry (e.g. `"150"` for Europe, `"019"` for the Americas, `"155"` for Western Europe). It is a code `Intl.DisplayNames` with `type: "region"` accepts, so a client can name the area in any language: `new Intl.DisplayNames(["de"], { type: "region" }).of("150")` is `"Europa"`. Absent for areas without a standard code (e.g. "Central Europe"), for `world_region` and `custom` entries, and for `country` and `subdivision` entries, whose `value` is already an ISO 3166-1 alpha-2 or ISO 3166-2 code. */
+                code?: string;
             }[];
             /** @description Read-only: derived from `remotePermits`. */
             remoteWorldwide: boolean | null;
@@ -1665,6 +1673,8 @@ interface components {
                 /** @enum {string} */
                 type: "worldwide" | "world_region" | "continent" | "region" | "subregion" | "subdivision" | "country" | "custom";
                 value: string;
+                /** @description Ignored on input. Job reads add it to some entries; send it back or leave it out. */
+                code?: string;
             }[];
             /** @description Where remote candidates must be timezone-compatible. Each entry mirrors the `remotePermits` shape (`world_region`, `continent`, `region`, `subregion`, `country`) plus `timezone` (specific IANA name with optional `plusMinus` ±N hours expansion) and `all` (every timezone: equivalent of `worldwide` for permits). The canonical `{type, value}` set is published at `GET /v1/taxonomies/remote-timezones`. **When omitted on POST**, the server auto-derives this from `remotePermits` (or `[{all,all}]` if neither was provided). **PATCH never auto-re-derives**: once set, only an explicit replacement updates the stored value, even when `remotePermits` changes. Pass `[]` to clear an existing constraint. */
             remoteTimezones?: {
@@ -2709,6 +2719,8 @@ interface components {
             remotePermits: {
                 type: string;
                 value: string;
+                /** @description UN M.49 area code of a `continent`, `region` or `subregion` entry (e.g. `"150"` for Europe, `"019"` for the Americas, `"155"` for Western Europe). It is a code `Intl.DisplayNames` with `type: "region"` accepts, so a client can name the area in any language: `new Intl.DisplayNames(["de"], { type: "region" }).of("150")` is `"Europa"`. Absent for areas without a standard code (e.g. "Central Europe"), for `world_region` and `custom` entries, and for `country` and `subdivision` entries, whose `value` is already an ISO 3166-1 alpha-2 or ISO 3166-2 code. */
+                code?: string;
             }[];
             /** @description Read-only: derived from `remotePermits`. `true` only when the authored selection is a single `{type:"worldwide"}` entry. */
             remoteWorldwide: boolean | null;
@@ -2717,6 +2729,8 @@ interface components {
                 type: string;
                 value: string;
                 plusMinus?: number;
+                /** @description Display name of the entry in the board language: the country, continent, region or subregion name ("Europa"), or the time zone name ("Mitteleuropäische Zeit"). A `world_region` shows its acronym ("EMEA"; the full English name on an English board), `all` the name of the world ("Welt"), and a group without a localized name its English `value`. Render this instead of `value`. */
+                label: string;
             }[];
             /** @description Read-only: derived from `remoteTimezones`. UTC hour offsets used by the job-search index. */
             remoteAllowedTzOffsets: number[];
@@ -2743,17 +2757,29 @@ interface components {
             /** @description How often the candidate must be in-office over `inOfficePeriod`, or `null` if not specified. */
             inOfficeFrequency: number | null;
             company: components["schemas"]["JobCompany"];
-            /** @description Physical office locations associated with the job. */
+            /** @description Physical office locations associated with the job. Each `displayName` is in the board's language (city, region and country, each where a translation exists); `city`, `region` and `country` stay as stored. */
             officeLocations: components["schemas"]["JobOfficeLocation"][];
-            /** @description Resolved job categories (slug + board display name): same shape as the card; names joined server-side. Guaranteed resolvable: every emitted slug resolves via `GET /v1/boards/:identifier/categories/:slug` — consumers never need to re-verify before linking. */
+            /** @description Resolved job categories: same shape as the card; names joined server-side. Show `displayName` and link with `canonicalSlug` (board language); `name` and `slug` stay English. Guaranteed resolvable: every emitted slug resolves via `GET /v1/boards/:identifier/categories/:slug` — consumers never need to re-verify before linking. */
             categories: {
+                /** @description English source slug of the category. Accepted by the jobs `category` filter. */
                 slug: string;
+                /** @description English source name of the category. */
                 name: string;
+                /** @description The slug of the category's page in the board language. Equals `slug` when the category has no translation. Link chips with this slug. */
+                canonicalSlug: string;
+                /** @description The category name in the board language, for the chip label. Equals `name` when the category has no translation. */
+                displayName: string;
             }[];
-            /** @description Resolved job skills (slug + board display name). Guaranteed resolvable: every emitted slug resolves via `GET /v1/boards/:identifier/skills/:slug` — consumers never need to re-verify before linking. */
+            /** @description Resolved job skills. Show `displayName` and link with `canonicalSlug` (board language); `name` and `slug` stay English. Guaranteed resolvable: every emitted slug resolves via `GET /v1/boards/:identifier/skills/:slug` — consumers never need to re-verify before linking. */
             skills: {
+                /** @description English source slug of the skill. Accepted by the jobs `skill` filter. */
                 slug: string;
+                /** @description English source name of the skill. */
                 name: string;
+                /** @description The slug of the skill's page in the board language. Equals `slug` when the skill has no translation. Link chips with this slug. */
+                canonicalSlug: string;
+                /** @description The skill name in the board language, for the chip label. Equals `name` when the skill has no translation. */
+                displayName: string;
             }[];
             /** @description Place ancestor chain (country → region → city) for the breadcrumb. Link each entry with `canonicalSlug`; show `name`, which is in the board's language. `slug` stays the English source slug. */
             placeHierarchy: {
@@ -2871,6 +2897,13 @@ interface components {
             remoteWorldwide: boolean | null;
             /** @description ISO 3166-1 alpha-2 codes the remote permit selection covers (derived expansion, mirroring the job detail field of the same name). Empty for worldwide/unconstrained and non-remote jobs. */
             remoteWorkPermitCountryCodes: string[];
+            /** @description The remote scopes the employer picked, with the same entries and order as the job detail field of the same name: `[{"type":"continent","value":"Europe","code":"150"},{"type":"country","value":"DE"}]`. Build the card label in the board language from it: name a `country` from its `value` and an area from its `code` with `Intl.DisplayNames`, and fall back to `remoteLocationLabel` for entries you cannot name. `[]` for non-remote jobs and for a remote job that declares no scope. */
+            remotePermits: {
+                type: string;
+                value: string;
+                /** @description UN M.49 area code of a `continent`, `region` or `subregion` entry (e.g. `"150"` for Europe, `"019"` for the Americas, `"155"` for Western Europe). It is a code `Intl.DisplayNames` with `type: "region"` accepts, so a client can name the area in any language: `new Intl.DisplayNames(["de"], { type: "region" }).of("150")` is `"Europa"`. Absent for areas without a standard code (e.g. "Central Europe"), for `world_region` and `custom` entries, and for `country` and `subdivision` entries, whose `value` is already an ISO 3166-1 alpha-2 or ISO 3166-2 code. */
+                code?: string;
+            }[];
             salaryMin: number | null;
             salaryMax: number | null;
             salaryCurrency: string | null;
@@ -2881,6 +2914,8 @@ interface components {
             /** @description Plain-text card teaser derived from the job description (HTML stripped, first sentence / word-boundary cut). `null` when there is nothing honest to show. Always present — independent of the `?fields=+description` opt-in for the long-form HTML body. Prefer this over requesting `+description` for list/card renders. */
             summary: string | null;
             locationLabel: string | null;
+            /** @description Kilometres from the selected `location` to this job’s point. Computed at read time from the listing origin and the search hit — not stored. `null` when the listing has no origin or the job has no point. */
+            distanceKm: number | null;
             /** @description Embedded company summary, or `null` if none is attached. */
             company: {
                 slug: string;
@@ -2891,15 +2926,27 @@ interface components {
                     [key: string]: string | string[] | boolean | number;
                 };
             } | null;
-            /** @description Job categories (slug + board display name). Guaranteed resolvable: every emitted slug resolves via `GET /v1/boards/:identifier/categories/:slug`. */
+            /** @description Job categories. Show `displayName` and link with `canonicalSlug` (board language); `name` and `slug` stay English. Guaranteed resolvable: every emitted slug resolves via `GET /v1/boards/:identifier/categories/:slug`. */
             categories: {
+                /** @description English source slug of the category. Accepted by the jobs `category` filter. */
                 slug: string;
+                /** @description English source name of the category. */
                 name: string;
+                /** @description The slug of the category's page in the board language. Equals `slug` when the category has no translation. Link chips with this slug. */
+                canonicalSlug: string;
+                /** @description The category name in the board language, for the chip label. Equals `name` when the category has no translation. */
+                displayName: string;
             }[];
-            /** @description Job skills (slug + board display name). Guaranteed resolvable: every emitted slug resolves via `GET /v1/boards/:identifier/skills/:slug`. */
+            /** @description Job skills. Show `displayName` and link with `canonicalSlug` (board language); `name` and `slug` stay English. Guaranteed resolvable: every emitted slug resolves via `GET /v1/boards/:identifier/skills/:slug`. */
             skills: {
+                /** @description English source slug of the skill. Accepted by the jobs `skill` filter. */
                 slug: string;
+                /** @description English source name of the skill. */
                 name: string;
+                /** @description The slug of the skill's page in the board language. Equals `slug` when the skill has no translation. Link chips with this slug. */
+                canonicalSlug: string;
+                /** @description The skill name in the board language, for the chip label. Equals `name` when the skill has no translation. */
+                displayName: string;
             }[];
             /** @description The job's custom-field values of the select, boolean, and number types, keyed by each field's `key`; select values are option `key`s. Resolve labels via the board's `customFields.job` definitions (see `GET /v1/boards/:identifier`). Values of fields no longer defined, and removed options, are omitted; text types are only on the full job (`PublicJob`). `{}` when none. */
             customFieldValues: {
@@ -2978,10 +3025,10 @@ interface components {
             /** @description Free-text search query matched against job title and description. Up to 200 characters. */
             query?: string;
             /**
-             * @description Result ordering. `relevance` (default) ranks by search relevance with featured jobs first; `newest` orders by publish date and `salary_high` by salary (no-salary jobs last). Any explicit sort unpins featured jobs.
+             * @description Result ordering. `relevance` (default) ranks by search relevance with featured jobs first; `newest` orders by publish date, `salary_high` by salary (no-salary jobs last), and `distance` nearest-first from `filters.location` (jobs without a point last). `distance` requires a location that resolves to coordinates (`sort_distance_requires_location` otherwise). Any explicit sort unpins featured jobs.
              * @enum {string}
              */
-            sort?: "relevance" | "newest" | "salary_high";
+            sort?: "relevance" | "newest" | "salary_high" | "distance";
             /** @description Optional faceted filters to narrow search results. Multi-value filters match jobs in any of the supplied values; range filters accept `gte` and `lte` bounds. */
             filters?: {
                 /** @description Only return jobs at any of the given company IDs. Up to 10 values. */
@@ -3011,7 +3058,7 @@ interface components {
                      */
                     lte?: string;
                 };
-                /** @description Only return jobs in the place with this slug, including the places inside it (a region includes its cities). Pass `radius` to widen a city or locality to nearby jobs. A place slug from `GET /places/suggest` returns jobs within `radius` km of that place, by default a distance that suits its size. Unresolvable slugs are ignored. */
+                /** @description Only return jobs in the place with this slug, including the places inside it (a region includes its cities). The slug can also name a country or region remote jobs on the board are open to, as `GET /places?q=` suggests. Pass `radius` to widen a city or locality to nearby jobs. A place slug from `GET /places/suggest` returns jobs within `radius` km of that place, by default a distance that suits its size. Unresolvable slugs are ignored. */
                 location?: string;
                 /** @description Widen a city or locality `location` to also return jobs placed in a city or locality within this many kilometres of the place (1–250; decimals allowed, e.g. `8.05` for 5 miles). Omit for jobs in the place itself. Ignored for region and country places, and without `location`. For a place from `GET /places/suggest`, an omitted `radius` uses the place's own default distance: 15 km for a neighbourhood, 25 km for a town, 50 km for a city. */
                 radius?: number;
@@ -3077,6 +3124,10 @@ interface components {
             geo: components["schemas"]["TaxonomyGeo"];
             /** @description The board's intro for this category or location page, as sanitized HTML. Absent when the page has none. Show it on page 1 with no filters. */
             introHtml?: string;
+            /** @description The board's `<title>` for this category or location page, to use as written in place of your own title on page 1 with no filters. Absent when the board has not set one. */
+            metaTitle?: string;
+            /** @description The board's meta description for this category or location page, to use as written on page 1 with no filters. Absent when the board has not set one. */
+            metaDescription?: string;
             /** @description Present, and `true`, when a place slug resolved to a place from `GET /boards/{identifier}/places/suggest` instead of one of the board's places; absent for every other resolution. Its location page lists the jobs within the place's own default distance (pass the slug as the jobs `location` with no `radius`). Index that page only when it lists at least 5 on-site or hybrid jobs: read `count` from `GET /boards/{identifier}/jobs?location={slug}&remoteOption=on_site&remoteOption=hybrid&limit=1`, in parallel with the page's own job read, and emit `noindex, follow` below 5. Remote jobs still list on the page and count in its headline; they only do not count toward indexing. A view with an explicit `radius` stays `noindex, follow`. Only suggested places need this read. */
             suggested?: boolean;
             /** @description The breadcrumb above a suggested place, country first: its country, its region and, for a neighbourhood or suburb (`geo.placeType` `locality`), its city. Present when `suggested` is `true`, absent otherwise. Render Jobs > each ancestor > the place (`displayName`), with the same BreadcrumbList JSON-LD as for the board's own places; link an ancestor to `/jobs/locations/:canonicalSlug` only when its `canonicalSlug` is not `null`. */
@@ -3338,6 +3389,8 @@ interface components {
             parsedAt: string | null;
             keepResumeOnFile: boolean | null;
             hasResumeOnFile: boolean;
+            /** @description When true, signed-in approved employers on this board receive an expiring `resumeUrl` on `GET /talent/{handle}`. Default false. Distinct from `keepResumeOnFile` (application downloads). */
+            shareWithEmployers: boolean;
             file: {
                 /** @description Short-lived signed download URL. */
                 url: string;
@@ -3616,11 +3669,15 @@ interface components {
         StartConversationBody: {
             candidateBoardUserId: string;
             body: string;
+            /** @description Approved company whose message credits to use. Omit to retain the default company. */
+            companyId?: string;
             /** @description Optional job id. When set, this send is from that job pipeline and may auto-advance Shortlisted to Contacted. */
             job?: string;
         } | {
             candidateHandle: string;
             body: string;
+            /** @description Approved company whose message credits to use. Omit to retain the default company. */
+            companyId?: string;
             /** @description Optional job id. When set, this send is from that job pipeline and may auto-advance Shortlisted to Contacted. */
             job?: string;
         };
@@ -3715,6 +3772,8 @@ interface components {
             displayName: string | null;
             headline: string | null;
             location: string | null;
+            /** @description Kilometres from the selected `place` to this candidate’s home point. Computed at read time from the listing origin and the search hit — not stored. `null` when the listing has no origin or the candidate has no point. */
+            distanceKm: number | null;
             avatarUrl: string | null;
             /** @description Plain-text card teaser derived from `bio` (HTML stripped, first sentence / word-boundary cut). `null` when there is nothing honest to show. Prefer this over `bio` for directory/card renders; cards still lead with `headline` when present. */
             summary: string | null;
@@ -3769,7 +3828,7 @@ interface components {
             openToRelocate?: boolean;
             place?: string;
             /** @enum {string} */
-            sort?: "relevance" | "newest";
+            sort?: "relevance" | "newest" | "distance";
             seniority?: string;
             permitCountry?: string;
             interestedRole?: string;
@@ -3853,6 +3912,8 @@ interface components {
              * @enum {string|null}
              */
             lastActive: "today" | "this_week" | "this_month" | "last_3_months" | "over_3_months" | null;
+            /** @description Expiring signed download URL for the candidate’s stored resume. Only returned to a signed-in approved employer on this board, and only when the candidate opted in to share it with employers and a file is on file; `null` otherwise. Turning sharing off stops new URLs; a URL already issued works until it expires. Never present on directory cards. */
+            resumeUrl: string | null;
         };
         TalentUnlock: {
             /** @enum {string} */
@@ -4161,6 +4222,10 @@ interface components {
             label?: string;
             hidden?: boolean;
         };
+        UpdateResumeBody: {
+            /** @description When true, signed-in approved employers on this board receive an expiring `resumeUrl` on `GET /talent/{handle}`. Distinct from `keepResumeOnFile`. */
+            shareWithEmployers: boolean;
+        };
         UpdateSkillsBody: {
             skills: string[];
         };

package/dist/{_spec-B4TxcV4W.d.ts → _spec-QzRtIJNE.d.ts}

@@ -678,10 +678,14 @@ interface components {
             companyCount: number;
         };
         CompanyMarketRef: {
-            /** @description Display name of the market. */
+            /** @description English source name of the market. */
             name: string;
             /** @description Source slug for the market. Use it as the `:market` segment of the market-scoped company browse. */
             slug: string;
+            /** @description The slug of the market's page in the board language. Equals `slug` when the market has no translation. Link market chips with this slug; the market-scoped company browse resolves it too. */
+            canonicalSlug: string;
+            /** @description The market name in the board language, for the chip label. Equals `name` when the market has no translation. */
+            displayName: string;
         };
         CompanyMember: {
             id: string;
@@ -1354,6 +1358,8 @@ interface components {
                 /** @enum {string} */
                 type: "worldwide" | "world_region" | "continent" | "region" | "subregion" | "subdivision" | "country" | "custom";
                 value: string;
+                /** @description Ignored on input. Job reads add it to some entries; send it back or leave it out. */
+                code?: string;
             }[];
             /** @description Where remote candidates must be timezone-compatible. Each entry mirrors the `remotePermits` shape (`world_region`, `continent`, `region`, `subregion`, `country`) plus `timezone` (specific IANA name with optional `plusMinus` ±N hours expansion) and `all` (every timezone: equivalent of `worldwide` for permits). The canonical `{type, value}` set is published at `GET /v1/taxonomies/remote-timezones`. **When omitted on POST**, the server auto-derives this from `remotePermits` (or `[{all,all}]` if neither was provided). **PATCH never auto-re-derives**: once set, only an explicit replacement updates the stored value, even when `remotePermits` changes. Pass `[]` to clear an existing constraint. */
             remoteTimezones?: {
@@ -1427,6 +1433,8 @@ interface components {
             remotePermits: {
                 type: string;
                 value: string;
+                /** @description UN M.49 area code of a `continent`, `region` or `subregion` entry (e.g. `"150"` for Europe, `"019"` for the Americas, `"155"` for Western Europe). It is a code `Intl.DisplayNames` with `type: "region"` accepts, so a client can name the area in any language: `new Intl.DisplayNames(["de"], { type: "region" }).of("150")` is `"Europa"`. Absent for areas without a standard code (e.g. "Central Europe"), for `world_region` and `custom` entries, and for `country` and `subdivision` entries, whose `value` is already an ISO 3166-1 alpha-2 or ISO 3166-2 code. */
+                code?: string;
             }[];
             /** @description Read-only: derived from `remotePermits`. */
             remoteWorldwide: boolean | null;
@@ -1665,6 +1673,8 @@ interface components {
                 /** @enum {string} */
                 type: "worldwide" | "world_region" | "continent" | "region" | "subregion" | "subdivision" | "country" | "custom";
                 value: string;
+                /** @description Ignored on input. Job reads add it to some entries; send it back or leave it out. */
+                code?: string;
             }[];
             /** @description Where remote candidates must be timezone-compatible. Each entry mirrors the `remotePermits` shape (`world_region`, `continent`, `region`, `subregion`, `country`) plus `timezone` (specific IANA name with optional `plusMinus` ±N hours expansion) and `all` (every timezone: equivalent of `worldwide` for permits). The canonical `{type, value}` set is published at `GET /v1/taxonomies/remote-timezones`. **When omitted on POST**, the server auto-derives this from `remotePermits` (or `[{all,all}]` if neither was provided). **PATCH never auto-re-derives**: once set, only an explicit replacement updates the stored value, even when `remotePermits` changes. Pass `[]` to clear an existing constraint. */
             remoteTimezones?: {
@@ -2709,6 +2719,8 @@ interface components {
             remotePermits: {
                 type: string;
                 value: string;
+                /** @description UN M.49 area code of a `continent`, `region` or `subregion` entry (e.g. `"150"` for Europe, `"019"` for the Americas, `"155"` for Western Europe). It is a code `Intl.DisplayNames` with `type: "region"` accepts, so a client can name the area in any language: `new Intl.DisplayNames(["de"], { type: "region" }).of("150")` is `"Europa"`. Absent for areas without a standard code (e.g. "Central Europe"), for `world_region` and `custom` entries, and for `country` and `subdivision` entries, whose `value` is already an ISO 3166-1 alpha-2 or ISO 3166-2 code. */
+                code?: string;
             }[];
             /** @description Read-only: derived from `remotePermits`. `true` only when the authored selection is a single `{type:"worldwide"}` entry. */
             remoteWorldwide: boolean | null;
@@ -2717,6 +2729,8 @@ interface components {
                 type: string;
                 value: string;
                 plusMinus?: number;
+                /** @description Display name of the entry in the board language: the country, continent, region or subregion name ("Europa"), or the time zone name ("Mitteleuropäische Zeit"). A `world_region` shows its acronym ("EMEA"; the full English name on an English board), `all` the name of the world ("Welt"), and a group without a localized name its English `value`. Render this instead of `value`. */
+                label: string;
             }[];
             /** @description Read-only: derived from `remoteTimezones`. UTC hour offsets used by the job-search index. */
             remoteAllowedTzOffsets: number[];
@@ -2743,17 +2757,29 @@ interface components {
             /** @description How often the candidate must be in-office over `inOfficePeriod`, or `null` if not specified. */
             inOfficeFrequency: number | null;
             company: components["schemas"]["JobCompany"];
-            /** @description Physical office locations associated with the job. */
+            /** @description Physical office locations associated with the job. Each `displayName` is in the board's language (city, region and country, each where a translation exists); `city`, `region` and `country` stay as stored. */
             officeLocations: components["schemas"]["JobOfficeLocation"][];
-            /** @description Resolved job categories (slug + board display name): same shape as the card; names joined server-side. Guaranteed resolvable: every emitted slug resolves via `GET /v1/boards/:identifier/categories/:slug` — consumers never need to re-verify before linking. */
+            /** @description Resolved job categories: same shape as the card; names joined server-side. Show `displayName` and link with `canonicalSlug` (board language); `name` and `slug` stay English. Guaranteed resolvable: every emitted slug resolves via `GET /v1/boards/:identifier/categories/:slug` — consumers never need to re-verify before linking. */
             categories: {
+                /** @description English source slug of the category. Accepted by the jobs `category` filter. */
                 slug: string;
+                /** @description English source name of the category. */
                 name: string;
+                /** @description The slug of the category's page in the board language. Equals `slug` when the category has no translation. Link chips with this slug. */
+                canonicalSlug: string;
+                /** @description The category name in the board language, for the chip label. Equals `name` when the category has no translation. */
+                displayName: string;
             }[];
-            /** @description Resolved job skills (slug + board display name). Guaranteed resolvable: every emitted slug resolves via `GET /v1/boards/:identifier/skills/:slug` — consumers never need to re-verify before linking. */
+            /** @description Resolved job skills. Show `displayName` and link with `canonicalSlug` (board language); `name` and `slug` stay English. Guaranteed resolvable: every emitted slug resolves via `GET /v1/boards/:identifier/skills/:slug` — consumers never need to re-verify before linking. */
             skills: {
+                /** @description English source slug of the skill. Accepted by the jobs `skill` filter. */
                 slug: string;
+                /** @description English source name of the skill. */
                 name: string;
+                /** @description The slug of the skill's page in the board language. Equals `slug` when the skill has no translation. Link chips with this slug. */
+                canonicalSlug: string;
+                /** @description The skill name in the board language, for the chip label. Equals `name` when the skill has no translation. */
+                displayName: string;
             }[];
             /** @description Place ancestor chain (country → region → city) for the breadcrumb. Link each entry with `canonicalSlug`; show `name`, which is in the board's language. `slug` stays the English source slug. */
             placeHierarchy: {
@@ -2871,6 +2897,13 @@ interface components {
             remoteWorldwide: boolean | null;
             /** @description ISO 3166-1 alpha-2 codes the remote permit selection covers (derived expansion, mirroring the job detail field of the same name). Empty for worldwide/unconstrained and non-remote jobs. */
             remoteWorkPermitCountryCodes: string[];
+            /** @description The remote scopes the employer picked, with the same entries and order as the job detail field of the same name: `[{"type":"continent","value":"Europe","code":"150"},{"type":"country","value":"DE"}]`. Build the card label in the board language from it: name a `country` from its `value` and an area from its `code` with `Intl.DisplayNames`, and fall back to `remoteLocationLabel` for entries you cannot name. `[]` for non-remote jobs and for a remote job that declares no scope. */
+            remotePermits: {
+                type: string;
+                value: string;
+                /** @description UN M.49 area code of a `continent`, `region` or `subregion` entry (e.g. `"150"` for Europe, `"019"` for the Americas, `"155"` for Western Europe). It is a code `Intl.DisplayNames` with `type: "region"` accepts, so a client can name the area in any language: `new Intl.DisplayNames(["de"], { type: "region" }).of("150")` is `"Europa"`. Absent for areas without a standard code (e.g. "Central Europe"), for `world_region` and `custom` entries, and for `country` and `subdivision` entries, whose `value` is already an ISO 3166-1 alpha-2 or ISO 3166-2 code. */
+                code?: string;
+            }[];
             salaryMin: number | null;
             salaryMax: number | null;
             salaryCurrency: string | null;
@@ -2881,6 +2914,8 @@ interface components {
             /** @description Plain-text card teaser derived from the job description (HTML stripped, first sentence / word-boundary cut). `null` when there is nothing honest to show. Always present — independent of the `?fields=+description` opt-in for the long-form HTML body. Prefer this over requesting `+description` for list/card renders. */
             summary: string | null;
             locationLabel: string | null;
+            /** @description Kilometres from the selected `location` to this job’s point. Computed at read time from the listing origin and the search hit — not stored. `null` when the listing has no origin or the job has no point. */
+            distanceKm: number | null;
             /** @description Embedded company summary, or `null` if none is attached. */
             company: {
                 slug: string;
@@ -2891,15 +2926,27 @@ interface components {
                     [key: string]: string | string[] | boolean | number;
                 };
             } | null;
-            /** @description Job categories (slug + board display name). Guaranteed resolvable: every emitted slug resolves via `GET /v1/boards/:identifier/categories/:slug`. */
+            /** @description Job categories. Show `displayName` and link with `canonicalSlug` (board language); `name` and `slug` stay English. Guaranteed resolvable: every emitted slug resolves via `GET /v1/boards/:identifier/categories/:slug`. */
             categories: {
+                /** @description English source slug of the category. Accepted by the jobs `category` filter. */
                 slug: string;
+                /** @description English source name of the category. */
                 name: string;
+                /** @description The slug of the category's page in the board language. Equals `slug` when the category has no translation. Link chips with this slug. */
+                canonicalSlug: string;
+                /** @description The category name in the board language, for the chip label. Equals `name` when the category has no translation. */
+                displayName: string;
             }[];
-            /** @description Job skills (slug + board display name). Guaranteed resolvable: every emitted slug resolves via `GET /v1/boards/:identifier/skills/:slug`. */
+            /** @description Job skills. Show `displayName` and link with `canonicalSlug` (board language); `name` and `slug` stay English. Guaranteed resolvable: every emitted slug resolves via `GET /v1/boards/:identifier/skills/:slug`. */
             skills: {
+                /** @description English source slug of the skill. Accepted by the jobs `skill` filter. */
                 slug: string;
+                /** @description English source name of the skill. */
                 name: string;
+                /** @description The slug of the skill's page in the board language. Equals `slug` when the skill has no translation. Link chips with this slug. */
+                canonicalSlug: string;
+                /** @description The skill name in the board language, for the chip label. Equals `name` when the skill has no translation. */
+                displayName: string;
             }[];
             /** @description The job's custom-field values of the select, boolean, and number types, keyed by each field's `key`; select values are option `key`s. Resolve labels via the board's `customFields.job` definitions (see `GET /v1/boards/:identifier`). Values of fields no longer defined, and removed options, are omitted; text types are only on the full job (`PublicJob`). `{}` when none. */
             customFieldValues: {
@@ -2978,10 +3025,10 @@ interface components {
             /** @description Free-text search query matched against job title and description. Up to 200 characters. */
             query?: string;
             /**
-             * @description Result ordering. `relevance` (default) ranks by search relevance with featured jobs first; `newest` orders by publish date and `salary_high` by salary (no-salary jobs last). Any explicit sort unpins featured jobs.
+             * @description Result ordering. `relevance` (default) ranks by search relevance with featured jobs first; `newest` orders by publish date, `salary_high` by salary (no-salary jobs last), and `distance` nearest-first from `filters.location` (jobs without a point last). `distance` requires a location that resolves to coordinates (`sort_distance_requires_location` otherwise). Any explicit sort unpins featured jobs.
              * @enum {string}
              */
-            sort?: "relevance" | "newest" | "salary_high";
+            sort?: "relevance" | "newest" | "salary_high" | "distance";
             /** @description Optional faceted filters to narrow search results. Multi-value filters match jobs in any of the supplied values; range filters accept `gte` and `lte` bounds. */
             filters?: {
                 /** @description Only return jobs at any of the given company IDs. Up to 10 values. */
@@ -3011,7 +3058,7 @@ interface components {
                      */
                     lte?: string;
                 };
-                /** @description Only return jobs in the place with this slug, including the places inside it (a region includes its cities). Pass `radius` to widen a city or locality to nearby jobs. A place slug from `GET /places/suggest` returns jobs within `radius` km of that place, by default a distance that suits its size. Unresolvable slugs are ignored. */
+                /** @description Only return jobs in the place with this slug, including the places inside it (a region includes its cities). The slug can also name a country or region remote jobs on the board are open to, as `GET /places?q=` suggests. Pass `radius` to widen a city or locality to nearby jobs. A place slug from `GET /places/suggest` returns jobs within `radius` km of that place, by default a distance that suits its size. Unresolvable slugs are ignored. */
                 location?: string;
                 /** @description Widen a city or locality `location` to also return jobs placed in a city or locality within this many kilometres of the place (1–250; decimals allowed, e.g. `8.05` for 5 miles). Omit for jobs in the place itself. Ignored for region and country places, and without `location`. For a place from `GET /places/suggest`, an omitted `radius` uses the place's own default distance: 15 km for a neighbourhood, 25 km for a town, 50 km for a city. */
                 radius?: number;
@@ -3077,6 +3124,10 @@ interface components {
             geo: components["schemas"]["TaxonomyGeo"];
             /** @description The board's intro for this category or location page, as sanitized HTML. Absent when the page has none. Show it on page 1 with no filters. */
             introHtml?: string;
+            /** @description The board's `<title>` for this category or location page, to use as written in place of your own title on page 1 with no filters. Absent when the board has not set one. */
+            metaTitle?: string;
+            /** @description The board's meta description for this category or location page, to use as written on page 1 with no filters. Absent when the board has not set one. */
+            metaDescription?: string;
             /** @description Present, and `true`, when a place slug resolved to a place from `GET /boards/{identifier}/places/suggest` instead of one of the board's places; absent for every other resolution. Its location page lists the jobs within the place's own default distance (pass the slug as the jobs `location` with no `radius`). Index that page only when it lists at least 5 on-site or hybrid jobs: read `count` from `GET /boards/{identifier}/jobs?location={slug}&remoteOption=on_site&remoteOption=hybrid&limit=1`, in parallel with the page's own job read, and emit `noindex, follow` below 5. Remote jobs still list on the page and count in its headline; they only do not count toward indexing. A view with an explicit `radius` stays `noindex, follow`. Only suggested places need this read. */
             suggested?: boolean;
             /** @description The breadcrumb above a suggested place, country first: its country, its region and, for a neighbourhood or suburb (`geo.placeType` `locality`), its city. Present when `suggested` is `true`, absent otherwise. Render Jobs > each ancestor > the place (`displayName`), with the same BreadcrumbList JSON-LD as for the board's own places; link an ancestor to `/jobs/locations/:canonicalSlug` only when its `canonicalSlug` is not `null`. */
@@ -3338,6 +3389,8 @@ interface components {
             parsedAt: string | null;
             keepResumeOnFile: boolean | null;
             hasResumeOnFile: boolean;
+            /** @description When true, signed-in approved employers on this board receive an expiring `resumeUrl` on `GET /talent/{handle}`. Default false. Distinct from `keepResumeOnFile` (application downloads). */
+            shareWithEmployers: boolean;
             file: {
                 /** @description Short-lived signed download URL. */
                 url: string;
@@ -3616,11 +3669,15 @@ interface components {
         StartConversationBody: {
             candidateBoardUserId: string;
             body: string;
+            /** @description Approved company whose message credits to use. Omit to retain the default company. */
+            companyId?: string;
             /** @description Optional job id. When set, this send is from that job pipeline and may auto-advance Shortlisted to Contacted. */
             job?: string;
         } | {
             candidateHandle: string;
             body: string;
+            /** @description Approved company whose message credits to use. Omit to retain the default company. */
+            companyId?: string;
             /** @description Optional job id. When set, this send is from that job pipeline and may auto-advance Shortlisted to Contacted. */
             job?: string;
         };
@@ -3715,6 +3772,8 @@ interface components {
             displayName: string | null;
             headline: string | null;
             location: string | null;
+            /** @description Kilometres from the selected `place` to this candidate’s home point. Computed at read time from the listing origin and the search hit — not stored. `null` when the listing has no origin or the candidate has no point. */
+            distanceKm: number | null;
             avatarUrl: string | null;
             /** @description Plain-text card teaser derived from `bio` (HTML stripped, first sentence / word-boundary cut). `null` when there is nothing honest to show. Prefer this over `bio` for directory/card renders; cards still lead with `headline` when present. */
             summary: string | null;
@@ -3769,7 +3828,7 @@ interface components {
             openToRelocate?: boolean;
             place?: string;
             /** @enum {string} */
-            sort?: "relevance" | "newest";
+            sort?: "relevance" | "newest" | "distance";
             seniority?: string;
             permitCountry?: string;
             interestedRole?: string;
@@ -3853,6 +3912,8 @@ interface components {
              * @enum {string|null}
              */
             lastActive: "today" | "this_week" | "this_month" | "last_3_months" | "over_3_months" | null;
+            /** @description Expiring signed download URL for the candidate’s stored resume. Only returned to a signed-in approved employer on this board, and only when the candidate opted in to share it with employers and a file is on file; `null` otherwise. Turning sharing off stops new URLs; a URL already issued works until it expires. Never present on directory cards. */
+            resumeUrl: string | null;
         };
         TalentUnlock: {
             /** @enum {string} */
@@ -4161,6 +4222,10 @@ interface components {
             label?: string;
             hidden?: boolean;
         };
+        UpdateResumeBody: {
+            /** @description When true, signed-in approved employers on this board receive an expiring `resumeUrl` on `GET /talent/{handle}`. Distinct from `keepResumeOnFile`. */
+            shareWithEmployers: boolean;
+        };
         UpdateSkillsBody: {
             skills: string[];
         };

package/dist/{blog-BYuzCPFi.d.mts → blog-D32ONCap.d.mts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-B4TxcV4W.mjs';
+import { S as Schemas } from './_spec-QzRtIJNE.mjs';
 
 /** Author shape embedded on posts (no `object` discriminator). */
 type BlogAuthorEmbed = Schemas['PublicBlogAuthorEmbed'];

package/dist/{blog-C1nsaLmM.d.ts → blog-DBYumoqv.d.ts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-B4TxcV4W.js';
+import { S as Schemas } from './_spec-QzRtIJNE.js';
 
 /** Author shape embedded on posts (no `object` discriminator). */
 type BlogAuthorEmbed = Schemas['PublicBlogAuthorEmbed'];

package/dist/{board-BtipyMwh.d.ts → board-BXRsEJR8.d.ts}

@@ -1,8 +1,11 @@
-import { S as Schemas } from './_spec-B4TxcV4W.js';
-import { L as ListEnvelope, v as RelatedSearch, b as CustomFieldFilter, O as ObjectReferenceFilter, a as JobCapability } from './jobs-BMJHIKTi.js';
+import { S as Schemas } from './_spec-QzRtIJNE.js';
+import { L as ListEnvelope, v as RelatedSearch, b as CustomFieldFilter, O as ObjectReferenceFilter, a as JobCapability } from './jobs-BSc8fWRd.js';
 
 type PublicCompany = Schemas['CompanyPublic'];
-/** A market (sector) a company operates in — name + its source slug. */
+/**
+ * A market (sector) a company operates in — English name + source slug, plus
+ * its board-language `displayName` and the `canonicalSlug` its page lives at.
+ */
 type CompanyMarketRef = Schemas['CompanyMarketRef'];
 /** The company DETAIL shape — `PublicCompany` plus `markets` (detail-only). */
 type PublicCompanyDetail = Schemas['CompanyPublicDetail'];

package/dist/{board-j0KFqNBp.d.mts → board-Dc9RJzZs.d.mts}

@@ -1,8 +1,11 @@
-import { S as Schemas } from './_spec-B4TxcV4W.mjs';
-import { L as ListEnvelope, v as RelatedSearch, b as CustomFieldFilter, O as ObjectReferenceFilter, a as JobCapability } from './jobs-DKo4rx45.mjs';
+import { S as Schemas } from './_spec-QzRtIJNE.mjs';
+import { L as ListEnvelope, v as RelatedSearch, b as CustomFieldFilter, O as ObjectReferenceFilter, a as JobCapability } from './jobs-Cu5SX_Yp.mjs';
 
 type PublicCompany = Schemas['CompanyPublic'];
-/** A market (sector) a company operates in — name + its source slug. */
+/**
+ * A market (sector) a company operates in — English name + source slug, plus
+ * its board-language `displayName` and the `canonicalSlug` its page lives at.
+ */
 type CompanyMarketRef = Schemas['CompanyMarketRef'];
 /** The company DETAIL shape — `PublicCompany` plus `markets` (detail-only). */
 type PublicCompanyDetail = Schemas['CompanyPublicDetail'];

package/dist/{breadcrumbs-BCEsjVMn.d.mts → breadcrumbs-CsG5emA0.d.mts}

@@ -1,5 +1,5 @@
-import { P as PublicBoard, a as CompanyCategorySalary, b as CompanySalary, L as LocationSalaryDetail, S as SkillSalaryDetail, T as TitleSalaryDetail } from './board-j0KFqNBp.mjs';
-import { P as PublicJob } from './jobs-DKo4rx45.mjs';
+import { P as PublicBoard, a as CompanyCategorySalary, b as CompanySalary, L as LocationSalaryDetail, S as SkillSalaryDetail, T as TitleSalaryDetail } from './board-Dc9RJzZs.mjs';
+import { P as PublicJob } from './jobs-Cu5SX_Yp.mjs';
 
 /**
  * Wire enum for `salaryTimeframe`. Defined here (not re-exported from any