@headless-lms/core 0.3.0 → 0.4.0

package/dist/identity/notification-settings.js

@@ -0,0 +1,113 @@
+import { NotFoundError, ValidationError } from "../shared/errors.js";
+import { noopLogger } from "../shared/logger.js";
+//#region src/identity/notification-settings.ts
+function communityOf(scope) {
+	return scope === "org" ? null : scope.communityId;
+}
+function keyOf(key) {
+	return JSON.stringify([
+		key.communityId,
+		key.spaceId,
+		key.category,
+		key.channel
+	]);
+}
+var NotificationSettingsServiceImpl = class {
+	repo;
+	categories;
+	access;
+	channels;
+	logger;
+	constructor(params) {
+		this.repo = params.repo;
+		this.categories = params.categories;
+		this.access = params.access;
+		this.channels = params.channels;
+		this.logger = params.logger ?? noopLogger;
+	}
+	async get(orgId, userId, scope) {
+		return (await this.repo.forUsers(orgId, [userId], communityOf(scope), null)).map(({ userId: _userId, ...setting }) => setting);
+	}
+	async getMany(orgId, userIds, scope, categories) {
+		const unique = [...new Set(userIds)];
+		const result = Object.fromEntries(unique.map((userId) => [userId, []]));
+		if (unique.length === 0 || categories.length === 0) return result;
+		const rows = await this.repo.forUsers(orgId, unique, communityOf(scope), categories);
+		for (const { userId, ...setting } of rows) result[userId]?.push(setting);
+		return result;
+	}
+	async set(orgId, actor, scope, changes) {
+		const communityId = communityOf(scope);
+		let list;
+		if (communityId === null) list = await this.categories.orgList(orgId);
+		else {
+			if (!await this.access.canOpen(orgId, actor, communityId)) throw new NotFoundError("Community", communityId);
+			list = await this.categories.communityList(orgId, communityId);
+		}
+		const configured = this.channels.list();
+		const problems = [];
+		const byKey = /* @__PURE__ */ new Map();
+		changes.forEach((change, index) => {
+			const at = `settings[${index}]`;
+			const category = list.find((candidate) => candidate.key === change.category);
+			if (!category) {
+				problems.push({
+					path: `${at}.category`,
+					message: `there is no category ${change.category}`
+				});
+				return;
+			}
+			const offered = category.channels[change.channel];
+			if (!offered || !configured.includes(change.channel)) {
+				problems.push({
+					path: `${at}.channel`,
+					message: `${change.category} does not offer the channel ${change.channel}`
+				});
+				return;
+			}
+			if (offered.locked) {
+				problems.push({
+					path: `${at}.channel`,
+					message: `the channel ${change.channel} of ${change.category} is locked`
+				});
+				return;
+			}
+			if (change.spaceId !== void 0 && category.perSpace !== true) {
+				problems.push({
+					path: `${at}.spaceId`,
+					message: `${change.category} cannot be set per space`
+				});
+				return;
+			}
+			const key = {
+				communityId,
+				spaceId: change.spaceId ?? null,
+				category: change.category,
+				channel: change.channel
+			};
+			byKey.set(keyOf(key), {
+				key,
+				enabled: change.enabled
+			});
+		});
+		if (problems.length > 0) throw new ValidationError(problems);
+		const entries = [...byKey.values()];
+		await this.repo.apply(orgId, actor.userId, entries.flatMap(({ key, enabled }) => enabled === null ? [] : [{
+			...key,
+			enabled
+		}]), entries.flatMap(({ key, enabled }) => enabled === null ? [key] : []), /* @__PURE__ */ new Date());
+		this.logger.info("notification settings changed", {
+			orgId,
+			userId: actor.userId,
+			communityId,
+			count: entries.length
+		});
+	}
+	switchedOn(orgId, communityId, category, spaceId) {
+		return this.repo.switchedOn(orgId, communityId, category, spaceId);
+	}
+};
+//#endregion
+export { NotificationSettingsServiceImpl };
+
+//# sourceMappingURL=notification-settings.js.map

