@cavuno/board 4.42.0 → 4.45.0

package/dist/index.js

@@ -209,6 +209,8 @@ var BOARD_API_ERROR_CODES = [
   "talent_list_not_found",
   "sourced_candidate_not_found",
   "sourced_convert_unavailable",
+  // Saved people on a talent list: a list holds at most 500 people.
+  "talent_list_full",
   // Candidate job-access paywall
   "candidate_paywall_access_required",
   "paywall_already_active",
@@ -403,7 +405,7 @@ async function clearSession(storage) {
 }
 
 // src/version.ts
-var SDK_VERSION = "4.42.0";
+var SDK_VERSION = "4.45.0";
 
 // src/client.ts
 function isRawBody(body) {
@@ -1346,7 +1348,11 @@ function jobPostingNamespace(client) {
         { ...options, method: "POST", body: input }
       );
     },
-    /** List the credit options for a verified email (an option → `selectedBilling`). */
+    /**
+     * List the credit options for a verified email. To spend one, pass the
+     * option as `selectedBilling` and the same `verificationToken` as
+     * `billingVerificationToken` to `create`.
+     */
     getBillingOptions(input, options) {
       return client.fetch(
         "/job-postings/billing-options",
@@ -2486,9 +2492,12 @@ function meNamespace(client) {
         }
       },
       /**
-       * Company-owned saved predicates over the talent directory.
-       * Approved members share the same lists. Optional `job` binds a list
-       * to one company job; pass `job: null` on update to unbind.
+       * Company-owned saved searches over the talent directory. Each holds
+       * named filters and, optionally, saved people (`members`). Approved
+       * members share the same lists. Optional `job` links a list to one
+       * company job; pass `job: null` on update to unlink. Linking a list
+       * shortlists everyone saved to it onto that job; unlinking changes no
+       * pipeline.
        */
       talentLists: {
         /**
@@ -2530,7 +2539,10 @@ function meNamespace(client) {
             { ...options, method: "PATCH", body }
           );
         },
-        /** Delete a talent list. Sourced membership is unaffected. */
+        /**
+         * Delete a talent list and the people saved to it. Job pipelines and
+         * sourced membership are unaffected.
+         */
         remove(slug, listId, options) {
           return client.fetch(
             `/me/companies/${encodeURIComponent(
@@ -2538,6 +2550,90 @@ function meNamespace(client) {
             )}/talent-lists/${encodeURIComponent(listId)}`,
             { ...options, method: "DELETE" }
           );
+        },
+        /**
+         * The talent lists of a company one candidate is saved to — for
+         * showing which lists a Save control has ticked.
+         *
+         * @example
+         * const { data } = await board.me.companies.talentLists.memberships(
+         *   'acme',
+         *   { candidate: candidateId },
+         * );
+         * const saved = new Set(data.map((m) => m.listId));
+         */
+        memberships(slug, query, options) {
+          return client.fetch(
+            `/me/companies/${encodeURIComponent(slug)}/talent-list-memberships`,
+            { ...options, query }
+          );
+        },
+        /**
+         * People saved to a talent list (at most 500 per list).
+         */
+        members: {
+          /**
+           * List the people saved to a list as directory cards, most
+           * recently saved first unless `sort` or a keyword (`q`) is set;
+           * with a keyword, best match first. Cards are redacted as in the
+           * public directory when the board sells profile unlocks, except
+           * for candidates the company has unlocked. Runs the public
+           * talent directory search, with the same filters, restricted to
+           * the saved people, so a "Saved" view can combine with the
+           * list's filters. Blocked, hidden and deactivated
+           * candidates are omitted. `total` counts every visible saved
+           * person; `count` counts the ones the filters keep.
+           *
+           * @example
+           * const { data, total } =
+           *   await board.me.companies.talentLists.members.list(
+           *     'acme',
+           *     listId,
+           *     { skill: 'react' },
+           *   );
+           */
+          list(slug, listId, query, options) {
+            return client.fetch(
+              `/me/companies/${encodeURIComponent(
+                slug
+              )}/talent-lists/${encodeURIComponent(listId)}/members`,
+              { ...options, query }
+            );
+          },
+          /**
+           * Save a candidate to a list. Idempotent: saving someone already
+           * on it returns `created: false`. When the list is linked to a
+           * job, the candidate is also shortlisted onto that job unless they
+           * already have a pipeline row there. A full list raises
+           * `talent_list_full` (409).
+           *
+           * @example
+           * await board.me.companies.talentLists.members.add('acme', listId, {
+           *   candidateBoardUserId: candidateId,
+           * });
+           */
+          add(slug, listId, body, options) {
+            return client.fetch(
+              `/me/companies/${encodeURIComponent(
+                slug
+              )}/talent-lists/${encodeURIComponent(listId)}/members`,
+              { ...options, method: "POST", body }
+            );
+          },
+          /**
+           * Remove a candidate from a list. Idempotent. Never changes a job
+           * pipeline, including the linked job's.
+           */
+          remove(slug, listId, candidateBoardUserId, options) {
+            return client.fetch(
+              `/me/companies/${encodeURIComponent(
+                slug
+              )}/talent-lists/${encodeURIComponent(
+                listId
+              )}/members/${encodeURIComponent(candidateBoardUserId)}`,
+              { ...options, method: "DELETE" }
+            );
+          }
         }
       },
       /**
@@ -3753,9 +3849,10 @@ function sitemapNamespace(client) {
 function talentNamespace(client) {
   return {
     /**
-     * List the board's public talent directory — candidate cards ranked by
+     * List the board's talent directory — candidate cards ranked by
      * job-search status then most-recently-updated, the same ordering the
-     * hosted `/talent` page renders. Only `public` profiles appear.
+     * hosted `/talent` page renders. Anonymous callers see `public` profiles;
+     * a signed-in board user also sees `logged_in_only` ones.
      *
      * Throws `talent_directory_restricted` (403) when the board restricts the
      * directory to employers (render an employer upsell), or
@@ -3788,6 +3885,30 @@ function talentNamespace(client) {
         `/talent/${encodeURIComponent(handle)}`,
         options
       );
+    },
+    places: {
+      /**
+       * List the places the board's directory candidates live in, busiest
+       * first, each with how many candidates the caller can see there (a
+       * country counts every candidate in its cities). Anonymous callers get
+       * counts of `public` profiles; a signed-in board user also counts
+       * `logged_in_only` ones. Pass a place's `slug` as `talent.list`'s
+       * `place` filter. With `q`, returns location search matches instead,
+       * ranked as `taxonomy.places.list` ranks them.
+       *
+       * Same access errors as `talent.list`. Returns an empty list until the
+       * board's place counts are built.
+       *
+       * @example
+       * const { data: places } = await board.talent.places.list({ limit: 50 });
+       * const { data: matches } = await board.talent.places.list({ q: 'lon' });
+       */
+      list(query, options) {
+        return client.fetch("/talent/places", {
+          ...options,
+          query
+        });
+      }
     }
   };
 }

