@cavuno/board 4.62.0 → 4.64.0

package/CHANGELOG.md

@@ -3,6 +3,32 @@
 This changelog records changes that affect Board API compatibility, exported
 types, runtime behavior, or supported integration patterns.
 
+## 4.64.0 — 2026-11-05
+
+- Tip jar: tippers can cover the card fee. `board.tipJar.get` returns
+  `coverFee` (the card rate) or null when the board doesn't offer it,
+  `board.tipJar.checkout` takes `coverFee: true` to add the fee as a
+  separate line, and the checkout status reports `coverFeeCents`.
+- New exported helper `tipCoverFeeCents(amountCents, tipJar.coverFee)`
+  returns the same fee the checkout charges.
+- New error code: `tip_fee_cover_not_allowed`.
+
+## 4.63.0 — 2026-11-05
+
+- `board.me.profile.listVerifications` returns a row for every item on the
+  profile that can be verified, including unchecked ones, typed as the new
+  exported `MyItemVerification`. Each row's `nextStep` (`email`, `team` or
+  `none`) says which check the item allows now, and `emailCheck` is set
+  while an emailed code is waiting. A rejected item reopens only after its
+  checked details change.
+- New operator operations: `batchPlans` (`POST /plans/batch`, up to 10
+  complete plans with their prices per call) and `listTodos`
+  (`GET /todos`, the board's setup to-dos as they read on Home).
+- Domains returned by the operator domain operations carry `dnsRecords`,
+  the routing records to add at the DNS provider.
+- `PATCH /jobs/{id}` clears `experienceMonths` and in-office attendance
+  when they are sent as `null`.
+
 ## 4.62.0 — 2026-11-04
 
 - Tip jar. `board.tipJar.get` reads the board's tip page settings,

package/dist/{_spec-BCwCDDX2.d.mts → _spec-D1Qg_Twd.d.mts}

@@ -1373,7 +1373,7 @@ interface components {
              * @enum {string}
              */
             remoteOption: "on_site" | "hybrid" | "remote";
-            /** @description Where remote candidates must hold work authorization. Each entry is the smallest relevant scope: `worldwide`, a `world_region` (EMEA / LATAM / NA / APAC), a `continent`, a `region`, a `subregion`, a `custom` group (e.g. `EU`), a `country` (ISO 3166-1 alpha-2), or a `subdivision` (ISO 3166-2). Subdivisions auto-imply their parent country in the derived `remoteWorkPermitCountryCodes` output. Worldwide is mutually exclusive with all other entries. The canonical `{type, value}` set is published at `GET /v1/taxonomies/remote-permits`. Pass `[]` to clear an existing constraint. */
+            /** @description Where remote candidates must hold work authorization. Each entry is the smallest relevant scope: `worldwide`, a `world_region` (EMEA / LATAM / NA / APAC), a `continent`, a `region`, a `subregion`, a `custom` group (e.g. `EU`), a `country` (ISO 3166-1 alpha-2), or a `subdivision` (ISO 3166-2). Subdivisions auto-imply their parent country in the derived `remoteWorkPermitCountryCodes` output. Worldwide is mutually exclusive with all other entries. The canonical `{type, value}` set is published at `GET /v1/taxonomies/remote-permits`. Pass `[]` to clear an existing constraint on an `on_site` or `hybrid` job; a `remote` job always needs at least one entry, so send `[{"type":"worldwide","value":"worldwide"}]` to lift the restriction. */
             remotePermits?: {
                 /** @enum {string} */
                 type: "worldwide" | "world_region" | "continent" | "region" | "subregion" | "subdivision" | "country" | "custom";
@@ -1688,7 +1688,7 @@ interface components {
              * @enum {string}
              */
             remoteOption?: "on_site" | "hybrid" | "remote";
-            /** @description Where remote candidates must hold work authorization. Each entry is the smallest relevant scope: `worldwide`, a `world_region` (EMEA / LATAM / NA / APAC), a `continent`, a `region`, a `subregion`, a `custom` group (e.g. `EU`), a `country` (ISO 3166-1 alpha-2), or a `subdivision` (ISO 3166-2). Subdivisions auto-imply their parent country in the derived `remoteWorkPermitCountryCodes` output. Worldwide is mutually exclusive with all other entries. The canonical `{type, value}` set is published at `GET /v1/taxonomies/remote-permits`. Pass `[]` to clear an existing constraint. */
+            /** @description Where remote candidates must hold work authorization. Each entry is the smallest relevant scope: `worldwide`, a `world_region` (EMEA / LATAM / NA / APAC), a `continent`, a `region`, a `subregion`, a `custom` group (e.g. `EU`), a `country` (ISO 3166-1 alpha-2), or a `subdivision` (ISO 3166-2). Subdivisions auto-imply their parent country in the derived `remoteWorkPermitCountryCodes` output. Worldwide is mutually exclusive with all other entries. The canonical `{type, value}` set is published at `GET /v1/taxonomies/remote-permits`. Pass `[]` to clear an existing constraint on an `on_site` or `hybrid` job; a `remote` job always needs at least one entry, so send `[{"type":"worldwide","value":"worldwide"}]` to lift the restriction. */
             remotePermits?: {
                 /** @enum {string} */
                 type: "worldwide" | "world_region" | "continent" | "region" | "subregion" | "subdivision" | "country" | "custom";
@@ -1804,7 +1804,7 @@ interface components {
             object: "item_verification";
             itemKey: string;
             /**
-             * @description `changed`: a checked field was edited after verification. `lapsed`: past its expiry or re-check date (see `lapseReason`).
+             * @description `changed`: a checked field was edited after the item was verified or rejected. `lapsed`: past its expiry or re-check date (see `lapseReason`).
              * @enum {string}
              */
             status: "unverified" | "pending" | "needs_info" | "verified" | "rejected" | "unable_to_verify" | "changed" | "lapsed" | "revoked";
@@ -2266,6 +2266,35 @@ interface components {
             /** @description The target stage id. */
             stageId: string;
         };
+        MyItemVerification: components["schemas"]["ItemVerification"] & {
+            /** @description The verification's id. For an item with no verification yet (`unverified`), its `itemKey`. */
+            id?: string;
+            /**
+             * Format: date-time
+             * @description When the verification last changed. For an item with no verification yet, when the profile last saved it.
+             */
+            updatedAt?: string;
+            /**
+             * @description What the worker can do for this item now, from its state on the server. `email`: the item allows an email-domain check (`POST …/verifications/email-domain`); asking the board team is also allowed. A start can still be rate limited (per item, per worker, or within a minute of the last check), and the route then answers `429` with `item_verification_rate_limited`. `team`: the item allows only asking the board team (`POST …/verifications`), for example a past job, an item with no website, a field the team verifies, or a rejected item whose checked details were edited since. `none`: nothing to do now (waiting for review, verified, revoked, or rejected and not edited since). Company profile items are never `email`.
+             * @enum {string}
+             */
+            nextStep: "email" | "team" | "none";
+            /** @description A code emailed for this item that can still be typed (`POST …/verifications/email-domain/confirm`), so a client can return to the code step after a reload. `null` when there is none, it expired, or the item changed since it was sent. Only set while `nextStep` is `email`. */
+            emailCheck: {
+                /** @description The domain the code was sent to. The address itself is never stored. */
+                domain: string;
+                /**
+                 * Format: date-time
+                 * @description When the emailed code stops working.
+                 */
+                codeExpiresAt: string;
+                /**
+                 * Format: date-time
+                 * @description When a new check can send another email for this item; before then a new check sends nothing.
+                 */
+                resendAvailableAt: string;
+            } | null;
+        };
         NotificationPreference: {
             /** @enum {string} */
             object: "notification_preference";
@@ -4466,6 +4495,13 @@ interface components {
             allowNote: boolean;
             /** @description The longest note, in characters (280). */
             noteMaxLength: number;
+            /** @description The card rate behind "Add {fee} to cover the card fee", or `null` when the board does not offer it (then leave `coverFee` out of the checkout body). The fee for a tip of A minor units is ceil((A + fixedMinor) / (1 - percentBps / 10000)) - A, so the board keeps the whole tip after the card fee; show it next to the checkbox and send `coverFee: true` when ticked. */
+            coverFee: {
+                /** @description The percentage part of the card rate, in basis points (290 is 2.9%). */
+                percentBps: number;
+                /** @description The fixed part of the card rate, in minor units of the currency. */
+                fixedMinor: number;
+            } | null;
             /** @description Plain text shown after a tip; `null` when unset. */
             thankYouMessage: string | null;
             /** @description Tips so far, when the board shows the number of tips; otherwise `null`. */
@@ -4494,6 +4530,8 @@ interface components {
             amountCents: number;
             /** @description Optional plain-text note for the board, at most 280 characters (longer is refused with `tip_note_too_long`). Only when `allowNote` is true; leave it out otherwise. */
             note?: string;
+            /** @description Add the card fee on top of the tip, so the board keeps the whole tip. Default false. Only when the tip jar `coverFee` is not `null` (otherwise refused with `tip_fee_cover_not_allowed`); the checkout then charges `amountCents` plus the fee worked out from it. */
+            coverFee?: boolean;
             /** @description The relative path Stripe returns the tipper to (`session_id` is appended). Defaults to the tip page. */
             returnPath?: string;
             /** @description Honeypot. Render it hidden and leave it empty; a filled value is answered like a success and nothing is recorded. */
@@ -4507,7 +4545,10 @@ interface components {
              * @enum {string}
              */
             status: "processing" | "paid";
+            /** @description The tip, without the card fee. */
             amountCents: number;
+            /** @description The card fee the tipper added on top of the tip; 0 when none. The charge was `amountCents` + `coverFeeCents`. */
+            coverFeeCents: number;
             currency: string;
             /** @description Where the receipt goes, masked (`m•••@gmail.com`): the session id is in a URL that can be shared. `null` until paid, or when Stripe collected none. */
             receiptEmail: string | null;

package/dist/{_spec-BCwCDDX2.d.ts → _spec-D1Qg_Twd.d.ts}

@@ -1373,7 +1373,7 @@ interface components {
              * @enum {string}
              */
             remoteOption: "on_site" | "hybrid" | "remote";
-            /** @description Where remote candidates must hold work authorization. Each entry is the smallest relevant scope: `worldwide`, a `world_region` (EMEA / LATAM / NA / APAC), a `continent`, a `region`, a `subregion`, a `custom` group (e.g. `EU`), a `country` (ISO 3166-1 alpha-2), or a `subdivision` (ISO 3166-2). Subdivisions auto-imply their parent country in the derived `remoteWorkPermitCountryCodes` output. Worldwide is mutually exclusive with all other entries. The canonical `{type, value}` set is published at `GET /v1/taxonomies/remote-permits`. Pass `[]` to clear an existing constraint. */
+            /** @description Where remote candidates must hold work authorization. Each entry is the smallest relevant scope: `worldwide`, a `world_region` (EMEA / LATAM / NA / APAC), a `continent`, a `region`, a `subregion`, a `custom` group (e.g. `EU`), a `country` (ISO 3166-1 alpha-2), or a `subdivision` (ISO 3166-2). Subdivisions auto-imply their parent country in the derived `remoteWorkPermitCountryCodes` output. Worldwide is mutually exclusive with all other entries. The canonical `{type, value}` set is published at `GET /v1/taxonomies/remote-permits`. Pass `[]` to clear an existing constraint on an `on_site` or `hybrid` job; a `remote` job always needs at least one entry, so send `[{"type":"worldwide","value":"worldwide"}]` to lift the restriction. */
             remotePermits?: {
                 /** @enum {string} */
                 type: "worldwide" | "world_region" | "continent" | "region" | "subregion" | "subdivision" | "country" | "custom";
@@ -1688,7 +1688,7 @@ interface components {
              * @enum {string}
              */
             remoteOption?: "on_site" | "hybrid" | "remote";
-            /** @description Where remote candidates must hold work authorization. Each entry is the smallest relevant scope: `worldwide`, a `world_region` (EMEA / LATAM / NA / APAC), a `continent`, a `region`, a `subregion`, a `custom` group (e.g. `EU`), a `country` (ISO 3166-1 alpha-2), or a `subdivision` (ISO 3166-2). Subdivisions auto-imply their parent country in the derived `remoteWorkPermitCountryCodes` output. Worldwide is mutually exclusive with all other entries. The canonical `{type, value}` set is published at `GET /v1/taxonomies/remote-permits`. Pass `[]` to clear an existing constraint. */
+            /** @description Where remote candidates must hold work authorization. Each entry is the smallest relevant scope: `worldwide`, a `world_region` (EMEA / LATAM / NA / APAC), a `continent`, a `region`, a `subregion`, a `custom` group (e.g. `EU`), a `country` (ISO 3166-1 alpha-2), or a `subdivision` (ISO 3166-2). Subdivisions auto-imply their parent country in the derived `remoteWorkPermitCountryCodes` output. Worldwide is mutually exclusive with all other entries. The canonical `{type, value}` set is published at `GET /v1/taxonomies/remote-permits`. Pass `[]` to clear an existing constraint on an `on_site` or `hybrid` job; a `remote` job always needs at least one entry, so send `[{"type":"worldwide","value":"worldwide"}]` to lift the restriction. */
             remotePermits?: {
                 /** @enum {string} */
                 type: "worldwide" | "world_region" | "continent" | "region" | "subregion" | "subdivision" | "country" | "custom";
@@ -1804,7 +1804,7 @@ interface components {
             object: "item_verification";
             itemKey: string;
             /**
-             * @description `changed`: a checked field was edited after verification. `lapsed`: past its expiry or re-check date (see `lapseReason`).
+             * @description `changed`: a checked field was edited after the item was verified or rejected. `lapsed`: past its expiry or re-check date (see `lapseReason`).
              * @enum {string}
              */
             status: "unverified" | "pending" | "needs_info" | "verified" | "rejected" | "unable_to_verify" | "changed" | "lapsed" | "revoked";
@@ -2266,6 +2266,35 @@ interface components {
             /** @description The target stage id. */
             stageId: string;
         };
+        MyItemVerification: components["schemas"]["ItemVerification"] & {
+            /** @description The verification's id. For an item with no verification yet (`unverified`), its `itemKey`. */
+            id?: string;
+            /**
+             * Format: date-time
+             * @description When the verification last changed. For an item with no verification yet, when the profile last saved it.
+             */
+            updatedAt?: string;
+            /**
+             * @description What the worker can do for this item now, from its state on the server. `email`: the item allows an email-domain check (`POST …/verifications/email-domain`); asking the board team is also allowed. A start can still be rate limited (per item, per worker, or within a minute of the last check), and the route then answers `429` with `item_verification_rate_limited`. `team`: the item allows only asking the board team (`POST …/verifications`), for example a past job, an item with no website, a field the team verifies, or a rejected item whose checked details were edited since. `none`: nothing to do now (waiting for review, verified, revoked, or rejected and not edited since). Company profile items are never `email`.
+             * @enum {string}
+             */
+            nextStep: "email" | "team" | "none";
+            /** @description A code emailed for this item that can still be typed (`POST …/verifications/email-domain/confirm`), so a client can return to the code step after a reload. `null` when there is none, it expired, or the item changed since it was sent. Only set while `nextStep` is `email`. */
+            emailCheck: {
+                /** @description The domain the code was sent to. The address itself is never stored. */
+                domain: string;
+                /**
+                 * Format: date-time
+                 * @description When the emailed code stops working.
+                 */
+                codeExpiresAt: string;
+                /**
+                 * Format: date-time
+                 * @description When a new check can send another email for this item; before then a new check sends nothing.
+                 */
+                resendAvailableAt: string;
+            } | null;
+        };
         NotificationPreference: {
             /** @enum {string} */
             object: "notification_preference";
@@ -4466,6 +4495,13 @@ interface components {
             allowNote: boolean;
             /** @description The longest note, in characters (280). */
             noteMaxLength: number;
+            /** @description The card rate behind "Add {fee} to cover the card fee", or `null` when the board does not offer it (then leave `coverFee` out of the checkout body). The fee for a tip of A minor units is ceil((A + fixedMinor) / (1 - percentBps / 10000)) - A, so the board keeps the whole tip after the card fee; show it next to the checkbox and send `coverFee: true` when ticked. */
+            coverFee: {
+                /** @description The percentage part of the card rate, in basis points (290 is 2.9%). */
+                percentBps: number;
+                /** @description The fixed part of the card rate, in minor units of the currency. */
+                fixedMinor: number;
+            } | null;
             /** @description Plain text shown after a tip; `null` when unset. */
             thankYouMessage: string | null;
             /** @description Tips so far, when the board shows the number of tips; otherwise `null`. */
@@ -4494,6 +4530,8 @@ interface components {
             amountCents: number;
             /** @description Optional plain-text note for the board, at most 280 characters (longer is refused with `tip_note_too_long`). Only when `allowNote` is true; leave it out otherwise. */
             note?: string;
+            /** @description Add the card fee on top of the tip, so the board keeps the whole tip. Default false. Only when the tip jar `coverFee` is not `null` (otherwise refused with `tip_fee_cover_not_allowed`); the checkout then charges `amountCents` plus the fee worked out from it. */
+            coverFee?: boolean;
             /** @description The relative path Stripe returns the tipper to (`session_id` is appended). Defaults to the tip page. */
             returnPath?: string;
             /** @description Honeypot. Render it hidden and leave it empty; a filled value is answered like a success and nothing is recorded. */
@@ -4507,7 +4545,10 @@ interface components {
              * @enum {string}
              */
             status: "processing" | "paid";
+            /** @description The tip, without the card fee. */
             amountCents: number;
+            /** @description The card fee the tipper added on top of the tip; 0 when none. The charge was `amountCents` + `coverFeeCents`. */
+            coverFeeCents: number;
             currency: string;
             /** @description Where the receipt goes, masked (`m•••@gmail.com`): the session id is in a URL that can be shared. `null` until paid, or when Stripe collected none. */
             receiptEmail: string | null;

package/dist/{blog-BQ869KiE.d.ts → blog-Dp2jAVVM.d.ts}

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

package/dist/{blog-C0wl_hx8.d.mts → blog-e0YbZBjg.d.mts}

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

package/dist/{board-D5x6dfUk.d.ts → board-BeNZLOYC.d.ts}

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

package/dist/{board-D2ImSfzo.d.mts → board-Cc3wbTKI.d.mts}

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

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

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