@headless-lms/adapter-db 0.2.0 → 0.3.0

package/drizzle/meta/_journal.json

@@ -22,6 +22,62 @@
       "when": 1790675689629,
       "tag": "0002_automation_kinds",
       "breakpoints": true
+    },
+    {
+      "idx": 3,
+      "version": "7",
+      "when": 1792574273608,
+      "tag": "0003_community",
+      "breakpoints": true
+    },
+    {
+      "idx": 4,
+      "version": "7",
+      "when": 1792652068527,
+      "tag": "0004_assets_sources",
+      "breakpoints": true
+    },
+    {
+      "idx": 5,
+      "version": "7",
+      "when": 1792654657973,
+      "tag": "0005_notices_and_seed_index",
+      "breakpoints": true
+    },
+    {
+      "idx": 6,
+      "version": "7",
+      "when": 1792664309207,
+      "tag": "0006_community_review_fixes",
+      "breakpoints": true
+    },
+    {
+      "idx": 7,
+      "version": "7",
+      "when": 1793025210130,
+      "tag": "0007_notifications",
+      "breakpoints": true
+    },
+    {
+      "idx": 8,
+      "version": "7",
+      "when": 1793267692172,
+      "tag": "0008_content_access",
+      "breakpoints": true
+    },
+    {
+      "idx": 9,
+      "version": "7",
+      "when": 1793271619441,
+      "tag": "0009_community_indexes",
+      "breakpoints": true
+    },
+    {
+      "idx": 10,
+      "version": "7",
+      "when": 1793328918383,
+      "tag": "0010_mcp_access",
+      "breakpoints": true
     }
   ]
