@ieeesa-npm/groups 0.15.10 → 0.15.11

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/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/services/groups.service.d.ts

@@ -77,6 +77,7 @@ export declare class GroupsService {
         "1037": string;
         "1038": string;
         "1039": string;
+        "1071": string;
         "1072": string;
         "1073": string;
         "1074": string;
@@ -106,6 +107,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;
@@ -122,6 +130,18 @@ export declare class GroupsService {
     representingOrganizations: RepresentingOrganization[];
     constructor(httpService: HttpService, userPermissionsService: UserPermissionsService, groupPermissionsService: GroupPermissionsMapService, alertService: AlertsService);
     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).
+     * @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.

package/package.json

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