@cavuno/board 4.65.0 → 4.66.0

package/dist/sitemap.d.mts

@@ -1,10 +1,10 @@
 import { BoardSdk } from './index.mjs';
-import './_spec-CIufstif.mjs';
-import './search-PrqcJMft.mjs';
-import './jobs-CbXbDBij.mjs';
-import './board-DZNCHGgl.mjs';
-import './seo-ohehUCzN.mjs';
-import './blog-teDJ9KaO.mjs';
+import './_spec-DBI6azWs.mjs';
+import './search-CrXCM8Hq.mjs';
+import './jobs-qoVMh_Zd.mjs';
+import './board-BsUhxdjL.mjs';
+import './seo-DRVgmTCQ.mjs';
+import './blog-Bx-rjH4V.mjs';
 
 /**
  * Sitemap primitives — the pure XML + bucket-filename logic behind a board

package/dist/sitemap.d.ts

@@ -1,10 +1,10 @@
 import { BoardSdk } from './index.js';
-import './_spec-CIufstif.js';
-import './search-B7x4qt9A.js';
-import './jobs-DM_QMccX.js';
-import './board-iCHYuNhr.js';
-import './seo-C1Br7ygq.js';
-import './blog-DuNJLfIh.js';
+import './_spec-DBI6azWs.js';
+import './search-DPHLf8pI.js';
+import './jobs-Dyj1HZ8W.js';
+import './board-USJ9ZZab.js';
+import './seo-BDwe8PwT.js';
+import './blog--VKuBIdw.js';
 
 /**
  * Sitemap primitives — the pure XML + bucket-filename logic behind a board

package/dist/sitemap.mjs

@@ -3,7 +3,7 @@ import {
 } from "./chunk-DLSO6XXY.mjs";
 import {
   isNotFound
-} from "./chunk-H3YIWHXR.mjs";
+} from "./chunk-R62XFNS7.mjs";
 import {
   BOARD_PATHS,
   blogAuthorPath,

package/dist/suggest.d.mts

@@ -1,5 +1,5 @@
-import { h as SuggestionItem, b as SearchSuggestQuery, F as FetchOptions, g as SuggestResult } from './search-PrqcJMft.mjs';
-import './_spec-CIufstif.mjs';
+import { h as SuggestionItem, b as SearchSuggestQuery, F as FetchOptions, g as SuggestResult } from './search-CrXCM8Hq.mjs';
+import './_spec-DBI6azWs.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-B7x4qt9A.js';
-import './_spec-CIufstif.js';
+import { h as SuggestionItem, b as SearchSuggestQuery, F as FetchOptions, g as SuggestResult } from './search-DPHLf8pI.js';
+import './_spec-DBI6azWs.js';
 
 /**
  * `@cavuno/board/suggest` — framework-agnostic headless search-suggest

package/package.json

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

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

@@ -112,18 +112,26 @@ const categoryOptions = categories.data.map((term) => ({
 }));
 ```
 
-For homepage "browse by category" tiles, ask for the busiest terms rather
-than the first page of the name-sorted collection:
+Categories also carry `totalJobCount`: published jobs on the category or
+any subcategory, each job once. A parent category page lists its
+subcategories' jobs, so show `totalJobCount` next to category links. A parent
+whose jobs all sit in subcategories has `jobCount` 0 and is still listed.
+
+For homepage "browse by category" tiles, ask for the busiest top-level
+categories rather than the first page of the name-sorted collection:
 
 ```ts snippet
 const top = await board.taxonomy.categories.list({
+  topLevel: true,
   limit: 8,
-  sort: 'jobCount',
+  sort: 'totalJobCount',
 });
 ```
 
 Category and skill lists accept `q`, `limit` (1–100), `sort` (`name` or
-`jobCount`), and opaque `cursor`. Pass `nextCursor` unchanged to the next
+`jobCount`; categories also `totalJobCount`), and opaque `cursor`. With
+`sort: 'jobCount'` and no `q` or `topLevel`, a parent with no jobs of its own
+is left out; `totalJobCount` includes it. Pass `nextCursor` unchanged to the next
 request. The cursor is bound to `q`, `limit`, and `sort`.
 
 ```ts snippet

package/skills/cavuno-board-post-a-job/SKILL.md

@@ -5,7 +5,7 @@ description: Post a job publicly with @cavuno/board. Use for plan selection, log
 
 # Status-first job posting
 
-The public posting funnel is anonymous and rate-limited. Its invariant is status-first handling: `board.jobPosting.create` returns one of four success states, and the host follows that state. Rejected submissions throw `BoardApiError` instead.
+The public posting funnel is anonymous and rate-limited. Its invariant is status-first handling: `board.jobPosting.create` returns one of its success states, and the host follows that state. Rejected submissions throw `BoardApiError` instead.
 
 Employer dashboard job management belongs to `board.me.companies.jobs.*`. Candidate access payments belong to `cavuno-board-paywall`.
 
@@ -160,11 +160,59 @@ switch (result.status) {
 
 The mapping is:
 
-- paid Stripe plan → `checkout`;
+- paid Stripe plan → `checkout`, or `embedded_checkout` when you send `checkoutUiMode: 'embedded_page'`;
 - free or credited posting → `published`, or `pending_approval` on moderated boards;
 - invoice plan → `invoice_sent`.
 
-The checkout value is a URL for a host-owned full-page redirect. Payment publication happens by webhook; the SDK exposes no Stripe integration or publish-confirm method.
+`checkoutUrl` is a URL for a host-owned full-page redirect. Payment publication happens by webhook; the SDK exposes no Stripe integration or publish-confirm method.
+
+## Embedded checkout
+
+To keep the poster on your page, send `checkoutUiMode: 'embedded_page'`. A paid plan then returns `embedded_checkout` with everything Stripe.js needs. Load Stripe.js from `js.stripe.com` yourself; the SDK never bundles it.
+
+```ts no-check
+const result = await board.jobPosting.create({
+  submission,
+  checkoutUiMode: 'embedded_page',
+});
+
+if (result.status === 'embedded_checkout') {
+  const stripe = await loadStripe(result.publishableKey, {
+    stripeAccount: result.stripeAccountId,
+  });
+  const checkout = await stripe.initEmbeddedCheckout({
+    clientSecret: result.clientSecret,
+    onComplete: () => showPaid(result.sessionId),
+  });
+  checkout.mount('#checkout');
+}
+```
+
+Cards finish in place and fire `onComplete`. Payment methods that need a redirect still return to the board's `/post/success`, so that page must exist in both modes.
+
+## Checkout outcome
+
+After either checkout, read what happened with the session id: `sessionId` from `embedded_checkout`, or `session_id` on the `/post/success` return URL. `awaiting_payment` lasts until the payment webhook lands, so poll briefly. `processing` means a bank payment is still clearing and can take days; `payment_failed` means it failed. `jobStatus` and `jobUrl` say whether the job is live.
+
+```ts snippet
+const outcome = await board.jobPosting.getCheckout(sessionId);
+
+switch (outcome.status) {
+  case 'paid':
+    if (outcome.jobUrl) linkToJob(outcome.jobUrl);
+    break;
+  case 'processing':
+    showPaymentProcessing(outcome.jobTitle);
+    break;
+  case 'awaiting_payment':
+    retrySoon();
+    break;
+  case 'payment_failed':
+  case 'canceled':
+    offerToPostAgain();
+    break;
+}
+```
 
 ## Verified existing credit
 
@@ -200,8 +248,9 @@ Bare-email billing lookup is intentionally absent because it would expose whethe
 ## Completion gate
 
 - The form renders `forms.job` in order: hidden entries are absent, required and locked entries block submit while empty, and an unknown built-in key is skipped.
-- Every `create` call handles all four statuses.
-- Paid checkout redirects through `checkoutUrl`; the job appears only after webhook completion.
+- Every `create` call handles every status it can return (`embedded_checkout` only with `checkoutUiMode: 'embedded_page'`).
+- Paid checkout redirects through `checkoutUrl` or mounts `clientSecret`; the job appears only after webhook completion.
+- The return page reads `getCheckout(sessionId)` and tells `paid` from `processing`.
 - Free unmoderated submission returns a resolving `jobSlug`.
 - Missing domain logos leave submission usable without `logoUrl`.
 - Existing credit is selectable only after token verification.

package/skills/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "4.65.0",
+  "version": "4.66.0",
   "skills": [
     {
       "name": "cavuno-board-account",