@peektravel/app-utilities 0.9.4 → 1.0.0

package/dist/index.d.cts

@@ -1932,6 +1932,37 @@ declare class AvailabilityService {
     getAvailabilityTimes(query: AvailabilityTimesQuery): Promise<AvailabilityTime[]>;
 }
 
+/**
+ * Reads custom questions defined on the account.
+ *
+ * Obtain an instance via {@link PeekAccessService.getCustomQuestionService}.
+ */
+declare class CustomQuestionService {
+    private readonly client;
+    constructor(client: GraphQLClient);
+    /**
+     * Returns every custom question defined on the account, across all
+     * activities. Choice-style questions (`SELECT_ONE`, `LOCATION`, …) carry their
+     * selectable {@link CustomQuestion.options}; free-text/checkbox questions
+     * return an empty option list.
+     *
+     * These are account-wide question **definitions**, not customer answers — no
+     * PII is involved, so the result is unaffected by `fullCustomerAccess`. Unlike
+     * {@link ProductService.getCustomQuestions}, the catalog carries no
+     * per-activity configuration, so {@link CustomQuestion.order} is `0` and
+     * {@link CustomQuestion.isRequired} is `false` on every entry.
+     *
+     * @returns Every custom question on the account, or an empty list when none
+     *   are defined.
+     *
+     * @example
+     * ```ts
+     * const questions = await peek.getCustomQuestionService().getAll();
+     * ```
+     */
+    getAll(): Promise<CustomQuestion[]>;
+}
+
 /**
  * The clean data model for a Peek Pro daily (dashboard) note.
  */
