@burdenoff/planmagnet-fe-sdk 2026.703.2 → 2026.703.3

package/dist/index.js

@@ -1,12 +1,12 @@
 import { createContext, useMemo, useEffect, useContext, useState, useCallback } from 'react';
-import { ApolloProvider, useApolloClient, useMutation, useQuery } from '@apollo/client/react';
+import { ApolloProvider, useQuery, useApolloClient, useMutation } from '@apollo/client/react';
 import { createHttpLink, ApolloClient, from, InMemoryCache } from '@apollo/client/core';
 import { setContext } from '@apollo/client/link/context';
 import { onError } from '@apollo/client/link/error';
 import { CombinedGraphQLErrors } from '@apollo/client/errors';
 import { jsx, jsxs } from 'react/jsx-runtime';
 import { gql } from '@apollo/client';
-import { CircleX, CircleCheckBig, CircleDotDashed, CircleDot, Circle, CircleDashed, User, CalendarDays, ChevronUp, ChevronDown, ChevronLeft, ChevronRight, CalendarRange, List, LayoutGrid, Search, Plus } from 'lucide-react';
+import { CircleX, CircleCheckBig, CircleDotDashed, CircleDot, Circle, CircleDashed, User, Link2, CalendarDays, ChevronUp, ChevronDown, ChevronLeft, ChevronRight, CalendarRange, List, LayoutGrid, Search, Plus } from 'lucide-react';
 import { clsx } from 'clsx';
 import { twMerge } from 'tailwind-merge';
 import { addWeeks, startOfWeek, endOfWeek, eachDayOfInterval, addMonths, startOfMonth, endOfMonth, format, isToday, isSameMonth, startOfDay, parseISO, isValid } from 'date-fns';
@@ -410,6 +410,63 @@ var MOVE_WORK_ITEM = gql`
   }
   ${WORK_ITEM_FIELDS}
 `;
+var WORK_ITEM_LINK_FIELDS = gql`
+  fragment WorkItemLinkFields on WorkItemLink {
+    id
+    workspaceId
+    workItemId
+    sourceProduct
+    entityType
+    entityId
+    relationType
+    displayNameSnapshot
+    deepLinkSnapshot
+    metadata
+    createdBy
+    onBehalfOf
+    createdAt
+    updatedAt
+  }
+`;
+var LIST_WORK_ITEM_LINKS = gql`
+  query ListWorkItemLinks(
+    $workspaceId: ID!
+    $filter: PlanmagnetWorkItemLinkFilter
+    $pagination: PlanmagnetPaginationInput
+  ) {
+    planmagnetWorkItemLinks(
+      workspaceId: $workspaceId
+      filter: $filter
+      pagination: $pagination
+    ) {
+      items {
+        ...WorkItemLinkFields
+      }
+      pageInfo {
+        hasNextPage
+        hasPreviousPage
+        startCursor
+        endCursor
+        totalCount
+      }
+      totalCount
+    }
+  }
+  ${WORK_ITEM_LINK_FIELDS}
+`;
+var CREATE_WORK_ITEM_LINK = gql`
+  mutation CreateWorkItemLink($input: PlanmagnetCreateWorkItemLinkInput!) {
+    planmagnetLinkWorkItem(input: $input) {
+      ...WorkItemLinkFields
+    }
+  }
+  ${WORK_ITEM_LINK_FIELDS}
+`;
+var DELETE_WORK_ITEM_LINK = gql`
+  mutation UnlinkWorkItem($id: ID!) {
+    planmagnetUnlinkWorkItem(id: $id)
+  }
+`;
 function cn(...inputs) {
   return twMerge(clsx(inputs));
 }
