@headless-lms/core 0.2.0 → 0.4.0

package/dist/reporting/member/service.js

@@ -0,0 +1,364 @@
+import { isStaffRole } from "../../organizations/roles.js";
+import { channelOrder } from "../../shared/notification-categories.js";
+import { seesSpace } from "../../entitlements/rules.js";
+import { resolveChannels } from "../../shared/notification-settings.js";
+//#region src/reporting/member/service.ts
+function refKey(ref) {
+	return `${ref.type}:${ref.id}`;
+}
+function itemView(ref, titles) {
+	const found = ref ? titles[refKey(ref)] : void 0;
+	if (!ref || !found) return null;
+	return found.excerpt !== void 0 ? {
+		type: ref.type,
+		id: ref.id,
+		excerpt: found.excerpt
+	} : {
+		type: ref.type,
+		id: ref.id,
+		title: found.title
+	};
+}
+function isActivityPublished(settings) {
+	return settings?.published !== false;
+}
+var MemberReportServiceImpl = class {
+	repo;
+	content;
+	progress;
+	files;
+	fileUrls;
+	access;
+	notificationList;
+	titles;
+	subscriptions;
+	notificationCategories;
+	notificationSettings;
+	channels;
+	constructor(params) {
+		this.repo = params.repo;
+		this.content = params.content;
+		this.progress = params.progress;
+		this.files = params.files;
+		this.fileUrls = params.fileUrls;
+		this.access = params.access;
+		this.notificationList = params.notifications;
+		this.titles = params.titles;
+		this.subscriptions = params.subscriptions;
+		this.notificationCategories = params.notificationCategories;
+		this.notificationSettings = params.notificationSettings;
+		this.channels = params.channels;
+	}
+	async communityNotificationSettings(orgId, actor, userId, communityId) {
+		if (!await this.access.isCommunityMember(orgId, actor, communityId)) return null;
+		const [list, settings, spaceIds, spaces, community] = await Promise.all([
+			this.notificationCategories.community.get(orgId, communityId),
+			this.notificationSettings.get(orgId, userId, { communityId }),
+			this.access.openSpaceIds(orgId, actor, communityId),
+			this.content.listSpaces(orgId, communityId),
+			this.content.getCommunity(orgId, communityId)
+		]);
+		const open = new Set(spaceIds);
+		return {
+			communityId,
+			digest: community?.settings.digest ?? null,
+			categories: this.settingsView(list.categories, settings, spaces.filter((space) => open.has(space.id)).map((space) => ({
+				spaceId: space.id,
+				name: space.name
+			})))
+		};
+	}
+	async orgNotificationSettings(orgId, userId) {
+		const [list, settings] = await Promise.all([this.notificationCategories.org.get(orgId, orgId), this.notificationSettings.get(orgId, userId, "org")]);
+		return { categories: this.settingsView(list.categories, settings, []) };
+	}
+	settingsView(categories, settings, spaces) {
+		const configured = channelOrder(this.channels.list());
+		const channelsAt = (category, spaceId) => {
+			const withoutLevel = settings.filter((setting) => setting.category !== category.key || setting.spaceId !== spaceId);
+			const fallback = new Map(resolveChannels(category, withoutLevel, spaceId, configured).map((resolved) => [resolved.channel, resolved.enabled]));
+			return resolveChannels(category, settings, spaceId, configured).map((resolved) => ({
+				...resolved,
+				default: fallback.get(resolved.channel) ?? resolved.enabled
+			}));
+		};
+		return categories.map((category) => {
+			const perSpace = category.perSpace === true;
+			const view = {
+				key: category.key,
+				perSpace,
+				channels: channelsAt(category, null)
+			};
+			if (perSpace) view.spaces = spaces.map(({ spaceId, name }) => ({
+				spaceId,
+				name,
+				channels: channelsAt(category, spaceId)
+			}));
+			return view;
+		});
+	}
+	async notifications(orgId, actor, userId, filter, page) {
+		const listed = await this.notificationList.list(orgId, userId, filter, page);
+		return {
+			rows: await this.describeNotifications(orgId, actor, listed.items),
+			total: listed.total,
+			page: page.page,
+			pageSize: page.pageSize,
+			unreadCount: listed.unreadCount
+		};
+	}
+	async notification(orgId, actor, userId, notificationId) {
+		const found = await this.notificationList.get(orgId, userId, notificationId);
+		if (!found) return null;
+		const [view] = await this.describeNotifications(orgId, actor, [found]);
+		return view ?? null;
+	}
+	async notificationUnreadCounts(orgId, actor, userId) {
+		const communityIds = await this.access.openCommunityIds(orgId, actor);
+		return this.notificationList.unreadCounts(orgId, userId, communityIds);
+	}
+	async describeNotifications(orgId, actor, rows) {
+		const refs = rows.flatMap((row) => [
+			...row.subject ? [row.subject] : [],
+			...row.parent ? [row.parent] : [],
+			...row.communityId ? [{
+				type: "community",
+				id: row.communityId
+			}] : [],
+			...row.spaceId ? [{
+				type: "space",
+				id: row.spaceId
+			}] : []
+		]);
+		const actorIds = [...new Set(rows.flatMap((row) => row.actorOrgUserId ?? []))];
+		const [people, discussionTitles, contentTitles] = await Promise.all([
+			this.repo.people(orgId, actorIds),
+			this.titles.discussion.titlesFor(orgId, actor, refs),
+			this.titles.content.titlesFor(orgId, actor, refs)
+		]);
+		const titles = {
+			...contentTitles,
+			...discussionTitles
+		};
+		const personById = new Map(people.map((person) => [person.orgUserId, person]));
+		return rows.map((row) => {
+			const person = row.actorOrgUserId ? personById.get(row.actorOrgUserId) : void 0;
+			const community = row.communityId ? titles[`community:${row.communityId}`] : void 0;
+			const space = row.spaceId ? titles[`space:${row.spaceId}`] : void 0;
+			return {
+				id: row.id,
+				type: row.type,
+				scope: row.scope,
+				reasons: row.reasons,
+				matchedReason: row.matchedReason,
+				category: row.category,
+				display: row.display,
+				community: row.communityId && community ? {
+					id: row.communityId,
+					title: community.title
+				} : null,
+				space: row.spaceId && space ? {
+					id: row.spaceId,
+					name: space.title
+				} : null,
+				actor: person ? {
+					orgUserId: person.orgUserId,
+					name: person.displayName,
+					imageUrl: person.imageAssetId ? this.fileUrls.personImage(person.orgUserId) : null
+				} : null,
+				subject: itemView(row.subject, titles),
+				parent: itemView(row.parent, titles),
+				createdAt: row.createdAt,
+				readAt: row.readAt
+			};
+		});
+	}
+	async listCourses(orgId, orgUserId) {
+		const ids = await this.access.listAccessibleContent(orgId, orgUserId, "course");
+		return (await Promise.all(ids.map((id) => this.content.getCourse(orgId, id)))).filter((c) => c !== null && c.status === "published");
+	}
+	async getCourse(orgId, orgUserId, courseId) {
+		if (!await this.access.hasAccess(orgId, orgUserId, courseId)) return null;
+		const course = await this.content.getCourse(orgId, courseId);
+		return course && course.status === "published" ? course : null;
+	}
+	async listModules(orgId, orgUserId, courseId) {
+		if (!await this.getCourse(orgId, orgUserId, courseId)) return null;
+		return this.content.listCourseModules(orgId, courseId);
+	}
+	async listActivities(orgId, orgUserId, courseId) {
+		if (!await this.getCourse(orgId, orgUserId, courseId)) return null;
+		return (await this.content.listCourseActivityViews(orgId, courseId)).filter((a) => isActivityPublished(a.settings));
+	}
+	async courseProgress(orgId, orgUserId, courseId) {
+		if (!await this.getCourse(orgId, orgUserId, courseId)) return null;
+		const ids = (await this.content.listCourseActivities(orgId, courseId)).filter((a) => isActivityPublished(a.settings)).map((a) => a.id);
+		const records = await this.progress.listByTargets(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(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 ids = await this.access.listAccessibleContent(orgId, orgUserId, "download");
+		return (await Promise.all(ids.map((id) => this.content.getDownload(orgId, id)))).filter((d) => d !== null && d.status === "published");
+	}
+	async getDownload(orgId, orgUserId, downloadId) {
+		if (!await this.access.hasAccess(orgId, orgUserId, downloadId)) return null;
+		const download = await this.content.getDownload(orgId, downloadId);
+		if (!download || download.status !== "published") return null;
+		return {
+			download,
+			assets: await this.content.listDownloadAssets(orgId, downloadId)
+		};
+	}
+	async thumbnailFile(orgId, actor, owner, id) {
+		const item = owner === "course" ? await this.content.getCourse(orgId, id) : owner === "download" ? await this.content.getDownload(orgId, id) : await this.content.getCommunity(orgId, id);
+		if (!item?.thumbnailAssetId || item.status !== "published" && !isStaffRole(actor.role)) return null;
+		return this.files.signFile(orgId, item.thumbnailAssetId);
+	}
+	async activityFile(orgId, actor, activityId, assetId) {
+		const activity = await this.content.getActivity(orgId, activityId);
+		if (!activity) return null;
+		if (!isStaffRole(actor.role)) {
+			if (!isActivityPublished(activity.settings) || !await this.getCourse(orgId, actor.id, activity.courseId)) return null;
+		}
+		if (!(await this.content.listCourseActivityAssets(orgId, activity.courseId)).some((link) => link.activityId === activityId && link.assetId === assetId)) return null;
+		return this.files.signFile(orgId, assetId);
+	}
+	async downloadFile(orgId, actor, downloadId, assetId) {
+		if (!isStaffRole(actor.role) && !await this.getDownload(orgId, actor.id, downloadId)) return null;
+		const file = (await this.content.listDownloadAssets(orgId, downloadId)).find((f) => f.assetId === assetId);
+		if (!file) return null;
+		return this.files.signFile(orgId, assetId, { saveAs: file.displayName ?? file.filename });
+	}
+	async personImage(orgId, orgUserId) {
+		const [person] = await this.repo.people(orgId, [orgUserId]);
+		if (!person?.imageAssetId) return null;
+		return this.files.signFile(orgId, person.imageAssetId);
+	}
+	async directory(orgId, actor, communityId, query) {
+		if (!await this.access.isCommunityMember(orgId, actor, communityId)) return null;
+		if (!await this.content.getCommunity(orgId, communityId)) return null;
+		const page = await this.repo.directory(orgId, communityId, query);
+		return {
+			...page,
+			rows: page.rows.map((row) => ({
+				...row,
+				imageUrl: row.imageAssetId ? this.fileUrls.personImage(row.orgUserId) : null
+			}))
+		};
+	}
+	async communityHome(orgId, actor, communityId) {
+		if (!await this.access.isCommunityMember(orgId, actor, communityId)) return null;
+		const community = await this.content.getCommunity(orgId, communityId);
+		if (!community) return null;
+		const spaces = await this.content.listSpaces(orgId, communityId);
+		return {
+			communityId,
+			title: community.title,
+			description: community.description,
+			thumbnailUrl: community.thumbnailUrl,
+			dm: community.settings.dm,
+			spaces: await this.homeSpaces(orgId, actor, communityId, spaces)
+		};
+	}
+	async communitySpace(orgId, actor, communityId, spaceId) {
+		if (!await this.access.isCommunityMember(orgId, actor, communityId)) return null;
+		const space = await this.content.getSpace(orgId, spaceId);
+		if (!space || space.communityId !== communityId) return null;
+		const [view] = await this.homeSpaces(orgId, actor, communityId, [space]);
+		return view ?? null;
+	}
+	async homeSpaces(orgId, actor, communityId, spaces) {
+		const [openIds, counts, standings, subscribed] = await Promise.all([
+			this.access.openSpaceIds(orgId, actor, communityId),
+			this.repo.spaceMemberCounts(orgId, communityId),
+			this.access.spaceStandings(orgId, actor, communityId),
+			this.subscriptions.viewerSubscriptions(orgId, actor.id, "space", spaces.map((space) => space.id), /* @__PURE__ */ new Date())
+		]);
+		const open = new Set(openIds);
+		const seen = spaces.filter((space) => seesSpace(actor.role, space.accessRule, standings[space.id]));
+		return Promise.all(seen.map(async (space) => {
+			const memberCount = counts[space.id] ?? 0;
+			const base = {
+				id: space.id,
+				name: space.name,
+				memberCount,
+				accessRule: space.accessRule,
+				standing: standingOf(space, open.has(space.id), memberCount, standings[space.id])
+			};
+			if (!open.has(space.id)) return {
+				...base,
+				locked: true
+			};
+			return {
+				...base,
+				locked: false,
+				description: space.description,
+				capacity: space.capacity,
+				settings: space.settings,
+				topics: space.topics.map((topic) => ({
+					id: topic.id,
+					name: topic.name
+				})),
+				links: await this.linkViews(orgId, actor, space.links),
+				subscription: subscribed[space.id] ?? null
+			};
+		}));
+	}
+	async linkViews(orgId, actor, links) {
+		const shown = (status) => status === "published" || isStaffRole(actor.role);
+		return (await Promise.all(links.map(async (link) => {
+			const course = await this.content.getCourse(orgId, link.contentId);
+			if (course) return shown(course.status) ? {
+				id: link.id,
+				contentId: link.contentId,
+				type: "course",
+				title: course.title
+			} : null;
+			const download = await this.content.getDownload(orgId, link.contentId);
+			if (download) return shown(download.status) ? {
+				id: link.id,
+				contentId: link.contentId,
+				type: "download",
+				title: download.title
+			} : null;
+			const community = await this.content.getCommunity(orgId, link.contentId);
+			if (community) return shown(community.status) ? {
+				id: link.id,
+				contentId: link.contentId,
+				type: "community",
+				title: community.title
+			} : null;
+			return null;
+		}))).filter((view) => view !== null);
+	}
+};
+function standingOf(space, open, memberCount, status) {
+	if (space.accessRule === "all_members" || open && status !== "active") return "open";
+	if (status === "active") return "member";
+	if (status === "requested" || status === "invited") return status;
+	if (space.capacity !== null && memberCount >= space.capacity) return "full";
+	return "none";
+}
+//#endregion
+export { MemberReportServiceImpl };
+
+//# sourceMappingURL=service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","names":[],"sources":["../../../src/reporting/member/service.ts"],"sourcesContent":["import { type ContentServicePort, type SpaceDetail } from '../../content/index.js';\nimport { seesSpace, type EntitlementsService, type SpaceMember } from '../../entitlements/index.js';\nimport type { ProgressService } from '../../progress/index.js';\nimport type { AssetFiles, FileUrls } from '../../assets/index.js';\nimport { isStaffRole } from '../../organizations/index.js';\nimport type {\n  ItemTitles as DiscussionItemTitles,\n  SubscriptionService,\n} from '../../discussion/index.js';\nimport type { ItemTitles as ContentItemTitles } from '../../content/index.js';\nimport type { NotificationSettingsService } from '../../identity/index.js';\nimport type { ListedNotification, NotificationsService } from '../../automations/index.js';\nimport type { ChannelRegistry, NotificationCategoryService } from '../../shared/ports.js';\nimport { resolveChannels } from '../../shared/notification-settings.js';\nimport { channelOrder } from '../../shared/notification-categories.js';\nimport type {\n  NotificationCategory,\n  NotificationFilter,\n  StoredSetting,\n  SubjectRef,\n} from '../../types/index.js';\nimport type { Actor } from '../../shared/actor.js';\nimport type { Page } from '../../types/index.js';\nimport type {\n  ActivityView,\n  CommunityHome,\n  CommunityHomeLink,\n  CommunityHomeSpace,\n  CourseProgressView,\n  CourseView,\n  DirectoryEntry,\n  DirectoryQuery,\n  DownloadFile,\n  DownloadView,\n  Module,\n  NotificationItemView,\n  NotificationView,\n  NotificationsView,\n  NotificationUnreadCounts,\n  CommunityNotificationSettingsView,\n  NotificationSettingsCategoryView,\n  OrgNotificationSettingsView,\n  SettingsChannelView,\n} from './model.js';\nimport type { MemberReportRepository, MemberReportService } from './ports.js';\n\nfunction refKey(ref: SubjectRef): string {\n  return `${ref.type}:${ref.id}`;\n}\n\nfunction itemView(\n  ref: SubjectRef | null,\n  titles: Record<string, { title: string; excerpt?: string }>,\n): NotificationItemView | null {\n  const found = ref ? titles[refKey(ref)] : undefined;\n  if (!ref || !found) {\n    return null;\n  }\n  return found.excerpt !== undefined\n    ? { type: ref.type, id: ref.id, excerpt: found.excerpt }\n    : { type: ref.type, id: ref.id, title: found.title };\n}\n\nfunction isActivityPublished(settings: unknown): boolean {\n  return (settings as { published?: boolean } | null)?.published !== false;\n}\n\ntype MemberAccess = Pick<\n  EntitlementsService,\n  | 'isCommunityMember'\n  | 'openSpaceIds'\n  | 'spaceStandings'\n  | 'hasAccess'\n  | 'listAccessibleContent'\n  | 'openCommunityIds'\n>;\n\nexport type MemberReportServiceParams = {\n  repo: MemberReportRepository;\n  content: ContentServicePort;\n  progress: ProgressService;\n  files: Pick<AssetFiles, 'signFile'>;\n  fileUrls: FileUrls;\n  access: MemberAccess;\n  notifications: Pick<NotificationsService, 'list' | 'get' | 'unreadCounts'>;\n  titles: { discussion: DiscussionItemTitles; content: ContentItemTitles };\n  subscriptions: Pick<SubscriptionService, 'viewerSubscriptions'>;\n  notificationCategories: {\n    community: Pick<NotificationCategoryService, 'get'>;\n    org: Pick<NotificationCategoryService, 'get'>;\n  };\n  notificationSettings: Pick<NotificationSettingsService, 'get'>;\n  channels: Pick<ChannelRegistry, 'list'>;\n};\n\nexport class MemberReportServiceImpl implements MemberReportService {\n  private readonly repo: MemberReportRepository;\n  private readonly content: ContentServicePort;\n  private readonly progress: ProgressService;\n  private readonly files: Pick<AssetFiles, 'signFile'>;\n  private readonly fileUrls: FileUrls;\n  private readonly access: MemberAccess;\n  private readonly notificationList: Pick<NotificationsService, 'list' | 'get' | 'unreadCounts'>;\n  private readonly titles: MemberReportServiceParams['titles'];\n  private readonly subscriptions: Pick<SubscriptionService, 'viewerSubscriptions'>;\n  private readonly notificationCategories: MemberReportServiceParams['notificationCategories'];\n  private readonly notificationSettings: Pick<NotificationSettingsService, 'get'>;\n  private readonly channels: Pick<ChannelRegistry, 'list'>;\n\n  constructor(params: MemberReportServiceParams) {\n    this.repo = params.repo;\n    this.content = params.content;\n    this.progress = params.progress;\n    this.files = params.files;\n    this.fileUrls = params.fileUrls;\n    this.access = params.access;\n    this.notificationList = params.notifications;\n    this.titles = params.titles;\n    this.subscriptions = params.subscriptions;\n    this.notificationCategories = params.notificationCategories;\n    this.notificationSettings = params.notificationSettings;\n    this.channels = params.channels;\n  }\n\n  async communityNotificationSettings(\n    orgId: string,\n    actor: Actor,\n    userId: string,\n    communityId: string,\n  ): Promise<CommunityNotificationSettingsView | null> {\n    if (!(await this.access.isCommunityMember(orgId, actor, communityId))) {\n      return null;\n    }\n    const [list, settings, spaceIds, spaces, community] = await Promise.all([\n      this.notificationCategories.community.get(orgId, communityId),\n      this.notificationSettings.get(orgId, userId, { communityId }),\n      this.access.openSpaceIds(orgId, actor, communityId),\n      this.content.listSpaces(orgId, communityId),\n      this.content.getCommunity(orgId, communityId),\n    ]);\n    const open = new Set(spaceIds);\n    return {\n      communityId,\n      digest: community?.settings.digest ?? null,\n      categories: this.settingsView(\n        list.categories,\n        settings,\n        spaces\n          .filter((space) => open.has(space.id))\n          .map((space) => ({ spaceId: space.id, name: space.name })),\n      ),\n    };\n  }\n\n  async orgNotificationSettings(\n    orgId: string,\n    userId: string,\n  ): Promise<OrgNotificationSettingsView> {\n    const [list, settings] = await Promise.all([\n      this.notificationCategories.org.get(orgId, orgId),\n      this.notificationSettings.get(orgId, userId, 'org'),\n    ]);\n    return { categories: this.settingsView(list.categories, settings, []) };\n  }\n\n  private settingsView(\n    categories: NotificationCategory[],\n    settings: StoredSetting[],\n    spaces: { spaceId: string; name: string }[],\n  ): NotificationSettingsCategoryView[] {\n    const configured = channelOrder(this.channels.list());\n    const channelsAt = (\n      category: NotificationCategory,\n      spaceId: string | null,\n    ): SettingsChannelView[] => {\n      const withoutLevel = settings.filter(\n        (setting) => setting.category !== category.key || setting.spaceId !== spaceId,\n      );\n      const fallback = new Map(\n        resolveChannels(category, withoutLevel, spaceId, configured).map((resolved) => [\n          resolved.channel,\n          resolved.enabled,\n        ]),\n      );\n      return resolveChannels(category, settings, spaceId, configured).map((resolved) => ({\n        ...resolved,\n        default: fallback.get(resolved.channel) ?? resolved.enabled,\n      }));\n    };\n    return categories.map((category) => {\n      const perSpace = category.perSpace === true;\n      const view: NotificationSettingsCategoryView = {\n        key: category.key,\n        perSpace,\n        channels: channelsAt(category, null),\n      };\n      if (perSpace) {\n        view.spaces = spaces.map(({ spaceId, name }) => ({\n          spaceId,\n          name,\n          channels: channelsAt(category, spaceId),\n        }));\n      }\n      return view;\n    });\n  }\n\n  async notifications(\n    orgId: string,\n    actor: Actor,\n    userId: string,\n    filter: NotificationFilter,\n    page: { page: number; pageSize: number },\n  ): Promise<NotificationsView> {\n    const listed = await this.notificationList.list(orgId, userId, filter, page);\n    return {\n      rows: await this.describeNotifications(orgId, actor, listed.items),\n      total: listed.total,\n      page: page.page,\n      pageSize: page.pageSize,\n      unreadCount: listed.unreadCount,\n    };\n  }\n\n  async notification(\n    orgId: string,\n    actor: Actor,\n    userId: string,\n    notificationId: string,\n  ): Promise<NotificationView | null> {\n    const found = await this.notificationList.get(orgId, userId, notificationId);\n    if (!found) {\n      return null;\n    }\n    const [view] = await this.describeNotifications(orgId, actor, [found]);\n    return view ?? null;\n  }\n\n  async notificationUnreadCounts(\n    orgId: string,\n    actor: Actor,\n    userId: string,\n  ): Promise<NotificationUnreadCounts> {\n    const communityIds = await this.access.openCommunityIds(orgId, actor);\n    return this.notificationList.unreadCounts(orgId, userId, communityIds);\n  }\n\n  private async describeNotifications(\n    orgId: string,\n    actor: Actor,\n    rows: ListedNotification[],\n  ): Promise<NotificationView[]> {\n    const refs = rows.flatMap((row) => [\n      ...(row.subject ? [row.subject] : []),\n      ...(row.parent ? [row.parent] : []),\n      ...(row.communityId ? [{ type: 'community' as const, id: row.communityId }] : []),\n      ...(row.spaceId ? [{ type: 'space' as const, id: row.spaceId }] : []),\n    ]);\n    const actorIds = [...new Set(rows.flatMap((row) => row.actorOrgUserId ?? []))];\n    const [people, discussionTitles, contentTitles] = await Promise.all([\n      this.repo.people(orgId, actorIds),\n      this.titles.discussion.titlesFor(orgId, actor, refs),\n      this.titles.content.titlesFor(orgId, actor, refs),\n    ]);\n    const titles = { ...contentTitles, ...discussionTitles };\n    const personById = new Map(people.map((person) => [person.orgUserId, person]));\n    return rows.map((row) => {\n      const person = row.actorOrgUserId ? personById.get(row.actorOrgUserId) : undefined;\n      const community = row.communityId ? titles[`community:${row.communityId}`] : undefined;\n      const space = row.spaceId ? titles[`space:${row.spaceId}`] : undefined;\n      return {\n        id: row.id,\n        type: row.type,\n        scope: row.scope,\n        reasons: row.reasons,\n        matchedReason: row.matchedReason,\n        category: row.category,\n        display: row.display,\n        community:\n          row.communityId && community ? { id: row.communityId, title: community.title } : null,\n        space: row.spaceId && space ? { id: row.spaceId, name: space.title } : null,\n        actor: person\n          ? {\n              orgUserId: person.orgUserId,\n              name: person.displayName,\n              imageUrl: person.imageAssetId ? this.fileUrls.personImage(person.orgUserId) : null,\n            }\n          : null,\n        subject: itemView(row.subject, titles),\n        parent: itemView(row.parent, titles),\n        createdAt: row.createdAt,\n        readAt: row.readAt,\n      };\n    });\n  }\n\n  async listCourses(orgId: string, orgUserId: string): Promise<CourseView[]> {\n    const ids = await this.access.listAccessibleContent(orgId, orgUserId, 'course');\n    const courses = await Promise.all(ids.map((id) => this.content.getCourse(orgId, id)));\n    return courses.filter((c): c is CourseView => c !== null && c.status === 'published');\n  }\n\n  async getCourse(orgId: string, orgUserId: string, courseId: string): Promise<CourseView | null> {\n    if (!(await this.access.hasAccess(orgId, orgUserId, courseId))) {\n      return null;\n    }\n    const course = await this.content.getCourse(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    if (!(await this.getCourse(orgId, orgUserId, courseId))) {\n      return null;\n    }\n    return this.content.listCourseModules(orgId, courseId);\n  }\n\n  async listActivities(\n    orgId: string,\n    orgUserId: string,\n    courseId: string,\n  ): Promise<ActivityView[] | null> {\n    if (!(await this.getCourse(orgId, orgUserId, courseId))) {\n      return null;\n    }\n    const activities = await this.content.listCourseActivityViews(orgId, courseId);\n    return activities.filter((a) => isActivityPublished(a.settings));\n  }\n\n  async courseProgress(\n    orgId: string,\n    orgUserId: string,\n    courseId: string,\n  ): Promise<CourseProgressView | null> {\n    if (!(await this.getCourse(orgId, orgUserId, courseId))) {\n      return null;\n    }\n    const courseActivities = await this.content.listCourseActivities(orgId, courseId);\n    const ids = courseActivities.filter((a) => isActivityPublished(a.settings)).map((a) => a.id);\n    const records = await this.progress.listByTargets(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(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<DownloadView[]> {\n    const ids = await this.access.listAccessibleContent(orgId, orgUserId, 'download');\n    const rows = await Promise.all(ids.map((id) => this.content.getDownload(orgId, id)));\n    return rows.filter((d): d is DownloadView => d !== null && d.status === 'published');\n  }\n\n  async getDownload(\n    orgId: string,\n    orgUserId: string,\n    downloadId: string,\n  ): Promise<{ download: DownloadView; assets: DownloadFile[] } | null> {\n    if (!(await this.access.hasAccess(orgId, orgUserId, downloadId))) {\n      return null;\n    }\n    const download = await this.content.getDownload(orgId, downloadId);\n    if (!download || download.status !== 'published') {\n      return null;\n    }\n    const assets = await this.content.listDownloadAssets(orgId, downloadId);\n    return { download, assets };\n  }\n\n  async thumbnailFile(\n    orgId: string,\n    actor: Actor,\n    owner: 'course' | 'download' | 'community',\n    id: string,\n  ): Promise<string | null> {\n    const item =\n      owner === 'course'\n        ? await this.content.getCourse(orgId, id)\n        : owner === 'download'\n          ? await this.content.getDownload(orgId, id)\n          : await this.content.getCommunity(orgId, id);\n    if (!item?.thumbnailAssetId || (item.status !== 'published' && !isStaffRole(actor.role))) {\n      return null;\n    }\n    return this.files.signFile(orgId, item.thumbnailAssetId);\n  }\n\n  async activityFile(\n    orgId: string,\n    actor: Actor,\n    activityId: string,\n    assetId: string,\n  ): Promise<string | null> {\n    const activity = await this.content.getActivity(orgId, activityId);\n    if (!activity) {\n      return null;\n    }\n    if (!isStaffRole(actor.role)) {\n      if (\n        !isActivityPublished(activity.settings) ||\n        !(await this.getCourse(orgId, actor.id, activity.courseId))\n      ) {\n        return null;\n      }\n    }\n    const links = await this.content.listCourseActivityAssets(orgId, activity.courseId);\n    if (!links.some((link) => link.activityId === activityId && link.assetId === assetId)) {\n      return null;\n    }\n    return this.files.signFile(orgId, assetId);\n  }\n\n  async downloadFile(\n    orgId: string,\n    actor: Actor,\n    downloadId: string,\n    assetId: string,\n  ): Promise<string | null> {\n    if (!isStaffRole(actor.role) && !(await this.getDownload(orgId, actor.id, downloadId))) {\n      return null;\n    }\n    const files = await this.content.listDownloadAssets(orgId, downloadId);\n    const file = files.find((f) => f.assetId === assetId);\n    if (!file) {\n      return null;\n    }\n    return this.files.signFile(orgId, assetId, { saveAs: file.displayName ?? file.filename });\n  }\n\n  async personImage(orgId: string, orgUserId: string): Promise<string | null> {\n    const [person] = await this.repo.people(orgId, [orgUserId]);\n    if (!person?.imageAssetId) {\n      return null;\n    }\n    return this.files.signFile(orgId, person.imageAssetId);\n  }\n\n  async directory(\n    orgId: string,\n    actor: Actor,\n    communityId: string,\n    query: DirectoryQuery,\n  ): Promise<Page<DirectoryEntry> | null> {\n    if (!(await this.access.isCommunityMember(orgId, actor, communityId))) {\n      return null;\n    }\n    const community = await this.content.getCommunity(orgId, communityId);\n    if (!community) {\n      return null;\n    }\n    const page = await this.repo.directory(orgId, communityId, query);\n    return {\n      ...page,\n      rows: page.rows.map((row) => ({\n        ...row,\n        imageUrl: row.imageAssetId ? this.fileUrls.personImage(row.orgUserId) : null,\n      })),\n    };\n  }\n\n  async communityHome(\n    orgId: string,\n    actor: Actor,\n    communityId: string,\n  ): Promise<CommunityHome | null> {\n    if (!(await this.access.isCommunityMember(orgId, actor, communityId))) {\n      return null;\n    }\n    const community = await this.content.getCommunity(orgId, communityId);\n    if (!community) {\n      return null;\n    }\n    const spaces = await this.content.listSpaces(orgId, communityId);\n    return {\n      communityId,\n      title: community.title,\n      description: community.description,\n      thumbnailUrl: community.thumbnailUrl,\n      dm: community.settings.dm,\n      spaces: await this.homeSpaces(orgId, actor, communityId, spaces),\n    };\n  }\n\n  async communitySpace(\n    orgId: string,\n    actor: Actor,\n    communityId: string,\n    spaceId: string,\n  ): Promise<CommunityHomeSpace | null> {\n    if (!(await this.access.isCommunityMember(orgId, actor, communityId))) {\n      return null;\n    }\n    const space = await this.content.getSpace(orgId, spaceId);\n    if (!space || space.communityId !== communityId) {\n      return null;\n    }\n    const [view] = await this.homeSpaces(orgId, actor, communityId, [space]);\n    return view ?? null;\n  }\n\n  private async homeSpaces(\n    orgId: string,\n    actor: Actor,\n    communityId: string,\n    spaces: SpaceDetail[],\n  ): Promise<CommunityHomeSpace[]> {\n    const [openIds, counts, standings, subscribed] = await Promise.all([\n      this.access.openSpaceIds(orgId, actor, communityId),\n      this.repo.spaceMemberCounts(orgId, communityId),\n      this.access.spaceStandings(orgId, actor, communityId),\n      this.subscriptions.viewerSubscriptions(\n        orgId,\n        actor.id,\n        'space',\n        spaces.map((space) => space.id),\n        new Date(),\n      ),\n    ]);\n    const open = new Set(openIds);\n    const seen = spaces.filter((space) =>\n      seesSpace(actor.role, space.accessRule, standings[space.id]),\n    );\n    return Promise.all(\n      seen.map(async (space): Promise<CommunityHomeSpace> => {\n        const memberCount = counts[space.id] ?? 0;\n        const base = {\n          id: space.id,\n          name: space.name,\n          memberCount,\n          accessRule: space.accessRule,\n          standing: standingOf(space, open.has(space.id), memberCount, standings[space.id]),\n        };\n        if (!open.has(space.id)) {\n          return { ...base, locked: true };\n        }\n        return {\n          ...base,\n          locked: false,\n          description: space.description,\n          capacity: space.capacity,\n          settings: space.settings,\n          topics: space.topics.map((topic) => ({ id: topic.id, name: topic.name })),\n          links: await this.linkViews(orgId, actor, space.links),\n          subscription: subscribed[space.id] ?? null,\n        };\n      }),\n    );\n  }\n\n  private async linkViews(\n    orgId: string,\n    actor: Actor,\n    links: SpaceDetail['links'],\n  ): Promise<CommunityHomeLink[]> {\n    const shown = (status: string) => status === 'published' || isStaffRole(actor.role);\n    const views = await Promise.all(\n      links.map(async (link): Promise<CommunityHomeLink | null> => {\n        const course = await this.content.getCourse(orgId, link.contentId);\n        if (course) {\n          return shown(course.status)\n            ? { id: link.id, contentId: link.contentId, type: 'course', title: course.title }\n            : null;\n        }\n        const download = await this.content.getDownload(orgId, link.contentId);\n        if (download) {\n          return shown(download.status)\n            ? { id: link.id, contentId: link.contentId, type: 'download', title: download.title }\n            : null;\n        }\n        const community = await this.content.getCommunity(orgId, link.contentId);\n        if (community) {\n          return shown(community.status)\n            ? { id: link.id, contentId: link.contentId, type: 'community', title: community.title }\n            : null;\n        }\n        return null;\n      }),\n    );\n    return views.filter((view): view is CommunityHomeLink => view !== null);\n  }\n}\n\nfunction standingOf(\n  space: SpaceDetail,\n  open: boolean,\n  memberCount: number,\n  status: SpaceMember['status'] | undefined,\n): CommunityHomeSpace['standing'] {\n  if (space.accessRule === 'all_members' || (open && status !== 'active')) {\n    return 'open';\n  }\n  if (status === 'active') {\n    return 'member';\n  }\n  if (status === 'requested' || status === 'invited') {\n    return status;\n  }\n  if (space.capacity !== null && memberCount >= space.capacity) {\n    return 'full';\n  }\n  return 'none';\n}\n"],"mappings":"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"}

package/dist/shared/actor.d.ts

@@ -0,0 +1,9 @@
+import { Role } from "../types/schemas/organizations.js";
+//#region src/shared/actor.d.ts
+interface Actor {
+  id: string;
+  role: Role;
+}
+//#endregion
+export { Actor };
+//# sourceMappingURL=actor.d.ts.map

package/dist/shared/errors.d.ts

@@ -17,6 +17,24 @@ declare class ConflictError extends Error {
 declare class ForbiddenError extends Error {
   constructor(message: string);
 }
+/** The caller's own input breaks a rule, independent of existing state
+ *  (wrong file type, too large, talking to yourself, …). The HTTP layer maps
+ *  this to 400. */
+declare class InvalidInputError extends Error {
+  constructor(message: string);
+}
+declare class UnavailableError extends Error {
+  readonly details?: Record<string, string> | undefined;
+  constructor(message: string, details?: Record<string, string> | undefined);
+}
+type ValidationProblem = {
+  path?: string;
+  message: string;
+};
+declare class ValidationError extends Error {
+  readonly problems: ValidationProblem[];
+  constructor(problems: string | ValidationProblem[]);
+}
 //#endregion
-export { ConflictError, ForbiddenError, NotFoundError };
+export { ConflictError, ForbiddenError, InvalidInputError, NotFoundError, UnavailableError, ValidationError, ValidationProblem };
 //# sourceMappingURL=errors.d.ts.map

package/dist/shared/errors.js

@@ -28,7 +28,33 @@ var ForbiddenError = class extends Error {
 		this.name = "ForbiddenError";
 	}
 };
+/** The caller's own input breaks a rule, independent of existing state
+*  (wrong file type, too large, talking to yourself, …). The HTTP layer maps
+*  this to 400. */
+var InvalidInputError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "InvalidInputError";
+	}
+};
+var UnavailableError = class extends Error {
+	details;
+	constructor(message, details) {
+		super(message);
+		this.details = details;
+		this.name = "UnavailableError";
+	}
+};
+var ValidationError = class extends Error {
+	problems;
+	constructor(problems) {
+		const list = typeof problems === "string" ? [{ message: problems }] : problems;
+		super(list.map((problem) => problem.path ? `${problem.path}: ${problem.message}` : problem.message).join("; "));
+		this.problems = list;
+		this.name = "ValidationError";
+	}
+};
 //#endregion
