@cavuno/board 4.36.0 → 4.39.0

package/CHANGELOG.md

@@ -3,6 +3,55 @@
 This changelog records changes that affect Board API compatibility, exported
 types, runtime behavior, or supported integration patterns.
 
+## 4.39.0 — 2026-10-06
+
+- Talent search: the `place`, `seniority`, `permitCountry` and
+  `interestedRole` filters now narrow results. Before, they were accepted but
+  ignored.
+- API key permissions are inclusive: a key with `X.manage` can also read, and
+  a key with `X.publish` can also manage and read. Existing keys gain the
+  lower levels automatically.
+
+## 4.38.0 — 2026-10-06
+
+- Company invites: `board.invites.preview({ token })` looks up a company
+  member invite before sign-in, so an invite link can open a "Join
+  <company>" page. It returns the invite's `status` (`pending`, `expired`,
+  `accepted` or `revoked`), `expiresAt` and the company's `slug`, `name` and
+  `logoUrl`. While the invite is pending it also returns the invited `email`
+  and `account` (`none`, `employer` or `candidate`), so the page can offer
+  sign-up or sign-in. An unknown token is a 404 `employer_invite_not_found`.
+
+- `board.auth.register` accepts an optional `inviteToken`. When an employer
+  registers with a pending invite sent to the same email, no verification
+  email is sent: accepting the invite with `board.me.acceptInvite` verifies
+  the address.
+
+## 4.37.0 — 2026-10-06
+
+- Job search: `radius` on `board.jobs.list`, `board.jobs.search` and the embed
+  jobs list now widens a city or locality `location` to nearby jobs within
+  that many kilometres (1–250, decimals allowed, e.g. `40.2` for 25 miles).
+  Without `radius` a location search returns jobs in the place itself, as
+  before. Region and country locations ignore `radius`. If you already send
+  `radius`, city and locality searches now include nearby jobs.
+
+- `@cavuno/board/format` adds `searchRadiusOptions(unit)` (5, 10, 25, 50, 100
+  in miles or kilometres), `defaultSearchRadius(unit)` (25 mi or 50 km) and
+  `formatDistance(value, unit)` for a search distance menu, plus distance
+  helpers for a commute field: `distanceUnitForCountry`,
+  `defaultCommuteRadiusKm`, `kmToDistanceUnit`, `distanceUnitToKm`,
+  `kmToMiles`, `milesToKm`, `MILES_COUNTRIES`, `COMMUTE_RADIUS_MIN_KM` and
+  `COMMUTE_RADIUS_MAX_KM`.
+
+- Candidate profile: `board.me.profile.update` accepts `locationId` (an id
+  from `board.locations.search`) and `commuteRadiusKm` (1–250, `null` for the
+  default). The profile returns `locationPlace`, `commuteRadiusKm` and
+  `commuteRadiusDefaultKm`. While a candidate has a home place, their
+  `countryCode` is that place's country and a sent `countryCode` is ignored.
+  Recommended jobs use the home place and commute distance for on-site and
+  hybrid jobs.
+
 ## 4.36.0 — 2026-10-06
 
 - `board.get()` returns `ads.googleConsentMessage`. It is `true` when visitors

package/dist/{_spec-C4T68Nnr.d.mts → _spec-BcXYrhOP.d.mts}

