@cavuno/board 4.60.0 → 4.62.0

package/CHANGELOG.md

@@ -3,6 +3,44 @@
 This changelog records changes that affect Board API compatibility, exported
 types, runtime behavior, or supported integration patterns.
 
+## 4.62.0 — 2026-11-04
+
+- Tip jar. `board.tipJar.get` reads the board's tip page settings,
+  `board.tipJar.checkout` starts a tip with an embedded Stripe Checkout, and
+  `board.tipJar.getCheckout` reads the tip back after Stripe returns the
+  tipper. New exported types: `TipJar`, `TipJarCheckout`,
+  `TipJarCheckoutBody` and `TipJarCheckoutStatus`.
+- `BOARD_PATHS.tip` (`/tip`) and the `tip` route role. A board without a tip
+  jar may leave the page unpublished.
+- New error codes: `tip_jar_not_found`, `tip_checkout_not_found`,
+  `tip_amount_below_minimum`, `tip_amount_invalid`, `tip_note_not_allowed`
+  and `tip_note_too_long`.
+- New operator operations and events: plan purpose `tip_jar` with a `tipJar`
+  object on the plans operations, `listPlanTips`, and the `tip.received` and
+  `tip.refunded` webhooks.
+
+## 4.61.0 — 2026-11-04
+
+- `board.context()` carries `verification.experience` and
+  `verification.education`: whether workers can get those profile items
+  verified on the board.
+- Email-domain verification of profile items:
+  `board.me.profile.submitEmailDomainVerification` emails a code and a link
+  to an address at the item's domain, and
+  `board.me.profile.confirmEmailDomainVerification` (code) or
+  `board.auth.verifyItemEmail` (link token) confirms it. New exported types:
+  `ItemEmailDomainVerification`, `SubmitItemEmailDomainVerificationBody`,
+  `ConfirmItemEmailDomainVerificationBody` and
+  `ConfirmItemEmailDomainVerificationLinkBody`.
+- `board.me.profile.listVerifications` and
+  `board.me.companies.listVerifications` no longer list items whose type the
+  board has switched verification off for.
+- Job alert digests on your own site: `board.jobAlerts.recordClick` records a
+  visitor opening a job from a digest email, using the params
+  `parseJobAlertClickParams(url)` reads from the job link. Spread
+  `parseJobAlertUnsubscribeParams(url)` into `board.jobAlerts.unsubscribe` to
+  record which digest the subscriber unsubscribed from.
+
 ## 4.60.0 — 2026-11-03
 
 - Profile item verification. `board.me.profile.listVerifications` and

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

@@ -2808,6 +2808,13 @@ interface components {
                 /** @description Whether posting a job on this board requires an active membership. When `true`, render the join gate in place of the anonymous post form: the platform rejects a create from a company with no contributing assignment (`membership_required`). Absent board config defaults to `false`. This flag is board policy and is safe to read anonymously; a signed-in employer's own standing rides their company billing options. */
                 requiresMembership: boolean;
             };
