@stackframe/stack 2.3.4 → 2.3.7

package/dist/lib/hooks.js

@@ -1,30 +1,55 @@
-import { StackContext } from "../providers/stack-provider-client";
-import { useContext } from "react";
-export function useUser(options = {}) {
-    const stackApp = useStackApp(options);
-    if (options.projectIdMustMatch && stackApp.projectId !== options.projectIdMustMatch) {
-        throw new Error("Unexpected project ID in useStackApp: " + stackApp.projectId);
-    }
-    if (options.projectIdMustMatch === "internal") {
-        return stackApp.useUser(options);
-    }
-    else {
-        return stackApp.useUser(options);
-    }
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/lib/hooks.ts
+var hooks_exports = {};
+__export(hooks_exports, {
+  useStackApp: () => useStackApp,
+  useUser: () => useUser
+});
+module.exports = __toCommonJS(hooks_exports);
+var import_stack_provider_client = require("../providers/stack-provider-client");
+var import_react = require("react");
+function useUser(options = {}) {
+  const stackApp = useStackApp(options);
+  if (options.projectIdMustMatch && stackApp.projectId !== options.projectIdMustMatch) {
+    throw new Error("Unexpected project ID in useStackApp: " + stackApp.projectId);
+  }
+  if (options.projectIdMustMatch === "internal") {
+    return stackApp.useUser(options);
+  } else {
+    return stackApp.useUser(options);
+  }
 }
-/**
- * Returns the current Stack app associated with the StackProvider.
- *
- * @returns the current Stack app
- */
-export function useStackApp(options = {}) {
-    const context = useContext(StackContext);
-    if (context === null) {
-        throw new Error("useStackApp must be used within a StackProvider");
-    }
-    const stackApp = context.app;
-    if (options.projectIdMustMatch && stackApp.projectId !== options.projectIdMustMatch) {
-        throw new Error("Unexpected project ID in useStackApp: " + stackApp.projectId);
-    }
-    return stackApp;
+function useStackApp(options = {}) {
+  const context = (0, import_react.useContext)(import_stack_provider_client.StackContext);
+  if (context === null) {
+    throw new Error("useStackApp must be used within a StackProvider");
+  }
+  const stackApp = context.app;
+  if (options.projectIdMustMatch && stackApp.projectId !== options.projectIdMustMatch) {
+    throw new Error("Unexpected project ID in useStackApp: " + stackApp.projectId);
+  }
+  return stackApp;
 }
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useStackApp,
+  useUser
+});

package/dist/lib/stack-app.d.mts

