@slotchain/sdk 1.0.0

package/src/clients/booking-client.ts

@@ -0,0 +1,98 @@
+import { AxiosInstance } from 'axios';
+import { ApiResponse, Booking } from '../types/api';
+
+export class BookingClient {
+  constructor(private client: AxiosInstance) {}
+
+  /**
+   * Get booking by ID
+   * GET /api/v1/bookings/:id
+   */
+  async getById(id: string): Promise<ApiResponse<Booking>> {
+    const response = await this.client.get<ApiResponse<Booking>>(
+      `/api/v1/bookings/${id}`
+    );
+    return response.data;
+  }
+
+  /**
+   * List bookings
+   * GET /api/v1/bookings
+   */
+  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[]>>(
+      '/api/v1/bookings',
+      { params }
+    );
+    return response.data;
+  }
+
+  /**
+   * Create a new booking (publishes booking.created event)
+   * POST /api/v1/bookings
+   */
+  async create(data: {
+    slot_id: string;
+    customer_info: {
+      name: string;
+      email: string;
+      phone?: string;
+      address?: string;
+      city?: string;
+      state?: string;
+      zipCode?: string;
+      isGuestCheckout?: boolean;
+    };
+    booking_data?: Record<string, unknown>;
+  }): Promise<ApiResponse<Booking>> {
+    const response = await this.client.post<ApiResponse<Booking>>(
+      '/api/v1/bookings',
+      data
+    );
+    return response.data;
+  }
+
+  /**
+   * Update booking by ID
+   * PUT /api/v1/bookings/:id
+   */
+  async update(id: string, data: {
+    status?: string;
+    customer_info?: Record<string, unknown>;
+    booking_data?: Record<string, unknown>;
+  }): Promise<ApiResponse<Booking>> {
+    const response = await this.client.put<ApiResponse<Booking>>(
+      `/api/v1/bookings/${id}`,
+      data
+    );
+    return response.data;
+  }
+
+  /**
+   * Cancel booking by ID
+   * Note: Cancel is typically done via update with status change
+   * If dedicated cancel endpoint exists, update this method
+   */
+  async cancel(id: string): Promise<ApiResponse<Booking>> {
+    // Use update to change status to cancelled
+    return this.update(id, { status: 'cancelled' });
+  }
+
+  /**
+   * Delete booking by ID (soft delete)
+   * DELETE /api/v1/bookings/:id
+   */
+  async delete(id: string): Promise<ApiResponse<void>> {
+    const response = await this.client.delete<ApiResponse<void>>(
+      `/api/v1/bookings/${id}`
+    );
+    return response.data;
+  }
+}
+

package/src/clients/customer-client.ts

