@slotchain/sdk 1.1.0 → 1.1.2

package/dist/index.d.mts

@@ -27,6 +27,20 @@ interface Tenant {
     id: string;
     slug: string;
     name: string;
+    primary_domain?: string;
+    subdomain?: string;
+    custom_domains?: string[];
+    branding?: {
+        logo?: string;
+        colors?: {
+            primary?: string;
+            secondary?: string;
+        };
+    };
+    is_public?: boolean;
+    metadata?: Record<string, unknown>;
+    created_at: string;
+    updated_at: string;
 }
 /**
  * Tenant branding configuration
@@ -79,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;
@@ -94,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;
@@ -139,6 +192,34 @@ interface DataQualityIssue {
     message: string;
     resolved: boolean;
 }
+/**
+ * Organization type
+ */
+interface Organization {
+    id: string;
+    slug?: string;
+    name: string;
+    description?: string;
+    metadata?: Record<string, unknown>;
+    tenant_slugs?: string[];
+    created_at: string;
+    updated_at: string;
+}
+/**
+ * Organization with nested tenants
+ */
+interface OrganizationFullConfig extends Organization {
+    tenants: Tenant[];
+}
+/**
+ * Options for getting organization
+ */
+interface GetOrganizationOptions {
+    includeTenants?: boolean;
+    page?: number;
+    limit?: number;
+    is_public?: boolean;
+}
 /**
  * Full tenant configuration including branding, services, and service items
  * Service items are nested within each service object (not as a separate top-level array)
@@ -287,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
@@ -943,6 +1082,53 @@ declare class DataQualityClient {
     getSummary(tenantId: string): Promise<ApiResponse<any>>;
 }
 
+/**
+ * OrganizationClient provides methods for managing organizations
+ */
+declare class OrganizationClient {
+    private client;
+    constructor(client: AxiosInstance);
+    /**
+     * Get organization by ID or slug
+     * GET /api/v1/organizations/:id
+     *
+     * @param identifier - Organization ID or slug
+     * @param options - Query options (includeTenants, page, limit, is_public)
+     * @returns Organization or OrganizationFullConfig (with nested tenants if includeTenants=true)
+     *
+     * @example
+     * ```typescript
+     * // Get organization only
+     * const org = await slotly.organization.getById('org-123');
+     *
+     * // Get organization with tenants
+     * const orgWithTenants = await slotly.organization.getById('org-123', {
+     *   includeTenants: true,
+     *   page: 1,
+     *   limit: 10,
+     *   is_public: true
+     * });
+     * ```
+     */
+    getById(identifier: string, options?: GetOrganizationOptions): Promise<ApiResponse<Organization | OrganizationFullConfig>>;
+    /**
+     * Get organization by slug (alias for getById)
+     * GET /api/v1/organizations/:slug
+     *
+     * @param slug - Organization slug
+     * @param options - Query options (includeTenants, page, limit, is_public)
+     * @returns Organization or OrganizationFullConfig (with nested tenants if includeTenants=true)
+     *
+     * @example
+     * ```typescript
+     * const org = await slotly.organization.getBySlug('acme-corp', {
+     *   includeTenants: true
+     * });
+     * ```
+     */
+    getBySlug(slug: string, options?: GetOrganizationOptions): Promise<ApiResponse<Organization | OrganizationFullConfig>>;
+}
+
 /**
  * Custom error classes for Slotly SDK
  */
@@ -1104,6 +1290,7 @@ interface SlotlyApi {
     studio: StudioClient;
     notification: NotificationClient;
     dataQuality: DataQualityClient;
+    organization: OrganizationClient;
 }
 /**
  * Initialize and configure a new Slotly API client with dual authentication.
@@ -1168,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 Notification, 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

@@ -27,6 +27,20 @@ interface Tenant {
     id: string;
     slug: string;
     name: string;
+    primary_domain?: string;
+    subdomain?: string;
+    custom_domains?: string[];
+    branding?: {
+        logo?: string;
+        colors?: {
+            primary?: string;
+            secondary?: string;
+        };
+    };
+    is_public?: boolean;
+    metadata?: Record<string, unknown>;
+    created_at: string;
+    updated_at: string;
 }
 /**
  * Tenant branding configuration
@@ -79,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;
@@ -94,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;
@@ -139,6 +192,34 @@ interface DataQualityIssue {
     message: string;
     resolved: boolean;
 }
+/**
+ * Organization type
+ */
+interface Organization {
+    id: string;
+    slug?: string;
+    name: string;
+    description?: string;
+    metadata?: Record<string, unknown>;
+    tenant_slugs?: string[];
+    created_at: string;
+    updated_at: string;
+}
+/**
+ * Organization with nested tenants
+ */
+interface OrganizationFullConfig extends Organization {
+    tenants: Tenant[];
+}
+/**
+ * Options for getting organization
+ */
+interface GetOrganizationOptions {
+    includeTenants?: boolean;
+    page?: number;
+    limit?: number;
+    is_public?: boolean;
+}
 /**
  * Full tenant configuration including branding, services, and service items
  * Service items are nested within each service object (not as a separate top-level array)
@@ -287,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
@@ -943,6 +1082,53 @@ declare class DataQualityClient {
     getSummary(tenantId: string): Promise<ApiResponse<any>>;
 }
 
+/**
+ * OrganizationClient provides methods for managing organizations
+ */
+declare class OrganizationClient {
+    private client;
+    constructor(client: AxiosInstance);
+    /**
+     * Get organization by ID or slug
+     * GET /api/v1/organizations/:id
+     *
+     * @param identifier - Organization ID or slug
+     * @param options - Query options (includeTenants, page, limit, is_public)
+     * @returns Organization or OrganizationFullConfig (with nested tenants if includeTenants=true)
+     *
+     * @example
+     * ```typescript
+     * // Get organization only
+     * const org = await slotly.organization.getById('org-123');
+     *
+     * // Get organization with tenants
+     * const orgWithTenants = await slotly.organization.getById('org-123', {
+     *   includeTenants: true,
+     *   page: 1,
+     *   limit: 10,
+     *   is_public: true
+     * });
+     * ```
+     */
+    getById(identifier: string, options?: GetOrganizationOptions): Promise<ApiResponse<Organization | OrganizationFullConfig>>;
+    /**
+     * Get organization by slug (alias for getById)
+     * GET /api/v1/organizations/:slug
+     *
+     * @param slug - Organization slug
+     * @param options - Query options (includeTenants, page, limit, is_public)
+     * @returns Organization or OrganizationFullConfig (with nested tenants if includeTenants=true)
+     *
+     * @example
+     * ```typescript
+     * const org = await slotly.organization.getBySlug('acme-corp', {
+     *   includeTenants: true
+     * });
+     * ```
+     */
+    getBySlug(slug: string, options?: GetOrganizationOptions): Promise<ApiResponse<Organization | OrganizationFullConfig>>;
+}
+
 /**
  * Custom error classes for Slotly SDK
  */
@@ -1104,6 +1290,7 @@ interface SlotlyApi {
     studio: StudioClient;
     notification: NotificationClient;
     dataQuality: DataQualityClient;
+    organization: OrganizationClient;
 }
 /**
  * Initialize and configure a new Slotly API client with dual authentication.
@@ -1168,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 Notification, 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 };