package/dist/identity/notification-settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-settings.js","names":[],"sources":["../../src/identity/notification-settings.ts"],"sourcesContent":["import type { NotificationCategory, SettingsScope, StoredSetting } from '../types/index.js';\nimport type { ChannelRegistry, Logger } from '../shared/ports.js';\nimport { NotFoundError, ValidationError, type ValidationProblem } from '../shared/errors.js';\nimport { noopLogger } from '../shared/logger.js';\nimport type {\n  CommunityAccessReader,\n  MemberActor,\n  NotificationCategoryReader,\n  NotificationSettingsRepository,\n  NotificationSettingsService,\n  SettingChange,\n  SettingKey,\n} from './ports.js';\n\nfunction communityOf(scope: SettingsScope): string | null {\n  return scope === 'org' ? null : scope.communityId;\n}\n\nfunction keyOf(key: SettingKey): string {\n  return JSON.stringify([key.communityId, key.spaceId, key.category, key.channel]);\n}\n\nexport type NotificationSettingsServiceParams = {\n  repo: NotificationSettingsRepository;\n  categories: NotificationCategoryReader;\n  access: CommunityAccessReader;\n  channels: Pick<ChannelRegistry, 'list'>;\n  logger?: Logger;\n};\n\nexport class NotificationSettingsServiceImpl implements NotificationSettingsService {\n  private readonly repo: NotificationSettingsRepository;\n  private readonly categories: NotificationCategoryReader;\n  private readonly access: CommunityAccessReader;\n  private readonly channels: Pick<ChannelRegistry, 'list'>;\n  private readonly logger: Logger;\n\n  constructor(params: NotificationSettingsServiceParams) {\n    this.repo = params.repo;\n    this.categories = params.categories;\n    this.access = params.access;\n    this.channels = params.channels;\n    this.logger = params.logger ?? noopLogger;\n  }\n\n  async get(orgId: string, userId: string, scope: SettingsScope): Promise<StoredSetting[]> {\n    const rows = await this.repo.forUsers(orgId, [userId], communityOf(scope), null);\n    return rows.map(({ userId: _userId, ...setting }) => setting);\n  }\n\n  async getMany(\n    orgId: string,\n    userIds: string[],\n    scope: SettingsScope,\n    categories: string[],\n  ): Promise<Record<string, StoredSetting[]>> {\n    const unique = [...new Set(userIds)];\n    const result: Record<string, StoredSetting[]> = Object.fromEntries(\n      unique.map((userId) => [userId, []]),\n    );\n    if (unique.length === 0 || categories.length === 0) {\n      return result;\n    }\n    const rows = await this.repo.forUsers(orgId, unique, communityOf(scope), categories);\n    for (const { userId, ...setting } of rows) {\n      result[userId]?.push(setting);\n    }\n    return result;\n  }\n\n  async set(\n    orgId: string,\n    actor: MemberActor,\n    scope: SettingsScope,\n    changes: SettingChange[],\n  ): Promise<void> {\n    const communityId = communityOf(scope);\n    let list: NotificationCategory[];\n    if (communityId === null) {\n      list = await this.categories.orgList(orgId);\n    } else {\n      if (!(await this.access.canOpen(orgId, actor, communityId))) {\n        throw new NotFoundError('Community', communityId);\n      }\n      list = await this.categories.communityList(orgId, communityId);\n    }\n    const configured = this.channels.list();\n    const problems: ValidationProblem[] = [];\n    const byKey = new Map<string, { key: SettingKey; enabled: boolean | null }>();\n    changes.forEach((change, index) => {\n      const at = `settings[${index}]`;\n      const category = list.find((candidate) => candidate.key === change.category);\n      if (!category) {\n        problems.push({\n          path: `${at}.category`,\n          message: `there is no category ${change.category}`,\n        });\n        return;\n      }\n      const offered = category.channels[change.channel];\n      if (!offered || !configured.includes(change.channel)) {\n        problems.push({\n          path: `${at}.channel`,\n          message: `${change.category} does not offer the channel ${change.channel}`,\n        });\n        return;\n      }\n      if (offered.locked) {\n        problems.push({\n          path: `${at}.channel`,\n          message: `the channel ${change.channel} of ${change.category} is locked`,\n        });\n        return;\n      }\n      if (change.spaceId !== undefined && category.perSpace !== true) {\n        problems.push({\n          path: `${at}.spaceId`,\n          message: `${change.category} cannot be set per space`,\n        });\n        return;\n      }\n      const key: SettingKey = {\n        communityId,\n        spaceId: change.spaceId ?? null,\n        category: change.category,\n        channel: change.channel,\n      };\n      byKey.set(keyOf(key), { key, enabled: change.enabled });\n    });\n    if (problems.length > 0) {\n      throw new ValidationError(problems);\n    }\n    const entries = [...byKey.values()];\n    await this.repo.apply(\n      orgId,\n      actor.userId,\n      entries.flatMap(({ key, enabled }) => (enabled === null ? [] : [{ ...key, enabled }])),\n      entries.flatMap(({ key, enabled }) => (enabled === null ? [key] : [])),\n      new Date(),\n    );\n    this.logger.info('notification settings changed', {\n      orgId,\n      userId: actor.userId,\n      communityId,\n      count: entries.length,\n    });\n  }\n\n  switchedOn(\n    orgId: string,\n    communityId: string,\n    category: string,\n    spaceId: string | null,\n  ): Promise<string[]> {\n    return this.repo.switchedOn(orgId, communityId, category, spaceId);\n  }\n}\n"],"mappings":"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"}

package/dist/identity/ports.d.ts

@@ -1,8 +1,10 @@
 import { JsonValue } from "../types/shared.js";
-import { CreateUserInput, Notification, NotificationKind, NotificationPreference, UpdateUserInput, UserProfile, UserProfileView } from "../types/schemas/identity.js";
+import { CreateUserInput, UpdateUserInput, UserProfile, UserProfileView } from "../types/schemas/identity.js";
 import { User } from "../types/identity.js";
+import { DeviceView, NotificationCategory, PushDevice, PushProvider, SettingsScope, StoredSetting } from "../types/notifications.js";
 import "../types/index.js";
 import { OutboxAppender, UnitOfWork } from "../shared/ports.js";
+import { Actor } from "../shared/actor.js";
 import "./model.js";
 import "./types.js";
 //#region src/identity/ports.d.ts
@@ -55,44 +57,6 @@ interface SessionAdmin {
   /** Points the caller's current session at `orgId`.  */
   stampActiveOrganization(headers: AuthHeaders, orgId: string): Promise<boolean>;
 }
