@peektravel/app-utilities 0.2.2 → 0.2.4

package/dist/index.d.ts

@@ -51,112 +51,6 @@ declare class GraphQLClient {
     private buildHeaders;
 }
 
-/**
- * The clean data model for a Peek Pro account user (staff member / guide).
- */
-/**
- * An account user on a Peek Pro account.
- *
- * Only **active** users are returned by the account-user service — inactive
- * users are filtered out — so there is no status field on this model.
- */
-interface AccountUser {
-    /** Unique identifier of the account user. */
-    id: string;
-    /** Full name. */
-    name: string;
-    /** Email address. */
-    email: string;
-    /** Phone number. */
-    phone: string;
-    /** The activities this user is assigned to. */
-    assignedActivities: AssignedActivity[];
-}
-/** An activity an {@link AccountUser} is assigned to. */
-interface AssignedActivity {
-    /** Activity (product) id. */
-    id: string;
-    /** Activity name. */
-    name: string;
-}
-
-/** Tuning options for an {@link AccountUserService}. */
-interface AccountUserServiceOptions {
-    /** Page size for cursor pagination. Default: 50. */
-    pageSize?: number;
-}
-declare class AccountUserService {
-    private readonly client;
-    private readonly pageSize;
-    constructor(client: GraphQLClient, options?: AccountUserServiceOptions);
-    /**
-     * Returns all active account users, walking the cursor pagination to the end.
-     * Inactive users are omitted.
-     */
-    getAll(): Promise<AccountUser[]>;
-    /**
-     * Returns a single active account user by id, or `null` when no active user
-     * matches.
-     */
-    getById(userId: string): Promise<AccountUser | null>;
-}
-
-/**
- * The clean data model for Peek Pro activity availability times.
- */
-/** A single bookable availability time slot for an activity. */
-interface AvailabilityTime {
-    /** Unique identifier. */
-    id: string;
-    /** Time label. */
-    time: string;
-    /** Slot start. */
-    from: string;
-    /** Slot end. */
-    end: string;
-    /** Slot duration. */
-    duration: Duration;
-    /** Availability status. */
-    status: string;
-    /** Per-resource-option availability. */
-    availability: Availability[];
-}
-/** Duration of an {@link AvailabilityTime} slot. */
-interface Duration {
-    name: string;
-    length: {
-        amount: number;
-        unit: string;
-    };
-}
-/** Availability for a specific resource option within a slot. */
-interface Availability {
-    qty: number;
-    taken: number;
-    resourceOptionId: string;
-}
-/** A requested resource-option quantity used when querying availability. */
-interface ResourceOptionQuantity {
-    resourceOptionId: string;
-    quantity: number;
-}
-/** Query parameters for fetching availability times. */
-interface AvailabilityTimesQuery {
-    /** Activity (product) id. */
-    activityId: string;
-    /** Date (YYYY-MM-DD). */
-    date: string;
-    /** The resource options and quantities to check availability for. */
-    resourceOptionQuantities: ResourceOptionQuantity[];
-}
-
-declare class AvailabilityService {
-    private readonly client;
-    constructor(client: GraphQLClient);
-    /** Returns the availability times for an activity/date and requested quantities. */
-    getAvailabilityTimes(query: AvailabilityTimesQuery): Promise<AvailabilityTime[]>;
-}
-
 /**
  * The clean, transport-agnostic data model for a Peek Pro product.
  *
@@ -215,6 +109,10 @@ interface ProductTicket {
     /** Human-readable name of the ticket / option. */
     name: string;
 }
+/** {@link Product.type} for standard bookable activities. */
+declare const ACTIVITY_PRODUCT_TYPE = "ACTIVITY";
+/** {@link Product.type} for rental products. */
+declare const RENTAL_PRODUCT_TYPE = "RENTAL";
 /**
  * The {@link Product.type} value assigned to add-on products.
  *
@@ -247,6 +145,12 @@ declare class ProductService {
      * ```
      */
     getAllProducts(): Promise<Product[]>;
+    /** Returns products with type {@link ACTIVITY_PRODUCT_TYPE}. */
+    getAllActivities(): Promise<Product[]>;
+    /** Returns products with type {@link RENTAL_PRODUCT_TYPE}. */
+    getAllRentals(): Promise<Product[]>;
+    /** Returns only add-on products. */
+    getAllAddons(): Promise<Product[]>;
     private fetchActivities;
     private fetchAllItemOptionNodes;
 }
@@ -756,24 +660,6 @@ declare class BookingService {
     private fetchPaginated;
 }
 
