@headless-lms/core 0.1.0 → 0.3.0

package/dist/organizations/types.d.ts

@@ -1,5 +1,5 @@
 import { ProvisionUserInput } from "../types/schemas/identity.js";
-import { AcceptInviteInput, AddOrgUserInput, CreateInviteInput, CreateOrgUserInput, InviteRole, NewOrganizationInput, OrgUserStatus, Organization } from "../types/schemas/organizations.js";
+import { AcceptInviteInput, AddOrgUserInput, CreateInviteInput, CreateOrgUserInput, InviteRole, NewOrganizationInput, OrgUserStatus, Organization, UpdateOrgUserInput } from "../types/schemas/organizations.js";
 import { InviteId, OrgUserId, OrganizationId } from "../types/organizations.js";
 import "../types/index.js";
 //#region src/organizations/types.d.ts
@@ -20,20 +20,11 @@ interface UnlinkOrgUserInput {
   orgExternalId: string;
   userExternalId: string;
 }
-interface UpdatePersonInput {
-  firstName?: string;
-  lastName?: string;
-  email?: string;
-}
-interface UpdateStudentInput extends UpdatePersonInput {
-  orgId: string;
-  orgUserId: string;
-}
 interface ResendStudentInviteInput {
   orgId: string;
   orgUserId: string;
   inviterUserId: string;
 }
 //#endregion
-export { type AcceptInviteInput, type AddOrgUserInput, type CreateInviteInput, type CreateOrgUserInput, CreateOrganizationInput, type InviteId, type InviteRole, LinkOrgUserInput, type NewOrganizationInput, type OrgUserId, type OrgUserStatus, type OrganizationId, type ProvisionUserInput, ResendStudentInviteInput, UnlinkOrgUserInput, UpdateOrganizationInput, UpdatePersonInput, UpdateStudentInput };
+export { type AcceptInviteInput, type AddOrgUserInput, type CreateInviteInput, type CreateOrgUserInput, CreateOrganizationInput, type InviteId, type InviteRole, LinkOrgUserInput, type NewOrganizationInput, type OrgUserId, type OrgUserStatus, type OrganizationId, type ProvisionUserInput, ResendStudentInviteInput, UnlinkOrgUserInput, type UpdateOrgUserInput, UpdateOrganizationInput };
 //# sourceMappingURL=types.d.ts.map

package/dist/progress/events.d.ts

@@ -12,6 +12,7 @@ declare const progressEvents: {
     startedAt: Date;
     position: JsonValue;
     completedAt: Date | null;
+    createdAt: Date;
     updatedAt: Date;
   }, "progress.record.started", 1>, {
     id: string;
@@ -22,8 +23,23 @@ declare const progressEvents: {
     startedAt: unknown;
     position: unknown;
     completedAt: unknown;
+    createdAt: unknown;
     updatedAt: unknown;
-  }>;
+  }, import("zod").ZodObject<{
+    orgId: import("zod").ZodString;
+    id: import("zod").ZodString;
+    createdAt: import("zod").ZodCoercedDate<unknown>;
+    updatedAt: import("zod").ZodCoercedDate<unknown>;
+    startedAt: import("zod").ZodCoercedDate<unknown>;
+    orgUserId: import("zod").ZodString;
+    targetType: import("zod").ZodEnum<{
+      course: "course";
+      activity: "activity";
+      module: "module";
+    }>;
+    targetId: import("zod").ZodString;
+    completedAt: import("zod").ZodNullable<import("zod").ZodCoercedDate<unknown>>;
+  }, import("zod/v4/core").$strip>>;
   progressCompleted: RuntimeEventDefinition<VersionedDomainEvent<{
     id: string;
     orgId: string;
@@ -33,6 +49,7 @@ declare const progressEvents: {
     startedAt: Date;
     position: JsonValue;
     completedAt: Date | null;
+    createdAt: Date;
     updatedAt: Date;
   }, "progress.record.completed", 1>, {
     id: string;
@@ -43,8 +60,23 @@ declare const progressEvents: {
     startedAt: unknown;
     position: unknown;
     completedAt: unknown;
+    createdAt: unknown;
     updatedAt: unknown;
-  }>;
+  }, import("zod").ZodObject<{
+    orgId: import("zod").ZodString;
+    id: import("zod").ZodString;
+    createdAt: import("zod").ZodCoercedDate<unknown>;
+    updatedAt: import("zod").ZodCoercedDate<unknown>;
+    startedAt: import("zod").ZodCoercedDate<unknown>;
+    orgUserId: import("zod").ZodString;
+    targetType: import("zod").ZodEnum<{
+      course: "course";
+      activity: "activity";
+      module: "module";
+    }>;
+    targetId: import("zod").ZodString;
+    completedAt: import("zod").ZodNullable<import("zod").ZodCoercedDate<unknown>>;
+  }, import("zod/v4/core").$strip>>;
 };
 type ProgressStarted = EventOf<typeof progressEvents.progressStarted>;
 type ProgressCompleted = EventOf<typeof progressEvents.progressCompleted>;

