@elqnt/kg 2.1.1 → 3.0.1

package/dist/{chunk-4XIW5GLO.js → chunk-2TJCYLTP.js}

@@ -1,7 +1,20 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }"use client";
 
 // api/index.ts
 var _browser = require('@elqnt/api-client/browser');
+function buildQueryString(params) {
+  const searchParams = new URLSearchParams();
+  for (const [key, value] of Object.entries(params)) {
+    if (value !== void 0) {
+      searchParams.set(key, value);
+    }
+  }
+  const queryString = searchParams.toString();
+  return queryString ? `?${queryString}` : "";
+}
+function buildHeaders(graphId) {
+  return graphId ? { "X-Graph-ID": graphId } : void 0;
+}
 async function listGraphsApi(options) {
   return _browser.browserApiRequest.call(void 0, "/api/v1/kg/graphs", { method: "GET", ...options });
 }
@@ -18,25 +31,27 @@ async function deleteGraphApi(graphId, options) {
   return _browser.browserApiRequest.call(void 0, `/api/v1/kg/graphs/${graphId}`, { method: "DELETE", ...options });
 }
 async function queryGraphApi(query, options) {
-  return _browser.browserApiRequest.call(void 0, "/api/v1/kg/query", { method: "POST", body: query, timeout: 3e4, ...options });
+  return _browser.browserApiRequest.call(void 0, "/api/v1/kg/query", {
+    method: "POST",
+    body: query,
+    timeout: 3e4,
+    headers: buildHeaders(options.graphId),
+    ...options
+  });
 }
 async function getGraphLabelsApi(options) {
-  const params = new URLSearchParams();
-  if (options.graphId) params.set("graphId", options.graphId);
-  const queryString = params.toString();
-  return _browser.browserApiRequest.call(void 0, `/api/v1/kg/labels${queryString ? `?${queryString}` : ""}`, { method: "GET", ...options });
+  const queryString = buildQueryString({ graphId: options.graphId });
+  return _browser.browserApiRequest.call(void 0, `/api/v1/kg/labels${queryString}`, { method: "GET", ...options });
 }
 async function getKGNodeApi(nodeId, options) {
-  const params = new URLSearchParams();
-  if (options.graphId) params.set("graphId", options.graphId);
-  const queryString = params.toString();
-  return _browser.browserApiRequest.call(void 0, `/api/v1/kg/nodes/${nodeId}${queryString ? `?${queryString}` : ""}`, { method: "GET", ...options });
+  const queryString = buildQueryString({ graphId: options.graphId });
+  return _browser.browserApiRequest.call(void 0, `/api/v1/kg/nodes/${nodeId}${queryString}`, { method: "GET", ...options });
 }
 async function ingestKGNodeApi(node, options) {
   return _browser.browserApiRequest.call(void 0, "/api/v1/kg/nodes", {
     method: "POST",
     body: node,
-    headers: options.graphId ? { "X-Graph-ID": options.graphId } : void 0,
+    headers: buildHeaders(options.graphId),
     ...options
   });
 }
