@stackframe/stack 2.8.36 → 2.8.40

package/dist/index.d.ts

@@ -2,15 +2,17 @@ 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 { GenericQueryCtx, UserIdentity } from 'convex/server';
 import { inlineOfferSchema } from '@stackframe/stack-shared/dist/schema-fields';
 import * as yup from 'yup';
 import { ProductionModeError } from '@stackframe/stack-shared/dist/helpers/production-mode';
 import { CompleteConfig, EnvironmentConfigOverrideOverride } from '@stackframe/stack-shared/dist/config/schema';
 import { ChatContent } from '@stackframe/stack-shared/dist/interface/admin-interface';
+import { AdminTransaction } from '@stackframe/stack-shared/dist/interface/crud/transactions';
 import { InternalSession } from '@stackframe/stack-shared/dist/sessions';
+import { XOR, PrettifyType, IfAndOnlyIf } from '@stackframe/stack-shared/dist/utils/types';
 import { InternalApiKeysCrud } from '@stackframe/stack-shared/dist/interface/crud/internal-api-keys';
 import { ReadonlyJson } from '@stackframe/stack-shared/dist/utils/json';
-import { PrettifyType, IfAndOnlyIf } from '@stackframe/stack-shared/dist/utils/types';
 import { GeoInfo } from '@stackframe/stack-shared/dist/utils/geo';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as lucide_react from 'lucide-react';
@@ -37,12 +39,28 @@ type RedirectMethod = "window" | "nextjs" | "none" | {
     useNavigate: () => (to: string) => void;
     navigate?: (to: string) => void;
 };