package/dist/progress/events.js

@@ -1,16 +1,29 @@
 import { progressRecordSchema } from "../types/schemas/progress.js";
 import { defineEvent } from "../shared/events.js";
 //#region src/progress/events.ts
+const publicProgressRecord = progressRecordSchema.pick({
+	id: true,
+	orgId: true,
+	orgUserId: true,
+	targetType: true,
+	targetId: true,
+	startedAt: true,
+	completedAt: true,
+	createdAt: true,
+	updatedAt: true
+}).strip();
 const progressEvents = {
 	progressStarted: defineEvent({
 		type: "progress.record.started",
 		version: 1,
-		data: progressRecordSchema
+		data: progressRecordSchema,
+		publicData: publicProgressRecord
 	}),
 	progressCompleted: defineEvent({
 		type: "progress.record.completed",
 		version: 1,
-		data: progressRecordSchema
+		data: progressRecordSchema,
+		publicData: publicProgressRecord
 	})
 };
 //#endregion

package/dist/progress/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","names":[],"sources":["../../src/progress/events.ts"],"sourcesContent":["import { progressRecordSchema } from '../types/schemas/index.js';\nimport {\n  defineEvent,\n  type EventOf,\n  type EventOfValues,\n  type NewDomainEvent,\n} from '../shared/ports.js';\n\nexport const progressEvents = {\n  progressStarted: defineEvent({\n    type: 'progress.record.started',\n    version: 1,\n    data: progressRecordSchema,\n  }),\n  progressCompleted: defineEvent({\n    type: 'progress.record.completed',\n    version: 1,\n    data: progressRecordSchema,\n  }),\n};\n\nexport type ProgressStarted = EventOf<typeof progressEvents.progressStarted>;\nexport type ProgressCompleted = EventOf<typeof progressEvents.progressCompleted>;\nexport type ProgressEvent = EventOfValues<typeof progressEvents>;\nexport type NewProgressEvent = NewDomainEvent<ProgressEvent>;\n"],"mappings":";;;AAQA,MAAa,iBAAiB;CAC5B,iBAAiB,YAAY;EAC3B,MAAM;EACN,SAAS;EACT,MAAM;CACR,CAAC;CACD,mBAAmB,YAAY;EAC7B,MAAM;EACN,SAAS;EACT,MAAM;CACR,CAAC;AACH"}
+{"version":3,"file":"events.js","names":[],"sources":["../../src/progress/events.ts"],"sourcesContent":["import { progressRecordSchema } from '../types/schemas/index.js';\nimport {\n  defineEvent,\n  type EventOf,\n  type EventOfValues,\n  type NewDomainEvent,\n} from '../shared/ports.js';\n\nconst publicProgressRecord = progressRecordSchema\n  .pick({\n    id: true,\n    orgId: true,\n    orgUserId: true,\n    targetType: true,\n    targetId: true,\n    startedAt: true,\n    completedAt: true,\n    createdAt: true,\n    updatedAt: true,\n  })\n  .strip();\n\nexport const progressEvents = {\n  progressStarted: defineEvent({\n    type: 'progress.record.started',\n    version: 1,\n    data: progressRecordSchema,\n    publicData: publicProgressRecord,\n  }),\n  progressCompleted: defineEvent({\n    type: 'progress.record.completed',\n    version: 1,\n    data: progressRecordSchema,\n    publicData: publicProgressRecord,\n  }),\n};\n\nexport type ProgressStarted = EventOf<typeof progressEvents.progressStarted>;\nexport type ProgressCompleted = EventOf<typeof progressEvents.progressCompleted>;\nexport type ProgressEvent = EventOfValues<typeof progressEvents>;\nexport type NewProgressEvent = NewDomainEvent<ProgressEvent>;\n"],"mappings":";;;AAQA,MAAM,uBAAuB,qBAC1B,KAAK;CACJ,IAAI;CACJ,OAAO;CACP,WAAW;CACX,YAAY;CACZ,UAAU;CACV,WAAW;CACX,aAAa;CACb,WAAW;CACX,WAAW;AACb,CAAC,CAAC,CACD,MAAM;AAET,MAAa,iBAAiB;CAC5B,iBAAiB,YAAY;EAC3B,MAAM;EACN,SAAS;EACT,MAAM;EACN,YAAY;CACd,CAAC;CACD,mBAAmB,YAAY;EAC7B,MAAM;EACN,SAAS;EACT,MAAM;EACN,YAAY;CACd,CAAC;AACH"}

