@insforge/sdk 1.2.1-dev.0 → 1.2.1-dev.2

package/dist/index.mjs

@@ -192,6 +192,95 @@ var Logger = class {
   }
 };
 
+// src/lib/token-manager.ts
+var CSRF_TOKEN_COOKIE = "insforge_csrf_token";
+function getCsrfToken() {
+  if (typeof document === "undefined") return null;
+  const match = document.cookie.split(";").find((c) => c.trim().startsWith(`${CSRF_TOKEN_COOKIE}=`));
+  if (!match) return null;
+  return match.split("=")[1] || null;
+}
+function setCsrfToken(token) {
+  if (typeof document === "undefined") return;
+  const maxAge = 7 * 24 * 60 * 60;
+  const secure = typeof window !== "undefined" && window.location.protocol === "https:" ? "; Secure" : "";
+  document.cookie = `${CSRF_TOKEN_COOKIE}=${encodeURIComponent(token)}; path=/; max-age=${maxAge}; SameSite=Lax${secure}`;
+}
+function clearCsrfToken() {
+  if (typeof document === "undefined") return;
+  const secure = typeof window !== "undefined" && window.location.protocol === "https:" ? "; Secure" : "";
+  document.cookie = `${CSRF_TOKEN_COOKIE}=; path=/; max-age=0; SameSite=Lax${secure}`;
+}
+var TokenManager = class {
+  constructor() {
+    // In-memory storage
+    this.accessToken = null;
+    this.user = null;
+    // Callback for token changes (used by realtime to reconnect with new token)
+    this.onTokenChange = null;
+  }
+  /**
+   * Save session in memory
+   */
+  saveSession(session) {
+    const tokenChanged = session.accessToken !== this.accessToken;
+    this.accessToken = session.accessToken;
+    this.user = session.user;
+    if (tokenChanged && this.onTokenChange) {
+      this.onTokenChange();
+    }
+  }
+  /**
+   * Get current session
+   */
+  getSession() {
+    if (!this.accessToken || !this.user) return null;
+    return {
+      accessToken: this.accessToken,
+      user: this.user
+    };
+  }
+  /**
+   * Get access token
+   */
+  getAccessToken() {
+    return this.accessToken;
+  }
+  /**
+   * Set access token
+   */
+  setAccessToken(token) {
+    const tokenChanged = token !== this.accessToken;
+    this.accessToken = token;
+    if (tokenChanged && this.onTokenChange) {
+      this.onTokenChange();
+    }
+  }
+  /**
+   * Get user
+   */
+  getUser() {
+    return this.user;
+  }
+  /**
+   * Set user
+   */
+  setUser(user) {
+    this.user = user;
+  }
+  /**
+   * Clear in-memory session
+   */
+  clearSession() {
+    const hadToken = this.accessToken !== null;
+    this.accessToken = null;
+    this.user = null;
+    if (hadToken && this.onTokenChange) {
+      this.onTokenChange();
+    }
+  }
+};
+
 // src/lib/http-client.ts
 var RETRYABLE_STATUS_CODES = /* @__PURE__ */ new Set([500, 502, 503, 504]);
 var IDEMPOTENT_METHODS = /* @__PURE__ */ new Set(["GET", "HEAD", "PUT", "DELETE", "OPTIONS"]);
