@cavuno/board 4.66.0 → 4.67.0

package/dist/index.mjs

@@ -28,7 +28,7 @@ import {
   isSsoRequired,
   isUnauthorized,
   isValidationError
-} from "./chunk-R62XFNS7.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.66.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(
@@ -1433,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) {
@@ -1643,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 }
+        );
       }
     },
     /**
@@ -4317,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-qoVMh_Zd.d.mts → jobs-CbTUedOr.d.mts}

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

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

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

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

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

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

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

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

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

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

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-DBI6azWs.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-DRVgmTCQ.mjs';
-import './_spec-DBI6azWs.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-BDwe8PwT.js';
-import './_spec-DBI6azWs.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-Bx-rjH4V.mjs';
-import { e as JsonLdObject } from './breadcrumbs-BVN_gIJq.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-BVN_gIJq.mjs';
-import './_spec-DBI6azWs.mjs';
-import './board-BsUhxdjL.mjs';
-import './jobs-qoVMh_Zd.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--VKuBIdw.js';
-import { e as JsonLdObject } from './breadcrumbs-maV86vZP.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-maV86vZP.js';
-import './_spec-DBI6azWs.js';
-import './board-USJ9ZZab.js';
-import './jobs-Dyj1HZ8W.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-DBI6azWs.mjs';
-import './search-CrXCM8Hq.mjs';
-import './jobs-qoVMh_Zd.mjs';
-import './board-BsUhxdjL.mjs';
-import './seo-DRVgmTCQ.mjs';
-import './blog-Bx-rjH4V.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-DBI6azWs.js';
-import './search-DPHLf8pI.js';
-import './jobs-Dyj1HZ8W.js';
-import './board-USJ9ZZab.js';
-import './seo-BDwe8PwT.js';
-import './blog--VKuBIdw.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-R62XFNS7.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-DBI6azWs.mjs';
-import './search-CrXCM8Hq.mjs';
-import './jobs-qoVMh_Zd.mjs';
-import './board-BsUhxdjL.mjs';
-import './seo-DRVgmTCQ.mjs';
-import './blog-Bx-rjH4V.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-DBI6azWs.js';
-import './search-DPHLf8pI.js';
-import './jobs-Dyj1HZ8W.js';
-import './board-USJ9ZZab.js';
-import './seo-BDwe8PwT.js';
-import './blog--VKuBIdw.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-R62XFNS7.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-CrXCM8Hq.mjs';
-import './_spec-DBI6azWs.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-DPHLf8pI.js';
-import './_spec-DBI6azWs.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.66.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/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "4.66.0",
+  "version": "4.67.0",
   "skills": [
     {
       "name": "cavuno-board-account",
@@ -38,7 +38,7 @@
     },
     {
       "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.",
       "path": "skills/cavuno-board-collections/SKILL.md",
       "framework": null,
       "category": "core"