@cavuno/board 4.61.0 → 4.63.0

package/dist/sitemap.mjs

@@ -3,7 +3,7 @@ import {
 } from "./chunk-DLSO6XXY.mjs";
 import {
   isNotFound
-} from "./chunk-M4CX64RC.mjs";
+} from "./chunk-COHTNSU2.mjs";
 import {
   BOARD_PATHS,
   blogAuthorPath,
@@ -19,7 +19,7 @@ import {
   salaryLocationPath,
   salarySkillPath,
   salaryTitlePath
-} from "./chunk-MSY7ERBY.mjs";
+} from "./chunk-RAE63XH5.mjs";
 
 // src/sitemap/xml.ts
 var SITEMAP_BUCKETS = [

package/dist/suggest.d.mts

@@ -1,5 +1,5 @@
-import { h as SuggestionItem, b as SearchSuggestQuery, F as FetchOptions, g as SuggestResult } from './search-CbGEG89W.mjs';
-import './_spec-B6YOcfhm.mjs';
+import { h as SuggestionItem, b as SearchSuggestQuery, F as FetchOptions, g as SuggestResult } from './search-BtrwcLkc.mjs';
+import './_spec-D1Qg_Twd.mjs';
 
 /**
  * `@cavuno/board/suggest` — framework-agnostic headless search-suggest

package/dist/suggest.d.ts

@@ -1,5 +1,5 @@
-import { h as SuggestionItem, b as SearchSuggestQuery, F as FetchOptions, g as SuggestResult } from './search-D4Uo2bRh.js';
-import './_spec-B6YOcfhm.js';
+import { h as SuggestionItem, b as SearchSuggestQuery, F as FetchOptions, g as SuggestResult } from './search-DZeNdYN6.js';
+import './_spec-D1Qg_Twd.js';
 
 /**
  * `@cavuno/board/suggest` — framework-agnostic headless search-suggest

package/dist/well-known.d.mts

@@ -1,4 +1,4 @@
-import { R as RouteEntry, a as RouteRole } from './roles-B_d0igKI.mjs';
+import { R as RouteEntry, a as RouteRole } from './roles-D745cT5b.mjs';
 
 /**
  * Runtime well-known endpoint — Request → Response serving ManifestV1

package/dist/well-known.d.ts

@@ -1,4 +1,4 @@
-import { R as RouteEntry, a as RouteRole } from './roles-B_d0igKI.js';
+import { R as RouteEntry, a as RouteRole } from './roles-D745cT5b.js';
 
 /**
  * Runtime well-known endpoint — Request → Response serving ManifestV1

package/dist/well-known.js

@@ -118,7 +118,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
@@ -158,7 +160,8 @@ var ROLE_PARAM_REGISTRY = {
   alertsManage: [],
   alertsConfirm: [],
   products: [],
-  mePurchases: []
+  mePurchases: [],
+  tip: []
 };
 var REQUIRED_ROLES = [
   "jobDetail",
@@ -207,7 +210,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
   }
 };
 
@@ -500,7 +504,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
 };
 
 // src/well-known/handler.ts

package/dist/well-known.mjs

@@ -1,7 +1,7 @@
 import {
   compileManifest
-} from "./chunk-LO7D3AIX.mjs";
-import "./chunk-MSY7ERBY.mjs";
+} from "./chunk-HHMY3W7T.mjs";
+import "./chunk-RAE63XH5.mjs";
 
 // src/well-known/handler.ts
 var WELL_KNOWN_CACHE_CONTROL = "public, max-age=300";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cavuno/board",
-  "version": "4.61.0",
+  "version": "4.63.0",
   "description": "Build custom job boards and careers pages with Cavuno’s TypeScript SDK.",
   "keywords": [
     "api-client",

package/skills/cavuno-board-products/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: cavuno-board-products
-description: Digital product storefront with @cavuno/board. Use for product lists and pages, reviews, free claims, embedded paid checkout, the purchase download page with its email confirmation, downloads, buyer reviews, resending the link, or the signed-in buyer's purchases.
+description: Digital product storefront with @cavuno/board. Use for product lists and pages, reviews, free claims, embedded paid checkout, the purchase download page with its email confirmation, downloads, buyer reviews, resending the link, the signed-in buyer's purchases, or the tip jar's tip page and tip checkout.
 ---
 
 # Digital product storefront
@@ -122,6 +122,34 @@ const { data: mine } = await board.purchases.mine({ cache: 'no-store' });
 
 `review` replaces the buyer's earlier review; `product_reviews_disabled` (404) when ratings are off, `purchase_refunded` (409), `purchase_review_invalid` (400). `mine` needs a board user session and lists purchases made while signed in plus those made with the user's verified email, each with `downloadUrl`.
 
+## Tip jar
+
+A board can have one tip jar: visitors tip any amount at or above a minimum on the tip page, `BOARD_PATHS.tip` (`/tip`), the `tip` route role. `board.tipJar` reads it and takes tips; the types are `TipJar`, `TipJarCheckoutBody`, `TipJarCheckout` and `TipJarCheckoutStatus`.
+
+```ts snippet
+const jar = await board.tipJar.get(); // tip_jar_not_found (404): hide the tip page and its links
+// jar.suggestedCents: three amounts, smallest first; jar.minimumCents; jar.allowNote
+// jar.tipCount is null unless the board shows the number of tips
+// jar.coverFee: the card rate, or null when the board does not offer to cover the card fee;
+// tipCoverFeeCents(amountCents, jar.coverFee) is the fee to show ("Add {fee} to cover the card fee")
+
+const kit = await board.tipJar.checkout({
+  amountCents: 500, // at least jar.minimumCents
+  note: 'Thanks for the weekly roundup!', // only when jar.allowNote; 280 characters max
+  coverFee: true, // the tipper ticked "cover the card fee"; only when jar.coverFee is not null
+  returnPath: '/tip',
+  website: '', // honeypot: render hidden, send empty
+});
+// Mount like a paid product: loadStripe(kit.publishableKey, { stripeAccount: kit.stripeAccountId })
+// then initEmbeddedCheckout({ clientSecret: kit.clientSecret }). Expires after 30 minutes.
+
+const status = await board.tipJar.getCheckout(sessionId, { cache: 'no-store' });
+if (status.status === 'paid') showThanks(status.thankYouMessage, status.receiptEmail);
+// 'processing' until the payment clears: poll briefly
+```
+
+Stripe collects the tipper's email (prefilled for a signed-in board user), so the form asks only for the amount and the note. Render the note as a plain `textarea`. `receiptEmail` is masked (`m•••@gmail.com`) because the session id is in a shareable URL. Link to the tip page with `jar.url`, which follows the board's route manifest. Errors: `tip_amount_below_minimum` (400, `details.minimumCents`), `tip_amount_invalid`, `tip_note_not_allowed`, `tip_note_too_long`, `tip_fee_cover_not_allowed` (400), `tip_jar_not_found` (404), `stripe_not_connected` (409), `rate_limited` (429), `rate_limit_unavailable` (503); `getCheckout` with an unknown session is `tip_checkout_not_found` (404). The API never returns other tippers' emails or notes.
+
 ## Completion gate
 
 - The list shows listed products only; a link-only product page renders with `noindex`.
@@ -129,6 +157,7 @@ const { data: mine } = await board.purchases.mine({ cache: 'no-store' });
 - A forwarded download link asks for the email, and the confirmation survives a reload through your own cookie.
 - Downloads start from a button; `purchase_download_limit_reached` disables the button instead of retrying.
 - Download pages, checkout status and `mine()` are `no-store`; purchase paths never reach analytics or the sitemap.
+- The tip page hides when `board.tipJar.get()` is `tip_jar_not_found`; a test tip returns with `session_id` and `getCheckout` reaches `paid`.
 
 ## Cavuno SDK reference
 

package/skills/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "4.61.0",
+  "version": "4.63.0",
   "skills": [
     {
       "name": "cavuno-board-account",
@@ -115,7 +115,7 @@
     },
     {
       "name": "cavuno-board-products",
-      "description": "Digital product storefront with @cavuno/board. Use for product lists and pages, reviews, free claims, embedded paid checkout, the purchase download page with its email confirmation, downloads, buyer reviews, resending the link, or the signed-in buyer's purchases.",
+      "description": "Digital product storefront with @cavuno/board. Use for product lists and pages, reviews, free claims, embedded paid checkout, the purchase download page with its email confirmation, downloads, buyer reviews, resending the link, the signed-in buyer's purchases, or the tip jar's tip page and tip checkout.",
       "path": "skills/cavuno-board-products/SKILL.md",
       "framework": null,
       "category": "core"