@cavuno/board 1.34.0 → 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";
@@ -538,7 +541,11 @@ 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) => join2(projectRoot, root)).filter(
     (root) => existsSync2(root)
@@ -546,7 +553,7 @@ function checkSkillsFreshness(projectRoot) {
   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();
@@ -579,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")
     );
@@ -593,7 +604,7 @@ 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 {
@@ -617,7 +628,7 @@ async function runDoctor(options) {
   } else {
     results.push(
       ...await runWriteProbes({
-        env: options.env,
+        env,
         fetchImpl,
         resendApiKey: options.resendApiKey,
         nonce: options.writeProbeNonce,
@@ -646,8 +657,10 @@ 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) => existsSync3(root));
   const targetDirs = existing.length > 0 ? existing : [roots[0]];
@@ -725,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-DgDC0T4g.d.mts → board-Be8dY9Ba.d.mts}

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

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

@@ -1,4 +1,4 @@
-import { b as Schemas } from './jobs-IIJtDgzX.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-IIJtDgzX.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-IIJtDgzX.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-IIJtDgzX.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-DgDC0T4g.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-IIJtDgzX.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-Id19Yg8-.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-IIJtDgzX.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-IIJtDgzX.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-DgDC0T4g.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-BfEEEOHj.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-BfEEEOHj.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.34.0";
+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 });
@@ -1902,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[];
@@ -1919,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[];
@@ -1936,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[];
@@ -1953,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[];
@@ -2338,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-IIJtDgzX.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-IIJtDgzX.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-Id19Yg8-.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-CL_00fNX.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-CL_00fNX.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.34.0";
+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 });
@@ -1902,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[];
@@ -1919,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[];
@@ -1936,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[];
@@ -1953,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[];
@@ -2338,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.34.0";
+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,

package/dist/index.mjs

@@ -265,7 +265,7 @@ async function clearSession(storage) {
 }
 
 // src/version.ts
-var SDK_VERSION = "1.34.0";
+var SDK_VERSION = "1.35.0";
 
 // src/client.ts
 function isRawBody(body) {
@@ -356,6 +356,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) {
@@ -1751,7 +1754,7 @@ function meNamespace(client) {
        *
        * @example
        * await board.me.alerts.update(alertId, {
-       *   frequency: 'daily',
+       *   frequency: 'weekly',
        *   placeIds: ['ChIJ…'],
        * });
        */
@@ -2586,7 +2589,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,