@headless-lms/server 0.3.0 → 0.5.0

package/dist/http/schemas/notifications.js

@@ -1,19 +1,53 @@
-import { paginated } from "./shared.js";
+import { PageQuery, paginated } from "./shared.js";
 import { z } from "zod";
-import { notificationKindSchema, notificationPreferenceSchema, notificationSchema } from "@headless-lms/core/schemas";
+import { digestScheduleSchema, jsonValueSchema, notificationCategoryKeySchema, notificationCategoryListSchema, notificationCategorySchema, notificationChannelKeySchema, notificationScopeSchema, notificationTypeKeySchema, reasonSchema, subjectTypeSchema } from "@headless-lms/core/schemas";
 //#region src/http/schemas/notifications.ts
-const Notification = notificationSchema;
 const NotificationIdParam = z.object({ notificationId: z.string() });
+function commaSeparated(item, description) {
+	return z.string().max(2e3).transform((value) => value.split(",").map((part) => part.trim()).filter((part) => part.length > 0)).pipe(z.array(item).min(1).max(50)).describe(description);
+}
+function scopeMatchesCommunity(filter, ctx) {
+	if (filter.scope === "org" && filter.communityId !== void 0) ctx.addIssue({
+		code: "custom",
+		path: ["communityId"],
+		message: "`communityId` implies `scope=community`; it cannot go with `scope=org`"
+	});
+	if (filter.includeOrg === true && filter.communityId === void 0) ctx.addIssue({
+		code: "custom",
+		path: ["includeOrg"],
+		message: "`includeOrg` goes with `communityId`"
+	});
+	if (filter.includeOrg === true && filter.scope !== void 0) ctx.addIssue({
+		code: "custom",
+		path: ["includeOrg"],
+		message: "`includeOrg` cannot go with `scope`"
+	});
+}
+const notificationFilterShape = z.object({
+	scope: z.enum(["org", "community"]).optional().describe("`org`: the org list only; `community`: notifications in any community"),
+	communityId: z.string().min(1).max(64).optional().describe("Notifications in this community; implies `scope=community`"),
+	includeOrg: z.stringbool().optional().describe("With `communityId`, `true` adds the org list (notifications in no community); not with `scope`"),
+	category: commaSeparated(notificationCategoryKeySchema, "One or more category keys, comma separated").optional(),
+	reason: commaSeparated(reasonSchema, "One or more reasons, comma separated; matches any").optional(),
+	type: commaSeparated(notificationTypeKeySchema, "One or more types, comma separated").optional(),
+	unread: z.stringbool().optional().describe("`true` for unread notifications only")
+}).strict();
+const NotificationFilterQuery = notificationFilterShape.superRefine(scopeMatchesCommunity);
+const NotificationListQuery = PageQuery.extend(notificationFilterShape.shape).strict().superRefine(scopeMatchesCommunity);
+const NotificationItem = z.object({
+	type: subjectTypeSchema,
+	id: z.string(),
+	title: z.string().optional(),
+	excerpt: z.string().optional()
+});
 const NotificationView = z.object({
 	id: z.string(),
-	kind: notificationKindSchema,
-	createdAt: z.coerce.date(),
-	readAt: z.coerce.date().nullable(),
-	actor: z.object({
-		orgUserId: z.string(),
-		displayName: z.string().nullable(),
-		imageUrl: z.string().nullable()
-	}).nullable(),
+	type: z.string(),
+	scope: notificationScopeSchema,
+	reasons: z.array(reasonSchema),
+	matchedReason: reasonSchema.describe("The reason of the pair the category matched, which picks the wording, such as a reply to your comment"),
+	category: z.string(),
+	display: z.record(z.string(), jsonValueSchema).describe("The text stored when the notification was sent"),
 	community: z.object({
 		id: z.string(),
 		title: z.string()
@@ -22,23 +56,109 @@ const NotificationView = z.object({
 		id: z.string(),
 		name: z.string()
 	}).nullable(),
-	post: z.object({
-		id: z.string(),
-		title: z.string()
-	}).nullable().describe("Null when the viewer can no longer see the post"),
-	commentId: z.string().nullable(),
-	chat: z.object({
-		id: z.string(),
-		title: z.string()
-	}).nullable().describe("Null when the viewer is not in the chat"),
-	messageId: z.string().nullable()
-});
-const NotificationsPage = paginated(NotificationView).extend({ unreadCount: z.number().int() });
-const MarkedRead = z.object({ updated: z.number().int() });
-const NotificationPreference = notificationPreferenceSchema;
-const NotificationPreferences = z.array(NotificationPreference);
-const SetNotificationPreferences = z.object({ preferences: z.array(NotificationPreference).min(1).max(notificationKindSchema.options.length).refine((preferences) => new Set(preferences.map((p) => p.kind)).size === preferences.length, { message: "must name each kind at most once" }).describe("One entry per kind to change, each kind at most once; kinds left out keep theirs") }).strict();
+	actor: z.object({
+		orgUserId: z.string(),
+		name: z.string().nullable(),
+		imageUrl: z.string().nullable()
+	}).nullable(),
+	subject: NotificationItem.nullable().describe("What the notification is about, with its current title or excerpt; null when you can no longer open it or it was deleted"),
+	parent: NotificationItem.nullable().describe("The subject's container, such as a comment's post; null when you can no longer open it or it was deleted"),
+	createdAt: z.coerce.date(),
+	readAt: z.coerce.date().nullable()
+});
+const NotificationsPage = paginated(NotificationView).extend({ unreadCount: z.number().int().describe("Unread notifications matching the same filters") });
+const NotificationUnreadCounts = z.object({
+	org: z.number().int(),
+	communities: z.array(z.object({
+		communityId: z.string(),
+		unread: z.number().int()
+	}))
+});
+const NotificationCategory = notificationCategorySchema;
+const NotificationCategoryList = z.object({
+	categories: z.array(NotificationCategory),
+	source: z.enum(["default", "stored"]).describe("`default` while the list in use is the server default, `stored` once one is saved")
+});
+const ReplaceNotificationCategories = z.object({ categories: notificationCategoryListSchema.describe("The whole ordered list; a notification is filed under the first category that matches") }).strict();
+const NotificationCategoryDefaults = z.object({ categories: z.array(NotificationCategory) });
+const NotificationListScopeQuery = z.object({ scope: z.enum(["org", "community"]) }).strict();
+const NotificationTypeInfo = z.object({
+	type: z.string(),
+	scopes: z.array(notificationScopeSchema),
+	reasons: z.array(reasonSchema)
+});
+const NotificationTypeInfos = z.array(NotificationTypeInfo);
+const NotificationChannelInfos = z.array(z.object({ channel: z.string() }));
+const ResolvedChannel = z.object({
+	channel: z.string(),
+	enabled: z.boolean(),
+	default: z.boolean().describe("What the channel would be without your own setting at this level: what `enabled: null` gives"),
+	source: z.enum([
+		"locked",
+		"space",
+		"community",
+		"spaceDefault",
+		"default"
+	]).describe("Why the channel is on or off: locked by the category, your setting for the space, your setting for the whole community (or the org), the default for the space, or the category default"),
+	locked: z.boolean()
+});
+const NotificationSettingsCategory = z.object({
+	key: z.string(),
+	perSpace: z.boolean(),
+	channels: z.array(ResolvedChannel),
+	spaces: z.array(z.object({
+		spaceId: z.string(),
+		name: z.string(),
+		channels: z.array(ResolvedChannel)
+	})).optional().describe("Per-space categories only: every space you can open")
+});
+const CommunityNotificationSettings = z.object({
+	communityId: z.string(),
+	digest: digestScheduleSchema.nullable().describe("The community's digest schedule; null when it sends no digest"),
+	categories: z.array(NotificationSettingsCategory)
+});
+const OrgNotificationSettings = z.object({ categories: z.array(NotificationSettingsCategory) });
+const PatchNotificationSettings = z.object({ settings: z.array(z.object({
+	category: notificationCategoryKeySchema,
+	spaceId: z.string().min(1).max(64).optional(),
+	channel: notificationChannelKeySchema,
+	enabled: z.boolean().nullable().describe("null removes your choice, so the default applies again")
+}).strict()).min(1).max(200) }).strict();
+const DeviceFields = {
+	id: z.string(),
+	provider: z.enum([
+		"apns",
+		"fcm",
+		"webpush"
+	]),
+	token: z.string(),
+	p256dh: z.string().nullable(),
+	auth: z.string().nullable(),
+	appId: z.string().nullable(),
+	environment: z.enum(["production", "sandbox"]).nullable()
+};
+const Device = z.object(DeviceFields);
+const DeviceList = z.array(z.object({
+	...DeviceFields,
+	lastSeenAt: z.coerce.date()
+}));
+const DeviceIdParam = z.object({ deviceId: z.string() });
+const RegisterDevice = z.object({
+	provider: z.enum([
+		"apns",
+		"fcm",
+		"webpush"
+	]),
+	token: z.string().min(1).max(4096).describe("The APNs device token, the FCM registration token, or the Web Push endpoint URL"),
+	keys: z.object({
+		p256dh: z.string().min(1).max(512),
+		auth: z.string().min(1).max(512)
+	}).strict().optional().describe("The Web Push subscription keys; webpush only"),
+	appId: z.string().min(1).max(255).optional().describe("The iOS bundle id or Android package name"),
+	environment: z.enum(["production", "sandbox"]).optional().describe("apns only")
+}).strict();
+const PushConfigView = z.object({ vapidPublicKey: z.string().nullable() });
 //#endregion
