@explorins/pers-sdk 2.2.0-alpha.1 → 2.2.0-alpha.2

package/dist/booking/api/booking-api.d.ts

@@ -0,0 +1,71 @@
+import { PersApiClient } from '../../core/pers-api-client';
+import type { BookingDTO, CreateBookingDTO, UpdateBookingDTO } from '@explorins/pers-shared';
+/**
+ * Booking filter options for querying bookings
+ */
+/**
+ * Options for booking validation checks
+ */
+export interface BookingValidationOptions {
+    /** Status to check - defaults to checking active+future */
+    status?: 'active' | 'future' | 'past' | 'active_future' | 'any';
+    /** Business ID to filter by */
+    businessId?: string;
+}
+export interface BookingQueryOptions {
+    userId?: string;
+    businessId?: string;
+    status?: 'active' | 'future' | 'past' | 'any';
+}
+/**
+ * Low-level API for booking operations
+ *
+ * Provides direct HTTP calls to the booking endpoints.
+ * For most use cases, prefer using BookingManager or BookingService.
+ *
+ * @internal
+ */
+export declare class BookingApi {
+    private readonly apiClient;
+    private readonly basePath;
+    constructor(apiClient: PersApiClient);
+    /**
+     * List all bookings with optional filters
+     *
+     * @param options - Filter options (userId, businessId, status)
+     * @returns Promise resolving to array of bookings
+     */
+    getAll(options?: BookingQueryOptions): Promise<BookingDTO[]>;
+    /**
+     * Get a single booking by ID
+     *
+     * @param id - Booking UUID
+     * @returns Promise resolving to booking data
+     */
+    getById(id: string): Promise<BookingDTO>;
+    /**
+     * Create a new booking
+     *
+     * @param data - Booking creation data
+     * @returns Promise resolving to created booking
+     */
+    create(data: CreateBookingDTO): Promise<BookingDTO>;
+    /**
+     * Update an existing booking
+     *
+     * @param id - Booking UUID
+     * @param data - Booking update data
+     * @returns Promise resolving to updated booking
+     */
+    update(id: string, data: UpdateBookingDTO): Promise<BookingDTO>;
+    /**
+     * Delete a booking
+     *
+     * @param id - Booking UUID
+     * @returns Promise resolving to success status
+     */
+    delete(id: string): Promise<{
+        success: boolean;
+    }>;
+}
+//# sourceMappingURL=booking-api.d.ts.map

package/dist/booking/api/booking-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"booking-api.d.ts","sourceRoot":"","sources":["../../../src/booking/api/booking-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,wBAAwB,CAAC;AAEhC;;GAEG;AACH;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,2DAA2D;IAC3D,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,eAAe,GAAG,KAAK,CAAC;IAChE,+BAA+B;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAC;CAC/C;AAED;;;;;;;GAOG;AACH,qBAAa,UAAU;IAGT,OAAO,CAAC,QAAQ,CAAC,SAAS;IAFtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;gBAEX,SAAS,EAAE,aAAa;IAErD;;;;;OAKG;IACG,MAAM,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAmBlE;;;;;OAKG;IACG,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAI9C;;;;;OAKG;IACG,MAAM,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC;IAIzD;;;;;;OAMG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC;IAIrE;;;;;OAKG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;CAGxD"}

package/dist/booking/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @explorins/pers-sdk-booking
+ *
+ * Platform-agnostic Booking Domain SDK for PERS ecosystem
+ * Handles booking management for eligibility checks and tracking
+ */
+export { BookingApi, type BookingQueryOptions, type BookingValidationOptions } from './api/booking-api';
+export { BookingService } from './services/booking-service';
+//# sourceMappingURL=index.d.ts.map

package/dist/booking/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/booking/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,UAAU,EAAE,KAAK,mBAAmB,EAAE,KAAK,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAGxG,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/booking/services/booking-service.d.ts

