@cavuno/board 4.63.0 → 4.65.0

package/dist/seo.d.ts

@@ -1,9 +1,9 @@
-import { P as PublicBlogPostSummary, B as BlogAuthorEmbed } from './blog-Dp2jAVVM.js';
-import { e as JsonLdObject } from './breadcrumbs-BOFeIYEX.js';
-export { A as ALL_COUNTRY_CODES, B as BreadcrumbItemInput, g as FaqItem, J as JobBreadcrumb, h as JsonLdBoard, N as NumberNotation, i as SENIORITY_ORDER, j as SalaryFaqEntry, k as SalaryJsonLdOptions, l as SalaryOccupationListOptions, b as buildJobBreadcrumbs, m as buildSalaryFaq, o as companyCategorySalaryJsonLd, p as companySalaryJsonLd, q as createBreadcrumbJsonLd, r as createJobPostingJsonLd, s as crossAxisSalaryJsonLd, t as faqJsonLd, c as formatSalaryStat, d as formatSalaryStatRange, u as itemListJsonLd, v as locationSalaryJsonLd, n as normalizeWebsiteUrl, w as skillSalaryJsonLd, x as sortBySeniority, y as titleSalaryJsonLd } from './breadcrumbs-BOFeIYEX.js';
-import './_spec-D1Qg_Twd.js';
-import './board-BeNZLOYC.js';
-import './jobs-D04ngjCP.js';
+import { P as PublicBlogPostSummary, B as BlogAuthorEmbed } from './blog-DuNJLfIh.js';
+import { e as JsonLdObject } from './breadcrumbs-DYGo0yB9.js';
+export { A as ALL_COUNTRY_CODES, B as BreadcrumbItemInput, g as FaqItem, J as JobBreadcrumb, h as JsonLdBoard, N as NumberNotation, i as SENIORITY_ORDER, j as SalaryFaqEntry, k as SalaryJsonLdOptions, l as SalaryOccupationListOptions, b as buildJobBreadcrumbs, m as buildSalaryFaq, o as companyCategorySalaryJsonLd, p as companySalaryJsonLd, q as createBreadcrumbJsonLd, r as createJobPostingJsonLd, s as crossAxisSalaryJsonLd, t as faqJsonLd, c as formatSalaryStat, d as formatSalaryStatRange, u as itemListJsonLd, v as locationSalaryJsonLd, n as normalizeWebsiteUrl, w as skillSalaryJsonLd, x as sortBySeniority, y as titleSalaryJsonLd } from './breadcrumbs-DYGo0yB9.js';
+import './_spec-CIufstif.js';
+import './board-iCHYuNhr.js';
+import './jobs-DM_QMccX.js';
 
 /**
  * Blog structured data on the `@cavuno/board` wire types, transcribed from
@@ -28,13 +28,24 @@ type ArticleJsonLdPost = Pick<PublicBlogPostSummary, 'title' | 'customExcerpt' |
  * first, then `ogImageUrl` — pass your page's OG image URL (hosted passes
  * its generated `/blog/:slug/og` card; OG generation itself is app-owned
  * per ).
+ *
+ * Pass `authorProfileUrl` (the first author's profile page URL) so the
+ * `author` is the same `Person` (`@id` + `url`) that
+ * `createAuthorProfileJsonLd` declares on that page. Without it the author
+ * carries only a name and their website, and nothing links the post to the
+ * profile.
  */
-declare function createBlogArticleJsonLd({ post, boardName, permalink, ogImageUrl, }: {
+declare function createBlogArticleJsonLd({ post, boardName, permalink, ogImageUrl, authorProfileUrl, }: {
     post: ArticleJsonLdPost;
     boardName: string;
     permalink: string;
     /** Fallback image when the post has no cover, e.g. your generated OG card URL. */
     ogImageUrl?: string | null;
+    /**
+     * Absolute canonical URL of the first author's profile page: the
+     * `canonical` you pass to `createAuthorProfileJsonLd` on that page.
+     */
+    authorProfileUrl?: string | null;
 }): JsonLdObject;
 /**
  * `ProfilePage` for a blog author page — the hosted shape: a `Person` main
@@ -55,6 +66,10 @@ declare function createAuthorProfileJsonLd({ author, canonical, description, ori
     origin: string | null;
     /** The author's recent posts (newest first) — the builder keeps the first 5. */
     posts: Pick<PublicBlogPostSummary, 'title' | 'slug' | 'publishedAt'>[];
+    /**
+     * The author's total published post count: the posts list `count` for
+     * `authorSlug`, not the length of one page.
+     */
     totalPosts: number;
 }): JsonLdObject | null;
 