@@ -258,6 +258,8 @@ interface components {
             developmentOrigin?: string;
             /** @description Optional same-origin path to carry through the email link. */
             returnTo?: string;
+            /** @description The company member invite token, when the person is signing up from an invite link. When `role` is `employer` and it is a pending invite on this board sent to this same email, no verification email is sent: accepting the invite (`POST /boards/{identifier}/me/invites/accept`) verifies the address. Registration never accepts the invite itself. Any other token is ignored and the verification email is sent as usual. */
+            inviteToken?: string;
         };
         BoardAuthRequestMagicLinkBody: {
             audienceAttribution?: components["schemas"]["AudienceAttribution"];
@@ -535,6 +537,22 @@ interface components {
             name: string;
             proficiency: string;
         };
+        /** @description Where the candidate lives, picked from the location search. Job matches use it with `commuteRadiusKm` for on-site and hybrid jobs. `null` when the candidate has only a free-text `location`. */
+        CandidateLocationPlace: {
+            /** @description Location id, as returned by `GET /locations/search`. Send it back as `locationId` to keep the same place. */
+            id: string;
+            /** @description Full display name, e.g. `Houston, Texas, United States`. */
+            name: string;
+            /** @description ISO 3166-1 alpha-2 country code. */
+            countryCode: string;
+            region: string | null;
+            city: string | null;
+            /**
+             * @description Level of the place, as `placeType` in `GET /locations/search`. A commute radius applies only to a `city` or `locality`; a `region` or `country` matches on-site and hybrid jobs anywhere in its country. `null` for places saved before the level was recorded.
+             * @enum {string|null}
+             */
+            placeType: "country" | "region" | "city" | "locality" | null;
+        } | null;
         CandidateProfile: {
             id: string;
             /** @enum {string} */
@@ -545,6 +563,7 @@ interface components {
             handle: string | null;
             headline: string | null;
             location: string | null;
+            locationPlace: components["schemas"]["CandidateLocationPlace"];
             countryCode: string | null;
             /** @enum {string} */
             profileVisibility: "hidden" | "logged_in_only" | "public";
@@ -552,7 +571,12 @@ interface components {
             jobSearchStatus: "actively_looking" | "open_to_offers" | "not_looking";
             /** @enum {string} */
             jobSearchStatusVisibleTo: "everyone" | "employers_only";
+            /** @description Open to relocate. Widens on-site and hybrid job matches from the commute radius to the whole country the candidate lives in or holds a work permit for. */
             openToRelocate: boolean;
+            /** @description How far the candidate is willing to commute, in kilometres. Applies only when `locationPlace` is a city or locality; a region or country home matches on its country instead. `null` means the default for their country (`commuteRadiusDefaultKm`). */
+            commuteRadiusKm: number | null;
+            /** @description The commute distance used when `commuteRadiusKm` is `null`: 40 km (25 miles) where distances are shown in miles (US, GB, LR, MM), 50 km elsewhere. Use it to prefill a commute field. */
+            commuteRadiusDefaultKm: number;
         };
         CandidateSkill: {
             /** @enum {string} */
@@ -662,6 +686,30 @@ interface components {
             object: "company_member_invite_acceptance";
             companySlug: string;
         };
+        CompanyMemberInvitePreview: {
+            /** @enum {string} */
+            object: "company_member_invite_preview";
+            /**
+             * @description Where the invite stands. `pending` can still be accepted; `expired` was never accepted before `expiresAt`; `accepted` has been used; `revoked` was withdrawn by a company admin.
+             * @enum {string}
+             */
+            status: "pending" | "expired" | "accepted" | "revoked";
+            /** @description The address the invite was sent to. Only present while `status` is `pending`; `null` otherwise. Accepting requires signing in with this address. */
+            email: string | null;
+            /** @description When the invite stops being acceptable (ISO 8601). */
+            expiresAt: string;
+            /**
+             * @description Whether someone already has an account on this board with the invited address: `none` (offer sign-up), `employer` (offer sign-in), or `candidate` (the address belongs to a candidate account, which cannot join a company). Only present while `status` is `pending`; `null` otherwise.
+             * @enum {string|null}
+             */
+            account: "none" | "employer" | "candidate" | null;
+            /** @description The company the invite is for. */
+            company: {
+                slug: string;
+                name: string;
+                logoUrl: string | null;
+            };
+        };
         CompanyMembership: {
             id: string;
             /** @enum {string} */
@@ -1513,7 +1561,12 @@ interface components {
                 expiresAt: string | null;
             };
             stages: components["schemas"]["EmployerPipelineStage"][];
+            /** @description One page of applicants, newest application first. Without `limit`, a page holds up to 2000. */
             applicants: components["schemas"]["EmployerApplicant"][];
+            /** @description Whether more applicants follow this page. */
+            hasMore: boolean;
+            /** @description Pass as `cursor` to read the next page of applicants; `null` on the last page. */
+            nextCursor: string | null;
         };
         EmployerPipelineStage: {
             id: string;
@@ -2130,6 +2183,10 @@ interface components {
             /** @description Post title. */
             title: string;
         };
+        PreviewCompanyMemberInviteBody: {
+            /** @description The `token` query parameter from the invite link (`/employers/invites/accept?token=…`). */
+            token: string;
+        };
         ProfileChoiceList: {
             data: {
                 id: string;
@@ -2840,9 +2897,9 @@ interface components {
                      */
                     lte?: string;
                 };
-                /** @description Only return jobs near the place with this slug (geo radius search). Unresolvable slugs are ignored. */
+                /** @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. Unresolvable slugs are ignored. */
                 location?: string;
-                /** @description Search radius in kilometres around `location` (10–250; default 50). Ignored without `location`. */
+                /** @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`. */
                 radius?: number;
                 /** @description Public custom job fields. Clauses are AND-matched; values within a clause are OR-matched. Up to 10 clauses and 10 values per clause. */
                 customFields?: {
@@ -3834,6 +3891,9 @@ interface components {
             handle?: string;
             headline?: string;
             location?: string;
+            /** @description Where the candidate lives: an `id` from `GET /locations/search`, resolved server-side. Also sets `location` to the place name unless `location` is sent too. While the candidate has a place, `countryCode` is always that place's country. `null` removes the place and keeps `location` and the last `countryCode`. An unknown id returns `400 locations_invalid_id`; `503 locations_unavailable` while the lookup is temporarily down. Changing `location` without `locationId` removes the place. */
+            locationId?: string | null;
+            /** @description Country the candidate can work in, checked against country-limited jobs. Applies only when the candidate has no place (`locationId`): while a place is stored or sent, `countryCode` is that place's country and a sent value is ignored without an error. Without a place, `null` clears it. */
             countryCode?: string | null;
             /** @enum {string} */
             profileVisibility?: "hidden" | "logged_in_only" | "public";
@@ -3842,6 +3902,8 @@ interface components {
             /** @enum {string} */
             jobSearchStatusVisibleTo?: "everyone" | "employers_only";
             openToRelocate?: boolean;
+            /** @description How far the candidate is willing to commute, in kilometres (1–250, stored to one decimal place). `null` resets it to the default for their country. */
+            commuteRadiusKm?: number | null;
         };
         UpdateCompanyMemberRoleBody: {
             /** @enum {string} */

package/dist/{_spec-C4T68Nnr.d.ts → _spec-BcXYrhOP.d.ts}

@@ -258,6 +258,8 @@ interface components {
             developmentOrigin?: string;
             /** @description Optional same-origin path to carry through the email link. */
             returnTo?: string;
+            /** @description The company member invite token, when the person is signing up from an invite link. When `role` is `employer` and it is a pending invite on this board sent to this same email, no verification email is sent: accepting the invite (`POST /boards/{identifier}/me/invites/accept`) verifies the address. Registration never accepts the invite itself. Any other token is ignored and the verification email is sent as usual. */
+            inviteToken?: string;
         };
         BoardAuthRequestMagicLinkBody: {
             audienceAttribution?: components["schemas"]["AudienceAttribution"];
@@ -535,6 +537,22 @@ interface components {
             name: string;
             proficiency: string;
         };
+        /** @description Where the candidate lives, picked from the location search. Job matches use it with `commuteRadiusKm` for on-site and hybrid jobs. `null` when the candidate has only a free-text `location`. */
+        CandidateLocationPlace: {
+            /** @description Location id, as returned by `GET /locations/search`. Send it back as `locationId` to keep the same place. */
+            id: string;
+            /** @description Full display name, e.g. `Houston, Texas, United States`. */
+            name: string;
+            /** @description ISO 3166-1 alpha-2 country code. */
+            countryCode: string;
+            region: string | null;
+            city: string | null;
+            /**
+             * @description Level of the place, as `placeType` in `GET /locations/search`. A commute radius applies only to a `city` or `locality`; a `region` or `country` matches on-site and hybrid jobs anywhere in its country. `null` for places saved before the level was recorded.
+             * @enum {string|null}
+             */
+            placeType: "country" | "region" | "city" | "locality" | null;
+        } | null;
         CandidateProfile: {
             id: string;
             /** @enum {string} */
@@ -545,6 +563,7 @@ interface components {
             handle: string | null;
             headline: string | null;
             location: string | null;
+            locationPlace: components["schemas"]["CandidateLocationPlace"];
             countryCode: string | null;
             /** @enum {string} */
             profileVisibility: "hidden" | "logged_in_only" | "public";
@@ -552,7 +571,12 @@ interface components {
             jobSearchStatus: "actively_looking" | "open_to_offers" | "not_looking";
             /** @enum {string} */
             jobSearchStatusVisibleTo: "everyone" | "employers_only";
+            /** @description Open to relocate. Widens on-site and hybrid job matches from the commute radius to the whole country the candidate lives in or holds a work permit for. */
             openToRelocate: boolean;
+            /** @description How far the candidate is willing to commute, in kilometres. Applies only when `locationPlace` is a city or locality; a region or country home matches on its country instead. `null` means the default for their country (`commuteRadiusDefaultKm`). */
+            commuteRadiusKm: number | null;
+            /** @description The commute distance used when `commuteRadiusKm` is `null`: 40 km (25 miles) where distances are shown in miles (US, GB, LR, MM), 50 km elsewhere. Use it to prefill a commute field. */
+            commuteRadiusDefaultKm: number;
         };
         CandidateSkill: {
             /** @enum {string} */
@@ -662,6 +686,30 @@ interface components {
             object: "company_member_invite_acceptance";
             companySlug: string;
         };
+        CompanyMemberInvitePreview: {
+            /** @enum {string} */
+            object: "company_member_invite_preview";
+            /**
+             * @description Where the invite stands. `pending` can still be accepted; `expired` was never accepted before `expiresAt`; `accepted` has been used; `revoked` was withdrawn by a company admin.
+             * @enum {string}
+             */
+            status: "pending" | "expired" | "accepted" | "revoked";
+            /** @description The address the invite was sent to. Only present while `status` is `pending`; `null` otherwise. Accepting requires signing in with this address. */
+            email: string | null;
+            /** @description When the invite stops being acceptable (ISO 8601). */
+            expiresAt: string;
+            /**
+             * @description Whether someone already has an account on this board with the invited address: `none` (offer sign-up), `employer` (offer sign-in), or `candidate` (the address belongs to a candidate account, which cannot join a company). Only present while `status` is `pending`; `null` otherwise.
+             * @enum {string|null}
+             */
+            account: "none" | "employer" | "candidate" | null;
+            /** @description The company the invite is for. */
+            company: {
+                slug: string;
+                name: string;
+                logoUrl: string | null;
+            };
+        };
         CompanyMembership: {
             id: string;
             /** @enum {string} */
@@ -1513,7 +1561,12 @@ interface components {
                 expiresAt: string | null;
             };
             stages: components["schemas"]["EmployerPipelineStage"][];
+            /** @description One page of applicants, newest application first. Without `limit`, a page holds up to 2000. */
             applicants: components["schemas"]["EmployerApplicant"][];
+            /** @description Whether more applicants follow this page. */
+            hasMore: boolean;
+            /** @description Pass as `cursor` to read the next page of applicants; `null` on the last page. */
+            nextCursor: string | null;
         };
         EmployerPipelineStage: {
             id: string;
@@ -2130,6 +2183,10 @@ interface components {
             /** @description Post title. */
             title: string;
         };
+        PreviewCompanyMemberInviteBody: {
+            /** @description The `token` query parameter from the invite link (`/employers/invites/accept?token=…`). */
+            token: string;
+        };
         ProfileChoiceList: {
             data: {
                 id: string;
@@ -2840,9 +2897,9 @@ interface components {
                      */
                     lte?: string;
                 };
-                /** @description Only return jobs near the place with this slug (geo radius search). Unresolvable slugs are ignored. */
+                /** @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. Unresolvable slugs are ignored. */
                 location?: string;
-                /** @description Search radius in kilometres around `location` (10–250; default 50). Ignored without `location`. */
+                /** @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`. */
                 radius?: number;
                 /** @description Public custom job fields. Clauses are AND-matched; values within a clause are OR-matched. Up to 10 clauses and 10 values per clause. */
                 customFields?: {
@@ -3834,6 +3891,9 @@ interface components {
             handle?: string;
             headline?: string;
             location?: string;
+            /** @description Where the candidate lives: an `id` from `GET /locations/search`, resolved server-side. Also sets `location` to the place name unless `location` is sent too. While the candidate has a place, `countryCode` is always that place's country. `null` removes the place and keeps `location` and the last `countryCode`. An unknown id returns `400 locations_invalid_id`; `503 locations_unavailable` while the lookup is temporarily down. Changing `location` without `locationId` removes the place. */
+            locationId?: string | null;
+            /** @description Country the candidate can work in, checked against country-limited jobs. Applies only when the candidate has no place (`locationId`): while a place is stored or sent, `countryCode` is that place's country and a sent value is ignored without an error. Without a place, `null` clears it. */
             countryCode?: string | null;
             /** @enum {string} */
             profileVisibility?: "hidden" | "logged_in_only" | "public";
@@ -3842,6 +3902,8 @@ interface components {
             /** @enum {string} */
             jobSearchStatusVisibleTo?: "everyone" | "employers_only";
             openToRelocate?: boolean;
+            /** @description How far the candidate is willing to commute, in kilometres (1–250, stored to one decimal place). `null` resets it to the default for their country. */
+            commuteRadiusKm?: number | null;
         };
         UpdateCompanyMemberRoleBody: {
             /** @enum {string} */

package/dist/{blog-_LtV-JaY.d.ts → blog-BLLQ5H5M.d.ts}

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

package/dist/{blog-bQmqKnw2.d.mts → blog-PS7AwaF7.d.mts}

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

package/dist/{board-CRgQjnrn.d.mts → board-CK62f0G5.d.mts}

@@ -1,5 +1,5 @@
-import { S as Schemas } from './_spec-C4T68Nnr.mjs';
-import { L as ListEnvelope, t as RelatedSearch, a as CustomFieldFilter, O as ObjectReferenceFilter } from './jobs-Cg2d2oI4.mjs';
+import { S as Schemas } from './_spec-BcXYrhOP.mjs';
+import { L as ListEnvelope, t as RelatedSearch, a as CustomFieldFilter, O as ObjectReferenceFilter } from './jobs-Y9kacbM1.mjs';
 
 type PublicCompany = Schemas['CompanyPublic'];
 /** A market (sector) a company operates in — name + its source slug. */

package/dist/{board-2UfZ7fZk.d.ts → board-CTUrq9MP.d.ts}

@@ -1,5 +1,5 @@
-import { S as Schemas } from './_spec-C4T68Nnr.js';
-import { L as ListEnvelope, t as RelatedSearch, a as CustomFieldFilter, O as ObjectReferenceFilter } from './jobs-3Md7CCMl.js';
+import { S as Schemas } from './_spec-BcXYrhOP.js';
+import { L as ListEnvelope, t as RelatedSearch, a as CustomFieldFilter, O as ObjectReferenceFilter } from './jobs--rvR1CgY.js';
 
 type PublicCompany = Schemas['CompanyPublic'];
 /** A market (sector) a company operates in — name + its source slug. */

package/dist/{breadcrumbs-C_jNh4xd.d.ts → breadcrumbs-Adrx69WV.d.ts}

@@ -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-2UfZ7fZk.js';
-import { P as PublicJob } from './jobs-3Md7CCMl.js';
+import { P as PublicBoard, a as CompanyCategorySalary, b as CompanySalary, L as LocationSalaryDetail, S as SkillSalaryDetail, T as TitleSalaryDetail } from './board-CTUrq9MP.js';
+import { P as PublicJob } from './jobs--rvR1CgY.js';
 
 /**
  * Wire enum for `salaryTimeframe`. Defined here (not re-exported from any

package/dist/{breadcrumbs-f7KFSWnx.d.mts → breadcrumbs-CwSd7BN1.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-CRgQjnrn.mjs';
-import { P as PublicJob } from './jobs-Cg2d2oI4.mjs';
+import { P as PublicBoard, a as CompanyCategorySalary, b as CompanySalary, L as LocationSalaryDetail, S as SkillSalaryDetail, T as TitleSalaryDetail } from './board-CK62f0G5.mjs';
+import { P as PublicJob } from './jobs-Y9kacbM1.mjs';
 
 /**
  * Wire enum for `salaryTimeframe`. Defined here (not re-exported from any