@headless-lms/core 0.3.0 → 0.5.0

package/dist/content/ports.d.ts

@@ -1,102 +1,152 @@
 import { Page } from "../types/shared.js";
-import { Activity, ActivityAsset, ActivityView, AddDownloadAssetInput, Bundle, BundleItem, Community, CommunityView, Course, CourseSettings, CourseView, CreateBundleInput, CreateCommunityInput, CreateCourseInput, CreateDownloadInput, CreateSpaceInput, DmSettings, Download, DownloadAsset, DownloadFile, DownloadView, ListBundlesQuery, ListCommunitiesQuery, ListCoursesQuery, ListDownloadsQuery, Module, PatchDmSettingsInput, SaveActivityInput, SetSpaceTopicsInput, Space, SpaceDetail, UpdateBundleInput, UpdateCommunityInput, UpdateCourseInput, UpdateDownloadInput, UpdateSpaceInput } from "../types/schemas/content.js";
+import { Activity, ActivityAsset, ActivityView, AddDownloadAssetInput, AddEventAssetInput, Bundle, BundleItem, Community, CommunityView, Course, CourseSettings, CourseView, CreateBundleInput, CreateCommunityInput, CreateCourseInput, CreateDownloadInput, CreateEventInput, CreateSpaceInput, DigestSchedule, DmSettings, Download, DownloadAsset, DownloadFile, DownloadView, Event, EventAsset, EventFile, EventLead, EventSettings, EventStatus, EventView, ListBundlesQuery, ListCommunitiesQuery, ListCoursesQuery, ListDownloadsQuery, ListEventsQuery, Module, PatchCommunitySettingsInput, SaveActivityInput, SetSpaceTopicsInput, Space, SpaceDetail, UpdateBundleInput, UpdateCommunityInput, UpdateCourseInput, UpdateDownloadInput, UpdateEventInput, UpdateSpaceInput } from "../types/schemas/content.js";
+import { SubjectRef } from "../types/notifications.js";
+import "../types/index.js";
+import { Actor } from "../shared/actor.js";
 import { OutboxAppender, UnitOfWork } from "../shared/ports.js";
 import "./model.js";
 import "./types.js";
-import { Actor } from "../shared/actor.js";
 //#region src/content/ports.d.ts
-interface ContentService extends DownloadablesService, CourseManagementService, CommunitiesService {}
+interface ContentService extends DownloadablesService, CourseManagementService, BundlesService, CommunitiesService, EventsService {}
+interface ItemTitle {
+  title: string;
+  excerpt?: string;
+}
+interface ItemTitles {
+  titlesFor(refs: SubjectRef[], actor: Actor): Promise<Record<string, ItemTitle>>;
+}
+interface ItemTitleAccess {
+  hasAccess(orgId: string, orgUserId: string, contentId: string): Promise<boolean>;
+  isCommunityMember(communityId: string, actor: Actor): Promise<boolean>;
+  canOpenSpace(spaceId: string, actor: Actor): Promise<boolean>;
+}
+interface LibraryAssetRef {
+  id: string;
+  contentId: string | null;
+}
+interface ContentAssetReader {
+  libraryAssetsFor(orgId: string, assetIds: string[]): Promise<LibraryAssetRef[]>;
+}
 interface CommunityReader {
-  getSpace(orgId: string, spaceId: string): Promise<SpaceDetail | null>;
-  listSpaces(orgId: string, communityId: string): Promise<SpaceDetail[]>;
-  getDmSettings(orgId: string, communityId: string): Promise<DmSettings | null>;
+  getSpace(spaceId: string, actor: Actor): Promise<SpaceDetail | null>;
+  listSpaces(communityId: string, actor: Actor): Promise<SpaceDetail[]>;
+  getDmSettings(communityId: string, actor: Actor): Promise<DmSettings | null>;
 }
 interface SpaceRowLock {
   lockSpace(orgId: string, spaceId: string): Promise<Space | null>;
 }