-}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@headless-lms/adapter-db",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -21,7 +21,7 @@
   "dependencies": {
     "drizzle-orm": "^0.45.2",
     "pg": "^8.13.1",
-    "@headless-lms/core": "0.2.0"
+    "@headless-lms/core": "0.3.0"
   },
   "devDependencies": {
     "@types/node": "^22.10.2",

package/dist/repositories/course-analytics.d.ts

@@ -1,15 +0,0 @@
-import { NodePgDatabase } from "drizzle-orm/node-postgres";
-import { Logger } from "@headless-lms/core/shared/ports";
-import { CourseAnalytics, CourseEnrollmentPoint, CoursesReportRepository } from "@headless-lms/core/reporting/courses";
-//#region src/repositories/course-analytics.d.ts
-declare class DrizzleCourseAnalyticsRepository implements CoursesReportRepository {
-  private readonly db;
-  private readonly logger;
-  constructor(db: NodePgDatabase, logger?: Logger);
-  private courseExists;
-  analytics(orgId: string, courseId: string): Promise<CourseAnalytics | null>;
-  enrollments(orgId: string, courseId: string, days: number): Promise<CourseEnrollmentPoint[] | null>;
-}
-//#endregion
-export { DrizzleCourseAnalyticsRepository };
-//# sourceMappingURL=course-analytics.d.ts.map

package/dist/repositories/course-analytics.js

@@ -1,137 +0,0 @@
-import { courses } from "../schema/content.js";
-import { entitlements } from "../schema/entitlements.js";
-import "../schema/index.js";
-import { translateDbErrors } from "./pg-errors.js";
-import { and, eq, sql } from "drizzle-orm";
-import { noopLogger } from "@headless-lms/core/shared/logger";
-//#region src/repositories/course-analytics.ts
-var DrizzleCourseAnalyticsRepository = class {
-	db;
-	logger;
-	constructor(db, logger = noopLogger) {
-		this.db = db;
-		this.logger = logger;
-	}
-	async courseExists(orgId, courseId) {
-		const [row] = await this.db.select({ id: courses.id }).from(courses).where(and(eq(courses.orgId, orgId), eq(courses.id, courseId)));
-		return row !== void 0;
-	}
-	async analytics(orgId, courseId) {
-		if (!await this.courseExists(orgId, courseId)) return null;
-		const cohort = sql`
-      select org_user_id from entitlements
-      where org_id = ${orgId}
-        and content_id = ${courseId}
-        and status = 'active'
-        and (expires_at is null or expires_at >= now())
-    `;
-		const publishedActivities = sql`
-      select a.id, a.settings, a.seq, a.module_id
-      from activities a
-      where a.org_id = ${orgId}
-        and a.course_id = ${courseId}
-        and coalesce((a.settings ->> 'published')::boolean, true)
-    `;
-		const summary = (await this.db.execute(sql`
-      with cohort as (${cohort}),
-      acts as (${publishedActivities}),
-      per_learner as (
-        select c.org_user_id,
-          count(pr.id) filter (where pr.completed_at is not null) as done
-        from cohort c
-        left join progress_records pr
-          on pr.org_id = ${orgId}
-          and pr.org_user_id = c.org_user_id
-          and pr.target_type = 'activity'
-          and pr.target_id in (select id from acts)
-        group by c.org_user_id
-      )
-      select
-        (select count(*) from cohort)::int as enrolled,
-        (
-          select count(distinct pr.org_user_id) from progress_records pr
-          where pr.org_id = ${orgId}
-            and pr.org_user_id in (select org_user_id from cohort)
-            and (
-              (pr.target_type = 'activity' and pr.target_id in (select id from acts))
-              or (pr.target_type = 'course' and pr.target_id = ${courseId})
-            )
-        )::int as started,
-        (
-          select count(*) from progress_records pr
-          where pr.org_id = ${orgId}
-            and pr.org_user_id in (select org_user_id from cohort)
-            and pr.target_type = 'course'
-            and pr.target_id = ${courseId}
-            and pr.completed_at is not null
-        )::int as completed,
-        coalesce((
-          select round(avg(least(done::numeric / nullif((select count(*) from acts), 0), 1) * 100))
-          from per_learner
-        ), 0)::int as avg_progress
-    `)).rows[0];
-		const activities = (await this.db.execute(sql`
-      with cohort as (${cohort})
-      select
-        a.id,
-        coalesce(a.settings ->> 'title', '') as title,
-        m.id as module_id,
-        m.title as module_title,
-        count(pr.id)::int as started,
-        count(pr.id) filter (where pr.completed_at is not null)::int as completed
-      from activities a
-      join modules m on m.org_id = a.org_id and m.id = a.module_id
-      left join progress_records pr
-        on pr.org_id = ${orgId}
-        and pr.target_type = 'activity'
-        and pr.target_id = a.id
-        and pr.org_user_id in (select org_user_id from cohort)
-      where a.org_id = ${orgId}
-        and a.course_id = ${courseId}
-        and coalesce((a.settings ->> 'published')::boolean, true)
-      group by a.id, a.settings, m.id, m.title, m.seq, a.seq
-      order by m.seq, a.seq
-    `)).rows.map((r) => ({
-			activityId: r.id,
-			title: r.title,
-			moduleId: r.module_id,
-			moduleTitle: r.module_title,
-			started: Number(r.started),
-			completed: Number(r.completed)
-		}));
-		return {
-			enrolled: Number(summary?.enrolled ?? 0),
-			started: Number(summary?.started ?? 0),
-			completed: Number(summary?.completed ?? 0),
-			avgProgress: Number(summary?.avg_progress ?? 0),
-			activities
-		};
-	}
-	async enrollments(orgId, courseId, days) {
-		if (!await this.courseExists(orgId, courseId)) return null;
-		return (await this.db.execute(sql`
-      select
-        to_char(d.day, 'YYYY-MM-DD') as date,
-        count(${entitlements.id})::int as count
-      from generate_series(
-        (now() at time zone 'utc')::date - (${days} - 1),
-        (now() at time zone 'utc')::date,
-        interval '1 day'
-      ) as d(day)
-      left join ${entitlements}
-        on ${entitlements.orgId} = ${orgId}
-        and ${entitlements.contentId} = ${courseId}
-        and (${entitlements.grantedAt} at time zone 'utc')::date = d.day::date
-      group by d.day
-      order by d.day
-    `)).rows.map((r) => ({
-			date: r.date,
-			count: Number(r.count)
-		}));
-	}
-};
-translateDbErrors(DrizzleCourseAnalyticsRepository);
-//#endregion
-export { DrizzleCourseAnalyticsRepository };
-
-//# sourceMappingURL=course-analytics.js.map

package/dist/repositories/course-analytics.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"course-analytics.js","names":[],"sources":["../../src/repositories/course-analytics.ts"],"sourcesContent":["// reporting/courses — Drizzle repository (implements the core outbound port).\n// Per-course engagement figures. The cohort is every org user holding an\n// effective-active entitlement to the course (status='active' and not expired);\n// completions by revoked/expired students are deliberately excluded so the\n// numbers describe the current roster. An activity counts toward the\n// denominator when its settings blob does not say published=false (missing ⇒\n// published), mirroring reporting/learn.\nimport { and, eq, sql } from \"drizzle-orm\";\nimport type { NodePgDatabase } from \"drizzle-orm/node-postgres\";\nimport type {\n  CourseAnalytics,\n  CourseActivityEngagement,\n  CourseEnrollmentPoint,\n  CoursesReportRepository,\n} from \"@headless-lms/core/reporting/courses\";\nimport { courses, entitlements } from \"../schema/index.js\";\nimport type { Logger } from \"@headless-lms/core/shared/ports\";\nimport { noopLogger } from \"@headless-lms/core/shared/logger\";\nimport { translateDbErrors } from \"./pg-errors.js\";\n\nexport class DrizzleCourseAnalyticsRepository implements CoursesReportRepository {\n  constructor(\n    private readonly db: NodePgDatabase,\n    private readonly logger: Logger = noopLogger,\n  ) {}\n\n  private async courseExists(orgId: string, courseId: string): Promise<boolean> {\n    const [row] = await this.db\n      .select({ id: courses.id })\n      .from(courses)\n      .where(and(eq(courses.orgId, orgId), eq(courses.id, courseId)));\n    return row !== undefined;\n  }\n\n  async analytics(orgId: string, courseId: string): Promise<CourseAnalytics | null> {\n    if (!(await this.courseExists(orgId, courseId))) {\n      return null;\n    }\n\n    const cohort = sql`\n      select org_user_id from entitlements\n      where org_id = ${orgId}\n        and content_id = ${courseId}\n        and status = 'active'\n        and (expires_at is null or expires_at >= now())\n    `;\n    const publishedActivities = sql`\n      select a.id, a.settings, a.seq, a.module_id\n      from activities a\n      where a.org_id = ${orgId}\n        and a.course_id = ${courseId}\n        and coalesce((a.settings ->> 'published')::boolean, true)\n    `;\n\n    const summaryResult = await this.db.execute(sql`\n      with cohort as (${cohort}),\n      acts as (${publishedActivities}),\n      per_learner as (\n        select c.org_user_id,\n          count(pr.id) filter (where pr.completed_at is not null) as done\n        from cohort c\n        left join progress_records pr\n          on pr.org_id = ${orgId}\n          and pr.org_user_id = c.org_user_id\n          and pr.target_type = 'activity'\n          and pr.target_id in (select id from acts)\n        group by c.org_user_id\n      )\n      select\n        (select count(*) from cohort)::int as enrolled,\n        (\n          select count(distinct pr.org_user_id) from progress_records pr\n          where pr.org_id = ${orgId}\n            and pr.org_user_id in (select org_user_id from cohort)\n            and (\n              (pr.target_type = 'activity' and pr.target_id in (select id from acts))\n              or (pr.target_type = 'course' and pr.target_id = ${courseId})\n            )\n        )::int as started,\n        (\n          select count(*) from progress_records pr\n          where pr.org_id = ${orgId}\n            and pr.org_user_id in (select org_user_id from cohort)\n            and pr.target_type = 'course'\n            and pr.target_id = ${courseId}\n            and pr.completed_at is not null\n        )::int as completed,\n        coalesce((\n          select round(avg(least(done::numeric / nullif((select count(*) from acts), 0), 1) * 100))\n          from per_learner\n        ), 0)::int as avg_progress\n    `);\n    const summary = summaryResult.rows[0] as {\n      enrolled: number;\n      started: number;\n      completed: number;\n      avg_progress: number;\n    };\n\n    const funnelResult = await this.db.execute(sql`\n      with cohort as (${cohort})\n      select\n        a.id,\n        coalesce(a.settings ->> 'title', '') as title,\n        m.id as module_id,\n        m.title as module_title,\n        count(pr.id)::int as started,\n        count(pr.id) filter (where pr.completed_at is not null)::int as completed\n      from activities a\n      join modules m on m.org_id = a.org_id and m.id = a.module_id\n      left join progress_records pr\n        on pr.org_id = ${orgId}\n        and pr.target_type = 'activity'\n        and pr.target_id = a.id\n        and pr.org_user_id in (select org_user_id from cohort)\n      where a.org_id = ${orgId}\n        and a.course_id = ${courseId}\n        and coalesce((a.settings ->> 'published')::boolean, true)\n      group by a.id, a.settings, m.id, m.title, m.seq, a.seq\n      order by m.seq, a.seq\n    `);\n    const activities: CourseActivityEngagement[] = (\n      funnelResult.rows as {\n        id: string;\n        title: string;\n        module_id: string;\n        module_title: string;\n        started: number;\n        completed: number;\n      }[]\n    ).map((r) => ({\n      activityId: r.id,\n      title: r.title,\n      moduleId: r.module_id,\n      moduleTitle: r.module_title,\n      started: Number(r.started),\n      completed: Number(r.completed),\n    }));\n\n    return {\n      enrolled: Number(summary?.enrolled ?? 0),\n      started: Number(summary?.started ?? 0),\n      completed: Number(summary?.completed ?? 0),\n      avgProgress: Number(summary?.avg_progress ?? 0),\n      activities,\n    };\n  }\n\n  // Grants per day for this course over the trailing window, zero-filled so the\n  // series has one point per calendar day (UTC) even when nothing was granted.\n  async enrollments(\n    orgId: string,\n    courseId: string,\n    days: number,\n  ): Promise<CourseEnrollmentPoint[] | null> {\n    if (!(await this.courseExists(orgId, courseId))) {\n      return null;\n    }\n    const result = await this.db.execute(sql`\n      select\n        to_char(d.day, 'YYYY-MM-DD') as date,\n        count(${entitlements.id})::int as count\n      from generate_series(\n        (now() at time zone 'utc')::date - (${days} - 1),\n        (now() at time zone 'utc')::date,\n        interval '1 day'\n      ) as d(day)\n      left join ${entitlements}\n        on ${entitlements.orgId} = ${orgId}\n        and ${entitlements.contentId} = ${courseId}\n        and (${entitlements.grantedAt} at time zone 'utc')::date = d.day::date\n      group by d.day\n      order by d.day\n    `);\n    const rows = result.rows as { date: string; count: number }[];\n    return rows.map((r) => ({ date: r.date, count: Number(r.count) }));\n  }\n}\ntranslateDbErrors(DrizzleCourseAnalyticsRepository);\n"],"mappings":";;;;;;;AAoBA,IAAa,mCAAb,MAAiF;CAE5D;CACA;CAFnB,YACE,IACA,SAAkC,YAClC;EAFiB,KAAA,KAAA;EACA,KAAA,SAAA;CAChB;CAEH,MAAc,aAAa,OAAe,UAAoC;EAC5E,MAAM,CAAC,OAAO,MAAM,KAAK,GACtB,OAAO,EAAE,IAAI,QAAQ,GAAG,CAAC,CAAC,CAC1B,KAAK,OAAO,CAAC,CACb,MAAM,IAAI,GAAG,QAAQ,OAAO,KAAK,GAAG,GAAG,QAAQ,IAAI,QAAQ,CAAC,CAAC;EAChE,OAAO,QAAQ,KAAA;CACjB;CAEA,MAAM,UAAU,OAAe,UAAmD;EAChF,IAAI,CAAE,MAAM,KAAK,aAAa,OAAO,QAAQ,GAC3C,OAAO;EAGT,MAAM,SAAS,GAAG;;uBAEC,MAAM;2BACF,SAAS;;;;EAIhC,MAAM,sBAAsB,GAAG;;;yBAGV,MAAM;4BACH,SAAS;;;EA0CjC,MAAM,WAAU,MAtCY,KAAK,GAAG,QAAQ,GAAG;wBAC3B,OAAO;iBACd,oBAAoB;;;;;;2BAMV,MAAM;;;;;;;;;;8BAUH,MAAM;;;;iEAI6B,SAAS;;;;;8BAK5C,MAAM;;;iCAGH,SAAS;;;;;;;KAOrC,EAAA,CAC6B,KAAK;EA6BnC,MAAM,cACJ,MAvByB,KAAK,GAAG,QAAQ,GAAG;wBAC1B,OAAO;;;;;;;;;;;yBAWN,MAAM;;;;yBAIN,MAAM;4BACH,SAAS;;;;KAIhC,EAAA,CAEc,KAQb,KAAK,OAAO;GACZ,YAAY,EAAE;GACd,OAAO,EAAE;GACT,UAAU,EAAE;GACZ,aAAa,EAAE;GACf,SAAS,OAAO,EAAE,OAAO;GACzB,WAAW,OAAO,EAAE,SAAS;EAC/B,EAAE;EAEF,OAAO;GACL,UAAU,OAAO,SAAS,YAAY,CAAC;GACvC,SAAS,OAAO,SAAS,WAAW,CAAC;GACrC,WAAW,OAAO,SAAS,aAAa,CAAC;GACzC,aAAa,OAAO,SAAS,gBAAgB,CAAC;GAC9C;EACF;CACF;CAIA,MAAM,YACJ,OACA,UACA,MACyC;EACzC,IAAI,CAAE,MAAM,KAAK,aAAa,OAAO,QAAQ,GAC3C,OAAO;EAmBT,QADa,MAhBQ,KAAK,GAAG,QAAQ,GAAG;;;gBAG5B,aAAa,GAAG;;8CAEc,KAAK;;;;kBAIjC,aAAa;aAClB,aAAa,MAAM,KAAK,MAAM;cAC7B,aAAa,UAAU,KAAK,SAAS;eACpC,aAAa,UAAU;;;KAGjC,EAAA,CACmB,KACR,KAAK,OAAO;GAAE,MAAM,EAAE;GAAM,OAAO,OAAO,EAAE,KAAK;EAAE,EAAE;CACnE;AACF;AACA,kBAAkB,gCAAgC"}

