@headless-lms/core 0.2.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

@@ -15,6 +15,8 @@ declare const automationEvents: {
       input: Record<string, JsonValue>;
     }[];
     enabled: boolean;
+    filter: Record<string, JsonValue> | null;
+    source: "system" | "user";
     createdAt: Date;
     updatedAt: Date;
   }, "automation.created", 2>, {
@@ -29,6 +31,8 @@ declare const automationEvents: {
       input: Record<string, unknown>;
     }[];
     enabled: boolean;
+    filter: Record<string, unknown> | null;
+    source: "system" | "user";
     createdAt: unknown;
     updatedAt: unknown;
   }, undefined>;
@@ -44,6 +48,8 @@ declare const automationEvents: {
       input: Record<string, JsonValue>;
     }[];
     enabled: boolean;
+    filter: Record<string, JsonValue> | null;
+    source: "system" | "user";
     createdAt: Date;
     updatedAt: Date;
   }, "automation.updated", 2>, {
@@ -58,6 +64,8 @@ declare const automationEvents: {
       input: Record<string, unknown>;
     }[];
     enabled: boolean;
+    filter: Record<string, unknown> | null;
+    source: "system" | "user";
     createdAt: unknown;
     updatedAt: unknown;
   }, undefined>;
@@ -73,6 +81,8 @@ declare const automationEvents: {
       input: Record<string, JsonValue>;
     }[];
     enabled: boolean;
+    filter: Record<string, JsonValue> | null;
+    source: "system" | "user";
     createdAt: Date;
     updatedAt: Date;
   }, "automation.deleted", 2>, {
@@ -87,6 +97,8 @@ declare const automationEvents: {
       input: Record<string, unknown>;
     }[];
     enabled: boolean;
+    filter: Record<string, unknown> | null;
+    source: "system" | "user";
     createdAt: unknown;
     updatedAt: unknown;
   }, undefined>;
@@ -102,6 +114,8 @@ declare const automationEvents: {
       input: Record<string, JsonValue>;
     }[];
     enabled: boolean;
+    filter: Record<string, JsonValue> | null;
+    source: "system" | "user";
     createdAt: Date;
     updatedAt: Date;
   }, "automation.enabled", 2>, {
@@ -116,6 +130,8 @@ declare const automationEvents: {
       input: Record<string, unknown>;
     }[];
     enabled: boolean;
+    filter: Record<string, unknown> | null;
+    source: "system" | "user";
     createdAt: unknown;
     updatedAt: unknown;
   }, undefined>;
@@ -131,6 +147,8 @@ declare const automationEvents: {
       input: Record<string, JsonValue>;
     }[];
     enabled: boolean;
+    filter: Record<string, JsonValue> | null;
+    source: "system" | "user";
     createdAt: Date;
     updatedAt: Date;
   }, "automation.disabled", 2>, {
@@ -145,6 +163,8 @@ declare const automationEvents: {
       input: Record<string, unknown>;
     }[];
     enabled: boolean;
+    filter: Record<string, unknown> | null;
+    source: "system" | "user";
     createdAt: unknown;
     updatedAt: unknown;
   }, undefined>;
@@ -161,6 +181,7 @@ declare const automationEvents: {
       type: string;
       status: "completed" | "failed";
       error?: string | undefined;
+      recipients?: string[] | undefined;
     }[];
     startedAt: Date;
     finishedAt: Date | null;
@@ -179,6 +200,7 @@ declare const automationEvents: {
       type: string;
       status: "completed" | "failed";
       error?: string | undefined;
+      recipients?: string[] | undefined;
     }[];
     startedAt: unknown;
     finishedAt: unknown;
@@ -198,6 +220,7 @@ declare const automationEvents: {
       type: string;
       status: "completed" | "failed";
       error?: string | undefined;
+      recipients?: string[] | undefined;
     }[];
     startedAt: Date;
     finishedAt: Date | null;
