@stackframe/stack 2.4.16 → 2.4.18

package/dist/lib/stack-app.js

@@ -45,7 +45,7 @@ var import_results = require("@stackframe/stack-shared/dist/utils/results");
 var import_react2 = require("@stackframe/stack-shared/dist/utils/react");
 var import_stores = require("@stackframe/stack-shared/dist/utils/stores");
 var import_clientInterface = require("@stackframe/stack-shared/dist/interface/clientInterface");
-var import_next = require("../utils/next");
+var import_env = require("@stackframe/stack-shared/src/utils/env");
 var import_auth = require("./auth");
 var NextNavigationUnscrambled = __toESM(require("next/navigation"));
 var import_url = require("../utils/url");
@@ -56,8 +56,10 @@ var import_react3 = require("@stackframe/stack-shared/dist/utils/react");
 var import_compile_time = require("@stackframe/stack-shared/dist/utils/compile-time");
 var import_stack_sc = require("@stackframe/stack-sc");
 var cookie = __toESM(require("cookie"));
+var import_sessions = require("@stackframe/stack-shared/dist/sessions");
+var import_use_trigger = require("@stackframe/stack-shared/dist/hooks/use-trigger");
 var NextNavigation = (0, import_compile_time.scrambleDuringCompileTime)(NextNavigationUnscrambled);
-var clientVersion = "js @stackframe/stack@2.4.16";
+var clientVersion = "js @stackframe/stack@2.4.18";
 function permissionDefinitionScopeToType(scope) {
   return { "any-team": "team", "specific-team": "team", "global": "global" }[scope.type];
 }
