@crossworks/client-types 0.232.329 → 0.232.333

package/package.json

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

package/src/dto/access.ts

@@ -33,8 +33,15 @@ export type AccessLinkView = {
 /** GET /api/access/nodes/:id */
 /** Who wrote a brain item, when a member wrote it and an admin accepted it
  *  (member logins Phase 4): the member-authored badge. `name` is the login's
- *  display name ("A member" without one, "Removed member" once deleted). */
-export type MemberItemAuthor = { name: string; acceptedAt: string | null };
+ *  display name ("A member" without one, "A client" for a client without
+ *  one, "Removed member" once deleted). `role` (0.232.333 on) names the
+ *  author's role: show "Client", never "A member", for a client (client
+ *  logins audit B26); null once the login is deleted. */
+export type MemberItemAuthor = {
+  name: string;
+  acceptedAt: string | null;
+  role?: 'member' | 'client' | null;
+};
 
 export type AccessNodeView = {
   item: AccessItemView;

package/src/dto/client.ts

@@ -35,7 +35,9 @@ export type ClientSharedRow = {
   type: MemberItemKind;
   title: string;
   icon: string | null;
-  summary: string | null;
+  /** Never sent since 0.232.333 (it was built from the unredacted text); do
+   *  not show it. Optional only so older clients still compile. */
+  summary?: string | null;
   updatedAt: string;
 };
 
@@ -54,7 +56,7 @@ export type ClientSharedPage = {
 export type ClientSharedItem =
   | (ClientSharedRow & { type: 'page'; doc: unknown })
   | (ClientSharedRow & { type: 'note'; content: string })
-  | (ClientSharedRow & { type: 'table'; table: unknown })
+  | (ClientSharedRow & { type: 'table'; table: ClientSharedTable })
   | (ClientSharedRow & { type: 'draw' })
   | (ClientSharedRow & {
       type: 'file';
@@ -63,6 +65,39 @@ export type ClientSharedItem =
       sizeBytes: number | null;
     });
 
+/** One column of a client table: what the grid draws a header and a cell
+ *  with. No formula, no reference source, no options. */
+export type ClientSharedTableColumn = { id: string; name: string; type: string };
+
+/** One committed row of a client table. A cell that names an item the
+ *  client may not read (`/n/<id>`, `page:`, `media:`, `draw:`, `mention:`)
+ *  arrives as "Private item". */
+export type ClientSharedTableRow = {
+  id: string;
+  cells: Record<string, string | number | boolean | string[] | null>;
+};
+
+/** A client table (GET /api/client/shared/:id, type table): the committed
+ *  grid of one tab and nothing else about the table (no description, tags,
+ *  summary, visibility, level, app link or draft). The shape the member
+ *  reader draws (`data`, `docClipped`, `tabs`, `tabId`), so one viewer reads
+ *  both. `data` is a leading window when `docClipped`; `rowCount` is the
+ *  tab's true total. */
+export type ClientSharedTable = {
+  data: {
+    columns: ClientSharedTableColumn[];
+    rows: ClientSharedTableRow[];
+    /** Footer totals the owner set, by column id. */
+    aggregates?: Record<string, string>;
+  };
+  docClipped?: boolean;
+  /** The workbook's tabs in order (absent for a one-grid table). */
+  tabs?: { id: string; name: string; rows: number; columns: number }[];
+  /** Which tab `data` holds. */
+  tabId?: string | null;
+  rowCount?: number;
+};
+
 /** The label a client sees instead of a reference it may not read. */
 export const CLIENT_PRIVATE_LABEL = 'Private item';
 
@@ -104,7 +139,9 @@ export type ClientLoginCreated = { client: ClientLoginRow };
 
 /** POST /api/team-admin/clients/:id/signin-link -> the link, ONCE. `path` is
  *  the client-app path to hand the client (the code is its only secret);
- *  72 hours, one use. Any older open link of the login is revoked. */
+ *  72 hours, one use. Any older open link of the login is revoked. Since
+ *  0.232.333 the code rides in the fragment (`/client-signin#code=...`), so
+ *  it never reaches a server log; links issued before carry `?code=`. */
 export type ClientSigninLinkCreated = {
   link: ClientSigninLinkRow;
   code: string;
@@ -118,7 +155,10 @@ export type ClientAdminRefusedReason =
   | 'contact-not-found'
   | 'contact-has-login'
   | 'no-email'
-  | 'not-a-client';
+  | 'not-a-client'
+  /** A contact-linked client's email must be one of the contact's addresses
+   *  (the mail gates know the client by its contact; audit B26). */
+  | 'email-not-on-contact';
 
 /** POST /api/auth/client-link { code, email } -> 200 { ok: true } and the
  *  session cookie (30 days), or one uniform 401 for every failure. */
@@ -159,7 +199,28 @@ export type ClientSigninSender = {
   dailyCap: number;
   sentLast24h: number;
   capReached: boolean;
+  /** Codes actually handed to the mail server in the last 24 h (sentLast24h counted failed ones too; it now equals this). */
+  deliveredLast24h?: number;
+  /** Sends that failed in the last 24 h, and the newest failure. */
+  failedLast24h?: number;
+  lastFailure?: { at: string; reason: string } | null;
+  /** False when no email worker serves the code queue on this box: codes are then OFF whatever the sender. */
+  emailWorker?: boolean;
+  /** Requests that were skipped because a cap was hit in the last 24 h (per email, per address or brain-wide). */
+  capSkipsLast24h?: number;
+};
+
+/** GET /api/team-admin/clients/signin-sender/preview?accountId=<id>: what
+ *  choosing that account as the sender would do, before the admin confirms.
+ *  Choosing None (or another sender) later RESTORES the folders the choice
+ *  left out (the server remembers exactly which it added). */
+export type ClientSigninSenderPreview = {
+  /** The folders that choosing this sender will leave out of mail sync. Empty + canUse false = refused. */
+  sentFolders: string[];
+  canUse: boolean;
+  reason?: 'no-sent-folder' | 'folders-unreadable' | 'account-cannot-send';
 };
 
 /** Why an admin's sender choice was refused (the 4xx `reason`). */
-export type ClientSenderRefusedReason = 'account-not-found' | 'account-cannot-send';
+export type ClientSenderRefusedReason =
+  'account-not-found' | 'account-cannot-send' | 'no-sent-folder' | 'folders-unreadable';

package/src/dto/member-apps.ts

@@ -56,8 +56,13 @@ export type MemberChatRow = {
   name: string;
   email: string;
   /** False when the login is disabled or no longer a member (its old
-   *  thread still shows). */
+   *  thread still shows). Always false for a client: a client is never a
+   *  team member (client logins audit B26). */
   active: boolean;
+  /** The login's role, named (0.232.333 on): 'member' for the team; 'client'
+   *  for a client login with a chat thread, which is NOT a team member; absent
+   *  for a former member who is an admin now (its old thread still shows). */
+  role?: 'member' | 'client';
   lastMessageAt: string | null;
   lastMessageText: string | null;
   lastMessageDirection: 'inbound' | 'outbound' | null;

package/src/dto/member-invites.ts

@@ -37,7 +37,8 @@ export type MemberInviteList = { invites: MemberInviteRow[] };
 /**
  * POST /api/team-admin/invites (201). `code` and `linkPath` are shown ONCE:
  * only the code's hash is stored. `linkPath` is a client-app path
- * (`/invite?code=…`); prefix the client's origin to share it.
+ * (`/invite#code=...` since 0.232.333: the fragment never reaches a server
+ * log; `/invite?code=…` before); prefix the client's origin to share it.
  */
 export type MemberInviteCreated = {
   invite: MemberInviteRow;

package/src/index.ts

@@ -118,6 +118,7 @@ export type {
   ClientCodeSignIn,
   ClientSigninSenderCandidate,
   ClientSigninSender,
+  ClientSigninSenderPreview,
   ClientSenderRefusedReason,
   ClientLoginCreated,
   ClientLoginList,
@@ -125,6 +126,9 @@ export type {
   ClientSharedItem,
   ClientSharedPage,
   ClientSharedRow,
+  ClientSharedTable,
+  ClientSharedTableColumn,
+  ClientSharedTableRow,
   ClientShell,
   ClientSigninLinkCreated,
   ClientSigninLinkRow,