blackboard-upc 1.0.9 → 1.0.10

package/CHANGELOG.md

@@ -4,6 +4,22 @@ All notable changes to `blackboard-upc` will be documented here.
 
 ---
 
+## [1.0.10] — 2026-04-24
+
+### Added
+- **TTL real del SSO en `whoami`, `status` y `login`** — ahora se muestran las dos ventanas: la del token de Blackboard (~3h, se auto-renueva) y la del SSO de Microsoft (~90 días, la ventana real hasta que hay que re-loguearse). Ejemplo:
+  ```
+  SSO Microsoft: 89 días · Blackboard: 173 min
+  se auto-renueva hasta que el SSO expire o hagas logout
+  ```
+- `getSsoExpiry()` helper en `src/auth/login.ts` — lee el expiry de `ESTSAUTHPERSISTENT` (la cookie de Microsoft que controla la persistencia del SSO) desde la sesión guardada, sin llamadas de red
+- `formatSessionLifetime()` helper en `src/ui/theme.ts` — centraliza el formato de las dos líneas (resumen + nota) y maneja el caso donde el SSO es session-only
+
+### Changed
+- `blackboard login` ya no muestra "expira en 3h" (engañoso, porque se auto-renueva); muestra la misma info que `whoami`/`status`
+
+---
+
 ## [1.0.9] — 2026-04-24
 
 ### Fixed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "blackboard-upc",
-  "version": "1.0.9",
+  "version": "1.0.10",
   "description": "CLI no oficial para UPC Aula Virtual (Blackboard Learn) — acceso desde la terminal y MCP para Claude",
   "main": "run.js",
   "bin": {

package/src/auth/login.ts

@@ -57,6 +57,27 @@ export function resolveDisplayName(userData: any): string | undefined {
   return userData.studentId || undefined;
 }
 
+// Microsoft SSO persistence is controlled specifically by ESTSAUTHPERSIST
+// (set when the user accepts "Keep me signed in"). Other cookies on
+// login.microsoftonline.com like MUID/fpc are tracking and persist ~1 year
+// but don't keep the user signed in — ignore them.
+const SSO_COOKIE_NAMES = new Set(['ESTSAUTHPERSISTENT', 'ESTSAUTHLIGHT', 'ESTSAUTH']);
+
+export function getSsoExpiry(cookies: Cookie[]): number | undefined {
+  const ssoCookies = cookies.filter(c =>
+    SSO_COOKIE_NAMES.has(c.name) &&
+    (c.domain.includes('login.microsoftonline.com') || c.domain.includes('login.live.com'))
+  );
+  const now = Date.now();
+  const future = ssoCookies
+    .map(c => c.expires)
+    .filter((e): e is number => typeof e === 'number' && e > 0)
+    .map(e => e * 1000)
+    .filter(ms => ms > now);
+  if (future.length === 0) return undefined;
+  return Math.max(...future);
+}
+
 function extractXsrf(cookies: Cookie[]): string {
   const bb = cookies.find(c => c.name === 'BbRouter');
   if (bb) {

package/src/commands/login.ts

@@ -2,11 +2,11 @@ import { Command } from 'commander';
 import inquirer from 'inquirer';
 import chalk from 'chalk';
 import ora from 'ora';
-import { login, resolveDisplayName } from '../auth/login.js';
+import { login, resolveDisplayName, getSsoExpiry } from '../auth/login.js';
 import { loadSession, loadOrRefreshSession, saveSession, clearSession, isSessionValid } from '../auth/session.js';
 import { createClient } from '../api/client.js';
 import { getMe } from '../api/courses.js';
-import { ok, fail, warn, whatNext } from '../ui/theme.js';
+import { ok, fail, warn, whatNext, formatSessionLifetime } from '../ui/theme.js';
 
 export function loginCommand(program: Command) {
   program
@@ -36,9 +36,11 @@ export function loginCommand(program: Command) {
           password: opts.password,
         });
 
-        const remainingMin = Math.round((session.expiresAt - Date.now()) / 60_000);
-        const remainingHr  = (remainingMin / 60).toFixed(1);
-        console.log(ok(`Sesión guardada — expira en ${remainingHr}h`));
+        const ssoExpiresAt = getSsoExpiry(session.cookies);
+        const { summary, note } = formatSessionLifetime(session.expiresAt, ssoExpiresAt);
+        console.log(ok(`Sesión guardada`));
+        console.log(chalk.gray(`  ${summary}`));
+        console.log(chalk.gray(`  ${note}`));
         if (session.userName) console.log(chalk.gray(`  Usuario: ${session.userName}`));
         if (session.userId)   console.log(chalk.gray(`  ID:      ${session.userId}`));
         whatNext();
@@ -85,7 +87,9 @@ export function loginCommand(program: Command) {
       }
 
       console.log(chalk.green(`Logged in as: ${chalk.bold(session!.userName || session!.userId || 'unknown')}`));
-      const remaining = Math.round((session!.expiresAt - Date.now()) / 60_000);
-      console.log(chalk.gray(`Session expires in: ${remaining} minutes`));
+      const ssoExpiresAt = getSsoExpiry(session!.cookies);
+      const { summary, note } = formatSessionLifetime(session!.expiresAt, ssoExpiresAt);
+      console.log(chalk.gray(summary));
+      console.log(chalk.gray(note));
     });
 }

