@ieeesa-npm/groups 0.15.17 → 0.15.18

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

@@ -113,16 +113,6 @@ 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

package/lib/components/interest-responses/interest-responses.component.d.ts

@@ -0,0 +1,80 @@
+import { ChangeDetectorRef, OnDestroy, OnInit } from '@angular/core';
+import { GroupsService } from '../../services/groups.service';
+import * as i0 from "@angular/core";
+/**
+ * A single question/answer pair rendered in the interest responses list. Built
+ * from a backend {@link InterestFormResponse}; {@code value} is normalized to a
+ * display string (CHECKBOX arrays are joined).
+ */
+interface SubmissionAnswer {
+    label: string;
+    value: string;
+}
+/**
+ * Payload passed into {@link InterestResponsesComponent} by the host
+ * {@link ModalComponent} via the dynamic-input pattern.
+ */
+export interface InterestResponsesData {
+    /** The interest record whose stored responses are shown. */
+    interestId: string;
+}
+/**
+ * "View Responses" content of the Roster Management "Interested Rosters" tab
+ * (SP3M-428). Rendered inside the shared {@link ModalComponent} (which supplies
+ * the title row and X close), it lists a requester's submitted interest-form
+ * answers as label/value pairs. Responses are loaded on init from
+ * {@link GroupsService.getInterestResponses} using the interest id supplied by
+ * the host modal. All display text is sourced from constants.json.
+ * @export
+ * @class InterestResponsesComponent
+ */
+export declare class InterestResponsesComponent implements OnInit, OnDestroy {
+    private groupsService;
+    private cdr;
+    /**
+     * Data supplied by the host {@link ModalComponent} via the dynamic-input
+     * pattern (`dataInputName: 'componentData'`): carries the interest id whose
+     * responses are loaded.
+     */
+    componentData: InterestResponsesData | null;
+    constants: any;
+    texts: any;
+    submissionAnswers: SubmissionAnswer[];
+    isLoading: boolean;
+    errorMessage: string;
+    private readonly destroy$;
+    constructor(groupsService: GroupsService, cdr: ChangeDetectorRef);
+    /**
+     * Loads the interest-form responses for the supplied interest id on init.
+     * @memberof InterestResponsesComponent
+     */
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    /**
+     * Fetches and maps the interest-form responses into displayable
+     * question/answer pairs. Failures surface a user-facing error message and are
+     * delegated to GroupsService for alerting, mirroring the platform pattern.
+     * @memberof InterestResponsesComponent
+     */
+    private loadResponses;
+    /**
+     * Maps backend responses to label/value pairs, joining multi-select
+     * (CHECKBOX) answers and normalizing missing values to an empty string.
+     * @param {InterestFormResponse[]} responses
+     * @return {SubmissionAnswer[]}
+     * @memberof InterestResponsesComponent
+     */
+    private mapResponses;
+    /**
+     * Normalizes an answer value for display. CHECKBOX answers arrive as an array
+     * and are joined with commas; all other field types render their string
+     * value as-is.
+     * @param {InterestFormResponse} response
+     * @return {string}
+     * @memberof InterestResponsesComponent
+     */
+    private formatAnswer;
+    static ɵfac: i0.ɵɵFactoryDeclaration<InterestResponsesComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<InterestResponsesComponent, "ieeesa-interest-responses", never, { "componentData": { "alias": "componentData"; "required": false; }; }, {}, never, never, true, never>;
+}
+export {};

package/lib/components/interested-rosters/interested-rosters.component.d.ts

@@ -1,17 +1,151 @@
+import { ChangeDetectorRef, OnDestroy, OnInit } from '@angular/core';
+import { MatDialog } from '@angular/material/dialog';
+import { PageEvent } from '@angular/material/paginator';
+import { Sort } from '@angular/material/sort';
+import { SelectOption } from '@ieeesa-npm/models';
+import { PaginatorConfig, TableActions, TableColumnSchema } from '@ieeesa-npm/presentation';
+import { GroupInfo } from '../../models/group-info.model';
+import { InterestedRoster } from '../../models/interest-response.model';
+import { GroupsService } from '../../services/groups.service';
 import * as i0 from "@angular/core";
