@contractspec/example.integration-hub 3.7.6 → 3.8.2

package/dist/ui/tables/integration-table.shared.js

@@ -0,0 +1,85 @@
+// @bun
+// 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);
+}
+export {
+  formatJson,
+  formatDateTime,
+  StatusBadge,
+  IntegrationTableToolbar
+};

package/dist/visualizations/catalog.d.ts

@@ -0,0 +1,11 @@
+import { VisualizationRegistry } from '@contractspec/lib.contracts-spec/visualizations';
+export declare const IntegrationTypeVisualization: import("@contractspec/lib.contracts-spec").VisualizationSpec;
+export declare const ConnectionStatusVisualization: import("@contractspec/lib.contracts-spec").VisualizationSpec;
+export declare const HealthySyncMetricVisualization: import("@contractspec/lib.contracts-spec").VisualizationSpec;
+export declare const AttentionSyncMetricVisualization: import("@contractspec/lib.contracts-spec").VisualizationSpec;
+export declare const IntegrationVisualizationSpecs: readonly [import("@contractspec/lib.contracts-spec").VisualizationSpec, import("@contractspec/lib.contracts-spec").VisualizationSpec, import("@contractspec/lib.contracts-spec").VisualizationSpec, import("@contractspec/lib.contracts-spec").VisualizationSpec];
+export declare const IntegrationVisualizationRegistry: VisualizationRegistry;
+export declare const IntegrationVisualizationRefs: {
+    key: string;
+    version: string;
+}[];

package/dist/visualizations/catalog.js

@@ -0,0 +1,138 @@
+// @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
+}));
+export {
+  IntegrationVisualizationSpecs,
+  IntegrationVisualizationRegistry,
+  IntegrationVisualizationRefs,
+  IntegrationTypeVisualization,
+  HealthySyncMetricVisualization,
+  ConnectionStatusVisualization,
+  AttentionSyncMetricVisualization
+};

package/dist/visualizations/index.d.ts

@@ -0,0 +1,2 @@
+export * from './catalog';
+export * from './selectors';

package/dist/visualizations/index.js

@@ -0,0 +1,212 @@
+// @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
+  };
+}
+export {
+  createIntegrationVisualizationSections,
+  IntegrationVisualizationSpecs,
+  IntegrationVisualizationRegistry,
+  IntegrationVisualizationRefs,
+  IntegrationTypeVisualization,
+  HealthySyncMetricVisualization,
+  ConnectionStatusVisualization,
+  AttentionSyncMetricVisualization
+};

package/dist/visualizations/selectors.d.ts

@@ -0,0 +1,10 @@
+import type { VisualizationSurfaceItem } from '@contractspec/lib.design-system';
+import type { Connection, Integration, SyncConfig } from '../handlers/integration.handlers';
+interface SyncLike extends Pick<SyncConfig, 'recordsSynced'> {
+    status: string;
+}
+export declare function createIntegrationVisualizationSections(integrations: Pick<Integration, 'type'>[], connections: Pick<Connection, 'status'>[], syncConfigs: SyncLike[]): {
+    primaryItems: VisualizationSurfaceItem[];
+    comparisonItems: VisualizationSurfaceItem[];
+};
+export {};

package/dist/visualizations/selectors.js

@@ -0,0 +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
+  };
+}
+export {
+  createIntegrationVisualizationSections
+};

package/dist/visualizations/selectors.test.d.ts

@@ -0,0 +1 @@
+export {};