@ieeesa-npm/groups 0.15.26 → 0.15.28

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

@@ -272,7 +272,17 @@ export declare class TreeViewComponent implements OnInit, AfterViewInit, OnDestr
      */
     handleGroupActions(group: GroupNode): void;
     /**
-     * Returns the filtered menu items based on groups hasChildren.
+     * Returns the group action menu items the current user may see for the given
+     * group, filtered by per-group permissions and group type. The "Manage
+     * Interest Form" action (SP3M-380) is gated: it renders only when the
+     * interest-form feature is enabled for the tenant
+     * (GroupsService.isInterestFormFeatureEnabled()) AND either the user holds the
+     * VIEW_AND_MANAGE_GROUP_INTEREST permission for that specific group (strictly
+     * per-group, no global fallback) OR the user is a cross-group admin holding
+     * MANAGE_ALL_GROUPS ("Manage All Group Details"). It is always hidden on
+     * admin/system group types (e.g. the System Users Group), which are not real
+     * committees with an interest form, and hidden entirely when the feature is
+     * disabled. When shown it is kept leftmost by the trailing sort.
      * @param {GroupNode} group
      * @return {Menu[]}
      * @memberof TreeViewComponent

package/lib/groups.component.d.ts

@@ -16,6 +16,7 @@ import { GroupPermission, UserPermission } from './models/group-permissions.mode
 import { PermissionType } from './models/permission-type.model';
 import { GroupPermissionsMapService } from './services/group-permissions-map-service';
 import { LoggedInUserInfo } from './models/user.model';
+import { TenantFeature } from './models/tenant-feature.model';
 import * as i0 from "@angular/core";
 /**
  * Groups component is a wrapper or container component for groups management reusable component and in this component integrates all group management functionalities and this will be entry component for managing groups when it is consumed in other applications.
@@ -76,6 +77,19 @@ export declare class GroupsComponent implements OnInit, OnDestroy {
      */
     set requiredProfileFields(value: string[] | null | undefined);
     get requiredProfileFields(): string[];
+    private _tenantFeatures;
+    /**
+     * Tenant feature flags supplied by the host app from its cached tenant
+     * configuration. Passed to GroupsService so interest-form UI (e.g. the
+     * "Manage Interest Form" tree action) is gated on whether the feature is
+     * enabled for the tenant. Optional — defaults to none (fail-closed).
+     *
+     * 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 tenantFeatures(value: TenantFeature[] | null | undefined);
+    get tenantFeatures(): TenantFeature[];
     permissionType: typeof PermissionType;
     functionType: GroupFunctionType;
     alignmentType: typeof AlignType;
@@ -256,5 +270,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; }; "requiredProfileFields": { "alias": "requiredProfileFields"; "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; }; "tenantFeatures": { "alias": "tenantFeatures"; "required": false; }; }, {}, never, never, true, never>;
 }

package/lib/models/feature-flag.model.d.ts

@@ -0,0 +1,3 @@
+export declare enum FeatureFlag {
+    INTEREST_FORM = "FEATURE_INTEREST_FORM"
+}

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

@@ -13,6 +13,6 @@ export declare enum PermissionType {
     MANAGE_ALL_GROUPS = "MANAGE_ALL_GROUPS",
     VIEW_ALL_ROSTERS = "VIEW_ALL_ROSTERS",
     MANAGE_ALL_ROSTERS = "MANAGE_ALL_ROSTERS",
-    MANAGE_CUSTOM_INTEREST_QUESTIONS = "MANAGE_CUSTOM_INTEREST_QUESTIONS",
+    VIEW_AND_MANAGE_GROUP_INTEREST = "VIEW_AND_MANAGE_GROUP_INTEREST",
     RESTRICT_GROUPS_AND_ROSTERS = "RESTRICT_GROUPS_AND_ROSTERS"
 }

package/lib/models/tenant-feature.model.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Tenant feature flag as surfaced by the host application. Mirrors the host's
+ * `TenantFeature` shape (shared.state.ts); the groups reusable library cannot
+ * import the host state, so the shape is duplicated locally.
+ */
+export interface TenantFeature {
+    featureId: string;
+    featureName?: string;
+    isDeleted?: boolean;
+    /**
+     * The application (tenant) this feature flag belongs to. Present in the
+     * host's cached payload; used to scope the origin-wide TENANT_FEATURES cache
+     * to the active application so another app's flags cannot bleed through.
+     */
+    appId?: string;
+}

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

