@cavuno/board 1.25.0 → 1.26.0

package/dist/index.d.mts

@@ -1,3734 +1,5 @@
-interface components {
-    schemas: {
-        AccessCheckoutBody: {
-            /**
-             * @description The offer tier to purchase (from `GET /paywall/offers/enabled`).
-             * @enum {string}
-             */
-            offerKey: "daily" | "weekly" | "monthly" | "quarterly" | "yearly" | "lifetime";
-            /** @description Relative path Stripe returns the buyer to on completion; `session_id` is appended. */
-            returnPath: string;
-            /** @enum {string} */
-            colorMode: "light" | "dark";
-        };
-        AccessCheckoutSession: {
-            /** @enum {string} */
-            object: "checkout_session";
-            sessionId: string;
-            /** @description The Checkout Session client secret to mount the embedded form. */
-            clientSecret: string;
-            /** @description The board’s connected Stripe account to initialise Stripe.js with. */
-            stripeAccountId: string;
-            /** @description The platform Stripe publishable key for `loadStripe`. */
-            publishableKey: string;
-            /**
-             * @description `recurring` grants get a manage-subscription portal; `lifetime` do not.
-             * @enum {string}
-             */
-            offerType: "recurring" | "lifetime";
-        };
-        AccessCheckoutSessionState: {
-            /** @enum {string} */
-            object: "checkout_session_state";
-            /** @enum {string} */
-            status: "open" | "complete" | "expired";
-            clientSecret: string | null;
-        };
-        AccessGrant: {
-            /** @enum {string} */
-            object: "access_grant";
-            hasAccess: boolean;
-            /** @enum {string|null} */
-            status: "active" | "past_due" | "unpaid" | "incomplete" | "incomplete_expired" | "canceled" | "pending" | null;
-            /** @enum {string|null} */
-            offerType: "recurring" | "lifetime" | null;
-            offerKey: string | null;
-            currentPeriodEnd: string | null;
-            cancelAtPeriodEnd: boolean;
-        };
-        AccessPortalBody: {
-            /** @description Relative path Stripe returns the buyer to; defaults to the board root. */
-            returnPath?: string;
-        };
-        AccessPortalSession: {
-            /** @enum {string} */
-            object: "portal_session";
-            /** Format: uri */
-            url: string;
-        };
-        AddApplicantNoteBody: {
-            /** @description The note text. */
-            body: string;
-        };
-        /** @description Links related to this resource. List responses only carry the `admin` URL because the public URL needs the company slug, which list-shape Convex projections do not fan out to. */
-        AdminOnlyResourceLinks: {
-            /**
-             * Format: uri
-             * @description URL inside the Cavuno app where the authenticated owner can manage this resource.
-             */
-            admin: string;
-        };
-        Alert: {
-            /** @description Job-alert preference ID — also the path key. */
-            id: string;
-            /** @enum {string} */
-            object: "alert";
-            label: string | null;
-            /** @enum {string} */
-            frequency: "daily" | "weekly";
-            isActive: boolean;
-            filters: {
-                jobFunctions: string[];
-                seniorityLevels: string[];
-                remoteOptions: string[];
-                placeIds: string[];
-                salaryMin: number | null;
-                salaryMax: number | null;
-                salaryCurrency: string | null;
-            };
-            /**
-             * Format: date-time
-             * @description When this alert last dispatched a digest, or null.
-             */
-            lastSentAt: string | null;
-        };
-        AlertBody: {
-            label?: string;
-            /** @enum {string} */
-            frequency: "daily" | "weekly";
-            jobFunctions?: string[];
-            seniorityLevels?: string[];
-            remoteOptions?: string[];
-            placeIds?: string[];
-            salaryMin?: number | null;
-            salaryMax?: number | null;
-            salaryCurrency?: string | null;
-        };
-        ApiKey: {
-            /** @description Unique identifier for the object. */
-            id: string;
-            /**
-             * @description String representing the object's type. Objects of the same type share the same value.
-             * @enum {string}
-             */
-            object: "api_key";
-            /** @description Public key ID component, embedded in the key prefix as `cavuno_live_<keyId>_`. */
-            keyId: string;
-            /** @description Human-readable name for the key, shown in the dashboard. */
-            name: string;
-            /** @description Public prefix in the form `cavuno_live_<keyId>_`. Safe to log; the full plaintext secret is never returned by the API. */
-            prefix: string;
-            /** @description Time at which the key was created. Unix epoch in milliseconds. */
-            createdAt: number;
-            /** @description Identifier of the user who minted the key. */
-            createdBy: string;
-            /** @description Time at which the key was last used to authenticate a request, or `null` if it has never been used. Unix epoch in milliseconds. */
-            lastUsedAt: number | null;
-            /** @description Time at which the key was revoked, or `null` if the key is still active. Unix epoch in milliseconds. */
-            revokedAt: number | null;
-            /** @description Time at which the key expires, or `null` if the key has no expiry. Unix epoch in milliseconds. */
-            expiresAt: number | null;
-        };
-        Application: {
-            /** @description Application ID — the `:applicationId` path key. */
-            id: string;
-            /** @enum {string} */
-            object: "application";
-            /**
-             * @description Coarse candidate-facing status derived from the employer pipeline stage.
-             * @enum {string}
-             */
-            status: "applied" | "interviewing" | "negotiation" | "hired" | "archived";
-            /** Format: date-time */
-            appliedAt: string;
-            /** Format: date-time */
-            updatedAt: string;
-            coverNote: string | null;
-            candidateName: string | null;
-            candidateEmail: string | null;
-            candidateLocation: string | null;
-            candidateHeadline: string | null;
-            resumeFilename: string | null;
-            job: {
-                id: string;
-                title: string;
-                slug: string | null;
-                companySlug: string | null;
-                companyName: string | null;
-            } | null;
-        };
-        ApplyBody: {
-            name?: string;
-            /** Format: email */
-            email?: string;
-            coverNote?: string;
-        };
-        AuditLogEntry: {
-            /** @description Unique identifier for the object. */
-            id: string;
-            /**
-             * @description String representing the object's type. Objects of the same type share the same value.
-             * @enum {string}
-             */
-            object: "audit_log";
-            /** @description Identifier of the account the entry belongs to. */
-            accountId: string;
-            /**
-             * @description Type of actor that performed the action.
-             * @enum {string}
-             */
-            actorType: "api_key" | "oauth_token" | "user_session" | "system";
-            /** @description Identifier of the actor that performed the action. */
-            actorId: string;
-            /** @description Human-readable label for the actor, suitable for display. */
-            actorLabel: string;
-            /** @description Action that was performed (e.g. `jobs.create`, `companies.update`). */
-            action: string;
-            /** @description Type of resource the action was performed on. */
-            resourceType: string;
-            /** @description Identifier of the resource the action was performed on, or `null` for resource-less actions. */
-            resourceId: string | null;
-            /** @description Serialized JSON snapshot of the resource before the action, or `null` for create actions. */
-            before: string | null;
-            /** @description Serialized JSON snapshot of the resource after the action, or `null` for delete actions. */
-            after: string | null;
-            /** @description Serialized JSON of free-form metadata about the action (e.g. truncation byte sizes), or `null` if none was attached. */
-            metadata: string | null;
-            /** @description IP address the request originated from, or `null` if unavailable. */
-            ipAddress: string | null;
-            /** @description User-agent string from the request, or `null` if unavailable. */
-            userAgent: string | null;
-            /** @description Identifier of the request that produced the entry. Use this to correlate with platform logs. */
-            requestId: string;
-            /** @description Time at which the audit entry was written. Unix epoch in milliseconds. */
-            timestamp: number;
-        };
-        BatchRequestBody: {
-            /** @description Array of sub-operations to execute. Each entry runs independently and reports its result on the corresponding entry of the response `data` array. Sub-operation `id` values must be unique within the batch. Up to 100 entries. */
-            operations: ({
-                id: string;
-                /** @enum {string} */
-                method: "POST";
-                body?: unknown;
-                action?: string;
-                resourceId?: string;
-            } | {
-                id: string;
-                /** @enum {string} */
-                method: "PATCH";
-                body?: unknown;
-                resourceId: string;
-            } | {
-                id: string;
-                /** @enum {string} */
-                method: "DELETE";
-                resourceId: string;
-            })[];
-        };
-        Block: {
-            /** @enum {string} */
-            object: "block";
-            /** @enum {boolean} */
-            blocked: true;
-        };
-        BlockStatus: {
-            /** @enum {string} */
-            object: "block_status";
-            blocked: boolean;
-        };
-        BlockUserBody: {
-            boardUserId: string;
-        };
-        BlockedUser: {
-            id: string;
-            /** @enum {string} */
-            object: "blocked_user";
-            boardUserId: string;
-            displayName: string;
-            avatarUrl: string | null;
-            /** Format: date-time */
-            createdAt: string;
-        };
-        BlogAuthor: {
-            /** @description Unique identifier for the object. Use this value as the `{id}` path parameter for the author endpoints (e.g. `GET /v1/blog/authors/{id}`). */
-            id: string;
-            /**
-             * @description String representing the object's type. Objects of the same type share the same value.
-             * @enum {string}
-             */
-            object: "blog_author";
-            /** @description Display name of the author. */
-            name: string;
-            /** @description URL-friendly slug for the author. */
-            slug: string;
-            /** @description Short biography, or `null` if not set. */
-            bio: string | null;
-            /** @description The author's email address, or `null` if not set. */
-            email: string | null;
-            /** @description Author visibility status, or `null` if not set. */
-            status: string | null;
-            /** @description URL of the author avatar, or `null` if no avatar is set. */
-            avatarUrl: string | null;
-            /** @description The author's website URL, or `null` if not set. */
-            websiteUrl: string | null;
-            /** @description The author's X (Twitter) URL, or `null` if not set. */
-            twitterUrl: string | null;
-            /** @description The author's LinkedIn URL, or `null` if not set. */
-            linkedinUrl: string | null;
-            /** @description The author's GitHub URL, or `null` if not set. */
-            githubUrl: string | null;
-            /** @description SEO meta title, or `null` if not set. */
-            metaTitle: string | null;
-            /** @description SEO meta description, or `null` if not set. */
-            metaDescription: string | null;
-            /** @description Time at which the author was created. ISO 8601 datetime. */
-            createdAt: string;
-            /** @description Time at which the author was last updated, or `null` if it has never been updated. ISO 8601 datetime. */
-            updatedAt: string | null;
-        };
-        BlogPost: components["schemas"]["BlogPostSummary"] & {
-            html: string | null;
-        };
-        BlogPostSummary: {
-            /** @description Unique identifier for the object. Use this value as the `{id}` path parameter for the blog-post endpoints (e.g. `GET /v1/blog/posts/{id}`). */
-            id: string;
-            /** @enum {string} */
-            object: "blog_post";
-            title: string;
-            slug: string;
-            status: string;
-            visibility: string;
-            type: string;
-            featured: boolean;
-            authorIds: string[];
-            tagIds: string[];
-            coverUrl: string | null;
-            ogImageUrl: string | null;
-            featureImageAlt: string | null;
-            featureImageCaption: string | null;
-            customExcerpt: string | null;
-            readingTimeMin: number | null;
-            seoTitle: string | null;
-            seoDescription: string | null;
-            canonicalUrl: string | null;
-            publishedAt: string | null;
-            createdAt: string;
-            updatedAt: string | null;
-        };
-        BlogPostsBatchRequest: {
-            /** @description Array of post sub-operations to execute. Each runs independently and reports on the matching entry of the response `data` array. `id` values must be unique. Supported: POST (create), PATCH (update), DELETE, and POST with action `publish`/`unpublish`. Up to 50 entries. */
-            operations: ({
-                id: string;
-                /** @enum {string} */
-                method: "POST";
-                body?: unknown;
-                action?: string;
-                resourceId?: string;
-            } | {
-                id: string;
-                /** @enum {string} */
-                method: "PATCH";
-                body?: unknown;
-                resourceId: string;
-            } | {
-                id: string;
-                /** @enum {string} */
-                method: "DELETE";
-                resourceId: string;
-            })[];
-        };
-        BlogTag: {
-            /** @description Unique identifier for the object. Use this value as the `{id}` path parameter for the tag endpoints (e.g. `GET /v1/blog/tags/{id}`). */
-            id: string;
-            /**
-             * @description String representing the object's type. Objects of the same type share the same value.
-             * @enum {string}
-             */
-            object: "blog_tag";
-            /** @description Display name of the tag. */
-            name: string;
-            /** @description URL-friendly slug for the tag. */
-            slug: string;
-            /** @description Tag description, or `null` if not set. */
-            description: string | null;
-            /** @description Tag visibility, or `null` if not set. */
-            visibility: string | null;
-            /** @description SEO meta title, or `null` if not set. */
-            metaTitle: string | null;
-            /** @description SEO meta description, or `null` if not set. */
-            metaDescription: string | null;
-            /** @description Time at which the tag was created. ISO 8601 datetime. */
-            createdAt: string;
-            /** @description Time at which the tag was last updated, or `null` if it has never been updated. ISO 8601 datetime. */
-            updatedAt: string | null;
-        };
-        BoardAccessGrant: {
-            /** @enum {string} */
-            object: "board_access_grant";
-            /** @description The board-access grant. Send it as the `X-Board-Access` header on subsequent content reads to pass the password wall. */
-            token: string;
-        };
-        BoardAuthConsumeMagicLinkBody: {
-            token: string;
-        };
-        BoardAuthForgotPasswordBody: {
-            /** Format: email */
-            email: string;
-        };
-        BoardAuthLoginBody: {
-            /** Format: email */
-            email: string;
-            password: string;
-        };
-        BoardAuthLogoutBody: {
-            refreshToken: string;
-        };
-        BoardAuthOAuthAuthorizationUrl: {
-            /** @enum {string} */
-            object: "oauth_authorization_url";
-            /** @enum {string} */
-            provider: "google" | "linkedin";
-            /** Format: uri */
-            authorizeUrl: string;
-        };
-        BoardAuthOAuthExchangeBody: {
-            token: string;
-        };
-        BoardAuthRefreshBody: {
-            refreshToken: string;
-        };
-        BoardAuthRegisterBody: {
-            /**
-             * @description Which role profile to create on the board.
-             * @enum {string}
-             */
-            role: "candidate" | "employer";
-            /**
-             * @description Registration method. Only `emailpass` is supported.
-             * @enum {string}
-             */
-            method: "emailpass";
-            /** Format: email */
-            email: string;
-            /** @description Minimum 8 characters. */
-            password: string;
-            displayName: string;
-        };
-        BoardAuthRequestMagicLinkBody: {
-            /** Format: email */
-            email: string;
-            /** @description Optional same-origin path to carry through the email link. */
-            returnTo?: string;
-        };
-        BoardAuthResetPasswordBody: {
-            token: string;
-            /** @description Minimum 8 characters. */
-            password: string;
-        };
-        BoardAuthSession: {
-            /** @enum {string} */
-            object: "board_auth_session";
-            /** @description Short-lived JWT (1 hour). Send as `Authorization: Bearer`. */
-            accessToken: string;
-            /** @description Opaque single-use refresh token (30 days). Each refresh returns a replacement; a reused token is rejected. */
-            refreshToken: string;
-            /** @description Access-token expiry, epoch milliseconds. */
-            expiresAt: number;
-            boardUser: components["schemas"]["BoardUser"];
-        };
-        BoardAuthVerifyEmailBody: {
-            token: string;
-        };
-        BoardSeo: {
-            /** @enum {string} */
-            object: "board_seo";
-            /** @description Verbatim `ads.txt` content, or `null` when not configured. */
-            adsTxt: string | null;
-            /** @description IndexNow key-file content, or `null` when not configured. */
-            indexNowKey: string | null;
-            /** @description Google site-verification token for the `<meta>` tag, or `null`. */
-            googleSiteVerification: string | null;
-            /**
-             * Format: uri
-             * @description The board's canonical base URL (honours a configured custom domain). Build `robots.txt`'s `Sitemap:` line (`${canonicalBase}/sitemap.xml`) and canonical links from it.
-             */
-            canonicalBase: string;
-            /** @description Absolute URLs for the board's configured favicons / app icons (null when unset). The variant key implies the role + size; build `<link rel="icon">` tags + the web-manifest icon list from these. */
-            icons: {
-                ico: string | null;
-                svg: string | null;
-                appleTouch: string | null;
-                icon192: string | null;
-                icon512: string | null;
-                iconMaskable512: string | null;
-            };
-            /** @description Web-manifest metadata; assemble `site.webmanifest` from this + `icons`. */
-            manifest: {
-                name: string;
-                themeColor: string;
-            };
-        };
-        BoardUser: {
-            /** @description Board user ID. */
-            id: string;
-            /** @enum {string} */
-            object: "board_user";
-            /** @enum {string} */
-            role: "candidate" | "employer";
-            email: string;
-            displayName: string | null;
-            emailVerified: boolean;
-        };
-        BulkMoveApplicantsBody: {
-            applicationIds: string[];
-            /** @description The target stage id. */
-            stageId: string;
-        };
-        BulkRejectApplicantsBody: {
-            applicationIds: string[];
-        };
-        CandidateAvatar: {
-            /** @enum {string} */
-            object: "candidate_avatar";
-            avatarUrl: string | null;
-        };
-        CandidateEducation: {
-            id: string;
-            /** @enum {string} */
-            object: "candidate_education";
-            institutionName: string;
-            institutionUrl: string | null;
-            degree: string | null;
-            fieldOfStudy: string | null;
-            grade: string | null;
-            activitiesAndSocieties: string | null;
-            startDate: string | null;
-            endDate: string | null;
-            description: string | null;
-            sortOrder: number;
-        };
-        CandidateExperience: {
-            id: string;
-            /** @enum {string} */
-            object: "candidate_experience";
-            title: string;
-            companyName: string;
-            companyUrl: string | null;
-            location: string | null;
-            employmentType: string | null;
-            locationType: string | null;
-            foundVia: string | null;
-            startDate: string;
-            endDate: string | null;
-            description: string | null;
-            sortOrder: number;
-            experienceSkills: string[];
-        };
-        CandidateLanguage: {
-            /** @enum {string} */
-            object: "candidate_language";
-            name: string;
-            proficiency: string;
-        };
-        CandidateProfile: {
-            id: string;
-            /** @enum {string} */
-            object: "candidate_profile";
-            displayName: string | null;
-            bio: string | null;
-            avatarUrl: string | null;
-            handle: string | null;
-            headline: string | null;
-            location: string | null;
-            /** @enum {string} */
-            profileVisibility: "hidden" | "logged_in_only" | "public";
-            /** @enum {string} */
-            jobSearchStatus: "actively_looking" | "open_to_offers" | "not_looking";
-            /** @enum {string} */
-            jobSearchStatusVisibleTo: "everyone" | "employers_only";
-            openToRelocate: boolean;
-        };
-        CandidateSkill: {
-            /** @enum {string} */
-            object: "candidate_skill";
-            name: string;
-            jobSkillId: string | null;
-        };
-        ClaimableCompany: {
-            id: string;
-            /** @enum {string} */
-            object: "claimable_company";
-            name: string;
-            slug: string;
-            website: string | null;
-        };
-        CompaniesBatchRequest: {
-            /** @description Array of sub-operations to execute. Each entry runs independently and reports its result on the corresponding entry of the response `data` array. Sub-operation `id` values must be unique within the batch. Up to 100 entries. */
-            operations: ({
-                id: string;
-                /** @enum {string} */
-                method: "POST";
-                body?: unknown;
-                action?: string;
-                resourceId?: string;
-            } | {
-                id: string;
-                /** @enum {string} */
-                method: "PATCH";
-                body?: unknown;
-                resourceId: string;
-            } | {
-                id: string;
-                /** @enum {string} */
-                method: "DELETE";
-                resourceId: string;
-            })[];
-        };
-        Company: components["schemas"]["CompanySummary"] & {
-            /** @description Long-form description of the company, or `null` if not set. */
-            description: string | null;
-            /** @description Whether automated backfill of jobs from this company is supported, or `null` if not yet evaluated. */
-            canBackfill: boolean | null;
-            /** @description Total number of jobs at this company across all statuses. */
-            jobCount: number;
-            /** @description Number of currently-published jobs at this company. */
-            publishedJobCount: number;
-        };
-        CompanyCategorySalary: {
-            /** @enum {string} */
-            object: "company_category_salary";
-            categorySourceSlug: string;
-            categoryCanonicalSlug: string;
-            companyName: string;
-            companySlug: string;
-            companyLogoPath: string | null;
-            companyWebsite: string | null;
-            categoryName: string;
-            overallSalary: {
-                avgMin: number;
-                avgMax: number;
-                jobCount: number;
-            } | null;
-            bySeniority: {
-                seniority: string;
-                avgSalaryMin: number;
-                avgSalaryMax: number;
-                jobCount: number;
-                boardAvgMin: number | null;
-                boardAvgMax: number | null;
-                boardMedianMin: number | null;
-                boardMedianMax: number | null;
-                boardP25Min: number | null;
-                boardP75Min: number | null;
-                boardP25Max: number | null;
-                boardP75Max: number | null;
-                diffPercent: number | null;
-            }[];
-            competitors: {
-                companySlug: string;
-                companyName: string;
-                logoPath: string | null;
-                avgSalaryMin: number;
-                avgSalaryMax: number;
-                jobCount: number;
-            }[];
-            boardCategoryAvgMin: number | null;
-            boardCategoryAvgMax: number | null;
-            boardCategoryP25Min: number | null;
-            boardCategoryP75Max: number | null;
-            currency: string;
-        };
-        CompanyMarket: {
-            /** @enum {string} */
-            object: "company_market";
-            slug: string;
-            name: string;
-            /** @description Number of companies on the board in this market. */
-            companyCount: number;
-        };
-        CompanyMarketRef: {
-            /** @description Display name of the market. */
-            name: string;
-            /** @description Source slug for the market. Use it as the `:market` segment of the market-scoped company browse. */
-            slug: string;
-        };
-        CompanyMembership: {
-            id: string;
-            /** @enum {string} */
-            object: "company_membership";
-            /** @enum {string} */
-            status: "approved" | "pending_work_email" | "awaiting_admin" | "rejected";
-            role: string;
-            workEmail: string | null;
-            /** Format: date-time */
-            workEmailVerifiedAt: string | null;
-            company: {
-                id: string;
-                name: string;
-                slug: string | null;
-                website: string | null;
-                logoUrl: string | null;
-            };
-        };
-        CompanyPublic: {
-            /** @description Unique identifier for the object. Use this value as the `{id}` path parameter for the company endpoints (e.g. `GET /v1/companies/{id}`). */
-            id: string;
-            /**
-             * @description String representing the object's type. Objects of the same type share the same value.
-             * @enum {string}
-             */
-            object: "public_company";
-            /** @description Display name of the company. */
-            name: string;
-            /** @description URL-friendly slug for the company. */
-            slug: string;
-            /** @description Public company website URL, or `null` if not set. */
-            website: string | null;
-            /** @description URL of the company logo, or `null` if no logo is set. */
-            logoUrl: string | null;
-            /** @description Long-form description of the company, or `null` if not set. */
-            description: string | null;
-            /** @description Total number of public-facing jobs at this company. Currently mirrors `publishedJobCount`. */
-            jobCount: number;
-            /** @description Number of currently-published, non-expired jobs at this company. */
-            publishedJobCount: number;
-            links: components["schemas"]["PublicCompanyLinks"];
-        };
-        CompanyPublicDetail: components["schemas"]["CompanyPublic"] & {
-            /** @description Markets (sectors) this company operates in, each with its source slug. Empty when the company has no markets. */
-            markets: components["schemas"]["CompanyMarketRef"][];
-        };
-        CompanySalary: {
-            /** @enum {string} */
-            object: "company_salary";
-            companyName: string;
-            companySlug: string;
-            companyLogoPath: string | null;
-            companyWebsite: string | null;
-            overallSalary: {
-                avgMin: number;
-                avgMax: number;
-                jobCount: number;
-            } | null;
-            bySeniority: {
-                seniority: string;
-                avgSalaryMin: number;
-                avgSalaryMax: number;
-                jobCount: number;
-                boardAvgMin: number | null;
-                boardAvgMax: number | null;
-                boardMedianMin: number | null;
-                boardMedianMax: number | null;
-                boardP25Min: number | null;
-                boardP75Min: number | null;
-                boardP25Max: number | null;
-                boardP75Max: number | null;
-                diffPercent: number | null;
-            }[];
-            competitors: {
-                companySlug: string;
-                companyName: string;
-                logoPath: string | null;
-                avgSalaryMin: number;
-                avgSalaryMax: number;
-                jobCount: number;
-            }[];
-            topLocations: {
-                locationName: string;
-                countryCode: string;
-                placeSlug: string;
-                avgSalaryMin: number;
-                avgSalaryMax: number;
-                jobCount: number;
-            }[];
-            byCategory: {
-                categorySlug: string;
-                categoryName: string;
-                avgSalaryMin: number;
-                avgSalaryMax: number;
-                jobCount: number;
-            }[];
-            boardOverallAvgMin: number | null;
-            boardOverallAvgMax: number | null;
-            boardMedianMin: number | null;
-            boardMedianMax: number | null;
-            boardP25Min: number | null;
-            boardP75Min: number | null;
-            boardP25Max: number | null;
-            boardP75Max: number | null;
-            currency: string;
-        };
-        CompanySummary: {
-            /** @description Unique identifier for the object. Use this value as the `{id}` path parameter for the company endpoints (e.g. `GET /v1/companies/{id}`). */
-            id: string;
-            /**
-             * @description String representing the object's type. Objects of the same type share the same value.
-             * @enum {string}
-             */
-            object: "company";
-            /** @description Display name of the company. */
-            name: string;
-            /** @description URL-friendly slug for the company. */
-            slug: string;
-            /** @description Public company website URL, or `null` if not set. */
-            website: string | null;
-            /** @description URL of the company logo, or `null` if no logo is set. */
-            logoUrl: string | null;
-            /** @description One-line summary of the company, or `null` if not set. */
-            summary: string | null;
-            /** @description X (Twitter) profile URL, or `null` if not set. */
-            xUrl: string | null;
-            /** @description LinkedIn page URL, or `null` if not set. */
-            linkedinUrl: string | null;
-            /** @description Facebook page URL, or `null` if not set. */
-            facebookUrl: string | null;
-            /** @description Time at which the company was created. ISO 8601 datetime. */
-            createdAt: string;
-            /** @description Time at which the company was last updated, or `null` if it has never been updated. ISO 8601 datetime. */
-            updatedAt: string | null;
-            /** @description Public + admin URLs for this company. `public` may be `null` if the company lacks a slug. */
-            links: components["schemas"]["ResourceLinks"] & {
-                /**
-                 * Format: uri
-                 * @description Canonical public URL for this company on the board, or `null` when no slug is set.
-                 */
-                public?: string | null;
-            };
-        };
-        ConfirmWorkEmailBody: {
-            token: string;
-        };
-        Conversation: {
-            id: string;
-            /** @enum {string} */
-            object: "conversation";
-            /** Format: date-time */
-            lastMessageAt: string;
-            lastMessageSnippet: string;
-            lastMessageAuthorBoardUserId: string;
-            /** Format: date-time */
-            archivedAt: string | null;
-            hasUnread: boolean;
-            counterparty: components["schemas"]["ConversationCounterparty"];
-        };
-        ConversationArchive: {
-            /** @enum {string} */
-            object: "conversation_archive";
-            /** Format: date-time */
-            archivedAt: string | null;
-        };
-        ConversationCounterparty: {
-            boardUserId: string;
-            displayName: string;
-            avatarUrl: string | null;
-            companyName: string | null;
-            handle: string | null;
-            companySlug: string | null;
-        };
-        ConversationDetail: components["schemas"]["Conversation"] & {
-            /** @enum {string} */
-            viewerRole: "employer" | "candidate";
-            viewerLastReadMessageId: string | null;
-        };
-        ConversationRef: {
-            /** @enum {string} */
-            object: "conversation_ref";
-            conversationId: string | null;
-        };
-        CreateAuthorBody: {
-            /** @description URL-friendly slug for the author. Auto-generated from `name` when omitted. */
-            slug?: string;
-            /** @description Short biography for the author. Sanitized HTML. */
-            bio?: string;
-            /**
-             * Format: email
-             * @description The author's email address.
-             */
-            email?: string;
-            /**
-             * @description Author visibility status. One of `active` or `inactive`.
-             * @enum {string}
-             */
-            status?: "active" | "inactive";
-            /** @description Storage ID of an uploaded avatar image (from `POST /v1/media/upload`). Pass `null` to clear an existing avatar. */
-            avatarStorageId?: string | null;
-            /** @description The author's personal website URL. Normalized to a canonical URL when stored. */
-            websiteUrl?: string;
-            /** @description The author's X (Twitter) profile URL. Stored as the canonical `https://x.com/<handle>` URL. */
-            twitterUrl?: string;
-            /** @description The author's LinkedIn profile URL. */
-            linkedinUrl?: string;
-            /** @description The author's GitHub profile URL. */
-            githubUrl?: string;
-            /** @description SEO meta title for the author page. */
-            metaTitle?: string;
-            /** @description SEO meta description for the author page. */
-            metaDescription?: string;
-            /** @description The author's display name. */
-            name: string;
-        };
-        CreateBlogPostBody: {
-            slug?: string;
-            html?: string;
-            customExcerpt?: string;
-            readingTimeMin?: number;
-            featured?: boolean;
-            authorIds?: string[];
-            tagIds?: string[];
-            coverStorageId?: string | null;
-            ogImageStorageId?: string | null;
-            featureImageAlt?: string;
-            featureImageCaption?: string;
-            seoTitle?: string;
-            seoDescription?: string;
-            /** Format: uri */
-            canonicalUrl?: string;
-            /** Format: date-time */
-            publishedAt?: string;
-            title: string;
-            /** @enum {string} */
-            status?: "draft" | "scheduled" | "published";
-        };
-        CreateCompanyBody: {
-            /** @description Public company website URL. Normalized to a canonical apex domain when stored. */
-            website?: string;
-            /** @description One-line summary of the company. Up to 280 characters. */
-            summary?: string;
-            /** @description Long-form description of the company. Up to 25,000 characters. */
-            description?: string;
-            /** @description X (Twitter) profile URL or handle. Stored as the canonical handle. */
-            xUrl?: string;
-            /** @description LinkedIn company page URL. */
-            linkedinUrl?: string;
-            /** @description Facebook company page URL. */
-            facebookUrl?: string;
-            /** @description The company's display name. */
-            name: string;
-            /** @description URL-friendly slug for the company. Auto-generated from `name` when omitted. */
-            slug?: string;
-        };
-        CreateEducationBody: {
-            institutionName: string;
-            institutionUrl?: string;
-            degree?: string;
-            fieldOfStudy?: string;
-            grade?: string;
-            activitiesAndSocieties?: string;
-            startDate?: string;
-            endDate?: string;
-            description?: string;
-            sortOrder?: number;
-        };
-        CreateExperienceBody: {
-            title: string;
-            companyName: string;
-            startDate: string;
-            companyUrl?: string;
-            location?: string;
-            employmentType?: string;
-            locationType?: string;
-            foundVia?: string;
-            endDate?: string;
-            description?: string;
-            sortOrder?: number;
-        };
-        CreateJobBody: {
-            /** @description The ID of an existing company. Provide either `companyId` or `company`, not both. */
-            companyId?: string;
-            /** @description Long-form description of the role. Up to 25,000 characters. */
-            description: string;
-            /** @description URL-friendly slug for the job. Auto-generated from `title` when omitted. */
-            slug?: string;
-            /**
-             * @description Employment type of the role.
-             * @enum {string}
-             */
-            employmentType?: "full_time" | "part_time" | "contract" | "internship" | "temporary" | "volunteer" | "other";
-            /**
-             * @description Whether the role is on-site, hybrid, or fully remote.
-             * @enum {string}
-             */
-            remoteOption?: "on_site" | "hybrid" | "remote";
-            /** @description Where remote candidates must hold work authorization. Each entry is the smallest relevant scope: `worldwide`, a `world_region` (EMEA / LATAM / NA / APAC), a `continent`, a `region`, a `subregion`, a `custom` group (e.g. `EU`), a `country` (ISO 3166-1 alpha-2), or a `subdivision` (ISO 3166-2). Subdivisions auto-imply their parent country in the derived `remoteWorkPermitCountryCodes` output. Worldwide is mutually exclusive with all other entries. The canonical `{type, value}` set is published at `GET /v1/taxonomies/remote-permits`. Pass `[]` to clear an existing constraint. */
-            remotePermits?: {
-                /** @enum {string} */
-                type: "worldwide" | "world_region" | "continent" | "region" | "subregion" | "subdivision" | "country" | "custom";
-                value: string;
-            }[];
-            /** @description Where remote candidates must be timezone-compatible. Each entry mirrors the `remotePermits` shape (`world_region`, `continent`, `region`, `subregion`, `country`) plus `timezone` (specific IANA name with optional `plusMinus` ±N hours expansion) and `all` (every timezone — equivalent of `worldwide` for permits). The canonical `{type, value}` set is published at `GET /v1/taxonomies/remote-timezones`. **When omitted on POST**, the server auto-derives this from `remotePermits` (or `[{all,all}]` if neither was provided). **PATCH never auto-re-derives** — once set, only an explicit replacement updates the stored value, even when `remotePermits` changes. Pass `[]` to clear an existing constraint. */
-            remoteTimezones?: {
-                /** @enum {string} */
-                type: "all" | "world_region" | "continent" | "region" | "subregion" | "country" | "timezone";
-                value: string;
-                plusMinus?: number;
-            }[];
-            /**
-             * @description Whether the employer sponsors visas for remote candidates. One of `yes`, `no`, or `unknown`.
-             * @enum {string}
-             */
-            remoteSponsorship?: "yes" | "no" | "unknown";
-            /**
-             * @description Seniority level of the role.
-             * @enum {string}
-             */
-            seniority?: "entry_level" | "associate" | "mid_level" | "senior" | "lead" | "principal" | "director" | "executive";
-            /** @description Where candidates apply. Accepts an HTTPS URL, a `mailto:` URI, or a bare email address (which is normalized to `mailto:` form). */
-            applicationUrl: string;
-            /** @description Minimum salary, in `salaryCurrency` units. */
-            salaryMin?: number;
-            /** @description Maximum salary, in `salaryCurrency` units. */
-            salaryMax?: number;
-            /** @description Three-letter ISO 4217 currency code for `salaryMin` and `salaryMax`. */
-            salaryCurrency?: string;
-            /**
-             * @description Period the `salaryMin` and `salaryMax` figures are quoted against.
-             * @enum {string}
-             */
-            salaryTimeframe?: "per_year" | "per_month" | "per_week" | "per_day" | "per_hour";
-            /** @description Whether the job appears in featured slots on the public board. */
-            isFeatured?: boolean;
-            /** @description Job expiry as a Unix epoch in milliseconds. On create, omitted or `null` defaults to 30 days from creation. On PATCH, pass `null` to clear an existing expiry. Past timestamps remove the job from the public board. */
-            expiresAt?: number | unknown | unknown;
-            /** @description Time at which the job was first published, as a Unix epoch in milliseconds. When omitted on create with `status: "published"`, the server stamps the current time. Useful for bulk-importing historical jobs while preserving original publication dates. PATCH may overwrite an existing value but cannot clear it. */
-            publishedAt?: number;
-            /** @description Required education credentials. Each value is one of `high_school`, `associate_degree`, `bachelor_degree`, `professional_certificate`, `postgraduate_degree`, or `no_requirements`. */
-            educationRequirements?: ("high_school" | "associate_degree" | "bachelor_degree" | "professional_certificate" | "postgraduate_degree" | "no_requirements")[];
-            /** @description Minimum required experience, expressed in months. */
-            experienceMonths?: number;
-            /** @description If `true`, equivalent experience may substitute for the listed education requirements. */
-            experienceInPlaceOfEducation?: boolean;
-            /**
-             * @description Period denominator for `inOfficeFrequency`.
-             * @enum {string}
-             */
-            inOfficePeriod?: "per_week" | "per_month" | "per_year";
-            /** @description How often the candidate must be in-office over `inOfficePeriod`. */
-            inOfficeFrequency?: number;
-            /** @description Physical office locations associated with the job. Each entry is forward-geocoded server-side; a country mismatch returns `400 jobs_unresolvable_location`. */
-            officeLocations?: components["schemas"]["JobOfficeLocationInput"][];
-            /** @description An external identifier for the job from your own system, such as an ATS requisition ID. Use this value to look up the job later via `GET /v1/jobs?externalId=...` for deduplication. Scoped per-account: two different accounts may reuse the same `externalId` without collision. Up to 255 characters. */
-            externalId?: string;
-            /** @description Board-defined custom-field values, keyed by the field `key` (definitions, including type and option keys, are published at `GET /v1/settings/job-form`). Writes are **additive**: on `PATCH` a key you send is set/overwritten and a key you omit is preserved (unsent keys are never cleared); on `POST` this initializes the bag. Send a key with an intentional-empty value — `null`, `""`, or `[]` — to **clear** it (`""`/`null` clear any type; `[]` clears a `multi_select`); `false` and `0` are kept as real values. Values must match the field type and `single_select`/`multi_select` must use defined option **keys** (not labels); a wrong-typed value is rejected (`custom_field_wrong_type`), never silently cleared. Unknown keys are ignored. The stored bag never contains `null`/empty values. */
-            customFieldValues?: {
-                [key: string]: string | string[] | boolean | number | unknown | unknown;
-            };
-            /** @description The job title. */
-            title: string;
-            company?: components["schemas"]["InlineCompanyInput"];
-            /**
-             * @description Initial status of the job. Defaults to `draft`. Only `draft` and `published` are writable here. The system-set values `expired` and `archived` are not — use the dedicated transitions (`POST /v1/jobs/:id/publish`, `/pause`, `/expire`) for status changes after create.
-             * @enum {string}
-             */
-            status?: "draft" | "published";
-        };
-        CreateJobPostingBody: {
-            submission: {
-                companyName: string;
-                companyWebsite?: string;
-                contactName: string;
-                contactEmail: string;
-                title: string;
-                description: string;
-                employmentType: string;
-                remoteOption: string;
-                officeLocations: {
-                    /** @enum {string} */
-                    provider?: "mapbox";
-                    providerPlaceId?: string;
-                    displayName: string;
-                    countryCode?: string;
-                    region?: string;
-                    locality?: string;
-                    city?: string;
-                    latitude?: number;
-                    longitude?: number;
-                    boundingBox?: number[];
-                    raw?: {
-                        suggestion?: {
-                            [key: string]: unknown;
-                        };
-                        retrieve?: {
-                            [key: string]: unknown;
-                        };
-                    };
-                }[];
-                inOfficePeriod?: string;
-                inOfficeFrequency?: number;
-                seniority?: string;
-                applicationUrl: string;
-                salaryRangeEnabled: boolean;
-                salaryMin?: number;
-                salaryMax?: number;
-                salaryTimeframe?: string;
-                salaryCurrency?: string;
-                selectedPlan?: string;
-                isFeatured?: boolean;
-                remoteWorkingPermits?: {
-                    type: string;
-                    value: string;
-                    label: string;
-                }[];
-                remoteTimezones?: {
-                    type: string;
-                    value: string;
-                    label: string;
-                    plusMinus: number;
-                    offset?: number;
-                }[];
-                /** @enum {string} */
-                remoteSponsorship?: "yes" | "no" | "unknown";
-                customFieldValues?: {
-                    [key: string]: string | string[] | boolean | number;
-                };
-            };
-            remoteAllowedTzOffsets?: number[];
-            remoteWorkPermitCountryCodes?: string[];
-            logoUrl?: string;
-            selectedBilling?: {
-                type: string;
-                id?: string;
-                planId: string;
-            };
-            invoiceBilling?: {
-                billingName?: string;
-                address: {
-                    line1?: string;
-                    city?: string;
-                    postalCode?: string;
-                    country?: string;
-                };
-                taxId?: string;
-                detailFields?: {
-                    name: string;
-                    value: string;
-                }[];
-            };
-            colorMode?: string;
-        };
-        CreatePipelineStageBody: {
-            /** @description The job whose pipeline gains the stage. */
-            jobId: string;
-            /** @description The stage label. */
-            label: string;
-        };
-        CreateTagBody: {
-            /** @description URL-friendly slug for the tag. Auto-generated from `name` when omitted. */
-            slug?: string;
-            /** @description Description for the tag. Sanitized HTML. */
-            description?: string;
-            /**
-             * @description Tag visibility. One of `public` or `internal`.
-             * @enum {string}
-             */
-            visibility?: "public" | "internal";
-            /** @description SEO meta title for the tag page. */
-            metaTitle?: string;
-            /** @description SEO meta description for the tag page. */
-            metaDescription?: string;
-            /** @description The display name of the tag. */
-            name: string;
-        };
-        CustomFieldDefinition: {
-            /** @description Immutable per-board slug. The key in a job’s `customFieldValues`, and the frontend translation token (`customField.<key>.*`). */
-            key: string;
-            /** @description Authoring-default label; the localized public string lives in the board template. */
-            label: string;
-            /**
-             * @description Field type, which dictates the value: `short_text`/`long_text` → string; `single_select` → one option key; `multi_select` → array of option keys; `boolean` → boolean; `number` → number.
-             * @enum {string}
-             */
-            type: "short_text" | "long_text" | "single_select" | "multi_select" | "boolean" | "number";
-            /** @description Present only for `single_select`/`multi_select`. A stored value is one (or, for multi, several) of these option `key`s — never a label. */
-            options?: components["schemas"]["CustomFieldOption"][];
-            /** @description When true, the value cannot be cleared or left empty on a write (rejected with `custom_field_required`). */
-            required: boolean;
-            /** @description Inclusive minimum for `number` fields, when set. */
-            min?: number;
-            /** @description Inclusive maximum for `number` fields, when set. */
-            max?: number;
-        };
-        CustomFieldOption: {
-            /** @description Stable option key — the value stored on a job, not the label. */
-            key: string;
-            /** @description Display label (authoring default; localized per board in the template). */
-            label: string;
-        };
-        DuplicateJobBody: Record<string, never>;
-        DynamicClientRegistrationRequest: {
-            /** @description Array of redirect URIs the client may use. Must be HTTPS, except for `http://localhost` URIs in development. At least one entry is required. */
-            redirect_uris: string[];
-            /** @description Human-readable client name shown to users on the consent screen. Recommended for MCP clients; defaults to "MCP client" when omitted. */
-            client_name?: string;
-            /** @description Space-separated list of scopes the client may request. When omitted, the client is registered for all scopes. */
-            scope?: string;
-            /**
-             * @description OAuth token endpoint authentication method. Use `none` for public PKCE clients that cannot keep a client secret.
-             * @enum {string}
-             */
-            token_endpoint_auth_method?: "client_secret_basic" | "none";
-        };
-        DynamicClientRegistrationResponse: {
-            /** @description Public OAuth client identifier. */
-            client_id: string;
-            /** @description Time at which the client was registered. Unix epoch in seconds. */
-            client_id_issued_at: number;
-            /** @description Plaintext OAuth client secret. Returned exactly once for confidential clients; omitted for public clients. */
-            client_secret?: string;
-            /** @description Time at which the client secret expires. Unix epoch in seconds, or `0` if the secret does not expire. Omitted for public clients. */
-            client_secret_expires_at?: number;
-            /** @description Array of redirect URIs registered for the client. */
-            redirect_uris: string[];
-            /** @description Human-readable client name shown to users on the consent screen. */
-            client_name: string;
-            /** @description OAuth grant types the client is permitted to use. */
-            grant_types: string[];
-            /** @description OAuth response types the client is permitted to use. */
-            response_types: string[];
-            /** @description Authentication method the client uses at the token endpoint. */
-            token_endpoint_auth_method: string;
-            /** @description Space-separated list of scopes the client may request. */
-            scope: string;
-        };
-        EditMessageBody: {
-            body: string;
-        };
-        EmployerApplicant: {
-            id: string;
-            /** @enum {string} */
-            object: "employer_applicant";
-            jobId: string;
-            candidateBoardUserId: string | null;
-            candidateProfileId: string | null;
-            candidateProfileHandle: string | null;
-            candidateName: string | null;
-            candidateEmail: string | null;
-            candidateHeadline: string | null;
-            candidateLocation: string | null;
-            coverNote: string | null;
-            resumeFilename: string | null;
-            /** @description A short-lived signed URL to the uploaded resume, or `null`. */
-            resumeUrl: string | null;
-            stage: string;
-            /** @description How the application arrived (e.g. `native_apply`). */
-            source: string;
-            /** Format: date-time */
-            appliedAt: string;
-            timeline: components["schemas"]["EmployerApplicantTimelineEntry"][];
-        };
-        EmployerApplicantTimelineEntry: {
-            id: string;
-            /** @description The activity kind (e.g. `stage_changed`, `note_created`, `application_created`). */
-            type: string;
-            actorBoardUserId: string | null;
-            actorName: string | null;
-            noteId: string | null;
-            /** @description The note text for a `note_created` entry, else `null`. */
-            noteBody: string | null;
-            fromStage: string | null;
-            toStage: string | null;
-            /** Format: date-time */
-            createdAt: string;
-        };
-        EmployerBillingOption: {
-            id: string;
-            /** @enum {string} */
-            object: "employer_billing_option";
-            /** @enum {string} */
-            type: "subscription" | "order";
-            planId: string;
-            planName: string;
-            /** @enum {string} */
-            planKind: "subscription" | "one_time" | "bundle";
-            jobsRemaining: number;
-            jobsTotal: number;
-            featuredRemaining: number;
-            featuredTotal: number;
-            /**
-             * Format: date-time
-             * @description When a subscription renews, or `null` for one-time orders.
-             */
-            renewsAt: string | null;
-        };
-        EmployerCheckout: {
-            /** @enum {string} */
-            object: "employer_checkout";
-            /** @enum {string} */
-            status: "checkout" | "published" | "invoice_sent";
-            /** @description The Stripe Checkout / hosted-invoice URL, or `null`. */
-            checkoutUrl: string | null;
-            jobId: string;
-            jobSlug: string | null;
-        };
-        EmployerCheckoutBody: {
-            billing: {
-                /** @enum {string} */
-                type: "new";
-                planId: string;
-            } | {
-                /** @enum {string} */
-                type: "order";
-                planId: string;
-                id: string;
-            } | {
-                /** @enum {string} */
-                type: "subscription";
-                planId: string;
-                id: string;
-            };
-            invoiceBilling?: {
-                billingName?: string;
-                /** Format: email */
-                email?: string;
-                address?: {
-                    line1?: string;
-                    city?: string;
-                    postalCode?: string;
-                    country?: string;
-                };
-                taxId?: string;
-                detailFields?: {
-                    name: string;
-                    value: string;
-                }[];
-            };
-            isFeatured?: boolean;
-            /**
-             * Format: uri
-             * @description Where Stripe returns the buyer on success. Defaults to the board's canonical employer pages.
-             */
-            successUrl?: string;
-            /**
-             * Format: uri
-             * @description Where Stripe returns the buyer on cancel.
-             */
-            cancelUrl?: string;
-        };
-        EmployerCompany: {
-            id: string;
-            /** @enum {string} */
-            object: "employer_company";
-            name: string;
-            slug: string;
-            website: string | null;
-            description: string | null;
-            summary: string | null;
-            xUrl: string | null;
-            linkedinUrl: string | null;
-            facebookUrl: string | null;
-            logoUrl: string | null;
-        };
-        EmployerCreateJobBody: {
-            /** @description Long-form description of the role. Up to 25,000 characters. */
-            description: string;
-            /** @description URL-friendly slug for the job. Auto-generated from `title` when omitted. */
-            slug?: string;
-            /**
-             * @description Employment type of the role.
-             * @enum {string}
-             */
-            employmentType?: "full_time" | "part_time" | "contract" | "internship" | "temporary" | "volunteer" | "other";
-            /**
-             * @description Whether the role is on-site, hybrid, or fully remote.
-             * @enum {string}
-             */
-            remoteOption?: "on_site" | "hybrid" | "remote";
-            /** @description Where remote candidates must hold work authorization. Each entry is the smallest relevant scope: `worldwide`, a `world_region` (EMEA / LATAM / NA / APAC), a `continent`, a `region`, a `subregion`, a `custom` group (e.g. `EU`), a `country` (ISO 3166-1 alpha-2), or a `subdivision` (ISO 3166-2). Subdivisions auto-imply their parent country in the derived `remoteWorkPermitCountryCodes` output. Worldwide is mutually exclusive with all other entries. The canonical `{type, value}` set is published at `GET /v1/taxonomies/remote-permits`. Pass `[]` to clear an existing constraint. */
-            remotePermits?: {
-                /** @enum {string} */
-                type: "worldwide" | "world_region" | "continent" | "region" | "subregion" | "subdivision" | "country" | "custom";
-                value: string;
-            }[];
-            /** @description Where remote candidates must be timezone-compatible. Each entry mirrors the `remotePermits` shape (`world_region`, `continent`, `region`, `subregion`, `country`) plus `timezone` (specific IANA name with optional `plusMinus` ±N hours expansion) and `all` (every timezone — equivalent of `worldwide` for permits). The canonical `{type, value}` set is published at `GET /v1/taxonomies/remote-timezones`. **When omitted on POST**, the server auto-derives this from `remotePermits` (or `[{all,all}]` if neither was provided). **PATCH never auto-re-derives** — once set, only an explicit replacement updates the stored value, even when `remotePermits` changes. Pass `[]` to clear an existing constraint. */
-            remoteTimezones?: {
-                /** @enum {string} */
-                type: "all" | "world_region" | "continent" | "region" | "subregion" | "country" | "timezone";
-                value: string;
-                plusMinus?: number;
-            }[];
-            /**
-             * @description Whether the employer sponsors visas for remote candidates. One of `yes`, `no`, or `unknown`.
-             * @enum {string}
-             */
-            remoteSponsorship?: "yes" | "no" | "unknown";
-            /**
-             * @description Seniority level of the role.
-             * @enum {string}
-             */
-            seniority?: "entry_level" | "associate" | "mid_level" | "senior" | "lead" | "principal" | "director" | "executive";
-            /** @description Where candidates apply. Accepts an HTTPS URL, a `mailto:` URI, or a bare email address (normalized to `mailto:` form). */
-            applicationUrl: string;
-            /** @description Minimum salary, in `salaryCurrency` units. */
-            salaryMin?: number;
-            /** @description Maximum salary, in `salaryCurrency` units. */
-            salaryMax?: number;
-            /** @description Three-letter ISO 4217 currency code for `salaryMin` and `salaryMax`. */
-            salaryCurrency?: string;
-            /**
-             * @description Period the `salaryMin` and `salaryMax` figures are quoted against.
-             * @enum {string}
-             */
-            salaryTimeframe?: "per_year" | "per_month" | "per_week" | "per_day" | "per_hour";
-            /** @description Required education credentials. Each value is one of `high_school`, `associate_degree`, `bachelor_degree`, `professional_certificate`, `postgraduate_degree`, or `no_requirements`. */
-            educationRequirements?: ("high_school" | "associate_degree" | "bachelor_degree" | "professional_certificate" | "postgraduate_degree" | "no_requirements")[];
-            /** @description Minimum required experience, expressed in months. */
-            experienceMonths?: number;
-            /** @description If `true`, equivalent experience may substitute for the listed education requirements. */
-            experienceInPlaceOfEducation?: boolean;
-            /**
-             * @description Period denominator for `inOfficeFrequency`.
-             * @enum {string}
-             */
-            inOfficePeriod?: "per_week" | "per_month" | "per_year";
-            /** @description How often the candidate must be in-office over `inOfficePeriod`. */
-            inOfficeFrequency?: number;
-            /** @description Physical office locations associated with the job. Each entry is forward-geocoded server-side; a country mismatch returns `400 jobs_unresolvable_location`. */
-            officeLocations?: components["schemas"]["JobOfficeLocationInput"][];
-            /** @description The job title. */
-            title: string;
-        };
-        EmployerJob: components["schemas"]["EmployerJobSummary"] & {
-            /** @description Long-form description of the role, or `null` if not specified. */
-            description: string | null;
-            /** @description Where candidates apply, or `null` if not specified. An HTTPS URL or `mailto:` URI. */
-            applicationUrl: string | null;
-            /** @description Hierarchical permit selection authored by the employer. The three `remoteWorkPermit*` and `remoteWorldwide` fields are read-only derived projections. */
-            remotePermits: {
-                type: string;
-                value: string;
-            }[];
-            /** @description Read-only — derived from `remotePermits`. */
-            remoteWorldwide: boolean | null;
-            /** @description Hierarchical timezone selection. The flat `remoteAllowedTzOffsets` below is the read-only derived projection. */
-            remoteTimezones: {
-                type: string;
-                value: string;
-                plusMinus?: number;
-            }[];
-            /** @description Read-only — derived from `remoteTimezones`. UTC hour offsets. */
-            remoteAllowedTzOffsets: number[];
-            /** @description Read-only — derived from `remotePermits`. ISO 3166-1 alpha-2. */
-            remoteWorkPermitCountryCodes: string[];
-            /** @description Read-only — derived from `remotePermits`. ISO 3166-2. */
-            remoteWorkPermitSubdivisionCodes: string[];
-            /**
-             * @description Whether the employer sponsors visas for remote candidates. One of `yes`, `no`, or `unknown`.
-             * @enum {string}
-             */
-            remoteSponsorship: "yes" | "no" | "unknown";
-            /** @description Required education credentials. */
-            educationRequirements: ("high_school" | "associate_degree" | "bachelor_degree" | "professional_certificate" | "postgraduate_degree" | "no_requirements")[];
-            /** @description Minimum required experience in months, or `null`. */
-            experienceMonths: number | null;
-            /** @description If `true`, equivalent experience may substitute for education. `null` if not specified. */
-            experienceInPlaceOfEducation: boolean | null;
-            /**
-             * @description Period denominator for `inOfficeFrequency`, or `null`.
-             * @enum {string|null}
-             */
-            inOfficePeriod: "per_week" | "per_month" | "per_year" | null;
-            /** @description How often the candidate must be in-office, or `null`. */
-            inOfficeFrequency: number | null;
-            company: components["schemas"]["JobCompany"];
-            /** @description Physical office locations associated with the job. */
-            officeLocations: components["schemas"]["JobOfficeLocation"][];
-        };
-        /** @description Public-only links. The operator dashboard URL is intentionally omitted on employer responses. */
-        EmployerJobLinks: {
-            /**
-             * Format: uri
-             * @description Canonical public URL for this job, or `null` when the job has no slug or no associated company slug (so a stable URL cannot be assembled). A draft carries a URL but only resolves once published.
-             */
-            public: string | null;
-        };
-        EmployerJobSummary: {
-            /** @description Unique identifier for the object. Use this value as the `{id}` path parameter for the job endpoints (e.g. `GET /v1/jobs/{id}`). */
-            id: string;
-            /**
-             * @description String representing the object's type. Objects of the same type share the same value.
-             * @enum {string}
-             */
-            object: "employer_job";
-            /** @description The job title. */
-            title: string;
-            /** @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`.
-             * @enum {string}
-             */
-            status: "draft" | "published" | "expired" | "archived";
-            /** @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.
-             * @enum {string|null}
-             */
-            employmentType: "full_time" | "part_time" | "contract" | "internship" | "temporary" | "volunteer" | "other" | null;
-            /**
-             * @description Whether the role is on-site, hybrid, or fully remote, or `null` if not specified.
-             * @enum {string|null}
-             */
-            remoteOption: "on_site" | "hybrid" | "remote" | null;
-            /**
-             * @description Seniority level of the role, or `null` if not specified.
-             * @enum {string|null}
-             */
-            seniority: "entry_level" | "associate" | "mid_level" | "senior" | "lead" | "principal" | "director" | "executive" | null;
-            /** @description Minimum salary in `salaryCurrency` units, or `null` if not specified. */
-            salaryMin: number | null;
-            /** @description Maximum salary in `salaryCurrency` units, or `null` if not specified. */
-            salaryMax: number | null;
-            /** @description Three-letter ISO 4217 currency code for the salary range, or `null` if no salary is specified. */
-            salaryCurrency: string | null;
-            /**
-             * @description Period the salary range is quoted against, or `null` if no salary is specified.
-             * @enum {string|null}
-             */
-            salaryTimeframe: "per_year" | "per_month" | "per_week" | "per_day" | "per_hour" | null;
-            /** @description Whether the job appears in featured slots on the public board. */
-            isFeatured: boolean;
-            /** @description Time at which the job was first published, or `null` if not yet published. ISO 8601 datetime. */
-            publishedAt: string | null;
-            /** @description Time at which the job expires, or `null` if no expiry is set. ISO 8601 datetime. */
-            expiresAt: string | null;
-            /** @description Time at which the job was created. ISO 8601 datetime. */
-            createdAt: string;
-            /** @description Time at which the job was last updated. ISO 8601 datetime. */
-            updatedAt: string;
-            links: components["schemas"]["EmployerJobLinks"];
-        };
-        EmployerPipeline: {
-            /** @enum {string} */
-            object: "employer_pipeline";
-            job: {
-                id: string;
-                title: string;
-                status: string;
-                /** Format: date-time */
-                expiresAt: string | null;
-            };
-            stages: components["schemas"]["EmployerPipelineStage"][];
-            applicants: components["schemas"]["EmployerApplicant"][];
-        };
-        EmployerPipelineStage: {
-            id: string;
-            /** @enum {string} */
-            object: "employer_pipeline_stage";
-            jobId: string;
-            label: string;
-            /** @description The stable system meaning (`review`/`offer`/`hired`/`rejected`), or `null` for a custom employer stage. */
-            systemStage: string | null;
-            isProtected: boolean;
-            hidden: boolean;
-            position: number;
-        };
-        EmployerUpdateJobBody: {
-            /** @description Long-form description of the role. Up to 25,000 characters. */
-            description?: string;
-            /** @description URL-friendly slug for the job. Auto-generated from `title` when omitted. */
-            slug?: string;
-            /**
-             * @description Employment type of the role.
-             * @enum {string}
-             */
-            employmentType?: "full_time" | "part_time" | "contract" | "internship" | "temporary" | "volunteer" | "other";
-            /**
-             * @description Whether the role is on-site, hybrid, or fully remote.
-             * @enum {string}
-             */
-            remoteOption?: "on_site" | "hybrid" | "remote";
-            /** @description Where remote candidates must hold work authorization. Each entry is the smallest relevant scope: `worldwide`, a `world_region` (EMEA / LATAM / NA / APAC), a `continent`, a `region`, a `subregion`, a `custom` group (e.g. `EU`), a `country` (ISO 3166-1 alpha-2), or a `subdivision` (ISO 3166-2). Subdivisions auto-imply their parent country in the derived `remoteWorkPermitCountryCodes` output. Worldwide is mutually exclusive with all other entries. The canonical `{type, value}` set is published at `GET /v1/taxonomies/remote-permits`. Pass `[]` to clear an existing constraint. */
-            remotePermits?: {
-                /** @enum {string} */
-                type: "worldwide" | "world_region" | "continent" | "region" | "subregion" | "subdivision" | "country" | "custom";
-                value: string;
-            }[];
-            /** @description Where remote candidates must be timezone-compatible. Each entry mirrors the `remotePermits` shape (`world_region`, `continent`, `region`, `subregion`, `country`) plus `timezone` (specific IANA name with optional `plusMinus` ±N hours expansion) and `all` (every timezone — equivalent of `worldwide` for permits). The canonical `{type, value}` set is published at `GET /v1/taxonomies/remote-timezones`. **When omitted on POST**, the server auto-derives this from `remotePermits` (or `[{all,all}]` if neither was provided). **PATCH never auto-re-derives** — once set, only an explicit replacement updates the stored value, even when `remotePermits` changes. Pass `[]` to clear an existing constraint. */
-            remoteTimezones?: {
-                /** @enum {string} */
-                type: "all" | "world_region" | "continent" | "region" | "subregion" | "country" | "timezone";
-                value: string;
-                plusMinus?: number;
-            }[];
-            /**
-             * @description Whether the employer sponsors visas for remote candidates. One of `yes`, `no`, or `unknown`.
-             * @enum {string}
-             */
-            remoteSponsorship?: "yes" | "no" | "unknown";
-            /**
-             * @description Seniority level of the role.
-             * @enum {string}
-             */
-            seniority?: "entry_level" | "associate" | "mid_level" | "senior" | "lead" | "principal" | "director" | "executive";
-            /** @description Where candidates apply. Accepts an HTTPS URL, a `mailto:` URI, or a bare email address (which is normalized to `mailto:` form). */
-            applicationUrl?: string;
-            /** @description Minimum salary, in `salaryCurrency` units. */
-            salaryMin?: number;
-            /** @description Maximum salary, in `salaryCurrency` units. */
-            salaryMax?: number;
-            /** @description Three-letter ISO 4217 currency code for `salaryMin` and `salaryMax`. */
-            salaryCurrency?: string;
-            /**
-             * @description Period the `salaryMin` and `salaryMax` figures are quoted against.
-             * @enum {string}
-             */
-            salaryTimeframe?: "per_year" | "per_month" | "per_week" | "per_day" | "per_hour";
-            /** @description Required education credentials. Each value is one of `high_school`, `associate_degree`, `bachelor_degree`, `professional_certificate`, `postgraduate_degree`, or `no_requirements`. */
-            educationRequirements?: ("high_school" | "associate_degree" | "bachelor_degree" | "professional_certificate" | "postgraduate_degree" | "no_requirements")[];
-            /** @description Minimum required experience, expressed in months. */
-            experienceMonths?: number;
-            /** @description If `true`, equivalent experience may substitute for the listed education requirements. */
-            experienceInPlaceOfEducation?: boolean;
-            /**
-             * @description Period denominator for `inOfficeFrequency`.
-             * @enum {string}
-             */
-            inOfficePeriod?: "per_week" | "per_month" | "per_year";
-            /** @description How often the candidate must be in-office over `inOfficePeriod`. */
-            inOfficeFrequency?: number;
-            /** @description Physical office locations associated with the job. Each entry is forward-geocoded server-side; a country mismatch returns `400 jobs_unresolvable_location`. */
-            officeLocations?: components["schemas"]["JobOfficeLocationInput"][];
-            /** @description The job title. */
-            title?: string;
-        };
-        FindOrCreateCompanyBody: {
-            /** @description The company's display name. */
-            name: string;
-            /** @description Public company website URL. Used to resolve to an existing company by domain before falling back to creation. */
-            website?: string;
-            /** @description One-line summary of the company. Up to 280 characters. */
-            summary?: string;
-            /** @description If `true` (default), falls back to matching by `name` when no website match is found. Set to `false` to match by website domain only. */
-            matchByName?: boolean;
-            /** @description If `true` (default), creates a new company when no match is found. Set to `false` to receive a `404 companies_not_found` response instead. */
-            createIfMissing?: boolean;
-        };
-        HandleAvailability: {
-            /** @enum {string} */
-            object: "handle_availability";
-            handle: string;
-            available: boolean;
-        };
-        /** @description An inline company payload, resolved via `find-or-create` before the job is created. Provide either `company` or `companyId`, not both. */
-        InlineCompanyInput: {
-            /** @description The company's display name. */
-            name: string;
-            /** @description Public company website URL. Used to resolve to an existing company by domain before falling back to creation. */
-            website?: string;
-            /** @description One-line summary of the company. Up to 280 characters. */
-            summary?: string;
-            /** @description If `true` (default), falls back to matching by `name` when no website match is found. Set to `false` to match by website domain only. */
-            matchByName?: boolean;
-            /** @description If `true` (default), creates a new company when no match is found. Set to `false` to receive a `404 companies_not_found` response instead. */
-            createIfMissing?: boolean;
-        };
-        Job: components["schemas"]["JobSummary"] & {
-            /** @description Public + admin URLs for this job. `public` may be `null` if the job lacks a slug or company-slug. */
-            links?: components["schemas"]["ResourceLinks"] & {
-                /**
-                 * Format: uri
-                 * @description Canonical public URL for this job, or `null` when the job has no slug or no associated company slug (so a stable URL cannot be assembled).
-                 */
-                public?: string | null;
-            };
-            /** @description Long-form description of the role, or `null` if not specified. */
-            description: string | null;
-            /** @description Where candidates apply, or `null` if not specified. An HTTPS URL or `mailto:` URI. */
-            applicationUrl: string | null;
-            /** @description Hierarchical permit selection authored by the caller. Lossless round-trip with the input — `[{type:"world_region",value:"EMEA"}]` goes in and comes out the same. The three `remoteWorkPermit*` and `remoteWorldwide` fields below are read-only derived projections of this list. */
-            remotePermits: {
-                type: string;
-                value: string;
-            }[];
-            /** @description Read-only — derived from `remotePermits`. `true` only when the authored selection is a single `{type:"worldwide"}` entry. */
-            remoteWorldwide: boolean | null;
-            /** @description Hierarchical timezone selection. Lossless round-trip with the authored input. When omitted on POST, the server auto-derives this from `remotePermits` (or `[{all,all}]` if neither was provided). PATCH never auto-re-derives — once set, only an explicit replacement updates the stored value. The flat `remoteAllowedTzOffsets` field below is the read-only derived projection used by search. */
-            remoteTimezones: {
-                type: string;
-                value: string;
-                plusMinus?: number;
-            }[];
-            /** @description Read-only — derived from `remoteTimezones` (per-country/per-region offset fan-out). UTC hour offsets used by the job-search index. */
-            remoteAllowedTzOffsets: number[];
-            /** @description Read-only — derived from `remotePermits` (hierarchical groups fan out to alpha2 sets; subdivisions auto-add the parent country). ISO 3166-1 alpha-2 codes. */
-            remoteWorkPermitCountryCodes: string[];
-            /** @description Read-only — derived from `remotePermits` (subdivision entries only). ISO 3166-2 codes. */
-            remoteWorkPermitSubdivisionCodes: string[];
-            /**
-             * @description Whether the employer sponsors visas for remote candidates. One of `yes`, `no`, or `unknown`.
-             * @enum {string}
-             */
-            remoteSponsorship: "yes" | "no" | "unknown";
-            /** @description Required education credentials. Each value is one of `high_school`, `associate_degree`, `bachelor_degree`, `professional_certificate`, `postgraduate_degree`, or `no_requirements`. */
-            educationRequirements: ("high_school" | "associate_degree" | "bachelor_degree" | "professional_certificate" | "postgraduate_degree" | "no_requirements")[];
-            /** @description Minimum required experience in months, or `null` if not specified. */
-            experienceMonths: number | null;
-            /** @description If `true`, equivalent experience may substitute for the listed education requirements. `null` if not specified. */
-            experienceInPlaceOfEducation: boolean | null;
-            /**
-             * @description Period denominator for `inOfficeFrequency`, or `null` if not specified.
-             * @enum {string|null}
-             */
-            inOfficePeriod: "per_week" | "per_month" | "per_year" | null;
-            /** @description How often the candidate must be in-office over `inOfficePeriod`, or `null` if not specified. */
-            inOfficeFrequency: number | null;
-            company: components["schemas"]["JobCompany"];
-            /** @description Physical office locations associated with the job. */
-            officeLocations: components["schemas"]["JobOfficeLocation"][];
-        };
-        /** @description Embedded company resource for the job, or `null` if no company is attached. */
-        JobCompany: {
-            /** @description Unique identifier for the company. */
-            id: string;
-            /** @description Display name of the company, or `null` if not yet set. */
-            name: string | null;
-            /** @description URL slug of the company, or `null` if not yet set. */
-            slug: string | null;
-            /** @description URL of the company logo, or `null` if no logo is set. */
-            logoUrl: string | null;
-            /** @description Company website URL, or `null` if no website is set. */
-            website: string | null;
-        } | null;
-        JobFormConfig: {
-            sponsorship?: {
-                visible: boolean;
-            };
-            salary?: {
-                visible: boolean;
-                required?: boolean;
-                minBound?: number;
-                maxBound?: number;
-                allowedCurrencies?: string[];
-            };
-            seniority?: {
-                visible: boolean;
-                required?: boolean;
-                allowedOptions?: string[];
-            };
-            workArrangement?: {
-                allowedOptions: string[];
-            };
-            employmentType?: {
-                allowedOptions: string[];
-            };
-            location?: {
-                visible: boolean;
-                allowedCountries?: string[];
-            };
-            /** @description Board-defined custom field definitions, in display order. Read these to learn which `customFieldValues` keys, types, and option keys a job accepts on POST/PATCH /v1/jobs. */
-            customFields?: components["schemas"]["CustomFieldDefinition"][];
-        };
-        JobOfficeLocation: {
-            /** @description ISO 3166-1 alpha-2 country code, or `null` if the location was not resolved. */
-            countryCode: string | null;
-            /** @description Full country name, or `null` if the location was not resolved. */
-            country: string | null;
-            /** @description Neighborhood or sub-locality, or `null` if not resolved. */
-            locality: string | null;
-            /** @description City, or `null` if not resolved. */
-            city: string | null;
-            /** @description Region, state, or province name, or `null` if not resolved. */
-            region: string | null;
-            /** @description Region or state code (e.g. `CA` for California), or `null` if not resolved. */
-            regionCode: string | null;
-            /** @description Postal or ZIP code, or `null` if not resolved. */
-            postalCode: string | null;
-            /** @description Pre-formatted display name for the location, or `null` if not resolved. */
-            displayName: string | null;
-        };
-        JobOfficeLocationInput: {
-            /** @description Neighborhood or sub-locality. */
-            locality?: string;
-            /** @description City. */
-            city: string;
-            /** @description Region, state, or province. */
-            region?: string;
-            /** @description ISO 3166-1 alpha-2 country code OR recognized country name/alias. Aliases are normalized to canonical alpha-2 server-side (e.g. `US`, `USA`, `United States` → `US`; `UK`, `GB`, `United Kingdom` → `GB`). */
-            country: string;
-        } | {
-            /** @description Free-form location string (e.g. `"Berlin, Germany"`, `"Mountain View, California, USA"`). Mapbox parses + ranks candidates server-side; rejects on low confidence. */
-            query: string;
-        };
-        JobPostingBillingCheck: {
-            /** @enum {string} */
-            object: "job_posting_billing_check";
-            hasActiveBilling: boolean;
-        };
-        JobPostingBillingOptions: {
-            /** @enum {string} */
-            object: "job_posting_billing_options";
-            options: {
-                id: string;
-                type: string;
-                planId: string;
-                planName: string;
-                planKind: string;
-                capacities: {
-                    key: string;
-                    total: number;
-                    used: number;
-                    remaining: number;
-                }[];
-                jobsRemaining: number;
-                jobsTotal: number;
-                featuredRemaining: number;
-                featuredTotal: number;
-                renewsAt: string | null;
-            }[];
-        };
-        JobPostingBillingOptionsBody: {
-            verificationToken: string;
-        };
-        JobPostingBillingVerification: {
-            /** @enum {string} */
-            object: "job_posting_billing_verification";
-            success: boolean;
-        };
-        JobPostingCheckBillingBody: {
-            /** Format: email */
-            email: string;
-        };
-        JobPostingLogo: {
-            /** @enum {string} */
-            object: "job_posting_logo";
-            publicUrl: string;
-        };
-        JobPostingPlan: {
-            /** @enum {string} */
-            object: "job_posting_plan";
-            id: string;
-            name: string;
-            description: string | null;
-            kind: string;
-            /** @enum {string|null} */
-            billingInterval: "month" | "year" | null;
-            /** @enum {string|null} */
-            purpose: "job_posting" | "talent_access" | null;
-            isRecommended: boolean;
-            displayOrder: number | null;
-            invoiceOnly: boolean;
-            /** @enum {string|null} */
-            publishTiming: "on_issue" | "on_payment" | null;
-            netTermsDays: number | null;
-            prices: {
-                currency: string;
-                amountCents: number;
-                isActive: boolean;
-            }[];
-            features: {
-                key: string | null;
-                value: string | null;
-            }[];
-        };
-        JobPostingResult: {
-            /** @enum {string} */
-            object: "job_posting_result";
-            /** @enum {string} */
-            status: "checkout";
-            checkoutUrl: string;
-            jobId: string;
-        } | {
-            /** @enum {string} */
-            object: "job_posting_result";
-            /** @enum {string} */
-            status: "published";
-            jobId: string;
-            jobSlug: string;
-        } | {
-            /** @enum {string} */
-            object: "job_posting_result";
-            /** @enum {string} */
-            status: "pending_approval";
-            jobId: string;
-        } | {
-            /** @enum {string} */
-            object: "job_posting_result";
-            /** @enum {string} */
-            status: "invoice_sent";
-            jobId: string;
-        };
-        JobPostingSendVerificationBody: {
-            /** Format: email */
-            email: string;
-        };
-        JobPostingSubscriptionEntitlements: {
-            /** @enum {string} */
-            object: "job_posting_subscription_entitlements";
-            hasSubscription: boolean;
-            subscriptionId: string | null;
-            canFeature: boolean | null;
-            featuredSlotsRemaining: number | null;
-            featuredSlotsTotal: number | null;
-            maxActiveRemaining: number | null;
-            maxActiveTotal: number | null;
-            featureSelectionMode: string | null;
-        };
-        JobPostingSubscriptionEntitlementsBody: {
-            /** Format: email */
-            email: string;
-            planId: string;
-        };
-        JobSummary: {
-            /** @description Unique identifier for the object. Use this value as the `{id}` path parameter for the job endpoints (e.g. `GET /v1/jobs/{id}`). */
-            id: string;
-            /**
-             * @description String representing the object's type. Objects of the same type share the same value.
-             * @enum {string}
-             */
-            object: "job";
-            /** @description The job title. */
-            title: string;
-            /** @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`.
-             * @enum {string}
-             */
-            status: "draft" | "published" | "expired" | "archived";
-            /** @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.
-             * @enum {string|null}
-             */
-            employmentType: "full_time" | "part_time" | "contract" | "internship" | "temporary" | "volunteer" | "other" | null;
-            /**
-             * @description Whether the role is on-site, hybrid, or fully remote, or `null` if not specified.
-             * @enum {string|null}
-             */
-            remoteOption: "on_site" | "hybrid" | "remote" | null;
-            /**
-             * @description Seniority level of the role, or `null` if not specified.
-             * @enum {string|null}
-             */
-            seniority: "entry_level" | "associate" | "mid_level" | "senior" | "lead" | "principal" | "director" | "executive" | null;
-            /** @description Minimum salary in `salaryCurrency` units, or `null` if not specified. */
-            salaryMin: number | null;
-            /** @description Maximum salary in `salaryCurrency` units, or `null` if not specified. */
-            salaryMax: number | null;
-            /** @description Three-letter ISO 4217 currency code for the salary range, or `null` if no salary is specified. */
-            salaryCurrency: string | null;
-            /**
-             * @description Period the salary range is quoted against, or `null` if no salary is specified.
-             * @enum {string|null}
-             */
-            salaryTimeframe: "per_year" | "per_month" | "per_week" | "per_day" | "per_hour" | null;
-            /** @description Whether the job appears in featured slots on the public board. */
-            isFeatured: boolean;
-            /** @description Time at which the job was first published, or `null` if not yet published. ISO 8601 datetime. */
-            publishedAt: string | null;
-            /** @description Time at which the job expires, or `null` if no expiry is set. ISO 8601 datetime. */
-            expiresAt: string | null;
-            /** @description Time at which the job was created. ISO 8601 datetime. */
-            createdAt: string;
-            /** @description Time at which the job was last updated. ISO 8601 datetime. */
-            updatedAt: string;
-            /** @description External identifier supplied by the caller on create, used for deduplication via `GET /v1/jobs?externalId=...`. `null` when no external identifier was set. */
-            externalId: string | null;
-            /** @description Board-defined custom-field values for this job, keyed by the field `key` (the definitions are published at `GET /v1/settings/job-form`). Each value is returned as stored: a string (`short_text` / `long_text` / a `single_select` option key), a string array (`multi_select` option keys), a boolean, or a number. Always an object — `{}` when the job has no custom-field values, never `null` or a missing field. Only real values are stored, so this never contains `null` or empty values. */
-            customFieldValues: {
-                [key: string]: string | string[] | boolean | number;
-            };
-            links: components["schemas"]["AdminOnlyResourceLinks"];
-        };
-        LegalPage: {
-            /** @enum {string} */
-            object: "legal_page";
-            /** @description The resolved legal page type. */
-            type: string;
-            /** @description Page heading (H1), with `{{board_name}}` resolved. */
-            title: string;
-            /** @description Owner-authored prose as portable HTML (transitional field, ADR-0039 — the starter authors the layout). Empty string when the page has no text body. */
-            content: string;
-            /** @enum {string} */
-            contentFormat: "html";
-            /** @description Structured impressum legal-entity facts; `null` for non-impressum pages. */
-            legalEntity: {
-                legalName: string | null;
-                address: string | null;
-            } | null;
-        };
-        LocationSalaryDetail: {
-            /** @enum {string} */
-            object: "location_salary_detail";
-            /** @description Immutable English source place slug — the salary-stats key. */
-            sourceSlug: string;
-            /** @description Board-language canonical URL slug — the starter 308 target. */
-            canonicalSlug: string;
-            placeName: string;
-            placeId: string;
-            adminLevel: string;
-            countryCode: string;
-            overallSalary: {
-                avgMin: number;
-                avgMax: number;
-                medianMin: number;
-                medianMax: number;
-                p25Min: number;
-                p75Max: number;
-                jobCount: number;
-            } | null;
-            childLocations: {
-                placeName: string;
-                placeSlug: string;
-                countryCode: string;
-                avgSalaryMin: number;
-                avgSalaryMax: number;
-                medianSalaryMin: number;
-                medianSalaryMax: number;
-                p25SalaryMin: number;
-                p75SalaryMax: number;
-                jobCount: number;
-                currency: string;
-            }[];
-            childLocationsByRegion: {
-                regionName: string;
-                regionSlug: string;
-                cities: {
-                    placeName: string;
-                    placeSlug: string;
-                    countryCode: string;
-                    avgSalaryMin: number;
-                    avgSalaryMax: number;
-                    medianSalaryMin: number;
-                    medianSalaryMax: number;
-                    p25SalaryMin: number;
-                    p75SalaryMax: number;
-                    jobCount: number;
-                    currency: string;
-                }[];
-            }[];
-            topCategories: {
-                avgSalaryMin: number;
-                avgSalaryMax: number;
-                jobCount: number;
-                categorySlug: string;
-                categoryName: string;
-            }[];
-            topSkills: {
-                avgSalaryMin: number;
-                avgSalaryMax: number;
-                jobCount: number;
-                skillSlug: string;
-                skillName: string;
-            }[];
-            siblingLocations: {
-                placeName: string;
-                placeSlug: string;
-                countryCode: string;
-                avgSalaryMin: number;
-                avgSalaryMax: number;
-                medianSalaryMin: number;
-                medianSalaryMax: number;
-                p25SalaryMin: number;
-                p75SalaryMax: number;
-                jobCount: number;
-                currency: string;
-            }[];
-            boardOverallAvgMin: number | null;
-            boardOverallAvgMax: number | null;
-            currency: string;
-        };
-        LocationSkillsIndex: {
-            /** @enum {string} */
-            object: "location_skills_index";
-            sourceSlug: string;
-            canonicalSlug: string;
-            placeName: string;
-            skills: {
-                slug: string;
-                name: string;
-                avgSalaryMin: number;
-                avgSalaryMax: number;
-                jobCount: number;
-            }[];
-        };
-        LocationTitlesIndex: {
-            /** @enum {string} */
-            object: "location_titles_index";
-            sourceSlug: string;
-            canonicalSlug: string;
-            placeName: string;
-            titles: {
-                slug: string;
-                name: string;
-                avgSalaryMin: number;
-                avgSalaryMax: number;
-                jobCount: number;
-            }[];
-        };
-        MediaGet: components["schemas"]["MediaUpload"] & {
-            /** @description Time at which the file was uploaded. ISO 8601 datetime. */
-            uploadedAt: string;
-            /** @description Resources currently referencing this file. Currently always `[]` — the resolver is not yet implemented. */
-            referencedBy: {
-                /** @description Type of the resource referencing this file. */
-                resourceType: string;
-                /** @description Identifier of the resource referencing this file. */
-                resourceId: string;
-            }[];
-        };
-        MediaUpload: {
-            /** @description Unique identifier for the object. Use this value as the `{id}` path parameter for `GET /v1/media/{id}`. */
-            id: string;
-            /**
-             * @description String representing the object's type. Objects of the same type share the same value.
-             * @enum {string}
-             */
-            object: "media_upload";
-            /** @description URL where the file can be downloaded. Permanent for files served from the assets domain; a signed URL for legacy files. Always set on the upload response; may be `null` on retrieval if the underlying blob has been deleted. */
-            url: string | null;
-            /** @description Time at which the signed `url` expires (ISO 8601 datetime), or `null` when the `url` is permanent and never expires. */
-            urlExpiresAt: string | null;
-            /** @description MIME type of the uploaded file. */
-            mimeType: string;
-            /** @description Size of the uploaded file, in bytes. */
-            sizeBytes: number;
-            /**
-             * @description Resource type the file was uploaded for.
-             * @enum {string}
-             */
-            purpose: "board_logo" | "board_hero" | "account_avatar" | "company_logo" | "blog_image";
-        };
-        Message: {
-            id: string;
-            /** @enum {string} */
-            object: "message";
-            conversationId: string;
-            authorBoardUserId: string;
-            recipientBoardUserId: string;
-            body: string;
-            author: components["schemas"]["MessageAuthor"];
-            /** Format: date-time */
-            sentAt: string;
-            /** Format: date-time */
-            editedAt: string | null;
-            /** Format: date-time */
-            deletedAt: string | null;
-            /** Format: date-time */
-            readAt: string | null;
-        };
-        MessageAuthor: {
-            displayName: string;
-            avatarUrl: string | null;
-            companyName: string | null;
-        };
-        ModerationReport: {
-            /** @enum {string} */
-            object: "moderation_report";
-            id: string;
-            blocked: boolean;
-        };
-        MoveApplicantStageBody: {
-            /** @description The target stage id. */
-            stageId: string;
-        };
-        NotificationPreference: {
-            /** @enum {string} */
-            object: "notification_preference";
-            /** @enum {string} */
-            channel: "messageEmails" | "applicationEmails";
-            subscribed: boolean;
-            updatedAt: number | null;
-        };
-        /** @description Error envelope, populated once the operation reaches `failed`. `null` otherwise. */
-        OperationErrorEnvelope: {
-            /** @description Machine-readable error code. */
-            code: string;
-            /** @description Human-readable error message. */
-            message: string;
-            /** @description Additional structured details about the error, when present. */
-            details?: unknown;
-            /** @description Identifier of the request that produced the error. Use this to correlate with platform logs. */
-            requestId?: string;
-        } | null;
-        /** @description Snapshot of the operation's progress, or `null` if the operation does not report progress. */
-        OperationProgress: {
-            /** @description Progress as a percentage between 0 and 100, when the operation reports a percentage. */
-            percent?: number;
-            /** @description Human-readable progress message, when available. */
-            message?: string;
-            /** @description Number of items processed so far, when applicable. */
-            processed?: number;
-            /** @description Total number of items to process, when known. */
-            total?: number;
-        } | null;
-        OperationResource: {
-            /** @description Unique identifier for the object. */
-            id: string;
-            /**
-             * @description String representing the object's type. Objects of the same type share the same value.
-             * @enum {string}
-             */
-            object: "operation";
-            /** @description Operation kind, identifying which workflow the operation runs. */
-            kind: string;
-            /**
-             * @description Current state of the operation.
-             * @enum {string}
-             */
-            state: "pending" | "running" | "succeeded" | "failed" | "cancelled";
-            /** @description Identifier of the account the operation belongs to. */
-            accountId: string;
-            progress: components["schemas"]["OperationProgress"];
-            /** @description Operation result, populated once the operation reaches `succeeded`. Shape varies by `kind`. */
-            result?: unknown;
-            error: components["schemas"]["OperationErrorEnvelope"];
-            /** @description Time at which the operation was created. ISO 8601 datetime. */
-            createdAt: string;
-            /** @description Time at which the operation was last updated. ISO 8601 datetime. */
-            updatedAt: string;
-            /** @description Time at which the operation reached a terminal state, or `null` if it has not yet completed. ISO 8601 datetime. */
-            completedAt: string | null;
-            /** @description Whether cancellation of the operation has been requested. */
-            cancelRequested: boolean;
-            /** @description Type of resource the operation acts on, or `null` for resource-less operations. */
-            resourceType: string | null;
-            /** @description Identifier of the resource the operation acts on, or `null` for resource-less operations. */
-            resourceId: string | null;
-            /** @description Identifier of the parent operation when this operation is a child of a fan-out, or `null` otherwise. */
-            parentOperationId: string | null;
-        };
-        PatchSettingsBody: {
-            /** @description Display name of the board. */
-            name?: string;
-            /** @description URL slug of the board. Lowercase alphanumeric and hyphens; reserved values (e.g. `admin`, `api`) are rejected. */
-            slug?: string;
-            /** @description Identifier of the custom domain to use as the primary public URL. */
-            primaryDomainId?: string;
-            /** @description Media storage ID returned by `POST /v1/media/upload` with `purpose=board_logo`. */
-            logoStorageId?: string;
-            /** @description Media storage ID returned by `POST /v1/media/upload` with `purpose=board_hero`. */
-            heroStorageId?: string;
-            /** @description Whether the board sits behind a password gate. Use `POST /v1/settings/password-protection` to set the actual password before enabling. */
-            passwordProtectionEnabled?: boolean;
-            /** @description Whether candidates can subscribe to email alerts for new jobs. */
-            jobAlertsEnabled?: boolean;
-            /** @description Whether candidate profiles are enabled on the board. */
-            candidatesEnabled?: boolean;
-            /** @description Whether employer self-serve flows are enabled. */
-            employersEnabled?: boolean;
-            /** @description Whether the public blog is exposed. */
-            blogEnabled?: boolean;
-            /** @description Whether the legal Impressum page is exposed (required in some jurisdictions). */
-            impressumEnabled?: boolean;
-            /** @description Whether jobs posted by employers from the free tier require admin approval before they appear on the public board. */
-            requireApprovalFreeJobs?: boolean;
-            /** @description Whether aggregated jobs (e.g. those scraped or imported from upstream sources) require admin approval before they appear on the public board. */
-            requireApprovalAggregatedJobs?: boolean;
-            /** @description Whether visitors must sign in to view jobs. */
-            registrationWallEnabled?: boolean;
-            /** @description Whether the public talent directory is enabled. */
-            talentDirectoryEnabled?: boolean;
-            /** @description Whether the Cavuno-branded footer is displayed on the public board. Plan-gated; lower-tier plans cannot disable this. */
-            showCavunoBranding?: boolean;
-            /** @description Default expiry, in days, applied to newly published jobs when no `expiresAt` is supplied. */
-            defaultJobDurationDays?: number;
-            /** @description Public contact email shown on the board. Pass `null` to clear. */
-            contactEmail?: string | "" | unknown | unknown;
-            /** @description Legal name of the entity operating the board. Pass `null` to clear. */
-            companyLegalName?: string | "" | unknown | unknown;
-            /** @description Postal address of the entity operating the board. Pass `null` to clear. */
-            companyAddress?: string | "" | unknown | unknown;
-            /** @description Public company website URL. Pass `null` to clear. */
-            companyWebsiteUrl?: string | "" | unknown | unknown;
-            /** @description Company X (Twitter) handle or profile URL. Pass `null` to clear. */
-            companyXHandle?: string | "" | unknown | unknown;
-            /** @description Company Facebook page URL. Pass `null` to clear. */
-            companyFacebookUrl?: string | "" | unknown | unknown;
-            /** @description Company LinkedIn page URL. Pass `null` to clear. */
-            companyLinkedinUrl?: string | "" | unknown | unknown;
-            /** @description Label shown for the talent directory in the public navigation. 1–50 characters. */
-            talentNavLabel?: string;
-            /** @description Custom copy displayed on the password gate. Up to 500 characters. Pass `null` to clear. */
-            passwordProtectionMessage?: string | "" | unknown | unknown;
-            /** @description Free-form configuration object merged into the existing config. Reserved keys (e.g. `passwordProtectionEnabled`, `adsenseClientId`, `jobAccessPaywallEnabled`) cannot be set here — use the dedicated endpoints instead. */
-            config?: {
-                [key: string]: unknown;
-            };
-        };
-        PaywallOffer: {
-            /** @enum {string} */
-            object: "paywall_offer";
-            /** @description The tier key posted to checkout (e.g. `monthly`, `lifetime`). */
-            offerKey: string;
-            label: string;
-            billingLabel: string;
-            amountCents: number;
-            currency: string;
-            /**
-             * @description `recurring` tiers get a manage-subscription portal; `lifetime` do not.
-             * @enum {string}
-             */
-            offerType: "recurring" | "lifetime";
-            intervalUnit: string | null;
-            intervalCount: number | null;
-            isDefault: boolean;
-        };
-        Plan: {
-            /** @enum {string} */
-            object: "plan";
-            id: string;
-            name: string;
-            description: string | null;
-            /** @enum {string} */
-            purpose: "job_posting" | "talent_access";
-            /** @enum {string} */
-            kind: "free" | "subscription" | "one_time" | "bundle";
-            /** @enum {string|null} */
-            billingInterval: "month" | "year" | null;
-            isRecommended: boolean;
-            displayOrder: number;
-            invoiceOnly: boolean;
-            /** @enum {string|null} */
-            publishTiming: "on_issue" | "on_payment" | null;
-            netTermsDays: number | null;
-            price: {
-                currency: string;
-                amountCents: number;
-                /** @description The public Stripe Price id used to start checkout. */
-                stripePriceId: string | null;
-            } | null;
-            featureSummary: {
-                durationDays: number;
-                maxActiveJobs: number;
-                featuredSlots: number;
-                /** @enum {string} */
-                featureSelectionMode: "auto" | "manual";
-            };
-            /** @description Talent-access allowances (per billing period). Present only when `purpose` is `talent_access`. `"unlimited"` is a sentinel value. */
-            talent?: {
-                unlocksPerPeriod: string;
-                messagesPerPeriod: string;
-            };
-        };
-        PublicBlogAdjacentPosts: {
-            /** @enum {string} */
-            object: "blog_adjacent_posts";
-            previous: components["schemas"]["PublicBlogPostSummary"] | null;
-            next: components["schemas"]["PublicBlogPostSummary"] | null;
-        };
-        PublicBlogAuthor: components["schemas"]["PublicBlogAuthorEmbed"] & {
-            /** @enum {string} */
-            object: "public_blog_author";
-        };
-        PublicBlogAuthorEmbed: {
-            id: string;
-            name: string;
-            slug: string;
-            bio: string | null;
-            avatarUrl: string | null;
-            websiteUrl: string | null;
-            twitterUrl: string | null;
-            linkedinUrl: string | null;
-            githubUrl: string | null;
-        };
-        PublicBlogPost: components["schemas"]["PublicBlogPostSummary"] & {
-            html: string | null;
-            ogImageUrl: string | null;
-            featureImageCaption: string | null;
-            seoTitle: string | null;
-            seoDescription: string | null;
-            redirected: boolean;
-            newSlug: string | null;
-        };
-        PublicBlogPostSummary: {
-            id: string;
-            /** @enum {string} */
-            object: "public_blog_post";
-            title: string;
-            slug: string;
-            featured: boolean;
-            coverUrl: string | null;
-            featureImageAlt: string | null;
-            customExcerpt: string | null;
-            readingTimeMin: number | null;
-            publishedAt: string | null;
-            canonicalUrl: string | null;
-            createdAt: string;
-            authors: components["schemas"]["PublicBlogAuthorEmbed"][];
-            tags: components["schemas"]["PublicBlogTagEmbed"][];
-        };
-        PublicBlogSearchBody: {
-            /** @description Free-text search query. Up to 200 characters. */
-            query: string;
-            /** @description An opaque pagination cursor returned in the `nextCursor` field of a previous response. Pass it back to fetch the next page of results. */
-            cursor?: string | null;
-            /** @description A limit on the number of objects to be returned. Limit can range between 1 and 50. */
-            limit?: number;
-        };
-        PublicBlogTag: components["schemas"]["PublicBlogTagEmbed"] & {
-            /** @enum {string} */
-            object: "public_blog_tag";
-        };
-        PublicBlogTagEmbed: {
-            id: string;
-            name: string;
-            slug: string;
-            description: string | null;
-        };
-        PublicBoardContext: {
-            /** @enum {string} */
-            object: "public_board";
-            /** @description Immutable board identifier (`boards_…`). */
-            id: string;
-            /** @description Mutable canonical board slug. */
-            slug: string;
-            name: string;
-            /** @description Board language (ISO code); defaults to "en". */
-            language: string;
-            logoUrl: string | null;
-            /** @description Active custom-domain hostname, or null. */
-            primaryDomain: string | null;
-            /** @description Whitelabel toggle (default `true`). Render the "Powered by Cavuno" badge unless `false`. */
-            showCavunoBranding: boolean;
-            features: {
-                jobAlerts: boolean;
-                candidates: boolean;
-                employers: boolean;
-                blog: boolean;
-                talentDirectory: boolean;
-                registrationWall: boolean;
-                passwordProtected: boolean;
-                publicJobSubmission: boolean;
-                candidatePaywall: boolean;
-                impressum: boolean;
-            };
-            analytics: {
-                ga4MeasurementId: string | null;
-                gtmId: string | null;
-                metaPixelId: string | null;
-                linkedInPartnerId: string | null;
-                cookieConsentRequired: boolean;
-            };
-            theme: {
-                mode: string;
-                schemeId: string;
-                typography: {
-                    fontSans: string;
-                    fontHeading?: string | null;
-                };
-                colors: {
-                    light: {
-                        [key: string]: unknown;
-                    };
-                    dark: {
-                        [key: string]: unknown;
-                    };
-                };
-            } | null;
-            /** @description Operator-defined custom job-field definitions (CAV-294), in display order. Board-wide; the frontend uses these to render and localize each job's opaque `customFieldValues`. Empty when the board defines none. Display-only — not filterable or searchable in v1. */
-            customFields: components["schemas"]["CustomFieldDefinition"][];
-        };
-        PublicCompaniesSearchBody: {
-            /** @description Free-text search query matched against company name. Up to 200 characters. */
-            query?: string;
-            /** @description Scope the results to companies in a single market (sector), by the market slug. Resolves a board-language or English slug; an unknown slug returns 404. Use `GET /boards/:identifier/companies/markets/:market` to resolve a slug to its canonical form first. */
-            marketSlug?: string;
-            /** @description An opaque pagination cursor returned in the `nextCursor` field of a previous response. Pass it back to fetch the next page of results. */
-            cursor?: string | null;
-            /** @description A limit on the number of objects to be returned. Limit can range between 1 and 100. */
-            limit?: number;
-        };
-        /** @description Public-only links. The admin URL is intentionally omitted on public-board responses. */
-        PublicCompanyLinks: {
-            /**
-             * Format: uri
-             * @description Canonical public URL for this company on the board, or `null` when no slug is set.
-             */
-            public: string | null;
-        };
-        PublicJob: {
-            /** @description Unique identifier for the object. Use this value as the `{id}` path parameter for the job endpoints (e.g. `GET /v1/jobs/{id}`). */
-            id: string;
-            /**
-             * @description String representing the object's type. Objects of the same type share the same value.
-             * @enum {string}
-             */
-            object: "public_job";
-            /** @description The job title. */
-            title: string;
-            /** @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`.
-             * @enum {string}
-             */
-            status: "draft" | "published" | "expired" | "archived";
-            /** @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.
-             * @enum {string|null}
-             */
-            employmentType: "full_time" | "part_time" | "contract" | "internship" | "temporary" | "volunteer" | "other" | null;
-            /**
-             * @description Whether the role is on-site, hybrid, or fully remote, or `null` if not specified.
-             * @enum {string|null}
-             */
-            remoteOption: "on_site" | "hybrid" | "remote" | null;
-            /**
-             * @description Seniority level of the role, or `null` if not specified.
-             * @enum {string|null}
-             */
-            seniority: "entry_level" | "associate" | "mid_level" | "senior" | "lead" | "principal" | "director" | "executive" | null;
-            /** @description Minimum salary in `salaryCurrency` units, or `null` if not specified. */
-            salaryMin: number | null;
-            /** @description Maximum salary in `salaryCurrency` units, or `null` if not specified. */
-            salaryMax: number | null;
-            /** @description Three-letter ISO 4217 currency code for the salary range, or `null` if no salary is specified. */
-            salaryCurrency: string | null;
-            /**
-             * @description Period the salary range is quoted against, or `null` if no salary is specified.
-             * @enum {string|null}
-             */
-            salaryTimeframe: "per_year" | "per_month" | "per_week" | "per_day" | "per_hour" | null;
-            /** @description Whether the job appears in featured slots on the public board. */
-            isFeatured: boolean;
-            /** @description Time at which the job was first published, or `null` if not yet published. ISO 8601 datetime. */
-            publishedAt: string | null;
-            /** @description Time at which the job expires, or `null` if no expiry is set. ISO 8601 datetime. */
-            expiresAt: string | null;
-            /** @description Time at which the job was created. ISO 8601 datetime. */
-            createdAt: string;
-            /** @description Time at which the job was last updated. ISO 8601 datetime. */
-            updatedAt: string;
-            links: components["schemas"]["PublicJobLinks"];
-            /** @description Long-form description of the role, or `null` if not specified. */
-            description: string | null;
-            /** @description Where candidates apply, or `null` if not specified. An HTTPS URL or `mailto:` URI. */
-            applicationUrl: string | null;
-            /** @description Hierarchical permit selection authored by the board owner. The three `remoteWorkPermit*` and `remoteWorldwide` fields are read-only derived projections. */
-            remotePermits: {
-                type: string;
-                value: string;
-            }[];
-            /** @description Read-only — derived from `remotePermits`. `true` only when the authored selection is a single `{type:"worldwide"}` entry. */
-            remoteWorldwide: boolean | null;
-            /** @description Hierarchical timezone selection. The flat `remoteAllowedTzOffsets` field below is the read-only derived projection. */
-            remoteTimezones: {
-                type: string;
-                value: string;
-                plusMinus?: number;
-            }[];
-            /** @description Read-only — derived from `remoteTimezones`. UTC hour offsets used by the job-search index. */
-            remoteAllowedTzOffsets: number[];
-            /** @description Read-only — derived from `remotePermits` (hierarchical groups fan out to alpha2 sets; subdivisions auto-add the parent country). ISO 3166-1 alpha-2 codes. */
-            remoteWorkPermitCountryCodes: string[];
-            /** @description Read-only — derived from `remotePermits` (subdivision entries only). ISO 3166-2 codes. */
-            remoteWorkPermitSubdivisionCodes: string[];
-            /**
-             * @description Whether the employer sponsors visas for remote candidates. One of `yes`, `no`, or `unknown`.
-             * @enum {string}
-             */
-            remoteSponsorship: "yes" | "no" | "unknown";
-            /** @description Required education credentials. Each value is one of `high_school`, `associate_degree`, `bachelor_degree`, `professional_certificate`, `postgraduate_degree`, or `no_requirements`. */
-            educationRequirements: ("high_school" | "associate_degree" | "bachelor_degree" | "professional_certificate" | "postgraduate_degree" | "no_requirements")[];
-            /** @description Minimum required experience in months, or `null` if not specified. */
-            experienceMonths: number | null;
-            /** @description If `true`, equivalent experience may substitute for the listed education requirements. `null` if not specified. */
-            experienceInPlaceOfEducation: boolean | null;
-            /**
-             * @description Period denominator for `inOfficeFrequency`, or `null` if not specified.
-             * @enum {string|null}
-             */
-            inOfficePeriod: "per_week" | "per_month" | "per_year" | null;
-            /** @description How often the candidate must be in-office over `inOfficePeriod`, or `null` if not specified. */
-            inOfficeFrequency: number | null;
-            company: components["schemas"]["JobCompany"];
-            /** @description Physical office locations associated with the job. */
-            officeLocations: components["schemas"]["JobOfficeLocation"][];
-            /** @description Resolved job categories (slug + board display name) — same shape as the card; names joined server-side. */
-            categories: {
-                slug: string;
-                name: string;
-            }[];
-            /** @description Resolved job skills (slug + board display name). */
-            skills: {
-                slug: string;
-                name: string;
-            }[];
-            /** @description Place ancestor chain (country → region → city) for the breadcrumb; each `{slug,name}` links to `/jobs/locations/:slug`. Source-language. */
-            placeHierarchy: {
-                slug: string;
-                name: string;
-            }[];
-            /** @description Opaque, display-only custom-field values (CAV-294), keyed by each field's `key`. Values are the option `key`(s) for select fields, or the raw boolean/number/text otherwise — resolve labels via the board's `customFields` definitions (see `GET /v1/boards/:identifier`). `{}` when the board defines no custom fields. Not filterable or searchable in v1. */
-            customFieldValues: {
-                [key: string]: string | string[] | boolean | number;
-            };
-        };
-        PublicJobAlertConfirmation: {
-            /** @enum {string} */
-            object: "job_alert_confirmation";
-            /**
-             * @description Outcome of the confirmation. Always returned with HTTP 200 so the consumer renders by status (the token may be valid, stale, or unknown).
-             * @enum {string}
-             */
-            status: "confirmed" | "already_confirmed" | "expired" | "not_found";
-        };
-        PublicJobAlertManageResult: {
-            /** @enum {string} */
-            object: "job_alert_manage_result";
-            success: boolean;
-        };
-        PublicJobAlertManageState: {
-            /** @enum {string} */
-            object: "job_alert_manage_state";
-            email: string;
-            confirmed: boolean;
-            unsubscribed: boolean;
-            preferences: {
-                id: string;
-                label: string | null;
-                frequency: string;
-                isActive: boolean;
-                filters: {
-                    jobFunctions?: string[];
-                    seniorityLevels?: string[];
-                    remoteOptions?: string[];
-                    placeIds?: string[];
-                    salaryMin?: number | null;
-                    salaryMax?: number | null;
-                    salaryCurrency?: string | null;
-                };
-                manageToken: string;
-            }[];
-        };
-        PublicJobAlertResend: {
-            /** @enum {string} */
-            object: "job_alert_confirmation_resend";
-            /** @enum {string} */
-            status: "sent" | "not_found" | "already_confirmed" | "throttled" | "send_failed";
-        };
-        PublicJobAlertSubscription: {
-            /** @enum {string} */
-            object: "job_alert_subscription";
-            /**
-             * @description `created` on a new subscription; `duplicate` if it existed.
-             * @enum {string}
-             */
-            status: "created" | "duplicate";
-            /** @description True when a double-opt-in confirmation email was sent. */
-            requiresConfirmation: boolean;
-            /** @description True if the subscriber was already email-confirmed. */
-            confirmed: boolean;
-        };
-        PublicJobCard: {
-            id: string;
-            /** @enum {string} */
-            object: "job_card";
-            slug: string;
-            title: string;
-            /**
-             * Format: date-time
-             * @description ISO 8601 publish timestamp, or `null` if unpublished.
-             */
-            publishedAt: string | null;
-            /** @enum {string|null} */
-            employmentType: "full_time" | "part_time" | "contract" | "internship" | "temporary" | "volunteer" | "other" | 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. */
-            remoteLocationLabel: string | null;
-            salaryMin: number | null;
-            salaryMax: number | null;
-            salaryCurrency: string | null;
-            salaryTimeframe: string | null;
-            isFeatured: boolean;
-            locationLabel: string | null;
-            /** @description Embedded company summary, or `null` if none is attached. */
-            company: {
-                slug: string;
-                name: string;
-                logoUrl: string | null;
-            } | null;
-            categories: {
-                slug: string;
-                name: string;
-            }[];
-            skills: {
-                slug: string;
-                name: string;
-            }[];
-            links: {
-                /**
-                 * Format: uri
-                 * @description Canonical public URL for this job, or `null` when no stable URL can be assembled.
-                 */
-                public: string | null;
-            };
-            /** @description Long-form description (HTML), or `null`. Present ONLY when requested via `?fields=+description`; absent on the default slim card. */
-            description?: string | null;
-        };
-        /** @description Public-only links. The admin URL is intentionally omitted on public-board responses. */
-        PublicJobLinks: {
-            /**
-             * Format: uri
-             * @description Canonical public URL for this job, or `null` when the job has no slug or no associated company slug (so a stable URL cannot be assembled).
-             */
-            public: string | null;
-        };
-        PublicPlace: {
-            /** @enum {string} */
-            object: "place";
-            /** @description Stable place identity (locations-tree edge endpoint). */
-            id: string;
-            /** @description Parent place's `id`; `null` for a root place. */
-            parentId: string | null;
-            /** @description Public slug (links to `/jobs/locations/:slug`); `null` if unslugged. */
-            slug: string | null;
-            name: string;
-            placeType: string;
-            countryCode: string | null;
-            regionCode: string | null;
-            /** @description Live published-job count for this place. */
-            jobCount: number;
-        };
-        PublicSearchJobsBody: {
-            /** @description Free-text search query matched against job title and description. Up to 200 characters. */
-            query?: string;
-            /**
-             * @description Result ordering. `relevance` (default) ranks by search relevance with featured jobs first; `newest` orders by publish date and `salary_high` by salary (no-salary jobs last). Any explicit sort unpins featured jobs.
-             * @enum {string}
-             */
-            sort?: "relevance" | "newest" | "salary_high";
-            /** @description Optional faceted filters to narrow search results. Multi-value filters match jobs in any of the supplied values; range filters accept `gte` and `lte` bounds. */
-            filters?: {
-                /** @description Only return jobs at any of the given company IDs. Up to 10 values. */
-                companyId?: 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. */
-                employmentType?: ("full_time" | "part_time" | "contract" | "internship" | "temporary" | "volunteer" | "other")[];
-                /** @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 Range filter on the job's `publishedAt` timestamp. */
-                publishedAt?: {
-                    /**
-                     * Format: date-time
-                     * @description Only return jobs published at or after this ISO 8601 datetime.
-                     */
-                    gte?: string;
-                    /**
-                     * Format: date-time
-                     * @description Only return jobs published at or before this ISO 8601 datetime.
-                     */
-                    lte?: string;
-                };
-                /** @description Only return jobs near the place with this slug (geo radius search). Unresolvable slugs are ignored. */
-                location?: string;
-                /** @description Search radius in kilometres around `location` (10–250; default 50). Ignored without `location`. */
-                radius?: number;
-            };
-            /** @description An opaque pagination cursor returned in the `nextCursor` field of a previous response. Pass it back to fetch the next page of results. */
-            cursor?: string;
-            /**
-             * @description A limit on the number of objects to be returned. Limit can range between 1 and 100.
-             * @example 20
-             */
-            limit?: number;
-            /**
-             * @description The number of jobs to skip — the storefront page offset. Takes precedence over `cursor`. `offset + limit` may not exceed 10,000.
-             * @example 0
-             */
-            offset?: number;
-        };
-        PublicTaxonomyResolution: {
-            /** @enum {string} */
-            object: "taxonomy_resolution";
-            /** @enum {string} */
-            type: "category" | "skill" | "place" | "market";
-            /** @description Immutable English source slug — the semantic-search key. */
-            sourceSlug: string;
-            /** @description Board-language URL slug (the `<link rel=canonical>` target). */
-            canonicalSlug: string;
-            /** @description Board-language display name. */
-            displayName: string;
-            /** @description The canonical slug to emit a 308 redirect to when the inbound slug differs; `null` otherwise. */
-            redirectTo: string | null;
-            geo: components["schemas"]["TaxonomyGeo"];
-        };
-        PublicVerifyBoardPasswordBody: {
-            /** @description The board password. */
-            password: string;
-        };
-        PublishJobBody: {
-            /**
-             * Format: date-time
-             * @description New expiry as an ISO 8601 datetime. Pass `null` to clear the expiry. When omitted, the server preserves the existing expiry **if it is still in the future**; a stored expiry in the past (e.g. left over from a prior `expire` call) is cleared automatically so a republished job does not land in an immediately-invisible state.
-             */
-            expiresAt?: string | null;
-        };
-        ReadReceipt: {
-            /** @enum {string} */
-            object: "read_receipt";
-            /** Format: date-time */
-            markedAt: string;
-        };
-        RedirectResolution: {
-            /** @enum {string} */
-            object: "redirect_resolution";
-            path: string;
-            /** @description The redirect target (board-relative), or `null` when no redirect matches. The consumer 308s to `target`, or 404s when `null`. */
-            target: string | null;
-        };
-        RemotePermitTaxonomyEntry: {
-            /** @description Discriminator. One of: `worldwide`, `world_region`, `continent`, `region`, `subregion`, `custom`, `country`, `subdivision`. */
-            type: string;
-            /** @description Canonical value for the type. ISO 3166-1 alpha-2 for `country`, ISO 3166-2 for `subdivision`, etc. */
-            value: string;
-            /** @description Human-readable display label. */
-            label: string;
-        };
-        RemoteTimezoneTaxonomyEntry: {
-            /** @description Discriminator. One of: `all`, `world_region`, `continent`, `region`, `subregion`, `country`, `timezone`. */
-            type: string;
-            /** @description Canonical value for the type. ISO 3166-1 alpha-2 for `country`, IANA name (e.g. `Europe/London`) for `timezone`, etc. */
-            value: string;
-            /** @description Human-readable display label. */
-            label: string;
-        };
-        ReorderPipelineStagesBody: {
-            /** @description The job whose stages are reordered. */
-            jobId: string;
-            /** @description Every stage id of the job, in the new order. */
-            orderedStageIds: string[];
-        };
-        ReplyBody: {
-            body: string;
-        };
-        ReportBody: {
-            /** @enum {string} */
-            reason: "spam" | "harassment" | "misrepresentation" | "other";
-            freeText?: string;
-        };
-        ResourceLinks: {
-            /**
-             * Format: uri
-             * @description Canonical public URL for this resource on the board. Honours the configured custom domain when present, otherwise uses the board subdomain.
-             */
-            public: string;
-            /**
-             * Format: uri
-             * @description URL inside the Cavuno app where the authenticated owner can manage this resource.
-             */
-            admin: string;
-        };
-        Resume: {
-            /** @enum {string} */
-            object: "resume";
-            /**
-             * @description Async parse state; poll GET /me/resume until parsed or failed.
-             * @enum {string|null}
-             */
-            parseStatus: "parsing" | "parsed" | "failed" | null;
-            parseFailureReason: string | null;
-            /** Format: date-time */
-            parsedAt: string | null;
-            keepResumeOnFile: boolean | null;
-            hasResumeOnFile: boolean;
-            file: {
-                /** @description Short-lived signed download URL. */
-                url: string;
-                contentType: string;
-                sizeBytes: number;
-            } | null;
-        };
-        RevokeRequest: {
-            /** @description The access or refresh token to revoke. */
-            token: string;
-            /**
-             * @description Hint indicating whether `token` is an `access_token` or `refresh_token`. Optional.
-             * @enum {string}
-             */
-            token_type_hint?: "access_token" | "refresh_token";
-            /** @description OAuth client identifier. May be supplied here or via HTTP Basic authentication. */
-            client_id?: string;
-            /** @description OAuth client secret. May be supplied here or via HTTP Basic authentication. */
-            client_secret?: string;
-        };
-        SalaryCompanyIndexItem: {
-            /** @enum {string} */
-            object: "salary_company";
-            companySlug: string;
-            companyName: string;
-            logoPath: string | null;
-            avgSalaryMin: number;
-            avgSalaryMax: number;
-            jobCount: number;
-            currency: string;
-        };
-        SalaryLocationIndexItem: {
-            /** @enum {string} */
-            object: "salary_location";
-            placeSlug: string;
-            placeName: string;
-            /** @description Slug of the parent place; `null` for a top-level node. */
-            parentSlug: string | null;
-            avgSalaryMin: number;
-            avgSalaryMax: number;
-            jobCount: number;
-        };
-        SalarySkillIndexItem: {
-            /** @enum {string} */
-            object: "salary_skill";
-            slug: string;
-            name: string;
-            avgSalaryMin: number;
-            avgSalaryMax: number;
-            p25SalaryMin: number;
-            p75SalaryMax: number;
-            jobCount: number;
-            currency: string;
-        };
-        SalaryTitleIndexItem: {
-            /** @enum {string} */
-            object: "salary_title";
-            slug: string;
-            name: string;
-            avgSalaryMin: number;
-            avgSalaryMax: number;
-            p25SalaryMin: number;
-            p75SalaryMax: number;
-            jobCount: number;
-            currency: string;
-        };
-        SalesLedPlan: {
-            /** @enum {string} */
-            object: "sales_led_plan";
-            id: string;
-            name: string;
-            description: string;
-            /** @description Display price text, e.g. "Contact us". */
-            priceText: string;
-            ctaText: string;
-            /** @description The CTA target — a URL, mailto:, or tel: link. */
-            ctaDestination: string;
-            featuredBullets: string[];
-            displayOrder: number;
-        };
-        SaveJobBody: {
-            jobId: string;
-        };
-        SavedJob: {
-            /** @description Saved-job row ID. */
-            id: string;
-            /** @enum {string} */
-            object: "saved_job";
-            /** @description The saved job — also the DELETE path key. */
-            jobId: string;
-            /** Format: date-time */
-            savedAt: string;
-            job: components["schemas"]["PublicJob"];
-        };
-        SearchBlogPostsBody: {
-            query?: string;
-            /** @enum {string} */
-            status?: "draft" | "scheduled" | "published";
-            cursor?: string | null;
-            limit?: number;
-        };
-        SearchCompaniesBody: {
-            /** @description Free-text search query matched against company name. Up to 200 characters. */
-            query?: string;
-            /** @description An opaque pagination cursor returned in the `nextCursor` field of a previous response. Pass it back to fetch the next page of results. */
-            cursor?: string | null;
-            /**
-             * @description A limit on the number of objects to be returned. Limit can range between 1 and 100.
-             * @example 20
-             */
-            limit?: number;
-        };
-        SearchJobsBody: {
-            /** @description Free-text search query matched against job title and description. Up to 200 characters. */
-            query?: string;
-            /** @description Optional faceted filters to narrow search results. Multi-value filters match jobs in any of the supplied values; range filters accept `gte` and `lte` bounds. */
-            filters?: {
-                /** @description Only return jobs in any of the given statuses. Up to 10 values. */
-                status?: ("draft" | "published" | "expired" | "archived")[];
-                /** @description Only return jobs at any of the given company IDs. Up to 10 values. */
-                companyId?: 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. */
-                employmentType?: ("full_time" | "part_time" | "contract" | "internship" | "temporary" | "volunteer" | "other")[];
-                /** @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 Range filter on the job's `publishedAt` timestamp. */
-                publishedAt?: {
-                    /**
-                     * Format: date-time
-                     * @description Only return jobs published at or after this ISO 8601 datetime.
-                     */
-                    gte?: string;
-                    /**
-                     * Format: date-time
-                     * @description Only return jobs published at or before this ISO 8601 datetime.
-                     */
-                    lte?: string;
-                };
-            };
-            /** @description An opaque pagination cursor returned in the `nextCursor` field of a previous response. Pass it back to fetch the next page of results. */
-            cursor?: string;
-            /**
-             * @description A limit on the number of objects to be returned. Limit can range between 1 and 100.
-             * @example 20
-             */
-            limit?: number;
-        };
-        SendWorkEmailBody: {
-            /** Format: email */
-            workEmail: string;
-        };
-        SettingsAdsenseBody: {
-            /** @description Whether AdSense placements are rendered on the public board. */
-            adsenseEnabled?: boolean;
-            /** @description AdSense publisher ID in `ca-pub-XXXXXXXXXXXXXXXX` format. Pass an empty string or `null` to clear. */
-            adsenseClientId?: string | "" | unknown | unknown;
-            /** @description Map of placement key to slot configuration. Placement keys are lowercase alphanumeric with `-`, `_`, `.`, or `:`. */
-            adsenseSlots?: {
-                [key: string]: components["schemas"]["SettingsAdsenseSlot"];
-            };
-            /** @description Contents to serve from `/ads.txt`. Up to 2,000 characters. Pass an empty string or `null` to clear. */
-            adsTxt?: string | "" | unknown | unknown;
-        };
-        SettingsAdsenseSlot: {
-            /** @description Whether this placement is rendered. */
-            enabled: boolean;
-            /** @description Ten-digit AdSense slot ID. Pass an empty string or `null` to clear. */
-            slotId: string | "" | unknown | unknown;
-            /** @description AdSense layout type for the placement. */
-            layout?: ("auto" | "in-article" | "in-feed" | "fluid") | "" | unknown | unknown;
-            /** @description AdSense ad format. */
-            format?: ("auto" | "horizontal" | "vertical" | "rectangle" | "responsive") | "" | unknown | unknown;
-            /** @description Visual style override for the placement. */
-            style?: ("default" | "light" | "dark" | "contrast") | "" | unknown | unknown;
-            /** @description How often the placement is shown (e.g. once every N items). */
-            frequency?: number | unknown | unknown;
-        };
-        SettingsPasswordProtectionBody: {
-            /** @description Plaintext password used to gate the public board. Must be at least 8 characters. Stored hashed and encrypted server-side. */
-            password: string;
-        };
-        SettingsPaywallBody: {
-            /** @description Whether the job-access paywall is enforced on the public board. */
-            jobAccessPaywallEnabled: boolean;
-            /** @description Number of jobs visible before the paywall locks the rest. Range 1–500. */
-            jobAccessPreviewCount?: number;
-            /** @description Heading shown on the paywall. Up to 120 characters. */
-            jobAccessLockHeading?: string;
-            /** @description Body copy shown on the paywall. Up to 600 characters. */
-            jobAccessLockDescription?: string;
-            /** @description Call-to-action label shown on the paywall. Up to 60 characters. */
-            jobAccessButtonText?: string;
-            /** @description Fine-print disclaimer shown beneath the call-to-action. Up to 200 characters. */
-            jobAccessDisclaimerText?: string;
-            /** @description Label appended to the monthly price (e.g. `/month`). Up to 60 characters. */
-            jobAccessPerMonthLabel?: string;
-            /** @description Template string used to render the savings line for annual plans. Up to 120 characters. */
-            jobAccessSavingsTemplate?: string;
-            /** @description Three-letter ISO 4217 currency code for paywall pricing. */
-            jobAccessCurrency?: string;
-            /** @description Stripe product ID associated with the paywall plan. Pass `null` to clear. */
-            jobAccessStripeProductId?: string | unknown | unknown;
-            /** @description Stripe billing-portal configuration ID used for self-serve plan management. Pass `null` to clear. */
-            jobAccessStripePortalConfigId?: string | unknown | unknown;
-        };
-        SkillLocationSalary: {
-            /** @enum {string} */
-            object: "skill_location_salary";
-            skillSourceSlug: string;
-            skillCanonicalSlug: string;
-            locationSourceSlug: string;
-            locationCanonicalSlug: string;
-            skillName: string;
-            placeName: string;
-            countryCode: string;
-            adminLevel: string;
-            overallSalary: {
-                avgMin: number;
-                avgMax: number;
-                p25Min: number | null;
-                p75Max: number | null;
-                jobCount: number;
-            } | null;
-            bySeniority: {
-                seniority: string;
-                avgSalaryMin: number;
-                avgSalaryMax: number;
-                jobCount: number;
-            }[];
-            childLocations: {
-                placeSlug: string;
-                placeName: string;
-                avgSalaryMin: number;
-                avgSalaryMax: number;
-                jobCount: number;
-            }[];
-            childLocationsByRegion: {
-                regionName: string;
-                regionSlug: string;
-                cities: {
-                    placeSlug: string;
-                    placeName: string;
-                    avgSalaryMin: number;
-                    avgSalaryMax: number;
-                    jobCount: number;
-                }[];
-            }[];
-            otherLocations: {
-                placeSlug: string;
-                placeName: string;
-                avgSalaryMin: number;
-                avgSalaryMax: number;
-                jobCount: number;
-            }[];
-            topSkills: {
-                avgSalaryMin: number;
-                avgSalaryMax: number;
-                jobCount: number;
-                skillSlug: string;
-                skillName: string;
-            }[];
-            topTitles: {
-                avgSalaryMin: number;
-                avgSalaryMax: number;
-                jobCount: number;
-                categorySlug: string;
-                categoryName: string;
-            }[];
-            boardSkillAvgMin: number | null;
-            boardSkillAvgMax: number | null;
-            currency: string;
-        };
-        SkillLocationsIndex: {
-            /** @enum {string} */
-            object: "skill_locations_index";
-            sourceSlug: string;
-            canonicalSlug: string;
-            skillName: string;
-            currency: string;
-            locations: components["schemas"]["SalaryLocationIndexItem"][];
-        };
-        SkillSalaryDetail: {
-            /** @enum {string} */
-            object: "skill_salary_detail";
-            /** @description Immutable English source slug — the salary-stats key. */
-            sourceSlug: string;
-            /** @description Board-language canonical URL slug — the starter 308 target. */
-            canonicalSlug: string;
-            skillName: string;
-            overallSalary: {
-                avgMin: number;
-                avgMax: number;
-                medianMin: number;
-                medianMax: number;
-                p25Min: number;
-                p75Max: number;
-                jobCount: number;
-            } | null;
-            bySeniority: {
-                seniority: string;
-                avgSalaryMin: number;
-                avgSalaryMax: number;
-                jobCount: number;
-                boardAvgMin: number | null;
-                boardAvgMax: number | null;
-                diffPercent: number | null;
-            }[];
-            topCompanies: {
-                avgSalaryMin: number;
-                avgSalaryMax: number;
-                jobCount: number;
-                companySlug: string;
-                companyName: string;
-                logoPath: string | null;
-            }[];
-            topLocations: {
-                avgSalaryMin: number;
-                avgSalaryMax: number;
-                jobCount: number;
-                placeName: string;
-                placeSlug: string;
-                countryCode: string;
-            }[];
-            topTitles: {
-                avgSalaryMin: number;
-                avgSalaryMax: number;
-                jobCount: number;
-                categorySlug: string;
-                categoryName: string;
-            }[];
-            relatedSkills: {
-                avgSalaryMin: number;
-                avgSalaryMax: number;
-                jobCount: number;
-                skillSlug: string;
-                skillName: string;
-            }[];
-            totalLocationCount: number;
-            boardOverallAvgMin: number | null;
-            boardOverallAvgMax: number | null;
-            boardMedianMin: number | null;
-            boardMedianMax: number | null;
-            currency: string;
-        };
-        StartAboutApplicationBody: {
-            applicationId: string;
-            body: string;
-        };
-        StartConversationBody: {
-            candidateBoardUserId: string;
-            body: string;
-        };
-        TalentDirectoryEntry: {
-            /** @enum {string} */
-            object: "talent_directory_entry";
-            handle: string | null;
-            displayName: string | null;
-            headline: string | null;
-            location: string | null;
-            avatarUrl: string | null;
-            bio: string | null;
-            jobSearchStatus: string | null;
-            skills: string[];
-            experiences: {
-                title: string;
-                companyName: string;
-                startDate: string;
-                endDate: string | null;
-            }[];
-            education: {
-                institutionName: string;
-                startDate: string | null;
-                endDate: string | null;
-            }[];
-        };
-        TalentProfile: {
-            /** @enum {string} */
-            object: "talent_profile";
-            handle: string | null;
-            displayName: string | null;
-            headline: string | null;
-            location: string | null;
-            bio: string | null;
-            avatarUrl: string | null;
-            /** @description The candidate job-search status, or `null` when it is set to employers-only (an anonymous caller is not an employer). */
-            jobSearchStatus: string | null;
-            experiences: {
-                title: string;
-                companyName: string;
-                companyUrl: string | null;
-                location: string | null;
-                employmentType: string | null;
-                locationType: string | null;
-                foundVia: string | null;
-                /** @description Start month, `YYYY-MM`. */
-                startDate: string;
-                /** @description End month `YYYY-MM`, or `null` for a current role. */
-                endDate: string | null;
-                description: string | null;
-                /** @description Skills the candidate applied in this role. */
-                experienceSkills: string[];
-            }[];
-            education: {
-                institutionName: string;
-                institutionUrl: string | null;
-                degree: string | null;
-                fieldOfStudy: string | null;
-                grade: string | null;
-                activitiesAndSocieties: string | null;
-                startDate: string | null;
-                endDate: string | null;
-                description: string | null;
-            }[];
-            skills: {
-                name: string;
-                /** @description Reference to the canonical skill taxonomy, when matched. */
-                jobSkillId: string | null;
-            }[];
-            languages: {
-                name: string;
-                proficiency: string;
-            }[];
-        };
-        /** @description Geo for place resolutions; `null` for category/skill. */
-        TaxonomyGeo: {
-            lat: number | null;
-            lng: number | null;
-            countryCode: string | null;
-            regionCode: string | null;
-            region: string | null;
-            city: string | null;
-            locality: string | null;
-            placeType: string | null;
-        } | null;
-        TitleLocationSalary: {
-            /** @enum {string} */
-            object: "title_location_salary";
-            categorySourceSlug: string;
-            categoryCanonicalSlug: string;
-            locationSourceSlug: string;
-            locationCanonicalSlug: string;
-            categoryName: string;
-            placeName: string;
-            countryCode: string;
-            adminLevel: string;
-            overallSalary: {
-                avgMin: number;
-                avgMax: number;
-                p25Min: number | null;
-                p75Max: number | null;
-                jobCount: number;
-            } | null;
-            bySeniority: {
-                seniority: string;
-                avgSalaryMin: number;
-                avgSalaryMax: number;
-                jobCount: number;
-            }[];
-            childLocations: {
-                placeSlug: string;
-                placeName: string;
-                avgSalaryMin: number;
-                avgSalaryMax: number;
-                jobCount: number;
-            }[];
-            childLocationsByRegion: {
-                regionName: string;
-                regionSlug: string;
-                cities: {
-                    placeSlug: string;
-                    placeName: string;
-                    avgSalaryMin: number;
-                    avgSalaryMax: number;
-                    jobCount: number;
-                }[];
-            }[];
-            otherLocations: {
-                placeSlug: string;
-                placeName: string;
-                avgSalaryMin: number;
-                avgSalaryMax: number;
-                jobCount: number;
-            }[];
-            topSkills: {
-                avgSalaryMin: number;
-                avgSalaryMax: number;
-                jobCount: number;
-                skillSlug: string;
-                skillName: string;
-            }[];
-            topTitles: {
-                avgSalaryMin: number;
-                avgSalaryMax: number;
-                jobCount: number;
-                categorySlug: string;
-                categoryName: string;
-            }[];
-            boardCategoryAvgMin: number | null;
-            boardCategoryAvgMax: number | null;
-            currency: string;
-        };
-        TitleLocationsIndex: {
-            /** @enum {string} */
-            object: "title_locations_index";
-            sourceSlug: string;
-            canonicalSlug: string;
-            categoryName: string;
-            currency: string;
-            locations: components["schemas"]["SalaryLocationIndexItem"][];
-        };
-        TitleSalaryDetail: {
-            /** @enum {string} */
-            object: "title_salary_detail";
-            /** @description Immutable English source slug — the salary-stats key. */
-            sourceSlug: string;
-            /** @description Board-language canonical URL slug — the starter 308 target. */
-            canonicalSlug: string;
-            categoryName: string;
-            overallSalary: {
-                avgMin: number;
-                avgMax: number;
-                p25Min: number;
-                p75Max: number;
-                jobCount: number;
-            } | null;
-            bySeniority: {
-                seniority: string;
-                avgSalaryMin: number;
-                avgSalaryMax: number;
-                jobCount: number;
-                boardAvgMin: number | null;
-                boardAvgMax: number | null;
-                boardMedianMin: number | null;
-                boardMedianMax: number | null;
-                boardP25Min: number | null;
-                boardP75Min: number | null;
-                boardP25Max: number | null;
-                boardP75Max: number | null;
-                diffPercent: number | null;
-            }[];
-            topCompanies: {
-                avgSalaryMin: number;
-                avgSalaryMax: number;
-                jobCount: number;
-                companySlug: string;
-                companyName: string;
-                logoPath: string | null;
-            }[];
-            topLocations: {
-                avgSalaryMin: number;
-                avgSalaryMax: number;
-                jobCount: number;
-                placeName: string;
-                placeSlug: string;
-                countryCode: string;
-            }[];
-            topSkills: {
-                avgSalaryMin: number;
-                avgSalaryMax: number;
-                jobCount: number;
-                skillSlug: string;
-                skillName: string;
-            }[];
-            relatedTitles: {
-                avgSalaryMin: number;
-                avgSalaryMax: number;
-                jobCount: number;
-                categorySlug: string;
-                categoryName: string;
-            }[];
-            totalLocationCount: number;
-            boardOverallAvgMin: number | null;
-            boardOverallAvgMax: number | null;
-            boardMedianMin: number | null;
-            boardMedianMax: number | null;
-            boardP25Min: number | null;
-            boardP75Max: number | null;
-            currency: string;
-        };
-        TokenRequest: {
-            /**
-             * @description OAuth grant type. Either `authorization_code` to exchange an authorization code for a new token pair, or `refresh_token` to exchange a refresh token for a new token pair.
-             * @enum {string}
-             */
-            grant_type: "authorization_code" | "refresh_token";
-            /** @description Authorization code returned from the authorization endpoint. Required when `grant_type` is `authorization_code`. */
-            code?: string;
-            /** @description Redirect URI used in the original authorization request. Must match exactly. Required when `grant_type` is `authorization_code`. */
-            redirect_uri?: string;
-            /** @description PKCE code verifier whose `S256` hash matches the original `code_challenge`. Required when `grant_type` is `authorization_code`. */
-            code_verifier?: string;
-            /** @description Refresh token previously issued. Required when `grant_type` is `refresh_token`. Refresh tokens are single-use; reusing one revokes the entire token chain. */
-            refresh_token?: string;
-            /** @description OAuth client identifier. May be supplied here or via HTTP Basic authentication. */
-            client_id?: string;
-            /** @description OAuth client secret. May be supplied here or via HTTP Basic authentication. */
-            client_secret?: string;
-            /** @description Optional scope narrowing. Currently ignored — issued tokens always carry the full scope registered for the client. */
-            scope?: string;
-        };
-        TokenResponse: {
-            /** @description Newly issued access token. Use as a `Bearer` token in the `Authorization` header. */
-            access_token: string;
-            /**
-             * @description Always `Bearer`.
-             * @enum {string}
-             */
-            token_type: "Bearer";
-            /** @description Lifetime of the access token, in seconds. */
-            expires_in: number;
-            /** @description Newly issued refresh token. Single-use; reusing it revokes the entire token chain. */
-            refresh_token: string;
-            /** @description Space-separated list of scopes granted on the issued token. */
-            scope: string;
-        };
-        UnreadCount: {
-            /** @enum {string} */
-            object: "unread_count";
-            count: number;
-        };
-        UnsubscribeBody: {
-            boardUserId: string;
-            /** @enum {string} */
-            channel: "messageEmails" | "applicationEmails";
-            token: string;
-        };
-        UpdateApplicationFactsBody: {
-            candidateName?: string;
-            /** Format: email */
-            candidateEmail?: string;
-            candidateHeadline?: string;
-            candidateLocation?: string;
-            coverNote?: string;
-        };
-        UpdateAuthorBody: {
-            /** @description URL-friendly slug for the author. Auto-generated from `name` when omitted. */
-            slug?: string;
-            /** @description Short biography for the author. Sanitized HTML. */
-            bio?: string;
-            /**
-             * Format: email
-             * @description The author's email address.
-             */
-            email?: string;
-            /**
-             * @description Author visibility status. One of `active` or `inactive`.
-             * @enum {string}
-             */
-            status?: "active" | "inactive";
-            /** @description Storage ID of an uploaded avatar image (from `POST /v1/media/upload`). Pass `null` to clear an existing avatar. */
-            avatarStorageId?: string | null;
-            /** @description The author's personal website URL. Normalized to a canonical URL when stored. */
-            websiteUrl?: string;
-            /** @description The author's X (Twitter) profile URL. Stored as the canonical `https://x.com/<handle>` URL. */
-            twitterUrl?: string;
-            /** @description The author's LinkedIn profile URL. */
-            linkedinUrl?: string;
-            /** @description The author's GitHub profile URL. */
-            githubUrl?: string;
-            /** @description SEO meta title for the author page. */
-            metaTitle?: string;
-            /** @description SEO meta description for the author page. */
-            metaDescription?: string;
-            /** @description The author's display name. */
-            name?: string;
-        };
-        UpdateBlogPostBody: {
-            slug?: string;
-            html?: string;
-            customExcerpt?: string;
-            readingTimeMin?: number;
-            featured?: boolean;
-            authorIds?: string[];
-            tagIds?: string[];
-            coverStorageId?: string | null;
-            ogImageStorageId?: string | null;
-            featureImageAlt?: string;
-            featureImageCaption?: string;
-            seoTitle?: string;
-            seoDescription?: string;
-            /** Format: uri */
-            canonicalUrl?: string;
-            /** Format: date-time */
-            publishedAt?: string;
-            title?: string;
-            /** @enum {string} */
-            status?: "draft" | "scheduled" | "published";
-        };
-        UpdateCandidateProfileBody: {
-            displayName?: string;
-            bio?: string;
-            handle?: string;
-            headline?: string;
-            location?: string;
-            /** @enum {string} */
-            profileVisibility?: "hidden" | "logged_in_only" | "public";
-            /** @enum {string} */
-            jobSearchStatus?: "actively_looking" | "open_to_offers" | "not_looking";
-            /** @enum {string} */
-            jobSearchStatusVisibleTo?: "everyone" | "employers_only";
-            openToRelocate?: boolean;
-        };
-        UpdateCompanyBody: {
-            /** @description Public company website URL. Normalized to a canonical apex domain when stored. */
-            website?: string;
-            /** @description One-line summary of the company. Up to 280 characters. */
-            summary?: string;
-            /** @description Long-form description of the company. Up to 25,000 characters. */
-            description?: string;
-            /** @description X (Twitter) profile URL or handle. Stored as the canonical handle. */
-            xUrl?: string;
-            /** @description LinkedIn company page URL. */
-            linkedinUrl?: string;
-            /** @description Facebook company page URL. */
-            facebookUrl?: string;
-            /** @description The company's display name. */
-            name?: string;
-            /** @description URL-friendly slug for the company. */
-            slug?: string;
-        };
-        UpdateEducationBody: {
-            institutionName?: string;
-            institutionUrl?: string;
-            degree?: string;
-            fieldOfStudy?: string;
-            grade?: string;
-            activitiesAndSocieties?: string;
-            startDate?: string;
-            endDate?: string;
-            description?: string;
-            sortOrder?: number;
-        };
-        UpdateEmployerCompanyBody: {
-            name?: string;
-            description?: string;
-            website?: string;
-            summary?: string;
-            xUrl?: string;
-            linkedinUrl?: string;
-            facebookUrl?: string;
-        };
-        UpdateExperienceBody: {
-            title?: string;
-            companyName?: string;
-            startDate?: string;
-            companyUrl?: string;
-            location?: string;
-            employmentType?: string;
-            locationType?: string;
-            foundVia?: string;
-            endDate?: string;
-            description?: string;
-            sortOrder?: number;
-        };
-        UpdateJobBody: {
-            /** @description Identifier of the company the job belongs to. */
-            companyId?: string;
-            /** @description Long-form description of the role. Up to 25,000 characters. */
-            description?: string;
-            /** @description URL-friendly slug for the job. Auto-generated from `title` when omitted. */
-            slug?: string;
-            /**
-             * @description Employment type of the role.
-             * @enum {string}
-             */
-            employmentType?: "full_time" | "part_time" | "contract" | "internship" | "temporary" | "volunteer" | "other";
-            /**
-             * @description Whether the role is on-site, hybrid, or fully remote.
-             * @enum {string}
-             */
-            remoteOption?: "on_site" | "hybrid" | "remote";
-            /** @description Where remote candidates must hold work authorization. Each entry is the smallest relevant scope: `worldwide`, a `world_region` (EMEA / LATAM / NA / APAC), a `continent`, a `region`, a `subregion`, a `custom` group (e.g. `EU`), a `country` (ISO 3166-1 alpha-2), or a `subdivision` (ISO 3166-2). Subdivisions auto-imply their parent country in the derived `remoteWorkPermitCountryCodes` output. Worldwide is mutually exclusive with all other entries. The canonical `{type, value}` set is published at `GET /v1/taxonomies/remote-permits`. Pass `[]` to clear an existing constraint. */
-            remotePermits?: {
-                /** @enum {string} */
-                type: "worldwide" | "world_region" | "continent" | "region" | "subregion" | "subdivision" | "country" | "custom";
-                value: string;
-            }[];
-            /** @description Where remote candidates must be timezone-compatible. Each entry mirrors the `remotePermits` shape (`world_region`, `continent`, `region`, `subregion`, `country`) plus `timezone` (specific IANA name with optional `plusMinus` ±N hours expansion) and `all` (every timezone — equivalent of `worldwide` for permits). The canonical `{type, value}` set is published at `GET /v1/taxonomies/remote-timezones`. **When omitted on POST**, the server auto-derives this from `remotePermits` (or `[{all,all}]` if neither was provided). **PATCH never auto-re-derives** — once set, only an explicit replacement updates the stored value, even when `remotePermits` changes. Pass `[]` to clear an existing constraint. */
-            remoteTimezones?: {
-                /** @enum {string} */
-                type: "all" | "world_region" | "continent" | "region" | "subregion" | "country" | "timezone";
-                value: string;
-                plusMinus?: number;
-            }[];
-            /**
-             * @description Whether the employer sponsors visas for remote candidates. One of `yes`, `no`, or `unknown`.
-             * @enum {string}
-             */
-            remoteSponsorship?: "yes" | "no" | "unknown";
-            /**
-             * @description Seniority level of the role.
-             * @enum {string}
-             */
-            seniority?: "entry_level" | "associate" | "mid_level" | "senior" | "lead" | "principal" | "director" | "executive";
-            /** @description Where candidates apply. Accepts an HTTPS URL, a `mailto:` URI, or a bare email address (which is normalized to `mailto:` form). */
-            applicationUrl?: string;
-            /** @description Minimum salary, in `salaryCurrency` units. */
-            salaryMin?: number;
-            /** @description Maximum salary, in `salaryCurrency` units. */
-            salaryMax?: number;
-            /** @description Three-letter ISO 4217 currency code for `salaryMin` and `salaryMax`. */
-            salaryCurrency?: string;
-            /**
-             * @description Period the `salaryMin` and `salaryMax` figures are quoted against.
-             * @enum {string}
-             */
-            salaryTimeframe?: "per_year" | "per_month" | "per_week" | "per_day" | "per_hour";
-            /** @description Whether the job appears in featured slots on the public board. */
-            isFeatured?: boolean;
-            /** @description Job expiry as a Unix epoch in milliseconds. On create, omitted or `null` defaults to 30 days from creation. On PATCH, pass `null` to clear an existing expiry. Past timestamps remove the job from the public board. */
-            expiresAt?: number | unknown | unknown;
-            /** @description Time at which the job was first published, as a Unix epoch in milliseconds. When omitted on create with `status: "published"`, the server stamps the current time. Useful for bulk-importing historical jobs while preserving original publication dates. PATCH may overwrite an existing value but cannot clear it. */
-            publishedAt?: number;
-            /** @description Required education credentials. Each value is one of `high_school`, `associate_degree`, `bachelor_degree`, `professional_certificate`, `postgraduate_degree`, or `no_requirements`. */
-            educationRequirements?: ("high_school" | "associate_degree" | "bachelor_degree" | "professional_certificate" | "postgraduate_degree" | "no_requirements")[];
-            /** @description Minimum required experience, expressed in months. */
-            experienceMonths?: number;
-            /** @description If `true`, equivalent experience may substitute for the listed education requirements. */
-            experienceInPlaceOfEducation?: boolean;
-            /**
-             * @description Period denominator for `inOfficeFrequency`.
-             * @enum {string}
-             */
-            inOfficePeriod?: "per_week" | "per_month" | "per_year";
-            /** @description How often the candidate must be in-office over `inOfficePeriod`. */
-            inOfficeFrequency?: number;
-            /** @description Physical office locations associated with the job. Each entry is forward-geocoded server-side; a country mismatch returns `400 jobs_unresolvable_location`. */
-            officeLocations?: components["schemas"]["JobOfficeLocationInput"][];
-            /** @description An external identifier for the job from your own system, such as an ATS requisition ID. Use this value to look up the job later via `GET /v1/jobs?externalId=...` for deduplication. Scoped per-account: two different accounts may reuse the same `externalId` without collision. Up to 255 characters. */
-            externalId?: string;
-            /** @description Board-defined custom-field values, keyed by the field `key` (definitions, including type and option keys, are published at `GET /v1/settings/job-form`). Writes are **additive**: on `PATCH` a key you send is set/overwritten and a key you omit is preserved (unsent keys are never cleared); on `POST` this initializes the bag. Send a key with an intentional-empty value — `null`, `""`, or `[]` — to **clear** it (`""`/`null` clear any type; `[]` clears a `multi_select`); `false` and `0` are kept as real values. Values must match the field type and `single_select`/`multi_select` must use defined option **keys** (not labels); a wrong-typed value is rejected (`custom_field_wrong_type`), never silently cleared. Unknown keys are ignored. The stored bag never contains `null`/empty values. */
-            customFieldValues?: {
-                [key: string]: string | string[] | boolean | number | unknown | unknown;
-            };
-            /** @description The job title. */
-            title?: string;
-        };
-        UpdateLanguagesBody: {
-            languages: {
-                name: string;
-                proficiency: string;
-            }[];
-        };
-        UpdateNotificationPreferenceBody: {
-            /** @enum {string} */
-            channel: "messageEmails" | "applicationEmails";
-            subscribed: boolean;
-        };
-        UpdatePipelineStageBody: {
-            label?: string;
-            hidden?: boolean;
-        };
-        UpdateSkillsBody: {
-            skills: string[];
-        };
-        UpdateTagBody: {
-            /** @description URL-friendly slug for the tag. Auto-generated from `name` when omitted. */
-            slug?: string;
-            /** @description Description for the tag. Sanitized HTML. */
-            description?: string;
-            /**
-             * @description Tag visibility. One of `public` or `internal`.
-             * @enum {string}
-             */
-            visibility?: "public" | "internal";
-            /** @description SEO meta title for the tag page. */
-            metaTitle?: string;
-            /** @description SEO meta description for the tag page. */
-            metaDescription?: string;
-            /** @description The display name of the tag. */
-            name?: string;
-        };
-        Usage: {
-            /** @description Unique identifier for the object. Equal to the account ID — usage is a per-account singleton. */
-            id: string;
-            /**
-             * @description String representing the object's type. Objects of the same type share the same value.
-             * @enum {string}
-             */
-            object: "usage";
-            /** @description Number of jobs currently in `published` status. */
-            activeJobs: number;
-            /** @description Plan-enforced cap on the number of published jobs. */
-            activeJobsLimit: number;
-            /** @description Number of additional jobs the account may publish before hitting the limit. */
-            available: number;
-            /** @description Slug of the account's current plan. */
-            plan: string;
-        };
-        VerifyEmailOtpBody: {
-            code: string;
-        };
-    };
-    responses: never;
-    parameters: never;
-    requestBodies: never;
-    headers: never;
-    pathItems: never;
-}
+import { S as Schemas, R as RemoteOption, E as EmploymentType, a as Seniority, L as ListEnvelope, b as RelatedSearch, c as components, J as JobsListQuery, d as JobCardListEnvelope, e as JobsSearchBody, f as JobCardSearchEnvelope, g as JobsSimilarQuery, h as SearchEnvelope } from './jobs-CM67_J6H.mjs';
+export { C as CustomFieldValue, i as CustomFieldValues, j as EducationRequirement, k as JobCompany, l as JobSort, O as OfficeLocation, P as PublicJob, m as PublicJobCard, n as RemotePermit, o as RemoteTimezone, p as StorefrontPagination } from './jobs-CM67_J6H.mjs';
 
 type Awaitable<T> = T | Promise<T>;
 /**
@@ -3796,6 +67,23 @@ declare class BoardClient {
     fetch<T>(path: string, init?: FetchOptions): Promise<T>;
 }
 
+/**
+ * Well-known `<domain>_<snake_reason>` codes the Board API sends, grouped by
+ * surface — the catalog for i18n lookup tables and error tracking. Drift-gated
+ * against the v1 API source (`error-codes.test.ts`).
+ *
+ * Deliberately NOT exhaustive-by-type: new codes MAY ship within v1
+ * (additive, per `01-conventions.md` §11.3), so `BoardApiErrorCode` keeps
+ * plain strings assignable while still autocompleting the known set.
+ * `unknown_error` is SDK-synthesized when a response carries no parseable
+ * envelope.
+ */
+declare const BOARD_API_ERROR_CODES: readonly ["internal_error", "validation_bad_request", "validation_payload_too_large", "rate_limited", "rate_limit_unavailable", "search_unavailable", "too_many_filter_values", "pagination_invalid_cursor", "pagination_offset_too_large", "auth_unauthenticated", "auth_forbidden", "plan_upgrade_required", "unknown_error", "boards_not_found", "board_page_not_found", "board_auth_email_taken", "board_auth_invalid_credentials", "board_auth_invalid_token", "board_auth_registration_disabled", "board_auth_token_expired", "board_password_required", "board_password_invalid", "jobs_not_found", "jobs_invalid_filter", "categories_not_found", "skills_not_found", "places_not_found", "companies_not_found", "company_markets_not_found", "company_salary_not_found", "company_category_salary_not_found", "salaries_title_not_found", "salaries_skill_not_found", "salaries_location_not_found", "salaries_title_location_not_found", "salaries_skill_location_not_found", "blog_post_not_found", "blog_author_not_found", "blog_tag_not_found", "talent_not_found", "talent_directory_not_found", "talent_directory_restricted", "job_alert_not_found", "job_alerts_disabled", "candidate_alert_limit_reached", "candidate_alert_not_found", "candidate_entry_not_found", "candidate_handle_taken", "candidate_job_not_found", "resume_invalid_file", "resume_upload_forbidden", "applications_external_apply_only", "applications_guest_not_allowed", "applications_job_not_found", "applications_not_found", "applications_resume_invalid_file", "applications_unprocessable", "messaging_application_not_found", "messaging_application_not_linked", "messaging_blocked", "messaging_cannot_block_self", "messaging_cold_rule", "messaging_conversation_not_found", "messaging_disabled", "messaging_edit_window_expired", "messaging_message_deleted", "messaging_message_not_found", "messaging_not_author", "messaging_not_participant", "messaging_not_permitted", "messaging_not_recipient", "messaging_rate_limited", "messaging_recipient_not_found", "messaging_recipient_not_open", "messaging_unsend_window_expired", "employer_applicant_not_found", "employer_ats_unprocessable", "employer_checkout_failed", "employer_company_exists", "employer_company_name_taken", "employer_company_not_found", "employer_job_not_found", "employer_job_slug_taken", "employer_jobs_quota_exceeded", "employer_not_member", "employer_payment_required", "employer_pipeline_stage_not_found", "paywall_already_active", "paywall_disabled", "paywall_invalid_checkout_session", "paywall_no_candidate_profile", "paywall_no_recurring_subscription", "paywall_offer_not_found", "job_posting_logo_lookup_unavailable", "job_posting_logo_not_found", "job_posting_rejected"];
+/**
+ * The known code set plus open string — new codes ship additively within v1,
+ * so exhaustive narrowing is intentionally impossible.
+ */
+type BoardApiErrorCode = (typeof BOARD_API_ERROR_CODES)[number] | (string & {});
 /**
  * Error raised for every non-2xx Board API response.
  *
@@ -3814,7 +102,7 @@ declare class BoardClient {
 declare class BoardApiError extends Error {
     readonly status: number;
     /** `<domain>_<snake_reason>` code from the v1 error envelope. */
