@ieeesa-npm/groups 0.15.0 → 0.15.2

package/lib/components/add-working-groups/add-working-groups.component.d.ts

@@ -0,0 +1,37 @@
+import { MatDialogRef } from '@angular/material/dialog';
+import { AvailableForeignGroup } from '../../models/reciprocal-credit.model';
+import * as i0 from "@angular/core";
+/** Data passed into the Add Working Groups modal. */
+export interface AddWorkingGroupsDialogData {
+    availableGroups: AvailableForeignGroup[];
+    selectedGroupIds: string[];
+}
+/** Row model with a local selection flag. */
+interface WorkingGroupRow extends AvailableForeignGroup {
+    selected: boolean;
+}
+/**
+ * Modal to select one or more foreign working groups (under the same committee)
+ * for reciprocal credit. Provides search and a checkbox table. Returns the
+ * selected AvailableForeignGroup[] on Add.
+ * @export
+ * @class AddWorkingGroupsComponent
+ */
+export declare class AddWorkingGroupsComponent {
+    private dialogRef;
+    private data;
+    rows: WorkingGroupRow[];
+    searchTerm: string;
+    constructor(dialogRef: MatDialogRef<AddWorkingGroupsComponent>, data: AddWorkingGroupsDialogData);
+    /** Rows filtered by the search term (group name). */
+    get filteredRows(): WorkingGroupRow[];
+    /** Count of currently selected rows (for the title). */
+    get selectedCount(): number;
+    /** Toggle a row's selection. */
+    toggleRow(row: WorkingGroupRow): void;
+    onCancel(): void;
+    onAdd(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AddWorkingGroupsComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<AddWorkingGroupsComponent, "ieeesa-add-working-groups", never, {}, {}, never, never, true, never>;
+}
+export {};

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

@@ -9,6 +9,7 @@ import { GroupInfo } from '../../models/group-info.model';
 import { AlertType } from '@ieeesa-npm/models';
 import { GroupFunctionType } from '../../models/group-function-type.model';
 import { ParentGroupsInfo } from '../../models/parent-groups-info.model';
+import { SelectedForeignGroup } from '../reciprocal-credit-section/reciprocal-credit-section.component';
 import * as i0 from "@angular/core";
 /**
  * CreateGroupComponent uses DynamicFormComponent to build create new group form or edit group and implement the functionalities of submission of form and handling success and error scenarios.
@@ -33,6 +34,9 @@ export declare class CreateGroupComponent implements OnInit, OnDestroy {
     formCancel: EventEmitter<any>;
     createGroupText: {
         heading: string;
+        reciprocalCredit: {
+            selectAtLeastOneGroup: string;
+        };
         label: {
             parentGroup: string;
             changeParentGroup: string;
@@ -56,7 +60,7 @@ export declare class CreateGroupComponent implements OnInit, OnDestroy {
                 parentGroup: string;
                 changeParentGroup: string;
                 newParentGroup: string;
-                groupType: string;
+                groupType: string; /** Config ids of previously-saved reciprocal rows removed locally — for soft-delete on Save. */
                 groupName: string;
                 shortName: string;
                 groupScope: string;
@@ -111,6 +115,13 @@ export declare class CreateGroupComponent implements OnInit, OnDestroy {
     allowedParentGroupsOptions: SelectOption[];
     isParentGroupChanged: boolean;
     slideToggleOption: SlideToggleOption;
+    /** Reciprocal credit state (Working Group only) — captured for Save. */
+    reciprocalEnabled: boolean;
+    reciprocalSelectedGroups: SelectedForeignGroup[];
+    /** Config ids of previously-saved reciprocal rows removed locally — for soft-delete on Save. */
+    reciprocalRemovedConfigIds: string[];
+    /** Group type currently selected in the create form (for gating the section). */
+    selectedCreateGroupTypeId?: string;
     dynamicFormComponent: DynamicFormComponent;
     constructor(groupsService: GroupsService, globalErrorHandlerService: GlobalErrorHandlerService, alertService: AlertsService);
     /**
@@ -166,6 +177,15 @@ export declare class CreateGroupComponent implements OnInit, OnDestroy {
      * @memberof CreateGroupComponent
      */
     editGroup(formData: any): void;
+    /**
+     * Persists reciprocal-credit changes captured from the section after a
+     * successful group edit: POSTs newly-added foreign groups (those without a
+     * configId) and soft-deletes each removed config id. Emits the group-edit
+     * response once persistence completes (or immediately if there's nothing to do).
+     * @param {*} editResponse the successful edit-group response
+     * @memberof CreateGroupComponent
+     */
+    private persistReciprocalCredit;
     /**
      * Captures the server side errors and handles the errors based on the custom or Http errors.
      * @param {HttpErrorResponse} error
@@ -193,6 +213,39 @@ export declare class CreateGroupComponent implements OnInit, OnDestroy {
      * @memberof CreateGroupComponent
      */
     createGroupCancelled(): void;
+    /**
+     * True when the group being created/edited is a Working Group — gates the
+     * Reciprocal Credit section.
+     * @return {boolean}
+     * @memberof CreateGroupComponent
+     */
+    get isWorkingGroup(): boolean;
+    /**
+     * True when the Reciprocal Credit section should be shown: only for a Working
+     * Group in EDIT mode. Hidden during create because the home group has no id
+     * yet and the create flow is still being finalized with the client team.
+     * @return {boolean}
+     * @memberof CreateGroupComponent
+     */
+    get isReciprocalSectionVisible(): boolean;
+    /**
+     * True when the reciprocal section is shown, the toggle is ON, but no foreign
+     * group has been added — an invalid state (BE rejects an empty foreign-group
+     * list). Used to block the edit Save.
+     * @return {boolean}
+     * @memberof CreateGroupComponent
+     */
+    get isReciprocalInvalid(): boolean;
+    /** Home group id for the reciprocal section (present in edit). */
+    get reciprocalHomeGroupId(): string | undefined;
+    /** Parent committee name shown in the reciprocal helper text. */
+    get reciprocalParentCommitteeName(): string | undefined;
+    /** Capture reciprocal toggle state from the section. */
+    onReciprocalEnabledChange(enabled: boolean): void;
+    /** Capture reciprocal foreign-group selection from the section. */
+    onReciprocalSelectionChange(groups: SelectedForeignGroup[]): void;
+    /** Capture the config ids to soft-delete on Save from the section. */
+    onReciprocalRemovedConfigIdsChange(configIds: string[]): void;
     /**
      * Gets allowed parent groups for reassigning the parent.
      * @param {string} groupId

package/lib/components/reciprocal-credit-section/reciprocal-credit-section.component.d.ts

@@ -0,0 +1,102 @@
+import { EventEmitter, OnDestroy, OnInit } from '@angular/core';
+import { MatDialog } from '@angular/material/dialog';
+import { SlideToggleOption } from '@ieeesa-npm/presentation';
+import { Subject } from 'rxjs';
+import { GroupsService } from '../../services/groups.service';
+import { AvailableForeignGroup } from '../../models/reciprocal-credit.model';
+import * as i0 from "@angular/core";
+/**
+ * A selected foreign group shown as a chip. `configId` is present only for groups
+ * that were loaded from an existing (saved) config — it is needed to remove that
+ * specific row on the BE when the group is de-selected or the toggle is turned off.
+ */
+export interface SelectedForeignGroup {
+    groupId: string;
+    groupName: string;
+    configId?: string;
+}
+/**
+ * Reciprocal Credit configuration section shown inside the group create/edit
+ * form — ONLY when the group is a Working Group. Provides the enable toggle,
+ * selected foreign-group chips, and the "+ Add Working Groups" launcher.
+ *
+ * The toggle has no backend flag: it is derived from whether any config rows
+ * exist for the home group. Enabling persists nothing until at least one foreign
+ * group is added (POST); disabling soft-deletes every existing config row
+ * (one POST /{configId}/remove per row).
+ *
+ * The parent form reads `enabled` and `selectedForeignGroups` to build the save
+ * request, and `removedConfigIds` to know which existing rows to remove.
+ * @export
+ * @class ReciprocalCreditSectionComponent
+ */
+export declare class ReciprocalCreditSectionComponent implements OnInit, OnDestroy {
+    private groupsService;
+    private dialog;
+    destroy$: Subject<boolean>;
+    /** Home group id (present in edit; absent in create until the group is saved). */
+    homeGroupId?: string;
+    /** Optional event id for event-scoped configs (omit for global/Groups screen). */
+    eventId?: string;
+    /** Parent committee name for the helper text ("Only groups under ..."). */
+    parentCommitteeName?: string;
+    /** Emits the current enabled state whenever it changes. */
+    enabledChange: EventEmitter<boolean>;
+    /** Emits the current selected foreign groups whenever they change. */
+    selectionChange: EventEmitter<SelectedForeignGroup[]>;
+    /**
+     * Emits the config ids of previously-saved rows that have been removed locally
+     * (chip de-selected or toggle turned off), so the parent can soft-delete each
+     * on save.
+     */
+    removedConfigIdsChange: EventEmitter<string[]>;
+    /** Toggle state. */
+    enabled: boolean;
+    /** Option config for the shared ieeesa-slide-toggle. */
+    toggleOption: SlideToggleOption;
+    /** Selected foreign working groups (chips). */
+    selectedForeignGroups: SelectedForeignGroup[];
+    /**
+     * Persistent map of foreignGroupId → configId for the rows that existed on the
+     * initial load. Kept for the whole edit session so a saved group re-selected
+     * after being de-selected recovers its configId (and its queued removal is undone).
+     */
+    private savedConfigIdByGroupId;
+    /**
+     * Config ids that existed on load but have since been removed locally (either by
+     * de-selecting a chip or turning the toggle off). The parent removes each on save.
+     */
+    removedConfigIds: string[];
+    /** All foreign working groups available under the same committee. */
+    availableGroups: AvailableForeignGroup[];
+    isLoading: boolean;
+    constructor(groupsService: GroupsService, dialog: MatDialog);
+    ngOnInit(): void;
+    /** Fetch the foreign working groups available for selection. */
+    private loadAvailableGroups;
+    /**
+     * Load existing reciprocal config rows for the edit-prefill path. The toggle is
+     * ON when one or more rows exist; each chip keeps its own configId for removal.
+     */
+    private loadExistingConfig;
+    /** Handle the enable/disable toggle (shared ieeesa-slide-toggle emits SlideToggleOption). */
+    onToggleChange(option: SlideToggleOption): void;
+    /** Open the Add Working Groups modal. */
+    onAddWorkingGroups(): void;
+    /**
+     * Merge the modal's returned selection into the current chips. Groups that are
+     * no longer selected but were saved get queued for removal; already-selected
+     * groups keep their existing configId.
+     */
+    private mergeSelection;
+    /** Remove a selected foreign group chip. */
+    removeGroup(groupId: string): void;
+    /** Track saved rows (those with a configId) that must be removed on the BE. */
+    private queueRemovalOf;
+    /** True when the section is valid (toggle off, OR toggle on with ≥1 group). */
+    get isValid(): boolean;
+    private emitState;
+    ngOnDestroy(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ReciprocalCreditSectionComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ReciprocalCreditSectionComponent, "ieeesa-reciprocal-credit-section", never, { "homeGroupId": { "alias": "homeGroupId"; "required": false; }; "eventId": { "alias": "eventId"; "required": false; }; "parentCommitteeName": { "alias": "parentCommitteeName"; "required": false; }; }, { "enabledChange": "enabledChange"; "selectionChange": "selectionChange"; "removedConfigIdsChange": "removedConfigIdsChange"; }, never, never, true, never>;
+}

package/lib/models/reciprocal-credit.model.d.ts

@@ -0,0 +1,51 @@
+/**
+ * A foreign group returned by the `available-groups` endpoint. It is a candidate
+ * that can be selected as a reciprocal-credit source for a home group.
+ *
+ * Real API: GET /v1/meetings/admin/reciprocal-credit/{homeGroupId}/available-groups
+ * Body item shape: { groupId, groupName }
+ * @export
+ * @interface AvailableForeignGroup
+ */
+export interface AvailableForeignGroup {
+    groupId: string;
+    groupName: string;
+}
+/** Scope of a reciprocal-credit config row. */
+export type ReciprocalCreditScope = 'EVENT' | 'GLOBAL';
+/**
+ * A single reciprocal-credit config row. The BE returns one row per foreign
+ * group, each with its own `configId` (needed to remove/soft-delete that row).
+ *
+ * Real API: GET/POST /v1/meetings/admin/reciprocal-credit... → body: ReciprocalCreditConfigRow[]
+ * @export
+ * @interface ReciprocalCreditConfigRow
+ */
+export interface ReciprocalCreditConfigRow {
+    configId: string;
+    homeGroupId: string;
+    foreignGroupId: string;
+    foreignGroupName: string;
+    /** Present only for event-scoped configs. */
+    eventId?: string;
+    scope: ReciprocalCreditScope;
+}
+/**
+ * Payload for saving a reciprocal-credit configuration.
+ * `eventId` is included only for event-scoped configs; omit it for global configs.
+ *
+ * Real API: POST /v1/meetings/admin/reciprocal-credit
+ * @export
+ * @interface SaveReciprocalCreditPayload
+ */
+export interface SaveReciprocalCreditPayload {
+    homeGroupId: string;
+    foreignGroupIds: string[];
+    eventId?: string;
+}
+/** Standard API response wrapper for reciprocal endpoints. */
+export interface ReciprocalCreditResponse<T> {
+    status: boolean;
+    message: string;
+    body: T;
+}

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

@@ -8,6 +8,7 @@ import { GroupInfo } from '../models/group-info.model';
 import { SearchUsersPayload, FilterUsersPayload, GetGroupUsersResponse, User, LoggedInUserInfo } from '../models/user.model';
 import { Role } from '../models/role.model';
 import { EditGroupPayload } from '../models/edit-group.model';
+import { AvailableForeignGroup, ReciprocalCreditConfigRow, ReciprocalCreditResponse, SaveReciprocalCreditPayload } from '../models/reciprocal-credit.model';
 import { GroupFunctionType } from '../models/group-function-type.model';
 import { RosterFunctionType } from '../models/roster-function-type.model';
 import { GroupUserInfo } from '../models/group-user-info.model';
@@ -45,6 +46,14 @@ export declare class GroupsService {
         "1006": string;
         "1007": string;
         "1008": string;
+        /**
+         * Handles custom API errors: maps BE error codes to messages and shows an
+         * alert. Mirrors the events-and-meetings error handling so reciprocal-credit
+         * failures (e.g. MTG-011 duplicate, MTG-012 permission) surface consistently.
+         * @param {*} error the HttpErrorResponse from a failed call
+         * @param {boolean} [showAlert=true] whether to display the alert
+         * @memberof GroupsService
+         */
         "1009": string;
         "1010": string;
         "1011": string;
@@ -67,12 +76,6 @@ export declare class GroupsService {
         "1028": string;
         "1029": string;
         "1030": string;
-        /**
-         * Gets the group users for the given group id.
-         * @param {string} groupId
-         * @return {Observable<GetGroupUsersResponse>}
-         * @memberof GroupsService
-         */
         "1031": string;
         "1032": string;
         "1033": string;
@@ -83,7 +86,11 @@ export declare class GroupsService {
         "1038": string;
         "1039": string;
         "2001": string;
-        "2002": string;
+        "2002": string; /**
+         * Sets group function type.
+         * @param {GroupFunctionType} groupFunctionType -group function type.
+         * @memberof GroupsService
+         */
         "2010": string;
         "2011": string;
         "20l2": string;
@@ -95,16 +102,15 @@ export declare class GroupsService {
         "2018": string;
         "2019": string;
         "2020": string;
-        "2021": string; /**
-         * Gets the group users based on searched name or email
-         * @param {SearchUsersPayload} payload
-         * @return {Observable<GetGroupUsersResponse>}
-         * @memberof GroupsService
-         */
+        "2021": string;
         "2022": string;
         "2023": string;
         "2024": string;
         "3004": string;
+        "MTG-010": string;
+        "MTG-011": string;
+        "MTG-012": string;
+        default: string;
     };
     apiBaseUrl: string;
     userPermission: any;
@@ -180,6 +186,15 @@ export declare class GroupsService {
      * @memberof GroupsService
      */
     parseErrorMessage(errorCodes: string[]): string[];
+    /**
+     * Handles custom API errors: maps BE error codes to messages and shows an
+     * alert. Mirrors the events-and-meetings error handling so reciprocal-credit
+     * failures (e.g. MTG-011 duplicate, MTG-012 permission) surface consistently.
+     * @param {*} error the HttpErrorResponse from a failed call
+     * @param {boolean} [showAlert=true] whether to display the alert
+     * @memberof GroupsService
+     */
+    handleErrors(error: any, showAlert?: boolean): void;
     /**
      * Sets selected group info.
      * @param {(GroupInfo | undefined)} selectedGroupInfo -selected group info.
@@ -429,6 +444,49 @@ export declare class GroupsService {
      * @memberof GroupsService
      */
     getMemberTypes(): Role[];
+    /** Path prefix (relative to apiBaseUrl) for the reciprocal-credit endpoints. */
+    private readonly RECIPROCAL_BASE_PATH;
+    /**
+     * Build a reciprocal-credit endpoint URL from apiBaseUrl + the base path,
+     * guarding against accidental double slashes if apiBaseUrl has a trailing slash.
+     * @param {string} [suffix] extra path/query appended after the base path.
+     * @return {string}
+     */
+    private buildReciprocalUrl;
+    /**
+     * Fetch the foreign groups available for reciprocal credit for a home group.
+     * GET {apiBaseUrl}/meetings/admin/reciprocal-credit/{homeGroupId}/available-groups
+     * @param {string} homeGroupId
+     * @return {Observable<ReciprocalCreditResponse<AvailableForeignGroup[]>>}
+     * @memberof GroupsService
+     */
+    getAvailableReciprocalGroups(homeGroupId: string): Observable<ReciprocalCreditResponse<AvailableForeignGroup[]>>;
+    /**
+     * Load existing reciprocal-credit config rows for a home group (edit prefill).
+     * GET {apiBaseUrl}/meetings/admin/reciprocal-credit/{homeGroupId}[?eventId=...]
+     * Returns one row per foreign group; an empty array means reciprocal credit is off.
+     * @param {string} homeGroupId
+     * @param {string} [eventId] optional — filters to an event-scoped config.
+     * @return {Observable<ReciprocalCreditResponse<ReciprocalCreditConfigRow[]>>}
+     * @memberof GroupsService
+     */
+    getReciprocalConfig(homeGroupId: string, eventId?: string): Observable<ReciprocalCreditResponse<ReciprocalCreditConfigRow[]>>;
+    /**
+     * Save a reciprocal-credit config (creates/reactivates one row per foreign group).
+     * POST {apiBaseUrl}/meetings/admin/reciprocal-credit
+     * @param {SaveReciprocalCreditPayload} payload
+     * @return {Observable<ReciprocalCreditResponse<ReciprocalCreditConfigRow[]>>}
+     * @memberof GroupsService
+     */
+    saveReciprocalCredit(payload: SaveReciprocalCreditPayload): Observable<ReciprocalCreditResponse<ReciprocalCreditConfigRow[]>>;
+    /**
+     * Remove (soft delete) a single reciprocal-credit config row by its configId.
+     * POST {apiBaseUrl}/meetings/admin/reciprocal-credit/{configId}/remove
+     * @param {string} configId
+     * @return {Observable<ReciprocalCreditResponse<null>>}
+     * @memberof GroupsService
+     */
+    removeReciprocalConfig(configId: string): Observable<ReciprocalCreditResponse<null>>;
     static ɵfac: i0.ɵɵFactoryDeclaration<GroupsService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<GroupsService>;
 }

package/package.json

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

package/public-api.d.ts

@@ -1,6 +1,8 @@
 export * from './lib/components/create-group/create-group.component';
 export * from './lib/components/tree-view/tree-view.component';
 export * from './lib/components/edit-user-roles/edit-user-roles.component';
+export * from './lib/components/reciprocal-credit-section/reciprocal-credit-section.component';
+export * from './lib/components/add-working-groups/add-working-groups.component';
 export * from './lib/groups.component';
 export * from './lib/models/create-group.model';
 export * from './lib/models/group-action.model';
@@ -20,6 +22,7 @@ export * from './lib/models/role-type.model';
 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/services/groups.service';
 export * from './lib/assets/form-validations';
 export * from './lib/groups.module';