@@ -552,6 +609,36 @@ var TASK_STATUSES = [
 function enumLabel(value) {
   return value.toLowerCase().replace(/_/g, " ");
 }
+function LinkChip({ link, renderIcon, className }) {
+  const label = link.displayNameSnapshot || enumLabel(link.entityType);
+  const icon = renderIcon?.(link.entityType) ?? /* @__PURE__ */ jsx(Link2, { className: "h-3 w-3 shrink-0", "aria-hidden": "true" });
+  const body = /* @__PURE__ */ jsxs(
+    "span",
+    {
+      className: cn(
+        "inline-flex max-w-full items-center gap-1 rounded-full border border-primary/20 bg-primary/5 px-1.5 py-0.5 text-[10px] font-medium text-primary",
+        className
+      ),
+      title: `${enumLabel(link.relationType)} \xB7 ${enumLabel(link.entityType)}`,
+      children: [
+        icon,
+        /* @__PURE__ */ jsx("span", { className: "truncate", children: label })
+      ]
+    }
+  );
+  if (link.deepLinkSnapshot) {
+    return /* @__PURE__ */ jsx(
+      "a",
+      {
+        href: link.deepLinkSnapshot,
+        onClick: (e) => e.stopPropagation(),
+        className: "inline-flex max-w-full no-underline hover:brightness-95",
+        children: body
+      }
+    );
+  }
+  return body;
+}
 var STATUS_META = {
   BACKLOG: { icon: CircleDashed, tone: "text-muted-foreground/60" },
   TODO: { icon: Circle, tone: "text-muted-foreground" },
@@ -705,12 +792,15 @@ function TaskCard({
   onDragEnd,
   dragging,
   resolveAssignee,
+  links,
+  renderLinkIcon,
   className
 }) {
   const overdue = isOverdue(task.dueDate, task.status);
   const due = formatDueDate(task.dueDate);
   const resolved = task.assigneeId ? resolveAssignee?.(task.assigneeId) : null;
   const showTopRow = !hidden.has("key") || !hidden.has("type");
+  const showLinks = !hidden.has("links") && (links?.length ?? 0) > 0;
   const showLabels = !hidden.has("labels") && (task.labels?.length ?? 0) > 0;
   const showPriority = !hidden.has("priority");
   const showPoints = !hidden.has("storyPoints") && task.storyPoints != null;
@@ -749,6 +839,13 @@ function TaskCard({
           !hidden.has("type") && /* @__PURE__ */ jsx(TypeBadge, { type: task.type })
         ] }),
         /* @__PURE__ */ jsx("p", { className: "line-clamp-2 text-sm font-medium leading-snug text-foreground", children: task.title }),
+        showLinks && /* @__PURE__ */ jsxs("div", { className: "mt-1.5 flex flex-wrap gap-1", children: [
+          links.slice(0, 3).map((link) => /* @__PURE__ */ jsx(LinkChip, { link, renderIcon: renderLinkIcon }, link.id)),
+          links.length > 3 && /* @__PURE__ */ jsxs("span", { className: "text-[10px] text-muted-foreground", children: [
+            "+",
+            links.length - 3
+          ] })
+        ] }),
         showLabels && /* @__PURE__ */ jsxs("div", { className: "mt-1.5 flex flex-wrap gap-1", children: [
           task.labels.slice(0, 3).map((l) => /* @__PURE__ */ jsx(
             "span",
@@ -798,6 +895,29 @@ function TaskCard({
     }
   );
 }
+function useWorkItemLinks(workspaceId, sourceProduct, limit = 500) {
+  const { data, loading } = useQuery(
+    LIST_WORK_ITEM_LINKS,
+    {
+      variables: {
+        workspaceId,
+        ...sourceProduct ? { filter: { sourceProduct } } : {},
+        pagination: { first: limit }
+      },
+      skip: !workspaceId || !sourceProduct
+    }
+  );
+  const linksByItem = useMemo(() => {
+    const map = /* @__PURE__ */ new Map();
+    for (const link of data?.planmagnetWorkItemLinks?.items ?? []) {
+      const arr = map.get(link.workItemId);
+      if (arr) arr.push(link);
+      else map.set(link.workItemId, [link]);
+    }
+    return map;
+  }, [data]);
+  return { linksByItem, loading };
+}
 function TaskBoardCore({
   projectId,
   columns = DEFAULT_BOARD_COLUMNS,
@@ -809,6 +929,8 @@ function TaskBoardCore({
   assigneeId,
   hiddenFields,
   resolveAssignee,
+  linkSourceProduct,
+  renderLinkIcon,
   onTaskClick,
   className,
   workspaceId: workspaceIdProp
@@ -817,6 +939,7 @@ function TaskBoardCore({
   const workspaceId = workspaceIdProp ?? ctx?.workspaceId;
   const client = useApolloClient();
   const hidden = useMemo(() => new Set(hiddenFields ?? []), [hiddenFields]);
+  const { linksByItem } = useWorkItemLinks(workspaceId, linkSourceProduct);
   const [draggingId, setDraggingId] = useState(null);
   const [dragOver, setDragOver] = useState(null);
   const [moveError, setMoveError] = useState(null);
@@ -927,6 +1050,8 @@ function TaskBoardCore({
                 draggable: canDrag,
                 dragging: draggingId === task.id,
                 resolveAssignee,
+                links: linksByItem.get(task.id),
+                renderLinkIcon,
                 onDragStart: (t, e) => {
                   setDraggingId(t.id);
                   e.dataTransfer.effectAllowed = "move";
@@ -1292,6 +1417,7 @@ var COLUMN_LABELS = {
   assignee: "Assignee",
   dueDate: "Due Date",
   storyPoints: "Points",
+  linkedRecord: "Linked Record",
   labels: "Labels"
 };
 var COLUMN_SORT = {
@@ -1315,12 +1441,15 @@ function TaskListCore({
   hideHeader,
   onSelect,
   resolveAssignee,
+  linkSourceProduct,
+  renderLinkIcon,
   limit = 200,
   className,
   workspaceId: workspaceIdProp
 }) {
   const ctx = usePlanMagnetContextSafe();
   const workspaceId = workspaceIdProp ?? ctx?.workspaceId;
+  const { linksByItem } = useWorkItemLinks(workspaceId, linkSourceProduct);
   const [sort, setSort] = useState({
     by: sortBy ?? null,
     dir: sortDir
@@ -1422,7 +1551,11 @@ function TaskListCore({
               "td",
               {
                 className: "px-3 py-2 align-middle text-foreground",
-                children: renderCell(col, task, resolveAssignee)
+                children: renderCell(col, task, {
+                  resolveAssignee,
+                  links: linksByItem.get(task.id),
+                  renderLinkIcon
+                })
               },
               col
             ))
@@ -1433,7 +1566,8 @@ function TaskListCore({
     ] }) })
   ] });
 }
-function renderCell(col, task, resolveAssignee) {
+function renderCell(col, task, opts) {
+  const { resolveAssignee, links, renderLinkIcon } = opts;
   switch (col) {
     case "key":
       return /* @__PURE__ */ jsx("span", { className: "font-mono text-xs text-muted-foreground", children: task.key });
@@ -1471,6 +1605,17 @@ function renderCell(col, task, resolveAssignee) {
     }
     case "storyPoints":
       return task.storyPoints != null ? /* @__PURE__ */ jsx("span", { className: "flex h-5 min-w-5 items-center justify-center rounded-full bg-primary/10 px-1 text-[10px] font-semibold text-primary", children: task.storyPoints }) : /* @__PURE__ */ jsx("span", { className: "text-muted-foreground", children: "\u2014" });
+    case "linkedRecord":
+      if (!links || links.length === 0) {
+        return /* @__PURE__ */ jsx("span", { className: "text-muted-foreground", children: "\u2014" });
+      }
+      return /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap gap-1", children: [
+        links.slice(0, 2).map((link) => /* @__PURE__ */ jsx(LinkChip, { link, renderIcon: renderLinkIcon }, link.id)),
+        links.length > 2 && /* @__PURE__ */ jsxs("span", { className: "text-[10px] text-muted-foreground", children: [
+          "+",
+          links.length - 2
+        ] })
+      ] });
     case "labels":
       return /* @__PURE__ */ jsx("div", { className: "flex flex-wrap gap-1", children: (task.labels ?? []).slice(0, 3).map((l) => /* @__PURE__ */ jsx(
         "span",
@@ -2307,6 +2452,8 @@ function TasksPageCore({
   views,
   defaultView = "board",
   resolveAssignee,
+  linkSourceProduct,
+  renderLinkIcon,
   header,
   onTaskSaved,
   createSurface = "modal",
@@ -2372,6 +2519,14 @@ function TasksPageCore({
   ) : null;
   const listPriority = priority === "ALL" ? void 0 : priority;
   const listType = type === "ALL" ? void 0 : type;
+  const listColumns = linkSourceProduct ? [
+    "title",
+    "status",
+    "priority",
+    "assignee",
+    "dueDate",
+    "linkedRecord"
+  ] : void 0;
   return /* @__PURE__ */ jsxs("div", { className: cn("space-y-4 p-6", className), children: [
     header && /* @__PURE__ */ jsx("div", { className: "min-w-0", children: typeof header === "string" ? /* @__PURE__ */ jsx("h1", { className: "truncate text-2xl font-semibold text-foreground", children: header }) : header }),
     /* @__PURE__ */ jsx(
@@ -2404,6 +2559,8 @@ function TasksPageCore({
         search,
         hiddenFields,
         resolveAssignee,
+        linkSourceProduct,
+        renderLinkIcon,
         onTaskClick: handleTaskClick
       }
     ),
@@ -2417,6 +2574,9 @@ function TasksPageCore({
         search: search || void 0,
         hideHeader: true,
         resolveAssignee,
+        linkSourceProduct,
+        renderLinkIcon,
+        columns: listColumns ? [...listColumns] : void 0,
         onSelect: handleSelect
       }
     ),
@@ -2483,6 +2643,6 @@ function TasksPage({
   );
 }
 
-export { Avatar, Badge, CREATE_WORK_ITEM, CreateTask, CreateTaskCore, DEFAULT_BOARD_COLUMNS, Drawer, GET_PROJECTS, GET_WORK_ITEM, LIST_WORK_ITEMS, MOVE_WORK_ITEM, Modal, PRIORITY_META, PROJECT_SUMMARY_FIELDS, PlanMagnetProvider, PriorityIndicator, STATUS_META, StatusIcon, StatusPill, TASK_PRIORITIES, TASK_STATUSES, TASK_TYPES, TaskBoard, TaskBoardCore, TaskCard, TaskDetail, TaskDetailCore, TaskList, TaskListCore, TaskTimelineCore, TaskToolbar, TasksPage, TasksPageCore, TypeBadge, UPDATE_WORK_ITEM, WORK_ITEM_FIELDS, WORK_ITEM_SUMMARY_FIELDS, badgeVariants, cn, config, createPlanMagnetClient, enumLabel, getGraphQLEndpoint, getPlanMagnetClient, getPlanMagnetClientSafe, getPlanMagnetConfig, isPlanMagnetClientReady, resetPlanMagnetClient, resetPlanMagnetConfig, setPlanMagnetClient, setPlanMagnetConfig, usePlanMagnetContext, usePlanMagnetContextSafe, validateTrustedOrigin, waitForPlanMagnetClient };
+export { Avatar, Badge, CREATE_WORK_ITEM, CREATE_WORK_ITEM_LINK, CreateTask, CreateTaskCore, DEFAULT_BOARD_COLUMNS, DELETE_WORK_ITEM_LINK, Drawer, GET_PROJECTS, GET_WORK_ITEM, LIST_WORK_ITEMS, LIST_WORK_ITEM_LINKS, LinkChip, MOVE_WORK_ITEM, Modal, PRIORITY_META, PROJECT_SUMMARY_FIELDS, PlanMagnetProvider, PriorityIndicator, STATUS_META, StatusIcon, StatusPill, TASK_PRIORITIES, TASK_STATUSES, TASK_TYPES, TaskBoard, TaskBoardCore, TaskCard, TaskDetail, TaskDetailCore, TaskList, TaskListCore, TaskTimelineCore, TaskToolbar, TasksPage, TasksPageCore, TypeBadge, UPDATE_WORK_ITEM, WORK_ITEM_FIELDS, WORK_ITEM_LINK_FIELDS, WORK_ITEM_SUMMARY_FIELDS, badgeVariants, cn, config, createPlanMagnetClient, enumLabel, getGraphQLEndpoint, getPlanMagnetClient, getPlanMagnetClientSafe, getPlanMagnetConfig, isPlanMagnetClientReady, resetPlanMagnetClient, resetPlanMagnetConfig, setPlanMagnetClient, setPlanMagnetConfig, usePlanMagnetContext, usePlanMagnetContextSafe, useWorkItemLinks, validateTrustedOrigin, waitForPlanMagnetClient };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map