@djangocfg/api 2.1.447 → 2.1.449

package/dist/clients.d.cts

@@ -813,11 +813,11 @@ type OAuthTokenResponse = {
     /**
      * True if a new user was created during this OAuth flow
      */
-    is_new_user: boolean;
+    is_new_user?: boolean;
     /**
      * True if a new OAuth connection was created
      */
-    is_new_connection: boolean;
+    is_new_connection?: boolean;
     /**
      * True if user should be prompted to enable 2FA
      */
@@ -871,6 +871,10 @@ type OtpRequestResponse = {
      * Success message
      */
     message: string;
+    /**
+     * Webmail deep-link for the recipient's provider, or null if the domain is unknown.
+     */
+    webmail?: WebmailLink | null;
 };
 /**
  * Serializer for OTP verification.
@@ -1120,6 +1124,129 @@ type VerifyResponse = {
      */
     warning?: string;
 };
+/**
+ * Deep-link that opens the user's webmail on a search for our login email.
+ *
+ * Present only when the recipient's email domain maps to a known webmail
+ * provider (Gmail, Outlook, Mail.ru, Yandex, iCloud, …). For unknown/corporate
+ * domains this whole object is null and the frontend shows no button.
+ */
+type WebmailLink = {
+    /**
+     * Provider slug (e.g. 'gmail', 'outlook', 'mail_ru'). Also selects the brand icon on the frontend.
+     *
+     * * `gmail` - gmail
+     * * `outlook` - outlook
+     * * `yahoo` - yahoo
+     * * `icloud` - icloud
+     * * `proton` - proton
+     * * `zoho` - zoho
+     * * `aol` - aol
+     * * `fastmail` - fastmail
+     * * `gmx` - gmx
+     * * `mailcom` - mailcom
+     * * `mail_ru` - mail_ru
+     * * `yandex` - yandex
+     * * `rambler` - rambler
+     * * `qq` - qq
+     * * `netease` - netease
+     * * `sina` - sina
+     * * `aliyun` - aliyun
+     * * `naver` - naver
+     * * `daum` - daum
+     * * `web_de` - web_de
+     * * `tonline` - tonline
+     * * `seznam` - seznam
+     * * `wp_pl` - wp_pl
+     * * `o2_pl` - o2_pl
+     * * `interia` - interia
+     * * `libero` - libero
+     * * `virgilio` - virgilio
+     * * `orange` - orange
+     * * `laposte` - laposte
+     * * `free_fr` - free_fr
+     * * `sfr` - sfr
+     */
+    provider: WebmailLinkProviderEnum;
+    /**
+     * Human-facing provider name, e.g. 'Gmail'.
+     */
+    provider_name: string;
+    /**
+     * Absolute URL to open in a new tab (a sender-filtered search, or the inbox as fallback).
+     */
+    url: string;
+    /**
+     * True if the URL opens a search filtered to our sender; False if it only opens the inbox.
+     */
+    is_search: boolean;
+};
+/**
+ * * `gmail` - gmail
+ * * `outlook` - outlook
+ * * `yahoo` - yahoo
+ * * `icloud` - icloud
+ * * `proton` - proton
+ * * `zoho` - zoho
+ * * `aol` - aol
+ * * `fastmail` - fastmail
+ * * `gmx` - gmx
+ * * `mailcom` - mailcom
+ * * `mail_ru` - mail_ru
+ * * `yandex` - yandex
+ * * `rambler` - rambler
+ * * `qq` - qq
+ * * `netease` - netease
+ * * `sina` - sina
+ * * `aliyun` - aliyun
+ * * `naver` - naver
+ * * `daum` - daum
+ * * `web_de` - web_de
+ * * `tonline` - tonline
+ * * `seznam` - seznam
+ * * `wp_pl` - wp_pl
+ * * `o2_pl` - o2_pl
+ * * `interia` - interia
+ * * `libero` - libero
+ * * `virgilio` - virgilio
+ * * `orange` - orange
+ * * `laposte` - laposte
+ * * `free_fr` - free_fr
+ * * `sfr` - sfr
+ */
+declare enum WebmailLinkProviderEnum {
+    GMAIL = "gmail",
+    OUTLOOK = "outlook",
+    YAHOO = "yahoo",
+    ICLOUD = "icloud",
+    PROTON = "proton",
+    ZOHO = "zoho",
+    AOL = "aol",
+    FASTMAIL = "fastmail",
+    GMX = "gmx",
+    MAILCOM = "mailcom",
+    MAIL_RU = "mail_ru",
+    YANDEX = "yandex",
+    RAMBLER = "rambler",
+    QQ = "qq",
+    NETEASE = "netease",
+    SINA = "sina",
+    ALIYUN = "aliyun",
+    NAVER = "naver",
+    DAUM = "daum",
+    WEB_DE = "web_de",
+    TONLINE = "tonline",
+    SEZNAM = "seznam",
+    WP_PL = "wp_pl",
+    O2_PL = "o2_pl",
+    INTERIA = "interia",
+    LIBERO = "libero",
+    VIRGILIO = "virgilio",
+    ORANGE = "orange",
+    LAPOSTE = "laposte",
+    FREE_FR = "free_fr",
+    SFR = "sfr"
+}
 type CfgAccountsOauthConnectionsResponse200AutoRef = Array<OAuthConnection>;
 type CfgAccountsOauthDisconnectResponse200AutoRef = {
     message?: string;
@@ -1822,6 +1949,12 @@ declare class API$2 {
         access: string;
         refresh?: string;
     } | null>) | null): void;