-type GetUserOptions$1<HasTokenStore> = {
+type GetCurrentUserOptions<HasTokenStore> = {
     or?: 'redirect' | 'throw' | 'return-null' | 'anonymous' | /** @deprecated */ 'anonymous-if-exists[deprecated]';
     tokenStore?: TokenStoreInit;
 } & (HasTokenStore extends false ? {
     tokenStore: TokenStoreInit;
 } : {});
+type ConvexCtx = GenericQueryCtx<any> | {
+    auth: {
+        getUserIdentity: () => Promise<UserIdentity | null>;
+    };
+};
+type GetCurrentPartialUserOptions<HasTokenStore> = {
+    or?: 'return-null' | 'anonymous';
+    tokenStore?: TokenStoreInit;
+} & ({
+    from: 'token';
+} | {
+    from: 'convex';
+    ctx: ConvexCtx;
+}) & (HasTokenStore extends false ? {
+    tokenStore: TokenStoreInit;
+} : {});
 type RequestLike = {
     headers: {
         get: (name: string) => string | null;
@@ -123,17 +141,30 @@ type AdminSentEmail = {
     sentAt: Date;
     error?: unknown;
 };
-type SendEmailOptions = {
-    userIds: string[];
+type SendEmailOptionsBase = {
     themeId?: string | null | false;
     subject?: string;
     notificationCategoryName?: string;
-} & ({
-    html: string;
-} | {
-    templateId: string;
-    variables?: Record<string, any>;
-});
+};
+type SendEmailOptions = SendEmailOptionsBase & XOR<[
+    {
+        userIds: string[];
+    },
+    {
+        allUsers: true;
+    }
+]> & XOR<[
+    {
+        html: string;
+    },
+    {
+        templateId: string;
+        variables?: Record<string, any>;
+    },
+    {
+        draftId: string;
+    }
+]>;
 
 type InternalApiKeyBase = {
     id: string;
@@ -306,6 +337,36 @@ type NotificationCategory = {
     setEnabled(enabled: boolean): Promise<void>;
 };
 
+type OAuthProvider = {
+    readonly id: string;
+    readonly type: string;
+    readonly userId: string;
+    readonly accountId?: string;
+    readonly email?: string;
+    readonly allowSignIn: boolean;
+    readonly allowConnectedAccounts: boolean;
+    update(data: {
+        allowSignIn?: boolean;
+        allowConnectedAccounts?: boolean;
+    }): Promise<Result<void, InstanceType<typeof KnownErrors.OAuthProviderAccountIdAlreadyUsedForSignIn>>>;
+    delete(): Promise<void>;
+};
+type ServerOAuthProvider = {
+    readonly id: string;
+    readonly type: string;
+    readonly userId: string;
+    readonly accountId: string;
+    readonly email?: string;
+    readonly allowSignIn: boolean;
+    readonly allowConnectedAccounts: boolean;
+    update(data: {
+        accountId?: string;
+        email?: string;
+        allowSignIn?: boolean;
+        allowConnectedAccounts?: boolean;
+    }): Promise<Result<void, InstanceType<typeof KnownErrors.OAuthProviderAccountIdAlreadyUsedForSignIn>>>;
+    delete(): Promise<void>;
+};
 type Session = {
     getTokens(): Promise<{
         accessToken: string | null;
@@ -517,6 +578,10 @@ type UserExtra = {
     getTeamProfile(team: Team): Promise<EditableTeamMemberProfile>;
     useTeamProfile(team: Team): EditableTeamMemberProfile;
     createApiKey(options: ApiKeyCreationOptions<"user">): Promise<UserApiKeyFirstView>;
+    useOAuthProviders(): OAuthProvider[];
+    listOAuthProviders(): Promise<OAuthProvider[]>;
+    useOAuthProvider(id: string): OAuthProvider | null;
+    getOAuthProvider(id: string): Promise<OAuthProvider | null>;
 } & AsyncStoreProperty<"apiKeys", [], UserApiKey[], true> & 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?: {
@@ -529,6 +594,8 @@ type User = BaseUser;
 type CurrentUser = BaseUser & Auth & UserExtra & Customer;
 type CurrentInternalUser = CurrentUser & InternalUserExtra;
 type ProjectCurrentUser<ProjectId> = ProjectId extends "internal" ? CurrentInternalUser : CurrentUser;
+type TokenPartialUser = Pick<User, "id" | "displayName" | "primaryEmail" | "primaryEmailVerified" | "isAnonymous">;
+type SyncedPartialUser = TokenPartialUser & Pick<User, "id" | "displayName" | "primaryEmail" | "primaryEmailVerified" | "profileImageUrl" | "signedUpAt" | "clientMetadata" | "clientReadOnlyMetadata" | "isAnonymous" | "hasPassword">;
 type ActiveSession = {
     id: string;
     userId: string;
@@ -582,6 +649,10 @@ type ServerBaseUser = {
     }): TeamPermission[];
     usePermission(scope: Team, permissionId: string): TeamPermission | null;
     usePermission(permissionId: string): TeamPermission | null;
+    useOAuthProviders(): ServerOAuthProvider[];
+    listOAuthProviders(): Promise<ServerOAuthProvider[]>;
+    useOAuthProvider(id: string): ServerOAuthProvider | null;
+    getOAuthProvider(id: string): Promise<ServerOAuthProvider | null>;
     /**
      * Creates a new session object with a refresh token for this user. Can be used to impersonate them.
      */
@@ -602,6 +673,7 @@ type ServerUser = ServerBaseUser & BaseUser & UserExtra & Customer<true>;
 type CurrentServerUser = Auth & ServerUser;
 type CurrentInternalServerUser = CurrentServerUser & InternalUserExtra;
 type ProjectCurrentServerUser<ProjectId> = ProjectId extends "internal" ? CurrentInternalServerUser : CurrentServerUser;
+type SyncedPartialServerUser = SyncedPartialUser & Pick<ServerUser, "serverMetadata">;
 type ServerUserUpdateOptions = {
     primaryEmail?: string | null;
     primaryEmailVerified?: boolean;
@@ -718,34 +790,60 @@ type StackServerApp<HasTokenStore extends boolean = boolean, ProjectId extends s
      */
     getServerUser(): Promise<ProjectCurrentServerUser<ProjectId> | null>;
     createUser(options: ServerUserCreateOptions): Promise<ServerUser>;
-    useUser(options: GetUserOptions$1<HasTokenStore> & {
+    useUser(options: GetCurrentUserOptions<HasTokenStore> & {
         or: 'redirect';
     }): ProjectCurrentServerUser<ProjectId>;
-    useUser(options: GetUserOptions$1<HasTokenStore> & {
+    useUser(options: GetCurrentUserOptions<HasTokenStore> & {
         or: 'throw';
     }): ProjectCurrentServerUser<ProjectId>;
-    useUser(options: GetUserOptions$1<HasTokenStore> & {
+    useUser(options: GetCurrentUserOptions<HasTokenStore> & {
         or: 'anonymous';
     }): ProjectCurrentServerUser<ProjectId>;
-    useUser(options?: GetUserOptions$1<HasTokenStore>): ProjectCurrentServerUser<ProjectId> | null;
+    useUser(options?: GetCurrentUserOptions<HasTokenStore>): ProjectCurrentServerUser<ProjectId> | null;
     useUser(id: string): ServerUser | null;
     useUser(options: {
         apiKey: string;
+        or?: "return-null" | "anonymous";
     }): ServerUser | null;
-    getUser(options: GetUserOptions$1<HasTokenStore> & {
+    useUser(options: {
+        from: "convex";
+        ctx: GenericQueryCtx<any>;
+        or?: "return-null" | "anonymous";
+    }): ServerUser | null;
+    getUser(options: GetCurrentUserOptions<HasTokenStore> & {
         or: 'redirect';
     }): Promise<ProjectCurrentServerUser<ProjectId>>;
-    getUser(options: GetUserOptions$1<HasTokenStore> & {
+    getUser(options: GetCurrentUserOptions<HasTokenStore> & {
         or: 'throw';
     }): Promise<ProjectCurrentServerUser<ProjectId>>;
-    getUser(options: GetUserOptions$1<HasTokenStore> & {
+    getUser(options: GetCurrentUserOptions<HasTokenStore> & {
         or: 'anonymous';
     }): Promise<ProjectCurrentServerUser<ProjectId>>;
-    getUser(options?: GetUserOptions$1<HasTokenStore>): Promise<ProjectCurrentServerUser<ProjectId> | null>;
+    getUser(options?: GetCurrentUserOptions<HasTokenStore>): Promise<ProjectCurrentServerUser<ProjectId> | null>;
     getUser(id: string): Promise<ServerUser | null>;
     getUser(options: {
         apiKey: string;
+        or?: "return-null" | "anonymous";
+    }): Promise<ServerUser | null>;
+    getUser(options: {
+        from: "convex";
+        ctx: GenericQueryCtx<any>;
+        or?: "return-null" | "anonymous";
     }): Promise<ServerUser | null>;
+    getPartialUser(options: GetCurrentPartialUserOptions<HasTokenStore> & {
+        from: 'token';
+    }): Promise<TokenPartialUser | null>;
+    getPartialUser(options: GetCurrentPartialUserOptions<HasTokenStore> & {
+        from: 'convex';
+    }): Promise<TokenPartialUser | null>;
+    getPartialUser(options: GetCurrentPartialUserOptions<HasTokenStore>): Promise<SyncedPartialServerUser | TokenPartialUser | null>;
+    usePartialUser(options: GetCurrentPartialUserOptions<HasTokenStore> & {
+        from: 'token';
+    }): TokenPartialUser | null;
+    usePartialUser(options: GetCurrentPartialUserOptions<HasTokenStore> & {
+        from: 'convex';
+    }): TokenPartialUser | null;
+    usePartialUser(options: GetCurrentPartialUserOptions<HasTokenStore>): SyncedPartialServerUser | TokenPartialUser | null;
     useTeam(id: string): ServerTeam | null;
     useTeam(options: {
         apiKey: string;
@@ -760,7 +858,15 @@ type StackServerApp<HasTokenStore extends boolean = boolean, ProjectId extends s
     listUsers(options?: ServerListUsersOptions): Promise<ServerUser[] & {
         nextCursor: string | null;
     }>;
-    sendEmail(options: SendEmailOptions): Promise<Result<void, KnownErrors["RequiresCustomEmailServer"] | KnownErrors["SchemaError"] | KnownErrors["UserIdDoesNotExist"]>>;
+    createOAuthProvider(options: {
+        userId: string;
+        accountId: string;
+        providerConfigId: string;
+        email: string;
+        allowSignIn: boolean;
+        allowConnectedAccounts: boolean;
+    }): Promise<Result<ServerOAuthProvider, InstanceType<typeof KnownErrors.OAuthProviderAccountIdAlreadyUsedForSignIn>>>;
+    sendEmail(options: SendEmailOptions): Promise<void>;
 } & AsyncStoreProperty<"user", [id: string], ServerUser | null, false> & Omit<AsyncStoreProperty<"users", [], ServerUser[], true>, "listUsers" | "useUsers"> & AsyncStoreProperty<"teams", [], ServerTeam[], true> & AsyncStoreProperty<"dataVaultStore", [id: string], DataVaultStore, false> & AsyncStoreProperty<"item", [
     {
         itemId: string;
@@ -797,22 +903,28 @@ type StackAdminApp<HasTokenStore extends boolean = boolean, ProjectId extends st
     displayName: string;
     themeId?: string;
     tsxSource: string;
+}[], true> & AsyncStoreProperty<"emailDrafts", [], {
+    id: string;
+    displayName: string;
+    themeId: string | undefined | false;
+    tsxSource: string;
+    sentAt: Date | null;
 }[], true> & AsyncStoreProperty<"stripeAccountInfo", [], {
     account_id: string;
     charges_enabled: boolean;
     details_submitted: boolean;
     payouts_enabled: boolean;
-} | null, false> & {
-    useEmailTemplates(): {
-        id: string;
-        displayName: string;
-        tsxSource: string;
-    }[];
-    listEmailTemplates(): Promise<{
-        id: string;
-        displayName: string;
-        tsxSource: string;
-    }[]>;
+} | null, false> & AsyncStoreProperty<"transactions", [
+    {
+        cursor?: string;
+        limit?: number;
+        type?: 'subscription' | 'one_time' | 'item_quantity_change';
+        customerType?: 'user' | 'team' | 'custom';
+    }
+], {
+    transactions: AdminTransaction[];
+    nextCursor: string | null;
+}, true> & {
     createInternalApiKey(options: InternalApiKeyCreateOptions): Promise<InternalApiKeyFirstView>;
     createTeamPermissionDefinition(data: AdminTeamPermissionDefinitionCreateOptions): Promise<AdminTeamPermission>;
     updateTeamPermissionDefinition(permissionId: string, data: AdminTeamPermissionDefinitionUpdateOptions): Promise<void>;
@@ -837,7 +949,7 @@ type StackAdminApp<HasTokenStore extends boolean = boolean, ProjectId extends st
         id: string;
     }>;
     updateEmailTheme(id: string, tsxSource: string): Promise<void>;
-    sendChatMessage(threadId: string, contextType: "email-theme" | "email-template", messages: Array<{
+    sendChatMessage(threadId: string, contextType: "email-theme" | "email-template" | "email-draft", messages: Array<{
         role: string;
         content: any;
     }>, abortSignal?: AbortSignal): Promise<{
@@ -859,6 +971,18 @@ type StackAdminApp<HasTokenStore extends boolean = boolean, ProjectId extends st
     createStripeWidgetAccountSession(): Promise<{
         client_secret: string;
     }>;
+    createEmailDraft(options: {
+        displayName: string;
+        themeId?: string | undefined | false;
+        tsxSource?: string;
+    }): Promise<{
+        id: string;
+    }>;
+    updateEmailDraft(id: string, data: {
+        displayName?: string;
+        themeId?: string | undefined | false;
+        tsxSource?: string;
+    }): Promise<void>;
     createItemQuantityChange(options: ({
         userId: string;
         itemId: string;
@@ -921,7 +1045,7 @@ type AdminProjectConfig = {
     readonly allowTeamApiKeys: boolean;
 };
 type AdminEmailConfig = ({
-    type: "standard";
+    type: "standard" | "resend";
     senderName: string;
     senderEmail: string;
     host: string;
@@ -1048,7 +1172,9 @@ type StackClientAppConstructor = {
 type StackClientApp<HasTokenStore extends boolean = boolean, ProjectId extends string = string> = ({
     readonly projectId: ProjectId;
     readonly urls: Readonly<HandlerUrls>;
-    signInWithOAuth(provider: string): Promise<void>;
+    signInWithOAuth(provider: string, options?: {
+        returnTo?: string;
+    }): Promise<void>;
     signInWithCredential(options: {
         email: string;
         password: string;
@@ -1092,26 +1218,48 @@ type StackClientApp<HasTokenStore extends boolean = boolean, ProjectId extends s
         noRedirect?: boolean;
     }): Promise<Result<undefined, KnownErrors["VerificationCodeError"] | KnownErrors["InvalidTotpCode"]>>;
     redirectToOAuthCallback(): Promise<void>;
-    useUser(options: GetUserOptions$1<HasTokenStore> & {
+    getConvexClientAuth(options: {
+        tokenStore: TokenStoreInit;
+    }): (args: {
+        forceRefreshToken: boolean;
+    }) => Promise<string | null>;
+    getConvexHttpClientAuth(options: {
+        tokenStore: TokenStoreInit;
+    }): Promise<string>;
+    useUser(options: GetCurrentUserOptions<HasTokenStore> & {
         or: 'redirect';
     }): ProjectCurrentUser<ProjectId>;
-    useUser(options: GetUserOptions$1<HasTokenStore> & {
+    useUser(options: GetCurrentUserOptions<HasTokenStore> & {
         or: 'throw';
     }): ProjectCurrentUser<ProjectId>;
-    useUser(options: GetUserOptions$1<HasTokenStore> & {
+    useUser(options: GetCurrentUserOptions<HasTokenStore> & {
         or: 'anonymous';
     }): ProjectCurrentUser<ProjectId>;
-    useUser(options?: GetUserOptions$1<HasTokenStore>): ProjectCurrentUser<ProjectId> | null;
-    getUser(options: GetUserOptions$1<HasTokenStore> & {
+    useUser(options?: GetCurrentUserOptions<HasTokenStore>): ProjectCurrentUser<ProjectId> | null;
+    getUser(options: GetCurrentUserOptions<HasTokenStore> & {
         or: 'redirect';
     }): Promise<ProjectCurrentUser<ProjectId>>;
-    getUser(options: GetUserOptions$1<HasTokenStore> & {
+    getUser(options: GetCurrentUserOptions<HasTokenStore> & {
         or: 'throw';
     }): Promise<ProjectCurrentUser<ProjectId>>;
-    getUser(options: GetUserOptions$1<HasTokenStore> & {
+    getUser(options: GetCurrentUserOptions<HasTokenStore> & {
         or: 'anonymous';
     }): Promise<ProjectCurrentUser<ProjectId>>;
-    getUser(options?: GetUserOptions$1<HasTokenStore>): Promise<ProjectCurrentUser<ProjectId> | null>;
+    getUser(options?: GetCurrentUserOptions<HasTokenStore>): Promise<ProjectCurrentUser<ProjectId> | null>;
+    getPartialUser(options: GetCurrentPartialUserOptions<HasTokenStore> & {
+        from: 'token';
+    }): Promise<TokenPartialUser | null>;
+    getPartialUser(options: GetCurrentPartialUserOptions<HasTokenStore> & {
+        from: 'convex';
+    }): Promise<TokenPartialUser | null>;
+    getPartialUser(options: GetCurrentPartialUserOptions<HasTokenStore>): Promise<SyncedPartialUser | TokenPartialUser | null>;
+    usePartialUser(options: GetCurrentPartialUserOptions<HasTokenStore> & {
+        from: 'token';
+    }): TokenPartialUser | null;
+    usePartialUser(options: GetCurrentPartialUserOptions<HasTokenStore> & {
+        from: 'convex';
+    }): TokenPartialUser | null;
+    usePartialUser(options: GetCurrentPartialUserOptions<HasTokenStore>): SyncedPartialUser | TokenPartialUser | null;
     useNavigate(): (to: string) => void;
     [stackAppInternalsSymbol]: {
         toClientJson(): StackClientAppJson<HasTokenStore, ProjectId>;
@@ -1133,6 +1281,15 @@ type StackClientApp<HasTokenStore extends boolean = boolean, ProjectId extends s
 });
 declare const StackClientApp: StackClientAppConstructor;
 
+declare function getConvexProvidersConfig(options: {
+    projectId?: string;
+}): {
+    type: string;
+    issuer: string;
+    jwks: string;
+    algorithm: string;
+}[];
+
 declare const iconMap: {
     readonly Contact: React$1.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React$1.RefAttributes<SVGSVGElement>>;
     readonly ShieldCheck: React$1.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React$1.RefAttributes<SVGSVGElement>>;
@@ -1265,7 +1422,7 @@ declare function NextStackHandler<HasTokenStore extends boolean>(props: BaseHand
     routeProps: RouteProps | unknown;
 })): Promise<any>;
 
-type GetUserOptions = GetUserOptions$1<true> & {
+type GetUserOptions = GetCurrentUserOptions<true> & {
     projectIdMustMatch?: string;
 };
 /**
@@ -1507,4 +1664,4 @@ type UserButtonProps = {
 };
 declare function UserButton(props: UserButtonProps): react_jsx_runtime.JSX.Element;
 
-export { AccountSettings, type AdminDomainConfig, type AdminEmailConfig, type AdminOAuthProviderConfig, type AdminOwnedProject, type AdminProject, type AdminProjectConfig, type AdminProjectConfigUpdateOptions, type AdminProjectCreateOptions, type AdminProjectPermission, type AdminProjectPermissionDefinition, type AdminProjectPermissionDefinitionCreateOptions, type AdminProjectPermissionDefinitionUpdateOptions, type AdminProjectUpdateOptions, type AdminSentEmail, type AdminTeamPermission, type AdminTeamPermissionDefinition, type AdminTeamPermissionDefinitionCreateOptions, type AdminTeamPermissionDefinitionUpdateOptions, type Auth, AuthPage, CliAuthConfirmation, type Connection, type ContactChannel, CredentialSignIn, CredentialSignUp, type CurrentInternalServerUser, type CurrentInternalUser, type CurrentServerUser, type CurrentUser, type EditableTeamMemberProfile, EmailVerification, ForgotPassword, type GetUserOptions$1 as GetUserOptions, type HandlerUrls, type InternalApiKey, type InternalApiKeyBase, type InternalApiKeyBaseCrudRead, type InternalApiKeyCreateOptions, type InternalApiKeyFirstView, MagicLinkSignIn, MessageCard, OAuthButton, OAuthButtonGroup, type OAuthConnection, type OAuthProviderConfig, type OAuthScopesOnSignIn, PasswordReset, type Project, type ProjectConfig, SelectedTeamSwitcher, type ServerContactChannel, type ServerListUsersOptions, type ServerTeam, type ServerTeamCreateOptions, type ServerTeamMemberProfile, type ServerTeamUpdateOptions, type ServerTeamUser, type ServerUser, type Session, SignIn, SignUp, StackAdminApp, type StackAdminAppConstructor, type StackAdminAppConstructorOptions, StackClientApp, type StackClientAppConstructor, type StackClientAppConstructorOptions, type StackClientAppJson, NextStackHandler as StackHandler, NextStackProvider as StackProvider, StackServerApp, type StackServerAppConstructor, type StackServerAppConstructorOptions, StackTheme, type Team, type TeamCreateOptions, type TeamInvitation$1 as TeamInvitation, type TeamMemberProfile, TeamSwitcher, type TeamUpdateOptions, type TeamUser, type User, UserAvatar, UserButton, stackAppInternalsSymbol, useStackApp, useUser };
+export { AccountSettings, type AdminDomainConfig, type AdminEmailConfig, type AdminOAuthProviderConfig, type AdminOwnedProject, type AdminProject, type AdminProjectConfig, type AdminProjectConfigUpdateOptions, type AdminProjectCreateOptions, type AdminProjectPermission, type AdminProjectPermissionDefinition, type AdminProjectPermissionDefinitionCreateOptions, type AdminProjectPermissionDefinitionUpdateOptions, type AdminProjectUpdateOptions, type AdminSentEmail, type AdminTeamPermission, type AdminTeamPermissionDefinition, type AdminTeamPermissionDefinitionCreateOptions, type AdminTeamPermissionDefinitionUpdateOptions, type Auth, AuthPage, CliAuthConfirmation, type Connection, type ContactChannel, CredentialSignIn, CredentialSignUp, type CurrentInternalServerUser, type CurrentInternalUser, type CurrentServerUser, type CurrentUser, type EditableTeamMemberProfile, EmailVerification, ForgotPassword, type GetCurrentUserOptions, type GetCurrentUserOptions as GetUserOptions, type HandlerUrls, type InternalApiKey, type InternalApiKeyBase, type InternalApiKeyBaseCrudRead, type InternalApiKeyCreateOptions, type InternalApiKeyFirstView, MagicLinkSignIn, MessageCard, OAuthButton, OAuthButtonGroup, type OAuthConnection, type OAuthProvider, type OAuthProviderConfig, type OAuthScopesOnSignIn, PasswordReset, type Project, type ProjectConfig, SelectedTeamSwitcher, type ServerContactChannel, type ServerListUsersOptions, type ServerOAuthProvider, type ServerTeam, type ServerTeamCreateOptions, type ServerTeamMemberProfile, type ServerTeamUpdateOptions, type ServerTeamUser, type ServerUser, type Session, SignIn, SignUp, StackAdminApp, type StackAdminAppConstructor, type StackAdminAppConstructorOptions, StackClientApp, type StackClientAppConstructor, type StackClientAppConstructorOptions, type StackClientAppJson, NextStackHandler as StackHandler, NextStackProvider as StackProvider, StackServerApp, type StackServerAppConstructor, type StackServerAppConstructorOptions, StackTheme, type Team, type TeamCreateOptions, type TeamInvitation$1 as TeamInvitation, type TeamMemberProfile, TeamSwitcher, type TeamUpdateOptions, type TeamUser, type User, UserAvatar, UserButton, getConvexProvidersConfig, stackAppInternalsSymbol, useStackApp, useUser };

package/dist/index.js

@@ -52,17 +52,20 @@ __export(src_exports, {
   TeamSwitcher: () => import_team_switcher.TeamSwitcher,
   UserAvatar: () => import_user_avatar.UserAvatar,
   UserButton: () => import_user_button.UserButton,
+  getConvexProvidersConfig: () => import_convex.getConvexProvidersConfig,
   useStackApp: () => import_hooks.useStackApp,
   useUser: () => import_hooks.useUser
 });
 module.exports = __toCommonJS(src_exports);
 __reExport(src_exports, require("./lib/stack-app/index.js"), module.exports);
+var import_convex = require("./integrations/convex.js");
 var import_stack_handler = __toESM(require("./components-page/stack-handler.js"));
 var import_hooks = require("./lib/hooks.js");
 var import_stack_provider = __toESM(require("./providers/stack-provider.js"));
 var import_theme_provider = require("./providers/theme-provider.js");
 var import_account_settings = require("./components-page/account-settings.js");
 var import_auth_page = require("./components-page/auth-page.js");
+var import_cli_auth_confirm = require("./components-page/cli-auth-confirm.js");
 var import_email_verification = require("./components-page/email-verification.js");
 var import_forgot_password = require("./components-page/forgot-password.js");
 var import_password_reset = require("./components-page/password-reset.js");
@@ -78,7 +81,6 @@ var import_oauth_button_group = require("./components/oauth-button-group.js");
 var import_selected_team_switcher = require("./components/selected-team-switcher.js");
 var import_team_switcher = require("./components/team-switcher.js");
 var import_user_button = require("./components/user-button.js");
-var import_cli_auth_confirm = require("./components-page/cli-auth-confirm.js");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AccountSettings,
@@ -102,6 +104,7 @@ var import_cli_auth_confirm = require("./components-page/cli-auth-confirm.js");
   TeamSwitcher,
   UserAvatar,
   UserButton,
+  getConvexProvidersConfig,
   useStackApp,
   useUser,
   ...require("./lib/stack-app/index.js")

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["\n//===========================================\n// THIS FILE IS AUTO-GENERATED FROM TEMPLATE. DO NOT EDIT IT DIRECTLY\n//===========================================\nexport * from './lib/stack-app';\n\nexport { default as StackHandler } from \"./components-page/stack-handler\";\nexport { useStackApp, useUser } from \"./lib/hooks\";\nexport { default as StackProvider } from \"./providers/stack-provider\";\nexport { StackTheme } from './providers/theme-provider';\n\nexport { AccountSettings } from \"./components-page/account-settings\";\nexport { AuthPage } from \"./components-page/auth-page\";\nexport { EmailVerification } from \"./components-page/email-verification\";\nexport { ForgotPassword } from \"./components-page/forgot-password\";\nexport { PasswordReset } from \"./components-page/password-reset\";\nexport { SignIn } from \"./components-page/sign-in\";\nexport { SignUp } from \"./components-page/sign-up\";\nexport { CredentialSignIn as CredentialSignIn } from \"./components/credential-sign-in\";\nexport { CredentialSignUp as CredentialSignUp } from \"./components/credential-sign-up\";\nexport { UserAvatar } from \"./components/elements/user-avatar\";\nexport { MagicLinkSignIn as MagicLinkSignIn } from \"./components/magic-link-sign-in\";\nexport { MessageCard } from \"./components/message-cards/message-card\";\nexport { OAuthButton } from \"./components/oauth-button\";\nexport { OAuthButtonGroup } from \"./components/oauth-button-group\";\nexport { SelectedTeamSwitcher } from \"./components/selected-team-switcher\";\nexport { TeamSwitcher } from \"./components/team-switcher\";\nexport { UserButton } from \"./components/user-button\";\nexport { CliAuthConfirmation } from \"./components-page/cli-auth-confirm\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAIA,wBAAc,qCAJd;AAMA,2BAAwC;AACxC,mBAAqC;AACrC,4BAAyC;AACzC,4BAA2B;AAE3B,8BAAgC;AAChC,uBAAyB;AACzB,gCAAkC;AAClC,6BAA+B;AAC/B,4BAA8B;AAC9B,qBAAuB;AACvB,qBAAuB;AACvB,gCAAqD;AACrD,gCAAqD;AACrD,yBAA2B;AAC3B,gCAAmD;AACnD,0BAA4B;AAC5B,0BAA4B;AAC5B,gCAAiC;AACjC,oCAAqC;AACrC,2BAA6B;AAC7B,yBAA2B;AAC3B,8BAAoC;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["\n//===========================================\n// THIS FILE IS AUTO-GENERATED FROM TEMPLATE. DO NOT EDIT IT DIRECTLY\n//===========================================\nexport * from './lib/stack-app';\n\nexport { getConvexProvidersConfig } from \"./integrations/convex\";\n\nexport { default as StackHandler } from \"./components-page/stack-handler\";\nexport { useStackApp, useUser } from \"./lib/hooks\";\nexport { default as StackProvider } from \"./providers/stack-provider\";\nexport { StackTheme } from './providers/theme-provider';\n\nexport { AccountSettings } from \"./components-page/account-settings\";\nexport { AuthPage } from \"./components-page/auth-page\";\nexport { CliAuthConfirmation } from \"./components-page/cli-auth-confirm\";\nexport { EmailVerification } from \"./components-page/email-verification\";\nexport { ForgotPassword } from \"./components-page/forgot-password\";\nexport { PasswordReset } from \"./components-page/password-reset\";\nexport { SignIn } from \"./components-page/sign-in\";\nexport { SignUp } from \"./components-page/sign-up\";\nexport { CredentialSignIn as CredentialSignIn } from \"./components/credential-sign-in\";\nexport { CredentialSignUp as CredentialSignUp } from \"./components/credential-sign-up\";\nexport { UserAvatar } from \"./components/elements/user-avatar\";\nexport { MagicLinkSignIn as MagicLinkSignIn } from \"./components/magic-link-sign-in\";\nexport { MessageCard } from \"./components/message-cards/message-card\";\nexport { OAuthButton } from \"./components/oauth-button\";\nexport { OAuthButtonGroup } from \"./components/oauth-button-group\";\nexport { SelectedTeamSwitcher } from \"./components/selected-team-switcher\";\nexport { TeamSwitcher } from \"./components/team-switcher\";\nexport { UserButton } from \"./components/user-button\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAIA,wBAAc,qCAJd;AAMA,oBAAyC;AAEzC,2BAAwC;AACxC,mBAAqC;AACrC,4BAAyC;AACzC,4BAA2B;AAE3B,8BAAgC;AAChC,uBAAyB;AACzB,8BAAoC;AACpC,gCAAkC;AAClC,6BAA+B;AAC/B,4BAA8B;AAC9B,qBAAuB;AACvB,qBAAuB;AACvB,gCAAqD;AACrD,gCAAqD;AACrD,yBAA2B;AAC3B,gCAAmD;AACnD,0BAA4B;AAC5B,0BAA4B;AAC5B,gCAAiC;AACjC,oCAAqC;AACrC,2BAA6B;AAC7B,yBAA2B;","names":[]}

package/dist/integrations/convex.js

@@ -0,0 +1,43 @@
+"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/integrations/convex.ts
+var convex_exports = {};
+__export(convex_exports, {
+  getConvexProvidersConfig: () => getConvexProvidersConfig
+});
+module.exports = __toCommonJS(convex_exports);
+var import_urls = require("@stackframe/stack-shared/dist/utils/urls");
+var import_common = require("../lib/stack-app/apps/implementations/common.js");
+function getConvexProvidersConfig(options) {
+  const projectId = options.projectId ?? (0, import_common.getDefaultProjectId)();
+  return [
+    {
+      type: "customJwt",
+      issuer: import_urls.urlString`https://api.stack-auth.com/api/v1/projects/${projectId}`,
+      jwks: import_urls.urlString`https://api.stack-auth.com/api/v1/projects/${projectId}/.well-known/jwks.json?include_anonymous=true`,
+      algorithm: "ES256"
+    }
+  ];
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getConvexProvidersConfig
+});
+//# sourceMappingURL=convex.js.map

package/dist/integrations/convex.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/integrations/convex.ts"],"sourcesContent":["\n//===========================================\n// THIS FILE IS AUTO-GENERATED FROM TEMPLATE. DO NOT EDIT IT DIRECTLY\n//===========================================\nimport { urlString } from \"@stackframe/stack-shared/dist/utils/urls\";\nimport { getDefaultProjectId } from \"../lib/stack-app/apps/implementations/common\";\n\nexport function getConvexProvidersConfig(options: {\n  projectId?: string,\n}) {\n  const projectId = options.projectId ?? getDefaultProjectId();\n  return [\n    {\n      type: \"customJwt\",\n      issuer: urlString`https://api.stack-auth.com/api/v1/projects/${projectId}`,\n      jwks: urlString`https://api.stack-auth.com/api/v1/projects/${projectId}/.well-known/jwks.json?include_anonymous=true`,\n      algorithm: \"ES256\",\n    },\n  ];\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAIA,kBAA0B;AAC1B,oBAAoC;AAE7B,SAAS,yBAAyB,SAEtC;AACD,QAAM,YAAY,QAAQ,iBAAa,mCAAoB;AAC3D,SAAO;AAAA,IACL;AAAA,MACE,MAAM;AAAA,MACN,QAAQ,mEAAuD,SAAS;AAAA,MACxE,MAAM,mEAAuD,SAAS;AAAA,MACtE,WAAW;AAAA,IACb;AAAA,EACF;AACF;","names":[]}

package/dist/lib/stack-app/apps/implementations/admin-app-impl.js

@@ -42,7 +42,7 @@ var _StackAdminAppImplIncomplete = class extends import_server_app_impl._StackSe
       interface: new import_stack_shared.StackAdminInterface({
         getBaseUrl: () => (0, import_common2.getBaseUrl)(options.baseUrl),
         projectId: options.projectId ?? (0, import_common2.getDefaultProjectId)(),
-        extraRequestHeaders: options.extraRequestHeaders ?? {},
+        extraRequestHeaders: options.extraRequestHeaders ?? (0, import_common2.getDefaultExtraRequestHeaders)(),
         clientVersion: import_common2.clientVersion,
         ..."projectOwnerSession" in options ? {
           projectOwnerSession: options.projectOwnerSession
@@ -76,6 +76,9 @@ var _StackAdminAppImplIncomplete = class extends import_server_app_impl._StackSe
     this._adminEmailTemplatesCache = (0, import_common2.createCache)(async () => {
       return await this._interface.listInternalEmailTemplates();
     });
+    this._adminEmailDraftsCache = (0, import_common2.createCache)(async () => {
+      return await this._interface.listInternalEmailDrafts();
+    });
     this._adminTeamPermissionDefinitionsCache = (0, import_common2.createCache)(async () => {
       return await this._interface.listTeamPermissionDefinitions();
     });
@@ -85,8 +88,8 @@ var _StackAdminAppImplIncomplete = class extends import_server_app_impl._StackSe
     this._svixTokenCache = (0, import_common2.createCache)(async () => {
       return await this._interface.getSvixToken();
     });
-    this._metricsCache = (0, import_common2.createCache)(async () => {
-      return await this._interface.getMetrics();
+    this._metricsCache = (0, import_common2.createCache)(async ([includeAnonymous]) => {
+      return await this._interface.getMetrics(includeAnonymous);
     });
     this._emailPreviewCache = (0, import_common2.createCache)(async ([themeId, themeTsxSource, templateId, templateTsxSource]) => {
       return await this._interface.renderEmailPreview({ themeId, themeTsxSource, templateId, templateTsxSource });
@@ -104,6 +107,9 @@ var _StackAdminAppImplIncomplete = class extends import_server_app_impl._StackSe
         throw error;
       }
     });
+    this._transactionsCache = (0, import_common2.createCache)(async ([cursor, limit, type, customerType]) => {
+      return await this._interface.listTransactions({ cursor, limit, type, customerType });
+    });
   }
   _adminConfigFromCrud(data) {
     return JSON.parse(data.config_string);
@@ -300,6 +306,18 @@ var _StackAdminAppImplIncomplete = class extends import_server_app_impl._StackSe
       }));
     }, [crud]);
   }
+  useEmailDrafts() {
+    const crud = (0, import_common3.useAsyncCache)(this._adminEmailDraftsCache, [], "useEmailDrafts()");
+    return (0, import_react.useMemo)(() => {
+      return crud.map((draft) => ({
+        id: draft.id,
+        displayName: draft.display_name,
+        themeId: draft.theme_id,
+        tsxSource: draft.tsx_source,
+        sentAt: draft.sent_at_millis ? new Date(draft.sent_at_millis) : null
+      }));
+    }, [crud]);
+  }
   async listEmailThemes() {
     const crud = import_results.Result.orThrow(await this._adminEmailThemesCache.getOrWait([], "write-only"));
     return crud.map((theme) => ({
@@ -316,6 +334,16 @@ var _StackAdminAppImplIncomplete = class extends import_server_app_impl._StackSe
       tsxSource: template.tsx_source
     }));
   }
+  async listEmailDrafts() {
+    const crud = import_results.Result.orThrow(await this._adminEmailDraftsCache.getOrWait([], "write-only"));
+    return crud.map((draft) => ({
+      id: draft.id,
+      displayName: draft.display_name,
+      themeId: draft.theme_id,
+      tsxSource: draft.tsx_source,
+      sentAt: draft.sent_at_millis ? new Date(draft.sent_at_millis) : null
+    }));
+  }
   async createTeamPermissionDefinition(data) {
     const crud = await this._interface.createTeamPermissionDefinition((0, import_permissions.adminTeamPermissionDefinitionCreateOptionsToCrud)(data));
     await this._adminTeamPermissionDefinitionsCache.refresh([]);
@@ -378,8 +406,8 @@ var _StackAdminAppImplIncomplete = class extends import_server_app_impl._StackSe
   get [import_common.stackAppInternalsSymbol]() {
     return {
       ...super[import_common.stackAppInternalsSymbol],
-      useMetrics: () => {
-        return (0, import_common3.useAsyncCache)(this._metricsCache, [], "useMetrics()");
+      useMetrics: (includeAnonymous = false) => {
+        return (0, import_common3.useAsyncCache)(this._metricsCache, [includeAnonymous], "useMetrics()");
       }
     };
   }
@@ -417,6 +445,23 @@ var _StackAdminAppImplIncomplete = class extends import_server_app_impl._StackSe
     await this._adminEmailTemplatesCache.refresh([]);
     return result;
   }
+  async createEmailDraft(options) {
+    const result = await this._interface.createEmailDraft({
+      display_name: options.displayName,
+      theme_id: options.themeId,
+      tsx_source: options.tsxSource
+    });
+    await this._adminEmailDraftsCache.refresh([]);
+    return result;
+  }
+  async updateEmailDraft(id, data) {
+    await this._interface.updateEmailDraft(id, {
+      display_name: data.displayName,
+      theme_id: data.themeId,
+      tsx_source: data.tsxSource
+    });
+    await this._adminEmailDraftsCache.refresh([]);
+  }
   async sendChatMessage(threadId, contextType, messages, abortSignal) {
     return await this._interface.sendChatMessage(threadId, contextType, messages, abortSignal);
   }
@@ -472,6 +517,14 @@ var _StackAdminAppImplIncomplete = class extends import_server_app_impl._StackSe
   async testModePurchase(options) {
     await this._interface.testModePurchase({ price_id: options.priceId, full_code: options.fullCode, quantity: options.quantity });
   }
+  async listTransactions(params) {
+    const crud = import_results.Result.orThrow(await this._transactionsCache.getOrWait([params.cursor, params.limit, params.type, params.customerType], "write-only"));
+    return crud;
+  }
+  useTransactions(params) {
+    const data = (0, import_common3.useAsyncCache)(this._transactionsCache, [params.cursor, params.limit, params.type, params.customerType], "useTransactions()");
+    return data;
+  }
   async getStripeAccountInfo() {
     return await this._interface.getStripeAccountInfo();
   }