@slotchain/sdk 1.1.0 → 1.1.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@slotchain/sdk",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "TypeScript SDK for Slotly API",
   "main": "dist/index.cjs.js",
   "module": "dist/index.esm.js",

package/src/clients/booking-client.ts

@@ -1,5 +1,5 @@
 import { AxiosInstance } from 'axios';
-import { ApiResponse, Booking } from '../types/api';
+import { ApiResponse, Booking, BookingWithSlot, ListBookingsOptions } from '../types/api';
 
 export class BookingClient {
   constructor(private client: AxiosInstance) {}
@@ -16,23 +16,100 @@ export class BookingClient {
   }
 
   /**
-   * 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?: {
-    slot_id?: string;
-    customer_id?: string;
-    status?: string;
-    page?: number;
-    limit?: number;
-  }): Promise<ApiResponse<Booking[]>> {
-    const response = await this.client.get<ApiResponse<Booking[]>>(
+  async list(params?: ListBookingsOptions): Promise<ApiResponse<Booking[] | BookingWithSlot[]>> {
+    const response = await this.client.get<ApiResponse<Booking[] | BookingWithSlot[]>>(
       '/api/v1/bookings',
       { params }
     );
     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: string,
+    options?: Omit<ListBookingsOptions, 'tenant_id'>
+  ): Promise<ApiResponse<Booking[] | BookingWithSlot[]>> {
+    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: string,
+    options?: Omit<ListBookingsOptions, 'tenant_id' | 'includeSlot'>
+  ): Promise<ApiResponse<BookingWithSlot[]>> {
+    return this.list({
+      tenant_id: tenantId,
+      includeSlot: true,
+      ...options,
+    }) as Promise<ApiResponse<BookingWithSlot[]>>;
+  }
+
   /**
    * Create a new booking (publishes booking.created event)
    * POST /api/v1/bookings

package/src/clients/organization-client.ts

@@ -0,0 +1,83 @@
+import { AxiosInstance } from 'axios';
+import { ApiResponse, Organization, OrganizationFullConfig, GetOrganizationOptions } from '../types/api';
+
+/**
+ * OrganizationClient provides methods for managing organizations
+ */
+export class OrganizationClient {
+  constructor(private 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
+   * });
+   * ```
+   */
+  async getById(
+    identifier: string,
+    options?: GetOrganizationOptions
+  ): Promise<ApiResponse<Organization | OrganizationFullConfig>> {
+    const params: Record<string, any> = {};
+
+    if (options?.includeTenants) {
+      params.includeTenants = 'true';
+    }
+
+    if (options?.page !== undefined) {
+      params.page = options.page;
+    }
+
+    if (options?.limit !== undefined) {
+      params.limit = options.limit;
+    }
+
+    if (options?.is_public !== undefined) {
+      params.is_public = options.is_public;
+    }
+
+    const response = await this.client.get<ApiResponse<Organization | OrganizationFullConfig>>(
+      `/api/v1/organizations/${identifier}`,
+      { params }
+    );
+    return response.data;
+  }
+
+  /**
+   * 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
+   * });
+   * ```
+   */
+  async getBySlug(
+    slug: string,
+    options?: GetOrganizationOptions
+  ): Promise<ApiResponse<Organization | OrganizationFullConfig>> {
+    return this.getById(slug, options);
+  }
+}
+

package/src/index.ts

@@ -9,6 +9,7 @@ import { FlowClient } from './clients/flow-client';
 import { StudioClient } from './clients/studio-client';
 import { NotificationClient } from './clients/notification-client';
 import { DataQualityClient } from './clients/data-quality-client';
+import { OrganizationClient } from './clients/organization-client';
 import { setupRequestInterceptor, setupResponseInterceptor, setupErrorInterceptor } from './interceptors';
 import { setupRetryInterceptor } from './retry';
 import { SlotlyConfigurationError } from './errors';
@@ -20,6 +21,8 @@ export type {
   TenantFullConfig,
   TenantBranding,
   Booking,
+  BookingWithSlot,
+  ListBookingsOptions,
   Service,
   ServiceItem,
   ServiceWithItems,
@@ -32,6 +35,9 @@ export type {
   Studio,
   Notification,
   DataQualityIssue,
+  Organization,
+  OrganizationFullConfig,
+  GetOrganizationOptions,
 } from './types/api';
 
 // Re-export errors
@@ -97,6 +103,7 @@ export interface SlotlyApi {
   studio: StudioClient;
   notification: NotificationClient;
   dataQuality: DataQualityClient;
+  organization: OrganizationClient;
 }
 
 const defaultBaseURL = typeof process !== 'undefined' && process.env?.SLOTLY_API_URL 
@@ -289,6 +296,7 @@ export const useSlotly = (options: SlotlyClientOptions): SlotlyApi => {
     studio: new StudioClient(client),
     notification: new NotificationClient(client),
     dataQuality: new DataQualityClient(client),
+    organization: new OrganizationClient(client),
   };
 };
 

package/src/types/api.ts

@@ -26,7 +26,20 @@ export interface Tenant {
   id: string;
   slug: string;
   name: string;
-  // TODO: Add actual tenant properties
+  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;
 }
 
 /**
@@ -88,11 +101,49 @@ export interface Category {
 
 export 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;
-  // TODO: Add actual booking properties
+  created_at: string;
+  updated_at: string;
+}
+
+/**
+ * Booking with nested slot information
+ */
+export interface BookingWithSlot extends Booking {
+  slots?: Slot;
+}
+
+/**
+ * Options for listing bookings
+ */
+export interface ListBookingsOptions {
+  tenant_id?: string;
+  slot_id?: string;
+  customer_id?: string;
+  status?: string;
+  includeSlot?: boolean;
+  page?: number;
+  limit?: number;
 }
 
 export interface Service {
@@ -107,12 +158,13 @@ export interface Service {
 
 export interface Slot {
   id: string;
-  tenantId: string;
-  serviceId?: string;
-  startTime: string;
-  endTime: string;
-  available: boolean;
-  // TODO: Add actual slot properties
+  tenant_id: string;
+  name: string;
+  description?: string;
+  status?: string;
+  is_active?: boolean;
+  created_at: string;
+  updated_at: string;
 }
 
 export interface Customer {
@@ -166,6 +218,37 @@ export interface DataQualityIssue {
   // TODO: Add actual data quality issue properties
 }
 
+/**
+ * Organization type
+ */
+export 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
+ */
+export interface OrganizationFullConfig extends Organization {
+  tenants: Tenant[];
+}
+
+/**
+ * Options for getting organization
+ */
+export 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)