feat: add suppressGetSessionWarning option to suppress server-side warnings

- Add suppressGetSessionWarning property to GoTrueClientSettings type
- Initialize suppressGetSessionWarning in GoTrueClient constructor
- Add test case to verify warning suppression works correctly
- Mark as experimental feature in JSDoc comments

Author: gonchantech

src/GoTrueClient.ts

@@ -128,6 +128,7 @@ const DEFAULT_OPTIONS: Omit<
   flowType: 'implicit',
   debug: false,
   hasCustomAuthorizationHeader: false,
+  suppressGetSessionWarning: false,
 }
 
 async function lockNoOp<R>(name: string, acquireTimeout: number, fn: () => Promise<R>): Promise<R> {
@@ -234,6 +235,7 @@ export default class GoTrueClient {
     this.detectSessionInUrl = settings.detectSessionInUrl
     this.flowType = settings.flowType
     this.hasCustomAuthorizationHeader = settings.hasCustomAuthorizationHeader
+    this.suppressGetSessionWarning = settings.suppressGetSessionWarning
 
     if (settings.lock) {
       this.lock = settings.lock

src/lib/types.ts

@@ -95,6 +95,11 @@ export type GoTrueClientOptions = {
    * @experimental
    */
   hasCustomAuthorizationHeader?: boolean
+  /**
+   * Set to "true" if you want to suppress the warning when getting a session in server side environments.
+   * @experimental
+   */
+  suppressGetSessionWarning?: boolean
 }
 
 export type WeakPasswordReasons = 'length' | 'characters' | 'pwned' | (string & {})