@stackframe/tanstack-start 0.0.1 → 2.8.91

package/dist/lib/stack-app/apps/interfaces/client-app.d.ts

@@ -0,0 +1,220 @@
+import { AsyncStoreProperty, AuthLike, GetCurrentPartialUserOptions, GetCurrentUserOptions, HandlerUrlOptions, HandlerUrls, OAuthScopesOnSignIn, RedirectMethod, RedirectToOptions, ResolvedHandlerUrls, TokenStoreInit, stackAppInternalsSymbol } from "../../common.js";
+import { CustomerInvoicesList, CustomerInvoicesRequestOptions, CustomerProductsList, CustomerProductsRequestOptions, Item } from "../../customers/index.js";
+import { ProjectCurrentUser, SyncedPartialUser, TokenPartialUser } from "../../users/index.js";
+import { Project } from "../../projects/index.js";
+import { AnalyticsOptions } from "../implementations/session-replay.js";
+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 { RequestListener } from "@stackframe/stack-shared/dist/interface/client-interface";
+
+//#region src/lib/stack-app/apps/interfaces/client-app.d.ts
+type StackClientAppConstructorOptions<HasTokenStore extends boolean, ProjectId extends string> = {
+  baseUrl?: string | {
+    browser: string;
+    server: string;
+  };
+  extraRequestHeaders?: Record<string, string>;
+  projectId?: ProjectId;
+  publishableClientKey?: string;
+  urls?: HandlerUrlOptions;
+  oauthScopesOnSignIn?: Partial<OAuthScopesOnSignIn>;
+  tokenStore?: TokenStoreInit<HasTokenStore>;
+  redirectMethod?: RedirectMethod;
+  inheritsFrom?: StackClientApp<any, any>;
+  /**
+   * Whether to show the Stack Auth dev tool indicator in browser-like development environments.
+   *
+   * Defaults to true.
+   */
+  devTool?: boolean;
+  /**
+   * 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;
+  /**
+   * Options for analytics and session recording. Replays are disabled by default;
+   * set `{ replays: { enabled: true } }` to opt in.
+   */
+  analytics?: AnalyticsOptions;
+} & ({
+  tokenStore: TokenStoreInit<HasTokenStore>;
+} | {
+  tokenStore?: undefined;
+  inheritsFrom: StackClientApp<HasTokenStore, any>;
+}) & (string extends ProjectId ? unknown : ({
+  projectId: ProjectId;
+} | {
+  inheritsFrom: StackClientApp<any, ProjectId>;
+}));
+type StackClientAppJson<HasTokenStore extends boolean, ProjectId extends string> = StackClientAppConstructorOptions<HasTokenStore, ProjectId> & {
+  inheritsFrom?: undefined;
+} & {
+  uniqueIdentifier: string;
+};
+type StackClientApp<HasTokenStore extends boolean = boolean, ProjectId extends string = string> = ({
+  readonly projectId: ProjectId;
+  /**
+   * The version of the Stack Auth SDK.
+   */
+  readonly version: string;
+  /**
+   * @deprecated `app.urls` is static and does not include runtime redirect-back parameters.
+   * For navigation, prefer `redirectToXyz()` methods (for example `redirectToSignIn()`).
+   */
+  readonly urls: Readonly<ResolvedHandlerUrls>;
+  signInWithOAuth(provider: string, options?: {
+    returnTo?: 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;
+  } & ({
+    noVerificationCallback: true;
+  } | {
+    noVerificationCallback?: false;
+    verificationCallbackUrl?: string;
+  })): Promise<Result<undefined, KnownErrors["UserWithEmailAlreadyExists"] | KnownErrors["PasswordRequirementsNotMet"] | KnownErrors["BotChallengeFailed"]>>;
+  signInWithPasskey(): Promise<Result<undefined, KnownErrors["PasskeyAuthenticationFailed"] | KnownErrors["InvalidTotpCode"] | KnownErrors["PasskeyWebAuthnError"]>>;
+  callOAuthCallback(): Promise<boolean>;
+  promptCliLogin(options: {
+    appUrl: string;
+    expiresInMillis?: number;
+    anonRefreshToken?: string;
+    promptLink?: (url: string, loginCode: string) => void;
+  }): Promise<Result<string, KnownErrors["CliAuthError"] | KnownErrors["CliAuthExpiredError"] | KnownErrors["CliAuthUsedError"]>>;
+  sendForgotPasswordEmail(email: string, options?: {
+    callbackUrl?: string;
+  }): Promise<Result<undefined, KnownErrors["UserNotFound"]>>;
+  sendMagicLinkEmail(email: string, options?: {
+    callbackUrl?: string;
+  }): Promise<Result<{
+    nonce: string;
+  }, KnownErrors["RedirectUrlNotWhitelisted"] | KnownErrors["BotChallengeFailed"]>>;
+  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"] | KnownErrors["TeamInvitationEmailMismatch"]>>;
+  acceptTeamInvitation(code: string): Promise<Result<undefined, KnownErrors["VerificationCodeError"] | KnownErrors["TeamInvitationEmailMismatch"]>>;
+  getTeamInvitationDetails(code: string): Promise<Result<{
+    teamDisplayName: string;
+  }, KnownErrors["VerificationCodeError"] | KnownErrors["TeamInvitationEmailMismatch"]>>;
+  verifyEmail(code: string): Promise<Result<undefined, KnownErrors["VerificationCodeError"]>>;
+  signInWithMagicLink(code: string, options?: {
+    noRedirect?: boolean;
+  }): Promise<Result<undefined, KnownErrors["VerificationCodeError"] | KnownErrors["InvalidTotpCode"]>>;
+  signInWithMfa(otp: string, code: string, options?: {
+    noRedirect?: boolean;
+  }): Promise<Result<undefined, KnownErrors["VerificationCodeError"] | KnownErrors["InvalidTotpCode"]>>;
+  redirectToOAuthCallback(): Promise<void>;
+  getConvexClientAuth(options: HasTokenStore extends false ? {
+    tokenStore: TokenStoreInit;
+  } : {
+    tokenStore?: TokenStoreInit;
+  }): (args: {
+    forceRefreshToken: boolean;
+  }) => Promise<string | null>;
+  getConvexHttpClientAuth(options: {
+    tokenStore: TokenStoreInit;
+  }): Promise<string>;
+  useUser(options: GetCurrentUserOptions<HasTokenStore> & {
+    or: 'redirect';
+  }): ProjectCurrentUser<ProjectId>;
+  useUser(options: GetCurrentUserOptions<HasTokenStore> & {
+    or: 'throw';
+  }): ProjectCurrentUser<ProjectId>;
+  useUser(options: GetCurrentUserOptions<HasTokenStore> & {
+    or: 'anonymous';
+  }): ProjectCurrentUser<ProjectId>;
+  useUser(options?: GetCurrentUserOptions<HasTokenStore>): ProjectCurrentUser<ProjectId> | null;
+  getUser(options: GetCurrentUserOptions<HasTokenStore> & {
+    or: 'redirect';
+  }): Promise<ProjectCurrentUser<ProjectId>>;
+  getUser(options: GetCurrentUserOptions<HasTokenStore> & {
+    or: 'throw';
+  }): Promise<ProjectCurrentUser<ProjectId>>;
+  getUser(options: GetCurrentUserOptions<HasTokenStore> & {
+    or: 'anonymous';
+  }): Promise<ProjectCurrentUser<ProjectId>>;
+  getUser(options?: GetCurrentUserOptions<HasTokenStore>): Promise<ProjectCurrentUser<ProjectId> | null>;
+  cancelSubscription(options: {
+    productId: string;
+    subscriptionId?: string;
+  } | {
+    productId: string;
+    subscriptionId?: string;
+    teamId: string;
+  }): Promise<void>;
+  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>;
+    setCurrentUser(userJsonPromise: Promise<CurrentUserCrud['Client']['Read'] | null>): void;
+    getConstructorOptions(): StackClientAppConstructorOptions<HasTokenStore, ProjectId> & {
+      inheritsFrom?: undefined;
+    };
+    sendSessionReplayBatch(body: string, options: {
+      keepalive: boolean;
+    }): Promise<Result<Response, Error>>;
+    sendAnalyticsEventBatch(body: string, options: {
+      keepalive: boolean;
+    }): Promise<Result<Response, Error>>;
+    addRequestListener(listener: RequestListener): () => void;
+    sendRequest(path: string, requestOptions: RequestInit, requestType?: "client" | "server" | "admin"): Promise<Response>;
+    getRedirectMethod(): RedirectMethod;
+    redirectToUrl(url: string | URL, options?: {
+      replace?: boolean;
+    }): Promise<void>;
+    signInWithTokens(tokens: {
+      accessToken: string;
+      refreshToken: string;
+    }): Promise<void>;
+  };
+} & AsyncStoreProperty<"project", [], Project, false> & AsyncStoreProperty<"item", [{
+  itemId: string;
+  userId: string;
+} | {
+  itemId: string;
+  teamId: string;
+} | {
+  itemId: string;
+  customCustomerId: string;
+}], Item, false> & AsyncStoreProperty<"products", [options: CustomerProductsRequestOptions], CustomerProductsList, true> & AsyncStoreProperty<"invoices", [options: CustomerInvoicesRequestOptions], CustomerInvoicesList, true> & { [K in `redirectTo${Capitalize<keyof Omit<HandlerUrls, 'handler' | 'oauthCallback'>>}`]: (options?: RedirectToOptions) => Promise<void> } & AuthLike<HasTokenStore extends false ? {
+  tokenStore: TokenStoreInit;
+} : {
+  tokenStore?: TokenStoreInit;
+}>);
+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>;
+  };
+};
+declare const StackClientApp: StackClientAppConstructor;
+//#endregion
+export { StackClientApp, StackClientAppConstructor, StackClientAppConstructorOptions, StackClientAppJson };
+//# sourceMappingURL=client-app.d.ts.map