-export { MarkedRead, Notification, NotificationIdParam, NotificationPreference, NotificationPreferences, NotificationView, NotificationsPage, SetNotificationPreferences };
+export { CommunityNotificationSettings, Device, DeviceIdParam, DeviceList, NotificationCategory, NotificationCategoryDefaults, NotificationCategoryList, NotificationChannelInfos, NotificationFilterQuery, NotificationIdParam, NotificationListQuery, NotificationListScopeQuery, NotificationTypeInfo, NotificationTypeInfos, NotificationUnreadCounts, NotificationView, NotificationsPage, OrgNotificationSettings, PatchNotificationSettings, PushConfigView, RegisterDevice, ReplaceNotificationCategories };
 
 //# sourceMappingURL=notifications.js.map

package/dist/http/schemas/notifications.js.map

@@ -1 +1 @@
-{"version":3,"file":"notifications.js","names":[],"sources":["../../../src/http/schemas/notifications.ts"],"sourcesContent":["import { z } from 'zod';\nimport {\n  notificationKindSchema,\n  notificationPreferenceSchema,\n  notificationSchema,\n} from '@headless-lms/core/schemas';\nimport type { NotificationView as DomainNotificationView } from '@headless-lms/core/reporting/member';\nimport { paginated, type Matches } from './shared.js';\n\nexport const Notification = notificationSchema;\nexport const NotificationIdParam = z.object({ notificationId: z.string() });\n\nexport const NotificationView = z.object({\n  id: z.string(),\n  kind: notificationKindSchema,\n  createdAt: z.coerce.date(),\n  readAt: z.coerce.date().nullable(),\n  actor: z\n    .object({\n      orgUserId: z.string(),\n      displayName: z.string().nullable(),\n      imageUrl: z.string().nullable(),\n    })\n    .nullable(),\n  community: z.object({ id: z.string(), title: z.string() }).nullable(),\n  space: z.object({ id: z.string(), name: z.string() }).nullable(),\n  post: z\n    .object({ id: z.string(), title: z.string() })\n    .nullable()\n    .describe('Null when the viewer can no longer see the post'),\n  commentId: z.string().nullable(),\n  chat: z\n    .object({ id: z.string(), title: z.string() })\n    .nullable()\n    .describe('Null when the viewer is not in the chat'),\n  messageId: z.string().nullable(),\n});\ntype _NotificationViewMatches = Matches<DomainNotificationView, z.infer<typeof NotificationView>> &\n  Matches<z.infer<typeof NotificationView>, DomainNotificationView>;\n\nexport const NotificationsPage = paginated(NotificationView).extend({\n  unreadCount: z.number().int(),\n});\n\nexport const MarkedRead = z.object({ updated: z.number().int() });\n\nexport const NotificationPreference = notificationPreferenceSchema;\nexport const NotificationPreferences = z.array(NotificationPreference);\nexport const SetNotificationPreferences = z\n  .object({\n    preferences: z\n      .array(NotificationPreference)\n      .min(1)\n      .max(notificationKindSchema.options.length)\n      .refine(\n        (preferences) => new Set(preferences.map((p) => p.kind)).size === preferences.length,\n        { message: 'must name each kind at most once' },\n      )\n      .describe('One entry per kind to change, each kind at most once; kinds left out keep theirs'),\n  })\n  .strict();\n"],"mappings":";;;;AASA,MAAa,eAAe;AAC5B,MAAa,sBAAsB,EAAE,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC;AAE1E,MAAa,mBAAmB,EAAE,OAAO;CACvC,IAAI,EAAE,OAAO;CACb,MAAM;CACN,WAAW,EAAE,OAAO,KAAK;CACzB,QAAQ,EAAE,OAAO,KAAK,CAAC,CAAC,SAAS;CACjC,OAAO,EACJ,OAAO;EACN,WAAW,EAAE,OAAO;EACpB,aAAa,EAAE,OAAO,CAAC,CAAC,SAAS;EACjC,UAAU,EAAE,OAAO,CAAC,CAAC,SAAS;CAChC,CAAC,CAAC,CACD,SAAS;CACZ,WAAW,EAAE,OAAO;EAAE,IAAI,EAAE,OAAO;EAAG,OAAO,EAAE,OAAO;CAAE,CAAC,CAAC,CAAC,SAAS;CACpE,OAAO,EAAE,OAAO;EAAE,IAAI,EAAE,OAAO;EAAG,MAAM,EAAE,OAAO;CAAE,CAAC,CAAC,CAAC,SAAS;CAC/D,MAAM,EACH,OAAO;EAAE,IAAI,EAAE,OAAO;EAAG,OAAO,EAAE,OAAO;CAAE,CAAC,CAAC,CAC7C,SAAS,CAAC,CACV,SAAS,iDAAiD;CAC7D,WAAW,EAAE,OAAO,CAAC,CAAC,SAAS;CAC/B,MAAM,EACH,OAAO;EAAE,IAAI,EAAE,OAAO;EAAG,OAAO,EAAE,OAAO;CAAE,CAAC,CAAC,CAC7C,SAAS,CAAC,CACV,SAAS,yCAAyC;CACrD,WAAW,EAAE,OAAO,CAAC,CAAC,SAAS;AACjC,CAAC;AAID,MAAa,oBAAoB,UAAU,gBAAgB,CAAC,CAAC,OAAO,EAClE,aAAa,EAAE,OAAO,CAAC,CAAC,IAAI,EAC9B,CAAC;AAED,MAAa,aAAa,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;AAEhE,MAAa,yBAAyB;AACtC,MAAa,0BAA0B,EAAE,MAAM,sBAAsB;AACrE,MAAa,6BAA6B,EACvC,OAAO,EACN,aAAa,EACV,MAAM,sBAAsB,CAAC,CAC7B,IAAI,CAAC,CAAC,CACN,IAAI,uBAAuB,QAAQ,MAAM,CAAC,CAC1C,QACE,gBAAgB,IAAI,IAAI,YAAY,KAAK,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,SAAS,YAAY,QAC9E,EAAE,SAAS,mCAAmC,CAChD,CAAC,CACA,SAAS,kFAAkF,EAChG,CAAC,CAAC,CACD,OAAO"}
+{"version":3,"file":"notifications.js","names":[],"sources":["../../../src/http/schemas/notifications.ts"],"sourcesContent":["import { z } from 'zod';\nimport {\n  digestScheduleSchema,\n  jsonValueSchema,\n  notificationCategoryKeySchema,\n  notificationChannelKeySchema,\n  notificationCategoryListSchema,\n  notificationCategorySchema,\n  notificationScopeSchema,\n  notificationTypeKeySchema,\n  reasonSchema,\n  subjectTypeSchema,\n} from '@headless-lms/core/schemas';\nimport type {\n  CommunityNotificationSettingsView as DomainCommunityNotificationSettingsView,\n  NotificationUnreadCounts as DomainNotificationUnreadCounts,\n  NotificationView as DomainNotificationView,\n} from '@headless-lms/core/reporting/member';\nimport { PageQuery, paginated, type Matches } from './shared.js';\n\nexport const NotificationIdParam = z.object({ notificationId: z.string() });\n\nfunction commaSeparated<T extends string>(item: z.ZodType<T, string>, description: string) {\n  return z\n    .string()\n    .max(2000)\n    .transform((value) =>\n      value\n        .split(',')\n        .map((part) => part.trim())\n        .filter((part) => part.length > 0),\n    )\n    .pipe(z.array(item).min(1).max(50))\n    .describe(description);\n}\n\nfunction scopeMatchesCommunity(\n  filter: { scope?: 'org' | 'community'; communityId?: string; includeOrg?: boolean },\n  ctx: z.RefinementCtx,\n): void {\n  if (filter.scope === 'org' && filter.communityId !== undefined) {\n    ctx.addIssue({\n      code: 'custom',\n      path: ['communityId'],\n      message: '`communityId` implies `scope=community`; it cannot go with `scope=org`',\n    });\n  }\n  if (filter.includeOrg === true && filter.communityId === undefined) {\n    ctx.addIssue({\n      code: 'custom',\n      path: ['includeOrg'],\n      message: '`includeOrg` goes with `communityId`',\n    });\n  }\n  if (filter.includeOrg === true && filter.scope !== undefined) {\n    ctx.addIssue({\n      code: 'custom',\n      path: ['includeOrg'],\n      message: '`includeOrg` cannot go with `scope`',\n    });\n  }\n}\n\nconst notificationFilterShape = z\n  .object({\n    scope: z\n      .enum(['org', 'community'])\n      .optional()\n      .describe('`org`: the org list only; `community`: notifications in any community'),\n    communityId: z\n      .string()\n      .min(1)\n      .max(64)\n      .optional()\n      .describe('Notifications in this community; implies `scope=community`'),\n    includeOrg: z\n      .stringbool()\n      .optional()\n      .describe(\n        'With `communityId`, `true` adds the org list (notifications in no community); not with `scope`',\n      ),\n    category: commaSeparated(\n      notificationCategoryKeySchema,\n      'One or more category keys, comma separated',\n    ).optional(),\n    reason: commaSeparated(\n      reasonSchema,\n      'One or more reasons, comma separated; matches any',\n    ).optional(),\n    type: commaSeparated(\n      notificationTypeKeySchema,\n      'One or more types, comma separated',\n    ).optional(),\n    unread: z.stringbool().optional().describe('`true` for unread notifications only'),\n  })\n  .strict();\n\nexport const NotificationFilterQuery = notificationFilterShape.superRefine(scopeMatchesCommunity);\n\nexport const NotificationListQuery = PageQuery.extend(notificationFilterShape.shape)\n  .strict()\n  .superRefine(scopeMatchesCommunity);\n\nconst NotificationItem = z.object({\n  type: subjectTypeSchema,\n  id: z.string(),\n  title: z.string().optional(),\n  excerpt: z.string().optional(),\n});\n\nexport const NotificationView = z.object({\n  id: z.string(),\n  type: z.string(),\n  scope: notificationScopeSchema,\n  reasons: z.array(reasonSchema),\n  matchedReason: reasonSchema.describe(\n    'The reason of the pair the category matched, which picks the wording, such as a reply to your comment',\n  ),\n  category: z.string(),\n  display: z\n    .record(z.string(), jsonValueSchema)\n    .describe('The text stored when the notification was sent'),\n  community: z.object({ id: z.string(), title: z.string() }).nullable(),\n  space: z.object({ id: z.string(), name: z.string() }).nullable(),\n  actor: z\n    .object({\n      orgUserId: z.string(),\n      name: z.string().nullable(),\n      imageUrl: z.string().nullable(),\n    })\n    .nullable(),\n  subject: NotificationItem.nullable().describe(\n    'What the notification is about, with its current title or excerpt; null when you can no longer open it or it was deleted',\n  ),\n  parent: NotificationItem.nullable().describe(\n    \"The subject's container, such as a comment's post; null when you can no longer open it or it was deleted\",\n  ),\n  createdAt: z.coerce.date(),\n  readAt: z.coerce.date().nullable(),\n});\ntype _NotificationViewMatches = Matches<DomainNotificationView, z.infer<typeof NotificationView>> &\n  Matches<z.infer<typeof NotificationView>, DomainNotificationView>;\n\nexport const NotificationsPage = paginated(NotificationView).extend({\n  unreadCount: z.number().int().describe('Unread notifications matching the same filters'),\n});\n\nexport const NotificationUnreadCounts = z.object({\n  org: z.number().int(),\n  communities: z.array(z.object({ communityId: z.string(), unread: z.number().int() })),\n});\ntype _NotificationUnreadCountsMatches = Matches<\n  DomainNotificationUnreadCounts,\n  z.infer<typeof NotificationUnreadCounts>\n>;\n\nexport const NotificationCategory = notificationCategorySchema;\n\nexport const NotificationCategoryList = z.object({\n  categories: z.array(NotificationCategory),\n  source: z\n    .enum(['default', 'stored'])\n    .describe('`default` while the list in use is the server default, `stored` once one is saved'),\n});\n\nexport const ReplaceNotificationCategories = z\n  .object({\n    categories: notificationCategoryListSchema.describe(\n      'The whole ordered list; a notification is filed under the first category that matches',\n    ),\n  })\n  .strict();\n\nexport const NotificationCategoryDefaults = z.object({ categories: z.array(NotificationCategory) });\n\nexport const NotificationListScopeQuery = z\n  .object({ scope: z.enum(['org', 'community']) })\n  .strict();\n\nexport const NotificationTypeInfo = z.object({\n  type: z.string(),\n  scopes: z.array(notificationScopeSchema),\n  reasons: z.array(reasonSchema),\n});\nexport const NotificationTypeInfos = z.array(NotificationTypeInfo);\n\nexport const NotificationChannelInfos = z.array(z.object({ channel: z.string() }));\n\nconst ResolvedChannel = z.object({\n  channel: z.string(),\n  enabled: z.boolean(),\n  default: z\n    .boolean()\n    .describe(\n      'What the channel would be without your own setting at this level: what `enabled: null` gives',\n    ),\n  source: z\n    .enum(['locked', 'space', 'community', 'spaceDefault', 'default'])\n    .describe(\n      'Why the channel is on or off: locked by the category, your setting for the space, your setting for the whole community (or the org), the default for the space, or the category default',\n    ),\n  locked: z.boolean(),\n});\n\nconst NotificationSettingsCategory = z.object({\n  key: z.string(),\n  perSpace: z.boolean(),\n  channels: z.array(ResolvedChannel),\n  spaces: z\n    .array(z.object({ spaceId: z.string(), name: z.string(), channels: z.array(ResolvedChannel) }))\n    .optional()\n    .describe('Per-space categories only: every space you can open'),\n});\n\nexport const CommunityNotificationSettings = z.object({\n  communityId: z.string(),\n  digest: digestScheduleSchema\n    .nullable()\n    .describe(\"The community's digest schedule; null when it sends no digest\"),\n  categories: z.array(NotificationSettingsCategory),\n});\ntype _CommunityNotificationSettingsMatches = Matches<\n  DomainCommunityNotificationSettingsView,\n  z.infer<typeof CommunityNotificationSettings>\n>;\n\nexport const OrgNotificationSettings = z.object({\n  categories: z.array(NotificationSettingsCategory),\n});\n\nexport const PatchNotificationSettings = z\n  .object({\n    settings: z\n      .array(\n        z\n          .object({\n            category: notificationCategoryKeySchema,\n            spaceId: z.string().min(1).max(64).optional(),\n            channel: notificationChannelKeySchema,\n            enabled: z\n              .boolean()\n              .nullable()\n              .describe('null removes your choice, so the default applies again'),\n          })\n          .strict(),\n      )\n      .min(1)\n      .max(200),\n  })\n  .strict();\n\nconst DeviceFields = {\n  id: z.string(),\n  provider: z.enum(['apns', 'fcm', 'webpush']),\n  token: z.string(),\n  p256dh: z.string().nullable(),\n  auth: z.string().nullable(),\n  appId: z.string().nullable(),\n  environment: z.enum(['production', 'sandbox']).nullable(),\n};\n\nexport const Device = z.object(DeviceFields);\nexport const DeviceList = z.array(z.object({ ...DeviceFields, lastSeenAt: z.coerce.date() }));\nexport const DeviceIdParam = z.object({ deviceId: z.string() });\n\nexport const RegisterDevice = z\n  .object({\n    provider: z.enum(['apns', 'fcm', 'webpush']),\n    token: z\n      .string()\n      .min(1)\n      .max(4096)\n      .describe('The APNs device token, the FCM registration token, or the Web Push endpoint URL'),\n    keys: z\n      .object({ p256dh: z.string().min(1).max(512), auth: z.string().min(1).max(512) })\n      .strict()\n      .optional()\n      .describe('The Web Push subscription keys; webpush only'),\n    appId: z\n      .string()\n      .min(1)\n      .max(255)\n      .optional()\n      .describe('The iOS bundle id or Android package name'),\n    environment: z.enum(['production', 'sandbox']).optional().describe('apns only'),\n  })\n  .strict();\n\nexport const PushConfigView = z.object({ vapidPublicKey: z.string().nullable() });\n"],"mappings":"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"}

