@cavuno/board 4.6.0 → 4.8.0

package/CHANGELOG.md

@@ -3,6 +3,38 @@
 This changelog records changes that affect Board API compatibility, exported
 types, runtime behavior, or supported integration patterns.
 
+## 4.8.0 — 2026-08-23
+
+- **Country-gated Apply flows**: compatible starters can use
+  `board.jobs.createApplyIntent` for opaque external-apply redirects and
+  `board.jobs.prepareApplyApproval` before native Apply. The browser completes
+  country approval directly against the Cavuno Apply gateway, then returns the
+  opaque receipt through the existing `board.jobs.apply` call. New job payloads
+  expose `applyAction`, and native Apply accepts `approvalReceipt` plus the
+  matching server-owned `approvalSessionKey`. These additions keep destination
+  URLs and client-supplied country or IP values out of the trusted decision.
+
+## 4.7.0 — 2026-08-23
+
+- **`board.me.companies.recommendedTalent.list`**: candidates who fit one of
+  your company's jobs, best match first, for a signed-in employer. Pass the
+  company `slug` and the required `job`. Each item wraps the same
+  `talent_directory_entry` card the public directory returns, so existing
+  rendering works unchanged, and `jobSearchStatus` is populated even when the
+  candidate scoped it to employers only, because the caller is a verified
+  employer. Candidates who already applied to that job are excluded — they
+  belong to the job's pipeline, not to sourcing — as are hidden profiles and
+  anyone whose job-search status is `not_looking`. The response exposes no
+  rank, score, band, or ranker identity, and ranking improves server-side
+  without contract changes. The list is a bounded top slice, so expect it to
+  be short; an empty `data` is not a relevance signal and can arrive
+  mid-pagination, so follow `hasMore` / `nextCursor` rather than stopping at
+  the first empty page. Requires an approved `company_membership` for the
+  company, and the job must belong to it. A draft job answers
+  `409 job_not_published` rather than an empty list — only published jobs
+  carry the vectors matching needs. Exported types: `RecommendedTalent`,
+  `RecommendedTalentListQuery`.
+
 ## 4.6.0 — 2026-08-22
 
 - **`board.me.recommendedJobs.list`**: personalized jobs for the signed-in

package/dist/{_spec-Dm-1AieO.d.mts → _spec-DePC7a05.d.mts}

@@ -127,11 +127,40 @@ interface components {
                 companyName: string | null;
             } | null;
         };
