@ieeesa-npm/groups 0.15.11 → 0.15.13

package/lib/assets/country-calling-codes.d.ts

@@ -0,0 +1,14 @@
+import { SelectOption } from '@ieeesa-npm/models';
+/**
+ * Frontend-only static list of country calling (dialing) codes used by the
+ * Phone Number field's country-code dropdown in the add-user-roster form.
+ *
+ * This is static reference data (it does not change per request), so it is kept
+ * on the frontend rather than fetched from an API — no extra dependency needed.
+ * Both `id` and `name` are the raw calling code (e.g. `+1`) so the dropdown
+ * shows only the code and that same code is what gets persisted/sent to the
+ * backend. Countries that share a calling code are represented once.
+ */
+export declare const COUNTRY_CALLING_CODES: SelectOption[];
+/** Default country calling code option id (US/Canada), used when none is set. */
+export declare const DEFAULT_COUNTRY_CALLING_CODE = "+1";

package/lib/assets/form-validations.d.ts

@@ -27,4 +27,7 @@ export declare const GroupsValidationPatterns: {
     representingOrgNameMinLength: number;
     representingOrganization: RegExp;
     firstOrLastName: RegExp;
+    phoneNumber: RegExp;
+    phoneNumberMaxLength: number;
+    addressMaxLength: number;
 };

package/lib/components/add-user-roster/add-user-roster.component.d.ts