@@ -0,0 +1,227 @@
+import { ServerUserJson, ServerUserCustomizableJson, OAuthProviderConfigJson, KnownErrors } from '@stackframe/stack-shared';
+import { ReadonlyTokenStore, UserJson, UserCustomizableJson, ProjectJson, ProductionModeError, EmailConfigJson, DomainConfigJson, ClientProjectJson } from '@stackframe/stack-shared/dist/interface/clientInterface';
+import { ReadonlyJson } from '@stackframe/stack-shared/dist/utils/json';
+import { ProjectUpdateOptions, ApiKeySetCreateOptions } from '@stackframe/stack-shared/dist/interface/adminInterface';
+
+type TokenStoreOptions<HasTokenStore extends boolean = boolean> = HasTokenStore extends true ? "cookie" | "nextjs-cookie" | "memory" : HasTokenStore extends false ? null : TokenStoreOptions<true> | TokenStoreOptions<false>;
+type HandlerUrls = {
+    handler: string;
+    signIn: string;
+    afterSignIn: string;
+    signUp: string;
+    afterSignUp: string;
+    signOut: string;
+    afterSignOut: string;
+    emailVerification: string;
+    passwordReset: string;
+    forgotPassword: string;
+    home: string;
+    oauthCallback: string;
+    magicLinkCallback: string;
+    accountSettings: string;
+};
+type ProjectCurrentUser<ProjectId> = ProjectId extends "internal" ? CurrentInternalUser : CurrentUser;
+type StackClientAppConstructorOptions<HasTokenStore extends boolean, ProjectId extends string> = {
+    baseUrl?: string;
+    projectId?: ProjectId;
+    publishableClientKey?: string;
+    urls?: Partial<HandlerUrls>;
+    tokenStore: TokenStoreOptions<HasTokenStore>;
+};
+type StackServerAppConstructorOptions<HasTokenStore extends boolean, ProjectId extends string> = StackClientAppConstructorOptions<HasTokenStore, ProjectId> & {
+    secretServerKey?: string;
+};
+type StackAdminAppConstructorOptions<HasTokenStore extends boolean, ProjectId extends string> = ((StackServerAppConstructorOptions<HasTokenStore, ProjectId> & {
+    superSecretAdminKey?: string;
+}) | (Omit<StackServerAppConstructorOptions<HasTokenStore, ProjectId>, "publishableClientKey" | "secretServerKey"> & {
+    projectOwnerTokens: ReadonlyTokenStore;
+}));
+type StackClientAppJson<HasTokenStore extends boolean, ProjectId extends string> = StackClientAppConstructorOptions<HasTokenStore, ProjectId> & {
+    uniqueIdentifier: string;
+};
+declare const stackAppInternalsSymbol: unique symbol;
+type Auth<T, C> = {
+    readonly tokenStore: ReadonlyTokenStore;
+    update(this: T, user: Partial<C>): Promise<void>;
+    signOut(this: T): Promise<void>;
+    sendVerificationEmail(this: T): Promise<KnownErrors["EmailAlreadyVerified"] | undefined>;
+    updatePassword(this: T, options: {
+        oldPassword: string;
+        newPassword: string;
+    }): Promise<KnownErrors["PasswordMismatch"] | KnownErrors["PasswordRequirementsNotMet"] | undefined>;
+};
+type InternalAuth<T> = {
+    createProject(this: T, newProject: Pick<Project, "displayName" | "description">): Promise<Project>;
+    listOwnedProjects(this: T): Promise<Project[]>;
+    useOwnedProjects(this: T): Project[];
+    onOwnedProjectsChange(this: T, callback: (projects: Project[]) => void): void;
+};
+type User = {
+    readonly projectId: string;
+    readonly id: string;
+    readonly displayName: string | null;
+    /**
+     * The user's email address.
+     *
+     * Note: This might NOT be unique across multiple users, so always use `id` for unique identification.
+     */
+    readonly primaryEmail: string | null;
+    readonly primaryEmailVerified: boolean;
+    readonly profileImageUrl: string | null;
+    readonly signedUpAt: Date;
+    readonly clientMetadata: ReadonlyJson;
+    readonly authMethod: 'credential' | 'oauth';
+    readonly hasPassword: boolean;
+    readonly authWithEmail: boolean;
+    readonly oauthProviders: readonly string[];
+    toJson(this: CurrentUser): UserJson;
+};
+type CurrentUser = Auth<User, UserCustomizableJson> & User;
+type CurrentInternalUser = CurrentUser & InternalAuth<CurrentUser>;
+/**
+ * A user including sensitive fields that should only be used on the server, never sent to the client
+ * (such as sensitive information and serverMetadata).
+ */
+type ServerUser = Omit<User, "toJson"> & {
+    readonly serverMetadata: ReadonlyJson;
+    /**
+     * Returns a new user object with the sensitive fields removed.
+     */
+    getClientUser(this: ServerUser): User;
+    toJson(this: ServerUser): ServerUserJson;
+    update(this: ServerUser, user: Partial<ServerUserCustomizableJson>): Promise<void>;
+    delete(this: ServerUser): Promise<void>;
+};
+type CurrentServerUser = Auth<ServerUser, ServerUserCustomizableJson> & Omit<ServerUser, "getClientUser"> & {
+    getClientUser(this: CurrentServerUser): CurrentUser;
+};
+type CurrentInternalServerUser = CurrentServerUser & InternalAuth<CurrentServerUser>;
+type Project = {
+    readonly id: string;
+    readonly displayName: string;
+    readonly description?: string;
+    readonly createdAt: Date;
+    readonly userCount: number;
+    readonly isProductionMode: boolean;
+    readonly evaluatedConfig: {
+        readonly id: string;
+        readonly allowLocalhost: boolean;
+        readonly credentialEnabled: boolean;
+        readonly magicLinkEnabled: boolean;
+        readonly oauthProviders: OAuthProviderConfig[];
+        readonly emailConfig?: EmailConfig;
+        readonly domains: DomainConfig[];
+    };
+    update(this: Project, update: ProjectUpdateOptions): Promise<void>;
+    toJson(this: Project): ProjectJson;
+    getProductionModeErrors(this: Project): ProductionModeError[];
+};
+type ApiKeySetBase = {
+    id: string;
+    description: string;
+    expiresAt: Date;
+    manuallyRevokedAt: Date | null;
+    createdAt: Date;
+    isValid(): boolean;
+    whyInvalid(): "expired" | "manually-revoked" | null;
+    revoke(): Promise<void>;
+};
+type ApiKeySetFirstView = ApiKeySetBase & {
+    publishableClientKey?: string;
+    secretServerKey?: string;
+    superSecretAdminKey?: string;
+};
+type ApiKeySet = ApiKeySetBase & {
+    publishableClientKey: null | {
+        lastFour: string;
+    };
+    secretServerKey: null | {
+        lastFour: string;
+    };
+    superSecretAdminKey: null | {
+        lastFour: string;
+    };
+};
+type EmailConfig = EmailConfigJson;
+type DomainConfig = DomainConfigJson;
+type OAuthProviderConfig = OAuthProviderConfigJson;
+type GetUserOptions = {
+    or?: 'redirect' | 'throw' | 'return-null';
+};
+type AsyncStoreProperty<Name extends string, Value, IsMultiple extends boolean> = {
+    [key in `${IsMultiple extends true ? "list" : "get"}${Capitalize<Name>}`]: () => Promise<Value>;
+} & {
+    [key in `on${Capitalize<Name>}Change`]: (callback: (value: Value) => void) => void;
+} & {
+    [key in `use${Capitalize<Name>}`]: () => Value;
+};
+type StackClientAppConstructor = {
+    new <TokenStoreType extends string, HasTokenStore extends (TokenStoreType extends {} ? true : boolean), ProjectId extends string>(options: StackClientAppConstructorOptions<HasTokenStore, ProjectId>): StackClientApp<HasTokenStore, ProjectId>;
+    new (options: StackClientAppConstructorOptions<boolean, string>): StackClientApp<boolean, string>;
+    [stackAppInternalsSymbol]: {
+        fromClientJson<HasTokenStore extends boolean, ProjectId extends string>(json: StackClientAppJson<HasTokenStore, ProjectId>): StackClientApp<HasTokenStore, ProjectId>;
+    };
+};
+type StackClientApp<HasTokenStore extends boolean = boolean, ProjectId extends string = string> = ({
+    readonly projectId: ProjectId;
+    readonly urls: Readonly<HandlerUrls>;
+    signInWithOAuth(provider: string): Promise<void>;
+    signInWithCredential(options: {
+        email: string;
+        password: string;
+    }): Promise<KnownErrors["EmailPasswordMismatch"] | undefined>;
+    signUpWithCredential(options: {
+        email: string;
+        password: string;
+    }): Promise<KnownErrors["UserEmailAlreadyExists"] | undefined>;
+    callOAuthCallback(): Promise<void>;
+    sendForgotPasswordEmail(email: string): Promise<KnownErrors["UserNotFound"] | undefined>;
+    sendMagicLinkEmail(email: string): Promise<KnownErrors["RedirectUrlNotWhitelisted"] | undefined>;
+    resetPassword(options: {
+        code: string;
+        password: string;
+    }): Promise<KnownErrors["PasswordResetError"] | undefined>;
+    verifyPasswordResetCode(code: string): Promise<KnownErrors["PasswordResetCodeError"] | undefined>;
+    verifyEmail(code: string): Promise<KnownErrors["EmailVerificationError"] | undefined>;
+    signInWithMagicLink(code: string): Promise<KnownErrors["MagicLinkError"] | undefined>;
+    [stackAppInternalsSymbol]: {
+        toClientJson(): StackClientAppJson<HasTokenStore, ProjectId>;
+        setCurrentUser(userJsonPromise: Promise<UserJson | null>): void;
+    };
+} & AsyncStoreProperty<"project", ClientProjectJson, false> & {
+    [K in `redirectTo${Capitalize<keyof Omit<HandlerUrls, 'handler' | 'oauthCallback'>>}`]: () => Promise<never>;
+} & (HasTokenStore extends false ? {} : {
+    redirectToOAuthCallback(): Promise<never>;
+    useUser(options: GetUserOptions & {
+        or: 'redirect';
+    }): ProjectCurrentUser<ProjectId>;
+    useUser(options: GetUserOptions & {
+        or: 'throw';
+    }): ProjectCurrentUser<ProjectId>;
+    useUser(options?: GetUserOptions): ProjectCurrentUser<ProjectId> | null;
+    getUser(options: GetUserOptions & {
+        or: 'redirect';
+    }): Promise<ProjectCurrentUser<ProjectId>>;
+    getUser(options: GetUserOptions & {
+        or: 'throw';
+    }): Promise<ProjectCurrentUser<ProjectId>>;
+    getUser(options?: GetUserOptions): Promise<ProjectCurrentUser<ProjectId> | null>;
+    onUserChange: AsyncStoreProperty<"user", CurrentUser | null, false>["onUserChange"];
+}));
+declare const StackClientApp: StackClientAppConstructor;
+type StackServerAppConstructor = {
+    new <TokenStoreType extends string, HasTokenStore extends (TokenStoreType extends {} ? true : boolean), ProjectId extends string>(options: StackServerAppConstructorOptions<HasTokenStore, ProjectId>): StackServerApp<HasTokenStore, ProjectId>;
+    new (options: StackServerAppConstructorOptions<boolean, string>): StackServerApp<boolean, string>;
+};
+type StackServerApp<HasTokenStore extends boolean = boolean, ProjectId extends string = string> = (StackClientApp<HasTokenStore, ProjectId> & AsyncStoreProperty<"serverUser", CurrentServerUser | null, false> & AsyncStoreProperty<"serverUsers", ServerUser[], true> & {});
+declare const StackServerApp: StackServerAppConstructor;
+type StackAdminAppConstructor = {
+    new <HasTokenStore extends boolean, ProjectId extends string>(options: StackAdminAppConstructorOptions<HasTokenStore, ProjectId>): StackAdminApp<HasTokenStore, ProjectId>;
+    new (options: StackAdminAppConstructorOptions<boolean, string>): StackAdminApp<boolean, string>;
+};
+type StackAdminApp<HasTokenStore extends boolean = boolean, ProjectId extends string = string> = (StackServerApp<HasTokenStore, ProjectId> & AsyncStoreProperty<"projectAdmin", Project, false> & AsyncStoreProperty<"apiKeySets", ApiKeySet[], true> & {
+    createApiKeySet(options: ApiKeySetCreateOptions): Promise<ApiKeySetFirstView>;
+});
+declare const StackAdminApp: StackAdminAppConstructor;
+
+export { type ApiKeySet, type ApiKeySetBase, type ApiKeySetFirstView, type CurrentInternalServerUser, type CurrentInternalUser, type CurrentServerUser, type CurrentUser, type DomainConfig, type EmailConfig, type GetUserOptions, type HandlerUrls, type OAuthProviderConfig, type Project, type ServerUser, StackAdminApp, type StackAdminAppConstructorOptions, StackClientApp, type StackClientAppConstructorOptions, type StackClientAppJson, StackServerApp, type StackServerAppConstructorOptions, type TokenStoreOptions, type User, stackAppInternalsSymbol };

