@gymspace/sdk 1.2.13 → 1.2.14

package/src/resources/check-ins.ts

@@ -1,27 +1,40 @@
 import { BaseResource } from './base';
-import { 
-  CheckIn, 
-  CreateCheckInDto, 
+import {
+  CheckIn,
+  CreateCheckInDto,
   SearchCheckInsParams,
   GetCheckInStatsParams,
   CheckInStats,
   GetClientCheckInHistoryParams,
   CurrentlyInGymResponse,
   CheckInListResponse,
-  ClientCheckInHistory
+  ClientCheckInHistory,
 } from '../models/check-ins';
 import { RequestOptions, PaginatedResponseDto } from '../types';
 
 export class CheckInsResource extends BaseResource {
   private basePath = 'check-ins';
 
+  /**
+   * 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
+   */
   async createCheckIn(data: CreateCheckInDto, options?: RequestOptions): Promise<CheckIn> {
     return this.client.post<CheckIn>(this.basePath, data, options);
   }
 
   async searchCheckIns(
     params?: SearchCheckInsParams,
-    options?: RequestOptions
+    options?: RequestOptions,
   ): Promise<CheckInListResponse> {
     return this.client.get<CheckInListResponse>(this.basePath, params, options);
   }
@@ -34,30 +47,49 @@ export class CheckInsResource extends BaseResource {
     return this.client.get<CheckIn>(`${this.basePath}/${id}`, undefined, options);
   }
 
+  /**
+   * 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
+   */
   async deleteCheckIn(id: string, options?: RequestOptions): Promise<void> {
     return this.client.delete<void>(`${this.basePath}/${id}`, options);
   }
 
   async getGymCheckInStats(
     params: GetCheckInStatsParams,
-    options?: RequestOptions
+    options?: RequestOptions,
   ): Promise<CheckInStats> {
     return this.client.get<CheckInStats>(
       `${this.basePath}/stats/${params.period}`,
       undefined,
-      options
+      options,
     );
   }
 
   async getClientCheckInHistory(
     clientId: string,
     params?: GetClientCheckInHistoryParams,
-    options?: RequestOptions
+    options?: RequestOptions,
   ): Promise<ClientCheckInHistory> {
     return this.client.get<ClientCheckInHistory>(
       `${this.basePath}/client/${clientId}/history`,
       params,
-      options
+      options,
     );
   }
-}
+}

package/src/resources/contracts.ts

@@ -4,7 +4,13 @@ import {
   CreateContractDto,
   RenewContractDto,
   FreezeContractDto,
+  CancelContractDto,
+  SuspendContractDto,
+  ResumeContractDto,
+  ReactivateContractDto,
   GetContractsParams,
+  ContractLifecycleEvent,
+  CancellationAnalytics,
 } from '../models/contracts';
 import { RequestOptions, PaginatedResponseDto } from '../types';
 
