@cavuno/board 1.33.1 → 1.35.0

package/README.md

@@ -1,7 +1,7 @@
 # @cavuno/board
 
 Typed, isomorphic client for the [Cavuno](https://cavuno.com) Board API —
-the headless toolkit for building fully-custom job-board frontends. Zero
+the headless toolkit for building fully custom job board frontends. Zero
 dependencies; runs in the browser, Node ≥ 20, and Cloudflare Workers.
 
 You bring the framework and own the layout; the SDK brings the job board:
@@ -12,14 +12,14 @@ contract.
 
 ## Building with a coding agent
 
-The package ships an agent skill corpus that teaches Claude Code (or any
-SKILL.md-compatible agent) how to wire a board correctly — client setup,
+The package ships an Agent Skills corpus for Codex, Claude Code, Cursor, and
+other compatible coding agents. It teaches them how to wire a board correctly — client setup,
 auth and session ownership, pagination, gating, error handling, and a
 runtime smoke test:
 
 ```bash
-npm install @cavuno/board
-npx cavuno-board setup   # copies version-matched skills into .claude/skills and/or .agents/skills
+npm install @cavuno/board     # or: pnpm add / yarn add / bun add
+npx @cavuno/board setup       # copies version-matched Agent Skills
 ```
 
 Then ask your agent: *"set up my Cavuno board"* — it reads the
@@ -33,8 +33,7 @@ never works from stale docs.
 import { createBoardClient } from '@cavuno/board';
 
 const board = createBoardClient({
-  baseUrl: process.env.PUBLIC_CAVUNO_API_URL!, // https://api.cavuno.com
-  board: process.env.PUBLIC_CAVUNO_BOARD!,     // pk_… publishable key
+  board: process.env.PUBLIC_CAVUNO_BOARD!, // pk_… publishable key
 });
 
 const { name, theme, features } = await board.context();
@@ -80,7 +79,7 @@ SDK doesn't cover yet.
 
 ## Docs
 
-- API reference & guides: https://cavuno.com/docs/api
+- SDK guides and reference: https://cavuno.com/docs/sdk
 - The OpenAPI document: `GET https://api.cavuno.com/v1/openapi.json`
 - Reference starter (TanStack Start on Cloudflare Workers):
   https://github.com/wollemiahq/cavuno-board-starter

package/dist/bin.mjs

@@ -1,5 +1,8 @@
 #!/usr/bin/env node
 
+// src/constants.ts
+var DEFAULT_CAVUNO_API_URL = "https://api.cavuno.com";
+
 // src/skills.ts
 import { readFileSync } from "fs";
 import { dirname, resolve } from "path";
@@ -220,6 +223,58 @@ async function runReadProbes(fetchImpl, frontendUrl) {
   ];
 }
 
+// src/doctor/theme.ts
+import { createHash } from "crypto";
+import { existsSync, readFileSync as readFileSync2 } from "fs";
+import { join } from "path";
+var THEME = record("static.theme", 1);
+function checkThemeFreshness(projectRoot, context) {
+  const tokensPath = join(projectRoot, "src/tokens.css");
+  if (!existsSync(tokensPath)) {
+    return [
+      THEME(
+        "skip",
+        "board is not tokens-migrated (ADR-0065) \u2014 no src/tokens.css"
+      )
+    ];
+  }
+  const tokensHash = createHash("sha256").update(readFileSync2(tokensPath, "utf8"), "utf8").digest("hex");
+  const resolvedPath = join(projectRoot, "src/theme/resolved.ts");
+  const resolvedHash = existsSync(resolvedPath) ? readFileSync2(resolvedPath, "utf8").match(
+    /tokensHash = '([0-9a-f]{64})'/
+  )?.[1] ?? null : null;
+  if (resolvedHash !== tokensHash) {
+    return [
+      THEME(
+        "fail",
+        `src/theme/resolved.ts is ${resolvedHash ? "stale" : "missing"} \u2014 run \`npm run gen:theme\` (OG images render from it)`
+      )
+    ];
+  }
+  if (!context) {
+    return [
+      THEME(
+        "skip",
+        "local derivations fresh; platform snapshot unverified \u2014 board context unavailable"
+      )
+    ];
+  }
+  if (context.themeSnapshotHash !== tokensHash) {
+    return [
+      THEME(
+        "fail",
+        `platform theme snapshot is ${context.themeSnapshotHash ? "stale" : "missing"} \u2014 emails render ${context.themeSnapshotHash ? "an old" : "the legacy"} theme; sync it: \`npm run gen:theme -- --payload | npx convex run boards/themeSnapshot:sync\``
+      )
+    ];
+  }
+  return [
+    THEME(
+      "pass",
+      `tokens.css \u21C4 resolved module \u21C4 platform snapshot (${tokensHash.slice(0, 12)}\u2026)`
+    )
+  ];
+}
+
 // src/doctor/writes.ts
 var WRITE = {
   board: record("write.board", 3),
@@ -425,8 +480,8 @@ async function runWriteProbes(options) {
 }
 
 // src/doctor/run.ts
-import { existsSync, readFileSync as readFileSync2 } from "fs";
-import { join } from "path";
+import { existsSync as existsSync2, readFileSync as readFileSync3 } from "fs";
+import { join as join2 } from "path";
 var STATIC_API = record("static.api", 1);
 var STATIC_BOARD = record("static.board", 1);
 var STATIC_SKILLS = record("static.skills", 1);
@@ -486,15 +541,19 @@ async function checkBoardResolves(fetchImpl, env) {
     context: parsed
   };
 }
