@atzentis/booking-sdk 0.1.6 → 0.1.8

package/dist/index.d.ts

@@ -1197,6 +1197,1266 @@ declare class CategoriesService extends BaseService {
     delete(categoryId: string): Promise<void>;
 }
 
+/** Supported distribution channel types */
+type ChannelType = "channex" | "ical" | "direct";
+/** Channel connection status */
+type ChannelStatus = "active" | "inactive" | "error" | "pending";
+/** Credentials for channel authentication (redacted in responses) */
+type ChannelCredentials = Record<string, unknown>;
+/** Channel sync configuration */
+interface ChannelSettings {
+    autoSync?: boolean;
+    syncInterval?: number;
+    pushAvailability?: boolean;
+    pushRates?: boolean;
+    pullReservations?: boolean;
+}
+/** A distribution channel connection */
+interface Channel {
+    id: string;
+    propertyId: string;
+    type: ChannelType;
+    name: string;
+    status: ChannelStatus;
+    enabled: boolean;
+    credentials: ChannelCredentials;
+    settings: ChannelSettings;
+    lastSyncAt: string | null;
+    metadata: Record<string, unknown> | null;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Input for creating a new channel */
+interface CreateChannelInput {
+    propertyId: string;
+    type: ChannelType;
+    name?: string;
+    enabled?: boolean;
+    credentials?: ChannelCredentials;
+    settings?: ChannelSettings;
+    metadata?: Record<string, unknown>;
+}
+/** Input for updating an existing channel */
+interface UpdateChannelInput {
+    name?: string;
+    enabled?: boolean;
+    credentials?: ChannelCredentials;
+    settings?: ChannelSettings;
+    metadata?: Record<string, unknown>;
+}
+/** Parameters for listing channels */
+interface ListChannelsParams {
+    propertyId?: string;
+    type?: ChannelType;
+    status?: ChannelStatus;
+    enabled?: boolean;
+    limit?: number;
+    cursor?: string;
+}
+/** Paginated list of channels */
+type PaginatedChannels = Paginated<Channel>;
+/** Mapping between local category and OTA room type/rate plan */
+interface ChannelMapping {
+    id: string;
+    channelId: string;
+    localCategoryId: string;
+    channelRoomTypeId: string | null;
+    channelRatePlanId: string | null;
+    settings: Record<string, unknown> | null;
+    metadata: Record<string, unknown> | null;
+    createdAt: string;
+}
+/** Input for creating a channel mapping */
+interface CreateMappingInput {
+    localCategoryId: string;
+    channelRoomTypeId?: string;
+    channelRatePlanId?: string;
+    settings?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+}
+/** Parameters for listing mappings */
+interface ListMappingsParams {
+    localCategoryId?: string;
+    limit?: number;
+    cursor?: string;
+}
+/** Paginated list of channel mappings */
+type PaginatedMappings = Paginated<ChannelMapping>;
+/** Type of sync operation */
+type SyncOperationType = "push" | "pull";
+/** Status of a sync operation */
+type SyncOperationStatus = "pending" | "running" | "completed" | "failed";
+/** Statistics from a sync operation */
+interface SyncStats {
+    itemsSynced: number;
+    itemsFailed: number;
+    warnings: string[];
+}
+/** Error encountered during sync */
+interface SyncError {
+    code: string;
+    message: string;
+    details: Record<string, unknown> | null;
+}
+/** A sync operation record */
+interface SyncOperation {
+    id: string;
+    channelId: string;
+    type: SyncOperationType;
+    status: SyncOperationStatus;
+    startedAt: string | null;
+    completedAt: string | null;
+    stats: SyncStats | null;
+    errors: SyncError[];
+    createdAt: string;
+}
+/** Input for push sync */
+interface PushSyncInput {
+    dateFrom?: string;
+    dateTo?: string;
+    fullSync?: boolean;
+}
+/** Input for pull sync */
+interface PullSyncInput {
+    dateFrom?: string;
+    dateTo?: string;
+}
+/** Parameters for querying sync log */
+interface SyncLogParams {
+    type?: SyncOperationType;
+    status?: SyncOperationStatus;
+    from?: string;
+    to?: string;
+    limit?: number;
+    cursor?: string;
+}
+/** Paginated sync operation log */
+type PaginatedSyncLog = Paginated<SyncOperation>;
+/** Input for iCal import */
+interface ICalImportInput {
+    spaceId: string;
+    importUrl: string;
+    name?: string;
+    autoSync?: boolean;
+}
+/** Result of an iCal import operation */
+interface ICalImportResult {
+    id: string;
+    spaceId: string;
+    importUrl: string;
+    eventsImported: number;
+    lastImportedAt: string | null;
+    status: string;
+}
+/** Result of an iCal export operation */
+interface ICalExportResult {
+    spaceId: string;
+    exportUrl: string;
+    lastExportedAt: string | null;
+}
+
+/**
+ * Service for managing distribution channels in the Atzentis Booking API.
+ *
+ * Provides channel CRUD, mapping management, push/pull sync operations,
+ * sync log retrieval, and iCal import/export.
+ *
+ * @example
+ * ```typescript
+ * const booking = new BookingClient({ apiKey: "atz_io_live_xxxxx" });
+ *
+ * // Create a Channex connection
+ * const channel = await booking.distribution.createChannel({
+ *   propertyId: "prop_abc123",
+ *   type: "channex",
+ *   name: "Booking.com via Channex",
+ * });
+ *
+ * // Push availability to channel
+ * await booking.distribution.push(channel.id, {
+ *   dateFrom: "2025-07-01",
+ *   dateTo: "2025-12-31",
+ * });
+ * ```
+ */
+declare class DistributionService extends BaseService {
+    protected readonly basePath = "/distribution/v1";
+    /** Create a new distribution channel */
+    createChannel(input: CreateChannelInput): Promise<Channel>;
+    /** Get a channel by ID */
+    getChannel(channelId: string): Promise<Channel>;
+    /** List channels with optional filters */
+    listChannels(params?: ListChannelsParams): Promise<PaginatedChannels>;
+    /** Update a channel */
+    updateChannel(channelId: string, input: UpdateChannelInput): Promise<Channel>;
+    /** Delete a channel */
+    deleteChannel(channelId: string): Promise<void>;
+    /** Create a mapping between a local category and OTA room type/rate plan */
+    createMapping(channelId: string, input: CreateMappingInput): Promise<ChannelMapping>;
+    /** List mappings for a channel */
+    listMappings(channelId: string, params?: ListMappingsParams): Promise<PaginatedMappings>;
+    /** Delete a mapping */
+    deleteMapping(channelId: string, mappingId: string): Promise<void>;
+    /** Push availability and rates to a channel */
+    push(channelId: string, input?: PushSyncInput): Promise<SyncOperation>;
+    /** Pull reservations from a channel */
+    pull(channelId: string, input?: PullSyncInput): Promise<SyncOperation>;
+    /** Get sync operation log for a channel */
+    getSyncLog(channelId: string, params?: SyncLogParams): Promise<PaginatedSyncLog>;
+    /** Import availability from an external iCal feed */
+    icalImport(input: ICalImportInput): Promise<ICalImportResult>;
+    /** Get iCal export URL for a space */
+    icalExport(spaceId: string): Promise<ICalExportResult>;
+}
+
+/** Status of a folio */
+type FolioStatus = "open" | "closed" | "settled";
+/** A guest folio (accounting record) */
+interface Folio {
+    id: string;
+    bookingId: string;
+    guestId: string | null;
+    status: FolioStatus;
+    balance: number;
+    totalCharges: number;
+    totalPayments: number;
+    currency: string;
+    metadata: Record<string, unknown> | null;
+    createdAt: string;
+    updatedAt: string;
+    closedAt: string | null;
+    settledAt: string | null;
+}
+/** Input for creating a folio */
+interface CreateFolioInput {
+    bookingId: string;
+    guestId?: string;
+    currency?: string;
+    metadata?: Record<string, unknown>;
+}
+/** Input for updating a folio */
+interface UpdateFolioInput {
+    guestId?: string;
+    metadata?: Record<string, unknown>;
+}
+/** Parameters for listing folios */
+interface ListFoliosParams {
+    bookingId?: string;
+    guestId?: string;
+    status?: FolioStatus;
+    limit?: number;
+    cursor?: string;
+}
+/** Paginated list of folios */
+type PaginatedFolios = Paginated<Folio>;
+/** Type of charge applied to a folio */
+type ChargeType = "room" | "minibar" | "restaurant" | "spa" | "parking" | "telephone" | "laundry" | "other";
+/** A charge on a folio */
+interface FolioCharge {
+    id: string;
+    folioId: string;
+    type: ChargeType;
+    description: string | null;
+    amount: number;
+    currency: string;
+    transitory: boolean;
+    metadata: Record<string, unknown> | null;
+    createdAt: string;
+}
+/** Input for creating a charge */
+interface CreateChargeInput {
+    type: ChargeType;
+    amount: number;
+    description?: string;
+    currency?: string;
+    metadata?: Record<string, unknown>;
+}
+/** Parameters for listing charges */
+interface ListChargesParams {
+    type?: ChargeType;
+    limit?: number;
+    cursor?: string;
+}
+/** Paginated list of charges */
+type PaginatedCharges = Paginated<FolioCharge>;
+/** Input for moving charges between folios */
+interface MoveChargesInput {
+    chargeIds: string[];
+    toFolioId: string;
+}
+/** A payment applied to a folio */
+interface FolioPayment {
+    id: string;
+    folioId: string;
+    amount: number;
+    currency: string;
+    method: string;
+    reference: string | null;
+    metadata: Record<string, unknown> | null;
+    createdAt: string;
+}
+/** Input for creating a folio payment */
+interface CreateFolioPaymentInput {
+    amount: number;
+    method: string;
+    reference?: string;
+    currency?: string;
+    metadata?: Record<string, unknown>;
+}
+/** Parameters for listing folio payments */
+interface ListFolioPaymentsParams {
+    limit?: number;
+    cursor?: string;
+}
+/** Paginated list of folio payments */
+type PaginatedFolioPayments = Paginated<FolioPayment>;
+/** Status of an invoice */
+type InvoiceStatus = "draft" | "finalized" | "voided";
+/** A fiscal invoice */
+interface Invoice {
+    id: string;
+    folioId: string;
+    number: string;
+    status: InvoiceStatus;
+    amount: number;
+    currency: string;
+    language: string;
+    fiscalId: string | null;
+    metadata: Record<string, unknown> | null;
+    createdAt: string;
+    finalizedAt: string | null;
+}
+/** Input for generating an invoice */
+interface CreateInvoiceInput {
+    language?: string;
+    metadata?: Record<string, unknown>;
+}
+/** Daily accounting report */
+interface AccountingDailyReport {
+    date: string;
+    totalRevenue: number;
+    totalCharges: number;
+    totalPayments: number;
+    breakdown: Record<string, number>;
+}
+/** Revenue report by charge type */
+interface AccountingRevenueReport {
+    period: {
+        from: string;
+        to: string;
+    };
+    breakdown: Record<string, number>;
+}
+/** VAT breakdown entry */
+interface VatBreakdownEntry {
+    net: number;
+    vat: number;
+    gross: number;
+}
+/** VAT accounting report */
+interface AccountingVatReport {
+    period: {
+        from: string;
+        to: string;
+    };
+    breakdown: Record<string, VatBreakdownEntry>;
+}
+/** Parameters for accounting reports */
+interface AccountingReportParams {
+    date?: string;
+    from?: string;
+    to?: string;
+    propertyId?: string;
+}
+
+/**
+ * Service for financial operations in the Atzentis Booking API.
+ *
+ * Manages the full folio lifecycle (open → close → settle), charges,
+ * folio payments, invoices (including PDF export), and accounting reports.
+ *
+ * @example
+ * ```typescript
+ * const booking = new BookingClient({ apiKey: "atz_io_live_xxxxx" });
+ *
+ * // Create a folio for a booking
+ * const folio = await booking.finance.createFolio({
+ *   bookingId: "bk_abc123",
+ *   currency: "EUR",
+ * });
+ *
+ * // Add a room charge
+ * await booking.finance.createCharge(folio.id, {
+ *   type: "room",
+ *   amount: 10000,
+ * });
+ *
+ * // Close and settle
+ * await booking.finance.closeFolio(folio.id);
+ * await booking.finance.settleFolio(folio.id);
+ * ```
+ */
+declare class FinanceService extends BaseService {
+    protected readonly basePath = "/finance/v1";
+    /** Create a new folio for a booking */
+    createFolio(input: CreateFolioInput): Promise<Folio>;
+    /** Get a folio by ID */
+    getFolio(folioId: string): Promise<Folio>;
+    /** List folios with optional filters */
+    listFolios(params?: ListFoliosParams): Promise<PaginatedFolios>;
+    /** Update a folio */
+    updateFolio(folioId: string, input: UpdateFolioInput): Promise<Folio>;
+    /** Close a folio (no more charges can be added) */
+    closeFolio(folioId: string): Promise<Folio>;
+    /** Settle a folio (mark as fully paid) */
+    settleFolio(folioId: string): Promise<Folio>;
+    /** Create a charge on a folio */
+    createCharge(folioId: string, input: CreateChargeInput): Promise<FolioCharge>;
+    /** List charges on a folio */
+    listCharges(folioId: string, params?: ListChargesParams): Promise<PaginatedCharges>;
+    /** Create a transitory (non-billable) charge on a folio */
+    createTransitoryCharge(folioId: string, input: CreateChargeInput): Promise<FolioCharge>;
+    /** Move charges from one folio to another */
+    moveCharges(folioId: string, input: MoveChargesInput): Promise<{
+        moved: number;
+    }>;
+    /** Record a payment on a folio */
+    createFolioPayment(folioId: string, input: CreateFolioPaymentInput): Promise<FolioPayment>;
+    /** List payments on a folio */
+    listFolioPayments(folioId: string, params?: ListFolioPaymentsParams): Promise<PaginatedFolioPayments>;
+    /** Generate an invoice for a folio */
+    generateInvoice(folioId: string, input?: CreateInvoiceInput): Promise<Invoice>;
+    /** Get an invoice by ID */
+    getInvoice(invoiceId: string): Promise<Invoice>;
+    /** Get invoice as PDF binary data */
+    getInvoicePdf(invoiceId: string): Promise<ArrayBuffer>;
+    /** Get daily accounting report */
+    getDailyReport(params?: AccountingReportParams): Promise<AccountingDailyReport>;
+    /** Get revenue report by charge type */
+    getRevenueReport(params?: AccountingReportParams): Promise<AccountingRevenueReport>;
+    /** Get VAT accounting report */
+    getVatReport(params?: AccountingReportParams): Promise<AccountingVatReport>;
+}
+
+/** Guest address */
+interface GuestAddress {
+    /** Street address */
+    street: string | null;
+    /** City */
+    city: string | null;
+    /** State or province */
+    state: string | null;
+    /** Postal/ZIP code */
+    postalCode: string | null;
+    /** ISO 3166-1 alpha-2 country code */
+    country: string | null;
+}
+/** A guest profile in the Atzentis system */
+interface Guest {
+    /** Guest identifier */
+    id: string;
+    /** First name */
+    firstName: string;
+    /** Last name */
+    lastName: string;
+    /** Email address */
+    email: string | null;
+    /** Phone number */
+    phone: string | null;
+    /** Date of birth in YYYY-MM-DD format */
+    dateOfBirth: string | null;
+    /** ISO 3166-1 alpha-2 nationality code */
+    nationality: string | null;
+    /** ISO 639-1 language code */
+    language: string | null;
+    /** Guest address */
+    address: GuestAddress | null;
+    /** Company name */
+    company: string | null;
+    /** Passport number */
+    passportNumber: string | null;
+    /** National ID number */
+    idNumber: string | null;
+    /** Free-text notes */
+    notes: string | null;
+    /** Tags for categorization */
+    tags: string[];
+    /** How the guest was acquired */
+    source: string | null;
+    /** Open bag for custom data */
+    metadata: Record<string, unknown> | null;
+    /** Record creation timestamp */
+    createdAt: string;
+    /** Record last-update timestamp */
+    updatedAt: string;
+    /** Soft-delete timestamp, null if active */
+    deletedAt: string | null;
+}
+/** Input for creating a new guest */
+interface CreateGuestInput {
+    /** First name (required) */
+    firstName: string;
+    /** Last name (required) */
+    lastName: string;
+    /** Email address */
+    email?: string;
+    /** Phone number */
+    phone?: string;
+    /** Date of birth in YYYY-MM-DD format */
+    dateOfBirth?: string;
+    /** ISO 3166-1 alpha-2 nationality code */
+    nationality?: string;
+    /** ISO 639-1 language code */
+    language?: string;
+    /** Guest address */
+    address?: GuestAddress;
+    /** Company name */
+    company?: string;
+    /** Passport number */
+    passportNumber?: string;
+    /** National ID number */
+    idNumber?: string;
+    /** Free-text notes */
+    notes?: string;
+    /** Tags for categorization */
+    tags?: string[];
+    /** How the guest was acquired */
+    source?: string;
+    /** Custom metadata */
+    metadata?: Record<string, unknown>;
+}
+/** Input for updating an existing guest — all fields optional */
+interface UpdateGuestInput {
+    /** Update first name */
+    firstName?: string;
+    /** Update last name */
+    lastName?: string;
+    /** Update email */
+    email?: string | null;
+    /** Update phone */
+    phone?: string | null;
+    /** Update date of birth */
+    dateOfBirth?: string | null;
+    /** Update nationality */
+    nationality?: string | null;
+    /** Update language */
+    language?: string | null;
+    /** Update address */
+    address?: GuestAddress | null;
+    /** Update company */
+    company?: string | null;
+    /** Update passport number */
+    passportNumber?: string | null;
+    /** Update ID number */
+    idNumber?: string | null;
+    /** Update notes */
+    notes?: string | null;
+    /** Update tags */
+    tags?: string[];
+    /** Update source */
+    source?: string | null;
+    /** Update metadata */
+    metadata?: Record<string, unknown> | null;
+}
+/** Sort configuration for guest list queries */
+interface GuestSort {
+    /** Field to sort by */
+    field: "firstName" | "lastName" | "email" | "createdAt" | "updatedAt";
+    /** Sort direction */
+    direction: "asc" | "desc";
+}
+/** Query parameters for listing guests */
+interface ListGuestsParams {
+    /** Filter by tags (guests matching any of these tags) */
+    tags?: string[];
+    /** Filter by source */
+    source?: string;
+    /** Filter by creation date (from) */
+    createdFrom?: string;
+    /** Filter by creation date (to) */
+    createdTo?: string;
+    /** Sort configuration */
+    sort?: GuestSort;
+    /** Maximum results per page */
+    limit?: number;
+    /** Pagination cursor */
+    cursor?: string;
+}
+/** Paginated list of guests */
+interface PaginatedGuests {
+    /** Guests in this page */
+    data: Guest[];
+    /** Total number of matching guests */
+    totalCount: number;
+    /** Cursor for next page, null if no more results */
+    cursor: string | null;
+    /** Whether more results are available */
+    hasMore: boolean;
+}
+/** Parameters for searching guests */
+interface SearchGuestsParams {
+    /** Maximum results to return */
+    limit?: number;
+    /** Fields to search in (e.g., ["firstName", "lastName", "email"]) */
+    fields?: string[];
+}
+/** A guest match from a search, includes relevance score */
+interface GuestMatch extends Guest {
+    /** Relevance score between 0 and 1 (1 = exact match) */
+    score: number;
+}
+/** Result of a guest search */
+interface GuestSearchResult {
+    /** Matching guests sorted by score (highest first) */
+    data: GuestMatch[];
+    /** Total number of matches */
+    totalCount: number;
+}
+/** A potential duplicate candidate */
+interface DuplicateCandidate {
+    /** The potential duplicate guest */
+    guest: Guest;
+    /** Confidence score between 0 and 1 (1 = certain duplicate) */
+    confidence: number;
+    /** Fields that matched (e.g., ["email", "phone"]) */
+    matchedFields: string[];
+}
+/** Result of duplicate detection */
+interface GuestDuplicateResult {
+    /** Potential duplicates sorted by confidence (highest first) */
+    data: DuplicateCandidate[];
+}
+/** Input for merging duplicate guests into a primary profile */
+interface MergeGuestsInput {
+    /** IDs of duplicate guests to merge into the primary (required, non-empty) */
+    duplicateIds: string[];
+}
+/**
+ * Guest preferences with typed common fields and a custom catch-all.
+ *
+ * Common fields cover typical hospitality preferences.
+ * Use `custom` for vertical-specific or property-specific data.
+ */
+interface GuestPreferences {
+    /** Preferred room type (e.g., "single", "double", "suite") */
+    roomType: string | null;
+    /** Preferred floor (e.g., "high", "low", "ground") */
+    floorPreference: string | null;
+    /** Preferred bed type (e.g., "king", "twin", "queen") */
+    bedType: string | null;
+    /** Dietary requirements (e.g., "vegetarian", "vegan", "gluten-free") */
+    dietary: string[];
+    /** Known allergies */
+    allergies: string[];
+    /** Preferred communication channel (e.g., "email", "sms", "whatsapp") */
+    communicationChannel: string | null;
+    /** Preferred language for communication */
+    language: string | null;
+    /** Smoking preference */
+    smoking: boolean | null;
+    /** Accessibility requirements */
+    accessibility: string[];
+    /** Free-text special requests */
+    specialRequests: string | null;
+    /** Catch-all for vertical-specific preferences */
+    custom: Record<string, unknown>;
+}
+/** Input for updating guest preferences — all fields optional, partial merge */
+interface UpdateGuestPreferences {
+    /** Update room type preference */
+    roomType?: string | null;
+    /** Update floor preference */
+    floorPreference?: string | null;
+    /** Update bed type preference */
+    bedType?: string | null;
+    /** Update dietary requirements */
+    dietary?: string[];
+    /** Update allergies */
+    allergies?: string[];
+    /** Update communication channel */
+    communicationChannel?: string | null;
+    /** Update language preference */
+    language?: string | null;
+    /** Update smoking preference */
+    smoking?: boolean | null;
+    /** Update accessibility requirements */
+    accessibility?: string[];
+    /** Update special requests */
+    specialRequests?: string | null;
+    /** Update custom preferences (merged, not replaced) */
+    custom?: Record<string, unknown>;
+}
+/** Parameters for guest history queries */
+interface GuestHistoryParams {
+    /** Maximum results per page */
+    limit?: number;
+    /** Pagination cursor */
+    cursor?: string;
+    /** Filter from date in YYYY-MM-DD format */
+    from?: string;
+    /** Filter to date in YYYY-MM-DD format */
+    to?: string;
+}
+/** Lightweight booking summary for guest history */
+interface GuestBookingSummary {
+    /** Booking identifier */
+    id: string;
+    /** Property identifier */
+    propertyId: string;
+    /** Property display name */
+    propertyName: string;
+    /** Booking type */
+    type: BookingType;
+    /** Booking status */
+    status: BookingStatus;
+    /** Check-in date */
+    checkIn: string;
+    /** Check-out date */
+    checkOut: string;
+    /** Total amount in cents */
+    totalAmount: number;
+    /** ISO 4217 currency code */
+    currency: string;
+}
+/** Lightweight folio summary for guest history */
+interface GuestFolioSummary {
+    /** Folio identifier */
+    id: string;
+    /** Associated booking ID */
+    bookingId: string;
+    /** Property identifier */
+    propertyId: string;
+    /** Folio status */
+    status: string;
+    /** Total charges in cents */
+    totalCharges: number;
+    /** Total payments in cents */
+    totalPayments: number;
+    /** Outstanding balance in cents */
+    balance: number;
+    /** ISO 4217 currency code */
+    currency: string;
+    /** When the folio was closed, null if open */
+    closedAt: string | null;
+}
+/** Lightweight order summary for guest history */
+interface GuestOrderSummary {
+    /** Order identifier */
+    id: string;
+    /** Property identifier */
+    propertyId: string;
+    /** Order type */
+    type: string;
+    /** Order status */
+    status: string;
+    /** Total amount in cents */
+    totalAmount: number;
+    /** ISO 4217 currency code */
+    currency: string;
+    /** Number of items in the order */
+    items: number;
+    /** Order creation timestamp */
+    createdAt: string;
+}
+/** Paginated list of guest booking summaries */
+interface PaginatedGuestBookings {
+    /** Booking summaries in this page */
+    data: GuestBookingSummary[];
+    /** Total number of bookings */
+    totalCount: number;
+    /** Cursor for next page, null if no more results */
+    cursor: string | null;
+    /** Whether more results are available */
+    hasMore: boolean;
+}
+/** Paginated list of guest folio summaries */
+interface PaginatedGuestFolios {
+    /** Folio summaries in this page */
+    data: GuestFolioSummary[];
+    /** Total number of folios */
+    totalCount: number;
+    /** Cursor for next page, null if no more results */
+    cursor: string | null;
+    /** Whether more results are available */
+    hasMore: boolean;
+}
+/** Paginated list of guest order summaries */
+interface PaginatedGuestOrders {
+    /** Order summaries in this page */
+    data: GuestOrderSummary[];
+    /** Total number of orders */
+    totalCount: number;
+    /** Cursor for next page, null if no more results */
+    cursor: string | null;
+    /** Whether more results are available */
+    hasMore: boolean;
+}
+
+/**
+ * Service for managing guest profiles in the Atzentis Booking API.
+ *
+ * Provides full CRUD, search with scoring, duplicate detection,
+ * profile merging, preferences management, and cross-domain history
+ * (bookings, folios, orders).
+ *
+ * @example
+ * ```typescript
+ * const booking = new BookingClient({ apiKey: "atz_io_live_xxxxx" });
+ *
+ * // Create a guest
+ * const guest = await booking.guests.create({
+ *   firstName: "John",
+ *   lastName: "Doe",
+ *   email: "john@example.com",
+ * });
+ *
+ * // Search for guests
+ * const results = await booking.guests.search("Doe");
+ *
+ * // Get booking history
+ * const history = await booking.guests.getBookings(guest.id);
+ * ```
+ */
+declare class GuestsService extends BaseService {
+    protected readonly basePath = "/guest/v1/profiles";
+    /**
+     * 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: CreateGuestInput): Promise<Guest>;
+    /**
+     * Get a single guest by ID.
+     *
+     * @example
+     * ```typescript
+     * const guest = await client.guests.get("guest_42");
+     * ```
+     */
+    get(guestId: string): Promise<Guest>;
+    /**
+     * 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?: ListGuestsParams): Promise<PaginatedGuests>;
+    /**
+     * Update an existing guest profile.
+     *
+     * @example
+     * ```typescript
+     * const updated = await client.guests.update("guest_42", {
+     *   email: "maria.new@example.com",
+     *   tags: ["vip"],
+     * });
+     * ```
+     */
+    update(guestId: string, input: UpdateGuestInput): Promise<Guest>;
+    /**
+     * Delete a guest profile (soft-delete).
+     *
+     * @example
+     * ```typescript
+     * await client.guests.delete("guest_42");
+     * ```
+     */
+    delete(guestId: string): Promise<void>;
+    /**
+     * 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: string, params?: SearchGuestsParams): Promise<GuestSearchResult>;
+    /**
+     * 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: string): Promise<GuestDuplicateResult>;
+    /**
+     * 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: string, input: MergeGuestsInput): Promise<Guest>;
+    /**
+     * 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: string): Promise<GuestPreferences>;
+    /**
+     * 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: string, input: UpdateGuestPreferences): Promise<GuestPreferences>;
+    /**
+     * 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: string, params?: GuestHistoryParams): Promise<PaginatedGuestBookings>;
+    /**
+     * 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: string, params?: GuestHistoryParams): Promise<PaginatedGuestFolios>;
+    /**
+     * 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: string, params?: GuestHistoryParams): Promise<PaginatedGuestOrders>;
+    /** Build query params from GuestHistoryParams, omitting undefined values */
+    private _buildHistoryQuery;
+}
+
+/** Supported payment providers */
+type PaymentProvider = "stripe" | "viva_wallet";
+/** Status of a payment */
+type PaymentStatus = "succeeded" | "pending" | "failed" | "requires_action";
+/** A processed payment */
+interface Payment {
+    id: string;
+    bookingId: string;
+    amount: number;
+    currency: string;
+    status: PaymentStatus;
+    provider: PaymentProvider;
+    providerTransactionId: string | null;
+    paymentMethodId: string | null;
+    description: string | null;
+    metadata: Record<string, unknown> | null;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Input for processing a payment */
+interface ProcessPaymentInput {
+    bookingId: string;
+    amount: number;
+    currency: string;
+    paymentMethodId?: string;
+    description?: string;
+    metadata?: Record<string, unknown>;
+}
+/** Status of a refund */
+type RefundStatus = "succeeded" | "pending" | "failed";
+/** A refund applied to a payment */
+interface Refund {
+    id: string;
+    paymentId: string;
+    amount: number;
+    status: RefundStatus;
+    reason: string | null;
+    createdAt: string;
+}
+/** Input for refunding a payment */
+interface RefundInput {
+    amount?: number;
+    reason?: string;
+}
+/** Type of transaction */
+type TransactionType = "payment" | "refund" | "authorization" | "capture";
+/** A financial transaction record */
+interface Transaction {
+    id: string;
+    type: TransactionType;
+    bookingId: string | null;
+    amount: number;
+    currency: string;
+    status: string;
+    provider: PaymentProvider;
+    providerTransactionId: string | null;
+    metadata: Record<string, unknown> | null;
+    createdAt: string;
+}
+/** Parameters for listing transactions */
+interface ListTransactionsParams {
+    bookingId?: string;
+    status?: string;
+    provider?: PaymentProvider;
+    type?: TransactionType;
+    from?: string;
+    to?: string;
+    limit?: number;
+    cursor?: string;
+}
+/** Paginated list of transactions */
+type PaginatedTransactions = Paginated<Transaction>;
+/** Card details for a stored payment method */
+interface CardDetails {
+    last4: string;
+    brand: string;
+    expMonth: number;
+    expYear: number;
+}
+/** Status of a payment account (stored card) */
+type PaymentAccountStatus = "active" | "expired" | "revoked";
+/** A stored payment method (card on file) */
+interface PaymentAccount {
+    id: string;
+    paymentMethodId: string;
+    bookingId: string | null;
+    guestId: string | null;
+    card: CardDetails;
+    label: string | null;
+    status: PaymentAccountStatus;
+    metadata: Record<string, unknown> | null;
+    createdAt: string;
+}
+/** Input for creating a payment account */
+interface CreatePaymentAccountInput {
+    paymentMethodId: string;
+    bookingId?: string;
+    guestId?: string;
+    label?: string;
+    metadata?: Record<string, unknown>;
+}
+/** Parameters for listing payment accounts */
+interface ListPaymentAccountsParams {
+    bookingId?: string;
+    guestId?: string;
+    status?: PaymentAccountStatus;
+    limit?: number;
+    cursor?: string;
+}
+/** Paginated list of payment accounts */
+type PaginatedPaymentAccounts = Paginated<PaymentAccount>;
+/** Status of a pre-authorization */
+type AuthorizationStatus = "authorized" | "expired" | "captured" | "voided";
+/** A pre-authorization hold on a stored card */
+interface Authorization {
+    id: string;
+    accountId: string;
+    amount: number;
+    currency: string;
+    status: AuthorizationStatus;
+    expiresAt: string;
+    description: string | null;
+    metadata: Record<string, unknown> | null;
+    createdAt: string;
+}
+/** Input for authorizing a hold */
+interface AuthorizeInput {
+    amount: number;
+    currency?: string;
+    description?: string;
+    metadata?: Record<string, unknown>;
+}
+/** Input for capturing an authorized hold */
+interface CaptureInput {
+    amount: number;
+    description?: string;
+    metadata?: Record<string, unknown>;
+}
+/** Status of a terminal POS transaction */
+type TerminalTransactionStatus = "pending" | "authorized" | "declined" | "timeout";
+/** A POS terminal transaction */
+interface TerminalTransaction {
+    id: string;
+    terminalId: string;
+    amount: number;
+    currency: string;
+    status: TerminalTransactionStatus;
+    cardPresent: boolean;
+    bookingId: string | null;
+    description: string | null;
+    metadata: Record<string, unknown> | null;
+    createdAt: string;
+}
+/** Input for terminal authorization */
+interface TerminalAuthorizeInput {
+    amount: number;
+    terminalId: string;
+    bookingId?: string;
+    description?: string;
+    currency?: string;
+    metadata?: Record<string, unknown>;
+}
+/** Status of an IRIS bank transfer */
+type IrisTransferStatus = "initiated" | "completed" | "failed" | "expired";
+/** An IRIS instant bank transfer */
+interface IrisTransfer {
+    id: string;
+    amount: number;
+    currency: string;
+    guestId: string;
+    bookingId: string | null;
+    status: IrisTransferStatus;
+    paymentUrl: string;
+    expiresAt: string;
+    description: string | null;
+    metadata: Record<string, unknown> | null;
+    createdAt: string;
+    completedAt: string | null;
+}
+/** Input for initiating an IRIS transfer */
+interface IrisInitiateInput {
+    amount: number;
+    guestId: string;
+    bookingId?: string;
+    description?: string;
+    returnUrl?: string;
+    metadata?: Record<string, unknown>;
+}
+
+/**
+ * Service for payment operations in the Atzentis Booking API.
+ *
+ * Supports Stripe and Viva Wallet providers with payment processing,
+ * refunds, stored card management (authorize/capture), POS terminal
+ * operations, and IRIS Greek bank transfers.
+ *
+ * @example
+ * ```typescript
+ * const booking = new BookingClient({ apiKey: "atz_io_live_xxxxx" });
+ *
+ * // Process a payment
+ * const payment = await booking.payments.process({
+ *   bookingId: "bk_abc123",
+ *   amount: 15000,
+ *   currency: "EUR",
+ * });
+ *
+ * // Partial refund
+ * const refund = await booking.payments.refund(payment.id, {
+ *   amount: 5000,
+ *   reason: "Early checkout",
+ * });
+ * ```
+ */
+declare class PaymentsService extends BaseService {
+    protected readonly basePath = "/payment/v1";
+    /** Process a payment for a booking */
+    process(input: ProcessPaymentInput): Promise<Payment>;
+    /** Refund a payment (full or partial) */
+    refund(paymentId: string, input?: RefundInput): Promise<Refund>;
+    /** Get a transaction by ID */
+    getTransaction(transactionId: string): Promise<Transaction>;
+    /** List transactions with optional filters */
+    listTransactions(params?: ListTransactionsParams): Promise<PaginatedTransactions>;
+    /** Create a payment account (store a card on file) */
+    createAccount(input: CreatePaymentAccountInput): Promise<PaymentAccount>;
+    /** Get a payment account by ID */
+    getAccount(accountId: string): Promise<PaymentAccount>;
+    /** List payment accounts with optional filters */
+    listAccounts(params?: ListPaymentAccountsParams): Promise<PaginatedPaymentAccounts>;
+    /** Delete a payment account */
+    deleteAccount(accountId: string): Promise<void>;
+    /** Authorize a hold on a stored card */
+    authorize(accountId: string, input: AuthorizeInput): Promise<Authorization>;
+    /** Capture a previously authorized hold */
+    capture(accountId: string, input: CaptureInput): Promise<Payment>;
+    /** Initiate a POS terminal payment authorization */
+    terminalAuthorize(input: TerminalAuthorizeInput): Promise<TerminalTransaction>;
+    /** Initiate an IRIS instant bank transfer */
+    irisInitiate(input: IrisInitiateInput): Promise<IrisTransfer>;
+    /** Get the status of an IRIS transfer */
+    irisStatus(transferId: string): Promise<IrisTransfer>;
+}
+
 /**
  * Service for managing properties in the Atzentis Booking API.
  *
@@ -1418,6 +2678,10 @@ declare class BookingClient {
     readonly httpClient: HttpClient;
     private _availability?;
     private _bookings?;
+    private _distribution?;
+    private _finance?;
+    private _guests?;
+    private _payments?;
     private _properties?;
     private _categories?;
     private _spaces?;
@@ -1426,6 +2690,14 @@ declare class BookingClient {
     get availability(): AvailabilityService;
     /** Bookings service — lazy-initialized on first access */
     get bookings(): BookingsService;
+    /** Distribution service — lazy-initialized on first access */
+    get distribution(): DistributionService;
+    /** Finance service — lazy-initialized on first access */
+    get finance(): FinanceService;
+    /** Guests service — lazy-initialized on first access */
+    get guests(): GuestsService;
+    /** Payments service — lazy-initialized on first access */
+    get payments(): PaymentsService;
     /** Properties service — lazy-initialized on first access */
     get properties(): PropertiesService;
     /** Categories service — lazy-initialized on first access */
@@ -1514,4 +2786,4 @@ declare function firstPage<T>(fetcher: PageFetcher<T>, options?: PaginationOptio
 
 declare const VERSION = "0.1.0";
 
-export { type AssignSpaceInput, AuthenticationError, type AvailabilityCheckParams, type AvailabilityPricing, type AvailabilityRestrictions, type AvailabilityResult, type AvailabilitySearchParams, type AvailabilitySearchResult, type AvailabilitySearchResultEntry, AvailabilityService, type AvailableSpace, BOOKING_STATUSES, BOOKING_TYPES, type Booking, BookingClient, type BookingClientConfig, BookingError, type BookingErrorOptions, type BookingGuest, type BookingPricing, type BookingSort, type BookingSpace, type BookingStatus, type BookingType, BookingsService, type BulkUpdateSpaceInput, type CalendarDay, type CalendarParams, type CancelBookingInput, CategoriesService, type CheckInInput, type CheckOutInput, ConflictError, type Coordinates, type CreateBookingInput, type CreateCategoryInput, type CreatePropertyInput, type CreateSpaceInput, DEFAULT_MODULES, ForbiddenError, HttpClient, type HttpClientOptions, type HttpMethod, type HttpResponse, type LinkPosTableInput, type ListBookingsParams, type ListCategoriesParams, type ListPropertiesParams, type ListSpacesParams, type Logger, type NoShowInput, NotFoundError, PROPERTY_MODULES, type PageFetcher, type Paginated, type PaginatedBookings, type PaginationOptions, PaymentError, type PriceRange, type PricingParams, type PricingResult, PropertiesService, type Property, type PropertyAddress, type PropertyModules, type PropertyStatus, type PropertyType, RateLimitError, type RequestOptions, type ResolvedBookingClientConfig, type RetryConfig, type RetryOptions, SPACE_STATUSES, SPACE_TYPES, ServerError, type ServiceSlotParams, type ServiceTimeSlot, type Space, type SpaceCategory, type SpaceStatus, type SpaceType, SpacesService, type TableSlotParams, type TimeSlot, TimeoutError, type UpdateBookingInput, type UpdateCategoryInput, type UpdatePropertyInput, type UpdateSpaceInput, VERSION, ValidationError, bookingClientConfigSchema, createErrorFromResponse, firstPage, paginate };
+export { type AccountingDailyReport, type AccountingReportParams, type AccountingRevenueReport, type AccountingVatReport, type AssignSpaceInput, AuthenticationError, type Authorization, type AuthorizationStatus, type AuthorizeInput, type AvailabilityCheckParams, type AvailabilityPricing, type AvailabilityRestrictions, type AvailabilityResult, type AvailabilitySearchParams, type AvailabilitySearchResult, type AvailabilitySearchResultEntry, AvailabilityService, type AvailableSpace, BOOKING_STATUSES, BOOKING_TYPES, type Booking, BookingClient, type BookingClientConfig, BookingError, type BookingErrorOptions, type BookingGuest, type BookingPricing, type BookingSort, type BookingSpace, type BookingStatus, type BookingType, BookingsService, type BulkUpdateSpaceInput, type CalendarDay, type CalendarParams, type CancelBookingInput, type CaptureInput, type CardDetails, CategoriesService, type Channel, type ChannelCredentials, type ChannelMapping, type ChannelSettings, type ChannelStatus, type ChannelType, type ChargeType, type CheckInInput, type CheckOutInput, ConflictError, type Coordinates, type CreateBookingInput, type CreateCategoryInput, type CreateChannelInput, type CreateChargeInput, type CreateFolioInput, type CreateFolioPaymentInput, type CreateGuestInput, type CreateInvoiceInput, type CreateMappingInput, type CreatePaymentAccountInput, type CreatePropertyInput, type CreateSpaceInput, DEFAULT_MODULES, DistributionService, type DuplicateCandidate, FinanceService, type Folio, type FolioCharge, type FolioPayment, type FolioStatus, ForbiddenError, type Guest, type GuestAddress, type GuestBookingSummary, type GuestDuplicateResult, type GuestFolioSummary, type GuestHistoryParams, type GuestMatch, type GuestOrderSummary, type GuestPreferences, type GuestSearchResult, type GuestSort, GuestsService, HttpClient, type HttpClientOptions, type HttpMethod, type HttpResponse, type ICalExportResult, type ICalImportInput, type ICalImportResult, type Invoice, type InvoiceStatus, type IrisInitiateInput, type IrisTransfer, type IrisTransferStatus, type LinkPosTableInput, type ListBookingsParams, type ListCategoriesParams, type ListChannelsParams, type ListChargesParams, type ListFolioPaymentsParams, type ListFoliosParams, type ListGuestsParams, type ListMappingsParams, type ListPaymentAccountsParams, type ListPropertiesParams, type ListSpacesParams, type ListTransactionsParams, type Logger, type MergeGuestsInput, type MoveChargesInput, type NoShowInput, NotFoundError, PROPERTY_MODULES, type PageFetcher, type Paginated, type PaginatedBookings, type PaginatedChannels, type PaginatedCharges, type PaginatedFolioPayments, type PaginatedFolios, type PaginatedGuestBookings, type PaginatedGuestFolios, type PaginatedGuestOrders, type PaginatedGuests, type PaginatedMappings, type PaginatedPaymentAccounts, type PaginatedSyncLog, type PaginatedTransactions, type PaginationOptions, type Payment, type PaymentAccount, type PaymentAccountStatus, PaymentError, type PaymentProvider, type PaymentStatus, PaymentsService, type PriceRange, type PricingParams, type PricingResult, type ProcessPaymentInput, PropertiesService, type Property, type PropertyAddress, type PropertyModules, type PropertyStatus, type PropertyType, type PullSyncInput, type PushSyncInput, RateLimitError, type Refund, type RefundInput, type RefundStatus, type RequestOptions, type ResolvedBookingClientConfig, type RetryConfig, type RetryOptions, SPACE_STATUSES, SPACE_TYPES, type SearchGuestsParams, ServerError, type ServiceSlotParams, type ServiceTimeSlot, type Space, type SpaceCategory, type SpaceStatus, type SpaceType, SpacesService, type SyncError, type SyncLogParams, type SyncOperation, type SyncOperationStatus, type SyncOperationType, type SyncStats, type TableSlotParams, type TerminalAuthorizeInput, type TerminalTransaction, type TerminalTransactionStatus, type TimeSlot, TimeoutError, type Transaction, type TransactionType, type UpdateBookingInput, type UpdateCategoryInput, type UpdateChannelInput, type UpdateFolioInput, type UpdateGuestInput, type UpdateGuestPreferences, type UpdatePropertyInput, type UpdateSpaceInput, VERSION, ValidationError, type VatBreakdownEntry, bookingClientConfigSchema, createErrorFromResponse, firstPage, paginate };