Refactor header names, add options object to requestHandler and add new changes to api-reports and changeset along with docs

Signed-off-by: Ruben Vallejo <rvallejo@vmware.com>

plugins/kubernetes-common/api-report.md

@@ -218,10 +218,10 @@ export type KubernetesErrorTypes =
 // @public (undocumented)
 export type KubernetesFetchError = StatusError | RawFetchError;
 
-// @alpha
+// @public
 export const kubernetesPermissions: BasicPermission[];
 
-// @alpha
+// @public
 export const kubernetesProxyPermission: BasicPermission;
 
 // @public (undocumented)
@@ -288,9 +288,6 @@ export interface ReplicaSetsFetchResponse {
   type: 'replicasets';
 }
 
-// @alpha
-export const RESOURCE_TYPE_KUBERNETES_RESOURCE = 'kubernetes-resource';
-
 // @public (undocumented)
 export interface ServiceFetchResponse {
   // (undocumented)

plugins/kubernetes-common/src/index.ts

@@ -23,7 +23,6 @@
 export * from './types';
 export * from './catalog-entity-constants';
 export {
-  RESOURCE_TYPE_KUBERNETES_RESOURCE,
   kubernetesProxyPermission,
   kubernetesPermissions,
 } from './permissions';

plugins/kubernetes-common/src/permissions.ts

@@ -16,14 +16,8 @@
 
 import { createPermission } from '@backstage/plugin-permission-common';
 
-/**
- * Permission resource type which corresponds to cluster entities.
- * @alpha
- */
-export const RESOURCE_TYPE_KUBERNETES_RESOURCE = 'kubernetes-resource';
-
 /** This permission is used to check access to the proxy endpoint
- * @alpha
+ * @public
  */
 export const kubernetesProxyPermission = createPermission({
   name: 'kubernetes.proxy',
@@ -32,6 +26,6 @@ export const kubernetesProxyPermission = createPermission({
 
 /**
  * List of all Kubernetes permissions.
- * @alpha
+ * @public
  */
 export const kubernetesPermissions = [kubernetesProxyPermission];