@@ -1980,6 +2011,15 @@ interface BaseAccessServiceConfig {
      * way to target an install — prefer it over `baseUrl`/`appId`, which are
      * deprecated (the hardcoded base-URL fallbacks will be removed and a URL will
      * become required in a future release).
+     *
+     * For Peek `mode: "v2"` this field is **required** (the constructor throws
+     * without it). If you do not yet have a webhook `apiUrl` — e.g. an install that
+     * predates webhook `apiUrl` delivery, which you don't want to uninstall /
+     * reinstall just to obtain one — build one by appending your **app slug** to
+     * the registry prefix and pass that here:
+     * `https://apps.peek.com/installations-api/<app-slug>` (the trailing app-slug
+     * segment is required — the prefix alone is not a valid URL). Treat that as a
+     * transitional bridge and prefer the `apiUrl` the install webhook delivers.
      */
     apiUrl?: string;
     /**
@@ -2378,15 +2418,35 @@ interface InstallWebhookClaims {
  * Peek-specific extras below.
  */
 interface PeekAccessServiceConfig extends BaseAccessServiceConfig {
-    /** API gateway key, sent as the `pk-api-key` header. Required in v1 mode; not used in v2. */
-    gatewayKey?: string;
     /**
-     * Gateway mode. `"v2"` routes through the app-registry installations API
-     * (`baseUrl/appId/peek_backoffice_api-v1/endpointName`) and defaults to the
-     * app-registry sandbox base URL. `"v1"` (default) uses the standard backoffice
-     * GraphQL gateway.
+     * API gateway key, sent as the `pk-api-key` header. Required in `"v1"` mode
+     * (unless an `apiUrl` is supplied); not used in `"v2"`.
      */
-    mode?: "v2";
+    gatewayKey?: string;
+    /**
+     * Which connection generation to use. **Required — choose explicitly.**
+     *
+     * This field used to be optional, and omitting it meant `"v1"`. It is now
+     * mandatory so that updating the package forces a deliberate choice instead of
+     * silently keeping the old behaviour. If your install used the previous
+     * default, the fastest no-behaviour-change update is to pass `mode: "v1"`.
+     *
+     * - `"v2"` — **use this going forward.** Routes through the app-registry
+     *   installations API. It **requires** the install's **`apiUrl`**: the
+     *   per-install base URL delivered on the install webhook (`api.url`), which you
+     *   persist and pass as `apiUrl`. The constructor throws if it is missing —
+     *   there is no silent default. If you do not have a webhook `apiUrl` yet, build
+     *   one by appending your **app slug** to the registry prefix and pass that
+     *   yourself — `https://apps.peek.com/installations-api/<app-slug>` (same shape
+     *   as the webhook's `api.url`; the trailing app-slug segment is required, the
+     *   prefix alone is not a valid URL). Treat it as a transitional bridge and
+     *   prefer the webhook URL. No `gatewayKey` is needed (the registry
+     *   authenticates on the JWT alone).
+     * - `"v1"` — **deprecated; will be removed.** The legacy backoffice GraphQL
+     *   gateway; requires `gatewayKey`. Retained only so existing installs can
+     *   update with no immediate behaviour change. Migrate to `"v2"`.
+     */
+    mode: "v1" | "v2";
     /** Page size for cursor-paginated item options. Default: 50. */
     itemOptionsPageSize?: number;
 }
@@ -2402,20 +2462,28 @@ interface PeekAccessServiceConfig extends BaseAccessServiceConfig {
  * ```ts
  * import { PeekAccessService, type Product } from "@peektravel/app-utilities";
  *
+ * // "v2" (recommended) — registry connection, targeted by the install
+ * // webhook's apiUrl; no gatewayKey needed:
  * const peek = new PeekAccessService({
  *   installId: "install-123",            // JWT subject
  *   jwtSecret: process.env.PEEK_INTERNAL_SECRET!, // signs the JWT
  *   issuer: process.env.APP_NAME!,        // JWT issuer
- *   appId: process.env.PEEK_APP_ID!,      // gateway path segment
- *   gatewayKey: process.env.PEEK_GATEWAY_KEY!, // pk-api-key header
+ *   mode: "v2",                           // connection generation (required)
+ *   apiUrl: install.apiUrl,               // persisted from the install webhook
  * });
  *
+ * // "v1" (deprecated) — legacy gateway; the fastest update for installs that
+ * // relied on the old default:
+ * //   new PeekAccessService({ installId, jwtSecret, issuer, appId, gatewayKey, mode: "v1" })
+ *
  * const products: Product[] = await peek.getProductService().getAllProducts();
  * const booking = await peek.getBookingService().getById("b_abc123");
  * ```
  *
- * @throws {Error} from the constructor when any required config field
- * (`installId`, `jwtSecret`, `issuer`, `appId`, `gatewayKey`) is empty.
+ * @throws {Error} from the constructor when `mode` is missing or not `"v1"`/
+ * `"v2"`; when `"v2"` is selected without an `apiUrl`; or when any required
+ * config field is empty (`installId`, `jwtSecret`, `issuer`, and — in `"v1"`
+ * mode without an `apiUrl` — `appId` and `gatewayKey`).
  */
 declare class PeekAccessService {
     private readonly client;
@@ -2435,6 +2503,7 @@ declare class PeekAccessService {
     private membershipService?;
     private readonly bookingServices;
     private reviewService?;
+    private customQuestionService?;
     constructor(config: PeekAccessServiceConfig);
     /**
      * Verifies a Peek auth token issued by the app registry and returns the
@@ -2527,6 +2596,11 @@ declare class PeekAccessService {
      * authenticated transport. The instance is created lazily and reused.
      */
     getReviewService(): ReviewService;
+    /**
+     * Returns the {@link CustomQuestionService} for this install, bound to the
+     * shared authenticated transport. The instance is created lazily and reused.
+     */
+    getCustomQuestionService(): CustomQuestionService;
     /** All products (activities + add-ons). @deprecated The access service exposes only its resource-service accessors; call the service directly instead. See {@link ProductService.getAllProducts}. */
     getAllProducts(): Promise<Product[]>;
     /** All activity products (excludes add-ons). @deprecated The access service exposes only its resource-service accessors; call the service directly instead. See {@link ProductService.getAllActivities}. */
@@ -3325,4 +3399,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, CngPermissionError, 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 MetaData, type MetaDataBarcodeType, type MetaDataDurationUnit, type MetaDataValue, type MetaDataVolumeUnit, type MetaDataWeightUnit, 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, type ProductReviewSummary, 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 SetMetaDataAttachmentInput, type SetMetaDataGuestInput, type SetMetaDataResult, 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, CngPermissionError, 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, CustomQuestionService, 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 MetaData, type MetaDataBarcodeType, type MetaDataDurationUnit, type MetaDataValue, type MetaDataVolumeUnit, type MetaDataWeightUnit, 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, type ProductReviewSummary, 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 SetMetaDataAttachmentInput, type SetMetaDataGuestInput, type SetMetaDataResult, 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

@@ -1932,6 +1932,37 @@ declare class AvailabilityService {
     getAvailabilityTimes(query: AvailabilityTimesQuery): Promise<AvailabilityTime[]>;
 }
 
+/**
+ * Reads custom questions defined on the account.
+ *
+ * Obtain an instance via {@link PeekAccessService.getCustomQuestionService}.
+ */
+declare class CustomQuestionService {
+    private readonly client;
+    constructor(client: GraphQLClient);
+    /**
+     * Returns every custom question defined on the account, across all
+     * activities. Choice-style questions (`SELECT_ONE`, `LOCATION`, …) carry their
+     * selectable {@link CustomQuestion.options}; free-text/checkbox questions
+     * return an empty option list.
+     *
+     * These are account-wide question **definitions**, not customer answers — no
+     * PII is involved, so the result is unaffected by `fullCustomerAccess`. Unlike
+     * {@link ProductService.getCustomQuestions}, the catalog carries no
+     * per-activity configuration, so {@link CustomQuestion.order} is `0` and
+     * {@link CustomQuestion.isRequired} is `false` on every entry.
+     *
+     * @returns Every custom question on the account, or an empty list when none
+     *   are defined.
+     *
+     * @example
+     * ```ts
+     * const questions = await peek.getCustomQuestionService().getAll();
+     * ```
+     */
+    getAll(): Promise<CustomQuestion[]>;
+}
+
 /**
  * The clean data model for a Peek Pro daily (dashboard) note.
  */
@@ -1980,6 +2011,15 @@ interface BaseAccessServiceConfig {
      * way to target an install — prefer it over `baseUrl`/`appId`, which are
      * deprecated (the hardcoded base-URL fallbacks will be removed and a URL will
      * become required in a future release).
+     *
+     * For Peek `mode: "v2"` this field is **required** (the constructor throws
+     * without it). If you do not yet have a webhook `apiUrl` — e.g. an install that
+     * predates webhook `apiUrl` delivery, which you don't want to uninstall /
+     * reinstall just to obtain one — build one by appending your **app slug** to
+     * the registry prefix and pass that here:
+     * `https://apps.peek.com/installations-api/<app-slug>` (the trailing app-slug
+     * segment is required — the prefix alone is not a valid URL). Treat that as a
+     * transitional bridge and prefer the `apiUrl` the install webhook delivers.
      */
     apiUrl?: string;
     /**
@@ -2378,15 +2418,35 @@ interface InstallWebhookClaims {
  * Peek-specific extras below.
  */
 interface PeekAccessServiceConfig extends BaseAccessServiceConfig {
-    /** API gateway key, sent as the `pk-api-key` header. Required in v1 mode; not used in v2. */
-    gatewayKey?: string;
     /**
-     * Gateway mode. `"v2"` routes through the app-registry installations API
-     * (`baseUrl/appId/peek_backoffice_api-v1/endpointName`) and defaults to the
-     * app-registry sandbox base URL. `"v1"` (default) uses the standard backoffice
-     * GraphQL gateway.
+     * API gateway key, sent as the `pk-api-key` header. Required in `"v1"` mode
+     * (unless an `apiUrl` is supplied); not used in `"v2"`.
      */
-    mode?: "v2";
+    gatewayKey?: string;
+    /**
+     * Which connection generation to use. **Required — choose explicitly.**
+     *
+     * This field used to be optional, and omitting it meant `"v1"`. It is now
+     * mandatory so that updating the package forces a deliberate choice instead of
+     * silently keeping the old behaviour. If your install used the previous
+     * default, the fastest no-behaviour-change update is to pass `mode: "v1"`.
+     *
+     * - `"v2"` — **use this going forward.** Routes through the app-registry
+     *   installations API. It **requires** the install's **`apiUrl`**: the
+     *   per-install base URL delivered on the install webhook (`api.url`), which you
+     *   persist and pass as `apiUrl`. The constructor throws if it is missing —
+     *   there is no silent default. If you do not have a webhook `apiUrl` yet, build
+     *   one by appending your **app slug** to the registry prefix and pass that
+     *   yourself — `https://apps.peek.com/installations-api/<app-slug>` (same shape
+     *   as the webhook's `api.url`; the trailing app-slug segment is required, the
+     *   prefix alone is not a valid URL). Treat it as a transitional bridge and
+     *   prefer the webhook URL. No `gatewayKey` is needed (the registry
+     *   authenticates on the JWT alone).
+     * - `"v1"` — **deprecated; will be removed.** The legacy backoffice GraphQL
+     *   gateway; requires `gatewayKey`. Retained only so existing installs can
+     *   update with no immediate behaviour change. Migrate to `"v2"`.
+     */
+    mode: "v1" | "v2";
     /** Page size for cursor-paginated item options. Default: 50. */
     itemOptionsPageSize?: number;
 }
@@ -2402,20 +2462,28 @@ interface PeekAccessServiceConfig extends BaseAccessServiceConfig {
  * ```ts
  * import { PeekAccessService, type Product } from "@peektravel/app-utilities";
  *
+ * // "v2" (recommended) — registry connection, targeted by the install
+ * // webhook's apiUrl; no gatewayKey needed:
  * const peek = new PeekAccessService({
  *   installId: "install-123",            // JWT subject
  *   jwtSecret: process.env.PEEK_INTERNAL_SECRET!, // signs the JWT
  *   issuer: process.env.APP_NAME!,        // JWT issuer
- *   appId: process.env.PEEK_APP_ID!,      // gateway path segment
- *   gatewayKey: process.env.PEEK_GATEWAY_KEY!, // pk-api-key header
+ *   mode: "v2",                           // connection generation (required)
+ *   apiUrl: install.apiUrl,               // persisted from the install webhook
  * });
  *
+ * // "v1" (deprecated) — legacy gateway; the fastest update for installs that
+ * // relied on the old default:
+ * //   new PeekAccessService({ installId, jwtSecret, issuer, appId, gatewayKey, mode: "v1" })
+ *
  * const products: Product[] = await peek.getProductService().getAllProducts();
  * const booking = await peek.getBookingService().getById("b_abc123");
  * ```
  *
- * @throws {Error} from the constructor when any required config field
- * (`installId`, `jwtSecret`, `issuer`, `appId`, `gatewayKey`) is empty.
+ * @throws {Error} from the constructor when `mode` is missing or not `"v1"`/
+ * `"v2"`; when `"v2"` is selected without an `apiUrl`; or when any required
+ * config field is empty (`installId`, `jwtSecret`, `issuer`, and — in `"v1"`
+ * mode without an `apiUrl` — `appId` and `gatewayKey`).
  */
 declare class PeekAccessService {
     private readonly client;
@@ -2435,6 +2503,7 @@ declare class PeekAccessService {
     private membershipService?;
     private readonly bookingServices;
     private reviewService?;
+    private customQuestionService?;
     constructor(config: PeekAccessServiceConfig);
     /**
      * Verifies a Peek auth token issued by the app registry and returns the
@@ -2527,6 +2596,11 @@ declare class PeekAccessService {
      * authenticated transport. The instance is created lazily and reused.
      */
     getReviewService(): ReviewService;
+    /**
+     * Returns the {@link CustomQuestionService} for this install, bound to the
+     * shared authenticated transport. The instance is created lazily and reused.
+     */
+    getCustomQuestionService(): CustomQuestionService;
     /** All products (activities + add-ons). @deprecated The access service exposes only its resource-service accessors; call the service directly instead. See {@link ProductService.getAllProducts}. */
     getAllProducts(): Promise<Product[]>;
     /** All activity products (excludes add-ons). @deprecated The access service exposes only its resource-service accessors; call the service directly instead. See {@link ProductService.getAllActivities}. */
@@ -3325,4 +3399,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, CngPermissionError, 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 MetaData, type MetaDataBarcodeType, type MetaDataDurationUnit, type MetaDataValue, type MetaDataVolumeUnit, type MetaDataWeightUnit, 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, type ProductReviewSummary, 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 SetMetaDataAttachmentInput, type SetMetaDataGuestInput, type SetMetaDataResult, 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, CngPermissionError, 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, CustomQuestionService, 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 MetaData, type MetaDataBarcodeType, type MetaDataDurationUnit, type MetaDataValue, type MetaDataVolumeUnit, type MetaDataWeightUnit, 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, type ProductReviewSummary, 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 SetMetaDataAttachmentInput, type SetMetaDataGuestInput, type SetMetaDataResult, 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

@@ -2474,6 +2474,123 @@ function buildCancellation(items, addonOptionId, quantity) {
   return { bookingQuotes, canceledCount };
 }
 
+// src/internal/peek/custom-questions/custom-question-converter.ts
+function fromQuestionConfigurations(configs) {
+  return configs.map(
+    (config) => fromQuestionNode(config.question, config.order, config.isRequired)
+  );
+}
+function fromQuestionNodes(questions) {
+  return questions.map((question) => fromQuestionNode(question));
+}
+function fromQuestionNode(question, order, isRequired) {
+  return {
+    id: question.id,
+    order: order ?? 0,
+    isRequired: 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/custom-questions/custom-question-queries.ts
+var ALL_CUSTOM_QUESTIONS_QUERY = `
+  query Sales {
+    questions {
+      id
+      questionType
+      text
+      answerDefaultValue
+      hint
+      internalLabel
+      perGuest
+      ... on ChoiceQuestion {
+        options {
+          id
+          text
+          order
+        }
+      }
+    }
+  }
+`;
+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/custom-questions/custom-question-service.ts
+var CustomQuestionService = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Returns every custom question defined on the account, across all
+   * activities. Choice-style questions (`SELECT_ONE`, `LOCATION`, …) carry their
+   * selectable {@link CustomQuestion.options}; free-text/checkbox questions
+   * return an empty option list.
+   *
+   * These are account-wide question **definitions**, not customer answers — no
+   * PII is involved, so the result is unaffected by `fullCustomerAccess`. Unlike
+   * {@link ProductService.getCustomQuestions}, the catalog carries no
+   * per-activity configuration, so {@link CustomQuestion.order} is `0` and
+   * {@link CustomQuestion.isRequired} is `false` on every entry.
+   *
+   * @returns Every custom question on the account, or an empty list when none
+   *   are defined.
+   *
+   * @example
+   * ```ts
+   * const questions = await peek.getCustomQuestionService().getAll();
+   * ```
+   */
+  async getAll() {
+    const body = await this.client.request(
+      SALES_ENDPOINT,
+      ALL_CUSTOM_QUESTIONS_QUERY,
+      {}
+    );
+    return fromQuestionNodes(body.data?.questions ?? []);
+  }
+};
+
 // src/internal/peek/daily-notes/daily-note-converter.ts
 function toDailyNote(response) {
   const union = response?.dailyNote;
@@ -2652,7 +2769,7 @@ async function requestWithRetry(http, url, init, label, onResponse) {
 // src/internal/sdk-headers.ts
 var SDK_HEADER_NAME = "x-peek-sdk";
 var SDK_PLATFORM = "js";
-var SDK_VERSION = "0.9.4";
+var SDK_VERSION = "1.0.0";
 var SDK_HEADER_VALUE = `${SDK_PLATFORM}-${SDK_VERSION}`;
 
 // src/internal/peek/graphql-client.ts
@@ -3678,33 +3795,6 @@ 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 {
@@ -3763,36 +3853,6 @@ 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;
@@ -4352,7 +4412,9 @@ var noopLogger = {
 
 // src/peek-access-service.ts
 var DEFAULT_BASE_URL = "https://apps.peekapis.com/backoffice-gql";
-var DEFAULT_V2_BASE_URL = "https://app-registry.peeklabs.com/installations-api";
+var V2_FALLBACK_URL_PREFIX = "https://apps.peek.com/installations-api";
+var ERROR_MODE_REQUIRED = `PeekAccessService: "mode" is required and must be "v1" or "v2". Existing installs used the previous default of "v1" \u2014 pass mode: "v1" for the fastest update. Note: "v1" is deprecated and will be removed; migrate to "v2" and pass the install webhook's apiUrl.`;
+var ERROR_V2_API_URL_REQUIRED = `PeekAccessService: mode "v2" requires an "apiUrl" \u2014 the per-install URL delivered on the install webhook (api.url) and persisted per install. If you do not have one yet, append your app slug to the registry prefix and pass that, e.g. "${V2_FALLBACK_URL_PREFIX}/<app-slug>" (the trailing app-slug segment is required \u2014 the prefix alone is not a valid apiUrl).`;
 var PeekAccessService = class {
   client;
   productServiceOptions;
@@ -4371,21 +4433,27 @@ var PeekAccessService = class {
   membershipService;
   bookingServices = /* @__PURE__ */ new Map();
   reviewService;
+  customQuestionService;
   constructor(config) {
     const hasApiUrl = !!config.apiUrl;
+    if (config.mode !== "v1" && config.mode !== "v2") {
+      throw new Error(ERROR_MODE_REQUIRED);
+    }
     const isV2 = config.mode === "v2";
     requireNonEmpty(config.installId, "installId", "PeekAccessService");
     requireNonEmpty(config.jwtSecret, "jwtSecret", "PeekAccessService");
     requireNonEmpty(config.issuer, "issuer", "PeekAccessService");
-    if (!hasApiUrl) requireNonEmpty(config.appId ?? "", "appId", "PeekAccessService");
-    if (!hasApiUrl && !isV2) requireNonEmpty(config.gatewayKey ?? "", "gatewayKey", "PeekAccessService");
+    if (isV2 && !hasApiUrl) throw new Error(ERROR_V2_API_URL_REQUIRED);
+    if (!isV2 && !hasApiUrl) {
+      requireNonEmpty(config.appId ?? "", "appId", "PeekAccessService");
+      requireNonEmpty(config.gatewayKey ?? "", "gatewayKey", "PeekAccessService");
+    }
     this.jwtSecret = config.jwtSecret;
     this.issuer = config.issuer;
     const logger = config.logger ?? noopLogger;
     const tokens = createTokenManager(config);
-    const useRegistrySlug = hasApiUrl || isV2;
-    const defaultBaseUrl = isV2 ? DEFAULT_V2_BASE_URL : DEFAULT_BASE_URL;
-    const baseApiUrl = hasApiUrl ? resolveBaseApiUrl(config.apiUrl, V2_EXTENDABLE_SLUG, "PeekAccessService") : `${config.baseUrl ?? defaultBaseUrl}/${config.appId}`;
+    const useRegistrySlug = hasApiUrl;
+    const baseApiUrl = hasApiUrl ? resolveBaseApiUrl(config.apiUrl, V2_EXTENDABLE_SLUG, "PeekAccessService") : `${config.baseUrl ?? DEFAULT_BASE_URL}/${config.appId}`;
     this.client = new GraphQLClient({
       baseApiUrl,
       endpoints: peekApiEndpoints(useRegistrySlug),
@@ -4571,6 +4639,16 @@ var PeekAccessService = class {
     }
     return this.reviewService;
   }
+  /**
+   * Returns the {@link CustomQuestionService} for this install, bound to the
+   * shared authenticated transport. The instance is created lazily and reused.
+   */
+  getCustomQuestionService() {
+    if (!this.customQuestionService) {
+      this.customQuestionService = new CustomQuestionService(this.client);
+    }
+    return this.customQuestionService;
+  }
   // ─── Product short-forms ─────────────────────────────────────────────────
   /** All products (activities + add-ons). @deprecated The access service exposes only its resource-service accessors; call the service directly instead. See {@link ProductService.getAllProducts}. */
   getAllProducts() {
@@ -5040,7 +5118,12 @@ var AcmeAccessService = class {
 
 // src/access-service-factory.ts
 function createAccessServiceForInstall(install, config) {
-  const shared = { ...config, installId: install.installId, apiUrl: install.apiUrl };
+  const shared = {
+    ...config,
+    installId: install.installId,
+    apiUrl: install.apiUrl,
+    mode: "v2"
+  };
   switch (install.platform) {
     case "peek":
       return new PeekAccessService(shared);
@@ -5207,6 +5290,6 @@ function verifyInstallWebhook(token, secret) {
   };
 }
 
-export { ACTIVITY_PRODUCT_TYPE, ADD_ON_PRODUCT_TYPE, AccountUserService, AcmeAccessService, AcmeApiError, AcmeProductService, AdminAccountRequiredError, AvailabilityService, BookingService, CngAccessService, CngApiError, CngPermissionError, CngProductService, DailyNoteService, INSTALL_STATUSES, MembershipService, PeekAccessService, PeekGraphQLError, PeekHttpError, PiiAccessDisabledError, PricingService, ProductService, PromoCodeService, RENTAL_PRODUCT_TYPE, RateLimitError, ResellerService, ResourcePoolService, ReviewService, TimeslotService, createAccessServiceForInstall, noopLogger, parseBookingWebhook, parseInstallWebhook, parseWaiverWebhook, verifyInstallWebhook };
+export { ACTIVITY_PRODUCT_TYPE, ADD_ON_PRODUCT_TYPE, AccountUserService, AcmeAccessService, AcmeApiError, AcmeProductService, AdminAccountRequiredError, AvailabilityService, BookingService, CngAccessService, CngApiError, CngPermissionError, CngProductService, CustomQuestionService, DailyNoteService, INSTALL_STATUSES, MembershipService, PeekAccessService, PeekGraphQLError, PeekHttpError, PiiAccessDisabledError, PricingService, ProductService, PromoCodeService, RENTAL_PRODUCT_TYPE, RateLimitError, ResellerService, ResourcePoolService, ReviewService, TimeslotService, createAccessServiceForInstall, noopLogger, parseBookingWebhook, parseInstallWebhook, parseWaiverWebhook, verifyInstallWebhook };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map