feat(scaffolder): support updating template inputs of tasks

Signed-off-by: Phil Kuang <pkuang@factset.com>

plugins/scaffolder-common/src/TaskSpec.ts

@@ -0,0 +1,74 @@
+/*
+ * Copyright 2021 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, JsonObject } from '@backstage/types';
+
+/**
+ * TemplateMetadata
+ *
+ * @public
+ */
+export type TemplateMetadata = {
+  name: string;
+};
+
+/**
+ * TaskStep
+ *
+ * @public
+ */
+export interface TaskStep {
+  id: string;
+  name: string;
+  action: string;
+  input?: JsonObject;
+  if?: string | boolean;
+}
+
+/**
+ * TaskSpecV1beta2
+ *
+ * @public
+ */
+export interface TaskSpecV1beta2 {
+  apiVersion: 'backstage.io/v1beta2';
+  baseUrl?: string;
+  values: JsonObject;
+  steps: TaskStep[];
+  output: { [name: string]: string };
+  metadata?: TemplateMetadata;
+}
+
+/**
+ * TaskSpecV1beta3
+ *
+ * @public
+ */
+export interface TaskSpecV1beta3 {
+  apiVersion: 'scaffolder.backstage.io/v1beta3';
+  baseUrl?: string;
+  parameters: JsonObject;
+  steps: TaskStep[];
+  output: { [name: string]: JsonValue };
+  metadata?: TemplateMetadata;
+}
+
+/**
+ * TaskSpec
+ *
+ * @public
+ */
+export type TaskSpec = TaskSpecV1beta2 | TaskSpecV1beta3;

plugins/scaffolder-common/src/index.ts

@@ -30,3 +30,5 @@ export const templateEntityV1beta3Schema: JSONSchema = v1beta3Schema as Omit<
   JSONSchema,
   'examples'
 >;
+
+export * from './TaskSpec';