@stackframe/js 2.7.22 → 2.7.25

package/dist/index.d.mts

@@ -1,23 +1,746 @@
-export { f as AdminOwnedProject, r as AdminProject, _ as AdminProjectCreateOptions, g as AdminProjectUpdateOptions, A as Auth, y as CurrentInternalServerUser, u as CurrentInternalUser, x as CurrentServerUser, C as CurrentUser, E as EditableTeamMemberProfile, P as Project, o as ServerListUsersOptions, m as ServerTeam, p as ServerTeamCreateOptions, N as ServerTeamMemberProfile, Q as ServerTeamUpdateOptions, k as ServerTeamUser, j as ServerUser, s as Session, X as StackAdminApp, Y as StackAdminAppConstructor, q as StackAdminAppConstructorOptions, a as StackClientApp, a0 as StackClientAppConstructor, S as StackClientAppConstructorOptions, h as StackClientAppJson, V as StackServerApp, W as StackServerAppConstructor, i as StackServerAppConstructorOptions, c as Team, L as TeamCreateOptions, b as TeamInvitation, G as TeamMemberProfile, J as TeamUpdateOptions, T as TeamUser, t as User } from './index-COYzPcGI.mjs';
-export { AdminDomainConfig, AdminEmailConfig, AdminOAuthProviderConfig, AdminProjectConfig, AdminProjectConfigUpdateOptions, OAuthProviderConfig, ProjectConfig } from './lib/stack-app/project-configs/index.mjs';
-export { ApiKey, ApiKeyBase, ApiKeyBaseCrudRead, ApiKeyCreateOptions, ApiKeyFirstView } from './lib/stack-app/api-keys/index.mjs';
-export { GetUserOptions, HandlerUrls, OAuthScopesOnSignIn, stackAppInternalsSymbol } from './lib/stack-app/common.mjs';
-export { Connection, OAuthConnection } from './lib/stack-app/connected-accounts/index.mjs';
-export { ContactChannel } from './lib/stack-app/contact-channels/index.mjs';
-export { AdminTeamPermission, AdminTeamPermissionDefinition, AdminTeamPermissionDefinitionCreateOptions, AdminTeamPermissionDefinitionUpdateOptions, TeamPermission } from './lib/stack-app/permissions/index.mjs';
-import '@stackframe/stack-shared';
-import '@stackframe/stack-shared/dist/interface/crud/current-user';
-import '@stackframe/stack-shared/dist/utils/results';
-import '@stackframe/stack-shared/dist/helpers/production-mode';
-import '@stackframe/stack-shared/dist/interface/crud/projects';
-import '@stackframe/stack-shared/dist/interface/crud/email-templates';
-import '@stackframe/stack-shared/dist/sessions';
-import './lib/stack-app/email-templates/index.mjs';
-import '@stackframe/stack-shared/dist/interface/crud/teams';
-import '@stackframe/stack-shared/dist/utils/json';
-import '@stackframe/stack-shared/dist/interface/crud/users';
-import '@stackframe/stack-shared/dist/utils/oauth';
-import '@stackframe/stack-shared/dist/interface/crud/team-permissions';
-import '@stackframe/stack-shared/dist/interface/adminInterface';
-import '@stackframe/stack-shared/dist/interface/crud/api-keys';
-import '@stackframe/stack-shared/dist/interface/crud/contact-channels';
+import { KnownErrors } from '@stackframe/stack-shared';
+import { CurrentUserCrud } from '@stackframe/stack-shared/dist/interface/crud/current-user';
+import { Result } from '@stackframe/stack-shared/dist/utils/results';
+import { ProviderType } from '@stackframe/stack-shared/dist/utils/oauth';
+import { ProductionModeError } from '@stackframe/stack-shared/dist/helpers/production-mode';
+import { EmailTemplateType } from '@stackframe/stack-shared/dist/interface/crud/email-templates';
+import { InternalSession } from '@stackframe/stack-shared/dist/sessions';
+import { ApiKeysCrud } from '@stackframe/stack-shared/dist/interface/crud/api-keys';
+import { ReadonlyJson } from '@stackframe/stack-shared/dist/utils/json';
+
+type RedirectToOptions = {
+    replace?: boolean;
+    noRedirectBack?: boolean;
+};
+type AsyncStoreProperty<Name extends string, Args extends any[], Value, IsMultiple extends boolean> = {
+    [key in `${IsMultiple extends true ? "list" : "get"}${Capitalize<Name>}`]: (...args: Args) => Promise<Value>;
+};
+type EmailConfig = {
+    host: string;
+    port: number;
+    username: string;
+    password: string;
+    senderEmail: string;
+    senderName: string;
+};
+type RedirectMethod = "window" | "none" | {
+    useNavigate: () => (to: string) => void;
+    navigate?: (to: string) => void;
+};
+type GetUserOptions<HasTokenStore> = {
+    or?: 'redirect' | 'throw' | 'return-null';
+    tokenStore?: TokenStoreInit;
+} & (HasTokenStore extends false ? {
+    tokenStore: TokenStoreInit;
+} : {});
+type RequestLike = {
+    headers: {
+        get: (name: string) => string | null;
+    };
+};
+type TokenStoreInit<HasTokenStore extends boolean = boolean> = HasTokenStore extends true ? ("cookie" | "nextjs-cookie" | "memory" | RequestLike | {
+    accessToken: string;
+    refreshToken: string;
+}) : HasTokenStore extends false ? null : TokenStoreInit<true> | TokenStoreInit<false>;
+type HandlerUrls = {
+    handler: string;
+    signIn: string;
+    signUp: string;
+    afterSignIn: string;
+    afterSignUp: string;
+    signOut: string;
+    afterSignOut: string;
+    emailVerification: string;
+    passwordReset: string;
+    forgotPassword: string;
+    home: string;
+    oauthCallback: string;
+    magicLinkCallback: string;
+    accountSettings: string;
+    teamInvitation: string;
+    error: string;
+};
+type OAuthScopesOnSignIn = {
+    [key in ProviderType]: string[];
+};
+/** @internal */
+declare const stackAppInternalsSymbol: unique symbol;
+
+type ApiKeyBase = {
+    id: string;
+    description: string;
+    expiresAt: Date;
+    manuallyRevokedAt: Date | null;
+    createdAt: Date;
+    isValid(): boolean;
+    whyInvalid(): "expired" | "manually-revoked" | null;
+    revoke(): Promise<void>;
+};
+type ApiKeyBaseCrudRead = Pick<ApiKeysCrud["Admin"]["Read"], "id" | "created_at_millis" | "description" | "expires_at_millis" | "manually_revoked_at_millis">;
+type ApiKeyFirstView = {
+    publishableClientKey?: string;
+    secretServerKey?: string;
+    superSecretAdminKey?: string;
+} & ApiKeyBase;
+type ApiKey = {
+    publishableClientKey: null | {
+        lastFour: string;
+    };
+    secretServerKey: null | {
+        lastFour: string;
+    };
+    superSecretAdminKey: null | {
+        lastFour: string;
+    };
+} & ApiKeyBase;
+type ApiKeyCreateOptions = {
+    description: string;
+    expiresAt: Date;
+    hasPublishableClientKey: boolean;
+    hasSecretServerKey: boolean;
+    hasSuperSecretAdminKey: boolean;
+};
+
+type AdminEmailTemplate = {
+    type: EmailTemplateType;
+    subject: string;
+    content: any;
+    isDefault: boolean;
+};
+type AdminEmailTemplateUpdateOptions = {
+    subject?: string;
+    content?: any;
+};
+
+type TeamPermission = {
+    id: string;
+};
+type AdminTeamPermission = TeamPermission;
+type AdminTeamPermissionDefinition = {
+    id: string;
+    description?: string;
+    containedPermissionIds: string[];
+};
+type AdminTeamPermissionDefinitionCreateOptions = {
+    id: string;
+    description?: string;
+    containedPermissionIds: string[];
+};
+type AdminTeamPermissionDefinitionUpdateOptions = Partial<AdminTeamPermissionDefinitionCreateOptions>;
+
+type Connection = {
+    id: string;
+};
+type OAuthConnection = {
+    getAccessToken(): Promise<{
+        accessToken: string;
+    }>;
+} & Connection;
+
+type ContactChannel = {
+    id: string;
+    value: string;
+    type: 'email';
+    isPrimary: boolean;
+    isVerified: boolean;
+    usedForAuth: boolean;
+    sendVerificationEmail(): Promise<void>;
+    update(data: ContactChannelUpdateOptions): Promise<void>;
+    delete(): Promise<void>;
+};
+type ContactChannelCreateOptions = {
+    value: string;
+    type: 'email';
+    usedForAuth: boolean;
+};
+type ContactChannelUpdateOptions = {
+    usedForAuth?: boolean;
+    value?: string;
+    isPrimary?: boolean;
+};
+type ServerContactChannel = ContactChannel & {
+    update(data: ServerContactChannelUpdateOptions): Promise<void>;
+};
+type ServerContactChannelUpdateOptions = ContactChannelUpdateOptions & {
+    isVerified?: boolean;
+};
+type ServerContactChannelCreateOptions = ContactChannelCreateOptions & {
+    isVerified?: boolean;
+};
+
+type Session = {
+    getTokens(): Promise<{
+        accessToken: string | null;
+        refreshToken: string | null;
+    }>;
+};
+/**
+ * Contains everything related to the current user session.
+ */
+type Auth = {
+    readonly _internalSession: InternalSession;
+    readonly currentSession: Session;
+    signOut(options?: {
+        redirectUrl?: URL | string;
+    }): Promise<void>;
+    /**
+     * Returns headers for sending authenticated HTTP requests to external servers. Most commonly used in cross-origin
+     * requests. Similar to `getAuthJson`, but specifically for HTTP requests.
+     *
+     * If you are using `tokenStore: "cookie"`, you don't need this for same-origin requests. However, most
+     * browsers now disable third-party cookies by default, so we must pass authentication tokens by header instead
+     * if the client and server are on different origins.
+     *
+     * This function returns a header object that can be used with `fetch` or other HTTP request libraries to send
+     * authenticated requests.
+     *
+     * On the server, you can then pass in the `Request` object to the `tokenStore` option
+     * of your Stack app. Please note that CORS does not allow most headers by default, so you
+     * must include `x-stack-auth` in the [`Access-Control-Allow-Headers` header](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Headers)
+     * of the CORS preflight response.
+     *
+     * If you are not using HTTP (and hence cannot set headers), you will need to use the `getAuthJson()` function
+     * instead.
+     *
+     * Example:
+     *
+     * ```ts
+     * // client
+     * const res = await fetch("https://api.example.com", {
+     *   headers: {
+     *     ...await stackApp.getAuthHeaders()
+     *     // you can also add your own headers here
+     *   },
+     * });
+     *
+     * // server
+     * function handleRequest(req: Request) {
+     *   const user = await stackServerApp.getUser({ tokenStore: req });
+     *   return new Response("Welcome, " + user.displayName);
+     * }
+     * ```
+     */
+    getAuthHeaders(): Promise<{
+        "x-stack-auth": string;
+    }>;
+    /**
+     * Creates a JSON-serializable object containing the information to authenticate a user on an external server.
+     * Similar to `getAuthHeaders`, but returns an object that can be sent over any protocol instead of just
+     * HTTP headers.
+     *
+     * While `getAuthHeaders` is the recommended way to send authentication tokens over HTTP, your app may use
+     * a different protocol, for example WebSockets or gRPC. This function returns a token object that can be JSON-serialized and sent to the server in any way you like.
+     *
+     * On the server, you can pass in this token object into the `tokenStore` option to fetch user details.
+     *
+     * Example:
+     *
+     * ```ts
+     * // client
+     * const res = await rpcCall(rpcEndpoint, {
+     *   data: {
+     *     auth: await stackApp.getAuthJson(),
+     *   },
+     * });
+     *
+     * // server
+     * function handleRequest(data) {
+     *   const user = await stackServerApp.getUser({ tokenStore: data.auth });
+     *   return new Response("Welcome, " + user.displayName);
+     * }
+     * ```
+     */
+    getAuthJson(): Promise<{
+        accessToken: string | null;
+        refreshToken: string | null;
+    }>;
+    registerPasskey(options?: {
+        hostname?: string;
+    }): Promise<Result<undefined, KnownErrors["PasskeyRegistrationFailed"] | KnownErrors["PasskeyWebAuthnError"]>>;
+};
+/**
+ * ```
+ * +----------+-------------+-------------------+
+ * |    \     |   !Server   |      Server       |
+ * +----------+-------------+-------------------+
+ * | !Session | User        | ServerUser        |
+ * | Session  | CurrentUser | CurrentServerUser |
+ * +----------+-------------+-------------------+
+ * ```
+ *
+ * The fields on each of these types are available iff:
+ * BaseUser: true
+ * Auth: Session
+ * ServerBaseUser: Server
+ * UserExtra: Session OR Server
+ *
+ * The types are defined as follows (in the typescript manner):
+ * User = BaseUser
+ * CurrentUser = BaseUser & Auth & UserExtra
+ * ServerUser = BaseUser & ServerBaseUser & UserExtra
+ * CurrentServerUser = BaseUser & ServerBaseUser & Auth & UserExtra
+ **/
+type BaseUser = {
+    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: any;
+    readonly clientReadOnlyMetadata: any;
+    /**
+     * Whether the user has a password set.
+     */
+    readonly hasPassword: boolean;
+    readonly otpAuthEnabled: boolean;
+    readonly passkeyAuthEnabled: boolean;
+    readonly isMultiFactorRequired: boolean;
+    toClientJson(): CurrentUserCrud["Client"]["Read"];
+    /**
+     * @deprecated, use contact channel's usedForAuth instead
+     */
+    readonly emailAuthEnabled: boolean;
+    /**
+     * @deprecated
+     */
+    readonly oauthProviders: readonly {
+        id: string;
+    }[];
+};
+type UserExtra = {
+    setDisplayName(displayName: string): Promise<void>;
+    /** @deprecated Use contact channel's sendVerificationEmail instead */
+    sendVerificationEmail(): Promise<KnownErrors["EmailAlreadyVerified"] | void>;
+    setClientMetadata(metadata: any): Promise<void>;
+    updatePassword(options: {
+        oldPassword: string;
+        newPassword: string;
+    }): Promise<KnownErrors["PasswordConfirmationMismatch"] | KnownErrors["PasswordRequirementsNotMet"] | void>;
+    setPassword(options: {
+        password: string;
+    }): Promise<KnownErrors["PasswordRequirementsNotMet"] | void>;
+    /**
+     * A shorthand method to update multiple fields of the user at once.
+     */
+    update(update: UserUpdateOptions): Promise<void>;
+    listContactChannels(): Promise<ContactChannel[]>;
+    createContactChannel(data: ContactChannelCreateOptions): Promise<ContactChannel>;
+    delete(): Promise<void>;
+    getConnectedAccount(id: ProviderType, options: {
+        or: 'redirect';
+        scopes?: string[];
+    }): Promise<OAuthConnection>;
+    getConnectedAccount(id: ProviderType, options?: {
+        or?: 'redirect' | 'throw' | 'return-null';
+        scopes?: string[];
+    }): Promise<OAuthConnection | null>;
+    hasPermission(scope: Team, permissionId: string): Promise<boolean>;
+    readonly selectedTeam: Team | null;
+    setSelectedTeam(team: Team | null): Promise<void>;
+    createTeam(data: TeamCreateOptions): Promise<Team>;
+    leaveTeam(team: Team): Promise<void>;
+    getTeamProfile(team: Team): Promise<EditableTeamMemberProfile>;
+} & AsyncStoreProperty<"team", [id: string], Team | null, false> & AsyncStoreProperty<"teams", [], Team[], true> & AsyncStoreProperty<"permission", [scope: Team, permissionId: string, options?: {
+    recursive?: boolean;
+}], TeamPermission | null, false> & AsyncStoreProperty<"permissions", [scope: Team, options?: {
+    recursive?: boolean;
+}], TeamPermission[], true>;
+type InternalUserExtra = {
+    createProject(newProject: AdminProjectUpdateOptions & {
+        displayName: string;
+    }): Promise<AdminOwnedProject>;
+} & AsyncStoreProperty<"ownedProjects", [], AdminOwnedProject[], true>;
+type User = BaseUser;
+type CurrentUser = BaseUser & Auth & UserExtra;
+type CurrentInternalUser = CurrentUser & InternalUserExtra;
+type ProjectCurrentUser<ProjectId> = ProjectId extends "internal" ? CurrentInternalUser : CurrentUser;
+type UserUpdateOptions = {
+    displayName?: string;
+    clientMetadata?: ReadonlyJson;
+    selectedTeamId?: string | null;
+    totpMultiFactorSecret?: Uint8Array | null;
+    profileImageUrl?: string | null;
+    otpAuthEnabled?: boolean;
+    passkeyAuthEnabled?: boolean;
+};
+type ServerBaseUser = {
+    setPrimaryEmail(email: string | null, options?: {
+        verified?: boolean | undefined;
+    }): Promise<void>;
+    readonly lastActiveAt: Date;
+    readonly serverMetadata: any;
+    setServerMetadata(metadata: any): Promise<void>;
+    setClientReadOnlyMetadata(metadata: any): Promise<void>;
+    createTeam(data: Omit<ServerTeamCreateOptions, "creatorUserId">): Promise<ServerTeam>;
+    listContactChannels(): Promise<ServerContactChannel[]>;
+    createContactChannel(data: ServerContactChannelCreateOptions): Promise<ServerContactChannel>;
+    update(user: ServerUserUpdateOptions): Promise<void>;
+    grantPermission(scope: Team, permissionId: string): Promise<void>;
+    revokePermission(scope: Team, permissionId: string): Promise<void>;
+    /**
+     * Creates a new session object with a refresh token for this user. Can be used to impersonate them.
+     */
+    createSession(options?: {
+        expiresInMillis?: number;
+    }): Promise<Session>;
+} & AsyncStoreProperty<"team", [id: string], ServerTeam | null, false> & AsyncStoreProperty<"teams", [], ServerTeam[], true> & AsyncStoreProperty<"permission", [scope: Team, permissionId: string, options?: {
+    direct?: boolean;
+}], AdminTeamPermission | null, false> & AsyncStoreProperty<"permissions", [scope: Team, options?: {
+    direct?: boolean;
+}], AdminTeamPermission[], true>;
+/**
+ * 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 = ServerBaseUser & BaseUser & UserExtra;
+type CurrentServerUser = Auth & ServerUser;
+type CurrentInternalServerUser = CurrentServerUser & InternalUserExtra;
+type ProjectCurrentServerUser<ProjectId> = ProjectId extends "internal" ? CurrentInternalServerUser : CurrentServerUser;
+type ServerUserUpdateOptions = {
+    primaryEmail?: string | null;
+    primaryEmailVerified?: boolean;
+    primaryEmailAuthEnabled?: boolean;
+    clientReadOnlyMetadata?: ReadonlyJson;
+    serverMetadata?: ReadonlyJson;
+    password?: string;
+} & UserUpdateOptions;
+type ServerUserCreateOptions = {
+    primaryEmail?: string | null;
+    primaryEmailAuthEnabled?: boolean;
+    password?: string;
+    otpAuthEnabled?: boolean;
+    displayName?: string;
+    primaryEmailVerified?: boolean;
+    clientMetadata?: any;
+    clientReadOnlyMetadata?: any;
+    serverMetadata?: any;
+};
+
+type TeamMemberProfile = {
+    displayName: string | null;
+    profileImageUrl: string | null;
+};
+type TeamMemberProfileUpdateOptions = {
+    displayName?: string;
+    profileImageUrl?: string | null;
+};
+type EditableTeamMemberProfile = TeamMemberProfile & {
+    update(update: TeamMemberProfileUpdateOptions): Promise<void>;
+};
+type TeamUser = {
+    id: string;
+    teamProfile: TeamMemberProfile;
+};
+type TeamInvitation = {
+    id: string;
+    recipientEmail: string | null;
+    expiresAt: Date;
+    revoke(): Promise<void>;
+};
+type Team = {
+    id: string;
+    displayName: string;
+    profileImageUrl: string | null;
+    clientMetadata: any;
+    clientReadOnlyMetadata: any;
+    inviteUser(options: {
+        email: string;
+        callbackUrl?: string;
+    }): Promise<void>;
+    listUsers(): Promise<TeamUser[]>;
+    listInvitations(): Promise<TeamInvitation[]>;
+    update(update: TeamUpdateOptions): Promise<void>;
+    delete(): Promise<void>;
+};
+type TeamUpdateOptions = {
+    displayName?: string;
+    profileImageUrl?: string | null;
+    clientMetadata?: ReadonlyJson;
+};
+type TeamCreateOptions = {
+    displayName: string;
+    profileImageUrl?: string;
+};
+type ServerTeamMemberProfile = TeamMemberProfile;
+type ServerTeamUser = ServerUser & {
+    teamProfile: ServerTeamMemberProfile;
+};
+type ServerTeam = {
+    createdAt: Date;
+    serverMetadata: any;
+    listUsers(): Promise<ServerTeamUser[]>;
+    update(update: ServerTeamUpdateOptions): Promise<void>;
+    delete(): Promise<void>;
+    addUser(userId: string): Promise<void>;
+    inviteUser(options: {
+        email: string;
+        callbackUrl?: string;
+    }): Promise<void>;
+    removeUser(userId: string): Promise<void>;
+} & Team;
+type ServerListUsersOptions = {
+    cursor?: string;
+    limit?: number;
+    orderBy?: 'signedUpAt';
+    desc?: boolean;
+    query?: string;
+};
+type ServerTeamCreateOptions = TeamCreateOptions & {
+    creatorUserId?: string;
+};
+type ServerTeamUpdateOptions = TeamUpdateOptions & {
+    clientReadOnlyMetadata?: ReadonlyJson;
+    serverMetadata?: ReadonlyJson;
+};
+
+type StackServerAppConstructorOptions<HasTokenStore extends boolean, ProjectId extends string> = StackClientAppConstructorOptions<HasTokenStore, ProjectId> & {
+    secretServerKey?: string;
+};
+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> = ({
+    createTeam(data: ServerTeamCreateOptions): Promise<ServerTeam>;
+    /**
+     * @deprecated use `getUser()` instead
+     */
+    getServerUser(): Promise<ProjectCurrentServerUser<ProjectId> | null>;
+    createUser(options: ServerUserCreateOptions): Promise<ServerUser>;
+    getUser(options: GetUserOptions<HasTokenStore> & {
+        or: 'redirect';
+    }): Promise<ProjectCurrentServerUser<ProjectId>>;
+    getUser(options: GetUserOptions<HasTokenStore> & {
+        or: 'throw';
+    }): Promise<ProjectCurrentServerUser<ProjectId>>;
+    getUser(options?: GetUserOptions<HasTokenStore>): Promise<ProjectCurrentServerUser<ProjectId> | null>;
+    listUsers(options?: ServerListUsersOptions): Promise<ServerUser[] & {
+        nextCursor: string | null;
+    }>;
+} & AsyncStoreProperty<"user", [id: string], ServerUser | null, false> & Omit<AsyncStoreProperty<"users", [], ServerUser[], true>, "listUsers" | "useUsers"> & AsyncStoreProperty<"team", [id: string], ServerTeam | null, false> & AsyncStoreProperty<"teams", [], ServerTeam[], true> & StackClientApp<HasTokenStore, ProjectId>);
+declare const StackServerApp: StackServerAppConstructor;
+
+type StackAdminAppConstructorOptions<HasTokenStore extends boolean, ProjectId extends string> = ((StackServerAppConstructorOptions<HasTokenStore, ProjectId> & {
+    superSecretAdminKey?: string;
+}) | (Omit<StackServerAppConstructorOptions<HasTokenStore, ProjectId>, "publishableClientKey" | "secretServerKey"> & {
+    projectOwnerSession: InternalSession;
+}));
+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> = (AsyncStoreProperty<"project", [], AdminProject, false> & AsyncStoreProperty<"apiKeys", [], ApiKey[], true> & AsyncStoreProperty<"teamPermissionDefinitions", [], AdminTeamPermissionDefinition[], true> & {
+    listEmailTemplates(): Promise<AdminEmailTemplate[]>;
+    updateEmailTemplate(type: EmailTemplateType, data: AdminEmailTemplateUpdateOptions): Promise<void>;
+    resetEmailTemplate(type: EmailTemplateType): Promise<void>;
+    createApiKey(options: ApiKeyCreateOptions): Promise<ApiKeyFirstView>;
+    createTeamPermissionDefinition(data: AdminTeamPermissionDefinitionCreateOptions): Promise<AdminTeamPermission>;
+    updateTeamPermissionDefinition(permissionId: string, data: AdminTeamPermissionDefinitionUpdateOptions): Promise<void>;
+    deleteTeamPermissionDefinition(permissionId: string): Promise<void>;
+    sendTestEmail(options: {
+        recipientEmail: string;
+        emailConfig: EmailConfig;
+    }): Promise<Result<undefined, {
+        errorMessage: string;
+    }>>;
+} & StackServerApp<HasTokenStore, ProjectId>);
+declare const StackAdminApp: StackAdminAppConstructor;
+
+type ProjectConfig = {
+    readonly signUpEnabled: boolean;
+    readonly credentialEnabled: boolean;
+    readonly magicLinkEnabled: boolean;
+    readonly passkeyEnabled: boolean;
+    readonly clientTeamCreationEnabled: boolean;
+    readonly clientUserDeletionEnabled: boolean;
+    readonly oauthProviders: OAuthProviderConfig[];
+};
+type OAuthProviderConfig = {
+    readonly id: string;
+};
+type AdminProjectConfig = {
+    readonly id: string;
+    readonly signUpEnabled: boolean;
+    readonly credentialEnabled: boolean;
+    readonly magicLinkEnabled: boolean;
+    readonly passkeyEnabled: boolean;
+    readonly clientTeamCreationEnabled: boolean;
+    readonly clientUserDeletionEnabled: boolean;
+    readonly allowLocalhost: boolean;
+    readonly oauthProviders: AdminOAuthProviderConfig[];
+    readonly emailConfig?: AdminEmailConfig;
+    readonly domains: AdminDomainConfig[];
+    readonly createTeamOnSignUp: boolean;
+    readonly teamCreatorDefaultPermissions: AdminTeamPermission[];
+    readonly teamMemberDefaultPermissions: AdminTeamPermission[];
+};
+type AdminEmailConfig = ({
+    type: "standard";
+    senderName: string;
+    senderEmail: string;
+    host: string;
+    port: number;
+    username: string;
+    password: string;
+} | {
+    type: "shared";
+});
+type AdminDomainConfig = {
+    domain: string;
+    handlerPath: string;
+};
+type AdminOAuthProviderConfig = {
+    id: string;
+    enabled: boolean;
+} & ({
+    type: 'shared';
+} | {
+    type: 'standard';
+    clientId: string;
+    clientSecret: string;
+    facebookConfigId?: string;
+    microsoftTenantId?: string;
+}) & OAuthProviderConfig;
+type AdminProjectConfigUpdateOptions = {
+    domains?: {
+        domain: string;
+        handlerPath: string;
+    }[];
+    oauthProviders?: AdminOAuthProviderConfig[];
+    signUpEnabled?: boolean;
+    credentialEnabled?: boolean;
+    magicLinkEnabled?: boolean;
+    passkeyEnabled?: boolean;
+    clientTeamCreationEnabled?: boolean;
+    clientUserDeletionEnabled?: boolean;
+    allowLocalhost?: boolean;
+    createTeamOnSignUp?: boolean;
+    emailConfig?: AdminEmailConfig;
+    teamCreatorDefaultPermissions?: {
+        id: string;
+    }[];
+    teamMemberDefaultPermissions?: {
+        id: string;
+    }[];
+};
+
+type Project = {
+    readonly id: string;
+    readonly displayName: string;
+    readonly config: ProjectConfig;
+};
+type AdminProject = {
+    readonly id: string;
+    readonly displayName: string;
+    readonly description: string | null;
+    readonly createdAt: Date;
+    readonly userCount: number;
+    readonly isProductionMode: boolean;
+    readonly config: AdminProjectConfig;
+    update(this: AdminProject, update: AdminProjectUpdateOptions): Promise<void>;
+    delete(this: AdminProject): Promise<void>;
+    getProductionModeErrors(this: AdminProject): Promise<ProductionModeError[]>;
+    useProductionModeErrors(this: AdminProject): ProductionModeError[];
+} & Project;
+type AdminOwnedProject = {
+    readonly app: StackAdminApp<false>;
+} & AdminProject;
+type AdminProjectUpdateOptions = {
+    displayName?: string;
+    description?: string;
+    isProductionMode?: boolean;
+    config?: AdminProjectConfigUpdateOptions;
+};
+type AdminProjectCreateOptions = Omit<AdminProjectUpdateOptions, 'displayName'> & {
+    displayName: string;
+};
+
+type StackClientAppConstructorOptions<HasTokenStore extends boolean, ProjectId extends string> = {
+    baseUrl?: string | {
+        browser: string;
+        server: string;
+    };
+    projectId?: ProjectId;
+    publishableClientKey?: string;
+    urls?: Partial<HandlerUrls>;
+    oauthScopesOnSignIn?: Partial<OAuthScopesOnSignIn>;
+    tokenStore: TokenStoreInit<HasTokenStore>;
+    redirectMethod?: RedirectMethod;
+    /**
+     * By default, the Stack app will automatically prefetch some data from Stack's server when this app is first
+     * constructed. This improves the performance of your app, but will create network requests that are unnecessary if
+     * the app is never used or disposed of immediately. To disable this behavior, set this option to true.
+     */
+    noAutomaticPrefetch?: boolean;
+};
+type StackClientAppJson<HasTokenStore extends boolean, ProjectId extends string> = StackClientAppConstructorOptions<HasTokenStore, ProjectId> & {
+    uniqueIdentifier: 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>;
+    signInWithCredential(options: {
+        email: string;
+        password: string;
+        noRedirect?: boolean;
+    }): Promise<Result<undefined, KnownErrors["EmailPasswordMismatch"] | KnownErrors["InvalidTotpCode"]>>;
+    signUpWithCredential(options: {
+        email: string;
+        password: string;
+        noRedirect?: boolean;
+        verificationCallbackUrl?: string;
+    }): Promise<Result<undefined, KnownErrors["UserEmailAlreadyExists"] | KnownErrors["PasswordRequirementsNotMet"]>>;
+    signInWithPasskey(): Promise<Result<undefined, KnownErrors["PasskeyAuthenticationFailed"] | KnownErrors["InvalidTotpCode"] | KnownErrors["PasskeyWebAuthnError"]>>;
+    callOAuthCallback(): Promise<boolean>;
+    sendForgotPasswordEmail(email: string, options?: {
+        callbackUrl?: string;
+    }): Promise<Result<undefined, KnownErrors["UserNotFound"]>>;
+    sendMagicLinkEmail(email: string, options?: {
+        callbackUrl?: string;
+    }): Promise<Result<{
+        nonce: string;
+    }, KnownErrors["RedirectUrlNotWhitelisted"]>>;
+    resetPassword(options: {
+        code: string;
+        password: string;
+    }): Promise<Result<undefined, KnownErrors["VerificationCodeError"]>>;
+    verifyPasswordResetCode(code: string): Promise<Result<undefined, KnownErrors["VerificationCodeError"]>>;
+    verifyTeamInvitationCode(code: string): Promise<Result<undefined, KnownErrors["VerificationCodeError"]>>;
+    acceptTeamInvitation(code: string): Promise<Result<undefined, KnownErrors["VerificationCodeError"]>>;
+    getTeamInvitationDetails(code: string): Promise<Result<{
+        teamDisplayName: string;
+    }, KnownErrors["VerificationCodeError"]>>;
+    verifyEmail(code: string): Promise<Result<undefined, KnownErrors["VerificationCodeError"]>>;
+    signInWithMagicLink(code: string): Promise<Result<undefined, KnownErrors["VerificationCodeError"] | KnownErrors["InvalidTotpCode"]>>;
+    redirectToOAuthCallback(): Promise<void>;
+    getUser(options: GetUserOptions<HasTokenStore> & {
+        or: 'redirect';
+    }): Promise<ProjectCurrentUser<ProjectId>>;
+    getUser(options: GetUserOptions<HasTokenStore> & {
+        or: 'throw';
+    }): Promise<ProjectCurrentUser<ProjectId>>;
+    getUser(options?: GetUserOptions<HasTokenStore>): Promise<ProjectCurrentUser<ProjectId> | null>;
+    [stackAppInternalsSymbol]: {
+        toClientJson(): StackClientAppJson<HasTokenStore, ProjectId>;
+        setCurrentUser(userJsonPromise: Promise<CurrentUserCrud['Client']['Read'] | null>): void;
+    };
+} & AsyncStoreProperty<"project", [], Project, false> & {
+    [K in `redirectTo${Capitalize<keyof Omit<HandlerUrls, 'handler' | 'oauthCallback'>>}`]: (options?: RedirectToOptions) => Promise<void>;
+});
+declare const StackClientApp: StackClientAppConstructor;
+
+export { type AdminDomainConfig, type AdminEmailConfig, type AdminOAuthProviderConfig, type AdminOwnedProject, type AdminProject, type AdminProjectConfig, type AdminProjectConfigUpdateOptions, type AdminProjectCreateOptions, type AdminProjectUpdateOptions, type AdminTeamPermission, type AdminTeamPermissionDefinition, type AdminTeamPermissionDefinitionCreateOptions, type AdminTeamPermissionDefinitionUpdateOptions, type ApiKey, type ApiKeyBase, type ApiKeyBaseCrudRead, type ApiKeyCreateOptions, type ApiKeyFirstView, type Auth, type Connection, type ContactChannel, type CurrentInternalServerUser, type CurrentInternalUser, type CurrentServerUser, type CurrentUser, type EditableTeamMemberProfile, type GetUserOptions, type HandlerUrls, type OAuthConnection, type OAuthProviderConfig, type OAuthScopesOnSignIn, type Project, type ProjectConfig, type ServerListUsersOptions, type ServerTeam, type ServerTeamCreateOptions, type ServerTeamMemberProfile, type ServerTeamUpdateOptions, type ServerTeamUser, type ServerUser, type Session, StackAdminApp, type StackAdminAppConstructor, type StackAdminAppConstructorOptions, StackClientApp, type StackClientAppConstructor, type StackClientAppConstructorOptions, type StackClientAppJson, StackServerApp, type StackServerAppConstructor, type StackServerAppConstructorOptions, type Team, type TeamCreateOptions, type TeamInvitation, type TeamMemberProfile, type TeamPermission, type TeamUpdateOptions, type TeamUser, type User, stackAppInternalsSymbol };