@@ -199,16 +288,23 @@ var HttpClient = class {
   /**
    * Creates a new HttpClient instance.
    * @param config - SDK configuration including baseUrl, timeout, retry settings, and fetch implementation.
+   * @param tokenManager - Token manager for session persistence.
    * @param logger - Optional logger instance for request/response debugging.
    */
-  constructor(config, logger) {
+  constructor(config, tokenManager, logger) {
     this.userToken = null;
+    this.autoRefreshToken = true;
+    this.isRefreshing = false;
+    this.refreshPromise = null;
+    this.refreshToken = null;
     this.baseUrl = config.baseUrl || "http://localhost:7130";
+    this.autoRefreshToken = config.autoRefreshToken ?? true;
     this.fetch = config.fetch || (globalThis.fetch ? globalThis.fetch.bind(globalThis) : void 0);
     this.anonKey = config.anonKey;
     this.defaultHeaders = {
       ...config.headers
     };
+    this.tokenManager = tokenManager ?? new TokenManager();
     this.logger = logger || new Logger(false);
     this.timeout = config.timeout ?? 3e4;
     this.retryCount = config.retryCount ?? 3;
@@ -262,8 +358,14 @@ var HttpClient = class {
    * @returns Parsed response data.
    * @throws {InsForgeError} On timeout, network failure, or HTTP error responses.
    */
-  async request(method, path, options = {}) {
-    const { params, headers = {}, body, signal: callerSignal, ...fetchOptions } = options;
+  async handleRequest(method, path, options = {}) {
+    const {
+      params,
+      headers = {},
+      body,
+      signal: callerSignal,
+      ...fetchOptions
+    } = options;
     const url = this.buildUrl(path, params);
     const startTime = Date.now();
     const canRetry = IDEMPOTENT_METHODS.has(method.toUpperCase()) || options.idempotent === true;
@@ -302,7 +404,9 @@ var HttpClient = class {
     for (let attempt = 0; attempt <= maxAttempts; attempt++) {
       if (attempt > 0) {
         const delay = this.computeRetryDelay(attempt);
-        this.logger.warn(`Retry ${attempt}/${maxAttempts} for ${method} ${url} in ${delay}ms`);
+        this.logger.warn(
+          `Retry ${attempt}/${maxAttempts} for ${method} ${url} in ${delay}ms`
+        );
         if (callerSignal?.aborted) throw callerSignal.reason;
         await new Promise((resolve, reject) => {
           const onAbort = () => {
@@ -310,7 +414,8 @@ var HttpClient = class {
             reject(callerSignal.reason);
           };
           const timer2 = setTimeout(() => {
-            if (callerSignal) callerSignal.removeEventListener("abort", onAbort);
+            if (callerSignal)
+              callerSignal.removeEventListener("abort", onAbort);
             resolve();
           }, delay);
           if (callerSignal) {
@@ -330,10 +435,16 @@ var HttpClient = class {
             controller.abort(callerSignal.reason);
           } else {
             const onCallerAbort = () => controller.abort(callerSignal.reason);
-            callerSignal.addEventListener("abort", onCallerAbort, { once: true });
-            controller.signal.addEventListener("abort", () => {
-              callerSignal.removeEventListener("abort", onCallerAbort);
-            }, { once: true });
+            callerSignal.addEventListener("abort", onCallerAbort, {
+              once: true
+            });
+            controller.signal.addEventListener(
+              "abort",
+              () => {
+                callerSignal.removeEventListener("abort", onCallerAbort);
+              },
+              { once: true }
+            );
           }
         }
       }
@@ -377,7 +488,13 @@ var HttpClient = class {
         }
         if (timer !== void 0) clearTimeout(timer);
         if (!response.ok) {
-          this.logger.logResponse(method, url, response.status, Date.now() - startTime, data);
+          this.logger.logResponse(
+            method,
+            url,
+            response.status,
+            Date.now() - startTime,
+            data
+          );
           if (data && typeof data === "object" && "error" in data) {
             if (!data.statusCode && !data.status) {
               data.statusCode = response.status;
@@ -396,7 +513,13 @@ var HttpClient = class {
             "REQUEST_FAILED"
           );
         }
-        this.logger.logResponse(method, url, response.status, Date.now() - startTime, data);
+        this.logger.logResponse(
+          method,
+          url,
+          response.status,
+          Date.now() - startTime,
+          data
+        );
         return data;
       } catch (err) {
         if (timer !== void 0) clearTimeout(timer);
@@ -430,6 +553,33 @@ var HttpClient = class {
       "NETWORK_ERROR"
     );
   }
+  async request(method, path, options = {}) {
+    try {
+      return await this.handleRequest(method, path, { ...options });
+    } catch (error) {
+      if (error instanceof InsForgeError && error.statusCode === 401 && error.error === "INVALID_TOKEN" && this.autoRefreshToken) {
+        try {
+          const newTokenData = await this.handleTokenRefresh();
+          this.setAuthToken(newTokenData.accessToken);
+          this.tokenManager.saveSession(newTokenData);
+          if (newTokenData.csrfToken) {
+            setCsrfToken(newTokenData.csrfToken);
+          }
+          if (newTokenData.refreshToken) {
+            this.setRefreshToken(newTokenData.refreshToken);
+          }
+          return await this.handleRequest(method, path, { ...options });
+        } catch (error2) {
+          this.tokenManager.clearSession();
+          this.userToken = null;
+          this.refreshToken = null;
+          clearCsrfToken();
+          throw error2;
+        }
+      }
+      throw error;
+    }
+  }
   /** Performs a GET request. */
   get(path, options) {
     return this.request("GET", path, options);
@@ -454,6 +604,9 @@ var HttpClient = class {
   setAuthToken(token) {
     this.userToken = token;
   }
+  setRefreshToken(token) {
+    this.refreshToken = token;
+  }
   /** Returns the current default headers including the authorization header if set. */
   getHeaders() {
     const headers = { ...this.defaultHeaders };
@@ -463,94 +616,31 @@ var HttpClient = class {
     }
     return headers;
   }
-};
-
-// src/lib/token-manager.ts
-var CSRF_TOKEN_COOKIE = "insforge_csrf_token";
-function getCsrfToken() {
-  if (typeof document === "undefined") return null;
-  const match = document.cookie.split(";").find((c) => c.trim().startsWith(`${CSRF_TOKEN_COOKIE}=`));
-  if (!match) return null;
-  return match.split("=")[1] || null;
-}
-function setCsrfToken(token) {
-  if (typeof document === "undefined") return;
-  const maxAge = 7 * 24 * 60 * 60;
-  const secure = typeof window !== "undefined" && window.location.protocol === "https:" ? "; Secure" : "";
-  document.cookie = `${CSRF_TOKEN_COOKIE}=${encodeURIComponent(token)}; path=/; max-age=${maxAge}; SameSite=Lax${secure}`;
-}
-function clearCsrfToken() {
-  if (typeof document === "undefined") return;
-  const secure = typeof window !== "undefined" && window.location.protocol === "https:" ? "; Secure" : "";
-  document.cookie = `${CSRF_TOKEN_COOKIE}=; path=/; max-age=0; SameSite=Lax${secure}`;
-}
-var TokenManager = class {
-  constructor() {
-    // In-memory storage
-    this.accessToken = null;
-    this.user = null;
-    // Callback for token changes (used by realtime to reconnect with new token)
-    this.onTokenChange = null;
-  }
-  /**
-   * Save session in memory
-   */
-  saveSession(session) {
-    const tokenChanged = session.accessToken !== this.accessToken;
-    this.accessToken = session.accessToken;
-    this.user = session.user;
-    if (tokenChanged && this.onTokenChange) {
-      this.onTokenChange();
-    }
-  }
-  /**
-   * Get current session
-   */
-  getSession() {
-    if (!this.accessToken || !this.user) return null;
-    return {
-      accessToken: this.accessToken,
-      user: this.user
-    };
-  }
-  /**
-   * Get access token
-   */
-  getAccessToken() {
-    return this.accessToken;
-  }
-  /**
-   * Set access token
-   */
-  setAccessToken(token) {
-    const tokenChanged = token !== this.accessToken;
-    this.accessToken = token;
-    if (tokenChanged && this.onTokenChange) {
-      this.onTokenChange();
-    }
-  }
-  /**
-   * Get user
-   */
-  getUser() {
-    return this.user;
-  }
-  /**
-   * Set user
-   */
-  setUser(user) {
-    this.user = user;
-  }
-  /**
-   * Clear in-memory session
-   */
-  clearSession() {
-    const hadToken = this.accessToken !== null;
-    this.accessToken = null;
-    this.user = null;
-    if (hadToken && this.onTokenChange) {
-      this.onTokenChange();
+  async handleTokenRefresh() {
+    if (this.isRefreshing) {
+      return this.refreshPromise;
     }
+    this.isRefreshing = true;
+    this.refreshPromise = (async () => {
+      try {
+        const csrfToken = getCsrfToken();
+        const body = this.refreshToken ? { refreshToken: this.refreshToken } : void 0;
+        const response = await this.handleRequest(
+          "POST",
+          "/api/auth/sessions/current",
+          {
+            body,
+            headers: csrfToken ? { "X-CSRF-Token": csrfToken } : {},
+            credentials: "include"
+          }
+        );
+        return response;
+      } finally {
+        this.isRefreshing = false;
+        this.refreshPromise = null;
+      }
+    })();
+    return this.refreshPromise;
   }
 };
 
@@ -639,6 +729,7 @@ var Auth = class {
       this.tokenManager.saveSession(session);
     }
     this.http.setAuthToken(response.accessToken);
+    this.http.setRefreshToken(response.refreshToken ?? null);
     return true;
   }
   // ============================================================================
@@ -646,7 +737,7 @@ var Auth = class {
   // ============================================================================
   /**
    * Detect and handle OAuth callback parameters in URL
-   * Supports PKCE flow (insforge_code) and legacy flow (access_token in URL)
+   * Supports PKCE flow (insforge_code)
    */
   async detectAuthCallback() {
     if (this.isServerMode() || typeof window === "undefined") return;
@@ -667,31 +758,6 @@ var Auth = class {
         }
         return;
       }
-      const accessToken = params.get("access_token");
-      const userId = params.get("user_id");
-      const email = params.get("email");
-      if (accessToken && userId && email) {
-        const csrfToken = params.get("csrf_token");
-        const name = params.get("name");
-        if (csrfToken) {
-          setCsrfToken(csrfToken);
-        }
-        const session = {
-          accessToken,
-          user: {
-            id: userId,
-            email,
-            profile: { name: name || "" },
-            metadata: null,
-            emailVerified: false,
-            createdAt: (/* @__PURE__ */ new Date()).toISOString(),
-            updatedAt: (/* @__PURE__ */ new Date()).toISOString()
-          }
-        };
-        this.tokenManager.saveSession(session);
-        this.http.setAuthToken(accessToken);
-        cleanUrlParams("access_token", "user_id", "email", "name", "csrf_token");
-      }
     } catch (error) {
       console.debug("OAuth callback detection skipped:", error);
     }
@@ -709,6 +775,9 @@ var Auth = class {
       if (response.accessToken && response.user) {
         this.saveSessionFromResponse(response);
       }
+      if (response.refreshToken) {
+        this.http.setRefreshToken(response.refreshToken);
+      }
       return { data: response, error: null };
     } catch (error) {
       return wrapError(error, "An unexpected error occurred during sign up");
@@ -722,6 +791,9 @@ var Auth = class {
         { credentials: "include" }
       );
       this.saveSessionFromResponse(response);
+      if (response.refreshToken) {
+        this.http.setRefreshToken(response.refreshToken);
+      }
       return { data: response, error: null };
     } catch (error) {
       return wrapError(error, "An unexpected error occurred during sign in");
@@ -739,12 +811,15 @@ var Auth = class {
       }
       this.tokenManager.clearSession();
       this.http.setAuthToken(null);
+      this.http.setRefreshToken(null);
       if (!this.isServerMode()) {
         clearCsrfToken();
       }
       return { error: null };
     } catch {
-      return { error: new InsForgeError("Failed to sign out", 500, "SIGNOUT_ERROR") };
+      return {
+        error: new InsForgeError("Failed to sign out", 500, "SIGNOUT_ERROR")
+      };
     }
   }
   // ============================================================================
@@ -766,7 +841,9 @@ var Auth = class {
         providerKey
       );
       const oauthPath = isBuiltInProvider ? `/api/auth/oauth/${providerKey}` : `/api/auth/oauth/custom/${providerKey}`;
-      const response = await this.http.get(oauthPath, { params });
+      const response = await this.http.get(oauthPath, {
+        params
+      });
       if (!this.isServerMode() && typeof window !== "undefined" && !skipBrowserRedirect) {
         window.location.href = response.authUrl;
         return { data: {}, error: null };
@@ -806,7 +883,10 @@ var Auth = class {
           )
         };
       }
-      const request = { code, code_verifier: verifier };
+      const request = {
+        code,
+        code_verifier: verifier
+      };
       const response = await this.http.post(
         this.isServerMode() ? "/api/auth/oauth/exchange?client_type=mobile" : "/api/auth/oauth/exchange",
         request,
@@ -814,16 +894,14 @@ var Auth = class {
       );
       this.saveSessionFromResponse(response);
       return {
-        data: {
-          accessToken: response.accessToken,
-          refreshToken: response.refreshToken,
-          user: response.user,
-          redirectTo: response.redirectTo
-        },
+        data: response,
         error: null
       };
     } catch (error) {
-      return wrapError(error, "An unexpected error occurred during OAuth code exchange");
+      return wrapError(
+        error,
+        "An unexpected error occurred during OAuth code exchange"
+      );
     }
   }
   /**
@@ -842,16 +920,18 @@ var Auth = class {
         { credentials: "include" }
       );
       this.saveSessionFromResponse(response);
+      if (response.refreshToken) {
+        this.http.setRefreshToken(response.refreshToken);
+      }
       return {
-        data: {
-          accessToken: response.accessToken,
-          refreshToken: response.refreshToken,
-          user: response.user
-        },
+        data: response,
         error: null
       };
     } catch (error) {
-      return wrapError(error, "An unexpected error occurred during ID token sign in");
+      return wrapError(
+        error,
+        "An unexpected error occurred during ID token sign in"
+      );
     }
   }
   // ============================================================================
@@ -892,7 +972,10 @@ var Auth = class {
       }
       return { data: response, error: null };
     } catch (error) {
-      return wrapError(error, "An unexpected error occurred during session refresh");
+      return wrapError(
+        error,
+        "An unexpected error occurred during session refresh"
+      );
     }
   }
   /**
@@ -905,7 +988,9 @@ var Auth = class {
         const accessToken = this.tokenManager.getAccessToken();
         if (!accessToken) return { data: { user: null }, error: null };
         this.http.setAuthToken(accessToken);
-        const response = await this.http.get("/api/auth/sessions/current");
+        const response = await this.http.get(
+          "/api/auth/sessions/current"
+        );
         const user = response.user ?? null;
         return { data: { user }, error: null };
       }
@@ -943,24 +1028,38 @@ var Auth = class {
   // ============================================================================
   async getProfile(userId) {
     try {
-      const response = await this.http.get(`/api/auth/profiles/${userId}`);
+      const response = await this.http.get(
+        `/api/auth/profiles/${userId}`
+      );
       return { data: response, error: null };
     } catch (error) {
-      return wrapError(error, "An unexpected error occurred while fetching user profile");
+      return wrapError(
+        error,
+        "An unexpected error occurred while fetching user profile"
+      );
     }
   }
   async setProfile(profile) {
     try {
-      const response = await this.http.patch("/api/auth/profiles/current", {
-        profile
-      });
+      const response = await this.http.patch(
+        "/api/auth/profiles/current",
+        {
+          profile
+        }
+      );
       const currentUser = this.tokenManager.getUser();
       if (!this.isServerMode() && currentUser && response.profile !== void 0) {
-        this.tokenManager.setUser({ ...currentUser, profile: response.profile });
+        this.tokenManager.setUser({
+          ...currentUser,
+          profile: response.profile
+        });
       }
       return { data: response, error: null };
     } catch (error) {
-      return wrapError(error, "An unexpected error occurred while updating user profile");
+      return wrapError(
+        error,
+        "An unexpected error occurred while updating user profile"
+      );
     }
   }
   // ============================================================================
@@ -968,19 +1067,15 @@ var Auth = class {
   // ============================================================================
   async resendVerificationEmail(request) {
     try {
-      const response = await this.http.post(
-        "/api/auth/email/send-verification",
-        request
-      );
+      const response = await this.http.post("/api/auth/email/send-verification", request);
       return { data: response, error: null };
     } catch (error) {
-      return wrapError(error, "An unexpected error occurred while sending verification code");
+      return wrapError(
+        error,
+        "An unexpected error occurred while sending verification email"
+      );
     }
   }
-  /** @deprecated Use `resendVerificationEmail` instead */
-  async sendVerificationEmail(request) {
-    return this.resendVerificationEmail(request);
-  }
   async verifyEmail(request) {
     try {
       const response = await this.http.post(
@@ -989,9 +1084,15 @@ var Auth = class {
         { credentials: "include" }
       );
       this.saveSessionFromResponse(response);
+      if (response.refreshToken) {
+        this.http.setRefreshToken(response.refreshToken);
+      }
       return { data: response, error: null };
     } catch (error) {
-      return wrapError(error, "An unexpected error occurred while verifying email");
+      return wrapError(
+        error,
+        "An unexpected error occurred while verifying email"
+      );
     }
   }
   // ============================================================================
@@ -999,13 +1100,13 @@ var Auth = class {
   // ============================================================================
   async sendResetPasswordEmail(request) {
     try {
-      const response = await this.http.post(
-        "/api/auth/email/send-reset-password",
-        request
-      );
+      const response = await this.http.post("/api/auth/email/send-reset-password", request);
       return { data: response, error: null };
     } catch (error) {
-      return wrapError(error, "An unexpected error occurred while sending password reset code");
+      return wrapError(
+        error,
+        "An unexpected error occurred while sending password reset email"
+      );
     }
   }
   async exchangeResetPasswordToken(request) {
@@ -1016,7 +1117,10 @@ var Auth = class {
       );
       return { data: response, error: null };
     } catch (error) {
-      return wrapError(error, "An unexpected error occurred while verifying reset code");
+      return wrapError(
+        error,
+        "An unexpected error occurred while verifying reset code"
+      );
     }
   }
   async resetPassword(request) {
@@ -1027,7 +1131,10 @@ var Auth = class {
       );
       return { data: response, error: null };
     } catch (error) {
-      return wrapError(error, "An unexpected error occurred while resetting password");
+      return wrapError(
+        error,
+        "An unexpected error occurred while resetting password"
+      );
     }
   }
   // ============================================================================
@@ -1035,10 +1142,15 @@ var Auth = class {
   // ============================================================================
   async getPublicAuthConfig() {
     try {
-      const response = await this.http.get("/api/auth/public-config");
+      const response = await this.http.get(
+        "/api/auth/public-config"
+      );
       return { data: response, error: null };
     } catch (error) {
-      return wrapError(error, "An unexpected error occurred while fetching auth configuration");
+      return wrapError(
+        error,
+        "An unexpected error occurred while fetching auth configuration"
+      );
     }
   }
 };
@@ -1784,9 +1896,17 @@ var Functions = class _Functions {
         });
         return { data, error: null };
       } catch (error) {
-        if (error?.statusCode === 404) {
+        if (error instanceof Error && error.name === "AbortError") throw error;
+        if (error instanceof InsForgeError && error.statusCode === 404) {
         } else {
-          return { data: null, error };
+          return {
+            data: null,
+            error: error instanceof InsForgeError ? error : new InsForgeError(
+              error instanceof Error ? error.message : "Function invocation failed",
+              500,
+              "FUNCTION_ERROR"
+            )
+          };
         }
       }
     }
@@ -1795,7 +1915,15 @@ var Functions = class _Functions {
       const data = await this.http.request(method, path, { body, headers });
       return { data, error: null };
     } catch (error) {
-      return { data: null, error };
+      if (error instanceof Error && error.name === "AbortError") throw error;
+      return {
+        data: null,
+        error: error instanceof InsForgeError ? error : new InsForgeError(
+          error instanceof Error ? error.message : "Function invocation failed",
+          500,
+          "FUNCTION_ERROR"
+        )
+      };
     }
   }
 };
@@ -2066,8 +2194,15 @@ var Emails = class {
       );
       return { data, error: null };
     } catch (error) {
-      const normalizedError = error instanceof Error ? error : new Error(String(error));
-      return { data: null, error: normalizedError };
+      if (error instanceof Error && error.name === "AbortError") throw error;
+      return {
+        data: null,
+        error: error instanceof InsForgeError ? error : new InsForgeError(
+          error instanceof Error ? error.message : "Email send failed",
+          500,
+          "EMAIL_ERROR"
+        )
+      };
     }
   }
 };
@@ -2076,8 +2211,8 @@ var Emails = class {
 var InsForgeClient = class {
   constructor(config = {}) {
     const logger = new Logger(config.debug);
-    this.http = new HttpClient(config, logger);
     this.tokenManager = new TokenManager();
+    this.http = new HttpClient(config, this.tokenManager, logger);
     if (config.edgeFunctionToken) {
       this.http.setAuthToken(config.edgeFunctionToken);
       this.tokenManager.setAccessToken(config.edgeFunctionToken);
@@ -2089,12 +2224,16 @@ var InsForgeClient = class {
     this.storage = new Storage(this.http);
     this.ai = new AI(this.http);
     this.functions = new Functions(this.http, config.functionsUrl);
-    this.realtime = new Realtime(this.http.baseUrl, this.tokenManager, config.anonKey);
+    this.realtime = new Realtime(
+      this.http.baseUrl,
+      this.tokenManager,
+      config.anonKey
+    );
     this.emails = new Emails(this.http);
   }
   /**
    * Get the underlying HTTP client for custom requests
-   * 
+   *
    * @example
    * ```typescript
    * const httpClient = client.getHttpClient();