@cavuno/board 1.24.0 → 1.26.0

package/README.md

@@ -0,0 +1,88 @@
+# @cavuno/board
+
+Typed, isomorphic client for the [Cavuno](https://cavuno.com) Board API —
+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:
+jobs and search, companies, salaries, blog, board-user auth, saved jobs,
+applications, job alerts, messaging, employer self-service, checkout, and
+the candidate paywall — every method typed from the API's own OpenAPI
+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,
+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
+```
+
+Then ask your agent: *"set up my Cavuno board"* — it reads the
+`cavuno-board-setup` skill and works surface by surface. Because the
+skills live in your project and match your installed version, the agent
+never works from stale docs.
+
+## Quick start (by hand)
+
+```ts
+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
+});
+
+const { name, theme, features } = await board.context();
+const page = await board.jobs.list({ limit: 20 });
+const job = await board.jobs.retrieve('senior-chef');
+```
+
+Every method accepts trailing `FetchOptions` — `signal`, `headers`, and
+framework caching directives (`next: { tags }`, `cf: {…}`) pass through to
+`fetch` untouched. Walk full catalogs with the async iterator:
+
+```ts
+import { paginate } from '@cavuno/board';
+
+// the query `limit` is the page size; toArray's `limit` caps items collected
+for await (const card of paginate(board.jobs.list, { limit: 100 })) {
+  urls.push(card.links.public);
+}
+const first500 = await paginate(board.companies.list, { limit: 100 })
+  .toArray({ limit: 500 });
+```
+
+Errors are typed — every non-2xx throws a `BoardApiError` carrying the full
+v1 envelope (`status`, `code`, `details`, `requestId`), with guards like
+`isNotFound`, `isRateLimited`, and `isBoardPasswordRequired`.
+
+## Auth model
+
+Three tiers, safe for browsers by construction:
+
+- **`pk_…` publishable key** — identifies the board; public by design.
+- **Board-user JWT** — candidate/employer sessions via `board.auth.*`.
+  Pluggable storage (`memory` in the browser, `nostore` on the server);
+  on SSR, keep the session in an httpOnly cookie your app owns and pass
+  the token per call. No auto-refresh on 401 — rotation is explicit.
+- **No secret keys** — operator/admin credentials never touch this SDK.
+
+## Escape hatch
+
+`board.client.fetch<T>(path, init)` sends a typed request through the full
+pipeline (board base path, headers, bearer token, hooks) for endpoints the
+SDK doesn't cover yet.
+
+## Docs
+
+- API reference & guides: https://cavuno.com/docs/api
+- 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
+
+MIT © Wollemia

package/dist/bin.mjs

@@ -1,4 +1,11 @@
 #!/usr/bin/env node
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+var __commonJS = (cb, mod) => function __require() {
+  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
 
 // src/skills.ts
 import { readFileSync } from "fs";
@@ -14,6 +21,11 @@ function loadSkillManifest() {
   const manifestPath = resolveFromPackageRoot("skills/manifest.json");
   return JSON.parse(readFileSync(manifestPath, "utf8"));
 }
+var init_skills = __esm({
+  "src/skills.ts"() {
+    "use strict";
+  }
+});
 
 // src/setup/run.ts
 import { cpSync, existsSync, mkdirSync, readFileSync as readFileSync2 } from "fs";
@@ -32,43 +44,64 @@ function runSetup(cwd = process.cwd()) {
   const chosen = manifest.skills.filter(
     (skill) => skill.category === "core" || skill.framework === framework
   );
-  const targetDir = resolve2(cwd, ".claude", "skills");
-  mkdirSync(targetDir, { recursive: true });
+  const roots = [
+    resolve2(cwd, ".claude", "skills"),
+    resolve2(cwd, ".agents", "skills")
+  ];
+  const existing = roots.filter((root) => existsSync(root));
+  const targetDirs = existing.length > 0 ? existing : [roots[0]];
   const copied = [];
-  for (const skill of chosen) {
-    const sourceDir = dirname2(resolveFromPackageRoot(skill.path));
-    const destDir = resolve2(targetDir, skill.name);
-    mkdirSync(destDir, { recursive: true });
-    cpSync(sourceDir, destDir, { recursive: true });
-    copied.push(skill.name);
+  for (const targetDir of targetDirs) {
+    mkdirSync(targetDir, { recursive: true });
+    for (const skill of chosen) {
+      const sourceDir = dirname2(resolveFromPackageRoot(skill.path));
+      const destDir = resolve2(targetDir, skill.name);
+      mkdirSync(destDir, { recursive: true });
+      cpSync(sourceDir, destDir, { recursive: true });
+      if (!copied.includes(skill.name)) copied.push(skill.name);
+    }
   }
-  return { version: manifest.version, framework, targetDir, copied };
+  return { version: manifest.version, framework, targetDirs, copied };
 }
+var init_run = __esm({
+  "src/setup/run.ts"() {
+    "use strict";
+    init_skills();
+  }
+});
 
 // src/bin.ts
-function main() {
-  if (process.argv[2] !== "setup") {
-    console.error("Usage: cavuno-board setup");
-    process.exit(1);
-  }
-  const result = runSetup();
-  console.log(`
+var require_bin = __commonJS({
+  "src/bin.ts"() {
+    init_run();
+    function main() {
+      if (process.argv[2] !== "setup") {
+        console.error("Usage: cavuno-board setup");
+        process.exit(1);
+      }
+      const result = runSetup();
+      console.log(`
 @cavuno/board setup \u2014 v${result.version}`);
-  console.log(
-    `Detected framework: ${result.framework ?? "none (core skills only)"}`
-  );
-  console.log(`Copied ${result.copied.length} skills \u2192 ${result.targetDir}`);
-  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(
-    "       PUBLIC_CAVUNO_BOARD=pk_...   # your board publishable key"
-  );
-  console.log('  2. Ask your coding agent: "set up my Cavuno board".');
-  console.log("     It reads the cavuno-board-setup skill first.");
-  console.log(
-    "\n  Re-run `npx @cavuno/board setup` after upgrading to refresh skills."
-  );
-}
-main();
+      console.log(
+        `Detected framework: ${result.framework ?? "none (core skills only)"}`
+      );
+      console.log(
+        `Copied ${result.copied.length} skills \u2192 ${result.targetDirs.join(", ")}`
+      );
+      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(
+        "       PUBLIC_CAVUNO_BOARD=pk_...   # your board publishable key"
+      );
+      console.log('  2. Ask your coding agent: "set up my Cavuno board".');
+      console.log("     It reads the cavuno-board-setup skill first.");
+      console.log(
+        "\n  Re-run `npx @cavuno/board setup` after upgrading to refresh skills."
+      );
+    }
+    main();
+  }
+});
+export default require_bin();