@@ -0,0 +1,165 @@
+import { AxiosInstance } from 'axios';
+import { ApiResponse, Customer, Booking } from '../types/api';
+
+export class CustomerClient {
+  constructor(private client: AxiosInstance) {}
+
+  /**
+   * Get customer by ID
+   * GET /api/v1/customers/:id
+   * 
+   * @param id - Customer ID
+   * @returns Customer details
+   */
+  async getById(id: string): Promise<ApiResponse<Customer>> {
+    const response = await this.client.get<ApiResponse<Customer>>(
+      `/api/v1/customers/${id}`
+    );
+    return response.data;
+  }
+
+  /**
+   * Get customer by email
+   * GET /api/v1/customers?email=:email&tenant_id=:id
+   * 
+   * @param email - Customer email
+   * @param tenantId - Required tenant ID for scoping
+   * @returns Customer details
+   */
+  async getByEmail(email: string, tenantId: string): Promise<ApiResponse<Customer>> {
+    const response = await this.client.get<ApiResponse<Customer>>(
+      '/api/v1/customers',
+      { params: { email, tenant_id: tenantId } }
+    );
+    return response.data;
+  }
+
+  /**
+   * List customers with optional filters
+   * GET /api/v1/customers
+   * 
+   * @param params - Query parameters (tenant_id required, page, limit, search, is_guest)
+   * @returns Paginated list of customers
+   */
+  async list(params: {
+    tenant_id: string;
+    page?: number;
+    limit?: number;
+    search?: string;
+    is_guest?: boolean;
+  }): Promise<ApiResponse<Customer[]>> {
+    const response = await this.client.get<ApiResponse<Customer[]>>(
+      '/api/v1/customers',
+      { params }
+    );
+    return response.data;
+  }
+
+  /**
+   * Create a new customer
+   * POST /api/v1/customers
+   * 
+   * @param data - Customer creation data (tenant_id, name, email required)
+   * @returns Created customer
+   */
+  async create(data: Partial<Customer>): Promise<ApiResponse<Customer>> {
+    const response = await this.client.post<ApiResponse<Customer>>(
+      '/api/v1/customers',
+      data
+    );
+    return response.data;
+  }
+
+  /**
+   * Update customer by ID
+   * PUT /api/v1/customers/:id
+   * 
+   * @param id - Customer ID
+   * @param data - Customer update data
+   * @returns Updated customer
+   */
+  async update(id: string, data: Partial<Customer>): Promise<ApiResponse<Customer>> {
+    const response = await this.client.put<ApiResponse<Customer>>(
+      `/api/v1/customers/${id}`,
+      data
+    );
+    return response.data;
+  }
+
+  /**
+   * Delete customer by ID
+   * DELETE /api/v1/customers/:id
+   * 
+   * @param id - Customer ID
+   * @returns Empty response on success
+   */
+  async delete(id: string): Promise<ApiResponse<void>> {
+    const response = await this.client.delete<ApiResponse<void>>(
+      `/api/v1/customers/${id}`
+    );
+    return response.data;
+  }
+
+  /**
+   * Lookup customer by userId or tenantId
+   * GET /api/v1/customers/lookup
+   * 
+   * @param params - Query parameters (userId optional, tenantId required)
+   * @returns Customer or null
+   */
+  async lookup(params: {
+    userId?: string;
+    tenantId: string;
+  }): Promise<ApiResponse<Customer | null>> {
+    const response = await this.client.get<ApiResponse<Customer | null>>(
+      '/api/v1/customers/lookup',
+      { params: { userId: params.userId, tenantId: params.tenantId } }
+    );
+    return response.data;
+  }
+
+  /**
+   * Get autocomplete data from existing customers and bookings
+   * GET /api/v1/customers/autocomplete
+   * 
+   * @param tenantId - Tenant ID (required)
+   * @returns Autocomplete data
+   */
+  async autocomplete(tenantId: string): Promise<ApiResponse<any>> {
+    const response = await this.client.get<ApiResponse<any>>(
+      '/api/v1/customers/autocomplete',
+      { params: { tenantId } }
+    );
+    return response.data;
+  }
+
+  /**
+   * Get all bookings for a customer
+   * GET /api/v1/customers/bookings
+   * 
+   * @param params - Query parameters (email optional, userId optional, tenantId required)
+   * @returns Customer bookings data
+   */
+  async getBookings(params: {
+    email?: string;
+    userId?: string;
+    tenantId: string;
+  }): Promise<ApiResponse<{
+    customer: Customer | null;
+    bookings: Booking[];
+    groupedBySlot: Record<string, Booking[]>;
+    total: number;
+  }>> {
+    const response = await this.client.get<ApiResponse<{
+      customer: Customer | null;
+      bookings: Booking[];
+      groupedBySlot: Record<string, Booking[]>;
+      total: number;
+    }>>(
+      '/api/v1/customers/bookings',
+      { params }
+    );
+    return response.data;
+  }
+}
+

package/src/clients/data-quality-client.ts

