@headless-lms/core 0.3.0 → 0.5.0

package/dist/automations/notifications/rules/recipients.js

@@ -0,0 +1,98 @@
+import { nameMentions } from "../../../discussion/mentions.js";
+import { actorOf, excerpt } from "../../community-mail.js";
+//#region src/automations/notifications/rules/recipients.ts
+const MUTE_PROOF = [
+	"subject",
+	"moderator",
+	"mentioned"
+];
+var Reasons = class {
+	byPerson = /* @__PURE__ */ new Map();
+	add(orgUserIds, reason) {
+		for (const orgUserId of orgUserIds) {
+			if (!orgUserId) continue;
+			const reasons = this.byPerson.get(orgUserId) ?? [];
+			if (!reasons.includes(reason)) reasons.push(reason);
+			this.byPerson.set(orgUserId, reasons);
+		}
+		return this;
+	}
+	ids() {
+		return [...this.byPerson.keys()];
+	}
+	entries() {
+		return [...this.byPerson.entries()];
+	}
+};
+async function recipientsOf(reads, orgId, reasons, reach) {
+	const excluded = new Set(reach.exclude.filter((id) => Boolean(id)));
+	let people = new Map(reasons.entries().filter(([orgUserId]) => !excluded.has(orgUserId)));
+	if (people.size > 0 && reach.canOpen) {
+		const open = new Set(await reach.canOpen([...people.keys()]));
+		people = new Map([...people].filter(([orgUserId]) => open.has(orgUserId)));
+	}
+	for (const item of reach.mutedOn ?? []) {
+		const exposed = [...people].filter(([, held]) => held.some((reason) => !MUTE_PROOF.includes(reason))).map(([orgUserId]) => orgUserId);
+		if (exposed.length === 0) break;
+		for (const orgUserId of await reads.mutedAmong(orgId, item, exposed, reach.at)) {
+			const kept = (people.get(orgUserId) ?? []).filter((reason) => MUTE_PROOF.includes(reason));
+			if (kept.length > 0) people.set(orgUserId, kept);
+			else people.delete(orgUserId);
+		}
+	}
+	if (people.size === 0) return [];
+	const userIds = await reads.userIdsOf(orgId, [...people.keys()]);
+	return [...people].flatMap(([orgUserId, held]) => {
+		const userId = userIds[orgUserId];
+		return userId ? [{
+			orgUserId,
+			userId,
+			reasons: held
+		}] : [];
+	});
+}
+function listOf(base, recipients) {
+	return recipients.length > 0 ? [{
+		...base,
+		recipients
+	}] : [];
+}
+function eventAt(event) {
+	return new Date(event.occurredAt);
+}
+function actorOr(event, fallback) {
+	return actorOf(event) ?? fallback;
+}
+async function textExcerpt(reads, orgId, text, max) {
+	return excerpt(await nameMentions(text, (orgUserId) => reads.displayName(orgId, orgUserId)), max);
+}
+async function participantNames(reads, orgId, chat) {
+	const names = [];
+	for (const participant of chat.participants) if (!participant.leftAt) names.push(await reads.displayName(orgId, participant.orgUserId));
+	return names;
+}
+async function chatTitle(reads, orgId, chat, senderOrgUserId) {
+	if (chat.kind === "direct") return reads.displayName(orgId, senderOrgUserId);
+	const names = await participantNames(reads, orgId, chat);
+	return names.length > 0 ? names.join(", ") : "Group chat";
+}
+function chatReach(reads, orgId, chat, chatId, actor, at) {
+	return {
+		exclude: [actor],
+		at,
+		mutedOn: [{
+			type: "chat",
+			id: chatId
+		}],
+		canOpen: async (orgUserIds) => {
+			const present = new Set(chat.participants.filter((participant) => participant.leftAt === null).map((participant) => participant.orgUserId));
+			const unblocked = [];
+			for (const orgUserId of orgUserIds) if (present.has(orgUserId) && !await reads.pairBlocked(orgId, chat.communityId, actor, orgUserId)) unblocked.push(orgUserId);
+			return unblocked.length > 0 ? reads.communityMembersAmong(orgId, chat.communityId, unblocked) : [];
+		}
+	};
+}
+//#endregion
+export { Reasons, actorOr, chatReach, chatTitle, eventAt, listOf, participantNames, recipientsOf, textExcerpt };
+
+//# sourceMappingURL=recipients.js.map