package/dist/filters.d.mts

@@ -0,0 +1,55 @@
+import { l as JobSort, E as EmploymentType, R as RemoteOption, a as Seniority } from './jobs-CM67_J6H.mjs';
+
+declare const REMOTE_OPTIONS: readonly RemoteOption[];
+/**
+ * The employment types the listing FILTER offers (the hosted filter UI's
+ * set) — `volunteer`/`other` exist on the wire but are not filter options.
+ */
+declare const EMPLOYMENT_TYPES: readonly EmploymentType[];
+/** All 8 platform seniority levels — the hosted filter renders the full set as a multi-select. */
+declare const SENIORITIES: readonly Seniority[];
+declare const JOB_SORTS: readonly JobSort[];
+declare const DEFAULT_SORT: JobSort;
+/**
+ * Seniority display labels in the board language (lexicon-backed, en+de).
+ *
+ * @example
+ * seniorityLabels('de').executive; // "Führungskraft"
+ */
+declare function seniorityLabels(locale: string): Record<Seniority, string>;
+/**
+ * Sort-dropdown labels. The hosted board has no centralized sort vocabulary
+ * yet, so every locale receives these English defaults today. The locale
+ * parameter is CONTRACT, not cosmetics: ADR-0057 makes the board language a
+ * required leading argument on every label-producing helper so call sites
+ * are locale-correct by construction — when a sort vocabulary lands, no
+ * consumer changes shape (adding the parameter later would be a breaking
+ * change to every call site).
+ */
+declare function sortLabels(_locale: string): Record<JobSort, string>;
+interface ListingFilters {
+    q?: string;
+    remoteOption?: RemoteOption;
+    employmentType?: EmploymentType;
+    /** Multi-select (parity with the hosted board's seniority checkboxes). */
+    seniority?: Seniority[];
+    /** Result ordering (ADR-0048); absent ⇒ `relevance`. */
+    sort?: JobSort;
+}
+/**
+ * Normalise raw seniority input — an array (repeated params) or a
+ * comma-string (hand-typed URL) — to valid levels, with the hosted
+ * semantics: trim, lowercase, drop unknowns, dedupe preserving order.
+ */
+declare function parseSeniority(raw: unknown): Seniority[] | undefined;
+/**
+ * Validate raw URL search params into the supported listing filters,
+ * dropping unknown values (never throwing — listing URLs are public input).
+ *
+ * @example
+ * parseListingFilters({ seniority: 'senior,lead', sort: 'newest' });
+ * // { seniority: ['senior', 'lead'], sort: 'newest' }
+ */
+declare function parseListingFilters(search: Record<string, unknown>): ListingFilters;
+
+export { DEFAULT_SORT, EMPLOYMENT_TYPES, JOB_SORTS, type ListingFilters, REMOTE_OPTIONS, SENIORITIES, parseListingFilters, parseSeniority, seniorityLabels, sortLabels };