-export { ConflictError, ForbiddenError, NotFoundError };
+export { ConflictError, ForbiddenError, InvalidInputError, NotFoundError, UnavailableError, ValidationError };
 
 //# sourceMappingURL=errors.js.map

package/dist/shared/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","names":[],"sources":["../../src/shared/errors.ts"],"sourcesContent":["// Cross-cutting domain errors. Like `../shared/ports.js`, this file is\n// importable from any context; the central HTTP error handler maps these to\n// status codes so routes never hand-roll error replies.\n\n/** A command's target does not exist in this org. Queries return null for the\n *  same situation — a missing row is a normal answer to a question, but a\n *  failed precondition for a command. */\nexport class NotFoundError extends Error {\n  constructor(\n    readonly resource: string,\n    readonly id: string,\n  ) {\n    super(`${resource} not found`);\n    this.name = 'NotFoundError';\n  }\n}\n\n/** A command conflicts with existing state (duplicate email, already linked,\n *  …). The HTTP layer maps this to 409. */\nexport class ConflictError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'ConflictError';\n  }\n}\n\n/** The caller is authenticated but not permitted to perform this command.\n *  The HTTP layer maps this to 403. */\nexport class ForbiddenError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'ForbiddenError';\n  }\n}\n"],"mappings":";;;;AAOA,IAAa,gBAAb,cAAmC,MAAM;CAE5B;CACA;CAFX,YACE,UACA,IACA;EACA,MAAM,GAAG,SAAS,WAAW;EAHpB,KAAA,WAAA;EACA,KAAA,KAAA;EAGT,KAAK,OAAO;CACd;AACF;;;AAIA,IAAa,gBAAb,cAAmC,MAAM;CACvC,YAAY,SAAiB;EAC3B,MAAM,OAAO;EACb,KAAK,OAAO;CACd;AACF;;;AAIA,IAAa,iBAAb,cAAoC,MAAM;CACxC,YAAY,SAAiB;EAC3B,MAAM,OAAO;EACb,KAAK,OAAO;CACd;AACF"}
+{"version":3,"file":"errors.js","names":[],"sources":["../../src/shared/errors.ts"],"sourcesContent":["// Cross-cutting domain errors. Like `../shared/ports.js`, this file is\n// importable from any context; the central HTTP error handler maps these to\n// status codes so routes never hand-roll error replies.\n\n/** A command's target does not exist in this org. Queries return null for the\n *  same situation — a missing row is a normal answer to a question, but a\n *  failed precondition for a command. */\nexport class NotFoundError extends Error {\n  constructor(\n    readonly resource: string,\n    readonly id: string,\n  ) {\n    super(`${resource} not found`);\n    this.name = 'NotFoundError';\n  }\n}\n\n/** A command conflicts with existing state (duplicate email, already linked,\n *  …). The HTTP layer maps this to 409. */\nexport class ConflictError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'ConflictError';\n  }\n}\n\n/** The caller is authenticated but not permitted to perform this command.\n *  The HTTP layer maps this to 403. */\nexport class ForbiddenError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'ForbiddenError';\n  }\n}\n\n/** The caller's own input breaks a rule, independent of existing state\n *  (wrong file type, too large, talking to yourself, …). The HTTP layer maps\n *  this to 400. */\nexport class InvalidInputError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'InvalidInputError';\n  }\n}\n\nexport class UnavailableError extends Error {\n  constructor(\n    message: string,\n    readonly details?: Record<string, string>,\n  ) {\n    super(message);\n    this.name = 'UnavailableError';\n  }\n}\n\nexport type ValidationProblem = { path?: string; message: string };\n\nexport class ValidationError extends Error {\n  readonly problems: ValidationProblem[];\n\n  constructor(problems: string | ValidationProblem[]) {\n    const list = typeof problems === 'string' ? [{ message: problems }] : problems;\n    super(\n      list\n        .map((problem) => (problem.path ? `${problem.path}: ${problem.message}` : problem.message))\n        .join('; '),\n    );\n    this.problems = list;\n    this.name = 'ValidationError';\n  }\n}\n"],"mappings":";;;;AAOA,IAAa,gBAAb,cAAmC,MAAM;CAE5B;CACA;CAFX,YACE,UACA,IACA;EACA,MAAM,GAAG,SAAS,WAAW;EAHpB,KAAA,WAAA;EACA,KAAA,KAAA;EAGT,KAAK,OAAO;CACd;AACF;;;AAIA,IAAa,gBAAb,cAAmC,MAAM;CACvC,YAAY,SAAiB;EAC3B,MAAM,OAAO;EACb,KAAK,OAAO;CACd;AACF;;;AAIA,IAAa,iBAAb,cAAoC,MAAM;CACxC,YAAY,SAAiB;EAC3B,MAAM,OAAO;EACb,KAAK,OAAO;CACd;AACF;;;;AAKA,IAAa,oBAAb,cAAuC,MAAM;CAC3C,YAAY,SAAiB;EAC3B,MAAM,OAAO;EACb,KAAK,OAAO;CACd;AACF;AAEA,IAAa,mBAAb,cAAsC,MAAM;CAG/B;CAFX,YACE,SACA,SACA;EACA,MAAM,OAAO;EAFJ,KAAA,UAAA;EAGT,KAAK,OAAO;CACd;AACF;AAIA,IAAa,kBAAb,cAAqC,MAAM;CACzC;CAEA,YAAY,UAAwC;EAClD,MAAM,OAAO,OAAO,aAAa,WAAW,CAAC,EAAE,SAAS,SAAS,CAAC,IAAI;EACtE,MACE,KACG,KAAK,YAAa,QAAQ,OAAO,GAAG,QAAQ,KAAK,IAAI,QAAQ,YAAY,QAAQ,OAAQ,CAAC,CAC1F,KAAK,IAAI,CACd;EACA,KAAK,WAAW;EAChB,KAAK,OAAO;CACd;AACF"}

