@cavuno/board 4.9.0 → 4.11.0

package/dist/index.js

@@ -179,6 +179,13 @@ var BOARD_API_ERROR_CODES = [
   "paywall_no_candidate_profile",
   "paywall_no_recurring_subscription",
   "paywall_offer_not_found",
+  // Employer talent-access paywall
+  "talent_access_unavailable",
+  "company_required",
+  "already_on_plan",
+  "talent_access_required",
+  "messaging_talent_access_required",
+  "stripe_not_connected",
   // Public job posting
   "job_posting_logo_lookup_unavailable",
   "job_posting_logo_not_found",
@@ -335,7 +342,7 @@ async function clearSession(storage) {
 }
 
 // src/version.ts
-var SDK_VERSION = "4.9.0";
+var SDK_VERSION = "4.11.0";
 
 // src/client.ts
 function isRawBody(body) {
@@ -1843,6 +1850,29 @@ function meNamespace(client) {
           );
         }
       },
+      /**
+       * Stripe Customer Portal for a company I am an approved member of.
+       * Surfaces every subscription on the company's Stripe customer (job
+       * posting + talent access). Not a talent-access portal — candidate
+       * `me.access.portal` is a different buyer.
+       */
+      billingPortal: {
+        /**
+         * Mint a Stripe Customer Portal session. Optional `returnPath` is
+         * resolved against the board origin.
+         *
+         * @example
+         * const { url } = await board.me.companies.billingPortal.create('acme', {
+         *   returnPath: '/employers/billing',
+         * });
+         */
+        create(slug, body, options) {
+          return client.fetch(
+            `/me/companies/${encodeURIComponent(slug)}/billing-portal`,
+            { ...options, method: "POST", body }
+          );
+        }
+      },
       /**
        * The read-only reporting funnel that backs the hosted employer jobs
        * table: per-job views / apply clicks / native applications,
@@ -2107,9 +2137,11 @@ function meNamespace(client) {
       }
     },
     /**
-     * The viewer's talent entitlement on this board — "does this
-     * employer have talent access?" for gating a Message-vs-upsell CTA.
-     * Candidates and unaffiliated viewers get `hasTalentAccess: false`.
+     * The employer talent-access paywall — "does this employer have
+     * talent access?" plus remaining company-scoped unlock/message credits
+     * and the charging model. Candidates and unaffiliated viewers get
+     * `hasTalentAccess: false`. Message credits spend inline on
+     * `conversations.start` (no separate spend endpoint).
      *
      * @example
      * const { hasTalentAccess } = await board.me.talentAccess.retrieve();
@@ -2117,12 +2149,94 @@ function meNamespace(client) {
     talentAccess: {
       /**
        * Retrieve the viewer's talent entitlement. Never cache — per-user.
+       * Credits are company-scoped; `companyId` is set when the viewer has
+       * exactly one approved membership, otherwise `null` (pass `companyId`
+       * on writes — `company_required` with more than one).
        *
        * @example
        * const access = await board.me.talentAccess.retrieve();
        */
       retrieve(options) {
         return client.fetch("/me/talent-access", options);
+      },
+      /**
+       * Per-candidate unlock and credit state for the opaque `/p/{id}`
+       * profile route. Named `/p/{handle}` is the share bypass.
+       *
+       * @example
+       * const gate = await board.me.talentAccess.retrieveCandidate(candidateId);
+       */
+      retrieveCandidate(candidateId, options) {
+        return client.fetch(
+          `/me/talent-access/candidates/${encodeURIComponent(candidateId)}`,
+          options
+        );
+      },
+      /**
+       * Start embedded checkout for a public `talent_access` plan and return
+       * a connected-account mount kit. Same shape as candidate-access
+       * checkout; session metadata is `origin: talent_access`. `companyId`
+       * is required when the viewer has more than one approved membership
+       * (`company_required`).
+       *
+       * @example
+       * const kit = await board.me.talentAccess.checkout({
+       *   planId,
+       *   returnPath: '/employers',
+       *   colorMode: 'light',
+       * });
+       */
+      checkout(body, options) {
+        return client.fetch(
+          "/me/talent-access/checkout",
+          { ...options, method: "POST", body }
+        );
+      },
+      /**
+       * Poll a talent-access checkout session: `open` (re-mountable via
+       * `clientSecret`), `complete`, or `expired`. The session must be
+       * `origin: talent_access` for this board user.
+       *
+       * @example
+       * const s = await board.me.talentAccess.retrieveCheckout(kit.sessionId);
+       */
+      retrieveCheckout(sessionId, options) {
+        return client.fetch(
+          `/me/talent-access/checkout/${encodeURIComponent(sessionId)}`,
+          options
+        );
+      },
+      /**
+       * Spend one profile-unlock credit. Idempotent: already-unlocked
+       * returns `{ alreadyUnlocked: true }` with no decrement. Credits are
+       * company-scoped; `companyId` is required with multiple approved
+       * memberships (`company_required`).
+       *
+       * @example
+       * const unlock = await board.me.talentAccess.unlock({ candidateId });
+       */
+      unlock(body, options) {
+        return client.fetch("/me/talent-access/unlocks", {
+          ...options,
+          method: "POST",
+          body
+        });
+      },
+      /**
+       * Swap the company's primary talent_access subscription to `planId`
+       * in place (prorated). Never a second checkout — Checkout would mint
+       * a parallel subscription. Requires an existing talent_access sub.
+       * `companyId` is required with multiple approved memberships.
+       *
+       * @example
+       * await board.me.talentAccess.upgrade({ planId });
+       */
+      upgrade(body, options) {
+        return client.fetch("/me/talent-access/upgrade", {
+          ...options,
+          method: "POST",
+          body
+        });
       }
     },
     /**

package/dist/index.mjs

@@ -15,7 +15,7 @@ import {
   isValidationError,
   resolveStorage,
   writeSession
-} from "./chunk-T46JASKG.mjs";
+} from "./chunk-XEJWXRLK.mjs";
 import {
   paginate
 } from "./chunk-DLSO6XXY.mjs";
@@ -39,7 +39,7 @@ function toSearchParams(query) {
 }
 
 // src/version.ts
-var SDK_VERSION = "4.9.0";
+var SDK_VERSION = "4.11.0";
 
 // src/client.ts
 function isRawBody(body) {
@@ -1547,6 +1547,29 @@ function meNamespace(client) {
           );
         }
       },
+      /**
+       * Stripe Customer Portal for a company I am an approved member of.
+       * Surfaces every subscription on the company's Stripe customer (job
+       * posting + talent access). Not a talent-access portal — candidate
+       * `me.access.portal` is a different buyer.
+       */
+      billingPortal: {
+        /**
+         * Mint a Stripe Customer Portal session. Optional `returnPath` is
+         * resolved against the board origin.
+         *
+         * @example
+         * const { url } = await board.me.companies.billingPortal.create('acme', {
+         *   returnPath: '/employers/billing',
+         * });
+         */
+        create(slug, body, options) {
+          return client.fetch(
+            `/me/companies/${encodeURIComponent(slug)}/billing-portal`,
+            { ...options, method: "POST", body }
+          );
+        }
+      },
       /**
        * The read-only reporting funnel that backs the hosted employer jobs
        * table: per-job views / apply clicks / native applications,
@@ -1811,9 +1834,11 @@ function meNamespace(client) {
       }
     },
     /**
-     * The viewer's talent entitlement on this board — "does this
-     * employer have talent access?" for gating a Message-vs-upsell CTA.
-     * Candidates and unaffiliated viewers get `hasTalentAccess: false`.
+     * The employer talent-access paywall — "does this employer have
+     * talent access?" plus remaining company-scoped unlock/message credits
+     * and the charging model. Candidates and unaffiliated viewers get
+     * `hasTalentAccess: false`. Message credits spend inline on
+     * `conversations.start` (no separate spend endpoint).
      *
      * @example
      * const { hasTalentAccess } = await board.me.talentAccess.retrieve();
@@ -1821,12 +1846,94 @@ function meNamespace(client) {
     talentAccess: {
       /**
        * Retrieve the viewer's talent entitlement. Never cache — per-user.
+       * Credits are company-scoped; `companyId` is set when the viewer has
+       * exactly one approved membership, otherwise `null` (pass `companyId`
+       * on writes — `company_required` with more than one).
        *
        * @example
        * const access = await board.me.talentAccess.retrieve();
        */
       retrieve(options) {
         return client.fetch("/me/talent-access", options);
+      },
+      /**
+       * Per-candidate unlock and credit state for the opaque `/p/{id}`
+       * profile route. Named `/p/{handle}` is the share bypass.
+       *
+       * @example
+       * const gate = await board.me.talentAccess.retrieveCandidate(candidateId);
+       */
+      retrieveCandidate(candidateId, options) {
+        return client.fetch(
+          `/me/talent-access/candidates/${encodeURIComponent(candidateId)}`,
+          options
+        );
+      },
+      /**
+       * Start embedded checkout for a public `talent_access` plan and return
+       * a connected-account mount kit. Same shape as candidate-access
+       * checkout; session metadata is `origin: talent_access`. `companyId`
+       * is required when the viewer has more than one approved membership
+       * (`company_required`).
+       *
+       * @example
+       * const kit = await board.me.talentAccess.checkout({
+       *   planId,
+       *   returnPath: '/employers',
+       *   colorMode: 'light',
+       * });
+       */
+      checkout(body, options) {
+        return client.fetch(
+          "/me/talent-access/checkout",
+          { ...options, method: "POST", body }
+        );
+      },
+      /**
+       * Poll a talent-access checkout session: `open` (re-mountable via
+       * `clientSecret`), `complete`, or `expired`. The session must be
+       * `origin: talent_access` for this board user.
+       *
+       * @example
+       * const s = await board.me.talentAccess.retrieveCheckout(kit.sessionId);
+       */
+      retrieveCheckout(sessionId, options) {
+        return client.fetch(
+          `/me/talent-access/checkout/${encodeURIComponent(sessionId)}`,
+          options
+        );
+      },
+      /**
+       * Spend one profile-unlock credit. Idempotent: already-unlocked
+       * returns `{ alreadyUnlocked: true }` with no decrement. Credits are
+       * company-scoped; `companyId` is required with multiple approved
+       * memberships (`company_required`).
+       *
+       * @example
+       * const unlock = await board.me.talentAccess.unlock({ candidateId });
+       */
+      unlock(body, options) {
+        return client.fetch("/me/talent-access/unlocks", {
+          ...options,
+          method: "POST",
+          body
+        });
+      },
+      /**
+       * Swap the company's primary talent_access subscription to `planId`
+       * in place (prorated). Never a second checkout — Checkout would mint
+       * a parallel subscription. Requires an existing talent_access sub.
+       * `companyId` is required with multiple approved memberships.
+       *
+       * @example
+       * await board.me.talentAccess.upgrade({ planId });
+       */
+      upgrade(body, options) {
+        return client.fetch("/me/talent-access/upgrade", {
+          ...options,
+          method: "POST",
+          body
+        });
       }
     },
     /**

package/dist/{jobs-Iv6Wkvvf.d.ts → jobs-3BAwXBxR.d.ts}

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

package/dist/{jobs-B7q3BgIK.d.mts → jobs-iG5udM2R.d.mts}

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

package/dist/{search-DC0jatQN.d.mts → search-5DzB-OrD.d.mts}

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

package/dist/{search-CbDZwdyl.d.ts → search-kfabRi5l.d.ts}

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

package/dist/{seo-HCE7aCkh.d.mts → seo-C_Mt1i-Y.d.mts}

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

package/dist/{seo-BDFUuvXM.d.ts → seo-DndU15zg.d.ts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-B9Ah8dNs.js';
+import { S as Schemas } from './_spec-Ck02NvUF.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-HCE7aCkh.mjs';
-import './_spec-B9Ah8dNs.mjs';
+import { B as BoardSeo } from './seo-C_Mt1i-Y.mjs';
+import './_spec-Ck02NvUF.mjs';
 
 /**
  * `@cavuno/board/seo-files` — platform-owned crawler/identity file bodies

package/dist/seo-files.d.ts

@@ -1,5 +1,5 @@
-import { B as BoardSeo } from './seo-BDFUuvXM.js';
-import './_spec-B9Ah8dNs.js';
+import { B as BoardSeo } from './seo-DndU15zg.js';
+import './_spec-Ck02NvUF.js';
 
 /**
  * `@cavuno/board/seo-files` — platform-owned crawler/identity file bodies

package/dist/seo.d.mts

@@ -1,9 +1,9 @@
-import { P as PublicBlogPostSummary, B as BlogAuthorEmbed } from './blog-BmqWfLZi.mjs';
-import { e as JsonLdObject } from './breadcrumbs-BVQL2dNY.mjs';
-export { A as ALL_COUNTRY_CODES, B as BreadcrumbItemInput, g as FaqItem, J as JobBreadcrumb, h as JsonLdBoard, N as NumberNotation, i as SENIORITY_ORDER, j as SalaryFaqEntry, k as SalaryJsonLdOptions, l as SalaryOccupationListOptions, b as buildJobBreadcrumbs, m as buildSalaryFaq, o as companyCategorySalaryJsonLd, p as companySalaryJsonLd, q as createBreadcrumbJsonLd, r as createJobPostingJsonLd, s as crossAxisSalaryJsonLd, t as faqJsonLd, c as formatSalaryStat, d as formatSalaryStatRange, u as itemListJsonLd, v as locationSalaryJsonLd, n as normalizeWebsiteUrl, w as skillSalaryJsonLd, x as sortBySeniority, y as titleSalaryJsonLd } from './breadcrumbs-BVQL2dNY.mjs';
-import './_spec-B9Ah8dNs.mjs';
-import './board-B4jLqmxn.mjs';
-import './jobs-B7q3BgIK.mjs';
+import { P as PublicBlogPostSummary, B as BlogAuthorEmbed } from './blog-CZUXieNu.mjs';
+import { e as JsonLdObject } from './breadcrumbs-DJjtyjlf.mjs';
+export { A as ALL_COUNTRY_CODES, B as BreadcrumbItemInput, g as FaqItem, J as JobBreadcrumb, h as JsonLdBoard, N as NumberNotation, i as SENIORITY_ORDER, j as SalaryFaqEntry, k as SalaryJsonLdOptions, l as SalaryOccupationListOptions, b as buildJobBreadcrumbs, m as buildSalaryFaq, o as companyCategorySalaryJsonLd, p as companySalaryJsonLd, q as createBreadcrumbJsonLd, r as createJobPostingJsonLd, s as crossAxisSalaryJsonLd, t as faqJsonLd, c as formatSalaryStat, d as formatSalaryStatRange, u as itemListJsonLd, v as locationSalaryJsonLd, n as normalizeWebsiteUrl, w as skillSalaryJsonLd, x as sortBySeniority, y as titleSalaryJsonLd } from './breadcrumbs-DJjtyjlf.mjs';
+import './_spec-Ck02NvUF.mjs';
+import './board-wHyyyAhT.mjs';
+import './jobs-iG5udM2R.mjs';
 
 /**
  * Blog structured data on the `@cavuno/board` wire types, transcribed from

package/dist/seo.d.ts

@@ -1,9 +1,9 @@
-import { P as PublicBlogPostSummary, B as BlogAuthorEmbed } from './blog-bh07fZ8Q.js';
-import { e as JsonLdObject } from './breadcrumbs-B1HVufC7.js';
-export { A as ALL_COUNTRY_CODES, B as BreadcrumbItemInput, g as FaqItem, J as JobBreadcrumb, h as JsonLdBoard, N as NumberNotation, i as SENIORITY_ORDER, j as SalaryFaqEntry, k as SalaryJsonLdOptions, l as SalaryOccupationListOptions, b as buildJobBreadcrumbs, m as buildSalaryFaq, o as companyCategorySalaryJsonLd, p as companySalaryJsonLd, q as createBreadcrumbJsonLd, r as createJobPostingJsonLd, s as crossAxisSalaryJsonLd, t as faqJsonLd, c as formatSalaryStat, d as formatSalaryStatRange, u as itemListJsonLd, v as locationSalaryJsonLd, n as normalizeWebsiteUrl, w as skillSalaryJsonLd, x as sortBySeniority, y as titleSalaryJsonLd } from './breadcrumbs-B1HVufC7.js';
-import './_spec-B9Ah8dNs.js';
-import './board-De8nLbk7.js';
-import './jobs-Iv6Wkvvf.js';
+import { P as PublicBlogPostSummary, B as BlogAuthorEmbed } from './blog-ClwNmr_N.js';
+import { e as JsonLdObject } from './breadcrumbs-CPaEpS6h.js';
+export { A as ALL_COUNTRY_CODES, B as BreadcrumbItemInput, g as FaqItem, J as JobBreadcrumb, h as JsonLdBoard, N as NumberNotation, i as SENIORITY_ORDER, j as SalaryFaqEntry, k as SalaryJsonLdOptions, l as SalaryOccupationListOptions, b as buildJobBreadcrumbs, m as buildSalaryFaq, o as companyCategorySalaryJsonLd, p as companySalaryJsonLd, q as createBreadcrumbJsonLd, r as createJobPostingJsonLd, s as crossAxisSalaryJsonLd, t as faqJsonLd, c as formatSalaryStat, d as formatSalaryStatRange, u as itemListJsonLd, v as locationSalaryJsonLd, n as normalizeWebsiteUrl, w as skillSalaryJsonLd, x as sortBySeniority, y as titleSalaryJsonLd } from './breadcrumbs-CPaEpS6h.js';
+import './_spec-Ck02NvUF.js';
+import './board-6XZx1x5M.js';
+import './jobs-3BAwXBxR.js';
 
 /**
  * Blog structured data on the `@cavuno/board` wire types, transcribed from

package/dist/server.d.mts

@@ -1,10 +1,10 @@
 import { BoardSdk } from './index.mjs';
-import './_spec-B9Ah8dNs.mjs';
-import './search-DC0jatQN.mjs';
-import './board-B4jLqmxn.mjs';
-import './jobs-B7q3BgIK.mjs';
-import './seo-HCE7aCkh.mjs';
-import './blog-BmqWfLZi.mjs';
+import './_spec-Ck02NvUF.mjs';
+import './search-5DzB-OrD.mjs';
+import './board-wHyyyAhT.mjs';
+import './jobs-iG5udM2R.mjs';
+import './seo-C_Mt1i-Y.mjs';
+import './blog-CZUXieNu.mjs';
 
 /**
  * Session cookie codec — pure (no framework imports, no node imports) so it

package/dist/server.d.ts

@@ -1,10 +1,10 @@
 import { BoardSdk } from './index.js';
-import './_spec-B9Ah8dNs.js';
-import './search-CbDZwdyl.js';
-import './board-De8nLbk7.js';
-import './jobs-Iv6Wkvvf.js';
-import './seo-BDFUuvXM.js';
-import './blog-bh07fZ8Q.js';
+import './_spec-Ck02NvUF.js';
+import './search-kfabRi5l.js';
+import './board-6XZx1x5M.js';
+import './jobs-3BAwXBxR.js';
+import './seo-DndU15zg.js';
+import './blog-ClwNmr_N.js';
 
 /**
  * Session cookie codec — pure (no framework imports, no node imports) so it

package/dist/server.mjs

@@ -2,7 +2,7 @@ import {
   isNoStore,
   isUnauthorized,
   scopeToken
-} from "./chunk-T46JASKG.mjs";
+} from "./chunk-XEJWXRLK.mjs";
 
 // src/server/cookie.ts
 var COOKIE_ATTRIBUTES = "Path=/; HttpOnly; Secure; SameSite=Lax";

package/dist/sitemap.d.mts

@@ -1,10 +1,10 @@
 import { BoardSdk } from './index.mjs';
-import './_spec-B9Ah8dNs.mjs';
-import './search-DC0jatQN.mjs';
-import './board-B4jLqmxn.mjs';
-import './jobs-B7q3BgIK.mjs';
-import './seo-HCE7aCkh.mjs';
-import './blog-BmqWfLZi.mjs';
+import './_spec-Ck02NvUF.mjs';
+import './search-5DzB-OrD.mjs';
+import './board-wHyyyAhT.mjs';
+import './jobs-iG5udM2R.mjs';
+import './seo-C_Mt1i-Y.mjs';
+import './blog-CZUXieNu.mjs';
 
 /**
  * Sitemap primitives — the pure XML + bucket-filename logic behind a board

package/dist/sitemap.d.ts

@@ -1,10 +1,10 @@
 import { BoardSdk } from './index.js';
-import './_spec-B9Ah8dNs.js';
-import './search-CbDZwdyl.js';
-import './board-De8nLbk7.js';
-import './jobs-Iv6Wkvvf.js';
-import './seo-BDFUuvXM.js';
-import './blog-bh07fZ8Q.js';
+import './_spec-Ck02NvUF.js';
+import './search-kfabRi5l.js';
+import './board-6XZx1x5M.js';
+import './jobs-3BAwXBxR.js';
+import './seo-DndU15zg.js';
+import './blog-ClwNmr_N.js';
 
 /**
  * Sitemap primitives — the pure XML + bucket-filename logic behind a board

package/dist/suggest.d.mts

@@ -1,5 +1,5 @@
-import { h as SuggestionItem, b as SearchSuggestQuery, F as FetchOptions, g as SuggestResult } from './search-DC0jatQN.mjs';
-import './_spec-B9Ah8dNs.mjs';
+import { h as SuggestionItem, b as SearchSuggestQuery, F as FetchOptions, g as SuggestResult } from './search-5DzB-OrD.mjs';
+import './_spec-Ck02NvUF.mjs';
 
 /**
  * `@cavuno/board/suggest` — framework-agnostic headless search-suggest

package/dist/suggest.d.ts

@@ -1,5 +1,5 @@
-import { h as SuggestionItem, b as SearchSuggestQuery, F as FetchOptions, g as SuggestResult } from './search-CbDZwdyl.js';
-import './_spec-B9Ah8dNs.js';
+import { h as SuggestionItem, b as SearchSuggestQuery, F as FetchOptions, g as SuggestResult } from './search-kfabRi5l.js';
+import './_spec-Ck02NvUF.js';
 
 /**
  * `@cavuno/board/suggest` — framework-agnostic headless search-suggest

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cavuno/board",
-  "version": "4.9.0",
+  "version": "4.11.0",
   "description": "Build custom job boards and careers pages with Cavuno’s TypeScript SDK.",
   "keywords": [
     "api-client",

package/skills/cavuno-board-setup/SKILL.md

@@ -64,6 +64,7 @@ Route each enabled capability to its focused skill:
 | Saved jobs and applications | `cavuno-board-applications` |
 | Messaging | `cavuno-board-messaging` |
 | Candidate paywall | `cavuno-board-paywall` |
+| Employer talent access | `cavuno-board-talent-access` |
 | Public job posting | `cavuno-board-post-a-job` |
 | Localized chrome | `cavuno-board-i18n` |
 | Metadata and structured data | `cavuno-board-seo` |