@cavuno/board 4.45.0 → 4.48.0

package/dist/index.mjs

@@ -46,7 +46,7 @@ function toSearchParams(query) {
 }
 
 // src/version.ts
-var SDK_VERSION = "4.45.0";
+var SDK_VERSION = "4.48.0";
 
 // src/client.ts
 function isRawBody(body) {
@@ -2134,11 +2134,15 @@ function meNamespace(client) {
       },
       /**
        * 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.
+       * named filters and saved people (`members`), with no size limit.
+       * Approved members share the same lists. Optional `job` links a list
+       * to one company job, and a job has at most one list; pass
+       * `job: null` on update to unlink. Saving to a linked list is how a
+       * sourced candidate is shortlisted onto the job, and removing takes
+       * them off while they are still at Shortlisted, so the list and the
+       * job agree. Linking a list shortlists everyone saved to it, saves the
+       * sourced people already on the job, and folds in the job's previous
+       * list. Unlinking changes neither side.
        */
       talentLists: {
         /**
@@ -2210,13 +2214,15 @@ function meNamespace(client) {
           );
         },
         /**
-         * People saved to a talent list (at most 500 per list).
+         * People saved to a talent list. A list has no size limit.
          */
         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
+           * List the people saved to a list as directory cards, in the
+           * public directory's order: best match first with a keyword
+           * (`q`), otherwise by `sort` or the directory's default order. A
+           * save or removal shows here within seconds; `memberCount` is
+           * immediate. 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
@@ -2245,8 +2251,9 @@ function meNamespace(client) {
            * 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).
+           * already have a pipeline row there; this is the way to shortlist
+           * a sourced candidate. Lists have no size limit, so
+           * `talent_list_full` is never raised.
            *
            * @example
            * await board.me.companies.talentLists.members.add('acme', listId, {
@@ -2262,8 +2269,11 @@ function meNamespace(client) {
             );
           },
           /**
-           * Remove a candidate from a list. Idempotent. Never changes a job
-           * pipeline, including the linked job's.
+           * Remove a candidate from a list. Idempotent. On a list linked to
+           * a job, also removes their pipeline row on that job while it is a
+           * sourced row still at Shortlisted; anyone further along, or who
+           * applied, keeps it (end that with a rejection). An unlinked list
+           * changes no pipeline.
            */
           remove(slug, listId, candidateBoardUserId, options) {
             return client.fetch(
@@ -2279,15 +2289,21 @@ function meNamespace(client) {
       },
       /**
        * Per-job sourced membership — the unstaged kanban rail.
-       * Saving a candidate always writes here. Convert-on-drop creates a
-       * pipeline application with source `sourced` (hidden from the
-       * candidate until they apply themselves).
+       *
+       * @deprecated A job's sourced people are the people saved to its
+       * talent list. Use `talentLists.members` on the list whose `jobId` is
+       * the job: `add` shortlists, `remove` takes them off, and `list` with
+       * `stage` reads pipeline columns. `add` and `remove` here forward to
+       * those calls.
        */
       sourcedCandidates: {
         /**
          * List sourced candidates still on the rail for a job. Anyone who
          * already has a pipeline application for that job is omitted.
          *
+         * @deprecated Use `talentLists.members.list` on the job's talent
+         * list.
+         *
          * @example
          * const { data } = await board.me.companies.sourcedCandidates.list(
          *   'acme',
@@ -2302,7 +2318,12 @@ function meNamespace(client) {
         },
         /**
          * Save a candidate onto a job's sourced rail. Idempotent: a second
-         * add for the same pair returns `created: false`.
+         * add for the same pair returns `created: false`. Saves them to the
+         * job's talent list (created, named after the job, when it has
+         * none) and shortlists them onto the job.
+         *
+         * @deprecated Use `talentLists.members.add` on the job's talent
+         * list.
          *
          * @example
          * const saved = await board.me.companies.sourcedCandidates.add(
@@ -2317,7 +2338,14 @@ function meNamespace(client) {
             body
           });
         },
-        /** Remove a sourced membership. Does not touch pipeline applications. */
+        /**
+         * Remove a sourced membership: the candidate leaves the job's talent
+         * list, and their pipeline row on the job goes too while it is a
+         * sourced row still at Shortlisted.
+         *
+         * @deprecated Use `talentLists.members.remove` on the job's talent
+         * list.
+         */
         remove(slug, sourcedId, options) {
           return client.fetch(
             `/me/companies/${encodeURIComponent(
@@ -2333,6 +2361,9 @@ function meNamespace(client) {
          * `review`. A board without a native pipeline raises
          * `sourced_convert_unavailable` (409).
          *
+         * @deprecated Saving to the job's talent list already shortlists
+         * the candidate; move them on the pipeline from there.
+         *
          * @example
          * const result = await board.me.companies.sourcedCandidates.convert(
          *   'acme',
@@ -3533,9 +3564,10 @@ function talentNamespace(client) {
        * first, each with how many candidates the caller can see there (a
        * country counts every candidate in its cities). Anonymous callers get
        * counts of `public` profiles; a signed-in board user also counts
-       * `logged_in_only` ones. Pass a place's `slug` as `talent.list`'s
-       * `place` filter. With `q`, returns location search matches instead,
-       * ranked as `taxonomy.places.list` ranks them.
+       * `logged_in_only` ones. Pass a place's `slug` (or its board-language
+       * `canonicalSlug`) as `talent.list`'s `place` filter, and show its
+       * board-language `displayName`. With `q`, returns location search
+       * matches instead, ranked as `taxonomy.places.list` ranks them.
        *
        * Same access errors as `talent.list`. Returns an empty list until the
        * board's place counts are built.
@@ -3603,7 +3635,9 @@ function taxonomyNamespace(client) {
       /**
        * Without `query`: list every place used by a published job, with its
        * live job count (the locations directory). With `query.q` (≥2 chars):
-       * location autocomplete — the top name matches ranked.
+       * location autocomplete — the top name matches ranked. Each place
+       * carries its board-language `displayName` and `canonicalSlug`; link
+       * with `canonicalSlug`.
        */
       list(query, options) {
         return client.fetch("/places", {

package/dist/{jobs-D9ERWWda.d.mts → jobs-oSTStcbC.d.mts}

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

package/dist/{jobs-C7UvN_dW.d.ts → jobs-rnatMRvm.d.ts}

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

package/dist/paths.d.mts

@@ -134,6 +134,11 @@ declare function blogAuthorPath(authorSlug: string): string;
  * Only the handle is encoded.
  */
 declare function talentProfilePath(handle: string): string;
+/**
+ * Talent location page (`/talent/locations/<place>`): the candidates who live
+ * in a place. Pass the place's `canonicalSlug` from the talent place list.
+ */
+declare function talentLocationPath(placeSlug: string): string;
 /**
  * Static top-level board paths (indexed marketing + index surfaces). Kept
  * here so the sitemap and consumers share one definition of the chrome
@@ -155,6 +160,7 @@ declare const BOARD_PATHS: {
     readonly cookiePolicy: "/cookie-policy";
     readonly impressum: "/impressum";
     readonly talent: "/talent";
+    readonly talentLocations: "/talent/locations";
     readonly employers: "/employers";
     /**
      * Alert-email surfaces. Promoted out of raw literals in
@@ -188,4 +194,4 @@ declare function goAlertsConfirmPath(): string;
  */
 declare function boardUrl(origin: string, path: string): string;
 
-export { BOARD_PATHS, type SuggestionPathInput, type SuggestionPathOptions, type SuggestionPathScope, blogAuthorPath, blogPostPath, blogTagPath, boardUrl, companyMarketPath, companyPath, companySalaryPath, encodePathSegment, goAlertsConfirmPath, goAlertsManagePath, goJobPath, jobDetailPath, jobsCategoryPath, jobsLocationCategoryPath, jobsLocationPath, jobsLocationSkillPath, jobsSkillPath, salaryLocationPath, salarySkillPath, salaryTitlePath, suggestionPath, talentProfilePath };
+export { BOARD_PATHS, type SuggestionPathInput, type SuggestionPathOptions, type SuggestionPathScope, blogAuthorPath, blogPostPath, blogTagPath, boardUrl, companyMarketPath, companyPath, companySalaryPath, encodePathSegment, goAlertsConfirmPath, goAlertsManagePath, goJobPath, jobDetailPath, jobsCategoryPath, jobsLocationCategoryPath, jobsLocationPath, jobsLocationSkillPath, jobsSkillPath, salaryLocationPath, salarySkillPath, salaryTitlePath, suggestionPath, talentLocationPath, talentProfilePath };

package/dist/paths.d.ts

@@ -134,6 +134,11 @@ declare function blogAuthorPath(authorSlug: string): string;
  * Only the handle is encoded.
  */
 declare function talentProfilePath(handle: string): string;
+/**
+ * Talent location page (`/talent/locations/<place>`): the candidates who live
+ * in a place. Pass the place's `canonicalSlug` from the talent place list.
+ */
+declare function talentLocationPath(placeSlug: string): string;
 /**
  * Static top-level board paths (indexed marketing + index surfaces). Kept
  * here so the sitemap and consumers share one definition of the chrome
@@ -155,6 +160,7 @@ declare const BOARD_PATHS: {
     readonly cookiePolicy: "/cookie-policy";
     readonly impressum: "/impressum";
     readonly talent: "/talent";
+    readonly talentLocations: "/talent/locations";
     readonly employers: "/employers";
     /**
      * Alert-email surfaces. Promoted out of raw literals in
@@ -188,4 +194,4 @@ declare function goAlertsConfirmPath(): string;
  */
 declare function boardUrl(origin: string, path: string): string;
 
-export { BOARD_PATHS, type SuggestionPathInput, type SuggestionPathOptions, type SuggestionPathScope, blogAuthorPath, blogPostPath, blogTagPath, boardUrl, companyMarketPath, companyPath, companySalaryPath, encodePathSegment, goAlertsConfirmPath, goAlertsManagePath, goJobPath, jobDetailPath, jobsCategoryPath, jobsLocationCategoryPath, jobsLocationPath, jobsLocationSkillPath, jobsSkillPath, salaryLocationPath, salarySkillPath, salaryTitlePath, suggestionPath, talentProfilePath };
+export { BOARD_PATHS, type SuggestionPathInput, type SuggestionPathOptions, type SuggestionPathScope, blogAuthorPath, blogPostPath, blogTagPath, boardUrl, companyMarketPath, companyPath, companySalaryPath, encodePathSegment, goAlertsConfirmPath, goAlertsManagePath, goJobPath, jobDetailPath, jobsCategoryPath, jobsLocationCategoryPath, jobsLocationPath, jobsLocationSkillPath, jobsSkillPath, salaryLocationPath, salarySkillPath, salaryTitlePath, suggestionPath, talentLocationPath, talentProfilePath };

package/dist/paths.js

@@ -42,6 +42,7 @@ __export(paths_exports, {
   salarySkillPath: () => salarySkillPath,
   salaryTitlePath: () => salaryTitlePath,
   suggestionPath: () => suggestionPath,
+  talentLocationPath: () => talentLocationPath,
   talentProfilePath: () => talentProfilePath
 });
 module.exports = __toCommonJS(paths_exports);
@@ -131,6 +132,9 @@ function blogAuthorPath(authorSlug) {
 function talentProfilePath(handle) {
   return `/p/${encodePathSegment(handle)}`;
 }
+function talentLocationPath(placeSlug) {
+  return `/talent/locations/${encodePathSegment(placeSlug)}`;
+}
 var BOARD_PATHS = {
   home: "/",
   jobs: "/jobs",
@@ -147,6 +151,7 @@ var BOARD_PATHS = {
   cookiePolicy: "/cookie-policy",
   impressum: "/impressum",
   talent: "/talent",
+  talentLocations: "/talent/locations",
   employers: "/employers",
   /**
    * Alert-email surfaces. Promoted out of raw literals in

package/dist/paths.mjs

@@ -21,8 +21,9 @@ import {
   salarySkillPath,
   salaryTitlePath,
   suggestionPath,
+  talentLocationPath,
   talentProfilePath
-} from "./chunk-XXQCESMU.mjs";
+} from "./chunk-JFDWTTOQ.mjs";
 export {
   BOARD_PATHS,
   blogAuthorPath,
@@ -46,5 +47,6 @@ export {
   salarySkillPath,
   salaryTitlePath,
   suggestionPath,
+  talentLocationPath,
   talentProfilePath
 };

package/dist/route-contract.js

@@ -119,6 +119,7 @@ var BOARD_PATHS = {
   cookiePolicy: "/cookie-policy",
   impressum: "/impressum",
   talent: "/talent",
+  talentLocations: "/talent/locations",
   employers: "/employers",
   /**
    * Alert-email surfaces. Promoted out of raw literals in

package/dist/route-contract.mjs

@@ -26,8 +26,8 @@ import {
   parseTanStackRoutes,
   sameParamSet,
   validateManifest
-} from "./chunk-5KCWHENV.mjs";
-import "./chunk-XXQCESMU.mjs";
+} from "./chunk-2KD2CWFL.mjs";
+import "./chunk-JFDWTTOQ.mjs";
 export {
   ALL_ROLES,
   CANONICAL_MANIFEST,

package/dist/{search-D0TFnn1x.d.ts → search-CKvtGE6t.d.ts}

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

package/dist/{search-BMSNK85o.d.mts → search-uiAE7AFt.d.mts}

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

package/dist/{seo-CYmVKHsu.d.ts → seo-C2WvBFEi.d.ts}

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

package/dist/{seo-C3WmgifR.d.mts → seo-Cz0544dX.d.mts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-CdNZDaaR.mjs';
+import { S as Schemas } from './_spec-Fw9b79TI.mjs';
 
 /**
  * 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-C3WmgifR.mjs';
-import './_spec-CdNZDaaR.mjs';
+import { B as BoardSeo } from './seo-Cz0544dX.mjs';
+import './_spec-Fw9b79TI.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-CYmVKHsu.js';
-import './_spec-CdNZDaaR.js';
+import { B as BoardSeo } from './seo-C2WvBFEi.js';
+import './_spec-Fw9b79TI.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-uV51b4Cg.mjs';
-import { e as JsonLdObject } from './breadcrumbs-BY1UMCbL.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-BY1UMCbL.mjs';
-import './_spec-CdNZDaaR.mjs';
-import './board-CJw-MJpf.mjs';
-import './jobs-D9ERWWda.mjs';
+import { P as PublicBlogPostSummary, B as BlogAuthorEmbed } from './blog-Dlyky5Eo.mjs';
+import { e as JsonLdObject } from './breadcrumbs-Bj8SieZi.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-Bj8SieZi.mjs';
+import './_spec-Fw9b79TI.mjs';
+import './board-DkwbMZdt.mjs';
+import './jobs-oSTStcbC.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-ZvLJ6w1Q.js';
-import { e as JsonLdObject } from './breadcrumbs-CXvdv6Ry.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-CXvdv6Ry.js';
-import './_spec-CdNZDaaR.js';
-import './board-3JU14eF3.js';
-import './jobs-C7UvN_dW.js';
+import { P as PublicBlogPostSummary, B as BlogAuthorEmbed } from './blog-DldIXX6n.js';
+import { e as JsonLdObject } from './breadcrumbs-CzFiddAt.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-CzFiddAt.js';
+import './_spec-Fw9b79TI.js';
+import './board-B1Ueww2w.js';
+import './jobs-rnatMRvm.js';
 
 /**
  * Blog structured data on the `@cavuno/board` wire types, transcribed from

package/dist/seo.js

@@ -199,6 +199,7 @@ var BOARD_PATHS = {
   cookiePolicy: "/cookie-policy",
   impressum: "/impressum",
   talent: "/talent",
+  talentLocations: "/talent/locations",
   employers: "/employers",
   /**
    * Alert-email surfaces. Promoted out of raw literals in
@@ -262,11 +263,11 @@ function buildJobBreadcrumbs(job) {
   ];
   let lastPlaceSlug = null;
   for (const place of job.placeHierarchy) {
-    lastPlaceSlug = place.slug;
+    lastPlaceSlug = place.canonicalSlug;
     crumbs.push({
       kind: "place",
       name: place.name,
-      path: jobsLocationPath(place.slug)
+      path: jobsLocationPath(place.canonicalSlug)
     });
   }
   const primaryCategory = job.categories[0];

package/dist/seo.mjs

@@ -17,11 +17,11 @@ import {
   skillSalaryJsonLd,
   sortBySeniority,
   titleSalaryJsonLd
-} from "./chunk-KDFKVWTZ.mjs";
+} from "./chunk-JTFUOGWE.mjs";
 import {
   boardUrl,
   jobDetailPath
-} from "./chunk-XXQCESMU.mjs";
+} from "./chunk-JFDWTTOQ.mjs";
 
 // src/seo/blog.ts
 function createBlogArticleJsonLd({

package/dist/server.d.mts

@@ -1,10 +1,10 @@
 import { BoardSdk } from './index.mjs';
-import './_spec-CdNZDaaR.mjs';
-import './search-BMSNK85o.mjs';
-import './jobs-D9ERWWda.mjs';
-import './board-CJw-MJpf.mjs';
-import './seo-C3WmgifR.mjs';
-import './blog-uV51b4Cg.mjs';
+import './_spec-Fw9b79TI.mjs';
+import './search-uiAE7AFt.mjs';
+import './jobs-oSTStcbC.mjs';
+import './board-DkwbMZdt.mjs';
+import './seo-Cz0544dX.mjs';
+import './blog-Dlyky5Eo.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-CdNZDaaR.js';
-import './search-D0TFnn1x.js';
-import './jobs-C7UvN_dW.js';
-import './board-3JU14eF3.js';
-import './seo-CYmVKHsu.js';
-import './blog-ZvLJ6w1Q.js';
+import './_spec-Fw9b79TI.js';
+import './search-CKvtGE6t.js';
+import './jobs-rnatMRvm.js';
+import './board-B1Ueww2w.js';
+import './seo-C2WvBFEi.js';
+import './blog-DldIXX6n.js';
 
 /**
  * Session cookie codec — pure (no framework imports, no node imports) so it

package/dist/sitemap.d.mts

@@ -1,10 +1,10 @@
 import { BoardSdk } from './index.mjs';
-import './_spec-CdNZDaaR.mjs';
-import './search-BMSNK85o.mjs';
-import './jobs-D9ERWWda.mjs';
-import './board-CJw-MJpf.mjs';
-import './seo-C3WmgifR.mjs';
-import './blog-uV51b4Cg.mjs';
+import './_spec-Fw9b79TI.mjs';
+import './search-uiAE7AFt.mjs';
+import './jobs-oSTStcbC.mjs';
+import './board-DkwbMZdt.mjs';
+import './seo-Cz0544dX.mjs';
+import './blog-Dlyky5Eo.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-CdNZDaaR.js';
-import './search-D0TFnn1x.js';
-import './jobs-C7UvN_dW.js';
-import './board-3JU14eF3.js';
-import './seo-CYmVKHsu.js';
-import './blog-ZvLJ6w1Q.js';
+import './_spec-Fw9b79TI.js';
+import './search-CKvtGE6t.js';
+import './jobs-rnatMRvm.js';
+import './board-B1Ueww2w.js';
+import './seo-C2WvBFEi.js';
+import './blog-DldIXX6n.js';
 
 /**
  * Sitemap primitives — the pure XML + bucket-filename logic behind a board

package/dist/sitemap.js

@@ -240,6 +240,7 @@ var BOARD_PATHS = {
   cookiePolicy: "/cookie-policy",
   impressum: "/impressum",
   talent: "/talent",
+  talentLocations: "/talent/locations",
   employers: "/employers",
   /**
    * Alert-email surfaces. Promoted out of raw literals in

package/dist/sitemap.mjs

@@ -19,7 +19,7 @@ import {
   salaryLocationPath,
   salarySkillPath,
   salaryTitlePath
-} from "./chunk-XXQCESMU.mjs";
+} from "./chunk-JFDWTTOQ.mjs";
 
 // src/sitemap/xml.ts
 var SITEMAP_BUCKETS = [

package/dist/suggest.d.mts

@@ -1,5 +1,5 @@
-import { h as SuggestionItem, b as SearchSuggestQuery, F as FetchOptions, g as SuggestResult } from './search-BMSNK85o.mjs';
-import './_spec-CdNZDaaR.mjs';
+import { h as SuggestionItem, b as SearchSuggestQuery, F as FetchOptions, g as SuggestResult } from './search-uiAE7AFt.mjs';
+import './_spec-Fw9b79TI.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-D0TFnn1x.js';
-import './_spec-CdNZDaaR.js';
+import { h as SuggestionItem, b as SearchSuggestQuery, F as FetchOptions, g as SuggestResult } from './search-CKvtGE6t.js';
+import './_spec-Fw9b79TI.js';
 
 /**
  * `@cavuno/board/suggest` — framework-agnostic headless search-suggest

package/dist/well-known.js

@@ -100,6 +100,7 @@ var BOARD_PATHS = {
   cookiePolicy: "/cookie-policy",
   impressum: "/impressum",
   talent: "/talent",
+  talentLocations: "/talent/locations",
   employers: "/employers",
   /**
    * Alert-email surfaces. Promoted out of raw literals in

package/dist/well-known.mjs

@@ -1,7 +1,7 @@
 import {
   compileManifest
-} from "./chunk-5KCWHENV.mjs";
-import "./chunk-XXQCESMU.mjs";
+} from "./chunk-2KD2CWFL.mjs";
+import "./chunk-JFDWTTOQ.mjs";
 
 // src/well-known/handler.ts
 var WELL_KNOWN_CACHE_CONTROL = "public, max-age=300";

package/package.json

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

package/skills/cavuno-board-job-alerts/SKILL.md

@@ -42,6 +42,31 @@ switch (result.status) {
 
 Only `jobFunctions`, `placeSlugs`, and `remoteOptions` filter digest delivery. Seniority and salary fields are stored but do not scope delivery. The supported cadence is `weekly`.
 
+`jobFunctions` are category and skill slugs (the `slug` of a category or skill, such as `engineering` or `media-and-communication`). A digest matches a job when any entry equals one of the job's category or skill slugs. Prefer sending slugs. If you send display names or free-text keywords instead, the server slugifies each one when the alert is saved and matches it against the board's category and skill slugs, their aliases, and their board-language slugs. A display name that does not slugify to one of those (for example, a renamed category) is stored slugified and will not match, so send slugs whenever you have them. Alerts read back from the API therefore always carry slugs, so compare and display them as slugs.
+
+## Alert kinds, keywords, and anchor jobs
+
+Every alert read back from either lane carries a read-only `kind`:
+
+- `similar_job`: jobs similar to the job the visitor subscribed from. Subscribe from a job page with `context: { source: 'job_detail', jobId }` (or `job_apply_dialog`). `anchorJob` is that job as `{ id, slug, title }`, kept after the job closes. It is `null` for other kinds, and for an older similar-job alert whose job has not been captured yet.
+- `search`: a board search for the alert's keywords, in `filters.query`. An older search alert can report `kind: 'search'` with `filters.query` `null`: its keyword is the single `jobFunctions` entry. When `query` is `null`, show the job functions as the alert's search instead.
+- `filters`: jobs matching the stored filters exactly.
+
+Send the query a search page ran as `filters.query` (on `board.me.alerts`, the top-level `query`), at most 200 characters after trimming. Keep sending the location and other filters alongside it.
+
+```ts snippet
+await board.jobAlerts.subscribe({
+  email: 'ada@example.com',
+  consent: true,
+  filters: { query: 'Python developer', placeSlugs: ['berlin'] },
+  context: { source: 'jobs_list' },
+});
+```
+
+A sent `query` is stored as given (trimmed), so `front-end` reads back as `front-end`. A job-page `context` without a `jobId` cannot anchor a similar-job alert; with a `query` it makes a `search` alert. A client that predates `query` and sends the search keyword as its single `jobFunctions` entry, with a search-page `context.source`, still works: the server keeps that keyword as the alert's `query`.
+
+On an update, `null` clears `query`, and omitting it keeps the stored keywords as long as `jobFunctions` are unchanged. An update never changes `kind`, except that giving a `filters` alert a `query` makes it a `search` alert. A `similar_job` alert takes no `query`: sending one, on subscribe with a job-page `context` or on an update, fails with `validation_bad_request` (400). To follow keywords instead, remove the similar-job alert and create a search alert. In alert lists, show the kind and, for similar-job alerts, link the anchor job.
+
 ## Anonymous lane: manage-token transport
 
 The read and write transports intentionally use different keys:
@@ -92,16 +117,19 @@ const { data: alerts } = await board.me.alerts.list();
 alerts[0]?.isActive;
 alerts[0]?.lastSentAt;
 alerts[0]?.filters;
+alerts[0]?.kind;
+alerts[0]?.anchorJob;
 
 const alert = await board.me.alerts.create({
   frequency: 'weekly',
-  jobFunctions: ['engineering'],
+  query: 'Platform engineer',
   remoteOptions: ['remote'],
 });
 
 const current = await board.me.alerts.retrieve(alert.id);
 await board.me.alerts.update(alert.id, {
   frequency: 'weekly',
+  query: current.filters.query,
   jobFunctions: current.filters.jobFunctions,
   seniorityLevels: current.filters.seniorityLevels,
   remoteOptions: current.filters.remoteOptions,

package/skills/cavuno-board-talent-access/SKILL.md

@@ -130,6 +130,8 @@ await board.me.conversations.start({
 
 Named `/p/{handle}` is the share bypass and always shows a full `public` profile. Opaque `/p/{id}` is the unlock-gated route. When `accessModel === 'paid_unlocks_and_messaging'`, directory cards redact for viewers who are not unlimited.
 
+`lastActive` on directory cards and profiles is a coarse bucket (`today`, `this_week`, `this_month`, `last_3_months`, `over_3_months`) for a signed-in employer looking at a candidate who is actively looking or open to offers, and `null` otherwise. It stays on redacted cards. Render it as a short label such as "Active this week" and hide it when `null`.
+
 ```ts snippet
 const named = await board.talent.retrieve('jane-doe');
 const opaque = await board.talent.retrieve('bu_candidate');

package/skills/manifest.json

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