@headless-lms/core 0.1.0

package/dist/progress/service.js

@@ -0,0 +1,181 @@
+import { genId } from "../shared/id.js";
+import { noopLogger } from "../shared/logger.js";
+import { NotFoundError } from "../shared/errors.js";
+import { progressEvents } from "./events.js";
+//#region src/progress/service.ts
+/** Mirrors reporting/learn: `settings.published === false` is the only draft signal. */
+function isActivityPublished(settings) {
+	return settings?.published !== false;
+}
+/** Fold a report batch into the record's per-subject state map. Reserved keys
+*  (`asset` = subject, `completed` = claim) are stripped; the rest is the asset
+*  type's own vocabulary, stored opaquely — latest report per subject wins. */
+function mergeReports(position, items) {
+	const map = { ...position ?? {} };
+	let changed = false;
+	let claimed = false;
+	for (const item of items) {
+		const { asset, completed, ...payload } = item;
+		if (completed === true) claimed = true;
+		if (Object.keys(payload).length > 0) {
+			map[asset ?? "self"] = payload;
+			changed = true;
+		}
+	}
+	return {
+		map,
+		changed,
+		claimed
+	};
+}
+/** The completion-rule seam. Only `manual` ships: no authored rule → the
+*  learner's claim decides. Authored rules are never satisfied until their
+*  evaluators exist. Future rules evaluate against the accumulated state map. */
+function completionSatisfied(settings, claimed) {
+	const rule = settings?.completion?.rule;
+	if (!rule || rule === "manual") return claimed;
+	return false;
+}
+var ProgressServiceImpl = class {
+	repo;
+	content;
+	uow;
+	logger;
+	constructor(params) {
+		this.repo = params.repo;
+		this.content = params.content;
+		this.uow = params.uow;
+		this.logger = params.logger ?? noopLogger;
+	}
+	async report(orgId, input) {
+		const activity = await this.content.getActivity(orgId, input.activityId);
+		if (!activity || !isActivityPublished(activity.settings)) throw new NotFoundError("Activity", input.activityId);
+		const courseId = activity.courseId;
+		const modules = await this.content.listCourseModules(orgId, courseId);
+		const courseActivities = await this.content.listCourseActivities(orgId, courseId);
+		return this.uow.run(async (scope) => {
+			const lockIds = [
+				...courseActivities.filter((a) => isActivityPublished(a.settings)).map((a) => a.id),
+				...modules.map((m) => m.id),
+				courseId
+			];
+			await scope.progress.findByTargets(orgId, input.orgUserId, lockIds, { forUpdate: true });
+			const events = [];
+			let record = await this.ensureActivityRecord(orgId, input, scope, events);
+			const state = mergeReports(record.position, input.reports);
+			if (state.changed && !record.completedAt) record = await scope.progress.update(orgId, record.id, { position: state.map }) ?? record;
+			if (!record.completedAt && completionSatisfied(activity.settings, state.claimed)) {
+				record = await scope.progress.update(orgId, record.id, { completedAt: /* @__PURE__ */ new Date() }) ?? record;
+				events.push(progressEvents.progressCompleted.make({
+					orgId,
+					data: record
+				}));
+				await this.completeContainers(orgId, input, courseId, modules, courseActivities, scope, events);
+				this.logger.info("progress completed", {
+					orgId,
+					recordId: record.id
+				});
+			}
+			if (events.length > 0) await scope.outbox.append(events);
+			return record;
+		});
+	}
+	async ensureActivityRecord(orgId, input, scope, events) {
+		const target = {
+			orgUserId: input.orgUserId,
+			targetType: "activity",
+			targetId: input.activityId
+		};
+		const existing = await scope.progress.findByTarget(orgId, target);
+		if (existing) return existing;
+		const now = /* @__PURE__ */ new Date();
+		const record = await scope.progress.insert(orgId, {
+			id: genId("progress"),
+			orgId,
+			orgUserId: input.orgUserId,
+			targetType: "activity",
+			targetId: input.activityId,
+			startedAt: now,
+			position: null,
+			completedAt: null,
+			updatedAt: now
+		});
+		if (!record) {
+			const winner = await scope.progress.findByTarget(orgId, target);
+			if (!winner) throw new Error("progress record vanished after insert conflict");
+			return winner;
+		}
+		events.push(progressEvents.progressStarted.make({
+			orgId,
+			data: record
+		}));
+		this.logger.info("progress started", {
+			orgId,
+			recordId: record.id
+		});
+		return record;
+	}
+	/** After an activity completes: newly-complete containers get their records
+	*  (created complete) and a progress.completed event — same transaction. */
+	async completeContainers(orgId, input, courseId, modules, courseActivities, scope, events) {
+		const published = courseActivities.filter((a) => isActivityPublished(a.settings));
+		const byModule = modules.map((m) => ({
+			id: m.id,
+			activityIds: published.filter((a) => a.moduleId === m.id).map((a) => a.id)
+		}));
+		const allIds = byModule.flatMap((m) => m.activityIds);
+		const records = await scope.progress.findByTargets(orgId, input.orgUserId, allIds);
+		const done = new Set(records.filter((r) => r.targetType === "activity" && r.completedAt).map((r) => r.targetId));
+		const containing = byModule.find((m) => m.activityIds.includes(input.activityId));
+		if (containing && containing.activityIds.every((id) => done.has(id))) await this.ensureContainerComplete(orgId, input, "module", containing.id, scope, events);
+		if (allIds.length > 0 && allIds.every((id) => done.has(id))) await this.ensureContainerComplete(orgId, input, "course", courseId, scope, events);
+	}
+	async ensureContainerComplete(orgId, input, targetType, targetId, scope, events) {
+		const target = {
+			orgUserId: input.orgUserId,
+			targetType,
+			targetId
+		};
+		let existing = await scope.progress.findByTarget(orgId, target);
+		if (existing?.completedAt) return;
+		if (!existing) {
+			const now = /* @__PURE__ */ new Date();
+			const inserted = await scope.progress.insert(orgId, {
+				id: genId("progress"),
+				orgId,
+				orgUserId: input.orgUserId,
+				targetType,
+				targetId,
+				startedAt: now,
+				position: null,
+				completedAt: now,
+				updatedAt: now
+			});
+			if (inserted) {
+				events.push(progressEvents.progressCompleted.make({
+					orgId,
+					data: inserted
+				}));
+				return;
+			}
+			existing = await scope.progress.findByTarget(orgId, target);
+			if (existing?.completedAt) return;
+			if (!existing) throw new Error("progress container record vanished after insert conflict");
+		}
+		const record = await scope.progress.update(orgId, existing.id, { completedAt: /* @__PURE__ */ new Date() }) ?? existing;
+		events.push(progressEvents.progressCompleted.make({
+			orgId,
+			data: record
+		}));
+	}
+	get(orgId, target) {
+		return this.repo.findByTarget(orgId, target);
+	}
+	listByTargets(orgId, orgUserId, targetIds) {
+		return this.repo.findByTargets(orgId, orgUserId, targetIds);
+	}
+};
+//#endregion
+export { ProgressServiceImpl };
+
+//# sourceMappingURL=service.js.map

