@slotchain/sdk 1.1.3 → 1.1.4

package/dist/index.d.mts

@@ -57,20 +57,32 @@ interface TenantBranding {
  */
 interface ServiceItem {
     id: string;
-    serviceId: string;
+    service_id: string;
     name: string;
     description?: string;
     price?: number;
     duration?: number;
-    available?: boolean;
+    is_available?: boolean;
+    sort_order?: number;
+    created_at: string;
+    updated_at: string;
 }
 /**
- * Enhanced Service type with nested service items
+ * Enhanced Service type with nested service items (for tenant endpoint)
+ * Uses 'serviceItems' property name
  */
 interface ServiceWithItems extends Service {
     /** Array of service items nested within this service (optional, may be empty array) */
     serviceItems?: ServiceItem[];
 }
+/**
+ * Service with items for slot endpoint
+ * Uses 'items' property name (different from tenant endpoint)
+ */
+interface SlotServiceWithItems extends Service {
+    /** Array of service items nested within this service (always included for slot endpoint) */
+    items: ServiceItem[];
+}
 /**
  * Service item with parent service reference
  */
@@ -137,11 +149,16 @@ interface ListBookingsOptions {
 }
 interface Service {
     id: string;
-    tenantId: string;
+    tenant_id: string;
+    slot_id?: string;
     name: string;
     description?: string;
+    category?: string;
+    is_active?: boolean;
     duration?: number;
     price?: number;
+    created_at: string;
+    updated_at: string;
 }
 interface Slot {
     id: string;
@@ -488,10 +505,45 @@ declare class ServiceClient {
      * @returns Service details (with items if includeItems=true)
      */
     getById(id: string, includeItems?: boolean): Promise<ApiResponse<Service | ServiceWithItems>>;
+    /**
+     * Get services for a tenant (full list with optional filters)
+     * GET /api/v1/services
+     *
+     * @param options - Query options
+     * @param options.tenantId - Tenant ID (UUID) - required if tenantSlug not provided
+     * @param options.tenantSlug - Tenant slug - required if tenantId not provided
+     * @param options.slotId - Slot ID (DEPRECATED - accepted but ignored for API compatibility)
+     * @param options.isActive - Filter by active status
+     * @param options.includeItems - Include nested service items (default: false)
+     * @param options.page - Page number (default: 1)
+     * @param options.limit - Items per page (default: 20, max: 100)
+     * @returns Services with optional pagination metadata
+     */
+    getServicesByTenant(options: {
+        tenantId?: string;
+        tenantSlug?: string;
+        slotId?: string;
+        isActive?: boolean;
+        includeItems?: boolean;
+        page?: number;
+        limit?: number;
+    }): Promise<ApiResponse<Service[] | ServiceWithItems[]>>;
+    /**
+     * Get services for a specific slot
+     * GET /api/v1/slots/:id/services
+     *
+     * Note: Services are tenant-level entities. This endpoint returns all active services
+     * for the slot's tenant with items included. The response uses 'items' property (not 'serviceItems').
+     *
+     * @param slotId - Slot ID (UUID)
+     * @returns Services with nested items (always includes items, only active services)
+     */
+    getServicesBySlot(slotId: string): Promise<ApiResponse<SlotServiceWithItems[]>>;
     /**
      * List services by tenant slug
      * GET /api/v1/services?tenantSlug=:slug
      *
+     * @deprecated Consider using getServicesByTenant() for better type safety and validation
      * @param slug - Tenant slug (or use tenant_id in list() method)
      * @param params - Optional parameters (includeItems, page, limit, is_active)
      * @returns List of services for the tenant
@@ -506,6 +558,7 @@ declare class ServiceClient {
      * List services with optional filters
      * GET /api/v1/services
      *
+     * @deprecated Consider using getServicesByTenant() for better type safety and validation
      * @param params - Query parameters (tenant_id, tenantSlug, slot_id, page, limit, is_active, includeItems)
      * @returns Paginated list of services
      */
@@ -728,10 +781,13 @@ declare class SlotClient {
      * Get all active services for a slot with their items
      * GET /api/v1/slots/:id/services
      *
-     * @param id - Slot ID
-     * @returns Services with nested service items
+     * Note: Services are tenant-level entities. This endpoint returns all active services
+     * for the slot's tenant with items included. The response uses 'items' property (not 'serviceItems').
+     *
+     * @param id - Slot ID (UUID)
+     * @returns Services with nested items (always includes items, only active services)
      */
-    getServices(id: string): Promise<ApiResponse<ServiceWithItems[]>>;
+    getServices(id: string): Promise<ApiResponse<SlotServiceWithItems[]>>;
     /**
      * Get slot with tenant information
      * GET /api/v1/slots/:id/tenant-info
@@ -1355,4 +1411,4 @@ interface SlotlyApi {
  */
 declare const useSlotly: (options: SlotlyClientOptions) => SlotlyApi;
 
-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 };
+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 SlotServiceWithItems, 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

@@ -57,20 +57,32 @@ interface TenantBranding {
  */
 interface ServiceItem {
     id: string;
-    serviceId: string;
+    service_id: string;
     name: string;
     description?: string;
     price?: number;
     duration?: number;
-    available?: boolean;
+    is_available?: boolean;
+    sort_order?: number;
+    created_at: string;
+    updated_at: string;
 }
 /**
- * Enhanced Service type with nested service items
+ * Enhanced Service type with nested service items (for tenant endpoint)
+ * Uses 'serviceItems' property name
  */
 interface ServiceWithItems extends Service {
     /** Array of service items nested within this service (optional, may be empty array) */
     serviceItems?: ServiceItem[];
 }
+/**
+ * Service with items for slot endpoint
+ * Uses 'items' property name (different from tenant endpoint)
+ */
+interface SlotServiceWithItems extends Service {
+    /** Array of service items nested within this service (always included for slot endpoint) */
+    items: ServiceItem[];
+}
 /**
  * Service item with parent service reference
  */
@@ -137,11 +149,16 @@ interface ListBookingsOptions {
 }
 interface Service {
     id: string;
-    tenantId: string;
+    tenant_id: string;
+    slot_id?: string;
     name: string;
     description?: string;
+    category?: string;
+    is_active?: boolean;
     duration?: number;
     price?: number;
+    created_at: string;
+    updated_at: string;
 }
 interface Slot {
     id: string;
@@ -488,10 +505,45 @@ declare class ServiceClient {
      * @returns Service details (with items if includeItems=true)
      */
     getById(id: string, includeItems?: boolean): Promise<ApiResponse<Service | ServiceWithItems>>;
+    /**
+     * Get services for a tenant (full list with optional filters)
+     * GET /api/v1/services
+     *
+     * @param options - Query options
+     * @param options.tenantId - Tenant ID (UUID) - required if tenantSlug not provided
+     * @param options.tenantSlug - Tenant slug - required if tenantId not provided
+     * @param options.slotId - Slot ID (DEPRECATED - accepted but ignored for API compatibility)
+     * @param options.isActive - Filter by active status
+     * @param options.includeItems - Include nested service items (default: false)
+     * @param options.page - Page number (default: 1)
+     * @param options.limit - Items per page (default: 20, max: 100)
+     * @returns Services with optional pagination metadata
+     */
+    getServicesByTenant(options: {
+        tenantId?: string;
+        tenantSlug?: string;
+        slotId?: string;
+        isActive?: boolean;
+        includeItems?: boolean;
+        page?: number;
+        limit?: number;
+    }): Promise<ApiResponse<Service[] | ServiceWithItems[]>>;
+    /**
+     * Get services for a specific slot
+     * GET /api/v1/slots/:id/services
+     *
+     * Note: Services are tenant-level entities. This endpoint returns all active services
+     * for the slot's tenant with items included. The response uses 'items' property (not 'serviceItems').
+     *
+     * @param slotId - Slot ID (UUID)
+     * @returns Services with nested items (always includes items, only active services)
+     */
+    getServicesBySlot(slotId: string): Promise<ApiResponse<SlotServiceWithItems[]>>;
     /**
      * List services by tenant slug
      * GET /api/v1/services?tenantSlug=:slug
      *
+     * @deprecated Consider using getServicesByTenant() for better type safety and validation
      * @param slug - Tenant slug (or use tenant_id in list() method)
      * @param params - Optional parameters (includeItems, page, limit, is_active)
      * @returns List of services for the tenant
@@ -506,6 +558,7 @@ declare class ServiceClient {
      * List services with optional filters
      * GET /api/v1/services
      *
+     * @deprecated Consider using getServicesByTenant() for better type safety and validation
      * @param params - Query parameters (tenant_id, tenantSlug, slot_id, page, limit, is_active, includeItems)
      * @returns Paginated list of services
      */
@@ -728,10 +781,13 @@ declare class SlotClient {
      * Get all active services for a slot with their items
      * GET /api/v1/slots/:id/services
      *
-     * @param id - Slot ID
-     * @returns Services with nested service items
+     * Note: Services are tenant-level entities. This endpoint returns all active services
+     * for the slot's tenant with items included. The response uses 'items' property (not 'serviceItems').
+     *
+     * @param id - Slot ID (UUID)
+     * @returns Services with nested items (always includes items, only active services)
      */
-    getServices(id: string): Promise<ApiResponse<ServiceWithItems[]>>;
+    getServices(id: string): Promise<ApiResponse<SlotServiceWithItems[]>>;
     /**
      * Get slot with tenant information
      * GET /api/v1/slots/:id/tenant-info
@@ -1355,4 +1411,4 @@ interface SlotlyApi {
  */
 declare const useSlotly: (options: SlotlyClientOptions) => SlotlyApi;
 
-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 };
+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 SlotServiceWithItems, 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

@@ -324,10 +324,79 @@ var ServiceClient = class {
     );
     return response.data;
   }
+  /**
+   * Get services for a tenant (full list with optional filters)
+   * GET /api/v1/services
+   * 
+   * @param options - Query options
+   * @param options.tenantId - Tenant ID (UUID) - required if tenantSlug not provided
+   * @param options.tenantSlug - Tenant slug - required if tenantId not provided
+   * @param options.slotId - Slot ID (DEPRECATED - accepted but ignored for API compatibility)
+   * @param options.isActive - Filter by active status
+   * @param options.includeItems - Include nested service items (default: false)
+   * @param options.page - Page number (default: 1)
+   * @param options.limit - Items per page (default: 20, max: 100)
+   * @returns Services with optional pagination metadata
+   */
+  async getServicesByTenant(options) {
+    if (!options.tenantId && !options.tenantSlug) {
+      return {
+        success: false,
+        error: {
+          code: "MISSING_TENANT_ID",
+          message: "tenantId or tenantSlug is required"
+        }
+      };
+    }
+    const params = {};
+    if (options.tenantId) {
+      params.tenant_id = options.tenantId;
+    }
+    if (options.tenantSlug) {
+      params.tenantSlug = options.tenantSlug;
+    }
+    if (options.slotId) {
+      params.slot_id = options.slotId;
+    }
+    if (options.isActive !== void 0) {
+      params.is_active = options.isActive;
+    }
+    if (options.includeItems) {
+      params.includeItems = true;
+    }
+    if (options.page !== void 0) {
+      params.page = options.page;
+    }
+    if (options.limit !== void 0) {
+      params.limit = Math.min(options.limit, 100);
+    }
+    const response = await this.client.get(
+      "/api/v1/services",
+      { params }
+    );
+    return response.data;
+  }
+  /**
+   * Get services for a specific slot
+   * GET /api/v1/slots/:id/services
+   * 
+   * Note: Services are tenant-level entities. This endpoint returns all active services
+   * for the slot's tenant with items included. The response uses 'items' property (not 'serviceItems').
+   * 
+   * @param slotId - Slot ID (UUID)
+   * @returns Services with nested items (always includes items, only active services)
+   */
+  async getServicesBySlot(slotId) {
+    const response = await this.client.get(
+      `/api/v1/slots/${slotId}/services`
+    );
+    return response.data;
+  }
   /**
    * List services by tenant slug
    * GET /api/v1/services?tenantSlug=:slug
    * 
+   * @deprecated Consider using getServicesByTenant() for better type safety and validation
    * @param slug - Tenant slug (or use tenant_id in list() method)
    * @param params - Optional parameters (includeItems, page, limit, is_active)
    * @returns List of services for the tenant
@@ -343,6 +412,7 @@ var ServiceClient = class {
    * List services with optional filters
    * GET /api/v1/services
    * 
+   * @deprecated Consider using getServicesByTenant() for better type safety and validation
    * @param params - Query parameters (tenant_id, tenantSlug, slot_id, page, limit, is_active, includeItems)
    * @returns Paginated list of services
    */
@@ -659,8 +729,11 @@ var SlotClient = class {
    * Get all active services for a slot with their items
    * GET /api/v1/slots/:id/services
    * 
-   * @param id - Slot ID
-   * @returns Services with nested service items
+   * Note: Services are tenant-level entities. This endpoint returns all active services
+   * for the slot's tenant with items included. The response uses 'items' property (not 'serviceItems').
+   * 
+   * @param id - Slot ID (UUID)
+   * @returns Services with nested items (always includes items, only active services)
    */
   async getServices(id) {
     const response = await this.client.get(