package/dist/http/schemas/platform.d.ts

@@ -0,0 +1,37 @@
+import { z } from "zod";
+//#region src/http/schemas/platform.d.ts
+declare const CreatePlatformOrganization: z.ZodObject<{
+  name: z.ZodString;
+  slug: z.ZodString;
+  keyName: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const PlatformOrganization: z.ZodObject<{
+  organization: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    slug: z.ZodString;
+    createdAt: z.ZodString;
+  }, z.core.$strip>;
+  apiKey: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodNullable<z.ZodString>;
+    start: z.ZodNullable<z.ZodString>;
+    role: z.ZodNullable<z.ZodObject<{
+      key: z.ZodString;
+      name: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    createdAt: z.ZodCoercedDate<unknown>;
+    lastUsedAt: z.ZodNullable<z.ZodCoercedDate<unknown>>;
+    expiresAt: z.ZodNullable<z.ZodCoercedDate<unknown>>;
+    key: z.ZodString;
+  }, z.core.$strip>;
+}, z.core.$strip>;
+declare const CreatePlatformApiKey: z.ZodObject<{
+  name: z.ZodString;
+}, z.core.$strip>;
+declare const PlatformOrgIdParam: z.ZodObject<{
+  orgId: z.ZodString;
+}, z.core.$strip>;
+//#endregion
+export { CreatePlatformApiKey, CreatePlatformOrganization, PlatformOrgIdParam, PlatformOrganization };
+//# sourceMappingURL=platform.d.ts.map

