@headless-lms/adapter-db 0.2.0 → 0.4.0

package/dist/repositories/students.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"students.js","names":[],"sources":["../../src/repositories/students.ts"],"sourcesContent":["// students — Drizzle repository (implements the core outbound port).\n// A read-model over org users + entitlements: a \"student\" row in the report is\n// any org_users row with role 'student', with or without entitlements. Rooted at\n// `org_users` and scoped by its org, with entitlements LEFT JOINed in for the\n// aggregated count. Name/email come from the identity `users` row (INNER, since\n// user_id is NOT NULL); the avatar comes from the better-auth `user` table,\n// LEFT JOINed via that same identity row.\nimport { and, asc, desc, eq, ilike, or, sql, type SQL } from \"drizzle-orm\";\nimport type { NodePgDatabase } from \"drizzle-orm/node-postgres\";\nimport type {\n  Page,\n  Student,\n  StudentAnalytics,\n  StudentCourseProgress,\n  StudentsQuery,\n  StudentsReportRepository,\n} from \"@headless-lms/core/reporting/students\";\nimport { orgUsers, users, entitlements } from \"../schema/index.js\";\nimport { STUDENT_ROLE } from \"@headless-lms/core/organizations\";\nimport { user } from \"../schema/better-auth.js\";\nimport type { OrgUserStatus } from \"@headless-lms/core/types\";\nimport type { Logger } from \"@headless-lms/core/shared/ports\";\nimport { noopLogger } from \"@headless-lms/core/shared/logger\";\nimport { orgUserProfileColumns } from \"./org-user-profile.js\";\nimport { translateDbErrors } from \"./pg-errors.js\";\n\nconst entitlementCountExpr = sql<number>`count(${entitlements.id})`;\n// Completion now lives in the progress domain; the students report no longer\n// derives a percentage from entitlements. Placeholder until wired to progress.\nconst avgProgressExpr = sql<number>`0`;\n// Last learning activity: the newest touch on any of the student's progress\n// records. A scalar subquery so it neither fans out the entitlement count nor\n// widens the GROUP BY.\nconst lastActiveExpr = sql<Date | null>`(\n  select max(pr.updated_at) from progress_records pr\n  where pr.org_id = ${orgUsers.orgId} and pr.org_user_id = ${orgUsers.id}\n)`;\n\ninterface StudentRow {\n  id: string;\n  email: string;\n  image: string | null;\n  firstName: string | null;\n  lastName: string | null;\n  status: OrgUserStatus;\n  createdAt: Date;\n  entitlementCount: number;\n  avgProgress: number;\n  lastActiveAt: Date | null;\n}\n\nfunction toStudent(row: StudentRow): Student {\n  return {\n    id: row.id,\n    email: row.email,\n    image: row.image ?? null,\n    firstName: row.firstName,\n    lastName: row.lastName,\n    status: row.status,\n    entitlementCount: Number(row.entitlementCount),\n    avgProgress: Number(row.avgProgress),\n    joinedAt: row.createdAt.toISOString(),\n    lastActiveAt: row.lastActiveAt ? new Date(row.lastActiveAt).toISOString() : null,\n  };\n}\n\nexport class DrizzleStudentsRepository implements StudentsReportRepository {\n  constructor(\n    private readonly db: NodePgDatabase,\n    private readonly logger: Logger = noopLogger,\n  ) {}\n\n  async list(orgId: string, query: StudentsQuery): Promise<Page<Student>> {\n    // Staff share this table now — the role filter is what keeps them out of\n    // the students report.\n    const filters: SQL[] = [eq(orgUsers.orgId, orgId), eq(orgUsers.role, STUDENT_ROLE)];\n    const q = query.search?.trim();\n    if (q) {\n      const like = `%${q}%`;\n      filters.push(\n        or(ilike(users.firstName, like), ilike(users.lastName, like), ilike(users.email, like))!,\n      );\n    }\n    const where = and(...filters);\n\n    const [totals] = await this.db\n      .select({ total: sql<number>`count(*)` })\n      .from(orgUsers)\n      .innerJoin(users, eq(users.id, orgUsers.userId))\n      .where(where);\n\n    const rows = await this.db\n      .select({\n        ...orgUserProfileColumns,\n        status: orgUsers.status,\n        createdAt: orgUsers.createdAt,\n        entitlementCount: entitlementCountExpr,\n        avgProgress: avgProgressExpr,\n        lastActiveAt: lastActiveExpr,\n      })\n      .from(orgUsers)\n      .leftJoin(\n        entitlements,\n        and(eq(entitlements.orgId, orgUsers.orgId), eq(entitlements.orgUserId, orgUsers.id)),\n      )\n      .innerJoin(users, eq(users.id, orgUsers.userId))\n      .leftJoin(user, eq(user.id, users.externalId))\n      .where(where)\n      // Group by the full composite PK (orgId, id): grouping by id alone gives\n      // Postgres no functional dependency for the other students columns.\n      .groupBy(\n        orgUsers.orgId,\n        orgUsers.id,\n        orgUsers.status,\n        users.email,\n        users.firstName,\n        users.lastName,\n        user.image,\n      )\n      .orderBy(...this.resolveOrder(query.sort))\n      .limit(query.pageSize)\n      .offset((query.page - 1) * query.pageSize);\n\n    return {\n      rows: rows.map(toStudent),\n      total: Number(totals?.total ?? 0),\n      page: query.page,\n      pageSize: query.pageSize,\n    };\n  }\n\n  async findById(orgId: string, id: string): Promise<Student | null> {\n    const [row] = await this.db\n      .select({\n        ...orgUserProfileColumns,\n        status: orgUsers.status,\n        createdAt: orgUsers.createdAt,\n        entitlementCount: entitlementCountExpr,\n        avgProgress: avgProgressExpr,\n        lastActiveAt: lastActiveExpr,\n      })\n      .from(orgUsers)\n      .leftJoin(\n        entitlements,\n        and(eq(entitlements.orgId, orgUsers.orgId), eq(entitlements.orgUserId, orgUsers.id)),\n      )\n      .innerJoin(users, eq(users.id, orgUsers.userId))\n      .leftJoin(user, eq(user.id, users.externalId))\n      .where(and(eq(orgUsers.orgId, orgId), eq(orgUsers.id, id), eq(orgUsers.role, STUDENT_ROLE)))\n      .groupBy(\n        orgUsers.orgId,\n        orgUsers.id,\n        orgUsers.status,\n        users.email,\n        users.firstName,\n        users.lastName,\n        user.image,\n      )\n      .limit(1);\n    return row ? toStudent(row) : null;\n  }\n\n  // Learner record: one row per course the student holds an effective-active\n  // entitlement to (mirroring the course-analytics cohort rule), with progress\n  // computed over published activities the same way reporting/courses does.\n  async analytics(orgId: string, id: string): Promise<StudentAnalytics | null> {\n    const [exists] = await this.db\n      .select({ id: orgUsers.id })\n      .from(orgUsers)\n      .where(and(eq(orgUsers.orgId, orgId), eq(orgUsers.id, id), eq(orgUsers.role, STUDENT_ROLE)));\n    if (!exists) {\n      return null;\n    }\n\n    const result = await this.db.execute(sql`\n      with cohort_courses as (\n        select c.id, c.title\n        from entitlements e\n        join courses c on c.org_id = e.org_id and c.id = e.content_id\n        where e.org_id = ${orgId}\n          and e.org_user_id = ${id}\n          and e.status = 'active'\n          and (e.expires_at is null or e.expires_at >= now())\n      ),\n      acts as (\n        select a.course_id, a.id\n        from activities a\n        where a.org_id = ${orgId}\n          and a.course_id in (select id from cohort_courses)\n          and coalesce((a.settings ->> 'published')::boolean, true)\n      )\n      select\n        cc.id as course_id,\n        cc.title,\n        count(a.id)::int as total_activities,\n        count(pr.id) filter (where pr.completed_at is not null)::int as completed_activities,\n        min(pr.started_at) as started_at,\n        max(pr.updated_at) as last_activity_at,\n        (\n          select prc.completed_at from progress_records prc\n          where prc.org_id = ${orgId}\n            and prc.org_user_id = ${id}\n            and prc.target_type = 'course'\n            and prc.target_id = cc.id\n        ) as completed_at\n      from cohort_courses cc\n      left join acts a on a.course_id = cc.id\n      left join progress_records pr\n        on pr.org_id = ${orgId}\n        and pr.org_user_id = ${id}\n        and pr.target_type = 'activity'\n        and pr.target_id = a.id\n      group by cc.id, cc.title\n      order by cc.title\n    `);\n\n    const courses: StudentCourseProgress[] = (\n      result.rows as {\n        course_id: string;\n        title: string;\n        total_activities: number;\n        completed_activities: number;\n        started_at: Date | string | null;\n        last_activity_at: Date | string | null;\n        completed_at: Date | string | null;\n      }[]\n    ).map((r) => {\n      const total = Number(r.total_activities);\n      const done = Number(r.completed_activities);\n      return {\n        courseId: r.course_id,\n        title: r.title,\n        totalActivities: total,\n        completedActivities: done,\n        progress: total > 0 ? Math.round(Math.min(done / total, 1) * 100) : 0,\n        startedAt: r.started_at ? new Date(r.started_at).toISOString() : null,\n        lastActivityAt: r.last_activity_at ? new Date(r.last_activity_at).toISOString() : null,\n        completedAt: r.completed_at ? new Date(r.completed_at).toISOString() : null,\n      };\n    });\n\n    const started = courses.filter((c) => c.startedAt !== null).length;\n    const completed = courses.filter((c) => c.completedAt !== null).length;\n    const avgProgress =\n      courses.length > 0\n        ? Math.round(courses.reduce((sum, c) => sum + c.progress, 0) / courses.length)\n        : 0;\n\n    return { enrolled: courses.length, started, completed, avgProgress, courses };\n  }\n\n  private resolveOrder(sort?: string): SQL[] {\n    const descending = sort?.startsWith(\"-\") ?? false;\n    const field = sort ? (descending ? sort.slice(1) : sort) : \"firstName\";\n    const dir = descending ? desc : asc;\n    switch (field) {\n      case \"email\":\n        return [dir(users.email)];\n      case \"entitlementCount\":\n        return [dir(entitlementCountExpr)];\n      case \"avgProgress\":\n        return [dir(avgProgressExpr)];\n      case \"joinedAt\":\n        return [dir(orgUsers.createdAt)];\n      case \"lastActiveAt\":\n        return [dir(lastActiveExpr)];\n      case \"lastName\":\n        return [dir(users.lastName), dir(users.firstName)];\n      case \"firstName\":\n      default:\n        return [dir(users.firstName), dir(users.lastName)];\n    }\n  }\n}\ntranslateDbErrors(DrizzleStudentsRepository);\n"],"mappings":"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"}