@cavuno/board 4.22.0 → 4.24.0

package/dist/index.d.ts

@@ -1,13 +1,13 @@
-import { S as Schemas, c as components } from './_spec-p1bcDr9R.js';
-import { F as FetchOptions, S as StorageMode, B as BoardRequest, A as Awaitable, L as Logger, a as BoardClient, b as SearchSuggestQuery } from './search-W28d76OJ.js';
-export { c as ACCESS_TOKEN_KEY, d as BOARD_ACCESS_GRANT_KEY, C as CompanySuggestion, e as CustomStorage, M as MarketSuggestion, R as REFRESH_TOKEN_KEY, f as SearchSuggestType, g as SuggestResult, h as SuggestionItem, T as TermSuggestion } from './search-W28d76OJ.js';
-import { c as CompaniesListQuery, d as CompanyListEnvelope, e as CompaniesSearchBody, f as CompanyJobsListQuery, g as CompanySimilarQuery, h as CompanyMarketsListQuery, i as SalaryDetailQuery } from './board-Dq9gD7qr.js';
-export { a as CompanyCategorySalary, j as CompanyMarket, k as CompanyMarketRef, b as CompanySalary, l as CompanySalarySummary, C as CustomFieldDefinition, m as CustomFieldOption, n as CustomFieldType, L as LocationSalaryDetail, o as LocationSkillsIndex, p as LocationTitlesIndex, P as PublicBoard, q as PublicBoardAds, r as PublicBoardAnalytics, s as PublicBoardFeatures, t as PublicBoardJobForm, u as PublicCompany, v as PublicCompanyDetail, w as PublicCompanyMembership, x as SalaryCompany, y as SalaryLocation, z as SalarySkill, A as SalaryTitle, B as SkillLocationSalary, D as SkillLocationsIndex, S as SkillSalaryDetail, E as TitleLocationSalary, F as TitleLocationsIndex, T as TitleSalaryDetail } from './board-Dq9gD7qr.js';
-export { B as BoardSeo } from './seo-DAHd1ngs.js';
-import { R as RemoteOption, E as EmploymentType, S as Seniority, L as ListEnvelope, a as JobsListQuery, b as JobCardListEnvelope, c as JobsSearchBody, d as JobCardSearchEnvelope, e as JobsSimilarQuery, f as SearchEnvelope } from './jobs-C-sBPgNp.js';
-export { g as CustomFieldValue, C as CustomFieldValues, h as EducationRequirement, i as JobCatalogPagination, j as JobCompany, J as JobSort, O as OfficeLocation, k as OffsetPagination, P as PublicJob, l as PublicJobCard, m as RelatedSearch, n as RemotePermit, o as RemoteTimezone, p as StorefrontPagination } from './jobs-C-sBPgNp.js';
-import { a as BlogPostsListQuery, b as BlogSimilarQuery, c as BlogSearchBody } from './blog-DB4YIfn4.js';
-export { B as BlogAuthorEmbed, d as BlogTagEmbed, e as PublicBlogAdjacentPosts, f as PublicBlogAuthor, g as PublicBlogPost, P as PublicBlogPostSummary, h as PublicBlogTag } from './blog-DB4YIfn4.js';
+import { S as Schemas, c as components } from './_spec-BZQuYYpQ.js';
+import { F as FetchOptions, S as StorageMode, B as BoardRequest, A as Awaitable, L as Logger, a as BoardClient, b as SearchSuggestQuery } from './search-mFmRLLe9.js';
+export { c as ACCESS_TOKEN_KEY, d as BOARD_ACCESS_GRANT_KEY, C as CompanySuggestion, e as CustomStorage, M as MarketSuggestion, R as REFRESH_TOKEN_KEY, f as SearchSuggestType, g as SuggestResult, h as SuggestionItem, T as TermSuggestion } from './search-mFmRLLe9.js';
+import { c as CompaniesListQuery, d as CompanyListEnvelope, e as CompaniesSearchBody, f as CompanyJobsListQuery, g as CompanySimilarQuery, h as CompanyMarketsListQuery, i as SalaryDetailQuery } from './board-ByNdDHrH.js';
+export { a as CompanyCategorySalary, j as CompanyMarket, k as CompanyMarketRef, b as CompanySalary, l as CompanySalarySummary, C as CustomFieldDefinition, m as CustomFieldOption, n as CustomFieldType, L as LocationSalaryDetail, o as LocationSkillsIndex, p as LocationTitlesIndex, P as PublicBoard, q as PublicBoardAds, r as PublicBoardAnalytics, s as PublicBoardFeatures, t as PublicBoardJobForm, u as PublicCompany, v as PublicCompanyDetail, w as PublicCompanyMembership, x as SalaryCompany, y as SalaryLocation, z as SalarySkill, A as SalaryTitle, B as SkillLocationSalary, D as SkillLocationsIndex, S as SkillSalaryDetail, E as TitleLocationSalary, F as TitleLocationsIndex, T as TitleSalaryDetail } from './board-ByNdDHrH.js';
+export { B as BoardSeo } from './seo-BCqk_6iN.js';
+import { R as RemoteOption, E as EmploymentType, S as Seniority, L as ListEnvelope, a as JobsListQuery, b as JobCardListEnvelope, c as JobsSearchBody, d as JobCardSearchEnvelope, e as JobsSimilarQuery, f as SearchEnvelope } from './jobs-C8Hkjwwr.js';
+export { g as CustomFieldValue, C as CustomFieldValues, h as EducationRequirement, i as JobCatalogPagination, j as JobCompany, J as JobSort, O as OfficeLocation, k as OffsetPagination, P as PublicJob, l as PublicJobCard, m as RelatedSearch, n as RemotePermit, o as RemoteTimezone, p as StorefrontPagination } from './jobs-C8Hkjwwr.js';
+import { a as BlogPostsListQuery, b as BlogSimilarQuery, c as BlogSearchBody } from './blog-DrBeKr1S.js';
+export { B as BlogAuthorEmbed, d as BlogTagEmbed, e as PublicBlogAdjacentPosts, f as PublicBlogAuthor, g as PublicBlogPost, P as PublicBlogPostSummary, h as PublicBlogTag } from './blog-DrBeKr1S.js';
 
 /**
  * Well-known `<domain>_<snake_reason>` codes the Board API sends, grouped by
@@ -150,7 +150,7 @@ declare function paginate<Q extends Record<string, unknown>, P extends PageShape
  * constant because the package is platform-neutral and cannot read
  * package.json at runtime.
  */