package/dist/repositories/dashboard.d.ts

@@ -1,14 +0,0 @@
-import { NodePgDatabase } from "drizzle-orm/node-postgres";
-import { Logger } from "@headless-lms/core/shared/ports";
-import { DashboardReportRepository, EnrollmentPoint, OverviewStats } from "@headless-lms/core/reporting/dashboard";
-//#region src/repositories/dashboard.d.ts
-declare class DrizzleDashboardRepository implements DashboardReportRepository {
-  private readonly db;
-  private readonly logger;
-  constructor(db: NodePgDatabase, logger?: Logger);
-  overview(orgId: string): Promise<OverviewStats>;
-  enrollments(orgId: string, days: number): Promise<EnrollmentPoint[]>;
-}
-//#endregion
-export { DrizzleDashboardRepository };
-//# sourceMappingURL=dashboard.d.ts.map

package/dist/repositories/dashboard.js

@@ -1,57 +0,0 @@
-import { courses } from "../schema/content.js";
-import { entitlements } from "../schema/entitlements.js";
-import "../schema/index.js";
-import { translateDbErrors } from "./pg-errors.js";
-import { and, eq, gte, isNull, or, sql } from "drizzle-orm";
-import { noopLogger } from "@headless-lms/core/shared/logger";
-//#region src/repositories/dashboard.ts
-var DrizzleDashboardRepository = class {
-	db;
-	logger;
-	constructor(db, logger = noopLogger) {
-		this.db = db;
-		this.logger = logger;
-	}
-	async overview(orgId) {
-		const [courseCounts] = await this.db.select({
-			published: sql`count(*) filter (where ${courses.status} = 'published')`,
-			draft: sql`count(*) filter (where ${courses.status} = 'draft')`
-		}).from(courses).where(eq(courses.orgId, orgId));
-		const effectiveActive = and(eq(entitlements.orgId, orgId), eq(entitlements.status, "active"), or(isNull(entitlements.expiresAt), gte(entitlements.expiresAt, sql`now()`)));
-		const [entitlementCounts] = await this.db.select({
-			activeStudents: sql`count(distinct ${entitlements.orgUserId})`,
-			expiringSoon: sql`count(*) filter (where ${entitlements.expiresAt} is not null and ${entitlements.expiresAt} < now() + interval '14 days')`
-		}).from(entitlements).where(effectiveActive);
-		return {
-			publishedCourses: Number(courseCounts?.published ?? 0),
-			draftCourses: Number(courseCounts?.draft ?? 0),
-			activeStudents: Number(entitlementCounts?.activeStudents ?? 0),
-			expiringSoon: Number(entitlementCounts?.expiringSoon ?? 0)
-		};
-	}
-	async enrollments(orgId, days) {
-		return (await this.db.execute(sql`
-      select
-        to_char(d.day, 'YYYY-MM-DD') as date,
-        count(${entitlements.id})::int as count
-      from generate_series(
-        (now() at time zone 'utc')::date - (${days} - 1),
-        (now() at time zone 'utc')::date,
-        interval '1 day'
-      ) as d(day)
-      left join ${entitlements}
-        on ${entitlements.orgId} = ${orgId}
-        and (${entitlements.grantedAt} at time zone 'utc')::date = d.day::date
-      group by d.day
-      order by d.day
-    `)).rows.map((r) => ({
-			date: r.date,
-			count: Number(r.count)
-		}));
-	}
-};
-translateDbErrors(DrizzleDashboardRepository);
-//#endregion
-export { DrizzleDashboardRepository };
-
-//# sourceMappingURL=dashboard.js.map

