@backstage/plugin-scaffolder-common 1.6.0 → 1.7.0-next.0

package/dist/TemplateEntityV1beta3.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"TemplateEntityV1beta3.cjs.js","sources":["../src/TemplateEntityV1beta3.ts"],"sourcesContent":["/*\n * Copyright 2020 The Backstage Authors\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 {\n  Entity,\n  entityKindSchemaValidator,\n  KindValidator,\n} from '@backstage/catalog-model';\nimport { JsonObject } from '@backstage/types';\nimport schema from './Template.v1beta3.schema.json';\n\n/**\n * Backstage catalog Template kind Entity. Templates are used by the Scaffolder\n * plugin to create new entities, such as Components.\n *\n * @public\n */\nexport interface TemplateEntityV1beta3 extends Entity {\n  /**\n   * The apiVersion string of the TaskSpec.\n   */\n  apiVersion: 'scaffolder.backstage.io/v1beta3';\n  /**\n   * The kind of the entity\n   */\n  kind: 'Template';\n  /**\n   * The specification of the Template Entity\n   */\n  spec: {\n    /**\n     * The type that the Template will create. For example service, website or library.\n     */\n    type: string;\n\n    /**\n     * Template specific configuration of the presentation layer.\n     */\n    presentation?: TemplatePresentationV1beta3;\n\n    /**\n     * Recovery strategy for the template\n     */\n    EXPERIMENTAL_recovery?: TemplateRecoveryV1beta3;\n\n    /**\n     * Form hooks to be run\n     */\n    EXPERIMENTAL_formDecorators?: { id: string; input?: JsonObject }[];\n\n    /**\n     * This is a JSONSchema or an array of JSONSchema's which is used to render a form in the frontend\n     * to collect user input and validate it against that schema. This can then be used in the `steps` part below to template\n     * variables passed from the user into each action in the template.\n     */\n    parameters?: TemplateParametersV1beta3 | TemplateParametersV1beta3[];\n    /**\n     * A list of steps to be executed in sequence which are defined by the template. These steps are a list of the underlying\n     * javascript action and some optional input parameters that may or may not have been collected from the end user.\n     */\n    steps: Array<TemplateEntityStepV1beta3>;\n    /**\n     * The output is an object where template authors can pull out information from template actions and return them in a known standard way.\n     */\n    output?: { [name: string]: string };\n    /**\n     * The owner entityRef of the TemplateEntity\n     */\n    owner?: string;\n    /**\n     * Specifies the lifecycle phase of the TemplateEntity\n     */\n    lifecycle?: string;\n  };\n}\n\n/**\n * Depends on how you designed your task you might tailor the behaviour for each of them.\n *\n * @public\n */\nexport interface TemplateRecoveryV1beta3 extends JsonObject {\n  /**\n   *\n   * none - not recover, let the task be marked as failed\n   * startOver - do recover, start the execution of the task from the first step.\n   *\n   * @public\n   */\n  EXPERIMENTAL_strategy?: 'none' | 'startOver';\n}\n\n/**\n * The presentation of the template.\n *\n * @public\n */\nexport interface TemplatePresentationV1beta3 extends JsonObject {\n  /**\n   * Overrides default buttons' text\n   */\n  buttonLabels?: {\n    /**\n     * The text for the button which leads to the previous template page\n     */\n    backButtonText?: string;\n    /**\n     * The text for the button which starts the execution of the template\n     */\n    createButtonText?: string;\n    /**\n     * The text for the button which opens template's review/summary\n     */\n    reviewButtonText?: string;\n  };\n}\n\n/**\n * Step that is part of a Template Entity.\n *\n * @public\n */\nexport interface TemplateEntityStepV1beta3 extends JsonObject {\n  id?: string;\n  name?: string;\n  action: string;\n  input?: JsonObject;\n  if?: string | boolean;\n  'backstage:permissions'?: TemplatePermissionsV1beta3;\n}\n\n/**\n * Parameter that is part of a Template Entity.\n *\n * @public\n */\nexport interface TemplateParametersV1beta3 extends JsonObject {\n  'backstage:permissions'?: TemplatePermissionsV1beta3;\n}\n\n/**\n *  Access control properties for parts of a template.\n *\n * @public\n */\nexport interface TemplatePermissionsV1beta3 extends JsonObject {\n  tags?: string[];\n}\n\nconst validator = entityKindSchemaValidator(schema);\n\n/**\n * Entity data validator for {@link TemplateEntityV1beta3}.\n *\n * @public\n */\nexport const templateEntityV1beta3Validator: KindValidator = {\n  // TODO(freben): Emulate the old KindValidator until we fix that type\n  async check(data: Entity) {\n    return validator(data) === data;\n  },\n};\n\n/**\n * Typeguard for filtering entities and ensuring v1beta3 entities\n * @public\n */\nexport const isTemplateEntityV1beta3 = (\n  entity: Entity,\n): entity is TemplateEntityV1beta3 =>\n  entity.apiVersion === 'scaffolder.backstage.io/v1beta3' &&\n  entity.kind === 'Template';\n"],"names":["entityKindSchemaValidator","schema"],"mappings":";;;;;AAkKA,MAAM,SAAA,GAAYA,uCAA0BC,+BAAM,CAAA;AAO3C,MAAM,8BAAgD,GAAA;AAAA;AAAA,EAE3D,MAAM,MAAM,IAAc,EAAA;AACxB,IAAO,OAAA,SAAA,CAAU,IAAI,CAAM,KAAA,IAAA;AAAA;AAE/B;AAMO,MAAM,0BAA0B,CACrC,MAAA,KAEA,OAAO,UAAe,KAAA,iCAAA,IACtB,OAAO,IAAS,KAAA;;;;;"}
+{"version":3,"file":"TemplateEntityV1beta3.cjs.js","sources":["../src/TemplateEntityV1beta3.ts"],"sourcesContent":["/*\n * Copyright 2020 The Backstage Authors\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 {\n  Entity,\n  entityKindSchemaValidator,\n  KindValidator,\n} from '@backstage/catalog-model';\nimport { JsonObject } from '@backstage/types';\nimport schema from './Template.v1beta3.schema.json';\n\n/**\n * Backstage catalog Template kind Entity. Templates are used by the Scaffolder\n * plugin to create new entities, such as Components.\n *\n * @public\n */\nexport interface TemplateEntityV1beta3 extends Entity {\n  /**\n   * The apiVersion string of the TaskSpec.\n   */\n  apiVersion: 'scaffolder.backstage.io/v1beta3';\n  /**\n   * The kind of the entity\n   */\n  kind: 'Template';\n  /**\n   * The specification of the Template Entity\n   */\n  spec: {\n    /**\n     * The type that the Template will create. For example service, website or library.\n     */\n    type: string;\n\n    /**\n     * Template specific configuration of the presentation layer.\n     */\n    presentation?: TemplatePresentationV1beta3;\n\n    /**\n     * Recovery strategy for the template\n     */\n    EXPERIMENTAL_recovery?: TemplateRecoveryV1beta3;\n\n    /**\n     * Form hooks to be run\n     */\n    EXPERIMENTAL_formDecorators?: { id: string; input?: JsonObject }[];\n\n    /**\n     * This is a JSONSchema or an array of JSONSchema's which is used to render a form in the frontend\n     * to collect user input and validate it against that schema. This can then be used in the `steps` part below to template\n     * variables passed from the user into each action in the template.\n     */\n    parameters?: TemplateParametersV1beta3 | TemplateParametersV1beta3[];\n    /**\n     * A list of steps to be executed in sequence which are defined by the template. These steps are a list of the underlying\n     * javascript action and some optional input parameters that may or may not have been collected from the end user.\n     */\n    steps: Array<TemplateEntityStepV1beta3>;\n    /**\n     * The output is an object where template authors can pull out information from template actions and return them in a known standard way.\n     */\n    output?: { [name: string]: string };\n    /**\n     * The owner entityRef of the TemplateEntity\n     */\n    owner?: string;\n    /**\n     * Specifies the lifecycle phase of the TemplateEntity\n     */\n    lifecycle?: string;\n  };\n}\n\n/**\n * Depends on how you designed your task you might tailor the behaviour for each of them.\n *\n * @public\n */\nexport interface TemplateRecoveryV1beta3 extends JsonObject {\n  /**\n   *\n   * none - not recover, let the task be marked as failed\n   * startOver - do recover, start the execution of the task from the first step.\n   *\n   * @public\n   */\n  EXPERIMENTAL_strategy?: 'none' | 'startOver';\n}\n\n/**\n * The presentation of the template.\n *\n * @public\n */\nexport interface TemplatePresentationV1beta3 extends JsonObject {\n  /**\n   * Overrides default buttons' text\n   */\n  buttonLabels?: {\n    /**\n     * The text for the button which leads to the previous template page\n     */\n    backButtonText?: string;\n    /**\n     * The text for the button which starts the execution of the template\n     */\n    createButtonText?: string;\n    /**\n     * The text for the button which opens template's review/summary\n     */\n    reviewButtonText?: string;\n  };\n}\n\n/**\n * Step that is part of a Template Entity.\n *\n * @public\n */\nexport interface TemplateEntityStepV1beta3 extends JsonObject {\n  id?: string;\n  name?: string;\n  action: string;\n  input?: JsonObject;\n  if?: string | boolean;\n  'backstage:permissions'?: TemplatePermissionsV1beta3;\n}\n\n/**\n * The shape of each entry of parameters which gets rendered\n * as a separate step in the wizard input\n *\n * @public\n */\nexport type TemplateParameterSchema = {\n  title: string;\n  description?: string;\n  presentation?: TemplatePresentationV1beta3;\n  steps: Array<{\n    title: string;\n    description?: string;\n    schema: JsonObject;\n  }>;\n  EXPERIMENTAL_formDecorators?: { id: string; input?: JsonObject }[];\n};\n\n/**\n * Parameter that is part of a Template Entity.\n *\n * @public\n */\nexport interface TemplateParametersV1beta3 extends JsonObject {\n  'backstage:permissions'?: TemplatePermissionsV1beta3;\n}\n\n/**\n *  Access control properties for parts of a template.\n *\n * @public\n */\nexport interface TemplatePermissionsV1beta3 extends JsonObject {\n  tags?: string[];\n}\n\nconst validator = entityKindSchemaValidator(schema);\n\n/**\n * Entity data validator for {@link TemplateEntityV1beta3}.\n *\n * @public\n */\nexport const templateEntityV1beta3Validator: KindValidator = {\n  // TODO(freben): Emulate the old KindValidator until we fix that type\n  async check(data: Entity) {\n    return validator(data) === data;\n  },\n};\n\n/**\n * Typeguard for filtering entities and ensuring v1beta3 entities\n * @public\n */\nexport const isTemplateEntityV1beta3 = (\n  entity: Entity,\n): entity is TemplateEntityV1beta3 =>\n  entity.apiVersion === 'scaffolder.backstage.io/v1beta3' &&\n  entity.kind === 'Template';\n"],"names":["entityKindSchemaValidator","schema"],"mappings":";;;;;AAoLA,MAAM,SAAA,GAAYA,uCAA0BC,+BAAM,CAAA;AAO3C,MAAM,8BAAgD,GAAA;AAAA;AAAA,EAE3D,MAAM,MAAM,IAAc,EAAA;AACxB,IAAO,OAAA,SAAA,CAAU,IAAI,CAAM,KAAA,IAAA;AAAA;AAE/B;AAMO,MAAM,0BAA0B,CACrC,MAAA,KAEA,OAAO,UAAe,KAAA,iCAAA,IACtB,OAAO,IAAS,KAAA;;;;;"}

