nucleus-core-ts 0.10.117 → 0.10.118

package/dist/.build-ok

@@ -1 +1 @@
-0.10.117
+0.10.118

package/dist/fe/components/VerificationFlowPage/components/VerificationEntityList.d.ts

@@ -1,5 +1,5 @@
 import type { VerificationFlowLabels } from '../labels';
-import type { VerificationBulkStatusItem, VerificationEntityStatusesAction } from '../types';
+import type { VerificationBulkStatusItem, VerificationCancelAction, VerificationEntityStatusesAction } from '../types';
 export type VerificationEntityListTheme = {
     container: string;
     header: string;
@@ -46,5 +46,11 @@ export type VerificationEntityListProps = {
     pageSize?: number;
     /** Spread over the English defaults; omit it and the list stays English. */
     labels?: Partial<VerificationFlowLabels>;
+    /**
+     * Ends a chain that cannot finish. This list is the only screen that knows
+     * which chains are still `active`, so it is where the exit belongs — until
+     * now the API had one and the product offered none.
+     */
+    cancelAction?: VerificationCancelAction;
 };
-export declare function VerificationEntityList({ entityName, entityStatusesAction, theme: themeOverrides, themeMode, onEntityClick, pageSize, labels, }: VerificationEntityListProps): import("react/jsx-runtime").JSX.Element;
+export declare function VerificationEntityList({ entityName, entityStatusesAction, theme: themeOverrides, themeMode, onEntityClick, pageSize, labels, cancelAction, }: VerificationEntityListProps): import("react/jsx-runtime").JSX.Element;

package/dist/fe/components/VerificationFlowPage/components/VerificationEntityList.js

@@ -97,7 +97,7 @@ const lightTheme = {
     };
     return map[status] ?? status;
 }