package/dist/progress/index.d.ts

@@ -3,6 +3,6 @@ import { ProgressId } from "../types/progress.js";
 import { ProgressCompleted, ProgressEvent, ProgressStarted, progressEvents } from "./events.js";
 import "./model.js";
 import "./types.js";
-import { ProgressRepository, ProgressService, ProgressUnitOfWork } from "./ports.js";
+import { ContentAccessReader, ProgressRepository, ProgressService, ProgressUnitOfWork } from "./ports.js";
 import { ProgressServiceImpl } from "./service.js";
-export { type ProgressCompleted, type ProgressEvent, type ProgressId, type ProgressRecord, type ProgressReportItem, type ProgressRepository, type ProgressService, ProgressServiceImpl, type ProgressStarted, type ProgressTarget, type ProgressTargetType, type ProgressUnitOfWork, type ReportProgressInput, progressEvents };
+export { type ContentAccessReader, type ProgressCompleted, type ProgressEvent, type ProgressId, type ProgressRecord, type ProgressReportItem, type ProgressRepository, type ProgressService, ProgressServiceImpl, type ProgressStarted, type ProgressTarget, type ProgressTargetType, type ProgressUnitOfWork, type ReportProgressInput, progressEvents };

package/dist/progress/ports.d.ts

@@ -25,6 +25,11 @@ interface ProgressRepository {
   }): Promise<ProgressRecord[]>;
   update(orgId: string, id: string, patch: Partial<Pick<ProgressRecord, 'position' | 'completedAt'>>): Promise<ProgressRecord | null>;
 }
