@cavuno/board 4.41.1 → 4.44.0

package/dist/index.mjs

@@ -25,7 +25,7 @@ import {
   isSsoRequired,
   isUnauthorized,
   isValidationError
-} from "./chunk-WSO6JN5C.mjs";
+} from "./chunk-DZD3DAEY.mjs";
 
 // src/query.ts
 function toSearchParams(query) {
@@ -46,7 +46,7 @@ function toSearchParams(query) {
 }
 
 // src/version.ts
-var SDK_VERSION = "4.41.1";
+var SDK_VERSION = "4.44.0";
 
 // src/client.ts
 function isRawBody(body) {
@@ -989,7 +989,11 @@ function jobPostingNamespace(client) {
         { ...options, method: "POST", body: input }
       );
     },
-    /** List the credit options for a verified email (an option → `selectedBilling`). */
+    /**
+     * List the credit options for a verified email. To spend one, pass the
+     * option as `selectedBilling` and the same `verificationToken` as
+     * `billingVerificationToken` to `create`.
+     */
     getBillingOptions(input, options) {
       return client.fetch(
         "/job-postings/billing-options",
@@ -2129,9 +2133,12 @@ function meNamespace(client) {
         }
       },
       /**
-       * Company-owned saved predicates over the talent directory.
-       * Approved members share the same lists. Optional `job` binds a list
-       * to one company job; pass `job: null` on update to unbind.
+       * Company-owned saved searches over the talent directory. Each holds
+       * named filters and, optionally, saved people (`members`). Approved
+       * members share the same lists. Optional `job` links a list to one
+       * company job; pass `job: null` on update to unlink. Linking a list
+       * shortlists everyone saved to it onto that job; unlinking changes no
+       * pipeline.
        */
       talentLists: {
         /**
@@ -2173,7 +2180,10 @@ function meNamespace(client) {
             { ...options, method: "PATCH", body }
           );
         },
-        /** Delete a talent list. Sourced membership is unaffected. */
+        /**
+         * Delete a talent list and the people saved to it. Job pipelines and
+         * sourced membership are unaffected.
+         */
         remove(slug, listId, options) {
           return client.fetch(
             `/me/companies/${encodeURIComponent(
@@ -2181,6 +2191,90 @@ function meNamespace(client) {
             )}/talent-lists/${encodeURIComponent(listId)}`,
             { ...options, method: "DELETE" }
           );
+        },
+        /**
+         * The talent lists of a company one candidate is saved to — for
+         * showing which lists a Save control has ticked.
+         *
+         * @example
+         * const { data } = await board.me.companies.talentLists.memberships(
+         *   'acme',
+         *   { candidate: candidateId },
+         * );
+         * const saved = new Set(data.map((m) => m.listId));
+         */
+        memberships(slug, query, options) {
+          return client.fetch(
+            `/me/companies/${encodeURIComponent(slug)}/talent-list-memberships`,
+            { ...options, query }
+          );
+        },
+        /**
+         * People saved to a talent list (at most 500 per list).
+         */
+        members: {
+          /**
+           * List the people saved to a list as directory cards, most
+           * recently saved first unless `sort` or a keyword (`q`) is set;
+           * with a keyword, best match first. Cards are redacted as in the
+           * public directory when the board sells profile unlocks, except
+           * for candidates the company has unlocked. Runs the public
+           * talent directory search, with the same filters, restricted to
+           * the saved people, so a "Saved" view can combine with the
+           * list's filters. Blocked, hidden and deactivated
+           * candidates are omitted. `total` counts every visible saved
+           * person; `count` counts the ones the filters keep.
+           *
+           * @example
+           * const { data, total } =
+           *   await board.me.companies.talentLists.members.list(
+           *     'acme',
+           *     listId,
+           *     { skill: 'react' },
+           *   );
+           */
+          list(slug, listId, query, options) {
+            return client.fetch(
+              `/me/companies/${encodeURIComponent(
+                slug
+              )}/talent-lists/${encodeURIComponent(listId)}/members`,
+              { ...options, query }
+            );
+          },
+          /**
+           * Save a candidate to a list. Idempotent: saving someone already
+           * on it returns `created: false`. When the list is linked to a
+           * job, the candidate is also shortlisted onto that job unless they
+           * already have a pipeline row there. A full list raises
+           * `talent_list_full` (409).
+           *
+           * @example
+           * await board.me.companies.talentLists.members.add('acme', listId, {
+           *   candidateBoardUserId: candidateId,
+           * });
+           */
+          add(slug, listId, body, options) {
+            return client.fetch(
+              `/me/companies/${encodeURIComponent(
+                slug
+              )}/talent-lists/${encodeURIComponent(listId)}/members`,
+              { ...options, method: "POST", body }
+            );
+          },
+          /**
+           * Remove a candidate from a list. Idempotent. Never changes a job
+           * pipeline, including the linked job's.
+           */
+          remove(slug, listId, candidateBoardUserId, options) {
+            return client.fetch(
+              `/me/companies/${encodeURIComponent(
+                slug
+              )}/talent-lists/${encodeURIComponent(
+                listId
+              )}/members/${encodeURIComponent(candidateBoardUserId)}`,
+              { ...options, method: "DELETE" }
+            );
+          }
         }
       },
       /**
@@ -3396,9 +3490,10 @@ function sitemapNamespace(client) {
 function talentNamespace(client) {
   return {
     /**
-     * List the board's public talent directory — candidate cards ranked by
+     * List the board's talent directory — candidate cards ranked by
      * job-search status then most-recently-updated, the same ordering the
-     * hosted `/talent` page renders. Only `public` profiles appear.
+     * hosted `/talent` page renders. Anonymous callers see `public` profiles;
+     * a signed-in board user also sees `logged_in_only` ones.
      *
      * Throws `talent_directory_restricted` (403) when the board restricts the
      * directory to employers (render an employer upsell), or

package/dist/{jobs-B-imggAc.d.mts → jobs-CjQM8EPT.d.mts}

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

package/dist/{jobs-jQwzYyvr.d.ts → jobs-DZVMzBOQ.d.ts}

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

package/dist/{search-C8uy6k8-.d.mts → search-BtBE6iJO.d.mts}

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

package/dist/{search-vXX_s6f5.d.ts → search-CF_wa20h.d.ts}

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

package/dist/{seo-D3AF4q7d.d.mts → seo-0bfk63qi.d.mts}

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

package/dist/{seo-BdNi6Eif.d.ts → seo-CU9LpWH7.d.ts}

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

package/dist/seo-files.d.mts

@@ -1,5 +1,5 @@
-import { B as BoardSeo } from './seo-D3AF4q7d.mjs';
-import './_spec-DRUEt9M3.mjs';
+import { B as BoardSeo } from './seo-0bfk63qi.mjs';
+import './_spec-CLxrfYJb.mjs';
 
 /**
  * `@cavuno/board/seo-files` — platform-owned crawler/identity file bodies

package/dist/seo-files.d.ts

@@ -1,5 +1,5 @@
-import { B as BoardSeo } from './seo-BdNi6Eif.js';
-import './_spec-DRUEt9M3.js';
+import { B as BoardSeo } from './seo-CU9LpWH7.js';
+import './_spec-CLxrfYJb.js';
 
 /**
  * `@cavuno/board/seo-files` — platform-owned crawler/identity file bodies

package/dist/seo.d.mts

@@ -1,9 +1,9 @@
-import { P as PublicBlogPostSummary, B as BlogAuthorEmbed } from './blog-B0oLDN4M.mjs';
-import { e as JsonLdObject } from './breadcrumbs-BTqDFpGD.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-BTqDFpGD.mjs';
-import './_spec-DRUEt9M3.mjs';
-import './board-Eusn8R9i.mjs';
-import './jobs-B-imggAc.mjs';
+import { P as PublicBlogPostSummary, B as BlogAuthorEmbed } from './blog-CQ40QX7l.mjs';
+import { e as JsonLdObject } from './breadcrumbs-DauM7O7_.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-DauM7O7_.mjs';
+import './_spec-CLxrfYJb.mjs';
+import './board-TOzb2D8c.mjs';
+import './jobs-CjQM8EPT.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-DZejMyq-.js';
-import { e as JsonLdObject } from './breadcrumbs-nX2svS5_.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-nX2svS5_.js';
-import './_spec-DRUEt9M3.js';
-import './board-C-Hz8MMP.js';
-import './jobs-jQwzYyvr.js';
+import { P as PublicBlogPostSummary, B as BlogAuthorEmbed } from './blog-mlhJ6UcD.js';
+import { e as JsonLdObject } from './breadcrumbs-DJHyzBji.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-DJHyzBji.js';
+import './_spec-CLxrfYJb.js';
+import './board-DWFDeICw.js';
+import './jobs-DZVMzBOQ.js';
 
 /**
  * Blog structured data on the `@cavuno/board` wire types, transcribed from

package/dist/server.d.mts

@@ -1,10 +1,10 @@
 import { BoardSdk } from './index.mjs';
-import './_spec-DRUEt9M3.mjs';
-import './search-C8uy6k8-.mjs';
-import './board-Eusn8R9i.mjs';
-import './jobs-B-imggAc.mjs';
-import './seo-D3AF4q7d.mjs';
-import './blog-B0oLDN4M.mjs';
+import './_spec-CLxrfYJb.mjs';
+import './search-BtBE6iJO.mjs';
+import './jobs-CjQM8EPT.mjs';
+import './board-TOzb2D8c.mjs';
+import './seo-0bfk63qi.mjs';
+import './blog-CQ40QX7l.mjs';
 
 /**
  * Session cookie codec — pure (no framework imports, no node imports) so it

package/dist/server.d.ts

@@ -1,10 +1,10 @@
 import { BoardSdk } from './index.js';
-import './_spec-DRUEt9M3.js';
-import './search-vXX_s6f5.js';
-import './board-C-Hz8MMP.js';
-import './jobs-jQwzYyvr.js';
-import './seo-BdNi6Eif.js';
-import './blog-DZejMyq-.js';
+import './_spec-CLxrfYJb.js';
+import './search-CF_wa20h.js';
+import './jobs-DZVMzBOQ.js';
+import './board-DWFDeICw.js';
+import './seo-CU9LpWH7.js';
+import './blog-mlhJ6UcD.js';
 
 /**
  * Session cookie codec — pure (no framework imports, no node imports) so it

package/dist/server.mjs

@@ -4,7 +4,7 @@ import {
 } from "./chunk-Z4ALWIGS.mjs";
 import {
   isUnauthorized
-} from "./chunk-WSO6JN5C.mjs";
+} from "./chunk-DZD3DAEY.mjs";
 
 // src/server/cookie.ts
 var COOKIE_ATTRIBUTES = "Path=/; HttpOnly; Secure; SameSite=Lax";

package/dist/sitemap.d.mts

@@ -1,10 +1,10 @@
 import { BoardSdk } from './index.mjs';
-import './_spec-DRUEt9M3.mjs';
-import './search-C8uy6k8-.mjs';
-import './board-Eusn8R9i.mjs';
-import './jobs-B-imggAc.mjs';
-import './seo-D3AF4q7d.mjs';
-import './blog-B0oLDN4M.mjs';
+import './_spec-CLxrfYJb.mjs';
+import './search-BtBE6iJO.mjs';
+import './jobs-CjQM8EPT.mjs';
+import './board-TOzb2D8c.mjs';
+import './seo-0bfk63qi.mjs';
+import './blog-CQ40QX7l.mjs';
 
 /**
  * Sitemap primitives — the pure XML + bucket-filename logic behind a board

package/dist/sitemap.d.ts

@@ -1,10 +1,10 @@
 import { BoardSdk } from './index.js';
-import './_spec-DRUEt9M3.js';
-import './search-vXX_s6f5.js';
-import './board-C-Hz8MMP.js';
-import './jobs-jQwzYyvr.js';
-import './seo-BdNi6Eif.js';
-import './blog-DZejMyq-.js';
+import './_spec-CLxrfYJb.js';
+import './search-CF_wa20h.js';
+import './jobs-DZVMzBOQ.js';
+import './board-DWFDeICw.js';
+import './seo-CU9LpWH7.js';
+import './blog-mlhJ6UcD.js';
 
 /**
  * Sitemap primitives — the pure XML + bucket-filename logic behind a board

package/dist/sitemap.mjs

@@ -3,7 +3,7 @@ import {
 } from "./chunk-DLSO6XXY.mjs";
 import {
   isNotFound
-} from "./chunk-WSO6JN5C.mjs";
+} from "./chunk-DZD3DAEY.mjs";
 import {
   BOARD_PATHS,
   blogAuthorPath,

package/dist/suggest.d.mts

@@ -1,5 +1,5 @@
-import { h as SuggestionItem, b as SearchSuggestQuery, F as FetchOptions, g as SuggestResult } from './search-C8uy6k8-.mjs';
-import './_spec-DRUEt9M3.mjs';
+import { h as SuggestionItem, b as SearchSuggestQuery, F as FetchOptions, g as SuggestResult } from './search-BtBE6iJO.mjs';
+import './_spec-CLxrfYJb.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-vXX_s6f5.js';
-import './_spec-DRUEt9M3.js';
+import { h as SuggestionItem, b as SearchSuggestQuery, F as FetchOptions, g as SuggestResult } from './search-CF_wa20h.js';
+import './_spec-CLxrfYJb.js';
 
 /**
  * `@cavuno/board/suggest` — framework-agnostic headless search-suggest

package/package.json

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

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

@@ -13,9 +13,11 @@ The host app owns authoring, feeds, sitemaps, and OG-image routes.
 ## Build archives
 
 `blog.posts.list` returns `ListEnvelope<PublicBlogPostSummary>`. Its query
-accepts `limit` (1–100), `cursor`, `tagSlug`, `authorSlug`, and
-`featured: 'true'`. `featured` is the string literal. Blog lists use cursor
-pagination and expose neither `offset` nor total `count`.
+accepts `limit` (1–100), `cursor`, `tagSlug`, `authorSlug`,
+`featured: 'true'`, and `sort` (`'newest'` default, or `'featured'` for
+featured posts first, then the rest, as one list). `featured` is the string
+literal. Blog lists use cursor pagination and expose neither `offset` nor total
+`count`; a cursor only continues the list it came from.
 
 ```ts snippet
 const page = await board.blog.posts.list({ tagSlug: 'news', limit: 12 });
@@ -109,6 +111,8 @@ Finish only after every applicable check passes:
   `html`.
 - A retrieved old slug redirects to `newSlug` before rendering.
 - Featured archives send the exact string `featured: 'true'`.
+- Archives that put featured posts on top use `sort: 'featured'`, not a
+  separate featured call merged in front of page one.
 - Cursor paging reaches `nextCursor: null` without relying on count or offset.
 - Newest and oldest posts handle the null side of `adjacent`.
 

package/skills/cavuno-board-post-a-job/SKILL.md

@@ -168,7 +168,7 @@ The checkout value is a URL for a host-owned full-page redirect. Payment publica
 
 ## Verified existing credit
 
-Email verification protects billing ownership. Send verification first, then exchange the token for options; a selected option becomes `selectedBilling`.
+Email verification protects billing ownership. Send verification first, then exchange the token for options; a selected option becomes `selectedBilling`, and the same token goes with it as `billingVerificationToken`. The token expires after an hour; verify again if it has.
 
 ```ts snippet
 await board.jobPosting.sendBillingVerification({ email });
@@ -190,6 +190,7 @@ if (option) {
       id: option.id,
       planId: option.planId,
     },
+    billingVerificationToken: verificationToken,
   });
 }
 ```

package/skills/manifest.json

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