-    readonly code: string;
+    readonly code: BoardApiErrorCode;
     /** Structured, per-code details — shape varies by `code`. */
     readonly details?: unknown;
     readonly requestId?: string;
@@ -3843,15 +131,69 @@ declare function isValidationError(e: unknown): e is BoardApiError;
 declare function isRateLimited(e: unknown): e is BoardApiError;
 declare function isConflict(e: unknown): e is BoardApiError;
 
+/** The minimal page shape every v1 list/search envelope satisfies. */
+interface PageShape {
+    hasMore: boolean;
+    nextCursor: string | null;
+    data: unknown[];
+}
+type ItemOf<P extends PageShape> = P['data'][number];
+interface Paginator<P extends PageShape> extends AsyncIterable<ItemOf<P>> {
+    /** Iterate raw page envelopes instead of items. */
+    pages(): AsyncGenerator<P, void, undefined>;
+    /**
+     * Collect items into an array, fetching pages only until `limit` items are
+     * gathered. The cap is required — an unbounded collect over a large board
+     * (tens of thousands of jobs) is an out-of-memory foot-gun.
+     *
+     * The cap bounds ITEMS collected, not the per-request page size — that is
+     * the `limit` in the list QUERY. Collecting 500 items at the API's default
+     * page size means many round trips; pass a page size too:
+     * `paginate(board.jobs.list, { limit: 100 }).toArray({ limit: 500 })`.
+     */
+    toArray(opts: {
+        limit: number;
+    }): Promise<ItemOf<P>[]>;
+}
+/**
+ * Walk a paginated list method to exhaustion — `for await` over items or
+ * pages, echoing the opaque `nextCursor` forward per `01-conventions.md` §7
+ * until `hasMore` is `false`.
+ *
+ * Works with any SDK list/search method (or a closure over one, for methods
+ * that take a leading id/slug). Cursor iteration order is stable only under
+ * an explicit sort/query — see the jobs skill.
+ *
+ * `offset` is honored for the FIRST page only and dropped afterwards: on
+ * storefront reads `offset` takes precedence over `cursor`, so carrying it
+ * forward would re-serve the same page forever.
+ *
+ * @example
+ * // every published job, one page of 100 at a time
+ * for await (const card of paginate(board.jobs.list, { limit: 100 })) {
+ *   urls.push(card.links.public);
+ * }
+ *
+ * @example
+ * // raw pages (e.g. sitemap bucketing); leading-arg methods via a closure
+ * const pager = paginate((q, o) => board.companies.listJobs('acme', q, o));
+ * for await (const page of pager.pages()) { … }
+ *
+ * @example
+ * // toArray's limit caps ITEMS; the query limit sets the PAGE size —
+ * // pass both, or 500 items arrive at the default page size (many trips).
+ * const first500 = await paginate(board.companies.list, { limit: 100 })
+ *   .toArray({ limit: 500 });
+ */
+declare function paginate<Q extends Record<string, unknown>, P extends PageShape>(listFn: (query?: Q, options?: FetchOptions) => Promise<P>, query?: Q, options?: FetchOptions): Paginator<P>;
+
 /**
  * Kept in lockstep with the package.json `version` field — guarded by
  * version.test.ts, which fails the suite on any drift. A hand-written
  * constant because the package is platform-neutral and cannot read
  * package.json at runtime.
  */
