@cavuno/board 4.60.0 → 4.62.0

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.60.0",
+  "version": "4.62.0",
   "description": "Build custom job boards and careers pages with Cavuno’s TypeScript SDK.",
   "keywords": [
     "api-client",

package/skills/cavuno-board-job-alerts/SKILL.md

@@ -108,6 +108,36 @@ await board.jobAlerts.updatePreference({
 });
 ```
 
+## Anonymous lane: digest engagement
+
+Digest job links open your job page with `ja_alert`, `ja_email`, `ja_pos` and `ja_mv`. Report the click from the job page's server code, once per full `GET` (not on prefetches or `HEAD`), and forward the visitor's user agent so crawlers and link scanners are left out. `recordClick` always resolves with `status: 'accepted'`; never block the page on it.
+
+Digest manage and unsubscribe links carry `ja_alert` and `ja_email`. Spread them into `unsubscribe` to attribute the unsubscribe to that email; a link without them returns `null`, which spreads to nothing.
+
+```ts snippet
+import {
+  parseJobAlertClickParams,
+  parseJobAlertUnsubscribeParams,
+} from '@cavuno/board';
+
+const click = parseJobAlertClickParams(request.url);
+if (click) {
+  await board.jobAlerts
+    .recordClick({
+      ...click,
+      jobId: job.id,
+      userAgent: request.headers.get('user-agent') ?? undefined,
+    })
+    .catch(() => undefined);
+}
+
+await board.jobAlerts.unsubscribe({
+  subscriptionId,
+  token,
+  ...parseJobAlertUnsubscribeParams(request.url),
+});
+```
+
 ## Signed-in lane
 
 Authenticated alerts use `placeIds`, while anonymous alerts use `placeSlugs`. Create and update accept the same `AlertBody`; update is a full replacement.
@@ -150,6 +180,7 @@ Removal is the signed-in lane's stop action; there is no pause state.
 - Anonymous subscribe sends `consent: true` and reveals no subscription existence.
 - The confirm UI handles all four statuses, including resend after expiry.
 - Manage reads use `subscription`; manage writes use `subscriptionId`.
+- Job pages opened from a digest call `recordClick` once, server-side, with the visitor's user agent; the unsubscribe passes the link's `ja_*` attribution.
 - Editing one field preserves every other field in both full-replace APIs.
 - UI promises only weekly delivery filtered by job function, place, and remote option.
 

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,31 @@ 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
+
+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
+  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` (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 +154,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.60.0",
+  "version": "4.62.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"