@@ -0,0 +1,79 @@
+import { BookingApi, type BookingQueryOptions, type BookingValidationOptions } from '../api/booking-api';
+import type { BookingDTO, CreateBookingDTO, UpdateBookingDTO } from '@explorins/pers-shared';
+/**
+ * Booking Service - Business logic layer for booking operations
+ *
+ * Provides booking management functionality with validation and
+ * business rule enforcement.
+ *
+ * @internal
+ */
+export declare class BookingService {
+    private readonly bookingApi;
+    constructor(bookingApi: BookingApi);
+    /**
+     * Get all bookings with optional filters
+     *
+     * @param options - Filter options
+     * @returns Promise resolving to array of bookings
+     */
+    getAll(options?: BookingQueryOptions): Promise<BookingDTO[]>;
+    /**
+     * Get bookings for a specific user
+     *
+     * @param userId - User ID to filter by
+     * @param status - Optional status filter
+     * @returns Promise resolving to user's bookings
+     */
+    getByUser(userId: string, status?: BookingQueryOptions['status']): Promise<BookingDTO[]>;
+    /**
+     * Get bookings for a specific business
+     *
+     * @param businessId - Business ID to filter by
+     * @param status - Optional status filter
+     * @returns Promise resolving to business's bookings
+     */
+    getByBusiness(businessId: string, status?: BookingQueryOptions['status']): Promise<BookingDTO[]>;
+    /**
+     * Get a single booking by ID
+     *
+     * @param id - Booking UUID
+     * @returns Promise resolving to booking data
+     */
+    getById(id: string): Promise<BookingDTO>;
+    /**
+     * Create a new booking
+     *
+     * @param data - Booking creation data
+     * @returns Promise resolving to created booking
+     */
+    create(data: CreateBookingDTO): Promise<BookingDTO>;
+    /**
+     * Update an existing booking
+     *
+     * @param id - Booking UUID
+     * @param data - Booking update data
+     * @returns Promise resolving to updated booking
+     */
+    update(id: string, data: UpdateBookingDTO): Promise<BookingDTO>;
+    /**
+     * Delete a booking
+     *
+     * @param id - Booking UUID
+     * @returns Promise resolving to success status
+     */
+    delete(id: string): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Check if a user has an active or future booking
+     *
+     * Useful for eligibility checks on redemptions.
+     *
+     * @param userId - User ID to check
+     * @param options - Validation options (status filter, business filter)
+     * @returns Promise resolving to true if user has valid booking
+     */
+    hasValidBooking(userId: string, options?: BookingValidationOptions): Promise<boolean>;
+}
+//# sourceMappingURL=booking-service.d.ts.map

package/dist/booking/services/booking-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"booking-service.d.ts","sourceRoot":"","sources":["../../../src/booking/services/booking-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,mBAAmB,EAAE,KAAK,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AACzG,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,wBAAwB,CAAC;AAEhC;;;;;;;GAOG;AACH,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAAV,UAAU,EAAE,UAAU;IAEnD;;;;;OAKG;IACG,MAAM,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAIlE;;;;;;OAMG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,mBAAmB,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAI9F;;;;;;OAMG;IACG,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,mBAAmB,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAItG;;;;;OAKG;IACG,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAI9C;;;;;OAKG;IACG,MAAM,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC;IAazD;;;;;;OAMG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC;IAarE;;;;;OAKG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAIvD;;;;;;;;OAQG;IACG,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,OAAO,CAAC;CAoB5F"}

package/dist/chunks/{pers-sdk-CBRtrG03.js → pers-sdk-C01Z2nmP.js}

@@ -1585,7 +1585,7 @@ class DefaultAuthProvider {
 /** SDK package name */
 const SDK_NAME = "@explorins/pers-sdk";
 /** SDK version - injected from package.json at build time */
-const SDK_VERSION = "2.2.0-alpha.1";
+const SDK_VERSION = "2.2.0-alpha.2";
 /** Full SDK identifier for headers */
 const SDK_USER_AGENT = `${SDK_NAME}/${SDK_VERSION}`;
 
@@ -1921,6 +1921,24 @@ class PersApiClient {
         else if (this.mergedConfig.apiProjectKey) {
             headers['x-project-key'] = this.mergedConfig.apiProjectKey;
         }
+        // Add data source tracking headers
+        const dataSource = this.mergedConfig.dataSource;
+        if (dataSource) {
+            headers['x-source-channel'] = dataSource.channel;
+            if (dataSource.medium) {
+                headers['x-source-medium'] = dataSource.medium;
+            }
+            if (dataSource.campaign) {
+                headers['x-source-campaign'] = dataSource.campaign;
+            }
+            if (dataSource.source) {
+                headers['x-source'] = dataSource.source;
+            }
+            // Note: referrer is typically set by browser, but can be overridden
+            if (dataSource.referrer) {
+                headers['Referer'] = dataSource.referrer;
+            }
+        }
         return headers;
     }
     // ==========================================
@@ -10529,6 +10547,412 @@ class CustomFieldDefinitionManager {
     }
 }
 
