@cavuno/board 4.8.0 → 4.9.0

package/dist/doctor.mjs

@@ -107,7 +107,14 @@ function summarize(results) {
   const passed = results.filter((r) => r.status === "pass").map((r) => r.id);
   const failed = results.filter((r) => r.status === "fail").map((r) => r.id);
   const skipped = results.filter((r) => r.status === "skip").map((r) => r.id);
-  return { exitCode: failed.length > 0 ? 1 : 0, passed, failed, skipped };
+  const warned = results.filter((r) => r.status === "warn").map((r) => r.id);
+  return {
+    exitCode: failed.length > 0 ? 1 : 0,
+    passed,
+    failed,
+    skipped,
+    warned
+  };
 }
 
 // src/doctor/cookie-conformance.ts
@@ -282,7 +289,7 @@ function checkCookieCodecConformance(projectRoot) {
 }
 
 // src/doctor/probe.ts
-var FETCH_TIMEOUT_MS = 1e4;
+var FETCH_TIMEOUT_MS = 6e4;
 async function probe(fetchImpl, url) {
   try {
     const response = await fetchImpl(url, {
@@ -308,7 +315,11 @@ var READ = {
   jobs: record("read.jobs", 2),
   jsonld: record("read.jsonld", 2),
   sitemap: record("read.sitemap", 2),
-  robots: record("read.robots", 2)
+  robots: record("read.robots", 2),
+  adsTxt: record("read.adsTxt", 2),
+  indexNow: record("read.indexNow", 2),
+  googleVerification: record("read.googleVerification", 2),
+  oauthCallback: record("read.oauthCallback", 2)
 };
 function skipReadProbes(reason) {
   return Object.values(READ).map((make) => make("skip", reason));
@@ -364,7 +375,11 @@ async function probeSitemap(fetchImpl, base) {
   }
   let urls = doc.urls;
   if (doc.kind === "index") {
-    const child = await probe(fetchImpl, onFrontend(base, urls[0]));
+    const childUrl = onFrontend(base, urls[0]);
+    let child = await probe(fetchImpl, childUrl);
+    if (!child.ok && (child.status === 503 || child.status === 0)) {
+      child = await probe(fetchImpl, childUrl);
+    }
     const childDoc = child.ok ? parseSitemap(child.body) : null;
     if (!childDoc || childDoc.urls.length === 0) {
       return READ.sitemap(
@@ -378,14 +393,109 @@ async function probeSitemap(fetchImpl, base) {
   const sample = await probe(fetchImpl, sampleUrl);
   return sample.ok ? READ.sitemap("pass", `${urls.length} entries; sample page resolves`) : READ.sitemap("fail", `sitemap page ${sampleUrl} \u2192 HTTP ${sample.status}`);
 }
-async function runReadProbes(fetchImpl, frontendUrl) {
+function scoreRobots(robots, seo) {
+  if (!robots.ok) {
+    return READ.robots("fail", `robots.txt HTTP ${robots.status}`);
+  }
+  const missing = [];
+  if (!/user-agent\s*:/i.test(robots.body)) missing.push("User-agent");
+  if (!robots.body.includes("Disallow: /go/")) missing.push("Disallow: /go/");
+  if (seo) {
+    const canonicalBase = seo.canonicalBase.replace(/\/+$/, "");
+    const sitemapLine = `Sitemap: ${canonicalBase}/sitemap.xml`;
+    if (!robots.body.includes(sitemapLine)) missing.push(sitemapLine);
+  }
+  if (missing.includes("User-agent")) {
+    return READ.robots(
+      "fail",
+      "robots.txt returned 200 but has no User-agent directive"
+    );
+  }
+  return missing.length === 0 ? READ.robots("pass", "present") : READ.robots(
+    "warn",
+    `robots.txt is missing ${missing.join(", ")} (hosted boards emit it)`
+  );
+}
+function configuredText(value) {
+  return typeof value === "string" && value.length > 0 ? value : null;
+}
+function scoreOptionalTextFile(options) {
+  const { make, label, path, seo, probed } = options;
+  if (seo == null) {
+    return make("skip", "board seo not fetched");
+  }
+  const expected = configuredText(options.configured);
+  if (expected !== null) {
+    if (!probed.ok) {
+      return make("fail", `${path} HTTP ${probed.status}`);
+    }
+    if (probed.body.trimEnd() === expected.trimEnd()) {
+      return make("pass", `${label} matches dashboard`);
+    }
+    return make("fail", `${path} body does not match dashboard ${label}`);
+  }
+  if (probed.status === 404) {
+    return make("pass", "unconfigured; 404 as expected");
+  }
+  if (probed.status === 200) {
+    return make(
+      "warn",
+      `${label} served but not configured in dashboard \u2014 clone leftover?`
+    );
+  }
+  return make("fail", `${path} HTTP ${probed.status}`);
+}
+function escapeRegExp(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function hasGoogleSiteVerificationMeta(html, token) {
+  const escaped = escapeRegExp(token);
+  const quoted = `["']${escaped}["']`;
+  const name = `name\\s*=\\s*["']google-site-verification["']`;
+  const content = `content\\s*=\\s*${quoted}`;
+  return new RegExp(`<meta\\b[^>]*\\b${name}[^>]*\\b${content}`, "i").test(html) || new RegExp(`<meta\\b[^>]*\\b${content}[^>]*\\b${name}`, "i").test(html);
+}
+function scoreGoogleVerification(homeHtml, seo) {
+  if (seo == null) {
+    return READ.googleVerification("skip", "board seo not fetched");
+  }
+  const token = configuredText(seo.googleSiteVerification);
+  if (token === null) {
+    return READ.googleVerification("skip", "no token configured");
+  }
+  return hasGoogleSiteVerificationMeta(homeHtml, token) ? READ.googleVerification("pass", "google-site-verification meta present") : READ.googleVerification(
+    "fail",
+    "home HTML is missing the google-site-verification meta tag"
+  );
+}
+var OAUTH_PROVIDERS = ["google", "linkedin"];
+function scoreOAuthCallback(probed) {
+  const broken = OAUTH_PROVIDERS.filter(
+    (provider) => !(probed[provider].status === 400 && /missing code or state/i.test(probed[provider].body))
+  );
+  return broken.length === 0 ? READ.oauthCallback("pass", "callback paths reach the hosted app") : READ.oauthCallback(
+    "warn",
+    `${broken.map((p) => `/api/board-auth/oauth/${p}/callback \u2192 HTTP ${probed[p].status}`).join(", ")} \u2014 only matters if you registered this domain's callback with the provider: forward the path to cavuno.com, or register https://cavuno.com/api/board-auth/oauth/{provider}/callback instead`
+  );
+}
+async function runReadProbes(fetchImpl, frontendUrl, seo) {
   const base = frontendUrl.replace(/\/$/, "");
-  const [home, jobsAndJsonLd, sitemap, robots] = await Promise.all([
-    probe(fetchImpl, base),
-    probeJobsAndJsonLd(fetchImpl, base),
-    probeSitemap(fetchImpl, base),
-    probe(fetchImpl, `${base}/robots.txt`)
-  ]);
+  const home = await probe(fetchImpl, base);
+  const jobsAndJsonLd = await probeJobsAndJsonLd(fetchImpl, base);
+  const sitemap = await probeSitemap(fetchImpl, base);
+  const robots = await probe(fetchImpl, `${base}/robots.txt`);
+  const adsTxt = await probe(fetchImpl, `${base}/ads.txt`);
+  const indexNow = await probe(fetchImpl, `${base}/indexnow-key.txt`);
+  const oauthCallback = {
+    google: await probe(
+      fetchImpl,
+      `${base}/api/board-auth/oauth/google/callback`
+    ),
+    linkedin: await probe(
+      fetchImpl,
+      `${base}/api/board-auth/oauth/linkedin/callback`
+    )
+  };
   return [
     home.ok && /<(html|body|div|main)[\s>]/i.test(home.body) ? READ.home("pass", "home renders") : READ.home(
       "fail",
@@ -393,10 +503,25 @@ async function runReadProbes(fetchImpl, frontendUrl) {
     ),
     ...jobsAndJsonLd,
     sitemap,
-    robots.ok && /user-agent\s*:/i.test(robots.body) ? READ.robots("pass", "present") : READ.robots(
-      "fail",
-      robots.ok ? "robots.txt returned 200 but has no User-agent directive" : `robots.txt HTTP ${robots.status}`
-    )
+    scoreRobots(robots, seo),
+    scoreOptionalTextFile({
+      make: READ.adsTxt,
+      label: "ads.txt",
+      path: "/ads.txt",
+      seo,
+      configured: seo?.adsTxt,
+      probed: adsTxt
+    }),
+    scoreOptionalTextFile({
+      make: READ.indexNow,
+      label: "indexnow-key.txt",
+      path: "/indexnow-key.txt",
+      seo,
+      configured: seo?.indexNowKey,
+      probed: indexNow
+    }),
+    scoreGoogleVerification(home.body, seo),
+    scoreOAuthCallback(oauthCallback)
   ];
 }
 
@@ -452,6 +577,28 @@ async function checkBoardResolves(fetchImpl, env) {
   }
   return STATIC_BOARD("pass", "publishable key resolves the board");
 }
+async function fetchBoardSeo(fetchImpl, env) {
+  const result = await probe(
+    fetchImpl,
+    `${apiBase(env.apiUrl)}/v1/boards/${encodeURIComponent(env.boardKey)}/seo`
+  );
+  if (!result.ok) return null;
+  try {
+    const parsed = JSON.parse(result.body);
+    if (typeof parsed !== "object" || parsed === null) return null;
+    const rec = parsed;
+    if (typeof rec.canonicalBase !== "string") return null;
+    const asNullableString = (value) => value === null || typeof value === "string" ? value : null;
+    return {
+      canonicalBase: rec.canonicalBase,
+      adsTxt: asNullableString(rec.adsTxt),
+      indexNowKey: asNullableString(rec.indexNowKey),
+      googleSiteVerification: asNullableString(rec.googleSiteVerification)
+    };
+  } catch {
+    return null;
+  }
+}
 var SKILL_ROOTS = [
   ".claude/skills",
   ".agents/skills",
@@ -513,8 +660,13 @@ async function runDoctor(options) {
   } else {
     results.push(STATIC_API("skip", "PUBLIC_CAVUNO_API_URL not set"));
   }
+  let seo = null;
   if (envOk) {
-    results.push(await checkBoardResolves(fetchImpl, env));
+    const boardResult = await checkBoardResolves(fetchImpl, env);
+    results.push(boardResult);
+    if (boardResult.status === "pass") {
+      seo = await fetchBoardSeo(fetchImpl, env);
+    }
   } else {
     results.push(STATIC_BOARD("skip", "env checks failed \u2014 fix them first"));
   }
@@ -523,7 +675,7 @@ async function runDoctor(options) {
     ...checkCookieCodecConformance(options.projectRoot ?? process.cwd())
   );
   results.push(
-    ...options.frontendUrl ? await runReadProbes(fetchImpl, options.frontendUrl) : skipReadProbes("no --frontend <url> given")
+    ...options.frontendUrl ? await runReadProbes(fetchImpl, options.frontendUrl, seo) : skipReadProbes("no --frontend <url> given")
   );
   return { results, summary: summarize(results) };
 }

package/dist/filters.d.mts

@@ -1,5 +1,5 @@
-import { J as JobSort, E as EmploymentType, R as RemoteOption, S as Seniority } from './jobs-DTLDt57G.mjs';
-import './_spec-DePC7a05.mjs';
+import { J as JobSort, E as EmploymentType, R as RemoteOption, S as Seniority } from './jobs-B7q3BgIK.mjs';
+import './_spec-B9Ah8dNs.mjs';
 
 /**
  * `@cavuno/board/filters` — the canonical listing-filter vocabulary and URL

package/dist/filters.d.ts

@@ -1,5 +1,5 @@
-import { J as JobSort, E as EmploymentType, R as RemoteOption, S as Seniority } from './jobs-twt5TO9l.js';
-import './_spec-DePC7a05.js';
+import { J as JobSort, E as EmploymentType, R as RemoteOption, S as Seniority } from './jobs-Iv6Wkvvf.js';
+import './_spec-B9Ah8dNs.js';
 
 /**
  * `@cavuno/board/filters` — the canonical listing-filter vocabulary and URL

package/dist/format.d.mts

@@ -1,7 +1,7 @@
-export { C as CurrencyDisplay, F as FormattedSalaryRange, J as JobBreadcrumb, N as NumberNotation, S as SalaryTimeframeInput, a as SalaryTimeframeValue, b as buildJobBreadcrumbs, f as formatSalaryRange, c as formatSalaryStat, d as formatSalaryStatRange, n as normalizeWebsiteUrl } from './breadcrumbs-P4qh0zML.mjs';
-import { C as CustomFieldDefinition } from './board-DxTMBgIf.mjs';
-import { C as CustomFieldValues } from './jobs-DTLDt57G.mjs';
-import './_spec-DePC7a05.mjs';
+export { C as CurrencyDisplay, F as FormattedSalaryRange, J as JobBreadcrumb, N as NumberNotation, S as SalaryTimeframeInput, a as SalaryTimeframeValue, b as buildJobBreadcrumbs, f as formatSalaryRange, c as formatSalaryStat, d as formatSalaryStatRange, n as normalizeWebsiteUrl } from './breadcrumbs-BVQL2dNY.mjs';
+import { C as CustomFieldDefinition } from './board-B4jLqmxn.mjs';
+import { C as CustomFieldValues } from './jobs-B7q3BgIK.mjs';
+import './_spec-B9Ah8dNs.mjs';
 
 /**
  * Date display helpers in the board language (required leading parameter,

package/dist/format.d.ts

@@ -1,7 +1,7 @@
-export { C as CurrencyDisplay, F as FormattedSalaryRange, J as JobBreadcrumb, N as NumberNotation, S as SalaryTimeframeInput, a as SalaryTimeframeValue, b as buildJobBreadcrumbs, f as formatSalaryRange, c as formatSalaryStat, d as formatSalaryStatRange, n as normalizeWebsiteUrl } from './breadcrumbs-kbmspmfk.js';
-import { C as CustomFieldDefinition } from './board-zWyHbyi4.js';
-import { C as CustomFieldValues } from './jobs-twt5TO9l.js';
-import './_spec-DePC7a05.js';
+export { C as CurrencyDisplay, F as FormattedSalaryRange, J as JobBreadcrumb, N as NumberNotation, S as SalaryTimeframeInput, a as SalaryTimeframeValue, b as buildJobBreadcrumbs, f as formatSalaryRange, c as formatSalaryStat, d as formatSalaryStatRange, n as normalizeWebsiteUrl } from './breadcrumbs-B1HVufC7.js';
+import { C as CustomFieldDefinition } from './board-De8nLbk7.js';
+import { C as CustomFieldValues } from './jobs-Iv6Wkvvf.js';
+import './_spec-B9Ah8dNs.js';
 
 /**
  * Date display helpers in the board language (required leading parameter,

package/dist/index.d.mts

@@ -1,12 +1,13 @@
-import { S as Schemas, c as components } from './_spec-DePC7a05.mjs';
-import { F as FetchOptions, S as StorageMode, B as BoardRequest, A as Awaitable, L as Logger, a as BoardClient, b as SearchSuggestQuery } from './search-f2UNlTfv.mjs';
-export { c as ACCESS_TOKEN_KEY, d as BOARD_ACCESS_GRANT_KEY, C as CompanySuggestion, e as CustomStorage, M as MarketSuggestion, R as REFRESH_TOKEN_KEY, f as SearchSuggestType, g as SuggestResult, h as SuggestionItem, T as TermSuggestion } from './search-f2UNlTfv.mjs';
-import { c as CompaniesListQuery, d as CompanyListEnvelope, e as CompaniesSearchBody, f as CompanyJobsListQuery, g as CompanySimilarQuery, h as CompanyMarketsListQuery, i as SalaryDetailQuery } from './board-DxTMBgIf.mjs';
-export { a as CompanyCategorySalary, j as CompanyMarket, k as CompanyMarketRef, b as CompanySalary, l as CompanySalarySummary, C as CustomFieldDefinition, m as CustomFieldOption, n as CustomFieldType, L as LocationSalaryDetail, o as LocationSkillsIndex, p as LocationTitlesIndex, P as PublicBoard, q as PublicBoardAnalytics, r as PublicBoardFeatures, s as PublicCompany, t as PublicCompanyDetail, u as SalaryCompany, v as SalaryLocation, w as SalarySkill, x as SalaryTitle, y as SkillLocationSalary, z as SkillLocationsIndex, S as SkillSalaryDetail, A as TitleLocationSalary, B as TitleLocationsIndex, T as TitleSalaryDetail } from './board-DxTMBgIf.mjs';
-import { R as RemoteOption, E as EmploymentType, S as Seniority, L as ListEnvelope, a as JobsListQuery, b as JobCardListEnvelope, c as JobsSearchBody, d as JobCardSearchEnvelope, e as JobsSimilarQuery, f as SearchEnvelope } from './jobs-DTLDt57G.mjs';
-export { g as CustomFieldValue, C as CustomFieldValues, h as EducationRequirement, i as JobCatalogPagination, j as JobCompany, J as JobSort, O as OfficeLocation, k as OffsetPagination, P as PublicJob, l as PublicJobCard, m as RelatedSearch, n as RemotePermit, o as RemoteTimezone, p as StorefrontPagination } from './jobs-DTLDt57G.mjs';
-import { a as BlogPostsListQuery, b as BlogSimilarQuery, c as BlogSearchBody } from './blog-DbFr4VPW.mjs';
-export { B as BlogAuthorEmbed, d as BlogTagEmbed, e as PublicBlogAdjacentPosts, f as PublicBlogAuthor, g as PublicBlogPost, P as PublicBlogPostSummary, h as PublicBlogTag } from './blog-DbFr4VPW.mjs';
+import { S as Schemas, c as components } from './_spec-B9Ah8dNs.mjs';
+import { F as FetchOptions, S as StorageMode, B as BoardRequest, A as Awaitable, L as Logger, a as BoardClient, b as SearchSuggestQuery } from './search-DC0jatQN.mjs';
+export { c as ACCESS_TOKEN_KEY, d as BOARD_ACCESS_GRANT_KEY, C as CompanySuggestion, e as CustomStorage, M as MarketSuggestion, R as REFRESH_TOKEN_KEY, f as SearchSuggestType, g as SuggestResult, h as SuggestionItem, T as TermSuggestion } from './search-DC0jatQN.mjs';
+import { c as CompaniesListQuery, d as CompanyListEnvelope, e as CompaniesSearchBody, f as CompanyJobsListQuery, g as CompanySimilarQuery, h as CompanyMarketsListQuery, i as SalaryDetailQuery } from './board-B4jLqmxn.mjs';
+export { a as CompanyCategorySalary, j as CompanyMarket, k as CompanyMarketRef, b as CompanySalary, l as CompanySalarySummary, C as CustomFieldDefinition, m as CustomFieldOption, n as CustomFieldType, L as LocationSalaryDetail, o as LocationSkillsIndex, p as LocationTitlesIndex, P as PublicBoard, q as PublicBoardAds, r as PublicBoardAnalytics, s as PublicBoardFeatures, t as PublicBoardJobForm, u as PublicCompany, v as PublicCompanyDetail, w as SalaryCompany, x as SalaryLocation, y as SalarySkill, z as SalaryTitle, A as SkillLocationSalary, B as SkillLocationsIndex, S as SkillSalaryDetail, D as TitleLocationSalary, E as TitleLocationsIndex, T as TitleSalaryDetail } from './board-B4jLqmxn.mjs';
+export { B as BoardSeo } from './seo-HCE7aCkh.mjs';
+import { R as RemoteOption, E as EmploymentType, S as Seniority, L as ListEnvelope, a as JobsListQuery, b as JobCardListEnvelope, c as JobsSearchBody, d as JobCardSearchEnvelope, e as JobsSimilarQuery, f as SearchEnvelope } from './jobs-B7q3BgIK.mjs';
+export { g as CustomFieldValue, C as CustomFieldValues, h as EducationRequirement, i as JobCatalogPagination, j as JobCompany, J as JobSort, O as OfficeLocation, k as OffsetPagination, P as PublicJob, l as PublicJobCard, m as RelatedSearch, n as RemotePermit, o as RemoteTimezone, p as StorefrontPagination } from './jobs-B7q3BgIK.mjs';
+import { a as BlogPostsListQuery, b as BlogSimilarQuery, c as BlogSearchBody } from './blog-BmqWfLZi.mjs';
+export { B as BlogAuthorEmbed, d as BlogTagEmbed, e as PublicBlogAdjacentPosts, f as PublicBlogAuthor, g as PublicBlogPost, P as PublicBlogPostSummary, h as PublicBlogTag } from './blog-BmqWfLZi.mjs';
 
 /**
  * Well-known `<domain>_<snake_reason>` codes the Board API sends, grouped by
@@ -19,7 +20,7 @@ export { B as BlogAuthorEmbed, d as BlogTagEmbed, e as PublicBlogAdjacentPosts,
  * `unknown_error` is SDK-synthesized when a response carries no parseable
  * envelope.
  */
-declare const BOARD_API_ERROR_CODES: readonly ["internal_error", "validation_bad_request", "validation_payload_too_large", "rate_limited", "rate_limit_unavailable", "search_unavailable", "too_many_filter_values", "pagination_invalid_cursor", "pagination_offset_too_large", "auth_unauthenticated", "auth_forbidden", "plan_upgrade_required", "unknown_error", "boards_not_found", "board_page_not_found", "board_auth_email_taken", "board_auth_invalid_credentials", "board_auth_invalid_token", "board_auth_registration_disabled", "board_auth_token_expired", "invalid_current_password", "no_password", "same_email", "email_taken", "invalid_token", "board_password_required", "board_password_invalid", "jobs_not_found", "jobs_invalid_filter", "categories_not_found", "skills_not_found", "places_not_found", "companies_not_found", "company_markets_not_found", "company_salary_not_found", "company_category_salary_not_found", "salaries_title_not_found", "salaries_skill_not_found", "salaries_location_not_found", "salaries_title_location_not_found", "salaries_skill_location_not_found", "blog_post_not_found", "blog_author_not_found", "blog_tag_not_found", "talent_not_found", "talent_directory_not_found", "talent_directory_restricted", "job_alert_not_found", "job_alerts_disabled", "candidate_alert_limit_reached", "candidate_alert_not_found", "candidate_entry_not_found", "candidate_handle_taken", "candidate_job_not_found", "resume_invalid_file", "resume_upload_forbidden", "applications_external_apply_only", "applications_country_not_allowed", "applications_guest_not_allowed", "applications_job_not_found", "applications_not_found", "applications_resume_invalid_file", "applications_unprocessable", "messaging_application_not_found", "messaging_application_not_linked", "messaging_blocked", "messaging_cannot_block_self", "messaging_cold_rule", "messaging_conversation_not_found", "messaging_disabled", "messaging_edit_window_expired", "messaging_message_deleted", "messaging_message_not_found", "messaging_not_author", "messaging_not_participant", "messaging_not_permitted", "messaging_not_recipient", "messaging_rate_limited", "messaging_recipient_not_found", "messaging_recipient_not_open", "messaging_unsend_window_expired", "employer_applicant_not_found", "employer_ats_unprocessable", "employer_checkout_failed", "employer_company_exists", "employer_company_name_taken", "employer_company_not_found", "employer_job_not_found", "employer_job_slug_taken", "employer_jobs_quota_exceeded", "employer_not_member", "employer_payment_required", "employer_pipeline_stage_not_found", "employer_member_not_found", "employer_invite_not_found", "not_company_admin", "not_company_member", "company_deletion_disabled", "last_admin", "already_member", "already_invited", "invalid_email", "invite_email_mismatch", "candidate_role", "job_not_published", "paywall_already_active", "paywall_disabled", "paywall_invalid_checkout_session", "paywall_no_candidate_profile", "paywall_no_recurring_subscription", "paywall_offer_not_found", "job_posting_logo_lookup_unavailable", "job_posting_logo_not_found", "job_posting_rejected"];
+declare const BOARD_API_ERROR_CODES: readonly ["internal_error", "validation_bad_request", "validation_payload_too_large", "rate_limited", "rate_limit_unavailable", "search_unavailable", "too_many_filter_values", "pagination_invalid_cursor", "pagination_offset_too_large", "auth_unauthenticated", "auth_forbidden", "plan_upgrade_required", "unknown_error", "boards_not_found", "board_page_not_found", "board_auth_email_taken", "board_auth_invalid_credentials", "board_auth_invalid_token", "board_auth_registration_disabled", "board_auth_token_expired", "invalid_current_password", "no_password", "same_email", "email_taken", "invalid_token", "board_password_required", "board_password_invalid", "jobs_not_found", "jobs_invalid_filter", "categories_not_found", "skills_not_found", "places_not_found", "companies_not_found", "company_markets_not_found", "company_salary_not_found", "company_category_salary_not_found", "salaries_title_not_found", "salaries_skill_not_found", "salaries_location_not_found", "salaries_title_location_not_found", "salaries_skill_location_not_found", "blog_post_not_found", "blog_author_not_found", "blog_tag_not_found", "talent_not_found", "talent_directory_not_found", "talent_directory_restricted", "job_recommendations_not_found", "recommended_talent_not_found", "job_alert_not_found", "job_alerts_disabled", "candidate_alert_limit_reached", "candidate_alert_not_found", "candidate_entry_not_found", "candidate_handle_taken", "candidate_job_not_found", "candidate_notification_preference_paused", "resume_invalid_file", "resume_upload_forbidden", "applications_external_apply_only", "applications_country_not_allowed", "applications_guest_not_allowed", "applications_job_not_found", "applications_not_found", "applications_resume_invalid_file", "applications_unprocessable", "messaging_application_not_found", "messaging_application_not_linked", "messaging_blocked", "messaging_cannot_block_self", "messaging_cold_rule", "messaging_conversation_not_found", "messaging_disabled", "messaging_edit_window_expired", "messaging_message_deleted", "messaging_message_not_found", "messaging_not_author", "messaging_not_participant", "messaging_not_permitted", "messaging_not_recipient", "messaging_rate_limited", "messaging_recipient_not_found", "messaging_recipient_not_open", "messaging_unsend_window_expired", "employer_applicant_not_found", "employer_ats_unprocessable", "employer_checkout_failed", "employer_company_exists", "employer_company_name_taken", "employer_company_not_found", "employer_job_not_found", "employer_job_slug_taken", "employer_jobs_quota_exceeded", "employer_not_member", "employer_payment_required", "employer_pipeline_stage_not_found", "employer_member_not_found", "employer_invite_not_found", "not_company_admin", "not_company_member", "company_deletion_disabled", "last_admin", "already_member", "already_invited", "invalid_email", "invite_email_mismatch", "candidate_role", "job_not_published", "paywall_already_active", "paywall_disabled", "paywall_invalid_checkout_session", "paywall_no_candidate_profile", "paywall_no_recurring_subscription", "paywall_offer_not_found", "job_posting_logo_lookup_unavailable", "job_posting_logo_not_found", "job_posting_rejected"];
 /**
  * The known code set plus open string — new codes ship additively within v1,
  * so exhaustive narrowing is intentionally impossible.
@@ -142,7 +143,7 @@ declare function paginate<Q extends Record<string, unknown>, P extends PageShape
  * constant because the package is platform-neutral and cannot read
  * package.json at runtime.
  */
-declare const SDK_VERSION = "4.8.0";
+declare const SDK_VERSION = "4.9.0";
 
 type SavedJob = Schemas['SavedJob'];
 type SavedJobsListQuery = {
@@ -468,15 +469,6 @@ type OAuthAuthorizationQuery = {
 type OAuthAuthorizationUrl = Schemas['BoardAuthOAuthAuthorizationUrl'];
 type OAuthExchangeBody = Schemas['BoardAuthOAuthExchangeBody'];
 
-/**
- * The public SEO-infra payload (`board.seo()`) — platform infrastructure a
- * headless frontend rebuilds `robots.txt` / `ads.txt` / `indexnow-key.txt`
- * (+ the Google site-verification `<meta>`) from, byte-identically to the
- * hosted board. Icons and `themeColor` left in 4.0.0; applications
- * own brand assets and presentation tokens.
- */
-type BoardSeo = Schemas['BoardSeo'];
-
 type EmbedJobsQuery = {
     /** Free-text search query, up to 200 characters. */
     q?: string;
@@ -689,6 +681,8 @@ type TaxonomyListQuery = {
     q?: string;
     cursor?: string;
     limit?: number;
+    /** `name` (default) or `jobCount` (highest published-job count first). */
+    sort?: 'name' | 'jobCount';
 };
 /**
  * Query for `taxonomy.places.list()`. Omit it (or `q`) for the full
@@ -740,10 +734,11 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
     client: BoardClient;
     /**
      * Board context — identity, brand (`logoUrl` + favicon `icons`), language,
-     * features, and analytics.
+     * features, analytics, and AdSense (`ads.enabled` + `ads.clientId`).
+     * Per-placement slot ids are not on this resource.
      *
      * @example
-     * const { name, language, logoUrl, icons } = await board.context();
+     * const { name, language, logoUrl, icons, ads } = await board.context();
      */
     context(options?: FetchOptions): Promise<{
         object: "public_board";
@@ -764,6 +759,8 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
         showCavunoBranding: boolean;
         features: {
             jobAlerts: boolean;
+            jobRecommendationsEnabled: boolean;
+            recommendedTalentEnabled: boolean;
             candidates: boolean;
             employers: boolean;
             blog: boolean;
@@ -783,9 +780,27 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
             linkedInPartnerId: string | null;
             cookieConsentRequired: boolean;
         };
+        ads: {
+            enabled: boolean;
+            clientId: string | null;
+        };
         customFields: {
             job: components["schemas"]["CustomFieldDefinition"][];
         };
+        jobForm: {
+            salary: {
+                visible: boolean;
+            };
+            seniority: {
+                visible: boolean;
+            };
+            location: {
+                visible: boolean;
+            };
+            sponsorship: {
+                visible: boolean;
+            };
+        };
         contact: {
             email: string | null;
             websiteUrl: string | null;
@@ -1580,12 +1595,14 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
                 object: "notification_preference";
                 channel: "messageEmails" | "applicationEmails" | "recommendedJobEmails";
                 subscribed: boolean;
+                waitlisted: boolean;
                 updatedAt: number | null;
             }>>;
             update(body: UpdateNotificationPreferenceBody, options?: FetchOptions): Promise<ListEnvelope<{
                 object: "notification_preference";
                 channel: "messageEmails" | "applicationEmails" | "recommendedJobEmails";
                 subscribed: boolean;
+                waitlisted: boolean;
                 updatedAt: number | null;
             }>>;
             unsubscribeWithToken(body: UnsubscribeBody, options?: FetchOptions): Promise<void>;
@@ -1656,6 +1673,7 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
                 linkedinUrl: string | null;
                 facebookUrl: string | null;
                 logoUrl: string | null;
+                deletionEnabled: boolean;
             }>;
             update(slug: string, body: UpdateEmployerCompanyBody, options?: FetchOptions): Promise<{
                 id: string;
@@ -1669,6 +1687,7 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
                 linkedinUrl: string | null;
                 facebookUrl: string | null;
                 logoUrl: string | null;
+                deletionEnabled: boolean;
             }>;
             delete(slug: string, options?: FetchOptions): Promise<void>;
             listMembers(slug: string, options?: FetchOptions): Promise<ListEnvelope<{
@@ -1711,6 +1730,7 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
                 linkedinUrl: string | null;
                 facebookUrl: string | null;
                 logoUrl: string | null;
+                deletionEnabled: boolean;
             }>;
             workEmail: {
                 verify(slug: string, body: SendWorkEmailBody, options?: FetchOptions): Promise<{
@@ -2488,6 +2508,7 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
                 sourceSlug: string;
                 canonicalSlug: string;
                 displayName: string;
+                jobCount: number;
             }>>;
             resolve(slug: string, options?: FetchOptions): Promise<{
                 object: "taxonomy_resolution";
@@ -2507,6 +2528,7 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
                 sourceSlug: string;
                 canonicalSlug: string;
                 displayName: string;
+                jobCount: number;
             }>>;
             resolve(slug: string, options?: FetchOptions): Promise<{
                 object: "taxonomy_resolution";
@@ -3187,4 +3209,4 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
 };
 type BoardSdk = ReturnType<typeof createBoardClient>;
 
-export { type AcceptCompanyMemberInviteBody, type AccessCheckoutBody, type AccessCheckoutSession, type AccessCheckoutSessionState, type AccessGrant, type AccessPortalBody, type AccessPortalSession, type AddApplicantNoteBody, type Alert, type AlertBody, type Application, type ApplicationsListQuery, type ApplyAction, type ApplyApprovalPlan, type ApplyApprovalReceipt, type ApplyBody, type ApplyIntent, Awaitable, BOARD_API_ERROR_CODES, type Block, type BlockStatus, type BlockUserBody, type BlockedUser, BlogPostsListQuery, BlogSearchBody, BlogSimilarQuery, type BoardAccessGrant, BoardApiError, type BoardApiErrorCode, type BoardAuthSession, BoardClient, BoardRequest, type BoardSdk, type BoardSeo, type BoardUser, type BulkMoveApplicantsBody, type BulkRejectApplicantsBody, type CandidateAvatar, type CandidateEducation, type CandidateExperience, type CandidateLanguage, type CandidateProfile, type CandidateSkill, type ClaimableCompany, CompaniesListQuery, CompaniesSearchBody, CompanyJobsListQuery, CompanyListEnvelope, CompanyMarketsListQuery, type CompanyMember, type CompanyMemberInvite, type CompanyMemberInviteAcceptance, type CompanyMembership, CompanySimilarQuery, type ConfirmEmailChangeBody, type ConfirmWorkEmailBody, type ConsumeMagicLinkBody, type Conversation, type ConversationArchive, type ConversationDetail, type ConversationRef, type ConversationsListQuery, type CreateApplyApprovalBody, type CreateApplyIntentBody, type CreateBoardClientOptions, type CreateCompanyBody, type CreateCompanyMemberInviteBody, type CreateEducationBody, type CreateEmployerJobBody, type CreateExperienceBody, type CreateJobPostingInput, type CreatePipelineStageBody, type EditMessageBody, type EmbedJobsQuery, type EmployerApplicant, type EmployerBillingOption, type EmployerCheckout, type EmployerCheckoutBody, type EmployerCompany, type EmployerCompanySearchQuery, type EmployerJob, type EmployerJobStat, type EmployerJobStatsPoint, type EmployerJobStatsTimeseriesQuery, type EmployerJobSummary, type EmployerJobsListQuery, type EmployerPipeline, type EmployerPipelineQuery, type EmployerPipelineStage, type EmployerProfileStats, type EmployerProfileViewsPoint, type EmployerProfileViewsTimeseriesQuery, EmploymentType, FetchOptions, type FindExistingConversationQuery, type ForgotPasswordBody, type HandleAvailability, type JobAlertConfirmation, type JobAlertDeletePreferenceInput, type JobAlertFiltersInput, type JobAlertFrequency, type JobAlertManageQuery, type JobAlertManageResult, type JobAlertManageState, type JobAlertManageTokenInput, type JobAlertPreference, type JobAlertRemoteOption, type JobAlertResendResult, type JobAlertStoredFilters, type JobAlertSubscribeInput, type JobAlertSubscription, type JobAlertUpdatePreferenceInput, JobCardListEnvelope, JobCardSearchEnvelope, type JobPostingBillingOptions, type JobPostingBillingVerification, type JobPostingLogoResult, type JobPostingPlan, type JobPostingResult, JobsListQuery, JobsSearchBody, JobsSimilarQuery, ListEnvelope, Logger, type LoginBody, type LogoutBody, type MarketingConsent, type Message, type ModerationReport, type MoveApplicantStageBody, type NotificationPreference, type OAuthAuthorizationQuery, type OAuthAuthorizationUrl, type OAuthExchangeBody, type OAuthProvider, type Paginator, type PaywallOffer, type PaywallOfferListEnvelope, type PlacesListQuery, type Plan, type PlanListEnvelope, type PlansListQuery, type PublicPlace, type PublicTaxonomyTerm, type ReadReceipt, type RecommendedJob, type RecommendedJobsListQuery, type RecommendedTalent, type RecommendedTalentListQuery, type RedirectResolution, type RefreshBody, type RegisterBody, RemoteOption, type RemotePermitTaxonomyEntry, type ReorderPipelineStagesBody, type ReplyBody, type ReportBody, type RequestEmailChangeBody, type RequestMagicLinkBody, type ResetPasswordBody, type Resume, type ResumeUploadOptions, SDK_VERSION, SalaryDetailQuery, type SalesLedPlan, type SalesLedPlanListEnvelope, type SaveJobBody, type SavedJob, type SavedJobsListQuery, SearchEnvelope, SearchSuggestQuery, type SendWorkEmailBody, Seniority, type StartAboutApplicationBody, type StartConversationBody, StorageMode, type TalentAccess, type TalentDirectoryEntry, type TalentDirectoryListEnvelope, type TalentDirectoryQuery, type TalentProfile, type TaxonomyGeo, type TaxonomyListQuery, type TaxonomyResolution, type ThreadMessagesQuery, type UnreadCount, type UnsubscribeBody, type UpdateApplicationFactsBody, type UpdateCandidateProfileBody, type UpdateCompanyMemberRoleBody, type UpdateEducationBody, type UpdateEmployerCompanyBody, type UpdateEmployerJobBody, type UpdateExperienceBody, type UpdateLanguagesBody, type UpdateNotificationPreferenceBody, type UpdatePasswordBody, type UpdatePipelineStageBody, type UpdateSkillsBody, type VerifyEmailBody, createBoardClient, isBoardApiError, isBoardPasswordRequired, isColdRule, isConflict, isForbidden, isNotFound, isOwnMessage, isRateLimited, isSafeApplicationUrl, isUnauthorized, isValidationError, lastOwnMessageId, paginate, resolveApplyAction };
+export { type AcceptCompanyMemberInviteBody, type AccessCheckoutBody, type AccessCheckoutSession, type AccessCheckoutSessionState, type AccessGrant, type AccessPortalBody, type AccessPortalSession, type AddApplicantNoteBody, type Alert, type AlertBody, type Application, type ApplicationsListQuery, type ApplyAction, type ApplyApprovalPlan, type ApplyApprovalReceipt, type ApplyBody, type ApplyIntent, Awaitable, BOARD_API_ERROR_CODES, type Block, type BlockStatus, type BlockUserBody, type BlockedUser, BlogPostsListQuery, BlogSearchBody, BlogSimilarQuery, type BoardAccessGrant, BoardApiError, type BoardApiErrorCode, type BoardAuthSession, BoardClient, BoardRequest, type BoardSdk, type BoardUser, type BulkMoveApplicantsBody, type BulkRejectApplicantsBody, type CandidateAvatar, type CandidateEducation, type CandidateExperience, type CandidateLanguage, type CandidateProfile, type CandidateSkill, type ClaimableCompany, CompaniesListQuery, CompaniesSearchBody, CompanyJobsListQuery, CompanyListEnvelope, CompanyMarketsListQuery, type CompanyMember, type CompanyMemberInvite, type CompanyMemberInviteAcceptance, type CompanyMembership, CompanySimilarQuery, type ConfirmEmailChangeBody, type ConfirmWorkEmailBody, type ConsumeMagicLinkBody, type Conversation, type ConversationArchive, type ConversationDetail, type ConversationRef, type ConversationsListQuery, type CreateApplyApprovalBody, type CreateApplyIntentBody, type CreateBoardClientOptions, type CreateCompanyBody, type CreateCompanyMemberInviteBody, type CreateEducationBody, type CreateEmployerJobBody, type CreateExperienceBody, type CreateJobPostingInput, type CreatePipelineStageBody, type EditMessageBody, type EmbedJobsQuery, type EmployerApplicant, type EmployerBillingOption, type EmployerCheckout, type EmployerCheckoutBody, type EmployerCompany, type EmployerCompanySearchQuery, type EmployerJob, type EmployerJobStat, type EmployerJobStatsPoint, type EmployerJobStatsTimeseriesQuery, type EmployerJobSummary, type EmployerJobsListQuery, type EmployerPipeline, type EmployerPipelineQuery, type EmployerPipelineStage, type EmployerProfileStats, type EmployerProfileViewsPoint, type EmployerProfileViewsTimeseriesQuery, EmploymentType, FetchOptions, type FindExistingConversationQuery, type ForgotPasswordBody, type HandleAvailability, type JobAlertConfirmation, type JobAlertDeletePreferenceInput, type JobAlertFiltersInput, type JobAlertFrequency, type JobAlertManageQuery, type JobAlertManageResult, type JobAlertManageState, type JobAlertManageTokenInput, type JobAlertPreference, type JobAlertRemoteOption, type JobAlertResendResult, type JobAlertStoredFilters, type JobAlertSubscribeInput, type JobAlertSubscription, type JobAlertUpdatePreferenceInput, JobCardListEnvelope, JobCardSearchEnvelope, type JobPostingBillingOptions, type JobPostingBillingVerification, type JobPostingLogoResult, type JobPostingPlan, type JobPostingResult, JobsListQuery, JobsSearchBody, JobsSimilarQuery, ListEnvelope, Logger, type LoginBody, type LogoutBody, type MarketingConsent, type Message, type ModerationReport, type MoveApplicantStageBody, type NotificationPreference, type OAuthAuthorizationQuery, type OAuthAuthorizationUrl, type OAuthExchangeBody, type OAuthProvider, type Paginator, type PaywallOffer, type PaywallOfferListEnvelope, type PlacesListQuery, type Plan, type PlanListEnvelope, type PlansListQuery, type PublicPlace, type PublicTaxonomyTerm, type ReadReceipt, type RecommendedJob, type RecommendedJobsListQuery, type RecommendedTalent, type RecommendedTalentListQuery, type RedirectResolution, type RefreshBody, type RegisterBody, RemoteOption, type RemotePermitTaxonomyEntry, type ReorderPipelineStagesBody, type ReplyBody, type ReportBody, type RequestEmailChangeBody, type RequestMagicLinkBody, type ResetPasswordBody, type Resume, type ResumeUploadOptions, SDK_VERSION, SalaryDetailQuery, type SalesLedPlan, type SalesLedPlanListEnvelope, type SaveJobBody, type SavedJob, type SavedJobsListQuery, SearchEnvelope, SearchSuggestQuery, type SendWorkEmailBody, Seniority, type StartAboutApplicationBody, type StartConversationBody, StorageMode, type TalentAccess, type TalentDirectoryEntry, type TalentDirectoryListEnvelope, type TalentDirectoryQuery, type TalentProfile, type TaxonomyGeo, type TaxonomyListQuery, type TaxonomyResolution, type ThreadMessagesQuery, type UnreadCount, type UnsubscribeBody, type UpdateApplicationFactsBody, type UpdateCandidateProfileBody, type UpdateCompanyMemberRoleBody, type UpdateEducationBody, type UpdateEmployerCompanyBody, type UpdateEmployerJobBody, type UpdateExperienceBody, type UpdateLanguagesBody, type UpdateNotificationPreferenceBody, type UpdatePasswordBody, type UpdatePipelineStageBody, type UpdateSkillsBody, type VerifyEmailBody, createBoardClient, isBoardApiError, isBoardPasswordRequired, isColdRule, isConflict, isForbidden, isNotFound, isOwnMessage, isRateLimited, isSafeApplicationUrl, isUnauthorized, isValidationError, lastOwnMessageId, paginate, resolveApplyAction };