package/dist/progress/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","names":[],"sources":["../../src/progress/service.ts"],"sourcesContent":["// progress context — service implementation (inbound port).\n// The frontend only reports usage; this service makes every completion\n// decision. One report batch runs in one UoW transaction: ensure the record,\n// merge item payloads into the per-subject state map, evaluate the activity's\n// completion rule, then module/course against current published structure —\n// appending events with the writes. The container is resolved from the\n// hierarchy (activity → module → course), never supplied by the caller.\n// Percentage/resume are derived by readers, never stored here.\nimport { genId } from '../shared/id.js';\nimport { NotFoundError } from '../shared/errors.js';\nimport type { ProgressRecord } from './model.js';\nimport type {\n  ProgressRepository,\n  ProgressService,\n  ProgressUnitOfWork,\n  ProgressWriteScope,\n} from './ports.js';\nimport type { ProgressReportItem, ProgressTarget, ReportProgressInput } from './types.js';\nimport { progressEvents, type NewProgressEvent } from './events.js';\nimport type { Activity, ContentService, Module } from '../content/index.js';\nimport type { JsonValue } from '../types/index.js';\nimport type { Logger } from '../shared/ports.js';\nimport { noopLogger } from '../shared/logger.js';\n\n/** Mirrors reporting/learn: `settings.published === false` is the only draft signal. */\nfunction isActivityPublished(settings: unknown): boolean {\n  return (settings as { published?: boolean } | null)?.published !== false;\n}\n\n/** Fold a report batch into the record's per-subject state map. Reserved keys\n *  (`asset` = subject, `completed` = claim) are stripped; the rest is the asset\n *  type's own vocabulary, stored opaquely — latest report per subject wins. */\nfunction mergeReports(\n  position: unknown,\n  items: ProgressReportItem[],\n): { map: Record<string, JsonValue>; changed: boolean; claimed: boolean } {\n  const map = { ...((position as Record<string, JsonValue> | null) ?? {}) };\n  let changed = false;\n  let claimed = false;\n  for (const item of items) {\n    const { asset, completed, ...payload } = item;\n    if (completed === true) {\n      claimed = true;\n    }\n    if (Object.keys(payload).length > 0) {\n      map[asset ?? 'self'] = payload;\n      changed = true;\n    }\n  }\n  return { map, changed, claimed };\n}\n\n/** The completion-rule seam. Only `manual` ships: no authored rule → the\n *  learner's claim decides. Authored rules are never satisfied until their\n *  evaluators exist. Future rules evaluate against the accumulated state map. */\nfunction completionSatisfied(settings: unknown, claimed: boolean): boolean {\n  const rule = (settings as { completion?: { rule?: string } } | null)?.completion?.rule;\n  if (!rule || rule === 'manual') {\n    return claimed;\n  }\n  return false;\n}\n\nexport type ProgressServiceParams = {\n  repo: ProgressRepository;\n  content: ContentService;\n  uow: ProgressUnitOfWork;\n  logger?: Logger;\n};\n\nexport class ProgressServiceImpl implements ProgressService {\n  private readonly repo: ProgressRepository;\n  private readonly content: ContentService;\n  private readonly uow: ProgressUnitOfWork;\n  private readonly logger: Logger;\n\n  constructor(params: ProgressServiceParams) {\n    this.repo = params.repo;\n    this.content = params.content;\n    this.uow = params.uow;\n    this.logger = params.logger ?? noopLogger;\n  }\n\n  async report(orgId: string, input: ReportProgressInput): Promise<ProgressRecord> {\n    const activity = await this.content.getActivity(orgId, input.activityId);\n    if (!activity || !isActivityPublished(activity.settings)) {\n      throw new NotFoundError('Activity', input.activityId);\n    }\n    const courseId = activity.courseId;\n    const modules = await this.content.listCourseModules(orgId, courseId);\n    const courseActivities = await this.content.listCourseActivities(orgId, courseId);\n    return this.uow.run(async (scope) => {\n      // Serializes concurrent reports for this student+course (locks are tx-scoped;\n      // both racers lock in the same order, the loser waits and then sees committed state).\n      const lockIds = [\n        ...courseActivities.filter((a) => isActivityPublished(a.settings)).map((a) => a.id),\n        ...modules.map((m) => m.id),\n        courseId,\n      ];\n      await scope.progress.findByTargets(orgId, input.orgUserId, lockIds, { forUpdate: true });\n      const events: NewProgressEvent[] = [];\n      let record = await this.ensureActivityRecord(orgId, input, scope, events);\n      const state = mergeReports(record.position, input.reports);\n      if (state.changed && !record.completedAt) {\n        record = (await scope.progress.update(orgId, record.id, { position: state.map })) ?? record;\n      }\n      if (!record.completedAt && completionSatisfied(activity.settings, state.claimed)) {\n        record =\n          (await scope.progress.update(orgId, record.id, {\n            completedAt: new Date(),\n          })) ?? record;\n        events.push(\n          progressEvents.progressCompleted.make({ orgId, data: record }),\n        );\n        await this.completeContainers(orgId, input, courseId, modules, courseActivities, scope, events);\n        this.logger.info('progress completed', { orgId, recordId: record.id });\n      }\n      if (events.length > 0) {\n        await scope.outbox.append(events);\n      }\n      return record;\n    });\n  }\n\n  private async ensureActivityRecord(\n    orgId: string,\n    input: ReportProgressInput,\n    scope: ProgressWriteScope,\n    events: NewProgressEvent[],\n  ): Promise<ProgressRecord> {\n    const target: ProgressTarget = {\n      orgUserId: input.orgUserId,\n      targetType: 'activity',\n      targetId: input.activityId,\n    };\n    const existing = await scope.progress.findByTarget(orgId, target);\n    if (existing) {\n      return existing;\n    }\n    const now = new Date();\n    const record = await scope.progress.insert(orgId, {\n      id: genId('progress'),\n      orgId,\n      orgUserId: input.orgUserId,\n      targetType: 'activity',\n      targetId: input.activityId,\n      startedAt: now,\n      position: null,\n      completedAt: null,\n      updatedAt: now,\n    });\n    if (!record) {\n      // Lost a concurrent first-touch insert: the winner owns the row and emitted\n      // progress.started. Return its row without re-emitting.\n      const winner = await scope.progress.findByTarget(orgId, target);\n      if (!winner) {\n        throw new Error('progress record vanished after insert conflict');\n      }\n      return winner;\n    }\n    events.push(progressEvents.progressStarted.make({ orgId, data: record }));\n    this.logger.info('progress started', { orgId, recordId: record.id });\n    return record;\n  }\n\n  /** After an activity completes: newly-complete containers get their records\n   *  (created complete) and a progress.completed event — same transaction. */\n  private async completeContainers(\n    orgId: string,\n    input: ReportProgressInput,\n    courseId: string,\n    modules: Module[],\n    courseActivities: Activity[],\n    scope: ProgressWriteScope,\n    events: NewProgressEvent[],\n  ): Promise<void> {\n    const published = courseActivities.filter((a) => isActivityPublished(a.settings));\n    const byModule = modules.map((m) => ({\n      id: m.id,\n      activityIds: published.filter((a) => a.moduleId === m.id).map((a) => a.id),\n    }));\n    const allIds = byModule.flatMap((m) => m.activityIds);\n    const records = await scope.progress.findByTargets(orgId, input.orgUserId, allIds);\n    const done = new Set(\n      records.filter((r) => r.targetType === 'activity' && r.completedAt).map((r) => r.targetId),\n    );\n    const containing = byModule.find((m) => m.activityIds.includes(input.activityId));\n    if (containing && containing.activityIds.every((id) => done.has(id))) {\n      await this.ensureContainerComplete(orgId, input, 'module', containing.id, scope, events);\n    }\n    if (allIds.length > 0 && allIds.every((id) => done.has(id))) {\n      await this.ensureContainerComplete(orgId, input, 'course', courseId, scope, events);\n    }\n  }\n\n  private async ensureContainerComplete(\n    orgId: string,\n    input: ReportProgressInput,\n    targetType: 'module' | 'course',\n    targetId: string,\n    scope: ProgressWriteScope,\n    events: NewProgressEvent[],\n  ): Promise<void> {\n    const target: ProgressTarget = { orgUserId: input.orgUserId, targetType, targetId };\n    let existing = await scope.progress.findByTarget(orgId, target);\n    if (existing?.completedAt) {\n      return;\n    }\n    if (!existing) {\n      const now = new Date();\n      const inserted = await scope.progress.insert(orgId, {\n        id: genId('progress'),\n        orgId,\n        orgUserId: input.orgUserId,\n        targetType,\n        targetId,\n        startedAt: now,\n        position: null,\n        completedAt: now,\n        updatedAt: now,\n      });\n      if (inserted) {\n        events.push(\n          progressEvents.progressCompleted.make({ orgId, data: inserted }),\n        );\n        return;\n      }\n      // Lost a concurrent insert: re-read the winner's row.\n      existing = await scope.progress.findByTarget(orgId, target);\n      if (existing?.completedAt) {\n        return;\n      }\n      if (!existing) {\n        throw new Error('progress container record vanished after insert conflict');\n      }\n    }\n    const record =\n      (await scope.progress.update(orgId, existing.id, {\n        completedAt: new Date(),\n      })) ?? existing;\n    events.push(progressEvents.progressCompleted.make({ orgId, data: record }));\n  }\n\n  get(orgId: string, target: ProgressTarget): Promise<ProgressRecord | null> {\n    return this.repo.findByTarget(orgId, target);\n  }\n\n  listByTargets(orgId: string, orgUserId: string, targetIds: string[]): Promise<ProgressRecord[]> {\n    return this.repo.findByTargets(orgId, orgUserId, targetIds);\n  }\n}\n"],"mappings":"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"}

