@cavuno/board 4.44.0 → 4.47.0

package/CHANGELOG.md

@@ -3,6 +3,67 @@
 This changelog records changes that affect Board API compatibility, exported
 types, runtime behavior, or supported integration patterns.
 
+## 4.47.0 — 2026-10-14
+
+- `board.taxonomy.places.list()` and `board.talent.places.list()` return each
+  place's board-language name and URL slug as `displayName` and
+  `canonicalSlug`. `name` and `slug` stay English. On an English board, or
+  for a place not yet translated, `displayName` is `name` and `canonicalSlug`
+  is `slug`. Link to location pages with a job place's `canonicalSlug`; pass a
+  talent place's `canonicalSlug` (or `slug`) only to `board.talent.list`'s
+  `place` filter.
+- With `q`, both lists also match the board-language name and slug, so
+  "Londres" finds London on a French board.
+- Deleting a company takes an optional `block=true`: the company is removed
+  and stays on the blocklist, so sourcing cannot add it back until it is
+  unblocked.
+- Job alerts: `jobFunctions` are category and skill slugs. Display names are
+  still accepted and slugified when the alert is saved, and alerts read back
+  carry slugs.
+
+## 4.46.0 — 2026-10-14
+
+- New `board.talent.places.list({ q, limit })`: the places a board's
+  directory candidates live in, each with `candidateCount`, the number of
+  candidates the viewer can see there. A candidate counts in their home place
+  and every place above it, so a country counts every candidate in its
+  cities. Signed-out viewers count public profiles; a signed-in board user
+  also counts profiles visible to signed-in users. Busiest first, up to
+  `limit` (1 to 500, default 100). With `q` (2 or more characters after
+  removing accents), it returns the best name and slug matches for a location
+  search field, at most 50. Pass a place's `slug` as `board.talent.list`'s
+  `place` filter. The list follows the directory's access rules.
+- New exported types: `TalentPlace`, `TalentPlacesListEnvelope`, `TalentPlacesQuery`.
+- Saved searches: a list has no size limit, so `talent_list_full` is no longer
+  raised. On a list linked to a job, `members.add` is how a sourced candidate
+  is shortlisted onto that job, and `members.remove` also takes them off the
+  job while they are still at Shortlisted. Linking a list shortlists everyone
+  saved to it and saves the job's sourced people to it; a job has at most one
+  list.
+- Deprecated: `me.companies.sourcedCandidates`. Use `talentLists.members` on the
+  job's linked list; `add` and `remove` on the old namespace forward to it.
+
+## 4.45.0 — 2026-10-13
+
+- `robotsBody()` and `robotsResponse()` from `@cavuno/board/seo-files` take
+  `listingPaths: { jobs, companies, talent }` for boards that rename or
+  translate their listing pages (for example `/vacatures` in place of
+  `/jobs`). The pagination `Disallow` rules then use those roots. A missing,
+  root (`/`) or unsafe value keeps the default root for that group, and
+  without the option the body is unchanged.
+- They also take `localeListingPaths`, a list of the same shape, for
+  secondary interface languages served under a prefix (for example
+  `/fr/emplois`). Each root gets the same pagination rules after the
+  base-language rules, and roots already listed are skipped.
+- New exported type: `RobotsListingPaths`.
+- Doctor: a new `read.localizedUrls` check. On a board whose route manifest
+  uses translated words, each translated page's English path must answer a
+  308 to the board's own path on the same origin, and that path must load.
+  English boards skip it with no extra requests.
+- The `cavuno-board-i18n` skill explains how a renamed URL word keeps
+  working: list the old word in `src/url-words-previous.json`, and starters
+  that read the file redirect it to the current word with one 308.
+
 ## 4.44.0 — 2026-10-12
 
 - Saved searches: `me.companies.talentLists.members.list()` takes `stage`, a

package/dist/{_spec-CLxrfYJb.d.mts → _spec-DHa5r3B0.d.mts}