package/dist/filters.d.ts

@@ -0,0 +1,55 @@
+import { l as JobSort, E as EmploymentType, R as RemoteOption, a as Seniority } from './jobs-CM67_J6H.js';
+
+declare const REMOTE_OPTIONS: readonly RemoteOption[];
+/**
+ * The employment types the listing FILTER offers (the hosted filter UI's
+ * set) — `volunteer`/`other` exist on the wire but are not filter options.
+ */
+declare const EMPLOYMENT_TYPES: readonly EmploymentType[];
+/** All 8 platform seniority levels — the hosted filter renders the full set as a multi-select. */
+declare const SENIORITIES: readonly Seniority[];
+declare const JOB_SORTS: readonly JobSort[];
+declare const DEFAULT_SORT: JobSort;
+/**
+ * Seniority display labels in the board language (lexicon-backed, en+de).
+ *
+ * @example
+ * seniorityLabels('de').executive; // "Führungskraft"
+ */
+declare function seniorityLabels(locale: string): Record<Seniority, string>;
+/**
+ * Sort-dropdown labels. The hosted board has no centralized sort vocabulary
+ * yet, so every locale receives these English defaults today. The locale
+ * parameter is CONTRACT, not cosmetics: ADR-0057 makes the board language a
+ * required leading argument on every label-producing helper so call sites
+ * are locale-correct by construction — when a sort vocabulary lands, no
+ * consumer changes shape (adding the parameter later would be a breaking
+ * change to every call site).
+ */
+declare function sortLabels(_locale: string): Record<JobSort, string>;
+interface ListingFilters {
+    q?: string;
+    remoteOption?: RemoteOption;
+    employmentType?: EmploymentType;
+    /** Multi-select (parity with the hosted board's seniority checkboxes). */
+    seniority?: Seniority[];
+    /** Result ordering (ADR-0048); absent ⇒ `relevance`. */
+    sort?: JobSort;
+}
+/**
+ * Normalise raw seniority input — an array (repeated params) or a
+ * comma-string (hand-typed URL) — to valid levels, with the hosted
+ * semantics: trim, lowercase, drop unknowns, dedupe preserving order.
+ */
+declare function parseSeniority(raw: unknown): Seniority[] | undefined;
+/**
+ * Validate raw URL search params into the supported listing filters,
+ * dropping unknown values (never throwing — listing URLs are public input).
+ *
+ * @example
+ * parseListingFilters({ seniority: 'senior,lead', sort: 'newest' });
+ * // { seniority: ['senior', 'lead'], sort: 'newest' }
+ */
+declare function parseListingFilters(search: Record<string, unknown>): ListingFilters;
+
+export { DEFAULT_SORT, EMPLOYMENT_TYPES, JOB_SORTS, type ListingFilters, REMOTE_OPTIONS, SENIORITIES, parseListingFilters, parseSeniority, seniorityLabels, sortLabels };

