@cavuno/board 4.2.0 → 4.3.0

package/CHANGELOG.md

@@ -3,6 +3,20 @@
 This changelog records changes that affect Board API compatibility, exported
 types, runtime behavior, or supported integration patterns.
 
+## 4.3.0 — 2026-08-07
+
+- **`CompanyPublic.salarySampleCount`**: number of jobs that contribute to a
+  company's salary aggregates on the board (`0` when there is no usable
+  sample). Prefer this over fetching the full company-salary document just to
+  gate a Salaries tab or empty state. Distinct from `publishedJobCount` (open
+  roles without pay data stay at 0 here).
+- **`GET …/companies/{slug}/salaries/summary`** and
+  `board.companies.salaries.summary(slug)`: lightweight profile teaser —
+  overall pay numbers, top categories by sample size, `sampleCount`, and
+  `currency` as `CompanySalarySummary`. Skips seniority, competitors,
+  locations, and logo joins from the full `CompanySalary` document. Format
+  currency ranges and multi-locale UI strings in the app.
+
 ## 4.2.0 — 2026-08-06
 
 - **Board logo + favicon pack on `board.context()`**: public board context now

package/dist/{_spec-BnoxU-iR.d.mts → _spec-CT7rWhQ-.d.mts}

@@ -449,6 +449,8 @@ interface components {
             jobCount: number;
             /** @description Number of currently-published, non-expired jobs at this company. */
             publishedJobCount: number;
+            /** @description Number of jobs that contribute to this company's salary aggregates on the board (the salary sample size). `0` when there is no usable salary data — prefer this over fetching the full company-salary document just to decide whether to show a Salaries tab. Not the same as `publishedJobCount` (open roles without pay data stay at 0 here). */
+            salarySampleCount: number;
             links: components["schemas"]["PublicCompanyLinks"];
         };
         CompanyPublicDetail: components["schemas"]["CompanyPublic"] & {
@@ -515,6 +517,28 @@ interface components {
             boardP75Max: number | null;
             currency: string;
         };
+        CompanySalarySummary: {
+            /** @enum {string} */
+            object: "company_salary_summary";
+            companyName: string;
+            companySlug: string;
+            overallSalary: {
+                avgMin: number;
+                avgMax: number;
+                jobCount: number;
+            } | null;
+            /** @description Top job categories at the company by sample size (capped; full list is on CompanySalary.byCategory). Category names/slugs are board-language localized. */
+            topCategories: {
+                categorySlug: string;
+                categoryName: string;
+                avgSalaryMin: number;
+                avgSalaryMax: number;
+                jobCount: number;
+            }[];
+            /** @description Jobs contributing to this company's salary aggregates (same meaning as CompanyPublic.salarySampleCount / overallSalary.jobCount). */
+            sampleCount: number;
+            currency: string;
+        };
         CompanySuggestion: {
             /** @enum {string} */
             object: "suggestion";

package/dist/{_spec-BnoxU-iR.d.ts → _spec-CT7rWhQ-.d.ts}

@@ -449,6 +449,8 @@ interface components {
             jobCount: number;
             /** @description Number of currently-published, non-expired jobs at this company. */
             publishedJobCount: number;
+            /** @description Number of jobs that contribute to this company's salary aggregates on the board (the salary sample size). `0` when there is no usable salary data — prefer this over fetching the full company-salary document just to decide whether to show a Salaries tab. Not the same as `publishedJobCount` (open roles without pay data stay at 0 here). */
+            salarySampleCount: number;
             links: components["schemas"]["PublicCompanyLinks"];
         };
         CompanyPublicDetail: components["schemas"]["CompanyPublic"] & {
@@ -515,6 +517,28 @@ interface components {
             boardP75Max: number | null;
             currency: string;
         };
+        CompanySalarySummary: {
+            /** @enum {string} */
+            object: "company_salary_summary";
+            companyName: string;
+            companySlug: string;
+            overallSalary: {
+                avgMin: number;
+                avgMax: number;
+                jobCount: number;
+            } | null;
+            /** @description Top job categories at the company by sample size (capped; full list is on CompanySalary.byCategory). Category names/slugs are board-language localized. */
+            topCategories: {
+                categorySlug: string;
+                categoryName: string;
+                avgSalaryMin: number;
+                avgSalaryMax: number;
+                jobCount: number;
+            }[];
+            /** @description Jobs contributing to this company's salary aggregates (same meaning as CompanyPublic.salarySampleCount / overallSalary.jobCount). */
+            sampleCount: number;
+            currency: string;
+        };
         CompanySuggestion: {
             /** @enum {string} */
             object: "suggestion";

package/dist/{blog-DoAOCg-d.d.mts → blog-CJda3-Ab.d.mts}

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

package/dist/{blog-D-PYhejB.d.ts → blog-DOBig1Wh.d.ts}

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

package/dist/{board-CvBkK7my.d.mts → board-BLwReKB8.d.mts}

@@ -1,5 +1,5 @@
-import { S as Schemas } from './_spec-BnoxU-iR.mjs';
-import { L as ListEnvelope, m as RelatedSearch } from './jobs-aTp9uC3a.mjs';
+import { S as Schemas } from './_spec-CT7rWhQ-.mjs';
+import { L as ListEnvelope, m as RelatedSearch } from './jobs-CZUpStJ3.mjs';
 
 type PublicCompany = Schemas['CompanyPublic'];
 /** A market (sector) a company operates in — name + its source slug. */
@@ -12,6 +12,13 @@ type PublicCompanyDetail = Schemas['CompanyPublicDetail'];
  * Names are board-language localized; the company slug/name are not.
  */
 type CompanySalary = Schemas['CompanySalary'];
+/**
+ * Lightweight company salary teaser for profile / overview UIs: overall pay
+ * numbers, top categories, currency, and sampleCount. Prefer over
+ * `CompanySalary` when you only need a teaser. Format ranges and multi-locale
+ * UI strings in the app.
+ */
+type CompanySalarySummary = Schemas['CompanySalarySummary'];
 /**
  * A company's salary for one job category: the category's source + board-language
  * canonical slug, by-seniority vs the board-category baseline, and competitors in
@@ -102,4 +109,4 @@ type CustomFieldDefinition = Schemas['CustomFieldDefinition'];
 type CustomFieldType = CustomFieldDefinition['type'];
 type CustomFieldOption = Schemas['CustomFieldOption'];
 
-export type { TitleLocationsIndex as A, CustomFieldDefinition as C, LocationSalaryDetail as L, PublicBoard as P, SkillSalaryDetail as S, TitleSalaryDetail as T, CompanyCategorySalary as a, CompanySalary as b, CompaniesListQuery as c, CompanyListEnvelope as d, CompaniesSearchBody as e, CompanyJobsListQuery as f, CompanySimilarQuery as g, CompanyMarketsListQuery as h, SalaryDetailQuery as i, CompanyMarket as j, CompanyMarketRef as k, CustomFieldOption as l, CustomFieldType as m, LocationSkillsIndex as n, LocationTitlesIndex as o, PublicBoardAnalytics as p, PublicBoardFeatures as q, PublicCompany as r, PublicCompanyDetail as s, SalaryCompany as t, SalaryLocation as u, SalarySkill as v, SalaryTitle as w, SkillLocationSalary as x, SkillLocationsIndex as y, TitleLocationSalary as z };
+export type { TitleLocationSalary as A, TitleLocationsIndex as B, CustomFieldDefinition as C, LocationSalaryDetail as L, PublicBoard as P, SkillSalaryDetail as S, TitleSalaryDetail as T, CompanyCategorySalary as a, CompanySalary as b, CompaniesListQuery as c, CompanyListEnvelope as d, CompaniesSearchBody as e, CompanyJobsListQuery as f, CompanySimilarQuery as g, CompanyMarketsListQuery as h, SalaryDetailQuery as i, CompanyMarket as j, CompanyMarketRef as k, CompanySalarySummary as l, CustomFieldOption as m, CustomFieldType as n, LocationSkillsIndex as o, LocationTitlesIndex as p, PublicBoardAnalytics as q, PublicBoardFeatures as r, PublicCompany as s, PublicCompanyDetail as t, SalaryCompany as u, SalaryLocation as v, SalarySkill as w, SalaryTitle as x, SkillLocationSalary as y, SkillLocationsIndex as z };

package/dist/{board-4vXzYDL3.d.ts → board-O990tPTt.d.ts}

@@ -1,5 +1,5 @@
-import { S as Schemas } from './_spec-BnoxU-iR.js';
-import { L as ListEnvelope, m as RelatedSearch } from './jobs-B8DNWEir.js';
+import { S as Schemas } from './_spec-CT7rWhQ-.js';
+import { L as ListEnvelope, m as RelatedSearch } from './jobs-Cf7J5vJe.js';
 
 type PublicCompany = Schemas['CompanyPublic'];
 /** A market (sector) a company operates in — name + its source slug. */
@@ -12,6 +12,13 @@ type PublicCompanyDetail = Schemas['CompanyPublicDetail'];
  * Names are board-language localized; the company slug/name are not.
  */
 type CompanySalary = Schemas['CompanySalary'];
+/**
+ * Lightweight company salary teaser for profile / overview UIs: overall pay
+ * numbers, top categories, currency, and sampleCount. Prefer over
+ * `CompanySalary` when you only need a teaser. Format ranges and multi-locale
+ * UI strings in the app.
+ */
+type CompanySalarySummary = Schemas['CompanySalarySummary'];
 /**
  * A company's salary for one job category: the category's source + board-language
  * canonical slug, by-seniority vs the board-category baseline, and competitors in
@@ -102,4 +109,4 @@ type CustomFieldDefinition = Schemas['CustomFieldDefinition'];
 type CustomFieldType = CustomFieldDefinition['type'];
 type CustomFieldOption = Schemas['CustomFieldOption'];
 
-export type { TitleLocationsIndex as A, CustomFieldDefinition as C, LocationSalaryDetail as L, PublicBoard as P, SkillSalaryDetail as S, TitleSalaryDetail as T, CompanyCategorySalary as a, CompanySalary as b, CompaniesListQuery as c, CompanyListEnvelope as d, CompaniesSearchBody as e, CompanyJobsListQuery as f, CompanySimilarQuery as g, CompanyMarketsListQuery as h, SalaryDetailQuery as i, CompanyMarket as j, CompanyMarketRef as k, CustomFieldOption as l, CustomFieldType as m, LocationSkillsIndex as n, LocationTitlesIndex as o, PublicBoardAnalytics as p, PublicBoardFeatures as q, PublicCompany as r, PublicCompanyDetail as s, SalaryCompany as t, SalaryLocation as u, SalarySkill as v, SalaryTitle as w, SkillLocationSalary as x, SkillLocationsIndex as y, TitleLocationSalary as z };
+export type { TitleLocationSalary as A, TitleLocationsIndex as B, CustomFieldDefinition as C, LocationSalaryDetail as L, PublicBoard as P, SkillSalaryDetail as S, TitleSalaryDetail as T, CompanyCategorySalary as a, CompanySalary as b, CompaniesListQuery as c, CompanyListEnvelope as d, CompaniesSearchBody as e, CompanyJobsListQuery as f, CompanySimilarQuery as g, CompanyMarketsListQuery as h, SalaryDetailQuery as i, CompanyMarket as j, CompanyMarketRef as k, CompanySalarySummary as l, CustomFieldOption as m, CustomFieldType as n, LocationSkillsIndex as o, LocationTitlesIndex as p, PublicBoardAnalytics as q, PublicBoardFeatures as r, PublicCompany as s, PublicCompanyDetail as t, SalaryCompany as u, SalaryLocation as v, SalarySkill as w, SalaryTitle as x, SkillLocationSalary as y, SkillLocationsIndex as z };

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

package/dist/{breadcrumbs-Blf_rsux.d.ts → breadcrumbs-ClvafKXZ.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-4vXzYDL3.js';
-import { P as PublicJob } from './jobs-B8DNWEir.js';
+import { P as PublicBoard, a as CompanyCategorySalary, b as CompanySalary, L as LocationSalaryDetail, S as SkillSalaryDetail, T as TitleSalaryDetail } from './board-O990tPTt.js';
+import { P as PublicJob } from './jobs-Cf7J5vJe.js';
 
 /**
  * Wire enum for `salaryTimeframe`. Defined here (not re-exported from any

package/dist/filters.d.mts

@@ -1,5 +1,5 @@
-import { J as JobSort, E as EmploymentType, R as RemoteOption, S as Seniority } from './jobs-aTp9uC3a.mjs';
-import './_spec-BnoxU-iR.mjs';
+import { J as JobSort, E as EmploymentType, R as RemoteOption, S as Seniority } from './jobs-CZUpStJ3.mjs';
+import './_spec-CT7rWhQ-.mjs';
 
 /**
  * `@cavuno/board/filters` — the canonical listing-filter vocabulary and URL

package/dist/filters.d.ts

@@ -1,5 +1,5 @@
-import { J as JobSort, E as EmploymentType, R as RemoteOption, S as Seniority } from './jobs-B8DNWEir.js';
-import './_spec-BnoxU-iR.js';
+import { J as JobSort, E as EmploymentType, R as RemoteOption, S as Seniority } from './jobs-Cf7J5vJe.js';
+import './_spec-CT7rWhQ-.js';
 
 /**
  * `@cavuno/board/filters` — the canonical listing-filter vocabulary and URL

package/dist/format.d.mts

@@ -1,7 +1,7 @@
-export { C as CurrencyDisplay, F as FormattedSalaryRange, J as JobBreadcrumb, N as NumberNotation, S as SalaryTimeframeInput, a as SalaryTimeframeValue, b as buildJobBreadcrumbs, f as formatSalaryRange, c as formatSalaryStat, d as formatSalaryStatRange, n as normalizeWebsiteUrl } from './breadcrumbs-Cz1sFqtV.mjs';
-import { C as CustomFieldDefinition } from './board-CvBkK7my.mjs';
-import { C as CustomFieldValues } from './jobs-aTp9uC3a.mjs';
-import './_spec-BnoxU-iR.mjs';
+export { C as CurrencyDisplay, F as FormattedSalaryRange, J as JobBreadcrumb, N as NumberNotation, S as SalaryTimeframeInput, a as SalaryTimeframeValue, b as buildJobBreadcrumbs, f as formatSalaryRange, c as formatSalaryStat, d as formatSalaryStatRange, n as normalizeWebsiteUrl } from './breadcrumbs-CQjU_wHB.mjs';
+import { C as CustomFieldDefinition } from './board-BLwReKB8.mjs';
+import { C as CustomFieldValues } from './jobs-CZUpStJ3.mjs';
+import './_spec-CT7rWhQ-.mjs';
 
 /**
  * Date display helpers in the board language (required leading parameter,

package/dist/format.d.ts

@@ -1,7 +1,7 @@
-export { C as CurrencyDisplay, F as FormattedSalaryRange, J as JobBreadcrumb, N as NumberNotation, S as SalaryTimeframeInput, a as SalaryTimeframeValue, b as buildJobBreadcrumbs, f as formatSalaryRange, c as formatSalaryStat, d as formatSalaryStatRange, n as normalizeWebsiteUrl } from './breadcrumbs-Blf_rsux.js';
-import { C as CustomFieldDefinition } from './board-4vXzYDL3.js';
-import { C as CustomFieldValues } from './jobs-B8DNWEir.js';
-import './_spec-BnoxU-iR.js';
+export { C as CurrencyDisplay, F as FormattedSalaryRange, J as JobBreadcrumb, N as NumberNotation, S as SalaryTimeframeInput, a as SalaryTimeframeValue, b as buildJobBreadcrumbs, f as formatSalaryRange, c as formatSalaryStat, d as formatSalaryStatRange, n as normalizeWebsiteUrl } from './breadcrumbs-ClvafKXZ.js';
+import { C as CustomFieldDefinition } from './board-O990tPTt.js';
+import { C as CustomFieldValues } from './jobs-Cf7J5vJe.js';
+import './_spec-CT7rWhQ-.js';
 
 /**
  * Date display helpers in the board language (required leading parameter,

package/dist/index.d.mts

@@ -1,12 +1,12 @@
-import { S as Schemas, c as components } from './_spec-BnoxU-iR.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-Cs7d8y1k.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-Cs7d8y1k.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-CvBkK7my.mjs';
-export { a as CompanyCategorySalary, j as CompanyMarket, k as CompanyMarketRef, b as CompanySalary, C as CustomFieldDefinition, l as CustomFieldOption, m as CustomFieldType, L as LocationSalaryDetail, n as LocationSkillsIndex, o as LocationTitlesIndex, P as PublicBoard, p as PublicBoardAnalytics, q as PublicBoardFeatures, r as PublicCompany, s as PublicCompanyDetail, t as SalaryCompany, u as SalaryLocation, v as SalarySkill, w as SalaryTitle, x as SkillLocationSalary, y as SkillLocationsIndex, S as SkillSalaryDetail, z as TitleLocationSalary, A as TitleLocationsIndex, T as TitleSalaryDetail } from './board-CvBkK7my.mjs';
-import { R as RemoteOption, E as EmploymentType, S as Seniority, L as ListEnvelope, a as JobsListQuery, b as JobCardListEnvelope, c as JobsSearchBody, d as JobCardSearchEnvelope, e as JobsSimilarQuery, f as SearchEnvelope } from './jobs-aTp9uC3a.mjs';
-export { g as CustomFieldValue, C as CustomFieldValues, h as EducationRequirement, i as JobCatalogPagination, j as JobCompany, J as JobSort, O as OfficeLocation, k as OffsetPagination, P as PublicJob, l as PublicJobCard, m as RelatedSearch, n as RemotePermit, o as RemoteTimezone, p as StorefrontPagination } from './jobs-aTp9uC3a.mjs';
-import { a as BlogPostsListQuery, b as BlogSimilarQuery, c as BlogSearchBody } from './blog-DoAOCg-d.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-DoAOCg-d.mjs';
+import { S as Schemas, c as components } from './_spec-CT7rWhQ-.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-CHLEpKE5.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-CHLEpKE5.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-BLwReKB8.mjs';
+export { a as CompanyCategorySalary, j as CompanyMarket, k as CompanyMarketRef, b as CompanySalary, l as CompanySalarySummary, C as CustomFieldDefinition, m as CustomFieldOption, n as CustomFieldType, L as LocationSalaryDetail, o as LocationSkillsIndex, p as LocationTitlesIndex, P as PublicBoard, q as PublicBoardAnalytics, r as PublicBoardFeatures, s as PublicCompany, t as PublicCompanyDetail, u as SalaryCompany, v as SalaryLocation, w as SalarySkill, x as SalaryTitle, y as SkillLocationSalary, z as SkillLocationsIndex, S as SkillSalaryDetail, A as TitleLocationSalary, B as TitleLocationsIndex, T as TitleSalaryDetail } from './board-BLwReKB8.mjs';
+import { R as RemoteOption, E as EmploymentType, S as Seniority, L as ListEnvelope, a as JobsListQuery, b as JobCardListEnvelope, c as JobsSearchBody, d as JobCardSearchEnvelope, e as JobsSimilarQuery, f as SearchEnvelope } from './jobs-CZUpStJ3.mjs';
+export { g as CustomFieldValue, C as CustomFieldValues, h as EducationRequirement, i as JobCatalogPagination, j as JobCompany, J as JobSort, O as OfficeLocation, k as OffsetPagination, P as PublicJob, l as PublicJobCard, m as RelatedSearch, n as RemotePermit, o as RemoteTimezone, p as StorefrontPagination } from './jobs-CZUpStJ3.mjs';
+import { a as BlogPostsListQuery, b as BlogSimilarQuery, c as BlogSearchBody } from './blog-CJda3-Ab.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-CJda3-Ab.mjs';
 
 /**
  * Well-known `<domain>_<snake_reason>` codes the Board API sends, grouped by
@@ -142,7 +142,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.2.0";
+declare const SDK_VERSION = "4.3.0";
 
 type SavedJob = Schemas['SavedJob'];
 type SavedJobsListQuery = {
@@ -964,6 +964,7 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
             description: string | null;
             jobCount: number;
             publishedJobCount: number;
+            salarySampleCount: number;
             links: components["schemas"]["PublicCompanyLinks"];
         } & {
             markets: components["schemas"]["CompanyMarketRef"][];
@@ -979,6 +980,7 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
             description: string | null;
             jobCount: number;
             publishedJobCount: number;
+            salarySampleCount: number;
             links: components["schemas"]["PublicCompanyLinks"];
         }>>;
         listJobs(companySlug: string, query?: CompanyJobsListQuery, options?: FetchOptions): Promise<JobCardListEnvelope>;
@@ -993,6 +995,7 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
             description: string | null;
             jobCount: number;
             publishedJobCount: number;
+            salarySampleCount: number;
             links: components["schemas"]["PublicCompanyLinks"];
         }>>;
         markets: ((query?: CompanyMarketsListQuery, options?: FetchOptions) => Promise<ListEnvelope<{
@@ -1070,6 +1073,25 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
             boardP75Max: number | null;
             currency: string;
         }>) & {
+            summary(companySlug: string, options?: FetchOptions): Promise<{
+                object: "company_salary_summary";
+                companyName: string;
+                companySlug: string;
+                overallSalary: {
+                    avgMin: number;
+                    avgMax: number;
+                    jobCount: number;
+                } | null;
+                topCategories: {
+                    categorySlug: string;
+                    categoryName: string;
+                    avgSalaryMin: number;
+                    avgSalaryMax: number;
+                    jobCount: number;
+                }[];
+                sampleCount: number;
+                currency: string;
+            }>;
             category(companySlug: string, categorySlug: string, query?: SalaryDetailQuery, options?: FetchOptions): Promise<{
                 object: "company_category_salary";
                 categorySourceSlug: string;

package/dist/index.d.ts

@@ -1,12 +1,12 @@
-import { S as Schemas, c as components } from './_spec-BnoxU-iR.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-Cskh-neW.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-Cskh-neW.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-4vXzYDL3.js';
-export { a as CompanyCategorySalary, j as CompanyMarket, k as CompanyMarketRef, b as CompanySalary, C as CustomFieldDefinition, l as CustomFieldOption, m as CustomFieldType, L as LocationSalaryDetail, n as LocationSkillsIndex, o as LocationTitlesIndex, P as PublicBoard, p as PublicBoardAnalytics, q as PublicBoardFeatures, r as PublicCompany, s as PublicCompanyDetail, t as SalaryCompany, u as SalaryLocation, v as SalarySkill, w as SalaryTitle, x as SkillLocationSalary, y as SkillLocationsIndex, S as SkillSalaryDetail, z as TitleLocationSalary, A as TitleLocationsIndex, T as TitleSalaryDetail } from './board-4vXzYDL3.js';
-import { R as RemoteOption, E as EmploymentType, S as Seniority, L as ListEnvelope, a as JobsListQuery, b as JobCardListEnvelope, c as JobsSearchBody, d as JobCardSearchEnvelope, e as JobsSimilarQuery, f as SearchEnvelope } from './jobs-B8DNWEir.js';
-export { g as CustomFieldValue, C as CustomFieldValues, h as EducationRequirement, i as JobCatalogPagination, j as JobCompany, J as JobSort, O as OfficeLocation, k as OffsetPagination, P as PublicJob, l as PublicJobCard, m as RelatedSearch, n as RemotePermit, o as RemoteTimezone, p as StorefrontPagination } from './jobs-B8DNWEir.js';
-import { a as BlogPostsListQuery, b as BlogSimilarQuery, c as BlogSearchBody } from './blog-D-PYhejB.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-D-PYhejB.js';
+import { S as Schemas, c as components } from './_spec-CT7rWhQ-.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-YWruydKJ.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-YWruydKJ.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-O990tPTt.js';
+export { a as CompanyCategorySalary, j as CompanyMarket, k as CompanyMarketRef, b as CompanySalary, l as CompanySalarySummary, C as CustomFieldDefinition, m as CustomFieldOption, n as CustomFieldType, L as LocationSalaryDetail, o as LocationSkillsIndex, p as LocationTitlesIndex, P as PublicBoard, q as PublicBoardAnalytics, r as PublicBoardFeatures, s as PublicCompany, t as PublicCompanyDetail, u as SalaryCompany, v as SalaryLocation, w as SalarySkill, x as SalaryTitle, y as SkillLocationSalary, z as SkillLocationsIndex, S as SkillSalaryDetail, A as TitleLocationSalary, B as TitleLocationsIndex, T as TitleSalaryDetail } from './board-O990tPTt.js';
+import { R as RemoteOption, E as EmploymentType, S as Seniority, L as ListEnvelope, a as JobsListQuery, b as JobCardListEnvelope, c as JobsSearchBody, d as JobCardSearchEnvelope, e as JobsSimilarQuery, f as SearchEnvelope } from './jobs-Cf7J5vJe.js';
+export { g as CustomFieldValue, C as CustomFieldValues, h as EducationRequirement, i as JobCatalogPagination, j as JobCompany, J as JobSort, O as OfficeLocation, k as OffsetPagination, P as PublicJob, l as PublicJobCard, m as RelatedSearch, n as RemotePermit, o as RemoteTimezone, p as StorefrontPagination } from './jobs-Cf7J5vJe.js';
+import { a as BlogPostsListQuery, b as BlogSimilarQuery, c as BlogSearchBody } from './blog-DOBig1Wh.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-DOBig1Wh.js';
 
 /**
  * Well-known `<domain>_<snake_reason>` codes the Board API sends, grouped by
@@ -142,7 +142,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.2.0";
+declare const SDK_VERSION = "4.3.0";
 
 type SavedJob = Schemas['SavedJob'];
 type SavedJobsListQuery = {
@@ -964,6 +964,7 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
             description: string | null;
             jobCount: number;
             publishedJobCount: number;
+            salarySampleCount: number;
             links: components["schemas"]["PublicCompanyLinks"];
         } & {
             markets: components["schemas"]["CompanyMarketRef"][];
@@ -979,6 +980,7 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
             description: string | null;
             jobCount: number;
             publishedJobCount: number;
+            salarySampleCount: number;
             links: components["schemas"]["PublicCompanyLinks"];
         }>>;
         listJobs(companySlug: string, query?: CompanyJobsListQuery, options?: FetchOptions): Promise<JobCardListEnvelope>;
@@ -993,6 +995,7 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
             description: string | null;
             jobCount: number;
             publishedJobCount: number;
+            salarySampleCount: number;
             links: components["schemas"]["PublicCompanyLinks"];
         }>>;
         markets: ((query?: CompanyMarketsListQuery, options?: FetchOptions) => Promise<ListEnvelope<{
@@ -1070,6 +1073,25 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
             boardP75Max: number | null;
             currency: string;
         }>) & {
+            summary(companySlug: string, options?: FetchOptions): Promise<{
+                object: "company_salary_summary";
+                companyName: string;
+                companySlug: string;
+                overallSalary: {
+                    avgMin: number;
+                    avgMax: number;
+                    jobCount: number;
+                } | null;
+                topCategories: {
+                    categorySlug: string;
+                    categoryName: string;
+                    avgSalaryMin: number;
+                    avgSalaryMax: number;
+                    jobCount: number;
+                }[];
+                sampleCount: number;
+                currency: string;
+            }>;
             category(companySlug: string, categorySlug: string, query?: SalaryDetailQuery, options?: FetchOptions): Promise<{
                 object: "company_category_salary";
                 categorySourceSlug: string;

package/dist/index.js

@@ -312,7 +312,7 @@ async function clearSession(storage) {
 }
 
 // src/version.ts
-var SDK_VERSION = "4.2.0";
+var SDK_VERSION = "4.3.0";
 
 // src/client.ts
 function isRawBody(body) {
@@ -776,6 +776,12 @@ function companiesNamespace(client) {
       options
     ),
     {
+      summary(companySlug, options) {
+        return client.fetch(
+          `/companies/${encodeURIComponent(companySlug)}/salaries/summary`,
+          options
+        );
+      },
       category(companySlug, categorySlug, query, options) {
         return client.fetch(
           `/companies/${encodeURIComponent(companySlug)}/salaries/${encodeURIComponent(categorySlug)}`,

package/dist/index.mjs

@@ -39,7 +39,7 @@ function toSearchParams(query) {
 }
 
 // src/version.ts
-var SDK_VERSION = "4.2.0";
+var SDK_VERSION = "4.3.0";
 
 // src/client.ts
 function isRawBody(body) {
@@ -503,6 +503,12 @@ function companiesNamespace(client) {
       options
     ),
     {
+      summary(companySlug, options) {
+        return client.fetch(
+          `/companies/${encodeURIComponent(companySlug)}/salaries/summary`,
+          options
+        );
+      },
       category(companySlug, categorySlug, query, options) {
         return client.fetch(
           `/companies/${encodeURIComponent(companySlug)}/salaries/${encodeURIComponent(categorySlug)}`,

package/dist/{jobs-aTp9uC3a.d.mts → jobs-CZUpStJ3.d.mts}

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

package/dist/{jobs-B8DNWEir.d.ts → jobs-Cf7J5vJe.d.ts}

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

package/dist/{search-Cs7d8y1k.d.mts → search-CHLEpKE5.d.mts}

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

package/dist/{search-Cskh-neW.d.ts → search-YWruydKJ.d.ts}

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

package/dist/seo.d.mts

@@ -1,9 +1,9 @@
-import { P as PublicBlogPostSummary, B as BlogAuthorEmbed } from './blog-DoAOCg-d.mjs';
-import { e as JsonLdObject } from './breadcrumbs-Cz1sFqtV.mjs';
-export { A as ALL_COUNTRY_CODES, B as BreadcrumbItemInput, g as FaqItem, J as JobBreadcrumb, h as JsonLdBoard, N as NumberNotation, i as SENIORITY_ORDER, j as SalaryFaqEntry, k as SalaryJsonLdOptions, l as SalaryOccupationListOptions, b as buildJobBreadcrumbs, m as buildSalaryFaq, o as companyCategorySalaryJsonLd, p as companySalaryJsonLd, q as createBreadcrumbJsonLd, r as createJobPostingJsonLd, s as crossAxisSalaryJsonLd, t as faqJsonLd, c as formatSalaryStat, d as formatSalaryStatRange, u as itemListJsonLd, v as locationSalaryJsonLd, n as normalizeWebsiteUrl, w as skillSalaryJsonLd, x as sortBySeniority, y as titleSalaryJsonLd } from './breadcrumbs-Cz1sFqtV.mjs';
-import './_spec-BnoxU-iR.mjs';
-import './board-CvBkK7my.mjs';
-import './jobs-aTp9uC3a.mjs';
+import { P as PublicBlogPostSummary, B as BlogAuthorEmbed } from './blog-CJda3-Ab.mjs';
+import { e as JsonLdObject } from './breadcrumbs-CQjU_wHB.mjs';
+export { A as ALL_COUNTRY_CODES, B as BreadcrumbItemInput, g as FaqItem, J as JobBreadcrumb, h as JsonLdBoard, N as NumberNotation, i as SENIORITY_ORDER, j as SalaryFaqEntry, k as SalaryJsonLdOptions, l as SalaryOccupationListOptions, b as buildJobBreadcrumbs, m as buildSalaryFaq, o as companyCategorySalaryJsonLd, p as companySalaryJsonLd, q as createBreadcrumbJsonLd, r as createJobPostingJsonLd, s as crossAxisSalaryJsonLd, t as faqJsonLd, c as formatSalaryStat, d as formatSalaryStatRange, u as itemListJsonLd, v as locationSalaryJsonLd, n as normalizeWebsiteUrl, w as skillSalaryJsonLd, x as sortBySeniority, y as titleSalaryJsonLd } from './breadcrumbs-CQjU_wHB.mjs';
+import './_spec-CT7rWhQ-.mjs';
+import './board-BLwReKB8.mjs';
+import './jobs-CZUpStJ3.mjs';
 
 /**
  * Blog structured data on the `@cavuno/board` wire types, transcribed from

package/dist/seo.d.ts

@@ -1,9 +1,9 @@
-import { P as PublicBlogPostSummary, B as BlogAuthorEmbed } from './blog-D-PYhejB.js';
-import { e as JsonLdObject } from './breadcrumbs-Blf_rsux.js';
-export { A as ALL_COUNTRY_CODES, B as BreadcrumbItemInput, g as FaqItem, J as JobBreadcrumb, h as JsonLdBoard, N as NumberNotation, i as SENIORITY_ORDER, j as SalaryFaqEntry, k as SalaryJsonLdOptions, l as SalaryOccupationListOptions, b as buildJobBreadcrumbs, m as buildSalaryFaq, o as companyCategorySalaryJsonLd, p as companySalaryJsonLd, q as createBreadcrumbJsonLd, r as createJobPostingJsonLd, s as crossAxisSalaryJsonLd, t as faqJsonLd, c as formatSalaryStat, d as formatSalaryStatRange, u as itemListJsonLd, v as locationSalaryJsonLd, n as normalizeWebsiteUrl, w as skillSalaryJsonLd, x as sortBySeniority, y as titleSalaryJsonLd } from './breadcrumbs-Blf_rsux.js';
-import './_spec-BnoxU-iR.js';
-import './board-4vXzYDL3.js';
-import './jobs-B8DNWEir.js';
+import { P as PublicBlogPostSummary, B as BlogAuthorEmbed } from './blog-DOBig1Wh.js';
+import { e as JsonLdObject } from './breadcrumbs-ClvafKXZ.js';
+export { A as ALL_COUNTRY_CODES, B as BreadcrumbItemInput, g as FaqItem, J as JobBreadcrumb, h as JsonLdBoard, N as NumberNotation, i as SENIORITY_ORDER, j as SalaryFaqEntry, k as SalaryJsonLdOptions, l as SalaryOccupationListOptions, b as buildJobBreadcrumbs, m as buildSalaryFaq, o as companyCategorySalaryJsonLd, p as companySalaryJsonLd, q as createBreadcrumbJsonLd, r as createJobPostingJsonLd, s as crossAxisSalaryJsonLd, t as faqJsonLd, c as formatSalaryStat, d as formatSalaryStatRange, u as itemListJsonLd, v as locationSalaryJsonLd, n as normalizeWebsiteUrl, w as skillSalaryJsonLd, x as sortBySeniority, y as titleSalaryJsonLd } from './breadcrumbs-ClvafKXZ.js';
+import './_spec-CT7rWhQ-.js';
+import './board-O990tPTt.js';
+import './jobs-Cf7J5vJe.js';
 
 /**
  * Blog structured data on the `@cavuno/board` wire types, transcribed from

package/dist/server.d.mts

@@ -1,9 +1,9 @@
 import { BoardSdk } from './index.mjs';
-import './_spec-BnoxU-iR.mjs';
-import './search-Cs7d8y1k.mjs';
-import './board-CvBkK7my.mjs';
-import './jobs-aTp9uC3a.mjs';
-import './blog-DoAOCg-d.mjs';
+import './_spec-CT7rWhQ-.mjs';
+import './search-CHLEpKE5.mjs';
+import './board-BLwReKB8.mjs';
+import './jobs-CZUpStJ3.mjs';
+import './blog-CJda3-Ab.mjs';
 
 /**
  * Session cookie codec — pure (no framework imports, no node imports) so it

package/dist/server.d.ts

@@ -1,9 +1,9 @@
 import { BoardSdk } from './index.js';
-import './_spec-BnoxU-iR.js';
-import './search-Cskh-neW.js';
-import './board-4vXzYDL3.js';
-import './jobs-B8DNWEir.js';
-import './blog-D-PYhejB.js';
+import './_spec-CT7rWhQ-.js';
+import './search-YWruydKJ.js';
+import './board-O990tPTt.js';
+import './jobs-Cf7J5vJe.js';
+import './blog-DOBig1Wh.js';
 
 /**
  * Session cookie codec — pure (no framework imports, no node imports) so it

package/dist/sitemap.d.mts

@@ -1,9 +1,9 @@
 import { BoardSdk } from './index.mjs';
-import './_spec-BnoxU-iR.mjs';
-import './search-Cs7d8y1k.mjs';
-import './board-CvBkK7my.mjs';
-import './jobs-aTp9uC3a.mjs';
-import './blog-DoAOCg-d.mjs';
+import './_spec-CT7rWhQ-.mjs';
+import './search-CHLEpKE5.mjs';
+import './board-BLwReKB8.mjs';
+import './jobs-CZUpStJ3.mjs';
+import './blog-CJda3-Ab.mjs';
 
 /**
  * Sitemap primitives — the pure XML + bucket-filename logic behind a board

package/dist/sitemap.d.ts

@@ -1,9 +1,9 @@
 import { BoardSdk } from './index.js';
-import './_spec-BnoxU-iR.js';
-import './search-Cskh-neW.js';
-import './board-4vXzYDL3.js';
-import './jobs-B8DNWEir.js';
-import './blog-D-PYhejB.js';
+import './_spec-CT7rWhQ-.js';
+import './search-YWruydKJ.js';
+import './board-O990tPTt.js';
+import './jobs-Cf7J5vJe.js';
+import './blog-DOBig1Wh.js';
 
 /**
  * Sitemap primitives — the pure XML + bucket-filename logic behind a board

package/dist/suggest.d.mts

@@ -1,5 +1,5 @@
-import { h as SuggestionItem, b as SearchSuggestQuery, F as FetchOptions, g as SuggestResult } from './search-Cs7d8y1k.mjs';
-import './_spec-BnoxU-iR.mjs';
+import { h as SuggestionItem, b as SearchSuggestQuery, F as FetchOptions, g as SuggestResult } from './search-CHLEpKE5.mjs';
+import './_spec-CT7rWhQ-.mjs';
 
 /**
  * `@cavuno/board/suggest` — framework-agnostic headless search-suggest

package/dist/suggest.d.ts

@@ -1,5 +1,5 @@
-import { h as SuggestionItem, b as SearchSuggestQuery, F as FetchOptions, g as SuggestResult } from './search-Cskh-neW.js';
-import './_spec-BnoxU-iR.js';
+import { h as SuggestionItem, b as SearchSuggestQuery, F as FetchOptions, g as SuggestResult } from './search-YWruydKJ.js';
+import './_spec-CT7rWhQ-.js';
 
 /**
  * `@cavuno/board/suggest` — framework-agnostic headless search-suggest

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cavuno/board",
-  "version": "4.2.0",
+  "version": "4.3.0",
   "description": "Build custom job boards and careers pages with Cavuno’s TypeScript SDK.",
   "keywords": [
     "api-client",

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

@@ -80,12 +80,23 @@ the current company, and ranks by open roles. Fetch `retrieve` before reading
 
 ## Render company salaries
 
-`companies.salaries` is callable and carries `.category`. The overview returns
-`CompanySalary`: nullable `overallSalary`, `bySeniority` rows with board
-comparison `diffPercent`, `competitors`, `topLocations`, `byCategory`,
-board-wide baselines, and `currency`.
+`companies.salaries` is callable and carries `.summary` and `.category`.
+
+For a profile / overview teaser, prefer `.summary` — it returns
+`CompanySalarySummary` (overall numbers, top categories, `sampleCount`,
+`currency`) without seniority, competitors, locations, or logos. Format
+currency ranges and multi-locale UI strings in the app.
+
+The full overview returns `CompanySalary`: nullable `overallSalary`,
+`bySeniority` rows with board comparison `diffPercent`, `competitors`,
+`topLocations`, `byCategory`, board-wide baselines, and `currency`.
 
 ```ts snippet
+const teaser = await board.companies.salaries.summary('acme');
+teaser.overallSalary;
+teaser.topCategories;
+teaser.sampleCount;
+
 const overview = await board.companies.salaries('acme');
 overview.bySeniority[0]?.diffPercent;
 
@@ -97,11 +108,12 @@ category.categorySourceSlug;
 category.categoryCanonicalSlug;
 ```
 
-Pass `{ locale }` for board-language category names. Company identity remains
-untranslated. The API returns both the immutable English
+Pass `{ locale }` for board-language category names on `.category`. Company
+identity remains untranslated. The API returns both the immutable English
 `categorySourceSlug` and the board-language `categoryCanonicalSlug`; the host
 route issues a 308 when the inbound category slug differs from the canonical
-one.
+one. Gate a Salaries tab with `company.salarySampleCount > 0` from
+`companies.retrieve` rather than fetching salary documents just for presence.
 
 ## Completion gate
 

package/skills/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "4.2.0",
+  "version": "4.3.0",
   "skills": [
     {
       "name": "cavuno-board-account",