@gymspace/sdk 1.2.12 → 1.2.14

package/dist/index.d.ts

@@ -432,11 +432,10 @@ interface CreateGymDto {
     postalCode?: string;
     phone?: string;
     email?: string;
-    openingTime?: string;
-    closingTime?: string;
     capacity?: number;
     amenities?: GymAmenities;
     settings?: GymSettings;
+    schedule?: GymSchedule;
 }
 interface UpdateGymDto {
     name?: string;
@@ -446,11 +445,10 @@ interface UpdateGymDto {
     postalCode?: string;
     phone?: string;
     email?: string;
-    openingTime?: string;
-    closingTime?: string;
     capacity?: number;
     amenities?: GymAmenities;
     settings?: GymSettings;
+    schedule?: GymSchedule;
 }
 interface GymAmenities {
     hasParking?: boolean;
@@ -459,10 +457,44 @@ interface GymAmenities {
     [key: string]: any;
 }
 interface GymSettings {
+    inventory?: InventorySettings;
+    contracts?: ContractSettings;
     logo?: string;
     primaryColor?: string;
     [key: string]: any;
 }
+/**
+ * Inventory configuration settings
+ */
+interface InventorySettings {
+    defaultMinStock?: number;
+    defaultMaxStock?: number;
+    enableLowStockAlerts?: boolean;
+}
+/**
+ * Contract expiration configuration settings
+ */
+interface ContractSettings {
+    expiringSoonDays?: number;
+    gracePeriodDays?: number;
+    enableExpirationNotifications?: boolean;
+}
+/**
+ * Update gym inventory settings DTO
+ */
+interface UpdateGymInventorySettingsDto {
+    defaultMinStock?: number;
+    defaultMaxStock?: number;
+    enableLowStockAlerts?: boolean;
+}
+/**
+ * Update gym contract settings DTO
+ */
+interface UpdateGymContractSettingsDto {
+    expiringSoonDays?: number;
+    gracePeriodDays?: number;
+    enableExpirationNotifications?: boolean;
+}
 interface Gym {
     id: string;
     organizationId: string;
@@ -474,8 +506,6 @@ interface Gym {
     postalCode?: string;
     phone?: string;
     email?: string;
-    openingTime?: string;
-    closingTime?: string;
     capacity?: number;
     amenities?: GymAmenities;
     settings?: GymSettings;
@@ -484,6 +514,11 @@ interface Gym {
     isActive: boolean;
     createdAt: string;
     updatedAt: string;
+    _count?: {
+        gymClients: number;
+        collaborators: number;
+        contracts: number;
+    };
 }
 interface TimeSlot {
     open: string;
@@ -556,6 +591,40 @@ declare class GymsResource extends BaseResource {
     }>, options?: RequestOptions): Promise<Gym>;
     updateGymSchedule(id: string, data: UpdateGymScheduleDto, options?: RequestOptions): Promise<Gym>;
     updateGymSocialMedia(id: string, data: UpdateGymSocialMediaDto, options?: RequestOptions): Promise<Gym>;
+    /**
+     * Update current gym inventory settings (stock configuration)
+     * Uses gym from context (x-gym-id header)
+     * @param data Inventory settings data
+     * @param options Request options
+     * @returns Updated gym with new settings
+     *
+     * @example
+     * ```typescript
+     * const gym = await sdk.gyms.updateInventorySettings({
+     *   defaultMinStock: 15,
+     *   defaultMaxStock: 1000,
+     *   enableLowStockAlerts: true
+     * });
+     * ```
+     */
+    updateInventorySettings(data: UpdateGymInventorySettingsDto, options?: RequestOptions): Promise<Gym>;
+    /**
+     * Update current gym contract expiration settings
+     * Uses gym from context (x-gym-id header)
+     * @param data Contract settings data
+     * @param options Request options
+     * @returns Updated gym with new settings
+     *
+     * @example
+     * ```typescript
+     * const gym = await sdk.gyms.updateContractSettings({
+     *   expiringSoonDays: 7,
+     *   gracePeriodDays: 0,
+     *   enableExpirationNotifications: true
+     * });
+     * ```
+     */
+    updateContractSettings(data: UpdateGymContractSettingsDto, options?: RequestOptions): Promise<Gym>;
 }
 
 declare class CollaboratorsResource extends BaseResource {
@@ -605,6 +674,9 @@ interface CreateClientDto {
     occupation?: string;
     notes?: string;
     profilePhotoId?: string;
+    emergencyContactName?: string;
+    emergencyContactPhone?: string;
+    medicalConditions?: string;
     customData?: Record<string, any>;
 }
 interface UpdateClientDto {
@@ -623,6 +695,9 @@ interface UpdateClientDto {
     occupation?: string;
     notes?: string;
     profilePhotoId?: string;
+    emergencyContactName?: string;
+    emergencyContactPhone?: string;
+    medicalConditions?: string;
     customData?: Record<string, any>;
 }
 interface Client {
@@ -710,7 +785,6 @@ interface ClientStats {
 }
 interface SearchClientsParams {
     search?: string;
-    activeOnly?: boolean;
     clientNumber?: string;
     documentId?: string;
     includeContractStatus?: boolean;
@@ -810,6 +884,21 @@ declare class MembershipPlansResource extends BaseResource {
     getMembershipPlanStats(id: string, options?: RequestOptions): Promise<MembershipPlanStats>;
 }
 
+declare enum CancellationReason {
+    PRICE_TOO_HIGH = "PRICE_TOO_HIGH",
+    NOT_USING_SERVICE = "NOT_USING_SERVICE",
+    MOVING_LOCATION = "MOVING_LOCATION",
+    FINANCIAL_ISSUES = "FINANCIAL_ISSUES",
+    SERVICE_DISSATISFACTION = "SERVICE_DISSATISFACTION",
+    TEMPORARY_BREAK = "TEMPORARY_BREAK",
+    OTHER = "OTHER"
+}
+declare enum SuspensionType {
+    VACATION = "vacation",
+    MEDICAL = "medical",
+    FINANCIAL = "financial",
+    OTHER = "other"
+}
 interface CreateContractDto {
     gymClientId: string;
     gymMembershipPlanId: string;
@@ -835,6 +924,32 @@ interface FreezeContractDto {
     freezeEndDate: string;
     reason?: string;
 }
+interface CancelContractDto {
+    reason: CancellationReason;
+    detailedFeedback?: string;
+    offeredAlternatives?: boolean;
+    wouldRecommend?: boolean;
+    satisfactionScore?: number;
+}
+interface SuspendContractDto {
+    suspensionType: SuspensionType;
+    startDate: string;
+    endDate?: string;
+    reason?: string;
+    maintainBenefits?: boolean;
+    autoReactivate?: boolean;
+}
+interface ResumeContractDto {
+    resumeDate?: string;
+    notes?: string;
+}
+interface ReactivateContractDto {
+    newPlanId?: string;
+    startDate: string;
+    applyWinBackOffer?: boolean;
+    paymentMethodId: string;
+    notes?: string;
+}
 interface Contract {
     id: string;
     gymId: string;
@@ -846,34 +961,70 @@ interface Contract {
     startDate: string;
     endDate: string;
     status: ContractStatus;
-    price: number;
-    discountPercentage?: number;
-    finalAmount: number;
-    freezeStartDate?: string;
-    freezeEndDate?: string;
+    basePrice: string;
+    customPrice?: string | null;
+    finalAmount: string;
+    currency: string;
+    discountPercentage?: number | null;
+    discountAmount?: string | null;
+    paymentFrequency: string;
+    notes?: string | null;
+    termsAndConditions?: string | null;
+    freezeStartDate?: string | null;
+    freezeEndDate?: string | null;
+    contractDocumentId?: string | null;
+    paymentReceiptIds?: string[] | null;
     receiptIds?: string[];
     metadata?: Record<string, any>;
+    createdByUserId?: string;
+    updatedByUserId?: string | null;
+    approvedByUserId?: string | null;
+    approvedAt?: string | null;
+    cancelledByUserId?: string | null;
+    cancelledAt?: string | null;
     createdAt: string;
     updatedAt: string;
+    deletedAt?: string | null;
     gymClient?: {
         id: string;
         name: string;
-        email: string;
+        email: string | null;
+        phone?: string;
+        gym?: {
+            id: string;
+            name: string;
+        };
     };
     gymMembershipPlan?: {
         id: string;
+        gymId: string;
         name: string;
-        basePrice?: number;
-        durationMonths?: number;
+        basePrice: string;
+        durationMonths?: number | null;
+        durationDays?: number | null;
+        description?: string;
+        features?: string[];
+        termsAndConditions?: string;
+        allowsCustomPricing?: boolean;
+        includesAdvisor?: boolean;
+        showInCatalog?: boolean;
+        assetsIds?: string[];
+        status?: string;
     };
     paymentMethod?: {
         id: string;
+        organizationId: string;
         name: string;
         description?: string;
         code: string;
         enabled: boolean;
+        metadata?: Record<string, any>;
     };
     renewals?: Contract[];
+    createdBy?: {
+        id: string;
+        email: string;
+    };
 }
 interface GetContractsParams extends PaginationQueryDto {
     status?: ContractStatus;
@@ -884,6 +1035,38 @@ interface GetContractsParams extends PaginationQueryDto {
     endDateFrom?: string;
     endDateTo?: string;
 }
+interface ContractLifecycleEvent {
+    id: string;
+    contractId: string;
+    eventType: string;
+    previousStatus?: string;
+    newStatus?: string;
+    reason?: string;
+    metadata?: Record<string, any>;
+    createdAt: string;
+    createdBy?: {
+        id: string;
+        name: string;
+        email: string;
+    };
+}
+interface CancellationAnalytics {
+    total: number;
+    reasonBreakdown: Record<string, number>;
+    averageSatisfaction: number | null;
+    recommendationRate: number;
+    feedbacks: Array<{
+        id: string;
+        contractId: string;
+        contractNumber: string;
+        clientName: string;
+        reason: string;
+        detailedFeedback?: string;
+        satisfactionScore?: number;
+        wouldRecommend?: boolean;
+        createdAt: string;
+    }>;
+}
 
 declare class ContractsResource extends BaseResource {
     private basePath;
@@ -893,9 +1076,15 @@ declare class ContractsResource extends BaseResource {
     getClientContracts(clientId: string, options?: RequestOptions): Promise<Contract[]>;
     renewContract(id: string, data: RenewContractDto, options?: RequestOptions): Promise<Contract>;
     freezeContract(id: string, data: FreezeContractDto, options?: RequestOptions): Promise<Contract>;
-    cancelContract(id: string, data: {
-        reason: string;
-    }, options?: RequestOptions): Promise<Contract>;
+    cancelContract(id: string, data: CancelContractDto, options?: RequestOptions): Promise<Contract>;
+    suspendContract(id: string, data: SuspendContractDto, options?: RequestOptions): Promise<Contract>;
+    resumeContract(id: string, data: ResumeContractDto, options?: RequestOptions): Promise<Contract>;
+    reactivateContract(id: string, data: ReactivateContractDto, options?: RequestOptions): Promise<Contract>;
+    getLifecycleHistory(id: string, options?: RequestOptions): Promise<ContractLifecycleEvent[]>;
+    getCancellationAnalytics(params?: {
+        startDate?: string;
+        endDate?: string;
+    }, options?: RequestOptions): Promise<CancellationAnalytics>;
     resendWhatsAppNotification(contractId: string, options?: RequestOptions): Promise<{
         success: boolean;
         message: string;
@@ -1104,10 +1293,42 @@ interface ClientCheckInHistory {
 
 declare class CheckInsResource extends BaseResource {
     private basePath;
+    /**
+     * Creates a new check-in for a client.
+     *
+     * **Permissions Required:**
+     * - Gym owners with full gym access
+     * - Active collaborators with CHECKINS_CREATE permission
+     *
+     * @param data - The check-in data including client ID and optional notes
+     * @param options - Optional request configuration
+     * @returns The created check-in record with client and user details
+     * @throws {ValidationError} When client is not found or already checked in
+     * @throws {AuthorizationError} When user lacks required permissions
+     */
     createCheckIn(data: CreateCheckInDto, options?: RequestOptions): Promise<CheckIn>;
     searchCheckIns(params?: SearchCheckInsParams, options?: RequestOptions): Promise<CheckInListResponse>;
     getCurrentlyInGym(options?: RequestOptions): Promise<CurrentlyInGymResponse>;
     getCheckIn(id: string, options?: RequestOptions): Promise<CheckIn>;
+    /**
+     * Deletes a check-in record.
+     *
+     * **Permissions Required:**
+     * - Gym owners with full gym access
+     * - Active collaborators with CHECKINS_CREATE permission
+     *
+     * **Business Rules:**
+     * - Only check-ins from today can be deleted
+     * - The same permission level required for creation is required for deletion
+     * - Cannot delete check-ins from previous days
+     *
+     * @param id - The ID of the check-in to delete
+     * @param options - Optional request configuration
+     * @returns Promise that resolves when the check-in is successfully deleted
+     * @throws {NotFoundError} When the check-in is not found
+     * @throws {AuthorizationError} When user lacks required permissions
+     * @throws {ValidationError} When trying to delete a check-in from a previous day
+     */
     deleteCheckIn(id: string, options?: RequestOptions): Promise<void>;
     getGymCheckInStats(params: GetCheckInStatsParams, options?: RequestOptions): Promise<CheckInStats>;
     getClientCheckInHistory(clientId: string, params?: GetClientCheckInHistoryParams, options?: RequestOptions): Promise<ClientCheckInHistory>;
@@ -1326,7 +1547,6 @@ interface StartOnboardingData {
     timezone: string;
 }
 interface StartOnboardingResponse {
-    success: boolean;
     access_token: string;
     refresh_token: string;
     user: {
@@ -1335,6 +1555,8 @@ interface StartOnboardingResponse {
         name: string;
         userType: string;
     };
+    lastActiveGymId: string;
+    lastActiveOrganizationId: string;
     organization: {
         id: string;
         name: string;
@@ -1561,6 +1783,14 @@ interface Product {
     createdAt: string;
     updatedAt: string;
     category?: ProductCategory;
+    image?: {
+        id: string;
+        filename: string;
+        originalName: string;
+        fileSize: number;
+        mimeType: string;
+        previewUrl?: string;
+    };
     createdBy?: {
         id: string;
         name: string;
@@ -1976,6 +2206,11 @@ interface UpdateSubscriptionPlanDto {
 }
 declare class SubscriptionPlansResource extends BaseResource {
     private basePath;
+    private publicBasePath;
+    /**
+     * List all active subscription plans (Public - no authentication required)
+     */
+    listPublicPlans(options?: RequestOptions): Promise<SubscriptionPlanDto[]>;
     /**
      * List all subscription plans (Super Admin only)
      */
@@ -2316,6 +2551,472 @@ declare class WhatsAppTemplatesResource extends BaseResource {
     preview(id: string, variables: Record<string, any>, options?: RequestOptions): Promise<PreviewTemplateResponse>;
 }
 
+interface BulkTemplate {
+    id: string;
+    gymId: string;
+    name: string;
+    message: string;
+    description?: string;
+    tags: string[];
+    isActive: boolean;
+    usageCount: number;
+    lastUsedAt?: Date;
+    createdByUserId: string;
+    createdAt: Date;
+    updatedAt: Date;
+}
+interface CreateBulkTemplateDto {
+    name: string;
+    message: string;
+    description?: string;
+    tags?: string[];
+    isActive?: boolean;
+}
+interface UpdateBulkTemplateDto {
+    name?: string;
+    message?: string;
+    description?: string;
+    tags?: string[];
+    isActive?: boolean;
+}
+interface BulkMessageVariable {
+    name: string;
+    placeholder: string;
+    description: string;
+    example: string;
+    category: 'client' | 'gym' | 'membership' | 'datetime' | 'custom';
+    required: boolean;
+    formatter?: 'text' | 'currency' | 'date' | 'number';
+}
+interface SendBulkMessagesDto {
+    templateId?: string;
+    message: string;
+    clientIds: string[];
+}
+interface RejectedClientDto {
+    clientId: string;
+    reason: string;
+}
+interface BulkMessageResultDto {
+    sendId: string;
+    totalRecipients: number;
+    accepted: number;
+    rejected: number;
+    rejectedReasons: RejectedClientDto[];
+    estimatedTime: number;
+}
+type RejectedClient = RejectedClientDto;
+type BulkMessageResult = BulkMessageResultDto;
+interface BulkMessageLogDto {
+    sendId: string;
+    clientId: string;
+    clientName: string;
+    phoneNumber: string;
+    message: string;
+    status: 'pending' | 'queued' | 'sent' | 'delivered' | 'failed';
+    sentAt?: string;
+    deliveredAt?: string;
+    failedAt?: string;
+    failureReason?: string;
+    retryCount: number;
+    timestamp: string;
+}
+interface GetBulkLogsQueryDto {
+    sendId: string;
+}
+interface BulkLogsResponseDto {
+    sendId: string;
+    totalRecipients: number;
+    sent: number;
+    delivered: number;
+    failed: number;
+    pending: number;
+    logs: BulkMessageLogDto[];
+    isComplete: boolean;
+}
+type BulkMessageLog = BulkMessageLogDto;
+type BulkLogsResponse = BulkLogsResponseDto;
+interface GenerateAIMessageDto {
+    prompt: string;
+    tone?: 'promotional' | 'informational' | 'reminder' | 'greeting' | 'custom' | 'friendly';
+    includeVariables?: string[];
+    additionalRequirements?: string;
+}
+interface GenerateAIMessageResponseDto {
+    message: string;
+    variables: string[];
+    tone: string;
+    suggestions?: string[];
+}
+type GenerateAIMessageParams = GenerateAIMessageDto;
+type GenerateAIMessageResponse = GenerateAIMessageResponseDto;
+
+declare class BulkMessagingResource extends BaseResource {
+    private basePath;
+    private templatesPath;
+    createTemplate(data: CreateBulkTemplateDto, options?: RequestOptions): Promise<BulkTemplate>;
+    getTemplates(options?: RequestOptions): Promise<BulkTemplate[]>;
+    getTemplate(id: string, options?: RequestOptions): Promise<BulkTemplate>;
+    updateTemplate(id: string, data: UpdateBulkTemplateDto, options?: RequestOptions): Promise<BulkTemplate>;
+    deleteTemplate(id: string, options?: RequestOptions): Promise<void>;
+    getAvailableVariables(options?: RequestOptions): Promise<BulkMessageVariable[]>;
+    /**
+     * Generate AI message with streaming support
+     * Note: This proxies to the agent endpoint for streaming responses
+     */
+    generateAIMessage(data: GenerateAIMessageDto, options?: RequestOptions): Promise<GenerateAIMessageResponseDto>;
+    /**
+     * Send bulk messages to multiple clients
+     * Note: SDK sends clientIds, API fetches full client and gym data before sending to agent
+     */
+    send(data: SendBulkMessagesDto, options?: RequestOptions): Promise<BulkMessageResultDto>;
+    /**
+     * Get logs for a bulk message send operation
+     */
+    getLogs(sendId: string, options?: RequestOptions): Promise<BulkLogsResponseDto>;
+}
+
+interface CreateActivityDto {
+    name: string;
+    description?: string;
+    imageId?: string;
+    startDateTime: string;
+    durationMinutes: number;
+    maxParticipants?: number;
+    recurrenceType?: 'daily' | 'weekly' | 'monthly';
+    recurrenceEndDate?: string;
+    planRestrictions?: string[];
+}
+interface UpdateActivityDto {
+    name?: string;
+    description?: string;
+    imageId?: string;
+    startDateTime?: string;
+    durationMinutes?: number;
+    maxParticipants?: number;
+    recurrenceType?: 'daily' | 'weekly' | 'monthly';
+    recurrenceEndDate?: string;
+    planRestrictions?: string[];
+    isActive?: boolean;
+}
+interface Activity {
+    id: string;
+    gymId: string;
+    name: string;
+    description?: string;
+    imageId?: string;
+    startDateTime: string;
+    durationMinutes: number;
+    maxParticipants?: number;
+    recurrenceType?: 'daily' | 'weekly' | 'monthly';
+    recurrenceEndDate?: string;
+    isActive: boolean;
+    planRestrictions: ActivityPlanRestriction[];
+    notifications?: ActivityNotification[];
+    createdByUserId: string;
+    updatedByUserId?: string;
+    createdAt: string;
+    updatedAt: string;
+    deletedAt?: string;
+}
+interface ActivityPlanRestriction {
+    id: string;
+    membershipPlanId: string;
+    membershipPlan: {
+        id: string;
+        name: string;
+    };
+}
+interface SearchActivitiesParams {
+    page?: number;
+    limit?: number;
+    search?: string;
+    startDate?: string;
+    endDate?: string;
+    recurrenceType?: 'daily' | 'weekly' | 'monthly';
+    planId?: string;
+    isActive?: boolean;
+}
+interface CreateActivityNotificationDto {
+    templateId?: string;
+    customMessage?: string;
+    advanceTimeMinutes: number;
+}
+interface UpdateActivityNotificationDto {
+    templateId?: string;
+    customMessage?: string;
+    advanceTimeMinutes?: number;
+    isActive?: boolean;
+}
+interface ActivityNotification {
+    id: string;
+    activityId: string;
+    templateId?: string;
+    customMessage?: string;
+    advanceTimeMinutes: number;
+    isActive: boolean;
+    template?: {
+        id: string;
+        name: string;
+        message: string;
+    };
+    sentNotifications?: SentActivityNotification[];
+    createdByUserId: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface SentActivityNotification {
+    id: string;
+    sendId: string;
+    recipientsCount: number;
+    sentAt: string;
+    status: string;
+}
+interface ActivityStats {
+    totalActivities: number;
+    activeActivities: number;
+    upcomingActivities: number;
+    totalNotificationsSent: number;
+    notificationsByActivity: {
+        activityId: string;
+        activityName: string;
+        notificationsSent: number;
+        lastSentAt: string;
+    }[];
+}
+interface ActivityStatsParams {
+    startDate?: string;
+    endDate?: string;
+}
+interface EligibleClient {
+    id: string;
+    name: string;
+    phone: string;
+    email: string;
+    planName: string;
+}
+interface EligibleClientsResponse {
+    total: number;
+    clients: EligibleClient[];
+}
+interface DeleteActivityParams {
+    deleteRecurrence?: boolean;
+}
+
+declare class ActivitiesResource extends BaseResource {
+    private basePath;
+    createActivity(data: CreateActivityDto, options?: RequestOptions): Promise<Activity>;
+    searchActivities(params?: SearchActivitiesParams, options?: RequestOptions): Promise<PaginatedResponseDto<Activity>>;
+    getActivity(id: string, options?: RequestOptions): Promise<Activity>;
+    updateActivity(id: string, data: UpdateActivityDto, options?: RequestOptions): Promise<Activity>;
+    deleteActivity(id: string, params?: DeleteActivityParams, options?: RequestOptions): Promise<void>;
+    createNotification(activityId: string, data: CreateActivityNotificationDto, options?: RequestOptions): Promise<ActivityNotification>;
+    getNotifications(activityId: string, options?: RequestOptions): Promise<{
+        data: ActivityNotification[];
+    }>;
+    updateNotification(activityId: string, notificationId: string, data: UpdateActivityNotificationDto, options?: RequestOptions): Promise<ActivityNotification>;
+    deleteNotification(activityId: string, notificationId: string, options?: RequestOptions): Promise<void>;
+    getStats(params?: ActivityStatsParams, options?: RequestOptions): Promise<ActivityStats>;
+    getEligibleClients(activityId: string, options?: RequestOptions): Promise<EligibleClientsResponse>;
+}
+
+interface CreateTagDto {
+    name: string;
+    color?: string;
+    description?: string;
+}
+interface UpdateTagDto {
+    name?: string;
+    color?: string;
+    description?: string;
+}
+interface AssignTagsDto {
+    tagIds: string[];
+}
+interface RemoveTagsDto {
+    tagIds: string[];
+}
+interface Tag {
+    id: string;
+    gymId: string;
+    name: string;
+    color?: string;
+    description?: string;
+    clientCount?: number;
+    createdAt: string;
+    updatedAt: string;
+    createdBy?: {
+        id: string;
+        name: string;
+    };
+}
+interface TagWithAssignment extends Tag {
+    assignedAt?: string;
+    assignedBy?: {
+        id: string;
+        name: string;
+    };
+}
+interface SearchTagsParams {
+    page?: number;
+    limit?: number;
+    search?: string;
+    includeCount?: boolean;
+    sortBy?: 'name' | 'createdAt' | 'clientCount';
+    sortOrder?: 'asc' | 'desc';
+}
+interface GetTagClientsParams {
+    page?: number;
+    limit?: number;
+    search?: string;
+    status?: 'active' | 'inactive';
+}
+interface AssignTagsResponse {
+    message: string;
+    assigned: number;
+    skipped: number;
+    client: {
+        id: string;
+        name: string;
+        tags: TagWithAssignment[];
+    };
+}
+interface RemoveTagsResponse {
+    message: string;
+    removed: number;
+    notFound: number;
+    client: {
+        id: string;
+        name: string;
+        tags: TagWithAssignment[];
+    };
+}
+interface DeleteTagResponse {
+    message: string;
+    deletedCount: number;
+    affectedClients: number;
+}
+interface ClientTagsResponse {
+    client: {
+        id: string;
+        name: string;
+        clientNumber: string;
+    };
+    tags: TagWithAssignment[];
+    total: number;
+}
+interface TagClientsResponse {
+    data: Array<{
+        id: string;
+        clientNumber: string;
+        name: string;
+        email?: string;
+        phone?: string;
+        status: string;
+        assignedAt: string;
+        assignedBy: {
+            id: string;
+            name: string;
+        };
+    }>;
+    meta: {
+        total: number;
+        page: number;
+        limit: number;
+        totalPages: number;
+    };
+    tag: {
+        id: string;
+        name: string;
+        color?: string;
+    };
+}
+interface TagStatsResponse {
+    totalTags: number;
+    totalAssignments: number;
+    averageTagsPerClient: number;
+    mostUsedTags: Array<{
+        id: string;
+        name: string;
+        color?: string;
+        clientCount: number;
+    }>;
+    leastUsedTags: Array<{
+        id: string;
+        name: string;
+        color?: string;
+        clientCount: number;
+    }>;
+    unusedTags: Array<{
+        id: string;
+        name: string;
+        color?: string;
+        clientCount: number;
+    }>;
+}
+
+declare class TagsResource extends BaseResource {
+    private basePath;
+    /**
+     * Create a new tag
+     * POST /api/v1/tags
+     */
+    createTag(data: CreateTagDto, options?: RequestOptions): Promise<Tag>;
+    /**
+     * List all tags with optional filters and pagination
+     * GET /api/v1/tags
+     */
+    searchTags(params?: SearchTagsParams, options?: RequestOptions): Promise<PaginatedResponseDto<Tag>>;
+    /**
+     * Get a specific tag by ID
+     * GET /api/v1/tags/:id
+     */
+    getTag(id: string, options?: RequestOptions): Promise<Tag>;
+    /**
+     * Update an existing tag
+     * PUT /api/v1/tags/:id
+     */
+    updateTag(id: string, data: UpdateTagDto, options?: RequestOptions): Promise<Tag>;
+    /**
+     * Delete a tag (soft delete)
+     * DELETE /api/v1/tags/:id
+     * @param id - Tag ID
+     * @param force - Force deletion even if tag has assigned clients
+     */
+    deleteTag(id: string, force?: boolean, options?: RequestOptions): Promise<DeleteTagResponse>;
+    /**
+     * Get clients with a specific tag
+     * GET /api/v1/tags/:id/clients
+     */
+    getTagClients(id: string, params?: GetTagClientsParams, options?: RequestOptions): Promise<TagClientsResponse>;
+    /**
+     * Get tag statistics
+     * GET /api/v1/tags/stats
+     */
+    getTagStats(options?: RequestOptions): Promise<TagStatsResponse>;
+    /**
+     * Assign one or multiple tags to a client
+     * POST /api/v1/clients/:clientId/tags
+     */
+    assignTagsToClient(clientId: string, data: AssignTagsDto, options?: RequestOptions): Promise<AssignTagsResponse>;
+    /**
+     * Remove a specific tag from a client
+     * DELETE /api/v1/clients/:clientId/tags/:tagId
+     */
+    removeTagFromClient(clientId: string, tagId: string, options?: RequestOptions): Promise<RemoveTagsResponse>;
+    /**
+     * Remove multiple tags from a client
+     * DELETE /api/v1/clients/:clientId/tags
+     * Note: This endpoint requires sending tagIds in the request body
+     */
+    removeTagsFromClient(clientId: string, tagIds: string[], options?: RequestOptions): Promise<RemoveTagsResponse>;
+    /**
+     * Get all tags assigned to a client
+     * GET /api/v1/clients/:clientId/tags
+     */
+    getClientTags(clientId: string, options?: RequestOptions): Promise<ClientTagsResponse>;
+}
+
 declare class GymSpaceSdk {
     client: ApiClient;
     private expoFetch?;
@@ -2345,6 +3046,9 @@ declare class GymSpaceSdk {
     paymentMethods: PaymentMethodsResource;
     whatsapp: WhatsAppResource;
     whatsappTemplates: WhatsAppTemplatesResource;
+    bulkMessaging: BulkMessagingResource;
+    activities: ActivitiesResource;
+    tags: TagsResource;
     constructor(config: GymSpaceConfig);
     /**
      * Set the authentication token
@@ -2414,4 +3118,4 @@ declare class NetworkError extends GymSpaceError {
     constructor(message?: string);
 }
 
-export { type ActivateRenewalDto, AdminSubscriptionManagementResource, type AdminSubscriptionStatusDto, type AffiliateOrganizationDto, type Amenities, ApiClient, type ApiResponse, type AssetResponseDto, AssetsResource, AuthResource, AuthenticationError, AuthorizationError, type AvailablePlanDto, type BusinessHours, type CancelSubscriptionDto, type CatalogGym, type ChangePasswordDto, type ChangePasswordResponseDto, type CheckIn, type CheckInDetail, type CheckInListResponse, type CheckInStats, type CheckInSystemFeatures, type CheckIns, type CheckInsList, CheckInsResource, type CheckLimitResponse, type CityWithGyms, type Client, type ClientCheckInHistory, type ClientManagementFeatures, type ClientStat, type ClientStats, ClientsResource, type CollaboratorRoleDto, CollaboratorsResource, type CompleteGuidedSetupData, type ConfigureFeaturesData, type ConnectionStatusResponse, type Contact, type Contract, ContractsResource, type ContractsRevenue, type CreateCheckInDto, type CreateClientDto, type CreateContractDto, type CreateGymDto, type CreateMembershipPlanDto, type CreatePaymentMethodDto, type CreateProductCategoryDto, type CreateProductDto, type CreateSaleDto, type CreateServiceDto, type CreateSubscriptionPlanDto, type CreateSupplierDto, type CreateTemplateDto, type CreateWhatsAppConfigDto, type CurrentSessionResponse, type CurrentlyInGymResponse, type CustomerSalesReport, DashboardResource, type DashboardStats, type DateRangeParams, type DaySchedule, type Debts, type DisconnectResponse, type ExpiringContract, type FileResponseDto, FilesResource, type FreezeContractDto, type GetCheckInStatsParams, type GetClientCheckInHistoryParams, type GetContractsParams, type GetFeaturedGymsParams, type GetGymInvitationsParams, type GetMembershipPlansParams, type Gym, type GymAmenities, type GymSchedule, type GymSettings, type GymSocialMedia, type GymSpaceConfig, GymSpaceError, GymSpaceSdk, type GymStats, GymsResource, HealthResource, type HealthResponse, type InitializeConnectionResponse, type InvitationValidationResponse, InvitationsResource, type ListContactsResponse, type LoginDto, type LoginResponseDto, type MembershipManagementFeatures, type MembershipPlan, type MembershipPlanStats, MembershipPlansResource, NetworkError, type NewClients, NotFoundError, type NotificationSettings, OnboardingResource, type OnboardingResponse, type OnboardingStatus, OnboardingStep, type Organization, type OrganizationAdminDetails, type OrganizationStats, type OrganizationWithDetails, OrganizationsResource, type PaginatedResponse, type PaginatedResponseDto, type PaginationParams, type PaginationQueryDto, type PaySaleDto, type PaymentMethod, type PaymentMethodStats, PaymentMethodsResource, type PermissionsGroup, type PreviewTemplateResponse, type PriceDto, type PricingDto, type Product, type ProductCategory, ProductsResource, PublicCatalogResource, type ReadyResponse, type RegisterCollaboratorDto, type RegisterOwnerDto, type RenewContractDto, type RequestOptions, type RequestPasswordResetDto, type RequestPasswordResetResponseDto, type ResendResetCodeDto, type ResendResetCodeResponseDto, type ResendVerificationDto, type ResetPasswordDto, type ResetPasswordResponseDto, RolesResource, type Sale, type SaleItem, type SaleItemDto, SalesResource, type SalesRevenue, type SalesStats, type SearchCatalogParams, type SearchCheckInsParams, type SearchClientsParams, type SearchPaymentMethodsParams, type SearchProductsParams, type SearchSalesParams, type SearchSuppliersParams, type SearchTemplatesDto, type SearchWhatsAppMessagesDto, type SendWhatsAppMessageDto, type SocialMedia, type StartOnboardingData, type StartOnboardingResponse, type StockMovement, type Subscription, type SubscriptionHistoryDto, type SubscriptionPlan, type SubscriptionPlanDto, SubscriptionPlansResource, type SubscriptionStatusDto, SubscriptionsResource, type Supplier, SuppliersResource, type SuppliersStats, type TimeSlot, type TopSellingProduct, type UpdateClientDto, type UpdateGymDto, type UpdateGymScheduleDto, type UpdateGymSettingsData, type UpdateGymSocialMediaDto, type UpdateMembershipPlanDto, type UpdateOrganizationDto, type UpdatePaymentMethodDto, type UpdatePaymentStatusDto, type UpdateProductCategoryDto, type UpdateProductDto, type UpdateProfileDto, type UpdateSaleDto, type UpdateStockDto, type UpdateSubscriptionPlanDto, type UpdateSupplierDto, type UpdateTemplateDto, type UpdateWhatsAppConfigDto, type UpgradeSubscriptionDto, type UploadAssetDto, type UploadFileDto, type UserProfileDto, UsersResource, ValidationError, type VerifyEmailDto, type VerifyResetCodeDto, type VerifyResetCodeResponseDto, type WeeklySchedule, type WhatsAppConfig, type WhatsAppMessage, WhatsAppResource, type WhatsAppTemplate, WhatsAppTemplatesResource };
+export { type ActivateRenewalDto, ActivitiesResource, type Activity, type ActivityNotification, type ActivityPlanRestriction, type ActivityStats, type ActivityStatsParams, AdminSubscriptionManagementResource, type AdminSubscriptionStatusDto, type AffiliateOrganizationDto, type Amenities, ApiClient, type ApiResponse, type AssetResponseDto, AssetsResource, type AssignTagsDto, type AssignTagsResponse, AuthResource, AuthenticationError, AuthorizationError, type AvailablePlanDto, type BulkLogsResponse, type BulkLogsResponseDto, type BulkMessageLog, type BulkMessageLogDto, type BulkMessageResult, type BulkMessageResultDto, type BulkMessageVariable, BulkMessagingResource, type BulkTemplate, type BusinessHours, type CancelContractDto, type CancelSubscriptionDto, type CancellationAnalytics, CancellationReason, type CatalogGym, type ChangePasswordDto, type ChangePasswordResponseDto, type CheckIn, type CheckInDetail, type CheckInListResponse, type CheckInStats, type CheckInSystemFeatures, type CheckIns, type CheckInsList, CheckInsResource, type CheckLimitResponse, type CityWithGyms, type Client, type ClientCheckInHistory, type ClientManagementFeatures, type ClientStat, type ClientStats, type ClientTagsResponse, ClientsResource, type CollaboratorRoleDto, CollaboratorsResource, type CompleteGuidedSetupData, type ConfigureFeaturesData, type ConnectionStatusResponse, type Contact, type Contract, type ContractLifecycleEvent, type ContractSettings, ContractsResource, type ContractsRevenue, type CreateActivityDto, type CreateActivityNotificationDto, type CreateBulkTemplateDto, type CreateCheckInDto, type CreateClientDto, type CreateContractDto, type CreateGymDto, type CreateMembershipPlanDto, type CreatePaymentMethodDto, type CreateProductCategoryDto, type CreateProductDto, type CreateSaleDto, type CreateServiceDto, type CreateSubscriptionPlanDto, type CreateSupplierDto, type CreateTagDto, type CreateTemplateDto, type CreateWhatsAppConfigDto, type CurrentSessionResponse, type CurrentlyInGymResponse, type CustomerSalesReport, DashboardResource, type DashboardStats, type DateRangeParams, type DaySchedule, type Debts, type DeleteActivityParams, type DeleteTagResponse, type DisconnectResponse, type EligibleClient, type EligibleClientsResponse, type ExpiringContract, type FileResponseDto, FilesResource, type FreezeContractDto, type GenerateAIMessageDto, type GenerateAIMessageParams, type GenerateAIMessageResponse, type GenerateAIMessageResponseDto, type GetBulkLogsQueryDto, type GetCheckInStatsParams, type GetClientCheckInHistoryParams, type GetContractsParams, type GetFeaturedGymsParams, type GetGymInvitationsParams, type GetMembershipPlansParams, type GetTagClientsParams, type Gym, type GymAmenities, type GymSchedule, type GymSettings, type GymSocialMedia, type GymSpaceConfig, GymSpaceError, GymSpaceSdk, type GymStats, GymsResource, HealthResource, type HealthResponse, type InitializeConnectionResponse, type InventorySettings, type InvitationValidationResponse, InvitationsResource, type ListContactsResponse, type LoginDto, type LoginResponseDto, type MembershipManagementFeatures, type MembershipPlan, type MembershipPlanStats, MembershipPlansResource, NetworkError, type NewClients, NotFoundError, type NotificationSettings, OnboardingResource, type OnboardingResponse, type OnboardingStatus, OnboardingStep, type Organization, type OrganizationAdminDetails, type OrganizationStats, type OrganizationWithDetails, OrganizationsResource, type PaginatedResponse, type PaginatedResponseDto, type PaginationParams, type PaginationQueryDto, type PaySaleDto, type PaymentMethod, type PaymentMethodStats, PaymentMethodsResource, type PermissionsGroup, type PreviewTemplateResponse, type PriceDto, type PricingDto, type Product, type ProductCategory, ProductsResource, PublicCatalogResource, type ReactivateContractDto, type ReadyResponse, type RegisterCollaboratorDto, type RegisterOwnerDto, type RejectedClient, type RejectedClientDto, type RemoveTagsDto, type RemoveTagsResponse, type RenewContractDto, type RequestOptions, type RequestPasswordResetDto, type RequestPasswordResetResponseDto, type ResendResetCodeDto, type ResendResetCodeResponseDto, type ResendVerificationDto, type ResetPasswordDto, type ResetPasswordResponseDto, type ResumeContractDto, RolesResource, type Sale, type SaleItem, type SaleItemDto, SalesResource, type SalesRevenue, type SalesStats, type SearchActivitiesParams, type SearchCatalogParams, type SearchCheckInsParams, type SearchClientsParams, type SearchPaymentMethodsParams, type SearchProductsParams, type SearchSalesParams, type SearchSuppliersParams, type SearchTagsParams, type SearchTemplatesDto, type SearchWhatsAppMessagesDto, type SendBulkMessagesDto, type SendWhatsAppMessageDto, type SentActivityNotification, type SocialMedia, type StartOnboardingData, type StartOnboardingResponse, type StockMovement, type Subscription, type SubscriptionHistoryDto, type SubscriptionPlan, type SubscriptionPlanDto, SubscriptionPlansResource, type SubscriptionStatusDto, SubscriptionsResource, type Supplier, SuppliersResource, type SuppliersStats, type SuspendContractDto, SuspensionType, type Tag, type TagClientsResponse, type TagStatsResponse, type TagWithAssignment, TagsResource, type TimeSlot, type TopSellingProduct, type UpdateActivityDto, type UpdateActivityNotificationDto, type UpdateBulkTemplateDto, type UpdateClientDto, type UpdateGymContractSettingsDto, type UpdateGymDto, type UpdateGymInventorySettingsDto, type UpdateGymScheduleDto, type UpdateGymSettingsData, type UpdateGymSocialMediaDto, type UpdateMembershipPlanDto, type UpdateOrganizationDto, type UpdatePaymentMethodDto, type UpdatePaymentStatusDto, type UpdateProductCategoryDto, type UpdateProductDto, type UpdateProfileDto, type UpdateSaleDto, type UpdateStockDto, type UpdateSubscriptionPlanDto, type UpdateSupplierDto, type UpdateTagDto, type UpdateTemplateDto, type UpdateWhatsAppConfigDto, type UpgradeSubscriptionDto, type UploadAssetDto, type UploadFileDto, type UserProfileDto, UsersResource, ValidationError, type VerifyEmailDto, type VerifyResetCodeDto, type VerifyResetCodeResponseDto, type WeeklySchedule, type WhatsAppConfig, type WhatsAppMessage, WhatsAppResource, type WhatsAppTemplate, WhatsAppTemplatesResource };