@crossworks/client-types 0.230.62 → 0.230.67

package/package.json

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

package/src/index.ts

@@ -685,11 +685,50 @@ export type TaskRow = {
   priority: TaskPriority;
   dueAt: string | null;
   tags: string[];
+  /** Checklist inside the task ("task breakup"). Stored in `data.todos`. */
+  todos: TaskTodo[];
+  /** Fractional ordering key for the board (within-column order). Stored in
+   *  `data.rank`; null on tasks never dragged — they sort after ranked ones. */
+  rank: string | null;
+  /** Comments on this task (node_comments rows). List/detail badge material. */
+  commentCount: number;
   summary: string | null;
+  /** When the task was filed away, or null while it is live. Archived tasks are
+   *  excluded from every list, count and board unless explicitly requested —
+   *  it is what keeps a Done column from growing without bound. Orthogonal to
+   *  `status`: an archived task keeps the status it had. */
+  archivedAt: string | null;
   createdAt: string;
   updatedAt: string;
 };
 
+/** One checklist item inside a task. Server assigns `id` on write. */
+export type TaskTodo = {
+  id: string;
+  text: string;
+  done: boolean;
+};
+
+/** Mirrors @mantle/db `NodeCommentAuthorKind`. */
+export type NodeCommentAuthorKind = 'owner' | 'member' | 'agent';
+
+/**
+ * A comment on a node (tasks first; the table is node-generic). `authorName`
+ * is a display snapshot at post time; `mine` is computed server-side per
+ * viewer (an owner login sees its own comments as mine, a team member sees
+ * theirs), so clients never reconcile the two auth worlds themselves.
+ */
+export type NodeComment = {
+  id: string;
+  nodeId: string;
+  authorKind: NodeCommentAuthorKind;
+  authorName: string;
+  mine: boolean;
+  body: string;
+  createdAt: string;
+  editedAt: string | null;
+};
+
 export type JournalRow = {
   id: string;
   title: string;
@@ -1326,7 +1365,7 @@ export type TeamVisibleShare = {
 
 /** Task lifecycle vocabulary — mirrors content's TASK_STATUSES/TASK_PRIORITIES
  *  consts, which are `satisfies`-checked against these unions. */
-export type TaskStatus = 'open' | 'done';
+export type TaskStatus = 'open' | 'in_progress' | 'blocked' | 'done';
 export type TaskPriority = 'low' | 'normal' | 'high';
 
 /** Mirrors @mantle/db `ForumTopicKind`. */

package/src/lib/format-datetime.ts

@@ -76,6 +76,22 @@ export function formatTime(input: Input, missing = 'never'): string {
   return new Intl.DateTimeFormat(LOCALE, TIME_OPTS).format(d);
 }
 
+const DAY_TIME_OPTS: Intl.DateTimeFormatOptions = {
+  day: 'numeric',
+  month: 'short',
+  hour: '2-digit',
+  minute: '2-digit',
+  hour12: false,
+};
+
+/** '17 Aug, 10:06' — compact stamp for feed/thread rows (comments, posts)
+ *  where the full numeric formatDateTime is too heavy. */
+export function formatDayTime(input: Input, missing = 'never'): string {
+  const d = toDate(input);
+  if (!d) return missing;
+  return new Intl.DateTimeFormat(LOCALE, DAY_TIME_OPTS).format(d);
+}
+
 /**
  * `YYYY-MM-DD` in the viewer's LOCAL timezone (defaults to now). Use this to
  * compare against day-bucketed date strings — `new Date().toISOString().slice(0,10)`