@peektravel/app-utilities 0.7.4 → 0.8.1

package/dist/index.d.cts

@@ -421,6 +421,64 @@ declare const RENTAL_PRODUCT_TYPE = "RENTAL";
  */
 declare const ADD_ON_PRODUCT_TYPE = "ADD-ON";
 
+/**
+ * The clean, transport-agnostic data model for an activity's custom questions.
+ *
+ * Custom questions are the operator-configured questions attached to a bookable
+ * activity (per-guest waiver-style prompts, free-text inputs, multiple-choice
+ * pickers, etc.). This is the shape consumers work with — it is decoupled from
+ * the underlying Peek GraphQL `Question`/`ChoiceQuestion` schema, which stays
+ * internal.
+ *
+ * Note: this describes the **question definitions** on an activity, not any
+ * customer's answers — so there is no PII here and nothing gated behind
+ * `fullCustomerAccess`.
+ */
+/**
+ * A single custom question configured on an activity.
+ *
+ * The ordering and requiredness come from the activity's question
+ * configuration; the remaining fields describe the reusable question itself.
+ */
+interface CustomQuestion {
+    /** Unique identifier of the question (e.g. `"cq_anq67"`). */
+    id: string;
+    /** 1-based position of the question within the activity's question list. */
+    order: number;
+    /** Whether the activity requires an answer to this question. */
+    isRequired: boolean;
+    /** The question prompt shown to the guest (Peek's `text`). */
+    questionText: string;
+    /** Helper/hint text shown alongside the prompt, or `null` when none. */
+    hintText: string | null;
+    /**
+     * The question's input type as reported by Peek — e.g. `"CHECK_BOX"`,
+     * `"TEXT"`, `"LOCATION"`, `"SELECT_ONE"`. Left as a string so new Peek
+     * question types flow through without a package change.
+     */
+    questionType: string;
+    /** Operator-only label for the question, or `null` when none. */
+    internalLabel: string | null;
+    /** `true` when the question is answered once per guest rather than per booking. */
+    perGuest: boolean;
+    /** Pre-filled default answer, or `null` when none. */
+    defaultValue: string | null;
+    /**
+     * Selectable options for choice-style questions (`SELECT_ONE`, `LOCATION`,
+     * …). Empty for free-text/checkbox questions that carry no options.
+     */
+    options: CustomQuestionOption[];
+}
+/** A single selectable option on a choice-style {@link CustomQuestion}. */
+interface CustomQuestionOption {
+    /** Unique identifier of the option (e.g. `"cqao_mwdgvw"`). */
+    id: string;
+    /** 1-based position of the option within the question's option list. */
+    order: number;
+    /** The option's display label (Peek's `text`). */
+    value: string;
+}
+
 /** Tuning options for a {@link ProductService}. */
 interface ProductServiceOptions {
     /** Page size for cursor-paginated item options. Default: 50. */
@@ -451,6 +509,21 @@ declare class ProductService {
     getAllRentals(): Promise<Product[]>;
     /** Returns only add-on products. */
     getAllAddons(): Promise<Product[]>;
+    /**
+     * Returns every custom question configured on a single activity, in the order
+     * Peek reports them. Choice-style questions (`SELECT_ONE`, `LOCATION`, …)
+     * carry their selectable {@link CustomQuestion.options}; free-text/checkbox
+     * questions return an empty option list.
+     *
+     * These are question **definitions**, not customer answers — no PII is
+     * involved, so the result is unaffected by `fullCustomerAccess`.
+     *
+     * @param productId The activity's id.
+     * @returns The activity's custom questions, or an empty list when the activity
+     *   has none or is not found.
+     * @throws Error when `productId` is missing or blank.
+     */
+    getCustomQuestions(productId: string): Promise<CustomQuestion[]>;
     private fetchActivities;
     private fetchAllItemOptionNodes;
 }
@@ -773,6 +846,34 @@ interface CreateBookingGuest {
     optinMarketing?: boolean;
     optinSms?: boolean;
 }
+/**
+ * An answer to one of an activity's custom questions, supplied when creating a
+ * booking. The question is identified by id **or** text, and the value is
+ * resolved against the question's type at create time (see
+ * {@link CreateBookingInput.customQuestionAnswers}).
+ */
+interface CustomQuestionAnswerInput {
+    /**
+     * The question to answer — either its id (`cq_…`) or its question text. Text
+     * is matched leniently (lowercased, non-alphanumerics stripped); it must match
+     * exactly one question or creation fails.
+     */
+    questionIdOrText: string;
+    /**
+     * The answer. How it is interpreted depends on the question's type:
+     * - **checkbox** — `yes`/`no`/`true`/`false` (case-insensitive).
+     * - **text** — used verbatim.
+     * - **select-one / location** — an option id (`cqao_…`) or the option's label,
+     *   matched leniently the same way as `questionIdOrText`.
+     *
+     * For **location** questions you only select the option — Peek holds each
+     * option's configured lat/long and applies it, so no coordinates are (or can
+     * be) supplied here.
+     *
+     * Per-guest questions are **not yet supported**: answering one fails creation.
+     */
+    value: string;
+}
 /**
  * Input for creating a booking. IDs must already be resolved — the package does
  * not do free-text product/ticket/time matching (that stays in the caller).
@@ -788,6 +889,21 @@ interface CreateBookingInput {
     guest: CreateBookingGuest;
     /** Operator notes to attach. */
     operatorNotes?: string;
+    /**
+     * Answers to the activity's custom questions. When non-empty, the activity's
+     * custom questions are fetched and each answer is validated/resolved before
+     * the booking is created — an unmatched question, ambiguous text/option, or
+     * invalid checkbox value fails creation before any quote is made.
+     */
+    customQuestionAnswers?: CustomQuestionAnswerInput[];
+    /**
+     * When `true`, creation fails if any of the activity's required custom
+     * questions (per-guest questions excluded) is left unanswered. Because this
+     * enforces coverage against the activity's questions, it forces custom-question
+     * validation to run even when `customQuestionAnswers` is empty or omitted.
+     * Default: `false`.
+     */
+    requireRequiredQuestions?: boolean;
     /** Suppress the customer confirmation email. Default: false. */
     skipCustomerEmail?: boolean;
     /** Clone the quote from an existing order. */
@@ -1160,10 +1276,18 @@ declare class BookingService {
      *
      * @throws {Error} when `activityId`, `availabilityTimeId`, a ticket
      * `resourceOptionId`/positive `quantity`, or the guest `name` is missing; when
-     * `markAsPaid` is set without an `idempotencyKey`; or when the quote/order
-     * mutations fail.
+     * `markAsPaid` is set without an `idempotencyKey`; when
+     * `requireRequiredQuestions` is set and a required custom question is left
+     * unanswered; or when the quote/order mutations fail.
      */
     create(input: CreateBookingInput): Promise<CreatedBooking>;
+    /**
+     * Resolves the input's custom-question answers into the quote's
+     * `questionAnswers` payload (each tagged with a fresh `refid`), or `null` when
+     * none were supplied. Fetches the activity's custom questions to validate
+     * against; throws on the first unmatched/ambiguous/invalid answer.
+     */
+    private buildQuestionAnswers;
     private markCreatedBookingPaid;
     /** Finds the parent item id of an add-on by matching its option id. */
     private resolveParentItemId;
@@ -2062,6 +2186,8 @@ declare class PeekAccessService {
     getAllRentals(): Promise<Product[]>;
     /** All add-on products. Delegates to {@link ProductService.getAllAddons}. */
     getAllAddons(): Promise<Product[]>;
+    /** An activity's custom questions. Delegates to {@link ProductService.getCustomQuestions}. */
+    getCustomQuestions(productId: string): Promise<CustomQuestion[]>;
     /** All active account users. Delegates to {@link AccountUserService.getAll}. */
     getAllAccountUsers(): Promise<AccountUser[]>;
     /** Account user by id, or null. Delegates to {@link AccountUserService.getById}. */
@@ -2836,4 +2962,4 @@ declare class AcmeApiError extends Error {
     constructor(statusCode: number, body: unknown, message?: string);
 }
 
-export { ACTIVITY_PRODUCT_TYPE, ADD_ON_PRODUCT_TYPE, type AccessOptions, type AccountUser, AccountUserService, type AccountUserServiceOptions, AcmeAccessService, type AcmeAccessServiceConfig, type AcmeActivity, type AcmeActivityTicket, AcmeApiError, AcmeProductService, type Activity, type ActivityOverrides, type ActivityTicket, type AddAddonInput, AdminAccountRequiredError, type Agent, type AssignGuideResult, type AssignedActivity, type AssignedResource, type Availability, AvailabilityService, type AvailabilityTime, type AvailabilityTimesQuery, type Booking, type BookingAddon, type BookingAddonMoney, type BookingAddonOption, type BookingAddons, type BookingAddonsMutationResult, type BookingPaymentsOnFile, type BookingReadOptions, type BookingSearchBy, BookingService, type BookingServiceOptions, type BookingTimeRangeSearch, type CancelBookingResult, type Channel, type ClearOverridesInput, CngAccessService, type CngAccessServiceConfig, CngApiError, CngProductService, type CreateBookingGuest, type CreateBookingInput, type CreateBookingTicket, type CreateEngineInput, type CreatePromoCodeInput, type CreatedBooking, type CreatedPricingEngine, type CreatedPromoCode, type CustomQuestionAnswer, type DailyNote, DailyNoteService, type Duration, type Guest, type GuestMetadata, type Guide, type GuideAssignment, INSTALL_STATUSES, type InstallAccessConfig, type InstallAccessService, type InstallAccessTarget, type InstallStatus, type InstallWebhook, type InstallWebhookAccount, type InstallWebhookClaims, type InvoiceLinkResult, type Logger, type MakePaymentInput, type MakePaymentResult, type Membership, type MembershipPurchaseInput, MembershipService, type NoteMode, type Payment, type PaymentSource, PeekAccessService, type PeekAccessServiceConfig, type PeekAuthTokenClaims, type PeekAuthTokenUser, PeekGraphQLError, PeekHttpError, type PeekPlatform, PiiAccessDisabledError, type Price, type PricingActivityContext, type PricingEngine, type PricingMoney, type PricingNamedRef, type PricingOverride, type PricingOverrideFilter, PricingService, type Product, type ProductMeetingLocation, ProductService, type ProductServiceOptions, type ProductTicket, type PromoCode, type PromoCodeFixedAmount, PromoCodeService, type PromoCodeServiceOptions, type PurchasedMembership, RENTAL_PRODUCT_TYPE, RateLimitError, type RefundInput, type RefundResult, ResellerService, type ResolvedOverride, type ResolvedPricingOverride, type ResolvedResourceOption, type Resource, type ResourceOptionOverride, type ResourceOptionQuantity, type ResourcePool, type ResourcePoolAccountUser, type ResourcePoolAssignment, type ResourcePoolMode, ResourcePoolService, type Review, ReviewService, type Ticket, type Timeslot, type TimeslotFilter, TimeslotService, type UpdateEngineInput, type UpdateTimeslotResult, type UpsertOverridesInput, type UpsertOverridesResult, type Waiver, createAccessServiceForInstall, noopLogger, parseBookingWebhook, parseInstallWebhook, parseWaiverWebhook, verifyInstallWebhook };
+export { ACTIVITY_PRODUCT_TYPE, ADD_ON_PRODUCT_TYPE, type AccessOptions, type AccountUser, AccountUserService, type AccountUserServiceOptions, AcmeAccessService, type AcmeAccessServiceConfig, type AcmeActivity, type AcmeActivityTicket, AcmeApiError, AcmeProductService, type Activity, type ActivityOverrides, type ActivityTicket, type AddAddonInput, AdminAccountRequiredError, type Agent, type AssignGuideResult, type AssignedActivity, type AssignedResource, type Availability, AvailabilityService, type AvailabilityTime, type AvailabilityTimesQuery, type Booking, type BookingAddon, type BookingAddonMoney, type BookingAddonOption, type BookingAddons, type BookingAddonsMutationResult, type BookingPaymentsOnFile, type BookingReadOptions, type BookingSearchBy, BookingService, type BookingServiceOptions, type BookingTimeRangeSearch, type CancelBookingResult, type Channel, type ClearOverridesInput, CngAccessService, type CngAccessServiceConfig, CngApiError, CngProductService, type CreateBookingGuest, type CreateBookingInput, type CreateBookingTicket, type CreateEngineInput, type CreatePromoCodeInput, type CreatedBooking, type CreatedPricingEngine, type CreatedPromoCode, type CustomQuestion, type CustomQuestionAnswer, type CustomQuestionAnswerInput, type CustomQuestionOption, type DailyNote, DailyNoteService, type Duration, type Guest, type GuestMetadata, type Guide, type GuideAssignment, INSTALL_STATUSES, type InstallAccessConfig, type InstallAccessService, type InstallAccessTarget, type InstallStatus, type InstallWebhook, type InstallWebhookAccount, type InstallWebhookClaims, type InvoiceLinkResult, type Logger, type MakePaymentInput, type MakePaymentResult, type Membership, type MembershipPurchaseInput, MembershipService, type NoteMode, type Payment, type PaymentSource, PeekAccessService, type PeekAccessServiceConfig, type PeekAuthTokenClaims, type PeekAuthTokenUser, PeekGraphQLError, PeekHttpError, type PeekPlatform, PiiAccessDisabledError, type Price, type PricingActivityContext, type PricingEngine, type PricingMoney, type PricingNamedRef, type PricingOverride, type PricingOverrideFilter, PricingService, type Product, type ProductMeetingLocation, ProductService, type ProductServiceOptions, type ProductTicket, type PromoCode, type PromoCodeFixedAmount, PromoCodeService, type PromoCodeServiceOptions, type PurchasedMembership, RENTAL_PRODUCT_TYPE, RateLimitError, type RefundInput, type RefundResult, ResellerService, type ResolvedOverride, type ResolvedPricingOverride, type ResolvedResourceOption, type Resource, type ResourceOptionOverride, type ResourceOptionQuantity, type ResourcePool, type ResourcePoolAccountUser, type ResourcePoolAssignment, type ResourcePoolMode, ResourcePoolService, type Review, ReviewService, type Ticket, type Timeslot, type TimeslotFilter, TimeslotService, type UpdateEngineInput, type UpdateTimeslotResult, type UpsertOverridesInput, type UpsertOverridesResult, type Waiver, createAccessServiceForInstall, noopLogger, parseBookingWebhook, parseInstallWebhook, parseWaiverWebhook, verifyInstallWebhook };

package/dist/index.d.ts

@@ -421,6 +421,64 @@ declare const RENTAL_PRODUCT_TYPE = "RENTAL";
  */
 declare const ADD_ON_PRODUCT_TYPE = "ADD-ON";
 
+/**
+ * The clean, transport-agnostic data model for an activity's custom questions.
+ *
+ * Custom questions are the operator-configured questions attached to a bookable
+ * activity (per-guest waiver-style prompts, free-text inputs, multiple-choice
+ * pickers, etc.). This is the shape consumers work with — it is decoupled from
+ * the underlying Peek GraphQL `Question`/`ChoiceQuestion` schema, which stays
+ * internal.
+ *
+ * Note: this describes the **question definitions** on an activity, not any
+ * customer's answers — so there is no PII here and nothing gated behind
+ * `fullCustomerAccess`.
+ */
+/**
+ * A single custom question configured on an activity.
+ *
+ * The ordering and requiredness come from the activity's question
+ * configuration; the remaining fields describe the reusable question itself.
+ */
+interface CustomQuestion {
+    /** Unique identifier of the question (e.g. `"cq_anq67"`). */
+    id: string;
+    /** 1-based position of the question within the activity's question list. */
+    order: number;
+    /** Whether the activity requires an answer to this question. */
+    isRequired: boolean;
+    /** The question prompt shown to the guest (Peek's `text`). */
+    questionText: string;
+    /** Helper/hint text shown alongside the prompt, or `null` when none. */
+    hintText: string | null;
+    /**
+     * The question's input type as reported by Peek — e.g. `"CHECK_BOX"`,
+     * `"TEXT"`, `"LOCATION"`, `"SELECT_ONE"`. Left as a string so new Peek
+     * question types flow through without a package change.
+     */
+    questionType: string;
+    /** Operator-only label for the question, or `null` when none. */
+    internalLabel: string | null;
+    /** `true` when the question is answered once per guest rather than per booking. */
+    perGuest: boolean;
+    /** Pre-filled default answer, or `null` when none. */
+    defaultValue: string | null;
+    /**
+     * Selectable options for choice-style questions (`SELECT_ONE`, `LOCATION`,
+     * …). Empty for free-text/checkbox questions that carry no options.
+     */
+    options: CustomQuestionOption[];
+}
+/** A single selectable option on a choice-style {@link CustomQuestion}. */
+interface CustomQuestionOption {
+    /** Unique identifier of the option (e.g. `"cqao_mwdgvw"`). */
+    id: string;
+    /** 1-based position of the option within the question's option list. */
+    order: number;
+    /** The option's display label (Peek's `text`). */
+    value: string;
+}
+
 /** Tuning options for a {@link ProductService}. */
 interface ProductServiceOptions {
     /** Page size for cursor-paginated item options. Default: 50. */
@@ -451,6 +509,21 @@ declare class ProductService {
     getAllRentals(): Promise<Product[]>;
     /** Returns only add-on products. */
     getAllAddons(): Promise<Product[]>;
+    /**
+     * Returns every custom question configured on a single activity, in the order
+     * Peek reports them. Choice-style questions (`SELECT_ONE`, `LOCATION`, …)
+     * carry their selectable {@link CustomQuestion.options}; free-text/checkbox
+     * questions return an empty option list.
+     *
+     * These are question **definitions**, not customer answers — no PII is
+     * involved, so the result is unaffected by `fullCustomerAccess`.
+     *
+     * @param productId The activity's id.
+     * @returns The activity's custom questions, or an empty list when the activity
+     *   has none or is not found.
+     * @throws Error when `productId` is missing or blank.
+     */
+    getCustomQuestions(productId: string): Promise<CustomQuestion[]>;
     private fetchActivities;
     private fetchAllItemOptionNodes;
 }
@@ -773,6 +846,34 @@ interface CreateBookingGuest {
     optinMarketing?: boolean;
     optinSms?: boolean;
 }
+/**
+ * An answer to one of an activity's custom questions, supplied when creating a
+ * booking. The question is identified by id **or** text, and the value is
+ * resolved against the question's type at create time (see
+ * {@link CreateBookingInput.customQuestionAnswers}).
+ */
+interface CustomQuestionAnswerInput {
+    /**
+     * The question to answer — either its id (`cq_…`) or its question text. Text
+     * is matched leniently (lowercased, non-alphanumerics stripped); it must match
+     * exactly one question or creation fails.
+     */
+    questionIdOrText: string;
+    /**
+     * The answer. How it is interpreted depends on the question's type:
+     * - **checkbox** — `yes`/`no`/`true`/`false` (case-insensitive).
+     * - **text** — used verbatim.
+     * - **select-one / location** — an option id (`cqao_…`) or the option's label,
+     *   matched leniently the same way as `questionIdOrText`.
+     *
+     * For **location** questions you only select the option — Peek holds each
+     * option's configured lat/long and applies it, so no coordinates are (or can
+     * be) supplied here.
+     *
+     * Per-guest questions are **not yet supported**: answering one fails creation.
+     */
+    value: string;
+}
 /**
  * Input for creating a booking. IDs must already be resolved — the package does
  * not do free-text product/ticket/time matching (that stays in the caller).
@@ -788,6 +889,21 @@ interface CreateBookingInput {
     guest: CreateBookingGuest;
     /** Operator notes to attach. */
     operatorNotes?: string;
+    /**
+     * Answers to the activity's custom questions. When non-empty, the activity's
+     * custom questions are fetched and each answer is validated/resolved before
+     * the booking is created — an unmatched question, ambiguous text/option, or
+     * invalid checkbox value fails creation before any quote is made.
+     */
+    customQuestionAnswers?: CustomQuestionAnswerInput[];
+    /**
+     * When `true`, creation fails if any of the activity's required custom
+     * questions (per-guest questions excluded) is left unanswered. Because this
+     * enforces coverage against the activity's questions, it forces custom-question
+     * validation to run even when `customQuestionAnswers` is empty or omitted.
+     * Default: `false`.
+     */
+    requireRequiredQuestions?: boolean;
     /** Suppress the customer confirmation email. Default: false. */
     skipCustomerEmail?: boolean;
     /** Clone the quote from an existing order. */
@@ -1160,10 +1276,18 @@ declare class BookingService {
      *
      * @throws {Error} when `activityId`, `availabilityTimeId`, a ticket
      * `resourceOptionId`/positive `quantity`, or the guest `name` is missing; when
-     * `markAsPaid` is set without an `idempotencyKey`; or when the quote/order
-     * mutations fail.
+     * `markAsPaid` is set without an `idempotencyKey`; when
+     * `requireRequiredQuestions` is set and a required custom question is left
+     * unanswered; or when the quote/order mutations fail.
      */
     create(input: CreateBookingInput): Promise<CreatedBooking>;
+    /**
+     * Resolves the input's custom-question answers into the quote's
+     * `questionAnswers` payload (each tagged with a fresh `refid`), or `null` when
+     * none were supplied. Fetches the activity's custom questions to validate
+     * against; throws on the first unmatched/ambiguous/invalid answer.
+     */
+    private buildQuestionAnswers;
     private markCreatedBookingPaid;
     /** Finds the parent item id of an add-on by matching its option id. */
     private resolveParentItemId;
@@ -2062,6 +2186,8 @@ declare class PeekAccessService {
     getAllRentals(): Promise<Product[]>;
     /** All add-on products. Delegates to {@link ProductService.getAllAddons}. */
     getAllAddons(): Promise<Product[]>;
+    /** An activity's custom questions. Delegates to {@link ProductService.getCustomQuestions}. */
+    getCustomQuestions(productId: string): Promise<CustomQuestion[]>;
     /** All active account users. Delegates to {@link AccountUserService.getAll}. */
     getAllAccountUsers(): Promise<AccountUser[]>;
     /** Account user by id, or null. Delegates to {@link AccountUserService.getById}. */
@@ -2836,4 +2962,4 @@ declare class AcmeApiError extends Error {
     constructor(statusCode: number, body: unknown, message?: string);
 }
 
-export { ACTIVITY_PRODUCT_TYPE, ADD_ON_PRODUCT_TYPE, type AccessOptions, type AccountUser, AccountUserService, type AccountUserServiceOptions, AcmeAccessService, type AcmeAccessServiceConfig, type AcmeActivity, type AcmeActivityTicket, AcmeApiError, AcmeProductService, type Activity, type ActivityOverrides, type ActivityTicket, type AddAddonInput, AdminAccountRequiredError, type Agent, type AssignGuideResult, type AssignedActivity, type AssignedResource, type Availability, AvailabilityService, type AvailabilityTime, type AvailabilityTimesQuery, type Booking, type BookingAddon, type BookingAddonMoney, type BookingAddonOption, type BookingAddons, type BookingAddonsMutationResult, type BookingPaymentsOnFile, type BookingReadOptions, type BookingSearchBy, BookingService, type BookingServiceOptions, type BookingTimeRangeSearch, type CancelBookingResult, type Channel, type ClearOverridesInput, CngAccessService, type CngAccessServiceConfig, CngApiError, CngProductService, type CreateBookingGuest, type CreateBookingInput, type CreateBookingTicket, type CreateEngineInput, type CreatePromoCodeInput, type CreatedBooking, type CreatedPricingEngine, type CreatedPromoCode, type CustomQuestionAnswer, type DailyNote, DailyNoteService, type Duration, type Guest, type GuestMetadata, type Guide, type GuideAssignment, INSTALL_STATUSES, type InstallAccessConfig, type InstallAccessService, type InstallAccessTarget, type InstallStatus, type InstallWebhook, type InstallWebhookAccount, type InstallWebhookClaims, type InvoiceLinkResult, type Logger, type MakePaymentInput, type MakePaymentResult, type Membership, type MembershipPurchaseInput, MembershipService, type NoteMode, type Payment, type PaymentSource, PeekAccessService, type PeekAccessServiceConfig, type PeekAuthTokenClaims, type PeekAuthTokenUser, PeekGraphQLError, PeekHttpError, type PeekPlatform, PiiAccessDisabledError, type Price, type PricingActivityContext, type PricingEngine, type PricingMoney, type PricingNamedRef, type PricingOverride, type PricingOverrideFilter, PricingService, type Product, type ProductMeetingLocation, ProductService, type ProductServiceOptions, type ProductTicket, type PromoCode, type PromoCodeFixedAmount, PromoCodeService, type PromoCodeServiceOptions, type PurchasedMembership, RENTAL_PRODUCT_TYPE, RateLimitError, type RefundInput, type RefundResult, ResellerService, type ResolvedOverride, type ResolvedPricingOverride, type ResolvedResourceOption, type Resource, type ResourceOptionOverride, type ResourceOptionQuantity, type ResourcePool, type ResourcePoolAccountUser, type ResourcePoolAssignment, type ResourcePoolMode, ResourcePoolService, type Review, ReviewService, type Ticket, type Timeslot, type TimeslotFilter, TimeslotService, type UpdateEngineInput, type UpdateTimeslotResult, type UpsertOverridesInput, type UpsertOverridesResult, type Waiver, createAccessServiceForInstall, noopLogger, parseBookingWebhook, parseInstallWebhook, parseWaiverWebhook, verifyInstallWebhook };
+export { ACTIVITY_PRODUCT_TYPE, ADD_ON_PRODUCT_TYPE, type AccessOptions, type AccountUser, AccountUserService, type AccountUserServiceOptions, AcmeAccessService, type AcmeAccessServiceConfig, type AcmeActivity, type AcmeActivityTicket, AcmeApiError, AcmeProductService, type Activity, type ActivityOverrides, type ActivityTicket, type AddAddonInput, AdminAccountRequiredError, type Agent, type AssignGuideResult, type AssignedActivity, type AssignedResource, type Availability, AvailabilityService, type AvailabilityTime, type AvailabilityTimesQuery, type Booking, type BookingAddon, type BookingAddonMoney, type BookingAddonOption, type BookingAddons, type BookingAddonsMutationResult, type BookingPaymentsOnFile, type BookingReadOptions, type BookingSearchBy, BookingService, type BookingServiceOptions, type BookingTimeRangeSearch, type CancelBookingResult, type Channel, type ClearOverridesInput, CngAccessService, type CngAccessServiceConfig, CngApiError, CngProductService, type CreateBookingGuest, type CreateBookingInput, type CreateBookingTicket, type CreateEngineInput, type CreatePromoCodeInput, type CreatedBooking, type CreatedPricingEngine, type CreatedPromoCode, type CustomQuestion, type CustomQuestionAnswer, type CustomQuestionAnswerInput, type CustomQuestionOption, type DailyNote, DailyNoteService, type Duration, type Guest, type GuestMetadata, type Guide, type GuideAssignment, INSTALL_STATUSES, type InstallAccessConfig, type InstallAccessService, type InstallAccessTarget, type InstallStatus, type InstallWebhook, type InstallWebhookAccount, type InstallWebhookClaims, type InvoiceLinkResult, type Logger, type MakePaymentInput, type MakePaymentResult, type Membership, type MembershipPurchaseInput, MembershipService, type NoteMode, type Payment, type PaymentSource, PeekAccessService, type PeekAccessServiceConfig, type PeekAuthTokenClaims, type PeekAuthTokenUser, PeekGraphQLError, PeekHttpError, type PeekPlatform, PiiAccessDisabledError, type Price, type PricingActivityContext, type PricingEngine, type PricingMoney, type PricingNamedRef, type PricingOverride, type PricingOverrideFilter, PricingService, type Product, type ProductMeetingLocation, ProductService, type ProductServiceOptions, type ProductTicket, type PromoCode, type PromoCodeFixedAmount, PromoCodeService, type PromoCodeServiceOptions, type PurchasedMembership, RENTAL_PRODUCT_TYPE, RateLimitError, type RefundInput, type RefundResult, ResellerService, type ResolvedOverride, type ResolvedPricingOverride, type ResolvedResourceOption, type Resource, type ResourceOptionOverride, type ResourceOptionQuantity, type ResourcePool, type ResourcePoolAccountUser, type ResourcePoolAssignment, type ResourcePoolMode, ResourcePoolService, type Review, ReviewService, type Ticket, type Timeslot, type TimeslotFilter, TimeslotService, type UpdateEngineInput, type UpdateTimeslotResult, type UpsertOverridesInput, type UpsertOverridesResult, type Waiver, createAccessServiceForInstall, noopLogger, parseBookingWebhook, parseInstallWebhook, parseWaiverWebhook, verifyInstallWebhook };

package/dist/index.js

@@ -1039,6 +1039,107 @@ function toBookingAddon(item) {
   return { addonId, addonName, total: item.total, addonOptions };
 }
 
+// src/internal/peek/bookings/custom-question-answer.ts
+var QUESTION_TYPE_CHECK_BOX = "CHECK_BOX";
+var QUESTION_TYPE_TEXT = "TEXT";
+var QUESTION_TYPE_SELECT_ONE = "SELECT_ONE";
+var QUESTION_TYPE_LOCATION = "LOCATION";
+var QUESTION_ID_REGEX = /^cq_[a-z0-9]+$/;
+var OPTION_ID_REGEX = /^cqao_[a-z0-9]+$/;
+var CHECKBOX_TRUE = /* @__PURE__ */ new Set(["yes", "true"]);
+var CHECKBOX_VALID = /* @__PURE__ */ new Set(["yes", "no", "true", "false"]);
+var CHECKBOX_TEXT_TRUE = "Yes";
+var CHECKBOX_TEXT_FALSE = "No";
+var errUnknownQuestionId = (v) => `No custom question matches id "${v}" for this activity`;
+var errNoTextMatch = (v) => `No custom question matches text "${v}" for this activity`;
+var errAmbiguousText = (v) => `Custom question text "${v}" matches more than one question`;
+var errPerGuestUnsupported = (id) => `Per-guest custom question "${id}" is not yet supported`;
+var errUnsupportedType = (type, id) => `Custom question "${id}" has unsupported type "${type}"`;
+var errInvalidCheckbox = (v, id) => `Checkbox answer for question "${id}" must be yes/no/true/false, got "${v}"`;
+var errUnknownOptionId = (v, id) => `No option matches id "${v}" for question "${id}"`;
+var errNoOptionMatch = (v, id) => `No option matches "${v}" for question "${id}"`;
+var errAmbiguousOption = (v, id) => `Option "${v}" matches more than one option for question "${id}"`;
+var errMissingRequired = (text, id) => `Custom question "${text}" (${id}) is required but was not answered`;
+function normalize(value) {
+  return value.toLowerCase().replace(/[^a-z0-9]/g, "");
+}
+function resolveQuestion(idOrText, questions) {
+  if (QUESTION_ID_REGEX.test(idOrText)) {
+    const byId = questions.find((question) => question.id === idOrText);
+    if (!byId) throw new Error(errUnknownQuestionId(idOrText));
+    return byId;
+  }
+  const target = normalize(idOrText);
+  const matches = questions.filter(
+    (question) => normalize(question.questionText) === target
+  );
+  if (matches.length === 0) throw new Error(errNoTextMatch(idOrText));
+  if (matches.length > 1) throw new Error(errAmbiguousText(idOrText));
+  return matches[0];
+}
+function resolveOption(value, question) {
+  if (OPTION_ID_REGEX.test(value)) {
+    const byId = question.options.find((option) => option.id === value);
+    if (!byId) throw new Error(errUnknownOptionId(value, question.id));
+    return byId;
+  }
+  const target = normalize(value);
+  const matches = question.options.filter(
+    (option) => normalize(option.value) === target
+  );
+  if (matches.length === 0) throw new Error(errNoOptionMatch(value, question.id));
+  if (matches.length > 1) throw new Error(errAmbiguousOption(value, question.id));
+  return matches[0];
+}
+function resolveOne(answer, questions) {
+  const question = resolveQuestion(answer.questionIdOrText, questions);
+  if (question.perGuest) {
+    throw new Error(errPerGuestUnsupported(question.id));
+  }
+  switch (question.questionType) {
+    case QUESTION_TYPE_CHECK_BOX: {
+      const normalized = answer.value.trim().toLowerCase();
+      if (!CHECKBOX_VALID.has(normalized)) {
+        throw new Error(errInvalidCheckbox(answer.value, question.id));
+      }
+      const isChecked = CHECKBOX_TRUE.has(normalized);
+      return {
+        questionId: question.id,
+        isChecked,
+        questionAnswerText: isChecked ? CHECKBOX_TEXT_TRUE : CHECKBOX_TEXT_FALSE
+      };
+    }
+    case QUESTION_TYPE_TEXT:
+      return { questionId: question.id, questionAnswerText: answer.value };
+    case QUESTION_TYPE_SELECT_ONE:
+    case QUESTION_TYPE_LOCATION: {
+      const option = resolveOption(answer.value, question);
+      return {
+        questionId: question.id,
+        questionAnswerOptionId: option.id,
+        questionAnswerText: option.value
+      };
+    }
+    default:
+      throw new Error(errUnsupportedType(question.questionType, question.id));
+  }
+}
+function resolveCustomQuestionAnswers(answers, questions, options) {
+  const resolved = answers.map((answer) => resolveOne(answer, questions));
+  if (options?.requireRequired) {
+    assertRequiredAnswered(resolved, questions);
+  }
+  return resolved;
+}
+function assertRequiredAnswered(resolved, questions) {
+  const answered = new Set(resolved.map((answer) => answer.questionId));
+  for (const question of questions) {
+    if (question.isRequired && !question.perGuest && !answered.has(question.id)) {
+      throw new Error(errMissingRequired(question.questionText, question.id));
+    }
+  }
+}
+
 // src/internal/peek/bookings/booking-service.ts
 var DEFAULT_PAGE_SIZE2 = 50;
 var DEFAULT_CANCEL_NOTE = "Canceled";
@@ -1553,11 +1654,13 @@ ${note}`;
    *
    * @throws {Error} when `activityId`, `availabilityTimeId`, a ticket
    * `resourceOptionId`/positive `quantity`, or the guest `name` is missing; when
-   * `markAsPaid` is set without an `idempotencyKey`; or when the quote/order
-   * mutations fail.
+   * `markAsPaid` is set without an `idempotencyKey`; when
+   * `requireRequiredQuestions` is set and a required custom question is left
+   * unanswered; or when the quote/order mutations fail.
    */
   async create(input) {
     validateCreateInput(input);
+    const questionAnswers = await this.buildQuestionAnswers(input);
     const tickets = input.tickets.flatMap(
       (ticket) => Array.from({ length: ticket.quantity }, () => ({
         resourceOptionId: ticket.resourceOptionId,
@@ -1584,6 +1687,9 @@ ${note}`;
     if (input.operatorNotes) {
       bookingQuote.operatorNotes = input.operatorNotes;
     }
+    if (questionAnswers) {
+      bookingQuote.questionAnswers = questionAnswers;
+    }
     const quoteInput = { bookingQuotes: [bookingQuote] };
     if (input.parentOrderId) {
       quoteInput.source = { clonedFromId: input.parentOrderId };
@@ -1623,6 +1729,32 @@ ${note}`;
     }
     return created;
   }
+  /**
+   * Resolves the input's custom-question answers into the quote's
+   * `questionAnswers` payload (each tagged with a fresh `refid`), or `null` when
+   * none were supplied. Fetches the activity's custom questions to validate
+   * against; throws on the first unmatched/ambiguous/invalid answer.
+   */
+  async buildQuestionAnswers(input) {
+    const answers = input.customQuestionAnswers ?? [];
+    const requireRequired = input.requireRequiredQuestions ?? false;
+    if (answers.length === 0 && !requireRequired) {
+      return null;
+    }
+    const questions = await this.deps.productService.getCustomQuestions(
+      input.activityId
+    );
+    const resolved = resolveCustomQuestionAnswers(answers, questions, {
+      requireRequired
+    });
+    if (resolved.length === 0) {
+      return null;
+    }
+    return resolved.map((answer) => ({
+      ...answer,
+      refid: randomUUID()
+    }));
+  }
   async markCreatedBookingPaid(booking, input) {
     const parsedPartial = input.markAsPaidAmount ? parseFloat(input.markAsPaidAmount) : NaN;
     const amount = !Number.isNaN(parsedPartial) && parsedPartial > 0 ? parsedPartial.toFixed(2) : booking.balanceAmount;
@@ -2935,6 +3067,33 @@ function fromItemOptionNodes(nodes) {
   return Array.from(grouped.values());
 }
 
+// src/internal/peek/products/custom-question-converter.ts
+function fromQuestionConfigurations(configs) {
+  return configs.map(fromQuestionConfiguration);
+}
+function fromQuestionConfiguration(config) {
+  const question = config.question;
+  return {
+    id: question.id,
+    order: config.order ?? 0,
+    isRequired: config.isRequired ?? false,
+    questionText: question.text,
+    hintText: question.hint ?? null,
+    questionType: question.questionType,
+    internalLabel: question.internalLabel ?? null,
+    perGuest: question.perGuest ?? false,
+    defaultValue: question.answerDefaultValue ?? null,
+    options: (question.options ?? []).map(fromQuestionOption)
+  };
+}
+function fromQuestionOption(option) {
+  return {
+    id: option.id,
+    order: option.order,
+    value: option.text
+  };
+}
+
 // src/internal/peek/products/product-queries.ts
 var PRODUCTS_QUERY = `
   query Sales {
@@ -2993,7 +3152,38 @@ var ITEM_OPTIONS_QUERY = `
   }
 `;
 
+// src/internal/peek/products/custom-question-queries.ts
+var CUSTOM_QUESTIONS_QUERY = `
+  query Sales($id: ID!) {
+    activity(id: $id) {
+      id
+      name
+      questionActivityConfigurations {
+        isRequired
+        order
+        question {
+          id
+          questionType
+          text
+          answerDefaultValue
+          hint
+          internalLabel
+          perGuest
+          ... on ChoiceQuestion {
+            options {
+              id
+              text
+              order
+            }
+          }
+        }
+      }
+    }
+  }
+`;
+
 // src/internal/peek/products/product-service.ts
+var ERROR_PRODUCT_ID_REQUIRED2 = "A non-empty product id is required.";
 var DEFAULT_ITEM_OPTIONS_PAGE_SIZE = 50;
 var ProductService = class {
   constructor(client, options = {}) {
@@ -3038,6 +3228,32 @@ var ProductService = class {
     const nodes = await this.fetchAllItemOptionNodes();
     return fromItemOptionNodes(nodes);
   }
+  /**
+   * Returns every custom question configured on a single activity, in the order
+   * Peek reports them. Choice-style questions (`SELECT_ONE`, `LOCATION`, …)
+   * carry their selectable {@link CustomQuestion.options}; free-text/checkbox
+   * questions return an empty option list.
+   *
+   * These are question **definitions**, not customer answers — no PII is
+   * involved, so the result is unaffected by `fullCustomerAccess`.
+   *
+   * @param productId The activity's id.
+   * @returns The activity's custom questions, or an empty list when the activity
+   *   has none or is not found.
+   * @throws Error when `productId` is missing or blank.
+   */
+  async getCustomQuestions(productId) {
+    if (!productId?.trim()) {
+      throw new Error(ERROR_PRODUCT_ID_REQUIRED2);
+    }
+    const body = await this.client.request(
+      SALES_ENDPOINT,
+      CUSTOM_QUESTIONS_QUERY,
+      { id: productId }
+    );
+    const configs = body.data?.activity?.questionActivityConfigurations ?? [];
+    return fromQuestionConfigurations(configs);
+  }
   async fetchActivities() {
     const body = await this.client.request(
       SALES_ENDPOINT,
@@ -3751,6 +3967,10 @@ var PeekAccessService = class {
   getAllAddons() {
     return this.getProductService().getAllAddons();
   }
+  /** An activity's custom questions. Delegates to {@link ProductService.getCustomQuestions}. */
+  getCustomQuestions(productId) {
+    return this.getProductService().getCustomQuestions(productId);
+  }
   // ─── Account-user short-forms ─────────────────────────────────────────────
   /** All active account users. Delegates to {@link AccountUserService.getAll}. */
   getAllAccountUsers() {