@jumoo/processing 18.2.0 → 19.0.0-beta01

package/dist/pipeline/components/pipeline-table.element.js

@@ -60,7 +60,7 @@ let JumooPipelinesTableElement = class JumooPipelinesTableElement extends UmbLit
                     },
                     {
                         columnAlias: 'background',
-                        value: html `<umb-icon
+                        value: html `<umb-icon
 								.name=${when((pipeline.state.backgroundState?.isBackgroundRequest ?? false) == true, () => 'icon-check', () => 'icon-close')}></umb-icon>`,
                     },
                     {
@@ -77,35 +77,35 @@ let JumooPipelinesTableElement = class JumooPipelinesTableElement extends UmbLit
             };
         })
             .filter((item) => item !== undefined);
-        return html `
-			<umb-table
-				.config=${this._tableConfig}
-				.columns=${this.tableColumns}
-				.items=${items}
-				.filter=${this.filter}></umb-table>
+        return html `
+			<umb-table
+				.config=${this._tableConfig}
+				.columns=${this.tableColumns}
+				.items=${items}
+				.filter=${this.filter}></umb-table>
 		`;
     }
     renderActions(pipeline) {
         if (!pipeline.id)
             return nothing;
-        return html `<uui-button-group
-			><uui-button
-				.id=${pipeline.id}
-				label="View"
-				color="positive"
-				look="outline"
-				@click=${__classPrivateFieldGet(this, _JumooPipelinesTableElement_instances, "m", _JumooPipelinesTableElement_onViewPipeline)}
-				>View</uui-button
-			>
+        return html `<uui-button-group
+			><uui-button
+				.id=${pipeline.id}
+				label="View"
+				color="positive"
+				look="outline"
+				@click=${__classPrivateFieldGet(this, _JumooPipelinesTableElement_instances, "m", _JumooPipelinesTableElement_onViewPipeline)}
+				>View</uui-button
+			>
 			${this.hideDelete
             ? ''
-            : html `<uui-button
-							label="Delete"
-							color="danger"
-							look="outline"
-							@click=${() => __classPrivateFieldGet(this, _JumooPipelinesTableElement_instances, "m", _JumooPipelinesTableElement_onDeletePipeline).call(this, pipeline.id)}
-							>Delete</uui-button
-						>`}</uui-button-group
+            : html `<uui-button
+							label="Delete"
+							color="danger"
+							look="outline"
+							@click=${() => __classPrivateFieldGet(this, _JumooPipelinesTableElement_instances, "m", _JumooPipelinesTableElement_onDeletePipeline).call(this, pipeline.id)}
+							>Delete</uui-button
+						>`}</uui-button-group
 		>`;
     }
 };

package/dist/pipeline/index.d.ts

@@ -5,4 +5,5 @@ export * from './pipeline.element.js';
 export * from './pipeline.context.js';
 export * from './pipeline.repository.js';
 export * from './pipeline.source.js';
+export * from './pipeline-conflict.js';
 export * from './pipelines.context.js';

package/dist/pipeline/index.js

@@ -5,4 +5,5 @@ export * from './pipeline.element.js';
 export * from './pipeline.context.js';
 export * from './pipeline.repository.js';
 export * from './pipeline.source.js';
+export * from './pipeline-conflict.js';
 export * from './pipelines.context.js';

package/dist/pipeline/modal/errors/error-modal.element.js

@@ -39,7 +39,9 @@ let JumooProcessingErrorModal = class JumooProcessingErrorModal extends UmbModal
 						<div class="detail">${this.data?.error.action}</div>
 					</div>
 					<div class="more">
-						<div class="label"></div>
+						<div class="label">
+							<umb-localize key="jumooProcError_step"></umb-localize>
+						</div>
 						<div class="detail">
 							${this.data?.error.step}
 							${when(this.data?.error.subStep, () => html `(${this.data?.error.subStep})`)}

package/dist/pipeline/pipeline-conflict.d.ts

@@ -0,0 +1,31 @@
+import type { UmbControllerHost } from '@umbraco-cms/backoffice/controller-api';
+import type { PipelineRunStatus } from '../api';
+/**
+ * @description a pipeline that couldn't be created or resumed because another one holds its
+ * concurrency key (the server's 409 `PipelineConflictProblemDetails`).
+ */
+export interface PipelineConflict {
+    /** the pipeline holding the key */
+    runningPipelineId: string;
+    /** the key that is held */
+    concurrencyKey: string;
+    /** the server's message */
+    detail?: string | null;
+    /** the holder's status, when the current user can see it */
+    holder?: PipelineRunStatus;
+}
+/**
+ * @description reads the 409 "already running" body off an error, whether it is the raw
+ * problem details the generated client throws or the `UmbApiError` tryExecute wraps it in.
+ * @param error the error from a request.
+ * @returns the conflict, or undefined for any other error.
+ */
+export declare function getPipelineConflict(error: unknown): PipelineConflict | undefined;
+/**
+ * @description tryExecute, except a 409 "already running" comes back as the error without a
+ * notification, so the caller can show it inline. Every other error notifies as normal.
+ * @param host the host the request (and any notification) belongs to.
+ * @param promise the request.
+ * @returns the response, as tryExecute returns it.
+ */
+export declare function tryExecuteAllowingConflict<T>(host: UmbControllerHost, promise: Promise<T>): Promise<import("@umbraco-cms/backoffice/resources").UmbApiResponse<T>>;

package/dist/pipeline/pipeline-conflict.js

@@ -0,0 +1,42 @@
+import { tryExecute, UmbApiError } from '@umbraco-cms/backoffice/resources';
+/**
+ * @description reads the 409 "already running" body off an error, whether it is the raw
+ * problem details the generated client throws or the `UmbApiError` tryExecute wraps it in.
+ * @param error the error from a request.
+ * @returns the conflict, or undefined for any other error.
+ */
+export function getPipelineConflict(error) {
+    const body = UmbApiError.isUmbApiError(error) ? error.problemDetails : error;
+    if (!body || typeof body !== 'object')
+        return undefined;
+    const problem = body;
+    if (problem.status !== 409 || typeof problem.runningPipelineId !== 'string')
+        return undefined;
+    return {
+        runningPipelineId: problem.runningPipelineId,
+        concurrencyKey: typeof problem.concurrencyKey === 'string' ? problem.concurrencyKey : '',
+        detail: typeof problem.detail === 'string' ? problem.detail : undefined,
+    };
+}
+/**
+ * @description tryExecute, except a 409 "already running" comes back as the error without a
+ * notification, so the caller can show it inline. Every other error notifies as normal.
+ * @param host the host the request (and any notification) belongs to.
+ * @param promise the request.
+ * @returns the response, as tryExecute returns it.
+ */
+export async function tryExecuteAllowingConflict(host, promise) {
+    let conflict;
+    const response = await tryExecute(host, promise.catch((error) => {
+        if (!getPipelineConflict(error))
+            throw error;
+        conflict = error;
+        return undefined;
+    }));
+    if (!conflict)
+        return response;
+    const problem = conflict;
+    return {
+        error: new UmbApiError(problem.detail ?? problem.title ?? 'Conflict', 409, null, problem),
+    };
+}

package/dist/pipeline/pipeline.context.d.ts

@@ -1,7 +1,7 @@
 import { UmbControllerBase } from '@umbraco-cms/backoffice/class-api';
 import { UmbControllerHost } from '@umbraco-cms/backoffice/controller-api';
 import { UmbContextToken } from '@umbraco-cms/backoffice/context-api';
-import { PipelineState, ProcessingMessage, ProcessingOptions, ProcessingResults } from '@jumoo/processing';
+import { PipelineState, ProcessingMessage, ProcessingOptions, ProcessingResults, PipelineConflict } from '@jumoo/processing';
 /**
  * @description context for keeping pipeline status and progress as we do things.
  */
@@ -13,6 +13,11 @@ export declare class PipelineContext extends UmbControllerBase {
     readonly results: import("rxjs").Observable<ProcessingResults | undefined>;
     readonly message: import("rxjs").Observable<ProcessingMessage | undefined>;
     readonly backgroundState: import("rxjs").Observable<PipelineState | undefined>;
+    /**
+     * @description set when the pipeline couldn't be created or resumed because another one
+     * holds its concurrency key - "already running".
+     */
+    readonly conflict: import("rxjs").Observable<PipelineConflict | undefined>;
     constructor(host: UmbControllerHost);
     private isMessage;
     private isState;

package/dist/pipeline/pipeline.context.js

@@ -9,11 +9,14 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
-var _PipelineContext_instances, _PipelineContext_repository, _PipelineContext_hubContext, _PipelineContext_pipeline, _PipelineContext_state, _PipelineContext_options, _PipelineContext_results, _PipelineContext_message, _PipelineContext_backgroundState, _PipelineContext_clientId, _PipelineContext_hasConnectedBefore, _PipelineContext_onClientIdChanged, _PipelineContext_isInFlight, _PipelineContext_trigger, _PipelineContext_close, _PipelineContext_finalized, _PipelineContext_valid, _PipelineContext_pending;
+var _PipelineContext_instances, _PipelineContext_repository, _PipelineContext_hubContext, _PipelineContext_pipeline, _PipelineContext_state, _PipelineContext_options, _PipelineContext_results, _PipelineContext_message, _PipelineContext_backgroundState, _PipelineContext_conflict, _PipelineContext_clientId, _PipelineContext_hasConnectedBefore, _PipelineContext_onClientIdChanged, _PipelineContext_isInFlight, _PipelineContext_setConflict, _PipelineContext_retryAfterSignIn, _PipelineContext_waitForSignIn, _PipelineContext_trigger, _PipelineContext_close, _PipelineContext_finalized, _PipelineContext_valid, _PipelineContext_pending;
 import { UmbControllerBase } from '@umbraco-cms/backoffice/class-api';
 import { UmbContextToken } from '@umbraco-cms/backoffice/context-api';
 import { UmbBooleanState, UmbObjectState } from '@umbraco-cms/backoffice/observable-api';
-import { PipelineStatus, PipelineRepository, ProcessingSignalRContext, } from '@jumoo/processing';
+import { UMB_AUTH_CONTEXT } from '@umbraco-cms/backoffice/auth';
+import { UmbApiError } from '@umbraco-cms/backoffice/resources';
+import { filter, firstValueFrom } from '@umbraco-cms/backoffice/external/rxjs';
+import { PipelineStatus, PipelineRepository, ProcessingSignalRContext, getPipelineConflict, } from '@jumoo/processing';
 /**
  * @description context for keeping pipeline status and progress as we do things.
  */
@@ -35,6 +38,12 @@ export class PipelineContext extends UmbControllerBase {
         this.message = __classPrivateFieldGet(this, _PipelineContext_message, "f").asObservable();
         _PipelineContext_backgroundState.set(this, new UmbObjectState(undefined));
         this.backgroundState = __classPrivateFieldGet(this, _PipelineContext_backgroundState, "f").asObservable();
+        _PipelineContext_conflict.set(this, new UmbObjectState(undefined));
+        /**
+         * @description set when the pipeline couldn't be created or resumed because another one
+         * holds its concurrency key - "already running".
+         */
+        this.conflict = __classPrivateFieldGet(this, _PipelineContext_conflict, "f").asObservable();
         // tracks the SignalR connection id ourselves, alongside the hub context's own clientId
         // observable, so #onClientIdChanged can tell "first connect" (nothing to reattach - there's
         // no prior, now-dead connection) apart from "changed after already having one" (a genuine
@@ -59,8 +68,7 @@ export class PipelineContext extends UmbControllerBase {
         __classPrivateFieldSet(this, _PipelineContext_repository, new PipelineRepository(this), "f");
         this.provideContext(JUMOO_PROCESSING_CONTEXT, this);
         __classPrivateFieldSet(this, _PipelineContext_hubContext, new ProcessingSignalRContext(this), "f");
-        const token = '[redacted]';
-        __classPrivateFieldGet(this, _PipelineContext_hubContext, "f").startHub(token, ['message', 'state']);
+        __classPrivateFieldGet(this, _PipelineContext_hubContext, "f").startHub(['message', 'state']);
         this.observe(__classPrivateFieldGet(this, _PipelineContext_hubContext, "f").messagesOf('message'), (message) => {
             if (!message?.message)
                 return;
@@ -86,8 +94,13 @@ export class PipelineContext extends UmbControllerBase {
         return message !== undefined;
     }
     async createPipeline(processor, strategy, options) {
-        const pipeline = await __classPrivateFieldGet(this, _PipelineContext_repository, "f").create(processor, strategy, options);
-        __classPrivateFieldGet(this, _PipelineContext_pipeline, "f").setValue(pipeline);
+        __classPrivateFieldGet(this, _PipelineContext_conflict, "f").setValue(undefined);
+        const { data, error } = await __classPrivateFieldGet(this, _PipelineContext_instances, "m", _PipelineContext_retryAfterSignIn).call(this, () => __classPrivateFieldGet(this, _PipelineContext_repository, "f").tryCreate(processor, strategy, options));
+        if (error) {
+            await __classPrivateFieldGet(this, _PipelineContext_instances, "m", _PipelineContext_setConflict).call(this, error);
+            return;
+        }
+        __classPrivateFieldGet(this, _PipelineContext_pipeline, "f").setValue(data);
     }
     async loadPipeline(id) {
         const pipeline = await __classPrivateFieldGet(this, _PipelineContext_repository, "f").Get(id);
@@ -112,8 +125,14 @@ export class PipelineContext extends UmbControllerBase {
     async process() {
         if (!__classPrivateFieldGet(this, _PipelineContext_pipeline, "f").value)
             return;
-        const clientId = __classPrivateFieldGet(this, _PipelineContext_hubContext, "f")?.getClientId() ?? null;
-        const response = await __classPrivateFieldGet(this, _PipelineContext_repository, "f").process(__classPrivateFieldGet(this, _PipelineContext_pipeline, "f").value, clientId);
+        const pipelineId = __classPrivateFieldGet(this, _PipelineContext_pipeline, "f").value;
+        const { data: response, error } = await __classPrivateFieldGet(this, _PipelineContext_instances, "m", _PipelineContext_retryAfterSignIn).call(this, () => 
+        // the connection id is read each time: the hub can reconnect while the user signs in.
+        __classPrivateFieldGet(this, _PipelineContext_repository, "f").tryProcess(pipelineId, __classPrivateFieldGet(this, _PipelineContext_hubContext, "f")?.getClientId() ?? null));
+        if (error) {
+            await __classPrivateFieldGet(this, _PipelineContext_instances, "m", _PipelineContext_setConflict).call(this, error);
+            return undefined;
+        }
         if (response?.state) {
             __classPrivateFieldGet(this, _PipelineContext_state, "f").setValue(response.state);
         }
@@ -128,7 +147,10 @@ export class PipelineContext extends UmbControllerBase {
     async updateOptions(options) {
         if (!__classPrivateFieldGet(this, _PipelineContext_pipeline, "f").value)
             return;
-        const response = await __classPrivateFieldGet(this, _PipelineContext_repository, "f").update(__classPrivateFieldGet(this, _PipelineContext_pipeline, "f").value, options);
+        const pipelineId = __classPrivateFieldGet(this, _PipelineContext_pipeline, "f").value;
+        const { data: response, error } = await __classPrivateFieldGet(this, _PipelineContext_instances, "m", _PipelineContext_retryAfterSignIn).call(this, () => __classPrivateFieldGet(this, _PipelineContext_repository, "f").tryUpdate(pipelineId, options));
+        if (error)
+            await __classPrivateFieldGet(this, _PipelineContext_instances, "m", _PipelineContext_setConflict).call(this, error);
         if (response?.options) {
             console.debug('update: pipeline.options', response);
             __classPrivateFieldGet(this, _PipelineContext_options, "f").setValue(response.options);
@@ -140,7 +162,10 @@ export class PipelineContext extends UmbControllerBase {
     async saveOptions() {
         if (!__classPrivateFieldGet(this, _PipelineContext_pipeline, "f").value)
             return;
-        const response = await __classPrivateFieldGet(this, _PipelineContext_repository, "f").update(__classPrivateFieldGet(this, _PipelineContext_pipeline, "f").value, __classPrivateFieldGet(this, _PipelineContext_options, "f").value);
+        const pipelineId = __classPrivateFieldGet(this, _PipelineContext_pipeline, "f").value;
+        const { data: response, error } = await __classPrivateFieldGet(this, _PipelineContext_instances, "m", _PipelineContext_retryAfterSignIn).call(this, () => __classPrivateFieldGet(this, _PipelineContext_repository, "f").tryUpdate(pipelineId, __classPrivateFieldGet(this, _PipelineContext_options, "f").value));
+        if (error)
+            await __classPrivateFieldGet(this, _PipelineContext_instances, "m", _PipelineContext_setConflict).call(this, error);
         if (response?.options) {
             console.debug('save:pipeline.options', response);
             __classPrivateFieldGet(this, _PipelineContext_options, "f").setValue(response.options);
@@ -217,7 +242,7 @@ export class PipelineContext extends UmbControllerBase {
         __classPrivateFieldGet(this, _PipelineContext_pending, "f").setValue(__classPrivateFieldGet(this, _PipelineContext_options, "f").value);
     }
 }
-_PipelineContext_repository = new WeakMap(), _PipelineContext_hubContext = new WeakMap(), _PipelineContext_pipeline = new WeakMap(), _PipelineContext_state = new WeakMap(), _PipelineContext_options = new WeakMap(), _PipelineContext_results = new WeakMap(), _PipelineContext_message = new WeakMap(), _PipelineContext_backgroundState = new WeakMap(), _PipelineContext_clientId = new WeakMap(), _PipelineContext_hasConnectedBefore = new WeakMap(), _PipelineContext_trigger = new WeakMap(), _PipelineContext_close = new WeakMap(), _PipelineContext_finalized = new WeakMap(), _PipelineContext_valid = new WeakMap(), _PipelineContext_pending = new WeakMap(), _PipelineContext_instances = new WeakSet(), _PipelineContext_onClientIdChanged = 
+_PipelineContext_repository = new WeakMap(), _PipelineContext_hubContext = new WeakMap(), _PipelineContext_pipeline = new WeakMap(), _PipelineContext_state = new WeakMap(), _PipelineContext_options = new WeakMap(), _PipelineContext_results = new WeakMap(), _PipelineContext_message = new WeakMap(), _PipelineContext_backgroundState = new WeakMap(), _PipelineContext_conflict = new WeakMap(), _PipelineContext_clientId = new WeakMap(), _PipelineContext_hasConnectedBefore = new WeakMap(), _PipelineContext_trigger = new WeakMap(), _PipelineContext_close = new WeakMap(), _PipelineContext_finalized = new WeakMap(), _PipelineContext_valid = new WeakMap(), _PipelineContext_pending = new WeakMap(), _PipelineContext_instances = new WeakSet(), _PipelineContext_onClientIdChanged = 
 /**
  * @description called whenever the SignalR connection id changes - which includes the very
  * first connect, where there's nothing to reattach yet, and a reconnect, where a pipeline
@@ -255,6 +280,64 @@ async function _PipelineContext_onClientIdChanged(clientId) {
         default:
             return false;
     }
+}, _PipelineContext_setConflict = 
+/**
+ * @description records a 409 "already running", with the holder's status when the user can
+ * see it.
+ * @param error the error from a create, process or update.
+ * @returns true when it was a conflict.
+ */
+async function _PipelineContext_setConflict(error) {
+    const conflict = getPipelineConflict(error);
+    if (!conflict)
+        return false;
+    __classPrivateFieldGet(this, _PipelineContext_conflict, "f").setValue(conflict);
+    const holder = await __classPrivateFieldGet(this, _PipelineContext_repository, "f").getRunStatus(conflict.runningPipelineId);
+    if (holder)
+        __classPrivateFieldGet(this, _PipelineContext_conflict, "f").setValue({ ...conflict, holder });
+    return true;
+}, _PipelineContext_retryAfterSignIn = 
+/**
+ * @description makes a create, update or process call, and makes it again if it hit a session
+ * timeout. From Umbraco 19 a 401 on a POST opens the login modal but, unlike a GET, the
+ * request is not retried - so a run would drop back to waiting mid-pipeline, or carry on with
+ * options that were never saved. The 401 comes from the auth middleware, before our
+ * controller runs, so once the user has signed back in it is safe to send the same call again.
+ * @param call the request, made again on each attempt.
+ * @returns the first result that isn't a 401.
+ */
+async function _PipelineContext_retryAfterSignIn(call) {
+    let result = await call();
+    while (result.error && (await __classPrivateFieldGet(this, _PipelineContext_instances, "m", _PipelineContext_waitForSignIn).call(this, result.error))) {
+        result = await call();
+    }
+    return result;
+}, _PipelineContext_waitForSignIn = 
+/**
+ * @description waits for the user to sign back in after a session timeout.
+ * @param error the error from a request.
+ * @returns true once the user has signed back in after a 401, false for any other error.
+ */
+async function _PipelineContext_waitForSignIn(error) {
+    // the generated client doesn't throw, so this is usually the problem details themselves
+    // rather than an UmbApiError - check both, as getPipelineConflict does.
+    const status = UmbApiError.isUmbApiError(error)
+        ? error.status
+        : error?.status;
+    if (status !== 401)
+        return false;
+    const authContext = await this.getContext(UMB_AUTH_CONTEXT);
+    if (!authContext)
+        return false;
+    // the 401 clears the session, but the request can land before that does - so wait for
+    // the session to be gone and then back, rather than taking a still-signed-in value.
+    let signedOut = false;
+    await firstValueFrom(authContext.isAuthorized.pipe(filter((isAuthorized) => {
+        if (!isAuthorized)
+            signedOut = true;
+        return isAuthorized && signedOut;
+    })));
+    return true;
 };
 export default PipelineContext;
 export const JUMOO_PROCESSING_CONTEXT = new UmbContextToken('JumooPipelineContext');

package/dist/pipeline/pipeline.element.d.ts

@@ -9,6 +9,8 @@ import { ProcessingOptions } from '@jumoo/processing';
  * @fires pipeline-waiting - when the pipeline is waiting for user input
  * @fires pipeline-last-action - when the pipeline is on the last action
  * @fires pipeline-status - the current status of the pipeline.
+ * @fires pipeline-conflict - when the pipeline can't be created or resumed because another
+ * process is already running for the same target (detail is the PipelineConflict).
  */
 export declare class JumooPipelineElement extends UmbLitElement {
     private context?;
@@ -35,6 +37,7 @@ export declare class JumooPipelineElement extends UmbLitElement {
     private results;
     private message;
     private backgroundState;
+    private conflict;
     constructor();
     connectedCallback(): void;
     private process;
@@ -57,6 +60,14 @@ export declare class JumooPipelineElement extends UmbLitElement {
      */
     private onLastAction;
     render(): import("lit-html").TemplateResult<1>;
+    private renderConflict;
+    /**
+     * @description the time worth showing for the holder: when it was queued, when it last
+     * moved, how long it has been paused, or when it is due.
+     * @param holder the holder's status.
+     * @returns the label key and the time, or undefined when there is nothing to show.
+     */
+    private conflictTime;
     private renderDebug;
     private renderStatus;
     private renderBackground;

package/dist/pipeline/pipeline.element.js

@@ -7,6 +7,24 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 import { css, customElement, html, nothing, property, state, } from '@umbraco-cms/backoffice/external/lit';
 import { UmbLitElement } from '@umbraco-cms/backoffice/lit-element';
 import { PipelineStatus, JUMOO_PROCESSING_CONTEXT, } from '@jumoo/processing';
+import { PipelineRunState } from '../api/index.js';
+/**
+ * @description the suffix on the conflict panel's headline and message keys for the holder's
+ * status. A holder that isn't moving or waiting gets the general wording.
+ * @param status the holder's status.
+ * @returns the key suffix.
+ */
+function conflictSuffix(status) {
+    switch (status) {
+        case PipelineRunState.RUNNING:
+        case PipelineRunState.QUEUED:
+        case PipelineRunState.WAITING:
+        case PipelineRunState.SCHEDULED:
+            return status;
+        default:
+            return '';
+    }
+}
 /**
  * @property {string} processor - the processor to use for the pipeline
  * @property {string} strategy - the strategy to use for the pipeline
@@ -16,6 +34,8 @@ import { PipelineStatus, JUMOO_PROCESSING_CONTEXT, } from '@jumoo/processing';
  * @fires pipeline-waiting - when the pipeline is waiting for user input
  * @fires pipeline-last-action - when the pipeline is on the last action
  * @fires pipeline-status - the current status of the pipeline.
+ * @fires pipeline-conflict - when the pipeline can't be created or resumed because another
+ * process is already running for the same target (detail is the PipelineConflict).
  */
 let JumooPipelineElement = class JumooPipelineElement extends UmbLitElement {
     constructor() {
@@ -73,6 +93,17 @@ let JumooPipelineElement = class JumooPipelineElement extends UmbLitElement {
             this.observe(this.context.results, (results) => {
                 this.results = results;
             });
+            this.observe(this.context.conflict, (conflict) => {
+                const isNew = conflict && !this.conflict;
+                this.conflict = conflict;
+                if (isNew) {
+                    this.dispatchEvent(new CustomEvent('pipeline-conflict', {
+                        bubbles: true,
+                        composed: true,
+                        detail: conflict,
+                    }));
+                }
+            });
         });
     }
     connectedCallback() {
@@ -139,7 +170,68 @@ let JumooPipelineElement = class JumooPipelineElement extends UmbLitElement {
         this.fireEvent('pipeline-last-action');
     }
     render() {
-        return html `${this.renderStatus()}${this.renderDebug()}`;
+        return html `${this.conflict ? this.renderConflict(this.conflict) : this.renderStatus()}${this.renderDebug()}`;
+    }
+    renderConflict(conflict) {
+        const holder = conflict.holder;
+        const suffix = holder ? conflictSuffix(holder.status) : '';
+        const time = holder ? this.conflictTime(holder) : undefined;
+        const dateFormat = {
+            dateStyle: 'medium',
+            timeStyle: 'short',
+        };
+        return html `<div class="conflict">
+			<div class="header">
+				<uui-icon name="icon-alert"></uui-icon>
+				<h3>${this.localize.term(`jumooProcConflict_headline${suffix}`)}</h3>
+			</div>
+			<p>${this.localize.term(`jumooProcConflict_message${suffix}`)}</p>
+			${holder
+            ? html `<dl>
+							<dt><umb-localize key="jumooProcConflict_status">Status</umb-localize></dt>
+							<dd>${this.localize.term(`jumooProcConflict_state${holder.status}`)}</dd>
+							${holder.startedByName
+                ? html `<dt>
+												<umb-localize key="jumooProcConflict_startedBy"
+													>Started by</umb-localize
+												>
+											</dt>
+											<dd>${holder.startedByName}</dd>`
+                : nothing}
+							${time
+                ? html `<dt>${this.localize.term(time.label)}</dt>
+											<dd>${this.localize.date(time.value, dateFormat)}</dd>`
+                : nothing}
+							${holder.status === PipelineRunState.RUNNING
+                ? html `<dt>
+												<umb-localize key="jumooProcConflict_progress"
+													>Progress</umb-localize
+												>
+											</dt>
+											<dd>${Math.round(holder.progress.percentage)}%</dd>`
+                : nothing}
+						</dl>`
+            : nothing}
+		</div>`;
+    }
+    /**
+     * @description the time worth showing for the holder: when it was queued, when it last
+     * moved, how long it has been paused, or when it is due.
+     * @param holder the holder's status.
+     * @returns the label key and the time, or undefined when there is nothing to show.
+     */
+    conflictTime(holder) {
+        const pick = (label, value) => value ? { label: `jumooProcConflict_${label}`, value } : undefined;
+        switch (holder.status) {
+            case PipelineRunState.QUEUED:
+                return pick('queued', holder.created);
+            case PipelineRunState.WAITING:
+                return pick('waitingSince', holder.modified);
+            case PipelineRunState.SCHEDULED:
+                return pick('scheduledFor', holder.scheduledFor);
+            default:
+                return pick('lastActivity', holder.modified ?? holder.created);
+        }
     }
     renderDebug() {
         return this.debug
@@ -155,6 +247,7 @@ let JumooPipelineElement = class JumooPipelineElement extends UmbLitElement {
             case PipelineStatus.RUNNING:
                 return this.renderSteps();
             case PipelineStatus.FAILED:
+            case PipelineStatus.CANCELLED:
                 return this.renderFail();
             case PipelineStatus.BACKGROUND:
                 return this.renderBackground();
@@ -219,6 +312,40 @@ JumooPipelineElement.styles = css `
 		umb-extension-slot {
 			height: 100%;
 		}
