@5minds/processcube_app_sdk 8.5.0 → 8.6.1

package/README.md

@@ -111,12 +111,13 @@ export default nextConfig;
 
 ### CSS einbinden
 
-Client-Komponenten bringen eigene Stylesheets mit, die im Layout oder auf der Seite importiert werden müssen:
+Komponenten-CSS wird automatisch geladen — beim Import einer Client-Komponente wird das zugehörige Stylesheet vom Consumer-Bundler (webpack/turbopack) mit aufgelöst. Ein manueller CSS-Import ist in den meisten Fällen nicht nötig.
+
+Falls die Tailwind-Basisstyles (Resets, Utilities) separat benötigt werden:
 
 ```typescript
-// Beispiel: ProcessInstanceInspector CSS
-import '@5minds/processcube_app_sdk/client/components/ProcessInstanceInspector/ProcessInstanceInspector.css';
-import '@5minds/processcube_app_sdk/client/components/BPMNViewer.css';
+// app/layout.tsx
+import '@5minds/processcube_app_sdk/client/styles';
 ```
 
 ### Umgebungsvariablen
@@ -407,7 +408,7 @@ export default withApplicationSdk({
 | `useExternalTasks`           | `boolean` | `false`                  | External Task Worker aktivieren       |
 | `customExternalTasksDirPath` | `string`  | `./app` oder `./src/app` | Verzeichnis für External Task Handler |
 
-Das Plugin fügt automatisch `esbuild` zu `serverComponentsExternalPackages` hinzu und startet Worker nur im Server-Modus (nicht während `next build`).
+Das Plugin fügt automatisch `esbuild` zu `serverExternalPackages` hinzu und startet Worker nur im Server-Modus (nicht während `next build`).
 
 ### Umgebungsvariablen
 
@@ -549,6 +550,15 @@ const triggered = await getFlowNodeInstancesTriggeredByFlowNodeInstanceIds(['fni
 
 ### User Tasks
 
+> **Blocking vs. Non-Blocking:** Einige Funktionen blocken, bis ein Event eintritt. Das ist wichtig für die Wahl der richtigen Funktion:
+>
+> | Funktion                | Blockiert? | Use-Case                                           |
+> | ----------------------- | ---------- | -------------------------------------------------- |
+> | `waitForUserTask()`     | **Ja**     | Server-seitig auf nächsten Task warten (Event-Sub) |
+> | `getWaitingUserTasks()` | Nein       | Polling, UI-Abfragen, Server Components            |
+> | `getUserTasks()`        | Nein       | Allgemeine Abfrage mit vollem Query-Objekt         |
+> | `waitForProcessEnd()`   | **Ja**     | Warten bis Prozess beendet (Event-Sub)             |
+
 #### getWaitingUserTasks
 
 Gibt alle wartenden User Tasks zurück.
@@ -633,7 +643,13 @@ await cancelReservedUserTask(identity, 'flow-node-instance-id');
 | `getReservedUserTasksByIdentity(identity?, options?)`         | Vom aktuellen User reservierte Tasks       |
 | `getAssignedUserTasksByIdentity(identity?, options?)`         | Dem aktuellen User zugewiesene Tasks       |
 
-Alle Funktionen unterstützen einen `identity`-Parameter: `true` (Default) nutzt die implizite User-Identity, `false` deaktiviert Auth, oder ein explizites `Identity`-Objekt.
+Alle Funktionen unterstützen einen `identity`-Parameter:
+
+| Wert              | Verhalten                                                                                               |
+| ----------------- | ------------------------------------------------------------------------------------------------------- |
+| `true` (Default)  | Nutzt die implizite User-Identity aus der NextAuth-Session                                              |
+| `false`           | Anonymer Zugriff — kein Auth-Header. Voraussetzung: Engine muss `allowAnonymousRootAccess: true` haben. |
+| `Identity`-Objekt | Explizite Identity (z.B. von `getServerIdentity()` oder `getIdentity()`)                                |
 
 ### Server Actions
 
@@ -810,11 +826,12 @@ export default function InspectorPage({ processInstanceId }: { processInstanceId
 
 Rendert dynamische Formulare basierend auf UserTask-FormField-Definitionen. Unterstützt 25+ Feldtypen und Custom Fields.
 
+Die Komponente importiert ihr CSS automatisch — ein separater CSS-Import ist nicht nötig.
+
 ```typescript
 'use client';
 
 import { DynamicUi } from '@5minds/processcube_app_sdk/client';
-import '@5minds/processcube_app_sdk/client/components/DynamicUi/DynamicUi.css';
 
 export default function TaskForm({ task }) {
   return (

package/build/client/{actions-MB5VDCO7.mjs → actions-AYWPNATG.mjs}

@@ -1 +1 @@
-"use server";import"./chunk-YEKQJ4YC.mjs";import{DataModels as C}from"@5minds/processcube_engine_client";import{DataModels as b}from"@5minds/processcube_engine_client";import{getToken as p}from"next-auth/jwt";import{ResponseCookies as k}from"next/dist/compiled/@edge-runtime/cookies/index.js";import{cookies as a,headers as y}from"next/headers.js";async function i(){let e=await p({req:{cookies:await a(),headers:await y()}});if(e?.expiresAt&&Date.now()>=e.expiresAt*1e3){let s=await fetch(`${process.env.NEXTAUTH_URL}/api/auth/session`,{method:"GET",headers:{"Content-Type":"application/json",cookie:(await a()).toString()}}),o=new k(s.headers);if(o.getAll().length){let d=!1;try{for(let c of o.getAll())(await a()).set(c.name,c.value,{...c})}catch{d=!0}if(e=await p({req:{cookies:d?o:await a(),headers:await y()}}),e?.error)throw e.error}}if(!e?.accessToken||!e?.sub)throw new Error("AccessToken or Sub could not be determined!");return{token:e?.accessToken,userId:e?.sub}}import{EngineClient as T}from"@5minds/processcube_engine_client";var h=process.env.PROCESSCUBE_ENGINE_URL??"http://localhost:10560",n=new T(h);async function r(){try{return i()}catch{return}}async function u(e){let t=await r();return(await n.processInstances.query({processInstanceId:e},{identity:t,includeXml:!0})).processInstances[0]}async function I(e,t={sortSettings:{sortBy:b.FlowNodeInstances.FlowNodeInstanceSortableColumns.createdAt,sortDir:"ASC"}}){return(await n.flowNodeInstances.query({processInstanceId:e},{...t,identity:t.identity??await r()})).flowNodeInstances}async function l(e){let t=await r();return(await n.flowNodeInstances.query({triggeredByFlowNodeInstance:e},{identity:t})).flowNodeInstances}async function f(e,t,s){let o=await r();await n.processInstances.retryProcessInstance(e,{flowNodeInstanceId:t,newStartToken:s,identity:o})}async function m(e){let t=await r();await n.processInstances.terminateProcessInstance(e,t)}async function w(...e){await n.manualTasks.finishManualTask(...e)}async function g(...e){await n.userTasks.finishUserTask(...e)}async function P(...e){await n.untypedTasks.finishTask(...e)}async function E(){try{return i()}catch{return}}var Q=async(e,t)=>{let s=await E();t==="bpmn:UserTask"?await g(e,{},s):t==="bpmn:ManualTask"?await w(e,s):t==="bpmn:Task"?await P(e,s):console.error(`[@5minds/processcube_app_sdk:handlePlay]		Unsupported flow node type: ${t}`)},z=async e=>{await m(e)},J=async(e,t,s)=>{await f(e,t,s)},K=async e=>u(e),V=async e=>I(e,{sortSettings:{sortBy:C.FlowNodeInstances.FlowNodeInstanceSortableColumns.createdAt,sortDir:"DESC"}}),W=async e=>l(e);export{Q as finishTask,V as getFlowNodeInstances,K as getProcessInstance,W as getTriggeredFlowNodeInstances,J as retryProcess,z as terminateProcess};
+"use server";import"./chunk-YEKQJ4YC.mjs";import{DataModels as C}from"@5minds/processcube_engine_client";import{DataModels as b}from"@5minds/processcube_engine_client";import{getToken as d}from"next-auth/jwt";import{ResponseCookies as k}from"next/dist/compiled/@edge-runtime/cookies/index.js";import{cookies as a,headers as y}from"next/headers.js";async function i(){let e=await d({req:{cookies:await a(),headers:await y()}});if(e?.expiresAt&&Date.now()>=e.expiresAt*1e3){let s=await fetch(`${process.env.NEXTAUTH_URL}/api/auth/session`,{method:"GET",headers:{"Content-Type":"application/json",cookie:(await a()).toString()}}),o=new k(s.headers);if(o.getAll().length){let p=!1;try{for(let c of o.getAll())(await a()).set(c.name,c.value,{...c})}catch{p=!0}if(e=await d({req:{cookies:p?o:await a(),headers:await y()}}),e?.error)throw e.error}}if(!e?.accessToken||!e?.sub)throw new Error("AccessToken or Sub could not be determined!");return{token:e?.accessToken,userId:e?.sub}}import{EngineClient as T}from"@5minds/processcube_engine_client";var h=process.env.PROCESSCUBE_ENGINE_URL??"http://localhost:10560",n=new T(h);async function r(){try{return i()}catch{return}}async function u(e){let t=await r();return(await n.processInstances.query({processInstanceId:e},{identity:t,includeXml:!0})).processInstances[0]}async function I(e,t={sortSettings:{sortBy:b.FlowNodeInstances.FlowNodeInstanceSortableColumns.createdAt,sortDir:"ASC"}}){return(await n.flowNodeInstances.query({processInstanceId:e},{...t,identity:t.identity??await r()})).flowNodeInstances}async function l(e){let t=await r();return(await n.flowNodeInstances.query({triggeredByFlowNodeInstance:e},{identity:t})).flowNodeInstances}async function f(e,t,s){let o=await r();await n.processInstances.retryProcessInstance(e,{flowNodeInstanceId:t,newStartToken:s,identity:o})}async function m(e){let t=await r();await n.processInstances.terminateProcessInstance(e,t)}async function w(...e){await n.manualTasks.finishManualTask(...e)}async function g(...e){await n.userTasks.finishUserTask(...e)}async function P(...e){await n.untypedTasks.finishTask(...e)}async function E(){try{return i()}catch{return}}var Q=async(e,t)=>{let s=await E();t==="bpmn:UserTask"?await g(e,{},s):t==="bpmn:ManualTask"?await w(e,s):t==="bpmn:Task"?await P(e,s):console.error(`[@5minds/processcube_app_sdk:handlePlay]		Unsupported flow node type: ${t}`)},z=async e=>{await m(e)},J=async(e,t,s)=>{await f(e,t,s)},K=async e=>u(e),V=async e=>I(e,{sortSettings:{sortBy:C.FlowNodeInstances.FlowNodeInstanceSortableColumns.createdAt,sortDir:"DESC"}}),W=async e=>l(e);export{Q as finishTask,V as getFlowNodeInstances,K as getProcessInstance,W as getTriggeredFlowNodeInstances,J as retryProcess,z as terminateProcess};

package/build/client/components/DynamicUi/DynamicUi.d.ts

@@ -1,6 +1,7 @@
 import React, { PropsWithChildren } from 'react';
 import { DataModels } from '@5minds/processcube_engine_sdk';
 import { UserTaskInstance } from '../../../common/types';
+import './DynamicUi.css';
 import { type DynamicUiFormFieldComponentMap } from './FormFields';
 interface DynamicUiForwardedRefRenderFunction extends React.ForwardRefRenderFunction<DynamicUiRefFunctions, DynamicUiComponentProps> {
     (props: DynamicUiComponentProps, ref: DynamicUiFormFieldRef): React.ReactNode;