@cavuno/board 4.56.1 → 4.57.0

package/dist/{_spec-DS4-nx__.d.ts → _spec-CDYDY0hB.d.ts}

@@ -2292,6 +2292,174 @@ interface components {
             /** @description The `token` query parameter from the invite link (`/employers/invites/accept?token=…`). */
             token: string;
         };
+        ProductCard: {
+            /** @enum {string} */
+            object: "product";
+            slug: string;
+            name: string;
+            summary: string | null;
+            coverImageUrl: string | null;
+            price: components["schemas"]["ProductPrice"];
+            rating: components["schemas"]["ProductRatingSummary"];
+            soldOut: boolean;
+            /** @description The product page path on the board (its route manifest words). */
+            url: string;
+        };
+        ProductCheckout: {
+            /** @enum {string} */
+            object: "product_checkout";
+            /**
+             * @description `complete`: a free claim was recorded; send the buyer to `downloadUrl`. `open`: mount the embedded Stripe Checkout with the mount kit fields.
+             * @enum {string}
+             */
+            status: "complete" | "open";
+            /** @description `complete` only: the download page path on the board, with its token. */
+            downloadUrl: string | null;
+            /** @description `complete` only: the purchase token for `GET /purchases/{token}`. */
+            purchaseToken: string | null;
+            sessionId: string | null;
+            /** @description `open` only: the Checkout Session client secret. The session expires after 30 minutes. */
+            clientSecret: string | null;
+            /** @description `open` only: the board’s connected Stripe account. */
+            stripeAccountId: string | null;
+            /** @description `open` only: the Stripe publishable key for `loadStripe`. */
+            publishableKey: string | null;
+        };
+        ProductCheckoutBody: {
+            /** @description Where the download link and receipt are sent. */
+            email: string;
+            /**
+             * @description Answers to the product’s `questions`, by question id.
+             * @default []
+             */
+            answers: {
+                questionId: string;
+                value: string | boolean;
+            }[];
+            /** @description Pay what you want: the amount the buyer chose, in cents. Omit to let the buyer choose on the Stripe page. `0` on a $0+ product claims it for free. */
+            amountCents?: number;
+            /** @description Free products: also subscribe the email to the board’s job alerts. Show it unticked. */
+            jobAlertOptIn?: boolean;
+            /** @description Paid products: the relative path Stripe returns the buyer to (`session_id` is appended). Defaults to the product page. */
+            returnPath?: string;
+            /** @description Honeypot. Render it hidden and leave it empty; a filled value is answered like a success and nothing is recorded or sent. */
+            website?: string;
+        };
+        ProductCheckoutStatus: {
+            /** @enum {string} */
+            object: "product_checkout_status";
+            /**
+             * @description `awaiting_payment` until the payment webhook lands (poll briefly), then `paid` with the download page.
+             * @enum {string}
+             */
+            status: "awaiting_payment" | "paid" | "free" | "access_removed";
+            /** @description `paid` only: the download page path on the board, with its token. */
+            downloadUrl: string | null;
+            /** @description `paid` only: the purchase token for `GET /purchases/{token}`. */
+            purchaseToken: string | null;
+        };
+        ProductDetail: {
+            /** @enum {string} */
+            object: "product";
+            slug: string;
+            name: string;
+            /** @description Plain-text description. When `descriptionHtml` is set, this is its text. */
+            description: string | null;
+            /** @description Formatted description as sanitized HTML: `h2`, `h3`, `p`, `br`, `strong`, `em`, `u`, `s`, `ul`, `ol`, `li`, `blockquote`, `hr`, `a` (`rel="noopener nofollow ugc"`, new tab) and `img` (images uploaded to this board only). `null` when the seller wrote none; show `description` instead. */
+            descriptionHtml: string | null;
+            summary: string | null;
+            /** @description Operator facts shown on the product page. */
+            details: components["schemas"]["ProductDetailRow"][];
+            images: string[];
+            price: components["schemas"]["ProductPrice"];
+            soldOut: boolean;
+            /** @description Sales so far, when the seller shows the number of sales; otherwise `null`. */
+            salesCount: number | null;
+            refundPolicy: string | null;
+            questions: components["schemas"]["ProductQuestion"][];
+            contents: {
+                displayName: string;
+                description: string | null;
+                /** @enum {string} */
+                kind: "file" | "link";
+                /** @description File extension (`pdf`, `zip`, …) or `link`. */
+                fileType: string;
+                pageCount: number | null;
+                sizeBytes: number | null;
+            }[];
+            facts: {
+                fileCount: number;
+                linkCount: number;
+                fileTypes: string[];
+                pageCount: number | null;
+                totalSizeBytes: number;
+            };
+            /** @description `false` for an unlisted (link-only) product: keep it out of listings, sitemaps and search indexes. */
+            isListed: boolean;
+            ratingsEnabled: boolean;
+            rating: {
+                average: number | null;
+                count: number;
+                /** @description Counted reviews per star, 1 star first. */
+                histogram: number[];
+            } | null;
+            /** @description The product page path on the board. */
+            url: string;
+        };
+        /** @description A facts box row: `text` shows `value`; `check` is a yes/no row shown as a tick or a cross. */
+        ProductDetailRow: {
+            /** @enum {string} */
+            kind: "text";
+            label: string;
+            value: string;
+        } | {
+            /** @enum {string} */
+            kind: "check";
+            label: string;
+            /** @description Yes/no: show a tick for `true` and a cross for `false`, not a word. */
+            checked: boolean;
+        };
+        ProductPrice: {
+            /**
+             * @description `free`: claimed with an email. `fixed`: one price. `pay_what_you_want`: the buyer chooses at least `minimumCents`.
+             * @enum {string}
+             */
+            kind: "free" | "fixed" | "pay_what_you_want";
+            /** @description Lowercase ISO currency code; `null` for free products. */
+            currency: string | null;
+            /** @description The price (fixed), the minimum (pay what you want), or 0 (free). */
+            amountCents: number;
+            minimumCents?: number;
+            suggestedCents?: number | null;
+        };
+        ProductQuestion: {
+            id: string;
+            /** @enum {string} */
+            kind: "text" | "checkbox" | "dropdown";
+            label: string;
+            required: boolean;
+            /** @description Dropdown choices; `null` for the other kinds. */
+            options: string[] | null;
+        };
+        /** @description `null` when ratings are off for the product. */
+        ProductRatingSummary: {
+            /** @description Average stars, 1 to 5; `null` with no counted reviews. */
+            average: number | null;
+            count: number;
+        } | null;
+        ProductReview: {
+            id: string;
+            /** @enum {string} */
+            object: "product_review";
+            stars: number;
+            comment: string | null;
+            displayName: string | null;
+            /** @description The operator’s public reply. */
+            reply: string | null;
+            replyAt: string | null;
+            createdAt: string;
+            updatedAt: string;
+        };
         ProfileChoiceList: {
             data: {
                 id: string;
@@ -3169,6 +3337,148 @@ interface components {
             /** @description The board password. */
             password: string;
         };
+        Purchase: {
+            /** @enum {string} */
+            object: "purchase";
+            /** @enum {string} */
+            status: "awaiting_payment" | "paid" | "free";
+            product: {
+                slug: string;
+                name: string;
+                thankYouMessage: string | null;
+            };
+            email: string;
+            purchasedAt: string;
+            amountCents: number;
+            currency: string;
+            /** @description Downloads allowed per file. */
+            downloadCap: number;
+            files: ({
+                /** @enum {string} */
+                kind: "file";
+                fileId: string;
+                displayName: string;
+                description: string | null;
+                contentType: string | null;
+                sizeBytes: number | null;
+                pageCount: number | null;
+                /**
+                 * @description `preparing`: the buyer’s personal stamped copy is being made (they are emailed when it is ready). `limit_reached`: no downloads left.
+                 * @enum {string}
+                 */
+                state: "ready" | "preparing" | "limit_reached";
+                downloadsUsed: number;
+                downloadsLeft: number;
+                /** @description The buyer gets their own stamped copy of this PDF. */
+                stamped: boolean;
+            } | {
+                /** @enum {string} */
+                kind: "link";
+                fileId: string;
+                displayName: string;
+                description: string | null;
+                url: string;
+            })[];
+            /** @description Whether to offer Download all: a file is ready to download and the ready files total at most 500 MB. Above 500 MB the buyer downloads the files one by one. */
+            downloadAllAvailable: boolean;
+            /** @enum {string} */
+            stamping: "off" | "ready" | "preparing";
+            /** @description The Stripe receipt or paid invoice; `null` for free claims. */
+            receiptUrl: string | null;
+            refundPolicy: string | null;
+            ratingsEnabled: boolean;
+            /** @description The buyer’s own review, if any. */
+            review: {
+                stars: number;
+                comment: string | null;
+                displayName: string | null;
+                hidden: boolean;
+                reply: string | null;
+                updatedAt: string;
+            } | null;
+            purchaseToken: string;
+            /** @description Send it back in `X-Cavuno-Purchase-Confirmation` on later requests for this purchase; `null` when the request already carried it. */
+            confirmationToken: string | null;
+        };
+        PurchaseConfirmBody: {
+            email: string;
+        };
+        PurchaseConfirmation: {
+            /** @enum {string} */
+            object: "purchase_confirmation";
+            confirmationToken: string;
+        };
+        PurchaseDownload: {
+            /** @enum {string} */
+            object: "purchase_download";
+            /** @description A signed, short-lived link that downloads as an attachment. */
+            url: string;
+            expiresAt: string;
+            /** @description The name it downloads under: the file's `displayName`, with the file's extension added when that name has none. */
+            fileName: string;
+            downloadsLeft: number;
+            confirmationToken: string | null;
+        };
+        PurchaseDownloadAll: {
+            /** @enum {string} */
+            object: "purchase_download_all";
+            /** @description A short-lived link to the streamed ZIP of every ready file. */
+            url: string;
+            expiresAt: string;
+            fileCount: number;
+            totalBytes: number;
+            /** @description File ids left out while their stamped copy is made. */
+            preparing: string[];
+            /** @description File ids left out because no downloads are left. */
+            limitReached: string[];
+            confirmationToken: string | null;
+        };
+        PurchaseResendBody: {
+            email: string;
+            /** @description Only this product’s purchases; omit for all of them. */
+            productSlug?: string;
+            /** @description Honeypot. Render it hidden and leave it empty. */
+            website?: string;
+        };
+        PurchaseResendResult: {
+            /** @enum {string} */
+            object: "purchase_resend";
+            /** @enum {boolean} */
+            accepted: true;
+        };
+        PurchaseReviewBody: {
+            stars: number;
+            comment?: string;
+            /** @description The name shown with the review; omit to stay anonymous. */
+            displayName?: string;
+        };
+        PurchaseReviewResult: {
+            id: string;
+            /** @enum {string} */
+            object: "purchase_review";
+            /** @description Whether the stars count toward the product rating. */
+            counted: boolean;
+        };
+        PurchaseSummary: {
+            id: string;
+            /** @enum {string} */
+            object: "purchase_summary";
+            product: {
+                slug: string;
+                name: string;
+                coverImageUrl: string | null;
+            };
+            /** @enum {string} */
+            status: "paid" | "free";
+            purchasedAt: string;
+            amountCents: number;
+            currency: string;
+            /** @description `false` while the product cannot be delivered (taken down, or the board is closed). */
+            available: boolean;
+            purchaseToken: string;
+            /** @description The download page path on the board. */
+            downloadUrl: string;
+        };
         ReadReceipt: {
             /** @enum {string} */
             object: "read_receipt";

package/dist/bin.mjs

@@ -92,6 +92,12 @@ function blogAuthorPath(authorSlug) {
 function talentProfilePath(handle) {
   return `/p/${encodePathSegment(handle)}`;
 }
+function productPath(productSlug) {
+  return `/products/${encodePathSegment(productSlug)}`;
+}
+function purchasePath(purchaseToken) {
+  return `/purchases/${encodePathSegment(purchaseToken)}`;
+}
 var BOARD_PATHS = {
   home: "/",
   jobs: "/jobs",
@@ -116,7 +122,11 @@ var BOARD_PATHS = {
    * one definition.
    */
   alertsManage: "/alerts/manage",
-  alertsConfirm: "/alerts/confirm"
+  alertsConfirm: "/alerts/confirm",
+  /** The digital product catalogue. */
+  products: "/products",
+  /** A signed-in board user's purchased products. */
+  mePurchases: "/me/purchases"
 };
 
 // src/route-contract/roles.ts
@@ -135,6 +145,8 @@ var ROLE_PARAM_REGISTRY = {
   blogTag: ["tagSlug"],
   blogAuthor: ["authorSlug"],
   talentProfile: ["handle"],
+  product: ["productSlug"],
+  purchase: ["purchaseToken"],
   home: [],
   jobs: [],
   companies: [],
@@ -152,7 +164,9 @@ var ROLE_PARAM_REGISTRY = {
   talent: [],
   employers: [],
   alertsManage: [],
-  alertsConfirm: []
+  alertsConfirm: [],
+  products: [],
+  mePurchases: []
 };
 var ALL_ROLES = Object.keys(
   ROLE_PARAM_REGISTRY
@@ -175,6 +189,8 @@ var CANONICAL_MANIFEST = {
     blogTag: blogTagPath(":tagSlug"),
     blogAuthor: blogAuthorPath(":authorSlug"),
     talentProfile: talentProfilePath(":handle"),
+    product: productPath(":productSlug"),
+    purchase: purchasePath(":purchaseToken"),
     home: BOARD_PATHS.home,
     jobs: BOARD_PATHS.jobs,
     companies: BOARD_PATHS.companies,
@@ -192,7 +208,9 @@ var CANONICAL_MANIFEST = {
     talent: BOARD_PATHS.talent,
     employers: BOARD_PATHS.employers,
     alertsManage: "/alerts/manage",
-    alertsConfirm: "/alerts/confirm"
+    alertsConfirm: "/alerts/confirm",
+    products: BOARD_PATHS.products,
+    mePurchases: BOARD_PATHS.mePurchases
   }
 };
 
@@ -229,7 +247,11 @@ var ROLE_INDEX_PATHS = {
   talent: BOARD_PATHS.talent,
   employers: BOARD_PATHS.employers,
   alertsManage: BOARD_PATHS.home,
-  alertsConfirm: BOARD_PATHS.home
+  alertsConfirm: BOARD_PATHS.home,
+  product: BOARD_PATHS.products,
+  purchase: BOARD_PATHS.home,
+  products: BOARD_PATHS.products,
+  mePurchases: BOARD_PATHS.home
 };
 function splitSegments(path) {
   const withoutLeading = path.startsWith("/") ? path.slice(1) : path;

package/dist/{blog-By6dc-Ce.d.ts → blog-DNGOmaKI.d.ts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-DS4-nx__.js';
+import { S as Schemas } from './_spec-CDYDY0hB.js';
 
 /** Author shape embedded on posts (no `object` discriminator). */
 type BlogAuthorEmbed = Schemas['PublicBlogAuthorEmbed'];

package/dist/{blog-BcjUrzqE.d.mts → blog-WupXypHv.d.mts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-DS4-nx__.mjs';
+import { S as Schemas } from './_spec-CDYDY0hB.mjs';
 
 /** Author shape embedded on posts (no `object` discriminator). */
 type BlogAuthorEmbed = Schemas['PublicBlogAuthorEmbed'];

package/dist/{board-B7104o4G.d.ts → board-CmQox8FZ.d.ts}

@@ -1,5 +1,5 @@
-import { S as Schemas } from './_spec-DS4-nx__.js';
-import { L as ListEnvelope, v as RelatedSearch, b as CustomFieldFilter, O as ObjectReferenceFilter, a as JobCapability } from './jobs-DkDmvx2n.js';
+import { S as Schemas } from './_spec-CDYDY0hB.js';
+import { L as ListEnvelope, v as RelatedSearch, b as CustomFieldFilter, O as ObjectReferenceFilter, a as JobCapability } from './jobs-B-NPmaV0.js';
 
 type PublicCompany = Schemas['CompanyPublic'];
 /**

package/dist/{board-BboonvQM.d.mts → board-DbBBz7Pv.d.mts}

@@ -1,5 +1,5 @@
-import { S as Schemas } from './_spec-DS4-nx__.mjs';
-import { L as ListEnvelope, v as RelatedSearch, b as CustomFieldFilter, O as ObjectReferenceFilter, a as JobCapability } from './jobs-D70pujRc.mjs';
+import { S as Schemas } from './_spec-CDYDY0hB.mjs';
+import { L as ListEnvelope, v as RelatedSearch, b as CustomFieldFilter, O as ObjectReferenceFilter, a as JobCapability } from './jobs-CgmHLS8j.mjs';
 
 type PublicCompany = Schemas['CompanyPublic'];
 /**

package/dist/{breadcrumbs-CfRlf9_7.d.ts → breadcrumbs-DpXiAo9j.d.ts}

@@ -1,5 +1,5 @@
-import { P as PublicBoard, a as CompanyCategorySalary, b as CompanySalary, L as LocationSalaryDetail, S as SkillSalaryDetail, T as TitleSalaryDetail } from './board-B7104o4G.js';
-import { P as PublicJob } from './jobs-DkDmvx2n.js';
+import { P as PublicBoard, a as CompanyCategorySalary, b as CompanySalary, L as LocationSalaryDetail, S as SkillSalaryDetail, T as TitleSalaryDetail } from './board-CmQox8FZ.js';
+import { P as PublicJob } from './jobs-B-NPmaV0.js';
 
 /**
  * Wire enum for `salaryTimeframe`. Defined here (not re-exported from any

package/dist/{breadcrumbs-DmnLLDr9.d.mts → breadcrumbs-mQTz0vZo.d.mts}

@@ -1,5 +1,5 @@
-import { P as PublicBoard, a as CompanyCategorySalary, b as CompanySalary, L as LocationSalaryDetail, S as SkillSalaryDetail, T as TitleSalaryDetail } from './board-BboonvQM.mjs';
-import { P as PublicJob } from './jobs-D70pujRc.mjs';
+import { P as PublicBoard, a as CompanyCategorySalary, b as CompanySalary, L as LocationSalaryDetail, S as SkillSalaryDetail, T as TitleSalaryDetail } from './board-DbBBz7Pv.mjs';
+import { P as PublicJob } from './jobs-CgmHLS8j.mjs';
 
 /**
  * Wire enum for `salaryTimeframe`. Defined here (not re-exported from any