@cavuno/board 4.51.0 → 4.53.0

package/CHANGELOG.md

@@ -3,6 +3,76 @@
 This changelog records changes that affect Board API compatibility, exported
 types, runtime behavior, or supported integration patterns.
 
+## 4.53.0 — 2026-10-21
+
+- Sponsored jobs (`isSponsored: true`) are being restricted to callers that
+  send the `apply-gateway-v1` capability, the opt-in for starters that send
+  candidates through the Apply gateway; send it on every job read now.
+  Without it, the job lists
+  (`jobs.list`, `jobs.similar`, `jobs.search`, `companies.listJobs`,
+  `embed.jobs` and `me.recommendedJobs.list`) leave Sponsored jobs out, with
+  `count` and pagination covering only the jobs returned, and
+  `jobs.retrieve` returns 404 `jobs_not_found` for a Sponsored job.
+- `JobsListQuery`, `JobsSimilarQuery`, `CompanyJobsListQuery` and
+  `EmbedJobsQuery` accept `capabilities: ['apply-gateway-v1']`, sent as the
+  `capabilities` query parameter so the response stays shared-cacheable
+  (prefer it to the header on these reads: a shared cache keys by URL).
+  `jobs.search` and `me.recommendedJobs.list` take the
+  `x-cavuno-board-capabilities: apply-gateway-v1` header in
+  `options.headers`.
+- A place resolution (`board.taxonomy.places.resolve()`) has an optional
+  `defaultRadiusKm`: the distance the jobs search applies around the place
+  when no `radius` is passed (with `defaultRadius: true` for the board's own
+  places; always for a suggested place). It is absent for regions, countries
+  and places without coordinates. Show it as the selected distance when the
+  visitor has not picked one.
+
+## 4.52.0 — 2026-10-20
+
+- Every salary page response has an `indexable` boolean: title, skill and
+  location details, title and skill by location, the four by-location and
+  by-place lists, and company and company-by-title salaries. When it is
+  `false`, render `<meta name="robots" content="noindex, follow">`; the page
+  still renders and its links stay followable. The board sitemap lists only
+  indexable salary pages.
+- Items in the salary lists (`SalaryCompany`, `SalaryTitle`, `SalarySkill`,
+  `SalaryLocation`, and the rows of the by-location and by-place lists) carry
+  `indexable` for the page they link to. Index a salary hub such as
+  `/salaries/titles` when at least one item it lists is indexable.
+- The generated API types include the company plan operations
+  (`/v1/companies/{id}/plan-assignments` and
+  `/v1/companies/{id}/plan-invoices`): list, create and revoke a company's
+  plan assignments, and list, create and cancel its plan invoices.
+- Operator API errors caused by the board's plan can carry an `upgrade` object
+  (`PlanUpgradeHint`) naming the blocking capability, the cheapest plan that
+  unlocks it, and the hosted checkout and plan-change endpoints. Board API
+  errors never carry it.
+- `GET` and `PATCH /v1/settings` carry the board's analytics tracking IDs
+  (`ga4MeasurementId`, `gtmContainerId`, `metaPixelId`, `linkedinPartnerId`
+  and the LinkedIn conversion IDs); `null` or an empty string clears one.
+- Board checkout status (job seeker access, talent access and membership)
+  can return `paymentStatus`, `'paid'` or `'processing'`, on a complete
+  session. On `'processing'` (a bank debit or transfer still clearing), stop
+  polling for access and tell the visitor their payment is processing.
+- The employer job read (`GET /me/companies/:slug/jobs/:id`) can return
+  `paymentProcessing: true` while a draft's delayed payment is still clearing.
+- The generated API types include the `/v1/job-feeds` operations
+  (`listJobFeeds`, `createJobFeed`, `getJobFeed`, `updateJobFeed`,
+  `deleteJobFeed`, `redetectJobFeedMapping`, `listJobFeedRuns`) to connect and
+  manage recurring XML job feeds.
+- A place slug that resolves to a suggested place
+  (`board.taxonomy.places.suggest()`) returns `suggested: true` and
+  `ancestors` (`PublicPlaceAncestor[]`: country, region and, for a
+  neighbourhood, city). Render them as the breadcrumb, linking an ancestor only
+  when its `canonicalSlug` is not `null`. Index a suggested place's page only
+  when it lists at least 5 on-site or hybrid jobs: read `count` from
+  `GET /jobs?location={slug}&remoteOption=on_site&remoteOption=hybrid&limit=1`.
+- Place suggestions come only from countries where the board has published
+  on-site or hybrid jobs, and each one's `regionCode` is its ISO 3166-2 region
+  code when it has one.
+- `createBreadcrumbJsonLd` leaves out an earlier crumb with no `href`,
+  since schema.org needs an `item` URL on every crumb but the last.
+
 ## 4.51.0 — 2026-10-19
 
 - A category or location page can carry its own intro. Taxonomy resolutions

