@headless-lms/server 0.2.0 → 0.4.0

package/dist/_virtual/_rolldown/runtime.js

@@ -0,0 +1,5 @@
+import { createRequire } from "node:module";
+//#region \0rolldown/runtime.js
+var __require = /* #__PURE__ */ (() => createRequire(import.meta.url))();
+//#endregion
+export { __require };

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

@@ -0,0 +1,24 @@
+import { ContentService } from "@headless-lms/core/content";
+import { EntitlementsService } from "@headless-lms/core/entitlements";
+import { ChatService, DiscussionService, PostService, SubscriptionService } from "@headless-lms/core/discussion";
+import { IdentityService } from "@headless-lms/core/identity";
+import { OrganizationService } from "@headless-lms/core/organizations";
+import { CommunityMailReads, GrantWriter } from "@headless-lms/core/automations";
+//#region src/app/community-mail.d.ts
+type CommunityMailDeps = {
+  content: Pick<ContentService, 'getCommunity' | 'getSpace' | 'listCommunitiesById'>;
+  entitlements: Pick<EntitlementsService, 'openSpacesFor' | 'communitiesOpenedBy' | 'communityMembersAmong' | 'spaceOpenersAmong' | 'spaceOpeners' | 'communityModeratorIds' | 'countActiveSpaceMembers' | 'communityIdsOpenedFor' | 'ensureGrant'>;
+  organizations: Pick<OrganizationService, 'getOrgUserById' | 'staffOrgUserIds'>;
+  identity: Pick<IdentityService, 'displayName'>;
+  posts: Pick<PostService, 'find'>;
+  subscriptions: Pick<SubscriptionService, 'followerIds' | 'itemSubscriptions'>;
+  discussion: Pick<DiscussionService, 'getComment'>;
+  chats: Pick<ChatService, 'chatSummary' | 'latestMessageBody' | 'isBlocked'>;
+};
+declare function communityMail(deps: CommunityMailDeps): {
+  mail: Omit<CommunityMailReads, 'recentMessageRecipients'>;
+  grants: GrantWriter;
+};
+//#endregion
+export { CommunityMailDeps, communityMail };
+//# sourceMappingURL=community-mail.d.ts.map

package/dist/app/community-mail.js