package/dist/TemplateEntityV1beta3.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"TemplateEntityV1beta3.esm.js","sources":["../src/TemplateEntityV1beta3.ts"],"sourcesContent":["/*\n * Copyright 2020 The Backstage Authors\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 {\n  Entity,\n  entityKindSchemaValidator,\n  KindValidator,\n} from '@backstage/catalog-model';\nimport { JsonObject } from '@backstage/types';\nimport schema from './Template.v1beta3.schema.json';\n\n/**\n * Backstage catalog Template kind Entity. Templates are used by the Scaffolder\n * plugin to create new entities, such as Components.\n *\n * @public\n */\nexport interface TemplateEntityV1beta3 extends Entity {\n  /**\n   * The apiVersion string of the TaskSpec.\n   */\n  apiVersion: 'scaffolder.backstage.io/v1beta3';\n  /**\n   * The kind of the entity\n   */\n  kind: 'Template';\n  /**\n   * The specification of the Template Entity\n   */\n  spec: {\n    /**\n     * The type that the Template will create. For example service, website or library.\n     */\n    type: string;\n\n    /**\n     * Template specific configuration of the presentation layer.\n     */\n    presentation?: TemplatePresentationV1beta3;\n\n    /**\n     * Recovery strategy for the template\n     */\n    EXPERIMENTAL_recovery?: TemplateRecoveryV1beta3;\n\n    /**\n     * Form hooks to be run\n     */\n    EXPERIMENTAL_formDecorators?: { id: string; input?: JsonObject }[];\n\n    /**\n     * This is a JSONSchema or an array of JSONSchema's which is used to render a form in the frontend\n     * to collect user input and validate it against that schema. This can then be used in the `steps` part below to template\n     * variables passed from the user into each action in the template.\n     */\n    parameters?: TemplateParametersV1beta3 | TemplateParametersV1beta3[];\n    /**\n     * A list of steps to be executed in sequence which are defined by the template. These steps are a list of the underlying\n     * javascript action and some optional input parameters that may or may not have been collected from the end user.\n     */\n    steps: Array<TemplateEntityStepV1beta3>;\n    /**\n     * The output is an object where template authors can pull out information from template actions and return them in a known standard way.\n     */\n    output?: { [name: string]: string };\n    /**\n     * The owner entityRef of the TemplateEntity\n     */\n    owner?: string;\n    /**\n     * Specifies the lifecycle phase of the TemplateEntity\n     */\n    lifecycle?: string;\n  };\n}\n\n/**\n * Depends on how you designed your task you might tailor the behaviour for each of them.\n *\n * @public\n */\nexport interface TemplateRecoveryV1beta3 extends JsonObject {\n  /**\n   *\n   * none - not recover, let the task be marked as failed\n   * startOver - do recover, start the execution of the task from the first step.\n   *\n   * @public\n   */\n  EXPERIMENTAL_strategy?: 'none' | 'startOver';\n}\n\n/**\n * The presentation of the template.\n *\n * @public\n */\nexport interface TemplatePresentationV1beta3 extends JsonObject {\n  /**\n   * Overrides default buttons' text\n   */\n  buttonLabels?: {\n    /**\n     * The text for the button which leads to the previous template page\n     */\n    backButtonText?: string;\n    /**\n     * The text for the button which starts the execution of the template\n     */\n    createButtonText?: string;\n    /**\n     * The text for the button which opens template's review/summary\n     */\n    reviewButtonText?: string;\n  };\n}\n\n/**\n * Step that is part of a Template Entity.\n *\n * @public\n */\nexport interface TemplateEntityStepV1beta3 extends JsonObject {\n  id?: string;\n  name?: string;\n  action: string;\n  input?: JsonObject;\n  if?: string | boolean;\n  'backstage:permissions'?: TemplatePermissionsV1beta3;\n}\n\n/**\n * Parameter that is part of a Template Entity.\n *\n * @public\n */\nexport interface TemplateParametersV1beta3 extends JsonObject {\n  'backstage:permissions'?: TemplatePermissionsV1beta3;\n}\n\n/**\n *  Access control properties for parts of a template.\n *\n * @public\n */\nexport interface TemplatePermissionsV1beta3 extends JsonObject {\n  tags?: string[];\n}\n\nconst validator = entityKindSchemaValidator(schema);\n\n/**\n * Entity data validator for {@link TemplateEntityV1beta3}.\n *\n * @public\n */\nexport const templateEntityV1beta3Validator: KindValidator = {\n  // TODO(freben): Emulate the old KindValidator until we fix that type\n  async check(data: Entity) {\n    return validator(data) === data;\n  },\n};\n\n/**\n * Typeguard for filtering entities and ensuring v1beta3 entities\n * @public\n */\nexport const isTemplateEntityV1beta3 = (\n  entity: Entity,\n): entity is TemplateEntityV1beta3 =>\n  entity.apiVersion === 'scaffolder.backstage.io/v1beta3' &&\n  entity.kind === 'Template';\n"],"names":[],"mappings":";;;AAkKA,MAAM,SAAA,GAAY,0BAA0B,MAAM,CAAA;AAO3C,MAAM,8BAAgD,GAAA;AAAA;AAAA,EAE3D,MAAM,MAAM,IAAc,EAAA;AACxB,IAAO,OAAA,SAAA,CAAU,IAAI,CAAM,KAAA,IAAA;AAAA;AAE/B;AAMO,MAAM,0BAA0B,CACrC,MAAA,KAEA,OAAO,UAAe,KAAA,iCAAA,IACtB,OAAO,IAAS,KAAA;;;;"}
+{"version":3,"file":"TemplateEntityV1beta3.esm.js","sources":["../src/TemplateEntityV1beta3.ts"],"sourcesContent":["/*\n * Copyright 2020 The Backstage Authors\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 {\n  Entity,\n  entityKindSchemaValidator,\n  KindValidator,\n} from '@backstage/catalog-model';\nimport { JsonObject } from '@backstage/types';\nimport schema from './Template.v1beta3.schema.json';\n\n/**\n * Backstage catalog Template kind Entity. Templates are used by the Scaffolder\n * plugin to create new entities, such as Components.\n *\n * @public\n */\nexport interface TemplateEntityV1beta3 extends Entity {\n  /**\n   * The apiVersion string of the TaskSpec.\n   */\n  apiVersion: 'scaffolder.backstage.io/v1beta3';\n  /**\n   * The kind of the entity\n   */\n  kind: 'Template';\n  /**\n   * The specification of the Template Entity\n   */\n  spec: {\n    /**\n     * The type that the Template will create. For example service, website or library.\n     */\n    type: string;\n\n    /**\n     * Template specific configuration of the presentation layer.\n     */\n    presentation?: TemplatePresentationV1beta3;\n\n    /**\n     * Recovery strategy for the template\n     */\n    EXPERIMENTAL_recovery?: TemplateRecoveryV1beta3;\n\n    /**\n     * Form hooks to be run\n     */\n    EXPERIMENTAL_formDecorators?: { id: string; input?: JsonObject }[];\n\n    /**\n     * This is a JSONSchema or an array of JSONSchema's which is used to render a form in the frontend\n     * to collect user input and validate it against that schema. This can then be used in the `steps` part below to template\n     * variables passed from the user into each action in the template.\n     */\n    parameters?: TemplateParametersV1beta3 | TemplateParametersV1beta3[];\n    /**\n     * A list of steps to be executed in sequence which are defined by the template. These steps are a list of the underlying\n     * javascript action and some optional input parameters that may or may not have been collected from the end user.\n     */\n    steps: Array<TemplateEntityStepV1beta3>;\n    /**\n     * The output is an object where template authors can pull out information from template actions and return them in a known standard way.\n     */\n    output?: { [name: string]: string };\n    /**\n     * The owner entityRef of the TemplateEntity\n     */\n    owner?: string;\n    /**\n     * Specifies the lifecycle phase of the TemplateEntity\n     */\n    lifecycle?: string;\n  };\n}\n\n/**\n * Depends on how you designed your task you might tailor the behaviour for each of them.\n *\n * @public\n */\nexport interface TemplateRecoveryV1beta3 extends JsonObject {\n  /**\n   *\n   * none - not recover, let the task be marked as failed\n   * startOver - do recover, start the execution of the task from the first step.\n   *\n   * @public\n   */\n  EXPERIMENTAL_strategy?: 'none' | 'startOver';\n}\n\n/**\n * The presentation of the template.\n *\n * @public\n */\nexport interface TemplatePresentationV1beta3 extends JsonObject {\n  /**\n   * Overrides default buttons' text\n   */\n  buttonLabels?: {\n    /**\n     * The text for the button which leads to the previous template page\n     */\n    backButtonText?: string;\n    /**\n     * The text for the button which starts the execution of the template\n     */\n    createButtonText?: string;\n    /**\n     * The text for the button which opens template's review/summary\n     */\n    reviewButtonText?: string;\n  };\n}\n\n/**\n * Step that is part of a Template Entity.\n *\n * @public\n */\nexport interface TemplateEntityStepV1beta3 extends JsonObject {\n  id?: string;\n  name?: string;\n  action: string;\n  input?: JsonObject;\n  if?: string | boolean;\n  'backstage:permissions'?: TemplatePermissionsV1beta3;\n}\n\n/**\n * The shape of each entry of parameters which gets rendered\n * as a separate step in the wizard input\n *\n * @public\n */\nexport type TemplateParameterSchema = {\n  title: string;\n  description?: string;\n  presentation?: TemplatePresentationV1beta3;\n  steps: Array<{\n    title: string;\n    description?: string;\n    schema: JsonObject;\n  }>;\n  EXPERIMENTAL_formDecorators?: { id: string; input?: JsonObject }[];\n};\n\n/**\n * Parameter that is part of a Template Entity.\n *\n * @public\n */\nexport interface TemplateParametersV1beta3 extends JsonObject {\n  'backstage:permissions'?: TemplatePermissionsV1beta3;\n}\n\n/**\n *  Access control properties for parts of a template.\n *\n * @public\n */\nexport interface TemplatePermissionsV1beta3 extends JsonObject {\n  tags?: string[];\n}\n\nconst validator = entityKindSchemaValidator(schema);\n\n/**\n * Entity data validator for {@link TemplateEntityV1beta3}.\n *\n * @public\n */\nexport const templateEntityV1beta3Validator: KindValidator = {\n  // TODO(freben): Emulate the old KindValidator until we fix that type\n  async check(data: Entity) {\n    return validator(data) === data;\n  },\n};\n\n/**\n * Typeguard for filtering entities and ensuring v1beta3 entities\n * @public\n */\nexport const isTemplateEntityV1beta3 = (\n  entity: Entity,\n): entity is TemplateEntityV1beta3 =>\n  entity.apiVersion === 'scaffolder.backstage.io/v1beta3' &&\n  entity.kind === 'Template';\n"],"names":[],"mappings":";;;AAoLA,MAAM,SAAA,GAAY,0BAA0B,MAAM,CAAA;AAO3C,MAAM,8BAAgD,GAAA;AAAA;AAAA,EAE3D,MAAM,MAAM,IAAc,EAAA;AACxB,IAAO,OAAA,SAAA,CAAU,IAAI,CAAM,KAAA,IAAA;AAAA;AAE/B;AAMO,MAAM,0BAA0B,CACrC,MAAA,KAEA,OAAO,UAAe,KAAA,iCAAA,IACtB,OAAO,IAAS,KAAA;;;;"}

