@headless-lms/core 0.1.0 → 0.3.0

package/dist/automations/community-mail.d.ts

@@ -0,0 +1,112 @@
+import { DomainEvent, JsonValue } from "../types/shared.js";
+import { Logger } from "../types/ports.js";
+import { EmailTemplateId, EmailTemplateParams } from "../types/email-templates.js";
+import { GrantEntitlementInput } from "../types/schemas/entitlements.js";
+import { WebhookSender } from "../types/automations.js";
+import { ChatStatus } from "../types/schemas/discussion.js";
+import "../types/index.js";
+import { CredentialStore } from "../shared/ports.js";
+import { NotificationDesk } from "../identity/ports.js";
+import { Mailer, MailerLookups } from "../shared/mailer.js";
+import "../identity/index.js";
+import "../entitlements/index.js";
+import "./ports.js";
+//#region src/automations/community-mail.d.ts
+declare const MESSAGE_EXCERPT = 140;
+declare const POST_EXCERPT = 280;
+declare const MESSAGE_BATCH_MS: number;
+interface EmailRecipient<K extends EmailTemplateId = EmailTemplateId> {
+  to: string;
+  orgUserId: string;
+  userId: string;
+  params: EmailTemplateParams[K];
+}
+interface CommunityMailReads {
+  communityTitle(orgId: string, communityId: string): Promise<string | null>;
+  space(orgId: string, spaceId: string): Promise<{
+    name: string;
+    communityId: string;
+    capacity: number | null;
+  } | null>;
+  openSpaceNames(orgId: string, orgUserId: string, communityId: string): Promise<string[]>;
+  communitiesOpenedBy(orgId: string, grant: {
+    contentId: string | null;
+    bundleId: string | null;
+  }): Promise<string[]>;
+  communityMembersAmong(orgId: string, communityId: string, ids: string[]): Promise<string[]>;
+  spaceOpenersAmong(orgId: string, spaceId: string, ids: string[]): Promise<string[]>;
+  spaceOpeners(orgId: string, spaceId: string): Promise<string[]>;
+  moderationAudience(orgId: string, communityId: string): Promise<string[]>;
+  staffIds(orgId: string): Promise<string[]>;
+  displayName(orgId: string, orgUserId: string): Promise<string>;
+  followerIds(orgId: string, postId: string): Promise<string[]>;
+  comment(orgId: string, commentId: string): Promise<{
+    orgUserId: string;
+    postId: string | null;
+    body: string;
+  } | null>;
+  post(orgId: string, postId: string): Promise<{
+    title: string;
+    body: string;
+    spaceId: string;
+    orgUserId: string;
+    communityId: string;
+  } | null>;
+  chat(orgId: string, chatId: string): Promise<{
+    communityId: string;
+    kind: 'direct' | 'group';
+    status: ChatStatus;
+    createdBy: string | null;
+    participants: {
+      orgUserId: string;
+      muted: boolean;
+      mutedUntil: Date | null;
+      leftAt: Date | null;
+    }[];
+  } | null>;
+  latestMessageBody(orgId: string, chatId: string): Promise<string | null>;
+  pairBlocked(orgId: string, communityId: string, a: string, b: string): Promise<boolean>;
+  activeMemberCount(orgId: string, spaceId: string): Promise<number>;
+  memberCommunityTitles(orgId: string, orgUserId: string): Promise<{
+    id: string;
+    title: string;
+  }[]>;
+  recentMessageRecipients(orgId: string, automationId: string, chatId: string, since: Date): Promise<string[]>;
+}
+interface ScheduledWork {
+  publishDuePosts(orgId: string, now: Date): Promise<void>;
+  expireDueGrants(orgId: string, now: Date): Promise<void>;
+  sendDigest(orgId: string, now: Date): Promise<void>;
+  hasDuePosts(orgId: string, now: Date): Promise<boolean>;
+  hasDueGrants(orgId: string, now: Date): Promise<boolean>;
+  removeUnattachedUploads(orgId: string, now: Date): Promise<void>;
+  hasUnattachedUploads(orgId: string, now: Date): Promise<boolean>;
+}
+interface GrantWriter {
+  grant(orgId: string, input: GrantEntitlementInput): Promise<unknown>;
+}
+interface ActionDeps {
+  mailer: Pick<Mailer, 'send'>;
+  lookups: MailerLookups;
+  credentials: Pick<CredentialStore, 'reveal'>;
+  webhooks: WebhookSender;
+  mail: CommunityMailReads;
+  grants: GrantWriter;
+  desk: NotificationDesk;
+  scheduledWork: ScheduledWork;
+  automationId: string;
+  actionInput: Record<string, JsonValue>;
+  logger?: Logger;
+}
+declare const emptyCommunityMail: CommunityMailReads;
+declare const emptyNotificationDesk: NotificationDesk;
+declare const emptyScheduledWork: ScheduledWork;
+declare function actorOf(event: DomainEvent): string | undefined;
+declare function previousStatusOf(event: DomainEvent): string | undefined;
+declare function excerpt(value: string, max: number): string;
+declare function seededCommunityId(deps: ActionDeps): string | null;
+declare function firedAtOf(event: DomainEvent): Date;
+declare function address<K extends EmailTemplateId>(deps: ActionDeps, event: DomainEvent, orgId: string, orgUserIds: string[], params: EmailTemplateParams[K]): Promise<EmailRecipient<K>[] | undefined>;
+//#endregion
+export { ActionDeps, CommunityMailReads, EmailRecipient, GrantWriter, MESSAGE_BATCH_MS, MESSAGE_EXCERPT, POST_EXCERPT, ScheduledWork, actorOf, address, emptyCommunityMail, emptyNotificationDesk, emptyScheduledWork, excerpt, firedAtOf, previousStatusOf, seededCommunityId };
+//# sourceMappingURL=community-mail.d.ts.map

