@cavuno/board 4.33.0 → 4.35.0

package/CHANGELOG.md

@@ -3,6 +3,51 @@
 This changelog records changes that affect Board API compatibility, exported
 types, runtime behavior, or supported integration patterns.
 
+## 4.35.0 — 2026-10-05
+
+- Boards can define custom employment types, such as "Casual", each with a
+  built-in type as its Google equivalent. Jobs gain
+  `customEmploymentType: { key, label } | null`; `employmentType` still holds
+  the built-in type, which is what Google for Jobs markup and job feeds use.
+  Show `customEmploymentType.label` when it is set.
+
+- The board context lists a board's custom types under
+  `jobForm.employmentType.customTypes` (`key`, `label`, `employmentType`,
+  `offered`) and the full display order under `jobForm.employmentType.order`.
+  `allowedOptions` and `customTypes` are returned in that order. Types that
+  are not offered stay listed so existing jobs keep their label.
+
+- Job search and listing accept a `customEmploymentType` filter (keys). A
+  built-in `employmentType` filter value now matches jobs of that type that
+  have no custom type, so "Part-time" does not return "Casual" jobs.
+
+- Job posting and employer job writes accept `customEmploymentType` (a key);
+  the matching built-in type is set automatically.
+
+- Links to non-image files in public company custom fields are signed and
+  expire after at least 24 hours, so they work on password-protected boards.
+  Request fresh company data rather than storing these links.
+
+## 4.34.0 — 2026-10-05
+
+- Added `analytics.recordConsent` to record a visitor's cookie-banner choice
+  (accepted, denied, or withdrawn) as proof of consent. It works without
+  `install` and sets no cookies.
+
+- The default analytics script URL points at a new tracker version. On boards
+  that require cookie consent, load the tracker with `analytics.install()`
+  only after the visitor accepts.
+
+- Jobs can have the status `pending_approval`: the job is waiting for an
+  operator to approve it and is not public, like a draft. Approve it with
+  `POST /v1/jobs/:id/publish` and reject it with `DELETE /v1/jobs/:id`.
+  Code that switches on job status should handle the new value.
+
+- Public company responses include `customFieldMedia`, which resolves files
+  in public image gallery and file custom fields to
+  `{ id, name, contentType, sizeBytes, url }`, keyed by field key. Use `url`
+  to render them.
+
 ## 4.33.0 — 2026-10-04
 
 - The default analytics script URL now includes a version query, so browsers

package/dist/{_spec-BdqHycDm.d.mts → _spec-DBpKC6Rv.d.mts}

@@ -319,6 +319,16 @@ interface components {
             enabled: boolean;
             boardName: string;
         };