package/dist/lib/stack-app.d.ts

@@ -1,9 +1,10 @@
-import { KnownErrors, OAuthProviderConfigJson, ServerUserCustomizableJson, ServerUserJson } from "@stackframe/stack-shared";
-import { ClientProjectJson, UserCustomizableJson, UserJson, ProjectJson, EmailConfigJson, DomainConfigJson, ReadonlyTokenStore, ProductionModeError } from "@stackframe/stack-shared/dist/interface/clientInterface";
-import { ReadonlyJson } from "@stackframe/stack-shared/dist/utils/json";
-import { ApiKeySetCreateOptions, ProjectUpdateOptions } from "@stackframe/stack-shared/dist/interface/adminInterface";
-export type TokenStoreOptions<HasTokenStore extends boolean = boolean> = HasTokenStore extends true ? "cookie" | "nextjs-cookie" | "memory" : HasTokenStore extends false ? null : TokenStoreOptions<true> | TokenStoreOptions<false>;
-export type HandlerUrls = {
+import { ServerUserJson, ServerUserCustomizableJson, OAuthProviderConfigJson, KnownErrors } from '@stackframe/stack-shared';
+import { ReadonlyTokenStore, UserJson, UserCustomizableJson, ProjectJson, ProductionModeError, EmailConfigJson, DomainConfigJson, ClientProjectJson } from '@stackframe/stack-shared/dist/interface/clientInterface';
+import { ReadonlyJson } from '@stackframe/stack-shared/dist/utils/json';
+import { ProjectUpdateOptions, ApiKeySetCreateOptions } from '@stackframe/stack-shared/dist/interface/adminInterface';
+
+type TokenStoreOptions<HasTokenStore extends boolean = boolean> = HasTokenStore extends true ? "cookie" | "nextjs-cookie" | "memory" : HasTokenStore extends false ? null : TokenStoreOptions<true> | TokenStoreOptions<false>;
+type HandlerUrls = {
     handler: string;
     signIn: string;
     afterSignIn: string;
@@ -20,27 +21,25 @@ export type HandlerUrls = {
     accountSettings: string;
 };
 type ProjectCurrentUser<ProjectId> = ProjectId extends "internal" ? CurrentInternalUser : CurrentUser;
-export type StackClientAppConstructorOptions<HasTokenStore extends boolean, ProjectId extends string> = {
+type StackClientAppConstructorOptions<HasTokenStore extends boolean, ProjectId extends string> = {
     baseUrl?: string;
     projectId?: ProjectId;
     publishableClientKey?: string;
     urls?: Partial<HandlerUrls>;
     tokenStore: TokenStoreOptions<HasTokenStore>;
 };
-export type StackServerAppConstructorOptions<HasTokenStore extends boolean, ProjectId extends string> = StackClientAppConstructorOptions<HasTokenStore, ProjectId> & {
+type StackServerAppConstructorOptions<HasTokenStore extends boolean, ProjectId extends string> = StackClientAppConstructorOptions<HasTokenStore, ProjectId> & {
     secretServerKey?: string;
 };
-export type StackAdminAppConstructorOptions<HasTokenStore extends boolean, ProjectId extends string> = ((StackServerAppConstructorOptions<HasTokenStore, ProjectId> & {
+type StackAdminAppConstructorOptions<HasTokenStore extends boolean, ProjectId extends string> = ((StackServerAppConstructorOptions<HasTokenStore, ProjectId> & {
     superSecretAdminKey?: string;
 }) | (Omit<StackServerAppConstructorOptions<HasTokenStore, ProjectId>, "publishableClientKey" | "secretServerKey"> & {
     projectOwnerTokens: ReadonlyTokenStore;
 }));
-export type StackClientAppJson<HasTokenStore extends boolean, ProjectId extends string> = StackClientAppConstructorOptions<HasTokenStore, ProjectId> & {
+type StackClientAppJson<HasTokenStore extends boolean, ProjectId extends string> = StackClientAppConstructorOptions<HasTokenStore, ProjectId> & {
     uniqueIdentifier: string;
-    currentClientUserJson: UserJson | null;
-    currentProjectJson: ClientProjectJson;
 };
-export declare const stackAppInternalsSymbol: unique symbol;
+declare const stackAppInternalsSymbol: unique symbol;
 type Auth<T, C> = {
     readonly tokenStore: ReadonlyTokenStore;
     update(this: T, user: Partial<C>): Promise<void>;
@@ -57,7 +56,7 @@ type InternalAuth<T> = {
     useOwnedProjects(this: T): Project[];
     onOwnedProjectsChange(this: T, callback: (projects: Project[]) => void): void;
 };
-export type User = {
+type User = {
     readonly projectId: string;
     readonly id: string;
     readonly displayName: string | null;
@@ -77,13 +76,13 @@ export type User = {
     readonly oauthProviders: readonly string[];
     toJson(this: CurrentUser): UserJson;
 };
-export type CurrentUser = Auth<User, UserCustomizableJson> & User;
-export type CurrentInternalUser = CurrentUser & InternalAuth<CurrentUser>;
+type CurrentUser = Auth<User, UserCustomizableJson> & User;
+type CurrentInternalUser = CurrentUser & InternalAuth<CurrentUser>;
 /**
  * A user including sensitive fields that should only be used on the server, never sent to the client
  * (such as sensitive information and serverMetadata).
  */
-export type ServerUser = Omit<User, "toJson"> & {
+type ServerUser = Omit<User, "toJson"> & {
     readonly serverMetadata: ReadonlyJson;
     /**
      * Returns a new user object with the sensitive fields removed.
@@ -93,11 +92,11 @@ export type ServerUser = Omit<User, "toJson"> & {
     update(this: ServerUser, user: Partial<ServerUserCustomizableJson>): Promise<void>;
     delete(this: ServerUser): Promise<void>;
 };
-export type CurrentServerUser = Auth<ServerUser, ServerUserCustomizableJson> & Omit<ServerUser, "getClientUser"> & {
+type CurrentServerUser = Auth<ServerUser, ServerUserCustomizableJson> & Omit<ServerUser, "getClientUser"> & {
     getClientUser(this: CurrentServerUser): CurrentUser;
 };
-export type CurrentInternalServerUser = CurrentServerUser & InternalAuth<CurrentServerUser>;
-export type Project = {
+type CurrentInternalServerUser = CurrentServerUser & InternalAuth<CurrentServerUser>;
+type Project = {
     readonly id: string;
     readonly displayName: string;
     readonly description?: string;
@@ -117,7 +116,7 @@ export type Project = {
     toJson(this: Project): ProjectJson;
     getProductionModeErrors(this: Project): ProductionModeError[];
 };
-export type ApiKeySetBase = {
+type ApiKeySetBase = {
     id: string;
     description: string;
     expiresAt: Date;
@@ -127,12 +126,12 @@ export type ApiKeySetBase = {
     whyInvalid(): "expired" | "manually-revoked" | null;
     revoke(): Promise<void>;
 };
-export type ApiKeySetFirstView = ApiKeySetBase & {
+type ApiKeySetFirstView = ApiKeySetBase & {
     publishableClientKey?: string;
     secretServerKey?: string;
     superSecretAdminKey?: string;
 };
-export type ApiKeySet = ApiKeySetBase & {
+type ApiKeySet = ApiKeySetBase & {
     publishableClientKey: null | {
         lastFour: string;
     };
@@ -143,10 +142,10 @@ export type ApiKeySet = ApiKeySetBase & {
         lastFour: string;
     };
 };
-export type EmailConfig = EmailConfigJson;
-export type DomainConfig = DomainConfigJson;
-export type OAuthProviderConfig = OAuthProviderConfigJson;
-export type GetUserOptions = {
+type EmailConfig = EmailConfigJson;
+type DomainConfig = DomainConfigJson;
+type OAuthProviderConfig = OAuthProviderConfigJson;
+type GetUserOptions = {
     or?: 'redirect' | 'throw' | 'return-null';
 };
 type AsyncStoreProperty<Name extends string, Value, IsMultiple extends boolean> = {
@@ -156,7 +155,14 @@ type AsyncStoreProperty<Name extends string, Value, IsMultiple extends boolean>
 } & {
     [key in `use${Capitalize<Name>}`]: () => Value;
 };
-export type StackClientApp<HasTokenStore extends boolean = boolean, ProjectId extends string = string> = ({
+type StackClientAppConstructor = {
+    new <TokenStoreType extends string, HasTokenStore extends (TokenStoreType extends {} ? true : boolean), ProjectId extends string>(options: StackClientAppConstructorOptions<HasTokenStore, ProjectId>): StackClientApp<HasTokenStore, ProjectId>;
+    new (options: StackClientAppConstructorOptions<boolean, string>): StackClientApp<boolean, string>;
+    [stackAppInternalsSymbol]: {
+        fromClientJson<HasTokenStore extends boolean, ProjectId extends string>(json: StackClientAppJson<HasTokenStore, ProjectId>): StackClientApp<HasTokenStore, ProjectId>;
+    };
+};
+type StackClientApp<HasTokenStore extends boolean = boolean, ProjectId extends string = string> = ({
     readonly projectId: ProjectId;
     readonly urls: Readonly<HandlerUrls>;
     signInWithOAuth(provider: string): Promise<void>;
@@ -179,7 +185,8 @@ export type StackClientApp<HasTokenStore extends boolean = boolean, ProjectId ex
     verifyEmail(code: string): Promise<KnownErrors["EmailVerificationError"] | undefined>;
     signInWithMagicLink(code: string): Promise<KnownErrors["MagicLinkError"] | undefined>;
     [stackAppInternalsSymbol]: {
-        toClientJson(): Promise<StackClientAppJson<HasTokenStore, ProjectId>>;
+        toClientJson(): StackClientAppJson<HasTokenStore, ProjectId>;
+        setCurrentUser(userJsonPromise: Promise<UserJson | null>): void;
     };
 } & AsyncStoreProperty<"project", ClientProjectJson, false> & {
     [K in `redirectTo${Capitalize<keyof Omit<HandlerUrls, 'handler' | 'oauthCallback'>>}`]: () => Promise<never>;
@@ -201,26 +208,20 @@ export type StackClientApp<HasTokenStore extends boolean = boolean, ProjectId ex
     getUser(options?: GetUserOptions): Promise<ProjectCurrentUser<ProjectId> | null>;
     onUserChange: AsyncStoreProperty<"user", CurrentUser | null, false>["onUserChange"];
 }));
-type StackClientAppConstructor = {
-    new <TokenStoreType extends string, HasTokenStore extends (TokenStoreType extends {} ? true : boolean), ProjectId extends string>(options: StackClientAppConstructorOptions<HasTokenStore, ProjectId>): StackClientApp<HasTokenStore, ProjectId>;
-    new (options: StackClientAppConstructorOptions<boolean, string>): StackClientApp<boolean, string>;
-    [stackAppInternalsSymbol]: {
-        fromClientJson<HasTokenStore extends boolean, ProjectId extends string>(json: StackClientAppJson<HasTokenStore, ProjectId>): StackClientApp<HasTokenStore, ProjectId>;
-    };
-};
-export declare const StackClientApp: StackClientAppConstructor;
-export type StackServerApp<HasTokenStore extends boolean = boolean, ProjectId extends string = string> = (StackClientApp<HasTokenStore, ProjectId> & AsyncStoreProperty<"serverUser", CurrentServerUser | null, false> & AsyncStoreProperty<"serverUsers", ServerUser[], true> & {});
+declare const StackClientApp: StackClientAppConstructor;
 type StackServerAppConstructor = {
     new <TokenStoreType extends string, HasTokenStore extends (TokenStoreType extends {} ? true : boolean), ProjectId extends string>(options: StackServerAppConstructorOptions<HasTokenStore, ProjectId>): StackServerApp<HasTokenStore, ProjectId>;
     new (options: StackServerAppConstructorOptions<boolean, string>): StackServerApp<boolean, string>;
 };
-export declare const StackServerApp: StackServerAppConstructor;
-export type StackAdminApp<HasTokenStore extends boolean = boolean, ProjectId extends string = string> = (StackServerApp<HasTokenStore, ProjectId> & AsyncStoreProperty<"projectAdmin", Project, false> & AsyncStoreProperty<"apiKeySets", ApiKeySet[], true> & {
-    createApiKeySet(options: ApiKeySetCreateOptions): Promise<ApiKeySetFirstView>;
-});
+type StackServerApp<HasTokenStore extends boolean = boolean, ProjectId extends string = string> = (StackClientApp<HasTokenStore, ProjectId> & AsyncStoreProperty<"serverUser", CurrentServerUser | null, false> & AsyncStoreProperty<"serverUsers", ServerUser[], true> & {});
+declare const StackServerApp: StackServerAppConstructor;
 type StackAdminAppConstructor = {
     new <HasTokenStore extends boolean, ProjectId extends string>(options: StackAdminAppConstructorOptions<HasTokenStore, ProjectId>): StackAdminApp<HasTokenStore, ProjectId>;
     new (options: StackAdminAppConstructorOptions<boolean, string>): StackAdminApp<boolean, string>;
 };
-export declare const StackAdminApp: StackAdminAppConstructor;
-export {};
+type StackAdminApp<HasTokenStore extends boolean = boolean, ProjectId extends string = string> = (StackServerApp<HasTokenStore, ProjectId> & AsyncStoreProperty<"projectAdmin", Project, false> & AsyncStoreProperty<"apiKeySets", ApiKeySet[], true> & {
+    createApiKeySet(options: ApiKeySetCreateOptions): Promise<ApiKeySetFirstView>;
+});
+declare const StackAdminApp: StackAdminAppConstructor;
+
+export { type ApiKeySet, type ApiKeySetBase, type ApiKeySetFirstView, type CurrentInternalServerUser, type CurrentInternalUser, type CurrentServerUser, type CurrentUser, type DomainConfig, type EmailConfig, type GetUserOptions, type HandlerUrls, type OAuthProviderConfig, type Project, type ServerUser, StackAdminApp, type StackAdminAppConstructorOptions, StackClientApp, type StackClientAppConstructorOptions, type StackClientAppJson, StackServerApp, type StackServerAppConstructorOptions, type TokenStoreOptions, type User, stackAppInternalsSymbol };