@@ -44,6 +44,8 @@ export declare class AddUserRosterComponent implements OnInit, OnDestroy {
     groupRosterType: GroupRosterType;
     isUserExist: boolean;
     selectedOrganizations: AutoCompleteOption[];
+    countryCallingCodes: SelectOption[];
+    requiredProfileFields: string[];
     timeOutId: ReturnType<typeof setTimeout>;
     /**
      * True when the selected group's roster type is INDIVIDUAL (the only roster
@@ -173,6 +175,12 @@ export declare class AddUserRosterComponent implements OnInit, OnDestroy {
      * @memberof AddUserRosterComponent
      */
     onFormCancel(): void;
+    /**
+     * Gets the tenant's required profile fields so the add-user form only shows
+     * the phone/address fields the tenant has configured as required.
+     * @memberof AddUserRosterComponent
+     */
+    getRequiredProfileFields(): void;
     /**
      * Gets the classifications from master data.
      * @memberof AddUserRosterComponent
@@ -239,6 +247,16 @@ export declare class AddUserRosterComponent implements OnInit, OnDestroy {
      * @memberof AddUserRosterComponent
      */
     getAddNewUserPayload(formData: any): AddOrEditUserPayload | AddOrEditUserIndividualRosterPayload;
+    /**
+     * Appends the optional contact fields (phone country code, phone number and
+     * address) to the payload. The country code is sent only when a phone number
+     * is provided; phone number and address are included only when the user
+     * entered a value (so nulls/empties are not sent to the backend).
+     * @param {(AddOrEditUserPayload | AddOrEditUserIndividualRosterPayload)} payload
+     * @param {*} formData
+     * @memberof AddUserRosterComponent
+     */
+    appendContactDetailsToPayload(payload: AddOrEditUserPayload | AddOrEditUserIndividualRosterPayload, formData: any): void;
     /**
      * Disables form submit button when org name length is less than minCharToSearch and greater than zero.
      * @memberof AddUserRosterComponent

package/lib/components/create-group/create-group.component.d.ts

@@ -35,7 +35,7 @@ export declare class CreateGroupComponent implements OnInit, OnDestroy {
     createGroupText: {
         heading: string;
         reciprocalCredit: {
-            selectAtLeastOneGroup: string;
+            selectAtLeastOneGroup: string; /** Reciprocal credit state (Working Group only) — captured for Save. */
         };
         label: {
             parentGroup: string;
@@ -60,7 +60,12 @@ export declare class CreateGroupComponent implements OnInit, OnDestroy {
                 parentGroup: string;
                 changeParentGroup: string;
                 newParentGroup: string;
-                groupType: string; /** Config ids of previously-saved reciprocal rows removed locally — for soft-delete on Save. */
+                groupType: string;
+                /**
+                 * Initialize the create group form group array and component.
+                 * @return -returns nothing
+                 * @memberof CreateGroupComponent
+                 */
                 groupName: string;
                 shortName: string;
                 groupScope: string;

package/lib/components/edit-user-roles/edit-user-roles.component.d.ts

@@ -39,7 +39,9 @@ export declare class EditUserRolesComponent implements OnInit, OnDestroy {
     hasClassification: boolean;
     groupRosterType: GroupRosterType;
     representingOrganizations: SelectOption[];
+    countryCallingCodes: SelectOption[];
     orgSearchValue: string;
+    requiredProfileFields: string[];
     /**
      * True when the selected group's roster type is INDIVIDUAL (the only roster
      * type that shows the Representing Organization field).
@@ -111,6 +113,16 @@ export declare class EditUserRolesComponent implements OnInit, OnDestroy {
      * @memberof EditUserRolesComponent
      */
     getEditUserRolePayload(formData: any): AddOrEditUserPayload | AddOrEditUserIndividualRosterPayload;
+    /**
+     * Appends the optional contact fields (phone country code, phone number and
+     * address) to the payload. Reads from the combined PHONE control value
+     * ({ countryCode, phoneNumber }) and the address control. Sends the country
+     * code only when a number is present; omits empty values.
+     * @param {(AddOrEditUserPayload | AddOrEditUserIndividualRosterPayload)} payload
+     * @param {*} formData
+     * @memberof EditUserRolesComponent
+     */
+    appendContactDetailsToPayload(payload: AddOrEditUserPayload | AddOrEditUserIndividualRosterPayload, formData: any): void;
     /**
      * Emits form cancel event.
      * @memberof EditUserRolesComponent
@@ -140,6 +152,13 @@ export declare class EditUserRolesComponent implements OnInit, OnDestroy {
      * @memberof editUserRoleFormGroupRef
      */
     onEditUserRoleFormChange(form: FormGroup[]): void;
+    /**
+     * Gets the tenant's required profile fields so the edit-user form only shows
+     * the phone/address fields the tenant has configured as required. Builds the
+     * form once resolved (or immediately if the appId isn't available).
+     * @memberof EditUserRolesComponent
+     */
+    getRequiredProfileFields(): void;
     /**
      * Gets the classifications from master data.
      * @memberof EditUserRolesComponent

package/lib/components/roster-import/roster-import.component.d.ts

@@ -168,6 +168,14 @@ export declare class RosterImportComponent implements OnInit, OnDestroy {
      * @memberof RosterImportComponent
      */
     onRemoveFile(): void;
+    /**
+     * Returns from the result screen to a clean upload state so the user can
+     * upload a corrected file (e.g. after downloading the error log) without
+     * closing and reopening the import dialog. Clears the previous file,
+     * result, errors and job id.
+     * @memberof RosterImportComponent
+     */
+    onUploadNewFile(): void;
     /**
      * Runs the real import: upload → validate → confirm. The progress bar is
      * shown in indeterminate mode while the chain is in flight, then the

package/lib/models/add-new-user.model.d.ts

@@ -5,6 +5,9 @@ export interface SearchUserByEmailResponse {
         userId: string | null;
         email: string;
         name: string;
+        phoneCountryCode?: string | null;
+        phoneNumber?: string | null;
+        address?: string | null;
     };
 }
 export interface GetUserDetailsPayload {

package/lib/models/add-or-edit-user-group.model.d.ts

@@ -13,6 +13,9 @@ export interface AddOrEditUserRolePayload {
     email: string;
     firstName?: string;
     lastName?: string;
+    phoneCountryCode?: string;
+    phoneNumber?: string;
+    address?: string;
 }
 export interface AddOrEditIndividualRosterPayload extends AddOrEditUserRolePayload {
     classification?: {

package/lib/models/group-user-info.model.d.ts

@@ -7,4 +7,7 @@ export interface GroupUserInfo {
     organization?: string;
     memberStatus?: string;
     canDelete?: boolean;
+    phoneCountryCode?: string | null;
+    phoneNumber?: string | null;
+    address?: string | null;
 }

package/lib/models/required-profile-fields.model.d.ts

@@ -0,0 +1,20 @@
+export interface RequiredProfileFieldsConfiguration {
+    configFieldValue?: {
+        requiredFields?: string[];
+    };
+}
+export interface RequiredProfileFieldsResponse {
+    status: boolean;
+    message?: string;
+    body?: RequiredProfileFieldsConfiguration[];
+}
+/**
+ * Shape of the tenant required-profile-fields value cached in local storage by
+ * the hosting application at login (storage key `REQUIRED_PROFILE_FIELDS`). The
+ * add-user / edit-user forms read this cache to decide which optional fields
+ * (phone/address/employer) to show.
+ */
+export interface CachedRequiredProfileFields {
+    appId: string;
+    requiredFields: string[];
+}

package/lib/models/table-column-schema-user-group.model.d.ts

@@ -5,5 +5,7 @@ export declare enum TableColumnSchemaUserGroup {
     EMPLOYER = "employer",
     CLASSIFICATION = "classification",
     ORGANIZATION = "org_name",
-    MEMBER_TYPE = "memberType"
+    MEMBER_TYPE = "memberType",
+    PHONE_NUMBER = "phone_number",
+    ADDRESS = "address"
 }

package/lib/models/user-info.model.d.ts

@@ -2,4 +2,7 @@ export interface UserInfo {
     email: string;
     name: string;
     userId: string | null;
+    phoneCountryCode?: string | null;
+    phoneNumber?: string | null;
+    address?: string | null;
 }

package/lib/models/user.model.d.ts

@@ -10,6 +10,9 @@ export interface User {
     memberStatus: string | null;
     organization: string | null;
     employer: string | null;
+    phoneCountryCode: string | null;
+    phoneNumber: string | null;
+    address: string | null;
     checked?: boolean;
     canDelete?: boolean;
 }
@@ -28,6 +31,9 @@ export interface GetGroupUsersResponse {
         classification: Classification | null;
         organizations: Organization[] | null;
         employer: Employer | null;
+        phoneCountryCode?: string | null;
+        phoneNumber?: string | null;
+        address?: string | null;
         canDelete?: boolean;
     }[];
 }

package/lib/services/groups.service.d.ts

@@ -1,7 +1,7 @@
 import { Observable, BehaviorSubject } from 'rxjs';
 import { CreateGroupPayload, CreateGroupResponse } from '../models/create-group.model';
 import { BusinessRule, GroupTypeConfiguration, GroupTypeConfigValue, GroupTypeResponse } from '../models/group-types.model';
-import { AlertsService, HttpService } from '@ieeesa-npm/utility';
+import { AlertsService, HttpService, StorageService } from '@ieeesa-npm/utility';
 import { GetGroupResponse, GetGroupsPayload } from '../models/view-group.model';
 import { DeleteGroupPayload } from '../models/delete-group.model';
 import { GroupInfo } from '../models/group-info.model';
@@ -18,7 +18,7 @@ import { GetUserDetailsPayload, SearchUserByEmailResponse } from '../models/add-
 import { OrganizationRequestPayload, OrganizationResponse } from '../models/organization.model';
 import { ClassificationResponse } from '../models/classification.model';
 import { GroupRosterType } from '../models/roster-type.model';
-import { CheckboxOption } from '@ieeesa-npm/models';
+import { CheckboxOption, SelectOption } from '@ieeesa-npm/models';
 import { FormControlStatus } from '@angular/forms';
 import { GroupPermission, UserPermission } from '../models/group-permissions.model';
 import { PermissionType } from '../models/permission-type.model';
@@ -35,6 +35,7 @@ export declare class GroupsService {
     private userPermissionsService;
     private groupPermissionsService;
     alertService: AlertsService;
+    private storageService;
     groupsText: {
         ER1000: string;
         ER1001: string;
@@ -128,7 +129,7 @@ export declare class GroupsService {
     userInfo: LoggedInUserInfo;
     memberTypes: Role[];
     representingOrganizations: RepresentingOrganization[];
-    constructor(httpService: HttpService, userPermissionsService: UserPermissionsService, groupPermissionsService: GroupPermissionsMapService, alertService: AlertsService);
+    constructor(httpService: HttpService, userPermissionsService: UserPermissionsService, groupPermissionsService: GroupPermissionsMapService, alertService: AlertsService, storageService: StorageService);
     setAppConfig(apiBaseUrl: string, userPermission: any): void;
     /**
      * Stores the tenant-level required profile fields provided by the host app.
@@ -138,6 +139,21 @@ export declare class GroupsService {
     setRequiredProfileFields(requiredProfileFields: string[]): void;
     /**
      * Returns the tenant-level required profile fields (never null).
+     *
+     * Reads the local storage cache the hosting application writes at login (key
+     * `REQUIRED_PROFILE_FIELDS`) as the source of truth, so the add-user /
+     * edit-user forms always reflect the tenant configuration regardless of the
+     * @Input/resolver timing.
+     *
+     * The cache is only trusted when it is well-formed for the active
+     * application: its `appId` must match the current user's `appId` and its
+     * `requiredFields` must be an array. This guards against (a) a stale cache
+     * from a previously opened application applying another tenant's fields, and
+     * (b) a malformed cache crashing the forms when callers run
+     * `requiredFields.includes(...)` on a non-array value. When the cache is
+     * missing, for another app, or malformed, it falls back to the in-memory
+     * value set via {@link setRequiredProfileFields} (the host @Input), then to
+     * an empty list.
      * @return {string[]}
      * @memberof GroupsService
      */
@@ -384,7 +400,9 @@ export declare class GroupsService {
      */
     setUserInfo(userInfo: LoggedInUserInfo): void;
     /**
-     * Returns the logged in user information.
+     * Returns the logged in user information. Falls back to the USER_INFO blob
+     * the host app persists to local storage when the userInfo input hasn't
+     * been set yet (e.g. host wiring not completed or timing race on init).
      * @return {LoggedInUserInfo}
      * @memberof GroupsService
      */
@@ -456,6 +474,13 @@ export declare class GroupsService {
      * @memberof GroupsService
      */
     getMemberTypes(): Role[];
+    /**
+     * Returns the frontend-only static list of country calling codes for the
+     * Phone Number field's country-code dropdown.
+     * @return {SelectOption[]}
+     * @memberof GroupsService
+     */
+    getCountryCallingCodes(): SelectOption[];
     /** Path prefix (relative to apiBaseUrl) for the reciprocal-credit endpoints. */
     private readonly RECIPROCAL_BASE_PATH;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ieeesa-npm/groups",
-  "version": "0.15.11",
+  "version": "0.15.13",
   "peerDependencies": {
     "@angular/common": "^16.1.0",
     "@angular/core": "^16.1.0"

package/public-api.d.ts

@@ -28,6 +28,7 @@ export * from './lib/models/roster-type.model';
 export * from './lib/models/table-column-schema-user-group.model';
 export * from './lib/models/parent-groups-info.model';
 export * from './lib/models/reciprocal-credit.model';
+export * from './lib/models/required-profile-fields.model';
 export * from './lib/services/groups.service';
 export * from './lib/services/roster-export.service';
 export * from './lib/services/roster-import-api.service';