-interface NewNotification {
-  userId: string;
-  kind: NotificationKind;
-  actorOrgUserId: string | null;
-  communityId: string | null;
-  spaceId: string | null;
-  postId: string | null;
-  commentId: string | null;
-  chatId: string | null;
-  messageId: string | null;
-}
-interface NotificationsQuery {
-  page: number;
-  pageSize: number;
-}
-interface NotificationPage {
-  rows: Notification[];
-  total: number;
-  page: number;
-  pageSize: number;
-  unreadCount: number;
-}
-/** What automations calls to tell people. */
-interface NotificationDesk {
-  notify(orgId: string, notifications: NewNotification[]): Promise<void>;
-  preferencesFor(orgId: string, userIds: string[], kind: NotificationKind): Promise<Record<string, NotificationPreference>>;
-}
-/** A person's own notifications and preferences. */
-interface NotificationInbox {
-  listNotifications(orgId: string, userId: string, query: NotificationsQuery): Promise<NotificationPage>;
-  markNotificationRead(orgId: string, userId: string, notificationId: string): Promise<Notification>;
-  markAllNotificationsRead(orgId: string, userId: string): Promise<{
-    updated: number;
-  }>;
-  notificationPreferences(orgId: string, userId: string): Promise<NotificationPreference[]>;
-  setNotificationPreferences(orgId: string, userId: string, preferences: NotificationPreference[]): Promise<NotificationPreference[]>;
-}
-interface NotificationService extends NotificationDesk, NotificationInbox {}
 interface IdentityService extends UserProvisioner, UserResolver, UserEditor {
   profileOf(orgId: string, userId: string): Promise<UserProfileView>;
   displayName(userId: string | null): Promise<string>;
@@ -107,25 +71,85 @@ interface IdentityRepository {
   findProfile(userId: string): Promise<UserProfile | null>;
   upsertProfile(userId: string, patch: ProfilePatch): Promise<UserProfile>;
 }
-interface NotificationsRepository {
-  insert(orgId: string, rows: Notification[]): Promise<void>;
-  page(orgId: string, userId: string, query: NotificationsQuery): Promise<{
-    rows: Notification[];
-    total: number;
-    unreadCount: number;
-  }>;
-  markRead(orgId: string, userId: string, notificationId: string, at: Date): Promise<Notification | null>;
-  markAllRead(orgId: string, userId: string, at: Date): Promise<number>;
-  preferences(orgId: string, userIds: string[]): Promise<(NotificationPreference & {
-    userId: string;
-  })[]>;
-  upsertPreferences(orgId: string, userId: string, preferences: NotificationPreference[]): Promise<void>;
-}
 interface IdentityTxScope {
   identity: IdentityRepository;
   outbox: OutboxAppender;
 }
 type IdentityUnitOfWork = UnitOfWork<IdentityTxScope>;
+type MemberActor = Actor & {
+  userId: string;
+};
+interface SettingChange {
+  category: string;
+  spaceId?: string;
+  channel: string;
+  enabled: boolean | null;
+}
+interface NotificationSettingsService {
+  get(orgId: string, userId: string, scope: SettingsScope): Promise<StoredSetting[]>;
+  getMany(orgId: string, userIds: string[], scope: SettingsScope, categories: string[]): Promise<Record<string, StoredSetting[]>>;
+  set(orgId: string, actor: MemberActor, scope: SettingsScope, changes: SettingChange[]): Promise<void>;
+  switchedOn(orgId: string, communityId: string, category: string, spaceId: string | null): Promise<string[]>;
+}
+interface NotificationCategoryReader {
+  communityList(orgId: string, communityId: string): Promise<NotificationCategory[]>;
+  orgList(orgId: string): Promise<NotificationCategory[]>;
+}
+interface CommunityAccessReader {
+  canOpen(orgId: string, actor: Actor, communityId: string): Promise<boolean>;
+}
+interface SettingKey {
+  communityId: string | null;
+  spaceId: string | null;
+  category: string;
+  channel: string;
+}
+interface NotificationSettingsRepository {
+  forUsers(orgId: string, userIds: string[], communityId: string | null, categories: string[] | null): Promise<(StoredSetting & {
+    userId: string;
+  })[]>;
+  apply(orgId: string, userId: string, upserts: (SettingKey & {
+    enabled: boolean;
+  })[], deletes: SettingKey[], at: Date): Promise<void>;
+  switchedOn(orgId: string, communityId: string, category: string, spaceId: string | null): Promise<string[]>;
+}
+interface DeviceRegistration {
+  provider: PushProvider;
+  token: string;
+  keys?: {
+    p256dh: string;
+    auth: string;
+  };
+  appId?: string;
+  environment?: 'production' | 'sandbox';
+}
+interface DevicesService {
+  register(orgId: string, actor: MemberActor, input: DeviceRegistration): Promise<PushDevice>;
+  list(orgId: string, actor: MemberActor): Promise<DeviceView[]>;
+  remove(orgId: string, actor: MemberActor, deviceId: string): Promise<void>;
+  activeDevices(orgId: string, userId: string, since: Date): Promise<PushDevice[]>;
+  withActiveDevices(orgId: string, userIds: string[], since: Date): Promise<string[]>;
+  removeDead(orgId: string, deviceIds: string[]): Promise<void>;
+  pushConfig(): {
+    vapidPublicKey: string | null;
+  };
+}
+interface NewDevice {
+  userId: string;
+  provider: PushProvider;
+  token: string;
+  p256dh: string | null;
+  auth: string | null;
+  appId: string | null;
+  environment: 'production' | 'sandbox' | null;
+}
+interface DevicesRepository {
+  upsert(orgId: string, device: NewDevice, at: Date): Promise<DeviceView>;
+  listForUser(orgId: string, userId: string, since: Date | null): Promise<DeviceView[]>;
+  usersWithDevices(orgId: string, userIds: string[], since: Date): Promise<string[]>;
+  deleteOwn(orgId: string, userId: string, deviceId: string): Promise<boolean>;
+  deleteMany(orgId: string, deviceIds: string[]): Promise<void>;
+}
 //#endregion
-export { AuthHeaders, IdentityRepository, IdentityService, IdentityTxScope, IdentityUnitOfWork, NewNotification, NotificationDesk, NotificationInbox, NotificationPage, NotificationService, NotificationsQuery, NotificationsRepository, ProfilePatch, SessionAdmin, UpdateProfileInput, UserEditor, UserProvisioner, UserResolver };
+export { AuthHeaders, CommunityAccessReader, DeviceRegistration, DevicesRepository, DevicesService, IdentityRepository, IdentityService, IdentityTxScope, IdentityUnitOfWork, MemberActor, NewDevice, NotificationCategoryReader, NotificationSettingsRepository, NotificationSettingsService, ProfilePatch, SessionAdmin, SettingChange, SettingKey, UpdateProfileInput, UserEditor, UserProvisioner, UserResolver };
 //# sourceMappingURL=ports.d.ts.map

package/dist/integrations/events.d.ts

@@ -22,8 +22,8 @@ declare const integrationEvents: {
     createdAt: unknown;
     updatedAt: unknown;
   }, import("zod").ZodObject<{
-    orgId: import("zod").ZodString;
     id: import("zod").ZodString;
+    orgId: import("zod").ZodString;
     createdAt: import("zod").ZodCoercedDate<unknown>;
     updatedAt: import("zod").ZodCoercedDate<unknown>;
     active: import("zod").ZodBoolean;
@@ -49,8 +49,8 @@ declare const integrationEvents: {
     createdAt: unknown;
     updatedAt: unknown;
   }, import("zod").ZodObject<{
-    orgId: import("zod").ZodString;
     id: import("zod").ZodString;
+    orgId: import("zod").ZodString;
     createdAt: import("zod").ZodCoercedDate<unknown>;
     updatedAt: import("zod").ZodCoercedDate<unknown>;
     active: import("zod").ZodBoolean;
@@ -76,8 +76,8 @@ declare const integrationEvents: {
     createdAt: unknown;
     updatedAt: unknown;
   }, import("zod").ZodObject<{
-    orgId: import("zod").ZodString;
     id: import("zod").ZodString;
+    orgId: import("zod").ZodString;
     createdAt: import("zod").ZodCoercedDate<unknown>;
     updatedAt: import("zod").ZodCoercedDate<unknown>;
     active: import("zod").ZodBoolean;

package/dist/organizations/events.d.ts

@@ -91,15 +91,14 @@ declare const organizationEvents: {
     createdAt: unknown;
     updatedAt: unknown;
   }, import("zod").ZodObject<{
-    orgId: import("zod").ZodString;
     id: import("zod").ZodString;
+    orgId: import("zod").ZodString;
+    createdAt: import("zod").ZodCoercedDate<unknown>;
+    updatedAt: import("zod").ZodCoercedDate<unknown>;
     status: import("zod").ZodEnum<{
       active: "active";
       invited: "invited";
     }>;
-    createdAt: import("zod").ZodCoercedDate<unknown>;
-    updatedAt: import("zod").ZodCoercedDate<unknown>;
-    userId: import("zod").ZodString;
     role: import("zod").ZodEnum<{
       owner: "owner";
       admin: "admin";
@@ -107,6 +106,7 @@ declare const organizationEvents: {
       moderator: "moderator";
       student: "student";
     }>;
+    userId: import("zod").ZodString;
   }, import("zod/v4/core").$strip>>;
   orgUserDeleted: RuntimeEventDefinition<VersionedDomainEvent<{
     id: string;
@@ -125,15 +125,14 @@ declare const organizationEvents: {
     createdAt: unknown;
     updatedAt: unknown;
   }, import("zod").ZodObject<{
-    orgId: import("zod").ZodString;
     id: import("zod").ZodString;
+    orgId: import("zod").ZodString;
+    createdAt: import("zod").ZodCoercedDate<unknown>;
+    updatedAt: import("zod").ZodCoercedDate<unknown>;
     status: import("zod").ZodEnum<{
       active: "active";
       invited: "invited";
     }>;
-    createdAt: import("zod").ZodCoercedDate<unknown>;
-    updatedAt: import("zod").ZodCoercedDate<unknown>;
-    userId: import("zod").ZodString;
     role: import("zod").ZodEnum<{
       owner: "owner";
       admin: "admin";
@@ -141,6 +140,7 @@ declare const organizationEvents: {
       moderator: "moderator";
       student: "student";
     }>;
+    userId: import("zod").ZodString;
   }, import("zod/v4/core").$strip>>;
   orgUserUpdated: RuntimeEventDefinition<VersionedDomainEvent<{
     id: string;
@@ -159,15 +159,14 @@ declare const organizationEvents: {
     createdAt: unknown;
     updatedAt: unknown;
   }, import("zod").ZodObject<{
-    orgId: import("zod").ZodString;
     id: import("zod").ZodString;
+    orgId: import("zod").ZodString;
+    createdAt: import("zod").ZodCoercedDate<unknown>;
+    updatedAt: import("zod").ZodCoercedDate<unknown>;
     status: import("zod").ZodEnum<{
       active: "active";
       invited: "invited";
     }>;
-    createdAt: import("zod").ZodCoercedDate<unknown>;
-    updatedAt: import("zod").ZodCoercedDate<unknown>;
-    userId: import("zod").ZodString;
     role: import("zod").ZodEnum<{
       owner: "owner";
       admin: "admin";
@@ -175,6 +174,7 @@ declare const organizationEvents: {
       moderator: "moderator";
       student: "student";
     }>;
+    userId: import("zod").ZodString;
   }, import("zod/v4/core").$strip>>;
   inviteCreated: RuntimeEventDefinition<VersionedDomainEvent<{
     id: string;
@@ -199,24 +199,24 @@ declare const organizationEvents: {
     createdAt: unknown;
     updatedAt: unknown;
   }, import("zod").ZodObject<{
-    orgId: import("zod").ZodString;
     id: import("zod").ZodString;
+    orgId: import("zod").ZodString;
+    createdAt: import("zod").ZodCoercedDate<unknown>;
+    updatedAt: import("zod").ZodCoercedDate<unknown>;
     status: import("zod").ZodEnum<{
       pending: "pending";
       accepted: "accepted";
       rejected: "rejected";
       canceled: "canceled";
     }>;
-    createdAt: import("zod").ZodCoercedDate<unknown>;
-    updatedAt: import("zod").ZodCoercedDate<unknown>;
     expiresAt: import("zod").ZodNullable<import("zod").ZodCoercedDate<unknown>>;
-    email: import("zod").ZodEmail;
     role: import("zod").ZodEnum<{
       admin: "admin";
       instructor: "instructor";
       moderator: "moderator";
       student: "student";
     }>;
+    email: import("zod").ZodEmail;
     invitedBy: import("zod").ZodString;
   }, import("zod/v4/core").$strip>>;
   inviteAccepted: RuntimeEventDefinition<VersionedDomainEvent<{
@@ -242,24 +242,24 @@ declare const organizationEvents: {
     createdAt: unknown;
     updatedAt: unknown;
   }, import("zod").ZodObject<{
-    orgId: import("zod").ZodString;
     id: import("zod").ZodString;
+    orgId: import("zod").ZodString;
+    createdAt: import("zod").ZodCoercedDate<unknown>;
+    updatedAt: import("zod").ZodCoercedDate<unknown>;
     status: import("zod").ZodEnum<{
       pending: "pending";
       accepted: "accepted";
       rejected: "rejected";
       canceled: "canceled";
     }>;
-    createdAt: import("zod").ZodCoercedDate<unknown>;
-    updatedAt: import("zod").ZodCoercedDate<unknown>;
     expiresAt: import("zod").ZodNullable<import("zod").ZodCoercedDate<unknown>>;
-    email: import("zod").ZodEmail;
     role: import("zod").ZodEnum<{
       admin: "admin";
       instructor: "instructor";
       moderator: "moderator";
       student: "student";
     }>;
+    email: import("zod").ZodEmail;
     invitedBy: import("zod").ZodString;
   }, import("zod/v4/core").$strip>>;
   inviteCanceled: RuntimeEventDefinition<VersionedDomainEvent<{
@@ -302,15 +302,14 @@ declare const organizationEvents: {
     createdAt: unknown;
     updatedAt: unknown;
   }, import("zod").ZodObject<{
-    orgId: import("zod").ZodString;
     id: import("zod").ZodString;
+    orgId: import("zod").ZodString;
+    createdAt: import("zod").ZodCoercedDate<unknown>;
+    updatedAt: import("zod").ZodCoercedDate<unknown>;
     status: import("zod").ZodEnum<{
       active: "active";
       invited: "invited";
     }>;
-    createdAt: import("zod").ZodCoercedDate<unknown>;
-    updatedAt: import("zod").ZodCoercedDate<unknown>;
-    userId: import("zod").ZodString;
     role: import("zod").ZodEnum<{
       owner: "owner";
       admin: "admin";
@@ -318,6 +317,7 @@ declare const organizationEvents: {
       moderator: "moderator";
       student: "student";
     }>;
+    userId: import("zod").ZodString;
   }, import("zod/v4/core").$strip>>;
   studentDeleted: RuntimeEventDefinition<VersionedDomainEvent<{
     id: string;
@@ -336,15 +336,14 @@ declare const organizationEvents: {
     createdAt: unknown;
     updatedAt: unknown;
   }, import("zod").ZodObject<{
-    orgId: import("zod").ZodString;
     id: import("zod").ZodString;
+    orgId: import("zod").ZodString;
+    createdAt: import("zod").ZodCoercedDate<unknown>;
+    updatedAt: import("zod").ZodCoercedDate<unknown>;
     status: import("zod").ZodEnum<{
       active: "active";
       invited: "invited";
     }>;
-    createdAt: import("zod").ZodCoercedDate<unknown>;
-    updatedAt: import("zod").ZodCoercedDate<unknown>;
-    userId: import("zod").ZodString;
     role: import("zod").ZodEnum<{
       owner: "owner";
       admin: "admin";
@@ -352,6 +351,7 @@ declare const organizationEvents: {
       moderator: "moderator";
       student: "student";
     }>;
+    userId: import("zod").ZodString;
   }, import("zod/v4/core").$strip>>;
   studentLinked: RuntimeEventDefinition<VersionedDomainEvent<{
     id: string;
@@ -370,15 +370,14 @@ declare const organizationEvents: {
     createdAt: unknown;
     updatedAt: unknown;
   }, import("zod").ZodObject<{
-    orgId: import("zod").ZodString;
     id: import("zod").ZodString;
+    orgId: import("zod").ZodString;
+    createdAt: import("zod").ZodCoercedDate<unknown>;
+    updatedAt: import("zod").ZodCoercedDate<unknown>;
     status: import("zod").ZodEnum<{
       active: "active";
       invited: "invited";
     }>;
-    createdAt: import("zod").ZodCoercedDate<unknown>;
-    updatedAt: import("zod").ZodCoercedDate<unknown>;
-    userId: import("zod").ZodString;
     role: import("zod").ZodEnum<{
       owner: "owner";
       admin: "admin";
@@ -386,6 +385,7 @@ declare const organizationEvents: {
       moderator: "moderator";
       student: "student";
     }>;
+    userId: import("zod").ZodString;
   }, import("zod/v4/core").$strip>>;
 };
 type OrganizationCreated = EventOf<typeof organizationEvents.organizationCreated>;

package/dist/organizations/index.d.ts

@@ -7,6 +7,7 @@ import { CreateOrganizationInput, LinkOrgUserInput, ResendStudentInviteInput, Un
 import { AuthHeaders } from "../identity/ports.js";
 import { AuthOrganization, MemberRecord, MemberWriteContext, MembersRepository, NewInviteRow, NewOrganizationRow, OrgAdmin, OrganizationService, OrganizationsRepository } from "./ports.js";
 import { OrganizationServiceImpl } from "./service.js";
+import { OrgNotificationCategories } from "./notification-categories.js";
 import { InviteAccepted, InviteCanceled, InviteCreated, OrgUserDeleted, OrgUserLinked, OrgUserUpdated, OrganizationCreated, OrganizationDeleted, OrganizationEvent, OrganizationUpdated, StudentCreated, StudentDeleted, StudentLinked, organizationEvents } from "./events.js";
 import { ACCESS_SCOPES, AccessScope, SCOPE_PERMISSION, ScopeOption, assertRoleHoldsScopes, isAccessScope, isDeleteScope, roleHoldsScope, scopeOptions, scopesForRole } from "./access-scopes.js";
-export { ACCESS_SCOPES, type AcceptInviteInput, AccessScope, type AddOrgUserInput, type AuthHeaders, type AuthOrganization, type Capability, type CreateInviteInput, type CreateOrgUserInput, type CreateOrganizationInput, type Invite, type InviteAccepted, type InviteCanceled, type InviteCreated, InviteError, type InviteId, type InviteRole, type LinkOrgUserInput, type Member, type MemberRecord, type MemberRoleChange, type MemberStatus, type MemberWriteContext, type MembersQuery, type MembersRepository, type NewInviteRow, type NewOrganizationInput, type NewOrganizationRow, type OrgAdmin, type OrgUser, type OrgUserDeleted, type OrgUserId, type OrgUserLinked, type OrgUserStatus, type OrgUserUpdated, type Organization, type OrganizationCreated, type OrganizationDeleted, type OrganizationEvent, type OrganizationId, OrganizationRuleError, type OrganizationService, OrganizationServiceImpl, type OrganizationUpdated, type OrganizationsRepository, type Page, type Permission, ROLES, type ResendStudentInviteInput, type Role, SCOPE_PERMISSION, STAFF_ROLES, STUDENT_ROLE, ScopeOption, type StaffRole, type StudentCreated, type StudentDeleted, type StudentLinked, type TeamRole, type UnlinkOrgUserInput, type UpdateOrgUserInput, type UpdateOrganizationInput, assertRoleHoldsScopes, canModerate, capability, isAccessScope, isDeleteScope, isRole, isStaffRole, normalizeRole, organizationEvents, parseRole, roleHoldsScope, scopeOptions, scopesForRole };
+export { ACCESS_SCOPES, type AcceptInviteInput, AccessScope, type AddOrgUserInput, type AuthHeaders, type AuthOrganization, type Capability, type CreateInviteInput, type CreateOrgUserInput, type CreateOrganizationInput, type Invite, type InviteAccepted, type InviteCanceled, type InviteCreated, InviteError, type InviteId, type InviteRole, type LinkOrgUserInput, type Member, type MemberRecord, type MemberRoleChange, type MemberStatus, type MemberWriteContext, type MembersQuery, type MembersRepository, type NewInviteRow, type NewOrganizationInput, type NewOrganizationRow, type OrgAdmin, OrgNotificationCategories, type OrgUser, type OrgUserDeleted, type OrgUserId, type OrgUserLinked, type OrgUserStatus, type OrgUserUpdated, type Organization, type OrganizationCreated, type OrganizationDeleted, type OrganizationEvent, type OrganizationId, OrganizationRuleError, type OrganizationService, OrganizationServiceImpl, type OrganizationUpdated, type OrganizationsRepository, type Page, type Permission, ROLES, type ResendStudentInviteInput, type Role, SCOPE_PERMISSION, STAFF_ROLES, STUDENT_ROLE, ScopeOption, type StaffRole, type StudentCreated, type StudentDeleted, type StudentLinked, type TeamRole, type UnlinkOrgUserInput, type UpdateOrgUserInput, type UpdateOrganizationInput, assertRoleHoldsScopes, canModerate, capability, isAccessScope, isDeleteScope, isRole, isStaffRole, normalizeRole, organizationEvents, parseRole, roleHoldsScope, scopeOptions, scopesForRole };

package/dist/organizations/index.js

@@ -2,5 +2,6 @@ import { ROLES, STAFF_ROLES, STUDENT_ROLE, canModerate, capability, isRole, isSt
 import { InviteError, OrganizationRuleError } from "./members.js";
 import { organizationEvents } from "./events.js";
 import { OrganizationServiceImpl } from "./service.js";
+import { OrgNotificationCategories } from "./notification-categories.js";
 import { ACCESS_SCOPES, SCOPE_PERMISSION, assertRoleHoldsScopes, isAccessScope, isDeleteScope, roleHoldsScope, scopeOptions, scopesForRole } from "./access-scopes.js";
-export { ACCESS_SCOPES, InviteError, OrganizationRuleError, OrganizationServiceImpl, ROLES, SCOPE_PERMISSION, STAFF_ROLES, STUDENT_ROLE, assertRoleHoldsScopes, canModerate, capability, isAccessScope, isDeleteScope, isRole, isStaffRole, normalizeRole, organizationEvents, parseRole, roleHoldsScope, scopeOptions, scopesForRole };
+export { ACCESS_SCOPES, InviteError, OrgNotificationCategories, OrganizationRuleError, OrganizationServiceImpl, ROLES, SCOPE_PERMISSION, STAFF_ROLES, STUDENT_ROLE, assertRoleHoldsScopes, canModerate, capability, isAccessScope, isDeleteScope, isRole, isStaffRole, normalizeRole, organizationEvents, parseRole, roleHoldsScope, scopeOptions, scopesForRole };

package/dist/organizations/notification-categories.d.ts

@@ -0,0 +1,32 @@
+import { Logger } from "../types/ports.js";
+import { NotificationCategory } from "../types/notifications.js";
+import "../types/index.js";
+import { ChannelRegistry, NotificationCategoryService, NotificationTypeRegistry } from "../shared/ports.js";
+import { SettingsService } from "../shared/settings.js";
+//#region src/organizations/notification-categories.d.ts
+type OrgNotificationCategoriesParams = {
+  settings: SettingsService;
+  types: NotificationTypeRegistry;
+  channels: ChannelRegistry;
+  logger?: Logger;
+};
+declare class OrgNotificationCategories implements NotificationCategoryService {
+  private readonly settings;
+  private readonly types;
+  private readonly channels;
+  private readonly logger;
+  constructor(params: OrgNotificationCategoriesParams);
+  get(orgId: string, scopeId: string): Promise<{
+    categories: NotificationCategory[];
+    source: 'default' | 'stored';
+  }>;
+  replace(orgId: string, scopeId: string, categories: NotificationCategory[]): Promise<{
+    categories: NotificationCategory[];
+    source: 'stored';
+  }>;
+  reset(orgId: string, scopeId: string): Promise<void>;
+  defaults(): NotificationCategory[];
+}
+//#endregion
+export { OrgNotificationCategories, OrgNotificationCategoriesParams };
+//# sourceMappingURL=notification-categories.d.ts.map

package/dist/organizations/notification-categories.js

@@ -0,0 +1,51 @@
+import { noopLogger } from "../shared/logger.js";
+import "../shared/settings.js";
+import { assertValidCategoryList, offeringConfigured, storedCategoryList } from "../shared/notification-categories.js";
+//#region src/organizations/notification-categories.ts
+var OrgNotificationCategories = class {
+	settings;
+	types;
+	channels;
+	logger;
+	constructor(params) {
+		this.settings = params.settings;
+		this.types = params.types;
+		this.channels = params.channels;
+		this.logger = params.logger ?? noopLogger;
+	}
+	async get(orgId, scopeId) {
+		const stored = storedCategoryList((await this.settings.get(orgId, "organizations", scopeId))?.notificationCategories);
+		return stored ? {
+			categories: offeringConfigured(stored, this.channels.list()),
+			source: "stored"
+		} : {
+			categories: this.defaults(),
+			source: "default"
+		};
+	}
+	async replace(orgId, scopeId, categories) {
+		const configured = this.channels.list();
+		assertValidCategoryList(categories, "org", this.types, configured);
+		const ordered = offeringConfigured(categories, configured);
+		await this.settings.patch(orgId, "organizations", scopeId, { notificationCategories: ordered });
+		this.logger.info("org notification categories replaced", {
+			orgId,
+			keys: categories.map((category) => category.key)
+		});
+		return {
+			categories: ordered,
+			source: "stored"
+		};
+	}
+	async reset(orgId, scopeId) {
+		await this.settings.patch(orgId, "organizations", scopeId, { notificationCategories: null });
+		this.logger.info("org notification categories reset", { orgId });
+	}
+	defaults() {
+		return this.types.defaults("org");
+	}
+};
+//#endregion
+export { OrgNotificationCategories };
+
+//# sourceMappingURL=notification-categories.js.map

package/dist/organizations/notification-categories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-categories.js","names":[],"sources":["../../src/organizations/notification-categories.ts"],"sourcesContent":["import type { NotificationCategory } from '../types/index.js';\nimport type {\n  ChannelRegistry,\n  Logger,\n  NotificationCategoryService,\n  NotificationTypeRegistry,\n} from '../shared/ports.js';\nimport { noopLogger } from '../shared/logger.js';\nimport { SettingsNamespace, type SettingsService } from '../shared/settings.js';\nimport {\n  assertValidCategoryList,\n  offeringConfigured,\n  storedCategoryList,\n} from '../shared/notification-categories.js';\n\nexport type OrgNotificationCategoriesParams = {\n  settings: SettingsService;\n  types: NotificationTypeRegistry;\n  channels: ChannelRegistry;\n  logger?: Logger;\n};\n\nexport class OrgNotificationCategories implements NotificationCategoryService {\n  private readonly settings: SettingsService;\n  private readonly types: NotificationTypeRegistry;\n  private readonly channels: ChannelRegistry;\n  private readonly logger: Logger;\n\n  constructor(params: OrgNotificationCategoriesParams) {\n    this.settings = params.settings;\n    this.types = params.types;\n    this.channels = params.channels;\n    this.logger = params.logger ?? noopLogger;\n  }\n\n  async get(\n    orgId: string,\n    scopeId: string,\n  ): Promise<{ categories: NotificationCategory[]; source: 'default' | 'stored' }> {\n    const value = await this.settings.get<Record<string, unknown>>(\n      orgId,\n      SettingsNamespace.organizations,\n      scopeId,\n    );\n    const stored = storedCategoryList(value?.notificationCategories);\n    return stored\n      ? { categories: offeringConfigured(stored, this.channels.list()), source: 'stored' }\n      : { categories: this.defaults(), source: 'default' };\n  }\n\n  async replace(\n    orgId: string,\n    scopeId: string,\n    categories: NotificationCategory[],\n  ): Promise<{ categories: NotificationCategory[]; source: 'stored' }> {\n    const configured = this.channels.list();\n    assertValidCategoryList(categories, 'org', this.types, configured);\n    const ordered = offeringConfigured(categories, configured);\n    await this.settings.patch(orgId, SettingsNamespace.organizations, scopeId, {\n      notificationCategories: ordered,\n    });\n    this.logger.info('org notification categories replaced', {\n      orgId,\n      keys: categories.map((category) => category.key),\n    });\n    return { categories: ordered, source: 'stored' };\n  }\n\n  async reset(orgId: string, scopeId: string): Promise<void> {\n    await this.settings.patch(orgId, SettingsNamespace.organizations, scopeId, {\n      notificationCategories: null,\n    });\n    this.logger.info('org notification categories reset', { orgId });\n  }\n\n  defaults(): NotificationCategory[] {\n    return this.types.defaults('org');\n  }\n}\n"],"mappings":";;;;AAsBA,IAAa,4BAAb,MAA8E;CAC5E;CACA;CACA;CACA;CAEA,YAAY,QAAyC;EACnD,KAAK,WAAW,OAAO;EACvB,KAAK,QAAQ,OAAO;EACpB,KAAK,WAAW,OAAO;EACvB,KAAK,SAAS,OAAO,UAAU;CACjC;CAEA,MAAM,IACJ,OACA,SAC+E;EAM/E,MAAM,SAAS,oBAAmB,MALd,KAAK,SAAS,IAChC,OAAA,iBAEA,OACF,EAAA,EACyC,sBAAsB;EAC/D,OAAO,SACH;GAAE,YAAY,mBAAmB,QAAQ,KAAK,SAAS,KAAK,CAAC;GAAG,QAAQ;EAAS,IACjF;GAAE,YAAY,KAAK,SAAS;GAAG,QAAQ;EAAU;CACvD;CAEA,MAAM,QACJ,OACA,SACA,YACmE;EACnE,MAAM,aAAa,KAAK,SAAS,KAAK;EACtC,wBAAwB,YAAY,OAAO,KAAK,OAAO,UAAU;EACjE,MAAM,UAAU,mBAAmB,YAAY,UAAU;EACzD,MAAM,KAAK,SAAS,MAAM,OAAA,iBAAwC,SAAS,EACzE,wBAAwB,QAC1B,CAAC;EACD,KAAK,OAAO,KAAK,wCAAwC;GACvD;GACA,MAAM,WAAW,KAAK,aAAa,SAAS,GAAG;EACjD,CAAC;EACD,OAAO;GAAE,YAAY;GAAS,QAAQ;EAAS;CACjD;CAEA,MAAM,MAAM,OAAe,SAAgC;EACzD,MAAM,KAAK,SAAS,MAAM,OAAA,iBAAwC,SAAS,EACzE,wBAAwB,KAC1B,CAAC;EACD,KAAK,OAAO,KAAK,qCAAqC,EAAE,MAAM,CAAC;CACjE;CAEA,WAAmC;EACjC,OAAO,KAAK,MAAM,SAAS,KAAK;CAClC;AACF"}