@8wave/ai-elements 0.119.0-beta.59 → 0.119.0-beta.62

package/dist-vue/apps/web-component/src/composables/useChatbotAuth.d.ts

@@ -51,15 +51,44 @@ declare function externalAuthClient(): {
                 error: null;
             }>;
         };
+        externalToken: {
+            /** Hands the current session a fresh token of its own user. */
+            refresh: (data: {
+                token: string;
+            }) => Promise<{
+                data: null;
+                error: {
+                    message?: string | undefined;
+                    status: number;
+                    statusText: string;
+                };
+            } | {
+                data: {
+                    expiresAt: string | null;
+                };
+                error: null;
+            }>;
+        };
     };
     pathMethods: {
         '/sign-in/external-token': "POST";
+        '/external-token/refresh': "POST";
     };
     atomListeners: {
         matcher: (path: string) => path is "/sign-in/external-token";
         signal: "$sessionSignal";
     }[];
 };
+/**
+ * When to ask the host for the next token, in ms from `now`, for a token
+ * that expires at `expiresAt` (seconds, the `exp` claim). A minute before
+ * the expiry, but never before half of the time left, nor within ten
+ * seconds: a token that lives a minute or less, or a browser clock running
+ * ahead of the provider's, would otherwise have the host asked again as soon
+ * as it answers. Nothing for a token already expired here: asking cannot
+ * help it.
+ */
+export declare function externalTokenExpiringDelay(expiresAt: number, now?: number): number | undefined;
 type AuthClientOptions = {
     baseURL?: string;
     basePath?: string;
@@ -101,6 +130,13 @@ export declare function useChatbotAuth(options?: {
      * signature or disabled config): the host should provide a fresh token.
      */
     onExternalAuthExpired?: () => void;
+    /**
+     * Called a minute before the external token of the session expires,
+     * while the session goes on: the host should provide a fresh token,
+     * which the session takes in place. The MCP servers that receive the
+     * user's token need a valid one on every turn.
+     */
+    onExternalTokenExpiring?: () => void;
 }): {
     client: VueAuthClient<AuthClientOptions>;
     session: Readonly<globalThis.Ref<{