-/**
- * The clean data model for a Peek Pro daily (dashboard) note.
- */
-/** The daily note shown on the Peek Pro dashboard. */
-interface DailyNote {
-    /** The note text. */
-    note: string;
-}
-
-declare class DailyNoteService {
-    private readonly client;
-    constructor(client: GraphQLClient);
-    /** Returns today's daily note, or null when none is set. */
-    getToday(): Promise<DailyNote | null>;
-    /** Upserts the daily note and returns the saved note, or null. */
-    update(note: string): Promise<DailyNote | null>;
-}
-
 /**
  * The clean data model for Peek Pro memberships.
  */
@@ -830,96 +716,342 @@ interface PurchasedMembership {
     balanceFormatted: string;
 }
 
-declare class MembershipService {
-    private readonly client;
-    constructor(client: GraphQLClient);
-    /** Returns all membership variants, flattened into {@link Membership} records. */
-    getAll(): Promise<Membership[]>;
-    /**
-     * Purchases a membership via the two-step quote → order flow. Throws on
-     * invalid input or when Peek returns errors.
-     */
-    purchase(input: MembershipPurchaseInput): Promise<PurchasedMembership>;
-}
-
 /**
- * The clean data model for Peek Pro reseller channels and their agents.
+ * The clean data model for Peek Pro activity availability times.
  */