+        BoardCustomEmploymentType: {
+            /** @description Stable key. Send it as `customEmploymentType` when posting a job, and filter jobs by it. */
+            key: string;
+            /** @description Display name, e.g. `Casual`. */
+            label: string;
+            /** @description The custom type's Google equivalent: a built-in employment type. Send it as `employmentType` alongside the key; it is what Google for Jobs and job feeds see. */
+            employmentType: string;
+            /** @description Whether posters can pick this type. An un-offered type still labels the jobs that already use it; leave it out of a posting form. */
+            offered: boolean;
+        };
         BoardFormBuiltinField: {
             /**
              * @description discriminator enum property added by openapi-typescript
@@ -704,6 +714,10 @@ interface components {
             customFieldValues: {
                 [key: string]: string | number | boolean | string[];
             };
+            /** @description Resolved files for public `image_gallery` and `file` company custom fields, keyed by field key like `customFieldValues`, in the stored order. Each file `id` matches a value in `customFieldValues`. Use `url` to render: published images are permanent public asset URLs (e.g. `https://assets.cavuno.com/...`); other files, and images still being published, use a signed download URL that expires after at least 24 hours. Fields with no files are omitted. */
+            customFieldMedia: {
+                [key: string]: components["schemas"]["ProfileFieldMedia"][];
+            };
             /** @description Resolved public object references attached to this company. Private references are omitted. */
             objectReferences: components["schemas"]["ResolvedProfileObjectReference"][];
             links: components["schemas"]["PublicCompanyLinks"];
@@ -944,6 +958,8 @@ interface components {
                 title: string;
                 description: string;
                 employmentType: string;
+                /** @description Key of one of the board's custom employment types (board context `jobForm.employmentType.customTypes`). `employmentType` must be the Google equivalent of that type; an unknown key, a type with `offered: false`, or a different `employmentType` returns `400`. */
+                customEmploymentType?: string;
                 remoteOption: string;
                 officeLocations: {
                     /**
@@ -1240,10 +1256,12 @@ interface components {
             /** @description URL-friendly slug for the job. Auto-generated from `title` when omitted. */
             slug?: string;
             /**
-             * @description Employment type of the role.
+             * @description Employment type of the role. When `customEmploymentType` is also sent, this must be the Google equivalent of that custom type (or be omitted: the server sets it). Sending a built-in type without `customEmploymentType` clears any custom type on the job.
              * @enum {string}
              */
             employmentType?: "full_time" | "part_time" | "contract" | "internship" | "temporary" | "volunteer" | "other";
+            /** @description Key of one of the board's custom employment types (`GET /v1/settings/job-form` → `employmentType.customTypes`). The job is saved with the Google equivalent of that type as its built-in `employmentType`, which is what Google for Jobs and feeds see. An unknown key, a type the board no longer offers (`offered: false`), or an `employmentType` that differs from its Google equivalent returns `400 jobs_constraint_violation`. Pass `null` to clear the custom type and keep the built-in; omitted means unchanged. */
+            customEmploymentType?: string | null;
             /**
              * @description **Required.** Whether the role is on-site, hybrid, or fully remote: one of `on_site`, `hybrid`, `remote`. Omitting it or sending `null` returns `400`. It is not valid on its own either: `on_site` and `hybrid` require at least one `officeLocations` entry, and `remote` requires `remotePermits` (use `[{"type":"worldwide","value":"worldwide"}]` for anywhere; `remoteTimezones` then auto-derives on POST).
              * @enum {string}
@@ -1425,17 +1443,24 @@ interface components {
             /** @description URL-friendly slug used in public board URLs, or `null` if no slug is set. */
             slug: string | null;
             /**
-             * @description Current status of the job. One of `draft`, `published`, `expired`, or `archived`.
+             * @description Current status of the job. One of `draft`, `published`, `expired`, `archived`, or `pending_approval`. A `pending_approval` job is waiting for an operator to approve it: approve with `POST /v1/jobs/:id/publish`, reject with `DELETE /v1/jobs/:id`. It is not public, like a draft.
              * @enum {string}
              */
-            status: "draft" | "published" | "expired" | "archived";
+            status: "draft" | "published" | "expired" | "archived" | "pending_approval";
             /** @description Identifier of the company the job belongs to, or `null` if no company is attached. */
             companyId: string | null;
             /**
-             * @description Employment type of the role, or `null` if not specified.
+             * @description Employment type of the role, or `null` if not specified. For a job with a custom employment type, this is the Google equivalent of the custom type.
              * @enum {string|null}
              */
             employmentType: "full_time" | "part_time" | "contract" | "internship" | "temporary" | "volunteer" | "other" | null;
+            /** @description The board's custom employment type for this job (for example `Casual`), or `null` when the job uses a built-in type only. A deleted custom type reads back as `null` and the job shows its built-in `employmentType`. */
+            customEmploymentType: {
+                /** @description Stable key of the custom employment type. Never changes. */
+                key: string;
+                /** @description Display name of the custom employment type, as configured. */
+                label: string;
+            } | null;
             /**
              * @description Whether the role is on-site, hybrid, or fully remote. `null` only on older jobs saved without one; create requires it and `PATCH` cannot clear it.
              * @enum {string|null}
@@ -1535,10 +1560,12 @@ interface components {
             /** @description URL-friendly slug for the job. Auto-generated from `title` when omitted. */
             slug?: string;
             /**
-             * @description Employment type of the role.
+             * @description Employment type of the role. When `customEmploymentType` is also sent, this must be the Google equivalent of that custom type (or be omitted: the server sets it). Sending a built-in type without `customEmploymentType` clears any custom type on the job.
              * @enum {string}
              */
             employmentType?: "full_time" | "part_time" | "contract" | "internship" | "temporary" | "volunteer" | "other";
+            /** @description Key of one of the board's custom employment types (`GET /v1/settings/job-form` → `employmentType.customTypes`). The job is saved with the Google equivalent of that type as its built-in `employmentType`, which is what Google for Jobs and feeds see. An unknown key, a type the board no longer offers (`offered: false`), or an `employmentType` that differs from its Google equivalent returns `400 jobs_constraint_violation`. Pass `null` to clear the custom type and keep the built-in; omitted means unchanged. */
+            customEmploymentType?: string | null;
             /**
              * @description Whether the role is on-site, hybrid, or fully remote. Omitted means unchanged; `null` returns `400` because a job's workplace type can be changed but not cleared. **Never valid on its own:** `on_site` and `hybrid` require at least one `officeLocations` entry, and `remote` requires `remotePermits` (use `[{"type":"worldwide","value":"worldwide"}]` for anywhere; `remoteTimezones` then auto-derives on POST). Sending it alone returns `400`.
              * @enum {string}
@@ -2130,6 +2157,18 @@ interface components {
             min?: number;
             max?: number;
         };
+        ProfileFieldMedia: {
+            /** @description File identifier. Matches the value stored for the field in `customFieldValues`. */
+            id: string;
+            /** @description Original file name. */
+            name: string;
+            /** @description MIME type of the file. */
+            contentType: string;
+            /** @description Size of the file, in bytes. */
+            sizeBytes: number;
+            /** @description Absolute, browser-loadable URL. Published images are permanent public asset URLs (e.g. `https://assets.cavuno.com/...`) safe to cache and hotlink. Other files, and an image saved moments ago that is still being published, use a signed download URL that expires after at least 24 hours and works on password-protected boards without a password grant, so read the URL from the response rather than storing it. */
+            url: string;
+        };
         ProfileFieldValuesBody: {
             values: {
                 [key: string]: string | number | boolean | string[] | unknown;
@@ -2385,8 +2424,12 @@ interface components {
                     allowedOptions: string[];
                 };
                 employmentType: {
-                    /** @description Employment types the board accepts, fully resolved like `seniority.allowedOptions`. A single entry means the form must collapse the field. */
+                    /** @description Built-in employment types the board accepts, fully resolved like `seniority.allowedOptions` and sorted by `order`. Empty when the board offers only custom types (`customTypes`). When the built-ins and offered custom types together come to a single option, the form must collapse the field. */
                     allowedOptions: string[];
+                    /** @description The board's custom employment types, sorted by `order`, offered or not. Offer the `offered` ones next to `allowedOptions` in a posting form's employment type picker; use all of them to label jobs. Always an array (empty when the board defines none). */
+                    customTypes: components["schemas"]["BoardCustomEmploymentType"][];
+                    /** @description The board's employment type display order: every built-in value and every custom type key, each once. Sort a posting form's employment type picker by it. */
+                    order: string[];
                 };
             };
             forms: components["schemas"]["BoardForms"];
@@ -2461,17 +2504,24 @@ interface components {
             /** @description URL-friendly slug used in public board URLs, or `null` if no slug is set. */
             slug: string | null;
             /**
-             * @description Current status of the job. One of `draft`, `published`, `expired`, or `archived`.
+             * @description Current status of the job. One of `draft`, `published`, `expired`, `archived`, or `pending_approval`. A `pending_approval` job is waiting for an operator to approve it: approve with `POST /v1/jobs/:id/publish`, reject with `DELETE /v1/jobs/:id`. It is not public, like a draft.
              * @enum {string}
              */
-            status: "draft" | "published" | "expired" | "archived";
+            status: "draft" | "published" | "expired" | "archived" | "pending_approval";
             /** @description Identifier of the company the job belongs to, or `null` if no company is attached. */
             companyId: string | null;
             /**
-             * @description Employment type of the role, or `null` if not specified.
+             * @description Employment type of the role, or `null` if not specified. For a job with a custom employment type, this is the Google equivalent of the custom type.
              * @enum {string|null}
              */
             employmentType: "full_time" | "part_time" | "contract" | "internship" | "temporary" | "volunteer" | "other" | null;
+            /** @description The board's custom employment type for this job (for example `Casual`), or `null` when the job uses a built-in type only. A deleted custom type reads back as `null` and the job shows its built-in `employmentType`. */
+            customEmploymentType: {
+                /** @description Stable key of the custom employment type. Never changes. */
+                key: string;
+                /** @description Display name of the custom employment type, as configured. */
+                label: string;
+            } | null;
             /**
              * @description Whether the role is on-site, hybrid, or fully remote. `null` only on older jobs saved without one; create requires it and `PATCH` cannot clear it.
              * @enum {string|null}
@@ -2640,8 +2690,18 @@ interface components {
              * @description ISO 8601 publish timestamp, or `null` if unpublished.
              */
             publishedAt: string | null;
-            /** @enum {string|null} */
+            /**
+             * @description Built-in employment type. For a job with a custom employment type, the Google equivalent of that type.
+             * @enum {string|null}
+             */
             employmentType: "full_time" | "part_time" | "contract" | "internship" | "temporary" | "volunteer" | "other" | null;
+            /** @description The board's custom employment type for this job (show its `label` instead of the built-in), or `null`. */
+            customEmploymentType: {
+                /** @description Stable key of the custom employment type. Never changes. */
+                key: string;
+                /** @description Display name of the custom employment type, as configured. */
+                label: string;
+            } | null;
             /** @enum {string|null} */
             remoteOption: "on_site" | "hybrid" | "remote" | null;
             /** @description Display region label for remote jobs (e.g. "United States", "Worldwide"); `null` for non-remote jobs. */
@@ -2757,8 +2817,10 @@ interface components {
                 companySlug?: string[];
                 /** @description Only return jobs with any of the given remote-work options. Up to 10 values. */
                 remoteOption?: ("on_site" | "hybrid" | "remote")[];
-                /** @description Only return jobs with any of the given employment types. Up to 10 values. */
+                /** @description Only return jobs with any of the given built-in employment types. Up to 10 values. A built-in value matches jobs of that type that have no custom employment type: a job with a custom type matches only through `customEmploymentType`. Combined with `customEmploymentType` as a union. */
                 employmentType?: ("full_time" | "part_time" | "contract" | "internship" | "temporary" | "volunteer" | "other")[];
+                /** @description Only return jobs with any of the given custom employment type keys (the board's `customTypes`). Up to 10 values. Combined with `employmentType` as a union: a job matches when it has one of these custom types OR one of the given built-in types and no custom type. */
+                customEmploymentType?: string[];
                 /** @description Only return jobs at any of the given seniority levels. Up to 10 values. */
                 seniority?: ("entry_level" | "associate" | "mid_level" | "senior" | "lead" | "principal" | "director" | "executive")[];
                 /** @description Only return jobs tagged with any of the given category slugs. Up to 10 values. Accepts the `sourceSlug` or the board-language `canonicalSlug` from `GET /v1/boards/{identifier}/categories`, or a `slug` from a job card's `categories`. Unknown slugs match no jobs. */

package/dist/{_spec-BdqHycDm.d.ts → _spec-DBpKC6Rv.d.ts}

@@ -319,6 +319,16 @@ interface components {
             enabled: boolean;
             boardName: string;
         };
+        BoardCustomEmploymentType: {
+            /** @description Stable key. Send it as `customEmploymentType` when posting a job, and filter jobs by it. */
+            key: string;
+            /** @description Display name, e.g. `Casual`. */
+            label: string;
+            /** @description The custom type's Google equivalent: a built-in employment type. Send it as `employmentType` alongside the key; it is what Google for Jobs and job feeds see. */
+            employmentType: string;
+            /** @description Whether posters can pick this type. An un-offered type still labels the jobs that already use it; leave it out of a posting form. */
+            offered: boolean;
+        };
         BoardFormBuiltinField: {
             /**
              * @description discriminator enum property added by openapi-typescript
@@ -704,6 +714,10 @@ interface components {
             customFieldValues: {
                 [key: string]: string | number | boolean | string[];
             };
+            /** @description Resolved files for public `image_gallery` and `file` company custom fields, keyed by field key like `customFieldValues`, in the stored order. Each file `id` matches a value in `customFieldValues`. Use `url` to render: published images are permanent public asset URLs (e.g. `https://assets.cavuno.com/...`); other files, and images still being published, use a signed download URL that expires after at least 24 hours. Fields with no files are omitted. */
+            customFieldMedia: {
+                [key: string]: components["schemas"]["ProfileFieldMedia"][];
+            };
             /** @description Resolved public object references attached to this company. Private references are omitted. */
             objectReferences: components["schemas"]["ResolvedProfileObjectReference"][];
             links: components["schemas"]["PublicCompanyLinks"];
@@ -944,6 +958,8 @@ interface components {
                 title: string;
                 description: string;
                 employmentType: string;
+                /** @description Key of one of the board's custom employment types (board context `jobForm.employmentType.customTypes`). `employmentType` must be the Google equivalent of that type; an unknown key, a type with `offered: false`, or a different `employmentType` returns `400`. */
+                customEmploymentType?: string;
                 remoteOption: string;
                 officeLocations: {
                     /**
@@ -1240,10 +1256,12 @@ interface components {
             /** @description URL-friendly slug for the job. Auto-generated from `title` when omitted. */
             slug?: string;
             /**
-             * @description Employment type of the role.
+             * @description Employment type of the role. When `customEmploymentType` is also sent, this must be the Google equivalent of that custom type (or be omitted: the server sets it). Sending a built-in type without `customEmploymentType` clears any custom type on the job.
              * @enum {string}
              */
             employmentType?: "full_time" | "part_time" | "contract" | "internship" | "temporary" | "volunteer" | "other";
+            /** @description Key of one of the board's custom employment types (`GET /v1/settings/job-form` → `employmentType.customTypes`). The job is saved with the Google equivalent of that type as its built-in `employmentType`, which is what Google for Jobs and feeds see. An unknown key, a type the board no longer offers (`offered: false`), or an `employmentType` that differs from its Google equivalent returns `400 jobs_constraint_violation`. Pass `null` to clear the custom type and keep the built-in; omitted means unchanged. */
+            customEmploymentType?: string | null;
             /**
              * @description **Required.** Whether the role is on-site, hybrid, or fully remote: one of `on_site`, `hybrid`, `remote`. Omitting it or sending `null` returns `400`. It is not valid on its own either: `on_site` and `hybrid` require at least one `officeLocations` entry, and `remote` requires `remotePermits` (use `[{"type":"worldwide","value":"worldwide"}]` for anywhere; `remoteTimezones` then auto-derives on POST).
              * @enum {string}
@@ -1425,17 +1443,24 @@ interface components {
             /** @description URL-friendly slug used in public board URLs, or `null` if no slug is set. */
             slug: string | null;
             /**
-             * @description Current status of the job. One of `draft`, `published`, `expired`, or `archived`.
+             * @description Current status of the job. One of `draft`, `published`, `expired`, `archived`, or `pending_approval`. A `pending_approval` job is waiting for an operator to approve it: approve with `POST /v1/jobs/:id/publish`, reject with `DELETE /v1/jobs/:id`. It is not public, like a draft.
              * @enum {string}
              */
-            status: "draft" | "published" | "expired" | "archived";
+            status: "draft" | "published" | "expired" | "archived" | "pending_approval";
             /** @description Identifier of the company the job belongs to, or `null` if no company is attached. */
             companyId: string | null;
             /**
-             * @description Employment type of the role, or `null` if not specified.
+             * @description Employment type of the role, or `null` if not specified. For a job with a custom employment type, this is the Google equivalent of the custom type.
              * @enum {string|null}
              */
             employmentType: "full_time" | "part_time" | "contract" | "internship" | "temporary" | "volunteer" | "other" | null;
+            /** @description The board's custom employment type for this job (for example `Casual`), or `null` when the job uses a built-in type only. A deleted custom type reads back as `null` and the job shows its built-in `employmentType`. */
+            customEmploymentType: {
+                /** @description Stable key of the custom employment type. Never changes. */
+                key: string;
+                /** @description Display name of the custom employment type, as configured. */
+                label: string;
+            } | null;
             /**
              * @description Whether the role is on-site, hybrid, or fully remote. `null` only on older jobs saved without one; create requires it and `PATCH` cannot clear it.
              * @enum {string|null}
@@ -1535,10 +1560,12 @@ interface components {
             /** @description URL-friendly slug for the job. Auto-generated from `title` when omitted. */
             slug?: string;
             /**
-             * @description Employment type of the role.
+             * @description Employment type of the role. When `customEmploymentType` is also sent, this must be the Google equivalent of that custom type (or be omitted: the server sets it). Sending a built-in type without `customEmploymentType` clears any custom type on the job.
              * @enum {string}
              */
             employmentType?: "full_time" | "part_time" | "contract" | "internship" | "temporary" | "volunteer" | "other";
+            /** @description Key of one of the board's custom employment types (`GET /v1/settings/job-form` → `employmentType.customTypes`). The job is saved with the Google equivalent of that type as its built-in `employmentType`, which is what Google for Jobs and feeds see. An unknown key, a type the board no longer offers (`offered: false`), or an `employmentType` that differs from its Google equivalent returns `400 jobs_constraint_violation`. Pass `null` to clear the custom type and keep the built-in; omitted means unchanged. */
+            customEmploymentType?: string | null;
             /**
              * @description Whether the role is on-site, hybrid, or fully remote. Omitted means unchanged; `null` returns `400` because a job's workplace type can be changed but not cleared. **Never valid on its own:** `on_site` and `hybrid` require at least one `officeLocations` entry, and `remote` requires `remotePermits` (use `[{"type":"worldwide","value":"worldwide"}]` for anywhere; `remoteTimezones` then auto-derives on POST). Sending it alone returns `400`.
              * @enum {string}
@@ -2130,6 +2157,18 @@ interface components {
             min?: number;
             max?: number;
         };
+        ProfileFieldMedia: {
+            /** @description File identifier. Matches the value stored for the field in `customFieldValues`. */
+            id: string;
+            /** @description Original file name. */
+            name: string;
+            /** @description MIME type of the file. */
+            contentType: string;
+            /** @description Size of the file, in bytes. */
+            sizeBytes: number;
+            /** @description Absolute, browser-loadable URL. Published images are permanent public asset URLs (e.g. `https://assets.cavuno.com/...`) safe to cache and hotlink. Other files, and an image saved moments ago that is still being published, use a signed download URL that expires after at least 24 hours and works on password-protected boards without a password grant, so read the URL from the response rather than storing it. */
+            url: string;
+        };
         ProfileFieldValuesBody: {
             values: {
                 [key: string]: string | number | boolean | string[] | unknown;
@@ -2385,8 +2424,12 @@ interface components {
                     allowedOptions: string[];
                 };
                 employmentType: {
-                    /** @description Employment types the board accepts, fully resolved like `seniority.allowedOptions`. A single entry means the form must collapse the field. */
+                    /** @description Built-in employment types the board accepts, fully resolved like `seniority.allowedOptions` and sorted by `order`. Empty when the board offers only custom types (`customTypes`). When the built-ins and offered custom types together come to a single option, the form must collapse the field. */
                     allowedOptions: string[];
+                    /** @description The board's custom employment types, sorted by `order`, offered or not. Offer the `offered` ones next to `allowedOptions` in a posting form's employment type picker; use all of them to label jobs. Always an array (empty when the board defines none). */
+                    customTypes: components["schemas"]["BoardCustomEmploymentType"][];
+                    /** @description The board's employment type display order: every built-in value and every custom type key, each once. Sort a posting form's employment type picker by it. */
+                    order: string[];
                 };
             };
             forms: components["schemas"]["BoardForms"];
@@ -2461,17 +2504,24 @@ interface components {
             /** @description URL-friendly slug used in public board URLs, or `null` if no slug is set. */
             slug: string | null;
             /**
-             * @description Current status of the job. One of `draft`, `published`, `expired`, or `archived`.
+             * @description Current status of the job. One of `draft`, `published`, `expired`, `archived`, or `pending_approval`. A `pending_approval` job is waiting for an operator to approve it: approve with `POST /v1/jobs/:id/publish`, reject with `DELETE /v1/jobs/:id`. It is not public, like a draft.
              * @enum {string}
              */
-            status: "draft" | "published" | "expired" | "archived";
+            status: "draft" | "published" | "expired" | "archived" | "pending_approval";
             /** @description Identifier of the company the job belongs to, or `null` if no company is attached. */
             companyId: string | null;
             /**
-             * @description Employment type of the role, or `null` if not specified.
+             * @description Employment type of the role, or `null` if not specified. For a job with a custom employment type, this is the Google equivalent of the custom type.
              * @enum {string|null}
              */
             employmentType: "full_time" | "part_time" | "contract" | "internship" | "temporary" | "volunteer" | "other" | null;
+            /** @description The board's custom employment type for this job (for example `Casual`), or `null` when the job uses a built-in type only. A deleted custom type reads back as `null` and the job shows its built-in `employmentType`. */
+            customEmploymentType: {
+                /** @description Stable key of the custom employment type. Never changes. */
+                key: string;
+                /** @description Display name of the custom employment type, as configured. */
+                label: string;
+            } | null;
             /**
              * @description Whether the role is on-site, hybrid, or fully remote. `null` only on older jobs saved without one; create requires it and `PATCH` cannot clear it.
              * @enum {string|null}
@@ -2640,8 +2690,18 @@ interface components {
              * @description ISO 8601 publish timestamp, or `null` if unpublished.
              */
             publishedAt: string | null;
-            /** @enum {string|null} */
+            /**
+             * @description Built-in employment type. For a job with a custom employment type, the Google equivalent of that type.
+             * @enum {string|null}
+             */
             employmentType: "full_time" | "part_time" | "contract" | "internship" | "temporary" | "volunteer" | "other" | null;
+            /** @description The board's custom employment type for this job (show its `label` instead of the built-in), or `null`. */
+            customEmploymentType: {
+                /** @description Stable key of the custom employment type. Never changes. */
+                key: string;
+                /** @description Display name of the custom employment type, as configured. */
+                label: string;
+            } | null;
             /** @enum {string|null} */
             remoteOption: "on_site" | "hybrid" | "remote" | null;
             /** @description Display region label for remote jobs (e.g. "United States", "Worldwide"); `null` for non-remote jobs. */
@@ -2757,8 +2817,10 @@ interface components {
                 companySlug?: string[];
                 /** @description Only return jobs with any of the given remote-work options. Up to 10 values. */
                 remoteOption?: ("on_site" | "hybrid" | "remote")[];
-                /** @description Only return jobs with any of the given employment types. Up to 10 values. */
+                /** @description Only return jobs with any of the given built-in employment types. Up to 10 values. A built-in value matches jobs of that type that have no custom employment type: a job with a custom type matches only through `customEmploymentType`. Combined with `customEmploymentType` as a union. */
                 employmentType?: ("full_time" | "part_time" | "contract" | "internship" | "temporary" | "volunteer" | "other")[];
+                /** @description Only return jobs with any of the given custom employment type keys (the board's `customTypes`). Up to 10 values. Combined with `employmentType` as a union: a job matches when it has one of these custom types OR one of the given built-in types and no custom type. */
+                customEmploymentType?: string[];
                 /** @description Only return jobs at any of the given seniority levels. Up to 10 values. */
                 seniority?: ("entry_level" | "associate" | "mid_level" | "senior" | "lead" | "principal" | "director" | "executive")[];
                 /** @description Only return jobs tagged with any of the given category slugs. Up to 10 values. Accepts the `sourceSlug` or the board-language `canonicalSlug` from `GET /v1/boards/{identifier}/categories`, or a `slug` from a job card's `categories`. Unknown slugs match no jobs. */

package/dist/analytics.d.mts

@@ -4,7 +4,7 @@ declare const DEFAULT_COLLECT_URL = "https://cavuno.com/api/analytics/collect";
  * new release reaches returning visitors instead of waiting out their browser
  * cache. The unversioned URL keeps serving the current script.
  */
-declare const DEFAULT_SCRIPT_URL = "https://cavuno.com/js/metrics.js?v=1.7.1-cavuno.1";
+declare const DEFAULT_SCRIPT_URL = "https://cavuno.com/js/metrics.js?v=1.7.1-cavuno.2";
 /** Placeholder tenant; collect rewrites from the publishable key. */
 declare const PENDING_TENANT_ID = "boards_pending";
 declare const WELL_KNOWN_ANALYTICS_SCRIPT_PATH = "/.well-known/cavuno/analytics.js";
@@ -40,6 +40,12 @@ type AnalyticsInstallOptions = {
 /**
  * Load the Cavuno-hosted metrics script and remember collect credentials.
  * Safe to call once per page; subsequent calls update collect targets only.
+ *
+ * The script sets a first-party `session-id` cookie (a random identifier
+ * that expires after 30 minutes without activity) and sends page view,
+ * engagement, and web-vital events. Where your board requires cookie consent
+ * (`analytics.cookieConsentRequired` from `board.context()`), call `install`
+ * only after the visitor accepts. Until it runs, `track` sends nothing.
  */
 declare function install(options: AnalyticsInstallOptions): void;
 /**
@@ -47,9 +53,40 @@ declare function install(options: AnalyticsInstallOptions): void;
  * Prefer `install` first so pageviews and vitals are also recorded.
  */
 declare function track(action: string, payload?: Record<string, unknown>): void;
+/** A visitor's answer to the cookie banner, as recorded by `recordConsent`. */
+type ConsentChoice = 'accepted' | 'denied' | 'withdrawn';
+type RecordConsentInput = {
+    /** The board's publishable key (`pk_…`), the same one `install` takes. */
+    publishableKey: string;
+    /**
+     * Random UUID the banner generates once and keeps in its own consent
+     * cookie, so every choice from the same browser shares one id.
+     */
+    consentId: string;
+    choice: ConsentChoice;
+    /** Identifies the banner text the visitor saw. 1–128 characters. */
+    bannerVersion: string;
+    /** Default: Cavuno central collect, as for `install`. */
+    collectUrl?: string;
+};
+/**
+ * Record a cookie-banner choice as proof of consent. Call it on every
+ * Accept, Decline and withdrawal.
+ *
+ * Works without `install`, so a Decline is recorded even though analytics
+ * never load. It reads and sets no cookie and sends no session id: the
+ * record holds only the consent id, the choice, the banner version, the
+ * board and the time it was received.
+ *
+ * Sends `POST {collectUrl}` with
+ * `{ publishableKey, action: 'consent', payload: { consent_id, choice, banner_version } }`.
+ * Throws on invalid input; network failures are swallowed.
+ */
+declare function recordConsent(input: RecordConsentInput): void;
 declare const analytics: {
     install: typeof install;
     track: typeof track;
+    recordConsent: typeof recordConsent;
     matchAnalyticsWellKnown: typeof matchAnalyticsWellKnown;
     DEFAULT_COLLECT_URL: string;
     DEFAULT_SCRIPT_URL: string;
@@ -60,4 +97,4 @@ declare const analytics: {
     WELL_KNOWN_COLLECT_EVENTS_PATH: string;
 };
 
-export { type AnalyticsInstallOptions, DEFAULT_COLLECT_URL, DEFAULT_SCRIPT_URL, PENDING_TENANT_ID, WELL_KNOWN_ANALYTICS_SCRIPT_PATH, WELL_KNOWN_COLLECT_EVENTS_PATH, WELL_KNOWN_COLLECT_PATH, WELL_KNOWN_SCRIPT_PATH, analytics, install, matchAnalyticsWellKnown, track };
+export { type AnalyticsInstallOptions, type ConsentChoice, DEFAULT_COLLECT_URL, DEFAULT_SCRIPT_URL, PENDING_TENANT_ID, type RecordConsentInput, WELL_KNOWN_ANALYTICS_SCRIPT_PATH, WELL_KNOWN_COLLECT_EVENTS_PATH, WELL_KNOWN_COLLECT_PATH, WELL_KNOWN_SCRIPT_PATH, analytics, install, matchAnalyticsWellKnown, recordConsent, track };

package/dist/analytics.d.ts

@@ -4,7 +4,7 @@ declare const DEFAULT_COLLECT_URL = "https://cavuno.com/api/analytics/collect";
  * new release reaches returning visitors instead of waiting out their browser
  * cache. The unversioned URL keeps serving the current script.
  */
-declare const DEFAULT_SCRIPT_URL = "https://cavuno.com/js/metrics.js?v=1.7.1-cavuno.1";
+declare const DEFAULT_SCRIPT_URL = "https://cavuno.com/js/metrics.js?v=1.7.1-cavuno.2";
 /** Placeholder tenant; collect rewrites from the publishable key. */
 declare const PENDING_TENANT_ID = "boards_pending";
 declare const WELL_KNOWN_ANALYTICS_SCRIPT_PATH = "/.well-known/cavuno/analytics.js";
@@ -40,6 +40,12 @@ type AnalyticsInstallOptions = {
 /**
  * Load the Cavuno-hosted metrics script and remember collect credentials.
  * Safe to call once per page; subsequent calls update collect targets only.
+ *
+ * The script sets a first-party `session-id` cookie (a random identifier
+ * that expires after 30 minutes without activity) and sends page view,
+ * engagement, and web-vital events. Where your board requires cookie consent
+ * (`analytics.cookieConsentRequired` from `board.context()`), call `install`
+ * only after the visitor accepts. Until it runs, `track` sends nothing.
  */
 declare function install(options: AnalyticsInstallOptions): void;
 /**
@@ -47,9 +53,40 @@ declare function install(options: AnalyticsInstallOptions): void;
  * Prefer `install` first so pageviews and vitals are also recorded.
  */
 declare function track(action: string, payload?: Record<string, unknown>): void;
+/** A visitor's answer to the cookie banner, as recorded by `recordConsent`. */
+type ConsentChoice = 'accepted' | 'denied' | 'withdrawn';
+type RecordConsentInput = {
+    /** The board's publishable key (`pk_…`), the same one `install` takes. */
+    publishableKey: string;
+    /**
+     * Random UUID the banner generates once and keeps in its own consent
+     * cookie, so every choice from the same browser shares one id.
+     */
+    consentId: string;
+    choice: ConsentChoice;
+    /** Identifies the banner text the visitor saw. 1–128 characters. */
+    bannerVersion: string;
+    /** Default: Cavuno central collect, as for `install`. */
+    collectUrl?: string;
+};
+/**
+ * Record a cookie-banner choice as proof of consent. Call it on every
+ * Accept, Decline and withdrawal.
+ *
+ * Works without `install`, so a Decline is recorded even though analytics
+ * never load. It reads and sets no cookie and sends no session id: the
+ * record holds only the consent id, the choice, the banner version, the
+ * board and the time it was received.
+ *
+ * Sends `POST {collectUrl}` with
+ * `{ publishableKey, action: 'consent', payload: { consent_id, choice, banner_version } }`.
+ * Throws on invalid input; network failures are swallowed.
+ */
+declare function recordConsent(input: RecordConsentInput): void;
 declare const analytics: {
     install: typeof install;
     track: typeof track;
+    recordConsent: typeof recordConsent;
     matchAnalyticsWellKnown: typeof matchAnalyticsWellKnown;
     DEFAULT_COLLECT_URL: string;
     DEFAULT_SCRIPT_URL: string;
@@ -60,4 +97,4 @@ declare const analytics: {
     WELL_KNOWN_COLLECT_EVENTS_PATH: string;
 };
 
-export { type AnalyticsInstallOptions, DEFAULT_COLLECT_URL, DEFAULT_SCRIPT_URL, PENDING_TENANT_ID, WELL_KNOWN_ANALYTICS_SCRIPT_PATH, WELL_KNOWN_COLLECT_EVENTS_PATH, WELL_KNOWN_COLLECT_PATH, WELL_KNOWN_SCRIPT_PATH, analytics, install, matchAnalyticsWellKnown, track };
+export { type AnalyticsInstallOptions, type ConsentChoice, DEFAULT_COLLECT_URL, DEFAULT_SCRIPT_URL, PENDING_TENANT_ID, type RecordConsentInput, WELL_KNOWN_ANALYTICS_SCRIPT_PATH, WELL_KNOWN_COLLECT_EVENTS_PATH, WELL_KNOWN_COLLECT_PATH, WELL_KNOWN_SCRIPT_PATH, analytics, install, matchAnalyticsWellKnown, recordConsent, track };