package/dist/repositories/dashboard.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"dashboard.js","names":[],"sources":["../../src/repositories/dashboard.ts"],"sourcesContent":["// dashboard — Drizzle repository (implements the core outbound port).\n// Back-office overview counts, every figure scoped to the active org. An\n// entitlement is \"effective-active\" when status='active' and it has not expired\n// (expires_at null or in the future) — expiry is derived at read time.\nimport { and, eq, gte, isNull, or, sql } from \"drizzle-orm\";\nimport type { NodePgDatabase } from \"drizzle-orm/node-postgres\";\nimport type {\n  DashboardReportRepository,\n  EnrollmentPoint,\n  OverviewStats,\n} from \"@headless-lms/core/reporting/dashboard\";\nimport { courses, entitlements } from \"../schema/index.js\";\nimport type { Logger } from \"@headless-lms/core/shared/ports\";\nimport { noopLogger } from \"@headless-lms/core/shared/logger\";\nimport { translateDbErrors } from \"./pg-errors.js\";\n\nexport class DrizzleDashboardRepository implements DashboardReportRepository {\n  constructor(\n    private readonly db: NodePgDatabase,\n    private readonly logger: Logger = noopLogger,\n  ) {}\n\n  async overview(orgId: string): Promise<OverviewStats> {\n    const [courseCounts] = await this.db\n      .select({\n        published: sql<number>`count(*) filter (where ${courses.status} = 'published')`,\n        draft: sql<number>`count(*) filter (where ${courses.status} = 'draft')`,\n      })\n      .from(courses)\n      .where(eq(courses.orgId, orgId));\n\n    const effectiveActive = and(\n      eq(entitlements.orgId, orgId),\n      eq(entitlements.status, \"active\"),\n      or(isNull(entitlements.expiresAt), gte(entitlements.expiresAt, sql`now()`)),\n    );\n\n    const [entitlementCounts] = await this.db\n      .select({\n        activeStudents: sql<number>`count(distinct ${entitlements.orgUserId})`,\n        expiringSoon: sql<number>`count(*) filter (where ${entitlements.expiresAt} is not null and ${entitlements.expiresAt} < now() + interval '14 days')`,\n      })\n      .from(entitlements)\n      .where(effectiveActive);\n\n    return {\n      publishedCourses: Number(courseCounts?.published ?? 0),\n      draftCourses: Number(courseCounts?.draft ?? 0),\n      activeStudents: Number(entitlementCounts?.activeStudents ?? 0),\n      expiringSoon: Number(entitlementCounts?.expiringSoon ?? 0),\n    };\n  }\n\n  // Grants per day over the trailing window, zero-filled so the series has one\n  // point per calendar day (UTC) even when nothing was granted.\n  async enrollments(orgId: string, days: number): Promise<EnrollmentPoint[]> {\n    const result = await this.db.execute(sql`\n      select\n        to_char(d.day, 'YYYY-MM-DD') as date,\n        count(${entitlements.id})::int as count\n      from generate_series(\n        (now() at time zone 'utc')::date - (${days} - 1),\n        (now() at time zone 'utc')::date,\n        interval '1 day'\n      ) as d(day)\n      left join ${entitlements}\n        on ${entitlements.orgId} = ${orgId}\n        and (${entitlements.grantedAt} at time zone 'utc')::date = d.day::date\n      group by d.day\n      order by d.day\n    `);\n    const rows = result.rows as { date: string; count: number }[];\n    return rows.map((r) => ({ date: r.date, count: Number(r.count) }));\n  }\n}\ntranslateDbErrors(DrizzleDashboardRepository);\n"],"mappings":";;;;;;;AAgBA,IAAa,6BAAb,MAA6E;CAExD;CACA;CAFnB,YACE,IACA,SAAkC,YAClC;EAFiB,KAAA,KAAA;EACA,KAAA,SAAA;CAChB;CAEH,MAAM,SAAS,OAAuC;EACpD,MAAM,CAAC,gBAAgB,MAAM,KAAK,GAC/B,OAAO;GACN,WAAW,GAAW,0BAA0B,QAAQ,OAAO;GAC/D,OAAO,GAAW,0BAA0B,QAAQ,OAAO;EAC7D,CAAC,CAAC,CACD,KAAK,OAAO,CAAC,CACb,MAAM,GAAG,QAAQ,OAAO,KAAK,CAAC;EAEjC,MAAM,kBAAkB,IACtB,GAAG,aAAa,OAAO,KAAK,GAC5B,GAAG,aAAa,QAAQ,QAAQ,GAChC,GAAG,OAAO,aAAa,SAAS,GAAG,IAAI,aAAa,WAAW,GAAG,OAAO,CAAC,CAC5E;EAEA,MAAM,CAAC,qBAAqB,MAAM,KAAK,GACpC,OAAO;GACN,gBAAgB,GAAW,kBAAkB,aAAa,UAAU;GACpE,cAAc,GAAW,0BAA0B,aAAa,UAAU,mBAAmB,aAAa,UAAU;EACtH,CAAC,CAAC,CACD,KAAK,YAAY,CAAC,CAClB,MAAM,eAAe;EAExB,OAAO;GACL,kBAAkB,OAAO,cAAc,aAAa,CAAC;GACrD,cAAc,OAAO,cAAc,SAAS,CAAC;GAC7C,gBAAgB,OAAO,mBAAmB,kBAAkB,CAAC;GAC7D,cAAc,OAAO,mBAAmB,gBAAgB,CAAC;EAC3D;CACF;CAIA,MAAM,YAAY,OAAe,MAA0C;EAiBzE,QADa,MAfQ,KAAK,GAAG,QAAQ,GAAG;;;gBAG5B,aAAa,GAAG;;8CAEc,KAAK;;;;kBAIjC,aAAa;aAClB,aAAa,MAAM,KAAK,MAAM;eAC5B,aAAa,UAAU;;;KAGjC,EAAA,CACmB,KACR,KAAK,OAAO;GAAE,MAAM,EAAE;GAAM,OAAO,OAAO,EAAE,KAAK;EAAE,EAAE;CACnE;AACF;AACA,kBAAkB,0BAA0B"}