-export function VerificationEntityList({ entityName, entityStatusesAction, theme: themeOverrides, themeMode = 'dark', onEntityClick, pageSize = 20, labels }) {
+export function VerificationEntityList({ entityName, entityStatusesAction, theme: themeOverrides, themeMode = 'dark', onEntityClick, pageSize = 20, labels, cancelAction }) {
     const baseTheme = themeMode === 'light' ? lightTheme : darkTheme;
     const t = {
         ...baseTheme,
@@ -109,6 +109,10 @@ export function VerificationEntityList({ entityName, entityStatusesAction, theme
     };
     const [activeTab, setActiveTab] = useState('all');
     const [currentPage, setCurrentPage] = useState(1);
+    // Which row is asking for confirmation, and what it is being told.
+    const [cancellingId, setCancellingId] = useState(null);
+    const [cancelReason, setCancelReason] = useState('');
+    const [cancelNote, setCancelNote] = useState(null);
     const loadStatuses = useEffectEvent((status, page)=>{
         entityStatusesAction.start({
             payload: {
@@ -128,6 +132,39 @@ export function VerificationEntityList({ entityName, entityStatusesAction, theme
         setCurrentPage(page);
         loadStatuses(activeTab === 'all' ? undefined : activeTab, page);
     });
+    const sendCancel = useEffectEvent((item)=>{
+        if (!cancelAction) return;
+        setCancelNote(null);
+        cancelAction.start({
+            payload: {
+                entity_name: item.entity_name,
+                entity_id: item.entity_id,
+                ...cancelReason ? {
+                    reason: cancelReason
+                } : {}
+            },
+            onAfterHandle: (res)=>{
+                /*
+         * A refusal — "only the person who started this verification, or a
+         * godmin, can cancel it" — arrives as a body, not always as a status,
+         * so it is read from the body. The row is NOT closed on a refusal:
+         * closing it here is the bug that made every other decision screen
+         * look like it had worked.
+         */ const response = res;
+                if (response?.success === false) {
+                    setCancelNote(response.message || say.cancelChainFailed);
+                    return;
+                }
+                setCancellingId(null);
+                setCancelReason('');
+                loadStatuses(activeTab === 'all' ? undefined : activeTab, currentPage);
+            },
+            onErrorHandle: (err)=>{
+                const msg = err?.message;
+                setCancelNote(msg || say.cancelChainFailed);
+            }
+        });
+    });
     useEffect(()=>{
         loadStatuses(undefined, 1);
     }, []);
@@ -294,7 +331,68 @@ export function VerificationEntityList({ entityName, entityStatusesAction, theme
                             /*#__PURE__*/ _jsx("span", {
                                 className: `${t.statusBadge} ${getStatusBadgeClass(item.status)}`,
                                 children: statusLabel(say, item.status)
-                            })
+                            }),
+                            cancelAction && item.status === 'active' ? cancellingId === item.instance_id ? // No handlers on this wrapper: the row above is a button
+                            // when `onEntityClick` is set, so each INTERACTIVE child
+                            // stops the bubble itself rather than a bare div doing it
+                            // for them.
+                            /*#__PURE__*/ _jsxs("div", {
+                                className: "flex flex-col items-stretch gap-2 shrink-0",
+                                children: [
+                                    /*#__PURE__*/ _jsx("p", {
+                                        className: t.metaLabel,
+                                        children: say.cancelChainConfirm
+                                    }),
+                                    /*#__PURE__*/ _jsx("input", {
+                                        type: "text",
+                                        value: cancelReason,
+                                        placeholder: say.cancelChainReasonPlaceholder,
+                                        onClick: (e)=>e.stopPropagation(),
+                                        onKeyDown: (e)=>e.stopPropagation(),
+                                        onChange: (e)=>setCancelReason(e.target.value),
+                                        className: themeMode === 'light' ? 'rounded-lg border border-gray-200 bg-gray-50 px-2 py-1 text-[11px] text-gray-800 outline-none focus:border-gray-400' : 'rounded-lg border border-white/[0.08] bg-white/[0.04] px-2 py-1 text-[11px] text-white/80 outline-none focus:border-white/20'
+                                    }),
+                                    /*#__PURE__*/ _jsxs("div", {
+                                        className: "flex items-center gap-2",
+                                        children: [
+                                            /*#__PURE__*/ _jsx("button", {
+                                                type: "button",
+                                                onClick: (e)=>{
+                                                    e.stopPropagation();
+                                                    sendCancel(item);
+                                                },
+                                                className: themeMode === 'light' ? 'rounded-lg border border-red-200 bg-red-50 px-2.5 py-1 text-[11px] font-medium text-red-600 hover:bg-red-100' : 'rounded-lg border border-red-500/30 bg-red-500/20 px-2.5 py-1 text-[11px] font-medium text-red-400 hover:bg-red-500/30',
+                                                children: say.cancelChain
+                                            }),
+                                            /*#__PURE__*/ _jsx("button", {
+                                                type: "button",
+                                                onClick: (e)=>{
+                                                    e.stopPropagation();
+                                                    setCancellingId(null);
+                                                    setCancelReason('');
+                                                    setCancelNote(null);
+                                                },
+                                                className: themeMode === 'light' ? 'rounded-lg border border-gray-200 bg-gray-50 px-2.5 py-1 text-[11px] font-medium text-gray-500 hover:bg-gray-100' : 'rounded-lg border border-white/[0.08] bg-white/[0.06] px-2.5 py-1 text-[11px] font-medium text-white/50 hover:bg-white/[0.1]',
+                                                children: say.cancel
+                                            })
+                                        ]
+                                    }),
+                                    cancelNote ? /*#__PURE__*/ _jsx("p", {
+                                        role: "alert",
+                                        className: themeMode === 'light' ? 'text-[11px] leading-4 text-amber-900' : 'text-[11px] leading-4 text-amber-200',
+                                        children: cancelNote
+                                    }) : null
+                                ]
+                            }) : /*#__PURE__*/ _jsx("button", {
+                                type: "button",
+                                onClick: (e)=>{
+                                    e.stopPropagation();
+                                    setCancellingId(item.instance_id);
+                                    setCancelNote(null);
+                                },
+                                className: themeMode === 'light' ? 'shrink-0 rounded-lg border border-gray-200 bg-white px-2.5 py-1 text-[11px] font-medium text-gray-600 hover:bg-gray-100' : 'shrink-0 rounded-lg border border-white/[0.08] bg-white/[0.04] px-2.5 py-1 text-[11px] font-medium text-white/60 hover:bg-white/[0.1]',
+                                children: say.cancelChain
+                            }) : null
                         ]
                     }, item.instance_id);
                 })

package/dist/fe/components/VerificationFlowPage/components/VerificationFlowPage.d.ts

@@ -1,4 +1,4 @@
 import '@xyflow/react/dist/style.css';
 import type { ReactElement } from 'react';
 import type { VerificationFlowPageProps } from '../types';
-export declare function VerificationFlowPage({ entityName, title, subtitle, flowListAction, flowGetAction, flowSaveAction, flowPublishAction, flowUnpublishAction, flowDeleteAction, pendingAction, decideAction, uploadSignatureAction, listUsersAction, listRolesAction, entityStatusesAction, onFlowSelected, onDecisionMade, onEntityClick, onBack, showPending, showEntityStatuses, className, themeMode, labels, describeEntity, entityHref, availableChannels, initialTab, }: VerificationFlowPageProps): ReactElement;
+export declare function VerificationFlowPage({ entityName, title, subtitle, flowListAction, flowGetAction, flowSaveAction, flowPublishAction, flowUnpublishAction, flowDeleteAction, pendingAction, decideAction, uploadSignatureAction, listUsersAction, listRolesAction, entityStatusesAction, onFlowSelected, onDecisionMade, onEntityClick, onBack, showPending, showEntityStatuses, className, themeMode, labels, describeEntity, entityHref, availableChannels, initialTab, cancelAction, }: VerificationFlowPageProps): ReactElement;

package/dist/fe/components/VerificationFlowPage/components/VerificationFlowPage.js

@@ -297,7 +297,7 @@ function buildSavePayload(flowId, entityName, flowName, flowDescription, trigger
     };
 }
 // ─── Main Component ───────────────────────────────────────────────
-export function VerificationFlowPage({ entityName, title, subtitle, flowListAction, flowGetAction, flowSaveAction, flowPublishAction, flowUnpublishAction, flowDeleteAction, pendingAction, decideAction, uploadSignatureAction, listUsersAction, listRolesAction, entityStatusesAction, onFlowSelected, onDecisionMade, onEntityClick, onBack, showPending = true, showEntityStatuses = false, className, themeMode = 'dark', labels, describeEntity, entityHref, availableChannels, initialTab }) {
+export function VerificationFlowPage({ entityName, title, subtitle, flowListAction, flowGetAction, flowSaveAction, flowPublishAction, flowUnpublishAction, flowDeleteAction, pendingAction, decideAction, uploadSignatureAction, listUsersAction, listRolesAction, entityStatusesAction, onFlowSelected, onDecisionMade, onEntityClick, onBack, showPending = true, showEntityStatuses = false, className, themeMode = 'dark', labels, describeEntity, entityHref, availableChannels, initialTab, cancelAction }) {
     const theme = getVerificationFlowTheme(themeMode);
     setActiveTheme(theme);
     const say = {
@@ -1323,7 +1323,8 @@ export function VerificationFlowPage({ entityName, title, subtitle, flowListActi
                     entityStatusesAction: entityStatusesAction,
                     onEntityClick: onEntityClick,
                     themeMode: themeMode,
-                    labels: say
+                    labels: say,
+                    cancelAction: cancelAction
                 })
             })
         ]

package/dist/fe/components/VerificationFlowPage/labels.d.ts

@@ -192,6 +192,11 @@ export type VerificationFlowLabels = {
     openRecord: string;
     /** Shown beside a channel this deployment cannot deliver on. */
     channelUnavailable: string;
+    /** Ends a chain nobody can finish. Starter or godmin only. */
+    cancelChain: string;
+    cancelChainConfirm: string;
+    cancelChainReasonPlaceholder: string;
+    cancelChainFailed: string;
     verificationStatusTitle: string;
     /** "12 records for orders" — count and entity, both inside the label. */
     recordCount: (count: number, entityName: string) => string;

package/dist/fe/components/VerificationFlowPage/labels.js

@@ -152,6 +152,10 @@
     pendingRecordLabel: 'Record',
     openRecord: 'Open the record',
     channelUnavailable: 'not available on this installation',
+    cancelChain: 'End this review',
+    cancelChainConfirm: 'End this review? The record goes back to pending and a new chain can be started. The decisions already made are kept.',
+    cancelChainReasonPlaceholder: 'Why (optional)',
+    cancelChainFailed: 'The review could not be ended.',
     verificationStatusTitle: 'Verification Status',
     recordCount: (count, entityName)=>`${count} record${count !== 1 ? 's' : ''} for ${entityName}`,
     noRecordsIconTitle: 'No records',

package/dist/fe/components/VerificationFlowPage/types/index.d.ts

@@ -33,6 +33,23 @@ export type VerificationDecideAction = GenericAction<VerificationDecidePayload &
     entity_id: string;
 }, VerificationDecideResponse>;
 export type VerificationPendingAction = GenericAction<undefined, VerificationPendingResponse>;
+/**
+ * Closes a chain nobody can finish any more.
+ *
+ * The API has had this since the engine did; no screen in the product ever
+ * called it. So a chain that stranded — an emptied role, a withdrawn flow, a
+ * step whose only candidate the chain itself bars — could be ended by nothing
+ * a person can press, and the record stayed `pending` for good. The route
+ * allows the person who started the chain, or a godmin, and nobody else.
+ */
+export type VerificationCancelAction = GenericAction<{
+    entity_name: string;
+    entity_id: string;
+    reason?: string;
+}, {
+    success: boolean;
+    message?: string;
+}>;
 /**
  * Uploads the file a verifier signs with, and hands back its id.
  *
@@ -267,6 +284,11 @@ export type VerificationFlowPageProps = {
      * arrived says so here.
      */
     initialTab?: 'flow' | 'pending' | 'statuses';
+    /**
+     * Lets the starter (or a godmin) end a chain that cannot finish. Omit it and
+     * the records list has no cancel control, which is what shipped until now.
+     */
+    cancelAction?: VerificationCancelAction;
 };
 export type DraggedNodeType = NodeType | null;
 export type VerificationFlowPageState = {