+    /**
+     * Proactively refresh now via the registered handler, sharing the single
+     * 401-recovery flight (rotation + dedup + rotated-token persistence).
+     * See `auth.refreshNow`.
+     */
+    refreshNow(): Promise<string | null>;
 }
 
 interface APIOptions$1 {
@@ -1867,6 +2000,12 @@ declare class API$1 {
         access: string;
         refresh?: string;
     } | null>) | null): void;
+    /**
+     * Proactively refresh now via the registered handler, sharing the single
+     * 401-recovery flight (rotation + dedup + rotated-token persistence).
+     * See `auth.refreshNow`.
+     */
+    refreshNow(): Promise<string | null>;
 }
 
 interface APIOptions {
@@ -1915,6 +2054,12 @@ declare class API {
         access: string;
         refresh?: string;
     } | null>) | null): void;
+    /**
+     * Proactively refresh now via the registered handler, sharing the single
+     * 401-recovery flight (rotation + dedup + rotated-token persistence).
+     * See `auth.refreshNow`.
+     */
+    refreshNow(): Promise<string | null>;
 }
 
 declare const CfgAccountsApi: API$2;

package/dist/clients.d.ts

@@ -813,11 +813,11 @@ type OAuthTokenResponse = {
     /**
      * True if a new user was created during this OAuth flow
      */
-    is_new_user: boolean;
+    is_new_user?: boolean;
     /**
      * True if a new OAuth connection was created
      */
-    is_new_connection: boolean;
+    is_new_connection?: boolean;
     /**
      * True if user should be prompted to enable 2FA
      */
@@ -871,6 +871,10 @@ type OtpRequestResponse = {
      * Success message
      */
     message: string;
+    /**
+     * Webmail deep-link for the recipient's provider, or null if the domain is unknown.
+     */
+    webmail?: WebmailLink | null;
 };
 /**
  * Serializer for OTP verification.
@@ -1120,6 +1124,129 @@ type VerifyResponse = {
      */
     warning?: string;
 };
