Added DevTools plugin

Signed-off-by: Andre Wanlin <67169551+awanlin@users.noreply.github.com>

plugins/devtools-common/.eslintrc.js

@@ -0,0 +1 @@
+module.exports = require('@backstage/cli/config/eslint-factory')(__dirname);

plugins/devtools-common/README.md

@@ -0,0 +1,3 @@
+# DevTools Common
+
+Common types and permissions for the DevTools plugin.

plugins/devtools-common/api-report.md

@@ -0,0 +1,74 @@
+## API Report File for "@backstage/plugin-devtools-common"
+
+> Do not edit this file. It is a report generated by [API Extractor](https://api-extractor.com/).
+
+```ts
+import { BasicPermission } from '@backstage/plugin-permission-common';
+import { JsonValue } from '@backstage/types';
+
+// @public (undocumented)
+export type ConfigError = {
+  name: string;
+  message: string;
+  messages?: string[];
+  stack?: string;
+};
+
+// @public (undocumented)
+export type ConfigInfo = {
+  config?: JsonValue;
+  error?: ConfigError;
+};
+
+// @public (undocumented)
+export const devToolsAdministerPermission: BasicPermission;
+
+// @public (undocumented)
+export const devToolsConfigReadPermission: BasicPermission;
+
+// @public (undocumented)
+export const devToolsExternalDependenciesReadPermission: BasicPermission;
+
+// @public (undocumented)
+export type DevToolsInfo = {
+  operatingSystem: string;
+  nodeJsVersion: string;
+  backstageVersion: string;
+  dependencies: PackageDependency[];
+};
+
+// @public (undocumented)
+export const devToolsInfoReadPermission: BasicPermission;
+
+// @public (undocumented)
+export type Endpoint = {
+  name: string;
+  type: string;
+  target: string;
+};
+
+// @public (undocumented)
+export type ExternalDependency = {
+  name: string;
+  type: string;
+  target: string;
+  status: string;
+  error?: string;
+};
+
+// @public (undocumented)
+export enum ExternalDependencyStatus {
+  // (undocumented)
+  healthy = 'Healthy',
+  // (undocumented)
+  unhealthy = 'Unhealthy',
+}
+
+// @public (undocumented)
+export type PackageDependency = {
+  name: string;
+  versions: string;
+};
+
+// (No @packageDocumentation comment for this package)
+```

plugins/devtools-common/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@backstage/plugin-devtools-common",
+  "description": "Common functionalities for the devtools plugin",
+  "version": "0.0.0",
+  "main": "src/index.ts",
+  "types": "src/index.ts",
+  "license": "Apache-2.0",
+  "publishConfig": {
+    "access": "public",
+    "main": "dist/index.cjs.js",
+    "module": "dist/index.esm.js",
+    "types": "dist/index.d.ts"
+  },
+  "backstage": {
+    "role": "common-library"
+  },
+  "scripts": {
+    "build": "backstage-cli package build",
+    "lint": "backstage-cli package lint",
+    "test": "backstage-cli package test",
+    "clean": "backstage-cli package clean",
+    "prepack": "backstage-cli package prepack",
+    "postpack": "backstage-cli package postpack"
+  },
+  "dependencies": {
+    "@backstage/plugin-permission-common": "workspace:^",
+    "@backstage/types": "workspace:^"
+  },
+  "devDependencies": {
+    "@backstage/cli": "workspace:^"
+  },
+  "files": [
+    "dist"
+  ]
+}

plugins/devtools-common/src/index.ts

@@ -0,0 +1,18 @@
+/*
+ * Copyright 2022 The Backstage Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+export * from './types';
+export * from './permissions';

plugins/devtools-common/src/permissions.ts

@@ -0,0 +1,49 @@
+/*
+ * Copyright 2022 The Backstage Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { createPermission } from '@backstage/plugin-permission-common';
+
+/**
+ * @public
+ */
+export const devToolsAdministerPermission = createPermission({
+  name: 'devtools.administer',
+  attributes: { action: 'read' },
+});
+
+/**
+ * @public
+ */
+export const devToolsInfoReadPermission = createPermission({
+  name: 'devtools.info',
+  attributes: { action: 'read' },
+});
+
+/**
+ * @public
+ */
+export const devToolsConfigReadPermission = createPermission({
+  name: 'devtools.config',
+  attributes: { action: 'read' },
+});
+
+/**
+ * @public
+ */
+export const devToolsExternalDependenciesReadPermission = createPermission({
+  name: 'devtools.external-dependencies',
+  attributes: { action: 'read' },
+});

plugins/devtools-common/src/setupTests.ts

@@ -0,0 +1,17 @@
+/*
+ * Copyright 2022 The Backstage Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+export {};

plugins/devtools-common/src/types.ts

@@ -0,0 +1,67 @@
+/*
+ * Copyright 2022 The Backstage Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { JsonValue } from '@backstage/types';
+
+/** @public */
+export type Endpoint = {
+  name: string;
+  type: string;
+  target: string;
+};
+
+/** @public */
+export type ExternalDependency = {
+  name: string;
+  type: string;
+  target: string;
+  status: string;
+  error?: string;
+};
+
+/** @public */
+export type DevToolsInfo = {
+  operatingSystem: string;
+  nodeJsVersion: string;
+  backstageVersion: string;
+  dependencies: PackageDependency[];
+};
+
+/** @public */
+export type PackageDependency = {
+  name: string;
+  versions: string;
+};
+
+/** @public */
+export enum ExternalDependencyStatus {
+  healthy = 'Healthy',
+  unhealthy = 'Unhealthy',
+}
+
+/** @public */
+export type ConfigInfo = {
+  config?: JsonValue;
+  error?: ConfigError;
+};
+
+/** @public */
+export type ConfigError = {
+  name: string;
+  message: string;
+  messages?: string[];
+  stack?: string;
+};