@crossworks/client-types 0.232.281 → 0.232.283

package/package.json

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

package/src/dto/member.ts

@@ -5,6 +5,7 @@
  * its own thread.
  */
 import type { AccessLevel } from './access';
+import type { MemberItemKind } from '../member-kinds';
 
 /** GET /api/member/shell */
 export type MemberShell = {
@@ -30,7 +31,7 @@ export type MemberShell = {
   logoDarkVersion: string | null;
 };
 
-export type MemberLibraryKind = 'page' | 'note' | 'draw' | 'table' | 'file';
+export type MemberLibraryKind = MemberItemKind;
 
 export type MemberLibraryRow = {
   id: string;
@@ -80,3 +81,60 @@ export type MemberChatThread = {
   linked?: boolean;
   messages: MemberChatMessage[];
 };
+
+// ── Personal spaces (member logins Phase 2) ──────────────────────────────
+
+export type MemberSpaceSharing = 'private' | 'team';
+export type MemberReviewState = 'draft' | 'submitted' | 'returned' | 'accepted';
+
+/** One item of a personal space: GET /api/member/space[/team] rows. */
+export type MemberSpaceItemRow = {
+  id: string;
+  type: MemberItemKind;
+  title: string;
+  icon: string | null;
+  sharing: MemberSpaceSharing;
+  reviewState: MemberReviewState;
+  submittedAt: string | null;
+  returnedNote: string | null;
+  /** The login that wrote it (team drafts show whose it is). */
+  authorLoginId: string | null;
+  updatedAt: string;
+};
+
+/** GET /api/member/space?kind=&q=&page= (and /space/team) */
+export type MemberSpaceList = {
+  items: MemberSpaceItemRow[];
+  total: number;
+  page: number;
+  pageSize: number;
+};
+
+/** A space file's metadata; the bytes stream from the item's bytes route. */
+export type MemberSpaceFile = {
+  id: string;
+  filename: string;
+  extension: string;
+  mimeType: string;
+  sizeBytes: number;
+  sha256: string | null;
+};
+
+/**
+ * An item's body. The page, drawing and table shapes are the brain's own
+ * editor models (content-core); the contract leaves them to the client, which
+ * narrows them with `TDoc` / `TTable`.
+ */
+export type MemberSpaceItemBody<TDoc = unknown, TTable = unknown> =
+  | { type: 'page'; page: { doc: TDoc; draft: TDoc | null; draftRev?: number; title: string } }
+  | { type: 'note'; note: { content: string; title: string } }
+  /** Null for a teammate: their drawing shows from its saved SVG route. */
+  | { type: 'draw'; draw: { scene: TDoc; draft: TDoc | null; draftRev?: number } | null }
+  | { type: 'table'; table: TTable }
+  | { type: 'file'; file: MemberSpaceFile };
+
+/** GET /api/member/space/:id (and the team read): the row and its body. */
+export type MemberSpaceItem<TDoc = unknown, TTable = unknown> = {
+  row: MemberSpaceItemRow;
+  body: MemberSpaceItemBody<TDoc, TTable>;
+};

package/src/index.ts

@@ -47,8 +47,16 @@ export type {
   MemberLibraryKind,
   MemberLibraryPage,
   MemberLibraryRow,
+  MemberReviewState,
   MemberShell,
+  MemberSpaceFile,
+  MemberSpaceItem,
+  MemberSpaceItemBody,
+  MemberSpaceItemRow,
+  MemberSpaceList,
+  MemberSpaceSharing,
 } from './dto/member';
+export type { MemberItemKind } from './member-kinds';
 
 // Types only at the root; the runtime constants (APP_TINTS, limits) are the
 // `@mantle/client-types/app-nav` subpath.

package/src/member-kinds.test.ts

@@ -0,0 +1,13 @@
+import { describe, expect, it } from 'vitest';
+import { MEMBER_ITEM_KINDS, isMemberItemKind } from './member-kinds';
+
+describe('member item kinds', () => {
+  it('is the five kinds a space holds and the Library lists', () => {
+    expect([...MEMBER_ITEM_KINDS]).toEqual(['page', 'note', 'draw', 'table', 'file']);
+  });
+
+  it('accepts a kind and refuses anything else', () => {
+    for (const k of MEMBER_ITEM_KINDS) expect(isMemberItemKind(k)).toBe(true);
+    for (const v of ['folder', 'app', 'Page', '', null, 3]) expect(isMemberItemKind(v)).toBe(false);
+  });
+});

package/src/member-kinds.ts

@@ -0,0 +1,12 @@
+/**
+ * The kinds of item a member works with: what a personal space holds and
+ * what the Library lists. The ONE list, for the brain (member-space.ts,
+ * member-library.ts) and the client alike (audit M2); a runtime constant, so
+ * it is the `@mantle/client-types/member-kinds` subpath.
+ */
+export const MEMBER_ITEM_KINDS = ['page', 'note', 'draw', 'table', 'file'] as const;
+export type MemberItemKind = (typeof MEMBER_ITEM_KINDS)[number];
+
+export function isMemberItemKind(v: unknown): v is MemberItemKind {
+  return typeof v === 'string' && (MEMBER_ITEM_KINDS as readonly string[]).includes(v);
+}