@cauca-911/management 22.0.3 → 22.0.5

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@cauca-911/management",
-  "version": "22.0.3",
+  "version": "22.0.5",
   "peerDependencies": {
     "@angular/common": ">=22.1.0",
     "@angular/core": ">=22.1.0",
     "@cauca-911/core": ">=22.0.0",
     "@cauca-911/datagrid": ">=22.0.0",
-    "@cauca-911/devextreme": ">=22.0.0",
     "@cauca-911/material": ">=22.0.0",
+    "ngx-mat-select-search": ">=9.0.0",
     "odata-filter-builder": ">=1.0.0"
   },
   "homepage": "https://cauca.ca",

package/types/cauca-911-management.d.ts

@@ -4,8 +4,9 @@ import { Routes } from '@angular/router';
 import { OnDeactivate } from '@cauca-911/material';
 import { ODataFilter } from 'odata-data-source';
 import { BaseGridColumnComponent } from '@cauca-911/datagrid';
-import { HttpClient } from '@angular/common/http';
+import { Schema, FieldTree, FormValueControl, ValidationError } from '@angular/forms/signals';
 import { Observable } from 'rxjs';
+import { FormControl } from '@angular/forms';
 
 declare const MANAGEMENT_URL_PREFIX: InjectionToken<string>;
 declare const MANAGEMENT_ROUTE_SEGMENT: InjectionToken<string>;
@@ -113,6 +114,8 @@ interface UserGridColumn {
     showToolTip?: boolean;
     /** `scope` only: the key shown in place of the list when the row covers everything. */
     allLabel?: string;
+    /** Whether the column starts visible when the user has no stored configuration. Defaults to true. */
+    visibleByDefault?: boolean;
 }
 
 /** The shape every site's `UserList` feed shares. Site-specific columns arrive as extra properties. */