package/dist/progress/types.d.ts

@@ -0,0 +1,4 @@
+import { ProgressReportItem, ProgressTarget, ReportProgressInput } from "../types/schemas/progress.js";
+import { ProgressId } from "../types/progress.js";
+import "../types/index.js";
+export type { ProgressId, ProgressReportItem, ProgressTarget, ReportProgressInput };

package/dist/progress/types.js

@@ -0,0 +1 @@
+export {};

package/dist/reporting/dashboard/index.d.ts

@@ -0,0 +1,4 @@
+import { EnrollmentPoint, OverviewStats } from "./model.js";
+import { DashboardReportRepository, DashboardReportService } from "./ports.js";
+import { DashboardReportServiceImpl } from "./service.js";
+export { type DashboardReportRepository, type DashboardReportService, DashboardReportServiceImpl, type EnrollmentPoint, type OverviewStats };

package/dist/reporting/dashboard/index.js

@@ -0,0 +1,2 @@
+import { DashboardReportServiceImpl } from "./service.js";
+export { DashboardReportServiceImpl };

package/dist/reporting/dashboard/model.d.ts

@@ -0,0 +1,14 @@
+//#region src/reporting/dashboard/model.d.ts
+interface OverviewStats {
+  publishedCourses: number;
+  draftCourses: number;
+  activeStudents: number;
+  expiringSoon: number;
+}
+interface EnrollmentPoint {
+  date: string;
+  count: number;
+}
+//#endregion
+export { EnrollmentPoint, OverviewStats };
+//# sourceMappingURL=model.d.ts.map

