@cavuno/board 4.47.0 → 4.48.0

package/dist/seo.d.ts

@@ -1,9 +1,9 @@
-import { P as PublicBlogPostSummary, B as BlogAuthorEmbed } from './blog-wxhB8zAH.js';
-import { e as JsonLdObject } from './breadcrumbs-15j5xvmN.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-15j5xvmN.js';
-import './_spec-DHa5r3B0.js';
-import './board-DHsd92Gy.js';
-import './jobs-CIrTcMjw.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-DHa5r3B0.mjs';
-import './search-DBQApXN1.mjs';
-import './jobs-CMK-DZg3.mjs';
-import './board-Bpze3b50.mjs';
-import './seo-gY8y9RMw.mjs';
-import './blog-DylAbc0L.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-DHa5r3B0.js';
-import './search-666oDd7H.js';
-import './jobs-CIrTcMjw.js';
-import './board-DHsd92Gy.js';
-import './seo-ynqiQmby.js';
-import './blog-wxhB8zAH.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-DHa5r3B0.mjs';
-import './search-DBQApXN1.mjs';
-import './jobs-CMK-DZg3.mjs';
-import './board-Bpze3b50.mjs';
-import './seo-gY8y9RMw.mjs';
-import './blog-DylAbc0L.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-DHa5r3B0.js';
-import './search-666oDd7H.js';
-import './jobs-CIrTcMjw.js';
-import './board-DHsd92Gy.js';
-import './seo-ynqiQmby.js';
-import './blog-wxhB8zAH.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-DBQApXN1.mjs';
-import './_spec-DHa5r3B0.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-666oDd7H.js';
-import './_spec-DHa5r3B0.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.47.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

@@ -44,6 +44,29 @@ Only `jobFunctions`, `placeSlugs`, and `remoteOptions` filter digest delivery. S
 
 `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:
@@ -94,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.47.0",
+  "version": "4.48.0",
   "skills": [
     {
       "name": "cavuno-board-account",