@cavuno/board 4.65.0 → 4.67.0

package/dist/index.js

@@ -131,6 +131,8 @@ var BOARD_API_ERROR_CODES = [
   "blog_post_not_found",
   "blog_author_not_found",
   "blog_tag_not_found",
+  // Public collections
+  "collections_not_found",
   // Job aggregator feeds
   "feeds_not_found",
   "feed_not_ready",
@@ -151,6 +153,8 @@ var BOARD_API_ERROR_CODES = [
   "candidate_job_not_found",
   "candidate_notification_preference_paused",
   "candidate_profile_required",
+  "candidate_custom_field_not_found",
+  "candidate_custom_field_not_editable",
   "resume_invalid_file",
   "resume_upload_forbidden",
   // Applications
@@ -237,6 +241,7 @@ var BOARD_API_ERROR_CODES = [
   "job_posting_logo_lookup_unavailable",
   "job_posting_logo_not_found",
   "job_posting_rejected",
+  "job_posting_checkout_not_found",
   // Digital products and purchases
   "products_not_found",
   "product_checkout_not_found",
@@ -441,7 +446,7 @@ async function clearSession(storage) {
 }
 
 // src/version.ts
-var SDK_VERSION = "4.65.0";
+var SDK_VERSION = "4.67.0";
 
 // src/client.ts
 function isRawBody(body) {
@@ -1165,6 +1170,30 @@ function blogNamespace(client) {
   };
 }
 
+// src/namespaces/collections.ts
+function collectionsNamespace(client) {
+  return {
+    /**
+     * List the active entries of a collection the operator made public,
+     * sorted by name, with only its public fields. A collection that is not
+     * public reads as not found (`collections_not_found`). Follow
+     * `nextCursor` for more.
+     *
+     * @example
+     * const { data, nextCursor } = await board.collections.entries(
+     *   'trade_communities',
+     *   { limit: 50 },
+     * );
+     */
+    entries(key, query, options) {
+      return client.fetch(
+        `/collections/${encodeURIComponent(key)}/entries`,
+        { ...options, query }
+      );
+    }
+  };
+}
+
 // src/namespaces/companies.ts
 function companiesNamespace(client) {
   const markets = Object.assign(
@@ -1426,6 +1455,23 @@ function jobPostingNamespace(client) {
         body: input
       });
     },
+    /**
+     * After a paid posting's checkout (`sessionId` from an `embedded_checkout`
+     * result, or `session_id` on the return URL): `awaiting_payment` until the
+     * payment is confirmed (poll briefly), `processing` while a bank payment
+     * clears, then `paid` or `payment_failed`, or `canceled` if the checkout
+     * expired. `jobStatus` and `jobUrl` say whether the job is live.
+     *
+     * @example
+     * const s = await board.jobPosting.getCheckout(sessionId);
+     * if (s.jobUrl) location.assign(s.jobUrl);
+     */
+    getCheckout(sessionId, options) {
+      return client.fetch(
+        `/job-postings/checkout/${encodeURIComponent(sessionId)}`,
+        options
+      );
+    },
     /**
      * Upload a company logo (JPEG/PNG/WebP/GIF, ≤2 MB). Returns the stored
      * `publicUrl` — pass it back as the top-level `logoUrl` on `create(...)`.
@@ -1811,19 +1857,26 @@ function meNamespace(client) {
           query
         });
       },
-      /** Retrieve my profile custom-field definitions and current values. */
+      /**
+       * Retrieve my profile custom-field definitions, current values, and the
+       * saved files of upload fields (`customFieldMedia`).
+       */
       retrieveCustomFields(options) {
-        return client.fetch("/me/profile/custom-fields", {
-          ...options
-        });
+        return client.fetch(
+          "/me/profile/custom-fields",
+          { ...options }
+        );
       },
       /** Additively update my editable candidate profile custom fields. */
       updateCustomFields(body, options) {
-        return client.fetch("/me/profile/custom-fields", {
-          ...options,
-          method: "PATCH",
-          body
-        });
+        return client.fetch(
+          "/me/profile/custom-fields",
+          {
+            ...options,
+            method: "PATCH",
+            body
+          }
+        );
       },
       /** Retrieve editable catalog references on my candidate profile. */
       retrieveObjectReferences(options) {
@@ -2021,6 +2074,26 @@ function meNamespace(client) {
           method: "POST",
           body: form
         });
+      },
+      /**
+       * Upload one file to an owner-editable `image_gallery` or `file` field
+       * of my profile (up to 10 MB; galleries take JPEG, PNG, WebP or GIF).
+       * The file is a draft until its `id` is saved to the field with
+       * `updateCustomFields`, as the ordered list of file IDs.
+       *
+       * @example
+       * const image = await board.me.profile.uploadCustomFieldFile('portfolio', file);
+       * await board.me.profile.updateCustomFields({
+       *   values: { portfolio: [...savedIds, image.id] },
+       * });
+       */
+      uploadCustomFieldFile(fieldKey, file, options) {
+        const form = new FormData();
+        form.append("file", file);
+        return client.fetch(
+          `/me/profile/custom-fields/${encodeURIComponent(fieldKey)}/files`,
+          { ...options, method: "POST", body: form }
+        );
       }
     },
     /**
@@ -4725,6 +4798,7 @@ function createBoardClient(options) {
     embed: embedNamespace(client),
     companies: companiesNamespace(client),
     blog: blogNamespace(client),
+    collections: collectionsNamespace(client),
     auth: authNamespace(client, options.board),
     me: meNamespace(client),
     invites: invitesNamespace(client),

package/dist/index.mjs

@@ -28,7 +28,7 @@ import {
   isSsoRequired,
   isUnauthorized,
   isValidationError
-} from "./chunk-H3YIWHXR.mjs";
+} from "./chunk-ZA5TZ6UH.mjs";
 
 // src/query.ts
 function toSearchParams(query) {
@@ -49,7 +49,7 @@ function toSearchParams(query) {
 }
 
 // src/version.ts
-var SDK_VERSION = "4.65.0";
+var SDK_VERSION = "4.67.0";
 
 // src/client.ts
 function isRawBody(body) {
@@ -770,6 +770,30 @@ function blogNamespace(client) {
   };
 }
 
+// src/namespaces/collections.ts
+function collectionsNamespace(client) {
+  return {
+    /**
+     * List the active entries of a collection the operator made public,
+     * sorted by name, with only its public fields. A collection that is not
+     * public reads as not found (`collections_not_found`). Follow
+     * `nextCursor` for more.
+     *
+     * @example
+     * const { data, nextCursor } = await board.collections.entries(
+     *   'trade_communities',
+     *   { limit: 50 },
+     * );
+     */
+    entries(key, query, options) {
+      return client.fetch(
+        `/collections/${encodeURIComponent(key)}/entries`,
+        { ...options, query }
+      );
+    }
+  };
+}
+
 // src/namespaces/companies.ts
 function companiesNamespace(client) {
   const markets = Object.assign(
@@ -1031,6 +1055,23 @@ function jobPostingNamespace(client) {
         body: input
       });
     },