package/dist/reporting/dashboard/model.js

@@ -0,0 +1 @@
+export {};

package/dist/reporting/dashboard/ports.d.ts

@@ -0,0 +1,13 @@
+import { EnrollmentPoint, OverviewStats } from "./model.js";
+//#region src/reporting/dashboard/ports.d.ts
+interface DashboardReportService {
+  overview(orgId: string): Promise<OverviewStats>;
+  enrollments(orgId: string, days: number): Promise<EnrollmentPoint[]>;
+}
+interface DashboardReportRepository {
+  overview(orgId: string): Promise<OverviewStats>;
+  enrollments(orgId: string, days: number): Promise<EnrollmentPoint[]>;
+}
+//#endregion
+export { DashboardReportRepository, DashboardReportService };
+//# sourceMappingURL=ports.d.ts.map

package/dist/reporting/dashboard/ports.js

@@ -0,0 +1 @@
+export {};

package/dist/reporting/dashboard/service.d.ts

@@ -0,0 +1,19 @@
+import { Logger } from "../../types/ports.js";
+import "../../shared/ports.js";
+import { EnrollmentPoint, OverviewStats } from "./model.js";
+import { DashboardReportRepository, DashboardReportService } from "./ports.js";
+//#region src/reporting/dashboard/service.d.ts
+type DashboardReportServiceParams = {
+  repo: DashboardReportRepository;
+  logger?: Logger;
+};
+declare class DashboardReportServiceImpl implements DashboardReportService {
+  private readonly repo;
+  private readonly logger;
+  constructor(params: DashboardReportServiceParams);
+  overview(orgId: string): Promise<OverviewStats>;
+  enrollments(orgId: string, days: number): Promise<EnrollmentPoint[]>;
+}
+//#endregion
+export { DashboardReportServiceImpl, DashboardReportServiceParams };
+//# sourceMappingURL=service.d.ts.map

package/dist/reporting/dashboard/service.js

@@ -0,0 +1,20 @@
+import { noopLogger } from "../../shared/logger.js";
+//#region src/reporting/dashboard/service.ts
+var DashboardReportServiceImpl = class {
+	repo;
+	logger;
+	constructor(params) {
+		this.repo = params.repo;
+		this.logger = params.logger ?? noopLogger;
+	}
+	overview(orgId) {
+		return this.repo.overview(orgId);
+	}
+	enrollments(orgId, days) {
+		return this.repo.enrollments(orgId, days);
+	}
+};
+//#endregion
+export { DashboardReportServiceImpl };
+
+//# sourceMappingURL=service.js.map

