@ieeesa-npm/groups 0.15.14 → 0.15.15

package/lib/components/custom-question-editor/custom-question-editor.component.d.ts

@@ -0,0 +1,75 @@
+import { EventEmitter, OnInit } from '@angular/core';
+import { FormBuilder, FormGroup } from '@angular/forms';
+import { CustomQuestion, QuestionFieldType } from '../../models/custom-question.model';
+import * as i0 from "@angular/core";
+/**
+ * Editable card for a single custom interest-form question (SP3M-317). Renders
+ * the Question Label, Type, Required toggle, Placeholder, Help Text and (for
+ * choice types) Options fields. Emits save/cancel so the parent manages the
+ * questions list. The Options field is only shown for choice field types
+ * (SELECT / CHECKBOX / RADIO), matching the backend's choice-type validation.
+ * @export
+ * @class CustomQuestionEditorComponent
+ */
+export declare class CustomQuestionEditorComponent implements OnInit {
+    private formBuilder;
+    constants: any;
+    editorTexts: any;
+    fieldType: typeof QuestionFieldType;
+    typeOptions: {
+        value: QuestionFieldType;
+        label: any;
+    }[];
+    question: CustomQuestion;
+    save: EventEmitter<CustomQuestion>;
+    cancel: EventEmitter<void>;
+    form: FormGroup;
+    constructor(formBuilder: FormBuilder);
+    /**
+     * Builds the reactive form, seeding values from the question being edited.
+     * The question's options are stored as a raw JSON string, so they are parsed
+     * into one-per-line text for editing.
+     * @memberof CustomQuestionEditorComponent
+     */
+    ngOnInit(): void;
+    /**
+     * Parses a stored options JSON string into one-per-line text for the textarea.
+     * @param {(string | undefined)} optionsJson
+     * @return {string}
+     * @memberof CustomQuestionEditorComponent
+     */
+    parseOptionsString(optionsJson: string | undefined): string;
+    /**
+     * Whether the currently selected type requires an options list.
+     * @return {boolean}
+     * @memberof CustomQuestionEditorComponent
+     */
+    get isChoiceType(): boolean;
+    /**
+     * Parses the options textarea into a trimmed, non-empty string array,
+     * stripping trailing commas.
+     * @return {string[]}
+     * @memberof CustomQuestionEditorComponent
+     */
+    parseOptions(): string[];
+    /**
+     * Whether the editor is valid: label and type are required, and choice types
+     * require at least one option.
+     * @return {boolean}
+     * @memberof CustomQuestionEditorComponent
+     */
+    get isSaveDisabled(): boolean;
+    /**
+     * Emits the assembled question on save. Options are serialized to a JSON
+     * string to match the backend's JSONB column.
+     * @memberof CustomQuestionEditorComponent
+     */
+    onSave(): void;
+    /**
+     * Emits the cancel event.
+     * @memberof CustomQuestionEditorComponent
+     */
+    onCancel(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CustomQuestionEditorComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CustomQuestionEditorComponent, "ieeesa-custom-question-editor", never, { "question": { "alias": "question"; "required": false; }; }, { "save": "save"; "cancel": "cancel"; }, never, never, true, never>;
+}

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

@@ -1,6 +1,12 @@
 import { OnInit } from '@angular/core';
-import { MatDialogRef } from '@angular/material/dialog';
+import { MatDialog, MatDialogRef } from '@angular/material/dialog';
+import { CdkDragDrop } from '@angular/cdk/drag-drop';
 import { RadioOption, SlideToggleOption } from '@ieeesa-npm/presentation';
+import { AlertsService } from '@ieeesa-npm/utility';
+import { CustomQuestion, GroupRole, QuestionFieldType } from '../../models/custom-question.model';
+import { GroupInfo } from '../../models/group-info.model';
+import { GroupsService } from '../../services/groups.service';
+import { InterestFormService } from '../../services/interest-form.service';
 import * as i0 from "@angular/core";
 /**
  * Standard (locked) question row shown in the Interest Form tab.
@@ -14,16 +20,21 @@ export interface StandardQuestionRow {
 }
 /**
  * "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.
+ * group admin enables/disables the form, views locked standard questions,
+ * chooses the default membership level and manages custom questions
+ * (add / edit / reorder / remove), persisted to the groups backend via
+ * InterestFormService. Each question is saved individually (create/update) and
+ * the enable mode + default level are saved via the interest-config endpoint.
  * @export
  * @class InterestFormComponent
  */
 export declare class InterestFormComponent implements OnInit {
     private dialogRef;
+    group: GroupInfo;
+    private interestFormService;
+    private groupsService;
+    private alertService;
+    private dialog;
     constants: any;
     interestFormTexts: any;
     changesNotice: any;
@@ -35,41 +46,159 @@ export declare class InterestFormComponent implements OnInit {
     defaultMembershipDescription: any;
     customQuestionsTitle: any;
     addQuestionLabel: any;
+    requiredTag: any;
     standardTag: any;
+    newQuestionLabel: any;
+    editQuestionAriaLabel: any;
+    deleteQuestionAriaLabel: any;
+    noLevelsMessage: any;
+    typeLabels: any;
     cancelLabel: any;
     previewLabel: any;
     enableFormToggle: SlideToggleOption;
     standardQuestions: StandardQuestionRow[];
     membershipLevels: RadioOption[];
     isFormEnabled: boolean;
-    constructor(dialogRef: MatDialogRef<unknown>);
+    selectedLevelId: string | null;
+    levels: GroupRole[];
+    customQuestions: CustomQuestion[];
+    editingQuestionId: string | null;
+    private isEditingNewQuestion;
+    private destroy$;
+    constructor(dialogRef: MatDialogRef<unknown>, group: GroupInfo, interestFormService: InterestFormService, groupsService: GroupsService, alertService: AlertsService, dialog: MatDialog);
     /**
-     * Initializes the toggle, locked standard questions and default membership
-     * level options from constants.
+     * Initializes static UI options and loads the group's interest config and
+     * custom questions from the backend.
      * @memberof InterestFormComponent
      */
     ngOnInit(): void;
     /**
-     * Updates the form-enabled state when the toggle changes so the dependent
-     * sections show or hide accordingly.
+     * Loads the real membership levels for the group's group type and then the
+     * saved interest configuration (so the saved default level can be
+     * preselected).
+     * @memberof InterestFormComponent
+     */
+    loadMembershipLevels(): void;
+    /**
+     * Loads the group's interest configuration (mode + default level) and syncs
+     * the toggle and the default-level radio selection.
+     * @memberof InterestFormComponent
+     */
+    loadConfig(): void;
+    /**
+     * Builds the radio options from the real membership levels, marking the
+     * currently selected level as checked.
+     * @memberof InterestFormComponent
+     */
+    buildMembershipLevelOptions(): void;
+    /**
+     * Loads the group's custom questions.
+     * @memberof InterestFormComponent
+     */
+    loadQuestions(): void;
+    /**
+     * Updates the form-enabled state and persists the new interest mode.
      * @param {SlideToggleOption} toggle
      * @memberof InterestFormComponent
      */
     onEnableFormToggle(toggle: SlideToggleOption): void;
+    /**
+     * Persists the interest config. The default level is only sent for the
+     * enabled (FORM) mode; DISABLED clears it. Enabling without a selected level
+     * is skipped so an invalid request is never sent.
+     * @memberof InterestFormComponent
+     */
+    saveConfig(): void;
+    /**
+     * Records the selected default membership level and persists the config when
+     * the form is enabled.
+     * @param {RadioOption} option
+     * @memberof InterestFormComponent
+     */
+    onMembershipLevelChange(option: RadioOption): void;
+    /**
+     * Adds a new blank question and opens its editor. Only one editor is open at
+     * a time.
+     * @memberof InterestFormComponent
+     */
+    onAddQuestion(): void;
+    /**
+     * Opens the editor for an existing question.
+     * @param {CustomQuestion} question
+     * @memberof InterestFormComponent
+     */
+    onEditQuestion(question: CustomQuestion): void;
+    /**
+     * Creates or updates the question on the backend and refreshes the list.
+     * @param {CustomQuestion} question
+     * @memberof InterestFormComponent
+     */
+    onSaveQuestion(question: CustomQuestion): void;
+    /**
+     * Closes the editor and reloads the questions after a successful save.
+     * @memberof InterestFormComponent
+     */
+    private afterQuestionSaved;
+    /**
+     * Closes the editor. A newly added question is removed on cancel; an existing
+     * question keeps its previous values.
+     * @param {string} questionId
+     * @memberof InterestFormComponent
+     */
+    onCancelQuestion(questionId: string | undefined): void;
+    /**
+     * Removes a question on the backend and refreshes the list.
+     * @param {string} questionId
+     * @memberof InterestFormComponent
+     */
+    onDeleteQuestion(questionId: string | undefined): void;
+    /**
+     * Reorders questions on drag-drop and persists the new order.
+     * @param {CdkDragDrop<CustomQuestion[]>} event
+     * @memberof InterestFormComponent
+     */
+    onReorderQuestions(event: CdkDragDrop<CustomQuestion[]>): void;
+    /**
+     * Returns the display label for a question's field type.
+     * @param {(QuestionFieldType | null)} type
+     * @return {string}
+     * @memberof InterestFormComponent
+     */
+    getTypeLabel(type: QuestionFieldType | null): string;
+    /**
+     * Shows an error alert for a failed interest-form operation.
+     * @param {*} error
+     * @memberof InterestFormComponent
+     */
+    handleError(error: any): void;
+    /**
+     * Opens the interest form in read-only preview mode (SP3M-317 R6.7), reusing
+     * the shared express-interest dialog. Shows the admin's current custom
+     * questions as an end user would see them; no submit, Cancel only.
+     * @memberof InterestFormComponent
+     */
+    onPreview(): void;
     /**
      * Closes the Roster Interests dialog (Cancel action).
      * @memberof InterestFormComponent
      */
     onCancel(): void;
     /**
-     * Returns the unique identifier for a standard question row for ngFor
-     * tracking.
+     * ngFor tracking for standard question rows.
      * @param {number} index
      * @param {StandardQuestionRow} question
      * @return {number}
      * @memberof InterestFormComponent
      */
     trackByFn(index: number, question: StandardQuestionRow): number;
-    static ɵfac: i0.ɵɵFactoryDeclaration<InterestFormComponent, [{ optional: true; }]>;
+    /**
+     * ngFor tracking for custom questions.
+     * @param {number} index
+     * @param {CustomQuestion} question
+     * @return {string}
+     * @memberof InterestFormComponent
+     */
+    trackByQuestionId(index: number, question: CustomQuestion): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<InterestFormComponent, [{ optional: true; }, { optional: true; }, null, null, null, null]>;
     static ɵcmp: i0.ɵɵComponentDeclaration<InterestFormComponent, "ieeesa-interest-form", never, {}, {}, never, never, true, never>;
 }

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

@@ -0,0 +1,37 @@
+import { MatDialogRef } from '@angular/material/dialog';
+import { InterestFormQuestion } from '@ieeesa-npm/models';
+import { CustomQuestion } from '../../models/custom-question.model';
+import * as i0 from "@angular/core";
+/**
+ * Data passed to the preview dialog: the group name (subtitle) and the admin's
+ * current custom questions.
+ */
+export interface InterestFormPreviewData {
+    groupName: string;
+    customQuestions: CustomQuestion[];
+}
+/**
+ * Preview host for the interest form (SP3M-317 R6.7). Reuses the shared,
+ * presentational ExpressInterestDialogComponent in read-only preview mode so
+ * the admin sees the form exactly as an end user would, without any submit
+ * action — only Cancel closes the dialog. No backend call is made; the admin's
+ * in-progress custom questions are passed straight through.
+ * @export
+ * @class InterestFormPreviewComponent
+ */
+export declare class InterestFormPreviewComponent {
+    dialogRef: MatDialogRef<InterestFormPreviewComponent>;
+    private data;
+    constants: any;
+    previewTexts: any;
+    subtitle: string;
+    customQuestions: InterestFormQuestion[];
+    constructor(dialogRef: MatDialogRef<InterestFormPreviewComponent>, data: InterestFormPreviewData);
+    /**
+     * Closes the preview dialog.
+     * @memberof InterestFormPreviewComponent
+     */
+    onClose(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<InterestFormPreviewComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<InterestFormPreviewComponent, "ieeesa-interest-form-preview", never, {}, {}, never, never, true, never>;
+}

package/lib/models/custom-question.model.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Supported field types for a custom interest-form question (SP3M-317). Values
+ * match the backend FieldType enum / field_type CHECK constraint exactly.
+ */
+export declare enum QuestionFieldType {
+    TEXT = "TEXT",
+    TEXTAREA = "TEXTAREA",
+    SELECT = "SELECT",
+    CHECKBOX = "CHECKBOX",
+    RADIO = "RADIO",
+    DATE = "DATE"
+}
+/**
+ * Field types that require a configurable list of options
+ * (SELECT / CHECKBOX / RADIO), matching the backend's choice-type validation.
+ */
+export declare const CHOICE_FIELD_TYPES: QuestionFieldType[];
+/**
+ * Interest-expression mode for a group (matches backend InterestMode).
+ */
+export declare enum InterestMode {
+    DISABLED = "DISABLED",
+    BASIC = "BASIC",
+    FORM = "FORM"
+}
+/**
+ * A single admin-configured custom question on a group's interest form. Field
+ * names mirror the backend InterestFormQuestion entity so payloads map directly.
+ */
+export interface CustomQuestion {
+    questionId?: string;
+    groupId: string;
+    questionLabel: string;
+    fieldType: QuestionFieldType | null;
+    placeholder?: string;
+    helpText?: string;
+    isRequired: boolean;
+    viewOrder: number;
+    options?: string;
+}
+/**
+ * Lightweight transfer object for reordering questions (matches backend
+ * QuestionOrder).
+ */
+export interface QuestionOrder {
+    questionId: string;
+    viewOrder: number;
+}
+/**
+ * Group interest configuration (matches backend GroupInterestConfig).
+ */
+export interface GroupInterestConfig {
+    groupId: string;
+    interestMode: string;
+    defaultLevelId: string | null;
+}
+/**
+ * A role entry returned by GET /groups/role/{appId}. Member levels are the
+ * subset where roleTypeName === "Member Level"; their roleId is used as the
+ * interest-config defaultLevelId and roleName is the display label.
+ */
+export interface GroupRole {
+    roleId: string;
+    roleType: string;
+    roleName: string;
+    roleTypeName: string;
+    viewOrder?: number;
+}
+/**
+ * roleTypeName value identifying member-level roles.
+ */
+export declare const MEMBER_LEVEL_ROLE_TYPE = "Member Level";

package/lib/services/interest-form.service.d.ts

@@ -0,0 +1,105 @@
+import { Observable } from 'rxjs';
+import { HttpService } from '@ieeesa-npm/utility';
+import { CustomQuestion, GroupInterestConfig, GroupRole, QuestionOrder } from '../models/custom-question.model';
+import * as i0 from "@angular/core";
+/**
+ * Standard API response envelope used by the groups backend.
+ */
+export interface InterestApiResponse<T> {
+    status: boolean | string;
+    message?: string;
+    body?: T;
+}
+/**
+ * Service for managing a group's interest form configuration and custom
+ * questions (SP3M-317). Talks to the groups backend endpoints:
+ *   - GET  /v1/groups/interest-config/{groupId}
+ *   - PUT  /v1/groups/interest-config
+ *   - GET  /v1/groups/interest-questions/{groupId}
+ *   - POST /v1/groups/interest-questions
+ *   - PUT  /v1/groups/interest-questions
+ *   - PUT  /v1/groups/interest-questions/reorder
+ *   - PUT  /v1/groups/interest-questions/{questionId}/remove
+ *   - GET  /v1/groups/interest-questions/{groupId}/preview
+ * All write payloads are wrapped in the shared Request envelope ({ payload }).
+ * @export
+ * @class InterestFormService
+ */
+export declare class InterestFormService {
+    private httpService;
+    apiBaseUrl: string;
+    constructor(httpService: HttpService);
+    /**
+     * Sets the API base URL (resolved from the hosting application's config).
+     * @param {string} apiBaseUrl
+     * @memberof InterestFormService
+     */
+    setApiBaseUrl(apiBaseUrl: string): void;
+    /**
+     * Loads a group's interest configuration (mode + default member level).
+     * @param {string} groupId
+     * @return {Observable<InterestApiResponse<GroupInterestConfig>>}
+     * @memberof InterestFormService
+     */
+    getInterestConfig(groupId: string): Observable<InterestApiResponse<GroupInterestConfig>>;
+    /**
+     * Loads the tenant's roles. Member levels (used to populate the default
+     * membership level options) are the subset where roleTypeName is
+     * "Member Level"; filtering is done by the caller.
+     * @param {string} appId
+     * @return {Observable<InterestApiResponse<GroupRole[]>>}
+     * @memberof InterestFormService
+     */
+    getRoles(appId: string): Observable<InterestApiResponse<GroupRole[]>>;
+    /**
+     * Saves a group's interest configuration.
+     * @param {GroupInterestConfig} config
+     * @return {Observable<InterestApiResponse<string>>}
+     * @memberof InterestFormService
+     */
+    saveInterestConfig(config: GroupInterestConfig): Observable<InterestApiResponse<string>>;
+    /**
+     * Loads a group's custom interest questions (ordered by view order).
+     * @param {string} groupId
+     * @return {Observable<InterestApiResponse<CustomQuestion[]>>}
+     * @memberof InterestFormService
+     */
+    getQuestions(groupId: string): Observable<InterestApiResponse<CustomQuestion[]>>;
+    /**
+     * Creates a new custom interest question.
+     * @param {CustomQuestion} question
+     * @return {Observable<InterestApiResponse<CustomQuestion>>}
+     * @memberof InterestFormService
+     */
+    createQuestion(question: CustomQuestion): Observable<InterestApiResponse<CustomQuestion>>;
+    /**
+     * Updates an existing custom interest question.
+     * @param {CustomQuestion} question
+     * @return {Observable<InterestApiResponse<string>>}
+     * @memberof InterestFormService
+     */
+    updateQuestion(question: CustomQuestion): Observable<InterestApiResponse<string>>;
+    /**
+     * Persists the updated view order for a group's custom questions.
+     * @param {QuestionOrder[]} questionOrders
+     * @return {Observable<InterestApiResponse<string>>}
+     * @memberof InterestFormService
+     */
+    reorderQuestions(questionOrders: QuestionOrder[]): Observable<InterestApiResponse<string>>;
+    /**
+     * Soft-deletes a custom interest question by id.
+     * @param {string} questionId
+     * @return {Observable<InterestApiResponse<string>>}
+     * @memberof InterestFormService
+     */
+    removeQuestion(questionId: string): Observable<InterestApiResponse<string>>;
+    /**
+     * Builds a non-publishing preview of a group's interest form.
+     * @param {string} groupId
+     * @return {Observable<InterestApiResponse<unknown>>}
+     * @memberof InterestFormService
+     */
+    previewForm(groupId: string): Observable<InterestApiResponse<unknown>>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<InterestFormService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<InterestFormService>;
+}

package/package.json

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

package/public-api.d.ts

@@ -8,6 +8,10 @@ export * from './lib/components/roster-import-history/roster-import-history.comp
 export * from './lib/components/interest-form-management/interest-form-management.component';
 export * from './lib/components/interested-rosters/interested-rosters.component';
 export * from './lib/components/interest-form/interest-form.component';
+export * from './lib/components/custom-question-editor/custom-question-editor.component';
+export * from './lib/components/interest-form-preview/interest-form-preview.component';
+export * from './lib/models/custom-question.model';
+export * from './lib/services/interest-form.service';
 export * from './lib/groups.component';
 export * from './lib/models/create-group.model';
 export * from './lib/models/group-action.model';