@ieeesa-npm/groups 0.15.9 → 0.15.10

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

@@ -0,0 +1,75 @@
+import { OnInit } from '@angular/core';
+import { MatDialogRef } from '@angular/material/dialog';
+import { RadioOption, SlideToggleOption } from '@ieeesa-npm/presentation';
+import * as i0 from "@angular/core";
+/**
+ * Standard (locked) question row shown in the Interest Form tab.
+ * @export
+ * @interface StandardQuestionRow
+ */
+export interface StandardQuestionRow {
+    id: number;
+    label: string;
+    tag: string;
+}
+/**
+ * "Interest Form" tab content of the Roster Interests dialog (SP3M-317). The
+ * group admin configures the interest form here: enable/disable the form, view
+ * the locked standard questions, choose the default membership level and manage
+ * custom questions. Interactive controls reuse the shared presentation
+ * components (slide toggle, radio). Persistence via a mocked service and the
+ * custom-question builder will be added in subsequent increments.
+ * @export
+ * @class InterestFormComponent
+ */
+export declare class InterestFormComponent implements OnInit {
+    private dialogRef;
+    constants: any;
+    interestFormTexts: any;
+    changesNotice: any;
+    sectionTitle: any;
+    sectionDescription: any;
+    standardQuestionsTitle: any;
+    standardQuestionsHint: any;
+    defaultMembershipTitle: any;
+    defaultMembershipDescription: any;
+    customQuestionsTitle: any;
+    addQuestionLabel: any;
+    standardTag: any;
+    cancelLabel: any;
+    previewLabel: any;
+    enableFormToggle: SlideToggleOption;
+    standardQuestions: StandardQuestionRow[];
+    membershipLevels: RadioOption[];
+    isFormEnabled: boolean;
+    constructor(dialogRef: MatDialogRef<unknown>);
+    /**
+     * Initializes the toggle, locked standard questions and default membership
+     * level options from constants.
+     * @memberof InterestFormComponent
+     */
+    ngOnInit(): void;
+    /**
+     * Updates the form-enabled state when the toggle changes so the dependent
+     * sections show or hide accordingly.
+     * @param {SlideToggleOption} toggle
+     * @memberof InterestFormComponent
+     */
+    onEnableFormToggle(toggle: SlideToggleOption): void;
+    /**
+     * Closes the Roster Interests dialog (Cancel action).
+     * @memberof InterestFormComponent
+     */
+    onCancel(): void;
+    /**
+     * Returns the unique identifier for a standard question row for ngFor
+     * tracking.
+     * @param {number} index
+     * @param {StandardQuestionRow} question
+     * @return {number}
+     * @memberof InterestFormComponent
+     */
+    trackByFn(index: number, question: StandardQuestionRow): number;
+    static ɵfac: i0.ɵɵFactoryDeclaration<InterestFormComponent, [{ optional: true; }]>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<InterestFormComponent, "ieeesa-interest-form", never, {}, {}, never, never, true, never>;
+}

package/lib/components/interest-form-management/interest-form-management.component.d.ts