+    /**
+     * After a paid posting's checkout (`sessionId` from an `embedded_checkout`
+     * result, or `session_id` on the return URL): `awaiting_payment` until the
+     * payment is confirmed (poll briefly), `processing` while a bank payment
+     * clears, then `paid` or `payment_failed`, or `canceled` if the checkout
+     * expired. `jobStatus` and `jobUrl` say whether the job is live.
+     *
+     * @example
+     * const s = await board.jobPosting.getCheckout(sessionId);
+     * if (s.jobUrl) location.assign(s.jobUrl);
+     */
+    getCheckout(sessionId, options) {
+      return client.fetch(
+        `/job-postings/checkout/${encodeURIComponent(sessionId)}`,
+        options
+      );
+    },
     /**
      * Upload a company logo (JPEG/PNG/WebP/GIF, ≤2 MB). Returns the stored
      * `publicUrl` — pass it back as the top-level `logoUrl` on `create(...)`.
@@ -1416,19 +1457,26 @@ function meNamespace(client) {
           query
         });
       },
-      /** Retrieve my profile custom-field definitions and current values. */
+      /**
+       * Retrieve my profile custom-field definitions, current values, and the
+       * saved files of upload fields (`customFieldMedia`).
+       */
       retrieveCustomFields(options) {
-        return client.fetch("/me/profile/custom-fields", {
-          ...options
-        });
+        return client.fetch(
+          "/me/profile/custom-fields",
+          { ...options }
+        );
       },
       /** Additively update my editable candidate profile custom fields. */
       updateCustomFields(body, options) {
-        return client.fetch("/me/profile/custom-fields", {
-          ...options,
-          method: "PATCH",
-          body
-        });
+        return client.fetch(
+          "/me/profile/custom-fields",
+          {
+            ...options,
+            method: "PATCH",
+            body
+          }
+        );
       },
       /** Retrieve editable catalog references on my candidate profile. */
       retrieveObjectReferences(options) {
@@ -1626,6 +1674,26 @@ function meNamespace(client) {
           method: "POST",
           body: form
         });