package/dist/repositories/learn.d.ts

@@ -1,19 +0,0 @@
-import { NodePgDatabase } from "drizzle-orm/node-postgres";
-import { Logger } from "@headless-lms/core/shared/ports";
-import { ContentRef, LearnEntitlementReader } from "@headless-lms/core/reporting/learn";
-//#region src/repositories/learn.d.ts
-declare class DrizzleLearnRepository implements LearnEntitlementReader {
-  private readonly db;
-  private readonly logger;
-  constructor(db: NodePgDatabase, logger?: Logger);
-  private baseFilters;
-  activeRefs(orgId: string, orgUserId: string): Promise<ContentRef[]>;
-  activeRef(orgId: string, orgUserId: string, courseId: string): Promise<ContentRef | null>;
-  private downloadFilters;
-  activeDownloadRefs(orgId: string, orgUserId: string): Promise<ContentRef[]>;
-  activeDownloadRef(orgId: string, orgUserId: string, downloadId: string): Promise<ContentRef | null>;
-  downloadHasAsset(orgId: string, downloadId: string, assetId: string): Promise<boolean>;
-}
-//#endregion
-export { DrizzleLearnRepository };
-//# sourceMappingURL=learn.d.ts.map

package/dist/repositories/learn.js

@@ -1,56 +0,0 @@
-import { courses, downloadAssets, downloads } from "../schema/content.js";
-import { entitlements } from "../schema/entitlements.js";
-import "../schema/index.js";
-import { translateDbErrors } from "./pg-errors.js";
-import { and, eq, gt, isNull, or, sql } from "drizzle-orm";
-import { noopLogger } from "@headless-lms/core/shared/logger";
-//#region src/repositories/learn.ts
-var DrizzleLearnRepository = class {
-	db;
-	logger;
-	constructor(db, logger = noopLogger) {
-		this.db = db;
-		this.logger = logger;
-	}
-	baseFilters(orgId, orgUserId) {
-		return and(eq(entitlements.orgId, orgId), eq(entitlements.orgUserId, orgUserId), eq(entitlements.status, "active"), or(isNull(entitlements.expiresAt), gt(entitlements.expiresAt, sql`now()`)), eq(courses.status, "published"));
-	}
-	async activeRefs(orgId, orgUserId) {
-		return await this.db.select({
-			orgId: entitlements.orgId,
-			contentId: courses.id
-		}).from(entitlements).innerJoin(courses, and(eq(courses.orgId, entitlements.orgId), eq(courses.id, entitlements.contentId))).where(this.baseFilters(orgId, orgUserId));
-	}
-	async activeRef(orgId, orgUserId, courseId) {
-		const [row] = await this.db.select({
-			orgId: entitlements.orgId,
-			contentId: courses.id
-		}).from(entitlements).innerJoin(courses, and(eq(courses.orgId, entitlements.orgId), eq(courses.id, entitlements.contentId))).where(and(this.baseFilters(orgId, orgUserId), eq(entitlements.contentId, courseId))).limit(1);
-		return row ?? null;
-	}
-	downloadFilters(orgId, orgUserId) {
-		return and(eq(entitlements.orgId, orgId), eq(entitlements.orgUserId, orgUserId), eq(entitlements.status, "active"), or(isNull(entitlements.expiresAt), gt(entitlements.expiresAt, sql`now()`)), eq(downloads.status, "published"));
-	}
-	async activeDownloadRefs(orgId, orgUserId) {
-		return this.db.select({
-			orgId: entitlements.orgId,
-			contentId: downloads.id
-		}).from(entitlements).innerJoin(downloads, and(eq(downloads.orgId, entitlements.orgId), eq(downloads.id, entitlements.contentId))).where(this.downloadFilters(orgId, orgUserId));
-	}
-	async activeDownloadRef(orgId, orgUserId, downloadId) {
-		const [row] = await this.db.select({
-			orgId: entitlements.orgId,
-			contentId: downloads.id
-		}).from(entitlements).innerJoin(downloads, and(eq(downloads.orgId, entitlements.orgId), eq(downloads.id, entitlements.contentId))).where(and(this.downloadFilters(orgId, orgUserId), eq(entitlements.contentId, downloadId))).limit(1);
-		return row ?? null;
-	}
-	async downloadHasAsset(orgId, downloadId, assetId) {
-		const [row] = await this.db.select({ id: downloadAssets.id }).from(downloadAssets).where(and(eq(downloadAssets.orgId, orgId), eq(downloadAssets.downloadId, downloadId), eq(downloadAssets.assetId, assetId))).limit(1);
-		return row !== void 0;
-	}
-};
-translateDbErrors(DrizzleLearnRepository);
-//#endregion
-export { DrizzleLearnRepository };
-
-//# sourceMappingURL=learn.js.map

