@contractspec/example.integration-hub 3.7.7 → 3.8.4

package/dist/ui/renderers/index.js

@@ -1,4 +1,205 @@
 // @bun
+// 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 = [
   {
@@ -136,6 +337,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");
@@ -155,12 +357,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" : "\u26AB";
       lines.push(`| ${integration.name} | ${integration.type} | ${integration.connectionCount} | ${statusIcon} ${integration.status} |`);

package/dist/ui/renderers/integration.markdown.d.ts

@@ -1,7 +1,7 @@
 /**
  * Markdown renderers for Integration Hub presentations
  */
-import type { PresentationRenderer } from '@contractspec/lib.contracts-spec/presentations/transform-engine';
+import type { PresentationRenderer } from '@contractspec/lib.presentation-runtime-core/transform-engine';
 /**
  * Markdown renderer for Integration Dashboard
  */

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

@@ -1,4 +1,205 @@
 // @bun
+// 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 = [
   {
@@ -136,6 +337,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");
@@ -155,12 +357,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" : "\u26AB";
       lines.push(`| ${integration.name} | ${integration.type} | ${integration.connectionCount} | ${statusIcon} ${integration.status} |`);

package/dist/ui/tables/ConnectionsTable.d.ts

@@ -0,0 +1,4 @@
+import type { Connection } from '../../handlers/integration.handlers';
+export declare function ConnectionsTable({ connections, }: {
+    connections: Connection[];
+}): import("react/jsx-runtime").JSX.Element;