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

package/dist/chunks/{pers-sdk-DcNDMx1Y.cjs → pers-sdk-DEfiDbIs.cjs}

@@ -1587,7 +1587,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.3";
 /** Full SDK identifier for headers */
 const SDK_USER_AGENT = `${SDK_NAME}/${SDK_VERSION}`;
 
@@ -1923,6 +1923,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;
     }
     // ==========================================
@@ -10531,6 +10549,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
  *
@@ -11250,6 +11674,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
      *
@@ -11364,6 +11829,9 @@ exports.AuthApi = AuthApi;
 exports.AuthManager = AuthManager;
 exports.AuthService = AuthService;
 exports.AuthTokenManager = AuthTokenManager;
+exports.BookingApi = BookingApi;
+exports.BookingManager = BookingManager;
+exports.BookingService = BookingService;
 exports.BusinessManager = BusinessManager;
 exports.CampaignManager = CampaignManager;
 exports.CustomFieldDefinitionManager = CustomFieldDefinitionManager;
@@ -11405,4 +11873,4 @@ exports.createPersEventsClient = createPersEventsClient;
 exports.createPersSDK = createPersSDK;
 exports.isFatalAuthErrorInMessage = isFatalAuthErrorInMessage;
 exports.mergeWithDefaults = mergeWithDefaults;
-//# sourceMappingURL=pers-sdk-DcNDMx1Y.cjs.map
+//# sourceMappingURL=pers-sdk-DEfiDbIs.cjs.map