package/dist/shared/id.d.ts

@@ -30,6 +30,20 @@ declare const ID_PREFIXES: {
   readonly automationRun: "run";
   readonly comment: "cmt";
   readonly commentReport: "crp";
+  readonly community: "cmy";
+  readonly space: "spc";
+  readonly topic: "top";
+  readonly spaceLink: "slk";
+  readonly spaceMember: "spm";
+  readonly post: "pst";
+  readonly postFlag: "pfl";
+  readonly chat: "cht";
+  readonly message: "msg";
+  readonly messageFlag: "mfl";
+  readonly notification: "ntf";
+  readonly notificationSetting: "nst";
+  readonly notificationDelivery: "ndl";
+  readonly device: "dev";
 };
 type IdType = keyof typeof ID_PREFIXES;
 /** A bare KSUID body (27-char base62, time-sortable), no prefix. */

package/dist/shared/id.js

@@ -30,7 +30,21 @@ const ID_PREFIXES = {
 	automation: "atm",
 	automationRun: "run",
 	comment: "cmt",
-	commentReport: "crp"
+	commentReport: "crp",
+	community: "cmy",
+	space: "spc",
+	topic: "top",
+	spaceLink: "slk",
+	spaceMember: "spm",
+	post: "pst",
+	postFlag: "pfl",
+	chat: "cht",
+	message: "msg",
+	messageFlag: "mfl",
+	notification: "ntf",
+	notificationSetting: "nst",
+	notificationDelivery: "ndl",
+	device: "dev"
 };
 /** A bare KSUID body (27-char base62, time-sortable), no prefix. */
 function ksuid() {

package/dist/shared/id.js.map

@@ -1 +1 @@
-{"version":3,"file":"id.js","names":[],"sources":["../../src/shared/id.ts"],"sourcesContent":["import KSUID from 'ksuid';\n\n/**\n * Prefixed, KSUID-bodied string ids — `${prefix}_${ksuid}`, e.g. `org_2QZ4mK...`.\n *\n * The body is a real KSUID (27-char base62, 4-byte timestamp + 16 random bytes),\n * so ids are lexicographically time-sortable. The prefix marks the entity type at\n * a glance. A core utility (one implementation, nothing to swap), called directly\n * by core services and used as the Drizzle `.$defaultFn` for every domain id column.\n */\nexport const ID_PREFIXES = {\n  organization: 'org',\n  user: 'usr',\n  student: 'stu',\n  orgUser: 'orm',\n  invite: 'ivt',\n  bundle: 'bun',\n  course: 'crs',\n  module: 'mod',\n  activity: 'act',\n  activityAsset: 'aca',\n  download: 'dwn',\n  downloadAsset: 'dla',\n  asset: 'ast',\n  entitlement: 'ent',\n  progress: 'prg',\n  credential: 'crd',\n  connection: 'con',\n  event: 'evt',\n  automation: 'atm',\n  automationRun: 'run',\n  comment: 'cmt',\n  commentReport: 'crp',\n} as const;\n\nexport type IdType = keyof typeof ID_PREFIXES;\n\n/** A bare KSUID body (27-char base62, time-sortable), no prefix. */\nexport function ksuid(): string {\n  return KSUID.randomSync().string;\n}\n\n/** Attach an arbitrary prefix to a fresh KSUID — `${prefix}_${ksuid}`. */\nexport function prefixId(prefix: string): string {\n  return `${prefix}_${ksuid()}`;\n}\n\n/** Generate a prefixed, time-sortable id for the given domain entity type. */\nexport function genId(type: IdType): string {\n  return prefixId(ID_PREFIXES[type]);\n}\n\n/** True when `value` carries the prefix for `type` (shape check only, not existence). */\nexport function isId(type: IdType, value: string): boolean {\n  return value.startsWith(`${ID_PREFIXES[type]}_`);\n}\n"],"mappings":";;;;;;;;;;AAUA,MAAa,cAAc;CACzB,cAAc;CACd,MAAM;CACN,SAAS;CACT,SAAS;CACT,QAAQ;CACR,QAAQ;CACR,QAAQ;CACR,QAAQ;CACR,UAAU;CACV,eAAe;CACf,UAAU;CACV,eAAe;CACf,OAAO;CACP,aAAa;CACb,UAAU;CACV,YAAY;CACZ,YAAY;CACZ,OAAO;CACP,YAAY;CACZ,eAAe;CACf,SAAS;CACT,eAAe;AACjB;;AAKA,SAAgB,QAAgB;CAC9B,OAAO,MAAM,WAAW,CAAC,CAAC;AAC5B;;AAGA,SAAgB,SAAS,QAAwB;CAC/C,OAAO,GAAG,OAAO,GAAG,MAAM;AAC5B;;AAGA,SAAgB,MAAM,MAAsB;CAC1C,OAAO,SAAS,YAAY,KAAK;AACnC;;AAGA,SAAgB,KAAK,MAAc,OAAwB;CACzD,OAAO,MAAM,WAAW,GAAG,YAAY,MAAM,EAAE;AACjD"}
+{"version":3,"file":"id.js","names":[],"sources":["../../src/shared/id.ts"],"sourcesContent":["import KSUID from 'ksuid';\n\n/**\n * Prefixed, KSUID-bodied string ids — `${prefix}_${ksuid}`, e.g. `org_2QZ4mK...`.\n *\n * The body is a real KSUID (27-char base62, 4-byte timestamp + 16 random bytes),\n * so ids are lexicographically time-sortable. The prefix marks the entity type at\n * a glance. A core utility (one implementation, nothing to swap), called directly\n * by core services and used as the Drizzle `.$defaultFn` for every domain id column.\n */\nexport const ID_PREFIXES = {\n  organization: 'org',\n  user: 'usr',\n  student: 'stu',\n  orgUser: 'orm',\n  invite: 'ivt',\n  bundle: 'bun',\n  course: 'crs',\n  module: 'mod',\n  activity: 'act',\n  activityAsset: 'aca',\n  download: 'dwn',\n  downloadAsset: 'dla',\n  asset: 'ast',\n  entitlement: 'ent',\n  progress: 'prg',\n  credential: 'crd',\n  connection: 'con',\n  event: 'evt',\n  automation: 'atm',\n  automationRun: 'run',\n  comment: 'cmt',\n  commentReport: 'crp',\n  community: 'cmy',\n  space: 'spc',\n  topic: 'top',\n  spaceLink: 'slk',\n  spaceMember: 'spm',\n  post: 'pst',\n  postFlag: 'pfl',\n  chat: 'cht',\n  message: 'msg',\n  messageFlag: 'mfl',\n  notification: 'ntf',\n  notificationSetting: 'nst',\n  notificationDelivery: 'ndl',\n  device: 'dev',\n} as const;\n\nexport type IdType = keyof typeof ID_PREFIXES;\n\n/** A bare KSUID body (27-char base62, time-sortable), no prefix. */\nexport function ksuid(): string {\n  return KSUID.randomSync().string;\n}\n\n/** Attach an arbitrary prefix to a fresh KSUID — `${prefix}_${ksuid}`. */\nexport function prefixId(prefix: string): string {\n  return `${prefix}_${ksuid()}`;\n}\n\n/** Generate a prefixed, time-sortable id for the given domain entity type. */\nexport function genId(type: IdType): string {\n  return prefixId(ID_PREFIXES[type]);\n}\n\n/** True when `value` carries the prefix for `type` (shape check only, not existence). */\nexport function isId(type: IdType, value: string): boolean {\n  return value.startsWith(`${ID_PREFIXES[type]}_`);\n}\n"],"mappings":";;;;;;;;;;AAUA,MAAa,cAAc;CACzB,cAAc;CACd,MAAM;CACN,SAAS;CACT,SAAS;CACT,QAAQ;CACR,QAAQ;CACR,QAAQ;CACR,QAAQ;CACR,UAAU;CACV,eAAe;CACf,UAAU;CACV,eAAe;CACf,OAAO;CACP,aAAa;CACb,UAAU;CACV,YAAY;CACZ,YAAY;CACZ,OAAO;CACP,YAAY;CACZ,eAAe;CACf,SAAS;CACT,eAAe;CACf,WAAW;CACX,OAAO;CACP,OAAO;CACP,WAAW;CACX,aAAa;CACb,MAAM;CACN,UAAU;CACV,MAAM;CACN,SAAS;CACT,aAAa;CACb,cAAc;CACd,qBAAqB;CACrB,sBAAsB;CACtB,QAAQ;AACV;;AAKA,SAAgB,QAAgB;CAC9B,OAAO,MAAM,WAAW,CAAC,CAAC;AAC5B;;AAGA,SAAgB,SAAS,QAAwB;CAC/C,OAAO,GAAG,OAAO,GAAG,MAAM;AAC5B;;AAGA,SAAgB,MAAM,MAAsB;CAC1C,OAAO,SAAS,YAAY,KAAK;AACnC;;AAGA,SAAgB,KAAK,MAAc,OAAwB;CACzD,OAAO,MAAM,WAAW,GAAG,YAAY,MAAM,EAAE;AACjD"}

package/dist/shared/mailer.d.ts

@@ -6,13 +6,26 @@ import "./ports.js";
 /** Resolves the recipient/content details a template needs when the
  *  triggering event carries only row ids. Wired by the app layer. */
 interface MailerLookups {
-  orgUserEmail(orgId: string, orgUserId: string): Promise<string | null>;
+  orgUserPerson(orgId: string, orgUserId: string): Promise<{
+    userId: string;
+    email: string;
+  } | null>;
   contentInfo(orgId: string, contentId: string): Promise<{
     id: string;
     title: string;
     type: ContentType;
   } | null>;
 }
+declare class EmailRejectedError extends Error {
+  readonly status?: number | undefined;
+  constructor(message: string, status?: number | undefined);
+}
+declare function isEmailRejected(err: unknown): err is EmailRejectedError;
+declare class EmailRenderError extends Error {
+  readonly template: string;
+  constructor(template: string, cause: unknown);
+}
+declare function isEmailRenderError(err: unknown): err is EmailRenderError;
 declare class Mailer {
   private readonly templates;
   private readonly email;
@@ -21,5 +34,5 @@ declare class Mailer {
   send<K extends EmailTemplateId>(to: string, id: K, params: EmailTemplateParams[K], ctx?: Partial<TemplateContext>): Promise<void>;
 }
 //#endregion
-export { Mailer, MailerLookups };
+export { EmailRejectedError, EmailRenderError, Mailer, MailerLookups, isEmailRejected, isEmailRenderError };
 //# sourceMappingURL=mailer.d.ts.map