@ieeesa-npm/groups 0.15.10 → 0.15.12

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

@@ -74,8 +74,46 @@ export declare class RosterImportComponent implements OnInit, OnDestroy {
     /** Accepted file extensions (must match the BE contract: only .csv / .xlsx). */
     readonly ACCEPTED_EXTENSIONS: string[];
     constructor(rosterImportApiService: RosterImportApiService, groupService: GroupsService);
-    /** Required column headers for display. */
+    /**
+     * Required column headers for display and the sample file. This is the static
+     * base set from constants PLUS any tenant-level required profile fields the
+     * host app configured (e.g. phone / address / employer), mapped to friendly
+     * headers and de-duplicated (case-insensitive) against the base columns.
+     * @return {string[]}
+     */
     get requiredColumns(): string[];
+    /**
+     * Appends the tenant-configured columns (from {@link tenantExtraColumns}) to
+     * the base column headers.
+     * @param {string[]} base - The static base column headers.
+     * @return {string[]}
+     * @memberof RosterImportComponent
+     */
+    private mergeTenantColumns;
+    /**
+     * Resolves the tenant-configured required profile fields into the EXTRA
+     * columns to append after the base set — the single source of truth shared by
+     * both the header list ({@link requiredColumns}) and the sample file
+     * ({@link downloadSampleFile}) so the two never drift out of alignment.
+     *
+     * Each field becomes one column with its friendly `label` (known keys use the
+     * label map; unknown keys fall back to a title-cased key) and a `sampleValue`
+     * for the sample row. Fields whose label already exists in the base set
+     * (case-insensitive) are skipped so a tenant field like "employer" that is
+     * already a base column is not duplicated.
+     * @param {string[]} base - The static base column headers.
+     * @return {{ label: string; sampleValue: string }[]}
+     * @memberof RosterImportComponent
+     */
+    private tenantExtraColumns;
+    /**
+     * Maps a tenant field key to its display header. Known keys use the configured
+     * label map; unknown keys fall back to a title-cased key.
+     * @param {string} field - The tenant field key (e.g. 'phone').
+     * @return {string}
+     * @memberof RosterImportComponent
+     */
+    private tenantFieldLabel;
     /** Comma-separated accepted file types for the input element. */
     get acceptedFileTypes(): string;
     /** The target group id from the dialog payload (falls back to selection). */
@@ -154,14 +192,16 @@ export declare class RosterImportComponent implements OnInit, OnDestroy {
      */
     finalizeResult(job: RosterImportJob): void;
     /**
-     * Parses the BE `errorReport` raw JSON string into row-error view models.
+     * Normalizes the BE `error_report` into row-error view models.
      *
-     * The BE stores the report as a JSONB document wrapping the per-row entries:
-     * `{ "rows": [ { "row": 2, "field": "Email", "message": "..." } ] }`
-     * (serialized by its `ErrorReportWrapper`) and returns it verbatim via
-     * `@JsonRawValue`. So we read `parsed.rows`. A bare top-level array is also
-     * accepted as a fallback in case the contract is ever flattened.
-     * @param {(string | undefined)} errorReport - Raw JSON error report string.
+     * The BE wraps the per-row entries in a `{ rows: [ { row, field, message } ] }`
+     * document, but that value has been observed to arrive in MULTIPLE shapes:
+     *  - a parsed object `{ rows: [...] }` (confirm response — the common case),
+     *  - a raw JSON string of the same object (JSONB passthrough), or
+     *  - a bare array `[ { row, field, message } ]`.
+     * This handles all three (and `null`) so the error log renders regardless of
+     * how the field is serialized.
+     * @param {*} errorReport - The BE error_report (object, string, array, or null).
      * @return {RosterImportRowError[]}
      * @memberof RosterImportComponent
      */

package/lib/groups.component.d.ts

@@ -62,6 +62,19 @@ export declare class GroupsComponent implements OnInit, OnDestroy {
     apiBaseURL: string;
     userPermissions: UserPermission[];
     userInfo: LoggedInUserInfo;
+    private _requiredProfileFields;
+    /**
+     * Tenant-level required profile fields (e.g. ['phone','address','employer'])
+     * supplied by the host app from its cached tenant configuration. Passed to
+     * GroupsService so the roster import appends them to its required columns and
+     * sample file. Optional — defaults to none.
+     *
+     * Implemented as a setter so EVERY input update (including a late,
+     * async-resolved value that arrives after ngOnInit) is propagated to the
+     * singleton GroupsService — not just the initial binding.
+     */
+    set requiredProfileFields(value: string[] | null | undefined);
+    get requiredProfileFields(): string[];
     permissionType: typeof PermissionType;
     functionType: GroupFunctionType;
     alignmentType: typeof AlignType;
@@ -230,5 +243,5 @@ export declare class GroupsComponent implements OnInit, OnDestroy {
      */
     ngOnDestroy(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<GroupsComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<GroupsComponent, "ieeesa-groups", never, { "groupsPageInfo": { "alias": "groupsPageInfo"; "required": false; }; "applicationId": { "alias": "applicationId"; "required": false; }; "apiBaseURL": { "alias": "apiBaseURL"; "required": false; }; "userPermissions": { "alias": "userPermissions"; "required": false; }; "userInfo": { "alias": "userInfo"; "required": false; }; }, {}, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<GroupsComponent, "ieeesa-groups", never, { "groupsPageInfo": { "alias": "groupsPageInfo"; "required": false; }; "applicationId": { "alias": "applicationId"; "required": false; }; "apiBaseURL": { "alias": "apiBaseURL"; "required": false; }; "userPermissions": { "alias": "userPermissions"; "required": false; }; "userInfo": { "alias": "userInfo"; "required": false; }; "requiredProfileFields": { "alias": "requiredProfileFields"; "required": false; }; }, {}, never, never, true, never>;
 }

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/roster-import.model.d.ts

@@ -55,10 +55,13 @@ export interface RosterImportJob {
     /** Rows skipped due to validation errors. */
     failedRows?: number;
     /**
-     * Row-level errors as a RAW JSON string (BE `error_report` JSONB passthrough).
-     * Parse with `JSON.parse(...)` into {@link RosterImportErrorReport}[].
+     * Row-level errors from the BE `error_report` JSONB column. Observed to arrive
+     * EITHER as a parsed object `{ rows: RosterImportErrorReport[] }` OR as a raw
+     * JSON string of the same shape (depending on serialization). A bare array is
+     * also tolerated. `null` when there are no row errors. The client normalizes
+     * all of these — see RosterImportComponent.parseErrorReport.
      */
-    errorReport?: string;
+    errorReport?: any;
 }
 /**
  * Per-row validation outcome in a validate/preview response. Mirrors the BE

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;
@@ -77,6 +78,7 @@ export declare class GroupsService {
         "1037": string;
         "1038": string;
         "1039": string;
+        "1071": string;
         "1072": string;
         "1073": string;
         "1074": string;
@@ -106,6 +108,13 @@ export declare class GroupsService {
     };
     apiBaseUrl: string;
     userPermission: any;
+    /**
+     * Tenant-level required profile fields (e.g. ['phone','address','employer'])
+     * supplied by the host app from its cached tenant configuration. Consumed by
+     * the roster import to append tenant-mandated columns to the required-column
+     * list and the sample file. Empty when the tenant has none configured.
+     */
+    requiredProfileFields: string[];
     selectedGroupInfo: GroupInfo | undefined;
     groupFunctionType: GroupFunctionType;
     selectedGroupParentInfo: GroupInfo | undefined;
@@ -120,8 +129,35 @@ 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.
+     * @param {string[]} requiredProfileFields - Field keys (e.g. 'phone').
+     * @memberof 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
+     */
+    getRequiredProfileFields(): string[];
     /**
      * Gets application group types from API and returns it as an observable.
      * @return {Observable<GroupTypeResponse>} -It returns group types if success else error.
@@ -364,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
      */
@@ -436,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.10",
+  "version": "0.15.12",
   "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';