@@ -150,8 +153,12 @@ declare class UsersPageComponent {
 
 declare class UserListGridComponent implements OnInit {
     /**
-     * Read when the grid registers its columns, in `ngAfterContentInit`. Replacing the list
-     * afterwards renders nothing: the new columns are never registered with the MatTable.
+     * Read when the grid registers its columns, in `ngAfterContentInit`. Changing it afterwards
+     * recomputes `columns()` but does not re-run `applyColumns()`, so the MatTable is asked to
+     * render a column id it never registered and throws `Could not find column with id "X"`.
+     * `showPermissions`, `canEdit` and `canDelete` gate the row-action column the same way and
+     * carry the same constraint — and are the more likely one to hit, since a consumer binds them
+     * to an async permission signal more readily than it replaces the column list.
      */
     readonly extraColumns: _angular_core.InputSignal<UserGridColumn[]>;
     readonly showAddButton: _angular_core.InputSignal<boolean>;
@@ -193,189 +200,118 @@ declare class ScopeListGridColumnComponent extends BaseGridColumnComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ScopeListGridColumnComponent, "cauca-scope-list-grid-column", never, { "allLabel": { "alias": "allLabel"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-declare class CaucaManagementService {
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CaucaManagementService, never>;
-    static ɵprov: _angular_core.ɵɵInjectableDeclaration<CaucaManagementService>;
-}
-
-declare class CaucaManagementComponent {
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CaucaManagementComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CaucaManagementComponent, "cauca-management", never, {}, {}, never, never, true, never>;
-}
-
-/**
- * @deprecated This model is obsolete and should not be used.
- */
-declare class UserGroupModel {
-    idUserGroup: string;
-    idGroup: string;
-    idUser: string;
-}
-
-/**
- * @deprecated This model is obsolete and should not be used.
- */
-declare class UserPermissionModel {
-    idUserPermission: string;
-    isAllowed: boolean;
-    idUser: string;
-    idModulePermission: string;
-}
-
-/**
- * @deprecated This model is obsolete and should not be used.
- */
-declare class UserModel {
-    id: string;
+interface UserLoginForEdition {
     userName: string;
+    password: string;
+    twoFactorAuthenticatorEnabled: boolean;
+}
+interface UserPersonalInformationForEdition {
     firstName: string;
     lastName: string;
-    password: string;
     email: string;
-    isActive: boolean;
-    groups: UserGroupModel[];
-    permissions: UserPermissionModel[];
-    twoFactorAuthenticatorEnabled: boolean;
+    phoneNumber: string;
 }
-
-/**
- * @deprecated This model is obsolete and should not be used.
- */
-declare class GroupPermissionModel {
-    idGroupPermission: string;
-    isAllowed: boolean;
-    idGroup: string;
-    idModulePermission: string;
+interface UserForEditionBase {
+    id: string;
+    login: UserLoginForEdition;
+    personalInformation: UserPersonalInformationForEdition;
+    groupIds: string[];
 }
+/** What creation sends as the identifier. */
+declare const EmptyUserId = "00000000-0000-0000-0000-000000000000";
+declare function createEmptyUserForEdition(): UserForEditionBase;
 
-/**
- * @deprecated This model is obsolete and should not be used.
- */
-declare class GroupModel {
-    id: string;
-    name: string;
-    users: UserGroupModel[];
-    permissions: GroupPermissionModel[];
-    assignableByAllUsers: boolean;
+interface UserLoginSchemaOptions {
+    /**
+     * Whether this is a creation — the password rule is required only then.
+     *
+     * A consumer binding `cauca-user-login-fields` must pass this same value to that component's
+     * own `isNew` input; nothing here checks the two agree, and a mismatch shows the password as
+     * optional (or required) without matching what actually gets validated.
+     *
+     * Never add a `disabled()` rule to the password field based on this or any other condition:
+     * `cauca-password-selection`'s `setDisabledState(true)` disables its inner form group, which
+     * makes the group invalid and fires `onChange('')`, silently wiping the stored password.
+     */
+    readonly isNew: () => boolean;
+    /**
+     * Builds the availability URL for one candidate name. The caller closes over the id of the
+     * user being edited, so this takes only the name.
+     */
+    readonly userNameAvailabilityUrl: (userName: string) => string;
+}
+declare function createUserLoginSchema(options: UserLoginSchemaOptions): Schema<UserLoginForEdition>;
+interface UserPersonalInformationSchemaOptions {
+    /** Whether the email field is read-only, e.g. because it is managed by an external identity provider. */
+    readonly isEmailReadOnly: () => boolean;
 }
+declare function createUserPersonalInformationSchema(options: UserPersonalInformationSchemaOptions): Schema<UserPersonalInformationForEdition>;
 
-/**
- * @deprecated This model is obsolete and should not be used.
- */
-declare class PermissionModel {
+interface AssignableGroup {
     id: string;
     name: string;
-    tag: string;
-    idSystem: string;
 }
 
-/**
- * @deprecated This component is obsolete and should not be used.
- */
-declare class CaucaManagementGroupComponent implements OnInit {
-    readonly showPrintButton: _angular_core.InputSignal<boolean>;
-    readonly hoverStatePermission: _angular_core.InputSignal<boolean>;
-    readonly showAssignableByAllUsers: _angular_core.InputSignal<boolean>;
-    groups: GroupModel[];
-    users: UserModel[];
-    permissions: PermissionModel[];
-    userFullName: any;
-    showColumn: boolean;
-    showColumnXS: boolean;
-    translations: any;
-    private groupUsers;
-    private readonly managementGroupService;
-    private readonly managementUserService;
-    private readonly managementPermissionService;
-    constructor();
-    ngOnInit(): void;
-    fullName(data: any): string;
-    getGroupUser(field: any, e: any): void;
-    setGroupUser(field: any, e: any): void;
-    setGroupPermission(field: any, e: any): void;
-    getPermissionStatus(field: any, permission: any, e: any): void;
-    checkBoxToggled(field: any, permission: any, e: any): void;
-    onRowInserted(e: any): void;
-    onRowUpdated(e: any): void;
-    onRowRemoved(e: any): void;
-    calculateUsersCellValue: (e: any) => string;
-    onEditingStart(e: any): void;
-    onInitNewRow(): void;
-    groupNameAlreadyUsedValidation: (e: any) => Promise<boolean>;
-    private setPermissionStatus;
-    private saveGroup;
-    private removePermissionUndefined;
-    private getGroups;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CaucaManagementGroupComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CaucaManagementGroupComponent, "cauca-management-group", never, { "showPrintButton": { "alias": "showPrintButton"; "required": false; "isSignal": true; }; "hoverStatePermission": { "alias": "hoverStatePermission"; "required": false; "isSignal": true; }; "showAssignableByAllUsers": { "alias": "showAssignableByAllUsers"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+declare class UserEditionService<TUserForEdition extends UserForEditionBase> {
+    private readonly client;
+    private readonly baseUrl;
+    private readonly urlPrefix;
+    getForEdition(userId: string): Observable<TUserForEdition>;
+    saveForEdition(user: TUserForEdition): Observable<void>;
+    userNameAvailabilityUrl(userName: string, userId: string): string;
+    private buildApiUrl;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<UserEditionService<any>, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<UserEditionService<any>>;
 }
 
-/**
- * @deprecated This component is obsolete and should not be used.
- */
-declare class CaucaManagementUserComponent implements OnInit {
-    users: UserModel[];
-    showColumnXS: boolean;
-    private readonly managementUserService;
-    constructor();
-    ngOnInit(): void;
-    onRowInserted(e: any): void;
-    onRowUpdated(e: any): void;
-    onRowRemoved(e: any): void;
-    userNameAlreadyUsedValidation: (e: any) => Promise<boolean>;
-    private saveGroup;
-    private getUsers;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CaucaManagementUserComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CaucaManagementUserComponent, "cauca-management-user", never, {}, {}, never, never, true, never>;
+declare class AssignableGroupsService {
+    private readonly client;
+    private readonly baseUrl;
+    private readonly urlPrefix;
+    getAssignableGroups(): Observable<AssignableGroup[]>;
+    private buildApiUrl;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AssignableGroupsService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AssignableGroupsService>;
 }
 
-/**
- * @deprecated Import CaucaManagementComponent, CaucaManagementUserComponent and
- * CaucaManagementGroupComponent directly in your standalone components. Kept as a re-export
- * so existing consumers keep compiling.
- */
-declare class CaucaManagementModule {
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CaucaManagementModule, never>;
-    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<CaucaManagementModule, never, [typeof CaucaManagementComponent, typeof CaucaManagementGroupComponent, typeof CaucaManagementUserComponent], [typeof CaucaManagementComponent, typeof CaucaManagementUserComponent, typeof CaucaManagementGroupComponent]>;
-    static ɵinj: _angular_core.ɵɵInjectorDeclaration<CaucaManagementModule>;
+declare class UserLoginFieldsComponent {
+    readonly field: _angular_core.InputSignal<FieldTree<UserLoginForEdition>>;
+    readonly isNew: _angular_core.InputSignal<boolean>;
+    readonly isValidatingUserName: _angular_core.InputSignal<boolean>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<UserLoginFieldsComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<UserLoginFieldsComponent, "cauca-user-login-fields", never, { "field": { "alias": "field"; "required": true; "isSignal": true; }; "isNew": { "alias": "isNew"; "required": false; "isSignal": true; }; "isValidatingUserName": { "alias": "isValidatingUserName"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
-/**
- * @deprecated This service is obsolete and should not be used.
- */
-declare class ManagementUserService {
-    protected readonly http: HttpClient;
-    private readonly baseUrl;
-    private readonly baseUrlToUse;
-    getAll<TUser>(): Observable<TUser[]>;
-    get<TUser>(idUser: string): Observable<TUser>;
-    getGroup(idUser: string): Observable<any>;
-    addGroup(userGroup: UserGroupModel): Observable<any>;
-    deleteGroup(idUserGroup: string): Observable<any>;
-    addPermission(userPermission: UserPermissionModel): Observable<any>;
-    deletePermission(idUserPermission: string): Observable<any>;
-    save<TUser>(user: TUser): Observable<any>;
-    delete(idUser: string): Observable<any>;
-    hasExistingUserName<TUser>(user: TUser): Observable<boolean>;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ManagementUserService, never>;
-    static ɵprov: _angular_core.ɵɵInjectableDeclaration<ManagementUserService>;
+declare class UserPersonalInformationFieldsComponent {
+    readonly field: _angular_core.InputSignal<FieldTree<UserPersonalInformationForEdition>>;
+    readonly isEmailReadOnly: _angular_core.InputSignal<boolean>;
+    readonly emailHint: _angular_core.InputSignal<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<UserPersonalInformationFieldsComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<UserPersonalInformationFieldsComponent, "cauca-user-personal-information-fields", never, { "field": { "alias": "field"; "required": true; "isSignal": true; }; "isEmailReadOnly": { "alias": "isEmailReadOnly"; "required": false; "isSignal": true; }; "emailHint": { "alias": "emailHint"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
-/**
- * @deprecated This service is obsolete and should not be used.
- */
-declare class ManagementGroupService {
-    private readonly http;
-    private readonly baseUrl;
-    private readonly baseUrlToUse;
-    getAll(): Observable<GroupModel[]>;
-    get(idGroup: string): Observable<GroupModel>;
-    save(group: GroupModel): Observable<any>;
-    delete(idGroup: string): Observable<any>;
-    hasExistingGroupName(group: GroupModel): Observable<boolean>;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ManagementGroupService, never>;
-    static ɵprov: _angular_core.ɵɵInjectableDeclaration<ManagementGroupService>;
+declare class UserGroupsSelectorComponent implements FormValueControl<string[]> {
+    readonly value: _angular_core.ModelSignal<string[]>;
+    readonly label: _angular_core.InputSignal<string>;
+    readonly disabled: _angular_core.InputSignal<boolean>;
+    readonly readonly: _angular_core.InputSignal<boolean>;
+    readonly required: _angular_core.InputSignal<boolean>;
+    readonly invalid: _angular_core.InputSignal<boolean>;
+    readonly touched: _angular_core.InputSignal<boolean>;
+    readonly name: _angular_core.InputSignal<string>;
+    readonly errors: _angular_core.InputSignal<readonly ValidationError.WithOptionalFieldTree[]>;
+    readonly touch: _angular_core.OutputEmitterRef<void>;
+    protected readonly filterControl: FormControl<string>;
+    protected readonly options: _angular_core.Signal<AssignableGroup[]>;
+    protected readonly filteredOptions: _angular_core.Signal<AssignableGroup[]>;
+    protected readonly isSelectDisabled: _angular_core.Signal<boolean>;
+    private readonly assignableGroupsService;
+    private readonly filterText;
+    private readonly groups;
+    protected onSelectionChange(groupIds: string[]): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<UserGroupsSelectorComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<UserGroupsSelectorComponent, "cauca-user-groups-selector", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "touch": "touch"; }, never, never, true, never>;
 }
 
-export { AllScopeToken, CaucaManagementComponent, CaucaManagementGroupComponent, CaucaManagementModule, CaucaManagementService, CaucaManagementUserComponent, GroupEditionPageComponent, GroupModel, GroupPermissionModel, GroupsPageComponent, MANAGEMENT_ROUTE_SEGMENT, MANAGEMENT_URL_PREFIX, ManagementGroupService, ManagementUserService, REFRESHABLE_PERMISSION_STATE_TOKEN, ScopeListGridColumnComponent, UserGroupModel, UserListGridComponent, UserModel, UserPermissionModel, UserPermissionsDialogComponent, UsersPageComponent, managementGroupRoutes, provideCaucaManagement };
-export type { CaucaManagementConfig, RefreshablePermissionState, UserGridColumn, UserGridColumnKind, UserListRow, UserPermissionsDialogData };
+export { AllScopeToken, AssignableGroupsService, EmptyUserId, GroupEditionPageComponent, GroupsPageComponent, MANAGEMENT_ROUTE_SEGMENT, MANAGEMENT_URL_PREFIX, REFRESHABLE_PERMISSION_STATE_TOKEN, ScopeListGridColumnComponent, UserEditionService, UserGroupsSelectorComponent, UserListGridComponent, UserLoginFieldsComponent, UserPermissionsDialogComponent, UserPersonalInformationFieldsComponent, UsersPageComponent, createEmptyUserForEdition, createUserLoginSchema, createUserPersonalInformationSchema, managementGroupRoutes, provideCaucaManagement };
+export type { AssignableGroup, CaucaManagementConfig, RefreshablePermissionState, UserForEditionBase, UserGridColumn, UserGridColumnKind, UserListRow, UserLoginForEdition, UserLoginSchemaOptions, UserPermissionsDialogData, UserPersonalInformationForEdition, UserPersonalInformationSchemaOptions };