@masterteam/discussion 0.0.1

package/types/masterteam-discussion.d.ts

@@ -0,0 +1,383 @@
+import * as _angular_core from '@angular/core';
+import { ElementRef } from '@angular/core';
+import { HttpContext } from '@angular/common/http';
+import { EntityData } from '@masterteam/components/entities';
+import { Observable } from 'rxjs';
+
+interface AppResponseViewModelError {
+    code?: string;
+    message?: string;
+    details?: unknown;
+}
+interface AppResponseViewModel<T> {
+    endpoint?: string;
+    status?: number;
+    code?: number;
+    locale?: string;
+    message?: string | null;
+    errors?: AppResponseViewModelError | null;
+    data: T;
+    cacheSession?: string;
+}
+interface DiscussionThreadSummaryDto {
+    threadKey: string;
+    moduleType: string;
+    recordId: number;
+    totalComments: number;
+    lastCommentAt: string | null;
+    lastReadCommentId: number | null;
+    lastReadCommentCreatedAt: string | null;
+    lastReadAt: string | null;
+    unreadCount: number;
+    hasUnread: boolean;
+}
+interface DiscussionCommentAttachmentDto {
+    id: number;
+    fileId: string;
+    fileName: string;
+    contentType: string;
+    size: number;
+}
+interface DiscussionMentionDto {
+    id?: number;
+    userId: string;
+    startIndex: number;
+    length: number;
+}
+interface DiscussionCommentDto {
+    id: number;
+    moduleType: string;
+    recordId: number;
+    parentCommentId: number | null;
+    comment: string;
+    isSystem: boolean;
+    createdAt: string;
+    updatedAt: string | null;
+    createdBy: string;
+    updatedBy: string | null;
+    attachments: DiscussionCommentAttachmentDto[];
+    mentions: DiscussionMentionDto[];
+}
+interface DiscussionCommentsPageDto {
+    items: DiscussionCommentDto[];
+    nextCursor: string | null;
+    hasMore: boolean;
+    lastReadCommentId: number | null;
+    lastReadCommentCreatedAt: string | null;
+    lastReadAt: string | null;
+    unreadCount: number;
+    hasUnread: boolean;
+}
+interface DiscussionParticipantDto {
+    id: number;
+    userId: string;
+    user?: DiscussionParticipantUserDto | null;
+    addedBy: string;
+    addedByUser?: DiscussionParticipantUserDto | null;
+    createdAt: string;
+}
+interface DiscussionParticipantUserDto {
+    id: string;
+    displayName: string;
+    userName?: string | null;
+    fullName?: string | null;
+    photoUrl?: string | null;
+    isActive?: boolean;
+    isDeleted?: boolean;
+    hasContactDetails?: boolean;
+}
+interface DiscussionCommentRevisionDto {
+    id: number;
+    commentId: number;
+    revisionNumber: number;
+    comment: string;
+    createdAt: string;
+    createdBy: string;
+    mentions: DiscussionMentionDto[];
+}
+interface DiscussionReadStateDto {
+    threadKey: string;
+    moduleType: string;
+    recordId: number;
+    userId: string;
+    lastReadCommentId: number | null;
+    lastReadCommentCreatedAt: string | null;
+    lastReadAt: string | null;
+    unreadCount: number;
+    hasUnread: boolean;
+}
+interface DiscussionCreateCommentRequest {
+    comment: string;
+    parentCommentId?: number | null;
+    attachmentFileIds?: string[];
+    mentions?: DiscussionMentionDto[];
+}
+interface DiscussionUpdateCommentRequest {
+    comment: string;
+    mentions?: DiscussionMentionDto[];
+}
+interface DiscussionAddParticipantRequest {
+    userId: string;
+}
+interface DiscussionUpdateReadStateRequest {
+    lastReadCommentId?: number;
+}
+interface DiscussionMentionUser {
+    userId: string;
+    displayName: string;
+    userName?: string | null;
+    avatarUrl?: string | null;
+}
+interface DiscussionAttachmentUploadResult {
+    fileId: string;
+    fileName: string;
+    contentType?: string | null;
+    size?: number | null;
+}
+interface DiscussionAttachmentUploadProgressEvent {
+    progress: number;
+    completed: boolean;
+    file?: DiscussionAttachmentUploadResult;
+}
+interface DiscussionAttachmentDraft {
+    id: string;
+    fileId: string | null;
+    fileName: string;
+    contentType: string;
+    size: number;
+    progress: number;
+    status: 'uploading' | 'ready' | 'failed';
+    error?: string | null;
+}
+interface DiscussionCommentSegment {
+    text: string;
+    isMention: boolean;
+    userId?: string;
+}
+interface DiscussionReadStateLike {
+    lastReadCommentId: number | null;
+    lastReadCommentCreatedAt: string | null;
+    unreadCount: number;
+    hasUnread: boolean;
+}
+
+type MentionMode = 'composer' | 'edit';
+interface MentionSession {
+    mode: MentionMode;
+    triggerIndex: number;
+    caretIndex: number;
+    query: string;
+    textarea: HTMLTextAreaElement;
+    editCommentId: number | null;
+}
+interface MentionMenuPosition {
+    left: number;
+    top: number;
+    width: number;
+    maxHeight: number;
+    placement: 'above' | 'below';
+}
+declare class DiscussionThread {
+    private readonly api;
+    private readonly destroyRef;
+    readonly moduleType: _angular_core.InputSignal<string>;
+    readonly recordId: _angular_core.InputSignal<number>;
+    readonly title: _angular_core.InputSignal<string>;
+    readonly subtitle: _angular_core.InputSignal<string>;
+    readonly placeholder: _angular_core.InputSignal<string>;
+    readonly pageSize: _angular_core.InputSignal<number>;
+    readonly currentUserId: _angular_core.InputSignal<string>;
+    readonly requestContext: _angular_core.InputSignal<HttpContext | undefined>;
+    readonly mentionableUsers: _angular_core.InputSignal<DiscussionMentionUser[]>;
+    readonly mentionSearchEndpoint: _angular_core.InputSignal<string>;
+    readonly mentionSearchParam: _angular_core.InputSignal<string>;
+    readonly mentionSearchDataPath: _angular_core.InputSignal<string>;
+    readonly allowAttachments: _angular_core.InputSignal<boolean>;
+    readonly uploadEndpoint: _angular_core.InputSignal<string>;
+    readonly attachmentDownloadEndpoint: _angular_core.InputSignal<string>;
+    readonly showParticipants: _angular_core.InputSignal<boolean>;
+    readonly autoMarkRead: _angular_core.InputSignal<boolean>;
+    readonly refreshIntervalMs: _angular_core.InputSignal<number>;
+    readonly styleClass: _angular_core.InputSignal<string>;
+    readonly disabled: _angular_core.InputSignal<boolean>;
+    readonly loaded: _angular_core.OutputEmitterRef<DiscussionThreadSummaryDto>;
+    readonly errored: _angular_core.OutputEmitterRef<string>;
+    readonly commentCreated: _angular_core.OutputEmitterRef<DiscussionCommentDto>;
+    readonly commentUpdated: _angular_core.OutputEmitterRef<DiscussionCommentDto>;
+    readonly commentDeleted: _angular_core.OutputEmitterRef<number>;
+    readonly readStateChanged: _angular_core.OutputEmitterRef<DiscussionReadStateDto | null>;
+    protected readonly viewportRef: _angular_core.Signal<ElementRef<HTMLDivElement> | undefined>;
+    protected readonly composerInputRef: _angular_core.Signal<ElementRef<HTMLTextAreaElement> | undefined>;
+    protected readonly attachmentInputRef: _angular_core.Signal<ElementRef<HTMLInputElement> | undefined>;
+    protected readonly loadingInitial: _angular_core.WritableSignal<boolean>;
+    protected readonly loadingMore: _angular_core.WritableSignal<boolean>;
+    protected readonly posting: _angular_core.WritableSignal<boolean>;
+    protected readonly refreshing: _angular_core.WritableSignal<boolean>;
+    protected readonly markingRead: _angular_core.WritableSignal<boolean>;
+    protected readonly participantsLoading: _angular_core.WritableSignal<boolean>;
+    protected readonly savingEdit: _angular_core.WritableSignal<boolean>;
+    protected readonly revisionLoading: _angular_core.WritableSignal<boolean>;
+    protected readonly errorMessage: _angular_core.WritableSignal<string | null>;
+    protected readonly threadSummary: _angular_core.WritableSignal<DiscussionThreadSummaryDto | null>;
+    protected readonly commentsDesc: _angular_core.WritableSignal<DiscussionCommentDto[]>;
+    protected readonly participants: _angular_core.WritableSignal<DiscussionParticipantDto[]>;
+    protected readonly readState: _angular_core.WritableSignal<DiscussionReadStateDto | null>;
+    protected readonly nextCursor: _angular_core.WritableSignal<string | null>;
+    protected readonly hasMore: _angular_core.WritableSignal<boolean>;
+    protected readonly composerText: _angular_core.WritableSignal<string>;
+    protected readonly composerMentions: _angular_core.WritableSignal<DiscussionMentionDto[]>;
+    protected readonly composerAttachments: _angular_core.WritableSignal<DiscussionAttachmentDraft[]>;
+    protected readonly replyToCommentId: _angular_core.WritableSignal<number | null>;
+    protected readonly editingCommentId: _angular_core.WritableSignal<number | null>;
+    protected readonly editText: _angular_core.WritableSignal<string>;
+    protected readonly editMentions: _angular_core.WritableSignal<DiscussionMentionDto[]>;
+    protected readonly participantsExpanded: _angular_core.WritableSignal<boolean>;
+    protected readonly mentionSession: _angular_core.WritableSignal<MentionSession | null>;
+    protected readonly mentionCandidates: _angular_core.WritableSignal<DiscussionMentionUser[]>;
+    protected readonly mentionLoading: _angular_core.WritableSignal<boolean>;
+    protected readonly mentionActiveIndex: _angular_core.WritableSignal<number>;
+    protected readonly mentionMenuPosition: _angular_core.WritableSignal<MentionMenuPosition | null>;
+    protected readonly mentionMenuStyle: _angular_core.Signal<{
+        left: string;
+        top: string;
+        width: string;
+        maxHeight: string;
+    } | null>;
+    protected readonly revisionsDialogVisible: _angular_core.WritableSignal<boolean>;
+    protected readonly selectedRevisionComment: _angular_core.WritableSignal<DiscussionCommentDto | null>;
+    protected readonly revisionsByComment: _angular_core.WritableSignal<Map<number, DiscussionCommentRevisionDto[]>>;
+    protected readonly deletingCommentIds: _angular_core.WritableSignal<Set<number>>;
+    protected readonly atBottom: _angular_core.WritableSignal<boolean>;
+    protected readonly resolvedModuleType: _angular_core.Signal<string>;
+    protected readonly resolvedRecordId: _angular_core.Signal<number>;
+    protected readonly resolvedPageSize: _angular_core.Signal<number>;
+    protected readonly threadKey: _angular_core.Signal<string>;
+    protected readonly commentsAsc: _angular_core.Signal<DiscussionCommentDto[]>;
+    protected readonly commentsById: _angular_core.Signal<Map<number, DiscussionCommentDto>>;
+    protected readonly replyToComment: _angular_core.Signal<DiscussionCommentDto | null>;
+    protected readonly readStateLike: _angular_core.Signal<DiscussionReadStateLike | null>;
+    protected readonly hasUnread: _angular_core.Signal<boolean>;
+    protected readonly unreadCount: _angular_core.Signal<number>;
+    protected readonly firstUnreadCommentId: _angular_core.Signal<number | null>;
+    protected readonly mentionPool: _angular_core.Signal<DiscussionMentionUser[]>;
+    protected readonly participantEntities: _angular_core.Signal<EntityData[]>;
+    protected readonly uploadInProgress: _angular_core.Signal<boolean>;
+    protected readonly readyAttachmentFileIds: _angular_core.Signal<string[]>;
+    protected readonly canSend: _angular_core.Signal<boolean>;
+    protected readonly canSaveEdit: _angular_core.Signal<boolean>;
+    protected readonly charactersLeft: _angular_core.Signal<number>;
+    protected readonly visibleRevisions: _angular_core.Signal<DiscussionCommentRevisionDto[]>;
+    private readonly mentionSearchTerms;
+    private readonly mentionMenuMaxWidthPx;
+    private readonly mentionMenuPreferredHeightPx;
+    private readonly mentionMenuViewportPaddingPx;
+    private autoReadTimer;
+    constructor();
+    protected trackComment(_: number, comment: DiscussionCommentDto): number;
+    protected isOwnComment(comment: DiscussionCommentDto): boolean;
+    protected canEditComment(comment: DiscussionCommentDto): boolean;
+    protected canDeleteComment(comment: DiscussionCommentDto): boolean;
+    protected isDeleting(commentId: number): boolean;
+    protected getAvatarText(comment: DiscussionCommentDto): string;
+    protected getMentionAvatarText(user: DiscussionMentionUser): string;
+    protected getCommentSegments(comment: DiscussionCommentDto): DiscussionCommentSegment[];
+    protected getParentComment(comment: DiscussionCommentDto): DiscussionCommentDto | null;
+    protected openReply(comment: DiscussionCommentDto): void;
+    protected clearReply(): void;
+    protected startEdit(comment: DiscussionCommentDto): void;
+    protected cancelEdit(): void;
+    protected saveEdit(): Promise<void>;
+    protected deleteComment(comment: DiscussionCommentDto): Promise<void>;
+    protected sendComment(): Promise<void>;
+    protected loadOlder(): Promise<void>;
+    protected refreshThread(): Promise<void>;
+    protected markRead(): Promise<void>;
+    protected markUnread(): Promise<void>;
+    protected onViewportScroll(): void;
+    protected onComposerInput(event: Event): void;
+    protected onComposerCaretEvent(event: Event): void;
+    protected onComposerKeydown(event: KeyboardEvent): void;
+    protected onEditInput(event: Event): void;
+    protected onEditCaretEvent(event: Event): void;
+    protected onEditKeydown(event: KeyboardEvent): void;
+    protected selectMention(user: DiscussionMentionUser): void;
+    protected toggleParticipantsPanel(): void;
+    protected openRevisions(comment: DiscussionCommentDto): Promise<void>;
+    protected downloadAttachment(comment: DiscussionCommentDto, attachment: {
+        fileId: string;
+        fileName: string;
+    }): Promise<void>;
+    protected browseAttachments(): void;
+    protected onAttachmentSelected(event: Event): void;
+    protected removeAttachment(draftId: string): void;
+    private uploadAttachment;
+    private loadThread;
+    private reloadParticipantsQuiet;
+    private refreshReadState;
+    private resetData;
+    private resetComposer;
+    private applyInitialComments;
+    private applyCommentsPageMeta;
+    private normalizeComments;
+    private rebaseMentions;
+    private computeTextMutation;
+    private normalizePageSize;
+    private isCursorError;
+    private updateMentionSession;
+    private searchMentionCandidates;
+    private matchesMentionQuery;
+    private bindMentionSearch;
+    private handleMentionKeyboard;
+    private closeMentionMenu;
+    private positionMentionMenuForCurrentSession;
+    private positionMentionMenu;
+    private measureMentionCaret;
+    private resolveMentionLineHeight;
+    private getParticipantDisplayName;
+    private mapParticipantToEntityUserValue;
+    private mergeParticipants;
+    private toReadStateFromPage;
+    private resolveFirstUnreadCommentId;
+    private isCommentAfterPointer;
+    private focusComposer;
+    private scheduleScrollToBottom;
+    private scheduleAutoMarkRead;
+    private patchSummaryTotal;
+    private patchSummaryRead;
+    private handleError;
+    private generateDraftId;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DiscussionThread, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DiscussionThread, "mt-discussion-thread", never, { "moduleType": { "alias": "moduleType"; "required": true; "isSignal": true; }; "recordId": { "alias": "recordId"; "required": true; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "currentUserId": { "alias": "currentUserId"; "required": false; "isSignal": true; }; "requestContext": { "alias": "requestContext"; "required": false; "isSignal": true; }; "mentionableUsers": { "alias": "mentionableUsers"; "required": false; "isSignal": true; }; "mentionSearchEndpoint": { "alias": "mentionSearchEndpoint"; "required": false; "isSignal": true; }; "mentionSearchParam": { "alias": "mentionSearchParam"; "required": false; "isSignal": true; }; "mentionSearchDataPath": { "alias": "mentionSearchDataPath"; "required": false; "isSignal": true; }; "allowAttachments": { "alias": "allowAttachments"; "required": false; "isSignal": true; }; "uploadEndpoint": { "alias": "uploadEndpoint"; "required": false; "isSignal": true; }; "attachmentDownloadEndpoint": { "alias": "attachmentDownloadEndpoint"; "required": false; "isSignal": true; }; "showParticipants": { "alias": "showParticipants"; "required": false; "isSignal": true; }; "autoMarkRead": { "alias": "autoMarkRead"; "required": false; "isSignal": true; }; "refreshIntervalMs": { "alias": "refreshIntervalMs"; "required": false; "isSignal": true; }; "styleClass": { "alias": "styleClass"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "loaded": "loaded"; "errored": "errored"; "commentCreated": "commentCreated"; "commentUpdated": "commentUpdated"; "commentDeleted": "commentDeleted"; "readStateChanged": "readStateChanged"; }, never, never, true, never>;
+}
+
+declare class DiscussionApiService {
+    private readonly http;
+    private readonly defaultContext;
+    private readonly baseRoute;
+    getThreadSummary(moduleType: string, recordId: number, context?: HttpContext): Observable<DiscussionThreadSummaryDto>;
+    getComments(moduleType: string, recordId: number, take?: number, cursor?: string | null, context?: HttpContext): Observable<DiscussionCommentsPageDto>;
+    createComment(moduleType: string, recordId: number, request: DiscussionCreateCommentRequest, context?: HttpContext): Observable<DiscussionCommentDto>;
+    updateComment(moduleType: string, recordId: number, commentId: number, request: DiscussionUpdateCommentRequest, context?: HttpContext): Observable<DiscussionCommentDto>;
+    deleteComment(moduleType: string, recordId: number, commentId: number, context?: HttpContext): Observable<boolean>;
+    getCommentRevisions(moduleType: string, recordId: number, commentId: number, context?: HttpContext): Observable<DiscussionCommentRevisionDto[]>;
+    getParticipants(moduleType: string, recordId: number, context?: HttpContext): Observable<DiscussionParticipantDto[]>;
+    addParticipant(moduleType: string, recordId: number, request: DiscussionAddParticipantRequest, context?: HttpContext): Observable<DiscussionParticipantDto>;
+    getReadState(moduleType: string, recordId: number, context?: HttpContext): Observable<DiscussionReadStateDto>;
+    markReadState(moduleType: string, recordId: number, request?: DiscussionUpdateReadStateRequest, context?: HttpContext): Observable<DiscussionReadStateDto>;
+    clearReadState(moduleType: string, recordId: number, context?: HttpContext): Observable<boolean>;
+    uploadAttachment(file: File, uploadEndpoint: string, context?: HttpContext): Observable<DiscussionAttachmentUploadProgressEvent>;
+    searchMentionUsers(endpoint: string, query: string, paramName: string, dataPath: string, context?: HttpContext): Observable<DiscussionMentionUser[]>;
+    downloadAttachment(endpoint: string, fileId: string, fileName: string, context?: HttpContext): Observable<void>;
+    private threadRoute;
+    private resolveContext;
+    private mutationHeaders;
+    private idempotencyKey;
+    private unwrapUnknownResponse;
+    private mapUploadPayload;
+    private resolveDownloadEndpoint;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DiscussionApiService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<DiscussionApiService>;
+}
+
+export { DiscussionApiService, DiscussionThread };
+export type { AppResponseViewModel, AppResponseViewModelError, DiscussionAddParticipantRequest, DiscussionAttachmentDraft, DiscussionAttachmentUploadProgressEvent, DiscussionAttachmentUploadResult, DiscussionCommentAttachmentDto, DiscussionCommentDto, DiscussionCommentRevisionDto, DiscussionCommentSegment, DiscussionCommentsPageDto, DiscussionCreateCommentRequest, DiscussionMentionDto, DiscussionMentionUser, DiscussionParticipantDto, DiscussionParticipantUserDto, DiscussionReadStateDto, DiscussionReadStateLike, DiscussionThreadSummaryDto, DiscussionUpdateCommentRequest, DiscussionUpdateReadStateRequest };