@cavuno/board 1.39.0 → 1.41.0

package/dist/{_spec-DxC1ze93.d.mts → _spec-l_596ZwW.d.mts}

@@ -86,6 +86,31 @@ interface components {
              */
             admin: string;
         };
+        AdminPlan: {
+            /** @description Unique identifier for the plan. */
+            id: string;
+            /** @enum {string} */
+            object: "plan";
+            name: string;
+            description: string | null;
+            kind: string;
+            /**
+             * @description Subscription billing interval. Required for kind=subscription.
+             * @enum {string|null}
+             */
+            billingInterval: "month" | "year" | null;
+            /**
+             * @description Whether the plan grants job-posting or talent-access entitlement.
+             * @enum {string}
+             */
+            purpose: "job_posting" | "talent_access";
+            isPublic: boolean;
+            isRecommended: boolean;
+            isArchived: boolean;
+            displayOrder: number | null;
+            price: components["schemas"]["PlanPrice"];
+            features: components["schemas"]["PlanFeature"][];
+        };
         AiUsage: {
             id: string;
             /** @enum {string} */
@@ -276,6 +301,37 @@ interface components {
                 resourceId: string;
             })[];
         };
+        BillingCheckout: {
+            /** @enum {string} */
+            object: "billing_checkout";
+            funding: components["schemas"]["BillingHostedCheckoutFunding"];
+            /**
+             * Format: uri
+             * @description Hosted Stripe Checkout Session URL.
+             */
+            url: string;
+            /** @description Stripe Checkout Session id (cs_…). */
+            sessionId: string;
+            /**
+             * @description Self-serve plan key. enterprise is not self-serve and returns plan_not_self_serve.
+             * @enum {string}
+             */
+            planKey: "starter" | "basic" | "grow" | "advanced" | "enterprise";
+            /** @enum {string} */
+            interval: "monthly" | "annual";
+        };
+        BillingCheckoutBody: {
+            /**
+             * @description Self-serve plan key. enterprise is not self-serve and returns plan_not_self_serve.
+             * @enum {string}
+             */
+            planKey: "starter" | "basic" | "grow" | "advanced" | "enterprise";
+            /**
+             * @description Billing interval. Defaults to monthly when omitted.
+             * @enum {string}
+             */
+            interval?: "monthly" | "annual";
+        };
         BillingConnect: {
             /** @enum {string} */
             object: "billing_connect";
@@ -314,6 +370,14 @@ interface components {
             canRemoveBranding: boolean;
             apiAccess: boolean;
         };
+        BillingHostedCheckoutFunding: {
+            /** @enum {string} */
+            type: "hosted_checkout";
+        };
+        BillingSavedPmFunding: {
+            /** @enum {string} */
+            type: "saved_pm";
+        };
         BillingSubscription: {
             /** @enum {string} */
             object: "billing_subscription";
@@ -331,6 +395,47 @@ interface components {
             stripePriceId: string;
             quantity: number;
         };
+        BillingUpgrade: components["schemas"]["BillingUpgradeSavedPm"] | components["schemas"]["BillingUpgradeCheckoutRequired"];
+        BillingUpgradeBody: {
+            /**
+             * @description Self-serve plan key. enterprise is not self-serve and returns plan_not_self_serve.
+             * @enum {string}
+             */
+            planKey: "starter" | "basic" | "grow" | "advanced" | "enterprise";
+            /**
+             * @description Billing interval. Defaults to monthly when omitted.
+             * @enum {string}
+             */
+            interval?: "monthly" | "annual";
+        };
+        BillingUpgradeCheckoutRequired: {
+            /** @enum {string} */
+            object: "billing_upgrade";
+            funding: components["schemas"]["BillingHostedCheckoutFunding"];
+            /** @enum {string} */
+            status: "checkout_required";
+            /** Format: uri */
+            url: string;
+            sessionId: string;
+            /**
+             * @description Self-serve plan key. enterprise is not self-serve and returns plan_not_self_serve.
+             * @enum {string}
+             */
+            planKey: "starter" | "basic" | "grow" | "advanced" | "enterprise";
+        };
+        BillingUpgradeSavedPm: {
+            /** @enum {string} */
+            object: "billing_upgrade";
+            funding: components["schemas"]["BillingSavedPmFunding"];
+            /** @enum {string} */
+            status: "upgraded";
+            /**
+             * @description Self-serve plan key. enterprise is not self-serve and returns plan_not_self_serve.
+             * @enum {string}
+             */
+            planKey: "starter" | "basic" | "grow" | "advanced" | "enterprise";
+            stripeSubscriptionId: string;
+        };
         Block: {
             /** @enum {string} */
             object: "block";
@@ -1090,6 +1195,21 @@ interface components {
             object: "conversation_ref";
             conversationId: string | null;
         };
+        Coupon: {
+            id: string;
+            /** @enum {string} */
+            object: "coupon";
+            name: string | null;
+            percentOff: number | null;
+            amountOff: number | null;
+            currency: string | null;
+            duration: string;
+            durationInMonths: number | null;
+            valid: boolean;
+            appliesTo: string[] | null;
+            timesRedeemed: number;
+            created: string;
+        };
         CreateAuthorBody: {
             /** @description URL-friendly slug for the author. Auto-generated from `name` when omitted. */
             slug?: string;
@@ -1171,6 +1291,20 @@ interface components {
             /** @description URL-friendly slug for the company. Auto-generated from `name` when omitted. */
             slug?: string;
         };
+        CreateCouponBody: {
+            name: string;
+            percentOff?: number | null;
+            /** @description Fixed discount in the currency major unit (e.g. 10 for $10, 1000 for ¥1000). Required with `currency` when there is no percentOff. */
+            amountOff?: number | null;
+            currency?: string | null;
+            /** @enum {string} */
+            duration: "once" | "forever" | "repeating";
+            durationInMonths?: number;
+            maxRedemptions?: number;
+            /** @description Unix ms deadline after which the coupon cannot be redeemed. */
+            redeemBy?: number;
+            appliesToPlanIds?: string[];
+        };
         CreateDomainBody: {
             /** @description Hostname to bind to this board, for example jobs.acme.com. Labels may contain letters, numbers, and hyphens, and may not start or end with a hyphen. The API normalizes accepted hostnames to lowercase before writing. */
             domain: string;
@@ -1202,6 +1336,15 @@ interface components {
             description?: string;
             sortOrder?: number;
         };
+        CreateFeatureBody: {
+            /** @description Stable feature key, e.g. jobs.max_active. */
+            key: string;
+            name: string;
+            /** @description Value data type, e.g. integer or string. */
+            dataType: string;
+            description?: string;
+            defaultValue?: string;
+        };
         CreateForagerSubscriptionBody: {
             name: string;
             rules: components["schemas"]["ForagerRule"][];
@@ -1409,6 +1552,43 @@ interface components {
             /** @description The stage label. */
             label: string;
         };
+        CreatePlanBody: {
+            /** @description Display name for the plan. */
+            name: string;
+            /** @description Optional plan description. */
+            description?: string;
+            /**
+             * @description Plan billing kind.
+             * @enum {string}
+             */
+            kind: "free" | "one_time" | "bundle" | "subscription";
+            /**
+             * @description Subscription billing interval. Required for kind=subscription.
+             * @enum {string}
+             */
+            billingInterval?: "month" | "year";
+            /**
+             * @description Whether the plan grants job-posting or talent-access entitlement.
+             * @enum {string}
+             */
+            purpose?: "job_posting" | "talent_access";
+            /** @description Whether the plan is publicly listed. Defaults to false. */
+            isPublic?: boolean;
+            isRecommended?: boolean;
+            displayOrder?: number;
+        };
+        CreatePromotionCodeBody: {
+            code: string;
+            maxRedemptions?: number;
+            /**
+             * Format: date-time
+             * @description ISO-8601 expiry; converted to epoch seconds for Stripe.
+             */
+            expiresAt?: string;
+            firstTimeTransaction?: boolean;
+            minimumAmount?: number;
+            minimumAmountCurrency?: string;
+        };
         CreateRedirectBody: {
             /** @description Source path to match, for example `/old-careers`. */
             fromPath: string;
@@ -1815,6 +1995,28 @@ interface components {
              */
             public: string | null;
         };
+        EmployerJobStat: {
+            /** @enum {string} */
+            object: "employer_job_stat";
+            /** @description The Convex job id these stats belong to. */
+            jobId: string;
+            /** @description Job-detail page-views over the all-time window. */
+            views: number;
+            /** @description Apply-click events over the all-time window. */
+            applyClicks: number;
+            /** @description Native ATS application count, or `null` for an external-apply job (no native pipeline). */
+            applications: number | null;
+        };
+        EmployerJobStatsPoint: {
+            /** @enum {string} */
+            object: "employer_job_stats_point";
+            /** @description The UTC day this bucket covers (`YYYY-MM-DD`). */
+            date: string;
+            /** @description Job-detail page-views on this day. */
+            views: number;
+            /** @description Apply-click events on this day. */
+            applyClicks: number;
+        };
         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;
@@ -1919,6 +2121,25 @@ interface components {
             hidden: boolean;
             position: number;
         };
+        EmployerSubscription: {
+            id: string;
+            /** @enum {string} */
+            object: "employer_subscription";
+            employerEmail: string;
+            companyId: string | null;
+            companyName: string | null;
+            planId: string | null;
+            planName: string | null;
+            status: string;
+            /** @description ISO-8601 period end, or null. */
+            currentPeriodEnd: string | null;
+            cancelAtPeriodEnd: boolean;
+            /** @description ISO-8601 creation time. */
+            createdAt: string;
+            stripeCustomerId: string | null;
+            stripeSubscriptionId: string | null;
+        };
+        EmployerSubscriptionOrNull: components["schemas"]["EmployerSubscription"] | unknown | unknown;
         EmployerUpdateJobBody: {
             /** @description Long-form description of the role. Up to 25,000 characters. */
             description?: string;
@@ -1992,6 +2213,17 @@ interface components {
             /** @description The job title. */
             title?: string;
         };
+        FeatureDefinition: {
+            id: string;
+            /** @enum {string} */
+            object: "feature";
+            key: string;
+            name: string;
+            description: string | null;
+            dataType: string;
+            defaultValue: string | null;
+            isSystem: boolean;
+        };
         FindOrCreateCompanyBody: {
             /** @description The company's display name. */
             name: string;
@@ -2910,6 +3142,10 @@ interface components {
             requireApprovalAggregatedJobs?: boolean;
             /** @description Whether visitors must sign in to view jobs. */
             registrationWallEnabled?: boolean;
+            /** @description Whether the board's built-in ATS receives applications. When `false` (external-applications-only board), posting surfaces require an external `applicationUrl` and `POST /boards/:identifier/jobs/:jobSlug/apply` rejects with `applications_native_disabled`. Turning this off UNPUBLISHES every published native-apply job (those with no external `applicationUrl`) back to draft via an asynchronous batched drain — expect published job counts to shrink over the following seconds. Nothing is deleted, and re-enabling does NOT republish the drafted jobs. Absent means `true`. */
+            nativeApplicationsEnabled?: boolean;
+            /** @description Whether applicant↔employer messaging is enabled. When `false`, the `me/conversations` route family rejects with `messaging_disabled` and new-message emails are suppressed. Absent means `true`. */
+            applicantMessagingEnabled?: boolean;
             /** @description Legacy shorthand for the talent directory. `true` maps to `talentDirectoryVisibility: "public"`; `false` maps to `"off"`. Prefer the tri-state field. Providing both with conflicting values returns `settings_conflicting_fields`. */
             talentDirectoryEnabled?: boolean;
             /**
@@ -2956,6 +3192,34 @@ interface components {
                 [key: string]: unknown;
             };
         };
+        PaywallGrantAdmin: {
+            id: string;
+            /** @enum {string} */
+            object: "paywall_grant";
+            boardUserId: string;
+            email: string;
+            displayName: string;
+            /** @enum {string} */
+            kind: "recurring" | "one_time";
+            offerKey: string;
+            status: string;
+            stripeCustomerId: string | null;
+            stripeSubscriptionId: string | null;
+            amountCents: number;
+            currency: string;
+            currentPeriodStart: string | null;
+            currentPeriodEnd: string | null;
+            cancelAtPeriodEnd: boolean;
+            activatedAt: string | null;
+            canceledAt: string | null;
+            createdAt: string;
+        };
+        PaywallGrantCount: {
+            /** @enum {string} */
+            object: "paywall_grant_count";
+            cancelableRecurring: number;
+            windingDownRecurring: number;
+        };
         PaywallOffer: {
             /** @enum {string} */
             object: "paywall_offer";
@@ -2974,6 +3238,26 @@ interface components {
             intervalCount: number | null;
             isDefault: boolean;
         };
+        PaywallOfferAdmin: {
+            id: string;
+            /** @enum {string} */
+            object: "paywall_offer";
+            offerKey: string;
+            label: string | null;
+            billingLabel: string | null;
+            /** @enum {string} */
+            kind: "recurring" | "one_time";
+            intervalUnit: string | null;
+            intervalCount: number | null;
+            amountCents: number;
+            currency: string;
+            stripePriceId: string | null;
+            enabled: boolean;
+            isDefault: boolean;
+            displayOrder: number;
+            createdAt: string;
+        };
+        PaywallOfferAdminOrNull: components["schemas"]["PaywallOfferAdmin"] | unknown | unknown;
         Permission: {
             /** @description Unique identifier for the permission. */
             id: string;
@@ -3022,6 +3306,36 @@ interface components {
                 messagesPerPeriod: string;
             };
         };
+        PlanFeature: {
+            /** @description Stable feature key, e.g. jobs.max_active. */
+            key: string;
+            name: string | null;
+            value: string | null;
+            dataType: string | null;
+        };
+        PlanFeatureValue: {
+            key: string;
+            value: string;
+        };
+        /** @description The plan single active price, or null when no price has been set. */
+        PlanPrice: {
+            /** @description ISO 4217 currency code, lowercase. */
+            currency: string;
+            /** @description Unit amount in the smallest currency unit. */
+            amountCents: number;
+            stripePriceId: string | null;
+            stripeProductId: string | null;
+            isActive: boolean;
+        } | null;
+        PromotionCode: {
+            id: string;
+            /** @enum {string} */
+            object: "promotion_code";
+            code: string;
+            couponId: string;
+            active: boolean;
+            created: string;
+        };
         PublicBlogAdjacentPosts: {
             /** @enum {string} */
             object: "blog_adjacent_posts";
@@ -3115,6 +3429,10 @@ interface components {
                 publicJobSubmission: boolean;
                 candidatePaywall: boolean;
                 impressum: boolean;
+                /** @description Whether the board accepts native (on-board ATS) applications. `false` means external-applications-only: the server rejects native submissions to `POST /jobs/:jobSlug/apply` with `applications_native_disabled` (422). Clients should hide native apply UI and treat a job with no external `applicationUrl` as not-applyable. */
+                nativeApplications: boolean;
+                /** @description Whether applicant↔employer messaging is enabled on the board. `false` means the `me/conversations` route family rejects with `messaging_disabled` (403) — hide inbox/dock/Message CTAs. */
+                messaging: boolean;
             };
             /**
              * @description The tri-state behind `features.talentDirectory` (which is `visibility === 'public'`). Link /talent whenever this is not `'off'` — an employers-only directory renders a sign-in upsell for anonymous visitors, matching the hosted chrome.
@@ -3622,6 +3940,9 @@ interface components {
         RemoveForagerCompanyBody: {
             companyUrl: string;
         };
+        RenameCouponBody: {
+            name: string;
+        };
         ReorderPipelineStagesBody: {
             /** @description The job whose stages are reordered. */
             jobId: string;
@@ -3931,6 +4252,19 @@ interface components {
             /** Format: email */
             workEmail: string;
         };
+        SetPlanFeaturesBody: {
+            /** @description Full replacement set of feature key/value pairs for the plan. */
+            features: {
+                key: string;
+                value: string;
+            }[];
+        };
+        SetPlanPriceBody: {
+            /** @description ISO 4217 currency code (e.g. usd). */
+            currency: string;
+            /** @description Unit amount in the smallest currency unit. */
+            amountCents: number;
+        };
         SettingsAdsenseBody: {
             /** @description Whether AdSense placements are rendered on the public board. */
             adsenseEnabled?: boolean;
@@ -4141,6 +4475,9 @@ interface components {
         StartConversationBody: {
             candidateBoardUserId: string;
             body: string;
+        } | {
+            candidateHandle: string;
+            body: string;
         };
         Subscriber: {
             /** @description Unique identifier for the subscriber. */
@@ -4202,6 +4539,18 @@ interface components {
             items: components["schemas"]["SuggestionItem"][];
         };
         SuggestionItem: components["schemas"]["CompanySuggestion"] | components["schemas"]["TermSuggestion"];
+        TalentAccess: {
+            /** @enum {string} */
+            object: "talent_access";
+            /** @description Whether the viewer has an approved company membership on this board. */
+            isEmployer: boolean;
+            /** @description Whether this board sells talent access (a public `talent_access` plan exists). When `false` the talent surfaces are not credit-gated for employers. */
+            paywallActive: boolean;
+            /** @description The CTA answer: the viewer is an approved employer AND either the board has no talent paywall or one of their companies holds an active talent_access subscription or a succeeded credit pack. Always `false` for candidates; anonymous viewers get 401. */
+            hasTalentAccess: boolean;
+            /** @description True when any active talent_access subscription carries the unlimited profile-unlock sentinel on its feature snapshot. */
+            hasUnlimitedUnlocks: boolean;
+        };
         TalentDirectoryEntry: {
             /** @enum {string} */
             object: "talent_directory_entry";
@@ -4240,6 +4589,8 @@ interface components {
                 title: string;
                 companyName: string;
                 companyUrl: string | null;
+                /** @description Absolute logo URL for the company, resolved from `companyUrl` the same way the hosted profile renders it; `null` when the company has no usable website. Render a monogram/initials fallback when `null` (and on image error — the URL 404s when the brand has no icon). */
+                companyLogoUrl: string | null;
                 location: string | null;
                 employmentType: string | null;
                 locationType: string | null;
@@ -4255,6 +4606,8 @@ interface components {
             education: {
                 institutionName: string;
                 institutionUrl: string | null;
+                /** @description Absolute logo URL for the institution, resolved from `institutionUrl` the same way the hosted profile renders it; `null` when the institution has no usable website. Render a monogram/initials fallback when `null` (and on image error). */
+                institutionLogoUrl: string | null;
                 degree: string | null;
                 fieldOfStudy: string | null;
                 grade: string | null;
@@ -4769,10 +5122,30 @@ interface components {
             channel: "messageEmails" | "applicationEmails";
             subscribed: boolean;
         };
+        UpdatePaywallOfferBody: {
+            /** @description Enable or disable the offer. */
+            isEnabled?: boolean;
+            /** @description Alias of isEnabled (either is accepted). */
+            enabled?: boolean;
+            label?: string;
+            billingLabel?: string;
+            displayOrder?: number;
+            isDefault?: boolean;
+        };
         UpdatePipelineStageBody: {
             label?: string;
             hidden?: boolean;
         };
+        UpdatePlanBody: {
+            name?: string;
+            description?: string;
+            /** @description Publish/unpublish the plan. */
+            isPublic?: boolean;
+            isRecommended?: boolean;
+            /** @description Archive the plan (soft-delete). There is no hard DELETE. */
+            isArchived?: boolean;
+            displayOrder?: number;
+        };
         UpdateRedirectBody: {
             /** @description Source path to match, for example `/old-careers`. */
             fromPath?: string;