@@ -2862,9 +2862,13 @@ interface components {
             id: string;
             /** @description Parent place's `id`; `null` for a root place. */
             parentId: string | null;
-            /** @description Public slug (links to `/jobs/locations/:slug`); `null` if unslugged. */
+            /** @description English source slug: the key for the jobs `location` filter. `null` if unslugged. Build links with `canonicalSlug`: on a translated board, the location page at the English slug can 308-redirect. */
             slug: string | null;
+            /** @description Board-language canonical URL slug where the board language has unique place slugs; otherwise, or for an untranslated place, `slug`. `null` if unslugged. Use it for links: it resolves as the jobs `location` filter, on `GET /boards/{identifier}/places/{slug}`, and as the location page slug (`/jobs/locations/:slug`). */
+            canonicalSlug: string | null;
             name: string;
+            /** @description Board-language name with source-name fallback. */
+            displayName: string;
             placeType: string;
             countryCode: string | null;
             regionCode: string | null;
@@ -2940,6 +2944,26 @@ interface components {
              */
             offset?: number;
         };
+        PublicTalentPlace: {
+            /** @enum {string} */
+            object: "talent_place";
+            /** @description Stable place identity (the same id as `/places`). */
+            id: string;
+            /** @description Parent place's `id`; `null` for a root place. */
+            parentId: string | null;
+            /** @description English source place slug: pass it as the talent directory's `place` filter. */
+            slug: string | null;
+            /** @description Board-language place slug where the board language has unique place slugs; otherwise, or for an untranslated place, `slug`. `null` if unslugged. It resolves only as the talent directory's `place` filter: there are no talent location pages, and it is not a slug for `GET /boards/{identifier}/places/{slug}` or the job location pages. */
+            canonicalSlug: string | null;
+            name: string;
+            /** @description Board-language name with source-name fallback. */
+            displayName: string;
+            placeType: string;
+            countryCode: string | null;
+            regionCode: string | null;
+            /** @description Candidates the viewer can see in the directory whose home is this place or lies within it. Signed out: `public` profiles; signed in: `public` and `logged_in_only` profiles. */
+            candidateCount: number;
+        };
         PublicTaxonomyResolution: {
             /** @enum {string} */
             object: "taxonomy_resolution";
@@ -3607,7 +3631,7 @@ interface components {
             createdBy: string;
             createdAt: number;
             updatedAt: number;
-            /** @description People saved to this list (at most 500). Includes anyone the members list omits for the viewer (blocked, hidden or deactivated). */
+            /** @description People saved to this list. Exact and immediate; a list has no size limit. Includes anyone the members list omits for the viewer (blocked, hidden or deactivated). */
             memberCount: number;
         };
         TalentListFilters: {

package/dist/{_spec-CLxrfYJb.d.ts → _spec-DHa5r3B0.d.ts}

@@ -2862,9 +2862,13 @@ interface components {
             id: string;
             /** @description Parent place's `id`; `null` for a root place. */
             parentId: string | null;
-            /** @description Public slug (links to `/jobs/locations/:slug`); `null` if unslugged. */
+            /** @description English source slug: the key for the jobs `location` filter. `null` if unslugged. Build links with `canonicalSlug`: on a translated board, the location page at the English slug can 308-redirect. */
             slug: string | null;
+            /** @description Board-language canonical URL slug where the board language has unique place slugs; otherwise, or for an untranslated place, `slug`. `null` if unslugged. Use it for links: it resolves as the jobs `location` filter, on `GET /boards/{identifier}/places/{slug}`, and as the location page slug (`/jobs/locations/:slug`). */
+            canonicalSlug: string | null;
             name: string;
+            /** @description Board-language name with source-name fallback. */
+            displayName: string;
             placeType: string;
             countryCode: string | null;
             regionCode: string | null;
@@ -2940,6 +2944,26 @@ interface components {
              */
             offset?: number;
         };
+        PublicTalentPlace: {
+            /** @enum {string} */
+            object: "talent_place";
+            /** @description Stable place identity (the same id as `/places`). */
+            id: string;
+            /** @description Parent place's `id`; `null` for a root place. */
+            parentId: string | null;
+            /** @description English source place slug: pass it as the talent directory's `place` filter. */
+            slug: string | null;
+            /** @description Board-language place slug where the board language has unique place slugs; otherwise, or for an untranslated place, `slug`. `null` if unslugged. It resolves only as the talent directory's `place` filter: there are no talent location pages, and it is not a slug for `GET /boards/{identifier}/places/{slug}` or the job location pages. */
+            canonicalSlug: string | null;
+            name: string;
+            /** @description Board-language name with source-name fallback. */
+            displayName: string;
+            placeType: string;
+            countryCode: string | null;
+            regionCode: string | null;
+            /** @description Candidates the viewer can see in the directory whose home is this place or lies within it. Signed out: `public` profiles; signed in: `public` and `logged_in_only` profiles. */
+            candidateCount: number;
+        };
         PublicTaxonomyResolution: {
             /** @enum {string} */
             object: "taxonomy_resolution";
@@ -3607,7 +3631,7 @@ interface components {
             createdBy: string;
             createdAt: number;
             updatedAt: number;
-            /** @description People saved to this list (at most 500). Includes anyone the members list omits for the viewer (blocked, hidden or deactivated). */
+            /** @description People saved to this list. Exact and immediate; a list has no size limit. Includes anyone the members list omits for the viewer (blocked, hidden or deactivated). */
             memberCount: number;
         };
         TalentListFilters: {

package/dist/bin.mjs

@@ -454,12 +454,13 @@ function extractJobDetailLink(html, templates) {
 var HREF_PATH_RE = /href="(\/[^"?#\s]+)"/gi;
 var SLUG_RE = /^[a-z0-9-]+$/i;
 var CANONICAL_JOB_DETAIL_TEMPLATE = CANONICAL_MANIFEST.roles.jobDetail;
-function jobRoutesFromManifest(manifest) {
+function manifestRoleTemplate(manifest, name) {
   const roles = manifest !== null && typeof manifest === "object" && manifest.version === 1 ? manifest.roles : null;
-  const role = (name) => {
-    const template = roles !== null && typeof roles === "object" ? roles[name] : void 0;
-    return typeof template === "string" && checkRoleTemplate(name, template).length === 0 ? template : null;
-  };
+  const template = roles !== null && typeof roles === "object" ? roles[name] : void 0;
+  return typeof template === "string" && checkRoleTemplate(name, template).length === 0 ? template : null;
+}
+function jobRoutesFromManifest(manifest) {
+  const role = (name) => manifestRoleTemplate(manifest, name);
   const jobs = role("jobs");
   const company = role("company");
   const jobsWord = jobs?.split("/").filter((seg) => seg !== "" && !seg.includes(":")).at(-1);
@@ -777,6 +778,25 @@ async function probe(fetchImpl, url) {
     };
   }
 }
+async function probeHop(fetchImpl, url) {
+  try {
+    const response = await fetchImpl(url, {
+      redirect: "manual",
+      signal: AbortSignal.timeout(FETCH_TIMEOUT_MS)
+    });
+    await response.body?.cancel().catch(() => void 0);
+    return {
+      status: response.status,
+      location: response.headers.get("location")
+    };
+  } catch (error) {
+    return {
+      status: 0,
+      location: null,
+      error: error instanceof Error ? error.message : String(error)
+    };
+  }
+}
 
 // node_modules/.pnpm/parse5@7.3.0/node_modules/parse5/dist/common/unicode.js
 var UNDEFINED_CODE_POINTS = /* @__PURE__ */ new Set([
@@ -8713,6 +8733,142 @@ function hasCrawlableCavunoBacklink(html) {
   return visit(root);
 }
 
+// src/doctor/localized-urls.ts
+var LOCALIZED_URLS = record("read.localizedUrls", 2);
+var REDIRECT_OK = /* @__PURE__ */ new Set([
+  "employers",
+  "alertsManage",
+  "alertsConfirm"
+]);
+var MAY_BE_UNPUBLISHED = /* @__PURE__ */ new Set([
+  "blog",
+  "about",
+  "talent",
+  "privacyPolicy",
+  "termsOfService",
+  "cookiePolicy",
+  "impressum"
+]);
+var GATE_SEGMENTS = /* @__PURE__ */ new Set([
+  "password",
+  "coming-soon-gate"
+]);
+var CONCURRENCY = 1;
+var segments = (path) => path.split("/").filter(Boolean);
+function translatedStaticRoles(manifest) {
+  const translated = [];
+  for (const role of ALL_ROLES) {
+    if (ROLE_PARAM_REGISTRY[role].length > 0 || role === "home") continue;
+    const english = CANONICAL_MANIFEST.roles[role];
+    const localized = manifestRoleTemplate(manifest, role);
+    if (!english || !localized || localized === english) continue;
+    if (segments(localized).length !== segments(english).length) continue;
+    translated.push({ role, english, localized });
+  }
+  return translated;
+}
+function resolveLocation(location, requestUrl) {
+  try {
+    return new URL(location, requestUrl);
+  } catch {
+    return null;
+  }
+}
+function pathUnder(base, url) {
+  const prefix = base.pathname.replace(/\/$/, "");
+  const path = prefix && url.pathname.startsWith(prefix) ? url.pathname.slice(prefix.length) || "/" : url.pathname;
+  return `${path}${url.search}`;
+}
+function isGate(base, url, requested) {
+  const parts = segments(pathUnder(base, url).split("?")[0]);
+  const last = parts.at(-1);
+  if (last !== void 0 && GATE_SEGMENTS.has(last)) return true;
+  return parts.length === 1 && url.searchParams.get("redirect") === requested;
+}
+async function checkRole(fetchImpl, baseUrl, { role, english, localized }) {
+  const base = new URL(baseUrl);
+  const problems = [];
+  const englishUrl = `${baseUrl}${english}`;
+  const hop = await probeHop(fetchImpl, englishUrl);
+  const target = hop.location === null ? null : resolveLocation(hop.location, englishUrl);
+  if (hop.status !== 308) {
+    problems.push(
+      `${english} \u2192 HTTP ${hop.status}${hop.error ? ` (${hop.error})` : ""}${target ? ` to ${target.href}` : ""}, expected 308 to ${localized}`
+    );
+  } else if (target === null) {
+    problems.push(
+      `${english} \u2192 308 without a usable Location, expected ${localized}`
+    );
+  } else if (target.origin !== base.origin) {
+    problems.push(
+      `${english} \u2192 308 off the board's origin to ${target.href}, expected ${localized}`
+    );
+  } else if (pathUnder(base, target) !== localized) {
+    problems.push(
+      `${english} \u2192 308 to ${pathUnder(base, target)}, expected ${localized}`
+    );
+  }
+  const pageUrl = `${baseUrl}${localized}`;
+  const page = await probeHop(fetchImpl, pageUrl);
+  const pageTarget = page.location === null ? null : resolveLocation(page.location, pageUrl);
+  const ok2xx = page.status >= 200 && page.status < 300;
+  const redirected = page.status >= 300 && page.status < 400;
+  if (ok2xx) {
+  } else if (page.status === 404 && MAY_BE_UNPUBLISHED.has(role)) {
+  } else if (redirected && pageTarget === null) {
+    problems.push(
+      `${localized} \u2192 HTTP ${page.status} without a usable Location, expected 2xx`
+    );
+  } else if (redirected && pageTarget.origin !== base.origin) {
+    problems.push(
+      `${localized} \u2192 HTTP ${page.status} off the board's origin to ${pageTarget.href}, expected 2xx`
+    );
+  } else if (redirected && isGate(base, pageTarget, localized)) {
+    problems.push(
+      `${localized} \u2192 HTTP ${page.status} to the board's access gate ${pathUnder(base, pageTarget)}, expected 2xx`
+    );
+  } else if (!(redirected && REDIRECT_OK.has(role))) {
+    problems.push(
+      `${localized} \u2192 HTTP ${page.status}${page.error ? ` (${page.error})` : ""}${pageTarget ? ` to ${pathUnder(base, pageTarget)}` : ""}, expected 2xx`
+    );
+  }
+  return problems.length > 0 ? `${role}: ${problems.join("; ")}` : null;
+}
+async function probeLocalizedUrls(fetchImpl, base, manifest) {
+  if (manifest === null) {
+    return LOCALIZED_URLS(
+      "skip",
+      "not applicable \u2014 no readable route manifest at /.well-known/cavuno.json"
+    );
+  }
+  const roles = translatedStaticRoles(manifest);
+  if (roles.length === 0) {
+    return LOCALIZED_URLS(
+      "skip",
+      "not applicable \u2014 the route manifest publishes no translated URL words"
+    );
+  }
+  const failures = new Array(roles.length).fill(null);
+  let next = 0;
+  const worker = async () => {
+    while (next < roles.length) {
+      const index = next++;
+      failures[index] = await checkRole(fetchImpl, base, roles[index]);
+    }
+  };
+  await Promise.all(
+    Array.from({ length: Math.min(CONCURRENCY, roles.length) }, worker)
+  );
+  const failed = failures.filter((f) => f !== null);
+  if (failed.length > 0) {
+    return LOCALIZED_URLS("fail", failed.join(" | "));
+  }
+  return LOCALIZED_URLS(
+    "pass",
+    `${roles.length} translated pages: each English path 308s to the board's word and the page answers (${roles.map((r) => `${r.english} \u2192 ${r.localized}`).join(", ")})`
+  );
+}
+
 // src/doctor/read.ts
 var READ = {
   home: record("read.home", 2),
@@ -8725,7 +8881,8 @@ var READ = {
   indexNow: record("read.indexNow", 2),
   googleVerification: record("read.googleVerification", 2),
   attribution: record("read.attribution", 2),
-  oauthCallback: record("read.oauthCallback", 2)
+  oauthCallback: record("read.oauthCallback", 2),
+  localizedUrls: LOCALIZED_URLS
 };
 function skipReadProbes(reason) {
   return Object.values(READ).map((make) => make("skip", reason));
@@ -8746,17 +8903,17 @@ async function confirmsNoPublishedJobs(fetchImpl, env) {
     return false;
   }
 }
-async function readJobRoutes(fetchImpl, base) {
+async function readManifest(fetchImpl, base) {
   const manifest = await probe(fetchImpl, `${base}/.well-known/cavuno.json`);
-  if (!manifest.ok) return jobRoutesFromManifest(null);
+  if (!manifest.ok) return null;
   try {
-    return jobRoutesFromManifest(JSON.parse(manifest.body));
+    return JSON.parse(manifest.body);
   } catch {
-    return jobRoutesFromManifest(null);
+    return null;
   }
 }
-async function probeJobsAndJsonLd(fetchImpl, base, env) {
-  const { jobsPath, jobDetailTemplates } = await readJobRoutes(fetchImpl, base);
+async function probeJobsAndJsonLd(fetchImpl, base, manifest, env) {
+  const { jobsPath, jobDetailTemplates } = jobRoutesFromManifest(manifest);
   const jobs = await probe(fetchImpl, `${base}${jobsPath}`);
   const jobLink = jobs.ok ? extractJobDetailLink(jobs.body, jobDetailTemplates) : null;
   if (jobs.status === 200 && !jobLink && /<(html|body|main)[\s>]/i.test(jobs.body) && await confirmsNoPublishedJobs(fetchImpl, env)) {
@@ -9005,7 +9162,13 @@ function scoreOAuthCallback(probed) {
 async function runReadProbes(fetchImpl, frontendUrl, seo, env) {
   const base = frontendUrl.replace(/\/$/, "");
   const home = await probe(fetchImpl, base);
-  const jobsAndJsonLd = await probeJobsAndJsonLd(fetchImpl, base, env);
+  const manifest = await readManifest(fetchImpl, base);
+  const jobsAndJsonLd = await probeJobsAndJsonLd(
+    fetchImpl,
+    base,
+    manifest,
+    env
+  );
   const sitemap = await probeSitemap(fetchImpl, base);
   const robots = await probe(fetchImpl, `${base}/robots.txt`);
   const adsTxt = await probe(fetchImpl, `${base}/ads.txt`);
@@ -9020,6 +9183,7 @@ async function runReadProbes(fetchImpl, frontendUrl, seo, env) {
       `${base}/api/board-auth/oauth/linkedin/callback`
     )
   };
+  const localizedUrls = await probeLocalizedUrls(fetchImpl, base, manifest);
   const board = env?.apiUrl && env.boardKey ? await probe(
     fetchImpl,
     `${apiBase(env.apiUrl)}/v1/boards/${encodeURIComponent(env.boardKey)}`
@@ -9058,7 +9222,8 @@ async function runReadProbes(fetchImpl, frontendUrl, seo, env) {
     }),
     scoreGoogleVerification(home.body, seo),
     attribution,
-    scoreOAuthCallback(oauthCallback)
+    scoreOAuthCallback(oauthCallback),
+    localizedUrls
   ];
 }
 

package/dist/{blog-CQ40QX7l.d.mts → blog-DylAbc0L.d.mts}

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

package/dist/{blog-mlhJ6UcD.d.ts → blog-wxhB8zAH.d.ts}

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

package/dist/{board-TOzb2D8c.d.mts → board-Bpze3b50.d.mts}

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

package/dist/{board-DWFDeICw.d.ts → board-DHsd92Gy.d.ts}

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

package/dist/{breadcrumbs-DJHyzBji.d.ts → breadcrumbs-15j5xvmN.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-DWFDeICw.js';
-import { P as PublicJob } from './jobs-DZVMzBOQ.js';
+import { P as PublicBoard, a as CompanyCategorySalary, b as CompanySalary, L as LocationSalaryDetail, S as SkillSalaryDetail, T as TitleSalaryDetail } from './board-DHsd92Gy.js';
+import { P as PublicJob } from './jobs-CIrTcMjw.js';
 
 /**
  * Wire enum for `salaryTimeframe`. Defined here (not re-exported from any

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