@atzentis/booking-sdk 0.1.1 → 0.1.3

package/dist/index.d.ts

@@ -94,6 +94,314 @@ declare class HttpClient {
     private buildHeaders;
 }
 
+/** The standard paginated response shape returned by all v4.0 list endpoints */
+interface Paginated<T> {
+    /** The items for this page */
+    data: T[];
+    /** Opaque cursor for the next page; null when on the last page */
+    cursor: string | null;
+    /** True if more pages exist beyond this one */
+    hasMore: boolean;
+}
+/** Options for configuring pagination behavior */
+interface PaginationOptions {
+    /** Number of items per page (defaults to API default if omitted) */
+    limit?: number;
+    /** Initial cursor — omit to start from the first page */
+    cursor?: string;
+}
+/** Callback type: a function that fetches one page given current cursor options */
+type PageFetcher<T> = (options: PaginationOptions) => Promise<Paginated<T>>;
+
+/** All supported property types in the v4.0 API */
+type PropertyType = "hotel" | "resort" | "villa" | "apartment" | "hostel" | "bnb" | "restaurant" | "cafe" | "bar" | "beach" | "spa" | "salon" | "custom";
+/** Property lifecycle status */
+type PropertyStatus = "active" | "inactive" | "setup" | "suspended";
+/** Geographic coordinates */
+interface Coordinates {
+    lat: number;
+    lng: number;
+}
+/** Physical address of a property */
+interface PropertyAddress {
+    street: string;
+    city: string;
+    country: string;
+    state?: string;
+    postalCode?: string;
+    coordinates?: Coordinates;
+}
+/**
+ * Feature modules that can be enabled per property.
+ *
+ * Each flag controls access to a v4.0 API service group:
+ * - `booking` — Reservation and availability management
+ * - `concierge` — Guest request and service management
+ * - `intelligence` — Analytics and reporting
+ * - `revenue` — Dynamic pricing and yield management
+ * - `housekeeping` — Room cleaning and maintenance scheduling
+ * - `nightAudit` — End-of-day accounting reconciliation
+ * - `distribution` — Channel manager and OTA connectivity
+ * - `fiscal` — Tax compliance and fiscal reporting
+ * - `pos` — Point of sale bridge integration
+ */
+interface PropertyModules {
+    booking?: boolean;
+    concierge?: boolean;
+    intelligence?: boolean;
+    revenue?: boolean;
+    housekeeping?: boolean;
+    nightAudit?: boolean;
+    distribution?: boolean;
+    fiscal?: boolean;
+    pos?: boolean;
+}
+/** All 9 module names as a readonly tuple */
+declare const PROPERTY_MODULES: readonly ["booking", "concierge", "intelligence", "revenue", "housekeeping", "nightAudit", "distribution", "fiscal", "pos"];
+/** Default modules configuration with all modules disabled */
+declare const DEFAULT_MODULES: PropertyModules;
+/** A property in the Atzentis Booking system */
+interface Property {
+    id: string;
+    name: string;
+    type: PropertyType;
+    status: PropertyStatus;
+    currency: string;
+    timezone: string;
+    address: PropertyAddress;
+    modules: PropertyModules;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Input for creating a new property */
+interface CreatePropertyInput {
+    name: string;
+    type: PropertyType;
+    currency: string;
+    timezone: string;
+    address: PropertyAddress;
+    modules?: PropertyModules;
+}
+/** Input for updating an existing property — all fields optional */
+type UpdatePropertyInput = Partial<CreatePropertyInput>;
+/** Query parameters for listing properties */
+interface ListPropertiesParams {
+    type?: PropertyType;
+    status?: PropertyStatus;
+    cursor?: string;
+    limit?: number;
+}
+/** A space category (room type) belonging to a property */
+interface SpaceCategory {
+    id: string;
+    propertyId: string;
+    name: string;
+    code: string;
+    maxOccupancy: number;
+    /** Base price in integer cents */
+    basePrice: number;
+    description?: string;
+    sortOrder?: number;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Input for creating a new space category */
+interface CreateCategoryInput {
+    propertyId: string;
+    name: string;
+    code: string;
+    maxOccupancy: number;
+    /** Base price in integer cents */
+    basePrice: number;
+    description?: string;
+    sortOrder?: number;
+}
+/** Input for updating a space category — cannot change propertyId */
+type UpdateCategoryInput = Partial<Omit<CreateCategoryInput, "propertyId">>;
+/** Query parameters for listing categories — propertyId is required */
+interface ListCategoriesParams {
+    propertyId: string;
+    cursor?: string;
+    limit?: number;
+}
+
+/**
+ * Abstract base class for all SDK services.
+ * Provides typed HTTP helper methods and path construction.
+ * Not exported from the public API.
+ */
+declare abstract class BaseService {
+    protected readonly http: HttpClient;
+    protected abstract readonly basePath: string;
+    constructor(http: HttpClient);
+    /** Build a full path from the base path and additional segments */
+    protected _buildPath(...segments: string[]): string;
+    /** GET request returning typed response */
+    protected _get<T>(path: string, query?: Record<string, string | number | boolean | null | undefined>): Promise<T>;
+    /** POST request with body, returning typed response */
+    protected _post<T>(path: string, body: unknown): Promise<T>;
+    /** PATCH request with body, returning typed response */
+    protected _patch<T>(path: string, body: unknown): Promise<T>;
+    /** DELETE request, returning void */
+    protected _delete(path: string): Promise<void>;
+    /** GET list request with optional query params, returning paginated response */
+    protected _list<T>(params?: any): Promise<Paginated<T>>;
+}
+
+/**
+ * Service for managing space categories (room types) in the Atzentis Booking API.
+ *
+ * Categories are property-scoped — `propertyId` is required for create and list operations.
+ *
+ * @example
+ * ```typescript
+ * const booking = new BookingClient({ apiKey: "atz_io_live_xxxxx" });
+ *
+ * // List categories for a property
+ * const { data } = await booking.categories.list({ propertyId: "prop_abc123" });
+ *
+ * // Create a new category
+ * const category = await booking.categories.create({
+ *   propertyId: "prop_abc123",
+ *   name: "Deluxe Suite",
+ *   code: "DLX",
+ *   maxOccupancy: 3,
+ *   basePrice: 25000, // €250.00 in cents
+ * });
+ * ```
+ */
+declare class CategoriesService extends BaseService {
+    protected readonly basePath = "/inventory/v1/categories";
+    /**
+     * Create a new space category.
+     *
+     * @example
+     * ```typescript
+     * const category = await booking.categories.create({
+     *   propertyId: "prop_abc123",
+     *   name: "Standard Room",
+     *   code: "STD",
+     *   maxOccupancy: 2,
+     *   basePrice: 12000, // €120.00 in cents
+     * });
+     * ```
+     */
+    create(input: CreateCategoryInput): Promise<SpaceCategory>;
+    /**
+     * List categories for a property with cursor-based pagination.
+     *
+     * @param params - Must include `propertyId`
+     *
+     * @example
+     * ```typescript
+     * const page = await booking.categories.list({
+     *   propertyId: "prop_abc123",
+     *   limit: 50,
+     * });
+     * ```
+     */
+    list(params: ListCategoriesParams): Promise<Paginated<SpaceCategory>>;
+    /**
+     * Update an existing space category.
+     *
+     * @example
+     * ```typescript
+     * const updated = await booking.categories.update("cat_xyz789", {
+     *   basePrice: 15000, // Updated to €150.00
+     * });
+     * ```
+     */
+    update(categoryId: string, input: UpdateCategoryInput): Promise<SpaceCategory>;
+    /**
+     * Delete a space category.
+     *
+     * @example
+     * ```typescript
+     * await booking.categories.delete("cat_xyz789");
+     * ```
+     */
+    delete(categoryId: string): Promise<void>;
+}
+
+/**
+ * Service for managing properties in the Atzentis Booking API.
+ *
+ * @example
+ * ```typescript
+ * const booking = new BookingClient({ apiKey: "atz_io_live_xxxxx" });
+ *
+ * // List all active properties
+ * const { data, hasMore } = await booking.properties.list({ status: "active" });
+ *
+ * // Create a new property
+ * const property = await booking.properties.create({
+ *   name: "Seaside Villa",
+ *   type: "villa",
+ *   currency: "EUR",
+ *   timezone: "Europe/Athens",
+ *   address: { street: "123 Coast Rd", city: "Chania", country: "GR" },
+ * });
+ * ```
+ */
+declare class PropertiesService extends BaseService {
+    protected readonly basePath = "/inventory/v1/properties";
+    /**
+     * Create a new property.
+     *
+     * @example
+     * ```typescript
+     * const property = await booking.properties.create({
+     *   name: "Hotel Athena",
+     *   type: "hotel",
+     *   currency: "EUR",
+     *   timezone: "Europe/Athens",
+     *   address: { street: "1 Plaka St", city: "Athens", country: "GR" },
+     * });
+     * ```
+     */
+    create(input: CreatePropertyInput): Promise<Property>;
+    /**
+     * List properties with optional filters and cursor-based pagination.
+     *
+     * @example
+     * ```typescript
+     * const page = await booking.properties.list({ type: "hotel", limit: 20 });
+     * console.log(page.data); // Property[]
+     * console.log(page.hasMore); // boolean
+     * ```
+     */
+    list(params?: ListPropertiesParams): Promise<Paginated<Property>>;
+    /**
+     * Get a single property by ID.
+     *
+     * @example
+     * ```typescript
+     * const property = await booking.properties.get("prop_abc123");
+     * ```
+     */
+    get(propertyId: string): Promise<Property>;
+    /**
+     * Update an existing property.
+     *
+     * @example
+     * ```typescript
+     * const updated = await booking.properties.update("prop_abc123", {
+     *   name: "Hotel Athena Deluxe",
+     * });
+     * ```
+     */
+    update(propertyId: string, input: UpdatePropertyInput): Promise<Property>;
+    /**
+     * Delete a property.
+     *
+     * @example
+     * ```typescript
+     * await booking.properties.delete("prop_abc123");
+     * ```
+     */
+    delete(propertyId: string): Promise<void>;
+}
+
 /**
  * Main SDK client for the Atzentis Booking API.
  *
@@ -105,7 +413,13 @@ declare class HttpClient {
  */
 declare class BookingClient {
     readonly httpClient: HttpClient;
+    private _properties?;
+    private _categories?;
     constructor(config: BookingClientConfig);
+    /** Properties service — lazy-initialized on first access */
+    get properties(): PropertiesService;
+    /** Categories service — lazy-initialized on first access */
+    get categories(): CategoriesService;
     setApiKey(key: string): void;
     setTenantId(id: string): void;
 }
@@ -164,25 +478,6 @@ declare class TimeoutError extends BookingError {
 /** Creates a typed BookingError from an HTTP response and parsed body */
 declare function createErrorFromResponse(response: Response, body: unknown, retryAfterHeader?: string | null): BookingError;
 
-/** The standard paginated response shape returned by all v4.0 list endpoints */
-interface Paginated<T> {
-    /** The items for this page */
-    data: T[];
-    /** Opaque cursor for the next page; null when on the last page */
-    cursor: string | null;
-    /** True if more pages exist beyond this one */
-    hasMore: boolean;
-}
-/** Options for configuring pagination behavior */
-interface PaginationOptions {
-    /** Number of items per page (defaults to API default if omitted) */
-    limit?: number;
-    /** Initial cursor — omit to start from the first page */
-    cursor?: string;
-}
-/** Callback type: a function that fetches one page given current cursor options */
-type PageFetcher<T> = (options: PaginationOptions) => Promise<Paginated<T>>;
-
 /**
  * Returns an AsyncIterable that yields each page's data array in order.
  * Iteration stops automatically when hasMore is false or cursor is null.
@@ -207,4 +502,4 @@ declare function firstPage<T>(fetcher: PageFetcher<T>, options?: PaginationOptio
 
 declare const VERSION = "0.1.0";
 
-export { AuthenticationError, BookingClient, type BookingClientConfig, BookingError, type BookingErrorOptions, ConflictError, ForbiddenError, HttpClient, type HttpClientOptions, type HttpMethod, type HttpResponse, type Logger, NotFoundError, type PageFetcher, type Paginated, type PaginationOptions, PaymentError, RateLimitError, type RequestOptions, type ResolvedBookingClientConfig, type RetryConfig, type RetryOptions, ServerError, TimeoutError, VERSION, ValidationError, bookingClientConfigSchema, createErrorFromResponse, firstPage, paginate };
+export { AuthenticationError, BookingClient, type BookingClientConfig, BookingError, type BookingErrorOptions, CategoriesService, ConflictError, type Coordinates, type CreateCategoryInput, type CreatePropertyInput, DEFAULT_MODULES, ForbiddenError, HttpClient, type HttpClientOptions, type HttpMethod, type HttpResponse, type ListCategoriesParams, type ListPropertiesParams, type Logger, NotFoundError, PROPERTY_MODULES, type PageFetcher, type Paginated, type PaginationOptions, PaymentError, PropertiesService, type Property, type PropertyAddress, type PropertyModules, type PropertyStatus, type PropertyType, RateLimitError, type RequestOptions, type ResolvedBookingClientConfig, type RetryConfig, type RetryOptions, ServerError, type SpaceCategory, TimeoutError, type UpdateCategoryInput, type UpdatePropertyInput, VERSION, ValidationError, bookingClientConfigSchema, createErrorFromResponse, firstPage, paginate };

package/dist/index.js

@@ -442,6 +442,177 @@ _timeout = new WeakMap();
 _debug = new WeakMap();
 _logger = new WeakMap();
 
+// src/services/base.ts
+var BaseService = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /** Build a full path from the base path and additional segments */
+  _buildPath(...segments) {
+    if (segments.length === 0) return this.basePath;
+    return `${this.basePath}/${segments.join("/")}`;
+  }
+  /** GET request returning typed response */
+  _get(path, query) {
+    return this.http.get(path, { query });
+  }
+  /** POST request with body, returning typed response */
+  _post(path, body) {
+    return this.http.post(path, { body });
+  }
+  /** PATCH request with body, returning typed response */
+  _patch(path, body) {
+    return this.http.patch(path, { body });
+  }
+  /** DELETE request, returning void */
+  _delete(path) {
+    return this.http.delete(path);
+  }
+  /** GET list request with optional query params, returning paginated response */
+  // biome-ignore lint/suspicious/noExplicitAny: params are typed at service level, cast needed for HttpClient
+  _list(params) {
+    return this.http.get(this.basePath, { query: params });
+  }
+};
+
+// src/services/categories.ts
+var CategoriesService = class extends BaseService {
+  constructor() {
+    super(...arguments);
+    this.basePath = "/inventory/v1/categories";
+  }
+  /**
+   * Create a new space category.
+   *
+   * @example
+   * ```typescript
+   * const category = await booking.categories.create({
+   *   propertyId: "prop_abc123",
+   *   name: "Standard Room",
+   *   code: "STD",
+   *   maxOccupancy: 2,
+   *   basePrice: 12000, // €120.00 in cents
+   * });
+   * ```
+   */
+  create(input) {
+    return this._post(this.basePath, input);
+  }
+  /**
+   * List categories for a property with cursor-based pagination.
+   *
+   * @param params - Must include `propertyId`
+   *
+   * @example
+   * ```typescript
+   * const page = await booking.categories.list({
+   *   propertyId: "prop_abc123",
+   *   limit: 50,
+   * });
+   * ```
+   */
+  list(params) {
+    return this._list(params);
+  }
+  /**
+   * Update an existing space category.
+   *
+   * @example
+   * ```typescript
+   * const updated = await booking.categories.update("cat_xyz789", {
+   *   basePrice: 15000, // Updated to €150.00
+   * });
+   * ```
+   */
+  update(categoryId, input) {
+    return this._patch(this._buildPath(categoryId), input);
+  }
+  /**
+   * Delete a space category.
+   *
+   * @example
+   * ```typescript
+   * await booking.categories.delete("cat_xyz789");
+   * ```
+   */
+  delete(categoryId) {
+    return this._delete(this._buildPath(categoryId));
+  }
+};
+
+// src/services/properties.ts
+var PropertiesService = class extends BaseService {
+  constructor() {
+    super(...arguments);
+    this.basePath = "/inventory/v1/properties";
+  }
+  /**
+   * Create a new property.
+   *
+   * @example
+   * ```typescript
+   * const property = await booking.properties.create({
+   *   name: "Hotel Athena",
+   *   type: "hotel",
+   *   currency: "EUR",
+   *   timezone: "Europe/Athens",
+   *   address: { street: "1 Plaka St", city: "Athens", country: "GR" },
+   * });
+   * ```
+   */
+  create(input) {
+    return this._post(this.basePath, input);
+  }
+  /**
+   * List properties with optional filters and cursor-based pagination.
+   *
+   * @example
+   * ```typescript
+   * const page = await booking.properties.list({ type: "hotel", limit: 20 });
+   * console.log(page.data); // Property[]
+   * console.log(page.hasMore); // boolean
+   * ```
+   */
+  list(params) {
+    return this._list(params);
+  }
+  /**
+   * Get a single property by ID.
+   *
+   * @example
+   * ```typescript
+   * const property = await booking.properties.get("prop_abc123");
+   * ```
+   */
+  get(propertyId) {
+    return this._get(this._buildPath(propertyId));
+  }
+  /**
+   * Update an existing property.
+   *
+   * @example
+   * ```typescript
+   * const updated = await booking.properties.update("prop_abc123", {
+   *   name: "Hotel Athena Deluxe",
+   * });
+   * ```
+   */
+  update(propertyId, input) {
+    return this._patch(this._buildPath(propertyId), input);
+  }
+  /**
+   * Delete a property.
+   *
+   * @example
+   * ```typescript
+   * await booking.properties.delete("prop_abc123");
+   * ```
+   */
+  delete(propertyId) {
+    return this._delete(this._buildPath(propertyId));
+  }
+};
+
 // src/client.ts
 var BookingClient = class {
   constructor(config) {
@@ -459,6 +630,16 @@ var BookingClient = class {
       logger: validated.logger
     });
   }
+  /** Properties service — lazy-initialized on first access */
+  get properties() {
+    this._properties ?? (this._properties = new PropertiesService(this.httpClient));
+    return this._properties;
+  }
+  /** Categories service — lazy-initialized on first access */
+  get categories() {
+    this._categories ?? (this._categories = new CategoriesService(this.httpClient));
+    return this._categories;
+  }
   setApiKey(key) {
     if (!key || key.trim().length === 0) {
       throw new Error("apiKey must be a non-empty string");
@@ -498,17 +679,45 @@ async function firstPage(fetcher, options) {
   return fetcher({ ...options ?? {} });
 }
 
+// src/types/properties.ts
+var PROPERTY_MODULES = [
+  "booking",
+  "concierge",
+  "intelligence",
+  "revenue",
+  "housekeeping",
+  "nightAudit",
+  "distribution",
+  "fiscal",
+  "pos"
+];
+var DEFAULT_MODULES = {
+  booking: false,
+  concierge: false,
+  intelligence: false,
+  revenue: false,
+  housekeeping: false,
+  nightAudit: false,
+  distribution: false,
+  fiscal: false,
+  pos: false
+};
+
 // src/index.ts
 var VERSION = "0.1.0";
 export {
   AuthenticationError,
   BookingClient,
   BookingError,
+  CategoriesService,
   ConflictError,
+  DEFAULT_MODULES,
   ForbiddenError,
   HttpClient,
   NotFoundError,
+  PROPERTY_MODULES,
   PaymentError,
+  PropertiesService,
   RateLimitError,
   ServerError,
   TimeoutError,