-declare const SDK_VERSION = "1.25.0";
-
-type Schemas = components['schemas'];
+declare const SDK_VERSION = "1.26.0";
 
 type BoardUser = Schemas['BoardUser'];
 type BoardAuthSession = Schemas['BoardAuthSession'];
@@ -3893,107 +235,6 @@ type CustomFieldOption = Schemas['CustomFieldOption'];
  */
 type BoardSeo = Schemas['BoardSeo'];
 
-/**
- * Stripe-shaped success envelopes (`01-conventions.md` §5.1). The
- * server MAY add top-level fields; consumers MUST ignore unknown
- * fields.
- */
-/**
- * Medusa-style storefront pagination fields (ADR-0037 §7), populated only by
- * the board jobs catalog reads (browse / search / company-jobs); absent on
- * every other list/search. `nextCursor` is preserved alongside (offset-encoded).
- */
-interface StorefrontPagination {
-    /** Total matching results ("X jobs"). */
-    count?: number;
-    /** The page size used for this response. */
-    limit?: number;
-    /** Number of items skipped before this page. */
-    offset?: number;
-    /** Items hidden behind the candidate paywall for the current viewer; absent/0 when entitled. */
-    gatedCount?: number;
-}
-interface ListEnvelope<T> extends StorefrontPagination {
-    object: 'list';
-    url: string;
-    hasMore: boolean;
-    /** `null` when `hasMore` is false — always present, never undefined. */
-    nextCursor: string | null;
-    data: T[];
-}
-interface SearchEnvelope<T> extends StorefrontPagination {
-    object: 'search_result';
-    url: string;
-    hasMore: boolean;
-    nextCursor: string | null;
-    data: T[];
-}
-
-type PublicJob = Schemas['PublicJob'];
-type PublicJobCard = Schemas['PublicJobCard'];
-/**
- * A job's opaque, display-only custom-field values (CAV-294), keyed by each
- * field's `key`. Resolve labels via the board's `CustomFieldDefinition`s
- * (`board.context().customFields`).
- */
-type CustomFieldValues = PublicJob['customFieldValues'];
-type CustomFieldValue = CustomFieldValues[string];
-type JobCompany = Schemas['JobCompany'];
-type OfficeLocation = Schemas['JobOfficeLocation'];
-type RemoteOption = NonNullable<PublicJob['remoteOption']>;
-type EmploymentType = NonNullable<PublicJob['employmentType']>;
-type Seniority = NonNullable<PublicJob['seniority']>;
-/** Candidate-facing result ordering (ADR-0048); `relevance` is the default. */
-type JobSort = NonNullable<Schemas['PublicSearchJobsBody']['sort']>;
-type EducationRequirement = PublicJob['educationRequirements'][number];
-type RemotePermit = PublicJob['remotePermits'][number];
-type RemoteTimezone = PublicJob['remoteTimezones'][number];
-/**
- * Derived suggestion on a browse list (ADR-0037 §8): jobs surface `category`
- * and `skill` terms; the companies list surfaces `market` terms.
- */
-interface RelatedSearch {
-    type: 'category' | 'skill' | 'market';
-    slug: string;
-    term: string;
-    count: number;
-}
-/** The browse list envelope — `PublicJobCard`s + storefront fields + `relatedSearches`. */
-interface JobCardListEnvelope extends ListEnvelope<PublicJobCard> {
-    relatedSearches?: RelatedSearch[];
-}
-/** The search envelope — `PublicJobCard`s + storefront fields. */
-type JobCardSearchEnvelope = SearchEnvelope<PublicJobCard>;
-type JobsListQuery = {
-    cursor?: string;
-    /** 1–100. */
-    limit?: number;
-    /** Storefront page offset; takes precedence over `cursor`. `offset + limit` ≤ 10,000. */
-    offset?: number;
-    /** Repeated param (up to 10) — OR-matched. Repeat `companyId` per value. */
-    companyId?: string[];
-    remoteOption?: RemoteOption[];
-    employmentType?: EmploymentType[];
-    seniority?: Seniority[];
-    /** Result ordering (ADR-0048). Absent ⇒ `relevance` (the featured-ranked browse). */
-    sort?: JobSort;
-    /** Place slug for a geo radius search; unresolvable slugs are ignored. */
-    location?: string;
-    /** Radius in km around `location` (10–250; default 50). */
-    radius?: number;
-    /** Category slug seed (the `/jobs/[keyword]` page) — server resolves it to the English source name; unresolvable → 404. */
-    category?: string;
-    /** Skill slug seed (the `/jobs/skills/[skill]` page) — server-resolved; unresolvable → 404. */
-    skill?: string;
-    /** Sparse fieldset (Medusa-style `+field`). Only `'+description'` is supported — adds `description` to each card. */
-    fields?: string;
-};
-type JobsSimilarQuery = {
-    /** How many similar jobs to return (1–20; default 5). */
-    limit?: number;
-};
-type JobsSearchBody = Schemas['PublicSearchJobsBody'];
-
 type EmbedJobsQuery = {
     /** Free-text search query, up to 200 characters. */
     q?: string;
@@ -4399,7 +640,7 @@ type CreateJobPostingInput = Schemas['CreateJobPostingBody'];
 type JobPostingResult = Schemas['JobPostingResult'];
 /**
  * The result of `uploadLogo()` / `fetchLogoByDomain()`: a stored logo whose
- * `publicUrl` you pass back as `submission.logoUrl` on `create(...)`.
+ * `publicUrl` you pass back as the top-level `logoUrl` on `create(...)`.
  */
 type JobPostingLogoResult = Schemas['JobPostingLogo'];
 type JobPostingBillingCheck = Schemas['JobPostingBillingCheck'];
@@ -6748,4 +2989,4 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
 };
 type BoardSdk = ReturnType<typeof createBoardClient>;
 
