@headless-lms/core 0.2.0 → 0.4.0

package/dist/automations/ports.d.ts

@@ -1,18 +1,134 @@
 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, DeliveryDispatch, ScheduledAutomation, WebhookRequest, WebhookResponse, WebhookSender } from "../types/automations.js";
+import { Delivery, NotificationCategory, NotificationFilter, RecipientList, StoredNotification, SubjectRef } from "../types/notifications.js";
 import "../types/index.js";
 import { CredentialStore, OutboxAppender, UnitOfWork } from "../shared/ports.js";
 import "./model.js";
 import "./types.js";
+import { CommunityMailReads } from "./community-mail.js";
 //#region src/automations/ports.d.ts
 type NewAutomation = CreateAutomationInput & {
   kind: AutomationKind;
 };
+interface NotificationCategories {
+  listFor(orgId: string, communityId: string | null): Promise<NotificationCategory[]>;
+}
+interface NotificationReads extends Omit<CommunityMailReads, 'recentMessageRecipients'> {
+  threadParticipants(orgId: string, item: SubjectRef): Promise<string[]>;
+  mutedAmong(orgId: string, item: SubjectRef, orgUserIds: string[], at: Date): Promise<string[]>;
+  communityMembers(orgId: string, communityId: string): Promise<string[]>;
+  switchedOn(orgId: string, communityId: string, category: string, spaceId: string | null): Promise<string[]>;
+  courseHolders(orgId: string, courseId: string): Promise<string[]>;
+  contentLostBy(orgId: string, grant: {
+    orgUserId: string;
+    contentId: string | null;
+    bundleId: string | null;
+  }): Promise<string[]>;
+  activity(orgId: string, activityId: string): Promise<{
+    title: string;
+    moduleTitle: string;
+    courseId: string;
+    courseTitle: string;
+  } | null>;
+  userIdsOf(orgId: string, orgUserIds: string[]): Promise<Record<string, string>>;
+  emailOf(orgId: string, userId: string): Promise<string | null>;
+  contentInfo(orgId: string, item: {
+    contentId: string;
+  } | {
+    bundleId: string;
+  }): Promise<{
+    title: string;
+    type: string;
+  } | null>;
+  message(orgId: string, messageId: string): Promise<{
+    orgUserId: string;
+    chatId: string;
+    body: string;
+  } | null>;
+  postsPublished(orgId: string, communityId: string, from: Date, to: Date): Promise<{
+    postId: string;
+    spaceId: string;
+    title: string;
+    authorName: string;
+    spaceName: string;
+    commentCount: number;
+  }[]>;
+  unreadInChat(orgId: string, chatId: string, orgUserId: string): Promise<{
+    count: number;
+    latest: {
+      messageId: string;
+      senderOrgUserId: string;
+      body: string;
+    } | null;
+  }>;
+}
+type RecipientRule = (event: DomainEvent, reads: NotificationReads) => Promise<RecipientList[]>;
+interface ChatDebounce {
+  arm(orgId: string, list: RecipientList, occurredAt: Date): Promise<void>;
+  mentioned(orgId: string, userId: string, chatId: string): Promise<void>;
+}
+interface NewNotification extends Omit<StoredNotification, 'orgId'> {
+  sourceEventId: string | null;
+  inApp: boolean;
+}
+interface NewDelivery {
+  id: string;
+  notificationId: string;
+  channel: string;
+}
+type ListedNotification = StoredNotification & {
+  readAt: Date | null;
+};
+interface NotificationPage {
+  items: ListedNotification[];
+  total: number;
+  unreadCount: number;
+}
+interface UnreadCounts {
+  org: number;
+  communities: {
+    communityId: string;
+    unread: number;
+  }[];
+}
+interface NotificationsService {
+  list(orgId: string, userId: string, filter: NotificationFilter, page: {
+    page: number;
+    pageSize: number;
+  }): Promise<NotificationPage>;
+  get(orgId: string, userId: string, notificationId: string): Promise<ListedNotification | null>;
+  unreadCounts(orgId: string, userId: string, communityIds: string[]): Promise<UnreadCounts>;
+  markRead(orgId: string, userId: string, notificationId: string): Promise<void>;
+  markAllRead(orgId: string, userId: string, filter: NotificationFilter): Promise<{
+    marked: number;
+  }>;
+}
+interface NotificationsRepository {
+  insert(orgId: string, rows: NewNotification[], deliveries: NewDelivery[]): Promise<void>;
+  pendingDeliveriesForEvent(orgId: string, sourceEventId: string): Promise<{
+    id: string;
+  }[]>;
+  findDelivery(orgId: string, deliveryId: string): Promise<{
+    delivery: Delivery;
+    notification: StoredNotification;
+  } | null>;
+  markSent(orgId: string, deliveryId: string, at: Date): Promise<void>;
+  recordError(orgId: string, deliveryId: string, error: string): Promise<void>;
+  markFailed(orgId: string, deliveryId: string, error: string): Promise<void>;
+  page(orgId: string, userId: string, filter: NotificationFilter, page: {
+    page: number;
+    pageSize: number;
+  }): Promise<NotificationPage>;
+  find(orgId: string, userId: string, notificationId: string): Promise<ListedNotification | null>;
+  unreadCounts(orgId: string, userId: string, communityIds: string[]): Promise<UnreadCounts>;
+  markRead(orgId: string, userId: string, notificationId: string, at: Date): Promise<boolean>;
+  markAllRead(orgId: string, userId: string, filter: NotificationFilter, at: Date): Promise<number>;
+}
 /** A run row before persistence assigns its id and event_id. */
 type NewAutomationRun = Omit<AutomationRun, 'id' | 'eventId'>;
 interface AutomationsService {
-  /** Matches `event` against enabled automations and dispatches a run per match; never throws. */
+  /** Dispatches a run per enabled automation the event matches, then runs the notification process; throws only when the notification process fails, so the outbox redelivers. */
   handle(event: DomainEvent): Promise<void>;
   /** Built-in action types plus every loaded integration's declared actions. */
   availableActions(): AvailableActions;
@@ -42,6 +158,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 +172,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
@@ -67,5 +185,5 @@ interface AutomationsTxScope {
 }
 type AutomationsUnitOfWork = UnitOfWork<AutomationsTxScope>;
 //#endregion
-export { type AutomationDispatch, type AutomationEngine, type AutomationExecutor, AutomationRunsRepository, AutomationsRepository, AutomationsService, AutomationsTxScope, AutomationsUnitOfWork, NewAutomation, NewAutomationRun, type WebhookRequest, type WebhookResponse, type WebhookSender };
+export { type AutomationDispatch, type AutomationEngine, type AutomationExecutor, AutomationRunsRepository, AutomationsRepository, AutomationsService, AutomationsTxScope, AutomationsUnitOfWork, ChatDebounce, type DeliveryDispatch, ListedNotification, NewAutomation, NewAutomationRun, NewDelivery, NewNotification, NotificationCategories, NotificationPage, NotificationReads, NotificationsRepository, NotificationsService, RecipientRule, UnreadCounts, type WebhookRequest, type WebhookResponse, type WebhookSender };
 //# sourceMappingURL=ports.d.ts.map

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

package/dist/automations/schedule.js

@@ -0,0 +1,41 @@
+//#region src/automations/schedule.ts
+const FIELD_RANGES = [
+	[0, 59],
+	[0, 23],
+	[1, 31],
+	[1, 12],
+	[0, 6]
+];
+function cronMatches(expression, at) {
+	const fields = expression.trim().split(/\s+/);
+	if (fields.length !== 5) return false;
+	const parts = [
+		at.getUTCMinutes(),
+		at.getUTCHours(),
+		at.getUTCDate(),
+		at.getUTCMonth() + 1,
+		at.getUTCDay()
+	];
+	const [minute, hour, dayOfMonth, month, dayOfWeek] = fields.map((field, index) => field === "*" || field.split(",").some((piece) => Number(piece) === parts[index]));
+	const day = fields[2] !== "*" && fields[4] !== "*" ? dayOfMonth || dayOfWeek : dayOfMonth && dayOfWeek;
+	return Boolean(minute && hour && month && day);
+}
+function cronSupported(expression) {
+	const fields = expression.trim().split(/\s+/);
+	if (fields.length !== 5) return false;
+	return fields.every((field, index) => fieldSupported(field, FIELD_RANGES[index]));
+}
+function fieldSupported(field, range) {
+	if (field === "*") return true;
+	const pieces = field.split(",");
+	const [min, max] = range;
+	return pieces.length > 0 && pieces.every((piece) => {
+		if (!/^\d+$/.test(piece)) return false;
+		const value = Number(piece);
+		return value >= min && value <= max;
+	});
+}
+//#endregion
+export { cronMatches, cronSupported };
+
+//# sourceMappingURL=schedule.js.map

package/dist/automations/schedule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule.js","names":[],"sources":["../../src/automations/schedule.ts"],"sourcesContent":["const FIELD_RANGES = [\n  [0, 59],\n  [0, 23],\n  [1, 31],\n  [1, 12],\n  [0, 6],\n] as const;\n\nexport function cronMatches(expression: string, at: Date): boolean {\n  const fields = expression.trim().split(/\\s+/);\n  if (fields.length !== 5) {\n    return false;\n  }\n  const parts = [\n    at.getUTCMinutes(),\n    at.getUTCHours(),\n    at.getUTCDate(),\n    at.getUTCMonth() + 1,\n    at.getUTCDay(),\n  ];\n  const matches = fields.map(\n    (field, index) =>\n      field === '*' || field.split(',').some((piece) => Number(piece) === parts[index]),\n  );\n  const [minute, hour, dayOfMonth, month, dayOfWeek] = matches;\n  const day =\n    fields[2] !== '*' && fields[4] !== '*' ? dayOfMonth || dayOfWeek : dayOfMonth && dayOfWeek;\n  return Boolean(minute && hour && month && day);\n}\n\nexport function cronSupported(expression: string): boolean {\n  const fields = expression.trim().split(/\\s+/);\n  if (fields.length !== 5) {\n    return false;\n  }\n  return fields.every((field, index) => fieldSupported(field, FIELD_RANGES[index]!));\n}\n\nfunction fieldSupported(field: string, range: readonly [number, number]): boolean {\n  if (field === '*') {\n    return true;\n  }\n  const pieces = field.split(',');\n  const [min, max] = range;\n  return (\n    pieces.length > 0 &&\n    pieces.every((piece) => {\n      if (!/^\\d+$/.test(piece)) {\n        return false;\n      }\n      const value = Number(piece);\n      return value >= min && value <= max;\n    })\n  );\n}\n"],"mappings":";AAAA,MAAM,eAAe;CACnB,CAAC,GAAG,EAAE;CACN,CAAC,GAAG,EAAE;CACN,CAAC,GAAG,EAAE;CACN,CAAC,GAAG,EAAE;CACN,CAAC,GAAG,CAAC;AACP;AAEA,SAAgB,YAAY,YAAoB,IAAmB;CACjE,MAAM,SAAS,WAAW,KAAK,CAAC,CAAC,MAAM,KAAK;CAC5C,IAAI,OAAO,WAAW,GACpB,OAAO;CAET,MAAM,QAAQ;EACZ,GAAG,cAAc;EACjB,GAAG,YAAY;EACf,GAAG,WAAW;EACd,GAAG,YAAY,IAAI;EACnB,GAAG,UAAU;CACf;CAKA,MAAM,CAAC,QAAQ,MAAM,YAAY,OAAO,aAJxB,OAAO,KACpB,OAAO,UACN,UAAU,OAAO,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,UAAU,OAAO,KAAK,MAAM,MAAM,MAAM,CAEzB;CAC3D,MAAM,MACJ,OAAO,OAAO,OAAO,OAAO,OAAO,MAAM,cAAc,YAAY,cAAc;CACnF,OAAO,QAAQ,UAAU,QAAQ,SAAS,GAAG;AAC/C;AAEA,SAAgB,cAAc,YAA6B;CACzD,MAAM,SAAS,WAAW,KAAK,CAAC,CAAC,MAAM,KAAK;CAC5C,IAAI,OAAO,WAAW,GACpB,OAAO;CAET,OAAO,OAAO,OAAO,OAAO,UAAU,eAAe,OAAO,aAAa,MAAO,CAAC;AACnF;AAEA,SAAS,eAAe,OAAe,OAA2C;CAChF,IAAI,UAAU,KACZ,OAAO;CAET,MAAM,SAAS,MAAM,MAAM,GAAG;CAC9B,MAAM,CAAC,KAAK,OAAO;CACnB,OACE,OAAO,SAAS,KAChB,OAAO,OAAO,UAAU;EACtB,IAAI,CAAC,QAAQ,KAAK,KAAK,GACrB,OAAO;EAET,MAAM,QAAQ,OAAO,KAAK;EAC1B,OAAO,SAAS,OAAO,SAAS;CAClC,CAAC;AAEL"}

package/dist/automations/service.d.ts

@@ -1,12 +1,16 @@
 import { DomainEvent, Page } from "../types/shared.js";
 import { Logger } from "../types/ports.js";
 import { Automation, AutomationActionResult, AutomationRun, AutomationRunsQuery, AutomationsQuery, AvailableActions, AvailableTriggers, CreateAutomationInput, CreateWebhookInput, CreatedWebhook, UpdateAutomationInput, UpdateWebhookInput, Webhook, WebhookSecret } from "../types/schemas/automations.js";
-import { AutomationDispatch, AutomationEngine, AutomationExecutor, WebhookSender } from "../types/automations.js";
+import { AutomationDispatch, AutomationEngine, AutomationExecutor, DeliveryDispatch, ScheduledAutomation, WebhookSender } from "../types/automations.js";
+import "../types/index.js";
 import { CredentialStore } from "../shared/ports.js";
-import { Mailer, MailerLookups } from "../shared/mailer.js";
 import "./model.js";
+import { Mailer, MailerLookups } from "../shared/mailer.js";
 import "./types.js";
 import { AutomationRunsRepository, AutomationsRepository, AutomationsService, AutomationsUnitOfWork } from "./ports.js";
+import { CommunityMailReads, GrantWriter } from "./community-mail.js";
+import { NotificationDelivery } from "./notifications/delivery.js";
+import { NotificationProcessor } from "./notifications/processor.js";
 import { IntegrationsService } from "../integrations/ports.js";
 import "../integrations/index.js";
 //#region src/automations/service.d.ts
@@ -22,6 +26,10 @@ type AutomationsServiceParams = {
   integrations: Pick<IntegrationsService, 'available'>;
   credentials: CredentialStore;
   webhooks: WebhookSender;
+  mail: Omit<CommunityMailReads, 'recentMessageRecipients'>;
+  grants: GrantWriter;
+  delivery: Pick<NotificationDelivery, 'run'>;
+  processor: Pick<NotificationProcessor, 'process'>;
   logger?: Logger;
 };
 declare class AutomationsServiceImpl implements AutomationsService, AutomationExecutor {
@@ -34,17 +42,26 @@ declare class AutomationsServiceImpl implements AutomationsService, AutomationEx
   private readonly integrations;
   private readonly credentials;
   private readonly webhooks;
+  private readonly mail;
+  private readonly grants;
+  private readonly delivery;
+  private readonly processor;
   private readonly logger;
   constructor(params: AutomationsServiceParams);
   handle(event: DomainEvent): Promise<void>;
+  private reconcileSchedules;
   private safeListByTrigger;
   private dispatchOne;
   private openRun;
   private dispatchFor;
-  /** Best-effort: logs and never rethrows — `handle` must never throw. */
+  /** Best-effort: logs and never rethrows, so an org automation never fails `handle`. */
   private recordFailure;
   runAction(d: AutomationDispatch, index: number): Promise<AutomationActionResult>;
+  runDelivery(d: DeliveryDispatch, lastAttempt: boolean): Promise<void>;
+  listSchedules(): Promise<ScheduledAutomation[]>;
+  fireSchedule(orgId: string, automationId: string, at: Date): Promise<void>;
   finalize(d: AutomationDispatch, results: AutomationActionResult[]): Promise<void>;
+  private logOutcome;
   create(orgId: string, input: CreateAutomationInput): Promise<Automation>;
   update(orgId: string, id: string, input: UpdateAutomationInput): Promise<Automation | null>;
   delete(orgId: string, id: string): Promise<boolean>;
@@ -60,7 +77,6 @@ declare class AutomationsServiceImpl implements AutomationsService, AutomationEx
   revealWebhookSecret(orgId: string, id: string): Promise<WebhookSecret | null>;
   rotateWebhookSecret(orgId: string, id: string): Promise<WebhookSecret | null>;
   private findWebhook;
-  private assertSubscribableEvents;
   availableActions(): AvailableActions;
   availableTriggers(): AvailableTriggers;
 }