+interface CommunityDigest {
+  orgId: string;
+  communityId: string;
+  digest: DigestSchedule;
+}
 interface CommunitiesService extends CommunityReader {
-  listCommunities(orgId: string, query: ListCommunitiesQuery): Promise<Page<CommunityView>>;
-  getCommunity(orgId: string, id: string): Promise<CommunityView | null>;
-  listPublishedCommunityIds(orgId: string): Promise<string[]>;
-  listCommunitiesById(orgId: string, ids: string[]): Promise<Community[]>;
-  getCommunitySpace(orgId: string, communityId: string, spaceId: string): Promise<SpaceDetail | null>;
-  createCommunity(orgId: string, input: CreateCommunityInput, actor: Actor): Promise<CommunityView>;
-  updateCommunity(orgId: string, id: string, patch: UpdateCommunityInput, actor: Actor): Promise<CommunityView>;
-  publishCommunity(orgId: string, id: string, actor: Actor): Promise<CommunityView>;
-  unpublishCommunity(orgId: string, id: string, actor: Actor): Promise<CommunityView>;
-  deleteCommunity(orgId: string, id: string, actor: Actor): Promise<void>;
-  patchDmSettings(orgId: string, id: string, patch: PatchDmSettingsInput, actor: Actor): Promise<CommunityView>;
-  createSpace(orgId: string, communityId: string, input: CreateSpaceInput, actor: Actor): Promise<SpaceDetail>;
-  updateSpace(orgId: string, communityId: string, spaceId: string, patch: UpdateSpaceInput, actor: Actor): Promise<SpaceDetail>;
-  deleteSpace(orgId: string, communityId: string, spaceId: string, actor: Actor): Promise<void>;
-  reorderSpaces(orgId: string, communityId: string, orderedIds: string[], actor: Actor): Promise<SpaceDetail[]>;
-  setSpaceTopics(orgId: string, communityId: string, spaceId: string, input: SetSpaceTopicsInput, actor: Actor): Promise<SpaceDetail>;
-  addSpaceLink(orgId: string, communityId: string, spaceId: string, contentId: string, actor: Actor): Promise<SpaceDetail>;
-  removeSpaceLink(orgId: string, communityId: string, spaceId: string, linkId: string, actor: Actor): Promise<SpaceDetail>;
-  reorderSpaceLinks(orgId: string, communityId: string, spaceId: string, orderedIds: string[], actor: Actor): Promise<SpaceDetail>;
+  listCommunities(query: ListCommunitiesQuery, actor: Actor): Promise<Page<CommunityView>>;
+  getCommunity(id: string, actor: Actor): Promise<CommunityView>;
+  findCommunity(id: string, actor: Actor): Promise<CommunityView | null>;
+  communitiesWithDigest(): Promise<CommunityDigest[]>;
+  listCommunitiesById(ids: string[], actor: Actor): Promise<Community[]>;
+  getCommunitySpace(communityId: string, spaceId: string, actor: Actor): Promise<SpaceDetail>;
+  createCommunity(input: CreateCommunityInput, actor: Actor): Promise<CommunityView>;
+  updateCommunity(id: string, patch: UpdateCommunityInput, actor: Actor): Promise<CommunityView>;
+  publishCommunity(id: string, actor: Actor): Promise<CommunityView>;
+  unpublishCommunity(id: string, actor: Actor): Promise<CommunityView>;
+  deleteCommunity(id: string, actor: Actor): Promise<void>;
+  patchCommunitySettings(id: string, patch: PatchCommunitySettingsInput, actor: Actor): Promise<CommunityView>;
+  createSpace(communityId: string, input: CreateSpaceInput, actor: Actor): Promise<SpaceDetail>;
+  updateSpace(communityId: string, spaceId: string, patch: UpdateSpaceInput, actor: Actor): Promise<SpaceDetail>;
+  deleteSpace(communityId: string, spaceId: string, actor: Actor): Promise<void>;
+  reorderSpaces(communityId: string, orderedIds: string[], actor: Actor): Promise<SpaceDetail[]>;
+  setSpaceTopics(communityId: string, spaceId: string, input: SetSpaceTopicsInput, actor: Actor): Promise<SpaceDetail>;
+  addSpaceLink(communityId: string, spaceId: string, contentId: string, actor: Actor): Promise<SpaceDetail>;
+  removeSpaceLink(communityId: string, spaceId: string, linkId: string, actor: Actor): Promise<SpaceDetail>;
+  reorderSpaceLinks(communityId: string, spaceId: string, orderedIds: string[], actor: Actor): Promise<SpaceDetail>;
 }
 interface CourseManagementService {
-  listCourses(orgId: string, query: ListCoursesQuery): Promise<Page<CourseView>>;
-  getCourse(orgId: string, id: string): Promise<CourseView | null>;
-  createCourse(orgId: string, input: CreateCourseInput): Promise<CourseView>;
+  listCourses(query: ListCoursesQuery, actor: Actor): Promise<Page<CourseView>>;
+  getCourse(id: string, actor: Actor): Promise<CourseView>;
+  findCourse(id: string, actor: Actor): Promise<CourseView | null>;
+  createCourse(input: CreateCourseInput, actor: Actor): Promise<CourseView>;
   /** @throws NotFoundError when no course with this id exists in the org. */
-  updateCourse(orgId: string, id: string, patch: UpdateCourseInput): Promise<CourseView>;
+  updateCourse(id: string, patch: UpdateCourseInput, actor: Actor): Promise<CourseView>;
   /** @throws NotFoundError when no course with this id exists in the org. */
-  patchCourseSettings(orgId: string, id: string, value: Partial<CourseSettings>): Promise<CourseSettings>;
+  patchCourseSettings(id: string, value: Partial<CourseSettings>, actor: Actor): Promise<CourseSettings>;
   /** @throws NotFoundError when no course with this id exists in the org. */
-  deleteCourse(orgId: string, id: string, actor: Actor): Promise<void>;
-  listCourseModules(orgId: string, courseId: string): Promise<Module[]>;
-  listCourseActivities(orgId: string, courseId: string): Promise<Activity[]>;
-  listCourseActivityViews(orgId: string, courseId: string): Promise<ActivityView[]>;
-  listCourseActivityAssets(orgId: string, courseId: string): Promise<ActivityAsset[]>;
-  getActivity(orgId: string, activityId: string): Promise<Activity | null>;
-  getModule(orgId: string, moduleId: string): Promise<Module | null>;
-  reorderModules(orgId: string, courseId: string, orderedIds: string[]): Promise<Module[]>;
-  createModule(orgId: string, courseId: string, title: string): Promise<Module[]>;
+  deleteCourse(id: string, actor: Actor): Promise<void>;
+  listCourseModules(courseId: string, actor: Actor): Promise<Module[]>;
+  listCourseActivities(courseId: string, actor: Actor): Promise<Activity[]>;
+  listCourseActivityViews(courseId: string, actor: Actor): Promise<ActivityView[]>;
+  listCourseActivityAssets(courseId: string, actor: Actor): Promise<ActivityAsset[]>;
+  getActivity(activityId: string, actor: Actor): Promise<Activity | null>;
+  getModule(moduleId: string, actor: Actor): Promise<Module | null>;
+  reorderModules(courseId: string, orderedIds: string[], actor: Actor): Promise<Module[]>;
+  createModule(courseId: string, title: string, actor: Actor): Promise<Module[]>;
   /** @throws NotFoundError when no such module exists in this course. */
-  updateModule(orgId: string, courseId: string, moduleId: string, title: string): Promise<Module[]>;
+  updateModule(courseId: string, moduleId: string, title: string, actor: Actor): Promise<Module[]>;
   /** @throws NotFoundError when no such module exists in this course. */
-  deleteModule(orgId: string, courseId: string, moduleId: string): Promise<Module[]>;
+  deleteModule(courseId: string, moduleId: string, actor: Actor): Promise<Module[]>;
   /** @throws NotFoundError when no such module exists in this course. */
-  reorderActivities(orgId: string, courseId: string, moduleId: string, orderedIds: string[]): Promise<Module[]>;
+  reorderActivities(courseId: string, moduleId: string, orderedIds: string[], actor: Actor): Promise<Module[]>;
   /** @throws NotFoundError when the module — or, on update, the activity — does not exist. */
-  saveActivity(orgId: string, courseId: string, moduleId: string, input: SaveActivityInput, activityId?: string): Promise<Module[]>;
+  saveActivity(courseId: string, moduleId: string, input: SaveActivityInput, activityId: string | null, actor: Actor): Promise<Module[]>;
   /** @throws NotFoundError when no such activity exists in this module. */
-  deleteActivity(orgId: string, courseId: string, moduleId: string, activityId: string): Promise<Module[]>;
+  deleteActivity(courseId: string, moduleId: string, activityId: string, actor: Actor): Promise<Module[]>;
 }
 interface DownloadablesService {
-  listDownloads(orgId: string, query: ListDownloadsQuery): Promise<Page<DownloadView>>;
-  getDownload(orgId: string, id: string): Promise<DownloadView | null>;
-  createDownload(orgId: string, input: CreateDownloadInput): Promise<DownloadView>;
+  listDownloads(query: ListDownloadsQuery, actor: Actor): Promise<Page<DownloadView>>;
+  getDownload(id: string, actor: Actor): Promise<DownloadView>;
+  findDownload(id: string, actor: Actor): Promise<DownloadView | null>;
+  createDownload(input: CreateDownloadInput, actor: Actor): Promise<DownloadView>;
   /** @throws NotFoundError when no download with this id exists in the org. */
-  updateDownload(orgId: string, id: string, patch: UpdateDownloadInput): Promise<DownloadView>;
+  updateDownload(id: string, patch: UpdateDownloadInput, actor: Actor): Promise<DownloadView>;
   /** @throws NotFoundError when no download with this id exists in the org. */
-  removeDownload(orgId: string, id: string, actor: Actor): Promise<void>;
-  listDownloadAssets(orgId: string, downloadId: string): Promise<DownloadFile[]>;
-  addDownloadAsset(orgId: string, downloadId: string, input: AddDownloadAssetInput): Promise<DownloadFile[]>;
-  removeDownloadAsset(orgId: string, downloadId: string, assetId: string): Promise<DownloadFile[]>;
-  renameDownloadAsset(orgId: string, downloadId: string, assetId: string, displayName: string | null): Promise<DownloadFile[]>;
+  removeDownload(id: string, actor: Actor): Promise<void>;
+  listDownloadAssets(downloadId: string, actor: Actor): Promise<DownloadFile[]>;
+  addDownloadAsset(downloadId: string, input: AddDownloadAssetInput, actor: Actor): Promise<DownloadFile[]>;
+  removeDownloadAsset(downloadId: string, assetId: string, actor: Actor): Promise<DownloadFile[]>;
+  renameDownloadAsset(downloadId: string, assetId: string, displayName: string | null, actor: Actor): Promise<DownloadFile[]>;
   /** @throws ConflictError when assetIds is not exactly the download's current asset set. */
-  reorderDownloadAssets(orgId: string, downloadId: string, assetIds: string[]): Promise<DownloadFile[]>;
+  reorderDownloadAssets(downloadId: string, assetIds: string[], actor: Actor): Promise<DownloadFile[]>;
+}
+interface EventsService {
+  listEvents(query: ListEventsQuery, actor: Actor): Promise<Page<EventView>>;
+  getEvent(id: string, actor: Actor): Promise<EventView>;
+  findEvent(id: string, actor: Actor): Promise<EventView | null>;
+  findEvents(ids: string[], actor: Actor): Promise<EventView[]>;
+  createEvent(input: CreateEventInput, actor: Actor): Promise<EventView>;
+  updateEvent(id: string, patch: UpdateEventInput, actor: Actor): Promise<EventView>;
+  cancelEvent(id: string, actor: Actor): Promise<EventView>;
+  deleteEvent(id: string, actor: Actor): Promise<void>;
+  startingSoon(orgId: string, eventId: string, lead: EventLead, now: Date): Promise<void>;
+  listEventAssets(eventId: string, actor: Actor): Promise<EventFile[]>;
+  eventFilesFor(eventIds: string[], actor: Actor): Promise<Record<string, EventFile[]>>;
+  addEventAsset(eventId: string, input: AddEventAssetInput, actor: Actor): Promise<EventFile[]>;
+  removeEventAsset(eventId: string, assetId: string, actor: Actor): Promise<EventFile[]>;
+  renameEventAsset(eventId: string, assetId: string, displayName: string | null, actor: Actor): Promise<EventFile[]>;
+  reorderEventAssets(eventId: string, assetIds: string[], actor: Actor): Promise<EventFile[]>;
 }