@@ -44,56 +59,48 @@ async function updateKGNodeApi(nodeId, updates, options) {
   return _browser.browserApiRequest.call(void 0, `/api/v1/kg/nodes/${nodeId}`, {
     method: "PUT",
     body: updates,
-    headers: options.graphId ? { "X-Graph-ID": options.graphId } : void 0,
+    headers: buildHeaders(options.graphId),
     ...options
   });
 }
 async function getNodeConnectionStatsApi(nodeId, edgeLabel, options) {
-  const params = new URLSearchParams();
-  params.set("edgeLabel", edgeLabel);
-  if (options.graphId) params.set("graphId", options.graphId);
-  return _browser.browserApiRequest.call(void 0, `/api/v1/kg/nodes/${nodeId}/connections?${params.toString()}`, { method: "GET", ...options });
+  const queryString = buildQueryString({ edgeLabel, graphId: options.graphId });
+  return _browser.browserApiRequest.call(void 0, `/api/v1/kg/nodes/${nodeId}/connections${queryString}`, { method: "GET", ...options });
 }
 async function ingestDocumentApi(document, options) {
   return _browser.browserApiRequest.call(void 0, "/api/v1/kg/ingest", {
     method: "POST",
     body: document,
     timeout: 12e4,
-    headers: options.graphId ? { "X-Graph-ID": options.graphId } : void 0,
+    headers: buildHeaders(options.graphId),
     ...options
   });
 }
 async function deleteKGDocumentApi(documentId, options) {
-  const params = new URLSearchParams();
-  if (options.graphId) params.set("graphId", options.graphId);
-  const queryString = params.toString();
-  return _browser.browserApiRequest.call(void 0, `/api/v1/kg/documents/${documentId}${queryString ? `?${queryString}` : ""}`, { method: "DELETE", ...options });
+  const queryString = buildQueryString({ graphId: options.graphId });
+  return _browser.browserApiRequest.call(void 0, `/api/v1/kg/documents/${documentId}${queryString}`, { method: "DELETE", ...options });
 }
 async function optimizeGraphApi(options) {
   return _browser.browserApiRequest.call(void 0, "/api/v1/kg/graph/optimize", {
     method: "POST",
     body: {},
-    headers: options.graphId ? { "X-Graph-ID": options.graphId } : void 0,
+    headers: buildHeaders(options.graphId),
     ...options
   });
 }
 async function listDesignerNodesApi(options) {
-  const params = new URLSearchParams();
-  if (options.graphId) params.set("graphId", options.graphId);
-  const queryString = params.toString();
-  return _browser.browserApiRequest.call(void 0, `/api/v1/kg/designer/nodes${queryString ? `?${queryString}` : ""}`, { method: "GET", ...options });
+  const queryString = buildQueryString({ graphId: options.graphId });
+  return _browser.browserApiRequest.call(void 0, `/api/v1/kg/designer/nodes${queryString}`, { method: "GET", ...options });
 }
 async function getDesignerNodeApi(label, options) {
-  const params = new URLSearchParams();
-  if (options.graphId) params.set("graphId", options.graphId);
-  const queryString = params.toString();
-  return _browser.browserApiRequest.call(void 0, `/api/v1/kg/designer/nodes/${label}${queryString ? `?${queryString}` : ""}`, { method: "GET", ...options });
+  const queryString = buildQueryString({ graphId: options.graphId });
+  return _browser.browserApiRequest.call(void 0, `/api/v1/kg/designer/nodes/${label}${queryString}`, { method: "GET", ...options });
 }
 async function createDesignerNodeApi(node, options) {
   return _browser.browserApiRequest.call(void 0, "/api/v1/kg/designer/nodes", {
     method: "POST",
     body: { node },
-    headers: options.graphId ? { "X-Graph-ID": options.graphId } : void 0,
+    headers: buildHeaders(options.graphId),
     ...options
   });
 }
@@ -101,33 +108,27 @@ async function updateDesignerNodeApi(label, node, options) {
   return _browser.browserApiRequest.call(void 0, `/api/v1/kg/designer/nodes/${label}`, {
     method: "PUT",
     body: { node },
-    headers: options.graphId ? { "X-Graph-ID": options.graphId } : void 0,
+    headers: buildHeaders(options.graphId),
     ...options
   });
 }
 async function deleteDesignerNodeApi(label, options) {
-  const params = new URLSearchParams();
-  if (options.graphId) params.set("graphId", options.graphId);
-  const queryString = params.toString();
-  return _browser.browserApiRequest.call(void 0, `/api/v1/kg/designer/nodes/${label}${queryString ? `?${queryString}` : ""}`, { method: "DELETE", ...options });
+  const queryString = buildQueryString({ graphId: options.graphId });
+  return _browser.browserApiRequest.call(void 0, `/api/v1/kg/designer/nodes/${label}${queryString}`, { method: "DELETE", ...options });
 }
 async function listDesignerEdgesApi(options) {
-  const params = new URLSearchParams();
-  if (options.graphId) params.set("graphId", options.graphId);
-  const queryString = params.toString();
-  return _browser.browserApiRequest.call(void 0, `/api/v1/kg/designer/edges${queryString ? `?${queryString}` : ""}`, { method: "GET", ...options });
+  const queryString = buildQueryString({ graphId: options.graphId });
+  return _browser.browserApiRequest.call(void 0, `/api/v1/kg/designer/edges${queryString}`, { method: "GET", ...options });
 }
 async function getDesignerEdgeApi(label, options) {
-  const params = new URLSearchParams();
-  if (options.graphId) params.set("graphId", options.graphId);
-  const queryString = params.toString();
-  return _browser.browserApiRequest.call(void 0, `/api/v1/kg/designer/edges/${label}${queryString ? `?${queryString}` : ""}`, { method: "GET", ...options });
+  const queryString = buildQueryString({ graphId: options.graphId });
+  return _browser.browserApiRequest.call(void 0, `/api/v1/kg/designer/edges/${label}${queryString}`, { method: "GET", ...options });
 }
 async function createDesignerEdgeApi(edge, options) {
   return _browser.browserApiRequest.call(void 0, "/api/v1/kg/designer/edges", {
     method: "POST",
     body: { edge },
-    headers: options.graphId ? { "X-Graph-ID": options.graphId } : void 0,
+    headers: buildHeaders(options.graphId),
     ...options
   });
 }
