@crossworks/client-types 0.300.5 → 0.300.8

package/package.json

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

package/src/dto/member-apps.ts

@@ -77,6 +77,29 @@ export type MemberHomeApp = {
 export type MemberHomeData<THub = unknown> =
   { homeApp: MemberHomeApp; hub: THub } | { homeApp: null; hub: null };
 
+/**
+ * GET /api/home?ws=<id>: the landing page of a workspace, for every login
+ * (task d78e7bde). Without `ws` it is "All my workspaces": the Built-in
+ * home over every workspace of the login, never a home app.
+ *
+ * `ws` echoes the workspace asked for (null: all). `homeApp` is the
+ * workspace's home app when the workspace still holds it, its published
+ * build is green and the login may run it; null means the Built-in home.
+ * `hub` is always there: the data of the Built-in home and what a home
+ * app's `host.hub.get()` answers, read in the login's scope and kept to
+ * what the workspace reads (sections are its newest pages, counts its items
+ * per kind, apps the other apps it holds that the login may run). A
+ * workspace the login may not name is 404 `{ error, code: 'not_found' }`.
+ *
+ * `THub` is `HubData` from `@mantle/share-ui/app-bridge-protocol` (see
+ * MemberHomeData).
+ */
+export type WorkspaceHomeData<THub = unknown> = {
+  ws: string | null;
+  homeApp: MemberHomeApp | null;
+  hub: THub;
+};
+
 // ── Admin: member chats ──────────────────────────────────────────────────
 
 /** GET /api/team-admin/member-chats: one member login and its chat. */

package/src/dto/rows.ts

@@ -184,7 +184,8 @@ export type AppRow = {
    * has never been shared / the share is revoked (owner-only).
    */
   shareMode: ShareMode | null;
-  /** Whether this app is the designated Team Hub (prefs.teamHubAppId). */
+  /** Whether this app is the home app of a workspace the reader sees (its
+   *  landing page, set on the workspace screen; task d78e7bde). */
   isHub: boolean;
   /** A live open public link exists (not revoked, not expired): the
    *  "Public" pill. Absent from a brain before W5b2. */
@@ -567,11 +568,10 @@ export type ProfilePreferences = {
    *  group grant, so the switch can't be bypassed by a manifest change. Flip it
    *  from the Team admin surface. */
   teamPrivateReads?: boolean;
-  /** Node id of the mini-app designated as the members' HOME APP (the name
-   *  is from the retired /team hub). A member login's home renders it
-   *  full-bleed while it has a green published build and is at a level
-   *  members may run (`resolveMemberHomeApp`, member-apps.ts); the built-in
-   *  member home is the fallback. No share link is involved. Read via
+  /** RETIRED (task d78e7bde, migration 0276): the brain-wide members' home
+   *  app. 0276 made it the Team workspace's home app
+   *  (workspaces.landing_app_id); nothing reads it any more. It stays in
+   *  the stored preferences so a rollback finds it. Read via
    *  projectTeamHubAppId, never raw. */
   teamHubAppId?: string;
   /** The email account client sign-in codes are sent from (client logins

package/src/dto/workspaces.ts

@@ -92,16 +92,38 @@ export type WorkspaceDetailResponse = {
   /** The assistant has history (threads or messages): it cannot be swapped
    *  or removed, only cloned to use elsewhere. */
   hasHistory: boolean;
+  /** The workspace's landing page (task d78e7bde): its home app, or null
+   *  for the Built-in home. Absent from an older brain. */
+  landingApp?: WorkspaceLandingApp | null;
+};
+
+/**
+ * A workspace's home app, as its screen shows it. `held`: the workspace
+ * still holds the app; false is a pointer left from before (the landing
+ * page shows the Built-in home), with no id or title: only a clear
+ * (`landingAppId: null`) makes sense then. `appId` and `title` are named
+ * only to a user of the workspace (an Admin user outside it gets null for
+ * both). `ready`: a green published build, so the landing page shows it.
+ */
+export type WorkspaceLandingApp = {
+  held: boolean;
+  appId: string | null;
+  title: string | null;
+  ready: boolean;
 };
 
 /** PATCH /api/workspaces/:id. Name and description: a Moderator or an Admin
  *  user. Contact and assistant: an Admin user (assistant: area
- *  'assistants'). `null` clears. Answers the updated Workspace. */
+ *  'assistants'). The landing page (`landingAppId`): a Moderator of this
+ *  workspace only, to an app the workspace holds with a green published
+ *  build (409 `landing_app_not_held` or `landing_app_not_ready`). `null`
+ *  clears (the Built-in home). Answers the updated Workspace. */
 export type WorkspacePatchBody = {
   name?: string;
   description?: string;
   contactNodeId?: string | null;
   assistantId?: string | null;
+  landingAppId?: string | null;
 };
 
 /** GET /api/workspaces/:id/archive-preview: what archiving would do.
@@ -203,6 +225,8 @@ export type WorkspaceErrorCode =
   | 'assistant_has_history'
   | 'assistant_in_use'
   | 'resource_exists'
+  | 'landing_app_not_held'
+  | 'landing_app_not_ready'
   | 'rate_limited';
 
 export type WorkspaceError = { error: string; code: WorkspaceErrorCode };

package/src/index.ts

@@ -94,6 +94,7 @@ export type {
   MemberChatsResponse,
   MemberHomeApp,
   MemberHomeData,
+  WorkspaceHomeData,
 } from './dto/member-apps';
 export type {
   MemberInviteAccepted,
@@ -192,6 +193,7 @@ export type {
   WorkspaceDetailResponse,
   WorkspaceError,
   WorkspaceErrorCode,
+  WorkspaceLandingApp,
   WorkspaceListResponse,
   WorkspacePatchBody,
   WorkspaceResource,