package/dist/automations/community-mail.js

@@ -0,0 +1,90 @@
+import { noopLogger } from "../shared/logger.js";
+//#region src/automations/community-mail.ts
+const MESSAGE_EXCERPT = 140;
+const POST_EXCERPT = 280;
+const MESSAGE_BATCH_MS = 900 * 1e3;
+const emptyCommunityMail = {
+	communityTitle: async () => null,
+	space: async () => null,
+	openSpaceNames: async () => [],
+	communitiesOpenedBy: async () => [],
+	communityMembersAmong: async () => [],
+	spaceOpenersAmong: async () => [],
+	spaceOpeners: async () => [],
+	moderationAudience: async () => [],
+	staffIds: async () => [],
+	displayName: async () => "A member",
+	followerIds: async () => [],
+	comment: async () => null,
+	post: async () => null,
+	chat: async () => null,
+	latestMessageBody: async () => null,
+	pairBlocked: async () => false,
+	activeMemberCount: async () => 0,
+	memberCommunityTitles: async () => [],
+	recentMessageRecipients: async () => []
+};
+const emptyNotificationDesk = {
+	notify: async () => {},
+	preferencesFor: async () => ({})
+};
+const emptyScheduledWork = {
+	publishDuePosts: async () => {},
+	expireDueGrants: async () => {},
+	sendDigest: async () => {},
+	hasDuePosts: async () => false,
+	hasDueGrants: async () => false,
+	removeUnattachedUploads: async () => {},
+	hasUnattachedUploads: async () => false
+};
+function actorOf(event) {
+	const value = event.metadata?.actorOrgUserId;
+	return typeof value === "string" ? value : void 0;
+}
+function previousStatusOf(event) {
+	const value = event.metadata?.previousStatus;
+	return typeof value === "string" ? value : void 0;
+}
+function excerpt(value, max) {
+	const flat = value.replace(/\s+/g, " ").trim();
+	return flat.length <= max ? flat : flat.slice(0, max);
+}
+function seededCommunityId(deps) {
+	const id = deps.actionInput["communityId"];
+	return typeof id === "string" ? id : null;
+}
+function firedAtOf(event) {
+	if (typeof event.data === "object" && event.data !== null && "firedAt" in event.data) {
+		const firedAt = event.data.firedAt;
+		if (typeof firedAt === "string") return new Date(firedAt);
+	}
+	return new Date(event.occurredAt);
+}
+async function address(deps, event, orgId, orgUserIds, params) {
+	const actor = actorOf(event);
+	const wanted = [...new Set(orgUserIds)].filter((id) => id !== actor);
+	if (wanted.length === 0) return [];
+	const recipients = [];
+	const logger = deps.logger ?? noopLogger;
+	for (const orgUserId of wanted) {
+		const person = await deps.lookups.orgUserPerson(orgId, orgUserId);
+		if (!person) {
+			logger.warn("email skipped: recipient has no address", {
+				orgId,
+				orgUserId
+			});
+			continue;
+		}
+		recipients.push({
+			to: person.email,
+			orgUserId,
+			userId: person.userId,
+			params
+		});
+	}
+	return recipients;
+}
+//#endregion
+export { MESSAGE_BATCH_MS, MESSAGE_EXCERPT, POST_EXCERPT, actorOf, address, emptyCommunityMail, emptyNotificationDesk, emptyScheduledWork, excerpt, firedAtOf, previousStatusOf, seededCommunityId };
+
+//# sourceMappingURL=community-mail.js.map

