@backstage/plugin-scaffolder-backend 0.15.11 → 0.15.15

package/dist/index.d.ts

@@ -11,6 +11,8 @@ import { Config } from '@backstage/config';
 import { createPullRequest } from 'octokit-plugin-create-pull-request';
 import { Octokit } from '@octokit/rest';
 export { createFetchCookiecutterAction } from '@backstage/plugin-scaffolder-backend-module-cookiecutter';
+import { SpawnOptionsWithoutStdio } from 'child_process';
+import { Knex } from 'knex';
 import express from 'express';
 import { TemplateEntityV1beta2, Entity, LocationSpec } from '@backstage/catalog-model';
 import { CatalogProcessor, CatalogProcessorEmit } from '@backstage/plugin-catalog-backend';
@@ -139,11 +141,217 @@ declare class OctokitProvider {
 }
 
 declare type RunCommandOptions = {
+    /** command to run */
     command: string;
+    /** arguments to pass the command */
     args: string[];
+    /** options to pass to spawn */
+    options?: SpawnOptionsWithoutStdio;
+    /** stream to capture stdout and stderr output */
     logStream?: Writable;
 };
-declare const runCommand: ({ command, args, logStream, }: RunCommandOptions) => Promise<void>;
+/**
+ * Run a command in a sub-process, normally a shell command.
+ */
+declare const runCommand: ({ command, args, logStream, options, }: RunCommandOptions) => Promise<void>;
+
+/**
+ * Status
+ *
+ * @public
+ */
+declare type Status = 'open' | 'processing' | 'failed' | 'cancelled' | 'completed';
+/**
+ * CompletedTaskState
+ *
+ * @public
+ */
+declare type CompletedTaskState = 'failed' | 'completed';
+/**
+ * SerializedTask
+ *
+ * @public
+ */
+declare type SerializedTask = {
+    id: string;
+    spec: TaskSpec;
+    status: Status;
+    createdAt: string;
+    lastHeartbeatAt?: string;
+    secrets?: TaskSecrets;
+};
+/**
+ * TaskEventType
+ *
+ * @public
+ */
+declare type TaskEventType = 'completion' | 'log';
+/**
+ * SerializedTaskEvent
+ *
+ * @public
+ */
+declare type SerializedTaskEvent = {
+    id: number;
+    taskId: string;
+    body: JsonObject;
+    type: TaskEventType;
+    createdAt: string;
+};
+/**
+ * TemplateMetadata
+ *
+ * @public
+ */
+declare type TemplateMetadata = {
+    name: string;
+};
+/**
+ * TaskSpecV1beta2
+ *
+ * @public
+ */
+interface TaskSpecV1beta2 {
+    apiVersion: 'backstage.io/v1beta2';
+    baseUrl?: string;
+    values: JsonObject;
+    steps: Array<{
+        id: string;
+        name: string;
+        action: string;
+        input?: JsonObject;
+        if?: string | boolean;
+    }>;
+    output: {
+        [name: string]: string;
+    };
+    metadata?: TemplateMetadata;
+}
+interface TaskStep {
+    id: string;
+    name: string;
+    action: string;
+    input?: JsonObject;
+    if?: string | boolean;
+}
+/**
+ * TaskSpecV1beta3
+ *
+ * @public
+ */
+interface TaskSpecV1beta3 {
+    apiVersion: 'scaffolder.backstage.io/v1beta3';
+    baseUrl?: string;
+    parameters: JsonObject;
+    steps: TaskStep[];
+    output: {
+        [name: string]: JsonValue;
+    };
+    metadata?: TemplateMetadata;
+}
+/**
+ * TaskSpec
+ *
+ * @public
+ */
+declare type TaskSpec = TaskSpecV1beta2 | TaskSpecV1beta3;
+/**
+ * TaskSecrets
+ *
+ * @public
+ */
+declare type TaskSecrets = {
+    token: string | undefined;
+};
+/**
+ * DispatchResult
+ *
+ * @public
+ */
+declare type DispatchResult = {
+    taskId: string;
+};
+/**
+ * Task
+ *
+ * @public
+ */
+interface TaskContext {
+    spec: TaskSpec;
+    secrets?: TaskSecrets;
+    done: boolean;
+    emitLog(message: string, metadata?: JsonValue): Promise<void>;
+    complete(result: CompletedTaskState, metadata?: JsonValue): Promise<void>;
+    getWorkspaceName(): Promise<string>;
+}
+/**
+ * TaskBroker
+ *
+ * @public
+ */
+interface TaskBroker {
+    claim(): Promise<TaskContext>;
+    dispatch(spec: TaskSpec, secrets?: TaskSecrets): Promise<DispatchResult>;
+    vacuumTasks(timeoutS: {
+        timeoutS: number;
+    }): Promise<void>;
+    observe(options: {
+        taskId: string;
+        after: number | undefined;
+    }, callback: (error: Error | undefined, result: {
+        events: SerializedTaskEvent[];
+    }) => void): {
+        unsubscribe: () => void;
+    };
+    get(taskId: string): Promise<SerializedTask>;
+}
+/**
+ * TaskStoreEmitOptions
+ *
+ * @public
+ */
+declare type TaskStoreEmitOptions = {
+    taskId: string;
+    body: JsonObject;
+};
+/**
+ * TaskStoreListEventsOptions
+ *
+ * @public
+ */
+declare type TaskStoreListEventsOptions = {
+    taskId: string;
+    after?: number | undefined;
+};
+/**
+ * TaskStore
+ *
+ * @public
+ */
+interface TaskStore {
+    createTask(task: TaskSpec, secrets?: TaskSecrets): Promise<{
+        taskId: string;
+    }>;
+    getTask(taskId: string): Promise<SerializedTask>;
+    claimTask(): Promise<SerializedTask | undefined>;
+    completeTask(options: {
+        taskId: string;
+        status: Status;
+        eventBody: JsonObject;
+    }): Promise<void>;
+    heartbeatTask(taskId: string): Promise<void>;
+    listStaleTasks(options: {
+        timeoutS: number;
+    }): Promise<{
+        tasks: {
+            taskId: string;
+        }[];
+    }>;
+    emitLogEvent({ taskId, body }: TaskStoreEmitOptions): Promise<void>;
+    listEvents({ taskId, after, }: TaskStoreListEventsOptions): Promise<{
+        events: SerializedTaskEvent[];
+    }>;
+}
 
 declare type PartialJsonObject = Partial<JsonObject>;
 declare type PartialJsonValue = PartialJsonObject | JsonValue | undefined;