+/** Access is resolved by entitlements — a report is only taken from a student
+ *  who can open the course. */
+interface ContentAccessReader {
+  hasAccess(orgId: string, orgUserId: string, contentId: string): Promise<boolean>;
+}
 /** Writes that emit events run through this scope so row + outbox entry commit
  *  in one transaction. */
 interface ProgressWriteScope {
@@ -33,5 +38,5 @@ interface ProgressWriteScope {
 }
 type ProgressUnitOfWork = UnitOfWork<ProgressWriteScope>;
 //#endregion
-export { ProgressRepository, ProgressService, ProgressUnitOfWork, ProgressWriteScope };
+export { ContentAccessReader, ProgressRepository, ProgressService, ProgressUnitOfWork, ProgressWriteScope };
 //# sourceMappingURL=ports.d.ts.map

package/dist/progress/service.d.ts

@@ -1,21 +1,23 @@
 import { Logger } from "../types/ports.js";
 import { ProgressRecord, ProgressTarget, ReportProgressInput } from "../types/schemas/progress.js";
 import "../shared/ports.js";
-import { ContentService } from "../content/ports.js";
+import { CourseManagementService } from "../content/ports.js";
 import "../content/index.js";
 import "./model.js";
 import "./types.js";
-import { ProgressRepository, ProgressService, ProgressUnitOfWork } from "./ports.js";
+import { ContentAccessReader, ProgressRepository, ProgressService, ProgressUnitOfWork } from "./ports.js";
 //#region src/progress/service.d.ts
 type ProgressServiceParams = {
   repo: ProgressRepository;
-  content: ContentService;
+  content: CourseManagementService;
+  access: ContentAccessReader;
   uow: ProgressUnitOfWork;
   logger?: Logger;
 };
 declare class ProgressServiceImpl implements ProgressService {
   private readonly repo;
   private readonly content;
+  private readonly access;
   private readonly uow;
   private readonly logger;
   constructor(params: ProgressServiceParams);

package/dist/progress/service.js

@@ -1,9 +1,9 @@
 import { genId } from "../shared/id.js";
-import { noopLogger } from "../shared/logger.js";
 import { NotFoundError } from "../shared/errors.js";
+import { noopLogger } from "../shared/logger.js";
 import { progressEvents } from "./events.js";
 //#region src/progress/service.ts
-/** Mirrors reporting/learn: `settings.published === false` is the only draft signal. */
+/** Mirrors reporting/member: `settings.published === false` is the only draft signal. */
 function isActivityPublished(settings) {
 	return settings?.published !== false;
 }
@@ -39,11 +39,13 @@ function completionSatisfied(settings, claimed) {
 var ProgressServiceImpl = class {
 	repo;
 	content;
+	access;
 	uow;
 	logger;
 	constructor(params) {
 		this.repo = params.repo;
 		this.content = params.content;
+		this.access = params.access;
 		this.uow = params.uow;
 		this.logger = params.logger ?? noopLogger;
 	}
@@ -51,6 +53,8 @@ var ProgressServiceImpl = class {
 		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 course = await this.content.getCourse(orgId, courseId);
+		if (!course || course.status !== "published" || !await this.access.hasAccess(orgId, input.orgUserId, courseId)) throw new NotFoundError("Activity", input.activityId);
 		const modules = await this.content.listCourseModules(orgId, courseId);
 		const courseActivities = await this.content.listCourseActivities(orgId, courseId);
 		return this.uow.run(async (scope) => {
@@ -63,7 +67,7 @@ var ProgressServiceImpl = class {
 			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 (state.changed) 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({
@@ -98,6 +102,7 @@ var ProgressServiceImpl = class {
 			startedAt: now,
 			position: null,
 			completedAt: null,
+			createdAt: now,
 			updatedAt: now
 		});
 		if (!record) {
@@ -149,6 +154,7 @@ var ProgressServiceImpl = class {
 				startedAt: now,
 				position: null,
 				completedAt: now,
+				createdAt: now,
 				updatedAt: now
 			});
 			if (inserted) {

package/dist/progress/service.js.map

@@ -1 +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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"}
+{"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  ContentAccessReader,\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, CourseManagementService, 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/member: `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: CourseManagementService;\n  access: ContentAccessReader;\n  uow: ProgressUnitOfWork;\n  logger?: Logger;\n};\n\nexport class ProgressServiceImpl implements ProgressService {\n  private readonly repo: ProgressRepository;\n  private readonly content: CourseManagementService;\n  private readonly access: ContentAccessReader;\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.access = params.access;\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 course = await this.content.getCourse(orgId, courseId);\n    if (\n      !course ||\n      course.status !== 'published' ||\n      !(await this.access.hasAccess(orgId, input.orgUserId, courseId))\n    ) {\n      throw new NotFoundError('Activity', input.activityId);\n    }\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) {\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(progressEvents.progressCompleted.make({ orgId, data: record }));\n        await this.completeContainers(\n          orgId,\n          input,\n          courseId,\n          modules,\n          courseActivities,\n          scope,\n          events,\n        );\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      createdAt: now,\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        createdAt: now,\n        updatedAt: now,\n      });\n      if (inserted) {\n        events.push(progressEvents.progressCompleted.make({ orgId, data: inserted }));\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/reporting/admin/index.d.ts

@@ -0,0 +1,4 @@
+import { CommunityAnalytics, CommunityMember, CommunityMembersQuery, CourseActivityEngagement, CourseAnalytics, CourseEnrollmentPoint, EnrollmentPoint, OverviewStats, Page, Student, StudentAnalytics, StudentCourseProgress, StudentsQuery } from "./model.js";
+import { AdminReportRepository, AdminReportService } from "./ports.js";
+import { AdminReportServiceImpl } from "./service.js";
+export { type AdminReportRepository, type AdminReportService, AdminReportServiceImpl, type CommunityAnalytics, type CommunityMember, type CommunityMembersQuery, type CourseActivityEngagement, type CourseAnalytics, type CourseEnrollmentPoint, type EnrollmentPoint, type OverviewStats, type Page, type Student, type StudentAnalytics, type StudentCourseProgress, type StudentsQuery };

package/dist/reporting/admin/index.js

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

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

@@ -0,0 +1,108 @@
+import { OrgUserProfile, OrgUserStatus, Role } from "../../types/schemas/organizations.js";
+import "../../types/index.js";
+//#region src/reporting/admin/model.d.ts
+interface SpacePostCount {
+  spaceId: string;
+  count: number;
+}
+interface PostCommentCount {
+  postId: string;
+  count: number;
+}
+interface CommunityAnalytics {
+  memberCount: number;
+  activeMembers: number;
+  postsPerSpace: SpacePostCount[];
+  commentsPerPost: PostCommentCount[];
+  messagesSent: number;
+  flagsRaised: number;
+  flagsResolved: number;
+  grantsLapsed: number;
+  grantsRenewed: number;
+}
+interface OverviewStats {
+  publishedCourses: number;
+  draftCourses: number;
+  activeStudents: number;
+  expiringSoon: number;
+}
+interface EnrollmentPoint {
+  date: string;
+  count: number;
+}
+interface CourseActivityEngagement {
+  activityId: string;
+  title: string;
+  moduleId: string;
+  moduleTitle: string;
+  started: number;
+  completed: number;
+}
+interface CourseAnalytics {
+  enrolled: number;
+  started: number;
+  completed: number;
+  /** Mean of each cohort member's completed-activities percentage (0–100). */
+  avgProgress: number;
+  activities: CourseActivityEngagement[];
+}
+interface CourseEnrollmentPoint {
+  date: string;
+  count: number;
+}
+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 StudentCourseProgress {
+  courseId: string;
+  title: string;
+  /** Published activities in the course. */
+  totalActivities: number;
+  completedActivities: number;
+  /** 0–100, completed published activities over the total. */
+  progress: number;
+  startedAt: string | null;
+  lastActivityAt: string | null;
+  completedAt: string | null;
+}
+interface StudentAnalytics {
+  enrolled: number;
+  started: number;
+  completed: number;
+  /** Mean of the per-course progress percentages (0–100). */
+  avgProgress: number;
+  courses: StudentCourseProgress[];
+}
+interface CommunityMember extends OrgUserProfile {
+  role: Role;
+}
+interface CommunityMembersQuery {
+  page: number;
+  pageSize: number;
+  search?: string | undefined;
+}
+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 { CommunityAnalytics, CommunityMember, CommunityMembersQuery, CourseActivityEngagement, CourseAnalytics, CourseEnrollmentPoint, EnrollmentPoint, OverviewStats, Page, PostCommentCount, SpacePostCount, Student, StudentAnalytics, StudentCourseProgress, StudentsQuery };
+//# sourceMappingURL=model.d.ts.map

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

@@ -0,0 +1,27 @@
+import { CommunityAnalytics, CommunityMember, CommunityMembersQuery, CourseAnalytics, CourseEnrollmentPoint, EnrollmentPoint, OverviewStats, Page, Student, StudentAnalytics, StudentsQuery } from "./model.js";
+//#region src/reporting/admin/ports.d.ts
+interface AdminReportService {
+  overview(orgId: string): Promise<OverviewStats>;
+  enrollments(orgId: string, days: number): Promise<EnrollmentPoint[]>;
+  courseAnalytics(orgId: string, courseId: string): Promise<CourseAnalytics | null>;
+  courseEnrollments(orgId: string, courseId: string, days: number): Promise<CourseEnrollmentPoint[] | null>;
+  listStudents(orgId: string, query: StudentsQuery): Promise<Page<Student>>;
+  getStudent(orgId: string, id: string): Promise<Student | null>;
+  studentAnalytics(orgId: string, id: string): Promise<StudentAnalytics | null>;
+  communityAnalytics(orgId: string, communityId: string): Promise<CommunityAnalytics | null>;
+  communityMembers(orgId: string, communityId: string, query: CommunityMembersQuery): Promise<Page<CommunityMember> | null>;
+}
+interface AdminReportRepository {
+  overview(orgId: string): Promise<OverviewStats>;
+  enrollments(orgId: string, days: number): Promise<EnrollmentPoint[]>;
+  courseAnalytics(orgId: string, courseId: string): Promise<CourseAnalytics | null>;
+  courseEnrollments(orgId: string, courseId: string, days: number): Promise<CourseEnrollmentPoint[] | null>;
+  listStudents(orgId: string, query: StudentsQuery): Promise<Page<Student>>;
+  getStudent(orgId: string, id: string): Promise<Student | null>;
+  studentAnalytics(orgId: string, id: string): Promise<StudentAnalytics | null>;
+  communityAnalytics(orgId: string, communityId: string): Promise<CommunityAnalytics | null>;
+  communityMembers(orgId: string, communityId: string, query: CommunityMembersQuery): Promise<Page<CommunityMember> | null>;
+}
+//#endregion
+export { AdminReportRepository, AdminReportService };
+//# sourceMappingURL=ports.d.ts.map

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

@@ -0,0 +1,22 @@
+import { CommunityAnalytics, CommunityMember, CommunityMembersQuery, CourseAnalytics, CourseEnrollmentPoint, EnrollmentPoint, OverviewStats, Page, Student, StudentAnalytics, StudentsQuery } from "./model.js";
+import { AdminReportRepository, AdminReportService } from "./ports.js";
+//#region src/reporting/admin/service.d.ts
+type AdminReportServiceParams = {
+  repo: AdminReportRepository;
+};
+declare class AdminReportServiceImpl implements AdminReportService {
+  private readonly repo;
+  constructor(params: AdminReportServiceParams);
+  overview(orgId: string): Promise<OverviewStats>;
+  enrollments(orgId: string, days: number): Promise<EnrollmentPoint[]>;
+  courseAnalytics(orgId: string, courseId: string): Promise<CourseAnalytics | null>;
+  courseEnrollments(orgId: string, courseId: string, days: number): Promise<CourseEnrollmentPoint[] | null>;
+  listStudents(orgId: string, query: StudentsQuery): Promise<Page<Student>>;
+  getStudent(orgId: string, id: string): Promise<Student | null>;
+  studentAnalytics(orgId: string, id: string): Promise<StudentAnalytics | null>;
+  communityAnalytics(orgId: string, communityId: string): Promise<CommunityAnalytics | null>;
+  communityMembers(orgId: string, communityId: string, query: CommunityMembersQuery): Promise<Page<CommunityMember> | null>;
+}
+//#endregion
+export { AdminReportServiceImpl, AdminReportServiceParams };
+//# sourceMappingURL=service.d.ts.map

package/dist/reporting/admin/service.js

@@ -0,0 +1,38 @@
+//#region src/reporting/admin/service.ts
+var AdminReportServiceImpl = class {
+	repo;
+	constructor(params) {
+		this.repo = params.repo;
+	}
+	overview(orgId) {
+		return this.repo.overview(orgId);
+	}
+	enrollments(orgId, days) {
+		return this.repo.enrollments(orgId, days);
+	}
+	courseAnalytics(orgId, courseId) {
+		return this.repo.courseAnalytics(orgId, courseId);
+	}
+	courseEnrollments(orgId, courseId, days) {
+		return this.repo.courseEnrollments(orgId, courseId, days);
+	}
+	listStudents(orgId, query) {
+		return this.repo.listStudents(orgId, query);
+	}
+	getStudent(orgId, id) {
+		return this.repo.getStudent(orgId, id);
+	}
+	studentAnalytics(orgId, id) {
+		return this.repo.studentAnalytics(orgId, id);
+	}
+	communityAnalytics(orgId, communityId) {
+		return this.repo.communityAnalytics(orgId, communityId);
+	}
+	communityMembers(orgId, communityId, query) {
+		return this.repo.communityMembers(orgId, communityId, query);
+	}
+};
+//#endregion
+export { AdminReportServiceImpl };
+
+//# sourceMappingURL=service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","names":[],"sources":["../../../src/reporting/admin/service.ts"],"sourcesContent":["import type {\n  CommunityAnalytics,\n  CommunityMember,\n  CommunityMembersQuery,\n  CourseAnalytics,\n  CourseEnrollmentPoint,\n  EnrollmentPoint,\n  OverviewStats,\n  Page,\n  Student,\n  StudentAnalytics,\n  StudentsQuery,\n} from './model.js';\nimport type { AdminReportRepository, AdminReportService } from './ports.js';\n\nexport type AdminReportServiceParams = {\n  repo: AdminReportRepository;\n};\n\nexport class AdminReportServiceImpl implements AdminReportService {\n  private readonly repo: AdminReportRepository;\n\n  constructor(params: AdminReportServiceParams) {\n    this.repo = params.repo;\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  courseAnalytics(orgId: string, courseId: string): Promise<CourseAnalytics | null> {\n    return this.repo.courseAnalytics(orgId, courseId);\n  }\n\n  courseEnrollments(\n    orgId: string,\n    courseId: string,\n    days: number,\n  ): Promise<CourseEnrollmentPoint[] | null> {\n    return this.repo.courseEnrollments(orgId, courseId, days);\n  }\n\n  listStudents(orgId: string, query: StudentsQuery): Promise<Page<Student>> {\n    return this.repo.listStudents(orgId, query);\n  }\n\n  getStudent(orgId: string, id: string): Promise<Student | null> {\n    return this.repo.getStudent(orgId, id);\n  }\n\n  studentAnalytics(orgId: string, id: string): Promise<StudentAnalytics | null> {\n    return this.repo.studentAnalytics(orgId, id);\n  }\n\n  communityAnalytics(orgId: string, communityId: string): Promise<CommunityAnalytics | null> {\n    return this.repo.communityAnalytics(orgId, communityId);\n  }\n\n  communityMembers(\n    orgId: string,\n    communityId: string,\n    query: CommunityMembersQuery,\n  ): Promise<Page<CommunityMember> | null> {\n    return this.repo.communityMembers(orgId, communityId, query);\n  }\n}\n"],"mappings":";AAmBA,IAAa,yBAAb,MAAkE;CAChE;CAEA,YAAY,QAAkC;EAC5C,KAAK,OAAO,OAAO;CACrB;CAEA,SAAS,OAAuC;EAC9C,OAAO,KAAK,KAAK,SAAS,KAAK;CACjC;CAEA,YAAY,OAAe,MAA0C;EACnE,OAAO,KAAK,KAAK,YAAY,OAAO,IAAI;CAC1C;CAEA,gBAAgB,OAAe,UAAmD;EAChF,OAAO,KAAK,KAAK,gBAAgB,OAAO,QAAQ;CAClD;CAEA,kBACE,OACA,UACA,MACyC;EACzC,OAAO,KAAK,KAAK,kBAAkB,OAAO,UAAU,IAAI;CAC1D;CAEA,aAAa,OAAe,OAA8C;EACxE,OAAO,KAAK,KAAK,aAAa,OAAO,KAAK;CAC5C;CAEA,WAAW,OAAe,IAAqC;EAC7D,OAAO,KAAK,KAAK,WAAW,OAAO,EAAE;CACvC;CAEA,iBAAiB,OAAe,IAA8C;EAC5E,OAAO,KAAK,KAAK,iBAAiB,OAAO,EAAE;CAC7C;CAEA,mBAAmB,OAAe,aAAyD;EACzF,OAAO,KAAK,KAAK,mBAAmB,OAAO,WAAW;CACxD;CAEA,iBACE,OACA,aACA,OACuC;EACvC,OAAO,KAAK,KAAK,iBAAiB,OAAO,aAAa,KAAK;CAC7D;AACF"}

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

@@ -0,0 +1,5 @@
+import { CourseView, Module } from "../../types/schemas/content.js";
+import { CommunityHome, CommunityHomeSpace, CourseProgressView, DirectoryEntry, DirectoryQuery, DirectoryRow, LockedCommunitySpace, NotificationView, NotificationsView, OpenCommunitySpace } from "./model.js";
+import { MemberReportRepository, MemberReportService } from "./ports.js";
+import { MemberReportServiceImpl } from "./service.js";
+export { type CommunityHome, type CommunityHomeSpace, type CourseProgressView, type CourseView, type DirectoryEntry, type DirectoryQuery, type DirectoryRow, type LockedCommunitySpace, type MemberReportRepository, type MemberReportService, MemberReportServiceImpl, type Module, type NotificationView, type NotificationsView, type OpenCommunitySpace };

package/dist/reporting/member/index.js

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