@gymspace/sdk 1.3.2 → 1.3.3

package/package.json

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

package/src/client.ts

@@ -66,13 +66,16 @@ export class ApiClient {
     // Request interceptor
     this.axiosInstance.interceptors.request.use(
       (config: InternalAxiosRequestConfig) => {
-        // Add Authorization header if auth token is configured
-        if (this.config.apiKey && config.headers) {
+        // Check if this request should skip auth
+        const skipAuth = (config as any).skipAuth;
+
+        // Add Authorization header if auth token is configured and not skipped
+        if (this.config.apiKey && config.headers && !skipAuth) {
           config.headers['Authorization'] = `Bearer ${this.config.apiKey}`;
         }
 
-        // Add refresh token header for ALL authenticated requests
-        if (this.refreshToken && this.config.apiKey && config.headers) {
+        // Add refresh token header for ALL authenticated requests (not skipped)
+        if (this.refreshToken && this.config.apiKey && config.headers && !skipAuth) {
           config.headers['X-Refresh-Token'] = this.refreshToken;
         }
 
@@ -174,13 +177,14 @@ export class ApiClient {
     data?: any,
     options?: RequestOptions & AxiosRequestConfig,
   ): Promise<T> {
-    const { headers, ...axiosConfig } = options || {};
+    const { headers, skipAuth, ...axiosConfig } = options || {};
 
-    const config: AxiosRequestConfig = {
+    const config: AxiosRequestConfig & { skipAuth?: boolean } = {
       method,
       url: path,
       ...this.mergeOptions({ headers }),
       ...axiosConfig,
+      skipAuth, // Pass skipAuth flag to interceptor
     };
 
     if (data && ['POST', 'PUT', 'PATCH'].includes(method.toUpperCase())) {

package/src/models/onboarding.ts

@@ -9,7 +9,15 @@ export interface StartOnboardingData {
   timezone: string;
 }
 
+export enum OnboardingCacheStatus {
+  PROCESSING = 'PROCESSING',
+  COMPLETED = 'COMPLETED',
+  FAILED = 'FAILED',
+}
+
 export interface StartOnboardingResponse {
+  status: OnboardingCacheStatus;
+  email: string;
   access_token: string;
   refresh_token: string;
   user: {
@@ -18,19 +26,34 @@ export interface StartOnboardingResponse {
     name: string;
     userType: string;
   };
-  lastActiveGymId: string;
-  lastActiveOrganizationId: string;
-  // Additional fields for mobile app compatibility
-  organization: {
+}
+
+export interface OnboardingStatusResponse {
+  status: OnboardingCacheStatus;
+  currentStep?: string; // 'setup-organization' | 'setup-gym' | 'setup-features' | 'finalizing'
+  progress?: number; // 0-100
+  message?: string; // Backend progress message
+  user?: {
+    id: string;
+    email: string;
+    name: string;
+    userType: string;
+  };
+  organization?: {
     id: string;
     name: string;
     organizationCode: string;
   };
-  gym: {
+  gym?: {
     id: string;
     name: string;
   };
-  onboardingStatus: OnboardingStatus;
+  access_token?: string;
+  refresh_token?: string;
+  lastActiveGymId?: string;
+  lastActiveOrganizationId?: string;
+  error?: string;
+  onboardingStatus?: OnboardingStatus;
 }
 
 export interface BusinessHours {

package/src/resources/onboarding.ts

@@ -7,24 +7,87 @@ import {
   CompleteGuidedSetupData,
   OnboardingStatus,
   OnboardingResponse,
+  OnboardingStatusResponse,
+  OnboardingCacheStatus,
 } from '../models/onboarding';
 
 export class OnboardingResource extends BaseResource {
   /**
-   * Creates owner account, organization, and initial gym
-   * Now also sends verification and organization codes via email
+   * Start onboarding process (async)
+   * Creates user account and triggers background setup
+   * Returns immediately with PROCESSING status
+   * Use getStatusByEmail() to poll for completion
    */
   async start(data: StartOnboardingData): Promise<StartOnboardingResponse> {
-    const response = await this.client.post<StartOnboardingResponse>('/onboarding/start', data);
-    
+    const response = await this.client.post<StartOnboardingResponse>(
+      '/onboarding/start',
+      data,
+      { skipAuth: true }, // Public endpoint - no auth required
+    );
+
     // Store tokens after successful onboarding start
     if (response.access_token) {
       this.client.setAuthToken(response.access_token);
     }
-    
+
     return response;
   }
 
+  /**
+   * Get onboarding status by email (polling endpoint)
+   * Use this to check if async onboarding setup is complete
+   *
+   * @param email - User email to check status
+   * @returns Status object with PROCESSING, COMPLETED, or FAILED
+   */
+  async getStatusByEmail(email: string): Promise<OnboardingStatusResponse> {
+    return this.client.get<OnboardingStatusResponse>(
+      '/onboarding/status',
+      { email },
+      { skipAuth: true },
+    );
+  }
+
+  /**
+   * Poll for onboarding completion
+   * Automatically polls until status is COMPLETED or FAILED
+   *
+   * @param email - User email
+   * @param options - Polling options
+   * @returns Final status when completed or failed
+   */
+  async waitForCompletion(
+    email: string,
+    options: {
+      maxAttempts?: number;
+      intervalMs?: number;
+      onProgress?: (attempt: number, status: OnboardingCacheStatus) => void;
+    } = {},
+  ): Promise<OnboardingStatusResponse> {
+    const { maxAttempts = 60, intervalMs = 1000, onProgress } = options;
+
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+      const status = await this.getStatusByEmail(email);
+
+      if (onProgress) {
+        onProgress(attempt, status.status);
+      }
+
+      if (status.status === OnboardingCacheStatus.COMPLETED) {
+        return status;
+      }
+
+      if (status.status === OnboardingCacheStatus.FAILED) {
+        throw new Error(`Onboarding failed: ${status.error || 'Unknown error'}`);
+      }
+
+      // Wait before next poll
+      await new Promise((resolve) => setTimeout(resolve, intervalMs));
+    }
+
+    throw new Error('Onboarding timeout - process is still running in background');
+  }
+
   /**
    * Updates basic gym settings (step 2 of onboarding)
    * Configure basic gym information like name, address, etc.
@@ -49,10 +112,10 @@ export class OnboardingResource extends BaseResource {
   }
 
   /**
-   * Get current onboarding status
+   * Get current onboarding status by gym ID
    * Check progress and next steps
    */
   async getStatus(gymId: string): Promise<OnboardingStatus> {
     return this.client.get<OnboardingStatus>(`/onboarding/status/${gymId}`);
   }
-}
+}

package/src/types.ts

@@ -9,6 +9,7 @@ export interface GymSpaceConfig {
 export interface RequestOptions {
   gymId?: string;
   headers?: Record<string, string>;
+  skipAuth?: boolean; // Skip Authorization header for public endpoints
 }
 
 export interface PaginationParams {