+        ApplyApprovalPlan: {
+            /** @enum {string} */
+            object: "apply_approval_plan";
+            /** @enum {string} */
+            kind: "not_required";
+        } | {
+            /** @enum {string} */
+            object: "apply_approval_plan";
+            /** @enum {string} */
+            kind: "approval_required";
+            /** Format: uri */
+            approvalUrl: string;
+            /** Format: date-time */
+            expiresAt: string;
+        };
         ApplyBody: {
             name?: string;
             /** Format: email */
             email?: string;
             coverNote?: string;
+            /** @description Opaque native country-approval receipt returned by the browser-direct Apply gateway. */
+            approvalReceipt?: string;
+            /** @description Server-owned board session key that prepared the country approval. */
+            approvalSessionKey?: string;
+        };
+        ApplyIntent: {
+            /** @description Opaque one-time Apply intent token. */
+            id: string;
+            /** @enum {string} */
+            object: "apply_intent";
+            /** Format: uri */
+            gatewayUrl: string;
+            /** Format: date-time */
+            expiresAt: string;
         };
         Block: {
             /** @enum {string} */
@@ -329,6 +358,7 @@ interface components {
             handle: string | null;
             headline: string | null;
             location: string | null;
+            countryCode: string | null;
             /** @enum {string} */
             profileVisibility: "hidden" | "logged_in_only" | "public";
             /** @enum {string} */
@@ -634,6 +664,12 @@ interface components {
             object: "conversation_ref";
             conversationId: string | null;
         };
+        CreateApplyApprovalBody: {
+            sessionKey: string;
+        };
+        CreateApplyIntentBody: {
+            sessionKey: string;
+        };
         CreateCompanyBody: {
             /** @description Public company website URL. Normalized to a canonical apex domain when stored. */
             website?: string;
@@ -1578,7 +1614,7 @@ interface components {
             /** @enum {string} */
             object: "notification_preference";
             /** @enum {string} */
-            channel: "messageEmails" | "applicationEmails";
+            channel: "messageEmails" | "applicationEmails" | "recommendedJobEmails";
             subscribed: boolean;
             updatedAt: number | null;
         };
@@ -1880,6 +1916,9 @@ interface components {
             description: string | null;
             /** @description Where candidates apply, or `null` if not specified. An HTTPS URL or `mailto:` URI. */
             applicationUrl: string | null;
+            isSponsored: boolean;
+            /** @enum {string} */
+            applyAction: "native" | "external_direct" | "gateway_external" | "gateway_native";
             /** @description Hierarchical permit selection authored by the board owner. The three `remoteWorkPermit*` and `remoteWorldwide` fields are read-only derived projections. */
             remotePermits: {
                 type: string;
@@ -2172,6 +2211,11 @@ interface components {
             object: "recommended_job";
             job: components["schemas"]["PublicJobCard"];
         };
+        RecommendedTalent: {
+            /** @enum {string} */
+            object: "recommended_talent";
+            candidate: components["schemas"]["TalentDirectoryEntry"];
+        };
         RedirectResolution: {
             /** @enum {string} */
             object: "redirect_resolution";
@@ -2756,7 +2800,7 @@ interface components {
         UnsubscribeBody: {
             boardUserId: string;
             /** @enum {string} */
-            channel: "messageEmails" | "applicationEmails";
+            channel: "messageEmails" | "applicationEmails" | "recommendedJobEmails";
             token: string;
         };
         UpdateApplicationFactsBody: {
@@ -2773,6 +2817,7 @@ interface components {
             handle?: string;
             headline?: string;
             location?: string;
+            countryCode?: string | null;
             /** @enum {string} */
             profileVisibility?: "hidden" | "logged_in_only" | "public";
             /** @enum {string} */
@@ -2827,7 +2872,7 @@ interface components {
         };
         UpdateNotificationPreferenceBody: {
             /** @enum {string} */
-            channel: "messageEmails" | "applicationEmails";
+            channel: "messageEmails" | "applicationEmails" | "recommendedJobEmails";
             subscribed: boolean;
         };
         UpdatePasswordBody: {

package/dist/{_spec-Dm-1AieO.d.ts → _spec-DePC7a05.d.ts}

@@ -127,11 +127,40 @@ interface components {
                 companyName: string | null;
             } | null;
         };
+        ApplyApprovalPlan: {
+            /** @enum {string} */
+            object: "apply_approval_plan";
+            /** @enum {string} */
+            kind: "not_required";
+        } | {
+            /** @enum {string} */
+            object: "apply_approval_plan";
+            /** @enum {string} */
+            kind: "approval_required";
+            /** Format: uri */
+            approvalUrl: string;
+            /** Format: date-time */
+            expiresAt: string;
+        };
         ApplyBody: {
             name?: string;
             /** Format: email */
             email?: string;
             coverNote?: string;
+            /** @description Opaque native country-approval receipt returned by the browser-direct Apply gateway. */
+            approvalReceipt?: string;
+            /** @description Server-owned board session key that prepared the country approval. */
+            approvalSessionKey?: string;
+        };
+        ApplyIntent: {
+            /** @description Opaque one-time Apply intent token. */
+            id: string;
+            /** @enum {string} */
+            object: "apply_intent";
+            /** Format: uri */
+            gatewayUrl: string;
+            /** Format: date-time */
+            expiresAt: string;
         };
         Block: {
             /** @enum {string} */
@@ -329,6 +358,7 @@ interface components {
             handle: string | null;
             headline: string | null;
             location: string | null;
+            countryCode: string | null;
             /** @enum {string} */
             profileVisibility: "hidden" | "logged_in_only" | "public";
             /** @enum {string} */
@@ -634,6 +664,12 @@ interface components {
             object: "conversation_ref";
             conversationId: string | null;
         };
+        CreateApplyApprovalBody: {
+            sessionKey: string;
+        };
+        CreateApplyIntentBody: {
+            sessionKey: string;
+        };
         CreateCompanyBody: {
             /** @description Public company website URL. Normalized to a canonical apex domain when stored. */
             website?: string;
@@ -1578,7 +1614,7 @@ interface components {
             /** @enum {string} */
             object: "notification_preference";
             /** @enum {string} */
-            channel: "messageEmails" | "applicationEmails";
+            channel: "messageEmails" | "applicationEmails" | "recommendedJobEmails";
             subscribed: boolean;
             updatedAt: number | null;
         };
@@ -1880,6 +1916,9 @@ interface components {
             description: string | null;
             /** @description Where candidates apply, or `null` if not specified. An HTTPS URL or `mailto:` URI. */
             applicationUrl: string | null;
+            isSponsored: boolean;
+            /** @enum {string} */
+            applyAction: "native" | "external_direct" | "gateway_external" | "gateway_native";
             /** @description Hierarchical permit selection authored by the board owner. The three `remoteWorkPermit*` and `remoteWorldwide` fields are read-only derived projections. */
             remotePermits: {
                 type: string;
@@ -2172,6 +2211,11 @@ interface components {
             object: "recommended_job";
             job: components["schemas"]["PublicJobCard"];
         };
+        RecommendedTalent: {
+            /** @enum {string} */
+            object: "recommended_talent";
+            candidate: components["schemas"]["TalentDirectoryEntry"];
+        };
         RedirectResolution: {
             /** @enum {string} */
             object: "redirect_resolution";
@@ -2756,7 +2800,7 @@ interface components {
         UnsubscribeBody: {
             boardUserId: string;
             /** @enum {string} */
-            channel: "messageEmails" | "applicationEmails";
+            channel: "messageEmails" | "applicationEmails" | "recommendedJobEmails";
             token: string;
         };
         UpdateApplicationFactsBody: {
@@ -2773,6 +2817,7 @@ interface components {
             handle?: string;
             headline?: string;
             location?: string;
+            countryCode?: string | null;
             /** @enum {string} */
             profileVisibility?: "hidden" | "logged_in_only" | "public";
             /** @enum {string} */
@@ -2827,7 +2872,7 @@ interface components {
         };
         UpdateNotificationPreferenceBody: {
             /** @enum {string} */
-            channel: "messageEmails" | "applicationEmails";
+            channel: "messageEmails" | "applicationEmails" | "recommendedJobEmails";
             subscribed: boolean;
         };
         UpdatePasswordBody: {

package/dist/{blog-C5g0Tt8w.d.mts → blog-DbFr4VPW.d.mts}

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

package/dist/{blog-BvyEW4bf.d.ts → blog-ummlt6Uq.d.ts}

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

package/dist/{board-CemD1yEl.d.mts → board-DxTMBgIf.d.mts}

@@ -1,5 +1,5 @@
-import { S as Schemas } from './_spec-Dm-1AieO.mjs';
-import { L as ListEnvelope, m as RelatedSearch } from './jobs-B0phTsdB.mjs';
+import { S as Schemas } from './_spec-DePC7a05.mjs';
+import { L as ListEnvelope, m as RelatedSearch } from './jobs-DTLDt57G.mjs';
 
 type PublicCompany = Schemas['CompanyPublic'];
 /** A market (sector) a company operates in — name + its source slug. */

package/dist/{board-CW3qMKdu.d.ts → board-zWyHbyi4.d.ts}

@@ -1,5 +1,5 @@
-import { S as Schemas } from './_spec-Dm-1AieO.js';
-import { L as ListEnvelope, m as RelatedSearch } from './jobs-f-n4_rrz.js';
+import { S as Schemas } from './_spec-DePC7a05.js';
+import { L as ListEnvelope, m as RelatedSearch } from './jobs-twt5TO9l.js';
 
 type PublicCompany = Schemas['CompanyPublic'];
 /** A market (sector) a company operates in — name + its source slug. */

package/dist/{breadcrumbs-Bgmklae3.d.mts → breadcrumbs-P4qh0zML.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-CemD1yEl.mjs';
-import { P as PublicJob } from './jobs-B0phTsdB.mjs';
+import { P as PublicBoard, a as CompanyCategorySalary, b as CompanySalary, L as LocationSalaryDetail, S as SkillSalaryDetail, T as TitleSalaryDetail } from './board-DxTMBgIf.mjs';
+import { P as PublicJob } from './jobs-DTLDt57G.mjs';
 
 /**
  * Wire enum for `salaryTimeframe`. Defined here (not re-exported from any

package/dist/{breadcrumbs-BRHiWWSf.d.ts → breadcrumbs-kbmspmfk.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-CW3qMKdu.js';
-import { P as PublicJob } from './jobs-f-n4_rrz.js';
+import { P as PublicBoard, a as CompanyCategorySalary, b as CompanySalary, L as LocationSalaryDetail, S as SkillSalaryDetail, T as TitleSalaryDetail } from './board-zWyHbyi4.js';
+import { P as PublicJob } from './jobs-twt5TO9l.js';
 
 /**
  * Wire enum for `salaryTimeframe`. Defined here (not re-exported from any