@flusys/ng-shared 3.0.0 → 3.0.1

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@flusys/ng-shared",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "description": "Shared components and utilities for FLUSYS Angular packages",
   "license": "MIT",
   "peerDependencies": {
     "@angular/common": ">=21.0.0",
     "@angular/core": ">=21.0.0",
     "@angular/forms": ">=21.0.0",
-    "@flusys/ng-core": ">=3.0.0",
+    "@flusys/ng-core": ">=3.0.1",
     "@primeuix/themes": ">=1.0.0",
     "primeicons": ">=7.0.0",
     "primeng": ">=21.0.0"

package/types/flusys-ng-shared.d.ts

@@ -1,6 +1,6 @@
 import { Observable } from 'rxjs';
 import * as _angular_core from '@angular/core';
-import { Signal, Injector, ResourceRef, model, ElementRef, DestroyRef, InjectionToken } from '@angular/core';
+import { Signal, Injector, ResourceRef, model, OnDestroy, ElementRef, TemplateRef, DestroyRef, InjectionToken } from '@angular/core';
 import * as i1 from '@angular/common';
 import * as i2 from '@angular/forms';
 import { ControlValueAccessor } from '@angular/forms';
@@ -41,25 +41,18 @@ import * as i31 from 'primeng/tabs';
 import * as i32 from 'primeng/tag';
 import * as i33 from 'primeng/textarea';
 import * as i34 from 'primeng/toast';
-import * as i35 from 'primeng/toggleswitch';
-import * as i36 from 'primeng/tooltip';
-import * as i37 from 'primeng/treetable';
+import * as i35 from 'primeng/togglebutton';
+import * as i36 from 'primeng/toggleswitch';
+import * as i37 from 'primeng/tooltip';
+import * as i38 from 'primeng/treetable';
+import * as i39 from 'primeng/progressspinner';
+import * as i40 from 'primeng/colorpicker';
 import * as _flusys_ng_shared from '@flusys/ng-shared';
 import { HttpClient, HttpParams, HttpHeaders } from '@angular/common/http';
 import { FormValueControl } from '@angular/forms/signals';
 import { MessageService, ConfirmationService } from 'primeng/api';
 import * as _flusys_ng_core from '@flusys/ng-core';
 
-/**
- * Centralized Permission Codes
- *
- * Single source of truth for all permission codes used across the application.
- * Use these constants instead of hardcoded strings to prevent typos and enable easy refactoring.
- *
- * Naming Convention: <entity>.<action>
- * - entity: The resource being accessed (e.g., user, role, company)
- * - action: The operation being performed (create, read, update, delete, assign)
- */
 declare const USER_PERMISSIONS: {
     readonly CREATE: "user.create";
     readonly READ: "user.read";
@@ -142,9 +135,24 @@ declare const FORM_PERMISSIONS: {
     readonly UPDATE: "form.update";
     readonly DELETE: "form.delete";
 };
-/**
- * All permission codes grouped by module
- */
+declare const EVENT_PERMISSIONS: {
+    readonly CREATE: "event.create";
+    readonly READ: "event.read";
+    readonly UPDATE: "event.update";
+    readonly DELETE: "event.delete";
+};
+declare const EVENT_PARTICIPANT_PERMISSIONS: {
+    readonly CREATE: "event-participant.create";
+    readonly READ: "event-participant.read";
+    readonly UPDATE: "event-participant.update";
+    readonly DELETE: "event-participant.delete";
+};
+declare const NOTIFICATION_PERMISSIONS: {
+    readonly CREATE: "notification.create";
+    readonly READ: "notification.read";
+    readonly UPDATE: "notification.update";
+    readonly DELETE: "notification.delete";
+};
 declare const PERMISSIONS: {
     readonly USER: {
         readonly CREATE: "user.create";
@@ -228,6 +236,24 @@ declare const PERMISSIONS: {
         readonly UPDATE: "form.update";
         readonly DELETE: "form.delete";
     };
+    readonly EVENT: {
+        readonly CREATE: "event.create";
+        readonly READ: "event.read";
+        readonly UPDATE: "event.update";
+        readonly DELETE: "event.delete";
+    };
+    readonly EVENT_PARTICIPANT: {
+        readonly CREATE: "event-participant.create";
+        readonly READ: "event-participant.read";
+        readonly UPDATE: "event-participant.update";
+        readonly DELETE: "event-participant.delete";
+    };
+    readonly NOTIFICATION: {
+        readonly CREATE: "notification.create";
+        readonly READ: "notification.read";
+        readonly UPDATE: "notification.update";
+        readonly DELETE: "notification.delete";
+    };
 };
 type PermissionCode = (typeof PERMISSIONS)[keyof typeof PERMISSIONS][keyof (typeof PERMISSIONS)[keyof typeof PERMISSIONS]];
 
@@ -945,26 +971,15 @@ declare class AngularModule {
 
 declare class PrimeModule {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<PrimeModule, never>;
-    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<PrimeModule, never, never, [typeof i1$1.AutoCompleteModule, typeof i2$1.AvatarModule, typeof i3$1.ButtonModule, typeof i4.CardModule, typeof i5.CheckboxModule, typeof i6.ConfirmDialogModule, typeof i7.DatePickerModule, typeof i8.DialogModule, typeof i9.DividerModule, typeof i10.FileUploadModule, typeof i11.IconFieldModule, typeof i12.ImageModule, typeof i13.InputIconModule, typeof i14.InputNumberModule, typeof i15.InputTextModule, typeof i16.ListboxModule, typeof i17.MultiSelectModule, typeof i18.PaginatorModule, typeof i19.PanelModule, typeof i20.PasswordModule, typeof i21.PopoverModule, typeof i22.ProgressBarModule, typeof i23.RadioButtonModule, typeof i24.RippleModule, typeof i25.SelectButtonModule, typeof i26.SelectModule, typeof i27.SkeletonModule, typeof i28.SplitButtonModule, typeof i29.StepsModule, typeof i30.TableModule, typeof i31.TabsModule, typeof i32.TagModule, typeof i33.TextareaModule, typeof i34.ToastModule, typeof i35.ToggleSwitchModule, typeof i36.TooltipModule, typeof i37.TreeTableModule]>;
+    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<PrimeModule, never, never, [typeof i1$1.AutoCompleteModule, typeof i2$1.AvatarModule, typeof i3$1.ButtonModule, typeof i4.CardModule, typeof i5.CheckboxModule, typeof i6.ConfirmDialogModule, typeof i7.DatePickerModule, typeof i8.DialogModule, typeof i9.DividerModule, typeof i10.FileUploadModule, typeof i11.IconFieldModule, typeof i12.ImageModule, typeof i13.InputIconModule, typeof i14.InputNumberModule, typeof i15.InputTextModule, typeof i16.ListboxModule, typeof i17.MultiSelectModule, typeof i18.PaginatorModule, typeof i19.PanelModule, typeof i20.PasswordModule, typeof i21.PopoverModule, typeof i22.ProgressBarModule, typeof i23.RadioButtonModule, typeof i24.RippleModule, typeof i25.SelectButtonModule, typeof i26.SelectModule, typeof i27.SkeletonModule, typeof i28.SplitButtonModule, typeof i29.StepsModule, typeof i30.TableModule, typeof i31.TabsModule, typeof i32.TagModule, typeof i33.TextareaModule, typeof i34.ToastModule, typeof i35.ToggleButtonModule, typeof i36.ToggleSwitchModule, typeof i37.TooltipModule, typeof i38.TreeTableModule, typeof i39.ProgressSpinnerModule, typeof i40.ColorPickerModule]>;
     static ɵinj: _angular_core.ɵɵInjectorDeclaration<PrimeModule>;
 }
 
-/** Service names that can be used for feature-specific base URLs */
-type ServiceName = 'auth' | 'administration' | 'iam' | 'storage' | 'formBuilder' | 'email';
+type ServiceName = 'auth' | 'administration' | 'iam' | 'storage' | 'formBuilder' | 'email' | 'eventManager' | 'notification';
 
 /**
  * Service interface for CRUD operations.
- * Matches NestJS shared API controller endpoints:
- *
- * | Angular Method   | HTTP   | NestJS Endpoint        | Response Type          |
- * |------------------|--------|------------------------|------------------------|
- * | insert()         | POST   | /{resource}/insert     | ISingleResponse<T>     |
- * | insertMany()     | POST   | /{resource}/insert-many| IBulkResponse<T>       |
- * | findById()       | POST   | /{resource}/get/:id    | ISingleResponse<T>     |
- * | getAll()         | POST   | /{resource}/get-all    | IListResponse<T>       |
- * | update()         | POST   | /{resource}/update     | ISingleResponse<T>     |
- * | updateMany()     | POST   | /{resource}/update-many| IBulkResponse<T>       |
- * | delete()         | POST   | /{resource}/delete     | IMessageResponse       |
+ * Matches NestJS shared API controller endpoints (all POST, RPC-style).
  */
 interface IApiService<DtoT, InterfaceT> {
     insert(dto: DtoT): Observable<ISingleResponse<InterfaceT>>;
@@ -978,51 +993,15 @@ interface IApiService<DtoT, InterfaceT> {
 /**
  * Abstract base class for API services using Angular 21 resource() API.
  * Provides signal-based reactive data fetching with automatic loading states.
- * Response types match FLUSYS_NEST backend DTOs.
- *
- * ## Endpoint Mapping
- *
- * All endpoints use POST method (RPC-style API):
- * - `POST /{resource}/insert`       - Create single item
- * - `POST /{resource}/insert-many`  - Create multiple items
- * - `POST /{resource}/get/:id`      - Get single item by ID
- * - `POST /{resource}/get-all?q=`   - List with pagination/filter
- * - `POST /{resource}/update`       - Update single item
- * - `POST /{resource}/update-many`  - Update multiple items
- * - `POST /{resource}/delete`       - Delete/restore/permanent delete
  *
  * @example
  * ```typescript
- * // Define service with global apiBaseUrl
  * @Injectable({ providedIn: 'root' })
  * export class UserService extends ApiResourceService<UserDto, User> {
  *   constructor() {
  *     super('auth/users', inject(HttpClient));
  *   }
  * }
- *
- * // Define service with feature-specific baseUrl
- * @Injectable({ providedIn: 'root' })
- * export class FormService extends ApiResourceService<FormDto, Form> {
- *   constructor() {
- *     super('form', inject(HttpClient), 'formBuilder');
- *     // URL: services.formBuilder.baseUrl + '/form'
- *   }
- * }
- *
- * // In component - use signals
- * userService = inject(UserService);
- * users = this.userService.data;              // Signal<User[]>
- * isLoading = this.userService.isLoading;     // Signal<boolean>
- * total = this.userService.total;             // Signal<number>
- *
- * // Trigger fetch
- * this.userService.fetchList('search', { pagination: { currentPage: 0, pageSize: 10 } });
- *
- * // CRUD operations
- * await this.userService.insertAsync({ name: 'John', email: 'john@example.com' });
- * await this.userService.updateAsync({ id: '123', name: 'John Updated' });
- * await this.userService.deleteAsync({ id: '123', type: 'delete' });
  * ```
  */
 declare abstract class ApiResourceService<DtoT, InterfaceT> implements IApiService<DtoT, InterfaceT> {
@@ -1030,149 +1009,41 @@ declare abstract class ApiResourceService<DtoT, InterfaceT> implements IApiServi
     protected readonly injector: Injector;
     protected readonly http: HttpClient;
     protected readonly moduleApiName: string;
-    /** Current search term */
     readonly searchTerm: _angular_core.WritableSignal<string>;
-    /** Current filter and pagination state */
     readonly filterData: _angular_core.WritableSignal<IFilterData>;
-    /**
-     * Resource for list data - lazy initialized to prevent auto-fetch on service injection.
-     * Call initListResource() or any list method (fetchList, reload, etc.) to initialize.
-     */
     private _listResource;
-    /** Whether the list resource has been initialized */
     private _resourceInitialized;
-    /**
-     * Signal to track resource initialization for computed signals.
-     * This allows computed signals to re-evaluate when the resource is created.
-     * Without this, computed signals would not detect when _listResource changes from null.
-     */
     private readonly _resourceInitSignal;
-    /** Get or create the list resource (lazy initialization) */
     get listResource(): ResourceRef<IListResponse<InterfaceT> | undefined>;
-    /**
-     * Initialize the list resource. Called automatically when accessing listResource
-     * or any list-related computed signals/methods.
-     * Uses runInInjectionContext to support lazy initialization outside constructor.
-     */
     initListResource(): void;
-    /**
-     * Whether data is currently loading.
-     * Tracks _resourceInitSignal to re-evaluate when resource is created.
-     */
     readonly isLoading: _angular_core.Signal<boolean>;
-    /**
-     * List data array.
-     * Tracks _resourceInitSignal to re-evaluate when resource is created.
-     */
     readonly data: _angular_core.Signal<InterfaceT[]>;
-    /**
-     * Total count of items.
-     * Tracks _resourceInitSignal to re-evaluate when resource is created.
-     */
     readonly total: _angular_core.Signal<number>;
-    /**
-     * Pagination metadata.
-     * Tracks _resourceInitSignal to re-evaluate when resource is created.
-     */
     readonly pageInfo: _angular_core.Signal<_flusys_ng_shared.IPaginationMeta | undefined>;
-    /**
-     * Whether there are more pages.
-     * Tracks _resourceInitSignal to re-evaluate when resource is created.
-     */
     readonly hasMore: _angular_core.Signal<boolean>;
-    /**
-     * @param moduleApiName - The API resource path (e.g., 'form' for /form-builder/form)
-     * @param http - HttpClient instance
-     * @param serviceName - Optional service name for feature-specific base URL (e.g., 'formBuilder')
-     */
     constructor(moduleApiName: string, http: HttpClient, serviceName?: ServiceName);
     protected getHttpOptions(endpoint: string, params?: HttpParams): {
         params?: HttpParams | undefined;
         headers: HttpHeaders;
     };
-    /**
-     * Fetch list data (triggers resource initialization and reload)
-     */
     fetchList(search?: string, filter?: Partial<IFilterData>): void;
-    /**
-     * Update pagination
-     */
     setPagination(pagination: IPagination): void;
-    /**
-     * Go to next page
-     */
     nextPage(): void;
-    /**
-     * Reset to first page
-     */
     resetPagination(): void;
-    /**
-     * Reload current data
-     */
     reload(): void;
-    /**
-     * Insert single item (Observable)
-     * POST /{resource}/insert
-     */
     insert(dto: DtoT): Observable<ISingleResponse<InterfaceT>>;
-    /**
-     * Insert multiple items (Observable)
-     * POST /{resource}/insert-many
-     */
     insertMany(dtos: DtoT[]): Observable<IBulkResponse<InterfaceT>>;
-    /**
-     * Find single item by ID (Observable)
-     * POST /{resource}/get/:id
-     */
     findById(id: string, select?: string[]): Observable<ISingleResponse<InterfaceT>>;
-    /**
-     * Get all items with pagination (Observable)
-     * POST /{resource}/get-all?q=search
-     */
     getAll(search: string, filter: IFilterData): Observable<IListResponse<InterfaceT>>;
-    /**
-     * Update single item (Observable)
-     * POST /{resource}/update
-     */
     update(dto: DtoT): Observable<ISingleResponse<InterfaceT>>;
-    /**
-     * Update multiple items (Observable)
-     * POST /{resource}/update-many
-     */
     updateMany(dtos: DtoT[]): Observable<IBulkResponse<InterfaceT>>;
-    /**
-     * Delete items (Observable)
-     * POST /{resource}/delete
-     * @param deleteDto - { id: string | string[], type: 'delete' | 'restore' | 'permanent' }
-     */
     delete(deleteDto: IDeleteData): Observable<IMessageResponse>;
-    /**
-     * Fetch paginated list (async)
-     */
-    protected fetchAllAsync(search: string, filter: IFilterData): Promise<IListResponse<InterfaceT>>;
-    /**
-     * Find single item by ID (async)
-     */
+    getAllAsync(filter: IFilterData, search?: string): Promise<IListResponse<InterfaceT>>;
     findByIdAsync(id: string, select?: string[]): Promise<ISingleResponse<InterfaceT>>;
-    /**
-     * Insert single item (async)
-     */
     insertAsync(dto: DtoT): Promise<ISingleResponse<InterfaceT>>;
-    /**
-     * Insert multiple items (async)
-     */
     insertManyAsync(dtos: DtoT[]): Promise<IBulkResponse<InterfaceT>>;
-    /**
-     * Update single item (async)
-     */
     updateAsync(dto: DtoT): Promise<ISingleResponse<InterfaceT>>;
-    /**
-     * Update multiple items (async)
-     */
     updateManyAsync(dtos: DtoT[]): Promise<IBulkResponse<InterfaceT>>;
-    /**
-     * Delete items (async)
-     */
     deleteAsync(deleteDto: IDeleteData): Promise<IMessageResponse>;
 }
 
@@ -1282,11 +1153,13 @@ declare class IconComponent {
  * - Reactive forms: `[formControl]="ctrl"` or `formControlName="field"`
  * - Signal forms: `[formField]="formTree.field"`
  */
-declare class LazyMultiSelectComponent extends BaseFormControl<string[] | null> {
-    private readonly destroyRef;
+declare class LazyMultiSelectComponent extends BaseFormControl<string[] | null> implements OnDestroy {
+    private readonly document;
+    private readonly appRef;
     private readonly onDocumentClickBound;
-    private isDestroyed;
     readonly pSelectRef: _angular_core.Signal<ElementRef<HTMLDivElement>>;
+    readonly overlayTemplate: _angular_core.Signal<TemplateRef<unknown>>;
+    private overlayViewRef;
     readonly placeHolder: _angular_core.InputSignal<string>;
     readonly isEditMode: _angular_core.InputSignal<boolean>;
     readonly isLoading: _angular_core.InputSignal<boolean>;
@@ -1301,12 +1174,14 @@ declare class LazyMultiSelectComponent extends BaseFormControl<string[] | null>
     readonly selectedValueDisplay: _angular_core.Signal<string>;
     readonly isSelectAll: _angular_core.Signal<boolean>;
     constructor();
+    ngOnDestroy(): void;
     onScroll(event: Event): void;
-    onSelectClick(event: Event): void;
+    onSelectClick(): void;
+    private openOverlay;
+    private closeOverlay;
     onOverlayClick(event: Event): void;
     private handleDocumentClick;
     isSelected(data: IDropDown): boolean;
-    key(option: IDropDown): string;
     selectValue(event: CheckboxChangeEvent, option: IDropDown): void;
     changeSelectAll(event: CheckboxChangeEvent): void;
     clear(event: Event): void;
@@ -2037,5 +1912,5 @@ interface ScrollPaginationConfig {
  */
 declare function checkScrollPagination(event: Event, config: ScrollPaginationConfig): IPagination | null;
 
-export { ACTION_PERMISSIONS, AUTH_STATE_PROVIDER, AngularModule, ApiResourceService, ApiResourceService as ApiService, BRANCH_PERMISSIONS, BaseFormControl, BaseFormPage, BaseListPage, BaseUserSelectComponent, COMPANY_ACTION_PERMISSIONS, COMPANY_API_PROVIDER, COMPANY_PERMISSIONS, ContactTypeEnum, CookieService, EMAIL_CONFIG_PERMISSIONS, EMAIL_TEMPLATE_PERMISSIONS, EditModeElementChangerDirective, FILE_PERMISSIONS, FILE_TYPE_FILTERS, FOLDER_PERMISSIONS, FORM_PERMISSIONS, FileSelectorDialogComponent, FileUploaderComponent, FileUrlService, HasPermissionDirective, IconComponent, IconTypeEnum, IsEmptyImageDirective, LazyMultiSelectComponent, LazySelectComponent, PERMISSIONS, PROFILE_PERMISSION_PROVIDER, PROFILE_UPLOAD_PROVIDER, PermissionValidatorService, PlatformService, PreventDefaultDirective, PrimeModule, ROLE_ACTION_PERMISSIONS, ROLE_PERMISSIONS, STORAGE_CONFIG_PERMISSIONS, USER_ACTION_PERMISSIONS, USER_LIST_PROVIDER, USER_PERMISSIONS, USER_PERMISSION_PROVIDER, USER_PROVIDER, USER_ROLE_PERMISSIONS, UserMultiSelectComponent, UserSelectComponent, allPermissionsGuard, anyPermissionGuard, checkScrollPagination, evaluateLogicNode, evaluatePermission, formatFileSize, getAcceptString, getFileIconClass, hasAllPermissions, hasAnyPermission, hasPermission, isFileTypeAllowed, permissionGuard, provideValueAccessor };
+export { ACTION_PERMISSIONS, AUTH_STATE_PROVIDER, AngularModule, ApiResourceService, ApiResourceService as ApiService, BRANCH_PERMISSIONS, BaseFormControl, BaseFormPage, BaseListPage, BaseUserSelectComponent, COMPANY_ACTION_PERMISSIONS, COMPANY_API_PROVIDER, COMPANY_PERMISSIONS, ContactTypeEnum, CookieService, EMAIL_CONFIG_PERMISSIONS, EMAIL_TEMPLATE_PERMISSIONS, EVENT_PARTICIPANT_PERMISSIONS, EVENT_PERMISSIONS, EditModeElementChangerDirective, FILE_PERMISSIONS, FILE_TYPE_FILTERS, FOLDER_PERMISSIONS, FORM_PERMISSIONS, FileSelectorDialogComponent, FileUploaderComponent, FileUrlService, HasPermissionDirective, IconComponent, IconTypeEnum, IsEmptyImageDirective, LazyMultiSelectComponent, LazySelectComponent, NOTIFICATION_PERMISSIONS, PERMISSIONS, PROFILE_PERMISSION_PROVIDER, PROFILE_UPLOAD_PROVIDER, PermissionValidatorService, PlatformService, PreventDefaultDirective, PrimeModule, ROLE_ACTION_PERMISSIONS, ROLE_PERMISSIONS, STORAGE_CONFIG_PERMISSIONS, USER_ACTION_PERMISSIONS, USER_LIST_PROVIDER, USER_PERMISSIONS, USER_PERMISSION_PROVIDER, USER_PROVIDER, USER_ROLE_PERMISSIONS, UserMultiSelectComponent, UserSelectComponent, allPermissionsGuard, anyPermissionGuard, checkScrollPagination, evaluateLogicNode, evaluatePermission, formatFileSize, getAcceptString, getFileIconClass, hasAllPermissions, hasAnyPermission, hasPermission, isFileTypeAllowed, permissionGuard, provideValueAccessor };
 export type { ApiResponse, DeleteType, FilesResponseDto, GetFileUrlsFn, IActionNode, IActivatable, IApiService, IAuthStateProvider, IBaseEntity, IBulkMeta, IBulkResponse, ICompanyApiProvider, ICompanyBasicInfo, IDeleteData, IDropDown, IErrorResponse, IFileBasicInfo, IFileData, IFileSelectFilter, IFileUploadOptions, IFilter, IFilterData, IGroupNode, IListResponse, ILoggedUserInfo, ILogicNode, ILoginResponse, ILoginUserData, IMessageResponse, IMetadata, IOrderable, IPagination, IPaginationMeta, IProfileActionInfo, IProfilePermissionProvider, IProfileRoleInfo, IProfileUploadOptions, IProfileUploadProvider, IProfileUploadResult, IRefreshTokenResponse, IRequestMeta, ISingleResponse, ISoftDeletable, ISort, ITimestampable, IUploadedFile, IUserBasicInfo, IUserBranchPayload, IUserBranchPermission, IUserCompanyPayload, IUserListAction, IUserListColumn, IUserListFilter, IUserListItem, IUserListProvider, IUserPermissionProvider, IUserProvider, IUserSelectFilter, IValidationError, LoadFilesFn, LoadUsersFn, PermissionCode, ScrollPaginationConfig, ServiceName, UploadFileFn };