package/dist/http/schemas/platform.js

@@ -0,0 +1,19 @@
+import { Organization } from "./organizations.js";
+import { ApiKeyName, CreatedApiKey } from "./access.js";
+import { z } from "zod";
+//#region src/http/schemas/platform.ts
+const CreatePlatformOrganization = z.object({
+	name: z.string().trim().min(1).max(100),
+	slug: z.string().min(1).max(50).regex(/^[a-z0-9-]+$/, "Use lowercase letters, numbers, and hyphens only"),
+	keyName: ApiKeyName.optional().describe("The name of the API key created with it. Default `Platform`")
+});
+const PlatformOrganization = z.object({
+	organization: Organization,
+	apiKey: CreatedApiKey
+});
+const CreatePlatformApiKey = z.object({ name: ApiKeyName });
+const PlatformOrgIdParam = z.object({ orgId: z.string() });
+//#endregion
+export { CreatePlatformApiKey, CreatePlatformOrganization, PlatformOrgIdParam, PlatformOrganization };
+
+//# sourceMappingURL=platform.js.map

package/dist/http/schemas/platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.js","names":[],"sources":["../../../src/http/schemas/platform.ts"],"sourcesContent":["import { z } from 'zod';\nimport { ApiKeyName, CreatedApiKey } from './access.js';\nimport { Organization } from './organizations.js';\n\nexport const CreatePlatformOrganization = z.object({\n  name: z.string().trim().min(1).max(100),\n  slug: z\n    .string()\n    .min(1)\n    .max(50)\n    .regex(/^[a-z0-9-]+$/, 'Use lowercase letters, numbers, and hyphens only'),\n  keyName: ApiKeyName.optional().describe(\n    'The name of the API key created with it. Default `Platform`',\n  ),\n});\n\nexport const PlatformOrganization = z.object({\n  organization: Organization,\n  apiKey: CreatedApiKey,\n});\n\nexport const CreatePlatformApiKey = z.object({ name: ApiKeyName });\n\nexport const PlatformOrgIdParam = z.object({ orgId: z.string() });\n"],"mappings":";;;;AAIA,MAAa,6BAA6B,EAAE,OAAO;CACjD,MAAM,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG;CACtC,MAAM,EACH,OAAO,CAAC,CACR,IAAI,CAAC,CAAC,CACN,IAAI,EAAE,CAAC,CACP,MAAM,gBAAgB,kDAAkD;CAC3E,SAAS,WAAW,SAAS,CAAC,CAAC,SAC7B,6DACF;AACF,CAAC;AAED,MAAa,uBAAuB,EAAE,OAAO;CAC3C,cAAc;CACd,QAAQ;AACV,CAAC;AAED,MAAa,uBAAuB,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEjE,MAAa,qBAAqB,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/http/schemas/posts.d.ts

