@cauca-911/management 22.0.4 → 22.0.5

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@cauca-911/management",
-  "version": "22.0.4",
+  "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/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,6 +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 { 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>;
@@ -111,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. */
@@ -195,5 +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>;
 }
 
-export { AllScopeToken, GroupEditionPageComponent, GroupsPageComponent, MANAGEMENT_ROUTE_SEGMENT, MANAGEMENT_URL_PREFIX, REFRESHABLE_PERMISSION_STATE_TOKEN, ScopeListGridColumnComponent, UserListGridComponent, UserPermissionsDialogComponent, UsersPageComponent, managementGroupRoutes, provideCaucaManagement };
-export type { CaucaManagementConfig, RefreshablePermissionState, UserGridColumn, UserGridColumnKind, UserListRow, UserPermissionsDialogData };
+interface UserLoginForEdition {
+    userName: string;
+    password: string;
+    twoFactorAuthenticatorEnabled: boolean;
+}
+interface UserPersonalInformationForEdition {
+    firstName: string;
+    lastName: string;
+    email: string;
+    phoneNumber: 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;
+
+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>;
+
+interface AssignableGroup {
+    id: string;
+    name: string;
+}
+
+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>>;
+}
+
+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>;
+}
+
+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>;
+}
+
+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>;
+}
+
+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, 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 };