@owox/backend 0.37.0 → 0.39.0

package/dist/src/plugin-host/dto/presentation/publication-api.dto.js

@@ -9,7 +9,7 @@ var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.UpdatePluginByRepositoryApiDto = exports.PublicationResponseApiDto = exports.PluginPublisherDiagnosticsApiDto = exports.ReleaseRejectionApiDto = exports.PublishPluginApiDto = void 0;
+exports.PluginReleaseCheckResultApiDto = exports.PluginReleaseCheckIssueApiDto = exports.CheckPluginReleaseApiDto = exports.UpdatePluginByRepositoryApiDto = exports.PublicationResponseApiDto = exports.PluginPublisherDiagnosticsApiDto = exports.ReleaseRejectionApiDto = exports.PublishPluginApiDto = void 0;
 const swagger_1 = require("@nestjs/swagger");
 const class_validator_1 = require("class-validator");
 const github_access_mode_enum_1 = require("../../enums/github-access-mode.enum");
@@ -191,4 +191,98 @@ __decorate([
     (0, class_validator_1.MaxLength)(512),
     __metadata("design:type", String)
 ], UpdatePluginByRepositoryApiDto.prototype, "repository", void 0);
+class CheckPluginReleaseApiDto extends UpdatePluginByRepositoryApiDto {
+    ref;
+    version;
+}
+exports.CheckPluginReleaseApiDto = CheckPluginReleaseApiDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Branch, tag, or commit SHA to check.', example: 'main' }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(1),
+    (0, class_validator_1.MaxLength)(255),
+    (0, class_validator_1.Matches)(/^[^\s\p{Cc}\p{Cs}]+$/u, {
+        message: 'ref must not contain whitespace or control characters',
+    }),
+    __metadata("design:type", String)
+], CheckPluginReleaseApiDto.prototype, "ref", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Version the release would carry, X.Y.Z optionally prefixed with v. Defaults to the next version after the current one: the next patch below 1.0.0, the next minor from 1.0.0.',
+        example: '1.5.0',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(1),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], CheckPluginReleaseApiDto.prototype, "version", void 0);
+class PluginReleaseCheckIssueApiDto {
+    code;
+    detail;
+}
+exports.PluginReleaseCheckIssueApiDto = PluginReleaseCheckIssueApiDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ enum: release_rejection_code_enum_1.ReleaseRejectionCode }),
+    __metadata("design:type", String)
+], PluginReleaseCheckIssueApiDto.prototype, "code", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)(),
+    __metadata("design:type", String)
+], PluginReleaseCheckIssueApiDto.prototype, "detail", void 0);
+class PluginReleaseCheckResultApiDto {
+    pluginId;
+    repository;
+    commitSha;
+    candidateVersion;
+    baselineVersion;
+    collectionsEvaluated;
+    issues;
+}
+exports.PluginReleaseCheckResultApiDto = PluginReleaseCheckResultApiDto;
+__decorate([
+    (0, swagger_1.ApiProperty)(),
+    __metadata("design:type", String)
+], PluginReleaseCheckResultApiDto.prototype, "pluginId", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Canonical owner/name.' }),
+    __metadata("design:type", String)
+], PluginReleaseCheckResultApiDto.prototype, "repository", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        type: String,
+        nullable: true,
+        description: 'Null when the ref does not resolve.',
+    }),
+    __metadata("design:type", Object)
+], PluginReleaseCheckResultApiDto.prototype, "commitSha", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        type: String,
+        nullable: true,
+        description: 'Without the v prefix. Null when no version was given and none is current.',
+    }),
+    __metadata("design:type", Object)
+], PluginReleaseCheckResultApiDto.prototype, "candidateVersion", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        type: String,
+        nullable: true,
+        description: "Highest recorded version in the candidate's compatibility line. Null when there is none or the ref does not resolve; set with collectionsEvaluated false when the manifest is invalid.",
+    }),
+    __metadata("design:type", Object)
+], PluginReleaseCheckResultApiDto.prototype, "baselineVersion", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Whether collections were compared against the baseline.',
+    }),
+    __metadata("design:type", Boolean)
+], PluginReleaseCheckResultApiDto.prototype, "collectionsEvaluated", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        type: [PluginReleaseCheckIssueApiDto],
+        description: 'Reasons a release from this ref would be rejected; an invalid manifest or an unresolvable ref stops evaluation.',
+    }),
+    __metadata("design:type", Array)
+], PluginReleaseCheckResultApiDto.prototype, "issues", void 0);
 //# sourceMappingURL=publication-api.dto.js.map

