@slotchain/sdk 1.1.1 → 1.1.2

package/dist/index.d.mts

@@ -93,10 +93,47 @@ interface Category {
 }
 interface Booking {
     id: string;
-    tenantId: string;
-    slotId?: string;
-    customerId?: string;
+    slot_id: string;
+    customer_id?: string;
+    customer_info: {
+        name: string;
+        email: string;
+        phone?: string;
+        address?: string;
+        city?: string;
+        state?: string;
+        zipCode?: string;
+        isGuestCheckout?: boolean;
+    };
+    booking_data: {
+        services?: string[];
+        selected_services?: string[];
+        service_items?: string[];
+        total?: number;
+        delivery_type?: string;
+        [key: string]: unknown;
+    };
     status?: string;
+    created_at: string;
+    updated_at: string;
+}
+/**
+ * Booking with nested slot information
+ */
+interface BookingWithSlot extends Booking {
+    slots?: Slot;
+}
+/**
+ * Options for listing bookings
+ */
+interface ListBookingsOptions {
+    tenant_id?: string;
+    slot_id?: string;
+    customer_id?: string;
+    status?: string;
+    includeSlot?: boolean;
+    page?: number;
+    limit?: number;
 }
 interface Service {
     id: string;
@@ -108,11 +145,13 @@ interface Service {
 }
 interface Slot {
     id: string;
-    tenantId: string;
-    serviceId?: string;
-    startTime: string;
-    endTime: string;
-    available: boolean;
+    tenant_id: string;
+    name: string;
+    description?: string;
+    status?: string;
+    is_active?: boolean;
+    created_at: string;
+    updated_at: string;
 }
 interface Customer {
     id: string;
@@ -329,16 +368,74 @@ declare class BookingClient {
      */
     getById(id: string): Promise<ApiResponse<Booking>>;
     /**
-     * List bookings
+     * List bookings with enhanced filtering
      * GET /api/v1/bookings
+     *
+     * Supports filtering by tenant_id, slot_id, customer_id, status, and optional nested slot information.
+     *
+     * @param params - Query options (tenant_id, slot_id, customer_id, status, includeSlot, page, limit)
+     * @returns Bookings or BookingsWithSlot based on includeSlot parameter
+     *
+     * @example
+     * ```typescript
+     * // List bookings by tenant (single query - fast!)
+     * const bookings = await slotly.booking.list({
+     *   tenant_id: 'tenant-123',
+     *   includeSlot: true,
+     *   page: 1,
+     *   limit: 20
+     * });
+     *
+     * // List bookings by slot
+     * const slotBookings = await slotly.booking.list({
+     *   slot_id: 'slot-456',
+     *   status: 'confirmed'
+     * });
+     * ```
      */
-    list(params?: {
-        slot_id?: string;
-        customer_id?: string;
-        status?: string;
-        page?: number;
-        limit?: number;
-    }): Promise<ApiResponse<Booking[]>>;
+    list(params?: ListBookingsOptions): Promise<ApiResponse<Booking[] | BookingWithSlot[]>>;
+    /**
+     * List bookings by tenant (convenience method)
+     * GET /api/v1/bookings?tenant_id=:id
+     *
+     * @param tenantId - Tenant ID
+     * @param options - Additional options (includeSlot, page, limit, status)
+     * @returns Bookings or BookingsWithSlot based on includeSlot parameter
+     *
+     * @example
+     * ```typescript
+     * const bookings = await slotly.booking.listByTenant('tenant-123', {
+     *   page: 1,
+     *   limit: 20,
+     *   status: 'confirmed'
+     * });
+     * ```
+     */
+    listByTenant(tenantId: string, options?: Omit<ListBookingsOptions, 'tenant_id'>): Promise<ApiResponse<Booking[] | BookingWithSlot[]>>;
+    /**
+     * List bookings by tenant with nested slot information (convenience method)
+     * GET /api/v1/bookings?tenant_id=:id&includeSlot=true
+     *
+     * @param tenantId - Tenant ID
+     * @param options - Additional options (page, limit, status)
+     * @returns BookingsWithSlot (includes nested slot information)
+     *
+     * @example
+     * ```typescript
+     * const bookings = await slotly.booking.listByTenantWithSlots('tenant-123', {
+     *   page: 1,
+     *   limit: 20
+     * });
+     *
+     * // Access slot information
+     * bookings.data.forEach(booking => {
+     *   if (booking.slots) {
+     *     console.log('Slot name:', booking.slots.name);
+     *   }
+     * });
+     * ```
+     */
+    listByTenantWithSlots(tenantId: string, options?: Omit<ListBookingsOptions, 'tenant_id' | 'includeSlot'>): Promise<ApiResponse<BookingWithSlot[]>>;
     /**
      * Create a new booking (publishes booking.created event)
      * POST /api/v1/bookings
@@ -1258,4 +1355,4 @@ interface SlotlyApi {
  */
 declare const useSlotly: (options: SlotlyClientOptions) => SlotlyApi;
 
-export { type ApiResponse, type Booking, type Category, type Customer, type DataQualityIssue, type Flow, type FlowStep, type GetOrganizationOptions, type Notification, type Organization, type OrganizationFullConfig, type Service, type ServiceItem, type ServiceItemWithService, type ServiceWithItems, type Slot, type SlotlyApi, SlotlyApiError, type SlotlyAuthContext, SlotlyAuthError, type SlotlyClientOptions, SlotlyConfigurationError, SlotlyNetworkError, type SlotlyRequest, type Studio, type Tenant, type TenantBranding, type TenantFullConfig, useSlotly as default, getSlotlyContext, useSlotly, validateSlotlyRequest };
+export { type ApiResponse, type Booking, type BookingWithSlot, type Category, type Customer, type DataQualityIssue, type Flow, type FlowStep, type GetOrganizationOptions, type ListBookingsOptions, type Notification, type Organization, type OrganizationFullConfig, type Service, type ServiceItem, type ServiceItemWithService, type ServiceWithItems, type Slot, type SlotlyApi, SlotlyApiError, type SlotlyAuthContext, SlotlyAuthError, type SlotlyClientOptions, SlotlyConfigurationError, SlotlyNetworkError, type SlotlyRequest, type Studio, type Tenant, type TenantBranding, type TenantFullConfig, useSlotly as default, getSlotlyContext, useSlotly, validateSlotlyRequest };

package/dist/index.d.ts

@@ -93,10 +93,47 @@ interface Category {
 }
 interface Booking {
     id: string;
-    tenantId: string;
-    slotId?: string;
-    customerId?: string;
+    slot_id: string;
+    customer_id?: string;
+    customer_info: {
+        name: string;
+        email: string;
+        phone?: string;
+        address?: string;
+        city?: string;
+        state?: string;
+        zipCode?: string;
+        isGuestCheckout?: boolean;
+    };
+    booking_data: {
+        services?: string[];
+        selected_services?: string[];
+        service_items?: string[];
+        total?: number;
+        delivery_type?: string;
+        [key: string]: unknown;
+    };
     status?: string;
+    created_at: string;
+    updated_at: string;
+}
+/**
+ * Booking with nested slot information
+ */
+interface BookingWithSlot extends Booking {
+    slots?: Slot;
+}
+/**
+ * Options for listing bookings
+ */
+interface ListBookingsOptions {
+    tenant_id?: string;
+    slot_id?: string;
+    customer_id?: string;
+    status?: string;
+    includeSlot?: boolean;
+    page?: number;
+    limit?: number;
 }
 interface Service {
     id: string;
@@ -108,11 +145,13 @@ interface Service {
 }
 interface Slot {
     id: string;
-    tenantId: string;
-    serviceId?: string;
-    startTime: string;
-    endTime: string;
-    available: boolean;
+    tenant_id: string;
+    name: string;
+    description?: string;
+    status?: string;
+    is_active?: boolean;
+    created_at: string;
+    updated_at: string;
 }
 interface Customer {
     id: string;
@@ -329,16 +368,74 @@ declare class BookingClient {
      */
     getById(id: string): Promise<ApiResponse<Booking>>;
     /**
-     * List bookings
+     * List bookings with enhanced filtering
      * GET /api/v1/bookings
+     *
+     * Supports filtering by tenant_id, slot_id, customer_id, status, and optional nested slot information.
+     *
+     * @param params - Query options (tenant_id, slot_id, customer_id, status, includeSlot, page, limit)
+     * @returns Bookings or BookingsWithSlot based on includeSlot parameter
+     *
+     * @example
+     * ```typescript
+     * // List bookings by tenant (single query - fast!)
+     * const bookings = await slotly.booking.list({
+     *   tenant_id: 'tenant-123',
+     *   includeSlot: true,
+     *   page: 1,
+     *   limit: 20
+     * });
+     *
+     * // List bookings by slot
+     * const slotBookings = await slotly.booking.list({
+     *   slot_id: 'slot-456',
+     *   status: 'confirmed'
+     * });
+     * ```
      */
-    list(params?: {
-        slot_id?: string;
-        customer_id?: string;
-        status?: string;
-        page?: number;
-        limit?: number;
-    }): Promise<ApiResponse<Booking[]>>;
+    list(params?: ListBookingsOptions): Promise<ApiResponse<Booking[] | BookingWithSlot[]>>;
+    /**
+     * List bookings by tenant (convenience method)
+     * GET /api/v1/bookings?tenant_id=:id
+     *
+     * @param tenantId - Tenant ID
+     * @param options - Additional options (includeSlot, page, limit, status)
+     * @returns Bookings or BookingsWithSlot based on includeSlot parameter
+     *
+     * @example
+     * ```typescript
+     * const bookings = await slotly.booking.listByTenant('tenant-123', {
+     *   page: 1,
+     *   limit: 20,
+     *   status: 'confirmed'
+     * });
+     * ```
+     */
+    listByTenant(tenantId: string, options?: Omit<ListBookingsOptions, 'tenant_id'>): Promise<ApiResponse<Booking[] | BookingWithSlot[]>>;
+    /**
+     * List bookings by tenant with nested slot information (convenience method)
+     * GET /api/v1/bookings?tenant_id=:id&includeSlot=true
+     *
+     * @param tenantId - Tenant ID
+     * @param options - Additional options (page, limit, status)
+     * @returns BookingsWithSlot (includes nested slot information)
+     *
+     * @example
+     * ```typescript
+     * const bookings = await slotly.booking.listByTenantWithSlots('tenant-123', {
+     *   page: 1,
+     *   limit: 20
+     * });
+     *
+     * // Access slot information
+     * bookings.data.forEach(booking => {
+     *   if (booking.slots) {
+     *     console.log('Slot name:', booking.slots.name);
+     *   }
+     * });
+     * ```
+     */
+    listByTenantWithSlots(tenantId: string, options?: Omit<ListBookingsOptions, 'tenant_id' | 'includeSlot'>): Promise<ApiResponse<BookingWithSlot[]>>;
     /**
      * Create a new booking (publishes booking.created event)
      * POST /api/v1/bookings
@@ -1258,4 +1355,4 @@ interface SlotlyApi {
  */
 declare const useSlotly: (options: SlotlyClientOptions) => SlotlyApi;
 
-export { type ApiResponse, type Booking, type Category, type Customer, type DataQualityIssue, type Flow, type FlowStep, type GetOrganizationOptions, type Notification, type Organization, type OrganizationFullConfig, type Service, type ServiceItem, type ServiceItemWithService, type ServiceWithItems, type Slot, type SlotlyApi, SlotlyApiError, type SlotlyAuthContext, SlotlyAuthError, type SlotlyClientOptions, SlotlyConfigurationError, SlotlyNetworkError, type SlotlyRequest, type Studio, type Tenant, type TenantBranding, type TenantFullConfig, useSlotly as default, getSlotlyContext, useSlotly, validateSlotlyRequest };
+export { type ApiResponse, type Booking, type BookingWithSlot, type Category, type Customer, type DataQualityIssue, type Flow, type FlowStep, type GetOrganizationOptions, type ListBookingsOptions, type Notification, type Organization, type OrganizationFullConfig, type Service, type ServiceItem, type ServiceItemWithService, type ServiceWithItems, type Slot, type SlotlyApi, SlotlyApiError, type SlotlyAuthContext, SlotlyAuthError, type SlotlyClientOptions, SlotlyConfigurationError, SlotlyNetworkError, type SlotlyRequest, type Studio, type Tenant, type TenantBranding, type TenantFullConfig, useSlotly as default, getSlotlyContext, useSlotly, validateSlotlyRequest };

package/dist/index.esm.js

@@ -177,8 +177,30 @@ var BookingClient = class {
     return response.data;
   }
   /**
-   * List bookings
+   * List bookings with enhanced filtering
    * GET /api/v1/bookings
+   *
+   * Supports filtering by tenant_id, slot_id, customer_id, status, and optional nested slot information.
+   *
+   * @param params - Query options (tenant_id, slot_id, customer_id, status, includeSlot, page, limit)
+   * @returns Bookings or BookingsWithSlot based on includeSlot parameter
+   *
+   * @example
+   * ```typescript
+   * // List bookings by tenant (single query - fast!)
+   * const bookings = await slotly.booking.list({
+   *   tenant_id: 'tenant-123',
+   *   includeSlot: true,
+   *   page: 1,
+   *   limit: 20
+   * });
+   *
+   * // List bookings by slot
+   * const slotBookings = await slotly.booking.list({
+   *   slot_id: 'slot-456',
+   *   status: 'confirmed'
+   * });
+   * ```
    */
   async list(params) {
     const response = await this.client.get(
@@ -187,6 +209,59 @@ var BookingClient = class {
     );
     return response.data;
   }
+  /**
+   * List bookings by tenant (convenience method)
+   * GET /api/v1/bookings?tenant_id=:id
+   *
+   * @param tenantId - Tenant ID
+   * @param options - Additional options (includeSlot, page, limit, status)
+   * @returns Bookings or BookingsWithSlot based on includeSlot parameter
+   *
+   * @example
+   * ```typescript
+   * const bookings = await slotly.booking.listByTenant('tenant-123', {
+   *   page: 1,
+   *   limit: 20,
+   *   status: 'confirmed'
+   * });
+   * ```
+   */
+  async listByTenant(tenantId, options) {
+    return this.list({
+      tenant_id: tenantId,
+      ...options
+    });
+  }
+  /**
+   * List bookings by tenant with nested slot information (convenience method)
+   * GET /api/v1/bookings?tenant_id=:id&includeSlot=true
+   *
+   * @param tenantId - Tenant ID
+   * @param options - Additional options (page, limit, status)
+   * @returns BookingsWithSlot (includes nested slot information)
+   *
+   * @example
+   * ```typescript
+   * const bookings = await slotly.booking.listByTenantWithSlots('tenant-123', {
+   *   page: 1,
+   *   limit: 20
+   * });
+   *
+   * // Access slot information
+   * bookings.data.forEach(booking => {
+   *   if (booking.slots) {
+   *     console.log('Slot name:', booking.slots.name);
+   *   }
+   * });
+   * ```
+   */
+  async listByTenantWithSlots(tenantId, options) {
+    return this.list({
+      tenant_id: tenantId,
+      includeSlot: true,
+      ...options
+    });
+  }
   /**
    * Create a new booking (publishes booking.created event)
    * POST /api/v1/bookings