@burdenoff/microfe-crewfoundry 2026.703.2 → 2026.704.1

package/dist/crewfoundry/pages/HelpApiDocumentationPagePage.js

@@ -1,133 +1,195 @@
 import { useCrewFoundryStore as e } from "../store/crewfoundryStore.js";
 import { useMemo as t, useState as n } from "react";
-import { BookOpen as r, ChevronRight as i, Code2 as a, Copy as o, ExternalLink as s, Lock as c, Search as l, Server as u, Zap as d } from "lucide-react";
+import { Check as r, ChevronRight as i, Code2 as a, Copy as o, Database as s, ListTree as c, Lock as l, Network as u, Search as d } from "lucide-react";
 import { jsx as f, jsxs as p } from "react/jsx-runtime";
 import { Badge as m, Button as h, Card as g, CardContent as _, CardDescription as v, CardHeader as y, CardTitle as b, EmphasisPanel as x, GradientText as S, IllustratedEmptyState as C, Input as w, PagePurpose as T } from "@burdenoff/fe-libs/ui";
+import { useGlobalUi as E } from "@burdenoff/fe-libs/shared/providers/shell";
 //#region src/crewfoundry/pages/HelpApiDocumentationPagePage.tsx
-var E = {
-	GET: "bg-status-success-bg text-status-success-text",
-	POST: "bg-status-info-bg text-status-info-text",
-	PATCH: "bg-status-warning-bg text-status-warning-text",
-	DELETE: "bg-status-error-bg text-status-error-text"
+var D = "https://graphqlworkspaces.burdenoff.com/workspaces/graphql", O = [
+	{
+		name: "Announcement",
+		domain: "Communications"
+	},
+	{
+		name: "Candidate",
+		domain: "Hiring"
+	},
+	{
+		name: "Client",
+		domain: "Finance"
+	},
+	{
+		name: "Course",
+		domain: "Learning"
+	},
+	{
+		name: "Department",
+		domain: "HR"
+	},
+	{
+		name: "Employee",
+		domain: "HR"
+	},
+	{
+		name: "Interview",
+		domain: "Hiring"
+	},
+	{
+		name: "Invoice",
+		domain: "Finance"
+	},
+	{
+		name: "JobPosting",
+		domain: "Hiring"
+	},
+	{
+		name: "LearningPath",
+		domain: "Learning"
+	},
+	{
+		name: "LeaveRequest",
+		domain: "HR"
+	},
+	{
+		name: "MarketplaceService",
+		domain: "Marketplace"
+	},
+	{
+		name: "PayrollRecord",
+		domain: "Finance"
+	},
+	{
+		name: "Project",
+		domain: "Projects"
+	},
+	{
+		name: "Team",
+		domain: "Teams"
+	},
+	{
+		name: "TimeEntry",
+		domain: "HR"
+	},
+	{
+		name: "Vendor",
+		domain: "Finance"
+	}
+], k = {
+	Query: "bg-status-success-bg text-status-success-text",
+	Mutation: "bg-status-info-bg text-status-info-text"
+}, A = (e) => e.replace(/([a-z])([A-Z])/g, "$1 $2").toLowerCase(), j = async (e) => {
+	try {
+		if (typeof navigator < "u" && navigator.clipboard?.writeText) return await navigator.clipboard.writeText(e), !0;
+	} catch {}
+	try {
+		if (typeof document > "u") return !1;
+		let t = document.createElement("textarea");
+		t.value = e, t.style.position = "fixed", t.style.opacity = "0", document.body.appendChild(t), t.focus(), t.select();
+		let n = document.execCommand("copy");
+		return document.body.removeChild(t), n;
+	} catch {
+		return !1;
+	}
 };
-function D() {
-	let { employees: D, jobPostings: O, candidates: k, payrollRecords: A, leaveRequests: j } = e(), [M, N] = n(""), [P, F] = n(null), I = t(() => [
-		{
-			name: "Employees",
-			version: "v2",
-			endpoints: [
-				{
-					method: "GET",
-					path: "/api/v2/employees",
-					description: `List all employees (${D.length} records) with pagination and filters`
-				},
-				{
-					method: "POST",
-					path: "/api/v2/employees",
-					description: "Create a new employee record"
-				},
-				{
-					method: "GET",
-					path: "/api/v2/employees/:id",
-					description: "Get employee details by ID"
-				},
-				{
-					method: "PATCH",
-					path: "/api/v2/employees/:id",
-					description: "Update employee information"
-				},
-				{
-					method: "DELETE",
-					path: "/api/v2/employees/:id",
-					description: "Deactivate an employee record"
-				}
-			]
-		},
-		{
-			name: "Hiring",
-			version: "v2",
-			endpoints: [
-				{
-					method: "GET",
-					path: "/api/v2/jobs",
-					description: `List all job postings (${O.length} total)`
-				},
-				{
-					method: "POST",
-					path: "/api/v2/jobs",
-					description: "Create a new job posting"
-				},
-				{
-					method: "GET",
-					path: "/api/v2/candidates",
-					description: `List candidates (${k.length}) with pipeline filters`
-				},
-				{
-					method: "POST",
-					path: "/api/v2/candidates",
-					description: "Add a new candidate to the pipeline"
-				}
-			]
-		},
-		{
-			name: "Payroll",
-			version: "v1",
-			endpoints: [
-				{
-					method: "GET",
-					path: "/api/v1/payroll/records",
-					description: `List payroll records by period (${A.length} loaded)`
-				},
-				{
-					method: "POST",
-					path: "/api/v1/payroll/run",
-					description: "Trigger payroll processing"
-				},
-				{
-					method: "GET",
-					path: "/api/v1/payroll/reports",
-					description: "Generate payroll reports"
-				}
-			]
-		},
-		{
-			name: "Leave",
-			version: "v2",
-			endpoints: [
-				{
-					method: "GET",
-					path: "/api/v2/leave/requests",
-					description: `List leave requests with status filters (${j.length} total)`
-				},
-				{
-					method: "POST",
-					path: "/api/v2/leave/requests",
-					description: "Submit a new leave request"
-				},
-				{
-					method: "PATCH",
-					path: "/api/v2/leave/requests/:id/approve",
-					description: "Approve a leave request"
-				}
-			]
-		}
-	], [
-		k.length,
-		D.length,
-		O.length,
-		j.length,
-		A.length
-	]), L = (e) => {
-		F(e), setTimeout(() => F(null), 1500);
-	}, R = I.map((e) => ({
-		...e,
-		endpoints: e.endpoints.filter((e) => e.path.toLowerCase().includes(M.toLowerCase()) || e.description.toLowerCase().includes(M.toLowerCase()))
-	})).filter((e) => e.endpoints.length > 0);
+function M() {
+	let { employees: M, jobPostings: N, candidates: P, payrollRecords: F, leaveRequests: I } = e(), { showToast: L } = E(), [R, z] = n(""), [B, V] = n(null), H = t(() => {
+		let e = O.map((e) => ({
+			kind: "Mutation",
+			name: `createCrew${e.name}`,
+			signature: `createCrew${e.name}(input: CreateCrew${e.name}Input!): Crew${e.name}!`,
+			description: `Create a ${A(e.name)} record (${e.domain}).`
+		})), t = O.map((e) => ({
+			kind: "Mutation",
+			name: `updateCrew${e.name}`,
+			signature: `updateCrew${e.name}(id: ID!, input: UpdateCrew${e.name}Input!): Crew${e.name}!`,
+			description: `Update an existing ${A(e.name)} record (${e.domain}).`
+		})), n = O.map((e) => ({
+			kind: "Mutation",
+			name: `removeCrew${e.name}`,
+			signature: `removeCrew${e.name}(id: ID!): Boolean!`,
+			description: `Delete a ${A(e.name)} record (${e.domain}).`
+		}));
+		return [
+			{
+				id: "queries",
+				name: "Queries",
+				description: "Read the workspace dataset",
+				operations: [{
+					kind: "Query",
+					name: "crewfoundryBootstrap",
+					signature: "crewfoundryBootstrap: CrewfoundryBootstrap!",
+					description: `Load the full workspace dataset in one call — ${M.length} employees, ${N.length} job postings, ${P.length} candidates, ${F.length} payroll records, ${I.length} leave requests, and every other CrewFoundry collection.`
+				}]
+			},
+			{
+				id: "create",
+				name: "Create mutations",
+				description: "Add new records",
+				operations: e
+			},
+			{
+				id: "update",
+				name: "Update mutations",
+				description: "Modify existing records",
+				operations: t
+			},
+			{
+				id: "delete",
+				name: "Delete mutations",
+				description: "Remove records",
+				operations: n
+			},
+			{
+				id: "workflow",
+				name: "Workflow mutations",
+				description: "Enrollment & notifications",
+				operations: [
+					{
+						kind: "Mutation",
+						name: "enrollCrewCourse",
+						signature: "enrollCrewCourse(id: ID!): CrewCourse!",
+						description: "Enroll the current member into a learning course."
+					},
+					{
+						kind: "Mutation",
+						name: "markCrewNotificationRead",
+						signature: "markCrewNotificationRead(id: ID!): Boolean!",
+						description: "Mark a single notification as read."
+					},
+					{
+						kind: "Mutation",
+						name: "markAllCrewNotificationsRead",
+						signature: "markAllCrewNotificationsRead: Boolean!",
+						description: "Mark every notification as read."
+					}
+				]
+			}
+		];
+	}, [
+		P.length,
+		M.length,
+		N.length,
+		I.length,
+		F.length
+	]), U = t(() => H.reduce((e, t) => e + t.operations.length, 0), [H]), W = t(() => {
+		let e = R.trim().toLowerCase();
+		return e ? H.map((t) => ({
+			...t,
+			operations: t.operations.filter((t) => t.name.toLowerCase().includes(e) || t.signature.toLowerCase().includes(e) || t.description.toLowerCase().includes(e))
+		})).filter((e) => e.operations.length > 0) : H;
+	}, [H, R]), G = async (e) => {
+		await j(e) ? (V(e), L("Copied to clipboard", "success"), window.setTimeout(() => V((t) => t === e ? null : t), 1500)) : L("Unable to copy to clipboard", "error");
+	}, K = (e) => {
+		(typeof document < "u" ? document.getElementById(`group-${e}`) : null)?.scrollIntoView({
+			behavior: "smooth",
+			block: "start"
+		});
+	};
 	return /* @__PURE__ */ p("div", {
 		className: "space-y-6 p-6",
 		children: [
 			/* @__PURE__ */ p("div", {
-				className: "flex items-center justify-between",
+				className: "flex flex-col gap-3 md:flex-row md:items-start md:justify-between",
 				children: [/* @__PURE__ */ p("div", { children: [
 					/* @__PURE__ */ f("h1", {
 						className: "text-2xl font-semibold",
@@ -135,21 +197,24 @@ function D() {
 					}),
 					/* @__PURE__ */ f("p", {
 						className: "text-sm text-text-secondary",
-						children: "CrewFoundry REST API reference for integrations"
+						children: "CrewFoundry GraphQL API reference for integrations"
 					}),
 					/* @__PURE__ */ f(T, {
 						className: "mt-1",
-						children: "Browse the CrewFoundry API reference — use it to find endpoints, understand request formats, and integrate CrewFoundry with your own tools."
+						children: "Browse the CrewFoundry API reference — use it to find operations, understand request formats, and integrate CrewFoundry with your own tools."
 					})
 				] }), /* @__PURE__ */ p("div", {
-					className: "flex gap-2",
+					className: "flex flex-wrap items-center gap-2",
 					children: [/* @__PURE__ */ f(m, {
 						variant: "secondary",
-						children: "Base URL: api.crewfoundry.com"
+						className: "max-w-full truncate font-mono text-[10px]",
+						children: D
 					}), /* @__PURE__ */ p(h, {
 						size: "sm",
 						variant: "outline",
-						children: [/* @__PURE__ */ f(s, { className: "h-3 w-3 mr-1" }), "OpenAPI Spec"]
+						"aria-label": "Copy the GraphQL endpoint URL",
+						onClick: () => void G(D),
+						children: [B === D ? /* @__PURE__ */ f(r, { className: "mr-1 h-3 w-3 text-status-success-text" }) : /* @__PURE__ */ f(o, { className: "mr-1 h-3 w-3" }), "Copy endpoint"]
 					})]
 				})]
 			}),
@@ -158,37 +223,40 @@ function D() {
 				children: [
 					{
 						icon: u,
-						label: "REST API",
-						value: "v2.1.0",
+						label: "Protocol",
+						value: "GraphQL",
 						color: "text-status-info-text"
 					},
 					{
 						icon: a,
-						label: "GraphQL",
-						value: "Federation v2",
+						label: "Composition",
+						value: "Apollo Federation v2",
 						color: "text-action-primary-bg"
 					},
 					{
-						icon: c,
+						icon: l,
 						label: "Auth",
-						value: "OAuth 2.0 + JWT",
+						value: "Bearer token",
 						color: "text-status-success-text"
 					},
 					{
-						icon: d,
-						label: "Rate Limit",
-						value: "1,000 req/min",
+						icon: c,
+						label: "Operations",
+						value: String(U),
 						color: "text-status-warning-text"
 					}
 				].map((e) => /* @__PURE__ */ f(g, { children: /* @__PURE__ */ p(_, {
 					className: "flex items-center gap-3 pt-6",
-					children: [/* @__PURE__ */ f(e.icon, { className: `h-5 w-5 ${e.color}` }), /* @__PURE__ */ p("div", { children: [/* @__PURE__ */ f("p", {
-						className: "text-xs text-text-secondary",
-						children: e.label
-					}), /* @__PURE__ */ f("p", {
-						className: "text-sm font-medium",
-						children: e.value
-					})] })]
+					children: [/* @__PURE__ */ f(e.icon, { className: `h-5 w-5 ${e.color}` }), /* @__PURE__ */ p("div", {
+						className: "min-w-0",
+						children: [/* @__PURE__ */ f("p", {
+							className: "text-xs text-text-secondary",
+							children: e.label
+						}), /* @__PURE__ */ f("p", {
+							className: "truncate text-sm font-medium",
+							children: e.value
+						})]
+					})]
 				}) }, e.label))
 			}),
 			/* @__PURE__ */ p("div", {
@@ -197,34 +265,25 @@ function D() {
 					className: "space-y-4",
 					children: [/* @__PURE__ */ p(x, { children: [/* @__PURE__ */ f("div", {
 						className: "mb-2 text-sm font-semibold",
-						children: "Quick Start"
+						children: "Jump to"
 					}), /* @__PURE__ */ f("div", {
 						className: "space-y-2",
-						children: [
-							{
-								icon: r,
-								label: "Authentication Guide"
-							},
-							{
-								icon: a,
-								label: "SDK Reference"
-							},
-							{
-								icon: d,
-								label: "Webhooks"
-							},
-							{
-								icon: u,
-								label: "Rate Limiting"
-							}
-						].map((e) => /* @__PURE__ */ p("button", {
-							className: "flex w-full items-center gap-2 rounded-md px-2 py-1.5 text-sm hover:bg-bg-sunken transition-colors",
+						children: H.map((e) => /* @__PURE__ */ p("button", {
+							type: "button",
+							"aria-label": `Jump to ${e.name}`,
+							onClick: () => K(e.id),
+							className: "flex w-full items-center gap-2 rounded-md px-2 py-1.5 text-sm transition-colors hover:bg-bg-sunken",
 							children: [
-								/* @__PURE__ */ f(e.icon, { className: "h-3 w-3 text-text-secondary" }),
-								/* @__PURE__ */ f("span", { children: e.label }),
-								/* @__PURE__ */ f(i, { className: "h-3 w-3 ml-auto text-text-secondary" })
+								/* @__PURE__ */ f(c, { className: "h-3 w-3 text-text-secondary" }),
+								/* @__PURE__ */ f("span", { children: e.name }),
+								/* @__PURE__ */ f(m, {
+									variant: "outline",
+									className: "ml-auto text-[10px]",
+									children: e.operations.length
+								}),
+								/* @__PURE__ */ f(i, { className: "h-3 w-3 text-text-secondary" })
 							]
-						}, e.label))
+						}, e.id))
 					})] }), /* @__PURE__ */ p(g, { children: [/* @__PURE__ */ f(y, { children: /* @__PURE__ */ f(b, {
 						className: "text-sm",
 						children: "Authentication"
@@ -233,69 +292,77 @@ function D() {
 						children: [/* @__PURE__ */ f("div", {
 							className: "rounded-md bg-bg-sunken p-3",
 							children: /* @__PURE__ */ p("code", {
-								className: "text-xs font-mono",
+								className: "font-mono text-xs",
 								children: ["Authorization: Bearer ", "<token>"]
 							})
 						}), /* @__PURE__ */ f("p", {
 							className: "text-xs text-text-secondary",
-							children: "All API requests require a valid JWT token obtained through the OAuth 2.0 flow."
+							children: "Requests are authenticated at the gateway edge. Send your session bearer token on every request; the gateway resolves the actor and enforces workspace-scoped RBAC before the subgraph runs."
 						})]
 					})] })]
 				}), /* @__PURE__ */ p("div", {
-					className: "lg:col-span-3 space-y-4",
+					className: "space-y-4 lg:col-span-3",
 					children: [
 						/* @__PURE__ */ p("div", {
 							className: "relative max-w-md",
-							children: [/* @__PURE__ */ f(l, { className: "absolute left-3 top-1/2 -translate-y-1/2 h-4 w-4 text-text-secondary" }), /* @__PURE__ */ f(w, {
-								placeholder: "Search endpoints...",
+							children: [/* @__PURE__ */ f(d, { className: "absolute top-1/2 left-3 h-4 w-4 -translate-y-1/2 text-text-secondary" }), /* @__PURE__ */ f(w, {
+								placeholder: "Search operations...",
 								className: "pl-9",
-								value: M,
-								onChange: (e) => N(e.target.value)
+								value: R,
+								onChange: (e) => z(e.target.value)
 							})]
 						}),
-						R.map((e) => /* @__PURE__ */ p(g, { children: [/* @__PURE__ */ p(y, { children: [/* @__PURE__ */ p("div", {
-							className: "flex items-center gap-2",
-							children: [/* @__PURE__ */ f(b, {
-								className: "text-base",
-								children: e.name
-							}), /* @__PURE__ */ f(m, {
-								variant: "outline",
-								className: "text-[10px]",
-								children: e.version
+						W.map((e) => /* @__PURE__ */ p(g, {
+							id: `group-${e.id}`,
+							className: "scroll-mt-6",
+							children: [/* @__PURE__ */ p(y, { children: [/* @__PURE__ */ p("div", {
+								className: "flex items-center gap-2",
+								children: [/* @__PURE__ */ f(s, { className: "h-4 w-4 text-text-secondary" }), /* @__PURE__ */ f(b, {
+									className: "text-base",
+									children: e.name
+								})]
+							}), /* @__PURE__ */ p(v, { children: [
+								e.description,
+								" · ",
+								e.operations.length,
+								" operations"
+							] })] }), /* @__PURE__ */ f(_, {
+								className: "p-0",
+								children: e.operations.map((t, n) => /* @__PURE__ */ p("div", {
+									className: `flex items-center gap-3 px-6 py-3 hover:bg-bg-sunken/50 ${n < e.operations.length - 1 ? "border-b" : ""}`,
+									children: [
+										/* @__PURE__ */ f(m, {
+											className: `${k[t.kind]} min-w-[64px] justify-center border-0 font-mono text-[10px]`,
+											children: t.kind
+										}),
+										/* @__PURE__ */ p("div", {
+											className: "min-w-0 flex-1",
+											children: [/* @__PURE__ */ f("code", {
+												className: "block truncate font-mono text-sm",
+												children: t.signature
+											}), /* @__PURE__ */ f("span", {
+												className: "text-xs text-text-secondary",
+												children: t.description
+											})]
+										}),
+										/* @__PURE__ */ f(h, {
+											variant: "ghost",
+											size: "sm",
+											className: "h-6 w-6 shrink-0 p-0",
+											"aria-label": `Copy ${t.name} operation name`,
+											onClick: () => void G(t.name),
+											children: B === t.name ? /* @__PURE__ */ f(r, { className: "h-3 w-3 text-status-success-text" }) : /* @__PURE__ */ f(o, { className: "h-3 w-3 text-text-secondary" })
+										})
+									]
+								}, t.name))
 							})]
-						}), /* @__PURE__ */ p(v, { children: [e.endpoints.length, " endpoints"] })] }), /* @__PURE__ */ f(_, {
-							className: "p-0",
-							children: e.endpoints.map((t, n) => /* @__PURE__ */ p("div", {
-								className: `flex items-center gap-3 px-6 py-3 hover:bg-bg-sunken/50 cursor-pointer ${n < e.endpoints.length - 1 ? "border-b" : ""}`,
-								children: [
-									/* @__PURE__ */ f(m, {
-										className: `${E[t.method]} text-[10px] font-mono border-0 min-w-[50px] justify-center`,
-										children: t.method
-									}),
-									/* @__PURE__ */ f("code", {
-										className: "text-sm font-mono flex-1",
-										children: t.path
-									}),
-									/* @__PURE__ */ f("span", {
-										className: "text-xs text-text-secondary hidden lg:block max-w-[250px] truncate",
-										children: t.description
-									}),
-									/* @__PURE__ */ f(h, {
-										variant: "ghost",
-										size: "sm",
-										className: "h-6 w-6 p-0",
-										onClick: () => L(t.path),
-										children: /* @__PURE__ */ f(o, { className: `h-3 w-3 ${P === t.path ? "text-status-success-text" : "text-text-secondary"}` })
-									})
-								]
-							}, t.path + t.method))
-						})] }, e.name)),
-						R.length === 0 && /* @__PURE__ */ f("div", {
+						}, e.id)),
+						W.length === 0 && /* @__PURE__ */ f("div", {
 							className: "py-6",
 							children: /* @__PURE__ */ f(C, {
 								illustration: "empty-search",
-								title: "No endpoints match",
-								description: "Try a different search term to find the API you need."
+								title: "No operations match",
+								description: "Try a different search term to find the operation you need."
 							})
 						})
 					]
@@ -305,6 +372,6 @@ function D() {
 	});
 }
 //#endregion
-export { D as HelpApiDocumentationPagePage };
+export { M as HelpApiDocumentationPagePage };
 
 //# sourceMappingURL=HelpApiDocumentationPagePage.js.map