+
+		.conflict {
+			padding: var(--uui-size-space-5);
+			border: 1px solid var(--uui-color-warning-standalone);
+			border-left-width: 4px;
+			border-radius: var(--uui-border-radius);
+			background-color: var(--uui-color-surface);
+		}
+
+		.conflict .header {
+			display: flex;
+			align-items: center;
+			gap: var(--uui-size-space-3);
+			color: var(--uui-color-warning-standalone);
+		}
+
+		.conflict h3 {
+			margin: 0;
+		}
+
+		.conflict dl {
+			display: grid;
+			grid-template-columns: max-content 1fr;
+			gap: var(--uui-size-space-2) var(--uui-size-space-5);
+			margin: var(--uui-size-space-4) 0;
+		}
+
+		.conflict dt {
+			font-weight: bold;
+		}
+
+		.conflict dd {
+			margin: 0;
+		}
 	`;
 __decorate([
     property({ type: String })
@@ -253,6 +380,9 @@ __decorate([
 __decorate([
     state()
 ], JumooPipelineElement.prototype, "backgroundState", void 0);
+__decorate([
+    state()
+], JumooPipelineElement.prototype, "conflict", void 0);
 JumooPipelineElement = __decorate([
     customElement('jumoo-pipeline')
 ], JumooPipelineElement);

package/dist/pipeline/pipeline.repository.d.ts

@@ -14,6 +14,47 @@ export declare class PipelineRepository extends UmbControllerBase {
     getProcessors(): Promise<string[] | undefined>;
     Get(id: string): Promise<import("@jumoo/processing").Pipeline | undefined>;
     create(processor: string, strategy: string, options: ProcessingOptions | undefined): Promise<string | undefined>;
+    /**
+     * @description create, returning the whole response rather than just the id, so the caller
+     * can tell a 409 "already running" (see getPipelineConflict) from any other failure.
+     */
+    tryCreate(processor: string, strategy: string, options: ProcessingOptions | undefined): Promise<import("@umbraco-cms/backoffice/resources").UmbApiResponse<({
+        data: string;
+        error: undefined;
+    } | {
+        data: undefined;
+        error: unknown;
+    }) & {
+        request?: Request;
+        response?: Response;
+    }>>;
+    /**
+     * @description process, returning the whole response - see tryCreate.
+     */
+    tryProcess(id: string, clientId: string | null): Promise<import("@umbraco-cms/backoffice/resources").UmbApiResponse<({
+        data: import("@jumoo/processing").Pipeline;
+        error: undefined;
+    } | {
+        data: undefined;
+        error: unknown;
+    }) & {
+        request?: Request;
+        response?: Response;
+    }>>;
+    /**
+     * @description update, returning the whole response - see tryCreate.
+     */
+    tryUpdate(id: string, body: ProcessingOptions | undefined): Promise<import("@umbraco-cms/backoffice/resources").UmbApiResponse<({
+        data: import("@jumoo/processing").ProcessingOptionsResults;
+        error: undefined;
+    } | {
+        data: undefined;
+        error: unknown;
+    }) & {
+        request?: Request;
+        response?: Response;
+    }>>;
+    getRunStatus(id: string): Promise<import("@jumoo/processing").PipelineRunStatus | undefined>;
     complete(id: string): Promise<void>;
     getResults(id: string): Promise<import("@jumoo/processing").ProcessingResults | undefined>;
     listPipelines(status: PipelineStatus): Promise<import("@jumoo/processing").Pipeline[] | undefined>;

package/dist/pipeline/pipeline.repository.js

@@ -29,6 +29,28 @@ export class PipelineRepository extends UmbControllerBase {
     async create(processor, strategy, options) {
         return (await this.source.create(processor, strategy, options)).data;
     }
+    /**
+     * @description create, returning the whole response rather than just the id, so the caller
+     * can tell a 409 "already running" (see getPipelineConflict) from any other failure.
+     */
+    async tryCreate(processor, strategy, options) {
+        return await this.source.create(processor, strategy, options);
+    }
+    /**
+     * @description process, returning the whole response - see tryCreate.
+     */
+    async tryProcess(id, clientId) {
+        return await this.source.process(id, clientId);
+    }
+    /**
+     * @description update, returning the whole response - see tryCreate.
+     */
+    async tryUpdate(id, body) {
+        return await this.source.update(id, body);
+    }
+    async getRunStatus(id) {
+        return (await this.source.getRunStatus(id)).data;
+    }
     async complete(id) {
         console.debug('complete', id);
     }