package/dist/automations/notifications/rules/recipients.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipients.js","names":[],"sources":["../../../../src/automations/notifications/rules/recipients.ts"],"sourcesContent":["import { nameMentions } from '../../../discussion/index.js';\nimport type { DomainEvent } from '../../../shared/ports.js';\nimport type { Reason, RecipientList, SubjectRef } from '../../../types/index.js';\nimport { actorOf, excerpt } from '../../community-mail.js';\nimport type { NotificationReads } from '../../ports.js';\n\nexport type Recipient = NonNullable<RecipientList['recipients']>[number];\nexport type ListBase = Omit<RecipientList, 'recipients' | 'audience'>;\nexport type Chat = NonNullable<Awaited<ReturnType<NotificationReads['chat']>>>;\n\nconst MUTE_PROOF: Reason[] = ['subject', 'moderator', 'mentioned'];\n\nexport class Reasons {\n  private readonly byPerson = new Map<string, Reason[]>();\n\n  add(orgUserIds: (string | null | undefined)[], reason: Reason): this {\n    for (const orgUserId of orgUserIds) {\n      if (!orgUserId) {\n        continue;\n      }\n      const reasons = this.byPerson.get(orgUserId) ?? [];\n      if (!reasons.includes(reason)) {\n        reasons.push(reason);\n      }\n      this.byPerson.set(orgUserId, reasons);\n    }\n    return this;\n  }\n\n  ids(): string[] {\n    return [...this.byPerson.keys()];\n  }\n\n  entries(): [string, Reason[]][] {\n    return [...this.byPerson.entries()];\n  }\n}\n\nexport interface Reach {\n  exclude: (string | null | undefined)[];\n  canOpen?: (orgUserIds: string[]) => Promise<string[]>;\n  mutedOn?: SubjectRef[];\n  at: Date;\n}\n\nexport async function recipientsOf(\n  reads: NotificationReads,\n  orgId: string,\n  reasons: Reasons,\n  reach: Reach,\n): Promise<Recipient[]> {\n  const excluded = new Set(reach.exclude.filter((id): id is string => Boolean(id)));\n  let people = new Map(reasons.entries().filter(([orgUserId]) => !excluded.has(orgUserId)));\n  if (people.size > 0 && reach.canOpen) {\n    const open = new Set(await reach.canOpen([...people.keys()]));\n    people = new Map([...people].filter(([orgUserId]) => open.has(orgUserId)));\n  }\n  for (const item of reach.mutedOn ?? []) {\n    const exposed = [...people]\n      .filter(([, held]) => held.some((reason) => !MUTE_PROOF.includes(reason)))\n      .map(([orgUserId]) => orgUserId);\n    if (exposed.length === 0) {\n      break;\n    }\n    for (const orgUserId of await reads.mutedAmong(orgId, item, exposed, reach.at)) {\n      const kept = (people.get(orgUserId) ?? []).filter((reason) => MUTE_PROOF.includes(reason));\n      if (kept.length > 0) {\n        people.set(orgUserId, kept);\n      } else {\n        people.delete(orgUserId);\n      }\n    }\n  }\n  if (people.size === 0) {\n    return [];\n  }\n  const userIds = await reads.userIdsOf(orgId, [...people.keys()]);\n  return [...people].flatMap(([orgUserId, held]) => {\n    const userId = userIds[orgUserId];\n    return userId ? [{ orgUserId, userId, reasons: held }] : [];\n  });\n}\n\nexport function listOf(base: ListBase, recipients: Recipient[]): RecipientList[] {\n  return recipients.length > 0 ? [{ ...base, recipients }] : [];\n}\n\nexport function eventAt(event: DomainEvent): Date {\n  return new Date(event.occurredAt);\n}\n\nexport function actorOr(event: DomainEvent, fallback: string | null): string | null {\n  return actorOf(event) ?? fallback;\n}\n\nexport async function textExcerpt(\n  reads: NotificationReads,\n  orgId: string,\n  text: string,\n  max: number,\n): Promise<string> {\n  return excerpt(await nameMentions(text, (orgUserId) => reads.displayName(orgId, orgUserId)), max);\n}\n\nexport async function participantNames(\n  reads: NotificationReads,\n  orgId: string,\n  chat: Chat,\n): Promise<string[]> {\n  const names: string[] = [];\n  for (const participant of chat.participants) {\n    if (!participant.leftAt) {\n      names.push(await reads.displayName(orgId, participant.orgUserId));\n    }\n  }\n  return names;\n}\n\nexport async function chatTitle(\n  reads: NotificationReads,\n  orgId: string,\n  chat: Chat,\n  senderOrgUserId: string,\n): Promise<string> {\n  if (chat.kind === 'direct') {\n    return reads.displayName(orgId, senderOrgUserId);\n  }\n  const names = await participantNames(reads, orgId, chat);\n  return names.length > 0 ? names.join(', ') : 'Group chat';\n}\n\nexport function chatReach(\n  reads: NotificationReads,\n  orgId: string,\n  chat: Chat,\n  chatId: string,\n  actor: string,\n  at: Date,\n): Reach {\n  return {\n    exclude: [actor],\n    at,\n    mutedOn: [{ type: 'chat', id: chatId }],\n    canOpen: async (orgUserIds) => {\n      const present = new Set(\n        chat.participants\n          .filter((participant) => participant.leftAt === null)\n          .map((participant) => participant.orgUserId),\n      );\n      const unblocked: string[] = [];\n      for (const orgUserId of orgUserIds) {\n        if (\n          present.has(orgUserId) &&\n          !(await reads.pairBlocked(orgId, chat.communityId, actor, orgUserId))\n        ) {\n          unblocked.push(orgUserId);\n        }\n      }\n      return unblocked.length > 0\n        ? reads.communityMembersAmong(orgId, chat.communityId, unblocked)\n        : [];\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/automations/notifications/service.d.ts

@@ -0,0 +1,29 @@
+import { Logger } from "../../types/ports.js";
+import { NotificationFilter } from "../../types/notifications.js";
+import "../../types/index.js";
+import "../../shared/ports.js";
+import { MemberActor } from "../../identity/ports.js";
+import "../../identity/index.js";
+import { ListedNotification, NotificationPage, NotificationsRepository, NotificationsService, UnreadCounts } from "../ports.js";
+//#region src/automations/notifications/service.d.ts
+declare class NotificationsServiceImpl implements NotificationsService {
+  private readonly repo;
+  private readonly logger;
+  constructor(params: {
+    repo: NotificationsRepository;
+    logger?: Logger;
+  });
+  list(filter: NotificationFilter, page: {
+    page: number;
+    pageSize: number;
+  }, actor: MemberActor): Promise<NotificationPage>;
+  get(notificationId: string, actor: MemberActor): Promise<ListedNotification | null>;
+  unreadCounts(communityIds: string[], actor: MemberActor): Promise<UnreadCounts>;
+  markRead(notificationId: string, actor: MemberActor): Promise<void>;
+  markAllRead(filter: NotificationFilter, actor: MemberActor): Promise<{
+    marked: number;
+  }>;
+}
+//#endregion
+export { NotificationsServiceImpl };
+//# sourceMappingURL=service.d.ts.map

package/dist/automations/notifications/service.js

@@ -0,0 +1,45 @@
+import { noopLogger } from "../../shared/logger.js";
+import { NotFoundError } from "../../shared/errors.js";
+//#region src/automations/notifications/service.ts
+var NotificationsServiceImpl = class {
+	repo;
+	logger;
+	constructor(params) {
+		this.repo = params.repo;
+		this.logger = params.logger ?? noopLogger;
+	}
+	list(filter, page, actor) {
+		return this.repo.page(actor.orgId, actor.userId, filter, page);
+	}
+	get(notificationId, actor) {
+		return this.repo.find(actor.orgId, actor.userId, notificationId);
+	}
+	async unreadCounts(communityIds, actor) {
+		const ids = [...new Set(communityIds)];
+		const counts = await this.repo.unreadCounts(actor.orgId, actor.userId, ids);
+		const byCommunity = new Map(counts.communities.map((row) => [row.communityId, row.unread]));
+		return {
+			org: counts.org,
+			communities: ids.map((communityId) => ({
+				communityId,
+				unread: byCommunity.get(communityId) ?? 0
+			}))
+		};
+	}
+	async markRead(notificationId, actor) {
+		if (!await this.repo.markRead(actor.orgId, actor.userId, notificationId, /* @__PURE__ */ new Date())) throw new NotFoundError("Notification", notificationId);
+	}
+	async markAllRead(filter, actor) {
+		const marked = await this.repo.markAllRead(actor.orgId, actor.userId, filter, /* @__PURE__ */ new Date());
+		this.logger.debug("notifications marked read", {
+			orgId: actor.orgId,
+			userId: actor.userId,
+			marked
+		});
+		return { marked };
+	}
+};
+//#endregion
+export { NotificationsServiceImpl };
+
+//# sourceMappingURL=service.js.map

package/dist/automations/notifications/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","names":[],"sources":["../../../src/automations/notifications/service.ts"],"sourcesContent":["import { NotFoundError } from '../../shared/errors.js';\nimport { noopLogger } from '../../shared/logger.js';\nimport type { Logger } from '../../shared/ports.js';\nimport type { NotificationFilter } from '../../types/index.js';\nimport type { MemberActor } from '../../identity/index.js';\nimport type {\n  ListedNotification,\n  NotificationPage,\n  NotificationsRepository,\n  NotificationsService,\n  UnreadCounts,\n} from '../ports.js';\n\nexport class NotificationsServiceImpl implements NotificationsService {\n  private readonly repo: NotificationsRepository;\n  private readonly logger: Logger;\n\n  constructor(params: { repo: NotificationsRepository; logger?: Logger }) {\n    this.repo = params.repo;\n    this.logger = params.logger ?? noopLogger;\n  }\n\n  list(\n    filter: NotificationFilter,\n    page: { page: number; pageSize: number },\n    actor: MemberActor,\n  ): Promise<NotificationPage> {\n    return this.repo.page(actor.orgId, actor.userId, filter, page);\n  }\n\n  get(notificationId: string, actor: MemberActor): Promise<ListedNotification | null> {\n    return this.repo.find(actor.orgId, actor.userId, notificationId);\n  }\n\n  async unreadCounts(communityIds: string[], actor: MemberActor): Promise<UnreadCounts> {\n    const ids = [...new Set(communityIds)];\n    const counts = await this.repo.unreadCounts(actor.orgId, actor.userId, ids);\n    const byCommunity = new Map(counts.communities.map((row) => [row.communityId, row.unread]));\n    return {\n      org: counts.org,\n      communities: ids.map((communityId) => ({\n        communityId,\n        unread: byCommunity.get(communityId) ?? 0,\n      })),\n    };\n  }\n\n  async markRead(notificationId: string, actor: MemberActor): Promise<void> {\n    if (!(await this.repo.markRead(actor.orgId, actor.userId, notificationId, new Date()))) {\n      throw new NotFoundError('Notification', notificationId);\n    }\n  }\n\n  async markAllRead(filter: NotificationFilter, actor: MemberActor): Promise<{ marked: number }> {\n    const marked = await this.repo.markAllRead(actor.orgId, actor.userId, filter, new Date());\n    this.logger.debug('notifications marked read', {\n      orgId: actor.orgId,\n      userId: actor.userId,\n      marked,\n    });\n    return { marked };\n  }\n}\n"],"mappings":";;;AAaA,IAAa,2BAAb,MAAsE;CACpE;CACA;CAEA,YAAY,QAA4D;EACtE,KAAK,OAAO,OAAO;EACnB,KAAK,SAAS,OAAO,UAAU;CACjC;CAEA,KACE,QACA,MACA,OAC2B;EAC3B,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,MAAM,QAAQ,QAAQ,IAAI;CAC/D;CAEA,IAAI,gBAAwB,OAAwD;EAClF,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,MAAM,QAAQ,cAAc;CACjE;CAEA,MAAM,aAAa,cAAwB,OAA2C;EACpF,MAAM,MAAM,CAAC,GAAG,IAAI,IAAI,YAAY,CAAC;EACrC,MAAM,SAAS,MAAM,KAAK,KAAK,aAAa,MAAM,OAAO,MAAM,QAAQ,GAAG;EAC1E,MAAM,cAAc,IAAI,IAAI,OAAO,YAAY,KAAK,QAAQ,CAAC,IAAI,aAAa,IAAI,MAAM,CAAC,CAAC;EAC1F,OAAO;GACL,KAAK,OAAO;GACZ,aAAa,IAAI,KAAK,iBAAiB;IACrC;IACA,QAAQ,YAAY,IAAI,WAAW,KAAK;GAC1C,EAAE;EACJ;CACF;CAEA,MAAM,SAAS,gBAAwB,OAAmC;EACxE,IAAI,CAAE,MAAM,KAAK,KAAK,SAAS,MAAM,OAAO,MAAM,QAAQ,gCAAgB,IAAI,KAAK,CAAC,GAClF,MAAM,IAAI,cAAc,gBAAgB,cAAc;CAE1D;CAEA,MAAM,YAAY,QAA4B,OAAiD;EAC7F,MAAM,SAAS,MAAM,KAAK,KAAK,YAAY,MAAM,OAAO,MAAM,QAAQ,wBAAQ,IAAI,KAAK,CAAC;EACxF,KAAK,OAAO,MAAM,6BAA6B;GAC7C,OAAO,MAAM;GACb,QAAQ,MAAM;GACd;EACF,CAAC;EACD,OAAO,EAAE,OAAO;CAClB;AACF"}

package/dist/automations/notifications/types.d.ts

@@ -0,0 +1,7 @@
+import { NotificationTypeDeclaration } from "../../types/notifications.js";
+import "../../types/index.js";
+//#region src/automations/notifications/types.d.ts
+declare const NOTIFICATION_TYPES: NotificationTypeDeclaration[];
+//#endregion
+export { NOTIFICATION_TYPES };
+//# sourceMappingURL=types.d.ts.map