+/**
+ * Deep-link that opens the user's webmail on a search for our login email.
+ *
+ * Present only when the recipient's email domain maps to a known webmail
+ * provider (Gmail, Outlook, Mail.ru, Yandex, iCloud, …). For unknown/corporate
+ * domains this whole object is null and the frontend shows no button.
+ */
+type WebmailLink = {
+    /**
+     * Provider slug (e.g. 'gmail', 'outlook', 'mail_ru'). Also selects the brand icon on the frontend.
+     *
+     * * `gmail` - gmail
+     * * `outlook` - outlook
+     * * `yahoo` - yahoo
+     * * `icloud` - icloud
+     * * `proton` - proton
+     * * `zoho` - zoho
+     * * `aol` - aol
+     * * `fastmail` - fastmail
+     * * `gmx` - gmx
+     * * `mailcom` - mailcom
+     * * `mail_ru` - mail_ru
+     * * `yandex` - yandex
+     * * `rambler` - rambler
+     * * `qq` - qq
+     * * `netease` - netease
+     * * `sina` - sina
+     * * `aliyun` - aliyun
+     * * `naver` - naver
+     * * `daum` - daum
+     * * `web_de` - web_de
+     * * `tonline` - tonline
+     * * `seznam` - seznam
+     * * `wp_pl` - wp_pl
+     * * `o2_pl` - o2_pl
+     * * `interia` - interia
+     * * `libero` - libero
+     * * `virgilio` - virgilio
+     * * `orange` - orange
+     * * `laposte` - laposte
+     * * `free_fr` - free_fr
+     * * `sfr` - sfr
+     */
+    provider: WebmailLinkProviderEnum;
+    /**
+     * Human-facing provider name, e.g. 'Gmail'.
+     */
+    provider_name: string;
+    /**
+     * Absolute URL to open in a new tab (a sender-filtered search, or the inbox as fallback).
+     */
+    url: string;
+    /**
+     * True if the URL opens a search filtered to our sender; False if it only opens the inbox.
+     */
+    is_search: boolean;
+};
+/**
+ * * `gmail` - gmail
+ * * `outlook` - outlook
+ * * `yahoo` - yahoo
+ * * `icloud` - icloud
+ * * `proton` - proton
+ * * `zoho` - zoho
+ * * `aol` - aol
+ * * `fastmail` - fastmail
+ * * `gmx` - gmx
+ * * `mailcom` - mailcom
+ * * `mail_ru` - mail_ru
+ * * `yandex` - yandex
+ * * `rambler` - rambler
+ * * `qq` - qq
+ * * `netease` - netease
+ * * `sina` - sina
+ * * `aliyun` - aliyun
+ * * `naver` - naver
+ * * `daum` - daum
+ * * `web_de` - web_de
+ * * `tonline` - tonline
+ * * `seznam` - seznam
+ * * `wp_pl` - wp_pl
+ * * `o2_pl` - o2_pl
+ * * `interia` - interia
+ * * `libero` - libero
+ * * `virgilio` - virgilio
+ * * `orange` - orange
+ * * `laposte` - laposte
+ * * `free_fr` - free_fr
+ * * `sfr` - sfr
+ */
+declare enum WebmailLinkProviderEnum {
+    GMAIL = "gmail",
+    OUTLOOK = "outlook",
+    YAHOO = "yahoo",
+    ICLOUD = "icloud",
+    PROTON = "proton",
+    ZOHO = "zoho",
+    AOL = "aol",
+    FASTMAIL = "fastmail",
+    GMX = "gmx",
+    MAILCOM = "mailcom",
+    MAIL_RU = "mail_ru",
+    YANDEX = "yandex",
+    RAMBLER = "rambler",
+    QQ = "qq",
+    NETEASE = "netease",
+    SINA = "sina",
+    ALIYUN = "aliyun",
+    NAVER = "naver",
+    DAUM = "daum",
+    WEB_DE = "web_de",
+    TONLINE = "tonline",
+    SEZNAM = "seznam",
+    WP_PL = "wp_pl",
+    O2_PL = "o2_pl",
+    INTERIA = "interia",
+    LIBERO = "libero",
+    VIRGILIO = "virgilio",
+    ORANGE = "orange",
+    LAPOSTE = "laposte",
+    FREE_FR = "free_fr",
+    SFR = "sfr"
+}
 type CfgAccountsOauthConnectionsResponse200AutoRef = Array<OAuthConnection>;
 type CfgAccountsOauthDisconnectResponse200AutoRef = {
     message?: string;
@@ -1822,6 +1949,12 @@ declare class API$2 {
         access: string;
         refresh?: string;
     } | null>) | null): void;