@@ -0,0 +1,93 @@
+import { AxiosInstance } from 'axios';
+import { ApiResponse, DataQualityIssue } from '../types/api';
+
+export class DataQualityClient {
+  constructor(private client: AxiosInstance) {}
+
+  /**
+   * Get data quality issue by ID
+   * GET /api/v1/data-quality/:id
+   * 
+   * @param id - Issue ID
+   * @returns Data quality issue details
+   */
+  async getById(id: string): Promise<ApiResponse<DataQualityIssue>> {
+    // TODO: Replace with actual endpoint when available
+    const response = await this.client.get<ApiResponse<DataQualityIssue>>(
+      `/api/v1/data-quality/${id}`
+    );
+    return response.data;
+  }
+
+  /**
+   * List data quality issues with optional filters
+   * GET /api/v1/data-quality
+   * 
+   * @param params - Query parameters (tenantId, type, severity, resolved, page, limit)
+   * @returns Paginated list of data quality issues
+   */
+  async list(params?: {
+    tenantId?: string;
+    type?: string;
+    severity?: 'low' | 'medium' | 'high';
+    resolved?: boolean;
+    page?: number;
+    limit?: number;
+  }): Promise<ApiResponse<DataQualityIssue[]>> {
+    // TODO: Replace with actual endpoint when available
+    const response = await this.client.get<ApiResponse<DataQualityIssue[]>>(
+      '/api/v1/data-quality',
+      { params }
+    );
+    return response.data;
+  }
+
+  /**
+   * Run data quality check for a tenant
+   * POST /api/v1/data-quality/check
+   * 
+   * @param tenantId - Tenant ID to check
+   * @returns List of detected issues
+   */
+  async runCheck(tenantId: string): Promise<ApiResponse<DataQualityIssue[]>> {
+    // TODO: Replace with actual endpoint when available
+    const response = await this.client.post<ApiResponse<DataQualityIssue[]>>(
+      '/api/v1/data-quality/check',
+      { tenantId }
+    );
+    return response.data;
+  }
+
+  /**
+   * Resolve a data quality issue
+   * PATCH /api/v1/data-quality/:id/resolve
+   * 
+   * @param id - Issue ID
+   * @returns Resolved issue
+   */
+  async resolve(id: string): Promise<ApiResponse<DataQualityIssue>> {
+    // TODO: Replace with actual endpoint when available
+    const response = await this.client.patch<ApiResponse<DataQualityIssue>>(
+      `/api/v1/data-quality/${id}/resolve`,
+      { resolved: true }
+    );
+    return response.data;
+  }
+
+  /**
+   * Get data quality summary for a tenant
+   * GET /api/v1/data-quality/summary?tenantId=:id
+   * 
+   * @param tenantId - Tenant ID
+   * @returns Summary of data quality issues
+   */
+  async getSummary(tenantId: string): Promise<ApiResponse<any>> {
+    // TODO: Replace with actual endpoint when available
+    const response = await this.client.get<ApiResponse<any>>(
+      '/api/v1/data-quality/summary',
+      { params: { tenantId } }
+    );
+    return response.data;
+  }
+}
+

package/src/clients/flow-client.ts

@@ -0,0 +1,107 @@
+import { AxiosInstance } from 'axios';
+import { ApiResponse, Flow } from '../types/api';
+
+export class FlowClient {
+  constructor(private client: AxiosInstance) {}
+
+  /**
+   * Get flow by ID
+   * GET /api/v1/flows/:id
+   * 
+   * @param id - Flow ID
+   * @returns Flow details
+   */
+  async getById(id: string): Promise<ApiResponse<Flow>> {
+    // TODO: Replace with actual endpoint when available
+    const response = await this.client.get<ApiResponse<Flow>>(
+      `/api/v1/flows/${id}`
+    );
+    return response.data;
+  }
+
+  /**
+   * List flows with optional filters
+   * GET /api/v1/flows
+   * 
+   * @param params - Query parameters (tenantId, page, limit)
+   * @returns Paginated list of flows
+   */
+  async list(params?: {
+    tenantId?: string;
+    page?: number;
+    limit?: number;
+  }): Promise<ApiResponse<Flow[]>> {
+    // TODO: Replace with actual endpoint when available
+    const response = await this.client.get<ApiResponse<Flow[]>>(
+      '/api/v1/flows',
+      { params }
+    );
+    return response.data;
+  }
+
+  /**
+   * Create a new flow
+   * POST /api/v1/flows
+   * 
+   * @param data - Flow creation data
+   * @returns Created flow
+   */
+  async create(data: Partial<Flow>): Promise<ApiResponse<Flow>> {
+    // TODO: Replace with actual endpoint when available
+    const response = await this.client.post<ApiResponse<Flow>>(
+      '/api/v1/flows',
+      data
+    );
+    return response.data;
+  }
+
+  /**
+   * Update flow by ID
+   * PATCH /api/v1/flows/:id
+   * 
+   * @param id - Flow ID
+   * @param data - Flow update data
+   * @returns Updated flow
+   */
+  async update(id: string, data: Partial<Flow>): Promise<ApiResponse<Flow>> {
+    // TODO: Replace with actual endpoint when available
+    const response = await this.client.patch<ApiResponse<Flow>>(
+      `/api/v1/flows/${id}`,
+      data
+    );
+    return response.data;
+  }
+
+  /**
+   * Delete flow by ID
+   * DELETE /api/v1/flows/:id
+   * 
+   * @param id - Flow 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/flows/${id}`
+    );
+    return response.data;
+  }
+
+  /**
+   * Execute a flow
+   * POST /api/v1/flows/:id/execute
+   * 
+   * @param id - Flow ID
+   * @param input - Optional input data for flow execution
+   * @returns Flow execution result
+   */
+  async execute(id: string, input?: Record<string, any>): Promise<ApiResponse<any>> {
+    // TODO: Replace with actual endpoint when available
+    const response = await this.client.post<ApiResponse<any>>(
+      `/api/v1/flows/${id}/execute`,
+      { input }
+    );
+    return response.data;
+  }
+}
+

