@cavuno/board 4.53.0 → 4.55.0

package/dist/index.js

@@ -405,7 +405,7 @@ async function clearSession(storage) {
 }
 
 // src/version.ts
-var SDK_VERSION = "4.53.0";
+var SDK_VERSION = "4.55.0";
 
 // src/client.ts
 function isRawBody(body) {
@@ -3204,6 +3204,7 @@ function meNamespace(client) {
         const form = new FormData();
         form.append("resume", file);
         if (opts?.keepResumeOnFile) form.append("keepResumeOnFile", "true");
+        if (opts?.shareWithEmployers) form.append("shareWithEmployers", "true");
         if (opts?.importMode) form.append("importMode", opts.importMode);
         if (opts?.confirmReplaceAll) form.append("confirmReplaceAll", "true");
         return client.fetch("/me/resume", {
@@ -3222,6 +3223,20 @@ function meNamespace(client) {
       retrieve(options) {
         return client.fetch("/me/resume", options);
       },
+      /**
+       * Set whether signed-in approved employers may receive `resumeUrl` on
+       * `talent.retrieve`. Does not upload or delete the file.
+       *
+       * @example
+       * await board.me.resume.update({ shareWithEmployers: true });
+       */
+      update(body, options) {
+        return client.fetch("/me/resume", {
+          ...options,
+          method: "PATCH",
+          body
+        });
+      },
       /**
        * Delete my stored resume file + withdraw keep-on-file consent (parsed
        * profile fields stay). Resolves void (204).
@@ -3960,7 +3975,9 @@ function talentNamespace(client) {
     /**
      * Retrieve a candidate's public profile by handle (or board-user id). Only
      * `public` profiles resolve; a non-public or unknown handle throws
-     * `talent_not_found` (404).
+     * `talent_not_found` (404). `resumeUrl` is an expiring signed download
+     * for a signed-in approved employer when the candidate opted in to share
+     * their stored resume; `null` otherwise. Directory cards never include it.
      *
      * @example
      * const profile = await board.talent.retrieve('jane-doe');

package/dist/index.mjs

@@ -46,7 +46,7 @@ function toSearchParams(query) {
 }
 
 // src/version.ts
-var SDK_VERSION = "4.53.0";
+var SDK_VERSION = "4.55.0";
 
 // src/client.ts
 function isRawBody(body) {
@@ -2845,6 +2845,7 @@ function meNamespace(client) {
         const form = new FormData();
         form.append("resume", file);
         if (opts?.keepResumeOnFile) form.append("keepResumeOnFile", "true");
+        if (opts?.shareWithEmployers) form.append("shareWithEmployers", "true");
         if (opts?.importMode) form.append("importMode", opts.importMode);
         if (opts?.confirmReplaceAll) form.append("confirmReplaceAll", "true");
         return client.fetch("/me/resume", {
@@ -2863,6 +2864,20 @@ function meNamespace(client) {
       retrieve(options) {
         return client.fetch("/me/resume", options);
       },
+      /**
+       * Set whether signed-in approved employers may receive `resumeUrl` on
+       * `talent.retrieve`. Does not upload or delete the file.
+       *
+       * @example
+       * await board.me.resume.update({ shareWithEmployers: true });
+       */
+      update(body, options) {
+        return client.fetch("/me/resume", {
+          ...options,
+          method: "PATCH",
+          body
+        });
+      },
       /**
        * Delete my stored resume file + withdraw keep-on-file consent (parsed
        * profile fields stay). Resolves void (204).
@@ -3601,7 +3616,9 @@ function talentNamespace(client) {
     /**
      * Retrieve a candidate's public profile by handle (or board-user id). Only
      * `public` profiles resolve; a non-public or unknown handle throws
-     * `talent_not_found` (404).
+     * `talent_not_found` (404). `resumeUrl` is an expiring signed download
+     * for a signed-in approved employer when the candidate opted in to share
+     * their stored resume; `null` otherwise. Directory cards never include it.
      *
      * @example
      * const profile = await board.talent.retrieve('jane-doe');

package/dist/{jobs-BMJHIKTi.d.ts → jobs-BSc8fWRd.d.ts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-B4TxcV4W.js';
+import { S as Schemas } from './_spec-QzRtIJNE.js';
 
 /**
  * Optional pagination metadata returned by Board API list operations.
@@ -70,8 +70,14 @@ type RemoteTimezone = PublicJob['remoteTimezones'][number];
  */
 interface RelatedSearch {
     type: 'category' | 'skill' | 'market';
+    /** English source slug; filters and taxonomy lookups accept it. */
     slug: string;
+    /** The term's page slug in the board language; equals `slug` when untranslated. */
+    canonicalSlug: string;
+    /** English source label. */
     term: string;
+    /** The label in the board language; equals `term` when untranslated. */
+    displayName: string;
     count: number;
 }
 /** The browse list envelope — `PublicJobCard`s + job catalog pagination + `relatedSearches`. */

package/dist/{jobs-DKo4rx45.d.mts → jobs-Cu5SX_Yp.d.mts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-B4TxcV4W.mjs';
+import { S as Schemas } from './_spec-QzRtIJNE.mjs';
 
 /**
  * Optional pagination metadata returned by Board API list operations.
@@ -70,8 +70,14 @@ type RemoteTimezone = PublicJob['remoteTimezones'][number];
  */
 interface RelatedSearch {
     type: 'category' | 'skill' | 'market';
+    /** English source slug; filters and taxonomy lookups accept it. */
     slug: string;
+    /** The term's page slug in the board language; equals `slug` when untranslated. */
+    canonicalSlug: string;
+    /** English source label. */
     term: string;
+    /** The label in the board language; equals `term` when untranslated. */
+    displayName: string;
     count: number;
 }
 /** The browse list envelope — `PublicJobCard`s + job catalog pagination + `relatedSearches`. */

package/dist/{search-DVSEJ5aj.d.ts → search-Cc0D9AIG.d.ts}

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

package/dist/{search-DJQkMA5T.d.mts → search-D5GiEIK5.d.mts}

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

package/dist/{seo-CIOAZCuc.d.ts → seo-C0NRwuve.d.ts}

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

package/dist/{seo-D2oDCBT0.d.mts → seo-WA9kv-W8.d.mts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-B4TxcV4W.mjs';
+import { S as Schemas } from './_spec-QzRtIJNE.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-D2oDCBT0.mjs';
-import './_spec-B4TxcV4W.mjs';
+import { B as BoardSeo } from './seo-WA9kv-W8.mjs';
+import './_spec-QzRtIJNE.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-CIOAZCuc.js';
-import './_spec-B4TxcV4W.js';
+import { B as BoardSeo } from './seo-C0NRwuve.js';
+import './_spec-QzRtIJNE.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-BYuzCPFi.mjs';
-import { e as JsonLdObject } from './breadcrumbs-BCEsjVMn.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-BCEsjVMn.mjs';
-import './_spec-B4TxcV4W.mjs';
-import './board-j0KFqNBp.mjs';
-import './jobs-DKo4rx45.mjs';
+import { P as PublicBlogPostSummary, B as BlogAuthorEmbed } from './blog-D32ONCap.mjs';
+import { e as JsonLdObject } from './breadcrumbs-CsG5emA0.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-CsG5emA0.mjs';
+import './_spec-QzRtIJNE.mjs';
+import './board-Dc9RJzZs.mjs';
+import './jobs-Cu5SX_Yp.mjs';
 
 /**
  * Blog structured data on the `@cavuno/board` wire types, transcribed from
@@ -112,6 +112,10 @@ interface JobLink {
     company: {
         slug: string;
     } | null;
+    /** The job's public URL (`links.public` on a job card), in the board's URL language. */
+    links?: {
+        public?: string | null;
+    } | null;
 }
 /**
  * `BreadcrumbList` (+ `ItemList` of the visible jobs) JSON-LD for a listing

package/dist/seo.d.ts

@@ -1,9 +1,9 @@
-import { P as PublicBlogPostSummary, B as BlogAuthorEmbed } from './blog-C1nsaLmM.js';
-import { e as JsonLdObject } from './breadcrumbs-BKpfMLqi.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-BKpfMLqi.js';
-import './_spec-B4TxcV4W.js';
-import './board-BtipyMwh.js';
-import './jobs-BMJHIKTi.js';
+import { P as PublicBlogPostSummary, B as BlogAuthorEmbed } from './blog-DBYumoqv.js';
+import { e as JsonLdObject } from './breadcrumbs-DuT2G4a5.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-DuT2G4a5.js';
+import './_spec-QzRtIJNE.js';
+import './board-BXRsEJR8.js';
+import './jobs-BSc8fWRd.js';
 
 /**
  * Blog structured data on the `@cavuno/board` wire types, transcribed from
@@ -112,6 +112,10 @@ interface JobLink {
     company: {
         slug: string;
     } | null;
+    /** The job's public URL (`links.public` on a job card), in the board's URL language. */
+    links?: {
+        public?: string | null;
+    } | null;
 }
 /**
  * `BreadcrumbList` (+ `ItemList` of the visible jobs) JSON-LD for a listing

package/dist/seo.js

@@ -777,10 +777,7 @@ function listingJsonLd(options) {
       itemListElement: detailJobs.map((job, index) => ({
         "@type": "ListItem",
         position: index + 1,
-        url: boardUrl(
-          options.origin,
-          jobDetailPath(job.company.slug, job.slug)
-        )
+        url: job.links?.public || boardUrl(options.origin, jobDetailPath(job.company.slug, job.slug))
       }))
     });
   }

package/dist/seo.mjs

@@ -179,10 +179,7 @@ function listingJsonLd(options) {
       itemListElement: detailJobs.map((job, index) => ({
         "@type": "ListItem",
         position: index + 1,
-        url: boardUrl(
-          options.origin,
-          jobDetailPath(job.company.slug, job.slug)
-        )
+        url: job.links?.public || boardUrl(options.origin, jobDetailPath(job.company.slug, job.slug))
       }))
     });
   }

package/dist/server.d.mts

@@ -1,10 +1,10 @@
 import { BoardSdk } from './index.mjs';
-import './_spec-B4TxcV4W.mjs';
-import './search-DJQkMA5T.mjs';
-import './jobs-DKo4rx45.mjs';
-import './board-j0KFqNBp.mjs';
-import './seo-D2oDCBT0.mjs';
-import './blog-BYuzCPFi.mjs';
+import './_spec-QzRtIJNE.mjs';
+import './search-D5GiEIK5.mjs';
+import './jobs-Cu5SX_Yp.mjs';
+import './board-Dc9RJzZs.mjs';
+import './seo-WA9kv-W8.mjs';
+import './blog-D32ONCap.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-B4TxcV4W.js';
-import './search-DVSEJ5aj.js';
-import './jobs-BMJHIKTi.js';
-import './board-BtipyMwh.js';
-import './seo-CIOAZCuc.js';
-import './blog-C1nsaLmM.js';
+import './_spec-QzRtIJNE.js';
+import './search-Cc0D9AIG.js';
+import './jobs-BSc8fWRd.js';
+import './board-BXRsEJR8.js';
+import './seo-C0NRwuve.js';
+import './blog-DBYumoqv.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-B4TxcV4W.mjs';
-import './search-DJQkMA5T.mjs';
-import './jobs-DKo4rx45.mjs';
-import './board-j0KFqNBp.mjs';
-import './seo-D2oDCBT0.mjs';
-import './blog-BYuzCPFi.mjs';
+import './_spec-QzRtIJNE.mjs';
+import './search-D5GiEIK5.mjs';
+import './jobs-Cu5SX_Yp.mjs';
+import './board-Dc9RJzZs.mjs';
+import './seo-WA9kv-W8.mjs';
+import './blog-D32ONCap.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-B4TxcV4W.js';
-import './search-DVSEJ5aj.js';
-import './jobs-BMJHIKTi.js';
-import './board-BtipyMwh.js';
-import './seo-CIOAZCuc.js';
-import './blog-C1nsaLmM.js';
+import './_spec-QzRtIJNE.js';
+import './search-Cc0D9AIG.js';
+import './jobs-BSc8fWRd.js';
+import './board-BXRsEJR8.js';
+import './seo-C0NRwuve.js';
+import './blog-DBYumoqv.js';
 
 /**
  * Sitemap primitives — the pure XML + bucket-filename logic behind a board

package/dist/suggest.d.mts

@@ -1,5 +1,5 @@
-import { h as SuggestionItem, b as SearchSuggestQuery, F as FetchOptions, g as SuggestResult } from './search-DJQkMA5T.mjs';
-import './_spec-B4TxcV4W.mjs';
+import { h as SuggestionItem, b as SearchSuggestQuery, F as FetchOptions, g as SuggestResult } from './search-D5GiEIK5.mjs';
+import './_spec-QzRtIJNE.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-DVSEJ5aj.js';
-import './_spec-B4TxcV4W.js';
+import { h as SuggestionItem, b as SearchSuggestQuery, F as FetchOptions, g as SuggestResult } from './search-Cc0D9AIG.js';
+import './_spec-QzRtIJNE.js';
 
 /**
  * `@cavuno/board/suggest` — framework-agnostic headless search-suggest

package/package.json

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

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

@@ -86,8 +86,10 @@ const sortOptions = JOB_SORTS;
 Render seniority as a multi-select with all eight `SENIORITIES`.
 `EMPLOYMENT_TYPES` contains five listing options; `volunteer` and `other`
 remain valid job wire values but are absent from the filter control.
-`JOB_SORTS` contains exactly `relevance`, `newest`, and `salary_high`;
-`relevance` is the featured-ranked default. Label each option with your
+`JOB_SORTS` contains exactly `relevance`, `newest`, `salary_high`, and
+`distance`; `relevance` is the featured-ranked default. `distance` is
+nearest-first from the selected location and needs coordinates — hide it
+in the sort menu until a location is set. Label each option with your
 application's copy (message catalog or hard-coded board language).
 
 ## Load taxonomy options

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

@@ -31,6 +31,8 @@ access.companyId;
 
 `companyId` is set when the viewer has exactly one approved membership. It is `null` when they have none or more than one — pass `companyId` on writes or the API returns `company_required`.
 
+For employers with multiple approved companies, select the same company for each read and write. Pass `{ query: { companyId } }` to `me.talentAccess.retrieve`, `me.talentAccess.retrieveCandidate`, and `talent.retrieve`. The selected company controls balances, candidate unlock state, and opaque profile access. Omission preserves the default viewer context; pending memberships and companies on another board grant no access. Pass `companyId` in unlock, checkout, upgrade, and cold `conversations.start` bodies so the same company pays.
+
 ## Gate one candidate
 
 Per-candidate already-unlocked state is a sibling read so the singleton never takes a candidate id.
@@ -136,6 +138,8 @@ Named `/p/{handle}` is the share bypass and always shows a full `public` profile
 
 `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`.
 
+`resumeUrl` on `talent.retrieve` is an expiring signed download for a signed-in approved employer when the candidate opted in (`me.resume.update({ shareWithEmployers: true })` or the upload form field) and a file is on file. It is `null` for everyone else and never present on directory cards. Redacted opaque profiles also return `null`. Turning sharing off stops new URLs; one already issued works until it expires. Candidates manage the file through `me.resume`.
+
 ```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.53.0",
+  "version": "4.55.0",
   "skills": [
     {
       "name": "cavuno-board-account",