package/dist/lib/stack-app/apps/interfaces/client-app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-app.d.ts","names":[],"sources":["../../../../../src/lib/stack-app/apps/interfaces/client-app.ts"],"mappings":"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"}

package/dist/lib/stack-app/apps/interfaces/client-app.js

@@ -0,0 +1,10 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_chunk = require('../../../../chunk-BE-pF4vm.js');
+let ___implementations_index_js = require("../implementations/index.js");
+
+//#region src/lib/stack-app/apps/interfaces/client-app.ts
+const StackClientApp = ___implementations_index_js._StackClientAppImpl;
+
+//#endregion
+exports.StackClientApp = StackClientApp;
+//# sourceMappingURL=client-app.js.map

package/dist/lib/stack-app/apps/interfaces/client-app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-app.js","names":["_StackClientAppImpl"],"sources":["../../../../../src/lib/stack-app/apps/interfaces/client-app.ts"],"sourcesContent":["\n//===========================================\n// THIS FILE IS AUTO-GENERATED FROM TEMPLATE. DO NOT EDIT IT DIRECTLY, INSTEAD EDIT THE CORRESPONDING FILE IN packages/template\n//===========================================\nimport { KnownErrors } from \"@stackframe/stack-shared\";\nimport { CurrentUserCrud } from \"@stackframe/stack-shared/dist/interface/crud/current-user\";\nimport { Result } from \"@stackframe/stack-shared/dist/utils/results\";\nimport { AsyncStoreProperty, AuthLike, GetCurrentPartialUserOptions, GetCurrentUserOptions, HandlerUrlOptions, HandlerUrls, OAuthScopesOnSignIn, RedirectMethod, RedirectToOptions, ResolvedHandlerUrls, stackAppInternalsSymbol, TokenStoreInit } from \"../../common\";\nimport type { RequestListener } from \"@stackframe/stack-shared/dist/interface/client-interface\";\nimport { CustomerInvoicesList, CustomerInvoicesRequestOptions, CustomerProductsList, CustomerProductsRequestOptions, Item } from \"../../customers\";\nimport { Project } from \"../../projects\";\nimport { ProjectCurrentUser, SyncedPartialUser, TokenPartialUser } from \"../../users\";\nimport { _StackClientAppImpl } from \"../implementations\";\nimport { AnalyticsOptions } from \"../implementations/session-replay\";\n\nexport type StackClientAppConstructorOptions<HasTokenStore extends boolean, ProjectId extends string> = {\n  baseUrl?: string | { browser: string, server: string },\n  extraRequestHeaders?: Record<string, string>,\n  projectId?: ProjectId,\n  publishableClientKey?: string,\n  urls?: HandlerUrlOptions,\n  oauthScopesOnSignIn?: Partial<OAuthScopesOnSignIn>,\n  tokenStore?: TokenStoreInit<HasTokenStore>,\n  redirectMethod?: RedirectMethod,\n  inheritsFrom?: StackClientApp<any, any>,\n\n  /**\n   * Whether to show the Stack Auth dev tool indicator in browser-like development environments.\n   *\n   * Defaults to true.\n   */\n  devTool?: boolean,\n\n  /**\n   * By default, the Stack app will automatically prefetch some data from Stack's server when this app is first\n   * constructed. This improves the performance of your app, but will create network requests that are unnecessary if\n   * the app is never used or disposed of immediately. To disable this behavior, set this option to true.\n   */\n  noAutomaticPrefetch?: boolean,\n\n  /**\n   * Options for analytics and session recording. Replays are disabled by default;\n   * set `{ replays: { enabled: true } }` to opt in.\n   */\n  analytics?: AnalyticsOptions,\n} & (\n  { tokenStore: TokenStoreInit<HasTokenStore> } | { tokenStore?: undefined, inheritsFrom: StackClientApp<HasTokenStore, any> }\n) & (\n  string extends ProjectId ? unknown : ({ projectId: ProjectId } | { inheritsFrom: StackClientApp<any, ProjectId> })\n);\n\n\nexport type StackClientAppJson<HasTokenStore extends boolean, ProjectId extends string> = StackClientAppConstructorOptions<HasTokenStore, ProjectId> & { inheritsFrom?: undefined } & {\n  uniqueIdentifier: string,\n  // note: if you add more fields here, make sure to ensure the checkString in the constructor has/doesn't have them\n};\n\nexport type StackClientApp<HasTokenStore extends boolean = boolean, ProjectId extends string = string> = (\n  & {\n    readonly projectId: ProjectId,\n\n    /**\n     * The version of the Stack Auth SDK.\n     */\n    readonly version: string,\n\n    /**\n     * @deprecated `app.urls` is static and does not include runtime redirect-back parameters.\n     * For navigation, prefer `redirectToXyz()` methods (for example `redirectToSignIn()`).\n     */\n    readonly urls: Readonly<ResolvedHandlerUrls>,\n\n    signInWithOAuth(provider: string, options?: { returnTo?: string }): Promise<void>,\n    signInWithCredential(options: { email: string, password: string, noRedirect?: boolean }): Promise<Result<undefined, KnownErrors[\"EmailPasswordMismatch\"] | KnownErrors[\"InvalidTotpCode\"]>>,\n    signUpWithCredential(options: {\n      email: string,\n      password: string,\n      noRedirect?: boolean,\n    } & ({ noVerificationCallback: true } | { noVerificationCallback?: false, verificationCallbackUrl?: string })): Promise<Result<undefined, KnownErrors[\"UserWithEmailAlreadyExists\"] | KnownErrors[\"PasswordRequirementsNotMet\"] | KnownErrors[\"BotChallengeFailed\"]>>,\n    signInWithPasskey(): Promise<Result<undefined, KnownErrors[\"PasskeyAuthenticationFailed\"] | KnownErrors[\"InvalidTotpCode\"] | KnownErrors[\"PasskeyWebAuthnError\"]>>,\n    callOAuthCallback(): Promise<boolean>,\n    promptCliLogin(options: { appUrl: string, expiresInMillis?: number, anonRefreshToken?: string, promptLink?: (url: string, loginCode: string) => void }): Promise<Result<string, KnownErrors[\"CliAuthError\"] | KnownErrors[\"CliAuthExpiredError\"] | KnownErrors[\"CliAuthUsedError\"]>>,\n    sendForgotPasswordEmail(email: string, options?: { callbackUrl?: string }): Promise<Result<undefined, KnownErrors[\"UserNotFound\"]>>,\n    sendMagicLinkEmail(email: string, options?: { callbackUrl?: string }): Promise<Result<{ nonce: string }, KnownErrors[\"RedirectUrlNotWhitelisted\"] | KnownErrors[\"BotChallengeFailed\"]>>,\n    resetPassword(options: { code: string, password: string }): Promise<Result<undefined, KnownErrors[\"VerificationCodeError\"]>>,\n    verifyPasswordResetCode(code: string): Promise<Result<undefined, KnownErrors[\"VerificationCodeError\"]>>,\n    verifyTeamInvitationCode(code: string): Promise<Result<undefined, KnownErrors[\"VerificationCodeError\"] | KnownErrors[\"TeamInvitationEmailMismatch\"]>>,\n    acceptTeamInvitation(code: string): Promise<Result<undefined, KnownErrors[\"VerificationCodeError\"] | KnownErrors[\"TeamInvitationEmailMismatch\"]>>,\n    getTeamInvitationDetails(code: string): Promise<Result<{ teamDisplayName: string }, KnownErrors[\"VerificationCodeError\"] | KnownErrors[\"TeamInvitationEmailMismatch\"]>>,\n    verifyEmail(code: string): Promise<Result<undefined, KnownErrors[\"VerificationCodeError\"]>>,\n    signInWithMagicLink(code: string, options?: { noRedirect?: boolean }): Promise<Result<undefined, KnownErrors[\"VerificationCodeError\"] | KnownErrors[\"InvalidTotpCode\"]>>,\n    signInWithMfa(otp: string, code: string, options?: { noRedirect?: boolean }): Promise<Result<undefined, KnownErrors[\"VerificationCodeError\"] | KnownErrors[\"InvalidTotpCode\"]>>,\n\n    redirectToOAuthCallback(): Promise<void>,\n\n    getConvexClientAuth(options: HasTokenStore extends false ? { tokenStore: TokenStoreInit } : { tokenStore?: TokenStoreInit }): (args: { forceRefreshToken: boolean }) => Promise<string | null>,\n    getConvexHttpClientAuth(options: { tokenStore: TokenStoreInit }): Promise<string>,\n\n    useUser(options: GetCurrentUserOptions<HasTokenStore> & { or: 'redirect' }): ProjectCurrentUser<ProjectId>,\n    useUser(options: GetCurrentUserOptions<HasTokenStore> & { or: 'throw' }): ProjectCurrentUser<ProjectId>,\n    useUser(options: GetCurrentUserOptions<HasTokenStore> & { or: 'anonymous' }): ProjectCurrentUser<ProjectId>,\n    useUser(options?: GetCurrentUserOptions<HasTokenStore>): ProjectCurrentUser<ProjectId> | null,\n\n    getUser(options: GetCurrentUserOptions<HasTokenStore> & { or: 'redirect' }): Promise<ProjectCurrentUser<ProjectId>>,\n    getUser(options: GetCurrentUserOptions<HasTokenStore> & { or: 'throw' }): Promise<ProjectCurrentUser<ProjectId>>,\n    getUser(options: GetCurrentUserOptions<HasTokenStore> & { or: 'anonymous' }): Promise<ProjectCurrentUser<ProjectId>>,\n    getUser(options?: GetCurrentUserOptions<HasTokenStore>): Promise<ProjectCurrentUser<ProjectId> | null>,\n\n    cancelSubscription(options: { productId: string, subscriptionId?: string } | { productId: string, subscriptionId?: string, teamId: string }): Promise<void>,\n\n    // note: we don't special-case 'anonymous' here to return non-null, see GetPartialUserOptions for more details\n    getPartialUser(options: GetCurrentPartialUserOptions<HasTokenStore> & { from: 'token' }): Promise<TokenPartialUser | null>,\n    getPartialUser(options: GetCurrentPartialUserOptions<HasTokenStore> & { from: 'convex' }): Promise<TokenPartialUser | null>,\n    getPartialUser(options: GetCurrentPartialUserOptions<HasTokenStore>): Promise<SyncedPartialUser | TokenPartialUser | null>,\n    usePartialUser(options: GetCurrentPartialUserOptions<HasTokenStore> & { from: 'token' }): TokenPartialUser | null,\n    usePartialUser(options: GetCurrentPartialUserOptions<HasTokenStore> & { from: 'convex' }): TokenPartialUser | null,\n    usePartialUser(options: GetCurrentPartialUserOptions<HasTokenStore>): SyncedPartialUser | TokenPartialUser | null,\n    useNavigate(): (to: string) => void, // THIS_LINE_PLATFORM react-like\n\n    [stackAppInternalsSymbol]: {\n      toClientJson(): StackClientAppJson<HasTokenStore, ProjectId>,\n      setCurrentUser(userJsonPromise: Promise<CurrentUserCrud['Client']['Read'] | null>): void,\n      getConstructorOptions(): StackClientAppConstructorOptions<HasTokenStore, ProjectId> & { inheritsFrom?: undefined },\n      sendSessionReplayBatch(body: string, options: { keepalive: boolean }): Promise<Result<Response, Error>>,\n      sendAnalyticsEventBatch(body: string, options: { keepalive: boolean }): Promise<Result<Response, Error>>,\n      addRequestListener(listener: RequestListener): () => void,\n      sendRequest(path: string, requestOptions: RequestInit, requestType?: \"client\" | \"server\" | \"admin\"): Promise<Response>,\n      getRedirectMethod(): RedirectMethod,\n      redirectToUrl(url: string | URL, options?: { replace?: boolean }): Promise<void>,\n      signInWithTokens(tokens: { accessToken: string, refreshToken: string }): Promise<void>,\n    },\n  }\n  & AsyncStoreProperty<\"project\", [], Project, false>\n  & AsyncStoreProperty<\n    \"item\",\n    [{ itemId: string, userId: string } | { itemId: string, teamId: string } | { itemId: string, customCustomerId: string }],\n    Item,\n    false\n  >\n  & AsyncStoreProperty<\n    \"products\",\n    [options: CustomerProductsRequestOptions],\n    CustomerProductsList,\n    true\n  >\n  & AsyncStoreProperty<\n    \"invoices\",\n    [options: CustomerInvoicesRequestOptions],\n    CustomerInvoicesList,\n    true\n  >\n  & { [K in `redirectTo${Capitalize<keyof Omit<HandlerUrls, 'handler' | 'oauthCallback'>>}`]: (options?: RedirectToOptions) => Promise<void> }\n  & AuthLike<HasTokenStore extends false ? { tokenStore: TokenStoreInit } : { tokenStore?: TokenStoreInit }>\n);\nexport type StackClientAppConstructor = {\n  new <\n    TokenStoreType extends string,\n    HasTokenStore extends (TokenStoreType extends {} ? true : boolean),\n    ProjectId extends string\n  >(options: StackClientAppConstructorOptions<HasTokenStore, ProjectId>): StackClientApp<HasTokenStore, ProjectId>,\n  new(options: StackClientAppConstructorOptions<boolean, string>): StackClientApp<boolean, string>,\n\n  [stackAppInternalsSymbol]: {\n    fromClientJson<HasTokenStore extends boolean, ProjectId extends string>(\n      json: StackClientAppJson<HasTokenStore, ProjectId>\n    ): StackClientApp<HasTokenStore, ProjectId>,\n  },\n};\nexport const StackClientApp: StackClientAppConstructor = _StackClientAppImpl;\n"],"mappings":";;;;;AAwKA,MAAa,iBAA4CA"}

