@red-hat-developer-hub/backstage-plugin-scorecard-backend 2.3.5 → 2.5.0

package/CHANGELOG.md

@@ -1,5 +1,56 @@
 # @red-hat-developer-hub/backstage-plugin-scorecard-backend
 
+## 2.5.0
+
+### Minor Changes
+
+- d706601: Backstage version bump to v1.49.3
+- 55226c2: Introduces custom threshold rule icons that can be configured in `app-config.yaml`.
+- bd5f3e8: added disable metric feature to the pull metric task
+- 243ad0a: Aggregated scorecards now use **aggregation IDs** and dedicated HTTP routes. The old catalog-aggregations URL still works but is **deprecated** (not removed).
+
+  **Backend (`@red-hat-developer-hub/backstage-plugin-scorecard-backend`)**
+
+  - **Deprecated:** `GET /metrics/:metricId/catalog/aggregations` — responses are unchanged, but the handler emits [RFC 8594](https://datatracker.ietf.org/doc/html/rfc8594) `Deprecation` and `Link` headers (alternate successor: `GET .../aggregations/:aggregationId`) and logs a warning. Prefer **`GET /aggregations/:aggregationId`** for new integrations.
+  - **Added:** `GET /aggregations/:aggregationId` for aggregated results using configured aggregation.
+  - **Added:** `GET /aggregations/:aggregationId/metadata` for KPI titles, descriptions, and aggregation metadata consumed by the UI.
+
+  **Common (`@red-hat-developer-hub/backstage-plugin-scorecard-common`)**
+
+  - Types and constants aligned with the aggregation config and new API shapes.
+
+  **Frontend (`@red-hat-developer-hub/backstage-plugin-scorecard`)**
+
+  - Homepage and aggregated flows resolve cards via **`aggregationId`**, fetch metadata from the new endpoint, and keep localized threshold and error strings where translation keys exist.
+
+  **Action for adopters:** Configure aggregated scorecards with `aggregationId` values that match backend aggregation config, replace direct calls to `GET /metrics/:metricId/catalog/aggregations` with `GET /aggregations/:aggregationId` (and metadata if you need the same labels as the plugin UI).
+
+- c83b206: Adds the ability to drill down from aggregated scorecard KPIs to view the individual entities that contribute to the overall score. This enables managers and platform engineers to identify specific services impacting metrics and troubleshoot issues at the entity level.
+
+### Patch Changes
+
+- 4f483a6: Normalize entity owners to their full canonical reference when syncing. Catalog entities are able to define a short name or the full entity reference for group ownership. This can lead to inconsistent filtering as we utilize the full entity reference for users and groups
+- 89b273f: Adds the ability to sort by status that was originally missed during the initial implementation of the drill down feature
+- Updated dependencies [d706601]
+- Updated dependencies [55226c2]
+- Updated dependencies [243ad0a]
+- Updated dependencies [c83b206]
+  - @red-hat-developer-hub/backstage-plugin-scorecard-common@2.5.0
+  - @red-hat-developer-hub/backstage-plugin-scorecard-node@2.5.0
+
+## 2.4.0
+
+### Minor Changes
+
+- 7062658: Introduces custom threshold rule keys and colors that can be configured in `app-config.yaml`.
+
+### Patch Changes
+
+- Updated dependencies [7062658]
+- Updated dependencies [dc5e31a]
+  - @red-hat-developer-hub/backstage-plugin-scorecard-common@2.4.0
+  - @red-hat-developer-hub/backstage-plugin-scorecard-node@2.4.0
+
 ## 2.3.5
 
 ### Patch Changes

package/README.md

@@ -88,21 +88,27 @@ For more information about schedule configuration options, see the [Metric Colle
 
 The following metric providers are available:
 
-| Provider    | Metric ID          | Title                       | Description                                                                                                                      | Type   |
-| ----------- | ------------------ | --------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | ------ |
-| **GitHub**  | `github.open_prs`  | GitHub open PRs             | Count of open Pull Requests in GitHub                                                                                            | number |
-| **Jira**    | `jira.open_issues` | Jira open issues            | The number of opened issues in Jira                                                                                              | number |
-| **OpenSSF** | `openssf.*`        | OpenSSF Security Scorecards | 18 security metrics from OpenSSF Scorecards (e.g., `openssf.code_review`, `openssf.maintained`). Each returns a score from 0-10. | number |
+| Provider       | Metric ID          | Title                       | Description                                                                                                                      | Type   |
+| -------------- | ------------------ | --------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | ------ |
+| **GitHub**     | `github.open_prs`  | GitHub open PRs             | Count of open Pull Requests in GitHub                                                                                            | number |
+| **Jira**       | `jira.open_issues` | Jira open issues            | The number of opened issues in Jira                                                                                              | number |
+| **OpenSSF**    | `openssf.*`        | OpenSSF Security Scorecards | 18 security metrics from OpenSSF Scorecards (e.g., `openssf.code_review`, `openssf.maintained`). Each returns a score from 0-10. | number |
+| **Dependabot** | `dependabot.*`     | Dependabot Alerts           | Critical, High, Medium and Low CVE Alerts                                                                                        | number |
 
 To use these providers, install the corresponding backend modules:
 
 - GitHub: [`@red-hat-developer-hub/backstage-plugin-scorecard-backend-module-github`](../scorecard-backend-module-github/README.md)
 - Jira: [`@red-hat-developer-hub/backstage-plugin-scorecard-backend-module-jira`](../scorecard-backend-module-jira/README.md)
 - OpenSSF: [`@red-hat-developer-hub/backstage-plugin-scorecard-backend-module-openssf`](../scorecard-backend-module-openssf/README.md)
+- Dependabot: [`@red-hat-developer-hub/backstage-plugin-scorecard-backend-module-dependabot`](../scorecard-backend-module-dependabot/README.md)
+
+### Disabling Metrics
+
+Administrators can disable metric checks globally via app-config, and users can disable them for concrete entity via `scorecard.io/disabled-metrics` annotation. For more details, see [disabled-metrics-logic.md](./docs/disabled-metrics-logic.md).
 
 ## Thresholds
 
-Thresholds define conditions that determine which category a metric value belongs to (`error`, `warning`, or `success`). The Scorecard plugin provides multiple ways to configure thresholds:
+Thresholds define conditions to assign metric values to specific visual categories (`success`, `warning`, `error` or any custom category). The Scorecard plugin provides multiple ways to configure thresholds:
 
 - **Provider Defaults**: Metric providers define default thresholds
 - **App Configuration**: Override defaults through `app-config.yaml`
@@ -112,6 +118,38 @@ Thresholds are evaluated in order, and the first matching rule determines the ca
 
 For comprehensive threshold configuration guide, examples, and best practices, see [thresholds.md](./docs/thresholds.md).
 
+## Aggregation KPIs (homepage and `GET /aggregations`)
+
+Aggregated scorecard data for the authenticated user’s owned entities is exposed under **`GET /aggregations/:aggregationId`**. Optional entries in **`scorecard.aggregationKPIs`** assign a stable **aggregation id** (KPI key), custom **title** and **description**, **type**, and the backing **metricId**.
+
+```yaml
+scorecard:
+  aggregationKPIs:
+    openIssuesKpi:
+      title: 'Jira open issues KPI'
+      description: 'Open issues across entities you own, grouped by status.'
+      type: statusGrouped
+      metricId: jira.open_issues
+    openPrsKpi:
+      title: 'GitHub open PRs KPI'
+      description: 'Open pull requests grouped by status.'
+      type: statusGrouped
+      metricId: github.open_prs
+```
+
+| Field         | Description                                                    |
+| ------------- | -------------------------------------------------------------- |
+| `title`       | Display title for this aggregation (returned in API metadata). |
+| `description` | Display description for this aggregation.                      |
+| `type`        | Aggregation algorithm; currently `statusGrouped`.              |
+| `metricId`    | Metric provider id used to load thresholds and compute counts. |
+
+- **Path**: `scorecard.aggregationKPIs.<aggregationId>`.
+- If **`aggregationKPIs` is omitted** or a given id is not listed, **`GET /aggregations/:aggregationId`** still works when **`aggregationId` equals the metric id** (e.g. `github.open_prs`): the backend uses that metric with the default `statusGrouped` aggregation and metric-defined title/description.
+- Invalid KPI entries may be logged and skipped at runtime; prefer fixing config per backend validation.
+
+**Homepage cards** are configured in the app (for example Dynamic Home Page mount points). They should pass **`aggregationId`** matching a key in `aggregationKPIs` or the metric id for the default case. See the [Scorecard frontend plugin README](../scorecard/README.md#homepage-scorecard-cards).
+
 ## API Endpoints
 
 ### `GET /metrics`
@@ -177,9 +215,52 @@ curl -X GET "{{url}}/api/scorecard/metrics/catalog/component/default/my-service?
   -H "Authorization: Bearer <token>"
 ```
 
-### `GET /metrics/:metricId/catalog/aggregations`
+### `GET /aggregations/:aggregationId`
+
+Returns aggregated metrics for the authenticated user across all catalog entities they own (same ownership rules as the legacy route; see [aggregation.md](./docs/aggregation.md)).
+
+The **`aggregationId`** is either:
+
+- A key under **`scorecard.aggregationKPIs`** in app-config (KPI-specific title, description, type, and `metricId`), or
+- The **metric id** itself when no KPI entry exists (default **statusGrouped** behavior).
+
+#### Path Parameters
+
+| Parameter       | Type   | Required | Description                                                                           |
+| --------------- | ------ | -------- | ------------------------------------------------------------------------------------- |
+| `aggregationId` | string | Yes      | KPI id from `scorecard.aggregationKPIs` or the metric id for the default aggregation. |
+
+#### Authentication / permissions
+
+Same as the deprecated aggregation route: user authentication, `scorecard.metric.read`, and `catalog.entity.read` for each aggregated entity.
+
+#### Example Request
+
+```bash
+curl -X GET "{{url}}/api/scorecard/aggregations/openIssuesKpi" \
+  -H "Authorization: Bearer <token>"
+
+# Default aggregation when no KPI is configured (id equals metric id)
+curl -X GET "{{url}}/api/scorecard/aggregations/github.open_prs" \
+  -H "Authorization: Bearer <token>"
+```
+
+### `GET /aggregations/:aggregationId/metadata`
+
+Returns **title**, **description**, **type**, **history**, and **aggregationType** for the aggregation without computing full aggregate counts. Uses the same resolution rules as `GET /aggregations/:aggregationId` (KPI config vs metric id fallback).
+
+```bash
+curl -X GET "{{url}}/api/scorecard/aggregations/openIssuesKpi/metadata" \
+  -H "Authorization: Bearer <token>"
+```
+
+### `GET /metrics/:metricId/catalog/aggregations` (deprecated; removal planned)
+
+This endpoint **remains available** for backward compatibility and behaves like the default case of **`GET /aggregations/:metricId`** (status-grouped aggregation for that metric). **It will be removed in a future major release** of the plugin - migrate to **`GET /aggregations/:aggregationId`**.
+
+Responses include **RFC 8594** deprecation signals: header **`Deprecation: true`** and **`Link: <…/aggregations/<metricId>>; rel="alternate"`** pointing at the successor URL. The backend also logs a warning when this route is used.
 
-Returns aggregated metrics for a specific metric across all entities owned by the authenticated user. This endpoint aggregates metrics from:
+Returns aggregated metrics for a specific metric across all entities owned by the authenticated user:
 
 - Entities directly owned by the user
 - Entities owned by groups the user is a direct member of (only direct parent groups are considered)
@@ -204,7 +285,7 @@ Requires `scorecard.metric.read` permission. Additionally:
 #### Example Request
 
 ```bash
-# Get aggregated metrics for a specific metric
+# Deprecated — prefer GET /aggregations/github.open_prs (or your KPI id)
 curl -X GET "{{url}}/api/scorecard/metrics/github.open_prs/catalog/aggregations" \
   -H "Authorization: Bearer <token>"
 ```

package/config.d.ts

@@ -15,12 +15,39 @@
  */
 
 import { SchedulerServiceTaskScheduleDefinitionConfig } from '@backstage/backend-plugin-api';
+import { AggregationType } from '@red-hat-developer-hub/backstage-plugin-scorecard-common';
 
 export interface Config {
   /** Configuration for scorecard plugin */
   scorecard?: {
+    /** Configuration for scorecard aggregation KPIs */
+    aggregationKPIs?: {
+      /** Unique identifier for scorecard aggregation KPIs */
+      [aggregationId: string]: {
+        /** Title of the aggregation */
+        title: string;
+        /** Description of the aggregation */
+        description: string;
+        /** Type of the aggregation */
+        type: AggregationType;
+        /** Metric ID for which the aggregation is calculated */
+        metricId: string;
+      };
+    };
     /** Number of days to retain metric data in the database. Older data will be automatically cleaned up. Default: 365 days */
     dataRetentionDays?: number;
+    /** List of metric IDs (e.g. openssf.packaging) that are disabled globally. Entity annotations cannot override this. */
+    disabledMetrics?: string[];
+    /** Control whether users can override behavior via entity annotations. */
+    entityAnnotations?: {
+      /** Whether entity scorecard.io/disabled-metrics annotation can override. Only affects annotations; global disabledMetrics is unchanged. */
+      disabledMetrics?: {
+        /** If true (default), entities can disable metrics that are not mentioned in `except` list via `scorecard.io/disabled-metrics` annotation; if false, the annotation has no effect */
+        enabled?: boolean;
+        /** When enabled is true: entity annotations cannot disable metric IDs listed here (these checks always run). */
+        except?: string[];
+      };
+    };
     /** Configuration for scorecard metric providers */
     plugins?: {
       /** Configuration for datasource */
@@ -31,12 +58,58 @@ export interface Config {
         [metricName: string]: {
           /** Threshold configuration for the metric */
           thresholds?: {
+            /**
+             * Rules describe how metric values are categorized and how that category is presented in the UI.
+             * They are evaluated in order and the first matching rule is applied.
+             */
             rules?: Array<{
-              key: 'error' | 'warning' | 'success';
-              /** Threshold expression - supports: >=, <=, >, <, ==, !=, - (range) */
+              /**
+               * Threshold category key that a metric value is assigned to when this rule
+               * matches (for example `success`, `warning`, `error`, or a custom key).
+               */
+              key: string;
+              /**
+               * Threshold expression that determines whether a metric value matches this
+               * rule. Supports:`>=`, `<=`, `>`, `<`, `==`, `!=`, `-` (range).
+               *
+               * @example `<= 10` - Metric value must be less than or equal to 10.
+               * @example `10-60` - Metric value must be between 10 and 60 (inclusive).
+               */
               expression: string;
+              /**
+               * Color configuration - supports multiple formats:
+               * - theme palette reference (`success.main` / `warning.main` / `error.main`)
+               * - HEX code (e.g. '#FFA500')
+               * - RGB/RGBA (e.g. 'rgb(255, 0, 0)')
+               *
+               * Threshold rules 'success', 'warning' and 'error' have default colors.
+               */
+              color?: string;
+              /**
+               * Icon configuration - supports multiple formats:
+               * - Backstage system icons: 'kind:component', 'kind:api', etc.
+               * - Material Design icons: 'settings', 'home', 'build', etc.
+               * - SVG strings: '<svg xmlns="http://www.w3.org/2000/svg">...</svg>'
+               * - URLs: 'https://example.com/icon.png', '/assets/icon.svg'
+               * - Data URIs: 'data:image/svg+xml;base64,...'
+               *
+               * Threshold rules 'success', 'warning' and 'error' have default icons.
+               */
+              icon?: string;
             }>;
           };
+          /**
+           * Schedule for collecting this metric. If not set, the default hourly schedule is used.
+           *
+           * Default schedule:
+           * ```ts
+           * {
+           *   frequency: { hours: 1 },
+           *   timeout: { minutes: 15 },
+           *   initialDelay: { minutes: 1 },
+           * }
+           * ```
+           */
           schedule?: SchedulerServiceTaskScheduleDefinitionConfig;
         };
       };

package/dist/constants/aggregationKPIs.cjs.js

@@ -0,0 +1,6 @@
+'use strict';
+
+const AGGREGATION_KPIS_CONFIG_PATH = "scorecard.aggregationKPIs";
+
+exports.AGGREGATION_KPIS_CONFIG_PATH = AGGREGATION_KPIS_CONFIG_PATH;
+//# sourceMappingURL=aggregationKPIs.cjs.js.map

package/dist/constants/aggregationKPIs.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregationKPIs.cjs.js","sources":["../../src/constants/aggregationKPIs.ts"],"sourcesContent":["/*\n * Copyright Red Hat, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nexport const AGGREGATION_KPIS_CONFIG_PATH =\n  'scorecard.aggregationKPIs' as const;\n"],"names":[],"mappings":";;AAgBO,MAAM,4BACX,GAAA;;;;"}

package/dist/database/DatabaseMetricValues.cjs.js

@@ -4,6 +4,7 @@ class DatabaseMetricValues {
   constructor(dbClient) {
     this.dbClient = dbClient;
   }
+  dbClient;
   tableName = "metric_values";
   /**
    * Insert multiple metric values
@@ -33,39 +34,102 @@ class DatabaseMetricValues {
    * Get aggregated metrics by status for multiple entities and metrics.
    */
   async readAggregatedMetricByEntityRefs(catalog_entity_refs, metric_id) {
-    const latestIdsSubquery = this.dbClient(this.tableName).max("id").where("metric_id", metric_id).whereIn("catalog_entity_ref", catalog_entity_refs).groupBy("metric_id", "catalog_entity_ref");
-    const [row] = await this.dbClient(this.tableName).select("metric_id").count("* as total").max("timestamp as max_timestamp").select(
-      this.dbClient.raw(
-        "SUM(CASE WHEN status = 'success' AND value IS NOT NULL THEN 1 ELSE 0 END) as success"
-      )
-    ).select(
-      this.dbClient.raw(
-        "SUM(CASE WHEN status = 'warning' AND value IS NOT NULL THEN 1 ELSE 0 END) as warning"
-      )
-    ).select(
-      this.dbClient.raw(
-        "SUM(CASE WHEN status = 'error' AND value IS NOT NULL THEN 1 ELSE 0 END) as error"
-      )
-    ).whereIn("id", latestIdsSubquery).whereNotNull("status").whereNotNull("value").groupBy("metric_id");
-    if (row) {
-      let maxTimestamp;
-      if (row.max_timestamp instanceof Date) {
-        maxTimestamp = row.max_timestamp;
-      } else if (typeof row.max_timestamp === "number" || typeof row.max_timestamp === "string") {
-        maxTimestamp = new Date(row.max_timestamp);
+    const latestIdsSubquery = this.dbClient(this.tableName).max("id").where("metric_id", metric_id).whereIn("catalog_entity_ref", catalog_entity_refs).groupBy("catalog_entity_ref");
+    const statusRows = await this.dbClient(this.tableName).select("status").count("* as count").max("timestamp as max_timestamp").whereIn("id", latestIdsSubquery).whereNotNull("status").whereNotNull("value").groupBy("status");
+    if (!statusRows || statusRows.length === 0) {
+      return void 0;
+    }
+    const normalizeTimestamp = (timestamp) => {
+      if (timestamp instanceof Date) {
+        return timestamp;
+      } else if (typeof timestamp === "number" || typeof timestamp === "string") {
+        return new Date(timestamp);
+      }
+      return /* @__PURE__ */ new Date();
+    };
+    let maxTimestamp = /* @__PURE__ */ new Date(0);
+    let total = 0;
+    const statusCounts = {};
+    for (const row of statusRows) {
+      const rowTimestamp = normalizeTimestamp(row.max_timestamp);
+      if (rowTimestamp > maxTimestamp) {
+        maxTimestamp = rowTimestamp;
+      }
+      const name = row.status;
+      const count = Number(row.count);
+      statusCounts[name] = count;
+      total += count;
+    }
+    return {
+      metric_id,
+      total,
+      max_timestamp: maxTimestamp,
+      statusCounts
+    };
+  }
+  /**
+   * Fetch the latest entity metric values for a given metric, with optional filtering
+   * by status, name, kind, namespace, or owner, plus sorting and pagination.
+   */
+  async readEntityMetricsWithFilters(metric_id, options) {
+    const clientName = this.dbClient.client?.config?.client ?? "";
+    const isPostgres = clientName === "pg" || clientName.includes("postgres");
+    const latestIdsSubquery = this.dbClient(this.tableName).max("id").where("metric_id", metric_id).groupBy("catalog_entity_ref");
+    const query = this.dbClient(this.tableName).select("*").whereIn("id", latestIdsSubquery);
+    const sortColumnMap = {
+      entityName: "catalog_entity_ref",
+      owner: "entity_owner",
+      entityKind: "entity_kind",
+      timestamp: "timestamp",
+      metricValue: "value",
+      namespace: "entity_namespace",
+      status: "status"
+    };
+    const column = (options.sortBy && sortColumnMap[options.sortBy]) ?? "timestamp";
+    const direction = options.sortOrder === "asc" ? "asc" : "desc";
+    this.applySort(query, options.sortBy, column, direction, isPostgres);
+    if (options.status) {
+      query.where("status", options.status);
+    }
+    if (options.entityName) {
+      const escaped = options.entityName.replace(/[%_\\]/g, "\\$&");
+      query.whereRaw("catalog_entity_ref LIKE ? ESCAPE '\\'", [`%${escaped}%`]);
+    }
+    if (options.entityKind) {
+      query.where("entity_kind", options.entityKind);
+    }
+    if (options.entityNamespace) {
+      query.where("entity_namespace", options.entityNamespace);
+    }
+    if (options.entityOwner && options.entityOwner.length > 0) {
+      query.whereIn("entity_owner", options.entityOwner);
+    }
+    if (options.pagination) {
+      query.limit(options.pagination.limit).offset(options.pagination.offset);
+    }
+    return await query;
+  }
+  applySort(query, sortBy, column, direction, isPostgres) {
+    if (sortBy === "metricValue") {
+      if (isPostgres) {
+        query.orderByRaw(
+          `CAST(value::text AS DOUBLE PRECISION) ${direction} NULLS LAST, id ASC`
+        );
+      } else {
+        query.orderByRaw(
+          `value IS NULL, CAST(CAST(value AS TEXT) AS REAL) ${direction}, id ASC`
+        );
+      }
+    } else if (sortBy === "status") {
+      if (isPostgres) {
+        query.orderByRaw(`status ${direction} NULLS LAST, id ASC`);
       } else {
-        maxTimestamp = /* @__PURE__ */ new Date();
+        query.orderByRaw(`status IS NULL, status ${direction}, id ASC`);
       }
-      return {
-        metric_id: row.metric_id,
-        total: Number(row.total),
-        max_timestamp: maxTimestamp,
-        success: Number(row.success),
-        warning: Number(row.warning),
-        error: Number(row.error)
-      };
+    } else {
+      query.orderBy(column, direction);
+      query.orderBy("id", "asc");
     }
-    return void 0;
   }
 }
 

package/dist/database/DatabaseMetricValues.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"DatabaseMetricValues.cjs.js","sources":["../../src/database/DatabaseMetricValues.ts"],"sourcesContent":["/*\n * Copyright Red Hat, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Knex } from 'knex';\nimport {\n  DbMetricValueCreate,\n  DbMetricValue,\n  DbAggregatedMetric,\n} from './types';\n\nexport class DatabaseMetricValues {\n  private readonly tableName = 'metric_values';\n\n  constructor(private readonly dbClient: Knex<any, any[]>) {}\n\n  /**\n   * Insert multiple metric values\n   */\n  async createMetricValues(metricValues: DbMetricValueCreate[]): Promise<void> {\n    if (metricValues.length === 0) {\n      return;\n    }\n    await this.dbClient(this.tableName).insert(metricValues);\n  }\n\n  /**\n   * Get the latest metric values for a specific entity and metrics\n   */\n  async readLatestEntityMetricValues(\n    catalog_entity_ref: string,\n    metric_ids: string[],\n  ): Promise<DbMetricValue[]> {\n    return await this.dbClient(this.tableName)\n      .select('*')\n      .whereIn(\n        'id',\n        this.dbClient(this.tableName)\n          .max('id')\n          .whereIn('metric_id', metric_ids)\n          .where('catalog_entity_ref', catalog_entity_ref)\n          .groupBy('metric_id'),\n      );\n  }\n\n  /**\n   * Delete metric values that are older than the given date\n   */\n  async cleanupExpiredMetrics(olderThan: Date): Promise<number> {\n    return await this.dbClient(this.tableName)\n      .where('timestamp', '<', olderThan)\n      .del();\n  }\n\n  /**\n   * Get aggregated metrics by status for multiple entities and metrics.\n   */\n  async readAggregatedMetricByEntityRefs(\n    catalog_entity_refs: string[],\n    metric_id: string,\n  ): Promise<DbAggregatedMetric | undefined> {\n    const latestIdsSubquery = this.dbClient(this.tableName)\n      .max('id')\n      .where('metric_id', metric_id)\n      .whereIn('catalog_entity_ref', catalog_entity_refs)\n      .groupBy('metric_id', 'catalog_entity_ref');\n\n    const [row] = await this.dbClient(this.tableName)\n      .select('metric_id')\n      .count('* as total')\n      .max('timestamp as max_timestamp')\n      .select(\n        this.dbClient.raw(\n          \"SUM(CASE WHEN status = 'success' AND value IS NOT NULL THEN 1 ELSE 0 END) as success\",\n        ),\n      )\n      .select(\n        this.dbClient.raw(\n          \"SUM(CASE WHEN status = 'warning' AND value IS NOT NULL THEN 1 ELSE 0 END) as warning\",\n        ),\n      )\n      .select(\n        this.dbClient.raw(\n          \"SUM(CASE WHEN status = 'error' AND value IS NOT NULL THEN 1 ELSE 0 END) as error\",\n        ),\n      )\n      .whereIn('id', latestIdsSubquery)\n      .whereNotNull('status')\n      .whereNotNull('value')\n      .groupBy('metric_id');\n\n    // Normalize types for cross-database compatibility\n    // PostgreSQL returns COUNT/SUM as strings, SQLite returns numbers\n    // PostgreSQL returns MAX(timestamp) as Date, SQLite returns number (milliseconds)\n    if (row) {\n      let maxTimestamp: Date;\n      if (row.max_timestamp instanceof Date) {\n        maxTimestamp = row.max_timestamp;\n      } else if (\n        typeof row.max_timestamp === 'number' ||\n        typeof row.max_timestamp === 'string'\n      ) {\n        maxTimestamp = new Date(row.max_timestamp as string | number);\n      } else {\n        maxTimestamp = new Date();\n      }\n\n      return {\n        metric_id: row.metric_id,\n        total: Number(row.total),\n        max_timestamp: maxTimestamp,\n        success: Number(row.success),\n        warning: Number(row.warning),\n        error: Number(row.error),\n      };\n    }\n\n    return undefined;\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"DatabaseMetricValues.cjs.js","sources":["../../src/database/DatabaseMetricValues.ts"],"sourcesContent":["/*\n * Copyright Red Hat, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Knex } from 'knex';\nimport {\n  DbMetricValueCreate,\n  DbMetricValue,\n  DbAggregatedMetric,\n} from './types';\n\ntype ReadEntityMetricsWithFiltersOptions = {\n  status?: string;\n  entityName?: string;\n  entityKind?: string;\n  entityNamespace?: string;\n  entityOwner?: string[];\n  sortBy?:\n    | 'entityName'\n    | 'owner'\n    | 'entityKind'\n    | 'timestamp'\n    | 'metricValue'\n    | 'namespace'\n    | 'status';\n  sortOrder?: 'asc' | 'desc';\n  pagination?: { limit: number; offset: number };\n};\n\nexport class DatabaseMetricValues {\n  private readonly tableName = 'metric_values';\n\n  constructor(private readonly dbClient: Knex<any, any[]>) {}\n\n  /**\n   * Insert multiple metric values\n   */\n  async createMetricValues(metricValues: DbMetricValueCreate[]): Promise<void> {\n    if (metricValues.length === 0) {\n      return;\n    }\n    await this.dbClient(this.tableName).insert(metricValues);\n  }\n\n  /**\n   * Get the latest metric values for a specific entity and metrics\n   */\n  async readLatestEntityMetricValues(\n    catalog_entity_ref: string,\n    metric_ids: string[],\n  ): Promise<DbMetricValue[]> {\n    return await this.dbClient(this.tableName)\n      .select('*')\n      .whereIn(\n        'id',\n        this.dbClient(this.tableName)\n          .max('id')\n          .whereIn('metric_id', metric_ids)\n          .where('catalog_entity_ref', catalog_entity_ref)\n          .groupBy('metric_id'),\n      );\n  }\n\n  /**\n   * Delete metric values that are older than the given date\n   */\n  async cleanupExpiredMetrics(olderThan: Date): Promise<number> {\n    return await this.dbClient(this.tableName)\n      .where('timestamp', '<', olderThan)\n      .del();\n  }\n\n  /**\n   * Get aggregated metrics by status for multiple entities and metrics.\n   */\n  async readAggregatedMetricByEntityRefs(\n    catalog_entity_refs: string[],\n    metric_id: string,\n  ): Promise<DbAggregatedMetric | undefined> {\n    const latestIdsSubquery = this.dbClient(this.tableName)\n      .max('id')\n      .where('metric_id', metric_id)\n      .whereIn('catalog_entity_ref', catalog_entity_refs)\n      .groupBy('catalog_entity_ref');\n\n    const statusRows = await this.dbClient(this.tableName)\n      .select('status')\n      .count('* as count')\n      .max('timestamp as max_timestamp')\n      .whereIn('id', latestIdsSubquery)\n      .whereNotNull('status')\n      .whereNotNull('value')\n      .groupBy('status');\n\n    if (!statusRows || statusRows.length === 0) {\n      return undefined;\n    }\n\n    // Normalize types for cross-database compatibility\n    // PostgreSQL returns COUNT/SUM as strings, SQLite returns numbers\n    // PostgreSQL returns MAX(timestamp) as Date, SQLite returns number (milliseconds)\n    const normalizeTimestamp = (timestamp: any): Date => {\n      if (timestamp instanceof Date) {\n        return timestamp;\n      } else if (\n        typeof timestamp === 'number' ||\n        typeof timestamp === 'string'\n      ) {\n        return new Date(timestamp);\n      }\n      return new Date();\n    };\n\n    let maxTimestamp = new Date(0);\n    let total = 0;\n    const statusCounts: Record<string, number> = {};\n    for (const row of statusRows) {\n      const rowTimestamp = normalizeTimestamp(row.max_timestamp);\n      if (rowTimestamp > maxTimestamp) {\n        maxTimestamp = rowTimestamp;\n      }\n      const name = row.status as string;\n      const count = Number(row.count);\n      statusCounts[name] = count;\n      total += count;\n    }\n\n    return {\n      metric_id,\n      total,\n      max_timestamp: maxTimestamp,\n      statusCounts,\n    };\n  }\n\n  /**\n   * Fetch the latest entity metric values for a given metric, with optional filtering\n   * by status, name, kind, namespace, or owner, plus sorting and pagination.\n   */\n  async readEntityMetricsWithFilters(\n    metric_id: string,\n    options: ReadEntityMetricsWithFiltersOptions,\n  ): Promise<DbMetricValue[]> {\n    const clientName: string =\n      (this.dbClient as any).client?.config?.client ?? '';\n    const isPostgres = clientName === 'pg' || clientName.includes('postgres');\n\n    const latestIdsSubquery = this.dbClient(this.tableName)\n      .max('id')\n      .where('metric_id', metric_id)\n      .groupBy('catalog_entity_ref');\n\n    const query = this.dbClient(this.tableName)\n      .select('*')\n      .whereIn('id', latestIdsSubquery);\n\n    const sortColumnMap: Record<string, string> = {\n      entityName: 'catalog_entity_ref',\n      owner: 'entity_owner',\n      entityKind: 'entity_kind',\n      timestamp: 'timestamp',\n      metricValue: 'value',\n      namespace: 'entity_namespace',\n      status: 'status',\n    };\n\n    const column =\n      (options.sortBy && sortColumnMap[options.sortBy]) ?? 'timestamp';\n    const direction = options.sortOrder === 'asc' ? 'asc' : 'desc';\n\n    this.applySort(query, options.sortBy, column, direction, isPostgres);\n\n    if (options.status) {\n      query.where('status', options.status);\n    }\n\n    if (options.entityName) {\n      const escaped = options.entityName.replace(/[%_\\\\]/g, '\\\\$&');\n      query.whereRaw(\"catalog_entity_ref LIKE ? ESCAPE '\\\\'\", [`%${escaped}%`]);\n    }\n\n    if (options.entityKind) {\n      query.where('entity_kind', options.entityKind);\n    }\n\n    if (options.entityNamespace) {\n      query.where('entity_namespace', options.entityNamespace);\n    }\n\n    if (options.entityOwner && options.entityOwner.length > 0) {\n      query.whereIn('entity_owner', options.entityOwner);\n    }\n\n    if (options.pagination) {\n      query.limit(options.pagination.limit).offset(options.pagination.offset);\n    }\n\n    return await query;\n  }\n\n  private applySort(\n    query: any,\n    sortBy: string | undefined,\n    column: string,\n    direction: string,\n    isPostgres: boolean,\n  ): void {\n    if (sortBy === 'metricValue') {\n      // value is JSON and nullable; cast for numeric sort with NULLs last\n      if (isPostgres) {\n        query.orderByRaw(\n          `CAST(value::text AS DOUBLE PRECISION) ${direction} NULLS LAST, id ASC`,\n        );\n      } else {\n        // SQLite: \"value IS NULL\" puts nulls last; double-cast handles JSON-stored values\n        query.orderByRaw(\n          `value IS NULL, CAST(CAST(value AS TEXT) AS REAL) ${direction}, id ASC`,\n        );\n      }\n    } else if (sortBy === 'status') {\n      // status is nullable; NULLs always sort last regardless of direction\n      if (isPostgres) {\n        query.orderByRaw(`status ${direction} NULLS LAST, id ASC`);\n      } else {\n        // SQLite: \"status IS NULL\" evaluates to 1 for NULLs, pushing them to the end\n        query.orderByRaw(`status IS NULL, status ${direction}, id ASC`);\n      }\n    } else {\n      query.orderBy(column, direction);\n      // Ensure a stable sort when two metrics share the same primary sort value\n      query.orderBy('id', 'asc');\n    }\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/middlewares/validateAggregationIdParam.cjs.js

@@ -0,0 +1,20 @@
+'use strict';
+
+var zod = require('zod');
+var errors = require('@backstage/errors');
+
+function validateAggregationIdParam(req, _res, next) {
+  const schema = zod.z.object({
+    aggregationId: zod.z.string().min(1).max(255)
+  });
+  const parsed = schema.safeParse(req.params);
+  if (!parsed.success) {
+    throw new errors.InputError(
+      `Invalid aggregationId parameter: ${parsed.error.message}`
+    );
+  }
+  next();
+}
+
+exports.validateAggregationIdParam = validateAggregationIdParam;
+//# sourceMappingURL=validateAggregationIdParam.cjs.js.map

package/dist/middlewares/validateAggregationIdParam.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateAggregationIdParam.cjs.js","sources":["../../src/middlewares/validateAggregationIdParam.ts"],"sourcesContent":["/*\n * Copyright Red Hat, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { z } from 'zod';\nimport { InputError } from '@backstage/errors';\nimport type { Request, Response, NextFunction } from 'express';\n\nexport function validateAggregationIdParam(\n  req: Request,\n  _res: Response,\n  next: NextFunction,\n): void {\n  const schema = z.object({\n    aggregationId: z.string().min(1).max(255),\n  });\n\n  const parsed = schema.safeParse(req.params);\n\n  if (!parsed.success) {\n    throw new InputError(\n      `Invalid aggregationId parameter: ${parsed.error.message}`,\n    );\n  }\n\n  next();\n}\n"],"names":["z","InputError"],"mappings":";;;;;AAoBgB,SAAA,0BAAA,CACd,GACA,EAAA,IAAA,EACA,IACM,EAAA;AACN,EAAM,MAAA,MAAA,GAASA,MAAE,MAAO,CAAA;AAAA,IACtB,aAAA,EAAeA,MAAE,MAAO,EAAA,CAAE,IAAI,CAAC,CAAA,CAAE,IAAI,GAAG;AAAA,GACzC,CAAA;AAED,EAAA,MAAM,MAAS,GAAA,MAAA,CAAO,SAAU,CAAA,GAAA,CAAI,MAAM,CAAA;AAE1C,EAAI,IAAA,CAAC,OAAO,OAAS,EAAA;AACnB,IAAA,MAAM,IAAIC,iBAAA;AAAA,MACR,CAAA,iCAAA,EAAoC,MAAO,CAAA,KAAA,CAAM,OAAO,CAAA;AAAA,KAC1D;AAAA;AAGF,EAAK,IAAA,EAAA;AACP;;;;"}

package/dist/middlewares/validateDatasourceQueryParams.cjs.js

@@ -0,0 +1,18 @@
+'use strict';
+
+var zod = require('zod');
+var errors = require('@backstage/errors');
+
+function validateDatasourceQueryParams(req, _res, next) {
+  const schema = zod.z.object({
+    datasource: zod.z.string().min(1).max(255).optional()
+  });
+  const parsed = schema.safeParse(req.query);
+  if (!parsed.success) {
+    throw new errors.InputError(`Invalid query parameters: ${parsed.error.message}`);
+  }
+  next();
+}
+
+exports.validateDatasourceQueryParams = validateDatasourceQueryParams;
+//# sourceMappingURL=validateDatasourceQueryParams.cjs.js.map

package/dist/middlewares/validateDatasourceQueryParams.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateDatasourceQueryParams.cjs.js","sources":["../../src/middlewares/validateDatasourceQueryParams.ts"],"sourcesContent":["/*\n * Copyright Red Hat, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { z } from 'zod';\nimport { InputError } from '@backstage/errors';\nimport type { Request, Response, NextFunction } from 'express';\n\nexport function validateDatasourceQueryParams(\n  req: Request,\n  _res: Response,\n  next: NextFunction,\n): void {\n  const schema = z.object({\n    datasource: z.string().min(1).max(255).optional(),\n  });\n\n  const parsed = schema.safeParse(req.query);\n\n  if (!parsed.success) {\n    throw new InputError(`Invalid query parameters: ${parsed.error.message}`);\n  }\n\n  next();\n}\n"],"names":["z","InputError"],"mappings":";;;;;AAoBgB,SAAA,6BAAA,CACd,GACA,EAAA,IAAA,EACA,IACM,EAAA;AACN,EAAM,MAAA,MAAA,GAASA,MAAE,MAAO,CAAA;AAAA,IACtB,UAAA,EAAYA,KAAE,CAAA,MAAA,EAAS,CAAA,GAAA,CAAI,CAAC,CAAE,CAAA,GAAA,CAAI,GAAG,CAAA,CAAE,QAAS;AAAA,GACjD,CAAA;AAED,EAAA,MAAM,MAAS,GAAA,MAAA,CAAO,SAAU,CAAA,GAAA,CAAI,KAAK,CAAA;AAEzC,EAAI,IAAA,CAAC,OAAO,OAAS,EAAA;AACnB,IAAA,MAAM,IAAIC,iBAAW,CAAA,CAAA,0BAAA,EAA6B,MAAO,CAAA,KAAA,CAAM,OAAO,CAAE,CAAA,CAAA;AAAA;AAG1E,EAAK,IAAA,EAAA;AACP;;;;"}

package/dist/middlewares/validateMetricIdsQueryParams.cjs.js

@@ -0,0 +1,18 @@
+'use strict';
+
+var zod = require('zod');
+var errors = require('@backstage/errors');
+
+function validateMetricIdsQueryParams(req, _res, next) {
+  const schema = zod.z.object({
+    metricIds: zod.z.string().min(1).max(255).optional()
+  });
+  const parsed = schema.safeParse(req.query);
+  if (!parsed.success) {
+    throw new errors.InputError(`Invalid query parameters: ${parsed.error.message}`);
+  }
+  next();
+}
+
+exports.validateMetricIdsQueryParams = validateMetricIdsQueryParams;
+//# sourceMappingURL=validateMetricIdsQueryParams.cjs.js.map

package/dist/middlewares/validateMetricIdsQueryParams.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateMetricIdsQueryParams.cjs.js","sources":["../../src/middlewares/validateMetricIdsQueryParams.ts"],"sourcesContent":["/*\n * Copyright Red Hat, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { z } from 'zod';\nimport { InputError } from '@backstage/errors';\nimport type { Request, Response, NextFunction } from 'express';\n\nexport function validateMetricIdsQueryParams(\n  req: Request,\n  _res: Response,\n  next: NextFunction,\n): void {\n  const schema = z.object({\n    metricIds: z.string().min(1).max(255).optional(),\n  });\n\n  const parsed = schema.safeParse(req.query);\n\n  if (!parsed.success) {\n    throw new InputError(`Invalid query parameters: ${parsed.error.message}`);\n  }\n\n  next();\n}\n"],"names":["z","InputError"],"mappings":";;;;;AAoBgB,SAAA,4BAAA,CACd,GACA,EAAA,IAAA,EACA,IACM,EAAA;AACN,EAAM,MAAA,MAAA,GAASA,MAAE,MAAO,CAAA;AAAA,IACtB,SAAA,EAAWA,KAAE,CAAA,MAAA,EAAS,CAAA,GAAA,CAAI,CAAC,CAAE,CAAA,GAAA,CAAI,GAAG,CAAA,CAAE,QAAS;AAAA,GAChD,CAAA;AAED,EAAA,MAAM,MAAS,GAAA,MAAA,CAAO,SAAU,CAAA,GAAA,CAAI,KAAK,CAAA;AAEzC,EAAI,IAAA,CAAC,OAAO,OAAS,EAAA;AACnB,IAAA,MAAM,IAAIC,iBAAW,CAAA,CAAA,0BAAA,EAA6B,MAAO,CAAA,KAAA,CAAM,OAAO,CAAE,CAAA,CAAA;AAAA;AAG1E,EAAK,IAAA,EAAA;AACP;;;;"}

package/dist/permissions/permissionUtils.cjs.js

@@ -5,6 +5,30 @@ var errors = require('@backstage/errors');
 var alpha = require('@backstage/plugin-catalog-common/alpha');
 var rules = require('./rules.cjs.js');
 
+const getUserEntityRef = async (credentials) => {
+  const userEntityRef = credentials?.principal?.userEntityRef;
+  if (!userEntityRef) {
+    throw new errors.AuthenticationError("User entity reference not found");
+  }
+  return userEntityRef;
+};
+const authorizeConditional = async (credentials, permissions, permission) => {
+  const scorecardPermission = {};
+  if (permission.type === "resource") {
+    scorecardPermission.decision = (await permissions.authorizeConditional([{ permission }], {
+      credentials
+    }))[0];
+  } else {
+    scorecardPermission.decision = (await permissions.authorize([{ permission }], {
+      credentials
+    }))[0];
+  }
+  if (scorecardPermission.decision.result === pluginPermissionCommon.AuthorizeResult.DENY) {
+    throw new errors.NotAllowedError();
+  }
+  scorecardPermission.conditions = scorecardPermission.decision.result === pluginPermissionCommon.AuthorizeResult.CONDITIONAL ? scorecardPermission.decision.conditions : void 0;
+  return scorecardPermission;
+};
 const checkEntityAccess = async (entityRef, req, permissions, httpAuth) => {
   const entityAccessDecision = await permissions.authorize(
     [{ permission: alpha.catalogEntityReadPermission, resourceRef: entityRef }],
@@ -36,7 +60,9 @@ const filterAuthorizedMetrics = (metrics, filter) => {
   return metrics.filter((metric) => matches(metric, filter));
 };
 
+exports.authorizeConditional = authorizeConditional;
 exports.checkEntityAccess = checkEntityAccess;
 exports.filterAuthorizedMetrics = filterAuthorizedMetrics;
+exports.getUserEntityRef = getUserEntityRef;
 exports.matches = matches;
 //# sourceMappingURL=permissionUtils.cjs.js.map