@@ -0,0 +1,31 @@
+import { MatDialogRef } from '@angular/material/dialog';
+import { Tab } from '@ieeesa-npm/presentation';
+import { GroupInfo } from '../../models/group-info.model';
+import * as i0 from "@angular/core";
+/**
+ * Roster Interests dialog host (SP3M-317). Opened from the "Manage Interest
+ * Form" action on a group row. Renders a two-tab layout using the shared
+ * TabsComponent: "Interested Rosters" (submissions list) and "Interest Form"
+ * (admin configuration). The group being managed is provided via the dialog
+ * data. The tab content components are rendered dynamically by TabsComponent
+ * through each tab's componentRef.
+ * @export
+ * @class InterestFormManagementComponent
+ */
+export declare class InterestFormManagementComponent {
+    dialogRef: MatDialogRef<InterestFormManagementComponent>;
+    group: GroupInfo;
+    constants: any;
+    rosterInterestsTexts: any;
+    heading: any;
+    closeAriaLabel: any;
+    tabs: Tab[];
+    constructor(dialogRef: MatDialogRef<InterestFormManagementComponent>, group: GroupInfo);
+    /**
+     * Closes the Roster Interests dialog.
+     * @memberof InterestFormManagementComponent
+     */
+    onClose(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<InterestFormManagementComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<InterestFormManagementComponent, "ieeesa-interest-form-management", never, {}, {}, never, never, true, never>;
+}

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

@@ -0,0 +1,17 @@
+import * as i0 from "@angular/core";
+/**
+ * "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).
+ * @export
+ * @class InterestedRostersComponent
+ */
+export declare class InterestedRostersComponent {
+    constants: any;
+    interestedRostersTexts: any;
+    placeholderMessage: any;
+    static ɵfac: i0.ɵɵFactoryDeclaration<InterestedRostersComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<InterestedRostersComponent, "ieeesa-interested-rosters", never, {}, {}, never, never, true, never>;
+}

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

@@ -1,22 +1,46 @@
-import { EventEmitter, OnDestroy } from '@angular/core';
+import { EventEmitter, OnDestroy, OnInit } from '@angular/core';
 import { Subject } from 'rxjs';
-import { RosterUploadError, RosterUploadResponse } from '../../models/roster-import.model';
+import { RosterImportJob } from '../../models/roster-import.model';
+import { RosterImportApiService } from '../../services/roster-import-api.service';
+import { GroupsService } from '../../services/groups.service';
 import * as i0 from "@angular/core";
 /** States of the roster import flow. */
 type RosterImportState = 'upload' | 'processing' | 'result';
 /**
- * Roster Import dialog (MOCK data phase).
+ * View-model for the result screen. Populated from the confirmed
+ * {@link RosterImportJob} returned by the backend.
+ */
+interface RosterImportResult {
+    totalRecords: number;
+    successCount: number;
+    failureCount: number;
+}
+/** Row error shown on the result screen (mapped from the BE error report). */
+interface RosterImportRowError {
+    rowNumber: number;
+    field?: string;
+    errorMessage: string;
+}
+/**
+ * Roster Import dialog.
  *
- * Lets an admin upload a CSV/XLS/XLSX roster file, shows a processing progress
+ * Lets an admin upload a CSV/XLSX roster file, shows a processing progress
  * bar, then a result summary (added / skipped) with per-row errors and an
- * error-log download. Mirrors the events-and-meetings bulk-import-participants
- * flow. The real backend is not wired yet — {@link onImport} resolves a mock
- * response after a short delay so every Figma state can be exercised.
+ * error-log download.
+ *
+ * Wired to the real backend roster-import state machine
+ * (sa-saapps-groups-api `RosterImportController`) via
+ * {@link RosterImportApiService}: on Import it runs
+ * upload → validate → confirm and renders the confirmed job's terminal counts
+ * and per-row errors. Server-side validation errors (1072 unsupported format,
+ * 1073 too large, 1074 row limit, 1075 invalid status) are surfaced inline.
  *
  * @export
  * @class RosterImportComponent
  */
-export declare class RosterImportComponent implements OnDestroy {
+export declare class RosterImportComponent implements OnInit, OnDestroy {
+    private rosterImportApiService;
+    private groupService;
     /** Carries the { groupId, groupName } payload from the opening dialog. */
     componentData: any;
     /** Emitted after an import that added at least one row (parent refreshes). */
@@ -32,12 +56,10 @@ export declare class RosterImportComponent implements OnDestroy {
     selectedFile: File | null;
     /** File drag-over state. */
     isDragOver: boolean;
-    /** Processing progress percentage (0–100) shown next to the progress bar. */
-    progressValue: number;
-    /** Terminal upload result (mock). */
-    uploadResult: RosterUploadResponse | null;
+    /** Terminal upload result. */
+    uploadResult: RosterImportResult | null;
     /** Row-level errors for the completed job. */
-    jobErrors: RosterUploadError[];
+    jobErrors: RosterImportRowError[];
     /** Inline validation / API error message. */
     errorMessage: string | null;
     /**
@@ -45,21 +67,24 @@ export declare class RosterImportComponent implements OnDestroy {
      * (Figma: "No roster data found...").
      */
     noDataMessage: string | null;
-    /** Maximum file size in bytes (5 MB). */
-    readonly MAX_FILE_SIZE = 5242880;
-    /** Accepted file extensions. */
+    /** The import job id returned by upload (kept so cancel can clean it up). */
+    private importId;
+    /** Maximum file size in bytes (10 MB) — matches the BE 10MB limit. */
+    readonly MAX_FILE_SIZE = 10485760;
+    /** Accepted file extensions (must match the BE contract: only .csv / .xlsx). */
     readonly ACCEPTED_EXTENSIONS: string[];
-    /**
-     * MOCK ONLY: which scenario the next import simulates. Cycles through the
-     * scenarios so QA can see every result state by importing repeatedly. Remove
-     * when the real API is wired in.
-     */
-    private mockScenarios;
-    private mockScenarioIndex;
+    constructor(rosterImportApiService: RosterImportApiService, groupService: GroupsService);
     /** Required column headers for display. */
     get requiredColumns(): string[];
     /** Comma-separated accepted file types for the input element. */
     get acceptedFileTypes(): string;
+    /** The target group id from the dialog payload (falls back to selection). */
+    private get groupId();
+    /**
+     * Sets the API base URL on the import service.
+     * @memberof RosterImportComponent
+     */
+    ngOnInit(): void;
     /**
      * Cleans up subscriptions when the component is destroyed.
      * @memberof RosterImportComponent
@@ -106,20 +131,41 @@ export declare class RosterImportComponent implements OnDestroy {
      */
     onRemoveFile(): void;
     /**
-     * MOCK: "uploads" the file by simulating a short processing delay, then
-     * resolves the next mock scenario. Replace the timer + mock lookup with the
-     * real service call once the API is available.
+     * Runs the real import: upload → validate → confirm. The progress bar is
+     * shown in indeterminate mode while the chain is in flight, then the
+     * confirmed job's terminal counts + per-row errors drive the result screen.
      * @memberof RosterImportComponent
      */
     onImport(): void;
     /**
-     * Stores the terminal result and moves to the result state. When the file
-     * had no data rows, shows the "no roster data" info banner instead of the
-     * summary cards.
-     * @param {RosterUploadResponse} body - The terminal (mock) result.
+     * Maps a failed import call to an inline error message and returns the UI to
+     * the upload state so the user can retry. Known BE error codes (1072–1075)
+     * are mapped via constants; anything else uses the generic message.
+     * @param {*} error - The HttpErrorResponse.
      * @memberof RosterImportComponent
      */
-    finalizeResult(body: RosterUploadResponse): void;
+    private handleImportError;
+    /**
+     * Stores the terminal result and moves to the result state. When the job had
+     * no data rows, shows the "no roster data" info banner instead of the summary
+     * cards.
+     * @param {RosterImportJob} job - The confirmed import job.
+     * @memberof RosterImportComponent
+     */
+    finalizeResult(job: RosterImportJob): void;
+    /**
+     * Parses the BE `errorReport` raw JSON string 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.
+     * @return {RosterImportRowError[]}
+     * @memberof RosterImportComponent
+     */
+    private parseErrorReport;
     /**
      * Whether the result state should show the summary cards (added / skipped).
      * Hidden for the "no data records" case.
@@ -166,13 +212,6 @@ export declare class RosterImportComponent implements OnDestroy {
      * @memberof RosterImportComponent
      */
     private triggerDownload;
-    /**
-     * MOCK ONLY: returns the next scenario in the cycle so repeated imports show
-     * every result state.
-     * @return {RosterImportMockScenario}
-     * @memberof RosterImportComponent
-     */
-    private nextMockScenario;
     static ɵfac: i0.ɵɵFactoryDeclaration<RosterImportComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<RosterImportComponent, "ieeesa-roster-import", never, { "componentData": { "alias": "componentData"; "required": false; }; }, { "submitFormResponse": "submitFormResponse"; "formCancel": "formCancel"; }, never, never, true, never>;
 }

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

@@ -0,0 +1,102 @@
+import { ChangeDetectorRef, OnDestroy, OnInit } from '@angular/core';
+import { TableActions, TableColumnSchema } from '@ieeesa-npm/presentation';
+import { GlobalErrorHandlerService } from '@ieeesa-npm/utility';
+import { RosterImportApiService } from '../../services/roster-import-api.service';
+import { GroupsService } from '../../services/groups.service';
+import * as i0 from "@angular/core";
+/** A single row shown in the "Imported Files" table. */
+interface RosterImportHistoryRow {
+    timestamp: string;
+    personImported: string;
+    fileName: string;
+    addedRows: number | string;
+    errors: number | string;
+    targetGroup: string;
+}
+/**
+ * Roster import-history ("View History") dialog body.
+ *
+ * Rendered inside the shared ModalComponent (which supplies the
+ * "← Back to Rosters / View History" breadcrumb title row + X close). Shows the
+ * selected group's name and an "Imported Files" table listing prior roster
+ * imports.
+ *
+ * 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).
+ *
+ * @export
+ * @class RosterImportHistoryComponent
+ */
+export declare class RosterImportHistoryComponent implements OnInit, OnDestroy {
+    private rosterImportApiService;
+    private groupService;
+    private cdr;
+    private globalErrorHandlerService;
+    /** Carries the { groupId, groupName } payload from the opening dialog. */
+    componentData: any;
+    constants: any;
+    screenTexts: any;
+    private destroy$;
+    /** Table column definitions for the "Imported Files" table. */
+    columnSchema: TableColumnSchema[];
+    /** Import-history rows mapped for the table. */
+    tableData: RosterImportHistoryRow[];
+    /** True while the history request is in flight. */
+    isLoading: boolean;
+    /** Inline error message when the history request fails. */
+    errorMessage: string | null;
+    /** Read-only table — no search / filter / add / edit / delete actions. */
+    tableActions: TableActions;
+    /** Placeholder shown for fields the BE does not return (timestamp / person). */
+    private readonly placeholder;
+    constructor(rosterImportApiService: RosterImportApiService, groupService: GroupsService, cdr: ChangeDetectorRef, globalErrorHandlerService: GlobalErrorHandlerService);
+    /** The group name shown as the heading above the Imported Files table. */
+    get groupName(): string;
+    /** The group id whose history is fetched. */
+    private get groupId();
+    /**
+     * Builds the table schema and loads the import history from the BE.
+     * @memberof RosterImportHistoryComponent
+     */
+    ngOnInit(): void;
+    /**
+     * Cleans up subscriptions when the component is destroyed.
+     * @memberof RosterImportHistoryComponent
+     */
+    ngOnDestroy(): void;
+    /**
+     * Fetches the import history for the current group and maps it to table rows.
+     * @memberof RosterImportHistoryComponent
+     */
+    loadImportHistory(): void;
+    /**
+     * Maps a BE import job to a table row. Timestamp and Person Imported are not
+     * present in the response (BE `@JsonIgnore`), so they render a placeholder.
+     * Target Group uses the current group's name (history is per-group).
+     * @param {RosterImportJob} job - The BE import job.
+     * @return {RosterImportHistoryRow}
+     * @memberof RosterImportHistoryComponent
+     */
+    private mapJobToRow;
+    /**
+     * Maps a failed history request to a user-facing inline error message.
+     * A 403 gets the permission-specific message; other errors get the generic
+     * one and are forwarded to the global handler for logging/interceptors.
+     * @param {*} error - The HttpErrorResponse.
+     * @memberof RosterImportHistoryComponent
+     */
+    private handleError;
+    /**
+     * Defines the "Imported Files" table columns.
+     * @memberof RosterImportHistoryComponent
+     */
+    private buildColumnSchema;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RosterImportHistoryComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RosterImportHistoryComponent, "ieeesa-roster-import-history", never, { "componentData": { "alias": "componentData"; "required": false; }; }, {}, never, never, true, never>;
+}
+export {};

package/lib/components/tree-view/tree-view.component.d.ts

@@ -155,6 +155,7 @@ export declare class TreeViewComponent implements OnInit, AfterViewInit, OnDestr
     editGroupClick: EventEmitter<EditGroupAndParentInfo>;
     deleteGroupClick: EventEmitter<GroupInfo>;
     viewRosterClick: EventEmitter<GroupInfo>;
+    manageInterestFormClick: EventEmitter<GroupInfo>;
     isMobileView: boolean;
     groupFunctionType: typeof GroupFunctionType;
     constructor(database: Groups, elementRef: ElementRef, groupsService: GroupsService, breakpointObserverService: BreakpointObserverService);
@@ -263,8 +264,10 @@ export declare class TreeViewComponent implements OnInit, AfterViewInit, OnDestr
      */
     getToggleButtonInfo(group: GroupNode): IconButton;
     /**
-     * Handles the emitted group actions event
-     * @param {GroupInfo} group
+     * Handles the emitted group actions event. Emits the corresponding output
+     * for the selected action: view roster, create sub group, edit group,
+     * delete group, or manage interest form.
+     * @param {GroupNode} group
      * @memberof TreeViewComponent
      */
     handleGroupActions(group: GroupNode): void;
@@ -289,5 +292,5 @@ export declare class TreeViewComponent implements OnInit, AfterViewInit, OnDestr
      */
     ngOnDestroy(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<TreeViewComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<TreeViewComponent, "ieeesa-tree", never, { "parentGroupsInfo": { "alias": "parentGroupsInfo"; "required": false; }; "childGroupsInfo": { "alias": "childGroupsInfo"; "required": false; }; "isGroupSearchOrFilterActive": { "alias": "isGroupSearchOrFilterActive"; "required": false; }; "deletedGroupIdInfo": { "alias": "deletedGroupIdInfo"; "required": false; }; "userGroupPermissions": { "alias": "userGroupPermissions"; "required": false; }; }, { "toggleGroupClick": "toggleGroupClick"; "createGroupClick": "createGroupClick"; "editGroupClick": "editGroupClick"; "deleteGroupClick": "deleteGroupClick"; "viewRosterClick": "viewRosterClick"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<TreeViewComponent, "ieeesa-tree", never, { "parentGroupsInfo": { "alias": "parentGroupsInfo"; "required": false; }; "childGroupsInfo": { "alias": "childGroupsInfo"; "required": false; }; "isGroupSearchOrFilterActive": { "alias": "isGroupSearchOrFilterActive"; "required": false; }; "deletedGroupIdInfo": { "alias": "deletedGroupIdInfo"; "required": false; }; "userGroupPermissions": { "alias": "userGroupPermissions"; "required": false; }; }, { "toggleGroupClick": "toggleGroupClick"; "createGroupClick": "createGroupClick"; "editGroupClick": "editGroupClick"; "deleteGroupClick": "deleteGroupClick"; "viewRosterClick": "viewRosterClick"; "manageInterestFormClick": "manageInterestFormClick"; }, never, never, true, never>;
 }

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

@@ -188,6 +188,11 @@ export declare class ViewRosterComponent implements AfterViewInit, OnDestroy, On
      * @memberof ViewRosterComponent
      */
     onImportRoster(): void;
+    /**
+     * "View History" action — opens the roster import-history popup.
+     * @memberof ViewRosterComponent
+     */
+    onViewHistory(): void;
     /**
      * Handles alerts for success, error, warning.
      * @param {(string | string[])} message -error or warning message

package/lib/groups.component.d.ts

@@ -117,12 +117,29 @@ export declare class GroupsComponent implements OnInit, OnDestroy {
      * @memberof GroupsComponent
      */
     openRosterImportModal(selectedGroupInfo: GroupInfo): void;
+    /**
+     * Sets the dialog options for the roster import-history ("View History")
+     * modal and opens it. Passes the selected group's id/name to the
+     * dynamically-instantiated RosterImportHistoryComponent via the
+     * ModalComponent dynamic-input pattern.
+     * @param {GroupInfo} selectedGroupInfo
+     * @memberof GroupsComponent
+     */
+    openRosterImportHistoryModal(selectedGroupInfo: GroupInfo): void;
     /**
      * Sets the dialog options for users modal and calls openModal method.
      * @param {GroupInfo} group
      * @memberof GroupsComponent
      */
     viewRoster(group: GroupInfo): void;
+    /**
+     * Opens the Roster Interests dialog for the selected group (SP3M-317). The
+     * dialog hosts the "Interested Rosters" and "Interest Form" tabs and receives
+     * the group via the dialog data.
+     * @param {GroupInfo} group
+     * @memberof GroupsComponent
+     */
+    openRosterInterests(group: GroupInfo): void;
     /**
      * Opens modal component with for received params and handles form submission success and errors.
      * @param {*} dialogOptions

package/lib/models/group-action.model.d.ts

@@ -4,5 +4,6 @@ export declare enum GroupAction {
     EDIT_GROUP = 3,
     DELETE_GROUP = 4,
     EXPAND_GROUP_VIEW = 5,
-    COLLAPSE_GROUP_VIEW = 6
+    COLLAPSE_GROUP_VIEW = 6,
+    MANAGE_INTEREST_FORM = 7
 }

package/lib/models/group-function-type.model.d.ts

@@ -8,5 +8,6 @@ export declare enum GroupFunctionType {
     REASSIGN_PARENT_GROUP = "REASSIGN_PARENT_GROUP",
     EDIT_ROSTER_USER_ROLE = "EDIT_ROSTER_USER_ROLE",
     ADD_USER_TO_ROSTER = "ADD_USER_TO_ROSTER",
-    IMPORT_ROSTER = "IMPORT_ROSTER"
+    IMPORT_ROSTER = "IMPORT_ROSTER",
+    VIEW_IMPORT_HISTORY = "VIEW_IMPORT_HISTORY"
 }

package/lib/models/permission-type.model.d.ts

@@ -12,5 +12,6 @@ export declare enum PermissionType {
     VIEW_ALL_GROUPS = "VIEW_ALL_GROUPS",
     MANAGE_ALL_GROUPS = "MANAGE_ALL_GROUPS",
     VIEW_ALL_ROSTERS = "VIEW_ALL_ROSTERS",
-    MANAGE_ALL_ROSTERS = "MANAGE_ALL_ROSTERS"
+    MANAGE_ALL_ROSTERS = "MANAGE_ALL_ROSTERS",
+    MANAGE_CUSTOM_INTEREST_QUESTIONS = "MANAGE_CUSTOM_INTEREST_QUESTIONS"
 }

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

@@ -1,5 +1,101 @@
 /**
- * Terminal status of a roster bulk-upload job.
+ * Roster-import status state machine. Mirrors the BE `ImportStatus` enum
+ * (sa-saapps-groups-api: org.ieee.standards.groups.model.ImportStatus) and the
+ * `status` CHECK constraint on `roster_import_job_tb`.
+ *
+ * - PENDING    upload accepted, awaiting validation (default)
+ * - VALIDATING rows are being validated
+ * - COMPLETED  all rows imported successfully (terminal)
+ * - FAILED     no rows imported successfully (terminal)
+ * - PARTIAL    some rows imported, some failed (terminal)
+ */
+export declare enum RosterImportStatus {
+    PENDING = "PENDING",
+    VALIDATING = "VALIDATING",
+    COMPLETED = "COMPLETED",
+    FAILED = "FAILED",
+    PARTIAL = "PARTIAL"
+}
+/**
+ * A single per-row validation error stored in the import job's `error_report`
+ * JSONB column. Mirrors the BE `ErrorReport` POJO ({@code {row, field, message}}).
+ */
+export interface RosterImportErrorReport {
+    /** 1-based data-row number in the uploaded file. */
+    row: number;
+    /** The field/column the error relates to (e.g. "Name", "Email"). */
+    field?: string;
+    /** Human-readable error message. */
+    message: string;
+}
+/**
+ * Roster import job as returned by the BE (upload / confirm / history).
+ * Mirrors the JSON-serialized view of the BE `RosterImportJob` entity.
+ *
+ * IMPORTANT: The BE marks `createdOn`, `createdBy`, `updatedOn`, `updatedBy` as
+ * `@JsonIgnore`, so the response carries NO timestamp and NO importer identity.
+ * If the "View History" screen needs those (Timestamp / Person Imported
+ * columns), the BE must expose them first — this is a BE change, tracked
+ * separately. `errorReport` arrives as a raw JSON string (JSONB passthrough);
+ * parse it into {@link RosterImportErrorReport}[] on the client when needed.
+ */
+export interface RosterImportJob {
+    /** Import job identifier. */
+    importId: string;
+    /** The target group the roster was imported into. */
+    groupId: string;
+    /** Uploaded file name (e.g. "07_tenant_custom_fields.csv"). */
+    fileName?: string;
+    /** Current status (see {@link RosterImportStatus}). */
+    status: string;
+    /** Total data rows detected (`totalRows = successRows + failedRows`). */
+    totalRows?: number;
+    /** Rows successfully added/updated. */
+    successRows?: number;
+    /** 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}[].
+     */
+    errorReport?: string;
+}
+/**
+ * Per-row validation outcome in a validate/preview response. Mirrors the BE
+ * `RosterImportRowOutcome` POJO.
+ */
+export interface RosterImportRowOutcome {
+    /** 1-based data-row number in the uploaded file. */
+    row: number;
+    /** Whether this row passed validation. */
+    valid: boolean;
+    /** The field/column the error relates to, for an invalid row. */
+    field?: string;
+    /** Validation error message, for an invalid row. */
+    error?: string;
+}
+/**
+ * Validation preview returned by validate / preview. Mirrors the BE
+ * `RosterImportPreview` POJO. Building a preview commits no roster changes.
+ * `rows` is never null (BE guarantees an empty list at minimum).
+ */
+export interface RosterImportPreview {
+    /** Import job identifier. */
+    importId: string;
+    /** Current status (see {@link RosterImportStatus}). */
+    status: string;
+    /** Total data rows (`totalRows = successRows + failedRows`). */
+    totalRows: number;
+    /** Rows that passed validation. */
+    successRows: number;
+    /** Rows that failed validation. */
+    failedRows: number;
+    /** Per-row outcomes (never null). */
+    rows: RosterImportRowOutcome[];
+}
+/**
+ * @deprecated Use {@link RosterImportStatus} instead. Retained for backward
+ * compatibility with the pre-BE-integration public API.
  */
 export declare enum RosterUploadStatus {
     PROCESSING = "PROCESSING",
@@ -7,7 +103,9 @@ export declare enum RosterUploadStatus {
     FAILED = "FAILED"
 }
 /**
- * A single row-level error from the roster import validation.
+ * @deprecated Use {@link RosterImportErrorReport} (`{ row, field, message }`)
+ * or {@link RosterImportRowOutcome} instead. Retained for backward
+ * compatibility with the pre-BE-integration public API.
  */
 export interface RosterUploadError {
     /** 1-based row number in the uploaded file. */
@@ -20,13 +118,12 @@ export interface RosterUploadError {
     errorMessage: string;
 }
 /**
- * Terminal result of a roster bulk-upload job.
- *
- * NOTE: This is a MOCK-friendly shape used to build the UI before the real API
- * is available. It will be reconciled with the backend contract once shared.
+ * @deprecated Use {@link RosterImportJob} (confirm/history) or
+ * {@link RosterImportPreview} (validate) instead. Retained for backward
+ * compatibility with the pre-BE-integration public API.
  */
 export interface RosterUploadResponse {
-    /** Job identifier (unused by the mock flow, kept for parity with the API). */
+    /** Job identifier. */
     uploadJobId?: string;
     /** Terminal job status. */
     status: RosterUploadStatus;
@@ -39,17 +136,3 @@ export interface RosterUploadResponse {
     /** Row-level errors (present when failureCount > 0). */
     rowErrors: RosterUploadError[];
 }
-/**
- * The kind of mock scenario to simulate, so the UI can be exercised against
- * each Figma state without a backend.
- */
-export declare enum RosterImportMockScenario {
-    /** All rows imported successfully (Figma: 30 added / 0 skipped). */
-    ALL_SUCCESS = "ALL_SUCCESS",
-    /** Some rows imported, some skipped with errors (partial). */
-    PARTIAL = "PARTIAL",
-    /** Every row skipped with errors (Figma: 0 added / 30 skipped). */
-    ALL_SKIPPED = "ALL_SKIPPED",
-    /** File contained headers but zero data rows (Figma: "No roster data found"). */
-    EMPTY = "EMPTY"
-}

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

@@ -77,6 +77,10 @@ export declare class GroupsService {
         "1037": string;
         "1038": string;
         "1039": string;
+        "1072": string;
+        "1073": string;
+        "1074": string;
+        "1075": string;
         "2001": string;
         "2002": string;
         "2010": string;