@@ -48,12 +54,58 @@ export class ContractsResource extends BaseResource {
 
   async cancelContract(
     id: string,
-    data: { reason: string },
+    data: CancelContractDto,
     options?: RequestOptions,
   ): Promise<Contract> {
     return this.client.put<Contract>(`${this.basePath}/${id}/cancel`, data, options);
   }
 
+  async suspendContract(
+    id: string,
+    data: SuspendContractDto,
+    options?: RequestOptions,
+  ): Promise<Contract> {
+    return this.client.post<Contract>(`${this.basePath}/${id}/suspend`, data, options);
+  }
+
+  async resumeContract(
+    id: string,
+    data: ResumeContractDto,
+    options?: RequestOptions,
+  ): Promise<Contract> {
+    return this.client.post<Contract>(`${this.basePath}/${id}/resume`, data, options);
+  }
+
+  async reactivateContract(
+    id: string,
+    data: ReactivateContractDto,
+    options?: RequestOptions,
+  ): Promise<Contract> {
+    return this.client.post<Contract>(`${this.basePath}/${id}/reactivate`, data, options);
+  }
+
+  async getLifecycleHistory(
+    id: string,
+    options?: RequestOptions,
+  ): Promise<ContractLifecycleEvent[]> {
+    return this.client.get<ContractLifecycleEvent[]>(
+      `${this.basePath}/${id}/lifecycle-history`,
+      undefined,
+      options,
+    );
+  }
+
+  async getCancellationAnalytics(
+    params?: { startDate?: string; endDate?: string },
+    options?: RequestOptions,
+  ): Promise<CancellationAnalytics> {
+    return this.client.get<CancellationAnalytics>(
+      `${this.basePath}/analytics/cancellation-reasons`,
+      params,
+      options,
+    );
+  }
+
   async resendWhatsAppNotification(
     contractId: string,
     options?: RequestOptions,

package/src/resources/index.ts

@@ -25,3 +25,5 @@ export * from './payment-methods';
 export * from './whatsapp';
 export * from './whatsapp-templates';
 export * from './bulk-messaging';
+export * from './activities';
+export * from './tags';

package/src/resources/tags.ts

@@ -0,0 +1,147 @@
+import { BaseResource } from './base';
+import {
+  Tag,
+  CreateTagDto,
+  UpdateTagDto,
+  AssignTagsDto,
+  SearchTagsParams,
+  GetTagClientsParams,
+  AssignTagsResponse,
+  RemoveTagsResponse,
+  DeleteTagResponse,
+  ClientTagsResponse,
+  TagClientsResponse,
+  TagStatsResponse,
+} from '../models/tags';
+import { RequestOptions, PaginatedResponseDto } from '../types';
+
+export class TagsResource extends BaseResource {
+  private basePath = 'tags';
+
+  // ==================== Tag Management ====================
+
+  /**
+   * Create a new tag
+   * POST /api/v1/tags
+   */
+  async createTag(data: CreateTagDto, options?: RequestOptions): Promise<Tag> {
+    return this.client.post<Tag>(this.basePath, data, options);
+  }
+
+  /**
+   * List all tags with optional filters and pagination
+   * GET /api/v1/tags
+   */
+  async searchTags(
+    params?: SearchTagsParams,
+    options?: RequestOptions,
+  ): Promise<PaginatedResponseDto<Tag>> {
+    return this.client.get<PaginatedResponseDto<Tag>>(this.basePath, params, options);
+  }
+
+  /**
+   * Get a specific tag by ID
+   * GET /api/v1/tags/:id
+   */
+  async getTag(id: string, options?: RequestOptions): Promise<Tag> {
+    return this.client.get<Tag>(`${this.basePath}/${id}`, undefined, options);
+  }
+
+  /**
+   * Update an existing tag
+   * PUT /api/v1/tags/:id
+   */
+  async updateTag(id: string, data: UpdateTagDto, options?: RequestOptions): Promise<Tag> {
+    return this.client.put<Tag>(`${this.basePath}/${id}`, data, options);
+  }
+
+  /**
+   * Delete a tag (soft delete)
+   * DELETE /api/v1/tags/:id
+   * @param id - Tag ID
+   * @param force - Force deletion even if tag has assigned clients
+   */
+  async deleteTag(
+    id: string,
+    force?: boolean,
+    options?: RequestOptions,
+  ): Promise<DeleteTagResponse> {
+    const path = force ? `${this.basePath}/${id}?force=true` : `${this.basePath}/${id}`;
+    return this.client.delete<DeleteTagResponse>(path, options);
+  }
+
+  /**
+   * Get clients with a specific tag
+   * GET /api/v1/tags/:id/clients
+   */
+  async getTagClients(
+    id: string,
+    params?: GetTagClientsParams,
+    options?: RequestOptions,
+  ): Promise<TagClientsResponse> {
+    return this.client.get<TagClientsResponse>(`${this.basePath}/${id}/clients`, params, options);
+  }
+
+  /**
+   * Get tag statistics
+   * GET /api/v1/tags/stats
+   */
+  async getTagStats(options?: RequestOptions): Promise<TagStatsResponse> {
+    return this.client.get<TagStatsResponse>(`${this.basePath}/stats`, undefined, options);
+  }
+
+  // ==================== Client Tag Assignment ====================
+
+  /**
+   * Assign one or multiple tags to a client
+   * POST /api/v1/clients/:clientId/tags
+   */
+  async assignTagsToClient(
+    clientId: string,
+    data: AssignTagsDto,
+    options?: RequestOptions,
+  ): Promise<AssignTagsResponse> {
+    return this.client.post<AssignTagsResponse>(`clients/${clientId}/tags`, data, options);
+  }
+
+  /**
+   * Remove a specific tag from a client
+   * DELETE /api/v1/clients/:clientId/tags/:tagId
+   */
+  async removeTagFromClient(
+    clientId: string,
+    tagId: string,
+    options?: RequestOptions,
+  ): Promise<RemoveTagsResponse> {
+    return this.client.delete<RemoveTagsResponse>(`clients/${clientId}/tags/${tagId}`, options);
+  }
+
+  /**
+   * Remove multiple tags from a client
+   * DELETE /api/v1/clients/:clientId/tags
+   * Note: This endpoint requires sending tagIds in the request body
+   */
+  async removeTagsFromClient(
+    clientId: string,
+    tagIds: string[],
+    options?: RequestOptions,
+  ): Promise<RemoveTagsResponse> {
+    // DELETE with body requires special handling
+    return this.request<RemoveTagsResponse>(`clients/${clientId}/tags`, {
+      method: 'DELETE',
+      body: JSON.stringify({ tagIds }),
+      headers: {
+        'Content-Type': 'application/json',
+        ...options?.headers,
+      },
+    });
+  }
+
+  /**
+   * Get all tags assigned to a client
+   * GET /api/v1/clients/:clientId/tags
+   */
+  async getClientTags(clientId: string, options?: RequestOptions): Promise<ClientTagsResponse> {
+    return this.client.get<ClientTagsResponse>(`clients/${clientId}/tags`, undefined, options);
+  }
+}

package/src/sdk.ts

@@ -29,6 +29,8 @@ import {
   WhatsAppResource,
   WhatsAppTemplatesResource,
   BulkMessagingResource,
+  ActivitiesResource,
+  TagsResource,
 } from './resources';
 
 export class GymSpaceSdk {
@@ -63,6 +65,8 @@ export class GymSpaceSdk {
   public whatsapp: WhatsAppResource;
   public whatsappTemplates: WhatsAppTemplatesResource;
   public bulkMessaging: BulkMessagingResource;
+  public activities: ActivitiesResource;
+  public tags: TagsResource;
 
   constructor(config: GymSpaceConfig) {
     this.client = new ApiClient(config);
@@ -95,6 +99,8 @@ export class GymSpaceSdk {
     this.whatsapp = new WhatsAppResource(this.client);
     this.whatsappTemplates = new WhatsAppTemplatesResource(this.client);
     this.bulkMessaging = new BulkMessagingResource(this.client);
+    this.activities = new ActivitiesResource(this.client);
+    this.tags = new TagsResource(this.client);
   }
 
   /**