package/src/clients/notification-client.ts

@@ -0,0 +1,108 @@
+import { AxiosInstance } from 'axios';
+import { ApiResponse, Notification } from '../types/api';
+
+export class NotificationClient {
+  constructor(private client: AxiosInstance) {}
+
+  /**
+   * Get notification by ID
+   * GET /api/v1/notifications/:id
+   * 
+   * @param id - Notification ID
+   * @returns Notification details
+   */
+  async getById(id: string): Promise<ApiResponse<Notification>> {
+    // TODO: Replace with actual endpoint when available
+    const response = await this.client.get<ApiResponse<Notification>>(
+      `/api/v1/notifications/${id}`
+    );
+    return response.data;
+  }
+
+  /**
+   * List notifications with optional filters
+   * GET /api/v1/notifications
+   * 
+   * @param params - Query parameters (tenantId, type, recipient, page, limit)
+   * @returns Paginated list of notifications
+   */
+  async list(params?: {
+    tenantId?: string;
+    type?: string;
+    recipient?: string;
+    page?: number;
+    limit?: number;
+  }): Promise<ApiResponse<Notification[]>> {
+    // TODO: Replace with actual endpoint when available
+    const response = await this.client.get<ApiResponse<Notification[]>>(
+      '/api/v1/notifications',
+      { params }
+    );
+    return response.data;
+  }
+
+  /**
+   * Create a new notification
+   * POST /api/v1/notifications
+   * 
+   * @param data - Notification creation data
+   * @returns Created notification
+   */
+  async create(data: Partial<Notification>): Promise<ApiResponse<Notification>> {
+    // TODO: Replace with actual endpoint when available
+    const response = await this.client.post<ApiResponse<Notification>>(
+      '/api/v1/notifications',
+      data
+    );
+    return response.data;
+  }
+
+  /**
+   * Send notification immediately
+   * POST /api/v1/notifications/send
+   * 
+   * @param data - Notification data to send
+   * @returns Sent notification
+   */
+  async send(data: Partial<Notification>): Promise<ApiResponse<Notification>> {
+    // TODO: Replace with actual endpoint when available
+    const response = await this.client.post<ApiResponse<Notification>>(
+      '/api/v1/notifications/send',
+      data
+    );
+    return response.data;
+  }
+
+  /**
+   * Update notification by ID
+   * PATCH /api/v1/notifications/:id
+   * 
+   * @param id - Notification ID
+   * @param data - Notification update data
+   * @returns Updated notification
+   */
+  async update(id: string, data: Partial<Notification>): Promise<ApiResponse<Notification>> {
+    // TODO: Replace with actual endpoint when available
+    const response = await this.client.patch<ApiResponse<Notification>>(
+      `/api/v1/notifications/${id}`,
+      data
+    );
+    return response.data;
+  }
+
+  /**
+   * Delete notification by ID
+   * DELETE /api/v1/notifications/:id
+   * 
+   * @param id - Notification 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/notifications/${id}`
+    );
+    return response.data;
+  }
+}
+

package/src/clients/register-client.ts

@@ -0,0 +1,19 @@
+/**
+ * @deprecated RegisterClient has been moved to @slotly/studio-sdk
+ * 
+ * RegisterClient (studio-specific booking register operations) is now available
+ * in the separate @slotly/studio-sdk package. This ensures clear separation:
+ * studio-level register operations live in their own SDK, while tenant &
+ * platform scopes remain in the core @slotly/sdk.
+ * 
+ * To use register operations, install and import from @slotly/studio-sdk:
+ * ```ts
+ * import { useStudioSlotly } from '@slotly/studio-sdk';
+ * const studio = useStudioSlotly({ getClientKey, getUserToken });
+ * await studio.register.getRegisters(...);
+ * ```
+ */
+
+// This file is kept for backwards compatibility but should not be imported.
+// RegisterClient functionality has been moved to @slotly/studio-sdk
+