@scalemule/nextjs 0.0.3 → 0.0.5

package/dist/client.d.mts

@@ -28,6 +28,12 @@ interface ClientConfig {
     enableRateLimitQueue?: boolean;
     /** Enable offline queue (queues requests when offline, syncs when back online) */
     enableOfflineQueue?: boolean;
+    /**
+     * Signal that a session will be established asynchronously (e.g. via auth proxy).
+     * When true, API requests will wait for the session to be resolved before sending,
+     * preventing race conditions where requests fire before the auth token is available.
+     */
+    pendingSessionInit?: boolean;
 }
 interface RequestOptions extends RequestInit {
     /** Skip adding auth headers (for public endpoints) */
@@ -56,6 +62,8 @@ declare class ScaleMuleClient {
     private offlineQueue;
     private enableRateLimitQueue;
     private enableOfflineQueue;
+    private sessionGate;
+    private resolveSessionGate;
     constructor(config: ClientConfig);
     /**
      * Sync offline queue when coming back online
@@ -85,6 +93,16 @@ declare class ScaleMuleClient {
      * Get the application ID (required for realtime features)
      */
     getApplicationId(): string | null;
+    /**
+     * Signal that a session is being established asynchronously.
+     * API requests will wait until resolveSessionPending() is called.
+     */
+    setSessionPending(): void;
+    /**
+     * Resolve the pending session gate, allowing queued API requests to proceed.
+     * Must be called after setSessionPending(), whether session was established or not.
+     */
+    resolveSessionPending(): void;
     /**
      * Initialize client by loading persisted session
      */

package/dist/client.d.ts

@@ -28,6 +28,12 @@ interface ClientConfig {
     enableRateLimitQueue?: boolean;
     /** Enable offline queue (queues requests when offline, syncs when back online) */
     enableOfflineQueue?: boolean;
+    /**
+     * Signal that a session will be established asynchronously (e.g. via auth proxy).
+     * When true, API requests will wait for the session to be resolved before sending,
+     * preventing race conditions where requests fire before the auth token is available.
+     */
+    pendingSessionInit?: boolean;
 }
 interface RequestOptions extends RequestInit {
     /** Skip adding auth headers (for public endpoints) */
@@ -56,6 +62,8 @@ declare class ScaleMuleClient {
     private offlineQueue;
     private enableRateLimitQueue;
     private enableOfflineQueue;
+    private sessionGate;
+    private resolveSessionGate;
     constructor(config: ClientConfig);
     /**
      * Sync offline queue when coming back online
@@ -85,6 +93,16 @@ declare class ScaleMuleClient {
      * Get the application ID (required for realtime features)
      */
     getApplicationId(): string | null;
+    /**
+     * Signal that a session is being established asynchronously.
+     * API requests will wait until resolveSessionPending() is called.
+     */
+    setSessionPending(): void;
+    /**
+     * Resolve the pending session gate, allowing queued API requests to proceed.
+     * Must be called after setSessionPending(), whether session was established or not.
+     */
+    resolveSessionPending(): void;
     /**
      * Initialize client by loading persisted session
      */

package/dist/client.js

@@ -273,6 +273,8 @@ var ScaleMuleClient = class {
     this.userId = null;
     this.rateLimitQueue = null;
     this.offlineQueue = null;
+    this.sessionGate = null;
+    this.resolveSessionGate = null;
     this.apiKey = config.apiKey;
     this.applicationId = config.applicationId || null;
     this.gatewayUrl = resolveGatewayUrl(config);
@@ -287,6 +289,9 @@ var ScaleMuleClient = class {
       this.offlineQueue = new OfflineQueue(this.storage);
       this.offlineQueue.setOnlineCallback(() => this.syncOfflineQueue());
     }
+    if (config.pendingSessionInit) {
+      this.setSessionPending();
+    }
   }
   /**
    * Sync offline queue when coming back online
@@ -352,6 +357,28 @@ var ScaleMuleClient = class {
   getApplicationId() {
     return this.applicationId;
   }
+  /**
+   * Signal that a session is being established asynchronously.
+   * API requests will wait until resolveSessionPending() is called.
+   */
+  setSessionPending() {
+    if (!this.sessionGate) {
+      this.sessionGate = new Promise((resolve) => {
+        this.resolveSessionGate = resolve;
+      });
+    }
+  }
+  /**
+   * Resolve the pending session gate, allowing queued API requests to proceed.
+   * Must be called after setSessionPending(), whether session was established or not.
+   */
+  resolveSessionPending() {
+    if (this.resolveSessionGate) {
+      this.resolveSessionGate();
+      this.resolveSessionGate = null;
+      this.sessionGate = null;
+    }
+  }
   /**
    * Initialize client by loading persisted session
    */
@@ -360,6 +387,9 @@ var ScaleMuleClient = class {
     const userId = await this.storage.getItem(USER_ID_STORAGE_KEY);
     if (token) this.sessionToken = token;
     if (userId) this.userId = userId;
+    if (token) {
+      this.resolveSessionPending();
+    }
     if (this.debug) {
       console.log("[ScaleMule] Initialized with session:", !!token);
     }
@@ -424,6 +454,9 @@ var ScaleMuleClient = class {
    * Make an HTTP request to the ScaleMule API
    */
   async request(path, options = {}) {
+    if (this.sessionGate) {
+      await this.sessionGate;
+    }
     const url = `${this.gatewayUrl}${path}`;
     const headers = this.buildHeaders(options);
     const maxRetries = options.skipRetry ? 0 : options.retries ?? 2;

package/dist/client.mjs

@@ -271,6 +271,8 @@ var ScaleMuleClient = class {
     this.userId = null;
     this.rateLimitQueue = null;
     this.offlineQueue = null;
+    this.sessionGate = null;
+    this.resolveSessionGate = null;
     this.apiKey = config.apiKey;
     this.applicationId = config.applicationId || null;
     this.gatewayUrl = resolveGatewayUrl(config);
@@ -285,6 +287,9 @@ var ScaleMuleClient = class {
       this.offlineQueue = new OfflineQueue(this.storage);
       this.offlineQueue.setOnlineCallback(() => this.syncOfflineQueue());
     }
+    if (config.pendingSessionInit) {
+      this.setSessionPending();
+    }
   }
   /**
    * Sync offline queue when coming back online
@@ -350,6 +355,28 @@ var ScaleMuleClient = class {
   getApplicationId() {
     return this.applicationId;
   }
+  /**
+   * Signal that a session is being established asynchronously.
+   * API requests will wait until resolveSessionPending() is called.
+   */
+  setSessionPending() {
+    if (!this.sessionGate) {
+      this.sessionGate = new Promise((resolve) => {
+        this.resolveSessionGate = resolve;
+      });
+    }
+  }
+  /**
+   * Resolve the pending session gate, allowing queued API requests to proceed.
+   * Must be called after setSessionPending(), whether session was established or not.
+   */
+  resolveSessionPending() {
+    if (this.resolveSessionGate) {
+      this.resolveSessionGate();
+      this.resolveSessionGate = null;
+      this.sessionGate = null;
+    }
+  }
   /**
    * Initialize client by loading persisted session
    */
@@ -358,6 +385,9 @@ var ScaleMuleClient = class {
     const userId = await this.storage.getItem(USER_ID_STORAGE_KEY);
     if (token) this.sessionToken = token;
     if (userId) this.userId = userId;
+    if (token) {
+      this.resolveSessionPending();
+    }
     if (this.debug) {
       console.log("[ScaleMule] Initialized with session:", !!token);
     }
@@ -422,6 +452,9 @@ var ScaleMuleClient = class {
    * Make an HTTP request to the ScaleMule API
    */
   async request(path, options = {}) {
+    if (this.sessionGate) {
+      await this.sessionGate;
+    }
     const url = `${this.gatewayUrl}${path}`;
     const headers = this.buildHeaders(options);
     const maxRetries = options.skipRetry ? 0 : options.retries ?? 2;

package/dist/index.js

@@ -278,6 +278,8 @@ var ScaleMuleClient = class {
     this.userId = null;
     this.rateLimitQueue = null;
     this.offlineQueue = null;
+    this.sessionGate = null;
+    this.resolveSessionGate = null;
     this.apiKey = config.apiKey;
     this.applicationId = config.applicationId || null;
     this.gatewayUrl = resolveGatewayUrl(config);
@@ -292,6 +294,9 @@ var ScaleMuleClient = class {
       this.offlineQueue = new OfflineQueue(this.storage);
       this.offlineQueue.setOnlineCallback(() => this.syncOfflineQueue());
     }
+    if (config.pendingSessionInit) {
+      this.setSessionPending();
+    }
   }
   /**
    * Sync offline queue when coming back online
@@ -357,6 +362,28 @@ var ScaleMuleClient = class {
   getApplicationId() {
     return this.applicationId;
   }
+  /**
+   * Signal that a session is being established asynchronously.
+   * API requests will wait until resolveSessionPending() is called.
+   */
+  setSessionPending() {
+    if (!this.sessionGate) {
+      this.sessionGate = new Promise((resolve) => {
+        this.resolveSessionGate = resolve;
+      });
+    }
+  }
+  /**
+   * Resolve the pending session gate, allowing queued API requests to proceed.
+   * Must be called after setSessionPending(), whether session was established or not.
+   */
+  resolveSessionPending() {
+    if (this.resolveSessionGate) {
+      this.resolveSessionGate();
+      this.resolveSessionGate = null;
+      this.sessionGate = null;
+    }
+  }
   /**
    * Initialize client by loading persisted session
    */
@@ -365,6 +392,9 @@ var ScaleMuleClient = class {
     const userId = await this.storage.getItem(USER_ID_STORAGE_KEY);
     if (token) this.sessionToken = token;
     if (userId) this.userId = userId;
+    if (token) {
+      this.resolveSessionPending();
+    }
     if (this.debug) {
       console.log("[ScaleMule] Initialized with session:", !!token);
     }
@@ -429,6 +459,9 @@ var ScaleMuleClient = class {
    * Make an HTTP request to the ScaleMule API
    */
   async request(path, options = {}) {
+    if (this.sessionGate) {
+      await this.sessionGate;
+    }
     const url = `${this.gatewayUrl}${path}`;
     const headers = this.buildHeaders(options);
     const maxRetries = options.skipRetry ? 0 : options.retries ?? 2;
@@ -765,9 +798,10 @@ function ScaleMuleProvider({
       environment,
       gatewayUrl,
       debug,
-      storage
+      storage,
+      pendingSessionInit: !!authProxyUrl
     }),
-    [apiKey, applicationId, environment, gatewayUrl, debug, storage]
+    [apiKey, applicationId, environment, gatewayUrl, debug, storage, authProxyUrl]
   );
   react.useEffect(() => {
     let mounted = true;
@@ -789,6 +823,9 @@ function ScaleMuleProvider({
               if (data.success && data.data?.user) {
                 setUser(data.data.user);
                 setCachedUser(data.data.user);
+                if (data.data.sessionToken) {
+                  await client.setSession(data.data.sessionToken, data.data.userId || "");
+                }
               } else {
                 setUser(null);
                 setCachedUser(null);
@@ -798,6 +835,8 @@ function ScaleMuleProvider({
             if (mounted && debug) {
               console.debug("[ScaleMule] Auth proxy session check failed");
             }
+          } finally {
+            client.resolveSessionPending();
           }
         } else if (client.isAuthenticated()) {
           if (cachedUser && mounted) {

package/dist/index.mjs

@@ -276,6 +276,8 @@ var ScaleMuleClient = class {
     this.userId = null;
     this.rateLimitQueue = null;
     this.offlineQueue = null;
+    this.sessionGate = null;
+    this.resolveSessionGate = null;
     this.apiKey = config.apiKey;
     this.applicationId = config.applicationId || null;
     this.gatewayUrl = resolveGatewayUrl(config);
@@ -290,6 +292,9 @@ var ScaleMuleClient = class {
       this.offlineQueue = new OfflineQueue(this.storage);
       this.offlineQueue.setOnlineCallback(() => this.syncOfflineQueue());
     }
+    if (config.pendingSessionInit) {
+      this.setSessionPending();
+    }
   }
   /**
    * Sync offline queue when coming back online
@@ -355,6 +360,28 @@ var ScaleMuleClient = class {
   getApplicationId() {
     return this.applicationId;
   }
+  /**
+   * Signal that a session is being established asynchronously.
+   * API requests will wait until resolveSessionPending() is called.
+   */
+  setSessionPending() {
+    if (!this.sessionGate) {
+      this.sessionGate = new Promise((resolve) => {
+        this.resolveSessionGate = resolve;
+      });
+    }
+  }
+  /**
+   * Resolve the pending session gate, allowing queued API requests to proceed.
+   * Must be called after setSessionPending(), whether session was established or not.
+   */
+  resolveSessionPending() {
+    if (this.resolveSessionGate) {
+      this.resolveSessionGate();
+      this.resolveSessionGate = null;
+      this.sessionGate = null;
+    }
+  }
   /**
    * Initialize client by loading persisted session
    */
@@ -363,6 +390,9 @@ var ScaleMuleClient = class {
     const userId = await this.storage.getItem(USER_ID_STORAGE_KEY);
     if (token) this.sessionToken = token;
     if (userId) this.userId = userId;
+    if (token) {
+      this.resolveSessionPending();
+    }
     if (this.debug) {
       console.log("[ScaleMule] Initialized with session:", !!token);
     }
@@ -427,6 +457,9 @@ var ScaleMuleClient = class {
    * Make an HTTP request to the ScaleMule API
    */
   async request(path, options = {}) {
+    if (this.sessionGate) {
+      await this.sessionGate;
+    }
     const url = `${this.gatewayUrl}${path}`;
     const headers = this.buildHeaders(options);
     const maxRetries = options.skipRetry ? 0 : options.retries ?? 2;
@@ -763,9 +796,10 @@ function ScaleMuleProvider({
       environment,
       gatewayUrl,
       debug,
-      storage
+      storage,
+      pendingSessionInit: !!authProxyUrl
     }),
-    [apiKey, applicationId, environment, gatewayUrl, debug, storage]
+    [apiKey, applicationId, environment, gatewayUrl, debug, storage, authProxyUrl]
   );
   useEffect(() => {
     let mounted = true;
@@ -787,6 +821,9 @@ function ScaleMuleProvider({
               if (data.success && data.data?.user) {
                 setUser(data.data.user);
                 setCachedUser(data.data.user);
+                if (data.data.sessionToken) {
+                  await client.setSession(data.data.sessionToken, data.data.userId || "");
+                }
               } else {
                 setUser(null);
                 setCachedUser(null);
@@ -796,6 +833,8 @@ function ScaleMuleProvider({
             if (mounted && debug) {
               console.debug("[ScaleMule] Auth proxy session check failed");
             }
+          } finally {
+            client.resolveSessionPending();
           }
         } else if (client.isAuthenticated()) {
           if (cachedUser && mounted) {

package/dist/server/auth.js

@@ -1028,7 +1028,7 @@ function createAuthRoutes(config = {}) {
               cookieOptions
             );
           }
-          return successResponse({ user: userData });
+          return successResponse({ user: userData, sessionToken: session.sessionToken, userId: session.userId });
         }
         // ==================== Get Session Status ====================
         case "session": {

package/dist/server/auth.mjs

@@ -1026,7 +1026,7 @@ function createAuthRoutes(config = {}) {
               cookieOptions
             );
           }
-          return successResponse({ user: userData });
+          return successResponse({ user: userData, sessionToken: session.sessionToken, userId: session.userId });
         }
         // ==================== Get Session Status ====================
         case "session": {

package/dist/server/index.js

@@ -1245,7 +1245,7 @@ function createAuthRoutes(config = {}) {
               cookieOptions
             );
           }
-          return successResponse({ user: userData });
+          return successResponse({ user: userData, sessionToken: session.sessionToken, userId: session.userId });
         }
         // ==================== Get Session Status ====================
         case "session": {

package/dist/server/index.mjs

@@ -1243,7 +1243,7 @@ function createAuthRoutes(config = {}) {
               cookieOptions
             );
           }
-          return successResponse({ user: userData });
+          return successResponse({ user: userData, sessionToken: session.sessionToken, userId: session.userId });
         }
         // ==================== Get Session Status ====================
         case "session": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scalemule/nextjs",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "ScaleMule SDK for Next.js applications - authentication, storage, and user management",
   "main": "dist/index.js",
   "module": "dist/index.mjs",