@atzentis/booking-sdk 0.1.6 → 0.1.8

package/dist/index.cjs

@@ -37,11 +37,15 @@ __export(index_exports, {
   CategoriesService: () => CategoriesService,
   ConflictError: () => ConflictError,
   DEFAULT_MODULES: () => DEFAULT_MODULES,
+  DistributionService: () => DistributionService,
+  FinanceService: () => FinanceService,
   ForbiddenError: () => ForbiddenError,
+  GuestsService: () => GuestsService,
   HttpClient: () => HttpClient,
   NotFoundError: () => NotFoundError,
   PROPERTY_MODULES: () => PROPERTY_MODULES,
   PaymentError: () => PaymentError,
+  PaymentsService: () => PaymentsService,
   PropertiesService: () => PropertiesService,
   RateLimitError: () => RateLimitError,
   SPACE_STATUSES: () => SPACE_STATUSES,
@@ -1091,6 +1095,613 @@ var CategoriesService = class extends BaseService {
   }
 };
 
+// src/services/distribution.ts
+var DistributionService = class extends BaseService {
+  constructor() {
+    super(...arguments);
+    this.basePath = "/distribution/v1";
+  }
+  // ---------------------------------------------------------------------------
+  // Channel CRUD
+  // ---------------------------------------------------------------------------
+  /** Create a new distribution channel */
+  createChannel(input) {
+    return this._post(this._buildPath("channels"), input);
+  }
+  /** Get a channel by ID */
+  getChannel(channelId) {
+    return this._get(this._buildPath("channels", channelId));
+  }
+  /** List channels with optional filters */
+  listChannels(params) {
+    if (!params) return this._get(this._buildPath("channels"));
+    const query = {};
+    if (params.propertyId !== void 0) query.propertyId = params.propertyId;
+    if (params.type !== void 0) query.type = params.type;
+    if (params.status !== void 0) query.status = params.status;
+    if (params.enabled !== void 0) query.enabled = params.enabled;
+    if (params.limit !== void 0) query.limit = params.limit;
+    if (params.cursor !== void 0) query.cursor = params.cursor;
+    return this._get(this._buildPath("channels"), query);
+  }
+  /** Update a channel */
+  updateChannel(channelId, input) {
+    return this._patch(this._buildPath("channels", channelId), input);
+  }
+  /** Delete a channel */
+  deleteChannel(channelId) {
+    return this._delete(this._buildPath("channels", channelId));
+  }
+  // ---------------------------------------------------------------------------
+  // Mapping management
+  // ---------------------------------------------------------------------------
+  /** Create a mapping between a local category and OTA room type/rate plan */
+  createMapping(channelId, input) {
+    return this._post(this._buildPath("channels", channelId, "mappings"), input);
+  }
+  /** List mappings for a channel */
+  listMappings(channelId, params) {
+    if (!params) {
+      return this._get(this._buildPath("channels", channelId, "mappings"));
+    }
+    const query = {};
+    if (params.localCategoryId !== void 0) query.localCategoryId = params.localCategoryId;
+    if (params.limit !== void 0) query.limit = params.limit;
+    if (params.cursor !== void 0) query.cursor = params.cursor;
+    return this._get(this._buildPath("channels", channelId, "mappings"), query);
+  }
+  /** Delete a mapping */
+  deleteMapping(channelId, mappingId) {
+    return this._delete(this._buildPath("channels", channelId, "mappings", mappingId));
+  }
+  // ---------------------------------------------------------------------------
+  // Push/pull sync
+  // ---------------------------------------------------------------------------
+  /** Push availability and rates to a channel */
+  push(channelId, input) {
+    return this._post(this._buildPath("channels", channelId, "push"), input ?? {});
+  }
+  /** Pull reservations from a channel */
+  pull(channelId, input) {
+    return this._post(this._buildPath("channels", channelId, "pull"), input ?? {});
+  }
+  /** Get sync operation log for a channel */
+  getSyncLog(channelId, params) {
+    if (!params) {
+      return this._get(this._buildPath("channels", channelId, "sync-log"));
+    }
+    const query = {};
+    if (params.type !== void 0) query.type = params.type;
+    if (params.status !== void 0) query.status = params.status;
+    if (params.from !== void 0) query.from = params.from;
+    if (params.to !== void 0) query.to = params.to;
+    if (params.limit !== void 0) query.limit = params.limit;
+    if (params.cursor !== void 0) query.cursor = params.cursor;
+    return this._get(this._buildPath("channels", channelId, "sync-log"), query);
+  }
+  // ---------------------------------------------------------------------------
+  // iCal import/export
+  // ---------------------------------------------------------------------------
+  /** Import availability from an external iCal feed */
+  icalImport(input) {
+    return this._post(this._buildPath("ical", "import"), input);
+  }
+  /** Get iCal export URL for a space */
+  icalExport(spaceId) {
+    return this._get(this._buildPath("ical", "export", spaceId));
+  }
+};
+
+// src/services/finance.ts
+var FinanceService = class extends BaseService {
+  constructor() {
+    super(...arguments);
+    this.basePath = "/finance/v1";
+  }
+  // ---------------------------------------------------------------------------
+  // Folio CRUD and lifecycle
+  // ---------------------------------------------------------------------------
+  /** Create a new folio for a booking */
+  createFolio(input) {
+    return this._post(this._buildPath("folios"), input);
+  }
+  /** Get a folio by ID */
+  getFolio(folioId) {
+    return this._get(this._buildPath("folios", folioId));
+  }
+  /** List folios with optional filters */
+  listFolios(params) {
+    if (!params) return this._get(this._buildPath("folios"));
+    const query = {};
+    if (params.bookingId !== void 0) query.bookingId = params.bookingId;
+    if (params.guestId !== void 0) query.guestId = params.guestId;
+    if (params.status !== void 0) query.status = params.status;
+    if (params.limit !== void 0) query.limit = params.limit;
+    if (params.cursor !== void 0) query.cursor = params.cursor;
+    return this._get(this._buildPath("folios"), query);
+  }
+  /** Update a folio */
+  updateFolio(folioId, input) {
+    return this._patch(this._buildPath("folios", folioId), input);
+  }
+  /** Close a folio (no more charges can be added) */
+  closeFolio(folioId) {
+    return this._post(this._buildPath("folios", folioId, "close"), {});
+  }
+  /** Settle a folio (mark as fully paid) */
+  settleFolio(folioId) {
+    return this._post(this._buildPath("folios", folioId, "settle"), {});
+  }
+  // ---------------------------------------------------------------------------
+  // Charge operations
+  // ---------------------------------------------------------------------------
+  /** Create a charge on a folio */
+  createCharge(folioId, input) {
+    return this._post(this._buildPath("folios", folioId, "charges"), input);
+  }
+  /** List charges on a folio */
+  listCharges(folioId, params) {
+    if (!params) {
+      return this._get(this._buildPath("folios", folioId, "charges"));
+    }
+    const query = {};
+    if (params.type !== void 0) query.type = params.type;
+    if (params.limit !== void 0) query.limit = params.limit;
+    if (params.cursor !== void 0) query.cursor = params.cursor;
+    return this._get(this._buildPath("folios", folioId, "charges"), query);
+  }
+  /** Create a transitory (non-billable) charge on a folio */
+  createTransitoryCharge(folioId, input) {
+    return this._post(
+      this._buildPath("folios", folioId, "charges", "transitory"),
+      input
+    );
+  }
+  /** Move charges from one folio to another */
+  moveCharges(folioId, input) {
+    return this._post(
+      this._buildPath("folios", folioId, "charges", "move"),
+      input
+    );
+  }
+  // ---------------------------------------------------------------------------
+  // Folio payment operations
+  // ---------------------------------------------------------------------------
+  /** Record a payment on a folio */
+  createFolioPayment(folioId, input) {
+    return this._post(this._buildPath("folios", folioId, "payments"), input);
+  }
+  /** List payments on a folio */
+  listFolioPayments(folioId, params) {
+    if (!params) {
+      return this._get(this._buildPath("folios", folioId, "payments"));
+    }
+    const query = {};
+    if (params.limit !== void 0) query.limit = params.limit;
+    if (params.cursor !== void 0) query.cursor = params.cursor;
+    return this._get(this._buildPath("folios", folioId, "payments"), query);
+  }
+  // ---------------------------------------------------------------------------
+  // Invoice operations
+  // ---------------------------------------------------------------------------
+  /** Generate an invoice for a folio */
+  generateInvoice(folioId, input) {
+    return this._post(this._buildPath("folios", folioId, "invoice"), input ?? {});
+  }
+  /** Get an invoice by ID */
+  getInvoice(invoiceId) {
+    return this._get(this._buildPath("invoices", invoiceId));
+  }
+  /** Get invoice as PDF binary data */
+  getInvoicePdf(invoiceId) {
+    return this._get(this._buildPath("invoices", invoiceId, "pdf"));
+  }
+  // ---------------------------------------------------------------------------
+  // Accounting reports
+  // ---------------------------------------------------------------------------
+  /** Get daily accounting report */
+  getDailyReport(params) {
+    if (!params) return this._get(this._buildPath("accounting", "daily"));
+    const query = {};
+    if (params.date !== void 0) query.date = params.date;
+    if (params.propertyId !== void 0) query.propertyId = params.propertyId;
+    return this._get(this._buildPath("accounting", "daily"), query);
+  }
+  /** Get revenue report by charge type */
+  getRevenueReport(params) {
+    if (!params)
+      return this._get(this._buildPath("accounting", "revenue"));
+    const query = {};
+    if (params.from !== void 0) query.from = params.from;
+    if (params.to !== void 0) query.to = params.to;
+    if (params.propertyId !== void 0) query.propertyId = params.propertyId;
+    return this._get(this._buildPath("accounting", "revenue"), query);
+  }
+  /** Get VAT accounting report */
+  getVatReport(params) {
+    if (!params) return this._get(this._buildPath("accounting", "vat"));
+    const query = {};
+    if (params.from !== void 0) query.from = params.from;
+    if (params.to !== void 0) query.to = params.to;
+    if (params.propertyId !== void 0) query.propertyId = params.propertyId;
+    return this._get(this._buildPath("accounting", "vat"), query);
+  }
+};
+
+// 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/payments.ts
+var PaymentsService = class extends BaseService {
+  constructor() {
+    super(...arguments);
+    this.basePath = "/payment/v1";
+  }
+  // ---------------------------------------------------------------------------
+  // Process and refund
+  // ---------------------------------------------------------------------------
+  /** Process a payment for a booking */
+  process(input) {
+    return this._post(this._buildPath("payments"), input);
+  }
+  /** Refund a payment (full or partial) */
+  refund(paymentId, input) {
+    return this._post(this._buildPath("payments", paymentId, "refund"), input ?? {});
+  }
+  // ---------------------------------------------------------------------------
+  // Transactions
+  // ---------------------------------------------------------------------------
+  /** Get a transaction by ID */
+  getTransaction(transactionId) {
+    return this._get(this._buildPath("transactions", transactionId));
+  }
+  /** List transactions with optional filters */
+  listTransactions(params) {
+    if (!params) return this._get(this._buildPath("transactions"));
+    const query = {};
+    if (params.bookingId !== void 0) query.bookingId = params.bookingId;
+    if (params.status !== void 0) query.status = params.status;
+    if (params.provider !== void 0) query.provider = params.provider;
+    if (params.type !== void 0) query.type = params.type;
+    if (params.from !== void 0) query.from = params.from;
+    if (params.to !== void 0) query.to = params.to;
+    if (params.limit !== void 0) query.limit = params.limit;
+    if (params.cursor !== void 0) query.cursor = params.cursor;
+    return this._get(this._buildPath("transactions"), query);
+  }
+  // ---------------------------------------------------------------------------
+  // Payment accounts (stored cards)
+  // ---------------------------------------------------------------------------
+  /** Create a payment account (store a card on file) */
+  createAccount(input) {
+    return this._post(this._buildPath("accounts"), input);
+  }
+  /** Get a payment account by ID */
+  getAccount(accountId) {
+    return this._get(this._buildPath("accounts", accountId));
+  }
+  /** List payment accounts with optional filters */
+  listAccounts(params) {
+    if (!params) return this._get(this._buildPath("accounts"));
+    const query = {};
+    if (params.bookingId !== void 0) query.bookingId = params.bookingId;
+    if (params.guestId !== void 0) query.guestId = params.guestId;
+    if (params.status !== void 0) query.status = params.status;
+    if (params.limit !== void 0) query.limit = params.limit;
+    if (params.cursor !== void 0) query.cursor = params.cursor;
+    return this._get(this._buildPath("accounts"), query);
+  }
+  /** Delete a payment account */
+  deleteAccount(accountId) {
+    return this._delete(this._buildPath("accounts", accountId));
+  }
+  // ---------------------------------------------------------------------------
+  // Authorize and capture
+  // ---------------------------------------------------------------------------
+  /** Authorize a hold on a stored card */
+  authorize(accountId, input) {
+    return this._post(this._buildPath("accounts", accountId, "authorize"), input);
+  }
+  /** Capture a previously authorized hold */
+  capture(accountId, input) {
+    return this._post(this._buildPath("accounts", accountId, "capture"), input);
+  }
+  // ---------------------------------------------------------------------------
+  // Terminal operations
+  // ---------------------------------------------------------------------------
+  /** Initiate a POS terminal payment authorization */
+  terminalAuthorize(input) {
+    return this._post(this._buildPath("terminal", "authorize"), input);
+  }
+  // ---------------------------------------------------------------------------
+  // IRIS operations
+  // ---------------------------------------------------------------------------
+  /** Initiate an IRIS instant bank transfer */
+  irisInitiate(input) {
+    return this._post(this._buildPath("iris", "initiate"), input);
+  }
+  /** Get the status of an IRIS transfer */
+  irisStatus(transferId) {
+    return this._get(this._buildPath("iris", transferId));
+  }
+};
+
 // src/services/properties.ts
 var PropertiesService = class extends BaseService {
   constructor() {
@@ -1320,6 +1931,26 @@ var BookingClient = class {
     this._bookings ?? (this._bookings = new BookingsService(this.httpClient));
     return this._bookings;
   }
+  /** Distribution service — lazy-initialized on first access */
+  get distribution() {
+    this._distribution ?? (this._distribution = new DistributionService(this.httpClient));
+    return this._distribution;
+  }
+  /** Finance service — lazy-initialized on first access */
+  get finance() {
+    this._finance ?? (this._finance = new FinanceService(this.httpClient));
+    return this._finance;
+  }
+  /** Guests service — lazy-initialized on first access */
+  get guests() {
+    this._guests ?? (this._guests = new GuestsService(this.httpClient));
+    return this._guests;
+  }
+  /** Payments service — lazy-initialized on first access */
+  get payments() {
+    this._payments ?? (this._payments = new PaymentsService(this.httpClient));
+    return this._payments;
+  }
   /** Properties service — lazy-initialized on first access */
   get properties() {
     this._properties ?? (this._properties = new PropertiesService(this.httpClient));
@@ -1453,11 +2084,15 @@ var VERSION = "0.1.0";
   CategoriesService,
   ConflictError,
   DEFAULT_MODULES,
+  DistributionService,
+  FinanceService,
   ForbiddenError,
+  GuestsService,
   HttpClient,
   NotFoundError,
   PROPERTY_MODULES,
   PaymentError,
+  PaymentsService,
   PropertiesService,
   RateLimitError,
   SPACE_STATUSES,