@@ -168,6 +376,7 @@ declare type ActionContext<Input extends InputBase> = {
      * Creates a temporary directory for use by the action, which is then cleaned up automatically.
      */
     createTemporaryDirectory(): Promise<string>;
+    metadata?: TemplateMetadata;
 };
 declare type TemplateAction<Input extends InputBase> = {
     id: string;
@@ -190,6 +399,109 @@ declare const createTemplateAction: <Input extends Partial<{
     [name: string]: _backstage_types.JsonValue | Partial<_backstage_types.JsonObject> | undefined;
 }>>(templateAction: TemplateAction<Input>) => TemplateAction<any>;
 
+/**
+ * DatabaseTaskStore
+ *
+ * @public
+ */
+declare type DatabaseTaskStoreOptions = {
+    database: Knex;
+};
+/**
+ * DatabaseTaskStore
+ *
+ * @public
+ */
+declare class DatabaseTaskStore implements TaskStore {
+    private readonly db;
+    static create(options: DatabaseTaskStoreOptions): Promise<DatabaseTaskStore>;
+    constructor(options: DatabaseTaskStoreOptions);
+    getTask(taskId: string): Promise<SerializedTask>;
+    createTask(spec: TaskSpec, secrets?: TaskSecrets): Promise<{
+        taskId: string;
+    }>;
+    claimTask(): Promise<SerializedTask | undefined>;
+    heartbeatTask(taskId: string): Promise<void>;
+    listStaleTasks({ timeoutS }: {
+        timeoutS: number;
+    }): Promise<{
+        tasks: {
+            taskId: string;
+        }[];
+    }>;
+    completeTask({ taskId, status, eventBody, }: {
+        taskId: string;
+        status: Status;
+        eventBody: JsonObject;
+    }): Promise<void>;
+    emitLogEvent({ taskId, body }: TaskStoreEmitOptions): Promise<void>;
+    listEvents({ taskId, after, }: TaskStoreListEventsOptions): Promise<{
+        events: SerializedTaskEvent[];
+    }>;
+}
+
+/**
+ * TaskManager
+ *
+ * @public
+ */
+declare class TaskManager implements TaskContext {
+    private readonly state;
+    private readonly storage;
+    private readonly logger;
+    private isDone;
+    private heartbeatTimeoutId?;
+    static create(state: TaskState, storage: TaskStore, logger: Logger): TaskManager;
+    private constructor();
+    get spec(): TaskSpec;
+    get secrets(): TaskSecrets | undefined;
+    getWorkspaceName(): Promise<string>;
+    get done(): boolean;
+    emitLog(message: string, metadata?: JsonObject): Promise<void>;
+    complete(result: CompletedTaskState, metadata?: JsonObject): Promise<void>;
+    private startTimeout;
+}
+/**
+ * TaskState
+ *
+ * @public
+ */
+interface TaskState {
+    spec: TaskSpec;
+    taskId: string;
+    secrets?: TaskSecrets;
+}
+
+/**
+ * CreateWorkerOptions
+ *
+ * @public
+ */
+declare type CreateWorkerOptions = {
+    taskBroker: TaskBroker;
+    actionRegistry: TemplateActionRegistry;
+    integrations: ScmIntegrations;
+    workingDirectory: string;
+    logger: Logger;
+};
+/**
+ * TaskWorker
+ *
+ * @public
+ */
+declare class TaskWorker {
+    private readonly options;
+    private constructor();
+    static create(options: CreateWorkerOptions): Promise<TaskWorker>;
+    start(): void;
+    runOneTask(task: TaskContext): Promise<void>;
+}
+
+/**
+ * RouterOptions
+ *
+ * @public
+ */
 interface RouterOptions {
     logger: Logger;
     config: Config;
@@ -199,6 +511,7 @@ interface RouterOptions {
     actions?: TemplateAction<any>[];
     taskWorkers?: number;
     containerRunner: ContainerRunner;
+    taskBroker?: TaskBroker;
 }
 declare function createRouter(options: RouterOptions): Promise<express.Router>;
 
@@ -225,4 +538,4 @@ declare class ScaffolderEntitiesProcessor implements CatalogProcessor {
     postProcessEntity(entity: Entity, _location: LocationSpec, emit: CatalogProcessorEmit): Promise<Entity>;
 }
 
-export { ActionContext, CatalogEntityClient, OctokitProvider, RouterOptions, ScaffolderEntitiesProcessor, TemplateAction, TemplateActionRegistry, createBuiltinActions, createCatalogRegisterAction, createCatalogWriteAction, createDebugLogAction, createFetchPlainAction, createFetchTemplateAction, createFilesystemDeleteAction, createFilesystemRenameAction, createGithubActionsDispatchAction, createGithubWebhookAction, createPublishAzureAction, createPublishBitbucketAction, createPublishFileAction, createPublishGithubAction, createPublishGithubPullRequestAction, createPublishGitlabAction, createRouter, createTemplateAction, fetchContents, runCommand };
+export { ActionContext, CatalogEntityClient, CompletedTaskState, CreateWorkerOptions, DatabaseTaskStore, DispatchResult, OctokitProvider, RouterOptions, ScaffolderEntitiesProcessor, SerializedTask, SerializedTaskEvent, Status, TaskBroker, TaskContext, TaskEventType, TaskManager, TaskSecrets, TaskSpec, TaskSpecV1beta2, TaskSpecV1beta3, TaskState, TaskStore, TaskStoreEmitOptions, TaskStoreListEventsOptions, TaskWorker, TemplateAction, TemplateActionRegistry, TemplateMetadata, createBuiltinActions, createCatalogRegisterAction, createCatalogWriteAction, createDebugLogAction, createFetchPlainAction, createFetchTemplateAction, createFilesystemDeleteAction, createFilesystemRenameAction, createGithubActionsDispatchAction, createGithubWebhookAction, createPublishAzureAction, createPublishBitbucketAction, createPublishFileAction, createPublishGithubAction, createPublishGithubPullRequestAction, createPublishGitlabAction, createRouter, createTemplateAction, fetchContents, runCommand };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@backstage/plugin-scaffolder-backend",
   "description": "The Backstage backend plugin that helps you create new things",
-  "version": "0.15.11",
+  "version": "0.15.15",
   "main": "dist/index.cjs.js",
   "types": "dist/index.d.ts",
   "license": "Apache-2.0",
@@ -27,21 +27,22 @@
     "test": "backstage-cli test",
     "prepack": "backstage-cli prepack",
     "postpack": "backstage-cli postpack",
-    "clean": "backstage-cli clean"
+    "clean": "backstage-cli clean",
+    "build:assets": "node scripts/build-nunjucks.js"
   },
   "dependencies": {
-    "@backstage/backend-common": "^0.9.8",
-    "@backstage/catalog-client": "^0.5.0",
-    "@backstage/catalog-model": "^0.9.6",
+    "@backstage/backend-common": "^0.9.12",
+    "@backstage/catalog-client": "^0.5.2",
+    "@backstage/catalog-model": "^0.9.7",
     "@backstage/config": "^0.1.11",
-    "@backstage/errors": "^0.1.4",
-    "@backstage/integration": "^0.6.9",
-    "@backstage/plugin-catalog-backend": "^0.17.2",
-    "@backstage/plugin-scaffolder-backend-module-cookiecutter": "^0.1.3",
+    "@backstage/errors": "^0.1.5",
+    "@backstage/integration": "^0.6.10",
+    "@backstage/plugin-catalog-backend": "^0.19.0",
+    "@backstage/plugin-scaffolder-backend-module-cookiecutter": "^0.1.5",
     "@backstage/plugin-scaffolder-common": "^0.1.1",
     "@backstage/types": "^0.1.1",
-    "@gitbeaker/core": "^30.2.0",
-    "@gitbeaker/node": "^30.2.0",
+    "@gitbeaker/core": "^34.6.0",
+    "@gitbeaker/node": "^34.6.0",
     "@octokit/rest": "^18.5.3",
     "@octokit/webhooks": "^9.14.1",
     "@types/express": "^4.17.6",
@@ -49,7 +50,6 @@
     "command-exists": "^1.2.9",
     "compression": "^1.7.4",
     "cors": "^2.8.5",
-    "cross-fetch": "^3.0.6",
     "express": "^4.17.1",
     "express-promise-router": "^4.1.0",
     "fs-extra": "10.0.0",
@@ -64,21 +64,24 @@
     "lodash": "^4.17.21",
     "luxon": "^2.0.2",
     "morgan": "^1.10.0",
+    "node-fetch": "^2.6.1",
     "nunjucks": "^3.2.3",
     "octokit-plugin-create-pull-request": "^3.10.0",
     "uuid": "^8.2.0",
+    "vm2": "^3.9.5",
     "winston": "^3.2.1",
     "yaml": "^1.10.0"
   },
   "devDependencies": {
-    "@backstage/cli": "^0.8.1",
-    "@backstage/test-utils": "^0.1.20",
+    "@backstage/cli": "^0.10.0",
+    "@backstage/test-utils": "^0.1.23",
     "@types/command-exists": "^1.2.0",
     "@types/fs-extra": "^9.0.1",
     "@types/git-url-parse": "^9.0.0",
     "@types/mock-fs": "^4.13.0",
     "@types/nunjucks": "^3.1.4",
     "@types/supertest": "^2.0.8",
+    "esbuild": "^0.13.14",
     "jest-when": "^3.1.0",
     "mock-fs": "^5.1.0",
     "msw": "^0.35.0",
@@ -88,8 +91,9 @@
   "files": [
     "dist",
     "migrations",
-    "config.d.ts"
+    "config.d.ts",
+    "assets"
   ],
   "configSchema": "config.d.ts",
-  "gitHead": "3db0cb3683d3000666802af90a465ba4fb0d1e8d"
+  "gitHead": "a05e7081b805006e3f0b2960a08a7753357f532f"
 }