@@ -0,0 +1,92 @@
+//#region src/app/community-mail.ts
+function communityMail(deps) {
+	return {
+		mail: {
+			async communityTitle(orgId, communityId) {
+				return (await deps.content.getCommunity(orgId, communityId))?.title ?? null;
+			},
+			async space(orgId, spaceId) {
+				const space = await deps.content.getSpace(orgId, spaceId);
+				return space ? {
+					name: space.name,
+					communityId: space.communityId,
+					capacity: space.capacity
+				} : null;
+			},
+			async openSpaceNames(orgId, orgUserId, communityId) {
+				const orgUser = await deps.organizations.getOrgUserById(orgId, orgUserId);
+				if (!orgUser) return [];
+				return (await deps.entitlements.openSpacesFor(orgId, {
+					id: orgUser.id,
+					role: orgUser.role
+				}, communityId)).map((space) => space.name);
+			},
+			communitiesOpenedBy: (orgId, grant) => deps.entitlements.communitiesOpenedBy(orgId, grant),
+			communityMembersAmong: (orgId, communityId, ids) => deps.entitlements.communityMembersAmong(orgId, communityId, ids),
+			spaceOpenersAmong: (orgId, spaceId, ids) => deps.entitlements.spaceOpenersAmong(orgId, spaceId, ids),
+			spaceOpeners: (orgId, spaceId) => deps.entitlements.spaceOpeners(orgId, spaceId),
+			moderationAudience: (orgId, communityId) => deps.entitlements.communityModeratorIds(orgId, communityId),
+			staffIds: (orgId) => deps.organizations.staffOrgUserIds(orgId),
+			async displayName(orgId, orgUserId) {
+				const orgUser = await deps.organizations.getOrgUserById(orgId, orgUserId);
+				return deps.identity.displayName(orgUser?.userId ?? null);
+			},
+			followerIds: (orgId, postId) => deps.subscriptions.followerIds(orgId, postId),
+			async comment(orgId, commentId) {
+				const comment = await deps.discussion.getComment(orgId, commentId);
+				return comment ? {
+					orgUserId: comment.orgUserId,
+					postId: comment.postId,
+					activityId: comment.activityId,
+					parentId: comment.parentId,
+					body: comment.body
+				} : null;
+			},
+			async post(orgId, postId) {
+				const post = await deps.posts.find(orgId, postId);
+				return post ? {
+					title: post.title,
+					body: post.body,
+					spaceId: post.spaceId,
+					orgUserId: post.orgUserId,
+					communityId: post.communityId
+				} : null;
+			},
+			async chat(orgId, chatId) {
+				const summary = await deps.chats.chatSummary(orgId, chatId);
+				if (!summary) return null;
+				const mutes = new Map((await deps.subscriptions.itemSubscriptions(orgId, {
+					type: "chat",
+					id: chatId
+				})).filter((subscription) => subscription.state === "muted").map((subscription) => [subscription.orgUserId, subscription.mutedUntil]));
+				return {
+					communityId: summary.chat.communityId,
+					kind: summary.chat.kind,
+					status: summary.chat.status,
+					createdBy: summary.chat.createdBy,
+					participants: summary.participants.map((participant) => ({
+						orgUserId: participant.orgUserId,
+						muted: mutes.has(participant.orgUserId),
+						mutedUntil: mutes.get(participant.orgUserId) ?? null,
+						leftAt: participant.leftAt
+					}))
+				};
+			},
+			latestMessageBody: (orgId, chatId) => deps.chats.latestMessageBody(orgId, chatId),
+			pairBlocked: (orgId, communityId, a, b) => deps.chats.isBlocked(orgId, communityId, a, b),
+			activeMemberCount: (orgId, spaceId) => deps.entitlements.countActiveSpaceMembers(orgId, spaceId),
+			async memberCommunityTitles(orgId, orgUserId) {
+				const ids = await deps.entitlements.communityIdsOpenedFor(orgId, orgUserId);
+				return (await deps.content.listCommunitiesById(orgId, ids)).map((community) => ({
+					id: community.id,
+					title: community.title
+				}));
+			}
+		},
+		grants: { grant: (orgId, input) => deps.entitlements.ensureGrant(orgId, input) }
+	};
+}
+//#endregion
+export { communityMail };
+
+//# sourceMappingURL=community-mail.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"community-mail.js","names":[],"sources":["../../src/app/community-mail.ts"],"sourcesContent":["import type { CommunityMailReads, GrantWriter } from '@headless-lms/core/automations';\nimport type { ContentService } from '@headless-lms/core/content';\nimport type {\n  ChatService,\n  DiscussionService,\n  PostService,\n  SubscriptionService,\n} from '@headless-lms/core/discussion';\nimport type { EntitlementsService } from '@headless-lms/core/entitlements';\nimport type { IdentityService } from '@headless-lms/core/identity';\nimport type { OrganizationService } from '@headless-lms/core/organizations';\n\nexport type CommunityMailDeps = {\n  content: Pick<ContentService, 'getCommunity' | 'getSpace' | 'listCommunitiesById'>;\n  entitlements: Pick<\n    EntitlementsService,\n    | 'openSpacesFor'\n    | 'communitiesOpenedBy'\n    | 'communityMembersAmong'\n    | 'spaceOpenersAmong'\n    | 'spaceOpeners'\n    | 'communityModeratorIds'\n    | 'countActiveSpaceMembers'\n    | 'communityIdsOpenedFor'\n    | 'ensureGrant'\n  >;\n  organizations: Pick<OrganizationService, 'getOrgUserById' | 'staffOrgUserIds'>;\n  identity: Pick<IdentityService, 'displayName'>;\n  posts: Pick<PostService, 'find'>;\n  subscriptions: Pick<SubscriptionService, 'followerIds' | 'itemSubscriptions'>;\n  discussion: Pick<DiscussionService, 'getComment'>;\n  chats: Pick<ChatService, 'chatSummary' | 'latestMessageBody' | 'isBlocked'>;\n};\n\nexport function communityMail(deps: CommunityMailDeps): {\n  mail: Omit<CommunityMailReads, 'recentMessageRecipients'>;\n  grants: GrantWriter;\n} {\n  const mail: Omit<CommunityMailReads, 'recentMessageRecipients'> = {\n    async communityTitle(orgId, communityId) {\n      return (await deps.content.getCommunity(orgId, communityId))?.title ?? null;\n    },\n    async space(orgId, spaceId) {\n      const space = await deps.content.getSpace(orgId, spaceId);\n      return space\n        ? { name: space.name, communityId: space.communityId, capacity: space.capacity }\n        : null;\n    },\n    async openSpaceNames(orgId, orgUserId, communityId) {\n      const orgUser = await deps.organizations.getOrgUserById(orgId, orgUserId);\n      if (!orgUser) {\n        return [];\n      }\n      const spaces = await deps.entitlements.openSpacesFor(\n        orgId,\n        { id: orgUser.id, role: orgUser.role },\n        communityId,\n      );\n      return spaces.map((space) => space.name);\n    },\n    communitiesOpenedBy: (orgId, grant) => deps.entitlements.communitiesOpenedBy(orgId, grant),\n    communityMembersAmong: (orgId, communityId, ids) =>\n      deps.entitlements.communityMembersAmong(orgId, communityId, ids),\n    spaceOpenersAmong: (orgId, spaceId, ids) =>\n      deps.entitlements.spaceOpenersAmong(orgId, spaceId, ids),\n    spaceOpeners: (orgId, spaceId) => deps.entitlements.spaceOpeners(orgId, spaceId),\n    moderationAudience: (orgId, communityId) =>\n      deps.entitlements.communityModeratorIds(orgId, communityId),\n    staffIds: (orgId) => deps.organizations.staffOrgUserIds(orgId),\n    async displayName(orgId, orgUserId) {\n      const orgUser = await deps.organizations.getOrgUserById(orgId, orgUserId);\n      return deps.identity.displayName(orgUser?.userId ?? null);\n    },\n    followerIds: (orgId, postId) => deps.subscriptions.followerIds(orgId, postId),\n    async comment(orgId, commentId) {\n      const comment = await deps.discussion.getComment(orgId, commentId);\n      return comment\n        ? {\n            orgUserId: comment.orgUserId,\n            postId: comment.postId,\n            activityId: comment.activityId,\n            parentId: comment.parentId,\n            body: comment.body,\n          }\n        : null;\n    },\n    async post(orgId, postId) {\n      const post = await deps.posts.find(orgId, postId);\n      return post\n        ? {\n            title: post.title,\n            body: post.body,\n            spaceId: post.spaceId,\n            orgUserId: post.orgUserId,\n            communityId: post.communityId,\n          }\n        : null;\n    },\n    async chat(orgId, chatId) {\n      const summary = await deps.chats.chatSummary(orgId, chatId);\n      if (!summary) {\n        return null;\n      }\n      const mutes = new Map(\n        (await deps.subscriptions.itemSubscriptions(orgId, { type: 'chat', id: chatId }))\n          .filter((subscription) => subscription.state === 'muted')\n          .map((subscription) => [subscription.orgUserId, subscription.mutedUntil]),\n      );\n      return {\n        communityId: summary.chat.communityId,\n        kind: summary.chat.kind,\n        status: summary.chat.status,\n        createdBy: summary.chat.createdBy,\n        participants: summary.participants.map((participant) => ({\n          orgUserId: participant.orgUserId,\n          muted: mutes.has(participant.orgUserId),\n          mutedUntil: mutes.get(participant.orgUserId) ?? null,\n          leftAt: participant.leftAt,\n        })),\n      };\n    },\n    latestMessageBody: (orgId, chatId) => deps.chats.latestMessageBody(orgId, chatId),\n    pairBlocked: (orgId, communityId, a, b) => deps.chats.isBlocked(orgId, communityId, a, b),\n    activeMemberCount: (orgId, spaceId) =>\n      deps.entitlements.countActiveSpaceMembers(orgId, spaceId),\n    async memberCommunityTitles(orgId, orgUserId) {\n      const ids = await deps.entitlements.communityIdsOpenedFor(orgId, orgUserId);\n      const communities = await deps.content.listCommunitiesById(orgId, ids);\n      return communities.map((community) => ({ id: community.id, title: community.title }));\n    },\n  };\n  return {\n    mail,\n    grants: {\n      grant: (orgId, input) => deps.entitlements.ensureGrant(orgId, input),\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/app/container.d.ts

