@cavuno/board 4.69.0 → 4.71.0

package/dist/index.js

@@ -146,6 +146,8 @@ var BOARD_API_ERROR_CODES = [
   // Job alerts (anonymous + authenticated)
   "job_alert_not_found",
   "job_alerts_disabled",
+  "job_alert_confirmation_send_failed",
+  "job_alert_email_suppressed",
   "candidate_alert_limit_reached",
   "candidate_alert_not_found",
   // Candidate account
@@ -200,6 +202,8 @@ var BOARD_API_ERROR_CODES = [
   "employer_not_member",
   "employer_payment_required",
   "employer_pipeline_stage_not_found",
+  "company_custom_field_not_found",
+  "company_custom_field_not_editable",
   "employer_member_not_found",
   "employer_invite_not_found",
   "not_company_admin",
@@ -447,7 +451,7 @@ async function clearSession(storage) {
 }
 
 // src/version.ts
-var SDK_VERSION = "4.69.0";
+var SDK_VERSION = "4.71.0";
 
 // src/client.ts
 function isRawBody(body) {
@@ -1411,13 +1415,21 @@ function jobAlertsNamespace(client) {
         body: input
       });
     },
-    /** Re-activate a previously unsubscribed subscription via the manage token. */
+    /**
+     * Resume a previously unsubscribed subscription via the manage token.
+     * `status` is `resubscribed`, or `confirmation_sent` when the address
+     * never confirmed: a confirmation email went out and the alerts start
+     * once it is clicked.
+     */
     resubscribe(input, options) {
-      return client.fetch("/job-alerts/resubscribe", {
-        ...options,
-        method: "POST",
-        body: input
-      });
+      return client.fetch(
+        "/job-alerts/resubscribe",
+        {
+          ...options,
+          method: "POST",
+          body: input
+        }
+      );
     },
     /** Edit a preference's filters/frequency via the manage token. */
     updatePreference(input, options) {
@@ -2263,7 +2275,10 @@ function meNamespace(client) {
           { ...options, method: "PATCH", body }
         );
       },
-      /** Retrieve profile custom fields for a company I belong to. */
+      /**
+       * Retrieve profile custom fields for a company I belong to, with the
+       * saved files of upload fields (`customFieldMedia`).
+       */
       retrieveCustomFields(slug, options) {
         return client.fetch(
           `/me/companies/${encodeURIComponent(slug)}/custom-fields`,
@@ -2277,6 +2292,26 @@ function meNamespace(client) {
           { ...options, method: "PATCH", body }
         );
       },
+      /**
+       * Upload one file to an owner-editable `image_gallery` or `file` field
+       * of a company I belong to (up to 10 MB; galleries take JPEG, PNG, WebP
+       * or GIF). The file is a draft until its `id` is saved to the field with
+       * `updateCustomFields`, as the ordered list of file IDs.
+       *
+       * @example
+       * const image = await board.me.companies.uploadCustomFieldFile('acme', 'office_photos', file);
+       * await board.me.companies.updateCustomFields('acme', {
+       *   values: { office_photos: [...savedIds, image.id] },
+       * });
+       */
+      uploadCustomFieldFile(slug, fieldKey, file, options) {
+        const form = new FormData();
+        form.append("file", file);
+        return client.fetch(
+          `/me/companies/${encodeURIComponent(slug)}/custom-fields/${encodeURIComponent(fieldKey)}/files`,
+          { ...options, method: "POST", body: form }
+        );
+      },
       /**
        * Delete a company I admin (soft-delete cascade + Forager
        * exclusion). Resolves void on success (204).
@@ -4803,6 +4838,29 @@ function createBoardClient(options) {
     seo(options2) {
       return client.fetch("/seo", options2);
     },
+    /**
+     * Sign an address up for the board's email from a newsletter form. Sends
+     * a confirmation email; nothing is granted until the person clicks it.
+     * Always resolves `{ status: 'submitted', sendingPaused }`. Limited to 3
+     * a minute per address and 10 requests a minute per IP; on a builder
+     * site Cavuno hosts the IP limit counts each visitor, plus 6 sign-ups a
+     * minute per visitor (429 `rate_limited`).
+     *
+     * @example
+     * await board.subscribe({
+     *   email,
+     *   consent: true,
+     *   consentText: 'Send me news and offers from Acme Jobs.',
+     *   source: 'blog-footer',
+     * });
+     */
+    subscribe(input, options2) {
+      return client.fetch("/subscribe", {
+        ...options2,
+        method: "POST",
+        body: input
+      });
+    },
     jobs: jobsNamespace(client),
     embed: embedNamespace(client),
     companies: companiesNamespace(client),

package/dist/index.mjs

@@ -28,7 +28,7 @@ import {
   isSsoRequired,
   isUnauthorized,
   isValidationError
-} from "./chunk-7SAHE7UW.mjs";
+} from "./chunk-AQD4OMX4.mjs";
 
 // src/query.ts
 function toSearchParams(query) {
@@ -49,7 +49,7 @@ function toSearchParams(query) {
 }
 
 // src/version.ts
-var SDK_VERSION = "4.69.0";
+var SDK_VERSION = "4.71.0";
 
 // src/client.ts
 function isRawBody(body) {
@@ -1010,13 +1010,21 @@ function jobAlertsNamespace(client) {
         body: input
       });
     },
-    /** Re-activate a previously unsubscribed subscription via the manage token. */
+    /**
+     * Resume a previously unsubscribed subscription via the manage token.
+     * `status` is `resubscribed`, or `confirmation_sent` when the address
+     * never confirmed: a confirmation email went out and the alerts start
+     * once it is clicked.
+     */
     resubscribe(input, options) {
-      return client.fetch("/job-alerts/resubscribe", {
-        ...options,
-        method: "POST",
-        body: input
-      });
+      return client.fetch(
+        "/job-alerts/resubscribe",
+        {
+          ...options,
+          method: "POST",
+          body: input
+        }
+      );
     },
     /** Edit a preference's filters/frequency via the manage token. */
     updatePreference(input, options) {
@@ -1862,7 +1870,10 @@ function meNamespace(client) {
           { ...options, method: "PATCH", body }
         );
       },
-      /** Retrieve profile custom fields for a company I belong to. */
+      /**
+       * Retrieve profile custom fields for a company I belong to, with the
+       * saved files of upload fields (`customFieldMedia`).
+       */
       retrieveCustomFields(slug, options) {
         return client.fetch(
           `/me/companies/${encodeURIComponent(slug)}/custom-fields`,
@@ -1876,6 +1887,26 @@ function meNamespace(client) {
           { ...options, method: "PATCH", body }
         );
       },
+      /**
+       * Upload one file to an owner-editable `image_gallery` or `file` field
+       * of a company I belong to (up to 10 MB; galleries take JPEG, PNG, WebP
+       * or GIF). The file is a draft until its `id` is saved to the field with
+       * `updateCustomFields`, as the ordered list of file IDs.
+       *
+       * @example
+       * const image = await board.me.companies.uploadCustomFieldFile('acme', 'office_photos', file);
+       * await board.me.companies.updateCustomFields('acme', {
+       *   values: { office_photos: [...savedIds, image.id] },
+       * });
+       */
+      uploadCustomFieldFile(slug, fieldKey, file, options) {
+        const form = new FormData();
+        form.append("file", file);
+        return client.fetch(
+          `/me/companies/${encodeURIComponent(slug)}/custom-fields/${encodeURIComponent(fieldKey)}/files`,
+          { ...options, method: "POST", body: form }
+        );
+      },
       /**
        * Delete a company I admin (soft-delete cascade + Forager
        * exclusion). Resolves void on success (204).
@@ -4372,6 +4403,29 @@ function createBoardClient(options) {
     seo(options2) {
       return client.fetch("/seo", options2);
     },
+    /**
+     * Sign an address up for the board's email from a newsletter form. Sends
+     * a confirmation email; nothing is granted until the person clicks it.
+     * Always resolves `{ status: 'submitted', sendingPaused }`. Limited to 3
+     * a minute per address and 10 requests a minute per IP; on a builder
+     * site Cavuno hosts the IP limit counts each visitor, plus 6 sign-ups a
+     * minute per visitor (429 `rate_limited`).
+     *
+     * @example
+     * await board.subscribe({
+     *   email,
+     *   consent: true,
+     *   consentText: 'Send me news and offers from Acme Jobs.',
+     *   source: 'blog-footer',
+     * });
+     */
+    subscribe(input, options2) {
+      return client.fetch("/subscribe", {
+        ...options2,
+        method: "POST",
+        body: input
+      });
+    },
     jobs: jobsNamespace(client),
     embed: embedNamespace(client),
     companies: companiesNamespace(client),

package/dist/{jobs-Dz_w1jZq.d.ts → jobs-BMG0vrVI.d.ts}

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

package/dist/{jobs-Cew_q69W.d.mts → jobs-xjE0IrNu.d.mts}

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

package/dist/{search-DwvgvtEg.d.mts → search-BJkiU3Ic.d.mts}

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

package/dist/{search-BqAYR47P.d.ts → search-suUh-E7O.d.ts}

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

package/dist/{seo-CGy4fY5a.d.ts → seo-CW1JjEXH.d.ts}

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

package/dist/{seo-FKj1pSHZ.d.mts → seo-DGdqWPLo.d.mts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-CFOj7Qdf.mjs';
+import { S as Schemas } from './_spec-OPrym0QJ.mjs';
 
 /**
  * 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-FKj1pSHZ.mjs';
-import './_spec-CFOj7Qdf.mjs';
+import { B as BoardSeo } from './seo-DGdqWPLo.mjs';
+import './_spec-OPrym0QJ.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-CGy4fY5a.js';
-import './_spec-CFOj7Qdf.js';
+import { B as BoardSeo } from './seo-CW1JjEXH.js';
+import './_spec-OPrym0QJ.js';
 
 /**
  * `@cavuno/board/seo-files` — platform-owned crawler/identity file bodies

package/dist/seo-files.js

@@ -50,6 +50,7 @@ function listingRoot(value, fallback) {
   return safeListingRoot(value) ?? fallback;
 }
 var LISTING_GROUPS = ["jobs", "companies", "talent"];
+var CONTENT_SIGNAL = "Content-Signal: search=yes, ai-input=yes, ai-train=yes";
 function paginationRules(root) {
   return [
     `Disallow: ${root}?page=`,
@@ -78,6 +79,11 @@ function robotsBody(input) {
   }
   return [
     "User-Agent: *",
+    // Content Signals (contentsignals.org): how crawlers may use the board's
+    // content once fetched. Boards opt in to every use. The line sits inside
+    // the `User-Agent: *` group so it applies to all agents. The sandbox body
+    // above leaves it out because it allows no crawling at all.
+    CONTENT_SIGNAL,
     "Allow: /",
     "Disallow: /go/",
     "Disallow: /t/",

package/dist/seo-files.mjs

@@ -18,6 +18,7 @@ function listingRoot(value, fallback) {
   return safeListingRoot(value) ?? fallback;
 }
 var LISTING_GROUPS = ["jobs", "companies", "talent"];
+var CONTENT_SIGNAL = "Content-Signal: search=yes, ai-input=yes, ai-train=yes";
 function paginationRules(root) {
   return [
     `Disallow: ${root}?page=`,
@@ -46,6 +47,11 @@ function robotsBody(input) {
   }
   return [
     "User-Agent: *",
+    // Content Signals (contentsignals.org): how crawlers may use the board's
+    // content once fetched. Boards opt in to every use. The line sits inside
+    // the `User-Agent: *` group so it applies to all agents. The sandbox body
+    // above leaves it out because it allows no crawling at all.
+    CONTENT_SIGNAL,
     "Allow: /",
     "Disallow: /go/",
     "Disallow: /t/",

package/dist/seo.d.mts

@@ -1,9 +1,9 @@
-import { P as PublicBlogPostSummary, B as BlogAuthorEmbed } from './blog-DCRBPnpZ.mjs';
-import { e as JsonLdObject } from './breadcrumbs-Dwf0yq7B.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-Dwf0yq7B.mjs';
-import './_spec-CFOj7Qdf.mjs';
-import './board-DMS3I3sJ.mjs';
-import './jobs-Cew_q69W.mjs';
+import { P as PublicBlogPostSummary, B as BlogAuthorEmbed } from './blog-CHQYIhHH.mjs';
+import { e as JsonLdObject } from './breadcrumbs-CSm6P79s.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-CSm6P79s.mjs';
+import './_spec-OPrym0QJ.mjs';
+import './board-Btc1dzQB.mjs';
+import './jobs-xjE0IrNu.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-BaVJi3q1.js';
-import { e as JsonLdObject } from './breadcrumbs-yGijUUtR.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-yGijUUtR.js';
-import './_spec-CFOj7Qdf.js';
-import './board-zLt7j6hj.js';
-import './jobs-Dz_w1jZq.js';
+import { P as PublicBlogPostSummary, B as BlogAuthorEmbed } from './blog-BlRb84MY.js';
+import { e as JsonLdObject } from './breadcrumbs-Bv76gXvF.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-Bv76gXvF.js';
+import './_spec-OPrym0QJ.js';
+import './board-D74R4Iml.js';
+import './jobs-BMG0vrVI.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-CFOj7Qdf.mjs';
-import './search-DwvgvtEg.mjs';
-import './jobs-Cew_q69W.mjs';
-import './board-DMS3I3sJ.mjs';
-import './seo-FKj1pSHZ.mjs';
-import './blog-DCRBPnpZ.mjs';
+import './_spec-OPrym0QJ.mjs';
+import './search-BJkiU3Ic.mjs';
+import './jobs-xjE0IrNu.mjs';
+import './board-Btc1dzQB.mjs';
+import './seo-DGdqWPLo.mjs';
+import './blog-CHQYIhHH.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-CFOj7Qdf.js';
-import './search-BqAYR47P.js';
-import './jobs-Dz_w1jZq.js';
-import './board-zLt7j6hj.js';
-import './seo-CGy4fY5a.js';
-import './blog-BaVJi3q1.js';
+import './_spec-OPrym0QJ.js';
+import './search-suUh-E7O.js';
+import './jobs-BMG0vrVI.js';
+import './board-D74R4Iml.js';
+import './seo-CW1JjEXH.js';
+import './blog-BlRb84MY.js';
 
 /**
  * Session cookie codec — pure (no framework imports, no node imports) so it

package/dist/server.mjs

@@ -4,7 +4,7 @@ import {
 } from "./chunk-Z4ALWIGS.mjs";
 import {
   isUnauthorized
-} from "./chunk-7SAHE7UW.mjs";
+} from "./chunk-AQD4OMX4.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-CFOj7Qdf.mjs';
-import './search-DwvgvtEg.mjs';
-import './jobs-Cew_q69W.mjs';
-import './board-DMS3I3sJ.mjs';
-import './seo-FKj1pSHZ.mjs';
-import './blog-DCRBPnpZ.mjs';
+import './_spec-OPrym0QJ.mjs';
+import './search-BJkiU3Ic.mjs';
+import './jobs-xjE0IrNu.mjs';
+import './board-Btc1dzQB.mjs';
+import './seo-DGdqWPLo.mjs';
+import './blog-CHQYIhHH.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-CFOj7Qdf.js';
-import './search-BqAYR47P.js';
-import './jobs-Dz_w1jZq.js';
-import './board-zLt7j6hj.js';
-import './seo-CGy4fY5a.js';
-import './blog-BaVJi3q1.js';
+import './_spec-OPrym0QJ.js';
+import './search-suUh-E7O.js';
+import './jobs-BMG0vrVI.js';
+import './board-D74R4Iml.js';
+import './seo-CW1JjEXH.js';
+import './blog-BlRb84MY.js';
 
 /**
  * Sitemap primitives — the pure XML + bucket-filename logic behind a board

package/dist/sitemap.mjs

@@ -3,7 +3,7 @@ import {
 } from "./chunk-DLSO6XXY.mjs";
 import {
   isNotFound
-} from "./chunk-7SAHE7UW.mjs";
+} from "./chunk-AQD4OMX4.mjs";
 import {
   BOARD_PATHS,
   blogAuthorPath,

package/dist/suggest.d.mts

@@ -1,5 +1,5 @@
-import { h as SuggestionItem, b as SearchSuggestQuery, F as FetchOptions, g as SuggestResult } from './search-DwvgvtEg.mjs';
-import './_spec-CFOj7Qdf.mjs';
+import { h as SuggestionItem, b as SearchSuggestQuery, F as FetchOptions, g as SuggestResult } from './search-BJkiU3Ic.mjs';
+import './_spec-OPrym0QJ.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-BqAYR47P.js';
-import './_spec-CFOj7Qdf.js';
+import { h as SuggestionItem, b as SearchSuggestQuery, F as FetchOptions, g as SuggestResult } from './search-suUh-E7O.js';
+import './_spec-OPrym0QJ.js';
 
 /**
  * `@cavuno/board/suggest` — framework-agnostic headless search-suggest

package/package.json

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

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

@@ -217,6 +217,22 @@ await board.me.profile.updateCustomFields({
 });
 ```
 
+Company members upload to the company's upload fields the same way, with the company slug first. `customFieldMedia` on `board.me.companies.retrieveCustomFields` lists the saved files.
+
+```ts snippet
+const company = await board.me.companies.retrieveCustomFields('acme');
+const photos = Array.isArray(company.values.office_photos)
+  ? company.values.office_photos
+  : [];
+const photo = await board.me.companies.uploadCustomFieldFile(
+  'acme',
+  'office_photos',
+  file);
+await board.me.companies.updateCustomFields('acme', {
+  values: { office_photos: [...photos, photo.id] },
+});
+```
+
 Resume upload starts an asynchronous parse that may populate the profile. Poll within a fixed budget, surface failure, and keep manual editing available if parsing runs long.
 
 ```ts snippet

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

@@ -28,6 +28,7 @@ await board.auth.register({
   email: 'ada@example.com',
   password: 'a-strong-password',
   displayName: 'Ada',
+  timeZone: browserTimeZone, // read in the browser, sent with the form
 });
 
 const session = await board.auth.login({
@@ -40,6 +41,8 @@ const session = await board.auth.login({
 
 For alternate entry points, use `requestMagicLink` / `consumeMagicLink` or the OAuth authorization and exchange methods exposed under `board.auth`.
 
+Pass `timeZone` to `register` and `consumeMagicLink`: the person's IANA time zone from `Intl.DateTimeFormat().resolvedOptions().timeZone`, read in their browser (such as `Europe/Berlin`). On your server it returns the server's zone, so never fill it in there. The board keeps the first value it gets for a person and ignores an invalid one, so it never fails the sign-up.
+
 **Complete when:** the chosen entry flow returns a session and `board.me.retrieve()` resolves as that board user.
 
 ## 3. Handle expiry explicitly

package/skills/cavuno-board-job-alerts/SKILL.md

@@ -16,6 +16,8 @@ Both lanes are available only when `board.context()` reports `features.jobAlerts
 
 `subscribe` requires consent and deliberately returns the same submitted response for new and existing addresses. `confirm` always resolves; its status owns the landing-page branch.
 
+Send the person's time zone as `timeZone`: read `Intl.DateTimeFormat().resolvedOptions().timeZone` in their browser (such as `Europe/Berlin`) and pass it with the form. On your server it returns the server's zone, so never fill it in there. The board keeps the first value it gets for a person and ignores an invalid one.
+
 ```ts snippet
 const submitted = await board.jobAlerts.subscribe({
   email: 'ada@example.com',
@@ -26,20 +28,28 @@ const submitted = await board.jobAlerts.subscribe({
     remoteOptions: ['remote'],
     placeSlugs: ['berlin'],
   },
+  timeZone: browserTimeZone, // read in the browser, sent with the form
 });
 
 const result = await board.jobAlerts.confirm({ token });
 switch (result.status) {
   case 'confirmed':
   case 'already_confirmed':
+  case 'waitlisted':
   case 'not_found':
     break;
+  case 'unsubscribed':
+    // Offer the subscribe form again (it emails a fresh confirmation link)
+    // or the manage page's resume option.
+    break;
   case 'expired':
     await board.jobAlerts.resendConfirmation({ email });
     break;
 }
 ```
 
+`waitlisted` means the alert is confirmed but the board can't send to more people yet; it starts once a spot opens. `unsubscribed` means the link was sent before the alerts were turned off, so it doesn't turn them back on. Subscribing again with the form sends that address a fresh confirmation email, at most once every 12 hours and never while it is suppressed or when the board's team unsubscribed the address; clicking it resumes the alerts. The manage link in an alert email (`board.jobAlerts.resubscribe`) and signing in to create an alert resume them too.
+
 Only `jobFunctions`, `placeSlugs`, and `remoteOptions` filter digest delivery. Seniority and salary fields are stored but do not scope delivery. The supported cadence is `weekly`.
 
 `jobFunctions` are category and skill slugs (the `slug` of a category or skill, such as `engineering` or `media-and-communication`). A digest matches a job when any entry equals one of the job's category or skill slugs. Prefer sending slugs. If you send display names or free-text keywords instead, the server slugifies each one when the alert is saved and matches it against the board's category and skill slugs, their aliases, and their board-language slugs. A display name that does not slugify to one of those (for example, a renamed category) is stored slugified and will not match, so send slugs whenever you have them. Alerts read back from the API therefore always carry slugs, so compare and display them as slugs.
@@ -95,6 +105,8 @@ await board.jobAlerts.deletePreference({
 
 `unsubscribe` and `resubscribe` accept an optional `preferenceId`. Each managed preference also includes its own `manageToken`.
 
+`resubscribe` returns `status`: `resubscribed` means the subscription is resumed. `confirmation_sent` means the address never confirmed, so a confirmation email went out instead; keep showing the alerts as off and tell the person to check their inbox. A 429 means rate limiting or a confirmation email requested in the last two minutes; nothing new was sent. A 409 (`job_alert_email_suppressed`) means the address never confirmed and can't receive email, so nothing was sent; keep the alerts off and don't retry. A 502 (`job_alert_confirmation_send_failed`) means the email could not be sent.
+
 `updatePreference` is a full replacement. Round-trip every retained value and always send `frequency`.
 
 ```ts snippet