@crossworks/client-types 0.232.288 → 0.232.289

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crossworks/client-types",
-  "version": "0.232.288",
+  "version": "0.232.289",
   "type": "module",
   "main": "./src/index.ts",
   "types": "./src/index.ts",

package/src/dto/member-apps.ts

@@ -0,0 +1,83 @@
+/**
+ * Apps for members (member logins Phase 4b): what a MEMBER login's client
+ * reads from /api/member/apps and /api/member/home, plus the admin's view of
+ * member chats (/api/team-admin/member-chats). A member RUNS apps at team
+ * level or lower with a green published build; it never creates, edits or
+ * shares one.
+ */
+import type { AppTint } from '../app-nav';
+import type { AccessLevel } from './access';
+
+/** The app levels a member may run: team and below (never admin). */
+export type MemberAppLevel = Exclude<AccessLevel, 'admin'>;
+
+/** One launcher card (GET /api/member/apps). */
+export type MemberAppCard = {
+  id: string;
+  title: string;
+  icon: string | null;
+  color: AppTint | null;
+  description: string | null;
+  audience: MemberAppLevel;
+  updatedAt: string;
+};
+
+/** GET /api/member/apps: the apps a member may run, by title, and the
+ *  brain's home app when a member may run it (else null). */
+export type MemberAppList = { apps: MemberAppCard[]; homeAppId: string | null };
+
+/** The brain's pinned home app, when a member may run it. */
+export type MemberHomeApp = {
+  appId: string;
+  title: string;
+  icon: string | null;
+  color: AppTint | null;
+};
+
+/**
+ * GET /api/member/home: the pinned home app (null = the built-in home, and
+ * then `hub` is null too) and what its `host.hub.get()` answers. A section's
+ * token is a page id; an app card's token is an app id.
+ *
+ * `THub` is the hub payload, `HubData` from
+ * `@mantle/share-ui/app-bridge-protocol`. The contract leaves it to the
+ * client (share-ui depends on this package, so it cannot be named here):
+ * write `MemberHomeData<HubData>`.
+ */
+export type MemberHomeData<THub = unknown> =
+  { homeApp: MemberHomeApp; hub: THub } | { homeApp: null; hub: null };
+
+// ── Admin: member chats ──────────────────────────────────────────────────
+
+/** GET /api/team-admin/member-chats: one member login and its chat. */
+export type MemberChatRow = {
+  loginId: string;
+  /** Display name, else the part of the email before the @. */
+  name: string;
+  email: string;
+  /** False when the login is disabled or no longer a member (its old
+   *  thread still shows). */
+  active: boolean;
+  lastMessageAt: string | null;
+  lastMessageText: string | null;
+  lastMessageDirection: 'inbound' | 'outbound' | null;
+  messageCount: number;
+};
+
+/** One message of a member's thread, as the admin reads it. */
+export type MemberChatArchiveMessage = {
+  id: string;
+  direction: 'inbound' | 'outbound';
+  text: string;
+  status: 'pending' | 'complete' | 'failed';
+  error: string | null;
+  traceId: string | null;
+  createdAt: string;
+};
+
+/** GET /api/team-admin/member-chats?login=&before= : every member login, and
+ *  a window of the selected login's thread (null when there is no login). */
+export type MemberChatsResponse = {
+  members: MemberChatRow[];
+  selected: { loginId: string; thread: MemberChatArchiveMessage[]; windowSize: number } | null;
+};

package/src/index.ts

@@ -60,6 +60,16 @@ export type {
   MemberSpaceList,
   MemberSpaceSharing,
 } from './dto/member';
+export type {
+  MemberAppCard,
+  MemberAppLevel,
+  MemberAppList,
+  MemberChatArchiveMessage,
+  MemberChatRow,
+  MemberChatsResponse,
+  MemberHomeApp,
+  MemberHomeData,
+} from './dto/member-apps';
 export type { MemberItemKind } from './member-kinds';
 
 // Types only at the root; the runtime constants (APP_TINTS, limits) are the