@@ -216,6 +239,7 @@ declare const automationEvents: {
       type: string;
       status: "completed" | "failed";
       error?: string | undefined;
+      recipients?: string[] | undefined;
     }[];
     startedAt: unknown;
     finishedAt: unknown;
@@ -235,6 +259,7 @@ declare const automationEvents: {
       type: string;
       status: "completed" | "failed";
       error?: string | undefined;
+      recipients?: string[] | undefined;
     }[];
     startedAt: Date;
     finishedAt: Date | null;
@@ -253,6 +278,7 @@ declare const automationEvents: {
       type: string;
       status: "completed" | "failed";
       error?: string | undefined;
+      recipients?: string[] | undefined;
     }[];
     startedAt: unknown;
     finishedAt: unknown;
@@ -264,11 +290,13 @@ declare const automationEvents: {
     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>;

package/dist/automations/index.d.ts

@@ -1,9 +1,11 @@
 import { Page } from "../types/shared.js";
 import { Automation, AutomationAction, AutomationActionResult, AutomationKind, AutomationRun, AutomationRunStatus, AutomationRunsQuery, AutomationTrigger, AutomationsQuery, AvailableAction, AvailableActions, AvailableTriggers, CreateAutomationInput, CreateWebhookInput, CreatedWebhook, UpdateAutomationInput, UpdateWebhookInput, Webhook, WebhookSecret } from "../types/schemas/automations.js";
 import { AutomationDispatch, AutomationEngine, AutomationExecutor, WebhookRequest, WebhookResponse, WebhookSender } from "../types/automations.js";
-import { AutomationKindMismatchError, InvalidTriggerError, ReservedActionError } from "./model.js";
+import { ACTION_FAILED, ActionFailedError, AutomationKindMismatchError, InvalidTriggerError, ReservedActionError, actionFailureMessage } from "./model.js";
 import "./types.js";
 import { AutomationRunsRepository, AutomationsRepository, AutomationsService, AutomationsUnitOfWork, NewAutomation, NewAutomationRun } from "./ports.js";
+import { CommunityMailReads, GrantWriter, ScheduledWork } from "./community-mail.js";
 import { AutomationActionFailed, AutomationCreated, AutomationDeleted, AutomationDisabled, AutomationEnabled, AutomationEvent, AutomationRunCompleted, AutomationRunFailed, AutomationRunStarted, AutomationUpdated, automationEvents } from "./events.js";
 import { AutomationsServiceImpl } from "./service.js";
-export { type Automation, type AutomationAction, type AutomationActionFailed, type AutomationActionResult, type AutomationCreated, type AutomationDeleted, type AutomationDisabled, type AutomationDispatch, type AutomationEnabled, type AutomationEngine, type AutomationEvent, type AutomationExecutor, type AutomationKind, AutomationKindMismatchError, type AutomationRun, type AutomationRunCompleted, type AutomationRunFailed, type AutomationRunStarted, type AutomationRunStatus, type AutomationRunsQuery, type AutomationRunsRepository, type AutomationTrigger, type AutomationUpdated, type AutomationsQuery, type AutomationsRepository, type AutomationsService, AutomationsServiceImpl, type AutomationsUnitOfWork, type AvailableAction, type AvailableActions, type AvailableTriggers, type CreateAutomationInput, type CreateWebhookInput, type CreatedWebhook, InvalidTriggerError, type NewAutomation, type NewAutomationRun, type Page, ReservedActionError, type UpdateAutomationInput, type UpdateWebhookInput, type Webhook, type WebhookRequest, type WebhookResponse, type WebhookSecret, type WebhookSender, automationEvents };
+import { cronMatches } from "./schedule.js";
+export { ACTION_FAILED, ActionFailedError, type Automation, type AutomationAction, type AutomationActionFailed, type AutomationActionResult, type AutomationCreated, type AutomationDeleted, type AutomationDisabled, type AutomationDispatch, type AutomationEnabled, type AutomationEngine, type AutomationEvent, type AutomationExecutor, type AutomationKind, AutomationKindMismatchError, type AutomationRun, type AutomationRunCompleted, type AutomationRunFailed, type AutomationRunStarted, type AutomationRunStatus, type AutomationRunsQuery, type AutomationRunsRepository, type AutomationTrigger, type AutomationUpdated, type AutomationsQuery, type AutomationsRepository, type AutomationsService, AutomationsServiceImpl, type AutomationsUnitOfWork, type AvailableAction, type AvailableActions, type AvailableTriggers, type CommunityMailReads, type CreateAutomationInput, type CreateWebhookInput, type CreatedWebhook, type GrantWriter, InvalidTriggerError, type NewAutomation, type NewAutomationRun, type Page, ReservedActionError, type ScheduledWork, type UpdateAutomationInput, type UpdateWebhookInput, type Webhook, type WebhookRequest, type WebhookResponse, type WebhookSecret, type WebhookSender, actionFailureMessage, automationEvents, cronMatches };

package/dist/automations/index.js

@@ -1,4 +1,5 @@
+import { ACTION_FAILED, ActionFailedError, AutomationKindMismatchError, InvalidTriggerError, ReservedActionError, actionFailureMessage } from "./model.js";
 import { automationEvents } from "./events.js";
-import { AutomationKindMismatchError, InvalidTriggerError, ReservedActionError } from "./model.js";
+import { cronMatches } from "./schedule.js";
 import { AutomationsServiceImpl } from "./service.js";
-export { AutomationKindMismatchError, AutomationsServiceImpl, InvalidTriggerError, ReservedActionError, automationEvents };
+export { ACTION_FAILED, ActionFailedError, AutomationKindMismatchError, AutomationsServiceImpl, InvalidTriggerError, ReservedActionError, actionFailureMessage, automationEvents, cronMatches };

package/dist/automations/model.d.ts

@@ -5,9 +5,16 @@ import "../types/index.js";
 /** Rejected at authoring time: automation.* is reserved to avoid a self-triggering loop. */
 declare class InvalidTriggerError extends Error {
   readonly trigger: string;
-  readonly reason: 'reserved' | 'unknown';
-  constructor(trigger: string, reason?: 'reserved' | 'unknown');
+  readonly reason: 'reserved' | 'unknown' | 'schedule';
+  constructor(trigger: string, reason?: 'reserved' | 'unknown' | 'schedule');
 }
+declare const ACTION_FAILED = "The action failed";
+/** An action failure whose message is safe to record on the run. */
+declare class ActionFailedError extends Error {
+  constructor(message?: string);
+}
+/** The message a run records for an action that threw `err`. */
+declare function actionFailureMessage(err: unknown): string;
 declare class ReservedActionError extends Error {
   readonly actionType: string;
   constructor(actionType: string);
@@ -18,5 +25,5 @@ declare class AutomationKindMismatchError extends Error {
   constructor(automationId: string, kind: AutomationKind);
 }
 //#endregion
-export { type Automation, type AutomationAction, type AutomationActionResult, type AutomationKind, AutomationKindMismatchError, type AutomationRun, type AutomationRunStatus, type AutomationTrigger, type CreatedWebhook, type DeliverWebhookInput, InvalidTriggerError, type Page, ReservedActionError, type Webhook, type WebhookSecret };
+export { ACTION_FAILED, ActionFailedError, type Automation, type AutomationAction, type AutomationActionResult, type AutomationKind, AutomationKindMismatchError, type AutomationRun, type AutomationRunStatus, type AutomationTrigger, type CreatedWebhook, type DeliverWebhookInput, InvalidTriggerError, type Page, ReservedActionError, type Webhook, type WebhookSecret, actionFailureMessage };
 //# sourceMappingURL=model.d.ts.map

package/dist/automations/model.js

@@ -4,12 +4,25 @@ var InvalidTriggerError = class extends Error {
 	trigger;
 	reason;
 	constructor(trigger, reason = "reserved") {
-		super(reason === "reserved" ? `trigger "${trigger}" is reserved: automations cannot trigger on automation.* events` : `trigger "${trigger}" is not an event the system emits`);
+		const message = reason === "reserved" ? `trigger "${trigger}" is reserved: automations cannot trigger on automation.* events` : reason === "unknown" ? `trigger "${trigger}" is not an event the system emits` : `trigger "${trigger}" uses a schedule this system cannot match`;
+		super(message);
 		this.trigger = trigger;
 		this.reason = reason;
 		this.name = "InvalidTriggerError";
 	}
 };
+const ACTION_FAILED = "The action failed";
+/** An action failure whose message is safe to record on the run. */
+var ActionFailedError = class extends Error {
+	constructor(message = ACTION_FAILED) {
+		super(message);
+		this.name = "ActionFailedError";
+	}
+};
+/** The message a run records for an action that threw `err`. */
+function actionFailureMessage(err) {
+	return err instanceof ActionFailedError ? err.message : ACTION_FAILED;
+}
 var ReservedActionError = class extends Error {
 	actionType;
 	constructor(actionType) {
@@ -29,6 +42,6 @@ var AutomationKindMismatchError = class extends Error {
 	}
 };
 //#endregion
-export { AutomationKindMismatchError, InvalidTriggerError, ReservedActionError };
+export { ACTION_FAILED, ActionFailedError, AutomationKindMismatchError, InvalidTriggerError, ReservedActionError, actionFailureMessage };
 
 //# sourceMappingURL=model.js.map

package/dist/automations/model.js.map

@@ -1 +1 @@
-{"version":3,"file":"model.js","names":[],"sources":["../../src/automations/model.ts"],"sourcesContent":["// automations context — domain entities, owned by @headless-lms/core/types; the\n// domain errors below are runtime code and stay in core.\nimport type { AutomationKind } from '../types/index.js';\n\nexport type {\n  AutomationTrigger,\n  AutomationAction,\n  AutomationKind,\n  Automation,\n  AutomationRunStatus,\n  AutomationActionResult,\n  AutomationRun,\n  Webhook,\n  CreatedWebhook,\n  WebhookSecret,\n  DeliverWebhookInput,\n  Page,\n} from '../types/index.js';\n\n/** Rejected at authoring time: automation.* is reserved to avoid a self-triggering loop. */\nexport class InvalidTriggerError extends Error {\n  constructor(\n    readonly trigger: string,\n    readonly reason: 'reserved' | 'unknown' = 'reserved',\n  ) {\n    super(\n      reason === 'reserved'\n        ? `trigger \"${trigger}\" is reserved: automations cannot trigger on automation.* events`\n        : `trigger \"${trigger}\" is not an event the system emits`,\n    );\n    this.name = 'InvalidTriggerError';\n  }\n}\n\nexport class ReservedActionError extends Error {\n  constructor(readonly actionType: string) {\n    super(`action \"${actionType}\" is reserved to webhooks`);\n    this.name = 'ReservedActionError';\n  }\n}\n\nexport class AutomationKindMismatchError extends Error {\n  constructor(\n    readonly automationId: string,\n    readonly kind: AutomationKind,\n  ) {\n    super(`automation \"${automationId}\" is a ${kind} and can't be changed through this operation`);\n    this.name = 'AutomationKindMismatchError';\n  }\n}\n"],"mappings":";;AAoBA,IAAa,sBAAb,cAAyC,MAAM;CAElC;CACA;CAFX,YACE,SACA,SAA0C,YAC1C;EACA,MACE,WAAW,aACP,YAAY,QAAQ,oEACpB,YAAY,QAAQ,mCAC1B;EAPS,KAAA,UAAA;EACA,KAAA,SAAA;EAOT,KAAK,OAAO;CACd;AACF;AAEA,IAAa,sBAAb,cAAyC,MAAM;CACxB;CAArB,YAAY,YAA6B;EACvC,MAAM,WAAW,WAAW,0BAA0B;EADnC,KAAA,aAAA;EAEnB,KAAK,OAAO;CACd;AACF;AAEA,IAAa,8BAAb,cAAiD,MAAM;CAE1C;CACA;CAFX,YACE,cACA,MACA;EACA,MAAM,eAAe,aAAa,SAAS,KAAK,6CAA6C;EAHpF,KAAA,eAAA;EACA,KAAA,OAAA;EAGT,KAAK,OAAO;CACd;AACF"}
+{"version":3,"file":"model.js","names":[],"sources":["../../src/automations/model.ts"],"sourcesContent":["// automations context — domain entities, owned by @headless-lms/core/types; the\n// domain errors below are runtime code and stay in core.\nimport type { AutomationKind } from '../types/index.js';\n\nexport type {\n  AutomationTrigger,\n  AutomationAction,\n  AutomationKind,\n  Automation,\n  AutomationRunStatus,\n  AutomationActionResult,\n  AutomationRun,\n  Webhook,\n  CreatedWebhook,\n  WebhookSecret,\n  DeliverWebhookInput,\n  Page,\n} from '../types/index.js';\n\n/** Rejected at authoring time: automation.* is reserved to avoid a self-triggering loop. */\nexport class InvalidTriggerError extends Error {\n  constructor(\n    readonly trigger: string,\n    readonly reason: 'reserved' | 'unknown' | 'schedule' = 'reserved',\n  ) {\n    const message =\n      reason === 'reserved'\n        ? `trigger \"${trigger}\" is reserved: automations cannot trigger on automation.* events`\n        : reason === 'unknown'\n          ? `trigger \"${trigger}\" is not an event the system emits`\n          : `trigger \"${trigger}\" uses a schedule this system cannot match`;\n    super(message);\n    this.name = 'InvalidTriggerError';\n  }\n}\n\nexport const ACTION_FAILED = 'The action failed';\n\n/** An action failure whose message is safe to record on the run. */\nexport class ActionFailedError extends Error {\n  constructor(message: string = ACTION_FAILED) {\n    super(message);\n    this.name = 'ActionFailedError';\n  }\n}\n\n/** The message a run records for an action that threw `err`. */\nexport function actionFailureMessage(err: unknown): string {\n  return err instanceof ActionFailedError ? err.message : ACTION_FAILED;\n}\n\nexport class ReservedActionError extends Error {\n  constructor(readonly actionType: string) {\n    super(`action \"${actionType}\" is reserved to webhooks`);\n    this.name = 'ReservedActionError';\n  }\n}\n\nexport class AutomationKindMismatchError extends Error {\n  constructor(\n    readonly automationId: string,\n    readonly kind: AutomationKind,\n  ) {\n    super(`automation \"${automationId}\" is a ${kind} and can't be changed through this operation`);\n    this.name = 'AutomationKindMismatchError';\n  }\n}\n"],"mappings":";;AAoBA,IAAa,sBAAb,cAAyC,MAAM;CAElC;CACA;CAFX,YACE,SACA,SAAuD,YACvD;EACA,MAAM,UACJ,WAAW,aACP,YAAY,QAAQ,oEACpB,WAAW,YACT,YAAY,QAAQ,sCACpB,YAAY,QAAQ;EAC5B,MAAM,OAAO;EATJ,KAAA,UAAA;EACA,KAAA,SAAA;EAST,KAAK,OAAO;CACd;AACF;AAEA,MAAa,gBAAgB;;AAG7B,IAAa,oBAAb,cAAuC,MAAM;CAC3C,YAAY,UAAkB,eAAe;EAC3C,MAAM,OAAO;EACb,KAAK,OAAO;CACd;AACF;;AAGA,SAAgB,qBAAqB,KAAsB;CACzD,OAAO,eAAe,oBAAoB,IAAI,UAAU;AAC1D;AAEA,IAAa,sBAAb,cAAyC,MAAM;CACxB;CAArB,YAAY,YAA6B;EACvC,MAAM,WAAW,WAAW,0BAA0B;EADnC,KAAA,aAAA;EAEnB,KAAK,OAAO;CACd;AACF;AAEA,IAAa,8BAAb,cAAiD,MAAM;CAE1C;CACA;CAFX,YACE,cACA,MACA;EACA,MAAM,eAAe,aAAa,SAAS,KAAK,6CAA6C;EAHpF,KAAA,eAAA;EACA,KAAA,OAAA;EAGT,KAAK,OAAO;CACd;AACF"}

package/dist/automations/ports.d.ts

@@ -1,6 +1,6 @@
 import { DomainEvent, Page } from "../types/shared.js";
 import { Automation, AutomationKind, AutomationRun, AutomationRunsQuery, AutomationsQuery, AvailableActions, AvailableTriggers, CreateAutomationInput, CreateWebhookInput, CreatedWebhook, UpdateAutomationInput, UpdateWebhookInput, Webhook, WebhookSecret } from "../types/schemas/automations.js";
-import { AutomationDispatch, AutomationEngine, AutomationExecutor, WebhookRequest, WebhookResponse, WebhookSender } from "../types/automations.js";
+import { AutomationDispatch, AutomationEngine, AutomationExecutor, ScheduledAutomation, WebhookRequest, WebhookResponse, WebhookSender } from "../types/automations.js";
 import "../types/index.js";
 import { CredentialStore, OutboxAppender, UnitOfWork } from "../shared/ports.js";
 import "./model.js";
@@ -8,6 +8,7 @@ import "./types.js";
 //#region src/automations/ports.d.ts
 type NewAutomation = CreateAutomationInput & {
   kind: AutomationKind;
+  source?: 'system' | 'user';
 };
 /** A run row before persistence assigns its id and event_id. */
 type NewAutomationRun = Omit<AutomationRun, 'id' | 'eventId'>;
@@ -35,6 +36,7 @@ interface AutomationsService {
 }
 interface AutomationsRepository {
   insert(orgId: string, input: NewAutomation): Promise<Automation>;
+  insertSeed(orgId: string, input: NewAutomation): Promise<Automation | null>;
   update(orgId: string, id: string, patch: UpdateAutomationInput): Promise<Automation | null>;
   /** Returns the deleted row (the event snapshot), or null if it didn't exist. */
   delete(orgId: string, id: string): Promise<Automation | null>;
@@ -42,6 +44,7 @@ interface AutomationsRepository {
   listByOrg(orgId: string, kind?: AutomationKind): Promise<Automation[]>;
   /** All rows whose triggers include `trigger`, enabled and disabled alike — the service filters to `enabled`. */
   listByTrigger(orgId: string, trigger: string): Promise<Automation[]>;
+  listSchedules(): Promise<ScheduledAutomation[]>;
 }
 interface AutomationRunsRepository {
   /** Keyed by (orgId, automationId, event.id); returns `null` if this event was already run for this automation (duplicate). */
@@ -55,6 +58,7 @@ interface AutomationRunsRepository {
     finishedAt: Date;
   }): Promise<AutomationRun | null>;
   list(orgId: string, automationId: string, query: AutomationRunsQuery): Promise<Page<AutomationRun>>;
+  recentRecipients(orgId: string, automationId: string, chatId: string, since: Date): Promise<string[]>;
 }
 /** Tx-scoped port bundle for this context's mutating use cases — every member
  *  is bound to the UnitOfWork's transaction, so the write(s) and the event

package/dist/automations/schedule.d.ts

@@ -0,0 +1,6 @@
+//#region src/automations/schedule.d.ts
+declare function cronMatches(expression: string, at: Date): boolean;
+declare function cronSupported(expression: string): boolean;
+//#endregion
+export { cronMatches, cronSupported };
+//# sourceMappingURL=schedule.d.ts.map