@@ -98,45 +100,50 @@ function getDefaultBaseUrl() {
 }
 var defaultBaseUrl = "https://app.stack-auth.com";
 function createEmptyTokenStore() {
-  return new import_stores.AsyncStore({
+  return new import_stores.Store({
     refreshToken: null,
     accessToken: null
   });
 }
-var cookieTokenStore = null;
-var cookieTokenStoreInitializer = () => {
-  if (!(0, import_next.isClient)()) {
+var storedCookieTokenStore = null;
+var getCookieTokenStore = () => {
+  if (!(0, import_env.isBrowserLike)()) {
     throw new Error("Cannot use cookie token store on the server!");
   }
-  if (cookieTokenStore === null) {
-    cookieTokenStore = new import_stores.AsyncStore();
+  if (storedCookieTokenStore === null) {
+    const getCurrentValue = () => ({
+      refreshToken: (0, import_cookie.getCookie)("stack-refresh"),
+      accessToken: (0, import_cookie.getCookie)("stack-access")
+    });
+    storedCookieTokenStore = new import_stores.Store(getCurrentValue());
     let hasSucceededInWriting = true;
     setInterval(() => {
       if (hasSucceededInWriting) {
-        const newValue = {
-          refreshToken: (0, import_cookie.getCookie)("stack-refresh"),
-          accessToken: (0, import_cookie.getCookie)("stack-access")
-        };
-        const res = cookieTokenStore.get();
-        if (res.status !== "ok" || res.data.refreshToken !== newValue.refreshToken || res.data.accessToken !== newValue.accessToken) {
-          cookieTokenStore.set(newValue);
+        const currentValue = getCurrentValue();
+        const oldValue = storedCookieTokenStore.get();
+        if (JSON.stringify(currentValue) !== JSON.stringify(oldValue)) {
+          storedCookieTokenStore.set(currentValue);
         }
       }
-    }, 10);
-    cookieTokenStore.onChange((value) => {
+    }, 100);
+    storedCookieTokenStore.onChange((value) => {
       try {
         (0, import_cookie.setOrDeleteCookie)("stack-refresh", value.refreshToken, { maxAge: 60 * 60 * 24 * 365 });
         (0, import_cookie.setOrDeleteCookie)("stack-access", value.accessToken, { maxAge: 60 * 60 * 24 });
         hasSucceededInWriting = true;
       } catch (e) {
-        hasSucceededInWriting = false;
+        if (!(0, import_env.isBrowserLike)()) {
+          hasSucceededInWriting = false;
+        } else {
+          throw e;
+        }
       }
     });
   }
-  return cookieTokenStore;
+  return storedCookieTokenStore;
 };
 var loadingSentinel = Symbol("stackAppCacheLoadingSentinel");
-function useCache(cache, dependencies, caller) {
+function useAsyncCache(cache, dependencies, caller) {
   (0, import_react2.suspendIfSsr)(caller);
   const subscribe = (0, import_react.useCallback)((cb) => {
     const { unsubscribe } = cache.onChange(dependencies, () => cb());
@@ -160,17 +167,13 @@ var createCache = (fetcher) => {
     {}
   );
 };
-var createCacheByTokenStore = (fetcher) => {
+var createCacheBySession = (fetcher) => {
   return new import_caches.AsyncCache(
-    async ([tokenStore, ...extraDependencies]) => await fetcher(tokenStore, extraDependencies),
+    async ([session, ...extraDependencies]) => await fetcher(session, extraDependencies),
     {
-      onSubscribe: ([tokenStore], refresh) => {
-        const handlerObj = tokenStore.onChange((newValue, oldValue) => {
-          if (newValue.refreshToken === oldValue?.refreshToken)
-            return;
-          refresh();
-        });
-        return () => handlerObj.unsubscribe();
+      onSubscribe: ([session], refresh) => {
+        const handler = session.onInvalidate(() => refresh());
+        return () => handler.unsubscribe();
       }
     }
   );
@@ -197,7 +200,7 @@ var _StackClientAppImpl = class __StackClientAppImpl {
     }
     numberOfAppsCreated++;
     if (numberOfAppsCreated > 10) {
-      console.warn(`You have created more than 10 Stack apps (${numberOfAppsCreated}). This is usually a sign of a memory leak. Make sure to minimize the number of Stack apps per page (usually, one per project).`);
+      (process.env.NODE_ENV === "development" ? console.log : console.warn)(`You have created more than 10 Stack apps (${numberOfAppsCreated}). This is usually a sign of a memory leak, but can sometimes be caused by hot reload of your tech stack. In production, make sure to minimize the number of Stack apps per page (usually, one per project).`);
     }
   }
   _uniqueIdentifier = void 0;
@@ -205,24 +208,24 @@ var _StackClientAppImpl = class __StackClientAppImpl {
   _tokenStoreInit;
   _urlOptions;
   __DEMO_ENABLE_SLIGHT_FETCH_DELAY = false;
-  _currentUserCache = createCacheByTokenStore(async (tokenStore) => {
+  _currentUserCache = createCacheBySession(async (session) => {
     if (this.__DEMO_ENABLE_SLIGHT_FETCH_DELAY) {
       await (0, import_promises.wait)(2e3);
     }
-    const user = await this._interface.getClientUserByToken(tokenStore);
+    const user = await this._interface.getClientUserByToken(session);
     return import_results.Result.or(user, null);
   });
   _currentProjectCache = createCache(async () => {
     return import_results.Result.orThrow(await this._interface.getClientProject());
   });
-  _ownedProjectsCache = createCacheByTokenStore(async (tokenStore) => {
-    return await this._interface.listProjects(tokenStore);
+  _ownedProjectsCache = createCacheBySession(async (session) => {
+    return await this._interface.listProjects(session);
   });
-  _currentUserPermissionsCache = createCacheByTokenStore(async (tokenStore, [teamId, type, direct]) => {
-    return await this._interface.listClientUserTeamPermissions({ teamId, type, direct }, tokenStore);
+  _currentUserPermissionsCache = createCacheBySession(async (session, [teamId, type, direct]) => {
+    return await this._interface.listClientUserTeamPermissions({ teamId, type, direct }, session);
   });
-  _currentUserTeamsCache = createCacheByTokenStore(async (tokenStore) => {
-    return await this._interface.listClientUserTeams(tokenStore);
+  _currentUserTeamsCache = createCacheBySession(async (session) => {
+    return await this._interface.listClientUserTeams(session);
   });
   _initUniqueIdentifier() {
     if (!this._uniqueIdentifier) {
@@ -245,19 +248,18 @@ var _StackClientAppImpl = class __StackClientAppImpl {
     return this._uniqueIdentifier;
   }
   _memoryTokenStore = createEmptyTokenStore();
-  _requestTokenStores = /* @__PURE__ */ new Map();
-  _getTokenStore(overrideTokenStoreInit) {
+  _requestTokenStores = /* @__PURE__ */ new WeakMap();
+  _getOrCreateTokenStore(overrideTokenStoreInit) {
     const tokenStoreInit = overrideTokenStoreInit === void 0 ? this._tokenStoreInit : overrideTokenStoreInit;
     switch (tokenStoreInit) {
       case "cookie": {
-        return cookieTokenStoreInitializer();
+        return getCookieTokenStore();
       }
       case "nextjs-cookie": {
-        if ((0, import_next.isClient)()) {
-          return cookieTokenStoreInitializer();
+        if ((0, import_env.isBrowserLike)()) {
+          return getCookieTokenStore();
         } else {
-          const store = new import_stores.AsyncStore();
-          store.set({
+          const store = new import_stores.Store({
             refreshToken: (0, import_cookie.getCookie)("stack-refresh"),
             accessToken: (0, import_cookie.getCookie)("stack-access")
           });
@@ -278,12 +280,12 @@ var _StackClientAppImpl = class __StackClientAppImpl {
         return createEmptyTokenStore();
       }
       default: {
-        if (tokenStoreInit && typeof tokenStoreInit === "object" && "headers" in tokenStoreInit) {
+        if (tokenStoreInit !== null && typeof tokenStoreInit === "object" && "headers" in tokenStoreInit) {
           if (this._requestTokenStores.has(tokenStoreInit))
             return this._requestTokenStores.get(tokenStoreInit);
           const cookieHeader = tokenStoreInit.headers.get("cookie");
           const parsed = cookie.parse(cookieHeader || "");
-          const res = new import_stores.AsyncStore({
+          const res = new import_stores.Store({
             refreshToken: parsed["stack-refresh"] || null,
             accessToken: parsed["stack-access"] || null
           });
@@ -294,6 +296,60 @@ var _StackClientAppImpl = class __StackClientAppImpl {
       }
     }
   }
+  /**
+   * A map from token stores and session keys to sessions.
+   * 
+   * This isn't just a map from session keys to sessions for two reasons:
+   * 
+   * - So we can garbage-collect Session objects when the token store is garbage-collected
+   * - So different token stores are separated and don't leak information between each other, eg. if the same user sends two requests to the same server they should get a different session object
+   */
+  _sessionsByTokenStoreAndSessionKey = /* @__PURE__ */ new WeakMap();
+  _getSessionFromTokenStore(tokenStore) {
+    const tokenObj = tokenStore.get();
+    const sessionKey = import_sessions.Session.calculateSessionKey(tokenObj);
+    const existing = sessionKey ? this._sessionsByTokenStoreAndSessionKey.get(tokenStore)?.get(sessionKey) : null;
+    if (existing)
+      return existing;
+    const session = this._interface.createSession({
+      refreshToken: tokenObj.refreshToken,
+      accessToken: tokenObj.accessToken
+    });
+    session.onAccessTokenChange((newAccessToken) => {
+      tokenStore.update((old) => ({
+        ...old,
+        accessToken: newAccessToken?.token ?? null
+      }));
+    });
+    session.onInvalidate(() => {
+      tokenStore.update((old) => ({
+        ...old,
+        accessToken: null,
+        refreshToken: null
+      }));
+    });
+    let sessionsBySessionKey = this._sessionsByTokenStoreAndSessionKey.get(tokenStore) ?? /* @__PURE__ */ new Map();
+    this._sessionsByTokenStoreAndSessionKey.set(tokenStore, sessionsBySessionKey);
+    sessionsBySessionKey.set(sessionKey, session);
+    return session;
+  }
+  _getSession(overrideTokenStoreInit) {
+    const tokenStore = this._getOrCreateTokenStore(overrideTokenStoreInit);
+    return this._getSessionFromTokenStore(tokenStore);
+  }
+  _useSession(overrideTokenStoreInit) {
+    const tokenStore = this._getOrCreateTokenStore(overrideTokenStoreInit);
+    const subscribe = (0, import_react.useCallback)((cb) => {
+      const { unsubscribe } = tokenStore.onChange(() => cb());
+      return unsubscribe;
+    }, [tokenStore]);
+    const getSnapshot = (0, import_react.useCallback)(() => this._getSessionFromTokenStore(tokenStore), [tokenStore]);
+    return import_react.default.useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+  }
+  async _signInToAccountWithTokens(tokens) {
+    const tokenStore = this._getOrCreateTokenStore();
+    tokenStore.set(tokens);
+  }
   _hasPersistentTokenStore(overrideTokenStoreInit) {
     return (overrideTokenStoreInit !== void 0 ? overrideTokenStoreInit : this._tokenStoreInit) !== null;
   }
@@ -373,24 +429,25 @@ var _StackClientAppImpl = class __StackClientAppImpl {
         });
       },
       async listTeams() {
-        const teams = await app._currentUserTeamsCache.getOrWait([app._getTokenStore()], "write-only");
+        const teams = await app._currentUserTeamsCache.getOrWait([app._getSession()], "write-only");
         return teams.map((json2) => app._teamFromJson(json2));
       },
       useTeams() {
-        const teams = useCache(app._currentUserTeamsCache, [app._getTokenStore()], "user.useTeams()");
+        const session = app._useSession();
+        const teams = useAsyncCache(app._currentUserTeamsCache, [session], "user.useTeams()");
         return (0, import_react.useMemo)(() => teams.map((json2) => app._teamFromJson(json2)), [teams]);
       },
       onTeamsChange(callback) {
-        return app._currentUserTeamsCache.onChange([app._getTokenStore()], (value, oldValue) => {
+        return app._currentUserTeamsCache.onChange([app._getSession()], (value, oldValue) => {
           callback(value.map((json2) => app._teamFromJson(json2)), oldValue?.map((json2) => app._teamFromJson(json2)));
         });
       },
       async listPermissions(scope, options) {
-        const permissions = await app._currentUserPermissionsCache.getOrWait([app._getTokenStore(), scope.id, "team", !!options?.direct], "write-only");
+        const permissions = await app._currentUserPermissionsCache.getOrWait([app._getSession(), scope.id, "team", !!options?.direct], "write-only");
         return permissions.map((json2) => app._permissionFromJson(json2));
       },
       usePermissions(scope, options) {
-        const permissions = useCache(app._currentUserPermissionsCache, [app._getTokenStore(), scope.id, "team", !!options?.direct], "user.usePermissions()");
+        const permissions = useAsyncCache(app._currentUserPermissionsCache, [app._getSession(), scope.id, "team", !!options?.direct], "user.usePermissions()");
         return (0, import_react.useMemo)(() => permissions.map((json2) => app._permissionFromJson(json2)), [permissions]);
       },
       usePermission(scope, permissionId) {
@@ -418,30 +475,27 @@ var _StackClientAppImpl = class __StackClientAppImpl {
       displayName: json.displayName
     };
   }
-  _currentUserFromJson(json, tokenStore) {
+  _currentUserFromJson(json, session) {
     if (json === null)
       return null;
     const app = this;
     const currentUser = {
       ...this._userFromJson(json),
-      tokenStore,
-      async refreshAccessToken() {
-        await app._interface.refreshAccessToken(tokenStore);
-      },
+      session,
       async updateSelectedTeam(team) {
-        await app._updateUser({ selectedTeamId: team?.id ?? null }, tokenStore);
+        await app._updateUser({ selectedTeamId: team?.id ?? null }, session);
       },
       update(update) {
-        return app._updateUser(update, tokenStore);
+        return app._updateUser(update, session);
       },
       signOut() {
-        return app._signOut(tokenStore);
+        return app._signOut(session);
       },
       sendVerificationEmail() {
-        return app._sendVerificationEmail(tokenStore);
+        return app._sendVerificationEmail(session);
       },
       updatePassword(options) {
-        return app._updatePassword(options, tokenStore);
+        return app._updatePassword(options, session);
       }
     };
     if (this._isInternalProject()) {
@@ -500,13 +554,12 @@ var _StackClientAppImpl = class __StackClientAppImpl {
       }
     };
   }
-  _createAdminInterface(forProjectId, tokenStore) {
+  _createAdminInterface(forProjectId, session) {
     return new import_stack_shared.StackAdminInterface({
       baseUrl: this._interface.options.baseUrl,
       projectId: forProjectId,
       clientVersion,
-      projectOwnerTokens: tokenStore,
-      refreshProjectOwnerTokens: async () => await this._interface.refreshAccessToken(tokenStore)
+      projectOwnerSession: session
     });
   }
   get projectId() {
@@ -592,8 +645,8 @@ var _StackClientAppImpl = class __StackClientAppImpl {
   }
   async getUser(options) {
     this._ensurePersistentTokenStore(options?.tokenStore);
-    const tokenStore = this._getTokenStore(options?.tokenStore);
-    const userJson = await this._currentUserCache.getOrWait([tokenStore], "write-only");
+    const session = this._getSession(options?.tokenStore);
+    const userJson = await this._currentUserCache.getOrWait([session], "write-only");
     if (userJson === null) {
       switch (options?.or) {
         case "redirect": {
@@ -608,20 +661,18 @@ var _StackClientAppImpl = class __StackClientAppImpl {
         }
       }
     }
-    return this._currentUserFromJson(userJson, tokenStore);
+    return this._currentUserFromJson(userJson, session);
   }
   useUser(options) {
     this._ensurePersistentTokenStore(options?.tokenStore);
     const router = NextNavigation.useRouter();
-    const tokenStore = this._getTokenStore(options?.tokenStore);
-    const userJson = useCache(this._currentUserCache, [tokenStore], "useUser()");
+    const session = this._getSession(options?.tokenStore);
+    const userJson = useAsyncCache(this._currentUserCache, [session], "useUser()");
+    const triggerRedirectToSignIn = (0, import_use_trigger.useTrigger)(() => router.replace(this.urls.signIn));
     if (userJson === null) {
       switch (options?.or) {
         case "redirect": {
-          (0, import_promises.runAsynchronously)(async () => {
-            await (0, import_promises.wait)(0);
-            router.replace(this.urls.signIn);
-          });
+          triggerRedirectToSignIn();
           (0, import_react3.suspend)();
           throw new import_errors.StackAssertionError("suspend should never return");
         }
@@ -634,19 +685,19 @@ var _StackClientAppImpl = class __StackClientAppImpl {
       }
     }
     return (0, import_react.useMemo)(() => {
-      return this._currentUserFromJson(userJson, tokenStore);
-    }, [userJson, tokenStore, options?.or]);
+      return this._currentUserFromJson(userJson, session);
+    }, [userJson, session, options?.or]);
   }
   onUserChange(callback) {
     this._ensurePersistentTokenStore();
-    const tokenStore = this._getTokenStore();
-    return this._currentUserCache.onChange([tokenStore], (userJson) => {
-      callback(this._currentUserFromJson(userJson, tokenStore));
+    const session = this._getSession();
+    return this._currentUserCache.onChange([session], (userJson) => {
+      callback(this._currentUserFromJson(userJson, session));
     });
   }
-  async _updateUser(update, tokenStore) {
-    const res = await this._interface.setClientUserCustomizableData(update, tokenStore);
-    await this._refreshUser(tokenStore);
+  async _updateUser(update, session) {
+    const res = await this._interface.setClientUserCustomizableData(update, session);
+    await this._refreshUser(session);
     return res;
   }
   async signInWithOAuth(provider) {
@@ -655,35 +706,38 @@ var _StackClientAppImpl = class __StackClientAppImpl {
   }
   async signInWithCredential(options) {
     this._ensurePersistentTokenStore();
-    const tokenStore = this._getTokenStore();
-    const errorCode = await this._interface.signInWithCredential(options.email, options.password, tokenStore);
-    if (!errorCode) {
-      await this.redirectToAfterSignIn({ replace: true });
+    const session = this._getSession();
+    const result = await this._interface.signInWithCredential(options.email, options.password, session);
+    if (!(result instanceof import_stack_shared.KnownError)) {
+      await this._signInToAccountWithTokens(result);
+      return await this.redirectToAfterSignIn({ replace: true });
     }
-    return errorCode;
+    return result;
   }
   async signUpWithCredential(options) {
     this._ensurePersistentTokenStore();
-    const tokenStore = this._getTokenStore();
+    const session = this._getSession();
     const emailVerificationRedirectUrl = (0, import_url.constructRedirectUrl)(this.urls.emailVerification);
-    const errorCode = await this._interface.signUpWithCredential(
+    const result = await this._interface.signUpWithCredential(
       options.email,
       options.password,
       emailVerificationRedirectUrl,
-      tokenStore
+      session
     );
-    if (!errorCode) {
-      await this.redirectToAfterSignUp({ replace: true });
+    if (!(result instanceof import_stack_shared.KnownError)) {
+      await this._signInToAccountWithTokens(result);
+      return await this.redirectToAfterSignUp({ replace: true });
     }
-    return errorCode;
+    return result;
   }
   async signInWithMagicLink(code) {
     this._ensurePersistentTokenStore();
-    const tokenStore = this._getTokenStore();
-    const result = await this._interface.signInWithMagicLink(code, tokenStore);
+    const session = this._getSession();
+    const result = await this._interface.signInWithMagicLink(code, session);
     if (result instanceof import_stack_shared.KnownError) {
       return result;
     }
+    await this._signInToAccountWithTokens(result);
     if (result.newUser) {
       await this.redirectToAfterSignUp({ replace: true });
     } else {
@@ -692,9 +746,9 @@ var _StackClientAppImpl = class __StackClientAppImpl {
   }
   async callOAuthCallback() {
     this._ensurePersistentTokenStore();
-    const tokenStore = this._getTokenStore();
-    const result = await (0, import_auth.callOAuthCallback)(this._interface, tokenStore, this.urls.oauthCallback);
+    const result = await (0, import_auth.callOAuthCallback)(this._interface, this.urls.oauthCallback);
     if (result) {
+      await this._signInToAccountWithTokens(result);
       if (result.newUser) {
         await this.redirectToAfterSignUp({ replace: true });
         return true;
@@ -705,16 +759,16 @@ var _StackClientAppImpl = class __StackClientAppImpl {
     }
     return false;
   }
-  async _signOut(tokenStore) {
-    await this._interface.signOut(tokenStore);
+  async _signOut(session) {
+    await this._interface.signOut(session);
     await this.redirectToAfterSignOut();
   }
-  async _sendVerificationEmail(tokenStore) {
+  async _sendVerificationEmail(session) {
     const emailVerificationRedirectUrl = (0, import_url.constructRedirectUrl)(this.urls.emailVerification);
-    return await this._interface.sendVerificationEmail(emailVerificationRedirectUrl, tokenStore);
+    return await this._interface.sendVerificationEmail(emailVerificationRedirectUrl, session);
   }
-  async _updatePassword(options, tokenStore) {
-    return await this._interface.updatePassword(options, tokenStore);
+  async _updatePassword(options, session) {
+    return await this._interface.updatePassword(options, session);
   }
   async signOut() {
     const user = await this.getUser();
@@ -726,64 +780,64 @@ var _StackClientAppImpl = class __StackClientAppImpl {
     return await this._currentProjectCache.getOrWait([], "write-only");
   }
   useProject() {
-    return useCache(this._currentProjectCache, [], "useProject()");
+    return useAsyncCache(this._currentProjectCache, [], "useProject()");
   }
   onProjectChange(callback) {
     return this._currentProjectCache.onChange([], callback);
   }
   async _listOwnedProjects() {
     this._ensureInternalProject();
-    const tokenStore = this._getTokenStore();
-    const json = await this._ownedProjectsCache.getOrWait([tokenStore], "write-only");
+    const session = this._getSession();
+    const json = await this._ownedProjectsCache.getOrWait([session], "write-only");
     return json.map((j) => this._projectAdminFromJson(
       j,
-      this._createAdminInterface(j.id, tokenStore),
-      () => this._refreshOwnedProjects(tokenStore)
+      this._createAdminInterface(j.id, session),
+      () => this._refreshOwnedProjects(session)
     ));
   }
   _useOwnedProjects() {
     this._ensureInternalProject();
-    const tokenStore = this._getTokenStore();
-    const json = useCache(this._ownedProjectsCache, [tokenStore], "useOwnedProjects()");
+    const session = this._getSession();
+    const json = useAsyncCache(this._ownedProjectsCache, [session], "useOwnedProjects()");
     return (0, import_react.useMemo)(() => json.map((j) => this._projectAdminFromJson(
       j,
-      this._createAdminInterface(j.id, tokenStore),
-      () => this._refreshOwnedProjects(tokenStore)
+      this._createAdminInterface(j.id, session),
+      () => this._refreshOwnedProjects(session)
     )), [json]);
   }
   _onOwnedProjectsChange(callback) {
     this._ensureInternalProject();
-    const tokenStore = this._getTokenStore();
-    return this._ownedProjectsCache.onChange([tokenStore], (projects) => {
+    const session = this._getSession();
+    return this._ownedProjectsCache.onChange([session], (projects) => {
       callback(projects.map((j) => this._projectAdminFromJson(
         j,
-        this._createAdminInterface(j.id, tokenStore),
-        () => this._refreshOwnedProjects(tokenStore)
+        this._createAdminInterface(j.id, session),
+        () => this._refreshOwnedProjects(session)
       )));
     });
   }
   async _createProject(newProject) {
     this._ensureInternalProject();
-    const tokenStore = this._getTokenStore();
-    const json = await this._interface.createProject(newProject, tokenStore);
+    const session = this._getSession();
+    const json = await this._interface.createProject(newProject, session);
     const res = this._projectAdminFromJson(
       json,
-      this._createAdminInterface(json.id, tokenStore),
-      () => this._refreshOwnedProjects(tokenStore)
+      this._createAdminInterface(json.id, session),
+      () => this._refreshOwnedProjects(session)
     );
-    await this._refreshOwnedProjects(tokenStore);
+    await this._refreshOwnedProjects(session);
     return res;
   }
-  async _refreshUser(tokenStore) {
-    await this._currentUserCache.refresh([tokenStore]);
+  async _refreshUser(session) {
+    await this._currentUserCache.refresh([session]);
   }
   async _refreshUsers() {
   }
   async _refreshProject() {
     await this._currentProjectCache.refresh([]);
   }
-  async _refreshOwnedProjects(tokenStore) {
-    await this._ownedProjectsCache.refresh([tokenStore]);
+  async _refreshOwnedProjects(session) {
+    await this._ownedProjectsCache.refresh([session]);
   }
   static get [stackAppInternalsSymbol]() {
     return {
@@ -822,15 +876,15 @@ var _StackClientAppImpl = class __StackClientAppImpl {
         };
       },
       setCurrentUser: (userJsonPromise) => {
-        (0, import_promises.runAsynchronously)(this._currentUserCache.forceSetCachedValueAsync([this._getTokenStore()], userJsonPromise));
+        (0, import_promises.runAsynchronously)(this._currentUserCache.forceSetCachedValueAsync([this._getSession()], userJsonPromise));
       }
     };
   }
 };
 var _StackServerAppImpl = class extends _StackClientAppImpl {
   // TODO override the client user cache to use the server user cache, so we save some requests
-  _currentServerUserCache = createCacheByTokenStore(async (tokenStore) => {
-    const user = await this._interface.getServerUserByToken(tokenStore);
+  _currentServerUserCache = createCacheBySession(async (session) => {
+    const user = await this._interface.getServerUserByToken(session);
     return import_results.Result.or(user, null);
   });
   _serverUsersCache = createCache(async () => {
@@ -921,15 +975,15 @@ var _StackServerAppImpl = class extends _StackClientAppImpl {
         });
       },
       async listTeams() {
-        const teams = await app._serverTeamsCache.getOrWait([app._getTokenStore()], "write-only");
+        const teams = await app._serverTeamsCache.getOrWait([app._getSession()], "write-only");
         return teams.map((json2) => app._serverTeamFromJson(json2));
       },
       useTeams() {
-        const teams = useCache(app._serverTeamsCache, [app._getTokenStore()], "user.useTeams()");
+        const teams = useAsyncCache(app._serverTeamsCache, [app._getSession()], "user.useTeams()");
         return (0, import_react.useMemo)(() => teams.map((json2) => app._serverTeamFromJson(json2)), [teams]);
       },
       onTeamsChange(callback) {
-        return app._serverTeamsCache.onChange([app._getTokenStore()], (value, oldValue) => {
+        return app._serverTeamsCache.onChange([app._getSession()], (value, oldValue) => {
           callback(value.map((json2) => app._serverTeamFromJson(json2)), oldValue?.map((json2) => app._serverTeamFromJson(json2)));
         });
       },
@@ -938,7 +992,7 @@ var _StackServerAppImpl = class extends _StackClientAppImpl {
         return permissions.map((json2) => app._serverPermissionFromJson(json2));
       },
       usePermissions(scope, options) {
-        const permissions = useCache(app._serverTeamUserPermissionsCache, [scope.id, json.id, "team", !!options?.direct], "user.usePermissions()");
+        const permissions = useAsyncCache(app._serverTeamUserPermissionsCache, [scope.id, json.id, "team", !!options?.direct], "user.usePermissions()");
         return (0, import_react.useMemo)(() => permissions.map((json2) => app._serverPermissionFromJson(json2)), [permissions]);
       },
       usePermission(scope, permissionId) {
@@ -958,20 +1012,17 @@ var _StackServerAppImpl = class extends _StackClientAppImpl {
       }
     };
   }
-  _currentServerUserFromJson(json, tokenStore) {
+  _currentServerUserFromJson(json, session) {
     if (json === null)
       return null;
     const app = this;
     const nonCurrentServerUser = this._serverUserFromJson(json);
     const currentUser = {
       ...nonCurrentServerUser,
-      tokenStore,
-      async refreshAccessToken() {
-        await app._interface.refreshAccessToken(tokenStore);
-      },
+      session,
       async delete() {
         const res = await nonCurrentServerUser.delete();
-        await app._refreshUser(tokenStore);
+        await app._refreshUser(session);
         return res;
       },
       async updateSelectedTeam(team) {
@@ -979,20 +1030,20 @@ var _StackServerAppImpl = class extends _StackClientAppImpl {
       },
       async update(update) {
         const res = await nonCurrentServerUser.update(update);
-        await app._refreshUser(tokenStore);
+        await app._refreshUser(session);
         return res;
       },
       signOut() {
-        return app._signOut(tokenStore);
+        return app._signOut(session);
       },
       getClientUser() {
-        return app._currentUserFromJson(json, tokenStore);
+        return app._currentUserFromJson(json, session);
       },
       sendVerificationEmail() {
-        return app._sendVerificationEmail(tokenStore);
+        return app._sendVerificationEmail(session);
       },
       updatePassword(options) {
-        return app._updatePassword(options, tokenStore);
+        return app._updatePassword(options, session);
       }
     };
     if (this._isInternalProject()) {
@@ -1050,7 +1101,7 @@ var _StackServerAppImpl = class extends _StackClientAppImpl {
         await app._serverTeamsCache.refresh([]);
       },
       useMembers() {
-        const result = useCache(app._serverTeamMembersCache, [json.id], "team.useUsers()");
+        const result = useAsyncCache(app._serverTeamMembersCache, [json.id], "team.useUsers()");
         return (0, import_react.useMemo)(() => result.map((u) => app._serverTeamMemberFromJson(u)), [result]);
       },
       async addUser(userId) {
@@ -1074,9 +1125,9 @@ var _StackServerAppImpl = class extends _StackClientAppImpl {
   }
   async getServerUser() {
     this._ensurePersistentTokenStore();
-    const tokenStore = this._getTokenStore();
-    const userJson = await this._currentServerUserCache.getOrWait([tokenStore], "write-only");
-    return this._currentServerUserFromJson(userJson, tokenStore);
+    const session = this._getSession();
+    const userJson = await this._currentServerUserCache.getOrWait([session], "write-only");
+    return this._currentServerUserFromJson(userJson, session);
   }
   async getServerUserById(userId) {
     const json = await this._serverUserCache.getOrWait([userId], "write-only");
@@ -1084,20 +1135,20 @@ var _StackServerAppImpl = class extends _StackClientAppImpl {
   }
   useServerUser(options) {
     this._ensurePersistentTokenStore();
-    const tokenStore = this._getTokenStore();
-    const userJson = useCache(this._currentServerUserCache, [tokenStore], "useServerUser()");
+    const session = this._getSession();
+    const userJson = useAsyncCache(this._currentServerUserCache, [session], "useServerUser()");
     return (0, import_react.useMemo)(() => {
       if (options?.required && userJson === null) {
         (0, import_react.use)(this.redirectToSignIn());
       }
-      return this._currentServerUserFromJson(userJson, tokenStore);
-    }, [userJson, tokenStore, options?.required]);
+      return this._currentServerUserFromJson(userJson, session);
+    }, [userJson, session, options?.required]);
   }
   onServerUserChange(callback) {
     this._ensurePersistentTokenStore();
-    const tokenStore = this._getTokenStore();
-    return this._currentServerUserCache.onChange([tokenStore], (userJson) => {
-      callback(this._currentServerUserFromJson(userJson, tokenStore));
+    const session = this._getSession();
+    return this._currentServerUserCache.onChange([session], (userJson) => {
+      callback(this._currentServerUserFromJson(userJson, session));
     });
   }
   async listServerUsers() {
@@ -1105,7 +1156,7 @@ var _StackServerAppImpl = class extends _StackClientAppImpl {
     return json.map((j) => this._serverUserFromJson(j));
   }
   useServerUsers() {
-    const json = useCache(this._serverUsersCache, [], "useServerUsers()");
+    const json = useAsyncCache(this._serverUsersCache, [], "useServerUsers()");
     return (0, import_react.useMemo)(() => {
       return json.map((j) => this._serverUserFromJson(j));
     }, [json]);
@@ -1119,7 +1170,7 @@ var _StackServerAppImpl = class extends _StackClientAppImpl {
     return await this._serverTeamPermissionDefinitionsCache.getOrWait([], "write-only");
   }
   usePermissionDefinitions() {
-    return useCache(this._serverTeamPermissionDefinitionsCache, [], "usePermissions()");
+    return useAsyncCache(this._serverTeamPermissionDefinitionsCache, [], "usePermissions()");
   }
   _serverPermissionFromJson(json) {
     return {
@@ -1130,7 +1181,7 @@ var _StackServerAppImpl = class extends _StackClientAppImpl {
     };
   }
   async createPermissionDefinition(data) {
-    const permission = await this._serverPermissionFromJson(await this._interface.createPermissionDefinition(data));
+    const permission = this._serverPermissionFromJson(await this._interface.createPermissionDefinition(data));
     await this._serverTeamPermissionDefinitionsCache.refresh([]);
     return permission;
   }
@@ -1152,7 +1203,7 @@ var _StackServerAppImpl = class extends _StackClientAppImpl {
     return this._serverTeamFromJson(team);
   }
   useTeams() {
-    const teams = useCache(this._serverTeamsCache, [], "useServerTeams()");
+    const teams = useAsyncCache(this._serverTeamsCache, [], "useServerTeams()");
     return (0, import_react.useMemo)(() => {
       return teams.map((t) => this._serverTeamFromJson(t));
     }, [teams]);
@@ -1167,10 +1218,10 @@ var _StackServerAppImpl = class extends _StackClientAppImpl {
       return teams.find((t) => t.id === teamId) ?? null;
     }, [teams, teamId]);
   }
-  async _refreshUser(tokenStore) {
+  async _refreshUser(session) {
     await Promise.all([
-      super._refreshUser(tokenStore),
-      this._currentServerUserCache.refresh([tokenStore])
+      super._refreshUser(session),
+      this._currentServerUserCache.refresh([session])
     ]);
   }
   async _refreshUsers() {
@@ -1180,7 +1231,7 @@ var _StackServerAppImpl = class extends _StackClientAppImpl {
     ]);
   }
   useEmailTemplates() {
-    return useCache(this._serverEmailTemplatesCache, [], "useEmailTemplates()");
+    return useAsyncCache(this._serverEmailTemplatesCache, [], "useEmailTemplates()");
   }
   async listEmailTemplates() {
     return await this._serverEmailTemplatesCache.getOrWait([], "write-only");
@@ -1207,9 +1258,8 @@ var _StackAdminAppImpl = class extends _StackServerAppImpl {
         baseUrl: options.baseUrl ?? getDefaultBaseUrl(),
         projectId: options.projectId ?? getDefaultProjectId(),
         clientVersion,
-        ..."projectOwnerTokens" in options ? {
-          projectOwnerTokens: options.projectOwnerTokens,
-          refreshProjectOwnerTokens: options.refreshProjectOwnerTokens
+        ..."projectOwnerSession" in options ? {
+          projectOwnerSession: options.projectOwnerSession
         } : {
           publishableClientKey: options.publishableClientKey ?? getDefaultPublishableClientKey(),
           secretServerKey: options.secretServerKey ?? getDefaultSecretServerKey(),
@@ -1269,7 +1319,7 @@ var _StackAdminAppImpl = class extends _StackServerAppImpl {
     );
   }
   useProjectAdmin() {
-    const json = useCache(this._adminProjectCache, [], "useProjectAdmin()");
+    const json = useAsyncCache(this._adminProjectCache, [], "useProjectAdmin()");
     return (0, import_react.useMemo)(() => this._projectAdminFromJson(
       json,
       this._interface,
@@ -1290,7 +1340,7 @@ var _StackAdminAppImpl = class extends _StackServerAppImpl {
     return json.map((j) => this._createApiKeySetFromJson(j));
   }
   useApiKeySets() {
-    const json = useCache(this._apiKeySetsCache, [], "useApiKeySets()");
+    const json = useAsyncCache(this._apiKeySetsCache, [], "useApiKeySets()");
     return (0, import_react.useMemo)(() => {
       return json.map((j) => this._createApiKeySetFromJson(j));
     }, [json]);