@cavuno/board 3.1.0 → 4.0.0

package/dist/well-known.mjs

@@ -1,424 +1,7 @@
-// src/paths/index.ts
-function jobDetailPath(companySlug, jobSlug) {
-  return `/companies/${companySlug}/jobs/${jobSlug}`;
-}
-function jobsCategoryPath(categorySlug) {
-  return `/jobs/${categorySlug}`;
-}
-function jobsSkillPath(skillSlug) {
-  return `/jobs/skills/${skillSlug}`;
-}
-function jobsLocationPath(placeSlug) {
-  return `/jobs/locations/${placeSlug}`;
-}
-function companyPath(companySlug) {
-  return `/companies/${companySlug}`;
-}
-function companyMarketPath(marketSlug) {
-  return `/companies/markets/${marketSlug}`;
-}
-function companySalaryPath(companySlug) {
-  return `/companies/${companySlug}/salaries`;
-}
-function salaryTitlePath(titleSlug) {
-  return `/salaries/titles/${titleSlug}`;
-}
-function salarySkillPath(skillSlug) {
-  return `/salaries/skills/${skillSlug}`;
-}
-function salaryLocationPath(placeSlug) {
-  return `/salaries/locations/${placeSlug}`;
-}
-function blogPostPath(postSlug) {
-  return `/blog/${postSlug}`;
-}
-function blogTagPath(tagSlug) {
-  return `/blog/tag/${tagSlug}`;
-}
-function blogAuthorPath(authorSlug) {
-  return `/blog/author/${authorSlug}`;
-}
-var BOARD_PATHS = {
-  home: "/",
-  jobs: "/jobs",
-  companies: "/companies",
-  salaries: "/salaries",
-  salaryCompanies: "/salaries/companies",
-  salaryTitles: "/salaries/titles",
-  salarySkills: "/salaries/skills",
-  salaryLocations: "/salaries/locations",
-  blog: "/blog",
-  about: "/about",
-  privacyPolicy: "/privacy-policy",
-  termsOfService: "/terms-of-service",
-  cookiePolicy: "/cookie-policy",
-  impressum: "/impressum",
-  talent: "/talent",
-  employers: "/employers",
-  /**
-   * Alert-email surfaces. Promoted out of raw literals in
-   * the job-alerts composer so /go indirection and email composition share
-   * one definition.
-   */
-  alertsManage: "/alerts/manage",
-  alertsConfirm: "/alerts/confirm"
-};
-
-// src/route-contract/roles.ts
-var ROLE_PARAM_REGISTRY = {
-  jobDetail: ["companySlug", "jobSlug"],
-  jobsCategory: ["categorySlug"],
-  jobsSkill: ["skillSlug"],
-  jobsLocation: ["placeSlug"],
-  company: ["companySlug"],
-  companyMarket: ["marketSlug"],
-  companySalary: ["companySlug"],
-  salaryTitle: ["titleSlug"],
-  salarySkill: ["skillSlug"],
-  salaryLocation: ["placeSlug"],
-  blogPost: ["postSlug"],
-  blogTag: ["tagSlug"],
-  blogAuthor: ["authorSlug"],
-  home: [],
-  jobs: [],
-  companies: [],
-  salaries: [],
-  salaryCompanies: [],
-  salaryTitles: [],
-  salarySkills: [],
-  salaryLocations: [],
-  blog: [],
-  about: [],
-  privacyPolicy: [],
-  termsOfService: [],
-  cookiePolicy: [],
-  impressum: [],
-  talent: [],
-  employers: [],
-  alertsManage: [],
-  alertsConfirm: []
-};
-var REQUIRED_ROLES = [
-  "jobDetail",
-  "alertsManage",
-  "alertsConfirm"
-];
-var ALL_ROLES = Object.keys(
-  ROLE_PARAM_REGISTRY
-);
-var ROLE_SET = new Set(ALL_ROLES);
-var CANONICAL_MANIFEST = {
-  version: 1,
-  roles: {
-    jobDetail: jobDetailPath(":companySlug", ":jobSlug"),
-    jobsCategory: jobsCategoryPath(":categorySlug"),
-    jobsSkill: jobsSkillPath(":skillSlug"),
-    jobsLocation: jobsLocationPath(":placeSlug"),
-    company: companyPath(":companySlug"),
-    companyMarket: companyMarketPath(":marketSlug"),
-    companySalary: companySalaryPath(":companySlug"),
-    salaryTitle: salaryTitlePath(":titleSlug"),
-    salarySkill: salarySkillPath(":skillSlug"),
-    salaryLocation: salaryLocationPath(":placeSlug"),
-    blogPost: blogPostPath(":postSlug"),
-    blogTag: blogTagPath(":tagSlug"),
-    blogAuthor: blogAuthorPath(":authorSlug"),
-    home: BOARD_PATHS.home,
-    jobs: BOARD_PATHS.jobs,
-    companies: BOARD_PATHS.companies,
-    salaries: BOARD_PATHS.salaries,
-    salaryCompanies: BOARD_PATHS.salaryCompanies,
-    salaryTitles: BOARD_PATHS.salaryTitles,
-    salarySkills: BOARD_PATHS.salarySkills,
-    salaryLocations: BOARD_PATHS.salaryLocations,
-    blog: BOARD_PATHS.blog,
-    about: BOARD_PATHS.about,
-    privacyPolicy: BOARD_PATHS.privacyPolicy,
-    termsOfService: BOARD_PATHS.termsOfService,
-    cookiePolicy: BOARD_PATHS.cookiePolicy,
-    impressum: BOARD_PATHS.impressum,
-    talent: BOARD_PATHS.talent,
-    employers: BOARD_PATHS.employers,
-    alertsManage: "/alerts/manage",
-    alertsConfirm: "/alerts/confirm"
-  }
-};
-
-// src/route-contract/params.ts
-function extractParamNames(template) {
-  const names = [];
-  const re = /:([A-Za-z_][A-Za-z0-9_]*)/g;
-  let match;
-  while ((match = re.exec(template)) !== null) {
-    const name = match[1];
-    if (name !== void 0) names.push(name);
-  }
-  return names;
-}
-function sameParamSet(a, b) {
-  if (a.length !== b.length) return false;
-  const sortedA = [...a].sort();
-  const sortedB = [...b].sort();
-  for (let i = 0; i < sortedA.length; i++) {
-    if (sortedA[i] !== sortedB[i]) return false;
-  }
-  return true;
-}
-function paramSetKey(params) {
-  return [...params].sort().join("\0");
-}
-
-// src/route-contract/classify.ts
-var SHARED_SIGNATURE_COUNTS = (() => {
-  const counts = /* @__PURE__ */ new Map();
-  for (const role of ALL_ROLES) {
-    const params = ROLE_PARAM_REGISTRY[role];
-    if (params.length === 0) continue;
-    const key = paramSetKey(params);
-    counts.set(key, (counts.get(key) ?? 0) + 1);
-  }
-  return counts;
-})();
-function isSignatureCandidate(route, role) {
-  const registry = ROLE_PARAM_REGISTRY[role];
-  const routeParams = extractParamNames(route.template);
-  if (registry.length === 0) {
-    return route.template === CANONICAL_MANIFEST.roles[role];
-  }
-  if (!sameParamSet(routeParams, registry)) return false;
-  const shareCount = SHARED_SIGNATURE_COUNTS.get(paramSetKey(registry)) ?? 0;
-  if (shareCount > 1) {
-    return route.template === CANONICAL_MANIFEST.roles[role];
-  }
-  return true;
-}
-function classifyRoutes(routes, markers) {
-  const assignments = {};
-  const ambiguities = [];
-  const claimed = /* @__PURE__ */ new Set();
-  if (markers && markers.size > 0) {
-    const claimsByRole = /* @__PURE__ */ new Map();
-    for (const route of routes) {
-      if (route.sourcePath === void 0) continue;
-      const role = markers.get(route.sourcePath);
-      if (role === void 0) continue;
-      const list = claimsByRole.get(role);
-      if (list) list.push(route);
-      else claimsByRole.set(role, [route]);
-    }
-    for (const [role, candidates] of claimsByRole) {
-      for (const c of candidates) claimed.add(c);
-      if (candidates.length === 1) {
-        assignments[role] = candidates[0];
-      } else {
-        ambiguities.push({ role, candidates: [...candidates] });
-      }
-    }
-  }
-  const pool = routes.filter((r) => !claimed.has(r));
-  for (const role of ALL_ROLES) {
-    if (assignments[role] !== void 0) continue;
-    if (ambiguities.some((a) => a.role === role)) continue;
-    const candidates = pool.filter((r) => isSignatureCandidate(r, role));
-    if (candidates.length === 0) continue;
-    if (candidates.length === 1) {
-      const only = candidates[0];
-      if (claimed.has(only)) {
-        continue;
-      }
-      assignments[role] = only;
-      claimed.add(only);
-      continue;
-    }
-    ambiguities.push({ role, candidates: [...candidates] });
-  }
-  const missingRequired = REQUIRED_ROLES.filter(
-    (role) => assignments[role] === void 0
-  );
-  return { assignments, ambiguities, missingRequired };
-}
-
-// src/route-contract/validate.ts
-var TEMPLATE_CHARSET_RE = /^[A-Za-z0-9/_.:-]+$/;
-function checkRoleTemplate(role, template) {
-  const errors = [];
-  if (typeof template !== "string" || template.length === 0) {
-    errors.push({
-      code: "invalid_template",
-      message: `role '${role}' template must be a non-empty string`,
-      role
-    });
-    return errors;
-  }
-  if (!template.startsWith("/")) {
-    errors.push({
-      code: "invalid_template",
-      message: `role '${role}' template must start with '/', got ${JSON.stringify(template)}`,
-      role
-    });
-    return errors;
-  }
-  if (/\s/.test(template)) {
-    errors.push({
-      code: "invalid_template",
-      message: `role '${role}' template must not contain whitespace, got ${JSON.stringify(template)}`,
-      role
-    });
-    return errors;
-  }
-  if (template.includes("?") || template.includes("#")) {
-    errors.push({
-      code: "template_query_or_fragment",
-      message: `role '${role}' template must not contain '?' or '#', got ${JSON.stringify(template)}`,
-      role
-    });
-    return errors;
-  }
-  if (template.startsWith("//") || template.includes("//")) {
-    errors.push({
-      code: "template_double_slash",
-      message: `role '${role}' template must not contain '//', got ${JSON.stringify(template)}`,
-      role
-    });
-    return errors;
-  }
-  for (const seg of template.split("/")) {
-    if (seg === "." || seg === "..") {
-      errors.push({
-        code: "template_dot_segment",
-        message: `role '${role}' template must not contain '.' or '..' segments, got ${JSON.stringify(template)}`,
-        role
-      });
-      return errors;
-    }
-  }
-  if (!TEMPLATE_CHARSET_RE.test(template)) {
-    errors.push({
-      code: "template_illegal_charset",
-      message: `role '${role}' template contains illegal characters, got ${JSON.stringify(template)}`,
-      role
-    });
-    return errors;
-  }
-  const registry = ROLE_PARAM_REGISTRY[role];
-  const tokens = extractParamNames(template);
-  if (registry.length === 0) {
-    if (tokens.length > 0) {
-      errors.push({
-        code: "static_has_params",
-        message: `static role '${role}' template must not contain ':' tokens, got ${template}`,
-        role,
-        token: tokens[0]
-      });
-    }
-  } else {
-    const registrySet = new Set(registry);
-    for (const token of tokens) {
-      if (!registrySet.has(token)) {
-        errors.push({
-          code: "unregistered_param",
-          message: `role '${role}' template references unregistered param ':${token}'`,
-          role,
-          token
-        });
-      }
-    }
-    const retained = tokens.filter((t) => registrySet.has(t));
-    if (retained.length === 0) {
-      errors.push({
-        code: "missing_entity_param",
-        message: `role '${role}' template must contain at least one registry param (${registry.join(", ")})`,
-        role
-      });
-    }
-  }
-  return errors;
-}
-
-// src/route-contract/compile.ts
-var REQUIRED_SET = new Set(REQUIRED_ROLES);
-function compileManifest(routes, markers) {
-  const { assignments, ambiguities, missingRequired } = classifyRoutes(
-    routes,
-    markers
-  );
-  const roles = {};
-  const warnings = [];
-  const blocking = new Set(missingRequired);
-  for (const role of ALL_ROLES) {
-    const entry = assignments[role];
-    if (entry === void 0) continue;
-    const templateErrors = checkRoleTemplate(role, entry.template);
-    if (templateErrors.length > 0) {
-      const exact = templateErrors.map((e) => e.message).join("; ");
-      warnings.push(
-        `role '${role}' template rejected: ${exact} \u2014 add export const cavunoPage = '${role}' on the correct page or fix the template`
-      );
-      if (REQUIRED_SET.has(role)) {
-        blocking.add(role);
-      }
-      continue;
-    }
-    roles[role] = entry.template;
-  }
-  for (const amb of ambiguities) {
-    const kind = REQUIRED_SET.has(amb.role) ? "required" : "optional";
-    warnings.push(
-      `${kind} role '${amb.role}' is ambiguous \u2014 add export const cavunoPage = '${amb.role}' to disambiguate`
-    );
-  }
-  for (const role of ALL_ROLES) {
-    if (REQUIRED_SET.has(role)) continue;
-    if (roles[role] !== void 0) continue;
-    if (assignments[role] !== void 0) continue;
-    if (ambiguities.some((a) => a.role === role)) continue;
-    warnings.push(`optional role '${role}' is unassigned`);
-  }
-  return {
-    manifest: { version: 1, roles },
-    blockingMissing: REQUIRED_ROLES.filter((r) => blocking.has(r)),
-    warnings,
-    ambiguities
-  };
-}
-
-// src/route-contract/resolve-links.ts
-var REQUIRED_SET2 = new Set(REQUIRED_ROLES);
-
-// src/route-contract/match-history.ts
-var ROLE_INDEX_PATHS = {
-  jobDetail: BOARD_PATHS.jobs,
-  jobsCategory: BOARD_PATHS.jobs,
-  jobsSkill: BOARD_PATHS.jobs,
-  jobsLocation: BOARD_PATHS.jobs,
-  company: BOARD_PATHS.companies,
-  companyMarket: BOARD_PATHS.companies,
-  companySalary: BOARD_PATHS.companies,
-  salaryTitle: BOARD_PATHS.salaries,
-  salarySkill: BOARD_PATHS.salaries,
-  salaryLocation: BOARD_PATHS.salaries,
-  salaryCompanies: BOARD_PATHS.salaries,
-  salaryTitles: BOARD_PATHS.salaries,
-  salarySkills: BOARD_PATHS.salaries,
-  salaryLocations: BOARD_PATHS.salaries,
-  salaries: BOARD_PATHS.salaries,
-  blogPost: BOARD_PATHS.blog,
-  blogTag: BOARD_PATHS.blog,
-  blogAuthor: BOARD_PATHS.blog,
-  blog: BOARD_PATHS.blog,
-  home: BOARD_PATHS.home,
-  jobs: BOARD_PATHS.jobs,
-  companies: BOARD_PATHS.companies,
-  about: BOARD_PATHS.about,
-  privacyPolicy: BOARD_PATHS.privacyPolicy,
-  termsOfService: BOARD_PATHS.termsOfService,
-  cookiePolicy: BOARD_PATHS.cookiePolicy,
-  impressum: BOARD_PATHS.impressum,
-  talent: BOARD_PATHS.talent,
-  employers: BOARD_PATHS.employers,
-  alertsManage: BOARD_PATHS.home,
-  alertsConfirm: BOARD_PATHS.home
-};
+import {
+  compileManifest
+} 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.1.0",
+  "version": "4.0.0",
   "description": "Build custom job boards and careers pages with Cavuno’s TypeScript SDK.",
   "keywords": [
     "api-client",
@@ -201,9 +201,9 @@
   "scripts": {
     "build": "rm -rf dist && tsup",
     "clean": "git clean -xdf .turbo dist node_modules src/generated",
-    "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.node.json",
+    "typecheck": "tsgo --noEmit && tsgo --noEmit -p tsconfig.node.json",
     "test": "vitest run",
-    "check:publish": "publint --strict && attw --pack . --profile node16",
+    "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"
@@ -215,7 +215,8 @@
     "tsup": "^8.4.0",
     "tsx": "^4.19.2",
     "vitest": "^2.1.9",
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "@typescript/native-preview": "7.0.0-dev.20260707.2"
   },
   "engines": {
     "node": ">=20"

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'],
 });
 ```