@@ -1,23 +1,22 @@
+import { McpEndpoints } from "./mcp-endpoints.js";
 import { PollingOutboxRelayConfig } from "@headless-lms/adapter-defaults/events/outbox-relay";
 import { LogLevel, PinoInstance, RequestLogContext } from "@headless-lms/adapter-defaults/logging";
 import { BetterAuth } from "@headless-lms/adapter-auth";
-import { ContentService } from "@headless-lms/core/content";
+import { CommunityNotificationCategories, ContentService } from "@headless-lms/core/content";
 import { EntitlementsServiceImpl } from "@headless-lms/core/entitlements";
 import { ProgressServiceImpl } from "@headless-lms/core/progress";
-import { DiscussionServiceImpl } from "@headless-lms/core/discussion";
-import { IdentityServiceImpl, SessionAdmin } from "@headless-lms/core/identity";
-import { OrgAdmin, OrganizationServiceImpl } from "@headless-lms/core/organizations";
+import { ChatServiceImpl, DiscussionServiceImpl, PostServiceImpl, SubscriptionServiceImpl } from "@headless-lms/core/discussion";
+import { DevicesServiceImpl, IdentityServiceImpl, NotificationSettingsServiceImpl, SessionAdmin } from "@headless-lms/core/identity";
+import { OrgAdmin, OrgNotificationCategories, OrganizationServiceImpl } from "@headless-lms/core/organizations";
 import { AssetsServiceImpl } from "@headless-lms/core/assets";
 import { IntegrationsServiceImpl } from "@headless-lms/core/integrations";