-var SKILL_ROOTS = [".claude/skills", ".agents/skills"];
+var SKILL_ROOTS = [
+  ".claude/skills",
+  ".agents/skills",
+  ".cursor/skills"
+];
 function checkSkillsFreshness(projectRoot) {
-  const roots = SKILL_ROOTS.map((root) => join(projectRoot, root)).filter(
-    (root) => existsSync(root)
+  const roots = SKILL_ROOTS.map((root) => join2(projectRoot, root)).filter(
+    (root) => existsSync2(root)
   );
   if (roots.length === 0) {
     return STATIC_SKILLS(
       "skip",
-      "no .claude/skills or .agents/skills directory \u2014 run `npx @cavuno/board setup` to install agent skills"
+      "no .claude/skills, .agents/skills, or .cursor/skills directory \u2014 run `npx @cavuno/board setup` to install agent skills"
     );
   }
   const corpus = loadSkillCorpus();
@@ -502,10 +561,10 @@ function checkSkillsFreshness(projectRoot) {
   const seen = /* @__PURE__ */ new Set();
   for (const root of roots) {
     for (const skill of corpus.skills) {
-      const copied = join(root, skill.name, "SKILL.md");
-      if (!existsSync(copied)) continue;
+      const copied = join2(root, skill.name, "SKILL.md");
+      if (!existsSync2(copied)) continue;
       seen.add(skill.name);
-      if (readFileSync2(copied, "utf8") !== skill.content) {
+      if (readFileSync3(copied, "utf8") !== skill.content) {
         stale.add(skill.name);
       }
     }
@@ -527,12 +586,16 @@ function checkSkillsFreshness(projectRoot) {
 }
 async function runDoctor(options) {
   const fetchImpl = options.fetchImpl ?? fetch;
+  const env = {
+    ...options.env,
+    apiUrl: options.env.apiUrl ?? DEFAULT_CAVUNO_API_URL
+  };
   const results = [];
-  const envResults = checkEnv(options.env);
+  const envResults = checkEnv(env);
   results.push(...envResults);
   const envOk = envResults.every((r) => r.status === "pass");
-  if (options.env.apiUrl) {
-    const api = await checkApiReachable(fetchImpl, options.env.apiUrl);
+  if (env.apiUrl) {
+    const api = await checkApiReachable(fetchImpl, env.apiUrl);
     results.push(
       api ?? STATIC_API("skip", "API URL malformed \u2014 fix env.api-url first")
     );
@@ -541,13 +604,16 @@ async function runDoctor(options) {
   }
   let boardContext = null;
   if (envOk) {
-    const resolved = await checkBoardResolves(fetchImpl, options.env);
+    const resolved = await checkBoardResolves(fetchImpl, env);
     boardContext = resolved.context;
     results.push(resolved.result);
   } else {
     results.push(STATIC_BOARD("skip", "env checks failed \u2014 fix them first"));
   }
   results.push(checkSkillsFreshness(options.projectRoot ?? process.cwd()));
+  results.push(
+    ...checkThemeFreshness(options.projectRoot ?? process.cwd(), boardContext)
+  );
   results.push(
     ...options.frontendUrl ? await runReadProbes(fetchImpl, options.frontendUrl) : skipReadProbes("no --frontend <url> given")
   );
@@ -562,7 +628,7 @@ async function runDoctor(options) {
   } else {
     results.push(
       ...await runWriteProbes({
-        env: options.env,
+        env,
         fetchImpl,
         resendApiKey: options.resendApiKey,
         nonce: options.writeProbeNonce,
@@ -574,12 +640,12 @@ async function runDoctor(options) {
 }
 
 // src/setup/run.ts
-import { cpSync, existsSync as existsSync2, mkdirSync, readFileSync as readFileSync3 } from "fs";
+import { cpSync, existsSync as existsSync3, mkdirSync, readFileSync as readFileSync4 } from "fs";
 import { dirname as dirname2, resolve as resolve2 } from "path";
 function detectFramework(cwd) {
   const pkgPath = resolve2(cwd, "package.json");
-  if (!existsSync2(pkgPath)) return null;
-  const pkg = JSON.parse(readFileSync3(pkgPath, "utf8"));
+  if (!existsSync3(pkgPath)) return null;
+  const pkg = JSON.parse(readFileSync4(pkgPath, "utf8"));
   const deps = { ...pkg.dependencies, ...pkg.devDependencies };
   if (deps["@tanstack/react-start"]) return "tanstack-start";
   return null;
@@ -591,10 +657,12 @@ function runSetup(cwd = process.cwd()) {
     (skill) => skill.category === "core" || skill.framework === framework
   );
   const roots = [
+    resolve2(cwd, ".agents", "skills"),
     resolve2(cwd, ".claude", "skills"),
-    resolve2(cwd, ".agents", "skills")
+    resolve2(cwd, ".codex", "skills"),
+    resolve2(cwd, ".cursor", "skills")
   ];
-  const existing = roots.filter((root) => existsSync2(root));
+  const existing = roots.filter((root) => existsSync3(root));
   const targetDirs = existing.length > 0 ? existing : [roots[0]];
   const copied = [];
   for (const targetDir of targetDirs) {
@@ -670,11 +738,13 @@ function main() {
   );
   for (const name of result.copied) console.log(`  - ${name}`);
   console.log("\nNext steps:");
-  console.log("  1. Set your environment variables:");
-  console.log("       PUBLIC_CAVUNO_API_URL=https://api.cavuno.com");
+  console.log("  1. Set your board publishable key:");
   console.log(
     "       PUBLIC_CAVUNO_BOARD=pk_...   # your board publishable key"
   );
+  console.log(
+    "       # Optional API override: PUBLIC_CAVUNO_API_URL=https://api.cavuno.com"
+  );
   console.log('  2. Ask your coding agent: "set up my Cavuno board".');
   console.log("     It reads the cavuno-board-setup skill first.");
   console.log(

package/dist/{board-BTVapQiL.d.mts → board-Be8dY9Ba.d.mts}

@@ -1,4 +1,4 @@
-import { b as Schemas } from './jobs-Di4AV-02.mjs';
+import { b as Schemas } from './jobs-BFLMDNEN.mjs';
 
 type PublicBoard = Schemas['PublicBoardContext'];
 type PublicBoardFeatures = PublicBoard['features'];

package/dist/{board-0yI5ZRJw.d.ts → board-DsRbgz_D.d.ts}

@@ -1,4 +1,4 @@
-import { b as Schemas } from './jobs-Di4AV-02.js';
+import { b as Schemas } from './jobs-BFLMDNEN.js';
 
 type PublicBoard = Schemas['PublicBoardContext'];
 type PublicBoardFeatures = PublicBoard['features'];

package/dist/filters.d.mts

@@ -1,5 +1,5 @@
 import { B as BoardLabelOverrides } from './ui-copy-rlfoH9P3.mjs';
-import { J as JobSort, E as EmploymentType, R as RemoteOption, S as Seniority } from './jobs-Di4AV-02.mjs';
+import { J as JobSort, E as EmploymentType, R as RemoteOption, S as Seniority } from './jobs-BFLMDNEN.mjs';
 
 declare const REMOTE_OPTIONS: readonly RemoteOption[];
 /**

package/dist/filters.d.ts

@@ -1,5 +1,5 @@
 import { B as BoardLabelOverrides } from './ui-copy-rlfoH9P3.js';
-import { J as JobSort, E as EmploymentType, R as RemoteOption, S as Seniority } from './jobs-Di4AV-02.js';
+import { J as JobSort, E as EmploymentType, R as RemoteOption, S as Seniority } from './jobs-BFLMDNEN.js';
 
 declare const REMOTE_OPTIONS: readonly RemoteOption[];
 /**

package/dist/format.d.mts

@@ -1,7 +1,7 @@
-import { P as PublicJob, a as PublicJobCard, C as CustomFieldValues } from './jobs-Di4AV-02.mjs';
+import { P as PublicJob, a as PublicJobCard, C as CustomFieldValues } from './jobs-BFLMDNEN.mjs';
 import { B as BoardLabelOverrides } from './ui-copy-rlfoH9P3.mjs';
 export { A as AlertsCopy, a as ApplyCopy, b as BlogCopy, c as BreadcrumbsCopy, C as CopyLinkCopy, E as EntityCopy, F as FooterCopy, J as JobCardCopy, d as JobDetailCopy, e as JobSearchCopy, N as NavCopy, P as PUBLIC_LABEL_GROUPS, f as PaginationCopy, S as SalaryCopy, U as UiCopy, u as uiCopy } from './ui-copy-rlfoH9P3.mjs';
-import { C as CustomFieldDefinition } from './board-BTVapQiL.mjs';
+import { C as CustomFieldDefinition } from './board-Be8dY9Ba.mjs';
 
 /**
  * Date display helpers in the board language (required leading parameter,

package/dist/format.d.ts

@@ -1,7 +1,7 @@
-import { P as PublicJob, a as PublicJobCard, C as CustomFieldValues } from './jobs-Di4AV-02.js';
+import { P as PublicJob, a as PublicJobCard, C as CustomFieldValues } from './jobs-BFLMDNEN.js';
 import { B as BoardLabelOverrides } from './ui-copy-rlfoH9P3.js';
 export { A as AlertsCopy, a as ApplyCopy, b as BlogCopy, c as BreadcrumbsCopy, C as CopyLinkCopy, E as EntityCopy, F as FooterCopy, J as JobCardCopy, d as JobDetailCopy, e as JobSearchCopy, N as NavCopy, P as PUBLIC_LABEL_GROUPS, f as PaginationCopy, S as SalaryCopy, U as UiCopy, u as uiCopy } from './ui-copy-rlfoH9P3.js';
-import { C as CustomFieldDefinition } from './board-0yI5ZRJw.js';
+import { C as CustomFieldDefinition } from './board-DsRbgz_D.js';
 
 /**
  * Date display helpers in the board language (required leading parameter,

package/dist/index.d.mts

@@ -1,8 +1,8 @@
-import { b as Schemas, R as RemoteOption, E as EmploymentType, S as Seniority, L as ListEnvelope, c as components, d as JobsListQuery, e as JobCardListEnvelope, f as JobsSearchBody, g as JobCardSearchEnvelope, h as JobsSimilarQuery, i as SearchEnvelope } from './jobs-Di4AV-02.mjs';
-export { j as CustomFieldValue, C as CustomFieldValues, k as EducationRequirement, l as JobCompany, J as JobSort, O as OfficeLocation, P as PublicJob, a as PublicJobCard, m as RelatedSearch, n as RemotePermit, o as RemoteTimezone, p as StorefrontPagination } from './jobs-Di4AV-02.mjs';
-export { C as CustomFieldDefinition, a as CustomFieldOption, b as CustomFieldType, P as PublicBoard, c as PublicBoardAnalytics, d as PublicBoardFeatures, e as PublicBoardTheme } from './board-BTVapQiL.mjs';
-import { b as CompaniesListQuery, c as CompanyListEnvelope, d as CompaniesSearchBody, e as CompanyJobsListQuery, f as CompanySimilarQuery, g as CompanyMarketsListQuery, h as SalaryDetailQuery, i as BlogPostsListQuery, j as BlogSimilarQuery, k as BlogSearchBody } from './salaries-D-BGZpDC.mjs';
-export { B as BlogAuthorEmbed, l as BlogTagEmbed, C as CompanyCategorySalary, m as CompanyMarket, n as CompanyMarketRef, a as CompanySalary, L as LocationSalaryDetail, o as LocationSkillsIndex, p as LocationTitlesIndex, q as PublicBlogAdjacentPosts, r as PublicBlogAuthor, s as PublicBlogPost, P as PublicBlogPostSummary, t as PublicBlogTag, u as PublicCompany, v as PublicCompanyDetail, w as SalaryCompany, x as SalaryLocation, y as SalarySkill, z as SalaryTitle, A as SkillLocationSalary, D as SkillLocationsIndex, S as SkillSalaryDetail, E as TitleLocationSalary, F as TitleLocationsIndex, T as TitleSalaryDetail } from './salaries-D-BGZpDC.mjs';
+import { b as Schemas, R as RemoteOption, E as EmploymentType, S as Seniority, L as ListEnvelope, c as components, d as JobsListQuery, e as JobCardListEnvelope, f as JobsSearchBody, g as JobCardSearchEnvelope, h as JobsSimilarQuery, i as SearchEnvelope } from './jobs-BFLMDNEN.mjs';
+export { j as CustomFieldValue, C as CustomFieldValues, k as EducationRequirement, l as JobCatalogPagination, m as JobCompany, J as JobSort, O as OfficeLocation, n as OffsetPagination, P as PublicJob, a as PublicJobCard, o as RelatedSearch, p as RemotePermit, q as RemoteTimezone, r as StorefrontPagination } from './jobs-BFLMDNEN.mjs';
+export { C as CustomFieldDefinition, a as CustomFieldOption, b as CustomFieldType, P as PublicBoard, c as PublicBoardAnalytics, d as PublicBoardFeatures, e as PublicBoardTheme } from './board-Be8dY9Ba.mjs';
+import { b as CompaniesListQuery, c as CompanyListEnvelope, d as CompaniesSearchBody, e as CompanyJobsListQuery, f as CompanySimilarQuery, g as CompanyMarketsListQuery, h as SalaryDetailQuery, i as BlogPostsListQuery, j as BlogSimilarQuery, k as BlogSearchBody } from './salaries-pO_vGORE.mjs';
+export { B as BlogAuthorEmbed, l as BlogTagEmbed, C as CompanyCategorySalary, m as CompanyMarket, n as CompanyMarketRef, a as CompanySalary, L as LocationSalaryDetail, o as LocationSkillsIndex, p as LocationTitlesIndex, q as PublicBlogAdjacentPosts, r as PublicBlogAuthor, s as PublicBlogPost, P as PublicBlogPostSummary, t as PublicBlogTag, u as PublicCompany, v as PublicCompanyDetail, w as SalaryCompany, x as SalaryLocation, y as SalarySkill, z as SalaryTitle, A as SkillLocationSalary, D as SkillLocationsIndex, S as SkillSalaryDetail, E as TitleLocationSalary, F as TitleLocationsIndex, T as TitleSalaryDetail } from './salaries-pO_vGORE.mjs';
 
 type Awaitable<T> = T | Promise<T>;
 /**
@@ -176,7 +176,7 @@ interface Paginator<P extends PageShape> extends AsyncIterable<ItemOf<P>> {
  * an explicit sort/query — see the jobs skill.
  *
  * `offset` is honored for the FIRST page only and dropped afterwards: on
- * storefront reads `offset` takes precedence over `cursor`, so carrying it
+ * job catalog reads let `offset` take precedence over `cursor`, so carrying it
  * forward would re-serve the same page forever.
  *
  * @example
@@ -204,7 +204,7 @@ declare function paginate<Q extends Record<string, unknown>, P extends PageShape
  * constant because the package is platform-neutral and cannot read
  * package.json at runtime.
  */
-declare const SDK_VERSION = "1.33.1";
+declare const SDK_VERSION = "1.35.0";
 
 type SavedJob = Schemas['SavedJob'];
 type SavedJobsListQuery = {
@@ -456,7 +456,7 @@ type EmbedJobsQuery = {
     cursor?: string;
     /** Default 8; values above the embed ceiling of 50 are clamped to 50. */
     limit?: number;
-    /** Storefront page offset; takes precedence over `cursor`. `offset + limit` ≤ 10,000. */
+    /** Job catalog page offset; takes precedence over `cursor`. `offset + limit` ≤ 10,000. */
     offset?: number;
     /** Repeated param (up to 10) — OR-matched. Repeat `companyId` per value. */
     companyId?: string[];
@@ -547,7 +547,7 @@ type AccessCheckoutBody = Schemas['AccessCheckoutBody'];
 type AccessPortalBody = Schemas['AccessPortalBody'];
 type PaywallOfferListEnvelope = ListEnvelope<PaywallOffer>;
 
-type JobAlertFrequency = 'daily' | 'weekly';
+type JobAlertFrequency = 'weekly';
 type JobAlertRemoteOption = 'on_site' | 'hybrid' | 'remote';
 /**
  * Alert filters a consumer can capture. Only `jobFunctions` (→ job categories),
@@ -646,7 +646,8 @@ type PlacesListQuery = {
 };
 
 interface CreateBoardClientOptions {
-    baseUrl: string;
+    /** Cavuno API origin. Defaults to the production service. */
+    baseUrl?: string;
     /** Board identifier: `pk_…` key (provisioned default) | `boards_…` ID | slug. */
     board: string;
     auth?: {
@@ -669,7 +670,6 @@ interface CreateBoardClientOptions {
  * import { createBoardClient } from '@cavuno/board';
  *
  * const board = createBoardClient({
- *   baseUrl: 'https://api.cavuno.com',
  *   board: 'pk_a8f3…',
  * });
  * const { data } = await board.jobs.list({ limit: 20 });
@@ -709,6 +709,7 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
             candidatePaywall: boolean;
             impressum: boolean;
         };
+        talentDirectoryVisibility: "off" | "public" | "employers_only";
         analytics: {
             ga4MeasurementId: string | null;
             gtmId: string | null;
@@ -738,6 +739,21 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
                 [key: string]: string;
             };
         };
+        footer: {
+            description: string | null;
+            contactEmail: string | null;
+            websiteUrl: string | null;
+            xUrl: string | null;
+            facebookUrl: string | null;
+            linkedinUrl: string | null;
+            navigationOrder: string[];
+            customLinks: {
+                id: string;
+                label: string;
+                url: string;
+            }[];
+        };
+        themeSnapshotHash: string | null;
     }>;
     /**
      * Board SEO infra — `ads.txt`, IndexNow key, Google site-verification, and
@@ -1886,7 +1902,7 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
                 id: string;
                 object: "alert";
                 label: string | null;
-                frequency: "daily" | "weekly";
+                frequency: "weekly";
                 isActive: boolean;
                 filters: {
                     jobFunctions: string[];
@@ -1903,7 +1919,7 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
                 id: string;
                 object: "alert";
                 label: string | null;
-                frequency: "daily" | "weekly";
+                frequency: "weekly";
                 isActive: boolean;
                 filters: {
                     jobFunctions: string[];
@@ -1920,7 +1936,7 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
                 id: string;
                 object: "alert";
                 label: string | null;
-                frequency: "daily" | "weekly";
+                frequency: "weekly";
                 isActive: boolean;
                 filters: {
                     jobFunctions: string[];
@@ -1937,7 +1953,7 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
                 id: string;
                 object: "alert";
                 label: string | null;
-                frequency: "daily" | "weekly";
+                frequency: "weekly";
                 isActive: boolean;
                 filters: {
                     jobFunctions: string[];
@@ -2322,7 +2338,7 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
             preferences: {
                 id: string;
                 label: string | null;
-                frequency: string;
+                frequency: "weekly";
                 isActive: boolean;
                 filters: {
                     jobFunctions?: string[];

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-import { b as Schemas, R as RemoteOption, E as EmploymentType, S as Seniority, L as ListEnvelope, c as components, d as JobsListQuery, e as JobCardListEnvelope, f as JobsSearchBody, g as JobCardSearchEnvelope, h as JobsSimilarQuery, i as SearchEnvelope } from './jobs-Di4AV-02.js';
-export { j as CustomFieldValue, C as CustomFieldValues, k as EducationRequirement, l as JobCompany, J as JobSort, O as OfficeLocation, P as PublicJob, a as PublicJobCard, m as RelatedSearch, n as RemotePermit, o as RemoteTimezone, p as StorefrontPagination } from './jobs-Di4AV-02.js';
-export { C as CustomFieldDefinition, a as CustomFieldOption, b as CustomFieldType, P as PublicBoard, c as PublicBoardAnalytics, d as PublicBoardFeatures, e as PublicBoardTheme } from './board-0yI5ZRJw.js';
-import { b as CompaniesListQuery, c as CompanyListEnvelope, d as CompaniesSearchBody, e as CompanyJobsListQuery, f as CompanySimilarQuery, g as CompanyMarketsListQuery, h as SalaryDetailQuery, i as BlogPostsListQuery, j as BlogSimilarQuery, k as BlogSearchBody } from './salaries-B-zJKjkk.js';
-export { B as BlogAuthorEmbed, l as BlogTagEmbed, C as CompanyCategorySalary, m as CompanyMarket, n as CompanyMarketRef, a as CompanySalary, L as LocationSalaryDetail, o as LocationSkillsIndex, p as LocationTitlesIndex, q as PublicBlogAdjacentPosts, r as PublicBlogAuthor, s as PublicBlogPost, P as PublicBlogPostSummary, t as PublicBlogTag, u as PublicCompany, v as PublicCompanyDetail, w as SalaryCompany, x as SalaryLocation, y as SalarySkill, z as SalaryTitle, A as SkillLocationSalary, D as SkillLocationsIndex, S as SkillSalaryDetail, E as TitleLocationSalary, F as TitleLocationsIndex, T as TitleSalaryDetail } from './salaries-B-zJKjkk.js';
+import { b as Schemas, R as RemoteOption, E as EmploymentType, S as Seniority, L as ListEnvelope, c as components, d as JobsListQuery, e as JobCardListEnvelope, f as JobsSearchBody, g as JobCardSearchEnvelope, h as JobsSimilarQuery, i as SearchEnvelope } from './jobs-BFLMDNEN.js';
+export { j as CustomFieldValue, C as CustomFieldValues, k as EducationRequirement, l as JobCatalogPagination, m as JobCompany, J as JobSort, O as OfficeLocation, n as OffsetPagination, P as PublicJob, a as PublicJobCard, o as RelatedSearch, p as RemotePermit, q as RemoteTimezone, r as StorefrontPagination } from './jobs-BFLMDNEN.js';
+export { C as CustomFieldDefinition, a as CustomFieldOption, b as CustomFieldType, P as PublicBoard, c as PublicBoardAnalytics, d as PublicBoardFeatures, e as PublicBoardTheme } from './board-DsRbgz_D.js';
+import { b as CompaniesListQuery, c as CompanyListEnvelope, d as CompaniesSearchBody, e as CompanyJobsListQuery, f as CompanySimilarQuery, g as CompanyMarketsListQuery, h as SalaryDetailQuery, i as BlogPostsListQuery, j as BlogSimilarQuery, k as BlogSearchBody } from './salaries-negE75t8.js';
+export { B as BlogAuthorEmbed, l as BlogTagEmbed, C as CompanyCategorySalary, m as CompanyMarket, n as CompanyMarketRef, a as CompanySalary, L as LocationSalaryDetail, o as LocationSkillsIndex, p as LocationTitlesIndex, q as PublicBlogAdjacentPosts, r as PublicBlogAuthor, s as PublicBlogPost, P as PublicBlogPostSummary, t as PublicBlogTag, u as PublicCompany, v as PublicCompanyDetail, w as SalaryCompany, x as SalaryLocation, y as SalarySkill, z as SalaryTitle, A as SkillLocationSalary, D as SkillLocationsIndex, S as SkillSalaryDetail, E as TitleLocationSalary, F as TitleLocationsIndex, T as TitleSalaryDetail } from './salaries-negE75t8.js';
 
 type Awaitable<T> = T | Promise<T>;
 /**
@@ -176,7 +176,7 @@ interface Paginator<P extends PageShape> extends AsyncIterable<ItemOf<P>> {
  * an explicit sort/query — see the jobs skill.
  *
  * `offset` is honored for the FIRST page only and dropped afterwards: on
- * storefront reads `offset` takes precedence over `cursor`, so carrying it
+ * job catalog reads let `offset` take precedence over `cursor`, so carrying it
  * forward would re-serve the same page forever.
  *
  * @example
@@ -204,7 +204,7 @@ declare function paginate<Q extends Record<string, unknown>, P extends PageShape
  * constant because the package is platform-neutral and cannot read
  * package.json at runtime.
  */
-declare const SDK_VERSION = "1.33.1";
+declare const SDK_VERSION = "1.35.0";
 
 type SavedJob = Schemas['SavedJob'];
 type SavedJobsListQuery = {
@@ -456,7 +456,7 @@ type EmbedJobsQuery = {
     cursor?: string;
     /** Default 8; values above the embed ceiling of 50 are clamped to 50. */
     limit?: number;
-    /** Storefront page offset; takes precedence over `cursor`. `offset + limit` ≤ 10,000. */
+    /** Job catalog page offset; takes precedence over `cursor`. `offset + limit` ≤ 10,000. */
     offset?: number;
     /** Repeated param (up to 10) — OR-matched. Repeat `companyId` per value. */
     companyId?: string[];
@@ -547,7 +547,7 @@ type AccessCheckoutBody = Schemas['AccessCheckoutBody'];
 type AccessPortalBody = Schemas['AccessPortalBody'];
 type PaywallOfferListEnvelope = ListEnvelope<PaywallOffer>;
 
-type JobAlertFrequency = 'daily' | 'weekly';
+type JobAlertFrequency = 'weekly';
 type JobAlertRemoteOption = 'on_site' | 'hybrid' | 'remote';
 /**
  * Alert filters a consumer can capture. Only `jobFunctions` (→ job categories),
@@ -646,7 +646,8 @@ type PlacesListQuery = {
 };
 
 interface CreateBoardClientOptions {
-    baseUrl: string;
+    /** Cavuno API origin. Defaults to the production service. */
+    baseUrl?: string;
     /** Board identifier: `pk_…` key (provisioned default) | `boards_…` ID | slug. */
     board: string;
     auth?: {
@@ -669,7 +670,6 @@ interface CreateBoardClientOptions {
  * import { createBoardClient } from '@cavuno/board';
  *
  * const board = createBoardClient({
- *   baseUrl: 'https://api.cavuno.com',
  *   board: 'pk_a8f3…',
  * });
  * const { data } = await board.jobs.list({ limit: 20 });
@@ -709,6 +709,7 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
             candidatePaywall: boolean;
             impressum: boolean;
         };
+        talentDirectoryVisibility: "off" | "public" | "employers_only";
         analytics: {
             ga4MeasurementId: string | null;
             gtmId: string | null;
@@ -738,6 +739,21 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
                 [key: string]: string;
             };
         };
+        footer: {
+            description: string | null;
+            contactEmail: string | null;
+            websiteUrl: string | null;
+            xUrl: string | null;
+            facebookUrl: string | null;
+            linkedinUrl: string | null;
+            navigationOrder: string[];
+            customLinks: {
+                id: string;
+                label: string;
+                url: string;
+            }[];
+        };
+        themeSnapshotHash: string | null;
     }>;
     /**
      * Board SEO infra — `ads.txt`, IndexNow key, Google site-verification, and
@@ -1886,7 +1902,7 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
                 id: string;
                 object: "alert";
                 label: string | null;
-                frequency: "daily" | "weekly";
+                frequency: "weekly";
                 isActive: boolean;
                 filters: {
                     jobFunctions: string[];
@@ -1903,7 +1919,7 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
                 id: string;
                 object: "alert";
                 label: string | null;
-                frequency: "daily" | "weekly";
+                frequency: "weekly";
                 isActive: boolean;
                 filters: {
                     jobFunctions: string[];
@@ -1920,7 +1936,7 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
                 id: string;
                 object: "alert";
                 label: string | null;
-                frequency: "daily" | "weekly";
+                frequency: "weekly";
                 isActive: boolean;
                 filters: {
                     jobFunctions: string[];
@@ -1937,7 +1953,7 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
                 id: string;
                 object: "alert";
                 label: string | null;
-                frequency: "daily" | "weekly";
+                frequency: "weekly";
                 isActive: boolean;
                 filters: {
                     jobFunctions: string[];
@@ -2322,7 +2338,7 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
             preferences: {
                 id: string;
                 label: string | null;
-                frequency: string;
+                frequency: "weekly";
                 isActive: boolean;
                 filters: {
                     jobFunctions?: string[];

package/dist/index.js

@@ -312,7 +312,7 @@ async function clearSession(storage) {
 }
 
 // src/version.ts
-var SDK_VERSION = "1.33.1";
+var SDK_VERSION = "1.35.0";
 
 // src/client.ts
 function isRawBody(body) {
@@ -403,6 +403,9 @@ var BoardClient = class {
   }
 };
 
+// src/constants.ts
+var DEFAULT_CAVUNO_API_URL = "https://api.cavuno.com";
+
 // src/namespaces/auth.ts
 function authNamespace(client) {
   async function persist(session) {
@@ -1798,7 +1801,7 @@ function meNamespace(client) {
        *
        * @example
        * await board.me.alerts.update(alertId, {
-       *   frequency: 'daily',
+       *   frequency: 'weekly',
        *   placeIds: ['ChIJ…'],
        * });
        */
@@ -2633,7 +2636,7 @@ function resolveApplyAction(state) {
 // src/index.ts
 function createBoardClient(options) {
   const client = new BoardClient({
-    baseUrl: options.baseUrl,
+    baseUrl: options.baseUrl ?? DEFAULT_CAVUNO_API_URL,
     board: options.board,
     storage: resolveStorage(options.auth?.storage, options.board),
     globalHeaders: options.globalHeaders,