package/dist/automations/community-mail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"community-mail.js","names":[],"sources":["../../src/automations/community-mail.ts"],"sourcesContent":["import type { GrantEntitlementInput } from '../entitlements/index.js';\nimport type { NotificationDesk } from '../identity/index.js';\nimport type {\n  ChatStatus,\n  EmailTemplateId,\n  EmailTemplateParams,\n  JsonValue,\n} from '../types/index.js';\nimport type { Mailer, MailerLookups } from '../shared/mailer.js';\nimport type { CredentialStore, DomainEvent, Logger } from '../shared/ports.js';\nimport { noopLogger } from '../shared/logger.js';\nimport type { WebhookSender } from './ports.js';\n\nexport const MESSAGE_EXCERPT = 140;\nexport const POST_EXCERPT = 280;\nexport const MESSAGE_BATCH_MS = 15 * 60 * 1000;\n\nexport interface EmailRecipient<K extends EmailTemplateId = EmailTemplateId> {\n  to: string;\n  orgUserId: string;\n  userId: string;\n  params: EmailTemplateParams[K];\n}\n\nexport interface CommunityMailReads {\n  communityTitle(orgId: string, communityId: string): Promise<string | null>;\n  space(\n    orgId: string,\n    spaceId: string,\n  ): Promise<{ name: string; communityId: string; capacity: number | null } | null>;\n  openSpaceNames(orgId: string, orgUserId: string, communityId: string): Promise<string[]>;\n  communitiesOpenedBy(\n    orgId: string,\n    grant: { contentId: string | null; bundleId: string | null },\n  ): Promise<string[]>;\n  communityMembersAmong(orgId: string, communityId: string, ids: string[]): Promise<string[]>;\n  spaceOpenersAmong(orgId: string, spaceId: string, ids: string[]): Promise<string[]>;\n  spaceOpeners(orgId: string, spaceId: string): Promise<string[]>;\n  moderationAudience(orgId: string, communityId: string): Promise<string[]>;\n  staffIds(orgId: string): Promise<string[]>;\n  displayName(orgId: string, orgUserId: string): Promise<string>;\n  followerIds(orgId: string, postId: string): Promise<string[]>;\n  comment(\n    orgId: string,\n    commentId: string,\n  ): Promise<{ orgUserId: string; postId: string | null; body: string } | null>;\n  post(\n    orgId: string,\n    postId: string,\n  ): Promise<{\n    title: string;\n    body: string;\n    spaceId: string;\n    orgUserId: string;\n    communityId: string;\n  } | null>;\n  chat(\n    orgId: string,\n    chatId: string,\n  ): Promise<{\n    communityId: string;\n    kind: 'direct' | 'group';\n    status: ChatStatus;\n    createdBy: string | null;\n    participants: {\n      orgUserId: string;\n      muted: boolean;\n      mutedUntil: Date | null;\n      leftAt: Date | null;\n    }[];\n  } | null>;\n  latestMessageBody(orgId: string, chatId: string): Promise<string | null>;\n  pairBlocked(orgId: string, communityId: string, a: string, b: string): Promise<boolean>;\n  activeMemberCount(orgId: string, spaceId: string): Promise<number>;\n  memberCommunityTitles(orgId: string, orgUserId: string): Promise<{ id: string; title: string }[]>;\n  recentMessageRecipients(\n    orgId: string,\n    automationId: string,\n    chatId: string,\n    since: Date,\n  ): Promise<string[]>;\n}\n\nexport interface ScheduledWork {\n  publishDuePosts(orgId: string, now: Date): Promise<void>;\n  expireDueGrants(orgId: string, now: Date): Promise<void>;\n  sendDigest(orgId: string, now: Date): Promise<void>;\n  hasDuePosts(orgId: string, now: Date): Promise<boolean>;\n  hasDueGrants(orgId: string, now: Date): Promise<boolean>;\n  removeUnattachedUploads(orgId: string, now: Date): Promise<void>;\n  hasUnattachedUploads(orgId: string, now: Date): Promise<boolean>;\n}\n\nexport interface GrantWriter {\n  grant(orgId: string, input: GrantEntitlementInput): Promise<unknown>;\n}\n\nexport interface ActionDeps {\n  mailer: Pick<Mailer, 'send'>;\n  lookups: MailerLookups;\n  credentials: Pick<CredentialStore, 'reveal'>;\n  webhooks: WebhookSender;\n  mail: CommunityMailReads;\n  grants: GrantWriter;\n  desk: NotificationDesk;\n  scheduledWork: ScheduledWork;\n  automationId: string;\n  actionInput: Record<string, JsonValue>;\n  logger?: Logger;\n}\n\nexport const emptyCommunityMail: CommunityMailReads = {\n  communityTitle: async () => null,\n  space: async () => null,\n  openSpaceNames: async () => [],\n  communitiesOpenedBy: async () => [],\n  communityMembersAmong: async () => [],\n  spaceOpenersAmong: async () => [],\n  spaceOpeners: async () => [],\n  moderationAudience: async () => [],\n  staffIds: async () => [],\n  displayName: async () => 'A member',\n  followerIds: async () => [],\n  comment: async () => null,\n  post: async () => null,\n  chat: async () => null,\n  latestMessageBody: async () => null,\n  pairBlocked: async () => false,\n  activeMemberCount: async () => 0,\n  memberCommunityTitles: async () => [],\n  recentMessageRecipients: async () => [],\n};\n\nexport const emptyNotificationDesk: NotificationDesk = {\n  notify: async () => {},\n  preferencesFor: async () => ({}),\n};\n\nexport const emptyScheduledWork: ScheduledWork = {\n  publishDuePosts: async () => {},\n  expireDueGrants: async () => {},\n  sendDigest: async () => {},\n  hasDuePosts: async () => false,\n  hasDueGrants: async () => false,\n  removeUnattachedUploads: async () => {},\n  hasUnattachedUploads: async () => false,\n};\n\nexport function actorOf(event: DomainEvent): string | undefined {\n  const value = event.metadata?.actorOrgUserId;\n  return typeof value === 'string' ? value : undefined;\n}\n\nexport function previousStatusOf(event: DomainEvent): string | undefined {\n  const value = event.metadata?.previousStatus;\n  return typeof value === 'string' ? value : undefined;\n}\n\nexport function excerpt(value: string, max: number): string {\n  const flat = value.replace(/\\s+/g, ' ').trim();\n  return flat.length <= max ? flat : flat.slice(0, max);\n}\n\nexport function seededCommunityId(deps: ActionDeps): string | null {\n  const id = deps.actionInput['communityId'];\n  return typeof id === 'string' ? id : null;\n}\n\nexport function firedAtOf(event: DomainEvent): Date {\n  if (typeof event.data === 'object' && event.data !== null && 'firedAt' in event.data) {\n    const firedAt = (event.data as { firedAt?: unknown }).firedAt;\n    if (typeof firedAt === 'string') {\n      return new Date(firedAt);\n    }\n  }\n  return new Date(event.occurredAt);\n}\n\nexport async function address<K extends EmailTemplateId>(\n  deps: ActionDeps,\n  event: DomainEvent,\n  orgId: string,\n  orgUserIds: string[],\n  params: EmailTemplateParams[K],\n): Promise<EmailRecipient<K>[] | undefined> {\n  const actor = actorOf(event);\n  const wanted = [...new Set(orgUserIds)].filter((id) => id !== actor);\n  if (wanted.length === 0) {\n    return [];\n  }\n  const recipients: EmailRecipient<K>[] = [];\n  const logger = deps.logger ?? noopLogger;\n  for (const orgUserId of wanted) {\n    const person = await deps.lookups.orgUserPerson(orgId, orgUserId);\n    if (!person) {\n      logger.warn('email skipped: recipient has no address', { orgId, orgUserId });\n      continue;\n    }\n    recipients.push({ to: person.email, orgUserId, userId: person.userId, params });\n  }\n  return recipients;\n}\n"],"mappings":";;AAaA,MAAa,kBAAkB;AAC/B,MAAa,eAAe;AAC5B,MAAa,mBAAmB,MAAU;AAgG1C,MAAa,qBAAyC;CACpD,gBAAgB,YAAY;CAC5B,OAAO,YAAY;CACnB,gBAAgB,YAAY,CAAC;CAC7B,qBAAqB,YAAY,CAAC;CAClC,uBAAuB,YAAY,CAAC;CACpC,mBAAmB,YAAY,CAAC;CAChC,cAAc,YAAY,CAAC;CAC3B,oBAAoB,YAAY,CAAC;CACjC,UAAU,YAAY,CAAC;CACvB,aAAa,YAAY;CACzB,aAAa,YAAY,CAAC;CAC1B,SAAS,YAAY;CACrB,MAAM,YAAY;CAClB,MAAM,YAAY;CAClB,mBAAmB,YAAY;CAC/B,aAAa,YAAY;CACzB,mBAAmB,YAAY;CAC/B,uBAAuB,YAAY,CAAC;CACpC,yBAAyB,YAAY,CAAC;AACxC;AAEA,MAAa,wBAA0C;CACrD,QAAQ,YAAY,CAAC;CACrB,gBAAgB,aAAa,CAAC;AAChC;AAEA,MAAa,qBAAoC;CAC/C,iBAAiB,YAAY,CAAC;CAC9B,iBAAiB,YAAY,CAAC;CAC9B,YAAY,YAAY,CAAC;CACzB,aAAa,YAAY;CACzB,cAAc,YAAY;CAC1B,yBAAyB,YAAY,CAAC;CACtC,sBAAsB,YAAY;AACpC;AAEA,SAAgB,QAAQ,OAAwC;CAC9D,MAAM,QAAQ,MAAM,UAAU;CAC9B,OAAO,OAAO,UAAU,WAAW,QAAQ,KAAA;AAC7C;AAEA,SAAgB,iBAAiB,OAAwC;CACvE,MAAM,QAAQ,MAAM,UAAU;CAC9B,OAAO,OAAO,UAAU,WAAW,QAAQ,KAAA;AAC7C;AAEA,SAAgB,QAAQ,OAAe,KAAqB;CAC1D,MAAM,OAAO,MAAM,QAAQ,QAAQ,GAAG,CAAC,CAAC,KAAK;CAC7C,OAAO,KAAK,UAAU,MAAM,OAAO,KAAK,MAAM,GAAG,GAAG;AACtD;AAEA,SAAgB,kBAAkB,MAAiC;CACjE,MAAM,KAAK,KAAK,YAAY;CAC5B,OAAO,OAAO,OAAO,WAAW,KAAK;AACvC;AAEA,SAAgB,UAAU,OAA0B;CAClD,IAAI,OAAO,MAAM,SAAS,YAAY,MAAM,SAAS,QAAQ,aAAa,MAAM,MAAM;EACpF,MAAM,UAAW,MAAM,KAA+B;EACtD,IAAI,OAAO,YAAY,UACrB,OAAO,IAAI,KAAK,OAAO;CAE3B;CACA,OAAO,IAAI,KAAK,MAAM,UAAU;AAClC;AAEA,eAAsB,QACpB,MACA,OACA,OACA,YACA,QAC0C;CAC1C,MAAM,QAAQ,QAAQ,KAAK;CAC3B,MAAM,SAAS,CAAC,GAAG,IAAI,IAAI,UAAU,CAAC,CAAC,CAAC,QAAQ,OAAO,OAAO,KAAK;CACnE,IAAI,OAAO,WAAW,GACpB,OAAO,CAAC;CAEV,MAAM,aAAkC,CAAC;CACzC,MAAM,SAAS,KAAK,UAAU;CAC9B,KAAK,MAAM,aAAa,QAAQ;EAC9B,MAAM,SAAS,MAAM,KAAK,QAAQ,cAAc,OAAO,SAAS;EAChE,IAAI,CAAC,QAAQ;GACX,OAAO,KAAK,2CAA2C;IAAE;IAAO;GAAU,CAAC;GAC3E;EACF;EACA,WAAW,KAAK;GAAE,IAAI,OAAO;GAAO;GAAW,QAAQ,OAAO;GAAQ;EAAO,CAAC;CAChF;CACA,OAAO;AACT"}

