@gymspace/sdk 1.0.0

package/src/models/leads.ts

@@ -0,0 +1,52 @@
+import { LeadStatus } from '@gymspace/shared';
+import { PaginationQueryDto } from '../types';
+
+export interface CreateLeadDto {
+  name: string;
+  email: string;
+  phone: string;
+  gymId: string;
+  message?: string;
+  source?: string;
+  metadata?: Record<string, any>;
+}
+
+export interface UpdateLeadDto {
+  status?: LeadStatus;
+  notes?: string;
+  assignedToUserId?: string;
+  metadata?: Record<string, any>;
+}
+
+export interface Lead {
+  id: string;
+  gymId: string;
+  name: string;
+  email: string;
+  phone: string;
+  status: LeadStatus;
+  source?: string;
+  message?: string;
+  notes?: string;
+  assignedToUserId?: string;
+  convertedToClientId?: string;
+  metadata?: Record<string, any>;
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface SearchLeadsParams extends PaginationQueryDto {
+  status?: LeadStatus;
+  search?: string;
+  assignedToUserId?: string;
+  startDate?: string;
+  endDate?: string;
+}
+
+export interface LeadStats {
+  total: number;
+  byStatus: Record<LeadStatus, number>;
+  conversionRate: number;
+  averageResponseTime: number;
+  bySource: Record<string, number>;
+}

package/src/models/membership-plans.ts

@@ -0,0 +1,71 @@
+export interface CreateMembershipPlanDto {
+  name: string;
+  description?: string;
+  basePrice: number;
+  durationMonths?: number;
+  durationDays?: number;
+  termsAndConditions?: string;
+  allowsCustomPricing?: boolean;
+  maxEvaluations?: number;
+  includesAdvisor?: boolean;
+  showInCatalog?: boolean;
+  features?: string[];
+  status?: 'active' | 'inactive' | 'archived';
+  assetsIds?: string[];
+}
+
+export interface UpdateMembershipPlanDto {
+  name?: string;
+  description?: string;
+  basePrice?: number;
+  durationMonths?: number;
+  durationDays?: number;
+  termsAndConditions?: string;
+  allowsCustomPricing?: boolean;
+  maxEvaluations?: number;
+  includesAdvisor?: boolean;
+  showInCatalog?: boolean;
+  features?: string[];
+  status?: 'active' | 'inactive' | 'archived';
+  isActive?: boolean;
+  assetsIds?: string[];
+}
+
+export interface MembershipPlan {
+  id: string;
+  gymId: string;
+  name: string;
+  description?: string;
+  basePrice: number;
+  durationMonths?: number;
+  durationDays?: number;
+  gym?: {
+    id: string;
+    name: string;
+    organization: {
+      currency: string;
+    };
+  };
+  termsAndConditions?: string;
+  allowsCustomPricing: boolean;
+  maxEvaluations: number;
+  includesAdvisor: boolean;
+  showInCatalog: boolean;
+  features: string[];
+  status: 'active' | 'inactive' | 'archived';
+  isActive: boolean;
+  assetsIds?: string[];
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface MembershipPlanStats {
+  totalContracts: number;
+  activeContracts: number;
+  totalRevenue: number;
+  monthlyRevenue: number;
+}
+
+export interface GetMembershipPlansParams {
+  activeOnly?: boolean;
+}

package/src/models/onboarding.ts

@@ -0,0 +1,171 @@
+export interface StartOnboardingData {
+  name: string;
+  email: string;
+  phone: string;
+  password: string;
+  organizationName: string;
+  country: string;
+  currency: string;
+  timezone: string;
+}
+
+export interface StartOnboardingResponse {
+  success: boolean;
+  access_token: string;
+  refresh_token: string;
+  user: {
+    id: string;
+    email: string;
+    name: string;
+    userType: string;
+  };
+  organization: {
+    id: string;
+    name: string;
+    organizationCode: string;
+  };
+  gym: {
+    id: string;
+    name: string;
+  };
+  onboardingStatus: OnboardingStatus;
+}
+
+export interface BusinessHours {
+  open: string;
+  close: string;
+  closed: boolean;
+}
+
+export interface WeeklySchedule {
+  monday: BusinessHours;
+  tuesday: BusinessHours;
+  wednesday: BusinessHours;
+  thursday: BusinessHours;
+  friday: BusinessHours;
+  saturday: BusinessHours;
+  sunday: BusinessHours;
+}
+
+export interface Amenities {
+  hasParking: boolean;
+  hasShowers: boolean;
+  hasLockers: boolean;
+  hasPool: boolean;
+  hasSauna: boolean;
+  hasWifi: boolean;
+  hasChildcare: boolean;
+  hasCafeteria: boolean;
+}
+
+export interface SocialMedia {
+  facebook?: string;
+  instagram?: string;
+  twitter?: string;
+  website?: string;
+}
+
+export interface UpdateGymSettingsData {
+  gymId: string;
+  name: string;
+  address: string;
+  city: string;
+  state: string;
+  postalCode: string;
+  phone: string;
+  email: string;
+  businessHours: WeeklySchedule;
+  capacity: number;
+  description?: string;
+  amenities: Amenities;
+  socialMedia?: SocialMedia;
+  logo?: string;
+  coverPhoto?: string;
+  primaryColor?: string;
+}
+
+export interface ClientManagementFeatures {
+  enabled: boolean;
+  requireDocumentId: boolean;
+  enablePhotos: boolean;
+  trackEmergencyContacts: boolean;
+  trackMedicalConditions: boolean;
+}
+
+export interface MembershipManagementFeatures {
+  enabled: boolean;
+  allowCustomPricing: boolean;
+  allowContractFreezing: boolean;
+  expiryWarningDays: number;
+  autoRenewalReminders: boolean;
+}
+
+export interface CheckInSystemFeatures {
+  enabled: boolean;
+  requireActiveContract: boolean;
+  trackCheckInTime: boolean;
+  allowMultiplePerDay: boolean;
+}
+
+export interface EvaluationSystemFeatures {
+  enabled: boolean;
+  trackMeasurements: boolean;
+  trackBodyComposition: boolean;
+  trackPerformance: boolean;
+  defaultFrequencyDays: number;
+}
+
+export interface LeadManagementFeatures {
+  enabled: boolean;
+  publicCatalogListing: boolean;
+  enableOnlineForm: boolean;
+  autoAssignLeads: boolean;
+}
+
+export interface NotificationSettings {
+  emailEnabled: boolean;
+  smsEnabled: boolean;
+  welcomeEmails: boolean;
+  contractExpiryAlerts: boolean;
+  evaluationReminders: boolean;
+}
+
+export interface ConfigureFeaturesData {
+  gymId: string;
+  clientManagement: ClientManagementFeatures;
+  membershipManagement: MembershipManagementFeatures;
+  checkInSystem: CheckInSystemFeatures;
+  evaluationSystem: EvaluationSystemFeatures;
+  leadManagement: LeadManagementFeatures;
+  notifications: NotificationSettings;
+}
+
+export interface CompleteGuidedSetupData {
+  gymId: string;
+}
+
+export enum OnboardingStep {
+  ACCOUNT_CREATED = 'account_created',
+  GYM_SETTINGS = 'gym_settings',
+  FEATURES_CONFIGURED = 'features_configured',
+  COMPLETED = 'completed',
+}
+
+export interface OnboardingStatus {
+  organizationId: string;
+  gymId: string;
+  currentStep: OnboardingStep;
+  accountCreated: boolean;
+  gymSettingsCompleted: boolean;
+  featuresConfigured: boolean;
+  isCompleted: boolean;
+  nextAction: string;
+  completionPercentage: number;
+}
+
+export interface OnboardingResponse {
+  success: boolean;
+  gym?: any;
+  onboardingStatus: OnboardingStatus;
+  message?: string;
+}

package/src/models/organizations.ts

@@ -0,0 +1,25 @@
+export interface UpdateOrganizationDto {
+  country?: string;
+  currency?: string;
+  timezone?: string;
+  settings?: Record<string, any>;
+}
+
+export interface Organization {
+  id: string;
+  name: string;
+  country?: string;
+  currency?: string;
+  timezone?: string;
+  settings?: Record<string, any>;
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface OrganizationStats {
+  totalGyms: number;
+  totalClients: number;
+  totalContracts: number;
+  activeContracts: number;
+  totalRevenue: number;
+}

package/src/models/products.ts

@@ -0,0 +1,99 @@
+import { PaginationQueryDto } from '../types';
+
+// Product Category Models
+export interface CreateProductCategoryDto {
+  name: string;
+  description?: string;
+  color?: string;
+}
+
+export interface UpdateProductCategoryDto {
+  name?: string;
+  description?: string;
+  color?: string;
+}
+
+export interface ProductCategory {
+  id: string;
+  gymId: string;
+  name: string;
+  description?: string;
+  color?: string;
+  createdAt: string;
+  updatedAt: string;
+  createdBy?: {
+    id: string;
+    name: string;
+    email: string;
+  };
+  updatedBy?: {
+    id: string;
+    name: string;
+    email: string;
+  };
+  _count?: {
+    products: number;
+  };
+}
+
+// Product Models
+export interface CreateProductDto {
+  name: string;
+  description?: string;
+  price: number;
+  stock?: number;
+  categoryId?: string;
+  imageId?: string;
+  status?: 'active' | 'inactive';
+}
+
+export interface UpdateProductDto {
+  name?: string;
+  description?: string;
+  price?: number;
+  stock?: number;
+  categoryId?: string;
+  imageId?: string;
+  status?: 'active' | 'inactive';
+}
+
+export interface UpdateStockDto {
+  quantity: number;
+}
+
+export interface Product {
+  id: string;
+  gymId: string;
+  categoryId?: string;
+  name: string;
+  description?: string;
+  price: number;
+  stock: number;
+  imageId?: string;
+  status: 'active' | 'inactive';
+  createdAt: string;
+  updatedAt: string;
+  category?: ProductCategory;
+  createdBy?: {
+    id: string;
+    name: string;
+    email: string;
+  };
+  updatedBy?: {
+    id: string;
+    name: string;
+    email: string;
+  };
+  _count?: {
+    saleItems: number;
+  };
+}
+
+export interface SearchProductsParams extends PaginationQueryDto {
+  search?: string;
+  categoryId?: string;
+  status?: 'active' | 'inactive';
+  inStock?: boolean;
+  minPrice?: number;
+  maxPrice?: number;
+}

package/src/models/sales.ts

@@ -0,0 +1,108 @@
+import { PaginationQueryDto } from '../types';
+
+// Sale Item Models
+export interface SaleItemDto {
+  productId: string;
+  quantity: number;
+  unitPrice: number;
+}
+
+export interface SaleItem {
+  id: string;
+  saleId: string;
+  productId: string;
+  quantity: number;
+  unitPrice: number;
+  total: number;
+  createdAt: string;
+  updatedAt: string;
+  product?: {
+    id: string;
+    name: string;
+    imageId?: string;
+    category?: {
+      id: string;
+      name: string;
+      color?: string;
+    };
+  };
+}
+
+// Sale Models
+export interface CreateSaleDto {
+  items: SaleItemDto[];
+  customerName?: string;
+  notes?: string;
+  paymentStatus?: 'paid' | 'unpaid';
+}
+
+export interface UpdateSaleDto {
+  customerName?: string;
+  notes?: string;
+  paymentStatus?: 'paid' | 'unpaid';
+}
+
+export interface UpdatePaymentStatusDto {
+  paymentStatus: 'paid' | 'unpaid';
+}
+
+export interface Sale {
+  id: string;
+  gymId: string;
+  saleNumber: string;
+  total: number;
+  paymentStatus: 'paid' | 'unpaid';
+  saleDate: string;
+  customerName?: string;
+  notes?: string;
+  createdAt: string;
+  updatedAt: string;
+  saleItems?: SaleItem[];
+  createdBy?: {
+    id: string;
+    name: string;
+    email: string;
+  };
+  updatedBy?: {
+    id: string;
+    name: string;
+    email: string;
+  };
+  _count?: {
+    saleItems: number;
+  };
+}
+
+export interface SearchSalesParams extends PaginationQueryDto {
+  customerName?: string;
+  paymentStatus?: 'paid' | 'unpaid';
+  startDate?: string;
+  endDate?: string;
+  minTotal?: number;
+  maxTotal?: number;
+}
+
+// Analytics Models
+export interface SalesStats {
+  totalSales: number;
+  totalRevenue: number;
+  paidSales: number;
+  unpaidSales: number;
+  paymentRate: number;
+}
+
+export interface TopSellingProduct {
+  product?: {
+    id: string;
+    name: string;
+    price: number;
+    imageId?: string;
+    category?: {
+      id: string;
+      name: string;
+      color?: string;
+    };
+  };
+  totalQuantity: number;
+  totalRevenue: number;
+}

package/src/models/suppliers.ts

@@ -0,0 +1,57 @@
+import { PaginationQueryDto } from '../types';
+
+// Supplier Models
+export interface CreateSupplierDto {
+  name: string;
+  contactInfo?: string;
+  phone?: string;
+  email?: string;
+  address?: string;
+}
+
+export interface UpdateSupplierDto {
+  name?: string;
+  contactInfo?: string;
+  phone?: string;
+  email?: string;
+  address?: string;
+}
+
+export interface Supplier {
+  id: string;
+  gymId: string;
+  name: string;
+  contactInfo?: string;
+  phone?: string;
+  email?: string;
+  address?: string;
+  createdAt: string;
+  updatedAt: string;
+  createdBy?: {
+    id: string;
+    name: string;
+    email: string;
+  };
+  updatedBy?: {
+    id: string;
+    name: string;
+    email: string;
+  };
+}
+
+export interface SearchSuppliersParams extends PaginationQueryDto {
+  search?: string;
+}
+
+// Analytics Models
+export interface SuppliersStats {
+  totalSuppliers: number;
+  suppliersWithEmail: number;
+  suppliersWithPhone: number;
+  suppliersWithAddress: number;
+  contactCompleteness: {
+    email: number;
+    phone: number;
+    address: number;
+  };
+}

package/src/models/users.ts

@@ -0,0 +1,17 @@
+export interface UpdateProfileDto {
+  name?: string;
+  phone?: string;
+  birthDate?: string;
+}
+
+export interface UserProfileDto {
+  id: string;
+  email: string;
+  name: string;
+  phone?: string | null;
+  birthDate?: Date | string | null;
+  userType: 'owner' | 'collaborator';
+  emailVerified: boolean;
+  createdAt: Date | string;
+  updatedAt: Date | string;
+}

package/src/resources/assets.ts

@@ -0,0 +1,102 @@
+import { BaseResource } from './base';
+import type { AssetResponseDto } from '../models/assets';
+
+export class AssetsResource extends BaseResource {
+  /**
+   * Upload a new asset
+   */
+  async upload(data: {
+    file: File;
+    description?: string;
+    metadata?: Record<string, any>;
+  }): Promise<AssetResponseDto> {
+    const formData = new FormData();
+    formData.append('file', data.file);
+
+    if (data.description) {
+      formData.append('description', data.description);
+    }
+
+    if (data.metadata) {
+      formData.append('metadata', JSON.stringify(data.metadata));
+    }
+
+    return await this.client.post<AssetResponseDto>('/assets/upload', formData, {
+      headers: {
+        'Content-Type': 'multipart/form-data',
+      },
+    });
+  }
+
+  /**
+   * Get a single asset by ID
+   */
+  async findOne(id: string): Promise<AssetResponseDto> {
+    return await this.client.get<AssetResponseDto>(`/assets/${id}`);
+  }
+
+  /**
+   * Get multiple assets by IDs
+   */
+  async findByIds(ids: string[]): Promise<AssetResponseDto[]> {
+    if (!ids || ids.length === 0) {
+      return [];
+    }
+
+    // El segundo parámetro del get son los params directamente
+    return await this.client.get<AssetResponseDto[]>('/assets/by-ids', {
+      ids: ids.join(',')
+    });
+  }
+
+  /**
+   * Get all assets for the current gym
+   */
+  async findAll(): Promise<AssetResponseDto[]> {
+    return await this.client.get<AssetResponseDto[]>('/assets');
+  }
+
+  /**
+   * Delete an asset
+   */
+  async delete(id: string): Promise<void> {
+    await this.client.delete(`/assets/${id}`);
+  }
+
+  /**
+   * Get a signed download URL for an asset
+   */
+  async getDownloadUrl(id: string): Promise<{ url: string; filename: string }> {
+    return await this.client.get<{ url: string; filename: string }>(`/assets/${id}/download-url`);
+  }
+
+  /**
+   * Download an asset as a blob
+   */
+  async download(id: string): Promise<Blob> {
+    const response = await this.client.get<ArrayBuffer>(`/assets/${id}/download`, {
+      responseType: 'arraybuffer',
+    });
+
+    return new Blob([response]);
+  }
+
+  /**
+   * Get the render URL for an asset (for inline display)
+   * This returns the URL directly without making an API call
+   */
+  getRenderUrl(id: string): string {
+    return `${this.client.getBaseUrl()}/assets/${id}/render`;
+  }
+
+  /**
+   * Get asset blob for rendering/preview
+   */
+  async render(id: string): Promise<Blob> {
+    const response = await this.client.get<ArrayBuffer>(`/assets/${id}/render`, {
+      responseType: 'arraybuffer',
+    });
+
+    return new Blob([response]);
+  }
+}