@cavuno/board 4.47.0 → 4.49.0

package/dist/{jobs-CIrTcMjw.d.ts → jobs-DsO3htwV.d.mts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-DHa5r3B0.js';
+import { S as Schemas } from './_spec-DiQvT7IN.mjs';
 
 /**
  * Optional pagination metadata returned by Board API list operations.
@@ -114,6 +114,14 @@ type JobsListQuery = {
      * jobs in the place itself. Ignored for region and country places.
      */
     radius?: number;
+    /**
+     * With `location` and no `radius`: widen a city or locality to the market
+     * default distance (25 mi in the US, GB, LR and MM; 50 km elsewhere),
+     * computed from the resolved place. Regions and countries are not
+     * widened; an explicit `radius` wins. Saves resolving the place first to
+     * pick the radius.
+     */
+    defaultRadius?: boolean;
     /** Category slug seed (the `/jobs/[keyword]` page) — server resolves it to the English source name; unresolvable → 404. */
     category?: string;
     /** Skill slug seed (the `/jobs/skills/[skill]` page) — server-resolved; unresolvable → 404. */
@@ -121,6 +129,20 @@ type JobsListQuery = {
     /** Sparse fieldset (Medusa-style `+field`). Only `'+description'` is supported — adds `description` to each card. */
     fields?: string;
 };
+/**
+ * An opt-in capability token for `jobs.retrieve`. `apply-gateway-v1` selects
+ * the country-gated Apply shape (opaque Sponsored Apply).
+ */
+type JobCapability = 'apply-gateway-v1';
+type JobRetrieveQuery = {
+    /**
+     * Capability opt-ins, sent as the `capabilities` query parameter. Same
+     * effect as the `x-cavuno-board-capabilities` header, but the response
+     * stays shared-cacheable under its own URL; the header form is never
+     * cached.
+     */
+    capabilities?: JobCapability[];
+};
 type JobsSimilarQuery = {
     /** How many similar jobs to return (1–20; default 5). */
     limit?: number;
@@ -143,4 +165,4 @@ type ObjectReferenceFilter = {
  */
 type JobsSearchBody = Schemas['PublicSearchJobsBody'];
 
-export type { CustomFieldValues as C, EmploymentType as E, JobSort as J, ListEnvelope as L, ObjectReferenceFilter as O, PublicJob as P, RemoteOption as R, Seniority as S, CustomFieldFilter as a, JobCollectionChoiceQuery as b, JobsListQuery as c, JobCardListEnvelope as d, JobsSearchBody as e, JobCardSearchEnvelope as f, JobsSimilarQuery as g, SearchEnvelope as h, CustomFieldValue as i, CustomFilterValue as j, EducationRequirement as k, JobCatalogPagination as l, JobCollectionChoiceList as m, JobCollectionFieldDefinition as n, JobCompany as o, JobCustomEmploymentType as p, OfficeLocation as q, OffsetPagination as r, PublicJobCard as s, RelatedSearch as t, RemotePermit as u, RemoteTimezone as v, ResolvedJobCollectionField as w, StorefrontPagination as x };
+export type { CustomFieldValues as C, EmploymentType as E, JobSort as J, ListEnvelope as L, ObjectReferenceFilter as O, PublicJob as P, RemoteOption as R, Seniority as S, CustomFieldFilter as a, JobCollectionChoiceQuery as b, JobsListQuery as c, JobCardListEnvelope as d, JobRetrieveQuery as e, JobsSearchBody as f, JobCardSearchEnvelope as g, JobsSimilarQuery as h, SearchEnvelope as i, CustomFieldValue as j, CustomFilterValue as k, EducationRequirement as l, JobCapability as m, JobCatalogPagination as n, JobCollectionChoiceList as o, JobCollectionFieldDefinition as p, JobCompany as q, JobCustomEmploymentType as r, OfficeLocation as s, OffsetPagination as t, PublicJobCard as u, RelatedSearch as v, RemotePermit as w, RemoteTimezone as x, ResolvedJobCollectionField as y, StorefrontPagination as z };

package/dist/paths.d.mts

@@ -134,6 +134,11 @@ declare function blogAuthorPath(authorSlug: string): string;
  * Only the handle is encoded.
  */
 declare function talentProfilePath(handle: string): string;
+/**
+ * Talent location page (`/talent/locations/<place>`): the candidates who live
+ * in a place. Pass the place's `canonicalSlug` from the talent place list.
+ */
+declare function talentLocationPath(placeSlug: string): string;
 /**
  * Static top-level board paths (indexed marketing + index surfaces). Kept
  * here so the sitemap and consumers share one definition of the chrome
@@ -155,6 +160,7 @@ declare const BOARD_PATHS: {
     readonly cookiePolicy: "/cookie-policy";
     readonly impressum: "/impressum";
     readonly talent: "/talent";
+    readonly talentLocations: "/talent/locations";
     readonly employers: "/employers";
     /**
      * Alert-email surfaces. Promoted out of raw literals in
@@ -188,4 +194,4 @@ declare function goAlertsConfirmPath(): string;
  */
 declare function boardUrl(origin: string, path: string): string;
 
-export { BOARD_PATHS, type SuggestionPathInput, type SuggestionPathOptions, type SuggestionPathScope, blogAuthorPath, blogPostPath, blogTagPath, boardUrl, companyMarketPath, companyPath, companySalaryPath, encodePathSegment, goAlertsConfirmPath, goAlertsManagePath, goJobPath, jobDetailPath, jobsCategoryPath, jobsLocationCategoryPath, jobsLocationPath, jobsLocationSkillPath, jobsSkillPath, salaryLocationPath, salarySkillPath, salaryTitlePath, suggestionPath, talentProfilePath };
+export { BOARD_PATHS, type SuggestionPathInput, type SuggestionPathOptions, type SuggestionPathScope, blogAuthorPath, blogPostPath, blogTagPath, boardUrl, companyMarketPath, companyPath, companySalaryPath, encodePathSegment, goAlertsConfirmPath, goAlertsManagePath, goJobPath, jobDetailPath, jobsCategoryPath, jobsLocationCategoryPath, jobsLocationPath, jobsLocationSkillPath, jobsSkillPath, salaryLocationPath, salarySkillPath, salaryTitlePath, suggestionPath, talentLocationPath, talentProfilePath };

package/dist/paths.d.ts

@@ -134,6 +134,11 @@ declare function blogAuthorPath(authorSlug: string): string;
  * Only the handle is encoded.
  */
 declare function talentProfilePath(handle: string): string;
+/**
+ * Talent location page (`/talent/locations/<place>`): the candidates who live
+ * in a place. Pass the place's `canonicalSlug` from the talent place list.
+ */
+declare function talentLocationPath(placeSlug: string): string;
 /**
  * Static top-level board paths (indexed marketing + index surfaces). Kept
  * here so the sitemap and consumers share one definition of the chrome
@@ -155,6 +160,7 @@ declare const BOARD_PATHS: {
     readonly cookiePolicy: "/cookie-policy";
     readonly impressum: "/impressum";
     readonly talent: "/talent";
+    readonly talentLocations: "/talent/locations";
     readonly employers: "/employers";
     /**
      * Alert-email surfaces. Promoted out of raw literals in
@@ -188,4 +194,4 @@ declare function goAlertsConfirmPath(): string;
  */
 declare function boardUrl(origin: string, path: string): string;
 
-export { BOARD_PATHS, type SuggestionPathInput, type SuggestionPathOptions, type SuggestionPathScope, blogAuthorPath, blogPostPath, blogTagPath, boardUrl, companyMarketPath, companyPath, companySalaryPath, encodePathSegment, goAlertsConfirmPath, goAlertsManagePath, goJobPath, jobDetailPath, jobsCategoryPath, jobsLocationCategoryPath, jobsLocationPath, jobsLocationSkillPath, jobsSkillPath, salaryLocationPath, salarySkillPath, salaryTitlePath, suggestionPath, talentProfilePath };
+export { BOARD_PATHS, type SuggestionPathInput, type SuggestionPathOptions, type SuggestionPathScope, blogAuthorPath, blogPostPath, blogTagPath, boardUrl, companyMarketPath, companyPath, companySalaryPath, encodePathSegment, goAlertsConfirmPath, goAlertsManagePath, goJobPath, jobDetailPath, jobsCategoryPath, jobsLocationCategoryPath, jobsLocationPath, jobsLocationSkillPath, jobsSkillPath, salaryLocationPath, salarySkillPath, salaryTitlePath, suggestionPath, talentLocationPath, talentProfilePath };

package/dist/paths.js

@@ -42,6 +42,7 @@ __export(paths_exports, {
   salarySkillPath: () => salarySkillPath,
   salaryTitlePath: () => salaryTitlePath,
   suggestionPath: () => suggestionPath,
+  talentLocationPath: () => talentLocationPath,
   talentProfilePath: () => talentProfilePath
 });
 module.exports = __toCommonJS(paths_exports);
@@ -131,6 +132,9 @@ function blogAuthorPath(authorSlug) {
 function talentProfilePath(handle) {
   return `/p/${encodePathSegment(handle)}`;
 }
+function talentLocationPath(placeSlug) {
+  return `/talent/locations/${encodePathSegment(placeSlug)}`;
+}
 var BOARD_PATHS = {
   home: "/",
   jobs: "/jobs",
@@ -147,6 +151,7 @@ var BOARD_PATHS = {
   cookiePolicy: "/cookie-policy",
   impressum: "/impressum",
   talent: "/talent",
+  talentLocations: "/talent/locations",
   employers: "/employers",
   /**
    * Alert-email surfaces. Promoted out of raw literals in

package/dist/paths.mjs

@@ -21,8 +21,9 @@ import {
   salarySkillPath,
   salaryTitlePath,
   suggestionPath,
+  talentLocationPath,
   talentProfilePath
-} from "./chunk-XXQCESMU.mjs";
+} from "./chunk-JFDWTTOQ.mjs";
 export {
   BOARD_PATHS,
   blogAuthorPath,
@@ -46,5 +47,6 @@ export {
   salarySkillPath,
   salaryTitlePath,
   suggestionPath,
+  talentLocationPath,
   talentProfilePath
 };

package/dist/route-contract.js

@@ -119,6 +119,7 @@ var BOARD_PATHS = {
   cookiePolicy: "/cookie-policy",
   impressum: "/impressum",
   talent: "/talent",
+  talentLocations: "/talent/locations",
   employers: "/employers",
   /**
    * Alert-email surfaces. Promoted out of raw literals in

package/dist/route-contract.mjs

@@ -26,8 +26,8 @@ import {
   parseTanStackRoutes,
   sameParamSet,
   validateManifest
-} from "./chunk-5KCWHENV.mjs";
-import "./chunk-XXQCESMU.mjs";
+} from "./chunk-2KD2CWFL.mjs";
+import "./chunk-JFDWTTOQ.mjs";
 export {
   ALL_ROLES,
   CANONICAL_MANIFEST,

package/dist/{search-666oDd7H.d.ts → search-C3DpF31i.d.ts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-DHa5r3B0.js';
+import { S as Schemas } from './_spec-DiQvT7IN.js';
 
 type Awaitable<T> = T | Promise<T>;
 /**

package/dist/{search-DBQApXN1.d.mts → search-g3oH9aPu.d.mts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-DHa5r3B0.mjs';
+import { S as Schemas } from './_spec-DiQvT7IN.mjs';
 
 type Awaitable<T> = T | Promise<T>;
 /**

package/dist/{seo-ynqiQmby.d.ts → seo-BOPoZApt.d.ts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-DHa5r3B0.js';
+import { S as Schemas } from './_spec-DiQvT7IN.js';
 
 /**
  * The public SEO-infra payload (`board.seo()`) — platform infrastructure a

package/dist/{seo-gY8y9RMw.d.mts → seo-DMpAStWc.d.mts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-DHa5r3B0.mjs';
+import { S as Schemas } from './_spec-DiQvT7IN.mjs';
 
 /**
  * The public SEO-infra payload (`board.seo()`) — platform infrastructure a

package/dist/seo-files.d.mts

@@ -1,5 +1,5 @@
-import { B as BoardSeo } from './seo-gY8y9RMw.mjs';
-import './_spec-DHa5r3B0.mjs';
+import { B as BoardSeo } from './seo-DMpAStWc.mjs';
+import './_spec-DiQvT7IN.mjs';
 
 /**
  * `@cavuno/board/seo-files` — platform-owned crawler/identity file bodies

package/dist/seo-files.d.ts

@@ -1,5 +1,5 @@
-import { B as BoardSeo } from './seo-ynqiQmby.js';
-import './_spec-DHa5r3B0.js';
+import { B as BoardSeo } from './seo-BOPoZApt.js';
+import './_spec-DiQvT7IN.js';
 
 /**
  * `@cavuno/board/seo-files` — platform-owned crawler/identity file bodies

package/dist/seo.d.mts

@@ -1,9 +1,9 @@
-import { P as PublicBlogPostSummary, B as BlogAuthorEmbed } from './blog-DylAbc0L.mjs';
-import { e as JsonLdObject } from './breadcrumbs-B6yhrHJV.mjs';
-export { A as ALL_COUNTRY_CODES, B as BreadcrumbItemInput, g as FaqItem, J as JobBreadcrumb, h as JsonLdBoard, N as NumberNotation, i as SENIORITY_ORDER, j as SalaryFaqEntry, k as SalaryJsonLdOptions, l as SalaryOccupationListOptions, b as buildJobBreadcrumbs, m as buildSalaryFaq, o as companyCategorySalaryJsonLd, p as companySalaryJsonLd, q as createBreadcrumbJsonLd, r as createJobPostingJsonLd, s as crossAxisSalaryJsonLd, t as faqJsonLd, c as formatSalaryStat, d as formatSalaryStatRange, u as itemListJsonLd, v as locationSalaryJsonLd, n as normalizeWebsiteUrl, w as skillSalaryJsonLd, x as sortBySeniority, y as titleSalaryJsonLd } from './breadcrumbs-B6yhrHJV.mjs';
-import './_spec-DHa5r3B0.mjs';
-import './board-Bpze3b50.mjs';
-import './jobs-CMK-DZg3.mjs';
+import { P as PublicBlogPostSummary, B as BlogAuthorEmbed } from './blog-DGa6Wk08.mjs';
+import { e as JsonLdObject } from './breadcrumbs-2A7uGl7p.mjs';
+export { A as ALL_COUNTRY_CODES, B as BreadcrumbItemInput, g as FaqItem, J as JobBreadcrumb, h as JsonLdBoard, N as NumberNotation, i as SENIORITY_ORDER, j as SalaryFaqEntry, k as SalaryJsonLdOptions, l as SalaryOccupationListOptions, b as buildJobBreadcrumbs, m as buildSalaryFaq, o as companyCategorySalaryJsonLd, p as companySalaryJsonLd, q as createBreadcrumbJsonLd, r as createJobPostingJsonLd, s as crossAxisSalaryJsonLd, t as faqJsonLd, c as formatSalaryStat, d as formatSalaryStatRange, u as itemListJsonLd, v as locationSalaryJsonLd, n as normalizeWebsiteUrl, w as skillSalaryJsonLd, x as sortBySeniority, y as titleSalaryJsonLd } from './breadcrumbs-2A7uGl7p.mjs';
+import './_spec-DiQvT7IN.mjs';
+import './board-DM-vktAo.mjs';
+import './jobs-DsO3htwV.mjs';
 
 /**
  * Blog structured data on the `@cavuno/board` wire types, transcribed from

package/dist/seo.d.ts

@@ -1,9 +1,9 @@
-import { P as PublicBlogPostSummary, B as BlogAuthorEmbed } from './blog-wxhB8zAH.js';
-import { e as JsonLdObject } from './breadcrumbs-15j5xvmN.js';
-export { A as ALL_COUNTRY_CODES, B as BreadcrumbItemInput, g as FaqItem, J as JobBreadcrumb, h as JsonLdBoard, N as NumberNotation, i as SENIORITY_ORDER, j as SalaryFaqEntry, k as SalaryJsonLdOptions, l as SalaryOccupationListOptions, b as buildJobBreadcrumbs, m as buildSalaryFaq, o as companyCategorySalaryJsonLd, p as companySalaryJsonLd, q as createBreadcrumbJsonLd, r as createJobPostingJsonLd, s as crossAxisSalaryJsonLd, t as faqJsonLd, c as formatSalaryStat, d as formatSalaryStatRange, u as itemListJsonLd, v as locationSalaryJsonLd, n as normalizeWebsiteUrl, w as skillSalaryJsonLd, x as sortBySeniority, y as titleSalaryJsonLd } from './breadcrumbs-15j5xvmN.js';
-import './_spec-DHa5r3B0.js';
-import './board-DHsd92Gy.js';
-import './jobs-CIrTcMjw.js';
+import { P as PublicBlogPostSummary, B as BlogAuthorEmbed } from './blog-BqUwoJRF.js';
+import { e as JsonLdObject } from './breadcrumbs-BBwMLBGL.js';
+export { A as ALL_COUNTRY_CODES, B as BreadcrumbItemInput, g as FaqItem, J as JobBreadcrumb, h as JsonLdBoard, N as NumberNotation, i as SENIORITY_ORDER, j as SalaryFaqEntry, k as SalaryJsonLdOptions, l as SalaryOccupationListOptions, b as buildJobBreadcrumbs, m as buildSalaryFaq, o as companyCategorySalaryJsonLd, p as companySalaryJsonLd, q as createBreadcrumbJsonLd, r as createJobPostingJsonLd, s as crossAxisSalaryJsonLd, t as faqJsonLd, c as formatSalaryStat, d as formatSalaryStatRange, u as itemListJsonLd, v as locationSalaryJsonLd, n as normalizeWebsiteUrl, w as skillSalaryJsonLd, x as sortBySeniority, y as titleSalaryJsonLd } from './breadcrumbs-BBwMLBGL.js';
+import './_spec-DiQvT7IN.js';
+import './board-BNJ5Bsx2.js';
+import './jobs-DQZEGLIC.js';
 
 /**
  * Blog structured data on the `@cavuno/board` wire types, transcribed from

package/dist/seo.js

@@ -199,6 +199,7 @@ var BOARD_PATHS = {
   cookiePolicy: "/cookie-policy",
   impressum: "/impressum",
   talent: "/talent",
+  talentLocations: "/talent/locations",
   employers: "/employers",
   /**
    * Alert-email surfaces. Promoted out of raw literals in
@@ -262,11 +263,11 @@ function buildJobBreadcrumbs(job) {
   ];
   let lastPlaceSlug = null;
   for (const place of job.placeHierarchy) {
-    lastPlaceSlug = place.slug;
+    lastPlaceSlug = place.canonicalSlug;
     crumbs.push({
       kind: "place",
       name: place.name,
-      path: jobsLocationPath(place.slug)
+      path: jobsLocationPath(place.canonicalSlug)
     });
   }
   const primaryCategory = job.categories[0];

package/dist/seo.mjs

@@ -17,11 +17,11 @@ import {
   skillSalaryJsonLd,
   sortBySeniority,
   titleSalaryJsonLd
-} from "./chunk-KDFKVWTZ.mjs";
+} from "./chunk-JTFUOGWE.mjs";
 import {
   boardUrl,
   jobDetailPath
-} from "./chunk-XXQCESMU.mjs";
+} from "./chunk-JFDWTTOQ.mjs";
 
 // src/seo/blog.ts
 function createBlogArticleJsonLd({

package/dist/server.d.mts

@@ -1,10 +1,10 @@
 import { BoardSdk } from './index.mjs';
-import './_spec-DHa5r3B0.mjs';
-import './search-DBQApXN1.mjs';
-import './jobs-CMK-DZg3.mjs';
-import './board-Bpze3b50.mjs';
-import './seo-gY8y9RMw.mjs';
-import './blog-DylAbc0L.mjs';
+import './_spec-DiQvT7IN.mjs';
+import './search-g3oH9aPu.mjs';
+import './jobs-DsO3htwV.mjs';
+import './board-DM-vktAo.mjs';
+import './seo-DMpAStWc.mjs';
+import './blog-DGa6Wk08.mjs';
 
 /**
  * Session cookie codec — pure (no framework imports, no node imports) so it

package/dist/server.d.ts

@@ -1,10 +1,10 @@
 import { BoardSdk } from './index.js';
-import './_spec-DHa5r3B0.js';
-import './search-666oDd7H.js';
-import './jobs-CIrTcMjw.js';
-import './board-DHsd92Gy.js';
-import './seo-ynqiQmby.js';
-import './blog-wxhB8zAH.js';
+import './_spec-DiQvT7IN.js';
+import './search-C3DpF31i.js';
+import './jobs-DQZEGLIC.js';
+import './board-BNJ5Bsx2.js';
+import './seo-BOPoZApt.js';
+import './blog-BqUwoJRF.js';
 
 /**
  * Session cookie codec — pure (no framework imports, no node imports) so it

package/dist/sitemap.d.mts

@@ -1,10 +1,10 @@
 import { BoardSdk } from './index.mjs';
-import './_spec-DHa5r3B0.mjs';
-import './search-DBQApXN1.mjs';
-import './jobs-CMK-DZg3.mjs';
-import './board-Bpze3b50.mjs';
-import './seo-gY8y9RMw.mjs';
-import './blog-DylAbc0L.mjs';
+import './_spec-DiQvT7IN.mjs';
+import './search-g3oH9aPu.mjs';
+import './jobs-DsO3htwV.mjs';
+import './board-DM-vktAo.mjs';
+import './seo-DMpAStWc.mjs';
+import './blog-DGa6Wk08.mjs';
 
 /**
  * Sitemap primitives — the pure XML + bucket-filename logic behind a board

package/dist/sitemap.d.ts

@@ -1,10 +1,10 @@
 import { BoardSdk } from './index.js';
-import './_spec-DHa5r3B0.js';
-import './search-666oDd7H.js';
-import './jobs-CIrTcMjw.js';
-import './board-DHsd92Gy.js';
-import './seo-ynqiQmby.js';
-import './blog-wxhB8zAH.js';
+import './_spec-DiQvT7IN.js';
+import './search-C3DpF31i.js';
+import './jobs-DQZEGLIC.js';
+import './board-BNJ5Bsx2.js';
+import './seo-BOPoZApt.js';
+import './blog-BqUwoJRF.js';
 
 /**
  * Sitemap primitives — the pure XML + bucket-filename logic behind a board

package/dist/sitemap.js

@@ -240,6 +240,7 @@ var BOARD_PATHS = {
   cookiePolicy: "/cookie-policy",
   impressum: "/impressum",
   talent: "/talent",
+  talentLocations: "/talent/locations",
   employers: "/employers",
   /**
    * Alert-email surfaces. Promoted out of raw literals in

package/dist/sitemap.mjs

@@ -19,7 +19,7 @@ import {
   salaryLocationPath,
   salarySkillPath,
   salaryTitlePath
-} from "./chunk-XXQCESMU.mjs";
+} from "./chunk-JFDWTTOQ.mjs";
 
 // src/sitemap/xml.ts
 var SITEMAP_BUCKETS = [

package/dist/suggest.d.mts

@@ -1,5 +1,5 @@
-import { h as SuggestionItem, b as SearchSuggestQuery, F as FetchOptions, g as SuggestResult } from './search-DBQApXN1.mjs';
-import './_spec-DHa5r3B0.mjs';
+import { h as SuggestionItem, b as SearchSuggestQuery, F as FetchOptions, g as SuggestResult } from './search-g3oH9aPu.mjs';
+import './_spec-DiQvT7IN.mjs';
 
 /**
  * `@cavuno/board/suggest` — framework-agnostic headless search-suggest

package/dist/suggest.d.ts

@@ -1,5 +1,5 @@
-import { h as SuggestionItem, b as SearchSuggestQuery, F as FetchOptions, g as SuggestResult } from './search-666oDd7H.js';
-import './_spec-DHa5r3B0.js';
+import { h as SuggestionItem, b as SearchSuggestQuery, F as FetchOptions, g as SuggestResult } from './search-C3DpF31i.js';
+import './_spec-DiQvT7IN.js';
 
 /**
  * `@cavuno/board/suggest` — framework-agnostic headless search-suggest

package/dist/well-known.js

@@ -100,6 +100,7 @@ var BOARD_PATHS = {
   cookiePolicy: "/cookie-policy",
   impressum: "/impressum",
   talent: "/talent",
+  talentLocations: "/talent/locations",
   employers: "/employers",
   /**
    * Alert-email surfaces. Promoted out of raw literals in

package/dist/well-known.mjs

@@ -1,7 +1,7 @@
 import {
   compileManifest
-} from "./chunk-5KCWHENV.mjs";
-import "./chunk-XXQCESMU.mjs";
+} from "./chunk-2KD2CWFL.mjs";
+import "./chunk-JFDWTTOQ.mjs";
 
 // src/well-known/handler.ts
 var WELL_KNOWN_CACHE_CONTROL = "public, max-age=300";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cavuno/board",
-  "version": "4.47.0",
+  "version": "4.49.0",
   "description": "Build custom job boards and careers pages with Cavuno’s TypeScript SDK.",
   "keywords": [
     "api-client",

package/skills/cavuno-board-job-alerts/SKILL.md

@@ -44,6 +44,29 @@ Only `jobFunctions`, `placeSlugs`, and `remoteOptions` filter digest delivery. S
 
 `jobFunctions` are category and skill slugs (the `slug` of a category or skill, such as `engineering` or `media-and-communication`). A digest matches a job when any entry equals one of the job's category or skill slugs. Prefer sending slugs. If you send display names or free-text keywords instead, the server slugifies each one when the alert is saved and matches it against the board's category and skill slugs, their aliases, and their board-language slugs. A display name that does not slugify to one of those (for example, a renamed category) is stored slugified and will not match, so send slugs whenever you have them. Alerts read back from the API therefore always carry slugs, so compare and display them as slugs.
 
+## Alert kinds, keywords, and anchor jobs
+
+Every alert read back from either lane carries a read-only `kind`:
+
+- `similar_job`: jobs similar to the job the visitor subscribed from. Subscribe from a job page with `context: { source: 'job_detail', jobId }` (or `job_apply_dialog`). `anchorJob` is that job as `{ id, slug, title }`, kept after the job closes. It is `null` for other kinds, and for an older similar-job alert whose job has not been captured yet.
+- `search`: a board search for the alert's keywords, in `filters.query`. An older search alert can report `kind: 'search'` with `filters.query` `null`: its keyword is the single `jobFunctions` entry. When `query` is `null`, show the job functions as the alert's search instead.
+- `filters`: jobs matching the stored filters exactly.
+
+Send the query a search page ran as `filters.query` (on `board.me.alerts`, the top-level `query`), at most 200 characters after trimming. Keep sending the location and other filters alongside it.
+
+```ts snippet
+await board.jobAlerts.subscribe({
+  email: 'ada@example.com',
+  consent: true,
+  filters: { query: 'Python developer', placeSlugs: ['berlin'] },
+  context: { source: 'jobs_list' },
+});
+```
+
+A sent `query` is stored as given (trimmed), so `front-end` reads back as `front-end`. A job-page `context` without a `jobId` cannot anchor a similar-job alert; with a `query` it makes a `search` alert. A client that predates `query` and sends the search keyword as its single `jobFunctions` entry, with a search-page `context.source`, still works: the server keeps that keyword as the alert's `query`.
+
+On an update, `null` clears `query`, and omitting it keeps the stored keywords as long as `jobFunctions` are unchanged. An update never changes `kind`, except that giving a `filters` alert a `query` makes it a `search` alert. A `similar_job` alert takes no `query`: sending one, on subscribe with a job-page `context` or on an update, fails with `validation_bad_request` (400). To follow keywords instead, remove the similar-job alert and create a search alert. In alert lists, show the kind and, for similar-job alerts, link the anchor job.
+
 ## Anonymous lane: manage-token transport
 
 The read and write transports intentionally use different keys:
@@ -94,16 +117,19 @@ const { data: alerts } = await board.me.alerts.list();
 alerts[0]?.isActive;
 alerts[0]?.lastSentAt;
 alerts[0]?.filters;
+alerts[0]?.kind;
+alerts[0]?.anchorJob;
 
 const alert = await board.me.alerts.create({
   frequency: 'weekly',
-  jobFunctions: ['engineering'],
+  query: 'Platform engineer',
   remoteOptions: ['remote'],
 });
 
 const current = await board.me.alerts.retrieve(alert.id);
 await board.me.alerts.update(alert.id, {
   frequency: 'weekly',
+  query: current.filters.query,
   jobFunctions: current.filters.jobFunctions,
   seniorityLevels: current.filters.seniorityLevels,
   remoteOptions: current.filters.remoteOptions,

package/skills/cavuno-board-jobs/SKILL.md

@@ -20,9 +20,9 @@ widget uses `embed.jobs`.
 
 `JobsListQuery` accepts `limit` (1–100), `cursor`, `offset`, `companyId`,
 `companySlug`, `remoteOption`, `employmentType`, `seniority`, `location` with
-`radius` in kilometres, `category`, and `skill`. Repeated `seniority` values
-are OR-matched. `offset` takes precedence over `cursor`, so choose one paging
-mode per request.
+`radius` in kilometres or `defaultRadius`, `category`, and `skill`. Repeated
+`seniority` values are OR-matched. `offset` takes precedence over `cursor`, so
+choose one paging mode per request.
 
 ```ts snippet
 const first = await board.jobs.list({
@@ -58,6 +58,24 @@ const page = await board.jobs.list({
 });
 ```
 
+### List a location page in one request
+
+`defaultRadius: true` with a `location` and no `radius` widens a city or
+locality to the market default distance: 25 miles (40.2336 km) in the US, GB,
+LR and MM, 50 km elsewhere. Regions, countries and places without coordinates
+are not widened, and an explicit `radius` wins. The server picks the distance
+from the place it already resolves, so a location page can fetch its jobs in
+parallel with `taxonomy.places.resolve` instead of after it. `jobs.search` takes the
+same flag in `filters`.
+
+```ts snippet
+const nearby = await board.jobs.list({
+  location: 'houston-texas-united-states',
+  defaultRadius: true,
+  limit: 20,
+});
+```
+
 ## Search
 
 `jobs.search` posts `JobsSearchBody`: free-text `query`, structured `filters`,
@@ -88,6 +106,18 @@ job.company?.slug;
 const rail = await board.jobs.similar('senior-chef', { limit: 5 });
 ```
 
+A starter that renders the country-gated Apply flow opts in per request with
+`capabilities: ['apply-gateway-v1']`. The opt-in travels in the URL, so the
+response stays shared-cacheable. The older `x-cavuno-board-capabilities`
+header returns the same body but is never cached.
+
+```ts snippet
+const gated = await board.jobs.retrieve('senior-chef', {
+  capabilities: ['apply-gateway-v1'],
+});
+gated.applyAction; // 'gateway_external' | 'gateway_native' | …
+```
+
 ## Surface candidate gating
 
 On a gated board, `gatedCount` reports results withheld from the current

package/skills/cavuno-board-setup/SKILL.md

@@ -82,6 +82,19 @@ Pause with a concrete blocker when the board identifier or a required test crede
 
 **Complete when:** doctor, direct API probes, implemented-surface checks, and the production-build probe all pass or each skipped credentialed check is reported.
 
+## Reporting problems
+
+When Cavuno itself gets in the way (a missing capability, unclear or wrong documentation, a surprising response, an unhelpful error, a bug or slow performance), report it, even if you found a workaround. `POST https://api.cavuno.com/v1/feedback` accepts [Agent Feedback Protocol v0.1](https://trybackloop.com/spec/) reports without credentials; the discovery document is at `https://api.cavuno.com/.well-known/agent-feedback`.
+
+```bash
+curl https://api.cavuno.com/v1/feedback \
+  -X POST \
+  -H "Content-Type: application/json" \
+  -d '{ "type": "unclear_documentation", "goal": "What you were trying to do", "message": "What got in the way", "agent": { "name": "my-agent", "model": "model-name" } }'
+```
+
+`type`, `goal` and `message` are required; fill `agent.name` and `agent.model`. Up to 20 reports every 5 minutes. Never include credentials, `pk_…` keys, personal data or your user's private content. Send the report, then continue with the task.
+
 ## Cavuno SDK reference
 
 For setup and API details beyond this workflow, use the [Cavuno Board SDK documentation](https://cavuno.com/docs/sdk).

package/skills/cavuno-board-talent-access/SKILL.md

@@ -130,6 +130,8 @@ await board.me.conversations.start({
 
 Named `/p/{handle}` is the share bypass and always shows a full `public` profile. Opaque `/p/{id}` is the unlock-gated route. When `accessModel === 'paid_unlocks_and_messaging'`, directory cards redact for viewers who are not unlimited.
 
+`lastActive` on directory cards and profiles is a coarse bucket (`today`, `this_week`, `this_month`, `last_3_months`, `over_3_months`) for a signed-in employer looking at a candidate who is actively looking or open to offers, and `null` otherwise. It stays on redacted cards. Render it as a short label such as "Active this week" and hide it when `null`.
+
 ```ts snippet
 const named = await board.talent.retrieve('jane-doe');
 const opaque = await board.talent.retrieve('bu_candidate');

package/skills/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "4.47.0",
+  "version": "4.49.0",
   "skills": [
     {
       "name": "cavuno-board-account",