package/dist/reporting/dashboard/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","names":[],"sources":["../../../src/reporting/dashboard/service.ts"],"sourcesContent":["// reporting/dashboard — service implementation (inbound port).\nimport type { EnrollmentPoint, OverviewStats } from './model.js';\nimport type { DashboardReportRepository, DashboardReportService } from './ports.js';\nimport type { Logger } from '../../shared/ports.js';\nimport { noopLogger } from '../../shared/logger.js';\n\nexport type DashboardReportServiceParams = {\n  repo: DashboardReportRepository;\n  logger?: Logger;\n};\n\nexport class DashboardReportServiceImpl implements DashboardReportService {\n  private readonly repo: DashboardReportRepository;\n  private readonly logger: Logger;\n\n  constructor(params: DashboardReportServiceParams) {\n    this.repo = params.repo;\n    this.logger = params.logger ?? noopLogger;\n  }\n\n  overview(orgId: string): Promise<OverviewStats> {\n    return this.repo.overview(orgId);\n  }\n\n  enrollments(orgId: string, days: number): Promise<EnrollmentPoint[]> {\n    return this.repo.enrollments(orgId, days);\n  }\n}\n"],"mappings":";;AAWA,IAAa,6BAAb,MAA0E;CACxE;CACA;CAEA,YAAY,QAAsC;EAChD,KAAK,OAAO,OAAO;EACnB,KAAK,SAAS,OAAO,UAAU;CACjC;CAEA,SAAS,OAAuC;EAC9C,OAAO,KAAK,KAAK,SAAS,KAAK;CACjC;CAEA,YAAY,OAAe,MAA0C;EACnE,OAAO,KAAK,KAAK,YAAY,OAAO,IAAI;CAC1C;AACF"}

package/dist/reporting/learn/index.d.ts

@@ -0,0 +1,5 @@
+import { Course, Module } from "../../types/schemas/content.js";
+import { ContentRef, CourseProgressView } from "./model.js";
+import { LearnEntitlementReader, LearnReportService } from "./ports.js";
+import { LearnReportServiceImpl } from "./service.js";
+export { type ContentRef, type Course, type CourseProgressView, type LearnEntitlementReader, type LearnReportService, LearnReportServiceImpl, type Module };

package/dist/reporting/learn/index.js

@@ -0,0 +1,2 @@
+import { LearnReportServiceImpl } from "./service.js";
+export { LearnReportServiceImpl };

package/dist/reporting/learn/model.d.ts

@@ -0,0 +1,23 @@
+import { Course, Download, DownloadAsset, Module } from "../../types/schemas/content.js";
+import "../../content/index.js";
+//#region src/reporting/learn/model.d.ts
+/** An active-entitlement pointer: the org + content item a student may consume. */
+interface ContentRef {
+  orgId: string;
+  contentId: string;
+}
+/** Per-course progress for the student surface. Derived on read against the
+ *  current published structure — never stored. */
+interface CourseProgressView {
+  /** Keyed by activity id; absent key = not started. */
+  activities: Record<string, 'in-progress' | 'completed'>;
+  /** Integer 0–100: completed ÷ current published activities, rounded. */
+  percent: number;
+  /** The course target's own record says so. */
+  completed: boolean;
+  /** Per-activity reported state (the record's position map); absent key = none reported. */
+  positions: Record<string, unknown>;
+}
+//#endregion
+export { ContentRef, type Course, CourseProgressView, type Download, type DownloadAsset, type Module };
+//# sourceMappingURL=model.d.ts.map

package/dist/reporting/learn/model.js

@@ -0,0 +1 @@
+export {};

package/dist/reporting/learn/ports.d.ts

@@ -0,0 +1,42 @@
+import { Course, Download, DownloadAsset, Module } from "../../types/schemas/content.js";
+import { ContentRef, CourseProgressView } from "./model.js";
+//#region src/reporting/learn/ports.d.ts
+/**
+ * Inbound: the student-scoped read use-cases. Scoped by `(orgId, orgUserId)` —
+ * the portal org resolved at the boundary. `null` ⇒ not enrolled (→ 404).
+ */
+interface LearnReportService {
+  listCourses(orgId: string, orgUserId: string): Promise<Course[]>;
+  getCourse(orgId: string, orgUserId: string, courseId: string): Promise<Course | null>;
+  listModules(orgId: string, orgUserId: string, courseId: string): Promise<Module[] | null>;
+  courseProgress(orgId: string, orgUserId: string, courseId: string): Promise<CourseProgressView | null>;
+  listDownloads(orgId: string, orgUserId: string): Promise<Download[]>;
+  getDownload(orgId: string, orgUserId: string, downloadId: string): Promise<{
+    download: Download;
+    assets: DownloadAsset[];
+  } | null>;
+  /** Entitlement-gated. Returns null (→ 404) for every failure — never 403,
+   *  which would confirm the resource exists to someone not entitled to it. */
+  downloadAssetUrl(orgId: string, orgUserId: string, downloadId: string, assetId: string): Promise<{
+    url: string;
+    filename: string;
+  } | null>;
+}
+/**
+ * Outbound: the student's active, non-expired course entitlements in PUBLISHED
+ * courses, scoped to the portal org. Implemented by a Drizzle read repo; the
+ * service resolves each ref against the content service for the full
+ * Course/Module payload.
+ */
+interface LearnEntitlementReader {
+  activeRefs(orgId: string, orgUserId: string): Promise<ContentRef[]>;
+  activeRef(orgId: string, orgUserId: string, courseId: string): Promise<ContentRef | null>;
+  /** Active, non-expired grants to PUBLISHED downloads, scoped to the org. */
+  activeDownloadRefs(orgId: string, orgUserId: string): Promise<ContentRef[]>;
+  activeDownloadRef(orgId: string, orgUserId: string, downloadId: string): Promise<ContentRef | null>;
+  /** Whether this asset is linked to this download. The paywall's second gate. */
+  downloadHasAsset(orgId: string, downloadId: string, assetId: string): Promise<boolean>;
+}
+//#endregion
+export { LearnEntitlementReader, LearnReportService };
+//# sourceMappingURL=ports.d.ts.map

package/dist/reporting/learn/ports.js

@@ -0,0 +1 @@
+export {};

package/dist/reporting/learn/service.d.ts