package/dist/src/plugin-host/entities/plugin-action-execution.entity.d.ts

@@ -0,0 +1,24 @@
+import { PluginActionExecutionStatus, type PluginActionTrigger } from '../enums/plugin-action-execution-status.enum';
+export declare class PluginActionExecution {
+    id: string;
+    pluginId: string;
+    pluginVersionId: string;
+    installationId: string;
+    projectId: string;
+    userId: string;
+    action: string;
+    input: unknown;
+    trigger: PluginActionTrigger;
+    status: PluginActionExecutionStatus;
+    role: string;
+    tokenHash: string | null;
+    deadlineAt: Date | null;
+    createdAt: Date;
+    startedAt: Date | null;
+    finishedAt: Date | null;
+    errorCode: string | null;
+    errorMessage: string | null;
+    result: unknown;
+    payloadsClearedAt: Date | null;
+    payloadBytes: number;
+}

package/dist/src/plugin-host/entities/plugin-action-execution.entity.js

@@ -0,0 +1,136 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PluginActionExecution = void 0;
+const typeorm_1 = require("typeorm");
+const plugin_action_execution_status_enum_1 = require("../enums/plugin-action-execution-status.enum");
+const JSON_TEXT = {
+    to: (value) => (value === undefined || value === null ? value : JSON.stringify(value)),
+    from: (text) => text === null || text === undefined ? null : JSON.parse(String(text)),
+};
+let PluginActionExecution = class PluginActionExecution {
+    id;
+    pluginId;
+    pluginVersionId;
+    installationId;
+    projectId;
+    userId;
+    action;
+    input;
+    trigger;
+    status;
+    role;
+    tokenHash;
+    deadlineAt;
+    createdAt;
+    startedAt;
+    finishedAt;
+    errorCode;
+    errorMessage;
+    result;
+    payloadsClearedAt;
+    payloadBytes;
+};
+exports.PluginActionExecution = PluginActionExecution;
+__decorate([
+    (0, typeorm_1.PrimaryGeneratedColumn)('uuid'),
+    __metadata("design:type", String)
+], PluginActionExecution.prototype, "id", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 36 }),
+    __metadata("design:type", String)
+], PluginActionExecution.prototype, "pluginId", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 36 }),
+    __metadata("design:type", String)
+], PluginActionExecution.prototype, "pluginVersionId", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 36 }),
+    __metadata("design:type", String)
+], PluginActionExecution.prototype, "installationId", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 255 }),
+    __metadata("design:type", String)
+], PluginActionExecution.prototype, "projectId", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 255 }),
+    __metadata("design:type", String)
+], PluginActionExecution.prototype, "userId", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 64 }),
+    __metadata("design:type", String)
+], PluginActionExecution.prototype, "action", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'text', nullable: true, transformer: JSON_TEXT }),
+    __metadata("design:type", Object)
+], PluginActionExecution.prototype, "input", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 16 }),
+    __metadata("design:type", String)
+], PluginActionExecution.prototype, "trigger", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 16 }),
+    __metadata("design:type", String)
+], PluginActionExecution.prototype, "status", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 16 }),
+    __metadata("design:type", String)
+], PluginActionExecution.prototype, "role", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 64, nullable: true }),
+    __metadata("design:type", Object)
+], PluginActionExecution.prototype, "tokenHash", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'datetime', nullable: true }),
+    __metadata("design:type", Object)
+], PluginActionExecution.prototype, "deadlineAt", void 0);
+__decorate([
+    (0, typeorm_1.CreateDateColumn)(),
+    __metadata("design:type", Date)
+], PluginActionExecution.prototype, "createdAt", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'datetime', nullable: true }),
+    __metadata("design:type", Object)
+], PluginActionExecution.prototype, "startedAt", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'datetime', nullable: true }),
+    __metadata("design:type", Object)
+], PluginActionExecution.prototype, "finishedAt", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 64, nullable: true }),
+    __metadata("design:type", Object)
+], PluginActionExecution.prototype, "errorCode", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 1000, nullable: true }),
+    __metadata("design:type", Object)
+], PluginActionExecution.prototype, "errorMessage", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'text', nullable: true, transformer: JSON_TEXT }),
+    __metadata("design:type", Object)
+], PluginActionExecution.prototype, "result", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'datetime', nullable: true }),
+    __metadata("design:type", Object)
+], PluginActionExecution.prototype, "payloadsClearedAt", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'int', default: 0 }),
+    __metadata("design:type", Number)
+], PluginActionExecution.prototype, "payloadBytes", void 0);
+exports.PluginActionExecution = PluginActionExecution = __decorate([
+    (0, typeorm_1.Entity)('plugin_action_execution'),
+    (0, typeorm_1.Index)('UQ_plugin_action_execution_token', ['tokenHash'], { unique: true }),
+    (0, typeorm_1.Index)('idx_plugin_action_execution_running', ['installationId', 'status']),
+    (0, typeorm_1.Index)('idx_plugin_action_execution_deadline', ['status', 'deadlineAt']),
+    (0, typeorm_1.Index)('idx_plugin_action_execution_starts', ['installationId', 'startedAt', 'payloadBytes']),
+    (0, typeorm_1.Index)('idx_plugin_action_execution_finished', ['finishedAt']),
+    (0, typeorm_1.Index)('idx_plugin_action_execution_payloads', ['payloadsClearedAt', 'finishedAt'])
+], PluginActionExecution);
+//# sourceMappingURL=plugin-action-execution.entity.js.map

