@slotchain/sdk 1.0.0

package/src/clients/service-client.ts

@@ -0,0 +1,215 @@
+import { AxiosInstance } from 'axios';
+import { ApiResponse, Service, ServiceWithItems, Category } from '../types/api';
+
+export class ServiceClient {
+  constructor(private client: AxiosInstance) {}
+
+  /**
+   * Get service by ID
+   * GET /api/v1/services/:id
+   * 
+   * @param id - Service ID
+   * @param includeItems - Include nested service items (default: false)
+   * @returns Service details (with items if includeItems=true)
+   */
+  async getById(id: string, includeItems: boolean = false): Promise<ApiResponse<Service | ServiceWithItems>> {
+    const response = await this.client.get<ApiResponse<Service | ServiceWithItems>>(
+      `/api/v1/services/${id}`,
+      includeItems ? { params: { includeItems: true } } : undefined
+    );
+    return response.data;
+  }
+
+  /**
+   * List services by tenant slug
+   * GET /api/v1/services?tenantSlug=:slug
+   * 
+   * @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
+   */
+  async listServices(
+    slug: string,
+    params?: {
+      includeItems?: boolean;
+      page?: number;
+      limit?: number;
+      is_active?: boolean;
+    }
+  ): Promise<ApiResponse<Service[] | ServiceWithItems[]>> {
+    const response = await this.client.get<ApiResponse<Service[] | ServiceWithItems[]>>(
+      '/api/v1/services',
+      { params: { tenantSlug: slug, ...params } }
+    );
+    return response.data;
+  }
+
+  /**
+   * List services with optional filters
+   * GET /api/v1/services
+   * 
+   * @param params - Query parameters (tenant_id, tenantSlug, slot_id, page, limit, is_active, includeItems)
+   * @returns Paginated list of services
+   */
+  async list(params?: {
+    tenant_id?: string;
+    tenantSlug?: string;
+    slot_id?: string;
+    page?: number;
+    limit?: number;
+    is_active?: boolean;
+    includeItems?: boolean;
+  }): Promise<ApiResponse<Service[] | ServiceWithItems[]>> {
+    const response = await this.client.get<ApiResponse<Service[] | ServiceWithItems[]>>(
+      '/api/v1/services',
+      { params }
+    );
+    return response.data;
+  }
+
+  /**
+   * Create a new service
+   * POST /api/v1/services
+   * 
+   * @param data - Service creation data (tenant_id, name required)
+   * @returns Created service
+   */
+  async create(data: Partial<Service>): Promise<ApiResponse<Service>> {
+    const response = await this.client.post<ApiResponse<Service>>(
+      '/api/v1/services',
+      data
+    );
+    return response.data;
+  }
+
+  /**
+   * Update service by ID
+   * PUT /api/v1/services/:id
+   * 
+   * @param id - Service ID
+   * @param data - Service update data
+   * @returns Updated service
+   */
+  async update(id: string, data: Partial<Service>): Promise<ApiResponse<Service>> {
+    const response = await this.client.put<ApiResponse<Service>>(
+      `/api/v1/services/${id}`,
+      data
+    );
+    return response.data;
+  }
+
+  /**
+   * Delete service by ID
+   * DELETE /api/v1/services/:id
+   * 
+   * @param id - Service ID
+   * @returns Empty response on success
+   */
+  async delete(id: string): Promise<ApiResponse<void>> {
+    const response = await this.client.delete<ApiResponse<void>>(
+      `/api/v1/services/${id}`
+    );
+    return response.data;
+  }
+
+  /**
+   * Bulk create services
+   * POST /api/v1/services/bulk (if available)
+   * 
+   * @param services - Array of services to create
+   * @returns Created services
+   */
+  async bulkCreate(services: Partial<Service>[]): Promise<ApiResponse<Service[]>> {
+    // Note: Verify if bulk endpoint exists in API
+    const response = await this.client.post<ApiResponse<Service[]>>(
+      '/api/v1/services/bulk',
+      { services }
+    );
+    return response.data;
+  }
+
+  /**
+   * Get service with its service items nested
+   * GET /api/v1/services/:id?includeItems=true
+   * 
+   * @param id - Service ID
+   * @returns Service with nested service items
+   */
+  async getWithItems(id: string): Promise<ApiResponse<ServiceWithItems>> {
+    const response = await this.client.get<ApiResponse<ServiceWithItems>>(
+      `/api/v1/services/${id}`,
+      { params: { includeItems: true } }
+    );
+    return response.data;
+  }
+
+  /**
+   * List services with their service items nested
+   * GET /api/v1/services?includeItems=true
+   * 
+   * @param params - Query parameters (tenant_id, tenantSlug, slot_id, page, limit, is_active)
+   * @returns Paginated list of services with nested service items
+   */
+  async listWithItems(params?: {
+    tenant_id?: string;
+    tenantSlug?: string;
+    slot_id?: string;
+    page?: number;
+    limit?: number;
+    is_active?: boolean;
+  }): Promise<ApiResponse<ServiceWithItems[]>> {
+    const response = await this.client.get<ApiResponse<ServiceWithItems[]>>(
+      '/api/v1/services',
+      { params: { includeItems: true, ...params } }
+    );
+    return response.data;
+  }
+
+  /**
+   * List all categories for a tenant (extracted from services)
+   * GET /api/v1/categories?tenantSlug=:slug
+   * 
+   * @param tenantSlug - Tenant slug (or use tenant_id in params)
+   * @param params - Optional query parameters (tenant_id, includeServices)
+   * @returns List of categories for the tenant
+   */
+  async listCategories(
+    tenantSlug?: string,
+    params?: {
+      tenant_id?: string;
+      includeServices?: boolean;
+    }
+  ): Promise<ApiResponse<Category[]>> {
+    const response = await this.client.get<ApiResponse<Category[]>>(
+      '/api/v1/categories',
+      { params: { tenantSlug, ...params } }
+    );
+    return response.data;
+  }
+
+  /**
+   * Get category by ID (category name, lowercase)
+   * GET /api/v1/categories/:id?tenantSlug=:slug
+   * 
+   * @param categoryId - Category ID (lowercase category name, e.g., "consulting")
+   * @param tenantSlug - Tenant slug (or use tenant_id in params)
+   * @param params - Optional query parameters (tenant_id, includeServices, includeItems)
+   * @returns Category details
+   */
+  async getCategory(
+    categoryId: string,
+    tenantSlug?: string,
+    params?: {
+      tenant_id?: string;
+      includeServices?: boolean;
+      includeItems?: boolean;
+    }
+  ): Promise<ApiResponse<Category>> {
+    const response = await this.client.get<ApiResponse<Category>>(
+      `/api/v1/categories/${categoryId}`,
+      { params: { tenantSlug, ...params } }
+    );
+    return response.data;
+  }
+}
+