package/dist/lib/stack-app/apps/interfaces/server-app.d.ts

@@ -0,0 +1,153 @@
+import { t as GenericQueryCtx } from "../../../../storage-CKzvsBxG.js";
+import { AsyncStoreProperty, GetCurrentPartialUserOptions, GetCurrentUserOptions } from "../../common.js";
+import { CustomerProductsList, CustomerProductsRequestOptions, InlineProduct, ServerItem } from "../../customers/index.js";
+import { EmailDeliveryInfo, SendEmailOptions } from "../../email/index.js";
+import { DataVaultStore } from "../../data-vault/index.js";
+import { ProjectCurrentServerUser, ServerOAuthProvider, ServerUser, ServerUserCreateOptions, SyncedPartialServerUser, TokenPartialUser } from "../../users/index.js";
+import { ServerListTeamsOptions, ServerListUsersOptions, ServerTeam, ServerTeamCreateOptions } from "../../teams/index.js";
+import { StackClientApp, StackClientAppConstructorOptions } from "./client-app.js";
+import { KnownErrors } from "@stackframe/stack-shared";
+import { Result } from "@stackframe/stack-shared/dist/utils/results";
+
+//#region src/lib/stack-app/apps/interfaces/server-app.d.ts
+type StackServerAppConstructorOptions<HasTokenStore extends boolean, ProjectId extends string> = StackClientAppConstructorOptions<HasTokenStore, ProjectId> & {
+  secretServerKey?: 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>;
+  grantProduct(options: (({
+    userId: string;
+  } | {
+    teamId: string;
+  } | {
+    customCustomerId: string;
+  }) & ({
+    productId: string;
+  } | {
+    product: InlineProduct;
+  }) & {
+    quantity?: number;
+  })): Promise<void>;
+  useUser(options: GetCurrentUserOptions<HasTokenStore> & {
+    or: 'redirect';
+  }): ProjectCurrentServerUser<ProjectId>;
+  useUser(options: GetCurrentUserOptions<HasTokenStore> & {
+    or: 'throw';
+  }): ProjectCurrentServerUser<ProjectId>;
+  useUser(options: GetCurrentUserOptions<HasTokenStore> & {
+    or: 'anonymous';
+  }): ProjectCurrentServerUser<ProjectId>;
+  useUser(options?: GetCurrentUserOptions<HasTokenStore>): ProjectCurrentServerUser<ProjectId> | null;
+  useUser(id: string): ServerUser | null;
+  useUser(options: {
+    apiKey: string;
+    or?: "return-null" | "anonymous";
+  }): ServerUser | null;
+  useUser(options: {
+    from: "convex";
+    ctx: GenericQueryCtx<any>;
+    or?: "return-null" | "anonymous";
+  }): ServerUser | null;
+  getUser(options: GetCurrentUserOptions<HasTokenStore> & {
+    or: 'redirect';
+  }): Promise<ProjectCurrentServerUser<ProjectId>>;
+  getUser(options: GetCurrentUserOptions<HasTokenStore> & {
+    or: 'throw';
+  }): Promise<ProjectCurrentServerUser<ProjectId>>;
+  getUser(options: GetCurrentUserOptions<HasTokenStore> & {
+    or: 'anonymous';
+  }): Promise<ProjectCurrentServerUser<ProjectId>>;
+  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;
+  }): ServerTeam | null;
+  getTeam(id: string): Promise<ServerTeam | null>;
+  getTeam(options: {
+    apiKey: string;
+  }): Promise<ServerTeam | null>;
+  useUsers(options?: ServerListUsersOptions): ServerUser[] & {
+    nextCursor: string | null;
+  };
+  listUsers(options?: ServerListUsersOptions): Promise<ServerUser[] & {
+    nextCursor: string | null;
+  }>;
+  /**
+   * Returns every direct (or recursive) team permission grant for every
+   * member of the given team in one request. Use this instead of calling
+   * `user.listPermissions(team)` per row when rendering a roster — that
+   * pattern produces an N+1 over the team-member endpoint.
+   */
+  listTeamMemberPermissions(teamId: string, options?: {
+    recursive?: boolean;
+  }): Promise<{
+    userId: string;
+    permissionId: string;
+  }[]>;
+  useTeamMemberPermissions(teamId: string, options?: {
+    recursive?: boolean;
+  }): {
+    userId: string;
+    permissionId: string;
+  }[];
+  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>;
+  getEmailDeliveryStats(): Promise<EmailDeliveryInfo>;
+  useEmailDeliveryStats(): EmailDeliveryInfo;
+  activateEmailCapacityBoost(): Promise<void>;
+} & AsyncStoreProperty<"user", [id: string], ServerUser | null, false> & Omit<AsyncStoreProperty<"users", [], ServerUser[], true>, "listUsers" | "useUsers"> & AsyncStoreProperty<"teams", [options?: ServerListTeamsOptions], ServerTeam[] & {
+  nextCursor: string | null;
+}, true> & AsyncStoreProperty<"dataVaultStore", [id: string], DataVaultStore, false> & AsyncStoreProperty<"item", [{
+  itemId: string;
+  userId: string;
+} | {
+  itemId: string;
+  teamId: string;
+} | {
+  itemId: string;
+  customCustomerId: string;
+}], ServerItem, false> & AsyncStoreProperty<"products", [options: CustomerProductsRequestOptions], CustomerProductsList, true> & StackClientApp<HasTokenStore, ProjectId>);
+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>;
+};
+declare const StackServerApp: StackServerAppConstructor;
+//#endregion
+export { StackServerApp, StackServerAppConstructor, StackServerAppConstructorOptions };
+//# sourceMappingURL=server-app.d.ts.map