@@ -135,52 +136,46 @@ async function updateDesignerEdgeApi(label, edge, options) {
   return _browser.browserApiRequest.call(void 0, `/api/v1/kg/designer/edges/${label}`, {
     method: "PUT",
     body: { edge },
-    headers: options.graphId ? { "X-Graph-ID": options.graphId } : void 0,
+    headers: buildHeaders(options.graphId),
     ...options
   });
 }
 async function deleteDesignerEdgeApi(label, options) {
-  const params = new URLSearchParams();
-  if (options.graphId) params.set("graphId", options.graphId);
-  const queryString = params.toString();
-  return _browser.browserApiRequest.call(void 0, `/api/v1/kg/designer/edges/${label}${queryString ? `?${queryString}` : ""}`, { method: "DELETE", ...options });
+  const queryString = buildQueryString({ graphId: options.graphId });
+  return _browser.browserApiRequest.call(void 0, `/api/v1/kg/designer/edges/${label}${queryString}`, { method: "DELETE", ...options });
 }
 async function listCrawlJobsApi(options) {
-  const params = new URLSearchParams();
-  if (options.graphId) params.set("graphId", options.graphId);
-  if (options.limit) params.set("limit", String(options.limit));
-  if (options.offset) params.set("offset", String(options.offset));
-  if (options.status) params.set("status", options.status);
-  const queryString = params.toString();
-  return _browser.browserApiRequest.call(void 0, `/api/v1/kg/crawl/jobs${queryString ? `?${queryString}` : ""}`, { method: "GET", ...options });
+  const queryString = buildQueryString({
+    graphId: options.graphId,
+    limit: _optionalChain([options, 'access', _ => _.limit, 'optionalAccess', _2 => _2.toString, 'call', _3 => _3()]),
+    offset: _optionalChain([options, 'access', _4 => _4.offset, 'optionalAccess', _5 => _5.toString, 'call', _6 => _6()]),
+    status: options.status
+  });
+  return _browser.browserApiRequest.call(void 0, `/api/v1/kg/crawl/jobs${queryString}`, { method: "GET", ...options });
 }
 async function startCrawlJobApi(params, options) {
   return _browser.browserApiRequest.call(void 0, "/api/v1/kg/crawl/jobs", {
     method: "POST",
     body: params,
-    headers: options.graphId ? { "X-Graph-ID": options.graphId } : void 0,
+    headers: buildHeaders(options.graphId),
     ...options
   });
 }
 async function getCrawlJobStatusApi(jobId, options) {
-  const params = new URLSearchParams();
-  if (options.graphId) params.set("graphId", options.graphId);
-  const queryString = params.toString();
-  return _browser.browserApiRequest.call(void 0, `/api/v1/kg/crawl/jobs/${jobId}${queryString ? `?${queryString}` : ""}`, { method: "GET", ...options });
+  const queryString = buildQueryString({ graphId: options.graphId });
+  return _browser.browserApiRequest.call(void 0, `/api/v1/kg/crawl/jobs/${jobId}${queryString}`, { method: "GET", ...options });
 }
 async function cancelCrawlJobApi(jobId, options) {
   return _browser.browserApiRequest.call(void 0, `/api/v1/kg/crawl/jobs/${jobId}/cancel`, {
     method: "POST",
     body: {},
-    headers: options.graphId ? { "X-Graph-ID": options.graphId } : void 0,
+    headers: buildHeaders(options.graphId),
     ...options
   });
 }
 async function getCrawledPagesApi(jobId, options) {
-  const params = new URLSearchParams();
-  if (options.graphId) params.set("graphId", options.graphId);
-  const queryString = params.toString();
-  return _browser.browserApiRequest.call(void 0, `/api/v1/kg/crawl/jobs/${jobId}/pages${queryString ? `?${queryString}` : ""}`, { method: "GET", ...options });
+  const queryString = buildQueryString({ graphId: options.graphId });
+  return _browser.browserApiRequest.call(void 0, `/api/v1/kg/crawl/jobs/${jobId}/pages${queryString}`, { method: "GET", ...options });
 }
 
 