+    /**
+     * Proactively refresh now via the registered handler, sharing the single
+     * 401-recovery flight (rotation + dedup + rotated-token persistence).
+     * See `auth.refreshNow`.
+     */
+    refreshNow(): Promise<string | null>;
 }
 
 interface APIOptions$1 {
@@ -1867,6 +2000,12 @@ declare class API$1 {
         access: string;
         refresh?: string;
     } | null>) | null): void;
+    /**
+     * Proactively refresh now via the registered handler, sharing the single
+     * 401-recovery flight (rotation + dedup + rotated-token persistence).
+     * See `auth.refreshNow`.
+     */
+    refreshNow(): Promise<string | null>;
 }
 
 interface APIOptions {
@@ -1915,6 +2054,12 @@ declare class API {
         access: string;
         refresh?: string;
     } | null>) | null): void;
+    /**
+     * Proactively refresh now via the registered handler, sharing the single
+     * 401-recovery flight (rotation + dedup + rotated-token persistence).
+     * See `auth.refreshNow`.
+     */
+    refreshNow(): Promise<string | null>;
 }
 
 declare const CfgAccountsApi: API$2;

package/dist/clients.mjs

@@ -271,6 +271,17 @@ var auth = {
    */
   setRefreshHandler(fn) {
     _refreshHandler = fn;
+  },
+  /**
+   * Proactively run the registered refresh handler right now, reusing the
+   * SAME single-flight promise as the 401-recovery interceptor. Callers
+   * (e.g. an expiry timer / focus / reconnect) get token rotation,
+   * de-duplication and rotated-token persistence for free — they must NOT
+   * re-implement any of it. Returns the fresh access token, or null if
+   * there is no handler / no refresh token / the refresh failed.
+   */
+  refreshNow() {
+    return tryRefresh();
   }
 };
 async function tryRefresh() {
@@ -1994,6 +2005,14 @@ var API = class {
   setRefreshHandler(fn) {
     auth.setRefreshHandler(fn);
   }
+  /**
+   * Proactively refresh now via the registered handler, sharing the single
+   * 401-recovery flight (rotation + dedup + rotated-token persistence).
+   * See `auth.refreshNow`.
+   */
+  refreshNow() {
+    return auth.refreshNow();
+  }
 };
 
 // src/_api/generated/_cfg_centrifugo/api.ts
@@ -2058,6 +2077,14 @@ var API2 = class {
   setRefreshHandler(fn) {
     auth.setRefreshHandler(fn);
   }
+  /**
+   * Proactively refresh now via the registered handler, sharing the single
+   * 401-recovery flight (rotation + dedup + rotated-token persistence).
+   * See `auth.refreshNow`.
+   */
+  refreshNow() {
+    return auth.refreshNow();
+  }
 };
 
 // src/_api/generated/_cfg_totp/api.ts
@@ -2125,6 +2152,14 @@ var API3 = class {
   setRefreshHandler(fn) {
     auth.setRefreshHandler(fn);
   }
+  /**
+   * Proactively refresh now via the registered handler, sharing the single
+   * 401-recovery flight (rotation + dedup + rotated-token persistence).
+   * See `auth.refreshNow`.
+   */
+  refreshNow() {
+    return auth.refreshNow();
+  }
 };
 
 // src/_api/generated/index.ts