package/dist/seo.js

@@ -50,7 +50,8 @@ function createBlogArticleJsonLd({
   post,
   boardName,
   permalink,
-  ogImageUrl
+  ogImageUrl,
+  authorProfileUrl
 }) {
   const article = {
     "@context": "https://schema.org",
@@ -66,7 +67,12 @@ function createBlogArticleJsonLd({
   if (image) article.image = image;
   const author = post.authors[0];
   if (author) {
-    article.author = {
+    article.author = authorProfileUrl ? {
+      "@type": "Person",
+      "@id": authorProfileId(authorProfileUrl),
+      name: author.name,
+      url: authorProfileUrl
+    } : {
       "@type": "Person",
       name: author.name,
       ...author.websiteUrl ? { url: author.websiteUrl } : {}
@@ -92,7 +98,7 @@ function createAuthorProfileJsonLd({
     normalizeUrl(author.linkedinUrl),
     normalizeUrl(author.githubUrl)
   ].filter((value) => Boolean(value));
-  const authorId = `${canonical}#profile`;
+  const authorId = authorProfileId(canonical);
   const hasPart = posts.slice(0, 5).map((post) => {
     const postUrl = buildAbsoluteUrl(origin, `/blog/${post.slug}`);
     if (!postUrl) {
@@ -134,6 +140,9 @@ function createAuthorProfileJsonLd({
   }
   return profilePage;
 }
+function authorProfileId(authorCanonical) {
+  return `${authorCanonical}#profile`;
+}
 function normalizeUrl(value) {
   if (!value) {
     return null;

package/dist/seo.mjs

@@ -28,7 +28,8 @@ function createBlogArticleJsonLd({
   post,
   boardName,
   permalink,
-  ogImageUrl
+  ogImageUrl,
+  authorProfileUrl
 }) {
   const article = {
     "@context": "https://schema.org",
@@ -44,7 +45,12 @@ function createBlogArticleJsonLd({
   if (image) article.image = image;
   const author = post.authors[0];
   if (author) {
-    article.author = {
+    article.author = authorProfileUrl ? {
+      "@type": "Person",
+      "@id": authorProfileId(authorProfileUrl),
+      name: author.name,
+      url: authorProfileUrl
+    } : {
       "@type": "Person",
       name: author.name,
       ...author.websiteUrl ? { url: author.websiteUrl } : {}
@@ -70,7 +76,7 @@ function createAuthorProfileJsonLd({
     normalizeUrl(author.linkedinUrl),
     normalizeUrl(author.githubUrl)
   ].filter((value) => Boolean(value));
-  const authorId = `${canonical}#profile`;
+  const authorId = authorProfileId(canonical);
   const hasPart = posts.slice(0, 5).map((post) => {
     const postUrl = buildAbsoluteUrl(origin, `/blog/${post.slug}`);
     if (!postUrl) {
@@ -112,6 +118,9 @@ function createAuthorProfileJsonLd({
   }
   return profilePage;
 }
+function authorProfileId(authorCanonical) {
+  return `${authorCanonical}#profile`;
+}
 function normalizeUrl(value) {
   if (!value) {
     return null;

package/dist/server.d.mts

@@ -1,10 +1,10 @@
 import { BoardSdk } from './index.mjs';
-import './_spec-D1Qg_Twd.mjs';
-import './search-BtrwcLkc.mjs';
-import './jobs-CClqlUld.mjs';
-import './board-Cc3wbTKI.mjs';
-import './seo-LfpgbdnO.mjs';
-import './blog-e0YbZBjg.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';
 
 /**
  * Session cookie codec — pure (no framework imports, no node imports) so it

package/dist/server.d.ts

@@ -1,10 +1,10 @@
 import { BoardSdk } from './index.js';
-import './_spec-D1Qg_Twd.js';
-import './search-DZeNdYN6.js';
-import './jobs-D04ngjCP.js';
-import './board-BeNZLOYC.js';
-import './seo-DLoyZRTo.js';
-import './blog-Dp2jAVVM.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';
 
 /**
  * Session cookie codec — pure (no framework imports, no node imports) so it

package/dist/server.mjs

@@ -4,7 +4,7 @@ import {
 } from "./chunk-Z4ALWIGS.mjs";
 import {
   isUnauthorized
-} from "./chunk-COHTNSU2.mjs";
+} from "./chunk-H3YIWHXR.mjs";
 
 // src/server/cookie.ts
 var COOKIE_ATTRIBUTES = "Path=/; HttpOnly; Secure; SameSite=Lax";

package/dist/sitemap.d.mts

@@ -1,10 +1,10 @@
 import { BoardSdk } from './index.mjs';
-import './_spec-D1Qg_Twd.mjs';
-import './search-BtrwcLkc.mjs';
-import './jobs-CClqlUld.mjs';
-import './board-Cc3wbTKI.mjs';
-import './seo-LfpgbdnO.mjs';
-import './blog-e0YbZBjg.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';
 
 /**
  * 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-D1Qg_Twd.js';
-import './search-DZeNdYN6.js';
-import './jobs-D04ngjCP.js';
-import './board-BeNZLOYC.js';
-import './seo-DLoyZRTo.js';
-import './blog-Dp2jAVVM.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';
 
 /**
  * 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-COHTNSU2.mjs";
+} from "./chunk-H3YIWHXR.mjs";
 import {
   BOARD_PATHS,
   blogAuthorPath,

package/dist/skills.js

@@ -27,7 +27,7 @@ __export(skills_exports, {
 });
 module.exports = __toCommonJS(skills_exports);
 
-// node_modules/.pnpm/tsup@8.5.1_postcss@8.5.22_tsx@4.23.1_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js
+// node_modules/.pnpm/tsup@8.5.1_postcss@8.5.32_tsx@4.23.1_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js
 var getImportMetaUrl = () => typeof document === "undefined" ? new URL(`file:${__filename}`).href : document.currentScript && document.currentScript.tagName.toUpperCase() === "SCRIPT" ? document.currentScript.src : new URL("main.js", document.baseURI).href;
 var importMetaUrl = /* @__PURE__ */ getImportMetaUrl();
 

package/dist/suggest.d.mts

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cavuno/board",
-  "version": "4.63.0",
+  "version": "4.65.0",
   "description": "Build custom job boards and careers pages with Cavuno’s TypeScript SDK.",
   "keywords": [
     "api-client",
@@ -134,6 +134,16 @@
         "default": "./dist/go.js"
       }
     },
+    "./mcp": {
+      "import": {
+        "types": "./dist/mcp.d.mts",
+        "default": "./dist/mcp.mjs"
+      },
+      "require": {
+        "types": "./dist/mcp.d.ts",
+        "default": "./dist/mcp.js"
+      }
+    },
     "./route-contract": {
       "import": {
         "types": "./dist/route-contract.d.mts",
@@ -240,7 +250,8 @@
     "publint": "^0.3.12",
     "tsup": "^8.4.0",
     "tsx": "^4.19.2",
-    "vitest": "^2.1.9",
+    "vite": "^8.3.6",
+    "vitest": "^5.1.0",
     "typescript": "^5.9.3",
     "@typescript/native-preview": "7.0.0-dev.20260707.2"
   },

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

@@ -0,0 +1,80 @@
+---
+name: cavuno-board-mcp
+description: Serve the board's public MCP server at /mcp with @cavuno/board/mcp. Use when connecting a self-hosted board to Claude, ChatGPT, Cursor or another MCP client, or when /mcp or /mcp/docs returns 404 on the board's host.
+---
+
+# Board MCP server
+
+Every paid Cavuno board has a public, read-only MCP server: AI assistants can
+search its jobs, read job and company pages, and look up salaries. Boards that
+Cavuno hosts serve it at `/mcp` on their own domain already. A self-hosted
+board serves it by mounting `createMcpHandler` from `@cavuno/board/mcp`, which
+forwards to the Board API, so the tools, limits and setup page match every
+other Cavuno board.
+
+## Mount the handler
+
+Mount one handler at `/mcp`, `/mcp/*` and `/.well-known/ai-catalog.json`, for
+GET, HEAD and POST. Pass
+the board's publishable key: job and company links in tool results then point
+at the key's own origin.
+
+```ts snippet
+import { createMcpHandler } from '@cavuno/board/mcp';
+
+// app/mcp/[[...path]]/route.ts, and the same lines in
+// app/.well-known/ai-catalog.json/route.ts
+const handler = createMcpHandler({
+  board: process.env.NEXT_PUBLIC_CAVUNO_BOARD_KEY!,
+});
+export const GET = handler;
+export const HEAD = handler;
+export const POST = handler;
+```
+
+Other frameworks mount the same `(request: Request) => Promise<Response>`
+function on each path. Do not add authentication, cookies or caching in front
+of `/mcp`: every tool is an anonymous read, and MCP clients POST without
+credentials.
+
+## What each path answers
+
+- `POST /mcp`: the stateless Streamable HTTP transport.
+- `GET /mcp` from a browser: a redirect to `/mcp/docs`. Any other non-POST
+  request answers 405.
+- `GET /mcp/docs`: an HTML page listing the tools and how to add the server
+  to each assistant. Use this URL as the documentation link in a Claude or
+  ChatGPT directory submission.
+- `GET /mcp/server-card`: the MCP Server Card, the server's name, version,
+  title, icons and URL as `application/mcp-server-card+json`, for an
+  assistant to read before it connects.
+- `GET /.well-known/ai-catalog.json`: the AI Catalog, which lists the Server
+  Card so an assistant that knows only the board's domain can find the server.
+
+A free-plan board, a password-protected board, or a board whose operator has
+switched the server off answers 404 on every path.
+
+## Limits
+
+The Board API allows 1,000 MCP requests a minute per visitor address. Requests
+forwarded from a self-hosted server arrive from that server's address, so the
+limit applies to the board's MCP traffic as a whole. Over the limit, `/mcp`
+answers 429 with `Retry-After`.
+
+## Completion gate
+
+Finish only after every check passes against the deployed board:
+
+- `POST /mcp` with `{"jsonrpc":"2.0","id":1,"method":"tools/list"}`,
+  `Content-Type: application/json` and
+  `Accept: application/json, text/event-stream` returns the tool list.
+- Opening `/mcp` in a browser lands on `/mcp/docs`, and that page names the
+  board and shows `https://<board-host>/mcp` as the server URL.
+- `GET /.well-known/ai-catalog.json` returns an entry whose `url` is
+  `https://<board-host>/mcp/server-card`, and that card's `remotes` URL is
+  `https://<board-host>/mcp`.
+- A job URL in a `search_jobs` result opens on the board's own host.
+
+## Cavuno SDK reference
+
+For setup and API details beyond this workflow, use the [Cavuno Board SDK documentation](https://cavuno.com/docs/sdk).

package/skills/cavuno-board-seo/BLOG.md

@@ -10,17 +10,19 @@ import {
 
 const { name } = await board.context();
 const post = await board.blog.posts.retrieve('hello-world');
+const [firstAuthor] = post.authors;
 const article = createBlogArticleJsonLd({
   post,
   boardName: name,
   permalink: `https://jobs.example.com/blog/${post.slug}`,
   ogImageUrl: `https://jobs.example.com/blog/${post.slug}/og`,
+  authorProfileUrl: firstAuthor
+    ? `https://jobs.example.com/blog/author/${firstAuthor.slug}`
+    : null,
 });
 
 const author = await board.blog.authors.retrieve('jane');
-const { data: authorPosts } = await board.blog.posts.list({
-  authorSlug: 'jane',
-});
+const authorPosts = await board.blog.posts.list({ authorSlug: 'jane' });
 // Profile description is application-owned. Prefer author.bio; otherwise
 // compose from the board catalog (shape only — not an English sentence).
 const profile = createAuthorProfileJsonLd({
@@ -29,14 +31,17 @@ const profile = createAuthorProfileJsonLd({
   description:
     author.bio ?? messages.authorProfileDescription({ name: author.name }),
   origin: 'https://jobs.example.com',
-  posts: authorPosts,
-  totalPosts: authorPosts.length,
+  posts: authorPosts.data,
+  // The author's total, not this page's length.
+  totalPosts: authorPosts.count ?? authorPosts.data.length,
 });
 ```
 
-The article `ogImageUrl` is the fallback when the post has no cover. Supply
-author posts newest-first; the profile builder keeps the first five as
-`hasPart`.
+The article `ogImageUrl` is the fallback when the post has no cover. Pass
+`authorProfileUrl` as the same URL you give the profile's `canonical`, so the
+post's author and the profile's `Person` share one `@id`. Supply author posts
+newest-first; the profile builder keeps the first five as `hasPart`. The list's
+`count` is the author's total published posts; `data` is one page.
 
 This branch is complete when the post emits an `Article`, the author emits a
 `ProfilePage`, every URL is absolute and canonical, and a null builder result

package/skills/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "4.63.0",
+  "version": "4.65.0",
   "skills": [
     {
       "name": "cavuno-board-account",
@@ -92,6 +92,13 @@
       "framework": null,
       "category": "core"
     },
+    {
+      "name": "cavuno-board-mcp",
+      "description": "Serve the board's public MCP server at /mcp with @cavuno/board/mcp. Use when connecting a self-hosted board to Claude, ChatGPT, Cursor or another MCP client, or when /mcp or /mcp/docs returns 404 on the board's host.",
+      "path": "skills/cavuno-board-mcp/SKILL.md",
+      "framework": null,
+      "category": "core"
+    },
     {
       "name": "cavuno-board-messaging",
       "description": "Polled messaging contract with @cavuno/board. Use for inboxes, unread badges, threads, read receipts, message moderation, or user blocks.",