@@ -0,0 +1,48 @@
+import { Logger } from "../../types/ports.js";
+import { Course, Download, DownloadAsset, Module } from "../../types/schemas/content.js";
+import "../../shared/ports.js";
+import { AssetsService } from "../../assets/ports.js";
+import "../../assets/index.js";
+import { ContentService } from "../../content/ports.js";
+import "../../content/index.js";
+import { ProgressService } from "../../progress/ports.js";
+import "../../progress/index.js";
+import { CourseProgressView } from "./model.js";
+import { LearnEntitlementReader, LearnReportService } from "./ports.js";
+//#region src/reporting/learn/service.d.ts
+type LearnReportServiceParams = {
+  reader: LearnEntitlementReader;
+  content: ContentService;
+  progress: ProgressService;
+  assets: AssetsService;
+  deliveryExpirySeconds: number;
+  logger?: Logger;
+};
+declare class LearnReportServiceImpl implements LearnReportService {
+  private readonly reader;
+  private readonly content;
+  private readonly progress;
+  private readonly assets;
+  private readonly deliveryExpirySeconds;
+  private readonly logger;
+  constructor(params: LearnReportServiceParams);
+  listCourses(orgId: string, orgUserId: string): Promise<Course[]>;
+  getCourse(orgId: string, orgUserId: string, courseId: string): Promise<Course | null>;
+  listModules(orgId: string, orgUserId: string, courseId: string): Promise<Module[] | null>;
+  courseProgress(orgId: string, orgUserId: string, courseId: string): Promise<CourseProgressView | null>;
+  listDownloads(orgId: string, orgUserId: string): Promise<Download[]>;
+  getDownload(orgId: string, orgUserId: string, downloadId: string): Promise<{
+    download: Download;
+    assets: DownloadAsset[];
+  } | null>;
+  /** The paywall. Two gates, in order: an active entitlement to a published
+   *  download, then the asset actually belonging to that download — so a
+   *  student entitled to X cannot reach an asset of Y by swapping the id. */
+  downloadAssetUrl(orgId: string, orgUserId: string, downloadId: string, assetId: string): Promise<{
+    url: string;
+    filename: string;
+  } | null>;
+}
+//#endregion
+export { LearnReportServiceImpl, LearnReportServiceParams };
+//# sourceMappingURL=service.d.ts.map

package/dist/reporting/learn/service.js

@@ -0,0 +1,111 @@
+import { noopLogger } from "../../shared/logger.js";
+//#region src/reporting/learn/service.ts
+function isActivityPublished(settings) {
+	return settings?.published !== false;
+}
+var LearnReportServiceImpl = class {
+	reader;
+	content;
+	progress;
+	assets;
+	deliveryExpirySeconds;
+	logger;
+	constructor(params) {
+		this.reader = params.reader;
+		this.content = params.content;
+		this.progress = params.progress;
+		this.assets = params.assets;
+		this.deliveryExpirySeconds = params.deliveryExpirySeconds;
+		this.logger = params.logger ?? noopLogger;
+	}
+	async listCourses(orgId, orgUserId) {
+		const refs = await this.reader.activeRefs(orgId, orgUserId);
+		return (await Promise.all(refs.map((ref) => this.content.getCourse(ref.orgId, ref.contentId)))).filter((c) => c !== null && c.status === "published");
+	}
+	async getCourse(orgId, orgUserId, courseId) {
+		const ref = await this.reader.activeRef(orgId, orgUserId, courseId);
+		if (!ref) return null;
+		const course = await this.content.getCourse(ref.orgId, courseId);
+		return course && course.status === "published" ? course : null;
+	}
+	async listModules(orgId, orgUserId, courseId) {
+		const ref = await this.reader.activeRef(orgId, orgUserId, courseId);
+		if (!ref) return null;
+		return this.content.listCourseModules(ref.orgId, courseId);
+	}
+	async courseProgress(orgId, orgUserId, courseId) {
+		const ref = await this.reader.activeRef(orgId, orgUserId, courseId);
+		if (!ref) return null;
+		const ids = (await this.content.listCourseActivities(ref.orgId, courseId)).filter((a) => isActivityPublished(a.settings)).map((a) => a.id);
+		const records = await this.progress.listByTargets(ref.orgId, orgUserId, ids);
+		const activities = {};
+		const positions = {};
+		let done = 0;
+		for (const r of records) {
+			if (r.targetType !== "activity") continue;
+			activities[r.targetId] = r.completedAt ? "completed" : "in-progress";
+			if (r.completedAt) done += 1;
+			if (r.position != null) positions[r.targetId] = r.position;
+		}
+		const courseRecord = await this.progress.get(ref.orgId, {
+			orgUserId,
+			targetType: "course",
+			targetId: courseId
+		});
+		return {
+			activities,
+			percent: ids.length > 0 ? Math.round(done / ids.length * 100) : 0,
+			completed: courseRecord?.completedAt != null,
+			positions
+		};
+	}
+	async listDownloads(orgId, orgUserId) {
+		const refs = await this.reader.activeDownloadRefs(orgId, orgUserId);
+		return (await Promise.all(refs.map((ref) => this.content.getDownload(ref.orgId, ref.contentId)))).filter((d) => d !== null && d.status === "published");
+	}
+	async getDownload(orgId, orgUserId, downloadId) {
+		const ref = await this.reader.activeDownloadRef(orgId, orgUserId, downloadId);
+		if (!ref) return null;
+		const download = await this.content.getDownload(ref.orgId, downloadId);
+		if (!download || download.status !== "published") return null;
+		return {
+			download,
+			assets: await this.content.listDownloadAssets(ref.orgId, downloadId)
+		};
+	}
+	/** The paywall. Two gates, in order: an active entitlement to a published
+	*  download, then the asset actually belonging to that download — so a
+	*  student entitled to X cannot reach an asset of Y by swapping the id. */
+	async downloadAssetUrl(orgId, orgUserId, downloadId, assetId) {
+		const ref = await this.reader.activeDownloadRef(orgId, orgUserId, downloadId);
+		if (!ref) return null;
+		if (!await this.reader.downloadHasAsset(ref.orgId, downloadId, assetId)) {
+			this.logger.warn("download asset not linked", {
+				orgId,
+				downloadId,
+				assetId
+			});
+			return null;
+		}
+		const link = (await this.content.listDownloadAssets(ref.orgId, downloadId)).find((l) => l.assetId === assetId);
+		if (!link) return null;
+		const asset = await this.assets.get(ref.orgId, assetId);
+		if (!asset) return null;
+		const filename = link.displayName ?? asset.filename;
+		const ticket = await this.assets.requestDownload(ref.orgId, assetId, filename, this.deliveryExpirySeconds);
+		if (!ticket) return null;
+		this.logger.info("download asset signed", {
+			orgId,
+			downloadId,
+			assetId
+		});
+		return {
+			url: ticket.url,
+			filename
+		};
+	}
+};
+//#endregion
+export { LearnReportServiceImpl };
+
+//# sourceMappingURL=service.js.map