-export { ACCESS_TOKEN_KEY, type AccessCheckoutBody, type AccessCheckoutSession, type AccessCheckoutSessionState, type AccessGrant, type AccessPortalBody, type AccessPortalSession, type AddApplicantNoteBody, type Alert, type AlertBody, type Application, type ApplicationsListQuery, type ApplyBody, type Awaitable, BOARD_ACCESS_GRANT_KEY, type Block, type BlockStatus, type BlockUserBody, type BlockedUser, type BlogAuthorEmbed, type BlogPostsListQuery, type BlogSearchBody, type BlogSimilarQuery, type BlogTagEmbed, type BoardAccessGrant, BoardApiError, type BoardAuthSession, BoardClient, type BoardRequest, type BoardSdk, type BoardSeo, type BoardUser, type BulkMoveApplicantsBody, type BulkRejectApplicantsBody, type CandidateAvatar, type CandidateEducation, type CandidateExperience, type CandidateLanguage, type CandidateProfile, type CandidateSkill, type ClaimableCompany, type CompaniesListQuery, type CompaniesSearchBody, type CompanyCategorySalary, type CompanyJobsListQuery, type CompanyListEnvelope, type CompanyMarket, type CompanyMarketRef, type CompanyMarketsListQuery, type CompanyMembership, type CompanySalary, type CompanySimilarQuery, type ConfirmWorkEmailBody, type ConsumeMagicLinkBody, type Conversation, type ConversationArchive, type ConversationDetail, type ConversationRef, type ConversationsListQuery, type CreateBoardClientOptions, type CreateCompanyBody, type CreateEducationBody, type CreateEmployerJobBody, type CreateExperienceBody, type CreateJobPostingInput, type CreatePipelineStageBody, type CustomFieldDefinition, type CustomFieldOption, type CustomFieldType, type CustomFieldValue, type CustomFieldValues, type CustomStorage, type EditMessageBody, type EducationRequirement, type EmbedJobsQuery, type EmployerApplicant, type EmployerBillingOption, type EmployerCheckout, type EmployerCheckoutBody, type EmployerCompany, type EmployerCompanySearchQuery, type EmployerJob, type EmployerJobSummary, type EmployerJobsListQuery, type EmployerPipeline, type EmployerPipelineQuery, type EmployerPipelineStage, type EmploymentType, type FetchOptions, type FindExistingConversationQuery, type ForgotPasswordBody, type HandleAvailability, type JobAlertConfirmation, type JobAlertDeletePreferenceInput, type JobAlertFiltersInput, type JobAlertFrequency, type JobAlertManageQuery, type JobAlertManageResult, type JobAlertManageState, type JobAlertManageTokenInput, type JobAlertPreference, type JobAlertRemoteOption, type JobAlertResendResult, type JobAlertStoredFilters, type JobAlertSubscribeInput, type JobAlertSubscription, type JobAlertUpdatePreferenceInput, type JobCardListEnvelope, type JobCardSearchEnvelope, type JobCompany, type JobPostingBillingCheck, type JobPostingBillingOptions, type JobPostingBillingVerification, type JobPostingLogoResult, type JobPostingPlan, type JobPostingResult, type JobPostingSubscriptionEntitlements, type JobSort, type JobsListQuery, type JobsSearchBody, type JobsSimilarQuery, type LegalEntity, type LegalPageType, type ListEnvelope, type LocationSalaryDetail, type LocationSkillsIndex, type LocationTitlesIndex, type Logger, type LoginBody, type LogoutBody, type Message, type ModerationReport, type MoveApplicantStageBody, type NotificationPreference, type OAuthAuthorizationQuery, type OAuthAuthorizationUrl, type OAuthExchangeBody, type OAuthProvider, type OfficeLocation, type PaywallOffer, type PaywallOfferListEnvelope, type PlacesListQuery, type Plan, type PlanListEnvelope, type PlansListQuery, type PublicBlogAdjacentPosts, type PublicBlogAuthor, type PublicBlogPost, type PublicBlogPostSummary, type PublicBlogTag, type PublicBoard, type PublicBoardAnalytics, type PublicBoardFeatures, type PublicBoardTheme, type PublicCompany, type PublicCompanyDetail, type PublicJob, type PublicJobCard, type PublicLegalPage, type PublicPlace, REFRESH_TOKEN_KEY, type ReadReceipt, type RedirectResolution, type RefreshBody, type RegisterBody, type RelatedSearch, type RemoteOption, type RemotePermit, type RemoteTimezone, type ReorderPipelineStagesBody, type ReplyBody, type ReportBody, type RequestMagicLinkBody, type ResetPasswordBody, type Resume, type ResumeUploadOptions, SDK_VERSION, type SalaryCompany, type SalaryDetailQuery, type SalaryLocation, type SalarySkill, type SalaryTitle, type SalesLedPlan, type SalesLedPlanListEnvelope, type SaveJobBody, type SavedJob, type SavedJobsListQuery, type SearchEnvelope, type SendWorkEmailBody, type Seniority, type SkillLocationSalary, type SkillLocationsIndex, type SkillSalaryDetail, type StartAboutApplicationBody, type StartConversationBody, type StorageMode, type StorefrontPagination, type TalentDirectoryEntry, type TalentDirectoryListEnvelope, type TalentDirectoryQuery, type TalentProfile, type TaxonomyGeo, type TaxonomyResolution, type ThreadMessagesQuery, type TitleLocationSalary, type TitleLocationsIndex, type TitleSalaryDetail, type UnreadCount, type UnsubscribeBody, type UpdateApplicationFactsBody, type UpdateCandidateProfileBody, type UpdateEducationBody, type UpdateEmployerCompanyBody, type UpdateEmployerJobBody, type UpdateExperienceBody, type UpdateLanguagesBody, type UpdateNotificationPreferenceBody, type UpdatePipelineStageBody, type UpdateSkillsBody, type VerifyEmailBody, createBoardClient, isBoardApiError, isBoardPasswordRequired, isConflict, isForbidden, isNotFound, isRateLimited, isUnauthorized, isValidationError };
+export { ACCESS_TOKEN_KEY, type AccessCheckoutBody, type AccessCheckoutSession, type AccessCheckoutSessionState, type AccessGrant, type AccessPortalBody, type AccessPortalSession, type AddApplicantNoteBody, type Alert, type AlertBody, type Application, type ApplicationsListQuery, type ApplyBody, type Awaitable, BOARD_ACCESS_GRANT_KEY, BOARD_API_ERROR_CODES, type Block, type BlockStatus, type BlockUserBody, type BlockedUser, type BlogAuthorEmbed, type BlogPostsListQuery, type BlogSearchBody, type BlogSimilarQuery, type BlogTagEmbed, type BoardAccessGrant, BoardApiError, type BoardApiErrorCode, type BoardAuthSession, BoardClient, type BoardRequest, type BoardSdk, type BoardSeo, type BoardUser, type BulkMoveApplicantsBody, type BulkRejectApplicantsBody, type CandidateAvatar, type CandidateEducation, type CandidateExperience, type CandidateLanguage, type CandidateProfile, type CandidateSkill, type ClaimableCompany, type CompaniesListQuery, type CompaniesSearchBody, type CompanyCategorySalary, type CompanyJobsListQuery, type CompanyListEnvelope, type CompanyMarket, type CompanyMarketRef, type CompanyMarketsListQuery, type CompanyMembership, type CompanySalary, type CompanySimilarQuery, type ConfirmWorkEmailBody, type ConsumeMagicLinkBody, type Conversation, type ConversationArchive, type ConversationDetail, type ConversationRef, type ConversationsListQuery, type CreateBoardClientOptions, type CreateCompanyBody, type CreateEducationBody, type CreateEmployerJobBody, type CreateExperienceBody, type CreateJobPostingInput, type CreatePipelineStageBody, type CustomFieldDefinition, type CustomFieldOption, type CustomFieldType, type CustomStorage, type EditMessageBody, type EmbedJobsQuery, type EmployerApplicant, type EmployerBillingOption, type EmployerCheckout, type EmployerCheckoutBody, type EmployerCompany, type EmployerCompanySearchQuery, type EmployerJob, type EmployerJobSummary, type EmployerJobsListQuery, type EmployerPipeline, type EmployerPipelineQuery, type EmployerPipelineStage, EmploymentType, type FetchOptions, type FindExistingConversationQuery, type ForgotPasswordBody, type HandleAvailability, type JobAlertConfirmation, type JobAlertDeletePreferenceInput, type JobAlertFiltersInput, type JobAlertFrequency, type JobAlertManageQuery, type JobAlertManageResult, type JobAlertManageState, type JobAlertManageTokenInput, type JobAlertPreference, type JobAlertRemoteOption, type JobAlertResendResult, type JobAlertStoredFilters, type JobAlertSubscribeInput, type JobAlertSubscription, type JobAlertUpdatePreferenceInput, JobCardListEnvelope, JobCardSearchEnvelope, type JobPostingBillingCheck, type JobPostingBillingOptions, type JobPostingBillingVerification, type JobPostingLogoResult, type JobPostingPlan, type JobPostingResult, type JobPostingSubscriptionEntitlements, JobsListQuery, JobsSearchBody, JobsSimilarQuery, type LegalEntity, type LegalPageType, ListEnvelope, type LocationSalaryDetail, type LocationSkillsIndex, type LocationTitlesIndex, type Logger, type LoginBody, type LogoutBody, type Message, type ModerationReport, type MoveApplicantStageBody, type NotificationPreference, type OAuthAuthorizationQuery, type OAuthAuthorizationUrl, type OAuthExchangeBody, type OAuthProvider, type Paginator, type PaywallOffer, type PaywallOfferListEnvelope, type PlacesListQuery, type Plan, type PlanListEnvelope, type PlansListQuery, type PublicBlogAdjacentPosts, type PublicBlogAuthor, type PublicBlogPost, type PublicBlogPostSummary, type PublicBlogTag, type PublicBoard, type PublicBoardAnalytics, type PublicBoardFeatures, type PublicBoardTheme, type PublicCompany, type PublicCompanyDetail, type PublicLegalPage, type PublicPlace, REFRESH_TOKEN_KEY, type ReadReceipt, type RedirectResolution, type RefreshBody, type RegisterBody, RelatedSearch, RemoteOption, type ReorderPipelineStagesBody, type ReplyBody, type ReportBody, type RequestMagicLinkBody, type ResetPasswordBody, type Resume, type ResumeUploadOptions, SDK_VERSION, type SalaryCompany, type SalaryDetailQuery, type SalaryLocation, type SalarySkill, type SalaryTitle, type SalesLedPlan, type SalesLedPlanListEnvelope, type SaveJobBody, type SavedJob, type SavedJobsListQuery, SearchEnvelope, type SendWorkEmailBody, Seniority, type SkillLocationSalary, type SkillLocationsIndex, type SkillSalaryDetail, type StartAboutApplicationBody, type StartConversationBody, type StorageMode, type TalentDirectoryEntry, type TalentDirectoryListEnvelope, type TalentDirectoryQuery, type TalentProfile, type TaxonomyGeo, type TaxonomyResolution, type ThreadMessagesQuery, type TitleLocationSalary, type TitleLocationsIndex, type TitleSalaryDetail, type UnreadCount, type UnsubscribeBody, type UpdateApplicationFactsBody, type UpdateCandidateProfileBody, type UpdateEducationBody, type UpdateEmployerCompanyBody, type UpdateEmployerJobBody, type UpdateExperienceBody, type UpdateLanguagesBody, type UpdateNotificationPreferenceBody, type UpdatePipelineStageBody, type UpdateSkillsBody, type VerifyEmailBody, createBoardClient, isBoardApiError, isBoardPasswordRequired, isConflict, isForbidden, isNotFound, isRateLimited, isUnauthorized, isValidationError, paginate };