@flusys/ng-shared 8.1.4 → 9.0.0

package/README.md

@@ -77,6 +77,29 @@ Available CRUD methods: `insert`, `insertMany`, `findById`, `findByIds`, `getAll
 
 ---
 
+A subclass that needs its own endpoint on the same controller calls the protected `post<R>(endpoint, body)`
+helper, which adds the base URL and the loader tag:
+
+```typescript
+publish(id: string): Promise<ISingleResponse<IProduct>> {
+  return this.post('publish', { id });
+}
+```
+
+### Error toasts
+
+`errorCatchingInterceptor` shows every failed request as a toast (skipping 401, 403, `check-login` and
+requests sent with `SKIP_ERROR_TOAST`). The message is translated with `translateRef`, so a
+`messageVariables` entry that is itself a message ref (`{ problem: { messageKey, messageVariables } }`)
+is translated too. A catch block that wants its own message only for failures the user has not seen
+yet uses `isErrorToastShown(error)`:
+
+```typescript
+} catch (error) {
+  if (!isErrorToastShown(error)) this.messages.add({ severity: 'error', summary: this.translate.translate('x.save.failed') });
+}
+```
+
 ## 2. FileUrlService — Presigned URL Fetching
 
 Never construct file URLs manually. `FileUrlService` handles S3/Azure presigned URLs, caching, and deduplication.
@@ -154,12 +177,30 @@ All three guards redirect to `/` by default. Pass a second argument to change it
 
 ---
 
-## 5. TranslatePipe
+## 5. Action pickers + ACTION_PROVIDER
+
+`<lib-action-select>` (one code) and `<lib-action-multi-select>` (a list of codes) pick permission action codes for any "permission required" field, so feature packages never hand-type codes or import ng-iam.
+
+```html
+<lib-action-select inputId="permission" [(value)]="permissionCode" [placeholder]="defaultCode" />
+<lib-action-multi-select inputId="actionGroups" [(value)]="actionGroups" />
+```
+
+- Lists actions from the optional `ACTION_PROVIDER` token (`IActionProvider.getActions()` → flat `IActionBasicInfo[]` with `parentId` / `serial`); `provideIamProviders()` from `@flusys/ng-iam` wires it.
+- Both render an `f-treeselect` of the action hierarchy, ordered by `serial` then name. Actions without a `code` are groups: they expand but can't be picked, and a group with nothing pickable under it is hidden. The multi picker uses checkboxes that do not cascade, so ticking a node picks only that code. Search matches name or code.
+- Without a provider (IAM not installed) they fall back to typing codes: a text input, or chips added with Enter for the multi picker.
+- A saved code that is not an action stays selectable, so older or default codes still show.
+
+---
+
+## 6. TranslatePipe
 
 ```html
 {{ 'shared.save' | translate }} {{ 'pagination.showing' | translate: { from: 1, to: 10 } }}
 ```
 
+The pipe also accepts a backend message reference (`IMessageRef`: `{ messageKey, messageVariables? }`), e.g. `{{ plan.warnings[0] | translate }}`. `TranslateService.translateRef(ref)` does the same in code and translates variables that are themselves references first. `errorToMessageRef(error, fallbackKey?)` (`@flusys/ng-shared`) turns a failed HTTP call into a reference from the response's `messageKey`/`messageVariables`.
+
 ## License
 
 MIT © FLUSYS