package/dist/src/plugin-host/entities/plugin-version.entity.d.ts

@@ -1,4 +1,4 @@
-import type { PluginCollectionDeclaration } from '../utils/plugin-manifest.util';
+import type { PluginBackendDeclaration, PluginCollectionDeclaration } from '../utils/plugin-manifest.util';
 import type { StoredCredentialRequirement } from '../../data-marts/credentials/credential.types';
 export declare class PluginVersion {
     id: string;
@@ -13,6 +13,7 @@ export declare class PluginVersion {
     deliveryUrl: string;
     collections: PluginCollectionDeclaration[] | null;
     credentialRequirements: StoredCredentialRequirement[] | null;
+    backend: PluginBackendDeclaration | null;
     releasePublishedAt: Date | null;
     createdAt: Date;
 }

package/dist/src/plugin-host/entities/plugin-version.entity.js

@@ -24,6 +24,7 @@ let PluginVersion = class PluginVersion {
     deliveryUrl;
     collections;
     credentialRequirements;
+    backend;
     releasePublishedAt;
     createdAt;
 };
@@ -76,6 +77,10 @@ __decorate([
     (0, typeorm_1.Column)({ type: 'json', nullable: true }),
     __metadata("design:type", Object)
 ], PluginVersion.prototype, "credentialRequirements", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'json', nullable: true }),