-declare const SDK_VERSION = "4.22.0";
+declare const SDK_VERSION = "4.24.0";
 
 type SavedJob = Schemas['SavedJob'];
 type SavedJobsListQuery = {
@@ -922,7 +922,7 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
     client: BoardClient;
     /**
      * Board context — identity, brand (`logoUrl` + favicon `icons`), language,
-     * features, analytics, and AdSense (`ads.enabled` + `ads.clientId`).
+     * features, analytics, and AdSense (`ads.enabled`, `ads.clientId`, and `ads.defaultSlotId`).
      * Per-placement slot ids are not on this resource.
      *
      * @example
@@ -980,6 +980,7 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
         ads: {
             enabled: boolean;
             clientId: string | null;
+            defaultSlotId: string | null;
         };
         customFields: {
             job: components["schemas"]["CustomFieldDefinition"][];

package/dist/index.js

@@ -358,7 +358,7 @@ async function clearSession(storage) {
 }
 
 // src/version.ts
-var SDK_VERSION = "4.22.0";
+var SDK_VERSION = "4.24.0";
 
 // src/client.ts
 function isRawBody(body) {
@@ -3477,7 +3477,7 @@ function createBoardClient(options) {
     client,
     /**
      * Board context — identity, brand (`logoUrl` + favicon `icons`), language,
-     * features, analytics, and AdSense (`ads.enabled` + `ads.clientId`).
+     * features, analytics, and AdSense (`ads.enabled`, `ads.clientId`, and `ads.defaultSlotId`).
      * Per-placement slot ids are not on this resource.
      *
      * @example

package/dist/index.mjs

@@ -42,7 +42,7 @@ function toSearchParams(query) {
 }
 
 // src/version.ts
-var SDK_VERSION = "4.22.0";
+var SDK_VERSION = "4.24.0";
 
 // src/client.ts
 function isRawBody(body) {
@@ -3131,7 +3131,7 @@ function createBoardClient(options) {
     client,
     /**
      * Board context — identity, brand (`logoUrl` + favicon `icons`), language,
-     * features, analytics, and AdSense (`ads.enabled` + `ads.clientId`).
+     * features, analytics, and AdSense (`ads.enabled`, `ads.clientId`, and `ads.defaultSlotId`).
      * Per-placement slot ids are not on this resource.
      *
      * @example

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

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

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

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

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

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

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

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

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

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

package/dist/{seo-BGHJcfev.d.mts → seo-Dw-7-wfY.d.mts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-p1bcDr9R.mjs';
+import { S as Schemas } from './_spec-BZQuYYpQ.mjs';
 
 /**
  * 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-BGHJcfev.mjs';
-import './_spec-p1bcDr9R.mjs';
+import { B as BoardSeo } from './seo-Dw-7-wfY.mjs';
+import './_spec-BZQuYYpQ.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-DAHd1ngs.js';
-import './_spec-p1bcDr9R.js';
+import { B as BoardSeo } from './seo-BCqk_6iN.js';
+import './_spec-BZQuYYpQ.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-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';
+import { P as PublicBlogPostSummary, B as BlogAuthorEmbed } from './blog-DR7v6Bq7.mjs';
+import { e as JsonLdObject } from './breadcrumbs-WLAHK942.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-WLAHK942.mjs';
+import './_spec-BZQuYYpQ.mjs';
+import './board-D8e-h3qJ.mjs';
+import './jobs-CuhkEYri.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-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';
+import { P as PublicBlogPostSummary, B as BlogAuthorEmbed } from './blog-DrBeKr1S.js';
+import { e as JsonLdObject } from './breadcrumbs-Dzt5dJrV.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-Dzt5dJrV.js';
+import './_spec-BZQuYYpQ.js';
+import './board-ByNdDHrH.js';
+import './jobs-C8Hkjwwr.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-p1bcDr9R.mjs';
-import './search-CNeOnhWb.mjs';
-import './board-CuIyeFsj.mjs';
-import './jobs-Bv12BcSA.mjs';
-import './seo-BGHJcfev.mjs';
-import './blog-CsI8GdJS.mjs';
+import './_spec-BZQuYYpQ.mjs';
+import './search-BGonXaPj.mjs';
+import './board-D8e-h3qJ.mjs';
+import './jobs-CuhkEYri.mjs';
+import './seo-Dw-7-wfY.mjs';
+import './blog-DR7v6Bq7.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-p1bcDr9R.js';
-import './search-W28d76OJ.js';
-import './board-Dq9gD7qr.js';
-import './jobs-C-sBPgNp.js';
-import './seo-DAHd1ngs.js';
-import './blog-DB4YIfn4.js';
+import './_spec-BZQuYYpQ.js';
+import './search-mFmRLLe9.js';
+import './board-ByNdDHrH.js';
+import './jobs-C8Hkjwwr.js';
+import './seo-BCqk_6iN.js';
+import './blog-DrBeKr1S.js';
 
 /**
  * Session cookie codec — pure (no framework imports, no node imports) so it

package/dist/sitemap.d.mts

@@ -1,10 +1,10 @@
 import { BoardSdk } from './index.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';
+import './_spec-BZQuYYpQ.mjs';
+import './search-BGonXaPj.mjs';
+import './board-D8e-h3qJ.mjs';
+import './jobs-CuhkEYri.mjs';
+import './seo-Dw-7-wfY.mjs';
+import './blog-DR7v6Bq7.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-p1bcDr9R.js';
-import './search-W28d76OJ.js';
-import './board-Dq9gD7qr.js';
-import './jobs-C-sBPgNp.js';
-import './seo-DAHd1ngs.js';
-import './blog-DB4YIfn4.js';
+import './_spec-BZQuYYpQ.js';
+import './search-mFmRLLe9.js';
+import './board-ByNdDHrH.js';
+import './jobs-C8Hkjwwr.js';
+import './seo-BCqk_6iN.js';
+import './blog-DrBeKr1S.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

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

package/package.json

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

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.22.0",
+  "version": "4.24.0",
   "skills": [
     {
       "name": "cavuno-board-account",