@cavuno/board 4.67.0 → 4.69.0

package/CHANGELOG.md

@@ -3,6 +3,47 @@
 This changelog records changes that affect Board API compatibility, exported
 types, runtime behavior, or supported integration patterns.
 
+## 4.69.0 — 2026-11-12
+
+- Members-only boards: on a board whose context has
+  `posting.requiresMembership`, `board.plans.list()` leaves out job-posting
+  plans, except those priced by quote, because visitors cannot buy them.
+  `board.jobPosting.plans()` still returns them for members. An anonymous
+  `board.jobPosting.create(...)` on such a board is refused with
+  `membership_required`, whatever company website it names.
+- `board.jobPosting.plans()` returns each feature's `name`, `dataType` and
+  `displayOrder`, as `board.plans.list()` does, so a posting form can label a
+  plan's custom attributes from that one read.
+- `board.me.companies.billingOptions.list(slug)` is typed as
+  `EmployerBillingOptionsList`, which includes the `capabilities` the
+  endpoint returns: `canPost`, the `reason` when posting is refused, and the
+  membership allowance. `EmployerPostingCapabilities` is exported. Read
+  `canPost` to show a membership offer before the employer writes a job.
+- `board.me.companies.startMembershipCheckout(slug, body)` takes an optional
+  `redirectOnCompletion`: `'always'` (the default, unchanged) or
+  `'if_required'`, which keeps a card payment on the embedding page and fires
+  Stripe.js `onComplete`. Payment methods that need a redirect still return
+  to `returnPath`.
+- The board context carries `features.tipJar` (the board has an active tip
+  jar) and `features.products` (it lists at least one product), so a frontend
+  can show those links without probing `/tip-jar` and `/products`.
+- `auth.refresh()` and `auth.logout()` are rate limited per refresh token (10
+  a minute) instead of per client IP, with a ceiling of 1,000 a minute per IP.
+  A server-rendered frontend refreshing many visitors' sessions from one IP no
+  longer gets `rate_limited`.
+
+## 4.68.0 — 2026-11-11
+
+- Company market resolutions return `companyCount`: the number of companies
+  tagged with the market. Use it to tell whether a market page has enough
+  companies to index. The hosted sitemap lists a market page once at least
+  5 companies carry it.
+- Work arrangement pages: the place slugs `remote`, `hybrid` and `on-site`
+  name a work arrangement. Job list filters return that arrangement's jobs,
+  and place resolve returns its board-language label with `geo: null`. The
+  `jobs-locations` sitemap bucket lists the Remote page once the board has
+  enough remote jobs.
+
 ## 4.67.0 — 2026-11-11
 
 - Job seekers can fill their own image gallery and file profile fields: new

package/dist/{_spec-BehBmeHK.d.mts → _spec-CFOj7Qdf.d.mts}