+      },
+      /**
+       * Upload one file to an owner-editable `image_gallery` or `file` field
+       * of my profile (up to 10 MB; galleries take JPEG, PNG, WebP or GIF).
+       * The file is a draft until its `id` is saved to the field with
+       * `updateCustomFields`, as the ordered list of file IDs.
+       *
+       * @example
+       * const image = await board.me.profile.uploadCustomFieldFile('portfolio', file);
+       * await board.me.profile.updateCustomFields({
+       *   values: { portfolio: [...savedIds, image.id] },
+       * });
+       */
+      uploadCustomFieldFile(fieldKey, file, options) {
+        const form = new FormData();
+        form.append("file", file);
+        return client.fetch(
+          `/me/profile/custom-fields/${encodeURIComponent(fieldKey)}/files`,
+          { ...options, method: "POST", body: form }
+        );
       }
     },
     /**
@@ -4300,6 +4368,7 @@ function createBoardClient(options) {
     embed: embedNamespace(client),
     companies: companiesNamespace(client),
     blog: blogNamespace(client),
+    collections: collectionsNamespace(client),
     auth: authNamespace(client, options.board),
     me: meNamespace(client),
     invites: invitesNamespace(client),

package/dist/{jobs-CbXbDBij.d.mts → jobs-CbTUedOr.d.mts}

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

package/dist/{jobs-DM_QMccX.d.ts → jobs-D2mKA65F.d.ts}

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

package/dist/{search-B7x4qt9A.d.ts → search-CHejx_k7.d.ts}

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

package/dist/{search-PrqcJMft.d.mts → search-CxUViZsz.d.mts}

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

package/dist/{seo-ohehUCzN.d.mts → seo-CWa4rTf7.d.mts}

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

package/dist/{seo-C1Br7ygq.d.ts → seo-DYyQ8NTh.d.ts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-CIufstif.js';
+import { S as Schemas } from './_spec-BehBmeHK.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-ohehUCzN.mjs';
-import './_spec-CIufstif.mjs';
+import { B as BoardSeo } from './seo-CWa4rTf7.mjs';
+import './_spec-BehBmeHK.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-C1Br7ygq.js';
-import './_spec-CIufstif.js';
+import { B as BoardSeo } from './seo-DYyQ8NTh.js';
+import './_spec-BehBmeHK.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-teDJ9KaO.mjs';
-import { e as JsonLdObject } from './breadcrumbs-Bt3oNIAx.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-Bt3oNIAx.mjs';
-import './_spec-CIufstif.mjs';
-import './board-DZNCHGgl.mjs';
-import './jobs-CbXbDBij.mjs';
+import { P as PublicBlogPostSummary, B as BlogAuthorEmbed } from './blog-BmfbjijG.mjs';
+import { e as JsonLdObject } from './breadcrumbs-Cu_SPdRA.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-Cu_SPdRA.mjs';
+import './_spec-BehBmeHK.mjs';
+import './board-CXd9Me7_.mjs';
+import './jobs-CbTUedOr.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-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';
+import { P as PublicBlogPostSummary, B as BlogAuthorEmbed } from './blog-BLpOmpyQ.js';
+import { e as JsonLdObject } from './breadcrumbs-PEsRCVwI.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-PEsRCVwI.js';
+import './_spec-BehBmeHK.js';
+import './board-dV_3NXAI.js';
+import './jobs-D2mKA65F.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-CIufstif.mjs';
-import './search-PrqcJMft.mjs';
-import './jobs-CbXbDBij.mjs';
-import './board-DZNCHGgl.mjs';
-import './seo-ohehUCzN.mjs';
-import './blog-teDJ9KaO.mjs';
+import './_spec-BehBmeHK.mjs';
+import './search-CxUViZsz.mjs';
+import './jobs-CbTUedOr.mjs';
+import './board-CXd9Me7_.mjs';
+import './seo-CWa4rTf7.mjs';
+import './blog-BmfbjijG.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-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-BehBmeHK.js';
+import './search-CHejx_k7.js';
+import './jobs-D2mKA65F.js';
+import './board-dV_3NXAI.js';
+import './seo-DYyQ8NTh.js';
+import './blog-BLpOmpyQ.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-H3YIWHXR.mjs";
+} from "./chunk-ZA5TZ6UH.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-CIufstif.mjs';
-import './search-PrqcJMft.mjs';
-import './jobs-CbXbDBij.mjs';
-import './board-DZNCHGgl.mjs';
-import './seo-ohehUCzN.mjs';
-import './blog-teDJ9KaO.mjs';
+import './_spec-BehBmeHK.mjs';
+import './search-CxUViZsz.mjs';
+import './jobs-CbTUedOr.mjs';
+import './board-CXd9Me7_.mjs';
+import './seo-CWa4rTf7.mjs';
+import './blog-BmfbjijG.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-BehBmeHK.js';
+import './search-CHejx_k7.js';
+import './jobs-D2mKA65F.js';
+import './board-dV_3NXAI.js';
+import './seo-DYyQ8NTh.js';
+import './blog-BLpOmpyQ.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-ZA5TZ6UH.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-CxUViZsz.mjs';
+import './_spec-BehBmeHK.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-CHejx_k7.js';
+import './_spec-BehBmeHK.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.67.0",
   "description": "Build custom job boards and careers pages with Cavuno’s TypeScript SDK.",
   "keywords": [
     "api-client",

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

@@ -206,6 +206,17 @@ The SDK builds multipart `FormData` with field `file` from a `Blob` or `File`. A
 const { avatarUrl } = await board.me.profile.uploadAvatar(file);
 ```
 
+Image gallery and file custom fields take one upload per call, up to 10 MB; galleries accept JPEG, PNG, WebP or GIF and hold at most 10 images. Only fields with `editableByOwner: true` accept uploads. An upload is a draft until you save its `id` to the field: the field's value is the ordered list of file IDs, so append, remove or reorder IDs and send the whole list. Drafts never saved are deleted after a day. Show previews from the returned `url` and from `customFieldMedia` on `retrieveCustomFields`; both are signed links that expire, so read them fresh rather than storing them.
+
+```ts snippet
+const { values } = await board.me.profile.retrieveCustomFields();
+const saved = Array.isArray(values.portfolio) ? values.portfolio : [];
+const image = await board.me.profile.uploadCustomFieldFile('portfolio', file);
+await board.me.profile.updateCustomFields({
+  values: { portfolio: [...saved, image.id] },
+});
+```
+
 Resume upload starts an asynchronous parse that may populate the profile. Poll within a fixed budget, surface failure, and keep manual editing available if parsing runs long.
 
 ```ts snippet

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

@@ -1,13 +1,13 @@
 ---
 name: cavuno-board-collections
-description: Custom profile fields and collection references with @cavuno/board. Use for rendering company, talent or job custom fields, collection entries, benefits/technologies/certification sections, or collection-backed filters.
+description: Custom profile fields, collection references and public collections with @cavuno/board. Use for rendering company, talent or job custom fields, collection entries, a page that lists a collection's entries (resources, partners, communities), benefits/technologies/certification sections, or collection-backed filters.
 ---
 
 # Custom fields and collections
 
 An operator defines two kinds of extra data. A **custom field** stores one typed value directly on a company, talent profile, or job. A **collection reference** points that record at reusable entries — benefits, technologies, certifications, learning resources — that the operator maintains once and every record shares.
 
-Hosted Cavuno boards do not render either one. The API resolves them and your frontend decides the layout, so this surface is read-heavy: definitions tell you what to draw, resolved selections tell you what to draw it with.
+Your site renders both. The API resolves them and your frontend decides the layout, so this surface is read-heavy: definitions tell you what to draw, resolved selections tell you what to draw it with. A collection the operator made public can also be listed on its own page with `board.collections.entries` (see below).
 
 ## The read model
 
@@ -76,6 +76,34 @@ for (const field of job.resolvedCollectionFields) {
 }
 ```
 
+## Public collections
+
+A collection the operator turned **Public** on (Settings, Collections) can be listed on its own page, such as a Resources or Partners page. Ask the operator for the collection's key; a collection that is not public, archived, or unknown throws `BoardApiError` with code `collections_not_found`.
+
+```ts snippet
+const entries = [];
+let cursor: string | undefined;
+do {
+  const page = await board.collections.entries('trade_communities', {
+    limit: 100,
+    cursor,
+  });
+  entries.push(...page.data);
+  cursor = page.nextCursor ?? undefined;
+} while (cursor);
+
+for (const entry of entries) {
+  renderResource({
+    heading: entry.name,
+    logoUrl: entry.logoUrl,
+    website: entry.values.website,
+    href: entry.slug ? `/resources/${entry.slug}` : undefined,
+  });
+}
+```
+
+Each entry is `{ id, name, slug?, logoUrl?, fields, values, references? }`, sorted by name: the same `fields` / `values` / `references` shape as a job collection entry, without the per-job `title` and `description`. Take labels from `fields`.
+
 Visibility is enforced server-side. Public reads return only public scalar fields, public collection fields, and active entries; private definitions and archived entries are omitted entirely, not nulled. Do not render a placeholder for a key that is absent — the operator meant it to be invisible. An owner read returns the private owner-editable fields too, so the same component can receive either payload; branch on what is present.
 
 ## Owner writes
@@ -140,6 +168,7 @@ Finish only after every applicable check passes:
 - Rich text renders as formatted HTML, not escaped tags.
 - A private field and an archived entry are absent from the public render, with no empty placeholder left behind.
 - Job pages read `resolvedCollectionFields`, and company or talent pages read `objectReferences` — neither shape is assumed for the other.
+- A page that lists a collection reads `board.collections.entries`, follows `nextCursor` to the end, and handles `collections_not_found` without a broken page.
 - Filter requests carry record IDs from a choices call, and the filter control's options come from the public definition list.
 - A multi-select picker stops at the definition's `maxSelections`, or at 100 when the definition omits it.
 

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