@cavuno/board 3.2.0 → 4.0.0

package/dist/seo.mjs

@@ -9,17 +9,19 @@ import {
   createJobPostingJsonLd,
   crossAxisSalaryJsonLd,
   faqJsonLd,
-  formatRange,
-  formatSeniority,
-  formatUsd,
+  formatSalaryStat,
+  formatSalaryStatRange,
   itemListJsonLd,
   locationSalaryJsonLd,
   normalizeWebsiteUrl,
   skillSalaryJsonLd,
   sortBySeniority,
   titleSalaryJsonLd
-} from "./chunk-STE77MAT.mjs";
-import "./chunk-IJCJ26SQ.mjs";
+} from "./chunk-YEAQ3JEI.mjs";
+import {
+  boardUrl,
+  jobDetailPath
+} from "./chunk-BGKNXG4H.mjs";
 
 // src/seo/blog.ts
 function createBlogArticleJsonLd({
@@ -138,9 +140,8 @@ function buildAbsoluteUrl(origin, path) {
 
 // src/seo/listing.ts
 function listingHead(options) {
-  const countPrefix = typeof options.count === "number" ? `${options.language ? new Intl.NumberFormat(options.language).format(options.count) : options.count} ` : "";
-  const title = `${countPrefix}${options.heading} | ${options.boardName}`;
-  const description = `Browse ${countPrefix}${options.heading.toLowerCase()} on ${options.boardName}.`;
+  const title = options.title;
+  const description = options.description;
   const url = `${options.origin}${options.path}`;
   return {
     meta: [
@@ -155,31 +156,33 @@ function listingHead(options) {
   };
 }
 function listingJsonLd(options) {
-  const jobUrl = (job) => job.company ? `${options.origin}/companies/${job.company.slug}/jobs/${job.slug}` : `${options.origin}/jobs/${job.slug}`;
-  const objects = [
-    {
+  const objects = [];
+  if (options.breadcrumbs.length >= 2) {
+    objects.push({
       "@context": "https://schema.org",
-      // Deliberately NOT createBreadcrumbJsonLd (breadcrumbs.ts): listing trails
-      // are code-constructed (never user copy), so the hosted listing page skips
-      // the trim/drop-blank/min-2 gate that module transcribes. Same schema.org
-      // fragment, different (intentional) semantics — do not unify blindly.
       "@type": "BreadcrumbList",
       itemListElement: options.breadcrumbs.map((crumb, index) => ({
         "@type": "ListItem",
         position: index + 1,
         name: crumb.name,
-        ...crumb.path ? { item: `${options.origin}${crumb.path}` } : {}
+        ...crumb.path ? { item: boardUrl(options.origin, crumb.path) } : {}
       }))
-    }
-  ];
-  if (options.jobs && options.jobs.length > 0) {
+    });
+  }
+  const detailJobs = (options.jobs ?? []).filter(
+    (job) => job.company != null && Boolean(job.company.slug)
+  );
+  if (detailJobs.length > 0) {
     objects.push({
       "@context": "https://schema.org",
       "@type": "ItemList",
-      itemListElement: options.jobs.map((job, index) => ({
+      itemListElement: detailJobs.map((job, index) => ({
         "@type": "ListItem",
         position: index + 1,
-        url: jobUrl(job)
+        url: boardUrl(
+          options.origin,
+          jobDetailPath(job.company.slug, job.slug)
+        )
       }))
     });
   }
@@ -198,9 +201,8 @@ export {
   createJobPostingJsonLd,
   crossAxisSalaryJsonLd,
   faqJsonLd,
-  formatRange,
-  formatSeniority,
-  formatUsd,
+  formatSalaryStat,
+  formatSalaryStatRange,
   itemListJsonLd,
   listingHead,
   listingJsonLd,

package/dist/server.d.mts

@@ -1,9 +1,9 @@
 import { BoardSdk } from './index.mjs';
-import './_spec-nkWAraS0.mjs';
-import './search-CCyFWPi3.mjs';
-import './board-BJbXd_9_.mjs';
-import './jobs-lVvKCBCU.mjs';
-import './blog-DGBHmExV.mjs';
+import './_spec-GVe6WAfT.mjs';
+import './search-Cr4noJJZ.mjs';
+import './board-GGWJ4coe.mjs';
+import './jobs-BuLpV8iy.mjs';
+import './blog-Cf64mI8A.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-nkWAraS0.js';
-import './search-CyRvVMUp.js';
-import './board-JhdUWIoq.js';
-import './jobs-BiEvL9d7.js';
-import './blog-iV9XEIGf.js';
+import './_spec-GVe6WAfT.js';
+import './search-DdsniXQv.js';
+import './board-DUhgiacm.js';
+import './jobs-QrbXOYB9.js';
+import './blog-BsmKizpd.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-nkWAraS0.mjs';
-import './search-CCyFWPi3.mjs';
-import './board-BJbXd_9_.mjs';
-import './jobs-lVvKCBCU.mjs';
-import './blog-DGBHmExV.mjs';
+import './_spec-GVe6WAfT.mjs';
+import './search-Cr4noJJZ.mjs';
+import './board-GGWJ4coe.mjs';
+import './jobs-BuLpV8iy.mjs';
+import './blog-Cf64mI8A.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-nkWAraS0.js';
-import './search-CyRvVMUp.js';
-import './board-JhdUWIoq.js';
-import './jobs-BiEvL9d7.js';
-import './blog-iV9XEIGf.js';
+import './_spec-GVe6WAfT.js';
+import './search-DdsniXQv.js';
+import './board-DUhgiacm.js';
+import './jobs-QrbXOYB9.js';
+import './blog-BsmKizpd.js';
 
 /**
  * Sitemap primitives — the pure XML + bucket-filename logic behind a board

package/dist/sitemap.js

@@ -165,44 +165,54 @@ function paginate(listFn, query, options) {
 }
 
 // src/paths/index.ts
+function encodePathSegment(segment) {
+  try {
+    return encodeURIComponent(decodeURIComponent(segment)).replace(
+      /%3A/gi,
+      ":"
+    );
+  } catch {
+    return encodeURIComponent(segment).replace(/%3A/gi, ":");
+  }
+}
 function jobDetailPath(companySlug, jobSlug) {
-  return `/companies/${companySlug}/jobs/${jobSlug}`;
+  return `/companies/${encodePathSegment(companySlug)}/jobs/${encodePathSegment(jobSlug)}`;
 }
 function jobsCategoryPath(categorySlug) {
-  return `/jobs/${categorySlug}`;
+  return `/jobs/${encodePathSegment(categorySlug)}`;
 }
 function jobsSkillPath(skillSlug) {
-  return `/jobs/skills/${skillSlug}`;
+  return `/jobs/skills/${encodePathSegment(skillSlug)}`;
 }
 function jobsLocationPath(placeSlug) {
-  return `/jobs/locations/${placeSlug}`;
+  return `/jobs/locations/${encodePathSegment(placeSlug)}`;
 }
 function companyPath(companySlug) {
-  return `/companies/${companySlug}`;
+  return `/companies/${encodePathSegment(companySlug)}`;
 }
 function companyMarketPath(marketSlug) {
-  return `/companies/markets/${marketSlug}`;
+  return `/companies/markets/${encodePathSegment(marketSlug)}`;
 }
 function companySalaryPath(companySlug) {
-  return `/companies/${companySlug}/salaries`;
+  return `/companies/${encodePathSegment(companySlug)}/salaries`;
 }
 function salaryTitlePath(titleSlug) {
-  return `/salaries/titles/${titleSlug}`;
+  return `/salaries/titles/${encodePathSegment(titleSlug)}`;
 }
 function salarySkillPath(skillSlug) {
-  return `/salaries/skills/${skillSlug}`;
+  return `/salaries/skills/${encodePathSegment(skillSlug)}`;
 }
 function salaryLocationPath(placeSlug) {
-  return `/salaries/locations/${placeSlug}`;
+  return `/salaries/locations/${encodePathSegment(placeSlug)}`;
 }
 function blogPostPath(postSlug) {
-  return `/blog/${postSlug}`;
+  return `/blog/${encodePathSegment(postSlug)}`;
 }
 function blogTagPath(tagSlug) {
-  return `/blog/tag/${tagSlug}`;
+  return `/blog/tag/${encodePathSegment(tagSlug)}`;
 }
 function blogAuthorPath(authorSlug) {
-  return `/blog/author/${authorSlug}`;
+  return `/blog/author/${encodePathSegment(authorSlug)}`;
 }
 var BOARD_PATHS = {
   home: "/",
@@ -320,7 +330,8 @@ async function marketing(board, origin) {
     `${origin}${BOARD_PATHS.cookiePolicy}`
   ];
   if (features.impressum) urls.push(`${origin}${BOARD_PATHS.impressum}`);
-  if (features.talentDirectory) urls.push(`${origin}${BOARD_PATHS.talent}`);
+  if (features.talentDirectory === "public")
+    urls.push(`${origin}${BOARD_PATHS.talent}`);
   if (features.employers) urls.push(`${origin}${BOARD_PATHS.employers}`);
   return urls;
 }

package/dist/sitemap.mjs

@@ -16,7 +16,7 @@ import {
   salaryLocationPath,
   salarySkillPath,
   salaryTitlePath
-} from "./chunk-L7ZOYWHW.mjs";
+} from "./chunk-BGKNXG4H.mjs";
 
 // src/sitemap/xml.ts
 var SITEMAP_BUCKETS = [
@@ -208,7 +208,8 @@ async function marketing(board, origin) {
     `${origin}${BOARD_PATHS.cookiePolicy}`
   ];
   if (features.impressum) urls.push(`${origin}${BOARD_PATHS.impressum}`);
-  if (features.talentDirectory) urls.push(`${origin}${BOARD_PATHS.talent}`);
+  if (features.talentDirectory === "public")
+    urls.push(`${origin}${BOARD_PATHS.talent}`);
   if (features.employers) urls.push(`${origin}${BOARD_PATHS.employers}`);
   return urls;
 }

package/dist/skills.js

@@ -57,7 +57,7 @@ function loadSkillCorpus(baseDir) {
       ).map((entry) => ({
         path: entry.name,
         content: (0, import_node_fs.readFileSync)((0, import_node_path.resolve)(skillDir, entry.name), "utf8")
-      })).sort((a, b) => a.path.localeCompare(b.path));
+      })).sort((a, b) => a.path < b.path ? -1 : a.path > b.path ? 1 : 0);
       return {
         ...skill,
         content: (0, import_node_fs.readFileSync)(skillPath, "utf8"),

package/dist/skills.mjs

@@ -24,7 +24,7 @@ function loadSkillCorpus(baseDir) {
       ).map((entry) => ({
         path: entry.name,
         content: readFileSync(resolve(skillDir, entry.name), "utf8")
-      })).sort((a, b) => a.path.localeCompare(b.path));
+      })).sort((a, b) => a.path < b.path ? -1 : a.path > b.path ? 1 : 0);
       return {
         ...skill,
         content: readFileSync(skillPath, "utf8"),

package/dist/suggest.d.mts

@@ -1,5 +1,5 @@
-import { g as SuggestionItem, b as SearchSuggestQuery, F as FetchOptions, f as SuggestResult } from './search-CCyFWPi3.mjs';
-import './_spec-nkWAraS0.mjs';
+import { h as SuggestionItem, b as SearchSuggestQuery, F as FetchOptions, g as SuggestResult } from './search-Cr4noJJZ.mjs';
+import './_spec-GVe6WAfT.mjs';
 
 /**
  * `@cavuno/board/suggest` — framework-agnostic headless search-suggest

package/dist/suggest.d.ts

@@ -1,5 +1,5 @@
-import { g as SuggestionItem, b as SearchSuggestQuery, F as FetchOptions, f as SuggestResult } from './search-CyRvVMUp.js';
-import './_spec-nkWAraS0.js';
+import { h as SuggestionItem, b as SearchSuggestQuery, F as FetchOptions, g as SuggestResult } from './search-DdsniXQv.js';
+import './_spec-GVe6WAfT.js';
 
 /**
  * `@cavuno/board/suggest` — framework-agnostic headless search-suggest

package/dist/suggest.js

@@ -28,10 +28,24 @@ var DEFAULT_DEBOUNCE_MS = 250;
 function isAbortError(error) {
   return typeof DOMException !== "undefined" && error instanceof DOMException && error.name === "AbortError" || error instanceof Error && error.name === "AbortError";
 }
+function queryCharCount(query) {
+  try {
+    let n = 0;
+    for (const _ of new Intl.Segmenter(void 0, {
+      granularity: "grapheme"
+    }).segment(query)) {
+      n += 1;
+    }
+    return n;
+  } catch {
+    return [...query].length;
+  }
+}
 function applyExclusions(items, excluded) {
   if (excluded.size === 0) return items.slice();
   return items.filter(
-    (item) => !(item.type === "company" && excluded.has(item.slug.toLowerCase()))
+    (item) => !(item.type === "company" && // NFC + toLowerCase — same keying as setExcludedCompanySlugs.
+    excluded.has(item.slug.toLowerCase().normalize("NFC")))
   );
 }
 function createSuggestController(board, options) {
@@ -104,7 +118,7 @@ function createSuggestController(board, options) {
       if (disposed) return;
       const trimmed = query.trim();
       cancelTimer();
-      if (trimmed.length < minChars) {
+      if (queryCharCount(trimmed) < minChars) {
         sequence += 1;
         abortInFlight();
         rawItems = [];
@@ -133,7 +147,7 @@ function createSuggestController(board, options) {
     setExcludedCompanySlugs(slugs) {
       if (disposed) return;
       excluded = new Set(
-        slugs.map((s) => s.trim().toLowerCase()).filter(Boolean)
+        slugs.map((s) => s.trim().toLowerCase().normalize("NFC")).filter(Boolean)
       );
       setState({
         query: state.query,

package/dist/suggest.mjs

@@ -4,10 +4,24 @@ var DEFAULT_DEBOUNCE_MS = 250;
 function isAbortError(error) {
   return typeof DOMException !== "undefined" && error instanceof DOMException && error.name === "AbortError" || error instanceof Error && error.name === "AbortError";
 }
+function queryCharCount(query) {
+  try {
+    let n = 0;
+    for (const _ of new Intl.Segmenter(void 0, {
+      granularity: "grapheme"
+    }).segment(query)) {
+      n += 1;
+    }
+    return n;
+  } catch {
+    return [...query].length;
+  }
+}
 function applyExclusions(items, excluded) {
   if (excluded.size === 0) return items.slice();
   return items.filter(
-    (item) => !(item.type === "company" && excluded.has(item.slug.toLowerCase()))
+    (item) => !(item.type === "company" && // NFC + toLowerCase — same keying as setExcludedCompanySlugs.
+    excluded.has(item.slug.toLowerCase().normalize("NFC")))
   );
 }
 function createSuggestController(board, options) {
@@ -80,7 +94,7 @@ function createSuggestController(board, options) {
       if (disposed) return;
       const trimmed = query.trim();
       cancelTimer();
-      if (trimmed.length < minChars) {
+      if (queryCharCount(trimmed) < minChars) {
         sequence += 1;
         abortInFlight();
         rawItems = [];
@@ -109,7 +123,7 @@ function createSuggestController(board, options) {
     setExcludedCompanySlugs(slugs) {
       if (disposed) return;
       excluded = new Set(
-        slugs.map((s) => s.trim().toLowerCase()).filter(Boolean)
+        slugs.map((s) => s.trim().toLowerCase().normalize("NFC")).filter(Boolean)
       );
       setState({
         query: state.query,

package/dist/well-known.js

@@ -32,44 +32,54 @@ __export(well_known_exports, {
 module.exports = __toCommonJS(well_known_exports);
 
 // src/paths/index.ts
+function encodePathSegment(segment) {
+  try {
+    return encodeURIComponent(decodeURIComponent(segment)).replace(
+      /%3A/gi,
+      ":"
+    );
+  } catch {
+    return encodeURIComponent(segment).replace(/%3A/gi, ":");
+  }
+}
 function jobDetailPath(companySlug, jobSlug) {
-  return `/companies/${companySlug}/jobs/${jobSlug}`;
+  return `/companies/${encodePathSegment(companySlug)}/jobs/${encodePathSegment(jobSlug)}`;
 }
 function jobsCategoryPath(categorySlug) {
-  return `/jobs/${categorySlug}`;
+  return `/jobs/${encodePathSegment(categorySlug)}`;
 }
 function jobsSkillPath(skillSlug) {
-  return `/jobs/skills/${skillSlug}`;
+  return `/jobs/skills/${encodePathSegment(skillSlug)}`;
 }
 function jobsLocationPath(placeSlug) {
-  return `/jobs/locations/${placeSlug}`;
+  return `/jobs/locations/${encodePathSegment(placeSlug)}`;
 }
 function companyPath(companySlug) {
-  return `/companies/${companySlug}`;
+  return `/companies/${encodePathSegment(companySlug)}`;
 }
 function companyMarketPath(marketSlug) {
-  return `/companies/markets/${marketSlug}`;
+  return `/companies/markets/${encodePathSegment(marketSlug)}`;
 }
 function companySalaryPath(companySlug) {
-  return `/companies/${companySlug}/salaries`;
+  return `/companies/${encodePathSegment(companySlug)}/salaries`;
 }
 function salaryTitlePath(titleSlug) {
-  return `/salaries/titles/${titleSlug}`;
+  return `/salaries/titles/${encodePathSegment(titleSlug)}`;
 }
 function salarySkillPath(skillSlug) {
-  return `/salaries/skills/${skillSlug}`;
+  return `/salaries/skills/${encodePathSegment(skillSlug)}`;
 }
 function salaryLocationPath(placeSlug) {
-  return `/salaries/locations/${placeSlug}`;
+  return `/salaries/locations/${encodePathSegment(placeSlug)}`;
 }
 function blogPostPath(postSlug) {
-  return `/blog/${postSlug}`;
+  return `/blog/${encodePathSegment(postSlug)}`;
 }
 function blogTagPath(tagSlug) {
-  return `/blog/tag/${tagSlug}`;
+  return `/blog/tag/${encodePathSegment(tagSlug)}`;
 }
 function blogAuthorPath(authorSlug) {
-  return `/blog/author/${authorSlug}`;
+  return `/blog/author/${encodePathSegment(authorSlug)}`;
 }
 var BOARD_PATHS = {
   home: "/",

package/dist/well-known.mjs

@@ -1,7 +1,7 @@
 import {
   compileManifest
-} from "./chunk-NXY3OWGF.mjs";
-import "./chunk-L7ZOYWHW.mjs";
+} from "./chunk-T2KC6XGV.mjs";
+import "./chunk-BGKNXG4H.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": "3.2.0",
+  "version": "4.0.0",
   "description": "Build custom job boards and careers pages with Cavuno’s TypeScript SDK.",
   "keywords": [
     "api-client",
@@ -203,9 +203,7 @@
     "clean": "git clean -xdf .turbo dist node_modules src/generated",
     "typecheck": "tsgo --noEmit && tsgo --noEmit -p tsconfig.node.json",
     "test": "vitest run",
-    "check:publish": "publint --strict && attw --pack . --profile node16",
-    "check:surface": "node ../../scripts/check-public-surface.mjs",
-    "gen:surface": "node ../../scripts/check-public-surface.mjs --write",
+    "check:publish": "publint --strict && attw --pack . --profile node16 && node scripts/check-no-private-kit-types.mjs",
     "gen:skills-manifest": "tsx scripts/generate-skills-manifest.ts",
     "assert-publish-target": "node -e \"const p=require('./package.json'); if(p.name!=='@cavuno/board'){throw new Error('Refusing to publish: package.json name is '+p.name+', expected @cavuno/board')}; if(p.private){throw new Error('Refusing to publish: package.json has private:true')}\"",
     "prepublishOnly": "pnpm run assert-publish-target && pnpm run gen:skills-manifest && pnpm run build"

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

@@ -76,7 +76,10 @@ await board.me.applications.withdraw(applicationId);
 
 ## Save jobs
 
-Saved rows embed the full `PublicJob`. `save` converges on the existing row and `unsave` is idempotent.
+Saved rows embed the same slim `PublicJobCard` as the jobs list — render them
+with the same card view-model, and do not expect full-job fields (description,
+custom field values) on saved rows. `save` converges on the existing row and
+`unsave` is idempotent.
 
 ```ts snippet
 const saved = await board.me.savedJobs.list({ limit: 20 });

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

@@ -49,21 +49,19 @@ import {
   JOB_SORTS,
   REMOTE_OPTIONS,
   SENIORITIES,
-  seniorityLabels,
-  sortLabels,
 } from '@cavuno/board/filters';
 
-const { language } = await board.context();
-const seniorityCopy = seniorityLabels(language);
-const sortCopy = sortLabels(language);
+// Wire enums only — display labels are application-owned chrome.
+const seniorityOptions = SENIORITIES;
+const sortOptions = JOB_SORTS;
 ```
 
 Render seniority as a multi-select with all eight `SENIORITIES`.
 `EMPLOYMENT_TYPES` contains five listing options; `volunteer` and `other`
 remain valid job wire values but are absent from the filter control.
 `JOB_SORTS` contains exactly `relevance`, `newest`, and `salary_high`;
-`relevance` is the featured-ranked default. Sort labels follow the board copy
-catalog and operator overrides supplied to `sortLabels`.
+`relevance` is the featured-ranked default. Label each option with your
+application's copy (message catalog or hard-coded board language).
 
 ## Load taxonomy options
 
@@ -95,15 +93,16 @@ const second = first.nextCursor
   : null;
 ```
 
-Keyword suggestions accept `q` and `limit`. A present query shorter than two
-characters returns no results. Suggestions contain categories and skills only;
-because both types may share a slug, key each option by
-`type + canonicalSlug`.
+Keyword suggestions accept `q`, `limit`, and optional `types`. A present query
+shorter than two characters returns no results. Restrict to taxonomy terms with
+`types: ['category', 'skill']`; because both may share a slug, key each option
+by `termType + canonicalSlug`.
 
 ```ts snippet
-const suggestions = await board.taxonomy.suggestions.list({
+const { items } = await board.search.suggest({
   q: searchText,
   limit: 10,
+  types: ['category', 'skill'],
 });
 ```