Add OpenAPI spec for governance insights

features/v2/governance_insights.feature

@@ -0,0 +1,24 @@
+@endpoint(governance-insights) @endpoint(governance-insights-v2)
+Feature: Governance Insights
+  Governance Insights surface key usage, configuration, and best-practice
+  signals for an organization within the Governance Console. Each insight
+  reports a current value (and, optionally, a previous value for comparison)
+  along with the query used to compute it, so that the Console can render
+  trends and highlight areas that need attention.
+
+  Background:
+    Given a valid "apiKeyAuth" key in the system
+    And a valid "appKeyAuth" key in the system
+    And an instance of "GovernanceInsights" API
+    And operation "ListGovernanceInsights" enabled
+    And new "ListGovernanceInsights" request
+
+  @generated @skip @team:DataDog/aaa-governance-console
+  Scenario: List governance insights returns "Bad Request" response
+    When the request is sent
+    Then the response status is 400 Bad Request
+
+  @generated @skip @team:DataDog/aaa-governance-console
+  Scenario: List governance insights returns "OK" response
+    When the request is sent
+    Then the response status is 200 OK

features/v2/undo.json

@@ -2762,6 +2762,12 @@
       "type": "safe"
     }
   },
+  "ListGovernanceInsights": {
+    "tag": "Governance Insights",
+    "undo": {
+      "type": "safe"
+    }
+  },
   "GetHamrOrgConnection": {
     "tag": "High Availability MultiRegion",
     "undo": {

packages/datadog-api-client/README.md

@@ -405,6 +405,7 @@ apiInstance
 | Forms | @datadog/datadog-api-client-forms | [README.md](../../services/forms/README.md) |
 | GCP Integration | @datadog/datadog-api-client-gcp-integration | [README.md](../../services/gcp-integration/README.md) |
 | Google Chat Integration | @datadog/datadog-api-client-google-chat-integration | [README.md](../../services/google-chat-integration/README.md) |
+| Governance Insights | @datadog/datadog-api-client-governance-insights | [README.md](../../services/governance-insights/README.md) |
 | High Availability MultiRegion | @datadog/datadog-api-client-high-availability-multi-region | [README.md](../../services/high-availability-multi-region/README.md) |
 | Hosts | @datadog/datadog-api-client-hosts | [README.md](../../services/hosts/README.md) |
 | Incidents | @datadog/datadog-api-client-incidents | [README.md](../../services/incidents/README.md) |

private/bdd_runner/src/support/scenarios_model_mapping.ts

@@ -9371,6 +9371,21 @@ export const ScenariosModelMappings: { [key: string]: OperationMapping } = {
     },
     operationResponseType: "SAMLConfigurationResponse",
   },
+  "GovernanceInsightsApi.V2.ListGovernanceInsights": {
+    withValues: {
+      type: "boolean",
+      format: "",
+    },
+    orgUuid: {
+      type: "string",
+      format: "",
+    },
+    filterProduct: {
+      type: "Array<string>",
+      format: "",
+    },
+    operationResponseType: "GovernanceInsightsResponse",
+  },
   "HighAvailabilityMultiRegionApi.V2.GetHamrOrgConnection": {
     operationResponseType: "HamrOrgConnectionResponse",
   },

services/governance_insights/.yarnrc.yml

@@ -0,0 +1 @@
+nodeLinker: node-modules

services/governance_insights/README.md

@@ -0,0 +1,47 @@
+# @datadog/datadog-api-client-governance-insights
+
+## Description
+
+Governance Insights surface key usage, configuration, and best-practice signals for an
+organization within the Governance Console. Each insight reports a current value (and,
+optionally, a previous value for comparison) along with the query used to compute it, so
+that the Console can render trends and highlight areas that need attention.
+
+## Navigation
+
+- [Installation](#installation)
+- [Getting Started](#getting-started)
+
+## Installation
+
+```sh
+# NPM
+npm install @datadog/datadog-api-client-governance-insights
+# Yarn
+yarn add @datadog/datadog-api-client-governance-insights
+```
+
+## Getting Started
+```ts
+import { createConfiguration } from "@datadog/datadog-api-client";
+import { GovernanceInsightsApiV2 } from "@datadog/datadog-api-client-governance-insights";
+import { v2 } from "@datadog/datadog-api-client-governance-insights";
+
+const configuration = createConfiguration();
+// Enable unstable operations
+const configurationOpts = {
+    unstableOperations: {
+        "GovernanceInsightsApi.v2.listGovernanceInsights": true
+    }
+}
+
+const configuration = createConfiguration(configurationOpts);
+const apiInstance = new GovernanceInsightsApiV2(configuration);
+const params = {/* parameters */};
+
+apiInstance.listGovernanceInsights(params).then((data) => {
+    console.log("API called successfully. Returned data: " + JSON.stringify(data));
+}).catch((error) => {
+    console.error("Error calling API: " + error);
+});
+```

services/governance_insights/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@datadog/datadog-api-client-governance-insights",
+  "description": "",
+  "author": "",
+  "keywords": [
+    "api",
+    "fetch",
+    "typescript"
+  ],
+  "license": "Apache-2.0",
+  "licenses": [
+    {
+      "type": "Apache-2.0",
+      "url": "http://www.apache.org/licenses/LICENSE-2.0"
+    }
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/DataDog/datadog-api-client-typescript.git",
+    "directory": "services/governance-insights"
+  },
+  "files": [
+    "dist/**/*"
+  ],
+  "main": "./dist/index.js",
+  "typings": "./dist/index.d.ts",
+  "scripts": {
+    "prepack": "yarn workspace @datadog/datadog-api-client build && yarn build",
+    "build": "yarn generate-version-files && tsc",
+    "generate-version-files": "node -p \"'export const version = ' + JSON.stringify(require('./package.json').version)\" > src/version.ts"
+  },
+  "dependencies": {
+    "@datadog/datadog-api-client": "^2.0.0-beta.2"
+  },
+  "devDependencies": {
+    "typescript": "5.8.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "version": "0.0.1",
+  "packageManager": "yarn@4.9.1"
+}

services/governance_insights/src/index.ts

@@ -0,0 +1,3 @@
+export * as v2 from "./v2";
+
+export { GovernanceInsightsApi as GovernanceInsightsApiV2 } from "./v2/GovernanceInsightsApi";