package/dist/reporting/learn/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","names":[],"sources":["../../../src/reporting/learn/service.ts"],"sourcesContent":["// reporting/learn — service implementation. Composes the enrollment reader\n// (which published courses the student is actively enrolled in) with the content\n// service (the Course/Module payload). Activities are filtered to published;\n// `settings.published === false` is the only draft signal (missing ⇒ published).\nimport type { ContentService } from '../../content/index.js';\nimport type { ProgressService } from '../../progress/index.js';\nimport type { AssetsService } from '../../assets/index.js';\nimport type { Course, Module, CourseProgressView, Download, DownloadAsset } from './model.js';\nimport type { LearnEntitlementReader, LearnReportService } from './ports.js';\nimport type { Logger } from '../../shared/ports.js';\nimport { noopLogger } from '../../shared/logger.js';\n\nfunction isActivityPublished(settings: unknown): boolean {\n  return (settings as { published?: boolean } | null)?.published !== false;\n}\n\nexport type LearnReportServiceParams = {\n  reader: LearnEntitlementReader;\n  content: ContentService;\n  progress: ProgressService;\n  assets: AssetsService;\n  deliveryExpirySeconds: number;\n  logger?: Logger;\n};\n\nexport class LearnReportServiceImpl implements LearnReportService {\n  private readonly reader: LearnEntitlementReader;\n  private readonly content: ContentService;\n  private readonly progress: ProgressService;\n  private readonly assets: AssetsService;\n  private readonly deliveryExpirySeconds: number;\n  private readonly logger: Logger;\n\n  constructor(params: LearnReportServiceParams) {\n    this.reader = params.reader;\n    this.content = params.content;\n    this.progress = params.progress;\n    this.assets = params.assets;\n    this.deliveryExpirySeconds = params.deliveryExpirySeconds;\n    this.logger = params.logger ?? noopLogger;\n  }\n\n  async listCourses(orgId: string, orgUserId: string): Promise<Course[]> {\n    const refs = await this.reader.activeRefs(orgId, orgUserId);\n    const courses = await Promise.all(\n      refs.map((ref) => this.content.getCourse(ref.orgId, ref.contentId)),\n    );\n    return courses.filter((c): c is Course => c !== null && c.status === 'published');\n  }\n\n  async getCourse(orgId: string, orgUserId: string, courseId: string): Promise<Course | null> {\n    const ref = await this.reader.activeRef(orgId, orgUserId, courseId);\n    if (!ref) {\n      return null;\n    }\n    const course = await this.content.getCourse(ref.orgId, courseId);\n    return course && course.status === 'published' ? course : null;\n  }\n\n  async listModules(orgId: string, orgUserId: string, courseId: string): Promise<Module[] | null> {\n    const ref = await this.reader.activeRef(orgId, orgUserId, courseId);\n    if (!ref) {\n      return null;\n    }\n    return this.content.listCourseModules(ref.orgId, courseId);\n  }\n\n  async courseProgress(\n    orgId: string,\n    orgUserId: string,\n    courseId: string,\n  ): Promise<CourseProgressView | null> {\n    const ref = await this.reader.activeRef(orgId, orgUserId, courseId);\n    if (!ref) {\n      return null;\n    }\n    const courseActivities = await this.content.listCourseActivities(ref.orgId, courseId);\n    const ids = courseActivities.filter((a) => isActivityPublished(a.settings)).map((a) => a.id);\n    const records = await this.progress.listByTargets(ref.orgId, orgUserId, ids);\n    const activities: CourseProgressView['activities'] = {};\n    const positions: CourseProgressView['positions'] = {};\n    let done = 0;\n    for (const r of records) {\n      if (r.targetType !== 'activity') {\n        continue;\n      }\n      activities[r.targetId] = r.completedAt ? 'completed' : 'in-progress';\n      if (r.completedAt) {\n        done += 1;\n      }\n      if (r.position != null) {\n        positions[r.targetId] = r.position;\n      }\n    }\n    const courseRecord = await this.progress.get(ref.orgId, {\n      orgUserId,\n      targetType: 'course',\n      targetId: courseId,\n    });\n    return {\n      activities,\n      percent: ids.length > 0 ? Math.round((done / ids.length) * 100) : 0,\n      completed: courseRecord?.completedAt != null,\n      positions,\n    };\n  }\n\n  async listDownloads(orgId: string, orgUserId: string): Promise<Download[]> {\n    const refs = await this.reader.activeDownloadRefs(orgId, orgUserId);\n    const rows = await Promise.all(\n      refs.map((ref) => this.content.getDownload(ref.orgId, ref.contentId)),\n    );\n    return rows.filter((d): d is Download => d !== null && d.status === 'published');\n  }\n\n  async getDownload(\n    orgId: string,\n    orgUserId: string,\n    downloadId: string,\n  ): Promise<{ download: Download; assets: DownloadAsset[] } | null> {\n    const ref = await this.reader.activeDownloadRef(orgId, orgUserId, downloadId);\n    if (!ref) {\n      return null;\n    }\n    const download = await this.content.getDownload(ref.orgId, downloadId);\n    if (!download || download.status !== 'published') {\n      return null;\n    }\n    const assets = await this.content.listDownloadAssets(ref.orgId, downloadId);\n    return { download, assets };\n  }\n\n  /** The paywall. Two gates, in order: an active entitlement to a published\n   *  download, then the asset actually belonging to that download — so a\n   *  student entitled to X cannot reach an asset of Y by swapping the id. */\n  async downloadAssetUrl(\n    orgId: string,\n    orgUserId: string,\n    downloadId: string,\n    assetId: string,\n  ): Promise<{ url: string; filename: string } | null> {\n    const ref = await this.reader.activeDownloadRef(orgId, orgUserId, downloadId);\n    if (!ref) {\n      return null;\n    }\n    const linked = await this.reader.downloadHasAsset(ref.orgId, downloadId, assetId);\n    if (!linked) {\n      this.logger.warn('download asset not linked', { orgId, downloadId, assetId });\n      return null;\n    }\n    const links = await this.content.listDownloadAssets(ref.orgId, downloadId);\n    const link = links.find((l) => l.assetId === assetId);\n    if (!link) {\n      return null;\n    }\n    const asset = await this.assets.get(ref.orgId, assetId);\n    if (!asset) {\n      return null;\n    }\n    const filename = link.displayName ?? asset.filename;\n    const ticket = await this.assets.requestDownload(\n      ref.orgId,\n      assetId,\n      filename,\n      this.deliveryExpirySeconds,\n    );\n    if (!ticket) {\n      return null;\n    }\n    // Never log the signed URL — it is a bearer capability.\n    this.logger.info('download asset signed', { orgId, downloadId, assetId });\n    return { url: ticket.url, filename };\n  }\n}\n"],"mappings":"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"}