package/dist/repositories/learn.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"learn.js","names":[],"sources":["../../src/repositories/learn.ts"],"sourcesContent":["// learn — Drizzle read repo (implements the reporting/learn outbound port).\n// Returns the (org, content) refs a student is ACTIVELY entitled to and whose\n// course is PUBLISHED. \"Active\" excludes revoked and expired grants (expiry is\n// derived from expires_at at read time — no row flip). Org-scoped: the portal\n// org bounds the read (`entitlements.org_id`), so no cross-org grants leak.\n// The inner join to `courses` on the content id restricts to course grants —\n// no explicit content-type filter needed.\nimport { and, eq, gt, isNull, or, sql, type SQL } from \"drizzle-orm\";\nimport type { NodePgDatabase } from \"drizzle-orm/node-postgres\";\nimport type { LearnEntitlementReader, ContentRef } from \"@headless-lms/core/reporting/learn\";\nimport { entitlements, courses, downloads, downloadAssets } from \"../schema/index.js\";\nimport type { Logger } from \"@headless-lms/core/shared/ports\";\nimport { noopLogger } from \"@headless-lms/core/shared/logger\";\nimport { translateDbErrors } from \"./pg-errors.js\";\n\nexport class DrizzleLearnRepository implements LearnEntitlementReader {\n  constructor(\n    private readonly db: NodePgDatabase,\n    private readonly logger: Logger = noopLogger,\n  ) {}\n\n  private baseFilters(orgId: string, orgUserId: string): SQL {\n    return and(\n      eq(entitlements.orgId, orgId),\n      eq(entitlements.orgUserId, orgUserId),\n      eq(entitlements.status, \"active\"),\n      or(isNull(entitlements.expiresAt), gt(entitlements.expiresAt, sql`now()`))!,\n      eq(courses.status, \"published\"),\n    )!;\n  }\n\n  async activeRefs(orgId: string, orgUserId: string): Promise<ContentRef[]> {\n    const rows = await this.db\n      .select({ orgId: entitlements.orgId, contentId: courses.id })\n      .from(entitlements)\n      .innerJoin(\n        courses,\n        and(eq(courses.orgId, entitlements.orgId), eq(courses.id, entitlements.contentId)),\n      )\n      .where(this.baseFilters(orgId, orgUserId));\n    return rows;\n  }\n\n  async activeRef(orgId: string, orgUserId: string, courseId: string): Promise<ContentRef | null> {\n    const [row] = await this.db\n      .select({ orgId: entitlements.orgId, contentId: courses.id })\n      .from(entitlements)\n      .innerJoin(\n        courses,\n        and(eq(courses.orgId, entitlements.orgId), eq(courses.id, entitlements.contentId)),\n      )\n      .where(and(this.baseFilters(orgId, orgUserId), eq(entitlements.contentId, courseId)))\n      .limit(1);\n    return row ?? null;\n  }\n\n  private downloadFilters(orgId: string, orgUserId: string): SQL {\n    return and(\n      eq(entitlements.orgId, orgId),\n      eq(entitlements.orgUserId, orgUserId),\n      eq(entitlements.status, \"active\"),\n      or(isNull(entitlements.expiresAt), gt(entitlements.expiresAt, sql`now()`))!,\n      eq(downloads.status, \"published\"),\n    )!;\n  }\n\n  async activeDownloadRefs(orgId: string, orgUserId: string): Promise<ContentRef[]> {\n    return this.db\n      .select({ orgId: entitlements.orgId, contentId: downloads.id })\n      .from(entitlements)\n      .innerJoin(\n        downloads,\n        and(eq(downloads.orgId, entitlements.orgId), eq(downloads.id, entitlements.contentId)),\n      )\n      .where(this.downloadFilters(orgId, orgUserId));\n  }\n\n  async activeDownloadRef(\n    orgId: string,\n    orgUserId: string,\n    downloadId: string,\n  ): Promise<ContentRef | null> {\n    const [row] = await this.db\n      .select({ orgId: entitlements.orgId, contentId: downloads.id })\n      .from(entitlements)\n      .innerJoin(\n        downloads,\n        and(eq(downloads.orgId, entitlements.orgId), eq(downloads.id, entitlements.contentId)),\n      )\n      .where(and(this.downloadFilters(orgId, orgUserId), eq(entitlements.contentId, downloadId)))\n      .limit(1);\n    return row ?? null;\n  }\n\n  async downloadHasAsset(orgId: string, downloadId: string, assetId: string): Promise<boolean> {\n    const [row] = await this.db\n      .select({ id: downloadAssets.id })\n      .from(downloadAssets)\n      .where(\n        and(\n          eq(downloadAssets.orgId, orgId),\n          eq(downloadAssets.downloadId, downloadId),\n          eq(downloadAssets.assetId, assetId),\n        ),\n      )\n      .limit(1);\n    return row !== undefined;\n  }\n}\ntranslateDbErrors(DrizzleLearnRepository);\n"],"mappings":"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"}