package/dist/automations/community-notifications.d.ts

@@ -0,0 +1,16 @@
+import { DomainEvent } from "../types/shared.js";
+import { NotificationKind } from "../types/schemas/identity.js";
+import "../types/index.js";
+import "../shared/ports.js";
+import { NewNotification } from "../identity/ports.js";
+import "../identity/index.js";
+import { ActionDeps, EmailRecipient } from "./community-mail.js";
+//#region src/automations/community-notifications.d.ts
+type Placement = Omit<NewNotification, 'userId' | 'kind'>;
+interface NotificationPlacement<K extends NotificationKind> {
+  place(event: DomainEvent, recipient: EmailRecipient<K>, deps: ActionDeps): Promise<Placement[]>;
+}
+declare const NOTIFICATION_PLACEMENTS: { [K in NotificationKind]: NotificationPlacement<K>; };
+//#endregion
+export { NOTIFICATION_PLACEMENTS, NotificationPlacement };
+//# sourceMappingURL=community-notifications.d.ts.map

package/dist/automations/community-notifications.js

@@ -0,0 +1,84 @@
+import { actorOf } from "./community-mail.js";
+//#region src/automations/community-notifications.ts
+function text(event, key) {
+	if (typeof event.data !== "object" || event.data === null) return null;
+	const value = event.data[key];
+	return typeof value === "string" ? value : null;
+}
+function at(communityId, actorOrgUserId, about) {
+	return [{
+		communityId,
+		actorOrgUserId,
+		spaceId: about.spaceId ?? null,
+		postId: about.postId ?? null,
+		commentId: about.commentId ?? null,
+		chatId: about.chatId ?? null,
+		messageId: about.messageId ?? null
+	}];
+}
+function actor(event) {
+	return actorOf(event) ?? null;
+}
+async function spaceOfPost(deps, event, postId) {
+	return postId ? (await deps.mail.post(event.orgId, postId))?.spaceId ?? null : null;
+}
+const NOTIFICATION_PLACEMENTS = {
+	newPostInSpace: { place: async (event, { params }) => at(params.communityId, text(event, "orgUserId"), {
+		postId: params.postId,
+		spaceId: text(event, "spaceId")
+	}) },
+	newCommentOnPost: { place: async (event, { params }, deps) => at(params.communityId, text(event, "orgUserId"), {
+		postId: params.postId,
+		commentId: params.commentId,
+		spaceId: await spaceOfPost(deps, event, params.postId)
+	}) },
+	replyToYourComment: { place: async (event, { params }, deps) => at(params.communityId, text(event, "orgUserId"), {
+		postId: params.postId,
+		commentId: params.commentId,
+		spaceId: await spaceOfPost(deps, event, params.postId)
+	}) },
+	yourPostWasPublished: { place: async (event, { params }) => at(params.communityId, actor(event), {
+		postId: params.postId,
+		spaceId: text(event, "spaceId")
+	}) },
+	yourPostWasRemoved: { place: async (event, { params }) => at(params.communityId, text(event, "removedBy"), {
+		postId: text(event, "id"),
+		spaceId: params.spaceId
+	}) },
+	yourCommentWasRemoved: { place: async (event, { params }, deps) => at(params.communityId, text(event, "removedBy"), {
+		postId: params.postId,
+		commentId: text(event, "id"),
+		spaceId: await spaceOfPost(deps, event, params.postId)
+	}) },
+	requestApproved: { place: async (event, { params }) => at(params.communityId, actor(event), { spaceId: params.spaceId }) },
+	requestDeclined: { place: async (event, { params }) => at(params.communityId, actor(event), { spaceId: text(event, "spaceId") }) },
+	invitedToSpace: { place: async (event, { params }) => at(params.communityId, actor(event), { spaceId: params.spaceId }) },
+	newMessage: { place: async (event, { params }) => at(params.communityId, text(event, "orgUserId"), {
+		chatId: params.chatId,
+		messageId: text(event, "id")
+	}) },
+	messageRequest: { place: async (event, { params }) => at(params.communityId, text(event, "createdBy"), { chatId: params.chatId }) },
+	addedToGroupChat: { place: async (event, { params }) => at(params.communityId, text(event, "addedBy"), { chatId: params.chatId }) },
+	youAreNowAModerator: { place: async (event) => at(null, actor(event), {}) },
+	membershipEndingSoon: { place: async (_event, { params }) => at(params.communityId, null, {}) },
+	welcomeToCommunity: { place: async (event, { params }) => at(params.communityId, actor(event), {}) },
+	postAwaitingReview: { place: async (event, { params }) => at(params.communityId, text(event, "orgUserId"), {
+		postId: text(event, "id"),
+		spaceId: params.spaceId
+	}) },
+	joinRequest: { place: async (event, { params }) => at(params.communityId, text(event, "orgUserId"), { spaceId: params.spaceId }) },
+	somethingWasFlagged: { place: async (event, { params }, deps) => {
+		const commentId = text(event, "commentId");
+		const postId = commentId ? (await deps.mail.comment(event.orgId, commentId))?.postId ?? null : text(event, "postId");
+		return at(params.communityId, text(event, "orgUserId"), {
+			spaceId: params.spaceId,
+			postId,
+			commentId
+		});
+	} },
+	messageWasFlagged: { place: async (event, { params }) => at(params.communityId, text(event, "orgUserId"), { messageId: text(event, "messageId") }) }
+};
+//#endregion
+export { NOTIFICATION_PLACEMENTS };
+
+//# sourceMappingURL=community-notifications.js.map

