@codex-ts/core-lib 1.1.6 → 2.0.0

package/fesm2022/codex-ts-core-lib.mjs

@@ -1516,6 +1516,11 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.11", ngImpo
  * Base component for all task dashboard components in the application.
  * Provides common functionality for task management operations while
  * inheriting table functionality from BaseTableComponent.
+ *
+ * @deprecated Depends on {@link TaskEntityService}, which targets a Java controller
+ * (`BaseTaskController`) that no longer exists — see that interface's `@deprecated` note. Build
+ * queue/dashboard UIs against `WorkflowEngineApiService` from `workflow-engine/` instead, which
+ * targets `workflow-engine-lib`'s actual `/workflow/queue` endpoints.
  */
 class BaseTaskDashboardComponent extends BaseTableComponent {
     entityService;
@@ -2427,7 +2432,10 @@ class KeycloakAuthInterceptor {
             });
             return next.handle(authReq);
         }), catchError((error) => {
-            if (error.status === 401 || error.status === 403) {
+            // Only re-authenticate on 401 (missing/expired credentials). A 403 means the
+            // user IS authenticated but lacks permission — re-login won't grant it and
+            // would needlessly discard app state, so let the app handle 403 itself.
+            if (error.status === 401) {
                 this.keycloakService.login();
             }
             return throwError(() => error);
@@ -2617,10 +2625,22 @@ class HttpUtilityService {
     messageService;
     loading = new BehaviorSubject(false);
     loading$ = this.loading.asObservable();
+    // Reference count of in-flight requests. A single boolean flag was buggy: when
+    // concurrent requests overlapped, the first to finish flipped loading to false
+    // while others were still running. Emit loading = (inFlight > 0) instead.
+    inFlight = 0;
     constructor(http, messageService) {
         this.http = http;
         this.messageService = messageService;
     }
+    startLoading() {
+        this.inFlight++;
+        this.loading.next(this.inFlight > 0);
+    }
+    endLoading() {
+        this.inFlight = Math.max(0, this.inFlight - 1);
+        this.loading.next(this.inFlight > 0);
+    }
     /**
      * Perform a GET request with enhanced options
      * @param url The endpoint URL
@@ -2628,7 +2648,7 @@ class HttpUtilityService {
      * @returns An observable of the response
      */
     get(url, options) {
-        this.loading.next(true);
+        this.startLoading();
         let request$ = this.http.get(url, {
             params: options?.params,
             headers: options?.headers,
@@ -2641,7 +2661,7 @@ class HttpUtilityService {
         if (options?.timeoutMs) {
             request$ = request$.pipe(timeout(options.timeoutMs));
         }
-        return request$.pipe(catchError$1(this.handleError.bind(this)), finalize$1(() => this.loading.next(false)));
+        return request$.pipe(catchError$1(this.handleError.bind(this)), finalize$1(() => this.endLoading()));
     }
     /**
      * Perform a POST request with enhanced options
@@ -2651,7 +2671,7 @@ class HttpUtilityService {
      * @returns An observable of the response
      */
     post(url, body, options) {
-        this.loading.next(true);
+        this.startLoading();
         let request$ = this.http.post(url, body, {
             params: options?.params,
             headers: options?.headers,
@@ -2664,7 +2684,7 @@ class HttpUtilityService {
         if (options?.timeoutMs) {
             request$ = request$.pipe(timeout(options.timeoutMs));
         }
-        return request$.pipe(catchError$1(this.handleError.bind(this)), finalize$1(() => this.loading.next(false)));
+        return request$.pipe(catchError$1(this.handleError.bind(this)), finalize$1(() => this.endLoading()));
     }
     /**
      * Perform a PUT request with enhanced options
@@ -2674,7 +2694,7 @@ class HttpUtilityService {
      * @returns An observable of the response
      */
     put(url, body, options) {
-        this.loading.next(true);
+        this.startLoading();
         let request$ = this.http.put(url, body, {
             params: options?.params,
             headers: options?.headers,
@@ -2687,7 +2707,7 @@ class HttpUtilityService {
         if (options?.timeoutMs) {
             request$ = request$.pipe(timeout(options.timeoutMs));
         }
-        return request$.pipe(catchError$1(this.handleError.bind(this)), finalize$1(() => this.loading.next(false)));
+        return request$.pipe(catchError$1(this.handleError.bind(this)), finalize$1(() => this.endLoading()));
     }
     /**
      * Perform a PATCH request with enhanced options
@@ -2697,7 +2717,7 @@ class HttpUtilityService {
      * @returns An observable of the response
      */
     patch(url, body, options) {
-        this.loading.next(true);
+        this.startLoading();
         let request$ = this.http.patch(url, body, {
             params: options?.params,
             headers: options?.headers,
@@ -2710,7 +2730,7 @@ class HttpUtilityService {
         if (options?.timeoutMs) {
             request$ = request$.pipe(timeout(options.timeoutMs));
         }
-        return request$.pipe(catchError$1(this.handleError.bind(this)), finalize$1(() => this.loading.next(false)));
+        return request$.pipe(catchError$1(this.handleError.bind(this)), finalize$1(() => this.endLoading()));
     }
     /**
      * Perform a DELETE request with enhanced options
@@ -2719,7 +2739,7 @@ class HttpUtilityService {
      * @returns An observable of the response
      */
     delete(url, options) {
-        this.loading.next(true);
+        this.startLoading();
         let request$ = this.http.delete(url, {
             params: options?.params,
             headers: options?.headers,
@@ -2732,7 +2752,7 @@ class HttpUtilityService {
         if (options?.timeoutMs) {
             request$ = request$.pipe(timeout(options.timeoutMs));
         }
-        return request$.pipe(catchError$1(this.handleError.bind(this)), finalize$1(() => this.loading.next(false)));
+        return request$.pipe(catchError$1(this.handleError.bind(this)), finalize$1(() => this.endLoading()));
     }
     /**
      * Upload a file with optional additional data
@@ -2743,7 +2763,7 @@ class HttpUtilityService {
      * @returns An observable of the response
      */
     uploadFile(url, file, additionalData, options) {
-        this.loading.next(true);
+        this.startLoading();
         const formData = new FormData();
         formData.append('file', file, file.name);
         if (additionalData) {
@@ -2786,16 +2806,16 @@ class HttpUtilityService {
                     },
                     error: (error) => {
                         observer.error(this.handleError(error));
-                        this.loading.next(false);
+                        this.endLoading();
                     },
                     complete: () => {
-                        this.loading.next(false);
+                        this.endLoading();
                     }
                 });
             });
         }
         // Standard request without progress tracking
-        return request$.pipe(catchError$1(this.handleError.bind(this)), finalize$1(() => this.loading.next(false)));
+        return request$.pipe(catchError$1(this.handleError.bind(this)), finalize$1(() => this.endLoading()));
     }
     /**
      * Execute multiple HTTP requests in parallel
@@ -2803,8 +2823,8 @@ class HttpUtilityService {
      * @returns An observable that emits when all requests complete
      */
     batchRequests(requests) {
-        this.loading.next(true);
-        return forkJoin(requests).pipe(catchError$1(this.handleError.bind(this)), finalize$1(() => this.loading.next(false)));
+        this.startLoading();
+        return forkJoin(requests).pipe(catchError$1(this.handleError.bind(this)), finalize$1(() => this.endLoading()));
     }
     /**
      * Download a file from the server
@@ -2813,7 +2833,7 @@ class HttpUtilityService {
      * @param options Additional request options
      */
     downloadFile(url, filename, options) {
-        this.loading.next(true);
+        this.startLoading();
         let request$ = this.http.get(url, {
             params: options?.params,
             headers: options?.headers,
@@ -2823,7 +2843,7 @@ class HttpUtilityService {
         if (options?.timeoutMs) {
             request$ = request$.pipe(timeout(options.timeoutMs));
         }
-        return request$.pipe(catchError$1(this.handleError.bind(this)), finalize$1(() => this.loading.next(false)));
+        return request$.pipe(catchError$1(this.handleError.bind(this)), finalize$1(() => this.endLoading()));
     }
     /**
      * Create parameter string from an object
@@ -2917,6 +2937,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.11", ngImpo
 /**
  * Base service for task-related operations that extends the BaseCrudService.
  * Implements endpoints defined in Java BaseTaskController.
+ *
+ * @deprecated `BaseTaskController` (the Java controller this service's `sendEvent`/`PUT
+ * /{uuid}/event/{event}` call targets) no longer exists — it was deleted along with
+ * `microservice-starter-lib`'s Spring-State-Machine-based workflow subsystem in favor of
+ * `workflow-engine-lib`. Calling `sendEvent` against any current backend will 404. Use
+ * `WorkflowEngineApiService` from `workflow-engine/` instead, which targets the actual current
+ * engine API (`claim`/`unclaim`/`start`/`complete`/`reject`/`reassign` on `/workflow/tasks`).
  */
 class BaseTaskService extends BaseEntityService {
     httpUtility;
@@ -4639,6 +4666,198 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.11", ngImpo
     `, styles: [":host{display:block;min-height:100vh;background-color:var(--surface-ground)}\n"] }]
         }] });
 
+/**
+ * Types mirroring `workflow-engine-lib`'s REST contract (`WorkflowDtos.java`), field-for-field.
+ *
+ * This is a separate concept from this library's older `Workflow`/`BaseTask` models, which
+ * targeted a different, now-removed Java controller (`microservice-starter-lib`'s
+ * Spring-State-Machine-based `BaseWorkflowController`/`BaseTaskController`, deleted in favor of
+ * `workflow-engine-lib`). See those models' `@deprecated` notices for the distinction.
+ */
+/** The group name whose attributes belong in the queue row rather than a detail panel. */
+const WORKFLOW_PRIMARY_GROUP = 'primary';
+
+/**
+ * Client for `workflow-engine-lib`'s REST API — the data-driven engine that replaced
+ * `microservice-starter-lib`'s Spring-State-Machine-based workflow subsystem.
+ *
+ * Follows this library's established DI convention (see {@link BaseEntityService}): not
+ * `providedIn: 'root'`, constructed with the backend base URL by the consuming application —
+ * *
+ * ```ts
+ * providers: [{
+ *   provide: WorkflowEngineApiService,
+ *   useFactory: (http: HttpUtilityService, utils: UtilsService, msg: MessageService) =>
+ *     new WorkflowEngineApiService(http, utils, 'https://api.example.com/workflow', msg),
+ *   deps: [HttpUtilityService, UtilsService, MessageService],
+ * }]
+ * ```
+ *
+ * Every method maps one-to-one onto an engine endpoint; nothing here is business-specific.
+ *
+ * Deliberately not decorated with {@code @Injectable()} — like {@link BaseEntityService}, this
+ * class is always provided via an explicit `useFactory`/`useClass` provider (see above), never
+ * auto-constructed by Angular's injector, so its constructor isn't required to be fully
+ * DI-resolvable (`backendBaseUrl: string` isn't a valid injection token on its own).
+ */
+class WorkflowEngineApiService {
+    httpUtility;
+    utilsService;
+    backendBaseUrl;
+    messageService;
+    apiUrl;
+    /**
+     * Creates the client.
+     *
+     * @param httpUtility     HTTP requests, loading state, standardised error handling
+     * @param utilsService    UUID validation
+     * @param backendBaseUrl  base URL of the service hosting `workflow-engine-lib`, e.g.
+     *                        `https://api.example.com/workflow`
+     * @param messageService  optional, shown on client-side validation failures
+     */
+    constructor(httpUtility, utilsService, backendBaseUrl, messageService) {
+        this.httpUtility = httpUtility;
+        this.utilsService = utilsService;
+        this.backendBaseUrl = backendBaseUrl;
+        this.messageService = messageService;
+        this.apiUrl = backendBaseUrl.replace(/\/+$/, '');
+    }
+    requireUuid(value) {
+        if (this.utilsService.isValidUUID(value)) {
+            return null;
+        }
+        this.utilsService.showError('Invalid UUID format', this.messageService);
+        return throwError(() => new Error('Invalid UUID format'));
+    }
+    // ---------------------------------------------------------------- tasks
+    /** Finds a task by id. `GET /tasks/{id}` */
+    getTask(id) {
+        return this.requireUuid(id) ?? this.httpUtility.get(`${this.apiUrl}/tasks/${id}`);
+    }
+    /** Claims a task out of a shared queue. `POST /tasks/{id}/claim` */
+    claimTask(id) {
+        return this.requireUuid(id) ?? this.httpUtility.post(`${this.apiUrl}/tasks/${id}/claim`, {});
+    }
+    /** Releases a claim, returning the task to its queue. `POST /tasks/{id}/unclaim` */
+    unclaimTask(id) {
+        return this.requireUuid(id) ?? this.httpUtility.post(`${this.apiUrl}/tasks/${id}/unclaim`, {});
+    }
+    /** Marks work on a task as actively started. `POST /tasks/{id}/start` */
+    startTask(id) {
+        return this.requireUuid(id) ?? this.httpUtility.post(`${this.apiUrl}/tasks/${id}/start`, {});
+    }
+    /** Completes a task and resumes its workflow. `POST /tasks/{id}/complete` */
+    completeTask(id, request = {}) {
+        return this.requireUuid(id) ?? this.httpUtility.post(`${this.apiUrl}/tasks/${id}/complete`, request);
+    }
+    /** Rejects a task, resuming its workflow down a different path. `POST /tasks/{id}/reject` */
+    rejectTask(id, request = {}) {
+        return this.requireUuid(id) ?? this.httpUtility.post(`${this.apiUrl}/tasks/${id}/reject`, request);
+    }
+    /** Reassigns a task to a different subject. `POST /tasks/{id}/reassign` */
+    reassignTask(id, request) {
+        return this.requireUuid(id) ?? this.httpUtility.post(`${this.apiUrl}/tasks/${id}/reassign`, request);
+    }
+    // ---------------------------------------------------------------- instances
+    /** Starts a new workflow instance. `POST /instances` */
+    startInstance(request) {
+        return this.httpUtility.post(`${this.apiUrl}/instances`, request);
+    }
+    /** Finds an instance by id. `GET /instances/{id}` */
+    getInstance(id) {
+        return this.requireUuid(id) ?? this.httpUtility.get(`${this.apiUrl}/instances/${id}`);
+    }
+    /** Finds instances by business key. `GET /instances?businessKey=...` */
+    findInstancesByBusinessKey(businessKey) {
+        return this.httpUtility.get(`${this.apiUrl}/instances`, {
+            params: { businessKey },
+        });
+    }
+    /** Loads an instance's audit history, oldest first. `GET /instances/{id}/history` */
+    instanceHistory(id) {
+        return this.requireUuid(id) ?? this.httpUtility.get(`${this.apiUrl}/instances/${id}/history`);
+    }
+    /** Reads an instance's current variables. `GET /instances/{id}/variables` */
+    getInstanceVariables(id) {
+        return this.requireUuid(id) ?? this.httpUtility.get(`${this.apiUrl}/instances/${id}/variables`);
+    }
+    /** Sets or replaces instance variables outside of any node execution. `PUT /instances/{id}/variables` */
+    setInstanceVariables(id, request) {
+        return this.requireUuid(id) ?? this.httpUtility.put(`${this.apiUrl}/instances/${id}/variables`, request);
+    }
+    /** Signals an external event to a waiting instance. `POST /instances/{id}/signal` */
+    signalInstance(id, request) {
+        return this.requireUuid(id) ?? this.httpUtility.post(`${this.apiUrl}/instances/${id}/signal`, request);
+    }
+    /** Cancels a running instance and withdraws its open tasks. `POST /instances/{id}/cancel` */
+    cancelInstance(id, request = {}) {
+        return this.requireUuid(id) ?? this.httpUtility.post(`${this.apiUrl}/instances/${id}/cancel`, request);
+    }
+    // ---------------------------------------------------------------- definitions
+    /** Deploys a workflow definition, creating a new immutable version. `POST /definitions` */
+    deployDefinition(request) {
+        return this.httpUtility.post(`${this.apiUrl}/definitions`, request);
+    }
+    /** Lists every workflow definition. `GET /definitions` */
+    listDefinitions() {
+        return this.httpUtility.get(`${this.apiUrl}/definitions`);
+    }
+    /** Finds a definition by key. `GET /definitions/{key}` */
+    getDefinition(key) {
+        return this.httpUtility.get(`${this.apiUrl}/definitions/${key}`);
+    }
+    /** Lists every deployed version of a definition. `GET /definitions/{key}/versions` */
+    listVersions(key) {
+        return this.httpUtility.get(`${this.apiUrl}/definitions/${key}/versions`);
+    }
+    /** Loads the active version's authored document. `GET /definitions/{key}/versions/active` */
+    activeVersion(key) {
+        return this.httpUtility.get(`${this.apiUrl}/definitions/${key}/versions/active`);
+    }
+    /** Activates a specific version. `POST /definitions/{key}/versions/{versionNumber}/activate` */
+    activateVersion(key, versionNumber) {
+        return this.httpUtility.post(`${this.apiUrl}/definitions/${key}/versions/${versionNumber}/activate`, {});
+    }
+    // ---------------------------------------------------------------- queue
+    /** Loads one of the queue views. `GET /queue/{view}` */
+    queue(view, page = 0, size = 20) {
+        return this.httpUtility.get(`${this.apiUrl}/queue/${view}`, {
+            params: { page, size },
+        });
+    }
+    /** Searches the queue with structured criteria. `POST /queue/search` */
+    searchQueue(criteria = {}, page = 0, size = 20) {
+        return this.httpUtility.post(`${this.apiUrl}/queue/search`, criteria, {
+            params: { page, size },
+        });
+    }
+    // ---------------------------------------------------------------- business objects
+    /** Registers a business object type, or updates one with the same code. `POST /business-objects` */
+    registerBusinessObject(request) {
+        return this.httpUtility.post(`${this.apiUrl}/business-objects`, request);
+    }
+    /** Lists every registered business object. `GET /business-objects` */
+    listBusinessObjects() {
+        return this.httpUtility.get(`${this.apiUrl}/business-objects`);
+    }
+    /** Finds one business object, including the workflows bound to it. `GET /business-objects/{code}` */
+    getBusinessObject(code) {
+        return this.httpUtility.get(`${this.apiUrl}/business-objects/${code}`);
+    }
+    /** Registers a new version of a form under a business object. `POST /business-objects/{code}/forms` */
+    registerForm(code, request) {
+        return this.httpUtility.post(`${this.apiUrl}/business-objects/${code}/forms`, request);
+    }
+    /** Lists every form registered under a business object. `GET /business-objects/{code}/forms` */
+    listForms(code) {
+        return this.httpUtility.get(`${this.apiUrl}/business-objects/${code}/forms`);
+    }
+    /** Finds the active form version a new task would render. `GET /business-objects/{code}/forms/{formKey}` */
+    activeForm(code, formKey) {
+        return this.httpUtility.get(`${this.apiUrl}/business-objects/${code}/forms/${formKey}`);
+    }
+}
+
 /*
  * Public API Surface of core-lib
  */
@@ -4648,5 +4867,5 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.11", ngImpo
  * Generated bundle index. Do not edit.
  */
 
-export { AppConstants, AppMessages, BaseEntityService, BaseErrorService, BaseFormComponent, BaseListPageComponent, BaseListTabbedFormComponent, BasePageComponent, BaseTabbedFormComponent, BaseTableComponent, BaseTaskDashboardComponent, BaseTaskDetailsComponent, BaseTaskService, CommonValidators, ComponentContext, CoreFormlyModule, ERROR_SERVICE, EntityRegistryService, EnumRegistryService, FORMLY_TYPES, FORMLY_WRAPPERS, FormFieldWrapper, FormService, FormlyConfigService, HttpUtilityService, IndianDatePipe, KEYCLOAK_CONFIG, KEYCLOAK_SERVICE, KeycloakAuthGuard, KeycloakErrorPageComponent, KeycloakService, NotFoundComponent, NotificationService, PrimeNGFormlyModule, ReferenceDataProviderService, TabbedFormType, TableColumnDatatype, TaskRole, UnauthorizedComponent, UtilsService, provideKeycloak };
+export { AppConstants, AppMessages, BaseEntityService, BaseErrorService, BaseFormComponent, BaseListPageComponent, BaseListTabbedFormComponent, BasePageComponent, BaseTabbedFormComponent, BaseTableComponent, BaseTaskDashboardComponent, BaseTaskDetailsComponent, BaseTaskService, CommonValidators, ComponentContext, CoreFormlyModule, ERROR_SERVICE, EntityRegistryService, EnumRegistryService, FORMLY_TYPES, FORMLY_WRAPPERS, FormFieldWrapper, FormService, FormlyConfigService, HttpUtilityService, IndianDatePipe, KEYCLOAK_CONFIG, KEYCLOAK_SERVICE, KeycloakAuthGuard, KeycloakErrorPageComponent, KeycloakService, NotFoundComponent, NotificationService, PrimeNGFormlyModule, ReferenceDataProviderService, TabbedFormType, TableColumnDatatype, TaskRole, UnauthorizedComponent, UtilsService, WORKFLOW_PRIMARY_GROUP, WorkflowEngineApiService, provideKeycloak };
 //# sourceMappingURL=codex-ts-core-lib.mjs.map