@atzentis/booking-sdk 0.1.6 → 0.1.7

package/dist/index.js

@@ -1039,6 +1039,285 @@ var CategoriesService = class extends BaseService {
   }
 };
 
+// src/services/guests.ts
+var GuestsService = class extends BaseService {
+  constructor() {
+    super(...arguments);
+    this.basePath = "/guest/v1/profiles";
+  }
+  // ---------------------------------------------------------------------------
+  // CRUD
+  // ---------------------------------------------------------------------------
+  /**
+   * Create a new guest profile.
+   *
+   * @example
+   * ```typescript
+   * const guest = await client.guests.create({
+   *   firstName: "Maria",
+   *   lastName: "Papadopoulou",
+   *   email: "maria@example.com",
+   *   phone: "+30 210 1234567",
+   *   nationality: "GR",
+   * });
+   * ```
+   */
+  create(input) {
+    return this._post(this.basePath, input);
+  }
+  /**
+   * Get a single guest by ID.
+   *
+   * @example
+   * ```typescript
+   * const guest = await client.guests.get("guest_42");
+   * ```
+   */
+  get(guestId) {
+    return this._get(this._buildPath(guestId));
+  }
+  /**
+   * List guests with optional filters and cursor-based pagination.
+   *
+   * @example
+   * ```typescript
+   * const page = await client.guests.list({
+   *   tags: ["vip", "returning"],
+   *   sort: { field: "lastName", direction: "asc" },
+   *   limit: 20,
+   * });
+   * ```
+   */
+  list(params) {
+    if (!params) {
+      return this._get(this.basePath);
+    }
+    const query = {};
+    if (params.tags !== void 0 && params.tags.length > 0) {
+      query.tags = params.tags.join(",");
+    }
+    if (params.source !== void 0) query.source = params.source;
+    if (params.createdFrom !== void 0) query.createdFrom = params.createdFrom;
+    if (params.createdTo !== void 0) query.createdTo = params.createdTo;
+    if (params.sort !== void 0) {
+      query.sort = `${params.sort.field}:${params.sort.direction}`;
+    }
+    if (params.limit !== void 0) query.limit = params.limit;
+    if (params.cursor !== void 0) query.cursor = params.cursor;
+    return this._get(this.basePath, query);
+  }
+  /**
+   * Update an existing guest profile.
+   *
+   * @example
+   * ```typescript
+   * const updated = await client.guests.update("guest_42", {
+   *   email: "maria.new@example.com",
+   *   tags: ["vip"],
+   * });
+   * ```
+   */
+  update(guestId, input) {
+    return this._patch(this._buildPath(guestId), input);
+  }
+  /**
+   * Delete a guest profile (soft-delete).
+   *
+   * @example
+   * ```typescript
+   * await client.guests.delete("guest_42");
+   * ```
+   */
+  delete(guestId) {
+    return this._delete(this._buildPath(guestId));
+  }
+  // ---------------------------------------------------------------------------
+  // Search and Duplicate Detection
+  // ---------------------------------------------------------------------------
+  /**
+   * Search guests by name, email, phone, or passport number.
+   *
+   * Returns results sorted by relevance score (highest first).
+   *
+   * @param query - Search query string
+   * @param params - Optional search parameters (limit, fields)
+   *
+   * @example
+   * ```typescript
+   * // Search by name
+   * const results = await client.guests.search("Papadopoulos");
+   *
+   * // Search by email with field filter
+   * const results2 = await client.guests.search("maria@", {
+   *   fields: ["email"],
+   *   limit: 5,
+   * });
+   * ```
+   */
+  search(query, params) {
+    const searchQuery = {
+      q: query
+    };
+    if (params?.limit !== void 0) searchQuery.limit = params.limit;
+    if (params?.fields !== void 0 && params.fields.length > 0) {
+      searchQuery.fields = params.fields.join(",");
+    }
+    return this._get(this._buildPath("search"), searchQuery);
+  }
+  /**
+   * Find potential duplicate profiles for a guest.
+   *
+   * Returns candidates sorted by confidence score (highest first).
+   *
+   * @throws {NotFoundError} 404 if the guest is not found
+   *
+   * @example
+   * ```typescript
+   * const duplicates = await client.guests.findDuplicates("guest_42");
+   * for (const dup of duplicates.data) {
+   *   console.log(`${dup.guest.firstName} — ${dup.confidence} (${dup.matchedFields})`);
+   * }
+   * ```
+   */
+  findDuplicates(guestId) {
+    return this._get(this._buildPath(guestId, "duplicates"));
+  }
+  // ---------------------------------------------------------------------------
+  // Merge
+  // ---------------------------------------------------------------------------
+  /**
+   * Merge duplicate guest profiles into a primary profile.
+   *
+   * **Warning: This operation is irreversible.** All history from duplicate
+   * profiles is transferred to the primary. Duplicate profiles are soft-deleted.
+   *
+   * @throws {NotFoundError} 404 if primary or any duplicate is not found
+   * @throws {ConflictError} 409 if attempting to merge a guest into itself
+   * @throws {ValidationError} 400 if duplicateIds is empty
+   *
+   * @example
+   * ```typescript
+   * const merged = await client.guests.merge("guest_primary", {
+   *   duplicateIds: ["guest_dup1", "guest_dup2"],
+   * });
+   * ```
+   */
+  merge(primaryId, input) {
+    return this._post(this._buildPath(primaryId, "merge"), input);
+  }
+  // ---------------------------------------------------------------------------
+  // Preferences
+  // ---------------------------------------------------------------------------
+  /**
+   * Get guest preferences.
+   *
+   * Returns default/empty preferences if none have been set (does not throw 404).
+   *
+   * @throws {NotFoundError} 404 if the guest is not found
+   *
+   * @example
+   * ```typescript
+   * const prefs = await client.guests.getPreferences("guest_42");
+   * console.log(prefs.dietary, prefs.roomType);
+   * ```
+   */
+  getPreferences(guestId) {
+    return this._get(this._buildPath(guestId, "preferences"));
+  }
+  /**
+   * Update guest preferences (partial merge).
+   *
+   * Only provided fields are updated; unspecified fields retain their values.
+   *
+   * @throws {NotFoundError} 404 if the guest is not found
+   *
+   * @example
+   * ```typescript
+   * const updated = await client.guests.updatePreferences("guest_42", {
+   *   dietary: ["vegetarian"],
+   *   roomType: "suite",
+   *   custom: { pillow: "firm" },
+   * });
+   * ```
+   */
+  updatePreferences(guestId, input) {
+    return this._patch(this._buildPath(guestId, "preferences"), input);
+  }
+  // ---------------------------------------------------------------------------
+  // Cross-Domain History
+  // ---------------------------------------------------------------------------
+  /**
+   * Get a guest's booking history.
+   *
+   * Returns lightweight booking summaries with pagination support.
+   *
+   * @throws {NotFoundError} 404 if the guest is not found
+   *
+   * @example
+   * ```typescript
+   * const bookings = await client.guests.getBookings("guest_42", {
+   *   from: "2025-01-01",
+   *   to: "2025-12-31",
+   *   limit: 10,
+   * });
+   * ```
+   */
+  getBookings(guestId, params) {
+    return this._get(
+      this._buildPath(guestId, "bookings"),
+      params ? this._buildHistoryQuery(params) : void 0
+    );
+  }
+  /**
+   * Get a guest's folio history.
+   *
+   * Returns lightweight folio summaries with pagination support.
+   *
+   * @throws {NotFoundError} 404 if the guest is not found
+   *
+   * @example
+   * ```typescript
+   * const folios = await client.guests.getFolios("guest_42");
+   * ```
+   */
+  getFolios(guestId, params) {
+    return this._get(
+      this._buildPath(guestId, "folios"),
+      params ? this._buildHistoryQuery(params) : void 0
+    );
+  }
+  /**
+   * Get a guest's order history.
+   *
+   * Returns lightweight order summaries with pagination support.
+   *
+   * @throws {NotFoundError} 404 if the guest is not found
+   *
+   * @example
+   * ```typescript
+   * const orders = await client.guests.getOrders("guest_42", {
+   *   limit: 5,
+   *   cursor: "next_page",
+   * });
+   * ```
+   */
+  getOrders(guestId, params) {
+    return this._get(
+      this._buildPath(guestId, "orders"),
+      params ? this._buildHistoryQuery(params) : void 0
+    );
+  }
+  /** Build query params from GuestHistoryParams, omitting undefined values */
+  _buildHistoryQuery(params) {
+    const query = {};
+    if (params.limit !== void 0) query.limit = params.limit;
+    if (params.cursor !== void 0) query.cursor = params.cursor;
+    if (params.from !== void 0) query.from = params.from;
+    if (params.to !== void 0) query.to = params.to;
+    return query;
+  }
+};
+
 // src/services/properties.ts
 var PropertiesService = class extends BaseService {
   constructor() {
@@ -1268,6 +1547,11 @@ var BookingClient = class {
     this._bookings ?? (this._bookings = new BookingsService(this.httpClient));
     return this._bookings;
   }
+  /** Guests service — lazy-initialized on first access */
+  get guests() {
+    this._guests ?? (this._guests = new GuestsService(this.httpClient));
+    return this._guests;
+  }
   /** Properties service — lazy-initialized on first access */
   get properties() {
     this._properties ?? (this._properties = new PropertiesService(this.httpClient));
@@ -1401,6 +1685,7 @@ export {
   ConflictError,
   DEFAULT_MODULES,
   ForbiddenError,
+  GuestsService,
   HttpClient,
   NotFoundError,
   PROPERTY_MODULES,