-/** A reseller channel on a Peek Pro account. */
-interface Channel {
+/** A single bookable availability time slot for an activity. */
+interface AvailabilityTime {
     /** Unique identifier. */
     id: string;
-    /** Channel name. */
-    name: string;
-    /** Free-text notes, or null. */
-    notes: string | null;
-    /** Pricing model reported by Peek. */
-    pricingModel: string;
-    /** Channel state (e.g. active/inactive). */
-    state: string;
-    /** Channel type. */
-    type: string;
-    /** Agents belonging to this channel. */
-    agents: Agent[];
+    /** Time label. */
+    time: string;
+    /** Slot start. */
+    from: string;
+    /** Slot end. */
+    end: string;
+    /** Slot duration. */
+    duration: Duration;
+    /** Availability status. */
+    status: string;
+    /** Per-resource-option availability. */
+    availability: Availability[];
 }
-/** An agent (contact) belonging to a {@link Channel}. */
-interface Agent {
-    /** Email address, or null. */
-    email: string | null;
-    /** Agent name. */
+/** Duration of an {@link AvailabilityTime} slot. */
+interface Duration {
     name: string;
-    /** Internal notes, or null. */
-    internalNotes: string | null;
-    /** Phone number, or null. */
-    phone: string | null;
+    length: {
+        amount: number;
+        unit: string;
+    };
 }
-
-declare class ResellerService {
-    private readonly client;
-    constructor(client: GraphQLClient);
-    /**
-     * Returns all reseller channels, each with up to `agentsPerChannel` agents
-     * (default 10).
-     */
-    getAllChannels(agentsPerChannel?: number): Promise<Channel[]>;
+/** Availability for a specific resource option within a slot. */
+interface Availability {
+    qty: number;
+    taken: number;
+    resourceOptionId: string;
+}
+/** A requested resource-option quantity used when querying availability. */
+interface ResourceOptionQuantity {
+    resourceOptionId: string;
+    quantity: number;
+}
+/** Query parameters for fetching availability times. */
+interface AvailabilityTimesQuery {
+    /** Activity (product) id. */
+    activityId: string;
+    /** Date (YYYY-MM-DD). */
+    date: string;
+    /** The resource options and quantities to check availability for. */
+    resourceOptionQuantities: ResourceOptionQuantity[];
 }
 
 /**
- * The clean data model for a Peek Pro resource pool (e.g. guides, equipment).
+ * The clean data model for Peek Pro promo codes.
  */
-/** Filter mode for which resource pools to return. */
-type ResourcePoolMode = "ACTIVITY" | "ALL";
-/** A resource pool on a Peek Pro account. */
-interface ResourcePool {
+/** A promo code on a Peek Pro account. */
+interface PromoCode {
     /** Unique identifier. */
     id: string;
     /** Display name. */
     name: string;
-    /** Image URL, or null. */
-    imageUrl: string | null;
-    /** Allocation mode reported by Peek. */
-    mode: string;
-    /** Display color as a hex string, or null. */
-    colorHex: string | null;
-    /** Configured quantity, or null when not set. */
-    quantity: number | null;
-    /** Category (e.g. `"guide"`). */
-    category: string;
-    /** Capacity, or null when not set. */
-    capacity: number | null;
-    /** How the resource is tracked, or null. */
-    resourceTrackingMode: string | null;
-    /** The account user backing this pool (e.g. for guides), or null. */
-    accountUser: ResourcePoolAccountUser | null;
+    /** Percentage discount (0–100), or null for a fixed-amount code. */
+    percentAmount: number | null;
+    /** Whether the discount applies per ticket. */
+    perTicketDiscount: boolean;
+    /** The code guests redeem. */
+    redemptionCode: string;
+    /** Fixed-amount discount, or null for a percentage code. */
+    fixedAmount: PromoCodeFixedAmount | null;
 }
-/** Minimal account-user reference attached to a {@link ResourcePool}. */
-interface ResourcePoolAccountUser {
-    id: string;
-    name: string;
+/** A fixed monetary discount on a {@link PromoCode}. */
+interface PromoCodeFixedAmount {
+    /** Amount in the currency's minor/major unit as reported by Peek. */
+    amount: number;
+    /** ISO currency code. */
+    currency: string;
+    /** Human-formatted amount (e.g. `"$10.00"`). */
+    formatted: string;
 }
-
-declare class ResourcePoolService {
-    private readonly client;
+/** Input for creating a promo code. */
+interface CreatePromoCodeInput {
+    /** Display name. */
+    name: string;
+    /** The redemption code. */
+    code: string;
+    /** Discount amount as a string (percentage or fixed value). */
+    amount: string;
+    /** Whether `amount` is a percentage or a fixed monetary value. */
+    discountType: "percent" | "fixed";
+    /** Optional cap on total redemptions. */
+    maxRedemptions?: number;
+    /** ISO currency code for fixed discounts. Defaults to `"USD"`. */
+    currency?: string;
+}
+/** The result of creating a promo code (the mutation returns id + name). */
+interface CreatedPromoCode {
+    id: string;
+    name: string;
+}
+
+/**
+ * The clean data model for Peek Pro timeslots and timeslot operations.
+ */
+/** A bookable timeslot for an activity. */
+interface Timeslot {
+    /** Unique identifier. */
+    id: string;
+    /** The activity (product) id this timeslot belongs to. */
+    productId: string;
+    /** Total capacity of the timeslot. */
+    totalCapacity: number;
+    /** Remaining available capacity. */
+    availableCapacity: number;
+    /** Maximum party size per booking. */
+    maxPartySize: number;
+    /** Number of bookings on the timeslot. */
+    bookingCount: number;
+    /** Number of checked-in guests. */
+    checkedInCount: number;
+    /** Status reported by Peek (e.g. open/closed). */
+    status: string;
+    /** Manifest notes, or null. */
+    notes: string | null;
+    /** Duration in minutes. */
+    durationMin: number;
+    /** Date (YYYY-MM-DD). */
+    date: string;
+    /** Start time, or null. */
+    startTime: string | null;
+    /** Resources (e.g. guides, equipment) allocated to this timeslot. */
+    assignedResources: AssignedResource[];
+}
+/** A resource allocated to a {@link Timeslot}. */
+interface AssignedResource {
+    /** Resource pool id. */
+    id: string;
+    /** Resource pool name. */
+    name: string;
+    /** Resource pool capacity. */
+    capacity: number;
+    /** Resource pool category (e.g. `"guide"`). */
+    category: string;
+    /** Allocated quantity. */
+    quantity: number;
+    /** Backing account user id, or null. */
+    accountUserId: string | null;
+}
+/** Booking filter for {@link Timeslot} day queries. */
+type TimeslotFilter = "all" | "withBookings" | "withoutBookings";
+/** Result of a timeslot update (set availability / notes). */
+interface UpdateTimeslotResult {
+    manifestNotes: string | null;
+    status: string | null;
+}
+/** Input describing a guide (un)assignment across timeslots. */
+interface GuideAssignment {
+    /** Timeslots to (un)assign. */
+    timeslotIds: string[];
+    /** Guides to (un)assign — matched by resource-pool id, account-user id, or name. */
+    guideIds: string[];
+    /** Whether to assign or unassign. */
+    action: "assign" | "unassign";
+}
+/** Result of a guide (un)assignment request. */
+interface AssignGuideResult {
+    status: "success" | "error";
+    /** The created allocation request id on success, else null. */
+    resourceAllocationRequestId: string | null;
+    /** Error details on failure, else null. */
+    errors: Array<{
+        message: string;
+    }> | null;
+}
+
+/**
+ * The clean data model for a Peek Pro resource pool (e.g. guides, equipment).
+ */
+/** Filter mode for which resource pools to return. */
+type ResourcePoolMode = "ACTIVITY" | "ALL";
+/** A resource pool on a Peek Pro account. */
+interface ResourcePool {
+    /** Unique identifier. */
+    id: string;
+    /** Display name. */
+    name: string;
+    /** Image URL, or null. */
+    imageUrl: string | null;
+    /** Allocation mode reported by Peek. */
+    mode: string;
+    /** Display color as a hex string, or null. */
+    colorHex: string | null;
+    /** Configured quantity, or null when not set. */
+    quantity: number | null;
+    /** Category (e.g. `"guide"`). */
+    category: string;
+    /** Capacity, or null when not set. */
+    capacity: number | null;
+    /** How the resource is tracked, or null. */
+    resourceTrackingMode: string | null;
+    /** The account user backing this pool (e.g. for guides), or null. */
+    accountUser: ResourcePoolAccountUser | null;
+}
+/** Minimal account-user reference attached to a {@link ResourcePool}. */
+interface ResourcePoolAccountUser {
+    id: string;
+    name: string;
+}
+
+/**
+ * The clean data model for a Peek Pro account user (staff member / guide).
+ */
+/**
+ * An account user on a Peek Pro account.
+ *
+ * Only **active** users are returned by the account-user service — inactive
+ * users are filtered out — so there is no status field on this model.
+ */
+interface AccountUser {
+    /** Unique identifier of the account user. */
+    id: string;
+    /** Full name. */
+    name: string;
+    /** Email address. */
+    email: string;
+    /** Phone number. */
+    phone: string;
+    /** The activities this user is assigned to. */
+    assignedActivities: AssignedActivity[];
+}
+/** An activity an {@link AccountUser} is assigned to. */
+interface AssignedActivity {
+    /** Activity (product) id. */
+    id: string;
+    /** Activity name. */
+    name: string;
+}
+
+/** Tuning options for an {@link AccountUserService}. */
+interface AccountUserServiceOptions {
+    /** Page size for cursor pagination. Default: 50. */
+    pageSize?: number;
+}
+declare class AccountUserService {
+    private readonly client;
+    private readonly pageSize;
+    constructor(client: GraphQLClient, options?: AccountUserServiceOptions);
+    /**
+     * Returns all active account users, walking the cursor pagination to the end.
+     * Inactive users are omitted.
+     */
+    getAll(): Promise<AccountUser[]>;
+    /**
+     * Returns a single active account user by id, or `null` when no active user
+     * matches.
+     */
+    getById(userId: string): Promise<AccountUser | null>;
+}
+
+declare class AvailabilityService {
+    private readonly client;
+    constructor(client: GraphQLClient);
+    /** Returns the availability times for an activity/date and requested quantities. */
+    getAvailabilityTimes(query: AvailabilityTimesQuery): Promise<AvailabilityTime[]>;
+}
+
+/**
+ * The clean data model for a Peek Pro daily (dashboard) note.
+ */
+/** The daily note shown on the Peek Pro dashboard. */
+interface DailyNote {
+    /** The note text. */
+    note: string;
+}
+
+declare class DailyNoteService {
+    private readonly client;
+    constructor(client: GraphQLClient);
+    /** Returns today's daily note, or null when none is set. */
+    getToday(): Promise<DailyNote | null>;
+    /** Upserts the daily note and returns the saved note, or null. */
+    update(note: string): Promise<DailyNote | null>;
+}
+
+declare class MembershipService {
+    private readonly client;
+    constructor(client: GraphQLClient);
+    /** Returns all membership variants, flattened into {@link Membership} records. */
+    getAll(): Promise<Membership[]>;
+    /**
+     * Purchases a membership via the two-step quote → order flow. Throws on
+     * invalid input or when Peek returns errors.
+     */
+    purchase(input: MembershipPurchaseInput): Promise<PurchasedMembership>;
+}
+
+/**
+ * The clean data model for Peek Pro reseller channels and their agents.
+ */
+/** A reseller channel on a Peek Pro account. */
+interface Channel {
+    /** Unique identifier. */
+    id: string;
+    /** Channel name. */
+    name: string;
+    /** Free-text notes, or null. */
+    notes: string | null;
+    /** Pricing model reported by Peek. */
+    pricingModel: string;
+    /** Channel state (e.g. active/inactive). */
+    state: string;
+    /** Channel type. */
+    type: string;
+    /** Agents belonging to this channel. */
+    agents: Agent[];
+}
+/** An agent (contact) belonging to a {@link Channel}. */
+interface Agent {
+    /** Email address, or null. */
+    email: string | null;
+    /** Agent name. */
+    name: string;
+    /** Internal notes, or null. */
+    internalNotes: string | null;
+    /** Phone number, or null. */
+    phone: string | null;
+}
+
+declare class ResellerService {
+    private readonly client;
+    constructor(client: GraphQLClient);
+    /**
+     * Returns all reseller channels, each with up to `agentsPerChannel` agents
+     * (default 10).
+     */
+    getAllChannels(agentsPerChannel?: number): Promise<Channel[]>;
+}
+
+declare class ResourcePoolService {
+    private readonly client;
     constructor(client: GraphQLClient);
     /**
      * Returns all resource pools for the given mode filter (defaults to `"ALL"`).
@@ -1001,80 +1133,6 @@ declare class ReviewService {
     private validate;
 }
 
-/**
- * The clean data model for Peek Pro timeslots and timeslot operations.
- */
-/** A bookable timeslot for an activity. */
-interface Timeslot {
-    /** Unique identifier. */
-    id: string;
-    /** The activity (product) id this timeslot belongs to. */
-    productId: string;
-    /** Total capacity of the timeslot. */
-    totalCapacity: number;
-    /** Remaining available capacity. */
-    availableCapacity: number;
-    /** Maximum party size per booking. */
-    maxPartySize: number;
-    /** Number of bookings on the timeslot. */
-    bookingCount: number;
-    /** Number of checked-in guests. */
-    checkedInCount: number;
-    /** Status reported by Peek (e.g. open/closed). */
-    status: string;
-    /** Manifest notes, or null. */
-    notes: string | null;
-    /** Duration in minutes. */
-    durationMin: number;
-    /** Date (YYYY-MM-DD). */
-    date: string;
-    /** Start time, or null. */
-    startTime: string | null;
-    /** Resources (e.g. guides, equipment) allocated to this timeslot. */
-    assignedResources: AssignedResource[];
-}
-/** A resource allocated to a {@link Timeslot}. */
-interface AssignedResource {
-    /** Resource pool id. */
-    id: string;
-    /** Resource pool name. */
-    name: string;
-    /** Resource pool capacity. */
-    capacity: number;
-    /** Resource pool category (e.g. `"guide"`). */
-    category: string;
-    /** Allocated quantity. */
-    quantity: number;
-    /** Backing account user id, or null. */
-    accountUserId: string | null;
-}
-/** Booking filter for {@link Timeslot} day queries. */
-type TimeslotFilter = "all" | "withBookings" | "withoutBookings";
-/** Result of a timeslot update (set availability / notes). */
-interface UpdateTimeslotResult {
-    manifestNotes: string | null;
-    status: string | null;
-}
-/** Input describing a guide (un)assignment across timeslots. */
-interface GuideAssignment {
-    /** Timeslots to (un)assign. */
-    timeslotIds: string[];
-    /** Guides to (un)assign — matched by resource-pool id, account-user id, or name. */
-    guideIds: string[];
-    /** Whether to assign or unassign. */
-    action: "assign" | "unassign";
-}
-/** Result of a guide (un)assignment request. */
-interface AssignGuideResult {
-    status: "success" | "error";
-    /** The created allocation request id on success, else null. */
-    resourceAllocationRequestId: string | null;
-    /** Error details on failure, else null. */
-    errors: Array<{
-        message: string;
-    }> | null;
-}
-
 /**
  * Timeslot operations against the Peek gateway.
  *
@@ -1118,54 +1176,6 @@ declare class TimeslotService {
     private updateTimeslot;
 }
 
-/**
- * The clean data model for Peek Pro promo codes.
- */
-/** A promo code on a Peek Pro account. */
-interface PromoCode {
-    /** Unique identifier. */
-    id: string;
-    /** Display name. */
-    name: string;
-    /** Percentage discount (0–100), or null for a fixed-amount code. */
-    percentAmount: number | null;
-    /** Whether the discount applies per ticket. */
-    perTicketDiscount: boolean;
-    /** The code guests redeem. */
-    redemptionCode: string;
-    /** Fixed-amount discount, or null for a percentage code. */
-    fixedAmount: PromoCodeFixedAmount | null;
-}
-/** A fixed monetary discount on a {@link PromoCode}. */
-interface PromoCodeFixedAmount {
-    /** Amount in the currency's minor/major unit as reported by Peek. */
-    amount: number;
-    /** ISO currency code. */
-    currency: string;
-    /** Human-formatted amount (e.g. `"$10.00"`). */
-    formatted: string;
-}
-/** Input for creating a promo code. */
-interface CreatePromoCodeInput {
-    /** Display name. */
-    name: string;
-    /** The redemption code. */
-    code: string;
-    /** Discount amount as a string (percentage or fixed value). */
-    amount: string;
-    /** Whether `amount` is a percentage or a fixed monetary value. */
-    discountType: "percent" | "fixed";
-    /** Optional cap on total redemptions. */
-    maxRedemptions?: number;
-    /** ISO currency code for fixed discounts. Defaults to `"USD"`. */
-    currency?: string;
-}
-/** The result of creating a promo code (the mutation returns id + name). */
-interface CreatedPromoCode {
-    id: string;
-    name: string;
-}
-
 /** Tuning options for a {@link PromoCodeService}. */
 interface PromoCodeServiceOptions {
     /** Page size for cursor pagination. Default: 50. */
@@ -1184,15 +1194,28 @@ declare class PromoCodeService {
     create(input: CreatePromoCodeInput): Promise<CreatedPromoCode>;
 }
 
-/**
- * Authenticated root entry point to the Peek backoffice GraphQL gateway.
- *
- * Configure one instance per install with everything needed to authenticate and
- * reach the gateway. The access service owns the shared, authenticated
- * transport (it mints and caches tokens on demand) and hands out per-resource
- * service objects — e.g. {@link PeekAccessService.getProductService} — that
- * carry the resource-specific business logic.
- */
+/** User context embedded in a Peek auth token. */
+interface PeekAuthTokenUser {
+    /** User's email address. */
+    email: string;
+    /** User's Peek account ID */
+    id: string;
+    /** Whether the user has admin privileges. */
+    isAdmin: boolean;
+    /** User's locale (e.g. `"en"`). */
+    locale: string;
+    /** User's display name. */
+    name: string;
+}
+/** Claims returned by {@link PeekAccessService.verifyPeekAuthToken}. */
+interface PeekAuthTokenClaims {
+    /** Install ID — the JWT subject (`sub`). Peek-assigned UUID. */
+    installId: string;
+    /** App display version at time of issuance. */
+    displayVersion: string;
+    /** Authenticated user context. */
+    user: PeekAuthTokenUser;
+}
 
 /** Configuration for a {@link PeekAccessService} instance. */
 interface PeekAccessServiceConfig {
@@ -1258,6 +1281,7 @@ interface PeekAccessServiceConfig {
 declare class PeekAccessService {
     private readonly client;
     private readonly productServiceOptions;
+    private readonly jwtSecret;
     private productService?;
     private accountUserService?;
     private resourcePoolService?;
@@ -1270,6 +1294,25 @@ declare class PeekAccessService {
     private bookingService?;
     private reviewService?;
     constructor(config: PeekAccessServiceConfig);
+    /**
+     * Verifies a Peek auth token issued by the app registry and returns the
+     * decoded claims.
+     *
+     * Validates the HMAC signature (using this service's `jwtSecret`), the token
+     * expiry, the `"app_registry_v2"` issuer, and the `"Joken"` audience. Throws
+     * from the `jsonwebtoken` library on any failure — callers should catch to
+     * distinguish error kinds:
+     *
+     * - `JsonWebTokenError` — signature invalid, wrong issuer/audience, or token
+     *   malformed
+     * - `TokenExpiredError` — past `exp`
+     * - `NotBeforeError` — before `nbf`
+     *
+     * @throws {JsonWebTokenError} signature invalid or token malformed
+     * @throws {TokenExpiredError} token has expired
+     * @throws {NotBeforeError} token not yet valid
+     */
+    verifyPeekAuthToken(token: string): PeekAuthTokenClaims;
     /**
      * Returns the {@link ProductService} for this install, bound to the shared
      * authenticated transport. The instance is created lazily and reused.
@@ -1326,6 +1369,78 @@ declare class PeekAccessService {
      * authenticated transport. The instance is created lazily and reused.
      */
     getReviewService(): ReviewService;
+    /** All products (activities + add-ons). Delegates to {@link ProductService.getAllProducts}. */
+    getAllProducts(): Promise<Product[]>;
+    /** All activity products (excludes add-ons). Delegates to {@link ProductService.getAllActivities}. */
+    getAllActivities(): Promise<Product[]>;
+    /** All rental products. Delegates to {@link ProductService.getAllRentals}. */
+    getAllRentals(): Promise<Product[]>;
+    /** All add-on products. Delegates to {@link ProductService.getAllAddons}. */
+    getAllAddons(): Promise<Product[]>;
+    /** All active account users. Delegates to {@link AccountUserService.getAll}. */
+    getAllAccountUsers(): Promise<AccountUser[]>;
+    /** Account user by id, or null. Delegates to {@link AccountUserService.getById}. */
+    getAccountUserById(userId: string): Promise<AccountUser | null>;
+    /** All resource pools. Delegates to {@link ResourcePoolService.getAll}. */
+    getAllResourcePools(mode?: ResourcePoolMode): Promise<ResourcePool[]>;
+    /** Timeslots for an activity on a given date. Delegates to {@link TimeslotService.getForDay}. */
+    getTimeslotsForDay(productId: string, date: string, filter?: TimeslotFilter): Promise<Timeslot[]>;
+    /** Single timeslot by id. Delegates to {@link TimeslotService.getById}. */
+    getTimeslotById(timeslotId: string): Promise<Timeslot | null>;
+    /** Set timeslot status. Delegates to {@link TimeslotService.setAvailability}. */
+    setTimeslotAvailability(timeslotId: string, status: string): Promise<UpdateTimeslotResult>;
+    /** Set timeslot manifest notes. Delegates to {@link TimeslotService.setNotes}. */
+    setTimeslotNotes(timeslotId: string, manifestNotes: string): Promise<UpdateTimeslotResult>;
+    /** Assign or unassign guides on timeslots. Delegates to {@link TimeslotService.assignGuide}. */
+    assignTimeslotGuide(assignment: GuideAssignment): Promise<AssignGuideResult>;
+    /** All reseller channels. Delegates to {@link ResellerService.getAllChannels}. */
+    getAllChannels(agentsPerChannel?: number): Promise<Channel[]>;
+    /** All promo codes. Delegates to {@link PromoCodeService.getAll}. */
+    getAllPromoCodes(): Promise<PromoCode[]>;
+    /** Create a promo code. Delegates to {@link PromoCodeService.create}. */
+    createPromoCode(input: CreatePromoCodeInput): Promise<CreatedPromoCode>;
+    /** Today's daily note. Delegates to {@link DailyNoteService.getToday}. */
+    getDailyNoteToday(): Promise<DailyNote | null>;
+    /** Update today's daily note. Delegates to {@link DailyNoteService.update}. */
+    updateDailyNote(note: string): Promise<DailyNote | null>;
+    /** Availability times for an activity. Delegates to {@link AvailabilityService.getAvailabilityTimes}. */
+    getAvailabilityTimes(query: AvailabilityTimesQuery): Promise<AvailabilityTime[]>;
+    /** All memberships. Delegates to {@link MembershipService.getAll}. */
+    getAllMemberships(): Promise<Membership[]>;
+    /** Purchase a membership. Delegates to {@link MembershipService.purchase}. */
+    purchaseMembership(input: MembershipPurchaseInput): Promise<PurchasedMembership>;
+    /** Booking by id. Delegates to {@link BookingService.getById}. */
+    getBookingById(bookingId: string, options?: BookingReadOptions): Promise<Booking | null>;
+    /** Bookings by time range. Delegates to {@link BookingService.searchByTimeRange}. */
+    searchBookingsByTimeRange(input: BookingTimeRangeSearch): Promise<Booking[]>;
+    /** Bookings on a timeslot. Delegates to {@link BookingService.searchByTimeslot}. */
+    searchBookingsByTimeslot(timeslotId: string, options?: BookingReadOptions): Promise<Booking[]>;
+    /** Guests on a booking. Delegates to {@link BookingService.getGuests}. */
+    getBookingGuests(bookingId: string): Promise<Guest[]>;
+    /** Payments on file for a booking. Delegates to {@link BookingService.getPaymentsOnFile}. */
+    getBookingPaymentsOnFile(bookingId: string): Promise<BookingPaymentsOnFile | null>;
+    /** Append or overwrite operator notes. Delegates to {@link BookingService.appendNote}. */
+    appendBookingNote(bookingId: string, note: string, mode?: NoteMode): Promise<Booking | null>;
+    /** Set booking check-in status. Delegates to {@link BookingService.setCheckinStatus}. */
+    setBookingCheckinStatus(bookingId: string, checkedIn: boolean): Promise<Booking | null>;
+    /** Cancel a booking. Delegates to {@link BookingService.cancel}. */
+    cancelBooking(bookingId: string, notes?: string): Promise<CancelBookingResult>;
+    /** Charge a booking. Delegates to {@link BookingService.makePayment}. */
+    makeBookingPayment(input: MakePaymentInput): Promise<MakePaymentResult>;
+    /** Refund a booking payment. Delegates to {@link BookingService.refund}. */
+    refundBooking(input: RefundInput): Promise<RefundResult>;
+    /** Create an invoice link. Delegates to {@link BookingService.createInvoiceLink}. */
+    createBookingInvoiceLink(bookingId: string): Promise<InvoiceLinkResult>;
+    /** List add-ons on a booking. Delegates to {@link BookingService.listAddons}. */
+    listBookingAddons(bookingId: string): Promise<BookingAddons>;
+    /** Add an add-on to a booking. Delegates to {@link BookingService.addAddon}. */
+    addBookingAddon(bookingId: string, input: AddAddonInput): Promise<BookingAddonsMutationResult>;
+    /** Remove an add-on from a booking. Delegates to {@link BookingService.removeAddon}. */
+    removeBookingAddon(bookingId: string, input: AddAddonInput): Promise<BookingAddonsMutationResult>;
+    /** Create a booking. Delegates to {@link BookingService.create}. */
+    createBooking(input: CreateBookingInput): Promise<CreatedBooking>;
+    /** Reviews for an activity. Delegates to {@link ReviewService.getReviews}. */
+    getReviews(productId: string, reviewCount?: number, reviewOffset?: number): Promise<Review[]>;
 }
 
 /**
@@ -1441,4 +1556,4 @@ declare class PeekGraphQLError extends Error {
     constructor(graphqlErrors: unknown[], message?: string);
 }
 
-export { ADD_ON_PRODUCT_TYPE, type AccountUser, AccountUserService, type AccountUserServiceOptions, 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 CreateBookingGuest, type CreateBookingInput, type CreateBookingTicket, type CreatePromoCodeInput, type CreatedBooking, type CreatedPromoCode, type CustomQuestionAnswer, type DailyNote, DailyNoteService, type Duration, type Guest, type GuestMetadata, type Guide, type GuideAssignment, type InvoiceLinkResult, type Logger, type MakePaymentInput, type MakePaymentResult, type Membership, type MembershipPurchaseInput, MembershipService, type NoteMode, type Payment, type PaymentSource, PeekAccessService, type PeekAccessServiceConfig, PeekGraphQLError, type Price, type Product, ProductService, type ProductServiceOptions, type ProductTicket, type PromoCode, type PromoCodeFixedAmount, PromoCodeService, type PromoCodeServiceOptions, type PurchasedMembership, RateLimitError, type RefundInput, type RefundResult, ResellerService, type Resource, type ResourceOptionQuantity, type ResourcePool, type ResourcePoolAccountUser, type ResourcePoolAssignment, type ResourcePoolMode, ResourcePoolService, type Review, ReviewService, type Ticket, type Timeslot, type TimeslotFilter, TimeslotService, type UpdateTimeslotResult, type Waiver, noopLogger, parseBookingWebhook, parseWaiverWebhook };
+export { ACTIVITY_PRODUCT_TYPE, ADD_ON_PRODUCT_TYPE, type AccountUser, AccountUserService, type AccountUserServiceOptions, 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 CreateBookingGuest, type CreateBookingInput, type CreateBookingTicket, type CreatePromoCodeInput, type CreatedBooking, type CreatedPromoCode, type CustomQuestionAnswer, type DailyNote, DailyNoteService, type Duration, type Guest, type GuestMetadata, type Guide, type GuideAssignment, 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, type Price, type Product, ProductService, type ProductServiceOptions, type ProductTicket, type PromoCode, type PromoCodeFixedAmount, PromoCodeService, type PromoCodeServiceOptions, type PurchasedMembership, RENTAL_PRODUCT_TYPE, RateLimitError, type RefundInput, type RefundResult, ResellerService, type Resource, type ResourceOptionQuantity, type ResourcePool, type ResourcePoolAccountUser, type ResourcePoolAssignment, type ResourcePoolMode, ResourcePoolService, type Review, ReviewService, type Ticket, type Timeslot, type TimeslotFilter, TimeslotService, type UpdateTimeslotResult, type Waiver, noopLogger, parseBookingWebhook, parseWaiverWebhook };