package/dist/{_spec-Pr6ZvyW_.d.mts → _spec-B4TxcV4W.d.mts}

@@ -33,6 +33,11 @@ interface components {
             /** @enum {string} */
             status: "open" | "complete" | "expired";
             clientSecret: string | null;
+            /**
+             * @description Present only when `status` is `complete`. `paid`: the payment has arrived (or none was due); the purchase is granted once the payment webhook lands, so a short poll of the entitlement read sees it. `processing`: the buyer paid with a delayed method (SEPA / Bacs / ACH debit, bank transfer) that has not cleared yet. Nothing is granted until it clears, usually within a few business days, so stop polling and tell the buyer their payment is processing; read the session again later (for example on their next visit) to see whether it cleared or failed. `failed`: that delayed payment did not go through. Nothing was granted; the buyer can start a new checkout.
+             * @enum {string}
+             */
+            paymentStatus?: "paid" | "processing" | "failed";
         };
         AccessGrant: {
             /** @enum {string} */
@@ -661,6 +666,8 @@ interface components {
             boardCategoryP25Min: number | null;
             boardCategoryP75Max: number | null;
             currency: string;
+            /** @description Whether this salary page is worth indexing. When `false`, render `<meta name="robots" content="noindex, follow">`; the page still renders and its links stay followable. The board sitemap lists only indexable salary pages. */
+            indexable: boolean;
         };
         CompanyMarket: {
             /** @enum {string} */
@@ -851,6 +858,8 @@ interface components {
             boardP25Max: number | null;
             boardP75Max: number | null;
             currency: string;
+            /** @description Whether this salary page is worth indexing. When `false`, render `<meta name="robots" content="noindex, follow">`; the page still renders and its links stay followable. The board sitemap lists only indexable salary pages. */
+            indexable: boolean;
         };
         CompanySalarySummary: {
             /** @enum {string} */
@@ -1574,6 +1583,8 @@ interface components {
                 [key: string]: string[];
             };
             links: components["schemas"]["EmployerJobLinks"];
+            /** @description Returned by `GET …/jobs` (each job) and `GET …/jobs/:id`. `true` when the employer paid for this job with a delayed method (SEPA / Bacs / ACH debit, bank transfer) that has not cleared yet. The job stays a `draft` until the payment clears (usually within a few business days), then the paid listing goes through; a new checkout for the job is refused meanwhile. Show it as "payment processing" rather than an unpaid draft. */
+            paymentProcessing?: boolean;
         };
         EmployerPipeline: {
             /** @enum {string} */
@@ -1728,6 +1739,7 @@ interface components {
                 requestId: string;
                 /** @description Structured context for some errors, such as per-field validation issues. */
                 details?: unknown;
+                upgrade?: components["schemas"]["PlanUpgradeHint"];
             };
         };
         /**
@@ -1996,6 +2008,8 @@ interface components {
             boardOverallAvgMin: number | null;
             boardOverallAvgMax: number | null;
             currency: string;
+            /** @description Whether this salary page is worth indexing. When `false`, render `<meta name="robots" content="noindex, follow">`; the page still renders and its links stay followable. The board sitemap lists only indexable salary pages. */
+            indexable: boolean;
         };
         LocationSkillsIndex: {
             /** @enum {string} */
@@ -2011,7 +2025,11 @@ interface components {
                 jobCount: number;
                 /** @description ISO 4217 code of the amounts: the board's salary currency (USD unless the board set another). */
                 currency?: string;
+                /** @description Whether the salary page this item links to is worth indexing. When `false`, that page renders `<meta name="robots" content="noindex, follow">` and is left out of the board sitemap. */
+                indexable: boolean;
             }[];
+            /** @description Whether this salary page is worth indexing. When `false`, render `<meta name="robots" content="noindex, follow">`; the page still renders and its links stay followable. The board sitemap lists only indexable salary pages. */
+            indexable: boolean;
         };
         LocationTitlesIndex: {
             /** @enum {string} */
@@ -2027,7 +2045,11 @@ interface components {
                 jobCount: number;
                 /** @description ISO 4217 code of the amounts: the board's salary currency (USD unless the board set another). */
                 currency?: string;
+                /** @description Whether the salary page this item links to is worth indexing. When `false`, that page renders `<meta name="robots" content="noindex, follow">` and is left out of the board sitemap. */
+                indexable: boolean;
             }[];
+            /** @description Whether this salary page is worth indexing. When `false`, render `<meta name="robots" content="noindex, follow">`; the page still renders and its links stay followable. The board sitemap lists only indexable salary pages. */
+            indexable: boolean;
         };
         MarketSuggestion: {
             /** @enum {string} */
@@ -2202,6 +2224,33 @@ interface components {
                 };
             };
         };
