blackboard-upc 1.0.0 → 1.0.1

package/CHANGELOG.md

@@ -4,6 +4,18 @@ All notable changes to `blackboard-upc` will be documented here.
 
 ---
 
+## [1.0.1] — 2026-03-30
+
+### Added
+- `courses members <courseId>` — lista compañeros e instructor de un curso (con `--role` y `--json`)
+
+### Improved
+- `courses list` — usa `expand=course` en una sola llamada en vez de 1+N (antes: 1 llamada por curso)
+- `assignments list` — usa bulk grades (`/gradebook/users/{id}`) en paralelo con columns, eliminando N llamadas individuales
+- `courses members` — usa `expand=user` para traer nombres en una sola llamada
+
+---
+
 ## [1.0.0] — 2026-03-30
 
 ### Added
@@ -53,7 +65,7 @@ All notable changes to `blackboard-upc` will be documented here.
 
 ## Roadmap
 
-- [ ] `npx` install sin clonar repo (publicación en npm)
+- [x] `npx` install sin clonar repo (publicación en npm)
 - [ ] Refresh automático de sesión antes de expirar
 - [ ] Notificaciones de entregas próximas (`assignments due`)
 - [ ] Descarga de videos de grabaciones de clase

package/package.json

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

package/src/api/courses.ts

@@ -14,20 +14,9 @@ export async function getMyCourses(
   const params: Record<string, any> = { limit: opts.limit ?? 50 };
   if (opts.offset) params.offset = opts.offset;
 
+  params.expand = 'course';
   const r = await client.get(`/learn/api/public/v1/users/${userId}/courses`, { params });
-  const memberships: UserCourse[] = r.data.results;
-
-  // Resolve course names in parallel
-  const courseDetails = await Promise.allSettled(
-    memberships.map((m) => getCourse(client, m.courseId))
-  );
-
-  const results = memberships.map((m, i) => ({
-    ...m,
-    course: courseDetails[i].status === 'fulfilled' ? courseDetails[i].value : undefined,
-  }));
-
-  return { results, paging: r.data.paging };
+  return { results: r.data.results, paging: r.data.paging };
 }
 
 export async function getCourse(client: AxiosInstance, courseId: string): Promise<Course> {

package/src/commands/assignments.ts

@@ -61,7 +61,16 @@ export function assignmentsCommand(program: Command) {
         let userId = session.userId;
         if (!userId) { const me = await getMe(client); userId = me.id; }
 
-        const columns = await listAssignments(client, courseId);
+        const [columns, gradesRes] = await Promise.all([
+          listAssignments(client, courseId),
+          client
+            .get(`/learn/api/public/v1/courses/${courseId}/gradebook/users/${userId}`, {
+              params: { limit: 200 },
+            })
+            .then((r) => r.data.results as any[])
+            .catch(() => [] as any[]),
+        ]);
+
         spinner.succeed(`${columns.length} assignments found`);
 
         if (opts.json) { console.log(JSON.stringify(columns, null, 2)); return; }
@@ -71,19 +80,11 @@ export function assignmentsCommand(program: Command) {
           return;
         }
 
-        // Fetch my grade for each assignment in parallel
-        const gradeResults = await Promise.allSettled(
-          columns.map((c) =>
-            client
-              .get(`/learn/api/public/v1/courses/${courseId}/gradebook/users/${userId}/columns/${c.id}`)
-              .then((r) => r.data)
-              .catch(() => null)
-          )
-        );
+        const gradeMap = new Map(gradesRes.map((g: any) => [g.columnId, g]));
 
         console.log('');
-        columns.forEach((col, i) => {
-          const grade = gradeResults[i].status === 'fulfilled' ? gradeResults[i].value : null;
+        columns.forEach((col) => {
+          const grade = gradeMap.get(col.id) ?? null;
           const possible = col.score?.possible ?? '?';
           const due = col.grading?.due;
           const attemptsAllowed = col.grading?.attemptsAllowed === 0

package/src/commands/courses.ts

@@ -231,6 +231,63 @@ export function coursesCommand(program: Command) {
       }
     });
 
+  // Members
+  courses
+    .command('members <courseId>')
+    .description('List students and instructors in a course')
+    .option('--json', 'Output raw JSON')
+    .option('--role <role>', 'Filter by role: Student, Instructor')
+    .action(async (courseId, opts) => {
+      const session = requireSession();
+      const client = createClient(session);
+      const spinner = ora({ text: 'Fetching course members...', stream: process.stderr }).start();
+
+      try {
+        const res = await client.get(
+          `/learn/api/public/v1/courses/${courseId}/users?expand=user&limit=200`
+        );
+        let members: any[] = res.data.results ?? [];
+
+        if (opts.role) {
+          const roleFilter = opts.role.toLowerCase();
+          members = members.filter((m: any) => m.courseRoleId?.toLowerCase() === roleFilter);
+        }
+
+        spinner.succeed(`${members.length} members`);
+
+        if (opts.json) {
+          console.log(JSON.stringify({ results: members }, null, 2));
+          return;
+        }
+
+        const students = members.filter((m: any) => m.courseRoleId === 'Student');
+        const instructors = members.filter((m: any) => m.courseRoleId !== 'Student');
+
+        console.log('');
+        if (instructors.length > 0) {
+          console.log(chalk.bold('  Instructores'));
+          for (const m of instructors) {
+            const name = m.user ? `${m.user.name.given} ${m.user.name.family}` : m.userId;
+            console.log(`  ${chalk.yellow(name)}`);
+          }
+          console.log('');
+        }
+
+        if (students.length > 0) {
+          console.log(chalk.bold(`  Estudiantes (${students.length})`));
+          students.forEach((m: any, i: number) => {
+            const name = m.user ? `${m.user.name.given} ${m.user.name.family}` : m.userId;
+            const num = chalk.gray(`${String(i + 1).padStart(2, ' ')}.`);
+            console.log(`  ${num} ${name}`);
+          });
+        }
+        console.log('');
+      } catch (err: any) {
+        spinner.fail(err.message);
+        process.exit(1);
+      }
+    });
+
   // Grades
   courses
     .command('grades <courseId>')