package/dist/index.cjs.js

@@ -1,9 +1,11 @@
 'use strict';
 
 var TemplateEntityV1beta3 = require('./TemplateEntityV1beta3.cjs.js');
+var ScaffolderClient = require('./ScaffolderClient.cjs.js');
 
 
 
 exports.isTemplateEntityV1beta3 = TemplateEntityV1beta3.isTemplateEntityV1beta3;
 exports.templateEntityV1beta3Validator = TemplateEntityV1beta3.templateEntityV1beta3Validator;
+exports.ScaffolderClient = ScaffolderClient.ScaffolderClient;
 //# sourceMappingURL=index.cjs.js.map

package/dist/index.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;"}
+{"version":3,"file":"index.cjs.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;"}

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 import { EntityMeta, UserEntity, Entity, KindValidator } from '@backstage/catalog-model';
-import { JsonObject, JsonArray, JsonValue } from '@backstage/types';
+import { JsonObject, JsonArray, JsonValue, Observable } from '@backstage/types';
+import { ScmIntegrationRegistry } from '@backstage/integration';
+import { JSONSchema7 } from 'json-schema';
 
 /**
  * Information about a template that is stored on a task specification.
@@ -253,6 +255,26 @@ interface TemplateEntityStepV1beta3 extends JsonObject {
     if?: string | boolean;
     'backstage:permissions'?: TemplatePermissionsV1beta3;
 }
+/**
+ * The shape of each entry of parameters which gets rendered
+ * as a separate step in the wizard input
+ *
+ * @public
+ */
+type TemplateParameterSchema = {
+    title: string;
+    description?: string;
+    presentation?: TemplatePresentationV1beta3;
+    steps: Array<{
+        title: string;
+        description?: string;
+        schema: JsonObject;
+    }>;
+    EXPERIMENTAL_formDecorators?: {
+        id: string;
+        input?: JsonObject;
+    }[];
+};
 /**
  * Parameter that is part of a Template Entity.
  *
@@ -281,4 +303,381 @@ declare const templateEntityV1beta3Validator: KindValidator;
  */
 declare const isTemplateEntityV1beta3: (entity: Entity) => entity is TemplateEntityV1beta3;
 