@@ -214,4 +209,4 @@ async function getCrawledPagesApi(jobId, options) {
 
 
 exports.listGraphsApi = listGraphsApi; exports.getGraphApi = getGraphApi; exports.createGraphApi = createGraphApi; exports.updateGraphApi = updateGraphApi; exports.deleteGraphApi = deleteGraphApi; exports.queryGraphApi = queryGraphApi; exports.getGraphLabelsApi = getGraphLabelsApi; exports.getKGNodeApi = getKGNodeApi; exports.ingestKGNodeApi = ingestKGNodeApi; exports.updateKGNodeApi = updateKGNodeApi; exports.getNodeConnectionStatsApi = getNodeConnectionStatsApi; exports.ingestDocumentApi = ingestDocumentApi; exports.deleteKGDocumentApi = deleteKGDocumentApi; exports.optimizeGraphApi = optimizeGraphApi; exports.listDesignerNodesApi = listDesignerNodesApi; exports.getDesignerNodeApi = getDesignerNodeApi; exports.createDesignerNodeApi = createDesignerNodeApi; exports.updateDesignerNodeApi = updateDesignerNodeApi; exports.deleteDesignerNodeApi = deleteDesignerNodeApi; exports.listDesignerEdgesApi = listDesignerEdgesApi; exports.getDesignerEdgeApi = getDesignerEdgeApi; exports.createDesignerEdgeApi = createDesignerEdgeApi; exports.updateDesignerEdgeApi = updateDesignerEdgeApi; exports.deleteDesignerEdgeApi = deleteDesignerEdgeApi; exports.listCrawlJobsApi = listCrawlJobsApi; exports.startCrawlJobApi = startCrawlJobApi; exports.getCrawlJobStatusApi = getCrawlJobStatusApi; exports.cancelCrawlJobApi = cancelCrawlJobApi; exports.getCrawledPagesApi = getCrawledPagesApi;
-//# sourceMappingURL=chunk-4XIW5GLO.js.map
+//# sourceMappingURL=chunk-2TJCYLTP.js.map

package/dist/chunk-2TJCYLTP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/eloquent/eloquent/packages/@elqnt/kg/dist/chunk-2TJCYLTP.js","../api/index.ts"],"names":[],"mappings":"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","file":"/home/runner/work/eloquent/eloquent/packages/@elqnt/kg/dist/chunk-2TJCYLTP.js","sourcesContent":[null,"/**\n * Knowledge Graph Browser API\n *\n * Browser-side API client for KG operations.\n * Uses @elqnt/api-client for HTTP requests with automatic token management.\n *\n * @example\n * ```ts\n * import { listGraphsApi, queryGraphApi } from \"@elqnt/kg/api\";\n *\n * const graphs = await listGraphsApi({ baseUrl, orgId });\n * const result = await queryGraphApi(query, { baseUrl, orgId, graphId });\n * ```\n *\n * @packageDocumentation\n */\n\nimport { browserApiRequest } from \"@elqnt/api-client/browser\";\nimport type { ApiResponse, ApiClientOptions } from \"@elqnt/api-client\";\nimport type { ResponseMetadata } from \"@elqnt/types\";\nimport type {\n  Graph,\n  ListGraphsResult,\n  GetGraphResult,\n  CreateGraphResult,\n  CreateGraphRequest,\n  UpdateGraphResult,\n  DeleteGraphResult,\n  KGNode,\n  KGQuery,\n  KGQueryResult,\n  KGLabelInfo,\n  KGNodeIngestRequest,\n  KGSyncIngestResponse,\n  DeleteDocumentResponse,\n  GraphNodeDefinition,\n  GraphNodeResponse,\n  GraphEdgeDefinition,\n  GraphEdgeResponse,\n} from \"../models\";\n\n// =============================================================================\n// TYPES\n// =============================================================================\n\n/**\n * Options for KG API calls that may include a graph ID\n */\nexport interface KGApiOptions extends ApiClientOptions {\n  /** Optional graph ID for graph-scoped operations */\n  graphId?: string;\n}\n\n/**\n * Crawl job information\n */\nexport interface CrawlJob {\n  id: string;\n  baseUrl: string;\n  depth: number;\n  maxPages: number;\n  status: string;\n  pagesProcessed: number;\n  createdAt: string;\n  updatedAt: string;\n}\n\n/**\n * Response for listing crawl jobs\n */\nexport interface CrawlJobsListResponse {\n  jobs: CrawlJob[];\n  total: number;\n}\n\n/**\n * Response for crawl job status\n */\nexport interface CrawlJobStatusResponse {\n  job: CrawlJob;\n  success: boolean;\n}\n\n/**\n * Response for starting a crawl job\n */\nexport interface CrawlJobStartResponse {\n  jobId: string;\n  success: boolean;\n}\n\n/**\n * Response for listing crawled pages\n */\nexport interface CrawledPagesResponse {\n  pages: Array<{\n    url: string;\n    title: string;\n    status: string;\n    processedAt: string;\n  }>;\n  total: number;\n}\n\n// =============================================================================\n// UTILITIES\n// =============================================================================\n\n/**\n * Build query string from parameters, filtering out undefined values\n */\nfunction buildQueryString(params: Record<string, string | undefined>): string {\n  const searchParams = new URLSearchParams();\n  for (const [key, value] of Object.entries(params)) {\n    if (value !== undefined) {\n      searchParams.set(key, value);\n    }\n  }\n  const queryString = searchParams.toString();\n  return queryString ? `?${queryString}` : \"\";\n}\n\n/**\n * Build headers including X-Graph-ID if provided\n */\nfunction buildHeaders(graphId?: string): Record<string, string> | undefined {\n  return graphId ? { \"X-Graph-ID\": graphId } : undefined;\n}\n\n// =============================================================================\n// GRAPHS\n// =============================================================================\n\n/**\n * List all knowledge graphs for the organization\n *\n * @param options - API client options (baseUrl, orgId)\n * @returns List of graphs\n *\n * @example\n * ```ts\n * const response = await listGraphsApi({ baseUrl: \"http://api-gateway:80\", orgId: \"org-123\" });\n * if (response.data?.graphs) {\n *   console.log(\"Graphs:\", response.data.graphs);\n * }\n * ```\n */\nexport async function listGraphsApi(options: ApiClientOptions): Promise<ApiResponse<ListGraphsResult>> {\n  return browserApiRequest(\"/api/v1/kg/graphs\", { method: \"GET\", ...options });\n}\n\n/**\n * Get a specific knowledge graph by ID\n *\n * @param graphId - The graph ID\n * @param options - API client options\n * @returns The graph details\n */\nexport async function getGraphApi(graphId: string, options: ApiClientOptions): Promise<ApiResponse<GetGraphResult>> {\n  return browserApiRequest(`/api/v1/kg/graphs/${graphId}`, { method: \"GET\", ...options });\n}\n\n/**\n * Create a new knowledge graph\n *\n * @param graph - Graph creation request\n * @param options - API client options\n * @returns The created graph\n */\nexport async function createGraphApi(graph: CreateGraphRequest, options: ApiClientOptions): Promise<ApiResponse<CreateGraphResult>> {\n  return browserApiRequest(\"/api/v1/kg/graphs\", { method: \"POST\", body: graph, ...options });\n}\n\n/**\n * Update an existing knowledge graph\n *\n * @param graphId - The graph ID to update\n * @param updates - Partial graph updates\n * @param options - API client options\n * @returns The updated graph\n */\nexport async function updateGraphApi(\n  graphId: string,\n  updates: Partial<Graph>,\n  options: ApiClientOptions\n): Promise<ApiResponse<UpdateGraphResult>> {\n  return browserApiRequest(`/api/v1/kg/graphs/${graphId}`, { method: \"PUT\", body: updates, ...options });\n}\n\n/**\n * Delete a knowledge graph\n *\n * @param graphId - The graph ID to delete\n * @param options - API client options\n * @returns Success/failure result\n */\nexport async function deleteGraphApi(graphId: string, options: ApiClientOptions): Promise<ApiResponse<DeleteGraphResult>> {\n  return browserApiRequest(`/api/v1/kg/graphs/${graphId}`, { method: \"DELETE\", ...options });\n}\n\n// =============================================================================\n// QUERY & LABELS\n// =============================================================================\n\n/**\n * Query knowledge graph nodes\n *\n * @param query - The KG query parameters\n * @param options - API options including optional graphId\n * @returns Query results with matching nodes and edges\n *\n * @example\n * ```ts\n * const result = await queryGraphApi(\n *   { label: \"Person\", fields: [], limit: 10, depth: 1, sortBy: \"\", sortOrder: \"\" },\n *   { baseUrl, orgId, graphId }\n * );\n * ```\n */\nexport async function queryGraphApi(query: KGQuery, options: KGApiOptions): Promise<ApiResponse<KGQueryResult>> {\n  return browserApiRequest(\"/api/v1/kg/query\", {\n    method: \"POST\",\n    body: query,\n    timeout: 30000,\n    headers: buildHeaders(options.graphId),\n    ...options,\n  });\n}\n\n/**\n * Get all node labels in the knowledge graph\n *\n * @param options - API options including optional graphId\n * @returns List of labels with counts\n */\nexport async function getGraphLabelsApi(options: KGApiOptions): Promise<ApiResponse<{ labels: KGLabelInfo[] }>> {\n  const queryString = buildQueryString({ graphId: options.graphId });\n  return browserApiRequest(`/api/v1/kg/labels${queryString}`, { method: \"GET\", ...options });\n}\n\n// =============================================================================\n// NODES\n// =============================================================================\n\n/**\n * Get a specific KG node by ID\n *\n * @param nodeId - The node ID\n * @param options - API options including optional graphId\n * @returns The node details\n */\nexport async function getKGNodeApi(\n  nodeId: string,\n  options: KGApiOptions\n): Promise<ApiResponse<{ node: KGNode }>> {\n  const queryString = buildQueryString({ graphId: options.graphId });\n  return browserApiRequest(`/api/v1/kg/nodes/${nodeId}${queryString}`, { method: \"GET\", ...options });\n}\n\n/**\n * Ingest a new node into the knowledge graph\n *\n * @param node - Node ingest request\n * @param options - API options including optional graphId\n * @returns The created node ID\n */\nexport async function ingestKGNodeApi(\n  node: KGNodeIngestRequest,\n  options: KGApiOptions\n): Promise<ApiResponse<KGSyncIngestResponse>> {\n  return browserApiRequest(\"/api/v1/kg/nodes\", {\n    method: \"POST\",\n    body: node,\n    headers: buildHeaders(options.graphId),\n    ...options,\n  });\n}\n\n/**\n * Update an existing KG node\n *\n * @param nodeId - The node ID to update\n * @param updates - Partial node updates\n * @param options - API options including optional graphId\n * @returns Success/failure result\n */\nexport async function updateKGNodeApi(\n  nodeId: string,\n  updates: Partial<KGNode>,\n  options: KGApiOptions\n): Promise<ApiResponse<{ success: boolean; metadata: ResponseMetadata }>> {\n  return browserApiRequest(`/api/v1/kg/nodes/${nodeId}`, {\n    method: \"PUT\",\n    body: updates,\n    headers: buildHeaders(options.graphId),\n    ...options,\n  });\n}\n\n/**\n * Get connection statistics for a node\n *\n * @param nodeId - The node ID\n * @param edgeLabel - The edge label to filter by\n * @param options - API options including optional graphId\n * @returns Connection counts by label\n */\nexport async function getNodeConnectionStatsApi(\n  nodeId: string,\n  edgeLabel: string,\n  options: KGApiOptions\n): Promise<ApiResponse<Record<string, number>>> {\n  const queryString = buildQueryString({ edgeLabel, graphId: options.graphId });\n  return browserApiRequest(`/api/v1/kg/nodes/${nodeId}/connections${queryString}`, { method: \"GET\", ...options });\n}\n\n// =============================================================================\n// DOCUMENTS\n// =============================================================================\n\n/**\n * Ingest a document into the knowledge graph\n *\n * @param document - Document to ingest\n * @param options - API options including optional graphId\n * @returns Success/failure result\n */\nexport async function ingestDocumentApi(\n  document: { id: string; title: string; content: string; docUrl?: string; lang?: string },\n  options: KGApiOptions\n): Promise<ApiResponse<{ success: boolean; metadata: ResponseMetadata }>> {\n  return browserApiRequest(\"/api/v1/kg/ingest\", {\n    method: \"POST\",\n    body: document,\n    timeout: 120000,\n    headers: buildHeaders(options.graphId),\n    ...options,\n  });\n}\n\n/**\n * Delete a document from the knowledge graph\n *\n * @param documentId - The document ID to delete\n * @param options - API options including optional graphId\n * @returns Deletion result with counts\n */\nexport async function deleteKGDocumentApi(\n  documentId: string,\n  options: KGApiOptions\n): Promise<ApiResponse<DeleteDocumentResponse>> {\n  const queryString = buildQueryString({ graphId: options.graphId });\n  return browserApiRequest(`/api/v1/kg/documents/${documentId}${queryString}`, { method: \"DELETE\", ...options });\n}\n\n/**\n * Optimize the knowledge graph\n *\n * @param options - API options including optional graphId\n * @returns Success/failure result\n */\nexport async function optimizeGraphApi(options: KGApiOptions): Promise<ApiResponse<{ success: boolean; metadata: ResponseMetadata }>> {\n  return browserApiRequest(\"/api/v1/kg/graph/optimize\", {\n    method: \"POST\",\n    body: {},\n    headers: buildHeaders(options.graphId),\n    ...options,\n  });\n}\n\n// =============================================================================\n// DESIGNER - NODES\n// =============================================================================\n\n/**\n * List all node definitions in the graph designer\n *\n * @param options - API options including optional graphId\n * @returns List of node definitions\n */\nexport async function listDesignerNodesApi(options: KGApiOptions): Promise<ApiResponse<GraphNodeResponse>> {\n  const queryString = buildQueryString({ graphId: options.graphId });\n  return browserApiRequest(`/api/v1/kg/designer/nodes${queryString}`, { method: \"GET\", ...options });\n}\n\n/**\n * Get a specific node definition by label\n *\n * @param label - The node label\n * @param options - API options including optional graphId\n * @returns The node definition\n */\nexport async function getDesignerNodeApi(label: string, options: KGApiOptions): Promise<ApiResponse<GraphNodeResponse>> {\n  const queryString = buildQueryString({ graphId: options.graphId });\n  return browserApiRequest(`/api/v1/kg/designer/nodes/${label}${queryString}`, { method: \"GET\", ...options });\n}\n\n/**\n * Create a new node definition\n *\n * @param node - Node definition to create\n * @param options - API options including optional graphId\n * @returns The created node definition\n */\nexport async function createDesignerNodeApi(\n  node: Omit<GraphNodeDefinition, \"createdAt\" | \"updatedAt\">,\n  options: KGApiOptions\n): Promise<ApiResponse<GraphNodeResponse>> {\n  return browserApiRequest(\"/api/v1/kg/designer/nodes\", {\n    method: \"POST\",\n    body: { node },\n    headers: buildHeaders(options.graphId),\n    ...options,\n  });\n}\n\n/**\n * Update an existing node definition\n *\n * @param label - The node label to update\n * @param node - Partial node definition updates\n * @param options - API options including optional graphId\n * @returns The updated node definition\n */\nexport async function updateDesignerNodeApi(\n  label: string,\n  node: Partial<GraphNodeDefinition>,\n  options: KGApiOptions\n): Promise<ApiResponse<GraphNodeResponse>> {\n  return browserApiRequest(`/api/v1/kg/designer/nodes/${label}`, {\n    method: \"PUT\",\n    body: { node },\n    headers: buildHeaders(options.graphId),\n    ...options,\n  });\n}\n\n/**\n * Delete a node definition\n *\n * @param label - The node label to delete\n * @param options - API options including optional graphId\n * @returns Success/failure result\n */\nexport async function deleteDesignerNodeApi(\n  label: string,\n  options: KGApiOptions\n): Promise<ApiResponse<{ success: boolean; metadata: ResponseMetadata }>> {\n  const queryString = buildQueryString({ graphId: options.graphId });\n  return browserApiRequest(`/api/v1/kg/designer/nodes/${label}${queryString}`, { method: \"DELETE\", ...options });\n}\n\n// =============================================================================\n// DESIGNER - EDGES\n// =============================================================================\n\n/**\n * List all edge definitions in the graph designer\n *\n * @param options - API options including optional graphId\n * @returns List of edge definitions\n */\nexport async function listDesignerEdgesApi(options: KGApiOptions): Promise<ApiResponse<GraphEdgeResponse>> {\n  const queryString = buildQueryString({ graphId: options.graphId });\n  return browserApiRequest(`/api/v1/kg/designer/edges${queryString}`, { method: \"GET\", ...options });\n}\n\n/**\n * Get a specific edge definition by label\n *\n * @param label - The edge label\n * @param options - API options including optional graphId\n * @returns The edge definition\n */\nexport async function getDesignerEdgeApi(label: string, options: KGApiOptions): Promise<ApiResponse<GraphEdgeResponse>> {\n  const queryString = buildQueryString({ graphId: options.graphId });\n  return browserApiRequest(`/api/v1/kg/designer/edges/${label}${queryString}`, { method: \"GET\", ...options });\n}\n\n/**\n * Create a new edge definition\n *\n * @param edge - Edge definition to create\n * @param options - API options including optional graphId\n * @returns The created edge definition\n */\nexport async function createDesignerEdgeApi(\n  edge: Omit<GraphEdgeDefinition, \"createdAt\" | \"updatedAt\">,\n  options: KGApiOptions\n): Promise<ApiResponse<GraphEdgeResponse>> {\n  return browserApiRequest(\"/api/v1/kg/designer/edges\", {\n    method: \"POST\",\n    body: { edge },\n    headers: buildHeaders(options.graphId),\n    ...options,\n  });\n}\n\n/**\n * Update an existing edge definition\n *\n * @param label - The edge label to update\n * @param edge - Partial edge definition updates\n * @param options - API options including optional graphId\n * @returns The updated edge definition\n */\nexport async function updateDesignerEdgeApi(\n  label: string,\n  edge: Partial<GraphEdgeDefinition>,\n  options: KGApiOptions\n): Promise<ApiResponse<GraphEdgeResponse>> {\n  return browserApiRequest(`/api/v1/kg/designer/edges/${label}`, {\n    method: \"PUT\",\n    body: { edge },\n    headers: buildHeaders(options.graphId),\n    ...options,\n  });\n}\n\n/**\n * Delete an edge definition\n *\n * @param label - The edge label to delete\n * @param options - API options including optional graphId\n * @returns Success/failure result\n */\nexport async function deleteDesignerEdgeApi(\n  label: string,\n  options: KGApiOptions\n): Promise<ApiResponse<{ success: boolean; metadata: ResponseMetadata }>> {\n  const queryString = buildQueryString({ graphId: options.graphId });\n  return browserApiRequest(`/api/v1/kg/designer/edges/${label}${queryString}`, { method: \"DELETE\", ...options });\n}\n\n// =============================================================================\n// CRAWL JOBS\n// =============================================================================\n\n/**\n * List crawl jobs\n *\n * @param options - API options including optional graphId, limit, offset, status\n * @returns List of crawl jobs with total count\n */\nexport async function listCrawlJobsApi(\n  options: KGApiOptions & { limit?: number; offset?: number; status?: string }\n): Promise<ApiResponse<CrawlJobsListResponse>> {\n  const queryString = buildQueryString({\n    graphId: options.graphId,\n    limit: options.limit?.toString(),\n    offset: options.offset?.toString(),\n    status: options.status,\n  });\n  return browserApiRequest(`/api/v1/kg/crawl/jobs${queryString}`, { method: \"GET\", ...options });\n}\n\n/**\n * Start a new crawl job\n *\n * @param params - Crawl job parameters\n * @param options - API options including optional graphId\n * @returns The created job ID\n */\nexport async function startCrawlJobApi(\n  params: { baseUrl: string; depth: number; maxPages: number },\n  options: KGApiOptions\n): Promise<ApiResponse<CrawlJobStartResponse>> {\n  return browserApiRequest(\"/api/v1/kg/crawl/jobs\", {\n    method: \"POST\",\n    body: params,\n    headers: buildHeaders(options.graphId),\n    ...options,\n  });\n}\n\n/**\n * Get crawl job status\n *\n * @param jobId - The job ID\n * @param options - API options including optional graphId\n * @returns The job status\n */\nexport async function getCrawlJobStatusApi(\n  jobId: string,\n  options: KGApiOptions\n): Promise<ApiResponse<CrawlJobStatusResponse>> {\n  const queryString = buildQueryString({ graphId: options.graphId });\n  return browserApiRequest(`/api/v1/kg/crawl/jobs/${jobId}${queryString}`, { method: \"GET\", ...options });\n}\n\n/**\n * Cancel a crawl job\n *\n * @param jobId - The job ID to cancel\n * @param options - API options including optional graphId\n * @returns The updated job status\n */\nexport async function cancelCrawlJobApi(\n  jobId: string,\n  options: KGApiOptions\n): Promise<ApiResponse<CrawlJobStatusResponse>> {\n  return browserApiRequest(`/api/v1/kg/crawl/jobs/${jobId}/cancel`, {\n    method: \"POST\",\n    body: {},\n    headers: buildHeaders(options.graphId),\n    ...options,\n  });\n}\n\n/**\n * Get pages crawled by a job\n *\n * @param jobId - The job ID\n * @param options - API options including optional graphId\n * @returns List of crawled pages\n */\nexport async function getCrawledPagesApi(\n  jobId: string,\n  options: KGApiOptions\n): Promise<ApiResponse<CrawledPagesResponse>> {\n  const queryString = buildQueryString({ graphId: options.graphId });\n  return browserApiRequest(`/api/v1/kg/crawl/jobs/${jobId}/pages${queryString}`, { method: \"GET\", ...options });\n}\n"]}