package/src/clients/service-item-client.ts

@@ -0,0 +1,103 @@
+import { AxiosInstance } from 'axios';
+import { ApiResponse, ServiceItem, ServiceItemWithService } from '../types/api';
+
+/**
+ * ServiceItemClient provides methods for managing service items independently
+ * or in relation to their parent services.
+ */
+export class ServiceItemClient {
+  constructor(private client: AxiosInstance) {}
+
+  /**
+   * Get service item by ID
+   * GET /api/v1/service-items/:id
+   * 
+   * @param id - Service item ID
+   * @returns Service item details
+   */
+  async getById(id: string): Promise<ApiResponse<ServiceItem>> {
+    const response = await this.client.get<ApiResponse<ServiceItem>>(
+      `/api/v1/service-items/${id}`
+    );
+    return response.data;
+  }
+
+  /**
+   * List all service items for a service
+   * GET /api/v1/services/:serviceId/items
+   * 
+   * @param serviceId - Service ID
+   * @returns List of service items for the specified service
+   */
+  async listByService(serviceId: string): Promise<ApiResponse<ServiceItem[]>> {
+    const response = await this.client.get<ApiResponse<ServiceItem[]>>(
+      `/api/v1/services/${serviceId}/items`
+    );
+    return response.data;
+  }
+
+  /**
+   * Create a new service item for a service
+   * POST /api/v1/services/:serviceId/items
+   * 
+   * @param serviceId - Service ID
+   * @param data - Service item creation data
+   * @returns Created service item
+   */
+  async createForService(
+    serviceId: string,
+    data: Partial<ServiceItem>
+  ): Promise<ApiResponse<ServiceItem>> {
+    const response = await this.client.post<ApiResponse<ServiceItem>>(
+      `/api/v1/services/${serviceId}/items`,
+      { ...data, service_id: serviceId }
+    );
+    return response.data;
+  }
+
+  /**
+   * Create a new service item
+   * POST /api/v1/service-items (alternative to createForService)
+   * 
+   * @param data - Service item creation data (must include service_id)
+   * @returns Created service item
+   */
+  async create(data: Partial<ServiceItem>): Promise<ApiResponse<ServiceItem>> {
+    const response = await this.client.post<ApiResponse<ServiceItem>>(
+      '/api/v1/service-items',
+      data
+    );
+    return response.data;
+  }
+
+  /**
+   * Update service item by ID
+   * PUT /api/v1/service-items/:id
+   * 
+   * @param id - Service item ID
+   * @param data - Service item update data
+   * @returns Updated service item
+   */
+  async update(id: string, data: Partial<ServiceItem>): Promise<ApiResponse<ServiceItem>> {
+    const response = await this.client.put<ApiResponse<ServiceItem>>(
+      `/api/v1/service-items/${id}`,
+      data
+    );
+    return response.data;
+  }
+
+  /**
+   * Delete service item by ID
+   * DELETE /api/v1/service-items/:id
+   * 
+   * @param id - Service item ID
+   * @returns Empty response on success
+   */
+  async delete(id: string): Promise<ApiResponse<void>> {
+    const response = await this.client.delete<ApiResponse<void>>(
+      `/api/v1/service-items/${id}`
+    );
+    return response.data;
+  }
+}
+