-import { AutomationsServiceImpl } from "@headless-lms/core/automations";
-import { StudentsReportServiceImpl } from "@headless-lms/core/reporting/students";
-import { DashboardReportServiceImpl } from "@headless-lms/core/reporting/dashboard";
-import { CoursesReportServiceImpl } from "@headless-lms/core/reporting/courses";
-import { LearnReportServiceImpl } from "@headless-lms/core/reporting/learn";
+import { AutomationsServiceImpl, NotificationCategories, NotificationsServiceImpl } from "@headless-lms/core/automations";
 import { Mailer } from "@headless-lms/core/shared/mailer";
+import { AdminReportServiceImpl } from "@headless-lms/core/reporting/admin";
+import { MemberReportServiceImpl } from "@headless-lms/core/reporting/member";
 import { SettingsService } from "@headless-lms/core/shared/settings";
-import { AutomationEngine, WebhookSender } from "@headless-lms/core/types";
-import { CredentialStore, EmailSender, Logger, ObjectStorage, OutboxRelay, TemplateContext, TemplateRenderer } from "@headless-lms/core/shared/ports";
+import { AutomationEngine, PushConfig, WebhookSender } from "@headless-lms/core/types";
+import { ChannelRegistry, CredentialStore, EmailSender, Logger, NotificationChannel, NotificationTypeRegistry, ObjectStorage, OutboxRelay, PushSender, Scheduler, TemplateContext, TemplateRenderer } from "@headless-lms/core/shared/ports";
 //#region src/app/container.d.ts
 /** Installation-supplied ports; an absent slot falls back to a fail-loudly stub. */
 interface AdapterOverrides {
@@ -25,10 +24,15 @@ interface AdapterOverrides {
   storage?: ObjectStorage;
   /** Resolves email templates to rendered content. Absent → fail-loudly stub. */
   templates?: TemplateRenderer;
-  /** Durable automation engine. Absent → InlineAutomationEngine (in-process, one attempt per action). */
-  workflows?: AutomationEngine;
-  /** Outbound HTTP for webhook deliveries. Absent → FetchWebhookSender (fetch, 10s timeout). */
+  /** Durable automation engine, or a factory given the automations logger. Absent → InlineAutomationEngine (in-process, one attempt per action). */
+  workflows?: (AutomationEngine & Scheduler) | ((logger: Logger) => AutomationEngine & Scheduler);
+  /** Outbound HTTP for webhook deliveries. Absent → FetchWebhookSender (public addresses only, 10s timeout). */
   webhooks?: WebhookSender;
+  /** Notification channels beyond in-app, email and push; each key must be new. */
+  notificationChannels?: NotificationChannel[];
+  /** Push credentials per provider. Absent → no provider is configured and devices cannot register. */
+  push?: PushConfig;
+  pushSender?: PushSender;
 }
 interface BuildContainerOptions {
   /** Installation's plugins folder, scanned by loadIntegrations. Absent → no integrations. */
@@ -57,9 +61,12 @@ interface Config {
   outbox?: OutboxConfig;
   /** Log level for the process-wide logger (HTTP + domain + relay). Default "info". */
   logging?: LoggingConfig;
-  /** Presigned URL lifetime for entitled download delivery, seconds. Mirrors
+  /** Lifetime of every signed file URL a response carries, seconds. Mirrors
    *  ServerConfig.deliveryExpirySeconds — createContainer threads it through. */
   deliveryExpirySeconds: number;
+  memberImageMaxBytes: number;
+  /** Let the default webhook sender reach loopback and private network addresses. Local development only. */
+  webhookAllowPrivateNetwork?: boolean;
 }
 /** Tuning for the transactional-outbox relay. Every field is optional; the
  *  container resolves against OUTBOX_DEFAULTS. */
@@ -70,6 +77,7 @@ interface OutboxConfig {
   pollIntervalMs?: number;
   /** Max rows fetched/dispatched per tick. Default 100. */
   batchSize?: number;
+  concurrency?: number;
 }
 declare const OUTBOX_DEFAULTS: PollingOutboxRelayConfig;
 declare function resolveOutboxConfig(config?: OutboxConfig): PollingOutboxRelayConfig;
@@ -82,6 +90,7 @@ declare const LOGGING_DEFAULTS: Required<LoggingConfig>;
 declare function resolveLoggingConfig(config?: LoggingConfig): Required<LoggingConfig>;
 interface Container {
   auth: BetterAuth;
+  mcp: McpEndpoints;
   orgProvider: OrgAdmin;
   identity: IdentityServiceImpl;
   organizations: OrganizationServiceImpl;
@@ -89,17 +98,28 @@ interface Container {
   entitlements: EntitlementsServiceImpl;
   progress: ProgressServiceImpl;
   discussion: DiscussionServiceImpl;
+  posts: PostServiceImpl;
+  chats: ChatServiceImpl;
+  subscriptions: SubscriptionServiceImpl;
   assets: AssetsServiceImpl;
   integrations: IntegrationsServiceImpl;
   automations: AutomationsServiceImpl;
+  notificationTypes: NotificationTypeRegistry;
+  notificationChannels: ChannelRegistry;
+  notificationCategories: {
+    community: CommunityNotificationCategories;
+    org: OrgNotificationCategories;
+  };
+  notificationCategoryLists: NotificationCategories;
+  notificationSettings: NotificationSettingsServiceImpl;
+  devices: DevicesServiceImpl;
+  notificationList: NotificationsServiceImpl;
   /** Cross-cutting settings store. Not a context — a leaf every context may use;
    *  inject `settings.for('<namespace>')` into a service, never the service itself. */
   settings: SettingsService;
   reporting: {
-    students: StudentsReportServiceImpl;
-    dashboard: DashboardReportServiceImpl;
-    courses: CoursesReportServiceImpl;
-    learn: LearnReportServiceImpl;
+    admin: AdminReportServiceImpl;
+    member: MemberReportServiceImpl;
   };
   storage: ObjectStorage;
   mailer: Mailer;
@@ -113,6 +133,7 @@ interface Container {
    *  the installation's entry point starts it after listen (gen-openapi must
    *  not run a worker). buildServer stops it onClose. */
   automationEngine: AutomationEngine;
+  scheduler: Scheduler;
   /** Root logger port — components receive children bound with { name }. */
   logger: Logger;
   /** The raw pino root; buildServer hands it to Fastify so HTTP shares the stream. */