@gymspace/sdk 1.2.21 → 1.2.22

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gymspace/sdk",
-  "version": "1.2.21",
+  "version": "1.2.22",
   "description": "GymSpace TypeScript SDK for API integration",
   "author": "GymSpace Team",
   "license": "MIT",

package/src/models/activities.ts

@@ -65,14 +65,13 @@ export interface SearchActivitiesParams {
 }
 
 export interface CreateActivityNotificationDto {
-  templateId?: string;
-  customMessage?: string;
+  message: string;
   advanceTimeMinutes: number;
+  isActive?: boolean;
 }
 
 export interface UpdateActivityNotificationDto {
-  templateId?: string;
-  customMessage?: string;
+  message?: string;
   advanceTimeMinutes?: number;
   isActive?: boolean;
 }
@@ -80,11 +79,10 @@ export interface UpdateActivityNotificationDto {
 export interface ActivityNotification {
   id: string;
   activityId: string;
-  templateId?: string;
-  customMessage?: string;
+  templateId: string;
   advanceTimeMinutes: number;
   isActive: boolean;
-  template?: {
+  template: {
     id: string;
     name: string;
     message: string;

package/src/models/bulk-messaging.ts

@@ -6,6 +6,7 @@ export interface BulkTemplate {
   description?: string;
   tags: string[];
   isActive: boolean;
+  isHide: boolean;
   usageCount: number;
   lastUsedAt?: Date;
   createdByUserId: string;

package/src/models/catalog.ts

@@ -0,0 +1,236 @@
+// ============================================================================
+// Public Catalog Types
+// ============================================================================
+
+/**
+ * Hero section of the catalog
+ */
+export interface CatalogHeroSection {
+  logo: string | null;
+  banner: string | null;
+  heroMessage: string | null;
+  ctaButtonText: string;
+  whatsappUrl: string | null;
+}
+
+/**
+ * Activity/class offered by the gym
+ */
+export interface CatalogActivity {
+  id: string;
+  name: string;
+  description: string | null;
+  startTime: string;
+  duration: number;
+  days: string[];
+  imageUrl: string | null;
+}
+
+/**
+ * Membership plan offered by the gym
+ */
+export interface CatalogPlan {
+  id: string;
+  name: string;
+  description: string | null;
+  price: number;
+  currency: string;
+  duration: string;
+  features: any;
+  whatsappUrl: string | null;
+}
+
+/**
+ * Social media links
+ */
+export interface CatalogSocialMedia {
+  instagram: string | null;
+  facebook: string | null;
+  tiktok: string | null;
+  whatsapp: string | null;
+}
+
+/**
+ * Gym location information
+ */
+export interface CatalogLocation {
+  address: string | null;
+  city: string | null;
+  state: string | null;
+  latitude: number | null;
+  longitude: number | null;
+}
+
+/**
+ * Formatted schedule for a day
+ */
+export interface FormattedSchedule {
+  day: string;
+  hours: string;
+}
+
+/**
+ * Complete catalog response
+ */
+export interface CatalogResponse {
+  gym: {
+    id: string;
+    name: string;
+    slug: string;
+    description: string | null;
+    phone: string | null;
+    email: string | null;
+    currency: string;
+  };
+  hero: CatalogHeroSection;
+  plans: CatalogPlan[];
+  activities: CatalogActivity[];
+  schedule: FormattedSchedule[];
+  socialMedia: CatalogSocialMedia;
+  location: CatalogLocation;
+}
+
+/**
+ * City with gym count
+ */
+export interface CityWithGyms {
+  city: string;
+  state: string;
+  count: number;
+}
+
+/**
+ * Search catalog parameters
+ */
+export interface SearchCatalogParams {
+  search?: string;
+  city?: string;
+  state?: string;
+  latitude?: string;
+  longitude?: string;
+  radius?: string;
+  limit?: number;
+  offset?: number;
+}
+
+/**
+ * Catalog gym in search results
+ */
+export interface CatalogGym {
+  id: string;
+  name: string;
+  slug: string;
+  address?: string;
+  city?: string;
+  state?: string;
+  phone?: string;
+  email?: string;
+  amenities?: any;
+  settings?: any;
+}
+
+/**
+ * Search catalog response
+ */
+export interface SearchCatalogResponse {
+  gyms: CatalogGym[];
+  pagination: {
+    total: number;
+    limit: number;
+    offset: number;
+  };
+}
+
+// ============================================================================
+// Lead Management Types
+// ============================================================================
+
+/**
+ * Lead gender enum
+ */
+export enum LeadGender {
+  MALE = 'male',
+  FEMALE = 'female',
+  OTHER = 'other',
+}
+
+/**
+ * Create lead DTO
+ */
+export interface CreateLeadDto {
+  fullName: string;
+  age: number;
+  phone: string;
+  gender: LeadGender;
+  objective: string;
+}
+
+/**
+ * Catalog lead entity
+ */
+export interface CatalogLead {
+  id: string;
+  catalogId: string;
+  fullName: string;
+  age: number;
+  phone: string;
+  gender: string;
+  objective: string;
+  source: string;
+  ipAddress: string | null;
+  userAgent: string | null;
+  isContacted: boolean;
+  contactedAt: string | null;
+  createdAt: string;
+  updatedAt: string;
+}
+
+/**
+ * Lead filters for querying
+ */
+export interface LeadFiltersDto {
+  startDate?: string;
+  endDate?: string;
+  isContacted?: boolean;
+  limit?: number;
+  offset?: number;
+}
+
+/**
+ * Lead submission response
+ */
+export interface LeadSubmissionResponse {
+  message: string;
+}
+
+// ============================================================================
+// Admin Catalog Configuration Types
+// ============================================================================
+
+/**
+ * Gym catalog configuration
+ */
+export interface GymCatalog {
+  id: string;
+  gymId: string;
+  slug: string;
+  logo: string | null; // Deprecated: kept for backward compatibility
+  banner: string | null; // Deprecated: kept for backward compatibility
+  logoFileId: string | null;
+  bannerFileId: string | null;
+  heroMessage: string | null;
+  ctaButtonText: string;
+  createdAt: string;
+  updatedAt: string;
+}
+
+/**
+ * Update catalog configuration DTO
+ */
+export interface UpdateCatalogConfigDto {
+  slug?: string;
+  heroMessage?: string;
+  ctaButtonText?: string;
+  logoFileId?: string;
+  bannerFileId?: string;
+}

package/src/models/index.ts

@@ -26,6 +26,7 @@ export * from './bulk-messaging';
 export * from './activities';
 export * from './tags';
 export * from './commissions';
+export * from './catalog';
 
 export interface ApiResponse<T> {
   data: T;

package/src/models/subscriptions.ts

@@ -19,6 +19,7 @@ export interface Subscription {
   startDate: Date;
   endDate: Date;
   isActive: boolean;
+  isTrial?: boolean;
 }
 
 export interface AvailablePlanDto {
@@ -71,4 +72,4 @@ export interface CheckLimitResponse {
   currentUsage: number;
   limit: number;
   message?: string;
-}
+}

package/src/resources/admin-catalog.ts

@@ -0,0 +1,46 @@
+import { BaseResource } from './base';
+import { RequestOptions } from '../types';
+import {
+  GymCatalog,
+  UpdateCatalogConfigDto,
+  CatalogLead,
+  LeadFiltersDto,
+} from '../models/catalog';
+
+/**
+ * Admin Catalog Resource
+ * Handles catalog administration operations (requires authentication and CATALOG permissions)
+ */
+export class AdminCatalogResource extends BaseResource {
+  private basePath = 'admin/catalog';
+
+  /**
+   * Get catalog configuration for the current gym
+   * Requires: CATALOG_READ permission
+   */
+  async getCatalogConfig(options?: RequestOptions): Promise<GymCatalog> {
+    return this.client.get<GymCatalog>(this.basePath, undefined, options);
+  }
+
+  /**
+   * Update catalog configuration
+   * Requires: CATALOG_UPDATE permission
+   */
+  async updateCatalogConfig(
+    data: UpdateCatalogConfigDto,
+    options?: RequestOptions
+  ): Promise<GymCatalog> {
+    return this.client.put<GymCatalog>(this.basePath, data, options);
+  }
+
+  /**
+   * Get catalog leads with optional filtering
+   * Requires: CATALOG_READ permission
+   */
+  async getLeads(
+    filters?: LeadFiltersDto,
+    options?: RequestOptions
+  ): Promise<CatalogLead[]> {
+    return this.client.get<CatalogLead[]>(`${this.basePath}/leads`, filters, options);
+  }
+}

package/src/resources/index.ts

@@ -12,6 +12,7 @@ export * from './invitations';
 export * from './assets';
 export * from './files';
 export * from './public-catalog';
+export * from './admin-catalog';
 export * from './health';
 export * from './onboarding';
 export * from './products';

package/src/resources/public-catalog.ts

@@ -1,61 +1,62 @@
 import { BaseResource } from './base';
-import { RequestOptions, PaginatedResponseDto } from '../types';
-import { PaginationQueryDto } from '../types';
-
-export interface SearchCatalogParams extends PaginationQueryDto {
-  search?: string;
-  city?: string;
-  state?: string;
-  latitude?: string;
-  longitude?: string;
-  radius?: string;
-}
-
-export interface GetFeaturedGymsParams {
-  limit: string;
-}
-
-export interface CatalogGym {
-  id: string;
-  name: string;
-  slug: string;
-  address?: string;
-  city?: string;
-  state?: string;
-  phone?: string;
-  email?: string;
-  amenities?: any;
-  settings?: any;
-}
-
-export interface CityWithGyms {
-  city: string;
-  state: string;
-  count: number;
-}
-
+import { RequestOptions } from '../types';
+import {
+  CatalogResponse,
+  CatalogGym,
+  CityWithGyms,
+  SearchCatalogParams,
+  SearchCatalogResponse,
+  CreateLeadDto,
+  LeadSubmissionResponse,
+} from '../models/catalog';
+
+/**
+ * Public Catalog Resource
+ * Handles public-facing catalog operations (no authentication required)
+ */
 export class PublicCatalogResource extends BaseResource {
   private basePath = 'catalog';
 
+  /**
+   * Search gyms in the public catalog
+   */
   async searchCatalog(
     params?: SearchCatalogParams,
     options?: RequestOptions
-  ): Promise<PaginatedResponseDto<CatalogGym>> {
-    return this.paginate<CatalogGym>(`${this.basePath}/search`, params, options);
+  ): Promise<SearchCatalogResponse> {
+    return this.client.get<SearchCatalogResponse>(`${this.basePath}/search`, params, options);
   }
 
-  async getFeaturedGyms(
-    params: GetFeaturedGymsParams,
-    options?: RequestOptions
-  ): Promise<CatalogGym[]> {
+  /**
+   * Get featured gyms
+   */
+  async getFeaturedGyms(limit?: number, options?: RequestOptions): Promise<CatalogGym[]> {
+    const params = limit ? { limit: String(limit) } : undefined;
     return this.client.get<CatalogGym[]>(`${this.basePath}/featured`, params, options);
   }
 
+  /**
+   * Get list of cities with available gyms
+   */
   async getCitiesWithGyms(options?: RequestOptions): Promise<CityWithGyms[]> {
     return this.client.get<CityWithGyms[]>(`${this.basePath}/cities`, undefined, options);
   }
 
-  async getGymBySlug(slug: string, options?: RequestOptions): Promise<CatalogGym> {
-    return this.client.get<CatalogGym>(`${this.basePath}/${slug}`, undefined, options);
+  /**
+   * Get complete catalog details by gym slug
+   */
+  async getCatalogBySlug(slug: string, options?: RequestOptions): Promise<CatalogResponse> {
+    return this.client.get<CatalogResponse>(`${this.basePath}/${slug}`, undefined, options);
   }
-}
+
+  /**
+   * Submit a lead form for a specific gym
+   */
+  async submitLead(
+    slug: string,
+    data: CreateLeadDto,
+    options?: RequestOptions
+  ): Promise<LeadSubmissionResponse> {
+    return this.client.post<LeadSubmissionResponse>(`${this.basePath}/${slug}/lead`, data, options);
+  }
+}

package/src/resources/subscription-plans.ts

@@ -5,6 +5,7 @@ import { RequestOptions } from '../types';
 export interface SubscriptionPlanDto {
   id: string;
   name: string;
+  planType?: string;
   price: {
     PEN?: { currency: 'PEN'; value: number };
     USD?: { currency: 'USD'; value: number };
@@ -20,6 +21,7 @@ export interface SubscriptionPlanDto {
   features: Record<string, any>;
   description?: string;
   isActive: boolean;
+  isVisibleToPublic: boolean;
   createdAt: Date;
   updatedAt: Date;
   activeSubscriptions?: number;
@@ -37,6 +39,7 @@ export interface PricingDto {
 
 export interface CreateSubscriptionPlanDto {
   name: string;
+  planType?: string;
   price: PricingDto;
   billingFrequency: string;
   duration?: number;
@@ -47,10 +50,12 @@ export interface CreateSubscriptionPlanDto {
   features: Record<string, any>;
   description?: string;
   isActive?: boolean;
+  isVisibleToPublic?: boolean;
 }
 
 export interface UpdateSubscriptionPlanDto {
   name?: string;
+  planType?: string;
   price?: PricingDto;
   billingFrequency?: string;
   duration?: number;
@@ -61,6 +66,7 @@ export interface UpdateSubscriptionPlanDto {
   features?: Record<string, any>;
   description?: string;
   isActive?: boolean;
+  isVisibleToPublic?: boolean;
 }
 
 export class SubscriptionPlansResource extends BaseResource {

package/src/sdk.ts

@@ -16,6 +16,7 @@ import {
   AssetsResource,
   FilesResource,
   PublicCatalogResource,
+  AdminCatalogResource,
   HealthResource,
   OnboardingResource,
   ProductsResource,
@@ -57,6 +58,7 @@ export class GymSpaceSdk {
   public assets: AssetsResource;
   public files: FilesResource;
   public publicCatalog: PublicCatalogResource;
+  public adminCatalog: AdminCatalogResource;
   public health: HealthResource;
   public onboarding: OnboardingResource;
   public products: ProductsResource;
@@ -96,6 +98,7 @@ export class GymSpaceSdk {
     this.assets = new AssetsResource(this.client);
     this.files = new FilesResource(this.client);
     this.publicCatalog = new PublicCatalogResource(this.client);
+    this.adminCatalog = new AdminCatalogResource(this.client);
     this.health = new HealthResource(this.client);
     this.onboarding = new OnboardingResource(this.client);
     this.products = new ProductsResource(this.client);