Added option to the authentication that allows you to pass an existing token to tado

README.md

@@ -102,6 +102,7 @@ The following API calls are available
 /* Authentication */
 /*********************/
 tado.authenticate(refreshToken?, interval?);
+tado.authenticateWithToken(token?, interval?);
 tado.setTokenCallback(cb);
 
 /*********************/

examples/auth.ts

@@ -18,10 +18,16 @@ async function main(): Promise<void> {
     );
     console.log("------------------------------------------------");
   }
-  await futureToken;
+  const token = await futureToken;
 
   const me = await tado.getMe();
   console.log(me);
+
+  const [_, futureToken2] = await tado.authenticateWithToken(token);
+  const token2 = await futureToken2;
+  console.log("new token: ", token2);
+  const me2 = await tado.getMe();
+  console.log(me2);
 }
 
 main();

src/base.ts

@@ -218,6 +218,33 @@ export class BaseTado {
     return [verify.data, token];
   }
 
+  /**
+   * Authenticate with the Oauth server. An existing token may be supplied to bypass the device auth
+   * flow if it is still valid, otherwise the device flow is initiaited.
+   *
+   * @param existingToken - Attempt to use the provided token to re-authenticate
+   * @param timeout - Ignore the Tado provided timeout for device auth and use this value
+   * @returns A promise that resolves to either a `DeviceVerification` object for device auth flows
+   * and a promise of a token, or an undefined auth flow and a promise of a token, if the refresh token
+   * was supplied
+   */
+  async authenticateWithToken(
+    existingToken?: Token,
+    timeout?: number,
+  ): Promise<[DeviceVerification | undefined, Promise<Token>]> {
+    const now = new Date();
+
+    if (existingToken?.expiry && existingToken.expiry > now) {
+      this.#token = existingToken;
+      try {
+        return [undefined, new Promise((resolve) => resolve(existingToken))];
+      } catch {
+        // Refresh token is no good
+      }
+    }
+    return this.authenticate(existingToken?.refresh_token, timeout);
+  }
+
   /**
    * Makes an API call to the provided URL with the specified method and data.
    *