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 & {})

test/GoTrueClient.test.ts

@@ -1694,6 +1694,35 @@ describe('GoTrueClient with storageisServer = true', () => {
     expect(warnings.length).toEqual(0)
   })
 
+  test('getSession emits no warnings when suppressGetSessionWarning is set to true', async () => {
+    const storage = memoryLocalStorageAdapter({
+      [STORAGE_KEY]: JSON.stringify({
+        access_token: 'jwt.accesstoken.signature',
+        refresh_token: 'refresh-token',
+        token_type: 'bearer',
+        expires_in: 1000,
+        expires_at: Date.now() / 1000 + 1000,
+        user: {
+          id: 'random-user-id',
+        },
+      }),
+    })
+    storage.isServer = true
+
+    const client = new GoTrueClient({
+      storage,
+      suppressGetSessionWarning: true,
+    })
+
+    const {
+      data: { session },
+    } = await client.getSession()
+
+    const user = session?.user // accessing the user object from getSession shouldn't emit a warning
+    expect(user).not.toBeNull()
+    expect(warnings.length).toEqual(0)
+  })
+
   test('saveSession should overwrite the existing session', async () => {
     const store = memoryLocalStorageAdapter()
     const client = new GoTrueClient({