package/dist/lib/stack-app/apps/interfaces/server-app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-app.d.ts","names":[],"sources":["../../../../../src/lib/stack-app/apps/interfaces/server-app.ts"],"mappings":"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"}

package/dist/lib/stack-app/apps/interfaces/server-app.js

@@ -0,0 +1,10 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_chunk = require('../../../../chunk-BE-pF4vm.js');
+let ___implementations_index_js = require("../implementations/index.js");
+
+//#region src/lib/stack-app/apps/interfaces/server-app.ts
+const StackServerApp = ___implementations_index_js._StackServerAppImpl;
+
+//#endregion
+exports.StackServerApp = StackServerApp;
+//# sourceMappingURL=server-app.js.map

package/dist/lib/stack-app/apps/interfaces/server-app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-app.js","names":["_StackServerAppImpl"],"sources":["../../../../../src/lib/stack-app/apps/interfaces/server-app.ts"],"sourcesContent":["\n//===========================================\n// THIS FILE IS AUTO-GENERATED FROM TEMPLATE. DO NOT EDIT IT DIRECTLY, INSTEAD EDIT THE CORRESPONDING FILE IN packages/template\n//===========================================\nimport { KnownErrors } from \"@stackframe/stack-shared\";\nimport { Result } from \"@stackframe/stack-shared/dist/utils/results\";\nimport type { GenericQueryCtx } from \"convex/server\";\nimport { AsyncStoreProperty, GetCurrentPartialUserOptions, GetCurrentUserOptions } from \"../../common\";\nimport { CustomerProductsList, CustomerProductsRequestOptions, InlineProduct, ServerItem } from \"../../customers\";\nimport { DataVaultStore } from \"../../data-vault\";\nimport { EmailDeliveryInfo, SendEmailOptions } from \"../../email\";\nimport { ServerListTeamsOptions, ServerListUsersOptions, ServerTeam, ServerTeamCreateOptions } from \"../../teams\";\nimport { ProjectCurrentServerUser, ServerOAuthProvider, ServerUser, ServerUserCreateOptions, SyncedPartialServerUser, TokenPartialUser } from \"../../users\";\nimport { _StackServerAppImpl } from \"../implementations\";\nimport { StackClientApp, StackClientAppConstructorOptions } from \"./client-app\";\n\n\nexport type StackServerAppConstructorOptions<HasTokenStore extends boolean, ProjectId extends string> = StackClientAppConstructorOptions<HasTokenStore, ProjectId> & {\n  secretServerKey?: string,\n};\n\nexport type StackServerApp<HasTokenStore extends boolean = boolean, ProjectId extends string = string> = (\n  & {\n    createTeam(data: ServerTeamCreateOptions): Promise<ServerTeam>,\n    /**\n     * @deprecated use `getUser()` instead\n     */\n    getServerUser(): Promise<ProjectCurrentServerUser<ProjectId> | null>,\n\n    createUser(options: ServerUserCreateOptions): Promise<ServerUser>,\n    grantProduct(options: (\n      ({ userId: string } | { teamId: string } | { customCustomerId: string }) &\n      ({ productId: string } | { product: InlineProduct }) &\n      { quantity?: number }\n    )): Promise<void>,\n\n    useUser(options: GetCurrentUserOptions<HasTokenStore> & { or: 'redirect' }): ProjectCurrentServerUser<ProjectId>,\n    useUser(options: GetCurrentUserOptions<HasTokenStore> & { or: 'throw' }): ProjectCurrentServerUser<ProjectId>,\n    useUser(options: GetCurrentUserOptions<HasTokenStore> & { or: 'anonymous' }): ProjectCurrentServerUser<ProjectId>,\n    useUser(options?: GetCurrentUserOptions<HasTokenStore>): ProjectCurrentServerUser<ProjectId> | null,\n    useUser(id: string): ServerUser | null,\n    useUser(options: { apiKey: string, or?: \"return-null\" | \"anonymous\" }): ServerUser | null,\n    useUser(options: { from: \"convex\", ctx: GenericQueryCtx<any>, or?: \"return-null\" | \"anonymous\" }): ServerUser | null,\n\n    getUser(options: GetCurrentUserOptions<HasTokenStore> & { or: 'redirect' }): Promise<ProjectCurrentServerUser<ProjectId>>,\n    getUser(options: GetCurrentUserOptions<HasTokenStore> & { or: 'throw' }): Promise<ProjectCurrentServerUser<ProjectId>>,\n    getUser(options: GetCurrentUserOptions<HasTokenStore> & { or: 'anonymous' }): Promise<ProjectCurrentServerUser<ProjectId>>,\n    getUser(options?: GetCurrentUserOptions<HasTokenStore>): Promise<ProjectCurrentServerUser<ProjectId> | null>,\n    getUser(id: string): Promise<ServerUser | null>,\n    getUser(options: { apiKey: string, or?: \"return-null\" | \"anonymous\" }): Promise<ServerUser | null>,\n    getUser(options: { from: \"convex\", ctx: GenericQueryCtx<any>, or?: \"return-null\" | \"anonymous\" }): Promise<ServerUser | null>,\n\n    // note: we don't special-case 'anonymous' here to return non-null, see GetPartialUserOptions for more details\n    getPartialUser(options: GetCurrentPartialUserOptions<HasTokenStore> & { from: 'token' }): Promise<TokenPartialUser | null>,\n    getPartialUser(options: GetCurrentPartialUserOptions<HasTokenStore> & { from: 'convex' }): Promise<TokenPartialUser | null>,\n    getPartialUser(options: GetCurrentPartialUserOptions<HasTokenStore>): Promise<SyncedPartialServerUser | TokenPartialUser | null>,\n    usePartialUser(options: GetCurrentPartialUserOptions<HasTokenStore> & { from: 'token' }): TokenPartialUser | null,\n    usePartialUser(options: GetCurrentPartialUserOptions<HasTokenStore> & { from: 'convex' }): TokenPartialUser | null,\n    usePartialUser(options: GetCurrentPartialUserOptions<HasTokenStore>): SyncedPartialServerUser | TokenPartialUser | null,\n    useTeam(id: string): ServerTeam | null,\n    useTeam(options: { apiKey: string }): ServerTeam | null,\n    getTeam(id: string): Promise<ServerTeam | null>,\n    getTeam(options: { apiKey: string }): Promise<ServerTeam | null>,\n\n\n    useUsers(options?: ServerListUsersOptions): ServerUser[] & { nextCursor: string | null }, // THIS_LINE_PLATFORM react-like\n    listUsers(options?: ServerListUsersOptions): Promise<ServerUser[] & { nextCursor: string | null }>,\n\n    /**\n     * Returns every direct (or recursive) team permission grant for every\n     * member of the given team in one request. Use this instead of calling\n     * `user.listPermissions(team)` per row when rendering a roster — that\n     * pattern produces an N+1 over the team-member endpoint.\n     */\n    listTeamMemberPermissions(teamId: string, options?: { recursive?: boolean }): Promise<{ userId: string, permissionId: string }[]>,\n    useTeamMemberPermissions(teamId: string, options?: { recursive?: boolean }): { userId: string, permissionId: string }[],\n\n    // TODO this should actually be on ServerUser\n    createOAuthProvider(options: {\n      userId: string,\n      accountId: string,\n      providerConfigId: string,\n      email: string,\n      allowSignIn: boolean,\n      allowConnectedAccounts: boolean,\n    }): Promise<Result<ServerOAuthProvider, InstanceType<typeof KnownErrors.OAuthProviderAccountIdAlreadyUsedForSignIn>>>,\n\n    sendEmail(options: SendEmailOptions): Promise<void>,\n\n    getEmailDeliveryStats(): Promise<EmailDeliveryInfo>,\n    useEmailDeliveryStats(): EmailDeliveryInfo,\n\n    activateEmailCapacityBoost(): Promise<void>,\n  }\n  & AsyncStoreProperty<\"user\", [id: string], ServerUser | null, false>\n  & Omit<AsyncStoreProperty<\"users\", [], ServerUser[], true>, \"listUsers\" | \"useUsers\">\n  & AsyncStoreProperty<\"teams\", [options?: ServerListTeamsOptions], ServerTeam[] & { nextCursor: string | null }, true>\n  & AsyncStoreProperty<\"dataVaultStore\", [id: string], DataVaultStore, false>\n  & AsyncStoreProperty<\n    \"item\",\n    [{ itemId: string, userId: string } | { itemId: string, teamId: string } | { itemId: string, customCustomerId: string }],\n    ServerItem,\n    false\n  >\n  & AsyncStoreProperty<\n    \"products\",\n    [options: CustomerProductsRequestOptions],\n    CustomerProductsList,\n    true\n  >\n  & StackClientApp<HasTokenStore, ProjectId>\n);\nexport type StackServerAppConstructor = {\n  new <\n    TokenStoreType extends string,\n    HasTokenStore extends (TokenStoreType extends {} ? true : boolean),\n    ProjectId extends string\n  >(options: StackServerAppConstructorOptions<HasTokenStore, ProjectId>): StackServerApp<HasTokenStore, ProjectId>,\n  new (options: StackServerAppConstructorOptions<boolean, string>): StackServerApp<boolean, string>,\n};\nexport const StackServerApp: StackServerAppConstructor = _StackServerAppImpl;\n"],"mappings":";;;;;AAwHA,MAAa,iBAA4CA"}

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

