@contractspec/example.integration-hub 3.7.7 → 3.8.2

package/dist/node/visualizations/catalog.js

@@ -0,0 +1,137 @@
+// 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/node/visualizations/index.js

@@ -0,0 +1,211 @@
+// 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/node/visualizations/selectors.js

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