+type InterestedRosterColumnSchema = TableColumnSchema & {
+    ariaLabel?: (row: InterestedRoster) => string;
+};
 /**
- * "Interested Rosters" tab content of the Roster Interests dialog (SP3M-317).
- * Displays the list of users who expressed interest in the group. This is a
- * placeholder shell for now; the submissions table will be implemented in a
- * later increment once the backend is available (data will be mocked in the
- * service layer meanwhile).
+ * "Interested Rosters" tab of the Roster Interests dialog (SP3M-428). Lists the
+ * users who expressed interest in the group and lets a Group Admin review each
+ * requester's submitted responses and set/override their membership level from
+ * the Roster Management screen.
+ *
+ * The list is rendered through the shared {@link DataTableComponent}: the
+ * Name/Email/Affiliations/Submitted On columns are plain TEXT, Member Level is
+ * the reusable table's DROPDOWN column (an inline {@code ieeesa-select}) and
+ * Form is a LINK that opens the "View Responses" dialog. The Member Level
+ * options are sourced from the roles API
+ * ({@link GroupsService.getGroupTypeRoles}) filtered to the "Member Level" role
+ * type. Interested-roster rows are loaded from
+ * {@link GroupsService.getInterestResponsesByGroup} and each requester's stored
+ * form responses are loaded on demand from
+ * {@link GroupsService.getInterestResponses} using the row's `interestId`. All
+ * display text is sourced from constants.json.
  * @export
  * @class InterestedRostersComponent
  */