package/dist/filters.js

@@ -0,0 +1,193 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/filters/index.ts
+var filters_exports = {};
+__export(filters_exports, {
+  DEFAULT_SORT: () => DEFAULT_SORT,
+  EMPLOYMENT_TYPES: () => EMPLOYMENT_TYPES,
+  JOB_SORTS: () => JOB_SORTS,
+  REMOTE_OPTIONS: () => REMOTE_OPTIONS,
+  SENIORITIES: () => SENIORITIES,
+  parseListingFilters: () => parseListingFilters,
+  parseSeniority: () => parseSeniority,
+  seniorityLabels: () => seniorityLabels,
+  sortLabels: () => sortLabels
+});
+module.exports = __toCommonJS(filters_exports);
+
+// src/format/salary-lexicon.ts
+var EN = {
+  timeframe: {
+    per_year: "Yearly",
+    per_month: "Monthly",
+    per_week: "Weekly",
+    per_day: "Daily",
+    per_hour: "Hourly"
+  },
+  rangePrefix: { from: "From", upTo: "Up to" },
+  seniority: {
+    entry_level: "Entry level",
+    associate: "Associate",
+    mid_level: "Mid-level",
+    senior: "Senior",
+    lead: "Lead",
+    principal: "Principal",
+    director: "Director",
+    executive: "Executive"
+  },
+  frames: {
+    entitySalariesTitle: ({ entity, range }) => `${entity} Salaries (${range}/yr)`,
+    salariesInPlaceTitle: ({ place, range }) => `Salaries in ${place} (${range}/yr)`,
+    salariesInPlaceTitleNoRange: ({ place }) => `Salaries in ${place}`,
+    entitySalariesInPlaceTitle: ({ entity, place, range }) => `${entity} Salaries in ${place} (${range}/yr)`,
+    companySalariesTitle: ({ company, range }) => `${company} Salaries${range ? ` (${range}/yr)` : ""}`,
+    companyCategorySalariesTitle: ({ company, category, range }) => `${company} ${category} Salaries${range ? ` (${range}/yr)` : ""}`,
+    professionalsEarn: ({ entity, range, count }) => `${entity} professionals earn ${range}/yr on average across ${count} job postings.`,
+    rolesPay: ({ entity, range, count }) => `${entity} roles pay ${range}/yr on average across ${count} job postings.`,
+    professionalsInLocationEarn: ({ entity, place, range, count }) => `${entity} professionals in ${place} earn ${range}/yr on average across ${count} job postings.`,
+    seniorityRange: ({ lowLabel, lowAmount, highLabel, highAmount }) => `${lowLabel} roles start at ${lowAmount}, ${highLabel} roles reach ${highAmount}.`,
+    seniorityRangeWhile: ({ lowLabel, lowAmount, highLabel, highAmount }) => `${lowLabel} salaries start at ${lowAmount}, while ${highLabel} roles reach ${highAmount}.`,
+    compareAcrossTopPaying: ({ count }) => `Compare across ${count} top-paying ${count === 1 ? "company" : "companies"}.`,
+    compareAcrossTop: ({ count }) => `Compare across ${count} top ${count === 1 ? "company" : "companies"}.`,
+    boardWideAverage: ({ entity, range }) => `Board-wide ${entity} average: ${range}/yr.`,
+    averageSalaryInCity: ({ place, range, count }) => `Average salary in ${place} is ${range}/yr across ${count} jobs. Browse salary data by title and skill.`,
+    browseLocationsInRegion: ({ count, place }) => `Browse salary data across ${count} locations in ${place}. Compare salaries by title, skill, and company.`,
+    companyPays: ({ company, range, count }) => `${company} pays ${range}/yr on average across ${count} job postings.`,
+    breakdownAcrossCategories: ({ count }) => `Breakdown across ${count} job ${count === 1 ? "category" : "categories"}.`,
+    compareWithSimilar: ({ count }) => `Compare with ${count} similar ${count === 1 ? "company" : "companies"}.`,
+    salaryInfoFor: ({ company, board }) => `Salary information for ${company} on ${board}.`,
+    categoryRolesAtCompanyPay: ({ category, company, range, count }) => `${category} roles at ${company} pay ${range}/yr based on ${count} job postings.`,
+    categorySalaryDataFor: ({ category, company, board }) => `${category} salary data for ${company} on ${board}.`
+  }
+};
+var DE = {
+  timeframe: {
+    per_year: "pro Jahr",
+    per_month: "pro Monat",
+    per_week: "pro Woche",
+    per_day: "pro Tag",
+    per_hour: "pro Stunde"
+  },
+  rangePrefix: { from: "ab", upTo: "bis zu" },
+  seniority: {
+    entry_level: "Entry-Level",
+    associate: "Associate",
+    mid_level: "Mid-Level",
+    senior: "Senior",
+    lead: "Lead",
+    principal: "Principal",
+    director: "Director",
+    executive: "F\xFChrungskraft"
+  },
+  frames: {
+    entitySalariesTitle: ({ entity, range }) => `${entity} Geh\xE4lter (${range}/Jahr)`,
+    salariesInPlaceTitle: ({ place, range }) => `Geh\xE4lter in ${place} (${range}/Jahr)`,
+    salariesInPlaceTitleNoRange: ({ place }) => `Geh\xE4lter in ${place}`,
+    entitySalariesInPlaceTitle: ({ entity, place, range }) => `${entity} Geh\xE4lter in ${place} (${range}/Jahr)`,
+    companySalariesTitle: ({ company, range }) => `${company} Geh\xE4lter${range ? ` (${range}/Jahr)` : ""}`,
+    companyCategorySalariesTitle: ({ company, category, range }) => `${company} ${category} Geh\xE4lter${range ? ` (${range}/Jahr)` : ""}`,
+    professionalsEarn: ({ entity, range, count }) => `${entity}-Fachkr\xE4fte verdienen durchschnittlich ${range}/Jahr, basierend auf ${count} Stellenanzeigen.`,
+    rolesPay: ({ entity, range, count }) => `${entity}-Positionen werden mit durchschnittlich ${range}/Jahr verg\xFCtet, basierend auf ${count} Stellenanzeigen.`,
+    professionalsInLocationEarn: ({ entity, place, range, count }) => `${entity}-Fachkr\xE4fte in ${place} verdienen durchschnittlich ${range}/Jahr, basierend auf ${count} Stellenanzeigen.`,
+    seniorityRange: ({ lowLabel, lowAmount, highLabel, highAmount }) => `${lowLabel}-Positionen beginnen bei ${lowAmount}, ${highLabel}-Positionen erreichen ${highAmount}.`,
+    seniorityRangeWhile: ({ lowLabel, lowAmount, highLabel, highAmount }) => `${lowLabel}-Geh\xE4lter beginnen bei ${lowAmount}, w\xE4hrend ${highLabel}-Positionen ${highAmount} erreichen.`,
+    compareAcrossTopPaying: ({ count }) => `Vergleichen Sie ${count} ${count === 1 ? "bestzahlendes" : "bestzahlende"} Unternehmen.`,
+    compareAcrossTop: ({ count }) => `Vergleichen Sie ${count} Top-Unternehmen.`,
+    boardWideAverage: ({ entity, range }) => `Gesamtdurchschnitt ${entity}: ${range}/Jahr.`,
+    averageSalaryInCity: ({ place, range, count }) => `Das Durchschnittsgehalt in ${place} betr\xE4gt ${range}/Jahr, basierend auf ${count} Stellen. Gehaltsdaten nach Titel und F\xE4higkeiten durchsuchen.`,
+    browseLocationsInRegion: ({ count, place }) => `Gehaltsdaten f\xFCr ${count} Standorte in ${place} durchsuchen. Geh\xE4lter nach Titel, F\xE4higkeiten und Unternehmen vergleichen.`,
+    companyPays: ({ company, range, count }) => `${company} zahlt durchschnittlich ${range}/Jahr, basierend auf ${count} Stellenanzeigen.`,
+    breakdownAcrossCategories: ({ count }) => `Aufschl\xFCsselung \xFCber ${count} Job-${count === 1 ? "Kategorie" : "Kategorien"}.`,
+    compareWithSimilar: ({ count }) => `Vergleichen Sie mit ${count} \xE4hnlichen Unternehmen.`,
+    salaryInfoFor: ({ company, board }) => `Gehaltsinformationen f\xFCr ${company} auf ${board}.`,
+    categoryRolesAtCompanyPay: ({ category, company, range, count }) => `${category}-Positionen bei ${company} werden mit ${range}/Jahr verg\xFCtet, basierend auf ${count} Stellenanzeigen.`,
+    categorySalaryDataFor: ({ category, company, board }) => `${category}-Gehaltsdaten f\xFCr ${company} auf ${board}.`
+  }
+};
+var LEXICONS = { en: EN, de: DE };
+function getSalaryLexicon(locale) {
+  return locale && LEXICONS[locale] || EN;
+}
+
+// src/filters/index.ts
+var REMOTE_OPTIONS = [
+  "on_site",
+  "hybrid",
+  "remote"
+];
+var EMPLOYMENT_TYPES = [
+  "full_time",
+  "part_time",
+  "contract",
+  "internship",
+  "temporary"
+];
+var SENIORITIES = [
+  "entry_level",
+  "associate",
+  "mid_level",
+  "senior",
+  "lead",
+  "principal",
+  "director",
+  "executive"
+];
+var JOB_SORTS = [
+  "relevance",
+  "newest",
+  "salary_high"
+];
+var DEFAULT_SORT = "relevance";
+function seniorityLabels(locale) {
+  return getSalaryLexicon(locale).seniority;
+}
+function sortLabels(_locale) {
+  return {
+    relevance: "AI-ranked",
+    newest: "Most recent",
+    salary_high: "Salary: high to low"
+  };
+}
+var SENIORITY_LOOKUP = new Set(SENIORITIES);
+function parseSeniority(raw) {
+  const values = Array.isArray(raw) ? raw : typeof raw === "string" && raw ? raw.split(",") : [];
+  const result = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const value of values) {
+    if (typeof value !== "string") continue;
+    const normalized = value.trim().toLowerCase();
+    if (!normalized || seen.has(normalized)) continue;
+    if (!SENIORITY_LOOKUP.has(normalized)) continue;
+    seen.add(normalized);
+    result.push(normalized);
+  }
+  return result.length > 0 ? result : void 0;
+}
+function parseListingFilters(search) {
+  return {
+    q: typeof search.q === "string" && search.q ? search.q : void 0,
+    remoteOption: REMOTE_OPTIONS.includes(search.remoteOption) ? search.remoteOption : void 0,
+    employmentType: EMPLOYMENT_TYPES.includes(
+      search.employmentType
+    ) ? search.employmentType : void 0,
+    seniority: parseSeniority(search.seniority),
+    sort: JOB_SORTS.includes(search.sort) ? search.sort : void 0
+  };
+}