+/**
+ * Low-level API for booking operations
+ *
+ * Provides direct HTTP calls to the booking endpoints.
+ * For most use cases, prefer using BookingManager or BookingService.
+ *
+ * @internal
+ */
+class BookingApi {
+    constructor(apiClient) {
+        this.apiClient = apiClient;
+        this.basePath = '/bookings';
+    }
+    /**
+     * List all bookings with optional filters
+     *
+     * @param options - Filter options (userId, businessId, status)
+     * @returns Promise resolving to array of bookings
+     */
+    async getAll(options) {
+        const params = new URLSearchParams();
+        if (options?.userId) {
+            params.append('userId', options.userId);
+        }
+        if (options?.businessId) {
+            params.append('businessId', options.businessId);
+        }
+        if (options?.status) {
+            params.append('status', options.status);
+        }
+        const queryString = params.toString();
+        const url = queryString ? `${this.basePath}?${queryString}` : this.basePath;
+        return this.apiClient.get(url);
+    }
+    /**
+     * Get a single booking by ID
+     *
+     * @param id - Booking UUID
+     * @returns Promise resolving to booking data
+     */
+    async getById(id) {
+        return this.apiClient.get(`${this.basePath}/${id}`);
+    }
+    /**
+     * Create a new booking
+     *
+     * @param data - Booking creation data
+     * @returns Promise resolving to created booking
+     */
+    async create(data) {
+        return this.apiClient.post(this.basePath, data);
+    }
+    /**
+     * Update an existing booking
+     *
+     * @param id - Booking UUID
+     * @param data - Booking update data
+     * @returns Promise resolving to updated booking
+     */
+    async update(id, data) {
+        return this.apiClient.put(`${this.basePath}/${id}`, data);
+    }
+    /**
+     * Delete a booking
+     *
+     * @param id - Booking UUID
+     * @returns Promise resolving to success status
+     */
+    async delete(id) {
+        return this.apiClient.delete(`${this.basePath}/${id}`);
+    }
+}
+
+/**
+ * Booking Service - Business logic layer for booking operations
+ *
+ * Provides booking management functionality with validation and
+ * business rule enforcement.
+ *
+ * @internal
+ */
+class BookingService {
+    constructor(bookingApi) {
+        this.bookingApi = bookingApi;
+    }
+    /**
+     * Get all bookings with optional filters
+     *
+     * @param options - Filter options
+     * @returns Promise resolving to array of bookings
+     */
+    async getAll(options) {
+        return this.bookingApi.getAll(options);
+    }
+    /**
+     * Get bookings for a specific user
+     *
+     * @param userId - User ID to filter by
+     * @param status - Optional status filter
+     * @returns Promise resolving to user's bookings
+     */
+    async getByUser(userId, status) {
+        return this.bookingApi.getAll({ userId, status });
+    }
+    /**
+     * Get bookings for a specific business
+     *
+     * @param businessId - Business ID to filter by
+     * @param status - Optional status filter
+     * @returns Promise resolving to business's bookings
+     */
+    async getByBusiness(businessId, status) {
+        return this.bookingApi.getAll({ businessId, status });
+    }
+    /**
+     * Get a single booking by ID
+     *
+     * @param id - Booking UUID
+     * @returns Promise resolving to booking data
+     */
+    async getById(id) {
+        return this.bookingApi.getById(id);
+    }
+    /**
+     * Create a new booking
+     *
+     * @param data - Booking creation data
+     * @returns Promise resolving to created booking
+     */
+    async create(data) {
+        // Validate check-out is after check-in
+        if (data.checkInDate && data.checkOutDate) {
+            const checkIn = new Date(data.checkInDate);
+            const checkOut = new Date(data.checkOutDate);
+            if (checkOut <= checkIn) {
+                throw new Error('Check-out date must be after check-in date');
+            }
+        }
+        return this.bookingApi.create(data);
+    }
+    /**
+     * Update an existing booking
+     *
+     * @param id - Booking UUID
+     * @param data - Booking update data
+     * @returns Promise resolving to updated booking
+     */
+    async update(id, data) {
+        // Validate dates if both provided
+        if (data.checkInDate && data.checkOutDate) {
+            const checkIn = new Date(data.checkInDate);
+            const checkOut = new Date(data.checkOutDate);
+            if (checkOut <= checkIn) {
+                throw new Error('Check-out date must be after check-in date');
+            }
+        }
+        return this.bookingApi.update(id, data);
+    }
+    /**
+     * Delete a booking
+     *
+     * @param id - Booking UUID
+     * @returns Promise resolving to success status
+     */
+    async delete(id) {
+        return this.bookingApi.delete(id);
+    }
+    /**
+     * Check if a user has an active or future booking
+     *
+     * Useful for eligibility checks on redemptions.
+     *
+     * @param userId - User ID to check
+     * @param options - Validation options (status filter, business filter)
+     * @returns Promise resolving to true if user has valid booking
+     */
+    async hasValidBooking(userId, options) {
+        const queryOptions = {
+            userId,
+            businessId: options?.businessId
+        };
+        // If a specific status is requested, use it
+        if (options?.status && options.status !== 'active_future') {
+            queryOptions.status = options.status === 'any' ? undefined : options.status;
+            const bookings = await this.bookingApi.getAll(queryOptions);
+            return bookings.length > 0;
+        }
+        // Default: check active+future (active_future or undefined)
+        const activeBookings = await this.bookingApi.getAll({ ...queryOptions, status: 'active' });
+        if (activeBookings.length > 0)
+            return true;
+        const futureBookings = await this.bookingApi.getAll({ ...queryOptions, status: 'future' });
+        return futureBookings.length > 0;
+    }
+}
+
+/**
+ * Booking Manager - High-level interface for booking operations
+ *
+ * Provides a simplified API for managing bookings (hotel stays, reservations, etc.)
+ * Used for tracking user stays and eligibility checks on redemptions.
+ *
+ * @group Managers
+ * @category Booking Management
+ *
+ * @example List Bookings
+ * ```typescript
+ * // Get all bookings
+ * const allBookings = await sdk.bookings.getAll();
+ *
+ * // Filter by user
+ * const userBookings = await sdk.bookings.getAll({ userId: 'user-123' });
+ *
+ * // Filter by status
+ * const activeBookings = await sdk.bookings.getAll({ status: 'active' });
+ * ```
+ *
+ * @example Create Booking
+ * ```typescript
+ * const booking = await sdk.bookings.create({
+ *   userId: 'user-123',
+ *   locationName: 'Grand Hotel',
+ *   checkInDate: '2026-06-01',
+ *   checkOutDate: '2026-06-05',
+ *   guests: 2
+ * });
+ * ```
+ *
+ * @example Check Eligibility
+ * ```typescript
+ * // Check if user has valid (active or future) booking
+ * const hasBooking = await sdk.bookings.hasValidBooking('user-123');
+ * if (hasBooking) {
+ *   // User is eligible for booking-required redemption
+ * }
+ * ```
+ */
+class BookingManager {
+    constructor(apiClient, events) {
+        this.apiClient = apiClient;
+        this.events = events;
+        const bookingApi = new BookingApi(apiClient);
+        this.bookingService = new BookingService(bookingApi);
+    }
+    /**
+     * Get all bookings with optional filters
+     *
+     * @param options - Filter options (userId, businessId, status)
+     * @returns Promise resolving to array of bookings
+     *
+     * @example Basic Usage
+     * ```typescript
+     * // All bookings
+     * const bookings = await sdk.bookings.getAll();
+     *
+     * // Filter by user
+     * const userBookings = await sdk.bookings.getAll({ userId: 'user-123' });
+     *
+     * // Filter by status
+     * const activeBookings = await sdk.bookings.getAll({ status: 'active' });
+     * const futureBookings = await sdk.bookings.getAll({ status: 'future' });
+     * const pastBookings = await sdk.bookings.getAll({ status: 'past' });
+     * ```
+     */
+    async getAll(options) {
+        return this.bookingService.getAll(options);
+    }
+    /**
+     * Get bookings for a specific user
+     *
+     * Convenience method for filtering bookings by user ID.
+     *
+     * @param userId - User ID to filter by
+     * @param status - Optional status filter
+     * @returns Promise resolving to user's bookings
+     */
+    async getByUser(userId, status) {
+        return this.bookingService.getByUser(userId, status);
+    }
+    /**
+     * Get bookings for a specific business
+     *
+     * Convenience method for filtering bookings by business ID.
+     *
+     * @param businessId - Business ID to filter by
+     * @param status - Optional status filter
+     * @returns Promise resolving to business's bookings
+     */
+    async getByBusiness(businessId, status) {
+        return this.bookingService.getByBusiness(businessId, status);
+    }
+    /**
+     * Get a single booking by ID
+     *
+     * @param id - Booking UUID
+     * @returns Promise resolving to booking data
+     * @throws {PersApiError} When booking not found
+     */
+    async getById(id) {
+        return this.bookingService.getById(id);
+    }
+    /**
+     * Create a new booking
+     *
+     * Creates a booking for a user at a specific location. Used for tracking
+     * hotel stays, reservations, etc. for eligibility checks.
+     *
+     * @param data - Booking creation data
+     * @returns Promise resolving to created booking
+     * @throws {Error} When check-out date is not after check-in date
+     *
+     * @example Create Hotel Booking
+     * ```typescript
+     * const booking = await sdk.bookings.create({
+     *   userId: 'user-123',
+     *   locationName: 'Grand Hotel',
+     *   locationType: 'hotel',
+     *   checkInDate: '2026-06-01',
+     *   checkOutDate: '2026-06-05',
+     *   confirmationNumber: 'CONF123',
+     *   guests: 2,
+     *   notes: 'Ocean view room'
+     * });
+     * ```
+     */
+    async create(data) {
+        const result = await this.bookingService.create(data);
+        // TODO: Add event emission when 'booking' domain is added to pers-shared
+        // this.events?.emitSuccess({ domain: 'booking', type: 'booking_created', ... });
+        return result;
+    }
+    /**
+     * Update an existing booking
+     *
+     * @param id - Booking UUID
+     * @param data - Booking update data (partial update supported)
+     * @returns Promise resolving to updated booking
+     * @throws {PersApiError} When booking not found
+     * @throws {Error} When check-out date is not after check-in date
+     *
+     * @example Update Booking Dates
+     * ```typescript
+     * const updated = await sdk.bookings.update('booking-123', {
+     *   checkInDate: '2026-06-02',
+     *   checkOutDate: '2026-06-07'
+     * });
+     * ```
+     */
+    async update(id, data) {
+        const result = await this.bookingService.update(id, data);
+        // TODO: Add event emission when 'booking' domain is added to pers-shared
+        // this.events?.emitSuccess({ domain: 'booking', type: 'booking_updated', ... });
+        return result;
+    }
+    /**
+     * Delete a booking
+     *
+     * @param id - Booking UUID
+     * @returns Promise resolving to success status
+     * @throws {PersApiError} When booking not found
+     */
+    async delete(id) {
+        const result = await this.bookingService.delete(id);
+        // TODO: Add event emission when 'booking' domain is added to pers-shared
+        // this.events?.emitSuccess({ domain: 'booking', type: 'booking_deleted', ... });
+        return result;
+    }
+    /**
+     * Check if a user has a valid (active or future) booking
+     *
+     * Useful for eligibility checks on redemptions that require a valid booking.
+     *
+     * @param userId - User ID to check
+     * @param options - Validation options (status filter, business filter)
+     * @returns Promise resolving to true if user has valid booking
+     *
+     * @example Eligibility Check
+     * ```typescript
+     * const hasBooking = await sdk.bookings.hasValidBooking('user-123');
+     *
+     * if (!hasBooking) {
+     *   console.log('User must have an active or upcoming booking');
+     * }
+     *
+     * // Check for active booking only
+     * const hasActive = await sdk.bookings.hasValidBooking('user-123', { status: 'active' });
+     *
+     * // Check for booking at specific business
+     * const hasHotelBooking = await sdk.bookings.hasValidBooking('user-123', {
+     *   businessId: 'hotel-123'
+     * });
+     * ```
+     */
+    async hasValidBooking(userId, options) {
+        return this.bookingService.hasValidBooking(userId, options);
+    }
+    /**
+     * Get the booking service for advanced operations
+     *
+     * @returns BookingService instance with full API access
+     */
+    getBookingService() {
+        return this.bookingService;
+    }
+}
+
 /**
  * @fileoverview PERS SDK - Platform-agnostic TypeScript SDK with High-Level Managers
  *
@@ -11248,6 +11672,47 @@ class PersSDK {
         }
         return this._customFields;
     }
+    /**
+     * Booking manager - High-level booking operations
+     *
+     * Provides methods for managing user bookings (hotel stays, reservations, etc.)
+     * Used for eligibility checks on redemptions that require valid bookings.
+     *
+     * @returns BookingManager instance
+     *
+     * @example List User Bookings
+     * ```typescript
+     * // Get all bookings for a user
+     * const bookings = await sdk.bookings.getByUser('user-123');
+     *
+     * // Filter by status
+     * const activeBookings = await sdk.bookings.getAll({ status: 'active' });
+     * ```
+     *
+     * @example Create Booking
+     * ```typescript
+     * const booking = await sdk.bookings.create({
+     *   userId: 'user-123',
+     *   locationName: 'Grand Hotel',
+     *   checkInDate: '2026-06-01',
+     *   checkOutDate: '2026-06-05'
+     * });
+     * ```
+     *
+     * @example Eligibility Check
+     * ```typescript
+     * const hasBooking = await sdk.bookings.hasValidBooking('user-123');
+     * if (hasBooking) {
+     *   // User is eligible for booking-required redemption
+     * }
+     * ```
+     */
+    get bookings() {
+        if (!this._bookings) {
+            this._bookings = new BookingManager(this.apiClient, this._events);
+        }
+        return this._bookings;
+    }
     /**
      * Wallet Events Manager - Real-time blockchain events for user's wallets
      *
@@ -11354,5 +11819,5 @@ function createPersSDK(httpClient, config) {
     return new PersSDK(httpClient, config);
 }
 
-export { AuthTokenManager as A, BusinessManager as B, CampaignManager as C, DefaultAuthProvider as D, WalletEventsManager as E, FATAL_AUTH_CODES as F, CustomFieldDefinitionManager as G, AuthStatus as H, IndexedDBTokenStorage as I, FileApi as J, FileService as K, LocalStorageTokenStorage as L, MemoryTokenStorage as M, ApiKeyApi as N, WebhookApi as O, PersSDK as P, WebhookService as Q, RedemptionManager as R, SDK_NAME as S, TokenManager as T, UserManager as U, PersEventsClient as V, WebDPoPCryptoProvider as W, createPersEventsClient as X, AUTH_STORAGE_KEYS as a, DPOP_STORAGE_KEYS as b, SDK_VERSION as c, SDK_USER_AGENT as d, createPersSDK as e, PersApiClient as f, DEFAULT_PERS_CONFIG as g, buildApiRoot as h, buildWalletEventsWsUrl as i, StaticJwtAuthProvider as j, AuthApi as k, isFatalAuthErrorInMessage as l, mergeWithDefaults as m, AuthService as n, DPoPManager as o, PersEventEmitter as p, AuthManager as q, UserStatusManager as r, TransactionManager as s, PurchaseManager as t, FileManager as u, ApiKeyManager as v, AnalyticsManager as w, DonationManager as x, TriggerSourceManager as y, WebhookManager as z };
-//# sourceMappingURL=pers-sdk-CBRtrG03.js.map
+export { AuthTokenManager as A, BusinessManager as B, CampaignManager as C, DefaultAuthProvider as D, WalletEventsManager as E, FATAL_AUTH_CODES as F, CustomFieldDefinitionManager as G, BookingManager as H, IndexedDBTokenStorage as I, AuthStatus as J, FileApi as K, LocalStorageTokenStorage as L, MemoryTokenStorage as M, FileService as N, ApiKeyApi as O, PersSDK as P, WebhookApi as Q, RedemptionManager as R, SDK_NAME as S, TokenManager as T, UserManager as U, WebhookService as V, WebDPoPCryptoProvider as W, BookingApi as X, BookingService as Y, PersEventsClient as Z, createPersEventsClient as _, AUTH_STORAGE_KEYS as a, DPOP_STORAGE_KEYS as b, SDK_VERSION as c, SDK_USER_AGENT as d, createPersSDK as e, PersApiClient as f, DEFAULT_PERS_CONFIG as g, buildApiRoot as h, buildWalletEventsWsUrl as i, StaticJwtAuthProvider as j, AuthApi as k, isFatalAuthErrorInMessage as l, mergeWithDefaults as m, AuthService as n, DPoPManager as o, PersEventEmitter as p, AuthManager as q, UserStatusManager as r, TransactionManager as s, PurchaseManager as t, FileManager as u, ApiKeyManager as v, AnalyticsManager as w, DonationManager as x, TriggerSourceManager as y, WebhookManager as z };
+//# sourceMappingURL=pers-sdk-C01Z2nmP.js.map