@@ -27,6 +27,17 @@ declare const PostView: z.ZodObject<{
   createdAt: z.ZodCoercedDate<unknown>;
   updatedAt: z.ZodCoercedDate<unknown>;
   coverUrl: z.ZodNullable<z.ZodString>;
+  assets: z.ZodRecord<z.ZodString, z.ZodObject<{
+    url: z.ZodString;
+    kind: z.ZodEnum<{
+      image: "image";
+      video: "video";
+      audio: "audio";
+      document: "document";
+    }>;
+    filename: z.ZodString;
+    size: z.ZodNumber;
+  }, z.core.$strict>>;
   author: z.ZodObject<{
     id: z.ZodString;
     firstName: z.ZodNullable<z.ZodString>;
@@ -36,19 +47,24 @@ declare const PostView: z.ZodObject<{
     image: z.ZodNullable<z.ZodString>;
     imageAssetId: z.ZodNullable<z.ZodString>;
     imageUrl: z.ZodNullable<z.ZodString>;
-    role: z.ZodEnum<{
-      owner: "owner";
-      admin: "admin";
-      instructor: "instructor";
-      moderator: "moderator";
-      student: "student";
-    }>;
+    team: z.ZodBoolean;
+    roleName: z.ZodNullable<z.ZodString>;
   }, z.core.$strict>;
   reactions: z.ZodRecord<z.ZodString, z.ZodNumber>;
   viewerReaction: z.ZodNullable<z.ZodString>;
   commentCount: z.ZodNumber;
-  following: z.ZodBoolean;
+  subscription: z.ZodNullable<z.ZodObject<{
+    state: z.ZodEnum<{
+      following: "following";
+      muted: "muted";
+    }>;
+    mutedUntil: z.ZodNullable<z.ZodCoercedDate<unknown>>;
+  }, z.core.$strict>>;
   bookmarked: z.ZodBoolean;
+  mentions: z.ZodArray<z.ZodObject<{
+    orgUserId: z.ZodString;
+    name: z.ZodString;
+  }, z.core.$strict>>;
 }, z.core.$strict>;
 declare const PostFlag: z.ZodObject<{
   orgId: z.ZodString;
@@ -93,6 +109,17 @@ declare const PostFeedPage: z.ZodObject<{
     createdAt: z.ZodCoercedDate<unknown>;
     updatedAt: z.ZodCoercedDate<unknown>;
     coverUrl: z.ZodNullable<z.ZodString>;
+    assets: z.ZodRecord<z.ZodString, z.ZodObject<{
+      url: z.ZodString;
+      kind: z.ZodEnum<{
+        image: "image";
+        video: "video";
+        audio: "audio";
+        document: "document";
+      }>;
+      filename: z.ZodString;
+      size: z.ZodNumber;
+    }, z.core.$strict>>;
     author: z.ZodObject<{
       id: z.ZodString;
       firstName: z.ZodNullable<z.ZodString>;
@@ -102,19 +129,24 @@ declare const PostFeedPage: z.ZodObject<{
       image: z.ZodNullable<z.ZodString>;
       imageAssetId: z.ZodNullable<z.ZodString>;
       imageUrl: z.ZodNullable<z.ZodString>;
-      role: z.ZodEnum<{
-        owner: "owner";
-        admin: "admin";
-        instructor: "instructor";
-        moderator: "moderator";
-        student: "student";
-      }>;
+      team: z.ZodBoolean;
+      roleName: z.ZodNullable<z.ZodString>;
     }, z.core.$strict>;
     reactions: z.ZodRecord<z.ZodString, z.ZodNumber>;
     viewerReaction: z.ZodNullable<z.ZodString>;
     commentCount: z.ZodNumber;
-    following: z.ZodBoolean;
+    subscription: z.ZodNullable<z.ZodObject<{
+      state: z.ZodEnum<{
+        following: "following";
+        muted: "muted";
+      }>;
+      mutedUntil: z.ZodNullable<z.ZodCoercedDate<unknown>>;
+    }, z.core.$strict>>;
     bookmarked: z.ZodBoolean;
+    mentions: z.ZodArray<z.ZodObject<{
+      orgUserId: z.ZodString;
+      name: z.ZodString;
+    }, z.core.$strict>>;
   }, z.core.$strict>>;
   total: z.ZodNumber;
   page: z.ZodNumber;
@@ -190,6 +222,17 @@ declare const SpaceQueue: z.ZodObject<{
     createdAt: z.ZodCoercedDate<unknown>;
     updatedAt: z.ZodCoercedDate<unknown>;
     coverUrl: z.ZodNullable<z.ZodString>;
+    assets: z.ZodRecord<z.ZodString, z.ZodObject<{
+      url: z.ZodString;
+      kind: z.ZodEnum<{
+        image: "image";
+        video: "video";
+        audio: "audio";
+        document: "document";
+      }>;
+      filename: z.ZodString;
+      size: z.ZodNumber;
+    }, z.core.$strict>>;
     author: z.ZodObject<{
       id: z.ZodString;
       firstName: z.ZodNullable<z.ZodString>;
@@ -199,19 +242,24 @@ declare const SpaceQueue: z.ZodObject<{
       image: z.ZodNullable<z.ZodString>;
       imageAssetId: z.ZodNullable<z.ZodString>;
       imageUrl: z.ZodNullable<z.ZodString>;
-      role: z.ZodEnum<{
-        owner: "owner";
-        admin: "admin";
-        instructor: "instructor";
-        moderator: "moderator";
-        student: "student";
-      }>;
+      team: z.ZodBoolean;
+      roleName: z.ZodNullable<z.ZodString>;
     }, z.core.$strict>;
     reactions: z.ZodRecord<z.ZodString, z.ZodNumber>;
     viewerReaction: z.ZodNullable<z.ZodString>;
     commentCount: z.ZodNumber;
-    following: z.ZodBoolean;
+    subscription: z.ZodNullable<z.ZodObject<{
+      state: z.ZodEnum<{
+        following: "following";
+        muted: "muted";
+      }>;
+      mutedUntil: z.ZodNullable<z.ZodCoercedDate<unknown>>;
+    }, z.core.$strict>>;
     bookmarked: z.ZodBoolean;
+    mentions: z.ZodArray<z.ZodObject<{
+      orgUserId: z.ZodString;
+      name: z.ZodString;
+    }, z.core.$strict>>;
   }, z.core.$strict>>;
   flags: z.ZodArray<z.ZodObject<{
     orgId: z.ZodString;
@@ -252,6 +300,18 @@ declare const SpaceQueue: z.ZodObject<{
         published: "published";
         removed: "removed";
       }>;
+      author: z.ZodObject<{
+        id: z.ZodString;
+        firstName: z.ZodNullable<z.ZodString>;
+        lastName: z.ZodNullable<z.ZodString>;
+        displayName: z.ZodNullable<z.ZodString>;
+        headline: z.ZodNullable<z.ZodString>;
+        image: z.ZodNullable<z.ZodString>;
+        imageAssetId: z.ZodNullable<z.ZodString>;
+        imageUrl: z.ZodNullable<z.ZodString>;
+        team: z.ZodBoolean;
+        roleName: z.ZodNullable<z.ZodString>;
+      }, z.core.$strict>;
     }, z.core.$strict>;
   }, z.core.$strict>>;
 }, z.core.$strip>;
@@ -271,13 +331,8 @@ declare const PostCommentsPage: z.ZodObject<{
       image: z.ZodNullable<z.ZodString>;
       imageAssetId: z.ZodNullable<z.ZodString>;
       imageUrl: z.ZodNullable<z.ZodString>;
-      role: z.ZodEnum<{
-        owner: "owner";
-        admin: "admin";
-        instructor: "instructor";
-        moderator: "moderator";
-        student: "student";
-      }>;
+      team: z.ZodBoolean;
+      roleName: z.ZodNullable<z.ZodString>;
     }, z.core.$strict>;
     body: z.ZodNullable<z.ZodString>;
     status: z.ZodEnum<{
@@ -294,16 +349,15 @@ declare const PostCommentsPage: z.ZodObject<{
       image: z.ZodNullable<z.ZodString>;
       imageAssetId: z.ZodNullable<z.ZodString>;
       imageUrl: z.ZodNullable<z.ZodString>;
-      role: z.ZodEnum<{
-        owner: "owner";
-        admin: "admin";
-        instructor: "instructor";
-        moderator: "moderator";
-        student: "student";
-      }>;
+      team: z.ZodBoolean;
+      roleName: z.ZodNullable<z.ZodString>;
     }, z.core.$strict>>;
     reactions: z.ZodRecord<z.ZodString, z.ZodNumber>;
     viewerReaction: z.ZodOptional<z.ZodString>;
+    mentions: z.ZodArray<z.ZodObject<{
+      orgUserId: z.ZodString;
+      name: z.ZodString;
+    }, z.core.$strict>>;
     createdAt: z.ZodCoercedDate<unknown>;
     updatedAt: z.ZodCoercedDate<unknown>;
   }, z.core.$strict>>;

package/dist/http/schemas/posts.js

@@ -1,7 +1,7 @@
 import { DateTimeInput, PageQuery, paginated } from "./shared.js";
 import { CommentView } from "./discussion.js";
 import { z } from "zod";
-import { boundedJsonSchema, flaggedCommentSchema, idSchema, postFlagResolutionSchema, postFlagSchema, postViewSchema } from "@headless-lms/core/schemas";
+import { boundedJsonSchema, flaggedCommentViewSchema, idSchema, postFlagResolutionSchema, postFlagSchema, postViewSchema } from "@headless-lms/core/schemas";
 //#region src/http/schemas/posts.ts
 const PostView = postViewSchema;
 const PostFlag = postFlagSchema;
@@ -9,7 +9,7 @@ const PostFeedPage = paginated(PostView);
 const PostIdParam = z.object({ postId: z.string() });
 const FeedQuery = PageQuery.extend({ topicId: z.string().optional().describe("Only posts under this topic") }).strict();
 const PostTitle = z.string().trim().min(1).max(200);
-const PostBody = z.string().max(5e4);
+const PostBody = z.string().max(5e4).describe("The post's text, in the installation's body format (plain text unless the installation sets one). Mention a member with `<@orgUserId>`.");
 const PostExtra = boundedJsonSchema(16 * 1024);
 const CreatePost = z.object({
 	title: PostTitle,
@@ -21,7 +21,7 @@ const CreatePost = z.object({
 		"draft",
 		"submit",
 		"schedule"
-	]).describe("`draft` keeps the post to yourself. `submit` publishes it, or holds it for review when the space requires review and you are not staff. `schedule` submits it at `scheduledAt`."),
+	]).describe("`draft` keeps the post to yourself. `submit` publishes it, or holds it for review when the space requires review and you do not moderate the community. `schedule` submits it at `scheduledAt`."),
 	scheduledAt: DateTimeInput.nullable().describe("When a scheduled post is submitted. Required, and in the future, when `mode` is `schedule`; ignored otherwise.")
 }).strict();
 const UpdatePost = z.object({
@@ -38,7 +38,7 @@ const ResolvePostFlags = z.object({ resolution: postFlagResolutionSchema.extract
 const SpaceQueue = z.object({
 	pending: z.array(PostView),
 	flags: z.array(PostFlag),
-	commentFlags: z.array(flaggedCommentSchema)
+	commentFlags: z.array(flaggedCommentViewSchema)
 });
 const PostCommentsPage = paginated(CommentView);
 //#endregion

package/dist/http/schemas/posts.js.map

@@ -1 +1 @@
-{"version":3,"file":"posts.js","names":[],"sources":["../../../src/http/schemas/posts.ts"],"sourcesContent":["import { z } from 'zod';\nimport {\n  boundedJsonSchema,\n  flaggedCommentSchema,\n  idSchema,\n  postFlagResolutionSchema,\n  postFlagSchema,\n  postViewSchema,\n} from '@headless-lms/core/schemas';\nimport { CommentView } from './discussion.js';\nimport { DateTimeInput, PageQuery, paginated } from './shared.js';\n\nexport const PostView = postViewSchema;\nexport const PostFlag = postFlagSchema;\nexport const PostFeedPage = paginated(PostView);\nexport const PostIdParam = z.object({ postId: z.string() });\nexport const FeedQuery = PageQuery.extend({\n  topicId: z.string().optional().describe('Only posts under this topic'),\n}).strict();\n\nconst PostTitle = z.string().trim().min(1).max(200);\nconst PostBody = z.string().max(50_000);\nconst PostExtra = boundedJsonSchema(16 * 1024);\n\nexport const CreatePost = z\n  .object({\n    title: PostTitle,\n    body: PostBody,\n    topicId: idSchema\n      .nullable()\n      .describe(\"One of the space's topics. Required when the space has topics, else null\"),\n    extra: PostExtra.default({}),\n    coverAssetId: idSchema\n      .nullable()\n      .describe('A finalized image you uploaded through `requestMemberUpload`'),\n    mode: z\n      .enum(['draft', 'submit', 'schedule'])\n      .describe(\n        '`draft` keeps the post to yourself. `submit` publishes it, or holds it for review when the space requires review and you are not staff. `schedule` submits it at `scheduledAt`.',\n      ),\n    scheduledAt: DateTimeInput.nullable().describe(\n      'When a scheduled post is submitted. Required, and in the future, when `mode` is `schedule`; ignored otherwise.',\n    ),\n  })\n  .strict();\n\nexport const UpdatePost = z\n  .object({\n    title: PostTitle.optional(),\n    body: PostBody.optional(),\n    topicId: idSchema.nullable().optional(),\n    extra: PostExtra.optional(),\n    coverAssetId: idSchema.nullable().optional(),\n  })\n  .strict();\n\nexport const SchedulePost = z\n  .object({\n    scheduledAt: DateTimeInput.describe('When the post is submitted; must be in the future'),\n  })\n  .strict();\nexport const SetPostReactions = z\n  .object({ enabled: z.boolean().describe('Whether readers may react to this post') })\n  .strict();\nexport const FlagReason = z.object({ reason: z.string().trim().min(1).max(1_000) }).strict();\nexport const ResolvePostFlags = z\n  .object({\n    resolution: postFlagResolutionSchema\n      .extract(['dismissed'])\n      .describe(\n        '`dismissed` closes the open flags and leaves the post up. Removing the post resolves its flags as `removed` instead.',\n      ),\n  })\n  .strict();\n\nexport const SpaceQueue = z.object({\n  pending: z.array(PostView),\n  flags: z.array(PostFlag),\n  commentFlags: z.array(flaggedCommentSchema),\n});\n\nexport const PostCommentsPage = paginated(CommentView);\n"],"mappings":";;;;;AAYA,MAAa,WAAW;AACxB,MAAa,WAAW;AACxB,MAAa,eAAe,UAAU,QAAQ;AAC9C,MAAa,cAAc,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AAC1D,MAAa,YAAY,UAAU,OAAO,EACxC,SAAS,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,6BAA6B,EACvE,CAAC,CAAC,CAAC,OAAO;AAEV,MAAM,YAAY,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG;AAClD,MAAM,WAAW,EAAE,OAAO,CAAC,CAAC,IAAI,GAAM;AACtC,MAAM,YAAY,kBAAkB,KAAK,IAAI;AAE7C,MAAa,aAAa,EACvB,OAAO;CACN,OAAO;CACP,MAAM;CACN,SAAS,SACN,SAAS,CAAC,CACV,SAAS,0EAA0E;CACtF,OAAO,UAAU,QAAQ,CAAC,CAAC;CAC3B,cAAc,SACX,SAAS,CAAC,CACV,SAAS,8DAA8D;CAC1E,MAAM,EACH,KAAK;EAAC;EAAS;EAAU;CAAU,CAAC,CAAC,CACrC,SACC,iLACF;CACF,aAAa,cAAc,SAAS,CAAC,CAAC,SACpC,gHACF;AACF,CAAC,CAAC,CACD,OAAO;AAEV,MAAa,aAAa,EACvB,OAAO;CACN,OAAO,UAAU,SAAS;CAC1B,MAAM,SAAS,SAAS;CACxB,SAAS,SAAS,SAAS,CAAC,CAAC,SAAS;CACtC,OAAO,UAAU,SAAS;CAC1B,cAAc,SAAS,SAAS,CAAC,CAAC,SAAS;AAC7C,CAAC,CAAC,CACD,OAAO;AAEV,MAAa,eAAe,EACzB,OAAO,EACN,aAAa,cAAc,SAAS,mDAAmD,EACzF,CAAC,CAAC,CACD,OAAO;AACV,MAAa,mBAAmB,EAC7B,OAAO,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,SAAS,wCAAwC,EAAE,CAAC,CAAC,CACnF,OAAO;AACV,MAAa,aAAa,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAK,EAAE,CAAC,CAAC,CAAC,OAAO;AAC3F,MAAa,mBAAmB,EAC7B,OAAO,EACN,YAAY,yBACT,QAAQ,CAAC,WAAW,CAAC,CAAC,CACtB,SACC,sHACF,EACJ,CAAC,CAAC,CACD,OAAO;AAEV,MAAa,aAAa,EAAE,OAAO;CACjC,SAAS,EAAE,MAAM,QAAQ;CACzB,OAAO,EAAE,MAAM,QAAQ;CACvB,cAAc,EAAE,MAAM,oBAAoB;AAC5C,CAAC;AAED,MAAa,mBAAmB,UAAU,WAAW"}
+{"version":3,"file":"posts.js","names":[],"sources":["../../../src/http/schemas/posts.ts"],"sourcesContent":["import { z } from 'zod';\nimport {\n  boundedJsonSchema,\n  flaggedCommentViewSchema,\n  idSchema,\n  postFlagResolutionSchema,\n  postFlagSchema,\n  postViewSchema,\n} from '@headless-lms/core/schemas';\nimport { CommentView } from './discussion.js';\nimport { DateTimeInput, PageQuery, paginated } from './shared.js';\n\nexport const PostView = postViewSchema;\nexport const PostFlag = postFlagSchema;\nexport const PostFeedPage = paginated(PostView);\nexport const PostIdParam = z.object({ postId: z.string() });\nexport const FeedQuery = PageQuery.extend({\n  topicId: z.string().optional().describe('Only posts under this topic'),\n}).strict();\n\nconst PostTitle = z.string().trim().min(1).max(200);\nconst PostBody = z\n  .string()\n  .max(50_000)\n  .describe(\n    \"The post's text, in the installation's body format (plain text unless the installation sets one). Mention a member with `<@orgUserId>`.\",\n  );\nconst PostExtra = boundedJsonSchema(16 * 1024);\n\nexport const CreatePost = z\n  .object({\n    title: PostTitle,\n    body: PostBody,\n    topicId: idSchema\n      .nullable()\n      .describe(\"One of the space's topics. Required when the space has topics, else null\"),\n    extra: PostExtra.default({}),\n    coverAssetId: idSchema\n      .nullable()\n      .describe('A finalized image you uploaded through `requestMemberUpload`'),\n    mode: z\n      .enum(['draft', 'submit', 'schedule'])\n      .describe(\n        '`draft` keeps the post to yourself. `submit` publishes it, or holds it for review when the space requires review and you do not moderate the community. `schedule` submits it at `scheduledAt`.',\n      ),\n    scheduledAt: DateTimeInput.nullable().describe(\n      'When a scheduled post is submitted. Required, and in the future, when `mode` is `schedule`; ignored otherwise.',\n    ),\n  })\n  .strict();\n\nexport const UpdatePost = z\n  .object({\n    title: PostTitle.optional(),\n    body: PostBody.optional(),\n    topicId: idSchema.nullable().optional(),\n    extra: PostExtra.optional(),\n    coverAssetId: idSchema.nullable().optional(),\n  })\n  .strict();\n\nexport const SchedulePost = z\n  .object({\n    scheduledAt: DateTimeInput.describe('When the post is submitted; must be in the future'),\n  })\n  .strict();\nexport const SetPostReactions = z\n  .object({ enabled: z.boolean().describe('Whether readers may react to this post') })\n  .strict();\nexport const FlagReason = z.object({ reason: z.string().trim().min(1).max(1_000) }).strict();\nexport const ResolvePostFlags = z\n  .object({\n    resolution: postFlagResolutionSchema\n      .extract(['dismissed'])\n      .describe(\n        '`dismissed` closes the open flags and leaves the post up. Removing the post resolves its flags as `removed` instead.',\n      ),\n  })\n  .strict();\n\nexport const SpaceQueue = z.object({\n  pending: z.array(PostView),\n  flags: z.array(PostFlag),\n  commentFlags: z.array(flaggedCommentViewSchema),\n});\n\nexport const PostCommentsPage = paginated(CommentView);\n"],"mappings":";;;;;AAYA,MAAa,WAAW;AACxB,MAAa,WAAW;AACxB,MAAa,eAAe,UAAU,QAAQ;AAC9C,MAAa,cAAc,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AAC1D,MAAa,YAAY,UAAU,OAAO,EACxC,SAAS,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,6BAA6B,EACvE,CAAC,CAAC,CAAC,OAAO;AAEV,MAAM,YAAY,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG;AAClD,MAAM,WAAW,EACd,OAAO,CAAC,CACR,IAAI,GAAM,CAAC,CACX,SACC,yIACF;AACF,MAAM,YAAY,kBAAkB,KAAK,IAAI;AAE7C,MAAa,aAAa,EACvB,OAAO;CACN,OAAO;CACP,MAAM;CACN,SAAS,SACN,SAAS,CAAC,CACV,SAAS,0EAA0E;CACtF,OAAO,UAAU,QAAQ,CAAC,CAAC;CAC3B,cAAc,SACX,SAAS,CAAC,CACV,SAAS,8DAA8D;CAC1E,MAAM,EACH,KAAK;EAAC;EAAS;EAAU;CAAU,CAAC,CAAC,CACrC,SACC,iMACF;CACF,aAAa,cAAc,SAAS,CAAC,CAAC,SACpC,gHACF;AACF,CAAC,CAAC,CACD,OAAO;AAEV,MAAa,aAAa,EACvB,OAAO;CACN,OAAO,UAAU,SAAS;CAC1B,MAAM,SAAS,SAAS;CACxB,SAAS,SAAS,SAAS,CAAC,CAAC,SAAS;CACtC,OAAO,UAAU,SAAS;CAC1B,cAAc,SAAS,SAAS,CAAC,CAAC,SAAS;AAC7C,CAAC,CAAC,CACD,OAAO;AAEV,MAAa,eAAe,EACzB,OAAO,EACN,aAAa,cAAc,SAAS,mDAAmD,EACzF,CAAC,CAAC,CACD,OAAO;AACV,MAAa,mBAAmB,EAC7B,OAAO,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,SAAS,wCAAwC,EAAE,CAAC,CAAC,CACnF,OAAO;AACV,MAAa,aAAa,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAK,EAAE,CAAC,CAAC,CAAC,OAAO;AAC3F,MAAa,mBAAmB,EAC7B,OAAO,EACN,YAAY,yBACT,QAAQ,CAAC,WAAW,CAAC,CAAC,CACtB,SACC,sHACF,EACJ,CAAC,CAAC,CACD,OAAO;AAEV,MAAa,aAAa,EAAE,OAAO;CACjC,SAAS,EAAE,MAAM,QAAQ;CACzB,OAAO,EAAE,MAAM,QAAQ;CACvB,cAAc,EAAE,MAAM,wBAAwB;AAChD,CAAC;AAED,MAAa,mBAAmB,UAAU,WAAW"}

package/dist/http/schemas/profile.d.ts

@@ -8,8 +8,8 @@ declare const UserProfile: z.ZodObject<{
   imageAssetId: z.ZodNullable<z.ZodString>;
   imageUrl: z.ZodNullable<z.ZodString>;
   bio: z.ZodNullable<z.ZodString>;
-  userId: z.ZodString;
   extra: z.ZodType<import("@headless-lms/core/types").JsonValue, unknown, z.core.$ZodTypeInternals<import("@headless-lms/core/types").JsonValue, unknown>>;
+  userId: z.ZodString;
 }, z.core.$strip>;
 declare const UpdateProfile: z.ZodObject<{
   displayName: z.ZodOptional<z.ZodNullable<z.ZodString>>;

package/dist/http/schemas/shared.d.ts

@@ -20,8 +20,15 @@ declare const ValidationErrorBody: z.ZodObject<{
   }, z.core.$strip>>>;
 }, z.core.$strip>;
 type ValidationErrorBody = z.infer<typeof ValidationErrorBody>;
-type RefusalStatus = 400 | 403 | 404 | 409 | 413 | 415 | 502;
-type RefusalBodies<S extends RefusalStatus> = { [K in S]: K extends 400 ? typeof ValidationErrorBody : typeof ErrorBody; };
+declare const UnavailableErrorBody: z.ZodObject<{
+  error: z.ZodString;
+  message: z.ZodOptional<z.ZodString>;
+  requestId: z.ZodOptional<z.ZodString>;
+  details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>;
+type UnavailableErrorBody = z.infer<typeof UnavailableErrorBody>;
+type RefusalStatus = 400 | 403 | 404 | 409 | 413 | 415 | 422 | 502 | 503;
+type RefusalBodies<S extends RefusalStatus> = { [K in S]: K extends 400 | 422 ? typeof ValidationErrorBody : K extends 503 ? typeof UnavailableErrorBody : typeof ErrorBody; };
 /** Response schemas for the refusals a route can answer. A 400 keeps the validation `issues`. */
 declare function refusals<S extends RefusalStatus>(...statuses: S[]): RefusalBodies<S>;
 /** An RFC 3339 date-time in a request, such as `2026-10-29T12:00:00Z`, read as a Date. */
@@ -50,16 +57,6 @@ declare function paginated<T extends z.ZodTypeAny>(row: T): z.ZodObject<{
   page: z.ZodNumber;
   pageSize: z.ZodNumber;
 }, z.core.$strip>;
-/** All four org roles. `members.ts` exports a staff-only three-value `Role`;
- *  this is the full set, used wherever a learner can also appear. */
-declare const OrgRole: z.ZodEnum<{
-  owner: "owner";
-  admin: "admin";
-  instructor: "instructor";
-  moderator: "moderator";
-  student: "student";
-}>;
-type OrgRole = z.infer<typeof OrgRole>;
 /** Mirrors UserProfile in @headless-lms/core/types — keyed on the auth user id. */
 declare const UserProfileSchema: z.ZodObject<{
   id: z.ZodString;
@@ -78,5 +75,5 @@ declare const OrgUserProfileSchema: z.ZodObject<{
 }, z.core.$strip>;
 type OrgUserProfileSchema = z.infer<typeof OrgUserProfileSchema>;
 //#endregion
-export { DateTimeInput, ErrorBody, ListQuery, Matches, OrgRole, OrgUserProfileSchema, PageQuery, UserProfileSchema, ValidationErrorBody, paginated, refusals };
+export { DateTimeInput, ErrorBody, ListQuery, Matches, OrgUserProfileSchema, PageQuery, UnavailableErrorBody, UserProfileSchema, ValidationErrorBody, paginated, refusals };
 //# sourceMappingURL=shared.d.ts.map