package/src/clients/slot-client.ts

@@ -0,0 +1,140 @@
+import { AxiosInstance } from 'axios';
+import { ApiResponse, Slot, ServiceWithItems, Tenant } from '../types/api';
+
+export class SlotClient {
+  constructor(private client: AxiosInstance) {}
+
+  /**
+   * Get slot by ID
+   * GET /api/v1/slots/:id
+   * 
+   * @param id - Slot ID
+   * @returns Slot details
+   */
+  async getById(id: string): Promise<ApiResponse<Slot>> {
+    // TODO: Replace with actual endpoint when available
+    const response = await this.client.get<ApiResponse<Slot>>(
+      `/api/v1/slots/${id}`
+    );
+    return response.data;
+  }
+
+  /**
+   * List available slots
+   * GET /api/v1/slots
+   * 
+   * @param params - Query parameters (tenant_id required, status, is_active, page, limit)
+   * @returns Paginated list of slots
+   */
+  async list(params: {
+    tenant_id: string;
+    status?: string;
+    is_active?: boolean;
+    page?: number;
+    limit?: number;
+  }): Promise<ApiResponse<Slot[]>> {
+    const response = await this.client.get<ApiResponse<Slot[]>>(
+      '/api/v1/slots',
+      { params }
+    );
+    return response.data;
+  }
+
+  /**
+   * Create a new slot
+   * POST /api/v1/slots
+   * 
+   * @param data - Slot creation data (tenant_id, name required)
+   * @returns Created slot
+   */
+  async create(data: Partial<Slot>): Promise<ApiResponse<Slot>> {
+    const response = await this.client.post<ApiResponse<Slot>>(
+      '/api/v1/slots',
+      data
+    );
+    return response.data;
+  }
+
+  /**
+   * Update slot by ID
+   * PUT /api/v1/slots/:id
+   * 
+   * @param id - Slot ID
+   * @param data - Slot update data
+   * @returns Updated slot
+   */
+  async update(id: string, data: Partial<Slot>): Promise<ApiResponse<Slot>> {
+    const response = await this.client.put<ApiResponse<Slot>>(
+      `/api/v1/slots/${id}`,
+      data
+    );
+    return response.data;
+  }
+
+  /**
+   * Delete slot by ID
+   * DELETE /api/v1/slots/:id
+   * 
+   * @param id - Slot ID
+   * @returns Empty response on success
+   */
+  async delete(id: string): Promise<ApiResponse<void>> {
+    const response = await this.client.delete<ApiResponse<void>>(
+      `/api/v1/slots/${id}`
+    );
+    return response.data;
+  }
+
+  /**
+   * Bulk create slots
+   * POST /api/v1/slots/bulk (verify if available)
+   * 
+   * @param slots - Array of slots to create
+   * @returns Created slots
+   */
+  async bulkCreate(slots: Partial<Slot>[]): Promise<ApiResponse<Slot[]>> {
+    // Note: Verify if bulk endpoint exists in API
+    const response = await this.client.post<ApiResponse<Slot[]>>(
+      '/api/v1/slots/bulk',
+      { slots }
+    );
+    return response.data;
+  }
+
+  /**
+   * Mark slot as available/unavailable
+   * Note: Use update() method with status or other fields
+   */
+  async setAvailability(id: string, available: boolean): Promise<ApiResponse<Slot>> {
+    return this.update(id, { status: available ? 'active' : 'inactive' } as Partial<Slot>);
+  }
+
+  /**
+   * 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
+   */
+  async getServices(id: string): Promise<ApiResponse<ServiceWithItems[]>> {
+    const response = await this.client.get<ApiResponse<ServiceWithItems[]>>(
+      `/api/v1/slots/${id}/services`
+    );
+    return response.data;
+  }
+
+  /**
+   * Get slot with tenant information
+   * GET /api/v1/slots/:id/tenant-info
+   * 
+   * @param id - Slot ID
+   * @returns Slot with tenant data
+   */
+  async getWithTenant(id: string): Promise<ApiResponse<Slot & { tenant: Tenant }>> {
+    const response = await this.client.get<ApiResponse<Slot & { tenant: Tenant }>>(
+      `/api/v1/slots/${id}/tenant-info`
+    );
+    return response.data;
+  }
+}
+

