feat(content-drive): add Action Center for bulk workflow actions

core-web/libs/data-access/src/lib/dot-workflows-actions/dot-workflows-actions.service.ts

@@ -6,6 +6,8 @@ import { Injectable, inject } from '@angular/core';
 import { map } from 'rxjs/operators';
 
 import {
+    DotBulkActionRequest,
+    DotBulkActionView,
     DotCMSContentletWorkflowActions,
     DotCMSResponse,
     DotCMSWorkflow,
@@ -80,6 +82,29 @@ export class DotWorkflowsActionsService {
             );
     }
 
+    /**
+     * Returns the workflow actions available for a set of contentlets, grouped by scheme and step,
+     * each with the number of selected contentlets it applies to.
+     *
+     * Backing endpoint: `POST /api/v1/workflow/contentlet/actions/bulk`. Supply either
+     * `contentletIds` (contentlet **inodes**, despite the property name) or a Lucene `query` for
+     * selections that span pages.
+     *
+     * Note that an action's `count` is an upper bound when `conditionPresent` is true — the backend
+     * does not evaluate the action's Velocity condition while aggregating.
+     *
+     * @param {DotBulkActionRequest} request
+     * @returns {Observable<DotBulkActionView>}
+     * @memberof DotWorkflowsActionsService
+     */
+    getBulkActions(request: DotBulkActionRequest): Observable<DotBulkActionView> {
+        return this.httpClient
+            .post<
+                DotCMSResponse<DotBulkActionView>
+            >(`${this.BASE_URL}/contentlet/actions/bulk`, request)
+            .pipe(map((response) => response?.entity ?? { schemes: [] }));
+    }
+
     private getWorkFlowId(workflow: DotCMSWorkflow): string {
         return workflow && workflow.id;
     }

core-web/libs/dotcms-models/src/index.ts

@@ -11,6 +11,7 @@ export * from './lib/dot-asset-create-options.model';
 export * from './lib/dot-block-editor.model';
 export * from './lib/dot-block-editor-custom-blocks.util';
 export * from './lib/unknown-block.util';
+export * from './lib/dot-bulk-actions.model';
 export * from './lib/dot-bundle';
 export * from './lib/dot-categories.model';
 export * from './lib/dot-container.model';

core-web/libs/dotcms-models/src/lib/dot-bulk-actions.model.ts

@@ -0,0 +1,105 @@
+import { DotCMSWorkflowAction } from './dot-workflow-action.model';
+
+/**
+ * Request body for `POST /api/v1/workflow/contentlet/actions/bulk`.
+ *
+ * Either `contentletIds` or `query` must be supplied. Note that despite the property name,
+ * `contentletIds` holds contentlet **inodes**, not identifiers — the backend documents this
+ * explicitly on the endpoint.
+ */
+export interface DotBulkActionRequest {
+    /** Contentlet **inodes** (not identifiers, despite the name). */
+    contentletIds?: string[];
+    /** Lucene query, used when the selection spans pages ("select all"). */
+    query?: string;
+}
+
+/**
+ * A workflow step with the number of selected contentlets currently sitting in it.
+ */
+export interface DotCountWorkflowStep {
+    count: number;
+    workflowStep: {
+        id: string;
+        name: string;
+        schemeId: string;
+    };
+}
+
+/**
+ * A workflow action with the number of selected contentlets it applies to.
+ *
+ * `count` is the number of selected contentlets currently in a step that exposes this action.
+ * It is already summed across every step of the scheme by the backend, so flattening
+ * `steps[] -> actions[]` does not double-count.
+ *
+ * `count` is an **upper bound** when `conditionPresent` is true: the backend does not evaluate
+ * the action's Velocity condition when aggregating, because there is no per-contentlet
+ * permissionable at that point.
+ */
+export interface DotCountWorkflowAction {
+    count: number;
+    workflowAction: DotCMSWorkflowAction;
+    /** Action has a push-publish actionlet — needs environment/date inputs before firing. */
+    pushPublish: boolean;
+    /** Action has a move actionlet with no path — needs a target path before firing. */
+    moveable: boolean;
+    /** Action has a Velocity condition that was NOT evaluated when computing `count`. */
+    conditionPresent: boolean;
+}
+
+/**
+ * One workflow scheme and its steps, as returned inside {@link DotBulkActionView}.
+ */
+export interface DotBulkWorkflowSchemeView {
+    scheme: {
+        id: string;
+        name: string;
+        archived?: boolean;
+        description?: string;
+    };
+    steps: {
+        step: DotCountWorkflowStep;
+        actions: DotCountWorkflowAction[];
+    }[];
+}
+
+/**
+ * Response entity of `POST /api/v1/workflow/contentlet/actions/bulk`.
+ *
+ * Actions are deduped per scheme server-side and filtered to those flagged `showOn: LISTING`.
+ * Archived schemes are excluded.
+ */
+export interface DotBulkActionView {
+    schemes: DotBulkWorkflowSchemeView[];
+}
+
+/**
+ * UI-facing shape: one scheme with its steps flattened into a single action list.
+ *
+ * This is what the Action Center renders — the nested step grouping is a backend implementation
+ * detail that the dialog does not surface.
+ */
+export interface DotActionCenterScheme {
+    id: string;
+    name: string;
+    /** Number of selected contentlets that sit somewhere in this scheme. */
+    count: number;
+    actions: DotActionCenterWorkflowAction[];
+}
+
+/**
+ * A single selectable workflow action in the Action Center.
+ */
+export interface DotActionCenterWorkflowAction {
+    id: string;
+    name: string;
+    count: number;
+    /**
+     * True when the action cannot be fired from the dialog without collecting extra input
+     * (assign/comment, push-publish settings, or a move target path). Disabled in v1.
+     */
+    requiresInput: boolean;
+    /** True when `count` is an upper bound because a Velocity condition was not evaluated. */
+    approximateCount: boolean;
+}