@cavuno/board 4.47.0 → 4.49.0

package/dist/index.d.mts

@@ -1,13 +1,13 @@
-import { S as Schemas, c as components } from './_spec-DHa5r3B0.mjs';
-import { F as FetchOptions, S as StorageMode, B as BoardRequest, A as Awaitable, L as Logger, a as BoardClient, b as SearchSuggestQuery } from './search-DBQApXN1.mjs';
-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-DBQApXN1.mjs';
-import { L as ListEnvelope, R as RemoteOption, E as EmploymentType, S as Seniority, a as CustomFieldFilter, O as ObjectReferenceFilter, b as JobCollectionChoiceQuery, c as JobsListQuery, d as JobCardListEnvelope, e as JobsSearchBody, f as JobCardSearchEnvelope, g as JobsSimilarQuery, h as SearchEnvelope } from './jobs-CMK-DZg3.mjs';
-export { i as CustomFieldValue, C as CustomFieldValues, j as CustomFilterValue, k as EducationRequirement, l as JobCatalogPagination, m as JobCollectionChoiceList, n as JobCollectionFieldDefinition, o as JobCompany, p as JobCustomEmploymentType, J as JobSort, q as OfficeLocation, r as OffsetPagination, P as PublicJob, s as PublicJobCard, t as RelatedSearch, u as RemotePermit, v as RemoteTimezone, w as ResolvedJobCollectionField, x as StorefrontPagination } from './jobs-CMK-DZg3.mjs';
-import { c as CompaniesListQuery, d as CompanyListEnvelope, e as CompaniesSearchBody, f as CompanyJobsListQuery, g as CompanySimilarQuery, h as CompanyMarketsListQuery, i as SalaryDetailQuery } from './board-Bpze3b50.mjs';
-export { B as BoardCustomEmploymentType, j as BoardFormBuiltinField, k as BoardFormField, l as BoardFormLayout, m as BoardFormLockReason, n as BoardJobFormField, o as BoardProfileFormField, p as BoardRoleSignIn, q as BoardSignInSsoConnection, a as CompanyCategorySalary, r as CompanyMarket, s as CompanyMarketRef, b as CompanySalary, t as CompanySalarySummary, C as CustomFieldDefinition, u as CustomFieldOption, v as CustomFieldType, L as LocationSalaryDetail, w as LocationSkillsIndex, x as LocationTitlesIndex, P as PublicBoard, y as PublicBoardAds, z as PublicBoardAnalytics, A as PublicBoardFeatures, D as PublicBoardJobForm, E as PublicBoardSignIn, F as PublicCompany, G as PublicCompanyDetail, H as PublicCompanyMembership, I as SalaryCompany, J as SalaryLocation, K as SalarySkill, M as SalaryTitle, N as SkillLocationSalary, O as SkillLocationsIndex, S as SkillSalaryDetail, Q as TitleLocationSalary, R as TitleLocationsIndex, T as TitleSalaryDetail } from './board-Bpze3b50.mjs';
-export { B as BoardSeo } from './seo-gY8y9RMw.mjs';
-import { a as BlogPostsListQuery, b as BlogSimilarQuery, c as BlogSearchBody } from './blog-DylAbc0L.mjs';
-export { B as BlogAuthorEmbed, d as BlogTagEmbed, e as PublicBlogAdjacentPosts, f as PublicBlogAuthor, g as PublicBlogPost, P as PublicBlogPostSummary, h as PublicBlogTag } from './blog-DylAbc0L.mjs';
+import { S as Schemas, c as components } from './_spec-DiQvT7IN.mjs';
+import { F as FetchOptions, S as StorageMode, B as BoardRequest, A as Awaitable, L as Logger, a as BoardClient, b as SearchSuggestQuery } from './search-g3oH9aPu.mjs';
+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-g3oH9aPu.mjs';
+import { L as ListEnvelope, R as RemoteOption, E as EmploymentType, S as Seniority, a as CustomFieldFilter, O as ObjectReferenceFilter, b as JobCollectionChoiceQuery, c as JobsListQuery, d as JobCardListEnvelope, e as JobRetrieveQuery, f as JobsSearchBody, g as JobCardSearchEnvelope, h as JobsSimilarQuery, i as SearchEnvelope } from './jobs-DsO3htwV.mjs';
+export { j as CustomFieldValue, C as CustomFieldValues, k as CustomFilterValue, l as EducationRequirement, m as JobCapability, n as JobCatalogPagination, o as JobCollectionChoiceList, p as JobCollectionFieldDefinition, q as JobCompany, r as JobCustomEmploymentType, J as JobSort, s as OfficeLocation, t as OffsetPagination, P as PublicJob, u as PublicJobCard, v as RelatedSearch, w as RemotePermit, x as RemoteTimezone, y as ResolvedJobCollectionField, z as StorefrontPagination } from './jobs-DsO3htwV.mjs';
+import { c as CompaniesListQuery, d as CompanyListEnvelope, e as CompaniesSearchBody, f as CompanyJobsListQuery, g as CompanySimilarQuery, h as CompanyMarketsListQuery, i as SalaryDetailQuery } from './board-DM-vktAo.mjs';
+export { B as BoardCustomEmploymentType, j as BoardFormBuiltinField, k as BoardFormField, l as BoardFormLayout, m as BoardFormLockReason, n as BoardJobFormField, o as BoardProfileFormField, p as BoardRoleSignIn, q as BoardSignInSsoConnection, a as CompanyCategorySalary, r as CompanyMarket, s as CompanyMarketRef, b as CompanySalary, t as CompanySalarySummary, C as CustomFieldDefinition, u as CustomFieldOption, v as CustomFieldType, L as LocationSalaryDetail, w as LocationSkillsIndex, x as LocationTitlesIndex, P as PublicBoard, y as PublicBoardAds, z as PublicBoardAnalytics, A as PublicBoardFeatures, D as PublicBoardJobForm, E as PublicBoardSignIn, F as PublicCompany, G as PublicCompanyDetail, H as PublicCompanyMembership, I as SalaryCompany, J as SalaryLocation, K as SalarySkill, M as SalaryTitle, N as SkillLocationSalary, O as SkillLocationsIndex, S as SkillSalaryDetail, Q as TitleLocationSalary, R as TitleLocationsIndex, T as TitleSalaryDetail } from './board-DM-vktAo.mjs';
+export { B as BoardSeo } from './seo-DMpAStWc.mjs';
+import { a as BlogPostsListQuery, b as BlogSimilarQuery, c as BlogSearchBody } from './blog-DGa6Wk08.mjs';
+export { B as BlogAuthorEmbed, d as BlogTagEmbed, e as PublicBlogAdjacentPosts, f as PublicBlogAuthor, g as PublicBlogPost, P as PublicBlogPostSummary, h as PublicBlogTag } from './blog-DGa6Wk08.mjs';
 
 /**
  * Well-known `<domain>_<snake_reason>` codes the Board API sends, grouped by
@@ -202,7 +202,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.47.0";
+declare const SDK_VERSION = "4.49.0";
 
 type SavedJob = Schemas['SavedJob'];
 type SavedJobsListQuery = {
@@ -980,7 +980,13 @@ interface ApplyApprovalReceipt {
  * candidate scoped it to employers only.
  */
 type TalentProfile = Schemas['TalentProfile'];