@@ -0,0 +1,183 @@
+import { r as UserIdentity, t as GenericQueryCtx } from "../../storage-CKzvsBxG.js";
+import { ProviderType } from "@stackframe/stack-shared/dist/utils/oauth";
+import { DefaultHandlerUrlTarget, HandlerPageUrls, HandlerRedirectUrls, HandlerUrlOptions, HandlerUrlTarget, HandlerUrls, ResolvedHandlerUrls } from "@stackframe/stack-shared/dist/interface/handler-urls";
+
+//#region src/lib/stack-app/common.d.ts
+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> } & { [key in `use${Capitalize<Name>}`]: (...args: Args) => Value };
+type EmailConfig = {
+  host: string;
+  port: number;
+  username: string;
+  password: string;
+  senderEmail: string;
+  senderName: string;
+};
+type RedirectMethod = "window" | "tanstack-start" | "none" | {
+  useNavigate: () => (to: string) => void;
+  navigate?: (to: string) => void;
+};
+type GetCurrentUserOptions<HasTokenStore> = {
+  or?: 'redirect' | 'throw' | 'return-null' | 'anonymous' | /** @deprecated */'anonymous-if-exists[deprecated]';
+  /**
+   * Whether to include restricted users (users who haven't completed onboarding requirements like email verification).
+   * By default, restricted users are filtered out (treated similar to anonymous users).
+   *
+   * Note: This option cannot be set to false when `or: 'anonymous'` is used, as all anonymous users are also restricted.
+   *
+   * @default false
+   */
+  includeRestricted?: boolean;
+  tokenStore?: TokenStoreInit;
+} & (HasTokenStore extends false ? {
+  tokenStore: TokenStoreInit;
+} : {});
+type ConvexCtx = GenericQueryCtx<any> | {
+  auth: {
+    getUserIdentity: () => Promise<UserIdentity | null>;
+  };
+};
+type GetCurrentPartialUserOptions<HasTokenStore> = {
+  or?: 'return-null' | 'anonymous-if-exists';
+  tokenStore?: TokenStoreInit;
+} & ({
+  from: 'token';
+} | {
+  from: 'convex';
+  ctx: ConvexCtx;
+}) & (HasTokenStore extends false ? {
+  tokenStore: TokenStoreInit;
+} : {});
+type RequestLike = {
+  headers: {
+    get: (name: string) => string | null;
+  } | Record<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 OAuthScopesOnSignIn = { [key in ProviderType]: string[] };
+/**
+ * Contains the authentication methods without session-related fields.
+ * Used for apps that have token storage capabilities.
+ */
+type AuthLike<ExtraOptions = {}> = {
+  signOut(options?: {
+    redirectUrl?: URL | string;
+  } & ExtraOptions): Promise<void>;
+  signOut(options?: {
+    redirectUrl?: URL | string;
+  }): Promise<void>;
+  /**
+   * Returns the current access token, or null if the user is not signed in.
+   *
+   * The access token is a short-lived JWT that can be used to authenticate requests to external servers.
+   * It will be automatically refreshed when it expires.
+   */
+  getAccessToken(options?: {} & ExtraOptions): Promise<string | null>;
+  useAccessToken(options?: {} & ExtraOptions): string | null;
+  /**
+   * Returns the current refresh token, or null if the user is not signed in.
+   *
+   * The refresh token is a long-lived token that can be used to obtain new access tokens.
+   * It should be kept secret and never exposed to the client.
+   */
+  getRefreshToken(options?: {} & ExtraOptions): Promise<string | null>;
+  useRefreshToken(options?: {} & ExtraOptions): string | null;
+  /**
+   * Returns the value for the HTTP `Authorization` header for authenticated 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 the header value in this format:
+   * `Bearer stackauth_<base64(getAuthJson())>`, or `null` if the user is not signed in.
+   * You can use this 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 `authorization` 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), use `getAuthJson()` instead.
+   *
+   * Example:
+   *
+   * ```ts
+   * // client
+   * const authorizationHeader = await stackApp.getAuthorizationHeader();
+   * const res = await fetch("https://api.example.com", {
+   *   headers: {
+   *     ...(authorizationHeader ? { Authorization: authorizationHeader } : {})
+   *     // 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);
+   * }
+   * ```
+   */
+  getAuthorizationHeader(options?: {} & ExtraOptions): Promise<string | null>;
+  useAuthorizationHeader(options?: {} & ExtraOptions): string | null;
+  /**
+   * @deprecated Use `getAuthorizationHeader()` instead.
+   *
+   * Returns the legacy `x-stack-auth` headers for authenticated HTTP requests. This remains for backwards
+   * compatibility with existing integrations.
+   */
+  getAuthHeaders(options?: {} & ExtraOptions): Promise<{
+    "x-stack-auth": string;
+  }>; /** @deprecated Use `useAuthorizationHeader()` instead. */
+  useAuthHeaders(options?: {} & ExtraOptions): {
+    "x-stack-auth": string;
+  };
+  /**
+   * Creates a JSON-serializable object containing the information to authenticate a user on an external server.
+   * Similar to `getAuthorizationHeader`, but returns an object that can be sent over any protocol instead of just
+   * HTTP headers.
+   *
+   * While `getAuthorizationHeader` 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(options?: {} & ExtraOptions): Promise<{
+    accessToken: string | null;
+    refreshToken: string | null;
+  }>;
+  useAuthJson(options?: {} & ExtraOptions): {
+    accessToken: string | null;
+    refreshToken: string | null;
+  };
+};
+/** @internal */
+declare const stackAppInternalsSymbol: unique symbol;
+//#endregion
+export { AsyncStoreProperty, AuthLike, ConvexCtx, type DefaultHandlerUrlTarget, EmailConfig, GetCurrentPartialUserOptions, GetCurrentUserOptions, type HandlerPageUrls, type HandlerRedirectUrls, type HandlerUrlOptions, type HandlerUrlTarget, type HandlerUrls, OAuthScopesOnSignIn, RedirectMethod, RedirectToOptions, RequestLike, type ResolvedHandlerUrls, TokenStoreInit, stackAppInternalsSymbol };
+//# sourceMappingURL=common.d.ts.map