+type EventPatch = Omit<UpdateEventInput, 'status' | 'settings'> & {
+  status?: EventStatus;
+};
 interface BundlesService {
-  listBundles(orgId: string, query: ListBundlesQuery): Promise<Page<Bundle>>;
-  getBundle(orgId: string, id: string): Promise<Bundle | null>;
+  listBundles(query: ListBundlesQuery, actor: Actor): Promise<Page<Bundle>>;
+  getBundle(id: string, actor: Actor): Promise<Bundle>;
+  findBundle(id: string, actor: Actor): Promise<Bundle | null>;
   /** Bundle and its initial items are created together, or not at all.
    *  @throws NotFoundError when an initial content id does not exist in the org. */
-  createBundle(orgId: string, input: CreateBundleInput): Promise<Bundle>;
+  createBundle(input: CreateBundleInput, actor: Actor): Promise<Bundle>;
   /** @throws NotFoundError when no bundle with this id exists in the org. */
-  updateBundle(orgId: string, id: string, patch: UpdateBundleInput): Promise<Bundle>;
+  updateBundle(id: string, patch: UpdateBundleInput, actor: Actor): Promise<Bundle>;
   /** @throws NotFoundError when no bundle with this id exists in the org. */
-  deleteBundle(orgId: string, id: string): Promise<void>;
-  listBundleItems(orgId: string, bundleId: string): Promise<BundleItem[]>;
+  deleteBundle(id: string, actor: Actor): Promise<void>;
+  listBundleItems(bundleId: string, actor: Actor): Promise<BundleItem[]>;
   /** @throws NotFoundError when the bundle — or the content — does not exist in the org. */
-  addBundleItem(orgId: string, bundleId: string, contentId: string): Promise<BundleItem[]>;
+  addBundleItem(bundleId: string, contentId: string, actor: Actor): Promise<BundleItem[]>;
   /** @throws NotFoundError when no bundle with this id exists in the org. */
-  removeBundleItem(orgId: string, bundleId: string, contentId: string): Promise<BundleItem[]>;
+  removeBundleItem(bundleId: string, contentId: string, actor: Actor): Promise<BundleItem[]>;
 }
 interface ContentRepository {
-  listCourses(orgId: string, query: ListCoursesQuery): Promise<Page<Course>>;
+  listCourses(orgId: string, query: ListCoursesQuery, ids?: string[]): Promise<Page<Course>>;
   findCourseById(orgId: string, id: string): Promise<Course | null>;
   createCourse(orgId: string, input: CreateCourseInput, slug: string): Promise<Course>;
   updateCourse(orgId: string, id: string, patch: UpdateCourseInput): Promise<Course | null>;
@@ -117,7 +167,7 @@ interface ContentRepository {
     activity: Activity;
   }>;
   deleteActivity(orgId: string, courseId: string, moduleId: string, activityId: string): Promise<Module[]>;
-  listDownloads(orgId: string, query: ListDownloadsQuery): Promise<Page<Download>>;
+  listDownloads(orgId: string, query: ListDownloadsQuery, ids?: string[]): Promise<Page<Download>>;
   getDownload(orgId: string, id: string): Promise<Download | null>;
   createDownload(orgId: string, input: CreateDownloadInput, slug: string): Promise<Download>;
   updateDownload(orgId: string, id: string, patch: UpdateDownloadInput): Promise<Download | null>;
@@ -127,6 +177,20 @@ interface ContentRepository {
   removeDownloadAsset(orgId: string, downloadId: string, assetId: string): Promise<DownloadAsset[]>;
   renameDownloadAsset(orgId: string, downloadId: string, assetId: string, displayName: string | null): Promise<DownloadAsset[]>;
   reorderDownloadAssets(orgId: string, downloadId: string, assetIds: string[]): Promise<DownloadAsset[]>;
+  listEvents(orgId: string, query: ListEventsQuery, ids?: string[]): Promise<Page<Event>>;
+  findEventById(orgId: string, id: string): Promise<Event | null>;
+  findEventsByIds(orgId: string, ids: string[]): Promise<Event[]>;
+  createEvent(orgId: string, input: Omit<CreateEventInput, 'settings'>): Promise<Event>;
+  updateEvent(orgId: string, id: string, patch: EventPatch): Promise<Event | null>;
+  patchEventSettings(orgId: string, id: string, value: Partial<EventSettings>): Promise<EventSettings>;
+  deleteEvent(orgId: string, id: string): Promise<boolean>;
+  deleteEventSettings(orgId: string, id: string): Promise<void>;
+  listEventAssets(orgId: string, eventId: string): Promise<EventAsset[]>;
+  listEventAssetsFor(orgId: string, eventIds: string[]): Promise<EventAsset[]>;
+  addEventAsset(orgId: string, eventId: string, input: AddEventAssetInput): Promise<EventAsset[]>;
+  removeEventAsset(orgId: string, eventId: string, assetId: string): Promise<EventAsset[]>;
+  renameEventAsset(orgId: string, eventId: string, assetId: string, displayName: string | null): Promise<EventAsset[]>;
+  reorderEventAssets(orgId: string, eventId: string, assetIds: string[]): Promise<EventAsset[]>;
   listBundles(orgId: string, query: ListBundlesQuery): Promise<Page<Bundle>>;
   findBundleById(orgId: string, id: string): Promise<Bundle | null>;
   createBundle(orgId: string, input: CreateBundleInput): Promise<Bundle>;
@@ -136,13 +200,13 @@ interface ContentRepository {
   /** Content already in the bundle is left as it is — adding twice is a no-op. */
   addBundleItem(orgId: string, bundleId: string, contentId: string): Promise<BundleItem[]>;
   removeBundleItem(orgId: string, bundleId: string, contentId: string): Promise<BundleItem[]>;
-  listCommunities(orgId: string, query: ListCommunitiesQuery): Promise<Page<Community>>;
+  listCommunities(orgId: string, query: ListCommunitiesQuery, ids?: string[]): Promise<Page<Community>>;
   findCommunityById(orgId: string, id: string): Promise<Community | null>;
   findCommunitiesByIds(orgId: string, ids: string[]): Promise<Community[]>;
-  listPublishedCommunityIds(orgId: string): Promise<string[]>;
+  communitiesWithDigest(): Promise<CommunityDigest[]>;
   createCommunity(orgId: string, input: CreateCommunityInput, slug: string): Promise<Community>;
   updateCommunity(orgId: string, id: string, patch: UpdateCommunityInput): Promise<Community | null>;
-  patchDmSettings(orgId: string, id: string, patch: PatchDmSettingsInput): Promise<Community | null>;
+  patchCommunitySettings(orgId: string, id: string, patch: PatchCommunitySettingsInput): Promise<Community | null>;
   deleteCommunity(orgId: string, id: string): Promise<boolean>;
   deleteCommunitySettings(orgId: string, id: string): Promise<void>;
   listSpaces(orgId: string, communityId: string): Promise<SpaceDetail[]>;
@@ -165,5 +229,5 @@ interface ContentTxScope {
 }
 type ContentUnitOfWork = UnitOfWork<ContentTxScope>;
 //#endregion
-export { BundlesService, CommunitiesService, CommunityReader, ContentRepository, ContentService, ContentTxScope, ContentUnitOfWork, CourseManagementService, DownloadablesService, SpaceRowLock };
+export { BundlesService, CommunitiesService, CommunityDigest, CommunityReader, ContentAssetReader, ContentRepository, ContentService, ContentTxScope, ContentUnitOfWork, CourseManagementService, DownloadablesService, EventPatch, EventsService, ItemTitle, ItemTitleAccess, ItemTitles, LibraryAssetRef, SpaceRowLock };
 //# sourceMappingURL=ports.d.ts.map

package/dist/content/service.d.ts

@@ -1,98 +1,130 @@
 import { Page } from "../types/shared.js";
 import { Logger } from "../types/ports.js";
-import { Activity, ActivityAsset, ActivityView, AddDownloadAssetInput, Bundle, BundleItem, Community, CommunityView, CourseSettings, CourseView, CreateBundleInput, CreateCommunityInput, CreateCourseInput, CreateDownloadInput, CreateSpaceInput, DmSettings, DownloadFile, DownloadView, ListBundlesQuery, ListCommunitiesQuery, ListCoursesQuery, ListDownloadsQuery, Module, PatchDmSettingsInput, SaveActivityInput, SetSpaceTopicsInput, SpaceDetail, UpdateBundleInput, UpdateCommunityInput, UpdateCourseInput, UpdateDownloadInput, UpdateSpaceInput } from "../types/schemas/content.js";
-import "../shared/ports.js";
+import { Activity, ActivityAsset, ActivityView, AddDownloadAssetInput, AddEventAssetInput, Bundle, BundleItem, Community, CommunityView, CourseSettings, CourseView, CreateBundleInput, CreateCommunityInput, CreateCourseInput, CreateDownloadInput, CreateEventInput, CreateSpaceInput, DmSettings, DownloadFile, DownloadView, EventFile, EventLead, EventView, ListBundlesQuery, ListCommunitiesQuery, ListCoursesQuery, ListDownloadsQuery, ListEventsQuery, Module, PatchCommunitySettingsInput, SaveActivityInput, SetSpaceTopicsInput, SpaceDetail, UpdateBundleInput, UpdateCommunityInput, UpdateCourseInput, UpdateDownloadInput, UpdateEventInput, UpdateSpaceInput } from "../types/schemas/content.js";
+import { Actor } from "../shared/actor.js";
+import { Scheduler } from "../shared/ports.js";
 import { FileUrls } from "../assets/file-urls.js";
-import { AssetFiles, LibraryAssetReader } from "../assets/ports.js";
+import { AssetFiles } from "../assets/ports.js";
 import "../assets/index.js";
 import "./model.js";
 import "./types.js";
-import { Actor } from "../shared/actor.js";
-import { BundlesService, CommunitiesService, ContentRepository, ContentUnitOfWork, CourseManagementService, DownloadablesService } from "./ports.js";
+import { BundlesService, CommunitiesService, CommunityDigest, ContentAssetReader, ContentRepository, ContentUnitOfWork, CourseManagementService, DownloadablesService, EventsService } from "./ports.js";
 //#region src/content/service.d.ts
 type ContentServiceParams = {
   repo: ContentRepository;
   uow: ContentUnitOfWork;
-  libraryAssets: LibraryAssetReader;
-  files: Pick<AssetFiles, 'readyFiles'>;
+  libraryAssets: ContentAssetReader;
+  files: Pick<AssetFiles, 'readyFiles' | 'syncPublicImage'>;
   fileUrls: FileUrls;
+  scheduler: Pick<Scheduler, 'at' | 'cancel'>;
   logger?: Logger;
 };
-declare class ContentService implements CourseManagementService, DownloadablesService, BundlesService, CommunitiesService {
+declare class ContentService implements CourseManagementService, DownloadablesService, BundlesService, CommunitiesService, EventsService {
   private readonly repo;
   private readonly uow;
   private readonly libraryAssets;
   private readonly files;
   private readonly fileUrls;
+  private readonly scheduler;
   private readonly logger;
   constructor(params: ContentServiceParams);
+  private require;
+  private requireAny;
+  private visibleIds;
   private withThumbnail;
+  private syncThumbnail;
+  private withdrawThumbnail;
   private pageWithThumbnails;
   private downloadFiles;
-  listCourses(orgId: string, query: ListCoursesQuery): Promise<Page<CourseView>>;
-  getCourse(orgId: string, id: string): Promise<CourseView | null>;
-  createCourse(orgId: string, input: CreateCourseInput): Promise<CourseView>;
-  updateCourse(orgId: string, id: string, patch: UpdateCourseInput): Promise<CourseView>;
-  patchCourseSettings(orgId: string, id: string, value: Partial<CourseSettings>): Promise<CourseSettings>;
-  deleteCourse(orgId: string, id: string, actor: Actor): Promise<void>;
-  listCourseModules(orgId: string, courseId: string): Promise<Module[]>;
-  listCourseActivities(orgId: string, courseId: string): Promise<Activity[]>;
-  listCourseActivityViews(orgId: string, courseId: string): Promise<ActivityView[]>;
-  listCourseActivityAssets(orgId: string, courseId: string): Promise<ActivityAsset[]>;
-  getActivity(orgId: string, activityId: string): Promise<Activity | null>;
-  getModule(orgId: string, moduleId: string): Promise<Module | null>;
-  reorderModules(orgId: string, courseId: string, orderedIds: string[]): Promise<Module[]>;
-  createModule(orgId: string, courseId: string, title: string): Promise<Module[]>;
-  updateModule(orgId: string, courseId: string, moduleId: string, title: string): Promise<Module[]>;
-  deleteModule(orgId: string, courseId: string, moduleId: string): Promise<Module[]>;
-  reorderActivities(orgId: string, courseId: string, moduleId: string, orderedIds: string[]): Promise<Module[]>;
-  private assertLibraryAssets;
-  saveActivity(orgId: string, courseId: string, moduleId: string, input: SaveActivityInput, activityId?: string): Promise<Module[]>;
-  deleteActivity(orgId: string, courseId: string, moduleId: string, activityId: string): Promise<Module[]>;
-  listDownloads(orgId: string, query: ListDownloadsQuery): Promise<Page<DownloadView>>;
-  getDownload(orgId: string, id: string): Promise<DownloadView | null>;
-  createDownload(orgId: string, input: CreateDownloadInput): Promise<DownloadView>;
-  updateDownload(orgId: string, id: string, patch: UpdateDownloadInput): Promise<DownloadView>;
-  removeDownload(orgId: string, id: string, actor: Actor): Promise<void>;
-  listDownloadAssets(orgId: string, downloadId: string): Promise<DownloadFile[]>;
-  addDownloadAsset(orgId: string, downloadId: string, input: AddDownloadAssetInput): Promise<DownloadFile[]>;
-  removeDownloadAsset(orgId: string, downloadId: string, assetId: string): Promise<DownloadFile[]>;
-  renameDownloadAsset(orgId: string, downloadId: string, assetId: string, displayName: string | null): Promise<DownloadFile[]>;
+  private eventFiles;
+  private assertAttachable;
+  private courseAssetIds;
+  private downloadAssetIds;
+  private eventAssetIds;
+  listCourses(query: ListCoursesQuery, actor: Actor): Promise<Page<CourseView>>;
+  getCourse(id: string, actor: Actor): Promise<CourseView>;
+  findCourse(id: string, actor: Actor): Promise<CourseView | null>;
+  createCourse(input: CreateCourseInput, actor: Actor): Promise<CourseView>;
+  updateCourse(id: string, patch: UpdateCourseInput, actor: Actor): Promise<CourseView>;
+  patchCourseSettings(id: string, value: Partial<CourseSettings>, actor: Actor): Promise<CourseSettings>;
+  deleteCourse(id: string, actor: Actor): Promise<void>;
+  listCourseModules(courseId: string, actor: Actor): Promise<Module[]>;
+  listCourseActivities(courseId: string, actor: Actor): Promise<Activity[]>;
+  listCourseActivityViews(courseId: string, actor: Actor): Promise<ActivityView[]>;
+  listCourseActivityAssets(courseId: string, actor: Actor): Promise<ActivityAsset[]>;
+  getActivity(activityId: string, actor: Actor): Promise<Activity | null>;
+  getModule(moduleId: string, actor: Actor): Promise<Module | null>;
+  reorderModules(courseId: string, orderedIds: string[], actor: Actor): Promise<Module[]>;
+  createModule(courseId: string, title: string, actor: Actor): Promise<Module[]>;
+  updateModule(courseId: string, moduleId: string, title: string, actor: Actor): Promise<Module[]>;
+  deleteModule(courseId: string, moduleId: string, actor: Actor): Promise<Module[]>;
+  reorderActivities(courseId: string, moduleId: string, orderedIds: string[], actor: Actor): Promise<Module[]>;
+  saveActivity(courseId: string, moduleId: string, input: SaveActivityInput, activityId: string | null, actor: Actor): Promise<Module[]>;
+  deleteActivity(courseId: string, moduleId: string, activityId: string, actor: Actor): Promise<Module[]>;
+  listDownloads(query: ListDownloadsQuery, actor: Actor): Promise<Page<DownloadView>>;
+  getDownload(id: string, actor: Actor): Promise<DownloadView>;
+  findDownload(id: string, actor: Actor): Promise<DownloadView | null>;
+  createDownload(input: CreateDownloadInput, actor: Actor): Promise<DownloadView>;
+  updateDownload(id: string, patch: UpdateDownloadInput, actor: Actor): Promise<DownloadView>;
+  removeDownload(id: string, actor: Actor): Promise<void>;
+  listDownloadAssets(downloadId: string, actor: Actor): Promise<DownloadFile[]>;
+  addDownloadAsset(downloadId: string, input: AddDownloadAssetInput, actor: Actor): Promise<DownloadFile[]>;
+  removeDownloadAsset(downloadId: string, assetId: string, actor: Actor): Promise<DownloadFile[]>;
+  renameDownloadAsset(downloadId: string, assetId: string, displayName: string | null, actor: Actor): Promise<DownloadFile[]>;
   /** The caller must send the COMPLETE ordered set — a partial list would
    *  silently unlink whatever it omitted. */
-  reorderDownloadAssets(orgId: string, downloadId: string, assetIds: string[]): Promise<DownloadFile[]>;
-  listBundles(orgId: string, query: ListBundlesQuery): Promise<Page<Bundle>>;
-  getBundle(orgId: string, id: string): Promise<Bundle | null>;
-  createBundle(orgId: string, input: CreateBundleInput): Promise<Bundle>;
-  updateBundle(orgId: string, id: string, patch: UpdateBundleInput): Promise<Bundle>;
-  deleteBundle(orgId: string, id: string): Promise<void>;
-  listBundleItems(orgId: string, bundleId: string): Promise<BundleItem[]>;
-  addBundleItem(orgId: string, bundleId: string, contentId: string): Promise<BundleItem[]>;
-  removeBundleItem(orgId: string, bundleId: string, contentId: string): Promise<BundleItem[]>;
+  reorderDownloadAssets(downloadId: string, assetIds: string[], actor: Actor): Promise<DownloadFile[]>;
+  listEvents(query: ListEventsQuery, actor: Actor): Promise<Page<EventView>>;
+  getEvent(id: string, actor: Actor): Promise<EventView>;
+  findEvent(id: string, actor: Actor): Promise<EventView | null>;
+  findEvents(ids: string[], actor: Actor): Promise<EventView[]>;
+  createEvent(input: CreateEventInput, actor: Actor): Promise<EventView>;
+  updateEvent(id: string, patch: UpdateEventInput, actor: Actor): Promise<EventView>;
+  cancelEvent(id: string, actor: Actor): Promise<EventView>;
+  deleteEvent(id: string, actor: Actor): Promise<void>;
+  startingSoon(orgId: string, eventId: string, lead: EventLead, now: Date): Promise<void>;
+  private scheduleStartingSoon;
+  private cancelStartingSoon;
+  listEventAssets(eventId: string, actor: Actor): Promise<EventFile[]>;
+  eventFilesFor(eventIds: string[], actor: Actor): Promise<Record<string, EventFile[]>>;
+  addEventAsset(eventId: string, input: AddEventAssetInput, actor: Actor): Promise<EventFile[]>;
+  removeEventAsset(eventId: string, assetId: string, actor: Actor): Promise<EventFile[]>;
+  renameEventAsset(eventId: string, assetId: string, displayName: string | null, actor: Actor): Promise<EventFile[]>;
+  reorderEventAssets(eventId: string, assetIds: string[], actor: Actor): Promise<EventFile[]>;
+  listBundles(query: ListBundlesQuery, actor: Actor): Promise<Page<Bundle>>;
+  getBundle(id: string, actor: Actor): Promise<Bundle>;
+  findBundle(id: string, actor: Actor): Promise<Bundle | null>;
+  createBundle(input: CreateBundleInput, actor: Actor): Promise<Bundle>;
+  updateBundle(id: string, patch: UpdateBundleInput, actor: Actor): Promise<Bundle>;
+  deleteBundle(id: string, actor: Actor): Promise<void>;
+  listBundleItems(bundleId: string, actor: Actor): Promise<BundleItem[]>;
+  addBundleItem(bundleId: string, contentId: string, actor: Actor): Promise<BundleItem[]>;
+  removeBundleItem(bundleId: string, contentId: string, actor: Actor): Promise<BundleItem[]>;
   private spaceUpdates;
   private resolvedSpace;
-  listCommunities(orgId: string, query: ListCommunitiesQuery): Promise<Page<CommunityView>>;
-  getCommunity(orgId: string, id: string): Promise<CommunityView | null>;
-  listPublishedCommunityIds(orgId: string): Promise<string[]>;
-  listCommunitiesById(orgId: string, ids: string[]): Promise<Community[]>;
-  getSpace(orgId: string, spaceId: string): Promise<SpaceDetail | null>;
-  getCommunitySpace(orgId: string, communityId: string, spaceId: string): Promise<SpaceDetail | null>;
-  listSpaces(orgId: string, communityId: string): Promise<SpaceDetail[]>;
-  getDmSettings(orgId: string, communityId: string): Promise<DmSettings | null>;
-  createCommunity(orgId: string, input: CreateCommunityInput, actor: Actor): Promise<CommunityView>;
-  updateCommunity(orgId: string, id: string, patch: UpdateCommunityInput, actor: Actor): Promise<CommunityView>;
-  publishCommunity(orgId: string, id: string, actor: Actor): Promise<CommunityView>;
-  unpublishCommunity(orgId: string, id: string, actor: Actor): Promise<CommunityView>;
-  deleteCommunity(orgId: string, id: string, actor: Actor): Promise<void>;
-  patchDmSettings(orgId: string, id: string, patch: PatchDmSettingsInput, actor: Actor): Promise<CommunityView>;
-  createSpace(orgId: string, communityId: string, input: CreateSpaceInput, actor: Actor): Promise<SpaceDetail>;
-  updateSpace(orgId: string, communityId: string, spaceId: string, patch: UpdateSpaceInput, actor: Actor): Promise<SpaceDetail>;
-  deleteSpace(orgId: string, communityId: string, spaceId: string, actor: Actor): Promise<void>;
-  reorderSpaces(orgId: string, communityId: string, orderedIds: string[], actor: Actor): Promise<SpaceDetail[]>;
-  setSpaceTopics(orgId: string, communityId: string, spaceId: string, input: SetSpaceTopicsInput, actor: Actor): Promise<SpaceDetail>;
-  addSpaceLink(orgId: string, communityId: string, spaceId: string, contentId: string, actor: Actor): Promise<SpaceDetail>;
-  removeSpaceLink(orgId: string, communityId: string, spaceId: string, linkId: string, actor: Actor): Promise<SpaceDetail>;
-  reorderSpaceLinks(orgId: string, communityId: string, spaceId: string, orderedIds: string[], actor: Actor): Promise<SpaceDetail>;
+  listCommunities(query: ListCommunitiesQuery, actor: Actor): Promise<Page<CommunityView>>;
+  getCommunity(id: string, actor: Actor): Promise<CommunityView>;
+  findCommunity(id: string, actor: Actor): Promise<CommunityView | null>;
+  communitiesWithDigest(): Promise<CommunityDigest[]>;
+  listCommunitiesById(ids: string[], actor: Actor): Promise<Community[]>;
+  getSpace(spaceId: string, actor: Actor): Promise<SpaceDetail | null>;
+  getCommunitySpace(communityId: string, spaceId: string, actor: Actor): Promise<SpaceDetail>;
+  listSpaces(communityId: string, actor: Actor): Promise<SpaceDetail[]>;
+  getDmSettings(communityId: string, actor: Actor): Promise<DmSettings | null>;
+  createCommunity(input: CreateCommunityInput, actor: Actor): Promise<CommunityView>;
+  updateCommunity(id: string, patch: UpdateCommunityInput, actor: Actor): Promise<CommunityView>;
+  publishCommunity(id: string, actor: Actor): Promise<CommunityView>;
+  unpublishCommunity(id: string, actor: Actor): Promise<CommunityView>;
+  deleteCommunity(id: string, actor: Actor): Promise<void>;
+  patchCommunitySettings(id: string, patch: PatchCommunitySettingsInput, actor: Actor): Promise<CommunityView>;
+  createSpace(communityId: string, input: CreateSpaceInput, actor: Actor): Promise<SpaceDetail>;
+  updateSpace(communityId: string, spaceId: string, patch: UpdateSpaceInput, actor: Actor): Promise<SpaceDetail>;
+  deleteSpace(communityId: string, spaceId: string, actor: Actor): Promise<void>;
+  reorderSpaces(communityId: string, orderedIds: string[], actor: Actor): Promise<SpaceDetail[]>;
+  setSpaceTopics(communityId: string, spaceId: string, input: SetSpaceTopicsInput, actor: Actor): Promise<SpaceDetail>;
+  addSpaceLink(communityId: string, spaceId: string, contentId: string, actor: Actor): Promise<SpaceDetail>;
+  removeSpaceLink(communityId: string, spaceId: string, linkId: string, actor: Actor): Promise<SpaceDetail>;
+  reorderSpaceLinks(communityId: string, spaceId: string, orderedIds: string[], actor: Actor): Promise<SpaceDetail>;
 }
 //#endregion
 export { ContentService, ContentServiceParams };