+        /** @description Present only on Operator API errors caused by the board's Cavuno plan. Read `GET /v1/billing/subscription` to choose between `checkout` and `changePlan`, call it with `{ "planKey": requiredPlan }`, and give the returned `url` to a person to confirm. Each `path` is relative to the API origin, not to a `/v1` base URL. Both endpoints need `billing.manage`. Board API errors never include it. */
+        PlanUpgradeHint: {
+            /**
+             * @description The plan capability that blocked the request, named as in `GET /v1/billing/subscription` `capabilities`.
+             * @enum {string}
+             */
+            capability: "activeJobsLimit" | "teamSeatLimit" | "canBePublic" | "canRemoveBranding" | "apiAccess";
+            /**
+             * @description The cheapest self-serve plan that unlocks the action. Pass it as `planKey`. Omitted when it cannot be told without more information; read `GET /v1/billing/subscription` and pick a higher plan.
+             * @enum {string}
+             */
+            requiredPlan?: "starter" | "basic" | "grow" | "advanced" | "scale";
+            /** @description Starts a hosted checkout when the board has no active subscription (for example during a trial). */
+            checkout: {
+                /** @enum {string} */
+                method: "POST";
+                /** @enum {string} */
+                path: "/v1/billing/checkout";
+            };
+            /** @description Starts a hosted plan change when the board already has an active subscription. */
+            changePlan: {
+                /** @enum {string} */
+                method: "POST";
+                /** @enum {string} */
+                path: "/v1/billing/upgrade";
+            };
+        };
         PostSuggestion: {
             /** @enum {string} */
             object: "suggestion";
@@ -2913,6 +2962,14 @@ interface components {
             /** @description Live published-job count for this place. */
             jobCount: number;
         };
+        PublicPlaceAncestor: {
+            /** @description Name in the board's language. */
+            displayName: string;
+            /** @enum {string} */
+            placeType: "country" | "region" | "city";
+            /** @description The board's location page slug for this place (`/jobs/locations/:canonicalSlug`) when the board has the place among its places (`GET /boards/{identifier}/places`); `null` when it does not: show the name without a link. */
+            canonicalSlug: string | null;
+        };
         PublicProfileFields: {
             definitions: components["schemas"]["ProfileCustomFieldDefinition"][];
             referenceDefinitions: components["schemas"]["ProfileObjectReferenceDefinition"][];
@@ -3020,6 +3077,12 @@ interface components {
             geo: components["schemas"]["TaxonomyGeo"];
             /** @description The board's intro for this category or location page, as sanitized HTML. Absent when the page has none. Show it on page 1 with no filters. */
             introHtml?: string;
+            /** @description Present, and `true`, when a place slug resolved to a place from `GET /boards/{identifier}/places/suggest` instead of one of the board's places; absent for every other resolution. Its location page lists the jobs within the place's own default distance (pass the slug as the jobs `location` with no `radius`). Index that page only when it lists at least 5 on-site or hybrid jobs: read `count` from `GET /boards/{identifier}/jobs?location={slug}&remoteOption=on_site&remoteOption=hybrid&limit=1`, in parallel with the page's own job read, and emit `noindex, follow` below 5. Remote jobs still list on the page and count in its headline; they only do not count toward indexing. A view with an explicit `radius` stays `noindex, follow`. Only suggested places need this read. */
+            suggested?: boolean;
+            /** @description The breadcrumb above a suggested place, country first: its country, its region and, for a neighbourhood or suburb (`geo.placeType` `locality`), its city. Present when `suggested` is `true`, absent otherwise. Render Jobs > each ancestor > the place (`displayName`), with the same BreadcrumbList JSON-LD as for the board's own places; link an ancestor to `/jobs/locations/:canonicalSlug` only when its `canonicalSlug` is not `null`. */
+            ancestors?: components["schemas"]["PublicPlaceAncestor"][];
+            /** @description The distance in kilometres the jobs search applies around this place when no `radius` is passed: a city or locality with coordinates gets the market default (25 miles, 40.2336 km, in the US, GB, LR and MM; 50 km elsewhere), applied with `defaultRadius=true`; a suggested place gets its own default for its size, with or without `defaultRadius`. Absent for regions, countries, places without coordinates, and categories and skills. Show it as the selected distance when the visitor has not picked one. */
+            defaultRadiusKm?: number;
         };
         PublicTaxonomyTerm: {
             /** @enum {string} */
@@ -3292,6 +3355,8 @@ interface components {
             avgSalaryMax: number;
             jobCount: number;
             currency: string;
+            /** @description Whether the salary page this item links to is worth indexing. When `false`, that page renders `<meta name="robots" content="noindex, follow">` and is left out of the board sitemap. Index a salary hub (`/salaries/companies`, `/salaries/titles`, `/salaries/skills`, `/salaries/locations`) when at least one item it lists is indexable, and the `/salaries` overview when any item in these hub lists is indexable; otherwise render the hub with `noindex, follow`. A page that has its own `indexable` field uses that instead. */
+            indexable: boolean;
         };
         SalaryLocationIndexItem: {
             /** @enum {string} */
@@ -3307,6 +3372,8 @@ interface components {
             jobCount: number;
             /** @description ISO 4217 code of the amounts: the board's salary currency (USD unless the board set another). */
             currency?: string;
+            /** @description Whether the salary page this item links to is worth indexing. When `false`, that page renders `<meta name="robots" content="noindex, follow">` and is left out of the board sitemap. Index a salary hub (`/salaries/companies`, `/salaries/titles`, `/salaries/skills`, `/salaries/locations`) when at least one item it lists is indexable, and the `/salaries` overview when any item in these hub lists is indexable; otherwise render the hub with `noindex, follow`. A page that has its own `indexable` field uses that instead. */
+            indexable: boolean;
         };
         SalarySkillIndexItem: {
             /** @enum {string} */
@@ -3319,6 +3386,8 @@ interface components {
             p75SalaryMax: number;
             jobCount: number;
             currency: string;
+            /** @description Whether the salary page this item links to is worth indexing. When `false`, that page renders `<meta name="robots" content="noindex, follow">` and is left out of the board sitemap. Index a salary hub (`/salaries/companies`, `/salaries/titles`, `/salaries/skills`, `/salaries/locations`) when at least one item it lists is indexable, and the `/salaries` overview when any item in these hub lists is indexable; otherwise render the hub with `noindex, follow`. A page that has its own `indexable` field uses that instead. */
+            indexable: boolean;
         };
         SalaryTitleIndexItem: {
             /** @enum {string} */
@@ -3331,6 +3400,8 @@ interface components {
             p75SalaryMax: number;
             jobCount: number;
             currency: string;
+            /** @description Whether the salary page this item links to is worth indexing. When `false`, that page renders `<meta name="robots" content="noindex, follow">` and is left out of the board sitemap. Index a salary hub (`/salaries/companies`, `/salaries/titles`, `/salaries/skills`, `/salaries/locations`) when at least one item it lists is indexable, and the `/salaries` overview when any item in these hub lists is indexable; otherwise render the hub with `noindex, follow`. A page that has its own `indexable` field uses that instead. */
+            indexable: boolean;
         };
         /** @description Deprecated. Prefer public plans with purpose employer_service and pricingMode contact. */
         SalesLedPlan: {
@@ -3449,6 +3520,8 @@ interface components {
             boardSkillAvgMin: number | null;
             boardSkillAvgMax: number | null;
             currency: string;
+            /** @description Whether this salary page is worth indexing. When `false`, render `<meta name="robots" content="noindex, follow">`; the page still renders and its links stay followable. The board sitemap lists only indexable salary pages. */
+            indexable: boolean;
         };
         SkillLocationsIndex: {
             /** @enum {string} */
@@ -3458,6 +3531,8 @@ interface components {
             skillName: string;
             currency: string;
             locations: components["schemas"]["SalaryLocationIndexItem"][];
+            /** @description Whether this salary page is worth indexing. When `false`, render `<meta name="robots" content="noindex, follow">`; the page still renders and its links stay followable. The board sitemap lists only indexable salary pages. */
+            indexable: boolean;
         };
         SkillSalaryDetail: {
             /** @enum {string} */
@@ -3523,6 +3598,8 @@ interface components {
             boardMedianMin: number | null;
             boardMedianMax: number | null;
             currency: string;
+            /** @description Whether this salary page is worth indexing. When `false`, render `<meta name="robots" content="noindex, follow">`; the page still renders and its links stay followable. The board sitemap lists only indexable salary pages. */
+            indexable: boolean;
         };
         SourcedCandidate: {
             id: string;
@@ -3898,6 +3975,8 @@ interface components {
             boardCategoryAvgMin: number | null;
             boardCategoryAvgMax: number | null;
             currency: string;
+            /** @description Whether this salary page is worth indexing. When `false`, render `<meta name="robots" content="noindex, follow">`; the page still renders and its links stay followable. The board sitemap lists only indexable salary pages. */
+            indexable: boolean;
         };
         TitleLocationsIndex: {
             /** @enum {string} */
@@ -3907,6 +3986,8 @@ interface components {
             categoryName: string;
             currency: string;
             locations: components["schemas"]["SalaryLocationIndexItem"][];
+            /** @description Whether this salary page is worth indexing. When `false`, render `<meta name="robots" content="noindex, follow">`; the page still renders and its links stay followable. The board sitemap lists only indexable salary pages. */
+            indexable: boolean;
         };
         TitleSalaryDetail: {
             /** @enum {string} */
@@ -3978,6 +4059,8 @@ interface components {
             boardP25Min: number | null;
             boardP75Max: number | null;
             currency: string;
+            /** @description Whether this salary page is worth indexing. When `false`, render `<meta name="robots" content="noindex, follow">`; the page still renders and its links stay followable. The board sitemap lists only indexable salary pages. */
+            indexable: boolean;
         };
         UnreadCount: {
             /** @enum {string} */

package/dist/{_spec-Pr6ZvyW_.d.ts → _spec-B4TxcV4W.d.ts}

@@ -33,6 +33,11 @@ interface components {
             /** @enum {string} */
             status: "open" | "complete" | "expired";
             clientSecret: string | null;
+            /**
+             * @description Present only when `status` is `complete`. `paid`: the payment has arrived (or none was due); the purchase is granted once the payment webhook lands, so a short poll of the entitlement read sees it. `processing`: the buyer paid with a delayed method (SEPA / Bacs / ACH debit, bank transfer) that has not cleared yet. Nothing is granted until it clears, usually within a few business days, so stop polling and tell the buyer their payment is processing; read the session again later (for example on their next visit) to see whether it cleared or failed. `failed`: that delayed payment did not go through. Nothing was granted; the buyer can start a new checkout.
+             * @enum {string}
+             */
+            paymentStatus?: "paid" | "processing" | "failed";
         };
         AccessGrant: {
             /** @enum {string} */
@@ -661,6 +666,8 @@ interface components {
             boardCategoryP25Min: number | null;
             boardCategoryP75Max: number | null;
             currency: string;
+            /** @description Whether this salary page is worth indexing. When `false`, render `<meta name="robots" content="noindex, follow">`; the page still renders and its links stay followable. The board sitemap lists only indexable salary pages. */
+            indexable: boolean;
         };
         CompanyMarket: {
             /** @enum {string} */
@@ -851,6 +858,8 @@ interface components {
             boardP25Max: number | null;
             boardP75Max: number | null;
             currency: string;
+            /** @description Whether this salary page is worth indexing. When `false`, render `<meta name="robots" content="noindex, follow">`; the page still renders and its links stay followable. The board sitemap lists only indexable salary pages. */
+            indexable: boolean;
         };
         CompanySalarySummary: {
             /** @enum {string} */
@@ -1574,6 +1583,8 @@ interface components {
                 [key: string]: string[];
             };
             links: components["schemas"]["EmployerJobLinks"];
+            /** @description Returned by `GET …/jobs` (each job) and `GET …/jobs/:id`. `true` when the employer paid for this job with a delayed method (SEPA / Bacs / ACH debit, bank transfer) that has not cleared yet. The job stays a `draft` until the payment clears (usually within a few business days), then the paid listing goes through; a new checkout for the job is refused meanwhile. Show it as "payment processing" rather than an unpaid draft. */
+            paymentProcessing?: boolean;
         };
         EmployerPipeline: {
             /** @enum {string} */
@@ -1728,6 +1739,7 @@ interface components {
                 requestId: string;
                 /** @description Structured context for some errors, such as per-field validation issues. */
                 details?: unknown;
+                upgrade?: components["schemas"]["PlanUpgradeHint"];
             };
         };
         /**
@@ -1996,6 +2008,8 @@ interface components {
             boardOverallAvgMin: number | null;
             boardOverallAvgMax: number | null;
             currency: string;
+            /** @description Whether this salary page is worth indexing. When `false`, render `<meta name="robots" content="noindex, follow">`; the page still renders and its links stay followable. The board sitemap lists only indexable salary pages. */
+            indexable: boolean;
         };
         LocationSkillsIndex: {
             /** @enum {string} */
@@ -2011,7 +2025,11 @@ interface components {
                 jobCount: number;
                 /** @description ISO 4217 code of the amounts: the board's salary currency (USD unless the board set another). */
                 currency?: string;
+                /** @description Whether the salary page this item links to is worth indexing. When `false`, that page renders `<meta name="robots" content="noindex, follow">` and is left out of the board sitemap. */
+                indexable: boolean;
             }[];
+            /** @description Whether this salary page is worth indexing. When `false`, render `<meta name="robots" content="noindex, follow">`; the page still renders and its links stay followable. The board sitemap lists only indexable salary pages. */
+            indexable: boolean;
         };
         LocationTitlesIndex: {
             /** @enum {string} */
@@ -2027,7 +2045,11 @@ interface components {
                 jobCount: number;
                 /** @description ISO 4217 code of the amounts: the board's salary currency (USD unless the board set another). */
                 currency?: string;
+                /** @description Whether the salary page this item links to is worth indexing. When `false`, that page renders `<meta name="robots" content="noindex, follow">` and is left out of the board sitemap. */
+                indexable: boolean;
             }[];
+            /** @description Whether this salary page is worth indexing. When `false`, render `<meta name="robots" content="noindex, follow">`; the page still renders and its links stay followable. The board sitemap lists only indexable salary pages. */
+            indexable: boolean;
         };
         MarketSuggestion: {
             /** @enum {string} */
@@ -2202,6 +2224,33 @@ interface components {
                 };
             };
         };
+        /** @description Present only on Operator API errors caused by the board's Cavuno plan. Read `GET /v1/billing/subscription` to choose between `checkout` and `changePlan`, call it with `{ "planKey": requiredPlan }`, and give the returned `url` to a person to confirm. Each `path` is relative to the API origin, not to a `/v1` base URL. Both endpoints need `billing.manage`. Board API errors never include it. */
+        PlanUpgradeHint: {
+            /**
+             * @description The plan capability that blocked the request, named as in `GET /v1/billing/subscription` `capabilities`.
+             * @enum {string}
+             */
+            capability: "activeJobsLimit" | "teamSeatLimit" | "canBePublic" | "canRemoveBranding" | "apiAccess";
+            /**
+             * @description The cheapest self-serve plan that unlocks the action. Pass it as `planKey`. Omitted when it cannot be told without more information; read `GET /v1/billing/subscription` and pick a higher plan.
+             * @enum {string}
+             */
+            requiredPlan?: "starter" | "basic" | "grow" | "advanced" | "scale";
+            /** @description Starts a hosted checkout when the board has no active subscription (for example during a trial). */
+            checkout: {
+                /** @enum {string} */
+                method: "POST";
+                /** @enum {string} */
+                path: "/v1/billing/checkout";
+            };
+            /** @description Starts a hosted plan change when the board already has an active subscription. */
+            changePlan: {
+                /** @enum {string} */
+                method: "POST";
+                /** @enum {string} */
+                path: "/v1/billing/upgrade";
+            };
+        };
         PostSuggestion: {
             /** @enum {string} */
             object: "suggestion";
@@ -2913,6 +2962,14 @@ interface components {
             /** @description Live published-job count for this place. */
             jobCount: number;
         };
+        PublicPlaceAncestor: {
+            /** @description Name in the board's language. */
+            displayName: string;
+            /** @enum {string} */
+            placeType: "country" | "region" | "city";
+            /** @description The board's location page slug for this place (`/jobs/locations/:canonicalSlug`) when the board has the place among its places (`GET /boards/{identifier}/places`); `null` when it does not: show the name without a link. */
+            canonicalSlug: string | null;
+        };
         PublicProfileFields: {
             definitions: components["schemas"]["ProfileCustomFieldDefinition"][];
             referenceDefinitions: components["schemas"]["ProfileObjectReferenceDefinition"][];
@@ -3020,6 +3077,12 @@ interface components {
             geo: components["schemas"]["TaxonomyGeo"];
             /** @description The board's intro for this category or location page, as sanitized HTML. Absent when the page has none. Show it on page 1 with no filters. */
             introHtml?: string;
+            /** @description Present, and `true`, when a place slug resolved to a place from `GET /boards/{identifier}/places/suggest` instead of one of the board's places; absent for every other resolution. Its location page lists the jobs within the place's own default distance (pass the slug as the jobs `location` with no `radius`). Index that page only when it lists at least 5 on-site or hybrid jobs: read `count` from `GET /boards/{identifier}/jobs?location={slug}&remoteOption=on_site&remoteOption=hybrid&limit=1`, in parallel with the page's own job read, and emit `noindex, follow` below 5. Remote jobs still list on the page and count in its headline; they only do not count toward indexing. A view with an explicit `radius` stays `noindex, follow`. Only suggested places need this read. */
+            suggested?: boolean;
+            /** @description The breadcrumb above a suggested place, country first: its country, its region and, for a neighbourhood or suburb (`geo.placeType` `locality`), its city. Present when `suggested` is `true`, absent otherwise. Render Jobs > each ancestor > the place (`displayName`), with the same BreadcrumbList JSON-LD as for the board's own places; link an ancestor to `/jobs/locations/:canonicalSlug` only when its `canonicalSlug` is not `null`. */
+            ancestors?: components["schemas"]["PublicPlaceAncestor"][];
+            /** @description The distance in kilometres the jobs search applies around this place when no `radius` is passed: a city or locality with coordinates gets the market default (25 miles, 40.2336 km, in the US, GB, LR and MM; 50 km elsewhere), applied with `defaultRadius=true`; a suggested place gets its own default for its size, with or without `defaultRadius`. Absent for regions, countries, places without coordinates, and categories and skills. Show it as the selected distance when the visitor has not picked one. */
+            defaultRadiusKm?: number;
         };
         PublicTaxonomyTerm: {
             /** @enum {string} */
@@ -3292,6 +3355,8 @@ interface components {
             avgSalaryMax: number;
             jobCount: number;
             currency: string;
+            /** @description Whether the salary page this item links to is worth indexing. When `false`, that page renders `<meta name="robots" content="noindex, follow">` and is left out of the board sitemap. Index a salary hub (`/salaries/companies`, `/salaries/titles`, `/salaries/skills`, `/salaries/locations`) when at least one item it lists is indexable, and the `/salaries` overview when any item in these hub lists is indexable; otherwise render the hub with `noindex, follow`. A page that has its own `indexable` field uses that instead. */
+            indexable: boolean;
         };
         SalaryLocationIndexItem: {
             /** @enum {string} */
@@ -3307,6 +3372,8 @@ interface components {
             jobCount: number;
             /** @description ISO 4217 code of the amounts: the board's salary currency (USD unless the board set another). */
             currency?: string;
+            /** @description Whether the salary page this item links to is worth indexing. When `false`, that page renders `<meta name="robots" content="noindex, follow">` and is left out of the board sitemap. Index a salary hub (`/salaries/companies`, `/salaries/titles`, `/salaries/skills`, `/salaries/locations`) when at least one item it lists is indexable, and the `/salaries` overview when any item in these hub lists is indexable; otherwise render the hub with `noindex, follow`. A page that has its own `indexable` field uses that instead. */
+            indexable: boolean;
         };
         SalarySkillIndexItem: {
             /** @enum {string} */
@@ -3319,6 +3386,8 @@ interface components {
             p75SalaryMax: number;
             jobCount: number;
             currency: string;
+            /** @description Whether the salary page this item links to is worth indexing. When `false`, that page renders `<meta name="robots" content="noindex, follow">` and is left out of the board sitemap. Index a salary hub (`/salaries/companies`, `/salaries/titles`, `/salaries/skills`, `/salaries/locations`) when at least one item it lists is indexable, and the `/salaries` overview when any item in these hub lists is indexable; otherwise render the hub with `noindex, follow`. A page that has its own `indexable` field uses that instead. */
+            indexable: boolean;
         };
         SalaryTitleIndexItem: {
             /** @enum {string} */
@@ -3331,6 +3400,8 @@ interface components {
             p75SalaryMax: number;
             jobCount: number;
             currency: string;
+            /** @description Whether the salary page this item links to is worth indexing. When `false`, that page renders `<meta name="robots" content="noindex, follow">` and is left out of the board sitemap. Index a salary hub (`/salaries/companies`, `/salaries/titles`, `/salaries/skills`, `/salaries/locations`) when at least one item it lists is indexable, and the `/salaries` overview when any item in these hub lists is indexable; otherwise render the hub with `noindex, follow`. A page that has its own `indexable` field uses that instead. */
+            indexable: boolean;
         };
         /** @description Deprecated. Prefer public plans with purpose employer_service and pricingMode contact. */
         SalesLedPlan: {
@@ -3449,6 +3520,8 @@ interface components {
             boardSkillAvgMin: number | null;
             boardSkillAvgMax: number | null;
             currency: string;
+            /** @description Whether this salary page is worth indexing. When `false`, render `<meta name="robots" content="noindex, follow">`; the page still renders and its links stay followable. The board sitemap lists only indexable salary pages. */
+            indexable: boolean;
         };
         SkillLocationsIndex: {
             /** @enum {string} */
@@ -3458,6 +3531,8 @@ interface components {
             skillName: string;
             currency: string;
             locations: components["schemas"]["SalaryLocationIndexItem"][];
+            /** @description Whether this salary page is worth indexing. When `false`, render `<meta name="robots" content="noindex, follow">`; the page still renders and its links stay followable. The board sitemap lists only indexable salary pages. */
+            indexable: boolean;
         };
         SkillSalaryDetail: {
             /** @enum {string} */
@@ -3523,6 +3598,8 @@ interface components {
             boardMedianMin: number | null;
             boardMedianMax: number | null;
             currency: string;
+            /** @description Whether this salary page is worth indexing. When `false`, render `<meta name="robots" content="noindex, follow">`; the page still renders and its links stay followable. The board sitemap lists only indexable salary pages. */
+            indexable: boolean;
         };
         SourcedCandidate: {
             id: string;
@@ -3898,6 +3975,8 @@ interface components {
             boardCategoryAvgMin: number | null;
             boardCategoryAvgMax: number | null;
             currency: string;
+            /** @description Whether this salary page is worth indexing. When `false`, render `<meta name="robots" content="noindex, follow">`; the page still renders and its links stay followable. The board sitemap lists only indexable salary pages. */
+            indexable: boolean;
         };
         TitleLocationsIndex: {
             /** @enum {string} */
@@ -3907,6 +3986,8 @@ interface components {
             categoryName: string;
             currency: string;
             locations: components["schemas"]["SalaryLocationIndexItem"][];
+            /** @description Whether this salary page is worth indexing. When `false`, render `<meta name="robots" content="noindex, follow">`; the page still renders and its links stay followable. The board sitemap lists only indexable salary pages. */
+            indexable: boolean;
         };
         TitleSalaryDetail: {
             /** @enum {string} */
@@ -3978,6 +4059,8 @@ interface components {
             boardP25Min: number | null;
             boardP75Max: number | null;
             currency: string;
+            /** @description Whether this salary page is worth indexing. When `false`, render `<meta name="robots" content="noindex, follow">`; the page still renders and its links stay followable. The board sitemap lists only indexable salary pages. */
+            indexable: boolean;
         };
         UnreadCount: {
             /** @enum {string} */

package/dist/{blog-D-MQEaMU.d.mts → blog-BYuzCPFi.d.mts}

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

package/dist/{blog-BBBiKhsA.d.ts → blog-C1nsaLmM.d.ts}

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

package/dist/{board-C6PEXL7n.d.mts → board-BtipyMwh.d.ts}

@@ -1,5 +1,5 @@
-import { S as Schemas } from './_spec-Pr6ZvyW_.mjs';
-import { L as ListEnvelope, v as RelatedSearch, a as CustomFieldFilter, O as ObjectReferenceFilter } from './jobs-CeB5FVGG.mjs';
+import { S as Schemas } from './_spec-B4TxcV4W.js';
+import { L as ListEnvelope, v as RelatedSearch, b as CustomFieldFilter, O as ObjectReferenceFilter, a as JobCapability } from './jobs-BMJHIKTi.js';
 
 type PublicCompany = Schemas['CompanyPublic'];
 /** A market (sector) a company operates in — name + its source slug. */
@@ -58,6 +58,12 @@ type CompanyJobsListQuery = {
     cursor?: string;
     /** 1–100. */
     limit?: number;
+    /**
+     * Capability opt-ins, sent as the `capabilities` query parameter.
+     * `apply-gateway-v1` includes Sponsored jobs, which are left out without
+     * it; counts and pagination cover only the jobs returned.
+     */
+    capabilities?: JobCapability[];
 };
 type CompanySimilarQuery = {
     /** 1–20, default 6. */

package/dist/{board-CaZu8nEl.d.ts → board-j0KFqNBp.d.mts}

@@ -1,5 +1,5 @@
-import { S as Schemas } from './_spec-Pr6ZvyW_.js';
-import { L as ListEnvelope, v as RelatedSearch, a as CustomFieldFilter, O as ObjectReferenceFilter } from './jobs-DN0ePjTg.js';
+import { S as Schemas } from './_spec-B4TxcV4W.mjs';
+import { L as ListEnvelope, v as RelatedSearch, b as CustomFieldFilter, O as ObjectReferenceFilter, a as JobCapability } from './jobs-DKo4rx45.mjs';
 
 type PublicCompany = Schemas['CompanyPublic'];
 /** A market (sector) a company operates in — name + its source slug. */
@@ -58,6 +58,12 @@ type CompanyJobsListQuery = {
     cursor?: string;
     /** 1–100. */
     limit?: number;
+    /**
+     * Capability opt-ins, sent as the `capabilities` query parameter.
+     * `apply-gateway-v1` includes Sponsored jobs, which are left out without
+     * it; counts and pagination cover only the jobs returned.
+     */
+    capabilities?: JobCapability[];
 };
 type CompanySimilarQuery = {
     /** 1–20, default 6. */

package/dist/{breadcrumbs-WcxTd2Ka.d.mts → breadcrumbs-BCEsjVMn.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-C6PEXL7n.mjs';
-import { P as PublicJob } from './jobs-CeB5FVGG.mjs';
+import { P as PublicBoard, a as CompanyCategorySalary, b as CompanySalary, L as LocationSalaryDetail, S as SkillSalaryDetail, T as TitleSalaryDetail } from './board-j0KFqNBp.mjs';
+import { P as PublicJob } from './jobs-DKo4rx45.mjs';
 
 /**
  * Wire enum for `salaryTimeframe`. Defined here (not re-exported from any
@@ -348,7 +348,8 @@ interface BreadcrumbItemInput {
 /**
  * Build a `BreadcrumbList`, hosted semantics: labels are trimmed and empty
  * items dropped; fewer than 2 surviving items → `null` (a single crumb is
- * not a trail); the current page (no `href`) omits `item` per schema.org.
+ * not a trail); the current page (no `href`) omits `item` per schema.org,
+ * and an earlier item without `href` is left out.
  * Relative hrefs resolve against `options.origin`; without an origin a
  * relative item is omitted (never emit a relative `item` URL).
  */

package/dist/{breadcrumbs-DIIA4MaX.d.ts → breadcrumbs-BKpfMLqi.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-CaZu8nEl.js';
-import { P as PublicJob } from './jobs-DN0ePjTg.js';
+import { P as PublicBoard, a as CompanyCategorySalary, b as CompanySalary, L as LocationSalaryDetail, S as SkillSalaryDetail, T as TitleSalaryDetail } from './board-BtipyMwh.js';
+import { P as PublicJob } from './jobs-BMJHIKTi.js';
 
 /**
  * Wire enum for `salaryTimeframe`. Defined here (not re-exported from any
@@ -348,7 +348,8 @@ interface BreadcrumbItemInput {
 /**
  * Build a `BreadcrumbList`, hosted semantics: labels are trimmed and empty
  * items dropped; fewer than 2 surviving items → `null` (a single crumb is
- * not a trail); the current page (no `href`) omits `item` per schema.org.
+ * not a trail); the current page (no `href`) omits `item` per schema.org,
+ * and an earlier item without `href` is left out.
  * Relative hrefs resolve against `options.origin`; without an origin a
  * relative item is omitted (never emit a relative `item` URL).
  */