@nauth-toolkit/client 0.1.65 → 0.1.67

package/dist/index.d.mts

@@ -680,6 +680,44 @@ interface NAuthClientConfig {
      * base URL that points to the JSON-based mobile auth endpoints.
      */
     baseUrl: string;
+    /**
+     * Optional path prefix automatically prepended to all endpoint paths.
+     * Simplifies configuration when all auth endpoints share a common prefix.
+     *
+     * Benefits:
+     * - Avoids repeating `/auth` in every endpoint path or having to give it if using default endpoints in backend.
+     * - Cleaner endpoint configuration
+     * - Easier to change the auth path globally
+     *
+     * Note: Authorization tokens are still sent to ALL requests matching `baseUrl`,
+     * regardless of this prefix. This is a convenience feature, not a security boundary.
+     *
+     * @example Without authPathPrefix (verbose)
+     * ```typescript
+     * {
+     *   baseUrl: 'https://api.example.com',
+     *   endpoints: {
+     *     profile: '/auth/profile',
+     *     login: '/auth/login/mobile',
+     *     mfaStatus: '/auth/mfa/status',
+     *   }
+     * }
+     * ```
+     *
+     * @example With authPathPrefix (clean)
+     * ```typescript
+     * {
+     *   baseUrl: 'https://api.example.com',
+     *   authPathPrefix: '/auth',
+     *   endpoints: {
+     *     profile: '/profile',          // SDK builds: /auth/profile
+     *     login: '/login/mobile',       // SDK builds: /auth/login/mobile
+     *     mfaStatus: '/mfa/status',     // SDK builds: /auth/mfa/status
+     *   }
+     * }
+     * ```
+     */
+    authPathPrefix?: string;
     /**
      * How tokens are delivered between client and server.
      *
@@ -1651,6 +1689,7 @@ declare class NAuthClient {
     private getTokenDeliveryMode;
     /**
      * Build request URL by combining baseUrl with path.
+     * Automatically prepends authPathPrefix if configured and not already in path or baseUrl.
      * @private
      */
     private buildUrl;

package/dist/index.d.ts

@@ -680,6 +680,44 @@ interface NAuthClientConfig {
      * base URL that points to the JSON-based mobile auth endpoints.
      */
     baseUrl: string;
+    /**
+     * Optional path prefix automatically prepended to all endpoint paths.
+     * Simplifies configuration when all auth endpoints share a common prefix.
+     *
+     * Benefits:
+     * - Avoids repeating `/auth` in every endpoint path or having to give it if using default endpoints in backend.
+     * - Cleaner endpoint configuration
+     * - Easier to change the auth path globally
+     *
+     * Note: Authorization tokens are still sent to ALL requests matching `baseUrl`,
+     * regardless of this prefix. This is a convenience feature, not a security boundary.
+     *
+     * @example Without authPathPrefix (verbose)
+     * ```typescript
+     * {
+     *   baseUrl: 'https://api.example.com',
+     *   endpoints: {
+     *     profile: '/auth/profile',
+     *     login: '/auth/login/mobile',
+     *     mfaStatus: '/auth/mfa/status',
+     *   }
+     * }
+     * ```
+     *
+     * @example With authPathPrefix (clean)
+     * ```typescript
+     * {
+     *   baseUrl: 'https://api.example.com',
+     *   authPathPrefix: '/auth',
+     *   endpoints: {
+     *     profile: '/profile',          // SDK builds: /auth/profile
+     *     login: '/login/mobile',       // SDK builds: /auth/login/mobile
+     *     mfaStatus: '/mfa/status',     // SDK builds: /auth/mfa/status
+     *   }
+     * }
+     * ```
+     */
+    authPathPrefix?: string;
     /**
      * How tokens are delivered between client and server.
      *
@@ -1651,6 +1689,7 @@ declare class NAuthClient {
     private getTokenDeliveryMode;
     /**
      * Build request URL by combining baseUrl with path.
+     * Automatically prepends authPathPrefix if configured and not already in path or baseUrl.
      * @private
      */
     private buildUrl;

package/dist/index.mjs

@@ -314,10 +314,13 @@ var TokenManager = class {
    *
    * @param refreshFn - function performing refresh request
    */
-  async refreshOnce(refreshFn) {
+  async refreshOnce(refreshFn, options) {
+    const shouldPersist = options?.persist !== false;
     if (!this.refreshPromise) {
       this.refreshPromise = refreshFn().then(async (tokens) => {
-        await this.setTokens(tokens);
+        if (shouldPersist) {
+          await this.setTokens(tokens);
+        }
         return tokens;
       }).catch((error) => {
         throw error;
@@ -784,7 +787,7 @@ var NAuthClient = class {
     const refreshFn = async () => {
       return this.post(this.config.endpoints.refresh, body, false);
     };
-    const tokens = await this.tokenManager.refreshOnce(refreshFn);
+    const tokens = await this.tokenManager.refreshOnce(refreshFn, { persist: tokenDelivery === "json" });
     this.config.onTokenRefresh?.();
     this.eventEmitter.emit({ type: "auth:refresh", data: { success: true }, timestamp: Date.now() });
     return tokens;
@@ -1425,10 +1428,15 @@ var NAuthClient = class {
   }
   /**
    * Build request URL by combining baseUrl with path.
+   * Automatically prepends authPathPrefix if configured and not already in path or baseUrl.
    * @private
    */
   buildUrl(path) {
-    return `${this.config.baseUrl}${path}`;
+    const normalizedPath = path.startsWith("/") ? path : `/${path}`;
+    const baseUrlEndsWithPrefix = this.config.authPathPrefix && this.config.baseUrl.endsWith(this.config.authPathPrefix);
+    const effectivePath = this.config.authPathPrefix && !baseUrlEndsWithPrefix && !normalizedPath.startsWith(this.config.authPathPrefix) ? `${this.config.authPathPrefix}${normalizedPath}` : normalizedPath;
+    const normalizedBaseUrl = this.config.baseUrl.endsWith("/") ? this.config.baseUrl.slice(0, -1) : this.config.baseUrl;
+    return `${normalizedBaseUrl}${effectivePath}`;
   }
   /**
    * Build request headers for authentication.