-export declare class InterestedRostersComponent {
+export declare class InterestedRostersComponent implements OnInit, OnDestroy {
+    private dialog;
+    private groupsService;
+    private cdr;
+    group: GroupInfo | null;
     constants: any;
-    interestedRostersTexts: any;
-    placeholderMessage: any;
-    static ɵfac: i0.ɵɵFactoryDeclaration<InterestedRostersComponent, never>;
+    texts: any;
+    private destroy$;
+    /**
+     * Member-level dropdown options, sourced from the roles API
+    * ({@code GET /groups/config/rolesByGroupType/{groupType}}) filtered to the "Member Level" role type.
+     * Each option is {@code { id: roleId, name: roleName }}.
+     */
+    memberLevelOptions: SelectOption[];
+    rosters: InterestedRoster[];
+    tableData: InterestedRoster[];
+    columnSchema: InterestedRosterColumnSchema[];
+    /** Total interested-roster rows reported by the backend (for paging/counts). */
+    totalRecords: number;
+    paginatorConfig: PaginatorConfig;
+    pageIndex: number;
+    defaultSortedColumn: string;
+    defaultColumnSortDirection: Sort['direction'];
+    private sortedBy;
+    private sortedOrderBy;
+    /** Read-only table — no search / filter / add / edit / delete actions. */
+    tableActions: TableActions;
+    isLoading: boolean;
+    constructor(dialog: MatDialog, groupsService: GroupsService, cdr: ChangeDetectorRef, group: GroupInfo | null);
+    /**
+     * Builds the reusable-table column schema and loads the interested-roster
+     * list for the current group from the backend.
+     * @memberof InterestedRostersComponent
+     */
+    ngOnInit(): void;
+    /**
+     * Cleans up in-flight subscriptions when the component is destroyed.
+     * @memberof InterestedRostersComponent
+     */
+    ngOnDestroy(): void;
+    /**
+     * Resolves the current group id from the dialog data (falling back to the
+     * service's selected group) and loads the interested-roster rows for it. Maps
+     * each backend {@link GroupInterestResponseView} onto the flattened
+     * {@link InterestedRoster} shape the reusable table binds to. On failure the
+     * table is cleared and the error is delegated to GroupsService for alerting.
+     * @memberof InterestedRostersComponent
+     */
+    private loadInterestedRosters;
+    onPaginationChange(event: PageEvent): void;
+    onSortChange(event: Sort): void;
+    /**
+     * Maps a backend {@link GroupInterestResponseView} to the flattened
+     * {@link InterestedRoster} row the table renders: affiliation org names are
+     * joined into the affiliations list, the assigned membership level (if any)
+     * becomes the role name — which the Member Level dropdown binds as its
+     * pre-selected value — the submitted timestamp is formatted for display, and
+     * the interest id is carried through for the responses dialog and the level
+     * override.
+     * @param {GroupInterestResponseView} view
+     * @return {InterestedRoster}
+     * @memberof InterestedRostersComponent
+     */
+    private mapToRoster;
+    /**
+     * Formats the backend submitted timestamp (ISO date string) for display,
+     * falling back to the raw value when it is not a parseable date.
+     * @param {string} submittedOn
+     * @return {string}
+     * @memberof InterestedRostersComponent
+     */
+    private formatSubmittedOn;
+    /**
+     * Loads the Member Level dropdown options from the roles API
+    * ({@code GET /groups/config/rolesByGroupType/{groupType}}), keeping only roles whose
+     * {@code roleTypeName} is "Member Level" and mapping each to a
+     * {@link SelectOption} ({@code { id: roleId, name: roleName }}).
+     * @memberof InterestedRostersComponent
+     */
+    private loadMemberLevelOptions;
+    /**
+     * Persists the membership-level override when the admin picks a value in a
+     * row's Member Level dropdown (bound to the reusable table's
+     * `rowDropdownChange` output). Builds the request from the dialog's current
+     * group id, the row's user id and the selected option's id (the role id), and
+     * posts it to the backend. The row's displayed level is updated optimistically
+     * and reverted if the save fails.
+     * @param {{ row: InterestedRoster; option: SelectOption }} event
+     * @memberof InterestedRostersComponent
+     */
+    onMemberLevelChange(event: {
+        row: InterestedRoster;
+        option: SelectOption;
+    }): void;
+    /**
+     * Opens the "View Responses" dialog for a roster row (bound to the reusable
+     * table's LINK output) using the shared {@link ModalComponent}. The modal
+     * supplies the title row and X close; the requester's stored interest-form
+     * responses are rendered by {@link InterestResponsesComponent}, which loads
+     * them from the backend using the row's {@code interestId} passed via the
+     * ModalComponent dynamic-input pattern.
+     * @param {InterestedRoster} row
+     * @memberof InterestedRostersComponent
+     */
+    onFormLinkClick(row: InterestedRoster): void;
+    /**
+     * Defines the reusable-table columns for the Interested Rosters list. Every
+     * `cellData`/`selectedOption` is a `(row) => ...` accessor, matching the
+     * shared table's contract. Member Level is the DROPDOWN column seeded with the
+     * configured levels plus "None"; Form is a LINK that opens the responses
+     * dialog.
+     * @memberof InterestedRostersComponent
+     */
+    private buildColumnSchema;
+    static ɵfac: i0.ɵɵFactoryDeclaration<InterestedRostersComponent, [null, null, null, { optional: true; }]>;
     static ɵcmp: i0.ɵɵComponentDeclaration<InterestedRostersComponent, "ieeesa-interested-rosters", never, {}, {}, never, never, true, never>;
 }
+export {};

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

@@ -24,10 +24,11 @@ interface RosterImportHistoryRow {
  * Data comes from the real BE endpoint via {@link RosterImportApiService}:
  * `GET /v1/groups/roster/import/history/{groupId}`. The response is a list of
  * `RosterImportJob` whose JSON view exposes `fileName`, `successRows`,
- * `failedRows`, `status` and ids — but NOT `createdOn` / `createdBy` (both are
- * `@JsonIgnore` on the BE entity). So the "Timestamp" and "Person Imported"
- * columns render a placeholder until the BE exposes those fields. "Target
- * Group" uses the current group's name (history is scoped to one group).
+ * `failedRows`, `status` and ids. The "Timestamp" and "Person Imported" columns
+ * map to `createdOn` / `createdBy`; these are currently `@JsonIgnore` on the BE
+ * entity, so until the BE exposes them the columns show a placeholder, and they
+ * populate automatically once the response carries the fields. "Target Group"
+ * uses the current group's name (history is scoped to one group).
  *
  * @export
  * @class RosterImportHistoryComponent
@@ -83,6 +84,43 @@ export declare class RosterImportHistoryComponent implements OnInit, OnDestroy {
      * @memberof RosterImportHistoryComponent
      */
     private mapJobToRow;
+    /**
+     * Formats the BE `createdOn` timestamp for display, converting from UTC to the
+     * browser's local timezone.
+     *
+     * The API sends a UTC wall-clock string in `dd/MM/yyyy HH:mm:ss` with NO zone
+     * marker, so it must be parsed EXPLICITLY as UTC (otherwise luxon/JS would
+     * assume local time and shift it incorrectly), then rendered in the system
+     * (browser) zone via toLocal(). Uses luxon per the project's date standards
+     * (moment is legacy — not used for new code).
+     * @param {string} value - The raw UTC createdOn value from the BE.
+     * @return {string} the localized display string, or the placeholder when
+     * blank/invalid.
+     * @memberof RosterImportHistoryComponent
+     */
+    private formatTimestamp;
+    /**
+     * Parses a BE timestamp string into a luxon {@link DateTime}, tolerant of the
+     * several shapes the backend may send so the UI renders correctly regardless
+     * of which format is used.
+     *
+     * The agreed/expected BE format is a UTC wall-clock string `dd/MM/yyyy HH:mm:ss`
+     * with NO zone marker; it is tried FIRST and parsed explicitly in UTC. If the
+     * BE instead sends a different shape, these fallbacks are tried in order:
+     *  1. `dd/MM/yyyy HH:mm:ss` (UTC)        — the expected/agreed format
+     *  2. ISO-8601 (e.g. 2026-10-09T14:23:05Z or with offset) — zone from the string,
+     *     or assumed UTC when the string carries none
+     *  3. SQL datetime `yyyy-MM-dd HH:mm:ss` (UTC)
+     *  4. `dd/MM/yyyy HH:mm` (UTC, no seconds)
+     *  5. RFC-2822 / HTTP date
+     *  6. native JS Date (last resort) — assumed UTC
+     * The first format that yields a valid DateTime wins. Returns null when none
+     * parse.
+     * @param {string} value - The raw timestamp string from the BE.
+     * @return {(DateTime | null)}
+     * @memberof RosterImportHistoryComponent
+     */
+    private parseUtcTimestamp;
     /**
      * Maps a failed history request to a user-facing inline error message.
      * A 403 gets the permission-specific message; other errors get the generic

package/lib/groups.component.d.ts

@@ -6,7 +6,7 @@ import { Subject } from 'rxjs';
 import { GroupInfo } from './models/group-info.model';
 import { SelectOption, IconButton, AlignType, SearchType, BreakpointObserverService } from '@ieeesa-npm/presentation';
 import { GroupType, GroupTypeConfigValue } from './models/group-types.model';
-import { AlertsService, GlobalErrorHandlerService } from '@ieeesa-npm/utility';
+import { AlertsService, GlobalErrorHandlerService, StorageService } from '@ieeesa-npm/utility';
 import { AlertType } from '@ieeesa-npm/models';
 import { GroupFunctionType } from './models/group-function-type.model';
 import { GetGroupsPayload } from './models/view-group.model';
@@ -29,6 +29,7 @@ export declare class GroupsComponent implements OnInit, OnDestroy {
     globalErrorHandlerService: GlobalErrorHandlerService;
     private userPermissionsService;
     private groupPermissionsService;
+    private storageService;
     destroy$: Subject<boolean>;
     dialogRef: any;
     constants: any;
@@ -84,7 +85,8 @@ export declare class GroupsComponent implements OnInit, OnDestroy {
     trimmedSearchTerm: string;
     userGroupPermissions: GroupPermission[];
     supportMessage: string;
-    constructor(dialog: MatDialog, groupsService: GroupsService, alertService: AlertsService, breakpointObserverService: BreakpointObserverService, globalErrorHandlerService: GlobalErrorHandlerService, userPermissionsService: UserPermissionsService, groupPermissionsService: GroupPermissionsMapService);
+    private hasAttemptedHistoryRestore;
+    constructor(dialog: MatDialog, groupsService: GroupsService, alertService: AlertsService, breakpointObserverService: BreakpointObserverService, globalErrorHandlerService: GlobalErrorHandlerService, userPermissionsService: UserPermissionsService, groupPermissionsService: GroupPermissionsMapService, storageService: StorageService);
     /**
      * Initialize the groups component.
      * @return -returns nothing
@@ -138,7 +140,7 @@ export declare class GroupsComponent implements OnInit, OnDestroy {
      * @param {GroupInfo} selectedGroupInfo
      * @memberof GroupsComponent
      */
-    openRosterImportHistoryModal(selectedGroupInfo: GroupInfo): void;
+    openRosterImportHistoryModal(selectedGroupInfo: GroupInfo, isRestored?: boolean): void;
     /**
      * Sets the dialog options for users modal and calls openModal method.
      * @param {GroupInfo} group
@@ -160,7 +162,7 @@ export declare class GroupsComponent implements OnInit, OnDestroy {
      * @return -returns nothing
      * @memberof GroupsComponent
      */
-    openModal(dialogOptions: any, className?: string, groupInfo?: GroupInfo | EditGroupAndParentInfo): void;
+    openModal(dialogOptions: any, className?: string, groupInfo?: GroupInfo | EditGroupAndParentInfo, isRestoredReadOnlyDialog?: boolean): void;
     /**
      * Opens the confirmation modal to get user confirmation to delete the selected group.
      * @memberof GroupComponent
@@ -222,6 +224,9 @@ export declare class GroupsComponent implements OnInit, OnDestroy {
      * @memberof GroupsComponent
      */
     getGroupTypes(): void;
+    private get rosterHistoryStorageKey();
+    private persistRosterHistory;
+    private restoreRosterImportHistoryModal;
     /**
      * Handles alerts for success, error and warning.
      * @param {(string | string[])} message -success or error or warning message.

package/lib/models/interest-response.model.d.ts

@@ -0,0 +1,209 @@
+/**
+ * Interest-form field types frozen on each stored response via the backend's
+ * {@code field_type_snapshot} column. Mirrors the BE `FieldType` enum
+ * (sa-saapps-groups-api: org.ieee.standards.groups.model.FieldType) and drives
+ * how {@link InterestFormResponse.answerValue} is rendered in the admin
+ * "View Responses" dialog (single value vs. a list for CHECKBOX).
+ */
+export declare enum InterestFieldType {
+    TEXT = "TEXT",
+    TEXTAREA = "TEXTAREA",
+    SELECT = "SELECT",
+    CHECKBOX = "CHECKBOX",
+    RADIO = "RADIO",
+    DATE = "DATE"
+}
+/**
+ * A single submitted answer to an interest-form question, as returned by the
+ * backend from
+ * {@code GET {apiBaseUrl}/groups/interest/{interestId}/responses}.
+ *
+ * Mirrors the UI-view projection of the BE `InterestFormResponse` entity
+ * (sa-saapps-groups-api: org.ieee.standards.groups.model.InterestFormResponse);
+ * only the fields annotated with the BE `@JsonView(UiView)` are serialized —
+ * the audit/app_id columns are `@JsonIgnore` and never arrive on the client.
+ *
+ * {@link questionLabelSnapshot} and {@link fieldTypeSnapshot} freeze the
+ * question label and field type as configured at submit time, so later form
+ * configuration changes apply only to new submissions (R8.6, R8.8).
+ * {@link answerValue} is a JSONB passthrough: it arrives as a plain string for
+ * single-value fields (TEXT/TEXTAREA/SELECT/RADIO/DATE) and as a string[] for
+ * multi-select (CHECKBOX).
+ */
+export interface InterestFormResponse {
+    /** Response row identifier (e.g. "IFR_SAAPPS_..."). */
+    responseId: string;
+    /** The interest record this answer belongs to (e.g. "GINT_SAAPPS_..."). */
+    interestId: string;
+    /** The question this answer is for (e.g. "IFQ_SAAPPS_..."), when available. */
+    questionId?: string;
+    /** Question label frozen at submit time (R8.6, R8.8). */
+    questionLabelSnapshot?: string;
+    /** Field type frozen at submit time; see {@link InterestFieldType}. */
+    fieldTypeSnapshot?: string;
+    /**
+     * Submitted answer. A string for single-value fields; a string[] for
+     * CHECKBOX. `null`/undefined when the question was left unanswered.
+     */
+    answerValue?: string | string[] | null;
+}
+/**
+ * A single organization affiliation on an interested-roster row, as returned
+ * inside {@link GroupInterestResponseView.affiliation}. Mirrors the UI-view
+ * projection of the BE `Organization` entity (only `orgId`/`orgName` are
+ * `@JsonView(UiView)`; the rest are `@JsonIgnore`).
+ */
+export interface InterestAffiliation {
+    /** Organization id (e.g. "ORG_SAAPPS_..."). */
+    orgId: string;
+    /** Organization display name. */
+    orgName: string;
+}
+/**
+ * A single membership level (role) on an interested-roster row, as returned
+ * inside {@link GroupInterestResponseView.memberLevel}. Mirrors the UI-view
+ * projection of the BE role object: the level is a group role, so the fields
+ * are role-shaped ({@link roleId}/{@link roleName}). The list carries at most
+ * one element — the interest's current/assigned membership level (empty when
+ * none is assigned).
+ */
+export interface InterestMembershipLevel {
+    /** Role id of the membership level (e.g. "ROLE_SAAPPS_..."). */
+    roleId: string;
+    /** Role type id, when categorized; `null` otherwise. */
+    roleType?: string | null;
+    /** Display name of the level (e.g. "Member"). Bound as the dropdown value. */
+    roleName: string;
+    /** Human-readable role type name; `null` otherwise. */
+    roleTypeName?: string | null;
+    /** Display order within the group type's role catalog. */
+    viewOrder?: number;
+}
+/**
+ * One interested-users roster row for a group, as returned by the backend from
+ * {@code GET {apiBaseUrl}/groups/interest/group/{groupId}/responses}.
+ *
+ * Mirrors the UI-view projection of the BE `GroupInterestResponseView` read
+ * object (sa-saapps-groups-api:
+ * org.ieee.standards.groups.model.GroupInterestResponseView). It combines the
+ * interest record with the interested user's name/email, their organization
+ * affiliations for the group, the submitted timestamp, the group's default
+ * membership level (at most one element), and the group's type id, so the whole
+ * "Interested" roster renders in a single call (R8.7). Only `@JsonView(UiView)`
+ * fields are serialized; tenant app_id and audit columns stay hidden.
+ */
+export interface GroupInterestResponseView {
+    /** The interest record id (e.g. "GINT_SAAPPS_..."). */
+    interestId: string;
+    /** The group the interest belongs to (e.g. "GRP_SAAPPS_..."). */
+    groupId?: string;
+    /** The interested user's id (e.g. "User_NESC_..."). */
+    userId: string;
+    /** Interested user's display name. */
+    name: string;
+    /** Interested user's email address. */
+    email: string;
+    /** Organization affiliations for the group (id + name). */
+    affiliation: InterestAffiliation[];
+    /** Submitted timestamp (ISO date string; BE `Date`). */
+    submittedOn: string;
+    /** Group's default membership level (0 or 1 element). */
+    memberLevel: InterestMembershipLevel[];
+    /** The group's group type id. */
+    groupTypeId?: string;
+}
+/**
+ * Request payload for the interested-users roster list endpoint
+ * ({@code POST {apiBaseUrl}/groups/interest/group/{groupId}/responses}).
+ *
+ * Follows the repo payload convention of wrapping the request body in a
+ * {@code payload} key (matching FilterUsersPayload, SearchUsersPayload, etc.).
+ * Supports server-side search ({@link InterestedRostersRequestBody.searchByNameOrEmail})
+ * and pagination/sorting so the "Interested Rosters" table can page and sort
+ * large rosters without loading everything client-side.
+ */
+export interface InterestedRostersRequestPayload {
+    payload: InterestedRostersRequestBody;
+}
+/**
+ * The body of {@link InterestedRostersRequestPayload}. All fields are sent to
+ * the backend to filter, page and sort the interested-users roster.
+ */
+export interface InterestedRostersRequestBody {
+    /** Free-text search term matched against the requester's name or email. */
+    searchByNameOrEmail: string;
+    /** Zero-based row offset for the requested page. */
+    offset: number;
+    /** Number of rows per page. */
+    pageSize: number;
+    /** Column key to sort by (e.g. "name", "submittedOn"). */
+    sortedBy: string;
+    /** Sort direction (e.g. "asc" / "desc"). */
+    sortedOrderBy: string;
+}
+/**
+ * The `body` of the interested-users roster list response, as returned by
+ * {@code POST {apiBaseUrl}/groups/interest/group/{groupId}/responses}.
+ *
+ * The rows live under {@link data}; the remaining fields echo the paging state
+ * ({@link totalRecords}, {@link offset}, {@link pageSize}) so the table can
+ * drive pagination. The outer envelope ({@code status}/{@code message}/
+ * {@code body}) is unwrapped by the HTTP layer, so this models the `body` only.
+ */
+export interface InterestedRostersResponse {
+    /** The interested-roster rows for the requested page. */
+    data: GroupInterestResponseView[];
+    /** Total number of interested-roster rows across all pages. */
+    totalRecords: number;
+    /** Zero-based row offset of the returned page. */
+    offset: number;
+    /** Number of rows per page used for this response. */
+    pageSize: number;
+}
+/**
+ * A single interested-roster row shown in the Roster Management "Interested
+ * Rosters" table. Carries the {@link interestId} needed to fetch that
+ * requester's stored responses via the interest-responses endpoint and to
+ * override their membership level. Rows are produced by mapping the backend
+ * {@link GroupInterestResponseView} list onto this flattened display shape.
+ */
+export interface InterestedRoster {
+    /** The interest record id (e.g. "GINT_SAAPPS_..."), used for responses + override. */
+    interestId: string;
+    /** The interested user's id (e.g. "User_NESC_..."), used for the level override. */
+    userId: string;
+    /** Requester display name. */
+    name: string;
+    /** Requester email address. */
+    email: string;
+    /** Requester affiliations (organizations). */
+    affiliations: string[];
+    /** Submission date, preformatted for display. */
+    submittedOn: string;
+    /** Current/assigned membership level name, or null when none is assigned. */
+    memberLevel: string | null;
+}
+/**
+ * Request payload for overriding/setting an interested user's membership level
+ * ({@code POST {apiBaseUrl}/groups/interest/member-level}).
+ *
+ * Follows the repo payload convention of wrapping the request body in a
+ * {@code payload} key. Identifies the roster row by {@link UpdateMemberLevelBody.groupId}
+ * + {@link UpdateMemberLevelBody.userId} and carries the newly selected role in
+ * {@link UpdateMemberLevelBody.roleId}.
+ */
+export interface UpdateMemberLevelPayload {
+    payload: UpdateMemberLevelBody;
+}
+/**
+ * The body of {@link UpdateMemberLevelPayload}: the group and user being
+ * updated plus the role id of the chosen membership level.
+ */
+export interface UpdateMemberLevelBody {
+    /** The group the interested user belongs to (e.g. "GRP_SAAPPS_..."). */
+    groupId: string;
+    /** The interested user whose membership level is being set (e.g. "User_NESC_..."). */
+    userId: string;
+    /** The selected membership-level role id (e.g. "ROLE_SAAPPS_..."). */
+    roleId: string;
+}

package/lib/models/roster-import.model.d.ts

@@ -54,6 +54,18 @@ export interface RosterImportJob {
     successRows?: number;
     /** Rows skipped due to validation errors. */
     failedRows?: number;
+    /**
+     * When the import was created (ISO timestamp). Drives the "Timestamp" column
+     * in View History. Present only once the BE exposes it (currently @JsonIgnore);
+     * undefined otherwise, in which case the UI shows a placeholder.
+     */
+    createdOn?: string;
+    /**
+     * Who ran the import (user email/name). Drives the "Person Imported" column in
+     * View History. Present only once the BE exposes it (currently @JsonIgnore);
+     * undefined otherwise, in which case the UI shows a placeholder.
+     */
+    createdBy?: string;
     /**
      * Row-level errors from the BE `error_report` JSONB column. Observed to arrive
      * EITHER as a parsed object `{ rows: RosterImportErrorReport[] }` OR as a raw