@cavuno/board 4.66.0 → 4.67.0

package/CHANGELOG.md

@@ -3,6 +3,23 @@
 This changelog records changes that affect Board API compatibility, exported
 types, runtime behavior, or supported integration patterns.
 
+## 4.67.0 — 2026-11-11
+
+- Job seekers can fill their own image gallery and file profile fields: new
+  `board.me.profile.uploadCustomFieldFile(fieldKey, file)` uploads one file
+  (up to 10 MB; galleries take JPEG, PNG, WebP or GIF) to a field the profile
+  owner can edit and returns it as a draft. Save its `id` with
+  `board.me.profile.updateCustomFields` to attach it; drafts never saved are
+  deleted after 24 hours. New error codes `candidate_custom_field_not_found`
+  (404) and `candidate_custom_field_not_editable` (403).
+- Talent profile and directory reads, and the job seeker's own custom-field
+  reads, return `customFieldMedia`: the files of public image gallery and file
+  fields with signed links that expire after at least 24 hours. Redacted
+  previews return none.
+- New `board.collections.entries(key)` lists the active entries of a
+  collection the operator made public, with only its public fields. A
+  collection that is not public returns `collections_not_found`.
+
 ## 4.66.0 — 2026-11-11
 
 - Embedded checkout for paid job postings: send `checkoutUiMode:

package/dist/{_spec-DBI6azWs.d.mts → _spec-BehBmeHK.d.mts}

@@ -2356,6 +2356,12 @@ interface components {
             /** @description The target stage id. */
             stageId: string;
         };
+        MyCandidateProfileFieldValuesResponse: components["schemas"]["ProfileFieldValuesResponse"] & {
+            /** @description Resolved files for the candidate’s saved `image_gallery` and `file` values, keyed by field key like `values`, in the stored order, including private fields. Each file `id` matches a value in `values`. `url` is a signed link for the profile owner that expires after at least 24 hours, so read it from the response rather than storing it. Unsaved uploads are not listed. Fields with no files are omitted. */
+            customFieldMedia: {
+                [key: string]: components["schemas"]["ProfileFieldMedia"][];
+            };
+        };
         MyItemVerification: components["schemas"]["ItemVerification"] & {
             /** @description The verification's id. For an item with no verification yet (`unverified`), its `itemKey`. */
             id?: string;
@@ -3044,6 +3050,84 @@ interface components {
                 youtubeUrl: string | null;
             };
         };
+        PublicCollectionEntry: {
+            /** @description The entry's ID. */
+            id: string;
+            /** @description The entry's name. */
+            name: string;
+            /** @description URL-safe identifier, unique within the collection. Changing it keeps the previous value reserved. */
+            slug?: string;
+            /** @description The entry's logo: the image in the collection's logo field when that field is public, or a legacy logo URL on older entries. Absent when the entry has neither. */
+            logoUrl?: string;
+            /** @description The collection's public field definitions in display order. Take labels and select options from here. */
+            fields: {
+                key: string;
+                label: string;
+                /** @enum {string} */
+                type: "short_text" | "long_text" | "rich_text" | "single_select" | "multi_select" | "boolean" | "number" | "date" | "url" | "email" | "phone" | "image" | "image_gallery" | "file" | "reference";
+                helpText?: string;
+                options?: {
+                    key: string;
+                    label: string;
+                }[];
+            }[];
+            /** @description The entry's values, keyed by public field key. Media values are `{ id, name, contentType, sizeBytes, url }` objects (an array for an image gallery). Reference values are in `references` instead. A field with no value is absent. */
+            values: {
+                [key: string]: string | string[] | boolean | number | {
+                    id: string;
+                    name: string;
+                    contentType: string;
+                    sizeBytes: number;
+                    url: string;
+                } | {
+                    id: string;
+                    name: string;
+                    contentType: string;
+                    sizeBytes: number;
+                    url: string;
+                }[];
+            };
+            /** @description Entries that public reference fields point at, keyed by field key. Always an array, even for a single reference. */
+            references?: {
+                [key: string]: {
+                    id: string;
+                    name: string;
+                    /** @description URL-safe identifier, unique within the collection. Changing it keeps the previous value reserved. */
+                    slug?: string;
+                    fields: {
+                        key: string;
+                        label: string;
+                        /** @enum {string} */
+                        type: "short_text" | "long_text" | "rich_text" | "single_select" | "multi_select" | "boolean" | "number" | "date" | "url" | "email" | "phone" | "image" | "image_gallery" | "file" | "reference";
+                        helpText?: string;
+                        options?: {
+                            key: string;
+                            label: string;
+                        }[];
+                    }[];
+                    values: {
+                        [key: string]: string | string[] | boolean | number | {
+                            id: string;
+                            name: string;
+                            contentType: string;
+                            sizeBytes: number;
+                            url: string;
+                        } | {
+                            id: string;
+                            name: string;
+                            contentType: string;
+                            sizeBytes: number;
+                            url: string;
+                        }[];
+                    };
+                }[];
+            };
+        };
+        PublicCollectionEntryList: {
+            data: components["schemas"]["PublicCollectionEntry"][];
+            /** @description Pass as `cursor` for the next page; null on the last page. */
+            nextCursor: string | null;
+        };
         PublicCompaniesSearchBody: {
             /** @description Free-text search query matched against company name. Up to 200 characters. */
             query?: string;
@@ -4404,6 +4488,10 @@ interface components {
             customFieldValues: {
                 [key: string]: string | number | boolean | string[];
             };
+            /** @description Resolved files for public `image_gallery` and `file` candidate custom fields, keyed by field key like `customFieldValues`, in the stored order. Each file `id` matches a value in `customFieldValues`. `url` is a signed link that expires after at least 24 hours. Anyone holding it can load the file until then, or until the profile is hidden, the field made private or the board password changed, so read it from the response rather than storing or sharing it. The candidate’s own read returns owner links instead, which also load while the profile is hidden or the field is private. Empty on redacted previews, and on an `employers_only` board for viewers other than approved employers and the candidate. Fields with no files are omitted. */
+            customFieldMedia: {
+                [key: string]: components["schemas"]["ProfileFieldMedia"][];
+            };
             objectReferences: components["schemas"]["ResolvedProfileObjectReference"][];
             /**
              * @description Roughly when the candidate was last active on the board: `today` (within 24 hours), `this_week` (7 days), `this_month` (30 days), `last_3_months` (90 days) or `over_3_months`, counted back from the request. Only returned to a signed-in employer on this board, and only when the candidate’s job search status is `actively_looking` or `open_to_offers`; `null` otherwise. The exact time is never exposed.
@@ -4513,6 +4601,10 @@ interface components {
             customFieldValues: {
                 [key: string]: string | number | boolean | string[];
             };
+            /** @description Resolved files for public `image_gallery` and `file` candidate custom fields, keyed by field key like `customFieldValues`, in the stored order. Each file `id` matches a value in `customFieldValues`. `url` is a signed link that expires after at least 24 hours. Anyone holding it can load the file until then, or until the profile is hidden, the field made private or the board password changed, so read it from the response rather than storing or sharing it. The candidate’s own read returns owner links instead, which also load while the profile is hidden or the field is private. Empty on redacted previews, and on an `employers_only` board for viewers other than approved employers and the candidate. Fields with no files are omitted. */
+            customFieldMedia: {
+                [key: string]: components["schemas"]["ProfileFieldMedia"][];
+            };
             objectReferences: components["schemas"]["ResolvedProfileObjectReference"][];
             /**
              * @description Roughly when the candidate was last active on the board: `today` (within 24 hours), `this_week` (7 days), `this_month` (30 days), `last_3_months` (90 days) or `over_3_months`, counted back from the request. Only returned to a signed-in employer on this board, and only when the candidate’s job search status is `actively_looking` or `open_to_offers`; `null` otherwise. The exact time is never exposed.

package/dist/{_spec-DBI6azWs.d.ts → _spec-BehBmeHK.d.ts}

@@ -2356,6 +2356,12 @@ interface components {
             /** @description The target stage id. */
             stageId: string;
         };
+        MyCandidateProfileFieldValuesResponse: components["schemas"]["ProfileFieldValuesResponse"] & {
+            /** @description Resolved files for the candidate’s saved `image_gallery` and `file` values, keyed by field key like `values`, in the stored order, including private fields. Each file `id` matches a value in `values`. `url` is a signed link for the profile owner that expires after at least 24 hours, so read it from the response rather than storing it. Unsaved uploads are not listed. Fields with no files are omitted. */
+            customFieldMedia: {
+                [key: string]: components["schemas"]["ProfileFieldMedia"][];
+            };
+        };
         MyItemVerification: components["schemas"]["ItemVerification"] & {
             /** @description The verification's id. For an item with no verification yet (`unverified`), its `itemKey`. */
             id?: string;
@@ -3044,6 +3050,84 @@ interface components {
                 youtubeUrl: string | null;
             };
         };
+        PublicCollectionEntry: {
+            /** @description The entry's ID. */
+            id: string;
+            /** @description The entry's name. */
+            name: string;
+            /** @description URL-safe identifier, unique within the collection. Changing it keeps the previous value reserved. */
+            slug?: string;
+            /** @description The entry's logo: the image in the collection's logo field when that field is public, or a legacy logo URL on older entries. Absent when the entry has neither. */
+            logoUrl?: string;
+            /** @description The collection's public field definitions in display order. Take labels and select options from here. */
+            fields: {
+                key: string;
+                label: string;
+                /** @enum {string} */
+                type: "short_text" | "long_text" | "rich_text" | "single_select" | "multi_select" | "boolean" | "number" | "date" | "url" | "email" | "phone" | "image" | "image_gallery" | "file" | "reference";
+                helpText?: string;
+                options?: {
+                    key: string;
+                    label: string;
+                }[];
+            }[];
+            /** @description The entry's values, keyed by public field key. Media values are `{ id, name, contentType, sizeBytes, url }` objects (an array for an image gallery). Reference values are in `references` instead. A field with no value is absent. */
+            values: {
+                [key: string]: string | string[] | boolean | number | {
+                    id: string;
+                    name: string;
+                    contentType: string;
+                    sizeBytes: number;
+                    url: string;
+                } | {
+                    id: string;
+                    name: string;
+                    contentType: string;
+                    sizeBytes: number;
+                    url: string;
+                }[];
+            };
+            /** @description Entries that public reference fields point at, keyed by field key. Always an array, even for a single reference. */
+            references?: {
+                [key: string]: {
+                    id: string;
+                    name: string;
+                    /** @description URL-safe identifier, unique within the collection. Changing it keeps the previous value reserved. */
+                    slug?: string;
+                    fields: {
+                        key: string;
+                        label: string;
+                        /** @enum {string} */
+                        type: "short_text" | "long_text" | "rich_text" | "single_select" | "multi_select" | "boolean" | "number" | "date" | "url" | "email" | "phone" | "image" | "image_gallery" | "file" | "reference";
+                        helpText?: string;
+                        options?: {
+                            key: string;
+                            label: string;
+                        }[];
+                    }[];
+                    values: {
+                        [key: string]: string | string[] | boolean | number | {
+                            id: string;
+                            name: string;
+                            contentType: string;
+                            sizeBytes: number;
+                            url: string;
+                        } | {
+                            id: string;
+                            name: string;
+                            contentType: string;
+                            sizeBytes: number;
+                            url: string;
+                        }[];
+                    };
+                }[];
+            };
+        };
+        PublicCollectionEntryList: {
+            data: components["schemas"]["PublicCollectionEntry"][];
+            /** @description Pass as `cursor` for the next page; null on the last page. */
+            nextCursor: string | null;
+        };
         PublicCompaniesSearchBody: {
             /** @description Free-text search query matched against company name. Up to 200 characters. */
             query?: string;
@@ -4404,6 +4488,10 @@ interface components {
             customFieldValues: {
                 [key: string]: string | number | boolean | string[];
             };
+            /** @description Resolved files for public `image_gallery` and `file` candidate custom fields, keyed by field key like `customFieldValues`, in the stored order. Each file `id` matches a value in `customFieldValues`. `url` is a signed link that expires after at least 24 hours. Anyone holding it can load the file until then, or until the profile is hidden, the field made private or the board password changed, so read it from the response rather than storing or sharing it. The candidate’s own read returns owner links instead, which also load while the profile is hidden or the field is private. Empty on redacted previews, and on an `employers_only` board for viewers other than approved employers and the candidate. Fields with no files are omitted. */
+            customFieldMedia: {
+                [key: string]: components["schemas"]["ProfileFieldMedia"][];
+            };
             objectReferences: components["schemas"]["ResolvedProfileObjectReference"][];
             /**
              * @description Roughly when the candidate was last active on the board: `today` (within 24 hours), `this_week` (7 days), `this_month` (30 days), `last_3_months` (90 days) or `over_3_months`, counted back from the request. Only returned to a signed-in employer on this board, and only when the candidate’s job search status is `actively_looking` or `open_to_offers`; `null` otherwise. The exact time is never exposed.
@@ -4513,6 +4601,10 @@ interface components {
             customFieldValues: {
                 [key: string]: string | number | boolean | string[];
             };
+            /** @description Resolved files for public `image_gallery` and `file` candidate custom fields, keyed by field key like `customFieldValues`, in the stored order. Each file `id` matches a value in `customFieldValues`. `url` is a signed link that expires after at least 24 hours. Anyone holding it can load the file until then, or until the profile is hidden, the field made private or the board password changed, so read it from the response rather than storing or sharing it. The candidate’s own read returns owner links instead, which also load while the profile is hidden or the field is private. Empty on redacted previews, and on an `employers_only` board for viewers other than approved employers and the candidate. Fields with no files are omitted. */
+            customFieldMedia: {
+                [key: string]: components["schemas"]["ProfileFieldMedia"][];
+            };
             objectReferences: components["schemas"]["ResolvedProfileObjectReference"][];
             /**
              * @description Roughly when the candidate was last active on the board: `today` (within 24 hours), `this_week` (7 days), `this_month` (30 days), `last_3_months` (90 days) or `over_3_months`, counted back from the request. Only returned to a signed-in employer on this board, and only when the candidate’s job search status is `actively_looking` or `open_to_offers`; `null` otherwise. The exact time is never exposed.

package/dist/{blog--VKuBIdw.d.ts → blog-BLpOmpyQ.d.ts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-DBI6azWs.js';
+import { S as Schemas } from './_spec-BehBmeHK.js';
 
 /** Author shape embedded on posts (no `object` discriminator). */
 type BlogAuthorEmbed = Schemas['PublicBlogAuthorEmbed'];

package/dist/{blog-Bx-rjH4V.d.mts → blog-BmfbjijG.d.mts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-DBI6azWs.mjs';
+import { S as Schemas } from './_spec-BehBmeHK.mjs';
 
 /** Author shape embedded on posts (no `object` discriminator). */
 type BlogAuthorEmbed = Schemas['PublicBlogAuthorEmbed'];

package/dist/{board-BsUhxdjL.d.mts → board-CXd9Me7_.d.mts}

@@ -1,5 +1,5 @@
-import { S as Schemas } from './_spec-DBI6azWs.mjs';
-import { L as ListEnvelope, v as RelatedSearch, b as CustomFieldFilter, O as ObjectReferenceFilter, a as JobCapability } from './jobs-qoVMh_Zd.mjs';
+import { S as Schemas } from './_spec-BehBmeHK.mjs';
+import { L as ListEnvelope, v as RelatedSearch, b as CustomFieldFilter, O as ObjectReferenceFilter, a as JobCapability } from './jobs-CbTUedOr.mjs';
 
 type PublicCompany = Schemas['CompanyPublic'];
 /**

package/dist/{board-USJ9ZZab.d.ts → board-dV_3NXAI.d.ts}

@@ -1,5 +1,5 @@
-import { S as Schemas } from './_spec-DBI6azWs.js';
-import { L as ListEnvelope, v as RelatedSearch, b as CustomFieldFilter, O as ObjectReferenceFilter, a as JobCapability } from './jobs-Dyj1HZ8W.js';
+import { S as Schemas } from './_spec-BehBmeHK.js';
+import { L as ListEnvelope, v as RelatedSearch, b as CustomFieldFilter, O as ObjectReferenceFilter, a as JobCapability } from './jobs-D2mKA65F.js';
 
 type PublicCompany = Schemas['CompanyPublic'];
 /**

package/dist/{breadcrumbs-BVN_gIJq.d.mts → breadcrumbs-Cu_SPdRA.d.mts}

@@ -1,5 +1,5 @@
-import { P as PublicBoard, a as CompanyCategorySalary, b as CompanySalary, L as LocationSalaryDetail, S as SkillSalaryDetail, T as TitleSalaryDetail } from './board-BsUhxdjL.mjs';
-import { P as PublicJob } from './jobs-qoVMh_Zd.mjs';
+import { P as PublicBoard, a as CompanyCategorySalary, b as CompanySalary, L as LocationSalaryDetail, S as SkillSalaryDetail, T as TitleSalaryDetail } from './board-CXd9Me7_.mjs';
+import { P as PublicJob } from './jobs-CbTUedOr.mjs';
 
 /**
  * Wire enum for `salaryTimeframe`. Defined here (not re-exported from any

package/dist/{breadcrumbs-maV86vZP.d.ts → breadcrumbs-PEsRCVwI.d.ts}

@@ -1,5 +1,5 @@
-import { P as PublicBoard, a as CompanyCategorySalary, b as CompanySalary, L as LocationSalaryDetail, S as SkillSalaryDetail, T as TitleSalaryDetail } from './board-USJ9ZZab.js';
-import { P as PublicJob } from './jobs-Dyj1HZ8W.js';
+import { P as PublicBoard, a as CompanyCategorySalary, b as CompanySalary, L as LocationSalaryDetail, S as SkillSalaryDetail, T as TitleSalaryDetail } from './board-dV_3NXAI.js';
+import { P as PublicJob } from './jobs-D2mKA65F.js';
 
 /**
  * Wire enum for `salaryTimeframe`. Defined here (not re-exported from any