-/** A candidate card in the public talent directory. */
+/**
+ * A candidate card in the public talent directory. On cards and profiles,
+ * `lastActive` is a coarse bucket (`today`, `this_week`, `this_month`,
+ * `last_3_months`, `over_3_months`) returned only to a signed-in employer on
+ * the board, for candidates who are actively looking or open to offers;
+ * `null` for everyone else.
+ */
 type TalentDirectoryEntry = Schemas['TalentDirectoryEntry'];
 type TalentDirectoryQuery = {
     cursor?: string;
@@ -1088,6 +1094,13 @@ type JobAlertRemoteOption = 'on_site' | 'hybrid' | 'remote';
  * `seniorityLevels`/`salary*` are stored but do not filter delivery.
  */
 type JobAlertFiltersInput = {
+    /**
+     * Free-text search keywords (at most 200 characters after trimming). Send
+     * the query a search page ran. On `updatePreference`, `null` clears the
+     * keywords and omitting `query` keeps them while `jobFunctions` are
+     * unchanged. Not accepted on a job-page (similar-job) alert.
+     */
+    query?: string | null;
     jobFunctions?: string[];
     seniorityLevels?: string[];
     remoteOptions?: JobAlertRemoteOption[];
@@ -1119,6 +1132,14 @@ type JobAlertManageState = Schemas['PublicJobAlertManageState'];
 type JobAlertPreference = JobAlertManageState['preferences'][number];
 /** The stored filter criteria surfaced on a manage-page preference. */
 type JobAlertStoredFilters = JobAlertPreference['filters'];
+/**
+ * How an alert's digest is filled: `similar_job` (jobs like the job it was
+ * subscribed from), `search` (a board search for its keywords) or `filters`
+ * (jobs matching its stored filters exactly). Read-only.
+ */
+type JobAlertKind = JobAlertPreference['kind'];
+/** A similar-job alert's anchor job (`{ id, slug, title }`), or `null`. */
+type JobAlertAnchorJob = JobAlertPreference['anchorJob'];
 /** Query for `jobAlerts.manage` — the HMAC manage token from the digest email. */
 type JobAlertManageQuery = {
     subscription: string;
@@ -1441,7 +1462,7 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
             nextCursor: string | null;
         }>;
         list(query?: JobsListQuery, options?: FetchOptions): Promise<JobCardListEnvelope>;
-        retrieve(jobSlug: string, query?: Record<string, never>, options?: FetchOptions): Promise<{
+        retrieve(jobSlug: string, query?: JobRetrieveQuery, options?: FetchOptions): Promise<{
             id: string;
             object: "public_job";
             title: string;
@@ -1501,6 +1522,7 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
             placeHierarchy: {
                 slug: string;
                 name: string;
+                canonicalSlug: string;
             }[];
             customFieldValues: {
                 [key: string]: string | string[] | boolean | number;
@@ -3040,7 +3062,14 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
                 label: string | null;
                 frequency: "weekly";
                 isActive: boolean;
+                kind: "similar_job" | "search" | "filters";
+                anchorJob: {
+                    id: string;
+                    slug: string | null;
+                    title: string;
+                } | null;
                 filters: {
+                    query: string | null;
                     jobFunctions: string[];
                     seniorityLevels: string[];
                     remoteOptions: string[];
@@ -3057,7 +3086,14 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
                 label: string | null;
                 frequency: "weekly";
                 isActive: boolean;
+                kind: "similar_job" | "search" | "filters";
+                anchorJob: {
+                    id: string;
+                    slug: string | null;
+                    title: string;
+                } | null;
                 filters: {
+                    query: string | null;
                     jobFunctions: string[];
                     seniorityLevels: string[];
                     remoteOptions: string[];
@@ -3074,7 +3110,14 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
                 label: string | null;
                 frequency: "weekly";
                 isActive: boolean;
+                kind: "similar_job" | "search" | "filters";
+                anchorJob: {
+                    id: string;
+                    slug: string | null;
+                    title: string;
+                } | null;
                 filters: {
+                    query: string | null;
                     jobFunctions: string[];
                     seniorityLevels: string[];
                     remoteOptions: string[];
@@ -3091,7 +3134,14 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
                 label: string | null;
                 frequency: "weekly";
                 isActive: boolean;
+                kind: "similar_job" | "search" | "filters";
+                anchorJob: {
+                    id: string;
+                    slug: string | null;
+                    title: string;
+                } | null;
                 filters: {
+                    query: string | null;
                     jobFunctions: string[];
                     seniorityLevels: string[];
                     remoteOptions: string[];
@@ -3582,7 +3632,14 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
                 label: string | null;
                 frequency: "weekly";
                 isActive: boolean;
+                kind: "similar_job" | "search" | "filters";
+                anchorJob: {
+                    id: string;
+                    slug: string | null;
+                    title: string;
+                } | null;
                 filters: {
+                    query?: string;
                     jobFunctions?: string[];
                     seniorityLevels?: string[];
                     remoteOptions?: string[];
@@ -4025,6 +4082,7 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
                 avgSalaryMin: number;
                 avgSalaryMax: number;
                 jobCount: number;
+                currency?: string;
             }>>;
             retrieve(locationSlug: string, query?: SalaryDetailQuery, options?: FetchOptions): Promise<{
                 object: "location_salary_detail";
@@ -4118,6 +4176,7 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
                     avgSalaryMin: number;
                     avgSalaryMax: number;
                     jobCount: number;
+                    currency?: string;
                 }[];
             }>;
             skills(locationSlug: string, query?: SalaryDetailQuery, options?: FetchOptions): Promise<{
@@ -4131,6 +4190,7 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
                     avgSalaryMin: number;
                     avgSalaryMax: number;
                     jobCount: number;
+                    currency?: string;
                 }[];
             }>;
         };
@@ -4185,6 +4245,7 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
                 [key: string]: string | number | boolean | string[];
             };
             objectReferences: components["schemas"]["ResolvedProfileObjectReference"][];
+            lastActive: "today" | "this_week" | "this_month" | "last_3_months" | "over_3_months" | null;
         }>;
         places: {
             list(query?: TalentPlacesQuery, options?: FetchOptions): Promise<TalentPlacesListEnvelope>;
@@ -4221,4 +4282,4 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
 };
 type BoardSdk = ReturnType<typeof createBoardClient>;
 
-export { type AcceptCompanyMemberInviteBody, type AccessCheckoutBody, type AccessCheckoutSession, type AccessCheckoutSessionState, type AccessGrant, type AccessPortalBody, type AccessPortalSession, type AddApplicantNoteBody, type AddSourcedCandidateBody, type AddTalentListMemberBody, type Alert, type AlertBody, type Application, type ApplicationsListQuery, type ApplyAction, type ApplyApprovalPlan, type ApplyApprovalReceipt, type ApplyBody, type ApplyDecisionState, type ApplyIntent, type AudienceAttribution, type AvailableSignInMethods, Awaitable, BOARD_API_ERROR_CODES, type BindingStorage, type Block, type BlockStatus, type BlockUserBody, type BlockedUser, BlogPostsListQuery, BlogSearchBody, BlogSimilarQuery, type BoardAccessGrant, BoardApiError, type BoardApiErrorCode, type BoardAuthSession, BoardClient, BoardRequest, type BoardSdk, type BoardSitemapBucketSummary, type BoardSitemapIndex, type BoardUser, type BuiltInSignInMethod, type BulkMoveApplicantsBody, type BulkRejectApplicantsBody, type CandidateAvatar, type CandidateEducation, type CandidateExperience, type CandidateLanguage, type CandidateProfile, type CandidateSkill, type CategoryListQuery, type ClaimableCompany, CompaniesListQuery, CompaniesSearchBody, type CompanyBillingPortalBody, type CompanyBillingPortalSession, CompanyJobsListQuery, CompanyListEnvelope, CompanyMarketsListQuery, type CompanyMember, type CompanyMemberInvite, type CompanyMemberInviteAcceptance, type CompanyMemberInvitePreview, type CompanyMembership, CompanySimilarQuery, type ConfirmEmailChangeBody, type ConfirmWorkEmailBody, type ConsumeMagicLinkBody, type Conversation, type ConversationArchive, type ConversationDetail, type ConversationRef, type ConversationsListQuery, type ConvertSourcedCandidateBody, type CreateAlertBody, type CreateApplyApprovalBody, type CreateApplyIntentBody, type CreateBoardClientOptions, type CreateCompanyBody, type CreateCompanyMemberInviteBody, type CreateEducationBody, type CreateEmployerJobBody, type CreateExperienceBody, type CreateJobPostingInput, type CreatePipelineStageBody, type CreateTalentListBody, CustomFieldFilter, type EditMessageBody, type EmbedJobsQuery, type EmployerApplicant, type EmployerBillingOption, type EmployerCheckout, type EmployerCheckoutBody, type EmployerCompany, type EmployerCompanySearchQuery, type EmployerJob, type EmployerJobStat, type EmployerJobStatsPoint, type EmployerJobStatsTimeseriesQuery, type EmployerJobSummary, type EmployerJobsListQuery, type EmployerPipeline, type EmployerPipelineQuery, type EmployerPipelineStage, type EmployerProfileStats, type EmployerProfileViewsPoint, type EmployerProfileViewsTimeseriesQuery, EmploymentType, FetchOptions, type FindExistingConversationQuery, type ForgotPasswordBody, type HandleAvailability, type JobAlertConfirmation, type JobAlertDeletePreferenceInput, type JobAlertFiltersInput, type JobAlertFrequency, type JobAlertManageQuery, type JobAlertManageResult, type JobAlertManageState, type JobAlertManageTokenInput, type JobAlertPreference, type JobAlertRemoteOption, type JobAlertResendResult, type JobAlertStoredFilters, type JobAlertSubscribeInput, type JobAlertSubscription, type JobAlertUpdatePreferenceInput, JobCardListEnvelope, JobCardSearchEnvelope, JobCollectionChoiceQuery, type JobPostingBillingOptions, type JobPostingBillingVerification, type JobPostingLogoResult, type JobPostingPlan, type JobPostingResult, JobsListQuery, JobsSearchBody, JobsSimilarQuery, ListEnvelope, type LocationResolveInput, type LocationSearchQuery, Logger, type LoginBody, type LogoutBody, type MarketingConsent, type MembershipCheckoutBody, type MembershipCheckoutSession, type MembershipCheckoutSessionState, type Message, type ModerationReport, type MoveApplicantStageBody, type NotificationPreference, type OAuthAuthorizationQuery, type OAuthAuthorizationUrl, type OAuthCompletion, type OAuthExchangeBody, type OAuthProvider, ObjectReferenceFilter, type Paginator, type PaywallOffer, type PaywallOfferListEnvelope, type PlacesListQuery, type Plan, type PlanListEnvelope, type PlansListQuery, type PreviewCompanyMemberInviteBody, type ProfileChoiceList, type ProfileChoiceQuery, type ProfileFieldEntity, type ProfileFieldValues, type ProfileObjectReferenceSelectionWrite, type ProfileObjectReferences, type PublicLocation, type PublicPlace, type PublicProfileFields, type PublicTaxonomyTerm, type ReadReceipt, type RecommendedJob, type RecommendedJobsListQuery, type RecommendedTalent, type RecommendedTalentListQuery, type RedirectResolution, type RefreshBody, type RegisterBody, RemoteOption, type RemotePermitTaxonomyEntry, type ReorderPipelineStagesBody, type ReplaceProfileObjectReferencesBody, type ReplyBody, type ReportBody, type RequestEmailChangeBody, type RequestMagicLinkBody, type ResetPasswordBody, type Resume, type ResumeUploadOptions, SDK_VERSION, SIGN_IN_REDIRECT_ERROR_CODES, SSO_LINK_PROOF_BINDING_TTL_MS, SalaryDetailQuery, type SalesLedPlan, type SalesLedPlanListEnvelope, type SaveJobBody, type SavedJob, type SavedJobsListQuery, SearchEnvelope, SearchSuggestQuery, type SendWorkEmailBody, Seniority, type SignInRedirectErrorCode, type SignInRole, type SitemapEntriesEnvelope, type SitemapEntriesQuery, type SitemapEntry, type SourcedCandidate, type SsoAuthorizationQuery, type SsoAuthorizationUrl, type SsoLinkProofBindingStore, type SsoLinkProofBody, type StartAboutApplicationBody, type StartConversationBody, StorageMode, type TalentAccess, type TalentAccessCheckoutBody, type TalentAccessCheckoutSession, type TalentAccessCheckoutSessionState, type TalentAccessClaim, type TalentAccessClaimBody, type TalentAccessUpgrade, type TalentAccessUpgradeBody, type TalentCandidateAccess, type TalentDirectoryEntry, type TalentDirectoryListEnvelope, type TalentDirectoryQuery, type TalentList, type TalentListFilters, type TalentListMember, type TalentListMembersListEnvelope, type TalentListMembersQuery, type TalentListMembership, type TalentPlace, type TalentPlacesListEnvelope, type TalentPlacesQuery, type TalentProfile, type TalentUnlock, type TalentUnlockBody, type TaxonomyGeo, type TaxonomyListQuery, type TaxonomyResolution, type ThreadMessagesQuery, type UnreadCount, type UnsubscribeBody, type UpdateApplicationFactsBody, type UpdateCandidateProfileBody, type UpdateCompanyMemberRoleBody, type UpdateEducationBody, type UpdateEmployerCompanyBody, type UpdateEmployerJobBody, type UpdateExperienceBody, type UpdateLanguagesBody, type UpdateNotificationPreferenceBody, type UpdatePasswordBody, type UpdatePipelineStageBody, type UpdateProfileFieldValuesBody, type UpdateSkillsBody, type UpdateTalentListBody, type VerifyEmailBody, createBoardClient, isBoardApiError, isBoardPasswordRequired, isColdRule, isConflict, isForbidden, isFreeEmailWebsiteError, isNotFound, isOwnMessage, isRateLimited, isSafeApplicationUrl, isSignInMethodUnavailable, isSsoBrowserMismatch, isSsoRequired, isUnauthorized, isValidationError, lastOwnMessageId, paginate, parseOAuthCompletion, resolveApplyAction, resolveApplyDecision, ssoLinkProofBindingStore };
+export { type AcceptCompanyMemberInviteBody, type AccessCheckoutBody, type AccessCheckoutSession, type AccessCheckoutSessionState, type AccessGrant, type AccessPortalBody, type AccessPortalSession, type AddApplicantNoteBody, type AddSourcedCandidateBody, type AddTalentListMemberBody, type Alert, type AlertBody, type Application, type ApplicationsListQuery, type ApplyAction, type ApplyApprovalPlan, type ApplyApprovalReceipt, type ApplyBody, type ApplyDecisionState, type ApplyIntent, type AudienceAttribution, type AvailableSignInMethods, Awaitable, BOARD_API_ERROR_CODES, type BindingStorage, type Block, type BlockStatus, type BlockUserBody, type BlockedUser, BlogPostsListQuery, BlogSearchBody, BlogSimilarQuery, type BoardAccessGrant, BoardApiError, type BoardApiErrorCode, type BoardAuthSession, BoardClient, BoardRequest, type BoardSdk, type BoardSitemapBucketSummary, type BoardSitemapIndex, type BoardUser, type BuiltInSignInMethod, type BulkMoveApplicantsBody, type BulkRejectApplicantsBody, type CandidateAvatar, type CandidateEducation, type CandidateExperience, type CandidateLanguage, type CandidateProfile, type CandidateSkill, type CategoryListQuery, type ClaimableCompany, CompaniesListQuery, CompaniesSearchBody, type CompanyBillingPortalBody, type CompanyBillingPortalSession, CompanyJobsListQuery, CompanyListEnvelope, CompanyMarketsListQuery, type CompanyMember, type CompanyMemberInvite, type CompanyMemberInviteAcceptance, type CompanyMemberInvitePreview, type CompanyMembership, CompanySimilarQuery, type ConfirmEmailChangeBody, type ConfirmWorkEmailBody, type ConsumeMagicLinkBody, type Conversation, type ConversationArchive, type ConversationDetail, type ConversationRef, type ConversationsListQuery, type ConvertSourcedCandidateBody, type CreateAlertBody, type CreateApplyApprovalBody, type CreateApplyIntentBody, type CreateBoardClientOptions, type CreateCompanyBody, type CreateCompanyMemberInviteBody, type CreateEducationBody, type CreateEmployerJobBody, type CreateExperienceBody, type CreateJobPostingInput, type CreatePipelineStageBody, type CreateTalentListBody, CustomFieldFilter, type EditMessageBody, type EmbedJobsQuery, type EmployerApplicant, type EmployerBillingOption, type EmployerCheckout, type EmployerCheckoutBody, type EmployerCompany, type EmployerCompanySearchQuery, type EmployerJob, type EmployerJobStat, type EmployerJobStatsPoint, type EmployerJobStatsTimeseriesQuery, type EmployerJobSummary, type EmployerJobsListQuery, type EmployerPipeline, type EmployerPipelineQuery, type EmployerPipelineStage, type EmployerProfileStats, type EmployerProfileViewsPoint, type EmployerProfileViewsTimeseriesQuery, EmploymentType, FetchOptions, type FindExistingConversationQuery, type ForgotPasswordBody, type HandleAvailability, type JobAlertAnchorJob, type JobAlertConfirmation, type JobAlertDeletePreferenceInput, type JobAlertFiltersInput, type JobAlertFrequency, type JobAlertKind, type JobAlertManageQuery, type JobAlertManageResult, type JobAlertManageState, type JobAlertManageTokenInput, type JobAlertPreference, type JobAlertRemoteOption, type JobAlertResendResult, type JobAlertStoredFilters, type JobAlertSubscribeInput, type JobAlertSubscription, type JobAlertUpdatePreferenceInput, JobCardListEnvelope, JobCardSearchEnvelope, JobCollectionChoiceQuery, type JobPostingBillingOptions, type JobPostingBillingVerification, type JobPostingLogoResult, type JobPostingPlan, type JobPostingResult, JobRetrieveQuery, JobsListQuery, JobsSearchBody, JobsSimilarQuery, ListEnvelope, type LocationResolveInput, type LocationSearchQuery, Logger, type LoginBody, type LogoutBody, type MarketingConsent, type MembershipCheckoutBody, type MembershipCheckoutSession, type MembershipCheckoutSessionState, type Message, type ModerationReport, type MoveApplicantStageBody, type NotificationPreference, type OAuthAuthorizationQuery, type OAuthAuthorizationUrl, type OAuthCompletion, type OAuthExchangeBody, type OAuthProvider, ObjectReferenceFilter, type Paginator, type PaywallOffer, type PaywallOfferListEnvelope, type PlacesListQuery, type Plan, type PlanListEnvelope, type PlansListQuery, type PreviewCompanyMemberInviteBody, type ProfileChoiceList, type ProfileChoiceQuery, type ProfileFieldEntity, type ProfileFieldValues, type ProfileObjectReferenceSelectionWrite, type ProfileObjectReferences, type PublicLocation, type PublicPlace, type PublicProfileFields, type PublicTaxonomyTerm, type ReadReceipt, type RecommendedJob, type RecommendedJobsListQuery, type RecommendedTalent, type RecommendedTalentListQuery, type RedirectResolution, type RefreshBody, type RegisterBody, RemoteOption, type RemotePermitTaxonomyEntry, type ReorderPipelineStagesBody, type ReplaceProfileObjectReferencesBody, type ReplyBody, type ReportBody, type RequestEmailChangeBody, type RequestMagicLinkBody, type ResetPasswordBody, type Resume, type ResumeUploadOptions, SDK_VERSION, SIGN_IN_REDIRECT_ERROR_CODES, SSO_LINK_PROOF_BINDING_TTL_MS, SalaryDetailQuery, type SalesLedPlan, type SalesLedPlanListEnvelope, type SaveJobBody, type SavedJob, type SavedJobsListQuery, SearchEnvelope, SearchSuggestQuery, type SendWorkEmailBody, Seniority, type SignInRedirectErrorCode, type SignInRole, type SitemapEntriesEnvelope, type SitemapEntriesQuery, type SitemapEntry, type SourcedCandidate, type SsoAuthorizationQuery, type SsoAuthorizationUrl, type SsoLinkProofBindingStore, type SsoLinkProofBody, type StartAboutApplicationBody, type StartConversationBody, StorageMode, type TalentAccess, type TalentAccessCheckoutBody, type TalentAccessCheckoutSession, type TalentAccessCheckoutSessionState, type TalentAccessClaim, type TalentAccessClaimBody, type TalentAccessUpgrade, type TalentAccessUpgradeBody, type TalentCandidateAccess, type TalentDirectoryEntry, type TalentDirectoryListEnvelope, type TalentDirectoryQuery, type TalentList, type TalentListFilters, type TalentListMember, type TalentListMembersListEnvelope, type TalentListMembersQuery, type TalentListMembership, type TalentPlace, type TalentPlacesListEnvelope, type TalentPlacesQuery, type TalentProfile, type TalentUnlock, type TalentUnlockBody, type TaxonomyGeo, type TaxonomyListQuery, type TaxonomyResolution, type ThreadMessagesQuery, type UnreadCount, type UnsubscribeBody, type UpdateApplicationFactsBody, type UpdateCandidateProfileBody, type UpdateCompanyMemberRoleBody, type UpdateEducationBody, type UpdateEmployerCompanyBody, type UpdateEmployerJobBody, type UpdateExperienceBody, type UpdateLanguagesBody, type UpdateNotificationPreferenceBody, type UpdatePasswordBody, type UpdatePipelineStageBody, type UpdateProfileFieldValuesBody, type UpdateSkillsBody, type UpdateTalentListBody, type VerifyEmailBody, createBoardClient, isBoardApiError, isBoardPasswordRequired, isColdRule, isConflict, isForbidden, isFreeEmailWebsiteError, isNotFound, isOwnMessage, isRateLimited, isSafeApplicationUrl, isSignInMethodUnavailable, isSsoBrowserMismatch, isSsoRequired, isUnauthorized, isValidationError, lastOwnMessageId, paginate, parseOAuthCompletion, resolveApplyAction, resolveApplyDecision, ssoLinkProofBindingStore };

package/dist/index.d.ts

@@ -1,13 +1,13 @@
-import { S as Schemas, c as components } from './_spec-DHa5r3B0.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-666oDd7H.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-666oDd7H.js';
-import { L as ListEnvelope, R as RemoteOption, E as EmploymentType, S as Seniority, a as CustomFieldFilter, O as ObjectReferenceFilter, b as JobCollectionChoiceQuery, c as JobsListQuery, d as JobCardListEnvelope, e as JobsSearchBody, f as JobCardSearchEnvelope, g as JobsSimilarQuery, h as SearchEnvelope } from './jobs-CIrTcMjw.js';
-export { i as CustomFieldValue, C as CustomFieldValues, j as CustomFilterValue, k as EducationRequirement, l as JobCatalogPagination, m as JobCollectionChoiceList, n as JobCollectionFieldDefinition, o as JobCompany, p as JobCustomEmploymentType, J as JobSort, q as OfficeLocation, r as OffsetPagination, P as PublicJob, s as PublicJobCard, t as RelatedSearch, u as RemotePermit, v as RemoteTimezone, w as ResolvedJobCollectionField, x as StorefrontPagination } from './jobs-CIrTcMjw.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-DHsd92Gy.js';
-export { B as BoardCustomEmploymentType, j as BoardFormBuiltinField, k as BoardFormField, l as BoardFormLayout, m as BoardFormLockReason, n as BoardJobFormField, o as BoardProfileFormField, p as BoardRoleSignIn, q as BoardSignInSsoConnection, a as CompanyCategorySalary, r as CompanyMarket, s as CompanyMarketRef, b as CompanySalary, t as CompanySalarySummary, C as CustomFieldDefinition, u as CustomFieldOption, v as CustomFieldType, L as LocationSalaryDetail, w as LocationSkillsIndex, x as LocationTitlesIndex, P as PublicBoard, y as PublicBoardAds, z as PublicBoardAnalytics, A as PublicBoardFeatures, D as PublicBoardJobForm, E as PublicBoardSignIn, F as PublicCompany, G as PublicCompanyDetail, H as PublicCompanyMembership, I as SalaryCompany, J as SalaryLocation, K as SalarySkill, M as SalaryTitle, N as SkillLocationSalary, O as SkillLocationsIndex, S as SkillSalaryDetail, Q as TitleLocationSalary, R as TitleLocationsIndex, T as TitleSalaryDetail } from './board-DHsd92Gy.js';
-export { B as BoardSeo } from './seo-ynqiQmby.js';
-import { a as BlogPostsListQuery, b as BlogSimilarQuery, c as BlogSearchBody } from './blog-wxhB8zAH.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-wxhB8zAH.js';
+import { S as Schemas, c as components } from './_spec-DiQvT7IN.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-C3DpF31i.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-C3DpF31i.js';
+import { L as ListEnvelope, R as RemoteOption, E as EmploymentType, S as Seniority, a as CustomFieldFilter, O as ObjectReferenceFilter, b as JobCollectionChoiceQuery, c as JobsListQuery, d as JobCardListEnvelope, e as JobRetrieveQuery, f as JobsSearchBody, g as JobCardSearchEnvelope, h as JobsSimilarQuery, i as SearchEnvelope } from './jobs-DQZEGLIC.js';
+export { j as CustomFieldValue, C as CustomFieldValues, k as CustomFilterValue, l as EducationRequirement, m as JobCapability, n as JobCatalogPagination, o as JobCollectionChoiceList, p as JobCollectionFieldDefinition, q as JobCompany, r as JobCustomEmploymentType, J as JobSort, s as OfficeLocation, t as OffsetPagination, P as PublicJob, u as PublicJobCard, v as RelatedSearch, w as RemotePermit, x as RemoteTimezone, y as ResolvedJobCollectionField, z as StorefrontPagination } from './jobs-DQZEGLIC.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-BNJ5Bsx2.js';
+export { B as BoardCustomEmploymentType, j as BoardFormBuiltinField, k as BoardFormField, l as BoardFormLayout, m as BoardFormLockReason, n as BoardJobFormField, o as BoardProfileFormField, p as BoardRoleSignIn, q as BoardSignInSsoConnection, a as CompanyCategorySalary, r as CompanyMarket, s as CompanyMarketRef, b as CompanySalary, t as CompanySalarySummary, C as CustomFieldDefinition, u as CustomFieldOption, v as CustomFieldType, L as LocationSalaryDetail, w as LocationSkillsIndex, x as LocationTitlesIndex, P as PublicBoard, y as PublicBoardAds, z as PublicBoardAnalytics, A as PublicBoardFeatures, D as PublicBoardJobForm, E as PublicBoardSignIn, F as PublicCompany, G as PublicCompanyDetail, H as PublicCompanyMembership, I as SalaryCompany, J as SalaryLocation, K as SalarySkill, M as SalaryTitle, N as SkillLocationSalary, O as SkillLocationsIndex, S as SkillSalaryDetail, Q as TitleLocationSalary, R as TitleLocationsIndex, T as TitleSalaryDetail } from './board-BNJ5Bsx2.js';
+export { B as BoardSeo } from './seo-BOPoZApt.js';
+import { a as BlogPostsListQuery, b as BlogSimilarQuery, c as BlogSearchBody } from './blog-BqUwoJRF.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-BqUwoJRF.js';
 
 /**
  * Well-known `<domain>_<snake_reason>` codes the Board API sends, grouped by
@@ -202,7 +202,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.47.0";
+declare const SDK_VERSION = "4.49.0";
 
 type SavedJob = Schemas['SavedJob'];
 type SavedJobsListQuery = {
@@ -980,7 +980,13 @@ interface ApplyApprovalReceipt {
  * candidate scoped it to employers only.
  */
 type TalentProfile = Schemas['TalentProfile'];
-/** A candidate card in the public talent directory. */
+/**
+ * A candidate card in the public talent directory. On cards and profiles,
+ * `lastActive` is a coarse bucket (`today`, `this_week`, `this_month`,
+ * `last_3_months`, `over_3_months`) returned only to a signed-in employer on
+ * the board, for candidates who are actively looking or open to offers;
+ * `null` for everyone else.
+ */
 type TalentDirectoryEntry = Schemas['TalentDirectoryEntry'];
 type TalentDirectoryQuery = {
     cursor?: string;
@@ -1088,6 +1094,13 @@ type JobAlertRemoteOption = 'on_site' | 'hybrid' | 'remote';
  * `seniorityLevels`/`salary*` are stored but do not filter delivery.
  */
 type JobAlertFiltersInput = {
+    /**
+     * Free-text search keywords (at most 200 characters after trimming). Send
+     * the query a search page ran. On `updatePreference`, `null` clears the
+     * keywords and omitting `query` keeps them while `jobFunctions` are
+     * unchanged. Not accepted on a job-page (similar-job) alert.
+     */
+    query?: string | null;
     jobFunctions?: string[];
     seniorityLevels?: string[];
     remoteOptions?: JobAlertRemoteOption[];
@@ -1119,6 +1132,14 @@ type JobAlertManageState = Schemas['PublicJobAlertManageState'];
 type JobAlertPreference = JobAlertManageState['preferences'][number];
 /** The stored filter criteria surfaced on a manage-page preference. */
 type JobAlertStoredFilters = JobAlertPreference['filters'];
+/**
+ * How an alert's digest is filled: `similar_job` (jobs like the job it was
+ * subscribed from), `search` (a board search for its keywords) or `filters`
+ * (jobs matching its stored filters exactly). Read-only.
+ */
+type JobAlertKind = JobAlertPreference['kind'];
+/** A similar-job alert's anchor job (`{ id, slug, title }`), or `null`. */
+type JobAlertAnchorJob = JobAlertPreference['anchorJob'];
 /** Query for `jobAlerts.manage` — the HMAC manage token from the digest email. */
 type JobAlertManageQuery = {
     subscription: string;
@@ -1441,7 +1462,7 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
             nextCursor: string | null;
         }>;
         list(query?: JobsListQuery, options?: FetchOptions): Promise<JobCardListEnvelope>;
-        retrieve(jobSlug: string, query?: Record<string, never>, options?: FetchOptions): Promise<{
+        retrieve(jobSlug: string, query?: JobRetrieveQuery, options?: FetchOptions): Promise<{
             id: string;
             object: "public_job";
             title: string;
@@ -1501,6 +1522,7 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
             placeHierarchy: {
                 slug: string;
                 name: string;
+                canonicalSlug: string;
             }[];
             customFieldValues: {
                 [key: string]: string | string[] | boolean | number;
@@ -3040,7 +3062,14 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
                 label: string | null;
                 frequency: "weekly";
                 isActive: boolean;
+                kind: "similar_job" | "search" | "filters";
+                anchorJob: {
+                    id: string;
+                    slug: string | null;
+                    title: string;
+                } | null;
                 filters: {
+                    query: string | null;
                     jobFunctions: string[];
                     seniorityLevels: string[];
                     remoteOptions: string[];
@@ -3057,7 +3086,14 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
                 label: string | null;
                 frequency: "weekly";
                 isActive: boolean;
+                kind: "similar_job" | "search" | "filters";
+                anchorJob: {
+                    id: string;
+                    slug: string | null;
+                    title: string;
+                } | null;
                 filters: {
+                    query: string | null;
                     jobFunctions: string[];
                     seniorityLevels: string[];
                     remoteOptions: string[];
@@ -3074,7 +3110,14 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
                 label: string | null;
                 frequency: "weekly";
                 isActive: boolean;
+                kind: "similar_job" | "search" | "filters";
+                anchorJob: {
+                    id: string;
+                    slug: string | null;
+                    title: string;
+                } | null;
                 filters: {
+                    query: string | null;
                     jobFunctions: string[];
                     seniorityLevels: string[];
                     remoteOptions: string[];
@@ -3091,7 +3134,14 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
                 label: string | null;
                 frequency: "weekly";
                 isActive: boolean;
+                kind: "similar_job" | "search" | "filters";
+                anchorJob: {
+                    id: string;
+                    slug: string | null;
+                    title: string;
+                } | null;
                 filters: {
+                    query: string | null;
                     jobFunctions: string[];
                     seniorityLevels: string[];
                     remoteOptions: string[];
@@ -3582,7 +3632,14 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
                 label: string | null;
                 frequency: "weekly";
                 isActive: boolean;
+                kind: "similar_job" | "search" | "filters";
+                anchorJob: {
+                    id: string;
+                    slug: string | null;
+                    title: string;
+                } | null;
                 filters: {
+                    query?: string;
                     jobFunctions?: string[];
                     seniorityLevels?: string[];
                     remoteOptions?: string[];
@@ -4025,6 +4082,7 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
                 avgSalaryMin: number;
                 avgSalaryMax: number;
                 jobCount: number;
+                currency?: string;
             }>>;
             retrieve(locationSlug: string, query?: SalaryDetailQuery, options?: FetchOptions): Promise<{
                 object: "location_salary_detail";
@@ -4118,6 +4176,7 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
                     avgSalaryMin: number;
                     avgSalaryMax: number;
                     jobCount: number;
+                    currency?: string;
                 }[];
             }>;
             skills(locationSlug: string, query?: SalaryDetailQuery, options?: FetchOptions): Promise<{
@@ -4131,6 +4190,7 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
                     avgSalaryMin: number;
                     avgSalaryMax: number;
                     jobCount: number;
+                    currency?: string;
                 }[];
             }>;
         };
@@ -4185,6 +4245,7 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
                 [key: string]: string | number | boolean | string[];
             };
             objectReferences: components["schemas"]["ResolvedProfileObjectReference"][];
+            lastActive: "today" | "this_week" | "this_month" | "last_3_months" | "over_3_months" | null;
         }>;
         places: {
             list(query?: TalentPlacesQuery, options?: FetchOptions): Promise<TalentPlacesListEnvelope>;
@@ -4221,4 +4282,4 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
 };
 type BoardSdk = ReturnType<typeof createBoardClient>;
 
-export { type AcceptCompanyMemberInviteBody, type AccessCheckoutBody, type AccessCheckoutSession, type AccessCheckoutSessionState, type AccessGrant, type AccessPortalBody, type AccessPortalSession, type AddApplicantNoteBody, type AddSourcedCandidateBody, type AddTalentListMemberBody, type Alert, type AlertBody, type Application, type ApplicationsListQuery, type ApplyAction, type ApplyApprovalPlan, type ApplyApprovalReceipt, type ApplyBody, type ApplyDecisionState, type ApplyIntent, type AudienceAttribution, type AvailableSignInMethods, Awaitable, BOARD_API_ERROR_CODES, type BindingStorage, type Block, type BlockStatus, type BlockUserBody, type BlockedUser, BlogPostsListQuery, BlogSearchBody, BlogSimilarQuery, type BoardAccessGrant, BoardApiError, type BoardApiErrorCode, type BoardAuthSession, BoardClient, BoardRequest, type BoardSdk, type BoardSitemapBucketSummary, type BoardSitemapIndex, type BoardUser, type BuiltInSignInMethod, type BulkMoveApplicantsBody, type BulkRejectApplicantsBody, type CandidateAvatar, type CandidateEducation, type CandidateExperience, type CandidateLanguage, type CandidateProfile, type CandidateSkill, type CategoryListQuery, type ClaimableCompany, CompaniesListQuery, CompaniesSearchBody, type CompanyBillingPortalBody, type CompanyBillingPortalSession, CompanyJobsListQuery, CompanyListEnvelope, CompanyMarketsListQuery, type CompanyMember, type CompanyMemberInvite, type CompanyMemberInviteAcceptance, type CompanyMemberInvitePreview, type CompanyMembership, CompanySimilarQuery, type ConfirmEmailChangeBody, type ConfirmWorkEmailBody, type ConsumeMagicLinkBody, type Conversation, type ConversationArchive, type ConversationDetail, type ConversationRef, type ConversationsListQuery, type ConvertSourcedCandidateBody, type CreateAlertBody, type CreateApplyApprovalBody, type CreateApplyIntentBody, type CreateBoardClientOptions, type CreateCompanyBody, type CreateCompanyMemberInviteBody, type CreateEducationBody, type CreateEmployerJobBody, type CreateExperienceBody, type CreateJobPostingInput, type CreatePipelineStageBody, type CreateTalentListBody, CustomFieldFilter, type EditMessageBody, type EmbedJobsQuery, type EmployerApplicant, type EmployerBillingOption, type EmployerCheckout, type EmployerCheckoutBody, type EmployerCompany, type EmployerCompanySearchQuery, type EmployerJob, type EmployerJobStat, type EmployerJobStatsPoint, type EmployerJobStatsTimeseriesQuery, type EmployerJobSummary, type EmployerJobsListQuery, type EmployerPipeline, type EmployerPipelineQuery, type EmployerPipelineStage, type EmployerProfileStats, type EmployerProfileViewsPoint, type EmployerProfileViewsTimeseriesQuery, EmploymentType, FetchOptions, type FindExistingConversationQuery, type ForgotPasswordBody, type HandleAvailability, type JobAlertConfirmation, type JobAlertDeletePreferenceInput, type JobAlertFiltersInput, type JobAlertFrequency, type JobAlertManageQuery, type JobAlertManageResult, type JobAlertManageState, type JobAlertManageTokenInput, type JobAlertPreference, type JobAlertRemoteOption, type JobAlertResendResult, type JobAlertStoredFilters, type JobAlertSubscribeInput, type JobAlertSubscription, type JobAlertUpdatePreferenceInput, JobCardListEnvelope, JobCardSearchEnvelope, JobCollectionChoiceQuery, type JobPostingBillingOptions, type JobPostingBillingVerification, type JobPostingLogoResult, type JobPostingPlan, type JobPostingResult, JobsListQuery, JobsSearchBody, JobsSimilarQuery, ListEnvelope, type LocationResolveInput, type LocationSearchQuery, Logger, type LoginBody, type LogoutBody, type MarketingConsent, type MembershipCheckoutBody, type MembershipCheckoutSession, type MembershipCheckoutSessionState, type Message, type ModerationReport, type MoveApplicantStageBody, type NotificationPreference, type OAuthAuthorizationQuery, type OAuthAuthorizationUrl, type OAuthCompletion, type OAuthExchangeBody, type OAuthProvider, ObjectReferenceFilter, type Paginator, type PaywallOffer, type PaywallOfferListEnvelope, type PlacesListQuery, type Plan, type PlanListEnvelope, type PlansListQuery, type PreviewCompanyMemberInviteBody, type ProfileChoiceList, type ProfileChoiceQuery, type ProfileFieldEntity, type ProfileFieldValues, type ProfileObjectReferenceSelectionWrite, type ProfileObjectReferences, type PublicLocation, type PublicPlace, type PublicProfileFields, type PublicTaxonomyTerm, type ReadReceipt, type RecommendedJob, type RecommendedJobsListQuery, type RecommendedTalent, type RecommendedTalentListQuery, type RedirectResolution, type RefreshBody, type RegisterBody, RemoteOption, type RemotePermitTaxonomyEntry, type ReorderPipelineStagesBody, type ReplaceProfileObjectReferencesBody, type ReplyBody, type ReportBody, type RequestEmailChangeBody, type RequestMagicLinkBody, type ResetPasswordBody, type Resume, type ResumeUploadOptions, SDK_VERSION, SIGN_IN_REDIRECT_ERROR_CODES, SSO_LINK_PROOF_BINDING_TTL_MS, SalaryDetailQuery, type SalesLedPlan, type SalesLedPlanListEnvelope, type SaveJobBody, type SavedJob, type SavedJobsListQuery, SearchEnvelope, SearchSuggestQuery, type SendWorkEmailBody, Seniority, type SignInRedirectErrorCode, type SignInRole, type SitemapEntriesEnvelope, type SitemapEntriesQuery, type SitemapEntry, type SourcedCandidate, type SsoAuthorizationQuery, type SsoAuthorizationUrl, type SsoLinkProofBindingStore, type SsoLinkProofBody, type StartAboutApplicationBody, type StartConversationBody, StorageMode, type TalentAccess, type TalentAccessCheckoutBody, type TalentAccessCheckoutSession, type TalentAccessCheckoutSessionState, type TalentAccessClaim, type TalentAccessClaimBody, type TalentAccessUpgrade, type TalentAccessUpgradeBody, type TalentCandidateAccess, type TalentDirectoryEntry, type TalentDirectoryListEnvelope, type TalentDirectoryQuery, type TalentList, type TalentListFilters, type TalentListMember, type TalentListMembersListEnvelope, type TalentListMembersQuery, type TalentListMembership, type TalentPlace, type TalentPlacesListEnvelope, type TalentPlacesQuery, type TalentProfile, type TalentUnlock, type TalentUnlockBody, type TaxonomyGeo, type TaxonomyListQuery, type TaxonomyResolution, type ThreadMessagesQuery, type UnreadCount, type UnsubscribeBody, type UpdateApplicationFactsBody, type UpdateCandidateProfileBody, type UpdateCompanyMemberRoleBody, type UpdateEducationBody, type UpdateEmployerCompanyBody, type UpdateEmployerJobBody, type UpdateExperienceBody, type UpdateLanguagesBody, type UpdateNotificationPreferenceBody, type UpdatePasswordBody, type UpdatePipelineStageBody, type UpdateProfileFieldValuesBody, type UpdateSkillsBody, type UpdateTalentListBody, type VerifyEmailBody, createBoardClient, isBoardApiError, isBoardPasswordRequired, isColdRule, isConflict, isForbidden, isFreeEmailWebsiteError, isNotFound, isOwnMessage, isRateLimited, isSafeApplicationUrl, isSignInMethodUnavailable, isSsoBrowserMismatch, isSsoRequired, isUnauthorized, isValidationError, lastOwnMessageId, paginate, parseOAuthCompletion, resolveApplyAction, resolveApplyDecision, ssoLinkProofBindingStore };
+export { type AcceptCompanyMemberInviteBody, type AccessCheckoutBody, type AccessCheckoutSession, type AccessCheckoutSessionState, type AccessGrant, type AccessPortalBody, type AccessPortalSession, type AddApplicantNoteBody, type AddSourcedCandidateBody, type AddTalentListMemberBody, type Alert, type AlertBody, type Application, type ApplicationsListQuery, type ApplyAction, type ApplyApprovalPlan, type ApplyApprovalReceipt, type ApplyBody, type ApplyDecisionState, type ApplyIntent, type AudienceAttribution, type AvailableSignInMethods, Awaitable, BOARD_API_ERROR_CODES, type BindingStorage, type Block, type BlockStatus, type BlockUserBody, type BlockedUser, BlogPostsListQuery, BlogSearchBody, BlogSimilarQuery, type BoardAccessGrant, BoardApiError, type BoardApiErrorCode, type BoardAuthSession, BoardClient, BoardRequest, type BoardSdk, type BoardSitemapBucketSummary, type BoardSitemapIndex, type BoardUser, type BuiltInSignInMethod, type BulkMoveApplicantsBody, type BulkRejectApplicantsBody, type CandidateAvatar, type CandidateEducation, type CandidateExperience, type CandidateLanguage, type CandidateProfile, type CandidateSkill, type CategoryListQuery, type ClaimableCompany, CompaniesListQuery, CompaniesSearchBody, type CompanyBillingPortalBody, type CompanyBillingPortalSession, CompanyJobsListQuery, CompanyListEnvelope, CompanyMarketsListQuery, type CompanyMember, type CompanyMemberInvite, type CompanyMemberInviteAcceptance, type CompanyMemberInvitePreview, type CompanyMembership, CompanySimilarQuery, type ConfirmEmailChangeBody, type ConfirmWorkEmailBody, type ConsumeMagicLinkBody, type Conversation, type ConversationArchive, type ConversationDetail, type ConversationRef, type ConversationsListQuery, type ConvertSourcedCandidateBody, type CreateAlertBody, type CreateApplyApprovalBody, type CreateApplyIntentBody, type CreateBoardClientOptions, type CreateCompanyBody, type CreateCompanyMemberInviteBody, type CreateEducationBody, type CreateEmployerJobBody, type CreateExperienceBody, type CreateJobPostingInput, type CreatePipelineStageBody, type CreateTalentListBody, CustomFieldFilter, type EditMessageBody, type EmbedJobsQuery, type EmployerApplicant, type EmployerBillingOption, type EmployerCheckout, type EmployerCheckoutBody, type EmployerCompany, type EmployerCompanySearchQuery, type EmployerJob, type EmployerJobStat, type EmployerJobStatsPoint, type EmployerJobStatsTimeseriesQuery, type EmployerJobSummary, type EmployerJobsListQuery, type EmployerPipeline, type EmployerPipelineQuery, type EmployerPipelineStage, type EmployerProfileStats, type EmployerProfileViewsPoint, type EmployerProfileViewsTimeseriesQuery, EmploymentType, FetchOptions, type FindExistingConversationQuery, type ForgotPasswordBody, type HandleAvailability, type JobAlertAnchorJob, type JobAlertConfirmation, type JobAlertDeletePreferenceInput, type JobAlertFiltersInput, type JobAlertFrequency, type JobAlertKind, type JobAlertManageQuery, type JobAlertManageResult, type JobAlertManageState, type JobAlertManageTokenInput, type JobAlertPreference, type JobAlertRemoteOption, type JobAlertResendResult, type JobAlertStoredFilters, type JobAlertSubscribeInput, type JobAlertSubscription, type JobAlertUpdatePreferenceInput, JobCardListEnvelope, JobCardSearchEnvelope, JobCollectionChoiceQuery, type JobPostingBillingOptions, type JobPostingBillingVerification, type JobPostingLogoResult, type JobPostingPlan, type JobPostingResult, JobRetrieveQuery, JobsListQuery, JobsSearchBody, JobsSimilarQuery, ListEnvelope, type LocationResolveInput, type LocationSearchQuery, Logger, type LoginBody, type LogoutBody, type MarketingConsent, type MembershipCheckoutBody, type MembershipCheckoutSession, type MembershipCheckoutSessionState, type Message, type ModerationReport, type MoveApplicantStageBody, type NotificationPreference, type OAuthAuthorizationQuery, type OAuthAuthorizationUrl, type OAuthCompletion, type OAuthExchangeBody, type OAuthProvider, ObjectReferenceFilter, type Paginator, type PaywallOffer, type PaywallOfferListEnvelope, type PlacesListQuery, type Plan, type PlanListEnvelope, type PlansListQuery, type PreviewCompanyMemberInviteBody, type ProfileChoiceList, type ProfileChoiceQuery, type ProfileFieldEntity, type ProfileFieldValues, type ProfileObjectReferenceSelectionWrite, type ProfileObjectReferences, type PublicLocation, type PublicPlace, type PublicProfileFields, type PublicTaxonomyTerm, type ReadReceipt, type RecommendedJob, type RecommendedJobsListQuery, type RecommendedTalent, type RecommendedTalentListQuery, type RedirectResolution, type RefreshBody, type RegisterBody, RemoteOption, type RemotePermitTaxonomyEntry, type ReorderPipelineStagesBody, type ReplaceProfileObjectReferencesBody, type ReplyBody, type ReportBody, type RequestEmailChangeBody, type RequestMagicLinkBody, type ResetPasswordBody, type Resume, type ResumeUploadOptions, SDK_VERSION, SIGN_IN_REDIRECT_ERROR_CODES, SSO_LINK_PROOF_BINDING_TTL_MS, SalaryDetailQuery, type SalesLedPlan, type SalesLedPlanListEnvelope, type SaveJobBody, type SavedJob, type SavedJobsListQuery, SearchEnvelope, SearchSuggestQuery, type SendWorkEmailBody, Seniority, type SignInRedirectErrorCode, type SignInRole, type SitemapEntriesEnvelope, type SitemapEntriesQuery, type SitemapEntry, type SourcedCandidate, type SsoAuthorizationQuery, type SsoAuthorizationUrl, type SsoLinkProofBindingStore, type SsoLinkProofBody, type StartAboutApplicationBody, type StartConversationBody, StorageMode, type TalentAccess, type TalentAccessCheckoutBody, type TalentAccessCheckoutSession, type TalentAccessCheckoutSessionState, type TalentAccessClaim, type TalentAccessClaimBody, type TalentAccessUpgrade, type TalentAccessUpgradeBody, type TalentCandidateAccess, type TalentDirectoryEntry, type TalentDirectoryListEnvelope, type TalentDirectoryQuery, type TalentList, type TalentListFilters, type TalentListMember, type TalentListMembersListEnvelope, type TalentListMembersQuery, type TalentListMembership, type TalentPlace, type TalentPlacesListEnvelope, type TalentPlacesQuery, type TalentProfile, type TalentUnlock, type TalentUnlockBody, type TaxonomyGeo, type TaxonomyListQuery, type TaxonomyResolution, type ThreadMessagesQuery, type UnreadCount, type UnsubscribeBody, type UpdateApplicationFactsBody, type UpdateCandidateProfileBody, type UpdateCompanyMemberRoleBody, type UpdateEducationBody, type UpdateEmployerCompanyBody, type UpdateEmployerJobBody, type UpdateExperienceBody, type UpdateLanguagesBody, type UpdateNotificationPreferenceBody, type UpdatePasswordBody, type UpdatePipelineStageBody, type UpdateProfileFieldValuesBody, type UpdateSkillsBody, type UpdateTalentListBody, type VerifyEmailBody, createBoardClient, isBoardApiError, isBoardPasswordRequired, isColdRule, isConflict, isForbidden, isFreeEmailWebsiteError, isNotFound, isOwnMessage, isRateLimited, isSafeApplicationUrl, isSignInMethodUnavailable, isSsoBrowserMismatch, isSsoRequired, isUnauthorized, isValidationError, lastOwnMessageId, paginate, parseOAuthCompletion, resolveApplyAction, resolveApplyDecision, ssoLinkProofBindingStore };

package/dist/index.js

@@ -405,7 +405,7 @@ async function clearSession(storage) {
 }
 
 // src/version.ts
-var SDK_VERSION = "4.47.0";
+var SDK_VERSION = "4.49.0";
 
 // src/client.ts
 function isRawBody(body) {
@@ -1377,6 +1377,11 @@ function jobsNamespace(client) {
      *
      * @example
      * const { data, nextCursor } = await board.jobs.list({ limit: 20 });
+     * // A location page: nearby jobs at the market default distance.
+     * const nearby = await board.jobs.list({
+     *   location: 'houston-texas-united-states',
+     *   defaultRadius: true,
+     * });
      */
     list(query, options) {
       return client.fetch("/jobs", {
@@ -1386,12 +1391,18 @@ function jobsNamespace(client) {
     },
     /**
      * Retrieve one published job by slug.
-     * Compatible starters pass `x-cavuno-board-capabilities:
-     * apply-gateway-v1` in `options.headers` to opt in to the country-gated
-     * Apply shape. The SDK never sends that capability globally.
+     * Compatible starters opt in to the country-gated Apply shape with
+     * `{ capabilities: ['apply-gateway-v1'] }`, which keeps the response
+     * shared-cacheable under its own URL. Passing
+     * `x-cavuno-board-capabilities: apply-gateway-v1` in `options.headers`
+     * still works but is never cached. The SDK never sends the capability
+     * globally.
      *
      * @example
      * const job = await board.jobs.retrieve('senior-chef');
+     * const gated = await board.jobs.retrieve('senior-chef', {
+     *   capabilities: ['apply-gateway-v1'],
+     * });
      */
     retrieve(jobSlug, query, options) {
       return client.fetch(`/jobs/${encodeURIComponent(jobSlug)}`, {

package/dist/index.mjs

@@ -46,7 +46,7 @@ function toSearchParams(query) {
 }
 
 // src/version.ts
-var SDK_VERSION = "4.47.0";
+var SDK_VERSION = "4.49.0";
 
 // src/client.ts
 function isRawBody(body) {
@@ -1018,6 +1018,11 @@ function jobsNamespace(client) {
      *
      * @example
      * const { data, nextCursor } = await board.jobs.list({ limit: 20 });
+     * // A location page: nearby jobs at the market default distance.
+     * const nearby = await board.jobs.list({
+     *   location: 'houston-texas-united-states',
+     *   defaultRadius: true,
+     * });
      */
     list(query, options) {
       return client.fetch("/jobs", {
@@ -1027,12 +1032,18 @@ function jobsNamespace(client) {
     },
     /**
      * Retrieve one published job by slug.
-     * Compatible starters pass `x-cavuno-board-capabilities:
-     * apply-gateway-v1` in `options.headers` to opt in to the country-gated
-     * Apply shape. The SDK never sends that capability globally.
+     * Compatible starters opt in to the country-gated Apply shape with
+     * `{ capabilities: ['apply-gateway-v1'] }`, which keeps the response
+     * shared-cacheable under its own URL. Passing
+     * `x-cavuno-board-capabilities: apply-gateway-v1` in `options.headers`
+     * still works but is never cached. The SDK never sends the capability
+     * globally.
      *
      * @example
      * const job = await board.jobs.retrieve('senior-chef');
+     * const gated = await board.jobs.retrieve('senior-chef', {
+     *   capabilities: ['apply-gateway-v1'],
+     * });
      */
     retrieve(jobSlug, query, options) {
       return client.fetch(`/jobs/${encodeURIComponent(jobSlug)}`, {

package/dist/{jobs-CMK-DZg3.d.mts → jobs-DQZEGLIC.d.ts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-DHa5r3B0.mjs';
+import { S as Schemas } from './_spec-DiQvT7IN.js';
 
 /**
  * Optional pagination metadata returned by Board API list operations.
@@ -114,6 +114,14 @@ type JobsListQuery = {
      * jobs in the place itself. Ignored for region and country places.
      */
     radius?: number;
+    /**
+     * With `location` and no `radius`: widen a city or locality to the market
+     * default distance (25 mi in the US, GB, LR and MM; 50 km elsewhere),
+     * computed from the resolved place. Regions and countries are not
+     * widened; an explicit `radius` wins. Saves resolving the place first to
+     * pick the radius.
+     */
+    defaultRadius?: boolean;
     /** Category slug seed (the `/jobs/[keyword]` page) — server resolves it to the English source name; unresolvable → 404. */
     category?: string;
     /** Skill slug seed (the `/jobs/skills/[skill]` page) — server-resolved; unresolvable → 404. */
@@ -121,6 +129,20 @@ type JobsListQuery = {
     /** Sparse fieldset (Medusa-style `+field`). Only `'+description'` is supported — adds `description` to each card. */
     fields?: string;
 };
+/**
+ * An opt-in capability token for `jobs.retrieve`. `apply-gateway-v1` selects
+ * the country-gated Apply shape (opaque Sponsored Apply).
+ */
+type JobCapability = 'apply-gateway-v1';
+type JobRetrieveQuery = {
+    /**
+     * Capability opt-ins, sent as the `capabilities` query parameter. Same
+     * effect as the `x-cavuno-board-capabilities` header, but the response
+     * stays shared-cacheable under its own URL; the header form is never
+     * cached.
+     */
+    capabilities?: JobCapability[];
+};
 type JobsSimilarQuery = {
     /** How many similar jobs to return (1–20; default 5). */
     limit?: number;
@@ -143,4 +165,4 @@ type ObjectReferenceFilter = {
  */
 type JobsSearchBody = Schemas['PublicSearchJobsBody'];
 
-export type { CustomFieldValues as C, EmploymentType as E, JobSort as J, ListEnvelope as L, ObjectReferenceFilter as O, PublicJob as P, RemoteOption as R, Seniority as S, CustomFieldFilter as a, JobCollectionChoiceQuery as b, JobsListQuery as c, JobCardListEnvelope as d, JobsSearchBody as e, JobCardSearchEnvelope as f, JobsSimilarQuery as g, SearchEnvelope as h, CustomFieldValue as i, CustomFilterValue as j, EducationRequirement as k, JobCatalogPagination as l, JobCollectionChoiceList as m, JobCollectionFieldDefinition as n, JobCompany as o, JobCustomEmploymentType as p, OfficeLocation as q, OffsetPagination as r, PublicJobCard as s, RelatedSearch as t, RemotePermit as u, RemoteTimezone as v, ResolvedJobCollectionField as w, StorefrontPagination as x };
+export type { CustomFieldValues as C, EmploymentType as E, JobSort as J, ListEnvelope as L, ObjectReferenceFilter as O, PublicJob as P, RemoteOption as R, Seniority as S, CustomFieldFilter as a, JobCollectionChoiceQuery as b, JobsListQuery as c, JobCardListEnvelope as d, JobRetrieveQuery as e, JobsSearchBody as f, JobCardSearchEnvelope as g, JobsSimilarQuery as h, SearchEnvelope as i, CustomFieldValue as j, CustomFilterValue as k, EducationRequirement as l, JobCapability as m, JobCatalogPagination as n, JobCollectionChoiceList as o, JobCollectionFieldDefinition as p, JobCompany as q, JobCustomEmploymentType as r, OfficeLocation as s, OffsetPagination as t, PublicJobCard as u, RelatedSearch as v, RemotePermit as w, RemoteTimezone as x, ResolvedJobCollectionField as y, StorefrontPagination as z };