package/src/index.ts

@@ -9,15 +9,15 @@ import { assignmentsCommand } from './commands/assignments.js';
 import { loadSession, loadOrRefreshSession, saveSession, isSessionValid } from './auth/session.js';
 import { createClient } from './api/client.js';
 import { getMe, getSystemVersion } from './api/courses.js';
-import { resolveDisplayName } from './auth/login.js';
-import { BANNER, ok, fail, hint } from './ui/theme.js';
+import { resolveDisplayName, getSsoExpiry } from './auth/login.js';
+import { BANNER, ok, fail, hint, formatSessionLifetime } from './ui/theme.js';
 
 const program = new Command();
 
 program
   .name('blackboard')
   .description('CLI no oficial para UPC Aula Virtual (Blackboard Learn)')
-  .version('1.0.9')
+  .version('1.0.10')
   .addHelpText('beforeAll', BANNER);
 
 // Auth commands
@@ -50,10 +50,13 @@ program
       } catch {}
     }
 
+    const ssoExpiresAt = valid ? getSsoExpiry(session!.cookies) : undefined;
+
     const result = {
       loggedIn: valid,
       user: valid ? { id: session!.userId, name: session!.userName } : null,
       sessionExpiresAt: valid ? new Date(session!.expiresAt).toISOString() : null,
+      ssoExpiresAt: ssoExpiresAt ? new Date(ssoExpiresAt).toISOString() : null,
       server: sysVersion?.learn ?? null,
     };
 
@@ -62,9 +65,10 @@ program
     const v = sysVersion?.learn;
     console.log(`\n  Servidor: ${chalk.cyan(`Blackboard Learn ${v?.major}.${v?.minor}.${v?.patch} (${v?.build})`)}`);
     if (valid) {
-      const remaining = Math.round((session!.expiresAt - Date.now()) / 60_000);
+      const { summary, note } = formatSessionLifetime(session!.expiresAt, ssoExpiresAt);
       console.log(`  Sesión:   ${ok(`autenticado como ${chalk.bold(session!.userName || session!.userId || 'unknown')}`)}`);
-      console.log(`            ${chalk.gray(`expira en ${remaining} min`)}`);
+      console.log(`            ${chalk.gray(summary)}`);
+      console.log(`            ${chalk.gray(note)}`);
     } else {
       console.log(`  Sesión:   ${fail('no autenticado')} — ejecuta: ${hint('blackboard login')}`);
     }

package/src/ui/theme.ts

@@ -21,6 +21,32 @@ ${upcRed('  ██████  ███████ ██   ██  ███
   ${chalk.dim('CLI no oficial para UPC Aula Virtual · Blackboard Learn')}
 `;
 
+export function formatSessionLifetime(bbExpiresAt: number, ssoExpiresAt?: number): {
+  summary: string;
+  note: string;
+} {
+  const now = Date.now();
+  const bbMin = Math.max(0, Math.round((bbExpiresAt - now) / 60_000));
+
+  if (!ssoExpiresAt || ssoExpiresAt <= now) {
+    return {
+      summary: `Blackboard: ${bbMin} min`,
+      note: 'SSO sin "mantener sesión" — deberás reloguearte cuando expire',
+    };
+  }
+
+  const ssoMs = ssoExpiresAt - now;
+  const ssoDays = Math.floor(ssoMs / 86_400_000);
+  const ssoStr = ssoDays >= 1
+    ? `${ssoDays} día${ssoDays === 1 ? '' : 's'}`
+    : `${Math.round(ssoMs / 3_600_000)} h`;
+
+  return {
+    summary: `SSO Microsoft: ${ssoStr} · Blackboard: ${bbMin} min`,
+    note: 'se auto-renueva hasta que el SSO expire o hagas logout',
+  };
+}
+
 export function whatNext() {
   console.log(`
   ${chalk.bold('¿Qué puedo hacer ahora?')}