-export { type TaskRecoverStrategy, type TaskRecovery, type TaskSpec, type TaskSpecV1beta3, type TaskStep, type TemplateEntityStepV1beta3, type TemplateEntityV1beta3, type TemplateInfo, type TemplateParametersV1beta3, type TemplatePermissionsV1beta3, type TemplatePresentationV1beta3, type TemplateRecoveryV1beta3, isTemplateEntityV1beta3, templateEntityV1beta3Validator };
+/**
+ * @public
+ */
+type TaskStatus = 'cancelled' | 'completed' | 'failed' | 'open' | 'processing' | 'skipped';
+
+/**
+ * @public
+ */
+type TaskEventType = 'cancelled' | 'completion' | 'log' | 'recovered';
+
+/**
+ * Options you can pass into a Scaffolder request for additional information.
+ *
+ * @public
+ */
+interface ScaffolderRequestOptions {
+    token?: string;
+}
+/**
+ * The shape of each task returned from the `scaffolder-backend`
+ *
+ * @public
+ */
+type ScaffolderTask = {
+    id: string;
+    spec: TaskSpec;
+    status: TaskStatus;
+    lastHeartbeatAt?: string;
+    createdAt: string;
+};
+/**
+ * A single scaffolder usage example
+ *
+ * @public
+ */
+type ScaffolderUsageExample = {
+    description?: string;
+    example: string;
+    notes?: string;
+};
+/**
+ * The response shape for a single action in the `listActions` call to the `scaffolder-backend`
+ *
+ * @public
+ */
+type Action = {
+    id: string;
+    description?: string;
+    schema?: {
+        input?: JSONSchema7;
+        output?: JSONSchema7;
+    };
+    examples?: ScaffolderUsageExample[];
+};
+/**
+ * The response shape for the `listActions` call to the `scaffolder-backend`
+ *
+ * @public
+ */
+type ListActionsResponse = Array<Action>;
+/**
+ * The response shape for a single filter in the `listTemplatingExtensions` call to the `scaffolder-backend`
+ *
+ * @public
+ */
+type TemplateFilter = {
+    description?: string;
+    schema?: {
+        input?: JSONSchema7;
+        arguments?: JSONSchema7[];
+        output?: JSONSchema7;
+    };
+    examples?: ScaffolderUsageExample[];
+};
+/**
+ * The response shape for a single global function in the `listTemplatingExtensions` call to the `scaffolder-backend`
+ *
+ * @public
+ */
+type TemplateGlobalFunction = {
+    description?: string;
+    schema?: {
+        arguments?: JSONSchema7[];
+        output?: JSONSchema7;
+    };
+    examples?: ScaffolderUsageExample[];
+};
+/**
+ * The response shape for a single global value in the `listTemplatingExtensions` call to the `scaffolder-backend`
+ *
+ * @public
+ */
+type TemplateGlobalValue = {
+    description?: string;
+    value: JsonValue;
+};
+/**
+ * The response shape for the `listTemplatingExtensions` call to the `scaffolder-backend`
+ *
+ * @public
+ */
+type ListTemplatingExtensionsResponse = {
+    filters: Record<string, TemplateFilter>;
+    globals: {
+        functions: Record<string, TemplateGlobalFunction>;
+        values: Record<string, TemplateGlobalValue>;
+    };
+};
+/** @public */
+type ScaffolderOutputLink = {
+    title?: string;
+    icon?: string;
+    url?: string;
+    entityRef?: string;
+};
+/** @public */
+type ScaffolderOutputText = {
+    title?: string;
+    icon?: string;
+    content?: string;
+    default?: boolean;
+};
+/** @public */
+type ScaffolderTaskOutput = {
+    links?: ScaffolderOutputLink[];
+    text?: ScaffolderOutputText[];
+} & {
+    [key: string]: unknown;
+};
+/**
+ * The shape of a `LogEvent` message from the `scaffolder-backend`
+ *
+ * @public
+ */
+type LogEvent = {
+    type: TaskEventType;
+    body: {
+        message: string;
+        stepId?: string;
+        status?: TaskStatus;
+    };
+    createdAt: string;
+    id: number;
+    taskId: string;
+};
+/**
+ * The input options to the `scaffold` method of the `ScaffolderClient`.
+ *
+ * @public
+ */
+interface ScaffolderScaffoldOptions {
+    templateRef: string;
+    values: Record<string, JsonValue>;
+    secrets?: Record<string, string>;
+}
+/**
+ * The response shape of the `scaffold` method of the `ScaffolderClient`.
+ *
+ * @public
+ */
+interface ScaffolderScaffoldResponse {
+    taskId: string;
+}
+/**
+ * The arguments for `getIntegrationsList`.
+ *
+ * @public
+ */
+interface ScaffolderGetIntegrationsListOptions {
+    allowedHosts: string[];
+}
+/**
+ * The response shape for `getIntegrationsList`.
+ *
+ * @public
+ */
+interface ScaffolderGetIntegrationsListResponse {
+    integrations: {
+        type: string;
+        title: string;
+        host: string;
+    }[];
+}
+/**
+ * The input options to the `streamLogs` method of the `ScaffolderClient`.
+ *
+ * @public
+ */
+interface ScaffolderStreamLogsOptions {
+    isTaskRecoverable?: boolean;
+    taskId: string;
+    after?: number;
+}
+/** @public */
+interface ScaffolderDryRunOptions {
+    template: TemplateEntityV1beta3;
+    values: JsonObject;
+    secrets?: Record<string, string>;
+    directoryContents: {
+        path: string;
+        base64Content: string;
+    }[];
+}
+/** @public */
+interface ScaffolderDryRunResponse {
+    directoryContents: Array<{
+        path: string;
+        base64Content: string;
+        executable?: boolean;
+    }>;
+    log: Array<Pick<LogEvent, 'body'>>;
+    steps: TaskStep[];
+    output: ScaffolderTaskOutput;
+}
+/**
+ * An API to interact with the scaffolder backend.
+ *
+ * @public
+ */
+interface ScaffolderApi {
+    getTemplateParameterSchema(templateRef: string, options?: ScaffolderRequestOptions): Promise<TemplateParameterSchema>;
+    /**
+     * Executes the scaffolding of a component, given a template and its
+     * parameter values.
+     *
+     * @param options - The {@link ScaffolderScaffoldOptions} the scaffolding.
+     */
+    scaffold(request: ScaffolderScaffoldOptions, options?: ScaffolderRequestOptions): Promise<ScaffolderScaffoldResponse>;
+    getTask(taskId: string, options?: ScaffolderRequestOptions): Promise<ScaffolderTask>;
+    /**
+     * Sends a signal to a task broker to cancel the running task by taskId.
+     *
+     * @param taskId - the id of the task
+     */
+    cancelTask(taskId: string, options?: ScaffolderRequestOptions): Promise<{
+        status?: TaskStatus;
+    }>;
+    /**
+     * Starts the task again from the point where it failed.
+     *
+     * @param taskId - the id of the task
+     */
+    retry?(taskId: string, options?: ScaffolderRequestOptions): Promise<{
+        id: string;
+    }>;
+    listTasks?(request: {
+        filterByOwnership: 'owned' | 'all';
+        limit?: number;
+        offset?: number;
+    }, options?: ScaffolderRequestOptions): Promise<{
+        tasks: ScaffolderTask[];
+        totalTasks?: number;
+    }>;
+    getIntegrationsList(options: ScaffolderGetIntegrationsListOptions): Promise<ScaffolderGetIntegrationsListResponse>;
+    /**
+     * Returns a list of all installed actions.
+     */
+    listActions(options?: ScaffolderRequestOptions): Promise<ListActionsResponse>;
+    /**
+     * Returns a structure describing the available templating extensions.
+     */
+    listTemplatingExtensions?(options?: ScaffolderRequestOptions): Promise<ListTemplatingExtensionsResponse>;
+    streamLogs(request: ScaffolderStreamLogsOptions, options?: ScaffolderRequestOptions): Observable<LogEvent>;
+    dryRun?(request: ScaffolderDryRunOptions, options?: ScaffolderRequestOptions): Promise<ScaffolderDryRunResponse>;
+    autocomplete?(request: {
+        token: string;
+        provider: string;
+        resource: string;
+        context: Record<string, string>;
+    }, options?: ScaffolderRequestOptions): Promise<{
+        results: {
+            title?: string;
+            id: string;
+        }[];
+    }>;
+}
+
+/**
+ * An API to interact with the scaffolder backend.
+ *
+ * @public
+ */
+declare class ScaffolderClient implements ScaffolderApi {
+    private readonly apiClient;
+    private readonly discoveryApi;
+    private readonly scmIntegrationsApi;
+    private readonly fetchApi;
+    private readonly identityApi?;
+    private readonly useLongPollingLogs;
+    constructor(options: {
+        discoveryApi: {
+            getBaseUrl(pluginId: string): Promise<string>;
+        };
+        fetchApi: {
+            fetch: typeof fetch;
+        };
+        identityApi?: {
+            getBackstageIdentity(): Promise<{
+                type: 'user';
+                userEntityRef: string;
+                ownershipEntityRefs: string[];
+            }>;
+        };
+        scmIntegrationsApi: ScmIntegrationRegistry;
+        useLongPollingLogs?: boolean;
+    });
+    /**
+     * {@inheritdoc ScaffolderApi.listTasks}
+     */
+    listTasks(request: {
+        filterByOwnership: 'owned' | 'all';
+        limit?: number;
+        offset?: number;
+    }, options?: ScaffolderRequestOptions): Promise<{
+        tasks: ScaffolderTask[];
+        totalTasks?: number;
+    }>;
+    getIntegrationsList(options: ScaffolderGetIntegrationsListOptions): Promise<ScaffolderGetIntegrationsListResponse>;
+    /**
+     * {@inheritdoc ScaffolderApi.getTemplateParameterSchema}
+     */
+    getTemplateParameterSchema(templateRef: string, options?: ScaffolderRequestOptions): Promise<TemplateParameterSchema>;
+    /**
+     * {@inheritdoc ScaffolderApi.scaffold}
+     */
+    scaffold(request: ScaffolderScaffoldOptions, options?: ScaffolderRequestOptions): Promise<ScaffolderScaffoldResponse>;
+    /**
+     * {@inheritdoc ScaffolderApi.getTask}
+     */
+    getTask(taskId: string, options?: ScaffolderRequestOptions): Promise<ScaffolderTask>;
+    /**
+     * {@inheritdoc ScaffolderApi.streamLogs}
+     */
+    streamLogs(request: ScaffolderStreamLogsOptions, options?: ScaffolderRequestOptions): Observable<LogEvent>;
+    /**
+     * {@inheritdoc ScaffolderApi.dryRun}
+     */
+    dryRun(request: ScaffolderDryRunOptions, options?: ScaffolderRequestOptions): Promise<ScaffolderDryRunResponse>;
+    private streamLogsEventStream;
+    private streamLogsPolling;
+    /**
+     * {@inheritdoc ScaffolderApi.listActions}
+     */
+    listActions(options?: ScaffolderRequestOptions): Promise<ListActionsResponse>;
+    /**
+     * {@inheritdoc ScaffolderApi.listTemplatingExtensions}
+     */
+    listTemplatingExtensions(options?: ScaffolderRequestOptions): Promise<ListTemplatingExtensionsResponse>;
+    /**
+     * {@inheritdoc ScaffolderApi.cancelTask}
+     */
+    cancelTask(taskId: string, options?: ScaffolderRequestOptions): Promise<{
+        status?: TaskStatus;
+    }>;
+    /**
+     * {@inheritdoc ScaffolderApi.retry}
+     */
+    retry?(taskId: string, options?: ScaffolderRequestOptions): Promise<{
+        id: string;
+    }>;
+    /**
+     * {@inheritdoc ScaffolderApi.retry}
+     */
+    autocomplete({ token, resource, provider, context, }: {
+        token: string;
+        provider: string;
+        resource: string;
+        context: Record<string, string>;
+    }): Promise<{
+        results: {
+            title?: string;
+            id: string;
+        }[];
+    }>;
+    private requestRequired;
+}
+
+export { type Action, type ListActionsResponse, type ListTemplatingExtensionsResponse, type LogEvent, type ScaffolderApi, ScaffolderClient, type ScaffolderDryRunOptions, type ScaffolderDryRunResponse, type ScaffolderGetIntegrationsListOptions, type ScaffolderGetIntegrationsListResponse, type ScaffolderOutputLink, type ScaffolderOutputText, type ScaffolderRequestOptions, type ScaffolderScaffoldOptions, type ScaffolderScaffoldResponse, type ScaffolderStreamLogsOptions, type ScaffolderTask, type ScaffolderTaskOutput, type TaskStatus as ScaffolderTaskStatus, type ScaffolderUsageExample, type TaskEventType, type TaskRecoverStrategy, type TaskRecovery, type TaskSpec, type TaskSpecV1beta3, type TaskStep, type TemplateEntityStepV1beta3, type TemplateEntityV1beta3, type TemplateFilter, type TemplateGlobalFunction, type TemplateGlobalValue, type TemplateInfo, type TemplateParameterSchema, type TemplateParametersV1beta3, type TemplatePermissionsV1beta3, type TemplatePresentationV1beta3, type TemplateRecoveryV1beta3, isTemplateEntityV1beta3, templateEntityV1beta3Validator };

package/dist/index.esm.js

@@ -1,2 +1,3 @@
 export { isTemplateEntityV1beta3, templateEntityV1beta3Validator } from './TemplateEntityV1beta3.esm.js';
+export { ScaffolderClient } from './ScaffolderClient.esm.js';
 //# sourceMappingURL=index.esm.js.map

package/dist/index.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.esm.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}
+{"version":3,"file":"index.esm.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}