package/dist/index.mjs

@@ -25,7 +25,7 @@ import {
   isSsoRequired,
   isUnauthorized,
   isValidationError
-} from "./chunk-WSO6JN5C.mjs";
+} from "./chunk-DZD3DAEY.mjs";
 
 // src/query.ts
 function toSearchParams(query) {
@@ -46,7 +46,7 @@ function toSearchParams(query) {
 }
 
 // src/version.ts
-var SDK_VERSION = "4.42.0";
+var SDK_VERSION = "4.45.0";
 
 // src/client.ts
 function isRawBody(body) {
@@ -989,7 +989,11 @@ function jobPostingNamespace(client) {
         { ...options, method: "POST", body: input }
       );
     },
-    /** List the credit options for a verified email (an option → `selectedBilling`). */
+    /**
+     * List the credit options for a verified email. To spend one, pass the
+     * option as `selectedBilling` and the same `verificationToken` as
+     * `billingVerificationToken` to `create`.
+     */
     getBillingOptions(input, options) {
       return client.fetch(
         "/job-postings/billing-options",
@@ -2129,9 +2133,12 @@ function meNamespace(client) {
         }
       },
       /**
-       * Company-owned saved predicates over the talent directory.
-       * Approved members share the same lists. Optional `job` binds a list
-       * to one company job; pass `job: null` on update to unbind.
+       * Company-owned saved searches over the talent directory. Each holds
+       * named filters and, optionally, saved people (`members`). Approved
+       * members share the same lists. Optional `job` links a list to one
+       * company job; pass `job: null` on update to unlink. Linking a list
+       * shortlists everyone saved to it onto that job; unlinking changes no
+       * pipeline.
        */
       talentLists: {
         /**
@@ -2173,7 +2180,10 @@ function meNamespace(client) {
             { ...options, method: "PATCH", body }
           );
         },
-        /** Delete a talent list. Sourced membership is unaffected. */
+        /**
+         * Delete a talent list and the people saved to it. Job pipelines and
+         * sourced membership are unaffected.
+         */
         remove(slug, listId, options) {
           return client.fetch(
             `/me/companies/${encodeURIComponent(
@@ -2181,6 +2191,90 @@ function meNamespace(client) {
             )}/talent-lists/${encodeURIComponent(listId)}`,
             { ...options, method: "DELETE" }
           );
+        },
+        /**
+         * The talent lists of a company one candidate is saved to — for
+         * showing which lists a Save control has ticked.
+         *
+         * @example
+         * const { data } = await board.me.companies.talentLists.memberships(
+         *   'acme',
+         *   { candidate: candidateId },
+         * );
+         * const saved = new Set(data.map((m) => m.listId));
+         */
+        memberships(slug, query, options) {
+          return client.fetch(
+            `/me/companies/${encodeURIComponent(slug)}/talent-list-memberships`,
+            { ...options, query }
+          );
+        },
+        /**
+         * People saved to a talent list (at most 500 per list).
+         */
+        members: {
+          /**
+           * List the people saved to a list as directory cards, most
+           * recently saved first unless `sort` or a keyword (`q`) is set;
+           * with a keyword, best match first. Cards are redacted as in the
+           * public directory when the board sells profile unlocks, except
+           * for candidates the company has unlocked. Runs the public
+           * talent directory search, with the same filters, restricted to
+           * the saved people, so a "Saved" view can combine with the
+           * list's filters. Blocked, hidden and deactivated
+           * candidates are omitted. `total` counts every visible saved
+           * person; `count` counts the ones the filters keep.
+           *
+           * @example
+           * const { data, total } =
+           *   await board.me.companies.talentLists.members.list(
+           *     'acme',
+           *     listId,
+           *     { skill: 'react' },
+           *   );
+           */
+          list(slug, listId, query, options) {
+            return client.fetch(
+              `/me/companies/${encodeURIComponent(
+                slug
+              )}/talent-lists/${encodeURIComponent(listId)}/members`,
+              { ...options, query }
+            );
+          },
+          /**
+           * Save a candidate to a list. Idempotent: saving someone already
+           * on it returns `created: false`. When the list is linked to a
+           * job, the candidate is also shortlisted onto that job unless they
+           * already have a pipeline row there. A full list raises
+           * `talent_list_full` (409).
+           *
+           * @example
+           * await board.me.companies.talentLists.members.add('acme', listId, {
+           *   candidateBoardUserId: candidateId,
+           * });
+           */
+          add(slug, listId, body, options) {
+            return client.fetch(
+              `/me/companies/${encodeURIComponent(
+                slug
+              )}/talent-lists/${encodeURIComponent(listId)}/members`,
+              { ...options, method: "POST", body }
+            );
+          },
+          /**
+           * Remove a candidate from a list. Idempotent. Never changes a job
+           * pipeline, including the linked job's.
+           */
+          remove(slug, listId, candidateBoardUserId, options) {
+            return client.fetch(
+              `/me/companies/${encodeURIComponent(
+                slug
+              )}/talent-lists/${encodeURIComponent(
+                listId
+              )}/members/${encodeURIComponent(candidateBoardUserId)}`,
+              { ...options, method: "DELETE" }
+            );
+          }
         }
       },
       /**
@@ -3396,9 +3490,10 @@ function sitemapNamespace(client) {
 function talentNamespace(client) {
   return {
     /**
-     * List the board's public talent directory — candidate cards ranked by
+     * List the board's talent directory — candidate cards ranked by
      * job-search status then most-recently-updated, the same ordering the
-     * hosted `/talent` page renders. Only `public` profiles appear.
+     * hosted `/talent` page renders. Anonymous callers see `public` profiles;
+     * a signed-in board user also sees `logged_in_only` ones.
      *
      * Throws `talent_directory_restricted` (403) when the board restricts the
      * directory to employers (render an employer upsell), or
@@ -3431,6 +3526,30 @@ function talentNamespace(client) {
         `/talent/${encodeURIComponent(handle)}`,
         options
       );
+    },
+    places: {
+      /**
+       * List the places the board's directory candidates live in, busiest
+       * first, each with how many candidates the caller can see there (a
+       * country counts every candidate in its cities). Anonymous callers get
+       * counts of `public` profiles; a signed-in board user also counts
+       * `logged_in_only` ones. Pass a place's `slug` as `talent.list`'s
+       * `place` filter. With `q`, returns location search matches instead,
+       * ranked as `taxonomy.places.list` ranks them.
+       *
+       * Same access errors as `talent.list`. Returns an empty list until the
+       * board's place counts are built.
+       *
+       * @example
+       * const { data: places } = await board.talent.places.list({ limit: 50 });
+       * const { data: matches } = await board.talent.places.list({ q: 'lon' });
+       */
+      list(query, options) {
+        return client.fetch("/talent/places", {
+          ...options,
+          query
+        });
+      }
     }
   };
 }