package/src/clients/studio-client.ts

@@ -0,0 +1,128 @@
+import { AxiosInstance } from 'axios';
+import { ApiResponse, Studio } from '../types/api';
+
+export class StudioClient {
+  constructor(private client: AxiosInstance) {}
+
+  /**
+   * Get studio by ID
+   * GET /api/v1/studios/:id
+   * 
+   * @param id - Studio ID
+   * @returns Studio details
+   */
+  async getById(id: string): Promise<ApiResponse<Studio>> {
+    // TODO: Replace with actual endpoint when available
+    const response = await this.client.get<ApiResponse<Studio>>(
+      `/api/v1/studios/${id}`
+    );
+    return response.data;
+  }
+
+  /**
+   * Get studio by slug
+   * GET /api/v1/studios/slug/:slug
+   * 
+   * @param slug - Studio slug
+   * @returns Studio details
+   */
+  async getBySlug(slug: string): Promise<ApiResponse<Studio>> {
+    // TODO: Replace with actual endpoint when available
+    const response = await this.client.get<ApiResponse<Studio>>(
+      `/api/v1/studios/slug/${slug}`
+    );
+    return response.data;
+  }
+
+  /**
+   * List studios with optional filters
+   * GET /api/v1/studios
+   * 
+   * @param params - Query parameters (page, limit, search)
+   * @returns Paginated list of studios
+   */
+  async list(params?: {
+    page?: number;
+    limit?: number;
+    search?: string;
+  }): Promise<ApiResponse<Studio[]>> {
+    // TODO: Replace with actual endpoint when available
+    const response = await this.client.get<ApiResponse<Studio[]>>(
+      '/api/v1/studios',
+      { params }
+    );
+    return response.data;
+  }
+
+  /**
+   * Create a new studio
+   * POST /api/v1/studios
+   * 
+   * @param data - Studio creation data
+   * @returns Created studio
+   */
+  async create(data: Partial<Studio>): Promise<ApiResponse<Studio>> {
+    // TODO: Replace with actual endpoint when available
+    const response = await this.client.post<ApiResponse<Studio>>(
+      '/api/v1/studios',
+      data
+    );
+    return response.data;
+  }
+
+  /**
+   * Update studio by ID
+   * PATCH /api/v1/studios/:id
+   * 
+   * @param id - Studio ID
+   * @param data - Studio update data
+   * @returns Updated studio
+   */
+  async update(id: string, data: Partial<Studio>): Promise<ApiResponse<Studio>> {
+    // TODO: Replace with actual endpoint when available
+    const response = await this.client.patch<ApiResponse<Studio>>(
+      `/api/v1/studios/${id}`,
+      data
+    );
+    return response.data;
+  }
+
+  /**
+   * Delete studio by ID
+   * DELETE /api/v1/studios/:id
+   * 
+   * @param id - Studio ID
+   * @returns Empty response on success
+   */
+  async delete(id: string): Promise<ApiResponse<void>> {
+    // TODO: Replace with actual endpoint when available
+    const response = await this.client.delete<ApiResponse<void>>(
+      `/api/v1/studios/${id}`
+    );
+    return response.data;
+  }
+
+  /**
+   * Get data quality issues for a studio
+   * GET /api/v1/studios/:id/data-quality
+   * 
+   * @param id - Studio ID
+   * @param params - Query parameters (resolved, severity)
+   * @returns List of data quality issues
+   */
+  async getDataQualityIssues(
+    id: string,
+    params?: {
+      resolved?: boolean;
+      severity?: 'low' | 'medium' | 'high';
+    }
+  ): Promise<ApiResponse<any[]>> {
+    // TODO: Replace with actual endpoint when available
+    const response = await this.client.get<ApiResponse<any[]>>(
+      `/api/v1/studios/${id}/data-quality`,
+      { params }
+    );
+    return response.data;
+  }
+}
+