better-auth/dist/plugins/oauth-popup/types.d.mts

The most comprehensive authentication framework for TypeScript.

import { OAUTH_POPUP_MESSAGE_TYPE } from "./constants.mjs";

//#region src/plugins/oauth-popup/types.d.ts
/** OAuth error relayed to the opener when the flow fails. */
interface OAuthPopupError {
  code: string;
  description?: string;
}
/**
 * Message the completion page posts to its opener — success carries the token,
 * failure carries the error.
 */
interface OAuthPopupMessage {
  type: typeof OAUTH_POPUP_MESSAGE_TYPE;
  /** Echoes the request nonce so the opener can correlate the handoff. */
  nonce: string;
  /** The session token, sent as `Authorization: Bearer <token>` (on success). */
  token?: string;
  /** Where the flow would have redirected (callbackURL / newUserURL). */
  redirectTo?: string;
  /** The OAuth error (on failure). */
  error?: OAuthPopupError;
}
/** Payload embedded in the completion page's data block. */
interface OAuthPopupData extends OAuthPopupMessage {
  /** Exact origin the message is posted to (the trusted popup opener). */
  targetOrigin: string;
}
//#endregion
export { OAuthPopupData, OAuthPopupMessage };