package/dist/{jobs-SAkNWgAB.d.ts → jobs-C7UvN_dW.d.ts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-B2aizgxr.js';
+import { S as Schemas } from './_spec-CdNZDaaR.js';
 
 /**
  * Optional pagination metadata returned by Board API list operations.

package/dist/{jobs-C_eO-WfM.d.mts → jobs-D9ERWWda.d.mts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-B2aizgxr.mjs';
+import { S as Schemas } from './_spec-CdNZDaaR.mjs';
 
 /**
  * Optional pagination metadata returned by Board API list operations.

package/dist/{search-Cb3Aoa4c.d.mts → search-BMSNK85o.d.mts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-B2aizgxr.mjs';
+import { S as Schemas } from './_spec-CdNZDaaR.mjs';
 
 type Awaitable<T> = T | Promise<T>;
 /**

package/dist/{search-CVcMFOuJ.d.ts → search-D0TFnn1x.d.ts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-B2aizgxr.js';
+import { S as Schemas } from './_spec-CdNZDaaR.js';
 
 type Awaitable<T> = T | Promise<T>;
 /**

package/dist/{seo-DPVud7SH.d.mts → seo-C3WmgifR.d.mts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-B2aizgxr.mjs';
+import { S as Schemas } from './_spec-CdNZDaaR.mjs';
 
 /**
  * The public SEO-infra payload (`board.seo()`) — platform infrastructure a

package/dist/{seo-DgFBQTIK.d.ts → seo-CYmVKHsu.d.ts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-B2aizgxr.js';
+import { S as Schemas } from './_spec-CdNZDaaR.js';
 
 /**
  * The public SEO-infra payload (`board.seo()`) — platform infrastructure a

package/dist/seo-files.d.mts

@@ -1,5 +1,5 @@
-import { B as BoardSeo } from './seo-DPVud7SH.mjs';
-import './_spec-B2aizgxr.mjs';
+import { B as BoardSeo } from './seo-C3WmgifR.mjs';
+import './_spec-CdNZDaaR.mjs';
 
 /**
  * `@cavuno/board/seo-files` — platform-owned crawler/identity file bodies
@@ -18,13 +18,35 @@ declare const INDEXNOW_CACHE_CONTROL = "public, max-age=86400, must-revalidate";
 type SeoFileResponseInit = {
     method?: string;
 };
+/**
+ * The board's own listing roots, for boards that rename or localize their
+ * URL words (for example `/vacatures` in place of `/jobs`). Each root scopes
+ * one group of pagination `Disallow` rules. A missing, root (`/`) or unsafe
+ * value keeps the default English root for that group.
+ */
+type RobotsListingPaths = {
+    jobs?: string | null;
+    companies?: string | null;
+    talent?: string | null;
+};
 /** Lines of the hosted robots body (no sitemap line). Exported so tests and hosted can share the literal. */
 declare function robotsBody(input: {
     canonicalBase: string;
     sandbox?: boolean;
+    listingPaths?: RobotsListingPaths | null;
+    /**
+     * Listing roots of the board's secondary languages, served under a
+     * language prefix with that language's own URL words (for example
+     * `/de/stellen`). Each safe root adds one group of pagination rules after
+     * the base ones, in order. A missing, root or unsafe value adds nothing,
+     * and a root already listed is not repeated.
+     */
+    localeListingPaths?: readonly RobotsListingPaths[] | null;
 }): string;
 declare function robotsResponse(seo: Pick<BoardSeo, 'canonicalBase'> & {
     sandbox?: boolean;
+    listingPaths?: RobotsListingPaths | null;
+    localeListingPaths?: readonly RobotsListingPaths[] | null;
 }, init?: SeoFileResponseInit): Response;
 declare function adsTxtResponse(seo: Pick<BoardSeo, 'adsTxt'>, init?: SeoFileResponseInit): Response;
 declare function indexNowResponse(seo: Pick<BoardSeo, 'indexNowKey'>, init?: SeoFileResponseInit): Response;
@@ -33,4 +55,4 @@ declare function googleSiteVerificationMeta(token: string | null | undefined): {
     content: string;
 } | null;
 
-export { ADS_TXT_CACHE_CONTROL, INDEXNOW_CACHE_CONTROL, ROBOTS_CACHE_CONTROL, SEO_FILE_CONTENT_TYPE, type SeoFileResponseInit, adsTxtResponse, googleSiteVerificationMeta, indexNowResponse, robotsBody, robotsResponse };
+export { ADS_TXT_CACHE_CONTROL, INDEXNOW_CACHE_CONTROL, ROBOTS_CACHE_CONTROL, type RobotsListingPaths, SEO_FILE_CONTENT_TYPE, type SeoFileResponseInit, adsTxtResponse, googleSiteVerificationMeta, indexNowResponse, robotsBody, robotsResponse };

package/dist/seo-files.d.ts

@@ -1,5 +1,5 @@
-import { B as BoardSeo } from './seo-DgFBQTIK.js';
-import './_spec-B2aizgxr.js';
+import { B as BoardSeo } from './seo-CYmVKHsu.js';
+import './_spec-CdNZDaaR.js';
 
 /**
  * `@cavuno/board/seo-files` — platform-owned crawler/identity file bodies
@@ -18,13 +18,35 @@ declare const INDEXNOW_CACHE_CONTROL = "public, max-age=86400, must-revalidate";
 type SeoFileResponseInit = {
     method?: string;
 };
+/**
+ * The board's own listing roots, for boards that rename or localize their
+ * URL words (for example `/vacatures` in place of `/jobs`). Each root scopes
+ * one group of pagination `Disallow` rules. A missing, root (`/`) or unsafe
+ * value keeps the default English root for that group.
+ */
+type RobotsListingPaths = {
+    jobs?: string | null;
+    companies?: string | null;
+    talent?: string | null;
+};
 /** Lines of the hosted robots body (no sitemap line). Exported so tests and hosted can share the literal. */
 declare function robotsBody(input: {
     canonicalBase: string;
     sandbox?: boolean;
+    listingPaths?: RobotsListingPaths | null;
+    /**
+     * Listing roots of the board's secondary languages, served under a
+     * language prefix with that language's own URL words (for example
+     * `/de/stellen`). Each safe root adds one group of pagination rules after
+     * the base ones, in order. A missing, root or unsafe value adds nothing,
+     * and a root already listed is not repeated.
+     */
+    localeListingPaths?: readonly RobotsListingPaths[] | null;
 }): string;
 declare function robotsResponse(seo: Pick<BoardSeo, 'canonicalBase'> & {
     sandbox?: boolean;
+    listingPaths?: RobotsListingPaths | null;
+    localeListingPaths?: readonly RobotsListingPaths[] | null;
 }, init?: SeoFileResponseInit): Response;
 declare function adsTxtResponse(seo: Pick<BoardSeo, 'adsTxt'>, init?: SeoFileResponseInit): Response;
 declare function indexNowResponse(seo: Pick<BoardSeo, 'indexNowKey'>, init?: SeoFileResponseInit): Response;
@@ -33,4 +55,4 @@ declare function googleSiteVerificationMeta(token: string | null | undefined): {
     content: string;
 } | null;
 
-export { ADS_TXT_CACHE_CONTROL, INDEXNOW_CACHE_CONTROL, ROBOTS_CACHE_CONTROL, SEO_FILE_CONTENT_TYPE, type SeoFileResponseInit, adsTxtResponse, googleSiteVerificationMeta, indexNowResponse, robotsBody, robotsResponse };
+export { ADS_TXT_CACHE_CONTROL, INDEXNOW_CACHE_CONTROL, ROBOTS_CACHE_CONTROL, type RobotsListingPaths, SEO_FILE_CONTENT_TYPE, type SeoFileResponseInit, adsTxtResponse, googleSiteVerificationMeta, indexNowResponse, robotsBody, robotsResponse };

package/dist/seo-files.js

@@ -35,25 +35,54 @@ var SEO_FILE_CONTENT_TYPE = "text/plain; charset=utf-8";
 var ROBOTS_CACHE_CONTROL = "public, max-age=600, s-maxage=14400, stale-while-revalidate=86400";
 var ADS_TXT_CACHE_CONTROL = "public, max-age=3600, must-revalidate";
 var INDEXNOW_CACHE_CONTROL = "public, max-age=86400, must-revalidate";
+var DEFAULT_LISTING_PATHS = {
+  jobs: "/jobs",
+  companies: "/companies",
+  talent: "/talent"
+};
+var SAFE_LISTING_ROOT = /^(?:\/[^\s/*$?#]+)+$/;
+function safeListingRoot(value) {
+  if (typeof value !== "string") return null;
+  const root = value.replace(/\/+$/, "");
+  return SAFE_LISTING_ROOT.test(root) ? root : null;
+}
+function listingRoot(value, fallback) {
+  return safeListingRoot(value) ?? fallback;
+}
+var LISTING_GROUPS = ["jobs", "companies", "talent"];
+function paginationRules(root) {
+  return [
+    `Disallow: ${root}?page=`,
+    `Disallow: ${root}*&page=`,
+    `Disallow: ${root}/*?page=`
+  ];
+}
 function robotsBody(input) {
   if (input.sandbox) {
     return ["User-Agent: *", "Disallow: /", ""].join("\n");
   }
   const canonicalBase = input.canonicalBase.replace(/\/+$/, "");
+  const paths = input.listingPaths ?? {};
+  const baseRoots = LISTING_GROUPS.map(
+    (group) => listingRoot(paths[group], DEFAULT_LISTING_PATHS[group])
+  );
+  const seen = new Set(baseRoots);
+  const localeRoots = [];
+  for (const locale of input.localeListingPaths ?? []) {
+    for (const group of LISTING_GROUPS) {
+      const root = safeListingRoot(locale[group]);
+      if (root === null || seen.has(root)) continue;
+      seen.add(root);
+      localeRoots.push(root);
+    }
+  }
   return [
     "User-Agent: *",
     "Allow: /",
     "Disallow: /go/",
     "Disallow: /t/",
-    "Disallow: /jobs?page=",
-    "Disallow: /jobs*&page=",
-    "Disallow: /jobs/*?page=",
-    "Disallow: /companies?page=",
-    "Disallow: /companies*&page=",
-    "Disallow: /companies/*?page=",
-    "Disallow: /talent?page=",
-    "Disallow: /talent*&page=",
-    "Disallow: /talent/*?page=",
+    ...baseRoots.flatMap(paginationRules),
+    ...localeRoots.flatMap(paginationRules),
     "",
     `Sitemap: ${canonicalBase}/sitemap.xml`,
     ""
@@ -61,7 +90,12 @@ function robotsBody(input) {
 }
 function robotsResponse(seo, init) {
   return textFileResponse(
-    robotsBody({ canonicalBase: seo.canonicalBase, sandbox: seo.sandbox }),
+    robotsBody({
+      canonicalBase: seo.canonicalBase,
+      sandbox: seo.sandbox,
+      listingPaths: seo.listingPaths,
+      localeListingPaths: seo.localeListingPaths
+    }),
     ROBOTS_CACHE_CONTROL,
     init
   );