package/dist/automations/community-notifications.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"community-notifications.js","names":[],"sources":["../../src/automations/community-notifications.ts"],"sourcesContent":["import type { NewNotification } from '../identity/index.js';\nimport type { NotificationKind } from '../types/index.js';\nimport type { DomainEvent } from '../shared/ports.js';\nimport { actorOf, type ActionDeps, type EmailRecipient } from './community-mail.js';\n\ntype Placement = Omit<NewNotification, 'userId' | 'kind'>;\n\nexport interface NotificationPlacement<K extends NotificationKind> {\n  place(event: DomainEvent, recipient: EmailRecipient<K>, deps: ActionDeps): Promise<Placement[]>;\n}\n\ntype About = Partial<Pick<Placement, 'spaceId' | 'postId' | 'commentId' | 'chatId' | 'messageId'>>;\n\nfunction text(event: DomainEvent, key: string): string | null {\n  if (typeof event.data !== 'object' || event.data === null) {\n    return null;\n  }\n  const value = (event.data as Record<string, unknown>)[key];\n  return typeof value === 'string' ? value : null;\n}\n\nfunction at(communityId: string | null, actorOrgUserId: string | null, about: About): Placement[] {\n  return [\n    {\n      communityId,\n      actorOrgUserId,\n      spaceId: about.spaceId ?? null,\n      postId: about.postId ?? null,\n      commentId: about.commentId ?? null,\n      chatId: about.chatId ?? null,\n      messageId: about.messageId ?? null,\n    },\n  ];\n}\n\nfunction actor(event: DomainEvent): string | null {\n  return actorOf(event) ?? null;\n}\n\nasync function spaceOfPost(\n  deps: ActionDeps,\n  event: DomainEvent,\n  postId: string | null,\n): Promise<string | null> {\n  return postId ? ((await deps.mail.post(event.orgId, postId))?.spaceId ?? null) : null;\n}\n\nexport const NOTIFICATION_PLACEMENTS: {\n  [K in NotificationKind]: NotificationPlacement<K>;\n} = {\n  newPostInSpace: {\n    place: async (event, { params }) =>\n      at(params.communityId, text(event, 'orgUserId'), {\n        postId: params.postId,\n        spaceId: text(event, 'spaceId'),\n      }),\n  },\n  newCommentOnPost: {\n    place: async (event, { params }, deps) =>\n      at(params.communityId, text(event, 'orgUserId'), {\n        postId: params.postId,\n        commentId: params.commentId,\n        spaceId: await spaceOfPost(deps, event, params.postId),\n      }),\n  },\n  replyToYourComment: {\n    place: async (event, { params }, deps) =>\n      at(params.communityId, text(event, 'orgUserId'), {\n        postId: params.postId,\n        commentId: params.commentId,\n        spaceId: await spaceOfPost(deps, event, params.postId),\n      }),\n  },\n  yourPostWasPublished: {\n    place: async (event, { params }) =>\n      at(params.communityId, actor(event), {\n        postId: params.postId,\n        spaceId: text(event, 'spaceId'),\n      }),\n  },\n  yourPostWasRemoved: {\n    place: async (event, { params }) =>\n      at(params.communityId, text(event, 'removedBy'), {\n        postId: text(event, 'id'),\n        spaceId: params.spaceId,\n      }),\n  },\n  yourCommentWasRemoved: {\n    place: async (event, { params }, deps) =>\n      at(params.communityId, text(event, 'removedBy'), {\n        postId: params.postId,\n        commentId: text(event, 'id'),\n        spaceId: await spaceOfPost(deps, event, params.postId),\n      }),\n  },\n  requestApproved: {\n    place: async (event, { params }) =>\n      at(params.communityId, actor(event), { spaceId: params.spaceId }),\n  },\n  requestDeclined: {\n    place: async (event, { params }) =>\n      at(params.communityId, actor(event), { spaceId: text(event, 'spaceId') }),\n  },\n  invitedToSpace: {\n    place: async (event, { params }) =>\n      at(params.communityId, actor(event), { spaceId: params.spaceId }),\n  },\n  newMessage: {\n    place: async (event, { params }) =>\n      at(params.communityId, text(event, 'orgUserId'), {\n        chatId: params.chatId,\n        messageId: text(event, 'id'),\n      }),\n  },\n  messageRequest: {\n    place: async (event, { params }) =>\n      at(params.communityId, text(event, 'createdBy'), { chatId: params.chatId }),\n  },\n  addedToGroupChat: {\n    place: async (event, { params }) =>\n      at(params.communityId, text(event, 'addedBy'), { chatId: params.chatId }),\n  },\n  youAreNowAModerator: {\n    place: async (event) => at(null, actor(event), {}),\n  },\n  membershipEndingSoon: {\n    place: async (_event, { params }) => at(params.communityId, null, {}),\n  },\n  welcomeToCommunity: {\n    place: async (event, { params }) => at(params.communityId, actor(event), {}),\n  },\n  postAwaitingReview: {\n    place: async (event, { params }) =>\n      at(params.communityId, text(event, 'orgUserId'), {\n        postId: text(event, 'id'),\n        spaceId: params.spaceId,\n      }),\n  },\n  joinRequest: {\n    place: async (event, { params }) =>\n      at(params.communityId, text(event, 'orgUserId'), { spaceId: params.spaceId }),\n  },\n  somethingWasFlagged: {\n    place: async (event, { params }, deps) => {\n      const commentId = text(event, 'commentId');\n      const postId = commentId\n        ? ((await deps.mail.comment(event.orgId, commentId))?.postId ?? null)\n        : text(event, 'postId');\n      return at(params.communityId, text(event, 'orgUserId'), {\n        spaceId: params.spaceId,\n        postId,\n        commentId,\n      });\n    },\n  },\n  messageWasFlagged: {\n    place: async (event, { params }) =>\n      at(params.communityId, text(event, 'orgUserId'), { messageId: text(event, 'messageId') }),\n  },\n};\n"],"mappings":"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"}