package/dist/reporting/students/index.d.ts

@@ -0,0 +1,4 @@
+import { Page, Student, StudentsQuery } from "./model.js";
+import { StudentsReportRepository, StudentsReportService } from "./ports.js";
+import { StudentsReportServiceImpl } from "./service.js";
+export { type Page, type Student, type StudentsQuery, type StudentsReportRepository, type StudentsReportService, StudentsReportServiceImpl };

package/dist/reporting/students/index.js

@@ -0,0 +1,2 @@
+import { StudentsReportServiceImpl } from "./service.js";
+export { StudentsReportServiceImpl };

package/dist/reporting/students/model.d.ts

@@ -0,0 +1,31 @@
+import { OrgUserProfile, OrgUserStatus } from "../../types/schemas/organizations.js";
+import "../../types/index.js";
+//#region src/reporting/students/model.d.ts
+interface Student extends OrgUserProfile {
+  /** As typed on the invite form. `name` is the composed rendering name and
+   *  drifts once the person edits their own profile; these are what the admin
+   *  edits. Null for anyone who arrived by self-signup. */
+  firstName: string | null;
+  lastName: string | null;
+  entitlementCount: number;
+  avgProgress: number;
+  /** `invited` until they accept — the admin added them, they have not arrived. */
+  status: OrgUserStatus;
+  joinedAt: string;
+  lastActiveAt: string | null;
+}
+interface StudentsQuery {
+  page: number;
+  pageSize: number;
+  search?: string | undefined;
+  sort?: string | undefined;
+}
+interface Page<T> {
+  rows: T[];
+  total: number;
+  page: number;
+  pageSize: number;
+}
+//#endregion
+export { Page, Student, StudentsQuery };
+//# sourceMappingURL=model.d.ts.map

package/dist/reporting/students/model.js

@@ -0,0 +1 @@
+export {};

package/dist/reporting/students/ports.d.ts

@@ -0,0 +1,13 @@
+import { Page, Student, StudentsQuery } from "./model.js";
+//#region src/reporting/students/ports.d.ts
+interface StudentsReportService {
+  list(orgId: string, query: StudentsQuery): Promise<Page<Student>>;
+  get(orgId: string, id: string): Promise<Student | null>;
+}
+interface StudentsReportRepository {
+  list(orgId: string, query: StudentsQuery): Promise<Page<Student>>;
+  findById(orgId: string, id: string): Promise<Student | null>;
+}
+//#endregion
+export { StudentsReportRepository, StudentsReportService };
+//# sourceMappingURL=ports.d.ts.map

package/dist/reporting/students/ports.js

@@ -0,0 +1 @@
+export {};