@headless-lms/core 0.2.0 → 0.4.0

package/dist/automations/actions.js

@@ -1,75 +1,128 @@
 import { deliverWebhookInputSchema } from "../types/schemas/automations.js";
+import { noopLogger } from "../shared/logger.js";
 import { entitlementEvents } from "../entitlements/events.js";
+import { ActionFailedError } from "./model.js";
 import { ALL_EMAIL_TEMPLATE_IDS, DELIVER_WEBHOOK_ACTION, publicDataSchema } from "./catalog.js";
 import { webhookHeaders } from "./webhook-signing.js";
+import { address } from "./community-mail.js";
+import { COMMUNITY_DERIVATIONS } from "./community-derivations.js";
 //#region src/automations/actions.ts
 const SEND_EMAIL_DERIVATIONS = {
 	accessGranted: {
-		trigger: "entitlement.created",
-		derive: async (event, lookups) => {
+		triggers: ["entitlement.created"],
+		derive: async (event, deps) => {
 			const result = entitlementEvents.entitlementCreated.safeParse(event);
 			if (!result.success) return;
 			const entitlement = result.data.data;
-			if (!entitlement.contentId) return;
-			const [to, content] = await Promise.all([lookups.orgUserEmail(entitlement.orgId, entitlement.orgUserId), lookups.contentInfo(entitlement.orgId, entitlement.contentId)]);
-			if (!to || !content) return;
-			return {
-				to,
-				params: {
-					contentTitle: content.title,
-					contentId: content.id,
-					contentType: content.type
-				}
-			};
+			if (!entitlement.contentId) return [];
+			const content = await deps.lookups.contentInfo(entitlement.orgId, entitlement.contentId);
+			if (!content) return;
+			return address(deps, event, entitlement.orgId, [entitlement.orgUserId], {
+				contentTitle: content.title,
+				contentId: content.id,
+				contentType: content.type
+			});
 		}
 	},
 	accessRevoked: {
-		trigger: "entitlement.deleted",
-		derive: async (event, lookups) => {
+		triggers: ["entitlement.deleted"],
+		derive: async (event, deps) => {
 			const result = entitlementEvents.entitlementDeleted.safeParse(event);
 			if (!result.success) return;
 			const entitlement = result.data.data;
-			if (!entitlement.contentId) return;
-			const [to, content] = await Promise.all([lookups.orgUserEmail(entitlement.orgId, entitlement.orgUserId), lookups.contentInfo(entitlement.orgId, entitlement.contentId)]);
-			if (!to || !content) return;
-			return {
-				to,
-				params: { contentTitle: content.title }
-			};
+			if (!entitlement.contentId) return [];
+			const content = await deps.lookups.contentInfo(entitlement.orgId, entitlement.contentId);
+			if (!content) return;
+			return address(deps, event, entitlement.orgId, [entitlement.orgUserId], { contentTitle: content.title });
 		}
-	}
+	},
+	...COMMUNITY_DERIVATIONS
 };
+function reachedNoOne() {
+	return {
+		recipients: [],
+		failed: []
+	};
+}
+function assertSomeDelivered(action, outcome) {
+	if (outcome.recipients.length === 0 && outcome.failed.length > 0) throw new ActionFailedError(`${action}: delivery failed for all ${outcome.failed.length} recipients`);
+	return outcome;
+}
 function isEmailTemplateId(value) {
 	return typeof value === "string" && value in ALL_EMAIL_TEMPLATE_IDS;
 }
-/** Throws on any failure — the engine owns retry policy and failure bookkeeping. */
+/** Throws on any failure but a partial fan-out — the engine owns retry policy and failure bookkeeping. */
 async function executeAction(action, event, deps) {
 	switch (action.type) {
 		case "sendEmail": {
 			const template = action.input["template"];
-			if (!isEmailTemplateId(template)) throw new Error(`sendEmail: unknown template "${String(template)}"`);
+			if (!isEmailTemplateId(template)) throw new ActionFailedError(`sendEmail: unknown template "${String(template)}"`);
 			const derivation = SEND_EMAIL_DERIVATIONS[template];
-			if (!derivation || derivation.trigger !== event.type) throw new Error(`sendEmail: template "${template}" cannot be derived from event "${event.type}"`);
-			const derived = await derivation.derive(event, deps.lookups);
-			if (!derived) throw new Error(`sendEmail: event "${event.type}" is missing the data required to derive template "${template}"`);
-			await deps.mailer.send(derived.to, template, derived.params);
-			return;
+			if (!derivation || !derivation.triggers.includes(event.type)) throw new ActionFailedError(`sendEmail: template "${template}" cannot be derived from event "${event.type}"`);
+			const derived = await derivation.derive(event, {
+				...deps,
+				actionInput: action.input
+			});
+			if (!derived) throw new ActionFailedError(`sendEmail: event "${event.type}" is missing the data required to derive template "${template}"`);
+			const outcome = reachedNoOne();
+			for (const recipient of derived) (await send(template, recipient, event, deps) ? outcome.recipients : outcome.failed).push(recipient.orgUserId);
+			return assertSomeDelivered("sendEmail", outcome);
 		}
+		case "grantAccess":
+			await grantAccess(action, event, deps);
+			return reachedNoOne();
 		case DELIVER_WEBHOOK_ACTION:
 			await deliverWebhook(action, event, deps);
-			return;
-		default: throw new Error(`unknown automation action type "${action.type}"`);
+			return reachedNoOne();
+		default: throw new ActionFailedError(`unknown automation action type "${action.type}"`);
+	}
+}
+async function send(template, recipient, event, deps) {
+	try {
+		await deps.mailer.send(recipient.to, template, recipient.params);
+		return true;
+	} catch (err) {
+		(deps.logger ?? noopLogger).warn("automation email not delivered", {
+			orgId: event.orgId,
+			automationId: deps.automationId,
+			trigger: event.type,
+			template,
+			orgUserId: recipient.orgUserId,
+			err
+		});
+		return false;
 	}
 }
+function grantRecipient(event) {
+	if (typeof event.data !== "object" || event.data === null) return;
+	const data = event.data;
+	if (event.type === "organization.student.created" && typeof data.id === "string") return data.id;
+	if (typeof data.orgUserId === "string") return data.orgUserId;
+}
+async function grantAccess(action, event, deps) {
+	const contentId = typeof action.input.contentId === "string" ? action.input.contentId : null;
+	const bundleId = typeof action.input.bundleId === "string" ? action.input.bundleId : null;
+	if (contentId == null === (bundleId == null)) throw new ActionFailedError("grantAccess: provide exactly one of contentId or bundleId");
+	const orgUserId = grantRecipient(event);
+	if (!orgUserId) throw new ActionFailedError(`grantAccess: event "${event.type}" has no recipient`);
+	const days = action.input.expiresInDays;
+	const expiresAt = typeof days === "number" && Number.isFinite(days) ? new Date(Date.now() + days * 864e5) : null;
+	await deps.grants.grant(event.orgId, {
+		orgUserId,
+		contentId,
+		bundleId,
+		expiresAt
+	});
+}
 async function deliverWebhook(action, event, deps) {
 	const input = deliverWebhookInputSchema.safeParse(action.input);
-	if (!input.success) throw new Error(`${DELIVER_WEBHOOK_ACTION}: invalid input`);
+	if (!input.success) throw new ActionFailedError(`${DELIVER_WEBHOOK_ACTION}: invalid input`);
 	const publicData = publicDataSchema(event.type);
-	if (!publicData) throw new Error(`${DELIVER_WEBHOOK_ACTION}: event "${event.type}" is not published`);
+	if (!publicData) throw new ActionFailedError(`${DELIVER_WEBHOOK_ACTION}: event "${event.type}" is not published`);
 	const data = publicData.safeParse(event.data);
-	if (!data.success) throw new Error(`${DELIVER_WEBHOOK_ACTION}: event "${event.type}" does not match its published shape`);
+	if (!data.success) throw new ActionFailedError(`${DELIVER_WEBHOOK_ACTION}: event "${event.type}" does not match its published shape`);
 	const secret = (await deps.credentials.reveal(event.orgId, input.data.secretRef))?.["secret"];
-	if (typeof secret !== "string") throw new Error(`${DELIVER_WEBHOOK_ACTION}: signing secret not found`);
+	if (typeof secret !== "string") throw new ActionFailedError(`${DELIVER_WEBHOOK_ACTION}: signing secret not found`);
 	const body = JSON.stringify({
 		id: event.id,
 		type: event.type,
@@ -79,12 +132,23 @@ async function deliverWebhook(action, event, deps) {
 		data: data.data
 	});
 	const timestamp = Math.floor(Date.now() / 1e3);
-	const response = await deps.webhooks.send({
-		url: input.data.url,
-		headers: webhookHeaders(secret, event.id, timestamp, body),
-		body
-	});
-	if (response.status < 200 || response.status >= 300) throw new Error(`${DELIVER_WEBHOOK_ACTION}: endpoint responded ${response.status}`);
+	let response;
+	try {
+		response = await deps.webhooks.send({
+			url: input.data.url,
+			headers: webhookHeaders(secret, event.id, timestamp, body),
+			body
+		});
+	} catch (err) {
+		(deps.logger ?? noopLogger).warn("webhook endpoint not reached", {
+			orgId: event.orgId,
+			automationId: deps.automationId,
+			eventId: event.id,
+			err
+		});
+		throw new ActionFailedError(`${DELIVER_WEBHOOK_ACTION}: the endpoint could not be reached`);
+	}
+	if (response.status < 200 || response.status >= 300) throw new ActionFailedError(`${DELIVER_WEBHOOK_ACTION}: endpoint responded ${response.status}`);
 }
 //#endregion
 export { SEND_EMAIL_DERIVATIONS, executeAction };

package/dist/automations/actions.js.map

@@ -1 +1 @@
-{"version":3,"file":"actions.js","names":[],"sources":["../../src/automations/actions.ts"],"sourcesContent":["// automations context — action runners. `executeAction` maps one\n// AutomationAction against the DomainEvent that triggered its run.\n//\n// SEND_EMAIL_DERIVATIONS is the sendEmail runner's internal derivation table:\n// which (trigger, template) pairings are derivable. A template with no entry\n// (e.g. courseCompleted) makes `executeAction` throw a named error, recorded\n// by the engine as a failed action.\nimport type { EmailTemplateId, EmailTemplateParams } from '../types/index.js';\nimport { deliverWebhookInputSchema } from '../types/schemas/index.js';\nimport { entitlementEvents } from '../entitlements/index.js';\nimport type { Mailer, MailerLookups } from '../shared/mailer.js';\nimport type { CredentialStore, DomainEvent } from '../shared/ports.js';\nimport type { AutomationAction } from './model.js';\nimport type { WebhookSender } from './ports.js';\nimport { ALL_EMAIL_TEMPLATE_IDS, DELIVER_WEBHOOK_ACTION, publicDataSchema } from './catalog.js';\nimport { webhookHeaders } from './webhook-signing.js';\n\nexport interface ActionDeps {\n  mailer: Pick<Mailer, 'send'>;\n  lookups: MailerLookups;\n  credentials: Pick<CredentialStore, 'reveal'>;\n  webhooks: WebhookSender;\n}\n\ninterface SendEmailDerivation<K extends EmailTemplateId> {\n  /** The only event type this template's params can be derived from. */\n  trigger: string;\n  /** Undefined = the recipient or content behind the event's ids cannot be resolved. */\n  derive(\n    event: DomainEvent,\n    lookups: MailerLookups,\n  ): Promise<{ to: string; params: EmailTemplateParams[K] } | undefined>;\n}\n\ntype SendEmailDerivations = { [K in EmailTemplateId]?: SendEmailDerivation<K> };\n\nexport const SEND_EMAIL_DERIVATIONS: SendEmailDerivations = {\n  accessGranted: {\n    trigger: 'entitlement.created',\n    derive: async (event, lookups) => {\n      const result = entitlementEvents.entitlementCreated.safeParse(event);\n      if (!result.success) {\n        return undefined;\n      }\n      const entitlement = result.data.data;\n      // Bundle grants carry no content id — this email is per content item.\n      if (!entitlement.contentId) {\n        return undefined;\n      }\n      const [to, content] = await Promise.all([\n        lookups.orgUserEmail(entitlement.orgId, entitlement.orgUserId),\n        lookups.contentInfo(entitlement.orgId, entitlement.contentId),\n      ]);\n      if (!to || !content) {\n        return undefined;\n      }\n      return {\n        to,\n        params: { contentTitle: content.title, contentId: content.id, contentType: content.type },\n      };\n    },\n  },\n  accessRevoked: {\n    trigger: 'entitlement.deleted',\n    derive: async (event, lookups) => {\n      const result = entitlementEvents.entitlementDeleted.safeParse(event);\n      if (!result.success) {\n        return undefined;\n      }\n      const entitlement = result.data.data;\n      // Bundle grants carry no content id — this email is per content item.\n      if (!entitlement.contentId) {\n        return undefined;\n      }\n      const [to, content] = await Promise.all([\n        lookups.orgUserEmail(entitlement.orgId, entitlement.orgUserId),\n        lookups.contentInfo(entitlement.orgId, entitlement.contentId),\n      ]);\n      if (!to || !content) {\n        return undefined;\n      }\n      return {\n        to,\n        params: { contentTitle: content.title },\n      };\n    },\n  },\n};\n\nfunction isEmailTemplateId(value: unknown): value is EmailTemplateId {\n  return typeof value === 'string' && value in ALL_EMAIL_TEMPLATE_IDS;\n}\n\n/** Throws on any failure — the engine owns retry policy and failure bookkeeping. */\nexport async function executeAction(\n  action: AutomationAction,\n  event: DomainEvent,\n  deps: ActionDeps,\n): Promise<void> {\n  switch (action.type) {\n    case 'sendEmail': {\n      const template = action.input['template'];\n      if (!isEmailTemplateId(template)) {\n        throw new Error(`sendEmail: unknown template \"${String(template)}\"`);\n      }\n      const derivation = SEND_EMAIL_DERIVATIONS[template];\n      if (!derivation || derivation.trigger !== event.type) {\n        throw new Error(\n          `sendEmail: template \"${template}\" cannot be derived from event \"${event.type}\"`,\n        );\n      }\n      const derived = await derivation.derive(event, deps.lookups);\n      if (!derived) {\n        throw new Error(\n          `sendEmail: event \"${event.type}\" is missing the data required to derive template \"${template}\"`,\n        );\n      }\n      await deps.mailer.send(derived.to, template, derived.params);\n      return;\n    }\n    case DELIVER_WEBHOOK_ACTION: {\n      await deliverWebhook(action, event, deps);\n      return;\n    }\n    default: {\n      throw new Error(`unknown automation action type \"${action.type}\"`);\n    }\n  }\n}\n\nasync function deliverWebhook(\n  action: AutomationAction,\n  event: DomainEvent,\n  deps: ActionDeps,\n): Promise<void> {\n  const input = deliverWebhookInputSchema.safeParse(action.input);\n  if (!input.success) {\n    throw new Error(`${DELIVER_WEBHOOK_ACTION}: invalid input`);\n  }\n  const publicData = publicDataSchema(event.type);\n  if (!publicData) {\n    throw new Error(`${DELIVER_WEBHOOK_ACTION}: event \"${event.type}\" is not published`);\n  }\n  const data = publicData.safeParse(event.data);\n  if (!data.success) {\n    throw new Error(\n      `${DELIVER_WEBHOOK_ACTION}: event \"${event.type}\" does not match its published shape`,\n    );\n  }\n  const secrets = await deps.credentials.reveal(event.orgId, input.data.secretRef);\n  const secret = secrets?.['secret'];\n  if (typeof secret !== 'string') {\n    throw new Error(`${DELIVER_WEBHOOK_ACTION}: signing secret not found`);\n  }\n  const body = JSON.stringify({\n    id: event.id,\n    type: event.type,\n    version: event.version,\n    orgId: event.orgId,\n    occurredAt: event.occurredAt,\n    data: data.data,\n  });\n  const timestamp = Math.floor(Date.now() / 1000);\n  const response = await deps.webhooks.send({\n    url: input.data.url,\n    headers: webhookHeaders(secret, event.id, timestamp, body),\n    body,\n  });\n  if (response.status < 200 || response.status >= 300) {\n    throw new Error(`${DELIVER_WEBHOOK_ACTION}: endpoint responded ${response.status}`);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"actions.js","names":[],"sources":["../../src/automations/actions.ts"],"sourcesContent":["// automations context — action runners. `executeAction` maps one\n// AutomationAction against the DomainEvent that triggered its run.\n//\n// SEND_EMAIL_DERIVATIONS is the sendEmail runner's internal derivation table:\n// which (trigger, template) pairings are derivable. A template with no entry\n// (e.g. courseCompleted) makes `executeAction` throw a named error, recorded\n// by the engine as a failed action.\nimport type { EmailTemplateId } from '../types/index.js';\nimport { deliverWebhookInputSchema } from '../types/schemas/index.js';\nimport { entitlementEvents } from '../entitlements/index.js';\nimport type { DomainEvent } from '../shared/ports.js';\nimport { noopLogger } from '../shared/logger.js';\nimport { ActionFailedError, type AutomationAction } from './model.js';\nimport type { WebhookResponse } from './ports.js';\nimport { ALL_EMAIL_TEMPLATE_IDS, DELIVER_WEBHOOK_ACTION, publicDataSchema } from './catalog.js';\nimport { webhookHeaders } from './webhook-signing.js';\nimport { address, type ActionDeps, type EmailRecipient } from './community-mail.js';\nimport { COMMUNITY_DERIVATIONS, type EmailDerivation } from './community-derivations.js';\n\ntype SendEmailDerivations = { [K in EmailTemplateId]?: EmailDerivation<K> };\n\nexport const SEND_EMAIL_DERIVATIONS: SendEmailDerivations = {\n  accessGranted: {\n    triggers: ['entitlement.created'],\n    derive: async (event, deps) => {\n      const result = entitlementEvents.entitlementCreated.safeParse(event);\n      if (!result.success) {\n        return undefined;\n      }\n      const entitlement = result.data.data;\n      if (!entitlement.contentId) {\n        return [];\n      }\n      const content = await deps.lookups.contentInfo(entitlement.orgId, entitlement.contentId);\n      if (!content) {\n        return undefined;\n      }\n      return address(deps, event, entitlement.orgId, [entitlement.orgUserId], {\n        contentTitle: content.title,\n        contentId: content.id,\n        contentType: content.type,\n      });\n    },\n  },\n  accessRevoked: {\n    triggers: ['entitlement.deleted'],\n    derive: async (event, deps) => {\n      const result = entitlementEvents.entitlementDeleted.safeParse(event);\n      if (!result.success) {\n        return undefined;\n      }\n      const entitlement = result.data.data;\n      if (!entitlement.contentId) {\n        return [];\n      }\n      const content = await deps.lookups.contentInfo(entitlement.orgId, entitlement.contentId);\n      if (!content) {\n        return undefined;\n      }\n      return address(deps, event, entitlement.orgId, [entitlement.orgUserId], {\n        contentTitle: content.title,\n      });\n    },\n  },\n  ...COMMUNITY_DERIVATIONS,\n};\n\nexport type { ActionDeps, EmailRecipient };\n\n/** Who an action reached, and who a delivery to failed for (a partial failure does not throw). */\nexport interface ActionOutcome {\n  recipients: string[];\n  failed: string[];\n}\n\nfunction reachedNoOne(): ActionOutcome {\n  return { recipients: [], failed: [] };\n}\n\nfunction assertSomeDelivered(action: string, outcome: ActionOutcome): ActionOutcome {\n  if (outcome.recipients.length === 0 && outcome.failed.length > 0) {\n    throw new ActionFailedError(\n      `${action}: delivery failed for all ${outcome.failed.length} recipients`,\n    );\n  }\n  return outcome;\n}\n\nfunction isEmailTemplateId(value: unknown): value is EmailTemplateId {\n  return typeof value === 'string' && value in ALL_EMAIL_TEMPLATE_IDS;\n}\n\n/** Throws on any failure but a partial fan-out — the engine owns retry policy and failure bookkeeping. */\nexport async function executeAction(\n  action: AutomationAction,\n  event: DomainEvent,\n  deps: ActionDeps,\n): Promise<ActionOutcome> {\n  switch (action.type) {\n    case 'sendEmail': {\n      const template = action.input['template'];\n      if (!isEmailTemplateId(template)) {\n        throw new ActionFailedError(`sendEmail: unknown template \"${String(template)}\"`);\n      }\n      const derivation = SEND_EMAIL_DERIVATIONS[template];\n      if (!derivation || !derivation.triggers.includes(event.type)) {\n        throw new ActionFailedError(\n          `sendEmail: template \"${template}\" cannot be derived from event \"${event.type}\"`,\n        );\n      }\n      const derived = await derivation.derive(event, { ...deps, actionInput: action.input });\n      if (!derived) {\n        throw new ActionFailedError(\n          `sendEmail: event \"${event.type}\" is missing the data required to derive template \"${template}\"`,\n        );\n      }\n      const outcome = reachedNoOne();\n      for (const recipient of derived) {\n        const list = (await send(template, recipient, event, deps))\n          ? outcome.recipients\n          : outcome.failed;\n        list.push(recipient.orgUserId);\n      }\n      return assertSomeDelivered('sendEmail', outcome);\n    }\n    case 'grantAccess': {\n      await grantAccess(action, event, deps);\n      return reachedNoOne();\n    }\n    case DELIVER_WEBHOOK_ACTION: {\n      await deliverWebhook(action, event, deps);\n      return reachedNoOne();\n    }\n    default: {\n      throw new ActionFailedError(`unknown automation action type \"${action.type}\"`);\n    }\n  }\n}\n\nasync function send<K extends EmailTemplateId>(\n  template: K,\n  recipient: EmailRecipient<K>,\n  event: DomainEvent,\n  deps: ActionDeps,\n): Promise<boolean> {\n  try {\n    await deps.mailer.send(recipient.to, template, recipient.params);\n    return true;\n  } catch (err) {\n    (deps.logger ?? noopLogger).warn('automation email not delivered', {\n      orgId: event.orgId,\n      automationId: deps.automationId,\n      trigger: event.type,\n      template,\n      orgUserId: recipient.orgUserId,\n      err,\n    });\n    return false;\n  }\n}\n\nfunction grantRecipient(event: DomainEvent): string | undefined {\n  if (typeof event.data !== 'object' || event.data === null) {\n    return undefined;\n  }\n  const data = event.data as Record<string, unknown>;\n  if (event.type === 'organization.student.created' && typeof data.id === 'string') {\n    return data.id;\n  }\n  if (typeof data.orgUserId === 'string') {\n    return data.orgUserId;\n  }\n  return undefined;\n}\n\nasync function grantAccess(\n  action: AutomationAction,\n  event: DomainEvent,\n  deps: ActionDeps,\n): Promise<void> {\n  const contentId = typeof action.input.contentId === 'string' ? action.input.contentId : null;\n  const bundleId = typeof action.input.bundleId === 'string' ? action.input.bundleId : null;\n  if ((contentId == null) === (bundleId == null)) {\n    throw new ActionFailedError('grantAccess: provide exactly one of contentId or bundleId');\n  }\n  const orgUserId = grantRecipient(event);\n  if (!orgUserId) {\n    throw new ActionFailedError(`grantAccess: event \"${event.type}\" has no recipient`);\n  }\n  const days = action.input.expiresInDays;\n  const expiresAt =\n    typeof days === 'number' && Number.isFinite(days)\n      ? new Date(Date.now() + days * 86_400_000)\n      : null;\n  await deps.grants.grant(event.orgId, { orgUserId, contentId, bundleId, expiresAt });\n}\n\nasync function deliverWebhook(\n  action: AutomationAction,\n  event: DomainEvent,\n  deps: ActionDeps,\n): Promise<void> {\n  const input = deliverWebhookInputSchema.safeParse(action.input);\n  if (!input.success) {\n    throw new ActionFailedError(`${DELIVER_WEBHOOK_ACTION}: invalid input`);\n  }\n  const publicData = publicDataSchema(event.type);\n  if (!publicData) {\n    throw new ActionFailedError(\n      `${DELIVER_WEBHOOK_ACTION}: event \"${event.type}\" is not published`,\n    );\n  }\n  const data = publicData.safeParse(event.data);\n  if (!data.success) {\n    throw new ActionFailedError(\n      `${DELIVER_WEBHOOK_ACTION}: event \"${event.type}\" does not match its published shape`,\n    );\n  }\n  const secrets = await deps.credentials.reveal(event.orgId, input.data.secretRef);\n  const secret = secrets?.['secret'];\n  if (typeof secret !== 'string') {\n    throw new ActionFailedError(`${DELIVER_WEBHOOK_ACTION}: signing secret not found`);\n  }\n  const body = JSON.stringify({\n    id: event.id,\n    type: event.type,\n    version: event.version,\n    orgId: event.orgId,\n    occurredAt: event.occurredAt,\n    data: data.data,\n  });\n  const timestamp = Math.floor(Date.now() / 1000);\n  let response: WebhookResponse;\n  try {\n    response = await deps.webhooks.send({\n      url: input.data.url,\n      headers: webhookHeaders(secret, event.id, timestamp, body),\n      body,\n    });\n  } catch (err) {\n    (deps.logger ?? noopLogger).warn('webhook endpoint not reached', {\n      orgId: event.orgId,\n      automationId: deps.automationId,\n      eventId: event.id,\n      err,\n    });\n    throw new ActionFailedError(`${DELIVER_WEBHOOK_ACTION}: the endpoint could not be reached`);\n  }\n  if (response.status < 200 || response.status >= 300) {\n    throw new ActionFailedError(`${DELIVER_WEBHOOK_ACTION}: endpoint responded ${response.status}`);\n  }\n}\n"],"mappings":"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"}

package/dist/automations/catalog.js

@@ -1,10 +1,10 @@
-import { entitlementEvents } from "../entitlements/events.js";
 import { assetEvents } from "../assets/events.js";
+import { organizationEvents } from "../organizations/events.js";
+import { entitlementEvents } from "../entitlements/events.js";
 import { contentEvents } from "../content/events.js";
 import { discussionEvents } from "../discussion/events.js";
 import { identityEvents } from "../identity/events.js";
 import { integrationEvents } from "../integrations/events.js";
-import { organizationEvents } from "../organizations/events.js";
 import { progressEvents } from "../progress/events.js";
 //#region src/automations/catalog.ts
 /** Every EmailTemplateId — a missing key here is a compile error, kept exhaustive by construction. */
@@ -17,7 +17,38 @@ const ALL_EMAIL_TEMPLATE_IDS = {
 	emailVerification: true,
 	accessGranted: true,
 	accessRevoked: true,
-	courseCompleted: true
+	courseCompleted: true,
+	welcomeToCommunity: true,
+	membershipEndingSoon: true,
+	membershipEnded: true,
+	newPostInSpace: true,
+	yourPostWasPublished: true,
+	yourPostWasRemoved: true,
+	newCommentOnPost: true,
+	replyToYourComment: true,
+	yourCommentWasRemoved: true,
+	requestApproved: true,
+	requestDeclined: true,
+	invitedToSpace: true,
+	messageRequest: true,
+	newMessage: true,
+	addedToGroupChat: true,
+	youAreNowAModerator: true,
+	digest: true,
+	postAwaitingReview: true,
+	joinRequest: true,
+	somethingWasFlagged: true,
+	messageWasFlagged: true,
+	postReacted: true,
+	commentReacted: true,
+	mention: true,
+	messageReacted: true,
+	courseActivityAdded: true,
+	activityCommentCreated: true,
+	activityCommentRemoved: true,
+	activityCommentReacted: true,
+	activityCommentFlagged: true,
+	activityMention: true
 };
 const DELIVER_WEBHOOK_ACTION = "deliverWebhook";
 function catalogActions() {
@@ -30,6 +61,18 @@ function catalogActions() {
 			properties: { template: { enum: Object.keys(ALL_EMAIL_TEMPLATE_IDS) } }
 		},
 		source: "system"
+	}, {
+		type: "grantAccess",
+		description: "Grant a content item or bundle to the person on the event.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				contentId: { type: "string" },
+				bundleId: { type: "string" },
+				expiresInDays: { type: "number" }
+			}
+		},
+		source: "system"
 	}];
 }
 const TRIGGERS = [
@@ -75,6 +118,12 @@ const TRIGGERS = [
 		category: "Organization",
 		description: "a user was removed from an organization"
 	},
+	{
+		event: organizationEvents.orgUserUpdated,
+		label: "Member updated",
+		category: "Organization",
+		description: "an organization member was updated"
+	},
 	{
 		event: organizationEvents.inviteCreated,
 		label: "Invite sent",
@@ -165,6 +214,12 @@ const TRIGGERS = [
 		category: "Courses",
 		description: "a course activity was deleted"
 	},
+	{
+		event: contentEvents.activityPublished,
+		label: "Activity published",
+		category: "Courses",
+		description: "an activity of a published course was published"
+	},
 	{
 		event: contentEvents.activitiesReordered,
 		label: "Activities reordered",
@@ -213,6 +268,48 @@ const TRIGGERS = [
 		category: "Downloads",
 		description: "download assets were reordered"
 	},
+	{
+		event: contentEvents.communityCreated,
+		label: "Community created",
+		category: "Communities",
+		description: "a community was created"
+	},
+	{
+		event: contentEvents.communityUpdated,
+		label: "Community updated",
+		category: "Communities",
+		description: "a community was updated"
+	},
+	{
+		event: contentEvents.communityDeleted,
+		label: "Community deleted",
+		category: "Communities",
+		description: "a community was deleted"
+	},
+	{
+		event: contentEvents.spaceCreated,
+		label: "Space created",
+		category: "Communities",
+		description: "a space was created"
+	},
+	{
+		event: contentEvents.spaceUpdated,
+		label: "Space updated",
+		category: "Communities",
+		description: "a space was updated"
+	},
+	{
+		event: contentEvents.spaceDeleted,
+		label: "Space deleted",
+		category: "Communities",
+		description: "a space was deleted"
+	},
+	{
+		event: contentEvents.spacesReordered,
+		label: "Spaces reordered",
+		category: "Communities",
+		description: "spaces were reordered"
+	},
 	{
 		event: entitlementEvents.entitlementCreated,
 		label: "Access granted",
@@ -237,6 +334,30 @@ const TRIGGERS = [
 		category: "Access",
 		description: "an entitlement passed its expiry"
 	},
+	{
+		event: entitlementEvents.entitlementEndingSoon,
+		label: "Access ending soon",
+		category: "Access",
+		description: "an entitlement expires within a week"
+	},
+	{
+		event: entitlementEvents.spaceMemberCreated,
+		label: "Space member created",
+		category: "Access",
+		description: "a person was added to a space"
+	},
+	{
+		event: entitlementEvents.spaceMemberUpdated,
+		label: "Space member updated",
+		category: "Access",
+		description: "a space membership changed"
+	},
+	{
+		event: entitlementEvents.spaceMemberDeleted,
+		label: "Space member removed",
+		category: "Access",
+		description: "a space membership was removed"
+	},
 	{
 		event: progressEvents.progressStarted,
 		label: "Progress started",
@@ -279,6 +400,18 @@ const TRIGGERS = [
 		category: "Discussion",
 		description: "a comment was published"
 	},
+	{
+		event: discussionEvents.commentUpdated,
+		label: "Comment updated",
+		category: "Discussion",
+		description: "a comment was edited"
+	},
+	{
+		event: discussionEvents.commentReactionAdded,
+		label: "Comment reaction added",
+		category: "Discussion",
+		description: "a person reacted to a comment for the first time"
+	},
 	{
 		event: discussionEvents.commentRemoved,
 		label: "Comment removed",
@@ -291,6 +424,96 @@ const TRIGGERS = [
 		category: "Discussion",
 		description: "a comment was reported"
 	},
+	{
+		event: discussionEvents.postCreated,
+		label: "Post created",
+		category: "Discussion",
+		description: "a post was created"
+	},
+	{
+		event: discussionEvents.postUpdated,
+		label: "Post updated",
+		category: "Discussion",
+		description: "a post was updated"
+	},
+	{
+		event: discussionEvents.postPublished,
+		label: "Post published",
+		category: "Discussion",
+		description: "a post was published"
+	},
+	{
+		event: discussionEvents.postReactionAdded,
+		label: "Post reaction added",
+		category: "Discussion",
+		description: "a person reacted to a post for the first time"
+	},
+	{
+		event: discussionEvents.postRemoved,
+		label: "Post removed",
+		category: "Discussion",
+		description: "a post was removed"
+	},
+	{
+		event: discussionEvents.postReported,
+		label: "Post reported",
+		category: "Discussion",
+		description: "a post was reported"
+	},
+	{
+		event: discussionEvents.chatCreated,
+		label: "Chat created",
+		category: "Discussion",
+		description: "a chat was created"
+	},
+	{
+		event: discussionEvents.chatUpdated,
+		label: "Chat updated",
+		category: "Discussion",
+		description: "a chat was updated"
+	},
+	{
+		event: discussionEvents.chatParticipantAdded,
+		label: "Chat participant added",
+		category: "Discussion",
+		description: "a person was added to a chat"
+	},
+	{
+		event: discussionEvents.messageSent,
+		label: "Message sent",
+		category: "Discussion",
+		description: "a message was sent"
+	},
+	{
+		event: discussionEvents.messageUpdated,
+		label: "Message updated",
+		category: "Discussion",
+		description: "a message was edited"
+	},
+	{
+		event: discussionEvents.messageReactionAdded,
+		label: "Message reaction added",
+		category: "Discussion",
+		description: "a person reacted to a message for the first time"
+	},
+	{
+		event: discussionEvents.messageDeleted,
+		label: "Message deleted",
+		category: "Discussion",
+		description: "a message was deleted"
+	},
+	{
+		event: discussionEvents.messageReported,
+		label: "Message reported",
+		category: "Discussion",
+		description: "a message was reported"
+	},
+	{
+		event: discussionEvents.digestDue,
+		label: "Digest due",
+		category: "Discussion",
+		description: "a community's digest came due on its schedule"
+	},
 	{
 		event: assetEvents.assetCreated,
 		label: "Upload requested",

package/dist/automations/catalog.js.map

@@ -1 +1 @@
-{"version":3,"file":"catalog.js","names":[],"sources":["../../src/automations/catalog.ts"],"sourcesContent":["// automations context — the code-owned catalogs `availableActions()` and\n// `availableTriggers()` serve: built-in action definitions and the domain\n// event types automations may react to.\nimport type { z } from 'zod';\nimport type { EmailTemplateId } from '../types/index.js';\nimport { assetEvents } from '../assets/index.js';\nimport { contentEvents } from '../content/index.js';\nimport { discussionEvents } from '../discussion/index.js';\nimport { entitlementEvents } from '../entitlements/index.js';\nimport { identityEvents } from '../identity/index.js';\nimport { integrationEvents } from '../integrations/index.js';\nimport { organizationEvents } from '../organizations/index.js';\nimport { progressEvents } from '../progress/index.js';\nimport type { AvailableActions, AvailableTriggers } from './types.js';\n\n/** Every EmailTemplateId — a missing key here is a compile error, kept exhaustive by construction. */\nexport const ALL_EMAIL_TEMPLATE_IDS: Record<EmailTemplateId, true> = {\n  magicLink: true,\n  studentInvite: true,\n  memberInvite: true,\n  passwordReset: true,\n  passwordChanged: true,\n  emailVerification: true,\n  accessGranted: true,\n  accessRevoked: true,\n  courseCompleted: true,\n};\n\nexport const DELIVER_WEBHOOK_ACTION = 'deliverWebhook';\n\nexport function catalogActions(): AvailableActions {\n  return [\n    {\n      type: 'sendEmail',\n      description: 'Send a transactional email using a built-in template.',\n      inputSchema: {\n        type: 'object',\n        required: ['template'],\n        properties: {\n          template: { enum: Object.keys(ALL_EMAIL_TEMPLATE_IDS) },\n        },\n      },\n      source: 'system',\n    },\n  ];\n}\n\ninterface CatalogTrigger {\n  readonly event: { readonly type: string; readonly publicData: z.ZodType };\n  readonly label: string;\n  readonly category: string;\n  readonly description: string;\n}\n\nconst TRIGGERS: CatalogTrigger[] = [\n  {\n    event: identityEvents.userCreated,\n    label: 'User created',\n    category: 'Users',\n    description: 'a user was created',\n  },\n  {\n    event: identityEvents.userUpdated,\n    label: 'User updated',\n    category: 'Users',\n    description: 'a user was updated',\n  },\n  {\n    event: organizationEvents.organizationCreated,\n    label: 'Organization created',\n    category: 'Organization',\n    description: 'an organization was created',\n  },\n  {\n    event: organizationEvents.organizationUpdated,\n    label: 'Organization updated',\n    category: 'Organization',\n    description: 'an organization was updated',\n  },\n  {\n    event: organizationEvents.organizationDeleted,\n    label: 'Organization deleted',\n    category: 'Organization',\n    description: 'an organization was deleted',\n  },\n  {\n    event: organizationEvents.orgUserLinked,\n    label: 'Member joined',\n    category: 'Organization',\n    description: 'a user was linked to an organization',\n  },\n  {\n    event: organizationEvents.orgUserDeleted,\n    label: 'Member removed',\n    category: 'Organization',\n    description: 'a user was removed from an organization',\n  },\n  {\n    event: organizationEvents.inviteCreated,\n    label: 'Invite sent',\n    category: 'Organization',\n    description: 'an invite was created or re-issued',\n  },\n  {\n    event: organizationEvents.inviteAccepted,\n    label: 'Invite accepted',\n    category: 'Organization',\n    description: 'an invite was accepted',\n  },\n  {\n    event: organizationEvents.studentCreated,\n    label: 'Student created',\n    category: 'Students',\n    description: 'a student was created',\n  },\n  {\n    event: organizationEvents.studentDeleted,\n    label: 'Student deleted',\n    category: 'Students',\n    description: 'a student was deleted',\n  },\n  {\n    event: organizationEvents.studentLinked,\n    label: 'Student linked to account',\n    category: 'Students',\n    description: 'a pending student was linked to an auth account',\n  },\n  {\n    event: contentEvents.courseCreated,\n    label: 'Course created',\n    category: 'Courses',\n    description: 'a course was created',\n  },\n  {\n    event: contentEvents.courseUpdated,\n    label: 'Course updated',\n    category: 'Courses',\n    description: 'a course was updated',\n  },\n  {\n    event: contentEvents.courseDeleted,\n    label: 'Course deleted',\n    category: 'Courses',\n    description: 'a course was deleted',\n  },\n  {\n    event: contentEvents.moduleCreated,\n    label: 'Module created',\n    category: 'Courses',\n    description: 'a course module was created',\n  },\n  {\n    event: contentEvents.moduleUpdated,\n    label: 'Module updated',\n    category: 'Courses',\n    description: 'a course module was updated',\n  },\n  {\n    event: contentEvents.moduleDeleted,\n    label: 'Module deleted',\n    category: 'Courses',\n    description: 'a course module was deleted',\n  },\n  {\n    event: contentEvents.modulesReordered,\n    label: 'Modules reordered',\n    category: 'Courses',\n    description: 'course modules were reordered',\n  },\n  {\n    event: contentEvents.activityCreated,\n    label: 'Activity created',\n    category: 'Courses',\n    description: 'a course activity was created',\n  },\n  {\n    event: contentEvents.activityUpdated,\n    label: 'Activity updated',\n    category: 'Courses',\n    description: 'a course activity was updated',\n  },\n  {\n    event: contentEvents.activityDeleted,\n    label: 'Activity deleted',\n    category: 'Courses',\n    description: 'a course activity was deleted',\n  },\n  {\n    event: contentEvents.activitiesReordered,\n    label: 'Activities reordered',\n    category: 'Courses',\n    description: 'course activities were reordered',\n  },\n  {\n    event: contentEvents.downloadCreated,\n    label: 'Download created',\n    category: 'Downloads',\n    description: 'a download was created',\n  },\n  {\n    event: contentEvents.downloadUpdated,\n    label: 'Download updated',\n    category: 'Downloads',\n    description: 'a download was updated',\n  },\n  {\n    event: contentEvents.downloadDeleted,\n    label: 'Download deleted',\n    category: 'Downloads',\n    description: 'a download was deleted',\n  },\n  {\n    event: contentEvents.downloadAssetAdded,\n    label: 'Download file added',\n    category: 'Downloads',\n    description: 'a download asset was added',\n  },\n  {\n    event: contentEvents.downloadAssetRemoved,\n    label: 'Download file removed',\n    category: 'Downloads',\n    description: 'a download asset was removed',\n  },\n  {\n    event: contentEvents.downloadAssetRenamed,\n    label: 'Download file renamed',\n    category: 'Downloads',\n    description: 'a download asset was renamed',\n  },\n  {\n    event: contentEvents.downloadAssetsReordered,\n    label: 'Download files reordered',\n    category: 'Downloads',\n    description: 'download assets were reordered',\n  },\n  {\n    event: entitlementEvents.entitlementCreated,\n    label: 'Access granted',\n    category: 'Access',\n    description: 'a student was granted access to content',\n  },\n  {\n    event: entitlementEvents.entitlementUpdated,\n    label: 'Access updated',\n    category: 'Access',\n    description: \"an entitlement's status or expiry changed\",\n  },\n  {\n    event: entitlementEvents.entitlementDeleted,\n    label: 'Access revoked',\n    category: 'Access',\n    description: \"a student's access to content was revoked\",\n  },\n  {\n    event: entitlementEvents.entitlementExpired,\n    label: 'Access expired',\n    category: 'Access',\n    description: 'an entitlement passed its expiry',\n  },\n  {\n    event: progressEvents.progressStarted,\n    label: 'Progress started',\n    category: 'Progress',\n    description: 'a student started a progress record',\n  },\n  {\n    event: progressEvents.progressCompleted,\n    label: 'Progress completed',\n    category: 'Progress',\n    description: 'a student completed a progress record',\n  },\n  {\n    event: integrationEvents.connectionCreated,\n    label: 'Integration connected',\n    category: 'Integrations',\n    description: 'an integration connection was established',\n  },\n  {\n    event: integrationEvents.connectionUpdated,\n    label: 'Integration updated',\n    category: 'Integrations',\n    description: 'an integration connection changed',\n  },\n  {\n    event: integrationEvents.connectionRemoved,\n    label: 'Integration disconnected',\n    category: 'Integrations',\n    description: 'an integration connection was removed',\n  },\n  {\n    event: discussionEvents.commentCreated,\n    label: 'Comment created',\n    category: 'Discussion',\n    description: 'a comment was created',\n  },\n  {\n    event: discussionEvents.commentPublished,\n    label: 'Comment published',\n    category: 'Discussion',\n    description: 'a comment was published',\n  },\n  {\n    event: discussionEvents.commentRemoved,\n    label: 'Comment removed',\n    category: 'Discussion',\n    description: 'a comment was removed',\n  },\n  {\n    event: discussionEvents.commentReported,\n    label: 'Comment reported',\n    category: 'Discussion',\n    description: 'a comment was reported',\n  },\n  {\n    event: assetEvents.assetCreated,\n    label: 'Upload requested',\n    category: 'Assets',\n    description: 'an asset upload was requested',\n  },\n  {\n    event: assetEvents.assetReady,\n    label: 'Upload ready',\n    category: 'Assets',\n    description: 'an asset was confirmed ready',\n  },\n  {\n    event: assetEvents.assetDeleted,\n    label: 'Asset deleted',\n    category: 'Assets',\n    description: 'an asset was deleted',\n  },\n];\n\nexport function catalogTriggers(): AvailableTriggers['triggers'] {\n  return TRIGGERS.map(({ event, ...trigger }) => ({ type: event.type, ...trigger }));\n}\n\nexport function publicDataSchema(type: string): z.ZodType | undefined {\n  return TRIGGERS.find((trigger) => trigger.event.type === type)?.event.publicData;\n}\n"],"mappings":";;;;;;;;;;AAgBA,MAAa,yBAAwD;CACnE,WAAW;CACX,eAAe;CACf,cAAc;CACd,eAAe;CACf,iBAAiB;CACjB,mBAAmB;CACnB,eAAe;CACf,eAAe;CACf,iBAAiB;AACnB;AAEA,MAAa,yBAAyB;AAEtC,SAAgB,iBAAmC;CACjD,OAAO,CACL;EACE,MAAM;EACN,aAAa;EACb,aAAa;GACX,MAAM;GACN,UAAU,CAAC,UAAU;GACrB,YAAY,EACV,UAAU,EAAE,MAAM,OAAO,KAAK,sBAAsB,EAAE,EACxD;EACF;EACA,QAAQ;CACV,CACF;AACF;AASA,MAAM,WAA6B;CACjC;EACE,OAAO,eAAe;EACtB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,eAAe;EACtB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,mBAAmB;EAC1B,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,mBAAmB;EAC1B,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,mBAAmB;EAC1B,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,mBAAmB;EAC1B,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,mBAAmB;EAC1B,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,mBAAmB;EAC1B,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,mBAAmB;EAC1B,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,mBAAmB;EAC1B,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,mBAAmB;EAC1B,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,mBAAmB;EAC1B,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,cAAc;EACrB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,cAAc;EACrB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,cAAc;EACrB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,cAAc;EACrB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,cAAc;EACrB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,cAAc;EACrB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,cAAc;EACrB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,cAAc;EACrB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,cAAc;EACrB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,cAAc;EACrB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,cAAc;EACrB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,cAAc;EACrB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,cAAc;EACrB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,cAAc;EACrB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,cAAc;EACrB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,cAAc;EACrB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,cAAc;EACrB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,cAAc;EACrB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,kBAAkB;EACzB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,kBAAkB;EACzB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,kBAAkB;EACzB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,kBAAkB;EACzB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,eAAe;EACtB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,eAAe;EACtB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,kBAAkB;EACzB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,kBAAkB;EACzB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,kBAAkB;EACzB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,iBAAiB;EACxB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,iBAAiB;EACxB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,iBAAiB;EACxB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,iBAAiB;EACxB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,YAAY;EACnB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,YAAY;EACnB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,YAAY;EACnB,OAAO;EACP,UAAU;EACV,aAAa;CACf;AACF;AAEA,SAAgB,kBAAiD;CAC/D,OAAO,SAAS,KAAK,EAAE,OAAO,GAAG,eAAe;EAAE,MAAM,MAAM;EAAM,GAAG;CAAQ,EAAE;AACnF;AAEA,SAAgB,iBAAiB,MAAqC;CACpE,OAAO,SAAS,MAAM,YAAY,QAAQ,MAAM,SAAS,IAAI,CAAC,EAAE,MAAM;AACxE"}
+{"version":3,"file":"catalog.js","names":[],"sources":["../../src/automations/catalog.ts"],"sourcesContent":["// automations context — the code-owned catalogs `availableActions()` and\n// `availableTriggers()` serve: built-in action definitions and the domain\n// event types automations may react to.\nimport type { z } from 'zod';\nimport type { EmailTemplateId } from '../types/index.js';\nimport { assetEvents } from '../assets/index.js';\nimport { contentEvents } from '../content/index.js';\nimport { discussionEvents } from '../discussion/index.js';\nimport { entitlementEvents } from '../entitlements/index.js';\nimport { identityEvents } from '../identity/index.js';\nimport { integrationEvents } from '../integrations/index.js';\nimport { organizationEvents } from '../organizations/index.js';\nimport { progressEvents } from '../progress/index.js';\nimport type { AvailableActions, AvailableTriggers } from './types.js';\n\n/** Every EmailTemplateId — a missing key here is a compile error, kept exhaustive by construction. */\nexport const ALL_EMAIL_TEMPLATE_IDS: Record<EmailTemplateId, true> = {\n  magicLink: true,\n  studentInvite: true,\n  memberInvite: true,\n  passwordReset: true,\n  passwordChanged: true,\n  emailVerification: true,\n  accessGranted: true,\n  accessRevoked: true,\n  courseCompleted: true,\n  welcomeToCommunity: true,\n  membershipEndingSoon: true,\n  membershipEnded: true,\n  newPostInSpace: true,\n  yourPostWasPublished: true,\n  yourPostWasRemoved: true,\n  newCommentOnPost: true,\n  replyToYourComment: true,\n  yourCommentWasRemoved: true,\n  requestApproved: true,\n  requestDeclined: true,\n  invitedToSpace: true,\n  messageRequest: true,\n  newMessage: true,\n  addedToGroupChat: true,\n  youAreNowAModerator: true,\n  digest: true,\n  postAwaitingReview: true,\n  joinRequest: true,\n  somethingWasFlagged: true,\n  messageWasFlagged: true,\n  postReacted: true,\n  commentReacted: true,\n  mention: true,\n  messageReacted: true,\n  courseActivityAdded: true,\n  activityCommentCreated: true,\n  activityCommentRemoved: true,\n  activityCommentReacted: true,\n  activityCommentFlagged: true,\n  activityMention: true,\n};\n\nexport const DELIVER_WEBHOOK_ACTION = 'deliverWebhook';\n\nexport function catalogActions(): AvailableActions {\n  return [\n    {\n      type: 'sendEmail',\n      description: 'Send a transactional email using a built-in template.',\n      inputSchema: {\n        type: 'object',\n        required: ['template'],\n        properties: {\n          template: { enum: Object.keys(ALL_EMAIL_TEMPLATE_IDS) },\n        },\n      },\n      source: 'system',\n    },\n    {\n      type: 'grantAccess',\n      description: 'Grant a content item or bundle to the person on the event.',\n      inputSchema: {\n        type: 'object',\n        properties: {\n          contentId: { type: 'string' },\n          bundleId: { type: 'string' },\n          expiresInDays: { type: 'number' },\n        },\n      },\n      source: 'system',\n    },\n  ];\n}\n\ninterface CatalogTrigger {\n  readonly event: { readonly type: string; readonly publicData: z.ZodType };\n  readonly label: string;\n  readonly category: string;\n  readonly description: string;\n}\n\nconst TRIGGERS: CatalogTrigger[] = [\n  {\n    event: identityEvents.userCreated,\n    label: 'User created',\n    category: 'Users',\n    description: 'a user was created',\n  },\n  {\n    event: identityEvents.userUpdated,\n    label: 'User updated',\n    category: 'Users',\n    description: 'a user was updated',\n  },\n  {\n    event: organizationEvents.organizationCreated,\n    label: 'Organization created',\n    category: 'Organization',\n    description: 'an organization was created',\n  },\n  {\n    event: organizationEvents.organizationUpdated,\n    label: 'Organization updated',\n    category: 'Organization',\n    description: 'an organization was updated',\n  },\n  {\n    event: organizationEvents.organizationDeleted,\n    label: 'Organization deleted',\n    category: 'Organization',\n    description: 'an organization was deleted',\n  },\n  {\n    event: organizationEvents.orgUserLinked,\n    label: 'Member joined',\n    category: 'Organization',\n    description: 'a user was linked to an organization',\n  },\n  {\n    event: organizationEvents.orgUserDeleted,\n    label: 'Member removed',\n    category: 'Organization',\n    description: 'a user was removed from an organization',\n  },\n  {\n    event: organizationEvents.orgUserUpdated,\n    label: 'Member updated',\n    category: 'Organization',\n    description: 'an organization member was updated',\n  },\n  {\n    event: organizationEvents.inviteCreated,\n    label: 'Invite sent',\n    category: 'Organization',\n    description: 'an invite was created or re-issued',\n  },\n  {\n    event: organizationEvents.inviteAccepted,\n    label: 'Invite accepted',\n    category: 'Organization',\n    description: 'an invite was accepted',\n  },\n  {\n    event: organizationEvents.studentCreated,\n    label: 'Student created',\n    category: 'Students',\n    description: 'a student was created',\n  },\n  {\n    event: organizationEvents.studentDeleted,\n    label: 'Student deleted',\n    category: 'Students',\n    description: 'a student was deleted',\n  },\n  {\n    event: organizationEvents.studentLinked,\n    label: 'Student linked to account',\n    category: 'Students',\n    description: 'a pending student was linked to an auth account',\n  },\n  {\n    event: contentEvents.courseCreated,\n    label: 'Course created',\n    category: 'Courses',\n    description: 'a course was created',\n  },\n  {\n    event: contentEvents.courseUpdated,\n    label: 'Course updated',\n    category: 'Courses',\n    description: 'a course was updated',\n  },\n  {\n    event: contentEvents.courseDeleted,\n    label: 'Course deleted',\n    category: 'Courses',\n    description: 'a course was deleted',\n  },\n  {\n    event: contentEvents.moduleCreated,\n    label: 'Module created',\n    category: 'Courses',\n    description: 'a course module was created',\n  },\n  {\n    event: contentEvents.moduleUpdated,\n    label: 'Module updated',\n    category: 'Courses',\n    description: 'a course module was updated',\n  },\n  {\n    event: contentEvents.moduleDeleted,\n    label: 'Module deleted',\n    category: 'Courses',\n    description: 'a course module was deleted',\n  },\n  {\n    event: contentEvents.modulesReordered,\n    label: 'Modules reordered',\n    category: 'Courses',\n    description: 'course modules were reordered',\n  },\n  {\n    event: contentEvents.activityCreated,\n    label: 'Activity created',\n    category: 'Courses',\n    description: 'a course activity was created',\n  },\n  {\n    event: contentEvents.activityUpdated,\n    label: 'Activity updated',\n    category: 'Courses',\n    description: 'a course activity was updated',\n  },\n  {\n    event: contentEvents.activityDeleted,\n    label: 'Activity deleted',\n    category: 'Courses',\n    description: 'a course activity was deleted',\n  },\n  {\n    event: contentEvents.activityPublished,\n    label: 'Activity published',\n    category: 'Courses',\n    description: 'an activity of a published course was published',\n  },\n  {\n    event: contentEvents.activitiesReordered,\n    label: 'Activities reordered',\n    category: 'Courses',\n    description: 'course activities were reordered',\n  },\n  {\n    event: contentEvents.downloadCreated,\n    label: 'Download created',\n    category: 'Downloads',\n    description: 'a download was created',\n  },\n  {\n    event: contentEvents.downloadUpdated,\n    label: 'Download updated',\n    category: 'Downloads',\n    description: 'a download was updated',\n  },\n  {\n    event: contentEvents.downloadDeleted,\n    label: 'Download deleted',\n    category: 'Downloads',\n    description: 'a download was deleted',\n  },\n  {\n    event: contentEvents.downloadAssetAdded,\n    label: 'Download file added',\n    category: 'Downloads',\n    description: 'a download asset was added',\n  },\n  {\n    event: contentEvents.downloadAssetRemoved,\n    label: 'Download file removed',\n    category: 'Downloads',\n    description: 'a download asset was removed',\n  },\n  {\n    event: contentEvents.downloadAssetRenamed,\n    label: 'Download file renamed',\n    category: 'Downloads',\n    description: 'a download asset was renamed',\n  },\n  {\n    event: contentEvents.downloadAssetsReordered,\n    label: 'Download files reordered',\n    category: 'Downloads',\n    description: 'download assets were reordered',\n  },\n  {\n    event: contentEvents.communityCreated,\n    label: 'Community created',\n    category: 'Communities',\n    description: 'a community was created',\n  },\n  {\n    event: contentEvents.communityUpdated,\n    label: 'Community updated',\n    category: 'Communities',\n    description: 'a community was updated',\n  },\n  {\n    event: contentEvents.communityDeleted,\n    label: 'Community deleted',\n    category: 'Communities',\n    description: 'a community was deleted',\n  },\n  {\n    event: contentEvents.spaceCreated,\n    label: 'Space created',\n    category: 'Communities',\n    description: 'a space was created',\n  },\n  {\n    event: contentEvents.spaceUpdated,\n    label: 'Space updated',\n    category: 'Communities',\n    description: 'a space was updated',\n  },\n  {\n    event: contentEvents.spaceDeleted,\n    label: 'Space deleted',\n    category: 'Communities',\n    description: 'a space was deleted',\n  },\n  {\n    event: contentEvents.spacesReordered,\n    label: 'Spaces reordered',\n    category: 'Communities',\n    description: 'spaces were reordered',\n  },\n  {\n    event: entitlementEvents.entitlementCreated,\n    label: 'Access granted',\n    category: 'Access',\n    description: 'a student was granted access to content',\n  },\n  {\n    event: entitlementEvents.entitlementUpdated,\n    label: 'Access updated',\n    category: 'Access',\n    description: \"an entitlement's status or expiry changed\",\n  },\n  {\n    event: entitlementEvents.entitlementDeleted,\n    label: 'Access revoked',\n    category: 'Access',\n    description: \"a student's access to content was revoked\",\n  },\n  {\n    event: entitlementEvents.entitlementExpired,\n    label: 'Access expired',\n    category: 'Access',\n    description: 'an entitlement passed its expiry',\n  },\n  {\n    event: entitlementEvents.entitlementEndingSoon,\n    label: 'Access ending soon',\n    category: 'Access',\n    description: 'an entitlement expires within a week',\n  },\n  {\n    event: entitlementEvents.spaceMemberCreated,\n    label: 'Space member created',\n    category: 'Access',\n    description: 'a person was added to a space',\n  },\n  {\n    event: entitlementEvents.spaceMemberUpdated,\n    label: 'Space member updated',\n    category: 'Access',\n    description: 'a space membership changed',\n  },\n  {\n    event: entitlementEvents.spaceMemberDeleted,\n    label: 'Space member removed',\n    category: 'Access',\n    description: 'a space membership was removed',\n  },\n  {\n    event: progressEvents.progressStarted,\n    label: 'Progress started',\n    category: 'Progress',\n    description: 'a student started a progress record',\n  },\n  {\n    event: progressEvents.progressCompleted,\n    label: 'Progress completed',\n    category: 'Progress',\n    description: 'a student completed a progress record',\n  },\n  {\n    event: integrationEvents.connectionCreated,\n    label: 'Integration connected',\n    category: 'Integrations',\n    description: 'an integration connection was established',\n  },\n  {\n    event: integrationEvents.connectionUpdated,\n    label: 'Integration updated',\n    category: 'Integrations',\n    description: 'an integration connection changed',\n  },\n  {\n    event: integrationEvents.connectionRemoved,\n    label: 'Integration disconnected',\n    category: 'Integrations',\n    description: 'an integration connection was removed',\n  },\n  {\n    event: discussionEvents.commentCreated,\n    label: 'Comment created',\n    category: 'Discussion',\n    description: 'a comment was created',\n  },\n  {\n    event: discussionEvents.commentPublished,\n    label: 'Comment published',\n    category: 'Discussion',\n    description: 'a comment was published',\n  },\n  {\n    event: discussionEvents.commentUpdated,\n    label: 'Comment updated',\n    category: 'Discussion',\n    description: 'a comment was edited',\n  },\n  {\n    event: discussionEvents.commentReactionAdded,\n    label: 'Comment reaction added',\n    category: 'Discussion',\n    description: 'a person reacted to a comment for the first time',\n  },\n  {\n    event: discussionEvents.commentRemoved,\n    label: 'Comment removed',\n    category: 'Discussion',\n    description: 'a comment was removed',\n  },\n  {\n    event: discussionEvents.commentReported,\n    label: 'Comment reported',\n    category: 'Discussion',\n    description: 'a comment was reported',\n  },\n  {\n    event: discussionEvents.postCreated,\n    label: 'Post created',\n    category: 'Discussion',\n    description: 'a post was created',\n  },\n  {\n    event: discussionEvents.postUpdated,\n    label: 'Post updated',\n    category: 'Discussion',\n    description: 'a post was updated',\n  },\n  {\n    event: discussionEvents.postPublished,\n    label: 'Post published',\n    category: 'Discussion',\n    description: 'a post was published',\n  },\n  {\n    event: discussionEvents.postReactionAdded,\n    label: 'Post reaction added',\n    category: 'Discussion',\n    description: 'a person reacted to a post for the first time',\n  },\n  {\n    event: discussionEvents.postRemoved,\n    label: 'Post removed',\n    category: 'Discussion',\n    description: 'a post was removed',\n  },\n  {\n    event: discussionEvents.postReported,\n    label: 'Post reported',\n    category: 'Discussion',\n    description: 'a post was reported',\n  },\n  {\n    event: discussionEvents.chatCreated,\n    label: 'Chat created',\n    category: 'Discussion',\n    description: 'a chat was created',\n  },\n  {\n    event: discussionEvents.chatUpdated,\n    label: 'Chat updated',\n    category: 'Discussion',\n    description: 'a chat was updated',\n  },\n  {\n    event: discussionEvents.chatParticipantAdded,\n    label: 'Chat participant added',\n    category: 'Discussion',\n    description: 'a person was added to a chat',\n  },\n  {\n    event: discussionEvents.messageSent,\n    label: 'Message sent',\n    category: 'Discussion',\n    description: 'a message was sent',\n  },\n  {\n    event: discussionEvents.messageUpdated,\n    label: 'Message updated',\n    category: 'Discussion',\n    description: 'a message was edited',\n  },\n  {\n    event: discussionEvents.messageReactionAdded,\n    label: 'Message reaction added',\n    category: 'Discussion',\n    description: 'a person reacted to a message for the first time',\n  },\n  {\n    event: discussionEvents.messageDeleted,\n    label: 'Message deleted',\n    category: 'Discussion',\n    description: 'a message was deleted',\n  },\n  {\n    event: discussionEvents.messageReported,\n    label: 'Message reported',\n    category: 'Discussion',\n    description: 'a message was reported',\n  },\n  {\n    event: discussionEvents.digestDue,\n    label: 'Digest due',\n    category: 'Discussion',\n    description: \"a community's digest came due on its schedule\",\n  },\n  {\n    event: assetEvents.assetCreated,\n    label: 'Upload requested',\n    category: 'Assets',\n    description: 'an asset upload was requested',\n  },\n  {\n    event: assetEvents.assetReady,\n    label: 'Upload ready',\n    category: 'Assets',\n    description: 'an asset was confirmed ready',\n  },\n  {\n    event: assetEvents.assetDeleted,\n    label: 'Asset deleted',\n    category: 'Assets',\n    description: 'an asset was deleted',\n  },\n];\n\nexport function catalogTriggers(): AvailableTriggers['triggers'] {\n  return TRIGGERS.map(({ event, ...trigger }) => ({ type: event.type, ...trigger }));\n}\n\nexport function publicDataSchema(type: string): z.ZodType | undefined {\n  return TRIGGERS.find((trigger) => trigger.event.type === type)?.event.publicData;\n}\n"],"mappings":";;;;;;;;;;AAgBA,MAAa,yBAAwD;CACnE,WAAW;CACX,eAAe;CACf,cAAc;CACd,eAAe;CACf,iBAAiB;CACjB,mBAAmB;CACnB,eAAe;CACf,eAAe;CACf,iBAAiB;CACjB,oBAAoB;CACpB,sBAAsB;CACtB,iBAAiB;CACjB,gBAAgB;CAChB,sBAAsB;CACtB,oBAAoB;CACpB,kBAAkB;CAClB,oBAAoB;CACpB,uBAAuB;CACvB,iBAAiB;CACjB,iBAAiB;CACjB,gBAAgB;CAChB,gBAAgB;CAChB,YAAY;CACZ,kBAAkB;CAClB,qBAAqB;CACrB,QAAQ;CACR,oBAAoB;CACpB,aAAa;CACb,qBAAqB;CACrB,mBAAmB;CACnB,aAAa;CACb,gBAAgB;CAChB,SAAS;CACT,gBAAgB;CAChB,qBAAqB;CACrB,wBAAwB;CACxB,wBAAwB;CACxB,wBAAwB;CACxB,wBAAwB;CACxB,iBAAiB;AACnB;AAEA,MAAa,yBAAyB;AAEtC,SAAgB,iBAAmC;CACjD,OAAO,CACL;EACE,MAAM;EACN,aAAa;EACb,aAAa;GACX,MAAM;GACN,UAAU,CAAC,UAAU;GACrB,YAAY,EACV,UAAU,EAAE,MAAM,OAAO,KAAK,sBAAsB,EAAE,EACxD;EACF;EACA,QAAQ;CACV,GACA;EACE,MAAM;EACN,aAAa;EACb,aAAa;GACX,MAAM;GACN,YAAY;IACV,WAAW,EAAE,MAAM,SAAS;IAC5B,UAAU,EAAE,MAAM,SAAS;IAC3B,eAAe,EAAE,MAAM,SAAS;GAClC;EACF;EACA,QAAQ;CACV,CACF;AACF;AASA,MAAM,WAA6B;CACjC;EACE,OAAO,eAAe;EACtB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,eAAe;EACtB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,mBAAmB;EAC1B,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,mBAAmB;EAC1B,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,mBAAmB;EAC1B,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,mBAAmB;EAC1B,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,mBAAmB;EAC1B,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,mBAAmB;EAC1B,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,mBAAmB;EAC1B,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,mBAAmB;EAC1B,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,mBAAmB;EAC1B,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,mBAAmB;EAC1B,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,mBAAmB;EAC1B,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,cAAc;EACrB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,cAAc;EACrB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,cAAc;EACrB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,cAAc;EACrB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,cAAc;EACrB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,cAAc;EACrB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,cAAc;EACrB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,cAAc;EACrB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,cAAc;EACrB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,cAAc;EACrB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,cAAc;EACrB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,cAAc;EACrB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,cAAc;EACrB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,cAAc;EACrB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,cAAc;EACrB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,cAAc;EACrB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,cAAc;EACrB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,cAAc;EACrB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,cAAc;EACrB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,cAAc;EACrB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,cAAc;EACrB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,cAAc;EACrB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,cAAc;EACrB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,cAAc;EACrB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,cAAc;EACrB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,cAAc;EACrB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,kBAAkB;EACzB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,kBAAkB;EACzB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,kBAAkB;EACzB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,kBAAkB;EACzB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,kBAAkB;EACzB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,kBAAkB;EACzB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,kBAAkB;EACzB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,kBAAkB;EACzB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,eAAe;EACtB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,eAAe;EACtB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,kBAAkB;EACzB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,kBAAkB;EACzB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,kBAAkB;EACzB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,iBAAiB;EACxB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,iBAAiB;EACxB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,iBAAiB;EACxB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,iBAAiB;EACxB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,iBAAiB;EACxB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,iBAAiB;EACxB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,iBAAiB;EACxB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,iBAAiB;EACxB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,iBAAiB;EACxB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,iBAAiB;EACxB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,iBAAiB;EACxB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,iBAAiB;EACxB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,iBAAiB;EACxB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,iBAAiB;EACxB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,iBAAiB;EACxB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,iBAAiB;EACxB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,iBAAiB;EACxB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,iBAAiB;EACxB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,iBAAiB;EACxB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,iBAAiB;EACxB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,iBAAiB;EACxB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,YAAY;EACnB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,YAAY;EACnB,OAAO;EACP,UAAU;EACV,aAAa;CACf;CACA;EACE,OAAO,YAAY;EACnB,OAAO;EACP,UAAU;EACV,aAAa;CACf;AACF;AAEA,SAAgB,kBAAiD;CAC/D,OAAO,SAAS,KAAK,EAAE,OAAO,GAAG,eAAe;EAAE,MAAM,MAAM;EAAM,GAAG;CAAQ,EAAE;AACnF;AAEA,SAAgB,iBAAiB,MAAqC;CACpE,OAAO,SAAS,MAAM,YAAY,QAAQ,MAAM,SAAS,IAAI,CAAC,EAAE,MAAM;AACxE"}

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

@@ -0,0 +1,14 @@
+import { DomainEvent } from "../types/shared.js";
+import { EmailTemplateId } from "../types/email-templates.js";
+import "../types/index.js";
+import "../shared/ports.js";
+import { ActionDeps, EmailRecipient } from "./community-mail.js";
+//#region src/automations/community-derivations.d.ts
+interface EmailDerivation<K extends EmailTemplateId> {
+  triggers: readonly string[];
+  derive(event: DomainEvent, deps: ActionDeps): Promise<EmailRecipient<K>[] | undefined>;
+}
+declare const COMMUNITY_DERIVATIONS: { [K in EmailTemplateId]?: EmailDerivation<K>; };
+//#endregion
+export { COMMUNITY_DERIVATIONS, EmailDerivation };
+//# sourceMappingURL=community-derivations.d.ts.map