@@ -22,6 +22,7 @@ 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';
+import { TenantFeature } from '../models/tenant-feature.model';
 import { UserPermissionsService } from './user-permissions.service';
 import { GroupPermissionsMapService } from './group-permissions-map-service';
 import { ParentGroupsInfo } from '../models/parent-groups-info.model';
@@ -116,6 +117,12 @@ export declare class GroupsService {
      * list and the sample file. Empty when the tenant has none configured.
      */
     requiredProfileFields: string[];
+    /**
+     * Tenant feature flags supplied by the host app. Used by
+     * {@link isInterestFormFeatureEnabled} to gate interest-form UI. Empty when
+     * the host has not provided any features (fail-closed).
+     */
+    tenantFeatures: TenantFeature[];
     selectedGroupInfo: GroupInfo | undefined;
     groupFunctionType: GroupFunctionType;
     selectedGroupParentInfo: GroupInfo | undefined;
@@ -138,6 +145,33 @@ export declare class GroupsService {
      * @memberof GroupsService
      */
     setRequiredProfileFields(requiredProfileFields: string[]): void;
+    /**
+     * Stores the tenant feature flags provided by the host app. Consumed by
+     * {@link isInterestFormFeatureEnabled} to gate interest-form UI.
+     * @param {TenantFeature[]} tenantFeatures - Tenant feature flags.
+     * @memberof GroupsService
+     */
+    setTenantFeatures(tenantFeatures: TenantFeature[]): void;
+    /**
+     * Returns the tenant feature flags (never null).
+     *
+     * Reads the local storage cache the hosting application writes at login (key
+     * `TENANT_FEATURES`, a bare `TenantFeature[]`) as the source of truth, so the
+     * interest-form gate reflects the tenant configuration regardless of the
+     * @Input/resolver timing.
+     *
+     * The cache is only trusted when it is well-formed for the active
+     * application: it must be an array and its entries must belong to the current
+     * user's `appId`. The `TENANT_FEATURES` key is origin-wide, so a cache written
+     * by another application on the same origin could otherwise flip the
+     * interest-form gate with a different tenant's flags. When the cache is
+     * missing, malformed, or scoped to another app, it falls back to the in-memory
+     * value set via {@link setTenantFeatures} (the host @Input), then to an empty
+     * list.
+     * @return {TenantFeature[]}
+     * @memberof GroupsService
+     */
+    getTenantFeatures(): TenantFeature[];
     /**
      * Returns the tenant-level required profile fields (never null).
      *
@@ -424,6 +458,17 @@ export declare class GroupsService {
      * @memberof GroupsService
      */
     validateAccess(permissionType: PermissionType, permissions?: UserPermission[] | null): boolean;
+    /**
+     * SP3M-380: Returns true when the interest-form feature
+     * (`FEATURE_INTEREST_FORM`) is enabled for the current tenant. A single
+     * boolean capability check the UI gates on. Reads the tenant features from
+     * {@link getTenantFeatures} (local storage cache first, then the host
+     * @Input). Fail-closed: an empty/undefined feature list, or a feature marked
+     * deleted, yields false.
+     * @return {boolean}
+     * @memberof GroupsService
+     */
+    isInterestFormFeatureEnabled(): boolean;
     /**
      * Store the loaded group types.
      * @param {GroupTypeConfiguration[]} groupTypes

package/package.json

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

package/public-api.d.ts

@@ -34,6 +34,7 @@ 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/models/tenant-feature.model';
 export * from './lib/services/groups.service';
 export * from './lib/services/roster-export.service';
 export * from './lib/services/roster-import-api.service';