package/dist/automations/events.d.ts

@@ -7,137 +7,167 @@ declare const automationEvents: {
     orgId: string;
     id: string;
     name: string;
+    kind: "workflow" | "webhook";
     description: string | null;
-    trigger: string;
+    triggers: string[];
     actions: {
       type: string;
       input: Record<string, JsonValue>;
     }[];
     enabled: boolean;
+    filter: Record<string, JsonValue> | null;
+    source: "system" | "user";
     createdAt: Date;
     updatedAt: Date;
-  }, "automation.created", 1>, {
+  }, "automation.created", 2>, {
     orgId: string;
     id: string;
     name: string;
+    kind: "workflow" | "webhook";
     description: string | null;
-    trigger: string;
+    triggers: string[];
     actions: {
       type: string;
       input: Record<string, unknown>;
     }[];
     enabled: boolean;
+    filter: Record<string, unknown> | null;
+    source: "system" | "user";
     createdAt: unknown;
     updatedAt: unknown;
-  }>;
+  }, undefined>;
   automationUpdated: RuntimeEventDefinition<VersionedDomainEvent<{
     orgId: string;
     id: string;
     name: string;
+    kind: "workflow" | "webhook";
     description: string | null;
-    trigger: string;
+    triggers: string[];
     actions: {
       type: string;
       input: Record<string, JsonValue>;
     }[];
     enabled: boolean;
+    filter: Record<string, JsonValue> | null;
+    source: "system" | "user";
     createdAt: Date;
     updatedAt: Date;
-  }, "automation.updated", 1>, {
+  }, "automation.updated", 2>, {
     orgId: string;
     id: string;
     name: string;
+    kind: "workflow" | "webhook";
     description: string | null;
-    trigger: string;
+    triggers: string[];
     actions: {
       type: string;
       input: Record<string, unknown>;
     }[];
     enabled: boolean;
+    filter: Record<string, unknown> | null;
+    source: "system" | "user";
     createdAt: unknown;
     updatedAt: unknown;
-  }>;
+  }, undefined>;
   automationDeleted: RuntimeEventDefinition<VersionedDomainEvent<{
     orgId: string;
     id: string;
     name: string;
+    kind: "workflow" | "webhook";
     description: string | null;
-    trigger: string;
+    triggers: string[];
     actions: {
       type: string;
       input: Record<string, JsonValue>;
     }[];
     enabled: boolean;
+    filter: Record<string, JsonValue> | null;
+    source: "system" | "user";
     createdAt: Date;
     updatedAt: Date;
-  }, "automation.deleted", 1>, {
+  }, "automation.deleted", 2>, {
     orgId: string;
     id: string;
     name: string;
+    kind: "workflow" | "webhook";
     description: string | null;
-    trigger: string;
+    triggers: string[];
     actions: {
       type: string;
       input: Record<string, unknown>;
     }[];
     enabled: boolean;
+    filter: Record<string, unknown> | null;
+    source: "system" | "user";
     createdAt: unknown;
     updatedAt: unknown;
-  }>;
+  }, undefined>;
   automationEnabled: RuntimeEventDefinition<VersionedDomainEvent<{
     orgId: string;
     id: string;
     name: string;
+    kind: "workflow" | "webhook";
     description: string | null;
-    trigger: string;
+    triggers: string[];
     actions: {
       type: string;
       input: Record<string, JsonValue>;
     }[];
     enabled: boolean;
+    filter: Record<string, JsonValue> | null;
+    source: "system" | "user";
     createdAt: Date;
     updatedAt: Date;
-  }, "automation.enabled", 1>, {
+  }, "automation.enabled", 2>, {
     orgId: string;
     id: string;
     name: string;
+    kind: "workflow" | "webhook";
     description: string | null;
-    trigger: string;
+    triggers: string[];
     actions: {
       type: string;
       input: Record<string, unknown>;
     }[];
     enabled: boolean;
+    filter: Record<string, unknown> | null;
+    source: "system" | "user";
     createdAt: unknown;
     updatedAt: unknown;
-  }>;
+  }, undefined>;
   automationDisabled: RuntimeEventDefinition<VersionedDomainEvent<{
     orgId: string;
     id: string;
     name: string;
+    kind: "workflow" | "webhook";
     description: string | null;
-    trigger: string;
+    triggers: string[];
     actions: {
       type: string;
       input: Record<string, JsonValue>;
     }[];
     enabled: boolean;
+    filter: Record<string, JsonValue> | null;
+    source: "system" | "user";
     createdAt: Date;
     updatedAt: Date;
-  }, "automation.disabled", 1>, {
+  }, "automation.disabled", 2>, {
     orgId: string;
     id: string;
     name: string;
+    kind: "workflow" | "webhook";
     description: string | null;
-    trigger: string;
+    triggers: string[];
     actions: {
       type: string;
       input: Record<string, unknown>;
     }[];
     enabled: boolean;
+    filter: Record<string, unknown> | null;
+    source: "system" | "user";
     createdAt: unknown;
     updatedAt: unknown;
-  }>;
+  }, undefined>;
   runStarted: RuntimeEventDefinition<VersionedDomainEvent<{
     orgId: string;
     id: string;
@@ -151,9 +181,12 @@ declare const automationEvents: {
       type: string;
       status: "completed" | "failed";
       error?: string | undefined;
+      recipients?: string[] | undefined;
     }[];
     startedAt: Date;
     finishedAt: Date | null;
+    createdAt: Date;
+    updatedAt: Date;
   }, "automation.run.started", 1>, {
     orgId: string;
     id: string;
@@ -167,10 +200,13 @@ declare const automationEvents: {
       type: string;
       status: "completed" | "failed";
       error?: string | undefined;
+      recipients?: string[] | undefined;
     }[];
     startedAt: unknown;
     finishedAt: unknown;
-  }>;
+    createdAt: unknown;
+    updatedAt: unknown;
+  }, undefined>;
   runCompleted: RuntimeEventDefinition<VersionedDomainEvent<{
     orgId: string;
     id: string;
@@ -184,9 +220,12 @@ declare const automationEvents: {
       type: string;
       status: "completed" | "failed";
       error?: string | undefined;
+      recipients?: string[] | undefined;
     }[];
     startedAt: Date;
     finishedAt: Date | null;
+    createdAt: Date;
+    updatedAt: Date;
   }, "automation.run.completed", 1>, {
     orgId: string;
     id: string;
@@ -200,10 +239,13 @@ declare const automationEvents: {
       type: string;
       status: "completed" | "failed";
       error?: string | undefined;
+      recipients?: string[] | undefined;
     }[];
     startedAt: unknown;
     finishedAt: unknown;
-  }>;
+    createdAt: unknown;
+    updatedAt: unknown;
+  }, undefined>;
   runFailed: RuntimeEventDefinition<VersionedDomainEvent<{
     orgId: string;
     id: string;
@@ -217,9 +259,12 @@ declare const automationEvents: {
       type: string;
       status: "completed" | "failed";
       error?: string | undefined;
+      recipients?: string[] | undefined;
     }[];
     startedAt: Date;
     finishedAt: Date | null;
+    createdAt: Date;
+    updatedAt: Date;
   }, "automation.run.failed", 1>, {
     orgId: string;
     id: string;
@@ -233,21 +278,26 @@ declare const automationEvents: {
       type: string;
       status: "completed" | "failed";
       error?: string | undefined;
+      recipients?: string[] | undefined;
     }[];
     startedAt: unknown;
     finishedAt: unknown;
-  }>;
+    createdAt: unknown;
+    updatedAt: unknown;
+  }, undefined>;
   actionFailed: RuntimeEventDefinition<VersionedDomainEvent<{
     index: number;
     type: string;
     status: "completed" | "failed";
     error?: string | undefined;
+    recipients?: string[] | undefined;
   }, "automation.action.failed", 1>, {
     index: number;
     type: string;
     status: "completed" | "failed";
     error?: string | undefined;
-  }>;
+    recipients?: string[] | undefined;
+  }, undefined>;
 };
 type AutomationCreated = EventOf<typeof automationEvents.automationCreated>;
 type AutomationUpdated = EventOf<typeof automationEvents.automationUpdated>;

package/dist/automations/events.js

@@ -4,27 +4,27 @@ import { defineEvent } from "../shared/events.js";
 const automationEvents = {
 	automationCreated: defineEvent({
 		type: "automation.created",
-		version: 1,
+		version: 2,
 		data: automationSchema
 	}),
 	automationUpdated: defineEvent({
 		type: "automation.updated",
-		version: 1,
+		version: 2,
 		data: automationSchema
 	}),
 	automationDeleted: defineEvent({
 		type: "automation.deleted",
-		version: 1,
+		version: 2,
 		data: automationSchema
 	}),
 	automationEnabled: defineEvent({
 		type: "automation.enabled",
-		version: 1,
+		version: 2,
 		data: automationSchema
 	}),
 	automationDisabled: defineEvent({
 		type: "automation.disabled",
-		version: 1,
+		version: 2,
 		data: automationSchema
 	}),
 	runStarted: defineEvent({