@@ -539,7 +539,7 @@ interface components {
         BoardSitemap: {
             /** @enum {string} */
             object: "board_sitemap";
-            /** @description The buckets the board publishes, in the canonical bucket order. Empty buckets are omitted — exactly the set the hosted `/sitemap.xml` index lists. */
+            /** @description The buckets the board publishes, in the canonical bucket order. Empty buckets are omitted. This is the set the hosted `/sitemap.xml` index lists, plus the Remote work arrangement page (`/jobs/locations/remote`) in `jobs-locations` once the board has enough remote jobs. */
             buckets: components["schemas"]["BoardSitemapBucketSummary"][];
         };
         BoardSitemapBucketSummary: {
@@ -2099,6 +2099,12 @@ interface components {
             features: {
                 key: string | null;
                 value: string | null;
+                /** @description The feature's display name, including an operator-defined custom attribute's name. */
+                name: string;
+                /** @description How to read `value`, such as `integer`, `boolean` or `string`. */
+                dataType: string;
+                /** @description The operator-set order among the plan features; null when unset. */
+                displayOrder: number | null;
             }[];
         };
         JobPostingResult: {
@@ -2322,6 +2328,11 @@ interface components {
             returnPath: string;
             /** @enum {string} */
             colorMode: "light" | "dark";
+            /**
+             * @description When the buyer leaves for `returnPath`. `always` (default): every completed checkout redirects there. `if_required`: a card payment completes in place and the embedding page reacts to Stripe.js `onComplete` (then reads `GET …/membership/checkout/{sessionId}`); only a payment method that needs a redirect returns to `returnPath`.
+             * @enum {string}
+             */
+            redirectOnCompletion?: "always" | "if_required";
         };
         Message: {
             id: string;
@@ -2924,6 +2935,10 @@ interface components {
                 placeSuggestions: boolean;
                 /** @description Whether the board serves its public MCP server, which AI assistants connect to at `/mcp` on the board's own host, with a setup page for job seekers at `/mcp/docs`. `true` on a paid board that is not password-protected and has not turned the server off. Show a link to `/mcp/docs` (for example in the footer) only when `true`. */
                 mcp: boolean;
+                /** @description Whether the board has a tip jar that is on (not archived). Matches `GET /v1/boards/{identifier}/tip-jar` answering 200 instead of `tip_jar_not_found`, so chrome can decide whether to link to the tip page from this context alone. */
+                tipJar: boolean;
+                /** @description Whether the board lists at least one digital product. Matches `GET /v1/boards/{identifier}/products` returning a non-empty first page with no filters, so chrome can decide whether to link to the products page from this context alone. */
+                products: boolean;
             };
             /**
              * @description How the operator charges employers for the candidate directory. `paid_messaging` leaves profiles fully visible and spends a credit on a first cold message; `paid_unlocks_and_messaging` also redacts directory cards and gates the opaque `/p/{id}` profile route behind an unlock credit. `null` means the operator has not chosen explicitly, in which case infer it from the published `talent_access` plans: any plan granting profile unlocks means `paid_unlocks_and_messaging`, otherwise `paid_messaging`. The paywall is inert regardless when the board publishes no talent plan. An anonymous viewer has no entitlement read to derive this from, so it ships here rather than only on `me/talent-access`.
@@ -3590,7 +3605,7 @@ interface components {
                      */
                     lte?: string;
                 };
-                /** @description Only return jobs in the place with this slug, including the places inside it (a region includes its cities). The slug can also name a country or region remote jobs on the board are open to, as `GET /places?q=` suggests. Pass `radius` to widen a city or locality to nearby jobs. A place slug from `GET /places/suggest` returns jobs within `radius` km of that place, by default a distance that suits its size. Unresolvable slugs are ignored. */
+                /** @description Only return jobs in the place with this slug, including the places inside it (a region includes its cities). The slug can also name a country or region remote jobs on the board are open to, as `GET /places?q=` suggests. Pass `radius` to widen a city or locality to nearby jobs. A place slug from `GET /places/suggest` returns jobs within `radius` km of that place, by default a distance that suits its size. Unresolvable slugs are ignored. The reserved slugs `remote`, `hybrid` and `on-site` name a work arrangement, not a place: they return the jobs `remoteOption` `remote`, `hybrid` or `on_site` returns, ignore `radius`, and combined with a `remoteOption` that leaves that arrangement out return no jobs. */
                 location?: string;
                 /** @description Widen a city or locality `location` to also return jobs placed in a city or locality within this many kilometres of the place (1–250; decimals allowed, e.g. `8.05` for 5 miles). Omit for jobs in the place itself. Ignored for region and country places, and without `location`. For a place from `GET /places/suggest`, an omitted `radius` uses the place's own default distance: 15 km for a neighbourhood, 25 km for a town, 50 km for a city. */
                 radius?: number;
@@ -3666,6 +3681,8 @@ interface components {
             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;
+            /** @description The number of the board's companies tagged with this market. Present on market resolutions only. The board's sitemap lists a market page only when this is at least 5; emit `noindex, follow` on the plain market page below 5 so the two agree. */
+            companyCount?: number;
         };
         PublicTaxonomyTerm: {
             /** @enum {string} */

package/dist/{_spec-BehBmeHK.d.ts → _spec-CFOj7Qdf.d.ts}

@@ -539,7 +539,7 @@ interface components {
         BoardSitemap: {
             /** @enum {string} */
             object: "board_sitemap";
-            /** @description The buckets the board publishes, in the canonical bucket order. Empty buckets are omitted — exactly the set the hosted `/sitemap.xml` index lists. */
+            /** @description The buckets the board publishes, in the canonical bucket order. Empty buckets are omitted. This is the set the hosted `/sitemap.xml` index lists, plus the Remote work arrangement page (`/jobs/locations/remote`) in `jobs-locations` once the board has enough remote jobs. */
             buckets: components["schemas"]["BoardSitemapBucketSummary"][];
         };
         BoardSitemapBucketSummary: {
@@ -2099,6 +2099,12 @@ interface components {
             features: {
                 key: string | null;
                 value: string | null;
+                /** @description The feature's display name, including an operator-defined custom attribute's name. */
+                name: string;
+                /** @description How to read `value`, such as `integer`, `boolean` or `string`. */
+                dataType: string;
+                /** @description The operator-set order among the plan features; null when unset. */
+                displayOrder: number | null;
             }[];
         };
         JobPostingResult: {
@@ -2322,6 +2328,11 @@ interface components {
             returnPath: string;
             /** @enum {string} */
             colorMode: "light" | "dark";
+            /**
+             * @description When the buyer leaves for `returnPath`. `always` (default): every completed checkout redirects there. `if_required`: a card payment completes in place and the embedding page reacts to Stripe.js `onComplete` (then reads `GET …/membership/checkout/{sessionId}`); only a payment method that needs a redirect returns to `returnPath`.
+             * @enum {string}
+             */
+            redirectOnCompletion?: "always" | "if_required";
         };
         Message: {
             id: string;
@@ -2924,6 +2935,10 @@ interface components {
                 placeSuggestions: boolean;
                 /** @description Whether the board serves its public MCP server, which AI assistants connect to at `/mcp` on the board's own host, with a setup page for job seekers at `/mcp/docs`. `true` on a paid board that is not password-protected and has not turned the server off. Show a link to `/mcp/docs` (for example in the footer) only when `true`. */
                 mcp: boolean;
+                /** @description Whether the board has a tip jar that is on (not archived). Matches `GET /v1/boards/{identifier}/tip-jar` answering 200 instead of `tip_jar_not_found`, so chrome can decide whether to link to the tip page from this context alone. */
+                tipJar: boolean;
+                /** @description Whether the board lists at least one digital product. Matches `GET /v1/boards/{identifier}/products` returning a non-empty first page with no filters, so chrome can decide whether to link to the products page from this context alone. */
+                products: boolean;
             };
             /**
              * @description How the operator charges employers for the candidate directory. `paid_messaging` leaves profiles fully visible and spends a credit on a first cold message; `paid_unlocks_and_messaging` also redacts directory cards and gates the opaque `/p/{id}` profile route behind an unlock credit. `null` means the operator has not chosen explicitly, in which case infer it from the published `talent_access` plans: any plan granting profile unlocks means `paid_unlocks_and_messaging`, otherwise `paid_messaging`. The paywall is inert regardless when the board publishes no talent plan. An anonymous viewer has no entitlement read to derive this from, so it ships here rather than only on `me/talent-access`.
@@ -3590,7 +3605,7 @@ interface components {
                      */
                     lte?: string;
                 };
-                /** @description Only return jobs in the place with this slug, including the places inside it (a region includes its cities). The slug can also name a country or region remote jobs on the board are open to, as `GET /places?q=` suggests. Pass `radius` to widen a city or locality to nearby jobs. A place slug from `GET /places/suggest` returns jobs within `radius` km of that place, by default a distance that suits its size. Unresolvable slugs are ignored. */
+                /** @description Only return jobs in the place with this slug, including the places inside it (a region includes its cities). The slug can also name a country or region remote jobs on the board are open to, as `GET /places?q=` suggests. Pass `radius` to widen a city or locality to nearby jobs. A place slug from `GET /places/suggest` returns jobs within `radius` km of that place, by default a distance that suits its size. Unresolvable slugs are ignored. The reserved slugs `remote`, `hybrid` and `on-site` name a work arrangement, not a place: they return the jobs `remoteOption` `remote`, `hybrid` or `on_site` returns, ignore `radius`, and combined with a `remoteOption` that leaves that arrangement out return no jobs. */
                 location?: string;
                 /** @description Widen a city or locality `location` to also return jobs placed in a city or locality within this many kilometres of the place (1–250; decimals allowed, e.g. `8.05` for 5 miles). Omit for jobs in the place itself. Ignored for region and country places, and without `location`. For a place from `GET /places/suggest`, an omitted `radius` uses the place's own default distance: 15 km for a neighbourhood, 25 km for a town, 50 km for a city. */
                 radius?: number;
@@ -3666,6 +3681,8 @@ interface components {
             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;
+            /** @description The number of the board's companies tagged with this market. Present on market resolutions only. The board's sitemap lists a market page only when this is at least 5; emit `noindex, follow` on the plain market page below 5 so the two agree. */
+            companyCount?: number;
         };
         PublicTaxonomyTerm: {
             /** @enum {string} */

package/dist/{blog-BLpOmpyQ.d.ts → blog-BaVJi3q1.d.ts}

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

package/dist/{blog-BmfbjijG.d.mts → blog-DCRBPnpZ.d.mts}

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

package/dist/{board-CXd9Me7_.d.mts → board-DMS3I3sJ.d.mts}

@@ -1,5 +1,5 @@
-import { S as Schemas } from './_spec-BehBmeHK.mjs';
-import { L as ListEnvelope, v as RelatedSearch, b as CustomFieldFilter, O as ObjectReferenceFilter, a as JobCapability } from './jobs-CbTUedOr.mjs';
+import { S as Schemas } from './_spec-CFOj7Qdf.mjs';
+import { L as ListEnvelope, v as RelatedSearch, b as CustomFieldFilter, O as ObjectReferenceFilter, a as JobCapability } from './jobs-Cew_q69W.mjs';
 
 type PublicCompany = Schemas['CompanyPublic'];
 /**

package/dist/{board-dV_3NXAI.d.ts → board-zLt7j6hj.d.ts}

@@ -1,5 +1,5 @@
-import { S as Schemas } from './_spec-BehBmeHK.js';
-import { L as ListEnvelope, v as RelatedSearch, b as CustomFieldFilter, O as ObjectReferenceFilter, a as JobCapability } from './jobs-D2mKA65F.js';
+import { S as Schemas } from './_spec-CFOj7Qdf.js';
+import { L as ListEnvelope, v as RelatedSearch, b as CustomFieldFilter, O as ObjectReferenceFilter, a as JobCapability } from './jobs-Dz_w1jZq.js';
 
 type PublicCompany = Schemas['CompanyPublic'];
 /**

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

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