@gymspace/sdk 1.7.4 → 1.8.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gymspace/sdk",
-  "version": "1.7.4",
+  "version": "1.8.0",
   "description": "GymSpace TypeScript SDK for API integration",
   "author": "GymSpace Team",
   "license": "MIT",
@@ -40,7 +40,9 @@
   },
   "dependencies": {
     "@gymspace/shared": "^1.0.0",
-    "axios": "^1.6.5",
+    "@types/jsonwebtoken": "^9.0.10",
+    "axios": ">=1.0.0",
+    "jsonwebtoken": "^9.0.2",
     "zod": "^3.25.76"
   },
   "devDependencies": {

package/src/client.ts

@@ -1,19 +1,18 @@
 import axios, {
+  AxiosError,
   AxiosInstance,
   AxiosRequestConfig,
-  AxiosError,
   InternalAxiosRequestConfig,
-  AxiosRequestHeaders,
 } from 'axios';
-import { GymSpaceConfig, RequestOptions } from './types';
 import {
-  GymSpaceError,
   AuthenticationError,
   AuthorizationError,
+  GymSpaceError,
+  NetworkError,
   NotFoundError,
   ValidationError,
-  NetworkError,
 } from './errors';
+import { GymSpaceConfig, RequestOptions } from './types';
 
 export class ApiClient {
   private axiosInstance: AxiosInstance;
@@ -74,7 +73,7 @@ export class ApiClient {
           config.headers['Authorization'] = `Bearer ${this.config.apiKey}`;
         }
 
-        // Add refresh token header for ALL authenticated requests (not skipped)
+        // Add refresh token header if available (not skipped)
         if (this.refreshToken && this.config.apiKey && config.headers && !skipAuth) {
           config.headers['X-Refresh-Token'] = this.refreshToken;
         }

package/src/errors.ts

@@ -3,7 +3,7 @@ export class GymSpaceError extends Error {
     message: string,
     public statusCode?: number,
     public code?: string,
-    public details?: any
+    public details?: any,
   ) {
     super(message);
     this.name = 'GymSpaceError';
@@ -26,9 +26,7 @@ export class AuthorizationError extends GymSpaceError {
 
 export class NotFoundError extends GymSpaceError {
   constructor(resource: string, id?: string) {
-    const message = id 
-      ? `${resource} with id ${id} not found`
-      : `${resource} not found`;
+    const message = id ? `${resource} with id ${id} not found` : `${resource} not found`;
     super(message, 404, 'NOT_FOUND');
     this.name = 'NotFoundError';
   }
@@ -46,4 +44,4 @@ export class NetworkError extends GymSpaceError {
     super(message, 0, 'NETWORK_ERROR');
     this.name = 'NetworkError';
   }
-}
+}

package/src/models/activities.ts

@@ -64,14 +64,22 @@ export interface SearchActivitiesParams {
   isActive?: boolean;
 }
 
+export interface BulkMessageDto {
+  type: 'text' | 'image';
+  content: string;
+  mediaRef?: 'file' | 'asset';
+  caption?: string;
+  order: number;
+}
+
 export interface CreateActivityNotificationDto {
-  message: string;
+  messages: BulkMessageDto[];
   advanceTimeMinutes: number;
   isActive?: boolean;
 }
 
 export interface UpdateActivityNotificationDto {
-  message?: string;
+  messages?: BulkMessageDto[];
   advanceTimeMinutes?: number;
   isActive?: boolean;
 }
@@ -82,7 +90,8 @@ export interface ActivityNotificationDto {
   templateId: string;
   advanceTimeMinutes: number;
   isActive: boolean;
-  template: {
+  messages: BulkMessageDto[];
+  template?: {
     id: string;
     name: string;
     message: string;

package/src/models/bulk-messaging.ts

@@ -1,8 +1,11 @@
+import type { BulkMessage } from '@gymspace/shared';
+export type { BulkMessage };
+
 export interface BulkTemplate {
   id: string;
   gymId: string;
   name: string;
-  message: string;
+  messages: BulkMessage[];
   description?: string;
   tags: string[];
   isActive: boolean;
@@ -16,7 +19,7 @@ export interface BulkTemplate {
 
 export interface CreateBulkTemplateDto {
   name: string;
-  message: string;
+  messages: BulkMessage[];
   description?: string;
   tags?: string[];
   isActive?: boolean;
@@ -24,7 +27,7 @@ export interface CreateBulkTemplateDto {
 
 export interface UpdateBulkTemplateDto {
   name?: string;
-  message?: string;
+  messages?: BulkMessage[];
   description?: string;
   tags?: string[];
   isActive?: boolean;
@@ -37,8 +40,10 @@ export type { BulkMessageVariable } from '@gymspace/shared';
 
 export interface SendBulkMessagesDto {
   templateId?: string;
-  message: string;
+  messages?: BulkMessage[];
   clientIds: string[];
+  variableContext?: string;
+  scheduledAt?: string; // ISO 8601 datetime string for scheduled messages
 }
 
 export interface RejectedClientDto {
@@ -64,14 +69,27 @@ export interface BulkMessageLogDto {
   clientId: string;
   clientName: string;
   phoneNumber: string;
-  message: string;
-  status: 'pending' | 'queued' | 'sent' | 'delivered' | 'failed';
+  message?: string;
+  messages?: Array<{
+    type: 'text' | 'image';
+    order: number;
+    status: 'pending' | 'sent' | 'failed';
+    preview: string;
+    caption?: string;
+    externalMessageId?: string;
+    error?: string;
+    sentAt?: string;
+  }>;
+  status?: 'pending' | 'queued' | 'sent' | 'delivered' | 'failed';
+  overallStatus?: 'pending' | 'sending' | 'sent' | 'partial' | 'failed';
   sentAt?: string;
   deliveredAt?: string;
   failedAt?: string;
   failureReason?: string;
   retryCount: number;
-  timestamp: string;
+  timestamp?: string;
+  createdAt?: string;
+  updatedAt?: string;
 }
 
 export interface GetBulkLogsQueryDto {
@@ -85,6 +103,7 @@ export interface BulkLogsResponseDto {
   delivered: number;
   failed: number;
   pending: number;
+  partial?: number;
   logs: BulkMessageLogDto[];
   isComplete: boolean;
 }

package/src/models/contracts.ts

@@ -4,6 +4,8 @@ import { PaginationQueryDto } from '../types';
 export interface CreateContractDto {
   gymClientId: string;
   gymMembershipPlanId: string;
+  pricingPackageId?: string;
+  promoCode?: string;
   paymentMethodId: string;
   startDate: string;
   discountPercentage?: number;
@@ -16,6 +18,8 @@ export interface RenewContractDto {
   startDate?: string;
   discountPercentage?: number;
   customPrice?: number;
+  pricingPackageId?: string;
+  promoCode?: string;
   // Payment method ID (UUID) - uses the existing payment method if not provided
   paymentMethodId?: string;
   applyAtEndOfContract?: boolean;
@@ -66,6 +70,7 @@ export interface Contract {
   contractNumber: string;
   gymClientId: string;
   gymMembershipPlanId: string;
+  pricingPackageId?: string | null;
   paymentMethodId?: string;
   parentId?: string; // Reference to parent contract for renewals
   startDate: string;
@@ -77,6 +82,9 @@ export interface Contract {
   currency: string;
   discountPercentage?: number | null;
   discountAmount?: string | null;
+  promoCode?: string | null;
+  promoCodeSnapshot?: Record<string, any> | null;
+  promoDiscount?: string | null;
   paymentFrequency: string;
   notes?: string | null;
   termsAndConditions?: string | null;
@@ -122,6 +130,16 @@ export interface Contract {
     assetsIds?: string[];
     status?: string;
   };
+  pricingPackage?: {
+    id: string;
+    planId: string;
+    name: string;
+    price: number;
+    durationMonths?: number | null;
+    durationDays?: number | null;
+    isDefault: boolean;
+    isActive: boolean;
+  };
   paymentMethod?: {
     id: string;
     organizationId: string;

package/src/models/credits.ts

@@ -0,0 +1,79 @@
+// Feature Types
+export enum FeatureType {
+  AI_GENERATION = 'ai_generation',
+  BULK_WHATSAPP = 'bulk_whatsapp',
+}
+
+// Credit Account Models
+export interface CreditAccount {
+  id: string;
+  organizationId: string;
+  balance: number;
+  monthlyAllowance: number;
+  lastResetAt: string;
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface CreditAccountWithOrgName {
+  id: string;
+  organizationId: string;
+  organizationName: string;
+  balance: number;
+  monthlyAllowance: number;
+  lastResetAt: string;
+  createdAt: string;
+}
+
+// Credit Transaction Models
+export interface CreditTransaction {
+  id: string;
+  accountId: string;
+  featureType: FeatureType;
+  quantity: number;
+  description?: string;
+  metadata?: Record<string, any>;
+  createdAt: string;
+}
+
+// Credit Adjustment Models
+export interface CreditAdjustment {
+  adjustment: number;
+  reason: string;
+  notes?: string;
+}
+
+export interface CreditAdjustmentResponse {
+  previousBalance: number;
+  newBalance: number;
+  adjusted: number;
+  transactionId: string;
+}
+
+// Credit Usage Report Models
+export interface CreditUsageReport {
+  balance: number;
+  monthlyAllowance: number;
+  usedThisMonth: number;
+  remaining: number;
+  lastReset: string;
+  usagePercentage: number;
+  transactionCount: number;
+}
+
+export interface CreditUsageReportQuery {
+  startDate?: string;
+  endDate?: string;
+}
+
+// Credit Stats (for existing endpoint)
+export interface CreditStats {
+  balance: number;
+  monthlyAllowance: number;
+  usedThisMonth: number;
+  lastReset: string;
+}
+
+// DTOs for existing endpoints (already exported in bulk-messaging)
+// export interface GenerateAIMessageDto { ... }
+// export interface SendBulkMessagesDto { ... }

package/src/models/index.ts

@@ -33,6 +33,9 @@ export * from './tags';
 export * from './commissions';
 export * from './catalog';
 export * from './messages';
+export * from './credits';
+export * from './pricing-packages';
+export * from './promo-codes';
 
 export interface ApiResponse<T> {
   data: T;

package/src/models/membership-plans.ts

@@ -57,6 +57,9 @@ export interface MembershipPlan {
   assetsIds?: string[];
   createdAt: string;
   updatedAt: string;
+  _count?: {
+    pricingPackages: number;
+  };
 }
 
 export interface MembershipPlanStats {
@@ -126,4 +129,5 @@ export interface MembershipPlanStats {
 
 export interface GetMembershipPlansParams {
   activeOnly?: boolean;
+  includeCounts?: boolean;
 }

package/src/models/pricing-packages.ts

@@ -0,0 +1,65 @@
+// Request DTOs
+export interface CreatePricingPackageDto {
+  name: string;
+  description?: string;
+  durationMonths?: number;
+  durationDays?: number;
+  price: number;
+  currency?: string;
+  displayOrder?: number;
+  isActive?: boolean;
+  isDefault?: boolean;
+  metadata?: Record<string, any>;
+}
+
+export interface UpdatePricingPackageDto {
+  name?: string;
+  description?: string;
+  durationMonths?: number;
+  durationDays?: number;
+  price?: number;
+  currency?: string;
+  displayOrder?: number;
+  isActive?: boolean;
+  isDefault?: boolean;
+  metadata?: Record<string, any>;
+}
+
+export interface SearchPricingPackagesParams {
+  membershipPlanId?: string;
+  isActive?: boolean;
+  isDefault?: boolean;
+  page?: number;
+  limit?: number;
+}
+
+// Response types
+export interface PricingPackage {
+  id: string;
+  gymId: string;
+  membershipPlanId: string;
+  name: string;
+  description?: string;
+  durationMonths?: number;
+  durationDays?: number;
+  price: number;
+  currency: string;
+  displayOrder: number;
+  isActive: boolean;
+  isDefault: boolean;
+  metadata?: Record<string, any>;
+  createdAt: string;
+  updatedAt: string;
+  deletedAt?: string;
+
+  // Relations
+  membershipPlan?: {
+    id: string;
+    name: string;
+  };
+
+  // Counters
+  _count?: {
+    contracts: number;
+  };
+}

package/src/models/promo-codes.ts

@@ -0,0 +1,97 @@
+export enum DiscountType {
+  PERCENTAGE = 'PERCENTAGE',
+  FIXED_AMOUNT = 'FIXED_AMOUNT',
+}
+
+// Request DTOs
+export interface CreatePromoCodeDto {
+  code: string;
+  description?: string;
+  discountType: DiscountType;
+  discountValue: number;
+  validFrom: string;
+  validUntil: string;
+  maxUses?: number;
+  minPurchaseAmount?: number;
+  applicableTo?: {
+    planIds?: string[];
+    packageIds?: string[];
+  };
+}
+
+export interface UpdatePromoCodeDto {
+  description?: string;
+  discountType?: DiscountType;
+  discountValue?: number;
+  validFrom?: string;
+  validUntil?: string;
+  maxUses?: number;
+  minPurchaseAmount?: number;
+  applicableTo?: {
+    planIds?: string[];
+    packageIds?: string[];
+  };
+}
+
+export interface SearchPromoCodesParams {
+  isActive?: boolean;
+  code?: string;
+  status?: 'active' | 'expired' | 'exhausted';
+  page?: number;
+  limit?: number;
+}
+
+export interface ValidatePromoCodeDto {
+  code: string;
+  pricingPackageId: string;
+  packagePrice: number;
+}
+
+export interface ValidatePromoCodeResponseDto {
+  valid: boolean;
+  id?: string;
+  code?: string;
+  discountType?: string;
+  discountValue?: number;
+  discountAmount?: number;
+  finalAmount?: number;
+  error?: string;
+}
+
+// Response types
+export interface PromoCode {
+  id: string;
+  gymId: string;
+  code: string;
+  description?: string;
+  discountType: DiscountType;
+  discountValue: number;
+  validFrom: string;
+  validUntil: string;
+  maxUses?: number;
+  currentUses: number;
+  minPurchaseAmount?: number;
+  applicableTo?: {
+    planIds?: string[];
+    packageIds?: string[];
+  };
+  isActive: boolean;
+  createdAt: string;
+  updatedAt: string;
+  deletedAt?: string;
+
+  // Counters
+  _count?: {
+    contracts: number;
+  };
+}
+
+export interface PromoCodeAnalytics {
+  totalUses: number;
+  remainingUses?: number;
+  totalDiscount: number;
+  averageDiscount: number;
+  contractCount: number;
+  isActive: boolean;
+  daysUntilExpiration?: number;
+}