@contractspec/example.integration-hub 3.7.7 → 3.8.2

package/dist/node/ui/renderers/index.js

@@ -1,3 +1,204 @@
+// src/visualizations/catalog.ts
+import {
+  defineVisualization,
+  VisualizationRegistry
+} from "@contractspec/lib.contracts-spec/visualizations";
+var INTEGRATION_LIST_REF = {
+  key: "integration.list",
+  version: "1.0.0"
+};
+var CONNECTION_LIST_REF = {
+  key: "integration.connection.list",
+  version: "1.0.0"
+};
+var SYNC_CONFIG_REF = {
+  key: "integration.syncConfig.list",
+  version: "1.0.0"
+};
+var META = {
+  version: "1.0.0",
+  domain: "integration",
+  stability: "experimental",
+  owners: ["@example.integration-hub"],
+  tags: ["integration", "visualization", "sync"]
+};
+var IntegrationTypeVisualization = defineVisualization({
+  meta: {
+    ...META,
+    key: "integration-hub.visualization.integration-types",
+    title: "Integration Types",
+    description: "Distribution of configured integration categories.",
+    goal: "Show where integration coverage is concentrated.",
+    context: "Integration overview."
+  },
+  source: { primary: INTEGRATION_LIST_REF, resultPath: "data" },
+  visualization: {
+    kind: "pie",
+    nameDimension: "type",
+    valueMeasure: "count",
+    dimensions: [
+      { key: "type", label: "Type", dataPath: "type", type: "category" }
+    ],
+    measures: [
+      { key: "count", label: "Count", dataPath: "count", format: "number" }
+    ],
+    table: { caption: "Integration counts by type." }
+  }
+});
+var ConnectionStatusVisualization = defineVisualization({
+  meta: {
+    ...META,
+    key: "integration-hub.visualization.connection-status",
+    title: "Connection Status",
+    description: "Status distribution across configured connections.",
+    goal: "Highlight connection health and instability.",
+    context: "Connection monitoring."
+  },
+  source: { primary: CONNECTION_LIST_REF, resultPath: "data" },
+  visualization: {
+    kind: "cartesian",
+    variant: "bar",
+    xDimension: "status",
+    yMeasures: ["count"],
+    dimensions: [
+      { key: "status", label: "Status", dataPath: "status", type: "category" }
+    ],
+    measures: [
+      {
+        key: "count",
+        label: "Connections",
+        dataPath: "count",
+        format: "number",
+        color: "#1d4ed8"
+      }
+    ],
+    table: { caption: "Connection counts by status." }
+  }
+});
+var HealthySyncMetricVisualization = defineVisualization({
+  meta: {
+    ...META,
+    key: "integration-hub.visualization.sync-healthy",
+    title: "Healthy Syncs",
+    description: "Sync configurations currently healthy or recently successful.",
+    goal: "Summarize healthy synchronization capacity.",
+    context: "Sync-state comparison."
+  },
+  source: { primary: SYNC_CONFIG_REF, resultPath: "data" },
+  visualization: {
+    kind: "metric",
+    measure: "value",
+    measures: [
+      { key: "value", label: "Syncs", dataPath: "value", format: "number" }
+    ],
+    table: { caption: "Healthy sync count." }
+  }
+});
+var AttentionSyncMetricVisualization = defineVisualization({
+  meta: {
+    ...META,
+    key: "integration-hub.visualization.sync-attention",
+    title: "Attention Needed",
+    description: "Sync configurations paused, failing, or otherwise needing review.",
+    goal: "Summarize syncs needing action.",
+    context: "Sync-state comparison."
+  },
+  source: { primary: SYNC_CONFIG_REF, resultPath: "data" },
+  visualization: {
+    kind: "metric",
+    measure: "value",
+    measures: [
+      { key: "value", label: "Syncs", dataPath: "value", format: "number" }
+    ],
+    table: { caption: "Syncs requiring attention." }
+  }
+});
+var IntegrationVisualizationSpecs = [
+  IntegrationTypeVisualization,
+  ConnectionStatusVisualization,
+  HealthySyncMetricVisualization,
+  AttentionSyncMetricVisualization
+];
+var IntegrationVisualizationRegistry = new VisualizationRegistry([
+  ...IntegrationVisualizationSpecs
+]);
+var IntegrationVisualizationRefs = IntegrationVisualizationSpecs.map((spec) => ({
+  key: spec.meta.key,
+  version: spec.meta.version
+}));
+
+// src/visualizations/selectors.ts
+function isHealthySync(status) {
+  return status === "ACTIVE" || status === "SUCCESS";
+}
+function createIntegrationVisualizationSections(integrations, connections, syncConfigs) {
+  const integrationTypes = new Map;
+  const connectionStatuses = new Map;
+  let healthySyncs = 0;
+  let attentionSyncs = 0;
+  for (const integration of integrations) {
+    integrationTypes.set(integration.type, (integrationTypes.get(integration.type) ?? 0) + 1);
+  }
+  for (const connection of connections) {
+    connectionStatuses.set(connection.status, (connectionStatuses.get(connection.status) ?? 0) + 1);
+  }
+  for (const syncConfig of syncConfigs) {
+    if (isHealthySync(syncConfig.status)) {
+      healthySyncs += 1;
+    } else {
+      attentionSyncs += 1;
+    }
+  }
+  const primaryItems = [
+    {
+      key: "integration-types",
+      spec: IntegrationTypeVisualization,
+      data: {
+        data: Array.from(integrationTypes.entries()).map(([type, count]) => ({
+          type,
+          count
+        }))
+      },
+      title: "Integration Types",
+      description: "Configured integrations grouped by category.",
+      height: 260
+    },
+    {
+      key: "connection-status",
+      spec: ConnectionStatusVisualization,
+      data: {
+        data: Array.from(connectionStatuses.entries()).map(([status, count]) => ({
+          status,
+          count
+        }))
+      },
+      title: "Connection Status",
+      description: "Operational health across current connections."
+    }
+  ];
+  const comparisonItems = [
+    {
+      key: "healthy-syncs",
+      spec: HealthySyncMetricVisualization,
+      data: { data: [{ value: healthySyncs }] },
+      title: "Healthy Syncs",
+      description: "Active or recently successful sync configurations.",
+      height: 200
+    },
+    {
+      key: "attention-syncs",
+      spec: AttentionSyncMetricVisualization,
+      data: { data: [{ value: attentionSyncs }] },
+      title: "Attention Needed",
+      description: "Paused, failed, or degraded sync configurations.",
+      height: 200
+    }
+  ];
+  return {
+    primaryItems,
+    comparisonItems
+  };
+}
 // src/ui/renderers/integration.markdown.ts
 var mockIntegrations = [
   {
@@ -135,6 +336,7 @@ var integrationDashboardMarkdownRenderer = {
     const integrations = mockIntegrations;
     const connections = mockConnections;
     const syncs = mockSyncConfigs;
+    const visualizations = createIntegrationVisualizationSections(integrations, connections, syncs);
     const activeIntegrations = integrations.filter((i) => i.status === "ACTIVE");
     const connectedConnections = connections.filter((c) => c.status === "CONNECTED");
     const errorConnections = connections.filter((c) => c.status === "ERROR");
@@ -154,12 +356,21 @@ var integrationDashboardMarkdownRenderer = {
       `| Error Connections | ${errorConnections.length} |`,
       `| Sync Configs | ${syncs.length} |`,
       `| Records Synced (24h) | ${totalRecordsSynced.toLocaleString()} |`,
-      "",
-      "## Integrations",
-      "",
-      "| Name | Type | Connections | Status |",
-      "|------|------|-------------|--------|"
+      ""
     ];
+    lines.push("## Visualization Overview");
+    lines.push("");
+    for (const item of [
+      ...visualizations.primaryItems,
+      ...visualizations.comparisonItems
+    ]) {
+      lines.push(`- **${item.title}** via \`${item.spec.meta.key}\``);
+    }
+    lines.push("");
+    lines.push("## Integrations");
+    lines.push("");
+    lines.push("| Name | Type | Connections | Status |");
+    lines.push("|------|------|-------------|--------|");
     for (const integration of integrations) {
       const statusIcon = integration.status === "ACTIVE" ? "\uD83D\uDFE2" : "⚫";
       lines.push(`| ${integration.name} | ${integration.type} | ${integration.connectionCount} | ${statusIcon} ${integration.status} |`);

package/dist/node/ui/renderers/integration.markdown.js

@@ -1,3 +1,204 @@
+// src/visualizations/catalog.ts
+import {
+  defineVisualization,
+  VisualizationRegistry
+} from "@contractspec/lib.contracts-spec/visualizations";
+var INTEGRATION_LIST_REF = {
+  key: "integration.list",
+  version: "1.0.0"
+};
+var CONNECTION_LIST_REF = {
+  key: "integration.connection.list",
+  version: "1.0.0"
+};
+var SYNC_CONFIG_REF = {
+  key: "integration.syncConfig.list",
+  version: "1.0.0"
+};
+var META = {
+  version: "1.0.0",
+  domain: "integration",
+  stability: "experimental",
+  owners: ["@example.integration-hub"],
+  tags: ["integration", "visualization", "sync"]
+};
+var IntegrationTypeVisualization = defineVisualization({
+  meta: {
+    ...META,
+    key: "integration-hub.visualization.integration-types",
+    title: "Integration Types",
+    description: "Distribution of configured integration categories.",
+    goal: "Show where integration coverage is concentrated.",
+    context: "Integration overview."
+  },
+  source: { primary: INTEGRATION_LIST_REF, resultPath: "data" },
+  visualization: {
+    kind: "pie",
+    nameDimension: "type",
+    valueMeasure: "count",
+    dimensions: [
+      { key: "type", label: "Type", dataPath: "type", type: "category" }
+    ],
+    measures: [
+      { key: "count", label: "Count", dataPath: "count", format: "number" }
+    ],
+    table: { caption: "Integration counts by type." }
+  }
+});
+var ConnectionStatusVisualization = defineVisualization({
+  meta: {
+    ...META,
+    key: "integration-hub.visualization.connection-status",
+    title: "Connection Status",
+    description: "Status distribution across configured connections.",
+    goal: "Highlight connection health and instability.",
+    context: "Connection monitoring."
+  },
+  source: { primary: CONNECTION_LIST_REF, resultPath: "data" },
+  visualization: {
+    kind: "cartesian",
+    variant: "bar",
+    xDimension: "status",
+    yMeasures: ["count"],
+    dimensions: [
+      { key: "status", label: "Status", dataPath: "status", type: "category" }
+    ],
+    measures: [
+      {
+        key: "count",
+        label: "Connections",
+        dataPath: "count",
+        format: "number",
+        color: "#1d4ed8"
+      }
+    ],
+    table: { caption: "Connection counts by status." }
+  }
+});
+var HealthySyncMetricVisualization = defineVisualization({
+  meta: {
+    ...META,
+    key: "integration-hub.visualization.sync-healthy",
+    title: "Healthy Syncs",
+    description: "Sync configurations currently healthy or recently successful.",
+    goal: "Summarize healthy synchronization capacity.",
+    context: "Sync-state comparison."
+  },
+  source: { primary: SYNC_CONFIG_REF, resultPath: "data" },
+  visualization: {
+    kind: "metric",
+    measure: "value",
+    measures: [
+      { key: "value", label: "Syncs", dataPath: "value", format: "number" }
+    ],
+    table: { caption: "Healthy sync count." }
+  }
+});
+var AttentionSyncMetricVisualization = defineVisualization({
+  meta: {
+    ...META,
+    key: "integration-hub.visualization.sync-attention",
+    title: "Attention Needed",
+    description: "Sync configurations paused, failing, or otherwise needing review.",
+    goal: "Summarize syncs needing action.",
+    context: "Sync-state comparison."
+  },
+  source: { primary: SYNC_CONFIG_REF, resultPath: "data" },
+  visualization: {
+    kind: "metric",
+    measure: "value",
+    measures: [
+      { key: "value", label: "Syncs", dataPath: "value", format: "number" }
+    ],
+    table: { caption: "Syncs requiring attention." }
+  }
+});
+var IntegrationVisualizationSpecs = [
+  IntegrationTypeVisualization,
+  ConnectionStatusVisualization,
+  HealthySyncMetricVisualization,
+  AttentionSyncMetricVisualization
+];
+var IntegrationVisualizationRegistry = new VisualizationRegistry([
+  ...IntegrationVisualizationSpecs
+]);
+var IntegrationVisualizationRefs = IntegrationVisualizationSpecs.map((spec) => ({
+  key: spec.meta.key,
+  version: spec.meta.version
+}));
+
+// src/visualizations/selectors.ts
+function isHealthySync(status) {
+  return status === "ACTIVE" || status === "SUCCESS";
+}
+function createIntegrationVisualizationSections(integrations, connections, syncConfigs) {
+  const integrationTypes = new Map;
+  const connectionStatuses = new Map;
+  let healthySyncs = 0;
+  let attentionSyncs = 0;
+  for (const integration of integrations) {
+    integrationTypes.set(integration.type, (integrationTypes.get(integration.type) ?? 0) + 1);
+  }
+  for (const connection of connections) {
+    connectionStatuses.set(connection.status, (connectionStatuses.get(connection.status) ?? 0) + 1);
+  }
+  for (const syncConfig of syncConfigs) {
+    if (isHealthySync(syncConfig.status)) {
+      healthySyncs += 1;
+    } else {
+      attentionSyncs += 1;
+    }
+  }
+  const primaryItems = [
+    {
+      key: "integration-types",
+      spec: IntegrationTypeVisualization,
+      data: {
+        data: Array.from(integrationTypes.entries()).map(([type, count]) => ({
+          type,
+          count
+        }))
+      },
+      title: "Integration Types",
+      description: "Configured integrations grouped by category.",
+      height: 260
+    },
+    {
+      key: "connection-status",
+      spec: ConnectionStatusVisualization,
+      data: {
+        data: Array.from(connectionStatuses.entries()).map(([status, count]) => ({
+          status,
+          count
+        }))
+      },
+      title: "Connection Status",
+      description: "Operational health across current connections."
+    }
+  ];
+  const comparisonItems = [
+    {
+      key: "healthy-syncs",
+      spec: HealthySyncMetricVisualization,
+      data: { data: [{ value: healthySyncs }] },
+      title: "Healthy Syncs",
+      description: "Active or recently successful sync configurations.",
+      height: 200
+    },
+    {
+      key: "attention-syncs",
+      spec: AttentionSyncMetricVisualization,
+      data: { data: [{ value: attentionSyncs }] },
+      title: "Attention Needed",
+      description: "Paused, failed, or degraded sync configurations.",
+      height: 200
+    }
+  ];
+  return {
+    primaryItems,
+    comparisonItems
+  };
+}
 // src/ui/renderers/integration.markdown.ts
 var mockIntegrations = [
   {
@@ -135,6 +336,7 @@ var integrationDashboardMarkdownRenderer = {
     const integrations = mockIntegrations;
     const connections = mockConnections;
     const syncs = mockSyncConfigs;
+    const visualizations = createIntegrationVisualizationSections(integrations, connections, syncs);
     const activeIntegrations = integrations.filter((i) => i.status === "ACTIVE");
     const connectedConnections = connections.filter((c) => c.status === "CONNECTED");
     const errorConnections = connections.filter((c) => c.status === "ERROR");
@@ -154,12 +356,21 @@ var integrationDashboardMarkdownRenderer = {
       `| Error Connections | ${errorConnections.length} |`,
       `| Sync Configs | ${syncs.length} |`,
       `| Records Synced (24h) | ${totalRecordsSynced.toLocaleString()} |`,
-      "",
-      "## Integrations",
-      "",
-      "| Name | Type | Connections | Status |",
-      "|------|------|-------------|--------|"
+      ""
     ];
+    lines.push("## Visualization Overview");
+    lines.push("");
+    for (const item of [
+      ...visualizations.primaryItems,
+      ...visualizations.comparisonItems
+    ]) {
+      lines.push(`- **${item.title}** via \`${item.spec.meta.key}\``);
+    }
+    lines.push("");
+    lines.push("## Integrations");
+    lines.push("");
+    lines.push("| Name | Type | Connections | Status |");
+    lines.push("|------|------|-------------|--------|");
     for (const integration of integrations) {
       const statusIcon = integration.status === "ACTIVE" ? "\uD83D\uDFE2" : "⚫";
       lines.push(`| ${integration.name} | ${integration.type} | ${integration.connectionCount} | ${statusIcon} ${integration.status} |`);

package/dist/node/ui/tables/ConnectionsTable.js

@@ -0,0 +1,211 @@
+// src/ui/tables/integration-table.shared.tsx
+import { Button } from "@contractspec/lib.design-system";
+import { Badge } from "@contractspec/lib.ui-kit-web/ui/badge";
+import { HStack } from "@contractspec/lib.ui-kit-web/ui/stack";
+import { jsxDEV } from "react/jsx-dev-runtime";
+"use client";
+var STATUS_VARIANTS = {
+  ACTIVE: "default",
+  CONNECTED: "default",
+  SUCCESS: "default",
+  PENDING: "secondary",
+  PAUSED: "secondary",
+  ERROR: "destructive",
+  DISCONNECTED: "outline"
+};
+function formatDateTime(value) {
+  return value ? value.toLocaleString() : "Never";
+}
+function formatJson(value) {
+  return value ? JSON.stringify(value, null, 2) : "No configuration";
+}
+function StatusBadge({ status }) {
+  return /* @__PURE__ */ jsxDEV(Badge, {
+    variant: STATUS_VARIANTS[status] ?? "outline",
+    children: status
+  }, undefined, false, undefined, this);
+}
+function IntegrationTableToolbar({
+  controller,
+  label,
+  toggleColumnId,
+  toggleVisibleLabel,
+  toggleHiddenLabel,
+  pinColumnId,
+  pinLabel,
+  resizeColumnId,
+  resizeLabel
+}) {
+  const firstRow = controller.rows[0];
+  const toggleColumn = controller.columns.find((column) => column.id === toggleColumnId);
+  const pinColumn = controller.columns.find((column) => column.id === pinColumnId);
+  const resizeColumn = controller.columns.find((column) => column.id === resizeColumnId);
+  const pinTarget = pinColumn?.pinState === "left" ? false : "left";
+  return /* @__PURE__ */ jsxDEV(HStack, {
+    gap: "sm",
+    className: "flex-wrap",
+    children: [
+      /* @__PURE__ */ jsxDEV(Badge, {
+        variant: "outline",
+        children: label
+      }, undefined, false, undefined, this),
+      /* @__PURE__ */ jsxDEV(Button, {
+        variant: "outline",
+        size: "sm",
+        onPress: () => firstRow?.toggleExpanded?.(!firstRow?.isExpanded),
+        children: "Expand First Row"
+      }, undefined, false, undefined, this),
+      /* @__PURE__ */ jsxDEV(Button, {
+        variant: "outline",
+        size: "sm",
+        onPress: () => toggleColumn?.toggleVisibility?.(!toggleColumn?.visible),
+        children: toggleColumn?.visible ? toggleVisibleLabel : toggleHiddenLabel
+      }, undefined, false, undefined, this),
+      /* @__PURE__ */ jsxDEV(Button, {
+        variant: "outline",
+        size: "sm",
+        onPress: () => pinColumn?.pin?.(pinTarget),
+        children: pinColumn?.pinState === "left" ? `Unpin ${pinLabel}` : `Pin ${pinLabel}`
+      }, undefined, false, undefined, this),
+      /* @__PURE__ */ jsxDEV(Button, {
+        variant: "outline",
+        size: "sm",
+        onPress: () => resizeColumn?.resizeBy?.(40),
+        children: resizeLabel
+      }, undefined, false, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+
+// src/ui/tables/ConnectionsTable.tsx
+import { DataTable } from "@contractspec/lib.design-system";
+import { useContractTable } from "@contractspec/lib.presentation-runtime-react";
+import { VStack } from "@contractspec/lib.ui-kit-web/ui/stack";
+import { Text } from "@contractspec/lib.ui-kit-web/ui/text";
+import { jsxDEV as jsxDEV2 } from "react/jsx-dev-runtime";
+"use client";
+function ConnectionsTable({
+  connections
+}) {
+  const controller = useContractTable({
+    data: connections,
+    columns: [
+      {
+        id: "connection",
+        header: "Connection",
+        label: "Connection",
+        accessor: (connection) => connection.name,
+        cell: ({ item }) => /* @__PURE__ */ jsxDEV2(VStack, {
+          gap: "xs",
+          children: [
+            /* @__PURE__ */ jsxDEV2(Text, {
+              className: "font-medium text-sm",
+              children: item.name
+            }, undefined, false, undefined, this),
+            /* @__PURE__ */ jsxDEV2(Text, {
+              className: "text-muted-foreground text-xs",
+              children: [
+                "Created ",
+                item.createdAt.toLocaleDateString()
+              ]
+            }, undefined, true, undefined, this)
+          ]
+        }, undefined, true, undefined, this),
+        size: 240,
+        minSize: 180,
+        canSort: true,
+        canPin: true,
+        canResize: true
+      },
+      {
+        id: "status",
+        header: "Status",
+        label: "Status",
+        accessorKey: "status",
+        cell: ({ value }) => /* @__PURE__ */ jsxDEV2(StatusBadge, {
+          status: String(value)
+        }, undefined, false, undefined, this),
+        size: 150,
+        canSort: true,
+        canPin: true,
+        canResize: true
+      },
+      {
+        id: "lastSyncAt",
+        header: "Last Sync",
+        label: "Last Sync",
+        accessor: (connection) => connection.lastSyncAt?.getTime() ?? 0,
+        cell: ({ item }) => formatDateTime(item.lastSyncAt),
+        size: 200,
+        canSort: true,
+        canHide: true,
+        canResize: true
+      },
+      {
+        id: "errorMessage",
+        header: "Errors",
+        label: "Errors",
+        accessor: (connection) => connection.errorMessage ?? "",
+        cell: ({ value }) => String(value || "No errors"),
+        size: 240,
+        canHide: true,
+        canResize: true
+      }
+    ],
+    initialState: {
+      pagination: { pageIndex: 0, pageSize: 3 },
+      columnVisibility: { errorMessage: false },
+      columnPinning: { left: ["connection"], right: [] }
+    },
+    renderExpandedContent: (connection) => /* @__PURE__ */ jsxDEV2(VStack, {
+      gap: "sm",
+      className: "py-2",
+      children: [
+        /* @__PURE__ */ jsxDEV2(Text, {
+          className: "font-medium text-sm",
+          children: "Credentials"
+        }, undefined, false, undefined, this),
+        /* @__PURE__ */ jsxDEV2("pre", {
+          className: "overflow-auto rounded-md bg-muted/40 p-3 text-xs",
+          children: formatJson(connection.credentials)
+        }, undefined, false, undefined, this),
+        /* @__PURE__ */ jsxDEV2(Text, {
+          className: "font-medium text-sm",
+          children: "Config"
+        }, undefined, false, undefined, this),
+        /* @__PURE__ */ jsxDEV2("pre", {
+          className: "overflow-auto rounded-md bg-muted/40 p-3 text-xs",
+          children: formatJson(connection.config)
+        }, undefined, false, undefined, this),
+        /* @__PURE__ */ jsxDEV2(Text, {
+          className: "text-muted-foreground text-sm",
+          children: connection.errorMessage ?? "No sync errors recorded."
+        }, undefined, false, undefined, this)
+      ]
+    }, undefined, true, undefined, this),
+    getCanExpand: () => true
+  });
+  return /* @__PURE__ */ jsxDEV2(DataTable, {
+    controller,
+    title: "Connections",
+    description: "Client-mode ContractSpec table with visibility, pinning, resizing, and expanded diagnostics.",
+    toolbar: /* @__PURE__ */ jsxDEV2(IntegrationTableToolbar, {
+      controller,
+      label: `${connections.length} total connections`,
+      toggleColumnId: "errorMessage",
+      toggleVisibleLabel: "Hide Error Column",
+      toggleHiddenLabel: "Show Error Column",
+      pinColumnId: "status",
+      pinLabel: "Status",
+      resizeColumnId: "connection",
+      resizeLabel: "Widen Connection"
+    }, undefined, false, undefined, this),
+    emptyState: /* @__PURE__ */ jsxDEV2("div", {
+      className: "rounded-md border border-dashed p-8 text-center text-muted-foreground text-sm",
+      children: "No connections found"
+    }, undefined, false, undefined, this)
+  }, undefined, false, undefined, this);
+}
+export {
+  ConnectionsTable
+};