+            /** @description Whether profile item verification is switched on for the built-in experience and education items. */
+            verification: {
+                /** @description Whether workers can get the experience entries on their profile verified on this board. When `false`, hide verification controls for experience items. Absent board config defaults to `false`. */
+                experience: boolean;
+                /** @description Whether workers can get the education entries on their profile verified on this board. When `false`, hide verification controls for education items. Absent board config defaults to `false`. */
+                education: boolean;
+            };
             /** @description Sign-in options per role: the built-in methods and SSO connections switched on for that role. Render the sign-in page from this instead of hard-coding providers; any other method is refused with `board_auth_method_unavailable`. */
             signIn: {
                 candidate: components["schemas"]["BoardRoleSignIn"];
@@ -3108,6 +3115,15 @@ interface components {
             /** @description Configured collection references resolved to current live names, logos, and public record details. Archived collections and records are omitted. */
             resolvedCollectionFields: components["schemas"]["ResolvedJobCollectionField"][];
         };
+        PublicJobAlertClickReceipt: {
+            /** @enum {string} */
+            object: "job_alert_click";
+            /**
+             * @description Always `accepted`. The click is recorded after the response, and only when the alert and the job belong to this board and the visitor is not a crawler, so the response does not reveal either.
+             * @enum {string}
+             */
+            status: "accepted";
+        };
         PublicJobAlertConfirmation: {
             /** @enum {string} */
             object: "job_alert_confirmation";
@@ -4432,6 +4448,71 @@ interface components {
             /** @description Board-language name with source-name fallback. */
             displayName: string;
         };
+        TipJar: {
+            /** @enum {string} */
+            object: "tip_jar";
+            name: string;
+            /** @description Plain-text description. When `descriptionHtml` is set, this is its text. */
+            description: string | null;
+            /** @description Formatted description as sanitized HTML (the same tags as a digital product description). `null` when the board wrote none; show `description` instead. */
+            descriptionHtml: string | null;
+            /** @description Lowercase ISO currency code. */
+            currency: string;
+            /** @description The smallest tip, in minor units: the board's minimum, or Stripe's smallest charge in the currency when none is set. */
+            minimumCents: number;
+            /** @description Three suggested amounts in minor units, smallest first. */
+            suggestedCents: number[];
+            /** @description Whether the tipper may leave a note for the board. */
+            allowNote: boolean;
+            /** @description The longest note, in characters (280). */
+            noteMaxLength: number;
+            /** @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`. */
+            tipCount: number | null;
+            /** @description The tip page path on the board (its route manifest words). */
+            url: string;
+        };
+        TipJarCheckout: {
+            /** @enum {string} */
+            object: "tip_jar_checkout";
+            /**
+             * @description Mount the embedded Stripe Checkout with the mount kit fields. They are `null` only when the request was discarded (the honeypot was filled).
+             * @enum {string}
+             */
+            status: "open";
+            sessionId: string | null;
+            /** @description The Checkout Session client secret. The session expires after 30 minutes. */
+            clientSecret: string | null;
+            /** @description The board’s connected Stripe account. */
+            stripeAccountId: string | null;
+            /** @description The Stripe publishable key for `loadStripe`. */
+            publishableKey: string | null;
+        };
+        TipJarCheckoutBody: {
+            /** @description The tip in minor units of the tip jar currency: at least `minimumCents`. */
+            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 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. */
+            website?: string;
+        };
+        TipJarCheckoutStatus: {
+            /** @enum {string} */
+            object: "tip_jar_checkout_status";
+            /**
+             * @description `processing` until the payment clears (a delayed payment method, or the webhook has not landed yet; poll briefly), then `paid`.
+             * @enum {string}
+             */
+            status: "processing" | "paid";
+            amountCents: 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;
+            thankYouMessage: string | null;
+        };
         TitleLocationSalary: {
             /** @enum {string} */
             object: "title_location_salary";

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

@@ -2808,6 +2808,13 @@ interface components {
                 /** @description Whether posting a job on this board requires an active membership. When `true`, render the join gate in place of the anonymous post form: the platform rejects a create from a company with no contributing assignment (`membership_required`). Absent board config defaults to `false`. This flag is board policy and is safe to read anonymously; a signed-in employer's own standing rides their company billing options. */
                 requiresMembership: boolean;
             };
+            /** @description Whether profile item verification is switched on for the built-in experience and education items. */
+            verification: {
+                /** @description Whether workers can get the experience entries on their profile verified on this board. When `false`, hide verification controls for experience items. Absent board config defaults to `false`. */
+                experience: boolean;
+                /** @description Whether workers can get the education entries on their profile verified on this board. When `false`, hide verification controls for education items. Absent board config defaults to `false`. */
+                education: boolean;
+            };
             /** @description Sign-in options per role: the built-in methods and SSO connections switched on for that role. Render the sign-in page from this instead of hard-coding providers; any other method is refused with `board_auth_method_unavailable`. */
             signIn: {
                 candidate: components["schemas"]["BoardRoleSignIn"];
@@ -3108,6 +3115,15 @@ interface components {
             /** @description Configured collection references resolved to current live names, logos, and public record details. Archived collections and records are omitted. */
             resolvedCollectionFields: components["schemas"]["ResolvedJobCollectionField"][];
         };
+        PublicJobAlertClickReceipt: {
+            /** @enum {string} */
+            object: "job_alert_click";
+            /**
+             * @description Always `accepted`. The click is recorded after the response, and only when the alert and the job belong to this board and the visitor is not a crawler, so the response does not reveal either.
+             * @enum {string}
+             */
+            status: "accepted";
+        };
         PublicJobAlertConfirmation: {
             /** @enum {string} */
             object: "job_alert_confirmation";
@@ -4432,6 +4448,71 @@ interface components {
             /** @description Board-language name with source-name fallback. */
             displayName: string;
         };
+        TipJar: {
+            /** @enum {string} */
+            object: "tip_jar";
+            name: string;
+            /** @description Plain-text description. When `descriptionHtml` is set, this is its text. */
+            description: string | null;
+            /** @description Formatted description as sanitized HTML (the same tags as a digital product description). `null` when the board wrote none; show `description` instead. */
+            descriptionHtml: string | null;
+            /** @description Lowercase ISO currency code. */
+            currency: string;
+            /** @description The smallest tip, in minor units: the board's minimum, or Stripe's smallest charge in the currency when none is set. */
+            minimumCents: number;
+            /** @description Three suggested amounts in minor units, smallest first. */
+            suggestedCents: number[];
+            /** @description Whether the tipper may leave a note for the board. */
+            allowNote: boolean;
+            /** @description The longest note, in characters (280). */
+            noteMaxLength: number;
+            /** @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`. */
+            tipCount: number | null;
+            /** @description The tip page path on the board (its route manifest words). */
+            url: string;
+        };
+        TipJarCheckout: {
+            /** @enum {string} */
+            object: "tip_jar_checkout";
+            /**
+             * @description Mount the embedded Stripe Checkout with the mount kit fields. They are `null` only when the request was discarded (the honeypot was filled).
+             * @enum {string}
+             */
+            status: "open";
+            sessionId: string | null;
+            /** @description The Checkout Session client secret. The session expires after 30 minutes. */
+            clientSecret: string | null;
+            /** @description The board’s connected Stripe account. */
+            stripeAccountId: string | null;
+            /** @description The Stripe publishable key for `loadStripe`. */
+            publishableKey: string | null;
+        };
+        TipJarCheckoutBody: {
+            /** @description The tip in minor units of the tip jar currency: at least `minimumCents`. */
+            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 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. */
+            website?: string;
+        };
+        TipJarCheckoutStatus: {
+            /** @enum {string} */
+            object: "tip_jar_checkout_status";
+            /**
+             * @description `processing` until the payment clears (a delayed payment method, or the webhook has not landed yet; poll briefly), then `paid`.
+             * @enum {string}
+             */
+            status: "processing" | "paid";
+            amountCents: 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;
+            thankYouMessage: string | null;
+        };
         TitleLocationSalary: {
             /** @enum {string} */
             object: "title_location_salary";

package/dist/bin.mjs

@@ -126,7 +126,9 @@ var BOARD_PATHS = {
   /** The digital product catalogue. */
   products: "/products",
   /** A signed-in board user's purchased products. */
-  mePurchases: "/me/purchases"
+  mePurchases: "/me/purchases",
+  /** The tip page: visitors tip the board through its tip jar. */
+  tip: "/tip"
 };
 
 // src/route-contract/roles.ts
@@ -166,7 +168,8 @@ var ROLE_PARAM_REGISTRY = {
   alertsManage: [],
   alertsConfirm: [],
   products: [],
-  mePurchases: []
+  mePurchases: [],
+  tip: []
 };
 var ALL_ROLES = Object.keys(
   ROLE_PARAM_REGISTRY
@@ -210,7 +213,8 @@ var CANONICAL_MANIFEST = {
     alertsManage: "/alerts/manage",
     alertsConfirm: "/alerts/confirm",
     products: BOARD_PATHS.products,
-    mePurchases: BOARD_PATHS.mePurchases
+    mePurchases: BOARD_PATHS.mePurchases,
+    tip: BOARD_PATHS.tip
   }
 };
 
@@ -251,7 +255,8 @@ var ROLE_INDEX_PATHS = {
   product: BOARD_PATHS.products,
   purchase: BOARD_PATHS.home,
   products: BOARD_PATHS.products,
-  mePurchases: BOARD_PATHS.home
+  mePurchases: BOARD_PATHS.home,
+  tip: BOARD_PATHS.home
 };
 function splitSegments(path) {
   const withoutLeading = path.startsWith("/") ? path.slice(1) : path;
@@ -8769,7 +8774,9 @@ var MAY_BE_UNPUBLISHED = /* @__PURE__ */ new Set([
   "privacyPolicy",
   "termsOfService",
   "cookiePolicy",
-  "impressum"
+  "impressum",
+  // A board with no tip jar (or an archived one) has no tip page.
+  "tip"
 ]);
 var GATE_SEGMENTS = /* @__PURE__ */ new Set([
   "password",

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

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

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

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

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

@@ -1,5 +1,5 @@
-import { S as Schemas } from './_spec-DtsIUScQ.mjs';
-import { L as ListEnvelope, v as RelatedSearch, b as CustomFieldFilter, O as ObjectReferenceFilter, a as JobCapability } from './jobs-D-vpMQ6a.mjs';
+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';
 
 type PublicCompany = Schemas['CompanyPublic'];
 /**

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

@@ -1,5 +1,5 @@
-import { S as Schemas } from './_spec-DtsIUScQ.js';
-import { L as ListEnvelope, v as RelatedSearch, b as CustomFieldFilter, O as ObjectReferenceFilter, a as JobCapability } from './jobs-wc4h0pSV.js';
+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';
 
 type PublicCompany = Schemas['CompanyPublic'];
 /**

package/dist/{breadcrumbs-8k7a572J.d.ts → breadcrumbs-CkIH_iCI.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-QuwKsDOt.js';
-import { P as PublicJob } from './jobs-wc4h0pSV.js';
+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';
 
 /**
  * Wire enum for `salaryTimeframe`. Defined here (not re-exported from any

package/dist/{breadcrumbs-BEnF2UAW.d.mts → breadcrumbs-DqkhouJc.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-CWx0nu39.mjs';
-import { P as PublicJob } from './jobs-D-vpMQ6a.mjs';
+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';
 
 /**
  * Wire enum for `salaryTimeframe`. Defined here (not re-exported from any