pleumrouter 0.5.24 → 0.5.25

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pleumrouter",
-  "version": "0.5.24",
+  "version": "0.5.25",
   "description": "Official PleumRouter terminal CLI — launch any coding agent against PleumRouter.",
   "type": "module",
   "bin": {

package/src/config.mjs

@@ -62,15 +62,9 @@ export function clearCredentials(existing) {
 }
 
 /**
- * 사용 가능한 세션 보유 여부. 레거시 `key`(plm_)만 있는 상태는 requireAuth()가 거부하므로
- * (아래 requireAuth 참조) 미로그인으로 취급한다 — 그래야 런처가 자동으로 재로그인을 태운다.
+ * JWT payload 파싱(서명 검증 없는 디코드) — iat, exp 등의 클레임 추출용.
  */
-export function isLoggedIn(cfg = readConfig()) {
-  return Boolean(cfg?.access_token);
-}
-
-/** JWT payload `exp`(epoch sec) — 서명 검증 없이 refresh 트리거 힌트. */
-export function readJwtExp(token) {
+export function readJwtPayload(token) {
   if (typeof token !== "string") return null;
   const parts = token.split(".");
   const segment = parts[1];
@@ -80,14 +74,32 @@ export function readJwtExp(token) {
     const pad = b64.length % 4;
     if (pad) b64 += "=".repeat(4 - pad);
     const json = Buffer.from(b64, "base64").toString("utf8");
-    const payload = JSON.parse(json);
-    return typeof payload.exp === "number" ? payload.exp : null;
+    return JSON.parse(json);
   } catch {
     return null;
   }
 }
 
-/** access가 곧 만료(기본 60s 여유)면 true. */
+/** JWT payload `exp`(epoch sec) */
+export function readJwtExp(token) {
+  const payload = readJwtPayload(token);
+  return typeof payload?.exp === "number" ? payload.exp : null;
+}
+
+/** JWT payload `iat`(epoch sec) */
+export function readJwtIat(token) {
+  const payload = readJwtPayload(token);
+  return typeof payload?.iat === "number" ? payload.iat : null;
+}
+
+/** 토큰 만료 여부 판정 (skewSeconds 여유 포함, unparseable은 false 반환) */
+export function isTokenExpired(token, skewSeconds = 0) {
+  const exp = readJwtExp(token);
+  if (exp == null) return false;
+  return exp * 1000 <= Date.now() + skewSeconds * 1000;
+}
+
+/** access가 곧 만료(기본 60s 여유)면 true. unparseable은 만료로 간주. */
 export function accessTokenIsStale(accessToken, skewSeconds = 60) {
   const exp = readJwtExp(accessToken);
   if (exp == null) return true;
@@ -95,29 +107,59 @@ export function accessTokenIsStale(accessToken, skewSeconds = 60) {
 }
 
 /**
- * 유효한 access_token을 반환. stale이면 refresh. 레거시 `key`(plm_)만 있으면 재로그인 안내.
+ * 사용 가능한 세션 보유 여부.
+ * 1) access_token 또는 refresh_token이 없으면 미로그인.
+ * 2) refresh_token이 이미 7일 만료되었으면 미로그인.
+ * 3) 레거시 `key`(plm_)만 있는 상태는 requireAuth()가 거부하므로 미로그인.
+ */
+export function isLoggedIn(cfg = readConfig()) {
+  if (!cfg?.access_token || !cfg?.refresh_token) return false;
+  if (isTokenExpired(cfg.refresh_token)) return false;
+  return true;
+}
+
+/**
+ * 7일 슬라이딩 세션 갱신 (1시간 스로틀링).
+ * CLI 접속 시 마지막 갱신(iat)으로부터 minIntervalSeconds(기본 3600초=1시간) 이상 지났거나
+ * access_token이 곧 만료(stale)되면 /v1/auth/refresh를 호출해 만료일을 현재+7일로 연장한다.
+ */
+export async function touchSession(cfg = readConfig(), { minIntervalSeconds = 3600 } = {}) {
+  if (!isLoggedIn(cfg)) return null;
+  const iat = readJwtIat(cfg.refresh_token) ?? readJwtIat(cfg.access_token);
+  const ageSeconds = iat ? Math.max(0, Math.floor(Date.now() / 1000 - iat)) : Infinity;
+  const isStale = accessTokenIsStale(cfg.access_token, 300);
+  if (!isStale && ageSeconds < minIntervalSeconds) {
+    return cfg.access_token;
+  }
+  return await refreshAccessToken(cfg);
+}
+
+/**
+ * 유효한 access_token을 반환. stale이거나 1시간 경과 시 refresh하여 슬라이딩 윈도우 유지.
+ * 레거시 `key`(plm_)만 있으면 재로그인 안내.
  */
 export async function requireAuth() {
-  const cfg = readConfig();
+  let cfg = readConfig();
   if (cfg?.key && !cfg?.access_token) {
     console.error(
       t("Legacy API key login is no longer supported. Run:\n  pleum login"),
     );
     process.exit(1);
   }
-  if (!cfg?.access_token || !cfg?.refresh_token) {
+  if (!isLoggedIn(cfg)) {
     console.error(t("Login required. Run this first:\n  pleum login"));
     process.exit(1);
   }
-  if (!accessTokenIsStale(cfg.access_token)) {
+  const token = await touchSession(cfg);
+  if (token) return token;
+
+  cfg = readConfig();
+  if (cfg?.access_token && !accessTokenIsStale(cfg.access_token, 0)) {
     return cfg.access_token;
   }
-  const refreshed = await refreshAccessToken(cfg);
-  if (!refreshed) {
-    console.error(t("Session expired. Run:\n  pleum login"));
-    process.exit(1);
-  }
-  return refreshed;
+
+  console.error(t("Session expired. Run:\n  pleum login"));
+  process.exit(1);
 }
 
 export async function refreshAccessToken(cfg = readConfig()) {
@@ -129,7 +171,12 @@ export async function refreshAccessToken(cfg = readConfig()) {
       headers: { "Content-Type": "application/json" },
       body: JSON.stringify({ refresh_token: cfg.refresh_token }),
     });
-    if (!res.ok) return null;
+    if (!res.ok) {
+      if (res.status === 401 || res.status === 403) {
+        writeConfig(clearCredentials(cfg));
+      }
+      return null;
+    }
     const data = await res.json();
     if (!data.access_token || !data.refresh_token) return null;
     const exp = readJwtExp(data.access_token);

package/src/health.mjs

@@ -1,7 +1,7 @@
 // `pleum health` — 게이트웨이 연결성 + 로그인 상태 한눈에.
 // 셀프호스트/스테이징(PLEUM_BASE_URL) 점검·고객지원 트리아지용. 공개 /v1/health 재사용.
 
-import { ROOT, V1, readConfig } from "./config.mjs";
+import { ROOT, V1, readConfig, isLoggedIn } from "./config.mjs";
 import { style, divider } from "./ansi.mjs";
 import { t } from "./i18n.mjs";
 
@@ -39,7 +39,7 @@ export function renderHealth({ root, health, error, ms, keyPrefix }, styler = st
 
 export async function health() {
   const cfg = readConfig();
-  const keyPrefix = cfg?.access_token
+  const keyPrefix = isLoggedIn(cfg)
     ? "oauth"
     : cfg?.key
       ? cfg.key.slice(0, 8)

package/src/menu.mjs

@@ -13,7 +13,7 @@ import { spawn } from "node:child_process";
 import { createInterface } from "node:readline";
 import { style, displayWidth, terminalWidth, hyperlink, sanitizeTerminalText } from "./ansi.mjs";
 import { keyFeeder, select } from "./interactive.mjs";
-import { readConfig, writeConfig, isLoggedIn } from "./config.mjs";
+import { readConfig, writeConfig, isLoggedIn, touchSession } from "./config.mjs";
 import { RECIPES, MANUAL } from "./recipes.mjs";
 import { onPath, launch } from "./launch.mjs";
 import { fetchModels, matchModels, listModels, formatModelLabel } from "./models.mjs";
@@ -303,6 +303,7 @@ export async function mainMenu() {
   // login()의 실패(취소·2분 타임아웃·state 불일치)는 그대로 던져 bin/pleum.mjs의
   // 최상위 catch가 `✗ <메시지>` + exit 1로 처리하게 둔다(메뉴를 띄우지 않는다).
   if (!isLoggedIn()) await login();
+  else await touchSession().catch(() => {});
 
   for (;;) {
     const picked = await menuSelect();