@cavuno/board 4.21.1 → 4.23.0

package/dist/{jobs-CALE3I8I.d.mts → jobs-Bv12BcSA.d.mts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-CyNKpM_j.mjs';
+import { S as Schemas } from './_spec-p1bcDr9R.mjs';
 
 /**
  * Optional pagination metadata returned by Board API list operations.

package/dist/{jobs-CSWXqLZR.d.ts → jobs-C-sBPgNp.d.ts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-CyNKpM_j.js';
+import { S as Schemas } from './_spec-p1bcDr9R.js';
 
 /**
  * Optional pagination metadata returned by Board API list operations.

package/dist/{search-B_hwS-xu.d.mts → search-CNeOnhWb.d.mts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-CyNKpM_j.mjs';
+import { S as Schemas } from './_spec-p1bcDr9R.mjs';
 
 type Awaitable<T> = T | Promise<T>;
 /**

package/dist/{search-BRCbe1Nm.d.ts → search-W28d76OJ.d.ts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-CyNKpM_j.js';
+import { S as Schemas } from './_spec-p1bcDr9R.js';
 
 type Awaitable<T> = T | Promise<T>;
 /**

package/dist/{seo-CS4lrG20.d.mts → seo-BGHJcfev.d.mts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-CyNKpM_j.mjs';
+import { S as Schemas } from './_spec-p1bcDr9R.mjs';
 
 /**
  * The public SEO-infra payload (`board.seo()`) — platform infrastructure a

package/dist/{seo-D1u-RmLQ.d.ts → seo-DAHd1ngs.d.ts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-CyNKpM_j.js';
+import { S as Schemas } from './_spec-p1bcDr9R.js';
 
 /**
  * The public SEO-infra payload (`board.seo()`) — platform infrastructure a

package/dist/seo-files.d.mts

@@ -1,5 +1,5 @@
-import { B as BoardSeo } from './seo-CS4lrG20.mjs';
-import './_spec-CyNKpM_j.mjs';
+import { B as BoardSeo } from './seo-BGHJcfev.mjs';
+import './_spec-p1bcDr9R.mjs';
 
 /**
  * `@cavuno/board/seo-files` — platform-owned crawler/identity file bodies

package/dist/seo-files.d.ts

@@ -1,5 +1,5 @@
-import { B as BoardSeo } from './seo-D1u-RmLQ.js';
-import './_spec-CyNKpM_j.js';
+import { B as BoardSeo } from './seo-DAHd1ngs.js';
+import './_spec-p1bcDr9R.js';
 
 /**
  * `@cavuno/board/seo-files` — platform-owned crawler/identity file bodies

package/dist/seo.d.mts

@@ -1,9 +1,9 @@
-import { P as PublicBlogPostSummary, B as BlogAuthorEmbed } from './blog-BNIqGayD.mjs';
-import { e as JsonLdObject } from './breadcrumbs-Bi4LHNAF.mjs';
-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-Bi4LHNAF.mjs';
-import './_spec-CyNKpM_j.mjs';
-import './board-mn3GVbrC.mjs';
-import './jobs-CALE3I8I.mjs';
+import { P as PublicBlogPostSummary, B as BlogAuthorEmbed } from './blog-CsI8GdJS.mjs';
+import { e as JsonLdObject } from './breadcrumbs-B_WTKaIk.mjs';
+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-B_WTKaIk.mjs';
+import './_spec-p1bcDr9R.mjs';
+import './board-CuIyeFsj.mjs';
+import './jobs-Bv12BcSA.mjs';
 
 /**
  * Blog structured data on the `@cavuno/board` wire types, transcribed from

package/dist/seo.d.ts

@@ -1,9 +1,9 @@
-import { P as PublicBlogPostSummary, B as BlogAuthorEmbed } from './blog-CRvaDyzJ.js';
-import { e as JsonLdObject } from './breadcrumbs-Crk6Q69T.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-Crk6Q69T.js';
-import './_spec-CyNKpM_j.js';
-import './board-CXNxSlUB.js';
-import './jobs-CSWXqLZR.js';
+import { P as PublicBlogPostSummary, B as BlogAuthorEmbed } from './blog-DB4YIfn4.js';
+import { e as JsonLdObject } from './breadcrumbs-CyCZ8N8_.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-CyCZ8N8_.js';
+import './_spec-p1bcDr9R.js';
+import './board-Dq9gD7qr.js';
+import './jobs-C-sBPgNp.js';
 
 /**
  * Blog structured data on the `@cavuno/board` wire types, transcribed from

package/dist/server.d.mts

@@ -1,10 +1,10 @@
 import { BoardSdk } from './index.mjs';
-import './_spec-CyNKpM_j.mjs';
-import './search-B_hwS-xu.mjs';
-import './board-mn3GVbrC.mjs';
-import './jobs-CALE3I8I.mjs';
-import './seo-CS4lrG20.mjs';
-import './blog-BNIqGayD.mjs';
+import './_spec-p1bcDr9R.mjs';
+import './search-CNeOnhWb.mjs';
+import './board-CuIyeFsj.mjs';
+import './jobs-Bv12BcSA.mjs';
+import './seo-BGHJcfev.mjs';
+import './blog-CsI8GdJS.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-CyNKpM_j.js';
-import './search-BRCbe1Nm.js';
-import './board-CXNxSlUB.js';
-import './jobs-CSWXqLZR.js';
-import './seo-D1u-RmLQ.js';
-import './blog-CRvaDyzJ.js';
+import './_spec-p1bcDr9R.js';
+import './search-W28d76OJ.js';
+import './board-Dq9gD7qr.js';
+import './jobs-C-sBPgNp.js';
+import './seo-DAHd1ngs.js';
+import './blog-DB4YIfn4.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-LWJOSIXX.mjs";
+} from "./chunk-DP2ZZZEO.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-CyNKpM_j.mjs';
-import './search-B_hwS-xu.mjs';
-import './board-mn3GVbrC.mjs';
-import './jobs-CALE3I8I.mjs';
-import './seo-CS4lrG20.mjs';
-import './blog-BNIqGayD.mjs';
+import './_spec-p1bcDr9R.mjs';
+import './search-CNeOnhWb.mjs';
+import './board-CuIyeFsj.mjs';
+import './jobs-Bv12BcSA.mjs';
+import './seo-BGHJcfev.mjs';
+import './blog-CsI8GdJS.mjs';
 
 /**
  * Sitemap primitives — the pure XML + bucket-filename logic behind a board
@@ -70,6 +70,36 @@ declare const MIN_JOBS_PER_INDEXED_PAGE = 5;
  * urlset when a board lacks that content (valid, just zero URLs).
  */
 declare function listedBuckets(board: BoardSdk): Promise<SitemapBucket[]>;
+/**
+ * One listed bucket, with the freshness stamp the board publishes for it.
+ *
+ * `lastModified` is present only on the mirror path, and only for the buckets
+ * the board tracks one for — the legacy fallback has no such stamp, so it
+ * yields bucket names alone. Feed these straight to `renderSitemapIndex` and
+ * each `<sitemap>` gets a `<lastmod>`.
+ */
+interface ListedSitemapBucket {
+    bucket: SitemapBucket;
+    /** ISO 8601 timestamp of the newest content in the bucket, when known. */
+    lastModified?: string;
+}
+/**
+ * Like `listedBuckets`, but keeps each bucket's `lastModified`. Same two
+ * paths, same ordering, same error rules — the only difference is that the
+ * freshness stamp survives.
+ */
+declare function listedBucketEntries(board: BoardSdk): Promise<ListedSitemapBucket[]>;
 declare function buildBucketUrls(board: BoardSdk, origin: string, bucket: SitemapBucket): Promise<string[]>;
+/**
+ * Like `buildBucketUrls`, but keeps each URL's `lastModified` where the board
+ * publishes one. The result feeds `renderUrlset` directly, so every `<url>`
+ * that has a freshness stamp gets a `<lastmod>` — the signal crawlers use to
+ * prioritise recrawl across a large sitemap.
+ *
+ * On the legacy fallback path the catalog endpoints expose no per-URL stamp,
+ * so entries come back as `{ url }` only — identical output to
+ * `buildBucketUrls`, just in the wider shape.
+ */
+declare function buildBucketEntries(board: BoardSdk, origin: string, bucket: SitemapBucket): Promise<SitemapUrlEntry[]>;
 
-export { MIN_JOBS_PER_INDEXED_PAGE, SITEMAP_BUCKETS, SITEMAP_CHUNK_SIZE, type SitemapBucket, type SitemapIndexEntry, type SitemapUrlEntry, bucketFilename, buildBucketUrls, chunk, listedBuckets, parseBucketFilename, renderSitemapIndex, renderUrlset, xmlEscape };
+export { type ListedSitemapBucket, MIN_JOBS_PER_INDEXED_PAGE, SITEMAP_BUCKETS, SITEMAP_CHUNK_SIZE, type SitemapBucket, type SitemapIndexEntry, type SitemapUrlEntry, bucketFilename, buildBucketEntries, buildBucketUrls, chunk, listedBucketEntries, listedBuckets, parseBucketFilename, renderSitemapIndex, renderUrlset, xmlEscape };

package/dist/sitemap.d.ts

@@ -1,10 +1,10 @@
 import { BoardSdk } from './index.js';
-import './_spec-CyNKpM_j.js';
-import './search-BRCbe1Nm.js';
-import './board-CXNxSlUB.js';
-import './jobs-CSWXqLZR.js';
-import './seo-D1u-RmLQ.js';
-import './blog-CRvaDyzJ.js';
+import './_spec-p1bcDr9R.js';
+import './search-W28d76OJ.js';
+import './board-Dq9gD7qr.js';
+import './jobs-C-sBPgNp.js';
+import './seo-DAHd1ngs.js';
+import './blog-DB4YIfn4.js';
 
 /**
  * Sitemap primitives — the pure XML + bucket-filename logic behind a board
@@ -70,6 +70,36 @@ declare const MIN_JOBS_PER_INDEXED_PAGE = 5;
  * urlset when a board lacks that content (valid, just zero URLs).
  */
 declare function listedBuckets(board: BoardSdk): Promise<SitemapBucket[]>;
+/**
+ * One listed bucket, with the freshness stamp the board publishes for it.
+ *
+ * `lastModified` is present only on the mirror path, and only for the buckets
+ * the board tracks one for — the legacy fallback has no such stamp, so it
+ * yields bucket names alone. Feed these straight to `renderSitemapIndex` and
+ * each `<sitemap>` gets a `<lastmod>`.
+ */
+interface ListedSitemapBucket {
+    bucket: SitemapBucket;
+    /** ISO 8601 timestamp of the newest content in the bucket, when known. */
+    lastModified?: string;
+}
+/**
+ * Like `listedBuckets`, but keeps each bucket's `lastModified`. Same two
+ * paths, same ordering, same error rules — the only difference is that the
+ * freshness stamp survives.
+ */
+declare function listedBucketEntries(board: BoardSdk): Promise<ListedSitemapBucket[]>;
 declare function buildBucketUrls(board: BoardSdk, origin: string, bucket: SitemapBucket): Promise<string[]>;
+/**
+ * Like `buildBucketUrls`, but keeps each URL's `lastModified` where the board
+ * publishes one. The result feeds `renderUrlset` directly, so every `<url>`
+ * that has a freshness stamp gets a `<lastmod>` — the signal crawlers use to
+ * prioritise recrawl across a large sitemap.
+ *
+ * On the legacy fallback path the catalog endpoints expose no per-URL stamp,
+ * so entries come back as `{ url }` only — identical output to
+ * `buildBucketUrls`, just in the wider shape.
+ */
+declare function buildBucketEntries(board: BoardSdk, origin: string, bucket: SitemapBucket): Promise<SitemapUrlEntry[]>;
 
-export { MIN_JOBS_PER_INDEXED_PAGE, SITEMAP_BUCKETS, SITEMAP_CHUNK_SIZE, type SitemapBucket, type SitemapIndexEntry, type SitemapUrlEntry, bucketFilename, buildBucketUrls, chunk, listedBuckets, parseBucketFilename, renderSitemapIndex, renderUrlset, xmlEscape };
+export { type ListedSitemapBucket, MIN_JOBS_PER_INDEXED_PAGE, SITEMAP_BUCKETS, SITEMAP_CHUNK_SIZE, type SitemapBucket, type SitemapIndexEntry, type SitemapUrlEntry, bucketFilename, buildBucketEntries, buildBucketUrls, chunk, listedBucketEntries, listedBuckets, parseBucketFilename, renderSitemapIndex, renderUrlset, xmlEscape };

package/dist/sitemap.js

@@ -24,8 +24,10 @@ __export(sitemap_exports, {
   SITEMAP_BUCKETS: () => SITEMAP_BUCKETS,
   SITEMAP_CHUNK_SIZE: () => SITEMAP_CHUNK_SIZE,
   bucketFilename: () => bucketFilename,
+  buildBucketEntries: () => buildBucketEntries,
   buildBucketUrls: () => buildBucketUrls,
   chunk: () => chunk,
+  listedBucketEntries: () => listedBucketEntries,
   listedBuckets: () => listedBuckets,
   parseBucketFilename: () => parseBucketFilename,
   renderSitemapIndex: () => renderSitemapIndex,
@@ -305,34 +307,57 @@ function enumerateCompanies(board) {
 }
 var MIRROR_PAGE = 1e3;
 async function listedBuckets(board) {
+  const listed = await listedBucketEntries(board);
+  return listed.map((entry) => entry.bucket);
+}
+async function listedBucketEntries(board) {
   try {
     const index = await board.sitemap();
-    const published = new Set(index.buckets.map((entry) => entry.bucket));
-    return SITEMAP_BUCKETS.filter((bucket) => published.has(bucket));
+    const published = new Map(
+      index.buckets.map((entry) => [entry.bucket, entry.lastModified])
+    );
+    return SITEMAP_BUCKETS.filter((bucket) => published.has(bucket)).map(
+      (bucket) => {
+        const lastModified = published.get(bucket);
+        return lastModified === void 0 ? { bucket } : { bucket, lastModified };
+      }
+    );
   } catch (error) {
     if (!isNotFound(error)) throw error;
     const { features } = await board.context();
-    return SITEMAP_BUCKETS.filter((b) => b !== "blog" || features.blog);
+    return SITEMAP_BUCKETS.filter((b) => b !== "blog" || features.blog).map(
+      (bucket) => ({ bucket })
+    );
   }
 }
 async function buildBucketUrls(board, origin, bucket) {
+  const entries = await buildBucketEntries(board, origin, bucket);
+  return entries.map((entry) => entry.url);
+}
+async function buildBucketEntries(board, origin, bucket) {
   try {
-    return await mirrorBucketUrls(board, origin, bucket);
+    return await mirrorBucketEntries(board, origin, bucket);
   } catch (error) {
     if (!isNotFound(error)) throw error;
-    return legacyBucketUrls(board, origin, bucket);
+    const urls = await legacyBucketUrls(board, origin, bucket);
+    return urls.map((url) => ({ url }));
   }
 }
-async function mirrorBucketUrls(board, origin, bucket) {
+async function mirrorBucketEntries(board, origin, bucket) {
   const pages = paginate(
     (query, options) => board.sitemap.entries(bucket, query, options),
     { limit: MIRROR_PAGE }
   ).pages();
-  const urls = [];
+  const entries = [];
   for await (const page of pages) {
-    for (const entry of page.data) urls.push(`${origin}${entry.path}`);
+    for (const entry of page.data) {
+      const url = `${origin}${entry.path}`;
+      entries.push(
+        entry.lastModified === void 0 ? { url } : { url, lastModified: entry.lastModified }
+      );
+    }
   }
-  return urls;
+  return entries;
 }
 async function legacyBucketUrls(board, origin, bucket) {
   switch (bucket) {

package/dist/sitemap.mjs

@@ -3,7 +3,7 @@ import {
 } from "./chunk-DLSO6XXY.mjs";
 import {
   isNotFound
-} from "./chunk-LWJOSIXX.mjs";
+} from "./chunk-DP2ZZZEO.mjs";
 import {
   BOARD_PATHS,
   blogAuthorPath,
@@ -178,34 +178,57 @@ function enumerateCompanies(board) {
 }
 var MIRROR_PAGE = 1e3;
 async function listedBuckets(board) {
+  const listed = await listedBucketEntries(board);
+  return listed.map((entry) => entry.bucket);
+}
+async function listedBucketEntries(board) {
   try {
     const index = await board.sitemap();
-    const published = new Set(index.buckets.map((entry) => entry.bucket));
-    return SITEMAP_BUCKETS.filter((bucket) => published.has(bucket));
+    const published = new Map(
+      index.buckets.map((entry) => [entry.bucket, entry.lastModified])
+    );
+    return SITEMAP_BUCKETS.filter((bucket) => published.has(bucket)).map(
+      (bucket) => {
+        const lastModified = published.get(bucket);
+        return lastModified === void 0 ? { bucket } : { bucket, lastModified };
+      }
+    );
   } catch (error) {
     if (!isNotFound(error)) throw error;
     const { features } = await board.context();
-    return SITEMAP_BUCKETS.filter((b) => b !== "blog" || features.blog);
+    return SITEMAP_BUCKETS.filter((b) => b !== "blog" || features.blog).map(
+      (bucket) => ({ bucket })
+    );
   }
 }
 async function buildBucketUrls(board, origin, bucket) {
+  const entries = await buildBucketEntries(board, origin, bucket);
+  return entries.map((entry) => entry.url);
+}
+async function buildBucketEntries(board, origin, bucket) {
   try {
-    return await mirrorBucketUrls(board, origin, bucket);
+    return await mirrorBucketEntries(board, origin, bucket);
   } catch (error) {
     if (!isNotFound(error)) throw error;
-    return legacyBucketUrls(board, origin, bucket);
+    const urls = await legacyBucketUrls(board, origin, bucket);
+    return urls.map((url) => ({ url }));
   }
 }
-async function mirrorBucketUrls(board, origin, bucket) {
+async function mirrorBucketEntries(board, origin, bucket) {
   const pages = paginate(
     (query, options) => board.sitemap.entries(bucket, query, options),
     { limit: MIRROR_PAGE }
   ).pages();
-  const urls = [];
+  const entries = [];
   for await (const page of pages) {
-    for (const entry of page.data) urls.push(`${origin}${entry.path}`);
+    for (const entry of page.data) {
+      const url = `${origin}${entry.path}`;
+      entries.push(
+        entry.lastModified === void 0 ? { url } : { url, lastModified: entry.lastModified }
+      );
+    }
   }
-  return urls;
+  return entries;
 }
 async function legacyBucketUrls(board, origin, bucket) {
   switch (bucket) {
@@ -354,8 +377,10 @@ export {
   SITEMAP_BUCKETS,
   SITEMAP_CHUNK_SIZE,
   bucketFilename,
+  buildBucketEntries,
   buildBucketUrls,
   chunk,
+  listedBucketEntries,
   listedBuckets,
   parseBucketFilename,
   renderSitemapIndex,

package/dist/suggest.d.mts

@@ -1,5 +1,5 @@
-import { h as SuggestionItem, b as SearchSuggestQuery, F as FetchOptions, g as SuggestResult } from './search-B_hwS-xu.mjs';
-import './_spec-CyNKpM_j.mjs';
+import { h as SuggestionItem, b as SearchSuggestQuery, F as FetchOptions, g as SuggestResult } from './search-CNeOnhWb.mjs';
+import './_spec-p1bcDr9R.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-BRCbe1Nm.js';
-import './_spec-CyNKpM_j.js';
+import { h as SuggestionItem, b as SearchSuggestQuery, F as FetchOptions, g as SuggestResult } from './search-W28d76OJ.js';
+import './_spec-p1bcDr9R.js';
 
 /**
  * `@cavuno/board/suggest` — framework-agnostic headless search-suggest

package/package.json

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

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

@@ -18,6 +18,12 @@ Demoting, removing, or leaving as the last admin is `last_admin`. Admins
 invite by email; approved members can list pending invites; accept is
 session-gated on `board.me.acceptInvite`.
 
+An approved member can buy a public, priced membership plan for the company
+with `board.me.companies.startMembershipCheckout(slug, body)`. It returns the
+same embedded-checkout mount kit as talent access; poll
+`retrieveMembershipCheckout(slug, sessionId)` after the return redirect. A
+company that already holds a membership is `membership_seat_taken`.
+
 ```ts snippet
 await board.me.companies.delete('acme');
 const { data: members } = await board.me.companies.listMembers('acme');

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

@@ -18,7 +18,10 @@ The pure XML tier exports `SITEMAP_BUCKETS`, `SITEMAP_CHUNK_SIZE` (45,000),
 `chunk`, `bucketFilename`, `parseBucketFilename`, `renderUrlset`, and
 `renderSitemapIndex`. The catalog tier exports `listedBuckets(board)` and
 `buildBucketUrls(board, origin, bucket)`; it walks the SDK and applies the
-hosted indexing policy.
+hosted indexing policy. `listedBucketEntries(board)` and
+`buildBucketEntries(board, origin, bucket)` are the freshness-preserving
+siblings: same walk and same policy, but each result keeps its
+`lastModified`.
 
 ## Serve the index
 
@@ -77,9 +80,55 @@ return xmlResponse(renderUrlset(page));
 serialize to ISO 8601. `renderSitemapIndex` accepts strings or
 `{ url, lastModified? }`. The hosted format omits `changefreq` and `priority`.
 
+## Emit `<lastmod>`
+
+Freshness is the strongest recrawl-priority signal on a large sitemap, so
+prefer the entries walkers. `buildBucketEntries` returns
+`{ url, lastModified? }[]` that feeds `renderUrlset` unchanged, and
+`listedBucketEntries` returns `{ bucket, lastModified? }[]` for the index.
+The board publishes a stamp per URL and per bucket wherever it tracks one;
+entries without one simply omit `<lastmod>`.
+
+```ts snippet
+import {
+  SITEMAP_CHUNK_SIZE,
+  buildBucketEntries,
+  bucketFilename,
+  chunk,
+  listedBucketEntries,
+  renderSitemapIndex,
+  renderUrlset,
+  type SitemapIndexEntry,
+} from '@cavuno/board/sitemap';
+
+// Index: one <sitemap> per chunk, each carrying its bucket's stamp. Buckets
+// over SITEMAP_CHUNK_SIZE produce -2, -3, … files; list every one.
+const sitemaps: SitemapIndexEntry[] = [];
+for (const { bucket, lastModified } of await listedBucketEntries(board)) {
+  const chunks = chunk(await buildBucketEntries(board, origin, bucket), SITEMAP_CHUNK_SIZE);
+  for (let i = 0; i < Math.max(chunks.length, 1); i += 1) {
+    sitemaps.push({
+      url: `${origin}/sitemap/${bucketFilename(bucket, i)}`,
+      ...(lastModified ? { lastModified } : {}),
+    });
+  }
+}
+const indexXml = renderSitemapIndex(sitemaps);
+
+// Bucket file: every <url> keeps its own stamp.
+const entries = await buildBucketEntries(board, origin, parsed.bucket);
+const page = chunk(entries, SITEMAP_CHUNK_SIZE)[parsed.chunkIndex] ?? [];
+const bucketXml = renderUrlset(page);
+```
+
+`buildBucketUrls` and `listedBuckets` still return plain strings and bucket
+names; they are unchanged, and a sitemap built from them carries no
+`<lastmod>`.
+
 ## Keep the walker policy intact
 
-`buildBucketUrls` is the policy boundary:
+`buildBucketEntries` is the policy boundary (`buildBucketUrls` is a map over
+it):
 
 - Taxonomy and location pages enter the sitemap at five distinct jobs,
   `MIN_JOBS_PER_INDEXED_PAGE`.

package/skills/manifest.json

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