package/dist/repositories/students.d.ts

@@ -1,16 +0,0 @@
-import { NodePgDatabase } from "drizzle-orm/node-postgres";
-import { Logger } from "@headless-lms/core/shared/ports";
-import { Page, Student, StudentAnalytics, StudentsQuery, StudentsReportRepository } from "@headless-lms/core/reporting/students";
-//#region src/repositories/students.d.ts
-declare class DrizzleStudentsRepository implements StudentsReportRepository {
-  private readonly db;
-  private readonly logger;
-  constructor(db: NodePgDatabase, logger?: Logger);
-  list(orgId: string, query: StudentsQuery): Promise<Page<Student>>;
-  findById(orgId: string, id: string): Promise<Student | null>;
-  analytics(orgId: string, id: string): Promise<StudentAnalytics | null>;
-  private resolveOrder;
-}
-//#endregion
-export { DrizzleStudentsRepository };
-//# sourceMappingURL=students.d.ts.map

package/dist/repositories/students.js

@@ -1,160 +0,0 @@
-import { users } from "../schema/identity.js";
-import { orgUsers } from "../schema/organizations.js";
-import { entitlements } from "../schema/entitlements.js";
-import "../schema/index.js";
-import { translateDbErrors } from "./pg-errors.js";
-import { user } from "../schema/better-auth.js";
-import { orgUserProfileColumns } from "./org-user-profile.js";
-import { and, asc, desc, eq, ilike, or, sql } from "drizzle-orm";
-import { noopLogger } from "@headless-lms/core/shared/logger";
-import { STUDENT_ROLE } from "@headless-lms/core/organizations";
-//#region src/repositories/students.ts
-const entitlementCountExpr = sql`count(${entitlements.id})`;
-const avgProgressExpr = sql`0`;
-const lastActiveExpr = sql`(
-  select max(pr.updated_at) from progress_records pr
-  where pr.org_id = ${orgUsers.orgId} and pr.org_user_id = ${orgUsers.id}
-)`;
-function toStudent(row) {
-	return {
-		id: row.id,
-		email: row.email,
-		image: row.image ?? null,
-		firstName: row.firstName,
-		lastName: row.lastName,
-		status: row.status,
-		entitlementCount: Number(row.entitlementCount),
-		avgProgress: Number(row.avgProgress),
-		joinedAt: row.createdAt.toISOString(),
-		lastActiveAt: row.lastActiveAt ? new Date(row.lastActiveAt).toISOString() : null
-	};
-}
-var DrizzleStudentsRepository = class {
-	db;
-	logger;
-	constructor(db, logger = noopLogger) {
-		this.db = db;
-		this.logger = logger;
-	}
-	async list(orgId, query) {
-		const filters = [eq(orgUsers.orgId, orgId), eq(orgUsers.role, STUDENT_ROLE)];
-		const q = query.search?.trim();
-		if (q) {
-			const like = `%${q}%`;
-			filters.push(or(ilike(users.firstName, like), ilike(users.lastName, like), ilike(users.email, like)));
-		}
-		const where = and(...filters);
-		const [totals] = await this.db.select({ total: sql`count(*)` }).from(orgUsers).innerJoin(users, eq(users.id, orgUsers.userId)).where(where);
-		return {
-			rows: (await this.db.select({
-				...orgUserProfileColumns,
-				status: orgUsers.status,
-				createdAt: orgUsers.createdAt,
-				entitlementCount: entitlementCountExpr,
-				avgProgress: avgProgressExpr,
-				lastActiveAt: lastActiveExpr
-			}).from(orgUsers).leftJoin(entitlements, and(eq(entitlements.orgId, orgUsers.orgId), eq(entitlements.orgUserId, orgUsers.id))).innerJoin(users, eq(users.id, orgUsers.userId)).leftJoin(user, eq(user.id, users.externalId)).where(where).groupBy(orgUsers.orgId, orgUsers.id, orgUsers.status, users.email, users.firstName, users.lastName, user.image).orderBy(...this.resolveOrder(query.sort)).limit(query.pageSize).offset((query.page - 1) * query.pageSize)).map(toStudent),
-			total: Number(totals?.total ?? 0),
-			page: query.page,
-			pageSize: query.pageSize
-		};
-	}
-	async findById(orgId, id) {
-		const [row] = await this.db.select({
-			...orgUserProfileColumns,
-			status: orgUsers.status,
-			createdAt: orgUsers.createdAt,
-			entitlementCount: entitlementCountExpr,
-			avgProgress: avgProgressExpr,
-			lastActiveAt: lastActiveExpr
-		}).from(orgUsers).leftJoin(entitlements, and(eq(entitlements.orgId, orgUsers.orgId), eq(entitlements.orgUserId, orgUsers.id))).innerJoin(users, eq(users.id, orgUsers.userId)).leftJoin(user, eq(user.id, users.externalId)).where(and(eq(orgUsers.orgId, orgId), eq(orgUsers.id, id), eq(orgUsers.role, STUDENT_ROLE))).groupBy(orgUsers.orgId, orgUsers.id, orgUsers.status, users.email, users.firstName, users.lastName, user.image).limit(1);
-		return row ? toStudent(row) : null;
-	}
-	async analytics(orgId, id) {
-		const [exists] = await this.db.select({ id: orgUsers.id }).from(orgUsers).where(and(eq(orgUsers.orgId, orgId), eq(orgUsers.id, id), eq(orgUsers.role, STUDENT_ROLE)));
-		if (!exists) return null;
-		const courses = (await this.db.execute(sql`
-      with cohort_courses as (
-        select c.id, c.title
-        from entitlements e
-        join courses c on c.org_id = e.org_id and c.id = e.content_id
-        where e.org_id = ${orgId}
-          and e.org_user_id = ${id}
-          and e.status = 'active'
-          and (e.expires_at is null or e.expires_at >= now())
-      ),
-      acts as (
-        select a.course_id, a.id
-        from activities a
-        where a.org_id = ${orgId}
-          and a.course_id in (select id from cohort_courses)
-          and coalesce((a.settings ->> 'published')::boolean, true)
-      )
-      select
-        cc.id as course_id,
-        cc.title,
-        count(a.id)::int as total_activities,
-        count(pr.id) filter (where pr.completed_at is not null)::int as completed_activities,
-        min(pr.started_at) as started_at,
-        max(pr.updated_at) as last_activity_at,
-        (
-          select prc.completed_at from progress_records prc
-          where prc.org_id = ${orgId}
-            and prc.org_user_id = ${id}
-            and prc.target_type = 'course'
-            and prc.target_id = cc.id
-        ) as completed_at
-      from cohort_courses cc
-      left join acts a on a.course_id = cc.id
-      left join progress_records pr
-        on pr.org_id = ${orgId}
-        and pr.org_user_id = ${id}
-        and pr.target_type = 'activity'
-        and pr.target_id = a.id
-      group by cc.id, cc.title
-      order by cc.title
-    `)).rows.map((r) => {
-			const total = Number(r.total_activities);
-			const done = Number(r.completed_activities);
-			return {
-				courseId: r.course_id,
-				title: r.title,
-				totalActivities: total,
-				completedActivities: done,
-				progress: total > 0 ? Math.round(Math.min(done / total, 1) * 100) : 0,
-				startedAt: r.started_at ? new Date(r.started_at).toISOString() : null,
-				lastActivityAt: r.last_activity_at ? new Date(r.last_activity_at).toISOString() : null,
-				completedAt: r.completed_at ? new Date(r.completed_at).toISOString() : null
-			};
-		});
-		const started = courses.filter((c) => c.startedAt !== null).length;
-		const completed = courses.filter((c) => c.completedAt !== null).length;
-		const avgProgress = courses.length > 0 ? Math.round(courses.reduce((sum, c) => sum + c.progress, 0) / courses.length) : 0;
-		return {
-			enrolled: courses.length,
-			started,
-			completed,
-			avgProgress,
-			courses
-		};
-	}
-	resolveOrder(sort) {
-		const descending = sort?.startsWith("-") ?? false;
-		const field = sort ? descending ? sort.slice(1) : sort : "firstName";
-		const dir = descending ? desc : asc;
-		switch (field) {
-			case "email": return [dir(users.email)];
-			case "entitlementCount": return [dir(entitlementCountExpr)];
-			case "avgProgress": return [dir(avgProgressExpr)];
-			case "joinedAt": return [dir(orgUsers.createdAt)];
-			case "lastActiveAt": return [dir(lastActiveExpr)];
-			case "lastName": return [dir(users.lastName), dir(users.firstName)];
-			default: return [dir(users.firstName), dir(users.lastName)];
-		}
-	}
-};
-translateDbErrors(DrizzleStudentsRepository);
-//#endregion
-export { DrizzleStudentsRepository };
-
-//# sourceMappingURL=students.js.map

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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"}