+    __metadata("design:type", Object)
+], PluginVersion.prototype, "backend", void 0);
 __decorate([
     (0, typeorm_1.Column)({ type: 'datetime', nullable: true }),
     __metadata("design:type", Object)

package/dist/src/plugin-host/enums/plugin-action-execution-status.enum.d.ts

@@ -0,0 +1,9 @@
+export declare enum PluginActionExecutionStatus {
+    RUNNING = "RUNNING",
+    SUCCEEDED = "SUCCEEDED",
+    FAILED = "FAILED",
+    CANCELLED = "CANCELLED",
+    TIMED_OUT = "TIMED_OUT"
+}
+export type PluginActionTrigger = 'frontend';
+export declare function isFinalPluginActionStatus(status: string): boolean;

package/dist/src/plugin-host/enums/plugin-action-execution-status.enum.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PluginActionExecutionStatus = void 0;
+exports.isFinalPluginActionStatus = isFinalPluginActionStatus;
+var PluginActionExecutionStatus;
+(function (PluginActionExecutionStatus) {
+    PluginActionExecutionStatus["RUNNING"] = "RUNNING";
+    PluginActionExecutionStatus["SUCCEEDED"] = "SUCCEEDED";
+    PluginActionExecutionStatus["FAILED"] = "FAILED";
+    PluginActionExecutionStatus["CANCELLED"] = "CANCELLED";
+    PluginActionExecutionStatus["TIMED_OUT"] = "TIMED_OUT";
+})(PluginActionExecutionStatus || (exports.PluginActionExecutionStatus = PluginActionExecutionStatus = {}));
+const FINAL_STATUSES = new Set([
+    PluginActionExecutionStatus.SUCCEEDED,
+    PluginActionExecutionStatus.FAILED,
+    PluginActionExecutionStatus.CANCELLED,
+    PluginActionExecutionStatus.TIMED_OUT,
+]);
+function isFinalPluginActionStatus(status) {
+    return FINAL_STATUSES.has(status);
+}
+//# sourceMappingURL=plugin-action-execution-status.enum.js.map

package/dist/src/plugin-host/enums/release-rejection-code.enum.d.ts

@@ -9,6 +9,9 @@ export declare enum ReleaseRejectionCode {
     MANIFEST_INVALID_JSON = "MANIFEST_INVALID_JSON",
     MANIFEST_SCHEMA = "MANIFEST_SCHEMA",
     COLLECTIONS_INCOMPATIBLE = "COLLECTIONS_INCOMPATIBLE",
+    ACTION_INPUT_UNSUPPORTED = "ACTION_INPUT_UNSUPPORTED",
+    ACTIONS_INCOMPATIBLE = "ACTIONS_INCOMPATIBLE",
+    BACKEND_ORIGIN_CHANGED = "BACKEND_ORIGIN_CHANGED",
     DELIVERY_UNSUPPORTED = "DELIVERY_UNSUPPORTED",
     URL_NOT_HTTPS = "URL_NOT_HTTPS",
     URL_PRIVATE_NETWORK = "URL_PRIVATE_NETWORK",

package/dist/src/plugin-host/enums/release-rejection-code.enum.js

@@ -13,6 +13,9 @@ var ReleaseRejectionCode;
     ReleaseRejectionCode["MANIFEST_INVALID_JSON"] = "MANIFEST_INVALID_JSON";
     ReleaseRejectionCode["MANIFEST_SCHEMA"] = "MANIFEST_SCHEMA";
     ReleaseRejectionCode["COLLECTIONS_INCOMPATIBLE"] = "COLLECTIONS_INCOMPATIBLE";
+    ReleaseRejectionCode["ACTION_INPUT_UNSUPPORTED"] = "ACTION_INPUT_UNSUPPORTED";
+    ReleaseRejectionCode["ACTIONS_INCOMPATIBLE"] = "ACTIONS_INCOMPATIBLE";
+    ReleaseRejectionCode["BACKEND_ORIGIN_CHANGED"] = "BACKEND_ORIGIN_CHANGED";
     ReleaseRejectionCode["DELIVERY_UNSUPPORTED"] = "DELIVERY_UNSUPPORTED";
     ReleaseRejectionCode["URL_NOT_HTTPS"] = "URL_NOT_HTTPS";
     ReleaseRejectionCode["URL_PRIVATE_NETWORK"] = "URL_PRIVATE_NETWORK";
@@ -31,6 +34,9 @@ const REJECTION_IS_PUBLISHER_ACTIONABLE = {
     [ReleaseRejectionCode.MANIFEST_INVALID_JSON]: true,
     [ReleaseRejectionCode.MANIFEST_SCHEMA]: true,
     [ReleaseRejectionCode.COLLECTIONS_INCOMPATIBLE]: true,
+    [ReleaseRejectionCode.ACTION_INPUT_UNSUPPORTED]: true,
+    [ReleaseRejectionCode.ACTIONS_INCOMPATIBLE]: true,
+    [ReleaseRejectionCode.BACKEND_ORIGIN_CHANGED]: true,
     [ReleaseRejectionCode.DELIVERY_UNSUPPORTED]: true,
     [ReleaseRejectionCode.URL_NOT_HTTPS]: true,
     [ReleaseRejectionCode.URL_PRIVATE_NETWORK]: true,

package/dist/src/plugin-host/errors/plugin-action.errors.d.ts

@@ -0,0 +1,45 @@
+import { HttpStatus } from '@nestjs/common';
+import { PluginHostError } from './plugin-host.errors';
+export interface ActionInputError {
+    readonly instancePath: string;
+    readonly message: string;
+}
+export declare class ActionNotDeclaredError extends PluginHostError {
+    readonly memberVisible = true;
+    readonly httpStatus = HttpStatus.NOT_FOUND;
+    constructor(action: string);
+}
+export declare class ActionInputTooLargeError extends PluginHostError {
+    readonly memberVisible = true;
+    readonly httpStatus = HttpStatus.PAYLOAD_TOO_LARGE;
+    constructor();
+}
+export declare class ActionInputInvalidError extends PluginHostError {
+    readonly memberVisible = true;
+    constructor(errors: readonly ActionInputError[]);
+}
+export declare class TooManyExecutionsError extends PluginHostError {
+    readonly memberVisible = true;
+    readonly httpStatus = HttpStatus.TOO_MANY_REQUESTS;
+    constructor(message?: string);
+}
+export declare class ExecutionTokenNotAllowedError extends PluginHostError {
+    readonly memberVisible = true;
+    readonly httpStatus = HttpStatus.FORBIDDEN;
+    constructor(message?: string);
+}
+export declare class ExecutionTokenRequiredError extends PluginHostError {
+    readonly memberVisible = true;
+    readonly httpStatus = HttpStatus.FORBIDDEN;
+    constructor();
+}
+export declare class ExecutionNotFoundError extends PluginHostError {
+    readonly memberVisible = true;
+    readonly httpStatus = HttpStatus.NOT_FOUND;
+    constructor();
+}
+export declare class InstallationInactiveError extends PluginHostError {
+    readonly memberVisible = true;
+    readonly httpStatus = HttpStatus.FORBIDDEN;
+    constructor();
+}

package/dist/src/plugin-host/errors/plugin-action.errors.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InstallationInactiveError = exports.ExecutionNotFoundError = exports.ExecutionTokenRequiredError = exports.ExecutionTokenNotAllowedError = exports.TooManyExecutionsError = exports.ActionInputInvalidError = exports.ActionInputTooLargeError = exports.ActionNotDeclaredError = void 0;
+const common_1 = require("@nestjs/common");
+const plugin_action_limits_1 = require("../constants/plugin-action-limits");
+const plugin_host_errors_1 = require("./plugin-host.errors");
+class ActionNotDeclaredError extends plugin_host_errors_1.PluginHostError {
+    memberVisible = true;
+    httpStatus = common_1.HttpStatus.NOT_FOUND;
+    constructor(action) {
+        super('ACTION_NOT_DECLARED', `Action "${action}" is not declared in the current version of this plugin`);
+    }
+}
+exports.ActionNotDeclaredError = ActionNotDeclaredError;
+class ActionInputTooLargeError extends plugin_host_errors_1.PluginHostError {
+    memberVisible = true;
+    httpStatus = common_1.HttpStatus.PAYLOAD_TOO_LARGE;
+    constructor() {
+        super('INPUT_TOO_LARGE', `Action input is larger than ${plugin_action_limits_1.PLUGIN_ACTION_LIMITS.maxInputBytes / 1024} KiB`);
+    }
+}
+exports.ActionInputTooLargeError = ActionInputTooLargeError;
+class ActionInputInvalidError extends plugin_host_errors_1.PluginHostError {
+    memberVisible = true;
+    constructor(errors) {
+        super('INVALID_INPUT', 'Action input does not match the action schema', { errors });
+    }
+}
+exports.ActionInputInvalidError = ActionInputInvalidError;
+class TooManyExecutionsError extends plugin_host_errors_1.PluginHostError {
+    memberVisible = true;
+    httpStatus = common_1.HttpStatus.TOO_MANY_REQUESTS;
+    constructor(message = `This installation already has ${plugin_action_limits_1.PLUGIN_ACTION_LIMITS.maxRunningPerInstallation} running executions`) {
+        super('TOO_MANY_EXECUTIONS', message);
+    }
+}
+exports.TooManyExecutionsError = TooManyExecutionsError;
+class ExecutionTokenNotAllowedError extends plugin_host_errors_1.PluginHostError {
+    memberVisible = true;
+    httpStatus = common_1.HttpStatus.FORBIDDEN;
+    constructor(message = 'A backend action cannot start another action') {
+        super('EXECUTION_TOKEN_NOT_ALLOWED', message);
+    }
+}
+exports.ExecutionTokenNotAllowedError = ExecutionTokenNotAllowedError;
+class ExecutionTokenRequiredError extends plugin_host_errors_1.PluginHostError {
+    memberVisible = true;
+    httpStatus = common_1.HttpStatus.FORBIDDEN;
+    constructor() {
+        super('EXECUTION_TOKEN_REQUIRED', 'Only a backend action can read its own execution');
+    }
+}
+exports.ExecutionTokenRequiredError = ExecutionTokenRequiredError;
+class ExecutionNotFoundError extends plugin_host_errors_1.PluginHostError {
+    memberVisible = true;
+    httpStatus = common_1.HttpStatus.NOT_FOUND;
+    constructor() {
+        super('EXECUTION_NOT_FOUND', 'Execution was not found');
+    }
+}
+exports.ExecutionNotFoundError = ExecutionNotFoundError;
+class InstallationInactiveError extends plugin_host_errors_1.PluginHostError {
+    memberVisible = true;
+    httpStatus = common_1.HttpStatus.FORBIDDEN;
+    constructor() {
+        super('INSTALLATION_INACTIVE', 'The plugin installation is no longer active');
+    }
+}
+exports.InstallationInactiveError = InstallationInactiveError;
+//# sourceMappingURL=plugin-action.errors.js.map

package/dist/src/plugin-host/errors/plugin-host.errors.d.ts

@@ -1,6 +1,8 @@
+import { HttpStatus } from '@nestjs/common';
 import { BusinessViolationException } from '../../common/exceptions/business-violation.exception';
 export declare abstract class PluginHostError extends BusinessViolationException {
     abstract readonly memberVisible: boolean;
+    readonly httpStatus: HttpStatus;
     protected constructor(code: string, message: string, errorDetails?: Record<string, unknown>);
 }
 export declare class InvalidRepoLocatorError extends PluginHostError {
@@ -31,6 +33,10 @@ export declare class PluginSyncRateLimitedError extends PluginHostError {
     readonly memberVisible = true;
     constructor(retryAfterSeconds: number);
 }
+export declare class PluginCheckRateLimitedError extends PluginHostError {
+    readonly memberVisible = true;
+    constructor(retryAfterSeconds: number);
+}
 export declare class PluginSyncInProgressError extends PluginHostError {
     readonly memberVisible = true;
     constructor();

package/dist/src/plugin-host/errors/plugin-host.errors.js

@@ -1,8 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PluginVersionConflictError = exports.NoEligiblePluginVersionError = exports.PluginNotPublishedError = exports.StaleVersionConfirmationError = exports.PluginSuspendedError = exports.AudienceFormConflictError = exports.PublicationAuthorizationError = exports.PluginSyncLeaseLostError = exports.PluginSyncInProgressError = exports.PluginSyncRateLimitedError = exports.GithubApiError = exports.GithubRateLimitedError = exports.GithubAuthConfigError = exports.GithubRepoNotAccessibleError = exports.GithubRepoNotFoundError = exports.InvalidRepoLocatorError = exports.PluginHostError = void 0;
+exports.PluginVersionConflictError = exports.NoEligiblePluginVersionError = exports.PluginNotPublishedError = exports.StaleVersionConfirmationError = exports.PluginSuspendedError = exports.AudienceFormConflictError = exports.PublicationAuthorizationError = exports.PluginSyncLeaseLostError = exports.PluginSyncInProgressError = exports.PluginCheckRateLimitedError = exports.PluginSyncRateLimitedError = exports.GithubApiError = exports.GithubRateLimitedError = exports.GithubAuthConfigError = exports.GithubRepoNotAccessibleError = exports.GithubRepoNotFoundError = exports.InvalidRepoLocatorError = exports.PluginHostError = void 0;
+const common_1 = require("@nestjs/common");
 const business_violation_exception_1 = require("../../common/exceptions/business-violation.exception");
 class PluginHostError extends business_violation_exception_1.BusinessViolationException {
+    httpStatus = common_1.HttpStatus.BAD_REQUEST;
     constructor(code, message, errorDetails) {
         super(message, errorDetails, code);
     }
@@ -63,6 +65,13 @@ class PluginSyncRateLimitedError extends PluginHostError {
     }
 }
 exports.PluginSyncRateLimitedError = PluginSyncRateLimitedError;
+class PluginCheckRateLimitedError extends PluginHostError {
+    memberVisible = true;
+    constructor(retryAfterSeconds) {
+        super('PLUGIN_CHECK_RATE_LIMITED', `This plugin was checked very recently. Try again in ${retryAfterSeconds} seconds.`, { retryAfterSeconds });
+    }
+}
+exports.PluginCheckRateLimitedError = PluginCheckRateLimitedError;
 class PluginSyncInProgressError extends PluginHostError {
     memberVisible = true;
     constructor() {

package/dist/src/plugin-host/filters/plugin-host-exception.filter.js

@@ -19,8 +19,8 @@ let PluginHostExceptionFilter = PluginHostExceptionFilter_1 = class PluginHostEx
         if (!exception.memberVisible) {
             this.logger.warn(`Withheld ${exception.code} detail from a member-facing response: ${exception.message}`, exception.errorDetails);
         }
-        response.status(common_1.HttpStatus.BAD_REQUEST).json({
-            statusCode: common_1.HttpStatus.BAD_REQUEST,
+        response.status(exception.httpStatus).json({
+            statusCode: exception.httpStatus,
             timestamp: new Date().toISOString(),
             path: request.url,
             code: exception.code,

package/dist/src/plugin-host/mappers/plugin-action-execution.mapper.d.ts

@@ -0,0 +1,3 @@
+import type { PluginActionExecutionView } from '../dto/domain/plugin-action-execution.dto';
+import type { PluginActionExecutionSummary } from '../services/plugin-action-execution.service';
+export declare function toPluginActionExecutionView(execution: PluginActionExecutionSummary): PluginActionExecutionView;

package/dist/src/plugin-host/mappers/plugin-action-execution.mapper.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toPluginActionExecutionView = toPluginActionExecutionView;
+const plugin_action_execution_status_enum_1 = require("../enums/plugin-action-execution-status.enum");
+function toPluginActionExecutionView(execution) {
+    const failed = (0, plugin_action_execution_status_enum_1.isFinalPluginActionStatus)(execution.status) &&
+        execution.status !== plugin_action_execution_status_enum_1.PluginActionExecutionStatus.SUCCEEDED;
+    return {
+        id: execution.id,
+        action: execution.action,
+        status: execution.status,
+        trigger: execution.trigger,
+        startedAt: execution.startedAt,
+        deadlineAt: execution.deadlineAt,
+        finishedAt: execution.finishedAt,
+        result: execution.status === plugin_action_execution_status_enum_1.PluginActionExecutionStatus.SUCCEEDED ? execution.result : null,
+        error: failed
+            ? { code: execution.errorCode ?? execution.status, message: execution.errorMessage ?? '' }
+            : null,
+    };
+}
+//# sourceMappingURL=plugin-action-execution.mapper.js.map

package/dist/src/plugin-host/mappers/plugin-presentation.mapper.d.ts

@@ -1,8 +1,15 @@
 import type { AuthorizationContext } from '../../idp';
+import { CheckPluginReleaseCommand, PluginReleaseCheckResultDto } from '../dto/domain/check-plugin-release.command';
+import type { PluginHistoryPageDto, PluginHistoryPluginDto } from '../dto/domain/plugin-history.dto';
+import { ListPluginHistoryCommand } from '../dto/domain/list-plugin-history.command';
+import { ListPluginHistoryQueryApiDto, PluginHistoryPageApiDto } from '../dto/presentation/plugin-history-api.dto';
+import { FindPluginByRepositoryCommand } from '../dto/domain/find-plugin-by-repository.command';
 import { GetPluginDetailsCommand } from '../dto/domain/get-plugin-details.command';
 import { GetPluginGalleryCommand } from '../dto/domain/get-plugin-gallery.command';
 import { GetPluginInstallationEntryCommand } from '../dto/domain/get-plugin-installation-entry.command';
 import { InstallPluginCommand } from '../dto/domain/install-plugin.command';
+import type { PluginActionExecutionView, PluginActionWorkerContext, StartedPluginActionExecution } from '../dto/domain/plugin-action-execution.dto';
+import { PluginActionExecutionApiDto, PluginActionWorkerContextApiDto, StartedPluginActionExecutionApiDto } from '../dto/presentation/plugin-action-api.dto';
 import { ListInstallationsCommand } from '../dto/domain/list-installations.command';
 import { ListPublicationsCommand } from '../dto/domain/list-publications.command';
 import { InstalledPluginDto, PluginInstallationDto, PluginInstallationEntryDto } from '../dto/domain/plugin-installation.dto';
@@ -14,8 +21,9 @@ import { UninstallPluginCommand } from '../dto/domain/uninstall-plugin.command';
 import { PluginUpdateResultDto, UpdatePluginCommand } from '../dto/domain/update-plugin.command';
 import { InstalledPluginApiDto, InstallPluginApiDto, PluginEntryApiDto, PluginInstallationApiDto, PluginUpdateResultApiDto } from '../dto/presentation/plugin-installation-api.dto';
 import { PluginGalleryEntryApiDto } from '../dto/presentation/plugin-gallery-api.dto';
+import { PluginLookupApiDto } from '../dto/presentation/plugin-lookup-api.dto';
 import { PluginSuspensionResponseApiDto, SuspendPluginApiDto } from '../dto/presentation/plugin-suspension-api.dto';
-import { PluginPublisherDiagnosticsApiDto, PublicationResponseApiDto, PublishPluginApiDto, UpdatePluginByRepositoryApiDto } from '../dto/presentation/publication-api.dto';
+import { CheckPluginReleaseApiDto, PluginPublisherDiagnosticsApiDto, PluginReleaseCheckResultApiDto, PublicationResponseApiDto, PublishPluginApiDto, UpdatePluginByRepositoryApiDto } from '../dto/presentation/publication-api.dto';
 import { PluginVersion } from '../entities/plugin-version.entity';
 import { Plugin } from '../entities/plugin.entity';
 import { PluginPublicationScope } from '../enums/plugin-publication-scope.enum';
@@ -31,14 +39,22 @@ export declare class PluginPresentationMapper {
     toGetPluginGalleryCommand(context: AuthorizationContext): GetPluginGalleryCommand;
     toGetPluginDetailsCommand(pluginId: string, context: AuthorizationContext): GetPluginDetailsCommand;
     toListInstallationsCommand(context: AuthorizationContext, includeUninstalled: boolean): ListInstallationsCommand;
+    toListPluginHistoryCommand(context: AuthorizationContext, query: ListPluginHistoryQueryApiDto): ListPluginHistoryCommand;
+    toPluginHistoryResponse(page: PluginHistoryPageDto): PluginHistoryPageApiDto;
+    toFindPluginByRepositoryCommand(repository: string, context: AuthorizationContext): FindPluginByRepositoryCommand;
     toGetPluginInstallationEntryCommand(installationId: string, context: AuthorizationContext): GetPluginInstallationEntryCommand;
     toInstallCommand(pluginId: string, context: AuthorizationContext, dto: InstallPluginApiDto): InstallPluginCommand;
     toUpdateCommand(pluginId: string, context: AuthorizationContext): UpdatePluginCommand;
     toUpdateByRepositoryCommand(context: AuthorizationContext, dto: UpdatePluginByRepositoryApiDto): UpdatePluginCommand;
+    toCheckReleaseCommand(context: AuthorizationContext, dto: CheckPluginReleaseApiDto): CheckPluginReleaseCommand;
     toUninstallCommand(pluginId: string, context: AuthorizationContext): UninstallPluginCommand;
     toSuspendCommand(context: AuthorizationContext, dto: SuspendPluginApiDto): SuspendPluginCommand;
     toResumeCommand(context: AuthorizationContext, dto: SuspendPluginApiDto): ResumePluginCommand;
     toMemberDto(plugin: Plugin, version: PluginVersion | null, context: PluginViewContext): PluginGalleryEntryDto;
+    toHistoryPlugin(plugin: Plugin, version: PluginVersion | null): PluginHistoryPluginDto;
+    toLookupResponse(result: {
+        pluginId: string;
+    }): PluginLookupApiDto;
     toGalleryEntryResponse(dto: PluginGalleryEntryDto): PluginGalleryEntryApiDto;
     toGalleryEntryResponseList(dtos: PluginGalleryEntryDto[]): PluginGalleryEntryApiDto[];
     toPublicationResponse(dto: PluginPublicationDto): PublicationResponseApiDto;
@@ -49,6 +65,11 @@ export declare class PluginPresentationMapper {
     toInstalledPluginResponseList(dtos: InstalledPluginDto[]): InstalledPluginApiDto[];
     toInstallationEntryResponse(dto: PluginInstallationEntryDto): PluginEntryApiDto;
     toUpdateResultResponse(dto: PluginUpdateResultDto): PluginUpdateResultApiDto;
+    toReleaseCheckResponse(dto: PluginReleaseCheckResultDto): PluginReleaseCheckResultApiDto;
     toSuspensionResponse(dto: PluginSuspensionDto): PluginSuspensionResponseApiDto;
+    toStartedActionExecutionResponse(dto: StartedPluginActionExecution): StartedPluginActionExecutionApiDto;
+    toActionExecutionResponse(dto: PluginActionExecutionView): PluginActionExecutionApiDto;
+    toActionWorkerContextResponse(dto: PluginActionWorkerContext): PluginActionWorkerContextApiDto;
+    private displayNameOf;
     private toSource;
 }