fix: token+apiKey 共存時のリフレッシュブロックを修正、プロアクティブリフレッシュを追加

canRefresh() が apiKey の存在で常に false を返し、token (JWT) で認証
しているにも関わらずリフレッシュが一切発動しなかった問題を修正。
apiKey-only（token なし）の場合のみリフレッシュを無効化するように変更。

併せて、リクエスト前に JWT の exp を確認し期限切れ/期限間近なら
事前にリフレッシュするプロアクティブ方式を追加。

Author: miya0001

CHANGELOG.md

@@ -7,6 +7,10 @@
 
 ## [Unreleased]
 
+### 2026-04-05
+- **Fix**: token と apiKey が config に共存する場合、`canRefresh()` が apiKey の存在でリフレッシュをブロックし、JWT 期限切れ後にセッションが復旧不能になる問題を修正
+- **Feat**: リクエスト前に JWT の `exp` を確認し、期限切れ/期限間近なら事前にリフレッシュするプロアクティブ・トークンリフレッシュを追加
+
 ## [0.10.0] - 2026-04-03
 
 ### 2026-04-03

src/client.ts

@@ -1,5 +1,6 @@
 import type { ClientOptions, ClientResponse, NgsiError } from "./types.js";
 import { clientCredentialsGrant } from "./oauth.js";
+import { getTokenStatus } from "./token.js";
 
 export class DryRunSignal extends Error {
   constructor() {
@@ -163,7 +164,19 @@ export class GdbClient {
   }
 
   private canRefresh(): boolean {
-    return (!!this.refreshToken || (!!this.clientId && !!this.clientSecret)) && !this.apiKey;
+    if (!this.refreshToken && !(this.clientId && this.clientSecret)) return false;
+    // When authenticating solely via apiKey (no token), token refresh is unnecessary
+    if (!this.token && this.apiKey) return false;
+    return true;
+  }
+
+  /** Proactively refresh the token before making a request if it is expired or about to expire. */
+  private async proactiveRefresh(): Promise<void> {
+    if (!this.token || !this.canRefresh()) return;
+    const status = getTokenStatus(this.token);
+    if (status.isExpired || status.isExpiringSoon) {
+      await this.performTokenRefresh();
+    }
   }
 
   /** Check whether an error indicates an authentication/token problem that may be resolved by refreshing. */
@@ -341,6 +354,7 @@ export class GdbClient {
       headers?: Record<string, string>;
     },
   ): Promise<ClientResponse<T>> {
+    await this.proactiveRefresh();
     try {
       return await this.executeRequest<T>(method, path, options);
     } catch (err) {
@@ -404,6 +418,7 @@ export class GdbClient {
       skipTenantHeader?: boolean;
     },
   ): Promise<ClientResponse<T>> {
+    await this.proactiveRefresh();
     try {
       return await this.executeRawRequest<T>(method, path, options);
     } catch (err) {